From 279284b143fb4a16e575c07d4401ec9d6092feaf Mon Sep 17 00:00:00 2001
From: Marcus Kammer <marcus.kammer@mailbox.org>
Date: Wed, 24 Aug 2022 19:36:32 +0200
Subject: [PATCH] Update clones

---
 .../clojure-doc.org/articles/about/index.html |  216 ++
 .../articles/content/index.html               |  225 ++
 .../cookbooks/data_structures/index.html      |  208 ++
 .../cookbooks/date_and_time/index.html        |  208 ++
 .../files_and_directories/index.html          |  252 ++
 .../articles/cookbooks/math/index.html        |  252 ++
 .../articles/cookbooks/middleware/index.html  |  326 ++
 .../articles/cookbooks/strings/index.html     |  464 +++
 .../articles/ecosystem/books/index.html       |  230 ++
 .../articles/ecosystem/community/index.html   |  213 ++
 .../ecosystem/core_typed/filters/index.html   |  244 ++
 .../core_typed/function_types/index.html      |  237 ++
 .../ecosystem/core_typed/home/index.html      |  207 ++
 .../core_typed/limitations/index.html         |  222 ++
 .../ecosystem/core_typed/loops/index.html     |  223 ++
 .../mm_protocol_datatypes/index.html          |  219 ++
 .../ecosystem/core_typed/poly_fn/index.html   |  234 ++
 .../ecosystem/core_typed/quick_guide.html     |  241 ++
 .../core_typed/quick_guide/index.html         |  241 ++
 .../ecosystem/core_typed/rationale/index.html |  227 ++
 .../core_typed/start/annotations/index.html   |  275 ++
 .../introduction_and_motivation/index.html    |  237 ++
 .../ecosystem/core_typed/types/index.html     |  338 ++
 .../core_typed/user_documentation/index.html  |  257 ++
 .../ecosystem/data_processing/index.html      |  208 ++
 .../generating_documentation/index.html       |  231 ++
 .../articles/ecosystem/java_jdbc/home.html    |  310 ++
 .../ecosystem/java_jdbc/home/index.html       |  310 ++
 .../java_jdbc/reusing_connections.html        |  289 ++
 .../java_jdbc/reusing_connections/index.html  |  289 ++
 .../ecosystem/java_jdbc/using_ddl.html        |  249 ++
 .../ecosystem/java_jdbc/using_ddl/index.html  |  249 ++
 .../ecosystem/java_jdbc/using_sql.html        |  510 +++
 .../ecosystem/java_jdbc/using_sql/index.html  |  510 +++
 .../ecosystem/libraries_authoring/index.html  |  343 ++
 .../ecosystem/libraries_directory/index.html  |  239 ++
 .../articles/ecosystem/maven/index.html       |  395 +++
 .../ecosystem/running_cljug/index.html        |  209 ++
 .../articles/ecosystem/user_groups/index.html |  212 ++
 .../ecosystem/web_development/index.html      |  239 ++
 .../collections_and_sequences/index.html      |  648 ++++
 .../concurrency_and_parallelism/index.html    |  755 +++++
 .../language/core_overview/index.html         |  745 +++++
 .../articles/language/functions/index.html    |  398 +++
 .../articles/language/glossary/index.html     |  344 ++
 .../articles/language/interop/index.html      |  617 ++++
 .../articles/language/laziness/index.html     |  264 ++
 .../articles/language/macros/index.html       |  382 +++
 .../articles/language/namespaces/index.html   |  375 +++
 .../articles/language/polymorphism/index.html |  385 +++
 .../basic_web_development/index.html          |  476 +++
 .../articles/tutorials/eclipse/index.html     |  250 ++
 .../articles/tutorials/emacs/index.html       |  445 +++
 .../tutorials/getting_started/index.html      |  256 ++
 .../growing_a_dsl_with_clojure/index.html     |  385 +++
 .../tutorials/introduction/index.html         |  968 ++++++
 .../parsing_xml_with_zippers/index.html       |  486 +++
 .../tutorials/vim_fireplace/index.html        |  271 ++
 clones/clojure-doc.org/css/screen.css         |  168 +
 clones/clojure-doc.org/index.html             |  237 ++
 clones/clojure-doc.org/js/highlight.pack.js   |    2 +
 .../local-redirect/local-redirect.js          |   13 +-
 .../Building_New_Contract_Combinators.html    |  313 ++
 .../reference/Byte_and_String_Input.html      |  180 ++
 .../reference/Byte_and_String_Output.html     |   64 +
 .../reference/Command-Line_Parsing.html       |  152 +
 .../reference/Delayed_Evaluation.html         |   59 +
 .../reference/Equality.html                   |  202 ++
 .../reference/Exiting.html                    |   19 +
 .../reference/Expanding_Top-Level_Forms.html  |   51 +
 .../reference/Filesystem.html                 |  850 +++++
 .../Generating_A_Unit_from_Context.html       |    9 +
 .../reference/Generators.html                 |   49 +
 .../reference/Interactive_Help.html           |   22 +
 .../reference/Kernel_Forms_and_Functions.html |   25 +
 .../Lazy_Data-structure_Contracts.html        |   28 +
 .../reference/Legacy_Contracts.html           |    7 +
 .../Locations____variable-reference.html      |   18 +
 .../reference/Macros.html                     |    6 +
 .../reference/Manipulating_Paths.html         |  237 ++
 .../reference/Module_Names_and_Loading.html   |  320 ++
 .../reference/More_Path_Utilities.html        |   65 +
 .../reference/Namespaces.html                 |  207 ++
 .../reference/Object_and_Class_Contracts.html |  127 +
 .../reference/Printer_Extension.html          |   51 +
 .../reference/Random_generation.html          |   44 +
 .../reference/Reader_Extension.html           |   10 +
 .../reference/Reading.html                    |  185 ++
 .../reference/Sandboxed_Evaluation.html       |  511 +++
 .../reference/Serializing_Syntax.html         |   41 +
 .../reference/Single-Signature_Modules.html   |   15 +
 .../reference/Structural_Matching.html        |   25 +
 .../Structure_Type_Property_Contracts.html    |   32 +
 .../reference/Surrogates.html                 |   63 +
 .../Syntax_Quoting__quote-syntax.html         |   13 +
 .../reference/Transformer_Helpers.html        |   36 +
 .../reference/Unit_Utilities.html             |    4 +
 .../reference/Writing.html                    |  140 +
 .../reference/__expression.html               |   22 +
 .../reference/__top-interaction.html          |    6 +
 .../docs.racket-lang.org/reference/__top.html |   24 +
 .../reference/all-sync.html                   |    7 +
 .../reference/application.html                |   29 +
 .../reference/async-channel.html              |   41 +
 .../attaching-contracts-to-values.html        |  151 +
 .../docs.racket-lang.org/reference/begin.html |   30 +
 .../docs.racket-lang.org/reference/block.html |    8 +
 .../reference/booleans.html                   |   22 +
 .../docs.racket-lang.org/reference/boxes.html |   24 +
 .../reference/breakhandler.html               |   89 +
 .../reference/bytestrings.html                |  246 ++
 .../docs.racket-lang.org/reference/case.html  |   14 +
 .../reference/channel.html                    |   25 +
 .../reference/chaperones.html                 |  469 +++
 .../reference/characters.html                 |   71 +
 .../reference/collapsible.html                |   57 +
 .../reference/collects.html                   |  205 ++
 .../reference/compiler.html                   |   70 +
 .../reference/compoundunits.html              |   46 +
 .../reference/concurrency.html                |    6 +
 .../docs.racket-lang.org/reference/cont.html  |  177 ++
 .../reference/contmarks.html                  |  110 +
 .../reference/contract-utilities.html         |   98 +
 .../reference/contracts.html                  |   47 +
 .../reference/control.html                    |    2 +
 .../reference/createclass.html                |  324 ++
 .../reference/createinterface.html            |   30 +
 .../reference/creatingmorestructs.html        |   88 +
 .../reference/creatingunits.html              |  101 +
 .../reference/custodians.html                 |   64 +
 .../reference/customport.html                 |  370 +++
 .../reference/data-structure-contracts.html   |  281 ++
 .../docs.racket-lang.org/reference/data.html  |    3 +
 .../reference/debugging.html                  |   87 +
 .../reference/define-sig-form.html            |   16 +
 .../reference/define-struct.html              |  146 +
 .../reference/define.html                     |   70 +
 .../docs.racket-lang.org/reference/dicts.html |  202 ++
 .../reference/doc-bibliography.html           |    2 +
 .../reference/doc-index.html                  |   35 +
 .../reference/encodings.html                  |   72 +
 .../reference/engine.html                     |   39 +
 .../reference/envvars.html                    |   48 +
 .../reference/ephemerons.html                 |   40 +
 .../reference/eval-model.html                 |  515 +++
 .../docs.racket-lang.org/reference/eval.html  |  347 ++
 .../docs.racket-lang.org/reference/exns.html  |  507 +++
 .../reference/extflonums.html                 |   51 +
 .../docs.racket-lang.org/reference/extras.css |   12 +
 .../docs.racket-lang.org/reference/fasl.html  |   56 +
 .../reference/file-ports.html                 |  163 +
 .../docs.racket-lang.org/reference/finger.png |  Bin 0 -> 430 bytes
 .../reference/fixnums.html                    |   79 +
 .../reference/flonums.html                    |   73 +
 .../docs.racket-lang.org/reference/for.html   |  259 ++
 .../reference/function-contracts.html         |  192 ++
 .../reference/futures.html                    |  140 +
 .../reference/garbagecollection.html          |  101 +
 .../reference/generic-numbers.html            |  273 ++
 .../reference/hashtables.html                 |  278 ++
 .../docs.racket-lang.org/reference/icons.css  |    8 +
 clones/docs.racket-lang.org/reference/if.html |   42 +
 .../reference/implementations.html            |   26 +
 .../reference/include.html                    |   28 +
 .../docs.racket-lang.org/reference/index.html |   10 +
 .../reference/input-and-output.html           |    2 +
 .../reference/inspectors.html                 |   90 +
 .../reference/interaction-info.html           |   16 +
 .../reference/interactive.html                |   38 +
 .../reference/invokingunits.html              |   26 +
 .../reference/ivaraccess.html                 |   69 +
 .../reference/keywords.html                   |   18 +
 .../reference/lambda.html                     |   94 +
 .../reference/lazy-require.html               |   44 +
 .../docs.racket-lang.org/reference/let.html   |   78 +
 .../reference/linecol.html                    |   60 +
 .../reference/linkinference.html              |   70 +
 .../reference/linklets.html                   |  247 ++
 .../reference/load-lang.html                  |   24 +
 .../docs.racket-lang.org/reference/local.html |    9 +
 .../reference/logging.html                    |  155 +
 .../reference/magnify.png                     |  Bin 0 -> 323 bytes
 .../docs.racket-lang.org/reference/match.html |  195 ++
 .../reference/memory-order.html               |   26 +
 .../reference/memory.html                     |    2 +
 .../reference/mixins.html                     |   12 +
 .../docs.racket-lang.org/reference/model.html |    2 +
 .../reference/modprotect.html                 |   50 +
 .../reference/module.html                     |  196 ++
 .../reference/mpairs.html                     |   20 +
 .../reference/mzlib_class.html                |   29 +
 .../reference/mzlib_unit.html                 |   10 +
 .../reference/networking.html                 |    2 +
 .../reference/notation.html                   |  113 +
 .../reference/number-types.html               |   28 +
 .../reference/numbers.html                    |   71 +
 .../reference/objcreation.html                |   53 +
 .../reference/objectequality.html             |   31 +
 .../reference/objectprinting.html             |   19 +
 .../reference/objectserialize.html            |   40 +
 .../reference/objectutils.html                |   61 +
 .../reference/os-lib.html                     |    3 +
 clones/docs.racket-lang.org/reference/os.html |    2 +
 .../docs.racket-lang.org/reference/pairs.html |  243 ++
 .../reference/parameters.html                 |   57 +
 .../reference/parametric-contracts.html       |   34 +
 .../reference/pathutils.html                  |   30 +
 .../reference/performance-hint.html           |   12 +
 .../reference/phantom-bytes.html              |   19 +
 .../reference/phase_space.html                |   39 +
 .../reference/pipeports.html                  |   23 +
 .../reference/places.html                     |  215 ++
 .../reference/plumbers.html                   |   35 +
 .../reference/port-buffers.html               |   86 +
 .../reference/port-lib.html                   |  290 ++
 .../reference/port-ops.html                   |   34 +
 .../docs.racket-lang.org/reference/ports.html |   40 +
 .../reference/portstructs.html                |   16 +
 .../reference/pretty-print.html               |  173 +
 .../reference/printing.html                   |  425 +++
 .../reference/procedures.html                 |  262 ++
 .../reference/quasiquote.html                 |   36 +
 .../docs.racket-lang.org/reference/quote.html |    9 +
 .../reference/racket_contract_base.html       |   10 +
 .../reference/reader-procs.html               |   32 +
 .../reference/reader.html                     |  468 +++
 .../reference/readtables.html                 |   97 +
 .../reference/regexp.html                     |  329 ++
 .../reference/repl-module.html                |    6 +
 .../reference/require.html                    |  394 +++
 .../reference/running-sa.html                 |  336 ++
 .../reference/running.html                    |    2 +
 .../reference/runtime.html                    |  113 +
 .../reference/security.html                   |    2 +
 .../reference/securityguards.html             |   59 +
 .../reference/semaphore.html                  |   52 +
 .../reference/sequences.html                  |  282 ++
 .../reference/sequences_streams.html          |    7 +
 .../reference/serialization.html              |  283 ++
 .../docs.racket-lang.org/reference/set_.html  |   24 +
 .../docs.racket-lang.org/reference/sets.html  |  276 ++
 .../docs.racket-lang.org/reference/sha.html   |   20 +
 .../reference/shared.html                     |   46 +
 .../reference/single-unit.html                |   11 +
 .../reference/special-comments.html           |   10 +
 .../reference/splicing.html                   |   29 +
 .../reference/stencil_vectors.html            |   50 +
 .../reference/stratified-body.html            |    9 +
 .../reference/streams.html                    |  104 +
 .../reference/stringport.html                 |   36 +
 .../reference/strings.html                    |  223 ++
 .../reference/struct-copy.html                |   24 +
 .../reference/struct-generics.html            |  103 +
 .../reference/structinfo.html                 |  103 +
 .../reference/structprops.html                |   74 +
 .../reference/structures.html                 |   53 +
 .../reference/structutils.html                |   82 +
 .../reference/stx-patterns.html               |  197 ++
 .../reference/stxcerts.html                   |   27 +
 .../reference/stxcmp.html                     |   97 +
 .../reference/stxops.html                     |  171 +
 .../reference/stxparam.html                   |   50 +
 .../reference/stxprops.html                   |  110 +
 .../reference/stxtrans.html                   |  729 +++++
 .../reference/subprocess.html                 |  248 ++
 .../reference/symbols.html                    |   46 +
 .../docs.racket-lang.org/reference/sync.html  |  144 +
 .../reference/syntax-model.html               |  655 ++++
 .../reference/syntax-util.html                |   60 +
 .../reference/syntax.html                     |   22 +
 .../docs.racket-lang.org/reference/tcp.html   |  126 +
 .../reference/thread-local-storage.html       |    4 +
 .../reference/threadcells.html                |   36 +
 .../reference/threadgroups.html               |   15 +
 .../reference/threads.html                    |  137 +
 .../docs.racket-lang.org/reference/time.html  |   83 +
 .../docs.racket-lang.org/reference/trait.html |   76 +
 .../docs.racket-lang.org/reference/udp.html   |  147 +
 .../reference/undefined.html                  |    5 +
 .../reference/unitcontracts.html              |   16 +
 .../reference/unixpaths.html                  |   27 +
 .../reference/unreachable.html                |   10 +
 .../reference/unsafe.html                     |  211 ++
 .../reference/values.html                     |   12 +
 .../reference/vectors.html                    |   84 +
 .../docs.racket-lang.org/reference/void.html  |    5 +
 .../docs.racket-lang.org/reference/wcm.html   |   13 +
 .../reference/weakbox.html                    |   14 +
 .../reference/when_unless.html                |    6 +
 .../reference/willexecutor.html               |   45 +
 .../reference/windowspaths.html               |  245 ++
 .../releases/8.6/doc/doc-site.css             |    0
 .../releases/8.6/doc/doc-site.js              |    0
 .../8.6/doc/guide/An_Extended_Example.html    |   22 +
 .../releases/8.6/doc/guide/Backtracking.html  |   28 +
 .../8.6/doc/guide/Building_New_Contracts.html |  185 ++
 .../8.6/doc/guide/Contracts_for_Units.html    |   16 +
 .../releases/8.6/doc/guide/Emacs.html         |   56 +
 .../8.6/doc/guide/Invoking_Units.html         |   18 +
 .../releases/8.6/doc/guide/Linking_Units.html |   17 +
 .../Lists__Iteration__and_Recursion.html      |   96 +
 .../doc/guide/Looking_Ahead_and_Behind.html   |   22 +
 .../releases/8.6/doc/guide/Module_Syntax.html |  107 +
 .../8.6/doc/guide/More_Libraries.html         |   40 +
 .../Pairs__Lists__and_Racket_Syntax.html      |   87 +
 .../8.6/doc/guide/Signatures_and_Units.html   |   17 +
 .../releases/8.6/doc/guide/Simple_Values.html |   15 +
 .../releases/8.6/doc/guide/Sublime_Text.html  |    3 +
 .../releases/8.6/doc/guide/Vim.html           |   55 +
 .../8.6/doc/guide/Visual_Studio_Code.html     |    3 +
 .../Whole-module_Signatures_and_Units.html    |   10 +
 .../releases/8.6/doc/guide/application.html   |   41 +
 .../releases/8.6/doc/guide/begin.html         |   27 +
 .../releases/8.6/doc/guide/binding.html       |   35 +
 .../releases/8.6/doc/guide/booleans.html      |    8 +
 .../releases/8.6/doc/guide/boxes.html         |    5 +
 .../releases/8.6/doc/guide/bytestrings.html   |   22 +
 .../releases/8.6/doc/guide/case.html          |   11 +
 .../releases/8.6/doc/guide/characters.html    |   27 +
 .../releases/8.6/doc/guide/classes.html       |  365 +++
 .../releases/8.6/doc/guide/cmdline-tools.html |   27 +
 .../doc/guide/code-inspectors_protect.html    |   34 +
 .../releases/8.6/doc/guide/concurrency.html   |  101 +
 .../releases/8.6/doc/guide/conditionals.html  |   47 +
 .../8.6/doc/guide/contract-boundaries.html    |   44 +
 .../releases/8.6/doc/guide/contract-func.html |  132 +
 .../8.6/doc/guide/contracts-examples.html     |   29 +
 .../8.6/doc/guide/contracts-exists.html       |   19 +
 .../8.6/doc/guide/contracts-first.html        |   78 +
 .../guide/contracts-general-functions.html    |  186 ++
 .../8.6/doc/guide/contracts-gotchas.html      |   61 +
 .../8.6/doc/guide/contracts-struct.html       |  107 +
 .../releases/8.6/doc/guide/contracts.html     |    3 +
 .../releases/8.6/doc/guide/control.html       |    4 +
 .../releases/8.6/doc/guide/conts.html         |   32 +
 .../releases/8.6/doc/guide/datatypes.html     |    5 +
 .../releases/8.6/doc/guide/default-ports.html |   13 +
 .../releases/8.6/doc/guide/define-struct.html |  170 +
 .../releases/8.6/doc/guide/define.html        |   38 +
 .../releases/8.6/doc/guide/dialects.html      |   13 +
 .../8.6/doc/guide/doc-bibliography.html       |    2 +
 .../releases/8.6/doc/guide/doc-index.html     |   17 +
 .../releases/8.6/doc/guide/encodings.html     |   26 +
 .../releases/8.6/doc/guide/eval.html          |   72 +
 .../releases/8.6/doc/guide/exe.html           |    4 +
 .../releases/8.6/doc/guide/exns.html          |   30 +
 .../releases/8.6/doc/guide/figure.css         |   37 +
 .../releases/8.6/doc/guide/figure.js          |   27 +
 .../releases/8.6/doc/guide/finger.png         |  Bin 0 -> 430 bytes
 .../8.6/doc/guide/firstclassunits.html        |   46 +
 .../releases/8.6/doc/guide/for.html           |  130 +
 .../8.6/doc/guide/hash-lang_reader.html       |   23 +
 .../8.6/doc/guide/hash-lang_syntax.html       |   43 +
 .../8.6/doc/guide/hash-languages.html         |    9 +
 .../releases/8.6/doc/guide/hash-reader.html   |   84 +
 .../releases/8.6/doc/guide/hash-tables.html   |   29 +
 .../releases/8.6/doc/guide/i_o.html           |    9 +
 .../releases/8.6/doc/guide/icons.css          |    8 +
 .../releases/8.6/doc/guide/index.html         |   10 +
 .../releases/8.6/doc/guide/intro.html         |   75 +
 .../releases/8.6/doc/guide/io-patterns.html   |   19 +
 .../releases/8.6/doc/guide/keywords.html      |   14 +
 .../releases/8.6/doc/guide/lambda.html        |   39 +
 .../8.6/doc/guide/language-collection.html    |   21 +
 .../8.6/doc/guide/language-get-info.html      |   48 +
 .../releases/8.6/doc/guide/languages.html     |   14 +
 .../releases/8.6/doc/guide/let.html           |   43 +
 .../releases/8.6/doc/guide/load.html          |   40 +
 .../releases/8.6/doc/guide/macro-module.html  |  136 +
 .../8.6/doc/guide/macro-transformers.html     |   21 +
 .../releases/8.6/doc/guide/macros.html        |   19 +
 .../releases/8.6/doc/guide/magnify.png        |  Bin 0 -> 323 bytes
 .../releases/8.6/doc/guide/match.html         |   31 +
 .../releases/8.6/doc/guide/mk-namespace.html  |   77 +
 .../releases/8.6/doc/guide/module-basics.html |  186 ++
 .../8.6/doc/guide/module-languages.html       |   49 +
 .../releases/8.6/doc/guide/module-macro.html  |   23 +
 .../releases/8.6/doc/guide/module-paths.html  |   83 +
 .../8.6/doc/guide/module-provide.html         |   31 +
 .../8.6/doc/guide/module-require.html         |   32 +
 .../8.6/doc/guide/module-runtime-config.html  |   63 +
 .../releases/8.6/doc/guide/module-set.html    |   25 +
 .../releases/8.6/doc/guide/modules.html       |    3 +
 .../8.6/doc/guide/more-hash-lang.html         |   30 +
 .../releases/8.6/doc/guide/numbers.html       |   49 +
 .../releases/8.6/doc/guide/other-editors.html |    6 +
 .../releases/8.6/doc/guide/pairs.html         |   28 +
 .../releases/8.6/doc/guide/parallelism.html   |  162 +
 .../releases/8.6/doc/guide/parameterize.html  |   44 +
 .../8.6/doc/guide/pattern-macros.html         |  127 +
 .../releases/8.6/doc/guide/performance.html   |  348 ++
 .../releases/8.6/doc/guide/phases.html        |  133 +
 .../releases/8.6/doc/guide/pict.png           |  Bin 0 -> 23264 bytes
 .../releases/8.6/doc/guide/pict_2.png         |  Bin 0 -> 27932 bytes
 .../releases/8.6/doc/guide/pict_3.png         |  Bin 0 -> 38288 bytes
 .../releases/8.6/doc/guide/pict_4.png         |  Bin 0 -> 28080 bytes
 .../releases/8.6/doc/guide/pict_5.png         |  Bin 0 -> 21361 bytes
 .../releases/8.6/doc/guide/ports.html         |   24 +
 .../releases/8.6/doc/guide/proc-macros.html   |    7 +
 .../releases/8.6/doc/guide/prompt.html        |   26 +
 .../releases/8.6/doc/guide/protect-out.html   |   19 +
 .../releases/8.6/doc/guide/qq.html            |   21 +
 .../releases/8.6/doc/guide/quote.html         |   18 +
 .../releases/8.6/doc/guide/racket.html        |   63 +
 .../releases/8.6/doc/guide/read-write.html    |   18 +
 .../releases/8.6/doc/guide/reflection.html    |    4 +
 .../8.6/doc/guide/regexp-alternation.html     |   14 +
 .../releases/8.6/doc/guide/regexp-assert.html |   10 +
 .../releases/8.6/doc/guide/regexp-chars.html  |   60 +
 .../8.6/doc/guide/regexp-clusters.html        |   50 +
 .../releases/8.6/doc/guide/regexp-intro.html  |   41 +
 .../releases/8.6/doc/guide/regexp-match.html  |   40 +
 .../releases/8.6/doc/guide/regexp-quant.html  |   26 +
 .../releases/8.6/doc/guide/regexp.html        |    7 +
 .../releases/8.6/doc/guide/running.html       |    6 +
 .../releases/8.6/doc/guide/scheme-forms.html  |    5 +
 .../releases/8.6/doc/guide/scripts.html       |   41 +
 .../releases/8.6/doc/guide/serialization.html |   18 +
 .../releases/8.6/doc/guide/set_.html          |   24 +
 .../releases/8.6/doc/guide/standards.html     |   31 +
 .../releases/8.6/doc/guide/strings.html       |   28 +
 .../releases/8.6/doc/guide/stx-certs.html     |   34 +
 .../releases/8.6/doc/guide/stx-obj.html       |   40 +
 .../releases/8.6/doc/guide/stx-phases.html    |   65 +
 .../releases/8.6/doc/guide/symbols.html       |   28 +
 .../releases/8.6/doc/guide/syntax-case.html   |   32 +
 .../8.6/doc/guide/syntax-notation.html        |   26 +
 .../8.6/doc/guide/syntax-overview.html        |  145 +
 .../8.6/doc/guide/syntax_module-reader.html   |   26 +
 .../8.6/doc/guide/teaching-langs.html         |    6 +
 .../releases/8.6/doc/guide/to-scheme.html     |    5 +
 .../8.6/doc/guide/unit_versus_module.html     |   36 +
 .../releases/8.6/doc/guide/units.html         |   15 +
 .../releases/8.6/doc/guide/vectors.html       |   16 +
 .../8.6/doc/guide/void_undefined.html         |   15 +
 .../releases/8.6/doc/guide/with-syntax.html   |   20 +
 .../8.6/doc/local-redirect/local-redirect.js  |  210 ++
 .../doc/local-redirect/local-user-redirect.js |    0
 .../releases/8.6/doc/manual-fonts.css         |  251 ++
 .../releases/8.6/doc/manual-racket.css        |  326 ++
 .../releases/8.6/doc/manual-racket.js         |  247 ++
 .../releases/8.6/doc/manual-style.css         |  784 +++++
 .../releases/8.6/doc/racket.css               |  251 ++
 .../releases/8.6/doc/scribble-common.js       |  196 ++
 .../releases/8.6/doc/scribble.css             |  516 +++
 clones/download.racket-lang.org/robots.txt    |    2 +
 .../llthw.common-lisp.dev/1-0-0-overview.html | 1863 +++++++++++
 .../1-01-00-lisp-bootcamp.html                | 1847 +++++++++++
 .../1-01-01-syntax-overview.html              | 1891 +++++++++++
 .../llthw.common-lisp.dev/1-01-02-repl.html   | 1854 +++++++++++
 .../1-01-03-expressions.html                  | 1901 +++++++++++
 .../1-01-04-lists-cons-cells.html             | 1877 +++++++++++
 .../1-01-05-symbols.html                      | 1896 +++++++++++
 .../1-01-06-prefix-notation.html              | 1841 +++++++++++
 .../1-01-07-style-guide.html                  | 2005 ++++++++++++
 .../1-01-08-configuration.html                | 1904 +++++++++++
 .../1-02-00-input-output.html                 | 1860 +++++++++++
 .../1-02-01-strings.html                      | 1846 +++++++++++
 .../1-02-02-more-strings.html                 | 1845 +++++++++++
 .../1-02-03-unicode.html                      | 1843 +++++++++++
 .../llthw.common-lisp.dev/1-02-04-chars.html  | 1858 +++++++++++
 .../1-02-05-more-chars.html                   | 1854 +++++++++++
 .../1-02-06-char-codes.html                   | 1845 +++++++++++
 .../1-02-07-strings-from-chars.html           | 1843 +++++++++++
 .../1-02-08-printing.html                     | 1869 +++++++++++
 .../1-02-09-more-printing.html                | 1869 +++++++++++
 .../llthw.common-lisp.dev/1-02-10-prin1.html  | 1849 +++++++++++
 .../llthw.common-lisp.dev/1-02-11-princ.html  | 1850 +++++++++++
 .../llthw.common-lisp.dev/1-02-12-format.html | 1868 +++++++++++
 .../1-02-13-more-format.html                  | 1872 +++++++++++
 .../1-02-14-pathnames.html                    | 1884 +++++++++++
 .../1-02-15-streams.html                      | 1867 +++++++++++
 .../1-02-16-file-streams.html                 | 1869 +++++++++++
 .../1-02-17-binary-streams.html               | 1857 +++++++++++
 .../1-02-18-prompting-users.html              | 1856 +++++++++++
 .../1-02-19-pretty-printing.html              | 1846 +++++++++++
 .../1-03-0-getting-input-from-users.html      | 2028 ++++++++++++
 .../llthw.common-lisp.dev/1-04-0-lists.html   | 2363 ++++++++++++++
 .../1-05-0-lookups-trees.html                 | 2814 +++++++++++++++++
 clones/llthw.common-lisp.dev/1-06-0-math.html | 1856 +++++++++++
 .../1-06-01-integers.html                     | 1865 +++++++++++
 .../1-06-02-more-integers.html                | 1863 +++++++++++
 .../1-06-03-hexadecimal-notation.html         | 1888 +++++++++++
 .../1-06-04-octal-notation.html               | 1888 +++++++++++
 .../1-06-05-binary-notation.html              | 1893 +++++++++++
 .../llthw.common-lisp.dev/1-06-06-ratios.html | 1886 +++++++++++
 .../1-06-07-floating-point.html               | 1875 +++++++++++
 .../1-06-08-constants.html                    | 1864 +++++++++++
 .../1-06-09-complex-numbers.html              | 1848 +++++++++++
 .../1-06-10-arithmetic.html                   | 1879 +++++++++++
 .../1-06-11-more-arithmetic.html              | 1873 +++++++++++
 .../1-06-12-even-more-arithmetic.html         | 1842 +++++++++++
 .../1-06-13-exponents.html                    | 1847 +++++++++++
 .../1-06-14-logarithms.html                   | 1847 +++++++++++
 .../1-06-15-trigonometry.html                 | 1852 +++++++++++
 .../1-06-16-psuedorandom-numbers.html         | 1865 +++++++++++
 .../llthw.common-lisp.dev/1-07-0-arrays.html  | 1923 +++++++++++
 .../1-08-0-variables.html                     | 1900 +++++++++++
 .../1-09-0-closures.html                      | 1917 +++++++++++
 .../1-10-0-functions.html                     | 1936 ++++++++++++
 .../1-11-0-text-adventure.html                | 1906 +++++++++++
 .../1-12-0-namespaces.html                    | 2351 ++++++++++++++
 .../1-13-0-simple-web-app.html                | 1882 +++++++++++
 .../1-14-0-conditionals.html                  | 1890 +++++++++++
 .../1-15-0-command-line-utility.html          | 1865 +++++++++++
 .../1-16-0-map-loop.html                      | 1892 +++++++++++
 .../llthw.common-lisp.dev/1-17-0-iterate.html | 1876 +++++++++++
 .../llthw.common-lisp.dev/1-18-0-format.html  | 1881 +++++++++++
 clones/llthw.common-lisp.dev/1-19-0-dsl.html  | 1897 +++++++++++
 .../llthw.common-lisp.dev/1-20-0-review.html  | 1845 +++++++++++
 .../llthw.common-lisp.dev/2-0-0-overview.html | 1862 +++++++++++
 .../2-01-0-programming-paradigms.html         | 1923 +++++++++++
 .../llthw.common-lisp.dev/2-02-0-regex.html   | 1901 +++++++++++
 .../2-03-0-objects-control.html               | 1978 ++++++++++++
 .../2-04-0-data-persistence.html              | 1925 +++++++++++
 .../2-05-0-extended-types.html                | 1928 +++++++++++
 .../2-06-0-threads-memos-parallel.html        | 1908 +++++++++++
 .../2-07-0-logic-and-more-math.html           | 1945 ++++++++++++
 .../2-08-0-number-theory.html                 | 1947 ++++++++++++
 .../2-09-0-binary-octets-bits.html            | 1923 +++++++++++
 ...2-10-0-improved-text-adventure-engine.html | 1904 +++++++++++
 .../2-11-0-conditions.html                    | 1903 +++++++++++
 .../llthw.common-lisp.dev/2-12-0-2d-game.html | 1944 ++++++++++++
 .../2-13-0-compiler.html                      | 1918 +++++++++++
 .../2-14-0-tree-shaker.html                   | 1912 +++++++++++
 .../2-15-0-docs-and-inspection.html           | 1904 +++++++++++
 .../2-16-0-foreign-libs.html                  | 1882 +++++++++++
 .../2-17-0-debugging-testing.html             | 1902 +++++++++++
 clones/llthw.common-lisp.dev/2-18-0-ffi.html  | 1873 +++++++++++
 .../2-19-0-essential-libs.html                | 1952 ++++++++++++
 .../2-20-0-packaging-libs.html                | 1907 +++++++++++
 .../llthw.common-lisp.dev/2-21-0-review.html  | 1852 +++++++++++
 .../3-00-00-overview.html                     | 1863 +++++++++++
 .../3-01-00-web-apps.html                     | 1899 +++++++++++
 .../3-02-00-typesetting.html                  | 1929 +++++++++++
 .../llthw.common-lisp.dev/3-03-00-mobile.html | 1860 +++++++++++
 clones/llthw.common-lisp.dev/3-04-00-gui.html | 1880 +++++++++++
 .../3-05-00-system-utils.html                 | 1878 +++++++++++
 .../3-06-00-reverse-engineering.html          | 1893 +++++++++++
 .../3-07-00-graphics.html                     | 1893 +++++++++++
 .../llthw.common-lisp.dev/3-08-00-gaming.html | 1885 +++++++++++
 .../llthw.common-lisp.dev/3-09-00-audio.html  | 1889 +++++++++++
 .../llthw.common-lisp.dev/3-10-00-data.html   | 1874 +++++++++++
 .../3-11-00-cryptosec.html                    | 1884 +++++++++++
 .../3-12-00-fintech.html                      | 1913 +++++++++++
 .../3-13-00-scientific-computing.html         | 1878 +++++++++++
 .../3-14-00-computational-physics.html        | 1889 +++++++++++
 .../3-15-00-quantum-computing.html            | 1918 +++++++++++
 clones/llthw.common-lisp.dev/3-16-00-nlp.html | 1882 +++++++++++
 clones/llthw.common-lisp.dev/3-17-00-ai.html  | 1917 +++++++++++
 .../3-18-00-robotics.html                     | 1918 +++++++++++
 .../3-19-00-space-tech.html                   | 1905 +++++++++++
 .../3-20-00-neurotech.html                    | 1907 +++++++++++
 .../llthw.common-lisp.dev/3-21-00-lispos.html | 1890 +++++++++++
 .../3-22-00-lisp-machine.html                 | 1911 +++++++++++
 .../3-23-00-gov-mil.html                      | 1940 ++++++++++++
 clones/llthw.common-lisp.dev/CHANGELOG.html   | 1851 +++++++++++
 clones/llthw.common-lisp.dev/TODO.html        | 1840 +++++++++++
 .../acknowledgements.html                     | 1838 +++++++++++
 .../fontawesome/fontawesome-webfont.eot?      |  Bin 0 -> 76518 bytes
 .../fontawesome-webfont.eot?v=4.6.3           |  Bin 0 -> 76518 bytes
 .../fontawesome-webfont.svg?v=4.6.3           |  685 ++++
 .../fontawesome-webfont.ttf?v=4.6.3           |  Bin 0 -> 152796 bytes
 .../fontawesome-webfont.woff2?v=4.6.3         |  Bin 0 -> 71896 bytes
 .../fontawesome-webfont.woff?v=4.6.3          |  Bin 0 -> 90412 bytes
 .../folding-chapters.css                      |   22 +
 .../folding-chapters.js                       |   70 +
 .../fontsettings.js                           |  240 ++
 .../gitbook-plugin-fontsettings/website.css   |  291 ++
 .../gitbook-plugin-highlight/website.css      |  434 +++
 .../gitbook-plugin-hints/plugin-hints.css     |    9 +
 .../gitbook/gitbook-plugin-lunr/lunr.min.js   |    7 +
 .../gitbook-plugin-lunr/search-lunr.js        |   59 +
 .../gitbook-plugin-search/search-engine.js    |   50 +
 .../gitbook/gitbook-plugin-search/search.css  |   35 +
 .../gitbook/gitbook-plugin-search/search.js   |  213 ++
 .../gitbook/gitbook-plugin-sharing/buttons.js |   90 +
 .../llthw.common-lisp.dev/gitbook/gitbook.js  |    4 +
 .../apple-touch-icon-precomposed-152.png      |  Bin 0 -> 4817 bytes
 .../gitbook/images/favicon.ico                |  Bin 0 -> 4286 bytes
 .../llthw.common-lisp.dev/gitbook/style.css   |    9 +
 clones/llthw.common-lisp.dev/gitbook/theme.js |    4 +
 clones/llthw.common-lisp.dev/index.html       | 1882 +++++++++++
 .../llthw.common-lisp.dev/introduction.html   | 1853 +++++++++++
 .../preface-part-three.html                   | 1859 +++++++++++
 .../preface-part-two.html                     | 1864 +++++++++++
 clones/llthw.common-lisp.dev/preface.html     | 1838 +++++++++++
 587 files changed, 278375 insertions(+), 2 deletions(-)
 create mode 100644 clones/clojure-doc.org/articles/about/index.html
 create mode 100644 clones/clojure-doc.org/articles/content/index.html
 create mode 100644 clones/clojure-doc.org/articles/cookbooks/data_structures/index.html
 create mode 100644 clones/clojure-doc.org/articles/cookbooks/date_and_time/index.html
 create mode 100644 clones/clojure-doc.org/articles/cookbooks/files_and_directories/index.html
 create mode 100644 clones/clojure-doc.org/articles/cookbooks/math/index.html
 create mode 100644 clones/clojure-doc.org/articles/cookbooks/middleware/index.html
 create mode 100644 clones/clojure-doc.org/articles/cookbooks/strings/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/books/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/community/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/core_typed/filters/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/core_typed/function_types/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/core_typed/home/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/core_typed/limitations/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/core_typed/loops/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/core_typed/mm_protocol_datatypes/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/core_typed/poly_fn/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/core_typed/quick_guide.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/core_typed/quick_guide/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/core_typed/rationale/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/core_typed/start/annotations/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/core_typed/start/introduction_and_motivation/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/core_typed/types/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/core_typed/user_documentation/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/data_processing/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/generating_documentation/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/java_jdbc/home.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/java_jdbc/home/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/java_jdbc/reusing_connections.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/java_jdbc/reusing_connections/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/java_jdbc/using_ddl.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/java_jdbc/using_ddl/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/java_jdbc/using_sql.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/java_jdbc/using_sql/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/libraries_authoring/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/libraries_directory/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/maven/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/running_cljug/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/user_groups/index.html
 create mode 100644 clones/clojure-doc.org/articles/ecosystem/web_development/index.html
 create mode 100644 clones/clojure-doc.org/articles/language/collections_and_sequences/index.html
 create mode 100644 clones/clojure-doc.org/articles/language/concurrency_and_parallelism/index.html
 create mode 100644 clones/clojure-doc.org/articles/language/core_overview/index.html
 create mode 100644 clones/clojure-doc.org/articles/language/functions/index.html
 create mode 100644 clones/clojure-doc.org/articles/language/glossary/index.html
 create mode 100644 clones/clojure-doc.org/articles/language/interop/index.html
 create mode 100644 clones/clojure-doc.org/articles/language/laziness/index.html
 create mode 100644 clones/clojure-doc.org/articles/language/macros/index.html
 create mode 100644 clones/clojure-doc.org/articles/language/namespaces/index.html
 create mode 100644 clones/clojure-doc.org/articles/language/polymorphism/index.html
 create mode 100644 clones/clojure-doc.org/articles/tutorials/basic_web_development/index.html
 create mode 100644 clones/clojure-doc.org/articles/tutorials/eclipse/index.html
 create mode 100644 clones/clojure-doc.org/articles/tutorials/emacs/index.html
 create mode 100644 clones/clojure-doc.org/articles/tutorials/getting_started/index.html
 create mode 100644 clones/clojure-doc.org/articles/tutorials/growing_a_dsl_with_clojure/index.html
 create mode 100644 clones/clojure-doc.org/articles/tutorials/introduction/index.html
 create mode 100644 clones/clojure-doc.org/articles/tutorials/parsing_xml_with_zippers/index.html
 create mode 100644 clones/clojure-doc.org/articles/tutorials/vim_fireplace/index.html
 create mode 100644 clones/clojure-doc.org/css/screen.css
 create mode 100644 clones/clojure-doc.org/index.html
 create mode 100644 clones/clojure-doc.org/js/highlight.pack.js
 create mode 100644 clones/docs.racket-lang.org/reference/Building_New_Contract_Combinators.html
 create mode 100644 clones/docs.racket-lang.org/reference/Byte_and_String_Input.html
 create mode 100644 clones/docs.racket-lang.org/reference/Byte_and_String_Output.html
 create mode 100644 clones/docs.racket-lang.org/reference/Command-Line_Parsing.html
 create mode 100644 clones/docs.racket-lang.org/reference/Delayed_Evaluation.html
 create mode 100644 clones/docs.racket-lang.org/reference/Equality.html
 create mode 100644 clones/docs.racket-lang.org/reference/Exiting.html
 create mode 100644 clones/docs.racket-lang.org/reference/Expanding_Top-Level_Forms.html
 create mode 100644 clones/docs.racket-lang.org/reference/Filesystem.html
 create mode 100644 clones/docs.racket-lang.org/reference/Generating_A_Unit_from_Context.html
 create mode 100644 clones/docs.racket-lang.org/reference/Generators.html
 create mode 100644 clones/docs.racket-lang.org/reference/Interactive_Help.html
 create mode 100644 clones/docs.racket-lang.org/reference/Kernel_Forms_and_Functions.html
 create mode 100644 clones/docs.racket-lang.org/reference/Lazy_Data-structure_Contracts.html
 create mode 100644 clones/docs.racket-lang.org/reference/Legacy_Contracts.html
 create mode 100644 clones/docs.racket-lang.org/reference/Locations____variable-reference.html
 create mode 100644 clones/docs.racket-lang.org/reference/Macros.html
 create mode 100644 clones/docs.racket-lang.org/reference/Manipulating_Paths.html
 create mode 100644 clones/docs.racket-lang.org/reference/Module_Names_and_Loading.html
 create mode 100644 clones/docs.racket-lang.org/reference/More_Path_Utilities.html
 create mode 100644 clones/docs.racket-lang.org/reference/Namespaces.html
 create mode 100644 clones/docs.racket-lang.org/reference/Object_and_Class_Contracts.html
 create mode 100644 clones/docs.racket-lang.org/reference/Printer_Extension.html
 create mode 100644 clones/docs.racket-lang.org/reference/Random_generation.html
 create mode 100644 clones/docs.racket-lang.org/reference/Reader_Extension.html
 create mode 100644 clones/docs.racket-lang.org/reference/Reading.html
 create mode 100644 clones/docs.racket-lang.org/reference/Sandboxed_Evaluation.html
 create mode 100644 clones/docs.racket-lang.org/reference/Serializing_Syntax.html
 create mode 100644 clones/docs.racket-lang.org/reference/Single-Signature_Modules.html
 create mode 100644 clones/docs.racket-lang.org/reference/Structural_Matching.html
 create mode 100644 clones/docs.racket-lang.org/reference/Structure_Type_Property_Contracts.html
 create mode 100644 clones/docs.racket-lang.org/reference/Surrogates.html
 create mode 100644 clones/docs.racket-lang.org/reference/Syntax_Quoting__quote-syntax.html
 create mode 100644 clones/docs.racket-lang.org/reference/Transformer_Helpers.html
 create mode 100644 clones/docs.racket-lang.org/reference/Unit_Utilities.html
 create mode 100644 clones/docs.racket-lang.org/reference/Writing.html
 create mode 100644 clones/docs.racket-lang.org/reference/__expression.html
 create mode 100644 clones/docs.racket-lang.org/reference/__top-interaction.html
 create mode 100644 clones/docs.racket-lang.org/reference/__top.html
 create mode 100644 clones/docs.racket-lang.org/reference/all-sync.html
 create mode 100644 clones/docs.racket-lang.org/reference/application.html
 create mode 100644 clones/docs.racket-lang.org/reference/async-channel.html
 create mode 100644 clones/docs.racket-lang.org/reference/attaching-contracts-to-values.html
 create mode 100644 clones/docs.racket-lang.org/reference/begin.html
 create mode 100644 clones/docs.racket-lang.org/reference/block.html
 create mode 100644 clones/docs.racket-lang.org/reference/booleans.html
 create mode 100644 clones/docs.racket-lang.org/reference/boxes.html
 create mode 100644 clones/docs.racket-lang.org/reference/breakhandler.html
 create mode 100644 clones/docs.racket-lang.org/reference/bytestrings.html
 create mode 100644 clones/docs.racket-lang.org/reference/case.html
 create mode 100644 clones/docs.racket-lang.org/reference/channel.html
 create mode 100644 clones/docs.racket-lang.org/reference/chaperones.html
 create mode 100644 clones/docs.racket-lang.org/reference/characters.html
 create mode 100644 clones/docs.racket-lang.org/reference/collapsible.html
 create mode 100644 clones/docs.racket-lang.org/reference/collects.html
 create mode 100644 clones/docs.racket-lang.org/reference/compiler.html
 create mode 100644 clones/docs.racket-lang.org/reference/compoundunits.html
 create mode 100644 clones/docs.racket-lang.org/reference/concurrency.html
 create mode 100644 clones/docs.racket-lang.org/reference/cont.html
 create mode 100644 clones/docs.racket-lang.org/reference/contmarks.html
 create mode 100644 clones/docs.racket-lang.org/reference/contract-utilities.html
 create mode 100644 clones/docs.racket-lang.org/reference/contracts.html
 create mode 100644 clones/docs.racket-lang.org/reference/control.html
 create mode 100644 clones/docs.racket-lang.org/reference/createclass.html
 create mode 100644 clones/docs.racket-lang.org/reference/createinterface.html
 create mode 100644 clones/docs.racket-lang.org/reference/creatingmorestructs.html
 create mode 100644 clones/docs.racket-lang.org/reference/creatingunits.html
 create mode 100644 clones/docs.racket-lang.org/reference/custodians.html
 create mode 100644 clones/docs.racket-lang.org/reference/customport.html
 create mode 100644 clones/docs.racket-lang.org/reference/data-structure-contracts.html
 create mode 100644 clones/docs.racket-lang.org/reference/data.html
 create mode 100644 clones/docs.racket-lang.org/reference/debugging.html
 create mode 100644 clones/docs.racket-lang.org/reference/define-sig-form.html
 create mode 100644 clones/docs.racket-lang.org/reference/define-struct.html
 create mode 100644 clones/docs.racket-lang.org/reference/define.html
 create mode 100644 clones/docs.racket-lang.org/reference/dicts.html
 create mode 100644 clones/docs.racket-lang.org/reference/doc-bibliography.html
 create mode 100644 clones/docs.racket-lang.org/reference/doc-index.html
 create mode 100644 clones/docs.racket-lang.org/reference/encodings.html
 create mode 100644 clones/docs.racket-lang.org/reference/engine.html
 create mode 100644 clones/docs.racket-lang.org/reference/envvars.html
 create mode 100644 clones/docs.racket-lang.org/reference/ephemerons.html
 create mode 100644 clones/docs.racket-lang.org/reference/eval-model.html
 create mode 100644 clones/docs.racket-lang.org/reference/eval.html
 create mode 100644 clones/docs.racket-lang.org/reference/exns.html
 create mode 100644 clones/docs.racket-lang.org/reference/extflonums.html
 create mode 100644 clones/docs.racket-lang.org/reference/extras.css
 create mode 100644 clones/docs.racket-lang.org/reference/fasl.html
 create mode 100644 clones/docs.racket-lang.org/reference/file-ports.html
 create mode 100644 clones/docs.racket-lang.org/reference/finger.png
 create mode 100644 clones/docs.racket-lang.org/reference/fixnums.html
 create mode 100644 clones/docs.racket-lang.org/reference/flonums.html
 create mode 100644 clones/docs.racket-lang.org/reference/for.html
 create mode 100644 clones/docs.racket-lang.org/reference/function-contracts.html
 create mode 100644 clones/docs.racket-lang.org/reference/futures.html
 create mode 100644 clones/docs.racket-lang.org/reference/garbagecollection.html
 create mode 100644 clones/docs.racket-lang.org/reference/generic-numbers.html
 create mode 100644 clones/docs.racket-lang.org/reference/hashtables.html
 create mode 100644 clones/docs.racket-lang.org/reference/icons.css
 create mode 100644 clones/docs.racket-lang.org/reference/if.html
 create mode 100644 clones/docs.racket-lang.org/reference/implementations.html
 create mode 100644 clones/docs.racket-lang.org/reference/include.html
 create mode 100644 clones/docs.racket-lang.org/reference/index.html
 create mode 100644 clones/docs.racket-lang.org/reference/input-and-output.html
 create mode 100644 clones/docs.racket-lang.org/reference/inspectors.html
 create mode 100644 clones/docs.racket-lang.org/reference/interaction-info.html
 create mode 100644 clones/docs.racket-lang.org/reference/interactive.html
 create mode 100644 clones/docs.racket-lang.org/reference/invokingunits.html
 create mode 100644 clones/docs.racket-lang.org/reference/ivaraccess.html
 create mode 100644 clones/docs.racket-lang.org/reference/keywords.html
 create mode 100644 clones/docs.racket-lang.org/reference/lambda.html
 create mode 100644 clones/docs.racket-lang.org/reference/lazy-require.html
 create mode 100644 clones/docs.racket-lang.org/reference/let.html
 create mode 100644 clones/docs.racket-lang.org/reference/linecol.html
 create mode 100644 clones/docs.racket-lang.org/reference/linkinference.html
 create mode 100644 clones/docs.racket-lang.org/reference/linklets.html
 create mode 100644 clones/docs.racket-lang.org/reference/load-lang.html
 create mode 100644 clones/docs.racket-lang.org/reference/local.html
 create mode 100644 clones/docs.racket-lang.org/reference/logging.html
 create mode 100644 clones/docs.racket-lang.org/reference/magnify.png
 create mode 100644 clones/docs.racket-lang.org/reference/match.html
 create mode 100644 clones/docs.racket-lang.org/reference/memory-order.html
 create mode 100644 clones/docs.racket-lang.org/reference/memory.html
 create mode 100644 clones/docs.racket-lang.org/reference/mixins.html
 create mode 100644 clones/docs.racket-lang.org/reference/model.html
 create mode 100644 clones/docs.racket-lang.org/reference/modprotect.html
 create mode 100644 clones/docs.racket-lang.org/reference/module.html
 create mode 100644 clones/docs.racket-lang.org/reference/mpairs.html
 create mode 100644 clones/docs.racket-lang.org/reference/mzlib_class.html
 create mode 100644 clones/docs.racket-lang.org/reference/mzlib_unit.html
 create mode 100644 clones/docs.racket-lang.org/reference/networking.html
 create mode 100644 clones/docs.racket-lang.org/reference/notation.html
 create mode 100644 clones/docs.racket-lang.org/reference/number-types.html
 create mode 100644 clones/docs.racket-lang.org/reference/numbers.html
 create mode 100644 clones/docs.racket-lang.org/reference/objcreation.html
 create mode 100644 clones/docs.racket-lang.org/reference/objectequality.html
 create mode 100644 clones/docs.racket-lang.org/reference/objectprinting.html
 create mode 100644 clones/docs.racket-lang.org/reference/objectserialize.html
 create mode 100644 clones/docs.racket-lang.org/reference/objectutils.html
 create mode 100644 clones/docs.racket-lang.org/reference/os-lib.html
 create mode 100644 clones/docs.racket-lang.org/reference/os.html
 create mode 100644 clones/docs.racket-lang.org/reference/pairs.html
 create mode 100644 clones/docs.racket-lang.org/reference/parameters.html
 create mode 100644 clones/docs.racket-lang.org/reference/parametric-contracts.html
 create mode 100644 clones/docs.racket-lang.org/reference/pathutils.html
 create mode 100644 clones/docs.racket-lang.org/reference/performance-hint.html
 create mode 100644 clones/docs.racket-lang.org/reference/phantom-bytes.html
 create mode 100644 clones/docs.racket-lang.org/reference/phase_space.html
 create mode 100644 clones/docs.racket-lang.org/reference/pipeports.html
 create mode 100644 clones/docs.racket-lang.org/reference/places.html
 create mode 100644 clones/docs.racket-lang.org/reference/plumbers.html
 create mode 100644 clones/docs.racket-lang.org/reference/port-buffers.html
 create mode 100644 clones/docs.racket-lang.org/reference/port-lib.html
 create mode 100644 clones/docs.racket-lang.org/reference/port-ops.html
 create mode 100644 clones/docs.racket-lang.org/reference/ports.html
 create mode 100644 clones/docs.racket-lang.org/reference/portstructs.html
 create mode 100644 clones/docs.racket-lang.org/reference/pretty-print.html
 create mode 100644 clones/docs.racket-lang.org/reference/printing.html
 create mode 100644 clones/docs.racket-lang.org/reference/procedures.html
 create mode 100644 clones/docs.racket-lang.org/reference/quasiquote.html
 create mode 100644 clones/docs.racket-lang.org/reference/quote.html
 create mode 100644 clones/docs.racket-lang.org/reference/racket_contract_base.html
 create mode 100644 clones/docs.racket-lang.org/reference/reader-procs.html
 create mode 100644 clones/docs.racket-lang.org/reference/reader.html
 create mode 100644 clones/docs.racket-lang.org/reference/readtables.html
 create mode 100644 clones/docs.racket-lang.org/reference/regexp.html
 create mode 100644 clones/docs.racket-lang.org/reference/repl-module.html
 create mode 100644 clones/docs.racket-lang.org/reference/require.html
 create mode 100644 clones/docs.racket-lang.org/reference/running-sa.html
 create mode 100644 clones/docs.racket-lang.org/reference/running.html
 create mode 100644 clones/docs.racket-lang.org/reference/runtime.html
 create mode 100644 clones/docs.racket-lang.org/reference/security.html
 create mode 100644 clones/docs.racket-lang.org/reference/securityguards.html
 create mode 100644 clones/docs.racket-lang.org/reference/semaphore.html
 create mode 100644 clones/docs.racket-lang.org/reference/sequences.html
 create mode 100644 clones/docs.racket-lang.org/reference/sequences_streams.html
 create mode 100644 clones/docs.racket-lang.org/reference/serialization.html
 create mode 100644 clones/docs.racket-lang.org/reference/set_.html
 create mode 100644 clones/docs.racket-lang.org/reference/sets.html
 create mode 100644 clones/docs.racket-lang.org/reference/sha.html
 create mode 100644 clones/docs.racket-lang.org/reference/shared.html
 create mode 100644 clones/docs.racket-lang.org/reference/single-unit.html
 create mode 100644 clones/docs.racket-lang.org/reference/special-comments.html
 create mode 100644 clones/docs.racket-lang.org/reference/splicing.html
 create mode 100644 clones/docs.racket-lang.org/reference/stencil_vectors.html
 create mode 100644 clones/docs.racket-lang.org/reference/stratified-body.html
 create mode 100644 clones/docs.racket-lang.org/reference/streams.html
 create mode 100644 clones/docs.racket-lang.org/reference/stringport.html
 create mode 100644 clones/docs.racket-lang.org/reference/strings.html
 create mode 100644 clones/docs.racket-lang.org/reference/struct-copy.html
 create mode 100644 clones/docs.racket-lang.org/reference/struct-generics.html
 create mode 100644 clones/docs.racket-lang.org/reference/structinfo.html
 create mode 100644 clones/docs.racket-lang.org/reference/structprops.html
 create mode 100644 clones/docs.racket-lang.org/reference/structures.html
 create mode 100644 clones/docs.racket-lang.org/reference/structutils.html
 create mode 100644 clones/docs.racket-lang.org/reference/stx-patterns.html
 create mode 100644 clones/docs.racket-lang.org/reference/stxcerts.html
 create mode 100644 clones/docs.racket-lang.org/reference/stxcmp.html
 create mode 100644 clones/docs.racket-lang.org/reference/stxops.html
 create mode 100644 clones/docs.racket-lang.org/reference/stxparam.html
 create mode 100644 clones/docs.racket-lang.org/reference/stxprops.html
 create mode 100644 clones/docs.racket-lang.org/reference/stxtrans.html
 create mode 100644 clones/docs.racket-lang.org/reference/subprocess.html
 create mode 100644 clones/docs.racket-lang.org/reference/symbols.html
 create mode 100644 clones/docs.racket-lang.org/reference/sync.html
 create mode 100644 clones/docs.racket-lang.org/reference/syntax-model.html
 create mode 100644 clones/docs.racket-lang.org/reference/syntax-util.html
 create mode 100644 clones/docs.racket-lang.org/reference/syntax.html
 create mode 100644 clones/docs.racket-lang.org/reference/tcp.html
 create mode 100644 clones/docs.racket-lang.org/reference/thread-local-storage.html
 create mode 100644 clones/docs.racket-lang.org/reference/threadcells.html
 create mode 100644 clones/docs.racket-lang.org/reference/threadgroups.html
 create mode 100644 clones/docs.racket-lang.org/reference/threads.html
 create mode 100644 clones/docs.racket-lang.org/reference/time.html
 create mode 100644 clones/docs.racket-lang.org/reference/trait.html
 create mode 100644 clones/docs.racket-lang.org/reference/udp.html
 create mode 100644 clones/docs.racket-lang.org/reference/undefined.html
 create mode 100644 clones/docs.racket-lang.org/reference/unitcontracts.html
 create mode 100644 clones/docs.racket-lang.org/reference/unixpaths.html
 create mode 100644 clones/docs.racket-lang.org/reference/unreachable.html
 create mode 100644 clones/docs.racket-lang.org/reference/unsafe.html
 create mode 100644 clones/docs.racket-lang.org/reference/values.html
 create mode 100644 clones/docs.racket-lang.org/reference/vectors.html
 create mode 100644 clones/docs.racket-lang.org/reference/void.html
 create mode 100644 clones/docs.racket-lang.org/reference/wcm.html
 create mode 100644 clones/docs.racket-lang.org/reference/weakbox.html
 create mode 100644 clones/docs.racket-lang.org/reference/when_unless.html
 create mode 100644 clones/docs.racket-lang.org/reference/willexecutor.html
 create mode 100644 clones/docs.racket-lang.org/reference/windowspaths.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/doc-site.css
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/doc-site.js
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/An_Extended_Example.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/Backtracking.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/Building_New_Contracts.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/Contracts_for_Units.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/Emacs.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/Invoking_Units.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/Linking_Units.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/Lists__Iteration__and_Recursion.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/Looking_Ahead_and_Behind.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/Module_Syntax.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/More_Libraries.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/Pairs__Lists__and_Racket_Syntax.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/Signatures_and_Units.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/Simple_Values.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/Sublime_Text.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/Vim.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/Visual_Studio_Code.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/Whole-module_Signatures_and_Units.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/application.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/begin.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/binding.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/booleans.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/boxes.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/bytestrings.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/case.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/characters.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/classes.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/cmdline-tools.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/code-inspectors_protect.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/concurrency.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/conditionals.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/contract-boundaries.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/contract-func.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-examples.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-exists.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-first.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-general-functions.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-gotchas.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-struct.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/contracts.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/control.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/conts.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/datatypes.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/default-ports.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/define-struct.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/define.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/dialects.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/doc-bibliography.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/doc-index.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/encodings.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/eval.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/exe.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/exns.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/figure.css
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/figure.js
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/finger.png
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/firstclassunits.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/for.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/hash-lang_reader.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/hash-lang_syntax.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/hash-languages.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/hash-reader.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/hash-tables.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/i_o.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/icons.css
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/index.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/intro.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/io-patterns.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/keywords.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/lambda.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/language-collection.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/language-get-info.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/languages.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/let.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/load.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/macro-module.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/macro-transformers.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/macros.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/magnify.png
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/match.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/mk-namespace.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/module-basics.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/module-languages.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/module-macro.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/module-paths.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/module-provide.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/module-require.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/module-runtime-config.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/module-set.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/modules.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/more-hash-lang.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/numbers.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/other-editors.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/pairs.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/parallelism.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/parameterize.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/pattern-macros.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/performance.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/phases.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/pict.png
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/pict_2.png
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/pict_3.png
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/pict_4.png
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/pict_5.png
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/ports.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/proc-macros.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/prompt.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/protect-out.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/qq.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/quote.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/racket.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/read-write.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/reflection.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-alternation.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-assert.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-chars.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-clusters.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-intro.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-match.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-quant.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/regexp.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/running.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/scheme-forms.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/scripts.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/serialization.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/set_.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/standards.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/strings.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/stx-certs.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/stx-obj.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/stx-phases.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/symbols.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/syntax-case.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/syntax-notation.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/syntax-overview.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/syntax_module-reader.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/teaching-langs.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/to-scheme.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/unit_versus_module.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/units.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/vectors.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/void_undefined.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/guide/with-syntax.html
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/local-redirect/local-redirect.js
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/local-redirect/local-user-redirect.js
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/manual-fonts.css
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/manual-racket.css
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/manual-racket.js
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/manual-style.css
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/racket.css
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/scribble-common.js
 create mode 100644 clones/download.racket-lang.org/releases/8.6/doc/scribble.css
 create mode 100644 clones/download.racket-lang.org/robots.txt
 create mode 100644 clones/llthw.common-lisp.dev/1-0-0-overview.html
 create mode 100644 clones/llthw.common-lisp.dev/1-01-00-lisp-bootcamp.html
 create mode 100644 clones/llthw.common-lisp.dev/1-01-01-syntax-overview.html
 create mode 100644 clones/llthw.common-lisp.dev/1-01-02-repl.html
 create mode 100644 clones/llthw.common-lisp.dev/1-01-03-expressions.html
 create mode 100644 clones/llthw.common-lisp.dev/1-01-04-lists-cons-cells.html
 create mode 100644 clones/llthw.common-lisp.dev/1-01-05-symbols.html
 create mode 100644 clones/llthw.common-lisp.dev/1-01-06-prefix-notation.html
 create mode 100644 clones/llthw.common-lisp.dev/1-01-07-style-guide.html
 create mode 100644 clones/llthw.common-lisp.dev/1-01-08-configuration.html
 create mode 100644 clones/llthw.common-lisp.dev/1-02-00-input-output.html
 create mode 100644 clones/llthw.common-lisp.dev/1-02-01-strings.html
 create mode 100644 clones/llthw.common-lisp.dev/1-02-02-more-strings.html
 create mode 100644 clones/llthw.common-lisp.dev/1-02-03-unicode.html
 create mode 100644 clones/llthw.common-lisp.dev/1-02-04-chars.html
 create mode 100644 clones/llthw.common-lisp.dev/1-02-05-more-chars.html
 create mode 100644 clones/llthw.common-lisp.dev/1-02-06-char-codes.html
 create mode 100644 clones/llthw.common-lisp.dev/1-02-07-strings-from-chars.html
 create mode 100644 clones/llthw.common-lisp.dev/1-02-08-printing.html
 create mode 100644 clones/llthw.common-lisp.dev/1-02-09-more-printing.html
 create mode 100644 clones/llthw.common-lisp.dev/1-02-10-prin1.html
 create mode 100644 clones/llthw.common-lisp.dev/1-02-11-princ.html
 create mode 100644 clones/llthw.common-lisp.dev/1-02-12-format.html
 create mode 100644 clones/llthw.common-lisp.dev/1-02-13-more-format.html
 create mode 100644 clones/llthw.common-lisp.dev/1-02-14-pathnames.html
 create mode 100644 clones/llthw.common-lisp.dev/1-02-15-streams.html
 create mode 100644 clones/llthw.common-lisp.dev/1-02-16-file-streams.html
 create mode 100644 clones/llthw.common-lisp.dev/1-02-17-binary-streams.html
 create mode 100644 clones/llthw.common-lisp.dev/1-02-18-prompting-users.html
 create mode 100644 clones/llthw.common-lisp.dev/1-02-19-pretty-printing.html
 create mode 100644 clones/llthw.common-lisp.dev/1-03-0-getting-input-from-users.html
 create mode 100644 clones/llthw.common-lisp.dev/1-04-0-lists.html
 create mode 100644 clones/llthw.common-lisp.dev/1-05-0-lookups-trees.html
 create mode 100644 clones/llthw.common-lisp.dev/1-06-0-math.html
 create mode 100644 clones/llthw.common-lisp.dev/1-06-01-integers.html
 create mode 100644 clones/llthw.common-lisp.dev/1-06-02-more-integers.html
 create mode 100644 clones/llthw.common-lisp.dev/1-06-03-hexadecimal-notation.html
 create mode 100644 clones/llthw.common-lisp.dev/1-06-04-octal-notation.html
 create mode 100644 clones/llthw.common-lisp.dev/1-06-05-binary-notation.html
 create mode 100644 clones/llthw.common-lisp.dev/1-06-06-ratios.html
 create mode 100644 clones/llthw.common-lisp.dev/1-06-07-floating-point.html
 create mode 100644 clones/llthw.common-lisp.dev/1-06-08-constants.html
 create mode 100644 clones/llthw.common-lisp.dev/1-06-09-complex-numbers.html
 create mode 100644 clones/llthw.common-lisp.dev/1-06-10-arithmetic.html
 create mode 100644 clones/llthw.common-lisp.dev/1-06-11-more-arithmetic.html
 create mode 100644 clones/llthw.common-lisp.dev/1-06-12-even-more-arithmetic.html
 create mode 100644 clones/llthw.common-lisp.dev/1-06-13-exponents.html
 create mode 100644 clones/llthw.common-lisp.dev/1-06-14-logarithms.html
 create mode 100644 clones/llthw.common-lisp.dev/1-06-15-trigonometry.html
 create mode 100644 clones/llthw.common-lisp.dev/1-06-16-psuedorandom-numbers.html
 create mode 100644 clones/llthw.common-lisp.dev/1-07-0-arrays.html
 create mode 100644 clones/llthw.common-lisp.dev/1-08-0-variables.html
 create mode 100644 clones/llthw.common-lisp.dev/1-09-0-closures.html
 create mode 100644 clones/llthw.common-lisp.dev/1-10-0-functions.html
 create mode 100644 clones/llthw.common-lisp.dev/1-11-0-text-adventure.html
 create mode 100644 clones/llthw.common-lisp.dev/1-12-0-namespaces.html
 create mode 100644 clones/llthw.common-lisp.dev/1-13-0-simple-web-app.html
 create mode 100644 clones/llthw.common-lisp.dev/1-14-0-conditionals.html
 create mode 100644 clones/llthw.common-lisp.dev/1-15-0-command-line-utility.html
 create mode 100644 clones/llthw.common-lisp.dev/1-16-0-map-loop.html
 create mode 100644 clones/llthw.common-lisp.dev/1-17-0-iterate.html
 create mode 100644 clones/llthw.common-lisp.dev/1-18-0-format.html
 create mode 100644 clones/llthw.common-lisp.dev/1-19-0-dsl.html
 create mode 100644 clones/llthw.common-lisp.dev/1-20-0-review.html
 create mode 100644 clones/llthw.common-lisp.dev/2-0-0-overview.html
 create mode 100644 clones/llthw.common-lisp.dev/2-01-0-programming-paradigms.html
 create mode 100644 clones/llthw.common-lisp.dev/2-02-0-regex.html
 create mode 100644 clones/llthw.common-lisp.dev/2-03-0-objects-control.html
 create mode 100644 clones/llthw.common-lisp.dev/2-04-0-data-persistence.html
 create mode 100644 clones/llthw.common-lisp.dev/2-05-0-extended-types.html
 create mode 100644 clones/llthw.common-lisp.dev/2-06-0-threads-memos-parallel.html
 create mode 100644 clones/llthw.common-lisp.dev/2-07-0-logic-and-more-math.html
 create mode 100644 clones/llthw.common-lisp.dev/2-08-0-number-theory.html
 create mode 100644 clones/llthw.common-lisp.dev/2-09-0-binary-octets-bits.html
 create mode 100644 clones/llthw.common-lisp.dev/2-10-0-improved-text-adventure-engine.html
 create mode 100644 clones/llthw.common-lisp.dev/2-11-0-conditions.html
 create mode 100644 clones/llthw.common-lisp.dev/2-12-0-2d-game.html
 create mode 100644 clones/llthw.common-lisp.dev/2-13-0-compiler.html
 create mode 100644 clones/llthw.common-lisp.dev/2-14-0-tree-shaker.html
 create mode 100644 clones/llthw.common-lisp.dev/2-15-0-docs-and-inspection.html
 create mode 100644 clones/llthw.common-lisp.dev/2-16-0-foreign-libs.html
 create mode 100644 clones/llthw.common-lisp.dev/2-17-0-debugging-testing.html
 create mode 100644 clones/llthw.common-lisp.dev/2-18-0-ffi.html
 create mode 100644 clones/llthw.common-lisp.dev/2-19-0-essential-libs.html
 create mode 100644 clones/llthw.common-lisp.dev/2-20-0-packaging-libs.html
 create mode 100644 clones/llthw.common-lisp.dev/2-21-0-review.html
 create mode 100644 clones/llthw.common-lisp.dev/3-00-00-overview.html
 create mode 100644 clones/llthw.common-lisp.dev/3-01-00-web-apps.html
 create mode 100644 clones/llthw.common-lisp.dev/3-02-00-typesetting.html
 create mode 100644 clones/llthw.common-lisp.dev/3-03-00-mobile.html
 create mode 100644 clones/llthw.common-lisp.dev/3-04-00-gui.html
 create mode 100644 clones/llthw.common-lisp.dev/3-05-00-system-utils.html
 create mode 100644 clones/llthw.common-lisp.dev/3-06-00-reverse-engineering.html
 create mode 100644 clones/llthw.common-lisp.dev/3-07-00-graphics.html
 create mode 100644 clones/llthw.common-lisp.dev/3-08-00-gaming.html
 create mode 100644 clones/llthw.common-lisp.dev/3-09-00-audio.html
 create mode 100644 clones/llthw.common-lisp.dev/3-10-00-data.html
 create mode 100644 clones/llthw.common-lisp.dev/3-11-00-cryptosec.html
 create mode 100644 clones/llthw.common-lisp.dev/3-12-00-fintech.html
 create mode 100644 clones/llthw.common-lisp.dev/3-13-00-scientific-computing.html
 create mode 100644 clones/llthw.common-lisp.dev/3-14-00-computational-physics.html
 create mode 100644 clones/llthw.common-lisp.dev/3-15-00-quantum-computing.html
 create mode 100644 clones/llthw.common-lisp.dev/3-16-00-nlp.html
 create mode 100644 clones/llthw.common-lisp.dev/3-17-00-ai.html
 create mode 100644 clones/llthw.common-lisp.dev/3-18-00-robotics.html
 create mode 100644 clones/llthw.common-lisp.dev/3-19-00-space-tech.html
 create mode 100644 clones/llthw.common-lisp.dev/3-20-00-neurotech.html
 create mode 100644 clones/llthw.common-lisp.dev/3-21-00-lispos.html
 create mode 100644 clones/llthw.common-lisp.dev/3-22-00-lisp-machine.html
 create mode 100644 clones/llthw.common-lisp.dev/3-23-00-gov-mil.html
 create mode 100644 clones/llthw.common-lisp.dev/CHANGELOG.html
 create mode 100644 clones/llthw.common-lisp.dev/TODO.html
 create mode 100644 clones/llthw.common-lisp.dev/acknowledgements.html
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/fonts/fontawesome/fontawesome-webfont.eot?
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/fonts/fontawesome/fontawesome-webfont.eot?v=4.6.3
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/fonts/fontawesome/fontawesome-webfont.svg?v=4.6.3
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/fonts/fontawesome/fontawesome-webfont.ttf?v=4.6.3
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/fonts/fontawesome/fontawesome-webfont.woff2?v=4.6.3
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/fonts/fontawesome/fontawesome-webfont.woff?v=4.6.3
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-folding-chapters/folding-chapters.css
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-folding-chapters/folding-chapters.js
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-fontsettings/fontsettings.js
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-fontsettings/website.css
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-highlight/website.css
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-hints/plugin-hints.css
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-lunr/lunr.min.js
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-lunr/search-lunr.js
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-search/search-engine.js
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-search/search.css
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-search/search.js
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-sharing/buttons.js
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/gitbook.js
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/images/apple-touch-icon-precomposed-152.png
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/images/favicon.ico
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/style.css
 create mode 100644 clones/llthw.common-lisp.dev/gitbook/theme.js
 create mode 100644 clones/llthw.common-lisp.dev/index.html
 create mode 100644 clones/llthw.common-lisp.dev/introduction.html
 create mode 100644 clones/llthw.common-lisp.dev/preface-part-three.html
 create mode 100644 clones/llthw.common-lisp.dev/preface-part-two.html
 create mode 100644 clones/llthw.common-lisp.dev/preface.html

diff --git a/clones/clojure-doc.org/articles/about/index.html b/clones/clojure-doc.org/articles/about/index.html
new file mode 100644
index 00000000..5b0b2c28
--- /dev/null
+++ b/clones/clojure-doc.org/articles/about/index.html
@@ -0,0 +1,216 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: About</title>
+    
+
+<meta name="description" content="CDS (Clojure Documentation Site) is a community documentation project for the Clojure programming language. It is not affiliated with
+Clojure/core, does not require going through the Clojure Contributor Agreement, and is developed on GitHub.Rationale">
+
+<meta property="og:description" content="CDS (Clojure Documentation Site) is a community documentation project for the Clojure programming language. It is not affiliated with
+Clojure/core, does not require going through the Clojure Contributor Agreement, and is developed on GitHub.Rationale">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/about/" />
+<meta property="og:title" content="About" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/about/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>About</h2>
+    </div>
+    
+    <p>CDS (Clojure Documentation Site) is a community documentation project for the Clojure programming language. It is not affiliated with
+<code>Clojure/core</code>, does not require going through the Clojure Contributor Agreement, and is developed <a href="https://github.com/clojure-doc/clojure-doc.github.io">on GitHub</a>.</p><h2 id="rationale">Rationale</h2><p>The rationale is explained in more detail in the <a href="http://blog.clojurewerkz.org/blog/2012/10/10/announcing-a-new-clojure-documentation-project/">announcement blog post</a>.</p><h2 id="history">History</h2><p>CDS was started in early October, 2012, by several active members of the Clojure community due to their dissatisfaction
+with the state of documentation and documentation contribution process (that involved mailing Clojure Contributor Agreement in paper).</p><h2 id="goals">Goals</h2><p>The goal is to produce quality technical documentation for Clojure users and potential adopters with various expertise levels.</p><p>CDS strives to cover all aspects of Clojure: from tutorials and language guides to overview of the ecosystem, how
+libraries are developed and published, topics operations engineers will be interested in, JVM ecosystem tools
+and so on.</p><p>Adopting a language always takes more than just reading a book or a few tutorials about language features. Understanding
+design goals, the ecosystem and operations is just as important. CDS will try to address this.</p><h3 id="what-cds-is-not">What CDS is Not</h3><p>What's <em>not</em> here:</p><ul><li>Cheatsheets. The official <a href="http://clojure.org/cheatsheet">Clojure cheatsheet</a> is very good.  There is also an unofficial <a href="https://github.com/fogus/clojurescript-cheatsheet">ClojureScript cheatsheet</a> available for download and contribution.</li><li>API reference docs. Those can currently be found (with examples) at <a href="http://clojuredocs.org/">Clojuredocs</a>.</li></ul><p>Clojuredocs needs a lot of work and redesign (as in, the way it works) which will take a while. CDS is not concerned with providing the API reference;
+only tutorials, guides, and linking to other relevant resources.</p><h2 id="structure">Structure</h2><p>CDS is structured as a number of guides. They broadly fall into 4 categories:</p><ul><li><a href="https://clojure-doc.org/articles/about/content/#clojure_tutorials">Tutorials</a></li><li><a href="https://clojure-doc.org/articles/about/content/#clojure_language_guides">Language Guides</a></li><li><a href="https://clojure-doc.org/articles/about/content/#the_clojure_ecosystem">Ecosystem &amp; Tools</a></li><li><a href="https://clojure-doc.org/articles/about/content/#cookbooks">Cookbooks</a></li></ul><h3 id="tutorials">Tutorials</h3><p>These guides are for complete newcomers and should include a lot of hand holding. They don't assume any
+previous familiarity with Clojure, the JVM, the JVM tool ecosystem, functional programming, immutability, and so on.</p><p>Target audience: newcomers to the language.</p><h3 id="language-guides">Language guides</h3><p>These guides are more in-depth, focused on various aspects of the language and interoperability.
+Examples of such guides include:</p><ul><li>Sequences</li><li>Interoperability</li><li>Reference types</li><li>Laziness</li><li>Macros and compilation</li></ul><p>Target audience: from developers who already have some familiarity with the language to those who have been using it for
+a while.</p><h3 id="tools--ecosystem-guides">Tools &amp; Ecosystem guides</h3><p>These guides cover key Clojure ecosystem tools such as <a href="http://leiningen.org">Leiningen</a>, <a href="http://clojars.org">Clojars</a>, <a href="https://github.com/trptcolin/reply">REPLy</a>,
+<a href="https://github.com/clojure/tools.nrepl">nREPL</a>, <a href="https://github.com/technomancy/clojure-mode">Emacs clojure-mode</a>, VimClojure, <a href="https://code.google.com/p/counterclockwise/">Counterclockwise</a>, <a href="http://plugins.jetbrains.com/plugin?pluginId=4050">La Clojure</a>, etc. It also covers important ecosystem projects that are not tools: books,
+<a href="http://www.clojuresphere.com/">ClojureSphere</a>, <a href="http://clojurewerkz.org/">ClojureWerkz</a>, <a href="https://github.com/flatland">Flatland</a> and so on.</p><p>Target audience: all developers using or interested in the Clojure programming language.</p><h3 id="cookbooks">Cookbooks</h3><p>Concise <a href="https://clojure-doc.org/articles/about/content/#cookbooks">Clojure example code</a>, categorized by subject.</p><h2 id="mailing-list">Mailing List</h2><p>CDS <a href="https://groups.google.com/group/clojure">currently uses Clojure mailing list</a> for discussions. Feel free to join it and ask any questions you may have.</p><h2 id="news--announcements">News &amp; Announcements</h2><p>News and announcements are posted primarily on the <a href="https://clojurians.slack.com/archives/C8NUSGWG6">Clojurians Slack <code>#news-and-articles</code> channel</a>.</p><h2 id="reporting-issues">Reporting Issues</h2><p>If you find a mistake, poor grammar, an important topic not covered, or an outdated example, please <a href="https://github.com/clojure-doc/clojure-doc.github.io/issues">file an issue</a> on Github.</p><h2 id="contributing">Contributing</h2><p>CDS uses <a href="http://cryogenweb.org/">Cryogen</a>. All tutorials and guides are written in Markdown.</p><p>The toolchain and setup process are described <a href="https://github.com/clojure-doc/clojure-doc.github.io/blob/main/README.md#toolchain">in the README</a>.</p><p>To submit changes, create a branch and make your changes on it. Once you are done with your changes and all tests pass, submit a pull request
+on GitHub.</p>
+
+    <div id="prev-next">
+        
+        
+        
+        <a href="../content/index.html">Table of Contents &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="index.html">About</a></li>
+                    
+                    <li><a href="../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/content/index.html b/clones/clojure-doc.org/articles/content/index.html
new file mode 100644
index 00000000..a4a0ba92
--- /dev/null
+++ b/clones/clojure-doc.org/articles/content/index.html
@@ -0,0 +1,225 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Table of Contents</title>
+    
+
+<meta name="description" content="The content is a categorized and
+manifold collection of documentation guides for the Clojure programming language and
+its ecosystem.We recognize that different Clojure users have different level of expertise
+and separates content into several groups:">
+
+<meta property="og:description" content="The content is a categorized and
+manifold collection of documentation guides for the Clojure programming language and
+its ecosystem.We recognize that different Clojure users have different level of expertise
+and separates content into several groups:">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/content/" />
+<meta property="og:title" content="Table of Contents" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/content/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Table of Contents</h2>
+    </div>
+    
+    <p><a href="https://github.com/clojure-doc/clojure-doc.github.io">The content</a> is a categorized and
+manifold collection of documentation guides for the Clojure programming language and
+its ecosystem.</p><p>We recognize that different Clojure users have different level of expertise
+and separates content into several groups:</p><ul><li><a href="index.html#essentials">Essentials</a></li><li><a href="index.html#language-guides">Language Guides</a></li><li><a href="index.html#the-clojure-ecosystem">Ecosystem &amp; Tools</a> (tools, libraries, community, books) guides</li><li><a href="index.html#tutorials-and-cookbooks">Tutorials &amp; Cookbooks</a></li></ul><h2 id="essentials">Essentials</h2><p>Note that the editing environments are listed in alphabetical order and indicate no preference or endorsement. The last
+<a href="https://clojure.org/news/2021/04/06/state-of-clojure-2021">"State of the Union" Clojure survey</a> indicated
+that Emacs is still the most popular editing environment, followed by IntelliJ/Cursive, VS Code, Vim, and Atom.</p><h3 id="getting-started"><a href="../tutorials/getting_started/index.html">Getting Started</a></h3><p>If you're new to Clojure, this is a good place to start.</p><h3 id="introduction"><a href="../tutorials/introduction/index.html">Introduction</a></h3><p>A swift introduction to the Clojure language, covering most of the
+basics.</p><h3 id="atom-for-clojure-development"><a href="https://atom.io/packages/chlorine">Atom for Clojure Development</a></h3><p>The Chlorine package for Clojure development in Atom (via a Socket REPL).</p><h3 id="intellij--cursive-for-clojure-development"><a href="https://cursive-ide.com/userguide/">IntelliJ / Cursive for Clojure Development</a></h3><p>The user guide for Cursive, the Clojure plugin for IntelliJ.</p><h3 id="eclipse-for-clojure-development"><a href="../tutorials/eclipse/index.html">Eclipse for Clojure Development</a></h3><p>A brief introduction to Counterclockwise, a Clojure plugin for Eclipse.</p><h3 id="emacs-for-clojure-development"><a href="../tutorials/emacs/index.html">Emacs for Clojure Development</a></h3><p>A brief introduction to Emacs, Clojure mode, CIDER and Clojure development workflow with Emacs.</p><h3 id="vim-for-clojure-development"><a href="../tutorials/vim_fireplace/index.html">Vim for Clojure Development</a></h3><p>A brief introduction to Clojure development in Vim with fireplace.vim.</p><h3 id="vs-code-for-clojure-development"><a href="https://calva.io/">VS Code for Clojure Development</a></h3><p>The Calva extension for Clojure development in VS Code (via nREPL).</p><p>See also <a href="https://marketplace.visualstudio.com/items?itemName=mauricioszabo.clover">Clover for VS Code</a>
+for Clojure development in VS Code (via a Socket REPL).</p><h2 id="language-guides">Language Guides</h2><h3 id="functions"><a href="../language/functions/index.html">Functions</a></h3><p>Functions are at the heart of Clojure.</p><p>This guide covers:</p><ul><li>How to define functions</li><li>How to invoke functions</li><li>Multi-arity functions</li><li>Variadic functions</li><li>Higher order functions</li><li>Other topics related to functions</li></ul><h3 id="clojurecore-overview-incomplete"><a href="../language/core_overview/index.html">clojure.core Overview</a> (incomplete)</h3><p><code>clojure.core</code> is the core Clojure library.</p><p>This guide covers:</p><ul><li>Key functions of <code>clojure.core</code></li><li>Key macros of <code>clojure.core</code></li><li>Key vars of <code>clojure.core</code></li></ul><h3 id="interoperability-with-java"><a href="../language/interop/index.html">Interoperability with Java</a></h3><p>The Clojure language implementation is symbiotic with its host
+platform (the JVM), providing direct interoperability.</p><p>This guide covers:</p><ul><li>How to instantiate Java classes</li><li>How to invoke Java methods</li><li>How to extend Java classes with proxy</li><li>How to implement Java interfaces with reify</li><li>How to generate Java classes with gen-class</li><li>Other topics related to interop</li></ul><h3 id="namespaces"><a href="../language/namespaces/index.html">Namespaces</a></h3><p>Namespaces organize Clojure functions.</p><p>This guide covers:</p><ul><li>An overview of Clojure namespaces</li><li>How to define a namespace</li><li>How to use functions in other namespaces</li><li><code>require</code>, <code>refer</code> and <code>use</code></li><li>How to Look up and invoke a function by name</li><li>Common compilation exceptions and their causes</li><li>How code compilation works in Clojure</li></ul><h3 id="polymorphism-protocols-and-multimethods"><a href="../language/polymorphism/index.html">Polymorphism: Protocols and Multimethods</a></h3><p>This guide covers:</p><ul><li>What are polymorphic functions</li><li>Type-based polymorphism with protocols</li><li>Ad-hoc polymorphism with multimethods</li><li>How to create your own data types that behave like core Clojure data types</li></ul><h3 id="collections-and-sequences"><a href="../language/collections_and_sequences/index.html">Collections and Sequences</a></h3><p>This guide covers:</p><ul><li>Collections in Clojure</li><li>Sequences in Clojure</li><li>Core collection types</li><li>Key operations on collections and sequences</li><li>Other topics related to collections and sequences</li></ul><h3 id="concurrency--parallelism"><a href="../language/concurrency_and_parallelism/index.html">Concurrency &amp; Parallelism</a></h3><p>This guide covers:</p><ul><li>An overview of concurrency hazards</li><li>Clojure's approach to state and identity</li><li>Immutable data structures</li><li>Reference types (atoms, vars, agents, refs)</li><li>Using Clojure functions with <code>java.util.concurrent</code> abstractions</li><li>The Reducers framework (Clojure 1.5+)</li><li>Other topics related to concurrency and runtime parallelism</li></ul><h3 id="macros-and-metaprogramming"><a href="../language/macros/index.html">Macros and Metaprogramming</a></h3><p>This guide covers:</p><ul><li>Clojure macros</li><li>Clojure compilation process</li><li>Other topics related to metaprogramming</li></ul><h3 id="laziness-and-lazy-sequences-incomplete"><a href="../language/laziness/index.html">Laziness and Lazy Sequences</a> (incomplete)</h3><p>This guide covers:</p><ul><li>What are lazy sequences</li><li>How to create functions that produce lazy sequences</li><li>How to force evaluation</li><li>Pitfalls with lazy sequences</li></ul><h3 id="glossary"><a href="../language/glossary/index.html">Glossary</a></h3><p>This guide includes definitons of various Clojure-related terminology.</p><h2 id="the-clojure-ecosystem">The Clojure Ecosystem</h2><h3 id="books"><a href="../ecosystem/books/index.html">Books</a></h3><p>This guide covers:</p><ul><li>Books on Clojure</li><li>Books on ClojureScript</li></ul><h3 id="getting-started-with-leiningen"><a href="https://github.com/technomancy/leiningen/blob/master/doc/TUTORIAL.md">Getting Started with Leiningen</a></h3><p>This guide covers:</p><ul><li>What is Leiningen and what it can do for you</li><li>How to create a project with Leiningen</li><li>How to manage project dependencies</li><li>Accessing the REPL</li><li>How to run tests for your project</li><li>How to run the app</li><li>How to compile your code and dependencies into a single JAR for deployment ("überjar")</li><li>How to share (publish) a library</li></ul><h3 id="maven-for-clojure-development"><a href="../ecosystem/maven/index.html">Maven for Clojure Development</a></h3><p>This guide covers:</p><ul><li>An overview of Apache Maven</li><li>Maven Clojure plugin</li></ul><h3 id="clojure-library-directory"><a href="../ecosystem/libraries_directory/index.html">Clojure Library Directory</a></h3><p>A curated and highly opinionated categorized directory of available Clojure libraries and tools.</p><h3 id="clojure-community"><a href="../ecosystem/community/index.html">Clojure Community</a></h3><p>This guide covers:</p><ul><li>Planet Clojure, mailing lists, IRC channel</li><li>Clojure conferences</li><li>Local Clojure user groups</li><li>Other Clojure community resources</li></ul><h3 id="coretyped"><a href="../ecosystem/core_typed/home/index.html">core.typed</a></h3><ul><li>What is Clojure core.typed</li><li>core.typed documentation, tutorials, and guides.</li></ul><h3 id="javajdbc"><a href="../ecosystem/java_jdbc/home.html">java.jdbc</a></h3><p>This guide covers:</p><ul><li>An overview of Clojure's JDBC wrapper</li><li>Setting up a data source</li><li>Manipulating data with SQL</li><li>Manipulating tables with DDL</li><li>How to use connection pooling</li><li>How to use some common DSLs with java.jdbc</li><li>Where to go beyond java.jdbc</li></ul><h3 id="library-development-and-distribution"><a href="../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></h3><p>This guide covers:</p><ul><li>Basic setup for library development</li><li>How to publish a library to Clojars</li></ul><h3 id="leiningen-profiles"><a href="https://github.com/technomancy/leiningen/blob/master/doc/PROFILES.md">Leiningen Profiles</a></h3><p>This guide covers:</p><ul><li>What are Leiningen profiles</li><li>How to use them</li></ul><h3 id="distributing-libraries-with-leiningen"><a href="https://github.com/technomancy/leiningen/blob/master/doc/DEPLOY.md">Distributing Libraries with Leiningen</a></h3><p>This guide covers:</p><ul><li>How Clojure libraries are distributed</li><li>How to publish Clojure libraries to clojars.org</li><li>How to publish Clojure libraries to Maven Central</li><li>How to publish Clojure libraries to your own Maven repository</li></ul><h3 id="writing-leiningen-plugins"><a href="https://github.com/technomancy/leiningen/blob/master/doc/PLUGINS.md">Writing Leiningen Plugins</a></h3><p>This guide covers:</p><ul><li>What Leiningen plugins can do</li><li>How to install Leiningen plugins</li><li>How to develop plugins</li><li>How to distribute plugins</li></ul><h3 id="documentation-tools"><a href="../ecosystem/generating_documentation/index.html">Documentation Tools</a></h3><ul><li>Tools for generating documentation from docstrings and other project
+metadata.</li></ul><h3 id="data-processing-overview-tbd"><a href="../ecosystem/data_processing/index.html">Data Processing (Overview)</a> (TBD)</h3><p>This guide covers:</p><ul><li>An overview of why Clojure is an excellent choice for data processing</li><li>Popular tools and libraries in the area</li></ul><h3 id="clojure-user-groups"><a href="../ecosystem/user_groups/index.html">Clojure User Groups</a></h3><p>This guide covers:</p><ul><li>Clojure User Groups (CLJUGs) around the world</li></ul><h2 id="tutorials-and-cookbooks">Tutorials and Cookbooks</h2><h3 id="basic-web-development"><a href="../tutorials/basic_web_development/index.html">Basic Web Development</a></h3><p>A brief tutorial/walkthrough of building a small web app using Ring,
+Compojure, Hiccup, and H2.</p><h3 id="parsing-xml-in-clojure"><a href="../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></h3><p>This guide covers:</p><ul><li>How to parse XML in Clojure with zippers (<code>clojure.data.zip</code>)</li></ul><h3 id="growing-a-dsl-with-clojure"><a href="../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></h3><p>How to create a simple DSL with Clojure.</p><p>Includes introductions to:</p><ul><li>Multimethods</li><li>Hierarchies</li><li>Metaprogramming and the "Code as data" philosophy</li></ul><h3 id="strings"><a href="../cookbooks/strings/index.html">Strings</a></h3><p>This cookbook covers:</p><ul><li>How to work with strings</li><li>How to work with characters</li><li>How to work with regular expressions</li><li>How to work with context-free grammars</li><li>How to format text</li></ul><h3 id="mathematics"><a href="../cookbooks/math/index.html">Mathematics</a></h3><p>Includes coverage of facilities for doing math with Clojure.</p><h3 id="data-structures-tbd"><a href="../cookbooks/data_structures/index.html">Data Structures</a> (TBD)</h3><p>This cookbook covers:</p><ul><li>Vectors</li><li>Maps</li><li>Lists</li><li>Sets</li><li>Generic operations on sequences</li></ul><h3 id="files-and-directories"><a href="../cookbooks/files_and_directories/index.html">Files and Directories</a></h3><p>This cookbook covers:</p><ul><li>Reading and writing text and binary files</li><li>Listing directory contents</li><li>Creating files and directories</li><li>Moving files and directories</li><li>Removing files and directories</li><li>Accessing file metadata</li><li>Other operations on files and directories</li></ul><h3 id="date-and-time-tbd"><a href="../cookbooks/date_and_time/index.html">Date and Time</a> (TBD)</h3><p>This guide covers:</p><ul><li>Working with JDK dates</li><li>Working with Joda Time and <code>clj-time</code></li><li>Instant literals (Clojure 1.4+)</li></ul><h3 id="middleware-incomplete"><a href="../cookbooks/middleware/index.html">Middleware</a> (incomplete)</h3><p>This guide covers:</p><ul><li>What middleware is and how it works</li><li>Creating middleware for a client function</li><li>Combining middleware to create a new client</li></ul><h2 id="license">License</h2><p>All the content is distributed under the
+<a href="http://creativecommons.org/licenses/by/3.0/">CC BY 3.0</a> license
+and are copyright their respective primary author(s).</p><h2 id="tell-us-what-you-think">Tell Us What You Think!</h2><p>Please take a moment to tell us what you think about this guide on the <a href="https://clojurians.slack.com/archives/C02M6N5C137">Clojurians Slack <code>#clojure-doc</code> channel</a> or the <a href="https://groups.google.com/group/clojure">Clojure mailing list</a>.</p><p>Let us know what was unclear or what has not been covered. Maybe you do not like the guide style or grammar or discover spelling mistakes.
+Reader feedback is key to making the documentation better.</p>
+
+    <div id="prev-next">
+        
+        <a href="../about/index.html">&laquo; About</a>
+        
+        
+        ||
+        
+        
+        <a href="../tutorials/getting_started/index.html">Getting Started with Clojure &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../about/index.html">About</a></li>
+                    
+                    <li><a href="index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/cookbooks/data_structures/index.html b/clones/clojure-doc.org/articles/cookbooks/data_structures/index.html
new file mode 100644
index 00000000..5cffc1cf
--- /dev/null
+++ b/clones/clojure-doc.org/articles/cookbooks/data_structures/index.html
@@ -0,0 +1,208 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Data Structures (Help wanted)</title>
+    
+
+<meta name="description" content="Help wantedPlease follow the instructions on how to contribute and start writing over here">
+
+<meta property="og:description" content="Help wantedPlease follow the instructions on how to contribute and start writing over here">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/cookbooks/data_structures/" />
+<meta property="og:title" content="Data Structures (Help wanted)" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/cookbooks/data_structures/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Data Structures (Help wanted)</h2>
+    </div>
+    
+    <h2 id="help-wanted">Help wanted</h2><p>Please follow the <a href="https://github.com/clojure-doc/clojure-doc.github.io/tree/source#how-to-contribute">instructions</a> on how to contribute and start writing over <a href="https://github.com/clojure-doc/clojure-doc.github.io/blob/source/content/md/articles/cookbooks/data_structures.md">here</a></p><p>This cookbook covers working with core Clojure data structures.</p><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons
+Attribution 3.0 Unported License</a> (including images &amp;
+stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on Github</a>.</p>
+
+    <div id="prev-next">
+        
+        <a href="../../ecosystem/books/index.html">&laquo; Books about Clojure and ClojureScript</a>
+        
+        
+        ||
+        
+        
+        <a href="../strings/index.html">Strings &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/cookbooks/date_and_time/index.html b/clones/clojure-doc.org/articles/cookbooks/date_and_time/index.html
new file mode 100644
index 00000000..fee2067e
--- /dev/null
+++ b/clones/clojure-doc.org/articles/cookbooks/date_and_time/index.html
@@ -0,0 +1,208 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Date and Time (Help wanted)</title>
+    
+
+<meta name="description" content="Help wantedPlease follow the instructions on how to contribute and start writing over here">
+
+<meta property="og:description" content="Help wantedPlease follow the instructions on how to contribute and start writing over here">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/cookbooks/date_and_time/" />
+<meta property="og:title" content="Date and Time (Help wanted)" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/cookbooks/date_and_time/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Date and Time (Help wanted)</h2>
+    </div>
+    
+    <h2 id="help-wanted">Help wanted</h2><p>Please follow the <a href="https://github.com/clojure-doc/clojure-doc.github.io/tree/source#how-to-contribute">instructions</a> on how to contribute and start writing over <a href="https://github.com/clojure-doc/clojure-doc.github.io/blob/source/content/md/articles/cookbooks/date_and_time.md">here</a></p><p>This cookbook covers working with date and time values in Clojure.</p><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons
+Attribution 3.0 Unported License</a> (including images &amp;
+stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on Github</a>.</p>
+
+    <div id="prev-next">
+        
+        <a href="../math/index.html">&laquo; Mathematics with Clojure</a>
+        
+        
+        ||
+        
+        
+        <a href="../files_and_directories/index.html">Working with Files and Directories in Clojure &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/cookbooks/files_and_directories/index.html b/clones/clojure-doc.org/articles/cookbooks/files_and_directories/index.html
new file mode 100644
index 00000000..c9dd6589
--- /dev/null
+++ b/clones/clojure-doc.org/articles/cookbooks/files_and_directories/index.html
@@ -0,0 +1,252 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Working with Files and Directories in Clojure</title>
+    
+
+<meta name="description" content="This cookbook covers working with files and directories from Clojure,
+using functions in the clojure.java.io namespace as well as parts of
+the JDK via interoperability.This work is licensed under a Creative Commons
+Attribution 3.0 Unported License (including images &amp;
+stylesheets). The source is available on
+Github.">
+
+<meta property="og:description" content="This cookbook covers working with files and directories from Clojure,
+using functions in the clojure.java.io namespace as well as parts of
+the JDK via interoperability.This work is licensed under a Creative Commons
+Attribution 3.0 Unported License (including images &amp;
+stylesheets). The source is available on
+Github.">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/cookbooks/files_and_directories/" />
+<meta property="og:title" content="Working with Files and Directories in Clojure" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/cookbooks/files_and_directories/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Working with Files and Directories in Clojure</h2>
+    </div>
+    
+    <p>This cookbook covers working with files and directories from Clojure,
+using functions in the <code>clojure.java.io</code> namespace as well as parts of
+the JDK via interoperability.</p><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons
+Attribution 3.0 Unported License</a> (including images &amp;
+stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on
+Github</a>.</p><h2 id="preliminaries">Preliminaries</h2><p>Note that for the examples below, "io" is an alias for
+<code>clojure.java.io</code>. That is, it's assumed your <code>ns</code> macro contains:</p><pre><code class="clojure">(:require [clojure.java.io :as io])
+</code></pre><p>or else in the repl you've loaded it:</p><pre><code class="clojure">(require '[clojure.java.io :as io])
+</code></pre><h2 id="recipes">Recipes</h2><h3 id="read-a-file-into-one-long-string">Read a file into one long string</h3><pre><code class="clojure">(def a-long-string (slurp "foo.txt"))
+</code></pre><p>Note, you can pass urls to <code>slurp</code> as well. See also <a href="http://clojuredocs.org/clojure_core/clojure.core/slurp">slurp at
+Clojuredocs</a>.</p><h3 id="read-a-file-one-line-at-a-time">Read a file one line at a time</h3><p>Suppose you'd like to call <code>my-func</code> on every line in a file,
+and return the resulting sequence:</p><pre><code class="clojure">(with-open [rdr (io/reader "foo.txt")]
+  (doall (map my-func (line-seq rdr))))
+</code></pre><p>The <code>doall</code> is needed because the <code>map</code> call is lazy. The lines that
+<code>line-seq</code> gives you have no trailing newlines (and empty lines in the
+file will yield empty strings ("")).</p><h3 id="write-a-long-string-out-to-a-new-file">Write a long string out to a new file</h3><pre><code class="clojure">(spit "foo.txt"
+      "A long
+multi-line string.
+Bye.")
+</code></pre><p>Overwrites the file if it already exists. To append, use</p><pre><code class="clojure">(spit "foo.txt" "file content" :append true)
+</code></pre><h3 id="write-a-file-one-line-at-a-time">Write a file one line at a time</h3><p>Suppose you'd like to write out every item in a vector, one item per
+line:</p><pre><code class="clojure">(with-open [wrtr (io/writer "foo.txt")]
+  (doseq [i my-vec]
+    (.write wrtr (str i "\n"))))
+</code></pre><h3 id="check-if-a-file-exists">Check if a file exists</h3><pre><code class="clojure">(.exists (io/file "filename.txt"))
+</code></pre><p>Is it a directory? :</p><pre><code class="clojure">(.isDirectory (io/file "path/to/something"))
+</code></pre><p>An io/file is a java.io.File object (a file or a directory). You can
+call a number of functions on it, including:</p><pre><code>exists        Does the file exist?
+isDirectory   Is the File object a directory?
+getName       The basename of the file.
+getParent     The dirname of the file.
+getPath       Filename with directory.
+mkdir         Create this directory on disk.
+</code></pre><p>To read about more available methods, see <a href="http://docs.oracle.com/javase/7/docs/api/java/io/File.html">the java.io.File
+docs</a>.</p><h3 id="get-a-list-of-the-files-and-dirs-in-a-given-directory">Get a list of the files and dirs in a given directory</h3><p>As <code>File</code> objects:</p><pre><code class="clojure">(.listFiles (io/file "path/to/some-dir"))
+</code></pre><p>Same, but just the <em>names</em> (strings), not File objects:</p><pre><code class="clojure">(.list (io/file "path/to/some-dir"))
+</code></pre><p>The results of those calls are seqable.</p><h2 id="see-also">See also</h2><ul><li><a href="https://github.com/Raynes/fs">https://github.com/Raynes/fs</a></li><li>the I/O section of the <a href="http://clojure.org/cheatsheet">cheatsheet</a></li></ul>
+
+    <div id="prev-next">
+        
+        <a href="../date_and_time/index.html">&laquo; Date and Time (Help wanted)</a>
+        
+        
+        ||
+        
+        
+        <a href="../middleware/index.html">Middleware in Clojure &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/cookbooks/math/index.html b/clones/clojure-doc.org/articles/cookbooks/math/index.html
new file mode 100644
index 00000000..d0186d89
--- /dev/null
+++ b/clones/clojure-doc.org/articles/cookbooks/math/index.html
@@ -0,0 +1,252 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Mathematics with Clojure</title>
+    
+
+<meta name="description" content="This cookbook covers working with mathematics in Clojure, using
+built-in functions, contrib libraries, and parts of the JDK via
+interoperability.This work is licensed under a Creative Commons
+Attribution 3.0 Unported License (including images &amp;
+stylesheets). The source is available on
+Github.">
+
+<meta property="og:description" content="This cookbook covers working with mathematics in Clojure, using
+built-in functions, contrib libraries, and parts of the JDK via
+interoperability.This work is licensed under a Creative Commons
+Attribution 3.0 Unported License (including images &amp;
+stylesheets). The source is available on
+Github.">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/cookbooks/math/" />
+<meta property="og:title" content="Mathematics with Clojure" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/cookbooks/math/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Mathematics with Clojure</h2>
+    </div>
+    
+    <p>This cookbook covers working with mathematics in Clojure, using
+built-in functions, contrib libraries, and parts of the JDK via
+interoperability.</p><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons
+Attribution 3.0 Unported License</a> (including images &amp;
+stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on
+Github</a>.</p><h2 id="preliminaries">Preliminaries</h2><p>Some examples herein make use of the
+<a href="https://github.com/clojure/math.numeric-tower">math.numeric-tower</a>
+and
+<a href="https://github.com/clojure/math.combinatorics">math.combinatorics</a>
+contrib libraries. It's assumed that either you have the following in
+your source code's <code>ns</code> macro:</p><pre><code class="clojure">(:require [clojure.math.numeric-tower :as math]
+          [clojure.math.combinatorics :as combo])
+</code></pre><p>or else in the repl you've loaded them like so:</p><pre><code class="clojure">(require '[clojure.math.numeric-tower :as math])
+(require '[clojure.math.combinatorics :as combo])
+</code></pre><h2 id="recipes">Recipes</h2><h3 id="simple-math">Simple Math</h3><pre><code class="clojure">(+ 3 4)    ;=&gt; 7
+(- 3 4)    ;=&gt; -1
+(* 3 4)    ;=&gt; 12
+(/ 3 4)    ;=&gt; 3/4  (an exact ratio)
+(/ 3.0 4)  ;=&gt; 0.75
+
+(inc 5)    ;=&gt; 6
+(dec 5)    ;=&gt; 4
+</code></pre><p>For doing integer division and getting remainders (modulus), see the
+docs for
+<a href="http://clojuredocs.org/clojure_core/clojure.core/quot">quot</a>,
+<a href="http://clojuredocs.org/clojure_core/clojure.core/rem">rem</a>, and
+<a href="http://clojuredocs.org/clojure_core/clojure.core/mod">mod</a>.</p><p>For exponents, square roots, rounding, ceiling, floor, absolute value,
+and greatest/least common multiples, see the <a href="http://clojure.github.com/math.numeric-tower/">docs for
+math.numeric-tower</a>.</p><h3 id="trigonometry">Trigonometry</h3><p>Use what the Java platform provides, for example:</p><pre><code class="clojure">Math/PI       ;=&gt; 3.14159...
+(Math/sin x)
+(Math/cos x)
+(Math/tan x)
+</code></pre><p>There are many more functions available, which you can read about in
+the <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Math.html">docs for
+java.lang.Math</a>.</p><h3 id="combinatorics">Combinatorics</h3><p>For combinatoric functions (such as <code>combinations</code> and
+<code>permutations</code>), see the <a href="http://clojure.github.com/math.combinatorics/">docs for
+math.combinatorics</a>.</p>
+
+    <div id="prev-next">
+        
+        <a href="../strings/index.html">&laquo; Strings</a>
+        
+        
+        ||
+        
+        
+        <a href="../date_and_time/index.html">Date and Time (Help wanted) &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../strings/index.html">Strings</a></li>
+                    
+                    <li><a href="index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/cookbooks/middleware/index.html b/clones/clojure-doc.org/articles/cookbooks/middleware/index.html
new file mode 100644
index 00000000..2e2db724
--- /dev/null
+++ b/clones/clojure-doc.org/articles/cookbooks/middleware/index.html
@@ -0,0 +1,326 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Middleware in Clojure</title>
+    
+
+<meta name="description" content="This work is licensed under a Creative Commons
+Attribution 3.0 Unported License (including images &amp;
+stylesheets). The source is available on
+Github.What is Middleware?">
+
+<meta property="og:description" content="This work is licensed under a Creative Commons
+Attribution 3.0 Unported License (including images &amp;
+stylesheets). The source is available on
+Github.What is Middleware?">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/cookbooks/middleware/" />
+<meta property="og:title" content="Middleware in Clojure" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/cookbooks/middleware/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Middleware in Clojure</h2>
+    </div>
+    
+    <p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons
+Attribution 3.0 Unported License</a> (including images &amp;
+stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on
+Github</a>.</p><h2 id="what-is-middleware">What is Middleware?</h2><p>Middleware in Clojure is a common design pattern for threading a
+<em>request</em> through a series of functions designed to operate on it as
+well as threading the <em>response</em> through the same series of functions.</p><p>Middleware is used in many Clojure projects such as
+<a href="https://github.com/mmcgrana/ring">Ring</a>,
+<a href="https://github.com/dakrone/clj-http">clj-http</a> and
+<a href="https://clojure-doc.org/articles/cookbooks/middleware/TODO">something else here</a>.</p><h2 id="the-client-function">The <code>client</code> function</h2><p>The base of all middleware in Clojure is the <code>client</code> function, which
+takes a request object (usually a Clojure map) and returns a response
+object (also usually a Clojure map).</p><p>For example, let's use a <code>client</code> function that pulls some keys out of
+a map request and does an HTTP GET on a site:</p><pre><code class="clojure">(ns middleware.example
+  (:require [clj-http.client :as http]))
+
+(defn client [request]
+  (http/get (:site request) (:options request)))
+</code></pre><p>To use the client method, call it like so (response shortened to fit
+here):</p><pre><code class="clojure">(client {:site "http://www.aoeu.com" :options {}})
+;; ⇒ {:status 200, :headers {...}, :request-time 3057, :body "..."}
+</code></pre><p>Now that a client function exists, middleware can be wrapped around it
+to change the <em>request</em>, the <em>response</em>, or both.</p><p>Let's start with a middleware function that doesn't do anything. We'll
+call it the <code>no-op</code> middleware:</p><pre><code class="clojure">;; It is standard convention to name middleware wrap-&lt;something&gt;
+(defn wrap-no-op
+  ;; the wrapping function takes a client function to be used...
+  [client-fn]
+  ;; ...and returns a function that takes a request...
+  (fn [request]
+    ;; ...that calls the client function with the request
+    (client-fn request)))
+</code></pre><p>So how is this middleware used? First, it must be 'wrapped' around the
+existing client function:</p><pre><code class="clojure">(def new-client (wrap-no-op client))
+
+;; Now new-client can be used just like the client function:
+(new-client {:site "http://www.aoeu.com" :options {}})
+;; ⇒ {:status 200, :headers {...}, :request-time 3057, :body "..."}
+</code></pre><p>It works! Now it's not very exiting because it doesn't do anything
+yet, so let's add another middleware wrapper that does something more
+exiting.</p><p>Let's add a middleware function that automatically changes all "HTTP"
+requests into "HTTPS" requests. Again, we need a function that returns
+another function, so we can end up with a new method to call:</p><pre><code class="clojure">(defn wrap-https
+  [client-fn]
+  (fn [request]
+    (let [site (:site request)
+          new-site (.replaceAll site "http:" "https:")
+          new-request (assoc request :site new-site)]
+      (client-fn new-request))))
+</code></pre><p>The <code>wrap-https</code> middleware can be tested again by creating a new
+client function:</p><pre><code class="clojure">(def https-client (wrap-https client))
+
+;; Notice the :trace-redirects key shows that HTTPS was used instead
+;; of HTTP
+(https-client {:site "http://www.google.com" :options {}})
+;; ⇒ {:trace-redirects ["https://www.google.com"],
+;;    :status 200,
+;;    :headers {...},
+;;    :request-time 3057,
+;;    :body "..."}
+</code></pre><p>Middleware can be tested independently of the client function by
+providing the identity function (or any other function that returns a
+map). For example, we can see the <code>wrap-https</code> middleware returns the
+clojure map with the :site changed from 'http' to 'https':</p><pre><code class="clojure">((wrap-https identity) {:site "http://www.example.com"})
+;; ⇒ {:site "https://www.example.com"}
+</code></pre><h2 id="combining-middleware">Combining middleware</h2><p>In the previous example, we showed how to create and use middleware,
+but what about using multiple middleware functions? Let's define one
+more middleware so we have a total of three to work with. Here's the
+source for a middleware function that adds the current data to the
+response map:</p><pre><code class="clojure">(defn wrap-add-date
+  [client]
+  (fn [request]
+    (let [response (client request)]
+      (assoc response :date (java.util.Date.)))))
+</code></pre><p>And again, we can test it without using any other functions using
+<code>identity</code> as the client function:</p><pre><code class="clojure">((wrap-add-date identity) {})
+;; ⇒ {:date #inst "2012-11-09T12:41:05.171-00:00"}
+</code></pre><p>Middleware is useful on its own, but where it becomes truly more
+useful is in combining middleware together. Here's what a new client
+function looks like combining all the middleware:</p><pre><code class="clojure">(def my-client (wrap-add-date (wrap-https (wrap-no-op client))))
+
+(my-client {:site "http://www.google.com"})
+;; ⇒ {:date #inst "2012-11-09T12:43:39.451-00:00",
+;;    :cookies {...},
+;;    :trace-redirects ["https://www.google.com/"],
+;;    :request-time 1634,
+;;    :status 200,
+;;    :headers {...},
+;;    :body "..."}
+</code></pre><p>(The response map has been edited to take less space where you see
+'...')</p><p>Here we can see that the <code>wrap-https</code> middleware has successfully
+turned the request for http://www.google.com into one for
+https://www.google.com, additionally the <code>wrap-add-date</code> middleware
+has added the :date key with the date the request happened. (the
+<code>wrap-no-op</code> middleware did execute, but since it didn't do anything,
+there's no output to tell)</p><p>This is a good start, but adding middleware can be expressed in a much
+cleaner and clearer way by using Clojure's threading macro, <code>-&gt;</code>. The
+<code>my-client</code> definition from above can be expressed like this:</p><pre><code class="clojure">(def my-client
+  (-&gt; client
+      wrap-no-op
+      wrap-https
+      wrap-add-date))
+
+(my-client {:site "http://www.google.com"})
+;; ⇒ {:date #inst "2012-11-09T12:47:32.130-00:00",
+;;    :cookies {...},
+;;    :trace-redirects ["https://www.google.com/"],
+;;    :request-time 1630,
+;;    :status 200,
+;;    :headers {...},
+;;    :body "..."}
+</code></pre><p>Something else to keep in mind is that middleware expressed in this
+way will be executed <em>from the bottom up</em>, so in this case,
+<code>wrap-add-date</code> will call <code>wrap-https</code>, which in turn calls
+<code>wrap-no-op</code>, which finally calls the <code>client</code> function.</p><p>For an example of combining a large amount of middleware, see
+<a href="https://github.com/dakrone/clj-http/blob/5534950b5ed48e3bc7285f0e956444ea832399da/src/clj_http/client.clj#L542-567">clj-http's
+client.clj</a>
+file</p>
+
+    <div id="prev-next">
+        
+        <a href="../files_and_directories/index.html">&laquo; Working with Files and Directories in Clojure</a>
+        
+        
+        ||
+        
+        
+        <a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/cookbooks/strings/index.html b/clones/clojure-doc.org/articles/cookbooks/strings/index.html
new file mode 100644
index 00000000..7e952461
--- /dev/null
+++ b/clones/clojure-doc.org/articles/cookbooks/strings/index.html
@@ -0,0 +1,464 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Strings</title>
+    
+
+<meta name="description" content="This cookbook covers working with strings in Clojure using built-in
+functions, standard and contrib libraries, and parts of the JDK via
+interoperability.This work is licensed under a Creative Commons
+Attribution 3.0 Unported License (including images &amp;
+stylesheets). The source is available on
+Github.">
+
+<meta property="og:description" content="This cookbook covers working with strings in Clojure using built-in
+functions, standard and contrib libraries, and parts of the JDK via
+interoperability.This work is licensed under a Creative Commons
+Attribution 3.0 Unported License (including images &amp;
+stylesheets). The source is available on
+Github.">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/cookbooks/strings/" />
+<meta property="og:title" content="Strings" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/cookbooks/strings/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Strings</h2>
+    </div>
+    
+    <p>This cookbook covers working with strings in Clojure using built-in
+functions, standard and contrib libraries, and parts of the JDK via
+interoperability.</p><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons
+Attribution 3.0 Unported License</a> (including images &amp;
+stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on
+Github</a>.</p><h2 id="overview">Overview</h2><ul><li>Strings are <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html">plain Java
+strings</a>.
+You can use anything which operates on them.</li><li>Java strings are immutable, so they're convenient to use in Clojure.</li><li>You can't add metadata to Java strings.</li><li>Clojure supports some convenient notations:</li></ul><pre><code>    "foo"    java.lang.String
+    #"\d"    java.util.regex.Pattern (in this case, one which matches a single digit)
+    \f       java.lang.Character (in this case, the letter 'f')
+</code></pre><ul><li><strong>Caveat:</strong> Human brains and electronic computers are rather different
+devices. So Java strings (sequences of <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Character.html#unicode">UTF-16
+characters</a>)
+don't always map nicely to user-perceived characters. For example, a
+single Unicode "code point" doesn't necessarily equal a user-perceived
+character. (Like Korean Hangul Jamo, where user-perceived characters
+are composed from two or three Unicode code points.) Also, a Unicode
+code point may sometimes require 2 UTF-16 characters to encode it.</li></ul><h2 id="preliminaries">Preliminaries</h2><p>Some examples use
+<a href="http://clojure.github.io/clojure/clojure.string-api.html">clojure.string</a>,
+<a href="https://github.com/edn-format/edn">clojure.edn</a> and
+<a href="http://clojure.github.io/clojure/clojure.pprint-api.html">clojure.pprint</a>. We'll
+assume your <code>ns</code> macro contains:</p><pre><code class="clojure">(:require [clojure.string :as str]
+          [clojure.edn :as edn]
+          [clojure.pprint :as pp])
+</code></pre><p>or else in the repl you've loaded it:</p><pre><code class="clojure">(require '[clojure.string :as str])
+(require '[clojure.edn :as edn])
+(require '[clojure.pprint :as pp])
+</code></pre><h2 id="recipes">Recipes</h2><h3 id="basics">Basics</h3><pre><code class="clojure">;; Size measurements
+(count "0123")      ;=&gt; 4
+(empty? "0123")     ;=&gt; false
+(empty? "")         ;=&gt; true
+(str/blank? "    ") ;=&gt; true
+
+;; Concatenate
+(str "foo" "bar")            ;=&gt; "foobar"
+(str/join ["0" "1" "2"])     ;=&gt; "012"
+(str/join "." ["0" "1" "2"]) ;=&gt; "0.1.2"
+
+;; Matching using plain Java methods.
+;;
+;; You might prefer regexes for these. For instance, failure returns
+;; -1, which you have to test for. And characters like \o are
+;; instances of java.lang.Character, which you may have to convert to
+;; int or String.
+(.indexOf "foo" "oo")         ;=&gt; 1
+(.indexOf "foo" "x")          ;=&gt; -1
+(.lastIndexOf "foo" (int \o)) ;=&gt; 2
+
+;; Substring
+(subs "0123" 1)       ;=&gt; "123"
+(subs "0123" 1 3)     ;=&gt; "12"
+(str/trim "  foo  ")  ;=&gt; "foo"
+(str/triml "  foo  ") ;=&gt; "foo  "
+(str/trimr "  foo  ") ;=&gt; "  foo"
+
+;; Multiple substrings
+(seq "foo")                       ;=&gt; (\f \o \o)
+(str/split "foo/bar/quux" #"/")   ;=&gt; ["foo" "bar" "quux"]
+(str/split "foo/bar/quux" #"/" 2) ;=&gt; ["foo" "bar/quux"]
+(str/split-lines "foo
+bar")                             ;=&gt; ["foo" "bar"]
+
+;; Case
+(str/lower-case "fOo") ;=&gt; "foo"
+(str/upper-case "fOo") ;=&gt; "FOO"
+(str/capitalize "fOo") ;=&gt; "Foo"
+
+;; Escaping
+(str/escape "foo|bar|quux" {\| "||"}) ;=&gt; "foo||bar||quux"
+
+;; Get byte array of given encoding.
+;; (The output will likely have a different number than "3c3660".)
+(.getBytes "foo" "UTF-8") ;=&gt; #&lt;byte[] [B@3c3660&gt;
+
+;; Parsing keywords
+(keyword "foo")    ;=&gt; :foo
+
+;; Parsing numbers
+(bigint "20000000000000000000000000000") ;=&gt; 20000000000000000000000000000N
+(bigdec "20000000000000000000.00000000") ;=&gt; 20000000000000000000.00000000M
+(Integer/parseInt "2")                   ;=&gt; 2
+(Float/parseFloat "2")                   ;=&gt; 2.0
+
+;; Parsing edn, a subset of Clojure forms.
+(edn/read-string "0xffff") ;=&gt; 65535
+
+;; The sledgehammer approach to reading Clojure forms.
+;;
+;; SECURITY WARNING: Ensure *read-eval* is false when dealing with
+;; strings you don't 100% trust. Even though *read-eval* is false by
+;; default since Clojure 1.5, be paranoid and set it to false right
+;; before you use it, because anything could've re-bound it to true.
+(binding [*read-eval* false]
+  (read-string "#\"[abc]\""))
+;=&gt; #"[abc]"
+</code></pre><h3 id="parsing-complex-strings">Parsing complex strings</h3><h4 id="regexes">Regexes</h4><p>Regexes offer a boost in string-matching power. You can express ideas
+like repetition, alternatives, etc.</p><p><a href="http://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html">Regex
+reference.</a></p><p><strong>Groups:</strong> Regex groups are useful, when we want to match more than
+one substring. (Or refer to matches later.) In the regex <code>#"(group-1) (group-2)"</code>, the 0th group is the whole match. The 1st group is
+started by the left-most <code>(</code>, the 2nd group is started by the
+second-left-most <code>(</code>, etc. You can even nest groups. You can refer to
+groups later using <code>$0</code>, <code>$1</code>, etc.</p><p><strong>Matching</strong></p><pre><code class="clojure">;; Simple matching
+(re-find #"\d+" "foo 123 bar") ;=&gt; "123"
+
+;; What happens when a match fails.
+(re-find #"\d+" "foobar") ;=&gt; nil
+
+;; Return only the first groups which satisfy match.
+(re-matches #"(@\w+)\s([.0-9]+)%"
+            "@shanley 19.8%")
+;=&gt;["@shanley 19.8%" "@shanley" "19.8"]
+
+;; Return seq of all matching groups which occur in string.
+(re-seq #"(@\w+)\s([.0-9]+)%"
+        "@davidgraeber 12.3%,@shanley 19.8%")
+;=&gt; (["@davidgraeber 12.3%" "@davidgraeber" "12.3"]
+;    ["@shanley 19.8%" "@shanley" "19.8"])
+</code></pre><p><strong>Replacing</strong></p><p>We use <code>str/replace</code>. Aside from the first arg (the initial string),
+the next two args are match and replacement:</p><pre><code>   match / replacement can be:
+     string / string
+     char / char
+     pattern / (string or function of match).
+</code></pre><pre><code class="clojure">;; In the replacement string, $0, $1, etc refer to matched groups.
+(str/replace "@davidgraeber 12.3%,@shanley 19.8%"
+             #"(@\S+)\s([.0-9]+)%"
+             "$2 ($1)")
+;=&gt; "12.3 (@davidgraeber),19.8 (@shanley)"
+
+;; Using a function to replace text gives us power.
+(println
+  (str/replace "@davidgraeber 12.3%,@shanley 19.8%"
+               #"(@\w+)\s([.0-9]+)%,?"
+               (fn [[_ person percent]]
+                   (let [points (-&gt; percent Float/parseFloat (* 100) Math/round)]
+                     (str person "'s followers grew " points " points.\n")))))
+;print=&gt; @davidgraeber's followers grew 1230 points.
+;print=&gt; @shanley's followers grew 1980 points.
+;print=&gt;
+</code></pre><h4 id="context-free-grammars">Context-free grammars</h4><p>Context-free grammars offer yet another boost in expressive matching
+power, compared to regexes. You can express ideas like nesting.</p><p>We'll use <a href="https://github.com/Engelberg/instaparse">Instaparse</a> on
+<a href="http://www.json.org/">JSON's grammar</a>.  (This example isn't seriously
+tested nor a featureful parser. Use
+<a href="https://github.com/clojure/data.json">data.json</a> instead.)</p><pre><code class="clojure">;; Your project.clj should contain this (you may need to restart your JVM):
+;;   :dependencies [[instaparse "1.2.4"]]
+;;
+;;  We'll assume your ns macro contains:
+;;   (:require [instaparse.core :as insta])
+;; or else in the repl you've loaded it:
+;;   (require '[instaparse.core :as insta])
+
+(def barely-tested-json-parser
+  (insta/parser
+   "object     = &lt;'{'&gt; &lt;w*&gt; (members &lt;w*&gt;)* &lt;'}'&gt;
+    &lt;members&gt;  = pair (&lt;w*&gt; &lt;','&gt; &lt;w*&gt; members)*
+    &lt;pair&gt;     = string &lt;w*&gt; &lt;':'&gt; &lt;w*&gt; value
+    &lt;value&gt;    = string | number | object | array | 'true' | 'false' | 'null'
+    array      = &lt;'['&gt; elements* &lt;']'&gt;
+    &lt;elements&gt; = value &lt;w*&gt; (&lt;','&gt; &lt;w*&gt; elements)*
+    number     = int frac? exp?
+    &lt;int&gt;      = '-'? digits
+    &lt;frac&gt;     = '.' digits
+    &lt;exp&gt;      = e digits
+    &lt;e&gt;        = ('e' | 'E') (&lt;'+'&gt; | '-')?
+    &lt;digits&gt;   = #'[0-9]+'
+    (* First sketched state machine; then it was easier to figure out
+       regex syntax and all the maddening escape-backslashes. *)
+    string     = &lt;'\\\"'&gt; #'([^\"\\\\]|\\\\.)*' &lt;'\\\"'&gt;
+    &lt;w&gt;        = #'\\s+'"))
+
+(barely-tested-json-parser "{\"foo\": {\"bar\": 99.9e-9, \"quux\": [1, 2, -3]}}")
+;=&gt; [:object
+;     [:string "foo"]
+;     [:object
+;       [:string "bar"]
+;       [:number "99" "." "9" "e" "-" "9"]
+;       [:string "quux"]
+;       [:array [:number "1"] [:number "2"] [:number "-" "3"]]]]
+
+;; That last output is a bit verbose. Let's process it further.
+(-&gt;&gt; (barely-tested-json-parser "{\"foo\": {\"bar\": 99.9e-9, \"quux\": [1, 2, -3]}}")
+     (insta/transform {:object hash-map
+                       :string str
+                       :array vector
+                       :number (comp edn/read-string str)}))
+;=&gt; {"foo" {"quux" [1 2 -3], "bar" 9.99E-8}}
+
+
+;; Now we can appreciate what those &lt;angle-brackets&gt; were all about.
+;;
+;; When to the right of the grammar's =, it totally hides the enclosed
+;; thing in the output. For example, we don't care about whitespace,
+;; so we hide it with &lt;w*&gt;.
+;;
+;; When to the left of the grammar's =, it merely prevents a level of
+;; nesting in the output. For example, "members" is a rather
+;; artificial entity, so we prevent a pointless level of nesting with
+;; &lt;members&gt;.
+</code></pre><h3 id="building-complex-strings">Building complex strings</h3><h4 id="redirecting-streams">Redirecting streams</h4><p><code>with-out-str</code> provides a simple way to build strings. It redirects
+standard output (<code>*out*</code>) to a fresh <code>StringWriter</code>, then returns the
+resulting string. So you can use functions like <code>print</code>, <em>even in
+nested functions</em>, and get the resulting string at the end.</p><pre><code class="clojure">(let [shrimp-varieties ["shrimp-kabobs" "shrimp creole" "shrimp gumbo"]]
+  (with-out-str
+    (print "We have ")
+    (doseq [name (str/join ", " shrimp-varieties)]
+      (print name))
+    (print "...")))
+;=&gt; "We have shrimp-kabobs, shrimp creole, shrimp gumbo..."
+</code></pre><h4 id="format-strings">Format strings</h4><p>Java's templating mini-language helps you build many strings
+conveniently. <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Formatter.html">Reference.</a></p><pre><code class="clojure">;; %s is most commonly used to print args. Escape %'s with %%.
+(format "%s enjoyed %s%%." "Mozambique" 19.8) ;=&gt; "Mozambique enjoyed 19.8%."
+
+;; The 1$ prefix allows you to keep referring to the first arg.
+(format "%1$tY-%1$tm-%1$td" #inst"2000-01-02T00:00:00") ;=&gt; "2000-01-02"
+
+;; Again, 1$, 2$, etc prefixes let us refer to args in arbitrary orders.
+(format "New year: %2$tY. Old year: %1$tY"
+        #inst"2000-01-02T00:00:00"
+        #inst"3111-12-31T00:00:00")
+;=&gt; "New year: 3111. Old year: 2000"
+</code></pre><h4 id="cl-format">CL-Format</h4><p><code>cl-format</code> is a port of Common Lisp's notorious, powerful string
+formatting mini-language. For example, you can build strings from
+sequences. (As well as oddities like print numbers in English or two
+varieties of Roman numerals.) However, it's weaker than plain <code>format</code>
+with printing dates and referring to args in arbitrary order.</p><p>Remember that <code>cl-format</code> represents a (potentially unreadable)
+language which your audience didn't sign up to learn. If you're the
+sort of person who likes it, try to only use it in sweetspots where it
+provides clarity for little complexity.</p><p><a href="http://www.gigamonkeys.com/book/a-few-format-recipes.html">Tutorial</a>
+in Practical Common
+Lisp. <a href="http://www.lispworks.com/documentation/HyperSpec/Body/22_c.htm">Reference</a>
+in Common Lisp's Hyperspec.</p><pre><code class="clojure">;; The first param prints to *out* if true. To string if false.
+;; To a stream if it's a stream.
+(pp/cl-format true "~{~{~a had ~s percentage point~:p.~}~^~%~}"
+              {"@davidgraeber" 12.3
+               "@shanley" 19.8
+               "@tjgabbour" 1})
+;print=&gt; @davidgraeber had 12.3 percentage points.
+;print=&gt; @tjgabbour had 1 percentage point.
+;print=&gt; @shanley had 19.8 percentage points.
+
+(def format-string "~{~#[~;~a~;~a and ~a~:;~@{~a~#[~;, and ~:;, ~]~}~]~}")
+(pp/cl-format nil format-string [])
+;=&gt; ""
+(pp/cl-format nil format-string ["@shanley"])
+;=&gt; "@shanley"
+(pp/cl-format nil format-string ["@shanley", "@davidgraeber"])
+;=&gt; "@shanley and @davidgraeber"
+(pp/cl-format nil format-string ["@shanley", "@davidgraeber", "@sarahkendzior"])
+;=&gt; "@shanley, @davidgraeber, and @sarahkendzior"
+</code></pre><h2 id="contributors">Contributors</h2><p>Tj Gabbour <a href="mailto:tjg@simplevalue.de">tjg@simplevalue.de</a>, 2013 (original author)</p>
+
+    <div id="prev-next">
+        
+        <a href="../data_structures/index.html">&laquo; Data Structures (Help wanted)</a>
+        
+        
+        ||
+        
+        
+        <a href="../math/index.html">Mathematics with Clojure &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="index.html">Strings</a></li>
+                    
+                    <li><a href="../math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/books/index.html b/clones/clojure-doc.org/articles/ecosystem/books/index.html
new file mode 100644
index 00000000..1f26cc23
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/books/index.html
@@ -0,0 +1,230 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Books about Clojure and ClojureScript</title>
+    
+
+<meta name="description" content="This guide covers:">
+
+<meta property="og:description" content="This guide covers:">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/books/" />
+<meta property="og:title" content="Books about Clojure and ClojureScript" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/books/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Books about Clojure and ClojureScript</h2>
+    </div>
+    
+    <p>This guide covers:</p><ul><li>Books about Clojure</li><li>Books about ClojureScript</li></ul><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons Attribution 3.0 Unported License</a>
+(including images &amp; stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on Github</a>.</p><h2 id="overview">Overview</h2><p>As of September 2014, Clojure has over a dozen books published (or available for
+preview) about it, plus two about ClojureScript. This guide lists some of them
+in reverse chronological order and intended to provide a very brief
+overview of each. It is by no means comprehensive and may be quite
+opinionated. The goal is to identify books that are more useful to
+newcomers than others and recommend books that cover recent releases
+of Clojure (1.3+).</p><h2 id="books-about-clojure">Books About Clojure</h2><p>Note: books are listed in reverse chronological order.</p><h3 id="getting-clojure-build-your-functional-skills-one-idea-at-a-time">Getting Clojure: Build Your Functional Skills One Idea at a Time</h3><p>By Russ Olsen</p><h3 id="notes">Notes</h3><p>An accessible introduction to Clojure that focuses on the ideas behind the language as well as the practical details of writing code.</p><h3 id="where-you-can-buy-it">Where You Can Buy It</h3><ul><li><a href="https://pragprog.com/book/roclojure/getting-clojure#">The Pramatic Bookshelf</a>: eBook, paperback</li></ul><h3 id="clojure-microservices-with-clojure">Clojure: Microservices with Clojure</h3><p>By Anuj Kumar</p><h4 id="notes-1">Notes</h4><p>The common patterns and practices of the microservice architecture and their application using the Clojure programming language.</p><h4 id="where-you-can-buy-it-1">Where You Can Buy It</h4><ul><li><a href="https://www.packtpub.com/application-development/microservices-clojure">Packt</a>: eBook, paperback</li><li><a href="https://www.amazon.com/dp/1788622243">Amazon</a>: eBook, paperback</li></ul><h3 id="clojure-high-performance-jvm-programming">Clojure: High Performance JVM Programming</h3><p>By Eduardo Díaz, Shantanu Kumar, Akhil Wali</p><h4 id="notes-2">Notes</h4><p>Explore the world of lightning fast Clojure apps with asynchronous channels, logic, reactive programming and more.</p><h4 id="where-you-can-buy-it-2">Where You Can Buy It</h4><ul><li><a href="https://www.packtpub.com/application-development/clojure-high-performance-jvm-programming">Packt</a>:  eBook, paperback</li></ul><h3 id="clojure-standard-library-an-annotated-guide">Clojure Standard Library (An Annotated Guide)</h3><p>By Renzo Borgatti</p><h4 id="notes-3">Notes</h4><p>The book illustrates the functions and macros contained in the Clojure standard library adding examples and implementation notes. Currently in early access.</p><h4 id="where-you-can-buy-it-3">Where You Can Buy It</h4><ul><li><a href="https://www.manning.com/books/clojure-standard-library">Manning</a>: eBook</li></ul><h3 id="clojure-programming-cookbook">Clojure Programming Cookbook</h3><p>By Makoto Hashimoto, Nicolas Modrzyk</p><h4 id="notes-4">Notes</h4><p>Handle every problem you come across in the world of Clojure programming with this expert collection of recipes</p><h4 id="where-you-can-buy-it-4">Where You Can Buy It</h4><ul><li><a href="https://www.packtpub.com/application-development/clojure-programming-cookbook">Packt</a>:  eBook, paperback</li></ul><h3 id="mastering-clojure">Mastering Clojure</h3><p>By Akhil Wali</p><h4 id="notes-5">Notes</h4><p>Understand the philosophy of the Clojure language and dive into its inner workings to unlock its advanced features, methodologies, and constructs</p><h4 id="where-you-can-buy-it-5">Where You Can Buy It</h4><ul><li><a href="https://www.packtpub.com/application-development/mastering-clojure">Packt</a>:  eBook, paperback</li></ul><h3 id="clojure-for-java-developers">Clojure for Java Developers</h3><p>By Eduardo Díaz</p><h4 id="notes-6">Notes</h4><p>Discover Clojure’s features and advantages and use them in your existing projects</p><h4 id="where-you-can-buy-it-6">Where You Can Buy It</h4><ul><li><a href="https://www.packtpub.com/application-development/clojure-java-developers">Packt</a>:  eBook, paperback</li></ul><h3 id="clojure-for-finance">Clojure for Finance</h3><p>By Timothy Washington</p><h4 id="notes-7">Notes</h4><p>A practical step-by-step tutorial that provides a basic overview of the concepts but focuses on providing the skills required to analyze data.</p><h4 id="where-you-can-buy-it-7">Where You Can Buy It</h4><ul><li><a href="https://www.packtpub.com/big-data-and-business-intelligence/clojure-finance">Packt</a>:  eBook, paperback</li></ul><h3 id="mastering-clojure-macros">Mastering Clojure Macros</h3><p>By Colin Jones.</p><h4 id="notes-8">Notes</h4><p>A book that walks you step-by-step from the basic building blocks of macros to creating new language features.</p><h4 id="where-you-can-buy-it-8">Where You Can Buy It</h4><ul><li><a href="https://pragprog.com/book/cjclojure/mastering-clojure-macros">Pragmatic Programmers</a>:  eBook, paperback</li><li><a href="http://www.amazon.com/Mastering-Clojure-Macros-Cleaner-Smarter/dp/1941222226">Paperback on Amazon</a></li></ul><h3 id="the-joy-of-clojure-2nd-edition">The Joy of Clojure, 2nd Edition</h3><p>By Michael Fogus and Chris Houser.</p><h4 id="notes-9">Notes</h4><p>Updated for Clojure 1.6 with new content.</p><h4 id="where-you-can-buy-it-9">Where You Can Buy It</h4><ul><li><a href="http://joyofclojure.com/">Official Site</a></li><li>From <a href="http://www.manning.com/fogus2/">Manning</a>: eBook, paperback</li><li><a href="http://www.amazon.com/The-Joy-Clojure-Michael-Fogus/dp/1617291412">Paperback on Amazon</a></li></ul><h3 id="mastering-clojure-data-analysis">Mastering Clojure Data Analysis</h3><p>By Eric Rochester.</p><h4 id="notes-10">Notes</h4><p>This book presents a more in-depth look into Data Analysis than the author's
+other book <a href="index.html#clojure-data-analysis-cookbook">Clojure Data Analysis Cookbook</a>.
+Several topics (Network Analysis, GIS Analysis, Topic Modeling, Sentiment
+Analysis, etc) are examined with examples using Clojure to process real-world data.</p><h4 id="where-you-can-buy-it-10">Where You Can Buy It</h4><ul><li><a href="https://www.packtpub.com/big-data-and-business-intelligence/mastering-clojure-data-analysis">Packt Publishing</a>:  eBook, paperback</li><li><a href="http://www.amazon.com/Mastering-Clojure-Data-Analysis-Rochester-ebook/dp/B00KLAJ66S">Kindle version on Amazon</a></li><li><a href="http://www.amazon.com/Mastering-Clojure-Data-Analysis-Rochester/dp/1783284137">Paperback on Amazon</a></li></ul><h3 id="clojure-for-machine-learning">Clojure for Machine Learning</h3><p>By Akhil Wali.</p><h4 id="notes-11">Notes</h4><p>An introduction to machine learning problems, techniques and algorithms and
+how they can be applied against real-world problems using Clojure.</p><h4 id="where-you-can-buy-it-11">Where You Can Buy It</h4><ul><li><a href="https://www.packtpub.com/big-data-and-business-intelligence/clojure-machine-learning">Packt Publishing</a>: eBook, paperback</li><li><a href="http://www.amazon.com/Clojure-Machine-Learning-Akhil-Wali-ebook/dp/B00JXLF78M">Kindle version on Amazon</a></li><li><a href="http://www.amazon.com/Clojure-Machine-Learning-Akhil-Wali/dp/1783284358">Paperback on Amazon</a></li></ul><h3 id="web-development-with-clojure-build-bulletproof-web-apps-with-less-code">Web Development with Clojure: Build Bulletproof Web Apps with Less Code</h3><p>By Dmitri Sotnikov.</p><h4 id="notes-12">Notes</h4><p>This book shows you how to leverage Clojure web-development libraries to
+create web applications using an example-based approach.</p><h4 id="where-you-can-buy-it-12">Where You Can Buy It</h4><ul><li>From <a href="https://pragprog.com/book/dswdcloj/web-development-with-clojure">Pragmatic Programmers</a>: eBook, paperback</li><li><a href="http://www.amazon.com/Web-Development-Clojure-Build-Bulletproof/dp/1937785645">Kindle version on Amazon</a></li><li><a href="http://www.amazon.com/Clojure-Machine-Learning-Akhil-Wali/dp/1783284358">Paperback on Amazon</a></li></ul><h3 id="clojure-high-performance-programming">Clojure High Performance Programming</h3><p>By Shantanu Kumar.</p><h4 id="notes-13">Notes</h4><p>A book on all things performant code in Clojure and on the JVM: profiling,
+benchmarking, data structures, laziness impact, and more.</p><h4 id="where-you-can-buy-it-13">Where You Can Buy It</h4><ul><li><a href="http://www.packtpub.com/clojure-high-performance-programming/book">Packt Publishing</a>: eBook, paperback</li><li><a href="http://www.amazon.com/Clojure-Performance-Programming-Shantanu-Kumar-ebook/dp/B00GTE1RVW/">Amazon</a>: eBook (Kindle), paperback</li></ul><h3 id="clojure-for-the-brave-and-true">Clojure For The Brave and True</h3><p>By Daniel Higginbotham.</p><h4 id="notes-14">Notes</h4><p>A book for beginners. Covers the language and key parts of the ecosystem.</p><h4 id="where-you-can-buy-it-14">Where You Can Buy It</h4><ul><li><a href="http://www.braveclojure.com/">Official Site</a></li></ul><h3 id="clojure-cookbook">Clojure Cookbook</h3><p>By Luke VanderHart, Ryan Neufeld.</p><h4 id="notes-15">Notes</h4><p><a href="https://github.com/clojure-cookbook/clojure-cookbook/blob/master/CONTRIBUTING.md">Crowdsourced</a> cookbook of about 200 recipes from O'Reilly. Work in progress
+as of September 2013 but over 100 recipes are already available in the repository.</p><h4 id="where-you-can-buy-it-15">Where You Can Buy It</h4><ul><li><a href="http://clojure-cookbook.com">Official Site</a></li></ul><h3 id="functional-programming-for-the-object-oriented-programmer">Functional Programming for the Object-Oriented Programmer</h3><p>By Brian Marick.</p><h4 id="notes-16">Notes</h4><p>This is a book about functional programming for those with object-oriented programming
+backgrounds that uses Clojure in examples.</p><p>It is often cited as a good introductory book for newcomers to Clojure.</p><h4 id="where-you-can-buy-it-16">Where You Can Buy It</h4><ul><li><a href="https://leanpub.com/fp-oo">On Leanpub</a>, eBook (Kindle, ePub, PDF).</li></ul><h3 id="clojure-programming">Clojure Programming</h3><p>By Chas Emerick, Brian Carper, and Christophe Grand.</p><h4 id="notes-17">Notes</h4><p>An excellent introductory book. Friendly to newcomers to the language and functional programming in general.</p><h4 id="where-you-can-buy-it-17">Where You Can Buy It</h4><ul><li><a href="http://www.clojurebook.com/">Official Site</a></li><li>From <a href="http://shop.oreilly.com/product/0636920013754.do">O'Reilly</a>, eBook (Kindle, ePub, PDF) or paperback.</li><li><a href="http://www.amazon.com/Clojure-Programming-ebook/dp/B007Q4T040/ref=tmm_kin_title_0?ie=UTF8&amp;qid=1350284538&amp;sr=8-1">Kindle version on Amazon</a></li><li><a href="http://www.amazon.com/Clojure-Programming-Chas-Emerick/dp/1449394701/ref=sr_1_1?ie=UTF8&amp;qid=1350284538&amp;sr=8-1&amp;keywords=Clojure">Paperback on Amazon</a></li></ul><h3 id="programming-clojure-2nd-ed">Programming Clojure, 2nd Ed</h3><p>By Stuart Halloway and Aaron Bedra.</p><h4 id="notes-18">Notes</h4><p>2nd edition of the oldest book about Clojure. Updated for Clojure 1.3+ and includes new content, for example, introduction
+to <code>test.generative</code>, a Clojure testing framework similar to QuickCheck. A good book for beginners.</p><h4 id="where-you-can-buy-it-18">Where You Can Buy It</h4><ul><li>From <a href="http://pragprog.com/book/shcloj2/programming-clojure">Pragmatic Programmers</a>, eBook (Kindle, ePub, PDF) or paperback.</li><li><a href="http://www.amazon.com/Programming-Clojure-Stuart-Halloway/dp/1934356867/ref=sr_1_4?ie=UTF8&amp;qid=1350284538&amp;sr=8-4&amp;keywords=Clojure">Paperback on Amazon</a></li></ul><h3 id="the-joy-of-clojure-1st-ed">The Joy of Clojure, 1st Ed</h3><p>By Michael Fogus and Chris Houser.</p><h4 id="notes-19">Notes</h4><p>It's not an overstatement to say that this is a legendary book in the Clojure community. Covers "the what and why of Clojure".
+To really appreciate it, however, you will need to have some real Clojure experience under your belt.</p><h4 id="where-you-can-buy-it-19">Where You Can Buy It</h4><ul><li><a href="http://joyofclojure.com/">Official Site</a></li><li>From <a href="http://www.manning.com/fogus/">Manning</a>, eBook (Kindle, ePub, PDF) or paperback.</li><li><a href="http://www.amazon.com/The-Joy-Clojure-Thinking-Way/dp/1935182641/ref=sr_1_2?ie=UTF8&amp;qid=1350284538&amp;sr=8-2&amp;keywords=Clojure">Paperback on Amazon</a></li></ul><h3 id="clojure-data-analysis-cookbook">Clojure Data Analysis Cookbook</h3><p>By Eric Rochester.</p><h4 id="notes-20">Notes</h4><p>Covers multiple topics related to data analysis and data processing:</p><ul><li>Acquiring data</li><li>Cleaning data</li><li>Analyzing data</li><li>Visualizing data</li><li>Basic statistics</li><li>Basic machine learning</li></ul><h4 id="where-you-can-buy-it-20">Where You Can Buy It</h4><ul><li>From <a href="http://www.packtpub.com/clojure-data-analysis-cookbook/book">Packt Publishing</a></li></ul><h3 id="clojure-in-action-2nd-ed">Clojure in Action, 2nd Ed</h3><p>By Amit Rathore.</p><h4 id="notes-21">Notes</h4><p>Extended version of the first edition that covers Clojure 1.5, ClojureScript and Datomic.</p><h4 id="where-you-can-buy-it-21">Where You Can Buy It</h4><ul><li>From <a href="http://www.manning.com/rathore2/">Manning</a>, MEAP eBook (Kindle, ePub, PDF).</li></ul><h3 id="clojure-made-simple">Clojure Made Simple</h3><p>By <a href="https://twitter.com/jr0cket">John Stevenson</a>.</p><h4 id="notes-22">Notes</h4><p>A quick taste of Clojure for developers curious about the language.  Its aimed at the complete beginner who wants to give Clojure a quick try before making a big investment.  Its a short book in ebook only form and available for a few dollars.</p><h4 id="where-you-can-buy-it-22">Where You Can Buy It</h4><ul><li><a href="http://developerpress.com/en/clojure-made-simple-introduction-clojure">Official site</a></li><li><a href="http://clojuremadesimple.co.uk/">Book support site</a></li><li><a href="https://ganxy.com/i/77456/john-stevenson/clojure-made-simple">ganxy.com</a></li><li><a href="http://www.amazon.com/Clojure-Made-Simple-ebook/dp/B00BSY20HS">Kindle version on Amazon</a></li><li><a href="https://itunes.apple.com/us/book/clojure-made-simple/id618287958?mt=11">Apple iBookStore</a></li><li><a href="https://play.google.com/store/books/details/John_Stevenson_Clojure_Made_Simple?id=yqfBJYhvqJcC&amp;feature=nav_result#?t=W251bGwsMSwxLDMsImJvb2steXFmQkpZaHZxSmNDIl0.">Google Play</a></li></ul><h3 id="practical-clojure">Practical Clojure</h3><p>By Luke VanderHart, Stuart Sierra.</p><h4 id="notes-23">Notes</h4><p>A good introductory book.</p><h4 id="where-you-can-buy-it-23">Where You Can Buy It</h4><ul><li>From <a href="http://www.apress.com/9781430272311">Apress</a>, eBook or paperback.</li><li><a href="http://www.amazon.com/Practical-Clojure-Experts-Source-ebook/dp/B003VM7G3S/ref=sr_1_12?ie=UTF8&amp;qid=1350284538&amp;sr=8-12&amp;keywords=Clojure">Kindle version on Amazon</a></li><li><a href="http://www.amazon.com/Practical-Clojure-Experts-Voice-Source/dp/1430272317/ref=sr_1_6?ie=UTF8&amp;qid=1350284538&amp;sr=8-6&amp;keywords=Clojure">Paperback on Amazon</a></li></ul><h3 id="clojure-in-action-1st-ed">Clojure in Action, 1st Ed</h3><p>By Amit Rathore.</p><h4 id="notes-24">Notes</h4><p>Contains many practical examples. The last chapter on metaprogramming and DSLs is fantastic.</p><p><strong>This book covers Clojure 1.2</strong>. There were breaking changes in the language between Clojure 1.2 and 1.3,
+keep this in mind.</p><h4 id="where-you-can-buy-it-24">Where You Can Buy It</h4><ul><li>From <a href="http://www.manning.com/rathore/">Manning</a>, eBook (Kindle, ePub, PDF) or paperback.</li><li><a href="http://www.amazon.com/Clojure-Action-Amit-Rathore/dp/1935182595/ref=sr_1_3?ie=UTF8&amp;qid=1350284538&amp;sr=8-3&amp;keywords=Clojure">Paperback on Amazon</a></li></ul><h3 id="clojure---grundlagen-concurrent-programming-java">Clojure - Grundlagen, Concurrent Programming, Java</h3><p>By Stefan Kamphausen, Tim Oliver Kaiser</p><h4 id="notes-25">Notes</h4><ul><li>Written in German</li><li><strong>This book covers Clojure 1.2</strong>. There were breaking changes in
+the language between Clojure 1.2 and 1.3, keep this in mind.  The
+chapter on the contrib library in particular can be considered
+outdated.</li></ul><h4 id="where-you-can-buy-it-25">Where You Can Buy It</h4><ul><li>From
+<a href="http://www.dpunkt.de/buecher/3372/clojure.html">dpunkt.verlag</a>,
+eBook (PDF) or paperback.</li><li>From <a href="http://www.buch.de/shop/home/suchartikel/clojure/ISBN3-89864-684-X/">Buch.de</a></li><li><a href="http://www.amazon.de/Clojure-Grundlagen-Concurrent-Programming-Java/dp/389864684X/">Paperback on Amazon</a></li></ul><h3 id="programming-clojure-1st-ed">Programming Clojure, 1st Ed</h3><p>By Stuart Halloway.</p><h4 id="notes-26">Notes</h4><p>The oldest book on Clojure. Please consider getting the 2nd edition which covers a more recent version
+and includes several updates.</p><p><strong>This book covers Clojure 1.2</strong>.</p><h4 id="where-you-can-buy-it-26">Where You Can Buy It</h4><ul><li>From <a href="http://pragprog.com/book/shcloj/programming-clojure">Pragmatic Programmers</a></li><li><a href="http://www.amazon.com/Programming-Clojure-Pragmatic-Programmers-Halloway/dp/1934356336/ref=sr_1_7?ie=UTF8&amp;qid=1350284538&amp;sr=8-7&amp;keywords=Clojure">Paperback on Amazon</a></li></ul><h2 id="books-about-clojurescript">Books About ClojureScript</h2><h3 id="learning-clojurescript">Learning ClojureScript</h3><p>By W. David Jarvis, Rafik Naccache &amp; Allen Rohner</p><h4 id="notes-27">Notes</h4><p>Master the art of agile single page web application development with ClojureScript</p><h4 id="where-you-can-buy-it-27">Where You Can Buy It</h4><ul><li><a href="https://www.packtpub.com/web-development/learning-clojurescript">Packt</a>:  eBook, paperback</li></ul><h3 id="clojurescript-up-and-running">ClojureScript: Up and Running</h3><p>By Stuart Sierra and Luke VanderHart.</p><h4 id="notes-28">Notes</h4><p>The first book about ClojureScript, a Clojure implementation that compiles to JavaScript.</p><h4 id="where-you-can-buy-it-28">Where You Can Buy It</h4><ul><li>From <a href="http://shop.oreilly.com/product/0636920025139.do">O'Reilly</a>, eBook (Kindle, ePub, PDF) or paperback.</li></ul>
+
+    <div id="prev-next">
+        
+        <a href="../running_cljug/index.html">&laquo; Running a Clojure User Group</a>
+        
+        
+        ||
+        
+        
+        <a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted) &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/community/index.html b/clones/clojure-doc.org/articles/ecosystem/community/index.html
new file mode 100644
index 00000000..77366eac
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/community/index.html
@@ -0,0 +1,213 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Clojure Community</title>
+    
+
+<meta name="description" content="This guide covers:">
+
+<meta property="og:description" content="This guide covers:">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/community/" />
+<meta property="og:title" content="Clojure Community" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/community/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Clojure Community</h2>
+    </div>
+    
+    <p>This guide covers:</p><ul><li>The Official Clojure mailing lists</li><li>IRC channel</li><li>Documentation sites</li><li>Clojure User Groups around the globe</li><li>Conferences about or related to Clojure</li><li>Various Community sites about Clojure (subreddit, etc)</li></ul><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons Attribution 3.0 Unported License</a>
+(including images &amp; stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on Github</a>.</p><h2 id="clojure-mailing-lists">Clojure Mailing Lists</h2><ul><li><a href="https://groups.google.com/forum/?fromgroups#!forum/clojure">Clojure user mailing list</a></li><li><a href="https://groups.google.com/forum/?fromgroups#!forum/clojure-dev">Clojure development mailing list</a></li></ul><h2 id="clojure-irc-channels">Clojure IRC Channels</h2><h3 id="main-channel">Main Channel</h3><p><code>#clojure</code> on <code>irc.freenode.net</code>.</p><p>Channel logs are available at <a href="http://clojure-log.n01se.net/">clojure-log.n01se.net</a> and <a href="http://www.raynes.me/logs/irc.freenode.net/clojure/">www.raynes.me/logs/irc.freenode.net/clojure/</a>.</p><h3 id="documentation-channel">Documentation Channel</h3><p><code>#clojure-doc</code> on <code>irc.freenode.net</code>.</p><h2 id="documentation">Documentation</h2><ul><li><a href="http://clojuredocs.org/">Clojuredocs</a>: Clojure API reference, with examples</li><li><a href="http://jafingerhut.github.io/cheatsheet/clojuredocs/cheatsheet-tiptip-no-cdocs-summary.html">Clojure API Cheatsheet</a></li><li><a href="http://clojurekoans.com/">Clojure Koans</a></li><li><a href="http://www.getclojure.org">GetClojure</a>: Tens of thousands of searchable Clojure examples mined from all over the internet.</li><li><a href="http://grimoire.arrdem.com/">Grimoire</a></li></ul><h2 id="courses">Courses</h2><ul><li><a href="http://www.udemy.com/clojure-code">Udemy's 19 part series on Clojure</a></li><li><a href="http://mooc.cs.helsinki.fi/clojure">Functional Programming with Clojure</a></li></ul><h2 id="user-groups">User Groups</h2><ul><li>The list of <a href="../user_groups/index.html">Clojure User Groups</a> around the world</li><li><a href="../running_cljug/index.html">How to run your own Clojure User Group</a></li></ul><h2 id="videos-about-clojure">Videos About Clojure</h2><p>Videos of talks about Clojure are often made available on <a href="http://www.infoq.com/clojure">InfoQ</a>, and <a href="https://www.youtube.com/user/ClojureTV">Clojure YouTube channel</a>.</p><ul><li><a href="http://vimeo.com/channels/fulldisclojure/videos">Full Disclojure</a> is a series of screencasts about Clojure</li><li><a href="http://pluralsight.com/training/Courses/TableOfContents/clojure-concurrency-tutorial">Clojure Concurrency Tutorial</a></li><li><a href="http://shop.oreilly.com/product/0636920030409.do">Clojure Inside Out</a> from O'Reilly</li><li><a href="http://www.youtube.com/playlist?list=PL1p6TgkbKXqyOwq6iSkce_EY5YWFHciHt">Clojure Koans Walkthroughs</a></li><li><a href="http://pluralsight.com/training/courses/TableOfContents?courseName=clojure-fundamentals-part-one">Clojure Fundamentals</a></li><li><a href="http://www.purelyfunctional.tv/">LispCast</a></li><li><a href="https://tbaldridge.pivotshare.com/">Clojure Tutorials by Tim Baldridge</a></li></ul><h2 id="podcasts-about-clojure">Podcasts About Clojure</h2><ul><li><a href="http://mostlylazy.com/">Mostly λazy… a Clojure podcast</a> by Chas Emerick</li><li><a href="http://cognitect.com/podcast">Cognicast</a> by Craig Andera often discusses topics relevant to Clojure and ClojureScript.</li></ul><h2 id="code-repositories">Code Repositories</h2><p>Most folks host their projects at
+<a href="https://github.com/languages/Clojure">GitHub</a>, and most pure Clojure
+library distributions (with the exception of contrib) are available at
+<a href="https://clojars.org/">Clojars</a>.</p><h2 id="websites">Websites</h2><ul><li><a href="http://clojure.org/">Clojure.org</a>: the official website</li><li><a href="http://planet.clojure.in/">Planet Clojure</a>: aggregator of selected Clojure-related blog posts</li><li><a href="http://rosettacode.org/wiki/Category:Clojure">Clojure at Rosetta Code</a></li><li><a href="http://dev.clojure.org/dashboard.action">Clojure Confluence wiki</a></li><li><a href="http://www.clojure-toolbox.com/">The Clojure Toolbox</a>: a categorized directory of libraries and tools for Clojure</li><li><a href="https://www.4clojure.com/">4Clojure</a>: Clojure exercise problems</li><li><a href="http://exercism.io/">Exercism.io</a>: Peer-reviewed Clojure exercises</li></ul><h2 id="forums">Forums</h2><ul><li><a href="http://www.reddit.com/r/clojure">r/Clojure subreddit</a></li></ul><h2 id="conferences">Conferences</h2><p>In no particular order:</p><ul><li><a href="http://clojure-conj.org/">Clojure/conj</a>, aka "the Conj"</li><li><a href="http://euroclojure.com/">EuroClojure</a></li><li><a href="http://clojurewest.org/">Clojure/West</a></li><li><a href="https://thestrangeloop.com/">StrangeLoop</a> (not about Clojure but often has strong Clojure community presence)</li><li><a href="http://lambdajam.com/">Lambda Jam</a> (also not about Clojure but has strong Clojure community presence)</li></ul><h2 id="email-newsletters">Email Newsletters</h2><ul><li><a href="http://www.clojuregazette.com/">Clojure Gazette</a></li><li><a href="http://defnewsletter.com/">(def newsletter)</a></li></ul><h2 id="workshops">Workshops</h2><ul><li><a href="http://www.clojurebridge.org/">ClojureBridge</a></li><li><a href="http://lambdanext.eu/">Lambda Next</a></li></ul><h2 id="core-development">Core development</h2><p>See the <a href="http://dev.clojure.org/display/design/Home">Clojure Confluence wiki</a> for full details on
+how core development is handled.</p><p>Coordination of development efforts happen on the development mailing list, on the Confluence wiki,
+and make use of the <a href="http://dev.clojure.org/jira/browse/CLJ">JIRA bug and issue tracker</a>.</p><p>Although Clojure and the contrib libraries all have homes <a href="https://github.com/clojure">at GitHub</a>,
+<strong>pull-requests are not accepted</strong>. All core development happens via JIRA, patches and the Confluence wiki.</p>
+
+    <div id="prev-next">
+        
+        <a href="../maven/index.html">&laquo; How to use Maven to build Clojure projects</a>
+        
+        
+        ||
+        
+        
+        <a href="../user_groups/index.html">Clojure User Groups &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/core_typed/filters/index.html b/clones/clojure-doc.org/articles/ecosystem/core_typed/filters/index.html
new file mode 100644
index 00000000..563a8a0d
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/core_typed/filters/index.html
@@ -0,0 +1,244 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: core.typed - Filters</title>
+    
+
+<meta name="description" content="core.typed includes an implementation of occurrence typing, which helps the type
+checker refine types according to control flow.Occurrence typing helps core.typed infer a very accurate type for this expression
+by recognising the semantics of predicates like symbol? and number?.">
+
+<meta property="og:description" content="core.typed includes an implementation of occurrence typing, which helps the type
+checker refine types according to control flow.Occurrence typing helps core.typed infer a very accurate type for this expression
+by recognising the semantics of predicates like symbol? and number?.">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/core_typed/filters/" />
+<meta property="og:title" content="core.typed - Filters" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/core_typed/filters/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>core.typed - Filters</h2>
+    </div>
+    
+    <p>core.typed includes an implementation of occurrence typing, which helps the type
+checker refine types according to control flow.</p><p>Occurrence typing helps core.typed infer a very accurate type for this expression
+by recognising the semantics of predicates like <code>symbol?</code> and <code>number?</code>.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf (let [a (ann-form 1 Any)]
+                           (cond
+                             (symbol? a) a
+                             (number? a) a)))
+(U clojure.lang.Symbol java.lang.Number nil)
+</code></pre><h2 id="filters">Filters</h2><p>core.typed collects more information than just types for each expression.</p><p>A structure called a filter set is also inferred. A filter set is a collection
+of two filters:</p><ul><li>a filter that is true if the expression is a true value, called the <code>then</code> filter</li><li>a filter that is true if the expression is a false value, called the <code>else</code> filter</li></ul><h3 id="trivial-filters">Trivial Filters</h3><p>There are two trivial filters:</p><ul><li><code>tt</code>, the trivially true filter</li><li><code>ff</code>, the impossible filter</li></ul><p>We can use <code>cf</code> to check the filters of expressions.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf 1)
+[(Value 1) {:then tt, :else ff}]
+</code></pre><p>The second place of the result vector is the filter set inferred for the expression.
+<code>{:then tt, :else ff}</code> reads: the expression could be a true value, but it is impossible
+for it to be a false value. This of course aligns with the semantics of numbers in Clojure.</p><p>False values are never true:</p><pre><code class="clojure">clojure.core.typed=&gt; (cf nil)
+[nil {:then ff, :else tt}]
+</code></pre><h3 id="positive-and-negative-type-filters">Positive and Negative Type Filters</h3><p>Filters can hold information relating bindings to types.</p><p>A positive type filter refines a local binding to be a type.</p><p>This filter says that the local binding <code>a</code> is of type <code>Number</code>.</p><pre><code class="clojure">(is Number a)
+</code></pre><p>A negative type filter refines a local binding to <em>not</em> be a type.</p><p>This filter says that the local binding <code>a</code> is <em>not</em> of type <code>Number</code>.</p><pre><code class="clojure">(! Number a)
+</code></pre><h3 id="latent-filters">Latent Filters</h3><p>Filters almost never need to be written directly in normal code. <em>Latent</em> filters
+however are very useful, and provide the most useful information to core.typed.</p><p>A <em>latent filter set</em> is a filter set attached to a function type. It is latent
+because it is not used directly: instead when a function with a latent filter set
+is called, the filter set is instantiated in a way that makes sense in the current
+context before it is used like a normal filter.</p><h3 id="predicates">Predicates</h3><p>A very common place for a latent filters are in the types for predicates.</p><p>The type for <code>symbol?</code>, is</p><pre><code class="clojure">[Any -&gt; Boolean :filters {:then (is Symbol 0), :else (! Symbol 0)}]
+</code></pre><p>First, notice that latent type predicates can also take an integer as an identifier.
+The <code>0</code> represents the first argument of the function the latent filter set is attached to.</p><p>So the latent <code>then</code> filter <code>(is Symbol 0)</code> says the first argument to <code>symbol?</code> is of type <code>Symbol</code>
+if the whole expression is a true value. To retrieve a non-latent filter, the <code>0</code> is instantiated to
+the appropriate local binding.</p><pre><code>Note: Use `clojure.core.typed/print-filterset` to print the filter set of an expression.
+</code></pre><pre><code class="clojure">clojure.core.typed=&gt; (cf (let [a (ann-form 1 Any)]
+                           (print-filterset "symbol filters"
+                             (symbol? a))))
+"symbol filters"
+{:then (is clojure.lang.Symbol a), :else (! clojure.lang.Symbol a)}
+empty-object
+Flow tt
+boolean
+</code></pre><p>By printing the filter set of <code>(symbol? a)</code> we can see this in work, which
+has a non-latent filter set of <code>{:then (is clojure.lang.Symbol a), :else (! clojure.lang.Symbol a)}</code>.</p><h3 id="paths-and-objects">Paths and Objects</h3><p>TODO</p>
+
+    <div id="prev-next">
+        
+        <a href="../poly_fn/index.html">&laquo; core.typed - Polymorphic Functions</a>
+        
+        
+        ||
+        
+        
+        <a href="../mm_protocol_datatypes/index.html">core.typed - Protocols &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/core_typed/function_types/index.html b/clones/clojure-doc.org/articles/ecosystem/core_typed/function_types/index.html
new file mode 100644
index 00000000..ace7dba7
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/core_typed/function_types/index.html
@@ -0,0 +1,237 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: core.typed - Functions</title>
+    
+
+<meta name="description" content="Common things that are IFns:">
+
+<meta property="og:description" content="Common things that are IFns:">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/core_typed/function_types/" />
+<meta property="og:title" content="core.typed - Functions" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/core_typed/function_types/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>core.typed - Functions</h2>
+    </div>
+    
+    <ul><li>Function types are quite different from Typed Racket
+<ul><li>anything can implement the <code>IFn</code> interface</li><li>In core.typed the <code>Function</code> type is more a special type than the type for lambdas</li></ul></li></ul><p>Common things that are <code>IFn</code>s:</p><pre><code class="clojure">- clojure.lang.Function
+- c.l.Keyword
+  - [Any -&gt; Any]
+- (c.l.PersistentHashMap k v)
+  - (All [x]
+      (Fn [Any -&gt; (U nil v)]
+          [Any x -&gt; (U x v)]))
+- (c.l.PersistentHashSet v)
+  - (All [x]
+      (Fn [Any -&gt; (U nil v)]))
+- c.l.Symbol
+  - [Any -&gt; Any]
+- (Value :a)
+  - (All [x]
+      [Any -&gt; x :filters {:then (is {:a x} 0)}])
+- (Value sym)
+  - (All [x] [Any -&gt; (U nil v)])
+</code></pre><p>The <code>IFn</code> class might be parameterised by a <code>Function</code> type.
+The immediate problem is intersections allows us to have more
+than one function type.</p><p>eg. What function type is this?</p><pre><code class="clojure">(I (Value :a)
+   (All [x]
+     [Any -&gt; x :filters {:then (is {:a x} 0)}])
+</code></pre><p>Even <code>(Value :a)</code> inherits two function types:</p><ul><li>that for c.l.Keyword</li><li>that for <code>(Value :a)</code></li></ul><p><code>(Value :a) &lt;: (IFn x)</code> infers <code>x</code> to be:</p><pre><code class="clojure">(I [Any -&gt; Any]
+   (All [x]
+     [Any -&gt; x :filters {:then (is {:a x} 0)}])
+</code></pre><p>The second member of the intersection is more specific,
+thus can be simplified to:</p><pre><code class="clojure">(All [x]
+  [Any -&gt; x :filters {:then (is {:a x} 0)}])
+</code></pre><p>Does this work in general? As long as there is a subtyping relationship
+between the possible <code>Function</code> types, we can infer the most useful
+one.</p>
+
+    <div id="prev-next">
+        
+        <a href="../loops/index.html">&laquo; core.typed - Looping constructs</a>
+        
+        
+        ||
+        
+        
+        <a href="../limitations/index.html">core.typed - Limitations &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/core_typed/home/index.html b/clones/clojure-doc.org/articles/ecosystem/core_typed/home/index.html
new file mode 100644
index 00000000..0916cd60
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/core_typed/home/index.html
@@ -0,0 +1,207 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: core.typed - User Documentation Home</title>
+    
+
+<meta name="description" content="core.typed is an optional type system for Clojure.Quickstart">
+
+<meta property="og:description" content="core.typed is an optional type system for Clojure.Quickstart">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/core_typed/home/" />
+<meta property="og:title" content="core.typed - User Documentation Home" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/core_typed/home/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>core.typed - User Documentation Home</h2>
+    </div>
+    
+    <p>core.typed is an optional type system for Clojure.</p><h2 id="quickstart">Quickstart</h2><p><code>(clojure.core.typed/ann v t)</code> gives var <code>v</code> the static type <code>t</code>.</p><p><code>(clojure.core.typed/ann-form f t)</code> ensures form <code>f</code> is of the static type <code>t</code>.</p><p><code>(clojure.core.typed/check-ns)</code> type checks the current namespace.</p><p><code>(clojure.core.typed/cf t)</code> type checks the form <code>t</code>.</p><p>See the <a href="../quick_guide.html">Quick Guide</a>.</p><h2 id="rationale"><a href="../rationale/index.html">Rationale</a></h2><p>Why core.typed exists, what can it do for you?</p><h2 id="getting-started-guide">Getting Started Guide</h2><p>If you are new to core.typed, gradual type systems, or even types in general, and want to learn how
+core.typed can help verify your programs, start here.</p><h3 id="introduction-and-motivation"><a href="../start/introduction_and_motivation/index.html">Introduction and Motivation</a></h3><p>We discuss some theory and design goals of core.typed.</p><h3 id="annotations"><a href="../start/annotations/index.html">Annotations</a></h3><p>Where and how to annotate your code to help core.typed check your code.</p><h3 id="types"><a href="../types/index.html">Types</a></h3><p>Syntax and descriptions of core.typed types.</p><h3 id="polymorphic-functions-bounds-and-higher-kinded-variables"><a href="../poly_fn/index.html">Polymorphic Functions, Bounds and Higher-kinded Variables</a></h3><h3 id="filters"><a href="../filters/index.html">Filters</a></h3><p>An overview of filters for occurrence typing.</p><h3 id="datatypes-and-protocols"><a href="../mm_protocol_datatypes/index.html">Datatypes and Protocols</a></h3><p>Typing definitions and usages of Clojure datatypes and protocols.</p><h3 id="looping-constructs"><a href="../loops/index.html">Looping constructs</a></h3><p>core.typed provides several wrapper macros for common looping constructs.</p><h3 id="dotted-functions">Dotted Functions</h3><h3 id="java-classes-arrays-and-interop">Java Classes, Arrays and Interop</h3><h2 id="miscellaneous-tutorials">Miscellaneous Tutorials</h2><h3 id="hole-driven-development"><a href="https://github.com/clojure/core.typed/blob/master/src/test/clojure/clojure/core/typed/test/hole.clj">Hole-Driven Development</a></h3><p>A fun diversion playing with holes.</p><ul><li>Requires some knowledge of Haskell.</li></ul><h2 id="examples">Examples</h2><h3 id="irc-bot"><a href="https://github.com/frenchy64/Parjer">IRC Bot</a></h3><h2 id="limitations---known-issues"><a href="../limitations/index.html">Limitations</a> - Known issues</h2><h2 id="documentation-contributors">Documentation Contributors</h2><p>Ambrose Bonnaire-Sergeant (@ambrosebs)</p><p>Copyright 2013, Ambrose Bonnaire-Sergeant</p>
+
+    <div id="prev-next">
+        
+        <a href="../../java_jdbc/reusing_connections.html">&laquo; java.jdbc - How to reuse database connections</a>
+        
+        
+        ||
+        
+        
+        <a href="../user_documentation/index.html">core.typed - User Documentation &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/core_typed/limitations/index.html b/clones/clojure-doc.org/articles/ecosystem/core_typed/limitations/index.html
new file mode 100644
index 00000000..0e7a843f
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/core_typed/limitations/index.html
@@ -0,0 +1,222 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: core.typed - Limitations</title>
+    
+
+<meta name="description" content="Namespace managementTyped dependencies NYI.">
+
+<meta property="og:description" content="Namespace managementTyped dependencies NYI.">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/core_typed/limitations/" />
+<meta property="og:title" content="core.typed - Limitations" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/core_typed/limitations/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>core.typed - Limitations</h2>
+    </div>
+    
+    <h2 id="namespace-management">Namespace management</h2><p>Typed dependencies NYI.</p><h2 id="destructuring">Destructuring</h2><p>Only map destructuring <em>without</em> options is supported.</p><p>Other forms of destructuring require equality filters.</p><h2 id="shadowing-bindings">Shadowing bindings</h2><p>If an argument is shadowed and the shadowed binding is referenced
+in filters or object then the shadow is indistinguishable from the parameter
+and parameter will be incorrectly abstracted.</p><p>eg.</p><pre><code class="clojure">(fn [a]
+  (if (= a 1)
+    (let [a 'foo] ; here this shadows the argument, impossible to recover filters
+      a)          ; in fact any new filters about a will be incorrectly assumed to be the argument
+      false))
+</code></pre><p>(See <code>abstract-result</code> in <code>typed/test.clj</code>)</p><h2 id="dotted-functions">Dotted Functions</h2><p>A dotted function contains a dotted variable in its function type.</p><p>eg. map's type:
+<code>(All [c a b ...] [[a b ... b -&gt; c] (U nil (Seqable a)) (U nil (Seqable b)) ... b -&gt; (Seqable c)]))</code></p><p>We can't currently check the definitions of functions with dotted rest arguments.</p><h2 id="rest-arguments">Rest Arguments</h2><p>Currently cannot check the definition of functions with rest arguments,
+but usage checking should work.</p><h2 id="using-filter">Using <code>filter</code></h2><p>Not everything can be inferred from a <code>filter</code>. A common example is
+<code>(filter identity coll)</code> does not work. The reason is <code>identity</code> only
+gives negative information when its result is true: that the argument is <em>not</em><code>(U nil false)</code>.</p><p>This idiom must be converted to this syntax <code>(fn [a] a)</code> and then annotated with
+positive propositions.</p><pre><code class="clojure">;eg.
+
+(filter (ann-form (fn [a] a)
+                  [(U nil Number) -&gt; (U nil Number) :filters {:then (is Number 0)}])
+        [1 nil 2])
+; :- (Seqable Number)
+</code></pre><p>Positive information infers just fine, like <code>(filter number? coll)</code>.
+The above idiom is useful when you are filtering something like a <code>(Seqable (U nil x))</code> and there is no
+predicate to test for <code>x</code>, so you can only test if something isn't <code>nil</code>.</p>
+
+    <div id="prev-next">
+        
+        <a href="../function_types/index.html">&laquo; core.typed - Functions</a>
+        
+        
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/core_typed/loops/index.html b/clones/clojure-doc.org/articles/ecosystem/core_typed/loops/index.html
new file mode 100644
index 00000000..bd62c3a4
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/core_typed/loops/index.html
@@ -0,0 +1,223 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: core.typed - Looping constructs</title>
+    
+
+<meta name="description" content="Due to limitations in core.typed&#39;s inference, we require using &quot;typed&quot; versions
+of several core forms.loop">
+
+<meta property="og:description" content="Due to limitations in core.typed&#39;s inference, we require using &quot;typed&quot; versions
+of several core forms.loop">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/core_typed/loops/" />
+<meta property="og:title" content="core.typed - Looping constructs" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/core_typed/loops/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>core.typed - Looping constructs</h2>
+    </div>
+    
+    <p>Due to limitations in core.typed's inference, we require using "typed" versions
+of several core forms.</p><h1 id="loop">loop</h1><p>Usages of <code>loop</code> should be replaced with <code>clojure.core.typed/loop&gt;</code>.</p><p>The syntax is identical except each loop variable requires a type annotation.</p><pre><code class="clojure">(loop&gt; [[a :- Number] 1
+        [b :- (U nil Number)] nil]
+  ...)
+</code></pre><h1 id="named-fns">Named fn's</h1><p>Named <code>fn</code>'s require full annotation for accurate recursive calls inside the <code>fn</code> body.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf (ann-form (fn a [n] (+ (a 1) n))
+                                   [Number -&gt; Number]))
+(Fn [java.lang.Number -&gt; java.lang.Number])
+</code></pre><h1 id="for">for</h1><p>Use <code>clojure.core.typed/for&gt;</code> instead of <code>for</code>.</p><p><code>for&gt;</code> requires annotations for the return type of the body
+of the for, and the left hand side of each binding form.</p><pre><code class="clojure">(for&gt; :- Number
+      [[a :- (U nil AnyInteger)] [1 nil 2 3]
+       :when a]
+  (inc a))
+</code></pre><h1 id="doseq">doseq</h1><p>Use <code>clojure.core.typed/doseq&gt;</code> instead of <code>doseq</code>.</p><p><code>doseq&gt;</code> requires annotations for the left hand side of each binding form.</p><pre><code class="clojure">(doseq&gt; [[a :- (U nil AnyInteger)] [1 nil 2 3]
+         :when a]
+   (inc a))
+</code></pre>
+
+    <div id="prev-next">
+        
+        <a href="../mm_protocol_datatypes/index.html">&laquo; core.typed - Protocols</a>
+        
+        
+        ||
+        
+        
+        <a href="../function_types/index.html">core.typed - Functions &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/core_typed/mm_protocol_datatypes/index.html b/clones/clojure-doc.org/articles/ecosystem/core_typed/mm_protocol_datatypes/index.html
new file mode 100644
index 00000000..5f0a900f
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/core_typed/mm_protocol_datatypes/index.html
@@ -0,0 +1,219 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: core.typed - Protocols</title>
+    
+
+<meta name="description" content="Annotating Protocolsclojure.core.typed/ann-protocol annotates protocols.">
+
+<meta property="og:description" content="Annotating Protocolsclojure.core.typed/ann-protocol annotates protocols.">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/core_typed/mm_protocol_datatypes/" />
+<meta property="og:title" content="core.typed - Protocols" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/core_typed/mm_protocol_datatypes/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>core.typed - Protocols</h2>
+    </div>
+    
+    <h2 id="annotating-protocols">Annotating Protocols</h2><p><code>clojure.core.typed/ann-protocol</code> annotates protocols.</p><p>Takes a name and a optionally a :methods keyword argument mapping
+method names to expected types.</p><p>Protocol definitions should use <code>clojure.core.typed/defprotocol&gt;</code> (identical syntax to <code>defprotocol</code>).</p><pre><code class="clojure">(ann-protocol IUnifyWithLVar
+              unify-with-lvar [Term LVar ISubstitutions -&gt; (U ISubstitutions Fail)])
+
+(defprotocol&gt; IUnifyWithLVar
+  (unify-with-lvar [v u s]))
+</code></pre><p>Each protocol method argument (including the first) is explicit in the type annotation.
+Often, the the first argument (aka. <code>this</code>) will just be the protocol, but in some cases
+it is convenient to add more general types.</p><h2 id="annotating-datatypes">Annotating datatypes</h2><p><code>clojure.core.typed/ann-datatype</code> annotates datatypes.</p><p>Takes a name and a vector of fieldname/type type entries.</p><pre><code class="clojure">(ann-datatype Pair [lhs :- Term
+                    rhs :- Term])
+
+(deftype Pair [lhs rhs]
+  ...)
+</code></pre><p>Each protocol extended in <code>deftype</code> must have an annotated expected type with <code>ann-protocol</code>.</p><p>The types for Java interface method are inferred from their corresponding Java type.</p>
+
+    <div id="prev-next">
+        
+        <a href="../filters/index.html">&laquo; core.typed - Filters</a>
+        
+        
+        ||
+        
+        
+        <a href="../loops/index.html">core.typed - Looping constructs &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/core_typed/poly_fn/index.html b/clones/clojure-doc.org/articles/ecosystem/core_typed/poly_fn/index.html
new file mode 100644
index 00000000..2ac82b58
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/core_typed/poly_fn/index.html
@@ -0,0 +1,234 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: core.typed - Polymorphic Functions</title>
+    
+
+<meta name="description" content="core.typed supports polymorphic function types. They allow us to specify
+function types which are both general and accurate.All">
+
+<meta property="og:description" content="core.typed supports polymorphic function types. They allow us to specify
+function types which are both general and accurate.All">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/core_typed/poly_fn/" />
+<meta property="og:title" content="core.typed - Polymorphic Functions" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/core_typed/poly_fn/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>core.typed - Polymorphic Functions</h2>
+    </div>
+    
+    <p>core.typed supports polymorphic function types. They allow us to specify
+function types which are both general and accurate.</p><h1 id="all">All</h1><p>The primitive <code>All</code> constructor creates a polymorphic binder and scopes
+type variables in a type.</p><p>The identity function has a simple polymorphic type:</p><pre><code class="clojure">(All [x]
+  [x -&gt; x])
+</code></pre><p>Read: for all types <code>x</code>, a function that takes an <code>x</code> and returns an <code>x</code>.</p><p>Polymorphic types are introduced with annotations, but where are they eliminated?
+We use local type inference to infer type variable types based on how they are used.</p><pre><code class="clojure">(identity :a)
+</code></pre><p>In the above example, we infer <code>x</code> to be <code>Keyword</code>, and instantiate the polymorphic
+type as <code>[Keyword -&gt; Keyword]</code>.</p><h2 id="bounds">Bounds</h2><p>Type variables support upper and lower type bounds, which default to <code>Any</code> and <code>Nothing</code>
+respectively.</p><p>Equivalently, the type:</p><pre><code class="clojure">(All [x] ...)
+</code></pre><p>is shorthand for:</p><pre><code class="clojure">(All [[x :&gt; Nothing :&lt; Any]] ...)
+</code></pre><p>We use bounds to ensure a type variable can only be instantiated to a particular type.</p><p>The type of an identity function that only accepts <code>Number</code>s can be written:</p><pre><code class="clojure">(All [[x :&lt; Number]]
+  [x -&gt; x])
+</code></pre><p>Bounds do not seem as useful in core.typed as languages like Java or Scala.
+Often, combinations of ordered function intersections and unions are more useful.</p><p>Bounds are also recursive: a bound can refer to the variable it's bounding.
+Type variables to the left of the type variable being bounded in the same binder are in scope in a bound.</p><h2 id="higher-kinded-variables">Higher-kinded variables</h2><p>Note: Experimental feature</p><p>A type variable can be of a higher-kind.</p><pre><code class="clojure">(def-alias AnyMonad
+  (TFn [[m :kind (TFn [[x :variance :covariant]] Any)]]
+    '{:m-bind (All [x y]
+                [(m x) [x -&gt; (m y)] -&gt; (m y)])
+      :m-result (All [x]
+                  [x -&gt; (m x)])
+      :m-zero (U (All [x] (m x)) Undefined)
+      :m-plus (U (All [x]
+                   [(m x) * -&gt; (m x)])
+                 Undefined)}))
+</code></pre><p>In this type, <code>x</code> is a type function taking a type and returning a type.
+For those familiar with Haskell, <code>x</code> is of kind <code>* -&gt; *</code>.</p><p>The type function is also covariant, which further ensures <code>x</code> is instantiated
+to a covariant type function.</p>
+
+    <div id="prev-next">
+        
+        <a href="../start/annotations/index.html">&laquo; core.typed - Annotations</a>
+        
+        
+        ||
+        
+        
+        <a href="../filters/index.html">core.typed - Filters &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/core_typed/quick_guide.html b/clones/clojure-doc.org/articles/ecosystem/core_typed/quick_guide.html
new file mode 100644
index 00000000..31d4dd6d
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/core_typed/quick_guide.html
@@ -0,0 +1,241 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: core.typed - Quick Guide</title>
+    
+
+<meta name="description" content="Design choicesAll vars must have annotated static types">
+
+<meta property="og:description" content="Design choicesAll vars must have annotated static types">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/core_typed/quick_guide/" />
+<meta property="og:title" content="core.typed - Quick Guide" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/core_typed/quick_guide/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>core.typed - Quick Guide</h2>
+    </div>
+    
+    <h2 id="design-choices">Design choices</h2><h3 id="all-vars-must-have-annotated-static-types">All vars must have annotated static types</h3><p>Use <code>clojure.core.typed/ann</code> to assign types to vars</p><p>eg. Assign <code>my-fn</code> in the current namespace the type <code>[Any -&gt; Any]</code> (a function of one argument).</p><pre><code class="clojure">(ann my-fn [Any -&gt; Any])
+</code></pre><h3 id="type-checking-is-separate-to-compilation-and-must-be-explicitly-run">Type checking is separate to compilation and must be explicitly run</h3><p>Use <code>clojure.core.typed/check-ns</code> to type check the current namespace.
+This can be done at the REPL.</p><p>Note: Global annotations like <code>ann</code> are only valid when found in a namespace currently being
+checked with <code>check-ns</code>, or wrapped in a <code>cf</code>. A raw <code>ann</code> in a REPL has <em>no effect</em>.
+Global annotations should be top-level forms or inside a (possibly nested) top-level <code>do</code>.</p><h3 id="all-function-arguments-need-to-be-annotated-or-default-to-any">All function arguments need to be annotated, or default to <code>Any</code></h3><p>Use <code>clojure.core.typed/ann-form</code> to annotate a function.</p><p>eg.</p><pre><code class="clojure">(ann-form #(+ 1 %) [Number -&gt; Number])
+</code></pre><h3 id="everything-is-type-checked-but-coretyped-can-ignore-certain-expressions">Everything is type checked, but core.typed can ignore certain expressions</h3><p>core.typed is early in development and there are Clojure idioms it cannot
+currently type check. Wrap top-level expressions in <code>clojure.core.typed/tc-ignore</code>
+to ignore them.</p><p>Suggestion: If porting a namespace to core.typed, initially use <code>tc-ignore</code> liberally to ignore problematic
+code while determining the types for expressions. Once most vars are annotated, revisit
+these sites to determine the issue.</p><h2 id="debugging">Debugging</h2><h3 id="print-env-is-your-friend"><code>print-env</code> is your friend</h3><p><code>clojure.core.typed/print-env</code> takes a debug string and prints the local type environment at the current expression.</p><h3 id="use-cf-to-experiment-at-the-repl">Use <code>cf</code> to experiment at the REPL</h3><p><code>clojure.core.typed/cf</code> takes an expression and optionally an expected type and type checks the expression,
+returning its inferred type.</p><p>eg.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf (fn [a]
+                           {:pre [(number? a)]}
+                           (inc a)))
+[(Fn [Any -&gt; java.lang.Number]) {:then tt, :else ff}]
+</code></pre><p>If <code>cf</code> returns a vector of results, the first element is the static type.</p><h3 id="use-ann-form-to-ensure-expressions-are-particular-types">Use <code>ann-form</code> to ensure expressions are particular types</h3><p><code>clojure.core.typed/ann-form</code> can be used as a kind of static <code>assert</code>.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf (let [a (+ 1 2)
+                               _ (ann-form a clojure.lang.Symbol)]
+                           a))
+#&lt;AssertionError java.lang.AssertionError: Assert failed: 6: Local binding a expected type clojure.lang.Symbol, but actual type clojure.core.typed/AnyInteger
+(or (not expected) (subtype? t (ret-t expected)))&gt;
+</code></pre><h3 id="coretyped-understands-assertions-and-conditionals">core.typed understands assertions and conditionals</h3><p>Normal "untyped"  Clojure code often use type predicates combined with assertions or conditionals to direct control flow.
+core.typed uses them to gain type information about the current environment.</p><pre><code class="clojure">(let [a (ann-form 1 Number)
+      _ (print-env "before assert")
+      _ (assert (integer? a))
+      _ (print-env "after assert")])
+; "before assert"{:env {a java.lang.Number},
+;                 :props ()}
+; "after assert"{:env {_28338 nil, _ nil, a clojure.core.typed/AnyInteger},
+;                :props ((is clojure.core.typed/AnyInteger a) (when (! (U false nil) _) ff) (when (! (U false nil) _) ff) (when (! (U false nil) _28338) ff))}
+</code></pre><p>The <code>:env</code> map is maps local bindings to their current types.
+<code>:props</code> is a list of propositions currently in scope (can usually be ignored, mostly useful for internal debugging purposes).</p><p>Notice the local binding <code>a</code> has a more accurate type after the <code>assert</code> expression.</p><p>Note: core.typed operates on a hygienic AST, so shadowed bindings will have gensymed names.</p><h2 id="typing-core-constructs">Typing core constructs</h2><h3 id="coretyped-understands-datatype-definitions">core.typed understands datatype definitions</h3><p>Use <code>clojure.core.typed/ann-datatype</code> to give a datatype an expected type.</p><h3 id="use-defprotocol-instead-of-defprotocol">Use <code>defprotocol&gt;</code> instead of <code>defprotocol</code></h3><p>core.typed currently cannot understand protocol definitions. Simply replace references to <code>defprotocol</code>
+with <code>clojure.core.typed/defprotocol&gt;</code></p><h3 id="coretyped-understands-simple-multimethods">core.typed understands simple multimethods</h3><p>core.typed can infer accurate types for multimethods that dispatch on simple things like keywords or <code>class</code>.
+Just assign an expected type to the multimethod's var with <code>ann</code> and core.typed will use it to infer accurate
+types in each <code>defmethod</code>.</p><p>If in doubt whether a multimethod is being inferred properly, use the debugging techniques to double check.
+core.typed may not throw an exception if the dispatch is too complex to type check currently.</p><h3 id="macros--macro-definitions">Macros &amp; Macro Definitions</h3><p>Macro definitions are ignored. The type checker operates on the macroexpanded form from
+the Compiler's analysis phase.</p><h2 id="type-syntax">Type Syntax</h2><h3 id="types-use-the-current-global-scope-of-the-namespace">Types use the current global scope of the namespace</h3><p>Simply adding an <code>(:import ...)</code> to the <code>ns</code> declaration as usual in Clojure brings the class name into scope.
+Otherwise, refers to classes via their fully qualified name.</p>
+
+    <div id="prev-next">
+        
+        <a href="rationale/index.html">&laquo; core.typed - Rationale</a>
+        
+        
+        ||
+        
+        
+        <a href="start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/core_typed/quick_guide/index.html b/clones/clojure-doc.org/articles/ecosystem/core_typed/quick_guide/index.html
new file mode 100644
index 00000000..48f53863
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/core_typed/quick_guide/index.html
@@ -0,0 +1,241 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: core.typed - Quick Guide</title>
+    
+
+<meta name="description" content="Design choicesAll vars must have annotated static types">
+
+<meta property="og:description" content="Design choicesAll vars must have annotated static types">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/core_typed/quick_guide/" />
+<meta property="og:title" content="core.typed - Quick Guide" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/core_typed/quick_guide/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>core.typed - Quick Guide</h2>
+    </div>
+    
+    <h2 id="design-choices">Design choices</h2><h3 id="all-vars-must-have-annotated-static-types">All vars must have annotated static types</h3><p>Use <code>clojure.core.typed/ann</code> to assign types to vars</p><p>eg. Assign <code>my-fn</code> in the current namespace the type <code>[Any -&gt; Any]</code> (a function of one argument).</p><pre><code class="clojure">(ann my-fn [Any -&gt; Any])
+</code></pre><h3 id="type-checking-is-separate-to-compilation-and-must-be-explicitly-run">Type checking is separate to compilation and must be explicitly run</h3><p>Use <code>clojure.core.typed/check-ns</code> to type check the current namespace.
+This can be done at the REPL.</p><p>Note: Global annotations like <code>ann</code> are only valid when found in a namespace currently being
+checked with <code>check-ns</code>, or wrapped in a <code>cf</code>. A raw <code>ann</code> in a REPL has <em>no effect</em>.
+Global annotations should be top-level forms or inside a (possibly nested) top-level <code>do</code>.</p><h3 id="all-function-arguments-need-to-be-annotated-or-default-to-any">All function arguments need to be annotated, or default to <code>Any</code></h3><p>Use <code>clojure.core.typed/ann-form</code> to annotate a function.</p><p>eg.</p><pre><code class="clojure">(ann-form #(+ 1 %) [Number -&gt; Number])
+</code></pre><h3 id="everything-is-type-checked-but-coretyped-can-ignore-certain-expressions">Everything is type checked, but core.typed can ignore certain expressions</h3><p>core.typed is early in development and there are Clojure idioms it cannot
+currently type check. Wrap top-level expressions in <code>clojure.core.typed/tc-ignore</code>
+to ignore them.</p><p>Suggestion: If porting a namespace to core.typed, initially use <code>tc-ignore</code> liberally to ignore problematic
+code while determining the types for expressions. Once most vars are annotated, revisit
+these sites to determine the issue.</p><h2 id="debugging">Debugging</h2><h3 id="print-env-is-your-friend"><code>print-env</code> is your friend</h3><p><code>clojure.core.typed/print-env</code> takes a debug string and prints the local type environment at the current expression.</p><h3 id="use-cf-to-experiment-at-the-repl">Use <code>cf</code> to experiment at the REPL</h3><p><code>clojure.core.typed/cf</code> takes an expression and optionally an expected type and type checks the expression,
+returning its inferred type.</p><p>eg.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf (fn [a]
+                           {:pre [(number? a)]}
+                           (inc a)))
+[(Fn [Any -&gt; java.lang.Number]) {:then tt, :else ff}]
+</code></pre><p>If <code>cf</code> returns a vector of results, the first element is the static type.</p><h3 id="use-ann-form-to-ensure-expressions-are-particular-types">Use <code>ann-form</code> to ensure expressions are particular types</h3><p><code>clojure.core.typed/ann-form</code> can be used as a kind of static <code>assert</code>.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf (let [a (+ 1 2)
+                               _ (ann-form a clojure.lang.Symbol)]
+                           a))
+#&lt;AssertionError java.lang.AssertionError: Assert failed: 6: Local binding a expected type clojure.lang.Symbol, but actual type clojure.core.typed/AnyInteger
+(or (not expected) (subtype? t (ret-t expected)))&gt;
+</code></pre><h3 id="coretyped-understands-assertions-and-conditionals">core.typed understands assertions and conditionals</h3><p>Normal "untyped"  Clojure code often use type predicates combined with assertions or conditionals to direct control flow.
+core.typed uses them to gain type information about the current environment.</p><pre><code class="clojure">(let [a (ann-form 1 Number)
+      _ (print-env "before assert")
+      _ (assert (integer? a))
+      _ (print-env "after assert")])
+; "before assert"{:env {a java.lang.Number},
+;                 :props ()}
+; "after assert"{:env {_28338 nil, _ nil, a clojure.core.typed/AnyInteger},
+;                :props ((is clojure.core.typed/AnyInteger a) (when (! (U false nil) _) ff) (when (! (U false nil) _) ff) (when (! (U false nil) _28338) ff))}
+</code></pre><p>The <code>:env</code> map is maps local bindings to their current types.
+<code>:props</code> is a list of propositions currently in scope (can usually be ignored, mostly useful for internal debugging purposes).</p><p>Notice the local binding <code>a</code> has a more accurate type after the <code>assert</code> expression.</p><p>Note: core.typed operates on a hygienic AST, so shadowed bindings will have gensymed names.</p><h2 id="typing-core-constructs">Typing core constructs</h2><h3 id="coretyped-understands-datatype-definitions">core.typed understands datatype definitions</h3><p>Use <code>clojure.core.typed/ann-datatype</code> to give a datatype an expected type.</p><h3 id="use-defprotocol-instead-of-defprotocol">Use <code>defprotocol&gt;</code> instead of <code>defprotocol</code></h3><p>core.typed currently cannot understand protocol definitions. Simply replace references to <code>defprotocol</code>
+with <code>clojure.core.typed/defprotocol&gt;</code></p><h3 id="coretyped-understands-simple-multimethods">core.typed understands simple multimethods</h3><p>core.typed can infer accurate types for multimethods that dispatch on simple things like keywords or <code>class</code>.
+Just assign an expected type to the multimethod's var with <code>ann</code> and core.typed will use it to infer accurate
+types in each <code>defmethod</code>.</p><p>If in doubt whether a multimethod is being inferred properly, use the debugging techniques to double check.
+core.typed may not throw an exception if the dispatch is too complex to type check currently.</p><h3 id="macros--macro-definitions">Macros &amp; Macro Definitions</h3><p>Macro definitions are ignored. The type checker operates on the macroexpanded form from
+the Compiler's analysis phase.</p><h2 id="type-syntax">Type Syntax</h2><h3 id="types-use-the-current-global-scope-of-the-namespace">Types use the current global scope of the namespace</h3><p>Simply adding an <code>(:import ...)</code> to the <code>ns</code> declaration as usual in Clojure brings the class name into scope.
+Otherwise, refers to classes via their fully qualified name.</p>
+
+    <div id="prev-next">
+        
+        <a href="../rationale/index.html">&laquo; core.typed - Rationale</a>
+        
+        
+        ||
+        
+        
+        <a href="../start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/core_typed/rationale/index.html b/clones/clojure-doc.org/articles/ecosystem/core_typed/rationale/index.html
new file mode 100644
index 00000000..99962bb5
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/core_typed/rationale/index.html
@@ -0,0 +1,227 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: core.typed - Rationale</title>
+    
+
+<meta name="description" content="Static typing has well known benefits. For example, statically typed languages catch many common
+programming errors at the earliest time possible: compile time.
+Types also serve as an excellent form of (machine checkable) documentation that
+almost always augment existing hand-written documentation.Languages without static type checking (dynamically typed) bring other benefits.
+Without the strict rigidity of mandatory static typing, they can provide more flexible and forgiving
+idioms that can help in rapid prototyping.
+Often the benefits of static type checking are desired as the program grows.">
+
+<meta property="og:description" content="Static typing has well known benefits. For example, statically typed languages catch many common
+programming errors at the earliest time possible: compile time.
+Types also serve as an excellent form of (machine checkable) documentation that
+almost always augment existing hand-written documentation.Languages without static type checking (dynamically typed) bring other benefits.
+Without the strict rigidity of mandatory static typing, they can provide more flexible and forgiving
+idioms that can help in rapid prototyping.
+Often the benefits of static type checking are desired as the program grows.">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/core_typed/rationale/" />
+<meta property="og:title" content="core.typed - Rationale" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/core_typed/rationale/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>core.typed - Rationale</h2>
+    </div>
+    
+    <p>Static typing has well known benefits. For example, statically typed languages catch many common
+programming errors at the earliest time possible: compile time.
+Types also serve as an excellent form of (machine checkable) documentation that
+almost always augment existing hand-written documentation.</p><p>Languages without static type checking (dynamically typed) bring other benefits.
+Without the strict rigidity of mandatory static typing, they can provide more flexible and forgiving
+idioms that can help in rapid prototyping.
+Often the benefits of static type checking are desired as the program grows.</p><p>This work adds static type checking (and some of its benefits) to Clojure, a dynamically typed language,
+while still preserving idioms that characterise the language.
+It allows static and dynamically typed code to be mixed so the programmer can use whichever
+is more appropriate.</p><p>(For a detailed treatment, see my Honours Dissertation, <a href="https://github.com/downloads/frenchy64/papers/ambrose-honours.pdf">A Practical Optional Type System for Clojure</a>)</p>
+
+    <div id="prev-next">
+        
+        <a href="../user_documentation/index.html">&laquo; core.typed - User Documentation</a>
+        
+        
+        ||
+        
+        
+        <a href="../quick_guide.html">core.typed - Quick Guide &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/core_typed/start/annotations/index.html b/clones/clojure-doc.org/articles/ecosystem/core_typed/start/annotations/index.html
new file mode 100644
index 00000000..bc24d88d
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/core_typed/start/annotations/index.html
@@ -0,0 +1,275 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: core.typed - Annotations</title>
+    
+
+<meta name="description" content="core.typed requires a moderate amount of assistance from the user to help infer types.There are two main things that need annotating:">
+
+<meta property="og:description" content="core.typed requires a moderate amount of assistance from the user to help infer types.There are two main things that need annotating:">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/core_typed/start/annotations/" />
+<meta property="og:title" content="core.typed - Annotations" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/core_typed/start/annotations/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>core.typed - Annotations</h2>
+    </div>
+    
+    <p>core.typed requires a moderate amount of assistance from the user to help infer types.</p><p>There are two main things that need annotating:</p><ol><li>All vars must be annotated</li><li>All function parameters must be annotated, or default to <code>Any</code>.</li></ol><p>From the provided annotations, core.typed uses local type inference to infer
+the types for local bindings, interop calls, and other expressions, mostly
+without further assistance.</p><h2 id="vars">Vars</h2><p>When core.typed finds a var reference, <code>def</code>, <code>binding</code>, or some other var-related construct
+that relys on the derefereced value of a var, it requires an expected type.</p><pre><code class="clojure">clojure.core.typed=&gt; (declare abc)
+#'clojure.core.typed/abc
+clojure.core.typed=&gt; (cf abc)
+#&lt;AssertionError java.lang.AssertionError: Assert failed: Untyped var reference: clojure.core.typed/abc
+(contains? (clojure.core/deref *var-annotations*) nsym)&gt;
+</code></pre><h3 id="vars-in-current-namespace">Vars in current namespace</h3><p>Use <code>clojure.core.typed/ann</code> to associate a static type with a var.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf (ann abc Number))
+[clojure.core.typed/abc java.lang.Number]
+clojure.core.typed=&gt; (cf (def abc 1))
+clojure.lang.Var
+clojure.core.typed=&gt; (cf abc)
+java.lang.Number
+</code></pre><p><code>ann</code> qualifies the var in the current namespace if unqualified.</p><h3 id="vars-in-other-namespaces">Vars in other namespaces</h3><p>Sometimes vars from other namespaces need annotation. Just qualify the var as you
+would in the current namespace (aliases are recognised) to associate it with a static type.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf clojure.core/*compile-path*)
+#&lt;AssertionError java.lang.AssertionError: Assert failed: Untyped var reference: clojure.core/*compile-path*
+(contains? (clojure.core/deref *var-annotations*) nsym)&gt;
+clojure.core.typed=&gt; (cf (ann clojure.core/*compile-path* String))
+[clojure.core/*compile-path* java.lang.String]
+clojure.core.typed=&gt; (cf clojure.core/*compile-path*)
+java.lang.String
+</code></pre><h3 id="unchecked-vars">Unchecked Vars</h3><p>We can instruct core.typed to ignore certain var definitions by adding <code>:nocheck</code> metadata
+to <code>ann</code> forms.</p><pre><code class="clojure">(ns typed.nocheck
+  (:require [clojure.core.typed :refer [ann-nocheck ann check-ns]]))
+
+(ann ^:nocheck foo [Number -&gt; Number])
+(defn foo [a]
+  'a)
+
+(ann bar [Number -&gt; Number])
+(defn bar [b]
+  (+ 2 (foo b)))
+</code></pre><h3 id="var-warnings">Var Warnings</h3><p>After type checking has been performed, core.typed warns about vars that have been assigned types
+but have no corresponding checked <code>def</code> form. The <code>def</code> must at least make a binding,
+so it would be a warning if the var was only <code>declare</code>d.</p><pre><code class="clojure">(ns clojure.core.typed.test.nocheck
+  (:require [clojure.core.typed :refer [ann-nocheck ann check-ns]]))
+
+(ann ^:nocheck foo [Number -&gt; Number])
+(defn foo [a]
+  'a)
+
+(ann bar [Number -&gt; Number])
+(defn bar [b]
+  (+ 2 (foo b)))
+
+;(check-ns)
+; ...
+; WARNING: Var clojure.core.typed.test.var-usage/foo used without checking definition
+;=&gt; nil
+</code></pre><h2 id="functions">Functions</h2><p>There are several ways to annotate a function type.</p><h3 id="partial-annotation-with-fn">Partial annotation with <code>fn&gt;</code></h3><p>To annotate just the arguments of a <code>fn</code>, use the <code>fn&gt;</code> wrapper. It is exactly like <code>fn</code>,
+except each argument is wrapped in a vector which includes its static type.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf (fn&gt; [[a :- Number]] (+ a 1)))
+[(Fn [java.lang.Number -&gt; java.lang.Number]) {:then tt, :else ff}]
+</code></pre><p>All the usual destructuring is supported.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf (fn&gt; [[{:keys [a b c]} :- '{:a Number :b Long :c Double}]]
+                           [a b c]))
+[(Fn ['{:a java.lang.Number, :b java.lang.Long, :c java.lang.Double} -&gt; '[java.lang.Number java.lang.Long java.lang.Double]])
+ {:then tt, :else ff}]
+</code></pre><h3 id="full-annotation-with-ann-form">Full annotation with <code>ann-form</code></h3><p>Often it is more useful to provide a full function type as a <code>fn</code>'s annotation. This
+especially works well with Clojure's anonymous function syntax.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf (ann-form #(inc %)
+                                   [Number -&gt; Number]))
+(Fn [java.lang.Number -&gt; java.lang.Number])
+</code></pre><p>This way, you can also assign anonymous functions ordered intersection function types.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf (fn [a]
+                           (cond
+                             (number? a) 1
+                             (symbol? a) 'a))
+                         (Fn [Number -&gt; Number]
+                             [Symbol -&gt; Symbol]))
+(Fn [java.lang.Number -&gt; java.lang.Number]
+    [clojure.lang.Symbol -&gt; clojure.lang.Symbol])
+</code></pre>
+
+    <div id="prev-next">
+        
+        <a href="../../types/index.html">&laquo; core.typed - Types</a>
+        
+        
+        ||
+        
+        
+        <a href="../../poly_fn/index.html">core.typed - Polymorphic Functions &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/core_typed/start/introduction_and_motivation/index.html b/clones/clojure-doc.org/articles/ecosystem/core_typed/start/introduction_and_motivation/index.html
new file mode 100644
index 00000000..52c0d9a8
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/core_typed/start/introduction_and_motivation/index.html
@@ -0,0 +1,237 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: core.typed - Getting Started: Introduction and Motivation</title>
+    
+
+<meta name="description" content="core.typed is an optional type system for Clojure. If you are interesting in how core.typed
+can help you verify your programs as correct, read on.&quot;I use Clojure to avoid types!&quot;">
+
+<meta property="og:description" content="core.typed is an optional type system for Clojure. If you are interesting in how core.typed
+can help you verify your programs as correct, read on.&quot;I use Clojure to avoid types!&quot;">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/core_typed/start/introduction_and_motivation/" />
+<meta property="og:title" content="core.typed - Getting Started: Introduction and Motivation" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/core_typed/start/introduction_and_motivation/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>core.typed - Getting Started: Introduction and Motivation</h2>
+    </div>
+    
+    <p>core.typed is an optional type system for Clojure. If you are interesting in how core.typed
+can help you verify your programs as correct, read on.</p><h2 id="i-use-clojure-to-avoid-types">"I use Clojure to avoid types!"</h2><p>Many programmers use Clojure as relief from popular typed languages such as Java or C#.
+Java's verbosity and redundant type annotations help make the move to Clojure feel liberating
+and enjoyable: so why go back to types?</p><p>core.typed has a different story to tell:</p><ul><li>type checking is optional
+<ul><li>only use the type system where you need it</li></ul></li><li>local type inference is used to infer local bindings
+<ul><li>locals rarely need type annotations</li></ul></li><li>it can type check (mostly) normal Clojure code
+<ul><li>the Clojure you know and love!</li></ul></li></ul><p>If Java has driven you away from types, core.typed could be pleasant surprise.
+It might even become one of your go-to tools for code verification in Clojure.</p><h2 id="what-are-types">What are types?</h2><p>This is a good question, especially in the context of a dynamically-typed (DT) language
+where we don't have "types".</p><p>We use the term "type" to mean static type and "tag" for runtime tags.
+Types only exist at compile time and are used by the static type system to model runtime
+invariants and properties.</p><p>Thinking of compile-time and runtime as distinct phases in terms of types often helps.
+The type system uses types to reason about the runtime behaviour of code, which can
+also include tag invariants.</p><p>There are no types in Clojure, only tags. We can also say that Clojure has exactly one type: <code>Any</code> (subtype of all types).
+The closest equivalent to types we have
+are ad-hoc comments or doc-strings which describe the input/output behaviour
+of functions.</p><p>For example, the <code>number?</code> predicate returns true if its (runtime) argument
+has a tag that is a subtype of <code>java.lang.Number</code>, otherwise false. In core.typed
+we use a type to model these invariants.
+The tag of <code>number?</code> might be <code>IFn</code>, while its type is <code>[Any -&gt; boolean :filters {:then (is Number 0) :else (! Number 0)}]</code>.</p><p>In summary:</p><ul><li>types only exist at compile time</li><li>tags only exist at runtime</li></ul><h2 id="why-types">Why types?</h2><p>Why use types at all? A static type checker gives earlier and often clearer type errors.</p><p>For example, you might observe:</p><ul><li>fewer "Boolean is not an ISeq" errors without line numbers in production</li><li>more "Cannot pass Boolean to second argument of map" with line numbers at compile time in development.</li></ul><p>Types, when coupled with an appropriate doc-string, are excellent machine checkable documentation.
+They never go out of date, and are often invaluable as a quick reminder of what a function does.</p><p>Types are useful when a program grows, especially when there are multiple contributors.
+If a contribution passes the type system, we know that it is type correct (type errors are amongst
+the most common user errors in programming).</p><h2 id="great-types-are-the-answer">Great, types are the answer!</h2><p>Not quite. Types can help verify that a program is basically correct, but not if it does the right thing.
+Use as many verification techniques as you can: core.typed works great coupled with unit testing or
+generative testing.</p><p>Clojure simply is not built with static typing in mind. It is impractical to expect core.typed alone
+to prevent as many user errors as say Haskell's type system: core.typed either needs to choose some
+subset of Clojure optimised for user error prevention, or attempt to check all Clojure code
+while making some compromises (it does the latter).</p><p>This might seem discouraging, but in practice core.typed will catch all type errors in your code.
+The problem is some Clojure idioms are so flexible it is often impossible to distinguish
+between intended and unintended usage.</p><p>A small example: <code>map</code> accepts either <code>nil</code> or a <code>Seqable</code> as a second argument. It is perfectly
+valid to provide an argument that is always <code>nil</code>, but it's probably not what the user intended.</p><p>So for best results, couple core.typed with all the usual testing/verification techniques.</p><h2 id="before-we-begin">Before we begin</h2><p>There are some details to keep in mind when using core.typed before you jump in to use it.</p><p>Read the <a href="../../quick_guide.html">Quick Guide</a>, and keep a copy handy when you follow along the rest of the tutorial.</p>
+
+    <div id="prev-next">
+        
+        <a href="../../quick_guide.html">&laquo; core.typed - Quick Guide</a>
+        
+        
+        ||
+        
+        
+        <a href="../../types/index.html">core.typed - Types &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/core_typed/types/index.html b/clones/clojure-doc.org/articles/ecosystem/core_typed/types/index.html
new file mode 100644
index 00000000..7b80b623
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/core_typed/types/index.html
@@ -0,0 +1,338 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: core.typed - Types</title>
+    
+
+<meta name="description" content="Common typesAny and Nothing">
+
+<meta property="og:description" content="Common typesAny and Nothing">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/core_typed/types/" />
+<meta property="og:title" content="core.typed - Types" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/core_typed/types/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>core.typed - Types</h2>
+    </div>
+    
+    <h2 id="common-types">Common types</h2><h3 id="any-and-nothing">Any and Nothing</h3><p>Every type is a subtype to <code>Any</code>, written <code>x &lt;: Any</code> for all types <code>x</code>. Equivalently, any place that <code>Any</code> is valid,
+any other type can be used. <code>Any</code> is also known as the "Top" type.</p><p>Conversely, there are no types that are subtypes to <code>Nothing</code>. However for all types <code>x</code>
+it holds that <code>Nothing &lt;: x</code>. Put another way, <code>Nothing</code> is a valid type to give use
+in positions expecting any other type. In practice, <code>Nothing</code> is not as useful as <code>Any</code>,
+and is usually used internally to detect dead code and other code properties.</p><h3 id="functions">Functions</h3><p>core.typed has a special function type, which is an <em>ordered intersection</em> of arities.
+It allows us to specify fine grained function invariants.</p><p>Starting simply,</p><pre><code class="clojure">(Fn [Any -&gt; Any])
+</code></pre><p>is a function taking one argument of type <code>Any</code>. <code>[Any -&gt; Any]</code>
+is an equivalent shorthand for single-arity function types.</p><h4 id="multiple-arities">Multiple arities</h4><p>We can specify multiple arities:</p><pre><code class="clojure">(Fn [Any -&gt; Any]
+    [Any Any -&gt; Any])
+</code></pre><p>Here we can call a function of this type with either one or two arguments.
+In this case, the ordered intersection type acts as a simple overloading on arity.</p><p>Finer invariants can be expressed by specifying multiple signatures of the same arity:</p><pre><code class="clojure">(Fn [Symbol -&gt; Number]
+    [Number -&gt; Symbol])
+</code></pre><p>This function returns a <code>Number</code> if passed a <code>Symbol</code>, and returns a <code>Symbol</code> if passed a <code>Number</code>.</p><p>The exact return type for a function application expression involving multiple arities
+is chosen by matching the actual types provided with each arities, top-to-bottom
+(this explains why our functions are "ordered" intersections).
+In this case, each arity is disjoint because no combination of arguments could
+potentially trigger both arities. More concretely, there is no type that is both
+a <code>Symbol</code> and a <code>Number</code>, so at most one arity triggers for any given arguments.</p><p>Overlapping arities hints at the power of ordered intersections.</p><pre><code class="clojure">(Fn [Long -&gt; Symbol]
+    [Number -&gt; Keyword])
+</code></pre><p>This type always returns a <code>Symbol</code> for <code>Long</code> arguments.</p><p>Beware, swapping the arities produces different results!</p><pre><code class="clojure">(Fn [Number -&gt; Keyword]
+    [Long -&gt; Symbol])
+</code></pre><p>The first arity always "wins" because <code>Number</code> is strictly more general than <code>Long</code>.
+Arities are usually ordered from more-specific parameters to less-specific parameters.</p><p>What about arities that have partially overlapping parameters?
+Consider:</p><pre><code class="clojure">(Fn [Long Any -&gt; Keyword]
+    [Any Number -&gt; Symbol])
+</code></pre><p>Calling with <code>Long</code> <code>Long</code> arguments gives <code>Keyword</code>, and <code>Number</code> <code>Long</code> gives <code>Symbol</code>.</p><p>Flipping the arities gives different results:</p><pre><code class="clojure">(Fn [Any Number -&gt; Symbol]
+    [Long Any -&gt; Keyword])
+</code></pre><p>Now <code>Long</code> <code>Long</code> gives <code>Symbol</code>, and <code>Number</code> <code>Long</code> gives <code>Symbol</code>.
+Partially overlapping arities can be tricky and can unexpectedly trigger earlier arities,
+so care must be taken here.</p><p>Finally, a common idiom is to provide a base arity, which has arguments at least as general
+as the ones above it.</p><p>For example, we might want our function of type <code>(Fn [Long -&gt; Symbol] [Number -&gt; Keyword])</code> to handle the case where
+the argument is <em>either</em> a <code>Long</code> or a <code>Number</code>.
+We can express this by using a union (to express a least-upper-bound of <code>Long</code> and <code>Number</code>).</p><pre><code class="clojure">(Fn [Long -&gt; Symbol]
+    [Number -&gt; Keyword]
+    [(U Long Number) -&gt; (U Symbol Keyword)])
+</code></pre><p>Note the result type is sufficiently general to show the result type is either a <code>Symbol</code> or <code>Keyword</code>.</p><h4 id="rest-parameters">Rest parameters</h4><p>Rest parameters are specified using a <code>*</code>.</p><p>eg.</p><pre><code class="clojure">(Fn [Any Number * -&gt; Any])
+</code></pre><p>is a function taking at least one parameter, and any number of parameters after it
+of type <code>Number</code>.</p><h4 id="keyword-parameters">Keyword parameters</h4><p>Keyword parameters are specified using <code>&amp;</code> after the fixed domain.</p><p>eg.</p><pre><code class="clojure">(Fn [Any &amp; {:a Number} -&gt; Any])
+</code></pre><p>is a function that takes a fixed parameter and an optional keyword argument <code>:a</code>, of
+type <code>Number</code>.</p><p>We can also specify mandatory keyword parameters:</p><pre><code class="clojure">(Fn [Any &amp; {} :mandatory {:a Number} -&gt; Any])
+</code></pre><p>is the same function, except the keyword argumetn <code>:a</code> now must be present when calling.</p><p>We can express finer grained invariants by combining keyword types and ordered
+function intersection types:</p><pre><code class="clojure">(Fn [Any &amp; {} :mandatory {:a Number :b Number} -&gt; Number]
+    [Any &amp; {:a Number :b Number} -&gt; Any])
+</code></pre><p>This function type returns a <code>Number</code> if provided both <code>:a</code> and <code>:b</code> parameters,
+otherwise returns <code>Any</code> if some other combination of <code>:a</code> and <code>:b</code> is provided.</p><h3 id="java-classes">Java Classes</h3><p>core.typed reuses Java and clojure.lang.* classes. The normal scoping rules apply in types,
+e.g., use <code>:import</code> to bring classes into scope.</p><p>Note: <code>java.lang.*</code> classes are implicitly in scope in Clojure namespaces.</p><h3 id="numbers-strings-and-other-java-types">Numbers, Strings and other Java types</h3><p>core.typed follows the normal rules that apply to Clojure code.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf 1 Long)
+java.lang.Long
+clojure.core.typed=&gt; (cf 1.1 Double)
+java.lang.Double
+clojure.core.typed=&gt; (cf "a" String)
+java.lang.String
+clojure.core.typed=&gt; (cf \a Character)
+java.lang.Character
+</code></pre><h3 id="symbols-and-keywords">Symbols and Keywords</h3><p>Symbols and Keywords are instances of their corresponding clojure.lang classes.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf 'a clojure.lang.Symbol)
+clojure.lang.Symbol
+clojure.core.typed=&gt; (cf :a clojure.lang.Keyword)
+clojure.lang.Keyword
+</code></pre><h3 id="seqables">Seqables</h3><p>Seqables extend <code>(Seqable a)</code>, which is covariant in its argument.
+Types that extend <code>(Seqable a</code>) are capable of creating a sequence
+(aka. an <code>(ISeq a)</code>)  representation of itself via functions like <code>seq</code>.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf {'a 2 'b 3} (Seqable (IMapEntry Symbol Number)))
+(clojure.lang.Seqable (clojure.lang.IMapEntry clojure.lang.Symbol java.lang.Number))
+clojure.core.typed=&gt; (cf [1 2 3] (Seqable Number))
+(clojure.lang.Seqable java.lang.Number)
+clojure.core.typed=&gt; (cf '#{a b c} (Seqable Symbol))
+(clojure.lang.Seqable clojure.lang.Symbol)
+</code></pre><h3 id="seqs">Seqs</h3><p>Seqs extend <code>(ISeq a)</code>, which is covariant in its argument.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf (seq [1 2]) (ISeq Number))
+(clojure.lang.ISeq java.lang.Number)
+</code></pre><h3 id="lists">Lists</h3><p>Lists extend <code>(IPersistentList a)</code>, which is covariant in its argument.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf '(1 2) (IPersistentList Number))
+(clojure.lang.IPersistentList java.lang.Number)
+</code></pre><h3 id="vectors">Vectors</h3><p>Vectors extend <code>(IPersistentVector a)</code>, which is covariant in its argument.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf [1 2] (IPersistentVector Number))
+(clojure.lang.IPersistentVector java.lang.Number)
+</code></pre><h3 id="maps">Maps</h3><p>Maps extend <code>(IPersistentMap a b)</code>, which is covariant in both its arguments.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf {'a 1 'b 3} (IPersistentMap Symbol Long))
+(clojure.lang.IPersistentMap clojure.lang.Symbol java.lang.Long)
+</code></pre><h3 id="sets">Sets</h3><p>Sets extend <code>(IPersistentSet a)</code>, which is covariant in its argument.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf #{1 2 3} (IPersistentSet Number))
+(clojure.lang.IPersistentSet java.lang.Number)
+</code></pre><h3 id="atoms">Atoms</h3><p>An Atom of type <code>(Atom w r)</code> can accept values of type <code>w</code> and provide values of type <code>r</code>.
+It is contravariant in <code>w</code> and covariant in <code>r</code>.</p><p>Usually <code>w</code> and <code>r</code> are identical, so an alias <code>(clojure.core.typed/Atom1 wr)</code> is provided,
+which is equivalent to <code>(Atom wr wr)</code>.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf (atom {}) (Atom1 (IPersistentMap Symbol Number)))
+(clojure.core.typed/Atom1 (clojure.lang.IPersistentMap clojure.lang.Symbol java.lang.Number))
+</code></pre><h2 id="type-grammar">Type Grammar</h2><p>A rough grammar for core.typed types.</p><pre><code>Type :=  nil
+     |   true
+     |   false
+     |   (U Type*)
+     |   (I Type+)
+     |   FunctionIntersection
+     |   (Value CONSTANT-VALUE)
+     |   (Rec [Symbol] Type)
+     |   (All [Symbol+] Type)
+     |   (All [Symbol* Symbol ...] Type)
+     |   (HMap {Keyword Type*})        ;eg (HMap {:a (Value 1), :b nil})
+     |   '{Keyword Type*}              ;eg '{:a (Value 1), :b nil}
+     |   (Vector* Type*)
+     |   '[Type*]
+     |   (Seq* Type*)
+     |   (List* Type*)
+     |   Symbol  ;class/protocol/free resolvable in context
+
+FunctionIntersection :=  ArityType
+                     |   (Fn ArityType+)
+
+ArityType :=   [FixedArgs -&gt; Type]
+           |   [FixedArgs RestArgs * -&gt; Type]
+           |   [FixedArgs DottedType ... Symbol -&gt; Type]
+
+FixedArgs := Type*
+RestArgs := Type
+DottedType := Type
+</code></pre><h2 id="types">Types</h2><h3 id="value-shorthands">Value shorthands</h3><p><code>nil</code>, <code>true</code> and <code>false</code> resolve to the respective singleton types for those values</p><h3 id="intersections">Intersections</h3><p><code>(I Type+)</code> creates an intersection of types.</p><h3 id="unions">Unions</h3><p><code>(U Type*)</code> creates a union of types.</p><h3 id="functions-1">Functions</h3><p>A function type is an ordered intersection of arity types.</p><p>There is a vector sugar for functions of one arity.</p><h3 id="heterogeneous-maps">Heterogeneous Maps</h3><p><em>Warning</em>: Heterogeneous maps are alpha and their design is subject to change.</p><p>A heterogeneous map type represents a map that has at least a particular set of keyword keys.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf {:a 1})
+[(HMap {:a (Value 1)}) {:then tt, :else ff}]
+</code></pre><p>This type can also be written <code>'{:a (Value 1)}</code>.</p><p>Lookups of known keys infer accurate types.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf (-&gt; {:a 1} :a))
+(Value 1)
+</code></pre><p>Currently, they are limited (but still quite useful):</p><ul><li>the presence of keys is recorded, but not their absence</li><li>only keyword value keys are allowed.</li></ul><p>These rules have several implications.</p><h4 id="absent-keys">Absent keys</h4><p>Looking up keys that are not recorded as present give inaccurate types</p><pre><code class="clojure">clojure.core.typed=&gt; (cf (-&gt; {:a 1} :b))
+Any
+</code></pre><h4 id="non-keyword-keys">Non-keyword keys</h4><p>Literal maps without keyword keys are inferred as <code>APersistentMap</code>.</p><pre><code class="clojure">clojure.core.typed=&gt; (cf {(inc 1) 1})
+[(clojure.lang.APersistentMap clojure.core.typed/AnyInteger (Value 1)) {:then tt, :else ff}]
+</code></pre><p>Optional keys can be defined either by constructing a union of map types, or by passing
+the <code>HMap</code> type constructor an <code>:optional</code> keyword argument with a map of optional keys.</p><h3 id="heterogeneous-vectors">Heterogeneous Vectors</h3><p><code>(Vector* (Value 1) (Value 2))</code> is a IPersistentVector of length 2, essentially
+representing the value <code>[1 2]</code>. The type <code>'[(Value 1) (Value 2)]</code> is identical.</p><h3 id="polymorphism">Polymorphism</h3><p>The binding form <code>All</code> introduces a number of free variables inside a scope.</p><p>Optionally scopes a dotted variable by adding <code>...</code> after the last symbol in the binder.</p><p>eg. The identity function: <code>(All [x] [x -&gt; x])</code>
+eg. Introducing dotted variables: `(All [x y ...] [x y ... y -&gt; x])</p><h3 id="recursive-types">Recursive Types</h3><p><code>Rec</code> introduces a recursive type. It takes a vector of one symbol and a type.
+The symbol is scoped to represent the entire type in the type argument.</p><pre><code class="clojure">; Type for {:op :if
+;           :test {:op :var, :var #'A}
+;           :then {:op :nil}
+;           :else {:op :false}}
+(Rec [x]
+     (U (HMap {:op (Value :if)
+               :test x
+               :then x
+               :else x})
+        (HMap {:op (Value :var)
+               :var clojure.lang.Var})
+        (HMap {:op (Value :nil)})
+        (HMap {:op (Value :false)})))))
+</code></pre>
+
+    <div id="prev-next">
+        
+        <a href="../start/introduction_and_motivation/index.html">&laquo; core.typed - Getting Started: Introduction and Motivation</a>
+        
+        
+        ||
+        
+        
+        <a href="../start/annotations/index.html">core.typed - Annotations &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/core_typed/user_documentation/index.html b/clones/clojure-doc.org/articles/ecosystem/core_typed/user_documentation/index.html
new file mode 100644
index 00000000..85c656b9
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/core_typed/user_documentation/index.html
@@ -0,0 +1,257 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: core.typed - User Documentation</title>
+    
+
+<meta name="description" content="UsageType Aliases">
+
+<meta property="og:description" content="UsageType Aliases">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/core_typed/user_documentation/" />
+<meta property="og:title" content="core.typed - User Documentation" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/core_typed/user_documentation/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>core.typed - User Documentation</h2>
+    </div>
+    
+    <h1 id="usage">Usage</h1><h2 id="type-aliases">Type Aliases</h2><p><code>clojure.core.typed/def-alias</code> defines a type alias.</p><pre><code class="clojure">(def-alias Term (I IUnifyTerms
+                   IUnifyWithNil
+                   IUnifyWithObject
+                   IUnifyWithLVar
+                   IUnifyWithSequential
+                   IUnifyWithMap
+                   IUnifyWithSet
+                   IReifyTerm
+                   IWalkTerm
+                   IOccursCheckTerm
+                   IBuildTerm))
+</code></pre><h2 id="primitive-java-arrays">Primitive Java Arrays</h2><p>"Typed" arrays can be created with <code>into-array&gt;</code>, which has a 2 and 3 arity version.</p><p>The correspondence between core.typed types and Java types is subtle here. Usually
+<code>into-array&gt;</code> accepts a core.typed type as its first argument, followed by a collection (as <code>clojure.core/into-array</code>).</p><pre><code class="clojure">;; `int` is the primitive int in Java. This creates a primitive array.
+(class (into-array&gt; int [1]))
+;=&gt; [I
+
+;; This is a Number array with nullable elements.
+(class (into-array&gt; (U nil Number) [1]))
+;=&gt; [Ljava.lang.Number;
+
+;; This is a Number array with non-nullable elements.
+;; Notice this generates the same type as before as Java does not distinguish
+;; non-/nullable arrays. core.typed statically disallows nil to be added
+;; as an element from any Clojure it checks.
+(class (into-array&gt; Number [1]))
+;=&gt; [Ljava.lang.Number;
+
+;; An array of nullable primitive ints does not make sense in Java,
+;; so it is generalised to an array of Objects.
+(class (into-array&gt; (U nil int) [1]))
+;=&gt; [Ljava.lang.Object;
+
+;; Unions are often generalised to Object
+(class (into-array&gt; (U clojure.lang.Symbol Number) [1]))
+;=&gt; [Ljava.lang.Object;
+</code></pre><p>When more control is needed of the Java type, the 3 arity version of <code>into-array&gt;</code> accepts
+the Java type (in core.typed syntax) as first argument, followed by the Clojure type, and the collection.</p><pre><code class="clojure">;; Generalising to Number instead of Object.
+(class (into-array&gt; Number (U Integer Number) [1]))
+;=&gt; [Ljava.lang.Number;
+</code></pre><p>The Clojure element type should be a subtype to the Java element type.</p><h2 id="declarations">Declarations</h2><p><code>clojure.core.typed/declare-types</code>, <code>clojure.core.typed/declare-names</code> and <code>clojure.core.typed/declare-protocols</code> are similar
+to <code>declare</code> in that they allow you to use types before they are defined.</p><pre><code class="clojure">(declare-datatypes Substitutions)
+(declare-protocols LVar)
+(declare-names MyAlias)
+</code></pre><h2 id="checking-typed-namespaces">Checking typed namespaces</h2><p><code>clojure.core.typed/check-ns</code> checks the namespace that its symbol argument represents.</p><pre><code class="clojure">(check-ns 'my.ns)
+</code></pre><h2 id="debugging">Debugging</h2><p><code>clojure.core.typed/print-env</code> prints the current environment.</p><pre><code class="clojure">(let [a 1]
+  (print-env "Env:")
+  a)
+; Prints: "Env:" {:env {a (Value 1)},  ....}
+</code></pre><p><code>clojure.core.typed/cf</code> (pronounced "check form") can be used at the REPL to return the type of a form.</p><pre><code class="clojure">(cf 1)
+;=&gt; [(Value 1) {:then [top-filter], :else [bot-filter]} empty-object]
+</code></pre><h2 id="macros--macro-definitions">Macros &amp; Macro Definitions</h2><p>Macro definitions are ignored. The type checker operates on the macroexpanded form from
+the Compiler's analysis phase.</p>
+
+    <div id="prev-next">
+        
+        <a href="../home/index.html">&laquo; core.typed - User Documentation Home</a>
+        
+        
+        ||
+        
+        
+        <a href="../rationale/index.html">core.typed - Rationale &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/data_processing/index.html b/clones/clojure-doc.org/articles/ecosystem/data_processing/index.html
new file mode 100644
index 00000000..c1314c4d
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/data_processing/index.html
@@ -0,0 +1,208 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Data Processing (Help Wanted)</title>
+    
+
+<meta name="description" content="Help wantedPlease follow the instructions on how to contribute and start writing over here">
+
+<meta property="og:description" content="Help wantedPlease follow the instructions on how to contribute and start writing over here">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/data_processing/" />
+<meta property="og:title" content="Data Processing (Help Wanted)" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/data_processing/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Data Processing (Help Wanted)</h2>
+    </div>
+    
+    <h2 id="help-wanted">Help wanted</h2><p>Please follow the <a href="https://github.com/clojure-doc/clojure-doc.github.io/tree/source#how-to-contribute">instructions</a> on how to contribute and start writing over <a href="https://github.com/clojure-doc/clojure-doc.github.io/blob/source/content/md/articles/ecosystem/data_processing.md">here</a></p><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons
+Attribution 3.0 Unported License</a> (including images &amp;
+stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on Github</a>.</p>
+
+    <div id="prev-next">
+        
+        <a href="../generating_documentation/index.html">&laquo; Generating Documentation</a>
+        
+        
+        ||
+        
+        
+        <a href="../web_development/index.html">Web Development (Overview) &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/generating_documentation/index.html b/clones/clojure-doc.org/articles/ecosystem/generating_documentation/index.html
new file mode 100644
index 00000000..f8f894ff
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/generating_documentation/index.html
@@ -0,0 +1,231 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Generating Documentation</title>
+    
+
+<meta name="description" content="This guide notes some commonly-used tools for generating project
+documentation.This work is licensed under a Creative Commons
+Attribution 3.0 Unported License (including images &amp;
+stylesheets). The source is available on
+Github.">
+
+<meta property="og:description" content="This guide notes some commonly-used tools for generating project
+documentation.This work is licensed under a Creative Commons
+Attribution 3.0 Unported License (including images &amp;
+stylesheets). The source is available on
+Github.">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/generating_documentation/" />
+<meta property="og:title" content="Generating Documentation" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/generating_documentation/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Generating Documentation</h2>
+    </div>
+    
+    <p>This guide notes some commonly-used tools for generating project
+documentation.</p><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons
+Attribution 3.0 Unported License</a> (including images &amp;
+stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on
+Github</a>.</p><h2 id="what-version-of-clojure-does-this-guide-cover">What Version of Clojure Does This Guide Cover?</h2><p>This guide covers Clojure 1.4.</p><h2 id="overview">Overview</h2><p>Projects commonly (hopefully?) have at least two types of
+documentation:</p><ul><li>standalone
+<a href="http://en.wikipedia.org/wiki/Markdown">markdown</a>-formatted docs
+in the project's doc directory</li><li>docstrings</li></ul><p>There are a number of tools for generating handsome API docs from
+docstrings and other project metadata.</p><h2 id="codox">Codox</h2><p>If you'd like to generate nice-looking html API docs for your library,
+use <a href="https://github.com/weavejester/codox">codox</a>. Usage instructions
+are in the codox readme. Running codox (it's a lein plug-in and is run
+via <code>lein codox</code> in your project) will create a "doc" subdirectory
+containing the resulting html.</p><h2 id="marginalia">Marginalia</h2><p>If you'd like to render API docs side-by-side with the source code
+it's documenting, use <a href="https://github.com/fogus/lein-marginalia">the marginalia lein
+plug-in</a>. Usage instructions
+are in the readme.</p><h2 id="cadastre">Cadastre</h2><p>If you'd like to generate copious raw data from a project (which
+includes docstrings as well as other metadata), have a look at
+<a href="https://github.com/dakrone/cadastre">cadastre</a>.</p>
+
+    <div id="prev-next">
+        
+        <a href="../libraries_authoring/index.html">&laquo; Library Development and Distribution</a>
+        
+        
+        ||
+        
+        
+        <a href="../data_processing/index.html">Data Processing (Help Wanted) &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/java_jdbc/home.html b/clones/clojure-doc.org/articles/ecosystem/java_jdbc/home.html
new file mode 100644
index 00000000..40762d4e
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/java_jdbc/home.html
@@ -0,0 +1,310 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: java.jdbc - Getting Started</title>
+    
+
+<meta name="description" content="This guide is intended to help you the Clojure Contrib JDBC wrapper: clojure.java.jdbcA modern JDBC wrapper has since been written (by the same author/maintainer) -- read about next.jdbc on cljdoc.org">
+
+<meta property="og:description" content="This guide is intended to help you the Clojure Contrib JDBC wrapper: clojure.java.jdbcA modern JDBC wrapper has since been written (by the same author/maintainer) -- read about next.jdbc on cljdoc.org">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/java_jdbc/home/" />
+<meta property="og:title" content="java.jdbc - Getting Started" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/java_jdbc/home/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>java.jdbc - Getting Started</h2>
+    </div>
+    
+    <p>This guide is intended to help you the Clojure Contrib JDBC wrapper: <code>clojure.java.jdbc</code></p><p><strong>A modern JDBC wrapper has since been written (by the same author/maintainer) -- read about <a href="https://clojure-doc.org/articles/ecosystem/java_jdbc/home/cljdoc.org/d/com.github.seancorfield/next.jdbc/"><code>next.jdbc</code> on cljdoc.org</a></strong></p><h2 id="contents">Contents</h2><ul><li><a href="home.html">Overview</a></li><li><a href="using_sql.html">Using SQL</a></li><li><a href="using_ddl.html">Using DDL</a></li><li><a href="reusing_connections.html">Reusing Connections</a></li></ul><h2 id="overview">Overview</h2><p><code>java.jdbc</code> is intended to be a low-level Clojure wrapper around various Java
+JDBC drivers and supports a wide range of databases. The <a href="https://github.com/clojure/java.jdbc/"><code>java.jdbc</code> source is
+on GitHub</a> and there is a dedicated <a href="https://groups.google.com/forum/#!forum/clojure-java-jdbc">java.jdbc mailing
+list</a>. The detailed <a href="http://clojure.github.io/java.jdbc/"><code>java.jdbc</code> reference</a> is
+automatically generated from the <code>java.jdbc</code> source.</p><p>Generally, when using <code>java.jdbc</code>, you will set up a data source as a "database
+spec" and pass that to the various CRUD (create, read, update, delete)
+functions that <code>java.jdbc</code> provides. These operations are detailed within the
+<a href="using_sql.html">Using SQL</a> page, but a quick overview is provided by the
+walkthrough below.</p><p>By default, each operation opens a connection and executes the SQL inside a
+transaction. You can also run multiple operations against the same connection,
+either within a transaction or via connection pooling, or just with a shared
+connection. You can read more about reusing connections on the <a href="reusing_connections.html">Reusing
+Connections</a> page.</p><h2 id="higher-level-dsl-and-migration-libraries">Higher-level DSL and migration libraries</h2><p>If you need more abstraction than the <code>java.jdbc</code> wrapper provides, you may want
+to consider using a library that provides a DSL. All of the following libraries
+are built on top of <code>java.jdbc</code> and provide such abstraction:</p><ul><li><a href="https://github.com/jkk/honeysql">HoneySQL</a></li><li><a href="https://github.com/r0man/sqlingvo">SQLingvo</a></li><li><a href="http://sqlkorma.com">Korma</a></li><li><a href="https://github.com/walkable-server/walkable">Walkable</a></li></ul><p>In particular, <a href="http://sqlkorma.com">Korma</a> goes beyond a SQL DSL to provide "entities" and
+"relationships" (in the style of classical Object-Relational Mappers, but
+without the pain).</p><p>Another common need with SQL is for database migration libraries. Some of the
+more popular options are:</p><ul><li><a href="https://github.com/macourtney/drift">Drift</a></li><li><a href="https://github.com/pjstadig/migratus">Migratus</a></li><li><a href="https://github.com/weavejester/ragtime">Ragtime</a></li></ul><h2 id="a-brief-javajdbc-walkthrough">A brief <code>java.jdbc</code> walkthrough</h2><h3 id="setting-up-a-data-source">Setting up a data source</h3><p>A "database spec" is a Clojure map that specifies how to access the data
+source. Most commonly, you specify the database type, the database name,
+and the username and password. For example,</p><pre><code class="clojure">(def db-spec
+  {:dbtype "mysql"
+   :dbname "mydb"
+   :user "myaccount"
+   :password "secret"})
+</code></pre><p>See <a href="home.html#database-support"><strong>Database Support</strong></a> below for a complete list of
+databases and drivers supported by <code>java.jdbc</code> out of the box.</p><h3 id="a-hello-world-query">A "Hello World" Query</h3><p>Querying the database can be as simple as:</p><pre><code class="clojure">(ns dbexample
+  (:require [clojure.java.jdbc :as jdbc]))
+
+(def db-spec ... ) ;; see above
+
+(jdbc/query db-spec ["SELECT 3*5 AS result"])
+=&gt; {:result 15}
+</code></pre><p>Of course, we will want to do more with our database than have it perform
+simple calculations. Once we can successfully connect to it, we will likely
+want to create tables and manipulate data.</p><h3 id="creating-tables">Creating tables</h3><p><code>java.jdbc</code> provides <code>create-table-ddl</code> and <code>drop-table-ddl</code> to generate basic
+<code>CREATE TABLE</code> and <code>DROP TABLE</code> DDL strings. Anything beyond that can be
+constructed manually as a string.</p><pre><code class="clojure">(ns dbexample
+  (:require [clojure.java.jdbc :as jdbc]))
+
+(def db-spec ... ) ;; see above
+
+(def fruit-table-ddl
+  (jdbc/create-table-ddl :fruit
+                         [[:name "varchar(32)"]
+                          [:appearance "varchar(32)"]
+                          [:cost :int]
+                          [:grade :real]]))
+</code></pre><p>We can use the function <code>db-do-commands</code> to create our table and indexes in a
+single transaction:</p><pre><code class="clojure">(jdbc/db-do-commands db-spec
+                     [fruit-table-ddl
+                      "CREATE INDEX name_ix ON fruit ( name );"])
+</code></pre><p>For more details on DDL functionality within <code>java.jdbc</code>, see the <a href="using_ddl.html">Using DDL and
+Metadata Guide</a>.</p><h3 id="querying-the-database">Querying the database</h3><p>The four basic CRUD operations <code>java.jdbc</code> provides are:</p><pre><code class="clojure">(jdbc/insert! db-spec :table {:col1 42 :col2 "123"})               ;; Create
+(jdbc/query   db-spec ["SELECT * FROM table WHERE id = ?" 13])     ;; Read
+(jdbc/update! db-spec :table {:col1 77 :col2 "456"} ["id = ?" 13]) ;; Update
+(jdbc/delete! db-spec :table ["id = ?" 13])                        ;; Delete
+</code></pre><p>The table name can be specified as a string or a keyword.</p><p><code>insert!</code> takes a single record in hash map form to insert. <code>insert!</code> can also
+take a vector of column names (as strings or keywords), followed by a vector of
+column values to insert into those respective columns, much like an <code>INSERT</code>
+statement in SQL. Entries in the map that have the value <code>nil</code> will cause
+<code>NULL</code> values to be inserted into the corresponding columns.</p><p>If you wish to insert multiple rows (in hash map form) at once, you can use
+<code>insert-multi!</code>; however, <code>insert-multi!</code> will write a separate insertion
+statement for each row, so it is suggested you use the column-based form of
+<code>insert-multi!</code> over the row-based form. Passing multiple column values to
+<code>insert-multi!</code> will generate a single batched insertion statement and yield
+better performance.</p><p><code>query</code> allows us to run selection queries on the database. Since you provide
+the query string directly, you have as much flexibility as you like to perform
+complex queries.</p><p><code>update!</code> takes a map of columns to update, with their new values, and a SQL
+clause used to select which rows to update (prepended by <code>WHERE</code> in the
+generated SQL). As with <code>insert!</code>, <code>nil</code> values in the map cause the
+corresponding columns to be set to <code>NULL</code>.</p><p><code>delete!</code> takes a SQL clause used to select which rows to delete, similar to
+<code>update!</code>.</p><p>By default, the table name and column names are converted to strings
+corresponding to the keyword names in the underlying SQL. We can control how we
+transform keywords into SQL names using an optional <code>:entities</code> argument which
+is described in more detail in the <a href="using_sql.html">Using SQL</a> section.</p><h3 id="dropping-our-tables">Dropping our tables</h3><p>To clean out the database from our example, we can generate a the command to
+drop the fruit table:</p><pre><code class="clojure">(def drop-fruit-table-ddl (jdbc/drop-table-ddl :fruit))
+</code></pre><p>Ensure you tear down your tables and indexes in the opposite order of creation:</p><pre><code class="clojure">(jdbc/db-do-commands db-spec
+                     ["DROP INDEX name_ix;"
+                      drop-fruit-table-ddl])
+</code></pre><p>These are all the commands we need to write a simple migration for our database!</p><h2 id="database-support">Database Support</h2><p>Out of the box, <code>java.jdbc</code> understands the following <code>:dbtype</code> values (with
+their default class names):</p><ul><li><code>"derby"</code> - <code>org.apache.derby.jdbc.EmbeddedDriver</code></li><li><code>"h2"</code> - <code>org.h2.Driver</code></li><li><code>"h2:mem"</code> - <code>org.h2.Driver</code></li><li><code>"hsqldb"</code> or <code>"hsql"</code> - <code>org.hsqldb.jdbcDriver</code></li><li><code>"jtds:sqlserver"</code> or <code>"jtds"</code> - <code>net.sourceforge.jtds.jdbc.Driver</code></li><li><code>"mysql"</code> - <code>com.mysql.jdbc.Driver</code></li><li><code>"oracle:oci"</code> - <code>oracle.jdbc.OracleDriver</code></li><li><code>"oracle:thin"</code> or <code>"oracle"</code> - <code>oracle.jdbc.OracleDriver</code></li><li><code>"postgresql"</code> or <code>"postgres"</code> - <code>org.postgresql.Driver</code></li><li><code>"pgsql"</code> - <code>com.impossibl.postgres.jdbc.PGDriver</code></li><li><code>"redshift"</code> - <code>com.amazon.redshift.jdbc.Driver</code></li><li><code>"sqlite"</code> - <code>org.sqlite.JDBC</code></li><li><code>"sqlserver"</code> - <code>"mssql"</code> - <code>com.microsoft.sqlserver.jdbc.SQLServerDriver</code></li></ul><p>You must specify the appropriate JDBC driver dependency in your project -- these
+drivers are not included with <code>java.jdbc</code>.</p><p>You can overide the default class name by specifying <code>:classname</code> as well as
+<code>:dbtype</code>.</p><p>For databases that require a hostname or IP address, <code>java.jdbc</code> assumes
+<code>"127.0.0.1"</code> but that can be overidden with the <code>:host</code> option.</p><p>For databases that require a port, <code>java.jdbc</code> has the following defaults,
+which can be overridden with the <code>:port</code> option:</p><ul><li>Microsoft SQL Server - 1433</li><li>MySQL - 3306</li><li>Oracle - 1521</li><li>PostgreSQL - 5432</li></ul><p>Some databases require a different format for the "database spec". Here is an example
+that was required for an in-memory <a href="http://www.h2database.com">H2 database</a> prior
+to <code>java.jdbc</code> release 0.7.6:</p><pre><code class="clojure">(def db-spec
+  {:classname   "org.h2.Driver"
+   :subprotocol "h2:mem"                  ; the prefix `jdbc:` is added automatically
+   :subname     "demo;DB_CLOSE_DELAY=-1"  ; `;DB_CLOSE_DELAY=-1` very important!!!
+                    ; http://www.h2database.com/html/features.html#in_memory_databases
+   :user        "sa"                      ; default "system admin" user
+   :password    ""                        ; default password =&gt; empty string
+  })
+</code></pre><p>This is the most general form of database spec, that allows you to control each
+piece of the JDBC connection URL that would be created.</p><p>Note: as of <code>java.jdbc</code> 0.7.6, in-memory H2 databases are supported directly
+via the simple spec form:</p><pre><code class="clojure">(def db-spec
+  {:dbtype "h2:mem"
+   :dbname "mydb"})
+</code></pre><p>For file-based databases, such as H2, Derby, SQLite etc, the <code>:dbname</code> will
+specify the filename:</p><pre><code class="clojure">(def db-spec
+  {:dbtype "h2"
+   :dbname "/path/to/my/database"})
+</code></pre><h2 id="more-detailed-javajdbc-documentation">More detailed <code>java.jdbc</code> documentation</h2><ul><li><a href="using_sql.html">Using SQL:</a> a more detailed guide on using SQL with <code>java.jdbc</code></li><li><a href="using_ddl.html">Using DDL:</a> how to create your tables using the <code>java.jdbc</code> DDL</li><li><a href="reusing_connections.html">Reusing Connections:</a> how to reuse your database
+connections</li></ul>
+
+    <div id="prev-next">
+        
+        <a href="../../cookbooks/middleware/index.html">&laquo; Middleware in Clojure</a>
+        
+        
+        ||
+        
+        
+        <a href="using_sql.html">java.jdbc - Manipulating data with SQL &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/java_jdbc/home/index.html b/clones/clojure-doc.org/articles/ecosystem/java_jdbc/home/index.html
new file mode 100644
index 00000000..ffd8cfb2
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/java_jdbc/home/index.html
@@ -0,0 +1,310 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: java.jdbc - Getting Started</title>
+    
+
+<meta name="description" content="This guide is intended to help you the Clojure Contrib JDBC wrapper: clojure.java.jdbcA modern JDBC wrapper has since been written (by the same author/maintainer) -- read about next.jdbc on cljdoc.org">
+
+<meta property="og:description" content="This guide is intended to help you the Clojure Contrib JDBC wrapper: clojure.java.jdbcA modern JDBC wrapper has since been written (by the same author/maintainer) -- read about next.jdbc on cljdoc.org">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/java_jdbc/home/" />
+<meta property="og:title" content="java.jdbc - Getting Started" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/java_jdbc/home/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>java.jdbc - Getting Started</h2>
+    </div>
+    
+    <p>This guide is intended to help you the Clojure Contrib JDBC wrapper: <code>clojure.java.jdbc</code></p><p><strong>A modern JDBC wrapper has since been written (by the same author/maintainer) -- read about <a href="https://clojure-doc.org/articles/ecosystem/java_jdbc/home/cljdoc.org/d/com.github.seancorfield/next.jdbc/"><code>next.jdbc</code> on cljdoc.org</a></strong></p><h2 id="contents">Contents</h2><ul><li><a href="../home.html">Overview</a></li><li><a href="../using_sql.html">Using SQL</a></li><li><a href="../using_ddl.html">Using DDL</a></li><li><a href="../reusing_connections.html">Reusing Connections</a></li></ul><h2 id="overview">Overview</h2><p><code>java.jdbc</code> is intended to be a low-level Clojure wrapper around various Java
+JDBC drivers and supports a wide range of databases. The <a href="https://github.com/clojure/java.jdbc/"><code>java.jdbc</code> source is
+on GitHub</a> and there is a dedicated <a href="https://groups.google.com/forum/#!forum/clojure-java-jdbc">java.jdbc mailing
+list</a>. The detailed <a href="http://clojure.github.io/java.jdbc/"><code>java.jdbc</code> reference</a> is
+automatically generated from the <code>java.jdbc</code> source.</p><p>Generally, when using <code>java.jdbc</code>, you will set up a data source as a "database
+spec" and pass that to the various CRUD (create, read, update, delete)
+functions that <code>java.jdbc</code> provides. These operations are detailed within the
+<a href="../using_sql.html">Using SQL</a> page, but a quick overview is provided by the
+walkthrough below.</p><p>By default, each operation opens a connection and executes the SQL inside a
+transaction. You can also run multiple operations against the same connection,
+either within a transaction or via connection pooling, or just with a shared
+connection. You can read more about reusing connections on the <a href="../reusing_connections.html">Reusing
+Connections</a> page.</p><h2 id="higher-level-dsl-and-migration-libraries">Higher-level DSL and migration libraries</h2><p>If you need more abstraction than the <code>java.jdbc</code> wrapper provides, you may want
+to consider using a library that provides a DSL. All of the following libraries
+are built on top of <code>java.jdbc</code> and provide such abstraction:</p><ul><li><a href="https://github.com/jkk/honeysql">HoneySQL</a></li><li><a href="https://github.com/r0man/sqlingvo">SQLingvo</a></li><li><a href="http://sqlkorma.com">Korma</a></li><li><a href="https://github.com/walkable-server/walkable">Walkable</a></li></ul><p>In particular, <a href="http://sqlkorma.com">Korma</a> goes beyond a SQL DSL to provide "entities" and
+"relationships" (in the style of classical Object-Relational Mappers, but
+without the pain).</p><p>Another common need with SQL is for database migration libraries. Some of the
+more popular options are:</p><ul><li><a href="https://github.com/macourtney/drift">Drift</a></li><li><a href="https://github.com/pjstadig/migratus">Migratus</a></li><li><a href="https://github.com/weavejester/ragtime">Ragtime</a></li></ul><h2 id="a-brief-javajdbc-walkthrough">A brief <code>java.jdbc</code> walkthrough</h2><h3 id="setting-up-a-data-source">Setting up a data source</h3><p>A "database spec" is a Clojure map that specifies how to access the data
+source. Most commonly, you specify the database type, the database name,
+and the username and password. For example,</p><pre><code class="clojure">(def db-spec
+  {:dbtype "mysql"
+   :dbname "mydb"
+   :user "myaccount"
+   :password "secret"})
+</code></pre><p>See <a href="../home.html#database-support"><strong>Database Support</strong></a> below for a complete list of
+databases and drivers supported by <code>java.jdbc</code> out of the box.</p><h3 id="a-hello-world-query">A "Hello World" Query</h3><p>Querying the database can be as simple as:</p><pre><code class="clojure">(ns dbexample
+  (:require [clojure.java.jdbc :as jdbc]))
+
+(def db-spec ... ) ;; see above
+
+(jdbc/query db-spec ["SELECT 3*5 AS result"])
+=&gt; {:result 15}
+</code></pre><p>Of course, we will want to do more with our database than have it perform
+simple calculations. Once we can successfully connect to it, we will likely
+want to create tables and manipulate data.</p><h3 id="creating-tables">Creating tables</h3><p><code>java.jdbc</code> provides <code>create-table-ddl</code> and <code>drop-table-ddl</code> to generate basic
+<code>CREATE TABLE</code> and <code>DROP TABLE</code> DDL strings. Anything beyond that can be
+constructed manually as a string.</p><pre><code class="clojure">(ns dbexample
+  (:require [clojure.java.jdbc :as jdbc]))
+
+(def db-spec ... ) ;; see above
+
+(def fruit-table-ddl
+  (jdbc/create-table-ddl :fruit
+                         [[:name "varchar(32)"]
+                          [:appearance "varchar(32)"]
+                          [:cost :int]
+                          [:grade :real]]))
+</code></pre><p>We can use the function <code>db-do-commands</code> to create our table and indexes in a
+single transaction:</p><pre><code class="clojure">(jdbc/db-do-commands db-spec
+                     [fruit-table-ddl
+                      "CREATE INDEX name_ix ON fruit ( name );"])
+</code></pre><p>For more details on DDL functionality within <code>java.jdbc</code>, see the <a href="../using_ddl.html">Using DDL and
+Metadata Guide</a>.</p><h3 id="querying-the-database">Querying the database</h3><p>The four basic CRUD operations <code>java.jdbc</code> provides are:</p><pre><code class="clojure">(jdbc/insert! db-spec :table {:col1 42 :col2 "123"})               ;; Create
+(jdbc/query   db-spec ["SELECT * FROM table WHERE id = ?" 13])     ;; Read
+(jdbc/update! db-spec :table {:col1 77 :col2 "456"} ["id = ?" 13]) ;; Update
+(jdbc/delete! db-spec :table ["id = ?" 13])                        ;; Delete
+</code></pre><p>The table name can be specified as a string or a keyword.</p><p><code>insert!</code> takes a single record in hash map form to insert. <code>insert!</code> can also
+take a vector of column names (as strings or keywords), followed by a vector of
+column values to insert into those respective columns, much like an <code>INSERT</code>
+statement in SQL. Entries in the map that have the value <code>nil</code> will cause
+<code>NULL</code> values to be inserted into the corresponding columns.</p><p>If you wish to insert multiple rows (in hash map form) at once, you can use
+<code>insert-multi!</code>; however, <code>insert-multi!</code> will write a separate insertion
+statement for each row, so it is suggested you use the column-based form of
+<code>insert-multi!</code> over the row-based form. Passing multiple column values to
+<code>insert-multi!</code> will generate a single batched insertion statement and yield
+better performance.</p><p><code>query</code> allows us to run selection queries on the database. Since you provide
+the query string directly, you have as much flexibility as you like to perform
+complex queries.</p><p><code>update!</code> takes a map of columns to update, with their new values, and a SQL
+clause used to select which rows to update (prepended by <code>WHERE</code> in the
+generated SQL). As with <code>insert!</code>, <code>nil</code> values in the map cause the
+corresponding columns to be set to <code>NULL</code>.</p><p><code>delete!</code> takes a SQL clause used to select which rows to delete, similar to
+<code>update!</code>.</p><p>By default, the table name and column names are converted to strings
+corresponding to the keyword names in the underlying SQL. We can control how we
+transform keywords into SQL names using an optional <code>:entities</code> argument which
+is described in more detail in the <a href="../using_sql.html">Using SQL</a> section.</p><h3 id="dropping-our-tables">Dropping our tables</h3><p>To clean out the database from our example, we can generate a the command to
+drop the fruit table:</p><pre><code class="clojure">(def drop-fruit-table-ddl (jdbc/drop-table-ddl :fruit))
+</code></pre><p>Ensure you tear down your tables and indexes in the opposite order of creation:</p><pre><code class="clojure">(jdbc/db-do-commands db-spec
+                     ["DROP INDEX name_ix;"
+                      drop-fruit-table-ddl])
+</code></pre><p>These are all the commands we need to write a simple migration for our database!</p><h2 id="database-support">Database Support</h2><p>Out of the box, <code>java.jdbc</code> understands the following <code>:dbtype</code> values (with
+their default class names):</p><ul><li><code>"derby"</code> - <code>org.apache.derby.jdbc.EmbeddedDriver</code></li><li><code>"h2"</code> - <code>org.h2.Driver</code></li><li><code>"h2:mem"</code> - <code>org.h2.Driver</code></li><li><code>"hsqldb"</code> or <code>"hsql"</code> - <code>org.hsqldb.jdbcDriver</code></li><li><code>"jtds:sqlserver"</code> or <code>"jtds"</code> - <code>net.sourceforge.jtds.jdbc.Driver</code></li><li><code>"mysql"</code> - <code>com.mysql.jdbc.Driver</code></li><li><code>"oracle:oci"</code> - <code>oracle.jdbc.OracleDriver</code></li><li><code>"oracle:thin"</code> or <code>"oracle"</code> - <code>oracle.jdbc.OracleDriver</code></li><li><code>"postgresql"</code> or <code>"postgres"</code> - <code>org.postgresql.Driver</code></li><li><code>"pgsql"</code> - <code>com.impossibl.postgres.jdbc.PGDriver</code></li><li><code>"redshift"</code> - <code>com.amazon.redshift.jdbc.Driver</code></li><li><code>"sqlite"</code> - <code>org.sqlite.JDBC</code></li><li><code>"sqlserver"</code> - <code>"mssql"</code> - <code>com.microsoft.sqlserver.jdbc.SQLServerDriver</code></li></ul><p>You must specify the appropriate JDBC driver dependency in your project -- these
+drivers are not included with <code>java.jdbc</code>.</p><p>You can overide the default class name by specifying <code>:classname</code> as well as
+<code>:dbtype</code>.</p><p>For databases that require a hostname or IP address, <code>java.jdbc</code> assumes
+<code>"127.0.0.1"</code> but that can be overidden with the <code>:host</code> option.</p><p>For databases that require a port, <code>java.jdbc</code> has the following defaults,
+which can be overridden with the <code>:port</code> option:</p><ul><li>Microsoft SQL Server - 1433</li><li>MySQL - 3306</li><li>Oracle - 1521</li><li>PostgreSQL - 5432</li></ul><p>Some databases require a different format for the "database spec". Here is an example
+that was required for an in-memory <a href="http://www.h2database.com">H2 database</a> prior
+to <code>java.jdbc</code> release 0.7.6:</p><pre><code class="clojure">(def db-spec
+  {:classname   "org.h2.Driver"
+   :subprotocol "h2:mem"                  ; the prefix `jdbc:` is added automatically
+   :subname     "demo;DB_CLOSE_DELAY=-1"  ; `;DB_CLOSE_DELAY=-1` very important!!!
+                    ; http://www.h2database.com/html/features.html#in_memory_databases
+   :user        "sa"                      ; default "system admin" user
+   :password    ""                        ; default password =&gt; empty string
+  })
+</code></pre><p>This is the most general form of database spec, that allows you to control each
+piece of the JDBC connection URL that would be created.</p><p>Note: as of <code>java.jdbc</code> 0.7.6, in-memory H2 databases are supported directly
+via the simple spec form:</p><pre><code class="clojure">(def db-spec
+  {:dbtype "h2:mem"
+   :dbname "mydb"})
+</code></pre><p>For file-based databases, such as H2, Derby, SQLite etc, the <code>:dbname</code> will
+specify the filename:</p><pre><code class="clojure">(def db-spec
+  {:dbtype "h2"
+   :dbname "/path/to/my/database"})
+</code></pre><h2 id="more-detailed-javajdbc-documentation">More detailed <code>java.jdbc</code> documentation</h2><ul><li><a href="../using_sql.html">Using SQL:</a> a more detailed guide on using SQL with <code>java.jdbc</code></li><li><a href="../using_ddl.html">Using DDL:</a> how to create your tables using the <code>java.jdbc</code> DDL</li><li><a href="../reusing_connections.html">Reusing Connections:</a> how to reuse your database
+connections</li></ul>
+
+    <div id="prev-next">
+        
+        <a href="../../../cookbooks/middleware/index.html">&laquo; Middleware in Clojure</a>
+        
+        
+        ||
+        
+        
+        <a href="../using_sql.html">java.jdbc - Manipulating data with SQL &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/java_jdbc/reusing_connections.html b/clones/clojure-doc.org/articles/ecosystem/java_jdbc/reusing_connections.html
new file mode 100644
index 00000000..98c3eae7
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/java_jdbc/reusing_connections.html
@@ -0,0 +1,289 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: java.jdbc - How to reuse database connections</title>
+    
+
+<meta name="description" content="Contents">
+
+<meta property="og:description" content="Contents">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/java_jdbc/reusing_connections/" />
+<meta property="og:title" content="java.jdbc - How to reuse database connections" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/java_jdbc/reusing_connections/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>java.jdbc - How to reuse database connections</h2>
+    </div>
+    
+    <h2 id="contents">Contents</h2><ul><li><a href="home.html">Overview</a></li><li><a href="using_sql.html">Using SQL</a></li><li><a href="using_ddl.html">Using DDL</a></li><li><a href="reusing_connections.html">Reusing Connections</a></li></ul><h2 id="reusing-connections">Reusing Connections</h2><p>Since you rarely want every database operation to create a new connection,
+there are two ways to reuse connections:</p><ul><li>Grouping Operations using <code>with-db-connection</code>: If you don't want to deal
+with a connection pooling library, you can use this macro to automatically open a
+connection and maintain it for a body of code, with each operation executed in its
+own transaction, then close the connection.</li><li>Grouping Operations using <code>with-db-transaction</code>: If you want to execute multiple
+operations in a single transaction, you can use this macro to automatically open a
+connection, start a transaction, execute multiple operations, commit the transaction,
+and then close the connection.</li><li>Connection Pooling: This is the recommended approach and is fairly
+straightforward, with a number of connection pooling libraries available. See
+<em>How To Use Connection Pooling</em> below for more information.</li></ul><h2 id="using-with-db-connection">Using <code>with-db-connection</code></h2><p>This macro provides the simplest way to reuse connections, without having to
+add a dependency on an external connection pooling library:</p><pre><code class="clojure">(ns dbexample
+  (:require [clojure.java.jdbc :as jdbc]))
+
+(def db-spec ... ) ;; see above
+
+(jdbc/with-db-connection [db-con db-spec]
+  (let [;; fetch some rows using this connection
+        rows (jdbc/query db-con ["SELECT * FROM table WHERE id = ?" 42])]
+    ;; insert a copy of the first row using the same connection
+    (jdbc/insert! db-con :table (dissoc (first rows) :id))))
+</code></pre><p>The <code>query</code> and the <code>insert!</code> are each run in their own transaction and committed
+if they succeed. If you want to run multiple operations in a single transaction
+see the next section about <code>with-db-transaction</code>.</p><h2 id="using-with-db-transaction">Using <code>with-db-transaction</code></h2><p>This macro provides a way to reuse connections, committing or rolling back
+multiple operations in a single transaction:</p><pre><code class="clojure">(ns dbexample
+  (:require [clojure.java.jdbc :as jdbc]))
+
+(def db-spec ... ) ;; see above
+
+(jdbc/with-db-transaction [t-con db-spec]
+  (let [;; fetch some rows using this connection
+        rows (jdbc/query t-con ["SELECT * FROM table WHERE id = ?" 42])]
+    ;; insert a copy of the first row using the same connection
+    (jdbc/insert! t-con :table (dissoc (first rows) :id))))
+</code></pre><p>If any operation inside <code>with-db-transaction</code> fails (throws an exception), then
+all of the operations performed so far are rolled back. If all the operations
+succeed, then the entire transaction is committed.</p><p>Transactions are not nested (since not all databases support that) so if this is
+used another active transaction, the outer transaction (and connection) are used
+as-is. If the isolation levels of the outer and inner transaction do not match
+you will get an <code>IllegalStateException</code>.</p><p>See also <code>db-set-rollback-only!</code>, <code>db-unset-rollback-only!</code>, and <code>db-is-rollback-only</code>
+for additional control over the commit/rollback behavior of the enclosing transaction.</p><h2 id="using-connection-pooling">Using Connection Pooling</h2><p><code>java.jdbc</code> does not provide connection pooling directly but it is relatively
+easy to add to your project. There are several connection pooling libraries out
+there, but here we will provide instructions for the popular <code>c3p0</code> library.</p><p>The basic idea is to add your chosen connection pooling library to your
+project, import the appropriate class(es), define a function that consumes a
+"database spec" and produces a map containing a <code>:datasource</code> key whose value
+is the constructed pooled <code>DataSource</code> object, then use that hash map in place of your
+bare <code>db-spec</code> variable. You are responsible for creating the pooled data
+source object and passing the map containing it into any functions that need a
+database connection.</p><h3 id="using-the-c3p0-library">Using the c3p0 library</h3><p>For more information on c3p0, consult the <a href="http://www.mchange.com/projects/c3p0/">c3p0
+documentation</a>.</p><p>If you're using Leiningen, you can add the following to your dependencies:</p><pre><code class="clojure">[com.mchange/c3p0 "0.9.5.2"]  ;; check the documentation for latest version
+</code></pre><p>For a Maven-based project, you would add:</p><pre><code class="xml">&lt;dependency&gt;
+  &lt;groupId&gt;com.mchange&lt;/groupId&gt;
+  &lt;artifactId&gt;c3p0&lt;/artifactId&gt;
+  &lt;version&gt;0.9.5.2&lt;/version&gt;
+&lt;/dependency&gt;
+</code></pre><h3 id="create-the-pooled-datasource-from-your-db-spec">Create the pooled datasource from your db-spec</h3><p>Define your <code>db-spec</code> using the long form, for example (for MySQL):</p><pre><code class="clojure">(def db-spec
+  {:classname "com.mysql.jdbc.Driver"
+   :subprotocol "mysql"
+   :subname "//127.0.0.1:3306/mydb"
+   :user "myaccount"
+   :password "secret"})
+</code></pre><p>We have to use the long form here because c3p0 operates on the class name, subprotocol,
+and subname elements. Of course, you don't really need to define a <code>db-spec</code> here
+because you're not going to use it with <code>java.jdbc</code> directly, only with c3p0.</p><p>Import the c3p0 class as part of your namespace declaration, for example:</p><pre><code class="clojure">(ns example.db
+  (:import (com.mchange.v2.c3p0 ComboPooledDataSource)))
+</code></pre><p>Define a function that creates a pooled datasource:</p><pre><code class="clojure">(defn pool
+  [spec]
+  (let [cpds (doto (ComboPooledDataSource.)
+               (.setDriverClass (:classname spec))
+               (.setJdbcUrl (str "jdbc:" (:subprotocol spec) ":" (:subname spec)))
+               (.setUser (:user spec))
+               (.setPassword (:password spec))
+               ;; expire excess connections after 30 minutes of inactivity:
+               (.setMaxIdleTimeExcessConnections (* 30 60))
+               ;; expire connections after 3 hours of inactivity:
+               (.setMaxIdleTime (* 3 60 60)))]
+    {:datasource cpds}))
+</code></pre><p>Now you can create a single connection pool:</p><pre><code class="clojure">(def pooled-db (delay (pool db-spec)))
+
+(defn db-connection [] @pooled-db)
+</code></pre><p>And then call <code>(db-connection)</code> wherever you need access to it. If you're using
+a <a href="https://github.com/stuartsierra/component">component</a> lifecycle for your
+application, you won't need <code>pooled-db</code> or <code>db-connection</code>. You'll just create
+<code>(pool db-spec)</code> as part of your application's initialization and pass it
+around as part of your system configuration.</p>
+
+    <div id="prev-next">
+        
+        <a href="using_ddl.html">&laquo; java.jdbc - Using DDL and Metadata</a>
+        
+        
+        ||
+        
+        
+        <a href="../core_typed/home/index.html">core.typed - User Documentation Home &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/java_jdbc/reusing_connections/index.html b/clones/clojure-doc.org/articles/ecosystem/java_jdbc/reusing_connections/index.html
new file mode 100644
index 00000000..16ba78d3
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/java_jdbc/reusing_connections/index.html
@@ -0,0 +1,289 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: java.jdbc - How to reuse database connections</title>
+    
+
+<meta name="description" content="Contents">
+
+<meta property="og:description" content="Contents">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/java_jdbc/reusing_connections/" />
+<meta property="og:title" content="java.jdbc - How to reuse database connections" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/java_jdbc/reusing_connections/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>java.jdbc - How to reuse database connections</h2>
+    </div>
+    
+    <h2 id="contents">Contents</h2><ul><li><a href="../home.html">Overview</a></li><li><a href="../using_sql.html">Using SQL</a></li><li><a href="../using_ddl.html">Using DDL</a></li><li><a href="../reusing_connections.html">Reusing Connections</a></li></ul><h2 id="reusing-connections">Reusing Connections</h2><p>Since you rarely want every database operation to create a new connection,
+there are two ways to reuse connections:</p><ul><li>Grouping Operations using <code>with-db-connection</code>: If you don't want to deal
+with a connection pooling library, you can use this macro to automatically open a
+connection and maintain it for a body of code, with each operation executed in its
+own transaction, then close the connection.</li><li>Grouping Operations using <code>with-db-transaction</code>: If you want to execute multiple
+operations in a single transaction, you can use this macro to automatically open a
+connection, start a transaction, execute multiple operations, commit the transaction,
+and then close the connection.</li><li>Connection Pooling: This is the recommended approach and is fairly
+straightforward, with a number of connection pooling libraries available. See
+<em>How To Use Connection Pooling</em> below for more information.</li></ul><h2 id="using-with-db-connection">Using <code>with-db-connection</code></h2><p>This macro provides the simplest way to reuse connections, without having to
+add a dependency on an external connection pooling library:</p><pre><code class="clojure">(ns dbexample
+  (:require [clojure.java.jdbc :as jdbc]))
+
+(def db-spec ... ) ;; see above
+
+(jdbc/with-db-connection [db-con db-spec]
+  (let [;; fetch some rows using this connection
+        rows (jdbc/query db-con ["SELECT * FROM table WHERE id = ?" 42])]
+    ;; insert a copy of the first row using the same connection
+    (jdbc/insert! db-con :table (dissoc (first rows) :id))))
+</code></pre><p>The <code>query</code> and the <code>insert!</code> are each run in their own transaction and committed
+if they succeed. If you want to run multiple operations in a single transaction
+see the next section about <code>with-db-transaction</code>.</p><h2 id="using-with-db-transaction">Using <code>with-db-transaction</code></h2><p>This macro provides a way to reuse connections, committing or rolling back
+multiple operations in a single transaction:</p><pre><code class="clojure">(ns dbexample
+  (:require [clojure.java.jdbc :as jdbc]))
+
+(def db-spec ... ) ;; see above
+
+(jdbc/with-db-transaction [t-con db-spec]
+  (let [;; fetch some rows using this connection
+        rows (jdbc/query t-con ["SELECT * FROM table WHERE id = ?" 42])]
+    ;; insert a copy of the first row using the same connection
+    (jdbc/insert! t-con :table (dissoc (first rows) :id))))
+</code></pre><p>If any operation inside <code>with-db-transaction</code> fails (throws an exception), then
+all of the operations performed so far are rolled back. If all the operations
+succeed, then the entire transaction is committed.</p><p>Transactions are not nested (since not all databases support that) so if this is
+used another active transaction, the outer transaction (and connection) are used
+as-is. If the isolation levels of the outer and inner transaction do not match
+you will get an <code>IllegalStateException</code>.</p><p>See also <code>db-set-rollback-only!</code>, <code>db-unset-rollback-only!</code>, and <code>db-is-rollback-only</code>
+for additional control over the commit/rollback behavior of the enclosing transaction.</p><h2 id="using-connection-pooling">Using Connection Pooling</h2><p><code>java.jdbc</code> does not provide connection pooling directly but it is relatively
+easy to add to your project. There are several connection pooling libraries out
+there, but here we will provide instructions for the popular <code>c3p0</code> library.</p><p>The basic idea is to add your chosen connection pooling library to your
+project, import the appropriate class(es), define a function that consumes a
+"database spec" and produces a map containing a <code>:datasource</code> key whose value
+is the constructed pooled <code>DataSource</code> object, then use that hash map in place of your
+bare <code>db-spec</code> variable. You are responsible for creating the pooled data
+source object and passing the map containing it into any functions that need a
+database connection.</p><h3 id="using-the-c3p0-library">Using the c3p0 library</h3><p>For more information on c3p0, consult the <a href="http://www.mchange.com/projects/c3p0/">c3p0
+documentation</a>.</p><p>If you're using Leiningen, you can add the following to your dependencies:</p><pre><code class="clojure">[com.mchange/c3p0 "0.9.5.2"]  ;; check the documentation for latest version
+</code></pre><p>For a Maven-based project, you would add:</p><pre><code class="xml">&lt;dependency&gt;
+  &lt;groupId&gt;com.mchange&lt;/groupId&gt;
+  &lt;artifactId&gt;c3p0&lt;/artifactId&gt;
+  &lt;version&gt;0.9.5.2&lt;/version&gt;
+&lt;/dependency&gt;
+</code></pre><h3 id="create-the-pooled-datasource-from-your-db-spec">Create the pooled datasource from your db-spec</h3><p>Define your <code>db-spec</code> using the long form, for example (for MySQL):</p><pre><code class="clojure">(def db-spec
+  {:classname "com.mysql.jdbc.Driver"
+   :subprotocol "mysql"
+   :subname "//127.0.0.1:3306/mydb"
+   :user "myaccount"
+   :password "secret"})
+</code></pre><p>We have to use the long form here because c3p0 operates on the class name, subprotocol,
+and subname elements. Of course, you don't really need to define a <code>db-spec</code> here
+because you're not going to use it with <code>java.jdbc</code> directly, only with c3p0.</p><p>Import the c3p0 class as part of your namespace declaration, for example:</p><pre><code class="clojure">(ns example.db
+  (:import (com.mchange.v2.c3p0 ComboPooledDataSource)))
+</code></pre><p>Define a function that creates a pooled datasource:</p><pre><code class="clojure">(defn pool
+  [spec]
+  (let [cpds (doto (ComboPooledDataSource.)
+               (.setDriverClass (:classname spec))
+               (.setJdbcUrl (str "jdbc:" (:subprotocol spec) ":" (:subname spec)))
+               (.setUser (:user spec))
+               (.setPassword (:password spec))
+               ;; expire excess connections after 30 minutes of inactivity:
+               (.setMaxIdleTimeExcessConnections (* 30 60))
+               ;; expire connections after 3 hours of inactivity:
+               (.setMaxIdleTime (* 3 60 60)))]
+    {:datasource cpds}))
+</code></pre><p>Now you can create a single connection pool:</p><pre><code class="clojure">(def pooled-db (delay (pool db-spec)))
+
+(defn db-connection [] @pooled-db)
+</code></pre><p>And then call <code>(db-connection)</code> wherever you need access to it. If you're using
+a <a href="https://github.com/stuartsierra/component">component</a> lifecycle for your
+application, you won't need <code>pooled-db</code> or <code>db-connection</code>. You'll just create
+<code>(pool db-spec)</code> as part of your application's initialization and pass it
+around as part of your system configuration.</p>
+
+    <div id="prev-next">
+        
+        <a href="../using_ddl.html">&laquo; java.jdbc - Using DDL and Metadata</a>
+        
+        
+        ||
+        
+        
+        <a href="../../core_typed/home/index.html">core.typed - User Documentation Home &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/java_jdbc/using_ddl.html b/clones/clojure-doc.org/articles/ecosystem/java_jdbc/using_ddl.html
new file mode 100644
index 00000000..2ea8369d
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/java_jdbc/using_ddl.html
@@ -0,0 +1,249 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: java.jdbc - Using DDL and Metadata</title>
+    
+
+<meta name="description" content="Contents">
+
+<meta property="og:description" content="Contents">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/java_jdbc/using_ddl/" />
+<meta property="og:title" content="java.jdbc - Using DDL and Metadata" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/java_jdbc/using_ddl/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>java.jdbc - Using DDL and Metadata</h2>
+    </div>
+    
+    <h2 id="contents">Contents</h2><ul><li><a href="home.html">Overview</a></li><li><a href="using_sql.html">Using SQL</a></li><li><a href="using_ddl.html">Using DDL</a></li><li><a href="reusing_connections.html">Reusing Connections</a></li></ul><h2 id="using-ddl">Using DDL</h2><p>DDL operations can be executed using the <code>db-do-commands</code> function. The general
+approach is:</p><pre><code class="clojure">(jdbc/db-do-commands db-spec [sql-command-1 sql-command-2 .. sql-command-n])
+</code></pre><p>The commands are executed as a single, batched statement, wrapped in a
+transaction. If you want to avoid the transaction, use this approach:</p><pre><code class="clojure">(jdbc/db-do-commands db-spec false [sql-command-1 sql-command-2 .. sql-command-n])
+</code></pre><p>This is necessary for some databases that do not allow DDL operations to be
+wrapped in a transaction.</p><h3 id="creating-tables">Creating tables</h3><p>For the common operations of creating and dropping tables, <code>java.jdbc</code> provides a
+little assistance that recognizes <code>:entities</code> so you can use keywords (or
+strings) and have your chosen naming strategy applied, just as you can for
+several of the SQL functions.</p><pre><code class="clojure">(jdbc/create-table-ddl :fruit
+                       [[:name "varchar(32)" :primary :key]
+                        [:appearance "varchar(32)"]
+                        [:cost :int]
+                        [:grade :real]]
+                       {:table-spec "ENGINE=InnoDB"
+                        :entities clojure.string/upper-case})
+</code></pre><p>This will generate:</p><pre><code class="clojure">CREATE TABLE FRUIT
+    (NAME varchar(32) primary key,
+     APPEARANCE varchar(32),
+     COST int,
+     GRADE real) ENGINE=InnoDB
+</code></pre><p>which you can pass to <code>db-do-commands</code>.</p><p><code>create-table-ddl</code> also supports a <code>conditional?</code> option which can be a simple
+<code>Boolean</code>, which, if <code>true</code>, will add <code>IF NOT EXISTS</code> before the table name. If
+that syntax doesn't work for your database, you can pass a string that will be
+used instead. If that isn't enough, you can pass a function of two arguments:
+the first argument will be the table name and the second argument will be the
+DDL string (this approach is needed for Microsoft SQL Server).</p><h3 id="dropping-tables">Dropping tables</h3><p>Similarly there is a <code>drop-table-ddl</code> function which takes a table name and an
+optional <code>:entities</code> option to generate DDL to drop a table.</p><pre><code class="clojure">(jdbc/drop-table-ddl :fruit) ; drop table fruit
+(jdbc/drop-table-ddl :fruit {:entities clojure.string/upper-case}) ; drop table FRUIT
+</code></pre><p>This will generate:</p><pre><code class="clojure">DROP TABLE FRUIT
+</code></pre><p><code>drop-table-ddl</code> also supports a <code>conditional?</code> option which can be a simple
+<code>Boolean</code>, which, if <code>true</code>, will add <code>IF EXISTS</code> before the table name. If
+that syntax doesn't work for your database, you can pass a string that will be
+used instead. If that isn't enough, you can pass a function of two arguments:
+the first argument will be the table name and the second argument will be the
+DDL string (this approach is needed for Microsoft SQL Server).</p><h2 id="accessing-metadata">Accessing metadata</h2><p><code>java.jdbc</code> provides two functions for working with database metadata:</p><ul><li><code>with-db-metadata</code> for creating an active metadata object backed by an open
+connection</li><li><code>metadata-result</code> for turning metadata results into Clojure data structures</li></ul><p>For example:</p><pre><code class="clojure">(jdbc/with-db-metadata [md db-spec]
+  (jdbc/metadata-result (.getTables md nil nil nil (into-array ["TABLE" "VIEW"]))))
+</code></pre><p>This returns a sequence of maps describing all the tables and views in the
+current database. <code>metadata-result</code> only transforms <code>ResultSet</code> objects, other
+results are returned as-is. <code>metadata-result</code> can also accept an options map
+containing <code>:identifiers</code> and <code>:as-arrays?</code>, like the <code>query</code> function,
+and those options control how the metatadata is transformed and/or returned.</p><p>Both <code>with-db-metadata</code> and <code>metadata-result</code> can accept an options hash map
+which will be passed through various <code>java.jdbc</code> functions (<code>get-connections</code>
+for the former and <code>result-set-seq</code> for the latter).</p>
+
+    <div id="prev-next">
+        
+        <a href="using_sql.html">&laquo; java.jdbc - Manipulating data with SQL</a>
+        
+        
+        ||
+        
+        
+        <a href="reusing_connections.html">java.jdbc - How to reuse database connections &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/java_jdbc/using_ddl/index.html b/clones/clojure-doc.org/articles/ecosystem/java_jdbc/using_ddl/index.html
new file mode 100644
index 00000000..d2bd8d35
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/java_jdbc/using_ddl/index.html
@@ -0,0 +1,249 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: java.jdbc - Using DDL and Metadata</title>
+    
+
+<meta name="description" content="Contents">
+
+<meta property="og:description" content="Contents">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/java_jdbc/using_ddl/" />
+<meta property="og:title" content="java.jdbc - Using DDL and Metadata" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/java_jdbc/using_ddl/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>java.jdbc - Using DDL and Metadata</h2>
+    </div>
+    
+    <h2 id="contents">Contents</h2><ul><li><a href="../home.html">Overview</a></li><li><a href="../using_sql.html">Using SQL</a></li><li><a href="../using_ddl.html">Using DDL</a></li><li><a href="../reusing_connections.html">Reusing Connections</a></li></ul><h2 id="using-ddl">Using DDL</h2><p>DDL operations can be executed using the <code>db-do-commands</code> function. The general
+approach is:</p><pre><code class="clojure">(jdbc/db-do-commands db-spec [sql-command-1 sql-command-2 .. sql-command-n])
+</code></pre><p>The commands are executed as a single, batched statement, wrapped in a
+transaction. If you want to avoid the transaction, use this approach:</p><pre><code class="clojure">(jdbc/db-do-commands db-spec false [sql-command-1 sql-command-2 .. sql-command-n])
+</code></pre><p>This is necessary for some databases that do not allow DDL operations to be
+wrapped in a transaction.</p><h3 id="creating-tables">Creating tables</h3><p>For the common operations of creating and dropping tables, <code>java.jdbc</code> provides a
+little assistance that recognizes <code>:entities</code> so you can use keywords (or
+strings) and have your chosen naming strategy applied, just as you can for
+several of the SQL functions.</p><pre><code class="clojure">(jdbc/create-table-ddl :fruit
+                       [[:name "varchar(32)" :primary :key]
+                        [:appearance "varchar(32)"]
+                        [:cost :int]
+                        [:grade :real]]
+                       {:table-spec "ENGINE=InnoDB"
+                        :entities clojure.string/upper-case})
+</code></pre><p>This will generate:</p><pre><code class="clojure">CREATE TABLE FRUIT
+    (NAME varchar(32) primary key,
+     APPEARANCE varchar(32),
+     COST int,
+     GRADE real) ENGINE=InnoDB
+</code></pre><p>which you can pass to <code>db-do-commands</code>.</p><p><code>create-table-ddl</code> also supports a <code>conditional?</code> option which can be a simple
+<code>Boolean</code>, which, if <code>true</code>, will add <code>IF NOT EXISTS</code> before the table name. If
+that syntax doesn't work for your database, you can pass a string that will be
+used instead. If that isn't enough, you can pass a function of two arguments:
+the first argument will be the table name and the second argument will be the
+DDL string (this approach is needed for Microsoft SQL Server).</p><h3 id="dropping-tables">Dropping tables</h3><p>Similarly there is a <code>drop-table-ddl</code> function which takes a table name and an
+optional <code>:entities</code> option to generate DDL to drop a table.</p><pre><code class="clojure">(jdbc/drop-table-ddl :fruit) ; drop table fruit
+(jdbc/drop-table-ddl :fruit {:entities clojure.string/upper-case}) ; drop table FRUIT
+</code></pre><p>This will generate:</p><pre><code class="clojure">DROP TABLE FRUIT
+</code></pre><p><code>drop-table-ddl</code> also supports a <code>conditional?</code> option which can be a simple
+<code>Boolean</code>, which, if <code>true</code>, will add <code>IF EXISTS</code> before the table name. If
+that syntax doesn't work for your database, you can pass a string that will be
+used instead. If that isn't enough, you can pass a function of two arguments:
+the first argument will be the table name and the second argument will be the
+DDL string (this approach is needed for Microsoft SQL Server).</p><h2 id="accessing-metadata">Accessing metadata</h2><p><code>java.jdbc</code> provides two functions for working with database metadata:</p><ul><li><code>with-db-metadata</code> for creating an active metadata object backed by an open
+connection</li><li><code>metadata-result</code> for turning metadata results into Clojure data structures</li></ul><p>For example:</p><pre><code class="clojure">(jdbc/with-db-metadata [md db-spec]
+  (jdbc/metadata-result (.getTables md nil nil nil (into-array ["TABLE" "VIEW"]))))
+</code></pre><p>This returns a sequence of maps describing all the tables and views in the
+current database. <code>metadata-result</code> only transforms <code>ResultSet</code> objects, other
+results are returned as-is. <code>metadata-result</code> can also accept an options map
+containing <code>:identifiers</code> and <code>:as-arrays?</code>, like the <code>query</code> function,
+and those options control how the metatadata is transformed and/or returned.</p><p>Both <code>with-db-metadata</code> and <code>metadata-result</code> can accept an options hash map
+which will be passed through various <code>java.jdbc</code> functions (<code>get-connections</code>
+for the former and <code>result-set-seq</code> for the latter).</p>
+
+    <div id="prev-next">
+        
+        <a href="../using_sql.html">&laquo; java.jdbc - Manipulating data with SQL</a>
+        
+        
+        ||
+        
+        
+        <a href="../reusing_connections.html">java.jdbc - How to reuse database connections &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/java_jdbc/using_sql.html b/clones/clojure-doc.org/articles/ecosystem/java_jdbc/using_sql.html
new file mode 100644
index 00000000..fb1ccf5f
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/java_jdbc/using_sql.html
@@ -0,0 +1,510 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: java.jdbc - Manipulating data with SQL</title>
+    
+
+<meta name="description" content="Contents">
+
+<meta property="og:description" content="Contents">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/java_jdbc/using_sql/" />
+<meta property="og:title" content="java.jdbc - Manipulating data with SQL" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/java_jdbc/using_sql/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>java.jdbc - Manipulating data with SQL</h2>
+    </div>
+    
+    <h2 id="contents">Contents</h2><ul><li><a href="home.html">Overview</a></li><li><a href="using_sql.html">Using SQL</a></li><li><a href="using_ddl.html">Using DDL</a></li><li><a href="reusing_connections.html">Reusing Connections</a></li></ul><h2 id="using-sql">Using SQL</h2><p>Here are some examples of using <code>java.jdbc</code> to manipulate data with SQL.
+These examples assume a simple table called <code>fruit</code> (see <a href="https://clojure-doc.org/articles/ecosystem/java_jdbc/using_sql/using_ddl/">Using DDL and
+Metadata</a>). These examples all assume the following in your
+<code>ns</code> declaration:</p><pre><code class="clojure">(:require [clojure.java.jdbc :as jdbc])
+</code></pre><h2 id="reading-and-processing-rows">Reading and processing rows</h2><p><code>java.jdbc</code> provides a simple <code>query</code> function to allow you to read rows from
+tables, as well as optionally performing processing on them at the same time.</p><h3 id="reading-rows">Reading rows</h3><p>To obtain a fully realized result set as a sequence of maps, you can use
+<code>query</code> with a vector containing the SQL string and any parameters needed by
+the SQL:</p><pre><code class="clojure">(jdbc/query db-spec ["SELECT * FROM fruit"])
+;; ({:id 1 :name "Apple" :appearance "red" :cost 59 :grade 87}
+;;  {:id 2 :name "Banana" :appearance "yellow" :cost 29 :grade 92.2}
+;;  ...)
+
+(jdbc/query db-spec ["SELECT * FROM fruit WHERE cost &lt; ?" 50])
+;; ({:id 2 :name "Banana" :appearance "yellow" :cost 29 :grade 92.2}
+;;  ...)
+</code></pre><p>You can also return the result set as a sequence of vectors. The first vector
+will contain the column names, and each subsequent vector will represent a row
+of data with values in the same order as the columns.</p><pre><code class="clojure">(jdbc/query db-spec ["SELECT * FROM fruit WHERE cost &lt; ?" 50]
+         {:as-arrays? true})
+;; ([:id :name :appearance :cost :grade]
+;;  [2 "Banana" "yellow" 29 92.2]
+;;  ...)
+</code></pre><h3 id="processing-a-result-set-lazily">Processing a result set lazily</h3><p>Since <code>query</code> returns a fully realized result set, it can be difficult to
+process very large results. Fortunately, <code>java.jdbc</code> provides a number of ways to process a
+large result set lazily while the connection is open, either by passing a function via
+the <code>:result-set-fn</code> option or, since release 0.7.0, via <code>reducible-query</code>.</p><p><strong><code>query</code> and <code>:result-set-fn</code></strong></p><p><em>If you are using release 0.7.0 or later, consider using <code>reducible-query</code> instead -- see below.</em></p><p>For <code>:result-set-fn</code>, the function you pass must force
+realization of the result to avoid the connection closing while the result set
+is still being processed. A <code>reduce</code>-based function is a good choice.</p><pre><code class="clojure">(jdbc/query db-spec ["SELECT * FROM fruit WHERE cost &lt; ?" 50]
+            {:result-set-fn (fn [rs]
+                              (reduce (fn [total row-map]
+                                        (+ total (:cost row-map)))
+                              0 rs))})
+;; produces the total cost of all the cheap fruits: 437
+</code></pre><p>Of course, a simple sum like this could be computed directly in SQL instead:</p><pre><code class="clojure">(jdbc/query db-spec ["SELECT SUM(cost) FROM fruit WHERE cost &lt; ?" 50]
+            {:result-set-fn first})
+;; {:sum(cost) 437}
+</code></pre><p>We know we will only get one row back so passing <code>first</code> to <code>:result-set-fn</code> is
+a quick way to get just that row.</p><p>Remember that if you also specify <code>:as-arrays? true</code>, your result set function
+will be passed a sequence of vectors in which the first vector contains the
+column names and subsequent vectors represent the values in the rows, matching
+the order of the column names.</p><p><strong><code>reducible-query</code></strong></p><p>This is the recommended approach since release 0.7.0 but it does come with a few
+restrictions:</p><p>You cannot use any of the following options that <code>query</code> accepts:
+<code>as-arrays?</code>, <code>:explain</code>, <code>:explain-fn</code>, <code>:result-set-fn</code>, or <code>:row-fn</code>.</p><p>On the other hand, you have access to a much faster way to process result sets:
+you can specify <code>:raw? true</code> and no conversion from Java's <code>ResultSet</code> to
+Clojure's sequence of hash maps will be performed. In particular, it's as if you
+specified <code>:identifiers identity :keywordize? false :qualifier nil</code>, and the
+sequence representation of each row is not available. That means no <code>keys</code>,
+no <code>vals</code>, no <code>seq</code> calls, just simple key lookup (for convenience, you can
+still use keyword lookup for columns, but you can also call <code>get</code> with either a
+string or a keyword).</p><p>So how does this work? <code>reducible-query</code> produces a <code>clojure.lang.IReduce</code> which,
+when reduced with a function <code>f</code>, performs the query and reduces the <code>ResultSet</code>
+using <code>f</code>, opening and closing the connection and/or transaction during the
+reduction. For example:</p><pre><code class="clojure">;; our reducing function requires two arguments: we must provide initial val
+(reduce (fn [total {:keys [cost]}] (+ total cost))
+        0
+        (jdbc/reducible-query db-spec
+                              ["SELECT * FROM fruit WHERE cost &lt; ?" 50]
+                              {:raw? true}))
+;; separating the key selection from the reducing function: we can omit val
+(transduce (map :cost)
+           + ; can be called with 0, 1, or 2 arguments!
+           (jdbc/reducible-query db-spec
+                                 ["SELECT * FROM fruit WHERE cost &lt; ?" 50]
+                                 {:raw? true}))
+;; 437
+</code></pre><p>Since <code>reducible-query</code> doesn't actually run the query until you reduce its result,
+you can create it once and run it as many times as you want. This will avoid the
+overhead of option and parameter validation and handling for repeated reductions,
+since those are performed just once in the call to <code>reducible-query</code>. Note that
+the SQL parameters are fixed by that call, so this only works for running the
+<em>identical</em> query multiple times.</p><p>A reducible companion to <code>result-set-seq</code> also exists, in case you already have
+a Java <code>ResultSet</code> and want to create a <code>clojure.lang.IReduce</code>. <code>reducible-result-set</code>
+accept almost the same options as <code>result-set-seq</code>: <code>identifiers</code>, <code>keywordize?</code>,
+<code>qualifier</code>, and <code>read-columns</code>. It does not accept <code>as-arrays?</code> (for the same
+reason that <code>reducible-query</code> does not). Unlike <code>result-set-seq</code>, which produces
+a lazy sequence that can be consumed multiple times (with the first pass realizing
+it for subsequent passes), <code>reducible-result-set</code> is reducible just once: the
+underlying <code>ResultSet</code> is mutable and is consumed during the first reduction!</p><p>It should go without saying that both <code>reducible-query</code> and
+<code>reducible-result-set</code> respect <code>reduced</code> / <code>reduced?</code>.</p><p><strong>Additional Options?</strong></p><p>Note: some databases require additional options to be passed in to ensure that
+result sets are chunked and lazy. In particular, you may need to pass
+<code>:auto-commit?</code>, set appropriately, as an option to whichever function will open your database
+connection (<code>with-db-connection</code>, <code>with-db-transaction</code>, or the <code>query</code> / <code>reducible-query</code> itself
+if you are passing a bare database spec and expecting <code>query</code> / <code>reducible-query</code> to open and close
+the connection directly). You may also need to specify <code>:fetch-size</code>, <code>:result-type</code>,
+and possibly other options -- consult your database's documentation for the JDBC
+driver you are using.</p><h3 id="processing-each-row-lazily">Processing each row lazily</h3><p>As seen above, using <code>reduce</code>, <code>transduce</code>, etc with a <code>reducible-query</code> allow
+you to easily and efficiently process each row as you process the entire
+result set, but sometimes you just want a sequence of transformed rows.</p><p>We can process each row with the <code>:row-fn</code> option. Again, like with <code>:result-set-fn</code>,
+we pass a function but this time it will be
+invoked on each row, as the result set is realized.</p><pre><code class="clojure">(jdbc/query db-spec ["SELECT name FROM fruit WHERE cost &lt; ?" 50]
+            {:row-fn :name})
+;; ("Apple" "Banana" ...)
+</code></pre><p>The result is still a fully realized sequence, but each row has been
+transformed by the <code>:name</code> function you passed in.</p><p>You can combine this with <code>:result-set-fn</code> to simplify processing of result
+sets:</p><pre><code class="clojure">(jdbc/query db-spec ["SELECT * FROM fruit WHERE cost &lt; ?" 50]
+            {:row-fn :cost
+             :result-set-fn (partial reduce +)})
+;; produces the total cost of all the cheap fruits
+</code></pre><p>or:</p><pre><code class="clojure">(jdbc/query db-spec ["SELECT SUM(cost) AS total FROM fruit WHERE cost &lt; ?" 50]
+            {:row-fn :total
+             :result-set-fn first})
+;; produces the same result, via SQL
+</code></pre><p>Here is an example that manipulates rows to add computed columns:</p><pre><code class="clojure">(defn add-tax [row] (assoc row :tax (* 0.08 (:cost row))))
+
+(jdbc/query db-spec ["SELECT * FROM fruit"]
+            {:row-fn add-tax})
+;; produces all the rows with a new :tax column added
+</code></pre><p>All of the above can be achieved via <code>reducible-query</code> and the appropriate
+reducing function and/or transducer, but with those simple row/result set
+functions, the result is often longer / uglier:</p><pre><code class="clojure">(into [] (map :name) (jdbc/reducible-query db-spec ["SELECT name FROM fruit WHERE cost &lt; ?" 50]))
+(transduce (map :cost) + (jdbc/reducible-query db-spec ["SELECT * FROM fruit WHERE cost &lt; ?" 50]))
+;; :row-fn :total :result-set-fn first left as an exercise for the reader!
+(into [] (map add-tax) (jdbc/reducible-query db-spec ["SELECT * FROM fruit"]))
+</code></pre><p>If the result set is likely to be large and the reduction can use a <code>:raw? true</code>
+result set, <code>reducible-query</code> may be worth the verbosity for the performance gain.</p><h2 id="inserting-data">Inserting data</h2><p>Rows (and partial rows) can be inserted easily using the <code>insert!</code> function.
+You can insert a single row, or multiple rows. Depending on how you call
+<code>insert!</code>, the insertion will be done either through multiple SQL statements or
+through a single, batched SQL statement. That will also determine whether or
+not you get back any generated keys.</p><p>If you need a more complex form of insertion, you can use <code>execute!</code> and, if
+your database / driver supports it, you can pass <code>:return-keys</code> as an option
+to get back the generated keys. As of <code>java.jdbc</code> 0.7.6, this can be a vector
+of column names to return (for drivers that support that) or a simple Boolean.</p><h3 id="inserting-a-row">Inserting a row</h3><p>If you want to insert a single row (or partial row) and get back the generated
+keys, you can use <code>insert!</code> and specify the columns and their values as a map.
+This performs a single insert statement. A single-element sequence containing a
+map of the generated keys will be returned.</p><pre><code class="clojure">(jdbc/insert! db-spec :fruit {:name "Pear" :appearance "green" :cost 99})
+;; returns a database-specific map as the only element of a sequence, e.g.,
+;; ({:generated_key 50}) might be returned for MySQL
+</code></pre><p>Not all databases are able to return generated keys from an insert.</p><h3 id="inserting-multiple-rows">Inserting multiple rows</h3><p>There are two ways to insert multiple rows: as a sequence of maps, or as a
+sequence of vectors. In the former case, multiple inserts will be performed and
+a map of the generated keys will be returned for each insert (as a sequence).
+In the latter case, a single, batched insert will be performed and a sequence
+of row insert counts will be returned (generally a sequence of ones). The latter
+approach is likely to be substantially faster if you are inserting a large number
+of rows.</p><p>If you use <code>insert-multi!</code> and specify each row as a map of columns and their values,
+then you can specify a mixture of complete and partial rows, and you will get
+back the generated keys for each row (assuming the database has that
+capability).</p><pre><code class="clojure">(jdbc/insert-multi! db-spec :fruit
+                    [{:name "Pomegranate" :appearance "fresh" :cost 585}
+                     {:name "Kiwifruit" :grade 93}])
+;; returns a sequence of database-specific maps, e.g., for MySQL:
+;; ({generated_key 51} {generated_key 52})
+</code></pre><p>If you use <code>insert-multi!</code> and specify the columns you wish to insert followed by
+each row as a vector of column values, then you must specify the same columns
+in each row, and you will not get generated keys back, just row counts. If you
+wish to insert complete rows, you may omit the column name vector (passing
+<code>nil</code> instead) but your rows must match the natural order of columns in your
+table so be careful!</p><pre><code class="clojure">(jdbc/insert-multi! db-spec :fruit
+                    nil ; column names not supplied
+                    [[1 "Apple" "red" 59 87]
+                     [2 "Banana" "yellow" 29 92.2]
+                     [3 "Peach" "fuzzy" 139 90.0]
+                     [4 "Orange" "juicy" 89 88.6]])
+;; (1 1 1 1) - row counts modified
+</code></pre><p>It is generally safer to specify the columns you wish to insert so you can
+control the order, and choose to omit certain columns:</p><pre><code class="clojure">(jdbc/insert-multi! db-spec :fruit
+                    [:name :cost]
+                    [["Mango" 722]
+                     ["Feijoa" 441]])
+;; (1 1) - row counts modified
+</code></pre><h2 id="updating-rows">Updating rows</h2><p>If you want to update simple column values in one or more rows based on a
+simple SQL predicate, you can use <code>update!</code> with a map, representing the column
+values to set, and a SQL predicate with parameters. If you need a more complex
+form of update, you can use the <code>execute!</code> function with arbitrary SQL (and
+parameters).</p><pre><code class="clojure">;; update fruit set cost = 49 where grade &lt; ?
+(jdbc/update! db-spec :fruit
+              {:cost 49}
+              ["grade &lt; ?" 75])
+;; produces a sequence of the number of rows updated, e.g., (2)
+</code></pre><p>For a more complex update:</p><pre><code class="clojure">(jdbc/execute! db-spec
+               ["update fruit set cost = ( 2 * grade ) where grade &gt; ?" 50.0])
+;; produces a sequence of the number of rows updated, e.g., (3)
+</code></pre><h2 id="deleting-rows">Deleting rows</h2><p>If you want to delete any rows from a table that match a simple predicate, the
+<code>delete!</code> function can be used.</p><pre><code class="clojure">(jdbc/delete! db-spec :fruit ["grade &lt; ?" 25.0])
+;; produces a sequence of the number of rows deleted, e.g., (1)
+</code></pre><p>You can also use <code>execute!</code> for deleting rows:</p><pre><code class="clojure">(jdbc/execute! db-spec ["DELETE FROM fruit WHERE grade &lt; ?" 25.0])
+;; produces a sequence of the number of rows deleted, e.g., (1)
+</code></pre><h2 id="using-transactions">Using transactions</h2><p>You can write multiple operations in a transaction to ensure they are either
+all performed, or all rolled back.</p><pre><code class="clojure">(jdbc/with-db-transaction [t-con db-spec]
+  (jdbc/update! t-con :fruit
+                {:cost 49}
+                ["grade &lt; ?" 75])
+  (jdbc/execute! t-con
+                 ["update fruit set cost = ( 2 * grade ) where grade &gt; ?" 50.0]))
+</code></pre><p>The <code>with-db-transaction</code> macro creates a transaction-aware connection from the
+database specification and that should be used in the body of the transaction
+code.</p><p>You can specify the transaction isolation level as part of the
+<code>with-db-transction</code> binding:</p><pre><code class="clojure">(jdbc/with-db-transaction [t-con db-spec {:isolation :serializable}]
+  ...)
+</code></pre><p>Possible values for <code>:isolation</code> are <code>:none</code>, <code>:read-committed</code>,
+<code>:read-uncommitted</code>, <code>:repeatable-read</code>, and <code>:serializable</code>. Be aware that not
+all databases support all isolation levels. Inside a transaction, you can call
+<code>get-isolation-level</code> to return the current level.</p><p>In addition, you can also set the current transaction-aware connection to
+rollback, and reset that setting, as well as test whether the connection is
+currently set to rollback, using the following functions:</p><pre><code class="clojure">(jdbc/db-set-rollback-only! t-con)   ; this transaction will rollback instead of commit
+(jdbc/db-unset-rollback-only! t-con) ; this transaction will commit if successful
+(jdbc/db-is-rollback-only t-con)     ; returns true if transaction is set to rollback
+</code></pre><h2 id="updating-or-inserting-rows-conditionally">Updating or Inserting rows conditionally</h2><p><code>java.jdbc</code> does not provide a built-in function for updating existing rows or
+inserting a new row (the older API supported this but the logic was too
+simplistic to be generally useful). If you need that functionality, it can
+sometimes be done like this:</p><pre><code class="clojure">(defn update-or-insert!
+  "Updates columns or inserts a new row in the specified table"
+  [db table row where-clause]
+  (jdbc/with-db-transaction [t-con db]
+    (let [result (jdbc/update! t-con table row where-clause)]
+      (if (zero? (first result))
+        (jdbc/insert! t-con table row)
+        result))))
+
+(update-or-insert! mysql-db :fruit
+                   {:name "Cactus" :appearance "Spiky" :cost 2000}
+                   ["name = ?" "Cactus"])
+;; inserts Cactus (assuming none exists)
+(update-or-insert! mysql-db :fruit
+                   {:name "Cactus" :appearance "Spiky" :cost 2500}
+                   ["name = ?" "Cactus"])
+;; updates the Cactus we just inserted
+</code></pre><p>If the <code>where-clause</code> does not uniquely identify a single row, this will update
+multiple rows which might not be what you want, so be careful!</p><h2 id="exception-handling-and-transaction-rollback">Exception Handling and Transaction Rollback</h2><p>Transactions are rolled back if an exception is thrown, as shown in these
+examples.</p><pre><code class="clojure">(jdbc/with-db-transaction [t-con db-spec]
+  (jdbc/insert-multi! t-con :fruit
+                      [:name :appearance]
+                      [["Grape" "yummy"]
+                       ["Pear" "bruised"]])
+  ;; At this point the insert! call is complete, but the transaction is
+  ;; not. The exception will cause it to roll back leaving the database
+  ;; untouched.
+  (throw (Exception. "sql/test exception")))
+</code></pre><p>As noted above, transactions can also be set explicitly to rollback instead of
+commit:</p><pre><code class="clojure">(jdbc/with-db-transaction [t-con db-spec]
+  (prn "is-rollback-only" (jdbc/db-is-rollback-only t-con))
+  ;; is-rollback-only false
+  (jdbc/db-set-rollback-only! t-con)
+  ;; the following insert will be rolled back when the transaction ends:
+  (jdbc/insert!-multi t-con :fruit
+                      [:name :appearance]
+                      [["Grape" "yummy"]
+                       ["Pear" "bruised"]])
+  (prn "is-rollback-only" (jdbc/db-is-rollback-only t-con))
+  ;; is-rollback-only true
+  ;; the following will display the inserted rows:
+  (jdbc/query t-con ["SELECT * FROM fruit"]
+              :row-fn println))
+(prn)
+;; outside the transaction, the following will show the original rows
+;; without those two inserted inside the (rolled-back) transaction:
+(jdbc/query db-spec ["SELECT * FROM fruit"]
+            :row-fn println)
+</code></pre><h2 id="clojure-identifiers-and-sql-entities">Clojure identifiers and SQL entities</h2><p>As hinted at above, <code>java.jdbc</code> converts SQL entity names in result sets to
+keywords in Clojure by making them lowercase, and converts strings and keywords
+that specify table and column names (in maps) to SQL entities <em>as-is</em> by
+default.</p><p>You can override this behavior by specifying an options map, containing
+<code>:identifiers</code>, <code>:keywordize?</code> and/or <code>:qualifier</code>, on any function that
+returns or transforms a result set,
+and <code>:entities</code>, on any function that transforms Clojure data into SQL.</p><ul><li><code>:identifiers</code> is for converting <code>ResultSet</code> column names to keywords (or strings). It
+defaults to <code>clojure.string/lower-case</code>.</li><li><code>:keywordize?</code> controls whether to convert identifiers to keywords (the default) or not.</li><li><code>:qualifier</code> optionally specifies a namespace to qualify keywords with (when
+<code>:keywordize?</code> is not falsey).</li><li><code>:entities</code> is for converting Clojure keywords/string to SQL entity names. It
+defaults to <code>identity</code> (after calling <code>name</code> on the keyword or string).</li></ul><p>If you want to prevent <code>java.jdbc</code>'s conversion of SQL entity names to lowercase
+in a <code>query</code> result, you can specify <code>:identifiers identity</code>:</p><pre><code class="clojure">(jdbc/query db-spec ["SELECT * FROM mixedTable"]
+            {:identifiers identity})
+;; produces result set with column names exactly as they appear in the DB
+</code></pre><p>It you're working with a database that has underscores in column names, you
+might want to specify a function that converts those to dashes in Clojure
+keywords:</p><pre><code class="clojure">(jdbc/query db-spec ["SELECT * FROM mixedTable"]
+            {:identifiers #(.replace % \_ \-)})
+</code></pre><p>For several databases, you will often want entities to be quoted in some way
+(sometimes referred to as "stropping"). A utility function <code>quoted</code> is provided
+that accepts either a single character, a vector pair of characters, or a keyword
+as a symbolic name for the type of quoting you want (<code>:ansi</code>, <code>:mysql</code>,
+<code>:oracle</code>, <code>:sqlserver</code>), and
+returns a function suitable for use with the <code>:entities</code> option.</p><p>For example:</p><pre><code class="clojure">(jdbc/insert! db-spec :fruit
+              {:name "Apple" :appearance "Round" :cost 99}
+              {:entities (jdbc/quoted \`)}) ; or (jdbc/quoted :mysql)
+</code></pre><p>will execute:</p><pre><code class="clojure">INSERT INTO `fruit` ( `name`, `appearance`, `cost` )
+    VALUES ( ?, ?, ? )
+</code></pre><p>with the parameters <code>"Apple", "Round", "99"</code> whereas:</p><pre><code class="clojure">(jdbc/insert! db-spec :fruit
+              {:name "Apple" :appearance "Round" :cost 99}
+              {:entities (jdbc/quoted [\[ \]])}) ; or (jdbc/quoted :sqlserver)
+</code></pre><p>will execute:</p><pre><code class="clojure">INSERT INTO [fruit] ( [name], [appearance], [cost] )
+    VALUES ( ?, ?, ? )
+</code></pre><p>with the parameters <code>"Apple", "Round", "99"</code>.</p><h2 id="protocol-extensions-for-transforming-values">Protocol extensions for transforming values</h2><p>By default, <code>java.jdbc</code> leaves it up to Java interop and the JDBC driver library
+to perform the appropriate transformations of Clojure values to SQL values and
+vice versa. When Clojure values are passed through to the JDBC driver,
+<code>java.jdbc</code> uses <code>PreparedStatement/setObject</code> for all values by default. When
+Clojure values are read from a <code>ResultSet</code> they are left untransformed, except
+that <code>Boolean</code> values are coerced to canonical <code>true</code> / <code>false</code> values in
+Clojure (some driver / data type combinations can produce <code>(Boolean. false)</code>
+values otherwise, which do not behave like <code>false</code> in all situations).</p><p><code>java.jdbc</code> provides three protocols that you can extend, in order to modify
+these behaviors.</p><ul><li><code>ISQLValue</code> / <code>sql-value</code> - simple transformations of Clojure values to SQL
+values</li><li><code>ISQLParameter</code> / <code>set-parameter</code> - a more sophisticated transformation of
+Clojure values to SQL values that lets you override how the value is stored
+in the <code>PreparedStatement</code></li><li><code>IResultSetReadColumn</code> / <code>result-set-read-column</code> - simple transformations of
+SQL values to Clojure values when processing a <code>ResultSet</code> object</li></ul><p>If you are using a database that returns certain SQL types as custom Java types
+(e.g., PostgreSQL), you can extend <code>IResultSetReadColumn</code> to that type and
+define <code>result-set-read-column</code> to perform the necessary conversion to a usable
+Clojure data structure. The <code>result-set-read-column</code> function is called with
+three arguments:</p><ul><li>The SQL value itself</li><li>The <code>ResultSet</code> metadata object</li><li>The index of the column in the row / metadata</li></ul><p>By default <code>result-set-read-column</code> just returns its first argument (the
+<code>Boolean</code> implementation ensure the result is either <code>true</code> or <code>false</code>).</p><p>If you are using a database that requires special treatment of null values,
+e.g., TeraData, you can extend <code>ISQLParameter</code> to <code>nil</code> (and <code>Object</code>) and
+define <code>set-parameter</code> to use <code>.setNull</code> instead of <code>.setObject</code>. The
+<code>set-parameter</code> function is called with three arguments:</p><ul><li>The Clojure value itself</li><li>The <code>PreparedStatement</code> object</li><li>The index of the parameter being set</li></ul><p>By default <code>set-parameter</code> calls <code>sql-value</code> on the Clojure value and then
+calls <code>.setObject</code> to store the result of that call into the specified
+parameter in the SQL statement.</p><p>For general transformations of Clojure values to SQL values, extending
+<code>ISQLValue</code> and defining <code>sql-value</code> may be sufficient. The <code>sql-value</code>
+function is called with a single argument: the Clojure value. By default
+<code>sql-value</code> just returns its argument.</p>
+
+    <div id="prev-next">
+        
+        <a href="home.html">&laquo; java.jdbc - Getting Started</a>
+        
+        
+        ||
+        
+        
+        <a href="using_ddl.html">java.jdbc - Using DDL and Metadata &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/java_jdbc/using_sql/index.html b/clones/clojure-doc.org/articles/ecosystem/java_jdbc/using_sql/index.html
new file mode 100644
index 00000000..c51cde3a
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/java_jdbc/using_sql/index.html
@@ -0,0 +1,510 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: java.jdbc - Manipulating data with SQL</title>
+    
+
+<meta name="description" content="Contents">
+
+<meta property="og:description" content="Contents">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/java_jdbc/using_sql/" />
+<meta property="og:title" content="java.jdbc - Manipulating data with SQL" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/java_jdbc/using_sql/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>java.jdbc - Manipulating data with SQL</h2>
+    </div>
+    
+    <h2 id="contents">Contents</h2><ul><li><a href="../home.html">Overview</a></li><li><a href="../using_sql.html">Using SQL</a></li><li><a href="../using_ddl.html">Using DDL</a></li><li><a href="../reusing_connections.html">Reusing Connections</a></li></ul><h2 id="using-sql">Using SQL</h2><p>Here are some examples of using <code>java.jdbc</code> to manipulate data with SQL.
+These examples assume a simple table called <code>fruit</code> (see <a href="https://clojure-doc.org/articles/ecosystem/java_jdbc/using_sql/using_ddl/">Using DDL and
+Metadata</a>). These examples all assume the following in your
+<code>ns</code> declaration:</p><pre><code class="clojure">(:require [clojure.java.jdbc :as jdbc])
+</code></pre><h2 id="reading-and-processing-rows">Reading and processing rows</h2><p><code>java.jdbc</code> provides a simple <code>query</code> function to allow you to read rows from
+tables, as well as optionally performing processing on them at the same time.</p><h3 id="reading-rows">Reading rows</h3><p>To obtain a fully realized result set as a sequence of maps, you can use
+<code>query</code> with a vector containing the SQL string and any parameters needed by
+the SQL:</p><pre><code class="clojure">(jdbc/query db-spec ["SELECT * FROM fruit"])
+;; ({:id 1 :name "Apple" :appearance "red" :cost 59 :grade 87}
+;;  {:id 2 :name "Banana" :appearance "yellow" :cost 29 :grade 92.2}
+;;  ...)
+
+(jdbc/query db-spec ["SELECT * FROM fruit WHERE cost &lt; ?" 50])
+;; ({:id 2 :name "Banana" :appearance "yellow" :cost 29 :grade 92.2}
+;;  ...)
+</code></pre><p>You can also return the result set as a sequence of vectors. The first vector
+will contain the column names, and each subsequent vector will represent a row
+of data with values in the same order as the columns.</p><pre><code class="clojure">(jdbc/query db-spec ["SELECT * FROM fruit WHERE cost &lt; ?" 50]
+         {:as-arrays? true})
+;; ([:id :name :appearance :cost :grade]
+;;  [2 "Banana" "yellow" 29 92.2]
+;;  ...)
+</code></pre><h3 id="processing-a-result-set-lazily">Processing a result set lazily</h3><p>Since <code>query</code> returns a fully realized result set, it can be difficult to
+process very large results. Fortunately, <code>java.jdbc</code> provides a number of ways to process a
+large result set lazily while the connection is open, either by passing a function via
+the <code>:result-set-fn</code> option or, since release 0.7.0, via <code>reducible-query</code>.</p><p><strong><code>query</code> and <code>:result-set-fn</code></strong></p><p><em>If you are using release 0.7.0 or later, consider using <code>reducible-query</code> instead -- see below.</em></p><p>For <code>:result-set-fn</code>, the function you pass must force
+realization of the result to avoid the connection closing while the result set
+is still being processed. A <code>reduce</code>-based function is a good choice.</p><pre><code class="clojure">(jdbc/query db-spec ["SELECT * FROM fruit WHERE cost &lt; ?" 50]
+            {:result-set-fn (fn [rs]
+                              (reduce (fn [total row-map]
+                                        (+ total (:cost row-map)))
+                              0 rs))})
+;; produces the total cost of all the cheap fruits: 437
+</code></pre><p>Of course, a simple sum like this could be computed directly in SQL instead:</p><pre><code class="clojure">(jdbc/query db-spec ["SELECT SUM(cost) FROM fruit WHERE cost &lt; ?" 50]
+            {:result-set-fn first})
+;; {:sum(cost) 437}
+</code></pre><p>We know we will only get one row back so passing <code>first</code> to <code>:result-set-fn</code> is
+a quick way to get just that row.</p><p>Remember that if you also specify <code>:as-arrays? true</code>, your result set function
+will be passed a sequence of vectors in which the first vector contains the
+column names and subsequent vectors represent the values in the rows, matching
+the order of the column names.</p><p><strong><code>reducible-query</code></strong></p><p>This is the recommended approach since release 0.7.0 but it does come with a few
+restrictions:</p><p>You cannot use any of the following options that <code>query</code> accepts:
+<code>as-arrays?</code>, <code>:explain</code>, <code>:explain-fn</code>, <code>:result-set-fn</code>, or <code>:row-fn</code>.</p><p>On the other hand, you have access to a much faster way to process result sets:
+you can specify <code>:raw? true</code> and no conversion from Java's <code>ResultSet</code> to
+Clojure's sequence of hash maps will be performed. In particular, it's as if you
+specified <code>:identifiers identity :keywordize? false :qualifier nil</code>, and the
+sequence representation of each row is not available. That means no <code>keys</code>,
+no <code>vals</code>, no <code>seq</code> calls, just simple key lookup (for convenience, you can
+still use keyword lookup for columns, but you can also call <code>get</code> with either a
+string or a keyword).</p><p>So how does this work? <code>reducible-query</code> produces a <code>clojure.lang.IReduce</code> which,
+when reduced with a function <code>f</code>, performs the query and reduces the <code>ResultSet</code>
+using <code>f</code>, opening and closing the connection and/or transaction during the
+reduction. For example:</p><pre><code class="clojure">;; our reducing function requires two arguments: we must provide initial val
+(reduce (fn [total {:keys [cost]}] (+ total cost))
+        0
+        (jdbc/reducible-query db-spec
+                              ["SELECT * FROM fruit WHERE cost &lt; ?" 50]
+                              {:raw? true}))
+;; separating the key selection from the reducing function: we can omit val
+(transduce (map :cost)
+           + ; can be called with 0, 1, or 2 arguments!
+           (jdbc/reducible-query db-spec
+                                 ["SELECT * FROM fruit WHERE cost &lt; ?" 50]
+                                 {:raw? true}))
+;; 437
+</code></pre><p>Since <code>reducible-query</code> doesn't actually run the query until you reduce its result,
+you can create it once and run it as many times as you want. This will avoid the
+overhead of option and parameter validation and handling for repeated reductions,
+since those are performed just once in the call to <code>reducible-query</code>. Note that
+the SQL parameters are fixed by that call, so this only works for running the
+<em>identical</em> query multiple times.</p><p>A reducible companion to <code>result-set-seq</code> also exists, in case you already have
+a Java <code>ResultSet</code> and want to create a <code>clojure.lang.IReduce</code>. <code>reducible-result-set</code>
+accept almost the same options as <code>result-set-seq</code>: <code>identifiers</code>, <code>keywordize?</code>,
+<code>qualifier</code>, and <code>read-columns</code>. It does not accept <code>as-arrays?</code> (for the same
+reason that <code>reducible-query</code> does not). Unlike <code>result-set-seq</code>, which produces
+a lazy sequence that can be consumed multiple times (with the first pass realizing
+it for subsequent passes), <code>reducible-result-set</code> is reducible just once: the
+underlying <code>ResultSet</code> is mutable and is consumed during the first reduction!</p><p>It should go without saying that both <code>reducible-query</code> and
+<code>reducible-result-set</code> respect <code>reduced</code> / <code>reduced?</code>.</p><p><strong>Additional Options?</strong></p><p>Note: some databases require additional options to be passed in to ensure that
+result sets are chunked and lazy. In particular, you may need to pass
+<code>:auto-commit?</code>, set appropriately, as an option to whichever function will open your database
+connection (<code>with-db-connection</code>, <code>with-db-transaction</code>, or the <code>query</code> / <code>reducible-query</code> itself
+if you are passing a bare database spec and expecting <code>query</code> / <code>reducible-query</code> to open and close
+the connection directly). You may also need to specify <code>:fetch-size</code>, <code>:result-type</code>,
+and possibly other options -- consult your database's documentation for the JDBC
+driver you are using.</p><h3 id="processing-each-row-lazily">Processing each row lazily</h3><p>As seen above, using <code>reduce</code>, <code>transduce</code>, etc with a <code>reducible-query</code> allow
+you to easily and efficiently process each row as you process the entire
+result set, but sometimes you just want a sequence of transformed rows.</p><p>We can process each row with the <code>:row-fn</code> option. Again, like with <code>:result-set-fn</code>,
+we pass a function but this time it will be
+invoked on each row, as the result set is realized.</p><pre><code class="clojure">(jdbc/query db-spec ["SELECT name FROM fruit WHERE cost &lt; ?" 50]
+            {:row-fn :name})
+;; ("Apple" "Banana" ...)
+</code></pre><p>The result is still a fully realized sequence, but each row has been
+transformed by the <code>:name</code> function you passed in.</p><p>You can combine this with <code>:result-set-fn</code> to simplify processing of result
+sets:</p><pre><code class="clojure">(jdbc/query db-spec ["SELECT * FROM fruit WHERE cost &lt; ?" 50]
+            {:row-fn :cost
+             :result-set-fn (partial reduce +)})
+;; produces the total cost of all the cheap fruits
+</code></pre><p>or:</p><pre><code class="clojure">(jdbc/query db-spec ["SELECT SUM(cost) AS total FROM fruit WHERE cost &lt; ?" 50]
+            {:row-fn :total
+             :result-set-fn first})
+;; produces the same result, via SQL
+</code></pre><p>Here is an example that manipulates rows to add computed columns:</p><pre><code class="clojure">(defn add-tax [row] (assoc row :tax (* 0.08 (:cost row))))
+
+(jdbc/query db-spec ["SELECT * FROM fruit"]
+            {:row-fn add-tax})
+;; produces all the rows with a new :tax column added
+</code></pre><p>All of the above can be achieved via <code>reducible-query</code> and the appropriate
+reducing function and/or transducer, but with those simple row/result set
+functions, the result is often longer / uglier:</p><pre><code class="clojure">(into [] (map :name) (jdbc/reducible-query db-spec ["SELECT name FROM fruit WHERE cost &lt; ?" 50]))
+(transduce (map :cost) + (jdbc/reducible-query db-spec ["SELECT * FROM fruit WHERE cost &lt; ?" 50]))
+;; :row-fn :total :result-set-fn first left as an exercise for the reader!
+(into [] (map add-tax) (jdbc/reducible-query db-spec ["SELECT * FROM fruit"]))
+</code></pre><p>If the result set is likely to be large and the reduction can use a <code>:raw? true</code>
+result set, <code>reducible-query</code> may be worth the verbosity for the performance gain.</p><h2 id="inserting-data">Inserting data</h2><p>Rows (and partial rows) can be inserted easily using the <code>insert!</code> function.
+You can insert a single row, or multiple rows. Depending on how you call
+<code>insert!</code>, the insertion will be done either through multiple SQL statements or
+through a single, batched SQL statement. That will also determine whether or
+not you get back any generated keys.</p><p>If you need a more complex form of insertion, you can use <code>execute!</code> and, if
+your database / driver supports it, you can pass <code>:return-keys</code> as an option
+to get back the generated keys. As of <code>java.jdbc</code> 0.7.6, this can be a vector
+of column names to return (for drivers that support that) or a simple Boolean.</p><h3 id="inserting-a-row">Inserting a row</h3><p>If you want to insert a single row (or partial row) and get back the generated
+keys, you can use <code>insert!</code> and specify the columns and their values as a map.
+This performs a single insert statement. A single-element sequence containing a
+map of the generated keys will be returned.</p><pre><code class="clojure">(jdbc/insert! db-spec :fruit {:name "Pear" :appearance "green" :cost 99})
+;; returns a database-specific map as the only element of a sequence, e.g.,
+;; ({:generated_key 50}) might be returned for MySQL
+</code></pre><p>Not all databases are able to return generated keys from an insert.</p><h3 id="inserting-multiple-rows">Inserting multiple rows</h3><p>There are two ways to insert multiple rows: as a sequence of maps, or as a
+sequence of vectors. In the former case, multiple inserts will be performed and
+a map of the generated keys will be returned for each insert (as a sequence).
+In the latter case, a single, batched insert will be performed and a sequence
+of row insert counts will be returned (generally a sequence of ones). The latter
+approach is likely to be substantially faster if you are inserting a large number
+of rows.</p><p>If you use <code>insert-multi!</code> and specify each row as a map of columns and their values,
+then you can specify a mixture of complete and partial rows, and you will get
+back the generated keys for each row (assuming the database has that
+capability).</p><pre><code class="clojure">(jdbc/insert-multi! db-spec :fruit
+                    [{:name "Pomegranate" :appearance "fresh" :cost 585}
+                     {:name "Kiwifruit" :grade 93}])
+;; returns a sequence of database-specific maps, e.g., for MySQL:
+;; ({generated_key 51} {generated_key 52})
+</code></pre><p>If you use <code>insert-multi!</code> and specify the columns you wish to insert followed by
+each row as a vector of column values, then you must specify the same columns
+in each row, and you will not get generated keys back, just row counts. If you
+wish to insert complete rows, you may omit the column name vector (passing
+<code>nil</code> instead) but your rows must match the natural order of columns in your
+table so be careful!</p><pre><code class="clojure">(jdbc/insert-multi! db-spec :fruit
+                    nil ; column names not supplied
+                    [[1 "Apple" "red" 59 87]
+                     [2 "Banana" "yellow" 29 92.2]
+                     [3 "Peach" "fuzzy" 139 90.0]
+                     [4 "Orange" "juicy" 89 88.6]])
+;; (1 1 1 1) - row counts modified
+</code></pre><p>It is generally safer to specify the columns you wish to insert so you can
+control the order, and choose to omit certain columns:</p><pre><code class="clojure">(jdbc/insert-multi! db-spec :fruit
+                    [:name :cost]
+                    [["Mango" 722]
+                     ["Feijoa" 441]])
+;; (1 1) - row counts modified
+</code></pre><h2 id="updating-rows">Updating rows</h2><p>If you want to update simple column values in one or more rows based on a
+simple SQL predicate, you can use <code>update!</code> with a map, representing the column
+values to set, and a SQL predicate with parameters. If you need a more complex
+form of update, you can use the <code>execute!</code> function with arbitrary SQL (and
+parameters).</p><pre><code class="clojure">;; update fruit set cost = 49 where grade &lt; ?
+(jdbc/update! db-spec :fruit
+              {:cost 49}
+              ["grade &lt; ?" 75])
+;; produces a sequence of the number of rows updated, e.g., (2)
+</code></pre><p>For a more complex update:</p><pre><code class="clojure">(jdbc/execute! db-spec
+               ["update fruit set cost = ( 2 * grade ) where grade &gt; ?" 50.0])
+;; produces a sequence of the number of rows updated, e.g., (3)
+</code></pre><h2 id="deleting-rows">Deleting rows</h2><p>If you want to delete any rows from a table that match a simple predicate, the
+<code>delete!</code> function can be used.</p><pre><code class="clojure">(jdbc/delete! db-spec :fruit ["grade &lt; ?" 25.0])
+;; produces a sequence of the number of rows deleted, e.g., (1)
+</code></pre><p>You can also use <code>execute!</code> for deleting rows:</p><pre><code class="clojure">(jdbc/execute! db-spec ["DELETE FROM fruit WHERE grade &lt; ?" 25.0])
+;; produces a sequence of the number of rows deleted, e.g., (1)
+</code></pre><h2 id="using-transactions">Using transactions</h2><p>You can write multiple operations in a transaction to ensure they are either
+all performed, or all rolled back.</p><pre><code class="clojure">(jdbc/with-db-transaction [t-con db-spec]
+  (jdbc/update! t-con :fruit
+                {:cost 49}
+                ["grade &lt; ?" 75])
+  (jdbc/execute! t-con
+                 ["update fruit set cost = ( 2 * grade ) where grade &gt; ?" 50.0]))
+</code></pre><p>The <code>with-db-transaction</code> macro creates a transaction-aware connection from the
+database specification and that should be used in the body of the transaction
+code.</p><p>You can specify the transaction isolation level as part of the
+<code>with-db-transction</code> binding:</p><pre><code class="clojure">(jdbc/with-db-transaction [t-con db-spec {:isolation :serializable}]
+  ...)
+</code></pre><p>Possible values for <code>:isolation</code> are <code>:none</code>, <code>:read-committed</code>,
+<code>:read-uncommitted</code>, <code>:repeatable-read</code>, and <code>:serializable</code>. Be aware that not
+all databases support all isolation levels. Inside a transaction, you can call
+<code>get-isolation-level</code> to return the current level.</p><p>In addition, you can also set the current transaction-aware connection to
+rollback, and reset that setting, as well as test whether the connection is
+currently set to rollback, using the following functions:</p><pre><code class="clojure">(jdbc/db-set-rollback-only! t-con)   ; this transaction will rollback instead of commit
+(jdbc/db-unset-rollback-only! t-con) ; this transaction will commit if successful
+(jdbc/db-is-rollback-only t-con)     ; returns true if transaction is set to rollback
+</code></pre><h2 id="updating-or-inserting-rows-conditionally">Updating or Inserting rows conditionally</h2><p><code>java.jdbc</code> does not provide a built-in function for updating existing rows or
+inserting a new row (the older API supported this but the logic was too
+simplistic to be generally useful). If you need that functionality, it can
+sometimes be done like this:</p><pre><code class="clojure">(defn update-or-insert!
+  "Updates columns or inserts a new row in the specified table"
+  [db table row where-clause]
+  (jdbc/with-db-transaction [t-con db]
+    (let [result (jdbc/update! t-con table row where-clause)]
+      (if (zero? (first result))
+        (jdbc/insert! t-con table row)
+        result))))
+
+(update-or-insert! mysql-db :fruit
+                   {:name "Cactus" :appearance "Spiky" :cost 2000}
+                   ["name = ?" "Cactus"])
+;; inserts Cactus (assuming none exists)
+(update-or-insert! mysql-db :fruit
+                   {:name "Cactus" :appearance "Spiky" :cost 2500}
+                   ["name = ?" "Cactus"])
+;; updates the Cactus we just inserted
+</code></pre><p>If the <code>where-clause</code> does not uniquely identify a single row, this will update
+multiple rows which might not be what you want, so be careful!</p><h2 id="exception-handling-and-transaction-rollback">Exception Handling and Transaction Rollback</h2><p>Transactions are rolled back if an exception is thrown, as shown in these
+examples.</p><pre><code class="clojure">(jdbc/with-db-transaction [t-con db-spec]
+  (jdbc/insert-multi! t-con :fruit
+                      [:name :appearance]
+                      [["Grape" "yummy"]
+                       ["Pear" "bruised"]])
+  ;; At this point the insert! call is complete, but the transaction is
+  ;; not. The exception will cause it to roll back leaving the database
+  ;; untouched.
+  (throw (Exception. "sql/test exception")))
+</code></pre><p>As noted above, transactions can also be set explicitly to rollback instead of
+commit:</p><pre><code class="clojure">(jdbc/with-db-transaction [t-con db-spec]
+  (prn "is-rollback-only" (jdbc/db-is-rollback-only t-con))
+  ;; is-rollback-only false
+  (jdbc/db-set-rollback-only! t-con)
+  ;; the following insert will be rolled back when the transaction ends:
+  (jdbc/insert!-multi t-con :fruit
+                      [:name :appearance]
+                      [["Grape" "yummy"]
+                       ["Pear" "bruised"]])
+  (prn "is-rollback-only" (jdbc/db-is-rollback-only t-con))
+  ;; is-rollback-only true
+  ;; the following will display the inserted rows:
+  (jdbc/query t-con ["SELECT * FROM fruit"]
+              :row-fn println))
+(prn)
+;; outside the transaction, the following will show the original rows
+;; without those two inserted inside the (rolled-back) transaction:
+(jdbc/query db-spec ["SELECT * FROM fruit"]
+            :row-fn println)
+</code></pre><h2 id="clojure-identifiers-and-sql-entities">Clojure identifiers and SQL entities</h2><p>As hinted at above, <code>java.jdbc</code> converts SQL entity names in result sets to
+keywords in Clojure by making them lowercase, and converts strings and keywords
+that specify table and column names (in maps) to SQL entities <em>as-is</em> by
+default.</p><p>You can override this behavior by specifying an options map, containing
+<code>:identifiers</code>, <code>:keywordize?</code> and/or <code>:qualifier</code>, on any function that
+returns or transforms a result set,
+and <code>:entities</code>, on any function that transforms Clojure data into SQL.</p><ul><li><code>:identifiers</code> is for converting <code>ResultSet</code> column names to keywords (or strings). It
+defaults to <code>clojure.string/lower-case</code>.</li><li><code>:keywordize?</code> controls whether to convert identifiers to keywords (the default) or not.</li><li><code>:qualifier</code> optionally specifies a namespace to qualify keywords with (when
+<code>:keywordize?</code> is not falsey).</li><li><code>:entities</code> is for converting Clojure keywords/string to SQL entity names. It
+defaults to <code>identity</code> (after calling <code>name</code> on the keyword or string).</li></ul><p>If you want to prevent <code>java.jdbc</code>'s conversion of SQL entity names to lowercase
+in a <code>query</code> result, you can specify <code>:identifiers identity</code>:</p><pre><code class="clojure">(jdbc/query db-spec ["SELECT * FROM mixedTable"]
+            {:identifiers identity})
+;; produces result set with column names exactly as they appear in the DB
+</code></pre><p>It you're working with a database that has underscores in column names, you
+might want to specify a function that converts those to dashes in Clojure
+keywords:</p><pre><code class="clojure">(jdbc/query db-spec ["SELECT * FROM mixedTable"]
+            {:identifiers #(.replace % \_ \-)})
+</code></pre><p>For several databases, you will often want entities to be quoted in some way
+(sometimes referred to as "stropping"). A utility function <code>quoted</code> is provided
+that accepts either a single character, a vector pair of characters, or a keyword
+as a symbolic name for the type of quoting you want (<code>:ansi</code>, <code>:mysql</code>,
+<code>:oracle</code>, <code>:sqlserver</code>), and
+returns a function suitable for use with the <code>:entities</code> option.</p><p>For example:</p><pre><code class="clojure">(jdbc/insert! db-spec :fruit
+              {:name "Apple" :appearance "Round" :cost 99}
+              {:entities (jdbc/quoted \`)}) ; or (jdbc/quoted :mysql)
+</code></pre><p>will execute:</p><pre><code class="clojure">INSERT INTO `fruit` ( `name`, `appearance`, `cost` )
+    VALUES ( ?, ?, ? )
+</code></pre><p>with the parameters <code>"Apple", "Round", "99"</code> whereas:</p><pre><code class="clojure">(jdbc/insert! db-spec :fruit
+              {:name "Apple" :appearance "Round" :cost 99}
+              {:entities (jdbc/quoted [\[ \]])}) ; or (jdbc/quoted :sqlserver)
+</code></pre><p>will execute:</p><pre><code class="clojure">INSERT INTO [fruit] ( [name], [appearance], [cost] )
+    VALUES ( ?, ?, ? )
+</code></pre><p>with the parameters <code>"Apple", "Round", "99"</code>.</p><h2 id="protocol-extensions-for-transforming-values">Protocol extensions for transforming values</h2><p>By default, <code>java.jdbc</code> leaves it up to Java interop and the JDBC driver library
+to perform the appropriate transformations of Clojure values to SQL values and
+vice versa. When Clojure values are passed through to the JDBC driver,
+<code>java.jdbc</code> uses <code>PreparedStatement/setObject</code> for all values by default. When
+Clojure values are read from a <code>ResultSet</code> they are left untransformed, except
+that <code>Boolean</code> values are coerced to canonical <code>true</code> / <code>false</code> values in
+Clojure (some driver / data type combinations can produce <code>(Boolean. false)</code>
+values otherwise, which do not behave like <code>false</code> in all situations).</p><p><code>java.jdbc</code> provides three protocols that you can extend, in order to modify
+these behaviors.</p><ul><li><code>ISQLValue</code> / <code>sql-value</code> - simple transformations of Clojure values to SQL
+values</li><li><code>ISQLParameter</code> / <code>set-parameter</code> - a more sophisticated transformation of
+Clojure values to SQL values that lets you override how the value is stored
+in the <code>PreparedStatement</code></li><li><code>IResultSetReadColumn</code> / <code>result-set-read-column</code> - simple transformations of
+SQL values to Clojure values when processing a <code>ResultSet</code> object</li></ul><p>If you are using a database that returns certain SQL types as custom Java types
+(e.g., PostgreSQL), you can extend <code>IResultSetReadColumn</code> to that type and
+define <code>result-set-read-column</code> to perform the necessary conversion to a usable
+Clojure data structure. The <code>result-set-read-column</code> function is called with
+three arguments:</p><ul><li>The SQL value itself</li><li>The <code>ResultSet</code> metadata object</li><li>The index of the column in the row / metadata</li></ul><p>By default <code>result-set-read-column</code> just returns its first argument (the
+<code>Boolean</code> implementation ensure the result is either <code>true</code> or <code>false</code>).</p><p>If you are using a database that requires special treatment of null values,
+e.g., TeraData, you can extend <code>ISQLParameter</code> to <code>nil</code> (and <code>Object</code>) and
+define <code>set-parameter</code> to use <code>.setNull</code> instead of <code>.setObject</code>. The
+<code>set-parameter</code> function is called with three arguments:</p><ul><li>The Clojure value itself</li><li>The <code>PreparedStatement</code> object</li><li>The index of the parameter being set</li></ul><p>By default <code>set-parameter</code> calls <code>sql-value</code> on the Clojure value and then
+calls <code>.setObject</code> to store the result of that call into the specified
+parameter in the SQL statement.</p><p>For general transformations of Clojure values to SQL values, extending
+<code>ISQLValue</code> and defining <code>sql-value</code> may be sufficient. The <code>sql-value</code>
+function is called with a single argument: the Clojure value. By default
+<code>sql-value</code> just returns its argument.</p>
+
+    <div id="prev-next">
+        
+        <a href="../home.html">&laquo; java.jdbc - Getting Started</a>
+        
+        
+        ||
+        
+        
+        <a href="../using_ddl.html">java.jdbc - Using DDL and Metadata &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/libraries_authoring/index.html b/clones/clojure-doc.org/articles/ecosystem/libraries_authoring/index.html
new file mode 100644
index 00000000..7f2a1dac
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/libraries_authoring/index.html
@@ -0,0 +1,343 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Library Development and Distribution</title>
+    
+
+<meta name="description" content="This short guide covers how to create your own typical pure Clojure
+library and distribute it to the community via Clojars. It uses
+Clojure 1.4 and Leiningen 2.0-previewX, and requires you have git
+installed (though very little familiarity with git is required).It&#39;s assumed that you&#39;re already somewhat familiar with Clojure. If
+not, see the Getting Started and
+Introduction guides.">
+
+<meta property="og:description" content="This short guide covers how to create your own typical pure Clojure
+library and distribute it to the community via Clojars. It uses
+Clojure 1.4 and Leiningen 2.0-previewX, and requires you have git
+installed (though very little familiarity with git is required).It&#39;s assumed that you&#39;re already somewhat familiar with Clojure. If
+not, see the Getting Started and
+Introduction guides.">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/libraries_authoring/" />
+<meta property="og:title" content="Library Development and Distribution" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/libraries_authoring/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Library Development and Distribution</h2>
+    </div>
+    
+    <p>This short guide covers how to create your own typical pure Clojure
+library and distribute it to the community via Clojars. It uses
+Clojure 1.4 and Leiningen 2.0-previewX, and requires you have git
+installed (though very little familiarity with git is required).</p><p>It's assumed that you're already somewhat familiar with Clojure. If
+not, see the <a href="https://clojure-doc.org/articles/ecosystem/libraries_authoring/getting_started/">Getting Started</a> and
+<a href="https://clojure-doc.org/articles/ecosystem/libraries_authoring/introduction/">Introduction</a> guides.</p><p>For the purposes of this guide, the library we'll be making is named
+"<a href="https://clojars.org/trivial-library-example">trivial-library-example</a>".</p><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons
+Attribution 3.0 Unported License</a> (including images &amp;
+stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on
+Github</a>.</p><h2 id="create-the-project">Create the Project</h2><p>Create your new library project. Names are usually hyphen-separated
+lowercase words:</p><pre><code>lein new trivial-library-example
+cd trivial-library-example
+</code></pre><p>Typical lein usage is <code>lein new &lt;proj-type&gt; &lt;proj-name&gt;</code>, but if you
+leave out <code>&lt;proj-type&gt;</code> (as we've done above), lein defaults to
+creating a library project for you.</p><p>Our trivial library example project will have a dependency on
+<a href="https://clojars.org/org.flatland/useful">flatland's "useful"</a>
+library.</p><p>Open up our new project.clj file and make a few changes:</p><ol><li>Add our dependency (<code>[org.flatland/useful "0.9.0"]</code>) to the <code>:dependencies</code> vector.</li><li>Remove "-SNAPSHOT" from version string.</li><li>Write a short description.</li><li>Add a url (if not a homepage, then where it's source is hosted online).</li><li>If you're using a different license, change the value for <code>:license</code>.</li></ol><p>Regarding your choice of license, probably the three most common for
+Clojure libs (along with a grossly oversimplified blurb (by this
+author) for each) are:</p><ul><li>The <a href="http://directory.fsf.org/wiki/License:EPLv1.0">Eclipse Public License</a> (the default).</li><li>The <a href="http://www.gnu.org/licenses/lgpl.html">LGPL</a> (focused most on
+code and additions always being free; includes language addressing
+s/w patent concerns). See the <a href="http://www.gnu.org/licenses/license-recommendations.html">FSF's recommendations</a> and their
+<a href="http://www.gnu.org/licenses/gpl-howto.html">instructions for use</a>.</li><li>The <a href="http://opensource.org/licenses/MIT">MIT</a> License (focused most on the user's freedom to do what
+they want with the code). The FSF calls this the <a href="http://directory.fsf.org/wiki/License:Expat">"Expat"
+License</a>.</li></ul><p>Whichever one you choose, update your project.clj (if necessary) to
+reflect that choice and save the text of the license as a file named
+"LICENSE" or "COPYING" in your project directory.</p><h3 id="a-note-regarding-project-naming">A Note Regarding Project Naming</h3><p>The top line of your project.clj includes something like <code>defproject my-project-name</code>.  This means that your project has an <em>artifact-id</em>
+of "my-project-name", but it also implies a <em>group-id</em> of
+"my-project-name" (group-id = artifact-id).</p><p>The artifact-id is the name of your project. The group-id is used for
+namespacing (not the same thing as Clojure namespaces) --- it
+identifies to which group/organization a project belongs. Some
+examples of group-id's: clojurewerkz, sonian, and org.<em>your-domain</em>.</p><p>You may choose to explicitly use a group-id for your project, if you
+like. For example:</p><pre><code>(defproject org.my-domain/my-project-name ...
+...)
+</code></pre><p>The maintainers of Clojars
+<a href="https://github.com/clojars/clojars-web/wiki/Verified-Group-Names">require that new libs be published using verified groups</a>,
+such as org.my-domain.</p><p>Read more about groups at
+<a href="https://github.com/clojars/clojars-web/wiki/Groups">https://github.com/clojars/clojars-web/wiki/Groups</a>.</p><h2 id="update-the-readme">Update the README</h2><p>Aside from providing a good overview, rationale, and introduction at
+the top, you're encouraged to provide some usage examples as well.  A
+link to the lib's (future) Clojars page (which we'll get to below)
+might also be appreciated. Add acknowledgements near the end, if
+appropriate.  Adjust the copyright and license info at the bottom of
+the README as needed.</p><p>Lein provides you with a doc directory and a starter doc/intro.md
+file. If you find that you have more to say than will comfortably fit
+into the README.md, consider moving content into the doc dir.</p><p>Other goodies you might include in your README.md or doc/*.md files:
+tutorial, news, bugs, limitations, alternatives, troubleshooting,
+configuration.</p><p>Note that you generally won't add hand-written API documentation into
+your readme or other docs, as there are tools for creating that
+directly from your source (discussed later).</p><h2 id="create-your-projects-local-git-repository">Create your project's local git repository</h2><p>Before going much further, you probably want to get your project under
+version control. Make sure you've got git installed and configured to
+know your name and email address (i.e., that at some point you've run
+<code>git config --global user.name "Your Name"</code> and <code>git config --global user.email "your-email@somewhere.org"</code>).</p><p>Then, in your project dir, run:</p><pre><code>git init
+git add .
+git commit -m "The initial commit."
+</code></pre><p>At any time after you've made changes and want to inspect them and
+commit them to the repository:</p><pre><code>git diff
+git add -p
+git commit -m "The commit message."
+</code></pre><h2 id="write-tests">Write Tests</h2><p>In test/trivial_library_example/core_test.clj, add tests as needed.
+An example is provided in there to get you started.</p><h2 id="write-code">Write Code</h2><p>Write code to make your tests pass.</p><p>Remember to add a note at the top of each file indicating copyright
+and the license under which the code is distributed.</p><h2 id="run-tests">Run Tests</h2><p>In your project dir:</p><pre><code>lein test
+</code></pre><h2 id="commit-any-remaining-changes">Commit any remaining changes</h2><p>Before continuing to the next step, make sure all tests pass and
+you've committed all your changes. Check to see the status of your
+repo at any time with <code>git status</code> and view changes with <code>git diff</code>.</p><h2 id="create-github-project-and-upload-there">Create github project and Upload there</h2><p>This guide makes use of <a href="https://github.com/">github</a> to host your
+project code. If you don't already have a github account, create one,
+then log into it. Github provides good documentation on how to <a href="https://help.github.com/articles/set-up-git">get
+started</a> and how to
+<a href="https://help.github.com/articles/generating-ssh-keys">create an SSH key
+pair</a>. If you
+haven't already done so, get that set up before continuing.</p><p>Create a new repo there for your project using the icon/button/link
+near the top-right.</p><blockquote><p>You will have your local repository, and also a remote duplicate of
+it at github.</p></blockquote><p>For the repository name, use the same name as your project directory.
+Provide a one-line description and hit "Create repository".</p><p>Once this remote repo has been created, follow the instructions on the
+resulting page to "Push an existing repository from the command
+line". You'll of course run the <code>git</code> commands from your project
+directory:</p><pre><code>git remote add origin git@github.com:uvtc/trivial-library-example.git
+git push -u origin master
+</code></pre><p>You can now access your online repo. For this tutorial, it's
+<a href="https://github.com/uvtc/trivial-library-example">https://github.com/uvtc/trivial-library-example</a>.</p><p>Any changes you commit to your local repository can now be pushed
+to the remote one at github:</p><pre><code class="bash"># work work work
+git add -p
+git commit -m "commit message here"
+git push
+</code></pre><h2 id="create-a-gpg-key-for-signing-your-releases">Create a GPG key for signing your releases</h2><p>You'll need to create a <a href="http://www.gnupg.org/">gpg</a> key pair, which
+will be used by lein to sign any release you make to Clojars. Make
+sure you've got gpg installed and kick the tires:</p><pre><code>gpg --list-keys
+</code></pre><p>(The first time that command is run, you'll see some notices about
+it creating necessary files in your home dir.)</p><p>To create a key pair:</p><pre><code>gpg --gen-key
+</code></pre><p>Take the default key type (RSA and RSA), and default key size (2048).
+When asked for how long the key should remain valid, choose a year or
+two. Give it your real name and email address. When it prompts you for
+a comment, you might add one as it can be helpful if you have multiple
+keys to keep track of. When prompted for a passphrase, come up with one
+that is different from the one used with your ssh key.</p><p>When gpg has completed generating your keypair, you can have it list
+what keys it knows about:</p><pre><code>gpg --list-keys
+</code></pre><p>We'll use that public key in the next section.</p><h2 id="upload-to-clojars">Upload to Clojars</h2><p>If you don't already have an account at <a href="https://clojars.org/">https://clojars.org/</a>, create
+one. After doing so, you'll need to supply your ssh and gpg public
+keys to Clojars.  For the ssh public key, you can use the same one as
+used with github. For the gpg public key, get it by running:</p><pre><code>gpg --export -a &lt;your-key-id&gt;
+</code></pre><p>where <code>&lt;your-key-id&gt;</code> is in the output of <code>gpg --list-keys</code> (the
+8-character part following the forward slash on the line starting with
+"pub"). Copy/paste that output (including the "-----BEGIN PGP PUBLIC
+KEY BLOCK-----" and "-----END PGP PUBLIC KEY BLOCK-----") into the
+form on your Clojars profile page.</p><p>For more info on working with Clojars, see <a href="https://github.com/clojars/clojars-web/wiki/About">the Clojars
+wiki</a>.</p><p>Once your Clojars account is all set up, and it has your public keys,
+upload your library to Clojars like so:</p><pre><code>lein deploy clojars
+</code></pre><p>You will be asked for your (Clojars) username and password.</p><p>Then you'll be asked for your gpg passphrase. (You won't be asked for
+your ssh passphrase because <code>lein deploy clojars</code> uses http rather
+than scp --- though Clojars supports both.)</p><p>You should now be able to see your lib's Clojars page: for example,
+<a href="https://clojars.org/trivial-library-example">https://clojars.org/trivial-library-example</a>!</p><h2 id="generate-api-docs-optional">Generate API docs (optional)</h2><p>For larger library projects, you may want to automatically generate
+API docs (from your docstrings). See
+<a href="https://github.com/weavejester/codox">codox</a>. If your library project
+is hosted at github, you can use <a href="http://pages.github.com/">github
+pages</a> to host the resulting docs.</p><h2 id="announce-optional">Announce (optional)</h2><p>You're welcome to announce the availability of your new library
+on the <a href="https://groups.google.com/forum/?fromgroups#!forum/clojure">Clojure Mailing List</a>.</p><h2 id="make-updates-to-your-library">Make Updates to your library</h2><p>Making updates to your lib follows the same pattern as described above:</p><pre><code class="bash"># work test work test
+# update version string in project.clj
+git add -p
+git commit
+git push
+lein deploy clojars
+</code></pre><p>And optionally announce the release on the ML.</p><h3 id="merging-pull-requests">Merging pull-requests</h3><p>Note that if you receive a pull-request at github, you can easily
+merge those changes into your project (right there, via the web page
+describing the pull-request). Afterwards, update your local repo to
+grab those changes as well:</p><pre><code>git pull
+</code></pre><h2 id="see-also">See Also</h2><p>For more detailed documentation on various aspects of the procedures
+described here, see:</p><ul><li>the <a href="https://github.com/clojars/clojars-web/wiki">Clojars wiki</a></li><li>the
+<a href="https://github.com/technomancy/leiningen/blob/master/doc/TUTORIAL.md">Leiningen tutorial</a>
+and <a href="https://github.com/technomancy/leiningen/blob/master/doc/DEPLOY.md">deploy
+guide</a></li></ul><h2 id="contributors">Contributors</h2><p>John Gabriele <a href="mailto:jmg3000@gmail.com">jmg3000@gmail.com</a> (original author)</p>
+
+    <div id="prev-next">
+        
+        <a href="../libraries_directory/index.html">&laquo; A Directory of Clojure Libraries</a>
+        
+        
+        ||
+        
+        
+        <a href="../generating_documentation/index.html">Generating Documentation &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/libraries_directory/index.html b/clones/clojure-doc.org/articles/ecosystem/libraries_directory/index.html
new file mode 100644
index 00000000..1dc8be4e
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/libraries_directory/index.html
@@ -0,0 +1,239 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: A Directory of Clojure Libraries</title>
+    
+
+<meta name="description" content="This is a categorized and annotated directory of available Clojure
+libraries and tools. This directory is not comprehensive and is necessarily highly opinionated.This directory is manually curated by the Clojure community. Please endeavor to keep it up-to-date,
+consisting of high quality libraries with adequate documentation. There are many more libraries in the Clojure
+ecosystem, but some lack documentation and/or are useful primarily to experienced developers and such projects
+are not included in this document.">
+
+<meta property="og:description" content="This is a categorized and annotated directory of available Clojure
+libraries and tools. This directory is not comprehensive and is necessarily highly opinionated.This directory is manually curated by the Clojure community. Please endeavor to keep it up-to-date,
+consisting of high quality libraries with adequate documentation. There are many more libraries in the Clojure
+ecosystem, but some lack documentation and/or are useful primarily to experienced developers and such projects
+are not included in this document.">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/libraries_directory/" />
+<meta property="og:title" content="A Directory of Clojure Libraries" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/libraries_directory/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>A Directory of Clojure Libraries</h2>
+    </div>
+    
+    <p>This is a categorized and annotated directory of available Clojure
+libraries and tools. This directory is <strong>not comprehensive and is necessarily highly opinionated</strong>.</p><p>This directory is manually curated by the Clojure community. Please endeavor to keep it up-to-date,
+consisting of <strong>high quality</strong> libraries with adequate documentation. There are many more libraries in the Clojure
+ecosystem, but some lack documentation and/or are useful primarily to experienced developers and such projects
+are not included in this document.</p><p>For more comprehensive overview of the Clojure library ecosystem, please see <a href="http://clojuresphere.com/">ClojureSphere</a>.</p><h2 id="support-libraries">Support Libraries</h2><h3 id="general">General</h3><ul><li><p><a href="https://github.com/clj-commons/useful">useful</a> (<a href="https://clojars.org/org.flatland/useful">at clojars</a>)</p></li><li><p><a href="https://github.com/clojurewerkz/support">ClojureWerkz Support</a> (<a href="https://clojars.org/clojurewerkz/support">at clojars</a>)</p></li><li><p><a href="https://github.com/weavejester/medley">medley</a> (<a href="https://clojars.org/medley">at clojars</a>)</p></li></ul><h2 id="applications--environment">Applications &amp; Environment</h2><ul><li><p><a href="https://github.com/clojure/tools.cli">tools.cli</a>: a command line argument parser for Clojure</p></li><li><p><a href="https://clojars.org/environ">environ</a>: Manage environment settings from a number of different sources</p></li><li><p><a href="https://github.com/sonian/carica">carica</a> (<a href="https://clojars.org/sonian/carica">at clojars</a>):
+Flexible config file usage &amp; management library.</p></li></ul><h2 id="date-and-time">Date and Time</h2><ul><li><a href="https://clojars.org/clj-time">clj-time</a>: A date and time library for Clojure</li></ul><h2 id="testing">Testing</h2><ul><li><p><a href="http://clojure.github.com/clojure/clojure.test-api.html">clojure.test</a>: the standard unit testing library that ships with Clojure</p></li><li><p><a href="https://clojars.org/midje">Midje</a>: a more featureful test framework</p></li><li><p><a href="https://github.com/lshift/cloverage">cloverage</a>: a test-coverage tool (lein plug-in)</p></li><li><p><a href="https://github.com/jaycfields/expectations">expectations</a> (<a href="https://clojars.org/expectations">at clojars</a>): a minimalist's testing framework</p></li><li><p><a href="https://github.com/clojure/test.generative">test.generative</a>: generative testing, a la QuickCheck</p></li><li><p><a href="https://github.com/amitrathore/conjure">conjure</a> (<a href="https://clojars.org/org.clojars.runa/conjure">at clojars</a>):
+mocking and stubbing for unit tests.</p></li></ul><h2 id="namespaces-and-code-as-data">Namespaces and Code-as-Data</h2><ul><li><p><a href="https://github.com/clojure/tools.namespace">tools.namespace</a></p></li><li><p><a href="https://github.com/Raynes/bultitude">builtitude</a> (<a href="https://clojars.org/bultitude">at clojars</a>)</p></li><li><p><a href="https://github.com/Raynes/findfn">findfn</a> (<a href="https://clojars.org/findfn">at clojars</a>)</p></li><li><p><a href="https://github.com/weavejester/ns-tracker">ns-tracker</a> (<a href="https://clojars.org/ns-tracker">at clojars</a>)</p></li></ul><h2 id="serialization">Serialization</h2><h3 id="json">JSON</h3><ul><li><p><a href="https://github.com/dakrone/cheshire/">cheshire</a> (<a href="https://clojars.org/cheshire">at clojars</a>): very efficient Clojure JSON and SMILE (binary JSON) encoding/decoding.</p></li><li><p><a href="https://github.com/clojure/data.json">data.json</a>: JSON parser/generator to/from Clojure data structures.</p></li></ul><h3 id="protocol-buffers">Protocol Buffers</h3><ul><li><a href="https://github.com/flatland/clojure-protobuf">clojure-protobuf</a> (<a href="https://clojars.org/protobuf">at clojars</a>): a Clojure interface to Google's protocol buffers</li></ul><h3 id="kryo">Kryo</h3><ul><li><a href="https://github.com/revelytix/carbonite">carbonite</a></li></ul><h3 id="clojure-reader">Clojure Reader</h3><ul><li><a href="https://github.com/ptaoussanis/nippy">Nippy</a> (<a href="https://clojars.org/nippy">at clojars</a>): a more efficient implementation of the Clojure reader</li></ul><h3 id="xml">XML</h3><ul><li><a href="https://github.com/clojure/data.xml">data.xml</a>: a library for reading and writing XML</li></ul><h3 id="binary-formats">Binary Formats</h3><ul><li><a href="https://github.com/ztellman/gloss">gloss</a> (<a href="https://clojars.org/gloss">at clojars</a>): turns complicated byte formats into Clojure data structures</li></ul><h2 id="file-formats">File formats</h2><ul><li><p><a href="https://clojars.org/clj-pdf">clj-pdf</a>: a library for easily generating PDFs from Clojure</p></li><li><p><a href="https://github.com/michaelklishin/pantomime">Pantomime</a> (<a href="https://clojars.org/pantomime">at clojars</a>): a tiny Clojure library that deals with Internet media types (MIME types) and content type detection</p></li><li><p><a href="https://github.com/clojure/data.csv">data.csv</a>: a CSV parser</p></li></ul><h2 id="templating">Templating</h2><ul><li><p><a href="https://clojars.org/stencil">Stencil</a>: <a href="http://mustache.github.com/">Mustache</a> for Clojure (logic-less templates). Fast.</p></li><li><p><a href="https://clojars.org/de.ubercode.clostache/clostache">Clostache</a>: another nice <a href="http://mustache.github.com/">Mustache</a> implementation</p></li></ul><h2 id="http">HTTP</h2><h3 id="clientserver">Client/Server</h3><ul><li><a href="http://http-kit.org/">HTTP Kit</a> (<a href="https://clojars.org/http-kit">at
+clojars</a>): High-performance
+event-driven HTTP client/server for Clojure.</li></ul><h3 id="client">Client</h3><ul><li><p><a href="https://github.com/dakrone/clj-http">clj-http</a> (<a href="https://clojars.org/clj-http">at clojars</a>): An idiomatic Clojure http client wrapping the apache client.</p></li><li><p><a href="https://github.com/hiredman/clj-http-lite">clj-http-lite</a> (<a href="https://clojars.org/clj-http-lite">at clojars</a>): A lightweight version of clj-http having almost same API, but without any Apache dependencies.</p></li></ul><h2 id="logging">Logging</h2><ul><li><p><a href="https://clojars.org/com.taoensso/timbre">Timbre</a>:
+Simple, flexible, all-Clojure logging. No XML!</p></li><li><p><a href="https://github.com/clojure/tools.logging/">tools.logging</a>: standard general-purpose logging.</p></li><li><p><a href="https://clojars.org/clj-log">clj-log</a>: s-expression logger.</p></li></ul><h2 id="web-development">Web Development</h2><h3 id="web-services">Web Services</h3><ul><li><p><a href="https://github.com/ring-clojure">Ring</a> (<a href="https://clojars.org/ring">at clojars</a>): foundational
+web application library</p></li><li><p><a href="https://github.com/weavejester/compojure">Compojure</a> (<a href="https://clojars.org/compojure">at clojars</a>):
+concise routing library for Ring</p></li><li><p><a href="http://pedestal.io/">Pedestal</a> (<a href="https://clojars.org/search?q=pedestal">at clojars</a>):
+an open source tool set for building web applications in Clojure</p></li><li><p><a href="http://www.luminusweb.net/">Luminus</a>: lein template for creating batteries-included
+web applications using Ring, Compojure, lib-noir, and other libraries.</p></li><li><p><a href="https://github.com/clojure-liberator/liberator">Liberator</a> (<a href="https://clojars.org/liberator">at clojars</a>): a Clojure library for building RESTful applications</p></li><li><p><a href="https://github.com/cemerick/friend">friend</a> (<a href="https://clojars.org/com.cemerick/friend">at clojars</a>): Authentication and authorization library for Web apps</p></li></ul><h3 id="html-generation">HTML Generation</h3><ul><li><p><a href="https://clojars.org/hiccup">hiccup</a>: Generates HTML from Clojure data structures.</p></li><li><p><a href="https://github.com/davidsantiago/stencil">Stencil</a>: Implements the Mustache templating language.</p></li><li><p><a href="https://clojars.org/markdown-clj">markdown-clj</a>: Clojure based Markdown parsers for both Clojure and ClojureScript.</p></li></ul><h3 id="html-parsers">HTML Parsers</h3><ul><li><p><a href="https://clojars.org/crouton">Crouton</a>: A Clojure wrapper for the JSoup HTML and XML parser that handles real world inputs</p></li><li><p><a href="https://github.com/michaelklishin/crawlista">Crawlista</a> (<a href="https://clojars.org/clojurewerkz/crawlista">at clojars</a>): a support library for applications that crawl the Web</p></li><li><p><a href="http://home.ccil.org/~cowan/XML/tagsoup/">TagSoup</a>: a tool for parsing html as it's found in the wild: poor, nasty, and brutish.</p></li></ul><h3 id="data-validation">Data Validation</h3><ul><li><p><a href="http://clojurevalidations.info">Validateur</a> (<a href="https://clojars.org/com.novemberain/validateur">at clojars</a>): functional validations library inspired by Ruby's ActiveModel</p></li><li><p><a href="https://github.com/mylesmegyesi/metis">Metis</a>: another validations library inspired by Ruby's ActiveModel</p></li><li><p><a href="https://github.com/runa-dev/clj-schema">Clj-Schema</a> (<a href="https://clojars.org/org.clojars.runa/clj-schema">at clojars</a>): Schemas for Clojure Data: validation and test data generators</p></li></ul><h3 id="uris-urls">URIs, URLs</h3><ul><li><p><a href="https://github.com/michaelklishin/urly">Urly</a> (<a href="https://clojars.org/clojurewerkz/urly">at clojars</a>): unifies <code>java.net.URL</code>, <code>java.net.URI</code> and string URIs, provides parsing and manipulation helpers</p></li><li><p><a href="https://github.com/wtetzner/exploding-fish">Exploding Fish</a> (<a href="https://clojars.org/org.bovinegenius/exploding-fish">at clojars</a>): a URI library for Clojure</p></li><li><p><a href="https://github.com/clojurewerkz/route-one">route-one</a> (<a href="https://clojars.org/clojurewerkz/route-one">at clojars</a>): a tiny Clojure library that generates HTTP resource routes (as in Ruby on Rails, Jersey, and so on)</p></li></ul><h3 id="internationalization-i18n-localization-l10n">Internationalization (i18n), Localization (l10n)</h3><ul><li><a href="https://github.com/ptaoussanis/tower">Tower</a> (<a href="https://clojars.org/tower">at clojars</a>): a simple, idiomatic internationalization and localization story for Clojure</li></ul><h3 id="rss">RSS</h3><ul><li><a href="https://clojars.org/clj-rss">clj-rss</a>: RSS feed generation library</li></ul><h2 id="data-stores">Data Stores</h2><h3 id="relational-databases-jdbc">Relational Databases, JDBC</h3><ul><li><p><a href="https://github.com/clojure/java.jdbc">java.jdbc</a>: Basic wrapper for JDBC. Works with all JDBC databases (MySQL, PostgreSQL, Oracle, SQL Server, etc).</p></li><li><p><a href="https://clojars.org/korma">Korma</a>: <a href="http://sqlkorma.com/docs">"Tasty SQL for Clojure"</a></p></li></ul><h3 id="couchdb">CouchDB</h3><ul><li><a href="https://github.com/clojure-clutch/clutch">Clutch</a> (<a href="https://clojars.org/com.ashafa/clutch">at clojars</a>): <a href="http://couchdb.apache.org/">Apache CouchDB</a> client.</li></ul><h3 id="mongodb">MongoDB</h3><ul><li><p><a href="https://clojuremongodb.info">Monger</a> (<a href="https://clojars.org/com.novemberain/monger">at clojars</a>): Monger is an idiomatic Clojure MongoDB driver for a more civilized age with solid documentation</p></li><li><p><a href="https://github.com/aboekhoff/congomongo">congomongo</a> (<a href="https://clojars.org/congomongo">at clojars</a>): Basic wrapper for the MongoDB Java driver</p></li><li><p><a href="https://github.com/yuushimizu/Mongoika">Mongoika</a> (<a href="https://clojars.org/mongoika">at clojars</a>)</p></li></ul><h3 id="riak">Riak</h3><ul><li><a href="https://clojureriak.info">Welle</a> (<a href="https://clojars.org/com.novemberain/welle">at clojars</a>): An expressive Clojure client for Riak with solid documentation</li></ul><h3 id="redis">Redis</h3><ul><li><a href="https://github.com/ptaoussanis/carmine">Carmine</a> (<a href="https://clojars.org/com.taoensso/carmine">at clojars</a>): a great Clojure client for Redis</li></ul><h3 id="graph-databases-neo4j-titan-etc">Graph Databases (Neo4J, Titan, etc)</h3><ul><li><p><a href="https://clojureneo4j.info">Neocons</a> (<a href="https://clojars.org/clojurewerkz/neocons">at clojars</a>): Neocons is a feature rich idiomatic <a href="http://clojureneo4j.info">Clojure client for the Neo4J REST API</a>  with solid documentation</p></li><li><p><a href="http://titanium.clojurewerkz.org">Titanium</a> (<a href="https://clojars.org/clojurewerkz/titanium">at clojars</a>):
+a Clojure graph library built on top of Titan</p></li><li><p><a href="https://github.com/zmaril/archimedes">Archimedes</a> (<a href="https://clojars.org/zmaril/archimedes">at clojars</a>):
+a Clojure wrapper for Tinkerpop Blueprints</p></li><li><p><a href="https://github.com/zmaril/ogre">Ogre</a> (<a href="https://clojars.org/zmaril/ogre">at clojars</a>):
+a Clojure library for querying Tinkerpop graphs</p></li><li><p><a href="https://github.com/wagjo/borneo">Borneo</a> (<a href="https://clojars.org/borneo">at clojars</a>)</p></li></ul><h3 id="elasticsearch">ElasticSearch</h3><ul><li><p><a href="http://clojureelasticsearch.info">Elastisch</a> (<a href="https://clojars.org/clojurewerkz/elastisch">at clojars</a>): Elastisch is a minimalistic Clojure client for <a href="http://elasticsearch.org">ElasticSearch</a> with solid documentation.</p></li><li><p><a href="https://github.com/drewr/esperanto">Esperanto</a></p></li></ul><h3 id="memcached-couchbase-kestrel">Memcached, Couchbase, Kestrel</h3><ul><li><a href="http://clojurememcached.info">Spyglass</a> (<a href="https://clojars.org/clojurewerkz/spyglass">at clojars</a>): Spyglass is a very fast Clojure client for Memcached and Couchbase with solid documentation</li></ul><h3 id="apache-cassandra">Apache Cassandra</h3><ul><li><p><a href="https://github.com/clojurewerkz/cassaforte">Cassaforte</a> (<a href="https://clojars.org/clojurewerkz/cassaforte">at clojars</a>): A young Clojure client for Apache Cassandra</p></li><li><p><a href="https://github.com/pingles/clj-hector">clj-hector</a> (<a href="https://clojars.org/org.clojars.paul/clj-hector">at clojars</a>): A simple Clojure client for Cassandra that wraps Hector</p></li><li><p><a href="https://github.com/mpenet/alia">Alia</a> (<a href="https://clojars.org/cc.qbits/alia">at clojars</a>): Cassandra CQL3 client for Clojure, <a href="https://github.com/datastax/java-driver">datastax/java-driver</a> wrapper</p></li><li><p><a href="https://github.com/SMX-LTD/ccm-clj">ccm-clj</a> (<a href="https://clojars.org/com.smxemail/ccm-clj">at clojars</a>: Clojure interface to the Cassandra Cluster Manager, <a href="https://github.com/pcmanus/ccm">ccm</a></p></li></ul><h3 id="amazon-dynamodb">Amazon DynamoDB</h3><ul><li><a href="https://github.com/weavejester/rotary">Rotary</a> (<a href="https://clojars.org/rotary">at clojars</a>)</li></ul><h3 id="tokyo-cabinet">Tokyo Cabinet</h3><ul><li><a href="https://github.com/flatland/tokyocabinet">tokyocabinet</a> (<a href="https://clojars.org/tokyocabinet">at clojars</a>): native Tokyo Cabinet interface for Clojure</li></ul><h3 id="misc">Misc</h3><ul><li><p><a href="https://github.com/flatland/masai">masai</a> (<a href="https://clojars.org/masai">at clojars</a>): a very simple interface to a number of key-value stores</p></li><li><p><a href="https://github.com/flatland/jiraph">jiraph</a> (<a href="https://clojars.org/jiraph">at clojars</a>): a reasonably licensed embedded graph database with swappable backends</p></li></ul><h2 id="networking">Networking</h2><ul><li><p><a href="https://github.com/ztellman/lamina">Lamina</a> (<a href="https://clojars.org/lamina">at clojars</a>): event-driven workflows in Clojure</p></li><li><p><a href="https://github.com/clj-commons/aleph">Aleph</a> (<a href="https://clojars.org/aleph">at clojars</a>): asynchronous communication in Clojure</p></li></ul><h2 id="application-servers">Application Servers</h2><ul><li><a href="http://immutant.org/">Immutant</a> (<a href="https://clojars.org/org.immutant/immutant">at clojars</a>): a feature rich and integrated application platform for Clojure from Red Hat</li></ul><h2 id="messaging">Messaging</h2><h3 id="rabbitmq">RabbitMQ</h3><ul><li><a href="http://clojurerabbitmq.info">Langohr</a> (<a href="https://clojars.org/com.novemberain/langohr">at clojars</a>): a feature complete RabbitMQ client that embraces AMQP 0.9.1 model and learns from others</li></ul><h3 id="zeromq">ZeroMQ</h3><ul><li><a href="https://github.com/mpenet/jilch">Jilch</a> (<a href="https://clojars.org/jilch">at clojars</a>): Clojure ZeroMQ Library using JeroMQ, no native dependencies</li></ul><h3 id="beanstalk">Beanstalk</h3><ul><li><a href="https://github.com/drsnyder/beanstalk">beanstalk</a> (<a href="https://clojars.org/com.github.drsnyder/beanstalk">at clojars</a>): a Beanstalkd client</li></ul><h3 id="amazon-sqs">Amazon SQS</h3><ul><li><a href="https://github.com/cemerick/bandalore">Bandalore</a>: a Clojure client library for Amazon's Simple Queue Service</li></ul><h3 id="hornetq">HornetQ</h3><ul><li><a href="https://github.com/hugoduncan/hornetq-clj">hornetq-clj</a> (<a href="https://clojars.org/hornetq-clj/client">at clojars</a>): a tiny HornetQ client</li></ul><h2 id="data-processing-computation">Data Processing, Computation</h2><ul><li><p><a href="http://storm-project.net/">Twitter Storm</a> (<a href="https://clojars.org/storm">at clojars</a>): distributed realtime computation system</p></li><li><p><a href="http://www.cascalog.org/">Cascalog</a> (<a href="https://clojars.org/cascalog">at clojars</a>): data processing on Hadoop without the hassle</p></li></ul><h2 id="natural-language-processing">Natural Language Processing</h2><ul><li><a href="https://github.com/dakrone/clojure-opennlp">clojure-opennlp</a> (<a href="https://clojars.org/clojure-opennlp">at clojars</a>)</li></ul><h2 id="parsers-parser-combinators-language-construction">Parsers, Parser Combinators, Language Construction</h2><ul><li><p><a href="https://github.com/Engelberg/instaparse">Instaparse</a> (<a href="https://clojars.org/instaparse">at clojars</a>)</p></li><li><p><a href="https://github.com/blancas/kern">Kern</a> (<a href="https://clojars.org/org.blancas/kern">at clojars</a>)</p></li></ul><h2 id="automation-provisioning-devops-tools">Automation, Provisioning, DevOps Tools</h2><ul><li><p><a href="http://palletops.com/">pallet</a> (<a href="https://clojars.org/pallet">at clojars</a>): a platform for agile and programmatic automation of infrastructure</p></li><li><p><a href="http://www.jclouds.org/">jclouds</a>: unified APIs for dozens of cloud (IaaS) providers</p></li><li><p><a href="https://github.com/mcohen01/amazonica">Amazonica</a>: comprehensive Clojure client for the entire AWS API</p></li><li><p><a href="https://github.com/hugoduncan/clj-ssh">clj-ssh</a> (<a href="https://clojars.org/clj-ssh">at clojars</a>): an SSH client</p></li><li><p><a href="https://github.com/pallet/ssh-transport">ssh-transport</a>: executes commands over SSH</p></li></ul><h2 id="monitoring-metrics">Monitoring, metrics</h2><ul><li><p><a href="https://github.com/sjl/metrics-clojure">metrics-clojure</a> (<a href="https://clojars.org/metrics-clojure">at clojars</a>):
+Clojure library on top of Yammer's Metrics</p></li><li><p><a href="https://github.com/pyr/clj-statsd">clj-statsd</a> (<a href="https://clojars.org/clj-statsd">at clojars</a>): simple client library to interface with statsd</p></li><li><p><a href="https://github.com/heroku/pulse">pulse</a>: Real-time Heroku operations dashboard</p></li><li><p><a href="http://riemann.io">riemann</a> (<a href="https://clojars.org/riemann">at clojars</a>): A network event stream processing system, in Clojure.</p></li></ul><h2 id="io">I/O</h2><h3 id="files-nio-nio2">Files, NIO, NIO2</h3><p>File I/O is covered by the JDK and commonly used via <code>clojure.java.io</code> functions.</p><ul><li><a href="https://github.com/clj-commons/fs">fs</a> (<a href="https://clojars.org/clj-commons/fs">at clojars</a>): utilities for working with the file system</li><li><a href="https://github.com/pjstadig/nio">nio</a>: Clojure library for working with for Java NIO classes</li></ul><h3 id="standard-streams-subprocesses">Standard Streams, Subprocesses</h3><p>Standard streams I/O is covered by the JDK and commonly used via <code>clojure.java.io</code> functions.</p><ul><li><p>clojure.java.shell (part of Clojure distribution): Conveniently launch a sub-process providing
+its stdin and collecting its stdout.</p></li><li><p><a href="https://clojars.org/conch">conch</a>: for shelling out to external programs.
+An alternative to clojure.java.shell.</p></li></ul><h3 id="property-files">Property Files</h3><ul><li><a href="https://github.com/jaycfields/propertea">propertea</a> (<a href="https://clojars.org/propertea">at clojars</a>): painlessly work with property files</li></ul><h3 id="repl-and-terminal">REPL and Terminal</h3><ul><li><p><a href="https://github.com/trptcolin/reply">REPLy</a> (<a href="https://clojars.org/reply">at clojars</a>): a Swiss army knife of interactive editing, and better REPL for Clojure</p></li><li><p><a href="https://clojars.org/clojure-lanterna">clojure-lanterna</a> (<a href="https://clojars.org/clojure-lanterna">at clojars</a>): for creating TUIs (terminal-based user-interfaces), like ncurses.</p></li></ul><h2 id="concurrency-and-parallelism">Concurrency and Parallelism</h2><ul><li><a href="http://docs.oracle.com/javase/7/docs/technotes/guides/concurrency/index.html">java.util.concurrent</a>: a comprehensive, very mature set of concurrency primitives built into the JDK</li><li><a href="https://github.com/gaverhae/okku">Okku</a> (<a href="https://clojars.org/org.clojure.gaverhae/okku">at clojars</a>): Akka API for Clojure</li></ul><h2 id="mathematics">Mathematics</h2><ul><li><p><a href="https://github.com/clojure/math.numeric-tower">math.numeric-tower</a>: various utility math functions</p></li><li><p><a href="https://github.com/clojure/math.combinatorics">math.combinatorics</a>: common combinatorial functions</p></li><li><p><a href="https://github.com/mikera/matrix-api">core.matrix</a>: matrix operations</p></li></ul><h2 id="email">Email</h2><ul><li><p><a href="https://github.com/drewr/postal">Postal</a> (<a href="https://clojars.org/com.draines/postal">at clojars</a>): generate and send email with Clojure</p></li><li><p><a href="https://github.com/clojurewerkz/mailer">Mailer</a> (<a href="https://clojars.org/clojurewerkz/mailer">at clojars</a>): generate and send email using Postal and Moustache templates</p></li></ul><h2 id="data-structures-and-algorithms">Data Structures and Algorithms</h2><h3 id="strings">Strings</h3><ul><li>clojure.string</li></ul><h3 id="sets">Sets</h3><ul><li>clojure.set</li></ul><h3 id="caching">Caching</h3><ul><li><a href="https://github.com/clojure/core.cache">core.cache</a>: the Clojure API for various cache implementations</li></ul><h3 id="uuids">UUIDs</h3><ul><li><a href="https://github.com/mpenet/tardis">tardis</a> (<a href="https://clojars.org/cc.qbits/tardis">at clojars</a>): manages Type 1 UUIDs (time based)</li></ul><h3 id="monads">Monads</h3><ul><li><p><a href="https://github.com/clojure/algo.monads">algo.monads</a>: macros for defining monads, and definition of the most common monads</p></li><li><p><a href="https://github.com/jduey/protocol-monads">protocol-monads</a>: A protocol based monad implementation for clojure</p></li></ul><h3 id="memoization">Memoization</h3><ul><li><a href="https://github.com/clojure/core.memoize">core.memoize</a></li></ul><h3 id="other">Other</h3><ul><li><p><a href="https://github.com/michaelklishin/vclock">vclock</a> (<a href="https://clojars.org/clojurewerkz/vclock">at clojars</a>): a vector clocks implementation</p></li><li><p><a href="https://github.com/michaelklishin/chash">chash</a> (<a href="https://clojars.org/clojurewerkz/chash">at clojars</a>): a consistent hashing library</p></li></ul><h2 id="scheduling">Scheduling</h2><ul><li><a href="http://clojurequartz.info">Quartzite</a> (<a href="https://clojars.org/clojurewerkz/quartzite">at clojars</a>): a powerful scheduling library</li></ul><h2 id="graphics-and-gui">Graphics and GUI</h2><ul><li><p><a href="https://clojars.org/quil">Quil</a>: For making drawings, animations,
+and artwork (<a href="https://github.com/quil/quil/blob/master/examples/gen_art/README.md">some examples</a>). Wraps
+the <a href="http://www.processing.org/">"Processing"</a> graphics environment.</p></li><li><p><a href="http://seesaw-clj.org/">seesaw</a> (<a href="https://clojars.org/seesaw">at clojars</a>): A Swing wrapper/DSL.</p></li><li><p><a href="https://github.com/mikera/clisk">clisk</a>: Clisk is a DSL-based library for procedural image generation that can be used from Clojure and Java.</p></li></ul><h2 id="security-and-sandboxing">Security and Sandboxing</h2><ul><li><a href="https://github.com/flatland/clojail">Clojail</a> (<a href="https://clojars.org/clojail">at clojars</a>): a [code execution] sandboxing library</li></ul><h2 id="documentation">Documentation</h2><h3 id="literate-programming">Literate Programming</h3><ul><li><p><a href="https://github.com/fogus/marginalia">Marginalia</a> (<a href="https://clojars.org/marginalia">at clojars</a>): literate programming implementation for Clojure. See <a href="http://fogus.me/fun/marginalia/">the Marginalia
+site</a> for an example.</p></li><li><p><a href="https://github.com/fogus/lein-marginalia">Marginalia Leiningen plug-in</a> (<a href="https://clojars.org/lein-marginalia">at clojars</a>)</p></li></ul><h3 id="generating-api-reference">Generating API Reference</h3><ul><li><p><a href="https://github.com/weavejester/codox">Codox</a> (<a href="https://clojars.org/codox">at clojars</a>): from the author of Compojure. See <a href="http://weavejester.github.com/compojure/">compojure
+api docs</a> for an
+example.</p></li><li><p><a href="http://tomfaulhaber.github.com/autodoc/">Autodoc</a> (<a href="https://clojars.org/autodoc">at clojars</a>): used
+to generate the official <a href="http://clojure.github.com/">Clojure API reference</a>.</p></li></ul><h2 id="tooling">Tooling</h2><ul><li><p><a href="http://leiningen.org">Leiningen</a>: the Clojure build tool</p></li><li><p><a href="https://github.com/clojure/tools.nrepl">tools.nrepl</a>: nREPL interface</p></li><li><p><a href="https://github.com/clojure/java.jmx">java.jmx</a>: nice JMX interface</p></li><li><p><a href="https://github.com/clojure/test.benchmark">test.benchmark</a>: a benchmarking library</p></li><li><p><a href="https://github.com/clojure/tools.trace">tools.trace</a>: a tracing library</p></li><li><p><a href="https://github.com/hugoduncan/criterium">criterium</a> (<a href="https://clojars.org/criterium">at clojars</a>): a benchmarking library that tries to address common benchmarking pitfalls</p></li><li><p><a href="https://github.com/AlexBaranosky/print-foo">print-foo</a> (<a href="https://clojars.org/print-foo">at clojars</a>): A library of print debugging macros.</p></li><li><p><a href="https://github.com/AlexBaranosky/gui-diff">gui-diff</a> (<a href="https://clojars.org/gui-diff">at clojars</a>): Tools for side-by-side diffing of Clojure data structures and clojure.test failures</p></li></ul>
+
+    <div id="prev-next">
+        
+        <a href="../../language/glossary/index.html">&laquo; Clojure Terminology Guide</a>
+        
+        
+        ||
+        
+        
+        <a href="../libraries_authoring/index.html">Library Development and Distribution &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/maven/index.html b/clones/clojure-doc.org/articles/ecosystem/maven/index.html
new file mode 100644
index 00000000..e8e8132f
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/maven/index.html
@@ -0,0 +1,395 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: How to use Maven to build Clojure projects</title>
+    
+
+<meta name="description" content="This guide describes how to use Maven to build projects written in Clojure (or in Clojure,
+and other languages, such as Java).  Although Leiningen is more popular build tool in the
+Clojure community, Maven is also used for some projects, such as Clojure Contrib
+libraries, and may be useful when you need to perform some special tasks during build,
+that aren&#39;t covered by Leiningen&#39;s plugins, or when you&#39;re integrating Clojure code into
+an existing Maven project.What is Maven?">
+
+<meta property="og:description" content="This guide describes how to use Maven to build projects written in Clojure (or in Clojure,
+and other languages, such as Java).  Although Leiningen is more popular build tool in the
+Clojure community, Maven is also used for some projects, such as Clojure Contrib
+libraries, and may be useful when you need to perform some special tasks during build,
+that aren&#39;t covered by Leiningen&#39;s plugins, or when you&#39;re integrating Clojure code into
+an existing Maven project.What is Maven?">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/maven/" />
+<meta property="og:title" content="How to use Maven to build Clojure projects" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/maven/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>How to use Maven to build Clojure projects</h2>
+    </div>
+    
+    <p>This guide describes how to use Maven to build projects written in Clojure (or in Clojure,
+and other languages, such as Java).  Although Leiningen is more popular build tool in the
+Clojure community, Maven is also used for some projects, such as Clojure Contrib
+libraries, and may be useful when you need to perform some special tasks during build,
+that aren't covered by Leiningen's plugins, or when you're integrating Clojure code into
+an existing Maven project.</p><h2 id="what-is-maven">What is Maven?</h2><p><a href="http://maven.apache.org">Maven</a> is a software project life cycle management tool.  It implements dependencies
+resolution (with automatic download of missing dependencies from repositories), building &amp;
+testing of code, deployment of software, etc.  Maven's functionality is extensible with
+plugins, so it's possible to use it not only for Java code (primary goal of this tool),
+but also for code, written in other languages. You can read more about Maven in
+<a href="http://www.sonatype.com/products/maven/documentation/book-defguide">following, freely available book</a>.</p><p>Maven differs from other tools, such as Ant - it describes <em>what</em> we want to do, in
+contrast with Ant, that describes <em>how</em> to it.  Maven uses declarative style to
+describe tasks that we want to execute, and all described tasks are performed by
+the corresponding plugins.</p><p>Description of software lifecycle and information about project is stored in <code>pom.xml</code>,
+a file that should exist in root directory of the project (and in root directories of
+sub-projects, if your project is separated into several modules).  Project's information
+includes name, identifier and version of the project, and often includes more information:
+URL of project's site, information about source code repository (so you can use <code>mvn scm:update</code> goal to update code, for example), etc.</p><h2 id="lifecycle-phases">Lifecycle Phases</h2><p>Project Object Model (POM) defines set of stages for project's lifecycle - they are
+called "lifecycle phases".  Each phase can include several tasks (goals), that define what
+will be performed on given stage.  There are several common stages: compilation (<code>compile</code>),
+testing (<code>test</code>), creation of package (<code>package</code>), and installation (<code>install</code>).  Each of these
+phases has dependencies on other phases, that should be executed before its invocation
+(compilation should be executed before testing, testing before packaging, etc.).</p><p>Usually developer uses phase's name to start a process.  For example, <code>mvn package</code>, or <code>mvn install</code>, etc.  But developer can also execute concrete Maven's goal.  To do this, he
+should specify name of plugin, that implements concrete goal, and task name in given
+plugin.  For example, <code>mvn clojure:run</code> will start Clojure and execute script, specified in
+configuration.  We need to mention, that list of goals, that are executed for concrete
+lifecycle phase isn't constant - you can change this list by modifying plugin's
+configuration.</p><h2 id="maven-and-clojure">Maven and Clojure</h2><p>Clojure's support in Maven is provided by
+<a href="https://github.com/talios/clojure-maven-plugin">clojure-maven-plugin</a>, that is available
+in Maven's central repository, so it always available. (Besides <code>clojure-maven-plugin</code>,
+there is also <a href="https://github.com/pallet/zi">Zi</a> plugin, that was developed as part of
+<a href="http://palletops.com/">Pallet</a> project. In contrast to <code>clojure-maven-plugin</code> it's
+written in Clojure, and more tightly integrated with Clojure-specific subsystems, such
+Marginalia, Ritz, etc.)</p><p>As a base for your projects you can use <code>pom.xml</code> file from
+<a href="https://github.com/talios/clojure-maven-example">clojure-maven-example</a> project.</p><p>If you already have <code>pom.xml</code> in your project, then to enable this plugin, you will need to
+add following code into <code>&lt;plugins&gt;</code> section of <code>pom.xml</code>:</p><pre><code class="xml">  &lt;plugin&gt;
+    &lt;groupId&gt;com.theoryinpractise&lt;/groupId&gt;
+    &lt;artifactId&gt;clojure-maven-plugin&lt;/artifactId&gt;
+    &lt;version&gt;1.3.10&lt;/version&gt;
+  &lt;/plugin&gt;
+</code></pre><p><em>Attention:</em> version number could be changed as development continues.  To find latest
+plugin's version number you can use sites <a href="http://mvnrepository.com/artifact/com.theoryinpractise/clojure-maven-plugin">mvnrepository</a> or <a href="http://jarvana.com/jarvana/">Jarvana</a>, that contains
+information about packages, registered in Maven's repositories.  Besides this, you can
+omit plugin version - in this case, Maven will automatically use latest available version
+(although this isn't always good idea).</p><p>Declaration of this plugin will give you all implemented functionality - compilation,
+testing &amp; running of code, written in Clojure, etc.  Although, out of box you'll need to
+use complete goals names, such as <code>clojure:compile</code>, <code>clojure:test</code> &amp; <code>clojure:run</code>.</p><p>But you can make your life easier if you'll add these goals into list of goals for
+concrete lifecycle phases (<code>compile</code> and <code>test</code>).  To do this you need to add section
+<code>&lt;executions&gt;</code> into plugin's description, as in following example:</p><pre><code class="xml"> &lt;plugin&gt;
+   &lt;groupId&gt;com.theoryinpractise&lt;/groupId&gt;
+   &lt;artifactId&gt;clojure-maven-plugin&lt;/artifactId&gt;
+   &lt;version&gt;1.3.10&lt;/version&gt;
+   &lt;executions&gt;
+     &lt;execution&gt;
+       &lt;id&gt;compile&lt;/id&gt;
+       &lt;phase&gt;compile&lt;/phase&gt;
+       &lt;goals&gt;
+         &lt;goal&gt;compile&lt;/goal&gt;
+       &lt;/goals&gt;
+     &lt;/execution&gt;
+     &lt;execution&gt;
+       &lt;id&gt;test&lt;/id&gt;
+       &lt;phase&gt;test&lt;/phase&gt;
+       &lt;goals&gt;
+         &lt;goal&gt;test&lt;/goal&gt;
+       &lt;/goals&gt;
+     &lt;/execution&gt;
+   &lt;/executions&gt;
+ &lt;/plugin&gt;
+</code></pre><p>In this case, source code, written in Clojure will be compiled - this useful if you
+implement <code>gen-class</code>, that will be used from Java, or if you don't want to provide source
+code for your application.  But sometimes it's much better just to pack source code into
+jar, and it will compiled during loading of package (this is default behaviour when you're
+declaring <code>clojure</code> packaging type) - this allows to avoid binary incompatibility between
+different versions of Clojure.  To put source code into jar, you need to add following
+code into <code>resources</code> section (or change packaging type to <code>clojure</code>):</p><pre><code class="xml"> &lt;resource&gt;
+   &lt;directory&gt;src/main/clojure&lt;/directory&gt;
+ &lt;/resource&gt;
+</code></pre><p>By default, Clojure's source code is placed in the <code>src/main/clojure</code> directory of the
+project's tree, while source code for tests is placed in the <code>src/test/clojure</code> directory.
+These default values could be changed in <a href="index.html#configure">plugin's configuration</a>.</p><h3 id="goals-in-the-clojure-maven-plugin">Goals in the Clojure Maven Plugin</h3><p><code>clojure-maven-plugin</code> implements several commands (goals) that could be divided into
+following groups:</p><ul><li><p>Goals that work with source code (usually they are linked with corresponding phases of
+lifecycle, as it's shown above):</p><ul><li><code>clojure:compile</code>: compiles source code, written in Clojure;</li><li><code>clojure:test</code>: executes tests, written in Clojure.</li><li><code>clojure:test-with-junit</code>: executes tests using JUnit;</li><li><code>clojure:add-source</code>: adds directory with source code to archive <code>...-sources.jar</code>;</li><li><code>clojure:add-testsource</code>: add directory with tests source code into archive
+<code>...-testsources.jar</code>.</li></ul></li><li><p>Goals for execution of project's code:</p><ul><li><code>clojure:run</code>: executes script (or scripts) defined by <code>script</code> and/or <code>scripts</code>
+configuration directives.  This goals is often used to run project with correct
+dependencies;</li><li><code>clojure:repl</code>: starts Clojure REPL with all dependencies, specified in project.  If
+necessary, it also executes script specified in configuration option <code>replScript</code> - for
+example, you can put some initialization code into it.  If the JLine library was
+specified in dependencies, then it will be loaded automatically, making your work in
+REPL more comfortable;</li><li><code>clojure:swank</code>: starts Swank server, so you can connect to it from Emacs SLIME.  By
+default, this server is running on port 4005 (this value could be changed with system
+option <code>clojure.swank.port</code>);</li><li><code>clojure:nailgun</code>: starts Nailgun server, so you can connect to it from Vim with
+<a href="http://kotka.de/projects/clojure/vimclojure.html">vimclojure</a>.  By default, this server is running on port 2113 (this value could be
+changed with system option <code>clojure.nailgun.port</code>).</li></ul></li><li><p>Auxiliary tasks:</p><ul><li><code>clojure:marginalia</code>: generates documentation using <a href="http://fogus.github.com/marginalia/">Marginalia</a>;</li><li><code>clojure:autodoc</code>: generates documentation using <a href="http://tomfaulhaber.github.com/autodoc/">autodoc</a>;</li><li><code>clojure:gendoc</code>: generates documentation using gendoc.</li></ul></li></ul><h3 id="clojure-related-repositories">Clojure-related repositories</h3><p>There are several Clojure-related repositories.  All Clojure versions (stable &amp;
+development) are published at <a href="http://dev.clojure.org/display/doc/Maven+Settings+and+Repositories">Sonatype repository</a> that is periodically synchronized with
+Maven Central.  <a href="http://clojars.org">Clojars</a> is repository that is used by Clojure community to publish their
+projects.</p><p>To use repository you need to add following code into <code>repositories</code> section in <code>pom.xml</code>:</p><pre><code class="xml"> &lt;repository&gt;
+   &lt;id&gt;clojars&lt;/id&gt;
+   &lt;url&gt;http://clojars.org/repo/&lt;/url&gt;
+ &lt;/repository&gt;
+</code></pre><h3 id="dependencies-management">Dependencies Management</h3><p>Maven automatically downloads the all necessary dependencies from the default repository (known as
+Maven Central), and
+repositories, specified by user (as shown above).  Downloaded packages are stored in
+user's home directory and could be used by other projects without additional downloading.
+Each package is uniquely identified by combination of three parameters - group's name
+(the <code>groupId</code> tag), artifact's name (the <code>artifactId</code> tag), and version (the <code>version</code> tag).</p><p>To use Clojure in your project you need at least specify dependency on language itself.
+Right now, the stable version of Clojure is 1.4.0.  To declare this dependency, add
+following code into <code>dependencies</code> section of <code>pom.xml</code> file:</p><pre><code class="xml"> &lt;dependency&gt;
+   &lt;groupId&gt;org.clojure&lt;/groupId&gt;
+   &lt;artifactId&gt;clojure&lt;/artifactId&gt;
+   &lt;version&gt;1.4.0&lt;/version&gt;
+ &lt;/dependency&gt;
+</code></pre><p>If you want to use the latest version of the language, then you need to add corresponding
+repository (snapshots) and use version number like <code>1.5.0-master-SNAPSHOT</code> instead of version
+<code>1.4.0</code>.</p><p>To perform some tasks, implemented by <code>clojure-maven-plugin</code>, you need to specify additional
+dependencies.</p><p>If you will use <code>clojure:swank</code> goal, then you need to specify dependency on <code>swank-clojure</code> package:</p><pre><code class="xml"> &lt;dependency&gt;
+  &lt;groupId&gt;swank-clojure&lt;/groupId&gt;
+  &lt;artifactId&gt;swank-clojure&lt;/artifactId&gt;
+  &lt;version&gt;1.4.2&lt;/version&gt;
+&lt;/dependency&gt;
+</code></pre><p>If you will use <code>clojure:nailgun</code> task, then you need to download distribution from
+<a href="http://kotka.de/projects/clojure/vimclojure.html">vimclojure</a>'s site, build it, as described in documentation, and install into local
+Maven repository.  And after this, you need to add following dependency on
+<code>vimclojure</code> with following code:</p><pre><code class="xml">&lt;dependency&gt;
+  &lt;groupId&gt;de.kotka&lt;/groupId&gt;
+  &lt;artifactId&gt;vimclojure&lt;/artifactId&gt;
+  &lt;version&gt;X.Y.Z&lt;/version&gt;
+ &lt;/dependency&gt;
+</code></pre><p>The JLine library isn't required, but it could be useful if you plan to use the REPL -
+this library implements support for command history and other nice things. Presence of this library is detected
+automatically when <code>mvn clojure:repl</code> goal is executed. You can add dependency for this
+library with following code:</p><pre><code class="xml"> &lt;dependency&gt;
+  &lt;groupId&gt;jline&lt;/groupId&gt;
+  &lt;artifactId&gt;jline&lt;/artifactId&gt;
+  &lt;version&gt;0.9.94&lt;/version&gt;
+ &lt;/dependency&gt;
+</code></pre><h3 id="plugins-configuration">Plugin's Configuration</h3><p>Developer can change plugin's configuration options, such as location of source code,
+scripts names, etc.  To change some parameter, you need to add its new value into
+<code>configuration</code> section of the plugin's description.  For example, you can specify name of
+the script, that will be executed during testing, using following code:</p><pre><code class="xml">&lt;plugin&gt;
+   &lt;groupId&gt;com.theoryinpractise&lt;/groupId&gt;
+   &lt;artifactId&gt;clojure-maven-plugin&lt;/artifactId&gt;
+   &lt;version&gt;1.3.10&lt;/version&gt;
+   &lt;configuration&gt;
+     &lt;testScript&gt;src/test/clojure/test.clj&lt;/testScript&gt;
+   &lt;/configuration&gt;
+   .....
+ &lt;/plugin&gt;
+</code></pre><p>Following options are used to specify options related to source code &amp; compilation:</p><ul><li><code>sourceDirectories</code> - this option defines list of directories (each of them should be
+wrapped into <code>sourceDirectory</code> tag) that contains source code written in Clojure, and that
+will be packed into resulting jar (and compiled, if corresponding option is specified);</li><li><code>testSourceDirectories</code> - defines list of directories (each of them should be wrapped into
+<code>testSourceDirectory</code> tag) with tests, written in Clojure;</li><li><code>warnOnReflection</code> - option that enables (<code>true</code>) or disables (<code>false</code>) warnings about
+reflection during compilation of source code.</li></ul><p>Besides this, you can control which namespaces will be compiled and/or for which
+namespaces testing of source code will be performed.  To do this, you need to add
+<code>namespaces</code> tag into configuration and list corresponding namespaces inside it (each of
+item should be wrapped into <code>namespace</code> tag).  You can use regular expressions to specify
+all necessary namespaces, and you can also use <code>!</code> to exclude namespaces from this list.  In
+addition to this option, you can use other two: <code>compileDeclaredNamespaceOnly</code> and
+<code>testDeclaredNamespaceOnly</code> (with values <code>true</code> or <code>false</code>) - they control, will be these
+namespace limitations applied during compilation and/or testing.</p><p>There are also several options that are used to specify parameters for execution of your
+code and/or tests:</p><ul><li><code>script</code> and <code>scripts</code> - defines one (<code>script</code> tag) or several (<code>scripts</code> tag with nested <code>script</code>
+tags) names of scripts with code, that will executed when you'll execute the
+<code>clojure:run</code> task;</li><li><code>testScript</code>: defines name of script that will executed when you'll execute <code>clojure:test</code>
+task.  If there was no value specified in plugin's configuration, then plugin will
+automatically generate run script for all tests, that was found in project;</li><li><code>replScript</code> - defines name of script, that will executed if you'll execute <code>clojure:repl</code> task
+(it's also used by <code>clojure:swank</code> and <code>clojure:nailgun</code> tasks).  This code will executed
+before entering into REPL, so you can use it to specify initialization code for your
+working environment;</li><li><code>runWithTests</code> - enables (<code>true</code>) or disables (<code>false</code>) executions of tests if you run REPL or
+your code via Maven.  You can also change this value by using Maven's command-line
+option.  For example, using following command <code>mvn clojure:repl -Dclojure.runwith.test=false</code>;</li><li><code>clojureOptions</code> - using this option you can specify command-line options that will be
+passed to <code>java</code> process on every invocation.</li></ul><h2 id="wrapping-up">Wrapping Up</h2><p>I think, that this article provides enough information for you to start use Maven together
+with Clojure.  If you have Clojure-only project, and you don't plan to use all power of
+Maven, then may be you can look to the <a href="https://clojure-doc.org/articles/ecosystem/maven/leiningen.md">Leiningen</a> - this tool was created to build
+projects, written mostly in Clojure.  Another interesting project is <a href="http://polyglot.sonatype.org/">Polyglot Maven</a>, the
+main goal of it is creation of special DSL (Domain Specificl Language) using different
+languages (Clojure, Scala, Groovy) for description of Maven's configurations (for Clojure
+this language is almost the same as language implemented in Leiningen).</p><p>Other examples of using Maven with Clojure you can find in different projects: <a href="https://github.com/liebke/incanter/tree/1.0.x">Incanter</a>
+(as example of project, consisting from several modules), <a href="https://github.com/relevance/labrepl">labrepl</a> and
+the <a href="https://github.com/talios/clojure-maven-example">clojure-maven-example</a>.</p><h2 id="where-to-learn-more">Where To Learn More</h2><p>More information on Clojure and Maven you can also find in
+following blog posts:</p><ul><li><a href="http://muckandbrass.com/web/display/~cemerick/2010/03/25/Why+using+Maven+for+Clojure+builds+is+a+no-brainer">Why using Maven for Clojure builds is a no-brainer</a> (including video, that shows how to work with the <code>clojure-maven-plugin</code>)</li><li><a href="http://pupeno.com/blog/how-to-create-a-clojure-application/">How to create a Clojure application</a></li><li><a href="http://stuartsierra.com/2009/09/03/mavens-not-so-bad">Maven’s Not So Bad</a>.</li></ul><h2 id="contributors">Contributors</h2><p><a href="http://alexott.net/en/index.html">Alex Ott</a>, 2012 (original author)</p>
+
+    <div id="prev-next">
+        
+        <a href="../web_development/index.html">&laquo; Web Development (Overview)</a>
+        
+        
+        ||
+        
+        
+        <a href="../community/index.html">Clojure Community &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/running_cljug/index.html b/clones/clojure-doc.org/articles/ecosystem/running_cljug/index.html
new file mode 100644
index 00000000..ae1c0323
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/running_cljug/index.html
@@ -0,0 +1,209 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Running a Clojure User Group</title>
+    
+
+<meta name="description" content="About this tutorialThis guide covers:">
+
+<meta property="og:description" content="About this tutorialThis guide covers:">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/running_cljug/" />
+<meta property="og:title" content="Running a Clojure User Group" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/running_cljug/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Running a Clojure User Group</h2>
+    </div>
+    
+    <h2 id="about-this-tutorial">About this tutorial</h2><p>This guide covers:</p><ul><li>Starting a user group</li><li>Tips for keeping it going</li><li>Meeting ideas</li></ul><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons Attribution 3.0 Unported License</a>
+(including images &amp; stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on Github</a>.</p><h2 id="starting-a-user-group">Starting a user group</h2><p>Learning Clojure is easier (and more fun) if you can do it with others. Some of the essentials you will need to work out before your first meeting:</p><h3 id="meeting-time">Meeting time</h3><p>If you have a handful of interested parties, it's best to run a quick poll with some options for day of the week to find the most promising candidates and then unilaterally pick one. If evenings are challenging, consider a breakfast or lunch get together!</p><h3 id="location">Location</h3><p>Location can sometimes be the hardest part of creating a new group. Some ideas:</p><ul><li>Ask a software, consulting, or recruiting company in the area. Hosting a group is a great way for potential hires to learn about a company.</li><li>Many libraries and public spaces can be reserved for meetings.</li><li>A get together at a local bar or coffee shop can be enough at the beginning.</li></ul><h3 id="meeting-format">Meeting format</h3><p>Most Clojure user groups follow one of three models:</p><ul><li>Talk with a speaker</li><li>Coding exercises (dojo, swarm coding, pairing, etc)</li><li>Informal chat</li></ul><h3 id="speakers">Speakers</h3><p>If you have trouble getting speakers, try assigning a topic (a Clojure feature, library, etc) to someone to present at the next meeting.</p><h3 id="meeting-organization">Meeting organization</h3><p>By far the two most popular ways to organize your group are <a href="http://meetup.com">Meetup</a> (use discount code "clojure" for 50% off!) or Google group mailing lists.
+Also consider creating a GitHub organization where attendees can find each others' code repos.</p><h2 id="keeping-it-going">Keeping it going</h2><p>Once you get the first meeting or two under your belt, you have to worry about how to keep it going. Consistency is one of the most important things in getting a group going - as much as possible try to stick to a stable meeting date and location.</p><p>When the group is young you’ll need to spend some effort marketing to help it grow — this is one of the reasons that Meetup.com shines. If there are local calendars, get your group listed.</p><p>Create a web site! Domain names and hosting are cheap — it’s totally worth creating a blog site dedicated to the group on your own domain name.</p><p>Create a Twitter account for the group and post info related to the group as well as specific to your topic. Ask all attendees to post about meetings on Twitter and blogs. Record your talks and put them on the net.</p><p>Consider using a private mailing list for those that attend the meetings. This is a somewhat unusual choice these days but having the limited membership means that you generally know the people that write on the mailing list and having it closed means that people can be a bit more free in asking newbie questions. Both factors contribute to a closer-knit feeling of local community.</p><p>Once you get to a certain size (or if you are fortunate to have good companies involved), you can find sponsors that provide food for your group.</p><h2 id="meeting-ideas">Meeting ideas</h2><p>Looking for meeting ideas? Here's some ideas....</p><ul><li>Work through through the <a href="https://github.com/functional-koans/clojure-koans">Clojure Koans</a></li><li>Work through problems from <a href="http://www.4clojure.com/">4Clojure</a></li><li>Run a session on getting set up on Emacs with Clojure (or Vim, or ...)</li><li>Work through <a href="http://projecteuler.net/">Project Euler</a> problems</li><li>Work through a <a href="http://codekata.pragprog.com/">Code Kata</a></li><li>Implement a game (Tic-Tac-Toe, Rock-Paper-Scissors, Checkers, Othello, etc)</li><li>Build a web site for your group in Clojure and deploy it to Heroku!</li><li>Review and expand <a href="https://clojure-doc.github.io">Clojure documentation</a> guides</li><li>Look through the <a href="http://dev.clojure.org/jira/secure/Dashboard.jspa">Clojure JIRA</a> for bugs to work on</li></ul><p>And some tips:</p><ul><li><a href="http://otfrom.wordpress.com/2012/07/04/how-to-run-a-london-clojure-dojo-in-20ish-easy-steps/">Running a Clojure dojo</a></li><li><a href="http://www.infoq.com/presentations/Swarm-Coding">Swarm coding how-to</a></li></ul><h2 id="troubleshooting">Troubleshooting</h2><h3 id="i-cant-find-enough-people-for-a-group">I can't find enough people for a group</h3><p>You might think of broadening the scope to pull in people that are interested in something similar but not exactly the same. If you can't find enough
+people for a Clojure user group, maybe a functional programming group would capture other people interested in Erlang, Scala, Haskell, F#, etc.</p><h2 id="contributors">Contributors</h2><p>Alex Miller <a href="mailto:alex@puredanger.com">alex@puredanger.com</a> (original author)</p>
+
+    <div id="prev-next">
+        
+        <a href="../user_groups/index.html">&laquo; Clojure User Groups</a>
+        
+        
+        ||
+        
+        
+        <a href="../books/index.html">Books about Clojure and ClojureScript &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/user_groups/index.html b/clones/clojure-doc.org/articles/ecosystem/user_groups/index.html
new file mode 100644
index 00000000..536eebe9
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/user_groups/index.html
@@ -0,0 +1,212 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Clojure User Groups</title>
+    
+
+<meta name="description" content="This guide covers Clojure User Groups (CLJUGs) around the world. If you want to add a new user group,
+please see our How to Contribute guide.If you are looking to start a new Clojure User Group (CLJUG), see  How to run your own Clojure User Group
+and feel free to submit a link to your CLJUG site or mailing list once you have it going.">
+
+<meta property="og:description" content="This guide covers Clojure User Groups (CLJUGs) around the world. If you want to add a new user group,
+please see our How to Contribute guide.If you are looking to start a new Clojure User Group (CLJUG), see  How to run your own Clojure User Group
+and feel free to submit a link to your CLJUG site or mailing list once you have it going.">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/user_groups/" />
+<meta property="og:title" content="Clojure User Groups" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/user_groups/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Clojure User Groups</h2>
+    </div>
+    
+    <p>This guide covers Clojure User Groups (CLJUGs) around the world. If you want to add a new user group,
+please see our <a href="https://github.com/clojure-doc/clojure-doc.github.io#how-to-contribute">How to Contribute</a> guide.</p><p>If you are looking to start a new Clojure User Group (CLJUG), see  <a href="../running_cljug/index.html">How to run your own Clojure User Group</a>
+and feel free to submit a link to your CLJUG site or mailing list once you have it going.</p><h2 id="north-america">North America</h2><ul><li><a href="http://www.meetup.com/Atl-Clj/">Atlanta Clojure User Group</a></li><li><a href="http://www.meetup.com/Austin-Clojure-Meetup/">Austin Clojure Meetup</a></li><li><a href="http://www.meetup.com/Boston-Clojure-Group/">Boston Clojure User Group</a></li><li><a href="http://www.meetup.com/Charlotte-Clojure-Users-Group/">Charlotte Clojure User Group</a></li><li><a href="http://www.meetup.com/Chicago-Clojure/">Chicago Clojure User Group</a></li><li><a href="http://clojuredc.org/">Clojure DC User Group</a></li><li><a href="http://www.columbusclojure.com/">Columbus Clojure User Group</a></li><li><a href="http://www.meetup.com/DFW-Clojure/">Dallas/Fort Worth Clojure User Group</a></li><li><a href="http://www.meetup.com/Denver-Clojure-Meetup/">Denver Clojure User Group</a></li><li><a href="http://groups.google.com/group/detroit-clojure">Detroit Clojure User Group</a></li><li><a href="http://groups.google.com/group/clj-houston">Houston Clojure User Group</a></li><li><a href="http://clj-la.org/">Los Angeles Clojure User Group</a></li><li><a href="http://www.meetup.com/Madison-Clojure/">MadClojure (Madison Clojure User Group)</a></li><li><a href="http://clojure.mn/">Minnesota Clojure User Group</a></li><li><a href="https://groups.google.com/forum/#!forum/montreal-clojure-user-group">Montréal Clojure User Group</a></li><li><a href="http://www.meetup.com/Cap-Clug/">National Capital Area Clojure User Group</a></li><li><a href="http://www.meetup.com/Clojure-NYC/">New York City Clojure User Group</a></li><li><a href="http://groups.google.com/group/phl-clojure-language-club">Philadelphia Clojure User Group</a></li><li><a href="http://clj-phx.wikispaces.com/">Phoenix Clojure User Group</a></li><li><a href="http://www.meetup.com/Clojure-PGH/">Pittsburgh Clojure User Group</a></li><li><a href="http://www.meetup.com/The-Bay-Area-Clojure-User-Group/">San Francisco Bay Area Clojure User Group</a></li><li><a href="http://www.meetup.com/Santa-Barbara-Clojure-Users-Group/">Santa Barbara Clojure User Group</a></li><li><a href="http://seajure.github.com/">Seattle Clojure User Group, Seajure</a></li><li><a href="http://www.meetup.com/stl-clojure/">St. Louis Clojure Meetup</a></li><li><a href="http://meetup.com/TriClojure/">TriClojure Meetup</a></li><li><a href="http://wmassdevs.com/">Western Mass. Developer Group</a></li></ul><h2 id="europe">Europe</h2><ul><li><a href="http://www.clojure.dk/">Aarhus Clojure User Group</a></li><li><a href="http://ams-clj.github.com/">Amsterdam Clojurians</a>, <a href="http://twitter.com/cmsclj">@amsclj</a></li><li><a href="http://www.meetup.com/Clojure-Berlin/">Berlin Clojure User Group</a>, <a href="http://twitter.com/cljugb">@cljugb</a></li><li><a href="http://groups.google.com/group/bratislava-clojure/">Bratislava Clojure User Group</a></li><li><a href="http://www.meetup.com/Budapest-Clojure-User-Group/">Budapest Clojure User Group</a></li><li><a href="http://www.meetup.com/Cambridge-Clojurians/">Cambridge Clojurians</a></li><li><a href="https://groups.google.com/forum/#%21forum/clojure-finland">Clojure Finland</a></li><li><a href="https://groups.google.com/forum/?fromgroups#!forum/clojure-finland">Clojure Finland</a></li><li><a href="http://www.meetup.com/clojure-cologne/">Cologne Clojure User Group</a></li><li><a href="http://www.ative.dk/om-ative/arrangementer.aspx">Copenhagen Clojure User Group</a></li><li><a href="http://www.meetup.com/riviera-scala-clojure">French Riviera Clojure/Scala Meetup</a>, <a href="http://twitter.com/riviera_func">@riviera_func</a></li><li><a href="http://www.meetup.com/got-clj/">Göteborg Clojure User Group</a>, <a href="https://twitter.com/Gotclj">@Gotclj</a></li><li><a href="http://www.meetup.com/ClojureUserGroupHH/">Hamburg Clojure User Group</a></li><li><a href="http://groups.google.com/group/clojure-italy">Italian Clojure User Group</a></li><li><a href="https://groups.google.com/forum/#!forum/clojure-lt">Lithuanian Clojure User Group</a></li><li><a href="http://londonclojurians.org/">London Clojurians</a></li><li><a href="http://clojure-lyon.eventbrite.fr/">Lyon Clojure User Group</a></li><li><a href="http://manchester.clojuredojo.com/">Manchester Clojure Dojo</a></li><li><a href="http://www.meetup.com/clj-muc/">München Clojure User Group</a>, <a href="http://twitter.com/cljmuc">@cljmuc</a></li><li><a href="http://www.meetup.com/Lambda-Meetup-Group/">Prague</a></li><li><a href="http://www.meetup.com/ehrd-clj">Rotterdam/The Hague</a></li><li><a href="http://groups.google.com/group/stockholm-clojure-user-group">Stockholm Clojure User Group</a>, <a href="http://twitter.com/sclojug">@sclojug</a></li><li><a href="http://www.meetup.com/zh-clj-Zurich-Clojure-User-Group/">Zürich</a></li></ul><h2 id="south-america">South America</h2><p>TBD</p><h2 id="middle-east-asia--pacific">Middle East, Asia &amp; Pacific</h2><ul><li><a href="http://groups.google.com/group/bangalore-clj">Bangalore Clojure User Group</a></li><li><a href="https://groups.google.com/group/cn-clojure">Chinese Clojure User Group</a></li><li><a href="http://www.meetup.com/clj-melb/">Melbourne Clojure User Group</a></li><li><a href="http://www.meetup.com/clj-syd/">Sydney Clojure User Group</a></li><li><a href="http://www.meetup.com/Clojure-Israel/">Tel Aviv Clojure User Group</a></li></ul><h2 id="africa">Africa</h2><ul><li><a href="https://twitter.com/clj_ug_ct">Cape Town Clojure User Group</a></li></ul>
+
+    <div id="prev-next">
+        
+        <a href="../community/index.html">&laquo; Clojure Community</a>
+        
+        
+        ||
+        
+        
+        <a href="../running_cljug/index.html">Running a Clojure User Group &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/ecosystem/web_development/index.html b/clones/clojure-doc.org/articles/ecosystem/web_development/index.html
new file mode 100644
index 00000000..ff5a355c
--- /dev/null
+++ b/clones/clojure-doc.org/articles/ecosystem/web_development/index.html
@@ -0,0 +1,239 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Web Development (Overview)</title>
+    
+
+<meta name="description" content="This guide covers:">
+
+<meta property="og:description" content="This guide covers:">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/ecosystem/web_development/" />
+<meta property="og:title" content="Web Development (Overview)" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/ecosystem/web_development/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Web Development (Overview)</h2>
+    </div>
+    
+    <p>This guide covers:</p><ul><li>popular tools and libraries for web development</li></ul><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons
+Attribution 3.0 Unported License</a> (including images &amp;
+stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on
+Github</a>.</p><h2 id="what-version-of-clojure-does-this-guide-cover">What Version of Clojure Does This Guide Cover?</h2><p>This guide covers Clojure 1.4.</p><h2 id="some-options">Some Options</h2><p>Below are some of the various options available for web development
+with Clojure, listed roughly by size.</p><h3 id="ring-and-compojure">Ring and Compojure</h3><p>Perhaps the simplest and most minimal setup is to use only Ring and
+Compojure. To get started, see the <a href="../../tutorials/basic_web_development/index.html">basic web development
+tutorial</a>.</p><h3 id="lib-noir">lib-noir</h3><p>In addition to Ring and Compojure, you might also make use of
+<a href="https://github.com/noir-clojure/lib-noir">lib-noir</a>.</p><h3 id="luminus">Luminus</h3><p><a href="http://www.luminusweb.net/">Luminus</a> is <a href="https://github.com/yogthos/luminus-template">a lein
+template</a> for creating
+batteries-included web applications. It makes use of Ring, Compojure,
+lib-noir, and optionally (as described in its documentation) other
+libraries.</p><h2 id="templating-libraries">Templating Libraries</h2><p>Clojure has many options for building HTML.</p><h3 id="hiccup">Hiccup</h3><p><a href="https://github.com/weavejester/hiccup">Hiccup</a> represents HTML as
+Clojure data structures, allowing you to create and manipulate your
+HTML easily.</p><p><a href="https://github.com/davidsantiago/tinsel">Tinsel</a> is a library that
+extends Hiccup with selectors and transformers, so that you can write
+a template separate from the insertion of your data into the template.</p><h3 id="mustache">Mustache</h3><p><a href="https://github.com/fhd/clostache">Clostache</a> implements the
+<a href="http://mustache.github.com/">Mustache</a> templating language for
+Clojure.</p><p><a href="https://github.com/davidsantiago/stencil">Stencil</a> is another
+implementation of Mustache.</p><h3 id="fleet">Fleet</h3><p><a href="https://github.com/Flamefork/fleet">Fleet</a> embeds Clojure inside HTML
+templates, much like Java's JSPs, or Ruby's ERb.</p><h3 id="clabango">Clabango</h3><p><a href="https://github.com/danlarkin/clabango">Clabango</a> is modeled after the
+<a href="https://docs.djangoproject.com/en/1.4/topics/templates/">Django templating system</a>. It
+embeds special tags and filters inside HTML templates to insert and
+manipulate data.</p><h3 id="selmer">Selmer</h3><p><a href="https://github.com/yogthos/Selmer">Selmer</a> is also modeled after the Django
+templating system with a primary goal of performance.</p><h3 id="enlive-and-laser">Enlive and Laser</h3><p><a href="https://github.com/cgrand/enlive">Enlive</a> and
+<a href="https://github.com/Raynes/laser">Laser</a> are similar libraries. They
+both manipulate plain HTML, and can be used for screen scraping as
+well as templating. They work with HTML templates with no special
+embedded tags or code. They use selector functions to find pieces of
+HTML and transformation function to change the HTML into the way you
+want.</p><p>See the
+<a href="https://github.com/Raynes/laser/blob/master/docs/guide.md">Laser guide</a>
+to see if this style of templating works for you. It is powerful, but
+different from most other languages' templating libraries.</p><h2 id="see-also">See Also</h2><ul><li><p>the <a href="../libraries_directory/index.html#web_development">web development section of the library
+directory</a>.</p></li><li><p><a href="http://brehaut.net/blog/2012/clojure_web_and_the_crud_stack">The Clojure Web Stack and the CRUD Stack</a></p></li><li><p><a href="http://brehaut.net/blog/2011/ring_introduction">A Brief Overview of the Clojure Web Stack</a></p></li></ul><h2 id="contributors">Contributors</h2><ul><li>John Gabriele</li><li>Clinton Dreisbach</li></ul>
+
+    <div id="prev-next">
+        
+        <a href="../data_processing/index.html">&laquo; Data Processing (Help Wanted)</a>
+        
+        
+        ||
+        
+        
+        <a href="../maven/index.html">How to use Maven to build Clojure projects &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/language/collections_and_sequences/index.html b/clones/clojure-doc.org/articles/language/collections_and_sequences/index.html
new file mode 100644
index 00000000..8cd5f166
--- /dev/null
+++ b/clones/clojure-doc.org/articles/language/collections_and_sequences/index.html
@@ -0,0 +1,648 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Collections and Sequences in Clojure</title>
+    
+
+<meta name="description" content="This guide covers:">
+
+<meta property="og:description" content="This guide covers:">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/language/collections_and_sequences/" />
+<meta property="og:title" content="Collections and Sequences in Clojure" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/language/collections_and_sequences/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Collections and Sequences in Clojure</h2>
+    </div>
+    
+    <p>This guide covers:</p><ul><li>Collections in Clojure</li><li>Sequences in Clojure</li><li>Core collection types</li><li>Key operations on collections and sequences</li><li>Other topics related to collections and sequences</li></ul><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons Attribution 3.0 Unported License</a>
+(including images &amp; stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on Github</a>.</p><h2 id="what-version-of-clojure-does-this-guide-cover">What Version of Clojure Does This Guide Cover?</h2><p>This guide covers Clojure 1.5.</p><h2 id="overview">Overview</h2><p>Clojure provides a number of powerful abstractions including <em>collections</em> and <em>sequences</em>.
+When working with Clojure,
+many operations are expressed as a series of operations on collections or sequences.</p><p>Most of Clojure's core library treats collections and sequences the same way, although
+sometimes a distinction has to be made (e.g. with lazy infinite sequences).</p><p><code>clojure.core</code> provides many fundamental operations on collections, such as: <code>map</code>, <code>filter</code>,
+<code>remove</code>, <code>take</code>, and <code>drop</code>. Basic operations on collections and sequences are combined
+to implement more complex operations.</p><h3 id="clojure-collections-are-immutable-persistent">Clojure Collections are Immutable (Persistent)</h3><p>Clojure collections are <em>immutable</em> (<em>persistent</em>). The term "persistent data structures" has
+nothing to do with durably storing them on disk. What it means is that collections are
+mutated (updated) by producing new collections. To quote Wikipedia:</p><blockquote><p>In computing, a persistent data structure is a data structure that always preserves
+the previous version of itself when it is modified. Such data structures are effectively
+immutable, as their operations do not (visibly) update the structure in-place, but instead
+always yield a new updated structure.</p></blockquote><p>Clojure's persistent data structures are implemented as trees and <a href="https://en.wikipedia.org/wiki/Hash_array_mapped_trie"><em>tries</em></a> and
+have O(log<sub>32</sub> <em>n</em>) access complexity where <em>n</em> is the number of elements.</p><h2 id="the-collection-abstraction">The Collection Abstraction</h2><p>Clojure has a collection abstraction with several key operations supported for
+all collection implementations. They are</p><ul><li><code>=</code>: checks value equality of a collection compared to other collections</li><li><code>count</code>: returns number of elements in a collection</li><li><code>conj</code>: adds an item to a collection in the most efficient way</li><li><code>empty</code>: returns an empty collection of the same type as the argument</li><li><code>seq</code>: gets a sequence of a collection</li></ul><p>These functions work on all core Clojure collection types.</p><h2 id="core-collection-types">Core Collection Types</h2><p>Clojure has several core collection types:</p><ul><li>Maps (called hashes or dictionaries in some other languages)</li><li>Vectors</li><li>Lists</li><li>Sets</li></ul><h3 id="maps">Maps</h3><p>Maps associate keys with values. Boths keys and values can be of any type, but
+keys must be comparable. There are several implementations of maps with
+different guarantees about ordering. Hash maps are typically instantiated with literals:</p><pre><code class="clojure">{:language "Clojure" :creator "Rich Hickey"}
+</code></pre><p>Commas can be used in map literals (Clojure compiler treats the comma as whitespace):</p><pre><code class="clojure">{:language "Clojure", :creator "Rich Hickey"}
+</code></pre><p><code>clojure.core/sorted-map</code> and <code>clojure.core/array-map</code> produce ordered maps:</p><pre><code class="klipse-clojure nohighlight">(sorted-map :language "Clojure" :creator "Rich Hickey")
+;; ⇒ {:creator "Rich Hickey", :language "Clojure"}
+</code></pre><pre><code class="klipse-clojure nohighlight">(array-map :language "Clojure" :creator "Rich Hickey")
+;; ⇒ {:creator "Rich Hickey", :language "Clojure"}
+</code></pre><p>Unsurprisingly, map literals must contain an even number of forms (as many keys as values). Otherwise
+the code will not compile:</p><pre><code class="klipse-clojure nohighlight">{:language "Clojure" :creator}
+</code></pre><p>In general, the only major difference between Clojure maps and maps/hashes/dictionaries in some other languages
+is that Clojure maps are <em>immutable</em>. When a Clojure map is modified, the result is a new map that internally
+has structural sharing (for efficiency reasons) but semantically is a separate immutable value.</p><h4 id="maps-as-functions">Maps As Functions</h4><p>Maps in Clojure can be used as functions on their keys. See the <a href="../functions/index.html#maps_as_functions">Functions guide</a>
+for more information.</p><h4 id="keywords-as-functions">Keywords As Functions</h4><p>Keywords in Clojure can be used as functions on maps. See the <a href="../functions/index.html#keywords_as_functions">Functions guide</a>
+for more information.</p><h3 id="vectors">Vectors</h3><p>Vectors are collections that offer efficient random access (by index). They are typically instantiated with
+literals:</p><pre><code class="clojure">[1 2 3 4]
+
+["clojure" "scala" "erlang" "f#" "haskell" "ocaml"]
+</code></pre><p>Commas can be used to separate vector elements (Clojure compiler treats
+the comma as whitespace):</p><pre><code class="clojure">["clojure", "scala", "erlang", "f#", "haskell", "ocaml"]
+</code></pre><p>Unlike lists, vectors are not used for function invocation. They are, however, used to make certain
+forms (e.g. the list of locals in <code>let</code> or parameters in <code>defn</code>) stand out visually. This was
+an intentional decision in Clojure design.</p><h3 id="lists">Lists</h3><p>Lists in Clojure are singly linked lists. Access or modifications of list head is efficient, random access
+is not.</p><p>Lists in Clojure are special because they represent code forms, from function calls to macro calls to special forms.
+Code is data in Clojure and it is represented primarily as lists:</p><pre><code class="klipse-clojure nohighlight">(empty? [])
+</code></pre><p>First item on the list is said to be in the <em>calling position</em>.</p><p>When used as "just" data structures, lists are typically instantiated with literals with quoting:</p><pre><code class="klipse-clojure nohighlight">'(1 2 3 4)
+</code></pre><pre><code class="klipse-clojure nohighlight">'("clojure" "scala" "erlang" "f#" "haskell" "ocaml")
+</code></pre><p>Or you can explicitly use the <code>list</code> form:</p><pre><code class="klipse-clojure nohighlight">(list 1 2 3 4)
+;; ⇒ (1 2 3 4)
+</code></pre><p>Commas can be used to separate list elements (Clojure compiler treats
+the comma as whitespace):</p><pre><code class="klipse-clojure nohighlight">'("clojure", "scala", "erlang", "f#", "haskell", "ocaml")
+</code></pre><h4 id="lists-and-metaprogramming-in-clojure">Lists and Metaprogramming in Clojure</h4><p>Metaprogramming in Clojure (and other Lisp dialects) is different from metaprogramming in, say, Ruby, because
+in Ruby metaprogramming is <em>primarily</em> about producing strings while in Clojure it is about producing
+<em>data structures</em> (mostly <em>lists</em>). For sophisticated DSLs, producing data structures directly lets
+developers avoid a lot of incidental complexity that string generation brings along.</p><p>This topic is covered in detail in the <a href="../macros/index.html">Macros and Metaprogramming</a>.</p><h3 id="sets">Sets</h3><p>Sets are collections that offer efficient membership check operation and only allow each element to appear in the collection
+once. They are typically instantiated with literals:</p><pre><code class="klipse-clojure nohighlight">#{1 2 3 4}
+</code></pre><pre><code class="klipse-clojure nohighlight">#{"clojure" "scala" "erlang" "f#" "haskell" "ocaml"}
+</code></pre><p>Commas can be used to separate set elements (Clojure compiler treats the as whitespace):</p><pre><code class="klipse-clojure nohighlight">#{"clojure", "scala", "erlang", "f#", "haskell", "ocaml"}
+</code></pre><h4 id="sets-as-functions">Sets As Functions</h4><p>Sets in Clojure can be used as functions on their elements. See the <a href="../functions/index.html#sets_as_functions">Functions guide</a>
+for more information.</p><h4 id="set-membership-checks">Set Membership Checks</h4><p>The most common way of checking if an element is in a set is by using set as a function:</p><pre><code class="klipse-clojure nohighlight">(#{1 2 3 4} 1)
+;; ⇒ 1
+</code></pre><pre><code class="klipse-clojure nohighlight">(#{1 2 3 4} 10)
+;; ⇒ nil
+</code></pre><pre><code class="klipse-clojure nohighlight">(if (#{1 2 3 4} 1)
+  :hit
+  :miss)
+;; ⇒ :hit
+</code></pre><h2 id="sequences">Sequences</h2><p>The sequence abstraction represents a sequential view of a collection or collection-like
+entity (computation result).</p><p><code>clojure.core/seq</code> is a function that produces a sequence over the given argument.
+Data types that <code>clojure.core/seq</code> can produce a sequence over are called <em>seqable</em>:</p><ul><li>Clojure collections</li><li>Java maps</li><li>All iterable types (types that implement <code>java.util.Iterable</code>)</li><li>Java collections (<code>java.util.Set</code>, <code>java.util.List</code>, etc)</li><li>Java arrays</li><li>All types that implement <code>java.lang.CharSequence</code> interface, including Java strings</li><li>All types that implement <code>clojure.lang.Seqable</code> interface</li><li>nil</li></ul><p>The sequence abstraction supports several operations:</p><ul><li><code>first</code></li><li><code>rest</code></li><li><code>next</code></li></ul><p>and there are two ways to produce a sequence:</p><ul><li><code>seq</code> produces a sequence over its argument (often a collection)</li><li><code>lazy-seq</code> creates a <em>lazy sequence</em> (that is produced by performing computation)</li></ul><h3 id="seq-cons-list">seq, cons, list*</h3><p><code>clojure.core/seq</code> takes a single argument and returns a sequential view over it:</p><pre><code class="klipse-clojure nohighlight">(seq [1 2 3])
+;; ⇒ (1 2 3)
+</code></pre><p>When given an empty collection or sequence, <code>clojure.core/seq</code> returns nil:</p><pre><code class="klipse-clojure nohighlight">(seq [])
+;; ⇒ nil
+</code></pre><p>this is commonly used in the following pattern:</p><pre><code class="klipse-clojure nohighlight">(if (seq xs)
+  (comment "Do something with this sequence")
+  (comment "Do something else"))
+</code></pre><p>Another function that constructs sequences is <code>clojure.core/cons</code>. It prepends values to the head of
+the given sequence:</p><pre><code class="klipse-clojure nohighlight">(cons 0 (range 1 3))
+;; ⇒ (0 1 2)
+</code></pre><p><code>clojure.core/list*</code> does the same for a number of values:</p><pre><code class="klipse-clojure nohighlight">(list* 0 1 (range 2 5))
+;; ⇒ (0 1 2 3 4)
+</code></pre><p><code>clojure.core/cons</code> and <code>clojure.core/list*</code> are primarily used to produce lazy sequences and in metaprogramming (when writing
+macros). As far as metaprogramming goes, sequences and lists are the same and it is common to
+add items in the beginning of the list (into the <em>calling position</em>).</p><p>Note that <code>clojure.core/cons</code> does not create cons cells and lists in Clojure are not implemented
+as linked cons cells (like in many other dialects of Lisp).</p><h3 id="first-rest-next">first, rest, next</h3><p><code>clojure.core/first</code> returns the first item in the sequence. <code>clojure.core/next</code> and <code>clojure.core/rest</code>
+return the rest:</p><pre><code class="klipse-clojure nohighlight">(first (seq [1 2 3 4 5 6]))
+;; ⇒ 1
+
+(rest (seq [1 2 3 4 5 6]))
+;; ⇒ (2 3 4 5 6)
+</code></pre><p>the difference between them is what they return on a single element sequence:</p><pre><code class="klipse-clojure nohighlight">(rest (seq [:one]))
+;; ⇒ ()
+</code></pre><pre><code class="klipse-clojure nohighlight">(next (seq [:one]))
+;; ⇒ nil
+</code></pre><h3 id="lazy-sequences-in-clojure">Lazy Sequences in Clojure</h3><p><em>Lazy sequences</em> are produced by performing computation or I/O. They can be infinite
+or not have exact length (e.g. a sequence of all powers of 2 or an audio stream).</p><p>Lazy sequences is an broad topic and covered in the <a href="../laziness/index.html">Laziness</a> guide.</p><h2 id="key-operations-on-collections-and-sequences">Key Operations on Collections and Sequences</h2><p>Below is an overview of <code>clojure.core</code> functions that work on collections and sequences. Most of them
+work the same way for all types of collections, however, there are exception to this rule. For example,
+functions like <code>clojure.core/assoc</code>, <code>clojure.core/dissoc</code> and <code>clojure.core/get-in</code> only really
+make sense in the context of maps and other associative data structures (for example, records).</p><p><code>clojure.core/conj</code> adds elements to a collection in the most efficient manner, which depends on
+collection implementation details and won't be the same for vectors and lists.</p><p>In general, Clojure design emphasizes that operations on collections and sequences should be uniform and
+follow the principle of least surprise. In real world projects, however, the difference between
+algorithmic complexity and other runtime characteristics of various collection types often cannot
+be ignored. Keep this in mind.</p><p>You can find more information in the <a href="../core_overview/index.html">clojure.core Overview</a> and <a href="http://clojure.org/cheatsheet">Clojure cheatsheet</a>.</p><h3 id="count">count</h3><p>Returns a count of the number of items in a collection. An argument of nil returns 0.</p><pre><code class="klipse-clojure nohighlight">(count "Hello")
+;; ⇒ 5
+</code></pre><pre><code class="klipse-clojure nohighlight">(count [1 2 3 4 5 6 7])
+;; ⇒ 7
+</code></pre><pre><code class="klipse-clojure nohighlight">(count nil)
+;; ⇒ 0
+</code></pre><p>Note that count does not return in constant time for all collections. This can be determined with <code>counted?</code>.
+Keep in mind that lazy sequences must be realized to get a count of the items. This is often not intended and
+can cause a variety of otherwise cryptic errors.</p><pre><code class="klipse-clojure nohighlight">(counted? "Hello")
+;; ⇒ false
+</code></pre><pre><code class="klipse-clojure nohighlight">;; will be fully realized when using (count (range 10))
+(counted? (range 10))
+;; ⇒ false
+</code></pre><pre><code class="klipse-clojure nohighlight">;; Constant time return of (count)
+(counted? [1 2 3 4 5])
+;; ⇒ true
+</code></pre><h3 id="conj">conj</h3><p><code>conj</code> is short for "conjoin". As the name implies, <code>conj</code> takes a collection and argument(s) and returns the collection with those arguments added.</p><p>Adding items to a collection occurs at different places depending on the concrete type of collection.</p><p>List addition occurs at the beginning of the list. This is because accessing the head of the list is a constant time operation, and accessing
+the tail requires traversal of the entire list.</p><pre><code class="klipse-clojure nohighlight">(conj '(1 2) 3)
+;; ⇒ (3 1 2)
+</code></pre><p>Vectors have constant time access across the entire data structure. `'conj' thusly appends to the end of a vector.</p><pre><code class="klipse-clojure nohighlight">(conj [1 2] 3)
+;; ⇒ [1 2 3]
+</code></pre><p>Maps do not have guaranteed ordering, so the location that items are added is irrelevant. <code>conj</code> requires vectors of [key value] pairs to be
+added to the map.</p><pre><code class="klipse-clojure nohighlight">(conj {:a 1 :b 2 :c 3} [:d 4])
+;; ⇒ {:d 4, :a 1, :c 3, :b 2}
+</code></pre><pre><code class="klipse-clojure nohighlight">(conj {:cats 1 :dogs 2} [:ants 400] [:giraffes 13])
+;; ⇒ {:giraffes 13, :ants 400, :cats 1, :dogs 2}
+</code></pre><p>Sets also do not have guaranteed ordering. <code>conj</code> returns a set with the item added. As the concept of sets implies, added items will not duplicate equivalent items if they are present in the set.</p><pre><code class="klipse-clojure nohighlight">(conj #{1 4} 5)
+;; ⇒ #{1 4 5}
+</code></pre><pre><code class="klipse-clojure nohighlight">(conj #{:a :b :c} :b :c :d :e)
+;; ⇒ #{:a :c :b :d :e}
+</code></pre><h3 id="get">get</h3><p><code>get</code> returns the value for the specified key in a map or record, index of a vector or value in a set. If the key is not present,
+<code>get</code> returns nil or a supplied default value.</p><pre><code class="klipse-clojure nohighlight">;; val of a key in a map
+(get {:a 1 :b 2 :c 3} :b)
+;; ⇒ 2
+</code></pre><pre><code class="klipse-clojure nohighlight">;; index of a vector
+(get [10 15 20 25] 2)
+;; ⇒ 20
+</code></pre><pre><code class="klipse-clojure nohighlight">;; in a set, returns the value itself if present
+(get #{1 10 100 2 20 200} 1)
+;; ⇒ 1
+
+```klipse-clojure
+;; returns nil if key is not present
+(get {:a 1 :b 2} :c)
+;; ⇒ nil
+</code></pre><pre><code class="klipse-clojure nohighlight">;; vector does not have an _index_ of 4. nil is returned
+(get [1 2 3 4] 4)
+;; ⇒ nil
+</code></pre><pre><code class="klipse-clojure nohighlight">(defrecord Hand [index middle ring pinky thumb])
+(get (Hand. 3 4 3.5 2 2) :index)
+;; ⇒ 3
+</code></pre><p><code>get</code> also supports a default return value supplied as the last argument.</p><pre><code class="klipse-clojure nohighlight">;; index 4 does not exist. return default value
+(get [1 2 3 4] 4 "Not Found")
+;; ⇒ "Not Found"
+</code></pre><pre><code class="klipse-clojure nohighlight">;; key :c does not exist, so return default value of 3
+(get {:a 1 :b 2} :c 3)
+;; ⇒ 3
+</code></pre><h3 id="assoc">assoc</h3><p><code>assoc</code> takes a key and a value and returns a collection of the same type as the supplied collection with the key mapped to the new value.</p><p><code>assoc</code> is similar to <code>get</code> in how it works with maps, records or vectors. When applied to a map or record, the same type is returned with the key/value pairs added or modified.  When applied to a vector, a vector is returned with the key acting as an index and the index being replaced by the value.</p><p>Since maps and records can not contain multiple equivalent keys, supplying <code>assoc</code> with a key/value that exists in the one will cause <code>assoc</code> to return modify the key at that value in the result and not duplicate the key.</p><pre><code class="klipse-clojure nohighlight">(assoc {:a 1} :b 2)
+;; ⇒ {:b 2, :a 1}
+</code></pre><pre><code class="klipse-clojure nohighlight">(assoc {:a 1 :b 45 :c 3} :b 2)
+;; ⇒ {:a 1, :c 3, :b 2}
+</code></pre><pre><code class="klipse-clojure nohighlight">(defrecord Hand [index middle ring pinky thumb])
+(assoc (Hand. 3 4 3.5 2 2) :index 3.75)
+;; ⇒ #user.Hand{:index 3.75, :middle 4, :ring 3.5, :pinky 2, :thumb 2}
+</code></pre><p>When using <code>assoc</code> with a vector, the key is the index and the value is the value to assign to that index in the returned vector.
+The key must be &lt;= (count vector) or an index out of bounds error will occur.</p><pre><code class="klipse-clojure nohighlight">(assoc [1 2 76] 2 3) ; ⇒ [1 2 3]
+</code></pre><pre><code class="klipse-clojure nohighlight">;; index 5 does not exist. valid indexes for this vector are: 0, 1, 2
+(assoc [1 2 3] 5 6)
+;; the error here is slightly different in Clojure/Script
+</code></pre><p>When the key is equal to (count vector) <code>assoc</code> will add an item to the vector.</p><pre><code class="klipse-clojure nohighlight">(assoc [1 2 3] 3 4) ; ⇒ [1 2 3 4]
+</code></pre><h3 id="dissoc">dissoc</h3><p><code>dissoc</code> returns a map with the supplied keys, and subsequently their values, removed. Unlike <code>assoc</code>, <code>dissoc</code> does not work on vectors. When a record is provided, <code>dissoc</code> returns a map. For similar functionality with vectors, see <code>subvec</code> and <code>concat</code>.</p><pre><code class="klipse-clojure nohighlight">(dissoc {:a 1 :b 2 :c 3} :b)
+;; ⇒ {:a 1, :c 3}
+</code></pre><pre><code class="klipse-clojure nohighlight">(dissoc {:a 1 :b 14 :c 390 :d 75 :e 2 :f 51} :b :c :e)
+;; ⇒ {:a 1, :f 51, :d 75}
+</code></pre><pre><code class="klipse-clojure nohighlight">;; note that a map is returned, not a record.
+(defrecord Hand [index middle ring pinky thumb])
+;; always be careful with the bandsaw!
+(dissoc (Hand. 3 4 3.5 2 2) :ring)
+;; ⇒ {:index 3, :middle 4, :pinky 2, :thumb 2}
+</code></pre><h3 id="first">first</h3><p><code>first</code> returns the first item in the collection. <code>first</code> returns nil if the argument is empty or is nil.</p><p>Note that for collections that do not guarantee order like some maps and sets, the behaviour of <code>first</code> should not be relied on.</p><pre><code class="klipse-clojure nohighlight">(first (range 10))
+;; ⇒ 0
+</code></pre><pre><code class="klipse-clojure nohighlight">(first [:floor :piano :seagull])
+;; ⇒ :floor
+</code></pre><pre><code class="klipse-clojure nohighlight">(first [])
+;; ⇒ nil
+</code></pre><h3 id="rest">rest</h3><p><code>rest</code> returns a seq of items starting with the second element in the collection. <code>rest</code> returns an empty seq if the collection only contains a single item.</p><p><code>rest</code> should also not be relied on when using maps and sets unless you are sure ordering is guaranteed.</p><pre><code class="klipse-clojure nohighlight">(rest [13 1 16 -4])
+;; ⇒ (1 16 -4)
+</code></pre><pre><code class="klipse-clojure nohighlight">(rest '(:french-fry))
+;; ⇒ '()
+</code></pre><p>The behaviour of <code>rest</code> should be contrasted with <code>next</code>. <code>next</code> returns nil if the collection only has a single item. This is important when considering "truthiness" of values since an empty seq is "true" but nil is not.</p><pre><code class="klipse-clojure nohighlight">(if (rest '("stuff"))
+  (println "Does this print?"))
+;; yes, it prints.
+</code></pre><pre><code class="clojure">;; NEVER FINISHES EXECUTION!!!
+;; "done" is never reached because (rest x) is always a "true" value
+(defn inf
+  [x]
+  (if (rest x)
+    (inf (rest x))
+    "done"))
+</code></pre><h3 id="empty">empty?</h3><p><code>empty?</code> returns true if the collection has no items, or false if it has 1 or more items.</p><pre><code class="klipse-clojure nohighlight">(empty? [])
+;; ⇒ true
+</code></pre><pre><code class="klipse-clojure nohighlight">(empty? '(1 2 3))
+;; ⇒ false
+</code></pre><p>Do not confuse <code>empty?</code> with <code>empty</code>. This can be a source of great confusion:</p><pre><code class="klipse-clojure nohighlight">(if (empty [1 2 3]) ;; empty returns an empty seq, which is true! use empty? here.
+  "It's empty"
+  "It's not empty")
+;; ⇒ "It's empty"
+</code></pre><h3 id="empty-1">empty</h3><p><code>empty</code> returns an empty collection of the same type as the collection provided.</p><pre><code class="klipse-clojure nohighlight">(empty [1 2 3])
+;; ⇒ []
+</code></pre><pre><code class="klipse-clojure nohighlight">(empty {:a 1 :b 2 :c 3})
+;; ⇒ {}
+</code></pre><h3 id="not-empty">not-empty</h3><p><code>not-empty</code> returns nil if the collection has no items. If the collection contains items, the collection is returned.</p><pre><code class="klipse-clojure nohighlight">(not-empty '(:mice :elephants :children))
+;; ⇒ (:mice :elephants :children)
+</code></pre><pre><code class="klipse-clojure nohighlight">(not-empty '())
+;; ⇒ nil
+</code></pre><h3 id="contains">contains?</h3><p><code>contains</code> returns true if the provided <em>key</em> is present in a collection. <code>contains</code> is similar to <code>get</code> in that vectors treat the key as an index. <code>contains</code> will always return false for lists.</p><pre><code class="klipse-clojure nohighlight">(contains? {:a 1 :b 2 :c 3} :c)
+;; ⇒ true
+</code></pre><pre><code class="klipse-clojure nohighlight">;; true if index 2 exists
+(contains? ["John" "Mary" "Paul"] 2)
+;; ⇒ true
+</code></pre><pre><code class="klipse-clojure nohighlight">;; false if index 5 does not exist
+(contains? ["John" "Mary" "Paul"] 5)
+;; ⇒ false
+</code></pre><pre><code class="klipse-clojure nohighlight">;; "Paul" does not exist as an index
+(contains? ["John" "Mary" "Paul"] "Paul")
+;; ⇒ false
+</code></pre><pre><code class="klipse-clojure nohighlight">;; lists are not supported. contains? won't traverse a collection for a result.
+(contains? '(1 2 3) 0)
+;; ⇒ java.lang.IllegalArgumentException: contains? not supported on type: clojure.lang.PersistentList
+</code></pre><h3 id="some">some</h3><p><code>some</code> will apply a predicate to each value in a collection until a non-false/nil result is returned then immediately return that result.</p><p>Since collections are "true" values, this makes it possible to return the first result itself rather than simply <code>true</code>.</p><pre><code class="klipse-clojure nohighlight">(some even? [1 2 3 4 5])
+;; ⇒ true
+</code></pre><pre><code class="klipse-clojure nohighlight">;; predicate returns the value rather than simply true
+(some #(if (even? %) %) [1 2 3 4 5])
+;; ⇒ 2
+</code></pre><p>Since maps can be used as functions, you can use a map as a predicate. This will return the value of the first key in the collection that is also in the map.</p><pre><code class="klipse-clojure nohighlight">(some {:a 1 :b 5} [:h :k :d :b])
+;; ⇒ 5
+</code></pre><p>Sets can also be used as functions and will return the first item in the collection that is present in the set.</p><pre><code class="klipse-clojure nohighlight">(some #{4} (range 20))
+;; ⇒ 4
+</code></pre><h3 id="every">every?</h3><p><code>every</code> returns true if the predicate returns true for every item in the collection, otherwise it returns false.</p><pre><code class="klipse-clojure nohighlight">(every? even? (range 0 10 2))
+;; ⇒ true
+</code></pre><pre><code class="klipse-clojure nohighlight">;; set can be used to see if collection only contains items in the set.
+(every? #{2 3 4} [2 3 4 2 3 4])
+;; ⇒ true
+</code></pre><h3 id="map">map</h3><p><code>map</code> is used to sequence of values and generate a new sequence of
+values.</p><p>Essentially, you're creating a <em>mapping</em> from an old sequence of values
+to a new sequence of values.</p><pre><code class="klipse-clojure nohighlight">(def numbers
+  (range 1 10))
+;; ⇒ (1 2 3 4 5 6 7 8 9)
+</code></pre><pre><code class="klipse-clojure nohighlight">(map (partial * 2) numbers)
+;; ⇒ (2 4 6 8 10 12 14 16 18)
+</code></pre><pre><code class="klipse-clojure nohighlight">(def scores
+  {:clojure 10
+   :scala 9
+   :jruby 8})
+
+(map #(str "Team " (name (key %)) " has scored " (val %)) scores)
+;; ⇒ ("Team scala has scored 9" "Team jruby has scored 8" "Team clojure has scored 10")
+</code></pre><h3 id="reduce">reduce</h3><p><code>reduce</code> takes a sequence of values and a function. It applies that
+function repeatedly with the sequence of values to <em>reduce</em> it to a
+single value.</p><pre><code class="klipse-clojure nohighlight">(def numbers
+  (range 1 10))
+;; ⇒ (1 2 3 4 5 6 7 8 9)
+</code></pre><pre><code class="klipse-clojure nohighlight">(reduce + numbers)
+;; ⇒ 45
+</code></pre><pre><code class="klipse-clojure nohighlight">(def scores
+  {:clojure 10
+   :scala 9
+   :jruby 8})
+
+(reduce + (vals scores))
+;; ⇒ 27
+</code></pre><pre><code class="klipse-clojure nohighlight">;; Provide an initial value for the calculation
+(reduce + 10 (vals scores))
+;; ⇒ 37
+</code></pre><h3 id="filter">filter</h3><p><code>filter</code> returns a lazy sequence of items that return <code>true</code> for the provided predicate. Contrast to <code>remove</code>.</p><pre><code class="klipse-clojure nohighlight">(filter even? (range 10))
+;; ⇒ (0 2 4 6 8)
+</code></pre><pre><code class="klipse-clojure nohighlight">(filter #(if (&lt; (count %) 5) %) ["Paul" "Celery" "Computer" "Rudd" "Tayne"])
+;; ⇒ ("Paul" "Rudd")
+</code></pre><p>When using sets with <code>filter</code>, remember that if nil or false is in the set and in the collection, then the predicate will return itself: <code>nil</code>.</p><p>In this example, when nil and false are tested with the predicate, the predicate returns nil. This is because if the item is present in the set it is returned. This will cause that item to /not/ be included in the returned lazy-sequence.</p><pre><code class="klipse-clojure nohighlight">(filter #{:nothing :something nil}
+       [:nothing :something :things :someone nil false :pigeons])
+;; ⇒ (:nothing :something)
+</code></pre><h3 id="remove">remove</h3><p><code>remove</code> returns a lazy sequence of items that return <code>false</code> or <code>nil</code> for the provided predicate. Contrast to <code>filter</code>.</p><pre><code class="klipse-clojure nohighlight">(remove even? (range 10))
+;; ⇒ (1 3 5 7 9)
+</code></pre><pre><code class="klipse-clojure nohighlight">;; relative complement. probably useless?
+(remove {:a 1 :b 2} [:h :k :z :b :s])
+;; ⇒ (:h :k :z :s)
+</code></pre><p>When using sets with <code>remove</code>, remember that if nil or false is in the set and in the collection, then the predicate will return itself: <code>nil</code>.
+This will cause that item to be included in the returned lazy sequence.</p><p>In this example, when nil and false are tested with the predicate, the predicate returns nil. This is because if the item is present in the set it is returned.</p><pre><code class="klipse-clojure nohighlight">(remove #{:nothing :something nil}
+        [:nothing :something :things :someone nil false :pigeons])
+;; ⇒ (:things :someone nil false :pigeons)
+</code></pre><h3 id="iterate">iterate</h3><p><code>iterate</code> takes a function and an initial value, returns the result of
+applying the function on that initial value, then applies the function
+again on the resultant value, and repeats forever, lazily. Note that the
+function <em>iterates</em> on the value.</p><pre><code class="klipse-clojure nohighlight">(take 5 (iterate inc 1))
+;; ⇒ (1 2 3 4 5)
+</code></pre><pre><code class="klipse-clojure nohighlight">(defn multiply-by-two
+  [value]
+  (* 2 value))
+
+(take 10 (iterate multiply-by-two 1))
+;; ⇒ (1 2 4 8 16 32 64 128 256 512)
+</code></pre><h3 id="get-in">get-in</h3><p><code>get-in</code> is used to <em>get</em> a value that is deep <em>inside</em> a data
+structure.</p><p>You have to provide the data structure and a sequence of keys, where a
+key is valid at each subsequent level of the nested data structure.</p><p>If the sequence of keys does not lead to a valid path, <code>nil</code> is
+returned.</p><pre><code class="klipse-clojure nohighlight">(def family
+  {:dad {:shirt 5
+         :pants 6
+         :shoes 4}
+   :mom {:dress {:work 6
+                 :casual 7}
+         :book 3}
+   :son {:toy 5
+         :homework 1}})
+</code></pre><pre><code class="klipse-clojure nohighlight">(get-in family [:dad :shirt])
+;; ⇒ 5
+</code></pre><pre><code class="klipse-clojure nohighlight">(get-in family [:mom :dress])
+;; ⇒ {:work 6, :casual 7}
+</code></pre><pre><code class="klipse-clojure nohighlight">(get-in family [:mom :dress :casual])
+;; ⇒ 7
+</code></pre><pre><code class="klipse-clojure nohighlight">(get-in family [:son :pants])
+;; ⇒ nil
+
+```klipse-clojure
+(def locations
+  [:office :home :school])
+
+(get-in locations [1])
+;; ⇒ :home
+</code></pre><h3 id="update-in">update-in</h3><p><code>update-in</code> is used to <em>update</em> a value deep inside a structure
+<em>in-place</em>.</p><p>Note that since data structures are immutable, it only returns a
+"modified" data structure, it does not actually alter the original
+reference.</p><p>The "update" function takes the old value and returns a new value which
+<code>update-in</code> uses in the new modified data structure.</p><pre><code class="klipse-clojure nohighlight">(def family
+  {:dad {:shirt 5
+         :pants 6
+         :shoes 4}
+   :mom {:dress {:work 6
+                 :casual 7}
+         :book 3}
+   :son {:toy 5
+         :homework 1}})
+</code></pre><pre><code class="klipse-clojure nohighlight">(update-in family [:dad :pants] inc)
+
+;; ⇒ {:son {:toy 5, :homework 1}, :mom {:dress {:work 6, :casual 7}, :book 3}, :dad {:shoes 4, :shirt 5, :pants 7}}
+</code></pre><p>Notice that "pants" gets incremented</p><pre><code class="klipse-clojure nohighlight">(def locations
+  [:office :home :school])
+
+(update-in locations [2] #(keyword (str "high-" (name %))))
+;; ⇒ [:office :home :high-school]
+</code></pre><h3 id="assoc-in">assoc-in</h3><p><code>assoc-in</code> is used to <em>associate</em> a new value deep inside a structure
+<em>in-place</em>.</p><p>Note that since data structures are immutable, it only returns a
+"modified" data structure, it does not actually alter the original
+reference.</p><p>Note the difference between <code>update-in</code> and <code>assoc-in</code>: <code>update-in</code>
+takes a function that applies on the old value to return a new value,
+whereas <code>assoc-in</code> takes a new value as-is.</p><pre><code class="klipse-clojure nohighlight">(def family
+  {:dad {:shirt 5
+         :pants 6
+         :shoes 4}
+   :mom {:dress {:work 6
+                 :casual 7}
+         :book 3}
+   :son {:toy 5
+         :homework 1}})
+</code></pre><pre><code class="klipse-clojure nohighlight">(assoc-in family [:son :crayon] 3)
+;; ⇒ {:son {:toy 5, :crayon 3, :homework 1}, :mom {:dress {:work 6, :casual 7}, :book 3}, :dad {:shoes 4, :shirt 5, :pants 6}}
+</code></pre><pre><code class="klipse-clojure nohighlight">(def locations
+  [:office :home :school])
+
+(assoc-in locations [3] :high-school)
+;; ⇒ [:office :home :school :high-school]
+</code></pre><h3 id="keys">keys</h3><p><code>keys</code> returns a sequence of the keys in a map or record.</p><pre><code class="klipse-clojure nohighlight">(keys {1 "one" 2 "two" 3 "three"})
+;; ⇒ (1 2 3)
+</code></pre><pre><code class="klipse-clojure nohighlight">(defrecord Hand [index middle ring pinky thumb])
+(keys (Hand. 2 4 3 1 2))
+;; ⇒ (:index :middle :ring :pinky :thumb)
+</code></pre><h3 id="vals">vals</h3><p><code>vals</code> returns a sequence of vals in a map or record.</p><pre><code class="klipse-clojure nohighlight">(vals {:meows 20 :barks 2 :moos 5})
+;; ⇒ (5 2 20)
+</code></pre><pre><code class="klipse-clojure nohighlight">(defrecord Hand [index middle ring pinky thumb])
+(vals (Hand. 1 2 3 4 5))
+;; ⇒ (1 2 3 4 5)
+</code></pre><h3 id="select-keys">select-keys</h3><p><code>select-keys</code> is used to extract a subset of a map:</p><pre><code class="klipse-clojure nohighlight">(def family
+  {:dad {:shirt 5
+         :pant 6
+         :shoes 4}
+   :mom {:dress {:work 6
+                 :casual 7}
+         :book 3}
+   :son {:toy 5
+         :homework 1}})
+</code></pre><pre><code class="klipse-clojure nohighlight">(select-keys family [:dad])
+;; ⇒ {:dad {:shoes 4, :shirt 5, :pant 6}}
+</code></pre><pre><code class="klipse-clojure nohighlight">(select-keys family [:mom :son])
+;; ⇒ {:son {:toy 5, :homework 1}, :mom {:dress {:work 6, :casual 7}, :book 3}}
+</code></pre><h3 id="take">take</h3><p><code>take</code> returns a lazy sequence of the first <code>n</code> items of a collection <code>coll</code>.</p><pre><code class="klipse-clojure nohighlight">(take 3 [1 3 5 7 9])
+;; ⇒ (1 3 5)
+</code></pre><pre><code class="klipse-clojure nohighlight">(type (take 3 (range)))
+;; ⇒ clojure.lang.LazySeq
+</code></pre><p>If there are fewer than <code>n</code> items in <code>coll</code>, all items will be returned.</p><pre><code class="klipse-clojure nohighlight">(take 5 [1 2 3])
+;; ⇒ (1 2 3)
+</code></pre><pre><code class="klipse-clojure nohighlight">(take 3 nil)
+;; ⇒ ()
+</code></pre><h3 id="drop">drop</h3><p><code>drop</code> drops <code>n</code> items from a collection <code>coll</code> and returns a lazy sequence of the rest of it.</p><pre><code class="klipse-clojure nohighlight">(drop 3 '(0 1 2 3 4 5 6))
+;; ⇒ (3 4 5 6)
+</code></pre><pre><code class="klipse-clojure nohighlight">(drop 2 [1 2])
+;; ⇒ ()
+</code></pre><pre><code class="klipse-clojure nohighlight">(drop 2 nil)
+;; ⇒ ()
+</code></pre><h3 id="take-while">take-while</h3><p><code>take-while</code> returns a lazy sequence of items from a collection as long
+as the predicate returns <code>true</code> for each item:</p><pre><code class="klipse-clojure nohighlight">(take-while #(&lt; % 5) (range))
+;; ⇒ (0 1 2 3 4)
+</code></pre><h3 id="drop-while">drop-while</h3><p><code>drop-while</code> drops items from a collection as long as the predicate
+returns <code>false</code> for the item and when the first non-false item is found,
+it returns a lazy sequence from that item onwards:</p><pre><code class="klipse-clojure nohighlight">(drop-while #(&lt; % 5) (range 10))
+;; ⇒ (5 6 7 8 9)
+</code></pre><h2 id="transients">Transients</h2><p>Clojure data structures are immutable, they do not change. Mutating them produces
+a new data structure that internally has structural sharing with the original
+one. This makes a whole class of concurrency hazards go away but has some
+performance penalty and additional GC pressure.</p><p>For cases when raw performance for a piece of code is more important than safety,
+Clojure provides mutable versions of vectors and unsorted maps. They are known
+as <em>transients</em> and should only be used for locals and as an optimization
+technique after profiling.</p><p>Transients are produced from immutable data structures using the <code>clojure.core/transient</code>
+function:</p><pre><code class="klipse-clojure nohighlight">(let [m (transient {})]
+  (assoc! m :key "value") ;; mutates the transient in place!
+  (count m))
+;; ⇒ 1
+</code></pre><p>Note that <code>clojure.core/transient</code> does not affect nested collections, for
+example, values in a map of keywords to vectors.</p><p>To mutate transients, use <code>clojure.core/assoc!</code>, <code>clojure.core/dissoc!</code> and
+<code>clojure.core/conj!</code>. The exclamation point at the end hints that these
+functions work on transients and modify data structures in place, which
+is not safe of data structures are shared between threads.</p><p>To create an immutable data structure out of a transient, use <code>clojure.core/persistent!</code>:</p><pre><code class="klipse-clojure nohighlight">(let [m (transient {})]
+        (assoc! m :key "value")
+        (persistent! m)) ;; ⇒ {:key "value"}
+</code></pre><p>In conclusion: use transients only as an optimization technique and only
+after profiling and identifying hot spots in your code. Guessing is the
+shortest way we know to blowing the performance.</p><h2 id="custom-collections-and-sequences">Custom Collections and Sequences</h2><p>It is possible to develop custom collection types in Clojure or Java and have
+<code>clojure.core</code> functions work on them just like they do on builtin types.</p><p>TBD: <a href="https://github.com/clojure-doc/clojure-doc.github.io#how-to-contribute">How to Contribute</a></p><h2 id="wrapping-up">Wrapping Up</h2><p>When working with Clojure, it is common to operate and transform collections and sequences.
+Clojure's core library unify operations on collections and sequences where possible.
+This extends to Java collections, arrays and iterable objects for seamless interoperability.</p><p>Most of the time, whenever you need a function that transforms sequences, chances are, there is
+one already that does that in <code>clojure.core</code> or you can compose more than one <code>clojure.core</code> function
+to achieve the same result.</p><h2 id="contributors">Contributors</h2><p>Michael Klishin <a href="mailto:michael@defprotocol.org">michael@defprotocol.org</a>
+Robert Randolph <a href="mailto:audiolabs@gmail.com">audiolabs@gmail.com</a>
+satoru <a href="mailto:satorulogic@gmail.com">satorulogic@gmail.com</a></p>
+
+    <div id="prev-next">
+        
+        <a href="../namespaces/index.html">&laquo; Clojure Namespaces and Vars</a>
+        
+        
+        ||
+        
+        
+        <a href="../functions/index.html">Functions in Clojure &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+ <link rel="stylesheet" type="text/css" href="https://storage.googleapis.com/app.klipse.tech/css/codemirror.css">
+<script>
+window.klipse_settings = {
+  "selector" : ".klipse-clojure"
+};
+</script>
+<script src="https://storage.googleapis.com/app.klipse.tech/plugin/js/klipse_plugin.js"></script> 
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/language/concurrency_and_parallelism/index.html b/clones/clojure-doc.org/articles/language/concurrency_and_parallelism/index.html
new file mode 100644
index 00000000..df30fb7b
--- /dev/null
+++ b/clones/clojure-doc.org/articles/language/concurrency_and_parallelism/index.html
@@ -0,0 +1,755 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Concurrency and Parallelism in Clojure</title>
+    
+
+<meta name="description" content="This guide covers:">
+
+<meta property="og:description" content="This guide covers:">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/language/concurrency_and_parallelism/" />
+<meta property="og:title" content="Concurrency and Parallelism in Clojure" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/language/concurrency_and_parallelism/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Concurrency and Parallelism in Clojure</h2>
+    </div>
+    
+    <p>This guide covers:</p><ul><li>Clojure's identity/value separation</li><li>Clojure reference types and their concurrency semantics: atoms, refs, agents, vars</li><li>Dereferencing</li><li>Delays, futures and promises</li><li>Watches and validators</li><li>How to use java.util.concurrent from Clojure</li><li>Other approaches to concurrency available on the JVM</li><li>Other topics related to concurrency</li></ul><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons Attribution 3.0 Unported License</a>
+(including images &amp; stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on Github</a>.</p><h2 id="what-version-of-clojure-does-this-guide-cover">What Version of Clojure Does This Guide Cover?</h2><p>This guide covers Clojure 1.5.</p><h2 id="before-you-read-this-guide">Before You Read This Guide</h2><p>This is one of the most hardcore guides of the entire Clojure documentation
+project. It describes concepts that are simple but may seem foreign at first.
+These concepts are some of the key points of Clojure
+design. Understanding them may take some time for folks without
+a concurrent programming background. Don't let this learning curve
+discourage you.</p><p>If some parts are not clear, please ask for clarification <a href="https://groups.google.com/forum/?fromgroups#!forum/clojure">on the
+mailing
+list</a> or
+<a href="https://github.com/clojure-doc/clojure-doc.github.io/issues">file an issue</a> on GitHub.
+We will work hard on making this guide easy to follow with edits and
+images to illustrate the concepts.</p><h2 id="introduction-and-terminology">Introduction and Terminology</h2><p>Before we get to the Clojure features related to concurrency, lets lay a foundation and briefly
+cover some terminology.</p><table class="table-striped table-bordered table"><thead><tr><th>Term</th><th>Definition This Guide Uses</th></tr></thead><tbody><tr><td>Concurrency</td><td>When multiple threads are making progress, whether it is via time-slicing or parallelism</td></tr><tr><td>Parallelism</td><td>A condition that arises when at least two threads are executing simultaneously, e.g., on multiple cores or CPUs.</td></tr><tr><td>Shared State</td><td>When multiple threads of execution need to mutate (modify) one or more pieces of program state (e.g., variables, identities)</td></tr><tr><td>Mutable Data Structures</td><td>Data structures that, when changed, are updated "in place"</td></tr><tr><td>Immutable Data Structures</td><td>Data structures that, when changed, produce new data structures (copies), possibly with optimizations such as internal structural sharing</td></tr><tr><td>Concurrency Hazards</td><td>Conditions that occur in concurrent programs that prevent program from being correct (behaving the way its authors intended).</td></tr><tr><td>Shared Mutable State</td><td>When shared state is made of mutable data structures. A ripe ground for concurrency hazards.</td></tr></tbody></table><p>There are many concurrency hazards, some of the most common and well known are:</p><table class="table-striped table-bordered table"><thead><tr><th>Concurrency Hazard</th><th>Brief Description</th></tr></thead><tbody><tr><td>Race Condition</td><td>A condition when the outcome is dependent on timing or relative ordering of events</td></tr><tr><td>Deadlock</td><td>When two or more threads are waiting on each other to finish or release a shared resource, thus waiting forever and not making any progress</td></tr><tr><td>Livelock</td><td>When two or more threads are technically performing computation but not doing any useful work (not making progress), for example,
+          because they endlessly pass a piece of data to each other but never actually process it</td></tr><tr><td>Starvation</td><td>When a thread is not given regular access to a shared resource and cannot make progress.</td></tr></tbody></table><p>These hazards are not exclusive to threads and can happen with OS
+processes, runtime processes and any other execution processes. They
+are also not specific to a particular runtime or VM (e.g., the JVM) or
+programming language. Admittedly, some languages make it significantly
+easier to write correct, safe concurrent programs, but none are
+completely immune to concurrency hazards. More often than not,
+concurrency hazards are algorithmic problems, languages just encourage
+or discourage certain practices and techniques.</p><p><em>Thread-safe</em> code is code that is always executed correctly and does
+not suffer from concurrency hazards even when executed concurrently
+from multiple threads.</p><h2 id="overview">Overview</h2><p>One of Clojure design goals was to make concurrent programming
+easier. The thinking is that as modern CPUs add more and more cores
+and the number of CPUs is increasing as well, the biggest contributor
+to application throughput will come from making use of those
+resources.</p><p>The key design decision was making Clojure data structures immutable
+(persistent) and separating the concepts of <em>identity</em> and
+<em>value</em>. The importance of immutability cannot be over-emphasized:
+immutable values can be safely shared between threads, eliminate many
+concurrency hazards, and ultimately make it easier for developers to
+reason about their programs.</p><p>However, a language that only has immutable data structures and no way
+to change (mutate) program state is not very useful. The
+identity/value separation makes state mutations (e.g., incrementing a
+counter or adding an element to a list) possible in ways that
+have known guarantees with respect to concurrency. This separation largely
+eliminates the need for explicit use of locks, which is possible in Clojure
+but typically not necessary.</p><p>To put it another way: "changing variables" in Clojure happens
+differently from many other languages; in ways that are predictable
+from the concurrency perspective and which eliminate many concurrency hazards.</p><p>Next lets take a closer look to the identity/value separation.</p><h2 id="identityvalue-separation-on-state-and-identity">Identity/Value Separation ("on State and Identity")</h2><p>In Clojure, <em>values</em> are immutable. They never change. For example, a number is a value.
+A map <code>{:language "Clojure"}</code> is a value. A vector with 3 elements is a value.</p><p>When you attempt to modify a value (a data structure), a new value is produced instead. These
+are known as <em>persistent data structures</em> (the word "persistent" has nothing to do with
+storing data on disk).</p><p>An <em>identity</em> is a named entity (e.g., a list of active chat group
+members or a counter) that changes over time and at any given moment references a value.
+For example, the current value of a counter may be <code>42</code>. After incrementing it, the value
+is <code>43</code> but it is still the same counter --- the same identity. This is different from, say, Java
+or Ruby, where variables serve as identities that (typically) point to a mutable value
+and which are modified in place.</p><p><img src="https://clojure-doc.org/assets/images/language/concurrency_and_parallelism/identity_value.png" alt="identity_value" /></p><p>Identities in Clojure can be of several types, known as <em>reference types</em>.</p><h2 id="clojure-reference-types">Clojure Reference Types</h2><h3 id="overview-1">Overview</h3><p>In Clojure's world view, concurrent operations can be roughly
+classified as coordinated or uncoordinated, and synchronous or
+asynchronous. Different reference types in Clojure have their own
+concurrency semantics and cover different kind of operations:</p><table class="table-bordered table"><thead><tr><th></th><th>Coordinated</th><th>Uncoordinated</th></tr></thead><tbody><tr><td style="font-weight: bold;">Synchronous</td><td><a href="index.html#refs">Refs</a></td><td><a href="index.html#atoms">Atoms</a></td></tr><tr><td style="font-weight: bold;">Asynchronous</td><td>—</td><td><a href="index.html#agents">Agents</a></td></tr></tbody></table><dl><dt>Coordinated</dt><dd>An operation that depends on cooperation from other operations (possibly, other operations at least do not interfere with it)
+      in order to produce correct results. For example, a banking operation that involves more than one account.
+   </dd><dt>Uncoordinated</dt><dd>An operation that does not affect other operations in any way. For example, when downloading 100 Web pages concurrently,
+      each operation does not affect the others.
+  </dd><dt>Synchronous</dt><dd>When the caller's thread waits, blocks, or sleeps until it has access to a given resource or context.</dd><dt>Asynchronous</dt><dd>Operations that can be started or scheduled without blocking the caller's thread.</dd></dl><p>One more reference type, <a href="index.html#vars">vars</a>, supports dynamic scoping and thread-local storage.</p><h3 id="atoms">Atoms</h3><p>Atoms are references that change atomically (changes become immediately visible to all threads,
+changes are guaranteed to be synchronized by the JVM). If you come from a Java background,
+atoms are basically atomic references from <code>java.util.concurrent</code> with a functional twist
+to them. Atoms are identities that implement synchronous, uncoordinated, atomic updates.</p><p>Lets jump right in and demonstrate how atoms work using an example. We know that Clojure data
+structures are immutable by default. Adding an element to a collection really produces a new
+collection. In such case, how does one keep a shared list (say, of active connections to a server
+or recently crawled URLs) and mutate it in a thread-safe manner? We will demonstrate how to
+accomplish this with an atom.</p><p>To create an atom, use the <code>clojure.core/atom</code> function. Its argument will serve as the atom's
+initial value:</p><pre><code class="clojure">(def currently-connected (atom []))
+</code></pre><p>The line above makes the atom <code>currently-connected</code> an empty vector. To access an atom's value, use
+<code>clojure.core/deref</code> or the <code>@atom</code> reader form:</p><pre><code class="clojure">(def currently-connected (atom []))
+
+@currently-connected
+;; ⇒ []
+(deref currently-connected)
+;; ⇒ []
+currently-connected
+;; ⇒ #&lt;Atom@614b6b5d: []&gt;
+</code></pre><p>As the returned values demonstrate, the atom itself is a reference. To
+access its current value, you <em>dereference</em> it. Dereferencing will be
+covered in more detail later in this guide. For now, it is sufficient
+to say that dereferencing returns the current value of an atom. (Other
+Clojure reference types as well as a few specialized data structures
+can be dereferenced as well.)</p><p>Locals can be atoms, too:</p><pre><code class="clojure">(let [xs (atom [])]
+  @xs)
+;; ⇒ []
+</code></pre><p>Now to the most interesting part: adding elements to the collection.</p><p>To mutate an atom, we can use <code>clojure.core/swap!</code>.</p><p><code>swap!</code> takes an atom, a function and optionally some other args, swaps the current value of the atom to be the return value of calling the function with the current value of the atom and the args:</p><pre><code class="clojure">(swap! currently-connected conj "chatty-joe")
+;; ⇒ ["chatty-joe"]
+currently-connected
+;; ⇒ #&lt;Atom@614b6b5d: ["chatty-joe"]&gt;
+@currently-connected
+;; ⇒ ["chatty-joe"]
+</code></pre><p>To demonstrate this graphically, initial atom state looks like this:</p><p><img src="https://clojure-doc.org/assets/images/language/concurrency_and_parallelism/atom_state1.png" alt="Atom state 1" /></p><p>and then we mutated it with <code>swap!</code>:</p><p><img src="https://clojure-doc.org/assets/images/language/concurrency_and_parallelism/atom_state2.png" alt="Atom state 2" /></p><p>For the readers familiar with the atomic types from the <a href="http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/atomic/package-summary.html">java.util.concurrent.atomic</a> package,
+this should sound very familiar. The only difference is that instead of setting a value, atoms are mutated
+with a function. This is both because Clojure is a functional language and because with this approach,
+<code>clojure.core/swap!</code> can <em>retry the operation</em> safely. This implies that the function you provide to
+<code>swap!</code> is <em>pure</em> (has no side effects).</p><p>Occasionally you will need to mutate the value of an atom the same way you would with atomic references in Java:
+by setting them to a specific value. This is what <code>clojure.core/reset!</code> does. It takes an atom and the new value:</p><pre><code class="clojure">@currently-connected
+;; ⇒ ["chatty-joe"]
+(reset! currently-connected [])
+;; ⇒ []
+@currently-connected
+;; ⇒ []
+</code></pre><p><code>reset!</code> may be useful in test suites to reset an atom's state between test executions, but it should be
+used sparingly in your implementation code. Consider using <code>swap!</code> first.</p><p><em>TBD: demonstrate retries under high update rates</em></p><h4 id="summary-and-use-cases">Summary and Use Cases</h4><p>Atoms is the most commonly used concurrent feature in Clojure. It covers many cases and lets developers
+avoid explicit locking. Atoms cover a lot of use cases and are very fast. It's fair to say that
+when you need uncoordinated reference types (e.g., not Software Transactional Memory), the rule of
+thumb is, "start with an atom, then see".</p><p>It is not uncommon to initialize an atom in a local and then return it from the function and share
+a piece of state with other functions and/or threads.</p><h3 id="agents">Agents</h3><p>Agents are references that are updated asynchronously: updates happen at a later, unknown point
+in time, in a thread pool. Agents are identities that implement uncoordinated, asynchronous updates.</p><p>A small but useful example of using an agent is as a counter. For
+example, suppose we want to track how often page downloads in a Web
+crawler respond with 40x and 50x status codes. The simplest version
+can look like this:</p><pre><code class="clojure">(def errors-counter (agent 0))
+;; ⇒ #'user/errors-counter
+errors-counter
+;; ⇒ #&lt;Agent@6a6287b2: 0&gt;
+@errors-counter
+;; ⇒ 0
+(deref errors-counter)
+;; ⇒ 0
+</code></pre><p>One can immediately make several observations: just like atoms, agents are references. To get
+the current value of an agent, we need to <em>dereference</em> it using <code>clojure.core/deref</code> or
+the <code>@agent</code> reader macro.</p><p>To mutate an agent, we use <code>clojure.core/send</code> and <code>clojure.core/send-off</code>:</p><pre><code class="clojure">@errors-counter
+;; ⇒ 0
+(send errors-counter inc)
+;; ⇒ #&lt;Agent@6a6287b2: 0&gt;
+@errors-counter
+;; ⇒ 1
+
+;; 10 is an additional parameter. The + function will be invoked as `(+ @errors-counter 10)`.
+(send errors-counter + 10)
+;; ⇒ #&lt;Agent@6a6287b2: 1&gt;
+@errors-counter
+;; ⇒ 11
+</code></pre><p><code>send</code> and <code>send-off</code> are largely similar. The difference is in how they are implemented. <code>send</code> uses a
+fixed-size thread pool so using blocking operations with it won't yield good throughput. <code>send-off</code>
+uses a growing thread-pool so blocking operations is not a problem for it as long as there are resources
+available to the JVM to create and run all the threads. On a 4-8 GB machine with 4 cores and stock
+OS settings you can expect up to a couple of thousand I/O-bound threads to work without running
+the system out of kernel resources.</p><h4 id="using-custom-executors-with-agents">Using Custom Executors With Agents</h4><p>Agents can be used (and abused) for arbitrary code execution in a thread pool. Because the default
+thread pool Clojure maintains will not be a good fit for all use cases, Clojure 1.5 introduced
+a function that lets you control what thread pool (executor) is used by <code>clojure.core/send</code>:
+<code>clojure.core/set-agent-send-executor!</code>.</p><pre><code class="clojure">(import java.util.concurrent.Executors)
+
+(set-agent-send-executor! (Executors/newFixedThreadPool 32))
+;; clojure.core/send now will use the fixed size thread pool with 32 threads
+</code></pre><p>The default thread pool size is <code>number of available CPU cores + 2</code>.</p><p><code>clojure.core/set-agent-send-off-executor!</code> is a similar function that controls what
+thread pool <code>clojure.core/send-off</code> will use.</p><p>Finally, another new function in 1.5 is <code>clojure.core/send-via</code> which is like `` but lets you specify
+an executor to be used on a case-by-case basis:</p><pre><code class="clojure">(import java.util.concurrent.Executors)
+
+(def custom-pool (Executors/newFixedThreadPool 32))
+;; just like clojure.core/send but will use custom-pool instead
+;; of an internally maintained one
+(send-via custom-pool stream-agent inc)
+</code></pre><h3 id="agents-and-software-transactional-memory">Agents and Software Transactional Memory</h3><p>We haven't introduced refs and the concept of Software Transactional Memory yet. It will be covered later in this
+guide. Here it's sufficient to mention that agents are STM-aware and can be safely used inside transactions.</p><h3 id="agents-and-error-handling">Agents and Error Handling</h3><p>Functions that modify an agent's state will not always return successfully in the real world. Sometimes they
+will fail. For example:</p><pre><code class="clojure">@errors-counter
+;; ⇒ 11
+(send errors-counter / 0)
+;; Evaluation aborted.
+;; ⇒ nil
+</code></pre><p>This puts the agent into the <em>failed</em> state. Failed agents will re-raise the exception that caused them
+to fail every time their state changed is attempted:</p><pre><code class="clojure">(send errors-counter / 0)
+;; ⇒ #&lt;Agent@6a6287b2: 10&gt;
+(send errors-counter inc)
+;; Evaluation aborted.
+</code></pre><p>To access the exception that occured during the agent's state mutation, use <code>clojure.core/agent-error</code>:</p><pre><code class="clojure">(send errors-counter / 0)
+;; Evaluation aborted.
+;; ⇒ nil
+(agent-error errors-counter)
+;; ⇒ #&lt;ArithmeticException java.lang.ArithmeticException: Divide by zero&gt;
+</code></pre><p>It returns an exception. Agents can be restarted with <code>clojure.core/restart-agent</code> that takes an agent
+and a new initial value:</p><pre><code class="clojure">(restart-agent errors-counter 0)
+;; ⇒ 0
+(send errors-counter + 10)
+;; ⇒ #&lt;Agent@6a6287b2: 0&gt;
+@errors-counter
+;; ⇒ 10
+</code></pre><p>If you'd prefer an agent to ignore exceptions instead of going into the <em>failure mode</em>, <code>clojure.core/agent</code>
+takes an option that controls this behavior: <code>:error-mode</code>. Because completely ignoring errors is rarely a good
+idea, when the error mode is set to <code>:continue</code> you must also pass an error handler function:</p><pre><code class="clojure">(def errors-counter (agent 0
+                           :error-mode    :continue
+                           :error-handler (fn [failed-agent ^Exception exception]
+                                            (println (.getMessage exception)))))
+;; ⇒ #'user/errors-counter
+(send errors-counter inc)
+;; ⇒ #&lt;Agent@5620e147: 1&gt;
+(send errors-counter inc)
+;; ⇒ #&lt;Agent@5620e147: 2&gt;
+(send errors-counter / 0)
+;; output: "Divide by zero"
+;; ⇒ #&lt;Agent@5620e147: 2&gt;
+(send errors-counter inc)
+;; ⇒ #&lt;Agent@5620e147: 3&gt;
+@errors-counter
+;; ⇒ 3
+</code></pre><p>The handler function takes two arguments: an agent and the exception that occured.</p><h4 id="summary-and-use-cases-1">Summary and Use Cases</h4><p>Agents are asynchronously updated references. They can be used for anything that does
+not require strict consistency for reads:</p><ul><li>Counters (e.g. message rates in event processing)</li><li>Collections (e.g. recently processed events)</li></ul><p>Agents can be used for offloading arbitrary computations to a thread pool, however,
+only starting with Clojure 1.5 they can provide the same flexiblity as JDK executors
+(thread pools).</p><h3 id="refs">Refs</h3><p>Refs are the only <em>coordinated</em> reference type Clojure has. They help ensure that multiple
+identities can be modified concurrently within a <em><a href="https://clojure-doc.org/articles/language/concurrency_and_parallelism/glossary.html#transaction">transaction</a></em>:</p><ul><li>Either all refs are modified or none are</li><li>No race conditions between involved refs</li><li>No possibility of deadlocks between involved refs</li></ul><p>Refs provide ACI of <a href="http://en.wikipedia.org/wiki/ACID">ACID</a>. Refs
+are backed by Clojure's implementation of <a href="https://clojure-doc.org/articles/language/concurrency_and_parallelism/glossary.html#stm"><em>software transactional
+memory</em> (STM)</a>.</p><p>To instantiate a ref, use the <code>clojure.core/ref</code> function:</p><pre><code class="clojure">(def account-a (ref 0))
+;; ⇒ #'user/account-a
+(def account-b (ref 0))
+;; ⇒ #'user/account-b
+</code></pre><p>Like atoms and agents covered earlier, to get the current value of a ref, use <code>clojure.core/deref</code> or the "<code>@</code>"
+reader macro:</p><pre><code class="clojure">(deref account-a)
+;; ⇒ 0
+@account-b
+;; ⇒ 0
+</code></pre><p>Refs are for coordinated concurrent operations and so it does not make much sense to use a single ref
+(in that case, an atom would be sufficient). Refs are modified in a transaction in the <code>clojure.core/dosync</code>
+body.</p><p><code>clojure.core/dosync</code> starts a transaction, performs all modifications and commits changes. If a concurrently
+running transaction modifies a ref in the current transaction before the current transaction commits,
+the current transaction will be <em>retried</em> to make sure that the most recent value of the modified
+ref is used.</p><p><em>TBD: a picture that visualizes retries and serializability.</em></p><h4 id="alter">alter</h4><p>Refs are modified using <code>clojure.core/alter</code> which is very similar to
+<code>clojure.core/swap!</code> in the arguments it takes: a ref, a function that
+takes an old value and returns a new value of the ref, and any number
+of optional arguments to pass to the function.</p><p>In the following example, two refs are initialized at 1000,
+representing two bank accounts.  Then 100 units are transferred from
+one account to the other, atomically:</p><pre><code class="clojure">(def account-a (ref 1000))
+;; ⇒ #'user/account-a
+(def account-b (ref 1000))
+;; ⇒ #'user/account-b
+
+(dosync
+  ;; will be executed as (+ @account-a 100)
+  (alter account-a + 100)
+  ;; will be executed as (- @account-b 100)
+  (alter account-b - 100))
+;; ⇒ 900
+@account-a
+;; ⇒ 1100
+@account-b
+;; ⇒ 900
+</code></pre><h4 id="conflicts-and-retries">Conflicts and Retries</h4><p><em>TBD: explain transaction conflicts, demonstrate transaction retries</em></p><h4 id="commute">commute</h4><p>With a high number of concurrently running transactions, retries
+overhead can become noticeable.  Some modifications, however, can be
+applied in any order. Clojure's STM implementation acknowledges this
+fact and provides an alternative way to modify refs:
+<code>clojure.core/commute</code>. <code>commute</code> must only be used for operations
+that <a href="http://mathforum.org/dr.math/faq/faq.property.glossary.html#commutative">commute in the mathematical
+sense</a>:
+the order can be changed without affecting the result. For example,
+addition is commutative (1 + 10 produces the same result as 10 + 1)
+but substraction is not (1 − 10 does not equal 10 − 1).</p><p><code>clojure.core/commute</code> has the same signature as <code>clojure.core/alter</code>:</p><pre><code class="clojure">@account-a
+;; ⇒ 1100
+@account-b
+;; ⇒ 900
+(dosync
+  (commute account-a + 300)
+  (commute account-b + 300))
+;; ⇒ 1200
+@account-a
+;; ⇒ 1400
+@account-b
+;; ⇒ 1200
+</code></pre><p>Note that a change made to a ref by <code>commute</code> will never cause a transaction
+to retry. <code>commute</code> does not cause <em>transaction conflicts</em>.</p><h4 id="using-refs-with-clojure-data-structures">Using Refs With Clojure Data Structures</h4><p><em>TBD: demonstrate more complex changes, e.g., to game characters</em></p><h4 id="limitations-of-refs">Limitations of Refs</h4><p>Software transactional memory is a powerful but highly specialized tool. Because transactions can be retried,
+you must only use pure functions with STM. I/O operations cannot be undone by the runtime and very often are
+not <a href="https://clojure-doc.org/articles/language/concurrency_and_parallelism/glossary.html#idempotent">idempotent</a>.</p><p>Structuring your application code as <em>pure core</em> and <em>edge code</em> that interacts with the user or other
+services (performing I/O operations and other side-effects) helps with this. In that case, the pure core
+can use STM without issues.</p><p>For example, in a Web or network server, incoming requests are the edge code: they do I/O. The pure core
+is then called to modify server state, do any calculations necessary, return a result that is returned
+back to the client by the edge code:</p><p><em>TBD: a picture to demonstrate</em></p><p>Unlike some other languages and runtimes (for example, Haskell), Clojure <em>will not prevent you from
+doing I/O in transactions</em>. It is left as a matter of discipline on the programmer's part. It does provide
+a helper function, though: <code>clojure.core/io!</code> will raise an exception if there is an STM transaction
+running and has no effect otherwise.</p><p>First, an example with pure code:</p><pre><code class="clojure">(io!
+  ;; pure code, clojure.core/io! has no effect
+  (reduce + (range 0 100)))
+;; ⇒ 4950
+</code></pre><p>And an example that invokes functions that are guarded with <code>clojure.core/io!</code> in an STM
+transaction:</p><pre><code class="clojure">(defn render-results
+  "Prints results to the standard output"
+  []
+  (io!
+    (println "Results:")
+    (comment ...)))
+;; ⇒ #'user/render-results
+(dosync
+  (alter account-a + 100)
+  (alter account-b - 100)
+  (render-results))
+;; throws java.lang.IllegalStateException, "I/O in transaction!"
+</code></pre><h4 id="summary-and-use-cases-2">Summary and Use Cases</h4><p><em>TBD</em></p><h3 id="vars">Vars</h3><p>Vars are the reference type you are already familiar with. You define them via the <code>def</code> special form:</p><pre><code class="clojure">(def url "http://en.wikipedia.org/wiki/Margarita")
+</code></pre><p>Functions defined via <code>defn</code> are also stored in vars. Vars can be dynamically scoped. They have
+<em>root bindings</em> that are initially visible to all threads. When defining a var
+with <code>def</code>, you define a var that only has root binding, so its value will be the same no matter
+what thread you use it from:</p><pre><code class="clojure">(def url "http://en.wikipedia.org/wiki/Margarita")
+;; ⇒ #'user/url
+(.start (Thread. (fn []
+                   (println (format "url is %s" url)))))
+;; outputs "url is http://en.wikipedia.org/wiki/Margarita"
+;; ⇒ nil
+(.start (Thread. (fn []
+                   (println (format "url is %s" url)))))
+;; outputs "url is http://en.wikipedia.org/wiki/Margarita"
+;; ⇒ nil
+</code></pre><h4 id="dynamic-scoping-and-thread-local-bindings">Dynamic Scoping and Thread-local Bindings</h4><p>To temporarily change var value, we need to make the var dynamic by adding <code>:dynamic true</code> to its
+metadata and then use <code>clojure.core/binding</code>:</p><pre><code class="clojure">(def ^:dynamic *url* "http://en.wikipedia.org/wiki/Margarita")
+;; ⇒ #'user/*url*
+(println (format "*url* is now %s" *url*))
+;; outputs "*url* is now http://en.wikipedia.org/wiki/Margarita"
+
+(binding [*url* "http://en.wikipedia.org/wiki/Cointreau"]
+  (println (format "*url* is now %s" *url*)))
+;; outputs "*url* is now http://en.wikipedia.org/wiki/Cointreau"
+;; ⇒ nil
+</code></pre><p>Note that, by convention, vars which are supposed to or may be dynamically scoped are named with leading
+and trailing asterisks <code>*</code> (often referred to as "earmuffs").</p><p>In the example above, <code>binding</code> temporarily changed the var's current value to a different URL. But that happened only
+in the same thread as the var was originally defined in. What makes vars interesting from the concurrency
+point of view is that their bindings can be <em>thread-local</em> (yes, if you are familiar with thread-local variables
+in Java or Ruby, it is very similar and serves largely the same purpose). To demonstrate, let's change
+the example to spin up 3 threads and alter the var's value from them:</p><pre><code class="clojure">(def ^:dynamic *url* "http://en.wikipedia.org/wiki/Margarita")
+;; ⇒ #'user/*url*
+(println (format "*url* is now %s" *url*))
+;; outputs "*url* is now http://en.wikipedia.org/wiki/Margarita"
+;; ⇒ nil
+(.start (Thread. (fn []
+          (binding [*url* "http://en.wikipedia.org/wiki/Cointreau"]
+            (println (format "*url* is now %s" *url*))))))
+;; outputs "*url* is now http://en.wikipedia.org/wiki/Cointreau"
+;; ⇒ nil
+(.start (Thread. (fn []
+                   (binding [*url* "http://en.wikipedia.org/wiki/Guignolet"]
+                     (println (format "*url* is now %s" *url*))))))
+;; outputs "*url* is now http://en.wikipedia.org/wiki/Guignolet"
+;; ⇒ nil
+(.start (Thread. (fn []
+                   (binding [*url* "http://en.wikipedia.org/wiki/Apéritif"]
+                     (println (format "*url* is now %s" *url*))))))
+;; outputs "*url* is now http://en.wikipedia.org/wiki/Apéritif"
+;; ⇒ nil
+(println (format "*url* is now %s" *url*))
+;; outputs "*url* is now http://en.wikipedia.org/wiki/Margarita"
+;; ⇒ nil
+</code></pre><p>As you can see, var scoping in different threads did not modify the var's value in the thread it was
+originally defined in (its <em>root binding</em>). In real-world cases, for example, it means that a multi-threaded
+Web crawler can store some crawling state specific to a particular thread in a var and not
+modify its initial (global) value.</p><h4 id="how-to-alter-var-root">How to Alter Var Root</h4><p>Sometimes, however, modifying the root binding is necessary. This is done via <code>clojure.core/alter-var-root</code>
+which takes a var (not its value) and a function that takes the old var value and returns a new one:</p><pre><code class="clojure">*url*
+;; ⇒ "http://en.wikipedia.org/wiki/Margarita"
+(.start (Thread. (fn []
+                   (alter-var-root (var user/*url*) (fn [_] "http://en.wikipedia.org/wiki/Apéritif"))
+                   (println (format "*url* is now %s" *url*)))))
+;; outputs "*url* is now http://en.wikipedia.org/wiki/Apéritif"
+;; ⇒ nil
+*url*
+;; ⇒ "http://en.wikipedia.org/wiki/Apéritif"
+</code></pre><p><code>clojure.core/var</code> is used to locate the var (<code>user/*url*</code> in our example executed in the REPL). Note that it
+finds the var itself (the reference, the "box"), not its value (what the var evalutes to).</p><p>In the example above the function we use to alter var root ignores the current value and simply returns a
+predefined string:</p><pre><code class="clojure">(fn [_] "http://en.wikipedia.org/wiki/Apéritif")
+</code></pre><p>Such functions are common enough for <code>clojure.core</code> to provide a convenience higher-order function called
+<code>clojure.core/constantly</code>. It takes a value and returns a function that, when executed, ignores all its parameters
+and returns that value. So, the function above would be more idiomatically written as</p><pre><code class="clojure">*url*
+;; ⇒ "http://en.wikipedia.org/wiki/Margarita"
+(.start (Thread. (fn []
+                   (alter-var-root (var user/*url*) (constantly "http://en.wikipedia.org/wiki/Apéritif"))
+                   (println (format "*url* is now %s" *url*)))))
+;; outputs "*url* is now http://en.wikipedia.org/wiki/Apéritif"
+;; ⇒ nil
+*url*
+;; ⇒ "http://en.wikipedia.org/wiki/Apéritif"
+</code></pre><p>When is <code>alter-var-root</code> used in real world scenarios? Some Clojure data store and API clients stores active connection
+in a var, so initial connection requires root binding modification.</p><h4 id="summary-and-use-cases-3">Summary and Use Cases</h4><p>To summarize: vars can have dynamic scope. They have a root binding and can have thread-local bindings as well.
+As such, vars are good for storing pieces of program state that vary between threads but cannot
+be stored in a function local. <code>alter-var-root</code> is used to alter root binding of a var. It is done
+the functional way: by providing a function that takes the old var value and returns a new one.</p><p>To alter var root to a specific known value, use <code>clojure.core/constantly</code>.</p><h2 id="dereferencing">Dereferencing</h2><p>Earlier sections demonstrated the concept of <em>dereferencing</em>. Dereferencing means retrieving the current
+value of a reference (an atom, an agent, a ref, etc). To dereference a Clojure reference, use
+<code>clojure.core/deref</code> or the <code>@reference</code> reader macro:</p><pre><code class="clojure">(let [xs (atom [])]
+  @xs)
+;; ⇒ []
+</code></pre><p>Besides atoms, agents, and refs, Clojure has several other concurrency-oriented data structures
+that can be dereferenced: delays, futures, and promises. They will be covered later in this
+guide.</p><h3 id="dereferencing-support-for-data-types-implemented-in-java">Dereferencing Support For Data Types Implemented In Java</h3><p>It is possible to make custom data types implemented in Java support dereferencing by
+making them implement the <code>clojure.lang.</code> interface:</p><pre><code class="java">package clojure.lang;
+
+public interface IDeref{
+  Object deref();
+}
+</code></pre><p>This can be done to make data types implemented in Java look and feel more like built-in
+Clojure data types, or make it possible to pass said types to a function that expects
+its arguments to be dereferenceable.</p><h2 id="delays">Delays</h2><p>In Clojure, a <em>delay</em> is a data structure that is evaluated the first time it is dereferenced.
+Subsequent dereferencing will use the cached value. Delays are instantiated with the <code>clojure.core/delay</code>
+function.</p><p>In the following example a delay is used to calculate a timestamp that is later used
+as a cached value:</p><pre><code class="clojure">(def d (delay (System/currentTimeMillis)))
+;; ⇒ #'user/d
+d
+;; ⇒ #&lt;Delay@21ed22af: :pending&gt;
+;; dereferencing causes the value to be realized, it happens only once
+@d
+;; ⇒ 1350997814621
+@d
+;; ⇒ 1350997814621
+@d
+;; ⇒ 1350997814621
+</code></pre><p><code>clojure.core/realized?</code> can be used to check whether a delay instance has been realized
+or not:</p><pre><code class="clojure">(def d (delay (System/currentTimeMillis)))
+;; ⇒ #'user/d
+(realized? d)
+;; ⇒ false
+@d
+;; ⇒ 1350997967984
+(realized? d)
+;; ⇒ true
+</code></pre><h2 id="futures">Futures</h2><p>A Clojure future evaluates a piece of code in another thread. To instantiate a future,
+use <code>clojure.core/future</code>. The <code>future</code> function will return immediately (it never blocks
+the current thread). To obtain the result of computation, dereference the future:</p><pre><code class="clojure">(def ft (future (+ 1 2 3 4 5 6)))
+;; ⇒ #'user/ft
+ft
+;; ⇒ #&lt;core$future_call$reify__6110@effa25e: 21&gt;
+@ft
+;; ⇒ 21
+</code></pre><p>Dereferencing a future blocks the current thread. Because some operations may take
+a very long time or get blocked forever, futures support a timeout specified
+when you dereference them:</p><pre><code class="clojure">;; will block the current thread for 10 seconds, returns :completed
+(def ft (future (Thread/sleep 10000) :completed))
+;; ⇒ #'user/ft
+(deref ft 2000 :timed-out)
+;; ⇒ :timed-out
+</code></pre><p>Subsequent access to futures using <code>deref</code> will use the cached value, just like it
+does for delays.</p><p>Just like delays, it is possible to check whether a future is realized or not
+with <code>clojure.core/realized?</code>:</p><pre><code class="clojure">(def ft (future (reduce + (range 0 10000))))
+;; ⇒ #'user/ft
+(realized? ft)
+;; ⇒ true
+@ft
+;; ⇒ 49995000
+</code></pre><p>Clojure futures are evaluated in an unbounded, cached thread pool that is also used by agents
+(updated via <code>clojure.core/send-off</code>). This works well in many cases but may result in
+exhaustion of the heap or thrashing if too many futures are created.</p><p>Finally, Clojure futures implement <code>java.util.concurrent.Future</code> and can be used with Java APIs
+that accept them.</p><h2 id="promises">Promises</h2><p>Promises are yet another take on asynchronously realized values. They are similar to futures in
+certain ways:</p><ul><li>Can be dereferenced with a timeout</li><li>Caches the realized value</li><li>Supported by <code>clojure.core/realized?</code></li></ul><p>However, promises are realized not by evaluating a piece of code but by calling <code>clojure.core/deliver</code>
+on a promise along with a value:</p><pre><code class="clojure">;; promises have no code body (no code to evaluate)
+(def p (promise))
+;; ⇒ #'user/p
+p
+;; ⇒ #&lt;core$promise$reify__6153@306a0a21: :pending&gt;
+(realized? p)
+;; ⇒ false
+
+;; delivering a promise makes it realized
+(deliver p {:result 42})
+;; ⇒ #&lt;core$promise$reify__6153@306a0a21: {:result 42}&gt;
+(realized? p)
+;; ⇒ true
+@p
+;; ⇒ {:result 42}
+</code></pre><p>Promises combine many of the benefits of callback-oriented asynchronous programming
+and the simpler blocking function calls model provided by dereferencing.</p><h2 id="watches-and-validators">Watches and Validators</h2><p><em>TBD</em></p><h2 id="using-intrinsic-locks-synchronized-in-clojure">Using Intrinsic Locks ("synchronized") in Clojure</h2><h3 id="explicit-locking">Explicit Locking</h3><p>Every object on the JVM has an <em>intrinsic lock</em> (also referred to as <em>monitor lock</em>
+or simply <em>monitor</em>). By convention, a thread that needs to modify a field of a
+mutable object has to acquire the object's intrinsic lock and then release it.
+As long as a thread owns an intrinsic lock, no other thread can acquire the same lock.</p><p>In Clojure, explicit synchronization like this is rarely necessary but may be
+needed for interoperability with Java code. When you need to execute a piece
+of code while holding an intrinsic lock of a mutable object, use
+the <code>clojure.core/locking</code> macro:</p><pre><code class="clojure">(let [l (java.util.ArrayList.)]
+  (locking l
+    (.add l 10))
+  l)
+;; ⇒ #&lt;ArrayList [10]&gt;
+</code></pre><p>Note that for immutable Clojure data structures, explicit locking is effectively
+not necessary.</p><h3 id="synchronization-on-clojure-record-fields">Synchronization on Clojure Record Fields</h3><p><em>TBD</em></p><h2 id="reducers-clojure-15">Reducers (Clojure 1.5+)</h2><p><em>TBD</em></p><h2 id="javautilconcurrent">java.util.concurrent</h2><h3 id="overview-2">Overview</h3><p><code>java.util.concurrent</code> (sometimes abbreviated as <code>j.u.c.</code>) is a group of
+<em>concurrency utilities</em> in the JDK. Originally introduced in JDK 5 in 2004,
+they are developed and maintained by some of the experts in concurrency.
+<code>j.u.c.</code> is a mature library that has been heavily battle tested for
+almost a decade.</p><p>While Clojure provides a whole toolbelt of concurrency features of its own,
+in certain cases the best solution is to use an existing <code>j.u.c.</code> class
+or even build a new abstraction on top of <code>j.u.c.</code> building blocks.</p><p><code>j.u.c.</code> consists of multiple parts that cover common concurrent programming
+patterns and use cases: from thread pools (a.k.a. <em>executors</em>) to synchronization
+classes, to atomic variables, to concurrent collections, to the Fork/Join
+framework.</p><h3 id="executors-thread-pools">Executors (Thread Pools)</h3><h4 id="overview-3">Overview</h4><p>The Executor interface standardizes invocation, scheduling, execution, and control of asynchronous tasks.
+Those tasks can be executed in the calling thread, in newly created threads, or (mostly typically)
+in a thread pool. Thread pools also can have different implementations: for example,
+be fixed size or growing dynamically, using different error handling strategies and so on.</p><p>Executors are most often instantiated using static methods of the <code>java.util.concurrent.Executors</code> class. To submit an operation to the pool, use the <code>ExecutorService#submit</code> method.</p><pre><code class="clojure">(import '[java.util.concurrent Executors ExecutorService Callable])
+
+(let [^ExecutorService pool (Executors/newFixedThreadPool 16)
+      ^Callable clbl        (cast Callable (fn []
+                                             (reduce + (range 0 10000))))]
+  (.submit pool clbl))
+;; ⇒ #&lt;FutureTask java.util.concurrent.FutureTask@19ca276f&gt;
+</code></pre><p>In the example above, we create a new fixed size thread pool with 16 threads
+and submit a Clojure function for execution. Clojure functions <a href="../interop/index.html#clojure_functions_implement_runnable_and_callable">implement Runnable and Callable</a>
+interfaces and can be submitted for execution, however, because <code>ExecutorService#submit</code>
+is an overloaded method, to avoid reflection warnings, we cast the function
+to <code>java.util.concurrent.Callable</code>.</p><h4 id="javautilconcurrentfuture">java.util.concurrent.Future</h4><p><code>Executor#submit</code> will return an instance of <code>java.util.concurrent.Future</code>. It is much like Clojure
+futures but cannot be dereferenced. To get the result, use the <code>j.u.c.Future#get</code> method:</p><pre><code class="clojure">(import '[java.util.concurrent Executors ExecutorService Callable])
+
+(let [^ExecutorService pool (Executors/newFixedThreadPool 16)
+      ^Callable clbl        (cast Callable (fn []
+                                             (reduce + (range 0 10000))))
+      task                  (.submit pool clbl)]
+  (.get task))
+;; ⇒ 49995000
+</code></pre><h4 id="scheduled-executors">Scheduled Executors</h4><p><em>TBD</em></p><h3 id="countdown-latches">Countdown Latches</h3><p><em>Countdown latch</em> is a thread synchronization data structure. More specifically, it handles
+on group of concurrent workflows: "block the current thread until N other threads are
+done with their work". For example, "make a POST request to N URLs and continue when all N operations
+succeeded or failed".</p><p>Countdown latches are instances of <code>java.util.concurrent.CountDownLatch</code> and instantiated with
+a positive integer:</p><pre><code class="clojure">(import java.util.concurrent.CountDownLatch)
+
+(CountDownLatch. n)
+</code></pre><p>When the <code>CountDownLatch#await</code> method is executed, the calling thread blocks until the counter
+gets to 0. Invoking the <code>CountDownLatch#countDown</code> method decreases the counter by 1. Count down
+operations, of course, are supposed to be performed in other threads.</p><p>An example to demonstrate:</p><pre><code class="clojure">(let [cnt   (atom [])
+      n     5
+      latch (java.util.concurrent.CountDownLatch. n)]
+  (doseq [i (range 0 n)]
+    (.start (Thread. (fn []
+                       (swap! cnt conj i)
+                       (.countDown latch)))))
+  (.await latch)
+  @cnt)
+;; note the ordering: starting N threads in parallel leads to
+;; non-deterministic thread interleaving
+;; ⇒ [0 1 2 4 3]
+</code></pre><p>In the example above, we start multiple threads and block the current thread until all other
+threads are done. In this example, those other threads simply add an integer to a vector
+stored in an atom. More realistic scenarios will contact external services, the file system,
+perform some computation and so on.</p><p>Because when threads are executed concurrently (or in parallel), the order of their execution is not
+guaranteed, we see 4 being added to the vector before 3 in the result.</p><p>Countdown latches are commonly used with initial value of 1 to "block and wait until this operation in
+a different thread is done".</p><h3 id="concurrent-collections">Concurrent Collections</h3><p>Most of the Java collections are mutable and were not designed for concurrency. <code>java.util.concurrent</code> includes a number of collections that
+are thread safe and can be used for passing data structures between threads.</p><h3 id="atomic-variables">Atomic Variables</h3><p>The <a href="http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/atomic/package-summary.html">java.util.concurrent.atomic</a> package provides
+a number of data structures that support lock-free thread-safe programming on a single variable (identity). They support
+conditional atomic update operation (<em>compared-and-swap</em> aka <em>CAS</em>).</p><p>Some of the more popular atomic types in the <code>j.u.c.atomic</code> package are <a href="http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/atomic/AtomicBoolean.html">AtomicBoolean</a>,
+<a href="http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/atomic/AtomicLong.html">AtomicLong</a> and <a href="http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/atomic/AtomicReference.html">AtomicReference</a>.</p><p>Atomic references are pretty well covered in Clojure with atoms but ocassionally may be used by
+other libraries. An example to demonstrate how to use an atomic long for a thread-safe counter:</p><pre><code class="clojure">(let [l (AtomicLong.)]
+  (dotimes [i 50]
+    (.start (Thread. (fn []
+                       (.incrementAndGet l)))))
+  (.get l))
+;; ⇒ 49
+</code></pre><h3 id="forkjoin-framework">Fork/Join Framework</h3><p><em>TBD</em></p><h2 id="other-approaches-to-concurrency">Other Approaches to Concurrency</h2><p>There are also other approaches to concurrency that neither Clojure nor Java cover. The growing
+adoption of <em>message passing</em> concurrency (the <a href="http://en.wikipedia.org/wiki/Actor_model">Actor model</a> and <a href="http://en.wikipedia.org/wiki/Communicating_Sequential_Processes">CSP</a>)
+lead to the creation of several JVM-based frameworks for message passing. Some of the most popular ones
+include:</p><ul><li><a href="http://akka.io">Akka</a></li><li><a href="http://code.google.com/p/jetlang/">Jetlang</a></li><li><a href="http://lmax-exchange.github.com/disruptor/">LMAX Disruptor</a></li></ul><p>Akka's Java API can be used from Clojure either directly or via a library called <a href="https://github.com/gaverhae/okku">Okku</a>.</p><p>In LMAX Disruptor, event instances passed around are assumed to be mutable, so the framework is of limited use with Clojure.</p><h2 id="runtime-parallelism">Runtime Parallelism</h2><p>Clojure was designed to be a hosted language. Its primary target, the
+JVM, provides runtime parallelism support.  JVM threads map 1:1 to
+kernel threads. Those will be executed in parallel given that enough
+cores are available for OS scheduler to use.</p><p>In Clojure, many concurrency features are built on top of JVM threads
+and thus benefit from runtime parallelism if the program is running on
+a multi-core machine.</p><h2 id="books">Books</h2><p>Concurrency is a broad topic and it would be silly to think that we
+can cover it well in just one guide.  To get a better understanding of
+the subject, one can refer to a few excellent books:</p><ul><li><a href="http://www.amazon.com/Java-Concurrency-Practice-Brian-Goetz/dp/0321349601">Java Concurrency in Practice</a> by Brian Goetz et al. is a true classic.</li><li><a href="http://pragprog.com/book/vspcon/programming-concurrency-on-the-jvm">Programming Concurrency on the JVM</a> demonstrates a range of concurrency features in several JVM languages.</li></ul><h2 id="wrapping-up">Wrapping Up</h2><p>One of Clojure design goals was to make concurrent programming easier.</p><p>The key design decision was making Clojure data structures immutable
+(persistent) and separating the concepts of <em>identity</em> (references)
+and <em>value</em>. Immutable values eliminate many concurrency hazards, and
+ultimately make it easier for developers to reason about their
+programs.</p><p>Atoms are arguably the most commonly used reference type when working
+with concurrency (vars are used much more often but not for their
+concurrency semantics). Software Transactional Memory is a more
+specialized feature and has certain limitations (e.g., I/O operations
+must not be performed inside transactions). Finally, agents, futures,
+and promises provide an array of tools for working with asynchronous
+operations.</p><p>Concurrency is a hard fundamental problem. There is no single "best"
+solution or approach to it. On the JVM, Clojure offers several
+concurrency-related features of its own but also provides easy access
+to the <code>java.util.concurrent</code> primitives and libraries such as
+<a href="http://akka.io/">Akka</a> or
+<a href="http://code.google.com/p/jetlang/">Jetlang</a>.</p><h2 id="contributors">Contributors</h2><p>Michael Klishin <a href="mailto:michael@defprotocol.org">michael@defprotocol.org</a>, 2012 (original author)</p>
+
+    <div id="prev-next">
+        
+        <a href="../polymorphism/index.html">&laquo; Polymorphism in Clojure: Protocols and Multimethods</a>
+        
+        
+        ||
+        
+        
+        <a href="../glossary/index.html">Clojure Terminology Guide &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/language/core_overview/index.html b/clones/clojure-doc.org/articles/language/core_overview/index.html
new file mode 100644
index 00000000..70e7fa6d
--- /dev/null
+++ b/clones/clojure-doc.org/articles/language/core_overview/index.html
@@ -0,0 +1,745 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Overview of clojure.core, the standard Clojure library</title>
+    
+
+<meta name="description" content="This guide covers:">
+
+<meta property="og:description" content="This guide covers:">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/language/core_overview/" />
+<meta property="og:title" content="Overview of clojure.core, the standard Clojure library" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/language/core_overview/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Overview of clojure.core, the standard Clojure library</h2>
+    </div>
+    
+    <p>This guide covers:</p><ul><li>Key functions of <code>clojure.core</code></li><li>Key macros of <code>clojure.core</code></li><li>Key vars of <code>clojure.core</code></li><li>Essential special forms</li></ul><p>This guide is <strong>by no means comprehensive</strong> and does not try to explain each function/macro/form in depth. It is an overview,
+the goal is to briefly explain the purpose of each item and provide links to other articles with more information.</p><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons Attribution 3.0 Unported License</a>
+(including images &amp; stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on Github</a>.</p><h2 id="what-version-of-clojure-does-this-guide-cover">What Version of Clojure Does This Guide Cover?</h2><p>This guide covers Clojure 1.5.</p><h2 id="binding">Binding</h2><p><a id="let_desc"></a></p><h3 id="let">let</h3><pre><code class="clojure">(let [bindings*] exprs*)
+</code></pre><p><code>let</code> takes a vector of symbol value pairs followed by a variable number of expressions.</p><p><code>let</code> allows binding of locals (roughly equivalent to variables in many other languages) and defines an explicit scope for those bindings.</p><p>The body of a <code>let</code> statement also provides an implicit <code>do</code> that allows for multiple statements in the body of <code>let</code>.</p><p>A basic example:</p><pre><code class="klipse-clojure nohighlight">(let [x 1 y 2]
+  (println x y))
+</code></pre><p>Let can be nested, and the scope is lexically determined. This means that a binding's value is determined by the nearest binding form for that symbol.</p><p>This example basically demonstrates the lexical scoping of the let form.</p><pre><code class="klipse-clojure nohighlight">(let [x 1]
+  (println x) ; prints 1
+  (let [x 2]
+    (println x))) ; prints 2
+</code></pre><p>Let bindings are immutable and can be destructured.</p><p>See: Sections about destructuring in
+<a href="../../tutorials/introduction/index.html#destructuring">Introduction</a> and
+<a href="../functions/index.html#destructuring-of-function-arguments">Functions</a>
+pages.</p><p><a id="def_desc"></a></p><h3 id="def">def</h3><pre><code class="clojure">(def symbol doc-string? init?)
+</code></pre><p><code>def</code> takes a symbol and an optional init value.</p><p>If an init value is supplied, the root binding of the var is assigned to that value. Redefining a var with an init value will re-assign the root binding.</p><p>A root binding is a value that is shared across all threads.</p><p>The <code>let</code> form is the preferred method of creating local bindings. It is strongly suggested to prefer it where possible, and never use <code>def</code> within another form.</p><pre><code class="clojure">;; TBD - reference to var documentation, basic example
+;; TBD - metadata
+</code></pre><p><a id="declare_desc"></a></p><h3 id="declare">declare</h3><pre><code class="clojure">([&amp; names])
+</code></pre><p><code>declare</code> takes a variable number of symbols.</p><p><code>declare</code> provides a simple way of creating 'forward declarations'. <code>declare</code> defs the supplied symbols with no init values. This allows for referencing of a var before it has been supplied a value.</p><p>There are much better methods of value-based dispatch or code architecture in general, but this presents a simple situation forward declarations would be necessary.</p><pre><code class="klipse-clojure nohighlight">(declare func&lt;10 func&lt;20)
+
+;; without declare you will receive an error similar to:
+;; "Unable to resolve symbol: func10 in this context"
+
+(defn func&lt;10 [x]
+  (cond
+   (&lt; x 10) (func&lt;10 (inc x))
+   (&lt; x 20) (func&lt;20 x)
+   :else "too far!"))
+
+(defn func&lt;20 [x]
+  (cond
+   (&lt; x 10) (func&lt;10 x)
+   (&lt; x 20) "More than 10, less than 20"
+   :else "too far!"))
+</code></pre><p>No matter which order you put func&lt;10 and func&lt;20 in, there will be a reference to a var that does not yet exist when the compiler does the initial evaluation of top-level forms.</p><p><code>declare</code> defines the var with no binding so that the the var exists when it is referenced later in the code.</p><p><a id="defn_desc"></a></p><h3 id="defn">defn</h3><pre><code class="clojure">([name doc-string? attr-map? [params*] prepost-map? body] [name doc-string? attr-map? ([params*] prepost-map? body) + attr-map?])
+</code></pre><p><code>defn</code> takes a symbol, an optional doc string, an optional meta-data
+map, a vector of arguments and a variable number of expressions.</p><p><code>defn</code> is the primary way of defining functions. It allows for
+convenient definition of metadata about its argslist and documentation
+(docstrings). <code>defn</code> inherently allows for quick documentation of
+functions that can be retrieved with <code>doc</code>. This feature should be
+used almost universally.</p><p>Without <code>defn</code>, a var would be directly bound to a function definition
+and explicit metadata about the doc string and argslits would be added
+manually.</p><pre><code class="clojure">(def func (fn [x] x))
+
+;; same as:
+(defn func [x]
+  x)
+
+;; with metadata added by defn
+(def ^{:doc "documentation!"} ^{:arglists '([x])} func (fn [x] x))
+
+;;same as
+(defn func
+  "documentation!"
+  [x]
+  x)
+</code></pre><pre><code class="clojure">;; TBD - link to doc and metadata
+</code></pre><h2 id="branching">Branching</h2><p><a id="if_desc"></a></p><h3 id="if">if</h3><pre><code class="clojure">(if test then else?)
+</code></pre><p><code>if</code> takes 2 expressions, and an optional third.</p><p><code>if</code> is the primary method of conditional execution and other conditionals are built upon <code>if</code>.</p><p>If the return value of the first expression is anything except nil or false, the second expression is evaluated and the result returned..</p><p>If a third expression is provided, when the first expression returns nil or false the third expression is evaluated and returned.</p><pre><code class="klipse-clojure nohighlight">(if 0 "second") ; 0 is a 'true' value. Only false or nil are 'false'
+</code></pre><pre><code class="klipse-clojure nohighlight">(if nil "second" "third")
+</code></pre><pre><code class="klipse-clojure nohighlight">(if (&lt; 10 9) "second" "third") ; (&lt; 9 10) returns false
+</code></pre><pre><code class="klipse-clojure nohighlight">(if (seq '()) "second") ; seq returns nil for an empty sequence
+</code></pre><pre><code class="klipse-clojure nohighlight">(if (nil? (= 1 2)) "second" "third") ; differentiate between nil and false if needed
+</code></pre><p><a id="when_desc"></a></p><h3 id="when">when</h3><pre><code class="clojure">([test &amp; body])
+</code></pre><p><code>when</code> takes 2 expressions.</p><p><code>when</code> provides an implicit do form that is evaluated if an expression returns true, otherwise nil is returned. <code>when</code> does not provide an 'else'.</p><pre><code class="klipse-clojure nohighlight">(when (= 1 2) (print "hey") 10)
+</code></pre><pre><code class="klipse-clojure nohighlight">(when (&lt; 10 11) (print "hey") 10)
+</code></pre><h3 id="for">for</h3><p>See: <a href="index.html#for_desc">for</a></p><h3 id="doseq">doseq</h3><p>See: <a href="index.html#doseq_desc">doseq</a></p><h2 id="looping">Looping</h2><p><a id="recur_desc"></a></p><h3 id="recur">recur</h3><pre><code class="clojure">(recur exprs*)
+</code></pre><p><code>recur</code> allows for self-recursion without consuming stack space proportional to the number of recursive calls made. Due to the lack of tail-call optimization on the JVM currently, this is the only method of recursion that does not consume excess stack space.</p><p><code>recur</code> takes a number of arguments identical to the point of recursion. <code>recur</code> will evaluate those arguments, rebind them at the point of recursion and resume execution at that point.</p><p>The point of recursion is the nearest <code>fn</code> or <code>loop</code> form determined lexically.</p><p><code>recur</code> must be in the tail position of the recursion point expression. The tail position is the point in the expression where a return value would otherwise be determined and.</p><p><code>recur</code> does not bind <code>&amp;</code> in variadic functions and in these situations an empty seq must be passed by <code>recur</code>.</p><pre><code class="klipse-clojure nohighlight">(defn count-up
+  [result x y]
+  (if (= x y)
+    result
+    (recur (conj result x) (inc x) y)))
+
+(count-up [] 0 10)
+</code></pre><p>Example: getting factorial of a positive integer:</p><pre><code class="klipse-clojure nohighlight">(defn factorial
+  ([n]
+     (factorial n 1))
+  ([n acc]
+     (if (zero? n)
+       acc
+       (recur (dec n) (* n acc)))))
+
+(factorial 10)
+;; ⇒ 3628800
+</code></pre><p>TBD: more examples</p><p><a id="loop_desc"></a></p><h3 id="loop">loop</h3><pre><code class="clojure">(loop [bindings*] exprs*)
+</code></pre><p><code>loop</code> takes a vector of symbol value pairs followed by a variable number of expressions.</p><p><code>loop</code> establishes a recursion point for a <code>recur</code> expression inside its body. <code>loop</code> provides an implicit <code>let</code> for bindings.</p><p>The implicit <code>let</code> that <code>loop</code> provides binds each symbol to the init-expression. <code>recur</code> then binds new values when returning the execution point to <code>loop</code>.</p><pre><code class="klipse-clojure nohighlight">(defn count-up
+  [start total]
+  (loop [result []
+         x start
+         y total]
+    (if (= x y)
+      result
+      (recur (conj result x) (inc x) y))))
+
+(count-up 0 10)
+;; ⇒ [0 1 2 3 4 5 6 7 8 9]
+</code></pre><p>Example: getting factorial of a positive integer:</p><pre><code class="klipse-clojure nohighlight">(defn factorial
+  [n]
+  (loop [n n
+         acc 1]
+    (if (zero? n)
+      acc
+      (recur (dec n) (* acc n)))))
+
+(factorial 10)
+;; ⇒ 3628800
+</code></pre><p>TBD: more examples</p><p><a id="trampoline_desc"></a></p><h3 id="trampoline">trampoline</h3><pre><code class="clojure">([f])
+([f &amp; args])
+</code></pre><p><code>trampoline</code> takes a function and a variable number of arguments to pass to that function.</p><p><code>trampoline</code> allows for mutual recursion without consuming stack space proportional to the number of recursive calls made.</p><p>If the return value of that function is a function, <code>trampoline</code> calls that function with no arguments. If the return value is not a function, <code>trampoline</code> simply returns that value.</p><p>Since <code>trampoline</code> calls the returned functions with no arguments, you must supply an anonymous function that takes no arguments and calls the function you wish to recur to. This is usually done with anonymous function literals <code>#()</code></p><pre><code class="klipse-clojure nohighlight">(declare count-up1 count-up2) ;; see `declare` for why this is needed
+
+(defn count-up1
+  [result start total]
+  (if (= start total)
+    result
+    #(count-up2 (conj result start) (inc start) total))) ;; returns an anonymous function
+
+(defn count-up2 [result start total]
+  (if (= start total)
+    result
+    #(count-up1 (conj result start) (inc start) total))) ;; returns an anonymous function
+
+    #_(trampoline count-up1 [] 0 10)
+;; ⇒ [0 1 2 3 4 5 6 7 8 9]
+</code></pre><p>TBD: a trivial example that would not be easily solved with self-recursion</p><p><a id="for_desc"></a></p><h3 id="for-1">for</h3><pre><code class="clojure">([seq-exprs body-expr])
+</code></pre><p><code>for</code> takes a vector of pairs of [binding collection].</p><p><code>for</code> allows for list comprehensions. <code>for</code>  assigns each sequential value in the collection to the binding form and evaluates them rightmost first. The results are returned in a lazy sequence.</p><p><code>for</code> allows for explicit let, when and while through use of ":let []" ":when (expression)" ":while (expression)" in the binding vector.</p><pre><code class="klipse-clojure nohighlight">(for [x [1 2 3] y [4 5 6]]
+  [x y])
+;; ⇒ ([1 4] [1 5] [1 6] [2 4] [2 5] [2 6] [3 4] [3 5] [3 6])
+</code></pre><p>:when only evaluates the body when a true value is returned by the expression provided</p><pre><code class="klipse-clojure nohighlight">(for [x [1 2 3] y [4 5 6]
+      :when (and
+             (even? x)
+             (odd? y))]
+  [x y])
+;; ⇒ ([2 5])
+</code></pre><p>:while evaluates the body until a non-true value is reached. Note that the rightmost collection is fully bound to y before a non-true value of (&lt; x 2) is reached. This demonstrates the order of the comprehension.</p><pre><code class="klipse-clojure nohighlight">(for [x [1 2 3] y [4 5 6]
+      :while (&lt; x 2)]
+  [x y])
+;; ⇒ ([1 4] [1 5] [1 6])
+</code></pre><p><a id="doseq_desc"></a></p><h3 id="doseq-1">doseq</h3><pre><code class="clojure">([seq-exprs &amp; body])
+</code></pre><p><code>doseq</code> takes a vector of pairs of [binding collection].</p><p><code>doseq</code> is similar to <code>for</code> except it does not return a sequence of results. <code>doseq</code> is generally intended for execution of side-effects in the body, and thusly returns nil.</p><p><code>doseq</code> supports the same bindings as for - :let :when :while. For examples of these, see for.</p><pre><code class="klipse-clojure nohighlight">(doseq [x [1 2 3] y [4 5 6]]
+  (println [x y]))
+
+;; [1 4][1 5][1 6][2 4][2 5][2 6][3 4][3 5][3 6]
+;; ⇒ nil
+</code></pre><p><a id="iterate_desc"></a></p><h3 id="iterate">iterate</h3><pre><code class="clojure">([f x])
+</code></pre><p><code>iterate</code> takes a function and an argument to the function.</p><p>A lazy sequence is returned consisting of the argument then each subsequent entry is the function evaluated with the previous entry in the lazy sequence.</p><pre><code class="clojure">TBD: Examples
+</code></pre><p>TBD: Simple image accompaniment.</p><p><a id="reduce_desc"></a></p><h3 id="reduce">reduce</h3><pre><code class="clojure">([f coll])
+([f val coll])
+</code></pre><p><code>reduce</code> takes a function, an optional initial value and a collection.</p><p><code>reduce</code> takes the first item of the collection and either the second
+item of the collection or the provided initial value, then evaluates
+the function with those arguments. The function is then evaluated with
+that result and the next item in the collection. This is repeated
+until the collection is exhausted and the value of the final function
+call is returned.</p><pre><code class="clojure">TBD: examples
+</code></pre><p>TBD: Simple image accompaniment.</p><p><a id="reductions_desc"></a></p><h3 id="reductions">reductions</h3><pre><code class="clojure">([f coll])
+([f val coll])
+</code></pre><p><code>reductions</code> takes a function, an optional initial value and a collection.</p><p><code>reductions</code> returns a lazy sequence consisting of the first item in
+the collection, or the provided initial value followed by the result
+of the function evaluated with the previous result and the next item
+in the collection.</p><pre><code class="clojure">TBD: examples
+</code></pre><p>TBD: Simple image accompaniment.</p><p><a id="map_desc"></a></p><h3 id="map">map</h3><pre><code class="clojure">([f coll])
+([f c1 c2])
+([f c1 c2 c3])
+([f c1 c2 c3 &amp; colls])
+</code></pre><p><code>map</code> takes a function and one or more collections.  <code>map</code> passes an
+item from each collection, in order, to the function and returns a
+lazy sequence of the results.</p><p>The function provided to <code>map</code> must support an arity matching the
+number of collections passed. Due to this, when using more than one
+collection, map stops processing items when any collection runs out of
+items.</p><pre><code class="clojure">TBD: Examples
+</code></pre><p>TBD: Simple image accompaniment.</p><h2 id="collection-and-sequence-modification">Collection and Sequence Modification</h2><p><a id="conj_desc"></a></p><h3 id="conj">conj</h3><pre><code class="clojure">([coll x])
+([coll x &amp; xs])
+</code></pre><p><code>conj</code> takes a collection and a variable number of arguments.</p><p><code>conj</code> is short for "conjoin". As the name implies, <code>conj</code> returns the
+collection with those arguments added.</p><p>Adding items to a collection occurs at different places depending on
+the concrete type of collection.</p><p>List addition occurs at the beginning of the list. This is because
+accessing the head of the list is a constant time operation, and
+accessing the tail requires traversal of the entire list.</p><pre><code class="clojure">(conj '(1 2) 3)
+;; ⇒ (3 1 2)
+</code></pre><p>Vectors have constant time access across the entire data
+structure. `'conj' thusly appends to the end of a vector.</p><pre><code class="klipse-clojure nohighlight">(conj [1 2] 3)
+;; ⇒ [1 2 3]
+</code></pre><p>Maps do not have guaranteed ordering, so the location that items are
+added is irrelevant. <code>conj</code> requires vectors of [key value] pairs to
+be added to the map.</p><pre><code class="klipse-clojure nohighlight">(conj {:a 1 :b 2 :c 3} [:d 4])
+;; ⇒ {:d 4, :a 1, :c 3, :b 2}
+</code></pre><pre><code class="klipse-clojure nohighlight">(conj {:cats 1 :dogs 2} [:ants 400] [:giraffes 13])
+;; ⇒ {:giraffes 13, :ants 400, :cats 1, :dogs 2}
+</code></pre><p>Sets also do not have guaranteed ordering. <code>conj</code> returns a set with
+the item added. As the concept of sets implies, added items will not
+duplicate equivalent items if they are present in the set.</p><pre><code class="klipse-clojure nohighlight">(conj #{1 4} 5)
+;; ⇒ #{1 4 5}
+</code></pre><pre><code class="klipse-clojure nohighlight">(conj #{:a :b :c} :b :c :d :e)
+;; ⇒ #{:a :c :b :d :e}
+</code></pre><p><a id="empty_desc"></a></p><h3 id="empty">empty</h3><pre><code class="clojure">([coll])
+</code></pre><p><code>empty</code> takes a collection</p><p><code>empty</code> returns an empty collection of the same type as the collection
+provided.</p><pre><code class="klipse-clojure nohighlight">(empty [1 2 3])
+;; ⇒ []
+</code></pre><pre><code class="klipse-clojure nohighlight">(empty {:a 1 :b 2 :c 3})
+;; ⇒ {}
+</code></pre><p><a id="assoc_desc"></a></p><h3 id="assoc">assoc</h3><pre><code class="clojure">([map key val])
+([map key val &amp; kvs])
+</code></pre><p><code>assoc</code> takes a key and a value and returns a collection of the same
+type as the supplied collection with the key mapped to the new value.</p><p><code>assoc</code> is similar to get in how it works with maps, records or
+vectors. When applied to a map or record, the same type is returned
+with the key/value pairs added or modified.  When applied to a vector,
+a vector is returned with the key acting as an index and the index
+being replaced by the value.</p><p>Since maps and records can not contain multiple equivalent keys,
+supplying <code>assoc</code> with a key/value that exists in the one will cause
+<code>assoc</code> to return modify the key at that value in the result and not
+duplicate the key.</p><pre><code class="klipse-clojure nohighlight">(assoc {:a 1} :b 2)
+;; ⇒ {:b 2, :a 1}
+</code></pre><pre><code class="klipse-clojure nohighlight">(assoc {:a 1 :b 45 :c 3} :b 2)
+;; ⇒ {:a 1, :c 3, :b 2}
+</code></pre><pre><code class="klipse-clojure nohighlight">(defrecord Hand [index middle ring pinky thumb])
+(assoc (Hand. 3 4 3.5 2 2) :index 3.75)
+;; ⇒ #user.Hand{:index 3.75, :middle 4, :ring 3.5, :pinky 2, :thumb 2}
+</code></pre><p>When using <code>assoc</code> with a vector, the key is
+the index and the value is the value to assign to that index in the
+returned vector.  The key must be &lt;= (count vector) or a
+"IndexOutOfBoundsException" will occur. <code>assoc</code> can not be used to add
+an item to a vector.</p><pre><code class="klipse-clojure nohighlight">(assoc [1 2 76] 2 3) ;= [1 2 3]
+</code></pre><pre><code class="klipse-clojure nohighlight">;; index 5 does not exist. valid indexes for this vector are: 0, 1, 2
+(assoc [1 2 3] 5 6) 
+;; IndexOutOfBoundsException   clojure.lang.PersistentVector.assocN (PersistentVector.java:136)
+</code></pre><p><a id="dissoc_desc"></a></p><h3 id="dissoc">dissoc</h3><pre><code class="clojure">([map])
+([map key])
+([map key &amp; ks])
+</code></pre><p><code>dissoc</code> takes a map and a variable number of keys.</p><p><code>dissoc</code> returns a map with the supplied keys, and subsequently their
+values, removed. Unlike <code>assoc</code>, <code>dissoc</code> does not work on
+vectors. When a record is provided, <code>dissoc</code> returns a map. For
+similar functionality with vectors, see <code>subvec</code> and <code>concat</code>.</p><pre><code class="klipse-clojure nohighlight">(dissoc {:a 1 :b 2 :c 3} :b)
+;; ⇒ {:a 1, :c 3}
+</code></pre><pre><code class="klipse-clojure nohighlight">(dissoc {:a 1 :b 14 :c 390 :d 75 :e 2 :f 51} :b :c :e)
+;; ⇒ {:a 1, :f 51, :d 75}
+</code></pre><pre><code class="klipse-clojure nohighlight">;; note that a map is returned, not a record.
+(defrecord Hand [index middle ring pinky thumb])
+;; always be careful with the bandsaw!
+(dissoc (Hand. 3 4 3.5 2 2) :ring)
+;; ⇒ {:index 3, :middle 4, :pinky 2, :thumb 2}
+</code></pre><h2 id="information-about-a-collection-or-sequence">Information about a Collection or Sequence</h2><p><a id="count_desc"></a></p><h3 id="count">count</h3><pre><code class="clojure">([coll])
+</code></pre><p><code>count</code> takes a collection.</p><p>Returns a count of the number of items in a collection. An argument of nil returns 0.</p><pre><code class="klipse-clojure nohighlight">(count "Hello")
+;; ⇒ 5
+</code></pre><pre><code class="klipse-clojure nohighlight">(count [1 2 3 4 5 6 7])
+;; ⇒ 7
+</code></pre><pre><code class="klipse-clojure nohighlight">(count nil)
+;; ⇒ 0
+</code></pre><p>Note that count does not return in constant time for all
+collections. This can be determined with <code>counted?</code>.  Keep in mind
+that lazy sequences must be realized to get a count of the items. This
+is often not intended and can cause a variety of otherwise cryptic
+errors.</p><pre><code class="klipse-clojure nohighlight">(counted? "Hello")
+;; ⇒ false
+</code></pre><pre><code class="klipse-clojure nohighlight">;; will be fully realized when using (count (range 10))
+(counted? (range 10))
+;; ⇒ false
+</code></pre><pre><code class="klipse-clojure nohighlight">;; Constant time return of (count)
+(counted? [1 2 3 4 5])
+;; ⇒ true
+</code></pre><p><a id="empty?_desc"></a></p><h3 id="empty-1">empty?</h3><pre><code class="clojure">([coll])
+</code></pre><p><code>empty</code> takes a collection.</p><p><code>empty?</code> returns true if the collection has no items, or false if it has 1 or more items.</p><pre><code class="klipse-clojure nohighlight">(empty? [])
+;; ⇒ true
+</code></pre><pre><code class="klipse-clojure nohighlight">(empty? '(1 2 3))
+;; ⇒ false
+</code></pre><p>Do not confuse <code>empty?</code> with <code>empty</code>. This can be a source of great confusion:</p><pre><code class="klipse-clojure nohighlight">(if (empty [1 2 3]) ;; empty returns an empty seq, which is true! use empty? here.
+  "It's empty"
+  "It's not empty")
+;; ⇒ "It's empty"
+</code></pre><p><a id="not-empty_desc"></a></p><h3 id="not-empty">not-empty</h3><pre><code class="clojure">([coll])
+</code></pre><p><code>not-empty</code> takes a collection.</p><p><code>not-empty</code> returns nil if the collection has no items. If the collection contains items, the collection is returned.</p><pre><code class="klipse-clojure nohighlight">(not-empty '(:mice :elephants :children))
+;; ⇒ (:mice :elephants :children)
+</code></pre><pre><code class="klipse-clojure nohighlight">(not-empty '())
+;; ⇒ nil
+</code></pre><h2 id="items-in-a-collection-or-sequence">Items in a Collection or Sequence</h2><p><a id="first_desc"></a></p><h3 id="first">first</h3><pre><code class="clojure">([coll])
+</code></pre><p><code>first</code> takes a collection.</p><p><code>first</code> returns the first item in the collection. <code>first</code> returns nil
+if the argument is empty or is nil.</p><p>Note that for collections that do not guarantee order like some maps
+and sets, the behaviour of <code>first</code> should not be relied on.</p><pre><code class="klipse-clojure nohighlight">(first (range 10))
+;; ⇒ 0
+</code></pre><pre><code class="klipse-clojure nohighlight">(first [:floor :piano :seagull])
+;; ⇒ :floor
+</code></pre><pre><code class="klipse-clojure nohighlight">(first [])
+;; ⇒ nil
+</code></pre><p><a id="rest_desc"></a></p><h3 id="rest">rest</h3><pre><code class="clojure">([coll])
+</code></pre><p><code>rest</code> takes a collection.</p><p><code>rest</code> returns a seq of items starting with the second element in the
+collection. <code>rest</code> returns an empty seq if the collection only
+contains a single item.</p><p><code>rest</code> should also not be relied on when using maps and sets unless
+you are sure ordering is guaranteed.</p><pre><code class="klipse-clojure nohighlight">(rest [13 1 16 -4])
+;; ⇒ (1 16 -4)
+</code></pre><pre><code class="klipse-clojure nohighlight">(rest '(:french-fry))
+;; ⇒ '()
+</code></pre><p>The behaviour of <code>rest</code> should be contrasted with <code>next</code>. <code>next</code>
+returns nil if the collection only has a single item. This is
+important when considering "truthiness" of values since an empty seq
+is "true" but nil is not.</p><pre><code class="klipse-clojure nohighlight">(if (rest '("stuff"))
+  (print "Does this print?")) ;; yes, it prints.
+</code></pre><pre><code class="clojure">;; NEVER FINISHES EXECUTION!
+;; "done" is never reached because (rest x) is always a "true" value
+(defn inf
+  [x]
+  (if (rest x)
+    (inf (rest x))
+    "done"))
+</code></pre><p><a id="get_desc"></a></p><h3 id="get">get</h3><pre><code class="clojure">([map key])
+([map key not-found])
+</code></pre><p><code>get</code> takes an associative collection, a sequence of keys and an optional default value.</p><p><code>get</code> returns the value for the specified key in a map or record,
+index of a vector or value in a set. If the key is not present, <code>get</code>
+returns nil or a supplied default value.</p><pre><code class="klipse-clojure nohighlight">;; val of a key in a map
+(get {:a 1 :b 2 :c 3} :b)
+;; ⇒ 2
+</code></pre><pre><code class="klipse-clojure nohighlight">;; index of a vector
+(get [10 15 20 25] 2)
+;; ⇒ 20
+</code></pre><pre><code class="klipse-clojure nohighlight">;; in a set, returns the value itself if present
+(get #{1 10 100 2 20 200} 1)
+;; ⇒ 1
+</code></pre><pre><code class="klipse-clojure nohighlight">;; returns nil if key is not present
+(get {:a 1 :b 2} :c)
+;; ⇒ nil
+</code></pre><pre><code class="klipse-clojure nohighlight">;; vector does not have an _index_ of 4. nil is returned
+(get [1 2 3 4] 4)
+;; ⇒ nil
+</code></pre><pre><code class="klipse-clojure nohighlight">(defrecord Hand [index middle ring pinky thumb])
+(get (Hand. 3 4 3.5 2 2) :index)
+;; ⇒ 3
+</code></pre><p><code>get</code> also supports a default return value supplied as the last argument.</p><pre><code class="klipse-clojure nohighlight">;; index 4 does not exist. return default value
+(get [1 2 3 4] 4 "Not Found")
+;; ⇒ "Not Found"
+</code></pre><pre><code class="klipse-clojure nohighlight">;; key :c does not exist, so return default value of 3
+(get {:a 1 :b 2} :c 3)
+;; ⇒ 3
+</code></pre><p><a id="contains?_desc"></a></p><h3 id="contains">contains?</h3><pre><code class="clojure">([coll key])
+</code></pre><p><code>contains?</code> takes a map and a key.</p><p><code>contains</code> returns true if the provided <em>key</em> is present in a
+collection. <code>contains</code> is similar to <code>get</code> in that vectors treat the
+key as an index. <code>contains</code> will always return false for lists.</p><pre><code class="klipse-clojure nohighlight">(contains? {:a 1 :b 2 :c 3} :c)
+;; ⇒ true
+</code></pre><pre><code class="klipse-clojure nohighlight">;; true if index 2 exists
+(contains? ["John" "Mary" "Paul"] 2)
+;; ⇒ true
+</code></pre><pre><code class="klipse-clojure nohighlight">;; false if index 5 does not exist
+(contains? ["John" "Mary" "Paul"] 5)
+;; ⇒ false
+</code></pre><pre><code class="klipse-clojure nohighlight">;; "Paul" does not exist as an index
+(contains? ["John" "Mary" "Paul"] "Paul")
+;; ⇒ false
+</code></pre><pre><code class="klipse-clojure nohighlight">;; lists are not supported. contains? won't traverse a collection for a result.
+(contains? '(1 2 3) 0)
+;; ⇒ java.lang.IllegalArgumentException: contains? not supported on type: clojure.lang.PersistentList
+</code></pre><p><a id="keys_desc"></a></p><h3 id="keys">keys</h3><pre><code class="clojure">([map])
+</code></pre><p><code>keys</code> takes a map or record.</p><p><code>keys</code> returns a sequence of the keys in a map or record.</p><pre><code class="klipse-clojure nohighlight">(keys {1 "one" 2 "two" 3 "three"})
+;; ⇒ (1 2 3)
+</code></pre><pre><code class="klipse-clojure nohighlight">(defrecord Hand [index middle ring pinky thumb])
+(keys (Hand. 2 4 3 1 2))
+;; ⇒ (:index :middle :ring :pinky :thumb)
+</code></pre><p><a id="vals_desc"></a></p><h3 id="vals">vals</h3><pre><code class="clojure">([map])
+</code></pre><p><code>vals</code> takes a map or record.</p><p><code>vals</code> returns a sequence of vals in a map or record.</p><pre><code class="klipse-clojure nohighlight">(vals {:meows 20 :barks 2 :moos 5})
+;; ⇒ (5 2 20)
+</code></pre><pre><code class="klipse-clojure nohighlight">(defrecord Hand [index middle ring pinky thumb])
+(vals (Hand. 1 2 3 4 5))
+;; ⇒ (1 2 3 4 5)
+</code></pre><p><a id="take_desc"></a></p><h3 id="take">take</h3><pre><code class="clojure">([n coll])
+</code></pre><p><code>take</code> takes a number and a collection.</p><p><code>take</code> returns a lazy sequence starting with the first value of the
+collection and n sequential items after that.</p><p>If the number of items in the collection is less than the provided
+number, the entire collection is returned lazily.</p><pre><code class="clojure">TBD: example
+</code></pre><p><a id="drop_desc"></a></p><h3 id="drop">drop</h3><pre><code class="clojure">([n coll])
+</code></pre><p><code>drop</code> takes a number and a collection.</p><p><code>drop</code> returns a lazy sequence starting at the nth item of the collection.</p><pre><code class="clojure">TBD: example
+</code></pre><p><a id="take-while_desc"></a></p><h3 id="take-while">take-while</h3><pre><code class="clojure">([pred coll])
+</code></pre><p><code>take-while</code> takes a function that accepts a single-argument and a
+collection.</p><p><code>take-while</code> returns a lazy sequence of sequential items until the
+function returns nil/false value for that item.</p><pre><code class="clojure">TBD: example
+</code></pre><p><a id="drop-while_desc"></a></p><h3 id="drop-while">drop-while</h3><pre><code class="clojure">([pred coll])
+</code></pre><p>'drop-while` takes a function that accepts a single-argument and a
+collection.</p><p><code>drop-while</code> returns a lazy sequence starting at the first item in the
+collection that the function returns nil/false.</p><p><a id="filter_desc"></a></p><h3 id="filter">filter</h3><pre><code class="clojure">([pred coll])
+</code></pre><p><code>filter</code> takes a function that accepts a single argument and a
+collection.</p><p><code>filters</code> returns a lazy sequence of items that return <code>true</code> for the
+provided predicate. Contrast to <code>remove</code>.</p><pre><code class="klipse-clojure nohighlight">(filter even? (range 10))
+;; ⇒ (0 2 4 6 8)
+</code></pre><pre><code class="klipse-clojure nohighlight">(filter #(if (&lt; (count %) 5) %) ["Paul" "Celery" "Computer" "Rudd" "Tayne"])
+;; ⇒ ("Paul" "Rudd")
+</code></pre><p>When using sets with <code>filter</code>, remember that if nil or false is in the
+set and in the collection, then the predicate will return itself:
+<code>nil</code>.</p><p>In this example, when nil and false are tested with the predicate, the
+predicate returns nil. This is because if the item is present in the
+set it is returned. This will cause that item to /not/ be included in
+the returned lazy-sequence.</p><pre><code class="klipse-clojure nohighlight">(filter #{:nothing :something nil} [:nothing :something :things :someone nil false :pigeons])
+;; ⇒ (:nothing :something)
+</code></pre><p><a id="keep_desc"></a></p><h3 id="keep">keep</h3><p><code>(keep f coll)</code></p><p><code>keep</code> takes a function that accepts a single argument and a
+collection.</p><p><code>keep</code> returns a lazy sequence of non-nil results of the function
+applied to each item in the collection in sequence.</p><pre><code class="clojure">TBD: examples
+</code></pre><p><a id="remove_desc"></a></p><h3 id="remove">remove</h3><pre><code class="clojure">([pred coll])
+</code></pre><p><code>remove</code> takes a function that accepts a single argument and a
+collection.</p><p><code>remove</code> returns a lazy sequence of items that return <code>false</code> or <code>nil</code>
+for the provided predicate. Contrast to <code>filter</code>.</p><pre><code class="klipse-clojure nohighlight">(remove even? (range 10))
+;; ⇒ (1 3 5 7 9)
+</code></pre><pre><code class="klipse-clojure nohighlight">;; relative complement. probably useless?
+(remove {:a 1 :b 2} [:h :k :z :b :s])
+;; ⇒ (:h :k :z :s)
+</code></pre><p>When using sets with <code>remove</code>, remember that if nil or false is in the
+set and in the collection, then the predicate will return itself:
+<code>nil</code>.  This will cause that item to be included in the returned lazy
+sequence.</p><p>In this example, when nil and false are tested with the predicate, the
+predicate returns nil. This is because if the item is present in the
+set it is returned.</p><pre><code class="klipse-clojure nohighlight">(remove #{:nothing :something nil} [:nothing :something :things :someone nil false :pigeons])
+;; ⇒ (:things :someone nil false :pigeons)
+</code></pre><p><a id="some_desc"></a></p><h3 id="some">some</h3><pre><code class="clojure">([pred coll])
+</code></pre><p><code>some</code> takes a function that accepts a single argument and a collection.</p><p><code>some</code> will apply a predicate to each value in a collection until a
+non-false/nil result is returned then immediately return that result.</p><p>Since collections are "true" values, this makes it possible to return
+the first result itself rather than simply <code>true</code>.</p><pre><code class="klipse-clojure nohighlight">(some even? [1 2 3 4 5])
+;; ⇒ true
+</code></pre><pre><code class="klipse-clojure nohighlight">;; predicate returns the value rather than simply true
+(some #(if (even? %) %) [1 2 3 4 5])
+;; ⇒ 2
+</code></pre><p>Since maps can be used as functions, you can use a map as a
+predicate. This will return the value of the first key in the
+collection that is also in the map.</p><pre><code class="klipse-clojure nohighlight">(some {:a 1 :b 5} [:h :k :d :b])
+;; ⇒ 5
+</code></pre><p>Sets can also be used as functions and will return the first item in
+the collection that is present in the set.</p><pre><code class="klipse-clojure nohighlight">(some #{4} (range 20))
+;; ⇒ 4
+</code></pre><p><a id="every?_desc"></a></p><h3 id="every">every?</h3><pre><code class="clojure">([pred coll])
+</code></pre><p><code>every</code> takes a function that accepts a single argument and a collection.</p><p><code>every</code> returns true if the predicate returns true for every item in
+the collection, otherwise it returns false.</p><pre><code class="klipse-clojure nohighlight">(every? even? (range 0 10 2))
+;; ⇒ true
+</code></pre><pre><code class="klipse-clojure nohighlight">;; set can be used to see if collection only contains items in the set.
+(every? #{2 3 4} [2 3 4 2 3 4])
+;; ⇒ true
+</code></pre><h2 id="processing-collections-and-sequences">Processing Collections and Sequences</h2><p><a id="partition_desc"></a></p><h3 id="partition">partition</h3><pre><code class="clojure">([n coll])
+([n step coll])
+([n step pad coll])
+</code></pre><p><code>partition</code> takes a number, an optional step, an optional padding
+collection and a collection. If the padding collection is provided, a
+step must be provided.</p><p><code>partition</code> sequentially takes a provided number of items from the
+collection in sequence and puts them into lists. This lazy sequence of
+lists is returned.</p><p>If a step is provided, the lists in the returned lazy sequence start
+at offsets in the provided collection of that number items in the
+list.</p><p>If a padding collection is provided, the last item in the returned
+lazy sequence will be padded with the padding collection to achieve
+the desired partitioning size.</p><p>If there is no padding collection provided and there is not enough
+items to fill the last list in the returned lazy sequence, those items
+will be not used.</p><pre><code class="clojure">TBD: example
+</code></pre><p><a id="partition-all_desc"></a></p><h3 id="partition-all">partition-all</h3><pre><code class="clojure">([n coll])
+([n step coll])
+</code></pre><p><code>partition-all</code> takes a number, an optional step and a collection.</p><p><code>partition-all</code> sequentially takes a provided number of items from the
+collection in sequence and puts them into lists. This lazy sequence of
+lists is returned.</p><p>If a step is provided, the lists in the returned lazy sequence start
+at offsets in the provided collection of that number items in the
+list.</p><p>If there are not enough items to fill the last list in the returned
+lazy sequence, the remaining items will be used in the last list.</p><pre><code class="clojure">TBD: example
+</code></pre><h3 id="filter-1">filter</h3><p>See: <a href="https://clojure-doc.org/articles/language/core_overview/filter_desc">filter</a></p><h3 id="remove-1">remove</h3><p>See: <a href="https://clojure-doc.org/articles/language/core_overview/remove_desc">remove</a></p><h3 id="for-2">for</h3><p>See: <a href="https://clojure-doc.org/articles/language/core_overview/for_desc">for</a></p><h3 id="map-1">map</h3><p>See: <a href="https://clojure-doc.org/articles/language/core_overview/map_desc">map</a></p><h3 id="remove-2">remove</h3><p>See: <a href="https://clojure-doc.org/articles/language/core_overview/remove_desc">remove</a></p><h3 id="empty-2">empty?</h3><p>See: <a href="https://clojure-doc.org/articles/language/core_overview/empty?_desc">empty</a></p><h3 id="not-empty-1">not-empty</h3><p>See: <a href="https://clojure-doc.org/articles/language/core_overview/not-empty_desc">not-empty</a></p><h2 id="function-composition-and-application">Function Composition and Application</h2><p><a id="juxt_desc"></a></p><h3 id="juxt">juxt</h3><pre><code class="clojure">([])
+([f])
+([f g])
+([f g h])
+([f1 f2 f3 &amp; fs])
+</code></pre><p><code>juxt</code> takes a variable number of functions.</p><p><code>juxt</code> returns a function that will return a vector consisting of the
+result of each of those functions to a provided argument.</p><pre><code class="clojure">TBD: examples
+</code></pre><p>TBD: Simple image accompaniment.</p><p><a id="comp_desc"></a></p><h3 id="comp">comp</h3><pre><code class="clojure">([])
+([f])
+([f g])
+([f g h])
+([f1 f2 f3 &amp; fs])
+</code></pre><p><code>comp</code> takes a variable number of functions.</p><p><code>comp</code> returns a function that will return the result of applying the
+rightmost function to the provided argument, then the second rightmost
+function to the result of that etc.</p><pre><code class="clojure">TBD: examples
+</code></pre><p>TBD: Simple image accompaniment.</p><p><a id="fnil_desc"></a></p><h3 id="fnil">fnil</h3><pre><code class="clojure">([f x])
+([f x y])
+([f x y z])
+</code></pre><p><code>fnil</code> takes a function and one to three arguments.</p><p><code>fnil</code> returns a function that replaces any nil arguments with the
+provided values. <code>fnil</code> only supports supports patching 3 arguments,
+but will pass any arguments beyond that un-patched.</p><pre><code class="klipse-clojure nohighlight">(defn say-info [name location hobby]
+  (println name "is from" location "and enjoys" hobby))
+
+(def say-info-patched (fnil say-info "Someone" "an unknown location" "Clojure"))
+
+(say-info-patched nil nil nil)
+;; ⇒ Someone is from an unknown location and enjoys Clojure
+</code></pre><pre><code class="klipse-clojure nohighlight">(say-info-patched "Robert" nil "giraffe migrations")
+;; ⇒ Robert is from an unknown location and enjoys giraffe migrations
+</code></pre><p><a id="apply_desc"></a></p><h3 id="apply">apply</h3><pre><code class="clojure">([f args] [f x args] [f x y args] [f x y z args] [f a b c d &amp; args])
+</code></pre><p><code>apply</code> takes a variable number of arguments and a collection.</p><p><code>apply</code> effectively unrolls the supplied args and a collection into a
+list of arguments to the supplied function.</p><pre><code class="klipse-clojure nohighlight">(str ["Hel" "lo"])
+;; ⇒ "[\"Hel\" \"lo\"]" ;; not what we want, str is operating on the vector
+</code></pre><pre><code class="klipse-clojure nohighlight">(apply str ["Hel" "lo"]) ;; same as (str "Hel" "lo")
+;; ⇒ "Hello"
+</code></pre><p><code>apply</code> prepends any supplied arguments to the form as well.</p><pre><code class="klipse-clojure nohighlight">(map + [[1 2 3] [1 2 3]]) ;; This attempts to add 2 vectors with +
+;; ClassCastException   java.lang.Class.cast (Class.java:2990)
+</code></pre><pre><code class="klipse-clojure nohighlight">(apply map + [[1 2 3] [1 2 3]]) ;; same as (map + [1 2 3] [1 2 3])
+;; ⇒ (2 4 6)
+</code></pre><pre><code class="klipse-clojure nohighlight">(apply + 1 2 3 [4 5 6]) ;; same as  (+ 1 2 3 4 5 6)
+;; ⇒ 21
+</code></pre><p>Note that apply can not be used with macros.</p><p><a id="-_desc"></a></p><h3 id="-">-&gt;</h3><pre><code class="clojure">([x])
+([x form])
+([x form &amp; more])
+</code></pre><p><code>-&gt;</code> takes a value and optionally one or more expressions.</p><p><code>-&gt;</code> takes the first argument and inserts it as the second item in the
+next form, or creates a list with the first argument as the second
+item. The return value of that expression is inserted as the second
+item in the next form, making a list if necessary.  This continues
+until all expressions are evaluated and the final value is returned.</p><pre><code class="clojure">TBD: example
+</code></pre><p>TBD: Simple image accompaniment.</p><p><a id="-_desc"></a></p><h3 id="--1">-&gt;&gt;</h3><pre><code class="clojure">([x])
+([x form])
+([x form &amp; more])
+</code></pre><p><code>-&gt;&gt;</code> takes a value and optionally one or more expressions.</p><p><code>-&gt;&gt;</code> takes the first argument and inserts it as the last item in the
+next form, or creates a list with the first argument as the last
+item. The return value of that expression is inserted as the last item
+in the next form, making a list if necessary.  This continues until
+all expressions are evaluated and the final value is returned.</p><p>TBD: Simple image accompaniment.</p><h2 id="associative-collections">Associative Collections</h2><p><a id="get-in_desc"></a></p><h3 id="get-in">get-in</h3><pre><code class="clojure">([m ks] [m ks not-found])
+</code></pre><p><code>get-in</code> takes an associative collection, a sequence of keys and an optional default value.</p><p><code>get-in</code> takes the first value in the sequence of keys and retrieves
+the value, then applies each subsequent key to to the most recently
+returned value and returns the final result. If any key is not present
+when evaluated then either nil, or a provided default value is
+returned.</p><pre><code class="klipse-clojure nohighlight">(get-in {:profile {:personal {:age 28}}} [:profile :personal :age])
+;= 28
+</code></pre><p>TBD: Simple image accompaniment.</p><p><a id="update-in_desc"></a></p><h3 id="update-in">update-in</h3><pre><code class="clojure">([m [k &amp; ks] f &amp; args])
+</code></pre><p><code>update-in</code> takes an associative collection, a sequence of keys, a
+function and optional arguments to supply to that function.</p><p><code>update-in</code> takes the first value in the sequence of keys and
+retrieves the value, then applies each subsequent key to to the most
+recently returned value. The function and optional arguments are
+applied to the value and a new nested collection is returned with the
+key having the result of that function.</p><p><code>update-in</code> will create new hash-maps if a key in the sequence of keys
+does not exist. The returned collection will have a nested structure
+correlating to the provided sequence along with the result of the
+function and optional arguments as the value of the final key.</p><pre><code class="klipse-clojure nohighlight">(update-in {:profile {:personal {:age 28}}} [:profile :personal :age] inc)
+;= {:profile {:personal {:age 29}}}
+</code></pre><p>TBD: Simple image accompaniment.</p><p><a id="assoc-in_desc"></a></p><h3 id="assoc-in">assoc-in</h3><pre><code class="clojure">([m [k &amp; ks] v])
+</code></pre><p><code>assoc-in</code> takes an associative collection, a sequence of keys and a value.</p><p><code>assoc-in</code> takes the first value in the sequence of keys and retrieves
+the value, then applies each subsequent key to to the most recently
+returned value. The final key is assigned the provided value and a new
+nested collection is returned.</p><p><code>update-in</code> will create new hash-maps if a key in the sequence of keys
+does not exist. The returned collection will have a nested structure
+correlating to the provided sequence along with the provided value as
+the value of the final key.</p><pre><code class="klipse-clojure nohighlight">(assoc-in {:profile {:personal {:age 28}}} [:profile :personal :location] "Vancouver, BC")
+;= {:profile {:personal {:location "Vancouver, BC", :age 28}}}
+</code></pre><p>TBD: Simple image accompaniment.</p><p><a id="select-keys_desc"></a></p><h3 id="select-keys">select-keys</h3><pre><code class="clojure">([map keyseq])
+</code></pre><p><code>select-keys</code> takes an associative collection and a sequence of keys.</p><p><code>select-keys</code> returns a map containing only the entries that have a
+key which is also present in the sequence of keys.</p><pre><code class="klipse-clojure nohighlight">(select-keys {:a 1 :b 2 :c 3} [:a :b])
+;= {:b 2, :a 1}
+</code></pre><h3 id="keys-1">keys</h3><p>See: <a href="index.html#keys_desc">keys</a></p><h3 id="vals-1">vals</h3><p>See: <a href="index.html#vals_desc">vals</a></p><h3 id="get-1">get</h3><p>See: <a href="index.html#get_desc">get</a></p><h3 id="assoc-1">assoc</h3><p>See: <a href="index.html#assoc_desc">assoc</a></p><h3 id="dissoc-1">dissoc</h3><p>See: <a href="index.html#dissoc_desc">dissoc</a></p><h2 id="namespace-functions">Namespace Functions</h2><p><a id="ns_desc"></a></p><h3 id="ns-require-use-import-refer">ns, require, use, import, refer</h3><p>Please see the <a href="../namespaces/index.html">Namespace guide</a></p><h2 id="reference-types">Reference Types</h2><p><a id="ref_desc"></a></p><h3 id="ref-atom-var-agent">ref, atom, var, agent</h3><p>Please see the <a href="../concurrency_and_parallelism/index.html">Concurrency and Parallelism Guide</a></p><p><a id="deref_desc"></a></p><h3 id="deref-swap-reset-dosync-alter-commute-binding">deref, swap!, reset!, dosync, alter, commute, binding</h3><p>Please see the <a href="../concurrency_and_parallelism/index.html">Concurrency and Parallelism Guide</a></p><h2 id="contributors">Contributors</h2><p>Robert Randolph <a href="mailto:audiolabs@gmail.com">audiolabs@gmail.com</a> (original author)
+Michael Klishin <a href="mailto:michael@defprotocol.org">michael@defprotocol.org</a>
+Nguyễn Hà Dương <a href="mailto:cmpitg@gmail.com">cmpitg@gmail.com</a></p>
+
+    <div id="prev-next">
+        
+        <a href="../../tutorials/growing_a_dsl_with_clojure/index.html">&laquo; Growing a DSL with Clojure</a>
+        
+        
+        ||
+        
+        
+        <a href="../namespaces/index.html">Clojure Namespaces and Vars &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+ <link rel="stylesheet" type="text/css" href="https://storage.googleapis.com/app.klipse.tech/css/codemirror.css">
+<script>
+window.klipse_settings = {
+  "selector" : ".klipse-clojure"
+};
+</script>
+<script src="https://storage.googleapis.com/app.klipse.tech/plugin/js/klipse_plugin.js"></script> 
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/language/functions/index.html b/clones/clojure-doc.org/articles/language/functions/index.html
new file mode 100644
index 00000000..7e56284f
--- /dev/null
+++ b/clones/clojure-doc.org/articles/language/functions/index.html
@@ -0,0 +1,398 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Functions in Clojure</title>
+    
+
+<meta name="description" content="This guide covers:">
+
+<meta property="og:description" content="This guide covers:">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/language/functions/" />
+<meta property="og:title" content="Functions in Clojure" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/language/functions/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Functions in Clojure</h2>
+    </div>
+    
+    <p>This guide covers:</p><ul><li>How to define functions</li><li>How to invoke functions</li><li>Multi-arity functions</li><li>Variadic functions</li><li>Higher order functions</li><li>Other topics related to functions</li></ul><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons Attribution 3.0 Unported License</a>
+(including images &amp; stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on Github</a>.</p><h2 id="what-version-of-clojure-does-this-guide-cover">What Version of Clojure Does This Guide Cover?</h2><p>This guide covers Clojure 1.5.</p><h2 id="overview">Overview</h2><p>Clojure is a functional programming language. Naturally, functions are very important part of Clojure.</p><h2 id="how-to-define-functions">How To Define Functions</h2><p>Functions are typically defined using the <a href="http://clojuredocs.org/clojure_core/clojure.core/defn">defn</a> macro:</p><pre><code class="clojure">(defn round
+  [d precision]
+  (let [factor (Math/pow 10 precision)]
+    (/ (Math/floor (* d factor)) factor)))
+</code></pre><p>Functions can have doc strings (documentation strings) and it is a good idea to document functions that
+are part of the public API:</p><pre><code class="clojure">(defn round
+  "Round down a double to the given precision (number of significant digits)"
+  [d precision]
+  (let [factor (Math/pow 10 precision)]
+    (/ (Math/floor (* d factor)) factor)))
+</code></pre><p>In Clojure, function arguments may have optional type hints:</p><pre><code class="clojure">(defn round
+  [^double d ^long precision]
+  (let [factor (Math/pow 10 precision)]
+    (/ (Math/floor (* d factor)) factor)))
+</code></pre><p>Type hints sometimes allow the compiler to avoid reflective method calls and/or produce significantly more efficient bytecode.
+However, as a rule of thumb, it is usually not necessary to use type hints. Start writing your code without them. The compiler
+is also free to ignore provided hints.</p><p>Functions can also define <em>preconditions</em> and <em>postconditions</em> that put restrictions on argument values and
+the value function returns:</p><pre><code class="clojure">(defn round
+  "Round down a double to the given precision (number of significant digits)"
+  [^double d ^long precision]
+  {:pre [(not-nil? d) (not-nil? precision)]}
+  (let [factor (Math/pow 10 precision)]
+    (/ (Math/floor (* d factor)) factor)))
+</code></pre><p>In the example above, we use preconditions to check that both arguments are not nil. The <code>not-nil?</code> macro (or function) is not
+demonstrated in this example and assumed to be implemented elsewhere.</p><h2 id="anonymous-functions">Anonymous Functions</h2><p>Anonymous functions are defined using the <code>fn</code> special form:</p><pre><code class="clojure">(fn [x]
+  (* 2 x))
+</code></pre><p>Anonymous functions can be assigned to locals, passed between functions (higher order functions are covered later in this document)
+and returned from functions:</p><pre><code class="klipse-clojure nohighlight">(let [f (fn [x]
+          (* 2 x))]
+  (map f (range 0 10)))
+</code></pre><p>There is also a reader macro for anonymous functions:</p><pre><code class="klipse-clojure nohighlight">(let [f #(* 2 %)]
+  (map f (range 0 10)))
+</code></pre><p>The <code>%</code> in the example above means "the first argument". To refer to more than one argument, use <code>%1</code>, <code>%2</code> and so on:</p><pre><code class="klipse-clojure nohighlight">;; an anonymous function that takes 3 arguments and adds them together
+(let [f #(+ %1 %2 %3)]
+  (f 1 2 3))
+</code></pre><p>Please <strong>use this reader macro sparingly</strong>; excessive use may lead to unreadable code.</p><h2 id="how-to-invoke-functions">How To Invoke Functions</h2><p>Functions are invoked by placing a function to the leading position (<em>the calling position</em>) of a list:</p><pre style="visibility:hidden; height:0;"><code class="klipse-clojure nohighlight">
+(import '(goog.string format))
+</code></pre><pre><code class="klipse-clojure nohighlight">(format "Hello, %s" "world")
+</code></pre><p>This works also if you have a function stored in a local, a var or passed as an argument:</p><pre><code class="klipse-clojure nohighlight">(let [f format]
+  (f "Hello, %s" "world"))
+</code></pre><p>Alternatively, you can call a function using <a href="http://clojuredocs.org/clojure_core/clojure.core/apply">clojure.core/apply</a></p><pre><code class="klipse-clojure nohighlight">(apply format "Hello, %s" ["world"])
+</code></pre><pre><code class="klipse-clojure nohighlight">(apply format "Hello, %s %s" ["Clojure" "world"])
+</code></pre><p><code>clojure.core/apply</code> is usually only necessary when calling variadic functions or having the list of arguments passed in
+as a collection.</p><h2 id="multi-arity-functions">Multi-arity Functions</h2><p>Functions in Clojure can have multiple <em>arities</em>, or sets of arguments:</p><pre><code class="clojure">(defn tax-amount
+  ([amount]
+     (tax-amount amount 35))
+  ([amount rate]
+     (Math/round (double (* amount (/ rate 100))))))
+</code></pre><p>In the example above, the version of the function that takes only one argument (so called <em>one-arity</em> or <em>1-arity</em> function)
+calls another version (<em>2-arity</em>) with a default parameter. This is a common use case for multiple arities: to have default
+argument values. Clojure is a hosted language and JVM (and JavaScript VMs, for that matter) does not support default argument
+values, however, it does support <em>method overloading</em> and Clojure takes advantage of this.</p><p>Arities in Clojure can only differ by the number of arguments, not types. This is because Clojure is strongly dynamically typed language and type information about
+parameters may or may not be available to the compiler.</p><p>A larger example:</p><pre><code class="clojure">(defn range
+  ([]
+    (range 0 Double/POSITIVE_INFINITY 1))
+  ([end]
+    (range 0 end 1))
+  ([start end]
+    (range start end 1))
+  ([start end step]
+    (comment Omitted for clarity)))
+</code></pre><h2 id="destructuring-of-function-arguments">Destructuring of Function Arguments</h2><p>Sometimes function arguments are data structures: vectors, sequences, maps. To access parts of such
+data structure, you may do something like this:</p><pre><code class="clojure">(defn currency-of
+  [m]
+  (let [currency (get m :currency)]
+    currency))
+</code></pre><p>For vector arguments:</p><pre><code class="clojure">(defn currency-of
+  [pair]
+  (let [amount   (first  pair)
+        currency (second pair)]
+    currency))
+</code></pre><p>However, this is boilerplate code that has little to do with what the function really does. Clojure
+lets developer <strong>destructure</strong> parts of arguments, for both maps and sequences.</p><h3 id="positional-destructuring">Positional Destructuring</h3><p>Destructuring over vectors (<strong>positional destructuring</strong>) works like this: you replace the argument
+with a vector that has "placeholders" (symbols) in positions you want to bind. For example, if the
+argument is known to be a pair and you need second argument, it would look like this:</p><pre><code class="clojure">(defn currency-of
+  [[amount currency]]
+  currency)
+</code></pre><p>In the example above the first element in the pair is bound to <code>amount</code> and the second one is bound to
+<code>currency</code>. So far so good. However, notice that we do not use the <code>amount</code> local. In that case, we can
+ignore it by replacing it with an underscore:</p><pre><code class="clojure">(defn currency-of
+  [[_ currency]]
+  currency)
+</code></pre><p>Destructuring can nest (destructure deeper than one level):</p><pre><code class="clojure">(defn first-first
+  [[[i _] _]]
+  i)
+</code></pre><p>While this article does not cover <code>let</code> and locals, it is worth demonstrating that positional destructuring works
+exactly the same way for let bindings:</p><pre><code class="klipse-clojure nohighlight">(let [pair         [10 :gbp]
+      [_ currency] pair]
+  currency)
+</code></pre><h3 id="map-destructuring">Map Destructuring</h3><p>Destructuring over maps and records (<strong>map destructuring</strong>) works slightly differently:</p><pre><code class="clojure">(defn currency-of
+  [{currency :currency}]
+  currency)
+</code></pre><p>In this case example, we want to bind the value for key <code>:currency</code> to <code>currency</code>. Keys don't have to be
+keywords:</p><pre><code class="clojure">(defn currency-of
+  [{currency "currency"}]
+  currency)
+</code></pre><pre><code class="clojure">(defn currency-of
+  [{currency 'currency}]
+  currency)
+</code></pre><p>When destructuring multiple keys at once, it is more convenient to use a slightly different syntax:</p><pre><code class="clojure">(defn currency-of
+  [{:keys [currency amount]}]
+  currency)
+</code></pre><p>The example above assumes that map keys will be keywords and we are interested in two values: <code>currency</code>
+and <code>amount</code>. The same can be done for strings:</p><pre><code class="clojure">(defn currency-of
+  [{:strs [currency amount]}]
+  currency)
+</code></pre><p>and symbols:</p><pre><code class="clojure">(defn currency-of
+  [{:syms [currency amount]}]
+  currency)
+</code></pre><p>In practice, keywords are very commonly used for map keys so destructuring with <code>{:keys [...]}</code> is very common
+as well.</p><p>Map destructuring also lets us specify default values for keys that may be missing:</p><pre><code class="clojure">(defn currency-of
+  [{:keys [currency amount] :or {currency :gbp}}]
+  currency)
+</code></pre><p>This is very commonly used for implementing functions that take "extra options" (faking named arguments support).</p><p>Just like with positional destructuring, map destructuring works exactly the same way for let bindings:</p><pre><code class="klipse-clojure nohighlight">(let [money               {:currency :gbp :amount 10}
+     {currency :currency} money]
+  currency)
+</code></pre><h2 id="variadic-functions">Variadic Functions</h2><p>Variadic functions are functions that take varying number of arguments (some arguments are optional). Two examples
+of such function in <code>clojure.core</code> are <code>clojure.core/str</code> and <code>clojure.core/format</code>:</p><pre><code class="klipse-clojure nohighlight">(str "a" "b")
+; ⇒ "ab"
+</code></pre><pre><code class="klipse-clojure nohighlight">(str "a" "b" "c")
+; ⇒ "abc"
+</code></pre><pre><code class="klipse-clojure nohighlight">(format "Hello, %s" "world")
+; ⇒ "Hello, world"
+</code></pre><pre><code class="klipse-clojure nohighlight">(format "Hello, %s %s" "Clojure" "world")
+; ⇒ "Hello, Clojure world"
+</code></pre><p>To define a variadic function, prefix optional arguments with an ampersand (<code>&amp;</code>):</p><pre><code class="clojure">(defn log
+  [message &amp; args]
+  (comment ...))
+</code></pre><p>In the example above, one argument is required and the rest is optional. Variadic functions
+are invoked as usual:</p><pre><code class="klipse-clojure nohighlight">(defn log
+  [message &amp; args]
+  (println "args: " args))
+
+(log "message from " "192.0.0.76")
+</code></pre><pre><code class="klipse-clojure nohighlight">(log "message from " "192.0.0.76" "service:xyz")
+</code></pre><p>As you can see, optional arguments (<code>args</code>) are packed into a list.</p><h3 id="extra-arguments-aka-named-parameters">Extra Arguments (aka Named Parameters)</h3><p>Named parameters are achieved through the use of destructuring a variadic function.</p><p>Approaching named parameters from the standpoint of destructuring a variadic function allows for more clearly readable function invocations.  This is an example of named parameters:</p><pre><code class="klipse-clojure nohighlight">(defn job-info
+  [&amp; {:keys [name job income] :or {job "unemployed" income "$0.00"}}]
+  (if name
+    [name job income]
+    (println "No name specified")))
+</code></pre><p>Using the function looks like this:</p><pre><code class="klipse-clojure nohighlight">(job-info :name "Robert" :job "Engineer")
+;; ["Robert" "Engineer" "$0.00"]
+</code></pre><pre><code class="klipse-clojure nohighlight">(job-info :job "Engineer")
+;; No name specified
+</code></pre><p>Without the use of a variadic argument list, you would have to call the function with a single map argument such as <code>{:name "Robert" :job "Engineer}</code>.</p><p>Keyword default values are assigned by use of the <code>:or</code> keyword followed by a map of keywords to their default value.
+Keywords not present and not given a default will be nil.</p><h2 id="higher-order-functions">Higher Order Functions</h2><p>Higher-order functions (<em>HOFs</em>) are functions that take other functions as arguments. HOFs
+are an important functional programming technique and are quite commonly used in Clojure. One example
+of an HOF is a function that takes a function and a collection and returns a collection of elements
+that satisfy a condition (a predicate). In Clojure, this function is called <code>clojure.core/filter</code>:</p><pre><code class="klipse-clojure nohighlight">(filter even? (range 0 10))  ; ⇒ (0 2 4 6 8)
+</code></pre><p>In the example above, <code>clojure.core/filter</code> takes <code>clojure.core/even?</code> as an argument.</p><p><code>clojure.core</code> has dozens of other higher-order functions. The most commonly used ones are covered in <a href="../core_overview/index.html">clojure.core Overview</a>.</p><h2 id="private-functions">Private Functions</h2><p>Functions in Clojure can be private to their namespace.</p><p>They are covered in more detail in the <a href="../namespaces/index.html">Namespaces</a> guide.</p><h2 id="keywords-as-functions">Keywords as Functions</h2><p>In Clojure, keywords can be used as functions. They take a map or record and look themselves up in it:</p><pre><code class="klipse-clojure nohighlight">(:age {:age 27 :name "Michael"}) 
+; ⇒ 27
+</code></pre><p>This is commonly used with higher order functions:</p><pre><code class="klipse-clojure nohighlight">(map :age [{:age 45 :name "Joe"}
+           {:age 42 :name "Jill"}
+           {:age 17 :name "Matt"}]) 
+;; ⇒ (45 42 17)
+</code></pre><p>and the <code>-&gt;</code> macro:</p><pre><code class="klipse-clojure nohighlight">(-&gt; [{:age 45 :name "Joe"} {:age 42 :name "Jill"}]
+     first 
+     :name)
+;; ⇒ "Joe"
+</code></pre><h2 id="maps-as-functions">Maps as Functions</h2><p>Clojure maps are also functions that take keys and look up values for them:</p><pre><code class="klipse-clojure nohighlight">({:age 42 :name "Joe"} :name)
+; ⇒ "Joe"
+</code></pre><pre><code class="klipse-clojure nohighlight">({:age 42 :name "Joe"} :age)
+; ⇒ 42
+</code></pre><pre><code class="klipse-clojure nohighlight">({:age 42 :name "Joe"} :unknown)
+; ⇒ nil
+</code></pre><p>Note that this is <strong>not true</strong> for Clojure records, which are almost identical to maps in other
+cases.</p><h2 id="sets-as-functions">Sets as Functions</h2><pre><code class="klipse-clojure nohighlight">(#{1 2 3} 1)
+; ⇒ 1
+</code></pre><pre><code class="klipse-clojure nohighlight">(#{1 2 3} 10)
+; ⇒ nil
+</code></pre><pre><code class="klipse-clojure nohighlight">(#{:us :au :ru :uk} :uk)
+; ⇒ :uk
+</code></pre><pre><code class="klipse-clojure nohighlight">(#{:us :au :ru :uk} :cn)
+; ⇒ nil
+</code></pre><p>This is often used to check if a value is in a set:</p><pre><code class="clojure">(when (countries :in)
+  (comment ...))
+
+(if (countries :in)
+  (comment Implement positive case)
+  (comment Implement negative case))
+</code></pre><p>because everything but <code>false</code> and <code>nil</code> evaluates to <code>true</code> in Clojure.</p><h2 id="clojure-functions-as-comparators">Clojure Functions As Comparators</h2><p>Clojure functions implement the <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Comparator.html">java.util.Comparator</a>
+interface and can be used as comparators.</p><h2 id="wrapping-up">Wrapping Up</h2><p>Functions are at the heart of Clojure. They are defined using the <code>defn</code> macro, can have multiple arities,
+be variadic and support parameter destructuring. Function arguments and return value can optionally be
+type hinted.</p><p>Functions are first class values and can be passed to other functions (called Higher Order Functions or HOFs).
+This is fundamental to functional programming techniques.</p><p>Several core data types behave like functions. When used reasonably, this can lead to more concise, readable
+code.</p><h2 id="contributors">Contributors</h2><p>Michael Klishin <a href="mailto:michael@defprotocol.org">michael@defprotocol.org</a>, 2012 (original author)</p>
+
+    <div id="prev-next">
+        
+        <a href="../collections_and_sequences/index.html">&laquo; Collections and Sequences in Clojure</a>
+        
+        
+        ||
+        
+        
+        <a href="../laziness/index.html">Laziness in Clojure &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+ <link rel="stylesheet" type="text/css" href="https://storage.googleapis.com/app.klipse.tech/css/codemirror.css">
+<script>
+window.klipse_settings = {
+  "selector" : ".klipse-clojure"
+};
+</script>
+<script src="https://storage.googleapis.com/app.klipse.tech/plugin/js/klipse_plugin.js"></script> 
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/language/glossary/index.html b/clones/clojure-doc.org/articles/language/glossary/index.html
new file mode 100644
index 00000000..71a5a264
--- /dev/null
+++ b/clones/clojure-doc.org/articles/language/glossary/index.html
@@ -0,0 +1,344 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Clojure Terminology Guide</title>
+    
+
+<meta name="description" content="A glossary of terminology specific to Clojure. Terms
+are listed in alphabetical order.Terms">
+
+<meta property="og:description" content="A glossary of terminology specific to Clojure. Terms
+are listed in alphabetical order.Terms">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/language/glossary/" />
+<meta property="og:title" content="Clojure Terminology Guide" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/language/glossary/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Clojure Terminology Guide</h2>
+    </div>
+    
+    <p>A glossary of terminology specific to Clojure. Terms
+are listed in alphabetical order.</p><h2 id="terms">Terms</h2><h3 id="arity">arity</h3><p>The number of arguments a function takes is its arity.  If it's
+written to take a variable number of args, it's referred to as
+<a href="index.html#variadic">variadic</a>.</p><p>Functions can have multiple arity (for example, a function might have
+2 different bodies: one for when 2 args are passed, and another when 3
+args are passed).</p><h3 id="binding-form">binding-form</h3><p>Could mean one of two things:</p><ol><li><p>the expression you're binding to in a
+<a href="index.html#let_binding">let-binding</a>. It might be a simple name, or it
+might be a data structure used for
+<a href="index.html#destructuring">destructuring</a>.</p></li><li><p>Clojure provides the <code>binding</code> macro, used for setting the
+thread-local value of a dynamic var. The whole expression (form)
+is sometimes referred to as the "binding <a href="index.html#form">form</a>".</p></li></ol><h3 id="classpath">classpath</h3><p>The search path used by the JVM to locate classes which are not
+part of the Java standard class library. May include jar files.</p><h3 id="comparator">comparator</h3><p>A function that takes two args and compares them.  Returns -1, 0, or 1
+depending whether the first arg is less than, equal to or greater than
+the second.  The stock comparator that Clojure.core comes with is
+<code>compare</code>.</p><h3 id="coordinates">coordinates</h3><p>The "group-id/artifact-id version-string" identifier used in your
+project.clj to indicate a particular dependency.</p><p>See also <a href="index.html#libspec">libspec</a>.</p><h3 id="destructuring">destructuring</h3><p>The handy trick used in a <a href="index.html#let_binding">let-binding</a> to "unpack" the
+values from a data structure into the locals you're going to use.  See
+also <a href="index.html#binding-form">binding-form</a> and <a href="https://clojure-doc.org/articles/language/glossary/functions.html#destructuring_of_function_arguments">the destructuring section in
+the functions
+guide</a>.</p><h3 id="dereference">dereference</h3><p>To get the value of a reference type. You can use the <code>deref</code> function
+for this, or else some syntactic sugar: <code>@some-ref-type</code>.</p><h3 id="entry">entry</h3><p>A key/value pair in a map. Try <code>(type (first {:a 1 :b 2}))</code> and see
+that it returns <code>clojure.lang.MapEntry</code>.</p><h3 id="evaluator">evaluator</h3><p><em>todo</em></p><h3 id="form">form</h3><p>A valid s-expression. For example: <code>(+ 1 1)</code> and <code>(defn foo [x] (* x x))</code>.</p><h3 id="head-retention">head retention</h3><p><a href="index.html#lazy">Lazy</a> sequences are still <a href="index.html#persistence">persistent</a>. If you
+make <em>another</em> data structure using one, the original lazy sequence
+will be kept around and not garbage-collected. If the lazy sequence in
+infinite, and grows very large, it can cause performance problems or
+even an out-of-memory error. Accidentally keeping around a lazy
+sequence like this is referred to as "head retention".</p><h3 id="homoiconicity">homoiconicity</h3><p>Where the code and the data is represented by the same structure.
+This allows the code to be treated as data, and the data to be treated
+as code. This feature of Clojure, and other Lisps, allows for
+macros in the language, since they can operate on code as a data
+structure, and to return a transformation of that structure to
+be the representation of new code.</p><h3 id="idempotent">idempotent</h3><p>An operation that when given the same inputs will produce the same
+result when called one or more times. An idempotent function may
+produce a side effect, such a updating a ref or an atom, but will
+only produce the side effect once. An idempotent function is
+different than a pure function, in that a pure function will
+produce no side effects.</p><h3 id="identity">identity</h3><p>A logical entity in your program that may change over time --- it may
+take on different states at different times, but it still means the
+same logical entity. Clojure uses <a href="index.html#reference_types">reference types</a>
+to represent identities.  This is not to be confused with the <code>identity</code> function that just returns the argument given to it.</p><h3 id="implicit-do">implicit do</h3><p>The bodies of some expressions act like <code>do</code> in that you can include
+multiple expressions in them, and the expressions will be evaluated in
+the order they appear, with the resulting value of the body being the
+last expression evaluated. Forms that do this include: <code>when</code>,
+<code>when-let</code>, <code>fn</code>, <code>defn</code>, <code>let</code>, <code>loop</code>, and <code>try</code>.</p><h3 id="intern">intern</h3><p>A method of storing values or immutable data structures as a single
+copy of the item, allowing for more space-efficiency, and possibly
+time-efficiency, with the trade off of requiring more time being
+required when interning the item. When the string "clojure" is interned,
+all instances of the string "clojure" will reference the exact same
+instance, instead of having multiple string objects with the same value
+of "clojure".</p><h3 id="keyword">keyword</h3><p>A Clojure scalar data type whose literal syntax looks <code>:like</code> <code>:this</code>.
+They are like numbers and strings in that they evaluate to themselves,
+and are most often seen being used as keys in <a href="index.html#map">hash-maps</a>.</p><p>See also <a href="index.html#namespaced_keyword">namespaced keyword</a></p><p>The term is also used when talking about functions that take "keyword
+arguments", for example, something like: <code>(my-func :speed 42 :mass 2)</code>
+(as opposed to <code>(my-func {:speed 42 :mass 2})</code>).</p><h3 id="lazy">lazy</h3><p>Clojure can (and often does) create sequences for you that aren't
+fully computed. Upon casual inspection they <em>look</em> just like a regular
+list, but particular values in them are only computed the moment you
+ask for them --- not sooner.</p><p>This has the added benefit that you can easily create infinite
+sequences that don't consume infinite memory.</p><p>Many of the built-in Clojure functions return lazy sequences.</p><p>See also <a href="index.html#realize">realize</a>.</p><h3 id="let-binding">let-binding</h3><p>AKA, "binding vector", or just "bindings": in a <code>let</code> (and expressions
+that work like let, for example, <code>defn</code>, <code>loop</code>, <code>loop</code>, &amp; <code>fn</code>), the
+vector that comes first where you specify lexical bindings.</p><p>See also <a href="index.html#binding_form">binding form</a></p><h3 id="libspec">libspec</h3><p><em>todo</em></p><h3 id="macro">macro</h3><p>A special type of function which is transforms a S-Expression read in
+and applies a transformation to the S-Expression resulting in a new
+form.  This process is called macro-expansion, and is done as part
+of the Clojure reader.</p><h3 id="map">map</h3><p>Either refers to the built in <code>map</code> function, or else means "a
+hash-map object".</p><h3 id="memoization">memoization</h3><p>The ability to cache a result of a function call by given arguments,
+and return the result without having to do the calculation again.
+Memoization is a time-space trade off in that more memory is used
+to store the results of a function call to be able to return the
+value instead of having to keep spending time doing the calculation
+involved in the function.</p><h3 id="metadata">metadata</h3><p>An extra map that you can attach to a collection value (or a symbol),
+which contains data about the data you're attaching it to. Use <code>meta</code>
+to see the metadata of a given value.</p><h3 id="namespaced-keyword">namespaced keyword</h3><p>When you put two colons in front of a keyword's name --- for example
+::foo --- it is a so-called "namespaced keyword", and is expanded by
+the reader to become :current-namespace/foo.</p><h3 id="nullipotent">nullipotent</h3><p>An operation with no side effects.  The result of calling the function
+one or more times is the same as if it was never called.  Queries are
+typically good examples of functions that are nullipotent, as they
+do not modify the state of the object or structure they are queried
+against.</p><h3 id="persistence">persistence</h3><p>See the <a href="https://clojure-doc.org/articles/language/tutorials/introduction.html#values_immutability_and_persistence">relevant section of the
+introduction</a>.</p><h3 id="predicate">predicate</h3><p>A function taking one or more args and returning a boolean (<code>true</code> or
+<code>false</code>). Its name typically ends with a question mark. Some examples:
+<code>nil?</code>, <code>zero?</code>, <code>string?</code>.</p><h3 id="pure-function">pure function</h3><p>A function that given the same inputs will always produce the same
+result. A pure function also does not have any observable side effects
+and cannot depend on any outside state, other than that which was given
+as arguments to the function. A pure function's result also cannot change
+during the execution of the program or between executions of the program,
+as the dependency on outside state can lead to changes in the result of
+the function.  Pure functions are also
+<a href="index.html#referential-transparency">referentially transparent.</a></p><h3 id="reader">reader</h3><p><em>todo</em></p><h3 id="reader-macro">reader macro</h3><p>Syntax that the Clojure reader recognizes as special syntactic sugar,
+for example, <code>#""</code>, <code>#{}</code>, quoting, etc.</p><h3 id="realize">realize</h3><p>When the next value in a <a href="index.html#lazy">lazy</a> sequence is accessed for the
+first time, and is computed so as to made available, it is said to
+have been "realized".  This term is also used to refer to the status of <a href="https://clojure-doc.org/articles/language/glossary/concurrency_and_parallelism.html#promises">promises</a>, <a href="https://clojure-doc.org/articles/language/glossary/concurrency_and_parallelism.html#futures">futures</a>, and <a href="https://clojure-doc.org/articles/language/glossary/concurrency_and_parallelism.html#delays">delays</a>.  That is, if a promise (for example) is realized then that means its value has been delivered and is accessible via <a href="index.html#dereference">dereferencing</a>.</p><h3 id="reference-types">reference types</h3><p>Vars, atoms, refs, and agents are all reference types. They are
+mutable in the sense that you can change to what value they refer, and
+Clojure provides thread-safe mechanisms for doing so.</p><h3 id="referential-transparency">referential transparency</h3><p>An expression that will always return the same result for the values
+given, and can be substituted for the resulting value, without
+effecting the program.  The advantage of referential transparent
+expressions is that they can be memoized, and be the subject of
+various compilier optimizations.</p><h3 id="reify">reify</h3><p><em>todo</em></p><h3 id="repl">REPL</h3><p>Short for: "Read, Eval, Print, Loop".  The REPL reads in text through
+the <a href="index.html#reader">reader</a> transforming it into a Clojure data structure,
+<a href="index.html#evaluator">evaluates</a> the data structure as code, prints the result
+of the evaluation, and loops back waiting to read the next input string.</p><h3 id="rest-args">rest args</h3><p>The extra args passed to a <a href="index.html#variadic">variadic</a> function, for example
+if <code>my-func</code> were defined like <code>(defn my-func [a b &amp; more] ...)</code>, then
+called like <code>(my-func 1 2 3 4 5)</code>, then 3, 4, &amp; 5 are the "rest args".</p><h3 id="s-expression">s-expression</h3><p>Short for Symbolic Expression. A S-Expression is a data structure able
+to represent both simple datastructes such as literals, or complex data
+structures such as nested expressions. Due to their versatile nature,
+S-Expressions are able to represent both data in Clojure, as well as
+the Clojure code itself, allowing Clojure to be a
+<a href="index.html#homoiconicity">homoiconic</a> language.</p><h3 id="state">state</h3><p>The <a href="index.html#value">value</a> that a given <a href="index.html#identity">identity</a> may have at a
+given time.  When you change the state of an identity, you're changing
+to which value it refers. Clojure uses values to represent states.</p><h3 id="stm-software-transactional-memory">STM (Software Transactional Memory)</h3><p>Software Transactional Memory (STM) is a concurrency control method to
+coordinate and control access to shared storage as an alternative to
+lock-based synchronization. Clojure's STM uses multiversion concurrency
+control (MVCC) as an alternative to lock-based transactions, as well as
+ensuring changes are made atomically, consistently, and in
+isolation. It does this by taking a snapshot of the ref, making the
+changes in isolation to the snapshot, and apply the result. If the STM
+detects that another transaction has made an update to the ref, the
+current transaction will be forced to retry.</p><h3 id="symbol">symbol</h3><p>An identifier that refers to vars or local values.</p><h3 id="tagged-literals">tagged literals</h3><p>(Formerly called "reader literals".)</p><p>Some literals begin with a hash mark "#" (so-called "dispatch
+macros"); for example, <code>#{}</code> for sets and <code>#""</code> for regex
+literals. Starting with Clojure 1.4, you can create your own
+#-prefixed literal which causes the reader to parse the form
+following it using a function or macro of your own
+choosing/devising. It's in this way that you can <em>tag</em> a literal to be
+handled specially by the reader.</p><p>For more info, see <a href="http://clojure.org/reader">the "Tagged Literals" section of the reader
+doc</a>.</p><h3 id="threading-macros">threading macros</h3><p>The thread-first (<code>-&gt;</code>) and thread-last (<code>-&gt;&gt;</code>) macros.  "Threading"
+refers to how they pass values to each subsequent argument in the
+macro, not concurrency.</p><h3 id="thrush">thrush</h3><p>A combinator. Not the same thing as the <a href="index.html#threading-macros">thread-first
+macro</a>.  More info at
+<a href="http://blog.fogus.me/2010/09/28/thrush-in-clojure-redux/">http://blog.fogus.me/2010/09/28/thrush-in-clojure-redux/</a> if you're
+curious.</p><h3 id="transaction">transaction</h3><p><em>todo</em></p><h3 id="type-erasure">type erasure</h3><p>Java-related: Java generics allow you to specify a type for a
+collection.  This way you don't have to cast every object you pull out
+of an ArrayList like in the old days. This is a courtesy of the java
+compiler. The java runtime doesn't know about generics --- the
+compiler does all the checking for you, then the type information is
+discarded at runtime. In Clojure, this discarding is referred to as
+type erasure.</p><h3 id="value">value</h3><p>An immutable object, such as the number 1, the character <code>\a</code>, the
+string "hello", or the vector <code>[1 2 3]</code>. In Clojure, all scalars and
+built-in core data structures are values.</p><h3 id="variadic">variadic</h3><p>A function that can take a variable number of arguments.
+See also <a href="index.html#rest_args">rest args</a>.</p>
+
+    <div id="prev-next">
+        
+        <a href="../concurrency_and_parallelism/index.html">&laquo; Concurrency and Parallelism in Clojure</a>
+        
+        
+        ||
+        
+        
+        <a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/language/interop/index.html b/clones/clojure-doc.org/articles/language/interop/index.html
new file mode 100644
index 00000000..891281b5
--- /dev/null
+++ b/clones/clojure-doc.org/articles/language/interop/index.html
@@ -0,0 +1,617 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Clojure interoperability with Java</title>
+    
+
+<meta name="description" content="This guide covers:">
+
+<meta property="og:description" content="This guide covers:">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/language/interop/" />
+<meta property="og:title" content="Clojure interoperability with Java" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/language/interop/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Clojure interoperability with Java</h2>
+    </div>
+    
+    <p>This guide covers:</p><ul><li>How to instantiate Java classes</li><li>How to invoke Java methods</li><li>How to extend Java classes with proxy</li><li>How to implement Java interfaces with reify</li><li>How to generate Java classes with gen-class</li><li>Other topics related to interop</li></ul><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons Attribution 3.0 Unported License</a>
+(including images &amp; stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on Github</a>.</p><h2 id="what-version-of-clojure-does-this-guide-cover">What Version of Clojure Does This Guide Cover?</h2><p>This guide covers Clojure 1.5.</p><h2 id="overview">Overview</h2><p>Clojure was designed to be a hosted language that directly interoperates with its host platform (JVM, CLR and so on).
+Clojure code is compiled to JVM bytecode. For method calls on Java objects, Clojure compiler
+will try to emit the same bytecode <code>javac</code> would produce.</p><p>It is possible to implement interfaces, extend and generate Java classes in Clojure.</p><p>Clojure also provides convenient functions and macros that make consuming of Java libraries
+easier and often more concise than it would be in Java code.</p><h2 id="imports">Imports</h2><p>Java classes can be referenced either using their fully-qualified names (FQNs) such as
+<code>java.util.Date</code> or be <em>imported</em> in the current Clojure namespace using <code>clojure.core/import</code> and
+referenced by short names:</p><pre><code class="clojure">java.util.Date  ; ⇒ java.util.Date
+</code></pre><pre><code class="clojure">(import java.util.Date)
+
+Date  ; ⇒ java.util.Date
+</code></pre><p><code>ns</code> macro supports imports, too:</p><pre><code class="clojure">(ns myservice.main
+  (:import java.util.Date))
+</code></pre><p>More about the <code>ns</code> macro can be found in the article on <a href="../namespaces/index.html">Clojure namespaces</a>.</p><p>Dynamic (at runtime) imports are usually only used in the REPL and cases when there are multiple implementations of a particular
+protocol/service/feature and it is not possible to tell which one should be used until run time.</p><h3 id="automatic-imports-for-javalang">Automatic Imports For java.lang.*</h3><p>Classes from the <code>java.lang</code> package are automatically imported. For example, you can use <code>String</code> or <code>Math</code>
+without explicitly importing them:</p><pre><code class="clojure">(defn http-uri?
+  [^String uri]
+  (.startsWith (.toLowerCase uri) "http"))
+
+(Math/round 0.7886)
+</code></pre><h3 id="inner-nested-classes">Inner (Nested) Classes</h3><p>In Java, classes can be nested inside other classes. They are called <em>inner classes</em> and by convention,
+separated from their outer class by a dollar sign (<code>$</code>):</p><pre><code class="clojure">(import java.util.Map$Entry)
+
+Map$Entry  ; ⇒ java.util.Map$Entry
+
+;; this example assumes RabbitMQ Java client is on classpath
+(import com.rabbitmq.client.AMQP$BasicProperties)
+
+AMQP$BasicProperties  ; ⇒ com.rabbitmq.client.AMQP$BasicProperties
+</code></pre><p>Note that if you need to use both a class and one or more of its inner classes, they all need to be imported separately.
+As far as JVM is concerned, they are all separate classes, there is no "imports hierarchy".</p><h2 id="how-to-instantiate-java-classes">How to Instantiate Java Classes</h2><p>Java classes are instantiated using the <code>new</code> special form:</p><pre><code class="clojure">(new java.util.Date)  ; ⇒ #inst "2012-10-09T21:23:57.278-00:00"
+</code></pre><p>However, the Clojure reader provides a bit of syntactic sugar and you are much more likely
+to see this:</p><pre><code class="clojure">(java.util.Date.)     ; ⇒ #inst "2012-10-09T21:24:43.878-00:00"
+</code></pre><p>It is possible to use fully qualified names (e.g. <code>java.util.Date</code>) or short names with imports:</p><pre><code class="clojure">(import java.util.Date)
+
+(Date.)  ; ⇒ #inst "2012-10-09T21:24:27.229-00:00"
+</code></pre><p>An example with constructor arguments:</p><pre><code class="clojure">(java.net.URI. "http://clojure.org")  ; ⇒ #&lt;URI http://clojure.org&gt;
+</code></pre><h2 id="how-to-invoke-java-methods">How to Invoke Java Methods</h2><h3 id="instance-methods">Instance Methods</h3><p>Instance methods are invoked using the <code>.</code> special form:</p><pre><code class="clojure">(let [d (java.util.Date.)]
+  (. d getTime))  ; ⇒ 1349819873183
+</code></pre><p>Just like with object instantiation, it is much more common to see an alternative version:</p><pre><code class="clojure">(let [d (java.util.Date.)]
+  (.getTime d))  ; ⇒ 1349819873183
+</code></pre><h3 id="static-methods">Static Methods</h3><p>Static methods can be invoked with the same <code>.</code> special form:</p><pre><code class="clojure">(. Math floor 5.677)  ; ⇒ 5.0
+</code></pre><p>or (typically) to sugared version, <code>ClassName/methodName</code>:</p><pre><code class="clojure">(Math/floor 5.677)  ; ⇒ 5.0
+
+(Boolean/valueOf "false")  ; ⇒ false
+(Boolean/valueOf "true")   ; ⇒ true
+</code></pre><h3 id="chained-calls-with-the-double-dot-form">Chained Calls With The Double Dot Form</h3><p>It is possible to chain method calls using the <code>..</code> special form:</p><pre><code class="clojure">(.. (java.util.Date.) getTime toString)  ; ⇒ "1349821993809"
+</code></pre><h3 id="multiple-calls-on-the-same-object">Multiple Calls On the Same Object</h3><p>If you need to call a bunch of methods on a mutable object, you
+can use the <code>doto</code> macro:</p><pre><code class="clojure">(doto (java.util.Stack.)
+  (.push 42)
+  (.push 13)
+  (.push 7))  ; ⇒ #&lt;Stack [42, 13, 7]&gt;
+
+(let [pt (Point. 0 0)]
+  (doto pt
+    (.move  10 0)))  ; ⇒ #&lt;Point java.awt.Point[x=10, y=0]
+
+(let [pt (Point. 0 0)]
+  (doto pt
+    (.move  10 0)
+    (.translate  0 10)))  ; ⇒ #&lt;Point java.awt.point[x=10,y=10]
+</code></pre><p>The <code>doto</code> macro returns its first argument as a result.</p><h2 id="how-to-access-java-fields">How to Access Java Fields</h2><p>Public mutable fields are not common in Java libraries but sometimes you need to access them.
+It's done with the same dot special form:</p><pre><code class="clojure">(import java.awt.Point)
+
+(let [pt (Point. 0 10)]
+  (. pt x))  ; ⇒ 0
+
+(let [pt (Point. 0 10)]
+  (. pt y))  ; ⇒ 10
+</code></pre><p>and just like with instance methods, it is much more common to see the following version:</p><pre><code class="clojure">(import java.awt.Point)
+
+(let [pt (Point. 0 10)]
+  (.x pt))  ; ⇒ 0
+
+(let [pt (Point. 0 10)]
+  (.y pt))  ; ⇒ 10
+</code></pre><h2 id="how-to-set-java-fields">How to Set Java Fields</h2><p>To set a public mutable field, use <code>clojure.core/set!</code> that takes a field in the dot notation
+demonstrated earlier and a new value:</p><pre><code class="clojure">(import java.awt.Point)
+
+(let [pt (Point. 0 10)]
+  (set! (.y pt) 100)
+  (.y pt))  ; ⇒ 100
+</code></pre><p>Fortunately, mutable public fields are rare to meet in the JVM ecosystem so you won't need
+to do this often.</p><h2 id="how-to-work-with-enums">How To Work With Enums</h2><p><a href="http://docs.oracle.com/javase/tutorial/java/javaOO/enum.html">Enums (enumeration) type</a> values are accessed
+the same way as fields, except on enum classes and not objects:</p><pre><code class="clojure">java.util.concurrent.TimeUnit/MILLISECONDS  ; ⇒ #&lt; MILLISECONDS&gt;
+</code></pre><h2 id="determining-classes-of-java-objects">Determining Classes of Java Objects</h2><p>To get class of a particular value, pass it to <code>clojure.core/class</code>:</p><pre><code class="clojure">(class 1)       ; ⇒ java.lang.Long
+(class 1.0)     ; ⇒ java.lang.Double
+(class "docs")  ; ⇒ java.lang.String
+(class (java.net.URI. "https://github.com"))  ; ⇒ java.net.URI
+</code></pre><p>As this example demonstrates, Clojure strings are JVM strings, integer literals are compiled
+as longs and floating point literals are compiled as doubles.</p><p>You can also use <code>clojure.core/type</code> to return either the class of the
+Java object, or the <code>:type</code> metadata if it exists:</p><pre><code class="clojure">(def foo (with-meta [1 2 3] {:type :bar}))
+(type foo)
+;; ⇒ :bar
+(type [1 2 3])
+;; ⇒ clojure.lang.PersistentVector
+</code></pre><h2 id="how-to-get-a-java-class-reference-by-name">How To Get a Java Class Reference By Name</h2><p>To obtain a class reference by its string name (fully qualified), use <code>Class/forName</code> via Java interop:</p><pre><code class="clojure">(Class/forName "java.util.Date")  ; ⇒ java.util.Date
+</code></pre><h3 id="array-types-primitives">Array Types, Primitives</h3><p>JVM has what is called <strong>primitive types</strong> (numerics, chars, booleans) that are not "real" objects.
+In addition, array types have pretty obscure internal names. If you need to obtain a reference to
+an array of longs, for example, pass <code>"[[J"</code> to <code>Class/forName</code>. Below is the full table:</p><table class="table-striped table-bordered table"><thead><tr><th>Internal JVM class name</th><th>Array of ? (type)</th></tr></thead><tbody><tr><td><pre>"[[S"</pre></td><td>short</td></tr><tr><td><pre>"[[I"</pre></td><td>integer</td></tr><tr><td><pre>"[[J"</pre></td><td>long</td></tr><tr><td><pre>"[[F"</pre></td><td>float</td></tr><tr><td><pre>"[[D"</pre></td><td>double</td></tr><tr><td><pre>"[[B"</pre></td><td>byte</td></tr><tr><td><pre>"[[C"</pre></td><td>char</td></tr><tr><td><pre>"[[Z"</pre></td><td>boolean</td></tr></tbody></table><p>If this does not make much sense, don't worry. Just remember to come
+back to this guide when you need to extend a protocol for an array of
+primitives.</p><h2 id="implementing-java-interfaces-with-reify">Implementing Java Interfaces With reify</h2><p>It is possible to implement Java interfaces in Clojure. It is
+typically needed to interact with Java libraries that take arguments
+implementing a particular interface.</p><p>Interfaces are implemented using the <code>reify</code> special form.</p><p>Given the following Java interface:</p><pre><code class="java">public
+interface FilenameFilter {
+    /**
+     * Tests if a specified file should be included in a file list.
+     *
+     * @param   dir    the directory in which the file was found.
+     * @param   name   the name of the file.
+     * @return  &lt;code&gt;true&lt;/code&gt; if and only if the name should be
+     * included in the file list; &lt;code&gt;false&lt;/code&gt; otherwise.
+     */
+    boolean accept(File dir, String name);
+}
+</code></pre><p>here is how to implement it in Clojure:</p><pre><code class="clojure">;; a FileFilter implementation that accepts everything
+(reify java.io.FilenameFilter
+  (accept [this dir name]
+    true))
+</code></pre><p><code>reify</code> takes an interface (fully-qualified name or short name) and one or more
+method implementations that mimic function definitions without the <code>defn</code> and with
+<em>this</em> (as in Java, JavaScript or <em>self</em> in Ruby, Python) reference being the first argument:</p><pre><code class="clojure">(accept [this dir name]
+  true)
+</code></pre><p>With <code>reify</code>, generally there is no need to add type hints on arguments: Clojure
+compiler typically will detect the best matching method (by name and number of arguments).</p><p><code>reify</code> returns a <em>Java class instance</em>. Clojure compiler will generate a class that implements
+the interface and instantiate it. To demonstrate that reified objects indeed implement
+the interface:</p><pre><code class="clojure">(let [ff (reify java.io.FilenameFilter
+           (accept [this dir name]
+             true))]
+  (instance? java.io.FileFilter ff))  ; ⇒ true
+</code></pre><p><code>reify</code> can be used to implement multiple interfaces at once:</p><pre><code class="clojure">(let [ff (reify java.io.FilenameFilter
+           (accept [this dir name]
+             true)
+
+           java.io.FileFilter
+           (accept [this dir]
+             true))]
+  (instance? java.io.FileFilter ff))  ; ⇒ true
+</code></pre><h3 id="reify-parameter-destructuring-and-varargs">reify, Parameter Destructuring and Varargs</h3><p><code>reify</code> does not support destructuring or variadic number of arguments in method signatures.
+For example, the following will not work and won't even compile in Clojure 1.5:</p><pre><code class="clojure">(reify com.megacorp.api.AnInterface
+  (aMethod [a [b c]]
+    (comment ...))
+  (anotherMethod [a &amp; rest]
+    (comment ...)))
+</code></pre><h3 id="example-1">Example 1</h3><p>The following example demonstrates how instances created with <code>reify</code> are passed around
+as regular Java objects:</p><pre><code class="clojure">(import java.io.File)
+
+;; a file filter implementation that keeps only .clj files
+(let [ff (reify java.io.FilenameFilter
+           (accept [this dir name]
+             (.endsWith name ".clj")))
+    dir  (File. "/Users/antares/Development/ClojureWerkz/neocons.git/")]
+  (into [] (.listFiles dir ff)))
+;; ⇒ [#&lt;File /Users/antares/Development/ClojureWerkz/neocons.git/project.clj&gt;]
+</code></pre><p><code>reify</code> forms a closure: it will capture locals in its scope. This can be used to make implemented
+methods delegate to Clojure functions. The same example, rewritten with delegation:</p><pre><code class="clojure">user&gt; (import java.io.File)
+
+;; a file filter implementation that keeps only .clj files
+(let [f  (fn [^File dir ^String name]
+           (.endsWith name ".clj"))
+      ff (reify java.io.FilenameFilter
+           (accept [this dir name]
+             (f dir name)))
+    dir  (File. "/Users/antares/Development/ClojureWerkz/neocons.git/")]
+  (into [] (.listFiles dir ff)))
+;; ⇒ [#&lt;File /Users/antares/Development/ClojureWerkz/neocons.git/project.clj&gt;]
+</code></pre><p>Note that unlike in the "inline" implementation, Clojure compiler cannot infer types of
+<code>dir</code> and <code>name</code> parameters in the function that does the filtering, so we added type hints
+to avoid reflective calls. When methods are implemented "inline", types can be inferred from
+method signatures in the interface.</p><h2 id="extending-java-classes-with-proxy">Extending Java Classes With proxy</h2><p><code>proxy</code> is one of two ways to generate instances of anonymous classes in Clojure.
+<code>proxy</code> takes two vectors: one listing its superclass and (optional) interfaces, another constructor signatures, as well as
+method implementations. Method implementations are basically identical to <code>reify</code> except that the <code>this</code> argument is
+not necessary.</p><p>A very minimalistic example, we instantiate an anonymous class that extends <code>java.lang.Object</code>, implements no
+interfaces, has no explictly defined constructors and overrides <code>#toString</code>:</p><pre><code class="clojure">(proxy [Object] []
+        (toString []
+          "I am an instance of an anonymous class generated via proxy"))
+;; ⇒ #&lt;Object$0 I am an instance of an anonymous class generated via proxy&gt;
+</code></pre><p>Clojure compiler will generate an anonymous class for this <code>proxy</code> and at runtime, the cost of
+a <code>proxy</code> call is the cost of instantiating this class (the class is not generated anew on every single call).</p><p>A slightly more complex example where the generated class also implements <code>java.lang.Runnable</code> (runnable objects
+are commonly used with threads and <code>java.util.concurrent</code> classes) which defines one method, <code>#run</code>:</p><pre><code class="clojure">;; extends java.lang.Object, implements java.lang.Runnable
+(let [runnable (proxy [Object Runnable] []
+                       (toString []
+                         "I am an instance of an anonymous class generated via proxy")
+                       (run []
+                         (println "Run, proxy, run")))]
+        (.run runnable))  ; ⇒ nil
+;; outputs "Run, proxy, run"
+</code></pre><p><code>proxy</code> forms a closure: it will capture locals in its scope. This is very often used to create an instance
+that delegates to a Clojure function:</p><pre><code class="clojure">(let [f   (fn [] (println "Executed from a function"))
+      obj (proxy [Object Runnable] []
+            (run []
+              (f)))]
+        (.run obj))  ; ⇒ nil
+;; outputs "Executed from a function"
+</code></pre><p>TBD: more realistic examples | <a href="https://github.com/clojure-doc/clojure-doc.github.io#how-to-contribute">How to Contribute</a></p><h2 id="clojure-functions-implement-runnable-and-callable">Clojure Functions Implement Runnable and Callable</h2><p>Note that Clojure functions implement <code>java.lang.Runnable</code> and
+<code>java.util.concurrent.Callable</code> directly so you can pass functions to
+methods found in various classes from the <code>java.util.concurrent</code> package.</p><p>For example, to run a function in a new thread:</p><pre><code class="clojure">(let [t (Thread. (fn []
+                   (println "I am running in a separate thread")))]
+  (.start t))
+</code></pre><p>Or submit a function for execution to a thread pool (in JDK terms: an execution service):</p><pre><code class="clojure">(import '[java.util.concurrent Executors ExecutorService Callable])
+
+(let [^ExecutorService pool (Executors/newFixedThreadPool 16)
+      ^Callable  clbl       (cast Callable (fn []
+                                             (reduce + (range 0 10000))))
+      task                  (.submit pool clbl)]
+  (.get task))
+;; ⇒ 49995000
+</code></pre><p>Note that without the cast, Clojure compiler would not be able to determine
+which exact version of the method we intend to invoke, because <code>java.util.concurrent.ExecutionService/submit</code>
+has two versions, one for <code>Runnable</code> and one for <code>Callable</code>. They work very much the same but return
+slightly different results (<code>Callable</code> produces a value while <code>Runnable</code> always returns nil when
+executed).</p><p>The exception we would get without the cast is</p><pre><code>CompilerException java.lang.IllegalArgumentException: More than one matching method found: submit, compiling:(NO_SOURCE_PATH:2)
+</code></pre><h2 id="gen-class-and-how-to-implement-java-classes-in-clojure">gen-class and How to Implement Java Classes in Clojure</h2><h3 id="overview-1">Overview</h3><p><code>gen-class</code> is a Clojure feature for implementing Java classes in Clojure. It is relatively
+rarely used compared to <code>proxy</code> and <code>reify</code> but is needed to implement executable classes
+(that <code>java</code> runner and IDEs can as program entry points).</p><p>Unlike <code>proxy</code> and <code>reify</code>, <code>gen-class</code> defines named classes. They can be passed to Java
+APIs that expect class references. Classes defined with <code>gen-class</code> can extend
+base classes, implement any number of Java interfaces, define any number of constructors
+and define both instance and static methods.</p><h3 id="aot">AOT</h3><p><code>gen-class</code> requires <em>ahead-of-time</em> (AOT) compilation. It means that
+before using the classes defined with <code>gen-class</code>, the Clojure
+compiler needs to produce <code>.class</code> files from <code>gen-class</code> definitions.</p><h3 id="class-definition-with-clojurecoregen-class">Class Definition With clojure.core/gen-class</h3><p><code>clojure.core/gen-class</code> is a macro that uses a DSL for defining class
+methods, base class, implemented interfaces and so on.</p><p>It takes a number of options:</p><ul><li><code>:name</code> (a symbol): defines generated class name</li><li><code>:extends</code> (a symbol): name of the base class</li><li><code>:implements</code> (a collection): interfaces the class implements</li><li><code>:constructors</code> (a map): constructor signatures</li><li><code>:methods</code> (a collection): lists methods that will be implemented</li><li><code>:init</code> (symbol): defines a function that will be invoked with constructor arguments</li><li><code>:post-init</code> (symbol): defines a function that will be called with a constructed instance as its first argument</li><li><code>:state</code> (symbol): if supplied, a public final instance field with the given name will be created. Only makes sense when
+used with <code>:init</code>. State field value should be an atom or other ref type to allow state mutation.</li><li><code>:prefix</code> (string, default: <code>"-"</code>): methods will call functions named as <code>(str prefix method-name)</code>, e.g. <code>-getName</code> for <code>getName</code>.</li><li><code>:main</code> (boolean): if <code>true</code>, a public static main method will be generated for the class. It will delegate
+to a function named main with the prefix (<code>(str prefix "main")</code>), <code>-main</code> by default</li><li><code>:exposes</code>: TBD</li><li><code>:exposes-methods</code>: TBD</li><li><code>:factory</code>: TBD</li><li><code>:load-impl-ns</code>: TBD</li><li><code>:impl-ns</code>: TBD</li></ul><h4 id="the-name-option">The :name Option</h4><p>TBD</p><h4 id="the-extends-option">The :extends Option</h4><p>TBD</p><h4 id="the-implements-option">The :implements Option</h4><p>TBD</p><h4 id="the-constructors-option">The :constructors Option</h4><p>TBD</p><h4 id="the-methods-option">The :methods Option</h4><p>TBD</p><h4 id="the-init-option">The :init Option</h4><p>TBD</p><h4 id="the-post-init-option">The :post-init Option</h4><p>TBD</p><h4 id="the-state-option">The :state Option</h4><p>TBD</p><h4 id="the-prefix-option">The :prefix Option</h4><p>TBD</p><h4 id="the-main-option">The :main Option</h4><p>TBD</p><h4 id="the-exposes-option">The :exposes Option</h4><p>TBD</p><h4 id="the-exposes-methods-option">The :exposes-methods Option</h4><p>TBD</p><h4 id="the-factory-option">The :factory Option</h4><p>TBD</p><h4 id="the-load-impl-ns-option">The :load-impl-ns Option</h4><p>TBD</p><h4 id="the-impl-ns-option">The :impl-ns Option</h4><p>TBD</p><h3 id="gen-class-in-the-ns-macro">gen-class In The ns Macro</h3><p><code>gen-class</code> can be used with existing namespaces by adding <code>(:gen-class)</code> to the
+<code>ns</code> macro. Here is a "hello, world" example command line app that uses <code>gen-class</code>
+to generate a class that JVM launcher (<code>java</code>) can run:</p><pre><code class="clojure">(ns genclassy.core
+  (:gen-class))
+
+(defn -main
+  [&amp; args]
+  (println "Hello, World!"))
+</code></pre><p>This will use the name of the namespace for class name and use the namespace for method
+implementation (see the <code>:impl-ns</code> option above).</p><h3 id="examples">Examples</h3><p>A medium size example taken from an open source library:</p><pre><code class="clojure">(ns clojurewerkz.quartzite.listeners.amqp.PublishingSchedulerListener
+  (:gen-class :implements   [org.quartz.SchedulerListener]
+              :init         init
+              :state        state
+              :constructors {[com.rabbitmq.client.Channel String String] []})
+  (:require [langohr.basic     :as lhb]
+            [clojure.data.json :as json])
+  (:use [clojurewerkz.quartzite.conversion])
+  (:import [org.quartz SchedulerListener SchedulerException Trigger TriggerKey JobDetail JobKey]
+           [com.rabbitmq.client Channel]
+           [java.util Date]
+           [clojurewerkz.quartzite.listeners.amqp PublishingSchedulerListener]))
+
+
+
+(defn publish
+  [^PublishingSchedulerListener this payload ^String type]
+  (let [{ :keys [channel exchange routing-key] } @(.state this)
+        payload (json/json-str payload)]
+    (lhb/publish channel exchange routing-key payload :type type)))
+
+
+(defn -init
+  [^Channel ch ^String exchange ^String routing-key]
+  [[] (atom { :channel ch :exchange exchange :routing-key routing-key })])
+
+
+(defmacro payloadless-publisher
+  [method-name message-type]
+  `(defn ~method-name
+     [this#]
+     (publish this# (json/json-str {}) ~message-type)))
+
+(payloadless-publisher -schedulerStarted       "quartz.scheduler.started")
+(payloadless-publisher -schedulerInStandbyMode "quartz.scheduler.standby")
+(payloadless-publisher -schedulingDataCleared  "quartz.scheduler.cleared")
+(payloadless-publisher -schedulerShuttingDown  "quartz.scheduler.shutdown")
+
+
+(defn -schedulerError
+  [this ^String msg ^SchedulerException cause]
+  (publish this (json/json-str { :message msg :cause (str cause) }) "quartz.scheduler.error"))
+
+
+(defn -jobScheduled
+  [this ^Trigger trigger]
+  (publish this (json/json-str { :group (-&gt; trigger .getKey .getGroup) :key (-&gt; trigger .getKey .getName) :description (.getDescription trigger) }) "quartz.scheduler.job-scheduled"))
+
+(defn -jobUnscheduled
+  [this ^TriggerKey key]
+  (publish this (json/json-str { :group (.getGroup key) :key (.getName key) }) "quartz.scheduler.job-unscheduled"))
+
+(defn -triggerFinalized
+  [this ^Trigger trigger]
+  (publish this (json/json-str { :group (-&gt; trigger .getKey .getGroup) :key (-&gt; trigger .getKey .getName) :description (.getDescription trigger) }) "quartz.scheduler.trigger-finalized"))
+
+(defn -triggerPaused
+  [this ^TriggerKey key]
+  (publish this (json/json-str { :group (.getGroup key) :key (.getName key) }) "quartz.scheduler.trigger-paused"))
+
+(defn -triggersPaused
+  [this ^String trigger-group]
+  (publish this (json/json-str { :group trigger-group }) "quartz.scheduler.triggers-paused"))
+
+(defn -triggerResumed
+  [this ^TriggerKey key]
+  (publish this (json/json-str { :group (.getGroup key) :key (.getName key) }) "quartz.scheduler.trigger-resumed"))
+
+(defn -triggersResumed
+  [this ^String trigger-group]
+  (publish this (json/json-str { :group trigger-group }) "quartz.scheduler.triggers-resumed"))
+
+
+
+(defn -jobAdded
+  [this ^JobDetail detail]
+  (publish this (json/json-str { :job-detail (from-job-data (.getJobDataMap detail)) :description (.getDescription detail) }) "quartz.scheduler.job-added"))
+
+(defn -jobDeleted
+  [this ^JobKey key]
+  (publish this (json/json-str { :group (.getGroup key) :key (.getName key) }) "quartz.scheduler.job-deleted"))
+
+(defn -jobPaused
+  [this ^JobKey key]
+  (publish this (json/json-str { :group (.getGroup key) :key (.getName key) }) "quartz.scheduler.job-paused"))
+
+(defn -jobsPaused
+  [this ^String job-group]
+  (publish this (json/json-str { :group job-group }) "quartz.scheduler.jobs-paused"))
+
+(defn -jobResumed
+  [this ^JobKey key]
+  (publish this (json/json-str { :group (.getGroup key) :key (.getName key) }) "quartz.scheduler.job-resumed"))
+
+(defn -jobsResumed
+  [this ^String job-group]
+  (publish this (json/json-str { :group job-group }) "quartz.scheduler.jobs-resumed"))
+</code></pre><h3 id="inspecting-class-signatures">Inspecting Class Signatures</h3><p>When using <code>gen-class</code> for interoperability purposes, sometimes it is necessary to inspect the API
+of the class generated by <code>gen-class</code>.</p><p>It can be inspected
+using <a href="http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javap.html">javap</a>. Given the
+following Clojure namespace:</p><pre><code class="clojure">(ns genclassy.core
+  (:gen-class))
+
+(defn -main
+  [&amp; args]
+  (println "Hello, World!"))
+</code></pre><p>We can inspect the produced class like so:</p><pre><code># from target/classes, default .class files location used by Leiningen
+javap genclassy.core
+</code></pre><p>will output</p><pre><code class="java">public class genclassy.core {
+  public static {};
+  public genclassy.core();
+  public java.lang.Object clone();
+  public int hashCode();
+  public java.lang.String toString();
+  public boolean equals(java.lang.Object);
+  public static void main(java.lang.String[]);
+}
+</code></pre><h2 id="how-to-extend-protocols-to-java-classes">How To Extend Protocols to Java Classes</h2><p>Clojure protocols can be extended to any java class (including
+Clojure's internal types) very easily using <code>extend</code>:</p><p>Using the example of a json library, we can define our goal as getting
+to the point where the following works:</p><pre><code class="clojure">(json-encode (java.util.UUID/randomUUID))
+</code></pre><p>First, let's start with the protocol for json encoding an object:</p><pre><code class="clojure">(defprotocol JSONable
+  (json-encode [obj]))
+</code></pre><p>So, everything that is "JSONable" implements a <code>json-encode</code> method.</p><p>Next, let's define a dummy method to do the "encoding" (in this
+example, it just prints to standard out instead, it doesn't actually
+do any json encoding):</p><pre><code class="clojure">(defn encode-fn
+  [x]
+  (prn x))
+</code></pre><p>Now, define a method that will encode java objects by calling <code>bean</code>
+on them, then making each value of the bean map a string:</p><pre><code class="clojure">(defn encode-java-thing
+  [obj]
+  (encode-fn
+   (into {}
+         (map (fn [m]
+                [(key m) (str (val m))])
+              (bean obj)))))
+</code></pre><p>Let's try it on an example object, a UUID:</p><pre><code class="clojure">(encode-java-thing (java.util.UUID/randomUUID))
+;; ⇒ {:mostSignificantBits "-6060053801408705927",
+;;    :leastSignificantBits "-7978739947533933755",
+;;    :class "class java.util.UUID"}
+</code></pre><p>The next step is to extend the protocol to the java type, telling
+clojure which java type to extend, the protocol to implement and the
+method to use for the <code>json-encode</code> method:</p><pre><code class="clojure">(extend java.util.UUID
+  JSONable
+  {:json-encode encode-java-thing})
+</code></pre><p>Alternatively, you could use the <code>extend-type</code> macro, which actually
+expands into calls to <code>extend</code>:</p><pre><code class="clojure">(extend-type java.util.UUID
+  JSONable
+  (json-encode [obj] (encode-java-thing obj)))
+</code></pre><p>Now we can use <code>json-encode</code> for the object we've extended:</p><pre><code class="clojure">(json-encode (java.util.UUID/randomUUID))
+;; ⇒  {:mostSignificantBits "3097485598740136901",
+;;     :leastSignificantBits "-9000234678473924364",
+;;     :class "class java.util.UUID"}
+</code></pre><p>You could also write the function inline in the extend block, for
+example, extending <code>nil</code> to return a warning string:</p><pre><code class="clojure">(extend nil
+  JSONable
+  {:json-encode (fn [x] "x is nil!")})
+
+(json-encode nil)
+;; ⇒  "x is nil!"
+</code></pre><p>The <code>encode-java-thing</code> method can also be reused for other Java types
+we may want to encode:</p><pre><code class="clojure">(extend java.net.URL
+  JSONable
+  {:json-encode encode-java-thing})
+
+(json-encode (java.net.URL. "http://aoeu.com"))
+;; ⇒  {:path "",
+;;     :protocol "http",
+;;     :authority "aoeu.com",
+;;     :host "aoeu.com",
+;;     :ref "",
+;;     :content "sun.net.www.protocol.http.HttpURLConnection$HttpInputStream@4ecac02f",
+;;     :class "class java.net.URL",
+;;     :defaultPort "80",
+;;     :port "-1",
+;;     :query "",
+;;     :file "",
+;;     :userInfo ""}
+</code></pre><h2 id="using-intrinsic-locks-synchronized-in-clojure">Using Intrinsic Locks ("synchronized") in Clojure</h2><p>Every object on the JVM has an <em>intrinsic lock</em> (also referred to as <em>monitor lock</em>
+or simply <em>monitor</em>). While very rarely necessary, Clojure provides support for
+operations that acquire intrinsic lock of a mutable Java object.</p><p>This is covered in the <a href="../concurrency_and_parallelism/index.html#using_intrinsic_locks_synchronized_in_clojure">Concurrency and Parallelism guide</a>.</p><h2 id="wrapping-up">Wrapping Up</h2><p>TBD: <a href="https://github.com/clojure-doc/clojure-doc.github.io#how-to-contribute">How to Contribute</a></p><h2 id="contributors">Contributors</h2><p>Michael Klishin <a href="mailto:michael@defprotocol.org">michael@defprotocol.org</a> (original author)
+Lee Hinman <a href="mailto:lee@writequit.org">lee@writequit.org</a>
+gsnewmark <a href="mailto:gsnewmark@meta.ua">gsnewmark@meta.ua</a></p>
+
+    <div id="prev-next">
+        
+        <a href="../laziness/index.html">&laquo; Laziness in Clojure</a>
+        
+        
+        ||
+        
+        
+        <a href="../macros/index.html">Clojure Macros and Metaprogramming &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/language/laziness/index.html b/clones/clojure-doc.org/articles/language/laziness/index.html
new file mode 100644
index 00000000..b0c068da
--- /dev/null
+++ b/clones/clojure-doc.org/articles/language/laziness/index.html
@@ -0,0 +1,264 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Laziness in Clojure</title>
+    
+
+<meta name="description" content="This guide covers:">
+
+<meta property="og:description" content="This guide covers:">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/language/laziness/" />
+<meta property="og:title" content="Laziness in Clojure" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/language/laziness/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Laziness in Clojure</h2>
+    </div>
+    
+    <p>This guide covers:</p><ul><li>What are lazy sequences</li><li>Pitfalls with lazy sequences</li><li>How to create functions that produce lazy sequences</li><li>How to force evaluation</li></ul><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons
+Attribution 3.0 Unported License</a> (including images &amp;
+stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on
+Github</a>.</p><h2 id="what-version-of-clojure-does-this-guide-cover">What Version of Clojure Does This Guide Cover?</h2><p>This guide covers Clojure 1.5.</p><h2 id="overview">Overview</h2><p>Clojure is not a <a href="http://en.wikipedia.org/wiki/Lazy_evaluation">lazy language</a>.</p><p>However, Clojure supports <em>lazily evaluated sequences</em>. This means that sequence elements are not
+available ahead of time and produced as the result of a computation. The computation
+is performed as needed. Evaluation of lazy sequences is known as <em>realization</em>.</p><p>Lazy sequences can be infinite (e.g. the sequence of Fibonacci numbers, a sequence of
+dates with a particular interval between them, and so on). If a lazy sequence is finite,
+when its computation is completed, it becomes <em>fully realized</em>.</p><p>When it is necessary to fully realize a lazy sequence, Clojure provides a way to
+<em>force evaluation</em> (force realization).</p><h2 id="benefits-of-lazy-sequences">Benefits of Lazy Sequences</h2><p>Lazy sequences have two main benefits:</p><ul><li>They can be infinite</li><li>Full realization of interim results can be avoided</li></ul><h2 id="producing-lazy-sequences">Producing Lazy Sequences</h2><p>Lazy sequences are produced by functions. Such functions either use the <code>clojure.core/lazy-seq</code> macro
+or other functions that produce lazy sequences.</p><p><code>clojure.core/lazy-seq</code> accepts one or more forms that produce a sequence of <code>nil</code> (when the sequence
+is fully realized) and returns a seqable data structure that invokes the body the first time
+the value is needed and then caches the result.</p><p>For example, the following function produces a lazy sequence of random UUIDs strings:</p><pre><code class="klipse-clojure nohighlight">(defn uuid-seq
+  []
+  (lazy-seq
+   (cons (str (random-uuid))
+         (uuid-seq))))
+</code></pre><blockquote><p>Note: the <code>random-uuid</code> function is available in ClojureScript and was introduced into Clojure
+in version 1.11 Alpha 3. Prior to that, you needed to use Java interop:</p></blockquote><pre><code class="clojure">(defn uuid-seq
+  []
+  (lazy-seq
+   (cons (str (java.util.UUID/randomUUID))
+         (uuid-seq))))
+</code></pre><p>Another example:</p><pre><code class="klipse-clojure nohighlight">(defn fib-seq
+  "Returns a lazy sequence of Fibonacci numbers"
+  ([]
+     (fib-seq 0 1))
+  ([a b]
+     (lazy-seq
+      (cons b (fib-seq b (+ a b))))))
+</code></pre><p>Both examples use <code>clojure.core/cons</code> which prepends an element to a sequence. The sequence
+can in turn be lazy, which both of the examples rely on.</p><p>Even though both of these sequences are infinite, taking first N elements from each does
+return successfully:</p><pre><code class="klipse-clojure nohighlight">(take 3 (uuid-seq))
+</code></pre><pre><code class="klipse-clojure nohighlight">(take 10 (fib-seq))
+</code></pre><pre><code class="klipse-clojure nohighlight">(take 20 (fib-seq))
+</code></pre><h2 id="realizing-lazy-sequences-forcing-evaluation">Realizing Lazy Sequences (Forcing Evaluation)</h2><p>Lazy sequences can be forcefully realized with <code>clojure.core/dorun</code> and
+<code>clojure.core/doall</code>. The difference between the two is that <code>dorun</code>
+throws away all results and is supposed to be used for side effects,
+while <code>doall</code> returns computed values:</p><pre><code class="klipse-clojure nohighlight">(dorun (map inc [1 2 3 4]))
+</code></pre><pre><code class="klipse-clojure nohighlight">(doall (map inc [1 2 3 4]))
+</code></pre><h2 id="commonly-used-functions-that-produce-lazy-sequences">Commonly Used Functions That Produce Lazy Sequences</h2><p>Multiple frequently used <code>clojure.core</code> functions return lazy sequences,
+most notably:</p><ul><li><code>map</code></li><li><code>filter</code></li><li><code>remove</code></li><li><code>range</code></li><li><code>take</code></li><li><code>take-while</code></li><li><code>drop</code></li><li><code>drop-while</code></li></ul><p>The following example uses several of these functions to return 10 first
+even numbers in the range of [0, n):</p><pre><code class="klipse-clojure nohighlight">(take 10 (filter even? (range 0 100)))
+</code></pre><p>Several functions in <code>clojure.core</code> are designed to produce lazy
+sequences:</p><ul><li><code>repeat</code></li><li><code>iterate</code></li><li><code>cycle</code></li></ul><p>For example:</p><pre><code class="klipse-clojure nohighlight">(take 3 (repeat "ha"))
+</code></pre><pre><code class="klipse-clojure nohighlight">(take 5 (repeat "ha"))
+</code></pre><pre><code class="klipse-clojure nohighlight">(take 3 (cycle [1 2 3 4 5]))
+</code></pre><pre><code class="klipse-clojure nohighlight">(take 10 (cycle [1 2 3 4 5]))
+</code></pre><pre><code class="klipse-clojure nohighlight">(take 3 (iterate (partial + 1) 1))
+</code></pre><pre><code class="klipse-clojure nohighlight">(take 5 (iterate (partial + 1) 1))
+</code></pre><h2 id="lazy-sequences-chunking">Lazy Sequences Chunking</h2><p>There are two fundamental strategies for implementing lazy sequences:</p><ul><li>Realize elements one-by-one</li><li>Realize elements in groups (chunks, batches)</li></ul><p>In Clojure 1.1+, lazy sequences are <em>chunked</em> (realized in chunks).</p><p>For example, in the following code</p><pre><code class="klipse-clojure nohighlight">(take 10 (range 1 1000000000000))
+</code></pre><p>one-by-one realization would realize one element 10 times. With chunked sequences,
+elements are realized ahead of time in chunks (32 elements at a time).</p><p>This reduces the number of realizations and, for many common workloads, improves
+efficiency of lazy sequences.</p><h2 id="contributors">Contributors</h2><p>Michael Klishin <a href="mailto:michael@defprotocol.org">michael@defprotocol.org</a>, 2013 (original author)</p>
+
+    <div id="prev-next">
+        
+        <a href="../functions/index.html">&laquo; Functions in Clojure</a>
+        
+        
+        ||
+        
+        
+        <a href="../interop/index.html">Clojure interoperability with Java &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+ <link rel="stylesheet" type="text/css" href="https://storage.googleapis.com/app.klipse.tech/css/codemirror.css">
+<script>
+window.klipse_settings = {
+  "selector" : ".klipse-clojure"
+};
+</script>
+<script src="https://storage.googleapis.com/app.klipse.tech/plugin/js/klipse_plugin.js"></script> 
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/language/macros/index.html b/clones/clojure-doc.org/articles/language/macros/index.html
new file mode 100644
index 00000000..d3c7d8c4
--- /dev/null
+++ b/clones/clojure-doc.org/articles/language/macros/index.html
@@ -0,0 +1,382 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Clojure Macros and Metaprogramming</title>
+    
+
+<meta name="description" content="This guide covers:">
+
+<meta property="og:description" content="This guide covers:">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/language/macros/" />
+<meta property="og:title" content="Clojure Macros and Metaprogramming" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/language/macros/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Clojure Macros and Metaprogramming</h2>
+    </div>
+    
+    <p>This guide covers:</p><ul><li>Clojure macros</li><li>the Clojure compilation process</li></ul><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons
+Attribution 3.0 Unported License</a> (including images &amp;
+stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on
+Github</a>.</p><h2 id="what-version-of-clojure-does-this-guide-cover">What Version of Clojure Does This Guide Cover?</h2><p>This guide covers Clojure 1.5.</p><h2 id="before-you-read-this-guide">Before You Read This Guide</h2><p>This is one of the most hardcore guides of the entire Clojure documentation
+project. It describes concepts that are relatively unique to the Lisp family of languages
+that Clojure belongs to. Understanding them may take some time for folks without
+a metaprogramming background. Don't let this learning curve
+discourage you.</p><p>If some parts are not clear, please ask for clarification <a href="https://groups.google.com/forum/?fromgroups#!forum/clojure">on the
+mailing
+list</a> or
+<a href="https://github.com/clojure-doc/clojure-doc.github.io/issues">file an issue</a> on GitHub.
+We will work hard on making this guide easy to follow with edits and
+images to illustrate the concepts.</p><h2 id="overview">Overview</h2><p>Clojure is a dialect of Lisp and while it departs with some features of "traditional" Lisps,
+the fundamentals are there. One very powerful feature that comes with it is <em>macros</em>,
+a way to do metaprogramming using the language itself. This is pretty different from
+other languages known for good metaprogramming capabilities (e.g. Ruby) in that
+in Clojure, metaprogramming does not mean string generation. Instead, it means
+constructing a tree [of S-expressions, or lists]. This enables very powerful
+DSLs (domain-specific languages).</p><h2 id="compile-time-and-run-time">Compile Time and Run Time</h2><p>Clojure is a compiled language. The compiler reads source files or strings,
+produces data structures (aka the AST) and performs <em>macroexpansion</em>. Macros are evaluated at
+<em>compile time</em> and produce modified data structures that are compiled to the JVM
+bytecode. That bytecode is executed at <em>run time</em>.</p><p>Clojure code is compiled when it is loaded with <code>clojure.core/load</code> or <code>clojure.core/require</code>
+or can be ahead of time (AOT compilation) using tools such as <a href="http://leiningen.org">Leiningen</a>
+or the <a href="../../ecosystem/maven/index.html">Clojure Maven plugin</a>.</p><h2 id="clojure-reader">Clojure Reader</h2><p>Reader is another name for parser. Unlike many other languages, reader in Clojure
+can be extended in the language itself. It is also exposed to the language
+with <code>clojure.core/read</code> and <code>clojure.core/read-string</code> functions that
+return data structures:</p><pre style="visibility:hidden; height:0;"><code class="klipse-clojure nohighlight">
+(require '[cljs.reader :refer [read-string]])
+</code></pre><pre><code class="klipse-clojure nohighlight">(read-string "(if true :truth :false)")
+;= (if true :truth :false)
+</code></pre><p>Here we got back a list that is not evaluated.</p><p>The Reader produces data structures (in part that's why "code is data" in homoiconic
+languages) that are then evaluated:</p><ul><li>Literals (e.g., strings, integers, vectors) evaluate to themselves</li><li>Lists evaluate to invocations (calls) of functions and so on</li><li>Symbols are resolved to a var value</li></ul><p>Expressions that can be evaluated (invoked) are known as <em>forms</em>. Forms consist of:</p><ul><li>Functions</li><li>Macros</li><li>Special forms</li></ul><h3 id="special-forms">Special Forms</h3><p>The reader parses some forms in special ways that are not consistent
+with the rest of Clojure's syntax.</p><p>Such forms are called <em>special forms</em>. They consist of</p><ul><li>. (the dot special form)</li><li>new</li><li>set!</li><li>def</li><li>var</li><li>fn* (<code>fn</code> without destructuring)</li><li>if</li><li>case* (internal implementation of <code>case</code>)</li><li>do</li><li>let* (<code>let</code> without destructuring)</li><li>letfn* (<code>letfn</code> without destructuring)</li><li>clojure.core/import* (<code>import</code>)</li><li>quote</li><li>loop* (<code>loop</code> without destructuring)</li><li>recur</li><li>throw, try, catch, finally</li><li>deftype* (internals of <code>deftype</code>)</li><li>reify* (internals of <code>reify</code>)</li><li>monitor-enter, monitor-exit</li></ul><p>Some special forms are used directly in user code (like <code>do</code> and <code>if</code>), while others
+are only used to build more user friendly interfaces (like using <code>deftype</code> over the special form <code>deftype*</code>).</p><h2 id="first-taste-of-macros">First Taste of Macros</h2><p>Some programming languages include an <code>unless</code> expression (or statement) that is
+the opposite of <code>if</code>. Clojure is not one of them but it can be added by using
+a macro:</p><pre style="visibility:hidden; height:0;"><code class="klipse-clojure nohighlight">
+(require '[chivorcam.core :refer [defmacro defmacfn]])
+</code></pre><pre><code class="klipse-clojure nohighlight">(defmacro unless
+  "Similar to if but negates the condition"
+  [condition &amp; forms]
+  `(if (not ~condition)
+     ~@forms))
+</code></pre><p>Macros are defined using the <code>clojure.core/defmacro</code> function that takes
+macro name as a symbol, an optional documentation string, a vector
+of arguments and the macro body.</p><p>This macro can be used like similarly to the <code>if</code> form:</p><pre><code class="klipse-clojure nohighlight">(unless (= 1 2)
+  "one does not equal two"
+  "one equals two. How come?")
+</code></pre><p>Just like the <code>if</code> special form, this macro produces an expression that
+returns a value:</p><pre><code class="clojure">(unless (= 1 2)
+  "one does not equal two"
+  "one equals two. How come?")
+</code></pre><p>in fact, this is because the macro piggybacks on the <code>if</code> form.
+To see what the macro expands to, we can use <code>clojure.core/macroexpand-1</code>:</p><pre><code class="klipse-clojure nohighlight">(macroexpand-1 '(unless (= 1 2) true false))
+;= (if (clojure.core/not (= 1 2)) true false)
+</code></pre><p>This simplistic macro and the way we expanded it with <code>macroexpand-1</code>
+demonstrates three features of the Clojure reader that are used when
+writing macros:</p><ul><li>Quote (')</li><li>Syntax quote (`)</li><li>Unquote (~)</li><li>Unquote splicing (~@)</li></ul><h2 id="quote">Quote</h2><p>Quote supresses evaluation of the form that follows it. In other words,
+instead of being treated as an invocation, it will be treated as a list.</p><p>Compare:</p><pre><code class="klipse-clojure nohighlight">;; this form is evaluated by calling the clojure.core/+ function
+(+ 1 2 3)
+;= 6
+</code></pre><pre><code class="klipse-clojure nohighlight">;; quote supresses evaluation so the + is treated as a regular
+;; list element
+'(+ 1 2 3)
+;= (+ 1 2 3)
+</code></pre><p>The syntax quote supresses evaluation of the form that follows it and
+all nested forms. It is similar to templating languages where parts
+of the template are "fixed" and parts are "inserted" (evaluated).
+The syntax quote makes the form that follows it "a template".</p><h2 id="unquote">Unquote</h2><p>Unquote then is how parts of the template are forced to be evaluated
+(act similarly to variables in templates in templating languages).</p><p>Let's take another look at the same <code>unless</code> macro:</p><pre><code class="klipse-clojure nohighlight">(defmacro unless
+  [condition &amp; forms]
+  `(if (not ~condition)
+     ~@forms))
+</code></pre><p>and how we invoke it:</p><pre><code class="klipse-clojure nohighlight">(unless (= 1 2)
+  "one does not equal two"
+  "one equals two. How come?")
+</code></pre><p>When the macro is expanded, the condition local in this example has the value
+of <code>(= 1 2)</code> (a list). We want <code>unless</code> to perform boolean evaluation on it,
+and that's what unquote (<code>~</code>) does as can be seen from macroexpansion:</p><pre><code class="klipse-clojure nohighlight">(macroexpand-1 '(unless (= 1 2) true false))
+;= (if (clojure.core/not (= 1 2)) true false)
+</code></pre><p>Compare this with what the macro expands to when the unquote is removed:</p><pre><code class="klipse-clojure nohighlight">;; incorrect, missing unquote!
+(defmacro unless
+  [condition &amp; forms]
+  `(if (not condition)
+     ~@forms))
+
+(macroexpand-1 '(unless (= 1 2) true false))
+;= (if (clojure.core/not user/condition) true false)
+</code></pre><h3 id="implementation-details">Implementation Details</h3><p>The unquote operator is replaced by the reader with a call to a core
+Clojure function, <code>clojure.core/unquote</code>.</p><h2 id="unquote-splicing">Unquote-splicing</h2><p>Some macros take multiple forms. This is common in DSLs, for example.
+Each of those forms is often need to be quoted and concatenated.</p><p>The unquote-splicing operator (<code>~@</code>) is a convenient way to do it:</p><pre><code class="klipse-clojure nohighlight">(defmacro unsplice
+        [&amp; coll]
+        `(do ~@coll))
+</code></pre><pre><code class="klipse-clojure nohighlight">(macroexpand-1 '(unsplice (def a 1) (def b 2)))
+;= (do (def a 1) (def b 2))
+</code></pre><pre><code class="klipse-clojure nohighlight">(unsplice (def a 1) (def b 2))
+;= #'user/b
+</code></pre><pre><code class="klipse-clojure nohighlight">a
+;= 1
+</code></pre><pre><code class="klipse-clojure nohighlight">b
+;= 2
+</code></pre><h3 id="implementation-details-1">Implementation Details</h3><p>The unquote-splicing operator is replaced by the reader with a call to a core
+Clojure function, <code>clojure.core/unquote-splicing</code>.</p><h2 id="macro-hygiene-and-gensym">Macro Hygiene and gensym</h2><p>When writing a macro, there is a possibility that the macro will interact with
+vars or locals outside of it in unexpected ways, for example, by <a href="http://en.wikipedia.org/wiki/Variable_shadowing">shadowing</a> them.
+Such macros are known as <em>unhygienic macros</em>.</p><p>Clojure does not implement a full solution to hygienic macros but
+provides solutions to the biggest pitfalls of unhygienic macros by enforcing several restrictions:</p><ul><li>Symbols within a syntax quoted form are namespace-qualified</li><li>Unique symbol name generation (aka <em>gensyms</em>)</li></ul><h3 id="namespace-qualification-within-syntax-quote">Namespace Qualification Within Syntax Quote</h3><p>To demonstrate this behavior of syntax quote, consider the following example
+that replaces values "yes" and "no" with true and false, respectively, at compile
+time:</p><pre><code class="klipse-clojure nohighlight">(defmacro yes-no-&gt;boolean
+  [val]
+  `(let [b (= ~val "yes")]
+    b))
+;= #'user/yes-no-&gt;boolean
+</code></pre><pre><code class="klipse-clojure nohighlight">(macroexpand-1 '(yes-no-&gt;boolean "yes"))
+;= (clojure.core/let [user/b (clojure.core/= "yes" "yes")] user/b)
+</code></pre><p>Macroexpansion demonstrates that the Clojure compiler makes the <code>b</code> symbol namespace-qualified
+(<code>user</code> is the default namespace in the Clojure REPL). This helps avoid var and local
+shadowing.</p><p>Note: Special forms are not necessarily qualified. See section 'Special Forms in Detail'.</p><h3 id="generated-symbols-gensyms">Generated Symbols (gensyms)</h3><p>Automatic namespace generation is fine in some cases, but not every time. Sometimes
+a symbol name that is unique in the macro scope is necessary.</p><p>Unique symbols names can be generated with the <code>clojure.core/gensym</code> function that
+take an optional base string:</p><pre><code class="klipse-clojure nohighlight">(gensym)
+;= G__54
+</code></pre><pre><code class="klipse-clojure nohighlight">(gensym "base")
+;= base57
+</code></pre><p>There is a shortcut: if a symbol ends in <code>#</code> within a syntax quote form, it will be
+expanded by the compiler into a gensym (aka. an auto-gensym):</p><pre><code class="clojure">(defmacro yes-no-&gt;boolean
+  [val]
+  `(let [b# (= ~val "yes")]
+     b#))
+;= #'user/yes-no-&gt;boolean
+</code></pre><pre><code class="klipse-clojure nohighlight">(macroexpand-1 '(yes-no-&gt;boolean "yes"))
+;= (clojure.core/let [b__148__auto__ (clojure.core/= "yes" "yes")] b__148__auto__)
+</code></pre><p>The name that replaced <code>b#</code> was generated by the compiler to make unwanted variable
+capture very unlikely in practice, and impossible if all bindings are named with auto-gensym.</p><p>Theoretically, Clojure's approach to generating uncaptured gensyms (incrementing a global counter) can be circumvented
+via a mischievous macro or very bad luck.</p><p>Tip:
+Avoid code with <code>__</code> in local binding names. This ensures
+auto-gensyms are <em>never</em> captured in unwanted ways.</p><h2 id="macroexpansions">Macroexpansions</h2><p>During macro development, it is important to be able to test the macro
+and see what data structures the macro expands to. This can be done
+with two functions in the core Clojure library:</p><ul><li><code>clojure.core/macroexpand-1</code></li><li><code>clojure.core/macroexpand</code></li><li><code>clojure.walk/macroexpand-all</code></li></ul><p>The difference between the two is that <code>macroexpand-1</code> will expand the macro
+only once. If the result contains calls to other macros, those won't be expanded.
+<code>macroexpand</code>, however, will continue expanding all macros until the top level form
+is no longer a macro.</p><p>Both macroexpansion functions take quoted forms.</p><p>Macro expansion functions can be used to find out that <code>when</code> is a macro implemented on top of
+the <code>if</code> special form, for example:</p><pre><code class="klipse-clojure nohighlight">(macroexpand '(when true 1 42))
+</code></pre><h3 id="full-macroexpansion">Full Macroexpansion</h3><p>Neither <code>macroexpand-1</code> nor <code>macroexpand</code> expand nested
+forms. To fully expand macros including those in nested forms, there is <code>clojure.walk/macroexpand-all</code>,
+which, however, is not part of Clojure core and does not behave exactly the same way
+the compiler does.</p><h2 id="difference-between-quote-and-syntax-quote">Difference Between Quote and Syntax Quote</h2><p>The key difference between quote and syntax quote is that
+symbols within a syntax quoted form are automatically namespace-qualified.</p><h2 id="security-considerations">Security Considerations</h2><p><code>clojure.core/read-string</code> <em>can execute arbitrary code</em> and <em>must not</em> be used
+on inputs coming from untrusted sources. This behavior is controlled by the <code>clojure.core/*read-eval*</code>
+var. Starting with Clojure 1.5, the default value of <code>*read-eval*</code> is <code>false</code>.</p><p><code>*read-eval*</code> can be disabled via a property when starting the JVM:</p><pre><code>-Dclojure.read.eval=false
+</code></pre><p>When reading Clojure forms from untrusted sources, use <code>clojure.edn/read-string</code>, which is
+does not perform arbitrary code execution and is safer. <code>clojure.edn/read-string</code> implements
+the <a href="https://github.com/edn-format/edn">EDN format</a>, a subset of Clojure syntax for data
+structures. <code>clojure.edn</code> was introduced in Clojure 1.5.</p><h2 id="special-forms-in-detail">Special Forms in Detail</h2><p>Special forms are restrictive in their use and do not interact cleanly with several area of Clojure.</p><ul><li><p>Special forms must be a list with a special name as the first element.</p><p>A special name in a higher-order context is not a special form.</p><pre><code class="klipse-clojure nohighlight">do
+;; CompilerException java.lang.RuntimeException: Unable to resolve symbol: do in this context, compiling:(NO_SOURCE_PATH:0:0)
+</code></pre><p>Macros have a similar restriction, but notice: the macro's var is identified in the error while
+special names have no meaning at all outside the first element of a list.</p><pre><code class="klipse-clojure nohighlight">dosync
+;; CompilerException java.lang.RuntimeException: Can't take value of a macro: #'clojure.core/dosync, compiling:(NO_SOURCE_PATH:0:0)
+</code></pre></li><li><p>Special form names are not namespace-qualified.</p><p>Most special forms (all except <code>clojure.core/import*</code>) are not namespace
+qualified. The reader must circumvent syntax quote's policy of namespace-qualifying
+all symbols.</p><pre><code class="klipse-clojure nohighlight">`a
+;; user/a
+</code></pre><pre><code class="klipse-clojure nohighlight">`do
+;; do
+</code></pre><pre><code class="clojure">user=&gt; `if
+if
+user=&gt; `import*
+user/import*
+</code></pre></li><li><p>Special forms conflict with local scope.</p><p>Never use special names as local binding or global variable names.</p><pre><code class="clojure">(let [do 1] do)
+;;; nil
+</code></pre><p>Ouch!</p><p>This includes destructuring:</p><pre><code class="clojure">user=&gt; (let [{:keys [do]} {:do 1}] do)
+nil
+</code></pre><p>Note: Be wary of maps with keyword keys with special names, they are more
+likely to be destructured this way.</p></li></ul><p>Keep these special cases in mind as you work through the tutorial.</p><h2 id="contributors">Contributors</h2><ul><li>Michael Klishin <a href="mailto:michael@defprotocol.org">michael@defprotocol.org</a>, 2013 (original author)</li><li>Ambrose Bonnaire-Sergeant <a href="mailto:abonnairesergeant@gmail.com">abonnairesergeant@gmail.com</a>, 2013</li></ul>
+
+    <div id="prev-next">
+        
+        <a href="../interop/index.html">&laquo; Clojure interoperability with Java</a>
+        
+        
+        ||
+        
+        
+        <a href="../polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+ <link rel="stylesheet" type="text/css" href="https://storage.googleapis.com/app.klipse.tech/css/codemirror.css">
+<script>
+window.klipse_settings = {
+  "selector" : ".klipse-clojure"
+};
+</script>
+<script src="https://storage.googleapis.com/app.klipse.tech/plugin/js/klipse_plugin.js"></script> 
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/language/namespaces/index.html b/clones/clojure-doc.org/articles/language/namespaces/index.html
new file mode 100644
index 00000000..f28a4588
--- /dev/null
+++ b/clones/clojure-doc.org/articles/language/namespaces/index.html
@@ -0,0 +1,375 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Clojure Namespaces and Vars</title>
+    
+
+<meta name="description" content="This guide covers:">
+
+<meta property="og:description" content="This guide covers:">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/language/namespaces/" />
+<meta property="og:title" content="Clojure Namespaces and Vars" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/language/namespaces/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Clojure Namespaces and Vars</h2>
+    </div>
+    
+    <p>This guide covers:</p><ul><li>An overview of Clojure namespaces and vars</li><li>How to define namespaces</li><li>How to use functions in other namespaces</li><li><code>require</code>, <code>refer</code> and <code>use</code></li><li>Common compilation errors and typical problems that cause them</li><li>Namespaces and their relation to code compilation in Clojure</li></ul><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons Attribution 3.0 Unported License</a>
+(including images &amp; stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on Github</a>.</p><h2 id="what-version-of-clojure-does-this-guide-cover">What Version of Clojure Does This Guide Cover?</h2><p>This guide covers Clojure 1.5.</p><h2 id="overview">Overview</h2><p>Clojure functions are organized into <em>namespaces</em>. Clojure namespaces
+are very similar to Java packages and Python modules. Namespaces are
+basically maps (dictionaries) that map names to <em>vars</em>. In many cases,
+those vars store functions in them.</p><h2 id="defining-a-namespace">Defining a Namespace</h2><p>Namespaces are usually defined using the <code>clojure.core/ns</code> macro. In its basic
+form, it takes a name as a symbol:</p><pre><code class="clojure">(ns superlib.core)
+</code></pre><p>Namespaces can have multiple segments, separated by a dot:</p><pre><code class="clojure">(ns megacorp.service.core)
+</code></pre><p>It is <strong>highly recommended</strong> to avoid using single segment namespaces
+(e.g. <code>superlib</code>) to avoid inconvenient conflicts other developers
+will have to work around. If a library or application belongs to an
+organization or a group of projects, the
+<code>[organization].[library|app].[group-of-functions]</code> pattern is
+recommended. For example:</p><pre><code class="clojure">(ns clojurewerkz.welle.kv)
+
+(ns megacorp.search.indexer.core)
+</code></pre><p>In addition, the <code>ns</code> macro takes a number of optional forms:</p><ul><li><code>(:require ...)</code></li><li><code>(:import ...)</code></li><li><code>(:use ...)</code></li><li><code>(:refer-clojure ...)</code></li><li><code>(:gen-class ...)</code></li></ul><p>These are just slightly more concise variants of <code>clojure.core/import</code>, <code>clojure.core/require</code>, et cetera.</p><h3 id="the-require-helper-form">The :require Helper Form</h3><p>The <code>:require</code> helper form is for setting up access to other Clojure
+namespaces from your code. For example:</p><pre><code class="clojure">(ns megacorp.profitd.scheduling
+  (:require clojure.set))
+
+;; Now it is possible to do:
+;; (clojure.set/difference #{1 2 3} #{3 4 5})
+</code></pre><p>This will make sure the <code>clojure.set</code> namespace is loaded, compiled, and available as <code>clojure.set</code>
+(using its fully qualified name). It is possible (and common) to make a namespace available
+under an alias:</p><pre><code class="clojure">(ns megacorp.profitd.scheduling
+  (:require [clojure.set :as cs]))
+
+;; Now it is possible to do:
+;; (cs/difference #{1 2 3} #{3 4 5})
+</code></pre><p>One more example with two required namespaces:</p><pre><code class="clojure">(ns megacorp.profitd.scheduling
+  (:require [clojure.set  :as cs]
+            [clojure.walk :as walk]))
+</code></pre><h4 id="the-refer-option">The :refer Option</h4><p>To make functions in <code>clojure.set</code> available in the defined namespace via short names
+(i.e., their unqualified names, without the <code>clojure.set</code> or other prefix), you can tell Clojure compiler
+to <em>refer</em> to certain functions:</p><pre><code class="clojure">(ns megacorp.profitd.scheduling
+  (:require [clojure.set :refer [difference intersection]]))
+
+;; Now it is possible to do:
+;; (difference #{1 2 3} #{3 4 5})
+</code></pre><p>The <code>:refer</code> feature of the <code>:require</code> form is new in Clojure 1.4.</p><p>It is possible to refer to all functions in a namespace (usually not necessary):</p><pre><code class="clojure">(ns megacorp.profitd.scheduling
+  (:require [clojure.set :refer :all]))
+
+;; Now it is possible to do:
+;; (difference #{1 2 3} #{3 4 5})
+</code></pre><h3 id="the-import-helper-form">The :import Helper Form</h3><p>The <code>:import</code> helper form is for setting up access to Java classes
+from your Clojure code. For example:</p><pre><code class="clojure">(ns megacorp.profitd.scheduling
+  (:import java.util.concurrent.Executors))
+</code></pre><p>This will make sure the <code>java.util.concurrent.Executors</code> class is imported and can be used by its short
+name, <code>Executors</code>. It is possible to import multiple classes:</p><pre><code class="clojure">(ns megacorp.profitd.scheduling
+  (:import java.util.concurrent.Executors
+           java.util.concurrent.TimeUnit
+           java.util.Date))
+</code></pre><p>If multiple imported classes are in the same namespace (like in the example above),
+it is possible to avoid some duplication by using an <em>import list</em>. The first element
+of an import list is the package and other elements are class names in that package:</p><pre><code class="clojure">(ns megacorp.profitd.scheduling
+  (:import [java.util.concurrent Executors TimeUnit]
+           java.util.Date))
+</code></pre><p>Even though <em>import list</em> is called a list, it can be any Clojure collection (typically
+vectors are used).</p><h3 id="the-current-namespace">The Current Namespace</h3><p>Under the hood, Clojure keeps <strong>current namespace</strong> a special var, <a href="http://clojuredocs.org/clojure_core/clojure.core/*ns*">*ns*</a>.
+When vars are defined using the <a href="http://clojuredocs.org/clojure_core/clojure.core/def">def</a> special form, they are
+added to the current namespace.</p><h3 id="the-refer-clojure-helper-form">The :refer-clojure Helper Form</h3><p>Functions like <code>clojure.core/get</code> and macros like <code>clojure.core/defn</code> can be used without
+namespace qualification because they reside in the <code>clojure.core</code> namespace and Clojure
+compiler automatically <em>refers</em> all vars in it. Therefore, if your
+namespace defines a function with the same name (e.g. <code>find</code>), you will get a warning
+from the compiler, like this:</p><pre><code>WARNING: find already refers to: #'clojure.core/find in namespace: megacorp.profitd.scheduling, being replaced by: #'megacorp.profitd.scheduling/find
+</code></pre><p>This means that in the <code>megacorp.profitd.scheduling</code> namespace, <code>find</code> already refers to
+a value which happens to be <code>clojure.core/find</code>, but it is being replaced by a
+different value. Remember, Clojure is a very dynamic language and namespaces are
+basically maps, as far as the implementation goes. Most of the time, however,
+replacing vars like this is not intentional and Clojure compiler emits a warning.</p><p>To solve this problem, you can either rename your function, or else
+exclude certain <code>clojure.core</code> functions from being
+referred using the <code>(:refer-clojure ...)</code> form within the <code>ns</code>:</p><pre><code class="clojure">(ns megacorp.profitd.scheduling
+  (:refer-clojure :exclude [find]))
+
+(defn find
+  "Finds a needle in the haystack."
+  [^String haystack]
+  (comment ...))
+</code></pre><p>In this case, to use <code>clojure.core/find</code>, you will have to use its fully
+qualified name: <code>clojure.core/find</code>:</p><pre><code class="clojure">(ns megacorp.profitd.scheduling
+  (:refer-clojure :exclude [find]))
+
+(defn find
+  "Finds a needle in the haystack."
+  [^String haystack]
+  (clojure.core/find haystack :needle))
+</code></pre><h3 id="the-use-helper-form">The :use Helper Form</h3><p>In Clojure versions before 1.4, there was no <code>:refer</code> support for the
+<code>(:require ...)</code> form. Instead, a separate form was used: <code>(:use ...)</code>:</p><pre><code class="clojure">(ns megacorp.profitd.scheduling-test
+  (:use clojure.test))
+</code></pre><p>In the example above, <strong>all</strong> functions in <code>clojure.test</code> are made available
+in the current namespace. This practice (known as "naked use") works for <code>clojure.test</code> in
+test namespaces, but in general not a good idea. <code>(:use ...)</code> supports limiting
+functions that will be referred:</p><pre><code class="clojure">(ns megacorp.profitd.scheduling-test
+  (:use clojure.test :only [deftest testing is]))
+</code></pre><p>which is a pre-1.4 alternative of</p><pre><code class="clojure">(ns megacorp.profitd.scheduling-test
+  (:require clojure.test :refer [deftest testing is]))
+</code></pre><p>It is highly recommended to use <code>(:require ...)</code> (optionally with <code>... :refer [...]</code>) on Clojure 1.4
+and later releases. <code>(:use ...)</code> is a thing of the past and now that
+<code>(:require ...)</code> with <code>:refer</code> is capable of doing the same thing when you
+need it, it is a good idea to let <code>(:use ...)</code> go.</p><h3 id="the-gen-class-helper-form">The :gen-class Helper Form</h3><p><em>TBD: <a href="https://github.com/clojure-doc/clojure-doc.github.io#how-to-contribute">How to Contribute</a></em></p><h3 id="documentation-and-metadata">Documentation and Metadata</h3><p>Namespaces can have documentation strings. You can add one with the optional
+<code>ns</code> macro parameter:</p><pre><code class="clojure">(ns superlib.core
+  "Core functionality of Superlib.
+
+   Other parts of Superlib depend on functions and macros in this namespace."
+  (:require [clojure.set :refer [union difference]]))
+</code></pre><p>or metadata:</p><pre><code class="clojure">(ns ^{:doc "Core functionality of Superlib.
+            Other parts of Superlib depend on functions and macros in this namespace."
+      :author "Joe Smith"}
+   superlib.core
+  (:require [clojure.set :refer [union difference]]))
+</code></pre><p>Metadata can contain any additional keys such as <code>:author</code> which may be of use to various tools
+(such as <a href="https://clojars.org/codox">Codox</a>, <a href="https://clojars.org/cadastre">Cadastre</a>, or <a href="https://clojars.org/lein-clojuredocs">lein-clojuredocs</a>).</p><h2 id="how-to-use-functions-from-other-namespaces-in-the-repl">How to Use Functions From Other Namespaces in the REPL</h2><p>The <code>ns</code> macro is how you usually require functions from other namespaces.
+However, it is not very convenient in the REPL. For that case, the <code>clojure.core/require</code> function
+can be used directly:</p><pre><code class="clojure">;; Will be available as clojure.set, e.g. clojure.set/difference.
+(require 'clojure.set)
+
+;; Will be available as io, e.g. io/resource.
+(require '[clojure.java.io :as io])
+</code></pre><p>It takes a quoted <em><a href="https://clojure-doc.org/articles/language/namespaces/glossary.html#libspec">libspec</a></em>. The libspec is either a namespace name or
+a collection (typically a vector) of <code>[name :as alias]</code> or <code>[name :refer [fns]]</code>:</p><pre><code class="clojure">(require '[clojure.set :refer [difference]])
+
+(difference #{1 2 3} #{3 4 5 6})  ; ⇒ #{1 2}
+</code></pre><p>The <code>:as</code> and <code>:refer</code> options can be used together:</p><pre><code class="clojure">(require '[clojure.set :as cs :refer [difference]])
+
+(difference #{1 2 3} #{3 4 5 6})  ; ⇒ #{1 2}
+(cs/union #{1 2 3} #{3 4 5 6})    ; ⇒ #{1 2 3 4 5 6}
+</code></pre><p><code>clojure.core/use</code> does the same thing as <code>clojure.core/require</code> but with the
+<code>:refer</code> option (as discussed above). It is not generally recommended to use <code>use</code> with Clojure
+versions starting with 1.4. Use <code>clojure.core/require</code> with <code>:refer</code>
+instead.</p><h2 id="namespaces-and-class-generation">Namespaces and Class Generation</h2><p><em>TBD: <a href="https://github.com/clojure-doc/clojure-doc.github.io#how-to-contribute">How to Contribute</a></em></p><h2 id="namespaces-and-code-compilation-in-clojure">Namespaces and Code Compilation in Clojure</h2><p>Clojure is a compiled language: code is compiled when it is loaded (usually with <code>clojure.core/require</code>).</p><p>A namespace can contain vars or be used purely to extend protocols, add multimethod implementations,
+or conditionally load other libraries (e.g. the most suitable JSON parser or key/value store implementation).
+In all cases, to trigger compilation, you need to require the namespace.</p><h2 id="private-vars">Private Vars</h2><p>Vars (and, in turn, functions defined with <code>defn</code>) can be private. There are two equivalent ways to
+specify that a function is private: either via metadata or by using the <code>defn-</code> macro:</p><pre><code class="clojure">(ns megacorp.superlib)
+
+;;
+;; Implementation
+;;
+
+(def ^{:private true}
+  source-name "supersource")
+
+(defn- data-stream
+  [source]
+  (comment ...))
+</code></pre><h2 id="constant-vars">Constant Vars</h2><p>Vars can be constant. This is done by setting the <code>:const</code> metadata key to <code>true</code>. This
+will cause Clojure compiler to compile it as a constant:</p><pre><code class="clojure">(ns megacorp.epicgame)
+
+;;
+;; Implementation
+;;
+
+(def ^{:const true}
+  default-score 100)
+</code></pre><h2 id="how-to-look-up-and-invoke-a-function-by-name">How to Look up and Invoke a Function by Name</h2><p>It is possible to look up a function in particular namespace by-name with <code>clojure.core/ns-resolve</code>. This takes
+quoted names of the namespace and function. The returned value can be used just like any other
+function, for example, passed as an argument to a higher order function:</p><pre><code class="clojure">(ns-resolve 'clojure.set 'difference)  ; ⇒ #'clojure.set/difference
+
+(let [f (ns-resolve 'clojure.set 'difference)]
+   (f #{1 2 3} #{3 4 5 6}))  ; ⇒ #{1 2}
+</code></pre><h2 id="compiler-exceptions">Compiler Exceptions</h2><p>This section describes some common compilation errors.</p><h3 id="classnotfoundexception">ClassNotFoundException</h3><p>This exception means that JVM could not load a class. It is either misspelled or not on the
+<a href="https://clojure-doc.org/articles/language/namespaces/glossary.html#classpath">classpath</a>.
+Potentially your project has unsatisfied dependency (some dependencies may be optional).</p><p>Example:</p><pre><code class="clojure">user=&gt; (import java.uyil.concurrent.TimeUnit)
+ClassNotFoundException java.uyil.concurrent.TimeUnit  java.net.URLClassLoader$1.run (URLClassLoader.java:366)
+</code></pre><p>In the example above, <code>java.uyil.concurrent.TimeUnit</code> should have been <code>java.util.concurrent.TimeUnit</code>.</p><h3 id="compilerexception-javalangruntimeexception-no-such-var">CompilerException java.lang.RuntimeException: No such var</h3><p>This means that somewhere in the code a non-existent var is used. It may be a typo, an
+incorrect macro-generated var name or a similar issue. Example:</p><pre><code class="clojure">user=&gt; (clojure.java.io/resouce "thought_leaders_quotes.csv")
+CompilerException java.lang.RuntimeException: No such var: clojure.java.io/resouce, compiling:(NO_SOURCE_PATH:1)
+</code></pre><p>In the example above, <code>clojure.java.io/resouce</code> should have been <code>clojure.java.io/resource</code>. <code>NO_SOURCE_PATH</code>
+means that compilation was triggered from the REPL and not a Clojure source file.</p><h2 id="temporarily-overriding-vars-in-namespaces">Temporarily Overriding Vars in Namespaces</h2><p><em>TBD: <a href="https://github.com/clojure-doc/clojure-doc.github.io#how-to-contribute">How to Contribute</a></em></p><h2 id="getting-information-about-and-programmatically-manipulating-namespaces">Getting Information About and Programmatically Manipulating Namespaces</h2><p><em>TBD: <a href="https://github.com/clojure-doc/clojure-doc.github.io#how-to-contribute">How to Contribute</a></em></p><h2 id="wrapping-up">Wrapping Up</h2><p>Namespaces are basically maps (dictionaries) that map names to
+vars. In many cases, those vars store functions in them.</p><p>This implementation lets Clojure have many of its highly dynamic
+features at a very reasonable runtime overhead cost. For example, vars
+in namespaces can be temporarily altered for unit testing purposes.</p><h2 id="contributors">Contributors</h2><p>Michael Klishin <a href="mailto:michael@defprotocol.org">michael@defprotocol.org</a> (original author)</p>
+
+    <div id="prev-next">
+        
+        <a href="../core_overview/index.html">&laquo; Overview of clojure.core, the standard Clojure library</a>
+        
+        
+        ||
+        
+        
+        <a href="../collections_and_sequences/index.html">Collections and Sequences in Clojure &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/language/polymorphism/index.html b/clones/clojure-doc.org/articles/language/polymorphism/index.html
new file mode 100644
index 00000000..93c7a7eb
--- /dev/null
+++ b/clones/clojure-doc.org/articles/language/polymorphism/index.html
@@ -0,0 +1,385 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Polymorphism in Clojure: Protocols and Multimethods</title>
+    
+
+<meta name="description" content="This guide covers:">
+
+<meta property="og:description" content="This guide covers:">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/language/polymorphism/" />
+<meta property="og:title" content="Polymorphism in Clojure: Protocols and Multimethods" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/language/polymorphism/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Polymorphism in Clojure: Protocols and Multimethods</h2>
+    </div>
+    
+    <p>This guide covers:</p><ul><li>What are polymorphic functions</li><li>Type-based polymorphism with protocols</li><li>Ad-hoc polymorphism with multimethods</li><li>How to create your own data types that behave like core Clojure data types</li></ul><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons Attribution 3.0 Unported License</a>
+(including images &amp; stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on Github</a>.</p><h2 id="what-version-of-clojure-does-this-guide-cover">What Version of Clojure Does This Guide Cover?</h2><p>This guide covers Clojure 1.5.</p><h2 id="overview">Overview</h2><p>According to Wikipedia,</p><blockquote><p>In computer science, polymorphism is a programming language feature that allows values of different data types to be handled using a uniform interface.</p></blockquote><p>Polymorphism is not at all unique to object-oriented programming languages. Clojure has excellent support for
+polymorphism.</p><p>For example, when a function can be used on multiple data types or behave differently based on additional argument
+(often called <em>dispatch value</em>), that function is <em>polymorphic</em>. A simple example of such function is a function that
+serializes its input to JSON (or other format).</p><p>Ideally, developers would like to use the same function regardless of the input, and be able to extend
+it to new inputs, without having to change the original source. Inability to do so is known as the <a href="http://en.wikipedia.org/wiki/Expression_problem">Expression Problem</a>.</p><p>In Clojure, there are two approaches to polymorphism:</p><ul><li>Data type-oriented. More efficient (modern JVMs optimize this case very well), less flexible.</li><li>So called "ad-hoc polymorphism" where the exact function implementation is picked at runtime based on a special argument (<em>dispatch value</em>).</li></ul><p>The former is implemented using <em>protocols</em>, a feature first introduced in Clojure 1.2. The latter is available via
+<em>multimethods</em>, a feature that was around in Clojure since the early days.</p><h2 id="type-based-polymorphism-with-protocols">Type-based Polymorphism With Protocols</h2><p>It is common for polymorphic functions to <em>dispatch</em> (pick implementation) on the type of the first argument. For example,
+in Java or Ruby, when calling <code>#toString</code> or <code>#to_s</code> on an object, the exact implementation is located using that object's
+type.</p><p>Because this is a common case and because JVM can optimize this dispatch logic very well, Clojure 1.2 introduced a new
+feature called <em>protocols</em>. Protocols are simply groups of functions. Each of the functions can have different
+implementations for different data types.</p><p>Protocols are defined using the <code>clojure.core/defprotocol</code> special form. The example below defines a protocol for working with URLs and URIs.
+While URLs and URIs are not the same thing, some operations make sense for both:</p><pre><code class="clojure">(defprotocol URLLike
+  "Unifies operations on URLs and URIs"
+  (^String protocol-of  [input] "Returns protocol of given input")
+  (^String host-of      [input] "Returns host of given input")
+  (^String port-of      [input] "Returns port of given input")
+  (^String user-info-of [input] "Returns user information of given input")
+  (^String path-of      [input] "Returns path of given input")
+  (^String query-of     [input] "Returns query string of given input")
+  (^String fragment-of  [input] "Returns fragment of given input"))
+</code></pre><p><code>clojure.core/defprotocol</code> takes the name of the protocol and one or more lists of
+<strong>function name</strong>, <strong>argument list</strong>, <strong>documentation string</strong>:</p><pre><code class="clojure">(^String protocol-of  [input] "Returns protocol of given input")
+(^String host-of      [input] "Returns host of given input")
+</code></pre><p>The example above uses return type hints. This makes sense in the example but is not necessary. It could have been written
+it as</p><pre><code class="clojure">(defprotocol URLLike
+  "Unifies operations on URLs and URIs"
+  (protocol-of  [input] "Returns protocol of given input")
+  (host-of      [input] "Returns hostname of given input")
+  (port-of      [input] "Returns port of given input")
+  (user-info-of [input] "Returns user information (username:password) of given input")
+  (path-of      [input] "Returns path of given input")
+  (query-of     [input] "Returns query string of given input")
+  (fragment-of  [input] "Returns fragment of given input"))
+</code></pre><p>There are 3 ways URIs and URLs are commonly represented on the JVM:</p><ul><li><code>java.net.URI</code> instances</li><li><code>java.net.URL</code> instances</li><li>Strings</li></ul><p>When a new protocol imlementation is added for a type, it is called <strong>extending the protocol</strong>. The most common way to extend
+a protocol is via the <code>clojure.core/extend-protocol</code>:</p><pre><code class="clojure">(import java.net.URI)
+(import java.net.URL)
+
+(extend-protocol URLLike
+  URI
+  (protocol-of [^URI input]
+    (when-let [s (.getScheme input)]
+      (.toLowerCase s)))
+  (host-of [^URI input]
+    (-&gt; input .getHost .toLowerCase))
+  (port-of [^URI input]
+    (.getPort input))
+  (user-info-of [^URI input]
+    (.getUserInfo input))
+  (path-of [^URI input]
+    (.getPath input))
+  (query-of [^URI input]
+    (.getQuery input))
+  (fragment-of [^URI input]
+    (.getFragment input))
+
+  URL
+  (protocol-of [^URL input]
+    (protocol-of (.toURI input)))
+  (host-of [^URL input]
+    (host-of (.toURI input)))
+  (port-of [^URL input]
+    (.getPort input))
+  (user-info-of [^URL input]
+    (.getUserInfo input))
+  (path-of [^URL input]
+    (.getPath input))
+  (query-of [^URL input]
+    (.getQuery input))
+  (fragment-of [^URL input]
+    (.getRef input)))
+</code></pre><p>Protocol functions are used just like regular Clojure functions:</p><pre><code class="clojure">(protocol-of (URI. "https://clojure-doc.github.io")) ;= "http"
+(protocol-of (URL. "https://clojure-doc.github.io")) ;= "http"
+
+(path-of (URL. "https://clojure-doc.github.io/articles/content.html")) ;= "/articles/content/"
+(path-of (URI. "https://clojure-doc.github.io/articles/content.html")) ;= "/articles/content/"
+</code></pre><h3 id="using-protocols-from-different-namespaces">Using Protocols From Different Namespaces</h3><p>Protocol functions are required and used the same way as regular protocol functions. Consider a
+namespace that looks like this</p><pre><code class="clojure">(ns superlib.url-like
+  (:import [java.net URL URI]))
+
+(defprotocol URLLike
+  "Unifies operations on URLs and URIs"
+  (^String protocol-of  [input] "Returns protocol of given input")
+  (^String host-of      [input] "Returns host of given input")
+  (^String port-of      [input] "Returns port of given input")
+  (^String user-info-of [input] "Returns user information of given input")
+  (^String path-of      [input] "Returns path of given input")
+  (^String query-of     [input] "Returns query string of given input")
+  (^String fragment-of  [input] "Returns fragment of given input"))
+
+(extend-protocol URLLike
+  URI
+  (protocol-of [^URI input]
+    (when-let [s (.getScheme input)]
+      (.toLowerCase s)))
+  (host-of [^URI input]
+    (-&gt; input .getHost .toLowerCase))
+  (port-of [^URI input]
+    (.getPort input))
+  (user-info-of [^URI input]
+    (.getUserInfo input))
+  (path-of [^URI input]
+    (.getPath input))
+  (query-of [^URI input]
+    (.getQuery input))
+  (fragment-of [^URI input]
+    (.getFragment input))
+
+  URL
+  (protocol-of [^URL input]
+    (protocol-of (.toURI input)))
+  (host-of [^URL input]
+    (host-of (.toURI input)))
+  (port-of [^URL input]
+    (.getPort input))
+  (user-info-of [^URL input]
+    (.getUserInfo input))
+  (path-of [^URL input]
+    (.getPath input))
+  (query-of [^URL input]
+    (.getQuery input))
+  (fragment-of [^URL input]
+    (.getRef input)))
+</code></pre><p>To use <code>superlib.url-like/path-of</code> and other functions, you require them as regular functions:</p><pre><code class="clojure">(ns myapp
+  (:require [superlib.url-like] :refer [host-of scheme-of]))
+
+(host-of (java.net.URI. "https://twitter.com/cnn/"))
+</code></pre><h3 id="extending-protocols-for-core-clojure-data-types">Extending Protocols For Core Clojure Data Types</h3><p>TBD</p><h3 id="protocols-and-custom-data-types">Protocols and Custom Data Types</h3><p>TBD: cover extend-type, extend</p><h3 id="partial-implementation-of-protocols">Partial Implementation of Protocols</h3><p>With protocols, it is possible to only implement certain functions for certain types.</p><h2 id="ad-hoc-polymorphism-with-multimethods">Ad-hoc Polymorphism with Multimethods</h2><h3 id="first-example-shapes">First Example: Shapes</h3><p>Lets start with a simple problem definition. We have 3 shapes: square, circle and triangle, and
+need to provide an polymorphic function that calculates the area of the given shape.</p><p>In total, we need 4 functions:</p><ul><li>A function that calculates area of a square</li><li>A function that calculates area of a circle</li><li>A function that calculates area of a triangle</li><li>A polymorphic function that acts as a "unified frontend" to the functions above</li></ul><p>we will start with the latter and define a <em>multimethod</em> (not related to methods on Java objects or object-oriented programming):</p><pre><code class="klipse-clojure nohighlight">(defmulti area (fn [shape &amp; _]
+                 shape))
+</code></pre><p>Our multimethod has a name and a <em>dispatch function</em> that takes arguments passed to the multimethod and returns
+a value. The returned value will define what implementation of multimethod is used. In Java or Ruby, method implementation
+is picked by traversing the class hierarchy. With multimethods, the logic can be anything you need. That's why it is
+called <em>ad-hoc polymorphism</em>.</p><p>An alternative way of doing the same thing is to pass <code>clojure.core/first</code> instead of an anonymous function:</p><pre><code class="klipse-clojure nohighlight">(defmulti area first)
+</code></pre><p>Next lets implement our area multimethod for squares:</p><pre><code class="klipse-clojure nohighlight">(defmethod area :square
+  [_ side]
+  (* side side))
+</code></pre><p>Here <code>defmethod</code> defines a particular implementation of the multimethod <code>area</code>, the one that will be used if dispatch function
+returns <code>:square</code>. Lets try it out. Multimethods are invoked like regular Clojure functions:</p><pre><code class="klipse-clojure nohighlight">(area :square 4)
+;= 16
+</code></pre><p>In this case, we pass dispatch value as the first argument, our dispatch function returns it unmodified and
+that's how the exact implementation is looked up.</p><p>Implementation for circles looks very similar, we choose <code>:circle</code> as a reasonable dispatch value:</p><pre><code class="klipse-clojure nohighlight">(defmethod area :circle
+  [_ radius]
+  (* radius radius Math/PI))
+
+(area :circle 3)
+;= 28.274333882308138
+</code></pre><p>For the record, <code>Math/PI</code> in this example refers to <code>java.lang.Math/PI</code>, a field that stores the value of Pi.</p><p>Finally, an implementation for triangles. Here you can see that exact implementations can take different number of
+arguments. To calculate the area of a triangle, we multiple base by height and divide it by 2:</p><pre><code class="klipse-clojure nohighlight">(defmethod area :triangle
+  [_ b h]
+  (* 1/2 b h))
+
+(area :triangle 3 5)
+;= 15/2
+</code></pre><p>In this example we used <strong>Clojure ratio</strong> data type. We could have used doubles as well.</p><p>Putting it all together:</p><pre><code class="klipse-clojure nohighlight">(defmulti area (fn [shape &amp; _]
+                 shape))
+
+(defmethod area :square
+  [_ side]
+  (* side side))
+
+(defmethod area :circle
+  [_ radius]
+  (* radius radius Math/PI))
+
+(defmethod area :triangle
+  [_ b h]
+  (* 1/2 b h))
+</code></pre><pre><code class="klipse-clojure nohighlight">(area :square 4)
+;= 16
+</code></pre><pre><code class="klipse-clojure nohighlight">(area :circle 3)
+;= 28.274333882308138
+</code></pre><pre><code class="klipse-clojure nohighlight">(area :triangle 3 5)
+;= 15/2
+</code></pre><h3 id="second-example-tbd">Second Example: TBD</h3><p>TBD: an example that demonstrates deriving</p><h2 id="how-to-create-custom-data-type-that-core-functions-can-work-with">How To Create Custom Data Type That Core Functions Can Work With</h2><p>TBD: <a href="https://github.com/clojure-doc/clojure-doc.github.io#how-to-contribute">How to Contribute</a></p><h2 id="wrapping-up">Wrapping Up</h2><p>TBD: <a href="https://github.com/clojure-doc/clojure-doc.github.io#how-to-contribute">How to Contribute</a></p>
+
+    <div id="prev-next">
+        
+        <a href="../macros/index.html">&laquo; Clojure Macros and Metaprogramming</a>
+        
+        
+        ||
+        
+        
+        <a href="../concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../../tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../../tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../../tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../../tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../../tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../../tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+ <link rel="stylesheet" type="text/css" href="https://storage.googleapis.com/app.klipse.tech/css/codemirror.css">
+<script>
+window.klipse_settings = {
+  "selector" : ".klipse-clojure"
+};
+</script>
+<script src="https://storage.googleapis.com/app.klipse.tech/plugin/js/klipse_plugin.js"></script> 
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/tutorials/basic_web_development/index.html b/clones/clojure-doc.org/articles/tutorials/basic_web_development/index.html
new file mode 100644
index 00000000..77c64c88
--- /dev/null
+++ b/clones/clojure-doc.org/articles/tutorials/basic_web_development/index.html
@@ -0,0 +1,476 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Basic Web Development</title>
+    
+
+<meta name="description" content="This guide covers building a simple web-application using common
+Clojure libraries. When you&#39;re done working through it, you&#39;ll have a
+little webapp that displays some (x, y) locations from a database,
+letting you add more locations as well.It&#39;s assumed that you&#39;re already somewhat familiar with Clojure. If
+not, see the Getting Started and
+Introduction guides.">
+
+<meta property="og:description" content="This guide covers building a simple web-application using common
+Clojure libraries. When you&#39;re done working through it, you&#39;ll have a
+little webapp that displays some (x, y) locations from a database,
+letting you add more locations as well.It&#39;s assumed that you&#39;re already somewhat familiar with Clojure. If
+not, see the Getting Started and
+Introduction guides.">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/tutorials/basic_web_development/" />
+<meta property="og:title" content="Basic Web Development" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/tutorials/basic_web_development/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Basic Web Development</h2>
+    </div>
+    
+    <p>This guide covers building a simple web-application using common
+Clojure libraries. When you're done working through it, you'll have a
+little webapp that displays some (x, y) locations from a database,
+letting you add more locations as well.</p><p>It's assumed that you're already somewhat familiar with Clojure. If
+not, see the <a href="https://clojure-doc.org/articles/tutorials/basic_web_development/getting_started/">Getting Started</a> and
+<a href="https://clojure-doc.org/articles/tutorials/basic_web_development/introduction/">Introduction</a> guides.</p><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons
+Attribution 3.0 Unported License</a> (including images &amp;
+stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on
+Github</a>.</p><p>This guide uses Clojure 1.5, as well as current versions of the
+component libraries noted below.</p><h2 id="conceptual-overview-of-components">Conceptual Overview of Components</h2><p>We'll use four major components (briefly described below) for our
+little webapp:</p><ul><li>Ring</li><li>Compojure</li><li>Hiccup</li><li>H2</li></ul><h3 id="ring">Ring</h3><p><a href="https://github.com/ring-clojure/ring">Ring</a> (<a href="https://clojars.org/ring">at
+clojars</a>) is a foundational Clojure web
+application library. It:</p><ul><li>sets things up such that an http request comes into your webapp
+as a regular Clojure hashmap, and likewise makes it so that you
+can return a response as a hashmap.</li><li>provides <a href="https://github.com/ring-clojure/ring/blob/master/SPEC">a
+spec</a>
+describing exactly what those request and response maps should
+look like.</li><li>brings along a web server
+(<a href="http://www.eclipse.org/jetty/">Jetty</a>) and connects your
+webapp to it.</li></ul><p>For this tutorial, we won't actually need to deal with these maps
+by-hand, as you'll soon see.</p><p>For more info, see:</p><ul><li><a href="https://github.com/ring-clojure/ring#readme">the Ring readme</a></li><li><a href="https://github.com/ring-clojure/ring/wiki">its wiki docs</a></li><li><a href="http://ring-clojure.github.com/ring/">its API docs</a></li></ul><h3 id="compojure">Compojure</h3><p>If we were using only Ring, we'd have to write one single function to
+take that incoming request map and then delegate to various functions
+depending upon which page was requested.
+<a href="https://github.com/weavejester/compojure">Compojure</a> (<a href="https://clojars.org/compojure">at
+clojars</a>) provides some handy features
+to take care of this for us such that we can associate url paths with
+corresponding functions, all in one place.</p><p>For more info, see:</p><ul><li><a href="https://github.com/weavejester/compojure#readme">the Compojure readme</a></li><li><a href="https://github.com/weavejester/compojure/wiki">its wiki docs</a></li><li><a href="http://weavejester.github.com/compojure/">its API docs</a></li></ul><h3 id="hiccup">Hiccup</h3><p><a href="https://github.com/weavejester/hiccup">Hiccup</a> (<a href="https://clojars.org/hiccup">at
+clojars</a>) provides a quick and easy way to
+generate html. It converts regular Clojure data structures right into
+html. For example,</p><pre><code class="clojure">[:p "Hello, " [:i "doctor"] " Jones."]
+</code></pre><p>becomes</p><pre><code class="html">&lt;p&gt;Hello, &lt;i&gt;doctor&lt;/i&gt; Jones.&lt;/p&gt;
+</code></pre><p>but it also does two extra handy bits of magic:</p><ul><li><p>it provides some CSS-like shortcuts for specifying id and class,
+and</p></li><li><p>it automatically unpacks seqs for you, for example:</p><pre><code class="clojure">[:p '("a" "b" "c")]
+;; expands to (and so, is the same as if you wrote)
+[:p "a" "b" "c"]
+</code></pre></li></ul><p>For more info, see:</p><ul><li><a href="https://github.com/weavejester/hiccup#readme">the Hiccup readme</a></li><li><a href="https://github.com/weavejester/hiccup/wiki">its wiki docs</a></li><li><a href="http://weavejester.github.com/hiccup/">its API docs</a></li></ul><h3 id="h2">H2</h3><p><a href="http://www.h2database.com/html/main.html">H2</a> is a small and fast Java SQL
+database that could be embedded in your application or run in server
+mode. Uses single file for storage, but also could be run as in-memory DB.</p><blockquote><p>Another similar Java-based embedded DB that could be used in your
+application is <a href="http://db.apache.org/derby/">Apache Derby</a>.</p></blockquote><h2 id="create-and-set-up-your-project">Create and set up your project</h2><p>Create your new webapp project like so:</p><pre><code class="bash">lein new compojure my-webapp
+cd my-webapp
+</code></pre><p>Add the following extra dependencies to your project.clj's
+<code>:dependencies</code> vector:</p><pre><code class="clojure">[hiccup "1.0.5"]
+[org.clojure/java.jdbc "0.6.0"]
+[com.h2database/h2 "1.4.193"]
+</code></pre><p>(You might also remove the <code>-SNAPSHOT</code> from the project's version
+string.)</p><h2 id="add-some-styling">Add some styling</h2><pre><code class="bash">mkdir -p resources/public/css
+touch resources/public/css/styles.css
+</code></pre><p>and put into that file something like:</p><pre><code class="css">body {
+    background-color: Cornsilk;
+}
+
+#header-links {
+    background-color: BurlyWood;
+    padding: 10px;
+}
+
+h1 {
+    color: CornflowerBlue;
+}
+</code></pre><h2 id="set-up-your-database">Set up your database</h2><p>A file with DB would be automatically created when you connect to it for the
+first time, so all necessary DB preparations could be done programmatically
+using the REPL (with help of <code>clojure.java.jdbc</code>):</p><pre><code class="bash">lein repl
+</code></pre><p>Execute the following code to create a new my-webapp.h2.db database file in db
+subdirectory of your project, create a table we'll use for our webapp, and add
+one record to start us off with:</p><pre><code class="clojure">(require '[clojure.java.jdbc :as jdbc])
+(jdbc/with-db-connection [conn {:dbtype "h2" :dbname "./my-webapp"}]
+
+  (jdbc/db-do-commands conn
+    (jdbc/create-table-ddl :locations
+      [[:id "bigint primary key auto_increment"]
+       [:x "integer"]
+       [:y "integer"]]))
+
+  (jdbc/insert! conn :locations
+    {:x 8 :y 9}))
+</code></pre><p>and hit <code>ctrl-d</code> to exit.</p><p>For more about how to use the database functions, see the
+<a href="../../ecosystem/java_jdbc/home.html">Using java.jdbc</a> on this site.</p><h2 id="set-up-your-routes">Set up your routes</h2><p>In the default <code>src/my_webapp/handler.clj</code> file you're provided, we
+specify our webapp's <em>routes</em> inside the <code>defroutes</code> macro. That is,
+we assign a function to handle each of the url paths we'd like to
+support, and then at the end provide a "not found" page for any other
+url paths.</p><p>Make your handler.clj file look like this:</p><pre><code class="clojure">(ns my-webapp.handler
+  (:require [my-webapp.views :as views] ; add this require
+            [compojure.core :refer :all]
+            [compojure.route :as route]
+            [ring.middleware.defaults :refer [wrap-defaults site-defaults]]))
+
+(defroutes app-routes ; replace the generated app-routes with this
+  (GET "/"
+       []
+       (views/home-page))
+  (GET "/add-location"
+       []
+       (views/add-location-page))
+  (POST "/add-location"
+        {params :params}
+        (views/add-location-results-page params))
+  (GET "/location/:loc-id"
+       [loc-id]
+       (views/location-page loc-id))
+  (GET "/all-locations"
+       []
+       (views/all-locations-page))
+  (route/resources "/")
+  (route/not-found "Not Found"))
+
+(def app
+  (wrap-defaults app-routes site-defaults))
+</code></pre><p>Each of those expressions in <code>defroutes</code> like <code>(GET ...)</code> or <code>(POST ...)</code> are
+so-called "routes". They each evaluate to a function that
+takes a ring request hashmap and returns a response hashmap. Your
+<code>views/foo</code> function's job is to return that response hashmap, but note
+that Compojure is kind enough to make a suitable response map out of
+any html you return.</p><p>So, all you actually need to do now is write your views functions to
+return some html.</p><p>Incidentally, note the special destructuring that Compojure does for
+you in each of those routes. It can pull out url query (and body)
+parameters, as well as pieces of the url path requested, and hand them
+to your views functions. Read more about that at <a href="https://github.com/weavejester/compojure/wiki/Destructuring-Syntax">Compojure
+destructuring</a>.</p><h2 id="create-your-views">Create your Views</h2><p>Create a <code>src/my_webapp/views.clj</code> file and make it look like:</p><pre><code class="clojure">(ns my-webapp.views
+  (:require [my-webapp.db :as db]
+            [clojure.string :as str]
+            [hiccup.page :as page]
+            [ring.util.anti-forgery :as util]))
+
+(defn gen-page-head
+  [title]
+  [:head
+   [:title (str "Locations: " title)]
+   (page/include-css "/css/styles.css")])
+
+(def header-links
+  [:div#header-links
+   "[ "
+   [:a {:href "/"} "Home"]
+   " | "
+   [:a {:href "/add-location"} "Add a Location"]
+   " | "
+   [:a {:href "/all-locations"} "View All Locations"]
+   " ]"])
+
+(defn home-page
+  []
+  (page/html5
+   (gen-page-head "Home")
+   header-links
+   [:h1 "Home"]
+   [:p "Webapp to store and display some 2D (x,y) locations."]))
+
+(defn add-location-page
+  []
+  (page/html5
+   (gen-page-head "Add a Location")
+   header-links
+   [:h1 "Add a Location"]
+   [:form {:action "/add-location" :method "POST"}
+    (util/anti-forgery-field) ; prevents cross-site scripting attacks
+    [:p "x value: " [:input {:type "text" :name "x"}]]
+    [:p "y value: " [:input {:type "text" :name "y"}]]
+    [:p [:input {:type "submit" :value "submit location"}]]]))
+
+(defn add-location-results-page
+  [{:keys [x y]}]
+  (let [id (db/add-location-to-db x y)]
+    (page/html5
+     (gen-page-head "Added a Location")
+     header-links
+     [:h1 "Added a Location"]
+     [:p "Added [" x ", " y "] (id: " id ") to the db. "
+      [:a {:href (str "/location/" id)} "See for yourself"]
+      "."])))
+
+(defn location-page
+  [loc-id]
+  (let [{x :x y :y} (db/get-xy loc-id)]
+    (page/html5
+     (gen-page-head (str "Location " loc-id))
+     header-links
+     [:h1 "A Single Location"]
+     [:p "id: " loc-id]
+     [:p "x: " x]
+     [:p "y: " y])))
+
+(defn all-locations-page
+  []
+  (let [all-locs (db/get-all-locations)]
+    (page/html5
+     (gen-page-head "All Locations in the db")
+     header-links
+     [:h1 "All Locations"]
+     [:table
+      [:tr [:th "id"] [:th "x"] [:th "y"]]
+      (for [loc all-locs]
+        [:tr [:td (:id loc)] [:td (:x loc)] [:td (:y loc)]])])))
+</code></pre><p>Here we've implemented each function used in <code>handler.clj</code>.</p><p>Again, note that each of the functions with names ending in "-page"
+(the ones being called in <code>handler.clj</code>) is returning just a plain
+string consisting of html markup. In handler.clj's <code>defroutes</code>,
+Compojure is helpfully taking care of placing that into a response
+hashmap for us.</p><p>Rather than clog up this file with database-related calls, we've put
+them all into their own <code>db.clj</code> file (described next).</p><h2 id="create-some-db-access-functions">Create some db access functions</h2><p>Create a <code>src/my_webapp/db.clj</code> file and make it look like:</p><pre><code class="clojure">(ns my-webapp.db
+  (:require [clojure.java.jdbc :as jdbc]))
+
+(def db-spec {:dbtype "h2" :dbname "./my-webapp"})
+
+(defn add-location-to-db
+  [x y]
+  (let [results (jdbc/insert! db-spec :locations {:x x :y y})]
+    (assert (= (count results) 1))
+    (first (vals (first results)))))
+
+(defn get-xy
+  [loc-id]
+  (let [results (jdbc/query db-spec
+                            ["select x, y from locations where id = ?" loc-id])]
+    (assert (= (count results) 1))
+    (first results)))
+
+(defn get-all-locations
+  []
+  (jdbc/query db-spec "select id, x, y from locations"))
+</code></pre><p>Note that <code>jdbc/query</code> returns a seq of maps. Each map
+entry's key is a column name (as a Clojure keyword), and its value is
+the value for that column.</p><p>You'll also notice that we used a plain string in <code>get-all-locations</code>,
+rather than putting it in a vector. <code>java.jdbc</code> allows us to omit the vector
+wrapping when we have a simple SQL query with no parameters.</p><p>Of course, you can try out all these calls yourself in the REPL,
+if you like:</p><pre><code>~/temp/my-webapp$ lein repl
+...
+user=&gt; (require 'my-webapp.db)
+nil
+user=&gt; (ns my-webapp.db)
+nil
+my-webapp.db=&gt; (jdbc/query db-spec
+          #_=&gt;     "select x, y from locations where id = 1")
+({:y 9, :x 8})
+</code></pre><h2 id="run-your-webapp-during-development">Run your webapp during development</h2><p>You can run your webapp via lein:</p><pre><code>lein ring server
+</code></pre><p>It should start up and also open a browser window for you pointed at
+<a href="http://localhost:3000">http://localhost:3000</a>. You should be able to stop the webapp by
+hitting <code>ctrl-c</code>.</p><p>If you don't want it to automatically open a
+browser window, run it like so:</p><pre><code>lein ring server-headless
+</code></pre><h2 id="deploy-your-webapp">Deploy your webapp</h2><p>To make your webapp suitable for deployment, make the following
+changes:</p><h3 id="changes-in-projectclj">Changes in project.clj</h3><p>In your <code>project.clj</code> file:</p><ul><li><p>add to <code>:dependencies</code> (the version should generally match <code>compojure</code>s version):</p><pre><code class="clojure">[ring/ring-jetty-adapter "1.5.1"] ; e.g., for compojure version 1.5.1
+</code></pre></li><li><p>and also add <code>:main my-webapp.handler</code></p></li></ul><h3 id="changes-in-handlerclj">Changes in handler.clj</h3><p>In <code>src/my_webapp/handler.clj</code>:</p><ul><li>in your <code>ns</code> macro:
+<ul><li>add <code>[ring.adapter.jetty :as jetty]</code> to the <code>:require</code>, and</li><li>add <code>(:gen-class)</code> to the end</li></ul></li></ul><p>The <code>ns</code> form should now look like this:</p><pre><code class="clojure">(ns my-webapp.handler
+  (:require [my-webapp.views :as views]
+            [compojure.core :refer :all]
+            [compojure.route :as route]
+            [ring.adapter.jetty :as jetty] ; add this require
+            [ring.middleware.defaults :refer [wrap-defaults site-defaults]])
+  (:gen-class)) ; and add this gen-class
+</code></pre><ul><li><p>and at the bottom, add the following <code>-main</code> function:</p><pre><code class="clojure">(defn -main
+  [&amp; [port]]
+  (let [port (Integer. (or port
+                           (System/getenv "PORT")
+                           5000))]
+    (jetty/run-jetty #'app {:port  port
+                            :join? false})))
+</code></pre></li></ul><h3 id="build-and-run-it">Build and Run it</h3><p>Now create an uberjar of your webapp:</p><pre><code>lein uberjar
+</code></pre><p>And now you can run it directly:</p><pre><code>java -jar target/my-webapp-0.1.0-standalone.jar 8080
+</code></pre><p>(or on whatever port number you wish). If you run the JAR file from another
+folder, remember to copy the <code>my-webapp.mv.db</code> file to that folder!</p><p><em>NOTE: if you did not remove "-SNAPSHOT" from the project's version string
+when you first edited <code>project.clj</code>, then the JAR file will have <code>-SNAPSHOT</code>
+in its name.</em></p><h2 id="see-also">See Also</h2><ul><li>To get a head start with a more "batteries-included" project
+template, see <a href="http://www.luminusweb.net/">Luminus</a>.</li></ul><h2 id="contributors">Contributors</h2><p>John Gabriele <a href="mailto:jmg3000@gmail.com">jmg3000@gmail.com</a> (original author)</p><p>Ivan Kryvoruchko <a href="mailto:gildraug@gmail.com">gildraug@gmail.com</a></p><p>Sean Corfield <a href="mailto:sean@corfield.org">sean@corfield.org</a></p>
+
+    <div id="prev-next">
+        
+        <a href="../eclipse/index.html">&laquo; Starting with Eclipse and Counterclockwise For Clojure Development</a>
+        
+        
+        ||
+        
+        
+        <a href="../parsing_xml_with_zippers/index.html">Parsing XML in Clojure &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/tutorials/eclipse/index.html b/clones/clojure-doc.org/articles/tutorials/eclipse/index.html
new file mode 100644
index 00000000..524dc03d
--- /dev/null
+++ b/clones/clojure-doc.org/articles/tutorials/eclipse/index.html
@@ -0,0 +1,250 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Starting with Eclipse and Counterclockwise For Clojure Development</title>
+    
+
+<meta name="description" content="This guide covers:">
+
+<meta property="og:description" content="This guide covers:">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/tutorials/eclipse/" />
+<meta property="og:title" content="Starting with Eclipse and Counterclockwise For Clojure Development" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/tutorials/eclipse/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Starting with Eclipse and Counterclockwise For Clojure Development</h2>
+    </div>
+    
+    <p>This guide covers:</p><ul><li>Installing Eclipse</li><li>Installing Counterclockwise, the Clojure plugin for Eclipse</li><li>Creating a sample project</li></ul><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons Attribution 3.0 Unported License</a>
+(including images &amp; stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on Github</a>.</p><h2 id="what-version-of-clojure-does-this-guide-cover">What Version of Clojure Does This Guide Cover?</h2><p>This guide covers Clojure 1.4.</p><h2 id="installing-eclipse">Installing Eclipse</h2><ol><li>Download the latest release of Eclipse from the <a href="http://www.eclipse.org/downloads/packages/eclipse-ide-java-developers/junor">official site</a>.</li><li>Install Counterclockwise plugin.
+<ol><li>navigate to the "Install new Software" tab under the help menu</li><li>paste in the CCW update URL: http://ccw.cgrand.net/updatesite in the "Work with:" text field</li><li>check the "Clojure Programming" checkbox and hit the "Next" button</li></ol></li><li>Follow the instructions on the screen and restart Eclipse for changes to take effect.</li></ol><p>Counterclockwise takes care of setting up Clojure and Leiningen for you. And once the plugin is installed, you will be
+able to create a new Clojure project or a new Leiningen project.</p><p>Clojure project will use Eclipse to manage dependencies, while the Leiningen project will pull dependencies from the
+<code>project.clj</code> in the root folder of the project.</p><p>At this point you should have Eclipse with CCW up and running. Navigate to File-&gt;new-&gt;project in Eclipse menu.
+Then select Leiningen-&gt;Leiningen project. Here you'll see the default Leiningen Template filled in.
+And only thing you have to do is provide a project name. Give the project a name and hit the finish button.</p><p>You should now see a new project in your Package Explorer view on the left. If you created a project called
+<code>myproject</code> then the project template will have a src folder which will contain the package folder named myproject.</p><p>Note that since Java cannot use dashes in names, all the dashes in package folders for namespaces get converted to underscores.
+The package will contain a core.clj file, and its contents should look like the following:</p><pre><code class="clojure">(ns myproject.core)
+
+(defn foo
+  "I don't do a whole lot."
+  [x]
+  (println x "Hello, World!"))
+</code></pre><p>Let's open it and then hit the run button. You should see a REPL pop up momentarily on the bottom of the IDE.
+If all went well, your project should be ready to work on (if it failed, see the <a href="index.html#troubleshooting">troubleshooting section</a>). The code that's in the file will have already been
+loaded up in the REPL when we hit run, and we should now be able to call our foo function.</p><p>To do that, let's write the code which calls foo below it:</p><pre><code class="clojure">(foo "Test: ")
+</code></pre><p>Then navigate the cursor inside the call body and hit CTRL+ENTER on Linux/Windows or CMD+ENTER on OS X.
+You should see "Hello, World!" printed in the REPL view on the bottom. We can now change the behavior of the
+<code>foo</code> function and after reloading it the new behavior will be available next time it's called.</p><p>It's also recommended to enable the "strict/paredit" mode under Preferences-&gt;Clojure-&gt;Editor section.
+This will allow the editor to keep track of balancing the parens for you.</p><p>Another useful feature of the editor is the ability to select code by expression.
+If you navigate inside a function and press ALT+SHIFT+UP (use CMD instead of ALT in OS X), then inner
+body of the expression will be selected, pressing it again, will select the expression, and then the outer body,
+and so on. Conversely pressing ALT+SHIFT+DOWN will narrow the selection. This allows you to quickly navigate nested
+structures, and select code by chunks of logic as opposed to simply selecting individual lines.</p><h2 id="managing-dependencies">Managing dependencies</h2><h3 id="eclipse-dependencies">Eclipse Dependencies</h3><ol><li>Right click on the project navigate to properties.</li><li>Under properties select "Java Build Path"</li><li>Under Libraries select "Add External JARs..."</li><li>Click OK</li></ol><p>The library will show up under "Referenced Libraries" in Package Explorer.</p><h3 id="leiningen">Leiningen</h3><p>You will also see a <code>project.</code>clj` file in the root of the project. This file should look like the following:</p><pre><code class="clojure">(defproject myproject "0.1.0-SNAPSHOT"
+  :description "FIXME: write description"
+  :url "http://example.com/FIXME"
+  :license {:name "Eclipse Public License"
+            :url "http://www.eclipse.org/legal/epl-v10.html"}
+  :dependencies [[org.clojure/clojure "1.4.0"]])
+</code></pre><p>You can add new dependencies to your project by adding them to the dependencies vector.
+For example, if we wanted to add an HTTP client, head to <a href="http://clojuresphere.herokuapp.com/">ClojureSphere</a>
+and navigate to the clj-http page.</p><p>From there follow the link to Clojars and copy the following:</p><pre><code class="clojure">[clj-http "0.6.4"]
+</code></pre><p>now we'll simply paste it under dependencies in our <code>project.clj</code>:</p><pre><code class="clojure">:dependencies [[org.clojure/clojure "1.4.0"]
+               [clj-http "0.6.4"]]
+</code></pre><p>In the package explorer view on the left expand "Leiningen dependencies"
+and see that the clj-http jar included there. You will now have to kill our current REPL
+if it is running. To do that navigate to the terminal view next to it and press the stop button.
+When we start a new instance of the REPL, the library will be available for use.</p><p>In the core file we can now require the library in the namespace definition:</p><pre><code class="clojure">(ns myproject.core
+  (:require [clj-http.client :as client]))
+</code></pre><p>and test using the client by typing</p><pre><code class="clojure">(client/get "http://google.com")
+</code></pre><p>and running it as we did earlier.</p><h2 id="troubleshooting">Troubleshooting</h2><p>If when you attempt to run your code for the first time, you are asked
+to select a way to run your project, rather than it just running, you
+can try right clicking on the root project folder and then selecting
+Leiningen-&gt;Reset Project Configuration.</p>
+
+    <div id="prev-next">
+        
+        <a href="../vim_fireplace/index.html">&laquo; Clojure with Vim and fireplace.vim</a>
+        
+        
+        ||
+        
+        
+        <a href="../basic_web_development/index.html">Basic Web Development &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/tutorials/emacs/index.html b/clones/clojure-doc.org/articles/tutorials/emacs/index.html
new file mode 100644
index 00000000..79b80931
--- /dev/null
+++ b/clones/clojure-doc.org/articles/tutorials/emacs/index.html
@@ -0,0 +1,445 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Clojure with Emacs</title>
+    
+
+<meta name="description" content="This work is licensed under a Creative Commons
+Attribution 3.0 Unported License (including images &amp;
+stylesheets). The source is available on
+Github.What Version of Clojure Does This Guide Cover?">
+
+<meta property="og:description" content="This work is licensed under a Creative Commons
+Attribution 3.0 Unported License (including images &amp;
+stylesheets). The source is available on
+Github.What Version of Clojure Does This Guide Cover?">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/tutorials/emacs/" />
+<meta property="og:title" content="Clojure with Emacs" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/tutorials/emacs/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Clojure with Emacs</h2>
+    </div>
+    
+    <p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons
+Attribution 3.0 Unported License</a> (including images &amp;
+stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on
+Github</a>.</p><h2 id="what-version-of-clojure-does-this-guide-cover">What Version of Clojure Does This Guide Cover?</h2><p>This guide covers Clojure 1.5+ and Emacs 24+ for MS Windows and Linux,
+and Emacs 26+ for macOS. Earlier Clojure and Emacs releases
+are not supported by these instructions.</p><h2 id="overview">Overview</h2><p>Emacs has traditionally been one of the best development environments
+for functional languages and Lisps in particular. This guide will
+explain how to get it installed, and give an example of a basic
+workflow to use while developing a simple library.</p><h2 id="installing-emacs">Installing Emacs</h2><h3 id="macos">macOS</h3><p>The easiest way to get going with Emacs on macOS is to
+use <a href="https://brew.sh">Homebrew</a>. Instructions for installing Homebrew
+are provided on the landing page, and requirements (such as Xcode) are
+listed on the <a href="https://docs.brew.sh/Installation">installation details</a>
+page.</p><p>Once brew is installed, you can install Emacs using:</p><pre><code class="bash">$ brew cask install emacs
+</code></pre><p>This will install Emacs into your <code>/Applications/Emacs.app</code> folder and
+provide a symlink to the application as <code>/usr/local/bin/emacs</code>.</p><p>After installing, Emacs can be launched the same as other Mac applications
+<em>or</em> from the terminal via:</p><pre><code class="bash">$ emacs
+</code></pre><h3 id="debianubuntu">Debian/Ubuntu</h3><p>Newer Debian-based systems (post-wheezy) ship Emacs 24 in apt:</p><pre><code class="bash">$ sudo apt install emacs24
+</code></pre><h3 id="archantergos">Arch/Antergos</h3><p>The latest version of Emacs(<em>i.e.</em> v25.1) is available in Arch's official repositories.</p><pre><code class="bash">$ sudo pacman -S emacs
+</code></pre><p>On older systems you can add unofficial package sources for <code>emacs-snapshot</code>,
+either for <a href="http://emacs.naquadah.org/">Debian</a> or
+<a href="https://launchpad.net/~cassou/+archive/emacs">Ubuntu</a>.</p><h3 id="ms-windows">MS Windows</h3><p>You can find Emacs for Windows in the <a href="http://ftp.gnu.org/pub/gnu/emacs/windows/">FSF FTP
+directory</a>.</p><p>Download the file named <code>emacs-24.1-bin-i386.zip</code> and unzip it in a new folder.
+Avoid folder with spaces in their names such as <code>C:\Documents and Settings</code>.
+Prefer folder names such as <code>C:\emacs-24.1</code>.</p><p><a href="http://support.microsoft.com/kb/310519#tocHeadRef">Create an environment variable</a>
+with name HOME and value equal to the location of your home folder; in Windows
+XP, it's <code>C:\Documents and Settings\YourUsername</code>, in Windows 7, it's
+<code>C:\Users\YourUsername</code>. With this variable set, you can use the tilde character
+(<code>~</code>) to type the name of a file under your home folder and Emacs will expand
+its full path.</p><p>The following section describes Emacs configuration using the folder <code>.emacs.d</code>.
+When using Emacs in Windows, you should create this folder under your home
+folder. In Windows XP, that will be the folder <code>C:\Documents and Settings\YourUsername\.emacs.d</code>; in Windows 7, that will be the folder
+<code>C:\Users\YourUsername\.emacs.d</code>.</p><h2 id="configuring-emacs">Configuring Emacs</h2><p>So Emacs is installed, but running it now would be a somewhat
+barebones experience and not particularly useful for Clojure
+development.</p><h3 id="manual-setup">Manual setup</h3><p>Emacs can be configured through a folder in your home folder called
+<a href="http://www.emacswiki.org/emacs/DotEmacsDotD">~/.emacs.d</a>, and
+configuration options are pretty much endless. To help you through
+this, Phil Hagelberg has created a small library enables a few
+non-intrusive helpful features called
+<a href="https://github.com/technomancy/better-defaults">better-defaults</a>
+which might be useful if you are not already an Emacs pro.</p><p>Most Emacs packages are kept at <a href="http://melpa.milkbox.net">MELPA</a>,
+the community package host. Add this code to your config in
+<code>~/.emacs.d/init.el</code> to tell Emacs to look there:</p><p>For the stable repository:</p><pre><code class="cl">(require 'package)
+(add-to-list 'package-archives
+             '("melpa-stable" . "http://stable.melpa.org/packages/") t)
+(package-initialize)
+</code></pre><p>For the latest packages:</p><pre><code class="cl">(require 'package)
+(add-to-list 'package-archives
+             '("melpa" . "http://melpa.org/packages/") t)
+(package-initialize)
+</code></pre><p>Run <code>M-x package-refresh-contents</code> to pull in the package listing.</p><p><code>M-x</code> means <code>meta-x</code>, and meta is mapped to the alt key on most keyboards,
+though Mac OS X usually maps it to the command key.</p><p>You'll need to install the following packages:</p><ul><li><a href="https://github.com/clojure-emacs/clojure-mode">clojure-mode</a> - a major mode for editing Clojure and ClojureScript code</li><li><a href="https://github.com/clojure-emacs/cider">CIDER</a> - a Clojure interactive development environment and REPL for Emacs</li><li><a href="https://github.com/bbatsov/projectile">projectile</a>(optional) - for navigating inside your projects swiftly</li></ul><p>Before continuing any further you should briefly consult their documentation.</p><p>You can either install each package one-by-one with <code>M-x package-install</code> or specify all your packages in Emacs Lisp as part of
+your configuration file. This is helpful if you take your dotfiles to
+a new machine; you don't have to remember everything you've installed
+by hand.</p><pre><code class="cl">(defvar my-packages '(better-defaults
+                      projectile
+                      clojure-mode
+                      cider))
+
+(dolist (p my-packages)
+  (unless (package-installed-p p)
+    (package-install p)))
+</code></pre><p>Put the code above in <code>~/.emacs.d/init.el</code> and run it with <code>M-x eval-buffer</code>.</p><p>A lot of warnings will likely whizz by as it installs and compiles
+packages. Unless you have any actual <em>errors</em> this is all fine.</p><p>To look at the other packages available for installation you can
+invoke <code>M-x package-list-packages</code>. To manually install a package,
+move the point to line of the package with the keyboard and press 'i'
+for 'install'. After selecting all the packages you are interested in,
+press 'x' for 'eXecute' to install.</p><h3 id="preconfigured-setup">Preconfigured setup</h3><p>There are also some ready-made Emacs configurations that are optimized
+for Clojure development -
+<a href="https://github.com/bbatsov/prelude">Prelude</a>(developed by the
+maintainer of CIDER and clojure-mode) and
+<a href="https://github.com/overtone/emacs-live">Emacs Live</a>.</p><p>If you want a more powerful Emacs setup you should definitely check them out.</p><h3 id="basics">Basics</h3><p>The first thing you should do without question, is to go through the
+built-in Emacs tutorial. To do this press <code>C-h t</code> or hold down Control
+and press <code>h</code> and then press <code>t</code> by itself.</p><p>With that in mind, these are the basic keystrokes you're going to be
+using most often with the default binary of Emacs 24+:</p><pre><code>File/buffer/window commands
+C-x C-f     Find file
+C-x C-s     Save buffer
+C-x s       Save file (like save-as)
+C-x b       Switch buffer
+C-x k       Kill buffer
+C-x 1       Delete other windows
+C-x 0       Delete current window
+C-x 2       Split window horizontally
+C-x 3       Split window vertically
+
+Movement commands
+C-a         Beginning of line
+C-e         End of line
+C-n         Next line (down)
+C-p         Previous line (up)
+C-b         Back (left)
+C-f         Forward (right)
+M-f         Forward a word
+M-b         Back a word
+C-v         Forward a page
+M-v         Back a page
+
+Edit commands
+C-d         Kill character
+M-d         Kill word
+M-delete    Kill word backwards
+
+Misc commands
+C-s         Regex search forwards
+C-r         Regex search backwards
+M-%         Query replace
+</code></pre><p>I should also mention the help commands:</p><pre><code>C-h t     Tutorial (goes over the basics)
+C-h b     Describe all current key bindings
+C-h m     Describe the current mode
+C-h a     Apropos - search the help for a term
+C-h k     Describe key
+</code></pre><p>I recommend going through the tutorial at least once as it will give
+you a good understanding of the navigation and movement commands.
+Another useful command you will use a lot is <code>M-x</code> which allows you to
+run any command. And there are a LOT. Apropos is very useful for
+searching for something <code>C-h a</code>.</p><p>So after doing the tutorial (you did do that, RIGHT? O_O) you can move
+around, open files, save files, etc., and are generally comfortable at
+the basics. There is an almost infinite amount of things to learn
+about Emacs, but those basics will get you a long way.</p><h2 id="creating-a-project">Creating a project</h2><p>Let's go through the process of creating a small sample clojure project
+and illustrate how Emacs helps makes us champions in the land of lisp.</p><p>The project we will be building is a trivially simple command line
+parser that will take the argument pairs given to it and turn them
+into a map of key-value pairs. The functionality is irrelevant and not
+particularly useful. It serves purely to illustrate the development
+flow.</p><p>If you don't have <a href="http://leiningen.org">Leiningen</a> yet, get it
+installed and then use it to create a new project:</p><pre><code class="bash">$ lein new command-line-args
+$ cd command-line-args
+</code></pre><p>Take a look at the project structure:</p><pre><code>+ doc
+  - intro.md
+- project.clj
+- README.md
++ src
+  + command_line_args
+    - core.clj
++ test
+  + command_line_args
+    - core_test.clj
+</code></pre><p>Should be fairly self-explanatory, though Leiningen's built-in tutorial
+(available via <code>lein help tutorial</code>) provides a detailed explanation of
+the project structure.</p><p>Let's start up a live REPL session.</p><pre><code>M-x cider-jack-in
+</code></pre><p>This should open up a new window looking at our <code>*cider-repl*</code> buffer.</p><p>First thing to do is add a simple test (in fact the only test we will
+be adding because by default, we get it right first time). Open the
+<code>core_test.clj</code> file inside of the test folder. Replace the test that
+is there with the following:</p><pre><code class="clojure">(deftest pairs-of-values
+   (let [args ["--server" "localhost"
+               "--port" "8080"
+               "--environment" "production"]]
+      (is (= {:server "localhost"
+              :port "8080"
+              :environment "production"}
+             (parse-args args)))))
+</code></pre><p>We are simply assigning a list of arguments as they would arrive from
+the command line to a local called args, and asserting that the
+return value from a function called <code>parse-args</code> is equal to those
+command line args turned into a simple map.</p><p>Compile the file with <code>C-c C-k</code>(<code>M-x cider-load-buffer</code>). We should get an error
+message at the bottom of the emacs window complaining that clojure can't find
+parse-args.  Let's try to fix the exception by opening <code>core.clj</code> (<code>C-x C-f</code>/<code>M-x find-file</code>) and adding the following definition:</p><pre><code class="clojure">(defn parse-args [args]
+  {})
+</code></pre><p>Compile this with <code>C-c C-k</code>, save it (<code>C-x C-s</code>/<code>M-x save-buffer</code>), switch back
+to the test buffer (<code>C-x b RET</code>/<code>M-x switch-to-buffer RET</code>) and try compiling
+again (<code>C-c C-k</code>). This time it will succeed, so try running the tests with
+<code>C-c C-t t</code>(<em>i.e</em> <code>M-x cider-test-run-test</code>) and you should get a test report
+buffer showing some failure information:</p><pre><code class="clojure">(not (= {:server "localhost",
+         :port "8080",
+         :environment "production"}
+        {}))
+</code></pre><p>Anyway, our map was empty as expected. Let's fix that:</p><pre><code class="clojure">(defn parse-args [args]
+  (apply hash-map args))
+</code></pre><p>Running our tests again we now get another error:</p><pre><code class="clojure">(not (= {:server "localhost",
+         :port "8080",
+         :environment "production"}
+        {"--port" "8080",
+         "--server" "localhost",
+         "--environment" "production"}))
+</code></pre><p>Whoops, our keys are just strings with the dashes still in place. We
+need to strip those off and turn them into keywords:</p><pre><code class="clojure">(defn parse-args [args]
+  (into {} (map (fn [[k v]] [(keyword (.replace k "--" "")) v])
+                (partition 2 args))))
+</code></pre><p>And re-running the tests in the test buffer we are all happy. If we
+had multiple test files we can run them all from the CLI using:</p><pre><code class="bash">$ lein test
+</code></pre><p>Re-running all the tests from Leiningen can be a good sanity check
+before you wrap up work on a feature or branch since there are some
+cases where developing from a REPL can give misleading results. For
+instance, if you delete a function definition but still call it from
+other functions, you won't notice until your process is restarted.</p><p>So that is an extremely simple example of a workflow using Emacs with
+<code>clojure-mode</code> and <code>cider-test</code>.</p><h2 id="using-the-repl">Using the REPL</h2><p>One thing we haven't looked at is how useful having an open running
+REPL in Emacs can be for development. If you still have your project
+open, split the window (<code>C-x 2</code> (horizontally) or <code>C-x 3</code> (vertically)) in
+two so you have the <code>core.clj</code> and <code>*cider-repl*</code> buffers open.
+Let's say you are editing the core.clj and you want to play around with
+the functions as you define them. Looking at <code>parse-args</code> you have
+decided you want to pull out the anonymous function to be a named
+function <code>keywordize</code>.</p><p>First load and compile the buffer into the REPL process with <code>C-c C-k</code>. Change the namespace of the REPL buffer to the one of the file
+you're in with <code>C-c M-n</code>. Now switch to the REPL window with <code>C-x o</code>.</p><p>You now have access to the functions in this namespace that were
+defined when you compiled the file. Try it:</p><pre><code>command-line-args.core&gt; (parse-args '("key" "value"))
+{:key "value"}
+</code></pre><p>Let's go ahead and create our new function in <code>core.clj</code>:</p><pre><code class="clojure">(defn keywordize [kvp]
+  (let [[k v] kvp]
+    [(keyword (.replace k "--" "")) v]))
+
+(defn parse-args [args]
+  (into {} (map keywordize (partition 2 args))))
+</code></pre><p>Now we have a couple of options, we could re-compile the whole file again
+(<code>C-c C-k</code>) or we could evaluate each function on its own by going to the end
+of the s-exp and using <code>C-x C-e</code>(<em>i.e.</em> <code>cider-eval-last-sexp</code>) which sends the
+s-exp to the running REPL. Now switching back to the core.clj namespace
+(<code>C-c M-n</code>) and switching back to the REPL buffer we can try out our
+<code>keywordize</code> function:</p><pre><code>command-line-args.core&gt; (keywordize ["--oh" "hai"])
+[:oh "hai"]
+</code></pre><p>If your REPL is starting to get cluttered you can <code>M-x cider-repl-clear-buffer</code>
+to clear by first switching to the REPL buffer. The ability to continually
+change the code and play around with it is one of the things that makes Emacs
+and a lisp a great combination for development.</p><p>If you find yourself wanting to repeat a command you just typed at the
+REPL, you can use <code>M-p</code> scroll back through history and <code>M-n</code> to go
+forwards. Also, all of the Emacs editing commands are available in the
+REPL, which is great.</p><p>A handy clojure function to use in the REPL is <code>clojure.repl/doc</code> which
+gives you the docstring for a given function:</p><pre><code>command-line-args.core&gt; (use 'clojure.repl)
+nil
+command-line-args.core&gt; (doc println)
+-------------------------
+clojure.core/println
+([&amp; more])
+  Same as print followed by (newline)
+nil
+</code></pre><p>However there is a shortcut <code>C-c C-d d</code> when your cursor is over a
+function name. This will show the Clojure (or Javadoc) doc in a new window. If
+instead you want to jump to the source of the function you can use
+<code>M-.</code>, which is awesome. This works on your own functions as well as
+those which come from third-party libraries. Use <code>M-,</code> to pop the
+stack and return to where you were. For all the definitions in a
+single file you can use <code>M-x imenu</code> to list them and jump to one.</p><p>When you are finished with the REPL (or if for some reason it has
+gotten into a bad state), you can simply kill the <code>*cider-repl*</code>
+buffer by typing <code>M-x cider-quit</code> and re-run <code>cider-jack-in</code> to start another.</p><h2 id="appendix">Appendix</h2><p><a href="http://stable.melpa.org/#/getting-started">MELPA documentation</a></p><p>CIDER keyboard shortcuts can be found in <a href="https://github.com/clojure-emacs/cider#keyboard-shortcuts">CIDER documentation</a>.</p><h2 id="contributors">Contributors</h2><p><a href="http://blog.gaz-jones.com">Gareth Jones</a>, 2012 (original author)</p><p>Thanks to <a href="http://technomancy.us/">Phil Hagelberg</a>, <a href="http://cleancode.se/">Mikael
+Sundberg</a>, and <a href="http://jakemccrary.com/">Jake
+McCrary</a> for suggestions for improvements to
+the original blog posts from which this guide was created.</p>
+
+    <div id="prev-next">
+        
+        <a href="../introduction/index.html">&laquo; Introduction to Clojure</a>
+        
+        
+        ||
+        
+        
+        <a href="../vim_fireplace/index.html">Clojure with Vim and fireplace.vim &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/tutorials/getting_started/index.html b/clones/clojure-doc.org/articles/tutorials/getting_started/index.html
new file mode 100644
index 00000000..58af1462
--- /dev/null
+++ b/clones/clojure-doc.org/articles/tutorials/getting_started/index.html
@@ -0,0 +1,256 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Getting Started with Clojure</title>
+    
+
+<meta name="description" content="This guide covers:">
+
+<meta property="og:description" content="This guide covers:">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/tutorials/getting_started/" />
+<meta property="og:title" content="Getting Started with Clojure" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/tutorials/getting_started/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Getting Started with Clojure</h2>
+    </div>
+    
+    <p>This guide covers:</p><ul><li>prerequisites (such as Leiningen) and installing</li><li>running the REPL</li><li>creating a project</li><li>interactive development</li></ul><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons
+Attribution 3.0 Unported License</a> (including images &amp;
+stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on
+Github</a>.</p><h2 id="overview">Overview</h2><p>Clojure is a wonderfully simple language and you are going to love
+it.</p><p>To quickly get started, first make sure you've got Java installed.</p><p>Then install the <a href="http://leiningen.org/">Leiningen</a> project management
+tool.</p><blockquote><p>This author (jg) recommends always installing by downloading the
+script directly (as described in the instructions at leiningen.org),
+rather than using your OS's package manager. This will ensure that
+you get the latest lein version 2.</p></blockquote><p>Clojure programs are typically developed inside their own project
+directory, and Leiningen manages projects for you. Lein takes care of
+pulling in dependencies (including Clojure itself), running the REPL,
+running your program and its tests, packaging your program for
+distribution, and other administrative tasks. Run <code>lein help</code> to
+see the list of all the tasks in can perform.</p><blockquote><p>Again, there's no need to "install" Clojure, per se. Lein
+will take care of fetching it for you.</p></blockquote><h2 id="trying-out-the-repl">Trying out the REPL</h2><p>Although lein facilitates managing your projects, you can also run it
+on its own (outside of any particular project directory). Once you
+have the <code>lein</code> tool installed, run it from anywhere you like to get a
+repl:</p><pre><code>$ lein repl
+</code></pre><p>You should be greeted with a "<code>user=&gt;</code>" prompt. Try it out:</p><pre><code class="clojure">user=&gt; (+ 1 1)
+;; ⇒ 2
+user=&gt; (distinct [:a :b :a :c :a :d])
+;; ⇒ (:a :b :c :d)
+user=&gt; (dotimes [i 3]
+  #_=&gt;   (println (rand-nth ["Fabulous!" "Marvelous!" "Inconceivable!"])
+  #_=&gt;            i))
+;; Marvelous! 0
+;; Inconceivable! 1
+;; Fabulous! 2
+;; ⇒ nil
+</code></pre><h2 id="your-first-project">Your first project</h2><p>Create your first Clojure program like so:</p><pre><code class="bash">lein new app my-proj
+cd my-proj
+# Have a look at the "-main" function in src/my_proj/core.clj.
+lein run
+</code></pre><p>and see the output from that <code>println</code> function call in
+my_proj/core.clj!</p><h2 id="interactive-development">Interactive Development</h2><p>In your project directory, start up a repl (<code>lein repl</code>) and
+run your <code>-main</code> function to see its output in the repl:</p><pre><code>$ lein repl
+...
+my-proj.core=&gt; (-main)
+Hello, World!
+nil
+</code></pre><p>(The prompt is now "my-proj.core=&gt;" instead of "user=&gt;" because lein
+has started the repl in an app project. More about that ("namespaces")
+in the topical guides.)</p><p>From elsewhere, open up your my-proj/src/my_proj/core.clj file
+in your editor. Modify the text in that <code>println</code> call.</p><p>Back in the repl, reload your source file and run <code>-main</code> again:</p><pre><code>my-proj.core=&gt; (require 'my-proj.core :reload)
+my-proj.core=&gt; (-main)
+</code></pre><p>to see your changes.</p><h2 id="see-also">See Also</h2><p>Other getting started documentation you might find useful:</p><ul><li><a href="http://yogthos.github.io/ClojureDistilled.html">Clojure Distilled</a>:
+introduction to core concepts necessary for working with Clojure</li><li><a href="http://www.unexpected-vortices.com/clojure/brief-beginners-guide/index.html">A Brief Beginner's Guide to
+Clojure</a>:
+contains a bit more overview and background material for learning your way
+around the landscape.</li><li><a href="https://cemerick.com/blog/2012/05/02/starting-clojure-mk-2.html">Starting Clojure screencast</a>:
+an extensive getting-started screencast using Eclipse to develop a webapp project.</li></ul><h2 id="next-stop">Next Stop</h2><p>Next stop: <a href="../introduction/index.html">the basic Clojure language tutorial</a>.</p><h2 id="contributors">Contributors</h2><p>John Gabriele <a href="mailto:jmg3000@gmail.com">jmg3000@gmail.com</a> (original author)</p>
+
+    <div id="prev-next">
+        
+        <a href="../../content/index.html">&laquo; Table of Contents</a>
+        
+        
+        ||
+        
+        
+        <a href="../introduction/index.html">Introduction to Clojure &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/tutorials/growing_a_dsl_with_clojure/index.html b/clones/clojure-doc.org/articles/tutorials/growing_a_dsl_with_clojure/index.html
new file mode 100644
index 00000000..d828d2a0
--- /dev/null
+++ b/clones/clojure-doc.org/articles/tutorials/growing_a_dsl_with_clojure/index.html
@@ -0,0 +1,385 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Growing a DSL with Clojure</title>
+    
+
+<meta name="description" content="Lisps like Clojure are well suited to creating rich DSLs that integrate seamlessly into the language.You may have heard Lisps boasting about code being data and data being code. In this article we will define a DSL that benefits handsomely from this fact.">
+
+<meta property="og:description" content="Lisps like Clojure are well suited to creating rich DSLs that integrate seamlessly into the language.You may have heard Lisps boasting about code being data and data being code. In this article we will define a DSL that benefits handsomely from this fact.">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/tutorials/growing_a_dsl_with_clojure/" />
+<meta property="og:title" content="Growing a DSL with Clojure" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/tutorials/growing_a_dsl_with_clojure/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Growing a DSL with Clojure</h2>
+    </div>
+    
+    <p>Lisps like Clojure are well suited to creating rich DSLs that integrate seamlessly into the language.</p><p>You may have heard Lisps boasting about code being data and data being code. In this article we will define a DSL that benefits handsomely from this fact.</p><p>We will see our DSL evolve from humble beginnings, using successively more of Clojure’s powerful and unique means of abstraction.</p><h2 id="the-mission">The Mission</h2><p>Our goal will be to define a DSL that allows us to generate various scripting languages. The DSL code should look similar to regular Clojure code.</p><p>For example, we might use this Clojure form to generate either Bash or Windows Batch script output:</p><p>Input (Clojure form):</p><pre><code class="clojure">(if (= 1 2)
+  (println "a")
+  (println "b"))
+</code></pre><p>Output (Bash script):</p><pre><code class="sh">if [ 1 -eq 2 ]; then
+  echo "a"
+else
+  echo "b"
+fi
+</code></pre><p>Output (Windows Batch script):</p><pre><code class="bat">IF 1==2 (
+  ECHO a
+) ELSE (
+  ECHO b
+)
+</code></pre><p>We might, for example, use this DSL to dynamically generate scripts to perform maintenance tasks on server farms.</p><h2 id="baby-steps-mapping-to-our-domain-language">Baby Steps: Mapping to Our Domain Language</h2><p>I like Bash, so let’s start with a Bash script generator.</p><p>To start, we need to expose some parallels between Clojure’s core types and our domain language.</p><p>So which Clojure types have simple analogues in Bash script?</p><p>Strings and numbers should just simply return their String representation, so we will start with those.</p><p>Let’s define a function <code>emit-bash-form</code> that takes a Clojure form and returns a string that represents the equivalent Bash script.</p><pre style="visibility:hidden; height:0;"><code class="klipse-clojure nohighlight">
+(require '[chivorcam.core :refer [defmacro defmacfn]])
+</code></pre><pre><code class="klipse-clojure nohighlight">(defn emit-bash-form [a]
+  "Returns a String containing the equivalent Bash script
+  to its argument."
+  (cond
+    (string? a ) a
+    (number? a) (str a)
+    :else (throw (ex-info "Fell through" a))))
+</code></pre><p>The <code>cond</code> expression handles cases for strings and numbers or throws an exception.</p><pre><code class="klipse-clojure nohighlight">(emit-bash-form 1)
+</code></pre><pre><code class="klipse-clojure nohighlight">(emit-bash-form "a")
+</code></pre><pre><code class="klipse-clojure nohighlight">(emit-bash-form {})
+</code></pre><p>Now if we want to add some more dispatches, we just need to add a new clause to our <code>cond</code> expression.</p><h2 id="echo-and-print">Echo and Print</h2><p>Let’s add a feature.</p><p>Bash prints to the screen using <code>echo</code>. You’ve probably seen it if you’ve spent any time with a Linux shell.</p><pre><code class="sh">ambrose@ambrose-desktop&gt; echo asdf
+asdf
+</code></pre><p>clojure.core also contains a function <code>println</code> that has similar semantics to Bash's <code>echo</code>.</p><pre><code class="klipse-clojure nohighlight">(println "asdf")
+</code></pre><p>Wouldn’t it be cool if we could pass <code>(println "a")</code> to <code>emit-bash-form</code>?</p><pre><code class="clojure">(emit-bash-form (println "asdf"))
+</code></pre><p>At first, this seems like asking the impossible.</p><p>To made an analogy with Java, imagine calling this Java code and expecting the first argument to equal <code>System.out.println("asdf")</code>.</p><pre><code class="java">foo( System.out.println("asdf") );
+</code></pre><p>(Let’s ignore the fact that <code>System.out.println(...)</code> returns a void).</p><p>Java evaluates the arguments before you can even blink, resulting in a function call to println. How can we stop this evaluation and return the raw code?</p><p>Indeed this is an impossible task in Java. Even if this were possible, what could we expect do with the raw code?(!)</p><p><code>System.out.println("asdf")</code> is not a Collection, so we can’t iterate over it; it is not a <code>String</code>, so we can’t partition it with regular expressions.</p><p>Whatever "type" the raw code <code>System.out.println("asdf")</code> has, it’s not meant to be known by anyone but compiler writers.</p><p>Lisp turns this notion on its head.</p><h2 id="lisp-code-is-data">Lisp Code Is Data</h2><p>A problem with raw code forms in Java (assuming it is possible to extract them) is the lack of facilities to interrogate them. How does Clojure get around this limitation?</p><p>To get to the actual raw code at all, Clojure provides a mechanism to stop evaluation via quote. Prepending a quote to a code form prevents its evaluation and returns the raw Clojure form.</p><pre><code class="klipse-clojure nohighlight">'(println "a")
+</code></pre><p>So what is the type of our result?</p><pre><code class="klipse-clojure nohighlight">(type '(println "a"))
+</code></pre><p>It's a list!</p><p>We can now interrogate the raw code as if it were any old Clojure list (because it is!).</p><pre><code class="klipse-clojure nohighlight">(first '(println "a"))
+</code></pre><pre><code class="klipse-clojure nohighlight">(second '(println "a"))
+</code></pre><p>This is a result of Lisp’s remarkable property of code being data.</p><h2 id="a-little-closer-to-clojure">A Little Closer to Clojure</h2><p>Using quote, we can get halfway to a DSL that looks like Clojure code.</p><pre><code class="clojure">(emit-bash-form
+  '(println "a"))
+</code></pre><p>Let’s add this feature to <code>emit-bash-form</code>. We need to add a new clause to the <code>cond</code> form. Which type should the dispatch value be?</p><p>So let’s add a clause for lists.</p><pre><code class="klipse-clojure nohighlight">(defn emit-bash-form [a]
+  "Returns a String containing the equivalent Bash script
+  to its argument."
+  (cond
+    (list? a) 
+    (case (name (first a))
+      "println" (str "echo " (second a)))
+
+    (string? a) a
+    (number? a) (str a)
+    :else (throw (ex-info "Fell through" a))))
+</code></pre><p>As long as we remember to quote the argument, this is not bad.</p><pre><code class="klipse-clojure nohighlight">(emit-bash-form '(println "a"))
+</code></pre><pre><code class="klipse-clojure nohighlight">(emit-bash-form '(println "hello"))
+</code></pre><h2 id="multimethods-to-abstract-the-dispatch">Multimethods to Abstract the Dispatch</h2><p>We’ve made a good start, but I think it’s time for some refactoring.</p><p>Currently, to extend our implementation we add to our function emit-bash-form. Eventually this function will be too large to manage; we need a mechanism to split this function into more manageable pieces.</p><p>Essentially emit-bash-form is dispatching on the type of its argument. This dispatch style is a perfect fit for an abstraction Clojure provides called a multimethod.</p><p>Let’s define a multimethod called <code>emit-bash</code>.</p><p>The multimethod handles dispatch in a similar way to <code>cond</code>, but without having to actually write each case. Let’s compare this multimethod with our previous <code>cond</code> expression. <code>defmulti</code> is used to create a new multimethod, and associates it with a dispatch function.</p><pre><code class="klipse-clojure nohighlight">(defmulti emit-bash
+          (fn [form]
+            (cond
+              (list? form) :list
+              (string? form) :string
+              (number? form) :number
+              :else (throw (ex-info "Unknown type" form)))))
+</code></pre><p><code>defmethod</code> is used to add <em>methods</em> to an existing multimethod. Here <code>:string</code> is the <em>dispatch value</em>, and the method returns the form as is.</p><pre><code class="klipse-clojure nohighlight">(defmethod emit-bash
+  :string
+  [form]
+  form)
+</code></pre><p>Similar for numbers and lists:</p><pre><code class="klipse-clojure nohighlight">(defmethod emit-bash
+  :number
+  [form]
+  (str form))
+
+(defmethod emit-bash
+  :list
+  [form]
+  (case (name (first form))
+    "println" (str "echo " (second form))))
+</code></pre><p>Adding new methods has the same result as extending our <code>cond</code> expression, except:</p><ul><li>multimethods handle the dispatch, instead of writing it manually</li><li>anyone can extend the multimethod at any point, without disturbing existing code</li></ul><p>So how can we use <code>emit-bash</code>? Calling a multimethod is just like calling any Clojure function.</p><pre><code class="klipse-clojure nohighlight">(emit-bash '(println "a"))
+</code></pre><p>The dispatch is silently handled under the covers by the multimethod.</p><h2 id="extending-our-dsl-for-batch-script">Extending our DSL for Batch Script</h2><p>Let’s say I’m happy with the Bash implementation. I feel like starting a new implementation that generates Windows Batch script. Let’s define a new multimethod, emit-batch.</p><pre><code class="klipse-clojure nohighlight">(defmulti emit-batch
+          (fn [form]
+            (cond
+              (list? form) :list
+              (string? form) :string
+              (number? form) :number
+              :else (throw (ex-info "Unknown type" form)))))
+
+(defmethod emit-batch 
+  :list
+  [form]
+  (case (name (first form))
+    "println" (str "ECHO " (second form))
+    nil))
+
+(defmethod emit-batch
+  :string
+  [form]
+  form)
+
+(defmethod emit-batch
+  :number
+  [form]
+  (str form))
+</code></pre><p>We can now use <code>emit-batch</code> and <code>emit-bash</code> when we want Batch and Bash script output respectively.</p><pre><code class="klipse-clojure nohighlight">(emit-batch '(println "a"))
+</code></pre><pre><code class="klipse-clojure nohighlight">(emit-bash '(println "a"))
+"echo a"
+</code></pre><h2 id="ad-hoc-hierarchies">Ad-hoc Hierarchies</h2><p>Comparing the two implementations reveals many similarities. In fact, the only dispatch that differs is clojure.lang.PersistentList!</p><p>Some form of implementation inheritance would come in handy here.</p><p>We can tackle this with a simple mechanism Clojure provides to define global, ad-hoc hierarchies.</p><p>When I say this mechanism is simple, I mean non-compound; inheritance is not compounded into the mechanism to define classes or namespaces but rather is a separate functionality.</p><p>Contrast this to languages like Java, where inheritance is tightly coupled with defining a hierarchy of classes.</p><p>We can derive relationships from names to other names, and between classes and names. Names can be symbols or keywords. This is both very general and powerful!</p><p>We will use <code>(derive child parent)</code> to establishes a parent/child relationship between two keywords. <code>isa?</code> returns <code>true</code> if the first argument is derived from the second in a global hierarchy.</p><pre><code class="klipse-clojure nohighlight">(derive ::child ::parent)
+
+(isa? ::child ::parent)
+</code></pre><p>Let’s define a hierarchy in which the Bash and Batch implementations are siblings.</p><pre><code class="klipse-clojure nohighlight">(derive ::bash ::common)
+(derive ::batch ::common)
+</code></pre><p>Let’s test this hierarchy.</p><pre><code class="klipse-clojure nohighlight">(parents ::bash)
+</code></pre><pre><code class="klipse-clojure nohighlight">(parents ::batch)
+</code></pre><h2 id="utilizing-a-hierarchy-in-a-multimethod">Utilizing a Hierarchy in a Multimethod</h2><p>We can now define a new multimethod emit that utilizes our global hierarchy of names.</p><pre><code class="klipse-clojure nohighlight">(defmulti emit
+          (fn [form]
+            [*current-implementation*
+             (cond
+               (list? form) :list
+               (string? form) :string
+               (number? form) :number
+               :else (throw (ex-info "Unknown type" form)))]))
+</code></pre><p>The dispatch function returns a vector of two items: the current implementation (either <code>::bash</code> or <code>::batch</code>), and the class of our form (like <code>emit-bash</code>'s dispatch function).</p><p><code>*current-implementation*</code> is a dynamic var, which can be thought of as a thread-safe global variable.</p><pre><code class="klipse-clojure nohighlight">(def ^{:dynamic true}
+  ;; The current script language implementation to generate
+  *current-implementation*)
+</code></pre><p>In our hierarchy, <code>::common</code> is the parent, which means it should provide the methods in common with its children. Let's fill in these common implementations.</p><p>Remember the dispatch value is now a vector, notated with square brackets. In particular, in each defmethod the first vector is the dispatch value (the second vector is the list of formal parameters).</p><pre><code class="klipse-clojure nohighlight">(defmethod emit [::common :string]
+  [form]
+  form)
+
+(defmethod emit [::common :number]
+  [form]
+  (str form))
+</code></pre><p>This should look familiar. The only methods that needs to be specialized are those for clojure.lang.PersistentList, as we identified earlier. Notice the first item in the dispatch value is <code>::bash</code> or <code>::batch</code> instead of <code>::common</code>.</p><pre><code class="klipse-clojure nohighlight">(defmethod emit [::bash :list]
+  [form]
+  (case (name (first form))
+    "println" (str "echo " (second form))
+    nil))
+
+(defmethod emit [::batch :list]
+  [form]
+  (case (name (first form))
+    "println" (str "ECHO " (second form))
+    nil))
+</code></pre><p>The <code>::common</code> implementation is intentionally incomplete; it merely exists to manage any common methods between its children.</p><p>We can test emit by rebinding <code>*current-implementation*</code> to the implementation of our choice with binding.</p><pre><code class="klipse-clojure nohighlight">(binding [*current-implementation* ::common]
+         (emit "a"))
+</code></pre><pre><code class="klipse-clojure nohighlight">(binding [*current-implementation* ::batch]
+  (emit '(println "a")))
+</code></pre><pre><code class="klipse-clojure nohighlight">(binding [*current-implementation* ::bash]
+  (emit '(println "a")))
+</code></pre><pre><code class="klipse-clojure nohighlight">(binding [*current-implementation* ::common]
+  (emit '(println "a")))
+</code></pre><p>Because we didn’t define an implementation for <code>[::common :list]</code>, the multimethod falls through and throws an Exception.</p><p>Multimethods offer great flexibility and power, but with power comes great responsibility. Just because we can put our multimethods all in one namespace doesn’t mean we should. If our DSL becomes any bigger, we would probably separate all Bash and Batch implementations into individual namespaces.</p><p>This small example, however, is a good showcase for the flexibility of decoupling namespaces and inheritance.</p><h2 id="icing-on-the-cake">Icing on the Cake</h2><p>We’ve built a nice, solid foundation for our DSL using a combination of multimethods, dynamic vars, and ad-hoc hierarchies, but it’s a bit of a pain to use.</p><pre><code class="klipse-clojure nohighlight">(binding [*current-implementation* ::bash]
+  (emit '(println "a")))
+</code></pre><p>Let’s eliminate the boilerplate. But where is it?</p><p>The binding expression is an good candidate. We can reduce the chore of rebinding <em>current-implementation</em> by introducing with-implementation (which we will define soon).</p><pre><code class="clojure">(with-implementation ::bash
+  (emit '(println "a")))
+</code></pre><p>That’s an improvement. But there’s another improvement that’s not as obvious: the quote used to delay our form’s evaluation. Let’s use script, which we will define later, to get rid of this boilerplate:</p><pre><code class="clojure">(with-implementation ::bash
+  (script
+    (println "a")))
+</code></pre><p>This looks great, but how do we implement script? Clojure functions evaluate all their arguments before evaluating the function body, exactly the problem the quote was designed to solve.</p><p>To hide this detail we must wield one of Lisp’s most unique forms: the macro.</p><p>The macro’s main drawcard is that it doesn’t implicitly evaluate its arguments. This is a perfect fit for an implementation of script.</p><pre><code class="klipse-clojure nohighlight">(defmacro script [form]
+  `(emit '~form))
+</code></pre><p>To get an idea what is happening, here’s what a call to script returns and then implicitly evaluates.</p><pre><code class="klipse-clojure nohighlight">(macroexpand '(script (println "a")))
+</code></pre><p>It isn’t crucial that you understand the details, rather appreciate the role that macros play in cleaning up the syntax.</p><p>We will also implement with-implementation as a macro, but for different reasons than with script. To evaluate our script form inside a binding form we need to drop it in before evaluation.</p><pre><code class="klipse-clojure nohighlight">(defmacro with-implementation
+  [impl &amp; body]
+  `(binding [cljs.user/*current-implementation* ~impl]
+     ~@body))
+</code></pre><p>Roughly, here is the lifecyle of our DSL, from the sugared wrapper to our unsugared foundations.</p><pre><code class="clojure">(with-implementation ::bash
+  (script
+    (println "a")))
+=&gt;
+(with-implementation ::bash
+  (emit
+    '(println "a"))
+=&gt;
+(binding [*current-implementation* ::bash]
+  (emit
+    '(println "a")))
+</code></pre><p>Let's see it in action for Bash:</p><pre><code class="klipse-clojure nohighlight">(with-implementation ::bash
+  (script
+    (println "a")))
+</code></pre><p>And for Windows:</p><pre><code class="klipse-clojure nohighlight">(with-implementation ::batch
+  (script
+    (println "a")))
+</code></pre><p>It’s easy to see how a few well-placed macros can put the sugar on top of strong foundations. Our DSL really looks like Clojure code!</p><h2 id="conclusion">Conclusion</h2><p>We have seen many of Clojure’s advanced features working in harmony in this DSL, even though we incrementally incorported many of them. Generally, Clojure helps us switch our implementation strategies with minimum fuss.</p><p>This is notable when you consider how much our DSL evolved.</p><p>We initially used a simple <code>cond</code> expression, which was converted into two multimethods, one for each implementation. As multimethods are just ordinary functions, the transition was seamless for any existing testing code. (In this case I renamed the function for clarity).</p><p>We then merged these multimethods, utilizing a global hierachy for inheritance and dynamic vars to select the current implementation.</p><p>Finally, we devised a pleasant syntactic interface with a two simple macros, eliminating that last bit of boilerplate that other languages would have to live with.</p><p>I hope you have enjoyed following the evolution of our little DSL. This DSL is based on a simplified version of <a href="https://github.com/pallet/stevedore">Stevedore</a> by <a href="http://hugoduncan.org/">Hugo Duncan</a>. If you are interested in how this DSL can be extended, you can do no better than browsing the source code of <a href="https://github.com/pallet/stevedore">Stevedore</a>.</p><h2 id="copyright">Copyright</h2><p>Copyright Ambrose Bonnaire-Sergeant, 2013</p>
+
+    <div id="prev-next">
+        
+        <a href="../parsing_xml_with_zippers/index.html">&laquo; Parsing XML in Clojure</a>
+        
+        
+        ||
+        
+        
+        <a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+ <link rel="stylesheet" type="text/css" href="https://storage.googleapis.com/app.klipse.tech/css/codemirror.css">
+<script>
+window.klipse_settings = {
+  "selector" : ".klipse-clojure"
+};
+</script>
+<script src="https://storage.googleapis.com/app.klipse.tech/plugin/js/klipse_plugin.js"></script> 
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/tutorials/introduction/index.html b/clones/clojure-doc.org/articles/tutorials/introduction/index.html
new file mode 100644
index 00000000..b3c4d966
--- /dev/null
+++ b/clones/clojure-doc.org/articles/tutorials/introduction/index.html
@@ -0,0 +1,968 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Introduction to Clojure</title>
+    
+
+<meta name="description" content="This guide covers:">
+
+<meta property="og:description" content="This guide covers:">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/tutorials/introduction/" />
+<meta property="og:title" content="Introduction to Clojure" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/tutorials/introduction/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Introduction to Clojure</h2>
+    </div>
+    
+    <p>This guide covers:</p><ul><li>Clojure language basics</li><li>expressions, identifiers (locals, vars)</li><li><code>let</code> forms</li><li>scalars</li><li>functions</li><li>basic data types</li><li>introduction to immutable data structures</li><li>overview of Clojure reference types (vars, atoms, agents, refs)</li><li>looping and recursion</li><li>basics of Clojure macros</li></ul><p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons
+Attribution 3.0 Unported License</a> (including images &amp;
+stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on
+Github</a>.</p><h2 id="overview">Overview</h2><p>This is a brief beginner's introduction to Clojure. If you haven't
+already done so, have a look at the <a href="../getting_started/index.html">Getting
+Started</a> tutorial. Before
+continuing, make sure you've got Java and
+<a href="http://leiningen.org">Leiningen</a> installed, and can create a new
+project and run a REPL in it. The author expects you'll want to have a
+REPL running while following this introduction so you can type
+expressions into it as you go.</p><blockquote><p><strong>Note:</strong> In the code samples below, unless we're specifically
+discussing the REPL, to reduce clutter we've usually omitted showing
+the REPL prompt (ex. "<code>user=&gt;</code>" or "<code>my-proj.core=&gt;</code>").</p><p>Additionally: In Clojure, a semicolon begins a single-line comment,
+and in this document we use "<code>; ⇒</code>" (for trailing comments) and
+"<code>;; ⇒</code>" (for comments on their own line) to indicate what the
+previous expression evaluates to.</p></blockquote><p>This introduction is a whirlwind tutorial of most of the basics of
+Clojure. Its goal is to rapidly get you familiar with the core
+areas of the language without wasting your time and also without getting
+too bogged down in details or advanced topics (the various topics will
+get more comprehensive coverage in the topic guides anyway).</p><p>As we said in the Getting Started tutorial, Clojure is a wonderfully
+simple language, and you're going to love it.</p><h2 id="the-basics">The Basics</h2><p>Clojure is a general-purpose programming language, and a quite
+practical one at that.</p><p>The syntax for Clojure is like Lisp and is very simple: code is made
+up of expressions which are evaluated to some value. Here are some
+examples of expressions:</p><pre><code class="clojure">5                      ; ⇒ 5
+"hi"                   ; ⇒ "hi"
+[1 2 3]                ; evaluates to the vector `[1 2 3]`
+(+ 1 2)                ; evaluates to the sum of 1 and 2
+(if true "yes" "no")   ; evaluates to the string "yes"
+(println "hello!")     ; evaluates to nil (but also prints "hello!")
+</code></pre><p>Clojure supports a few extra bits of syntax which will be noted as we
+encounter them.</p><p>Expressions can contain sub-expressions:</p><pre><code class="clojure">(+ 1
+   (* 2 3)
+   (/ 10 2))   ; ⇒ 1 + (2 * 3) + (10 / 2) = 12
+</code></pre><p>Expressions in (various types of) brackets are often referred to as
+"forms".</p><p>An expression in parentheses is usually treated as a function call,
+but may also be a macro or special form (more about those in the
+<a href="index.html#evaluation">Evaluation</a> section below).</p><p>Clojure is not whitespace-sensitive. Also, commas count as whitespace,
+so you can omit them (for example, you can write a vector as <code>[1 2 3]</code>
+instead of <code>[1, 2, 3]</code>).</p><p>Clojure code is block-structured and lexically scoped (though dynamic
+scope is supported as well, if you really need it).</p><p>Clojure is a compiled language. The Clojure reader reads your source
+code, then your code is compiled to JVM bytecode, and then it's run on
+the JVM.  The reader supports a few extra bits of syntactic sugar (for
+example, a literal syntax for specifying regular expressions) that we
+will cover as we go along.</p><p>Throughout this tutorial, we will liberally reference and lean on the
+marvelous <a href="http://clojure.org/cheatsheet">Clojure Cheatsheet</a>. Aside
+from being a great organizational aide, it also handily includes links
+to the relevant <a href="http://clojuredocs.org/">Clojuredocs</a> pages where you
+can find docs for and examples of the various Clojure functions.</p><p>In the REPL, at any time you can see the documentation for a given
+function:</p><pre><code>(doc some-function)
+</code></pre><p>and even the source code for it:</p><pre><code>(source some-function)
+</code></pre><p>So, it will be of great use to you to have your REPL running so you
+can try things out while following along.</p><h2 id="identifiers">Identifiers</h2><p>Identifiers are used to name things. For example, in</p><pre><code class="clojure">(def the-answer 42)
+</code></pre><p>we've named something "the-answer" and given it the value 42.</p><p>In this document we'll mostly use lowercase letters, numbers, and
+dashes to name things, although some other characters are allowed too,
+such as <code>_&lt;&gt;!?*</code> (ex. <code>this-&gt;that</code>, <code>ready?</code>). We'll note more
+examples of those cases later on as they come up.</p><h2 id="scalars">Scalars</h2><p>Clojure has support for the following kinds of scalar values:</p><pre><code class="clojure">nil
+true, false
+</code></pre><p><code>nil</code> is like Python's None, or Java's null. It's just another value.
+Incidentally, there's no "undefined" value in Clojure --- if you try
+to use a symbol which you haven't defined, then it's undefined and the
+compiler will let you know about it.</p><p>As we go along, type those expressions into your REPL to see them
+evaluated. These too:</p><pre><code class="clojure">1        ; integer
+1N       ; arbitrary-precision integer
+1.2      ; float/double/decimal
+1.2M     ; arbitrary-precision decimal
+1.2e4    ; scientific notation
+1.2e4M   ; sci notation of arbitrary-precision decimal
+
+0x3a     ; hex literal (58 in decimal)
+1/3      ; Rational number, or "ratio".
+\a       ; The character "a".
+"hi"     ; A string.
+</code></pre><p>Strings can span multiple lines --- just hit Enter and keep typing. If
+you want to include a double-quote mark in a string, backslash-escape
+it.</p><pre><code class="clojure">#"^foo\d?$"   ; A regular expression.
+:foo          ; A keyword.
+</code></pre><p>We'll have more to say about <a href="index.html#regular-expressions">regular
+expressions</a> later on.</p><p>Keywords are just scalars that evaluate to themselves and are useful
+where in other languages you might use little strings as identifiers
+(for example, as the keys in a hashmap). More about keywords in the
+next section (<a href="index.html#data-structures">Data Structures</a>).</p><pre><code class="clojure">'foo   ; A symbol.
+</code></pre><p>A <em>symbol</em> is an object that represents the <em>name</em> of something. The
+single quote mark is there to keep Clojure from trying to figure out
+to what the symbol refers (the quote isn't part of the identifier of
+the symbol). When you want to represent the name of a thing --- rather
+than the value to which it refers --- you use a symbol. Their utility
+will become clearer later on when we briefly mention
+<a href="index.html#macros-and-special-forms">Macros</a>.</p><blockquote><p><strong>Terminology:</strong> By "object" we just mean the internal thing that
+Clojure uses to represent a value --- <em>not</em> "object" as in "object
+oriented programming".  Clojure is not an object oriented
+language. Sure, you can easily access Java OOP objects from Clojure,
+but that is outside the scope of this tutorial.</p><p>Also, the words "reference" and "refer" are used in Clojure in the
+generic sense. A symbol refers to an object (it is not the object
+itself).  Clojure <em>also</em> happens to support something called
+<em>reference types</em>. We'll cover them later on in the <a href="index.html#reference-types">Reference
+Types</a> section.</p></blockquote><h2 id="data-structures">Data Structures</h2><p>Clojure comes out of the box with nice literal syntax for the various
+core data structures:</p><pre><code class="clojure">[1 2 3]            ; A vector (can access items by index).
+[1 :two "three"]   ; Put anything into them you like.
+{:a 1 :b 2}        ; A hashmap (or just "map", for short).
+</code></pre><p>A hashmap is your typical hash/dictionary data structure. In the above
+example, the keys are :a and :b, and the values are 1 and 2. One key-value
+pair in a map is called an <em>entry</em>.</p><p>Although it's most common to use keywords (as shown above) for hashmap
+keys, you can use any values you like for the keys as well as the
+values.</p><pre><code class="clojure">#{:a :b :c}        ; A set (unordered, and contains no duplicates).
+'(1 2 3)           ; A list (linked-list)
+</code></pre><p>You generally don't use lists very often for typical sequential data
+in your programs:</p><pre><code class="clojure">(def my-stuff '("shirt" "coat" "hat"))  ; Works fine, but ...
+(def my-stuff ["shirt" "coat" "hat"])   ; this is more typical usage.
+</code></pre><p>Lists are most often used when treating code itself as just a bunch of
+nested lists --- see <a href="index.html#macros-and-special-forms">Macros</a>.</p><p>BTW, don't mind that single-quote mark before the list's open paren;
+it's just there to tell Clojure that this isn't a function call
+(discussed in <a href="index.html#function-calls">Function Calls</a>, below), but rather, an actual
+list.</p><blockquote><p>Note: In Clojure, we use the term "vector" rather than "array".
+"Array" would refer to the native Java array, whereas "vector"
+refers to the Clojure data structure.</p></blockquote><p>Nesting data structures works like you'd expect:</p><pre><code class="clojure">#{:a
+  [1 2 3]
+  {:foo 11 :bar 12}
+  #{"shirt" "coat" "hat"}}
+</code></pre><p>We will see how to get at values inside nested data structures a little
+later on.</p><h3 id="abstractions">Abstractions</h3><p>The data structures we just looked at (lists, vectors, maps, and sets)
+are all concrete data types. The various Clojure functions for working
+on them (which we will get to later on) actually aren't written to
+work on the concrete types, but rather, are written to work on
+abstract data types. The concrete data types are implementations of
+the various abstract data types.</p><p>Some of the Clojure abstractions are:</p><ul><li>Collection (Lists, vectors, maps, and sets are all collections.)</li><li>Sequential (Lists and vectors are ordered collections.)</li><li>Associative (Hashmaps associate keys with values. Vectors associate numeric indices with values.)</li><li>Indexed (Vectors, for example, can be quickly indexed into.)</li></ul><p>In the docs for the various functions, you'll often see that they
+take, for example, a "coll". This means that the particular function
+will work on any of the collections.</p><blockquote><p>If you'd like to look under the covers and see what the type of
+an object is, try <code>(type my-stuff)</code>.</p></blockquote><h2 id="evaluation">Evaluation</h2><p>So far you've been typing various literal values (expressions) into
+the repl and Clojure has evaluated them and repeated their resulting
+values back to you (printed them out in the repl):</p><pre><code class="clojure">user=&gt; "hi"
+;; "hi"
+user=&gt; :foo
+;; :foo
+user=&gt; [1 2 3]
+;; [1 2 3]
+</code></pre><p>Clojure evaluates the expressions you give it and tries to come up
+with a resulting value. If the expression starts with an open paren,
+Clojure treats it as either a macro, a <em>special form</em> (discussed
+below) or else a function call.</p><h3 id="function-calls">Function Calls</h3><p>If the symbol right after the open paren names a function, Clojure
+evaluates all of its function arguments first, then applies the
+function to the values of those args:</p><pre><code class="clojure">(my-func arg1 arg2 arg3)
+</code></pre><p>You can nest function calls as deep as tasteful discretion allows:</p><pre><code class="clojure">(my-func (my-func2 arg1
+                   arg2)
+         (other-func arg-a
+                     (foo-bar arg-x
+                              arg-y
+                              (+ arg-xx
+                                 arg-yy
+                                 arg-zz))
+                     arg-b))
+</code></pre><p>Note that your code will be easiest to read if you line up args to
+functions vertically (as shown above). Your editor should take care of
+this for you automatically.</p><p>By the way, there are no "operators" in Clojure per se; just function
+names (symbols which refer to their corresponding functions). So, for
+example, <code>+</code>, <code>&gt;</code>, <code>&lt;=</code>, <code>=</code>, <code>*</code>, and <code>not=</code> are all just function
+names.</p><h3 id="macros-and-special-forms">Macros and Special Forms</h3><p>If an expression starts with an open paren, Clojure first checks to
+see if it's a macro or special form. These are forms which don't
+follow the regular evaluation rule and get special treatment from the
+Clojure compiler.</p><p>Macros are like functions which take as arguments regular Clojure code
+(which is, after all, just a list of expressions and (usually nested)
+other lists), and returns the code transformed / expanded in some
+useful way.</p><p>You write macros to add new syntax to the Clojure language, and
+usually it's only done when necessary, after you've already gotten as
+far as you can with plain functions.</p><p>Macros are created using <code>defmacro</code>. Writing them involves
+manipulating lists (Clojure code), just like you've already
+seen. Though quoting and unquoting is used to control evaluation of
+the code you're handling.</p><p>Macro calls in your code get expanded at compile-time, right before
+the rest of your code is compiled. Certain Clojure built-ins like
+<code>let</code>, <code>def</code>, and <code>if</code> are written as special forms which are
+hard-coded into the compiler rather than macros, but this is an
+implementation detail; the effect is the same.</p><p>This tutorial does not discuss macros further.</p><h3 id="quoting">Quoting</h3><p>If for whatever reason you'd rather Clojure <em>not</em> treat something like
+<code>(+ 1 2 3)</code> as a function call, you can "quote" it like so:</p><pre><code class="klipse-clojure nohighlight">'(+ 1 2 3)
+</code></pre><p>This causes Clojure to then regard it simply as a 4-element list;
+the first element of which is the symbol for some function.  Reasons
+for wanting to do this will become clearer later on.</p><h2 id="let-and-locals">Let and Locals</h2><p>When you want some lexically-scoped named values to use in a section
+of your code, you can use the <code>let</code> expression:</p><pre><code class="klipse-clojure nohighlight">(let [width     10
+      height    20
+      thickness 2]
+  (println "hello from inside the `let`.")
+  (* width
+     height
+     thickness))
+</code></pre><p>The first thing inside the <code>let</code> is a binding vector. In it, you
+specify the local names you'd like to make available inside the <code>let</code>,
+along with their values.</p><blockquote><p><strong>Formatting note:</strong> Your readers might appreciate you vertically
+lining up the values used in the binding vector, as we've done
+above with 10, 20, and 2.</p></blockquote><p>These local names are symbols that refer directly to the values you
+set them to.</p><p>You can re-set the symbols in the binding vector multiple times
+(building it up into the value you need), if you find it useful:</p><pre><code class="klipse-clojure nohighlight">(let [x 2
+      x (* x x)
+      x (+ x 1)]
+  x)
+</code></pre><p>The <code>let</code> expression itself evaluates to the last expression in its
+body.  You can put other things inside the <code>let</code> (like our <code>println</code>
+expression, in the previous example), but the overall value of the
+<code>let</code> is its last expression.</p><blockquote><p>Note that the <code>println</code> expression just evaluates to nil. We don't
+use its value for anything --- we only care about its <em>side-effects</em>
+(printing out to the console). More about
+<a href="index.html#side-effects">Side-Effects</a> shortly.</p></blockquote><h2 id="namespaces">Namespaces</h2><p>Clojure uses <em>namespaces</em> to organize function names into groups
+and to keep them from colliding with other function names.
+All function names live in a namespace. All the core functions
+we've been using thus far are in the clojure.core namespace:</p><pre><code class="klipse-clojure nohighlight">(clojure.core/println "hi")
+</code></pre><p>That's the fully-qualified name of <code>println</code>. You'd normally have to
+use the fully-qualified name for functions (or else use an alias to
+the namespace --- covered in a moment), but Clojure makes all the
+clojure.core functions automatically available by their unqualified
+names (that is, sans namespace) for convenience.</p><p>Fully-qualified names are written "namespace/symbol". The namespace
+may have dots in it, which correspond to directories in your
+filesystem. For example, the function foo-bar.core/my-func corresponds
+to the my-func function in src/foo_bar/core.clj. (It's just a bit of
+the underlying Java platform showing through that you need to use
+underscores in your directory names instead of dashes).</p><p>It's most common for one source code file to correspond to one
+namespace, and often comprise one <em>library</em>. At the top of your source
+file, you write <code>(ns whatever)</code> and that declares the namespace for
+the rest of the file.</p><p>In the repl, you can make use of libraries --- and at the same time
+provide a handy alias for them --- by <em>requiring</em> them like so:</p><pre><code class="klipse-clojure nohighlight">(require '[clojure.string :as str])
+</code></pre><p>Now we can use all the functions in the clojure.string library by
+prefixing them with "str/". We'll do exactly this in the section below
+on <a href="index.html#functions-for-working-with-strings">Functions for working with
+strings</a>.</p><h2 id="functions-for-creating-data-structures">Functions for Creating Data Structures</h2><p>There are functions for creating the various data structures without
+using the usual literal syntax:</p><pre><code class="clojure">(list 1 2 3)            ; ⇒ '(1 2 3)
+(vector 1 2 3)          ; ⇒ [1 2 3]
+(hash-map :a 1 :b 2)    ; ⇒ {:a 1 :b 2}
+(hash-set :a :b :c)     ; ⇒ #{:a :b :c}
+</code></pre><p>And there are various functions for converting between vectors, sets,
+and maps:</p><pre><code class="clojure">(def my-vec [1 2 3])
+(set my-vec)                   ; ⇒ #{1 2 3}
+
+(def my-map {:a 1 :b 2})
+(vec my-map)                   ; ⇒ [[:a 1] [:b 2]]
+(flatten (vec my-map))         ; ⇒ (:a 1 :b 2)
+(set my-map)                   ; ⇒ #{[:b 2] [:a 1]}
+
+(def my-set #{:a :b :c :d})
+(vec my-set)                   ; ⇒ [:a :c :b :d]
+
+;; And for fun:
+(zipmap [:a :b :c] [1 2 3])    ; ⇒ {:c 3 :b 2 :a 1}
+(apply hash-map [:a 1 :b 2])   ; ⇒ {:a 1 :b 2}
+</code></pre><p>(We cover <code>apply</code> in the <a href="index.html#bread-and-butter-functions">Bread and Butter
+functions</a> section.)</p><p>If you need to convert to a sequential collection but don't need fast
+random access to items via index, you can use <code>seq</code> instead of <code>vec</code>
+(to convert to a generic linked-list-like ("sequential") data
+structure).  More about <code>seq</code> when we get to <a href="index.html#laziness">Laziness</a>.</p><blockquote><p>By the way, you may have noticed a pattern here: longer function
+names are for passing in values one-by-one to create the data
+structure, whereas the shorter function names are for passing in a
+whole data structure at once:</p><pre><code>literal  long name  short name
+-------  ---------  ------------------
+()       list       *{no short name}*
+[]       vector     vec
+{}       hash-map   *{no short name}*
+#{}      hash-set   set
+</code></pre><p>You might think of <code>seq</code> as the short name for <code>list</code>, but that's
+probably pushing it, since there are a few differences.</p></blockquote><h2 id="functions-for-working-with-data-structures">Functions For Working With Data Structures</h2><p>Getting values from data structures:</p><pre><code class="clojure">;; Vectors
+(def v [:a :b :c])
+(nth v 1)             ; ⇒ :b
+(v 1)                 ; ⇒ :b  (same)
+(first v)             ; ⇒ :a
+(rest v)              ; ⇒ (:b :c)
+(next v)              ; ⇒ (:b :c)
+(last v)              ; ⇒ :c
+
+;; Lists
+;; Same as vectors, but can't index.
+
+;; Maps
+(def m {:a 1 :b 2})
+(get m :a)            ; ⇒ 1
+(m :a)                ; ⇒ 1       (same)
+(:a m)                ; ⇒ 1       (same!)
+(get m :x 44)         ; ⇒ 44      (if no :x, 44 is the default)
+(keys m)              ; ⇒ (:a :b)
+(vals m)              ; ⇒ (1 2)
+;; Grab a key or a val from a single map entry:
+(key (first m))       ; ⇒ :a
+(val (first m))       ; ⇒ 1
+;; Of course, note that maps are not ordered.
+
+;; Sets
+(def s #{:a :b :c})
+(s :a)                ; ⇒ :a
+(s :z)                ; ⇒ nil
+</code></pre><p>Data structures in Clojure are actually <em>immutable</em> --- you can't
+change them. Though it may sound batty, it actually works out nicely
+in practice, and we'll read more about in the
+<a href="index.html#values,-immutability,-and-persistence">Immutability</a> section
+below. For now, just note that data structures can't be mutated, but
+we <em>can</em> get a new modified copy of a data structure:</p><pre><code class="clojure">;; Vectors
+(def v   [:a :b :c])
+(def li '(:a :b :c))
+(conj v  :d)          ; ⇒ [:a :b :c :d]
+(conj li :d)          ; ⇒ (:d :a :b :c)
+
+v   ; ⇒ is still [:a :b :c]
+li  ; ⇒ is still (:a :b :c)
+
+;; Maps
+(def m {:a 1 :b 2})
+(assoc m :c 3)        ; ⇒ {:a 1 :c 3 :b 2}
+(dissoc m :b)         ; ⇒ {:a 1}
+
+m   ; ⇒ is still {:a 1 :b 2}
+
+;; Sets
+(def s #{:a :b})
+(conj s :c)           ; ⇒ #{:a :c :b}
+(disj s :a)           ; ⇒ #{:b}
+
+s   ; ⇒ is still #{:a :b}
+</code></pre><p>See the <a href="http://clojure.org/cheatsheet">cheatsheet</a> for much more
+you can do with these core data structures.</p><h2 id="regular-expressions">Regular Expressions</h2><p>As you've seen, Clojure provides a handy literal syntax for regular
+expressions: <code>#"regex here"</code>. Clojure uses the same regular expression
+syntax as Java, which is nearly the same as what Perl 5 (and Python,
+and Ruby) uses. You can read more about the specifics in the Java
+<a href="http://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html">java.util.regex Pattern
+docs</a>.</p><p>Clojure provides a number of functions for working with strings, and a
+number of those can make use of regexes. See the next section for some
+examples.</p><h2 id="functions-for-working-with-strings">Functions For Working With Strings</h2><p>There are a number of functions for working with strings listed in the
+Strings section of the cheatsheet. Here are some examples of a few of
+them:</p><pre><code class="clojure">(str "hi" "there")
+;; ⇒ "hithere"
+(count "hello")
+;; ⇒ 5
+(require '[clojure.string :as str])
+;; ⇒ nil
+(str/split "hello there" #" ")
+;; ⇒ ["hello" "there"]
+(str/join ["hello" "there"])
+;; ⇒ "hellothere"
+(str/join " " ["hello" "there"])
+;; ⇒ "hello there"
+(str/replace "hello there" "ll" "LL")
+;; ⇒ "heLLo there"
+</code></pre><p>Some of them make optional use of regexes. There's more in the
+cheatsheet. Try them out!</p><p>Incidentally, since strings are sequential, any function that works on
+sequentials works on strings. For example:</p><pre><code class="clojure">(first "hello")
+;; ⇒ \h
+(last "hello")
+;; ⇒ \o
+(rest "hello")
+;; ⇒ (\e \l \l \o)
+(nth "hello" 1)
+;; ⇒ \e
+(doseq [letter "hello"] (println letter))
+;; h
+;; e
+;; l
+;; l
+;; o
+;; ⇒ nil
+</code></pre><p>Again, see the cheatsheet for more.</p><h2 id="values-immutability-and-persistence">Values, Immutability, and Persistence</h2><p>A <em>value</em> is fundamentally a constant thing; For example, the letter
+"a" is a value. You don't "set" the letter "a" to some other value; it
+always stays the letter "a". It's immutable. The value 10 is always
+10. You can't ever "set 10 to 11". That makes no sense. If you want
+11, you just use 11 instead of 10.</p><p>In Clojure, <em>all scalars and core data structures are like this</em>. They
+are values. They are immutable. The map</p><pre><code class="clojure">{:name "John"
+ :hit-points 200
+ :super-power :resourcefulness}
+</code></pre><p>is a value. If you want to "change" John's hit-points, you don't
+change anything per se, but rather, you just conjure up a whole new
+hashmap value.</p><p><strong>But wait:</strong> If you've done any imperative style programming in
+C-like languages, this sounds crazy wasteful. <em>However</em>, the yin to
+this immutability yang is that --- behind the scenes --- Clojure
+shares data structures.  It keeps track of all their pieces and
+re-uses them pervasively. For example, if you have a 1,000,000-item
+list and want to tack on one more item, you just tell Clojure, "give
+me a new one but with this item added" --- and Clojure dutifully gives
+you back a 1,000,001-item list in no time flat. Unbeknownst to you
+it's re-using the original list.</p><p>Clojure data structures are said to be <em>persistent</em>.</p><p>And, again: this works just fine because to you the data structures
+are all immutable. There is no "action at a distance". Other functions
+can't change the value of a data structure you're working on because
+values don't change.</p><blockquote><p>Note that, of course, Clojure doesn't do any unnecessary copying.
+For example, when you pass a large data structure to a function</p><pre><code>(my-func a-really-big-data-structure)
+</code></pre><p>it merely passes along a reference to the big data structure. You
+can't change it in the caller's scope, because of course it's
+immutable.</p><p>And of course, you don't get any action-at-a-distance in situations
+like this either:</p><pre><code class="clojure">(def a [1 2 3 4 5])
+(def b a)
+;; Do what you will with `b`, ...
+(my-func a)   ; but it won't affect `a`.
+</code></pre><p>since, regardless, you can't mutate the vector (neither via <code>b</code><em>nor</em> <code>a</code>).</p></blockquote><p>If you're wondering how the heck it's even possible to program at all
+if you don't have "variables" and can't change anything, it will
+become clear as we continue.</p><h2 id="control-structures">Control Structures</h2><p>Clojure has most of the usual control structures you'd expect to find,
+for example: <code>if</code>, <code>and</code>, <code>or</code>, and <code>cond</code>.  You can find them listed
+in the <a href="http://clojure.org/cheatsheet">Cheatsheet</a>.</p><p>Note that they are all <em>expressions</em> in Clojure, and evaluate to
+something.  So, for example, this <code>if</code> expression:</p><pre><code class="clojure">(if motor-turning?
+  "yes"
+  "no")
+</code></pre><p>Evaluates to either the value "yes" or the value "no".</p><p>Looping is handled by either using one of the various built-in
+functions such as <code>map</code>, <code>filter</code>, <code>reduce</code>, <code>for</code>, etc., or else it's
+handled by manually using <code>loop</code> and using recursion. We'll get to
+these shortly.</p><p>Incidentally, looping is something that is required far less in
+Clojure than in imperative languages like Python and Java. The
+functions that Clojure provides often makes looping unnecessary.
+For example, where in Python you might do something like this:</p><pre><code class="python">specific_stuff = []
+for i in my_items:
+    if is_what_i_want(i):
+        specific_stuff.append(i)
+</code></pre><p>in Clojure you lose the loop and it becomes:</p><pre><code class="clojure">(def specific-stuff (filter what-i-want? my-items))
+</code></pre><p>This sort of thing comes up again and again, and we'll cover more
+examples of it in the <a href="index.html#bread-and-butter-functions">Bread and Butter
+functions</a> section.</p><h2 id="truthiness">Truthiness</h2><p>In <code>(if &lt;test&gt; &lt;then-this&gt; &lt;otherwise-this&gt;)</code> (and in <code>and</code>, <code>or</code>,
+<code>cond</code>, etc. expressions), Clojure checks if the <code>&lt;test&gt;</code> evaluates to
+something that looks either true or false. Clojure takes a very simple
+approach here: <code>nil</code> and <code>false</code> are falsey; everything else is
+truthy.</p><p>This means that zero, the empty string, and empty core data structures
+are all true:</p><pre><code class="clojure">(if   0 :t :f)  ; ⇒ :t
+(if  "" :t :f)  ; ⇒ :t
+(if  [] :t :f)  ; ⇒ :t
+(if  {} :t :f)  ; ⇒ :t
+(if #{} :t :f)  ; ⇒ :t
+</code></pre><p>If you want to check if one of those is <em>empty</em>, you could use the
+<code>empty?</code> function, though, the docs recommend using this idiom:</p><pre><code class="clojure">(if (seq my-stuff)
+  "still has stuff left"
+  "all gone")
+</code></pre><h2 id="equality">Equality</h2><p>You'll often check for equality using <code>=</code> (and likewise inequality
+using <code>not=</code>), for example:</p><pre><code class="clojure">(if (= tries max-tries)
+  "you're done"
+  "keep going")
+</code></pre><p><code>=</code> recursively checks equality of nested data structures (and
+considers lists and vectors containing the same values in the same
+order as equal), for example:</p><pre><code class="clojure">(= {:a  [1 2 3] :b #{:x :y} :c {:foo 1 :bar 2}}
+   {:a '(1 2 3) :b #{:y :x} :c {:bar 2 :foo 1}})
+;; ⇒ true
+</code></pre><p>There's also a double-equals function <code>==</code> that is more forgiving
+across various types of numbers:</p><pre><code class="clojure">(= 4 4.0)
+;; ⇒ false
+(== 4 4.0)
+;; ⇒ true
+</code></pre><p>See the docs for
+<a href="http://clojuredocs.org/clojure_core/clojure.core/=">=</a> and
+<a href="http://clojuredocs.org/clojure_core/clojure.core/==">==</a> for more
+info.</p><h2 id="predicates-and-comparators">Predicates and Comparators</h2><p><em>Predicates</em> are functions that take one or more arguments and return
+a true or false value. They usually are named with a trailing question
+mark, for example, <code>even?</code>, <code>odd?</code>, <code>nil?</code>, etc. Though, some names
+don't have the question mark, such as <code>&gt;</code>, <code>&gt;=</code>, <code>&lt;</code>, <code>&lt;=</code>, <code>=</code>, <code>==</code>,
+and <code>not=</code>.</p><p><em>Comparators</em> are functions that take 2 args and return -1, 0, or 1
+depending upon whether the first arg is less than, equal to, or
+greater than the second arg. The main one is <code>compare</code>.</p><h2 id="vars">Vars</h2><p>Near the top of this tutorial is the following definition:</p><pre><code class="clojure">(def the-answer 42)
+</code></pre><p>The thing being defined here (behind the scenes) is officially called
+a <em>Var</em>. The symbol "<code>the-answer</code>" refers to that var which itself
+refers to the value 42:</p><p>the-answer (a symbol) → a var → 42 (a value).</p><p>When Clojure sees "<code>the-answer</code>", it automatically looks up the var,
+then from there finds and returns the value 42.</p><p>Recall that <a href="index.html#let-and-locals">locals</a> don't involve vars at all:
+those symbols refer directly to their values.</p><h2 id="functions-defining-your-own">Functions: Defining Your Own</h2><p>You can create a function using <code>fn</code>, and give it a name using <code>def</code>:</p><pre><code class="klipse-clojure nohighlight">(def my-func
+  (fn [a b]
+    (println "adding them!")
+    (+ a b)))
+</code></pre><p>As you might guess, this actually creates the symbol <code>my-func</code> which
+refers to a var which itself refers to the function (which is a
+value). Call it:</p><pre><code class="klipse-clojure nohighlight">(my-func 10 20)
+</code></pre><p>But for creating top-level functions, it's more convenient to use
+<code>defn</code> (which uses <code>def</code> under the hood):</p><pre><code class="clojure">(defn my-func
+  "Docstring goes here."
+  [a b]
+  (println "adding them!")
+  (+ a b))
+</code></pre><p>A few points to note:</p><ul><li>The function parameters (<code>a</code> and <code>b</code>) are present in a vector
+(just like with the <code>let</code> expression, except we don't include
+values for them).</li><li>Inside <code>my-func</code> you can do a sequence of operations if you like
+(for example, our <code>println</code> call) --- just like in a <code>let</code> --- but
+the value of the last expression is what the function call as a
+whole will evaluate to.</li><li>Function definitions (using <code>defn</code>) should only go at the
+"top-level".</li></ul><p>Functions can return data structures instead of just scalars:</p><pre><code class="clojure">(defn foo
+  [x]
+  [x (+ x 2) (* x 2)])
+</code></pre><p>and you can of course pass them data structures as well:</p><pre><code class="clojure">(defn bar
+  [x]
+  (println x))
+
+(bar {:a 1 :b 2})
+(bar [1 2 3])
+</code></pre><p>To define a function to take, say, two or more arguments:</p><pre><code class="clojure">(defn baz
+  [a b &amp; the-rest]
+  (println a)
+  (println b)
+  (println the-rest))
+</code></pre><p>Any additional args you pass beyond the first two get packaged into a
+sequence assigned to <code>the-rest</code>. To have that function take <em>zero</em> or
+more arguments, change the parameter vector to just <code>[&amp; the-rest]</code>.</p><h3 id="layout-of-functions">Layout of Functions</h3><p>Your author likes to write his functions in a top-down fashion:</p><pre><code class="clojure">;; BROKEN pseudocode
+
+(do-it)
+
+(defn do-it
+  []
+  (... (my-func-a ...)))
+
+(defn my-func-a
+  [...]
+  (... (my-func-b ...)))
+
+(defn my-func-b ...)
+</code></pre><p>but Clojure doesn't like that because it wants to have at least
+<em>heard</em> about a function before you write a call to it. To let Clojure
+know about a function's existence, use <code>declare</code>:</p><pre><code class="clojure">;; pseudocode
+
+(declare do-it)
+
+(do-it)
+
+(declare my-func-a)
+
+(defn do-it
+  []
+  (... (my-func-a ...)))
+
+(declare my-func-b)
+
+(defn my-func-a
+  [...]
+  (... (my-func-b ...)))
+
+(defn my-func-b ...)
+</code></pre><h2 id="side-effects">Side-effects</h2><p>Some expressions in Clojure have side-effects. Many do not. All
+expressions evaluate to something.</p><p>For example, <code>(+ 1 2)</code> evaluates to 3 and has no side-effects.
+<code>(println "hi")</code> evaluates to nil and has the side-effect of printing
+"hi" to standard out. You usually call <code>println</code> for the side-effect,
+not for the return value.</p><p>Pure functions are those which have no side-effects and which do not
+depend upon anything outside to compute their return value(s): you
+pass it one or more values, and it returns one or more values.</p><p>If you want to make an expression that has some side-effects before
+it evaluates to a value, use <code>do</code>:</p><pre><code class="clojure">(do
+  (println "Spinning up warp drive, captain ...")
+  (spin-up-warp-drive)
+  (get-engine-temperature))
+</code></pre><p>There are a handful of functions/macros/special-forms in Clojure for
+making use of side-effects, and they are spelled with a "do" at the
+beginning. Try these on for size:</p><pre><code class="klipse-clojure nohighlight">(def my-items ["shirt" "coat" "hat"])
+
+(doseq [i my-items]
+  (println i))
+</code></pre><pre><code class="klipse-clojure nohighlight">(dotimes [i 10]
+  (println "counting:" i))
+</code></pre><p>There's also <code>dorun</code> and <code>doall</code>, both of which are discussed below in
+the section on <a href="index.html#laziness">Laziness</a>.</p><p>We say that <code>let</code> expressions and function bodies (and also <code>loop</code>
+expressions, which you'll read about later in <a href="index.html#looping-and-recursion">Looping and
+Recursion</a>) have an "implicit do": within them
+you can list expressions one after another, and they all get evaluated
+in order (presumably for the side-effects), but the last one is what
+determines the overall resulting value of the <code>let</code> expression.</p><blockquote><p>Incidentally, if in the binding vector of a <code>let</code> you'd like to have
+some side-effects happen and aren't really concerned about the local
+values involved, it's customary to use "_" (an underscore) as the
+identifier:</p><pre><code class="clojure">(let [_ (do-something)
+      _ (println "done with that")
+      x 10]
+  ...)
+</code></pre><p>There's nothing special about the identifier "_" --- it's just
+shorter to type than, say, "this-is-of-no-consequence".</p></blockquote><p>There's a version of <code>if</code> which supports no "else" expression and
+which provides an "implicit do": it's spelled "<code>when</code>" (and likewise
+with <code>if-not</code> ↔ <code>when-not</code>).</p><h2 id="destructuring">Destructuring</h2><p>Clojure provides a little bit of extra syntactic support for assigning
+values to locals in <code>let</code> expressions and function definitions.  Using
+<code>let</code> as an example, suppose you have a nested data structure, and
+you'd like to assign some values in it to locals. Where you <em>could</em> do
+this:</p><pre><code class="clojure">(def games [:chess :checkers :backgammon :cards])
+
+(let [game-a (games 0)
+      game-b (games 1)
+      game-c (games 2)
+      game-d (games 3)]
+  ...
+  ...)
+</code></pre><p>Destructuring allows you to instead write:</p><pre><code class="clojure">(let [[game-a game-b game-c game-d] games]
+  ...
+  ...)
+</code></pre><p>The thing to the left of "games" in the binding vector is referred to
+as the "binding form". In the above case, the binding form is a
+vector.</p><p>The way it works is: if the binding form is a vector, Clojure assumes
+that the thing you're trying to assign to it must also be a vector,
+and so it unpacks the values from that data structure into the
+corresponding items listed in the binding form.</p><p>If you want to omit one or more of the values in the <code>games</code>, you
+can do so like this:</p><pre><code class="clojure">(let [[_ my-game _ your-game] games]
+  ...
+  ...)
+</code></pre><p>The underscore is just used as a placeholder. It's a valid identifier,
+but conventionally used when you don't care what value it gets. Above,
+my-game gets :checkers and your-game gets :cards.</p><p>Destructuring also works for maps in additon to vectors. For example,
+instead of:</p><pre><code class="clojure">(def concert {:band     "The Blues Brothers"
+              :location "Palace Hotel Ballroom"
+              :promos   "Ladies night, tonight"
+              :perks    "Free parking"})
+
+(let [band     (concert :band)
+      location (concert :location)
+      promos   (concert :promos)
+      perks    (concert :perks)]
+  ...
+  ...)
+</code></pre><p>you <em>could</em> do:</p><pre><code class="clojure">(let [{band     :band
+       location :location
+       promos   :promos
+       perks    :perks} concert]
+  ...
+  ...)
+</code></pre><p>but an even better shortcut that destructuring provides for that is:</p><pre><code class="clojure">(let [{:keys [band location promos perks]} concert]
+  ...
+  ...)
+</code></pre><h2 id="laziness">Laziness</h2><p>Most of the sequences Clojure creates (via calls to <code>map</code>, <code>reduce</code>,
+<code>filter</code>, <code>for</code>, etc. --- covered in the next section) are <em>lazy</em>. A
+lazy sequence is one that isn't <em>realized</em> (computed) all at
+once. Instead, its values are only realized when you ask for them. If
+you've only asked for the first 5 values of a lazy seq, then that seq
+consists of 5 values plus a box that makes more values only when you
+ask for them. .</p><p>A nice feature of laziness is that you can create lazy infinite
+sequences but only realize (and consume memory for) the first <em>n</em> that
+you actually need.</p><p>Be aware that the repl causes lazy lists to be fully realized if you
+ask to see their value (which one is apt to do). After using the repl
+for a while, you start to get a false sense of eagerness. <code>;)</code></p><p>If you've got some code that generates a lazy seq and you want to realize
+the whole thing right then and there, you can either use</p><ul><li><code>(doall my-lazy-seq)</code> (to get the whole thing), or else</li><li><code>(dorun my-lazy-seq)</code> (to realize each value (presumably for some
+side-effects you're expecting to get in the process) but then
+forget it as you proceed to realize the next one).</li></ul><h2 id="bread-and-butter-functions">Bread and Butter Functions</h2><p>Given Clojure's extensive use of immutability, persistent data
+structures, and laziness, one of its strong suits is functional
+programming. To this author, functional programming means:</p><ul><li>treating functions just like any other regular value (for example,
+passing them as args to other functions)</li><li>writing and using functions that return other functions</li><li>avoiding mutable state, preferring instead Clojure's functional
+alternatives (<code>map</code>, <code>filter</code>, <code>reduce</code>, etc.) or else just
+directly using recursion.</li></ul><p>Let's try out some of the power tools that Clojure comes with. In the
+subsections that follow, we've left out the corresponding links to
+clojuredocs for the given functions, but you'll probably want to read
+the docs and see the examples there to get the full story for each.</p><h3 id="map">map</h3><p>With <code>map</code> you can apply a function to every value in a collection.
+The result is a new collection. You can often use <code>map</code> instead of
+manually looping over a collection. Some examples using <code>map</code>:</p><pre><code class="klipse-clojure nohighlight">(map inc [10 20 30])
+</code></pre><pre><code class="klipse-clojure nohighlight">(map str [10 20 30])
+</code></pre><pre><code class="klipse-clojure nohighlight">;; You can define the function to be used on-the-fly:
+(map (fn [x] (str "=" x "=")) [10 20 30])
+</code></pre><pre><code class="klipse-clojure nohighlight">;; And `map` knows how to apply the function you give it
+;; to multiple collections in a coordinated way:
+(map (fn [x y] (str x y)) [:a :b :c] [1 2 3])
+</code></pre><p>When working on more than one collection at a time, <code>map</code> is smart
+enough to stop when the shorter of the colls runs out of items:</p><pre><code class="klipse-clojure nohighlight">(map (fn [x y] (str x y)) [:a :b :c] [1 2 3 4 5 6 7])
+</code></pre><h3 id="filter-and-remove">filter and remove</h3><p>Use <code>filter</code> with a predicate function to pare down a collection to
+just the values for which <code>(the-pred the-value)</code> returns true:</p><pre><code class="klipse-clojure nohighlight">(filter odd? (range 10))
+</code></pre><p>Use <code>remove</code> for the opposite effect (which amounts to <em>removing</em> the
+items for which <code>(pred val)</code> returns true):</p><pre><code class="klipse-clojure nohighlight">(remove odd? (range 10))
+</code></pre><p>You will often find yourself using these functions instead
+of writing loops like in imperative languages.</p><h3 id="apply">apply</h3><p><code>apply</code> is for when you have a function which takes individual args,
+for example, <code>max</code>, but the values you'd like to pass to it are in a
+collection. <code>apply</code> "unpacks" the items in the coll:</p><pre><code class="klipse-clojure nohighlight">(max 1 5 2 8 3)
+</code></pre><pre><code class="clojure">(max [1 5 2 8 3]) ;; ERROR
+</code></pre><pre><code class="klipse-clojure nohighlight">(apply max [1 5 2 8 3])
+</code></pre><p>A nice feature of <code>apply</code> is that you can supply extra args which
+you'd like to be treated as if they were part of the collection:</p><pre><code class="klipse-clojure nohighlight">(apply max 4 55 [1 5 2 8 3])
+</code></pre><h3 id="for">for</h3><p><code>for</code> is for generating collections from scratch (again, without
+needing to resort to manually looping). <code>for</code> is similar to Python's
+"list comprehensions". Some examples of using <code>for</code>:</p><pre><code class="klipse-clojure nohighlight">(for [i (range 10)] i)
+</code></pre><pre><code class="klipse-clojure nohighlight">(for [i (range 10)] (* i i))
+</code></pre><pre><code class="klipse-clojure nohighlight">(for [i (range 10) :when (odd? i)] [i (str "&lt;" i "&gt;")])
+</code></pre><p>Notice we snuck a "<code>:when (odd? i)</code>" in there. <code>for</code> even supports a
+<code>:let</code> modifier in there to set up your values before getting to the
+body of the <code>for</code> expression.</p><h3 id="reduce">reduce</h3><p><code>reduce</code> is a gem. You use it to apply a function to the first and
+second items in a coll and get a result. Then you apply it to the
+result you just got and the 3rd item in the coll. Then the result of
+<em>that</em> and the 4th. And so on.  The process looks something like this:</p><pre><code class="clojure">(reduce + [1 2 3 4 5])
+;; → 1 + 2   [3 4 5]
+;; → 3       [3 4 5]
+;; → 3 + 3   [4 5]
+;; → 6       [4 5]
+;; → 6 + 4   [5]
+;; → 10      [5]
+;; → 10 + 5
+;; =&gt; 5
+</code></pre><p>And, of course, you can supply your own function if you like:</p><pre><code class="clojure">(reduce (fn [x y] ...) [...])
+</code></pre><p>A nice additional feature of <code>reduce</code> is that you can supply a value
+for it to start off with:</p><pre><code class="klipse-clojure nohighlight">(reduce + 10 [1 2 3 4 5])
+</code></pre><p>This by itself is pretty handy. But it gets even better. Since you can
+supply an initial argument, and you can supply your own function, you
+can use a <em>data structure</em> as that initial argument and have your
+function "build it up" as you go. For example:</p><pre><code class="clojure">(reduce (fn [accum x]
+          (assoc accum
+                 (keyword x)
+                 (str x \- (rand-int 100))))
+        {}
+        ["hi" "hello" "bye"])
+
+;; → {}
+;; → {:hi "hi-29"}
+;; → {:hi "hi-29" :hello "hello-42"}
+;; ⇒  {:hi "hi-29" :hello "hello-42" :bye "bye-10"}
+</code></pre><p>Building up some accumulator using <code>reduce</code> and your own custom
+function is a fairly common pattern (and once again allows us to
+avoid looping and manipulations of anything mutable).</p><h3 id="partial-comp-and-iterate">partial, comp, and iterate</h3><p>With <code>partial</code> you can create a function which wraps another one and
+passes it some standard arguments every time, along with the ones you
+supply right when you call it. For example:</p><pre><code class="klipse-clojure nohighlight">(defn lots-of-args [a b c d] (str/join "-" [a b c d]))
+</code></pre><pre><code class="klipse-clojure nohighlight">(lots-of-args 10 20 30 40)
+</code></pre><pre><code class="klipse-clojure nohighlight">(def fewer-args (partial lots-of-args 10 20 30))
+</code></pre><pre><code class="klipse-clojure nohighlight">(fewer-args 40)
+</code></pre><pre><code class="klipse-clojure nohighlight">(fewer-args 99)
+</code></pre><p><code>comp</code> is for composing a function from other ones. That is, <code>(comp foo bar baz)</code> gives you a function that will first call baz on
+whatever you pass it, then bar on the result of that, then foo on the
+result of <em>that</em>, and finally returns the result.  Here's a silly
+example:</p><pre><code class="klipse-clojure nohighlight">(defn wrap-in-stars  [s] (str "*" s "*"))
+</code></pre><pre><code class="klipse-clojure nohighlight">(defn wrap-in-equals [s] (str "=" s "="))
+</code></pre><pre><code class="klipse-clojure nohighlight">(defn wrap-in-ats    [s] (str "@" s "@"))
+</code></pre><pre><code class="klipse-clojure nohighlight">(def wrap-it (comp wrap-in-ats
+                   wrap-in-equals
+                   wrap-in-stars))
+</code></pre><pre><code class="klipse-clojure nohighlight">(wrap-it "hi")
+</code></pre><pre><code class="klipse-clojure nohighlight">;; Which is the same as:
+(wrap-in-ats (wrap-in-equals (wrap-in-stars "hi")))
+</code></pre><p><code>(iterate foo x)</code> yields an infinite lazy list consisting
+of:</p><pre><code class="clojure">(x
+ (foo x)
+ (foo (foo x))
+ (foo (foo (foo x)))
+ ...)
+</code></pre><p>To just take the first, say, 5 values from an infinite list, try this:</p><pre><code class="klipse-clojure nohighlight">(defn square [x] (* x x))
+</code></pre><pre><code class="klipse-clojure nohighlight">(take 5 (iterate square 2))
+</code></pre><h2 id="looping-and-recursion">Looping and Recursion</h2><p>As you've seen in the previous section, looping is often just handled
+by various built-in functions such as <code>map</code>, <code>filter</code>, and <code>reduce</code>.
+You should use those whenever you can. For times when you need more
+manual control, you can write loops yourself. By-hand.</p><p>A <code>loop</code> expression looks like a <code>let</code>; you set up locals in its
+binding vector, then the body of the loop is executed. The body has an
+implicit do, just like <code>let</code> and function bodies. However, within the
+body of the <code>loop</code> expression you exit at some point with what you
+have or else loop again. When you loop again, you call the loop (using
+<code>recur</code>) as if it's a function, passing new values in for the ones you
+previously set up in the binding vector. The loop calling itself like
+this is called <em>recursion</em>. Here's a trivial example:</p><pre><code class="klipse-clojure nohighlight">(loop [accum []
+       i     1]
+  (if (= i 10)
+    accum
+    (recur (conj accum i)
+           (inc i))))
+</code></pre><p>The state in this loop is carried in the <code>accum</code> vector, which we
+update each time through the loop. <code>i</code> is the counter, and we finally
+exit the loop (which evaluates to <code>accum</code>) when i equals 10.</p><p><code>accum</code> could be any other data structure, and that call <code>(conj accum i)</code> could be any expression that yields a new data structure to take
+the old one's place the next time through.</p><p>You don't actually need a <code>loop</code> to use <code>recur</code>. If you use <code>recur</code> in
+a function body, it will just call the function again, replacing the
+args it was previously called with with the ones you pass to <code>recur</code>.</p><p>Finally, recall that if you just need looping for the side-effects
+only, see <code>doseq</code> and <code>dotimes</code>.</p><h2 id="reference-types">Reference Types</h2><p>Although we've been saying all along that Clojure doesn't have
+"variables", and that everything is immutable, ... that's not entirely
+true.</p><p>For when you really do need mutability, Clojure offers <em>reference
+types</em>. And Clojure provides built-in support for helping you mutate
+them in safe ways.</p><p>Aside from vars (which is a sort of special reference type), there are
+3 kinds of reference types:</p><ul><li>Atoms</li><li>Refs</li><li>Agents</li></ul><p>You might typically create a reference type like this:</p><pre><code class="clojure">(def my-atom (atom {}))
+</code></pre><p>This reference type is an atom, and its state is a hashmap (an empty
+one, for now). Here, the <code>my-atom</code> symbol refers to a var which refers
+to the atom.</p><p>Although you <em>still</em> can't literally change the value of the atom, you
+<em>can</em> swap in a new hashmap value for it any time you like. To retrieve
+the value of the atom, you "deref" it, or just use the shorter "@"
+syntax. Here's an (atom-specific) example:</p><pre><code class="klipse-clojure nohighlight">(def my-atom (atom {:foo 1}))
+</code></pre><pre><code class="klipse-clojure nohighlight">@my-atom
+</code></pre><pre><code class="klipse-clojure nohighlight">(swap! my-atom update-in [:foo] inc)
+</code></pre><pre><code class="klipse-clojure nohighlight">@my-atom
+</code></pre><p>... and we've just changed the state of the atom. (Note, <code>swap!</code> is a
+function used only for atoms. There are other specific functions for
+working with the other reference types.)</p><p>The point of having reference types is that, in your programs, you may
+want to represent an <em>identity</em>. An identity is something that may
+change its state over time, but is still the same entity,
+regardless. In Clojure, an identity is represented by a reference
+type, and its state is represented by a value.</p><p>We won't discuss reference types further in this tutorial. Perhaps
+someone will write a good topical guide...</p><h2 id="see-also">See Also</h2><ul><li><a href="https://www.4clojure.com/">4Clojure</a> --- try out what you've
+learned so far by interactively solving a set of interesting
+programming problems.</li></ul><h2 id="not-covered-in-this-tutorial">Not Covered In This Tutorial</h2><p>To keep this tutorial down to a manageable length, advanced topics or
+other far (or not so far) corners not covered herein include but
+aren't limited to: function literals, multiple-arity functions,
+exceptions, dynamic scoping of vars, namespaced keywords, metadata,
+any substantial coverage of macros, transients, zippers, delays,
+futures, promises, refs, agents or anything about multithreading,
+thread-first, thread-last, trampolines, datatypes, protocols,
+multimethods, and Java interop.</p><h2 id="contributors">Contributors</h2><p>John Gabriele <a href="mailto:jmg3000@gmail.com">jmg3000@gmail.com</a> (original author)</p>
+
+    <div id="prev-next">
+        
+        <a href="../getting_started/index.html">&laquo; Getting Started with Clojure</a>
+        
+        
+        ||
+        
+        
+        <a href="../emacs/index.html">Clojure with Emacs &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+ <link rel="stylesheet" type="text/css" href="https://storage.googleapis.com/app.klipse.tech/css/codemirror.css">
+<script>
+window.klipse_settings = {
+  "selector" : ".klipse-clojure"
+};
+</script>
+<script src="https://storage.googleapis.com/app.klipse.tech/plugin/js/klipse_plugin.js"></script> 
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/tutorials/parsing_xml_with_zippers/index.html b/clones/clojure-doc.org/articles/tutorials/parsing_xml_with_zippers/index.html
new file mode 100644
index 00000000..e032cd53
--- /dev/null
+++ b/clones/clojure-doc.org/articles/tutorials/parsing_xml_with_zippers/index.html
@@ -0,0 +1,486 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Parsing XML in Clojure</title>
+    
+
+<meta name="description" content="This work is licensed under a Creative Commons
+Attribution 3.0 Unported License (including images &amp;
+stylesheets). The source is available on
+Github.What Version of Clojure Does This Guide Cover?">
+
+<meta property="og:description" content="This work is licensed under a Creative Commons
+Attribution 3.0 Unported License (including images &amp;
+stylesheets). The source is available on
+Github.What Version of Clojure Does This Guide Cover?">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/tutorials/parsing_xml_with_zippers/" />
+<meta property="og:title" content="Parsing XML in Clojure" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/tutorials/parsing_xml_with_zippers/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Parsing XML in Clojure</h2>
+    </div>
+    
+    <p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons
+Attribution 3.0 Unported License</a> (including images &amp;
+stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on
+Github</a>.</p><h2 id="what-version-of-clojure-does-this-guide-cover">What Version of Clojure Does This Guide Cover?</h2><p>This guide covers Clojure 1.4 and Leiningen 2.x.</p><h2 id="overview">Overview</h2><p>Try as you might, XML is difficult to avoid. This is particularly true
+in the Java ecosystem. This guide will show you how to parse XML with
+the minimum amount of pain using the excellent tools available in
+Clojure.</p><h2 id="parsing-nzb-files">Parsing NZB files</h2><p>For the purpose of the tutorial I have chosen a simple and fairly well
+known XML file format: NZB. An NZB file is used to describe files to
+download from NNTP servers. In this tutorial we will take a basic NZB
+document and turn it into a Clojure map.</p><p>Let us start by creating a new project (for details on using
+Leiningen, see <a href="https://clojure-doc.org/articles/tutorials/leiningen/">this guide</a>:</p><pre><code class="bash">$ lein new nzb
+</code></pre><p>Now edit <code>project.clj</code> to contain the following:</p><pre><code class="clojure">(defproject nzb "0.1.0-SNAPSHOT"
+  :description ""
+  :url ""
+  :license {:name "Eclipse Public License"
+            :url "http://www.eclipse.org/legal/epl-v10.html"}
+  :dependencies [[org.clojure/clojure "1.4.0"]
+                 [org.clojure/data.zip "0.1.1"]])
+</code></pre><p>We are including a dependency on
+<a href="https://github.com/clojure/data.zip">clojure.data.zip</a>, which is a
+"system for filtering trees, and XML trees in particular".</p><p>Make a dir called <code>dev-resources</code> at the root of your project, and
+create a file named <code>example.nzb</code> inside of it. This will be the file
+we use to test our code (taken from
+<a href="http://en.wikipedia.org/wiki/NZB">wikipedia</a>). <code>dev-resources</code> is by
+convention the location to store file resources you use during
+development / testing.</p><p>Put the following XML in the example.nzb file:</p><pre><code class="xml">&lt;?xml version="1.0" encoding="iso-8859-1" ?&gt;
+&lt;!-- &lt;!DOCTYPE nzb PUBLIC "-//newzBin//DTD NZB 1.1//EN" "http://www.newzbin.com/DTD/nzb/nzb-1.1.dtd"&gt; --&gt;
+&lt;nzb xmlns="http://www.newzbin.com/DTD/2003/nzb"&gt;
+ &lt;head&gt;
+   &lt;meta type="title"&gt;Your File!&lt;/meta&gt;
+   &lt;meta type="tag"&gt;Example&lt;/meta&gt;
+ &lt;/head&gt;
+ &lt;file poster="Joe Bloggs &amp;lt;bloggs@nowhere.example&amp;gt;" date="1071674882" subject="Here's your file!  abc-mr2a.r01 (1/2)"&gt;
+   &lt;groups&gt;
+     &lt;group&gt;alt.binaries.newzbin&lt;/group&gt;
+     &lt;group&gt;alt.binaries.mojo&lt;/group&gt;
+   &lt;/groups&gt;
+   &lt;segments&gt;
+     &lt;segment bytes="102394" number="1"&gt;123456789abcdef@news.newzbin.com&lt;/segment&gt;
+     &lt;segment bytes="4501" number="2"&gt;987654321fedbca@news.newzbin.com&lt;/segment&gt;
+   &lt;/segments&gt;
+ &lt;/file&gt;
+&lt;/nzb&gt;
+</code></pre><p><em><em>Note</em> The eagle eyed among you will notice that I have commented out the
+DOCTYPE declaration, as this causes an Exception to be thrown. I will
+show you how to get around this towards the end of the tutorial.</em></p><p>Let's write a high level test to illustrate more clearly what we are
+trying to do. Open up the <code>test/nzb/core_test.clj</code> file and make enter
+the following:</p><pre><code class="clojure">(ns nzb.core-test
+  (:use clojure.test
+        nzb.core)
+  (:require [clojure.java.io :as io]))
+
+(deftest test-nzb-&gt;map
+  (let [input (io/resource "example.nzb")]
+    (is (= {:meta {:title "Your File!"
+                   :tag "Example"}
+            :files [{:poster "Joe Bloggs &lt;bloggs@nowhere.example&gt;"
+                     :date 1071674882
+                     :subject "Here's your file!  abc-mr2a.r01 (1/2)"
+                     :groups ["alt.binaries.newzbin"
+                              "alt.binaries.mojo"]
+                     :segments [{:bytes 102394
+                                 :number 1
+                                 :id "123456789abcdef@news.newzbin.com"}
+                                {:bytes 4501
+                                 :number 2
+                                 :id "987654321fedbca@news.newzbin.com"}]}]}
+           (nzb-&gt;map input)))))
+</code></pre><p>This should be fairly self-explanatory, I have directly translated the
+XML into Clojure data structures of maps and vectors. If we were to
+just use the <code>clojure.xml</code> library to parse the NZB file, we get a
+tree based representation. For example:</p><pre><code class="clojure">(-&gt; "example.nzb" io/resource io/file xml/parse)
+{:tag :nzb,
+ :attrs {:xmlns "http://www.newzbin.com/DTD/2003/nzb"},
+ :content
+ [{:tag :head,
+   :attrs nil,
+   :content
+   [{:tag :meta, :attrs {:type "title"}, :content ["Your File!"]}
+    {:tag :meta, :attrs {:type "tag"}, :content ["Example"]}]}
+  {:tag :file,
+   :attrs
+   {:poster "Joe Bloggs &lt;bloggs@nowhere.example&gt;",
+    :date "1071674882",
+    :subject "Here's your file!  abc-mr2a.r01 (1/2)"},
+   :content
+   [{:tag :groups,
+     :attrs nil,
+     :content
+     [{:tag :group, :attrs nil, :content ["alt.binaries.newzbin"]}
+      {:tag :group, :attrs nil, :content ["alt.binaries.mojo"]}]}
+    {:tag :segments,
+     :attrs nil,
+     :content
+     [{:tag :segment,
+       :attrs {:bytes "102394", :number "1"},
+       :content ["123456789abcdef@news.newzbin.com"]}
+      {:tag :segment,
+       :attrs {:bytes "4501", :number "2"},
+       :content ["987654321fedbca@news.newzbin.com"]}]}]}]}
+</code></pre><p>That's great, and can sometimes be enough. But I would rather work
+with the representation I have in the test. To do that, we need a way
+of traversing this tree and picking out the pieces of information we
+require. The <code>clojure.zip</code> and <code>clojure.data.zip</code> libraries are
+perfect for this. The
+<a href="http://clojure.github.com/data.zip/">documentation</a> for the
+<code>data.zip</code> library on github is nice, but it initially left me a
+little confused as to how to go about using the library (not being
+familiar with zippers).</p><h3 id="a-simple-example">A Simple Example</h3><p>Zippers allow you to easily traverse a data structure. Let's play with
+it in a REPL and start with the root node of our NZB file:</p><pre><code class="clojure">(require '[clojure.java.io :as io])
+(require '[clojure.xml :as xml])
+(require '[clojure.zip :as zip])
+(require '[clojure.data.zip.xml :as zip-xml])
+
+(def root (-&gt; "example.nzb" io/resource io/file xml/parse zip/xml-zip))
+</code></pre><p>Now we have a zipper for the root element of our document, we can
+start traversing it for information. The two main functions we will
+use for this are <code>xml-&gt;</code> and <code>xml1-&gt;</code>. The former returns a sequence
+of items based on the predicates given to it, the latter returning the
+first matching item. As an example, let's get the meta data from the NZB
+document <code>root</code> and create a Clojure map:</p><pre><code class="clojure">(into {}
+      (for [m (zip-xml/xml-&gt; root :head :meta)]
+        [(keyword (zip-xml/attr m :type))
+         (zip-xml/text m)]))
+;; =&gt; {:title "Your File!", :tag "Example"}
+</code></pre><p>A couple of things are happening here. First of all we use <code>xml-&gt;</code> to
+return a sequence of <code>&lt;meta&gt;</code> tags that live under the <code>&lt;head&gt;</code> tag:</p><pre><code class="clojure">(zip-xml/xml-&gt; root :head :meta)
+</code></pre><p>We use the <code>for</code> list comprehension macro to evaluate each item in the
+sequence. For each item we find the contents of the <code>:type</code> attribute
+using the <code>attr</code> function:</p><pre><code class="clojure">(keyword (zip-xml/attr m :type))
+</code></pre><p>This returns us the contents of the attribute as a string, which we
+turn into a <code>keyword</code> to use as the key in the map. We then use the
+<code>text</code> function to get the textual contents of the meta tag:</p><pre><code class="clojure">(zip-xml/text m)
+</code></pre><p>We make a tuple of these values, and pass the resulting sequence to
+<code>into</code> to build the map.</p><h2 id="putting-it-together">Putting It Together</h2><p>Using only these functions, we can parse the raw XML into the Clojure
+data structure from our unit test. If you like, open
+<code>./src/nzb/core.clj</code>, and make the changes as you read along.</p><p>First let's define our <code>nzb-&gt;map</code> function from the test, and pull in
+the code we have already written for parsing the metadata of the NZB:</p><pre><code class="clojure">(ns nzb.core
+  (:require [clojure.xml :as xml]
+            [clojure.java.io :as io]
+            [clojure.zip :as zip]
+            [clojure.data.zip.xml :as zip-xml]))
+
+(defn meta-&gt;map
+  [root]
+  (into {}
+        (for [m (zip-xml/xml-&gt; root :head :meta)]
+          [(keyword (zip-xml/attr m :type))
+           (zip-xml/text m)])))
+
+(defn file-&gt;map
+  [file]
+  ;; TODO
+)
+
+(defn nzb-&gt;map
+  [input]
+  (let [root (-&gt; input
+                 io/input-stream
+                 xml/parse
+                 zip/xml-zip)]
+    {:meta  (meta-&gt;map root)
+     :files (mapv file-&gt;map (zip-xml/xml-&gt; root :file))}))
+</code></pre><p>The only new thing here is the use of <code>io/input-stream</code> to allow us to
+use anything as <code>input</code> that the <code>io/input-stream</code> supports. These are
+currently <code>OutputStream</code>, <code>File</code>, <code>URI</code>, <code>URL</code>, <code>Socket</code>, <code>byte array</code>, and <code>String</code> arguments. See the
+<a href="http://clojure.github.com/clojure/clojure.java.io-api.html">clojure.java.io</a>
+docs for details.</p><p>Now let's fill in the <code>file-&gt;map</code> function:</p><pre><code class="clojure">(defn segment-&gt;map
+  [seg]
+  {:bytes  (Long/valueOf (zip-xml/attr seg :bytes))
+   :number (Integer/valueOf (zip-xml/attr seg :number))
+   :id     (zip-xml/xml1-&gt; seg zip-xml/text)})
+
+(defn file-&gt;map
+  [file]
+  {:poster   (zip-xml/attr file :poster)
+   :date     (Long/valueOf (zip-xml/attr file :date))
+   :subject  (zip-xml/attr file :subject)
+   :groups   (vec (zip-xml/xml-&gt; file :groups :group zip-xml/text))
+   :segments (mapv segment-&gt;map
+                   (zip-xml/xml-&gt; file :segments :segment))})
+</code></pre><p>Again, nothing new. We simply pick out the pieces of the document we
+wish to process using a combination of the <code>xml1-&gt;</code>, <code>xml-&gt;</code>, <code>attr</code>,
+and <code>text</code> functions. Run the test, and it should pass.</p><h3 id="prevent-parsing-the-dtd">Prevent Parsing the DTD</h3><p>Interestingly, if we uncomment the DTD declaration in the
+<code>example.nzb</code> file, our code now explodes with an Exception:</p><pre><code>org.xml.sax.SAXParseException: The markup declarations contained or pointed to by the document type declaration must be well-formed
+</code></pre><p>We can fix this by swapping out the <code>SAXParserFactory</code> and setting a
+feature to not validate the DTD. Here's how:</p><p>Update the <code>ns</code> declaration to include some required classes:</p><pre><code class="clojure">(ns nzb.core
+  (:require [clojure.xml :as xml]
+            [clojure.java.io :as io]
+            [clojure.zip :as zip]
+            [clojure.data.zip.xml :as zip-xml])
+  (:import (javax.xml.parsers SAXParser SAXParserFactory)))
+</code></pre><p>Define a function to switch out the SAXParserFactory:</p><pre><code class="clojure">(defn startparse-sax
+  "Don't validate the DTDs, they are usually messed up."
+  [s ch]
+  (let [factory (SAXParserFactory/newInstance)]
+    (.setFeature factory "http://apache.org/xml/features/nonvalidating/load-external-dtd" false)
+    (let [^SAXParser parser (.newSAXParser factory)]
+      (.parse parser s ch))))
+</code></pre><p>Update our nzb-&gt;map definition to use it:</p><pre><code class="clojure">(defn nzb-&gt;map
+  [input]
+  (let [root (-&gt; input
+                 io/input-stream
+                 (xml/parse startparse-sax)
+                 zip/xml-zip)]
+    {:meta  (meta-&gt;map root)
+     :files (mapv file-&gt;map (zip-xml/xml-&gt; root :file))}))
+</code></pre><p>Yay, our test passes again.</p><h2 id="query-predicates">Query Predicates</h2><p>There are a few other useful functions in the <code>clojure.data.zip.xml</code>
+ns we haven't yet looked at, namely: <code>text=</code>, <code>attr=</code>, and <code>tag=</code>.
+These functions allow you to construct query predicates to run against
+a given node. As an example, let's pull out the first file segment
+from the <code>example.nzb</code> file using the <code>attr=</code> function:</p><pre><code class="clojure">(zip-xml/xml1-&gt; root
+                :file
+                :segments
+                :segment
+                (zip-xml/attr= :number "1"))
+                zip-xml/text)
+"123456789abcdef@news.newzbin.com"
+</code></pre><p>From the root node of the document we reach down into <code>:file</code>,
+<code>:segments</code>, and <code>:segment</code> in turn, then use the <code>attr=</code> query
+predicate to match a <code>:segment</code> with a value of <code>"1"</code>.</p><p>Interestingly enough, the other two query predicates have shortcuts
+for their use. You have already been using the <code>tag=</code> query predicate
+every time you use a keyword to locate a tag. To use the <code>text=</code>
+predicate easily, just use a string. For example, to retrieve the
+second <code>:segment</code> based on its content of
+<code>987654321fedbca@news.newzbin.com</code>:</p><pre><code class="clojure">(zip-xml/xml1-&gt; root
+                :file
+                :segments
+                :segment
+                "987654321fedbca@news.newzbin.com")
+;; ... the resulting node
+</code></pre><p>Finally, you can combine these query predicates to match multiple
+things on a given node by using a vector:</p><pre><code class="clojure">(zip-xml/xml1-&gt; root
+                :file
+                :segments
+                :segment
+                [(zip-xml/attr= :number "1")
+                 (zip-xml/attr= :bytes "102394")]
+                zip-xml/text)
+"123456789abcdef@news.newzbin.com"
+</code></pre><p>Here we are matching on both the <code>:number</code> attribute being <code>"1"</code>, and
+the <code>:bytes</code> attribute being <code>"102394"</code>. Obviously, you can use
+strings here to match against content too.</p><h2 id="creating-new-predicates">Creating New Predicates</h2><p>OK, now let's suppose we want to use some kind of numerical comparison
+in our XML (like we might do with XPath). As it stands, we have no way
+to do that with the built-in functions but we can easily define our
+own.</p><p>Let's start with a general function for comparing attribute values:</p><pre><code class="clojure">(defn attr-fn
+  [attrname f test-val &amp; [conv-fn]]
+  (fn [loc]
+    (let [conv-fn (or conv-fn identity)
+          val (conv-fn (zip-xml/attr loc attrname))]
+      (f val test-val))))
+</code></pre><p>This function takes an attribute name (<code>attrname</code>), a function for
+making a comparison (<code>f</code>), a value to test agains (<code>test-val</code>) and
+optionally a conversion function. Imagine our <code>example.nzb</code> file had
+100 segments, and we only wanted to get segments over 75. We could now
+achieve this using our general function:</p><pre><code class="clojure">(zip-xml/xml-&gt; root
+               :file
+               :segments
+               :segment
+               (attr-fn :number &gt; 75 #(Long/valueOf %))
+               zip-xml/text)
+</code></pre><p>Let's provide a helper for this to make the syntax clearer:</p><pre><code class="clojure">(defn attr&gt;
+  [attrname val]
+  (attr-fn attrname &gt; val #(Long/valueOf %)))
+
+(zip-xml/xml-&gt; doc
+               :file
+               :segments
+               :segment
+               (attr&gt; :number 75)
+               zip-xml/text)
+</code></pre><p>We could build a whole suite of helper functions for examining XML
+nodes, if we are unlucky enough to be required to do so :)</p><h2 id="conclusion">Conclusion</h2><p>I hope these simple examples have given you an idea of the ease with
+which you can process XML using Clojure, and how simple it is to
+extend the tools already provded in interesting directions.</p><h2 id="contributors">Contributors</h2><p><a href="http://blog.gaz-jones.com">Gareth Jones</a>, 2012 (original author)</p>
+
+    <div id="prev-next">
+        
+        <a href="../basic_web_development/index.html">&laquo; Basic Web Development</a>
+        
+        
+        ||
+        
+        
+        <a href="../growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="../vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/articles/tutorials/vim_fireplace/index.html b/clones/clojure-doc.org/articles/tutorials/vim_fireplace/index.html
new file mode 100644
index 00000000..1c62c093
--- /dev/null
+++ b/clones/clojure-doc.org/articles/tutorials/vim_fireplace/index.html
@@ -0,0 +1,271 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides: Clojure with Vim and fireplace.vim</title>
+    
+
+<meta name="description" content="This work is licensed under a Creative Commons
+Attribution 3.0 Unported License (including images &amp;
+stylesheets). The source is available on
+Github.Overview">
+
+<meta property="og:description" content="This work is licensed under a Creative Commons
+Attribution 3.0 Unported License (including images &amp;
+stylesheets). The source is available on
+Github.Overview">
+
+<meta property="og:url" content="https://clojure-doc.github.io/articles/tutorials/vim_fireplace/" />
+<meta property="og:title" content="Clojure with Vim and fireplace.vim" />
+<meta property="og:type" content="article" />
+
+    <link rel="canonical" href="https://clojure-doc.github.io/articles/tutorials/vim_fireplace/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="../../../css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="../../../index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li ><a href="../../../index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="custom-page">
+    <div id="page-header">
+        <h2>Clojure with Vim and fireplace.vim</h2>
+    </div>
+    
+    <p>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons
+Attribution 3.0 Unported License</a> (including images &amp;
+stylesheets). The source is available <a href="https://github.com/clojure-doc/clojure-doc.github.io">on
+Github</a>.</p><h2 id="overview">Overview</h2><p><a href="https://github.com/tpope/vim-fireplace">fireplace.vim</a> is a Vim plugin developed by <a href="http://tpo.pe/">Tim Pope</a> which provides support for the "dynamic" aspects of Clojure development. Namely, connection to an <a href="https://github.com/clojure/tools.nrepl">nREPL</a> server, code evaluation, code completion, and basically everything beyond syntax highlighting and indentation.</p><p>This guide will cover installation and some basic usage within a typical Clojure project.</p><h2 id="about-the-name">About the Name</h2><p><em>fireplace was once called foreplay, but people weren't ready for that, so now it's fireplace</em></p><h2 id="what-about-vimclojure">What About VimClojure?</h2><p>Until recently (late 2012), VimClojure was the preeminent plugin for Clojure development in Vim. Since then, its developer, Meikel Brandmeyer, has <a href="https://groups.google.com/forum/?fromgroups=#!topic/vimclojure/B-UU8qctd5A">acknowledged</a> that VimClojure development has slowed to a trickle and that fireplace is the future. That said, VimClojure is still a viable and excellent development evironment.</p><h2 id="what-versions-of-clojure-and-fireplace-does-this-guide-cover">What Versions of Clojure and fireplace Does This Guide Cover?</h2><p>This guide covers Clojure 1.4 and the latest version of fireplace as of January 2013. It should work on most versions of both.</p><h2 id="essential-references">Essential References</h2><p>fireplace.vim lives on <a href="https://github.com/tpope/vim-fireplace">github</a>. That's the source of truth for development and where issues should be reported.</p><p>The <a href="https://groups.google.com/forum/?fromgroups#!forum/vimclojure">vimclojure mailing list</a> remains the primary place to get help and ask questions related to Clojuring in Vim.</p><p>Finally, don't forget the documentation that comes with the plugin itself. All features are documented there in standard Vim help format. Just <code>:help fireplace</code>, or <a href="https://github.com/tpope/vim-fireplace/blob/master/doc/fireplace.txt">view it online</a>. <em>I'm dead serious. READ THIS FILE.</em></p><h2 id="how-fireplacevim-works">How fireplace.vim Works</h2><p>Before using fireplace, it's useful to have a basic understanding of how it works, especially when it comes to evaluating Clojure code. This will help avoid confusion and tears. fireplace itself is a collection of VimScript code running withing Vim. When it needs to evaluate some Clojure code (for example, you just required a namespace, or gave it a command to run the tests in a namespace) it sends commands to an nREPL server embedded in a Java Virtual Machine (JVM).</p><p><em>Note that because fireplace evaluates code synchronously, so if you evaluate a long-running command, <strong>your entire Vim process will be blocked/frozen</strong> until the operation completes. More on this below.</em></p><p>Usually the task of running an nREPL server falls to Leiningen, but fireplace can connect to any nREPL server. See the <a href="https://github.com/clojure/tools.nrepl">nREPL docs</a> for details.</p><h2 id="installing-vim">Installing Vim</h2><p>TODO: Someone should write Vim installation instructions and basic usage here.</p><h3 id="osx">OSX</h3><ul><li>Install <a href="http://mxcl.github.com/homebrew/">Homebrew</a></li><li>The dance: <code>brew update</code></li><li>If you're like me, you tend to inspect a homebrew formula's options before installing: <code>brew options macvim</code></li><li>And if you're like me: <code>brew install --override-system-vim macvim</code></li><li>Optionally you can: <code>brew linkapps</code> which will, by default, create a symlink to <code>MacVim.app</code> in <code>~/Applications</code>.</li><li>Assuming your <code>PATH</code> is set correctly, you can run vim from the command line by typing <code>mvim</code></li><li>If you'd rather launch it from the dock, you can navigate to <code>~/Applications</code> and double-click <code>MacVim.app</code> assuming you've run <code>brew linkapps</code></li></ul><h3 id="debianubuntu">Debian/Ubuntu</h3><ul><li>Install: <code>sudo apt-get install vim</code></li><li>Create your .vimrc and a couple of vim-related dirs:
+<ul><li><code>touch ~/.vimrc &amp;&amp; mkdir ~/.vim &amp;&amp; mkdir ~/.vim/bundle</code></li></ul></li><li>Install <a href="https://github.com/tpope/vim-pathogen">pathogen</a> to make the future of vim plugin installs a breeze.</li><li>Enjoy the wonderful world of vim.</li></ul><h3 id="windows">Windows</h3><ul><li>Search and install gvim anywhere on your computer.</li><li>Make sure that <code>echo %HOME%</code> and <code>echo %userprofile%</code> is set to something typical as <code>C:\Users\user</code>.</li><li>Check your vim runtimepath with <code>:echo &amp;rtp</code> in vim. This is where your vim searches.</li><li>Note: The UNIX <code>.vimrc</code> is the windows<code>_vimrc</code> and the UNIX <code>.vim</code> is the Windows <code>vimfiles</code>!</li><li>Now make sure that both <code>.vimrc</code> and <code>vimfiles</code> live in the desired location (as e.g. <code>C:\Users\user</code>) so that the vim runtimepath can find it.</li><li>Test it by putting something as A) in the <code>_vimrc</code> as <code>set number</code> and as B) in the <code>vimfiles\colors\</code> as the solarized color scheme (and refer to it in _vimrc with <code>colorscheme solarized</code>).</li></ul><h2 id="installing-fireplacevim">Installing fireplace.vim</h2><p>Because fireplace.vim handles only the dynamic aspects of Clojure development, a separate plugin, <a href="https://github.com/guns/vim-clojure-static">vim-clojure-static</a> (extracted from VimClojure and maintained by <a href="https://github.com/guns">Sung Pae</a>) includes support for syntax highlighting, indentation, etc. You'll want to install both for a pleasant experience.</p><p>Installation is covered thoroughly in the <a href="https://github.com/tpope/vim-fireplace/blob/master/README.markdown">fireplace README</a>. Since it's likely to be most up-to-date, we'll defer to it for purposes of installation.</p><p>Once installed, there's really nothing to configure. Yay!</p><h2 id="vim-basics">Vim Basics</h2><p><code>vimtutor</code> is a ~30 minute tutorial on the bare basics of using Vim. It is included with Vim and it will get your some real experience editing text with Vim.</p><p>On Unix-based systems(ie: Mac, Linux), if Vim has been properly installed, you can start <code>vimtutor</code> from the shell.</p><p>On MS-Windows you can find it in the Program/Vim menu or execute vimtutor.bat from your Vim installation directory.</p><p>For more information on vimtutor and how to use it on other platforms, run <code>:help tutor</code> inside vim.</p><p>It is also recommended to have a cheat sheet handy when starting out so you have the commands in front of you if you need them. There are a lot of options available, but <a href="http://www.viemu.com/vi-vim-cheat-sheet.gif">this one</a> is fairly clean and makes a lot of sense after running through <code>vimtutor</code>.</p><h2 id="basics">Basics</h2><p>Let's go through the process of creating a simple project to demonstrate some of fireplace.vim's capabilities.
+Because this author is a little lazy, we'll use the same example as the <a href="../emacs/index.html">emacs tutorial</a>. That is, a simple
+command-line argument parser.</p><p>First, we'll need a new project:</p><pre><code>$ lein new command-line-args
+$ cd command-line-args
+</code></pre><p>Now we need to start up Vim as well as the nREPL server. Luckily, just running the Leiningen 2 REPL will start up a server for us. If you're using console Vim, I suggest running
+each in its own console.</p><p>In console 1:</p><pre><code>$ lein repl
+nREPL server started on port 58197
+... REPL help message elided ...
+user=&gt;
+</code></pre><p>Nice. And in console 2:</p><pre><code>$ vim
+</code></pre><p>If you're using gvim, just start gvim and then run the REPL:</p><pre><code>$ gvim
+$ lein repl
+nREPL server started on port 58197
+... REPL help message elided ...
+user=&gt;
+</code></pre><p><em>fireplace.vim will automatically figure out the nREPL port from the <code>target/repl-port</code> file written by Leiningen.</em></p><p>Now we can start editing code (see <a href="index.html#editing">Editing</a> below for tips on effectively editing Clojure code in Vim).</p><p>Let's add a simple test. Execute <code>:e test/command_line_args/core_test.clj</code>, enter insert mode and add the following to the file:</p><pre><code class="clojure">(deftest pairs-of-values
+   (let [args ["--server" "localhost"
+               "--port" "8080"
+               "--environment" "production"]]
+      (is (= {:server "localhost"
+              :port "8080"
+              :environment "production"}
+              (parse-args args)))))
+</code></pre><p>To run the test, save the file, <code>:w</code>, and now we'll invoke our first fireplace.vim command, <code>cpr</code>. <em>All commands are run in normal mode, so bang on escape a few times first</em>. This performs a <code>(require ... :reload)</code> on the current buffer/namespace. Here we don't even get a chance to run the test. The code doesn't even compile because <code>command-line-args.core/parse-args</code> hasn't been defined yet. Let's fix that.</p><p><em>Note: Anytime fireplace reports an exception in a namespace, you can get the full stack trace by opening Vim's "location list" with <code>:lopen</code>. Hit enter on a Clojure stack frame to jump to the relevant source.</em></p><p>The easiest way to get to the <code>command-line-args.core</code> namespace is to put your cursor on <code>command-line-args.core</code> in the <code>ns</code> declaration at the top of the file and hit <code>gf</code>. This key combination will open the file for the namespace under the cursor. <em>It even works for namespaces in jar files!</em></p><p>Next add the following definition in the <code>command-line-args.core</code> namespace:</p><pre><code class="clojure">(defn parse-args [args]
+  {})
+</code></pre><p><em>Tip: Use <code>ctrl-w f</code> (ctrl-w followed by the f key) to split the view into two windows opening the file under the cursor in a new split.</em></p><p>Save the file, <code>:w</code>, and then switch back to <code>test/command_line_args/core_test.clj</code>. Now we can try requiring the test namespace again. This time we'll type <code>:Require!</code>, which performs a <code>(require ... :reload-all)</code> on the current namespace. That should succeed, so we can run the tests with the command <code>:Eval (clojure.test/run-tests)</code> which will print out a test failure with something like this:</p><pre><code>Testing command-line-args.core-test
+
+FAIL in (pairs-of-values) (core_test.clj:9)
+expected: (= {:server "localhost", :port "8080", :environment "production"} (parse-args args))
+  actual: (not (= {:server "localhost", :environment "production", :port "8080"} {}))
+
+Ran 1 tests containing 1 assertions.
+1 failures, 0 errors.
+{:type :summary, :pass 0, :test 1, :error 0, :fail 1}
+</code></pre><p>Note that we know a few fireplace commands now:</p><ul><li><code>gf</code> - Jumps to the namespace under the cursor</li><li><code>cpr</code> and <code>:Require!</code> - <code>(require :reload)</code> or <code>(require :reload-all)</code> the current namespace.</li><li><code>:Eval (clojure code)</code> - Evaluate arbitrary Clojure code in the current namespace.</li><li><code>:lopen</code> - Not really a fireplace command, but it opens the stacktrace for the last exception in the buffer.</li></ul><p>Now we can fix some errors. Return to <code>command-line-args.core</code> and edit:</p><pre><code class="clojure">(defn parse-args [args]
+  (apply hash-map args))
+</code></pre><p>Running our tests again we get another error:</p><pre><code>Testing command-line-args.core-test
+
+FAIL in (pairs-of-values) (core_test.clj:9)
+expected: (= {:server "localhost", :port "8080", :environment "production"} (parse-args args))
+  actual: (not (= {:server "localhost", :environment "production", :port "8080"} {"--port"
+ "8080", "--server" "localhost", "--environment" "production"}))
+
+Ran 1 tests containing 1 assertions.
+1 failures, 0 errors.
+{:type :summary, :pass 0, :test 1, :error 0, :fail 1}
+</code></pre><p>We need to strip off those dashes and turn them into keywords. Back to <code>core.clj</code> again. Let's take a different route this time. Put your cursor on <code>parse-args</code> in the test file and hit <code>] ctrl-D</code> (two keystrokes). That jumps right to <code>parse-args</code>. Now we can fix it up:</p><pre><code class="clojure">(defn parse-args [args]
+  (into {} (map (fn [[k v]] [(keyword (.replace k "--" "")) v])
+                (partition 2 args))))
+</code></pre><p>and the test passes.</p><p><em>Tip</em>: During testing you may get into the situation where you've deleted an old, possibly failing, test, yet it still runs because it's still in memory. Supposing the name of the test is <code>a-test</code>, you have a few options:</p><ul><li>Hit <code>cqp</code> (or use <code>:Eval</code>) and run <code>(ns-unmap *ns* 'a-test)</code> to remove the test from the namespace.</li><li>Restart the Leiningen REPL. fireplace will re-initialize the connection the next time you run a command.</li></ul><p>Wondering what <code>clojure.core/ns-unmap</code> does? In fireplace, use the command <code>:Doc ns-unmap</code> to see the docstring. If a symbol's under your cursor you can just hit <code>shift-K</code> to do the same thing.</p><h2 id="the-quasi-repl-and-evaluating-code">The Quasi-REPL and Evaluating Code</h2><p>Note we've learned another handy command, <code>cqp</code>, which opens fireplace's "quasi-repl" where you can execute Clojure code in the current namespace. Tab-completion and command history are supported there as you'd expect. If you need to do a little more editing or you'd like to edit and re-run a previous command, hit <code>cqc</code> to bring up a command-line window similar to what you'd get with <code>q:</code> in normal Vim.</p><p>Many times you'd like to just evaluate some snippet of code. fireplace.vim really shines here because it brings idiomatic Vim to bear on the problem. For example, it's common to have a snippet of test code you're playing with in a namespace, often in a <code>(comment )</code> at the end of the file. Let's say we have something like this:</p><pre><code class="clojure">(comment
+  (my-service-call (choose-server load-balancer)
+                   (normalize-request { ... request map ...})))
+</code></pre><p>Say we wanted to evaluate the entire <code>(my-service-call ...)</code> expression. There are a few ways to do this:</p><ul><li>Put the cursor on <code>my-service-call</code> and hit <code>cpp</code>. This evaluates the inner-most expression containing the cursor</li><li>Put the cursor on the opening paren and hit <code>cp%</code>. <code>cp</code> followed by a Vim text motion (see below) executes the text described by that motion. We could also do, for example <code>cpiw</code> (inner word) to look at the value of the symbol under the cursor.</li><li>Put the cursor on the opening paren and hit <code>cq%</code>. This will grab the text (the <code>%</code> text motion again) and pre-populate the command-line window (<code>cqc</code> above) with the expression.</li></ul><p>With all that it's easy to see we can evaluate the whole <code>my-service-call</code> expression, or any of the sub-expressions in the comment. Furthermore, if you're code's all referentially transparent and everything, the <code>cpX</code> family of commands have cousins of the form <code>c!X</code> which replace the expression with its result.</p><h2 id="the-non-quasi-repl">The (non-quasi) REPL</h2><p>Unlike VimClojure, fireplace.vim doesn't have an integrated REPL. I (DR) miss it a little, but <a href="https://github.com/trptcolin/reply">REPL-y</a>, the REPL that ships with Leiningen is very nice and since it's separated from Vim there's much less chance of locking up Vim with a long-running or infinite operation.</p><p>Keep in mind that the nREPL server (the lein REPL) and fireplace are both playing in the same JVM. fireplace can see changes you make in nREPL and vice versa. So you can make some changes, save and hit <code>cpr</code> to reload the namespace and switch over to the REPL and the changes will be there.</p><h2 id="editing">Editing</h2><p>This section includes some tips on basic Clojure code editing in Vim.</p><p>TODO: Move this to a separate, more general doc?</p><h3 id="words">"Words"</h3><p>The <code>vim-clojure-static</code> plugin makes some minor adjustments to Vim's settings to improve the editing experience. In particular, it extends the notion of a "word" (<code>:help word</code>) to include additional characters like <code>-</code> (hyphen), <code>.</code> (dot), etc. This changes has a number of effects:</p><ul><li>Insert mode code completion (<code>ctrl-n</code> and <code>ctrl-p</code>) will complete words with hyphens which is very common in Clojure code</li><li>The insanely useful, magical "star" (<code>*</code>) operator in normal mode will search for the full Clojure symbol under the cursor, including dots, hyphens, etc.</li><li>Word motions (<code>:help w</code>), include dots, hyphens, etc. So <code>dw</code> in normal mode will delete an entire Clojure symbol.</li></ul><h3 id="wrangling-parentheses">Wrangling Parentheses</h3><p>The most effective way to edit Clojure code is <em>structurally</em> with <a href="https://bitbucket.org/kovisoft/paredit/overview">paredit.vim</a>, but if you don't have time to learn that, Vim still brings a lot to the table for dealing with all the parentheses in Clojure code.</p><p>First, obviously, the <code>%</code> motion (<code>:help %</code>) is very useful. In normal mode, put the cursor on an opening or closing paren and you can:</p><ul><li>Hit <code>%</code> to jump to the matching paren.</li><li>Hit <code>d%</code> to delete the parens and everything they contain.</li><li>Hit <code>y%</code> to "yank"/copy the parens and everything in them.</li><li>Hit <code>c%</code> to delete the parens and the text they contain and start editing.</li><li>Hit <code>v%</code> to select the parens and the text they contain visually.</li></ul><p>The <code>%</code> motion is useful, but it's often more convenient to work with Vim's "block" text object (<code>:help text-objects</code>). This manifests in two forms. First, <code>ab</code> ("all block") which is an entire form, including the parentheses. Second, <code>ib</code> ("inner block") which is all the text within the enclosing parentheses. So, put your cursor anywhere within some parentheses in normal mode and you can:</p><ul><li>Hit <code>dab</code> ("delete all block") to delete the entire form.</li><li>Hit <code>dib</code> ("delete inner block") to delete everything inside the parens.</li><li>Hit <code>cab</code> ("change all block") to delete the entire form and enter insert mode.</li><li>Hit <code>cib</code> ("change inner block") to delete the contents of the form, preserving parens, and enter insert mode.</li><li>Hit <code>yab</code> ("yank all block") to copy the entire form including parens.</li><li>Hit <code>yib</code> ("yank inner block") to copy the everything inside the parens.</li></ul><p>And so on. Getting these commands in muscle memory can really speed up working with Clojure forms.</p><p><em>Tip: Vim has text objects for blocks enclosed in square brackets (vectors), quotes (strings), curly braces (maps, sets) etc. They're all invaluable. <code>:help text-objects</code> !!!</em></p><h2 id="code-completion">Code Completion</h2><p>Some code completion is available with fireplace. It is built using Vim's <code>omni-complete</code>
+system. When typing a symbol, hit <code>ctrl-x ctrl-o</code> to start omni-complete. A popup with a
+list of suggestions will appear. Use <code>ctrl-n</code> and <code>ctrl-p</code> to change the selection and hit
+enter to expand a selection into the buffer.</p><p>Note that Vim's built-in code completion, <code>ctrl-n</code> and <code>ctrl-p</code> in insert mode, also work fine while editing Clojure code.</p><h2 id="getting-documentation">Getting Documentation</h2><p>fireplace has handy shortcuts for getting documentation for Clojure functions:</p><ul><li><code>shift-K</code>: Lookup the doc string for the symbol under the cursor. Works for Java classes as well.</li><li><code>:Doc</code>: Lookup the doc string for a symbol entered in a prompt. Works for Java classes as well.</li></ul><p>And since source code is often the best/only documentation in Clojure:</p><ul><li><code>[d</code>: display the source for the symbol under the cursor</li><li><code>:Source</code>: display the source code for a symbol entered in a prompt</li></ul><h2 id="other-resources">Other Resources</h2><h2 id="contributors">Contributors</h2><p><a href="http://darevay.com">Dave Ray</a>, 2013 (original author)</p>
+
+    <div id="prev-next">
+        
+        <a href="../emacs/index.html">&laquo; Clojure with Emacs</a>
+        
+        
+        ||
+        
+        
+        <a href="../eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development &raquo;</a>
+        
+    </div>
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="../../about/index.html">About</a></li>
+                    
+                    <li><a href="../../content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="../getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="../introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="../emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="../eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="../basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="../parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="../growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="../../language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="../../language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="../../language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="../../language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="../../language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="../../language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="../../language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="../../language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="../../language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="../../language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="../../ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="../../ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="../../ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="../../ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="../../ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="../../ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="../../ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="../../ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="../../cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="../../cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="../../cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="../../cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="../../ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="../../ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="../../../js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/css/screen.css b/clones/clojure-doc.org/css/screen.css
new file mode 100644
index 00000000..1bdb661a
--- /dev/null
+++ b/clones/clojure-doc.org/css/screen.css
@@ -0,0 +1,168 @@
+h1, h2, h3, h4, h5, h6 {
+    font-family: 'Alegreya';
+}
+
+body {
+    color: #333;
+    background-color: #f2f2f2;
+    font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif;
+    font-size: 16px;
+}
+
+.container {
+    max-width: 1000px;
+}
+
+.right {
+    float: right;
+    text-align: right;
+}
+
+.navbar {
+    border-radius: 0;
+    box-shadow: 0 0 0 0,0 6px 12px rgba(34,34,34,0.3);
+}
+
+.navbar-default {
+    background-color: #428bca;
+    border: none;
+}
+
+.navbar-default .navbar-brand {
+    color: #fff;
+    font-family: 'Alegreya';
+}
+
+.navbar-default .navbar-brand:hover {
+    color: #fff;
+}
+
+.navbar-default .navbar-nav li a {
+    color: #fff;
+}
+
+.navbar-default .navbar-nav li a:hover {
+    color: #fff;
+    background-color: #3d80ba;
+}
+
+.navbar-default .navbar-nav .active a {
+    color: #fff;
+    background-color: #3d80ba;
+}
+
+.navbar-default .navbar-toggle:hover{
+    background-color: #3d80ba;
+}
+
+.navbar-default .navbar-toggle .icon-bar {
+    background-color: #fff;
+}
+
+#sidebar {
+    margin-left: 15px;
+    margin-top: 50px;
+}
+
+#content {
+    background-color: #fff;
+    border-radius: 3px;
+    box-shadow: 0 0 0 0,0 6px 12px rgba(34,34,34,0.1);
+}
+
+#content img {
+    max-width: 100%;
+    height: auto;
+}
+
+footer {
+    font-size: 14px;
+    text-align: center;
+    padding-top: 75px;
+    padding-bottom: 30px;
+}
+
+blockquote footer {
+    text-align: left;
+    padding-top: 0px;
+    padding-bottom: 0px;
+}
+
+#post-tags {
+    margin-top: 30px;
+}
+
+#prev-next {
+    padding: 15px 0;
+}
+
+.post-header {
+    margin-bottom: 20px;
+}
+.post-header h2 {
+    font-size: 32px;
+}
+
+#post-meta {
+    font-size: 14px;
+    color: rgba(0,0,0,0.4)
+}
+
+#page-header {
+    border-bottom: 1px solid #dbdbdb;
+    margin-bottom: 20px;
+}
+#page-header h2 {
+    font-size: 32px;
+}
+
+pre {
+    overflow-x: auto;
+}
+pre code {
+    display: block;
+    padding: 0.5em;
+    overflow-wrap: normal;
+    white-space: pre;
+}
+
+code {
+    color: #428bca;
+}
+
+pre, code, .hljs {
+    background-color: #f7f9fd;
+}
+
+@media (min-width: 768px) {
+    .navbar {
+        min-height: 70px;
+    }
+    .navbar-nav>li>a {
+        padding: 30px 20px;
+    }
+    .navbar-default .navbar-brand {
+        font-size: 36px;
+        padding: 25px 15px;
+    }
+    #content{
+        margin-top: 30px;
+        padding: 30px 40px;
+    }
+}
+
+@media (max-width: 767px) {
+    body{
+        font-size: 14px;
+    }
+    .navbar-default .navbar-brand {
+        font-size: 30px;
+    }
+    #content{
+        padding: 15px;
+    }
+    #post-meta .right {
+        float:left;
+        text-align: left;
+    }
+}
diff --git a/clones/clojure-doc.org/index.html b/clones/clojure-doc.org/index.html
new file mode 100644
index 00000000..550a0862
--- /dev/null
+++ b/clones/clojure-doc.org/index.html
@@ -0,0 +1,237 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<head>
+    <meta charset="utf-8"/>
+    <title>Clojure Guides</title>
+    
+    <meta name="description" content="Clojure Documentation">
+    <meta name="keywords" content="">
+    
+    <link rel="canonical" href="https://clojure-doc.github.io/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Alegreya:400italic,700italic,400,700" rel="stylesheet"
+          type="text/css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/css/bootstrap.min.css">
+    <link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.2.0/css/font-awesome.min.css" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.7.0/styles/default.min.css">
+    <link href="css/screen.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+
+
+<nav class="navbar navbar-default">
+    <div class="container">
+        <div class="navbar-header">
+            <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+                <span class="sr-only">Toggle navigation</span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+                <span class="icon-bar"></span>
+            </button>
+            <a class="navbar-brand" href="index.html">Clojure Guides</a>
+        </div>
+        <div id="navbar" class="navbar-collapse collapse">
+            <ul class="nav navbar-nav navbar-right">
+                <li  class="active" ><a href="index.html">Home</a></li>
+                <li><a href="https://github.com/clojure-doc/clojure-doc.github.io">Contribute</a></li>
+            </ul>
+        </div><!--/.nav-collapse -->
+    </div><!--/.container-fluid -->
+</nav>
+
+
+<div class="container">
+
+
+    <div class="row">
+        <div class="col-lg-9">
+            <div id="content">
+                
+<div id="post">
+  <div>
+
+    <div class="jumbotron">
+      <div class="container">
+        <h1>Clojure Documentation</h1>
+        <p>Welcome to the community-driven documentation site for the Clojure programming language.</p>
+
+        <a class='btn btn-primary btn-lg' href='articles/tutorials/getting_started/index.html'>Get Started! »</a>
+        <a class="btn btn-lg" href="articles/content/index.html">See all content »</a>
+        <a class='btn btn-lg' href='https://github.com/clojure-doc/clojure-doc.github.io'>Contribute »</a>
+
+      </div>
+    </div>
+
+    <div class='row'>
+      <div class='col-md-4'>
+        <h2><a href='articles/content/index.html#essentials'>Essentials</a></h2>
+        <p>Tutorials aimed at new users.</p>
+      </div>
+
+      <div class='col-md-4'>
+        <h2><a href='articles/content/index.html#language-guides'>Language Guides</a></h2>
+        <p>Comprehensive guides on every aspect of the core language.</p>
+      </div>
+
+      <div class='col-md-4'>
+        <h2>Contributor-friendly</h2>
+        <p>
+          This material is not covered by the Clojure Contributor Agreement and is developed using <a href="https://github.com/clojure-doc/clojure-doc.github.io#how-to-contribute">pull-requests on GitHub</a>.
+        </p>
+      </div>
+    </div>
+
+    <div class='row'>
+      <div class='col-md-4'>
+        <h2><a href='articles/content/index.html#the-clojure-ecosystem'>Ecosystem & Tools</a></h2>
+        <p>Guides covering areas outside of the core language.</p>
+      </div>
+
+      <div class='col-md-4'>
+        <h2><a href='articles/content/index.html#tutorials-and-cookbooks'>Tutorials and Cookbooks</a></h2>
+        <p>Subject-specific tutorials and guides.</p>
+      </div>
+
+      <div class='col-md-4'>
+        <h2>Interactive Examples</h2>
+        <p><a href="https://github.com/viebel/klipse">Klipse</a> is used in several sections to provide
+          live, interactive code examples that you can edit to explore the concepts being
+          discussed.
+        </p>
+      </div>
+    </div>
+  </div>
+
+</div>
+
+            </div>
+        </div>
+
+        <div class="col-md-3">
+            <div id="sidebar">
+                <h3>Links</h3>
+                <ul id="links">
+                    
+                    <li><a href="articles/about/index.html">About</a></li>
+                    
+                    <li><a href="articles/content/index.html">Table of Contents</a></li>
+                    
+                    <li><a href="articles/tutorials/getting_started/index.html">Getting Started with Clojure</a></li>
+                    
+                    <li><a href="articles/tutorials/introduction/index.html">Introduction to Clojure</a></li>
+                    
+                    <li><a href="articles/tutorials/emacs/index.html">Clojure with Emacs</a></li>
+                    
+                    <li><a href="articles/tutorials/vim_fireplace/index.html">Clojure with Vim and fireplace.vim</a></li>
+                    
+                    <li><a href="articles/tutorials/eclipse/index.html">Starting with Eclipse and Counterclockwise For Clojure Development</a></li>
+                    
+                    <li><a href="articles/tutorials/basic_web_development/index.html">Basic Web Development</a></li>
+                    
+                    <li><a href="articles/tutorials/parsing_xml_with_zippers/index.html">Parsing XML in Clojure</a></li>
+                    
+                    <li><a href="articles/tutorials/growing_a_dsl_with_clojure/index.html">Growing a DSL with Clojure</a></li>
+                    
+                    <li><a href="articles/language/core_overview/index.html">Overview of clojure.core, the standard Clojure library</a></li>
+                    
+                    <li><a href="articles/language/namespaces/index.html">Clojure Namespaces and Vars</a></li>
+                    
+                    <li><a href="articles/language/collections_and_sequences/index.html">Collections and Sequences in Clojure</a></li>
+                    
+                    <li><a href="articles/language/functions/index.html">Functions in Clojure</a></li>
+                    
+                    <li><a href="articles/language/laziness/index.html">Laziness in Clojure</a></li>
+                    
+                    <li><a href="articles/language/interop/index.html">Clojure interoperability with Java</a></li>
+                    
+                    <li><a href="articles/language/macros/index.html">Clojure Macros and Metaprogramming</a></li>
+                    
+                    <li><a href="articles/language/polymorphism/index.html">Polymorphism in Clojure: Protocols and Multimethods</a></li>
+                    
+                    <li><a href="articles/language/concurrency_and_parallelism/index.html">Concurrency and Parallelism in Clojure</a></li>
+                    
+                    <li><a href="articles/language/glossary/index.html">Clojure Terminology Guide</a></li>
+                    
+                    <li><a href="articles/ecosystem/libraries_directory/index.html">A Directory of Clojure Libraries</a></li>
+                    
+                    <li><a href="articles/ecosystem/libraries_authoring/index.html">Library Development and Distribution</a></li>
+                    
+                    <li><a href="articles/ecosystem/generating_documentation/index.html">Generating Documentation</a></li>
+                    
+                    <li><a href="articles/ecosystem/data_processing/index.html">Data Processing (Help Wanted)</a></li>
+                    
+                    <li><a href="articles/ecosystem/web_development/index.html">Web Development (Overview)</a></li>
+                    
+                    <li><a href="articles/ecosystem/maven/index.html">How to use Maven to build Clojure projects</a></li>
+                    
+                    <li><a href="articles/ecosystem/community/index.html">Clojure Community</a></li>
+                    
+                    <li><a href="articles/ecosystem/user_groups/index.html">Clojure User Groups</a></li>
+                    
+                    <li><a href="articles/ecosystem/running_cljug/index.html">Running a Clojure User Group</a></li>
+                    
+                    <li><a href="articles/ecosystem/books/index.html">Books about Clojure and ClojureScript</a></li>
+                    
+                    <li><a href="articles/cookbooks/data_structures/index.html">Data Structures (Help wanted)</a></li>
+                    
+                    <li><a href="articles/cookbooks/strings/index.html">Strings</a></li>
+                    
+                    <li><a href="articles/cookbooks/math/index.html">Mathematics with Clojure</a></li>
+                    
+                    <li><a href="articles/cookbooks/date_and_time/index.html">Date and Time (Help wanted)</a></li>
+                    
+                    <li><a href="articles/cookbooks/files_and_directories/index.html">Working with Files and Directories in Clojure</a></li>
+                    
+                    <li><a href="articles/cookbooks/middleware/index.html">Middleware in Clojure</a></li>
+                    
+                    <li><a href="articles/ecosystem/java_jdbc/home.html">java.jdbc - Getting Started</a></li>
+                    
+                    <li><a href="articles/ecosystem/java_jdbc/using_sql.html">java.jdbc - Manipulating data with SQL</a></li>
+                    
+                    <li><a href="articles/ecosystem/java_jdbc/using_ddl.html">java.jdbc - Using DDL and Metadata</a></li>
+                    
+                    <li><a href="articles/ecosystem/java_jdbc/reusing_connections.html">java.jdbc - How to reuse database connections</a></li>
+                    
+                    <li><a href="articles/ecosystem/core_typed/home/index.html">core.typed - User Documentation Home</a></li>
+                    
+                    <li><a href="articles/ecosystem/core_typed/user_documentation/index.html">core.typed - User Documentation</a></li>
+                    
+                    <li><a href="articles/ecosystem/core_typed/rationale/index.html">core.typed - Rationale</a></li>
+                    
+                    <li><a href="articles/ecosystem/core_typed/quick_guide.html">core.typed - Quick Guide</a></li>
+                    
+                    <li><a href="articles/ecosystem/core_typed/start/introduction_and_motivation/index.html">core.typed - Getting Started: Introduction and Motivation</a></li>
+                    
+                    <li><a href="articles/ecosystem/core_typed/types/index.html">core.typed - Types</a></li>
+                    
+                    <li><a href="articles/ecosystem/core_typed/start/annotations/index.html">core.typed - Annotations</a></li>
+                    
+                    <li><a href="articles/ecosystem/core_typed/poly_fn/index.html">core.typed - Polymorphic Functions</a></li>
+                    
+                    <li><a href="articles/ecosystem/core_typed/filters/index.html">core.typed - Filters</a></li>
+                    
+                    <li><a href="articles/ecosystem/core_typed/mm_protocol_datatypes/index.html">core.typed - Protocols</a></li>
+                    
+                    <li><a href="articles/ecosystem/core_typed/loops/index.html">core.typed - Looping constructs</a></li>
+                    
+                    <li><a href="articles/ecosystem/core_typed/function_types/index.html">core.typed - Functions</a></li>
+                    
+                    <li><a href="articles/ecosystem/core_typed/limitations/index.html">core.typed - Limitations</a></li>
+                    
+                </ul>
+                
+                
+            </div>
+        </div>
+    </div>
+    <footer>Copyright &copy; 2021 Multiple Authors
+        <p style="text-align: center;">Powered by <a href="http://cryogenweb.org">Cryogen</a></p></footer>
+</div>
+<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
+<script src="js/highlight.pack.js" type="application/javascript"></script>
+<script>hljs.initHighlightingOnLoad();</script>
+
+
+</body>
+</html>
diff --git a/clones/clojure-doc.org/js/highlight.pack.js b/clones/clojure-doc.org/js/highlight.pack.js
new file mode 100644
index 00000000..acf70cc7
--- /dev/null
+++ b/clones/clojure-doc.org/js/highlight.pack.js
@@ -0,0 +1,2 @@
+/*! highlight.js v9.7.0 | BSD3 License | git.io/hljslicense */
+!function(e){var n="object"==typeof window&&window||"object"==typeof self&&self;"undefined"!=typeof exports?e(exports):n&&(n.hljs=e({}),"function"==typeof define&&define.amd&&define([],function(){return n.hljs}))}(function(e){function n(e){return e.replace(/[&<>]/gm,function(e){return I[e]})}function t(e){return e.nodeName.toLowerCase()}function r(e,n){var t=e&&e.exec(n);return t&&0===t.index}function a(e){return k.test(e)}function i(e){var n,t,r,i,o=e.className+" ";if(o+=e.parentNode?e.parentNode.className:"",t=B.exec(o))return R(t[1])?t[1]:"no-highlight";for(o=o.split(/\s+/),n=0,r=o.length;r>n;n++)if(i=o[n],a(i)||R(i))return i}function o(e,n){var t,r={};for(t in e)r[t]=e[t];if(n)for(t in n)r[t]=n[t];return r}function u(e){var n=[];return function r(e,a){for(var i=e.firstChild;i;i=i.nextSibling)3===i.nodeType?a+=i.nodeValue.length:1===i.nodeType&&(n.push({event:"start",offset:a,node:i}),a=r(i,a),t(i).match(/br|hr|img|input/)||n.push({event:"stop",offset:a,node:i}));return a}(e,0),n}function c(e,r,a){function i(){return e.length&&r.length?e[0].offset!==r[0].offset?e[0].offset<r[0].offset?e:r:"start"===r[0].event?e:r:e.length?e:r}function o(e){function r(e){return" "+e.nodeName+'="'+n(e.value)+'"'}l+="<"+t(e)+w.map.call(e.attributes,r).join("")+">"}function u(e){l+="</"+t(e)+">"}function c(e){("start"===e.event?o:u)(e.node)}for(var s=0,l="",f=[];e.length||r.length;){var g=i();if(l+=n(a.substr(s,g[0].offset-s)),s=g[0].offset,g===e){f.reverse().forEach(u);do c(g.splice(0,1)[0]),g=i();while(g===e&&g.length&&g[0].offset===s);f.reverse().forEach(o)}else"start"===g[0].event?f.push(g[0].node):f.pop(),c(g.splice(0,1)[0])}return l+n(a.substr(s))}function s(e){function n(e){return e&&e.source||e}function t(t,r){return new RegExp(n(t),"m"+(e.cI?"i":"")+(r?"g":""))}function r(a,i){if(!a.compiled){if(a.compiled=!0,a.k=a.k||a.bK,a.k){var u={},c=function(n,t){e.cI&&(t=t.toLowerCase()),t.split(" ").forEach(function(e){var t=e.split("|");u[t[0]]=[n,t[1]?Number(t[1]):1]})};"string"==typeof a.k?c("keyword",a.k):E(a.k).forEach(function(e){c(e,a.k[e])}),a.k=u}a.lR=t(a.l||/\w+/,!0),i&&(a.bK&&(a.b="\\b("+a.bK.split(" ").join("|")+")\\b"),a.b||(a.b=/\B|\b/),a.bR=t(a.b),a.e||a.eW||(a.e=/\B|\b/),a.e&&(a.eR=t(a.e)),a.tE=n(a.e)||"",a.eW&&i.tE&&(a.tE+=(a.e?"|":"")+i.tE)),a.i&&(a.iR=t(a.i)),null==a.r&&(a.r=1),a.c||(a.c=[]);var s=[];a.c.forEach(function(e){e.v?e.v.forEach(function(n){s.push(o(e,n))}):s.push("self"===e?a:e)}),a.c=s,a.c.forEach(function(e){r(e,a)}),a.starts&&r(a.starts,i);var l=a.c.map(function(e){return e.bK?"\\.?("+e.b+")\\.?":e.b}).concat([a.tE,a.i]).map(n).filter(Boolean);a.t=l.length?t(l.join("|"),!0):{exec:function(){return null}}}}r(e)}function l(e,t,a,i){function o(e,n){var t,a;for(t=0,a=n.c.length;a>t;t++)if(r(n.c[t].bR,e))return n.c[t]}function u(e,n){if(r(e.eR,n)){for(;e.endsParent&&e.parent;)e=e.parent;return e}return e.eW?u(e.parent,n):void 0}function c(e,n){return!a&&r(n.iR,e)}function g(e,n){var t=N.cI?n[0].toLowerCase():n[0];return e.k.hasOwnProperty(t)&&e.k[t]}function h(e,n,t,r){var a=r?"":y.classPrefix,i='<span class="'+a,o=t?"":C;return i+=e+'">',i+n+o}function p(){var e,t,r,a;if(!E.k)return n(B);for(a="",t=0,E.lR.lastIndex=0,r=E.lR.exec(B);r;)a+=n(B.substr(t,r.index-t)),e=g(E,r),e?(M+=e[1],a+=h(e[0],n(r[0]))):a+=n(r[0]),t=E.lR.lastIndex,r=E.lR.exec(B);return a+n(B.substr(t))}function d(){var e="string"==typeof E.sL;if(e&&!x[E.sL])return n(B);var t=e?l(E.sL,B,!0,L[E.sL]):f(B,E.sL.length?E.sL:void 0);return E.r>0&&(M+=t.r),e&&(L[E.sL]=t.top),h(t.language,t.value,!1,!0)}function b(){k+=null!=E.sL?d():p(),B=""}function v(e){k+=e.cN?h(e.cN,"",!0):"",E=Object.create(e,{parent:{value:E}})}function m(e,n){if(B+=e,null==n)return b(),0;var t=o(n,E);if(t)return t.skip?B+=n:(t.eB&&(B+=n),b(),t.rB||t.eB||(B=n)),v(t,n),t.rB?0:n.length;var r=u(E,n);if(r){var a=E;a.skip?B+=n:(a.rE||a.eE||(B+=n),b(),a.eE&&(B=n));do E.cN&&(k+=C),E.skip||(M+=E.r),E=E.parent;while(E!==r.parent);return r.starts&&v(r.starts,""),a.rE?0:n.length}if(c(n,E))throw new Error('Illegal lexeme "'+n+'" for mode "'+(E.cN||"<unnamed>")+'"');return B+=n,n.length||1}var N=R(e);if(!N)throw new Error('Unknown language: "'+e+'"');s(N);var w,E=i||N,L={},k="";for(w=E;w!==N;w=w.parent)w.cN&&(k=h(w.cN,"",!0)+k);var B="",M=0;try{for(var I,j,O=0;;){if(E.t.lastIndex=O,I=E.t.exec(t),!I)break;j=m(t.substr(O,I.index-O),I[0]),O=I.index+j}for(m(t.substr(O)),w=E;w.parent;w=w.parent)w.cN&&(k+=C);return{r:M,value:k,language:e,top:E}}catch(T){if(T.message&&-1!==T.message.indexOf("Illegal"))return{r:0,value:n(t)};throw T}}function f(e,t){t=t||y.languages||E(x);var r={r:0,value:n(e)},a=r;return t.filter(R).forEach(function(n){var t=l(n,e,!1);t.language=n,t.r>a.r&&(a=t),t.r>r.r&&(a=r,r=t)}),a.language&&(r.second_best=a),r}function g(e){return y.tabReplace||y.useBR?e.replace(M,function(e,n){return y.useBR&&"\n"===e?"<br>":y.tabReplace?n.replace(/\t/g,y.tabReplace):void 0}):e}function h(e,n,t){var r=n?L[n]:t,a=[e.trim()];return e.match(/\bhljs\b/)||a.push("hljs"),-1===e.indexOf(r)&&a.push(r),a.join(" ").trim()}function p(e){var n,t,r,o,s,p=i(e);a(p)||(y.useBR?(n=document.createElementNS("http://www.w3.org/1999/xhtml","div"),n.innerHTML=e.innerHTML.replace(/\n/g,"").replace(/<br[ \/]*>/g,"\n")):n=e,s=n.textContent,r=p?l(p,s,!0):f(s),t=u(n),t.length&&(o=document.createElementNS("http://www.w3.org/1999/xhtml","div"),o.innerHTML=r.value,r.value=c(t,u(o),s)),r.value=g(r.value),e.innerHTML=r.value,e.className=h(e.className,p,r.language),e.result={language:r.language,re:r.r},r.second_best&&(e.second_best={language:r.second_best.language,re:r.second_best.r}))}function d(e){y=o(y,e)}function b(){if(!b.called){b.called=!0;var e=document.querySelectorAll("pre code");w.forEach.call(e,p)}}function v(){addEventListener("DOMContentLoaded",b,!1),addEventListener("load",b,!1)}function m(n,t){var r=x[n]=t(e);r.aliases&&r.aliases.forEach(function(e){L[e]=n})}function N(){return E(x)}function R(e){return e=(e||"").toLowerCase(),x[e]||x[L[e]]}var w=[],E=Object.keys,x={},L={},k=/^(no-?highlight|plain|text)$/i,B=/\blang(?:uage)?-([\w-]+)\b/i,M=/((^(<[^>]+>|\t|)+|(?:\n)))/gm,C="</span>",y={classPrefix:"hljs-",tabReplace:null,useBR:!1,languages:void 0},I={"&":"&amp;","<":"&lt;",">":"&gt;"};return e.highlight=l,e.highlightAuto=f,e.fixMarkup=g,e.highlightBlock=p,e.configure=d,e.initHighlighting=b,e.initHighlightingOnLoad=v,e.registerLanguage=m,e.listLanguages=N,e.getLanguage=R,e.inherit=o,e.IR="[a-zA-Z]\\w*",e.UIR="[a-zA-Z_]\\w*",e.NR="\\b\\d+(\\.\\d+)?",e.CNR="(-?)(\\b0[xX][a-fA-F0-9]+|(\\b\\d+(\\.\\d*)?|\\.\\d+)([eE][-+]?\\d+)?)",e.BNR="\\b(0b[01]+)",e.RSR="!|!=|!==|%|%=|&|&&|&=|\\*|\\*=|\\+|\\+=|,|-|-=|/=|/|:|;|<<|<<=|<=|<|===|==|=|>>>=|>>=|>=|>>>|>>|>|\\?|\\[|\\{|\\(|\\^|\\^=|\\||\\|=|\\|\\||~",e.BE={b:"\\\\[\\s\\S]",r:0},e.ASM={cN:"string",b:"'",e:"'",i:"\\n",c:[e.BE]},e.QSM={cN:"string",b:'"',e:'"',i:"\\n",c:[e.BE]},e.PWM={b:/\b(a|an|the|are|I'm|isn't|don't|doesn't|won't|but|just|should|pretty|simply|enough|gonna|going|wtf|so|such|will|you|your|like)\b/},e.C=function(n,t,r){var a=e.inherit({cN:"comment",b:n,e:t,c:[]},r||{});return a.c.push(e.PWM),a.c.push({cN:"doctag",b:"(?:TODO|FIXME|NOTE|BUG|XXX):",r:0}),a},e.CLCM=e.C("//","$"),e.CBCM=e.C("/\\*","\\*/"),e.HCM=e.C("#","$"),e.NM={cN:"number",b:e.NR,r:0},e.CNM={cN:"number",b:e.CNR,r:0},e.BNM={cN:"number",b:e.BNR,r:0},e.CSSNM={cN:"number",b:e.NR+"(%|em|ex|ch|rem|vw|vh|vmin|vmax|cm|mm|in|pt|pc|px|deg|grad|rad|turn|s|ms|Hz|kHz|dpi|dpcm|dppx)?",r:0},e.RM={cN:"regexp",b:/\//,e:/\/[gimuy]*/,i:/\n/,c:[e.BE,{b:/\[/,e:/\]/,r:0,c:[e.BE]}]},e.TM={cN:"title",b:e.IR,r:0},e.UTM={cN:"title",b:e.UIR,r:0},e.METHOD_GUARD={b:"\\.\\s*"+e.UIR,r:0},e});hljs.registerLanguage("coffeescript",function(e){var c={keyword:"in if for while finally new do return else break catch instanceof throw try this switch continue typeof delete debugger super then unless until loop of by when and or is isnt not",literal:"true false null undefined yes no on off",built_in:"npm require console print module global window document"},n="[A-Za-z$_][0-9A-Za-z$_]*",r={cN:"subst",b:/#\{/,e:/}/,k:c},s=[e.BNM,e.inherit(e.CNM,{starts:{e:"(\\s*/)?",r:0}}),{cN:"string",v:[{b:/'''/,e:/'''/,c:[e.BE]},{b:/'/,e:/'/,c:[e.BE]},{b:/"""/,e:/"""/,c:[e.BE,r]},{b:/"/,e:/"/,c:[e.BE,r]}]},{cN:"regexp",v:[{b:"///",e:"///",c:[r,e.HCM]},{b:"//[gim]*",r:0},{b:/\/(?![ *])(\\\/|.)*?\/[gim]*(?=\W|$)/}]},{b:"@"+n},{b:"`",e:"`",eB:!0,eE:!0,sL:"javascript"}];r.c=s;var i=e.inherit(e.TM,{b:n}),t="(\\(.*\\))?\\s*\\B[-=]>",o={cN:"params",b:"\\([^\\(]",rB:!0,c:[{b:/\(/,e:/\)/,k:c,c:["self"].concat(s)}]};return{aliases:["coffee","cson","iced"],k:c,i:/\/\*/,c:s.concat([e.C("###","###"),e.HCM,{cN:"function",b:"^\\s*"+n+"\\s*=\\s*"+t,e:"[-=]>",rB:!0,c:[i,o]},{b:/[:\(,=]\s*/,r:0,c:[{cN:"function",b:t,e:"[-=]>",rB:!0,c:[o]}]},{cN:"class",bK:"class",e:"$",i:/[:="\[\]]/,c:[{bK:"extends",eW:!0,i:/[:="\[\]]/,c:[i]},i]},{b:n+":",e:":",rB:!0,rE:!0,r:0}])}});hljs.registerLanguage("ini",function(e){var b={cN:"string",c:[e.BE],v:[{b:"'''",e:"'''",r:10},{b:'"""',e:'"""',r:10},{b:'"',e:'"'},{b:"'",e:"'"}]};return{aliases:["toml"],cI:!0,i:/\S/,c:[e.C(";","$"),e.HCM,{cN:"section",b:/^\s*\[+/,e:/\]+/},{b:/^[a-z0-9\[\]_-]+\s*=\s*/,e:"$",rB:!0,c:[{cN:"attr",b:/[a-z0-9\[\]_-]+/},{b:/=/,eW:!0,r:0,c:[{cN:"literal",b:/\bon|off|true|false|yes|no\b/},{cN:"variable",v:[{b:/\$[\w\d"][\w\d_]*/},{b:/\$\{(.*?)}/}]},b,{cN:"number",b:/([\+\-]+)?[\d]+_[\d_]+/},e.NM]}]}]}});hljs.registerLanguage("xml",function(s){var e="[A-Za-z0-9\\._:-]+",t={eW:!0,i:/</,r:0,c:[{cN:"attr",b:e,r:0},{b:/=\s*/,r:0,c:[{cN:"string",endsParent:!0,v:[{b:/"/,e:/"/},{b:/'/,e:/'/},{b:/[^\s"'=<>`]+/}]}]}]};return{aliases:["html","xhtml","rss","atom","xjb","xsd","xsl","plist"],cI:!0,c:[{cN:"meta",b:"<!DOCTYPE",e:">",r:10,c:[{b:"\\[",e:"\\]"}]},s.C("<!--","-->",{r:10}),{b:"<\\!\\[CDATA\\[",e:"\\]\\]>",r:10},{b:/<\?(php)?/,e:/\?>/,sL:"php",c:[{b:"/\\*",e:"\\*/",skip:!0}]},{cN:"tag",b:"<style(?=\\s|>|$)",e:">",k:{name:"style"},c:[t],starts:{e:"</style>",rE:!0,sL:["css","xml"]}},{cN:"tag",b:"<script(?=\\s|>|$)",e:">",k:{name:"script"},c:[t],starts:{e:"</script>",rE:!0,sL:["actionscript","javascript","handlebars","xml"]}},{cN:"meta",v:[{b:/<\?xml/,e:/\?>/,r:10},{b:/<\?\w+/,e:/\?>/}]},{cN:"tag",b:"</?",e:"/?>",c:[{cN:"name",b:/[^\/><\s]+/,r:0},t]}]}});hljs.registerLanguage("markdown",function(e){return{aliases:["md","mkdown","mkd"],c:[{cN:"section",v:[{b:"^#{1,6}",e:"$"},{b:"^.+?\\n[=-]{2,}$"}]},{b:"<",e:">",sL:"xml",r:0},{cN:"bullet",b:"^([*+-]|(\\d+\\.))\\s+"},{cN:"strong",b:"[*_]{2}.+?[*_]{2}"},{cN:"emphasis",v:[{b:"\\*.+?\\*"},{b:"_.+?_",r:0}]},{cN:"quote",b:"^>\\s+",e:"$"},{cN:"code",v:[{b:"^```w*s*$",e:"^```s*$"},{b:"`.+?`"},{b:"^( {4}|	)",e:"$",r:0}]},{b:"^[-\\*]{3,}",e:"$"},{b:"\\[.+?\\][\\(\\[].*?[\\)\\]]",rB:!0,c:[{cN:"string",b:"\\[",e:"\\]",eB:!0,rE:!0,r:0},{cN:"link",b:"\\]\\(",e:"\\)",eB:!0,eE:!0},{cN:"symbol",b:"\\]\\[",e:"\\]",eB:!0,eE:!0}],r:10},{b:/^\[[^\n]+\]:/,rB:!0,c:[{cN:"symbol",b:/\[/,e:/\]/,eB:!0,eE:!0},{cN:"link",b:/:\s*/,e:/$/,eB:!0}]}]}});hljs.registerLanguage("cs",function(e){var i={keyword:"abstract as base bool break byte case catch char checked const continue decimal default delegate do double else enum event explicit extern finally fixed float for foreach goto if implicit in int interface internal is lock long object operator out override params private protected public readonly ref sbyte sealed short sizeof stackalloc static string struct switch this try typeof uint ulong unchecked unsafe ushort using virtual void volatile while nameof add alias ascending async await by descending dynamic equals from get global group into join let on orderby partial remove select set value var where yield",literal:"null false true"},r={cN:"string",b:'@"',e:'"',c:[{b:'""'}]},t=e.inherit(r,{i:/\n/}),a={cN:"subst",b:"{",e:"}",k:i},n=e.inherit(a,{i:/\n/}),c={cN:"string",b:/\$"/,e:'"',i:/\n/,c:[{b:"{{"},{b:"}}"},e.BE,n]},s={cN:"string",b:/\$@"/,e:'"',c:[{b:"{{"},{b:"}}"},{b:'""'},a]},o=e.inherit(s,{i:/\n/,c:[{b:"{{"},{b:"}}"},{b:'""'},n]});a.c=[s,c,r,e.ASM,e.QSM,e.CNM,e.CBCM],n.c=[o,c,t,e.ASM,e.QSM,e.CNM,e.inherit(e.CBCM,{i:/\n/})];var l={v:[s,c,r,e.ASM,e.QSM]},b=e.IR+"(<"+e.IR+"(\\s*,\\s*"+e.IR+")*>)?(\\[\\])?";return{aliases:["csharp"],k:i,i:/::/,c:[e.C("///","$",{rB:!0,c:[{cN:"doctag",v:[{b:"///",r:0},{b:"<!--|-->"},{b:"</?",e:">"}]}]}),e.CLCM,e.CBCM,{cN:"meta",b:"#",e:"$",k:{"meta-keyword":"if else elif endif define undef warning error line region endregion pragma checksum"}},l,e.CNM,{bK:"class interface",e:/[{;=]/,i:/[^\s:]/,c:[e.TM,e.CLCM,e.CBCM]},{bK:"namespace",e:/[{;=]/,i:/[^\s:]/,c:[e.inherit(e.TM,{b:"[a-zA-Z](\\.?\\w)*"}),e.CLCM,e.CBCM]},{bK:"new return throw await",r:0},{cN:"function",b:"("+b+"\\s+)+"+e.IR+"\\s*\\(",rB:!0,e:/[{;=]/,eE:!0,k:i,c:[{b:e.IR+"\\s*\\(",rB:!0,c:[e.TM],r:0},{cN:"params",b:/\(/,e:/\)/,eB:!0,eE:!0,k:i,r:0,c:[l,e.CNM,e.CBCM]},e.CLCM,e.CBCM]}]}});hljs.registerLanguage("ruby",function(e){var b="[a-zA-Z_]\\w*[!?=]?|[-+~]\\@|<<|>>|=~|===?|<=>|[<>]=?|\\*\\*|[-/+%^&*~`|]|\\[\\]=?",r={keyword:"and then defined module in return redo if BEGIN retry end for self when next until do begin unless END rescue else break undef not super class case require yield alias while ensure elsif or include attr_reader attr_writer attr_accessor",literal:"true false nil"},c={cN:"doctag",b:"@[A-Za-z]+"},a={b:"#<",e:">"},s=[e.C("#","$",{c:[c]}),e.C("^\\=begin","^\\=end",{c:[c],r:10}),e.C("^__END__","\\n$")],n={cN:"subst",b:"#\\{",e:"}",k:r},t={cN:"string",c:[e.BE,n],v:[{b:/'/,e:/'/},{b:/"/,e:/"/},{b:/`/,e:/`/},{b:"%[qQwWx]?\\(",e:"\\)"},{b:"%[qQwWx]?\\[",e:"\\]"},{b:"%[qQwWx]?{",e:"}"},{b:"%[qQwWx]?<",e:">"},{b:"%[qQwWx]?/",e:"/"},{b:"%[qQwWx]?%",e:"%"},{b:"%[qQwWx]?-",e:"-"},{b:"%[qQwWx]?\\|",e:"\\|"},{b:/\B\?(\\\d{1,3}|\\x[A-Fa-f0-9]{1,2}|\\u[A-Fa-f0-9]{4}|\\?\S)\b/},{b:/<<(-?)\w+$/,e:/^\s*\w+$/}]},i={cN:"params",b:"\\(",e:"\\)",endsParent:!0,k:r},d=[t,a,{cN:"class",bK:"class module",e:"$|;",i:/=/,c:[e.inherit(e.TM,{b:"[A-Za-z_]\\w*(::\\w+)*(\\?|\\!)?"}),{b:"<\\s*",c:[{b:"("+e.IR+"::)?"+e.IR}]}].concat(s)},{cN:"function",bK:"def",e:"$|;",c:[e.inherit(e.TM,{b:b}),i].concat(s)},{b:e.IR+"::"},{cN:"symbol",b:e.UIR+"(\\!|\\?)?:",r:0},{cN:"symbol",b:":(?!\\s)",c:[t,{b:b}],r:0},{cN:"number",b:"(\\b0[0-7_]+)|(\\b0x[0-9a-fA-F_]+)|(\\b[1-9][0-9_]*(\\.[0-9_]+)?)|[0_]\\b",r:0},{b:"(\\$\\W)|((\\$|\\@\\@?)(\\w+))"},{cN:"params",b:/\|/,e:/\|/,k:r},{b:"("+e.RSR+")\\s*",c:[a,{cN:"regexp",c:[e.BE,n],i:/\n/,v:[{b:"/",e:"/[a-z]*"},{b:"%r{",e:"}[a-z]*"},{b:"%r\\(",e:"\\)[a-z]*"},{b:"%r!",e:"![a-z]*"},{b:"%r\\[",e:"\\][a-z]*"}]}].concat(s),r:0}].concat(s);n.c=d,i.c=d;var l="[>?]>",o="[\\w#]+\\(\\w+\\):\\d+:\\d+>",w="(\\w+-)?\\d+\\.\\d+\\.\\d(p\\d+)?[^>]+>",u=[{b:/^\s*=>/,starts:{e:"$",c:d}},{cN:"meta",b:"^("+l+"|"+o+"|"+w+")",starts:{e:"$",c:d}}];return{aliases:["rb","gemspec","podspec","thor","irb"],k:r,i:/\/\*/,c:s.concat(u).concat(d)}});hljs.registerLanguage("apache",function(e){var r={cN:"number",b:"[\\$%]\\d+"};return{aliases:["apacheconf"],cI:!0,c:[e.HCM,{cN:"section",b:"</?",e:">"},{cN:"attribute",b:/\w+/,r:0,k:{nomarkup:"order deny allow setenv rewriterule rewriteengine rewritecond documentroot sethandler errordocument loadmodule options header listen serverroot servername"},starts:{e:/$/,r:0,k:{literal:"on off all"},c:[{cN:"meta",b:"\\s\\[",e:"\\]$"},{cN:"variable",b:"[\\$%]\\{",e:"\\}",c:["self",r]},r,e.QSM]}}],i:/\S/}});hljs.registerLanguage("http",function(e){var t="HTTP/[0-9\\.]+";return{aliases:["https"],i:"\\S",c:[{b:"^"+t,e:"$",c:[{cN:"number",b:"\\b\\d{3}\\b"}]},{b:"^[A-Z]+ (.*?) "+t+"$",rB:!0,e:"$",c:[{cN:"string",b:" ",e:" ",eB:!0,eE:!0},{b:t},{cN:"keyword",b:"[A-Z]+"}]},{cN:"attribute",b:"^\\w",e:": ",eE:!0,i:"\\n|\\s|=",starts:{e:"$",r:0}},{b:"\\n\\n",starts:{sL:[],eW:!0}}]}});hljs.registerLanguage("clojure",function(e){var t={"builtin-name":"def defonce cond apply if-not if-let if not not= = < > <= >= == + / * - rem quot neg? pos? delay? symbol? keyword? true? false? integer? empty? coll? list? set? ifn? fn? associative? sequential? sorted? counted? reversible? number? decimal? class? distinct? isa? float? rational? reduced? ratio? odd? even? char? seq? vector? string? map? nil? contains? zero? instance? not-every? not-any? libspec? -> ->> .. . inc compare do dotimes mapcat take remove take-while drop letfn drop-last take-last drop-while while intern condp case reduced cycle split-at split-with repeat replicate iterate range merge zipmap declare line-seq sort comparator sort-by dorun doall nthnext nthrest partition eval doseq await await-for let agent atom send send-off release-pending-sends add-watch mapv filterv remove-watch agent-error restart-agent set-error-handler error-handler set-error-mode! error-mode shutdown-agents quote var fn loop recur throw try monitor-enter monitor-exit defmacro defn defn- macroexpand macroexpand-1 for dosync and or when when-not when-let comp juxt partial sequence memoize constantly complement identity assert peek pop doto proxy defstruct first rest cons defprotocol cast coll deftype defrecord last butlast sigs reify second ffirst fnext nfirst nnext defmulti defmethod meta with-meta ns in-ns create-ns import refer keys select-keys vals key val rseq name namespace promise into transient persistent! conj! assoc! dissoc! pop! disj! use class type num float double short byte boolean bigint biginteger bigdec print-method print-dup throw-if printf format load compile get-in update-in pr pr-on newline flush read slurp read-line subvec with-open memfn time re-find re-groups rand-int rand mod locking assert-valid-fdecl alias resolve ref deref refset swap! reset! set-validator! compare-and-set! alter-meta! reset-meta! commute get-validator alter ref-set ref-history-count ref-min-history ref-max-history ensure sync io! new next conj set! to-array future future-call into-array aset gen-class reduce map filter find empty hash-map hash-set sorted-map sorted-map-by sorted-set sorted-set-by vec vector seq flatten reverse assoc dissoc list disj get union difference intersection extend extend-type extend-protocol int nth delay count concat chunk chunk-buffer chunk-append chunk-first chunk-rest max min dec unchecked-inc-int unchecked-inc unchecked-dec-inc unchecked-dec unchecked-negate unchecked-add-int unchecked-add unchecked-subtract-int unchecked-subtract chunk-next chunk-cons chunked-seq? prn vary-meta lazy-seq spread list* str find-keyword keyword symbol gensym force rationalize"},r="a-zA-Z_\\-!.?+*=<>&#'",n="["+r+"]["+r+"0-9/;:]*",a="[-+]?\\d+(\\.\\d+)?",o={b:n,r:0},s={cN:"number",b:a,r:0},i=e.inherit(e.QSM,{i:null}),c=e.C(";","$",{r:0}),d={cN:"literal",b:/\b(true|false|nil)\b/},l={b:"[\\[\\{]",e:"[\\]\\}]"},m={cN:"comment",b:"\\^"+n},p=e.C("\\^\\{","\\}"),u={cN:"symbol",b:"[:]{1,2}"+n},f={b:"\\(",e:"\\)"},h={eW:!0,r:0},y={k:t,l:n,cN:"name",b:n,starts:h},b=[f,i,m,p,c,u,l,s,d,o];return f.c=[e.C("comment",""),y,h],h.c=b,l.c=b,{aliases:["clj"],i:/\S/,c:[f,i,m,p,c,u,l,s,d]}});hljs.registerLanguage("sql",function(e){var t=e.C("--","$");return{cI:!0,i:/[<>{}*#]/,c:[{bK:"begin end start commit rollback savepoint lock alter create drop rename call delete do handler insert load replace select truncate update set show pragma grant merge describe use explain help declare prepare execute deallocate release unlock purge reset change stop analyze cache flush optimize repair kill install uninstall checksum restore check backup revoke comment",e:/;/,eW:!0,l:/[\w\.]+/,k:{keyword:"abort abs absolute acc acce accep accept access accessed accessible account acos action activate add addtime admin administer advanced advise aes_decrypt aes_encrypt after agent aggregate ali alia alias allocate allow alter always analyze ancillary and any anydata anydataset anyschema anytype apply archive archived archivelog are as asc ascii asin assembly assertion associate asynchronous at atan atn2 attr attri attrib attribu attribut attribute attributes audit authenticated authentication authid authors auto autoallocate autodblink autoextend automatic availability avg backup badfile basicfile before begin beginning benchmark between bfile bfile_base big bigfile bin binary_double binary_float binlog bit_and bit_count bit_length bit_or bit_xor bitmap blob_base block blocksize body both bound buffer_cache buffer_pool build bulk by byte byteordermark bytes cache caching call calling cancel capacity cascade cascaded case cast catalog category ceil ceiling chain change changed char_base char_length character_length characters characterset charindex charset charsetform charsetid check checksum checksum_agg child choose chr chunk class cleanup clear client clob clob_base clone close cluster_id cluster_probability cluster_set clustering coalesce coercibility col collate collation collect colu colum column column_value columns columns_updated comment commit compact compatibility compiled complete composite_limit compound compress compute concat concat_ws concurrent confirm conn connec connect connect_by_iscycle connect_by_isleaf connect_by_root connect_time connection consider consistent constant constraint constraints constructor container content contents context contributors controlfile conv convert convert_tz corr corr_k corr_s corresponding corruption cos cost count count_big counted covar_pop covar_samp cpu_per_call cpu_per_session crc32 create creation critical cross cube cume_dist curdate current current_date current_time current_timestamp current_user cursor curtime customdatum cycle data database databases datafile datafiles datalength date_add date_cache date_format date_sub dateadd datediff datefromparts datename datepart datetime2fromparts day day_to_second dayname dayofmonth dayofweek dayofyear days db_role_change dbtimezone ddl deallocate declare decode decompose decrement decrypt deduplicate def defa defau defaul default defaults deferred defi defin define degrees delayed delegate delete delete_all delimited demand dense_rank depth dequeue des_decrypt des_encrypt des_key_file desc descr descri describ describe descriptor deterministic diagnostics difference dimension direct_load directory disable disable_all disallow disassociate discardfile disconnect diskgroup distinct distinctrow distribute distributed div do document domain dotnet double downgrade drop dumpfile duplicate duration each edition editionable editions element ellipsis else elsif elt empty enable enable_all enclosed encode encoding encrypt end end-exec endian enforced engine engines enqueue enterprise entityescaping eomonth error errors escaped evalname evaluate event eventdata events except exception exceptions exchange exclude excluding execu execut execute exempt exists exit exp expire explain export export_set extended extent external external_1 external_2 externally extract failed failed_login_attempts failover failure far fast feature_set feature_value fetch field fields file file_name_convert filesystem_like_logging final finish first first_value fixed flash_cache flashback floor flush following follows for forall force form forma format found found_rows freelist freelists freepools fresh from from_base64 from_days ftp full function general generated get get_format get_lock getdate getutcdate global global_name globally go goto grant grants greatest group group_concat group_id grouping grouping_id groups gtid_subtract guarantee guard handler hash hashkeys having hea head headi headin heading heap help hex hierarchy high high_priority hosts hour http id ident_current ident_incr ident_seed identified identity idle_time if ifnull ignore iif ilike ilm immediate import in include including increment index indexes indexing indextype indicator indices inet6_aton inet6_ntoa inet_aton inet_ntoa infile initial initialized initially initrans inmemory inner innodb input insert install instance instantiable instr interface interleaved intersect into invalidate invisible is is_free_lock is_ipv4 is_ipv4_compat is_not is_not_null is_used_lock isdate isnull isolation iterate java join json json_exists keep keep_duplicates key keys kill language large last last_day last_insert_id last_value lax lcase lead leading least leaves left len lenght length less level levels library like like2 like4 likec limit lines link list listagg little ln load load_file lob lobs local localtime localtimestamp locate locator lock locked log log10 log2 logfile logfiles logging logical logical_reads_per_call logoff logon logs long loop low low_priority lower lpad lrtrim ltrim main make_set makedate maketime managed management manual map mapping mask master master_pos_wait match matched materialized max maxextents maximize maxinstances maxlen maxlogfiles maxloghistory maxlogmembers maxsize maxtrans md5 measures median medium member memcompress memory merge microsecond mid migration min minextents minimum mining minus minute minvalue missing mod mode model modification modify module monitoring month months mount move movement multiset mutex name name_const names nan national native natural nav nchar nclob nested never new newline next nextval no no_write_to_binlog noarchivelog noaudit nobadfile nocheck nocompress nocopy nocycle nodelay nodiscardfile noentityescaping noguarantee nokeep nologfile nomapping nomaxvalue nominimize nominvalue nomonitoring none noneditionable nonschema noorder nopr nopro noprom nopromp noprompt norely noresetlogs noreverse normal norowdependencies noschemacheck noswitch not nothing notice notrim novalidate now nowait nth_value nullif nulls num numb numbe nvarchar nvarchar2 object ocicoll ocidate ocidatetime ociduration ociinterval ociloblocator ocinumber ociref ocirefcursor ocirowid ocistring ocitype oct octet_length of off offline offset oid oidindex old on online only opaque open operations operator optimal optimize option optionally or oracle oracle_date oradata ord ordaudio orddicom orddoc order ordimage ordinality ordvideo organization orlany orlvary out outer outfile outline output over overflow overriding package pad parallel parallel_enable parameters parent parse partial partition partitions pascal passing password password_grace_time password_lock_time password_reuse_max password_reuse_time password_verify_function patch path patindex pctincrease pctthreshold pctused pctversion percent percent_rank percentile_cont percentile_disc performance period period_add period_diff permanent physical pi pipe pipelined pivot pluggable plugin policy position post_transaction pow power pragma prebuilt precedes preceding precision prediction prediction_cost prediction_details prediction_probability prediction_set prepare present preserve prior priority private private_sga privileges procedural procedure procedure_analyze processlist profiles project prompt protection public publishingservername purge quarter query quick quiesce quota quotename radians raise rand range rank raw read reads readsize rebuild record records recover recovery recursive recycle redo reduced ref reference referenced references referencing refresh regexp_like register regr_avgx regr_avgy regr_count regr_intercept regr_r2 regr_slope regr_sxx regr_sxy reject rekey relational relative relaylog release release_lock relies_on relocate rely rem remainder rename repair repeat replace replicate replication required reset resetlogs resize resource respect restore restricted result result_cache resumable resume retention return returning returns reuse reverse revoke right rlike role roles rollback rolling rollup round row row_count rowdependencies rowid rownum rows rtrim rules safe salt sample save savepoint sb1 sb2 sb4 scan schema schemacheck scn scope scroll sdo_georaster sdo_topo_geometry search sec_to_time second section securefile security seed segment select self sequence sequential serializable server servererror session session_user sessions_per_user set sets settings sha sha1 sha2 share shared shared_pool short show shrink shutdown si_averagecolor si_colorhistogram si_featurelist si_positionalcolor si_stillimage si_texture siblings sid sign sin size size_t sizes skip slave sleep smalldatetimefromparts smallfile snapshot some soname sort soundex source space sparse spfile split sql sql_big_result sql_buffer_result sql_cache sql_calc_found_rows sql_small_result sql_variant_property sqlcode sqldata sqlerror sqlname sqlstate sqrt square standalone standby start starting startup statement static statistics stats_binomial_test stats_crosstab stats_ks_test stats_mode stats_mw_test stats_one_way_anova stats_t_test_ stats_t_test_indep stats_t_test_one stats_t_test_paired stats_wsr_test status std stddev stddev_pop stddev_samp stdev stop storage store stored str str_to_date straight_join strcmp strict string struct stuff style subdate subpartition subpartitions substitutable substr substring subtime subtring_index subtype success sum suspend switch switchoffset switchover sync synchronous synonym sys sys_xmlagg sysasm sysaux sysdate sysdatetimeoffset sysdba sysoper system system_user sysutcdatetime table tables tablespace tan tdo template temporary terminated tertiary_weights test than then thread through tier ties time time_format time_zone timediff timefromparts timeout timestamp timestampadd timestampdiff timezone_abbr timezone_minute timezone_region to to_base64 to_date to_days to_seconds todatetimeoffset trace tracking transaction transactional translate translation treat trigger trigger_nestlevel triggers trim truncate try_cast try_convert try_parse type ub1 ub2 ub4 ucase unarchived unbounded uncompress under undo unhex unicode uniform uninstall union unique unix_timestamp unknown unlimited unlock unpivot unrecoverable unsafe unsigned until untrusted unusable unused update updated upgrade upped upper upsert url urowid usable usage use use_stored_outlines user user_data user_resources users using utc_date utc_timestamp uuid uuid_short validate validate_password_strength validation valist value values var var_samp varcharc vari varia variab variabl variable variables variance varp varraw varrawc varray verify version versions view virtual visible void wait wallet warning warnings week weekday weekofyear wellformed when whene whenev wheneve whenever where while whitespace with within without work wrapped xdb xml xmlagg xmlattributes xmlcast xmlcolattval xmlelement xmlexists xmlforest xmlindex xmlnamespaces xmlpi xmlquery xmlroot xmlschema xmlserialize xmltable xmltype xor year year_to_month years yearweek",literal:"true false null",built_in:"array bigint binary bit blob boolean char character date dec decimal float int int8 integer interval number numeric real record serial serial8 smallint text varchar varying void"},c:[{cN:"string",b:"'",e:"'",c:[e.BE,{b:"''"}]},{cN:"string",b:'"',e:'"',c:[e.BE,{b:'""'}]},{cN:"string",b:"`",e:"`",c:[e.BE]},e.CNM,e.CBCM,t]},e.CBCM,t]}});hljs.registerLanguage("perl",function(e){var t="getpwent getservent quotemeta msgrcv scalar kill dbmclose undef lc ma syswrite tr send umask sysopen shmwrite vec qx utime local oct semctl localtime readpipe do return format read sprintf dbmopen pop getpgrp not getpwnam rewinddir qqfileno qw endprotoent wait sethostent bless s|0 opendir continue each sleep endgrent shutdown dump chomp connect getsockname die socketpair close flock exists index shmgetsub for endpwent redo lstat msgctl setpgrp abs exit select print ref gethostbyaddr unshift fcntl syscall goto getnetbyaddr join gmtime symlink semget splice x|0 getpeername recv log setsockopt cos last reverse gethostbyname getgrnam study formline endhostent times chop length gethostent getnetent pack getprotoent getservbyname rand mkdir pos chmod y|0 substr endnetent printf next open msgsnd readdir use unlink getsockopt getpriority rindex wantarray hex system getservbyport endservent int chr untie rmdir prototype tell listen fork shmread ucfirst setprotoent else sysseek link getgrgid shmctl waitpid unpack getnetbyname reset chdir grep split require caller lcfirst until warn while values shift telldir getpwuid my getprotobynumber delete and sort uc defined srand accept package seekdir getprotobyname semop our rename seek if q|0 chroot sysread setpwent no crypt getc chown sqrt write setnetent setpriority foreach tie sin msgget map stat getlogin unless elsif truncate exec keys glob tied closedirioctl socket readlink eval xor readline binmode setservent eof ord bind alarm pipe atan2 getgrent exp time push setgrent gt lt or ne m|0 break given say state when",r={cN:"subst",b:"[$@]\\{",e:"\\}",k:t},s={b:"->{",e:"}"},n={v:[{b:/\$\d/},{b:/[\$%@](\^\w\b|#\w+(::\w+)*|{\w+}|\w+(::\w*)*)/},{b:/[\$%@][^\s\w{]/,r:0}]},i=[e.BE,r,n],o=[n,e.HCM,e.C("^\\=\\w","\\=cut",{eW:!0}),s,{cN:"string",c:i,v:[{b:"q[qwxr]?\\s*\\(",e:"\\)",r:5},{b:"q[qwxr]?\\s*\\[",e:"\\]",r:5},{b:"q[qwxr]?\\s*\\{",e:"\\}",r:5},{b:"q[qwxr]?\\s*\\|",e:"\\|",r:5},{b:"q[qwxr]?\\s*\\<",e:"\\>",r:5},{b:"qw\\s+q",e:"q",r:5},{b:"'",e:"'",c:[e.BE]},{b:'"',e:'"'},{b:"`",e:"`",c:[e.BE]},{b:"{\\w+}",c:[],r:0},{b:"-?\\w+\\s*\\=\\>",c:[],r:0}]},{cN:"number",b:"(\\b0[0-7_]+)|(\\b0x[0-9a-fA-F_]+)|(\\b[1-9][0-9_]*(\\.[0-9_]+)?)|[0_]\\b",r:0},{b:"(\\/\\/|"+e.RSR+"|\\b(split|return|print|reverse|grep)\\b)\\s*",k:"split return print reverse grep",r:0,c:[e.HCM,{cN:"regexp",b:"(s|tr|y)/(\\\\.|[^/])*/(\\\\.|[^/])*/[a-z]*",r:10},{cN:"regexp",b:"(m|qr)?/",e:"/[a-z]*",c:[e.BE],r:0}]},{cN:"function",bK:"sub",e:"(\\s*\\(.*?\\))?[;{]",eE:!0,r:5,c:[e.TM]},{b:"-\\w\\b",r:0},{b:"^__DATA__$",e:"^__END__$",sL:"mojolicious",c:[{b:"^@@.*",e:"$",cN:"comment"}]}];return r.c=o,s.c=o,{aliases:["pl","pm"],l:/[\w\.]+/,k:t,c:o}});hljs.registerLanguage("php",function(e){var c={b:"\\$+[a-zA-Z_-ÿ][a-zA-Z0-9_-ÿ]*"},i={cN:"meta",b:/<\?(php)?|\?>/},t={cN:"string",c:[e.BE,i],v:[{b:'b"',e:'"'},{b:"b'",e:"'"},e.inherit(e.ASM,{i:null}),e.inherit(e.QSM,{i:null})]},a={v:[e.BNM,e.CNM]};return{aliases:["php3","php4","php5","php6"],cI:!0,k:"and include_once list abstract global private echo interface as static endswitch array null if endwhile or const for endforeach self var while isset public protected exit foreach throw elseif include __FILE__ empty require_once do xor return parent clone use __CLASS__ __LINE__ else break print eval new catch __METHOD__ case exception default die require __FUNCTION__ enddeclare final try switch continue endfor endif declare unset true false trait goto instanceof insteadof __DIR__ __NAMESPACE__ yield finally",c:[e.HCM,e.C("//","$",{c:[i]}),e.C("/\\*","\\*/",{c:[{cN:"doctag",b:"@[A-Za-z]+"}]}),e.C("__halt_compiler.+?;",!1,{eW:!0,k:"__halt_compiler",l:e.UIR}),{cN:"string",b:/<<<['"]?\w+['"]?$/,e:/^\w+;?$/,c:[e.BE,{cN:"subst",v:[{b:/\$\w+/},{b:/\{\$/,e:/\}/}]}]},i,{cN:"keyword",b:/\$this\b/},c,{b:/(::|->)+[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*/},{cN:"function",bK:"function",e:/[;{]/,eE:!0,i:"\\$|\\[|%",c:[e.UTM,{cN:"params",b:"\\(",e:"\\)",c:["self",c,e.CBCM,t,a]}]},{cN:"class",bK:"class interface",e:"{",eE:!0,i:/[:\(\$"]/,c:[{bK:"extends implements"},e.UTM]},{bK:"namespace",e:";",i:/[\.']/,c:[e.UTM]},{bK:"use",e:";",c:[e.UTM]},{b:"=>"},t,a]}});hljs.registerLanguage("json",function(e){var i={literal:"true false null"},n=[e.QSM,e.CNM],r={e:",",eW:!0,eE:!0,c:n,k:i},t={b:"{",e:"}",c:[{cN:"attr",b:/"/,e:/"/,c:[e.BE],i:"\\n"},e.inherit(r,{b:/:/})],i:"\\S"},c={b:"\\[",e:"\\]",c:[e.inherit(r)],i:"\\S"};return n.splice(n.length,0,t,c),{c:n,k:i,i:"\\S"}});hljs.registerLanguage("cpp",function(t){var e={cN:"keyword",b:"\\b[a-z\\d_]*_t\\b"},r={cN:"string",v:[{b:'(u8?|U)?L?"',e:'"',i:"\\n",c:[t.BE]},{b:'(u8?|U)?R"',e:'"',c:[t.BE]},{b:"'\\\\?.",e:"'",i:"."}]},s={cN:"number",v:[{b:"\\b(0b[01']+)"},{b:"\\b([\\d']+(\\.[\\d']*)?|\\.[\\d']+)(u|U|l|L|ul|UL|f|F|b|B)"},{b:"(-?)(\\b0[xX][a-fA-F0-9']+|(\\b[\\d']+(\\.[\\d']*)?|\\.[\\d']+)([eE][-+]?[\\d']+)?)"}],r:0},i={cN:"meta",b:/#\s*[a-z]+\b/,e:/$/,k:{"meta-keyword":"if else elif endif define undef warning error line pragma ifdef ifndef include"},c:[{b:/\\\n/,r:0},t.inherit(r,{cN:"meta-string"}),{cN:"meta-string",b:"<",e:">",i:"\\n"},t.CLCM,t.CBCM]},a=t.IR+"\\s*\\(",c={keyword:"int float while private char catch import module export virtual operator sizeof dynamic_cast|10 typedef const_cast|10 const struct for static_cast|10 union namespace unsigned long volatile static protected bool template mutable if public friend do goto auto void enum else break extern using class asm case typeid short reinterpret_cast|10 default double register explicit signed typename try this switch continue inline delete alignof constexpr decltype noexcept static_assert thread_local restrict _Bool complex _Complex _Imaginary atomic_bool atomic_char atomic_schar atomic_uchar atomic_short atomic_ushort atomic_int atomic_uint atomic_long atomic_ulong atomic_llong atomic_ullong new throw return",built_in:"std string cin cout cerr clog stdin stdout stderr stringstream istringstream ostringstream auto_ptr deque list queue stack vector map set bitset multiset multimap unordered_set unordered_map unordered_multiset unordered_multimap array shared_ptr abort abs acos asin atan2 atan calloc ceil cosh cos exit exp fabs floor fmod fprintf fputs free frexp fscanf isalnum isalpha iscntrl isdigit isgraph islower isprint ispunct isspace isupper isxdigit tolower toupper labs ldexp log10 log malloc realloc memchr memcmp memcpy memset modf pow printf putchar puts scanf sinh sin snprintf sprintf sqrt sscanf strcat strchr strcmp strcpy strcspn strlen strncat strncmp strncpy strpbrk strrchr strspn strstr tanh tan vfprintf vprintf vsprintf endl initializer_list unique_ptr",literal:"true false nullptr NULL"},n=[e,t.CLCM,t.CBCM,s,r];return{aliases:["c","cc","h","c++","h++","hpp"],k:c,i:"</",c:n.concat([i,{b:"\\b(deque|list|queue|stack|vector|map|set|bitset|multiset|multimap|unordered_map|unordered_set|unordered_multiset|unordered_multimap|array)\\s*<",e:">",k:c,c:["self",e]},{b:t.IR+"::",k:c},{v:[{b:/=/,e:/;/},{b:/\(/,e:/\)/},{bK:"new throw return else",e:/;/}],k:c,c:n.concat([{b:/\(/,e:/\)/,k:c,c:n.concat(["self"]),r:0}]),r:0},{cN:"function",b:"("+t.IR+"[\\*&\\s]+)+"+a,rB:!0,e:/[{;=]/,eE:!0,k:c,i:/[^\w\s\*&]/,c:[{b:a,rB:!0,c:[t.TM],r:0},{cN:"params",b:/\(/,e:/\)/,k:c,r:0,c:[t.CLCM,t.CBCM,r,s,e]},t.CLCM,t.CBCM,i]}]),exports:{preprocessor:i,strings:r,k:c}}});hljs.registerLanguage("css",function(e){var c="[a-zA-Z-][a-zA-Z0-9_-]*",t={b:/[A-Z\_\.\-]+\s*:/,rB:!0,e:";",eW:!0,c:[{cN:"attribute",b:/\S/,e:":",eE:!0,starts:{eW:!0,eE:!0,c:[{b:/[\w-]+\(/,rB:!0,c:[{cN:"built_in",b:/[\w-]+/},{b:/\(/,e:/\)/,c:[e.ASM,e.QSM]}]},e.CSSNM,e.QSM,e.ASM,e.CBCM,{cN:"number",b:"#[0-9A-Fa-f]+"},{cN:"meta",b:"!important"}]}}]};return{cI:!0,i:/[=\/|'\$]/,c:[e.CBCM,{cN:"selector-id",b:/#[A-Za-z0-9_-]+/},{cN:"selector-class",b:/\.[A-Za-z0-9_-]+/},{cN:"selector-attr",b:/\[/,e:/\]/,i:"$"},{cN:"selector-pseudo",b:/:(:)?[a-zA-Z0-9\_\-\+\(\)"'.]+/},{b:"@(font-face|page)",l:"[a-z-]+",k:"font-face page"},{b:"@",e:"[{;]",i:/:/,c:[{cN:"keyword",b:/\w+/},{b:/\s/,eW:!0,eE:!0,r:0,c:[e.ASM,e.QSM,e.CSSNM]}]},{cN:"selector-tag",b:c,r:0},{b:"{",e:"}",i:/\S/,c:[e.CBCM,t]}]}});hljs.registerLanguage("makefile",function(e){var a={cN:"variable",b:/\$\(/,e:/\)/,c:[e.BE]};return{aliases:["mk","mak"],c:[e.HCM,{b:/^\w+\s*\W*=/,rB:!0,r:0,starts:{e:/\s*\W*=/,eE:!0,starts:{e:/$/,r:0,c:[a]}}},{cN:"section",b:/^[\w]+:\s*$/},{cN:"meta",b:/^\.PHONY:/,e:/$/,k:{"meta-keyword":".PHONY"},l:/[\.\w]+/},{b:/^\t+/,e:/$/,r:0,c:[e.QSM,a]}]}});hljs.registerLanguage("objectivec",function(e){var t={cN:"built_in",b:"\\b(AV|CA|CF|CG|CI|CL|CM|CN|CT|MK|MP|MTK|MTL|NS|SCN|SK|UI|WK|XC)\\w+"},_={keyword:"int float while char export sizeof typedef const struct for union unsigned long volatile static bool mutable if do return goto void enum else break extern asm case short default double register explicit signed typename this switch continue wchar_t inline readonly assign readwrite self @synchronized id typeof nonatomic super unichar IBOutlet IBAction strong weak copy in out inout bycopy byref oneway __strong __weak __block __autoreleasing @private @protected @public @try @property @end @throw @catch @finally @autoreleasepool @synthesize @dynamic @selector @optional @required @encode @package @import @defs @compatibility_alias __bridge __bridge_transfer __bridge_retained __bridge_retain __covariant __contravariant __kindof _Nonnull _Nullable _Null_unspecified __FUNCTION__ __PRETTY_FUNCTION__ __attribute__ getter setter retain unsafe_unretained nonnull nullable null_unspecified null_resettable class instancetype NS_DESIGNATED_INITIALIZER NS_UNAVAILABLE NS_REQUIRES_SUPER NS_RETURNS_INNER_POINTER NS_INLINE NS_AVAILABLE NS_DEPRECATED NS_ENUM NS_OPTIONS NS_SWIFT_UNAVAILABLE NS_ASSUME_NONNULL_BEGIN NS_ASSUME_NONNULL_END NS_REFINED_FOR_SWIFT NS_SWIFT_NAME NS_SWIFT_NOTHROW NS_DURING NS_HANDLER NS_ENDHANDLER NS_VALUERETURN NS_VOIDRETURN",literal:"false true FALSE TRUE nil YES NO NULL",built_in:"BOOL dispatch_once_t dispatch_queue_t dispatch_sync dispatch_async dispatch_once"},i=/[a-zA-Z@][a-zA-Z0-9_]*/,n="@interface @class @protocol @implementation";return{aliases:["mm","objc","obj-c"],k:_,l:i,i:"</",c:[t,e.CLCM,e.CBCM,e.CNM,e.QSM,{cN:"string",v:[{b:'@"',e:'"',i:"\\n",c:[e.BE]},{b:"'",e:"[^\\\\]'",i:"[^\\\\][^']"}]},{cN:"meta",b:"#",e:"$",c:[{cN:"meta-string",v:[{b:'"',e:'"'},{b:"<",e:">"}]}]},{cN:"class",b:"("+n.split(" ").join("|")+")\\b",e:"({|$)",eE:!0,k:n,l:i,c:[e.UTM]},{b:"\\."+e.UIR,r:0}]}});hljs.registerLanguage("nginx",function(e){var r={cN:"variable",v:[{b:/\$\d+/},{b:/\$\{/,e:/}/},{b:"[\\$\\@]"+e.UIR}]},b={eW:!0,l:"[a-z/_]+",k:{literal:"on off yes no true false none blocked debug info notice warn error crit select break last permanent redirect kqueue rtsig epoll poll /dev/poll"},r:0,i:"=>",c:[e.HCM,{cN:"string",c:[e.BE,r],v:[{b:/"/,e:/"/},{b:/'/,e:/'/}]},{b:"([a-z]+):/",e:"\\s",eW:!0,eE:!0,c:[r]},{cN:"regexp",c:[e.BE,r],v:[{b:"\\s\\^",e:"\\s|{|;",rE:!0},{b:"~\\*?\\s+",e:"\\s|{|;",rE:!0},{b:"\\*(\\.[a-z\\-]+)+"},{b:"([a-z\\-]+\\.)+\\*"}]},{cN:"number",b:"\\b\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}(:\\d{1,5})?\\b"},{cN:"number",b:"\\b\\d+[kKmMgGdshdwy]*\\b",r:0},r]};return{aliases:["nginxconf"],c:[e.HCM,{b:e.UIR+"\\s+{",rB:!0,e:"{",c:[{cN:"section",b:e.UIR}],r:0},{b:e.UIR+"\\s",e:";|{",rB:!0,c:[{cN:"attribute",b:e.UIR,starts:b}],r:0}],i:"[^\\s\\}]"}});hljs.registerLanguage("python",function(e){var r={cN:"meta",b:/^(>>>|\.\.\.) /},b={cN:"string",c:[e.BE],v:[{b:/(u|b)?r?'''/,e:/'''/,c:[r],r:10},{b:/(u|b)?r?"""/,e:/"""/,c:[r],r:10},{b:/(u|r|ur)'/,e:/'/,r:10},{b:/(u|r|ur)"/,e:/"/,r:10},{b:/(b|br)'/,e:/'/},{b:/(b|br)"/,e:/"/},e.ASM,e.QSM]},a={cN:"number",r:0,v:[{b:e.BNR+"[lLjJ]?"},{b:"\\b(0o[0-7]+)[lLjJ]?"},{b:e.CNR+"[lLjJ]?"}]},l={cN:"params",b:/\(/,e:/\)/,c:["self",r,a,b]};return{aliases:["py","gyp"],k:{keyword:"and elif is global as in if from raise for except finally print import pass return exec else break not with class assert yield try while continue del or def lambda async await nonlocal|10 None True False",built_in:"Ellipsis NotImplemented"},i:/(<\/|->|\?)/,c:[r,a,b,e.HCM,{v:[{cN:"function",bK:"def",r:10},{cN:"class",bK:"class"}],e:/:/,i:/[${=;\n,]/,c:[e.UTM,l,{b:/->/,eW:!0,k:"None"}]},{cN:"meta",b:/^[\t ]*@/,e:/$/},{b:/\b(print|exec)\(/}]}});hljs.registerLanguage("diff",function(e){return{aliases:["patch"],c:[{cN:"meta",r:10,v:[{b:/^@@ +\-\d+,\d+ +\+\d+,\d+ +@@$/},{b:/^\*\*\* +\d+,\d+ +\*\*\*\*$/},{b:/^\-\-\- +\d+,\d+ +\-\-\-\-$/}]},{cN:"comment",v:[{b:/Index: /,e:/$/},{b:/={3,}/,e:/$/},{b:/^\-{3}/,e:/$/},{b:/^\*{3} /,e:/$/},{b:/^\+{3}/,e:/$/},{b:/\*{5}/,e:/\*{5}$/}]},{cN:"addition",b:"^\\+",e:"$"},{cN:"deletion",b:"^\\-",e:"$"},{cN:"addition",b:"^\\!",e:"$"}]}});hljs.registerLanguage("java",function(e){var t=e.UIR+"(<"+e.UIR+"(\\s*,\\s*"+e.UIR+")*>)?",a="false synchronized int abstract float private char boolean static null if const for true while long strictfp finally protected import native final void enum else break transient catch instanceof byte super volatile case assert short package default double public try this switch continue throws protected public private module requires exports",r="\\b(0[bB]([01]+[01_]+[01]+|[01]+)|0[xX]([a-fA-F0-9]+[a-fA-F0-9_]+[a-fA-F0-9]+|[a-fA-F0-9]+)|(([\\d]+[\\d_]+[\\d]+|[\\d]+)(\\.([\\d]+[\\d_]+[\\d]+|[\\d]+))?|\\.([\\d]+[\\d_]+[\\d]+|[\\d]+))([eE][-+]?\\d+)?)[lLfF]?",s={cN:"number",b:r,r:0};return{aliases:["jsp"],k:a,i:/<\/|#/,c:[e.C("/\\*\\*","\\*/",{r:0,c:[{b:/\w+@/,r:0},{cN:"doctag",b:"@[A-Za-z]+"}]}),e.CLCM,e.CBCM,e.ASM,e.QSM,{cN:"class",bK:"class interface",e:/[{;=]/,eE:!0,k:"class interface",i:/[:"\[\]]/,c:[{bK:"extends implements"},e.UTM]},{bK:"new throw return else",r:0},{cN:"function",b:"("+t+"\\s+)+"+e.UIR+"\\s*\\(",rB:!0,e:/[{;=]/,eE:!0,k:a,c:[{b:e.UIR+"\\s*\\(",rB:!0,r:0,c:[e.UTM]},{cN:"params",b:/\(/,e:/\)/,k:a,r:0,c:[e.ASM,e.QSM,e.CNM,e.CBCM]},e.CLCM,e.CBCM]},s,{cN:"meta",b:"@[A-Za-z]+"}]}});hljs.registerLanguage("bash",function(e){var t={cN:"variable",v:[{b:/\$[\w\d#@][\w\d_]*/},{b:/\$\{(.*?)}/}]},s={cN:"string",b:/"/,e:/"/,c:[e.BE,t,{cN:"variable",b:/\$\(/,e:/\)/,c:[e.BE]}]},a={cN:"string",b:/'/,e:/'/};return{aliases:["sh","zsh"],l:/-?[a-z\._]+/,k:{keyword:"if then else elif fi for while in do done case esac function",literal:"true false",built_in:"break cd continue eval exec exit export getopts hash pwd readonly return shift test times trap umask unset alias bind builtin caller command declare echo enable help let local logout mapfile printf read readarray source type typeset ulimit unalias set shopt autoload bg bindkey bye cap chdir clone comparguments compcall compctl compdescribe compfiles compgroups compquote comptags comptry compvalues dirs disable disown echotc echoti emulate fc fg float functions getcap getln history integer jobs kill limit log noglob popd print pushd pushln rehash sched setcap setopt stat suspend ttyctl unfunction unhash unlimit unsetopt vared wait whence where which zcompile zformat zftp zle zmodload zparseopts zprof zpty zregexparse zsocket zstyle ztcp",_:"-ne -eq -lt -gt -f -d -e -s -l -a"},c:[{cN:"meta",b:/^#![^\n]+sh\s*$/,r:10},{cN:"function",b:/\w[\w\d_]*\s*\(\s*\)\s*\{/,rB:!0,c:[e.inherit(e.TM,{b:/\w[\w\d_]*/})],r:0},e.HCM,s,a,t]}});hljs.registerLanguage("javascript",function(e){var r="[A-Za-z$_][0-9A-Za-z$_]*",t={keyword:"in of if for while finally var new function do return void else break catch instanceof with throw case default try this switch continue typeof delete let yield const export super debugger as async await static import from as",literal:"true false null undefined NaN Infinity",built_in:"eval isFinite isNaN parseFloat parseInt decodeURI decodeURIComponent encodeURI encodeURIComponent escape unescape Object Function Boolean Error EvalError InternalError RangeError ReferenceError StopIteration SyntaxError TypeError URIError Number Math Date String RegExp Array Float32Array Float64Array Int16Array Int32Array Int8Array Uint16Array Uint32Array Uint8Array Uint8ClampedArray ArrayBuffer DataView JSON Intl arguments require module console window document Symbol Set Map WeakSet WeakMap Proxy Reflect Promise"},a={cN:"number",v:[{b:"\\b(0[bB][01]+)"},{b:"\\b(0[oO][0-7]+)"},{b:e.CNR}],r:0},n={cN:"subst",b:"\\$\\{",e:"\\}",k:t,c:[]},c={cN:"string",b:"`",e:"`",c:[e.BE,n]};n.c=[e.ASM,e.QSM,c,a,e.RM];var s=n.c.concat([e.CBCM,e.CLCM]);return{aliases:["js","jsx"],k:t,c:[{cN:"meta",r:10,b:/^\s*['"]use (strict|asm)['"]/},{cN:"meta",b:/^#!/,e:/$/},e.ASM,e.QSM,c,e.CLCM,e.CBCM,a,{b:/[{,]\s*/,r:0,c:[{b:r+"\\s*:",rB:!0,r:0,c:[{cN:"attr",b:r,r:0}]}]},{b:"("+e.RSR+"|\\b(case|return|throw)\\b)\\s*",k:"return throw case",c:[e.CLCM,e.CBCM,e.RM,{cN:"function",b:"(\\(.*?\\)|"+r+")\\s*=>",rB:!0,e:"\\s*=>",c:[{cN:"params",v:[{b:r},{b:/\(\s*\)/},{b:/\(/,e:/\)/,eB:!0,eE:!0,k:t,c:s}]}]},{b:/</,e:/(\/\w+|\w+\/)>/,sL:"xml",c:[{b:/<\w+\s*\/>/,skip:!0},{b:/<\w+/,e:/(\/\w+|\w+\/)>/,skip:!0,c:[{b:/<\w+\s*\/>/,skip:!0},"self"]}]}],r:0},{cN:"function",bK:"function",e:/\{/,eE:!0,c:[e.inherit(e.TM,{b:r}),{cN:"params",b:/\(/,e:/\)/,eB:!0,eE:!0,c:s}],i:/\[|%/},{b:/\$[(.]/},e.METHOD_GUARD,{cN:"class",bK:"class",e:/[{;=]/,eE:!0,i:/[:"\[\]]/,c:[{bK:"extends"},e.UTM]},{bK:"constructor",e:/\{/,eE:!0}],i:/#(?!!)/}});
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/local-redirect/local-redirect.js b/clones/docs.racket-lang.org/local-redirect/local-redirect.js
index 0f5acdce..f8f9ed78 100644
--- a/clones/docs.racket-lang.org/local-redirect/local-redirect.js
+++ b/clones/docs.racket-lang.org/local-redirect/local-redirect.js
@@ -90,6 +90,7 @@ var link_dirs = [
  ["bs", "../bs"],
  ["bug-report", "../bug-report"],
  ["buid", "../buid"],
+ ["bv", "../bv"],
  ["bzip2", "../bzip2"],
  ["c", "../c"],
  ["c-defs", "../c-defs"],
@@ -153,6 +154,7 @@ var link_dirs = [
  ["cpu-affinity", "../cpu-affinity"],
  ["cpuinfo", "../cpuinfo"],
  ["crc32c", "../crc32c"],
+ ["crontab-manual", "../crontab-manual"],
  ["crypto", "../crypto"],
  ["cs135-drtools", "../cs135-drtools"],
  ["cs2500f16-jsonlab", "../cs2500f16-jsonlab"],
@@ -256,6 +258,7 @@ var link_dirs = [
  ["ebml", "../ebml"],
  ["ebuild", "../ebuild"],
  ["ec", "../ec"],
+ ["eclass2scrbl", "../eclass2scrbl"],
  ["ecmascript", "../ecmascript"],
  ["ee-lib", "../ee-lib"],
  ["effection", "../effection"],
@@ -296,6 +299,7 @@ var link_dirs = [
  ["font-finder", "../font-finder"],
  ["for-helpers", "../for-helpers"],
  ["foreign", "../foreign"],
+ ["forged-ocelot", "../forged-ocelot"],
  ["formatted-string", "../formatted-string"],
  ["forms", "../forms"],
  ["forth", "../forth"],
@@ -409,6 +413,7 @@ var link_dirs = [
  ["inexact-number-lang", "../inexact-number-lang"],
  ["infix-manual", "../infix-manual"],
  ["infix-syntax", "../infix-syntax"],
+ ["ini", "../ini"],
  ["inside", "../inside"],
  ["interactive-brokers-api", "../interactive-brokers-api"],
  ["interconfection", "../interconfection"],
@@ -492,6 +497,7 @@ var link_dirs = [
  ["magenc", "../magenc"],
  ["magnolisp", "../magnolisp"],
  ["main", "../main"],
+ ["majordomo2", "../majordomo2"],
  ["make", "../make"],
  ["make-log-interceptor", "../make-log-interceptor"],
  ["manual-flomat", "../manual-flomat"],
@@ -728,6 +734,7 @@ var link_dirs = [
  ["racket-paint", "../racket-paint"],
  ["racket-quandl", "../racket-quandl"],
  ["racket-route-match", "../racket-route-match"],
+ ["racket-tree-sitter", "../racket-tree-sitter"],
  ["racket_turtle", "../racket_turtle"],
  ["racketscript", "../racketscript"],
  ["racketui", "../racketui"],
@@ -801,6 +808,7 @@ var link_dirs = [
  ["rokit-racket", "../rokit-racket"],
  ["roman-numeral", "../roman-numeral"],
  ["roomba", "../roomba"],
+ ["rosette-guide", "../rosette-guide"],
  ["routy", "../routy"],
  ["rparallel", "../rparallel"],
  ["rpn", "../rpn"],
@@ -814,6 +822,7 @@ var link_dirs = [
  ["ruckus", "../ruckus"],
  ["runomatic", "../runomatic"],
  ["russian", "../russian"],
+ ["russian-lang", "../russian-lang"],
  ["rws-html-template", "../rws-html-template"],
  ["rx-tx-async-channel", "../rx-tx-async-channel"],
  ["s3-sync", "../s3-sync"],
@@ -1142,7 +1151,7 @@ function demand_load(p, callback) {
 
 var loaded_link_targets = [];
 var link_targets = [];
-var num_link_target_bins = 20;
+var num_link_target_bins = 21;
 
 function convert_all_links() {
    var elements = document.getElementsByClassName("Sq");
@@ -1166,7 +1175,7 @@ function convert_all_links() {
          }
      }
      if (tag) {
-       var v = hash_string(decodeURIComponent(tag[0].substring(4))) % 20;
+       var v = hash_string(decodeURIComponent(tag[0].substring(4))) % 21;
        if (!loaded_link_targets[v]) {
          loaded_link_targets[v] = true;
          var p = "../local-redirect/local-redirect_" + v + ".js";
diff --git a/clones/docs.racket-lang.org/reference/Building_New_Contract_Combinators.html b/clones/docs.racket-lang.org/reference/Building_New_Contract_Combinators.html
new file mode 100644
index 00000000..342decb0
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Building_New_Contract_Combinators.html
@@ -0,0 +1,313 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>8.7&nbsp;Building New Contract Combinators</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.1&nbsp;</td><td><a href="data-structure-contracts.html" class="tocviewlink" data-pltdoc="x">Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.2&nbsp;</td><td><a href="function-contracts.html" class="tocviewlink" data-pltdoc="x">Function Contracts</a></td></tr><tr><td align="right">8.3&nbsp;</td><td><a href="parametric-contracts.html" class="tocviewlink" data-pltdoc="x">Parametric Contracts</a></td></tr><tr><td align="right">8.4&nbsp;</td><td><a href="Lazy_Data-structure_Contracts.html" class="tocviewlink" data-pltdoc="x">Lazy Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.5&nbsp;</td><td><a href="Structure_Type_Property_Contracts.html" class="tocviewlink" data-pltdoc="x">Structure Type Property Contracts</a></td></tr><tr><td align="right">8.6&nbsp;</td><td><a href="attaching-contracts-to-values.html" class="tocviewlink" data-pltdoc="x">Attaching Contracts to Values</a></td></tr><tr><td align="right">8.7&nbsp;</td><td><a href="Building_New_Contract_Combinators.html" class="tocviewselflink" data-pltdoc="x">Building New Contract Combinators</a></td></tr><tr><td align="right">8.8&nbsp;</td><td><a href="contract-utilities.html" class="tocviewlink" data-pltdoc="x">Contract Utilities</a></td></tr><tr><td align="right">8.9&nbsp;</td><td><a href="racket_contract_base.html" class="tocviewlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>contract/<span class="mywbr"> &nbsp;</span>base</span></span></a></td></tr><tr><td align="right">8.10&nbsp;</td><td><a href="collapsible.html" class="tocviewlink" data-pltdoc="x">Collapsible Contracts</a></td></tr><tr><td align="right">8.11&nbsp;</td><td><a href="Legacy_Contracts.html" class="tocviewlink" data-pltdoc="x">Legacy Contracts</a></td></tr><tr><td align="right">8.12&nbsp;</td><td><a href="Random_generation.html" class="tocviewlink" data-pltdoc="x">Random generation</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>8.7&nbsp;</td><td><a href="Building_New_Contract_Combinators.html" class="tocviewselflink" data-pltdoc="x">Building New Contract Combinators</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.7.1&nbsp;</td><td><a href="Building_New_Contract_Combinators.html#%28part._.Blame_.Objects%29" class="tocviewlink" data-pltdoc="x">Blame Objects</a></td></tr><tr><td align="right">8.7.2&nbsp;</td><td><a href="Building_New_Contract_Combinators.html#%28part._.Contracts_as_structs%29" class="tocviewlink" data-pltdoc="x">Contracts as structs</a></td></tr><tr><td align="right">8.7.3&nbsp;</td><td><a href="Building_New_Contract_Combinators.html#%28part._.Obligation_.Information_in_.Check_.Syntax%29" class="tocviewlink" data-pltdoc="x">Obligation Information in Check Syntax</a></td></tr><tr><td align="right">8.7.4&nbsp;</td><td><a href="Building_New_Contract_Combinators.html#%28part._.Utilities_for_.Building_.New_.Combinators%29" class="tocviewlink" data-pltdoc="x">Utilities for Building New Combinators</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._make-contract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._make-chaperone-contract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>chaperone-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._make-flat-contract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>flat-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._build-compound-type-name%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">build-<wbr></wbr>compound-<wbr></wbr>type-<wbr></wbr>name</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-contract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">coerce-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-contracts%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">coerce-<wbr></wbr>contracts</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-chaperone-contract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">coerce-<wbr></wbr>chaperone-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-chaperone-contracts%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">coerce-<wbr></wbr>chaperone-<wbr></wbr>contracts</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-flat-contract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">coerce-<wbr></wbr>flat-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-flat-contracts%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">coerce-<wbr></wbr>flat-<wbr></wbr>contracts</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-contract%2Ff%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">coerce-<wbr></wbr>contract/<span class="mywbr"> &nbsp;</span>f</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._skip-projection-wrapper~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">skip-<wbr></wbr>projection-<wbr></wbr>wrapper?</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._with-contract-continuation-mark%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>contract-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-pos%2Fneg-doubling%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">contract-<wbr></wbr>pos/<span class="mywbr"> &nbsp;</span>neg-<wbr></wbr>doubling</span></span></a></td></tr><tr><td><span class="tocsublinknumber">8.7.1<tt>&nbsp;</tt></span><a href="Building_New_Contract_Combinators.html#%28part._.Blame_.Objects%29" class="tocsubseclink" data-pltdoc="x">Blame Objects</a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame?</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._raise-blame-error%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-<wbr></wbr>blame-<wbr></wbr>error</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-add-context%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-<wbr></wbr>add-<wbr></wbr>context</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-context%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-<wbr></wbr>context</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-positive%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-<wbr></wbr>positive</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-negative%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-<wbr></wbr>negative</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-contract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-value%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-<wbr></wbr>value</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-source%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-<wbr></wbr>source</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-swap%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-<wbr></wbr>swap</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-original~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-<wbr></wbr>original?</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-swapped~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-<wbr></wbr>swapped?</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-replace-negative%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-<wbr></wbr>replace-<wbr></wbr>negative</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-replaced-negative~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-<wbr></wbr>replaced-<wbr></wbr>negative?</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-update%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-<wbr></wbr>update</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-missing-party~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-<wbr></wbr>missing-<wbr></wbr>party?</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-add-missing-party%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-<wbr></wbr>add-<wbr></wbr>missing-<wbr></wbr>party</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._exn~3afail~3acontract~3ablame%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>contract:<span class="mywbr"> &nbsp;</span>blame</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._current-blame-format%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>blame-<wbr></wbr>format</span></span></a></td></tr><tr><td><span class="tocsublinknumber">8.7.2<tt>&nbsp;</tt></span><a href="Building_New_Contract_Combinators.html#%28part._.Contracts_as_structs%29" class="tocsubseclink" data-pltdoc="x">Contracts as structs</a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3acontract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>contract</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3achaperone-contract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>chaperone-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3aflat-contract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>flat-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._prop~3acontracted%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>contracted</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._impersonator-prop~3acontracted%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonator-<wbr></wbr>prop:<span class="mywbr"> &nbsp;</span>contracted</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._prop~3ablame%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>blame</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._impersonator-prop~3ablame%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonator-<wbr></wbr>prop:<span class="mywbr"> &nbsp;</span>blame</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._build-flat-contract-property%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">build-<wbr></wbr>flat-<wbr></wbr>contract-<wbr></wbr>property</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._build-chaperone-contract-property%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">build-<wbr></wbr>chaperone-<wbr></wbr>contract-<wbr></wbr>property</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._build-contract-property%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">build-<wbr></wbr>contract-<wbr></wbr>property</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._contract-property~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-<wbr></wbr>property?</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._chaperone-contract-property~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-<wbr></wbr>contract-<wbr></wbr>property?</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._flat-contract-property~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flat-<wbr></wbr>contract-<wbr></wbr>property?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">8.7.3<tt>&nbsp;</tt></span><a href="Building_New_Contract_Combinators.html#%28part._.Obligation_.Information_in_.Check_.Syntax%29" class="tocsubseclink" data-pltdoc="x">Obligation Information in Check Syntax</a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._define%2Ffinal-prop%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/<span class="mywbr"> &nbsp;</span>final-<wbr></wbr>prop</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._define%2Fsubexpression-pos-prop%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/<span class="mywbr"> &nbsp;</span>subexpression-<wbr></wbr>pos-<wbr></wbr>prop</span></span></a></td></tr><tr><td><span class="tocsublinknumber">8.7.4<tt>&nbsp;</tt></span><a href="Building_New_Contract_Combinators.html#%28part._.Utilities_for_.Building_.New_.Combinators%29" class="tocsubseclink" data-pltdoc="x">Utilities for Building New Combinators</a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-stronger~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-<wbr></wbr>stronger?</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-equivalent~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-<wbr></wbr>equivalent?</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-first-order-passes~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-<wbr></wbr>first-<wbr></wbr>order-<wbr></wbr>passes?</span></span></a></td></tr><tr><td><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-first-order%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-<wbr></wbr>first-<wbr></wbr>order</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="attaching-contracts-to-values.html" title="backward to &quot;8.6 Attaching Contracts to Values&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contract-utilities.html" title="forward to &quot;8.8 Contract Utilities&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Building_New_Contract_Combinators&quot;">8.7<tt>&nbsp;</tt><a name="(part._.Building_.New_.Contract_.Combinators)"></a><a name="(mod-path._racket/contract/combinator)"></a>Building New Contract Combinators</h4><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="Building_New_Contract_Combinators.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/contract/combinator</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top" colspan="3"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/prop..rkt)._make-contract))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._make-contract%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-contract</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:name</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:first-order</span><span class="hspace">&nbsp;</span><span class="RktVar">first-order</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:late-neg-projection</span><span class="hspace">&nbsp;</span><span class="RktVar">late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:collapsible-late-neg-projection</span><span class="hspace">&nbsp;</span><span class="RktVar">collapsible-late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:val-first-projection</span><span class="hspace">&nbsp;</span><span class="RktVar">val-first-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:projection</span><span class="hspace">&nbsp;</span><span class="RktVar">proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:stronger</span><span class="hspace">&nbsp;</span><span class="RktVar">stronger</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:equivalent</span><span class="hspace">&nbsp;</span><span class="RktVar">equivalent</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:list-contract?</span><span class="hspace">&nbsp;</span><span class="RktVar">is-list-contract?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">anonymous-contract</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">first-order</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">collapsible-late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract~3f%29%29" class="RktValLink" data-pltdoc="x">collapsible-contract?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">val-first-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">first-order</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">x</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._raise-blame-error%29%29" class="RktValLink" data-pltdoc="x">raise-blame-error</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">expected:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~a"</span><span class="hspace">&nbsp;</span><span class="RktVal">given:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~e"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stronger</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">equivalent</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">is-list-contract?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top" colspan="3"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/combinator..rkt)._make-chaperone-contract))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._make-chaperone-contract%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-chaperone-contract</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:name</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:first-order</span><span class="hspace">&nbsp;</span><span class="RktVar">first-order</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:late-neg-projection</span><span class="hspace">&nbsp;</span><span class="RktVar">late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:collapsible-late-neg-projection</span><span class="hspace">&nbsp;</span><span class="RktVar">collapsible-late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:val-first-projection</span><span class="hspace">&nbsp;</span><span class="RktVar">val-first-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:projection</span><span class="hspace">&nbsp;</span><span class="RktVar">proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:stronger</span><span class="hspace">&nbsp;</span><span class="RktVar">stronger</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:equivalent</span><span class="hspace">&nbsp;</span><span class="RktVar">equivalent</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:list-contract?</span><span class="hspace">&nbsp;</span><span class="RktVar">is-list-contract?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._chaperone-contract~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">anonymous-chaperone-contract</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">first-order</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">collapsible-late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract~3f%29%29" class="RktValLink" data-pltdoc="x">collapsible-contract?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">val-first-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">first-order</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">x</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._raise-blame-error%29%29" class="RktValLink" data-pltdoc="x">raise-blame-error</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">expected:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~a"</span><span class="hspace">&nbsp;</span><span class="RktVal">given:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~e"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stronger</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">equivalent</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">is-list-contract?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top" colspan="3"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/combinator..rkt)._make-flat-contract))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._make-flat-contract%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-flat-contract</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:name</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:first-order</span><span class="hspace">&nbsp;</span><span class="RktVar">first-order</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:late-neg-projection</span><span class="hspace">&nbsp;</span><span class="RktVar">late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:collapsible-late-neg-projection</span><span class="hspace">&nbsp;</span><span class="RktVar">collapsible-late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:val-first-projection</span><span class="hspace">&nbsp;</span><span class="RktVar">val-first-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:projection</span><span class="hspace">&nbsp;</span><span class="RktVar">proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:stronger</span><span class="hspace">&nbsp;</span><span class="RktVar">stronger</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:equivalent</span><span class="hspace">&nbsp;</span><span class="RktVar">equivalent</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:list-contract?</span><span class="hspace">&nbsp;</span><span class="RktVar">is-list-contract?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">anonymous-flat-contract</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">first-order</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">collapsible-late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract~3f%29%29" class="RktValLink" data-pltdoc="x">collapsible-contract?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">val-first-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">first-order</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">x</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._raise-blame-error%29%29" class="RktValLink" data-pltdoc="x">raise-blame-error</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">expected:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~a"</span><span class="hspace">&nbsp;</span><span class="RktVal">given:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~e"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stronger</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">equivalent</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">is-list-contract?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">These functions build simple higher-order contracts, <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contracts</span></a>,
+and <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a>, respectively.  They all take the same set of three
+optional arguments: a name, a first-order predicate, and a blame-tracking projection.
+For <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._make-flat-contract%29%29" class="RktValLink" data-pltdoc="x">make-flat-contract</a></span>, see also <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._flat-contract-with-explanation%29%29" class="RktValLink" data-pltdoc="x">flat-contract-with-explanation</a></span>.</div></p><p>The <span class="RktVar">name</span> argument is any value to be rendered using <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> to
+describe the contract when a violation occurs.  The default name for simple
+higher-order contracts is <span class="RktRes">anonymous-contract</span>, for
+<a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contracts</span></a> is <span class="RktRes">anonymous-chaperone-contract</span>, and for
+<a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a> is <span class="RktRes">anonymous-flat-contract</span>.</p><p>The first-order predicate <span class="RktVar">first-order</span> is used to determine which values
+the contract applies to.  This test is used
+by <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-first-order-passes~3f%29%29" class="RktValLink" data-pltdoc="x">contract-first-order-passes?</a></span>, and indirectly by <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span>
+and <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._first-or%2Fc%29%29" class="RktValLink" data-pltdoc="x">first-or/c</a></span> to determine which higher-order contract to wrap a
+value with when there are multiple higher-order contracts to choose from.
+The default value accepts any value, but it must match the behavior of the
+projection argument (see below for how). The predicate should be influenced by
+the value of <span class="RktPn">(</span><span class="RktSym">contract-first-order-okay-to-give-up?</span><span class="RktPn">)</span> (see it&rsquo;s documentation
+for more explanation).</p><p>The <span class="RktVar">late-neg-proj</span> argument defines the behavior of applying
+ the contract via a <a name="(tech._late._neg._projection)"></a><span style="font-style: italic">late neg projection</span>. If it is supplied, this
+ argument accepts a <a href="Building_New_Contract_Combinators.html#%28tech._blame._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">blame object</span></a> that is missing one party (see also
+ <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-missing-party~3f%29%29" class="RktValLink" data-pltdoc="x">blame-missing-party?</a></span>).  Then it must return a function that accepts
+ both the value that is getting the contract and the name of the missing blame
+ party, in that order. The result must either be the value (perhaps suitably
+ wrapped with a <a href="chaperones.html#%28tech._chaperone%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone</span></a> or <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a> to enforce the
+ contract), or signal a contract violation using <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._raise-blame-error%29%29" class="RktValLink" data-pltdoc="x">raise-blame-error</a></span>.
+ The default is <span class="RktVal">#f</span>.</p><p>The <span class="RktVar">collapsible-late-neg-proj</span> argument takes the place of the
+ <span class="RktVar">late-neg-proj</span> argument for contracts that support collapsing.
+ If it is supplied, this argument accepts a <a href="Building_New_Contract_Combinators.html#%28tech._blame._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">blame object</span></a> that is
+ missing one party. It must return two values. The first value must be
+ a function that accepts both the value that is getting the contract and
+ the name of the missing blame party, in that order. The second value should
+ be a <a href="collapsible.html#%28tech._collapsible._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">collapsible</span></a> representation of the contract.</p><p>The projection <span class="RktVar">proj</span> and <span class="RktVar">val-first-proj</span> are older mechanisms for
+ defining the behavior of applying the contract.  The <span class="RktVar">proj</span> argument
+is a curried function of two arguments: the first application accepts a blame
+object, and the second accepts a value to protect with the contract.  The
+projection must either produce the value, suitably wrapped to enforce any
+higher-order aspects of the contract, or signal a contract violation using
+<span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._raise-blame-error%29%29" class="RktValLink" data-pltdoc="x">raise-blame-error</a></span>.  The default projection produces an error when the
+first-order test fails, and produces the value unchanged otherwise.
+The <span class="RktVar">val-first-proj</span> is like <span class="RktVar">late-neg-proj</span>, except with
+an extra layer of currying.</p><p>At least one of the <span class="RktVar">late-neg-proj</span>, <span class="RktVar">proj</span>,
+ <span class="RktVar">val-first-proj</span>, or <span class="RktVar">first-order</span> must be non-<span class="RktVal">#f</span>.</p><p>The projection arguments (<span class="RktVar">late-neg-proj</span>, <span class="RktVar">proj</span>, and
+ <span class="RktVar">val-first-proj</span>) must be in sync with the <span class="RktVar">first-order</span> argument.
+ In particular, if the <span class="RktVar">first-order</span> argument returns <span class="RktVal">#f</span> for some value,
+ then the projections must raise a blame error for that value and if the
+ <span class="RktVar">first-order</span> argument returns <span class="RktVal">#t</span> for some value, then the projection must
+ not signal any blame for this value, unless there are higher-order interactions
+ later. In other words, for <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a>, the <span class="RktVar">first-order</span> and
+ <span class="RktSym">projection</span> arguments must check the same predicate. For convenience, the
+ the default projection uses the <span class="RktVar">first-order</span> argument, signalling an error
+ when it returns <span class="RktVal">#f</span> and never signalling one otherwise.</p><p>Projections for <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contracts</span></a> must produce a value that passes
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-of~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-of?</a></span> when compared with the original, uncontracted value.
+Projections for <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a> must fail precisely when <span class="RktVar">first-order</span>
+does, and must produce the input value unchanged otherwise.  Applying a
+<a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> may result in either an application of the predicate, or the
+projection, or both; therefore, the two must be consistent.  The existence of a
+separate projection only serves to provide more specific error messages.  Most
+<a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a> do not need to supply an explicit projection.</p><p>The <span class="RktVar">stronger</span> argument is used to implement <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-stronger~3f%29%29" class="RktValLink" data-pltdoc="x">contract-stronger?</a></span>. The
+first argument is always the contract itself and the second argument is whatever
+was passed as the second argument to <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-stronger~3f%29%29" class="RktValLink" data-pltdoc="x">contract-stronger?</a></span>. If no
+<span class="RktVar">stronger</span> argument is supplied, then a default that compares its arguments
+with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> is used for <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a> and <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contracts</span></a>.
+For <a href="contracts.html#%28tech._impersonator._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator contracts</span></a> constructed with <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._make-contract%29%29" class="RktValLink" data-pltdoc="x">make-contract</a></span> that do not
+supply the <span class="RktVar">stronger</span> argument, <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-stronger~3f%29%29" class="RktValLink" data-pltdoc="x">contract-stronger?</a></span> returns <span class="RktVal">#f</span>.</p><p>Similarly, the <span class="RktVar">equivalent</span> argument is used to implement <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-equivalent~3f%29%29" class="RktValLink" data-pltdoc="x">contract-equivalent?</a></span>.
+If it isn&rsquo;t supplied or <span class="RktVal">#false</span> is supplied, then <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> is used
+for chaperone and flat contracts, and <span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">x</span><span class="stt"> </span><span class="RktSym">y</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">#f</span><span class="RktPn">)</span> is used otherwise.</p><p>The <span class="RktVar">is-list-contract?</span> argument is used by the <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._list-contract~3f%29%29" class="RktValLink" data-pltdoc="x">list-contract?</a></span> predicate
+to determine if this is a contract that accepts only <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span> values.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">int/c</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._make-flat-contract%29%29" class="RktValLink" data-pltdoc="x">make-flat-contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:name</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">int/c</span><span class="hspace">&nbsp;</span><span class="RktPn">#:first-order</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._contract%29%29" class="RktStxLink" data-pltdoc="x">contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">int/c</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">positive</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">negative</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._contract%29%29" class="RktStxLink" data-pltdoc="x">contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">int/c</span><span class="hspace">&nbsp;</span><span class="RktVal">"not one"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">positive</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">negative</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">eval:4:0: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: int/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: "not one"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: int/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: positive</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: positive</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">int/c</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">int/c</span><span class="hspace">&nbsp;</span><span class="RktVal">"not one"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">int-&gt;int/c</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._make-contract%29%29" class="RktValLink" data-pltdoc="x">make-contract</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:name</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">int-&gt;int/c</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:first-order</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:projection</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">domain</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-projection%29%29" class="RktValLink" data-pltdoc="x">contract-projection</a></span><span class="hspace">&nbsp;</span><span class="RktSym">int/c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-swap%29%29" class="RktValLink" data-pltdoc="x">blame-swap</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._range%29%29" class="RktValLink" data-pltdoc="x">range</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-projection%29%29" class="RktValLink" data-pltdoc="x">contract-projection</a></span><span class="hspace">&nbsp;</span><span class="RktSym">int/c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._range%29%29" class="RktValLink" data-pltdoc="x">range</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">domain</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._raise-blame-error%29%29" class="RktValLink" data-pltdoc="x">raise-blame-error</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">expected</span><span class="hspace">&nbsp;</span><span class="RktVal">"a function of one argument"</span><span class="hspace">&nbsp;</span><span class="RktVal">given:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~e"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._contract%29%29" class="RktStxLink" data-pltdoc="x">contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">int-&gt;int/c</span><span class="hspace">&nbsp;</span><span class="RktVal">"not fun"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">positive</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">negative</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">eval:8:0: broke its own contract;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">promised a function of one argument</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: "not fun"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: int-&gt;int/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: positive</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: positive</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">halve</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._contract%29%29" class="RktStxLink" data-pltdoc="x">contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">int-&gt;int/c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2F%29%29" class="RktValLink" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">positive</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">negative</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">halve</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">halve</span><span class="hspace">&nbsp;</span><span class="RktVal">1/2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">halve: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: int/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 1/2</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: int-&gt;int/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: positive</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: negative</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">halve</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">halve: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: int/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: 1/2</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: int-&gt;int/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: positive</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: positive</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.0.1.13 of package <span class="stt">base</span>: Added the <span class="RktPn">#:list-contract?</span> argument.<br/>Changed in version 6.90.0.30: Added the <span class="RktPn">#:equivalent</span> argument.<br/>Changed in version 7.1.0.10: Added the <span class="RktPn">#:collapsible-late-neg-projection</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._build-compound-type-name))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._build-compound-type-name%29%29" class="RktValDef RktValLink" data-pltdoc="x">build-compound-type-name</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c/s</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c/s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces an S-expression to be used as a name
+for a contract. The arguments should be either contracts or
+symbols. It wraps parentheses around its arguments and
+extracts the names from any contracts it is supplied with.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._coerce-contract))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-contract%29%29" class="RktValDef RktValLink" data-pltdoc="x">coerce-contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Converts a regular Racket value into an instance of a contract struct,
+converting it according to the description of <a href="contracts.html#%28tech._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">contracts</span></a>.</div></p><p>If <span class="RktVar">v</span> is not one of the coercible values,
+<span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-contract%29%29" class="RktValLink" data-pltdoc="x">coerce-contract</a></span> signals an error, using the first argument in
+the error message.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._coerce-contracts))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-contracts%29%29" class="RktValDef RktValLink" data-pltdoc="x">coerce-contracts</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">vs</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Coerces all of the arguments in <span class="RktVar">vs</span> into contracts (via
+<span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-contract%2Ff%29%29" class="RktValLink" data-pltdoc="x">coerce-contract/f</a></span>) and signals an error if any of them are not
+contracts.  The error messages assume that the function named by
+<span class="RktVar">id</span> got <span class="RktVar">vs</span> as its entire argument list.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._coerce-chaperone-contract))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-chaperone-contract%29%29" class="RktValDef RktValLink" data-pltdoc="x">coerce-chaperone-contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._chaperone-contract~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-contract%29%29" class="RktValLink" data-pltdoc="x">coerce-contract</a></span>, but requires the result
+to be a <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contract</span></a>, not an arbitrary contract.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._coerce-chaperone-contracts))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-chaperone-contracts%29%29" class="RktValDef RktValLink" data-pltdoc="x">coerce-chaperone-contracts</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">vs</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._chaperone-contract~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-contract?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-contracts%29%29" class="RktValLink" data-pltdoc="x">coerce-contracts</a></span>, but requires the results
+to be <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contracts</span></a>, not arbitrary contracts.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._coerce-flat-contract))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-flat-contract%29%29" class="RktValDef RktValLink" data-pltdoc="x">coerce-flat-contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-contract%29%29" class="RktValLink" data-pltdoc="x">coerce-contract</a></span>, but requires the result
+to be a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>, not an arbitrary contract.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._coerce-flat-contracts))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-flat-contracts%29%29" class="RktValDef RktValLink" data-pltdoc="x">coerce-flat-contracts</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-contracts%29%29" class="RktValLink" data-pltdoc="x">coerce-contracts</a></span>, but requires the results
+to be <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a>, not arbitrary contracts.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._coerce-contract/f))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-contract%2Ff%29%29" class="RktValDef RktValLink" data-pltdoc="x">coerce-contract/f</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-contract%29%29" class="RktValLink" data-pltdoc="x">coerce-contract</a></span>, but returns <span class="RktVal">#f</span> if
+the value cannot be coerced to a contract.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/combinator..rkt)._skip-projection-wrapper~3f))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._skip-projection-wrapper~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">skip-projection-wrapper?</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._skip-projection-wrapper~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">skip-projection-wrapper?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">wrap?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">wrap?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The functions <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._make-chaperone-contract%29%29" class="RktValLink" data-pltdoc="x">make-chaperone-contract</a></span> and
+<span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._build-chaperone-contract-property%29%29" class="RktValLink" data-pltdoc="x">build-chaperone-contract-property</a></span> wrap their
+arguments to ensure that the result of the projections
+are chaperones of the input. This layer of wrapping can,
+in some cases, introduce unwanted overhead into contract
+checking. If this parameter&rsquo;s value is <span class="RktVal">#t</span>
+during the dynamic extent of the call to either of those
+functions, the wrapping (and thus the checks) are skipped.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/private/guts..rkt)._with-contract-continuation-mark))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._with-contract-continuation-mark%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">with-contract-continuation-mark</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">blame</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._with-contract-continuation-mark%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">with-contract-continuation-mark</a></span><span class="hspace">&nbsp;</span><span class="RktVar">blame+neg-party</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Inserts a continuation mark that informs the contract profiler (see
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?tag=%28part._%28.%27%28lib._contract-profile%2Fscribblings%2Fcontract-profile..scrbl%29.%27._.%27top.%27%29%29&amp;version=8.6" class="Sq" data-pltdoc="x">the contract profiling documentation</a>)
+that contract checking is happening.
+For the costs from checking your new combinator to be included, you should wrap
+any deferred, higher-order checks with this form. First-order checks are
+recognized automatically and do not require this form.</div></p><p>If your combinator&rsquo;s projections operate on complete <a href="Building_New_Contract_Combinators.html#%28tech._blame._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">blame objects</span></a> (i.e., no
+missing blame parties), the <a href="Building_New_Contract_Combinators.html#%28tech._blame._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">blame object</span></a> should be the first argument to this
+form. Otherwise (e.g., in the case of <span class="RktVar">late-neg</span> projections), a pair
+of the <a href="Building_New_Contract_Combinators.html#%28tech._blame._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">blame object</span></a> and the missing party should be used instead.</p><p class="SHistory">Added in version 6.4.0.4 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/private/guts..rkt)._contract-pos/neg-doubling))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-pos%2Fneg-doubling%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">contract-pos/neg-doubling</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">e1</span><span class="hspace">&nbsp;</span><span class="RktVar">e2</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Some contract combinators need to build projections for
+subcontracts with both regular and <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-swap%29%29" class="RktValLink" data-pltdoc="x">blame-swap</a></span>ed
+versions of the blame that they are given in order to check
+both access and mutations (e.g., <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector%2Fc%29%29" class="RktValLink" data-pltdoc="x">vector/c</a></span> and
+<span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vectorof%29%29" class="RktValLink" data-pltdoc="x">vectorof</a></span>). In the case that such combinators are
+nested deeply inside each other, there is a potential for an
+exponential explosion of nested projections being built.</div></p><p>To avoid that explosion, wrap each of the calls to the
+blame-accepting portion of the combinator in
+<span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-pos%2Fneg-doubling%29%29" class="RktStxLink" data-pltdoc="x">contract-pos/neg-doubling</a></span>. It returns three values.
+The first is a boolean, indicating how to interpret the
+other two results. If the boolean is <span class="RktVal">#t</span>, then the
+other two results are the values of <span class="RktVar">e1</span> and
+<span class="RktVar">e2</span> and we are not too deep in the nesting. If the
+boolean is <span class="RktVal">#f</span>, then we have passed a threshold and
+it is not safe to evaluate <span class="RktVar">e1</span> and <span class="RktVar">e2</span> yet,
+as we are in danger of running into the exponential
+slowdown. In that case, the last two results are thunks
+that, when invoked, compute the values of <span class="RktVar">e1</span> and
+<span class="RktVar">e2</span>.</p><p>As an example, <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vectorof%29%29" class="RktValLink" data-pltdoc="x">vectorof</a></span> uses
+<span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-pos%2Fneg-doubling%29%29" class="RktStxLink" data-pltdoc="x">contract-pos/neg-doubling</a></span> wrapping its two calls to
+the blame-accepting part of the projection for its
+subcontract. When it receives a <span class="RktVal">#f</span> as that first
+boolean, it does not invoke the thunks right away, but waits
+until the interposition procedure that it attaches to the
+chaperoned vector is called. Then it invokes them (and caches
+the result). This delays the construction of the projections
+until they are actually needed, avoiding the exponential blowup.</p><p class="SHistory">Added in version 6.90.0.27 of package <span class="stt">base</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Blame_Objects&quot;">8.7.1<tt>&nbsp;</tt><a name="(part._.Blame_.Objects)"></a>Blame Objects</h5><p>This section describes <a name="(tech._blame._object)"></a><span style="font-style: italic">blame objects</span> and operations on them.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/blame..rkt)._blame~3f))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">blame?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">This predicate recognizes <a href="Building_New_Contract_Combinators.html#%28tech._blame._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">blame objects</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/blame..rkt)._raise-blame-error))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._raise-blame-error%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-blame-error</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">b</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:missing-party</span><span class="hspace">&nbsp;</span><span class="RktVar">missing-party</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">fmt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v-fmt</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._none%2Fc%29%29" class="RktValLink" data-pltdoc="x">none/c</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">missing-party</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">fmt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">given</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">given:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">expected</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">expected:</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v-fmt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Signals a contract violation.  The first argument, <span class="RktVar">b</span>, records the
+current blame information, including positive and negative parties, the name of
+the contract, the name of the value, and the source location of the contract
+application. The <span class="RktPn">#:missing-party</span> argument supplies one of the blame
+parties. It should be non-<span class="RktVal">#f</span> when the <span class="RktVar">b</span> object was created
+without supplying a negative party. See <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-add-missing-party%29%29" class="RktValLink" data-pltdoc="x">blame-add-missing-party</a></span> and
+the description of the <span class="RktVar">late-neg-proj</span> argument of <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._make-contract%29%29" class="RktValLink" data-pltdoc="x">make-contract</a></span>.</div></p><p>The second positional argument, <span class="RktVar">v</span>, is the value that failed to
+satisfy the contract.</p><p>The remaining arguments are a format string,
+<span class="RktVar">fmt</span>, and its arguments, <span class="RktVar">v-fmt</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span>, specifying an error message
+specific to the precise violation.</p><p>If <span class="RktVar">fmt</span> is a list, then the elements are concatenated together
+(with spaces added, unless there are already spaces at the ends of the strings),
+after first replacing symbols with either their string counterparts, or
+replacing <span class="RktVal">'</span><span class="RktVal">given</span> with <span class="RktVal">"produced"</span> and
+<span class="RktVal">'</span><span class="RktVal">expected</span> with <span class="RktVal">"promised"</span>, depending on whether or not
+the <span class="RktVar">b</span> argument has been swapped or not (see <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-swap%29%29" class="RktValLink" data-pltdoc="x">blame-swap</a></span>).</p><p>If <span class="RktVar">fmt</span> contains the symbols <span class="RktVal">'</span><span class="RktVal">given:</span> or <span class="RktVal">'</span><span class="RktVal">expected:</span>,
+they are replaced like <span class="RktVal">'</span><span class="RktVal">given</span> and <span class="RktVal">'</span><span class="RktVal">expected</span> are, but
+the replacements are prefixed with the string <span class="RktVal">"\n<span class="hspace">&nbsp;&nbsp;</span>"</span> to conform
+to the error message guidelines in <a href="exns.html#%28part._err-msg-conventions%29" data-pltdoc="x">Error Message Conventions</a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/blame..rkt)._blame-add-context))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-add-context%29%29" class="RktValDef RktValLink" data-pltdoc="x">blame-add-context</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">blame</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">context</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:important</span><span class="hspace">&nbsp;</span><span class="RktVar">important</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:swap?</span><span class="hspace">&nbsp;</span><span class="RktVar">swap?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">blame</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">context</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">important</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">swap?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Adds some context information to blame error messages
+  that explicates which portion of the contract failed
+  (and that gets rendered by <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._raise-blame-error%29%29" class="RktValLink" data-pltdoc="x">raise-blame-error</a></span>).</div></p><p>The <span class="RktVar">context</span> argument describes one layer of the
+  portion of the contract, typically of the form <span class="RktVal">"the 1st argument of"</span>
+  (in the case of a function contract)
+  or <span class="RktVal">"a conjunct of"</span> (in the case of an <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span> contract).</p><p><div class="SIntrapara">For example, consider this contract violation:
+  </div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">f: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: #f</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">the 1st element of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(list/c (-&gt; integer? integer?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition f)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr></table></blockquote></div><div class="SIntrapara">It shows that the portion of the contract being violated is the first
+occurrence of <span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span>, because the <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span> and
+the <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span> combinators each internally called
+<span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-add-context%29%29" class="RktValLink" data-pltdoc="x">blame-add-context</a></span> to add the two lines following
+&ldquo;in&rdquo; in the error message.</div></p><p>The <span class="RktVar">important</span> argument is used to build the beginning part
+of the contract violation. The last <span class="RktVar">important</span> argument that
+gets added to a <a href="Building_New_Contract_Combinators.html#%28tech._blame._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">blame object</span></a> is used. The <span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._class%2Fc%29%29" class="RktStxLink" data-pltdoc="x">class/c</a></span> contract
+adds an important argument, as does the <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span> contract (when
+<span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span> knows the name of the function getting the contract).</p><p>The <span class="RktVar">swap?</span> argument has the effect of calling <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-swap%29%29" class="RktValLink" data-pltdoc="x">blame-swap</a></span>
+while adding the layer of context, but without creating an extra
+<a href="Building_New_Contract_Combinators.html#%28tech._blame._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">blame object</span></a>.</p><p>Passing <span class="RktVal">#f</span> as the context string argument is no longer relevant.
+For backwards compatibility, <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-add-context%29%29" class="RktValLink" data-pltdoc="x">blame-add-context</a></span> returns <span class="RktSym">b</span>
+when <span class="RktVar">context</span> is <span class="RktVal">#f</span>.</p><p class="SHistory">Changed in version 6.90.0.29 of package <span class="stt">base</span>: The <span class="RktVar">context</span> argument being
+<span class="RktVal">#f</span> is no longer relevant.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/blame..rkt)._blame-context))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-context%29%29" class="RktValDef RktValLink" data-pltdoc="x">blame-context</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">blame</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">blame</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the context information that would be supplied in
+an error message, if <span class="RktVar">blame</span> is passed to <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._raise-blame-error%29%29" class="RktValLink" data-pltdoc="x">raise-blame-error</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/blame..rkt)._blame-positive))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-positive%29%29" class="RktValDef RktValLink" data-pltdoc="x">blame-positive</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/blame..rkt)._blame-negative))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-negative%29%29" class="RktValDef RktValLink" data-pltdoc="x">blame-negative</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">These functions produce printable descriptions of the current positive and
+negative parties of a <a href="Building_New_Contract_Combinators.html#%28tech._blame._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">blame object</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/blame..rkt)._blame-contract))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-contract%29%29" class="RktValDef RktValLink" data-pltdoc="x">blame-contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">This function produces a description of the contract associated with a blame
+object (the result of <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-name%29%29" class="RktValLink" data-pltdoc="x">contract-name</a></span>).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/blame..rkt)._blame-value))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">blame-value</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">This function produces the name of the value to which the contract was applied,
+or <span class="RktVal">#f</span> if no name was provided.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/blame..rkt)._blame-source))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-source%29%29" class="RktValDef RktValLink" data-pltdoc="x">blame-source</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._srcloc~3f%29%29" class="RktValLink" data-pltdoc="x">srcloc?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">This function produces the source location associated with a contract.  If no
+source location was provided, all fields of the structure will contain
+<span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/blame..rkt)._blame-swap))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-swap%29%29" class="RktValDef RktValLink" data-pltdoc="x">blame-swap</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">This function swaps the positive and negative parties of a <a href="Building_New_Contract_Combinators.html#%28tech._blame._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">blame object</span></a>.
+(See also <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-add-context%29%29" class="RktValLink" data-pltdoc="x">blame-add-context</a></span>.)</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/blame..rkt)._blame-original~3f))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-original~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">blame-original?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/blame..rkt)._blame-swapped~3f))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-swapped~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">blame-swapped?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">These functions report whether the current blame of a given <a href="Building_New_Contract_Combinators.html#%28tech._blame._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">blame object</span></a> is the
+same as in the original contract invocation (possibly of a compound contract
+containing the current one), or swapped, respectively.  Each is the negation of
+the other; both are provided for convenience and clarity.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/blame..rkt)._blame-replace-negative))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-replace-negative%29%29" class="RktValDef RktValLink" data-pltdoc="x">blame-replace-negative</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktVar">neg</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">neg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span> object just like <span class="RktVar">b</span> except
+           that it uses <span class="RktVar">neg</span> instead of the negative
+           position <span class="RktVar">b</span> has.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/blame..rkt)._blame-replaced-negative~3f))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-replaced-negative~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">blame-replaced-negative?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">b</span> is the result of calling
+<span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-replace-negative%29%29" class="RktValLink" data-pltdoc="x">blame-replace-negative</a></span> (or the result of some other function
+whose input was the result of <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-replace-negative%29%29" class="RktValLink" data-pltdoc="x">blame-replace-negative</a></span>).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/blame..rkt)._blame-update))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-update%29%29" class="RktValDef RktValLink" data-pltdoc="x">blame-update</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span><span class="RktVar">neg</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">neg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span> object just like <span class="RktVar">b</span> except
+           that it adds <span class="RktVar">pos</span> and <span class="RktVar">neg</span> to the positive
+           and negative parties of <span class="RktVar">b</span> respectively.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/blame..rkt)._blame-missing-party~3f))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-missing-party~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">blame-missing-party?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> when <span class="RktVar">b</span> does not have both parties.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/blame..rkt)._blame-add-missing-party))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-add-missing-party%29%29" class="RktValDef RktValLink" data-pltdoc="x">blame-add-missing-party</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktVar">missing-party</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-missing-party~3f%29%29" class="RktValLink" data-pltdoc="x">blame-missing-party?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-missing-party~3f%29%29" class="RktValLink" data-pltdoc="x">blame-missing-party?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">missing-party</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a new <a href="Building_New_Contract_Combinators.html#%28tech._blame._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">blame object</span></a> like <span class="RktVar">b</span>, except that the missing
+party is replaced with <span class="RktVar">missing-party</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/contract/private/blame..rkt)._exn~3afail~3acontract~3ablame-object))"></a><a name="(def._((lib._racket/contract/private/blame..rkt)._make-exn~3afail~3acontract~3ablame))"></a><a name="(def._((lib._racket/contract/private/blame..rkt)._exn~3afail~3acontract~3ablame~3f))"></a><a name="(def._((lib._racket/contract/private/blame..rkt)._struct~3aexn~3afail~3acontract~3ablame))"></a><a name="(def._((lib._racket/contract/private/blame..rkt)._exn~3afail~3acontract~3ablame))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._exn~3afail~3acontract~3ablame%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:contract:blame</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">object</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._make-exn~3afail~3acontract~3ablame%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:contract:blame</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">object</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">This exception is raised to signal a contract error. The <span class="RktSym">object</span>
+field contains a <a href="Building_New_Contract_Combinators.html#%28tech._blame._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">blame object</span></a> associated with a contract violation.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/blame..rkt)._current-blame-format))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._current-blame-format%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-blame-format</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._current-blame-format%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-blame-format</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that is used when constructing a
+contract violation error. Its value is procedure that
+accepts three arguments:
+</div><div class="SIntrapara"><ul><li><p>the <a href="Building_New_Contract_Combinators.html#%28tech._blame._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">blame object</span></a> for the violation,</p></li><li><p>the value that the contract applies to, and</p></li><li><p>a message indicating the kind of violation.</p></li></ul></div><div class="SIntrapara">The procedure then
+returns a string that is put into the contract error
+message. Note that the value is often already included in
+the message that indicates the violation.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show-blame-error</span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="hspace">&nbsp;</span><span class="RktSym">value</span><span class="hspace">&nbsp;</span><span class="RktSym">message</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append%29%29" class="RktValLink" data-pltdoc="x">string-append</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"Contract Violation!\n"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Guilty Party: ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-positive%29%29" class="RktValLink" data-pltdoc="x">blame-positive</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Innocent Party: ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-negative%29%29" class="RktValLink" data-pltdoc="x">blame-negative</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Contracted Value Name: ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-value%29%29" class="RktValLink" data-pltdoc="x">blame-value</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Contract Location: ~s\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-source%29%29" class="RktValLink" data-pltdoc="x">blame-source</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Contract Name: ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-contract%29%29" class="RktValLink" data-pltdoc="x">blame-contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Offending Value: ~s\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">value</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Offense: ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">message</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._current-blame-format%29%29" class="RktValLink" data-pltdoc="x">current-blame-format</a></span><span class="hspace">&nbsp;</span><span class="RktSym">show-blame-error</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2F%29%29" class="RktValLink" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">Contract Violation!</span></p></td></tr><tr><td><p><span class="RktErr">Guilty Party: (function f)</span></p></td></tr><tr><td><p><span class="RktErr">Innocent Party: top-level</span></p></td></tr><tr><td><p><span class="RktErr">Contracted Value Name: f</span></p></td></tr><tr><td><p><span class="RktErr">Contract Location: #(struct:srcloc eval 4 0 4 1)</span></p></td></tr><tr><td><p><span class="RktErr">Contract Name: (-&gt; integer? integer?)</span></p></td></tr><tr><td><p><span class="RktErr">Offending Value: 1/2</span></p></td></tr><tr><td><p><span class="RktErr">Offense: promised: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: 1/2</span></p></td></tr><tr><td><blockquote class="SubFlow"></blockquote></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1/2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">Contract Violation!</span></p></td></tr><tr><td><p><span class="RktErr">Guilty Party: top-level</span></p></td></tr><tr><td><p><span class="RktErr">Innocent Party: (function f)</span></p></td></tr><tr><td><p><span class="RktErr">Contracted Value Name: f</span></p></td></tr><tr><td><p><span class="RktErr">Contract Location: #(struct:srcloc eval 4 0 4 1)</span></p></td></tr><tr><td><p><span class="RktErr">Contract Name: (-&gt; integer? integer?)</span></p></td></tr><tr><td><p><span class="RktErr">Offending Value: 1/2</span></p></td></tr><tr><td><p><span class="RktErr">Offense: expected: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 1/2</span></p></td></tr><tr><td><blockquote class="SubFlow"></blockquote></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Contracts_as_structs&quot;">8.7.2<tt>&nbsp;</tt><a name="(part._.Contracts_as_structs)"></a>Contracts as structs</h5><p>The property <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3acontract%29%29" class="RktValLink" data-pltdoc="x">prop:contract</a></span> allows arbitrary structures to act as
+contracts.  The property <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3achaperone-contract%29%29" class="RktValLink" data-pltdoc="x">prop:chaperone-contract</a></span> allows arbitrary
+structures to act as <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contracts</span></a>; <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3achaperone-contract%29%29" class="RktValLink" data-pltdoc="x">prop:chaperone-contract</a></span>
+inherits <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3acontract%29%29" class="RktValLink" data-pltdoc="x">prop:contract</a></span>, so <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contract</span></a> structures may also act
+as general contracts.  The property <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3aflat-contract%29%29" class="RktValLink" data-pltdoc="x">prop:flat-contract</a></span> allows arbitrary structures
+to act as <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a>; <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3aflat-contract%29%29" class="RktValLink" data-pltdoc="x">prop:flat-contract</a></span> inherits both
+<span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3achaperone-contract%29%29" class="RktValLink" data-pltdoc="x">prop:chaperone-contract</a></span> and <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="RktValLink" data-pltdoc="x">prop:procedure</a></span>, so <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> structures
+may also act as <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contracts</span></a>, as general contracts, and as predicate procedures.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/contract/private/prop..rkt)._prop~3acontract))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3acontract%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:contract</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/contract/private/prop..rkt)._prop~3achaperone-contract))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3achaperone-contract%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:chaperone-contract</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/contract/private/prop..rkt)._prop~3aflat-contract))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3aflat-contract%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:flat-contract</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">These properties declare structures to be contracts or <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a>,
+respectively.  The value for <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3acontract%29%29" class="RktValLink" data-pltdoc="x">prop:contract</a></span> must be a <a href="Building_New_Contract_Combinators.html#%28tech._contract._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">contract
+property</span></a> constructed by <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._build-contract-property%29%29" class="RktValLink" data-pltdoc="x">build-contract-property</a></span>; likewise, the value
+for <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3achaperone-contract%29%29" class="RktValLink" data-pltdoc="x">prop:chaperone-contract</a></span> must be a <a href="Building_New_Contract_Combinators.html#%28tech._chaperone._contract._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contract property</span></a>
+constructed by <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._build-chaperone-contract-property%29%29" class="RktValLink" data-pltdoc="x">build-chaperone-contract-property</a></span> and the value
+for <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3aflat-contract%29%29" class="RktValLink" data-pltdoc="x">prop:flat-contract</a></span> must be a <a href="Building_New_Contract_Combinators.html#%28tech._flat._contract._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract property</span></a>
+constructed by <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._build-flat-contract-property%29%29" class="RktValLink" data-pltdoc="x">build-flat-contract-property</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/contract/private/guts..rkt)._prop~3acontracted))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._prop~3acontracted%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:contracted</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/contract/private/guts..rkt)._impersonator-prop~3acontracted))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._impersonator-prop~3acontracted%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonator-prop:contracted</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">These properties attach a contract value to the protected structure,
+chaperone, or impersonator value.  The function <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._has-contract~3f%29%29" class="RktValLink" data-pltdoc="x">has-contract?</a></span>
+returns <span class="RktVal">#t</span> for values that have one of these properties, and
+<span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._value-contract%29%29" class="RktValLink" data-pltdoc="x">value-contract</a></span> extracts the value from the property (which
+is expected to be the contract on the value).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/contract/private/guts..rkt)._prop~3ablame))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._prop~3ablame%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:blame</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/contract/private/guts..rkt)._impersonator-prop~3ablame))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._impersonator-prop~3ablame%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonator-prop:blame</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">These properties attach a blame information to the protected structure,
+chaperone, or impersonator value.  The function <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._has-blame~3f%29%29" class="RktValLink" data-pltdoc="x">has-blame?</a></span>
+returns <span class="RktVal">#t</span> for values that have one of these properties, and
+<span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._value-blame%29%29" class="RktValLink" data-pltdoc="x">value-blame</a></span> extracts the value from the property.</div></p><p>The value is expected to be the blame record for the contract on the value or
+a <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span>-pair of a blame record with a missing party and the missing
+party. The <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._value-blame%29%29" class="RktValLink" data-pltdoc="x">value-blame</a></span> function reassembles the arguments of the pair
+into a complete blame record using <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-add-missing-party%29%29" class="RktValLink" data-pltdoc="x">blame-add-missing-party</a></span>. If
+the value has one of the properties, but the value is not a <a href="Building_New_Contract_Combinators.html#%28tech._blame._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">blame object</span></a>
+or a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> position is a <a href="Building_New_Contract_Combinators.html#%28tech._blame._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">blame object</span></a>, then <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._has-blame~3f%29%29" class="RktValLink" data-pltdoc="x">has-blame?</a></span>
+returns <span class="RktVal">#f</span> but <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._value-blame%29%29" class="RktValLink" data-pltdoc="x">value-blame</a></span> returns <span class="RktVal">#f</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top" colspan="3"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/combinator..rkt)._build-flat-contract-property))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._build-flat-contract-property%29%29" class="RktValDef RktValLink" data-pltdoc="x">build-flat-contract-property</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:name</span><span class="hspace">&nbsp;</span><span class="RktVar">get-name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:first-order</span><span class="hspace">&nbsp;</span><span class="RktVar">get-first-order</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:late-neg-projection</span><span class="hspace">&nbsp;</span><span class="RktVar">late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:collapsible-late-neg-projection</span><span class="hspace">&nbsp;</span><span class="RktVar">collapsible-late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:val-first-projection</span><span class="hspace">&nbsp;</span><span class="RktVar">val-first-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:projection</span><span class="hspace">&nbsp;</span><span class="RktVar">get-projection</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:stronger</span><span class="hspace">&nbsp;</span><span class="RktVar">stronger</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:equivalent</span><span class="hspace">&nbsp;</span><span class="RktVar">equivalent</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:generate</span><span class="hspace">&nbsp;</span><span class="RktVar">generate</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:list-contract?</span><span class="hspace">&nbsp;</span><span class="RktVar">is-list-contract?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._flat-contract-property~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract-property?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">get-name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">anonymous-flat-contract</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">get-first-order</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">collapsible-late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract~3f%29%29" class="RktValLink" data-pltdoc="x">collapsible-contract?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">val-first-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">get-projection</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVar">get-first-order</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">x</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._raise-blame-error%29%29" class="RktValLink" data-pltdoc="x">raise-blame-error</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">expected:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~a"</span><span class="hspace">&nbsp;</span><span class="RktVal">given:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~e"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">get-name</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stronger</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">equivalent</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">generate</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">generator</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-fail~3f%29%29" class="RktValLink" data-pltdoc="x">contract-random-generate-fail?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fuel</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">is-list-contract?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top" colspan="3"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/combinator..rkt)._build-chaperone-contract-property))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._build-chaperone-contract-property%29%29" class="RktValDef RktValLink" data-pltdoc="x">build-chaperone-contract-property</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:name</span><span class="hspace">&nbsp;</span><span class="RktVar">get-name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:first-order</span><span class="hspace">&nbsp;</span><span class="RktVar">get-first-order</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:late-neg-projection</span><span class="hspace">&nbsp;</span><span class="RktVar">late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:collapsible-late-neg-projection</span><span class="hspace">&nbsp;</span><span class="RktVar">collapsible-late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:val-first-projection</span><span class="hspace">&nbsp;</span><span class="RktVar">val-first-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:projection</span><span class="hspace">&nbsp;</span><span class="RktVar">get-projection</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:stronger</span><span class="hspace">&nbsp;</span><span class="RktVar">stronger</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:equivalent</span><span class="hspace">&nbsp;</span><span class="RktVar">equivalent</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:generate</span><span class="hspace">&nbsp;</span><span class="RktVar">generate</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:exercise</span><span class="hspace">&nbsp;</span><span class="RktVar">exercise</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:list-contract?</span><span class="hspace">&nbsp;</span><span class="RktVar">is-list-contract?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._chaperone-contract-property~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-contract-property?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">get-name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">anonymous-chaperone-contract</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">get-first-order</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">collapsible-late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract~3f%29%29" class="RktValLink" data-pltdoc="x">collapsible-contract?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">val-first-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">get-projection</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVar">get-first-order</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">x</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._raise-blame-error%29%29" class="RktValLink" data-pltdoc="x">raise-blame-error</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">expected:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~a"</span><span class="hspace">&nbsp;</span><span class="RktVal">given:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~e"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">get-name</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stronger</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">equivalent</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">generate</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">generator</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-fail~3f%29%29" class="RktValLink" data-pltdoc="x">contract-random-generate-fail?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fuel</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">exercise</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fuel</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">is-list-contract?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top" colspan="3"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/prop..rkt)._build-contract-property))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._build-contract-property%29%29" class="RktValDef RktValLink" data-pltdoc="x">build-contract-property</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:name</span><span class="hspace">&nbsp;</span><span class="RktVar">get-name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:first-order</span><span class="hspace">&nbsp;</span><span class="RktVar">get-first-order</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:late-neg-projection</span><span class="hspace">&nbsp;</span><span class="RktVar">late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:collapsible-late-neg-projection</span><span class="hspace">&nbsp;</span><span class="RktVar">collapsible-late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:val-first-projection</span><span class="hspace">&nbsp;</span><span class="RktVar">val-first-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:projection</span><span class="hspace">&nbsp;</span><span class="RktVar">get-projection</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:stronger</span><span class="hspace">&nbsp;</span><span class="RktVar">stronger</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:equivalent</span><span class="hspace">&nbsp;</span><span class="RktVar">equivalent</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:generate</span><span class="hspace">&nbsp;</span><span class="RktVar">generate</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:exercise</span><span class="hspace">&nbsp;</span><span class="RktVar">exercise</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:list-contract?</span><span class="hspace">&nbsp;</span><span class="RktVar">is-list-contract?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._contract-property~3f%29%29" class="RktValLink" data-pltdoc="x">contract-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">get-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">anonymous-contract</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">get-first-order</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">collapsible-late-neg-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract~3f%29%29" class="RktValLink" data-pltdoc="x">collapsible-contract?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">val-first-proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">get-projection</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVar">get-first-order</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">x</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._raise-blame-error%29%29" class="RktValLink" data-pltdoc="x">raise-blame-error</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">expected:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~a"</span><span class="hspace">&nbsp;</span><span class="RktVal">given:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~e"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">get-name</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stronger</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">equivalent</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">generate</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">generator</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-fail~3f%29%29" class="RktValLink" data-pltdoc="x">contract-random-generate-fail?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fuel</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">exercise</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fuel</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">is-list-contract?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">These functions build the arguments for <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3acontract%29%29" class="RktValLink" data-pltdoc="x">prop:contract</a></span>,
+<span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3achaperone-contract%29%29" class="RktValLink" data-pltdoc="x">prop:chaperone-contract</a></span>, and <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3aflat-contract%29%29" class="RktValLink" data-pltdoc="x">prop:flat-contract</a></span>, respectively.</div></p><p><div class="SIntrapara">A <a name="(tech._contract._property)"></a><span style="font-style: italic">contract property</span> specifies the behavior of a structure when used as
+a contract.  It is specified in terms of seven properties:
+</div><div class="SIntrapara"><ul><li><p><span class="RktVar">get-name</span> which produces a description to <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> as part
+of a contract violation;</p></li><li><p><span class="RktVar">get-first-order</span>, which produces a first-order predicate to be
+used by <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-first-order-passes~3f%29%29" class="RktValLink" data-pltdoc="x">contract-first-order-passes?</a></span>;</p></li><li><p><span class="RktVar">late-neg-proj</span>, which produces a blame-tracking projection
+defining the behavior of the contract (The <span class="RktVar">get-projection</span>
+and <span class="RktVar">val-first-proj</span> arguments also specify the projection,
+but using a different signature. They are here for backwards compatibility.);</p></li><li><p><span class="RktVar">collapsible-late-neg-proj</span>, similar to <span class="RktVar">late-neg-proj</span>
+which produces a blame-tracking projection defining the behavior of the
+contract, this function additionally specifies the
+<a href="collapsible.html#%28tech._collapsible._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">collapsible</span></a> behavior of the contract;</p></li><li><p><span class="RktVar">stronger</span>, a predicate that determines whether this
+contract (passed in the first argument) is stronger than some other
+contract (passed in the second argument) and whose default always
+returns <span class="RktVal">#f</span>;</p></li><li><p><span class="RktVar">equivalent</span>, a predicate that determines whether this
+contract (passed in the first argument) is equivalent to some other
+contract (passed in the second argument); the default for flat
+and chaperone contracts is <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> and for impersonator contracts
+returns <span class="RktVal">#f</span>;</p></li><li><p><span class="RktVar">generate</span>, which returns a thunk that generates random values
+matching the contract (using <span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-fail%29%29" class="RktValLink" data-pltdoc="x">contract-random-generate-fail</a></span>)
+to indicate failure) or <span class="RktVal">#f</span> to indicate that random
+generation for this contract isn&rsquo;t supported;</p></li><li><p><span class="RktVar">exercise</span>, which returns a function that exercises values
+matching the contract (e.g., if it is a function contract, it may call
+the function) and a list of contracts whose values will be generated
+by this process;</p></li><li><p>and <span class="RktVar">is-list-contract?</span>, which is used by <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span>
+to determine if this contract accepts only <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span>s.</p></li></ul></div></p><p>At least one of the <span class="RktVar">late-neg-proj</span>, <span class="RktVar">collapsible-late-neg-proj</span>,
+<span class="RktVar">get-projection</span>, <span class="RktVar">val-first-proj</span>, or <span class="RktVar">get-first-order</span>
+must be non-<span class="RktVal">#f</span>.</p><p>These accessors are passed as (optional) keyword arguments to
+<span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._build-contract-property%29%29" class="RktValLink" data-pltdoc="x">build-contract-property</a></span>, and are applied to instances of the
+appropriate structure type by the contract system.  Their results are used
+analogously to the arguments of <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._make-contract%29%29" class="RktValLink" data-pltdoc="x">make-contract</a></span>.</p><p>A <a name="(tech._chaperone._contract._property)"></a><span style="font-style: italic">chaperone contract property</span> specifies the behavior of a structure
+when used as a chaperone contract.  It is specified using
+<span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._build-chaperone-contract-property%29%29" class="RktValLink" data-pltdoc="x">build-chaperone-contract-property</a></span>, and accepts exactly the same set of
+arguments as <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._build-contract-property%29%29" class="RktValLink" data-pltdoc="x">build-contract-property</a></span>.  The only difference is that the
+projection accessor must return a value that passes <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-of~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-of?</a></span> when
+compared with the original, uncontracted value.</p><p><div class="SIntrapara">A <a name="(tech._flat._contract._property)"></a><span style="font-style: italic">flat contract property</span> specifies the behavior of a structure when
+used as a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>.  It is specified using
+<span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._build-flat-contract-property%29%29" class="RktValLink" data-pltdoc="x">build-flat-contract-property</a></span>, and accepts similar
+arguments as <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._build-contract-property%29%29" class="RktValLink" data-pltdoc="x">build-contract-property</a></span>.  The differences are:
+</div><div class="SIntrapara"><ul><li><p>the projection accessor is expected not to wrap its argument in a
+higher-order fashion, analogous to the constraint on projections in
+<span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._make-flat-contract%29%29" class="RktValLink" data-pltdoc="x">make-flat-contract</a></span>;</p></li><li><p>the <span class="RktPn">#:exercise</span> keyword argument is omitted because it is not
+relevant for flat contracts.</p></li></ul></div></p><p class="SHistory">Changed in version 6.0.1.13 of package <span class="stt">base</span>: Added the <span class="RktPn">#:list-contract?</span> argument.<br/>Changed in version 6.1.1.4: Allow <span class="RktVar">generate</span> to return <span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-fail%29%29" class="RktValLink" data-pltdoc="x">contract-random-generate-fail</a></span>.<br/>Changed in version 6.90.0.30: Added the <span class="RktPn">#:equivalent</span> argument.<br/>Changed in version 7.1.0.10: Added the <span class="RktPn">#:collapsible-late-neg-projection</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/prop..rkt)._contract-property~3f))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._contract-property~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">contract-property?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/prop..rkt)._chaperone-contract-property~3f))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._chaperone-contract-property~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">chaperone-contract-property?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/prop..rkt)._flat-contract-property~3f))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._flat-contract-property~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">flat-contract-property?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">These predicates detect whether a value is a <a href="Building_New_Contract_Combinators.html#%28tech._contract._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">contract property</span></a>,
+<a href="Building_New_Contract_Combinators.html#%28tech._chaperone._contract._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contract property</span></a>, or a
+<a href="Building_New_Contract_Combinators.html#%28tech._flat._contract._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract property</span></a>, respectively.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Obligation_Information_in_Check_Syntax&quot;">8.7.3<tt>&nbsp;</tt><a name="(part._.Obligation_.Information_in_.Check_.Syntax)"></a>Obligation Information in Check Syntax</h5><p><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?tag=%28part._%28.%27%28lib._scribblings%2Fdrracket%2Fdrracket..scrbl%29.%27._.%27buttons.%27%29%29&amp;version=8.6" class="Sq" data-pltdoc="x">Check Syntax</a> in DrRacket shows obligation information for
+contracts according to <span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property%29%29" class="RktValLink" data-pltdoc="x">syntax-property</a></span>s that the contract combinators
+leave in the expanded form of the program. These properties indicate
+where contracts appear in the source and where the positive and negative
+positions of the contracts appear.</p><p>To make Check Syntax show obligation information for your new contract
+combinators, use the following properties (some helper macros and functions
+are below):</p><ul><li><p><div class="SIntrapara"><a name="(idx._(gentag._197._(lib._scribblings/reference/reference..scrbl)))"></a>
+</div><div class="SIntrapara"><span class="RktVal">'</span><span class="RktVal">racket/contract:contract</span><span class="hspace">&nbsp;</span><span class="RktSym">:</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector%2Fc%29%29" class="RktValLink" data-pltdoc="x">vector/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></div><div class="SIntrapara">This property should be attached to the result of a transformer
+               that implements a contract combinator. It signals to Check Syntax
+               that this is where a contract begins.</div></p><p>The first element in the
+               vector should be a unique (in the sense of <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>) value
+               that Check Syntax can use a tag to match up this contract with
+               its subpieces (specified by the two following syntax properties).</p><p>The second and third elements of the vector are syntax objects
+               from pieces of the contract, and Check Syntax will color them.
+               The first list should contain subparts that are the responsibility
+               of parties (typically modules) that provide implementations of the contract.
+               The second list should contain subparts that are the
+               responsibility of clients.</p><p>For example, in <span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">#:pre</span><span class="stt"> </span><span class="RktVal">#t</span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktPn">#:post</span><span class="stt"> </span><span class="RktVal">#t</span><span class="RktPn">)</span>,
+               the <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span> and the <span class="RktPn">#:post</span> should be in the first
+               list and <span class="RktPn">#:pre</span> in the second list.</p></li><li><p><div class="SIntrapara"><a name="(idx._(gentag._198._(lib._scribblings/reference/reference..scrbl)))"></a>
+</div><div class="SIntrapara"><span class="RktVal">'</span><span class="RktVal">racket/contract:negative-position</span><span class="hspace">&nbsp;</span><span class="RktSym">:</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></div><div class="SIntrapara">This property should be attached to sub-expressions of
+ a contract combinator that are expected to be other contracts.
+ The value of the property should be the key (the first element from
+ the vector for the <span class="RktVal">'</span><span class="RktVal">racket/contract:contract</span> property)
+ indicating which contract this is.</div></p><p>This property should be used when the expression&rsquo;s value is a contract
+ that clients are responsible for. </p></li><li><p><div class="SIntrapara"><a name="(idx._(gentag._199._(lib._scribblings/reference/reference..scrbl)))"></a>
+</div><div class="SIntrapara"><span class="RktVal">'</span><span class="RktVal">racket/contract:positive-position</span><span class="hspace">&nbsp;</span><span class="RktSym">:</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></div><div class="SIntrapara">This form is just like <span class="RktVal">'</span><span class="RktVal">racket/contract:negative-position</span>,
+ except that it should be used when the expression&rsquo;s value is
+ a contract that the original party should be responsible for.</div></p></li><li><p><div class="SIntrapara"><a name="(idx._(gentag._200._(lib._scribblings/reference/reference..scrbl)))"></a>
+</div><div class="SIntrapara"><span class="RktVal">'</span><span class="RktVal">racket/contract:contract-on-boundary</span><span class="hspace">&nbsp;</span><span class="RktSym">:</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></div><div class="SIntrapara">The presence of this property tells Check Syntax that it
+ should start coloring from this point. It expects the expression
+ to be a contract
+ (and, thus, to have the <span class="RktVal">'</span><span class="RktVal">racket/contract:contract</span> property);
+ this property indicates that this contract is on a (module) boundary.</div></p><p>(The value of the property is not used.)</p></li><li><p><div class="SIntrapara"><a name="(idx._(gentag._201._(lib._scribblings/reference/reference..scrbl)))"></a>
+</div><div class="SIntrapara"><span class="RktVal">'</span><span class="RktVal">racket/contract:internal-contract</span><span class="hspace">&nbsp;</span><span class="RktSym">:</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></div><div class="SIntrapara">Like <span class="RktVal">'</span><span class="RktVal">racket/contract:contract-on-boundary</span>, the presence
+ of this property triggers coloring, but this is meant for use
+ when the party (module) containing the contract (regardless of whether
+ or not this module exports anything matching the contract)
+ can be blamed for violating the contract. This comes into play
+ for <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span> contracts, since the contract itself has
+ access to values under contract via the dependency.</div></p></li></ul><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/private/guts..rkt)._define/final-prop))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._define%2Ffinal-prop%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/final-prop</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">header</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">header</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">main-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">main-id</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">main-id</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">id</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">header</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>, except that uses of
+            <span class="RktVar">main-id</span> in the header are annotated
+            with the <span class="RktVal">'</span><span class="RktVal">racket/contract:contract</span> property
+            (as above).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/private/guts..rkt)._define/subexpression-pos-prop))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._define%2Fsubexpression-pos-prop%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/subexpression-pos-prop</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">header</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">header</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">main-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">main-id</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">main-id</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">id</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">header</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>, except that uses of
+            <span class="RktVar">main-id</span> in the header are annotated
+            with the <span class="RktVal">'</span><span class="RktVal">racket/contract:contract</span> property
+            (as above) and arguments are annotated with the
+            <span class="RktVal">'</span><span class="RktVal">racket/contract:positive-position</span> property.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Utilities_for_Building_New_Combinators&quot;">8.7.4<tt>&nbsp;</tt><a name="(part._.Utilities_for_.Building_.New_.Combinators)"></a>Utilities for Building New Combinators</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._contract-stronger~3f))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-stronger~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">contract-stronger?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c1</span><span class="hspace">&nbsp;</span><span class="RktVar">c2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if the contract <span class="RktVar">c1</span> accepts either fewer
+  or the same set of values that <span class="RktVar">c2</span> does.</div></p><p><a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">Chaperone contracts</span></a> and <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a> that are the same
+  (i.e., where <span class="RktVar">c1</span> is <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to <span class="RktVar">c2</span>) are
+  considered to always be stronger than each other.</p><p>This function is conservative, so it may return <span class="RktVal">#f</span> when
+  <span class="RktVar">c1</span> does, in fact, accept fewer values.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-stronger~3f%29%29" class="RktValLink" data-pltdoc="x">contract-stronger?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-stronger~3f%29%29" class="RktValLink" data-pltdoc="x">contract-stronger?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._between%2Fc%29%29" class="RktValLink" data-pltdoc="x">between/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">25</span><span class="hspace">&nbsp;</span><span class="RktVal">75</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._between%2Fc%29%29" class="RktValLink" data-pltdoc="x">between/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-stronger~3f%29%29" class="RktValLink" data-pltdoc="x">contract-stronger?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._between%2Fc%29%29" class="RktValLink" data-pltdoc="x">between/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._between%2Fc%29%29" class="RktValLink" data-pltdoc="x">between/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">25</span><span class="hspace">&nbsp;</span><span class="RktVal">75</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-stronger~3f%29%29" class="RktValLink" data-pltdoc="x">contract-stronger?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._between%2Fc%29%29" class="RktValLink" data-pltdoc="x">between/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span>0</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._between%2Fc%29%29" class="RktValLink" data-pltdoc="x">between/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-stronger~3f%29%29" class="RktValLink" data-pltdoc="x">contract-stronger?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c~3d%29%29" class="RktValLink" data-pltdoc="x">&lt;=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c~3d%29%29" class="RktValLink" data-pltdoc="x">&lt;=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._contract-equivalent~3f))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-equivalent~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">contract-equivalent?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c1</span><span class="hspace">&nbsp;</span><span class="RktVar">c2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if the contract <span class="RktVar">c1</span> accepts the same
+  set of values that <span class="RktVar">c2</span> does.</div></p><p><a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">Chaperone contracts</span></a> and <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a> that are the same
+  (i.e., where <span class="RktVar">c1</span> is <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to <span class="RktVar">c2</span>) are
+  considered to always be equivalent to each other.</p><p>This function is conservative, so it may return <span class="RktVal">#f</span> when
+  <span class="RktVar">c1</span> does, in fact, accept the same set of values that <span class="RktVar">c2</span> does.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-equivalent~3f%29%29" class="RktValLink" data-pltdoc="x">contract-equivalent?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-equivalent~3f%29%29" class="RktValLink" data-pltdoc="x">contract-equivalent?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._non-empty-listof%29%29" class="RktValLink" data-pltdoc="x">non-empty-listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-equivalent~3f%29%29" class="RktValLink" data-pltdoc="x">contract-equivalent?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e~3d%29%29" class="RktValLink" data-pltdoc="x">&gt;=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._sqr%29%29" class="RktValLink" data-pltdoc="x">sqr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.90.0.30 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._contract-first-order-passes~3f))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-first-order-passes~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">contract-first-order-passes?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">contract</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">contract</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a boolean indicating whether the first-order tests
+of <span class="RktVar">contract</span> pass for <span class="RktVar">v</span>.</div></p><p>If it returns <span class="RktVal">#f</span>, the contract is guaranteed not to
+hold for that value; if it returns <span class="RktVal">#t</span>, the contract
+may or may not hold. If the contract is a first-order
+contract, a result of <span class="RktVal">#t</span> guarantees that the
+contract holds.</p><p>See also <span class="RktSym">contract-first-order-okay-to-give-up?</span> and
+<span class="RktSym">contract-first-order-try-less-hard</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._contract-first-order))"></a><span title="Provided from: racket/contract/combinator, racket/contract, racket | Package: base"><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-first-order%29%29" class="RktValDef RktValLink" data-pltdoc="x">contract-first-order</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces the first-order test used by <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span> to match values to
+higher-order contracts.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="attaching-contracts-to-values.html" title="backward to &quot;8.6 Attaching Contracts to Values&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contract-utilities.html" title="forward to &quot;8.8 Contract Utilities&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Byte_and_String_Input.html b/clones/docs.racket-lang.org/reference/Byte_and_String_Input.html
new file mode 100644
index 00000000..8638c093
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Byte_and_String_Input.html
@@ -0,0 +1,180 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.2&nbsp;Byte and String Input</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewselflink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>char</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-byte%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>byte</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>line</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-line%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>bytes-<wbr></wbr>line</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>string</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>string!</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>bytes!</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>bytes-<wbr></wbr>avail!</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%2A%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>bytes-<wbr></wbr>avail!*</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%2Fenable-break%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>bytes-<wbr></wbr>avail!/<span class="mywbr"> &nbsp;</span>enable-<wbr></wbr>break</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-string%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-<wbr></wbr>string</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-string%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-<wbr></wbr>string!</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-<wbr></wbr>bytes!</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes-avail%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-<wbr></wbr>bytes-<wbr></wbr>avail!</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes-avail%21%2A%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-<wbr></wbr>bytes-<wbr></wbr>avail!*</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes-avail%21%2Fenable-break%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-<wbr></wbr>bytes-<wbr></wbr>avail!/<span class="mywbr"> &nbsp;</span>enable-<wbr></wbr>break</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char-or-special%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>char-<wbr></wbr>or-<wbr></wbr>special</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-byte-or-special%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>byte-<wbr></wbr>or-<wbr></wbr>special</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-char%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-<wbr></wbr>char</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-byte%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-<wbr></wbr>byte</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-char-or-special%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-<wbr></wbr>char-<wbr></wbr>or-<wbr></wbr>special</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-byte-or-special%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-<wbr></wbr>byte-<wbr></wbr>or-<wbr></wbr>special</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-progress-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>progress-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-provides-progress-evts~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>provides-<wbr></wbr>progress-<wbr></wbr>evts?</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-commit-peeked%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>commit-<wbr></wbr>peeked</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._byte-ready~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">byte-<wbr></wbr>ready?</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._char-ready~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>ready?</span></span></a></td></tr><tr><td><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._progress-evt~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">progress-<wbr></wbr>evt?</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="port-lib.html" title="backward to &quot;13.1.10 More Port Constructors, Procedures, and Events&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Byte_and_String_Output.html" title="forward to &quot;13.3 Byte and String Output&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Byte_and_String_Input&quot;">13.2<tt>&nbsp;</tt><a name="(part._.Byte_and_.String_.Input)"></a>Byte and String Input</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-char))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-char</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Reads a single character from <span class="RktVar">in</span>&#8212;<wbr></wbr>which may involve reading
+several bytes to UTF-8-decode them into a character (see
+<a href="ports.html" data-pltdoc="x">Ports</a>); a minimal number of bytes are read/<a href="ports.html#%28tech._peek%29" class="techoutside" data-pltdoc="x"><span class="techinside">peek</span></a>ed to
+perform the decoding. If no bytes are available before an end-of-file,
+then <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> is returned.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"S2"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char%29%29" class="RktValLink" data-pltdoc="x">read-char</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._newline%29%29" class="RktValLink" data-pltdoc="x">newline</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char%29%29" class="RktValLink" data-pltdoc="x">read-char</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._newline%29%29" class="RktValLink" data-pltdoc="x">newline</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char%29%29" class="RktValLink" data-pltdoc="x">read-char</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">#\S</span></p></td></tr><tr><td><p><span class="RktOut">#\2</span></p></td></tr><tr><td><p><span class="RktOut">#&lt;eof&gt;</span></p></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-bytes%29%29" class="RktValLink" data-pltdoc="x">open-input-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"\316\273"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">The byte string contains UTF-8-encoded content:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char%29%29" class="RktValLink" data-pltdoc="x">read-char</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">#\&#955;</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-byte))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-byte%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-byte</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Reads a single byte from <span class="RktVar">in</span>. If no bytes are available before
+an end-of-file, then <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> is returned.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">The two values in the following list should be the same.</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-byte%29%29" class="RktValLink" data-pltdoc="x">read-byte</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-~3einteger%29%29" class="RktValLink" data-pltdoc="x">char-&gt;integer</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(97 97)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string%29%29" class="RktValLink" data-pltdoc="x">string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\&#955;</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">This string has a two byte-encoding.</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-byte%29%29" class="RktValLink" data-pltdoc="x">read-byte</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-byte%29%29" class="RktValLink" data-pltdoc="x">read-byte</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-byte%29%29" class="RktValLink" data-pltdoc="x">read-byte</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(206 187 #&lt;eof&gt;)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-line))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-line</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktVar">mode</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">linefeed</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return-linefeed</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any-one</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">linefeed</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns a string containing the next line of bytes from <span class="RktVar">in</span>.</div></p><p>Characters are read from <span class="RktVar">in</span> until a line separator or an
+end-of-file is read. The line separator is not included in the result
+string (but it is removed from the port&rsquo;s stream). If no characters
+are read before an end-of-file is encountered, <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> is
+returned.</p><p>The <span class="RktVar">mode</span> argument determines the line separator(s). It
+must be one of the following symbols:</p><ul><li><p><a name="(idx._(gentag._263._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">linefeed</span> breaks lines on linefeed characters.</p></li><li><p><a name="(idx._(gentag._264._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">return</span> breaks lines on return characters.</p></li><li><p><a name="(idx._(gentag._265._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">return-linefeed</span> breaks lines on
+return-linefeed combinations. If a return character is not followed
+by a linefeed character, it is included in the result string;
+similarly, a linefeed that is not preceded by a return is included
+in the result string.</p></li><li><p><a name="(idx._(gentag._266._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">any</span> breaks lines on any of a return
+character, linefeed character, or return-linefeed combination. If a
+return character is followed by a linefeed character, the two are
+treated as a combination.</p></li><li><p><a name="(idx._(gentag._267._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">any-one</span> breaks lines on either a return or
+linefeed character, without recognizing return-linefeed
+combinations.</p></li></ul><p>Return and linefeed characters are detected after the conversions that
+are automatically performed when reading a file in text mode. For
+example, reading a file in text mode on Windows automatically
+changes return-linefeed combinations to a linefeed. Thus, when a file
+is opened in text mode, <span class="RktVal">'</span><span class="RktVal">linefeed</span> is usually the appropriate
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="RktValLink" data-pltdoc="x">read-line</a></span> mode.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x\ny\n"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="RktValLink" data-pltdoc="x">read-line</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"x"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x\ny\n"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="RktValLink" data-pltdoc="x">read-line</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"x\ny\n"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x\ry\r"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="RktValLink" data-pltdoc="x">read-line</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"x"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x\r\ny\r\n"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="RktValLink" data-pltdoc="x">read-line</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return-linefeed</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"x"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x\r\ny\nz"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="RktValLink" data-pltdoc="x">read-line</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="RktValLink" data-pltdoc="x">read-line</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("x" "y")</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x\r\ny\nz"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="RktValLink" data-pltdoc="x">read-line</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any-one</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="RktValLink" data-pltdoc="x">read-line</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any-one</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("x" "")</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-bytes-line))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-line%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-bytes-line</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktVar">mode</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">linefeed</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return-linefeed</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any-one</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">linefeed</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="RktValLink" data-pltdoc="x">read-line</a></span>, but reads bytes and produces a byte string.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-string))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">amt</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">amt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>To read an entire port as a string, use <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3estring%29%29" class="RktValLink" data-pltdoc="x">port-&gt;string</a></span>.</p></blockquote></blockquote></blockquote></div></p><p>Returns a string containing the next <span class="RktVar">amt</span> characters from
+<span class="RktVar">in</span>.</p><p>If <span class="RktVar">amt</span> is <span class="RktVal">0</span>, then the empty string is
+returned. Otherwise, if fewer than <span class="RktVar">amt</span> characters are
+available before an end-of-file is encountered, then the returned
+string will contain only those characters before the end-of-file; that
+is, the returned string&rsquo;s length will be less than <span class="RktVar">amt</span>. (A
+temporary string of size <span class="RktVar">amt</span> is allocated while reading the
+input, even if the size of the result is less than <span class="RktVar">amt</span>
+characters.) If no characters are available before an end-of-file,
+then <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> is returned.</p><p>If an error occurs during reading, some characters may be lost; that
+is, if <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="RktValLink" data-pltdoc="x">read-string</a></span> successfully reads some characters before
+encountering an error, the characters are dropped.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"supercalifragilisticexpialidocious"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="RktValLink" data-pltdoc="x">read-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"super"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-bytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">amt</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">amt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>To read an entire port as bytes, use <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3ebytes%29%29" class="RktValLink" data-pltdoc="x">port-&gt;bytes</a></span>.</p></blockquote></blockquote></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="RktValLink" data-pltdoc="x">read-string</a></span>, but reads bytes and produces a byte string.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-bytes%29%29" class="RktValLink" data-pltdoc="x">open-input-bytes</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">6</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">115</span><span class="hspace">&nbsp;</span><span class="RktVal">101</span><span class="hspace">&nbsp;</span><span class="RktVal">99</span><span class="hspace">&nbsp;</span><span class="RktVal">114</span><span class="hspace">&nbsp;</span><span class="RktVal">101</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">116</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._length%29%29" class="RktValLink" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-byte%29%29" class="RktValLink" data-pltdoc="x">read-byte</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Futf-8%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;string/utf-8</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes%29%29" class="RktValLink" data-pltdoc="x">read-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._length%29%29" class="RktValLink" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"secret"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-string!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-string!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="RktValLink" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Reads characters from <span class="RktVar">in</span> like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="RktValLink" data-pltdoc="x">read-string</a></span>, but puts
+them into <span class="RktVar">str</span> starting from index <span class="RktVar">start-pos</span>
+(inclusive) up to <span class="RktVar">end-pos</span> (exclusive). Like
+<span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._substring%29%29" class="RktValLink" data-pltdoc="x">substring</a></span>, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised if
+<span class="RktVar">start-pos</span> or <span class="RktVar">end-pos</span> is out-of-range for
+<span class="RktVar">str</span>.</div></p><p>If the difference between <span class="RktVar">start-pos</span> and <span class="RktVar">end-pos</span> is
+<span class="RktVal">0</span>, then <span class="RktVal">0</span> is returned and <span class="RktVar">str</span> is not
+modified. If no bytes are available before an end-of-file, then
+<span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> is returned. Otherwise, the return value is the number of
+characters read. If <span style="font-style: italic">m</span> characters are read and
+<span style="font-style: italic">m&lt;</span><span class="RktVar">end-pos</span><span style="font-style: italic">-</span><span class="RktVar">start-pos</span>, then <span class="RktVar">str</span> is
+not modified at indices <span class="RktVar">start-pos</span><span style="font-style: italic">+m</span> through
+<span class="RktVar">end-pos</span>.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">buffer</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._make-string%29%29" class="RktValLink" data-pltdoc="x">make-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">#\_</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"cketRa"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~s\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">buffer</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%21%29%29" class="RktValLink" data-pltdoc="x">read-string!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">buffer</span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~s\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">buffer</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%21%29%29" class="RktValLink" data-pltdoc="x">read-string!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">buffer</span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~s\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">buffer</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">"__________"</span></p></td></tr><tr><td><p><span class="RktOut">"__cket____"</span></p></td></tr><tr><td><p><span class="RktOut">"Racket____"</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-bytes!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-bytes!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%21%29%29" class="RktValLink" data-pltdoc="x">read-string!</a></span>, but reads bytes, puts them into a byte
+string, and returns the number of bytes read.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">buffer</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._make-bytes%29%29" class="RktValLink" data-pltdoc="x">make-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-~3einteger%29%29" class="RktValLink" data-pltdoc="x">char-&gt;integer</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\_</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"cketRa"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~s\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">buffer</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes%21%29%29" class="RktValLink" data-pltdoc="x">read-bytes!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">buffer</span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~s\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">buffer</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes%21%29%29" class="RktValLink" data-pltdoc="x">read-bytes!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">buffer</span><span class="hspace">&nbsp;</span><span class="RktSym">ip</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~s\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">buffer</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">#"__________"</span></p></td></tr><tr><td><p><span class="RktOut">#"__cket____"</span></p></td></tr><tr><td><p><span class="RktOut">#"Racket____"</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-bytes-avail!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-bytes-avail!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes%21%29%29" class="RktValLink" data-pltdoc="x">read-bytes!</a></span>, but returns without blocking after having
+read the immediately available bytes, and it may return a procedure for
+a &ldquo;special&rdquo; result. The <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%29%29" class="RktValLink" data-pltdoc="x">read-bytes-avail!</a></span> procedure blocks
+only if no bytes (or specials) are yet available. Also unlike
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes%21%29%29" class="RktValLink" data-pltdoc="x">read-bytes!</a></span>, <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%29%29" class="RktValLink" data-pltdoc="x">read-bytes-avail!</a></span> never drops bytes; if
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%29%29" class="RktValLink" data-pltdoc="x">read-bytes-avail!</a></span> successfully reads some bytes and then
+encounters an error, it suppresses the error (treating it roughly like
+an end-of-file) and returns the read bytes.  (The error will be
+triggered by future reads.) If an error is encountered before any
+bytes have been read, an exception is raised.</div></p><p>When <span class="RktVar">in</span> produces a special value, as described in
+<a href="customport.html" data-pltdoc="x">Custom Ports</a>, the result is a procedure of four
+arguments. The four arguments correspond to the location of the
+special value within the port, as described in
+<a href="customport.html" data-pltdoc="x">Custom Ports</a>. If the procedure is called more than once
+with valid arguments, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. If
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%29%29" class="RktValLink" data-pltdoc="x">read-bytes-avail!</a></span> returns a special-producing procedure, then
+it does not place characters in <span class="RktVar">bstr</span>. Similarly,
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%29%29" class="RktValLink" data-pltdoc="x">read-bytes-avail!</a></span> places only as many bytes into <span class="RktVar">bstr</span>
+as are available before a special value in the port&rsquo;s stream.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-bytes-avail!*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-bytes-avail!*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%29%29" class="RktValLink" data-pltdoc="x">read-bytes-avail!</a></span>, but returns <span class="RktVal">0</span> immediately if
+no bytes (or specials) are available for reading and the end-of-file
+is not reached.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-bytes-avail!/enable-break))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%2Fenable-break%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-bytes-avail!/enable-break</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%29%29" class="RktValLink" data-pltdoc="x">read-bytes-avail!</a></span>, but breaks are enabled during the
+read (see also <a href="breakhandler.html" data-pltdoc="x">Breaks</a>). If breaking is disabled
+when <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">read-bytes-avail!/enable-break</a></span> is called, and if the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak%29%29" class="RktValLink" data-pltdoc="x">exn:break</a></span> exception is raised as a result of the call, then
+no bytes will have been read from <span class="RktVar">in</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._peek-string))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-string%29%29" class="RktValDef RktValLink" data-pltdoc="x">peek-string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">amt</span><span class="hspace">&nbsp;</span><span class="RktVar">skip-bytes-amt</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">amt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip-bytes-amt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="RktValLink" data-pltdoc="x">read-string</a></span>, except that the returned characters
+are <a href="ports.html#%28tech._peek%29" class="techoutside" data-pltdoc="x"><span class="techinside">peek</span></a>ed: preserved in the port for future reads and <a href="ports.html#%28tech._peek%29" class="techoutside" data-pltdoc="x"><span class="techinside">peeks</span></a>. (More precisely, undecoded
+bytes are left for future reads and peeks.) The <span class="RktVar">skip-bytes-amt</span> argument
+indicates a number of bytes (<span style="font-style: italic">not</span> characters) in the input
+stream to skip before collecting characters to return; thus, in total,
+the next <span class="RktVar">skip-bytes-amt</span> bytes plus <span class="RktVar">amt</span> characters
+are inspected.</div></p><p>For most kinds of ports, inspecting <span class="RktVar">skip-bytes-amt</span> bytes and
+<span class="RktVar">amt</span> characters requires at least
+<span class="RktVar">skip-bytes-amt</span><span style="font-style: italic">+</span><span class="RktVar">amt</span> bytes of memory overhead
+associated with the port, at least until the bytes/characters are
+read. No such overhead is required when peeking into a string port
+(see <a href="stringport.html" data-pltdoc="x">String Ports</a>), a pipe port (see
+<a href="pipeports.html" data-pltdoc="x">Pipes</a>), or a custom port with a specific peek
+procedure (depending on how the peek procedure is implemented; see
+<a href="customport.html" data-pltdoc="x">Custom Ports</a>).</p><p>If a port produces <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> mid-stream, attempts to skip beyond the
+<span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> for a <a href="ports.html#%28tech._peek%29" class="techoutside" data-pltdoc="x"><span class="techinside">peek</span></a> always produce <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> until the <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> is
+read.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._peek-bytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">peek-bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">amt</span><span class="hspace">&nbsp;</span><span class="RktVar">skip-bytes-amt</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">amt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip-bytes-amt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-string%29%29" class="RktValLink" data-pltdoc="x">peek-string</a></span>, but <a href="ports.html#%28tech._peek%29" class="techoutside" data-pltdoc="x"><span class="techinside">peeks</span></a> bytes and produces a byte string.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._peek-string!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-string%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">peek-string!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">str</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">skip-bytes-amt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip-bytes-amt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="RktValLink" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%21%29%29" class="RktValLink" data-pltdoc="x">read-string!</a></span>, but for <a href="ports.html#%28tech._peek%29" class="techoutside" data-pltdoc="x"><span class="techinside">peek</span></a>ing, and with a
+<span class="RktVar">skip-bytes-amt</span> argument like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-string%29%29" class="RktValLink" data-pltdoc="x">peek-string</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._peek-bytes!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">peek-bytes!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">skip-bytes-amt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip-bytes-amt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-string%21%29%29" class="RktValLink" data-pltdoc="x">peek-string!</a></span>, but <a href="ports.html#%28tech._peek%29" class="techoutside" data-pltdoc="x"><span class="techinside">peeks</span></a> bytes, puts them into a byte
+string, and returns the number of bytes read.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._peek-bytes-avail!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes-avail%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">peek-bytes-avail!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">skip-bytes-amt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">progress</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip-bytes-amt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">progress</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._progress-evt~3f%29%29" class="RktValLink" data-pltdoc="x">progress-evt?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%29%29" class="RktValLink" data-pltdoc="x">read-bytes-avail!</a></span>, but for <a href="ports.html#%28tech._peek%29" class="techoutside" data-pltdoc="x"><span class="techinside">peek</span></a>ing, and with two extra
+arguments. The <span class="RktVar">skip-bytes-amt</span> argument is as in
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes%29%29" class="RktValLink" data-pltdoc="x">peek-bytes</a></span>.  The <span class="RktVar">progress</span> argument must be either
+<span class="RktVal">#f</span> or an event produced by
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-progress-evt%29%29" class="RktValLink" data-pltdoc="x">port-progress-evt</a></span> for <span class="RktVar">in</span>.</div></p><p>To <a href="ports.html#%28tech._peek%29" class="techoutside" data-pltdoc="x"><span class="techinside">peek</span></a>, <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes-avail%21%29%29" class="RktValLink" data-pltdoc="x">peek-bytes-avail!</a></span> blocks until finding an
+end-of-file, at least one byte (or special) past the skipped bytes, or
+until a non-<span class="RktVal">#f</span> <span class="RktVar">progress</span> becomes ready. Furthermore,
+if <span class="RktVar">progress</span> is ready before bytes are peeked, no bytes are
+peeked or skipped, and <span class="RktVar">progress</span> may cut short the skipping
+process if it becomes available during the peek attempt. Furthermore,
+<span class="RktVar">progress</span> is checked even before determining whether the port
+is still open.</p><p>The result of <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes-avail%21%29%29" class="RktValLink" data-pltdoc="x">peek-bytes-avail!</a></span> is <span class="RktVal">0</span> only in the
+case that <span class="RktVar">progress</span> becomes ready before bytes are peeked.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._peek-bytes-avail!*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes-avail%21%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">peek-bytes-avail!*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">skip-bytes-amt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">progress</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip-bytes-amt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">progress</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._progress-evt~3f%29%29" class="RktValLink" data-pltdoc="x">progress-evt?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%2A%29%29" class="RktValLink" data-pltdoc="x">read-bytes-avail!*</a></span>, but for <a href="ports.html#%28tech._peek%29" class="techoutside" data-pltdoc="x"><span class="techinside">peek</span></a>ing, and with
+<span class="RktVar">skip-bytes-amt</span> and <span class="RktVar">progress</span> arguments like
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes-avail%21%29%29" class="RktValLink" data-pltdoc="x">peek-bytes-avail!</a></span>. Since this procedure never blocks, it may
+return before even <span class="RktVar">skip-bytes-amt</span> bytes are available from the
+port.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._peek-bytes-avail!/enable-break))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes-avail%21%2Fenable-break%29%29" class="RktValDef RktValLink" data-pltdoc="x">peek-bytes-avail!/enable-break</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">skip-bytes-amt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">progress</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip-bytes-amt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">progress</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._progress-evt~3f%29%29" class="RktValLink" data-pltdoc="x">progress-evt?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">read-bytes-avail!/enable-break</a></span>, but for <a href="ports.html#%28tech._peek%29" class="techoutside" data-pltdoc="x"><span class="techinside">peek</span></a>ing, and
+with <span class="RktVar">skip-bytes-amt</span> and <span class="RktVar">progress</span> arguments like
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes-avail%21%29%29" class="RktValLink" data-pltdoc="x">peek-bytes-avail!</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-char-or-special))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char-or-special%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-char-or-special</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">special-wrap</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">source-name</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">special-wrap</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">source-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char%29%29" class="RktValLink" data-pltdoc="x">read-char</a></span>, but if the input port returns a
+<a href="ports.html#%28tech._special%29" class="techoutside" data-pltdoc="x"><span class="techinside">special</span></a> value (through a value-generating procedure in a custom
+port, where <span class="RktVar">source-name</span> is provided to the procedure; see
+<a href="customport.html" data-pltdoc="x">Custom Ports</a> and <a href="special-comments.html" data-pltdoc="x">Special Comments</a> for details),
+then the result of applying <span class="RktVar">special-wrap</span> to the
+<a href="ports.html#%28tech._special%29" class="techoutside" data-pltdoc="x"><span class="techinside">special</span></a> value is returned. A <span class="RktVal">#f</span> value for
+<span class="RktVar">special-wrap</span> is treated the same as the identity function.</div></p><p class="SHistory">Changed in version 6.8.0.2 of package <span class="stt">base</span>: Added the <span class="RktVar">special-wrap</span> and
+<span class="RktVar">source-name</span> arguments.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-byte-or-special))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-byte-or-special%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-byte-or-special</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">special-wrap</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">source-name</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">special-wrap</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">source-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char-or-special%29%29" class="RktValLink" data-pltdoc="x">read-char-or-special</a></span>, but reads and returns a byte
+instead of a character.</div></p><p class="SHistory">Changed in version 6.8.0.2 of package <span class="stt">base</span>: Added the <span class="RktVar">special-wrap</span> and
+<span class="RktVar">source-name</span> arguments.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._peek-char))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-char%29%29" class="RktValDef RktValLink" data-pltdoc="x">peek-char</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktVar">skip-bytes-amt</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip-bytes-amt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char%29%29" class="RktValLink" data-pltdoc="x">read-char</a></span>, but <a href="ports.html#%28tech._peek%29" class="techoutside" data-pltdoc="x"><span class="techinside">peeks</span></a> instead of reading, and skips
+<span class="RktVar">skip-bytes-amt</span> bytes (not characters) at the start of the
+port.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._peek-byte))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-byte%29%29" class="RktValDef RktValLink" data-pltdoc="x">peek-byte</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktVar">skip-bytes-amt</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip-bytes-amt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-char%29%29" class="RktValLink" data-pltdoc="x">peek-char</a></span>, but <a href="ports.html#%28tech._peek%29" class="techoutside" data-pltdoc="x"><span class="techinside">peeks</span></a> and returns a byte instead of a
+character.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._peek-char-or-special))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-char-or-special%29%29" class="RktValDef RktValLink" data-pltdoc="x">peek-char-or-special</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">skip-bytes-amt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">special-wrap</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">source-name</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip-bytes-amt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">special-wrap</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">special</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">source-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-char%29%29" class="RktValLink" data-pltdoc="x">peek-char</a></span>, but if the input port returns a non-byte
+value after <span class="RktVar">skip-bytes-amt</span> byte positions, then the result
+depends on <span class="RktVar">special-wrap</span>:</div></p><ul><li><p>If <span class="RktVar">special-wrap</span> is <span class="RktVal">#f</span>, then the special value
+is returned (as for <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char-or-special%29%29" class="RktValLink" data-pltdoc="x">read-char-or-special</a></span>).</p></li><li><p>If <span class="RktVar">special-wrap</span> is a procedure, then it is applied the
+ special value to produce the result (as for
+ <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char-or-special%29%29" class="RktValLink" data-pltdoc="x">read-char-or-special</a></span>).</p></li><li><p>If <span class="RktVar">special-wrap</span> is <span class="RktVal">'</span><span class="RktVal">special</span>, then
+<span class="RktVal">'</span><span class="RktVal">special</span> is returned in place of the special
+value&#8212;<wbr></wbr>without calling the special-value procedure that is
+returned by the input-port implementation.</p></li></ul><p class="SHistory">Changed in version 6.8.0.2 of package <span class="stt">base</span>: Added the <span class="RktVar">special-wrap</span> and
+<span class="RktVar">source-name</span> arguments.<br/>Changed in version 6.90.0.16: Added <span class="RktVal">'</span><span class="RktVal">special</span> as an option
+for <span class="RktVar">special-wrap</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._peek-byte-or-special))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-byte-or-special%29%29" class="RktValDef RktValLink" data-pltdoc="x">peek-byte-or-special</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">skip-bytes-amt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">progress</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">special-wrap</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">source-name</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip-bytes-amt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">progress</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._progress-evt~3f%29%29" class="RktValLink" data-pltdoc="x">progress-evt?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">special-wrap</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">special</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">source-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-char-or-special%29%29" class="RktValLink" data-pltdoc="x">peek-char-or-special</a></span>, but <a href="ports.html#%28tech._peek%29" class="techoutside" data-pltdoc="x"><span class="techinside">peeks</span></a> and returns a byte
+instead of a character, and it supports a <span class="RktVar">progress</span> argument
+like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes-avail%21%29%29" class="RktValLink" data-pltdoc="x">peek-bytes-avail!</a></span>.</div></p><p class="SHistory">Changed in version 6.8.0.2 of package <span class="stt">base</span>: Added the <span class="RktVar">special-wrap</span> and
+<span class="RktVar">source-name</span> arguments.<br/>Changed in version 6.90.0.16: Added <span class="RktVal">'</span><span class="RktVal">special</span> as an option
+for <span class="RktVar">special-wrap</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._port-progress-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-progress-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-progress-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._progress-evt~3f%29%29" class="RktValLink" data-pltdoc="x">progress-evt?</a></span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-provides-progress-evts~3f%29%29" class="RktValLink" data-pltdoc="x">port-provides-progress-evts?</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> (see <a href="sync.html" data-pltdoc="x">Events</a>) that
+becomes <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> after any subsequent read
+from <span class="RktVar">in</span> or after <span class="RktVar">in</span> is closed. After the event
+becomes ready, it remains ready. The <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> of a progress event is the progress event itself.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._port-provides-progress-evts~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-provides-progress-evts~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-provides-progress-evts?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym">boolean</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-progress-evt%29%29" class="RktValLink" data-pltdoc="x">port-progress-evt</a></span> can return an event
+for <span class="RktVar">in</span>. All built-in kinds of ports support progress events,
+but ports created with <span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-input-port%29%29" class="RktValLink" data-pltdoc="x">make-input-port</a></span> (see
+<a href="customport.html" data-pltdoc="x">Custom Ports</a>) may not.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._port-commit-peeked))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-commit-peeked%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-commit-peeked</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">amt</span><span class="hspace">&nbsp;</span><span class="RktVar">progress</span><span class="hspace">&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">amt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">progress</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._progress-evt~3f%29%29" class="RktValLink" data-pltdoc="x">progress-evt?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Attempts to <a href="ports.html#%28tech._commit%29" class="techoutside" data-pltdoc="x"><span class="techinside">commit</span></a> as read the first <span class="RktVar">amt</span> previously <a href="ports.html#%28tech._peek%29" class="techoutside" data-pltdoc="x"><span class="techinside">peek</span></a>ed
+bytes, non-byte specials, and <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>s from <span class="RktVar">in</span>, or the
+first <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> or special value peeked from
+<span class="RktVar">in</span>. Mid-stream <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>s can be
+committed, but an <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> when the port is exhausted does not
+necessarily commit, since it does not correspond to data in the stream.</div></p><p>The read commits only if <span class="RktVar">progress</span> does not become ready first
+(i.e., if no other process reads from <span class="RktVar">in</span> first), and only if
+<span class="RktVar">evt</span> is chosen by a <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span> within
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-commit-peeked%29%29" class="RktValLink" data-pltdoc="x">port-commit-peeked</a></span> (in which case the event result is
+ignored); the <span class="RktVar">evt</span> must be either a channel-put event,
+channel, semaphore, semaphore-peek event, always event, or never
+event. Suspending the thread that calls <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-commit-peeked%29%29" class="RktValLink" data-pltdoc="x">port-commit-peeked</a></span>
+may or may not prevent the commit from proceeding.</p><p>The result from <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-commit-peeked%29%29" class="RktValLink" data-pltdoc="x">port-commit-peeked</a></span> is <span class="RktVal">#t</span> if data has been
+committed, and <span class="RktVal">#f</span> otherwise.</p><p>If no data has been peeked from <span class="RktVar">in</span> and <span class="RktVar">progress</span> is
+not ready, then <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.  If fewer than
+<span class="RktVar">amt</span> items have been peeked at the current start of
+<span class="RktVar">in</span>&rsquo;s stream, then only the peeked items are committed as
+read.  If <span class="RktVar">in</span>&rsquo;s stream currently starts at an <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> or
+a non-byte special value, then only the <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> or special value
+is committed as read.</p><p>If <span class="RktVar">progress</span> is not a result of <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-progress-evt%29%29" class="RktValLink" data-pltdoc="x">port-progress-evt</a></span>
+applied to <span class="RktVar">in</span>, then <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._byte-ready~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._byte-ready~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">byte-ready?</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-byte%29%29" class="RktValLink" data-pltdoc="x">read-byte</a></span><span class="stt"> </span><span class="RktVar">in</span><span class="RktPn">)</span> would not block (at the
+time that <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._byte-ready~3f%29%29" class="RktValLink" data-pltdoc="x">byte-ready?</a></span> was called, at least).  Equivalent to
+<span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">sync/timeout</a></span><span class="stt"> </span><span class="RktVal">0</span><span class="stt"> </span><span class="RktVar">in</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">#t</span><span class="RktPn">)</span>.</div></p><p>The <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._byte-ready~3f%29%29" class="RktValLink" data-pltdoc="x">byte-ready?</a></span> and <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._char-ready~3f%29%29" class="RktValLink" data-pltdoc="x">char-ready?</a></span> functions are
+appropriate for relatively few applications, because ports are meant
+to support streaming data among concurrent producers and consumers;
+the fact that a byte or character is not ready in some instant does
+not necessarily mean that the producer is finished supplying data.
+(Also, if a port has multiple consumers, data might get consumed
+between the time that a given process uses <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._byte-ready~3f%29%29" class="RktValLink" data-pltdoc="x">byte-ready?</a></span> to
+poll the port and the time that it reads data from the port.) Using
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._byte-ready~3f%29%29" class="RktValLink" data-pltdoc="x">byte-ready?</a></span> makes sense if you are implementing your own
+scheduler or if you know that the port&rsquo;s implementation and use are
+particularly constrained.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-ready~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._char-ready~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-ready?</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char%29%29" class="RktValLink" data-pltdoc="x">read-char</a></span><span class="stt"> </span><span class="RktVar">in</span><span class="RktPn">)</span> would not block (at the
+time that <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._char-ready~3f%29%29" class="RktValLink" data-pltdoc="x">char-ready?</a></span> was called, at least). Depending on the
+initial bytes of the stream, multiple bytes may be needed to form a
+UTF-8 encoding.</div></p><p>See <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._byte-ready~3f%29%29" class="RktValLink" data-pltdoc="x">byte-ready?</a></span> for a note on how <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._byte-ready~3f%29%29" class="RktValLink" data-pltdoc="x">byte-ready?</a></span> and
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._char-ready~3f%29%29" class="RktValLink" data-pltdoc="x">char-ready?</a></span> are rarely the right choice.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._progress-evt~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._progress-evt~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">progress-evt?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._progress-evt~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">progress-evt?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._progress-evt~3f%29%29" class="RktValLink" data-pltdoc="x">progress-evt?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">With one argument, returns <span class="RktVal">#t</span> is <span class="RktVar">v</span> is a progress evt
+for some input port, <span class="RktVal">#f</span> otherwise.</div></p><p>With two arguments, returns <span class="RktVal">#t</span> if <span class="RktVar">evt</span> is a progress
+event for <span class="RktVar">in</span>, <span class="RktVal">#f</span> otherwise.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="port-lib.html" title="backward to &quot;13.1.10 More Port Constructors, Procedures, and Events&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Byte_and_String_Output.html" title="forward to &quot;13.3 Byte and String Output&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Byte_and_String_Output.html b/clones/docs.racket-lang.org/reference/Byte_and_String_Output.html
new file mode 100644
index 00000000..c024f38f
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Byte_and_String_Output.html
@@ -0,0 +1,64 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.3&nbsp;Byte and String Output</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewselflink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-char%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-<wbr></wbr>char</span></span></a></td></tr><tr><td><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-byte%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-<wbr></wbr>byte</span></span></a></td></tr><tr><td><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._newline%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">newline</span></span></a></td></tr><tr><td><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-string%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-<wbr></wbr>string</span></span></a></td></tr><tr><td><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-<wbr></wbr>bytes-<wbr></wbr>avail</span></span></a></td></tr><tr><td><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%2A%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-<wbr></wbr>bytes-<wbr></wbr>avail*</span></span></a></td></tr><tr><td><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%2Fenable-break%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-<wbr></wbr>bytes-<wbr></wbr>avail/<span class="mywbr"> &nbsp;</span>enable-<wbr></wbr>break</span></span></a></td></tr><tr><td><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-special%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-<wbr></wbr>special</span></span></a></td></tr><tr><td><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-special-avail%2A%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-<wbr></wbr>special-<wbr></wbr>avail*</span></span></a></td></tr><tr><td><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-<wbr></wbr>bytes-<wbr></wbr>avail-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-special-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-<wbr></wbr>special-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._port-writes-atomic~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>writes-<wbr></wbr>atomic?</span></span></a></td></tr><tr><td><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._port-writes-special~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>writes-<wbr></wbr>special?</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Byte_and_String_Input.html" title="backward to &quot;13.2 Byte and String Input&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Reading.html" title="forward to &quot;13.4 Reading&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Byte_and_String_Output&quot;">13.3<tt>&nbsp;</tt><a name="(part._.Byte_and_.String_.Output)"></a>Byte and String Output</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._write-char))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-char%29%29" class="RktValDef RktValLink" data-pltdoc="x">write-char</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">out</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Writes a single character to <span class="RktVar">out</span>; more precisely, the bytes
+that are the UTF-8 encoding of <span class="RktVar">char</span> are written to
+<span class="RktVar">out</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._write-byte))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-byte%29%29" class="RktValDef RktValLink" data-pltdoc="x">write-byte</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">byte</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">out</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">byte</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Writes a single byte to <span class="RktVar">out</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._newline))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._newline%29%29" class="RktValDef RktValLink" data-pltdoc="x">newline</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">out</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-char%29%29" class="RktValLink" data-pltdoc="x">write-char</a></span><span class="stt"> </span><span class="RktVal">#\newline</span><span class="stt"> </span><span class="RktVar">out</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._write-string))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-string%29%29" class="RktValDef RktValLink" data-pltdoc="x">write-string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="RktValLink" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Writes characters to <span class="RktVar">out</span> from <span class="RktVar">str</span> starting from
+index <span class="RktVar">start-pos</span> (inclusive) up to <span class="RktVar">end-pos</span>
+(exclusive). Like <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._substring%29%29" class="RktValLink" data-pltdoc="x">substring</a></span>, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised
+if <span class="RktVar">start-pos</span> or <span class="RktVar">end-pos</span> is out-of-range for
+<span class="RktVar">str</span>.</div></p><p>The result is the number of characters written to <span class="RktVar">out</span>, which
+is always <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">end-pos</span><span class="stt"> </span><span class="RktVar">start-pos</span><span class="RktPn">)</span>.</p><p>If <span class="RktVar">str</span> is mutable, mutations after <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-string%29%29" class="RktValLink" data-pltdoc="x">write-string</a></span>
+returns do not affect the characters written to <span class="RktVar">out</span>. (This
+independence from mutation is not a special property of
+<span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-string%29%29" class="RktValLink" data-pltdoc="x">write-string</a></span>, but instead generally true of output
+functions.)</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._write-bytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">write-bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-string%29%29" class="RktValLink" data-pltdoc="x">write-string</a></span>, but writes bytes instead of characters.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._write-bytes-avail))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%29%29" class="RktValDef RktValLink" data-pltdoc="x">write-bytes-avail</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes%29%29" class="RktValLink" data-pltdoc="x">write-bytes</a></span>, but returns without blocking after writing
+as many bytes as it can immediately flush. It blocks only if no bytes
+can be flushed immediately. The result is the number of bytes written
+and flushed to <span class="RktVar">out</span>; if <span class="RktVar">start-pos</span> is the same as
+<span class="RktVar">end-pos</span>, then the result can be <span class="RktVal">0</span> (indicating a
+successful flush of any buffered data), otherwise the result is between
+<span class="RktVal">1</span> and <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">end-pos</span><span class="stt"> </span><span class="RktVar">start-pos</span><span class="RktPn">)</span>, inclusive.</div></p><p>The <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail</a></span> procedure never drops bytes; if
+<span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail</a></span> successfully writes some bytes and then
+encounters an error, it suppresses the error and returns the number of
+written bytes.  (The error will be triggered by future writes.) If an
+error is encountered before any bytes have been written, an exception
+is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._write-bytes-avail*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">write-bytes-avail*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail</a></span>, but never blocks, returns <span class="RktVal">#f</span>
+if the port contains buffered data that cannot be written immediately,
+and returns <span class="RktVal">0</span> if the port&rsquo;s internal buffer (if any) is
+flushed but no additional bytes can be written immediately.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._write-bytes-avail/enable-break))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%2Fenable-break%29%29" class="RktValDef RktValLink" data-pltdoc="x">write-bytes-avail/enable-break</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail</a></span>, except that breaks are enabled during
+the write. The procedure provides a guarantee about the interaction of
+writing and breaks: if breaking is disabled when
+<span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail/enable-break</a></span> is called, and if the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak%29%29" class="RktValLink" data-pltdoc="x">exn:break</a></span> exception is raised as a result of the call, then
+no bytes will have been written to <span class="RktVar">out</span>.  See also
+<a href="breakhandler.html" data-pltdoc="x">Breaks</a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._write-special))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-special%29%29" class="RktValDef RktValLink" data-pltdoc="x">write-special</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">out</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Writes <span class="RktVar">v</span> directly to <span class="RktVar">out</span> if the port supports
+special writes, or raises <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> if the port does
+not support special write. The result is always <span class="RktVal">#t</span>,
+indicating that the write succeeded.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._write-special-avail*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-special-avail%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">write-special-avail*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">out</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-special%29%29" class="RktValLink" data-pltdoc="x">write-special</a></span>, but without blocking. If <span class="RktVar">v</span>
+cannot be written immediately, the result is <span class="RktVal">#f</span> without
+writing <span class="RktVar">v</span>, otherwise the result is <span class="RktVal">#t</span> and <span class="RktVar">v</span>
+is written.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._write-bytes-avail-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">write-bytes-avail-evt</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail</a></span>, but instead of writing bytes
+immediately, it returns a synchronizable event (see
+<a href="sync.html" data-pltdoc="x">Events</a>).  The <span class="RktVar">out</span> must support atomic writes, as
+indicated by <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._port-writes-atomic~3f%29%29" class="RktValLink" data-pltdoc="x">port-writes-atomic?</a></span>.</div></p><p>Synchronizing on the object starts a write from <span class="RktVar">bstr</span>, and the
+event becomes ready when bytes are written (unbuffered) to the
+port. If <span class="RktVar">start-pos</span> and <span class="RktVar">end-pos</span> are the same, then
+the synchronization result is <span class="RktVal">0</span> when the port&rsquo;s internal
+buffer (if any) is flushed, otherwise the result is a positive exact
+integer. If the event is not selected in a synchronization, then no
+bytes will have been written to <span class="RktVar">out</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._write-special-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-special-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">write-special-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">out</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-special%29%29" class="RktValLink" data-pltdoc="x">write-special</a></span>, but instead of writing the special
+value immediately, it returns a synchronizable event (see
+<a href="sync.html" data-pltdoc="x">Events</a>).  The <span class="RktVar">out</span> must support atomic writes, as
+indicated by <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._port-writes-atomic~3f%29%29" class="RktValLink" data-pltdoc="x">port-writes-atomic?</a></span>.</div></p><p>Synchronizing on the object starts a write of the special value, and
+the event becomes ready when the value is written (unbuffered) to the
+port. If the event is not selected in a synchronization, then no value
+will have been written to <span class="RktVar">out</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._port-writes-atomic~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._port-writes-atomic~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-writes-atomic?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">out</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail/enable-break</a></span> can
+provide an exclusive-or guarantee (break or write, but not both) for
+<span class="RktVar">out</span>, and if the port can be used with procedures like
+<span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail-evt%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail-evt</a></span>. Racket&rsquo;s file-stream ports, pipes,
+string ports, and TCP ports all support atomic writes; ports created
+with <span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-output-port%29%29" class="RktValLink" data-pltdoc="x">make-output-port</a></span> (see <a href="customport.html" data-pltdoc="x">Custom Ports</a>) may
+support atomic writes.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._port-writes-special~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._port-writes-special~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-writes-special?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">out</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if procedures like <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-special%29%29" class="RktValLink" data-pltdoc="x">write-special</a></span> can
+write arbitrary values to the port. Racket&rsquo;s file-stream ports,
+pipes, string ports, and TCP ports all reject special values, but
+ports created with <span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-output-port%29%29" class="RktValLink" data-pltdoc="x">make-output-port</a></span> (see
+<a href="customport.html" data-pltdoc="x">Custom Ports</a>) may support them.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Byte_and_String_Input.html" title="backward to &quot;13.2 Byte and String Input&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Reading.html" title="forward to &quot;13.4 Reading&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Command-Line_Parsing.html b/clones/docs.racket-lang.org/reference/Command-Line_Parsing.html
new file mode 100644
index 00000000..a2467400
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Command-Line_Parsing.html
@@ -0,0 +1,152 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15.9&nbsp;Command-Line Parsing</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewselflink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewlink" data-pltdoc="x">Paths</a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="Filesystem.html" class="tocviewlink" data-pltdoc="x">Filesystem</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="networking.html" class="tocviewlink" data-pltdoc="x">Networking</a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="subprocess.html" class="tocviewlink" data-pltdoc="x">Processes</a></td></tr><tr><td align="right">15.5&nbsp;</td><td><a href="logging.html" class="tocviewlink" data-pltdoc="x">Logging</a></td></tr><tr><td align="right">15.6&nbsp;</td><td><a href="time.html" class="tocviewlink" data-pltdoc="x">Time</a></td></tr><tr><td align="right">15.7&nbsp;</td><td><a href="envvars.html" class="tocviewlink" data-pltdoc="x">Environment Variables</a></td></tr><tr><td align="right">15.8&nbsp;</td><td><a href="runtime.html" class="tocviewlink" data-pltdoc="x">Environment and Runtime Information</a></td></tr><tr><td align="right">15.9&nbsp;</td><td><a href="Command-Line_Parsing.html" class="tocviewselflink" data-pltdoc="x">Command-<wbr></wbr>Line Parsing</a></td></tr><tr><td align="right">15.10&nbsp;</td><td><a href="os-lib.html" class="tocviewlink" data-pltdoc="x">Additional Operating System Functions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Command-Line_Parsing.html#%28form._%28%28lib._racket%2Fcmdline..rkt%29._command-line%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">command-<wbr></wbr>line</span></span></a></td></tr><tr><td><a href="Command-Line_Parsing.html#%28def._%28%28lib._racket%2Fcmdline..rkt%29._parse-command-line%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">parse-<wbr></wbr>command-<wbr></wbr>line</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="runtime.html" title="backward to &quot;15.8 Environment and Runtime Information&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="os.html" title="up to &quot;15 Operating System&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="os-lib.html" title="forward to &quot;15.10 Additional Operating System Functions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Command-Line_Parsing&quot;">15.9<tt>&nbsp;</tt><a name="(part._.Command-.Line_.Parsing)"></a><a name="(mod-path._racket/cmdline)"></a>Command-Line Parsing</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="Command-Line_Parsing.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/cmdline</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="Command-Line_Parsing.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/cmdline</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/cmdline..rkt)._command-line))"></a><span title="Provided from: racket/cmdline, racket | Package: base"><span class="RktSym"><a href="Command-Line_Parsing.html#%28form._%28%28lib._racket%2Fcmdline..rkt%29._command-line%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">command-line</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">optional-name-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">optional-argv-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">flag-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">finish-clause</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">optional-name-expr</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:program</span><span class="hspace">&nbsp;</span><span class="RktVar">name-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">optional-argv-expr</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:argv</span><span class="hspace">&nbsp;</span><span class="RktVar">argv-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">flag-clause</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:multi</span><span class="hspace">&nbsp;</span><span class="RktVar">flag-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:once-each</span><span class="hspace">&nbsp;</span><span class="RktVar">flag-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:once-any</span><span class="hspace">&nbsp;</span><span class="RktVar">flag-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:final</span><span class="hspace">&nbsp;</span><span class="RktVar">flag-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:usage-help</span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:help-labels</span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:ps</span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">flag-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">flags</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">help-spec</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">flags</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktVar">handler-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">help-expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">flags</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">flag-string</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">flag-string</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">help-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">string</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">string-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">finish-clause</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:args</span><span class="hspace">&nbsp;</span><span class="RktVar">arg-formals</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:handlers</span><span class="hspace">&nbsp;</span><span class="RktVar">handlers-exprs</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">arg-formals</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">rest-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">rest-id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">arg</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">default-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">handlers-exprs</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">finish-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">arg-strings-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">finish-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">arg-strings-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">help-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktVar">finish-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">arg-strings-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">help-expr</span></td></tr><tr><td><span class="RktVar">unknown-expr</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Parses a command line according to the specification in the
+<span class="RktVar">flag-clause</span>s.</div></p><p>The <span class="RktVar">name-expr</span>, if provided, should produce a path or string
+to be used as the program name for reporting errors when the
+command-line is ill-formed. It defaults to <span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">run-file</span><span class="RktPn">)</span>. When a path is provided, only the last element of the
+path is used to report an error.</p><p>The <span class="RktVar">argv-expr</span>, if provided, must evaluate to a list or a
+vector of strings. It defaults to
+<span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._current-command-line-arguments%29%29" class="RktValLink" data-pltdoc="x">current-command-line-arguments</a></span><span class="RktPn">)</span>.</p><p>The command-line is disassembled into flags, each possibly with
+flag-specific arguments, followed by (non-flag)
+arguments. Command-line strings starting with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span> or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span> are parsed as flags, but arguments to flags are never
+parsed as flags, and integers and decimal numbers that start with
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span> are not treated as flags. Non-flag
+arguments in the command-line must appear after all flags and the
+flags&rsquo; arguments. No command-line string past the first non-flag
+argument is parsed as a flag. The built-in <span class="nobreak"><span class="stt">--</span></span> flag signals the
+end of command-line flags; any command-line string past the <span class="nobreak"><span class="stt">--</span></span>
+flag is parsed as a non-flag argument.</p><p>A <span class="RktPn">#:multi</span>, <span class="RktPn">#:once-each</span>, <span class="RktPn">#:once-any</span>, or
+<span class="RktPn">#:final</span> clause introduces a set of command-line flag
+specifications. The clause tag indicates how many times the flag can
+appear on the command line:</p><ul><li><p><span class="RktPn">#:multi</span> &#8212;<wbr></wbr> Each flag specified in the set can be
+represented any number of times on the command line; i.e., the flags
+in the set are independent and each flag can be used multiple times.</p></li><li><p><span class="RktPn">#:once-each</span> &#8212;<wbr></wbr> Each flag specified in the set can be
+represented once on the command line; i.e., the flags in the set are
+independent, but each flag should be specified at most once. If a
+flag specification is represented in the command line more than once,
+the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span> exception is raised.</p></li><li><p><span class="RktPn">#:once-any</span> &#8212;<wbr></wbr> Only one flag specified in the set can
+be represented on the command line; i.e., the flags in the set are
+mutually exclusive. If the set is represented in the command line
+more than once, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span> exception is raised.</p></li><li><p><span class="RktPn">#:final</span> &#8212;<wbr></wbr> Like <span class="RktPn">#:multi</span>, except that no
+argument after the flag is treated as a flag. Note that multiple
+<span class="RktPn">#:final</span> flags can be specified if they have short names; for
+example, if <span class="nobreak"><span class="stt">-a</span></span> is a <span class="RktPn">#:final</span> flag, then <span class="nobreak"><span class="stt">-aa</span></span> combines
+two instances of <span class="nobreak"><span class="stt">-a</span></span> in a single command-line argument.</p></li></ul><p>A normal flag specification has four parts:</p><ul><li><p><span class="RktVar">flags</span> &#8212;<wbr></wbr> a flag string, or a set of flag strings.  If
+a set of flags is provided, all of the flags are equivalent.  Each
+flag string must be of the form
+<span class="RktVal">"-</span><span class="RktVar">x</span><span class="RktVal">"</span> or
+<span class="RktVal">"+</span><span class="RktVar">x</span><span class="RktVal">"</span> for some
+character <span class="RktVar">x</span>, or
+<span class="RktVal">"--</span><span class="RktVar">x</span><span class="RktVal">"</span> or
+<span class="RktVal">"++</span><span class="RktVar">x</span><span class="RktVal">"</span> for some
+sequence of characters <span class="RktVar">x</span>. An <span class="RktVar">x</span> cannot
+contain only digits or digits plus a single decimal point, since
+simple (signed) numbers are not treated as flags. In addition, the
+flags <span class="RktVal">"--"</span>, <span class="RktVal">"-h"</span>, and <span class="RktVal">"--help"</span> are
+predefined and cannot be changed.</p></li><li><p><span class="RktVar">id</span>s &#8212;<wbr></wbr> identifier that are bound to the flag&rsquo;s
+arguments. The number of identifiers determines how many arguments
+can be provided on the command line with the flag, and the names of
+these identifiers will appear in the help message describing the
+flag. The <span class="RktVar">id</span>s are bound to string values in the
+<span class="RktVar">body</span>s for handling the flag.</p></li><li><p><span class="RktVar">help-spec</span> &#8212;<wbr></wbr> a string or sequence of strings that
+describes the flag. This string is used in the help message generated
+by the handler for the built-in <span class="nobreak"><span class="stt">-h</span></span> (or <span class="nobreak"><span class="stt">--help</span></span>) flag. A
+single literal string can be provided, or any number of expressions
+that produce strings; in the latter case, strings after the first one
+are displayed on subsequent lines.</p></li><li><p><span class="RktVar">body</span>s &#8212;<wbr></wbr> expressions that are evaluated when one of
+the <span class="RktVar">flags</span> appears on the command line. The flags are parsed
+left-to-right, and each sequence of <span class="RktVar">body</span>s is evaluated as
+the corresponding flag is encountered. When the <span class="RktVar">body</span>s are
+evaluated, the preceding <span class="RktVar">id</span>s are bound to the arguments
+provided for the flag on the command line.</p></li></ul><p>A flag specification using <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span> escapes to a more general
+method of specifying the handler and help strings. In this case, the
+handler procedure and help string list returned by
+<span class="RktVar">handler-expr</span> and <span class="RktVar">help-expr</span> are used as in the
+<span class="RktVar">table</span> argument of <span class="RktSym"><a href="Command-Line_Parsing.html#%28def._%28%28lib._racket%2Fcmdline..rkt%29._parse-command-line%29%29" class="RktValLink" data-pltdoc="x">parse-command-line</a></span>.</p><p>A <span class="RktPn">#:usage-help</span> clause inserts text lines immediately after
+the usage line.  Each string in the clause provides a separate line
+of text.</p><p>A <span class="RktPn">#:help-labels</span> clause inserts text lines into the help table
+of command-line flags. Each string in the clause provides a separate
+line of text.</p><p>A <span class="RktPn">#:ps</span> clause inserts text lines at the end of the help
+output. Each string in the clause provides a separate
+line of text.</p><p>After the flag clauses, a final clause handles command-line arguments
+that are not parsed as flags:</p><ul><li><p>Supplying no finish clause is the same as supplying
+<span class="RktPn">#:args</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span>.</p></li><li><p>For an <span class="RktPn">#:args</span> finish clause, identifiers in
+<span class="RktVar">arg-formals</span> are bound to the leftover command-line strings
+in the same way that identifiers are bound for a <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span>
+expression. Thus, specifying a single <span class="RktVar">id</span> (without
+parentheses) collects all of the leftover arguments into a list. The
+effective arity of the <span class="RktVar">arg-formals</span> specification determines
+the number of extra command-line arguments that the user can provide,
+and the names of the identifiers in <span class="RktVar">arg-formals</span> are used in
+the help string. When the command-line is parsed, if the number of
+provided arguments cannot be matched to identifiers in
+<span class="RktVar">arg-formals</span>, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span> exception is raised. Otherwise,
+<span class="RktSym">args</span> clause&rsquo;s <span class="RktVar">body</span>s are evaluated to handle the
+leftover arguments, and the result of the last <span class="RktVar">body</span> is the
+result of the <span class="RktSym"><a href="Command-Line_Parsing.html#%28form._%28%28lib._racket%2Fcmdline..rkt%29._command-line%29%29" class="RktStxLink" data-pltdoc="x">command-line</a></span> expression.</p></li><li><p>A <span class="RktPn">#:handlers</span> finish clause escapes to a more general
+method of handling the leftover arguments. In this case, the values
+of the expressions are used like the last two to four arguments
+<span class="RktSym"><a href="Command-Line_Parsing.html#%28def._%28%28lib._racket%2Fcmdline..rkt%29._parse-command-line%29%29" class="RktValLink" data-pltdoc="x">parse-command-line</a></span>.</p></li></ul><p>Example:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">verbose-mode</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._make-parameter%29%29" class="RktValLink" data-pltdoc="x">make-parameter</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">profiling-on</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._make-parameter%29%29" class="RktValLink" data-pltdoc="x">make-parameter</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">optimize-level</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._make-parameter%29%29" class="RktValLink" data-pltdoc="x">make-parameter</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">link-flags</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._make-parameter%29%29" class="RktValLink" data-pltdoc="x">make-parameter</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">file-to-compile</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Command-Line_Parsing.html#%28form._%28%28lib._racket%2Fcmdline..rkt%29._command-line%29%29" class="RktStxLink" data-pltdoc="x">command-line</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:program</span><span class="hspace">&nbsp;</span><span class="RktVal">"compiler"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:once-each</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">"-v"</span><span class="hspace">&nbsp;</span><span class="RktVal">"--verbose"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"Compile with verbose messages"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">verbose-mode</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">"-p"</span><span class="hspace">&nbsp;</span><span class="RktVal">"--profile"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"Compile with profiling"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">profiling-on</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:once-any</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">"-o"</span><span class="hspace">&nbsp;</span><span class="RktVal">"--optimize-1"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"Compile with optimization level 1"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">optimize-level</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVal">"--optimize-2"</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">show help on separate lines</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"Compile with optimization level 2,"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"which includes all of level 1"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">optimize-level</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:multi</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">"-l"</span><span class="hspace">&nbsp;</span><span class="RktVal">"--link-flags"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">lf</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">flag takes one argument</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"Add a flag &lt;lf&gt; for the linker"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">link-flags</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lf</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">link-flags</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:args</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">filename</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">expect one command-line argument: &lt;filename&gt;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">return the argument as a filename to compile</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">filename</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/cmdline..rkt)._parse-command-line))"></a><span title="Provided from: racket/cmdline, racket | Package: base"><span class="RktSym"><a href="Command-Line_Parsing.html#%28def._%28%28lib._racket%2Fcmdline..rkt%29._parse-command-line%29%29" class="RktValDef RktValLink" data-pltdoc="x">parse-command-line</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">argv</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">table</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">finish-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arg-help-strs</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">help-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">unknown-proc</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">argv</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vectorof%29%29" class="RktValLink" data-pltdoc="x">vectorof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">table</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">finish-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg-help-strs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">help-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">str</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">unknown-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">str</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Parses a command-line using the specification in <span class="RktVar">table</span>. For
+an overview of command-line parsing, see the <span class="RktSym"><a href="Command-Line_Parsing.html#%28form._%28%28lib._racket%2Fcmdline..rkt%29._command-line%29%29" class="RktStxLink" data-pltdoc="x">command-line</a></span>
+form, which provides a more convenient notation for most purposes.</div></p><p>The <span class="RktVar">table</span> argument to this procedural form encodes the
+information in <span class="RktSym"><a href="Command-Line_Parsing.html#%28form._%28%28lib._racket%2Fcmdline..rkt%29._command-line%29%29" class="RktStxLink" data-pltdoc="x">command-line</a></span>&rsquo;s clauses, except for the
+<span class="RktSym">args</span> clause.  Instead, arguments are handled by the
+<span class="RktVar">finish-proc</span> procedure, and help information about non-flag
+arguments is provided in <span class="RktVar">arg-help-strs</span>. In addition, the
+<span class="RktVar">finish-proc</span> procedure receives information accumulated while
+parsing flags. The <span class="RktVar">help-proc</span> and <span class="RktVar">unknown-proc</span>
+arguments allow customization that is not possible with
+<span class="RktSym"><a href="Command-Line_Parsing.html#%28form._%28%28lib._racket%2Fcmdline..rkt%29._command-line%29%29" class="RktStxLink" data-pltdoc="x">command-line</a></span>.</p><p>When there are no more flags, <span class="RktVar">finish-proc</span> is called with a
+list of information accumulated for command-line flags (see below) and
+the remaining non-flag arguments from the command-line. The arity of
+<span class="RktVar">finish-proc</span> determines the number of non-flag arguments
+accepted and required from the command-line. For example, if
+<span class="RktVar">finish-proc</span> accepts either two or three arguments, then
+either one or two non-flag arguments must be provided on the
+command-line. The <span class="RktVar">finish-proc</span> procedure can have any arity
+(see <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-arity</a></span>) except <span class="RktVal">0</span> or a list of
+<span class="RktVal">0</span>s (i.e., the procedure must at least accept one or more
+arguments).</p><p>The <span class="RktVar">arg-help-strs</span> argument is a list of strings identifying
+the expected (non-flag) command-line arguments, one for each
+argument. If an arbitrary number of arguments are allowed, the last
+string in <span class="RktVar">arg-help-strs</span> represents all of them.</p><p>The <span class="RktVar">help-proc</span> procedure is called with a help string if the
+<span class="nobreak"><span class="stt">-h</span></span> or <span class="nobreak"><span class="stt">--help</span></span> flag is included on the command line.  If an
+unknown flag is encountered, the <span class="RktVar">unknown-proc</span> procedure is
+called just like a flag-handling procedure (as described below); it
+must at least accept one argument (the unknown flag), but it may also
+accept more arguments. The default <span class="RktVar">help-proc</span> displays the
+string and exits and the default <span class="RktVar">unknown-proc</span> raises the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span> exception.</p><p>A <span class="RktVar">table</span> is a list of flag specification sets. Each set is
+represented as a pair of two items: a mode symbol and a list of either
+help strings or flag specifications.  A mode symbol is one of
+<span class="RktVal">'</span><span class="RktVal">once-each</span>, <span class="RktVal">'</span><span class="RktVal">once-any</span>, <span class="RktVal">'</span><span class="RktVal">multi</span>,
+<span class="RktVal">'</span><span class="RktVal">final</span>, <span class="RktVal">'</span><span class="RktVal">help-labels</span>, <span class="RktVal">'</span><span class="RktVal">usage-help</span>, or
+<span class="RktVal">'</span><span class="RktVal">ps</span> with the same meanings as the corresponding clause tags
+in <span class="RktSym"><a href="Command-Line_Parsing.html#%28form._%28%28lib._racket%2Fcmdline..rkt%29._command-line%29%29" class="RktStxLink" data-pltdoc="x">command-line</a></span>. For the <span class="RktVal">'</span><span class="RktVal">help-labels</span>,
+<span class="RktVal">'</span><span class="RktVal">usage-help</span> or <span class="RktVal">'</span><span class="RktVal">ps</span> mode, a list of help strings is
+provided. For the other modes, a list of flag specifications is
+provided, where each specification maps a number of flags to a single
+handler procedure. A specification is a list of three items:</p><ul><li><p>A list of strings for the flags defined by the spec. See
+<span class="RktSym"><a href="Command-Line_Parsing.html#%28form._%28%28lib._racket%2Fcmdline..rkt%29._command-line%29%29" class="RktStxLink" data-pltdoc="x">command-line</a></span> for information about the format of flag
+strings.</p></li><li><p>A procedure to handle the flag and its arguments when one of
+the flags is found on the command line. The arity of this handler
+procedure determines the number of arguments consumed by the flag:
+the handler procedure is called with a flag string plus the next few
+arguments from the command line to match the arity of the handler
+procedure. The handler procedure must accept at least one argument to
+receive the flag. If the handler accepts arbitrarily many arguments,
+all of the remaining arguments are passed to the handler.  A handler
+procedure&rsquo;s arity must either be a number or an
+<span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span> value.</p><p>The return value from the handler is added to a list that is
+eventually passed to <span class="RktVar">finish-proc</span>. If the handler returns
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>, no value is added onto this list. For all
+non-<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a> values returned by handlers, the order of the
+values in the list is the same as the order of the arguments on the
+command-line.</p></li><li><p>A non-empty list for constructing help information for the
+spec. The first element of the list describes the flag; it can be a
+string or a non-empty list of strings, and in the latter case, each
+string is shown on its own line. Additional elements of the main
+list must be strings to name the expected arguments for the flag. The
+number of extra help strings provided for a spec must match the
+number of arguments accepted by the spec&rsquo;s handler procedure.</p></li></ul><p>The following example is the same as the core example for
+<span class="RktSym"><a href="Command-Line_Parsing.html#%28form._%28%28lib._racket%2Fcmdline..rkt%29._command-line%29%29" class="RktStxLink" data-pltdoc="x">command-line</a></span>, translated to the procedural form:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Command-Line_Parsing.html#%28def._%28%28lib._racket%2Fcmdline..rkt%29._parse-command-line%29%29" class="RktValLink" data-pltdoc="x">parse-command-line</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"compile"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._current-command-line-arguments%29%29" class="RktValLink" data-pltdoc="x">current-command-line-arguments</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">once-each</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">[</span><span class="RktVal">(</span><span class="RktVal">"-v"</span><span class="hspace">&nbsp;</span><span class="RktVal">"--verbose"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">,</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">flag</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">verbose-mode</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">(</span><span class="RktVal">"Compile with verbose messages"</span><span class="RktVal">)</span><span class="RktVal">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">[</span><span class="RktVal">(</span><span class="RktVal">"-p"</span><span class="hspace">&nbsp;</span><span class="RktVal">"--profile"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">,</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">flag</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">profiling-on</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">(</span><span class="RktVal">"Compile with profiling"</span><span class="RktVal">)</span><span class="RktVal">]</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">(</span><span class="RktVal">once-any</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">[</span><span class="RktVal">(</span><span class="RktVal">"-o"</span><span class="hspace">&nbsp;</span><span class="RktVal">"--optimize-1"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">,</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">flag</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">optimize-level</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">(</span><span class="RktVal">"Compile with optimization level 1"</span><span class="RktVal">)</span><span class="RktVal">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">[</span><span class="RktVal">(</span><span class="RktVal">"--optimize-2"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">,</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">flag</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">optimize-level</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">"Compile with optimization level 2,"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"which implies all optimizations of level 1"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktVal">]</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">(</span><span class="RktVal">multi</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">[</span><span class="RktVal">(</span><span class="RktVal">"-l"</span><span class="hspace">&nbsp;</span><span class="RktVal">"--link-flags"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">,</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">flag</span><span class="hspace">&nbsp;</span><span class="RktSym">lf</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">link-flags</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lf</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">link-flags</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">(</span><span class="RktVal">"Add a flag &lt;lf&gt; for the linker"</span><span class="hspace">&nbsp;</span><span class="RktVal">"lf"</span><span class="RktVal">)</span><span class="RktVal">]</span><span class="RktVal">)</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">flag-accum</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._file%29%29" class="RktStxLink" data-pltdoc="x">file</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._file%29%29" class="RktStxLink" data-pltdoc="x">file</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"filename"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="runtime.html" title="backward to &quot;15.8 Environment and Runtime Information&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="os.html" title="up to &quot;15 Operating System&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="os-lib.html" title="forward to &quot;15.10 Additional Operating System Functions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Delayed_Evaluation.html b/clones/docs.racket-lang.org/reference/Delayed_Evaluation.html
new file mode 100644
index 00000000..c881d181
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Delayed_Evaluation.html
@@ -0,0 +1,59 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>10.3&nbsp;Delayed Evaluation</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewselflink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">10.1&nbsp;</td><td><a href="values.html" class="tocviewlink" data-pltdoc="x">Multiple Values</a></td></tr><tr><td align="right">10.2&nbsp;</td><td><a href="exns.html" class="tocviewlink" data-pltdoc="x">Exceptions</a></td></tr><tr><td align="right">10.3&nbsp;</td><td><a href="Delayed_Evaluation.html" class="tocviewselflink" data-pltdoc="x">Delayed Evaluation</a></td></tr><tr><td align="right">10.4&nbsp;</td><td><a href="cont.html" class="tocviewlink" data-pltdoc="x">Continuations</a></td></tr><tr><td align="right">10.5&nbsp;</td><td><a href="contmarks.html" class="tocviewlink" data-pltdoc="x">Continuation Marks</a></td></tr><tr><td align="right">10.6&nbsp;</td><td><a href="breakhandler.html" class="tocviewlink" data-pltdoc="x">Breaks</a></td></tr><tr><td align="right">10.7&nbsp;</td><td><a href="Exiting.html" class="tocviewlink" data-pltdoc="x">Exiting</a></td></tr><tr><td align="right">10.8&nbsp;</td><td><a href="unreachable.html" class="tocviewlink" data-pltdoc="x">Unreachable Expressions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>10.3&nbsp;</td><td><a href="Delayed_Evaluation.html" class="tocviewselflink" data-pltdoc="x">Delayed Evaluation</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">10.3.1&nbsp;</td><td><a href="Delayed_Evaluation.html#%28part._.Additional_.Promise_.Kinds%29" class="tocviewlink" data-pltdoc="x">Additional Promise Kinds</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._promise~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">promise?</span></span></a></td></tr><tr><td><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">delay</span></span></a></td></tr><tr><td><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._lazy%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">lazy</span></span></a></td></tr><tr><td><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">force</span></span></a></td></tr><tr><td><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._promise-forced~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">promise-<wbr></wbr>forced?</span></span></a></td></tr><tr><td><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._promise-running~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">promise-<wbr></wbr>running?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">10.3.1<tt>&nbsp;</tt></span><a href="Delayed_Evaluation.html#%28part._.Additional_.Promise_.Kinds%29" class="tocsubseclink" data-pltdoc="x">Additional Promise Kinds</a></td></tr><tr><td><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fname%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">delay/<span class="mywbr"> &nbsp;</span>name</span></span></a></td></tr><tr><td><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._promise%2Fname~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">promise/<span class="mywbr"> &nbsp;</span>name?</span></span></a></td></tr><tr><td><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fstrict%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">delay/<span class="mywbr"> &nbsp;</span>strict</span></span></a></td></tr><tr><td><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fsync%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">delay/<span class="mywbr"> &nbsp;</span>sync</span></span></a></td></tr><tr><td><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fthread%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">delay/<span class="mywbr"> &nbsp;</span>thread</span></span></a></td></tr><tr><td><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fidle%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">delay/<span class="mywbr"> &nbsp;</span>idle</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="exns.html" title="backward to &quot;10.2 Exceptions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Control Flow&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="cont.html" title="forward to &quot;10.4 Continuations&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Delayed_Evaluation&quot;">10.3<tt>&nbsp;</tt><a name="(part._.Delayed_.Evaluation)"></a><a name="(mod-path._racket/promise)"></a>Delayed Evaluation</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="Delayed_Evaluation.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/promise</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="Delayed_Evaluation.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/promise</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p>A <a name="(tech._promise)"></a><span style="font-style: italic">promise</span> encapsulates an expression to be evaluated on
+demand via <span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span>. After a promise has been <span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span>d,
+every later <span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span> of the promise produces the same result.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/promise..rkt)._promise~3f))"></a><span title="Provided from: racket/promise, racket | Package: base"><span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._promise~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">promise?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a promise, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/promise..rkt)._delay))"></a><span title="Provided from: racket/promise, racket | Package: base"><span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">delay</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Creates a promise that, when <span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span>d, evaluates the
+<span class="RktVar">body</span>s to produce its value.  The result is then cached, so
+further uses of <span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span> produce the cached value immediately.
+This includes multiple values and exceptions.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/promise..rkt)._lazy))"></a><span title="Provided from: racket/promise, racket | Package: base"><span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._lazy%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">lazy</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%29%29" class="RktStxLink" data-pltdoc="x">delay</a></span>, if the last <span class="RktVar">body</span> produces a promise when
+forced, then this promise is <span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span>d, too, to obtain a value.
+In other words, this form creates a composable promise, where the
+computation of its body is &ldquo;attached&rdquo; to the computation of the
+following promise, and a single <span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span> iterates through the
+whole chain, tail-calling each step.</div></p><p>Note that the last <span class="RktVar">body</span> of this form must produce a single
+value, but the value can itself be a <span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%29%29" class="RktStxLink" data-pltdoc="x">delay</a></span> promise that
+returns multiple values.</p><p>The <span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._lazy%29%29" class="RktStxLink" data-pltdoc="x">lazy</a></span> form is useful for implementing lazy libraries and
+languages, where tail calls can be wrapped in a promise.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/promise..rkt)._force))"></a><span title="Provided from: racket/promise, racket | Package: base"><span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValDef RktValLink" data-pltdoc="x">force</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">If <span class="RktVar">v</span> is a promise, then the promise is forced to obtain a
+value. If the promise has not been forced before, then the result is
+recorded in the promise so that future <span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span>s on the promise
+produce the same value (or values). If forcing the promise raises an
+exception, then the exception is similarly recorded so that forcing
+the promise will raise the same exception every time.</div></p><p>If <span class="RktVar">v</span> is <span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span>d again before the original call to
+<span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span> returns, then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span> exception is raised.</p><p>If <span class="RktVar">v</span> is not a promise, then it is returned as the result.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/promise..rkt)._promise-forced~3f))"></a><span title="Provided from: racket/promise, racket | Package: base"><span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._promise-forced~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">promise-forced?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">promise</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">promise</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._promise~3f%29%29" class="RktValLink" data-pltdoc="x">promise?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">promise</span> has been forced.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/promise..rkt)._promise-running~3f))"></a><span title="Provided from: racket/promise, racket | Package: base"><span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._promise-running~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">promise-running?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">promise</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">promise</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._promise~3f%29%29" class="RktValLink" data-pltdoc="x">promise?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">promise</span> is currently being forced.
+(Note that a promise can be either running or forced but not both.)</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Additional_Promise_Kinds&quot;">10.3.1<tt>&nbsp;</tt><a name="(part._.Additional_.Promise_.Kinds)"></a>Additional Promise Kinds</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/promise..rkt)._delay/name))"></a><span title="Provided from: racket/promise, racket | Package: base"><span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fname%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">delay/name</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Creates a &ldquo;call-by-name&rdquo; promise that is similar to
+<span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%29%29" class="RktStxLink" data-pltdoc="x">delay</a></span>-promises, except that the resulting value is not
+cached.  This kind of promise is essentially a thunk that is wrapped
+in a way that <span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span> recognizes.</div></p><p>If a <span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fname%29%29" class="RktStxLink" data-pltdoc="x">delay/name</a></span> promise forces itself, no exception is
+raised, the promise is never considered &ldquo;running&rdquo; or &ldquo;forced&rdquo; in
+the sense of <span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._promise-running~3f%29%29" class="RktValLink" data-pltdoc="x">promise-running?</a></span> and <span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._promise-forced~3f%29%29" class="RktValLink" data-pltdoc="x">promise-forced?</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/promise..rkt)._promise/name~3f))"></a><span title="Provided from: racket/promise, racket | Package: base"><span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._promise%2Fname~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">promise/name?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">promise</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">promise</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">promise</span> is a promise created with <span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fname%29%29" class="RktStxLink" data-pltdoc="x">delay/name</a></span>.
+</div><div class="SIntrapara"><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/promise..rkt)._delay/strict))"></a><span title="Provided from: racket/promise, racket | Package: base"><span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fstrict%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">delay/strict</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Creates a &ldquo;strict&rdquo; promise: it is evaluated immediately, and the
+result is wrapped in a promise value.  Note that the body can evaluate
+to multiple values, and forcing the resulting promise will return these
+values.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/promise..rkt)._delay/sync))"></a><span title="Provided from: racket/promise, racket | Package: base"><span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fsync%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">delay/sync</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Produces a promise where an attempt to <span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span> the promise by a
+thread other than one currently running the promise causes the
+<span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span> to block until a result is available. This kind of
+promise is also a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> for use with
+<span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span>; <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span>ing on the promise does not <span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span>
+it, but merely waits until a value is forced by another thread.
+The <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> is <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</div></p><p>If a promise created by <span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fsync%29%29" class="RktStxLink" data-pltdoc="x">delay/sync</a></span> is forced on a thread that
+is already running the promise, an exception is raised in the same way
+as for promises created with <span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%29%29" class="RktStxLink" data-pltdoc="x">delay</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/promise..rkt)._delay/thread))"></a><span title="Provided from: racket/promise, racket | Package: base"><span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fthread%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">delay/thread</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">body/option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">body/option</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">body</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:group</span><span class="hspace">&nbsp;</span><span class="RktVar">thread-group-expr</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fsync%29%29" class="RktStxLink" data-pltdoc="x">delay/sync</a></span>, but begins the computation immediately on a
+newly created thread. The thread is created under the <a href="threadgroups.html#%28tech._thread._group%29" class="techoutside" data-pltdoc="x"><span class="techinside">thread
+group</span></a> specified by <span class="RktVar">thread-group-expr</span>, which defaults to
+<span class="RktPn">(</span><span class="RktSym"><a href="threadgroups.html#%28def._%28%28quote._~23~25kernel%29._make-thread-group%29%29" class="RktValLink" data-pltdoc="x">make-thread-group</a></span><span class="RktPn">)</span>. A <span class="RktPn">#:group</span> specification can
+appear at most once.</div></p><p>Exceptions raised by the <span class="RktVar">body</span>s are caught as usual and raised
+only when the promise is <span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span>d. Unlike <span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fsync%29%29" class="RktStxLink" data-pltdoc="x">delay/sync</a></span>,
+if the thread running <span class="RktVar">body</span> terminates without producing a result
+or exception, <span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span> of the promise raises an exception (instead
+of blocking).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/promise..rkt)._delay/idle))"></a><span title="Provided from: racket/promise, racket | Package: base"><span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fidle%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">delay/idle</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">body/option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">body/option</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">body</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:wait-for</span><span class="hspace">&nbsp;</span><span class="RktVar">wait-evt-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:work-while</span><span class="hspace">&nbsp;</span><span class="RktVar">while-evt-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:tick</span><span class="hspace">&nbsp;</span><span class="RktVar">tick-secs-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:use</span><span class="hspace">&nbsp;</span><span class="RktVar">use-ratio-expr</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fthread%29%29" class="RktStxLink" data-pltdoc="x">delay/thread</a></span>, but with the following differences:</div></p><ul><li><p>the computation does not start until the event produced by
+<span class="RktVar">wait-evt-expr</span> is ready, where the default is
+<span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._system-idle-evt%29%29" class="RktValLink" data-pltdoc="x">system-idle-evt</a></span><span class="RktPn">)</span>;</p></li><li><p>the computation thread gets to work only when the process is
+otherwise idle as determined by <span class="RktVar">while-evt-expr</span>, which
+also defaults to <span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._system-idle-evt%29%29" class="RktValLink" data-pltdoc="x">system-idle-evt</a></span><span class="RktPn">)</span>;</p></li><li><p>the thread is allowed to run only periodically: out of every
+<span class="RktVar">tick-secs-expr</span> (defaults to <span class="RktVal">0.2</span>) seconds, the
+thread is allowed to run <span class="RktVar">use-ratio-expr</span> (defaults to
+<span class="RktVal">0.12</span>) of the time proportionally; i.e., the thread
+runs for <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="stt"> </span><span class="RktVar">tick-secs-expr</span><span class="stt"> </span><span class="RktVar">use-ratio-expr</span><span class="RktPn">)</span> seconds.</p></li></ul><p>If the promise is <span class="RktSym">forced</span> before the computation is done, it
+runs the rest of the computation immediately without waiting on events
+or periodically restricting evaluation.</p><p>A <span class="RktPn">#:wait-for</span>, <span class="RktPn">#:work-while</span>, <span class="RktPn">#:tick</span>, or
+<span class="RktPn">#:use</span> specification can appear at most once.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="exns.html" title="backward to &quot;10.2 Exceptions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Control Flow&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="cont.html" title="forward to &quot;10.4 Continuations&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Equality.html b/clones/docs.racket-lang.org/reference/Equality.html
new file mode 100644
index 00000000..61268e99
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Equality.html
@@ -0,0 +1,202 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.1&nbsp;Equality</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewselflink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.1&nbsp;</td><td><a href="Equality.html" class="tocviewselflink" data-pltdoc="x">Equality</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1.1&nbsp;</td><td><a href="Equality.html#%28part._model-eq%29" class="tocviewlink" data-pltdoc="x">Object Identity and Comparisons</a></td></tr><tr><td align="right">4.1.2&nbsp;</td><td><a href="Equality.html#%28part._.Equality_and_.Hashing%29" class="tocviewlink" data-pltdoc="x">Equality and Hashing</a></td></tr><tr><td align="right">4.1.3&nbsp;</td><td><a href="Equality.html#%28part._.Implementing_.Equality_for_.Custom_.Types%29" class="tocviewlink" data-pltdoc="x">Implementing Equality for Custom Types</a></td></tr><tr><td align="right">4.1.4&nbsp;</td><td><a href="Equality.html#%28part._.Honest_.Custom_.Equality%29" class="tocviewlink" data-pltdoc="x">Honest Custom Equality</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">equal?</span></span></a></td></tr><tr><td><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">equal-<wbr></wbr>always?</span></span></a></td></tr><tr><td><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eqv?</span></span></a></td></tr><tr><td><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eq?</span></span></a></td></tr><tr><td><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%2Frecur%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">equal?/<span class="mywbr"> &nbsp;</span>recur</span></span></a></td></tr><tr><td><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%2Frecur%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">equal-<wbr></wbr>always?/<span class="mywbr"> &nbsp;</span>recur</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.1.1<tt>&nbsp;</tt></span><a href="Equality.html#%28part._model-eq%29" class="tocsubseclink" data-pltdoc="x">Object Identity and Comparisons</a></td></tr><tr><td><span class="tocsublinknumber">4.1.2<tt>&nbsp;</tt></span><a href="Equality.html#%28part._.Equality_and_.Hashing%29" class="tocsubseclink" data-pltdoc="x">Equality and Hashing</a></td></tr><tr><td><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-hash-code%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">equal-<wbr></wbr>hash-<wbr></wbr>code</span></span></a></td></tr><tr><td><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-secondary-hash-code%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">equal-<wbr></wbr>secondary-<wbr></wbr>hash-<wbr></wbr>code</span></span></a></td></tr><tr><td><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always-hash-code%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">equal-<wbr></wbr>always-<wbr></wbr>hash-<wbr></wbr>code</span></span></a></td></tr><tr><td><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always-secondary-hash-code%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">equal-<wbr></wbr>always-<wbr></wbr>secondary-<wbr></wbr>hash-<wbr></wbr>code</span></span></a></td></tr><tr><td><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq-hash-code%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eq-<wbr></wbr>hash-<wbr></wbr>code</span></span></a></td></tr><tr><td><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv-hash-code%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eqv-<wbr></wbr>hash-<wbr></wbr>code</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.1.3<tt>&nbsp;</tt></span><a href="Equality.html#%28part._.Implementing_.Equality_for_.Custom_.Types%29" class="tocsubseclink" data-pltdoc="x">Implementing Equality for Custom Types</a></td></tr><tr><td><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal%2Bhash%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">gen:<span class="mywbr"> &nbsp;</span>equal+<span class="mywbr"> &nbsp;</span>hash</span></span></a></td></tr><tr><td><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal-mode%2Bhash%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">gen:<span class="mywbr"> &nbsp;</span>equal-<wbr></wbr>mode+<span class="mywbr"> &nbsp;</span>hash</span></span></a></td></tr><tr><td><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._prop~3aequal%2Bhash%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>equal+<span class="mywbr"> &nbsp;</span>hash</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.1.4<tt>&nbsp;</tt></span><a href="Equality.html#%28part._.Honest_.Custom_.Equality%29" class="tocsubseclink" data-pltdoc="x">Honest Custom Equality</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="versionbox"><span class="version">8.6</span></div><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="data.html" title="backward to &quot;4 Datatypes&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="booleans.html" title="forward to &quot;4.2 Booleans&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Equality&quot;">4.1<tt>&nbsp;</tt><a name="(part._.Equality)"></a>Equality</h4><p>Equality is the concept of whether two values are &ldquo;the same.&rdquo; Racket supports
+a few different kinds of equality by default, although <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> is
+preferred for most uses.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._equal~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">equal?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v1</span><span class="hspace">&nbsp;</span><span class="RktVar">v2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Two values are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> if and only if they are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>,
+unless otherwise specified for a particular datatype.</div></p><p>Datatypes with further specification of <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> include
+strings, byte strings, pairs, mutable pairs, vectors, boxes, hash
+tables, and inspectable structures. In the last six cases, equality
+is recursively defined; if both <span class="RktVar">v1</span> and <span class="RktVar">v2</span> contain
+reference cycles, they are equal when the infinite unfoldings of the
+values would be equal. See also <span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal+hash</a></span> and
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._prop~3aimpersonator-of%29%29" class="RktValLink" data-pltdoc="x">prop:impersonator-of</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">no</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">42</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">2.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="RktValLink" data-pltdoc="x">mcons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="RktValLink" data-pltdoc="x">mcons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="RktValLink" data-pltdoc="x">mcons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._integer-~3echar%29%29" class="RktValLink" data-pltdoc="x">integer-&gt;char</a></span><span class="hspace">&nbsp;</span><span class="RktVal">955</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._integer-~3echar%29%29" class="RktValLink" data-pltdoc="x">integer-&gt;char</a></span><span class="hspace">&nbsp;</span><span class="RktVal">955</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._make-string%29%29" class="RktValLink" data-pltdoc="x">make-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">#\z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._make-string%29%29" class="RktValLink" data-pltdoc="x">make-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">#\z</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._equal-always~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">equal-always?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v1</span><span class="hspace">&nbsp;</span><span class="RktVar">v2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Indicates whether <span class="RktVar">v1</span> and <span class="RktVar">v2</span> are equal and will always stay
+ equal independent of <span class="emph">mutations</span>. Generally, for to values to be equal-always, corresponding
+ immutable values within <span class="RktVar">v1</span> and <span class="RktVar">v2</span> must be <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>,
+ while corresponding mutable values within them must be <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>.</div></p><p>Two values <span class="RktVar">v1</span> and <span class="RktVar">v2</span> are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span> if and only
+ if there exists a third value <span class="RktVar">v3</span> such that <span class="RktVar">v1</span> and
+ <span class="RktVar">v2</span> are both chaperones of <span class="RktVar">v3</span>, meaning
+ <span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-of~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-of?</a></span><span class="stt"> </span><span class="RktVar">v1</span><span class="stt"> </span><span class="RktVar">v3</span><span class="RktPn">)</span> and <span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-of~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-of?</a></span><span class="stt"> </span><span class="RktVar">v2</span><span class="stt"> </span><span class="RktVar">v3</span><span class="RktPn">)</span> are both
+ true.</p><p>For values that include no chaperones or other impersonators,
+ <span class="RktVar">v1</span> and <span class="RktVar">v2</span> can be considered equal-always
+ if they are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>, except that corresponding mutable
+ vectors, boxes, hash tables, strings, byte strings, <a href="mpairs.html#%28tech._mutable._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutable pairs</span></a>, and
+ mutable structures within
+ <span class="RktVar">v1</span> and <span class="RktVar">v2</span> must be <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>, and equality on structures
+ can be specialized for <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span> through <span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal-mode%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal-mode+hash</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">no</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">42</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">2.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="RktValLink" data-pltdoc="x">mcons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="RktValLink" data-pltdoc="x">mcons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="RktValLink" data-pltdoc="x">mcons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._integer-~3echar%29%29" class="RktValLink" data-pltdoc="x">integer-&gt;char</a></span><span class="hspace">&nbsp;</span><span class="RktVal">955</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._integer-~3echar%29%29" class="RktValLink" data-pltdoc="x">integer-&gt;char</a></span><span class="hspace">&nbsp;</span><span class="RktVal">955</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._make-string%29%29" class="RktValLink" data-pltdoc="x">make-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">#\z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._make-string%29%29" class="RktValLink" data-pltdoc="x">make-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">#\z</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-~3eimmutable-string%29%29" class="RktValLink" data-pltdoc="x">string-&gt;immutable-string</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._make-string%29%29" class="RktValLink" data-pltdoc="x">make-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">#\z</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-~3eimmutable-string%29%29" class="RktValLink" data-pltdoc="x">string-&gt;immutable-string</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._make-string%29%29" class="RktValLink" data-pltdoc="x">make-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">#\z</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 8.5.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._eqv~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">eqv?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v1</span><span class="hspace">&nbsp;</span><span class="RktVar">v2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Two values are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span> if and only if they are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>,
+unless otherwise specified for a particular datatype.</div></p><p>The <a href="numbers.html#%28tech._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">number</span></a> and <a href="characters.html#%28tech._character%29" class="techoutside" data-pltdoc="x"><span class="techinside">character</span></a> datatypes are the only ones for which
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span> differs from <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>. Two numbers are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span> when
+they have the same exactness, precision, and are both equal and non-zero, both
+<span class="RktVal">+0.0</span>, both <span class="RktVal">+0.0f0</span>, both <span class="RktVal">-0.0</span>,
+both <span class="RktVal">-0.0f0</span>, both <span class="RktVal">+nan.0</span>, or both
+<span class="RktVal">+nan.f</span>&#8212;<wbr></wbr>considering real and imaginary components separately
+in the case of <a href="numbers.html#%28tech._complex._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">complex numbers</span></a>. Two characters are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span> when
+their <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-~3einteger%29%29" class="RktValLink" data-pltdoc="x">char-&gt;integer</a></span> results are equal.</p><p>Generally, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span> is identical to <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> except that the former
+cannot recursively compare the contents of compound data types (such as lists
+and structs) and cannot be customized by user-defined data types. The use of
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span> is lightly discouraged in favor of <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">no</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">42</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">2.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="RktValLink" data-pltdoc="x">mcons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="RktValLink" data-pltdoc="x">mcons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="RktValLink" data-pltdoc="x">mcons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._integer-~3echar%29%29" class="RktValLink" data-pltdoc="x">integer-&gt;char</a></span><span class="hspace">&nbsp;</span><span class="RktVal">955</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._integer-~3echar%29%29" class="RktValLink" data-pltdoc="x">integer-&gt;char</a></span><span class="hspace">&nbsp;</span><span class="RktVal">955</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._make-string%29%29" class="RktValLink" data-pltdoc="x">make-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">#\z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._make-string%29%29" class="RktValLink" data-pltdoc="x">make-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">#\z</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._eq~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">eq?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v1</span><span class="hspace">&nbsp;</span><span class="RktVar">v2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Return <span class="RktVal">#t</span> if <span class="RktVar">v1</span> and <span class="RktVar">v2</span> refer to the same
+object, <span class="RktVal">#f</span> otherwise. As a special case among <a href="numbers.html#%28tech._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">numbers</span></a>,
+two <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnums</span></a> that are <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span> are also the same according
+to <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>. See also <a href="Equality.html#%28part._model-eq%29" data-pltdoc="x">Object Identity and Comparisons</a>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">no</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">42</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">2.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="RktValLink" data-pltdoc="x">mcons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="RktValLink" data-pltdoc="x">mcons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="RktValLink" data-pltdoc="x">mcons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._integer-~3echar%29%29" class="RktValLink" data-pltdoc="x">integer-&gt;char</a></span><span class="hspace">&nbsp;</span><span class="RktVal">955</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._integer-~3echar%29%29" class="RktValLink" data-pltdoc="x">integer-&gt;char</a></span><span class="hspace">&nbsp;</span><span class="RktVal">955</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._make-string%29%29" class="RktValLink" data-pltdoc="x">make-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">#\z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._make-string%29%29" class="RktValLink" data-pltdoc="x">make-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">#\z</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._equal~3f/recur))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%2Frecur%29%29" class="RktValDef RktValLink" data-pltdoc="x">equal?/recur</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v1</span><span class="hspace">&nbsp;</span><span class="RktVar">v2</span><span class="hspace">&nbsp;</span><span class="RktVar">recur-proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">recur-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>, but using <span class="RktVar">recur-proc</span> for recursive
+comparisons (which means that reference cycles are not handled
+automatically). Non-<span class="RktVal">#f</span> results from <span class="RktVar">recur-proc</span> are
+converted to <span class="RktVal">#t</span> before being returned by
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%2Frecur%29%29" class="RktValLink" data-pltdoc="x">equal?/recur</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%2Frecur%29%29" class="RktValLink" data-pltdoc="x">equal?/recur</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%2Frecur%29%29" class="RktValLink" data-pltdoc="x">equal?/recur</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%2Frecur%29%29" class="RktValLink" data-pltdoc="x">equal?/recur</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1.2</span><span class="hspace">&nbsp;</span><span class="RktVal">3/4</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c~3d%29%29" class="RktValLink" data-pltdoc="x">&lt;=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._abs%29%29" class="RktValLink" data-pltdoc="x">abs</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0.25</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._equal-always~3f/recur))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%2Frecur%29%29" class="RktValDef RktValLink" data-pltdoc="x">equal-always?/recur</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v1</span><span class="hspace">&nbsp;</span><span class="RktVar">v2</span><span class="hspace">&nbsp;</span><span class="RktVar">recur-proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">recur-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, but using <span class="RktVar">recur-proc</span> for recursive
+comparisons (which means that reference cycles are not handled
+automatically). Non-<span class="RktVal">#f</span> results from <span class="RktVar">recur-proc</span> are
+converted to <span class="RktVal">#t</span> before being returned by
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%2Frecur%29%29" class="RktValLink" data-pltdoc="x">equal-always?/recur</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%2Frecur%29%29" class="RktValLink" data-pltdoc="x">equal-always?/recur</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%2Frecur%29%29" class="RktValLink" data-pltdoc="x">equal-always?/recur</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%2Frecur%29%29" class="RktValLink" data-pltdoc="x">equal-always?/recur</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-immutable%29%29" class="RktValLink" data-pltdoc="x">vector-immutable</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-immutable%29%29" class="RktValLink" data-pltdoc="x">vector-immutable</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1.2</span><span class="hspace">&nbsp;</span><span class="RktVal">3/4</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c~3d%29%29" class="RktValLink" data-pltdoc="x">&lt;=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._abs%29%29" class="RktValLink" data-pltdoc="x">abs</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0.25</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;model-eq&quot;">4.1.1<tt>&nbsp;</tt><a name="(part._model-eq)"></a>Object Identity and Comparisons</h5><p>The <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> operator compares two <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">values</span></a>, returning
+<span class="RktVal">#t</span> when the values refer to the same <a href="eval-model.html#%28tech._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">object</span></a>. This form
+of equality is suitable for comparing objects that support imperative
+update (e.g., to determine that the effect of modifying an object
+through one reference is visible through another reference). Also, an
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> test evaluates quickly, and <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>-based hashing
+is more lightweight than <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>-based hashing in hash tables.</p><p>In some cases, however, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> is unsuitable as a comparison
+operator, because the generation of <a href="eval-model.html#%28tech._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">objects</span></a> is not clearly
+defined. In particular, two applications of <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span> to the same two
+exact integers may or may not produce results that are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>,
+although the results are always <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>. Similarly, evaluation
+of a <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span> form typically generates a new procedure
+<a href="eval-model.html#%28tech._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">object</span></a>, but it may re-use a procedure <a href="eval-model.html#%28tech._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">object</span></a> previously
+generated by the same source <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span> form.</p><p>The behavior of a datatype with respect to <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> is generally
+specified with the datatype and its associated procedures.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Equality_and_Hashing&quot;">4.1.2<tt>&nbsp;</tt><a name="(part._.Equality_and_.Hashing)"></a>Equality and Hashing</h5><p>All comparable values have at least one <a name="(tech._hash._code)"></a><span style="font-style: italic">hash code</span> &#8212;<wbr></wbr> an arbitrary
+integer (more specifically a <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a>) computed by applying a hash function
+to the value. The defining property of these hash codes is that <span style="font-weight: bold">equal
+values have equal hash codes</span>. Note that the reverse is not true: two unequal
+values can still have equal hash codes. Hash codes are useful for various
+indexing and comparison operations, especially in the implementation of
+<a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash tables</span></a>. See <a href="hashtables.html" data-pltdoc="x">Hash Tables</a> for more information.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._equal-hash-code))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-hash-code%29%29" class="RktValDef RktValLink" data-pltdoc="x">equal-hash-code</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="Equality.html#%28tech._hash._code%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash code</span></a> consistent with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>. For any two calls
+with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> values, the returned number is the same. A hash code is
+computed even when <span class="RktVar">v</span> contains a cycle through pairs, vectors, boxes,
+and/or inspectable structure fields. Additionally, user-defined data types can
+customize how this hash code is computed by implementing
+<span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal+hash</a></span> or <span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal-mode%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal-mode+hash</a></span>.</div></p><p>For any <span class="RktVar">v</span> that could be produced by <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>, if <span class="RktSym">v2</span> is
+produced by <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> for the same input characters, the
+<span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-hash-code</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span> is the same as <span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-hash-code</a></span><span class="stt"> </span><span class="RktSym">v2</span><span class="RktPn">)</span> &#8212;<wbr></wbr>
+even if <span class="RktVar">v</span> and <span class="RktSym">v2</span> do not exist at the same time (and therefore
+could not be compared by calling <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>).</p><p class="SHistory">Changed in version 6.4.0.12 of package <span class="stt">base</span>: Strengthened guarantee for <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>able values.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._equal-secondary-hash-code))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-secondary-hash-code%29%29" class="RktValDef RktValLink" data-pltdoc="x">equal-secondary-hash-code</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-hash-code</a></span>, but computes a secondary <a href="Equality.html#%28tech._hash._code%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash code</span></a>
+suitable for use in double hashing.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._equal-always-hash-code))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always-hash-code%29%29" class="RktValDef RktValLink" data-pltdoc="x">equal-always-hash-code</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="Equality.html#%28tech._hash._code%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash code</span></a> consistent with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>. For any two
+calls with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span> values, the returned number is the same.</div></p><p>As <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-always-hash-code</a></span> traverses <span class="RktVar">v</span>, immutable
+values within <span class="RktVar">v</span> are hashed with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-hash-code</a></span>,
+while mutable values within <span class="RktVar">v</span> are hashed with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq-hash-code%29%29" class="RktValLink" data-pltdoc="x">eq-hash-code</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._equal-always-secondary-hash-code))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always-secondary-hash-code%29%29" class="RktValDef RktValLink" data-pltdoc="x">equal-always-secondary-hash-code</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-always-hash-code</a></span>, but computes a secondary <a href="Equality.html#%28tech._hash._code%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash code</span></a>
+suitable for use in double hashing.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._eq-hash-code))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq-hash-code%29%29" class="RktValDef RktValLink" data-pltdoc="x">eq-hash-code</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="Equality.html#%28tech._hash._code%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash code</span></a> consistent with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>. For any two calls with
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> values, the returned number is the same.</div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Equal <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnums</span></a> are always <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._eqv-hash-code))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv-hash-code%29%29" class="RktValDef RktValLink" data-pltdoc="x">eqv-hash-code</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="Equality.html#%28tech._hash._code%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash code</span></a> consistent with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>. For any two calls
+with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span> values, the returned number is the same.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Implementing_Equality_for_Custom_Types&quot;">4.1.3<tt>&nbsp;</tt><a name="(part._.Implementing_.Equality_for_.Custom_.Types)"></a>Implementing Equality for Custom Types</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/private/base..rkt)._gen~3aequal+hash))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal%2Bhash%29%29" class="RktValDef RktValLink" data-pltdoc="x">gen:equal+hash</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="struct-generics.html#%28tech._generic._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">generic interface</span></a> (see <a href="struct-generics.html" data-pltdoc="x">Generic Interfaces</a>) for types that can
+be compared for equality using <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>. The following methods must be
+implemented:</div></p><ul><li><p><span class="RktVar">equal-proc</span><span class="stt"> </span><span class="RktSym">:</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span> &#8212;<wbr></wbr>
+tests whether the first two arguments are equal, where both values are
+instances of the structure type to which the generic interface is associated
+(or a subtype of the structure type).</p><p>The third argument is an <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>  predicate to use for
+recursive equality checks; use the given predicate instead of
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to ensure that data cycles are handled
+properly and to work with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%2Frecur%29%29" class="RktValLink" data-pltdoc="x">equal?/recur</a></span> (but beware
+that an arbitrary function can be provided to
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%2Frecur%29%29" class="RktValLink" data-pltdoc="x">equal?/recur</a></span> for recursive checks, which means that
+arguments provided to the predicate might be exposed to
+arbitrary code).</p><p>The <span class="RktVar">equal-proc</span> is called for a pair of structures
+only when they are not <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>, and only when they both
+have a <span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal+hash</a></span> value inherited from the same
+structure type. With this strategy, the order in which
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> receives two structures does not matter. It
+also means that, by default, a structure sub-type inherits the
+equality predicate of its parent, if any.</p></li><li><p><span class="RktVar">hash-proc</span><span class="stt"> </span><span class="RktSym">:</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span> &#8212;<wbr></wbr>
+computes a hash code for the given structure, like <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-hash-code</a></span>.
+The first argument is an instance of the structure type (or one of its
+subtypes) to which the generic interface is associated.</p><p>The second argument is an <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-hash-code</a></span>-like procedure to use for
+recursive hash-code computation; use the given procedure instead of
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-hash-code</a></span> to ensure that data cycles are handled properly.</p><p>Although the result of <span class="RktVar">hash-proc</span> can be any exact
+integer, it will be truncated for most purposes to a <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a>
+(e.g., for the result of <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-hash-code</a></span>). Roughly,
+truncation uses <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-and%29%29" class="RktValLink" data-pltdoc="x">bitwise-and</a></span> to take the lower bits of the
+number. Thus, variation in the hash-code computation should be
+reflected in the fixnum-compatible bits of <span class="RktVar">hash-proc</span>&rsquo;s
+result. Consumers of a hash code are expected to use variation
+within the fixnum range appropriately, and producers are <span class="emph">not</span>
+responsible to reflect variation in hash codes across the full
+range of bits that fit within a fixnum.</p></li><li><p><span class="RktVar">hash2-proc</span><span class="stt"> </span><span class="RktSym">:</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span> &#8212;<wbr></wbr>
+computes a secondary hash code for the given structure. This procedure is
+like <span class="RktVar">hash-proc</span>, but analogous to
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-secondary-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-secondary-hash-code</a></span>.</p></li></ul><p>Take care to ensure that <span class="RktVar">hash-proc</span> and <span class="RktVar">hash2-proc</span>
+are consistent with <span class="RktVar">equal-proc</span>. Specifically,
+<span class="RktVar">hash-proc</span> and <span class="RktVar">hash2-proc</span> should produce the same
+value for any two structures for which <span class="RktVar">equal-proc</span> produces a
+true value.</p><p>The <span class="RktVar">equal-proc</span> is not only used for
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>, it is also used for <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%2Frecur%29%29" class="RktValLink" data-pltdoc="x">equal?/recur</a></span>,
+and <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span>. Furthermore, if the structure type
+has no mutable fields, <span class="RktVar">equal-proc</span> is used for <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, and
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-of~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-of?</a></span>. Likewise <span class="RktVar">hash-proc</span> and
+<span class="RktVar">hash2-proc</span> are used for
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-always-hash-code</a></span> and
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always-secondary-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-always-secondary-hash-code</a></span>, respectively, when
+the structure type has no mutable fields.
+Instances of these methods should follow the guidelines in
+<a href="Equality.html#%28part._.Honest_.Custom_.Equality%29" data-pltdoc="x">Honest Custom Equality</a> to implement all of these
+operations reasonably. In particular, these methods should
+not access mutable data unless the struct is declared
+mutable.</p><p>When a structure type has no <span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal+hash</a></span> or
+<span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal-mode%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal-mode+hash</a></span> implementation, then
+transparent structures (i.e., structures with an <a href="inspectors.html#%28tech._inspector%29" class="techoutside" data-pltdoc="x"><span class="techinside">inspector</span></a> that
+is controlled by the current <a href="inspectors.html#%28tech._inspector%29" class="techoutside" data-pltdoc="x"><span class="techinside">inspector</span></a>) are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>
+when they are instances of the same structure type (not counting
+sub-types), and when they have <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> field values.  For
+transparent structures, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-hash-code</a></span> and
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-secondary-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-secondary-hash-code</a></span> (in the case of no mutable fields)
+derive hash code using the field
+values. For a transparent structure type with at least one mutable field,
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span> is the same as <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>, and an
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-secondary-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-secondary-hash-code</a></span> result is based only on <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq-hash-code%29%29" class="RktValLink" data-pltdoc="x">eq-hash-code</a></span>.
+For opaque structure types, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> is the same as
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>, and <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-hash-code</a></span> and
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-secondary-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-secondary-hash-code</a></span> results are based only on
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq-hash-code%29%29" class="RktValLink" data-pltdoc="x">eq-hash-code</a></span>. If a structure has a <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._prop~3aimpersonator-of%29%29" class="RktValLink" data-pltdoc="x">prop:impersonator-of</a></span>
+property, then the <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._prop~3aimpersonator-of%29%29" class="RktValLink" data-pltdoc="x">prop:impersonator-of</a></span> property takes precedence over
+<span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal+hash</a></span> if the property value&rsquo;s procedure returns a
+non-<span class="RktVal">#f</span> value when applied to the structure.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">farm=?</span><span class="hspace">&nbsp;</span><span class="RktSym">farm1</span><span class="hspace">&nbsp;</span><span class="RktSym">farm2</span><span class="hspace">&nbsp;</span><span class="RktSym">recursive-equal?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">farm-apples</span><span class="hspace">&nbsp;</span><span class="RktSym">farm1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">farm-apples</span><span class="hspace">&nbsp;</span><span class="RktSym">farm2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">farm-oranges</span><span class="hspace">&nbsp;</span><span class="RktSym">farm1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">farm-oranges</span><span class="hspace">&nbsp;</span><span class="RktSym">farm2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">farm-sheep</span><span class="hspace">&nbsp;</span><span class="RktSym">farm1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">farm-sheep</span><span class="hspace">&nbsp;</span><span class="RktSym">farm2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">farm-hash-code</span><span class="hspace">&nbsp;</span><span class="RktSym">farm</span><span class="hspace">&nbsp;</span><span class="RktSym">recursive-equal-hash</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10000</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">farm-apples</span><span class="hspace">&nbsp;</span><span class="RktSym">farm</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">farm-oranges</span><span class="hspace">&nbsp;</span><span class="RktSym">farm</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">farm-sheep</span><span class="hspace">&nbsp;</span><span class="RktSym">farm</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">farm-secondary-hash-code</span><span class="hspace">&nbsp;</span><span class="RktSym">farm</span><span class="hspace">&nbsp;</span><span class="RktSym">recursive-equal-hash</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10000</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">farm-sheep</span><span class="hspace">&nbsp;</span><span class="RktSym">farm</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">farm-apples</span><span class="hspace">&nbsp;</span><span class="RktSym">farm</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">farm-oranges</span><span class="hspace">&nbsp;</span><span class="RktSym">farm</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">farm</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">apples</span><span class="hspace">&nbsp;</span><span class="RktSym">oranges</span><span class="hspace">&nbsp;</span><span class="RktSym">sheep</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal+hash</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">equal-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">farm=?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hash-proc</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">farm-hash-code</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hash2-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">farm-secondary-hash-code</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eastern-farm</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">farm</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">western-farm</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">farm</span><span class="hspace">&nbsp;</span><span class="RktVal">18</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">14</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">northern-farm</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">farm</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">southern-farm</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">farm</span><span class="hspace">&nbsp;</span><span class="RktVal">18</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">14</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eastern-farm</span><span class="hspace">&nbsp;</span><span class="RktSym">western-farm</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eastern-farm</span><span class="hspace">&nbsp;</span><span class="RktSym">northern-farm</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">western-farm</span><span class="hspace">&nbsp;</span><span class="RktSym">southern-farm</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/private/base..rkt)._gen~3aequal-mode+hash))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal-mode%2Bhash%29%29" class="RktValDef RktValLink" data-pltdoc="x">gen:equal-mode+hash</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="struct-generics.html#%28tech._generic._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">generic interface</span></a> (see <a href="struct-generics.html" data-pltdoc="x">Generic Interfaces</a>) for types that
+ may specify differences between <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> and <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>.
+ The following methods must be implemented:</div></p><ul><li><p><span class="RktVar">equal-mode-proc</span><span class="stt"> </span><span class="RktSym">:</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span> &#8212;<wbr></wbr>
+the first two arguments are the values to compare, the third argument is an
+equality function to use for recursive comparisons, and the last argument is
+the mode: <span class="RktVal">#t</span> for an <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> or <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span>
+comparison or <span class="RktVal">#f</span> for an <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span> or
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-of~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-of?</a></span> comparison.</p></li><li><p><span class="RktVar">hash-mode-proc</span><span class="stt"> </span><span class="RktSym">:</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span> &#8212;<wbr></wbr>
+the first argument is the value to compute a hash code for, the second
+argument is a hashing function to use for recursive hashing, and the last
+argument is the mode: <span class="RktVal">#t</span> for <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> hashing or <span class="RktVal">#f</span>
+for <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span> hashing.</p></li></ul><p>The <span class="RktVar">hash-mode-proc</span> implementation is used both for a
+ primary hash code and secondary hash code.</p><p>When implementing these methods, follow the guidelines in
+ <a href="Equality.html#%28part._.Honest_.Custom_.Equality%29" data-pltdoc="x">Honest Custom Equality</a>. In particular, these
+ methods should only access mutable data if the &ldquo;mode&rdquo; argument
+ is true to indicate <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> or <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span>.</p><p><div class="SIntrapara">Implementing <span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal-mode%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal-mode+hash</a></span> is most useful for types that
+ specify differences between <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> and <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, such
+ as a structure type that wraps mutable data with getter and setter procedures:
+ </div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get</span><span class="hspace">&nbsp;</span><span class="RktSym">gs</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">getset-getter</span><span class="hspace">&nbsp;</span><span class="RktSym">gs</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktSym">gs</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">getset-setter</span><span class="hspace">&nbsp;</span><span class="RktSym">gs</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">getset</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">getter</span><span class="hspace">&nbsp;</span><span class="RktSym">setter</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal-mode%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal-mode+hash</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">equal-mode-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="hspace">&nbsp;</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktSym">mode</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mode</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hash-mode-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="hspace">&nbsp;</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktSym">mode</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mode</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq-hash-code%29%29" class="RktValLink" data-pltdoc="x">eq-hash-code</a></span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">gsx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">getset</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">gsy</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">getset</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">gsx</span><span class="hspace">&nbsp;</span><span class="RktSym">gsy</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">gsx</span><span class="hspace">&nbsp;</span><span class="RktSym">gsy</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktSym">gsx</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktSym">gsy</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">gsx</span><span class="hspace">&nbsp;</span><span class="RktSym">gsy</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">gsx</span><span class="hspace">&nbsp;</span><span class="RktSym">gsy</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">gsx</span><span class="hspace">&nbsp;</span><span class="RktSym">gsx</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p></div></p><p class="SHistory">Added in version 8.5.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._prop~3aequal+hash))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._prop~3aequal%2Bhash%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:equal+hash</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property</span></a> (see <a href="structprops.html" data-pltdoc="x">Structure Type Properties</a>)
+ that supplies an equality predicate and hashing functions for a structure
+ type. Using the <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._prop~3aequal%2Bhash%29%29" class="RktValLink" data-pltdoc="x">prop:equal+hash</a></span> property is an alternative to
+ using the <span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal+hash</a></span> or <span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal-mode%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal-mode+hash</a></span>
+ <a href="struct-generics.html#%28tech._generic._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">generic interface</span></a>.</div></p><p>A <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._prop~3aequal%2Bhash%29%29" class="RktValLink" data-pltdoc="x">prop:equal+hash</a></span> property value is a list of either three
+ procedures <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVar">equal-proc</span><span class="stt"> </span><span class="RktVar">hash-proc</span><span class="stt"> </span><span class="RktVar">hash2-proc</span><span class="RktPn">)</span> or two
+ procedures <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVar">equal-mode-proc</span><span class="stt"> </span><span class="RktVar">hash-mode-proc</span><span class="RktPn">)</span>:</p><ul><li><p>The three-procedure case corresponds to the procedures of
+<span class="RktSym">gen:equal-hash</span>:</p><ul><li><p><span class="RktVar">equal-proc</span><span class="stt"> </span><span class="RktSym">:</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></li><li><p><span class="RktVar">hash-proc</span><span class="stt"> </span><span class="RktSym">:</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span></p></li><li><p><span class="RktVar">hash2-proc</span><span class="stt"> </span><span class="RktSym">:</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span></p></li></ul></li><li><p>The two-procedure case corresponds to the procedures of
+<span class="RktSym">gen:equal-mode-hash</span>:</p><ul><li><p><span class="RktVar">equal-mode-proc</span><span class="stt"> </span><span class="RktSym">:</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></li><li><p><span class="RktVar">hash-mode-proc</span><span class="stt"> </span><span class="RktSym">:</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span></p></li></ul></li></ul><p>When implementing these methods, follow the guidelines in
+<a href="Equality.html#%28part._.Honest_.Custom_.Equality%29" data-pltdoc="x">Honest Custom Equality</a>. In particular, these
+methods should only access mutable data if the struct is
+declared mutable or the mode is true.</p><p class="SHistory">Changed in version 8.5.0.3 of package <span class="stt">base</span>: Added support for two-procedure values to customize <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Honest_Custom_Equality&quot;">4.1.4<tt>&nbsp;</tt><a name="(part._.Honest_.Custom_.Equality)"></a>Honest Custom Equality</h5><p>Since the <span class="RktVar">equal-proc</span> or <span class="RktVar">equal-mode-proc</span>
+is used for more than just <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>, instances of
+them should follow certain guidelines to make sure that they work
+correctly for <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-of~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-of?</a></span>,
+and <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span>.</p><p>Due to the differences between these operations, avoid
+calling <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> within them. Instead, use the third
+argument to &ldquo;recur&rdquo; on the pieces, which allows
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%2Frecur%29%29" class="RktValLink" data-pltdoc="x">equal?/recur</a></span> to work properly, lets the other
+operations behave in their own distinct ways on the pieces,
+and enables some cycle detection.</p><p><table cellspacing="0" cellpadding="0" border="1" cellpadding="1"><tr><td width="500" align="left" valign="top"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">good</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">equal-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="hspace">&nbsp;</span><span class="RktSym">rec</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish-size</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish-size</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></td><td width="500" align="left" valign="top"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">bad</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">equal-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="hspace">&nbsp;</span><span class="RktSym">rec</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish-size</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish-size</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></td></tr></table></p><p>The operations <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> and <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>
+should be symmetric, so <span class="RktVar">equal-proc</span> instances
+should not change their answer when the arguments swap:</p><p><table cellspacing="0" cellpadding="0" border="1" cellpadding="1"><tr><td width="500" align="left" valign="top"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">good</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">equal-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="hspace">&nbsp;</span><span class="RktSym">rec</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish-size</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish-size</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></td><td width="500" align="left" valign="top"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">bad</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">equal-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="hspace">&nbsp;</span><span class="RktSym">rec</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c~3d%29%29" class="RktValLink" data-pltdoc="x">&lt;=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish-size</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish-size</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></td></tr></table></p><p>However, the operations <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-of~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-of?</a></span> and
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span> are <span class="emph">not</span> symmetric, so when
+calling the third argument to &ldquo;recur&rdquo; on pieces, pass the
+pieces in the same order they came in:</p><p><table cellspacing="0" cellpadding="0" border="1" cellpadding="1"><tr><td width="500" align="left" valign="top"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">good</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">equal-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="hspace">&nbsp;</span><span class="RktSym">rec</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish-size</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish-size</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></td><td width="500" align="left" valign="top"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">bad</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">equal-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="hspace">&nbsp;</span><span class="RktSym">rec</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish-size</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish-size</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></td></tr></table></p><p>Mutable structs will only use the custom equality for
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> and <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span>, so that
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span> and <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-of~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-of?</a></span> don&rsquo;t
+change on mutation. Structs that represent mutable data
+should either be declared mutable, or use
+<span class="RktVar">equal-mode-proc</span> from <span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal-mode%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal-mode+hash</a></span>
+instead of <span class="RktVar">equal-proc</span> from <span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal+hash</a></span>,
+and only access mutable data when the mode is true:</p><p><table cellspacing="0" cellpadding="0" border="1" cellpadding="1"><tr><td width="500" align="left" valign="top"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">good</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mcell</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">value</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mutable</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal+hash</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">equal-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="hspace">&nbsp;</span><span class="RktSym">rec</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mcell-value</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mcell-value</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hash-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="hspace">&nbsp;</span><span class="RktSym">rec</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq-hash-code%29%29" class="RktValLink" data-pltdoc="x">eq-hash-code</a></span><span class="hspace">&nbsp;</span><span class="RktSym">struct:mcell</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mcell-value</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hash2-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="hspace">&nbsp;</span><span class="RktSym">rec</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq-hash-code%29%29" class="RktValLink" data-pltdoc="x">eq-hash-code</a></span><span class="hspace">&nbsp;</span><span class="RktSym">struct:mcell</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mcell-value</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></td><td width="500" align="left" valign="top"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">bad</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mcell</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValLink" data-pltdoc="x">box</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">not declared mutable,</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">but represents mutable data anyway</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal+hash</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">equal-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="hspace">&nbsp;</span><span class="RktSym">rec</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="RktValLink" data-pltdoc="x">unbox</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mcell-box</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="RktValLink" data-pltdoc="x">unbox</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mcell-box</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hash-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="hspace">&nbsp;</span><span class="RktSym">rec</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq-hash-code%29%29" class="RktValLink" data-pltdoc="x">eq-hash-code</a></span><span class="hspace">&nbsp;</span><span class="RktSym">struct:mcell</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="RktValLink" data-pltdoc="x">unbox</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mcell-value</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hash2-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="hspace">&nbsp;</span><span class="RktSym">rec</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq-hash-code%29%29" class="RktValLink" data-pltdoc="x">eq-hash-code</a></span><span class="hspace">&nbsp;</span><span class="RktSym">struct:mcell</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="RktValLink" data-pltdoc="x">unbox</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mcell-value</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></td></tr></table></p><p><table cellspacing="0" cellpadding="0" border="1" cellpadding="1"><tr><td width="500" align="left" valign="top"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">also good</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mcell</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">value</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mutable</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">only accesses mutable data when mode is true</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal-mode%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal-mode+hash</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">equal-mode-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="hspace">&nbsp;</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktSym">mode</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mode</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mcell-value</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mcell-value</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hash-mode-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="hspace">&nbsp;</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktSym">mode</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mode</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq-hash-code%29%29" class="RktValLink" data-pltdoc="x">eq-hash-code</a></span><span class="hspace">&nbsp;</span><span class="RktSym">struct:mcell</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mcell-value</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq-hash-code%29%29" class="RktValLink" data-pltdoc="x">eq-hash-code</a></span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></td><td width="500" align="left" valign="top"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">still bad</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mcell</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">value</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mutable</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">accesses mutable data ignoring mode</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal-mode%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal-mode+hash</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">equal-mode-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="hspace">&nbsp;</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktSym">mode</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mcell-value</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mcell-value</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hash-mode-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="hspace">&nbsp;</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktSym">mode</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq-hash-code%29%29" class="RktValLink" data-pltdoc="x">eq-hash-code</a></span><span class="hspace">&nbsp;</span><span class="RktSym">struct:mcell</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rec</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mcell-value</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></td></tr></table></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="data.html" title="backward to &quot;4 Datatypes&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="booleans.html" title="forward to &quot;4.2 Booleans&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Exiting.html b/clones/docs.racket-lang.org/reference/Exiting.html
new file mode 100644
index 00000000..3f0c0d62
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Exiting.html
@@ -0,0 +1,19 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>10.7&nbsp;Exiting</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewselflink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">10.1&nbsp;</td><td><a href="values.html" class="tocviewlink" data-pltdoc="x">Multiple Values</a></td></tr><tr><td align="right">10.2&nbsp;</td><td><a href="exns.html" class="tocviewlink" data-pltdoc="x">Exceptions</a></td></tr><tr><td align="right">10.3&nbsp;</td><td><a href="Delayed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Delayed Evaluation</a></td></tr><tr><td align="right">10.4&nbsp;</td><td><a href="cont.html" class="tocviewlink" data-pltdoc="x">Continuations</a></td></tr><tr><td align="right">10.5&nbsp;</td><td><a href="contmarks.html" class="tocviewlink" data-pltdoc="x">Continuation Marks</a></td></tr><tr><td align="right">10.6&nbsp;</td><td><a href="breakhandler.html" class="tocviewlink" data-pltdoc="x">Breaks</a></td></tr><tr><td align="right">10.7&nbsp;</td><td><a href="Exiting.html" class="tocviewselflink" data-pltdoc="x">Exiting</a></td></tr><tr><td align="right">10.8&nbsp;</td><td><a href="unreachable.html" class="tocviewlink" data-pltdoc="x">Unreachable Expressions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._exit%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exit</span></span></a></td></tr><tr><td><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._exit-handler%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exit-<wbr></wbr>handler</span></span></a></td></tr><tr><td><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._executable-yield-handler%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">executable-<wbr></wbr>yield-<wbr></wbr>handler</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="breakhandler.html" title="backward to &quot;10.6 Breaks&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Control Flow&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="unreachable.html" title="forward to &quot;10.8 Unreachable Expressions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Exiting&quot;">10.7<tt>&nbsp;</tt><a name="(part._.Exiting)"></a>Exiting</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._exit))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._exit%29%29" class="RktValDef RktValLink" data-pltdoc="x">exit</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">v</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Passes <span class="RktVar">v</span> to the current <a href="Exiting.html#%28tech._exit._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">exit handler</span></a>. If the exit
+handler does not escape or terminate the thread, <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a> is
+returned.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._exit-handler))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._exit-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">exit-handler</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._exit-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">exit-handler</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the current <a name="(tech._exit._handler)"></a><span style="font-style: italic">exit handler</span>. The
+<a href="Exiting.html#%28tech._exit._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">exit handler</span></a> is called by <span class="RktSym"><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._exit%29%29" class="RktValLink" data-pltdoc="x">exit</a></span>.</div></p><p>The default <a href="Exiting.html#%28tech._exit._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">exit handler</span></a> in the Racket executable
+takes any argument, calls <span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-flush-all%29%29" class="RktValLink" data-pltdoc="x">plumber-flush-all</a></span> on the original plumber,
+and shuts down the OS-level Racket process. The
+argument is used as the OS-level exit code if it is an exact integer
+between <span class="RktVal">1</span> and <span class="RktVal">255</span> (which normally means
+&ldquo;failure&rdquo;); otherwise, the exit code is <span class="RktVal">0</span>, (which normally
+means &ldquo;success&rdquo;).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._executable-yield-handler))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._executable-yield-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">executable-yield-handler</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._executable-yield-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">executable-yield-handler</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines a procedure to be called as the Racket
+process is about to exit normally. The procedure associated with this
+parameter is not called when <span class="RktSym"><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._exit%29%29" class="RktValLink" data-pltdoc="x">exit</a></span> (or, more precisely, the
+default <a href="Exiting.html#%28tech._exit._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">exit handler</span></a>) is used to exit early. The argument to
+the handler is the status code that is returned to the system on exit.
+The default executable-yield handler simply returns <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</div></p><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=scheme&amp;rel=scheme_gui_base.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">scheme/gui/base</span></a> library sets this parameter to
+wait until all frames are closed, timers stopped, and queued events
+handled in the main eventspace. See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=scheme&amp;rel=scheme_gui_base.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">scheme/gui/base</span></a>
+for more information.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="breakhandler.html" title="backward to &quot;10.6 Breaks&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Control Flow&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="unreachable.html" title="forward to &quot;10.8 Unreachable Expressions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Expanding_Top-Level_Forms.html b/clones/docs.racket-lang.org/reference/Expanding_Top-Level_Forms.html
new file mode 100644
index 00000000..6fa35ac8
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Expanding_Top-Level_Forms.html
@@ -0,0 +1,51 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>12.9&nbsp;Expanding Top-Level Forms</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">12.1&nbsp;</td><td><a href="stx-patterns.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Syntax Matching</a></td></tr><tr><td align="right">12.2&nbsp;</td><td><a href="stxops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Content</a></td></tr><tr><td align="right">12.3&nbsp;</td><td><a href="stxcmp.html" class="tocviewlink" data-pltdoc="x">Syntax Object Bindings</a></td></tr><tr><td align="right">12.4&nbsp;</td><td><a href="stxtrans.html" class="tocviewlink" data-pltdoc="x">Syntax Transformers</a></td></tr><tr><td align="right">12.5&nbsp;</td><td><a href="stxparam.html" class="tocviewlink" data-pltdoc="x">Syntax Parameters</a></td></tr><tr><td align="right">12.6&nbsp;</td><td><a href="splicing.html" class="tocviewlink" data-pltdoc="x">Local Binding with Splicing Body</a></td></tr><tr><td align="right">12.7&nbsp;</td><td><a href="stxprops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Properties</a></td></tr><tr><td align="right">12.8&nbsp;</td><td><a href="stxcerts.html" class="tocviewlink" data-pltdoc="x">Syntax Taints</a></td></tr><tr><td align="right">12.9&nbsp;</td><td><a href="Expanding_Top-Level_Forms.html" class="tocviewselflink" data-pltdoc="x">Expanding Top-<wbr></wbr>Level Forms</a></td></tr><tr><td align="right">12.10&nbsp;</td><td><a href="Serializing_Syntax.html" class="tocviewlink" data-pltdoc="x">Serializing Syntax</a></td></tr><tr><td align="right">12.11&nbsp;</td><td><a href="include.html" class="tocviewlink" data-pltdoc="x">File Inclusion</a></td></tr><tr><td align="right">12.12&nbsp;</td><td><a href="syntax-util.html" class="tocviewlink" data-pltdoc="x">Syntax Utilities</a></td></tr><tr><td align="right">12.13&nbsp;</td><td><a href="phase_space.html" class="tocviewlink" data-pltdoc="x">Phase and Space Utilities</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>12.9&nbsp;</td><td><a href="Expanding_Top-Level_Forms.html" class="tocviewselflink" data-pltdoc="x">Expanding Top-<wbr></wbr>Level Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">12.9.1&nbsp;</td><td><a href="Expanding_Top-Level_Forms.html#%28part._modinfo%29" class="tocviewlink" data-pltdoc="x">Information on Expanded Modules</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">expand</span></span></a></td></tr><tr><td><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand-syntax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">expand-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand-once%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">expand-<wbr></wbr>once</span></span></a></td></tr><tr><td><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand-syntax-once%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">expand-<wbr></wbr>syntax-<wbr></wbr>once</span></span></a></td></tr><tr><td><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand-to-top-form%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">expand-<wbr></wbr>to-<wbr></wbr>top-<wbr></wbr>form</span></span></a></td></tr><tr><td><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand-syntax-to-top-form%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">expand-<wbr></wbr>syntax-<wbr></wbr>to-<wbr></wbr>top-<wbr></wbr>form</span></span></a></td></tr><tr><td><span class="tocsublinknumber">12.9.1<tt>&nbsp;</tt></span><a href="Expanding_Top-Level_Forms.html#%28part._modinfo%29" class="tocsubseclink" data-pltdoc="x">Information on Expanded Modules</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stxcerts.html" title="backward to &quot;12.8 Syntax Taints&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Serializing_Syntax.html" title="forward to &quot;12.10 Serializing Syntax&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Expanding_Top-Level_Forms&quot;">12.9<tt>&nbsp;</tt><a name="(part._.Expanding_.Top-.Level_.Forms)"></a>Expanding Top-Level Forms</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._expand))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand%29%29" class="RktValDef RktValLink" data-pltdoc="x">expand</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">top-level-form</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">insp</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">top-level-form</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">insp</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="RktValLink" data-pltdoc="x">current-code-inspector</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Expands all non-primitive syntax in <span class="RktVar">top-level-form</span>, and
+returns a syntax object for the expanded form that contains only core
+forms, matching the grammar specified by <a href="syntax-model.html#%28part._fully-expanded%29" data-pltdoc="x">Fully Expanded Programs</a>.</div></p><p>Before <span class="RktVar">top-level-form</span> is expanded, its lexical context is
+enriched with <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-syntax-introduce%29%29" class="RktValLink" data-pltdoc="x">namespace-syntax-introduce</a></span>, just as for
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span>. Use <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span> to convert the returned
+syntax object into a printable datum.</p><p>If <span class="RktVar">insp</span> is not the original <a href="modprotect.html#%28tech._code._inspector%29" class="techoutside" data-pltdoc="x"><span class="techinside">code inspector</span></a> (i.e., the
+value of <span class="RktPn">(</span><span class="RktSym"><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="RktValLink" data-pltdoc="x">current-code-inspector</a></span><span class="RktPn">)</span> when Racket starts), then
+the result syntax object is <a href="stxcerts.html#%28tech._tainted%29" class="techoutside" data-pltdoc="x"><span class="techinside">tainted</span></a>.</p><p>Here&rsquo;s an example of using <span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand%29%29" class="RktValLink" data-pltdoc="x">expand</a></span> on a module:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-base-namespace%29%29" class="RktValLink" data-pltdoc="x">make-base-namespace</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand%29%29" class="RktValLink" data-pltdoc="x">expand</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">module</span><span class="hspace">&nbsp;</span><span class="RktVal">foo</span><span class="hspace">&nbsp;</span><span class="RktVal">scheme</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">(</span><span class="RktVal">define</span><span class="hspace">&nbsp;</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">(</span><span class="RktVal">+</span><span class="hspace">&nbsp;</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Here&rsquo;s an example of using <span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand%29%29" class="RktValLink" data-pltdoc="x">expand</a></span> on a non-top-level form:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-namespace-anchor%29%29" class="RktStxLink" data-pltdoc="x">define-namespace-anchor</a></span><span class="hspace">&nbsp;</span><span class="RktSym">anchor</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._namespace-anchor-~3enamespace%29%29" class="RktValLink" data-pltdoc="x">namespace-anchor-&gt;namespace</a></span><span class="hspace">&nbsp;</span><span class="RktSym">anchor</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand%29%29" class="RktValLink" data-pltdoc="x">expand</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">delay</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">+</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p class="SHistory">Changed in version 8.2.0.4 of package <span class="stt">base</span>: Added the <span class="RktVar">insp</span> argument and tainting.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._expand-syntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand-syntax%29%29" class="RktValDef RktValLink" data-pltdoc="x">expand-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">insp</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">insp</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="RktValLink" data-pltdoc="x">current-code-inspector</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktPn">(</span><span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand%29%29" class="RktValLink" data-pltdoc="x">expand</a></span><span class="stt"> </span><span class="RktVar">stx</span><span class="stt"> </span><span class="RktVar">insp</span><span class="RktPn">)</span>, except that the argument must be a
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>, and its lexical context is not enriched before
+expansion.</div></p><p class="SHistory">Changed in version 8.2.0.4 of package <span class="stt">base</span>: Added the <span class="RktVar">insp</span> argument and tainting.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._expand-once))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand-once%29%29" class="RktValDef RktValLink" data-pltdoc="x">expand-once</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">top-level-form</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">insp</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">top-level-form</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">insp</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="RktValLink" data-pltdoc="x">current-code-inspector</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Partially expands <span class="RktVar">top-level-form</span> and returns a syntax object
+for the partially-expanded expression. Due to limitations in the
+expansion mechanism, some context information may be lost. In
+particular, calling <span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand-once%29%29" class="RktValLink" data-pltdoc="x">expand-once</a></span> on the result may produce a
+result that is different from expansion via <span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand%29%29" class="RktValLink" data-pltdoc="x">expand</a></span>.</div></p><p>Before <span class="RktVar">top-level-form</span> is expanded, its lexical context is
+enriched with <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-syntax-introduce%29%29" class="RktValLink" data-pltdoc="x">namespace-syntax-introduce</a></span>, as for
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span>.</p><p>The <span class="RktVar">insp</span> argument determines whether the result is
+<a href="stxcerts.html#%28tech._tainted%29" class="techoutside" data-pltdoc="x"><span class="techinside">tainted</span></a>, the same as for <span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand%29%29" class="RktValLink" data-pltdoc="x">expand</a></span>.</p><p class="SHistory">Changed in version 8.2.0.4 of package <span class="stt">base</span>: Added the <span class="RktVar">insp</span> argument and tainting.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._expand-syntax-once))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand-syntax-once%29%29" class="RktValDef RktValLink" data-pltdoc="x">expand-syntax-once</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">insp</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">insp</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="RktValLink" data-pltdoc="x">current-code-inspector</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktPn">(</span><span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand-once%29%29" class="RktValLink" data-pltdoc="x">expand-once</a></span><span class="stt"> </span><span class="RktVar">stx</span><span class="RktPn">)</span>, except that the argument
+must be a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>, and its lexical context is not
+enriched before expansion.</div></p><p class="SHistory">Changed in version 8.2.0.4 of package <span class="stt">base</span>: Added the <span class="RktVar">insp</span> argument and tainting.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._expand-to-top-form))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand-to-top-form%29%29" class="RktValDef RktValLink" data-pltdoc="x">expand-to-top-form</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">top-level-form</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">insp</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">top-level-form</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">insp</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="RktValLink" data-pltdoc="x">current-code-inspector</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Partially expands <span class="RktVar">top-level-form</span> to reveal the outermost
+syntactic form. This partial expansion is mainly useful for detecting
+top-level uses of <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span>. Unlike the result of
+<span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand-once%29%29" class="RktValLink" data-pltdoc="x">expand-once</a></span>, expanding the result of
+<span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand-to-top-form%29%29" class="RktValLink" data-pltdoc="x">expand-to-top-form</a></span> with <span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand%29%29" class="RktValLink" data-pltdoc="x">expand</a></span> produces the same
+result as using <span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand%29%29" class="RktValLink" data-pltdoc="x">expand</a></span> on the original syntax.</div></p><p>Before <span class="RktSym">stx-or-sexpr</span> is expanded, its lexical context is
+enriched with <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-syntax-introduce%29%29" class="RktValLink" data-pltdoc="x">namespace-syntax-introduce</a></span>, as for
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span>.</p><p>The <span class="RktVar">insp</span> argument determines whether the result is
+<a href="stxcerts.html#%28tech._tainted%29" class="techoutside" data-pltdoc="x"><span class="techinside">tainted</span></a>, the same as for <span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand%29%29" class="RktValLink" data-pltdoc="x">expand</a></span>.</p><p class="SHistory">Changed in version 8.2.0.4 of package <span class="stt">base</span>: Added the <span class="RktVar">insp</span> argument and tainting.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._expand-syntax-to-top-form))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand-syntax-to-top-form%29%29" class="RktValDef RktValLink" data-pltdoc="x">expand-syntax-to-top-form</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">insp</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">insp</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="RktValLink" data-pltdoc="x">current-code-inspector</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktPn">(</span><span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand-to-top-form%29%29" class="RktValLink" data-pltdoc="x">expand-to-top-form</a></span><span class="stt"> </span><span class="RktVar">stx</span><span class="RktPn">)</span>, except that the argument must
+be a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>, and its lexical context is not enriched
+before expansion.</div></p><p class="SHistory">Changed in version 8.2.0.4 of package <span class="stt">base</span>: Added the <span class="RktVar">insp</span> argument and tainting.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;modinfo&quot;">12.9.1<tt>&nbsp;</tt><a name="(part._modinfo)"></a>Information on Expanded Modules</h5><p>Information for an expanded <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> declaration is stored in a
+set of <a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax properties</span></a> (see <a href="stxprops.html" data-pltdoc="x">Syntax Object Properties</a>) attached
+to the syntax object:</p><ul><li><p><a name="(idx._(gentag._241._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">module-body-context</span> &#8212;<wbr></wbr> a syntax
+object whose <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> corresponds to the inside of
+the module, so it includes the expansion&rsquo;s <a href="syntax-model.html#%28tech._outside._edge._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">outside-edge scope</span></a>
+and its <a href="syntax-model.html#%28tech._inside._edge._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">inside-edge scope</span></a>; that is, the syntax object
+simulates an identifier that is present in the original module body
+and inaccessible to manipulation by any macro, so that its lexical
+information includes bindings for the module&rsquo;s imports and
+definitions.</p><p class="SHistory">Added in version 6.4.0.1 of package <span class="stt">base</span>.</p></li><li><p><a name="(idx._(gentag._242._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">module-body-inside-context</span> &#8212;<wbr></wbr> a syntax
+object whose <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> corresponds to an identifier
+that starts with no lexical context and is moved into the macro, so
+that it includes only the expansions&rsquo;s <a href="syntax-model.html#%28tech._inside._edge._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">inside-edge scope</span></a>.</p><p class="SHistory">Added in version 6.4.0.1 of package <span class="stt">base</span>.</p></li><li><p><a name="(idx._(gentag._243._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">module-body-context-simple?</span> &#8212;<wbr></wbr> a boolean,
+where <span class="RktVal">#t</span> indicates that the bindings of the module&rsquo;s body
+(as recorded in the <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> of the value of the
+<span class="RktVal">'</span><span class="RktVal">module-body-inside-context</span> property) can be directly
+reconstructed from modules directly imported into the module,
+including imported for-syntax, for-meta, and for-template.</p><p class="SHistory">Added in version 6.4.0.1 of package <span class="stt">base</span>.</p></li></ul><p class="SHistory">Changed in version 7.0 of package <span class="stt">base</span>: Removed <span class="RktVal">'</span><span class="RktVal">module-variable-provides</span>,
+<span class="RktVal">'</span><span class="RktVal">module-syntax-provides</span>,
+<span class="RktVal">'</span><span class="RktVal">module-indirect-provides</span>,
+and <span class="RktVal">'</span><span class="RktVal">module-indirect-for-meta-provides</span>
+properties.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stxcerts.html" title="backward to &quot;12.8 Syntax Taints&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Serializing_Syntax.html" title="forward to &quot;12.10 Serializing Syntax&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Filesystem.html b/clones/docs.racket-lang.org/reference/Filesystem.html
new file mode 100644
index 00000000..a279771c
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Filesystem.html
@@ -0,0 +1,850 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15.2&nbsp;Filesystem</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewselflink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewlink" data-pltdoc="x">Paths</a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="Filesystem.html" class="tocviewselflink" data-pltdoc="x">Filesystem</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="networking.html" class="tocviewlink" data-pltdoc="x">Networking</a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="subprocess.html" class="tocviewlink" data-pltdoc="x">Processes</a></td></tr><tr><td align="right">15.5&nbsp;</td><td><a href="logging.html" class="tocviewlink" data-pltdoc="x">Logging</a></td></tr><tr><td align="right">15.6&nbsp;</td><td><a href="time.html" class="tocviewlink" data-pltdoc="x">Time</a></td></tr><tr><td align="right">15.7&nbsp;</td><td><a href="envvars.html" class="tocviewlink" data-pltdoc="x">Environment Variables</a></td></tr><tr><td align="right">15.8&nbsp;</td><td><a href="runtime.html" class="tocviewlink" data-pltdoc="x">Environment and Runtime Information</a></td></tr><tr><td align="right">15.9&nbsp;</td><td><a href="Command-Line_Parsing.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Parsing</a></td></tr><tr><td align="right">15.10&nbsp;</td><td><a href="os-lib.html" class="tocviewlink" data-pltdoc="x">Additional Operating System Functions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>15.2&nbsp;</td><td><a href="Filesystem.html" class="tocviewselflink" data-pltdoc="x">Filesystem</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.2.1&nbsp;</td><td><a href="Filesystem.html#%28part._findpaths%29" class="tocviewlink" data-pltdoc="x">Locating Paths</a></td></tr><tr><td align="right">15.2.2&nbsp;</td><td><a href="Filesystem.html#%28part._fileutils%29" class="tocviewlink" data-pltdoc="x">Files</a></td></tr><tr><td align="right">15.2.3&nbsp;</td><td><a href="Filesystem.html#%28part._directories%29" class="tocviewlink" data-pltdoc="x">Directories</a></td></tr><tr><td align="right">15.2.4&nbsp;</td><td><a href="Filesystem.html#%28part._filesystem-change%29" class="tocviewlink" data-pltdoc="x">Detecting Filesystem Changes</a></td></tr><tr><td align="right">15.2.5&nbsp;</td><td><a href="Filesystem.html#%28part._runtime-path%29" class="tocviewlink" data-pltdoc="x">Declaring Paths Needed at Run Time</a></td></tr><tr><td align="right">15.2.6&nbsp;</td><td><a href="Filesystem.html#%28part._file-lib%29" class="tocviewlink" data-pltdoc="x">More File and Directory Utilities</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">15.2.1<tt>&nbsp;</tt></span><a href="Filesystem.html#%28part._findpaths%29" class="tocsubseclink" data-pltdoc="x">Locating Paths</a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">find-<wbr></wbr>system-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-list-string-~3epath-list%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-<wbr></wbr>list-<wbr></wbr>string-<wbr></wbr>&gt;path-<wbr></wbr>list</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._find-executable-path%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">find-<wbr></wbr>executable-<wbr></wbr>path</span></span></a></td></tr><tr><td><span class="tocsublinknumber">15.2.2<tt>&nbsp;</tt></span><a href="Filesystem.html#%28part._fileutils%29" class="tocsubseclink" data-pltdoc="x">Files</a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-exists~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-<wbr></wbr>exists?</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._link-exists~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">link-<wbr></wbr>exists?</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-type%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-<wbr></wbr>or-<wbr></wbr>directory-<wbr></wbr>type</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._delete-file%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">delete-<wbr></wbr>file</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._rename-file-or-directory%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">rename-<wbr></wbr>file-<wbr></wbr>or-<wbr></wbr>directory</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-modify-seconds%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-<wbr></wbr>or-<wbr></wbr>directory-<wbr></wbr>modify-<wbr></wbr>seconds</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-permissions%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-<wbr></wbr>or-<wbr></wbr>directory-<wbr></wbr>permissions</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-stat%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-<wbr></wbr>or-<wbr></wbr>directory-<wbr></wbr>stat</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-identity%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-<wbr></wbr>or-<wbr></wbr>directory-<wbr></wbr>identity</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-size%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-<wbr></wbr>size</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._copy-file%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">copy-<wbr></wbr>file</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._make-file-or-directory-link%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>file-<wbr></wbr>or-<wbr></wbr>directory-<wbr></wbr>link</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-force-delete-permissions%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>force-<wbr></wbr>delete-<wbr></wbr>permissions</span></span></a></td></tr><tr><td><span class="tocsublinknumber">15.2.3<tt>&nbsp;</tt></span><a href="Filesystem.html#%28part._directories%29" class="tocsubseclink" data-pltdoc="x">Directories</a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>directory</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory-for-user%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>directory-<wbr></wbr>for-<wbr></wbr>user</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-drive%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>drive</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._directory-exists~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">directory-<wbr></wbr>exists?</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._make-directory%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>directory</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._delete-directory%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">delete-<wbr></wbr>directory</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._directory-list%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">directory-<wbr></wbr>list</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._filesystem-root-list%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">filesystem-<wbr></wbr>root-<wbr></wbr>list</span></span></a></td></tr><tr><td><span class="tocsublinknumber">15.2.4<tt>&nbsp;</tt></span><a href="Filesystem.html#%28part._filesystem-change%29" class="tocsubseclink" data-pltdoc="x">Detecting Filesystem Changes</a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._filesystem-change-evt~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">filesystem-<wbr></wbr>change-<wbr></wbr>evt?</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._filesystem-change-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">filesystem-<wbr></wbr>change-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._filesystem-change-evt-cancel%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">filesystem-<wbr></wbr>change-<wbr></wbr>evt-<wbr></wbr>cancel</span></span></a></td></tr><tr><td><span class="tocsublinknumber">15.2.5<tt>&nbsp;</tt></span><a href="Filesystem.html#%28part._runtime-path%29" class="tocsubseclink" data-pltdoc="x">Declaring Paths Needed at Run Time</a></td></tr><tr><td><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>runtime-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-paths%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>runtime-<wbr></wbr>paths</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path-list%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>runtime-<wbr></wbr>path-<wbr></wbr>list</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-module-path-index%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>runtime-<wbr></wbr>module-<wbr></wbr>path-<wbr></wbr>index</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._runtime-require%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">runtime-<wbr></wbr>require</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-module-path%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>runtime-<wbr></wbr>module-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._runtime-paths%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">runtime-<wbr></wbr>paths</span></span></a></td></tr><tr><td><span class="tocsublinknumber">15.2.6<tt>&nbsp;</tt></span><a href="Filesystem.html#%28part._file-lib%29" class="tocsubseclink" data-pltdoc="x">More File and Directory Utilities</a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-~3estring%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-<wbr></wbr>&gt;string</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-~3ebytes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-<wbr></wbr>&gt;bytes</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-~3evalue%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-<wbr></wbr>&gt;value</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-~3elist%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-<wbr></wbr>&gt;list</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-~3elines%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-<wbr></wbr>&gt;lines</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-~3ebytes-lines%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-<wbr></wbr>&gt;bytes-<wbr></wbr>lines</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._display-to-file%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">display-<wbr></wbr>to-<wbr></wbr>file</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._write-to-file%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-<wbr></wbr>to-<wbr></wbr>file</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._display-lines-to-file%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">display-<wbr></wbr>lines-<wbr></wbr>to-<wbr></wbr>file</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._copy-directory%2Ffiles%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">copy-<wbr></wbr>directory/<span class="mywbr"> &nbsp;</span>files</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._delete-directory%2Ffiles%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">delete-<wbr></wbr>directory/<span class="mywbr"> &nbsp;</span>files</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._find-files%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">find-<wbr></wbr>files</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._pathlist-closure%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pathlist-<wbr></wbr>closure</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._fold-files%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fold-<wbr></wbr>files</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-directory%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>directory*</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-parent-directory%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>parent-<wbr></wbr>directory*</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-file%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>temporary-<wbr></wbr>file</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-directory%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>temporary-<wbr></wbr>directory</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-file%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>temporary-<wbr></wbr>file*</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-directory%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>temporary-<wbr></wbr>directory*</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._call-with-atomic-output-file%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>atomic-<wbr></wbr>output-<wbr></wbr>file</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._get-preference%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get-<wbr></wbr>preference</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._put-preferences%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">put-<wbr></wbr>preferences</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._preferences-lock-file-mode%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">preferences-<wbr></wbr>lock-<wbr></wbr>file-<wbr></wbr>mode</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-handle-get-preference-locked%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>handle-<wbr></wbr>get-<wbr></wbr>preference-<wbr></wbr>locked</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._call-with-file-lock%2Ftimeout%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>file-<wbr></wbr>lock/<span class="mywbr"> &nbsp;</span>timeout</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-lock-file-name%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>lock-<wbr></wbr>file-<wbr></wbr>name</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-type-bits%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-<wbr></wbr>type-<wbr></wbr>bits</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._socket-type-bits%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">socket-<wbr></wbr>type-<wbr></wbr>bits</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._symbolic-link-type-bits%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">symbolic-<wbr></wbr>link-<wbr></wbr>type-<wbr></wbr>bits</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._regular-file-type-bits%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regular-<wbr></wbr>file-<wbr></wbr>type-<wbr></wbr>bits</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._block-device-type-bits%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">block-<wbr></wbr>device-<wbr></wbr>type-<wbr></wbr>bits</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._directory-type-bits%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">directory-<wbr></wbr>type-<wbr></wbr>bits</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._character-device-type-bits%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">character-<wbr></wbr>device-<wbr></wbr>type-<wbr></wbr>bits</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._fifo-type-bits%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fifo-<wbr></wbr>type-<wbr></wbr>bits</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._set-user-id-bit%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>user-<wbr></wbr>id-<wbr></wbr>bit</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._set-group-id-bit%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>group-<wbr></wbr>id-<wbr></wbr>bit</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._sticky-bit%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sticky-<wbr></wbr>bit</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._user-permission-bits%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">user-<wbr></wbr>permission-<wbr></wbr>bits</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._user-read-bit%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">user-<wbr></wbr>read-<wbr></wbr>bit</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._user-write-bit%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">user-<wbr></wbr>write-<wbr></wbr>bit</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._user-execute-bit%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">user-<wbr></wbr>execute-<wbr></wbr>bit</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._group-permission-bits%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">group-<wbr></wbr>permission-<wbr></wbr>bits</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._group-read-bit%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">group-<wbr></wbr>read-<wbr></wbr>bit</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._group-write-bit%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">group-<wbr></wbr>write-<wbr></wbr>bit</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._group-execute-bit%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">group-<wbr></wbr>execute-<wbr></wbr>bit</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._other-permission-bits%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">other-<wbr></wbr>permission-<wbr></wbr>bits</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._other-read-bit%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">other-<wbr></wbr>read-<wbr></wbr>bit</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._other-write-bit%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">other-<wbr></wbr>write-<wbr></wbr>bit</span></span></a></td></tr><tr><td><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._other-execute-bit%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">other-<wbr></wbr>execute-<wbr></wbr>bit</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="windowspaths.html" title="backward to &quot;15.1.4 Windows Paths&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="os.html" title="up to &quot;15 Operating System&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="networking.html" title="forward to &quot;15.3 Networking&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Filesystem&quot;">15.2<tt>&nbsp;</tt><a name="(part._.Filesystem)"></a>Filesystem</h4><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;findpaths&quot;">15.2.1<tt>&nbsp;</tt><a name="(part._findpaths)"></a>Locating Paths</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._find-system-path))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">find-system-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">kind</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">kind</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a machine-specific path for a standard type of path specified
+by <span class="RktVar">kind</span>, which must be one of the following:</div></p><ul><li><p><a name="(idx._(gentag._317._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">home-dir</span> &#8212;<wbr></wbr> the current <a name="(tech._user's._home._directory)"></a><span style="font-style: italic">user&rsquo;s home
+directory</span>.</p><p>On all platforms, if the <a name="(idx._(gentag._318._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLTUSERHOME</span> environment
+variable is defined as a <a href="Manipulating_Paths.html#%28tech._complete%29" class="techoutside" data-pltdoc="x"><span class="techinside">complete</span></a> path, then the path is used
+as the user&rsquo;s home directory.</p><p>On Unix and Mac OS, when <span class="stt">PLTUSERHOME</span> does not apply,
+the user&rsquo;s home directory is determined by
+expanding the path <span class="stt">"~"</span>, which is expanded by first checking
+for a <a name="(idx._(gentag._319._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">HOME</span> environment variable. If none is defined,
+the <a name="(idx._(gentag._320._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">USER</span> and <a name="(idx._(gentag._321._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">LOGNAME</span> environment
+variables are consulted (in that order) to find a user name, and then
+system files are consulted to locate the user&rsquo;s home directory.</p><p>On Windows, when <span class="stt">PLTUSERHOME</span> does not apply,
+the user&rsquo;s home directory is the user-specific profile
+directory as determined by the Windows registry. If the registry
+cannot provide a directory for some reason, the value of the
+<a name="(idx._(gentag._322._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">USERPROFILE</span> environment variable is used instead, as
+long as it refers to a directory that exists. If <span class="stt">USERPROFILE</span>
+also fails, the directory is the one specified by the
+<a name="(idx._(gentag._323._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">HOMEDRIVE</span> and <a name="(idx._(gentag._324._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">HOMEPATH</span> environment
+variables.  If those environment variables are not defined, or if the
+indicated directory still does not exist, the directory containing
+the current executable is used as the home directory.</p></li><li><p><a name="(idx._(gentag._325._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">pref-dir</span> &#8212;<wbr></wbr> the standard directory for
+storing the current user&rsquo;s preferences. The preferences directory
+might not exist.</p><p>On Unix, the preferences directory is normally the <span class="stt">"racket"</span>
+subdirectory of the path specified by
+<a name="(idx._(gentag._326._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">XDG_CONFIG_HOME</span>, or <span class="stt">".config/racket"</span> in the
+<a href="Filesystem.html#%28tech._user%27s._home._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">user&rsquo;s home directory</span></a> if <span class="stt">XDG_CONFIG_HOME</span> is not set
+to an absolute path or if <span class="stt">PLTUSERHOME</span> is set. Either way, if
+that directory does not exist but a <span class="stt">".racket"</span> directory
+exists in the <a href="Filesystem.html#%28tech._user%27s._home._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">user&rsquo;s home directory</span></a>, then that directory is
+the preference directory, instead.</p><p>On Windows, the preferences directory is <span class="stt">"Racket"</span> in the
+<a href="Filesystem.html#%28tech._user%27s._home._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">user&rsquo;s home directory</span></a> if determined by <span class="stt">PLTUSERHOME</span>,
+otherwise in the user&rsquo;s application-data folder as specified by the
+Windows registry; the application-data folder is usually
+<span class="stt">"Application Data"</span> in the user&rsquo;s profile directory.</p><p>On Mac OS, the preferences directory is
+<span class="stt">"Library/Preferences"</span> in the <a href="Filesystem.html#%28tech._user%27s._home._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">user&rsquo;s home directory</span></a>.</p></li><li><p><a name="(idx._(gentag._327._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">pref-file</span> &#8212;<wbr></wbr> a file that contains a
+symbol-keyed association list of preference values. The file&rsquo;s
+directory path always matches the result returned for
+<span class="RktVal">'</span><span class="RktVal">pref-dir</span>. The file name is <span class="stt">"racket-prefs.rktd"</span> on Unix
+and Windows, and it is <span class="stt">"org.racket-lang.prefs.rktd"</span> on Mac OS.
+The file&rsquo;s directory might not exist. See also
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._get-preference%29%29" class="RktValLink" data-pltdoc="x">get-preference</a></span>.</p></li><li><p><a name="(idx._(gentag._328._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">temp-dir</span> &#8212;<wbr></wbr> the standard directory for
+storing temporary files. On Unix and Mac OS, this is the directory
+specified by the <a name="(idx._(gentag._329._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">TMPDIR</span> environment variable, if it
+is defined, otherwise it is the first path that exists among
+<span class="stt">"/var/tmp"</span>, <span class="stt">"/usr/tmp"</span>, and <span class="stt">"/tmp"</span>. On
+Windows, the result is the directory specified by the
+<a name="(idx._(gentag._330._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">TMP</span> or <a name="(idx._(gentag._331._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">TEMP</span> environment variable,
+if it is defined, otherwise it is the current directory.</p></li><li><p><a name="(idx._(gentag._332._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">init-dir</span> &#8212;<wbr></wbr> the directory containing the
+initialization file used by the Racket executable.</p><p>On Unix, the initialization directory is the same as the result
+returned for <span class="RktVal">'</span><span class="RktVal">pref-dir</span>&#8212;<wbr></wbr>unless that directory does not
+exist and a <span class="stt">".racketrc"</span> file exists in the <a href="Filesystem.html#%28tech._user%27s._home._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">user&rsquo;s home
+directory</span></a>, in which case the home directory is the initialization
+directory.</p><p>On Windows, the initialization directory is the same as the
+<a href="Filesystem.html#%28tech._user%27s._home._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">user&rsquo;s home directory</span></a>.</p><p>On Mac OS, the initialization directory is <span class="stt">"Library/Racket"</span>
+in the <a href="Filesystem.html#%28tech._user%27s._home._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">user&rsquo;s home directory</span></a>&#8212;<wbr></wbr>unless no
+<span class="stt">"racketrc.rktl"</span> exists there and a <span class="stt">".racketrc"</span> file
+does exist in the home directory, in which case the home directory is
+the initialization directory.</p></li><li><p><a name="(idx._(gentag._333._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">init-file</span> &#8212;<wbr></wbr> the file loaded at start-up by
+the Racket executable. The directory part of the
+path is the same path as returned for <span class="RktVal">'</span><span class="RktVal">init-dir</span>.</p><p>On Windows, the file part of the name is
+<a name="(idx._(gentag._334._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"racketrc.rktl"</span>.</p><p>On Unix and Mac OS, the file part of the name is
+<a name="(idx._(gentag._335._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"racketrc.rktl"</span>&#8212;<wbr></wbr>unless the path returned for
+<span class="RktVal">'</span><span class="RktVal">init-dir</span> is the <a href="Filesystem.html#%28tech._user%27s._home._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">user&rsquo;s home directory</span></a>, in which case
+the file part of the name is <a name="(idx._(gentag._336._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">".racketrc"</span>.</p></li><li><p><a name="(idx._(gentag._337._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">config-dir</span> &#8212;<wbr></wbr> a directory for
+the installation&rsquo;s configuration. This directory is specified by the
+<a name="(idx._(gentag._338._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLTCONFIGDIR</span> environment variable, and it can be
+overridden by the <span class="nobreak"><span class="stt">--config</span></span> or <span class="nobreak"><span class="stt">-G</span></span> command-line flag.  If no
+environment variable or flag is specified, or if the value is not a
+legal path name, then this directory defaults to an
+<span class="stt">"etc"</span> directory relative to the current executable.
+If the result of <span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">config-dir</span><span class="RktPn">)</span> is a
+relative path, it is relative to the current executable.
+The directory might not exist.</p></li><li><p><a name="(idx._(gentag._339._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">host-config-dir</span> &#8212;<wbr></wbr> like
+<span class="RktVal">'</span><span class="RktVal">config-dir</span>, but when cross-platform build mode has been
+selected (through the <span class="nobreak"><span class="stt">-C</span></span> or <span class="nobreak"><span class="stt">--cross</span></span> argument to
+<span class="stt">racket</span>; see <a href="running-sa.html#%28part._mz-cmdline%29" data-pltdoc="x">Command Line</a>), the result refers to a
+directory for the current system&rsquo;s installation, instead of for the
+target system.</p></li><li><p><a name="(idx._(gentag._340._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">addon-dir</span> &#8212;<wbr></wbr> a directory for
+user-specific Racket configuration, packages, and extension.
+This directory is specified by the
+<a name="(idx._(gentag._341._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLTADDONDIR</span> environment variable, and it can be
+overridden by the <span class="nobreak"><span class="stt">--addon</span></span> or <span class="nobreak"><span class="stt">-A</span></span> command-line flag.  If no
+environment variable or flag is specified, or if the value is not a
+legal path name, then this directory defaults to a platform-specific
+locations. The directory might not exist.</p><p>On Unix, the default is normally the <span class="stt">"racket"</span> subdirectory
+of the path specified by <a name="(idx._(gentag._342._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">XDG_DATA_HOME</span>, or
+<span class="stt">".local/share/racket"</span> in the <a href="Filesystem.html#%28tech._user%27s._home._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">user&rsquo;s home directory</span></a> if
+<span class="stt">XDG_CONFIG_HOME</span> is not set to an absolute path or if
+<span class="stt">PLTUSERHOME</span> is set. If that directory does not exists but a
+<span class="stt">".racket"</span> directory exists in the user&rsquo;s home directory,
+that the <span class="stt">".racket"</span> directory path is the default, instead.</p><p>On Windows, the default is the same as the <span class="RktVal">'</span><span class="RktVal">pref-dir</span> directory.</p><p>On Mac OS, the default is <span class="stt">"Library/Racket"</span> within the
+<a href="Filesystem.html#%28tech._user%27s._home._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">user&rsquo;s home directory</span></a>.</p></li><li><p><a name="(idx._(gentag._343._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">cache-dir</span> &#8212;<wbr></wbr> a directory for storing
+user-specific caches. The directory might not exist.</p><p>On Unix, the cache directory is normally the <span class="stt">"racket"</span>
+subdirectory of the path specified by
+<a name="(idx._(gentag._344._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">XDG_CACHE_HOME</span>, or <span class="stt">".cache/racket"</span> in the
+<a href="Filesystem.html#%28tech._user%27s._home._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">user&rsquo;s home directory</span></a> if <span class="stt">XDG_CACHE_HOME</span> is not set to
+an absolute path or if <span class="stt">PLTUSERHOME</span> is set. If that directory
+does not exist but a <span class="stt">".racket"</span> directory exists in the home
+directory, then the <span class="stt">".racket"</span> directory is the cache
+directory, instead.</p><p>On Windows, the cache directory is the same as the result returned
+for <span class="RktVal">'</span><span class="RktVal">addon-dir</span>.</p><p>On Mac OS, the cache directory is <span class="stt">"Library/Caches/Racket"</span>
+within the <a href="Filesystem.html#%28tech._user%27s._home._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">user&rsquo;s home directory</span></a>.</p></li><li><p><a name="(idx._(gentag._345._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">doc-dir</span> &#8212;<wbr></wbr> the standard directory for
+storing the current user&rsquo;s documents. On Unix, it&rsquo;s
+the <a href="Filesystem.html#%28tech._user%27s._home._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">user&rsquo;s home directory</span></a>.  On Windows, it is the <a href="Filesystem.html#%28tech._user%27s._home._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">user&rsquo;s
+home directory</span></a> if determined by <span class="stt">PLTUSERHOME</span>, otherwise it
+is the user&rsquo;s documents folder as specified by the Windows registry;
+the documents folder is usually <span class="stt">"My Documents"</span> in the user&rsquo;s
+home directory.  On Mac OS, it&rsquo;s the <span class="stt">"Documents"</span> directory
+in the <a href="Filesystem.html#%28tech._user%27s._home._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">user&rsquo;s home directory</span></a>.</p></li><li><p><a name="(idx._(gentag._346._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">desk-dir</span> &#8212;<wbr></wbr> the directory for the current user&rsquo;s
+desktop. On Unix, it&rsquo;s the <a href="Filesystem.html#%28tech._user%27s._home._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">user&rsquo;s home directory</span></a>. On
+Windows, it is the <a href="Filesystem.html#%28tech._user%27s._home._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">user&rsquo;s home directory</span></a> if determined by
+<span class="stt">PLTUSERHOME</span>, otherwise it is the user&rsquo;s desktop folder as
+specified by the Windows registry; the desktop folder is usually
+<span class="stt">"Desktop"</span> in the user&rsquo;s home directory. On Mac OS, it is
+<span class="stt">"Desktop"</span> in the <a href="Filesystem.html#%28tech._user%27s._home._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">user&rsquo;s home directory</span></a></p></li><li><p><a name="(idx._(gentag._347._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">sys-dir</span> &#8212;<wbr></wbr> the directory containing the
+operating system for Windows. On Unix and Mac OS, the
+result is <span class="RktVal">"/"</span>.</p></li><li><p><a name="(idx._(gentag._348._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">exec-file</span> &#8212;<wbr></wbr> the path of the Racket
+executable as provided by the operating system for the current
+invocation. For some operating systems, the path can be relative.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>For GRacket, the executable path is the name of a GRacket
+executable.</p></blockquote></blockquote></blockquote></li><li><p><a name="(idx._(gentag._349._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">run-file</span> &#8212;<wbr></wbr> the path of the current
+executable; this may be different from result for
+<span class="RktVal">'</span><span class="RktVal">exec-file</span> because an alternate path was provided through a
+<span class="nobreak"><span class="stt">--name</span></span> or <span class="nobreak"><span class="stt">-N</span></span> command-line flag to the Racket
+(or GRacket) executable, or because an embedding executable
+installed an alternate path. In particular a &ldquo;launcher&rdquo; script
+created by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=exe.html%23%2528def._%2528%2528lib._launcher%252Flauncher..rkt%2529._make-racket-launcher%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-racket-launcher</a></span> sets this path to the
+script&rsquo;s path.</p></li><li><p><a name="(idx._(gentag._350._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">collects-dir</span> &#8212;<wbr></wbr> a path to the main
+collection of libraries (see <a href="collects.html" data-pltdoc="x">Libraries and Collections</a>). If this path is
+relative, then it is relative to the executable as reported by
+<span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">exec-file</span><span class="RktPn">)</span>&#8212;<wbr></wbr>though the latter could be a
+soft-link or relative to the user&rsquo;s executable search path, so that
+the two results should be combined with
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._find-executable-path%29%29" class="RktValLink" data-pltdoc="x">find-executable-path</a></span>.  The <span class="RktVal">'</span><span class="RktVal">collects-dir</span> path is
+normally embedded in the Racket executable, but it can be
+overridden by the <span class="nobreak"><span class="stt">--collects</span></span> or <span class="nobreak"><span class="stt">-X</span></span> command-line flag.</p></li><li><p><a name="(idx._(gentag._351._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">host-collects-dir</span> &#8212;<wbr></wbr> like
+<span class="RktVal">'</span><span class="RktVal">collects-dir</span>, but when cross-platform build mode has been
+selected (through the <span class="nobreak"><span class="stt">-C</span></span> or <span class="nobreak"><span class="stt">--cross</span></span> argument to
+<span class="stt">racket</span>; see <a href="running-sa.html#%28part._mz-cmdline%29" data-pltdoc="x">Command Line</a>), the result refers to a
+directory for the current system&rsquo;s installation, instead of for the
+target system. In cross-platform build mode, collection
+files are normally read from the target system&rsquo;s installation,
+but some tasks require current-system directories (such as
+the one that holds foreign libraries) that are configured relative
+to the main library-collection path.</p></li><li><p><a name="(idx._(gentag._352._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">orig-dir</span> &#8212;<wbr></wbr> the current directory at
+start-up, which can be useful in converting a relative-path result
+from <span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">exec-file</span><span class="RktPn">)</span> or
+<span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">run-file</span><span class="RktPn">)</span> to a complete path.</p></li></ul><p class="SHistory">Changed in version 6.0.0.3 of package <span class="stt">base</span>: Added <span class="stt">PLTUSERHOME</span>.<br/>Changed in version 6.9.0.1: Added <span class="RktVal">'</span><span class="RktVal">host-config-dir</span>
+and <span class="RktVal">'</span><span class="RktVal">host-collects-dir</span>.<br/>Changed in version 7.8.0.9: Added <span class="RktVal">'</span><span class="RktVal">cache-dir</span>, and changed
+to use XDG directories as preferred on Unix
+with the previous paths as a fallback, and
+with similar adjustments for Mac OS.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._path-list-string-~3epath-list))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-list-string-~3epath-list%29%29" class="RktValDef RktValLink" data-pltdoc="x">path-list-string-&gt;path-list</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">str</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">default-path-list</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">same</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">default-path-list</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">same</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Parses a string or byte string containing a list of paths, and returns
+a list of paths. On Unix and Mac OS, paths in a path-list string are
+separated by a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">:</span><span class="hspace"></span></span>; on Windows, paths are separated by a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">;</span><span class="hspace"></span></span>, and all <span class="RktInBG"><span class="hspace"></span><span class="RktIn">"</span><span class="hspace"></span></span>s in the string are discarded. Whenever the path
+list contains an empty path, the list
+<span class="RktVar">default-path-list</span> is spliced into the returned list of
+paths. Parts of <span class="RktVar">str</span> that do not form a valid path are not
+included in the returned list. The given <span class="RktVar">str</span> must not contain
+a nul character or nul byte.</div></p><p class="SHistory">Changed in version 8.0.0.10 of package <span class="stt">base</span>: Changed to allow <span class="RktVal">'</span><span class="RktVal">same</span> in
+<span class="RktVar">default-path-list</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._find-executable-path))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._find-executable-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">find-executable-path</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">program</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">related</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">deepest?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">program</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">related</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">deepest?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Finds a path for the executable <span class="RktVar">program</span>, returning
+<span class="RktVal">#f</span> if the path cannot be found.</div></p><p>On Windows, if <span class="RktVar">program</span> is not found and it has no file
+extension, then the search starts over with <span class="stt">".exe"</span> added to
+<span class="RktVar">program</span>, and the result is <span class="RktVal">#f</span> only if the path with
+<span class="stt">".exe"</span> also cannot be found. The result includes the
+extension <span class="stt">".exe"</span> if only <span class="RktVar">program</span> with the extension
+is found.</p><p>If <span class="RktVar">related</span> is not <span class="RktVal">#f</span>, then it must be a relative
+path string, and the path found for <span class="RktVar">program</span> must be such
+that the file or directory <span class="RktVar">related</span> exists in the same
+directory as the executable. The result is then the full path for the
+found <span class="RktVar">related</span>, instead of the path for the executable.</p><p>This procedure is used by the Racket executable to find the
+standard library collection directory (see <a href="collects.html" data-pltdoc="x">Libraries and Collections</a>).  In
+this case, <span class="RktVar">program</span> is the name used to start Racket and
+<span class="RktVar">related</span> is <span class="RktVal">"collects"</span>.  The <span class="RktVar">related</span>
+argument is used because, on Unix and Mac OS, <span class="RktVar">program</span> may
+involve a sequence of soft links; in this case,
+<span class="RktVar">related</span> determines which link in the chain is relevant.</p><p>If <span class="RktVar">related</span> is not <span class="RktVal">#f</span>, then when
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._find-executable-path%29%29" class="RktValLink" data-pltdoc="x">find-executable-path</a></span> does not find a <span class="RktVar">program</span>
+that is a link to another file path, the search can continue with the
+destination of the link. Further links are inspected until
+<span class="RktVar">related</span> is found or the end of the chain of links is
+reached. If <span class="RktVar">deepest?</span> is <span class="RktVal">#f</span> (the default), then the
+result corresponds to the first path in a chain of links for which
+<span class="RktVar">related</span> is found (and further links are not actually
+explored); otherwise, the result corresponds to the last link in the
+chain for which <span class="RktVar">related</span> is found.</p><p>If <span class="RktVar">program</span> is a pathless name,
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._find-executable-path%29%29" class="RktValLink" data-pltdoc="x">find-executable-path</a></span> gets the value of the
+<a name="(idx._(gentag._353._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PATH</span> environment variable; if this environment
+variable is defined, <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._find-executable-path%29%29" class="RktValLink" data-pltdoc="x">find-executable-path</a></span> tries each path in
+<span class="stt">PATH</span> as a prefix for <span class="RktVar">program</span> using the search
+algorithm described above for path-containing
+<span class="RktVar">program</span>s. If the <span class="stt">PATH</span> environment variable is
+not defined, <span class="RktVar">program</span> is prefixed with the current
+directory and used in the search algorithm above. (On Windows, the
+current directory is always implicitly the first item in
+<span class="stt">PATH</span>, so <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._find-executable-path%29%29" class="RktValLink" data-pltdoc="x">find-executable-path</a></span> checks the current
+directory first on Windows.)</p><p class="SHistory">Changed in version 8.1.0.7 of package <span class="stt">base</span>: Added search with <span class="stt">".exe"</span>
+on Windows.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;fileutils&quot;">15.2.2<tt>&nbsp;</tt><a name="(part._fileutils)"></a>Files</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._file-exists~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-exists~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-exists?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if a file (not a directory) <span class="RktVar">path</span> exists,
+<span class="RktVal">#f</span> otherwise.</div></p><p>On Windows, <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-exists~3f%29%29" class="RktValLink" data-pltdoc="x">file-exists?</a></span>  reports <span class="RktVal">#t</span> for all
+variations of the special filenames (e.g., <span class="RktVal">"LPT1"</span>,
+<span class="RktVal">"x:/baddir/LPT1"</span>).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._link-exists~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._link-exists~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">link-exists?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if a link <span class="RktVar">path</span> exists,
+<span class="RktVal">#f</span> otherwise.</div></p><p>The predicates <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-exists~3f%29%29" class="RktValLink" data-pltdoc="x">file-exists?</a></span>  or <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._directory-exists~3f%29%29" class="RktValLink" data-pltdoc="x">directory-exists?</a></span>
+work on the final destination of a link or series of links, while
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._link-exists~3f%29%29" class="RktValLink" data-pltdoc="x">link-exists?</a></span>  only follows links to resolve the base part of
+<span class="RktVar">path</span> (i.e., everything except the last name in the
+path).</p><p>This procedure never raises the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span>
+exception.</p><p>On Windows, <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._link-exists~3f%29%29" class="RktValLink" data-pltdoc="x">link-exists?</a></span> reports <span class="RktVal">#t</span> for both
+symbolic links and junctions.</p><p class="SHistory">Changed in version 6.0.1.12 of package <span class="stt">base</span>: Added support for links on Windows.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._file-or-directory-type))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-type%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-or-directory-type</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">must-exist?</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">file</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">directory</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">link</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">directory-link</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">must-exist?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Reports whether <span class="RktVar">path</span> refers to a file, directory, link, or
+directory link (in the case of Windows; see also
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._make-file-or-directory-link%29%29" class="RktValLink" data-pltdoc="x">make-file-or-directory-link</a></span>), assuming that <span class="RktVar">path</span> can
+be accessed.</div></p><p>If <span class="RktVar">path</span> cannot be accessed, the result is <span class="RktVal">#f</span> if
+<span class="RktVar">must-exist?</span> is <span class="RktVal">#f</span>, otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> exception is raised.</p><p class="SHistory">Added in version 7.8.0.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._delete-file))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._delete-file%29%29" class="RktValDef RktValLink" data-pltdoc="x">delete-file</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Deletes the file with path <span class="RktVar">path</span> if it exists, otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> exception is raised. If <span class="RktVar">path</span> is a link, the link
+is deleted rather than the destination of the link.</div></p><p>On Windows, if an initial attempt to delete the file fails with a
+permission error and the value of
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-force-delete-permissions%29%29" class="RktValLink" data-pltdoc="x">current-force-delete-permissions</a></span> is true, then
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._delete-file%29%29" class="RktValLink" data-pltdoc="x">delete-file</a></span> attempts to change the file&rsquo;s permissions (to
+allow writes) and then delete the file; the permission change followed
+by deletion is a non-atomic sequence, with no attempt to revert a
+permission change if the deletion fails.</p><p>On Windows, <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._delete-file%29%29" class="RktValLink" data-pltdoc="x">delete-file</a></span> can delete a symbolic link, but not
+a junction. Use <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._delete-directory%29%29" class="RktValLink" data-pltdoc="x">delete-directory</a></span> to delete a junction.</p><p>On Windows, beware that if a file is deleted while it remains in use
+by some process (e.g., a background search indexer), then the file&rsquo;s
+content will eventually go away, but the file&rsquo;s name remains occupied
+until the file is no longer used. As long as the name remains
+occupied, attempts to open, delete, or replace the file will trigger a
+permission error (as opposed to a file-exists error). A common
+technique to avoid this pitfall is to move the file to a generated
+temporary name before deleting it. See also
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._delete-directory%2Ffiles%29%29" class="RktValLink" data-pltdoc="x">delete-directory/files</a></span>.</p><p class="SHistory">Changed in version 6.1.1.7 of package <span class="stt">base</span>: Changed Windows behavior to use
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-force-delete-permissions%29%29" class="RktValLink" data-pltdoc="x">current-force-delete-permissions</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._rename-file-or-directory))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._rename-file-or-directory%29%29" class="RktValDef RktValLink" data-pltdoc="x">rename-file-or-directory</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">old</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">new</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">exists-ok?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">old</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">new</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">exists-ok?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Renames the file or directory with path <span class="RktVar">old</span>&#8212;<wbr></wbr>if it
+exists&#8212;<wbr></wbr>to the path <span class="RktVar">new</span>. If the file or directory is not
+renamed successfully, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> exception is raised.</div></p><p>This procedure can be used to move a file/directory to a different
+directory (on the same filesystem) as well as rename a file/directory within
+a directory. Unless <span class="RktVar">exists-ok?</span>  is provided as a true value,
+<span class="RktVar">new</span> cannot refer to an existing file or directory, but the
+check is not atomic with the rename operation on Unix and Mac OS. Even if
+<span class="RktVar">exists-ok?</span> is true, <span class="RktVar">new</span> cannot refer to an existing
+file when <span class="RktVar">old</span> is a directory, and vice versa.</p><p>If <span class="RktVar">new</span> exists and is replaced, the replacement is atomic
+on Unix and Mac OS, but it is not guaranteed to be atomic on
+Windows. Furthermore, if <span class="RktVar">new</span> exists and is opened by any
+process for reading or writing, then attempting to replace it will
+typically fail on Windows. See also <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._call-with-atomic-output-file%29%29" class="RktValLink" data-pltdoc="x">call-with-atomic-output-file</a></span>.</p><p>If <span class="RktVar">old</span> is a link, the link is renamed rather than the
+destination of the link, and it counts as a file for replacing any
+existing <span class="RktVar">new</span>.</p><p>On Windows, beware that a directory cannot be renamed if any file
+within the directory is open. That constraint is particularly
+problematic if a search indexer is running in the background (as in
+the default Windows configuration). A possible workaround is to
+combine <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._copy-directory%2Ffiles%29%29" class="RktValLink" data-pltdoc="x">copy-directory/files</a></span> and
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._delete-directory%2Ffiles%29%29" class="RktValLink" data-pltdoc="x">delete-directory/files</a></span>, since the latter can deal with open
+files, although that sequence is obviously not atomic and temporarily
+duplicates files.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._file-or-directory-modify-seconds))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-modify-seconds%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-or-directory-modify-seconds</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">secs-n</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">secs-n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-modify-seconds%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-or-directory-modify-seconds</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">secs-n</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">secs-n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-modify-seconds%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-or-directory-modify-seconds</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">secs-n</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">fail-thunk</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">secs-n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">fail-thunk</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:filesystem</a></span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara"><a name="(idx._(gentag._354._(lib._scribblings/reference/reference..scrbl)))"></a>Returns
+the file or directory&rsquo;s last modification date in seconds
+since <a href="time.html#%28tech._the._epoch%29" class="techoutside" data-pltdoc="x"><span class="techinside">the epoch</span></a> (see also <a href="time.html" data-pltdoc="x">Time</a>) when
+<span class="RktVar">secs-n</span> is not provided or is <span class="RktVal">#f</span>.</div></p><p>For FAT filesystems on Windows, directories do not have modification
+dates. Therefore, the creation date is returned for a directory, but
+the modification date is returned for a file.</p><p>If <span class="RktVar">secs-n</span> is provided and not <span class="RktVal">#f</span>, the access and
+modification times of <span class="RktVar">path</span> are set to the given time.</p><p>On error (e.g., if no such file exists), then <span class="RktVar">fail-thunk</span> is
+called (through a tail call) to produce the result of the
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-modify-seconds%29%29" class="RktValLink" data-pltdoc="x">file-or-directory-modify-seconds</a></span> call. If <span class="RktVar">fail-thunk</span> is
+not provided, an error raises <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._file-or-directory-permissions))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-permissions%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-or-directory-permissions</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">mode</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">read</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">write</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">execute</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-permissions%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-or-directory-permissions</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktVar">mode</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">65535</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">bits</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-permissions%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-or-directory-permissions</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktVar">mode</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">65535</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara"><a name="(idx._(gentag._355._(lib._scribblings/reference/reference..scrbl)))"></a>When given one argument or <span class="RktVal">#f</span> as the second argument, returns
+a list containing <a name="(idx._(gentag._356._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">read</span>, <a name="(idx._(gentag._357._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">write</span>,
+and/or <a name="(idx._(gentag._358._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">execute</span> to indicate permission the given file
+or directory path by the current user and group. On Unix and Mac OS,
+permissions are checked for the current effective user instead of the
+real user.</div></p><p>If <span class="RktVal">'</span><span class="RktVal">bits</span> is supplied as the second argument, the result is a
+platform-specific integer encoding of the file or directory properties
+(mostly permissions), and the result is independent of the current
+user and group. The lowest nine bits of the encoding are somewhat
+portable, reflecting permissions for the file or directory&rsquo;s owner,
+members of the file or directory&rsquo;s group, or other users:</p><ul><li><p><span class="RktVal">#o400</span> : owner has read permission</p></li><li><p><span class="RktVal">#o200</span> : owner has write permission</p></li><li><p><span class="RktVal">#o100</span> : owner has execute permission</p></li><li><p><span class="RktVal">#o040</span> : group has read permission</p></li><li><p><span class="RktVal">#o020</span> : group has write permission</p></li><li><p><span class="RktVal">#o010</span> : group has execute permission</p></li><li><p><span class="RktVal">#o004</span> : others have read permission</p></li><li><p><span class="RktVal">#o002</span> : others have write permission</p></li><li><p><span class="RktVal">#o001</span> : others have execute permission</p></li></ul><p>See also <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._user-read-bit%29%29" class="RktValLink" data-pltdoc="x">user-read-bit</a></span>, etc. On Windows, permissions from
+all three (owner, group, and others) are always the same, and read and
+execute permission are always available. On Unix and Mac OS,
+higher bits have a platform-specific meaning.</p><p>If an integer is supplied as the second argument, it is used as an
+encoding of properties (mostly permissions) to install for the file.</p><p>In all modes, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> exception is raised on error (e.g., if no
+such file exists).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._file-or-directory-stat))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-stat%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-or-directory-stat</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">as-link?</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fc%29%29" class="RktValLink" data-pltdoc="x">hash/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-eq~3f%29%29" class="RktValLink" data-pltdoc="x">hash-eq?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">as-link?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara"><a name="(idx._(gentag._359._(lib._scribblings/reference/reference..scrbl)))"></a>Returns a hash with the following keys and values,
+where each value currently is a nonnegative exact integer:</div></p><ul><li><p><a name="(idx._(gentag._360._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">device-id</span> : device ID</p></li><li><p><a name="(idx._(gentag._361._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">inode</span> : inode number</p></li><li><p><a name="(idx._(gentag._362._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">mode</span> : mode bits (see below)</p></li><li><p><a name="(idx._(gentag._363._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">hardlink-count</span> : number of hard links</p></li><li><p><a name="(idx._(gentag._364._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">user-id</span> : numeric user ID of owner</p></li><li><p><a name="(idx._(gentag._365._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">group-id</span> : numeric group ID of owner</p></li><li><p><a name="(idx._(gentag._366._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">device-id-for-special-file</span> : device ID (if special file)</p></li><li><p><a name="(idx._(gentag._367._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">size</span> : size of file or symbolic link in bytes</p></li><li><p><a name="(idx._(gentag._368._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">block-size</span> : size of filesystem blocks</p></li><li><p><a name="(idx._(gentag._369._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">block-count</span> : number of used filesystem blocks</p></li><li><p><a name="(idx._(gentag._370._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">access-time-seconds</span> : last access time in seconds
+since <a href="time.html#%28tech._the._epoch%29" class="techoutside" data-pltdoc="x"><span class="techinside">the epoch</span></a></p></li><li><p><a name="(idx._(gentag._371._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">modify-time-seconds</span> : last modification time in
+seconds since <a href="time.html#%28tech._the._epoch%29" class="techoutside" data-pltdoc="x"><span class="techinside">the epoch</span></a></p></li><li><p><a name="(idx._(gentag._372._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">change-time-seconds</span> : last status change time in
+seconds since <a href="time.html#%28tech._the._epoch%29" class="techoutside" data-pltdoc="x"><span class="techinside">the epoch</span></a></p></li><li><p><a name="(idx._(gentag._373._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">creation-time-seconds</span> : creation time in seconds since
+<a href="time.html#%28tech._the._epoch%29" class="techoutside" data-pltdoc="x"><span class="techinside">the epoch</span></a></p></li><li><p><a name="(idx._(gentag._374._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">access-time-nanoseconds</span> : last access time in
+nanoseconds since <a href="time.html#%28tech._the._epoch%29" class="techoutside" data-pltdoc="x"><span class="techinside">the epoch</span></a></p></li><li><p><a name="(idx._(gentag._375._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">modify-time-nanoseconds</span> : last modification time in
+nanoseconds since <a href="time.html#%28tech._the._epoch%29" class="techoutside" data-pltdoc="x"><span class="techinside">the epoch</span></a></p></li><li><p><a name="(idx._(gentag._376._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">change-time-nanoseconds</span> : last status change time in
+nanoseconds since <a href="time.html#%28tech._the._epoch%29" class="techoutside" data-pltdoc="x"><span class="techinside">the epoch</span></a></p></li><li><p><a name="(idx._(gentag._377._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">creation-time-nanoseconds</span> : creation time in
+nanoseconds since <a href="time.html#%28tech._the._epoch%29" class="techoutside" data-pltdoc="x"><span class="techinside">the epoch</span></a></p></li></ul><p>If <span class="RktVar">as-link?</span> is a true value, then if <span class="RktVar">path</span> refers to a
+symbolic link, the stat information of the link is returned instead of the stat
+information of the referenced filesystem item.</p><p>The mode bits are the bits for permissions and other data, as returned from the
+Posix <span class="stt">stat</span>/<span class="stt">lstat</span> functions or the Windows <span class="stt">_wstat64</span> function,
+respectively. To select portions of the bit pattern, use the constants
+<a name="(idx._(gentag._378._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._user-read-bit%29%29" class="RktValLink" data-pltdoc="x">user-read-bit</a></span>, etc.</p><p>Depending on the operating system and filesystem, the &ldquo;nanoseconds&rdquo;
+timestamps may have less than nanoseconds precision. For example, in one
+environment a timestamp may be <span class="RktVal">1234567891234567891</span> (nanoseconds
+precision) and in another environment <span class="RktVal">1234567891000000000</span> (seconds
+precision).</p><p>Values that aren&rsquo;t available for a platform/filesystem combination may be set
+to <span class="RktVal">0</span>. For example, this applies to the <span class="RktVal">'</span><span class="RktVal">user-id</span> and
+<span class="RktVal">'</span><span class="RktVal">group-id</span> keys on Windows. Also, Posix platforms provide the status
+change timestamp, but not the creation timestamp; for Windows it&rsquo;s the
+opposite.</p><p>If <span class="RktVar">as-link?</span> is <span class="RktVal">#f</span> and <span class="RktVar">path</span> isn&rsquo;t accessible,
+the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> exception is raised. This exception is also raised if
+<span class="RktVar">as-link?</span> is a true value and <span class="RktVar">path</span> can&rsquo;t be resolved, i.e., is
+a dangling link.</p><p class="SHistory">Added in version 8.3.0.7 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._file-or-directory-identity))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-identity%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-or-directory-identity</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">as-link?</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">as-link?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara"><a name="(idx._(gentag._379._(lib._scribblings/reference/reference..scrbl)))"></a>Returns a number that represents the identity of
+<span class="RktVar">path</span> in terms of the device and file or directory that it
+accesses. This function can be used to check whether two paths
+correspond to the same filesystem entity under the assumption that the
+path&rsquo;s entity selection does not change.</div></p><p>If <span class="RktVar">as-link?</span> is a true value, then if <span class="RktVar">path</span> refers to
+a filesystem link, the identity of the link is returned instead of the
+identity of the referenced file or directory (if any).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._file-size))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-size%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-size</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the (logical) size of the specified file in bytes. On Mac
+OS, this size excludes the resource-fork size. On error (e.g., if no
+such file exists), the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> exception is raised.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._copy-file))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._copy-file%29%29" class="RktValDef RktValLink" data-pltdoc="x">copy-file</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">src</span><span class="hspace">&nbsp;</span><span class="RktVar">dest</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">exists-ok?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dest</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">exists-ok?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates the file <span class="RktVar">dest</span> as a copy of <span class="RktVar">src</span>, if
+<span class="RktVar">dest</span> does not already exist. If <span class="RktVar">dest</span> already exists
+and <span class="RktVar">exists-ok?</span> is <span class="RktVal">#f</span>, the copy fails with
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3afilesystem~3aexists~3f%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem:exists?</a></span> exception is raised; otherwise, if <span class="RktVar">dest</span>
+exists, its content is replaced with the content of <span class="RktVar">src</span>. File
+permissions are transferred from <span class="RktVar">src</span> to <span class="RktVar">dest</span>; on Windows,
+the modification time of <span class="RktVar">src</span> is also transferred to <span class="RktVar">dest</span>. If
+<span class="RktVar">src</span> refers to a link, the target of the link is copied,
+rather than the link itself; if <span class="RktVar">dest</span> refers to a link and
+<span class="RktVar">exists-ok?</span> is true, the target of the link is updated.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-file-or-directory-link))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._make-file-or-directory-link%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-file-or-directory-link</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">to</span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">to</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a link <span class="RktVar">path</span> to <span class="RktVar">to</span>. The
+creation will fail if <span class="RktVar">path</span> already exists. The <span class="RktVar">to</span>
+need not refer to an existing file or directory, and <span class="RktVar">to</span> is
+not expanded before writing the link. If the link is not created
+successfully,the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> exception is raised.</div></p><p>On Windows XP and earlier, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aunsupported%29%29" class="RktValLink" data-pltdoc="x">exn:fail:unsupported</a></span> exception is raised. On
+later versions of Windows, the creation of links tends to be
+disallowed by security policies. Windows distinguishes between file
+and directory links, and a directory link is created only if
+<span class="RktVar">to</span> parses syntactically as a directory (see
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3edirectory-path%29%29" class="RktValLink" data-pltdoc="x">path-&gt;directory-path</a></span>). Furthermore, a relative-path link is
+parsed specially by the operating system; see <a href="windowspaths.html" data-pltdoc="x">Windows Paths</a>
+for more information. When <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._make-file-or-directory-link%29%29" class="RktValLink" data-pltdoc="x">make-file-or-directory-link</a></span>
+succeeds, it creates a symbolic link as opposed to a junction or hard
+link. Beware that directory links must be deleted using
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._delete-directory%29%29" class="RktValLink" data-pltdoc="x">delete-directory</a></span> instead of <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._delete-file%29%29" class="RktValLink" data-pltdoc="x">delete-file</a></span>.</p><p class="SHistory">Changed in version 6.0.1.12 of package <span class="stt">base</span>: Added support for links on Windows.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-force-delete-permissions))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-force-delete-permissions%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-force-delete-permissions</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-force-delete-permissions%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-force-delete-permissions</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">any/c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">any/c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines on Windows whether
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._delete-file%29%29" class="RktValLink" data-pltdoc="x">delete-file</a></span> and <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._delete-directory%29%29" class="RktValLink" data-pltdoc="x">delete-directory</a></span> attempt to change a
+file or directory&rsquo;s permissions to delete it. The default value is
+<span class="RktVal">#t</span>.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;directories&quot;">15.2.3<tt>&nbsp;</tt><a name="(part._directories)"></a>Directories</h5><p>See also: <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._rename-file-or-directory%29%29" class="RktValLink" data-pltdoc="x">rename-file-or-directory</a></span>,
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-modify-seconds%29%29" class="RktValLink" data-pltdoc="x">file-or-directory-modify-seconds</a></span>,
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-permissions%29%29" class="RktValLink" data-pltdoc="x">file-or-directory-permissions</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-directory))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-directory</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-directory</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the current directory for resolving
+relative paths.</div></p><p>When the parameter procedure is called to set the current directory,
+the path argument is <a href="pathutils.html#%28tech._cleanse%29" class="techoutside" data-pltdoc="x"><span class="techinside">cleanse</span></a>d using <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._cleanse-path%29%29" class="RktValLink" data-pltdoc="x">cleanse-path</a></span>,
+simplified using <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._simplify-path%29%29" class="RktValLink" data-pltdoc="x">simplify-path</a></span>, and then converted to a
+directory path with <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3edirectory-path%29%29" class="RktValLink" data-pltdoc="x">path-&gt;directory-path</a></span>; cleansing and
+simplification raise an exception if the path is ill-formed. Thus, the
+current value of <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span> is always a cleansed,
+simplified, complete, directory path.</p><p>The path is not checked for existence when the parameter is set.</p><p>On Unix and Mac OS, the initial value of the parameter for a Racket
+process is taken from the <a name="(idx._(gentag._380._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PWD</span> environment
+variable&#8212;<wbr></wbr>if the value of the environment variable identifies the
+same directory as the operating system&rsquo;s report of the current
+directory.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-directory-for-user))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory-for-user%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-directory-for-user</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory-for-user%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-directory-for-user</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span>, but for use only by
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._srcloc-~3estring%29%29" class="RktValLink" data-pltdoc="x">srcloc-&gt;string</a></span> for reporting paths relative to a
+directory.</div></p><p>Normally, <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory-for-user%29%29" class="RktValLink" data-pltdoc="x">current-directory-for-user</a></span> should stay at its
+initial value, reflecting the directory where a user started a
+process. A tool such as DrRacket, however, implicitly lets a user
+select a directory (for the file being edited), in which case updating
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory-for-user%29%29" class="RktValLink" data-pltdoc="x">current-directory-for-user</a></span> makes sense.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-drive))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-drive%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-drive</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns the current drive name Windows. For other platforms, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aunsupported%29%29" class="RktValLink" data-pltdoc="x">exn:fail:unsupported</a></span> exception is raised. The current drive is always the drive
+of the current directory.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._directory-exists~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._directory-exists~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">directory-exists?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">path</span> refers to a directory,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-directory))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._make-directory%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-directory</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">permissions</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">permissions</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">65535</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#o777</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new directory with the path <span class="RktVar">path</span>.  If the directory
+is not created successfully, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> exception is raised.</div></p><p>The <span class="RktVar">permissions</span> argument specifies the permissions of the
+created directory, where an integer representation of permissions is
+treated the same as for <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-permissions%29%29" class="RktValLink" data-pltdoc="x">file-or-directory-permissions</a></span>. On
+Unix and Mac OS, these permissions bits are combined with the
+process&rsquo;s umask. On Windows, <span class="RktVar">permissions</span> is not used.</p><p class="SHistory">Changed in version 8.3.0.5 of package <span class="stt">base</span>: Added the <span class="RktVar">permissions</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._delete-directory))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._delete-directory%29%29" class="RktValDef RktValLink" data-pltdoc="x">delete-directory</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Deletes an existing directory with the path <span class="RktVar">path</span>. If the
+directory is not deleted successfully, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> exception is raised.</div></p><p>On Windows, if an initial attempt to delete the directory fails with a
+permission error and the value of <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-force-delete-permissions%29%29" class="RktValLink" data-pltdoc="x">current-force-delete-permissions</a></span>
+is true, then <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._delete-file%29%29" class="RktValLink" data-pltdoc="x">delete-file</a></span> attempts to change the
+directory&rsquo;s permissions (to allow writes) and then delete the
+directory; the permission change followed by deletion is a non-atomic
+sequence, with no attempt to revert a permission change if the deletion
+fails.</p><p class="SHistory">Changed in version 6.1.1.7 of package <span class="stt">base</span>: Changed Windows behavior to use
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-force-delete-permissions%29%29" class="RktValLink" data-pltdoc="x">current-force-delete-permissions</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._directory-list))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._directory-list%29%29" class="RktValDef RktValLink" data-pltdoc="x">directory-list</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktPn">#:build?</span><span class="hspace">&nbsp;</span><span class="RktVar">build?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">build?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See also the <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-directory%29%29" class="RktValLink" data-pltdoc="x">in-directory</a></span> sequence constructor.</p></blockquote></blockquote></blockquote></div></p><p>Returns a list of all files and directories in the directory specified
+by <span class="RktVar">path</span>. If <span class="RktVar">build?</span> is <span class="RktVal">#f</span>, the resulting
+paths are all <a href="More_Path_Utilities.html#%28tech._path._element%29" class="techoutside" data-pltdoc="x"><span class="techinside">path elements</span></a>; otherwise, the individual results
+are combined with <span class="RktVar">path</span> using <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span>.
+On Windows, an element of the result list may start with
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL\\</span><span class="hspace"></span></span>.</p><p>The resulting paths are always sorted using <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3c~3f%29%29" class="RktValLink" data-pltdoc="x">path&lt;?</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._filesystem-root-list))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._filesystem-root-list%29%29" class="RktValDef RktValLink" data-pltdoc="x">filesystem-root-list</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of all current root directories. Obtaining this list
+can be particularly slow on Windows.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;filesystem-change&quot;">15.2.4<tt>&nbsp;</tt><a name="(part._filesystem-change)"></a>Detecting Filesystem Changes</h5><p>Many operating systems provide notifications for filesystem changes,
+and those notifications are reflected in Racket by <a href="Filesystem.html#%28tech._filesystem._change._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">filesystem
+change events</span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._filesystem-change-evt~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._filesystem-change-evt~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">filesystem-change-evt?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="Filesystem.html#%28tech._filesystem._change._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">filesystem change
+event</span></a>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._filesystem-change-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._filesystem-change-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">filesystem-change-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">failure-thunk</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._filesystem-change-evt~3f%29%29" class="RktValLink" data-pltdoc="x">filesystem-change-evt?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">failure-thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a <a name="(tech._filesystem._change._event)"></a><span style="font-style: italic">filesystem change event</span>, which is a
+<a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> that becomes <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for
+synchronization</span></a> after a change to <span class="RktVar">path</span>:</div></p><ul><li><p>If <span class="RktVar">path</span> refers to a file, the event becomes
+<a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when the file&rsquo;s content or
+attributes change, or when the file is deleted.</p></li><li><p>If <span class="RktVar">path</span> refers to a directory, the event becomes
+<a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> if a file or subdirectory is
+added, renamed, or removed within the directory.</p></li></ul><p>The event also becomes <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> if
+it is passed to <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._filesystem-change-evt-cancel%29%29" class="RktValLink" data-pltdoc="x">filesystem-change-evt-cancel</a></span>.</p><p>Finally, depending on the precision of information available from the
+operating system, the event may become <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for
+synchronization</span></a> under other circumstances. For example, on
+Windows, an event for a file becomes ready when any file changes
+within in the same directory as the file.</p><p>After a <a href="Filesystem.html#%28tech._filesystem._change._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">filesystem change event</span></a> becomes <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for
+synchronization</span></a>, it stays <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a>. The
+event&rsquo;s <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> is the event itself.</p><p>If the current platform does not support filesystem-change
+notifications, then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aunsupported%29%29" class="RktValLink" data-pltdoc="x">exn:fail:unsupported</a></span> exception is raised if
+<span class="RktVar">failure-thunk</span> is not provided as a procedure, or <span class="RktVar">failure-thunk</span> is
+called in tail position if provided. Similarly, if there is any
+operating-system error when creating the event (such as a non-existent
+file), then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> exception is raised or <span class="RktVar">failure-thunk</span>
+is called.</p><p>Creation of a filesystem change event allocates resources at the
+operating-system level. The resources are released at latest when the
+event is sychronized and <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a>, when the
+event is canceled with <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._filesystem-change-evt-cancel%29%29" class="RktValLink" data-pltdoc="x">filesystem-change-evt-cancel</a></span>, or when
+the garbage collector determine that the filesystem change event is
+unreachable. See also <span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span> in <span class="RktVal">'</span><span class="RktVal">fs-change</span> mode.</p><p>A filesystem change event is placed under the management of the
+<a href="eval-model.html#%28tech._current._custodian%29" class="techoutside" data-pltdoc="x"><span class="techinside">current custodian</span></a> when it is created. If the <a href="eval-model.html#%28tech._custodian%29" class="techoutside" data-pltdoc="x"><span class="techinside">custodian</span></a>
+is shut down, <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._filesystem-change-evt-cancel%29%29" class="RktValLink" data-pltdoc="x">filesystem-change-evt-cancel</a></span> is applied to the
+event.</p><p class="SHistory">Changed in version 7.3.0.8 of package <span class="stt">base</span>: Allow <span class="RktVal">#f</span> for <span class="RktVar">failure-thunk</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._filesystem-change-evt-cancel))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._filesystem-change-evt-cancel%29%29" class="RktValDef RktValLink" data-pltdoc="x">filesystem-change-evt-cancel</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">evt</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._filesystem-change-evt~3f%29%29" class="RktValLink" data-pltdoc="x">filesystem-change-evt?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Causes <span class="RktVar">evt</span> to become immediately <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for
+synchronization</span></a>, whether it was ready or not before, and releases the
+resources (at the operating-system level) for tracking filesystem
+changes.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;runtime-path&quot;">15.2.5<tt>&nbsp;</tt><a name="(part._runtime-path)"></a><a name="(mod-path._racket/runtime-path)"></a>Declaring Paths Needed at Run Time</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="Filesystem.html#%28mod-path._racket%2Fruntime-path%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/runtime-path</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="Filesystem.html#%28mod-path._racket%2Fruntime-path%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/runtime-path</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p>The <a href="Filesystem.html#%28mod-path._racket%2Fruntime-path%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/runtime-path</span></a> library provides forms for
+accessing files and directories at run time using a path that are
+usually relative to an enclosing source file. Unlike using
+<span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-path%29%29" class="RktValLink" data-pltdoc="x">collection-path</a></span>, <span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-path</a></span> exposes each
+run-time path to tools like the executable and distribution creators,
+so that files and directories needed at run time are carried along in
+a distribution.</p><p>In addition to the bindings described below,
+<a href="Filesystem.html#%28mod-path._racket%2Fruntime-path%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/runtime-path</span></a> provides <span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._~23~25datum%29%29" class="RktStxLink" data-pltdoc="x">#%datum</a></span> in
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 1, since string constants are often used as
+compile-time expressions with <span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-path</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/runtime-path..rkt)._define-runtime-path))"></a><span title="Provided from: racket/runtime-path | Package: base"><span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-runtime-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-runtime?-id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">maybe-runtime?-id</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:runtime?-id</span><span class="hspace">&nbsp;</span><span class="RktVar">runtime?-id</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Uses <span class="RktVar">expr</span> as both a compile-time (i.e., <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> 1)
+expression and a run-time (i.e., <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> 0) expression. In either
+context, <span class="RktVar">expr</span> should produce a path, a string that represents
+a path, a list of the form <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">lib</span><span class="stt"> </span><span class="RktVar">str</span><span class="stt"> </span><span class="RktMeta">...+</span><span class="RktPn">)</span>, or a list
+of the form <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">so</span><span class="stt"> </span><span class="RktVar">str</span><span class="RktPn">)</span> or <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">so</span><span class="stt"> </span><span class="RktVar">str</span><span class="stt"> </span><span class="RktVar">vers</span><span class="RktPn">)</span>.
+If <span class="RktVar">runtime?-id</span> is provided, then it is bound in the context
+of <span class="RktVar">expr</span> to <span class="RktVal">#f</span> for the compile-time instance of
+<span class="RktVar">expr</span> and <span class="RktVal">#t</span> for the run-time instance of <span class="RktVar">expr</span>.</div></p><p>For run time, <span class="RktVar">id</span> is bound to a path that is based on the
+result of <span class="RktVar">expr</span>. The path is normally computed by taking a
+relative path result from <span class="RktVar">expr</span> and adding it to a path for
+the enclosing file (which is computed as described below). However,
+tools like the executable creator can also arrange (by colluding with
+<a href="Filesystem.html#%28mod-path._racket%2Fruntime-path%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/runtime-path</span></a>) to have a different base path
+substituted in a generated executable. If <span class="RktVar">expr</span> produces an
+absolute path, it is normally returned directly, but again may be
+replaced by an executable creator. In all cases, the executable
+creator preserves the relative locations of all paths within a given
+<a href="collects.html#%28tech._package%29" class="techoutside" data-pltdoc="x"><span class="techinside">package</span></a> (treating paths outside of any package as being together).
+When <span class="RktVar">expr</span> produces a relative or absolute path, then the path
+bound to <span class="RktVar">id</span> is always an absolute path.</p><p>If <span class="RktVar">expr</span> produces a list of the form <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">lib</span><span class="stt"> </span><span class="RktVar">str</span><span class="stt"> </span><span class="RktMeta">...+</span><span class="RktPn">)</span>, the value bound to <span class="RktVar">id</span> is an absolute path. The path
+refers to a collection-based file similar to using the value as a
+<a href="Module_Names_and_Loading.html#%28tech._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path</span></a>.</p><p>If <span class="RktVar">expr</span> produces a list of the form <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">so</span><span class="stt"> </span><span class="RktVar">str</span><span class="RktPn">)</span>
+or <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">so</span><span class="stt"> </span><span class="RktVar">str</span><span class="stt"> </span><span class="RktVar">vers</span><span class="RktPn">)</span>,
+the value bound to <span class="RktVar">id</span> can be either <span class="RktVar">str</span> or an
+absolute path; it is an absolute path when searching in the
+Racket-specific shared-object library directories (as determined by
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=dirs.html%23%2528def._%2528%2528lib._setup%252Fdirs..rkt%2529._get-lib-search-dirs%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">get-lib-search-dirs</a></span>) locates the path. In this way, shared-object
+libraries that are installed specifically for Racket get carried
+along in distributions. The search tries each directory in order;
+within a directory, the search tries using <span class="RktVar">str</span> directly,
+then it tries adding each version specified by <span class="RktVar">vers</span>&#8212;<wbr></wbr>which defaults
+to <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">#f</span><span class="RktVal">)</span>&#8212;<wbr></wbr>along with
+a platform-specific shared-library extension&#8212;<wbr></wbr>as produced by
+<span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">so-suffix</span><span class="RktPn">)</span>. A <span class="RktVar">vers</span>
+can be a string, or it can be a list of strings and <span class="RktVal">#f</span>.</p><p>If <span class="RktVar">expr</span> produces a list of the form <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">share</span><span class="stt"> </span><span class="RktVar">str</span><span class="RktPn">)</span>, the value bound to <span class="RktVar">id</span> can be either <span class="RktVar">str</span> or
+an absolute path; it is an absolute path when searching in the
+directories reported by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=dirs.html%23%2528def._%2528%2528lib._setup%252Fdirs..rkt%2529._find-user-share-dir%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">find-user-share-dir</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=dirs.html%23%2528def._%2528%2528lib._setup%252Fdirs..rkt%2529._find-share-dir%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">find-share-dir</a></span> (in that order) locates the path. In this way,
+files that are installed in Racket&rsquo;s <span class="stt">"share"</span> directory get
+carried along in distributions.</p><p>If <span class="RktVar">expr</span> produces a list of the form <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">module</span><span class="stt"> </span><span class="RktVar">module-path</span><span class="stt"> </span><span class="RktVar">var-ref</span><span class="RktPn">)</span> or <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">so</span><span class="stt"> </span><span class="RktVar">str</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVar">str-or-false</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span>, the value bound to <span class="RktVar">id</span> is a
+<a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a>, where <span class="RktVar">module-path</span> is treated as
+relative (if it is relative) to the module that is the home of the
+<a href="Locations____variable-reference.html#%28tech._variable._reference%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable reference</span></a> <span class="RktVar">var-ref</span>, where <span class="RktVar">var-ref</span>
+can be <span class="RktVal">#f</span> if <span class="RktVar">module-path</span> is absolute. In an
+executable, the corresponding module is carried along, including all
+of its dependencies.</p><p>For compile-time, the <span class="RktVar">expr</span> result is used by an executable
+creator&#8212;<wbr></wbr>but not the result when the containing module is
+compiled. Instead, <span class="RktVar">expr</span> is preserved in the module as a
+compile-time expression (in the sense of
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span>). Later, at the time that an executable is
+created, the compile-time portion of the module is executed (again),
+and the result of <span class="RktVar">expr</span> is the file or directory to be included with the
+executable. The reason for the extra compile-time execution is that
+the result of <span class="RktVar">expr</span> might be platform-dependent, so the result
+should not be stored in the (platform-independent) bytecode form of
+the module; the platform at executable-creation time, however, is the
+same as at run time for the executable. Note that <span class="RktVar">expr</span> is
+still evaluated at run time; consequently, avoid procedures like
+<span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-path%29%29" class="RktValLink" data-pltdoc="x">collection-path</a></span>, which depends on the source installation,
+and instead use relative paths and forms like <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">lib</span><span class="stt"> </span><span class="RktVar">str</span><span class="stt"> </span><span class="RktMeta">...+</span><span class="RktPn">)</span>.</p><p>If a path is needed only on some platforms and not on others, use
+<span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path-list%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-path-list</a></span> with an <span class="RktVar">expr</span> that produces an
+empty list on platforms where the path is not needed.</p><p>Beware that if <span class="RktVar">expr</span> produces the path of a directory when
+creating an executable, the directory&rsquo;s full content (including any
+subdirectories) is included with the executable or eventual
+distribution.</p><p>Also beware that <span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-path</a></span> in a <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> other
+than 0 does not cooperate properly with an executable creator. To work
+around that limitation, put <span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-path</a></span> in a separate
+module&#8212;<wbr></wbr>perhaps a <a href="eval-model.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodule</span></a> created by <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>&#8212;<wbr></wbr>then
+export the definition, and then the module containing the definition
+can be <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>d into any phase level. Using
+<span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-path</a></span> in a <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> other than 0
+logs a warning at expansion time.</p><p>The enclosing path for a <span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-path</a></span> is determined as
+follows from the <span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-path</a></span> syntactic form:</p><ul><li><p>If the form has a source module according to
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-source-module%29%29" class="RktValLink" data-pltdoc="x">syntax-source-module</a></span>, then the source location is
+determined by preserving the original expression as a syntax
+object, extracting its source module path at run time (again
+using <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-source-module%29%29" class="RktValLink" data-pltdoc="x">syntax-source-module</a></span>), and then resolving the
+resulting module path index. Note that <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-source-module%29%29" class="RktValLink" data-pltdoc="x">syntax-source-module</a></span>
+is based on a syntax object&rsquo;s <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a>, not its
+source location.</p></li><li><p>If the expression has no source module, the
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-source%29%29" class="RktValLink" data-pltdoc="x">syntax-source</a></span> location associated with the form is
+used, if is a string or path.</p></li><li><p>If no source module is available, and <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-source%29%29" class="RktValLink" data-pltdoc="x">syntax-source</a></span>
+produces no path, then <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-load-relative-directory</a></span>
+is used if it is not <span class="RktVal">#f</span>. Finally,
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span> is used if all else fails.</p></li></ul><p>In the latter two cases, the path is normally preserved in
+(platform-specific) byte form, but if the enclosing path corresponds to a
+result of <span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-file-path%29%29" class="RktValLink" data-pltdoc="x">collection-file-path</a></span>, then the path is record as
+relative to the corresponding module path.</p><p class="SHistory">Changed in version 6.0.1.6 of package <span class="stt">base</span>: Preserve relative paths only within a package.<br/>Changed in version 7.5.0.7: Added support for <span class="RktVal">'</span><span class="RktVal">share</span> in <span class="RktVar">expr</span>.</p><p>Examples:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Access a file </span><span class="stt">"data.txt"</span><span class="RktCmt"> at run-time that is originally</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">located in the same directory as the module source file:</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-path</a></span><span class="hspace">&nbsp;</span><span class="RktSym">data-file</span><span class="hspace">&nbsp;</span><span class="RktVal">"data.txt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">read-data</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._with-input-from-file%29%29" class="RktValLink" data-pltdoc="x">with-input-from-file</a></span><span class="hspace">&nbsp;</span><span class="RktSym">data-file</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes%29%29" class="RktValLink" data-pltdoc="x">read-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-size%29%29" class="RktValLink" data-pltdoc="x">file-size</a></span><span class="hspace">&nbsp;</span><span class="RktSym">data-file</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Load a platform-specific shared object (using </span><span class="RktSym">ffi-lib</span><span class="RktCmt">)</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">that is located in a platform-specific sub-directory of the</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">module</span><span class="RktCmt">'</span><span class="RktCmt">s source directory:</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-path</a></span><span class="hspace">&nbsp;</span><span class="RktSym">libfit-path</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"compiled"</span><span class="hspace">&nbsp;</span><span class="RktVal">"native"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-library-subpath%29%29" class="RktValLink" data-pltdoc="x">system-library-subpath</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-replace-suffix%29%29" class="RktValLink" data-pltdoc="x">path-replace-suffix</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"libfit"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">so-suffix</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">libfit</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ffi-lib</span><span class="hspace">&nbsp;</span><span class="RktSym">libfit-path</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Load a platform-specific shared object that might be installed</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">as part of the operating system, or might be installed</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">specifically for Racket:</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-path</a></span><span class="hspace">&nbsp;</span><span class="RktSym">libssl-so</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="RktStxLink" data-pltdoc="x">case</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">windows</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">so</span><span class="hspace">&nbsp;</span><span class="RktVal">"ssleay32"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">so</span><span class="hspace">&nbsp;</span><span class="RktVal">"libssl"</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">libssl</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ffi-lib</span><span class="hspace">&nbsp;</span><span class="RktSym">libssl-so</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p class="SHistory">Changed in version 6.4 of package <span class="stt">base</span>: Added <span class="RktPn">#:runtime?-id</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/runtime-path..rkt)._define-runtime-paths))"></a><span title="Provided from: racket/runtime-path | Package: base"><span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-paths%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-runtime-paths</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-runtime?-id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-path</a></span>, but declares and binds multiple
+paths at once. The <span class="RktVar">expr</span> should produce as many values as
+<span class="RktVar">id</span>s.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/runtime-path..rkt)._define-runtime-path-list))"></a><span title="Provided from: racket/runtime-path | Package: base"><span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path-list%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-runtime-path-list</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-runtime?-id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-path</a></span>, but <span class="RktVar">expr</span> should produce a
+list of paths.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/runtime-path..rkt)._define-runtime-module-path-index))"></a><span title="Provided from: racket/runtime-path | Package: base"><span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-module-path-index%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-runtime-module-path-index</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-runtime?-id</span><span class="hspace">&nbsp;</span><span class="RktVar">module-path-expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-path</a></span>, but <span class="RktVar">id</span> is bound to a
+<a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a> that encapsulates the result of
+<span class="RktVar">module-path-expr</span> relative to the enclosing module.</div></p><p>Use <span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-module-path-index%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-module-path-index</a></span> to bind a module path that is
+passed to a reflective function like <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span> while
+also creating a module dependency for building and distributing
+executables.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/runtime-path..rkt)._runtime-require))"></a><span title="Provided from: racket/runtime-path | Package: base"><span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._runtime-require%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">runtime-require</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-module-path-index%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-module-path-index</a></span>, but creates the
+distribution dependency without binding a module path index. When
+<span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._runtime-require%29%29" class="RktStxLink" data-pltdoc="x">runtime-require</a></span> is used multiple times within a module with
+the same <span class="RktVar">module-path</span>, all but the first use expands to an
+empty <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/runtime-path..rkt)._define-runtime-module-path))"></a><span title="Provided from: racket/runtime-path | Package: base"><span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-module-path%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-runtime-module-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-path</a></span>, but <span class="RktVar">id</span> is bound to a
+<a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module path</span></a>. The <a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module path</span></a> for
+<span class="RktVar">id</span> corresponds to <span class="RktVar">module-path</span> (with the same syntax
+as a module path for <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>), which can be relative to the
+enclosing module.</div></p><p>The <span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-module-path-index%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-module-path-index</a></span> form is usually
+preferred, because it creates a weaker link to the referenced module.
+Unlike <span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-module-path-index%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-module-path-index</a></span>, the
+<span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-module-path%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-module-path</a></span> form creates a <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-label%29%29" class="RktStxLink" data-pltdoc="x">for-label</a></span>
+dependency from an enclosing module to <span class="RktVar">module-path</span>. Since the
+dependency is merely <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-label%29%29" class="RktStxLink" data-pltdoc="x">for-label</a></span>, <span class="RktVar">module-path</span> is not
+<a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d or <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed when the enclosing module is
+<a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d or <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (unless such a dependency is
+created by other <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s), but the code for the referenced
+module is loaded when the enclosing module is loaded.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/runtime-path..rkt)._runtime-paths))"></a><span title="Provided from: racket/runtime-path | Package: base"><span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._runtime-paths%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">runtime-paths</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">This form is mainly for use by tools such as executable builders. It
+expands to a quoted list containing the run-time paths declared by
+<span class="RktVar">module-path</span>, returning the compile-time results of the
+declaration <span class="RktSym">expr</span>s, except that paths are converted to byte
+strings. The enclosing module must require (directly or indirectly)
+the module specified by <span class="RktVar">module-path</span>, which is an unquoted
+module path. The resulting list does <span class="emph">not</span> include module paths
+bound through <span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-module-path%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-module-path</a></span>.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;file-lib&quot;">15.2.6<tt>&nbsp;</tt><a name="(part._file-lib)"></a><a name="(mod-path._racket/file)"></a>More File and Directory Utilities</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="Filesystem.html#%28mod-path._racket%2Ffile%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/file</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="Filesystem.html#%28mod-path._racket%2Ffile%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/file</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._file-~3estring))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-~3estring%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-&gt;string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVar">mode-flag</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode-flag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">text</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span></td></tr></table></blockquote></div><div class="SIntrapara">Reads all characters from <span class="RktVar">path</span> and returns them as a string.
+The <span class="RktVar">mode-flag</span> argument is the same as for
+<span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-input-file%29%29" class="RktValLink" data-pltdoc="x">open-input-file</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._file-~3ebytes))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-~3ebytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-&gt;bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVar">mode-flag</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode-flag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">text</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span></td></tr></table></blockquote></div><div class="SIntrapara">Reads all characters from <span class="RktVar">path</span> and returns them as a
+<a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte string</span></a>.  The <span class="RktVar">mode-flag</span> argument is the same as
+for <span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-input-file%29%29" class="RktValLink" data-pltdoc="x">open-input-file</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._file-~3evalue))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-~3evalue%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-&gt;value</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVar">mode-flag</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode-flag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">text</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span></td></tr></table></blockquote></div><div class="SIntrapara">Reads a single S-expression from <span class="RktVar">path</span> using <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>.
+The <span class="RktVar">mode-flag</span> argument is the same as for
+<span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-input-file%29%29" class="RktValLink" data-pltdoc="x">open-input-file</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._file-~3elist))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-~3elist%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-&gt;list</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVar">mode-flag</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode-flag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">text</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span></td></tr></table></blockquote></div><div class="SIntrapara">Repeatedly calls <span class="RktVar">proc</span> to consume the contents of
+<span class="RktVar">path</span>, until <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> is produced. The <span class="RktVar">mode-flag</span>
+argument is the same as for <span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-input-file%29%29" class="RktValLink" data-pltdoc="x">open-input-file</a></span>.  </div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._file-~3elines))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-~3elines%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-&gt;lines</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVar">mode-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:line-mode</span><span class="hspace">&nbsp;</span><span class="RktVar">line-mode</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode-flag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">text</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">line-mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">linefeed</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return-linefeed</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any-one</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">any</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Read all characters from <span class="RktVar">path</span>, breaking them into lines. The
+<span class="RktVar">line-mode</span> argument is the same as the second argument to
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="RktValLink" data-pltdoc="x">read-line</a></span>, but the default is <span class="RktVal">'</span><span class="RktVal">any</span> instead of
+<span class="RktVal">'</span><span class="RktVal">linefeed</span>. The <span class="RktVar">mode-flag</span> argument is the same as for
+<span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-input-file%29%29" class="RktValLink" data-pltdoc="x">open-input-file</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._file-~3ebytes-lines))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-~3ebytes-lines%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-&gt;bytes-lines</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVar">mode-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:line-mode</span><span class="hspace">&nbsp;</span><span class="RktVar">line-mode</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode-flag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">text</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">line-mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">linefeed</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return-linefeed</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any-one</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">any</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-~3elines%29%29" class="RktValLink" data-pltdoc="x">file-&gt;lines</a></span>, but reading bytes and collecting them into
+lines like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-line%29%29" class="RktValLink" data-pltdoc="x">read-bytes-line</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._display-to-file))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._display-to-file%29%29" class="RktValDef RktValLink" data-pltdoc="x">display-to-file</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVar">mode-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:exists</span><span class="hspace">&nbsp;</span><span class="RktVar">exists-flag</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode-flag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">text</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">exists-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">error</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">append</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">update</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">replace</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">truncate</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">truncate/replace</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">error</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Uses <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> to print <span class="RktVar">v</span> to <span class="RktVar">path</span>. The <span class="RktVar">mode-flag</span> and
+<span class="RktVar">exists-flag</span> arguments are the same as for
+<span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-output-file%29%29" class="RktValLink" data-pltdoc="x">open-output-file</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._write-to-file))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._write-to-file%29%29" class="RktValDef RktValLink" data-pltdoc="x">write-to-file</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVar">mode-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:exists</span><span class="hspace">&nbsp;</span><span class="RktVar">exists-flag</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode-flag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">text</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">exists-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">error</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">append</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">update</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">replace</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">truncate</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">truncate/replace</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">error</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._display-to-file%29%29" class="RktValLink" data-pltdoc="x">display-to-file</a></span>, but using <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> instead of <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._display-lines-to-file))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._display-lines-to-file%29%29" class="RktValDef RktValLink" data-pltdoc="x">display-lines-to-file</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">lst</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:separator</span><span class="hspace">&nbsp;</span><span class="RktVar">separator</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVar">mode-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:exists</span><span class="hspace">&nbsp;</span><span class="RktVar">exists-flag</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">separator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#"\n"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode-flag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">text</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">exists-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">error</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">append</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">update</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">replace</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">truncate</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">truncate/replace</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">error</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Displays each element of <span class="RktVar">lst</span> to <span class="RktVar">path</span>, adding
+<span class="RktVar">separator</span> after each element. The <span class="RktVar">mode-flag</span> and
+<span class="RktVar">exists-flag</span> arguments are the same as for
+<span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-output-file%29%29" class="RktValLink" data-pltdoc="x">open-output-file</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top" colspan="3"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._copy-directory/files))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._copy-directory%2Ffiles%29%29" class="RktValDef RktValLink" data-pltdoc="x">copy-directory/files</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">src</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">dest</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:keep-modify-seconds?</span><span class="hspace">&nbsp;</span><span class="RktVar">keep-modify-seconds?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:preserve-links?</span><span class="hspace">&nbsp;</span><span class="RktVar">preserve-links?</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dest</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">keep-modify-seconds?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">preserve-links?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Copies the file or directory <span class="RktVar">src</span> to <span class="RktVar">dest</span>, raising
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> if the file or directory cannot be
+copied, possibly because <span class="RktVar">dest</span> exists already. If <span class="RktVar">src</span>
+is a directory, the copy applies recursively to the directory&rsquo;s
+content. If a source is a link and <span class="RktVar">preserve-links?</span> is <span class="RktVal">#f</span>,
+the target of the link is copied rather than the link itself; if
+<span class="RktVar">preserve-links?</span> is <span class="RktVal">#t</span>, the link is copied.</div></p><p>If <span class="RktVar">keep-modify-seconds?</span> is <span class="RktVal">#f</span>, then file copies
+keep only the properties kept by <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._copy-file%29%29" class="RktValLink" data-pltdoc="x">copy-file</a></span>. If
+<span class="RktVar">keep-modify-seconds?</span> is true, then each file copy also keeps
+the modification date of the original.</p><p class="SHistory">Changed in version 6.3 of package <span class="stt">base</span>: Added the <span class="RktPn">#:preserve-links?</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._delete-directory/files))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._delete-directory%2Ffiles%29%29" class="RktValDef RktValLink" data-pltdoc="x">delete-directory/files</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:must-exist?</span><span class="hspace">&nbsp;</span><span class="RktVar">must-exist?</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">must-exist?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Deletes the file or directory specified by <span class="RktVar">path</span>, raising
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> if the file or directory cannot be
+deleted. If <span class="RktVar">path</span> is a directory, then
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._delete-directory%2Ffiles%29%29" class="RktValLink" data-pltdoc="x">delete-directory/files</a></span> is first applied to each file and
+directory in <span class="RktVar">path</span> before the directory is deleted.</div></p><p>If <span class="RktVar">must-exist?</span> is true, then <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> is
+raised if <span class="RktVar">path</span> does not exist. If <span class="RktVar">must-exist?</span> is
+false, then <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._delete-directory%2Ffiles%29%29" class="RktValLink" data-pltdoc="x">delete-directory/files</a></span> succeeds if <span class="RktVar">path</span>
+does not exist (but a failure is possible if <span class="RktVar">path</span> initially
+exists and is removed by another thread or process before
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._delete-directory%2Ffiles%29%29" class="RktValLink" data-pltdoc="x">delete-directory/files</a></span> deletes it).</p><p>On Windows, <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._delete-directory%2Ffiles%29%29" class="RktValLink" data-pltdoc="x">delete-directory/files</a></span> attempts to move a file
+into the temporary-file directory before deleting it, which avoids
+problems caused by deleting a file that is currently open (e.g., by a
+search indexer running as a background process). If the move attempt
+fails (e.g., because the temporary directory is on a different drive
+than the file), then the file is deleted directly with
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._delete-file%29%29" class="RktValLink" data-pltdoc="x">delete-file</a></span>.</p><p class="SHistory">Changed in version 7.0 of package <span class="stt">base</span>: Added Windows-specific file deletion.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top" colspan="3"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._find-files))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._find-files%29%29" class="RktValDef RktValLink" data-pltdoc="x">find-files</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">predicate</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-path</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:skip-filtered-directory?</span><span class="hspace">&nbsp;</span><span class="RktVar">skip-filtered-directory?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:follow-links?</span><span class="hspace">&nbsp;</span><span class="RktVar">follow-links?</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">predicate</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip-filtered-directory?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">follow-links?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Traverses the filesystem starting at <span class="RktVar">start-path</span> and creates a
+list of all files and directories for which <span class="RktVar">predicate</span> returns
+true. If <span class="RktVar">start-path</span> is <span class="RktVal">#f</span>, then the traversal starts
+from <span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span><span class="RktPn">)</span>. In the resulting list, each
+directory precedes its content.</div></p><p>The <span class="RktVar">predicate</span> procedure is called with a single argument for
+each file or directory. If <span class="RktVar">start-path</span> is <span class="RktVal">#f</span>, the
+argument is a pathname string that is relative to the current
+directory. Otherwise, it is a path building on
+<span class="RktVar">start-path</span>. Consequently, supplying
+<span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span><span class="RktPn">)</span> for <span class="RktVar">start-path</span> is different from
+supplying <span class="RktVal">#f</span>, because <span class="RktVar">predicate</span> receives complete
+paths in the former case and relative paths in the latter.  Another
+difference is that <span class="RktVar">predicate</span> is not called for the current
+directory when <span class="RktVar">start-path</span> is <span class="RktVal">#f</span>.</p><p>If <span class="RktVar">skip-filtered-directory?</span> is true, then when
+<span class="RktVar">predicate</span> returns <span class="RktVal">#f</span> for a directory, the
+directory&rsquo;s content is not traversed.</p><p>If <span class="RktVar">follow-links?</span> is true, the <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._find-files%29%29" class="RktValLink" data-pltdoc="x">find-files</a></span> traversal
+follows links, and links are not included in the result. If
+<span class="RktVar">follow-links?</span> is <span class="RktVal">#f</span>, then links are not followed,
+and links are included in the result.</p><p>If <span class="RktVar">start-path</span> does not refer to an existing file or
+directory, then <span class="RktVar">predicate</span> will be called exactly once with
+<span class="RktVar">start-path</span> as the argument.</p><p>The <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._find-files%29%29" class="RktValLink" data-pltdoc="x">find-files</a></span> procedure raises an exception if it encounters
+a directory for which <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._directory-list%29%29" class="RktValLink" data-pltdoc="x">directory-list</a></span> fails.</p><p class="SHistory">Changed in version 6.3.0.11 of package <span class="stt">base</span>: Added the
+<span class="RktPn">#:skip-filtered-directory?</span>
+argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._pathlist-closure))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._pathlist-closure%29%29" class="RktValDef RktValLink" data-pltdoc="x">pathlist-closure</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">path-list</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:path-filter</span><span class="hspace">&nbsp;</span><span class="RktVar">path-filter</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:follow-links?</span><span class="hspace">&nbsp;</span><span class="RktVar">follow-links?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path-list</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path-filter</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">follow-links?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Given a list of paths, either absolute or relative to the current
+directory, returns a list such that</div></p><ul><li><p>if a nested path is given, all of its ancestors are also
+included in the result (but the same ancestor is not added
+twice);</p></li><li><p>if a path refers to directory, all of its descendants are also
+included in the result, except as omitted by <span class="RktVar">path-filter</span>;</p></li><li><p>ancestor directories appear before their descendants in the
+result list, as long as they are not misordered in the given
+<span class="RktVar">path-list</span>.</p></li></ul><p>If <span class="RktVar">path-filter</span> is a procedure, then it is applied to each
+descendant of a directory. If <span class="RktVar">path-filter</span> returns
+<span class="RktVal">#f</span>, then the descendant (and any of its descendants, in the
+case of a subdirectory) are omitted from the result.</p><p>If <span class="RktVar">follow-links?</span> is true, then the traversal of directories
+and files follows links, and the link paths are not included in the
+result. If <span class="RktVar">follow-links?</span> is <span class="RktVal">#f</span>, then the result list
+includes paths to link and the links are not followed.</p><p class="SHistory">Changed in version 6.3.0.11 of package <span class="stt">base</span>: Added the <span class="RktPn">#:path-filter</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._fold-files))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._fold-files%29%29" class="RktValDef RktValLink" data-pltdoc="x">fold-files</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">init-val</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">follow-links?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">file</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dir</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">link</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">file</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dir</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">link</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">init-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">follow-links?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Traverses the filesystem starting at <span class="RktVar">start-path</span>, calling
+<span class="RktVar">proc</span> on each discovered file, directory, and link. If
+<span class="RktVar">start-path</span> is <span class="RktVal">#f</span>, then the traversal starts from
+<span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span><span class="RktPn">)</span>.</div></p><p>The <span class="RktVar">proc</span> procedure is called with three arguments for each
+file, directory, or link:</p><ul><li><p>If <span class="RktVar">start-path</span> is <span class="RktVal">#f</span>, the first argument is a
+pathname string that is relative to the current directory. Otherwise,
+the first argument is a pathname that starts with
+<span class="RktVar">start-path</span>. Consequently, supplying
+<span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span><span class="RktPn">)</span> for <span class="RktVar">start-path</span> is different
+from supplying <span class="RktVal">#f</span>, because <span class="RktVar">proc</span> receives complete
+paths in the former case and relative paths in the latter. Another
+difference is that <span class="RktVar">proc</span> is not called for the current
+directory when <span class="RktVar">start-path</span> is <span class="RktVal">#f</span>.</p></li><li><p>The second argument is a symbol, either <span class="RktVal">'</span><span class="RktVal">file</span>,
+<span class="RktVal">'</span><span class="RktVal">dir</span>, or <span class="RktVal">'</span><span class="RktVal">link</span>. The second argument can be
+<span class="RktVal">'</span><span class="RktVal">link</span> when <span class="RktVar">follow-links?</span> is <span class="RktVal">#f</span>,
+in which case the filesystem traversal does not follow links. If
+<span class="RktVar">follow-links?</span> is <span class="RktVal">#t</span>, then <span class="RktVar">proc</span>
+will only get a <span class="RktVal">'</span><span class="RktVal">link</span> as a second argument when it
+encounters a dangling symbolic link (one that does not resolve to an
+existing file or directory).</p></li><li><p>The third argument is the accumulated result. For the first
+call to <span class="RktVar">proc</span>, the third argument is <span class="RktVar">init-val</span>. For the
+second call to <span class="RktVar">proc</span> (if any), the third argument is the result
+from the first call, and so on. The result of the last call to
+<span class="RktVar">proc</span> is the result of <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._fold-files%29%29" class="RktValLink" data-pltdoc="x">fold-files</a></span>.</p></li></ul><p>The <span class="RktVar">proc</span> argument is used in an analogous way to the
+procedure argument of <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldl%29%29" class="RktValLink" data-pltdoc="x">foldl</a></span>, where its result is used as the
+new accumulated result.  There is an exception for the case of a
+directory (when the second argument is <span class="RktVal">'</span><span class="RktVal">dir</span>): in this case
+the procedure may return two values, the second indicating whether the
+recursive scan should include the given directory or not.  If it
+returns a single value, the directory is scanned.  In the cases of
+files or links (when the second argument is <span class="RktVal">'</span><span class="RktVal">file</span> or
+<span class="RktVal">'</span><span class="RktVal">link</span>), a second value is permitted but ignored.</p><p>If the <span class="RktVar">start-path</span> is provided but no such path exists, or if
+paths disappear during the scan, then an exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._make-directory*))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-directory%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-directory*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates directory specified by <span class="RktVar">path</span>, creating intermediate
+directories as necessary, and never failing if <span class="RktVar">path</span> exists
+already.</div></p><p>If <span class="RktVar">path</span> is a relative path and the current directory does not
+exist, then <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-directory%2A%29%29" class="RktValLink" data-pltdoc="x">make-directory*</a></span> will not create the current
+directory, because it considers only explicit elements of
+<span class="RktVar">path</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._make-parent-directory*))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-parent-directory%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-parent-directory*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates the parent directory of the path specified by <span class="RktVar">path</span>,
+creating intermediate directories as necessary, and never failing if
+an ancestor of <span class="RktVar">path</span> exists already.</div></p><p>If <span class="RktVar">path</span> is a filesystem root or a relative path with a single
+path element, then no directory is created. Like
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-directory%2A%29%29" class="RktValLink" data-pltdoc="x">make-directory*</a></span>, if <span class="RktVar">path</span> is a relative path and the
+current directory does not exist, then <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-parent-directory%2A%29%29" class="RktValLink" data-pltdoc="x">make-parent-directory*</a></span>
+will not create it.</p><p class="SHistory">Added in version 6.1.1.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._make-temporary-file))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-file%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-temporary-file</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">template</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:copy-from</span><span class="hspace">&nbsp;</span><span class="RktVar">copy-from</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:base-dir</span><span class="hspace">&nbsp;</span><span class="RktVar">base-dir</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">compat-copy-from</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">compat-base-dir</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">template</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">"rkttmp~a"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">copy-from</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">directory</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">base-dir</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">compat-copy-from</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">directory</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">copy-from</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">compat-base-dir</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">base-dir</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new temporary file and returns its path.
+Instead of merely generating a fresh file name, the file is
+actually created; this prevents other threads or processes from
+picking the same temporary name.</div></p><p>The <span class="RktVar">template</span> argument must be a format string
+suitable for use with <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span> and one additional
+string argument (which will contain only digits). By
+default, if <span class="RktVar">template</span> produces a relative path, it
+is combined with the result of
+<span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">temp-dir</span><span class="RktPn">)</span> using
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span>; alternatively, <span class="RktVar">template</span> may
+produce an absolute path, in which case
+<span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">temp-dir</span><span class="RktPn">)</span> is not consulted. If
+<span class="RktVar">base-dir</span> is provided and non-<span class="RktVal">#false</span>,
+<span class="RktVar">template</span> must not produce a <a href="Manipulating_Paths.html#%28tech._complete%29" class="techoutside" data-pltdoc="x"><span class="techinside">complete</span></a> path,
+and <span class="RktVar">base-dir</span> will be used instead of
+<span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">temp-dir</span><span class="RktPn">)</span>. Using
+<span class="RktVar">base-dir</span> is generally more reliable than including
+directory components in <span class="RktVar">template</span>: it avoids subtle
+bugs from manipulating paths as string and eleminates the
+need to sanitize <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span> escape sequences.</p><p>On Windows, <span class="RktVar">template</span> may produce an absolute path
+which is not a complete path (see <a href="windowspaths.html" data-pltdoc="x">Windows Paths</a>)
+when <span class="RktVar">base-dir</span> is absent or <span class="RktVal">#f</span> (in which
+case it will be resolved relative to
+<span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span><span class="RktPn">)</span>) or if <span class="RktVar">base-dir</span> is a
+drive specification (in which case it will be used as with
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span>). If <span class="RktVar">base-dir</span> is any other kind
+of path, it is an error for <span class="RktVar">template</span> to produce an
+absolute path.</p><p>When the <span class="RktVar">template</span> argument is not provided, if
+there is source location information for the callsite of
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-file%29%29" class="RktValLink" data-pltdoc="x">make-temporary-file</a></span>, a template string is generated
+based on the source location: the default is
+<span class="RktVal">"rkttmp~a"</span> only when no source location information
+is available (e.g<span class="Sendabbrev">.</span> if <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-file%29%29" class="RktValLink" data-pltdoc="x">make-temporary-file</a></span> is used
+in a higher-order position).</p><p>If <span class="RktVar">copy-from</span> is provided as path, the temporary file
+is created as a copy of the named file (using <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._copy-file%29%29" class="RktValLink" data-pltdoc="x">copy-file</a></span>). If
+<span class="RktVar">copy-from</span> is <span class="RktVal">#f</span>, the temporary file is
+created as empty. As a special case, for backwards compatibility,
+if <span class="RktVar">copy-from</span> is <span class="RktVal">'</span><span class="RktVal">directory</span>,
+then the temporary &ldquo;file&rdquo; is created as a directory:
+for clarity, prefer <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-directory%29%29" class="RktValLink" data-pltdoc="x">make-temporary-directory</a></span> for creating
+temporary directories.</p><p>When a temporary file is created, it is not opened for reading or
+writing when the path is returned. The client program calling
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-file%29%29" class="RktValLink" data-pltdoc="x">make-temporary-file</a></span> is expected to open the file with the
+desired access and flags (probably using the <span class="RktVal">'</span><span class="RktVal">truncate</span> flag;
+see <span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-output-file%29%29" class="RktValLink" data-pltdoc="x">open-output-file</a></span>) and to delete it when it is no longer
+needed.</p><p>The by-position arguments <span class="RktVar">compat-copy-from</span> and
+<span class="RktVar">compat-base-dir</span> are for backwards compatibility:
+if provided, they take precedence over the <span class="RktPn">#:copy-from</span> and
+<span class="RktPn">#:base-dir</span> keyword variants.
+Supplying by-position arguments prevents <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-file%29%29" class="RktValLink" data-pltdoc="x">make-temporary-file</a></span>
+from generating a <span class="RktVar">template</span> using the source location.</p><p class="SHistory">Changed in version 8.4.0.3 of package <span class="stt">base</span>: Added the <span class="RktPn">#:copy-from</span> and <span class="RktPn">#:base-dir</span> arguments.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._make-temporary-directory))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-directory%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-temporary-directory</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">template</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:base-dir</span><span class="hspace">&nbsp;</span><span class="RktVar">base-dir</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">template</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">"rkttmp~a"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">base-dir</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-file%29%29" class="RktValLink" data-pltdoc="x">make-temporary-file</a></span>, but
+ creates a directory, rather than a regular file.</div></p><p>As with <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-file%29%29" class="RktValLink" data-pltdoc="x">make-temporary-file</a></span>, if the
+ <span class="RktVar">template</span> argument is not provided, a template
+ string is generated from the source location of the call to
+ <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-directory%29%29" class="RktValLink" data-pltdoc="x">make-temporary-directory</a></span> when possible: the default
+ is <span class="RktVal">"rkttmp~a"</span> only when no source location
+ information is available.</p><p class="SHistory">Added in version 8.4.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._make-temporary-file*))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-file%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-temporary-file*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prefix</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">suffix</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:copy-from</span><span class="hspace">&nbsp;</span><span class="RktVar">copy-from</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:base-dir</span><span class="hspace">&nbsp;</span><span class="RktVar">base-dir</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">suffix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">copy-from</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">base-dir</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._make-temporary-directory*))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-directory%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-temporary-directory*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prefix</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">suffix</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:base-dir</span><span class="hspace">&nbsp;</span><span class="RktVar">base-dir</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">suffix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">base-dir</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-file%29%29" class="RktValLink" data-pltdoc="x">make-temporary-file</a></span> and
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-directory%29%29" class="RktValLink" data-pltdoc="x">make-temporary-directory</a></span>, respectively, but, rather
+than using a template for <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span>, the path is based
+on <span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-append%29%29" class="RktValLink" data-pltdoc="x">bytes-append</a></span><span class="stt"> </span><span class="RktVar">prefix</span><span class="stt"> </span><span class="RktSym">generated</span><span class="stt"> </span><span class="RktVar">suffix</span><span class="RktPn">)</span>, where
+<span class="RktSym">generated</span> is a byte string chosen by the
+implementation to produce a unique path. If there is source
+location information for the callsite of
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-file%2A%29%29" class="RktValLink" data-pltdoc="x">make-temporary-file*</a></span> or
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-directory%2A%29%29" class="RktValLink" data-pltdoc="x">make-temporary-directory*</a></span>, <span class="RktSym">generated</span> will
+incorporate that information. The resulting path is combined
+with <span class="RktVar">base-dir</span> as with <span class="RktSym">make-temorary-file</span>.</div></p><p class="SHistory">Added in version 8.4.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top" colspan="3"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._call-with-atomic-output-file))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._call-with-atomic-output-file%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-atomic-output-file</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">file</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:security-guard</span><span class="hspace">&nbsp;</span><span class="RktVar">security-guard</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:rename-fail-handler</span><span class="hspace">&nbsp;</span><span class="RktVar">rename-fail-handler</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">file</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">tmp-path</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="RktPn">]</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">security-guard</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._security-guard~3f%29%29" class="RktValLink" data-pltdoc="x">security-guard?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">rename-fail-handler</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3afilesystem~3f%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">path&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Opens a temporary file for writing in the same directory as
+<span class="RktVar">file</span>, calls <span class="RktVar">proc</span> to write to the temporary file, and
+then atomically (except on Windows) moves the temporary file in place of <span class="RktVar">file</span>.
+The move simply uses <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._rename-file-or-directory%29%29" class="RktValLink" data-pltdoc="x">rename-file-or-directory</a></span> on Unix
+and Mac OS, and it uses <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._rename-file-or-directory%29%29" class="RktValLink" data-pltdoc="x">rename-file-or-directory</a></span> on Windows
+if <span class="RktVar">rename-fail-handler</span> is provided; otherwise, on Windows,
+the moves uses an extra rename step (see below) on Windows
+to avoid problems due to concurrent readers of <span class="RktVar">file</span>.</div></p><p>The <span class="RktVar">proc</span> function is called with an output port for the
+temporary file, plus the path of the temporary file. The result of
+<span class="RktVar">proc</span> is the result of <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._call-with-atomic-output-file%29%29" class="RktValLink" data-pltdoc="x">call-with-atomic-output-file</a></span>.</p><p>The <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._call-with-atomic-output-file%29%29" class="RktValLink" data-pltdoc="x">call-with-atomic-output-file</a></span> function arranges to delete
+temporary files on exceptions.</p><p>Windows prevents programs from deleting or replacing files that are
+open, but it allows renaming of open files. Therefore, on Windows,
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._call-with-atomic-output-file%29%29" class="RktValLink" data-pltdoc="x">call-with-atomic-output-file</a></span> by default creates a second
+temporary file <span class="RktVar">extra-tmp-file</span>, renames <span class="RktVar">file</span> to
+<span class="RktVar">extra-tmp-file</span>, renames the temporary file written by
+<span class="RktVar">proc</span> to <span class="RktVar">file</span>, and finally deletes
+<span class="RktVar">extra-tmp-file</span>. Since that process is not atomic, however,
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._rename-file-or-directory%29%29" class="RktValLink" data-pltdoc="x">rename-file-or-directory</a></span> is used if
+<span class="RktVar">rename-fail-handler</span> is provided, where
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._rename-file-or-directory%29%29" class="RktValLink" data-pltdoc="x">rename-file-or-directory</a></span> has some chance of being atomic,
+since that the source and destination of the moves will be in the same
+directory; any filesystem exception while attempting to rename the
+file is send to <span class="RktVar">rename-fail-handler</span>, which can
+re-<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span> the exception or simply return to try again, perhaps
+after a delay. In addition to a filesystem exception, the
+<span class="RktVar">rename-fail-handler</span> procedure also receives the temporary
+file path to be moved to <span class="RktSym">path</span>. The
+<span class="RktVar">rename-fail-handler</span> argument is used only on Windows.</p><p class="SHistory">Changed in version 7.1.0.6 of package <span class="stt">base</span>: Added the <span class="RktPn">#:rename-fail-handler</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._get-preference))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._get-preference%29%29" class="RktValDef RktValLink" data-pltdoc="x">get-preference</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">failure-thunk</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">flush-mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">filename</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:use-lock?</span><span class="hspace">&nbsp;</span><span class="RktVar">use-lock?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:timeout-lock-there</span><span class="hspace">&nbsp;</span><span class="RktVar">timeout-lock-there</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:lock-there</span><span class="hspace">&nbsp;</span><span class="RktVar">lock-there</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">failure-thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">flush-mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">timestamp</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">filename</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">string-path?</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">use-lock?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">timeout-lock-there</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">lock-there</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-handle-get-preference-locked%29%29" class="RktValLink" data-pltdoc="x">make-handle-get-preference-locked</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktVal">0.01</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span><span class="RktVar">failure-thunk</span><span class="hspace">&nbsp;</span><span class="RktVar">flush-mode</span><span class="hspace">&nbsp;</span><span class="RktVar">filename</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">#:lock-there</span><span class="hspace">&nbsp;</span><span class="RktVar">timeout-lock-there</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Extracts a preference value from the file designated by
+<span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">pref-file</span><span class="RktPn">)</span>, or by <span class="RktVar">filename</span> if it
+is provided and is not <span class="RktVal">#f</span>.  In the former case, if the
+preference file doesn&rsquo;t exist, <span class="RktSym">get-preferences</span> attempts to
+read an <a href="Filesystem.html#%28elem._old-prefs%29" data-pltdoc="x">old preferences file</a>, and then a
+<span class="stt">"racket-prefs.rktd"</span> file in the configuration directory
+(as reported by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=dirs.html%23%2528def._%2528%2528lib._setup%252Fdirs..rkt%2529._find-config-dir%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">find-config-dir</a></span>), instead. If none of those
+files exists, the preference set is empty.</div></p><p>The preference file should contain a list of symbol&ndash;value lists
+written with the default parameter settings.  Keys
+starting with <span class="RktSym">racket:</span>, <span class="RktSym">mzscheme:</span>, <span class="RktSym">mred:</span>,
+and <span class="RktSym">plt:</span> in any letter case are reserved for use by Racket
+implementors. If the preference file does not contain a list
+of symbol&ndash;value lists, an error is logged via <span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-error%29%29" class="RktStxLink" data-pltdoc="x">log-error</a></span>
+and <span class="RktVar">failure-thunk</span> is called.</p><p>The result of <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._get-preference%29%29" class="RktValLink" data-pltdoc="x">get-preference</a></span> is the value associated with
+<span class="RktVar">name</span> if it exists in the association list, or the result of
+calling <span class="RktVar">failure-thunk</span> otherwise.</p><p>Preference settings are cached (weakly) across calls to
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._get-preference%29%29" class="RktValLink" data-pltdoc="x">get-preference</a></span>, using <span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3ecomplete-path%29%29" class="RktValLink" data-pltdoc="x">path-&gt;complete-path</a></span><span class="stt"> </span><span class="RktVar">filename</span><span class="RktPn">)</span>
+as a cache key. If <span class="RktVar">flush-mode</span> is provided as <span class="RktVal">#f</span>, the
+cache is used instead of re-consulting the preferences file. If
+<span class="RktVar">flush-mode</span> is provided as <span class="RktVal">'</span><span class="RktVal">timestamp</span> (the default),
+then the cache is used only if the file has a timestamp that is the
+same as the last time the file was read. Otherwise, the file is
+re-consulted.</p><p>On platforms for which <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._preferences-lock-file-mode%29%29" class="RktValLink" data-pltdoc="x">preferences-lock-file-mode</a></span> returns
+<span class="RktVal">'</span><span class="RktVal">file-lock</span> and when <span class="RktVar">use-lock?</span> is true,
+preference-file reading is guarded by a lock; multiple readers can
+share the lock, but writers take the lock exclusively. If the
+preferences file cannot be read because the lock is unavailable,
+<span class="RktVar">lock-there</span> is called on the path of the lock file; if
+<span class="RktVar">lock-there</span> is <span class="RktVal">#f</span>, an exception is raised. The
+default <span class="RktVar">lock-there</span> handler retries about 5 times (with
+increasing delays between each attempt) before trying
+<span class="RktVar">timeout-lock-there</span>, and the default <span class="RktVar">timeout-lock-there</span>
+triggers an exception.</p><p>See also <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._put-preferences%29%29" class="RktValLink" data-pltdoc="x">put-preferences</a></span>. For a more elaborate preference
+system, see <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=framework&amp;rel=Preferences__Textual.html%23%2528def._%2528%2528lib._framework%252Fpreferences..rkt%2529._preferences%7E3aget%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">preferences:get</a></span>.</p><p><a name="(elem._old-prefs)"></a><span style="font-weight: bold">Old preferences files</span>: When a
+<span class="RktVar">filename</span> is not provided and the file indicated by
+<span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">pref-file</span><span class="RktPn">)</span> does not exist, the following
+paths are checked for compatibility with old versions of Racket:</p><ul><li><p>Windows: <span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">pref-dir</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">up</span><span class="stt"> </span><span class="RktVal">"PLT Scheme"</span><span class="stt"> </span><span class="RktVal">"plt-prefs.ss"</span><span class="RktPn">)</span></p></li><li><p>Mac OS: <span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">pref-dir</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">"org.plt-scheme.prefs.ss"</span><span class="RktPn">)</span></p></li><li><p>Unix: <span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._expand-user-path%29%29" class="RktValLink" data-pltdoc="x">expand-user-path</a></span><span class="stt"> </span><span class="RktVal">"~/.plt-scheme/plt-prefs.ss"</span><span class="RktPn">)</span></p></li></ul><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._put-preferences))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._put-preferences%29%29" class="RktValDef RktValLink" data-pltdoc="x">put-preferences</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">names</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">vals</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">locked-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">filename</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">names</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vals</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">locked-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">filename</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Installs a set of preference values and writes all current values to
+the preference file designated by <span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">pref-file</span><span class="RktPn">)</span>, or <span class="RktVar">filename</span> if it is supplied and not
+<span class="RktVal">#f</span>.</div></p><p>The <span class="RktVar">names</span> argument supplies the preference names, and
+<span class="RktVar">vals</span> must have the same length as <span class="RktVar">names</span>. Each
+element of <span class="RktVar">vals</span> must be an instance of a built-in data type
+whose <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> output is <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>able (i.e., the
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-unreadable%29%29" class="RktValLink" data-pltdoc="x">print-unreadable</a></span> parameter is set to <span class="RktVal">#f</span> while
+writing preferences).</p><p>Current preference values are read from the preference file before
+updating, and a write lock is held starting before the file
+read, and lasting until after the preferences file is updated. The
+lock is implemented by the existence of a file in the same directory
+as the preference file; see <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._preferences-lock-file-mode%29%29" class="RktValLink" data-pltdoc="x">preferences-lock-file-mode</a></span> for
+more information. If the directory of the preferences file does
+not already exist, it is created.</p><p>If the write lock is already held, then
+<span class="RktVar">locked-proc</span> is called with a single argument: the path of the lock
+file. The default <span class="RktVar">locked-proc</span> (used when the <span class="RktVar">locked-proc</span>
+argument is <span class="RktVal">#f</span>) reports an error; an alternative
+thunk might wait a while and try again, or give the user the choice to
+delete the lock file (in case a previous update attempt encountered
+disaster and locks are implemented by the presence of the lock file).</p><p>If <span class="RktVar">filename</span> is <span class="RktVal">#f</span> or not supplied, and the
+preference file does not already exist, then values read from the
+<span class="stt">"defaults"</span> collection (if any) are written for preferences
+that are not mentioned in <span class="RktVar">names</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._preferences-lock-file-mode))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._preferences-lock-file-mode%29%29" class="RktValDef RktValLink" data-pltdoc="x">preferences-lock-file-mode</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exists</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">file-lock</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Reports the way that the lock file is used to implement
+preference-file locking on the current platform.</div></p><p>The <span class="RktVal">'</span><span class="RktVal">exists</span> mode is currently used on all platforms except
+Windows. In <span class="RktVal">'</span><span class="RktVal">exists</span> mode, the existence of the lock file
+indicates that a write lock is held, and readers need no lock (because
+the preferences file is atomically updated via
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._rename-file-or-directory%29%29" class="RktValLink" data-pltdoc="x">rename-file-or-directory</a></span>).</p><p>The <span class="RktVal">'</span><span class="RktVal">file-lock</span> mode is currently used on Windows. In
+<span class="RktVal">'</span><span class="RktVal">file-lock</span> mode, shared and exclusive locks (in the sense of
+<span class="RktSym"><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-try-file-lock~3f%29%29" class="RktValLink" data-pltdoc="x">port-try-file-lock?</a></span>) on the lock file reflect reader and
+writer locks on the preference-file content. (The preference file
+itself is not locked, because a lock would interfere with replacing
+the file via <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._rename-file-or-directory%29%29" class="RktValLink" data-pltdoc="x">rename-file-or-directory</a></span>.)</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._make-handle-get-preference-locked))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-handle-get-preference-locked%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-handle-get-preference-locked</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">delay</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">failure-thunk</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">flush-mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">filename</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:lock-there</span><span class="hspace">&nbsp;</span><span class="RktVar">lock-there</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:max-delay</span><span class="hspace">&nbsp;</span><span class="RktVar">max-delay</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">delay</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">failure-thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">flush-mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">timestamp</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">filename</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lock-there</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">max-delay</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0.2</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a procedure suitable for use as the <span class="RktPn">#:lock-there</span>
+argument to <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._get-preference%29%29" class="RktValLink" data-pltdoc="x">get-preference</a></span>, where the <span class="RktVar">name</span>,
+<span class="RktVar">failure-thunk</span>, <span class="RktVar">flush-mode</span>, and <span class="RktVar">filename</span>
+are all passed on to <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._get-preference%29%29" class="RktValLink" data-pltdoc="x">get-preference</a></span> by the result procedure
+to retry the preferences lookup.</div></p><p>Before calling <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._get-preference%29%29" class="RktValLink" data-pltdoc="x">get-preference</a></span>, the result procedure uses
+<span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._sleep%29%29" class="RktValLink" data-pltdoc="x">sleep</a></span><span class="stt"> </span><span class="RktVar">delay</span><span class="RktPn">)</span> to pause. Then, if <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="stt"> </span><span class="RktVal">2</span><span class="stt"> </span><span class="RktVar">delay</span><span class="RktPn">)</span> is less
+than <span class="RktVar">max-delay</span>, the result procedure calls
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-handle-get-preference-locked%29%29" class="RktValLink" data-pltdoc="x">make-handle-get-preference-locked</a></span> to generate a new retry
+procedure to pass to <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._get-preference%29%29" class="RktValLink" data-pltdoc="x">get-preference</a></span>, but with a
+<span class="RktVar">delay</span> of <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="stt"> </span><span class="RktVal">2</span><span class="stt"> </span><span class="RktVar">delay</span><span class="RktPn">)</span>. If <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="stt"> </span><span class="RktVal">2</span><span class="stt"> </span><span class="RktVar">delay</span><span class="RktPn">)</span> is not
+less than <span class="RktVar">max-delay</span>, then <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._get-preference%29%29" class="RktValLink" data-pltdoc="x">get-preference</a></span> is called
+with the given <span class="RktVar">lock-there</span>, instead.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._call-with-file-lock/timeout))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._call-with-file-lock%2Ftimeout%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-file-lock/timeout</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">filename</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">kind</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">thunk</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">failure-thunk</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:lock-file</span><span class="hspace">&nbsp;</span><span class="RktVar">lock-file</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:delay</span><span class="hspace">&nbsp;</span><span class="RktVar">delay</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:max-delay</span><span class="hspace">&nbsp;</span><span class="RktVar">max-delay</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">filename</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">kind</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">shared</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exclusive</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">failure-thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lock-file</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">delay</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._negative~3f%29%29" class="RktValLink" data-pltdoc="x">negative?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0.01</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">max-delay</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._negative~3f%29%29" class="RktValLink" data-pltdoc="x">negative?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0.2</span></td></tr></table></blockquote></div><div class="SIntrapara">Obtains a lock for the filename <span class="RktVar">lock-file</span> and then calls
+<span class="RktVar">thunk</span>.  The <span class="RktVar">filename</span> argument specifies a file path
+prefix that is used only to generate the lock filename when
+<span class="RktVar">lock-file</span> is <span class="RktVal">#f</span>.  Specifically, when
+<span class="RktVar">lock-file</span> is <span class="RktVal">#f</span>, then
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._call-with-file-lock%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">call-with-file-lock/timeout</a></span> uses <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-lock-file-name%29%29" class="RktValLink" data-pltdoc="x">make-lock-file-name</a></span>
+to build the lock filename. If the lock file does not yet exist, it is
+created; beware that the lock file is <span class="emph">not</span> deleted by
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._call-with-file-lock%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">call-with-file-lock/timeout</a></span>.</div></p><p>When <span class="RktVar">thunk</span> returns,
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._call-with-file-lock%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">call-with-file-lock/timeout</a></span> releases the lock, returning the result of
+<span class="RktVar">thunk</span>. The <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._call-with-file-lock%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">call-with-file-lock/timeout</a></span> function will retry
+after <span class="RktVar">delay</span> seconds and continue retrying with exponential backoff
+until delay reaches <span class="RktVar">max-delay</span>. If
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._call-with-file-lock%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">call-with-file-lock/timeout</a></span> fails to obtain the lock,
+<span class="RktVar">failure-thunk</span> is called in tail position.  The <span class="RktVar">kind</span> argument
+specifies whether the lock is <span class="RktVal">'</span><span class="RktVal">shared</span> or <span class="RktVal">'</span><span class="RktVal">exclusive</span>
+in the sense of <span class="RktSym"><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-try-file-lock~3f%29%29" class="RktValLink" data-pltdoc="x">port-try-file-lock?</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._call-with-file-lock%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">call-with-file-lock/timeout</a></span><span class="hspace">&nbsp;</span><span class="RktSym">filename</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exclusive</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"File is locked\n"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Failed to obtain lock for file\n"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">File is locked</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._call-with-file-lock%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">call-with-file-lock/timeout</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exclusive</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._call-with-file-lock%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">call-with-file-lock/timeout</a></span><span class="hspace">&nbsp;</span><span class="RktSym">filename</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">shared</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Shouldn't get here\n"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Failed to obtain lock for file\n"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Shouldn't get here either\n"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:lock-file</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-lock-file-name%29%29" class="RktValLink" data-pltdoc="x">make-lock-file-name</a></span><span class="hspace">&nbsp;</span><span class="RktSym">filename</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">Failed to obtain lock for file</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/file..rkt)._make-lock-file-name))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-lock-file-name%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-lock-file-name</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-lock-file-name%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-lock-file-name</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dir</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dir</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-element~3f%29%29" class="RktValLink" data-pltdoc="x">path-element?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a lock filename by prepending <span class="RktVal">"_LOCK"</span> on Windows
+(i.e., when <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=cross-system.html%23%2528def._%2528%2528lib._setup%252Fcross-system..rkt%2529._cross-system-type%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cross-system-type</a></span> reports <span class="RktVal">'</span><span class="RktVal">windows</span>) or
+<span class="RktVal">".LOCK"</span> on other platforms to the file portion of the path.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-lock-file-name%29%29" class="RktValLink" data-pltdoc="x">make-lock-file-name</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"/home/george/project/important-file"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;path:/home/george/project/.LOCKimportant-file&gt;</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._file-type-bits))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-type-bits%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-type-bits</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o170000</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._socket-type-bits))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._socket-type-bits%29%29" class="RktValDef RktValLink" data-pltdoc="x">socket-type-bits</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o140000</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._symbolic-link-type-bits))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._symbolic-link-type-bits%29%29" class="RktValDef RktValLink" data-pltdoc="x">symbolic-link-type-bits</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o120000</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._regular-file-type-bits))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._regular-file-type-bits%29%29" class="RktValDef RktValLink" data-pltdoc="x">regular-file-type-bits</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o100000</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._block-device-type-bits))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._block-device-type-bits%29%29" class="RktValDef RktValLink" data-pltdoc="x">block-device-type-bits</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o060000</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._directory-type-bits))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._directory-type-bits%29%29" class="RktValDef RktValLink" data-pltdoc="x">directory-type-bits</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o040000</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._character-device-type-bits))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._character-device-type-bits%29%29" class="RktValDef RktValLink" data-pltdoc="x">character-device-type-bits</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o020000</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._fifo-type-bits))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._fifo-type-bits%29%29" class="RktValDef RktValLink" data-pltdoc="x">fifo-type-bits</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o010000</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._set-user-id-bit))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._set-user-id-bit%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-user-id-bit</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o004000</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._set-group-id-bit))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._set-group-id-bit%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-group-id-bit</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o002000</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._sticky-bit))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._sticky-bit%29%29" class="RktValDef RktValLink" data-pltdoc="x">sticky-bit</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o001000</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._user-permission-bits))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._user-permission-bits%29%29" class="RktValDef RktValLink" data-pltdoc="x">user-permission-bits</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o000700</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._user-read-bit))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._user-read-bit%29%29" class="RktValDef RktValLink" data-pltdoc="x">user-read-bit</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o000400</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._user-write-bit))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._user-write-bit%29%29" class="RktValDef RktValLink" data-pltdoc="x">user-write-bit</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o000200</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._user-execute-bit))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._user-execute-bit%29%29" class="RktValDef RktValLink" data-pltdoc="x">user-execute-bit</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o000100</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._group-permission-bits))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._group-permission-bits%29%29" class="RktValDef RktValLink" data-pltdoc="x">group-permission-bits</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o000070</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._group-read-bit))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._group-read-bit%29%29" class="RktValDef RktValLink" data-pltdoc="x">group-read-bit</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o000040</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._group-write-bit))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._group-write-bit%29%29" class="RktValDef RktValLink" data-pltdoc="x">group-write-bit</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o000020</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._group-execute-bit))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._group-execute-bit%29%29" class="RktValDef RktValLink" data-pltdoc="x">group-execute-bit</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o000010</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._other-permission-bits))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._other-permission-bits%29%29" class="RktValDef RktValLink" data-pltdoc="x">other-permission-bits</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o000007</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._other-read-bit))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._other-read-bit%29%29" class="RktValDef RktValLink" data-pltdoc="x">other-read-bit</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o000004</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._other-write-bit))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._other-write-bit%29%29" class="RktValDef RktValLink" data-pltdoc="x">other-write-bit</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o000002</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/file..rkt)._other-execute-bit))"></a><span title="Provided from: racket/file, racket | Package: base"><span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._other-execute-bit%29%29" class="RktValDef RktValLink" data-pltdoc="x">other-execute-bit</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#o000001</span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Constants that are useful with <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-permissions%29%29" class="RktValLink" data-pltdoc="x">file-or-directory-permissions</a></span>,
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-stat%29%29" class="RktValLink" data-pltdoc="x">file-or-directory-stat</a></span> and bitwise operations such as
+<span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-ior%29%29" class="RktValLink" data-pltdoc="x">bitwise-ior</a></span>, and <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-and%29%29" class="RktValLink" data-pltdoc="x">bitwise-and</a></span>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="windowspaths.html" title="backward to &quot;15.1.4 Windows Paths&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="os.html" title="up to &quot;15 Operating System&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="networking.html" title="forward to &quot;15.3 Networking&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Generating_A_Unit_from_Context.html b/clones/docs.racket-lang.org/reference/Generating_A_Unit_from_Context.html
new file mode 100644
index 00000000..ffc0dd48
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Generating_A_Unit_from_Context.html
@@ -0,0 +1,9 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7.5&nbsp;Generating A Unit from Context</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="creatingunits.html" class="tocviewlink" data-pltdoc="x">Creating Units</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="invokingunits.html" class="tocviewlink" data-pltdoc="x">Invoking Units</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="compoundunits.html" class="tocviewlink" data-pltdoc="x">Linking Units and Creating Compound Units</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="linkinference.html" class="tocviewlink" data-pltdoc="x">Inferred Linking</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="Generating_A_Unit_from_Context.html" class="tocviewselflink" data-pltdoc="x">Generating A Unit from Context</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="Structural_Matching.html" class="tocviewlink" data-pltdoc="x">Structural Matching</a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="define-sig-form.html" class="tocviewlink" data-pltdoc="x">Extending the Syntax of Signatures</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Unit_Utilities.html" class="tocviewlink" data-pltdoc="x">Unit Utilities</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="unitcontracts.html" class="tocviewlink" data-pltdoc="x">Unit Contracts</a></td></tr><tr><td align="right">7.10&nbsp;</td><td><a href="single-unit.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Unit Modules</a></td></tr><tr><td align="right">7.11&nbsp;</td><td><a href="Single-Signature_Modules.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Signature Modules</a></td></tr><tr><td align="right">7.12&nbsp;</td><td><a href="Transformer_Helpers.html" class="tocviewlink" data-pltdoc="x">Transformer Helpers</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Generating_A_Unit_from_Context.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit-from-context%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unit-<wbr></wbr>from-<wbr></wbr>context</span></span></a></td></tr><tr><td><a href="Generating_A_Unit_from_Context.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit-from-context%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>unit-<wbr></wbr>from-<wbr></wbr>context</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="linkinference.html" title="backward to &quot;7.4 Inferred Linking&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Structural_Matching.html" title="forward to &quot;7.6 Structural Matching&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Generating_A_Unit_from_Context&quot;">7.5<tt>&nbsp;</tt><a name="(part._.Generating_.A_.Unit_from_.Context)"></a>Generating A Unit from Context</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._unit-from-context))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="Generating_A_Unit_from_Context.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit-from-context%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">unit-from-context</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Creates a unit that implements an interface using bindings in the
+enclosing environment.  The generated unit is essentially the same as</div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym">expr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr></table></blockquote><p>for each <span class="RktSym">id</span> that must be defined to satisfy the exports, and
+each corresponding <span class="RktSym">expr</span> produces the value of <span class="RktSym">id</span> in
+the environment of the <span class="RktSym"><a href="Generating_A_Unit_from_Context.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit-from-context%29%29" class="RktStxLink" data-pltdoc="x">unit-from-context</a></span> expression. (The unit
+cannot be written as above, however, since each <span class="RktSym">id</span> definition
+within the unit shadows the binding outside the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span> form.)</p><p>See <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span> for the grammar of <span class="RktVar">tagged-sig-spec</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._define-unit-from-context))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="Generating_A_Unit_from_Context.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit-from-context%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-unit-from-context</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Generating_A_Unit_from_Context.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit-from-context%29%29" class="RktStxLink" data-pltdoc="x">unit-from-context</a></span>, in that a unit is constructed from
+the enclosing environment, and like <span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%29%29" class="RktStxLink" data-pltdoc="x">define-unit</a></span>, in that
+<span class="RktVar">id</span> is bound to static information to be used later with inference.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="linkinference.html" title="backward to &quot;7.4 Inferred Linking&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Structural_Matching.html" title="forward to &quot;7.6 Structural Matching&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Generators.html b/clones/docs.racket-lang.org/reference/Generators.html
new file mode 100644
index 00000000..0e37e513
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Generators.html
@@ -0,0 +1,49 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.16.3&nbsp;Generators</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewselflink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.16.1&nbsp;</td><td><a href="sequences.html" class="tocviewlink" data-pltdoc="x">Sequences</a></td></tr><tr><td align="right">4.16.2&nbsp;</td><td><a href="streams.html" class="tocviewlink" data-pltdoc="x">Streams</a></td></tr><tr><td align="right">4.16.3&nbsp;</td><td><a href="Generators.html" class="tocviewselflink" data-pltdoc="x">Generators</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._generator~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">generator?</span></span></a></td></tr><tr><td><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._generator%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">generator</span></span></a></td></tr><tr><td><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">yield</span></span></a></td></tr><tr><td><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._infinite-generator%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">infinite-<wbr></wbr>generator</span></span></a></td></tr><tr><td><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._in-generator%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">in-<wbr></wbr>generator</span></span></a></td></tr><tr><td><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._generator-state%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">generator-<wbr></wbr>state</span></span></a></td></tr><tr><td><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._sequence-~3egenerator%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-<wbr></wbr>&gt;generator</span></span></a></td></tr><tr><td><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._sequence-~3erepeated-generator%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-<wbr></wbr>&gt;repeated-<wbr></wbr>generator</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="streams.html" title="backward to &quot;4.16.2 Streams&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="sequences_streams.html" title="up to &quot;4.16 Sequences and Streams&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="dicts.html" title="forward to &quot;4.17 Dictionaries&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Generators&quot;">4.16.3<tt>&nbsp;</tt><a name="(part._.Generators)"></a><a name="(mod-path._racket/generator)"></a>Generators</h5><p>A <a name="(tech._generator)"></a><span style="font-style: italic">generator</span> is a procedure that returns a sequence of
+values, incrementing the sequence each time that the generator is
+called. In particular, the <span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._generator%29%29" class="RktStxLink" data-pltdoc="x">generator</a></span> form implements a
+generator by evaluating a body that calls <span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span> to return
+values from the generator.</p><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="Generators.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/generator</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/generator..rkt)._generator~3f))"></a><span title="Provided from: racket/generator | Package: base"><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._generator~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">generator?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Return <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="Generators.html#%28tech._generator%29" class="techoutside" data-pltdoc="x"><span class="techinside">generator</span></a>,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/generator..rkt)._generator))"></a><span title="Provided from: racket/generator | Package: base"><span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._generator%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">generator</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">formals</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">formals</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">rest-id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">rest-id</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Creates a <a href="Generators.html#%28tech._generator%29" class="techoutside" data-pltdoc="x"><span class="techinside">generator</span></a>, where <span class="RktVar">formals</span> specify the arguments.
+Keyword and optional arguments are not supported. This is the same as the
+<span class="RktVar">formals</span> of a single <span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span> clause.</div></p><p>For the first call to a generator, the arguments are bound to the
+<span class="RktVar">formals</span> and evaluation of <span class="RktVar">body</span> starts. During the
+<a href="eval-model.html#%28tech._dynamic._extent%29" class="techoutside" data-pltdoc="x"><span class="techinside">dynamic extent</span></a> of <span class="RktVar">body</span>, the generator can return
+immediately using the <span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span> function. A second call to the
+generator resumes at the <span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span> call, producing the
+arguments of the second call as the results of the <span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span>,
+and so on. The eventual results of <span class="RktVar">body</span> are supplied to an
+implicit final <span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span>; after that final <span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span>,
+calling the generator again returns the same values, but all such
+calls must provide 0 arguments to the generator.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">g</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._generator%29%29" class="RktStxLink" data-pltdoc="x">generator</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">c</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null~3f%29%29" class="RktValLink" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">g</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'a</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">g</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'b</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">g</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'c</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">g</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">g</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/generator..rkt)._yield))"></a><span title="Provided from: racket/generator | Package: base"><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValDef RktValLink" data-pltdoc="x">yield</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVar">v</span>s from a generator, saving the point of execution
+inside a generator (i.e., within the <a href="eval-model.html#%28tech._dynamic._extent%29" class="techoutside" data-pltdoc="x"><span class="techinside">dynamic extent</span></a> of a
+<span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._generator%29%29" class="RktStxLink" data-pltdoc="x">generator</a></span> body) to be resumed by the next call to the
+generator. The results of <span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span> are the arguments that are
+provided to the next call of the generator.</div></p><p>When not in the <a href="eval-model.html#%28tech._dynamic._extent%29" class="techoutside" data-pltdoc="x"><span class="techinside">dynamic extent</span></a> of a <span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._generator%29%29" class="RktStxLink" data-pltdoc="x">generator</a></span>,
+<span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._infinite-generator%29%29" class="RktStxLink" data-pltdoc="x">infinite-generator</a></span>, or <span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._in-generator%29%29" class="RktStxLink" data-pltdoc="x">in-generator</a></span> body,
+<span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span> raises <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span> after evaluating its
+<span class="RktSym">expr</span>s.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-generator</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._generator%29%29" class="RktStxLink" data-pltdoc="x">generator</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">my-generator</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">my-generator</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pass-values-generator</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._generator%29%29" class="RktStxLink" data-pltdoc="x">generator</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A%29%29" class="RktStxLink" data-pltdoc="x">let*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">from-user</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">from-user-again</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">from-user</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span><span class="hspace">&nbsp;</span><span class="RktSym">from-user-again</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">pass-values-generator</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">pass-values-generator</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">6</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">pass-values-generator</span><span class="hspace">&nbsp;</span><span class="RktVal">12</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">12</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/generator..rkt)._infinite-generator))"></a><span title="Provided from: racket/generator | Package: base"><span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._infinite-generator%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">infinite-generator</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._generator%29%29" class="RktStxLink" data-pltdoc="x">generator</a></span>, but repeats evaluation of the
+<span class="RktVar">body</span>s when the last <span class="RktVar">body</span> completes without
+implicitly <span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span>ing.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">welcome</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._infinite-generator%29%29" class="RktStxLink" data-pltdoc="x">infinite-generator</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">hello</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">goodbye</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">welcome</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'hello</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">welcome</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'goodbye</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">welcome</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'hello</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">welcome</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'goodbye</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/generator..rkt)._in-generator))"></a><span title="Provided from: racket/generator | Package: base"><span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._in-generator%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">in-generator</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-arity</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">maybe-arity</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:arity</span><span class="hspace">&nbsp;</span><span class="RktVar">arity-k</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Produces a <a href="sequences.html#%28tech._sequence%29" class="techoutside" data-pltdoc="x"><span class="techinside">sequence</span></a> that encapsulates the <a href="Generators.html#%28tech._generator%29" class="techoutside" data-pltdoc="x"><span class="techinside">generator</span></a>
+formed by <span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._generator%29%29" class="RktStxLink" data-pltdoc="x">generator</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta">...+</span><span class="RktPn">)</span>. The values produced by
+the generator form the elements of the sequence, except for the last
+value produced by the generator (i.e., the values produced by
+returning).</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._in-generator%29%29" class="RktStxLink" data-pltdoc="x">in-generator</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">c</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxLink" data-pltdoc="x">when</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null~3f%29%29" class="RktValLink" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(a b c)</span></p></td></tr></table></blockquote></div></p><p>If <span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._in-generator%29%29" class="RktStxLink" data-pltdoc="x">in-generator</a></span> is used immediately with a <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> (or
+<span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span>, etc.) binding&rsquo;s right-hand side, then its result
+arity (i.e., the number of values in each element of the sequence)
+can be inferred. Otherwise, if the generator produces multiple
+values for each element, its arity should be declared with an
+<span class="RktPn">#:arity</span><span class="stt"> </span><span class="RktVar">arity-k</span> clause; the <span class="RktVar">arity-k</span> must be a
+literal, exact, non-negative integer.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">g</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._in-generator%29%29" class="RktStxLink" data-pltdoc="x">in-generator</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._unless%29%29" class="RktStxLink" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">not-empty?</span><span class="hspace">&nbsp;</span><span class="RktSym">next</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%29%29" class="RktValLink" data-pltdoc="x">sequence-generate</a></span><span class="hspace">&nbsp;</span><span class="RktSym">g</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxLink" data-pltdoc="x">when</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">not-empty?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">next</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">done</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">stop?: arity mismatch;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">the expected number of arguments does not match the given</span></p></td></tr><tr><td><p><span class="RktErr">number</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: 1</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 2</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">g</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._in-generator%29%29" class="RktStxLink" data-pltdoc="x">in-generator</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:arity</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._unless%29%29" class="RktStxLink" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">not-empty?</span><span class="hspace">&nbsp;</span><span class="RktSym">next</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%29%29" class="RktValLink" data-pltdoc="x">sequence-generate</a></span><span class="hspace">&nbsp;</span><span class="RktSym">g</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxLink" data-pltdoc="x">when</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">not-empty?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">next</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">done</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'done</span></p></td></tr></table></blockquote></div></p><p>To use an existing generator as a sequence, use <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-producer%29%29" class="RktValLink" data-pltdoc="x">in-producer</a></span>
+with a stop-value known for the generator:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">abc-generator</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._generator%29%29" class="RktStxLink" data-pltdoc="x">generator</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">c</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-producer%29%29" class="RktValLink" data-pltdoc="x">in-producer</a></span><span class="hspace">&nbsp;</span><span class="RktSym">abc-generator</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(a b c)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-stop-value</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._gensym%29%29" class="RktValLink" data-pltdoc="x">gensym</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-generator</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._generator%29%29" class="RktStxLink" data-pltdoc="x">generator</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null~3f%29%29" class="RktValLink" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">my-stop-value</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-producer%29%29" class="RktValLink" data-pltdoc="x">in-producer</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-generator</span><span class="hspace">&nbsp;</span><span class="RktSym">my-stop-value</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(a #&lt;void&gt; c)</span></p></td></tr></table></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/generator..rkt)._generator-state))"></a><span title="Provided from: racket/generator | Package: base"><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._generator-state%29%29" class="RktValDef RktValLink" data-pltdoc="x">generator-state</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">g</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">g</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._generator~3f%29%29" class="RktValLink" data-pltdoc="x">generator?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a symbol that describes the state of the generator.</div></p><ul><li><p><span class="RktVal">'</span><span class="RktVal">fresh</span> &#8212;<wbr></wbr> The generator has been freshly created and
+has not been called yet.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">suspended</span> &#8212;<wbr></wbr> Control within the generator has been
+suspended due to a call to <span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span>.  The generator can
+be called.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">running</span> &#8212;<wbr></wbr> The generator is currently executing.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">done</span> &#8212;<wbr></wbr> The generator has executed its entire
+body and will continue to produce the same result as from
+the last call.</p></li></ul><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-generator</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._generator%29%29" class="RktStxLink" data-pltdoc="x">generator</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._generator-state%29%29" class="RktValLink" data-pltdoc="x">generator-state</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-generator</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'fresh</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">my-generator</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._generator-state%29%29" class="RktValLink" data-pltdoc="x">generator-state</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-generator</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'suspended</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">my-generator</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._generator-state%29%29" class="RktValLink" data-pltdoc="x">generator-state</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-generator</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'suspended</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">my-generator</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._generator-state%29%29" class="RktValLink" data-pltdoc="x">generator-state</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-generator</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'done</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">introspective-generator</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._generator%29%29" class="RktStxLink" data-pltdoc="x">generator</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="RktValLink" data-pltdoc="x">yield</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">introspective-generator</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">introspective-generator</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._generator-state%29%29" class="RktValLink" data-pltdoc="x">generator-state</a></span><span class="hspace">&nbsp;</span><span class="RktSym">introspective-generator</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'running</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._generator-state%29%29" class="RktValLink" data-pltdoc="x">generator-state</a></span><span class="hspace">&nbsp;</span><span class="RktSym">introspective-generator</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'done</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">introspective-generator</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'running</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/generator..rkt)._sequence-~3egenerator))"></a><span title="Provided from: racket/generator | Package: base"><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._sequence-~3egenerator%29%29" class="RktValDef RktValLink" data-pltdoc="x">sequence-&gt;generator</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Converts a <a href="sequences.html#%28tech._sequence%29" class="techoutside" data-pltdoc="x"><span class="techinside">sequence</span></a> to a <a href="Generators.html#%28tech._generator%29" class="techoutside" data-pltdoc="x"><span class="techinside">generator</span></a>. The generator
+returns the next element of the sequence each time the generator is
+invoked, where each element of the sequence must be a single
+value. When the sequence ends, the generator returns <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>
+as its final result.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/generator..rkt)._sequence-~3erepeated-generator))"></a><span title="Provided from: racket/generator | Package: base"><span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._sequence-~3erepeated-generator%29%29" class="RktValDef RktValLink" data-pltdoc="x">sequence-&gt;repeated-generator</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._sequence-~3egenerator%29%29" class="RktValLink" data-pltdoc="x">sequence-&gt;generator</a></span>, but when <span class="RktVar">s</span> has no
+further values, the generator starts the sequence again (so that the
+generator never stops producing values).</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="streams.html" title="backward to &quot;4.16.2 Streams&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="sequences_streams.html" title="up to &quot;4.16 Sequences and Streams&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="dicts.html" title="forward to &quot;4.17 Dictionaries&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Interactive_Help.html b/clones/docs.racket-lang.org/reference/Interactive_Help.html
new file mode 100644
index 00000000..6900d3fa
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Interactive_Help.html
@@ -0,0 +1,22 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>18.3&nbsp;Interactive Help</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewselflink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">18.1&nbsp;</td><td><a href="running-sa.html" class="tocviewlink" data-pltdoc="x">Running Racket or GRacket</a></td></tr><tr><td align="right">18.2&nbsp;</td><td><a href="collects.html" class="tocviewlink" data-pltdoc="x">Libraries and Collections</a></td></tr><tr><td align="right">18.3&nbsp;</td><td><a href="Interactive_Help.html" class="tocviewselflink" data-pltdoc="x">Interactive Help</a></td></tr><tr><td align="right">18.4&nbsp;</td><td><a href="interaction-info.html" class="tocviewlink" data-pltdoc="x">Interaction Configuration</a></td></tr><tr><td align="right">18.5&nbsp;</td><td><a href="interactive.html" class="tocviewlink" data-pltdoc="x">Interactive Module Loading</a></td></tr><tr><td align="right">18.6&nbsp;</td><td><a href="debugging.html" class="tocviewlink" data-pltdoc="x">Debugging</a></td></tr><tr><td align="right">18.7&nbsp;</td><td><a href="compiler.html" class="tocviewlink" data-pltdoc="x">Controlling and Inspecting Compilation</a></td></tr><tr><td align="right">18.8&nbsp;</td><td><a href="Kernel_Forms_and_Functions.html" class="tocviewlink" data-pltdoc="x">Kernel Forms and Functions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">help</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="collects.html" title="backward to &quot;18.2 Libraries and Collections&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;18 Running Racket&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="interaction-info.html" title="forward to &quot;18.4 Interaction Configuration&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Interactive_Help&quot;">18.3<tt>&nbsp;</tt><a name="(part._.Interactive_.Help)"></a><a name="(mod-path._racket/help)"></a>Interactive Help</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="Interactive_Help.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/help</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="Interactive_Help.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/help</span></a> and <a href="running-sa.html#%28mod-path._racket%2Finit%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/init</span></a> libraries, which means that they are available when  the Racket executable is started with no command-line arguments. They are not provided by <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/help..rkt)._help))"></a><span title="Provided from: racket/help, racket/init | Package: base"><span class="RktSym"><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">help</a></span></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">help</a></span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">help</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">help</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">#:from</span><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">help</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:search</span><span class="hspace">&nbsp;</span><span class="RktVar">datum</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara"><span class="emph">For general help, see the <a href="https://docs.racket-lang.org/index.html" class="plainlink" onclick="return GotoPLTRoot(&quot;8.6&quot;);">main documentation page</a>.</span></div></p><p>The <span class="RktSym"><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="RktStxLink" data-pltdoc="x">help</a></span> form searches the documentation and opens a web
+browser (using the user&rsquo;s selected browser) to display the results.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=net&amp;rel=sendurl.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">net/sendurl</span></a> for information on how
+the user&rsquo;s browser is launched to display help information.</p></blockquote></blockquote></blockquote><p>A simple <span class="RktSym"><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="RktStxLink" data-pltdoc="x">help</a></span> or <span class="RktPn">(</span><span class="RktSym"><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="RktStxLink" data-pltdoc="x">help</a></span><span class="RktPn">)</span> form opens the main
+documentation page.</p><p>The <span class="RktPn">(</span><span class="RktSym"><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="RktStxLink" data-pltdoc="x">help</a></span><span class="stt"> </span><span class="RktVar">string</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> form&#8212;<wbr></wbr>using literal strings, as
+opposed to expressions that produce strings&#8212;<wbr></wbr>performs a
+string-matching search. For example,</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="RktStxLink" data-pltdoc="x">help</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"web browser"</span><span class="hspace">&nbsp;</span><span class="RktVal">"firefox"</span><span class="RktPn">)</span></p></blockquote><p>searches the documentation index for references that include the
+phrase &ldquo;web browser&rdquo; or &ldquo;firefox.&rdquo;</p><p>A <span class="RktPn">(</span><span class="RktSym"><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="RktStxLink" data-pltdoc="x">help</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span> form looks for documentation specific to the
+current binding of <span class="RktVar">id</span>. For example,</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">net/url</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="RktStxLink" data-pltdoc="x">help</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=net&amp;rel=url.html%23%2528def._%2528%2528lib._net%252Furl..rkt%2529._url-%7E3estring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">url-&gt;string</a></span><span class="RktPn">)</span></td></tr></table></blockquote><p>opens a web browser to show the documentation for <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=net&amp;rel=url.html%23%2528def._%2528%2528lib._net%252Furl..rkt%2529._url-%7E3estring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">url-&gt;string</a></span>
+from the <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=net&amp;rel=url.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">net/url</span></a> library.</p><p>For the purposes of <span class="RktSym"><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="RktStxLink" data-pltdoc="x">help</a></span>, a <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-label%29%29" class="RktStxLink" data-pltdoc="x">for-label</a></span> require
+introduces a binding without actually executing the
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=net&amp;rel=url.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">net/url</span></a> library&#8212;<wbr></wbr>for cases when you want to check
+documentation, but cannot or do not want to run the providing module.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/gui</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">does not work in </span><span class="stt">racket</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-label%29%29" class="RktStxLink" data-pltdoc="x">for-label</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/gui</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ok in </span><span class="stt">racket</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="RktStxLink" data-pltdoc="x">help</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=frame_.html&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">frame%</a></span><span class="RktPn">)</span></td></tr></table></blockquote><p>If <span class="RktVar">id</span> has no for-label and normal binding, then <span class="RktSym"><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="RktStxLink" data-pltdoc="x">help</a></span>
+lists all libraries that are known to export a binding for
+<span class="RktVar">id</span>.</p><p>The <span class="RktPn">(</span><span class="RktSym"><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="RktStxLink" data-pltdoc="x">help</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktPn">#:from</span><span class="stt"> </span><span class="RktVar">module-path</span><span class="RktPn">)</span> variant is similar to
+<span class="RktPn">(</span><span class="RktSym"><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="RktStxLink" data-pltdoc="x">help</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span>, but using only the exports of
+<span class="RktVar">module-path</span>. (The <span class="RktVar">module-path</span> module is required
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-label%29%29" class="RktStxLink" data-pltdoc="x">for-label</a></span> in a temporary namespace.)</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="RktStxLink" data-pltdoc="x">help</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=frame_.html&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">frame%</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:from</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/gui</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">equivalent to the above</span></p></blockquote><p>The <span class="RktPn">(</span><span class="RktSym"><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="RktStxLink" data-pltdoc="x">help</a></span><span class="stt"> </span><span class="RktPn">#:search</span><span class="stt"> </span><span class="RktVar">datum</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> form is similar to
+<span class="RktPn">(</span><span class="RktSym"><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="RktStxLink" data-pltdoc="x">help</a></span><span class="stt"> </span><span class="RktVar">string</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>, where any non-string form of
+<span class="RktVar">datum</span> is converted to a string using <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>. No
+<span class="RktVar">datum</span> is evaluated as an expression.</p><p>For example,</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="RktStxLink" data-pltdoc="x">help</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:search</span><span class="hspace">&nbsp;</span><span class="RktVal">"web browser"</span><span class="hspace">&nbsp;</span><span class="RktSym">firefox</span><span class="RktPn">)</span></p></blockquote><p>also searches the documentation index for references that include the
+phrase &ldquo;web browser&rdquo; or &ldquo;firefox.&rdquo;</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="collects.html" title="backward to &quot;18.2 Libraries and Collections&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;18 Running Racket&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="interaction-info.html" title="forward to &quot;18.4 Interaction Configuration&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Kernel_Forms_and_Functions.html b/clones/docs.racket-lang.org/reference/Kernel_Forms_and_Functions.html
new file mode 100644
index 00000000..c6284552
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Kernel_Forms_and_Functions.html
@@ -0,0 +1,25 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>18.8&nbsp;Kernel Forms and Functions</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewselflink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">18.1&nbsp;</td><td><a href="running-sa.html" class="tocviewlink" data-pltdoc="x">Running Racket or GRacket</a></td></tr><tr><td align="right">18.2&nbsp;</td><td><a href="collects.html" class="tocviewlink" data-pltdoc="x">Libraries and Collections</a></td></tr><tr><td align="right">18.3&nbsp;</td><td><a href="Interactive_Help.html" class="tocviewlink" data-pltdoc="x">Interactive Help</a></td></tr><tr><td align="right">18.4&nbsp;</td><td><a href="interaction-info.html" class="tocviewlink" data-pltdoc="x">Interaction Configuration</a></td></tr><tr><td align="right">18.5&nbsp;</td><td><a href="interactive.html" class="tocviewlink" data-pltdoc="x">Interactive Module Loading</a></td></tr><tr><td align="right">18.6&nbsp;</td><td><a href="debugging.html" class="tocviewlink" data-pltdoc="x">Debugging</a></td></tr><tr><td align="right">18.7&nbsp;</td><td><a href="compiler.html" class="tocviewlink" data-pltdoc="x">Controlling and Inspecting Compilation</a></td></tr><tr><td align="right">18.8&nbsp;</td><td><a href="Kernel_Forms_and_Functions.html" class="tocviewselflink" data-pltdoc="x">Kernel Forms and Functions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;">&bull;</td><td>18.8&nbsp;</td><td><a href="Kernel_Forms_and_Functions.html" class="tocviewselflink" data-pltdoc="x">Kernel Forms and Functions</a></td></tr></table></div></div></div><div class="maincolumn"><div class="main"><div class="versionbox"><span class="version">8.6</span></div><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="compiler.html" title="backward to &quot;18.7 Controlling and Inspecting Compilation&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;18 Running Racket&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="doc-bibliography.html" title="forward to &quot;Bibliography&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Kernel_Forms_and_Functions&quot;">18.8<tt>&nbsp;</tt><a name="(part._.Kernel_.Forms_and_.Functions)"></a><a name="(mod-path._racket/kernel)"></a>Kernel Forms and Functions</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="Kernel_Forms_and_Functions.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/kernel</span></a></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The <a href="Kernel_Forms_and_Functions.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/kernel</span></a> library
+is a <a href="eval-model.html#%28tech._cross._phase._persistent%29" class="techoutside" data-pltdoc="x"><span class="techinside">cross-phase persistent</span></a> module that provides a minimal set of syntactic
+forms and functions.</div></p><p>&ldquo;Minimal&rdquo; means that <a href="Kernel_Forms_and_Functions.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/kernel</span></a> includes only
+forms that are built into the Racket compiler and only functions that
+are built into the run-time system. Currently, the set of bindings is
+not especially small, nor is it particularly well-defined, since the
+set of built-in functions can change frequently. Use
+<a href="Kernel_Forms_and_Functions.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/kernel</span></a> with care, and beware that its use can
+create compatibility problems.</p><p>The <a href="Kernel_Forms_and_Functions.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/kernel</span></a> module exports all of the bindings in the
+grammar of fully expanded programs (see <a href="syntax-model.html#%28part._fully-expanded%29" data-pltdoc="x">Fully Expanded Programs</a>),
+but it provides <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-lambda%29%29" class="RktStxLink" data-pltdoc="x">#%plain-lambda</a></span> as <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span> and <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-lambda%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span>,
+<span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-app%29%29" class="RktStxLink" data-pltdoc="x">#%plain-app</a></span> as <span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-app%29%29" class="RktStxLink" data-pltdoc="x">#%app</a></span>, and
+<span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-module-begin%29%29" class="RktStxLink" data-pltdoc="x">#%plain-module-begin</a></span> as <span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-module-begin%29%29" class="RktStxLink" data-pltdoc="x">#%module-begin</a></span>. Aside from
+<span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._~23~25datum%29%29" class="RktStxLink" data-pltdoc="x">#%datum</a></span> (which expands to <span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span>),
+<a href="Kernel_Forms_and_Functions.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/kernel</span></a> provides no other syntactic bindings.</p><p>The <a href="Kernel_Forms_and_Functions.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/kernel</span></a> module also exports many of the function
+bindings from <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>, and it exports a few other
+functions that are not exported by <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> because
+<a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> exports improved variants. The exact set
+of function bindings exported by <span class="RktSym">racket/kernel</span> is unspecified
+and subject to change across versions.</p><a name="(part._)"></a><a name="(mod-path._racket/kernel/init)"></a><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="Kernel_Forms_and_Functions.html#%28mod-path._racket%2Fkernel%2Finit%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/kernel/init</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The <a href="Kernel_Forms_and_Functions.html#%28mod-path._racket%2Fkernel%2Finit%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/kernel/init</span></a>
+library re-provides all of <a href="Kernel_Forms_and_Functions.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/kernel</span></a>. It also
+provides <span class="RktSym"><a href="__top-interaction.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25top-interaction%29%29" class="RktStxLink" data-pltdoc="x">#%top-interaction</a></span>, which makes
+<a href="Kernel_Forms_and_Functions.html#%28mod-path._racket%2Fkernel%2Finit%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/kernel/init</span></a> useful with the <span class="nobreak"><span class="stt">-I</span></span>
+command-line flag for <span class="stt">racket</span>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="compiler.html" title="backward to &quot;18.7 Controlling and Inspecting Compilation&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;18 Running Racket&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="doc-bibliography.html" title="forward to &quot;Bibliography&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Lazy_Data-structure_Contracts.html b/clones/docs.racket-lang.org/reference/Lazy_Data-structure_Contracts.html
new file mode 100644
index 00000000..9012e60d
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Lazy_Data-structure_Contracts.html
@@ -0,0 +1,28 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>8.4&nbsp;Lazy Data-structure Contracts</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.1&nbsp;</td><td><a href="data-structure-contracts.html" class="tocviewlink" data-pltdoc="x">Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.2&nbsp;</td><td><a href="function-contracts.html" class="tocviewlink" data-pltdoc="x">Function Contracts</a></td></tr><tr><td align="right">8.3&nbsp;</td><td><a href="parametric-contracts.html" class="tocviewlink" data-pltdoc="x">Parametric Contracts</a></td></tr><tr><td align="right">8.4&nbsp;</td><td><a href="Lazy_Data-structure_Contracts.html" class="tocviewselflink" data-pltdoc="x">Lazy Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.5&nbsp;</td><td><a href="Structure_Type_Property_Contracts.html" class="tocviewlink" data-pltdoc="x">Structure Type Property Contracts</a></td></tr><tr><td align="right">8.6&nbsp;</td><td><a href="attaching-contracts-to-values.html" class="tocviewlink" data-pltdoc="x">Attaching Contracts to Values</a></td></tr><tr><td align="right">8.7&nbsp;</td><td><a href="Building_New_Contract_Combinators.html" class="tocviewlink" data-pltdoc="x">Building New Contract Combinators</a></td></tr><tr><td align="right">8.8&nbsp;</td><td><a href="contract-utilities.html" class="tocviewlink" data-pltdoc="x">Contract Utilities</a></td></tr><tr><td align="right">8.9&nbsp;</td><td><a href="racket_contract_base.html" class="tocviewlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>contract/<span class="mywbr"> &nbsp;</span>base</span></span></a></td></tr><tr><td align="right">8.10&nbsp;</td><td><a href="collapsible.html" class="tocviewlink" data-pltdoc="x">Collapsible Contracts</a></td></tr><tr><td align="right">8.11&nbsp;</td><td><a href="Legacy_Contracts.html" class="tocviewlink" data-pltdoc="x">Legacy Contracts</a></td></tr><tr><td align="right">8.12&nbsp;</td><td><a href="Random_generation.html" class="tocviewlink" data-pltdoc="x">Random generation</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Lazy_Data-structure_Contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fds..rkt%29._contract-struct%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">contract-<wbr></wbr>struct</span></span></a></td></tr><tr><td><a href="Lazy_Data-structure_Contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fds..rkt%29._define-contract-struct%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>contract-<wbr></wbr>struct</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="parametric-contracts.html" title="backward to &quot;8.3 Parametric Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Structure_Type_Property_Contracts.html" title="forward to &quot;8.5 Structure Type Property Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Lazy_Data-structure_Contracts&quot;">8.4<tt>&nbsp;</tt><a name="(part._.Lazy_.Data-structure_.Contracts)"></a>Lazy Data-structure Contracts</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/private/ds..rkt)._contract-struct))"></a><span title="Provided from: racket/contract, racket | Package: base"><span class="RktSym"><a href="Lazy_Data-structure_Contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fds..rkt%29._contract-struct%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">contract-struct</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">field-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote><p><span style="background-color: yellow"><span style="font-weight: bold">NOTE:</span></span> This library is deprecated; use <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>, instead. Lazy struct contracts no longer require a separate
+struct declaration; instead <span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fstruct-dc..rkt%29._struct%2Fdc%29%29" class="RktStxLink" data-pltdoc="x">struct/dc</a></span>
+and <span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fstruct-dc..rkt%29._struct%2Fc%29%29" class="RktStxLink" data-pltdoc="x">struct/c</a></span> work directly with
+<span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> and <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-struct%29%29" class="RktStxLink" data-pltdoc="x">define-struct</a></span>.</p></blockquote></div></p><p>Like <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>, but with two differences:
+they do not
+define field mutators, and they define two contract constructors:
+<span class="RktVar">id</span><span class="RktSym">/c</span> and <span class="RktVar">id</span><span class="RktSym">/dc</span>. The
+first is a procedure that accepts as many arguments as there are
+fields and returns a contract for struct values whose fields match the
+arguments. The second is a syntactic form that also produces contracts
+on the structs, but the contracts on later fields may depend on the
+values of earlier fields.</p><p>The generated contract combinators are <span style="font-style: italic">lazy</span>: they only verify
+the contract holds for the portion of some data structure that is
+actually inspected. More precisely, a lazy data structure contract is
+not checked until a selector extracts a field of a struct.</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktVar">id</span><span class="RktSym">/dc</span><span class="hspace">&nbsp;</span><span class="RktVar">field-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">field-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">field-id</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">field-id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">field-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">]</span></td></tr></table></td></tr></table></blockquote><p>In each <span class="RktVar">field-spec</span> case, the first <span class="RktVar">field-id</span>
+specifies which field the contract applies to; the fields must be
+specified in the same order as the original
+<span class="RktSym"><a href="Lazy_Data-structure_Contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fds..rkt%29._contract-struct%29%29" class="RktStxLink" data-pltdoc="x">contract-struct</a></span>. The first case is for when the
+contract on the field does not depend on the value of any other
+field. The second case is for when the contract on the field does
+depend on some other fields, and the parenthesized <span class="RktVar">field-id</span>s
+indicate which fields it depends on; these dependencies can only be to
+earlier fields.</p></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/private/ds..rkt)._define-contract-struct))"></a><span title="Provided from: racket/contract, racket | Package: base"><span class="RktSym"><a href="Lazy_Data-structure_Contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fds..rkt%29._define-contract-struct%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-contract-struct</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">field-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote><p><span style="background-color: yellow"><span style="font-weight: bold">NOTE:</span></span> This library is deprecated; use <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>, instead. Lazy struct contracts no longer require a separate
+struct declaration; instead <span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fstruct-dc..rkt%29._struct%2Fdc%29%29" class="RktStxLink" data-pltdoc="x">struct/dc</a></span>
+and <span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fstruct-dc..rkt%29._struct%2Fc%29%29" class="RktStxLink" data-pltdoc="x">struct/c</a></span> work directly with
+<span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> and <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-struct%29%29" class="RktStxLink" data-pltdoc="x">define-struct</a></span>.</p></blockquote></div></p><p>Like <span class="RktSym"><a href="Lazy_Data-structure_Contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fds..rkt%29._contract-struct%29%29" class="RktStxLink" data-pltdoc="x">contract-struct</a></span>, but where the constructor&rsquo;s name is
+<span class="RktSym">make-</span><span class="RktVar">id</span>, much like <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-struct%29%29" class="RktStxLink" data-pltdoc="x">define-struct</a></span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="parametric-contracts.html" title="backward to &quot;8.3 Parametric Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Structure_Type_Property_Contracts.html" title="forward to &quot;8.5 Structure Type Property Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Legacy_Contracts.html b/clones/docs.racket-lang.org/reference/Legacy_Contracts.html
new file mode 100644
index 00000000..764b83ed
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Legacy_Contracts.html
@@ -0,0 +1,7 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>8.11&nbsp;Legacy Contracts</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.1&nbsp;</td><td><a href="data-structure-contracts.html" class="tocviewlink" data-pltdoc="x">Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.2&nbsp;</td><td><a href="function-contracts.html" class="tocviewlink" data-pltdoc="x">Function Contracts</a></td></tr><tr><td align="right">8.3&nbsp;</td><td><a href="parametric-contracts.html" class="tocviewlink" data-pltdoc="x">Parametric Contracts</a></td></tr><tr><td align="right">8.4&nbsp;</td><td><a href="Lazy_Data-structure_Contracts.html" class="tocviewlink" data-pltdoc="x">Lazy Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.5&nbsp;</td><td><a href="Structure_Type_Property_Contracts.html" class="tocviewlink" data-pltdoc="x">Structure Type Property Contracts</a></td></tr><tr><td align="right">8.6&nbsp;</td><td><a href="attaching-contracts-to-values.html" class="tocviewlink" data-pltdoc="x">Attaching Contracts to Values</a></td></tr><tr><td align="right">8.7&nbsp;</td><td><a href="Building_New_Contract_Combinators.html" class="tocviewlink" data-pltdoc="x">Building New Contract Combinators</a></td></tr><tr><td align="right">8.8&nbsp;</td><td><a href="contract-utilities.html" class="tocviewlink" data-pltdoc="x">Contract Utilities</a></td></tr><tr><td align="right">8.9&nbsp;</td><td><a href="racket_contract_base.html" class="tocviewlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>contract/<span class="mywbr"> &nbsp;</span>base</span></span></a></td></tr><tr><td align="right">8.10&nbsp;</td><td><a href="collapsible.html" class="tocviewlink" data-pltdoc="x">Collapsible Contracts</a></td></tr><tr><td align="right">8.11&nbsp;</td><td><a href="Legacy_Contracts.html" class="tocviewselflink" data-pltdoc="x">Legacy Contracts</a></td></tr><tr><td align="right">8.12&nbsp;</td><td><a href="Random_generation.html" class="tocviewlink" data-pltdoc="x">Random generation</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Legacy_Contracts.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._make-proj-contract%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>proj-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="Legacy_Contracts.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._raise-contract-error%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-<wbr></wbr>contract-<wbr></wbr>error</span></span></a></td></tr><tr><td><a href="Legacy_Contracts.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-proc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-<wbr></wbr>proc</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="collapsible.html" title="backward to &quot;8.10 Collapsible Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Random_generation.html" title="forward to &quot;8.12 Random generation&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Legacy_Contracts&quot;">8.11<tt>&nbsp;</tt><a name="(part._.Legacy_.Contracts)"></a>Legacy Contracts</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract..rkt)._make-proj-contract))"></a><span title="Provided from: racket/contract, racket | Package: base"><span class="RktSym"><a href="Legacy_Contracts.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._make-proj-contract%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-proj-contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span><span class="RktVar">proj</span><span class="hspace">&nbsp;</span><span class="RktVar">first-order</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">contact?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">contact?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">first-order</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Builds a contract using an old interface.</div></p><p><div class="SIntrapara">Modulo errors, it is equivalent to:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._make-contract%29%29" class="RktValLink" data-pltdoc="x">make-contract</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">#:name</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">#:first-order</span><span class="hspace">&nbsp;</span><span class="RktVar">first-order</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">#:projection</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">proj</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">blame</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">proj</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-positive%29%29" class="RktValLink" data-pltdoc="x">blame-positive</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-negative%29%29" class="RktValLink" data-pltdoc="x">blame-negative</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-source%29%29" class="RktValLink" data-pltdoc="x">blame-source</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-value%29%29" class="RktValLink" data-pltdoc="x">blame-value</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-contract%29%29" class="RktValLink" data-pltdoc="x">blame-contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-swapped~3f%29%29" class="RktValLink" data-pltdoc="x">blame-swapped?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">proj</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">blame</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">proj</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-positive%29%29" class="RktValLink" data-pltdoc="x">blame-positive</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-negative%29%29" class="RktValLink" data-pltdoc="x">blame-negative</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-source%29%29" class="RktValLink" data-pltdoc="x">blame-source</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-value%29%29" class="RktValLink" data-pltdoc="x">blame-value</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-contract%29%29" class="RktValLink" data-pltdoc="x">blame-contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/contract..rkt)._raise-contract-error))"></a><span title="Provided from: racket/contract, racket | Package: base"><span class="RktSym"><a href="Legacy_Contracts.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._raise-contract-error%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-contract-error</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">val</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">src</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">fmt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fmt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Calls <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._raise-blame-error%29%29" class="RktValLink" data-pltdoc="x">raise-blame-error</a></span> after building a <span class="RktSym">blame</span> struct from
+the <span class="RktVar">val</span>, <span class="RktVar">src</span>, <span class="RktVar">pos</span>, and <span class="RktVar">name</span> arguments.
+The <span class="RktVar">fmt</span> string and following arguments are passed to
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span> and used as the string in the error message.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract..rkt)._contract-proc))"></a><span title="Provided from: racket/contract, racket | Package: base"><span class="RktSym"><a href="Legacy_Contracts.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-proc%29%29" class="RktValDef RktValLink" data-pltdoc="x">contract-proc</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Constructs an old-style projection from a contract.</div></p><p>The resulting function accepts the information that is in a <span class="RktSym">blame</span>
+struct and returns a projection function that checks the contract.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="collapsible.html" title="backward to &quot;8.10 Collapsible Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Random_generation.html" title="forward to &quot;8.12 Random generation&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Locations____variable-reference.html b/clones/docs.racket-lang.org/reference/Locations____variable-reference.html
new file mode 100644
index 00000000..cd1c6ed5
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Locations____variable-reference.html
@@ -0,0 +1,18 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.6&nbsp;Locations: #%variable-reference</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewselflink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Locations____variable-reference.html#%28form._%28%28quote._~23~25kernel%29._~23~25variable-reference%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="__top.html" title="backward to &quot;3.5 Variable References and #%top&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="application.html" title="forward to &quot;3.7 Procedure Applications and #%app&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Locations____variable-reference&quot;">3.6<tt>&nbsp;</tt><a name="(part._.Locations____variable-reference)"></a>Locations: <span class="RktSym"><a href="Locations____variable-reference.html#%28form._%28%28quote._~23~25kernel%29._~23~25variable-reference%29%29" class="RktStxLink" data-pltdoc="x">#%variable-reference</a></span></h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._~23~25variable-reference))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Locations____variable-reference.html#%28form._%28%28quote._~23~25kernel%29._~23~25variable-reference%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">#%variable-reference</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Locations____variable-reference.html#%28form._%28%28quote._~23~25kernel%29._~23~25variable-reference%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">#%variable-reference</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Locations____variable-reference.html#%28form._%28%28quote._~23~25kernel%29._~23~25variable-reference%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">#%variable-reference</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces an opaque <a name="(tech._variable._reference)"></a><span style="font-style: italic">variable reference</span> value representing the
+<a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a> of <span class="RktVar">id</span>, which must be bound as a variable. If
+no <span class="RktVar">id</span> is supplied, the resulting value refers to an
+&ldquo;anonymous&rdquo; variable defined within the enclosing context (i.e.,
+within the enclosing module, or at the top level if the form is not
+inside a module).</div></p><p>When <span class="RktPn">(</span><span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">id</span><span class="RktPn">)</span> is used, then the variable reference refers
+to the same variable as <span class="RktPn">(</span><span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">id</span><span class="RktPn">)</span>. Note that
+<span class="RktPn">(</span><span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">id</span><span class="RktPn">)</span> is not allowed if <span class="RktVar">id</span> is locally bound
+or within a module if <span class="RktVar">id</span> is bound as a transformer.</p><p>A <a href="Locations____variable-reference.html#%28tech._variable._reference%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable reference</span></a> can be used with
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3eempty-namespace%29%29" class="RktValLink" data-pltdoc="x">variable-reference-&gt;empty-namespace</a></span>,
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3eresolved-module-path%29%29" class="RktValLink" data-pltdoc="x">variable-reference-&gt;resolved-module-path</a></span>, and
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3enamespace%29%29" class="RktValLink" data-pltdoc="x">variable-reference-&gt;namespace</a></span>, but facilities like
+<span class="RktSym"><a href="Namespaces.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-namespace-anchor%29%29" class="RktStxLink" data-pltdoc="x">define-namespace-anchor</a></span> and
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._namespace-anchor-~3enamespace%29%29" class="RktValLink" data-pltdoc="x">namespace-anchor-&gt;namespace</a></span> wrap those to provide a clearer
+interface. A <a href="Locations____variable-reference.html#%28tech._variable._reference%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable reference</span></a> is also useful to low-level
+extensions; see <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=inside&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">Inside: Racket C API</a>.</p><p class="SHistory">Changed in version 8.2.0.7 of package <span class="stt">base</span>: Changed <span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span> treatment to be
+consistent with <span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span> by itself.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="__top.html" title="backward to &quot;3.5 Variable References and #%top&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="application.html" title="forward to &quot;3.7 Procedure Applications and #%app&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Macros.html b/clones/docs.racket-lang.org/reference/Macros.html
new file mode 100644
index 00000000..fff28fda
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Macros.html
@@ -0,0 +1,6 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>12&nbsp;Macros</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>12&nbsp;</td><td><a href="Macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">12.1&nbsp;</td><td><a href="stx-patterns.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Syntax Matching</a></td></tr><tr><td align="right">12.2&nbsp;</td><td><a href="stxops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Content</a></td></tr><tr><td align="right">12.3&nbsp;</td><td><a href="stxcmp.html" class="tocviewlink" data-pltdoc="x">Syntax Object Bindings</a></td></tr><tr><td align="right">12.4&nbsp;</td><td><a href="stxtrans.html" class="tocviewlink" data-pltdoc="x">Syntax Transformers</a></td></tr><tr><td align="right">12.5&nbsp;</td><td><a href="stxparam.html" class="tocviewlink" data-pltdoc="x">Syntax Parameters</a></td></tr><tr><td align="right">12.6&nbsp;</td><td><a href="splicing.html" class="tocviewlink" data-pltdoc="x">Local Binding with Splicing Body</a></td></tr><tr><td align="right">12.7&nbsp;</td><td><a href="stxprops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Properties</a></td></tr><tr><td align="right">12.8&nbsp;</td><td><a href="stxcerts.html" class="tocviewlink" data-pltdoc="x">Syntax Taints</a></td></tr><tr><td align="right">12.9&nbsp;</td><td><a href="Expanding_Top-Level_Forms.html" class="tocviewlink" data-pltdoc="x">Expanding Top-<wbr></wbr>Level Forms</a></td></tr><tr><td align="right">12.10&nbsp;</td><td><a href="Serializing_Syntax.html" class="tocviewlink" data-pltdoc="x">Serializing Syntax</a></td></tr><tr><td align="right">12.11&nbsp;</td><td><a href="include.html" class="tocviewlink" data-pltdoc="x">File Inclusion</a></td></tr><tr><td align="right">12.12&nbsp;</td><td><a href="syntax-util.html" class="tocviewlink" data-pltdoc="x">Syntax Utilities</a></td></tr><tr><td align="right">12.13&nbsp;</td><td><a href="phase_space.html" class="tocviewlink" data-pltdoc="x">Phase and Space Utilities</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="memory-order.html" title="backward to &quot;11.7 Machine Memory Order&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stx-patterns.html" title="forward to &quot;12.1 Pattern-Based Syntax Matching&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Macros&quot;">12<tt>&nbsp;</tt><a name="(part._.Macros)"></a>Macros</h3><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=macros.html&amp;version=8.6" class="Sq" data-pltdoc="x">Macros</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces Macros.</p></blockquote></blockquote></blockquote><p>See <a href="syntax-model.html" data-pltdoc="x">Syntax Model</a> for general information on how programs
+are parsed. In particular, the subsection <a href="syntax-model.html#%28part._expand-steps%29" data-pltdoc="x">Expansion Steps</a>
+describes how parsing triggers macros, and
+<a href="syntax-model.html#%28part._transformer-model%29" data-pltdoc="x">Transformer Bindings</a> describes how macro transformers are
+called.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stx-patterns.html" class="toclink" data-pltdoc="x">12.1<span class="hspace">&nbsp;</span>Pattern-Based Syntax Matching</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxops.html" class="toclink" data-pltdoc="x">12.2<span class="hspace">&nbsp;</span>Syntax Object Content</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxops.html#%28part._.Syntax_.Object_.Source_.Locations%29" class="toclink" data-pltdoc="x">12.2.1<span class="hspace">&nbsp;</span>Syntax Object Source Locations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxcmp.html" class="toclink" data-pltdoc="x">12.3<span class="hspace">&nbsp;</span>Syntax Object Bindings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxtrans.html" class="toclink" data-pltdoc="x">12.4<span class="hspace">&nbsp;</span>Syntax Transformers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxtrans.html#%28part._require-trans%29" class="toclink" data-pltdoc="x">12.4.1<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">require</span></span> Transformers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxtrans.html#%28part._provide-trans%29" class="toclink" data-pltdoc="x">12.4.2<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">provide</span></span> Transformers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxtrans.html#%28part._keyword-trans%29" class="toclink" data-pltdoc="x">12.4.3<span class="hspace">&nbsp;</span>Keyword-Argument Conversion Introspection</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxtrans.html#%28part._portal-syntax%29" class="toclink" data-pltdoc="x">12.4.4<span class="hspace">&nbsp;</span>Portal Syntax Bindings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxparam.html" class="toclink" data-pltdoc="x">12.5<span class="hspace">&nbsp;</span>Syntax Parameters</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxparam.html#%28part._.Syntax_.Parameter_.Inspection%29" class="toclink" data-pltdoc="x">12.5.1<span class="hspace">&nbsp;</span>Syntax Parameter Inspection</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="splicing.html" class="toclink" data-pltdoc="x">12.6<span class="hspace">&nbsp;</span>Local Binding with Splicing Body</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxprops.html" class="toclink" data-pltdoc="x">12.7<span class="hspace">&nbsp;</span>Syntax Object Properties</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxcerts.html" class="toclink" data-pltdoc="x">12.8<span class="hspace">&nbsp;</span>Syntax Taints</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Expanding_Top-Level_Forms.html" class="toclink" data-pltdoc="x">12.9<span class="hspace">&nbsp;</span>Expanding Top-Level Forms</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Expanding_Top-Level_Forms.html#%28part._modinfo%29" class="toclink" data-pltdoc="x">12.9.1<span class="hspace">&nbsp;</span>Information on Expanded Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Serializing_Syntax.html" class="toclink" data-pltdoc="x">12.10<span class="hspace">&nbsp;</span>Serializing Syntax</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="include.html" class="toclink" data-pltdoc="x">12.11<span class="hspace">&nbsp;</span>File Inclusion</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-util.html" class="toclink" data-pltdoc="x">12.12<span class="hspace">&nbsp;</span>Syntax Utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-util.html#%28part._.Creating_formatted_identifiers%29" class="toclink" data-pltdoc="x">12.12.1<span class="hspace">&nbsp;</span>Creating formatted identifiers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-util.html#%28part._.Pattern_variables%29" class="toclink" data-pltdoc="x">12.12.2<span class="hspace">&nbsp;</span>Pattern variables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-util.html#%28part._.Error_reporting%29" class="toclink" data-pltdoc="x">12.12.3<span class="hspace">&nbsp;</span>Error reporting</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-util.html#%28part._.Recording_disappeared_uses%29" class="toclink" data-pltdoc="x">12.12.4<span class="hspace">&nbsp;</span>Recording disappeared uses</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-util.html#%28part._.Miscellaneous_utilities%29" class="toclink" data-pltdoc="x">12.12.5<span class="hspace">&nbsp;</span>Miscellaneous utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="phase_space.html" class="toclink" data-pltdoc="x">12.13<span class="hspace">&nbsp;</span>Phase and Space Utilities</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="memory-order.html" title="backward to &quot;11.7 Machine Memory Order&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stx-patterns.html" title="forward to &quot;12.1 Pattern-Based Syntax Matching&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Manipulating_Paths.html b/clones/docs.racket-lang.org/reference/Manipulating_Paths.html
new file mode 100644
index 00000000..21bc5657
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Manipulating_Paths.html
@@ -0,0 +1,237 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15.1.1&nbsp;Manipulating Paths</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewselflink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewselflink" data-pltdoc="x">Paths</a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="Filesystem.html" class="tocviewlink" data-pltdoc="x">Filesystem</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="networking.html" class="tocviewlink" data-pltdoc="x">Networking</a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="subprocess.html" class="tocviewlink" data-pltdoc="x">Processes</a></td></tr><tr><td align="right">15.5&nbsp;</td><td><a href="logging.html" class="tocviewlink" data-pltdoc="x">Logging</a></td></tr><tr><td align="right">15.6&nbsp;</td><td><a href="time.html" class="tocviewlink" data-pltdoc="x">Time</a></td></tr><tr><td align="right">15.7&nbsp;</td><td><a href="envvars.html" class="tocviewlink" data-pltdoc="x">Environment Variables</a></td></tr><tr><td align="right">15.8&nbsp;</td><td><a href="runtime.html" class="tocviewlink" data-pltdoc="x">Environment and Runtime Information</a></td></tr><tr><td align="right">15.9&nbsp;</td><td><a href="Command-Line_Parsing.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Parsing</a></td></tr><tr><td align="right">15.10&nbsp;</td><td><a href="os-lib.html" class="tocviewlink" data-pltdoc="x">Additional Operating System Functions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewlink" data-pltdoc="x">Paths</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1.1&nbsp;</td><td><a href="Manipulating_Paths.html" class="tocviewselflink" data-pltdoc="x">Manipulating Paths</a></td></tr><tr><td align="right">15.1.2&nbsp;</td><td><a href="More_Path_Utilities.html" class="tocviewlink" data-pltdoc="x">More Path Utilities</a></td></tr><tr><td align="right">15.1.3&nbsp;</td><td><a href="unixpaths.html" class="tocviewlink" data-pltdoc="x">Unix and Mac OS Paths</a></td></tr><tr><td align="right">15.1.4&nbsp;</td><td><a href="windowspaths.html" class="tocviewlink" data-pltdoc="x">Windows Paths</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path?</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-<wbr></wbr>string?</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-<wbr></wbr>for-<wbr></wbr>some-<wbr></wbr>system?</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._string-~3epath%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>&gt;path</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>&gt;path</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3estring%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-<wbr></wbr>&gt;string</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3ebytes%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-<wbr></wbr>&gt;bytes</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._string-~3epath-element%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>&gt;path-<wbr></wbr>element</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath-element%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>&gt;path-<wbr></wbr>element</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-element-~3estring%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-<wbr></wbr>element-<wbr></wbr>&gt;string</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-element-~3ebytes%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-<wbr></wbr>element-<wbr></wbr>&gt;bytes</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3c~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path&lt;?</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-convention-type%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-<wbr></wbr>convention-<wbr></wbr>type</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._system-path-convention-type%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">system-<wbr></wbr>path-<wbr></wbr>convention-<wbr></wbr>type</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">build-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%2Fconvention-type%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">build-<wbr></wbr>path/<span class="mywbr"> &nbsp;</span>convention-<wbr></wbr>type</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._absolute-path~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">absolute-<wbr></wbr>path?</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._relative-path~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">relative-<wbr></wbr>path?</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">complete-<wbr></wbr>path?</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3ecomplete-path%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-<wbr></wbr>&gt;complete-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3edirectory-path%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-<wbr></wbr>&gt;directory-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._resolve-path%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">resolve-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._cleanse-path%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cleanse-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._expand-user-path%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">expand-<wbr></wbr>user-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._simplify-path%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">simplify-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._normal-case-path%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">normal-<wbr></wbr>case-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._split-path%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">split-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._explode-path%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">explode-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-replace-extension%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-<wbr></wbr>replace-<wbr></wbr>extension</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-add-extension%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-<wbr></wbr>add-<wbr></wbr>extension</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-replace-suffix%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-<wbr></wbr>replace-<wbr></wbr>suffix</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-add-suffix%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-<wbr></wbr>add-<wbr></wbr>suffix</span></span></a></td></tr><tr><td><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._reroot-path%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">reroot-<wbr></wbr>path</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="pathutils.html" title="backward to &quot;15.1 Paths&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="pathutils.html" title="up to &quot;15.1 Paths&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="More_Path_Utilities.html" title="forward to &quot;15.1.2 More Path Utilities&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Manipulating_Paths&quot;">15.1.1<tt>&nbsp;</tt><a name="(part._.Manipulating_.Paths)"></a>Manipulating Paths</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._path~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">path?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a path value for the current
+platform (not a string, and not a path for a different platform),
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._path-string~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">path-string?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is either a <a name="(tech._path._or._string)"></a><span style="font-style: italic">path
+or string</span>: either a path for the current platform or a
+non-empty string without nul characters. Returns <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._path-for-some-system~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">path-for-some-system?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a path value for some platform
+(not a string), <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-~3epath))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._string-~3epath%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-&gt;path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a path whose byte-string encoding is
+<span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Flocale%29%29" class="RktValLink" data-pltdoc="x">string-&gt;bytes/locale</a></span><span class="stt"> </span><span class="RktVar">str</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-~3einteger%29%29" class="RktValLink" data-pltdoc="x">char-&gt;integer</a></span><span class="stt"> </span><span class="RktVal">#\?</span><span class="RktPn">)</span><span class="RktPn">)</span> on Unix and Mac OS
+or <span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Futf-8%29%29" class="RktValLink" data-pltdoc="x">string-&gt;bytes/utf-8</a></span><span class="stt"> </span><span class="RktVar">str</span><span class="RktPn">)</span> on Windows.</div></p><p>Beware that the current locale might not encode every string, in which
+case <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._string-~3epath%29%29" class="RktValLink" data-pltdoc="x">string-&gt;path</a></span> can produce the same path for different
+<span class="RktVar">str</span>s. See also <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._string-~3epath-element%29%29" class="RktValLink" data-pltdoc="x">string-&gt;path-element</a></span>, which should be
+used instead of <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._string-~3epath%29%29" class="RktValLink" data-pltdoc="x">string-&gt;path</a></span> when a string represents a
+single <a href="More_Path_Utilities.html#%28tech._path._element%29" class="techoutside" data-pltdoc="x"><span class="techinside">path element</span></a>. For information on how strings and byte
+strings encode paths, see <a href="unixpaths.html#%28part._unixpathrep%29" data-pltdoc="x">Unix Path Representation</a> and
+<a href="windowspaths.html#%28part._windowspathrep%29" data-pltdoc="x">Windows Path Representation</a>.</p><p>See also <span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._string-~3esome-system-path%29%29" class="RktValLink" data-pltdoc="x">string-&gt;some-system-path</a></span>, and see
+<a href="unixpaths.html#%28part._unixpathrep%29" data-pltdoc="x">Unix Path Representation</a> and <a href="windowspaths.html#%28part._windowspathrep%29" data-pltdoc="x">Windows Path Representation</a> for information
+on how strings encode paths.</p><p class="SHistory">Changed in version 6.1.1.1 of package <span class="stt">base</span>: Changed Windows conversion to always use UTF-8.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-~3epath))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-&gt;path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">type</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">type</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">unix</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">windows</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._system-path-convention-type%29%29" class="RktValLink" data-pltdoc="x">system-path-convention-type</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a path (for some platform) whose byte-string encoding is
+<span class="RktVar">bstr</span>, where <span class="RktVar">bstr</span> must not contain a nul byte. The
+optional <span class="RktVar">type</span> specifies the convention to use for the path.</div></p><p>For converting relative <a href="More_Path_Utilities.html#%28tech._path._element%29" class="techoutside" data-pltdoc="x"><span class="techinside">path elements</span></a> from literals, use instead
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath-element%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;path-element</a></span>, which applies a suitable encoding for
+individual elements.</p><p>For information on how byte strings encode paths, see
+<a href="unixpaths.html#%28part._unixpathrep%29" data-pltdoc="x">Unix Path Representation</a> and <a href="windowspaths.html#%28part._windowspathrep%29" data-pltdoc="x">Windows Path Representation</a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._path-~3estring))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3estring%29%29" class="RktValDef RktValLink" data-pltdoc="x">path-&gt;string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a string that represents <span class="RktVar">path</span> by decoding
+<span class="RktVar">path</span>&rsquo;s byte-string encoding using the current locale
+on Unix and Mac OS and by using UTF-8 on Windows. In the former case,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">?</span><span class="hspace"></span></span> is used in the result string where encoding fails, and if
+the encoding result is the empty string, then the result is
+<span class="RktVal">"?"</span>.</div></p><p>The resulting string is suitable for displaying to a user,
+string-ordering comparisons, etc., but it is not suitable for
+re-creating a path (possibly modified) via <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._string-~3epath%29%29" class="RktValLink" data-pltdoc="x">string-&gt;path</a></span>,
+since decoding and re-encoding the path&rsquo;s byte string may lose
+information.</p><p>Furthermore, for display and sorting based on individual <a href="More_Path_Utilities.html#%28tech._path._element%29" class="techoutside" data-pltdoc="x"><span class="techinside">path elements</span></a>
+(such as pathless file names), use <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-element-~3estring%29%29" class="RktValLink" data-pltdoc="x">path-element-&gt;string</a></span>,
+instead, to avoid special encodings use to represent some relative
+paths. See <a href="windowspaths.html" data-pltdoc="x">Windows Paths</a> for specific information about
+the conversion of Windows paths.</p><p>See also <span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._some-system-path-~3estring%29%29" class="RktValLink" data-pltdoc="x">some-system-path-&gt;string</a></span>.</p><p class="SHistory">Changed in version 6.1.1.1 of package <span class="stt">base</span>: Changed Windows conversion to always use UTF-8.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._path-~3ebytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3ebytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">path-&gt;bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces <span class="RktVar">path</span>&rsquo;s byte-string representation. No information is
+lost in this translation, so that <span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;path</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3ebytes%29%29" class="RktValLink" data-pltdoc="x">path-&gt;bytes</a></span><span class="stt"> </span><span class="RktVar">path</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-convention-type%29%29" class="RktValLink" data-pltdoc="x">path-convention-type</a></span><span class="stt"> </span><span class="RktVar">path</span><span class="RktPn">)</span><span class="RktPn">)</span> always produces a path that is
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to <span class="RktVar">path</span>. The <span class="RktVar">path</span> argument can be a
+path for any platform.</div></p><p>Conversion to and from byte values is useful for marshaling and
+unmarshaling paths, but manipulating the byte form of a path is
+generally a mistake. In particular, the byte string may start with a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL</span><span class="hspace"></span></span> encoding for Windows paths. Instead of
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3ebytes%29%29" class="RktValLink" data-pltdoc="x">path-&gt;bytes</a></span>, use <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._split-path%29%29" class="RktValLink" data-pltdoc="x">split-path</a></span> and
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-element-~3ebytes%29%29" class="RktValLink" data-pltdoc="x">path-element-&gt;bytes</a></span> to manipulate individual <a href="More_Path_Utilities.html#%28tech._path._element%29" class="techoutside" data-pltdoc="x"><span class="techinside">path elements</span></a>.</p><p>For information on how byte strings encode paths, see
+<a href="unixpaths.html#%28part._unixpathrep%29" data-pltdoc="x">Unix Path Representation</a> and <a href="windowspaths.html#%28part._windowspathrep%29" data-pltdoc="x">Windows Path Representation</a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-~3epath-element))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._string-~3epath-element%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-&gt;path-element</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">str</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">false-on-non-element?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-element~3f%29%29" class="RktValLink" data-pltdoc="x">path-element?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">false-on-non-element?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._string-~3epath%29%29" class="RktValLink" data-pltdoc="x">string-&gt;path</a></span>, except that <span class="RktVar">str</span> corresponds to a
+single relative element in a path, and it is encoded as necessary to
+convert it to a path. See <a href="unixpaths.html" data-pltdoc="x">Unix and Mac OS Paths</a> and
+<a href="windowspaths.html" data-pltdoc="x">Windows Paths</a> for more information on the conversion of
+paths.</div></p><p>If <span class="RktVar">str</span> does not correspond to any <a href="More_Path_Utilities.html#%28tech._path._element%29" class="techoutside" data-pltdoc="x"><span class="techinside">path element</span></a>
+(e.g., it is an absolute path, or it can be split), or if it
+corresponds to an up-directory or same-directory indicator on
+Unix and Mac OS, then either <span class="RktVal">#f</span> is returned or <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.
+A <span class="RktVal">#f</span> is returned only when <span class="RktVar">false-on-non-element?</span>
+is true.</p><p>Like <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3estring%29%29" class="RktValLink" data-pltdoc="x">path-&gt;string</a></span>, information can be lost from
+<span class="RktVar">str</span> in the locale-specific conversion to a path.</p><p class="SHistory">Changed in version 8.1.0.6 of package <span class="stt">base</span>: Added the <span class="RktVar">false-on-non-element?</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-~3epath-element))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath-element%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-&gt;path-element</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">type</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">false-on-non-element?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-element~3f%29%29" class="RktValLink" data-pltdoc="x">path-element?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">type</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">unix</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">windows</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._system-path-convention-type%29%29" class="RktValLink" data-pltdoc="x">system-path-convention-type</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">false-on-non-element?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;path</a></span>, except that <span class="RktVar">bstr</span> corresponds to a
+single relative element in a path. In terms of conversions,
+restrictions on <span class="RktVar">bstr</span>, and the treatment of <span class="RktVar">false-on-non-element?</span>,
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath-element%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;path-element</a></span> is like <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._string-~3epath-element%29%29" class="RktValLink" data-pltdoc="x">string-&gt;path-element</a></span>.</div></p><p>The <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath-element%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;path-element</a></span> procedure is generally the best
+choice for reconstructing a path based on another path (where the
+other path is deconstructed with <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._split-path%29%29" class="RktValLink" data-pltdoc="x">split-path</a></span> and
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-element-~3ebytes%29%29" class="RktValLink" data-pltdoc="x">path-element-&gt;bytes</a></span>) when ASCII-level manipulation of
+<a href="More_Path_Utilities.html#%28tech._path._element%29" class="techoutside" data-pltdoc="x"><span class="techinside">path elements</span></a> is necessary.</p><p class="SHistory">Changed in version 8.1.0.6 of package <span class="stt">base</span>: Added the <span class="RktVar">false-on-non-element?</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._path-element-~3estring))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-element-~3estring%29%29" class="RktValDef RktValLink" data-pltdoc="x">path-element-&gt;string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-element~3f%29%29" class="RktValLink" data-pltdoc="x">path-element?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3estring%29%29" class="RktValLink" data-pltdoc="x">path-&gt;string</a></span>, except that trailing path separators are
+removed (as by <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._split-path%29%29" class="RktValLink" data-pltdoc="x">split-path</a></span>). On Windows, any
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL</span><span class="hspace"></span></span> encoding prefix is also removed; see
+<a href="windowspaths.html" data-pltdoc="x">Windows Paths</a> for more information.</div></p><p>The <span class="RktVar">path</span> argument must be such that <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._split-path%29%29" class="RktValLink" data-pltdoc="x">split-path</a></span>
+applied to <span class="RktVar">path</span> would return <span class="RktVal">'</span><span class="RktVal">relative</span> as its first
+result and a path as its second result, otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>The <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-element-~3estring%29%29" class="RktValLink" data-pltdoc="x">path-element-&gt;string</a></span> procedure is generally the best
+choice for presenting a pathless file or directory name to a user.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._path-element-~3ebytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-element-~3ebytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">path-element-&gt;bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-element~3f%29%29" class="RktValLink" data-pltdoc="x">path-element?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3ebytes%29%29" class="RktValLink" data-pltdoc="x">path-&gt;bytes</a></span>, except that any encoding prefix is removed,
+etc., as for <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-element-~3estring%29%29" class="RktValLink" data-pltdoc="x">path-element-&gt;string</a></span>.</div></p><p>For any reasonable locale, consecutive ASCII characters in the printed
+form of <span class="RktVar">path</span> are mapped to consecutive byte values that match
+each character&rsquo;s code-point value, and a leading or trailing ASCII
+character is mapped to a leading or trailing byte, respectively. The
+<span class="RktVar">path</span> argument can be a path for any platform.</p><p>The <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-element-~3ebytes%29%29" class="RktValLink" data-pltdoc="x">path-element-&gt;bytes</a></span> procedure is generally the right
+choice (in combination with <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._split-path%29%29" class="RktValLink" data-pltdoc="x">split-path</a></span>) for extracting the
+content of a path to manipulate it at the ASCII level (then
+reassembling the result with <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath-element%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;path-element</a></span> and
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span>).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._path~3c~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3c~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">path&lt;?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a-path</span><span class="hspace">&nbsp;</span><span class="RktVar">b-path</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a-path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b-path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if the arguments are sorted, where the comparison
+for each pair of paths is the same as using
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3ebytes%29%29" class="RktValLink" data-pltdoc="x">path-&gt;bytes</a></span> and <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3c~3f%29%29" class="RktValLink" data-pltdoc="x">bytes&lt;?</a></span>.</div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._path-convention-type))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-convention-type%29%29" class="RktValDef RktValLink" data-pltdoc="x">path-convention-type</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">unix</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">windows</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Accepts a path value (not a string) and returns its convention
+type.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._system-path-convention-type))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._system-path-convention-type%29%29" class="RktValDef RktValLink" data-pltdoc="x">system-path-convention-type</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">unix</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">windows</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns the path convention type of the current platform:
+<a name="(idx._(gentag._288._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">unix</span> for Unix and Mac OS, <a name="(idx._(gentag._289._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">windows</span> for
+Windows.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._build-path))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">build-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">base</span><span class="hspace">&nbsp;</span><span class="RktVar">sub</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">base</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">up</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">same</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">sub</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">up</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">same</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Creates a path given a base path and any number of sub-path
+extensions. If <span class="RktVar">base</span> is an absolute path, the result is an
+absolute path, otherwise the result is a relative path.</div></p><p>The <span class="RktVar">base</span> and each <span class="RktVar">sub</span> must be either a relative
+path, the symbol <a name="(idx._(gentag._290._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">up</span> (indicating the relative parent
+directory), or the symbol <a name="(idx._(gentag._291._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">same</span> (indicating the
+relative current directory).  For Windows paths, if <span class="RktVar">base</span> is a
+drive specification (with or without a trailing slash) the first
+<span class="RktVar">sub</span> can be an absolute (driveless) path. For all platforms,
+the last <span class="RktVar">sub</span> can be a filename.</p><p>The <span class="RktVar">base</span> and <span class="RktVar">sub</span> arguments can be paths for
+any platform. The platform for the resulting path is inferred from the
+<span class="RktVar">base</span> and <span class="RktVar">sub</span> arguments, where string arguments imply
+a path for the current platform. If different arguments are for
+different platforms, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. If no argument
+implies a platform (i.e., all are <span class="RktVal">'</span><span class="RktVal">up</span> or <span class="RktVal">'</span><span class="RktVal">same</span>), the
+generated path is for the current platform.</p><p>Each <span class="RktVar">sub</span> and <span class="RktVar">base</span> can optionally end in a directory
+separator. If the last <span class="RktVar">sub</span> ends in a separator, it is
+included in the resulting path.</p><p>If <span class="RktVar">base</span> or <span class="RktVar">sub</span> is an illegal path string (because it
+is empty or contains a nul character), the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>The <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span> procedure builds a path <span style="font-style: italic">without</span>
+checking the validity of the path or accessing the filesystem.</p><p>See <a href="unixpaths.html" data-pltdoc="x">Unix and Mac OS Paths</a> and <a href="windowspaths.html" data-pltdoc="x">Windows Paths</a> for more
+information on the construction of paths.</p><p>The following examples assume that the current directory is
+<span class="stt">"/home/joeuser"</span> for Unix examples and <span class="stt">"C:\Joe&rsquo;s Files"</span> for
+Windows examples.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"src"</span><span class="hspace">&nbsp;</span><span class="RktVal">"racket"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Unix: </span><span class="RktSym">p1</span><span class="RktCmt"> is </span><span class="RktVal">"/home/joeuser/src/racket"</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Windows: </span><span class="RktSym">p1</span><span class="RktCmt"> is </span><span class="RktVal">"C:\\Joe's Files\\src\\racket"</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">up</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">up</span><span class="hspace">&nbsp;</span><span class="RktVal">"docs"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Racket"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Unix: </span><span class="RktSym">p2</span><span class="RktCmt"> is </span><span class="RktVal">"../../docs/Racket"</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Windows: </span><span class="RktSym">p2</span><span class="RktCmt"> is </span><span class="RktVal">"..\\..\\docs\\Racket"</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p2</span><span class="hspace">&nbsp;</span><span class="RktSym">p1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Unix and Windows: raises </span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span><span class="RktCmt">; </span><span class="RktSym">p1</span><span class="RktCmt"> is absolute</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p1</span><span class="hspace">&nbsp;</span><span class="RktSym">p2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Unix: is </span><span class="RktVal">"/home/joeuser/src/racket/../../docs/Racket"</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Windows: is </span><span class="RktVal">"C:\\Joe's Files\\src\\racket\\..\\..\\docs\\Racket"</span></td></tr></table></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._build-path/convention-type))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%2Fconvention-type%29%29" class="RktValDef RktValLink" data-pltdoc="x">build-path/convention-type</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">type</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">base</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">sub</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">type</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">unix</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">windows</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">base</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">up</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">same</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">sub</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">up</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">same</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span>, except a path convention type is specified
+explicitly.</div></p><p>Note that, just as with <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span>, any string arguments for either
+<span class="RktVar">base</span> or <span class="RktVar">sub</span> will be implicitly converted into a path for the
+current platform before being combined with the others. For this reason, you
+cannot use this function to build paths from strings for any platform other
+than the current one; in such attempts, <span class="RktVar">type</span> does not match the
+inferred convention type for the strings and an <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.
+(To create paths for foreign platforms, see <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;path</a></span>.)</p><p>The usefulness of <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%2Fconvention-type%29%29" class="RktValLink" data-pltdoc="x">build-path/convention-type</a></span> over <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span>
+is limited to cases where the sub-paths contain <span class="RktVal">'</span><span class="RktVal">same</span> or <span class="RktVal">'</span><span class="RktVal">up</span>
+elements.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._absolute-path~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._absolute-path~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">absolute-path?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">path</span> is an absolute path, <span class="RktVal">#f</span>
+otherwise. The <span class="RktVar">path</span> argument can be a path for any
+platform. If <span class="RktVar">path</span> is not a legal path string (e.g., it
+contains a nul character), <span class="RktVal">#f</span> is returned. This procedure
+does not access the filesystem.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._relative-path~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._relative-path~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">relative-path?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">path</span> is a relative path, <span class="RktVal">#f</span>
+otherwise. The <span class="RktVar">path</span> argument can be a path for any
+platform. If <span class="RktVar">path</span> is not a legal path string (e.g., it
+contains a nul character), <span class="RktVal">#f</span> is returned. This procedure
+does not access the filesystem.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._complete-path~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">complete-path?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">path</span> is a <a name="(tech._complete)"></a><span style="font-style: italic">complete</span>ly determined path
+(<span style="font-style: italic">not</span> relative to a directory or drive), <span class="RktVal">#f</span>
+otherwise. The <span class="RktVar">path</span> argument can be a path for any
+platform. Note that for Windows paths, an absolute path can omit the
+drive specification, in which case the path is neither relative nor
+complete. If <span class="RktVar">path</span> is not a legal path string (e.g., it
+contains a nul character), <span class="RktVal">#f</span> is returned.</div></p><p>This procedure does not access the filesystem.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._path-~3ecomplete-path))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3ecomplete-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">path-&gt;complete-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">base</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">base</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVar">path</span> as a complete path. If <span class="RktVar">path</span> is already
+a complete path, it is returned as the result. Otherwise,
+<span class="RktVar">path</span> is resolved with respect to the complete path
+<span class="RktVar">base</span>. If <span class="RktVar">base</span> is not a complete path, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p>The <span class="RktVar">path</span> and <span class="RktVar">base</span> arguments can be paths for any
+platform; if they are for different
+platforms, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>This procedure does not access the filesystem.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._path-~3edirectory-path))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3edirectory-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">path-&gt;directory-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVar">path</span> if <span class="RktVar">path</span> syntactically refers to a
+directory and ends in a separator, otherwise it returns an extended
+version of <span class="RktVar">path</span> that specifies a directory and ends with a
+separator. For example, on Unix and Mac OS, the path <span class="stt">"x/y/"</span>
+syntactically refers to a directory and ends in a separator, but
+<span class="stt">"x/y"</span> would be extended to <span class="stt">"x/y/"</span>, and <span class="stt">"x/.."</span> would be
+extended to <span class="stt">"x/../"</span>. The <span class="RktVar">path</span> argument can be a path for
+any platform, and the result will be for the same platform.</div></p><p>This procedure does not access the filesystem.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._resolve-path))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._resolve-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">resolve-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"><a href="pathutils.html#%28tech._cleanse%29" class="techoutside" data-pltdoc="x"><span class="techinside">Cleanse</span></a>s <span class="RktVar">path</span> and returns a path that references the
+same file or directory as <span class="RktVar">path</span>. If
+<span class="RktVar">path</span> is a soft link to another path, then the referenced path
+is returned (this may be a relative path with respect to the directory
+owning <span class="RktVar">path</span>), otherwise <span class="RktVar">path</span> is returned (after
+cleansing).</div></p><p>On Windows, the path for a link should be simplified syntactically, so
+that an up-directory indicator removes a preceding path element
+independent of whether the preceding element itself refers to a
+link. For relative-paths links, the path should be parsed specially;
+see <a href="windowspaths.html" data-pltdoc="x">Windows Paths</a> for more information.</p><p class="SHistory">Changed in version 6.0.1.12 of package <span class="stt">base</span>: Added support for links on Windows.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cleanse-path))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._cleanse-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">cleanse-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara"><a href="pathutils.html#%28tech._cleanse%29" data-pltdoc="x">Cleanse</a>s <span class="RktVar">path</span> (as described at the beginning of
+this chapter) without consulting the filesystem.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._string-~3esome-system-path%29%29" class="RktValLink" data-pltdoc="x">string-&gt;some-system-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"tiny//dancer"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">unix</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._cleanse-path%29%29" class="RktValLink" data-pltdoc="x">cleanse-path</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;path:tiny/dancer&gt;</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._expand-user-path))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._expand-user-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">expand-user-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"><a href="pathutils.html#%28tech._cleanse%29" data-pltdoc="x">Cleanse</a>s <span class="RktVar">path</span>. In addition, on Unix and Mac OS, a
+leading <span class="RktInBG"><span class="hspace"></span><span class="RktIn">~</span><span class="hspace"></span></span> is treated as user&rsquo;s home directory and expanded;
+the username follows the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">~</span><span class="hspace"></span></span> (before a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> or the end
+of the path), where <span class="RktInBG"><span class="hspace"></span><span class="RktIn">~</span><span class="hspace"></span></span> by itself indicates the home directory
+of the current user.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._simplify-path))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._simplify-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">simplify-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">use-filesystem?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">use-filesystem?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Eliminates redundant path separators (except for a single trailing
+separator), up-directory <span class="RktInBG"><span class="hspace"></span><span class="RktIn">..</span><span class="hspace"></span></span>, and same-directory <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>
+indicators in <span class="RktVar">path</span>, and changes <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> separators to
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> separators in Windows paths, such that the result
+accesses the same file or directory (if it exists) as <span class="RktVar">path</span>.</div></p><p>In general, the pathname is normalized as much as possible&#8212;<wbr></wbr>without
+consulting the filesystem if <span class="RktVar">use-filesystem?</span> is <span class="RktVal">#f</span>,
+and (on Windows) without changing the case of letters within the
+path.  If <span class="RktVar">path</span> syntactically refers to a directory, the
+result ends with a directory separator.</p><p>When <span class="RktVar">path</span> is simplified other than just converting slashes
+to backslashes and <span class="RktVar">use-filesystem?</span> is true
+(the default), a complete path is returned. If <span class="RktVar">path</span> is
+relative, it is resolved with respect to the current directory.
+On Unix and Mac OS, up-directory indicators are removed taking into account soft links (so
+that the resulting path refers to the same directory as before);
+on Windows, up-directory indicators are removed by deleting a
+preceding <a href="More_Path_Utilities.html#%28tech._path._element%29" class="techoutside" data-pltdoc="x"><span class="techinside">path element</span></a>.</p><p>When <span class="RktVar">use-filesystem?</span> is <span class="RktVal">#f</span>, up-directory indicators
+are removed by deleting a preceding <a href="More_Path_Utilities.html#%28tech._path._element%29" class="techoutside" data-pltdoc="x"><span class="techinside">path element</span></a>, and the result can
+be a relative path with up-directory indicators remaining at the
+beginning of the path; up-directory indicators are dropped when they
+refer to the parent of a root directory. Similarly, the result can be
+the same as <span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">same</span><span class="RktPn">)</span> (but with a trailing
+separator) if eliminating up-directory indicators leaves only
+same-directory indicators.</p><p>The <span class="RktVar">path</span> argument can be a path for any platform when
+<span class="RktVar">use-filesystem?</span> is <span class="RktVal">#f</span>, and the resulting path is for
+the same platform.</p><p>The filesystem might be accessed when <span class="RktVar">use-filesystem?</span> is
+true, but the source or simplified path might be a non-existent path. If
+<span class="RktVar">path</span> cannot be simplified due to a cycle of links, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> exception is raised (but a successfully simplified path may
+still involve a cycle of links if the cycle did not inhibit the
+simplification).</p><p>See <a href="unixpaths.html" data-pltdoc="x">Unix and Mac OS Paths</a> and <a href="windowspaths.html" data-pltdoc="x">Windows Paths</a> for more
+information on simplifying paths.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._string-~3esome-system-path%29%29" class="RktValLink" data-pltdoc="x">string-&gt;some-system-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"tiny//in/my/head/../../../dancer"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">unix</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._simplify-path%29%29" class="RktValLink" data-pltdoc="x">simplify-path</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;path:tiny/dancer&gt;</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._normal-case-path))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._normal-case-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">normal-case-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVar">path</span> with &ldquo;normalized&rdquo; case characters. For Unix and Mac OS
+paths, this procedure always returns the input path, because
+filesystems for these platforms can be case-sensitive. For Windows
+paths, if <span class="RktVar">path</span> does not start with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span>, the
+resulting string uses only lowercase letters, based on the current
+locale. In addition, for Windows paths when the path does not start
+with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span>, all <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>s are converted to
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s, and trailing spaces and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>s are removed.</div></p><p>The <span class="RktVar">path</span> argument can be a path for any platform, but beware
+that local-sensitive decoding and conversion of the path may be
+different on the current platform than for the path&rsquo;s platform.</p><p>This procedure does not access the filesystem.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._split-path))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._split-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">split-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">relative</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">up</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">same</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Deconstructs <span class="RktVar">path</span> into a smaller path and an immediate
+directory or file name.  Three values are returned:</div></p><ul><li><p><span class="RktSym">base</span> is either</p><ul><li><p>a path,</p></li><li><p><a name="(idx._(gentag._292._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">relative</span> if <span class="RktVar">path</span> is an immediate
+relative directory or filename, or</p></li><li><p><span class="RktVal">#f</span> if <span class="RktVar">path</span> is a root directory.</p></li></ul></li><li><p><div class="SIntrapara"><span class="RktSym">name</span> is either
+</div><div class="SIntrapara"><ul><li><p>a directory-name path,</p></li><li><p>a filename,</p></li><li><p><span class="RktVal">'</span><span class="RktVal">up</span> if the last part of <span class="RktVar">path</span> specifies the parent
+directory of the preceding path (e.g., <span class="RktInBG"><span class="hspace"></span><span class="RktIn">..</span><span class="hspace"></span></span> on Unix), or</p></li><li><p><span class="RktVal">'</span><span class="RktVal">same</span> if the last part of <span class="RktVar">path</span> specifies the
+same directory as the  preceding path (e.g., <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> on Unix).</p></li></ul></div></p></li><li><p><span class="RktSym">must-be-dir?</span> is <span class="RktVal">#t</span> if <span class="RktVar">path</span> explicitly
+specifies a directory (e.g., with a trailing separator), <span class="RktVal">#f</span>
+otherwise. Note that <span class="RktSym">must-be-dir?</span> does not specify whether
+<span class="RktSym">name</span> is actually a directory or not, but whether <span class="RktVar">path</span>
+syntactically specifies a directory.</p></li></ul><p>Compared to <span class="RktVar">path</span>, redundant separators (if any) are removed
+in the result <span class="RktSym">base</span> and <span class="RktSym">name</span>.  If <span class="RktSym">base</span> is
+<span class="RktVal">#f</span>, then <span class="RktSym">name</span> cannot be <span class="RktVal">'</span><span class="RktVal">up</span> or
+<span class="RktVal">'</span><span class="RktVal">same</span>. The <span class="RktVar">path</span> argument can be a path for any
+platform, and resulting paths for the same platform.</p><p>This procedure does not access the filesystem.</p><p>See <a href="unixpaths.html" data-pltdoc="x">Unix and Mac OS Paths</a> and <a href="windowspaths.html" data-pltdoc="x">Windows Paths</a> for more
+information on splitting paths.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._explode-path))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._explode-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">explode-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">up</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">same</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the list of <a href="More_Path_Utilities.html#%28tech._path._element%29" class="techoutside" data-pltdoc="x"><span class="techinside">path elements</span></a> that constitute <span class="RktVar">path</span>.  If
+<span class="RktVar">path</span> is simplified in the sense of <span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._simple-form-path%29%29" class="RktValLink" data-pltdoc="x">simple-form-path</a></span>,
+then the result is always a list of paths, and the first element of
+the list is a root.</div></p><p>The <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._explode-path%29%29" class="RktValLink" data-pltdoc="x">explode-path</a></span> function computes its result in time
+proportional to the length of <span class="RktVar">path</span> (unlike a loop in that
+uses <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._split-path%29%29" class="RktValLink" data-pltdoc="x">split-path</a></span>, which must allocate intermediate paths).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._path-replace-extension))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-replace-extension%29%29" class="RktValDef RktValLink" data-pltdoc="x">path-replace-extension</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktVar">ext</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ext</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a path that is the same as <span class="RktVar">path</span>, except that the
+extension for the last element of the path (including the extension
+separator) is changed to <span class="RktVar">ext</span>. If the last element of
+<span class="RktVar">path</span> has no extension, then <span class="RktVar">ext</span> is added to the
+path.</div></p><p>An extension is defined as a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> that is not at the start of
+the path element followed by any number of non-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>
+characters/bytes at the end of the <a href="More_Path_Utilities.html#%28tech._path._element%29" class="techoutside" data-pltdoc="x"><span class="techinside">path element</span></a>, as long as the
+path element is not a directory indicator like <span class="RktVal">".."</span>.</p><p>The <span class="RktVar">path</span> argument can be a path for any platform, and the
+result is for the same platform. If <span class="RktVar">path</span> represents a root,
+the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. The given <span class="RktVar">ext</span> typically
+starts with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>, but it is not required to start with an
+extension separator.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-replace-extension%29%29" class="RktValLink" data-pltdoc="x">path-replace-extension</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x/y.ss"</span><span class="hspace">&nbsp;</span><span class="RktVal">#".rkt"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;path:x/y.rkt&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-replace-extension%29%29" class="RktValLink" data-pltdoc="x">path-replace-extension</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x/y.ss"</span><span class="hspace">&nbsp;</span><span class="RktVal">#""</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;path:x/y&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-replace-extension%29%29" class="RktValLink" data-pltdoc="x">path-replace-extension</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x/y"</span><span class="hspace">&nbsp;</span><span class="RktVal">#".rkt"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;path:x/y.rkt&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-replace-extension%29%29" class="RktValLink" data-pltdoc="x">path-replace-extension</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x/y.tar.gz"</span><span class="hspace">&nbsp;</span><span class="RktVal">#".rkt"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;path:x/y.tar.rkt&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-replace-extension%29%29" class="RktValLink" data-pltdoc="x">path-replace-extension</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x/.racketrc"</span><span class="hspace">&nbsp;</span><span class="RktVal">#".rkt"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;path:x/.racketrc.rkt&gt;</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.5.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._path-add-extension))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-add-extension%29%29" class="RktValDef RktValLink" data-pltdoc="x">path-add-extension</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktVar">ext</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">sep</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ext</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sep</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#"_"</span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-replace-extension%29%29" class="RktValLink" data-pltdoc="x">path-replace-extension</a></span>, but any existing extension on
+<span class="RktVar">path</span> is preserved by replacing the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> before the extension
+with <span class="RktVar">sep</span>, and then the <span class="RktVar">ext</span> is added
+to the end.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-add-extension%29%29" class="RktValLink" data-pltdoc="x">path-add-extension</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x/y.ss"</span><span class="hspace">&nbsp;</span><span class="RktVal">#".rkt"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;path:x/y_ss.rkt&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-add-extension%29%29" class="RktValLink" data-pltdoc="x">path-add-extension</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x/y"</span><span class="hspace">&nbsp;</span><span class="RktVal">#".rkt"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;path:x/y.rkt&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-add-extension%29%29" class="RktValLink" data-pltdoc="x">path-add-extension</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x/y.tar.gz"</span><span class="hspace">&nbsp;</span><span class="RktVal">#".rkt"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;path:x/y.tar_gz.rkt&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-add-extension%29%29" class="RktValLink" data-pltdoc="x">path-add-extension</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x/y.tar.gz"</span><span class="hspace">&nbsp;</span><span class="RktVal">#".rkt"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"."</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;path:x/y.tar.gz.rkt&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-add-extension%29%29" class="RktValLink" data-pltdoc="x">path-add-extension</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x/.racketrc"</span><span class="hspace">&nbsp;</span><span class="RktVal">#".rkt"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;path:x/.racketrc.rkt&gt;</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.5.0.3 of package <span class="stt">base</span>.<br/>Changed in version 6.8.0.2: Added the <span class="RktVar">sep</span> optional argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._path-replace-suffix))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-replace-suffix%29%29" class="RktValDef RktValLink" data-pltdoc="x">path-replace-suffix</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktVar">ext</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ext</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote><p><span style="background-color: yellow"><span style="font-weight: bold">NOTE:</span></span> This function is deprecated; use <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-replace-extension%29%29" class="RktValLink" data-pltdoc="x">path-replace-extension</a></span>, instead. </p></blockquote></div></p><p>Like <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-replace-extension%29%29" class="RktValLink" data-pltdoc="x">path-replace-extension</a></span>, but treats a leading <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>
+in a path element as an extension separator.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._path-add-suffix))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-add-suffix%29%29" class="RktValDef RktValLink" data-pltdoc="x">path-add-suffix</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktVar">ext</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ext</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote><p><span style="background-color: yellow"><span style="font-weight: bold">NOTE:</span></span> This function is deprecated; use <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-add-extension%29%29" class="RktValLink" data-pltdoc="x">path-add-extension</a></span>, instead. </p></blockquote></div></p><p>Like <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-add-extension%29%29" class="RktValLink" data-pltdoc="x">path-add-extension</a></span>, but treats a leading <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>
+in a path element as an extension separator.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._reroot-path))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._reroot-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">reroot-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktVar">root-path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">root-path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a path that extends <span class="RktVar">root-path</span> based on the complete
+form of <span class="RktVar">path</span>.</div></p><p>If <span class="RktVar">path</span> is not already <a href="Manipulating_Paths.html#%28tech._complete%29" class="techoutside" data-pltdoc="x"><span class="techinside">complete</span></a>, is it completed via
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3ecomplete-path%29%29" class="RktValLink" data-pltdoc="x">path-&gt;complete-path</a></span>, in which case <span class="RktVar">path</span> must be a
+path for the current platform. The <span class="RktVar">path</span> argument is also
+<a href="pathutils.html#%28tech._cleanse%29" class="techoutside" data-pltdoc="x"><span class="techinside">cleanse</span></a>d and case-normalized via <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._normal-case-path%29%29" class="RktValLink" data-pltdoc="x">normal-case-path</a></span>. The
+path is then appended to <span class="RktVar">root-path</span>; in the case of Windows
+paths, a root letter drive becomes a letter path element, while a root
+UNC path is prefixed with <span class="RktVal">"UNC"</span> as a path element and the
+machine and volume names become path elements.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._reroot-path%29%29" class="RktValLink" data-pltdoc="x">reroot-path</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"/home/caprica/baltar"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">unix</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"/earth"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">unix</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;path:/earth/home/caprica/baltar&gt;</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._reroot-path%29%29" class="RktValLink" data-pltdoc="x">reroot-path</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"c:\\usr\\adama"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">windows</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"\\\\earth\\africa\\"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">windows</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;windows-path:\\earth\africa\c\usr\adama&gt;</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._reroot-path%29%29" class="RktValLink" data-pltdoc="x">reroot-path</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"\\\\galactica\\cac\\adama"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">windows</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"s:\\earth\\africa\\"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">windows</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;windows-path:s:\earth\africa\UNC\galactica\cac\adama&gt;</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="pathutils.html" title="backward to &quot;15.1 Paths&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="pathutils.html" title="up to &quot;15.1 Paths&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="More_Path_Utilities.html" title="forward to &quot;15.1.2 More Path Utilities&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Module_Names_and_Loading.html b/clones/docs.racket-lang.org/reference/Module_Names_and_Loading.html
new file mode 100644
index 00000000..5aae0174
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Module_Names_and_Loading.html
@@ -0,0 +1,320 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14.4&nbsp;Module Names and Loading</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewselflink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Namespaces.html" class="tocviewlink" data-pltdoc="x">Namespaces</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="eval.html" class="tocviewlink" data-pltdoc="x">Evaluation and Compilation</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="load-lang.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>load</span></span> Language</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="Module_Names_and_Loading.html" class="tocviewselflink" data-pltdoc="x">Module Names and Loading</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="chaperones.html" class="tocviewlink" data-pltdoc="x">Impersonators and Chaperones</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="securityguards.html" class="tocviewlink" data-pltdoc="x">Security Guards</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="custodians.html" class="tocviewlink" data-pltdoc="x">Custodians</a></td></tr><tr><td align="right">14.8&nbsp;</td><td><a href="threadgroups.html" class="tocviewlink" data-pltdoc="x">Thread Groups</a></td></tr><tr><td align="right">14.9&nbsp;</td><td><a href="inspectors.html" class="tocviewlink" data-pltdoc="x">Structure Inspectors</a></td></tr><tr><td align="right">14.10&nbsp;</td><td><a href="modprotect.html" class="tocviewlink" data-pltdoc="x">Code Inspectors</a></td></tr><tr><td align="right">14.11&nbsp;</td><td><a href="plumbers.html" class="tocviewlink" data-pltdoc="x">Plumbers</a></td></tr><tr><td align="right">14.12&nbsp;</td><td><a href="Sandboxed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Sandboxed Evaluation</a></td></tr><tr><td align="right">14.13&nbsp;</td><td><a href="repl-module.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>repl</span></span> Library</a></td></tr><tr><td align="right">14.14&nbsp;</td><td><a href="linklets.html" class="tocviewlink" data-pltdoc="x">Linklets and the Core Compiler</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>14.4&nbsp;</td><td><a href="Module_Names_and_Loading.html" class="tocviewselflink" data-pltdoc="x">Module Names and Loading</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.4.1&nbsp;</td><td><a href="Module_Names_and_Loading.html#%28part._modnameresolver%29" class="tocviewlink" data-pltdoc="x">Resolving Module Names</a></td></tr><tr><td align="right">14.4.2&nbsp;</td><td><a href="Module_Names_and_Loading.html#%28part._modpathidx%29" class="tocviewlink" data-pltdoc="x">Compiled Modules and References</a></td></tr><tr><td align="right">14.4.3&nbsp;</td><td><a href="Module_Names_and_Loading.html#%28part._dynreq%29" class="tocviewlink" data-pltdoc="x">Dynamic Module Access</a></td></tr><tr><td align="right">14.4.4&nbsp;</td><td><a href="Module_Names_and_Loading.html#%28part._modcache%29" class="tocviewlink" data-pltdoc="x">Module Cache</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">14.4.1<tt>&nbsp;</tt></span><a href="Module_Names_and_Loading.html#%28part._modnameresolver%29" class="tocsubseclink" data-pltdoc="x">Resolving Module Names</a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">resolved-<wbr></wbr>module-<wbr></wbr>path?</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._make-resolved-module-path%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>resolved-<wbr></wbr>module-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path-name%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">resolved-<wbr></wbr>module-<wbr></wbr>path-<wbr></wbr>name</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>path?</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-name-resolver%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>module-<wbr></wbr>name-<wbr></wbr>resolver</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-declare-name%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>module-<wbr></wbr>declare-<wbr></wbr>name</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-declare-source%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>module-<wbr></wbr>declare-<wbr></wbr>source</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-path-for-load%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>module-<wbr></wbr>path-<wbr></wbr>for-<wbr></wbr>load</span></span></a></td></tr><tr><td><span class="tocsublinknumber">14.4.2<tt>&nbsp;</tt></span><a href="Module_Names_and_Loading.html#%28part._modpathidx%29" class="tocsubseclink" data-pltdoc="x">Compiled Modules and References</a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>path-<wbr></wbr>index?</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index-resolve%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>path-<wbr></wbr>index-<wbr></wbr>resolve</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index-split%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>path-<wbr></wbr>index-<wbr></wbr>split</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index-submodule%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>path-<wbr></wbr>index-<wbr></wbr>submodule</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index-join%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>path-<wbr></wbr>index-<wbr></wbr>join</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._compiled-module-expression~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compiled-<wbr></wbr>module-<wbr></wbr>expression?</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-name%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>compiled-<wbr></wbr>name</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-submodules%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>compiled-<wbr></wbr>submodules</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-imports%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>compiled-<wbr></wbr>imports</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-exports%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>compiled-<wbr></wbr>exports</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-indirect-exports%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>compiled-<wbr></wbr>indirect-<wbr></wbr>exports</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-language-info%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>compiled-<wbr></wbr>language-<wbr></wbr>info</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-cross-phase-persistent~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>compiled-<wbr></wbr>cross-<wbr></wbr>phase-<wbr></wbr>persistent?</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-realm%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>compiled-<wbr></wbr>realm</span></span></a></td></tr><tr><td><span class="tocsublinknumber">14.4.3<tt>&nbsp;</tt></span><a href="Module_Names_and_Loading.html#%28part._dynreq%29" class="tocsubseclink" data-pltdoc="x">Dynamic Module Access</a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-<wbr></wbr>require</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require-for-syntax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-<wbr></wbr>require-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-declared~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>declared?</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3elanguage-info%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>&gt;language-<wbr></wbr>info</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3eimports%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>&gt;imports</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3eexports%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>&gt;exports</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3eindirect-exports%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>&gt;indirect-<wbr></wbr>exports</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3erealm%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>&gt;realm</span></span></a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-predefined~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>predefined?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">14.4.4<tt>&nbsp;</tt></span><a href="Module_Names_and_Loading.html#%28part._modcache%29" class="tocsubseclink" data-pltdoc="x">Module Cache</a></td></tr><tr><td><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-cache-clear%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>cache-<wbr></wbr>clear!</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="load-lang.html" title="backward to &quot;14.3 The racket/load Language&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="chaperones.html" title="forward to &quot;14.5 Impersonators and Chaperones&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Module_Names_and_Loading&quot;">14.4<tt>&nbsp;</tt><a name="(part._.Module_.Names_and_.Loading)"></a>Module Names and Loading</h4><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;modnameresolver&quot;">14.4.1<tt>&nbsp;</tt><a name="(part._modnameresolver)"></a>Resolving Module Names</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=module-helpers.html%23%2528mod-path._syntax%252Fmodresolve%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">syntax/modresolve</span></a> library provides additional
+operations for resolving and manipulating module names.</p></blockquote></blockquote></blockquote><p>The name of a declared module is represented by a <a name="(tech._resolved._module._path)"></a><span style="font-style: italic">resolved
+module path</span>, which encapsulates either a symbol or a complete
+filesystem path (see <a href="pathutils.html" data-pltdoc="x">Paths</a>). A symbol normally refers
+to a predefined module or module declared through reflective
+evaluation (e.g., <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span>). A filesystem path normally refers to
+a module declaration that was loaded on demand via <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> or
+other forms.</p><p>A <a name="(tech._module._path)"></a><span style="font-style: italic">module path</span> is a datum that matches the grammar for
+<span class="RktVar">module-path</span> for <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>. A module path is relative
+to another module.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._resolved-module-path~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">resolved-module-path?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module path</span></a>,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-resolved-module-path))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._make-resolved-module-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-resolved-module-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._non-empty-listof%29%29" class="RktValLink" data-pltdoc="x">non-empty-listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module path</span></a> that encapsulates <span class="RktVar">path</span>,
+where a list <span class="RktVar">path</span> corresponds to a <a href="eval-model.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodule</span></a> path.
+If <span class="RktVar">path</span> is a path or starts with a path, the path normally should be
+<a href="pathutils.html#%28tech._cleanse%29" class="techoutside" data-pltdoc="x"><span class="techinside">cleanse</span></a>d (see <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._cleanse-path%29%29" class="RktValLink" data-pltdoc="x">cleanse-path</a></span>) and simplified (see
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._simplify-path%29%29" class="RktValLink" data-pltdoc="x">simplify-path</a></span>, including consulting the file system).</div></p><p>A <a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module path</span></a> is interned. That is, if two
+<a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module path</span></a> values encapsulate paths that are
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>, then the <a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module path</span></a> values are
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._resolved-module-path-name))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path-name%29%29" class="RktValDef RktValLink" data-pltdoc="x">resolved-module-path-name</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._non-empty-listof%29%29" class="RktValLink" data-pltdoc="x">non-empty-listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">module-path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the path or symbol encapsulated by a <a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module path</span></a>.
+A list result corresponds to a <a href="eval-model.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodule</span></a> path.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-path~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-path?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> corresponds to a datum that matches
+the grammar for <span class="RktVar">module-path</span> for <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>,
+<span class="RktVal">#f</span> otherwise. Note that a path (in the sense of
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span>) is a module path.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-module-name-resolver))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-name-resolver%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-module-name-resolver</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._case-~3e%29%29" class="RktStxLink" data-pltdoc="x">case-&gt;</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-name-resolver%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-module-name-resolver</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._case-~3e%29%29" class="RktStxLink" data-pltdoc="x">case-&gt;</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the current <a name="(tech._module._name._resolver)"></a><span style="font-style: italic">module name
+resolver</span>, which manages the conversion from other kinds of module
+references to a <a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module path</span></a>. For example,
+when the expander encounters <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktVar">module-path</span><span class="RktPn">)</span> where
+<span class="RktVar">module-path</span> is not an identifier, then the expander passes
+<span class="RktVal">'</span><span class="RktVar">module-path</span> to the module name resolver to obtain a symbol
+or resolved module path. When such a <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> appears within a
+module, the <a name="(tech._module._path._resolver)"></a><span style="font-style: italic">module path resolver</span> is also given the name of
+the enclosing module, so that a relative reference can be converted to
+an absolute symbol or <a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module path</span></a>.</div></p><p>The default <a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name resolver</span></a> uses
+<span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-file-path%29%29" class="RktValLink" data-pltdoc="x">collection-file-path</a></span> to convert <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span> and
+symbolic-shorthand module paths to filesystem paths. The
+<span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-file-path%29%29" class="RktValLink" data-pltdoc="x">collection-file-path</a></span> function, in turn, uses the
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-links%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-links</a></span>
+and <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-paths</a></span> parameters.</p><p><div class="SIntrapara">A <a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name resolver</span></a> takes two and four arguments:
+</div><div class="SIntrapara"><ul><li><p>When given two arguments, the first is a name for a module that
+is now declared in the current namespace, and the second is optionally
+a namespace from which the declaration was copied.
+The module name resolver&rsquo;s result in this case is ignored.</p><p>The current module name resolver is called with two arguments by
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-attach-module%29%29" class="RktValLink" data-pltdoc="x">namespace-attach-module</a></span> or
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-attach-module-declaration%29%29" class="RktValLink" data-pltdoc="x">namespace-attach-module-declaration</a></span> to notify the resolver
+that a module declaration was attached to the current namespace (and
+should not be loaded in the future for the namespace&rsquo;s <a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module registry</span></a>).
+Evaluation of a module declaration also calls the current module
+name resolver with two arguments, where the first is the declared
+module and the second is <span class="RktVal">#f</span>. No other Racket operation
+invokes the module name resolver with two arguments, but other tools
+(such as DrRacket) might call this resolver in this mode to avoid
+redundant module loads.</p></li><li><p>When given four arguments, the first is a module path,
+equivalent to a quoted <span class="RktVar">module-path</span> for <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>.
+The second is name for the source module, if
+any, to which the path is relative; if the second argument is
+<span class="RktVal">#f</span>, the module path is relative to <span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-load-relative-directory</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span><span class="RktPn">)</span><span class="RktPn">)</span>.  The third
+argument is a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> that can be used for error
+reporting, if it is not <span class="RktVal">#f</span>. If the last argument is
+<span class="RktVal">#t</span>, then the module declaration should be loaded (if it is
+not already), otherwise the module path should be simply resolved to
+a name. The result is the resolved name.</p></li></ul></div></p><p>For the second case, the standard module name resolver keeps a
+table per <a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module registry</span></a> containing loaded module name. If a resolved module path is
+not in the table, and <span class="RktVal">#f</span> is not provided as the fourth
+argument to the <a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name resolver</span></a>, then the name is put into
+the table and the corresponding file is loaded with a variant of
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%2Fuse-compiled%29%29" class="RktValLink" data-pltdoc="x">load/use-compiled</a></span> that passes the expected module name to the
+<a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a>.</p><p>While loading a file, the default <a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name resolver</span></a> sets the
+<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-declare-name%29%29" class="RktValLink" data-pltdoc="x">current-module-declare-name</a></span> parameter to the resolved module
+name (while the <a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a> sets
+<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-declare-source%29%29" class="RktValLink" data-pltdoc="x">current-module-declare-source</a></span>). Also, the default
+<a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name resolver</span></a> records in a private <a href="eval-model.html#%28tech._continuation._mark%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation
+mark</span></a> the module being loaded, and it checks whether such a mark
+already exists; if such a continuation mark does exist in the current
+continuation, then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span> exception is raised with a message about a
+dependency cycle.</p><p>The default module name resolver cooperates with the default
+<a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a>: on a module-attach notification,
+bytecode-file information recorded by the <a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a>
+for the source namespace&rsquo;s <a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module registry</span></a> is transferred to
+the target namespace&rsquo;s <a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module registry</span></a>.</p><p>The default module name resolver also maintains a small,
+<a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module registry</span></a>-specific cache that maps <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span> and symbolic
+module paths to their resolutions. This cache is consulted before
+checking parameters such as <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-links%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-links</a></span>
+and <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-paths</a></span>, so results may
+&ldquo;stick&rdquo; even if those parameter values change. An entry is added to
+the cache only when the fourth argument to the module name resolver is
+true (indicating that a module should be loaded) and only when loading
+succeeds.</p><p>Finally, the default module name resolver potentially treats a
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxLink" data-pltdoc="x">submod</a></span> path specially. If the module path as the first
+element of the <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxLink" data-pltdoc="x">submod</a></span> form refers to non-existent collection,
+then instead of raising an exception, the default module name resolver
+synthesizes an uninterned symbol module name for the resulting
+<a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module path</span></a>. This special treatment of submodule paths
+is consistent with the special treatment of nonexistent submodules by
+the <a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a>, so that <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-declared~3f%29%29" class="RktValLink" data-pltdoc="x">module-declared?</a></span>
+can be used more readily to check for the existence of a submodule.</p><p>Module loading is suppressed (i.e., <span class="RktVal">#f</span> is supplied as a fourth
+argument to the module name resolver) when resolving module paths in
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax objects</span></a> (see <a href="syntax-model.html#%28part._stxobj-model%29" data-pltdoc="x">Syntax Objects</a>). When a
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> is manipulated, the current namespace might not
+match the original namespace for the syntax object, and the module
+should not necessarily be loaded in the current namespace.</p><p>For historical reasons, the default module name resolver currently
+accepts three arguments, in addition to two and four. Three arguments
+are treated the same as four arguments with the fourth argument as
+<span class="RktVal">#t</span>, except that an error is also logged. Support for three
+arguments will be removed in a future version.</p><p>The <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-name-resolver%29%29" class="RktValLink" data-pltdoc="x">current-module-name-resolver</a></span> binding is provided as
+<a href="modprotect.html#%28tech._protected%29" class="techoutside" data-pltdoc="x"><span class="techinside">protected</span></a> in the sense of <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._protect-out%29%29" class="RktStxLink" data-pltdoc="x">protect-out</a></span>.</p><p class="SHistory">Changed in version 6.0.1.12 of package <span class="stt">base</span>: Added error logging to the default module name resolver
+when called with three arguments.<br/>Changed in version 7.0.0.17: Added special treatment of <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxLink" data-pltdoc="x">submod</a></span> forms with a
+nonexistent collection by the default module name
+resolver.<br/>Changed in version 8.2.0.4: Changed binding to protected.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-module-declare-name))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-declare-name%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-module-declare-name</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-declare-name%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-module-declare-name</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines a module name that is used when evaluating
+a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> declaration (when the parameter value is not
+<span class="RktVal">#f</span>). In that case, the <span class="RktVar">id</span> from the <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>
+declaration is ignored, and the parameter&rsquo;s value is used as the name
+of the declared module.</div></p><p>When declaring <a href="eval-model.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodules</span></a>, <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-declare-name%29%29" class="RktValLink" data-pltdoc="x">current-module-declare-name</a></span>
+determines the name used for the submodule&rsquo;s root module, while its
+submodule path relative to the root module is unaffected.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-module-declare-source))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-declare-source%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-module-declare-source</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-declare-source%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-module-declare-source</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">src</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines source information to be associated with a
+module when evaluating a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> declaration. Source
+information is used in error messages and reflected by
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3emodule-source%29%29" class="RktValLink" data-pltdoc="x">variable-reference-&gt;module-source</a></span>. When the parameter value
+is <span class="RktVal">#f</span>, the module&rsquo;s name (as determined by
+<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-declare-name%29%29" class="RktValLink" data-pltdoc="x">current-module-declare-name</a></span>) is used as the source name
+instead of the parameter value.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-module-path-for-load))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-path-for-load%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-module-path-for-load</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-path-for-load%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-module-path-for-load</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines a module path used for
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax~3amissing-module%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax:missing-module</a></span> and
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3amissing-module%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem:missing-module</a></span> exceptions as raised by the
+default <a href="eval.html#%28tech._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">load handler</span></a>.  The parameter is normally set by a
+<a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name resolver</span></a>.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;modpathidx&quot;">14.4.2<tt>&nbsp;</tt><a name="(part._modpathidx)"></a>Compiled Modules and References</h5><p>While expanding a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> declaration, the expander resolves
+module paths for imports to load module declarations as necessary and
+to determine imported bindings, but the compiled form of a
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> declaration preserves the original module path.
+Consequently, a compiled module can be moved to another filesystem,
+where the module name resolver can resolve inter-module references
+among compiled code.</p><p>When a module reference is extracted from compiled form (see
+<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-imports%29%29" class="RktValLink" data-pltdoc="x">module-compiled-imports</a></span>) or from syntax objects in macro
+expansion (see <a href="stxops.html" data-pltdoc="x">Syntax Object Content</a>), the module reference is reported in
+the form of a <a name="(tech._module._path._index)"></a><span style="font-style: italic">module path index</span>. A <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a>
+is a semi-interned (multiple references to the same relative module
+tend to use the same <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a> value, but not always)
+opaque value that encodes a module path (see <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span>)
+and either a <a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module path</span></a> or another <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path
+index</span></a> to which it is relative.</p><p>A <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a> that uses both <span class="RktVal">#f</span> for its path and
+base <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a> represents &ldquo;self&rdquo;&#8212;<wbr></wbr>i.e., the module
+declaration that was the source of the <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a>&#8212;<wbr></wbr>and
+such a <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a> can be used as the root for a chain of
+<a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a>es at compile time. For example, when
+extracting information about an identifier&rsquo;s binding within a module,
+if the identifier is bound by a definition within the same module, the
+identifier&rsquo;s source module is reported using the &ldquo;self&rdquo; <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module
+path index</span></a>. If the identifier is instead defined in a module that is
+imported via a module path (as opposed to a literal module name), then
+the identifier&rsquo;s source module will be reported using a <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module
+path index</span></a> that contains the <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>d module path and the
+&ldquo;self&rdquo; <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a>. A &ldquo;self&rdquo; <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a>
+has a submodule path when the module that it refers to is a
+<a href="eval-model.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodule</span></a>.</p><p>A <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a> has state. When it is <a name="(tech._resolved)"></a><span style="font-style: italic">resolved</span> to
+a <a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module path</span></a>, then the <a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module path</span></a> is
+stored with the <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a>. In particular, when a module
+is loaded, its root <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a> is resolved to match the
+module&rsquo;s declaration-time name. This resolved path is forgotten,
+however, in identifiers that the module contributes to the compiled
+and marshaled form of other modules. The transient nature of resolved
+names allows the module code to be loaded with a different resolved
+name than the name when it was compiled.</p><p>Two <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a> values are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> when they have
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> path and base values (even if they have different
+<a href="Module_Names_and_Loading.html#%28tech._resolved%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved</span></a> values).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-path-index~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-path-index?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a>,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-path-index-resolve))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index-resolve%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-path-index-resolve</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">mpi</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">load?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">src-stx</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mpi</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">load?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module path</span></a> for the resolved module name,
+computing the resolved name (and storing it in <span class="RktVar">mpi</span>) if it has
+not been computed before.</div></p><p>Resolving a <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a> uses the current <a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module
+name resolver</span></a> (see <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-name-resolver%29%29" class="RktValLink" data-pltdoc="x">current-module-name-resolver</a></span>). Depending
+on the kind of module paths encapsulated by <span class="RktVar">mpi</span>, the computed
+resolved name can depend on the value of
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-load-relative-directory</a></span> or
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span>. The <span class="RktVar">load?</span> argument is propagated as
+the last argument to the <a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name resolver</span></a>, while the
+<span class="RktVar">src-stx</span> argument is propagated as the next-to-last argument.</p><p>Beware that concurrent resolution in namespaces that share a module
+registry can create race conditions when loading modules. See also
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-call-with-registry-lock%29%29" class="RktValLink" data-pltdoc="x">namespace-call-with-registry-lock</a></span>.</p><p>See also <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=module-helpers.html%23%2528def._%2528%2528lib._syntax%252Fmodresolve..rkt%2529._resolve-module-path-index%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">resolve-module-path-index</a></span>.</p><p class="SHistory">Changed in version 6.90.0.16 of package <span class="stt">base</span>: Added the <span class="RktVar">load?</span> optional argument.<br/>Changed in version 8.2: Added the <span class="RktVar">src-stx</span> optional argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-path-index-split))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index-split%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-path-index-split</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">mpi</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mpi</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns two values: a module path, and a base path&#8212;<wbr></wbr>either a
+<a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a>, <a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module path</span></a>, or
+<span class="RktVal">#f</span>&#8212;<wbr></wbr>to which the first path is relative.</div></p><p>A <span class="RktVal">#f</span> second result means that the path is relative to an
+unspecified directory (i.e., its resolution depends on the value of
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-load-relative-directory</a></span> and/or
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span>).</p><p>A <span class="RktVal">#f</span> for the first result implies a <span class="RktVal">#f</span> for the
+second result, and means that <span class="RktVar">mpi</span> represents &ldquo;self&rdquo; (see
+above). Such a <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a> may have a non-<span class="RktVal">#f</span>
+submodule path as reported by <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index-submodule%29%29" class="RktValLink" data-pltdoc="x">module-path-index-submodule</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-path-index-submodule))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index-submodule%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-path-index-submodule</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">mpi</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._non-empty-listof%29%29" class="RktValLink" data-pltdoc="x">non-empty-listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mpi</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a non-empty list of symbols if <span class="RktVar">mpi</span> is a &ldquo;self&rdquo; (see
+above) <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a> that refers to a <a href="eval-model.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodule</span></a>. The
+result is always <span class="RktVal">#f</span> if either result of
+<span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index-split%29%29" class="RktValLink" data-pltdoc="x">module-path-index-split</a></span><span class="stt"> </span><span class="RktVar">mpi</span><span class="RktPn">)</span> is non-<span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-path-index-join))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index-join%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-path-index-join</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktVar">base</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">submod</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">base</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">submod</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._non-empty-listof%29%29" class="RktValLink" data-pltdoc="x">non-empty-listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Combines <span class="RktVar">path</span>, <span class="RktVar">base</span>, and <span class="RktVar">submod</span> to create a
+new <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a>. The <span class="RktVar">path</span> argument can be
+<span class="RktVal">#f</span> only if <span class="RktVar">base</span> is also <span class="RktVal">#f</span>. The
+<span class="RktVar">submod</span> argument can be a list only when <span class="RktVar">path</span> and
+<span class="RktVar">base</span> are both <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._compiled-module-expression~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._compiled-module-expression~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">compiled-module-expression?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a compiled <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>
+declaration, <span class="RktVal">#f</span> otherwise. See also
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile%29%29" class="RktValLink" data-pltdoc="x">current-compile</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-compiled-name))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-name%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-compiled-name</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">compiled-module-code</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._non-empty-listof%29%29" class="RktValLink" data-pltdoc="x">non-empty-listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">compiled-module-code</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._compiled-module-expression~3f%29%29" class="RktValLink" data-pltdoc="x">compiled-module-expression?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-name%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-compiled-name</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">compiled-module-code</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._compiled-module-expression~3f%29%29" class="RktValLink" data-pltdoc="x">compiled-module-expression?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">compiled-module-code</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._compiled-module-expression~3f%29%29" class="RktValLink" data-pltdoc="x">compiled-module-expression?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._non-empty-listof%29%29" class="RktValLink" data-pltdoc="x">non-empty-listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Takes a module declaration in compiled form and either gets the
+module&rsquo;s declared name (when <span class="RktVar">name</span> is not provided) or returns
+a revised module declaration with the given <span class="RktVar">name</span>.</div></p><p>The name is a symbol for a top-level module, or a symbol paired with a list of symbols
+where the list reflects the <a href="eval-model.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodule</span></a> path to
+the module starting with the top-level module&rsquo;s declared name.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-compiled-submodules))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-submodules%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-compiled-submodules</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">compiled-module-code</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">non-star?</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._compiled-module-expression~3f%29%29" class="RktValLink" data-pltdoc="x">compiled-module-expression?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">compiled-module-code</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._compiled-module-expression~3f%29%29" class="RktValLink" data-pltdoc="x">compiled-module-expression?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">non-star?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-submodules%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-compiled-submodules</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">compiled-module-code</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">non-star?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">submodules</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._compiled-module-expression~3f%29%29" class="RktValLink" data-pltdoc="x">compiled-module-expression?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">compiled-module-code</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._compiled-module-expression~3f%29%29" class="RktValLink" data-pltdoc="x">compiled-module-expression?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">non-star?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">submodules</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._compiled-module-expression~3f%29%29" class="RktValLink" data-pltdoc="x">compiled-module-expression?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Takes a module declaration in compiled form and either gets the
+module&rsquo;s <a href="eval-model.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodules</span></a> (when <span class="RktVar">submodules</span> is not provided) or
+returns a revised module declaration with the given
+<span class="RktVar">submodules</span>. The <span class="RktVar">non-star?</span> argument determines
+whether the result or new submodule list corresponds to
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> declarations (when <span class="RktVar">non-star?</span> is true)
+or <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> declarations (when <span class="RktVar">non-star?</span> is <span class="RktVal">#f</span>).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-compiled-imports))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-imports%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-compiled-imports</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">compiled-module-code</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">compiled-module-code</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._compiled-module-expression~3f%29%29" class="RktValLink" data-pltdoc="x">compiled-module-expression?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Takes a module declaration in compiled form and returns an association
+list mapping <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> shifts (where <span class="RktVal">#f</span> corresponds
+to a shift into the <a href="syntax-model.html#%28tech._label._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">label phase level</span></a>) to module references for
+the module&rsquo;s explicit imports.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-compiled-exports))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-exports%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-compiled-exports</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">compiled-module-code</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">verbosity</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">compiled-module-code</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._compiled-module-expression~3f%29%29" class="RktValLink" data-pltdoc="x">compiled-module-expression?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">verbosity</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">defined-names</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns two association lists mapping from a combination of <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>
+and <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a> to exports at
+the corresponding phase and space. The first association list is for exported
+variables, and the second is for exported syntax. Beware however, that
+value bindings re-exported though a <a href="syntax-model.html#%28tech._rename._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">rename transformer</span></a> are in
+the syntax list instead of the value list. See <span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span>
+for information on the phase-and-space representation.</div></p><p>Each associated list, which is represented by <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span> in the
+result contracts above, more precisely matches the contract</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">only if <span class="RktVar">verbosity</span> is <span class="RktVal">'</span><span class="RktVal">defined-names</span>:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>For each element of the list, the leading symbol is the name of the
+export.</p><p>The second part&#8212;<wbr></wbr>the list of <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a> values,
+etc.&#8212;<wbr></wbr>describes the origin of the exported identifier. If the origin
+list is <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span>, then the exported identifier is defined in the
+module. If the exported identifier is re-exported, instead, then the
+origin list provides information on the import that was re-exported.
+The origin list has more than one element if the binding was imported
+multiple times from (possibly) different sources.</p><p>The last part, a symbol, is included only if <span class="RktVar">verbosity</span> is
+<span class="RktVal">'</span><span class="RktVal">defined-names</span>. In that case, the included symbol is the name
+of the definition within its defining module (which may be different
+than the name that is exported).</p><p>For each origin, a <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a> by itself means that the
+binding was imported with a <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> shift of <span class="RktVal">0</span>
+(i.e., a plain <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> without <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-meta%29%29" class="RktStxLink" data-pltdoc="x">for-meta</a></span>,
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span>, etc.) into the default <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a> (i.e.,
+without <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-space%29%29" class="RktStxLink" data-pltdoc="x">for-space</a></span>), and the imported identifier has the same name
+as the re-exported name. An origin represented with a list indicates
+explicitly the import, the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> plus <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a>
+where the imported identifier is bound (see <span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span> for more
+information on the representation), the symbolic name of the import
+as bound in the importing module, and the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> plus
+<a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a> of the identifier from the exporting module.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-exports%29%29" class="RktValLink" data-pltdoc="x">module-compiled-exports</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile%29%29" class="RktValLink" data-pltdoc="x">compile</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">module</span><span class="hspace">&nbsp;</span><span class="RktVal">banana</span><span class="hspace">&nbsp;</span><span class="RktVal">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">(</span><span class="RktVal">require</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">only-in</span><span class="hspace">&nbsp;</span><span class="RktVal">racket/math</span><span class="hspace">&nbsp;</span><span class="RktVal">pi</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">(</span><span class="RktVal">for-syntax</span><span class="hspace">&nbsp;</span><span class="RktVal">racket/base</span><span class="RktVal">)</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">(</span><span class="RktVal">provide</span><span class="hspace">&nbsp;</span><span class="RktVal">pi</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">(</span><span class="RktVal">rename-out</span><span class="hspace">&nbsp;</span><span class="RktVal">[</span><span class="RktVal">peel</span><span class="hspace">&nbsp;</span><span class="RktVal">wrapper</span><span class="RktVal">]</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">bush</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">cond</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">(</span><span class="RktVal">for-syntax</span><span class="hspace">&nbsp;</span><span class="RktVal">compile-time</span><span class="RktVal">)</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">(</span><span class="RktVal">define</span><span class="hspace">&nbsp;</span><span class="RktVal">peel</span><span class="hspace">&nbsp;</span><span class="RktVal">pi</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">(</span><span class="RktVal">define</span><span class="hspace">&nbsp;</span><span class="RktVal">bush</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">*</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">pi</span><span class="RktVal">)</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">(</span><span class="RktVal">begin-for-syntax</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">(</span><span class="RktVal">define</span><span class="hspace">&nbsp;</span><span class="RktVal">compile-time</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">current-seconds</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">defined-names</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">'((0</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;</span><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(bush () bush)</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;</span><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(pi (#&lt;module-path-index:racket/math&gt;) pi)</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;</span><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(wrapper () peel))</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(1 (compile-time () compile-time)))</span></p></td></tr><tr><td><p><span class="RktRes">'((0 (cond (#&lt;module-path-index:racket/base&gt;) cond)))</span></p></td></tr></table></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.5.0.6 of package <span class="stt">base</span>: Added the <span class="RktVar">verbosity</span> argument.<br/>Changed in version 8.2.0.3: Generalized results to phase&ndash;space combinations.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-compiled-indirect-exports))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-indirect-exports%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-compiled-indirect-exports</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">compiled-module-code</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">compiled-module-code</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._compiled-module-expression~3f%29%29" class="RktValLink" data-pltdoc="x">compiled-module-expression?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an association list mapping <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> values to
+symbols that represent variables within the module. These definitions
+are not directly accessible from source, but they are accessible from
+bytecode, and the order of the symbols in each list corresponds to an
+order for bytecode access.</div></p><p class="SHistory">Added in version 6.5.0.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-compiled-language-info))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-language-info%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-compiled-language-info</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">compiled-module-code</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector%2Fc%29%29" class="RktValLink" data-pltdoc="x">vector/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">compiled-module-code</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._compiled-module-expression~3f%29%29" class="RktValLink" data-pltdoc="x">compiled-module-expression?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span>See also <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=module-runtime-config.html&amp;version=8.6" class="Sq" data-pltdoc="x">Module-Handling Configuration</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a>.</p></blockquote></blockquote></blockquote></div></p><p>Returns information intended to reflect the &ldquo;language&rdquo; of the
+module&rsquo;s implementation as originally attached to the syntax of the
+module&rsquo;s declaration though the <a name="(idx._(gentag._279._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">module-language</span>
+<a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax property</span></a>. See also <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>.</p><p>If no information is available for the module, the result is
+<span class="RktVal">#f</span>. Otherwise, the result is <span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="stt"> </span><span class="RktVar">mp</span><span class="stt"> </span><span class="RktVar">name</span><span class="stt"> </span><span class="RktVar">val</span><span class="RktPn">)</span>
+such that <span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span><span class="stt"> </span><span class="RktVar">mp</span><span class="stt"> </span><span class="RktVar">name</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">val</span><span class="RktPn">)</span> should return
+function that takes two arguments. The function&rsquo;s arguments are a key
+for reflected information and a default value.  Acceptable keys and
+the interpretation of results is up to external tools, such as
+DrRacket.  If no information is available for a given key, the result
+should be the given default value.</p><p>See also <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3elanguage-info%29%29" class="RktValLink" data-pltdoc="x">module-&gt;language-info</a></span> and
+<a href="running-sa.html#%28mod-path._racket%2Flanguage-info%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/language-info</span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-compiled-cross-phase-persistent~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-cross-phase-persistent~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-compiled-cross-phase-persistent?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">compiled-module-code</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">compiled-module-code</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._compiled-module-expression~3f%29%29" class="RktValLink" data-pltdoc="x">compiled-module-expression?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">compiled-module-code</span> represents a
+<a href="eval-model.html#%28tech._cross._phase._persistent%29" class="techoutside" data-pltdoc="x"><span class="techinside">cross-phase persistent</span></a> module, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-compiled-realm))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-realm%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-compiled-realm</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">compiled-module-code</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">compiled-module-code</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._compiled-module-expression~3f%29%29" class="RktValLink" data-pltdoc="x">compiled-module-expression?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <a href="exns.html#%28tech._realm%29" class="techoutside" data-pltdoc="x"><span class="techinside">realm</span></a> of the module represented by
+<span class="RktVar">compiled-module-code</span>.</div></p><p class="SHistory">Added in version 8.4.0.2 of package <span class="stt">base</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;dynreq&quot;">14.4.3<tt>&nbsp;</tt><a name="(part._dynreq)"></a>Dynamic Module Access</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._dynamic-require))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValDef RktValLink" data-pltdoc="x">dynamic-require</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">mod</span><span class="hspace">&nbsp;</span><span class="RktVar">provided</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">fail-thunk</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">mod</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">provided</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fail-thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Because <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span> is a procedure, giving a plain S-expression for
+<span class="RktVar">mod</span> the same way as you would for a <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> expression likely won&rsquo;t give you
+expected results. What you need instead is something that evaluates to an S-expression; using
+<span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span> is one way to do it.</p></blockquote></blockquote></blockquote></div></p><p>Dynamically <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiates</span></a> the module specified by <span class="RktVar">mod</span>
+in the current namespace&rsquo;s registry at the namespace&rsquo;s <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base
+phase</span></a>, if it is not yet <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d. The current <a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module
+name resolver</span></a> may load a module declaration to resolve <span class="RktVar">mod</span>
+(see <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-name-resolver%29%29" class="RktValLink" data-pltdoc="x">current-module-name-resolver</a></span>); the path is resolved
+relative to <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-load-relative-directory</a></span> and/or
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span>. Beware that concurrent <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span>s
+in namespaces that share a <a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module registry</span></a> can create race
+conditions; see also <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-call-with-registry-lock%29%29" class="RktValLink" data-pltdoc="x">namespace-call-with-registry-lock</a></span>.</p><p>If <span class="RktVar">provided</span> is <span class="RktVal">#f</span>, then the result is <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>,
+and the module is not <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see <a href="syntax-model.html#%28part._mod-parse%29" data-pltdoc="x">Module Expansion, Phases, and Visits</a>) or
+even made <a href="eval-model.html#%28tech._available%29" class="techoutside" data-pltdoc="x"><span class="techinside">available</span></a> (for on-demand <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visits</span></a>) in phases
+above the <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">hello</span></p></td></tr></table></blockquote></div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The double quoted <span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">a</span> evaluates to the <span class="RktVar">root-module-path</span> <span class="RktVal">'</span><span class="RktVal">a</span>
+(see the grammar for <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>). Using <span class="RktVal">'</span><span class="RktVal">a</span> for <span class="RktVar">mod</span> won&rsquo;t work,
+because that evaluates to <span class="RktVar">root-module-path</span> <span class="RktSym">a</span>, and the example is
+not a module installed in a collection. Using <span class="RktSym">a</span> won&rsquo;t work, because <span class="RktSym">a</span>
+is an undefined variable.</p><p>Declaring <span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="stt"> </span><span class="RktSym">a</span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span> within another module, instead of in
+the <span class="RktSym">read-eval-print</span> loop, would create a submodule. In that case,
+<span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="stt"> </span><span class="RktVal">#f</span><span class="RktPn">)</span> would not access the module, because <span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">a</span>
+does not refer to a submodule.</p></blockquote></blockquote></blockquote><p>When <span class="RktVar">provided</span> is a symbol, the value of the module&rsquo;s export
+with the given name is returned, and still the module is not
+<a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed or made <a href="eval-model.html#%28tech._available%29" class="techoutside" data-pltdoc="x"><span class="techinside">available</span></a> in higher phases.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dessert</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dessert</span><span class="hspace">&nbsp;</span><span class="RktVal">"gulab jamun"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dessert</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"gulab jamun"</span></p></td></tr></table></blockquote></div></p><p>If the module exports <span class="RktVar">provided</span> as syntax, then a use of the binding
+is expanded and evaluated in a fresh namespace to which the module is
+attached, which means that the module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed in the fresh
+namespace. The expanded syntax must return a single value.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dessert2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dessert</span><span class="hspace">&nbsp;</span><span class="RktVal">"nanaimo bar"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dessert2</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">dessert</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dessert2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"nanaimo bar"</span></p></td></tr></table></blockquote></div></p><p>If the module has no such exported variable or syntax, then
+<span class="RktVar">fail-thunk</span> is called; the default <span class="RktVar">fail-thunk</span> raises
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span>. If the variable named by <span class="RktVar">provided</span>
+is exported protected (see <a href="modprotect.html" data-pltdoc="x">Code Inspectors</a>), then the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>If <span class="RktVar">provided</span> is <span class="RktVal">0</span>, then the module is
+<a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d but not <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed, the same as when
+<span class="RktVar">provided</span> is <span class="RktVal">#f</span>. With <span class="RktVal">0</span>, however, the module
+is made <a href="eval-model.html#%28tech._available%29" class="techoutside" data-pltdoc="x"><span class="techinside">available</span></a> in higher phases.</p><p>If <span class="RktVar">provided</span> is <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>, then the module is
+<a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed but not <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d (see <a href="syntax-model.html#%28part._mod-parse%29" data-pltdoc="x">Module Expansion, Phases, and Visits</a>),
+and the result is <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</p><p>More examples using different <span class="RktSym">module-path</span> grammar expressions are given below:</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racket/base</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">lib</span><span class="hspace">&nbsp;</span><span class="RktVal">"racket/base"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">inner-dessert</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">inner-dessert</span><span class="hspace">&nbsp;</span><span class="RktVal">"tiramisu"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">submod</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">inner-dessert</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"tiramisu"</span></p></td></tr></table></blockquote></div></p><p>The last line in the above example could instead have been written as</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">submod</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">inner-dessert</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"tiramisu"</span></p></td></tr></table></blockquote></div></p><p>which is equivalent.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._dynamic-require-for-syntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require-for-syntax%29%29" class="RktValDef RktValLink" data-pltdoc="x">dynamic-require-for-syntax</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">mod</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">provided</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">fail-thunk</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mod</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">provided</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fail-thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span>, but in a <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> that is <span style="font-style: italic"></span>1<span style="font-style: italic"></span>
+more than the namespace&rsquo;s <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-declared~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-declared~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-declared?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">mod</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">load?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">mod</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">load?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if the module indicated by <span class="RktVar">mod</span> is
+declared (but not necessarily <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d or <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed)
+in the current namespace, <span class="RktVal">#f</span> otherwise.</div></p><p>If <span class="RktVar">load?</span> is <span class="RktVal">#t</span> and <span class="RktVar">mod</span> is not a
+<a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module path</span></a>, the module is loaded in the process of
+resolving <span class="RktVar">mod</span> (as for <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span> and other
+functions). Checking for the declaration of a <a href="eval-model.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodule</span></a> does
+not trigger an exception if the submodule cannot be loaded because
+it does not exist, either within a root module that does exist or
+because the root module does not exist.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-~3elanguage-info))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3elanguage-info%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-&gt;language-info</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">mod</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">load?</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector%2Fc%29%29" class="RktValLink" data-pltdoc="x">vector/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">mod</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">load?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns information intended to reflect the &ldquo;language&rdquo; of the
+implementation of <span class="RktVar">mod</span>. If <span class="RktVar">mod</span> is a
+<a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module path</span></a> or <span class="RktVar">load?</span> is <span class="RktVal">#f</span>, the
+module named by <span class="RktVar">mod</span> must be <a href="eval-model.html#%28tech._declare%29" class="techoutside" data-pltdoc="x"><span class="techinside">declare</span></a>d (but not necessarily
+<a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d or <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed) in the current namespace;
+otherwise, <span class="RktVar">mod</span> may be loaded (as for <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span>
+and other functions). The information returned by
+<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3elanguage-info%29%29" class="RktValLink" data-pltdoc="x">module-&gt;language-info</a></span> is the same as would have been returned
+by <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-language-info%29%29" class="RktValLink" data-pltdoc="x">module-compiled-language-info</a></span> applied to the module&rsquo;s
+implementation as compiled code.</div></p><p>A module can be <a href="eval-model.html#%28tech._declare%29" class="techoutside" data-pltdoc="x"><span class="techinside">declare</span></a>d by using <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racket/dict</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3elanguage-info%29%29" class="RktValLink" data-pltdoc="x">module-&gt;language-info</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racket/dict</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-~3eimports))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3eimports%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-&gt;imports</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">mod</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">mod</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-imports%29%29" class="RktValLink" data-pltdoc="x">module-compiled-imports</a></span>, but produces the
+ imports of <span class="RktVar">mod</span>, which must be <a href="eval-model.html#%28tech._declare%29" class="techoutside" data-pltdoc="x"><span class="techinside">declare</span></a>d (but
+ not necessarily <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d or <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed) in
+ the current namespace. See <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3elanguage-info%29%29" class="RktValLink" data-pltdoc="x">module-&gt;language-info</a></span> for
+ an example of declaring an existing module.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">banana</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-in%29%29" class="RktStxLink" data-pltdoc="x">only-in</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/math</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">peel</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">peel</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bush</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3eimports%29%29" class="RktValLink" data-pltdoc="x">module-&gt;imports</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">banana</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((0 #&lt;module-path-index:racket/base&gt; #&lt;module-path-index:racket/math&gt;))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-~3eexports))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3eexports%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-&gt;exports</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">mod</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">verbosity</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">mod</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">verbosity</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">defined-names</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-exports%29%29" class="RktValLink" data-pltdoc="x">module-compiled-exports</a></span>, but produces the
+ exports of <span class="RktVar">mod</span>, which must be <a href="eval-model.html#%28tech._declare%29" class="techoutside" data-pltdoc="x"><span class="techinside">declare</span></a>d (but
+ not necessarily <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d or <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed) in
+ the current namespace. See <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3elanguage-info%29%29" class="RktValLink" data-pltdoc="x">module-&gt;language-info</a></span> for
+ an example of declaring an existing module.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">banana</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-in%29%29" class="RktStxLink" data-pltdoc="x">only-in</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/math</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._rename-out%29%29" class="RktStxLink" data-pltdoc="x">rename-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">peel</span><span class="hspace">&nbsp;</span><span class="RktSym">wrapper</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">peel</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bush</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3eexports%29%29" class="RktValLink" data-pltdoc="x">module-&gt;exports</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">banana</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">'((0 (wrapper ())))</span></p></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr></table></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.5.0.6 of package <span class="stt">base</span>: Added the <span class="RktVar">verbosity</span> argument.<br/>Changed in version 8.2.0.3: Generalized results to phase&ndash;space combinations.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-~3eindirect-exports))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3eindirect-exports%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-&gt;indirect-exports</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">mod</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">mod</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-indirect-exports%29%29" class="RktValLink" data-pltdoc="x">module-compiled-indirect-exports</a></span>, but produces the
+ exports of <span class="RktVar">mod</span>, which must be <a href="eval-model.html#%28tech._declare%29" class="techoutside" data-pltdoc="x"><span class="techinside">declare</span></a>d (but
+ not necessarily <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d or <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed) in
+ the current namespace. See <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3elanguage-info%29%29" class="RktValLink" data-pltdoc="x">module-&gt;language-info</a></span> for
+ an example of declaring an existing module.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">banana</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-in%29%29" class="RktStxLink" data-pltdoc="x">only-in</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/math</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">peel</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">peel</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bush</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3eindirect-exports%29%29" class="RktValLink" data-pltdoc="x">module-&gt;indirect-exports</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">banana</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((0 bush))</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.5.0.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-~3erealm))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3erealm%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-&gt;realm</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">mod</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">mod</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-realm%29%29" class="RktValLink" data-pltdoc="x">module-compiled-realm</a></span>, but produces the
+ exports of <span class="RktVar">mod</span>, which must be <a href="eval-model.html#%28tech._declare%29" class="techoutside" data-pltdoc="x"><span class="techinside">declare</span></a>d (but
+ not necessarily <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d or <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed) in
+ the current namespace.</div></p><p class="SHistory">Added in version 8.4.0.2 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-predefined~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-predefined~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-predefined?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">mod</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">mod</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Reports whether <span class="RktVar">mod</span> refers to a module that is predefined for
+the running Racket instance. Predefined modules always have a symbolic
+resolved module path, and they may be predefined always or
+specifically within a particular executable (such as one created by
+<span class="stt">raco exe</span> or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=exe.html%23%2528def._%2528%2528lib._compiler%252Fembed..rkt%2529._create-embedding-executable%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">create-embedding-executable</a></span>).</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;modcache&quot;">14.4.4<tt>&nbsp;</tt><a name="(part._modcache)"></a>Module Cache</h5><p>The expander keeps a place-local module cache in order to save time
+while loading modules that have been previously declared.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-cache-clear!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-cache-clear%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-cache-clear!</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Clears the place-local module cache.</div></p><p class="SHistory">Added in version 8.4.0.5 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="load-lang.html" title="backward to &quot;14.3 The racket/load Language&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="chaperones.html" title="forward to &quot;14.5 Impersonators and Chaperones&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/More_Path_Utilities.html b/clones/docs.racket-lang.org/reference/More_Path_Utilities.html
new file mode 100644
index 00000000..615f07f9
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/More_Path_Utilities.html
@@ -0,0 +1,65 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15.1.2&nbsp;More Path Utilities</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewselflink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewselflink" data-pltdoc="x">Paths</a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="Filesystem.html" class="tocviewlink" data-pltdoc="x">Filesystem</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="networking.html" class="tocviewlink" data-pltdoc="x">Networking</a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="subprocess.html" class="tocviewlink" data-pltdoc="x">Processes</a></td></tr><tr><td align="right">15.5&nbsp;</td><td><a href="logging.html" class="tocviewlink" data-pltdoc="x">Logging</a></td></tr><tr><td align="right">15.6&nbsp;</td><td><a href="time.html" class="tocviewlink" data-pltdoc="x">Time</a></td></tr><tr><td align="right">15.7&nbsp;</td><td><a href="envvars.html" class="tocviewlink" data-pltdoc="x">Environment Variables</a></td></tr><tr><td align="right">15.8&nbsp;</td><td><a href="runtime.html" class="tocviewlink" data-pltdoc="x">Environment and Runtime Information</a></td></tr><tr><td align="right">15.9&nbsp;</td><td><a href="Command-Line_Parsing.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Parsing</a></td></tr><tr><td align="right">15.10&nbsp;</td><td><a href="os-lib.html" class="tocviewlink" data-pltdoc="x">Additional Operating System Functions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewlink" data-pltdoc="x">Paths</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1.1&nbsp;</td><td><a href="Manipulating_Paths.html" class="tocviewlink" data-pltdoc="x">Manipulating Paths</a></td></tr><tr><td align="right">15.1.2&nbsp;</td><td><a href="More_Path_Utilities.html" class="tocviewselflink" data-pltdoc="x">More Path Utilities</a></td></tr><tr><td align="right">15.1.3&nbsp;</td><td><a href="unixpaths.html" class="tocviewlink" data-pltdoc="x">Unix and Mac OS Paths</a></td></tr><tr><td align="right">15.1.4&nbsp;</td><td><a href="windowspaths.html" class="tocviewlink" data-pltdoc="x">Windows Paths</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._file-name-from-path%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-<wbr></wbr>name-<wbr></wbr>from-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-get-extension%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-<wbr></wbr>get-<wbr></wbr>extension</span></span></a></td></tr><tr><td><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-has-extension~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-<wbr></wbr>has-<wbr></wbr>extension?</span></span></a></td></tr><tr><td><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._filename-extension%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">filename-<wbr></wbr>extension</span></span></a></td></tr><tr><td><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._find-relative-path%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">find-<wbr></wbr>relative-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._normalize-path%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">normalize-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-element~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-<wbr></wbr>element?</span></span></a></td></tr><tr><td><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-only%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-<wbr></wbr>only</span></span></a></td></tr><tr><td><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._simple-form-path%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">simple-<wbr></wbr>form-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._some-system-path-~3estring%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">some-<wbr></wbr>system-<wbr></wbr>path-<wbr></wbr>&gt;string</span></span></a></td></tr><tr><td><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._string-~3esome-system-path%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>&gt;some-<wbr></wbr>system-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._shrink-path-wrt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">shrink-<wbr></wbr>path-<wbr></wbr>wrt</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Manipulating_Paths.html" title="backward to &quot;15.1.1 Manipulating Paths&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="pathutils.html" title="up to &quot;15.1 Paths&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="unixpaths.html" title="forward to &quot;15.1.3 Unix and Mac OS Paths&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;More_Path_Utilities&quot;">15.1.2<tt>&nbsp;</tt><a name="(part._.More_.Path_.Utilities)"></a><a name="(mod-path._racket/path)"></a>More Path Utilities</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="More_Path_Utilities.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/path</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="More_Path_Utilities.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/path</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/path..rkt)._file-name-from-path))"></a><span title="Provided from: racket/path, racket | Package: base"><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._file-name-from-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-name-from-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the last element of <span class="RktVar">path</span>. If <span class="RktVar">path</span> is
+syntactically a directory path (see <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._split-path%29%29" class="RktValLink" data-pltdoc="x">split-path</a></span>), then the
+result is <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/path..rkt)._path-get-extension))"></a><span title="Provided from: racket/path, racket | Package: base"><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-get-extension%29%29" class="RktValDef RktValLink" data-pltdoc="x">path-get-extension</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a byte string that is the extension part of the filename in
+<span class="RktVar">path</span>, including the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> separator. If the path has no
+extension, <span class="RktVal">#f</span> is returned.</div></p><p>See <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-replace-extension%29%29" class="RktValLink" data-pltdoc="x">path-replace-extension</a></span> for the definition of a filename
+extension.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-get-extension%29%29" class="RktValLink" data-pltdoc="x">path-get-extension</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x/y.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#".rkt"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-get-extension%29%29" class="RktValLink" data-pltdoc="x">path-get-extension</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x/y"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-get-extension%29%29" class="RktValLink" data-pltdoc="x">path-get-extension</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x/y.tar.gz"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#".gz"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-get-extension%29%29" class="RktValLink" data-pltdoc="x">path-get-extension</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x/.racketrc"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.5.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/path..rkt)._path-has-extension~3f))"></a><span title="Provided from: racket/path, racket | Package: base"><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-has-extension~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">path-has-extension?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktVar">ext</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ext</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Determines whether the last element of <span class="RktVar">path</span> ends with
+<span class="RktVar">ext</span> but is not exactly the same as <span class="RktVar">ext</span>.</div></p><p>If <span class="RktVar">ext</span> is a <a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte string</span></a> with the shape of an extension
+(i.e., starting with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> and not including another <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>), this check is equivalent to
+checking whether <span class="RktPn">(</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-get-extension%29%29" class="RktValLink" data-pltdoc="x">path-get-extension</a></span><span class="stt"> </span><span class="RktVar">path</span><span class="RktPn">)</span> produces <span class="RktVar">ext</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-has-extension~3f%29%29" class="RktValLink" data-pltdoc="x">path-has-extension?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x/y.rkt"</span><span class="hspace">&nbsp;</span><span class="RktVal">#".rkt"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-has-extension~3f%29%29" class="RktValLink" data-pltdoc="x">path-has-extension?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x/y.ss"</span><span class="hspace">&nbsp;</span><span class="RktVal">#".rkt"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-has-extension~3f%29%29" class="RktValLink" data-pltdoc="x">path-has-extension?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x/y"</span><span class="hspace">&nbsp;</span><span class="RktVal">#".rkt"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-has-extension~3f%29%29" class="RktValLink" data-pltdoc="x">path-has-extension?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x/.racketrc"</span><span class="hspace">&nbsp;</span><span class="RktVal">#".racketrc"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-has-extension~3f%29%29" class="RktValLink" data-pltdoc="x">path-has-extension?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x/compiled/y_rkt.zo"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"_rkt.zo"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.5.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/path..rkt)._filename-extension))"></a><span title="Provided from: racket/path, racket | Package: base"><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._filename-extension%29%29" class="RktValDef RktValLink" data-pltdoc="x">filename-extension</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote><p><span style="background-color: yellow"><span style="font-weight: bold">NOTE:</span></span> This function is deprecated; use <span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-get-extension%29%29" class="RktValLink" data-pltdoc="x">path-get-extension</a></span>, instead. </p></blockquote></div></p><p>Returns a byte string that is the extension part of the filename in
+<span class="RktVar">path</span> without the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> separator. If <span class="RktVar">path</span> is
+syntactically a directory (see <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._split-path%29%29" class="RktValLink" data-pltdoc="x">split-path</a></span>) or if the path has
+no extension, <span class="RktVal">#f</span> is returned.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/path..rkt)._find-relative-path))"></a><span title="Provided from: racket/path, racket | Package: base"><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._find-relative-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">find-relative-path</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">base</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:more-than-root?</span><span class="hspace">&nbsp;</span><span class="RktVar">more-than-root?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:more-than-same?</span><span class="hspace">&nbsp;</span><span class="RktVar">more-than-same?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:normalize-case?</span><span class="hspace">&nbsp;</span><span class="RktVar">normalize-case?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">base</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">more-than-root?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">more-than-same?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">normalize-case?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Finds a relative pathname with respect to <span class="RktVar">base</span> that names the
+same file or directory as <span class="RktVar">path</span>. Both <span class="RktVar">base</span> and
+<span class="RktVar">path</span> must be simplified in the sense of
+<span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._simple-form-path%29%29" class="RktValLink" data-pltdoc="x">simple-form-path</a></span>. If <span class="RktVar">path</span> shares no subpath in
+common with <span class="RktVar">base</span>, <span class="RktVar">path</span> is returned.</div></p><p>If <span class="RktVar">more-than-root?</span> is true, if <span class="RktVar">base</span> and
+<span class="RktVar">path</span> share only a Unix root in common, and if neither
+<span class="RktVar">base</span> nor <span class="RktVar">path</span> is just a root path, then
+<span class="RktVar">path</span> is returned.</p><p>If <span class="RktVar">path</span> is the same as <span class="RktVar">base</span>, then
+<span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">same</span><span class="RktPn">)</span> is returned only if
+<span class="RktVar">more-than-same?</span> is true. Otherwise, <span class="RktVar">path</span> is
+returned when <span class="RktVar">path</span> is the same as <span class="RktVar">base</span>.</p><p>If <span class="RktVar">normalize-case?</span> is true (the default), then pairs of path
+elements to be compared are first converted via
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._normal-case-path%29%29" class="RktValLink" data-pltdoc="x">normal-case-path</a></span>, which means that path elements are
+compared case-insentively on Windows. If <span class="RktVar">normalize-case?</span> is
+<span class="RktVal">#f</span>, then path elements and the path roots match only if they
+have the same case.</p><p>The result is normally a <a href="pathutils.html#%28tech._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">path</span></a> in the sense of <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span>.
+The result is a string only if <span class="RktVar">path</span> is provided a string and
+also returned as the result.</p><p class="SHistory">Changed in version 6.8.0.3 of package <span class="stt">base</span>: Made path elements case-normalized
+for comparison by default, and
+added the <span class="RktPn">#:normalize-case?</span>
+argument.<br/>Changed in version 6.90.0.21: Added the <span class="RktPn">#:more-than-same?</span>
+argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/path..rkt)._normalize-path))"></a><span title="Provided from: racket/path, racket | Package: base"><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._normalize-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">normalize-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">wrt</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">wrt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>For most purposes, <span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._simple-form-path%29%29" class="RktValLink" data-pltdoc="x">simple-form-path</a></span> is the
+preferred mechanism to normalize a path, because it works for paths
+that include non-existent directory components, and it avoids
+unnecessarily expanding soft links.</p></blockquote></blockquote></blockquote></div></p><p>Returns a complete version of <span class="RktVar">path</span> by making the path
+complete, expanding the complete path, and resolving all soft links
+(which requires consulting the filesystem). If <span class="RktVar">path</span> is
+relative, then <span class="RktVar">wrt</span> is used as the base path.</p><p>Letter case is <span style="font-style: italic">not</span> normalized by <span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._normalize-path%29%29" class="RktValLink" data-pltdoc="x">normalize-path</a></span>. For
+this and other reasons, such as whether the path is syntactically a
+directory, the result of <span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._normalize-path%29%29" class="RktValLink" data-pltdoc="x">normalize-path</a></span> is not suitable for
+comparisons that determine whether two paths refer to the same file or
+directory (i.e., the comparison may produce false negatives).</p><p>An error is signaled by <span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._normalize-path%29%29" class="RktValLink" data-pltdoc="x">normalize-path</a></span> if the input
+path contains an embedded path for a non-existent directory,
+or if an infinite cycle of soft links is detected.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._normalize-path%29%29" class="RktValLink" data-pltdoc="x">normalize-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"."</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/path..rkt)._path-element~3f))"></a><span title="Provided from: racket/path, racket | Package: base"><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-element~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">path-element?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">path</span> is a <a name="(tech._path._element)"></a><span style="font-style: italic">path element</span>:
+a path value for some platform (see <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span>) such that
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._split-path%29%29" class="RktValLink" data-pltdoc="x">split-path</a></span> applied to <span class="RktVar">path</span> would return
+<span class="RktVal">'</span><span class="RktVal">relative</span> as its first result and a path as its second
+result. Otherwise, the result is <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/path..rkt)._path-only))"></a><span title="Provided from: racket/path, racket | Package: base"><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-only%29%29" class="RktValDef RktValLink" data-pltdoc="x">path-only</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVar">path</span> without its final path element in the case that
+<span class="RktVar">path</span> is not syntactically a directory; if <span class="RktVar">path</span> has only
+a single, non-directory path element, <span class="RktVal">#f</span> is returned. If
+<span class="RktVar">path</span> is syntactically a directory, then <span class="RktVar">path</span> is
+returned unchanged (but as a path, if it was a string).</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-only%29%29" class="RktValLink" data-pltdoc="x">path-only</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;path:a/&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-only%29%29" class="RktValLink" data-pltdoc="x">path-only</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-only%29%29" class="RktValLink" data-pltdoc="x">path-only</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3edirectory-path%29%29" class="RktValLink" data-pltdoc="x">path-&gt;directory-path</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;path:a/&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-only%29%29" class="RktValLink" data-pltdoc="x">path-only</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">up</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">up</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;path:../..&gt;</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/path..rkt)._simple-form-path))"></a><span title="Provided from: racket/path, racket | Package: base"><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._simple-form-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">simple-form-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._simplify-path%29%29" class="RktValLink" data-pltdoc="x">simplify-path</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3ecomplete-path%29%29" class="RktValLink" data-pltdoc="x">path-&gt;complete-path</a></span><span class="stt"> </span><span class="RktVar">path</span><span class="RktPn">)</span><span class="RktPn">)</span>, which
+ensures that the result is a complete path containing no up- or
+same-directory indicators.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/path..rkt)._some-system-path-~3estring))"></a><span title="Provided from: racket/path, racket | Package: base"><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._some-system-path-~3estring%29%29" class="RktValDef RktValLink" data-pltdoc="x">some-system-path-&gt;string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Converts <span class="RktVar">path</span> to a string using a UTF-8 encoding of the
+path&rsquo;s bytes.</div></p><p>Use this function when working with paths for a different system
+(whose encoding of pathnames might be unrelated to the current
+locale&rsquo;s encoding) and when starting and ending with strings.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/path..rkt)._string-~3esome-system-path))"></a><span title="Provided from: racket/path, racket | Package: base"><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._string-~3esome-system-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-&gt;some-system-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktVar">kind</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="RktValLink" data-pltdoc="x">path-for-some-system?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">kind</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">unix</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">windows</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Converts <span class="RktVar">str</span> to a <span class="RktVar">kind</span> path using a UTF-8 encoding
+of the path&rsquo;s bytes.</div></p><p>Use this function when working with paths for a different system
+(whose encoding of pathnames might be unrelated to the current
+locale&rsquo;s encoding) and when starting and ending with strings.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/path..rkt)._shrink-path-wrt))"></a><span title="Provided from: racket/path, racket | Package: base"><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._shrink-path-wrt%29%29" class="RktValDef RktValLink" data-pltdoc="x">shrink-path-wrt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">pth</span><span class="hspace">&nbsp;</span><span class="RktVar">other-pths</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pth</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">other-pths</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a suffix of <span class="RktVar">pth</span> that shares nothing
+in common with the suffixes of <span class="RktVar">other-pths</span>, or
+<span class="RktVar">pth</span>, if not possible (e.g. when <span class="RktVar">other-pths</span>
+is empty or contains only paths with the same elements as <span class="RktVar">pth</span>).</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._shrink-path-wrt%29%29" class="RktValLink" data-pltdoc="x">shrink-path-wrt</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"racket"</span><span class="hspace">&nbsp;</span><span class="RktVal">"list.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"racket"</span><span class="hspace">&nbsp;</span><span class="RktVal">"list.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"racket"</span><span class="hspace">&nbsp;</span><span class="RktVal">"base.rkt"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;path:list.rkt&gt;</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._shrink-path-wrt%29%29" class="RktValLink" data-pltdoc="x">shrink-path-wrt</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"racket"</span><span class="hspace">&nbsp;</span><span class="RktVal">"list.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"racket"</span><span class="hspace">&nbsp;</span><span class="RktVal">"list.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"racket"</span><span class="hspace">&nbsp;</span><span class="RktVal">"private"</span><span class="hspace">&nbsp;</span><span class="RktVal">"list.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"racket"</span><span class="hspace">&nbsp;</span><span class="RktVal">"base.rkt"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;path:racket/list.rkt&gt;</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Manipulating_Paths.html" title="backward to &quot;15.1.1 Manipulating Paths&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="pathutils.html" title="up to &quot;15.1 Paths&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="unixpaths.html" title="forward to &quot;15.1.3 Unix and Mac OS Paths&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Namespaces.html b/clones/docs.racket-lang.org/reference/Namespaces.html
new file mode 100644
index 00000000..73779558
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Namespaces.html
@@ -0,0 +1,207 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14.1&nbsp;Namespaces</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewselflink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Namespaces.html" class="tocviewselflink" data-pltdoc="x">Namespaces</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="eval.html" class="tocviewlink" data-pltdoc="x">Evaluation and Compilation</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="load-lang.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>load</span></span> Language</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="Module_Names_and_Loading.html" class="tocviewlink" data-pltdoc="x">Module Names and Loading</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="chaperones.html" class="tocviewlink" data-pltdoc="x">Impersonators and Chaperones</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="securityguards.html" class="tocviewlink" data-pltdoc="x">Security Guards</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="custodians.html" class="tocviewlink" data-pltdoc="x">Custodians</a></td></tr><tr><td align="right">14.8&nbsp;</td><td><a href="threadgroups.html" class="tocviewlink" data-pltdoc="x">Thread Groups</a></td></tr><tr><td align="right">14.9&nbsp;</td><td><a href="inspectors.html" class="tocviewlink" data-pltdoc="x">Structure Inspectors</a></td></tr><tr><td align="right">14.10&nbsp;</td><td><a href="modprotect.html" class="tocviewlink" data-pltdoc="x">Code Inspectors</a></td></tr><tr><td align="right">14.11&nbsp;</td><td><a href="plumbers.html" class="tocviewlink" data-pltdoc="x">Plumbers</a></td></tr><tr><td align="right">14.12&nbsp;</td><td><a href="Sandboxed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Sandboxed Evaluation</a></td></tr><tr><td align="right">14.13&nbsp;</td><td><a href="repl-module.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>repl</span></span> Library</a></td></tr><tr><td align="right">14.14&nbsp;</td><td><a href="linklets.html" class="tocviewlink" data-pltdoc="x">Linklets and the Core Compiler</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace?</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._make-empty-namespace%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>empty-<wbr></wbr>namespace</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-base-empty-namespace%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>base-<wbr></wbr>empty-<wbr></wbr>namespace</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-base-namespace%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>base-<wbr></wbr>namespace</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-namespace-anchor%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>namespace-<wbr></wbr>anchor</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._namespace-anchor~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-<wbr></wbr>anchor?</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._namespace-anchor-~3eempty-namespace%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-<wbr></wbr>anchor-<wbr></wbr>&gt;empty-<wbr></wbr>namespace</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._namespace-anchor-~3enamespace%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-<wbr></wbr>anchor-<wbr></wbr>&gt;namespace</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>namespace</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-symbol-~3eidentifier%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-<wbr></wbr>symbol-<wbr></wbr>&gt;identifier</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-base-phase%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-<wbr></wbr>base-<wbr></wbr>phase</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-module-identifier%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-<wbr></wbr>module-<wbr></wbr>identifier</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-variable-value%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-<wbr></wbr>variable-<wbr></wbr>value</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-set-variable-value%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-<wbr></wbr>set-<wbr></wbr>variable-<wbr></wbr>value!</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-undefine-variable%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-<wbr></wbr>undefine-<wbr></wbr>variable!</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-mapped-symbols%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-<wbr></wbr>mapped-<wbr></wbr>symbols</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-<wbr></wbr>require</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%2Fcopy%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-<wbr></wbr>require/<span class="mywbr"> &nbsp;</span>copy</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%2Fconstant%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-<wbr></wbr>require/<span class="mywbr"> &nbsp;</span>constant</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%2Fexpansion-time%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-<wbr></wbr>require/<span class="mywbr"> &nbsp;</span>expansion-<wbr></wbr>time</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-attach-module%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-<wbr></wbr>attach-<wbr></wbr>module</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-attach-module-declaration%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-<wbr></wbr>attach-<wbr></wbr>module-<wbr></wbr>declaration</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-unprotect-module%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-<wbr></wbr>unprotect-<wbr></wbr>module</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-module-registry%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-<wbr></wbr>module-<wbr></wbr>registry</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-call-with-registry-lock%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-<wbr></wbr>call-<wbr></wbr>with-<wbr></wbr>registry-<wbr></wbr>lock</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._module-~3enamespace%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>&gt;namespace</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-syntax-introduce%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-<wbr></wbr>syntax-<wbr></wbr>introduce</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._module-provide-protected~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-<wbr></wbr>provide-<wbr></wbr>protected?</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-<wbr></wbr>reference?</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-constant~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-<wbr></wbr>reference-<wbr></wbr>constant?</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3eempty-namespace%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-<wbr></wbr>reference-<wbr></wbr>&gt;empty-<wbr></wbr>namespace</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3enamespace%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-<wbr></wbr>reference-<wbr></wbr>&gt;namespace</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3eresolved-module-path%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-<wbr></wbr>reference-<wbr></wbr>&gt;resolved-<wbr></wbr>module-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3emodule-path-index%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-<wbr></wbr>reference-<wbr></wbr>&gt;module-<wbr></wbr>path-<wbr></wbr>index</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3emodule-source%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-<wbr></wbr>reference-<wbr></wbr>&gt;module-<wbr></wbr>source</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3ephase%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-<wbr></wbr>reference-<wbr></wbr>&gt;phase</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3emodule-base-phase%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-<wbr></wbr>reference-<wbr></wbr>&gt;module-<wbr></wbr>base-<wbr></wbr>phase</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3emodule-declaration-inspector%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-<wbr></wbr>reference-<wbr></wbr>&gt;module-<wbr></wbr>declaration-<wbr></wbr>inspector</span></span></a></td></tr><tr><td><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-from-unsafe~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-<wbr></wbr>reference-<wbr></wbr>from-<wbr></wbr>unsafe?</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="security.html" title="backward to &quot;14 Reflection and Security&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="eval.html" title="forward to &quot;14.2 Evaluation and Compilation&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Namespaces&quot;">14.1<tt>&nbsp;</tt><a name="(part._.Namespaces)"></a>Namespaces</h4><p>See <a href="syntax-model.html#%28part._namespace-model%29" data-pltdoc="x">Namespaces</a> for basic information on the
+<a href="syntax-model.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespace</span></a> model.</p><p>A new <a href="syntax-model.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespace</span></a> is created with procedures like
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._make-empty-namespace%29%29" class="RktValLink" data-pltdoc="x">make-empty-namespace</a></span>, and <span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-base-namespace%29%29" class="RktValLink" data-pltdoc="x">make-base-namespace</a></span>, which
+return a first-class namespace value. A namespace is used by setting
+the <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span> parameter value, or by providing the
+namespace to procedures such as <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span> and
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval-syntax%29%29" class="RktValLink" data-pltdoc="x">eval-syntax</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._namespace~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">namespace?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a namespace value, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-empty-namespace))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._make-empty-namespace%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-empty-namespace</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new <a href="syntax-model.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespace</span></a> that is empty, and whose <a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module
+registry</span></a> contains only mappings for some internal, predefined modules,
+such as <span class="RktVal">'</span><span class="RktVal">#%kernel</span>. The namespace&rsquo;s <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a> is
+the same as the <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a> of the <a href="syntax-model.html#%28tech._current._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">current
+namespace</span></a>. Attach modules from an existing namespace to the new one
+with <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-attach-module%29%29" class="RktValLink" data-pltdoc="x">namespace-attach-module</a></span>.</div></p><p>The new namespace is associated with a new <a name="(tech._root._namespace)"></a><span style="font-style: italic">root namespace</span>,
+which has the same <a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module registry</span></a> as the returned namespace
+and has a <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a> of 0. The new <a href="Namespaces.html#%28tech._root._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">root namespace</span></a> is
+the same as the returned namespace if both have <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a> 0.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._make-base-empty-namespace))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-base-empty-namespace%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-base-empty-namespace</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new empty <a href="syntax-model.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespace</span></a> like <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._make-empty-namespace%29%29" class="RktValLink" data-pltdoc="x">make-empty-namespace</a></span>,
+but with <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>
+attached. The namespace&rsquo;s <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a> is the same as the
+<a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> in which the <span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-base-empty-namespace%29%29" class="RktValLink" data-pltdoc="x">make-base-empty-namespace</a></span>
+function was created.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._make-base-namespace))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-base-namespace%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-base-namespace</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new <a href="syntax-model.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespace</span></a> like <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._make-empty-namespace%29%29" class="RktValLink" data-pltdoc="x">make-empty-namespace</a></span>, but
+with <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> attached and
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>d into the top-level environment. The namespace&rsquo;s
+<a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a> is the same as the <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> in which the
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-base-namespace%29%29" class="RktValLink" data-pltdoc="x">make-base-namespace</a></span> function was created.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._define-namespace-anchor))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-namespace-anchor%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-namespace-anchor</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Binds <span class="RktVar">id</span> to a namespace anchor that can be used with
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._namespace-anchor-~3eempty-namespace%29%29" class="RktValLink" data-pltdoc="x">namespace-anchor-&gt;empty-namespace</a></span> and
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._namespace-anchor-~3enamespace%29%29" class="RktValLink" data-pltdoc="x">namespace-anchor-&gt;namespace</a></span>.</div></p><p>This form can be used only in a <a href="syntax-model.html#%28tech._top._level._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level context</span></a> or in a
+<a href="syntax-model.html#%28tech._module._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">module-context</span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._namespace-anchor~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._namespace-anchor~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">namespace-anchor?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a namespace-anchor value,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._namespace-anchor-~3eempty-namespace))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._namespace-anchor-~3eempty-namespace%29%29" class="RktValDef RktValLink" data-pltdoc="x">namespace-anchor-&gt;empty-namespace</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._namespace-anchor~3f%29%29" class="RktValLink" data-pltdoc="x">namespace-anchor?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an empty namespace that shares a <a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module registry</span></a>
+and <a href="Namespaces.html#%28tech._root._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">root namespace</span></a> with
+the source of the anchor, and whose <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a> is the
+<a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> in which the anchor was created.</div></p><p>If the anchor is from a <span class="RktSym"><a href="Namespaces.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-namespace-anchor%29%29" class="RktStxLink" data-pltdoc="x">define-namespace-anchor</a></span> form in a
+module context, then the source is the namespace in which the
+containing module is instantiated. If the anchor is from a
+<span class="RktSym"><a href="Namespaces.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-namespace-anchor%29%29" class="RktStxLink" data-pltdoc="x">define-namespace-anchor</a></span> form in a top-level content, then the
+source is the namespace in which the anchor definition was evaluated.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._namespace-anchor-~3enamespace))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._namespace-anchor-~3enamespace%29%29" class="RktValDef RktValLink" data-pltdoc="x">namespace-anchor-&gt;namespace</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._namespace-anchor~3f%29%29" class="RktValLink" data-pltdoc="x">namespace-anchor?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a namespace corresponding to the source of the anchor.</div></p><p>If the anchor is from a <span class="RktSym"><a href="Namespaces.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-namespace-anchor%29%29" class="RktStxLink" data-pltdoc="x">define-namespace-anchor</a></span> form in a
+module context, then the result is a namespace for the module&rsquo;s body
+in the anchor&rsquo;s phase. The result is the same as a namespace obtained
+via <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._module-~3enamespace%29%29" class="RktValLink" data-pltdoc="x">module-&gt;namespace</a></span>, and the module is similarly made
+<a href="eval-model.html#%28tech._available%29" class="techoutside" data-pltdoc="x"><span class="techinside">available</span></a> if it is not available already.</p><p>If the anchor is from a <span class="RktSym"><a href="Namespaces.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-namespace-anchor%29%29" class="RktStxLink" data-pltdoc="x">define-namespace-anchor</a></span> form in a
+top-level content, then the result is the namespace in which the
+anchor definition was evaluated.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-namespace))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-namespace</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-namespace</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the <a href="syntax-model.html#%28tech._current._namespace%29" data-pltdoc="x">current namespace</a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._namespace-symbol-~3eidentifier))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-symbol-~3eidentifier%29%29" class="RktValDef RktValLink" data-pltdoc="x">namespace-symbol-&gt;identifier</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sym</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span> restricted to symbols. The
+<a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> of the resulting identifier corresponds to
+the top-level environment of the current namespace; the identifier has
+no source location or properties.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._namespace-base-phase))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-base-phase%29%29" class="RktValDef RktValLink" data-pltdoc="x">namespace-base-phase</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">namespace</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">namespace</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a> of <span class="RktVar">namespace</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._namespace-module-identifier))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-module-identifier%29%29" class="RktValDef RktValLink" data-pltdoc="x">namespace-module-identifier</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">where</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">where</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns an identifier whose binding is <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> in the
+<a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a> of <span class="RktVar">where</span> if it is a namespace, or in the
+<span class="RktVar">where</span> <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> otherwise.</div></p><p>The <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> of the identifier includes bindings (in
+the same <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>) for all syntactic forms that appear in
+fully expanded code (see <a href="syntax-model.html#%28part._fully-expanded%29" data-pltdoc="x">Fully Expanded Programs</a>), but using the
+name reported by the second element of <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="RktValLink" data-pltdoc="x">identifier-binding</a></span> for
+the binding; the <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> may also include other
+bindings.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._namespace-variable-value))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-variable-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">namespace-variable-value</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">sym</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">use-mapping?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">failure-thunk</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">namespace</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">use-mapping?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">failure-thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">namespace</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a value for <span class="RktVar">sym</span> in <span class="RktVar">namespace</span>, using
+<span class="RktVar">namespace</span>&rsquo;s <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a>. The returned value depends on
+<span class="RktVar">use-mapping?</span>:</div></p><ul><li><p>If <span class="RktVar">use-mapping?</span> is true (the default), and if
+<span class="RktVar">sym</span> maps to a top-level variable or an imported variable
+(see <a href="syntax-model.html#%28part._namespace-model%29" data-pltdoc="x">Namespaces</a>), then the result is the same as
+evaluating <span class="RktVar">sym</span> as an expression. If <span class="RktVar">sym</span> maps to
+syntax or imported syntax, then <span class="RktVar">failure-thunk</span> is called or
+the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax</a></span> exception is raised. If <span class="RktVar">sym</span> is mapped to an
+undefined variable or an uninitialized module variable, then
+<span class="RktVar">failure-thunk</span> is called or the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3avariable%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:variable</a></span> exception is raised.</p></li><li><p>If <span class="RktVar">use-mapping?</span> is <span class="RktVal">#f</span>, the namespace&rsquo;s
+syntax and import mappings are ignored. Instead, the value of the
+top-level variable named <span class="RktVar">sym</span> in namespace is returned. If
+the variable is undefined, then <span class="RktVar">failure-thunk</span> is called or
+the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3avariable%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:variable</a></span> exception is raised.</p></li></ul><p>If <span class="RktVar">failure-thunk</span> is not <span class="RktVal">#f</span>,
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-variable-value%29%29" class="RktValLink" data-pltdoc="x">namespace-variable-value</a></span> calls <span class="RktVar">failure-thunk</span> to
+produce the return value in place of raising an
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3avariable%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:variable</a></span> or <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax</a></span>
+exception.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._namespace-set-variable-value!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-set-variable-value%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">namespace-set-variable-value!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">sym</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">map?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">namespace</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">as-constant?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">map?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">namespace</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">as-constant?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Sets the value of <span class="RktVar">sym</span> in the top-level environment of
+<span class="RktVar">namespace</span> in the <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a>, defining <span class="RktVar">sym</span> if
+it is not already defined.</div></p><p>If <span class="RktVar">map?</span> is supplied as true, then the namespace&rsquo;s
+<a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> mapping is also adjusted (see
+<a href="syntax-model.html#%28part._namespace-model%29" data-pltdoc="x">Namespaces</a>) in the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> corresponding to
+the <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a>, so that <span class="RktVar">sym</span> maps to the variable.</p><p>If <span class="RktVar">as-constant?</span> is true, then the variable is made a constant
+(so future assignments are rejected) after <span class="RktVar">v</span> is installed as
+the value.</p><p class="SHistory">Changed in version 6.90.0.14 of package <span class="stt">base</span>: Added the <span class="RktVar">as-constant?</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._namespace-undefine-variable!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-undefine-variable%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">namespace-undefine-variable!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">sym</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">namespace</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">namespace</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Removes the <span class="RktVar">sym</span> variable, if any, in the top-level
+environment of <span class="RktVar">namespace</span> in its <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a>. The
+namespace&rsquo;s <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> mapping (see <a href="syntax-model.html#%28part._namespace-model%29" data-pltdoc="x">Namespaces</a>)
+is unaffected.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._namespace-mapped-symbols))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-mapped-symbols%29%29" class="RktValDef RktValLink" data-pltdoc="x">namespace-mapped-symbols</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">namespace</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">namespace</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of all symbols that are mapped to variables, syntax,
+and imports in <span class="RktVar">namespace</span> for the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>
+corresponding to the <a href="syntax-model.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespace</span></a>&rsquo;s <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._namespace-require))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%29%29" class="RktValDef RktValLink" data-pltdoc="x">namespace-require</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">quoted-raw-require-spec</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">namespace</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">quoted-raw-require-spec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">namespace</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Performs the import corresponding to <span class="RktVar">quoted-raw-require-spec</span>
+in the top-level environment of <span class="RktVar">namespace</span>, like a
+top-level <span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25require%29%29" class="RktStxLink" data-pltdoc="x">#%require</a></span>. The <span class="RktVar">quoted-raw-require-spec</span>
+argument must be either a datum that corresponds to a quoted
+<span class="RktVar">raw-require-spec</span> for <span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25require%29%29" class="RktStxLink" data-pltdoc="x">#%require</a></span>, which includes
+module paths, or it can be a <a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module path</span></a>.</div></p><p>Module paths in <span class="RktVar">quoted-raw-require-spec</span> are resolved with respect
+to <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-load-relative-directory</a></span> or
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span> (if the former is <span class="RktVal">#f</span>), even if the
+current namespace corresponds to a module body.</p><p class="SHistory">Changed in version 6.90.0.16 of package <span class="stt">base</span>: Added the <span class="RktVar">namespace</span> optional argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._namespace-require/copy))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%2Fcopy%29%29" class="RktValDef RktValLink" data-pltdoc="x">namespace-require/copy</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">quoted-raw-require-spec</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">namespace</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">quoted-raw-require-spec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">namespace</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%29%29" class="RktValLink" data-pltdoc="x">namespace-require</a></span> for syntax exported from the module,
+but exported variables at the namespace&rsquo;s <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a> are
+treated differently: the export&rsquo;s current value is copied to a
+top-level variable in <span class="RktVar">namespace</span>.</div></p><p class="SHistory">Changed in version 6.90.0.16 of package <span class="stt">base</span>: Added the <span class="RktVar">namespace</span> optional argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._namespace-require/constant))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%2Fconstant%29%29" class="RktValDef RktValLink" data-pltdoc="x">namespace-require/constant</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">quoted-raw-require-spec</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">namespace</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">quoted-raw-require-spec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">namespace</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%29%29" class="RktValLink" data-pltdoc="x">namespace-require</a></span>, but for each exported variable at the
+<a href="syntax-model.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespace</span></a>&rsquo;s <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a>, the export&rsquo;s value is copied to
+a corresponding top-level variable that is made immutable. Despite
+setting the top-level variable, the corresponding identifier is bound
+as imported.</div></p><p class="SHistory">Changed in version 6.90.0.16 of package <span class="stt">base</span>: Added the <span class="RktVar">namespace</span> optional argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._namespace-require/expansion-time))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%2Fexpansion-time%29%29" class="RktValDef RktValLink" data-pltdoc="x">namespace-require/expansion-time</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">quoted-raw-require-spec</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">namespace</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">quoted-raw-require-spec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">namespace</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%29%29" class="RktValLink" data-pltdoc="x">namespace-require</a></span>, but only the transformer part of the
+module is executed relative to <span class="RktVar">namespace</span>&rsquo;s <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base
+phase</span></a>; that is, the module is merely <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed, and not
+<a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d (see <a href="syntax-model.html#%28part._mod-parse%29" data-pltdoc="x">Module Expansion, Phases, and Visits</a>). If the required module
+has not been instantiated before, the module&rsquo;s variables remain
+undefined.</div></p><p class="SHistory">Changed in version 6.90.0.16 of package <span class="stt">base</span>: Added the <span class="RktVar">namespace</span> optional argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._namespace-attach-module))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-attach-module%29%29" class="RktValDef RktValLink" data-pltdoc="x">namespace-attach-module</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">src-namespace</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">modname</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">dest-namespace</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src-namespace</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">modname</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dest-namespace</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Attaches the instantiated module named by <span class="RktVar">modname</span>
+ in <span class="RktVar">src-namespace</span> (at its <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a>) to the
+ <a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module registry</span></a> of <span class="RktVar">dest-namespace</span>.</div></p><p>In addition to <span class="RktVar">modname</span>, every module that it
+ imports (directly or indirectly) is also recorded in the
+ current namespace&rsquo;s <a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module registry</span></a>, and instances
+ at the same <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> are also attached to
+ <span class="RktVar">dest-namespace</span> (while <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visits</span></a> at the
+ module&rsquo;s phase and instances at higher or lower phases are
+ not attached, nor even made <a href="eval-model.html#%28tech._available%29" class="techoutside" data-pltdoc="x"><span class="techinside">available</span></a> for on-demand
+ <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visits</span></a>). The inspector of the module invocation in
+ <span class="RktVar">dest-namespace</span> is the same as inspector of the
+ invocation in <span class="RktVar">src-namespace</span>.</p><p>If <span class="RktVar">modname</span> is not a symbol, the current module
+ name resolver is called to resolve the path, but no module
+ is loaded; the resolved form of <span class="RktVar">modname</span> is used as
+ the module name in <span class="RktVar">dest-namespace</span>.</p><p>If <span class="RktVar">modname</span> refers to a submodule or a module with
+ submodules, unless the module was loaded from bytecode
+ (i.e., a <span class="stt">".zo"</span> file) independently from submodules
+ within the same top-level module, then declarations for all
+ submodules within the module&rsquo;s top-level module are also
+ attached to <span class="RktVar">dest-namespace</span>.</p><p>If <span class="RktVar">modname</span> does not refer to an
+ <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d module in <span class="RktVar">src-namespace</span>, or if
+ the name of any module to be attached already has a
+ different declaration or same-<a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> instance in
+ <span class="RktVar">dest-namespace</span>, then the
+ <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>If <span class="RktVar">src-namespace</span> and <span class="RktVar">dest-namespace</span> do
+ not have the same <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a>, then the
+ <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>Unlike <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%29%29" class="RktValLink" data-pltdoc="x">namespace-require</a></span>,
+ <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-attach-module%29%29" class="RktValLink" data-pltdoc="x">namespace-attach-module</a></span> does not
+ <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a> the module, but copies the module
+ instance from the source namespace to the target namespace.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">food</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">apple</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">apple</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"pie"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%29%29" class="RktValLink" data-pltdoc="x">namespace-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">food</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ns</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-base-namespace%29%29" class="RktValLink" data-pltdoc="x">make-base-namespace</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%29%29" class="RktValLink" data-pltdoc="x">namespace-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">food</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">require: unknown module</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">module name: 'food</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-base-namespace%29%29" class="RktValLink" data-pltdoc="x">make-base-namespace</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-attach-module%29%29" class="RktValLink" data-pltdoc="x">namespace-attach-module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ns</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">food</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%29%29" class="RktValLink" data-pltdoc="x">namespace-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">food</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">apple</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">apple</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-base-namespace%29%29" class="RktValLink" data-pltdoc="x">make-base-namespace</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-attach-module-declaration%29%29" class="RktValLink" data-pltdoc="x">namespace-attach-module-declaration</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ns</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">food</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%29%29" class="RktValLink" data-pltdoc="x">namespace-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">food</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">apple</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">apple</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._namespace-attach-module-declaration))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-attach-module-declaration%29%29" class="RktValDef RktValLink" data-pltdoc="x">namespace-attach-module-declaration</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">src-namespace</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">modname</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">dest-namespace</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src-namespace</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">modname</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dest-namespace</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-attach-module%29%29" class="RktValLink" data-pltdoc="x">namespace-attach-module</a></span>, but the module
+specified by <span class="RktVar">modname</span> need only be declared (and not
+necessarily <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d) in <span class="RktVar">src-namespace</span>, and the
+module is merely declared in <span class="RktVar">dest-namespace</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._namespace-unprotect-module))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-unprotect-module%29%29" class="RktValDef RktValLink" data-pltdoc="x">namespace-unprotect-module</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">inspector</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">modname</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">namespace</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">inspector</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">modname</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">namespace</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Changes the inspector for the instance of the module referenced by
+<span class="RktVar">modname</span> in <span class="RktVar">namespace</span>&rsquo;s <a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module registry</span></a> so
+that it is controlled by the current code inspector. The given
+<span class="RktVar">inspector</span> must currently control the invocation of the module
+in <span class="RktVar">namespace</span>&rsquo;s <a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module registry</span></a>, otherwise the
+inspector is not changed. See also <a href="modprotect.html" data-pltdoc="x">Code Inspectors</a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._namespace-module-registry))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-module-registry%29%29" class="RktValDef RktValLink" data-pltdoc="x">namespace-module-registry</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">namespace</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">namespace</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module registry</span></a> of the given namespace. This value
+is useful only for identification via <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._namespace-call-with-registry-lock))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-call-with-registry-lock%29%29" class="RktValDef RktValLink" data-pltdoc="x">namespace-call-with-registry-lock</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">namespace</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">thunk</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">namespace</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Calls <span class="RktVar">thunk</span> while holding a reentrant lock for the namespace&rsquo;s
+<a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module registry</span></a>.</div></p><p>Namespace functions do not automatically use the registry lock, but it
+can be used via <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-call-with-registry-lock%29%29" class="RktValLink" data-pltdoc="x">namespace-call-with-registry-lock</a></span> among
+threads that load and instantiate modules to avoid internal race
+conditions. On-demand <a href="eval-model.html#%28tech._instantiation%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiation</span></a> of <a href="eval-model.html#%28tech._available%29" class="techoutside" data-pltdoc="x"><span class="techinside">available</span></a> modules
+also takes the lock; see <a href="syntax-model.html#%28part._mod-parse%29" data-pltdoc="x">Module Expansion, Phases, and Visits</a>.</p><p class="SHistory">Added in version 8.1.0.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-~3enamespace))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._module-~3enamespace%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-&gt;namespace</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">mod</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">src-namespace</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">mod</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src-namespace</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a namespace that corresponds to the body of an instantiated
+module in <span class="RktVar">src-namespace</span>&rsquo;s <a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module registry</span></a> and in the
+<span class="RktVar">src-namespace</span>&rsquo;s <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a>, making the module
+<a href="eval-model.html#%28tech._available%29" class="techoutside" data-pltdoc="x"><span class="techinside">available</span></a> for on-demand <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visits</span></a> at <span class="RktVar">src-namespace</span>&rsquo;s
+<a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a>. The returned namespace has the same <a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module
+registry</span></a> as <span class="RktVar">src-namespace</span>. Modifying a binding in the
+resulting namespace changes the binding seen in modules that require the
+namespace&rsquo;s module.</div></p><p>Module paths in a top-level <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> expression are resolved
+with respect to the namespace&rsquo;s module. New <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span>
+declarations are not allowed.</p><p>If the current code inspector does not control the invocation of the
+module in <span class="RktVar">src-namespace</span>&rsquo;s <a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module registry</span></a>, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised; see also <a href="modprotect.html" data-pltdoc="x">Code Inspectors</a>.</p><p>Bindings in the result namespace cannot be modified if the
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-enforce-module-constants%29%29" class="RktValLink" data-pltdoc="x">compile-enforce-module-constants</a></span> parameter was true when the
+module was declared, unless the module declaration itself included
+assignments to the binding via <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>.</p><p class="SHistory">Changed in version 6.90.0.16 of package <span class="stt">base</span>: Added the <span class="RktVar">src-namespace</span> optional argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._namespace-syntax-introduce))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-syntax-introduce%29%29" class="RktValDef RktValLink" data-pltdoc="x">namespace-syntax-introduce</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">namespace</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">namespace</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a syntax object like <span class="RktVar">stx</span>, except that
+<span class="RktVar">namespace</span>&rsquo;s bindings are included in the <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>&rsquo;s
+<a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> (see <a href="syntax-model.html#%28part._stxobj-model%29" data-pltdoc="x">Syntax Objects</a>). The
+additional context is overridden by any existing <a href="syntax-model.html#%28tech._top._level._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level
+bindings</span></a> in the <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>&rsquo;s <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a>, or
+by any existing or future <a href="syntax-model.html#%28tech._module._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">module bindings</span></a> in the <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical
+information</span></a>.</div></p><p class="SHistory">Changed in version 6.90.0.16 of package <span class="stt">base</span>: Added the <span class="RktVar">namespace</span> optional argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._module-provide-protected~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._module-provide-protected~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">module-provide-protected?</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">module-path-index</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">sym</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">module-path-index</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#f</span> if the module declaration for
+<span class="RktVar">module-path-index</span> defines <span class="RktVar">sym</span> and exports it
+unprotected, <span class="RktVal">#t</span> otherwise (which may mean that the symbol
+corresponds to an unexported definition, a protected export, or an
+identifier that is not defined at all within the module).</div></p><p>The <span class="RktVar">module-path-index</span> argument can be a symbol; see
+<a href="Module_Names_and_Loading.html#%28part._modpathidx%29" data-pltdoc="x">Compiled Modules and References</a> for more information on module path
+indices.</p><p>Typically, the arguments to <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._module-provide-protected~3f%29%29" class="RktValLink" data-pltdoc="x">module-provide-protected?</a></span>
+correspond to the first two elements of a list produced by
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="RktValLink" data-pltdoc="x">identifier-binding</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._variable-reference~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">variable-reference?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Return <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="Locations____variable-reference.html#%28tech._variable._reference%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable reference</span></a>
+produced by <span class="RktSym"><a href="Locations____variable-reference.html#%28form._%28%28quote._~23~25kernel%29._~23~25variable-reference%29%29" class="RktStxLink" data-pltdoc="x">#%variable-reference</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._variable-reference-constant~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-constant~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">variable-reference-constant?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">varref</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">varref</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference~3f%29%29" class="RktValLink" data-pltdoc="x">variable-reference?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if the variable represented by <span class="RktVar">varref</span>
+will retain its current value (i.e., <span class="RktVar">varref</span> refers to a
+variable that cannot be further modified by <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span> or
+<span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span>), <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._variable-reference-~3eempty-namespace))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3eempty-namespace%29%29" class="RktValDef RktValLink" data-pltdoc="x">variable-reference-&gt;empty-namespace</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">varref</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">varref</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference~3f%29%29" class="RktValLink" data-pltdoc="x">variable-reference?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an empty namespace that shares module declarations and
+instances with the namespace in which <span class="RktVar">varref</span> is instantiated,
+and with the same phase as <span class="RktVar">varref</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._variable-reference-~3enamespace))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3enamespace%29%29" class="RktValDef RktValLink" data-pltdoc="x">variable-reference-&gt;namespace</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">varref</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">varref</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference~3f%29%29" class="RktValLink" data-pltdoc="x">variable-reference?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">If <span class="RktVar">varref</span> refers to a <a href="eval-model.html#%28tech._module._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">module-level variable</span></a>, then the
+result is a namespace for the module&rsquo;s body in the referenced
+variable&rsquo;s <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a>; the result is the same as a namespace
+obtained via <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._module-~3enamespace%29%29" class="RktValLink" data-pltdoc="x">module-&gt;namespace</a></span>, and the module is similarly made
+<a href="eval-model.html#%28tech._available%29" class="techoutside" data-pltdoc="x"><span class="techinside">available</span></a> if it is not available already.</div></p><p>If <span class="RktVar">varref</span> refers to a <a href="eval-model.html#%28tech._top._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level variable</span></a>, then the
+result is the namespace in which the referenced variable is defined.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._variable-reference-~3eresolved-module-path))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3eresolved-module-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">variable-reference-&gt;resolved-module-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">varref</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">varref</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference~3f%29%29" class="RktValLink" data-pltdoc="x">variable-reference?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">If <span class="RktVar">varref</span> refers to a <a href="eval-model.html#%28tech._module._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">module-level variable</span></a>, the
+result is a <a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module path</span></a> naming the module.</div></p><p>If <span class="RktVar">varref</span> refers to a <a href="eval-model.html#%28tech._top._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level variable</span></a>, then the
+result is <span class="RktVal">#f</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._variable-reference-~3emodule-path-index))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3emodule-path-index%29%29" class="RktValDef RktValLink" data-pltdoc="x">variable-reference-&gt;module-path-index</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">varref</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">varref</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference~3f%29%29" class="RktValLink" data-pltdoc="x">variable-reference?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">If <span class="RktVar">varref</span> refers to a <a href="eval-model.html#%28tech._module._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">module-level variable</span></a>, the
+result is a <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a> naming the module.</div></p><p>If <span class="RktVar">varref</span> refers to a <a href="eval-model.html#%28tech._top._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level variable</span></a>, then the
+result is <span class="RktVal">#f</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._variable-reference-~3emodule-source))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3emodule-source%29%29" class="RktValDef RktValLink" data-pltdoc="x">variable-reference-&gt;module-source</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">varref</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">varref</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference~3f%29%29" class="RktValLink" data-pltdoc="x">variable-reference?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">If <span class="RktVar">varref</span> refers to a <a href="eval-model.html#%28tech._module._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">module-level variable</span></a>, the
+result is a path or symbol naming the module&rsquo;s source (which is
+typically, but not always, the same as in the <a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module
+path</span></a>).  If the relevant module is a <a href="eval-model.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodule</span></a>, the result
+corresponds to the enclosing top-level module&rsquo;s source.</div></p><p>If <span class="RktVar">varref</span> refers to a <a href="eval-model.html#%28tech._top._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level variable</span></a>, then the
+result is <span class="RktVal">#f</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._variable-reference-~3ephase))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3ephase%29%29" class="RktValDef RktValLink" data-pltdoc="x">variable-reference-&gt;phase</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">varref</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">varref</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference~3f%29%29" class="RktValLink" data-pltdoc="x">variable-reference?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> of the variable referenced by <span class="RktVar">varref</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._variable-reference-~3emodule-base-phase))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3emodule-base-phase%29%29" class="RktValDef RktValLink" data-pltdoc="x">variable-reference-&gt;module-base-phase</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">varref</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">varref</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference~3f%29%29" class="RktValLink" data-pltdoc="x">variable-reference?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> in which the module is instantiated for the
+variable referenced by <span class="RktVar">varref</span>, or <span class="RktVal">0</span> if the variable
+for <span class="RktVar">varref</span> is not within a module.</div></p><p>For a variable with a module, the result is less than the result of
+<span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3ephase%29%29" class="RktValLink" data-pltdoc="x">variable-reference-&gt;phase</a></span><span class="stt"> </span><span class="RktVar">varref</span><span class="RktPn">)</span> by <span style="font-style: italic">n</span> when the
+variable is bound at <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> <span style="font-style: italic">n</span> within the module.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._variable-reference-~3emodule-declaration-inspector))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3emodule-declaration-inspector%29%29" class="RktValDef RktValLink" data-pltdoc="x">variable-reference-&gt;module-declaration-inspector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">varref</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">varref</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference~3f%29%29" class="RktValLink" data-pltdoc="x">variable-reference?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the declaration <a href="inspectors.html#%28tech._inspector%29" class="techoutside" data-pltdoc="x"><span class="techinside">inspector</span></a> (see <a href="modprotect.html" data-pltdoc="x">Code Inspectors</a>)
+for the module of <span class="RktVar">varref</span>, where <span class="RktVar">varref</span> must refer to
+an anonymous module variable as produced by
+<span class="RktPn">(</span><span class="RktSym"><a href="Locations____variable-reference.html#%28form._%28%28quote._~23~25kernel%29._~23~25variable-reference%29%29" class="RktStxLink" data-pltdoc="x">#%variable-reference</a></span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._variable-reference-from-unsafe~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-from-unsafe~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">variable-reference-from-unsafe?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">varref</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">varref</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference~3f%29%29" class="RktValLink" data-pltdoc="x">variable-reference?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if the module of the variable reference itself
+(not necessarily a referenced variable) is compiled in unsafe mode,
+<span class="RktVal">#f</span> otherwise. <a href="linklets.html#%28tech._unsafe._mode%29" class="techoutside" data-pltdoc="x"><span class="techinside">Unsafe mode</span></a> can be enabled through the
+<a href="linklets.html#%28tech._linklet%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet</span></a> interface or enable for a module with
+<span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._~23~25declare%29%29" class="RktStxLink" data-pltdoc="x">#%declare</a></span><span class="stt"> </span><span class="RktPn">#:unsafe</span><span class="RktPn">)</span>.</div></p><p>The <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-from-unsafe~3f%29%29" class="RktValLink" data-pltdoc="x">variable-reference-from-unsafe?</a></span> procedure is intended for
+use as</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-from-unsafe~3f%29%29" class="RktValLink" data-pltdoc="x">variable-reference-from-unsafe?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Locations____variable-reference.html#%28form._%28%28quote._~23~25kernel%29._~23~25variable-reference%29%29" class="RktStxLink" data-pltdoc="x">#%variable-reference</a></span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>which the compiler can optimize to a literal <span class="RktVal">#t</span> or
+<span class="RktVal">#f</span> (since the enclosing module is being compiled in
+<a href="linklets.html#%28tech._unsafe._mode%29" class="techoutside" data-pltdoc="x"><span class="techinside">unsafe mode</span></a> or not).</p><p class="SHistory">Added in version 6.12.0.4 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="security.html" title="backward to &quot;14 Reflection and Security&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="eval.html" title="forward to &quot;14.2 Evaluation and Compilation&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Object_and_Class_Contracts.html b/clones/docs.racket-lang.org/reference/Object_and_Class_Contracts.html
new file mode 100644
index 00000000..46c68afc
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Object_and_Class_Contracts.html
@@ -0,0 +1,127 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6.7&nbsp;Object and Class Contracts</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewselflink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="createinterface.html" class="tocviewlink" data-pltdoc="x">Creating Interfaces</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="createclass.html" class="tocviewlink" data-pltdoc="x">Creating Classes</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="objcreation.html" class="tocviewlink" data-pltdoc="x">Creating Objects</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="ivaraccess.html" class="tocviewlink" data-pltdoc="x">Field and Method Access</a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="mixins.html" class="tocviewlink" data-pltdoc="x">Mixins</a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="trait.html" class="tocviewlink" data-pltdoc="x">Traits</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="Object_and_Class_Contracts.html" class="tocviewselflink" data-pltdoc="x">Object and Class Contracts</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="objectequality.html" class="tocviewlink" data-pltdoc="x">Object Equality and Hashing</a></td></tr><tr><td align="right">6.9&nbsp;</td><td><a href="objectserialize.html" class="tocviewlink" data-pltdoc="x">Object Serialization</a></td></tr><tr><td align="right">6.10&nbsp;</td><td><a href="objectprinting.html" class="tocviewlink" data-pltdoc="x">Object Printing</a></td></tr><tr><td align="right">6.11&nbsp;</td><td><a href="objectutils.html" class="tocviewlink" data-pltdoc="x">Object, Class, and Interface Utilities</a></td></tr><tr><td align="right">6.12&nbsp;</td><td><a href="Surrogates.html" class="tocviewlink" data-pltdoc="x">Surrogates</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._class%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">class/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._absent%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">absent</span></span></a></td></tr><tr><td><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._-~3em%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink"><span class="nobreak">-<wbr></wbr>&gt;</span>m</span></span></a></td></tr><tr><td><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._-~3e%2Am%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink"><span class="nobreak">-<wbr></wbr>&gt;</span>*m</span></span></a></td></tr><tr><td><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._case-~3em%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>&gt;m</span></span></a></td></tr><tr><td><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._-~3edm%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink"><span class="nobreak">-<wbr></wbr>&gt;</span>dm</span></span></a></td></tr><tr><td><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._object%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">object/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._instanceof%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">instanceof/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._dynamic-object%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-<wbr></wbr>object/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._object-contract%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">object-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._mixin-contract%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">mixin-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._make-mixin-contract%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>mixin-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._is-a~3f%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">is-<wbr></wbr>a?/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._implementation~3f%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">implementation?/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._subclass~3f%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subclass?/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="trait.html" title="backward to &quot;6.6 Traits&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="objectequality.html" title="forward to &quot;6.8 Object Equality and Hashing&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Object_and_Class_Contracts&quot;">6.7<tt>&nbsp;</tt><a name="(part._.Object_and_.Class_.Contracts)"></a>Object and Class Contracts</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/class..rkt)._class/c))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._class%2Fc%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">class/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-opaque</span><span class="hspace">&nbsp;</span><span class="RktVar">member-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">maybe-opaque</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:opaque</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:opaque</span><span class="hspace">&nbsp;</span><span class="RktPn">#:ignore-local-member-names</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">member-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">method-spec</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktVar">field-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init%29%29" class="RktStxLink" data-pltdoc="x">init</a></span><span class="hspace">&nbsp;</span><span class="RktVar">field-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-field%29%29" class="RktStxLink" data-pltdoc="x">init-field</a></span><span class="hspace">&nbsp;</span><span class="RktVar">field-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span><span class="hspace">&nbsp;</span><span class="RktVar">method-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit-field%29%29" class="RktStxLink" data-pltdoc="x">inherit-field</a></span><span class="hspace">&nbsp;</span><span class="RktVar">field-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span><span class="hspace">&nbsp;</span><span class="RktVar">method-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inner%29%29" class="RktStxLink" data-pltdoc="x">inner</a></span><span class="hspace">&nbsp;</span><span class="RktVar">method-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span><span class="hspace">&nbsp;</span><span class="RktVar">method-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span><span class="hspace">&nbsp;</span><span class="RktVar">method-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%29%29" class="RktStxLink" data-pltdoc="x">augride</a></span><span class="hspace">&nbsp;</span><span class="RktVar">method-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._absent%29%29" class="RktStxLink" data-pltdoc="x">absent</a></span><span class="hspace">&nbsp;</span><span class="RktVar">absent-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">method-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">method-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">method-id</span><span class="hspace">&nbsp;</span><span class="RktVar">method-contract-expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">field-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">field-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">field-id</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">absent-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">method-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktVar">field-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Produces a contract for a class.</div></p><p>There are two major categories of contracts listed in a <span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._class%2Fc%29%29" class="RktStxLink" data-pltdoc="x">class/c</a></span>
+form: external and internal contracts. External contracts govern behavior
+when an object is instantiated from a class or when methods or fields are
+accessed via an object of that class. Internal contracts govern behavior
+when method or fields are accessed within the class hierarchy.  This
+separation allows for stronger contracts for class clients and weaker
+contracts for subclasses.</p><p>Method contracts must contain an additional initial argument which corresponds
+to the implicit <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this%29%29" class="RktStxLink" data-pltdoc="x">this</a></span> parameter of the method.  This allows for
+contracts which discuss the state of the object when the method is called
+(or, for dependent contracts, in other parts of the contract).  Alternative
+contract forms, such as <span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._-~3em%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>m</a></span>, are provided as a shorthand
+for writing method contracts.</p><p>Methods and fields listed in an <span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._absent%29%29" class="RktStxLink" data-pltdoc="x">absent</a></span> clause must <span class="emph">not</span> be present in the class.</p><p>A class contract can be specified to be <span class="emph">opaque</span> with the <span class="RktPn">#:opaque</span>
+keyword. An opaque class contract will only accept a class that defines
+exactly the external methods and fields specified by the contract. A contract error
+is raised if the contracted class contains any methods or fields that are
+not specified. Methods or fields with local member names (i.e., defined with
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-local-member-name%29%29" class="RktStxLink" data-pltdoc="x">define-local-member-name</a></span>) are ignored for this check if
+<span class="RktPn">#:ignore-local-member-names</span> is provided.</p><p>The external contracts are as follows:</p><ul><li><p>An external method contract without a tag describes the behavior
+of the implementation of <span class="RktVar">method-id</span> on method sends to an
+object of the contracted class.  This contract will continue to be
+checked in subclasses until the contracted class&rsquo;s implementation is
+no longer the entry point for dynamic dispatch.</p><p>If only the field name is present, this is equivalent to insisting only
+that the method is present in the class.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">draw</span><span class="hspace">&nbsp;</span><span class="RktSym">who</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"reach for the sky, ~a"</span><span class="hspace">&nbsp;</span><span class="RktSym">who</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody+c%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._class%2Fc%29%29" class="RktStxLink" data-pltdoc="x">class/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">draw</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._-~3em%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>m</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">woody%</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">draw</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"reach for the sky, #f"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody+c%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">draw</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">zurg</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"reach for the sky, zurg"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody+c%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">draw</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">draw: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: symbol?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: #f</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">the draw method in</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(class/c (draw (-&gt;m symbol? string?)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition woody+c%)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract on: woody+c%</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:68:0</span></p></td></tr></table></blockquote></div></p></li><li><p>An external field contract, tagged with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span>, describes the
+behavior of the value contained in that field when accessed from outside
+the class.  Since fields may be mutated, these contracts
+are checked on any external access (via <span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._get-field%29%29" class="RktStxLink" data-pltdoc="x">get-field</a></span>)
+and external mutations (via <span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._set-field%21%29%29" class="RktStxLink" data-pltdoc="x">set-field!</a></span>) of the field.</p><p>If only the field name is present, this is equivalent to using the
+contract <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span> (but it is checked more efficiently).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody/hat%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">hat-location</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">uninitialized</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lose-hat</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hat-location</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">lost</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">find-hat</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hat-location</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">on-head</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody/hat+c%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._class%2Fc%29%29" class="RktStxLink" data-pltdoc="x">class/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">draw</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._-~3em%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>m</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">lose-hat</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._-~3em%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>m</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">find-hat</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._-~3em%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>m</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">hat-location</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">on-head</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">lost</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">woody/hat%</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._get-field%29%29" class="RktStxLink" data-pltdoc="x">get-field</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hat-location</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody/hat%</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'uninitialized</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">woody</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody/hat+c%</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody</span><span class="hspace">&nbsp;</span><span class="RktSym">lose-hat</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._get-field%29%29" class="RktStxLink" data-pltdoc="x">get-field</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hat-location</span><span class="hspace">&nbsp;</span><span class="RktSym">woody</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'lost</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._get-field%29%29" class="RktStxLink" data-pltdoc="x">get-field</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hat-location</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody/hat+c%</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">woody/hat+c%: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: (or/c (quote on-head) (quote lost))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: 'uninitialized</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the hat-location field in</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(class/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(draw (-&gt;m symbol? string?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(lose-hat (-&gt;m void?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(find-hat (-&gt;m void?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(field (hat-location</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(or/c 'on-head 'lost))))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition woody/hat+c%)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition woody/hat+c%)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:73:0</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">woody</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody/hat+c%</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._set-field%21%29%29" class="RktStxLink" data-pltdoc="x">set-field!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hat-location</span><span class="hspace">&nbsp;</span><span class="RktSym">woody</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">under-the-dresser</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">woody/hat+c%: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: (or/c (quote on-head) (quote lost))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 'under-the-dresser</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the hat-location field in</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(class/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(draw (-&gt;m symbol? string?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(lose-hat (-&gt;m void?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(find-hat (-&gt;m void?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(field (hat-location</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(or/c 'on-head 'lost))))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition woody/hat+c%)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:73:0</span></p></td></tr></table></blockquote></div></p></li><li><p>An initialization argument contract, tagged with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init%29%29" class="RktStxLink" data-pltdoc="x">init</a></span>,
+describes the expected behavior of the value paired with that name
+during class instantiation.  The same name can be provided more than
+once, in which case the first such contract in the <span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._class%2Fc%29%29" class="RktStxLink" data-pltdoc="x">class/c</a></span>
+form is applied to the first value tagged with that name in the list
+of initialization arguments, and so on.</p><p>If only the initialization argument name is present, this is equivalent to using the
+contract <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span> (but it is checked more efficiently).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody/init-hat%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init%29%29" class="RktStxLink" data-pltdoc="x">init</a></span><span class="hspace">&nbsp;</span><span class="RktSym">init-hat-location</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">hat-location</span><span class="hspace">&nbsp;</span><span class="RktSym">init-hat-location</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lose-hat</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hat-location</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">lost</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">find-hat</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hat-location</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">on-head</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody/init-hat+c%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._class%2Fc%29%29" class="RktStxLink" data-pltdoc="x">class/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">draw</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._-~3em%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>m</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">lose-hat</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._-~3em%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>m</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">find-hat</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._-~3em%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>m</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init%29%29" class="RktStxLink" data-pltdoc="x">init</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">init-hat-location</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">on-head</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">lost</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">hat-location</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">on-head</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">lost</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">woody/init-hat%</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._get-field%29%29" class="RktStxLink" data-pltdoc="x">get-field</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hat-location</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody/init-hat+c%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">init-hat-location</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">lost</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'lost</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._get-field%29%29" class="RktStxLink" data-pltdoc="x">get-field</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hat-location</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody/init-hat+c%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">init-hat-location</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">slinkys-mouth</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">woody/init-hat+c%: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: (or/c (quote on-head) (quote lost))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 'slinkys-mouth</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the init-hat-location init argument in</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(class/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(draw (-&gt;m symbol? string?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(lose-hat (-&gt;m void?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(find-hat (-&gt;m void?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(init (init-hat-location</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(or/c 'on-head 'lost)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(field (hat-location</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(or/c 'on-head 'lost))))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: </span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(definition woody/init-hat+c%)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:79:0</span></p></td></tr></table></blockquote></div></p></li><li><p>The contracts listed in an <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-field%29%29" class="RktStxLink" data-pltdoc="x">init-field</a></span> section are
+treated as if each contract appeared in an <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init%29%29" class="RktStxLink" data-pltdoc="x">init</a></span> section and
+a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span> section.</p></li></ul><p>The internal contracts restrict the behavior of method calls
+made between classes and their subclasses; such calls are not
+controlled by the class contracts described above.</p><p>As with the external contracts, when a method or field name is specified
+ but no contract appears, the contract is satisfied merely with the
+ presence of the corresponding field or method.</p><ul><li><p>A method contract tagged with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span> describes the
+behavior of the method when invoked directly (i.e., via
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span>) in any subclass of the contracted class.  This
+contract, like external method contracts, applies until the
+contracted class&rsquo;s method implementation is no longer the entry point
+for dynamic dispatch.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody+c%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span><span class="hspace">&nbsp;</span><span class="RktSym">draw</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"woody sez: &#8220;~a&#8221;\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">draw</span><span class="hspace">&nbsp;</span><span class="RktVal">"evil dr porkchop"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">woody sez: &#8220;reach for the sky, evil dr porkchop&#8221;</span></p></td></tr><tr><td><p><span class="RktRes">(object:eval:82:0 ...)</span></p></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody+c-inherit%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._class%2Fc%29%29" class="RktStxLink" data-pltdoc="x">class/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">draw</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._-~3em%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>m</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">woody+c%</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody+c-inherit%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span><span class="hspace">&nbsp;</span><span class="RktSym">draw</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"woody sez: ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">draw</span><span class="hspace">&nbsp;</span><span class="RktVal">"evil dr porkchop"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">draw: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: symbol?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: "evil dr porkchop"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">the draw method in</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(class/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(inherit (draw (-&gt;m symbol? string?))))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition woody+c-inherit%)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract on: woody+c-inherit%</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:83:0</span></p></td></tr></table></blockquote></div></p></li><li><p>A method contract tagged with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span> describes the behavior of
+<span class="RktVar">method-id</span> when called by the <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span> form in a
+subclass.  This contract only affects <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span> calls in
+subclasses which call the contract class&rsquo;s implementation of
+<span class="RktVar">method-id</span>.</p><p>This example shows how to extend the <span class="RktSym">draw</span> method
+so that if it is passed two arguments, it combines two
+calls to the original <span class="RktSym">draw</span> method, but with a
+contract the controls how the <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span> methods must
+be invoked.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody%+s</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._class%2Fc%29%29" class="RktStxLink" data-pltdoc="x">class/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">draw</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._-~3em%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>m</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">draw</span><span class="hspace">&nbsp;</span><span class="RktSym">who</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"reach for the sky, ~a"</span><span class="hspace">&nbsp;</span><span class="RktSym">who</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody2+c%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody%+s</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Foverride%29%29" class="RktStxLink" data-pltdoc="x">define/override</a></span><span class="hspace">&nbsp;</span><span class="RktSym">draw</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span><span class="hspace">&nbsp;</span><span class="RktSym">draw</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append%29%29" class="RktValLink" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span><span class="hspace">&nbsp;</span><span class="RktSym">draw</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">" and "</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span><span class="hspace">&nbsp;</span><span class="RktSym">draw</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody2+c%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">draw</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">evil-dr-porkchop</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">zurg</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"reach for the sky, evil-dr-porkchop and reach for the sky, zurg"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody2+c%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">draw</span><span class="hspace">&nbsp;</span><span class="RktVal">"evil dr porkchop"</span><span class="hspace">&nbsp;</span><span class="RktVal">"zurg"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">draw: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: symbol?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: "evil dr porkchop"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">the draw method in</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(class/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(super (draw (-&gt;m symbol? string?))))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition woody%+s)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract on: woody%+s</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:85:0</span></p></td></tr></table></blockquote></div></p><p>The last call signals an error blaming <span class="RktSym">woody2%+c</span> because
+there is no contract checking the initial <span class="RktSym">draw</span> call and
+the super-call violates its contract.</p></li><li><p>A method contract tagged with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inner%29%29" class="RktStxLink" data-pltdoc="x">inner</a></span> describes the
+behavior the class expects of an augmenting method in a subclass.
+This contract affects any implementations of <span class="RktVar">method-id</span> in
+subclasses which can be called via <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inner%29%29" class="RktStxLink" data-pltdoc="x">inner</a></span> from the contracted
+class.  This means a subclass which implements <span class="RktVar">method-id</span> via
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span> or <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="RktStxLink" data-pltdoc="x">overment</a></span> stop future subclasses from
+being affected by the contract, since further extension cannot be
+reached via the contracted class.</p></li><li><p>A method contract tagged with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span> describes the
+behavior expected by the contracted class for <span class="RktVar">method-id</span> when
+called directly (i.e. by the application <span class="RktPn">(</span><span class="RktVar">method-id</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>).
+This form can only be used if overriding the method in subclasses
+will change the entry point to the dynamic dispatch chain (i.e., the
+method has never been augmentable).</p><p>This time, instead of overriding <span class="RktSym">draw</span> to support
+two arguments, we can make a new method, <span class="RktSym">draw2</span> that
+takes the two arguments and calls <span class="RktSym">draw</span>. We also
+add a contract to make sure that overriding <span class="RktSym">draw</span>
+doesn&rsquo;t break <span class="RktSym">draw2</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody2+override/c%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._class%2Fc%29%29" class="RktStxLink" data-pltdoc="x">class/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">draw</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._-~3em%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>m</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody+c%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span><span class="hspace">&nbsp;</span><span class="RktSym">draw</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">draw2</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append%29%29" class="RktValLink" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">draw</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">" and "</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">draw</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody2+broken-draw</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody2+override/c%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Foverride%29%29" class="RktStxLink" data-pltdoc="x">define/override</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">draw</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">not-a-string</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">woody2+broken-draw</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">draw2</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">evil-dr-porkchop</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">zurg</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">draw: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: string?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 'not-a-string</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the range of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">the draw method in</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(class/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(override (draw (-&gt;m symbol? string?))))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: </span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(definition woody2+override/c%)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract on: woody2+override/c%</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:89:0</span></p></td></tr></table></blockquote></div></p></li><li><p>A method contract tagged with either <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span> or
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%29%29" class="RktStxLink" data-pltdoc="x">augride</a></span> describes the behavior provided by the contracted
+class for <span class="RktVar">method-id</span> when called directly from subclasses.
+These forms can only be used if the method has previously been
+augmentable, which means that no augmenting or overriding
+implementation will change the entry point to the dynamic dispatch
+chain.  <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span> is used when subclasses can augment the
+method, and <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%29%29" class="RktStxLink" data-pltdoc="x">augride</a></span> is used when subclasses can override the
+current augmentation.</p></li><li><p>A field contract tagged with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit-field%29%29" class="RktStxLink" data-pltdoc="x">inherit-field</a></span> describes
+the behavior of the value contained in that field when accessed
+directly (i.e., via <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit-field%29%29" class="RktStxLink" data-pltdoc="x">inherit-field</a></span>) in any subclass of the
+contracted class.  Since fields may be mutated, these contracts are
+checked on any access and/or mutation of the field that occurs in
+such subclasses.</p></li><li><p class="SHistory">Changed in version 6.1.1.8 of package <span class="stt">base</span>: Opaque class/c now optionally ignores local
+member names if an additional keyword is supplied.</p></li></ul><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._absent))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._absent%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">absent</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">absent-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._class%2Fc%29%29" class="RktStxLink" data-pltdoc="x">class/c</a></span>; use outside of a <span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._class%2Fc%29%29" class="RktStxLink" data-pltdoc="x">class/c</a></span> form is a syntax error.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/class..rkt)._-~3em))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._-~3em%29%29" class="RktStxDef RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>m</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dom</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">range</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span>, except that the domain of the resulting contract
+contains one more element than the stated domain, where the first
+(implicit) argument is contracted with <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span>.  This contract is
+useful for writing simpler method contracts when no properties of
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this%29%29" class="RktStxLink" data-pltdoc="x">this</a></span> need to be checked.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/class..rkt)._-~3e*m))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._-~3e%2Am%29%29" class="RktStxDef RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*m</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">mandatory-dom</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">optional-dom</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">rest</span><span class="hspace">&nbsp;</span><span class="RktVar">range</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span>, except that the mandatory domain of the
+resulting contract contains one more element than the stated domain,
+where the first (implicit) argument is contracted with
+<span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span>. This contract is useful for writing simpler method
+contracts when no properties of <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this%29%29" class="RktStxLink" data-pltdoc="x">this</a></span> need to be checked.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/class..rkt)._case-~3em))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._case-~3em%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">case-&gt;m</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">-&gt;</span><span class="hspace">&nbsp;</span><span class="RktVar">dom</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">rest</span><span class="hspace">&nbsp;</span><span class="RktVar">range</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._case-~3e%29%29" class="RktStxLink" data-pltdoc="x">case-&gt;</a></span>, except that the mandatory domain of each
+case of the resulting contract contains one more element than the stated
+domain, where the first (implicit) argument is contracted with
+<span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span>. This contract is useful for writing simpler method
+contracts when no properties of <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this%29%29" class="RktStxLink" data-pltdoc="x">this</a></span> need to be checked.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/class..rkt)._-~3edm))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._-~3edm%29%29" class="RktStxDef RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>dm</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">mandatory-dependent-dom</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">optional-dependent-dom</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">dependent-rest</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">pre-cond</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">dep-range</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ed%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span>, except that the mandatory domain of the resulting contract
+contains one more element than the stated domain, where the first (implicit) argument is contracted
+with <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span>. In addition, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this%29%29" class="RktStxLink" data-pltdoc="x">this</a></span> is appropriately bound in the body of the contract.
+This contract is useful for writing simpler method contracts when no properties
+of <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this%29%29" class="RktStxLink" data-pltdoc="x">this</a></span> need to be checked.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/class..rkt)._object/c))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._object%2Fc%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">object/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">member-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">member-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">method-spec</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktVar">field-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">method-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">method-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">method-id</span><span class="hspace">&nbsp;</span><span class="RktVar">method-contract</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">field-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">field-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">field-id</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Produces a contract for an object.</div></p><p>Unlike the older form <span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._object-contract%29%29" class="RktStxLink" data-pltdoc="x">object-contract</a></span>, but like
+<span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._class%2Fc%29%29" class="RktStxLink" data-pltdoc="x">class/c</a></span>, arbitrary contract expressions are allowed.
+Also, method contracts for <span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._object%2Fc%29%29" class="RktStxLink" data-pltdoc="x">object/c</a></span> follow those for
+<span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._class%2Fc%29%29" class="RktStxLink" data-pltdoc="x">class/c</a></span>.  An object wrapped with <span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._object%2Fc%29%29" class="RktStxLink" data-pltdoc="x">object/c</a></span>
+behaves as if its class had been wrapped with the equivalent
+<span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._class%2Fc%29%29" class="RktStxLink" data-pltdoc="x">class/c</a></span> contract.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/class..rkt)._instanceof/c))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._instanceof%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">instanceof/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">class-contract</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">class-contract</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a contract for an object, where the object is an
+instance of a class that conforms to <span class="RktVar">class-contract</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/class..rkt)._dynamic-object/c))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._dynamic-object%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">dynamic-object/c</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">method-names</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">method-contracts</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">field-names</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">field-contracts</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">method-names</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">method-contracts</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">field-names</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">field-contracts</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a contract for an object, similar to <span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._object%2Fc%29%29" class="RktStxLink" data-pltdoc="x">object/c</a></span> but
+where the names and contracts for both methods and fields can be
+computed dynamically. The list of names and contracts for both
+methods and field respectively must have the same lengths.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/class..rkt)._object-contract))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._object-contract%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">object-contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">member-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">member-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">method-id</span><span class="hspace">&nbsp;</span><span class="RktVar">method-contract</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktVar">field-id</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">method-contract</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktVar">dom</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">range</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">mandatory-dom</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">optional-dom</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">rest</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">range</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ed%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">mandatory-dependent-dom</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">optional-dependent-dom</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">dependent-rest</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">pre-cond</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">dep-range</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">dom</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">dom-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktVar">dom-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">range</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">range-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">values</span><span class="hspace">&nbsp;</span><span class="RktVar">range-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">any</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">mandatory-dom</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">dom-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktVar">dom-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">optional-dom</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">dom-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktVar">dom-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">rest</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktVar">rest-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">mandatory-dependent-dom</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">dom-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">dom-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">optional-dependent-dom</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">dom-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">dom-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">dependent-rest</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">rest-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">pre-cond</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:pre-cond</span><span class="hspace">&nbsp;</span><span class="RktVar">boolean-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">dep-range</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">any</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">range-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktVar">post-cond</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">values</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">range-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">post-cond</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">post-cond</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:post-cond</span><span class="hspace">&nbsp;</span><span class="RktVar">boolean-expr</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Produces a contract for an object.</div></p><p>Each of the contracts for a method has the same semantics as
+the corresponding function contract, but the syntax of the
+method contract must be written directly in the body of the
+object-contract&#8212;<wbr></wbr>much like the way that methods in class
+definitions use the same syntax as regular function
+definitions, but cannot be arbitrary procedures.  Unlike the
+method contracts for <span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._class%2Fc%29%29" class="RktStxLink" data-pltdoc="x">class/c</a></span>, the implicit <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this%29%29" class="RktStxLink" data-pltdoc="x">this</a></span>
+argument is not part of the contract.  To allow for the use of
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this%29%29" class="RktStxLink" data-pltdoc="x">this</a></span> in dependent contracts, <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ed%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span> contracts
+implicitly bind <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this%29%29" class="RktStxLink" data-pltdoc="x">this</a></span> to the object itself.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/class..rkt)._mixin-contract))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._mixin-contract%29%29" class="RktValDef RktValLink" data-pltdoc="x">mixin-contract</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="function-contracts.html#%28tech._function._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">function contract</span></a> that recognizes mixins. It guarantees that
+the input to the function is a class and the result of the function is
+a subclass of the input.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/class..rkt)._make-mixin-contract))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._make-mixin-contract%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-mixin-contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">type</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">type</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface~3f%29%29" class="RktValLink" data-pltdoc="x">interface?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a <a href="function-contracts.html#%28tech._function._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">function contract</span></a> that guarantees the input to the
+function is a class that implements/subclasses each <span class="RktVar">type</span>, and
+that the result of the function is a subclass of the input.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/class..rkt)._is-a~3f/c))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._is-a~3f%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">is-a?/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">type</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">type</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface~3f%29%29" class="RktValLink" data-pltdoc="x">interface?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Accepts a class or interface and returns a flat contract that
+recognizes objects that instantiate the class/interface.</div></p><p>See <span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._is-a~3f%29%29" class="RktValLink" data-pltdoc="x">is-a?</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/class..rkt)._implementation~3f/c))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._implementation~3f%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">implementation?/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">interface</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">interface</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface~3f%29%29" class="RktValLink" data-pltdoc="x">interface?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a flat contract that recognizes classes that implement
+<span class="RktVar">interface</span>.</div></p><p>See <span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._implementation~3f%29%29" class="RktValLink" data-pltdoc="x">implementation?</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/class..rkt)._subclass~3f/c))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._subclass~3f%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">subclass?/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">class</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">class</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a flat contract that recognizes classes that
+are subclasses of <span class="RktVar">class</span>.</div></p><p>See <span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._subclass~3f%29%29" class="RktValLink" data-pltdoc="x">subclass?</a></span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="trait.html" title="backward to &quot;6.6 Traits&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="objectequality.html" title="forward to &quot;6.8 Object Equality and Hashing&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Printer_Extension.html b/clones/docs.racket-lang.org/reference/Printer_Extension.html
new file mode 100644
index 00000000..c75806f9
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Printer_Extension.html
@@ -0,0 +1,51 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.8&nbsp;Printer Extension</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewselflink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Printer_Extension.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3acustom-write%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">gen:<span class="mywbr"> &nbsp;</span>custom-<wbr></wbr>write</span></span></a></td></tr><tr><td><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-write%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>custom-<wbr></wbr>write</span></span></a></td></tr><tr><td><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._custom-write~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custom-<wbr></wbr>write?</span></span></a></td></tr><tr><td><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._custom-write-accessor%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custom-<wbr></wbr>write-<wbr></wbr>accessor</span></span></a></td></tr><tr><td><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-print-quotable%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>custom-<wbr></wbr>print-<wbr></wbr>quotable</span></span></a></td></tr><tr><td><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._custom-print-quotable~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custom-<wbr></wbr>print-<wbr></wbr>quotable?</span></span></a></td></tr><tr><td><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._custom-print-quotable-accessor%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custom-<wbr></wbr>print-<wbr></wbr>quotable-<wbr></wbr>accessor</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="special-comments.html" title="backward to &quot;13.7.3 Special Comments&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="serialization.html" title="forward to &quot;13.9 Serialization&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Printer_Extension&quot;">13.8<tt>&nbsp;</tt><a name="(part._.Printer_.Extension)"></a>Printer Extension</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/private/base..rkt)._gen~3acustom-write))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3acustom-write%29%29" class="RktValDef RktValLink" data-pltdoc="x">gen:custom-write</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="struct-generics.html#%28tech._generic._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">generic interface</span></a> (see <a href="struct-generics.html" data-pltdoc="x">Generic Interfaces</a>) that
+supplies a method, <span class="RktSym">write-proc</span> used by the default printer to
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>, <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>, or <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> instances of the
+structure type.</div></p><p>A <span class="RktSym">write-proc</span> method takes three
+arguments: the structure to be printed, the target port, and an
+argument that is <span class="RktVal">#t</span> for <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> mode, <span class="RktVal">#f</span> for
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> mode, or <span class="RktVal">0</span> or <span class="RktVal">1</span> indicating
+the current <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> for <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode.  The
+procedure should print the value to the given port using
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>, <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>, <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>, <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._fprintf%29%29" class="RktValLink" data-pltdoc="x">fprintf</a></span>,
+<span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-special%29%29" class="RktValLink" data-pltdoc="x">write-special</a></span>, etc.</p><p>The <a href="Writing.html#%28tech._port._write._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">port write handler</span></a>, <a href="Writing.html#%28tech._port._display._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">port display handler</span></a>,
+and <a href="eval.html#%28tech._print._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">print handler</span></a> are specially
+configured for a port given to a custom-write procedure. Printing to
+the port through <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>, <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>, or <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>
+prints a value recursively with sharing annotations. To avoid a
+recursive print (i.e., to print without regard to sharing with a value
+currently being printed), print instead to a string or pipe and
+transfer the result to the target port using <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-string%29%29" class="RktValLink" data-pltdoc="x">write-string</a></span> or
+<span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-special%29%29" class="RktValLink" data-pltdoc="x">write-special</a></span>. To print recursively to a port other than
+the one given to the custom-write procedure, copy the given port&rsquo;s
+write handler, display handler, and print handler to the other port.</p><p>The port given to <span class="RktSym">write-proc</span> is not necessarily the actual
+target port. In particular, to detect cycles, sharing, and quoting
+modes (in the case of <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>), the printer invokes a
+custom-write procedure with a port that records information about
+recursive prints, and does not retain any other output. This
+information-gathering phase needs the same objects (in the
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> sense) to be printed as later, so that the recorded
+information can be correlated with printed values.</p><p>Recursive print operations may trigger an escape from a call to
+<span class="RktSym">write-proc</span>. For example, printing may escape during
+pretty-printing where a tentative print attempt overflows the line, or
+it may escape while printing error output that is constrained to a
+limited width.</p><p>The following example definition of a <span class="RktSym">tuple</span> type includes
+a <span class="RktSym">write-proc</span> procedure that prints the tuple&rsquo;s list content using
+angle brackets in <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> and <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode and no brackets in
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> mode. Elements of the tuple are printed recursively,
+so that graph and cycle structure can be represented.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">tuple-print</span><span class="hspace">&nbsp;</span><span class="RktSym">tuple</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktSym">mode</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxLink" data-pltdoc="x">when</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mode</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-string%29%29" class="RktValLink" data-pltdoc="x">write-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"&lt;"</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">tuple-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">tuple</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">recur</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="RktStxLink" data-pltdoc="x">case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mode</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktSym">mode</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._unless%29%29" class="RktStxLink" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="RktValLink" data-pltdoc="x">vector-length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">recur</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._for-each%29%29" class="RktValLink" data-pltdoc="x">for-each</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">e</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-string%29%29" class="RktValLink" data-pltdoc="x">write-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">", "</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">recur</span><span class="hspace">&nbsp;</span><span class="RktSym">e</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-~3elist%29%29" class="RktValLink" data-pltdoc="x">vector-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxLink" data-pltdoc="x">when</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mode</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-string%29%29" class="RktValLink" data-pltdoc="x">write-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"&gt;"</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tuple</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ref</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">gen:custom-write</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">write-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">tuple-print</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">tuple</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">1, 2, a</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">tuple</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">&lt;1, 2, "a"&gt;</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">t</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">tuple</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="RktValLink" data-pltdoc="x">vector-set!</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">tuple-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">#0=&lt;#0#, 2, "a"&gt;</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="structutils.html#%28def._%28%28lib._racket%2Fstruct..rkt%29._make-constructor-style-printer%29%29" class="RktValLink" data-pltdoc="x">make-constructor-style-printer</a></span> function can help in the
+implementation of a <span class="RktSym">write-proc</span>, as in this example:</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/struct</span><span class="RktPn">)</span></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">gen:custom-write</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">write-proc</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="structutils.html#%28def._%28%28lib._racket%2Fstruct..rkt%29._make-constructor-style-printer%29%29" class="RktValLink" data-pltdoc="x">make-constructor-style-printer</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">obj</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">point</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">obj</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point-x</span><span class="hspace">&nbsp;</span><span class="RktSym">obj</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point-y</span><span class="hspace">&nbsp;</span><span class="RktSym">obj</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">(point 1 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">#&lt;point: 1 2&gt;</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._prop~3acustom-write))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-write%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:custom-write</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property</span></a> (see <a href="structprops.html" data-pltdoc="x">Structure Type Properties</a>)
+that supplies a procedure that corresponds to <span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">gen:custom-write</a></span>&rsquo;s
+<span class="RktSym">write-proc</span>. Using the <span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">prop:custom-write</a></span> property is
+discouraged; use the <span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">gen:custom-write</a></span> <a href="struct-generics.html#%28tech._generic._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">generic interface</span></a>
+instead.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._custom-write~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._custom-write~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">custom-write?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> has the <span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">prop:custom-write</a></span>
+property, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._custom-write-accessor))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._custom-write-accessor%29%29" class="RktValDef RktValLink" data-pltdoc="x">custom-write-accessor</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._custom-write~3f%29%29" class="RktValLink" data-pltdoc="x">custom-write?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._custom-write~3f%29%29" class="RktValLink" data-pltdoc="x">custom-write?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the custom-write procedure associated with <span class="RktVar">v</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._prop~3acustom-print-quotable))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-print-quotable%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:custom-print-quotable</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._custom-print-quotable~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._custom-print-quotable~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">custom-print-quotable?</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._custom-print-quotable-accessor))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._custom-print-quotable-accessor%29%29" class="RktValDef RktValLink" data-pltdoc="x">custom-print-quotable-accessor</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A property and associated predicate and accessor. The property value
+is one of <span class="RktVal">'</span><span class="RktVal">self</span>, <span class="RktVal">'</span><span class="RktVal">never</span>, <span class="RktVal">'</span><span class="RktVal">maybe</span>, or
+<span class="RktVal">'</span><span class="RktVal">always</span>. When a structure has this property in addition to a
+<span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">prop:custom-write</a></span> property value, then the property value
+affects printing in <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode; see <a href="printing.html" data-pltdoc="x">The Printer</a>. When
+a value does not have the <span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-print-quotable%29%29" class="RktValLink" data-pltdoc="x">prop:custom-print-quotable</a></span>, it is
+equivalent to having the <span class="RktVal">'</span><span class="RktVal">self</span> property value, which is
+suitable both for self-quoting forms and printed forms that are
+unreadable.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="special-comments.html" title="backward to &quot;13.7.3 Special Comments&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="serialization.html" title="forward to &quot;13.9 Serialization&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Random_generation.html b/clones/docs.racket-lang.org/reference/Random_generation.html
new file mode 100644
index 00000000..a36424dd
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Random_generation.html
@@ -0,0 +1,44 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>8.12&nbsp;Random generation</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.1&nbsp;</td><td><a href="data-structure-contracts.html" class="tocviewlink" data-pltdoc="x">Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.2&nbsp;</td><td><a href="function-contracts.html" class="tocviewlink" data-pltdoc="x">Function Contracts</a></td></tr><tr><td align="right">8.3&nbsp;</td><td><a href="parametric-contracts.html" class="tocviewlink" data-pltdoc="x">Parametric Contracts</a></td></tr><tr><td align="right">8.4&nbsp;</td><td><a href="Lazy_Data-structure_Contracts.html" class="tocviewlink" data-pltdoc="x">Lazy Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.5&nbsp;</td><td><a href="Structure_Type_Property_Contracts.html" class="tocviewlink" data-pltdoc="x">Structure Type Property Contracts</a></td></tr><tr><td align="right">8.6&nbsp;</td><td><a href="attaching-contracts-to-values.html" class="tocviewlink" data-pltdoc="x">Attaching Contracts to Values</a></td></tr><tr><td align="right">8.7&nbsp;</td><td><a href="Building_New_Contract_Combinators.html" class="tocviewlink" data-pltdoc="x">Building New Contract Combinators</a></td></tr><tr><td align="right">8.8&nbsp;</td><td><a href="contract-utilities.html" class="tocviewlink" data-pltdoc="x">Contract Utilities</a></td></tr><tr><td align="right">8.9&nbsp;</td><td><a href="racket_contract_base.html" class="tocviewlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>contract/<span class="mywbr"> &nbsp;</span>base</span></span></a></td></tr><tr><td align="right">8.10&nbsp;</td><td><a href="collapsible.html" class="tocviewlink" data-pltdoc="x">Collapsible Contracts</a></td></tr><tr><td align="right">8.11&nbsp;</td><td><a href="Legacy_Contracts.html" class="tocviewlink" data-pltdoc="x">Legacy Contracts</a></td></tr><tr><td align="right">8.12&nbsp;</td><td><a href="Random_generation.html" class="tocviewselflink" data-pltdoc="x">Random generation</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-<wbr></wbr>random-<wbr></wbr>generate</span></span></a></td></tr><tr><td><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-exercise%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-<wbr></wbr>exercise</span></span></a></td></tr><tr><td><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate%2Fchoose%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-<wbr></wbr>random-<wbr></wbr>generate/<span class="mywbr"> &nbsp;</span>choose</span></span></a></td></tr><tr><td><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-fail%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-<wbr></wbr>random-<wbr></wbr>generate-<wbr></wbr>fail</span></span></a></td></tr><tr><td><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-fail~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-<wbr></wbr>random-<wbr></wbr>generate-<wbr></wbr>fail?</span></span></a></td></tr><tr><td><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-env~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-<wbr></wbr>random-<wbr></wbr>generate-<wbr></wbr>env?</span></span></a></td></tr><tr><td><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-stash%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-<wbr></wbr>random-<wbr></wbr>generate-<wbr></wbr>stash</span></span></a></td></tr><tr><td><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-get-current-environment%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-<wbr></wbr>random-<wbr></wbr>generate-<wbr></wbr>get-<wbr></wbr>current-<wbr></wbr>environment</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Legacy_Contracts.html" title="backward to &quot;8.11 Legacy Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="match.html" title="forward to &quot;9 Pattern Matching&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Random_generation&quot;">8.12<tt>&nbsp;</tt><a name="(part._.Random_generation)"></a>Random generation</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract..rkt)._contract-random-generate))"></a><span title="Provided from: racket/contract, racket | Package: base"><span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate%29%29" class="RktValDef RktValLink" data-pltdoc="x">contract-random-generate</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">ctc</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">fuel</span><span class="hspace">&nbsp;</span><span class="RktVar">fail</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ctc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fuel</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fail</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Attempts to randomly generate a value which will match the contract. The <span class="RktVar">fuel</span>
+argument limits how hard the generator tries to generate a value matching the
+contract and is a rough limit of the size of the resulting value.</div></p><p>The generator may fail to generate a value, either because some contracts
+do not have corresponding generators (for example, not all predicates have
+generators) or because there is not enough fuel. In either case, the
+function <span class="RktVar">fail</span> is invoked. If <span class="RktVar">fail</span> accepts an argument,
+it is called with <span class="RktVal">#t</span> when there is no generator for <span class="RktVar">ctc</span>
+and called with <span class="RktVal">#f</span> when there is a generator, but the generator
+ended up returning <span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-fail%29%29" class="RktValLink" data-pltdoc="x">contract-random-generate-fail</a></span>.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate%29%29" class="RktValLink" data-pltdoc="x">contract-random-generate</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(#f -476814620 -2147483647.0 110.0 540119564.0 -1 #f #f -1886291931.0 168.0)</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.1.1.5 of package <span class="stt">base</span>: Allow <span class="RktVar">fail</span> to accept a boolean.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/contract..rkt)._contract-exercise))"></a><span title="Provided from: racket/contract, racket | Package: base"><span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-exercise%29%29" class="RktValDef RktValLink" data-pltdoc="x">contract-exercise</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:fuel</span><span class="hspace">&nbsp;</span><span class="RktVar">fuel</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:shuffle?</span><span class="hspace">&nbsp;</span><span class="RktVar">shuffle?</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fuel</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">10</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">shuffle?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Attempts to get the <span class="RktVar">val</span>s to break their contracts (if any).</div></p><p>Uses <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._value-contract%29%29" class="RktValLink" data-pltdoc="x">value-contract</a></span> to determine if any of the <span class="RktVar">val</span>s have a
+ contract and, for those that do, uses information about the contract&rsquo;s shape
+ to poke and prod at the value. For example, if the value is function, it will
+ use the contract to tell it what arguments to supply to the value.</p><p>The argument <span class="RktVar">fuel</span> determines how hard <span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-exercise%29%29" class="RktValLink" data-pltdoc="x">contract-exercise</a></span>
+ tries to break the values. It controls both the number of exercise iterations
+ and the size of the intermediate values generated during the exercises.</p><p>The argument <span class="RktVar">shuffle?</span> controls whether <span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-exercise%29%29" class="RktValLink" data-pltdoc="x">contract-exercise</a></span>
+ randomizes the exercise order or not. If <span class="RktVar">shuffle?</span> is not <span class="RktVal">#f</span>,
+ <span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-exercise%29%29" class="RktValLink" data-pltdoc="x">contract-exercise</a></span> would shuffle the order of the contracts in each
+ exercise iteration.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">returns-false</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">does not obey its contract</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-exercise%29%29" class="RktValLink" data-pltdoc="x">contract-exercise</a></span><span class="hspace">&nbsp;</span><span class="RktSym">returns-false</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">returns-false: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: #f</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the range of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; integer? integer?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (function returns-false)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (function returns-false)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">calls-its-argument-with-eleven</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">f returns an integer, but</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">we're supposed to return a boolean</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-exercise%29%29" class="RktValLink" data-pltdoc="x">contract-exercise</a></span><span class="hspace">&nbsp;</span><span class="RktSym">calls-its-argument-with-eleven</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">calls-its-argument-with-eleven: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: boolean?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: 1980102363.0</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the range of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; (-&gt; integer? integer?) boolean?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: </span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(function calls-its-argument-with-eleven)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (function calls-its-argument-with-eleven)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:4:0</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.18 of package <span class="stt">base</span>: Added the <span class="RktVar">shuffle?</span> optional argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract..rkt)._contract-random-generate/choose))"></a><span title="Provided from: racket/contract, racket | Package: base"><span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate%2Fchoose%29%29" class="RktValDef RktValLink" data-pltdoc="x">contract-random-generate/choose</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span><span class="RktVar">fuel</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fuel</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">This function is like <span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate%29%29" class="RktValLink" data-pltdoc="x">contract-random-generate</a></span>, but it is intended to
+  be used with combinators that generate values based on sub-contracts
+  they have. It must be called when <span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate%29%29" class="RktValLink" data-pltdoc="x">contract-random-generate</a></span>
+  (and <span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-exercise%29%29" class="RktValLink" data-pltdoc="x">contract-exercise</a></span>) creates the generators.
+  To be more precise, <span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate%2Fchoose%29%29" class="RktValLink" data-pltdoc="x">contract-random-generate/choose</a></span> is available
+  only for the <span class="RktVar">generate</span> and <span class="RktVar">exercise</span> arguments in
+  <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._build-contract-property%29%29" class="RktValLink" data-pltdoc="x">build-contract-property</a></span>, <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._build-chaperone-contract-property%29%29" class="RktValLink" data-pltdoc="x">build-chaperone-contract-property</a></span>
+  or <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._build-flat-contract-property%29%29" class="RktValLink" data-pltdoc="x">build-flat-contract-property</a></span> and only during the dynamic
+  extent of the call to <span class="RktVar">generate</span> (and <span class="RktVar">exercise</span>).
+  That is, after it receives the <span class="RktVar">c</span> and <span class="RktVar">fuel</span> arguments
+  and before it returns the thunk (or the exerciser).</div></p><p><span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate%2Fchoose%29%29" class="RktValLink" data-pltdoc="x">contract-random-generate/choose</a></span> will never fail,
+  but it might escape back to an enclosing
+  call or to the original call to <span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate%29%29" class="RktValLink" data-pltdoc="x">contract-random-generate</a></span>.</p><p>It chooses one of several possible generation strategies, and thus it may not
+  actually use the generator associated with <span class="RktVar">c</span>, but might instead
+  use a stashed value that matches <span class="RktVar">c</span> that it knows about via
+  <span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-stash%29%29" class="RktValLink" data-pltdoc="x">contract-random-generate-stash</a></span>.</p><p class="SHistory">Added in version 6.1.1.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/contract..rkt)._contract-random-generate-fail))"></a><span title="Provided from: racket/contract, racket | Package: base"><span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-fail%29%29" class="RktValDef RktValLink" data-pltdoc="x">contract-random-generate-fail</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-fail~3f%29%29" class="RktValLink" data-pltdoc="x">contract-random-generate-fail?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">An atomic value that is used to indicate that a generator
+  failed to generate a value.</div></p><p class="SHistory">Added in version 6.1.1.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract..rkt)._contract-random-generate-fail~3f))"></a><span title="Provided from: racket/contract, racket | Package: base"><span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-fail~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">contract-random-generate-fail?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A predicate to recognize <span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-fail%29%29" class="RktValLink" data-pltdoc="x">contract-random-generate-fail</a></span>.</div></p><p class="SHistory">Added in version 6.1.1.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract..rkt)._contract-random-generate-env~3f))"></a><span title="Provided from: racket/contract, racket | Package: base"><span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-env~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">contract-random-generate-env?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Recognizes contract generation environments.</div></p><p class="SHistory">Added in version 6.1.1.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract..rkt)._contract-random-generate-stash))"></a><span title="Provided from: racket/contract, racket | Package: base"><span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-stash%29%29" class="RktValDef RktValLink" data-pltdoc="x">contract-random-generate-stash</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">env</span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">env</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-env~3f%29%29" class="RktValLink" data-pltdoc="x">contract-random-generate-env?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVar">c</span></td></tr></table></blockquote></div><div class="SIntrapara">This should be called with values that the program under
+  test supplies during contract generation. For example, when
+  <span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span> is generated,
+  it may call its argument function. That argument function may
+  return an integer and, if so, that integer should be saved by
+  calling <span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-stash%29%29" class="RktValLink" data-pltdoc="x">contract-random-generate-stash</a></span>, so it can
+  be used by other integer generators.</div></p><p class="SHistory">Added in version 6.1.1.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract..rkt)._contract-random-generate-get-current-environment))"></a><span title="Provided from: racket/contract, racket | Package: base"><span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-get-current-environment%29%29" class="RktValDef RktValLink" data-pltdoc="x">contract-random-generate-get-current-environment</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-env~3f%29%29" class="RktValLink" data-pltdoc="x">contract-random-generate-env?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the environment currently being for generation. This function
+  can be called only during the dynamic extent of contract generation.
+  It is intended to be grabbed during the construction of a contract
+  generator and then used with <span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-stash%29%29" class="RktValLink" data-pltdoc="x">contract-random-generate-stash</a></span>
+  while generation is happening.</div></p><p class="SHistory">Added in version 6.1.1.5 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Legacy_Contracts.html" title="backward to &quot;8.11 Legacy Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="match.html" title="forward to &quot;9 Pattern Matching&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Reader_Extension.html b/clones/docs.racket-lang.org/reference/Reader_Extension.html
new file mode 100644
index 00000000..23c667a7
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Reader_Extension.html
@@ -0,0 +1,10 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.7&nbsp;Reader Extension</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewselflink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewselflink" data-pltdoc="x">Reader Extension</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.7.1&nbsp;</td><td><a href="readtables.html" class="tocviewlink" data-pltdoc="x">Readtables</a></td></tr><tr><td align="right">13.7.2&nbsp;</td><td><a href="reader-procs.html" class="tocviewlink" data-pltdoc="x">Reader-<wbr></wbr>Extension Procedures</a></td></tr><tr><td align="right">13.7.3&nbsp;</td><td><a href="special-comments.html" class="tocviewlink" data-pltdoc="x">Special Comments</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="pretty-print.html" title="backward to &quot;13.6 Pretty Printing&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="readtables.html" title="forward to &quot;13.7.1 Readtables&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Reader_Extension&quot;">13.7<tt>&nbsp;</tt><a name="(part._.Reader_.Extension)"></a>Reader Extension</h4><p>Racket&rsquo;s reader can be extended in three ways: through a reader-macro
+procedure in a <a href="readtables.html#%28tech._readtable%29" class="techoutside" data-pltdoc="x"><span class="techinside">readtable</span></a> (see <a href="readtables.html" data-pltdoc="x">Readtables</a>), through a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#reader</span><span class="hspace"></span></span> form (see <a href="reader.html#%28part._parse-reader%29" data-pltdoc="x">Reading via an Extension</a>), or through a
+custom-port byte reader that returns a &ldquo;special&rdquo; result procedure
+(see <a href="customport.html" data-pltdoc="x">Custom Ports</a>). All three kinds of <a name="(tech._reader._extension._procedure)"></a><span style="font-style: italic">reader
+extension procedures</span> accept similar arguments, and their results are
+treated in the same way by <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> and <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> (or,
+more precisely, by the default read handler; see
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._port-read-handler%29%29" class="RktValLink" data-pltdoc="x">port-read-handler</a></span>).</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="readtables.html" class="toclink" data-pltdoc="x">13.7.1<span class="hspace">&nbsp;</span>Readtables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="reader-procs.html" class="toclink" data-pltdoc="x">13.7.2<span class="hspace">&nbsp;</span>Reader-Extension Procedures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="special-comments.html" class="toclink" data-pltdoc="x">13.7.3<span class="hspace">&nbsp;</span>Special Comments</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="pretty-print.html" title="backward to &quot;13.6 Pretty Printing&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="readtables.html" title="forward to &quot;13.7.1 Readtables&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Reading.html b/clones/docs.racket-lang.org/reference/Reading.html
new file mode 100644
index 00000000..06220ea3
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Reading.html
@@ -0,0 +1,185 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.4&nbsp;Reading</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewselflink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%2Frecursive%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read/<span class="mywbr"> &nbsp;</span>recursive</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%2Frecursive%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>syntax/<span class="mywbr"> &nbsp;</span>recursive</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-language%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>language</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-case-sensitive%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>case-<wbr></wbr>sensitive</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-square-bracket-as-paren%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>square-<wbr></wbr>bracket-<wbr></wbr>as-<wbr></wbr>paren</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-curly-brace-as-paren%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>curly-<wbr></wbr>brace-<wbr></wbr>as-<wbr></wbr>paren</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-square-bracket-with-tag%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>square-<wbr></wbr>bracket-<wbr></wbr>with-<wbr></wbr>tag</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-curly-brace-with-tag%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>curly-<wbr></wbr>brace-<wbr></wbr>with-<wbr></wbr>tag</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-box%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>accept-<wbr></wbr>box</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-compiled%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>accept-<wbr></wbr>compiled</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-bar-quote%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>accept-<wbr></wbr>bar-<wbr></wbr>quote</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-graph%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>accept-<wbr></wbr>graph</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax-accept-graph%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>syntax-<wbr></wbr>accept-<wbr></wbr>graph</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-decimal-as-inexact%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>decimal-<wbr></wbr>as-<wbr></wbr>inexact</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-single-flonum%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>single-<wbr></wbr>flonum</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-dot%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>accept-<wbr></wbr>dot</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-infix-dot%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>accept-<wbr></wbr>infix-<wbr></wbr>dot</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-cdot%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>cdot</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-quasiquote%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>accept-<wbr></wbr>quasiquote</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-reader%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>accept-<wbr></wbr>reader</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-lang%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>accept-<wbr></wbr>lang</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-readtable%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>readtable</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._call-with-default-reading-parameterization%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>default-<wbr></wbr>reading-<wbr></wbr>parameterization</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-reader-guard%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>reader-<wbr></wbr>guard</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-on-demand-source%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>on-<wbr></wbr>demand-<wbr></wbr>source</span></span></a></td></tr><tr><td><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._port-read-handler%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>read-<wbr></wbr>handler</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Byte_and_String_Output.html" title="backward to &quot;13.3 Byte and String Output&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Writing.html" title="forward to &quot;13.5 Writing&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Reading&quot;">13.4<tt>&nbsp;</tt><a name="(part._.Reading)"></a>Reading</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValDef RktValLink" data-pltdoc="x">read</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Reads and returns a single <a href="reader.html#%28tech._datum%29" class="techoutside" data-pltdoc="x"><span class="techinside">datum</span></a> from <span class="RktVar">in</span>. If
+<span class="RktVar">in</span> has a handler associated to it via
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._port-read-handler%29%29" class="RktValLink" data-pltdoc="x">port-read-handler</a></span>, then the handler is called. Otherwise, the
+default reader is used, as parameterized by the
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-readtable%29%29" class="RktValLink" data-pltdoc="x">current-readtable</a></span> parameter, as well as many other
+parameters.</div></p><p>See <a href="reader.html" data-pltdoc="x">The Reader</a> for information on the default reader and
+<a href="reader.html#%28part._parse-reader%29" data-pltdoc="x">Reading via an Extension</a> for the protocol of <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-syntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">source-name</span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">source-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>, but produces a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> with
+source-location information. The <span class="RktVar">source-name</span> is used as the
+source field of the syntax object; it can be an arbitrary value, but
+it should generally be a path for the source file.</div></p><p>See <a href="reader.html" data-pltdoc="x">The Reader</a> for information on the default reader in
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode and <a href="reader.html#%28part._parse-reader%29" data-pltdoc="x">Reading via an Extension</a> for
+the protocol of <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span>See also <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=stx-obj.html&amp;version=8.6" class="Sq" data-pltdoc="x">Syntax Objects</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a>.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read/recursive))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%2Frecursive%29%29" class="RktValDef RktValLink" data-pltdoc="x">read/recursive</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">readtable</span><span class="hspace">&nbsp;</span><span class="RktVar">graph?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">readtable</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._readtable~3f%29%29" class="RktValLink" data-pltdoc="x">readtable?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-readtable%29%29" class="RktValLink" data-pltdoc="x">current-readtable</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">graph?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to calling <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>, but normally used during the dynamic
+extent of <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> within a reader-extension procedure (see
+<a href="reader-procs.html" data-pltdoc="x">Reader-Extension Procedures</a>). The main effect of using
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read/recursive</a></span> instead of <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> is that
+graph-structure annotations (see <a href="reader.html#%28part._parse-graph%29" data-pltdoc="x">Reading Graph Structure</a>) in the
+nested read are considered part of the overall read, at least when the
+<span class="RktVar">graph?</span> argument is true; since the result is wrapped in a
+placeholder, however, it is not directly inspectable.</div></p><p>If <span class="RktVar">start</span> is provided and not <span class="RktVal">#f</span>, it is effectively
+prefixed to the beginning of <span class="RktVar">in</span>&rsquo;s stream for the read. (To
+prefix multiple characters, use <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._input-port-append%29%29" class="RktValLink" data-pltdoc="x">input-port-append</a></span>.)</p><p>The <span class="RktVar">readtable</span> argument is used for top-level parsing to
+satisfy the read request, including various delimiters of a built-in
+top-level form (such as parentheses and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> for reading a hash
+table); recursive parsing within the read (e.g., to
+read the elements of a list) instead uses the current readtable as
+determined by the <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-readtable%29%29" class="RktValLink" data-pltdoc="x">current-readtable</a></span> parameter.  A reader
+macro might call <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read/recursive</a></span> with a character and
+readtable to effectively invoke the readtable&rsquo;s behavior for the
+character.  If <span class="RktVar">readtable</span> is <span class="RktVal">#f</span>, the default
+readtable is used for top-level parsing.</p><p>When <span class="RktVar">graph?</span> is <span class="RktVal">#f</span>, graph structure annotations in
+the read datum are local to the datum.</p><p>When called within the dynamic extent of <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>, the
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read/recursive</a></span> procedure can produce a special-comment value
+(see <a href="special-comments.html" data-pltdoc="x">Special Comments</a>) when the input stream&rsquo;s first
+non-whitespace content parses as a comment.</p><p>See <a href="readtables.html" data-pltdoc="x">Readtables</a> for an extended example that uses
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read/recursive</a></span>.</p><p class="SHistory">Changed in version 6.2 of package <span class="stt">base</span>: Adjusted use of <span class="RktVar">readtable</span> to
+more consistently apply to the delimiters of
+a built-in form.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-syntax/recursive))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%2Frecursive%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-syntax/recursive</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">source-name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">readtable</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">graph?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">source-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">readtable</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._readtable~3f%29%29" class="RktValLink" data-pltdoc="x">readtable?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-readtable%29%29" class="RktValLink" data-pltdoc="x">current-readtable</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">graph?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Analogous to calling <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read/recursive</a></span>, but the resulting value
+encapsulates S-expression structure with source-location
+information. As with <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read/recursive</a></span>, when
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read-syntax/recursive</a></span> is used within the dynamic extent of
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>, the result from
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read-syntax/recursive</a></span> is either a special-comment value,
+end-of-file, or opaque graph-structure placeholder (not a syntax
+object). The placeholder can be embedded in an S-expression or syntax
+object returned by a reader macro, etc., and it will be replaced with
+the actual syntax object before the outermost <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>
+returns.</div></p><p>Using <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read/recursive</a></span> within the dynamic extent of
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> does not allow graph structure for reading to be
+included in the outer <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> parsing, and neither does
+using <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read-syntax/recursive</a></span> within the dynamic extent of
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>. In those cases, <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read/recursive</a></span> and
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read-syntax/recursive</a></span> produce results like <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> and
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>, except that a special-comment value is returned
+when the input stream starts with a comment (after whitespace).</p><p>See <a href="readtables.html" data-pltdoc="x">Readtables</a> for an extended example that uses
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read-syntax/recursive</a></span>.</p><p class="SHistory">Changed in version 6.2 of package <span class="stt">base</span>: Adjusted use of <span class="RktVar">readtable</span>
+in the same way as for
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read/recursive</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-language))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-language%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-language</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktVar">fail-thunk</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fail-thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Reads from <span class="RktVar">in</span> in the same way as <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>, but stopping as
+soon as a <a href="Reading.html#%28tech._reader._language%29" class="techoutside" data-pltdoc="x"><span class="techinside">reader language</span></a> (or its absence) is determined, and
+using the <a href="syntax-model.html#%28tech._current._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">current namespace</span></a> to load a reader module instead
+of its <a href="Namespaces.html#%28tech._root._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">root namespace</span></a> (if those are different).</div></p><p>A <a name="(tech._reader._language)"></a><span style="font-style: italic">reader language</span> is specified by <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span> or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!</span><span class="hspace"></span></span> (see <a href="reader.html#%28part._parse-reader%29" data-pltdoc="x">Reading via an Extension</a>) at the beginning of the
+input, though possibly after comment forms. The default
+<a href="readtables.html#%28tech._readtable%29" class="techoutside" data-pltdoc="x"><span class="techinside">readtable</span></a> is used by <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-language%29%29" class="RktValLink" data-pltdoc="x">read-language</a></span> (instead of the
+value of <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-readtable%29%29" class="RktValLink" data-pltdoc="x">current-readtable</a></span>), and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#reader</span><span class="hspace"></span></span> forms
+(which might produce comments) are not allowed before <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span>
+or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!</span><span class="hspace"></span></span>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span>See also <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=language-get-info.html&amp;version=8.6" class="Sq" data-pltdoc="x">Source-Handling Configuration</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a>.</p></blockquote></blockquote></blockquote><p>When it finds a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!</span><span class="hspace"></span></span> specification, instead
+of dispatching to a <span class="RktSym">read</span> or <span class="RktSym">read-syntax</span>
+function as <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> and <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> do,
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-language%29%29" class="RktValLink" data-pltdoc="x">read-language</a></span> dispatches to the <span class="RktSym">get-info</span>
+function (if any) exported by the same module. The arguments to
+<span class="RktSym">get-info</span> are the same as for <span class="RktSym">read</span>
+as described in <a href="reader.html#%28part._parse-reader%29" data-pltdoc="x">Reading via an Extension</a>. The result of the
+<span class="RktSym">get-info</span> function is the result of
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-language%29%29" class="RktValLink" data-pltdoc="x">read-language</a></span> if it is a function of two arguments; if
+<span class="RktSym">get-info</span> produces any other kind of result, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. If no <span class="RktSym">get-info</span> function is
+exported, <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-language%29%29" class="RktValLink" data-pltdoc="x">read-language</a></span> returns <span class="RktVal">#f</span>.</p><p><div class="SIntrapara">The function produced by <span class="RktSym">get-info</span> reflects information
+about the expected syntax of the input stream. The first argument to the
+function serves as a key on such information; acceptable keys and the
+interpretation of results is up to external tools, such as DrRacket (see
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?tag=%28part._%28.%27%28lib._scribblings%2Ftools%2Ftools..scrbl%29.%27._.%27lang-languages-customization.%27%29%29&amp;version=8.6" class="Sq" data-pltdoc="x">the DrRacket documentation</a>).
+If no information is available for a given key, the result should be
+the second argument.
+</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">scribble-manual-info</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-language%29%29" class="RktValLink" data-pltdoc="x">read-language</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"#lang scribble/manual"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">scribble-manual-info</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">color-lexer</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;procedure:scribble-inside-lexer&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">scribble-manual-info</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">something-else</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p></div></p><p>The <span class="RktSym">get-info</span> function itself is applied to five
+arguments: the input port being read, the module path from which the
+<span class="RktSym">get-info</span> function was extracted, and the source line
+(positive exact integer or <span class="RktVal">#f</span>), column (non-negative exact
+integer or <span class="RktVal">#f</span>), and position (positive exact integer or
+<span class="RktVal">#f</span>) of the start of the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!</span><span class="hspace"></span></span>
+form. The <span class="RktSym">get-info</span> function may further read from the
+given input port to determine its result, but it should read no
+further than necessary. The <span class="RktSym">get-info</span> function should
+not read from the port after returning a function.</p><p>If <span class="RktVar">in</span> starts with a <a href="Reading.html#%28tech._reader._language%29" class="techoutside" data-pltdoc="x"><span class="techinside">reader language</span></a> specification but
+the relevant module does not export <span class="RktSym">get-info</span> (but
+perhaps does export <span class="RktSym">read</span> and
+<span class="RktSym">read-syntax</span>), then the result of <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-language%29%29" class="RktValLink" data-pltdoc="x">read-language</a></span>
+is <span class="RktVal">#f</span>.</p><p>If <span class="RktVar">in</span> has a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!</span><span class="hspace"></span></span> specification,
+but parsing and resolving the specification raises an exception, the
+exception is propagated by <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-language%29%29" class="RktValLink" data-pltdoc="x">read-language</a></span>. Having at least
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#l</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!</span><span class="hspace"></span></span> (after comments and whitespace) counts as
+starting a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!</span><span class="hspace"></span></span> specification.</p><p>If <span class="RktVar">in</span> does not specify a <a href="Reading.html#%28tech._reader._language%29" class="techoutside" data-pltdoc="x"><span class="techinside">reader language</span></a> with
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!</span><span class="hspace"></span></span>, then <span class="RktVar">fail-thunk</span> is
+called. The default <span class="RktVar">fail-thunk</span> raises
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span> or <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread~3aeof%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read:eof</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-case-sensitive))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-case-sensitive%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-case-sensitive</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-case-sensitive%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-case-sensitive</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls parsing and printing of symbols. When this
+parameter&rsquo;s value is <span class="RktVal">#f</span>, the reader case-folds symbols (e.g.,
+producing <span class="RktVal">'</span><span class="RktVal">hi</span> when the input is any one of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">hi</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">Hi</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">HI</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">hI</span><span class="hspace"></span></span>). The parameter also
+affects the way that <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> prints symbols containing
+uppercase characters; if the parameter&rsquo;s value is <span class="RktVal">#f</span>, then
+symbols are printed with uppercase characters quoted by a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span>. The parameter&rsquo;s value is overridden by
+quoting <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span> vertical-bar quotes and the
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#cs</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#ci</span><span class="hspace"></span></span> prefixes; see
+<a href="reader.html#%28part._parse-symbol%29" data-pltdoc="x">Reading Symbols</a> for more information. While a module is
+loaded, the parameter is set to <span class="RktVal">#t</span> (see
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load%29%29" class="RktValLink" data-pltdoc="x">current-load</a></span>).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-square-bracket-as-paren))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-square-bracket-as-paren%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-square-bracket-as-paren</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-square-bracket-as-paren%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-square-bracket-as-paren</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls whether <span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span>
+are treated as parentheses. See <a href="reader.html#%28part._parse-pair%29" data-pltdoc="x">Reading Pairs and Lists</a> for more
+information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-curly-brace-as-paren))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-curly-brace-as-paren%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-curly-brace-as-paren</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-curly-brace-as-paren%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-curly-brace-as-paren</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls whether <span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span>
+are treated as parentheses. See <a href="reader.html#%28part._parse-pair%29" data-pltdoc="x">Reading Pairs and Lists</a> for more
+information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-square-bracket-with-tag))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-square-bracket-with-tag%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-square-bracket-with-tag</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-square-bracket-with-tag%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-square-bracket-with-tag</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls whether <span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span>
+are treated as parentheses, but the resulting list tagged with
+<span class="RktSym">#%brackets</span>. See <a href="reader.html#%28part._parse-pair%29" data-pltdoc="x">Reading Pairs and Lists</a> for more information.</div></p><p class="SHistory">Added in version 6.3.0.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-curly-brace-with-tag))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-curly-brace-with-tag%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-curly-brace-with-tag</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-curly-brace-with-tag%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-curly-brace-with-tag</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls whether <span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span> and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span> are treated as parentheses, but the resulting list
+tagged with <span class="RktSym">#%braces</span>. See <a href="reader.html#%28part._parse-pair%29" data-pltdoc="x">Reading Pairs and Lists</a> for more
+information.</div></p><p class="SHistory">Added in version 6.3.0.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-accept-box))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-box%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-accept-box</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-box%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-accept-box</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls parsing <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&amp;</span><span class="hspace"></span></span> input. See
+<a href="reader.html#%28part._parse-box%29" data-pltdoc="x">Reading Boxes</a> for more information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-accept-compiled))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-compiled%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-accept-compiled</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-compiled%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-accept-compiled</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls parsing <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#~</span><span class="hspace"></span></span> compiled input. See
+<a href="reader.html" data-pltdoc="x">The Reader</a> and <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile%29%29" class="RktValLink" data-pltdoc="x">current-compile</a></span> for more
+information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-accept-bar-quote))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-bar-quote%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-accept-bar-quote</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-bar-quote%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-accept-bar-quote</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls parsing and printing of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span> in
+symbols. See <a href="reader.html#%28part._parse-symbol%29" data-pltdoc="x">Reading Symbols</a> and <a href="printing.html" data-pltdoc="x">The Printer</a> for
+more information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-accept-graph))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-graph%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-accept-graph</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-graph%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-accept-graph</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A parameter value that controls parsing input with sharing in
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> mode. See <a href="reader.html#%28part._parse-graph%29" data-pltdoc="x">Reading Graph Structure</a> for more information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-syntax-accept-graph))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax-accept-graph%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-syntax-accept-graph</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax-accept-graph%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-syntax-accept-graph</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A parameter value that controls parsing input with sharing in
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode. See <a href="reader.html#%28part._parse-graph%29" data-pltdoc="x">Reading Graph Structure</a> for more information.</div></p><p class="SHistory">Added in version 8.4.0.8 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-decimal-as-inexact))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-decimal-as-inexact%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-decimal-as-inexact</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-decimal-as-inexact%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-decimal-as-inexact</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls parsing input numbers with a decimal point
+or exponent (but no explicit exactness tag). See
+<a href="reader.html#%28part._parse-number%29" data-pltdoc="x">Reading Numbers</a> for more information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-single-flonum))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-single-flonum%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-single-flonum</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-single-flonum%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-single-flonum</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls parsing input numbers that have a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">f</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">F</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">s</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">S</span><span class="hspace"></span></span> precision
+character. See <a href="reader.html#%28part._parse-number%29" data-pltdoc="x">Reading Numbers</a> for more information.</div></p><p class="SHistory">Added in version 7.3.0.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-accept-dot))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-dot%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-accept-dot</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-dot%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-accept-dot</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls parsing input with a dot, which is normally
+used for literal cons cells. See <a href="reader.html#%28part._parse-pair%29" data-pltdoc="x">Reading Pairs and Lists</a> for more
+information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-accept-infix-dot))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-infix-dot%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-accept-infix-dot</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-infix-dot%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-accept-infix-dot</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls parsing input with two dots to trigger infix
+ conversion. See <a href="reader.html#%28part._parse-pair%29" data-pltdoc="x">Reading Pairs and Lists</a> for more information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-cdot))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-cdot%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-cdot</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-cdot%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-cdot</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls parsing input with a dot, in a C
+structure accessor style. See <a href="reader.html#%28part._parse-cdot%29" data-pltdoc="x">Reading with C-style Infix-Dot Notation</a> for more
+information.</div></p><p class="SHistory">Added in version 6.3.0.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-accept-quasiquote))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-quasiquote%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-accept-quasiquote</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-quasiquote%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-accept-quasiquote</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls parsing input with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">`</span><span class="hspace"></span></span> or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">,</span><span class="hspace"></span></span> which is normally used for <span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span>,
+<span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote%29%29" class="RktStxLink" data-pltdoc="x">unquote</a></span>, and <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxLink" data-pltdoc="x">unquote-splicing</a></span> abbreviations. See
+<a href="reader.html#%28part._parse-quote%29" data-pltdoc="x">Reading Quotes</a> for more information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-accept-reader))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-reader%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-accept-reader</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-reader%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-accept-reader</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls whether <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#reader</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span>,
+or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!</span><span class="hspace"></span></span> are allowed for selecting a parser. See
+<a href="reader.html#%28part._parse-reader%29" data-pltdoc="x">Reading via an Extension</a> for more information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-accept-lang))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-lang%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-accept-lang</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-lang%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-accept-lang</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that (along with <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-reader%29%29" class="RktValLink" data-pltdoc="x">read-accept-reader</a></span>) controls
+whether <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!</span><span class="hspace"></span></span> are allowed for selecting a
+parser. See <a href="reader.html#%28part._parse-reader%29" data-pltdoc="x">Reading via an Extension</a> for more information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-readtable))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-readtable%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-readtable</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._readtable~3f%29%29" class="RktValLink" data-pltdoc="x">readtable?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-readtable%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-readtable</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">readtable</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">readtable</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._readtable~3f%29%29" class="RktValLink" data-pltdoc="x">readtable?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A parameter whose value determines a readtable that
+adjusts the parsing of S-expression input, where <span class="RktVal">#f</span> implies the
+default behavior. See <a href="readtables.html" data-pltdoc="x">Readtables</a> for more information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._call-with-default-reading-parameterization))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._call-with-default-reading-parameterization%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-default-reading-parameterization</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thunk</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Calls <span class="RktVar">thunk</span> in <a href="eval-model.html#%28tech._tail._position%29" class="techoutside" data-pltdoc="x"><span class="techinside">tail position</span></a> of a <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>
+to set all reader <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameters</span></a> above to their default values.</div></p><p>Using the default parameter values ensures consistency, and it also
+provides safety when reading from untrusted sources, since the default
+values disable evaluation of arbitrary code via <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a> or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#reader</span><span class="hspace"></span></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-reader-guard))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-reader-guard%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-reader-guard</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-reader-guard%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-reader-guard</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A parameter whose value converts or rejects (by raising an exception)
+a module-path datum following <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#reader</span><span class="hspace"></span></span>. See
+<a href="reader.html#%28part._parse-reader%29" data-pltdoc="x">Reading via an Extension</a> for more information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-on-demand-source))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-on-demand-source%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-on-demand-source</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-on-demand-source%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-on-demand-source</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">mode</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that enables lazy parsing of compiled code, so that
+closure bodies and syntax objects are extracted (and validated) from
+marshaled compiled code on demand. Normally, this parameter is set by
+the default <a href="eval.html#%28tech._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">load handler</span></a> when <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load-on-demand-enabled%29%29" class="RktValLink" data-pltdoc="x">load-on-demand-enabled</a></span>
+is <span class="RktVal">#t</span>.</div></p><p>A <span class="RktVal">#f</span> value for <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-on-demand-source%29%29" class="RktValLink" data-pltdoc="x">read-on-demand-source</a></span> disables lazy
+parsing of compiled code. A <span class="RktVal">#t</span> value enables lazy parsing.  A
+<a href="pathutils.html#%28tech._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">path</span></a> value furthers enable lazy retrieval from disk&#8212;<wbr></wbr>instead
+of keeping unparsed compiled code in memory&#8212;<wbr></wbr>when the
+<a name="(idx._(gentag._268._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_DELAY_FROM_ZO</span> environment variable is set (to
+any value) on start-up.</p><p>If the file at <span class="RktVar">mode</span> as a <a href="pathutils.html#%28tech._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">path</span></a> changes before the
+delayed code is parsed when lazy retrieval from disk is enabled, then
+the on-demand parse most likely will encounter garbage, leading to an
+exception.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._port-read-handler))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._port-read-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-read-handler</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._case-~3e%29%29" class="RktStxLink" data-pltdoc="x">case-&gt;</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._port-read-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-read-handler</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._case-~3e%29%29" class="RktStxLink" data-pltdoc="x">case-&gt;</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Gets or sets the <a name="(tech._port._read._handler)"></a><span style="font-style: italic">port read handler</span> for <span class="RktVar">in</span>. The
+handler called to read from the port when the built-in <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>
+or <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> procedure is applied to the port. (The
+port read handler is not used for <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read/recursive</a></span> or
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read-syntax/recursive</a></span>.)</div></p><p>A port read handler is applied to either one argument or two
+arguments:</p><ul><li><p>A single argument is supplied when the port is used
+with <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>; the argument is the port being read. The return
+value is the value that was read from the port (or end-of-file).</p></li><li><p>Two arguments are supplied when the port is used with
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>; the first argument is the port being read, and
+the second argument is a value indicating the source. The return
+value is a syntax object that was read from the port (or end-of-file).</p></li></ul><p>The default port read handler reads standard Racket expressions with
+Racket&rsquo;s built-in parser (see <a href="reader.html" data-pltdoc="x">The Reader</a>). It handles a
+special result from a custom input port (see
+<span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-input-port%29%29" class="RktValLink" data-pltdoc="x">make-input-port</a></span>) by treating it as a single expression,
+except that special-comment values (see
+<a href="special-comments.html" data-pltdoc="x">Special Comments</a>) are treated as whitespace.</p><p>The default port read handler itself can be customized through a
+readtable; see <a href="readtables.html" data-pltdoc="x">Readtables</a> for more information.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Byte_and_String_Output.html" title="backward to &quot;13.3 Byte and String Output&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Writing.html" title="forward to &quot;13.5 Writing&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Sandboxed_Evaluation.html b/clones/docs.racket-lang.org/reference/Sandboxed_Evaluation.html
new file mode 100644
index 00000000..403b9bed
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Sandboxed_Evaluation.html
@@ -0,0 +1,511 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14.12&nbsp;Sandboxed Evaluation</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewselflink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Namespaces.html" class="tocviewlink" data-pltdoc="x">Namespaces</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="eval.html" class="tocviewlink" data-pltdoc="x">Evaluation and Compilation</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="load-lang.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>load</span></span> Language</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="Module_Names_and_Loading.html" class="tocviewlink" data-pltdoc="x">Module Names and Loading</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="chaperones.html" class="tocviewlink" data-pltdoc="x">Impersonators and Chaperones</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="securityguards.html" class="tocviewlink" data-pltdoc="x">Security Guards</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="custodians.html" class="tocviewlink" data-pltdoc="x">Custodians</a></td></tr><tr><td align="right">14.8&nbsp;</td><td><a href="threadgroups.html" class="tocviewlink" data-pltdoc="x">Thread Groups</a></td></tr><tr><td align="right">14.9&nbsp;</td><td><a href="inspectors.html" class="tocviewlink" data-pltdoc="x">Structure Inspectors</a></td></tr><tr><td align="right">14.10&nbsp;</td><td><a href="modprotect.html" class="tocviewlink" data-pltdoc="x">Code Inspectors</a></td></tr><tr><td align="right">14.11&nbsp;</td><td><a href="plumbers.html" class="tocviewlink" data-pltdoc="x">Plumbers</a></td></tr><tr><td align="right">14.12&nbsp;</td><td><a href="Sandboxed_Evaluation.html" class="tocviewselflink" data-pltdoc="x">Sandboxed Evaluation</a></td></tr><tr><td align="right">14.13&nbsp;</td><td><a href="repl-module.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>repl</span></span> Library</a></td></tr><tr><td align="right">14.14&nbsp;</td><td><a href="linklets.html" class="tocviewlink" data-pltdoc="x">Linklets and the Core Compiler</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>14.12&nbsp;</td><td><a href="Sandboxed_Evaluation.html" class="tocviewselflink" data-pltdoc="x">Sandboxed Evaluation</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.12.1&nbsp;</td><td><a href="Sandboxed_Evaluation.html#%28part._.Security_.Considerations%29" class="tocviewlink" data-pltdoc="x">Security Considerations</a></td></tr><tr><td align="right">14.12.2&nbsp;</td><td><a href="Sandboxed_Evaluation.html#%28part._.Customizing_.Evaluators%29" class="tocviewlink" data-pltdoc="x">Customizing Evaluators</a></td></tr><tr><td align="right">14.12.3&nbsp;</td><td><a href="Sandboxed_Evaluation.html#%28part._.Interacting_with_.Evaluators%29" class="tocviewlink" data-pltdoc="x">Interacting with Evaluators</a></td></tr><tr><td align="right">14.12.4&nbsp;</td><td><a href="Sandboxed_Evaluation.html#%28part._.Miscellaneous%29" class="tocviewlink" data-pltdoc="x">Miscellaneous</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-evaluator%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>evaluator</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-module-evaluator%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>module-<wbr></wbr>evaluator</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._exn~3afail~3asandbox-terminated~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>sandbox-<wbr></wbr>terminated?</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._exn~3afail~3asandbox-terminated-reason%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>sandbox-<wbr></wbr>terminated-<wbr></wbr>reason</span></span></a></td></tr><tr><td><span class="tocsublinknumber">14.12.1<tt>&nbsp;</tt></span><a href="Sandboxed_Evaluation.html#%28part._.Security_.Considerations%29" class="tocsubseclink" data-pltdoc="x">Security Considerations</a></td></tr><tr><td><span class="tocsublinknumber">14.12.2<tt>&nbsp;</tt></span><a href="Sandboxed_Evaluation.html#%28part._.Customizing_.Evaluators%29" class="tocsubseclink" data-pltdoc="x">Customizing Evaluators</a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-trusted-sandbox-configuration%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>trusted-<wbr></wbr>sandbox-<wbr></wbr>configuration</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-init-hook%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>init-<wbr></wbr>hook</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-reader%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>reader</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-input%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>input</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-output%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>output</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-error-output%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>error-<wbr></wbr>output</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-coverage-enabled%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>coverage-<wbr></wbr>enabled</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-propagate-breaks%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>propagate-<wbr></wbr>breaks</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-propagate-exceptions%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>propagate-<wbr></wbr>exceptions</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-namespace-specs%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>namespace-<wbr></wbr>specs</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-namespace%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>make-<wbr></wbr>namespace</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-gui-available%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>gui-<wbr></wbr>available</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-override-collection-paths%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>override-<wbr></wbr>collection-<wbr></wbr>paths</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-security-guard%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>security-<wbr></wbr>guard</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-path-permissions%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>path-<wbr></wbr>permissions</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-network-guard%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>network-<wbr></wbr>guard</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-exit-handler%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>exit-<wbr></wbr>handler</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-memory-limit%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>memory-<wbr></wbr>limit</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-eval-limits%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>eval-<wbr></wbr>limits</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-eval-handlers%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>eval-<wbr></wbr>handlers</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-run-submodules%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>run-<wbr></wbr>submodules</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-inspector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>make-<wbr></wbr>inspector</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-code-inspector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>make-<wbr></wbr>code-<wbr></wbr>inspector</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-logger%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>make-<wbr></wbr>logger</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-plumber%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>make-<wbr></wbr>plumber</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-environment-variables%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-<wbr></wbr>make-<wbr></wbr>environment-<wbr></wbr>variables</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._default-language-readers%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">default-<wbr></wbr>language-<wbr></wbr>readers</span></span></a></td></tr><tr><td><span class="tocsublinknumber">14.12.3<tt>&nbsp;</tt></span><a href="Sandboxed_Evaluation.html#%28part._.Interacting_with_.Evaluators%29" class="tocsubseclink" data-pltdoc="x">Interacting with Evaluators</a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._evaluator-alive~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">evaluator-<wbr></wbr>alive?</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._kill-evaluator%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">kill-<wbr></wbr>evaluator</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._break-evaluator%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">break-<wbr></wbr>evaluator</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._get-user-custodian%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get-<wbr></wbr>user-<wbr></wbr>custodian</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._set-eval-limits%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>eval-<wbr></wbr>limits</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._set-eval-handler%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>eval-<wbr></wbr>handler</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-custodian-shutdown%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>custodian-<wbr></wbr>shutdown</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-killing-threads%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>killing-<wbr></wbr>threads</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._put-input%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">put-<wbr></wbr>input</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._get-output%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get-<wbr></wbr>output</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._get-error-output%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get-<wbr></wbr>error-<wbr></wbr>output</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._get-uncovered-expressions%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get-<wbr></wbr>uncovered-<wbr></wbr>expressions</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-in-sandbox-context%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>in-<wbr></wbr>sandbox-<wbr></wbr>context</span></span></a></td></tr><tr><td><span class="tocsublinknumber">14.12.4<tt>&nbsp;</tt></span><a href="Sandboxed_Evaluation.html#%28part._.Miscellaneous%29" class="tocsubseclink" data-pltdoc="x">Miscellaneous</a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._gui~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">gui?</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-limits%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>limits</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28form._%28%28lib._racket%2Fsandbox..rkt%29._with-limits%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>limits</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-deep-time-limit%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>deep-<wbr></wbr>time-<wbr></wbr>limit</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28form._%28%28lib._racket%2Fsandbox..rkt%29._with-deep-time-limit%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>deep-<wbr></wbr>time-<wbr></wbr>limit</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._exn~3afail~3aresource~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>resource?</span></span></a></td></tr><tr><td><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._exn~3afail~3aresource-resource%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>resource-<wbr></wbr>resource</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="plumbers.html" title="backward to &quot;14.11 Plumbers&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="repl-module.html" title="forward to &quot;14.13 The racket/repl Library&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Sandboxed_Evaluation&quot;">14.12<tt>&nbsp;</tt><a name="(part._.Sandboxed_.Evaluation)"></a><a name="(mod-path._racket/sandbox)"></a>Sandboxed Evaluation</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="Sandboxed_Evaluation.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/sandbox</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/sandbox-lib" title="Install this package using `raco pkg install sandbox-lib`"><span class="stt">sandbox-lib</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="Sandboxed_Evaluation.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/sandbox</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p>The <a href="Sandboxed_Evaluation.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/sandbox</span></a> module provides utilities for
+creating &ldquo;sandboxed&rdquo; evaluators, which are configured in a
+particular way and can have restricted resources (memory and time),
+filesystem and network access, and much more.  Sandboxed evaluators can be
+configured through numerous parameters &#8212;<wbr></wbr> and the defaults are set
+for the common use case where sandboxes are very limited.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top" colspan="3"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._make-evaluator))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-evaluator%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-evaluator</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">language</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input-program</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:requires</span><span class="hspace">&nbsp;</span><span class="RktVar">requires</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:allow-for-require</span><span class="hspace">&nbsp;</span><span class="RktVar">allow-for-require</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:allow-for-load</span><span class="hspace">&nbsp;</span><span class="RktVar">allow-for-load</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:allow-read</span><span class="hspace">&nbsp;</span><span class="RktVar">allow-read</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:allow-syntactic-requires</span><span class="hspace">&nbsp;</span><span class="RktVar">allow-syntactic-requires</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">language</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">special</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">begin</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input-program</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">requires</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">for-syntax</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">allow-for-require</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">allow-for-load</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">allow-read</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">allow-syntactic-requires</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top" colspan="3"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._make-module-evaluator))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-module-evaluator%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-module-evaluator</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">module-decl</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:language</span><span class="hspace">&nbsp;</span><span class="RktVar">lang</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:readers</span><span class="hspace">&nbsp;</span><span class="RktVar">readers</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:allow-for-require</span><span class="hspace">&nbsp;</span><span class="RktVar">allow-for-require</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:allow-for-load</span><span class="hspace">&nbsp;</span><span class="RktVar">allow-for-load</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:allow-read</span><span class="hspace">&nbsp;</span><span class="RktVar">allow-read</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:allow-syntactic-requires</span><span class="hspace">&nbsp;</span><span class="RktVar">allow-syntactic-requires</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">module-decl</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lang</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">readers</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktVar">lang</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._default-language-readers%29%29" class="RktValLink" data-pltdoc="x">default-language-readers</a></span><span class="hspace">&nbsp;</span><span class="RktVar">lang</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">allow-for-require</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">allow-for-load</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">allow-read</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">allow-syntactic-requires</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-evaluator</a></span> function creates an evaluator with a
+<span class="RktVar">language</span> and <span class="RktVar">requires</span> specification, and starts
+evaluating the given <span class="RktVar">input-program</span>s. The
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-module-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-module-evaluator</a></span> function creates an evaluator that
+works in the context of a given module. The result in either case is a
+function for further evaluation.</div></p><p>The returned evaluator operates in an isolated and limited
+environment. In particular, filesystem access is restricted, which may
+interfere with using modules from the filesystem that are not
+in a <a href="collects.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection</span></a>.  See below for
+information on the <span class="RktVar">allow-for-require</span>,
+<span class="RktVar">allow-for-load</span>, and <span class="RktVar">allow-read</span> arguments; collection-based
+module files typically do not need to be included in those lists.  When
+<span class="RktVar">language</span> is a module path or when <span class="RktVar">requires</span> is
+provided, the indicated modules are implicitly included in the
+<span class="RktVar">allow-for-require</span> list. When <span class="RktVar">allow-syntactic-requires</span>
+is not <span class="RktVal">#f</span>, it constraints the set of modules that can be directly
+referenced in a module; see below for more information.
+(For backward compatibility,
+non-<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span> path strings are allowed in arguments like
+<span class="RktVar">requires</span>; they are implicitly converted to paths before
+addition to <span class="RktVar">allow-for-require</span>.)</p><p>Each <span class="RktVar">input-program</span> or <span class="RktVar">module-decl</span> argument provides
+a program in one of the following forms:</p><ul><li><p>an input port used to read the program;</p></li><li><p>a string or a byte string holding the complete input;</p></li><li><p>a path that names a file holding the input; or</p></li><li><p>an S-expression or a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>, which is evaluated
+as with <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span> (see also
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._get-uncovered-expressions%29%29" class="RktValLink" data-pltdoc="x">get-uncovered-expressions</a></span>).</p></li></ul><p>In the first three cases above, the program is read using
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-reader%29%29" class="RktValLink" data-pltdoc="x">sandbox-reader</a></span>, with line-counting enabled for sensible error
+messages, and with <span class="RktVal">'</span><span class="RktVal">program</span> as the source (used for testing
+coverage).  In the last case, the input is expected to be the complete
+program, and is converted to a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> (using
+<span class="RktVal">'</span><span class="RktVal">program</span> as the source), unless it already is a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax
+object</span></a>.</p><p>The returned evaluator function accepts additional expressions
+(each time it is called) in essentially the same form: a string or
+byte string holding a sequence of expressions, a path for a file
+holding expressions, an S-expression, or a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>.  If
+the evaluator receives an <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> value, it is terminated and
+raises errors thereafter.  See also <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._kill-evaluator%29%29" class="RktValLink" data-pltdoc="x">kill-evaluator</a></span>, which
+terminates the evaluator without raising an exception.</p><p>For <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-evaluator</a></span>, multiple <span class="RktVar">input-program</span>s are
+effectively concatenated to form a single program. The way that the
+<span class="RktVar">input-program</span>s are evaluated depends on the <span class="RktVar">language</span>
+argument:</p><ul><li><p>The <span class="RktVar">language</span> argument can be a module path (i.e., a
+datum that matches the grammar for <span class="RktVar">module-path</span> of
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>).</p><p>In this case, the <span class="RktVar">input-program</span>s are automatically
+wrapped in a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>, and the resulting evaluator works
+within the resulting module&rsquo;s namespace.</p></li><li><p>The <span class="RktVar">language</span> argument can be a list starting with
+<span class="RktVal">'</span><span class="RktVal">special</span>, which indicates a built-in language with
+special input configuration. The possible values are
+<span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">special</span><span class="stt"> </span><span class="RktVal">r5rs</span><span class="RktVal">)</span> or a value indicating a teaching
+language: <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">special</span><span class="stt"> </span><span class="RktVal">beginner</span><span class="RktVal">)</span>, <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">special</span><span class="stt"> </span><span class="RktVal">beginner-abbr</span><span class="RktVal">)</span>, <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">special</span><span class="stt"> </span><span class="RktVal">intermediate</span><span class="RktVal">)</span>,
+<span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">special</span><span class="stt"> </span><span class="RktVal">intermediate-lambda</span><span class="RktVal">)</span>, or <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">special</span><span class="stt"> </span><span class="RktVal">advanced</span><span class="RktVal">)</span>.</p><p>In this case, the <span class="RktVar">input-program</span>s are automatically
+wrapped in a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>, and the resulting evaluator works
+within the resulting module&rsquo;s namespace. In addition, certain
+parameters (such as such as <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-infix-dot%29%29" class="RktValLink" data-pltdoc="x">read-accept-infix-dot</a></span>) are
+set to customize reading programs from strings and ports.</p><p>This option is provided mainly for older test systems. Using
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-module-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-module-evaluator</a></span> with input starting with
+<span class="RktMod">#lang</span> is generally better.</p></li><li><p>Finally, <span class="RktVar">language</span> can be a list whose first element is
+<span class="RktVal">'</span><span class="RktVal">begin</span>.</p><p>In this case, a new namespace is created using
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-namespace-specs%29%29" class="RktValLink" data-pltdoc="x">sandbox-namespace-specs</a></span>, which by default creates a
+new namespace using <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-namespace%29%29" class="RktValLink" data-pltdoc="x">sandbox-make-namespace</a></span> (which, in
+turn, uses <span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-base-namespace%29%29" class="RktValLink" data-pltdoc="x">make-base-namespace</a></span> or
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=Windowing_Functions.html%23%2528def._%2528%2528lib._racket%252Fgui%252Fbase..rkt%2529._make-gui-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-gui-namespace</a></span> depending on
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-gui-available%29%29" class="RktValLink" data-pltdoc="x">sandbox-gui-available</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=Dynamic_Loading.html%23%2528def._%2528%2528lib._racket%252Fgui%252Fdynamic..rkt%2529._gui-available%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">gui-available?</a></span>).</p><p>In the new namespace, <span class="RktVar">language</span> is evaluated as an
+expression to further initialize the namespace.</p></li></ul><p>The <span class="RktVar">requires</span> list adds additional imports to the module or
+namespace for the <span class="RktVar">input-program</span>s, even in the case that
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> is not made available through the <span class="RktVar">language</span>.
+The <span class="RktVar">allow-syntactic-requires</span> argument, if non-<span class="RktVal">#f</span>,
+constrains <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> references expanded in the module when the
+<span class="RktVar">language</span> argument implies a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> wrapper; more
+precisely, it constrains the module paths that can be resolved when a
+syntax object is provided to the <a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name resolver</span></a>, which
+will include <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> forms that are created by macro
+expansion. A relative-submodule path using <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxLink" data-pltdoc="x">submod</a></span> followed by
+either <span class="RktVal">"."</span> or <span class="RktVal">".."</span> is always allowed.</p><p>The following examples illustrate the difference between an evaluator
+that puts the program in a module and one that merely initializes a
+top-level namespace:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">base-module-eval</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">a module cannot have free variables...</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-evaluator</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racket/base</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">define</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">f</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">later</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">program:1:0: later: unbound identifier</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: later</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">base-module-eval</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-evaluator</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racket/base</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">define</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">f</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">later</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">define</span><span class="hspace">&nbsp;</span><span class="RktVal">later</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">base-module-eval</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">f</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">base-top-eval</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">non-module code can have free variables:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-evaluator</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">begin</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">define</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">f</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">later</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">base-top-eval</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">+</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">base-top-eval</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">define</span><span class="hspace">&nbsp;</span><span class="RktVal">later</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">base-top-eval</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">f</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-module-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-module-evaluator</a></span> function is essentially a
+restriction of <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-evaluator</a></span>, where the program must be a
+module, and all imports are part of the program.  In some cases it is
+useful to restrict the program to be a module using a specific module
+in its language position; use the optional <span class="RktVar">lang</span> argument
+to specify such a restriction, where <span class="RktVal">#f</span> means that no
+restriction is enforced. The <span class="RktVar">readers</span> argument similarly
+constrains the paths that can follow <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a> or <span class="RktMeta">#reader</span>
+if it is not <span class="RktVal">#f</span>, and the default is based on <span class="RktVar">lang</span>.
+The <span class="RktVar">allow-syntactic-requires</span> argument is treated the same as
+for <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-evaluator</a></span> in the module-wrapper case.</p><p>When the program is specified as a path, then
+the path is implicitly added to the <span class="RktVar">allow-for-load</span> list.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">base-module-eval2</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">equivalent to </span><span class="RktSym">base-module-eval</span><span class="RktCmt">:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-module-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-module-evaluator</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">module</span><span class="hspace">&nbsp;</span><span class="RktVal">m</span><span class="hspace">&nbsp;</span><span class="RktVal">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">(</span><span class="RktVal">define</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">f</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">later</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">(</span><span class="RktVal">define</span><span class="hspace">&nbsp;</span><span class="RktVal">later</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-module-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-module-evaluator</a></span> function can be convenient for testing
+module files: pass in a path value for the file
+name, and you get back an evaluator in the module&rsquo;s context which you
+can use with your favorite test facility.</p><p><div class="SIntrapara">In all cases, the evaluator operates in an isolated and limited
+environment:
+</div><div class="SIntrapara"><ul><li><p>It uses a new custodian and namespace. When
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=Dynamic_Loading.html%23%2528def._%2528%2528lib._racket%252Fgui%252Fdynamic..rkt%2529._gui-available%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">gui-available?</a></span> and <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-gui-available%29%29" class="RktValLink" data-pltdoc="x">sandbox-gui-available</a></span> produce
+true, it is also runs in its own eventspace.</p></li><li><p>The evaluator works under the <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-security-guard%29%29" class="RktValLink" data-pltdoc="x">sandbox-security-guard</a></span>,
+which restricts file system and network access.</p></li><li><p>The evaluator is contained in a memory-restricted environment,
+and each evaluation is wrapped in a <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-limits%29%29" class="RktValLink" data-pltdoc="x">call-with-limits</a></span>
+(when memory accounting is available); see also
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-memory-limit%29%29" class="RktValLink" data-pltdoc="x">sandbox-memory-limit</a></span>, <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-eval-limits%29%29" class="RktValLink" data-pltdoc="x">sandbox-eval-limits</a></span> and
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._set-eval-limits%29%29" class="RktValLink" data-pltdoc="x">set-eval-limits</a></span>.</p></li></ul></div><div class="SIntrapara">Note that these limits apply to the creation of the sandbox
+environment too &#8212;<wbr></wbr> so, for example, if the memory that is required to
+create the sandbox is higher than the limit, then
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-evaluator</a></span> will fail with a memory limit exception.</div></p><p>The <span class="RktVar">allow-for-require</span> and <span class="RktVar">allow-for-load</span> arguments
+adjust filesystem permissions to extend the set of files that
+are usable by the evaluator. Modules that are in a collection
+are automatically accessible, but the <span class="RktVar">allow-for-require</span> argument lists
+additional modules that can be <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>d along with their imports
+(transitively) through a filesystem path. The <span class="RktVar">allow-for-load</span> argument
+similarly lists files that can
+be <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%29%29" class="RktValLink" data-pltdoc="x">load</a></span>ed. (The precise permissions needed for
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> versus <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%29%29" class="RktValLink" data-pltdoc="x">load</a></span> can differ.)  The
+<span class="RktVar">allow-read</span> argument is for backward compatibility, only; each
+<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span> element of <span class="RktVar">allow-read</span> is effectively
+moved to <span class="RktVar">allow-for-require</span>, while other elements are moved to
+<span class="RktVar">allow-for-load</span>.</p><p><div class="SIntrapara">The sandboxed environment is well isolated, and the evaluator function
+essentially sends it an expression and waits for a result.  This form
+of communication makes it impossible to have nested (or concurrent)
+calls to a single evaluator.  Usually this is not a problem, but in
+some cases you can get the evaluator function available inside the
+sandboxed code, for example:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">e</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-evaluator</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racket/base</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">e</span><span class="hspace">&nbsp;</span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktRdr">,</span><span class="RktSym">e</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">evaluator: nested evaluator call with: 1</span></p></td></tr></table></blockquote></div><div class="SIntrapara">An error will be signaled in such cases.</div></p><p>If the value of <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-propagate-exceptions%29%29" class="RktValLink" data-pltdoc="x">sandbox-propagate-exceptions</a></span> is true (the
+default) when the sandbox is created, then exceptions (both syntax and
+run-time) are propagated as usual to the caller of the evaluation
+function (i.e., catch them with <span class="RktSym"><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%29%29" class="RktStxLink" data-pltdoc="x">with-handlers</a></span>). See below
+for a caveat about using raised exceptions directly. If the value
+of <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-propagate-exceptions%29%29" class="RktValLink" data-pltdoc="x">sandbox-propagate-exceptions</a></span> is <span class="RktVal">#f</span> when the
+sandbox is created, then uncaught exceptions in a sandbox evaluation
+cause the error to be printed to the sandbox&rsquo;s error port, and the
+caller of the evaluation receives <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</p><p>Take care when using a value returned from a sandbox or raised as an
+exception by a sandbox. The value might by an impersonator, or it
+might be a structure whose structure type redirects equality
+comparisons or printing operations. To safely handle an unknown value
+produced by a sandbox, manipulate it within the sandbox, possibly
+using <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-in-sandbox-context%29%29" class="RktValLink" data-pltdoc="x">call-in-sandbox-context</a></span>.</p><p>An evaluator can be used only by one thread at a time, and detected
+concurrent use triggers an exception. Beware of using an evaluator in
+a non-main thread, because the default value of
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-plumber%29%29" class="RktValLink" data-pltdoc="x">sandbox-make-plumber</a></span> registers a callback in the current
+plumber to flush the evaluator&rsquo;s plumber, and that means a flush of
+the current plumber (such as when the Racket process is about to exit)
+implies a use of the evaluator.</p><p class="SHistory">Changed in version 1.2 of package <span class="stt">sandbox-lib</span>: Added the <span class="RktPn">#:readers</span> and
+<span class="RktPn">#:allow-syntactic-require</span> arguments.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._exn~3afail~3asandbox-terminated~3f))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._exn~3afail~3asandbox-terminated~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:sandbox-terminated?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._exn~3afail~3asandbox-terminated-reason))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._exn~3afail~3asandbox-terminated-reason%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:sandbox-terminated-reason</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">exn</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">exn</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._exn~3afail~3asandbox-terminated~3f%29%29" class="RktValLink" data-pltdoc="x">exn:fail:sandbox-terminated?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A predicate and accessor for exceptions that are raised when a sandbox
+is terminated.  Once a sandbox raises such an exception, it will
+continue to raise it on further evaluation attempts.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Security_Considerations&quot;">14.12.1<tt>&nbsp;</tt><a name="(part._.Security_.Considerations)"></a>Security Considerations</h5><p>Although the sandbox is designed to provide a safe environment for executing
+Racket programs with restricted access to system resources, executing untrusted
+programs in a sandbox still carries some risk. Because a malicious program can
+exercise arbitrary functionality from the Racket runtime and installed collections,
+an attacker who identifies a vulnerability in Racket or an installed collection
+may be able to escape the sandbox.</p><p><div class="SIntrapara">To mitigate this risk, programs that use the sandbox should employ additional
+precautions when possible. Suggested measures include:
+</div><div class="SIntrapara"><ul><li><p>Supplying a custom module language to <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-evaluator</a></span> or
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-module-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-module-evaluator</a></span> that gives untrusted code access to only
+the language constructs it absolutely requires.</p></li><li><p>If untrusted code needs access to installed collections, installing only
+the collections required by your program.</p></li><li><p>Using operating-system-level security features to provide defense-in-depth
+in case the process running the sandbox is compromised.</p></li><li><p>Making sure your Racket installation and installed packages are up-to-date
+with the latest release.</p></li></ul></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Customizing_Evaluators&quot;">14.12.2<tt>&nbsp;</tt><a name="(part._.Customizing_.Evaluators)"></a>Customizing Evaluators</h5><p>The sandboxed evaluators that <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-evaluator</a></span> creates can be
+customized via many parameters.  Most of the configuration parameters
+affect newly created evaluators; changing them has no effect on
+already-running evaluators.</p><p>The default configuration options are set for a very restricted
+sandboxed environment &#8212;<wbr></wbr> one that is safe to make publicly available.
+Further customizations might be needed in case more privileges are
+needed, or if you want tighter restrictions.  Another useful approach
+for customizing an evaluator is to begin with a relatively
+unrestricted configuration and add the desired restrictions.  This approach is made
+possible by the <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-trusted-sandbox-configuration%29%29" class="RktValLink" data-pltdoc="x">call-with-trusted-sandbox-configuration</a></span>
+function.</p><p>The sandbox environment uses two notions of restricting the time that
+evaluations takes: <a href="Sandboxed_Evaluation.html#%28tech._shallow._time%29" class="techoutside" data-pltdoc="x"><span class="techinside">shallow time</span></a> and <a href="Sandboxed_Evaluation.html#%28tech._deep._time%29" class="techoutside" data-pltdoc="x"><span class="techinside">deep
+time</span></a>. <a name="(tech._shallow._time)"></a><span style="font-style: italic">Shallow time</span> refers to the immediate execution of an
+expression. For example, a <a href="Sandboxed_Evaluation.html#%28tech._shallow._time%29" class="techoutside" data-pltdoc="x"><span class="techinside">shallow time</span></a> limit of five seconds
+would restrict <span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._sleep%29%29" class="RktValLink" data-pltdoc="x">sleep</a></span><span class="stt"> </span><span class="RktVal">6</span><span class="RktPn">)</span> and other computations that take
+longer than five seconds. <a name="(tech._deep._time)"></a><span style="font-style: italic">Deep time</span> refers to the total
+execution of the expression and all threads and sub-processes that the
+expression creates. For example, a <a href="Sandboxed_Evaluation.html#%28tech._deep._time%29" class="techoutside" data-pltdoc="x"><span class="techinside">deep time</span></a> limit of five
+seconds would restrict <span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._sleep%29%29" class="RktValLink" data-pltdoc="x">sleep</a></span><span class="stt"> </span><span class="RktVal">6</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>, which
+<a href="Sandboxed_Evaluation.html#%28tech._shallow._time%29" class="techoutside" data-pltdoc="x"><span class="techinside">shallow time</span></a> would not, <span class="emph">as well as</span> all expressions that
+<a href="Sandboxed_Evaluation.html#%28tech._shallow._time%29" class="techoutside" data-pltdoc="x"><span class="techinside">shallow time</span></a> would restrict. By default, most sandboxes only
+restrict <a href="Sandboxed_Evaluation.html#%28tech._shallow._time%29" class="techoutside" data-pltdoc="x"><span class="techinside">shallow time</span></a> to facilitate expressions that use
+threads.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._call-with-trusted-sandbox-configuration))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-trusted-sandbox-configuration%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-trusted-sandbox-configuration</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thunk</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Invokes the <span class="RktVar">thunk</span> in a context where sandbox configuration
+parameters are set for minimal restrictions.  More specifically, there
+are no memory or time limits, and the existing existing <a href="inspectors.html#%28tech._inspector%29" class="techoutside" data-pltdoc="x"><span class="techinside">inspectors</span></a>,
+<a href="securityguards.html#%28tech._security._guard%29" class="techoutside" data-pltdoc="x"><span class="techinside">security guard</span></a>, <a href="Exiting.html#%28tech._exit._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">exit handler</span></a>, <a href="logging.html#%28tech._logger%29" class="techoutside" data-pltdoc="x"><span class="techinside">logger</span></a>, <a href="plumbers.html#%28tech._plumber%29" class="techoutside" data-pltdoc="x"><span class="techinside">plumber</span></a>, and
+<a href="envvars.html#%28tech._environment._variable._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">environment variable set</span></a> are used.  (Note that the I/O
+ports settings are not included.)</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-init-hook))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-init-hook%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-init-hook</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-init-hook%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-init-hook</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thunk</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines a thunk to be called for initializing a
+new evaluator.  The hook is called just before the program is
+evaluated in a newly-created evaluator context.  It can be used to
+setup environment parameters related to reading, writing, evaluation,
+and so on.  Certain languages (<span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">special</span><span class="stt"> </span><span class="RktVal">r5rs</span><span class="RktVal">)</span> and the
+teaching languages) have initializations specific to the language; the
+hook is used after that initialization, so it can override settings.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-reader))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-reader%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-reader</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-reader%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-reader</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that specifies a function that reads all expressions from
+<span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span>.  The function is used to read program
+source for an evaluator when a string, byte string, or port is
+supplied.  The reader function receives a value to be used as input
+source (i.e., the first argument to <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>), and it
+should return a list of <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax objects</span></a>.  The default reader
+calls <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>, accumulating results in a list until it
+receives <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>.</div></p><p>Note that the reader function is usually called as is, but when it is
+used to read the program input for <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-module-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-module-evaluator</a></span>,
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-lang%29%29" class="RktValLink" data-pltdoc="x">read-accept-lang</a></span> and <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-reader%29%29" class="RktValLink" data-pltdoc="x">read-accept-reader</a></span> are set to
+<span class="RktVal">#t</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-input))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-input%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-input</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">pipe</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-input%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-input</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">pipe</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the initial <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span>
+setting for a newly created evaluator. It defaults to <span class="RktVal">#f</span>,
+which creates an empty port.  The following other values are allowed:</div></p><ul><li><p>a string or byte string, which is converted to a port using
+<span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span> or <span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-bytes%29%29" class="RktValLink" data-pltdoc="x">open-input-bytes</a></span>;</p></li><li><p>an input port;</p></li><li><p>the symbol <span class="RktVal">'</span><span class="RktVal">pipe</span>, which triggers the creation of a
+pipe, where <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._put-input%29%29" class="RktValLink" data-pltdoc="x">put-input</a></span> can return the output end of the
+pipe or write directly to it;</p></li><li><p>a thunk, which is called to obtain a port (e.g., using
+<span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span> means that the evaluator input is
+the same as the calling context&rsquo;s input).</p></li></ul><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-output))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-output%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-output</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">pipe</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">bytes</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">string</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-output%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-output</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">pipe</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">bytes</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">string</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the initial <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span>
+setting for a newly created evaluator. It defaults to <span class="RktVal">#f</span>,
+which creates a port that discards all data.  The following other
+values are allowed:</div></p><ul><li><p>an output port, which is used as-is;</p></li><li><p>the symbol <span class="RktVal">'</span><span class="RktVal">bytes</span>, which causes <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._get-output%29%29" class="RktValLink" data-pltdoc="x">get-output</a></span> to
+return the complete output as a byte string as long as the
+evaluator has not yet terminated (so that the size of the bytes
+can be charged to the evaluator);</p></li><li><p>the symbol <span class="RktVal">'</span><span class="RktVal">string</span>, which is similar to
+<span class="RktVal">'</span><span class="RktVal">bytes</span>, but makes <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._get-output%29%29" class="RktValLink" data-pltdoc="x">get-output</a></span> produce a
+string;</p></li><li><p>the symbol <span class="RktVal">'</span><span class="RktVal">pipe</span>, which triggers the creation of a
+pipe, where <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._get-output%29%29" class="RktValLink" data-pltdoc="x">get-output</a></span> returns the input end of the
+pipe;</p></li><li><p>a thunk, which is called to obtain a port (e.g., using
+<span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span> means that the evaluator output is
+not diverted).</p></li></ul><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-error-output))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-error-output%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-error-output</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">pipe</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">bytes</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">string</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-error-output%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-error-output</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">pipe</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">bytes</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">string</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-output%29%29" class="RktValLink" data-pltdoc="x">sandbox-output</a></span>, but for the initial
+<span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-error-port%29%29" class="RktValLink" data-pltdoc="x">current-error-port</a></span> value. An evaluator&rsquo;s error output is set
+after its output, so using <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span> (the parameter
+itself, not its value) for this parameter value means that the error
+port is the same as the evaluator&rsquo;s initial output port.</div></p><p>The default is <span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._dup-output-port%29%29" class="RktValLink" data-pltdoc="x">dup-output-port</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-error-port%29%29" class="RktValLink" data-pltdoc="x">current-error-port</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>, which means that the error output of the
+generated evaluator goes to the calling context&rsquo;s error port.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-coverage-enabled))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-coverage-enabled%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-coverage-enabled</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-coverage-enabled%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-coverage-enabled</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">enabled?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">enabled?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls whether syntactic coverage information is
+collected by sandbox evaluators.  Use
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._get-uncovered-expressions%29%29" class="RktValLink" data-pltdoc="x">get-uncovered-expressions</a></span> to retrieve coverage information.</div></p><p>The default value is <span class="RktVal">#f</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-propagate-breaks))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-propagate-breaks%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-propagate-breaks</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-propagate-breaks%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-propagate-breaks</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">propagate?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">propagate?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">When both this boolean parameter and <span class="RktPn">(</span><span class="RktSym"><a href="breakhandler.html#%28def._%28%28quote._~23~25kernel%29._break-enabled%29%29" class="RktValLink" data-pltdoc="x">break-enabled</a></span><span class="RktPn">)</span> are true,
+breaking while an evaluator is
+running propagates the break signal to the sandboxed
+context.  This makes the sandboxed evaluator break, typically, but
+beware that sandboxed evaluation can capture and avoid the breaks (so
+if safe execution of code is your goal, make sure you use it with a
+time limit).  Also, beware that a break may be received after the
+evaluator&rsquo;s result, in which case the evaluation result is lost. Finally,
+beware that a break may be propagated after an evaluator has produced
+a result, so that the break is visible on the next interaction with
+the evaluator (or the break is lost if the evaluator is not used
+further). The default is <span class="RktVal">#t</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-propagate-exceptions))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-propagate-exceptions%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-propagate-exceptions</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-propagate-exceptions%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-propagate-exceptions</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">propagate?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">propagate?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls how uncaught exceptions during a sandbox
+evaluation are treated. When the parameter value is <span class="RktVal">#t</span>,
+then the exception is propagated to the caller of sandbox.
+When the parameter value is <span class="RktVal">#f</span>, the exception message
+is printed to the sandbox&rsquo;s error port, and the caller of the
+sandbox receives <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a> for the evaluation. The default
+is <span class="RktVal">#t</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-namespace-specs))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-namespace-specs%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-namespace-specs</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-namespace-specs%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-namespace-specs</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">spec</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">spec</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that holds a list of values that specify how to create a
+namespace for evaluation in <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-evaluator</a></span> or
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-module-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-module-evaluator</a></span>.  The first item in the list is a thunk
+that creates the namespace, and the rest are module paths for modules
+to be attached to the created namespace using
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-attach-module%29%29" class="RktValLink" data-pltdoc="x">namespace-attach-module</a></span>.</div></p><p>The default is <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-namespace%29%29" class="RktValLink" data-pltdoc="x">sandbox-make-namespace</a></span><span class="RktPn">)</span>.</p><p>The module paths are needed for sharing module instantiations between
+the sandbox and the caller.  For example, sandbox code that returns
+<span class="RktSym">posn</span> values (from the <span class="RktSym">lang/posn</span> module) will
+not be recognized as such by your own code by default, since the
+sandbox will have its own instance of <span class="RktSym">lang/posn</span> and
+thus its own struct type for <span class="RktSym">posn</span>s.  To be able to use such
+values, include <span class="RktVal">'</span><span class="RktVal">lang/posn</span> in the list of module paths.</p><p>When testing code that uses a teaching language, the following piece
+of code can be helpful:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-namespace-specs%29%29" class="RktValLink" data-pltdoc="x">sandbox-namespace-specs</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">specs</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-namespace-specs%29%29" class="RktValLink" data-pltdoc="x">sandbox-namespace-specs</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktRdr">,</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">specs</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">,@</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">specs</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">lang/posn</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">,@</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=Dynamic_Loading.html%23%2528def._%2528%2528lib._racket%252Fgui%252Fdynamic..rkt%2529._gui-available%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">gui-available?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">mrlib/cache-image-snip</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-make-namespace))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-namespace%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-make-namespace</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Calls <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=Windowing_Functions.html%23%2528def._%2528%2528lib._racket%252Fgui%252Fbase..rkt%2529._make-gui-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-gui-namespace</a></span> when <span class="RktPn">(</span><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-gui-available%29%29" class="RktValLink" data-pltdoc="x">sandbox-gui-available</a></span><span class="RktPn">)</span>
+produces true, <span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-base-namespace%29%29" class="RktValLink" data-pltdoc="x">make-base-namespace</a></span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-gui-available))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-gui-available%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-gui-available</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-gui-available%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-gui-available</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">avail?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">avail?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Determines whether the <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/gui</span></a> module can be used
+when a sandbox evaluator is created. If <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=Dynamic_Loading.html%23%2528def._%2528%2528lib._racket%252Fgui%252Fdynamic..rkt%2529._gui-available%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">gui-available?</a></span>
+produces <span class="RktVal">#f</span> during the creation of a sandbox evaluator, this
+parameter is forced to <span class="RktVal">#f</span> during initialization of the
+sandbox. The default value of the parameter is <span class="RktVal">#t</span>.</div></p><p>Various aspects of the library change when the GUI library is
+available, such as using a new eventspace for each evaluator.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-override-collection-paths))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-override-collection-paths%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-override-collection-paths</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-override-collection-paths%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-override-collection-paths</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">paths</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">paths</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines a list of collection directories to prefix
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-paths</a></span> in an evaluator. This
+parameter is useful for cases when you want to test code using an
+alternate, test-friendly version of a collection, for example, testing
+code that uses a GUI (like the <span class="RktSym">htdp/world</span> teachpack) can be
+done using a fake library that provides the same interface but no
+actual interaction. The default is <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-security-guard))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-security-guard%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-security-guard</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._security-guard~3f%29%29" class="RktValLink" data-pltdoc="x">security-guard?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._security-guard~3f%29%29" class="RktValLink" data-pltdoc="x">security-guard?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-security-guard%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-security-guard</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">guard</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">guard</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._security-guard~3f%29%29" class="RktValLink" data-pltdoc="x">security-guard?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._security-guard~3f%29%29" class="RktValLink" data-pltdoc="x">security-guard?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the initial
+<span class="RktPn">(</span><span class="RktSym"><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._current-security-guard%29%29" class="RktValLink" data-pltdoc="x">current-security-guard</a></span><span class="RktPn">)</span> for sandboxed evaluations.  It can
+be either a security guard, or a function to construct one.  The
+default is a function that restricts the access of the current
+security guard by forbidding all filesystem I/O except for
+specifications in <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-path-permissions%29%29" class="RktValLink" data-pltdoc="x">sandbox-path-permissions</a></span>, and it uses
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-network-guard%29%29" class="RktValLink" data-pltdoc="x">sandbox-network-guard</a></span> for network connections.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-path-permissions))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-path-permissions%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-path-permissions</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">execute</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">write</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">delete</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">read-bytecode</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">read</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exists</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-path-permissions%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-path-permissions</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">perms</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">perms</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">execute</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">write</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">delete</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">read-bytecode</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">read</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exists</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that configures the behavior of the default sandbox
+security guard by listing paths and access modes that are allowed for
+them.  The contents of this parameter is a list of specifications,
+each is an access mode and a byte-regexp for paths that are granted this
+access.</div></p><p>The access mode symbol is one of: <span class="RktVal">'</span><span class="RktVal">execute</span>, <span class="RktVal">'</span><span class="RktVal">write</span>,
+<span class="RktVal">'</span><span class="RktVal">delete</span>, <span class="RktVal">'</span><span class="RktVal">read</span>, or <span class="RktVal">'</span><span class="RktVal">exists</span>.  These symbols
+are in decreasing order: each implies access for the following modes
+too (e.g., <span class="RktVal">'</span><span class="RktVal">read</span> allows reading or checking for existence).</p><p>The path regexp is used to identify paths that are granted access.  It
+can also be given as a path (or a string or a byte string), which is
+(made into a complete path, cleansed, simplified, and then) converted
+to a regexp that allows the path and sub-directories; e.g.,
+<span class="RktVal">"/foo/bar"</span> applies to <span class="RktVal">"/foo/bar/baz"</span>.</p><p>An additional mode symbol, <span class="RktVal">'</span><span class="RktVal">read-bytecode</span>, is not part of the
+linear order of these modes.  Specifying this mode is similar to
+specifying <span class="RktVal">'</span><span class="RktVal">read</span>, but it is not implied by any other mode.
+(For example, even if you specify <span class="RktVal">'</span><span class="RktVal">write</span> for a certain path,
+you need to also specify <span class="RktVal">'</span><span class="RktVal">read-bytecode</span> to grant this
+permission.)  The sandbox usually works in the context of a lower code
+inspector (see <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-code-inspector%29%29" class="RktValLink" data-pltdoc="x">sandbox-make-code-inspector</a></span>) which prevents
+loading of untrusted bytecode files &#8212;<wbr></wbr> the sandbox is set-up to allow
+loading bytecode from files that are specified with
+<span class="RktVal">'</span><span class="RktVal">read-bytecode</span>.  This specification is given by default to
+the Racket collection hierarchy (including user-specific libraries) and
+to libraries that are explicitly specified in an <span class="RktPn">#:allow-read</span>
+argument.  (Note that this applies for loading bytecode files only,
+under a lower code inspector it is still impossible to use protected
+module bindings (see <a href="modprotect.html" data-pltdoc="x">Code Inspectors</a>).)</p><p>The default value is null, but when an evaluator is created, it is
+augmented by <span class="RktVal">'</span><span class="RktVal">read-bytecode</span> permissions that make it possible
+to use collection libraries (including
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-override-collection-paths%29%29" class="RktValLink" data-pltdoc="x">sandbox-override-collection-paths</a></span>). See
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-evaluator</a></span> for more information.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-network-guard))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-network-guard%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-network-guard</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">65535</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">server</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">client</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-network-guard%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-network-guard</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">65535</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">server</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">client</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that specifies a procedure to be used (as is) by the
+default <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-security-guard%29%29" class="RktValLink" data-pltdoc="x">sandbox-security-guard</a></span>.  The default forbids all
+network connection.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-exit-handler))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-exit-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-exit-handler</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-exit-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-exit-handler</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">handler</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">handler</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the initial <span class="RktPn">(</span><span class="RktSym"><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._exit-handler%29%29" class="RktValLink" data-pltdoc="x">exit-handler</a></span><span class="RktPn">)</span> for
+sandboxed evaluations.  The default kills the evaluator with an
+appropriate error message (see
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._exn~3afail~3asandbox-terminated-reason%29%29" class="RktValLink" data-pltdoc="x">exn:fail:sandbox-terminated-reason</a></span>).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-memory-limit))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-memory-limit%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-memory-limit</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-memory-limit%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-memory-limit</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">limit</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the total memory limit on the sandbox in
+megabytes (it can hold a rational or a floating point number).  When
+this limit is exceeded, the sandbox is terminated.  This value is used
+when the sandbox is created and the limit cannot be changed
+afterwards.  It defaults to 30mb.  See <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-eval-limits%29%29" class="RktValLink" data-pltdoc="x">sandbox-eval-limits</a></span>
+for per-evaluation limits and a description of how the two limits work
+together.</div></p><p>Note that (when memory accounting is enabled) memory is attributed to
+the highest custodian that refers to it.  This means that if you
+inspect a value that sandboxed evaluation returns outside of the
+sandbox, your own custodian will be charged for it.  To ensure that it
+is charged back to the sandbox, you should remove references to such
+values when the code is done inspecting it.</p><p><div class="SIntrapara">This policy has an impact on how the sandbox memory limit interacts
+with the per-expression limit specified by
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-eval-limits%29%29" class="RktValLink" data-pltdoc="x">sandbox-eval-limits</a></span>: values that are reachable from the
+sandbox, as well as from the interaction will count against the
+sandbox limit.  For example, in the last interaction of this code,
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">e</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-evaluator</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racket/base</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">e</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">define</span><span class="hspace">&nbsp;</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">e</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">for</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">[</span><span class="RktVal">i</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">in-range</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktVal">)</span><span class="RktVal">]</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">set!</span><span class="hspace">&nbsp;</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">cons</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">make-bytes</span><span class="hspace">&nbsp;</span><span class="RktVal">500000</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">a</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">the memory blocks are allocated within the interaction limit, but
+since they&rsquo;re chained to the defined variable, they&rsquo;re also reachable
+from the sandbox &#8212;<wbr></wbr> so they will count against the sandbox memory
+limit but not against the interaction limit (more precisely, no more
+than one block counts against the interaction limit).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-eval-limits))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-eval-limits%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-eval-limits</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-eval-limits%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-eval-limits</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">limits</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">limits</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the default limits on <span style="font-style: italic">each</span>
+use of a <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-evaluator</a></span> function, including the initial
+evaluation of the input program.  Its value should be a list of two
+numbers; where the first is a <a href="Sandboxed_Evaluation.html#%28tech._shallow._time%29" class="techoutside" data-pltdoc="x"><span class="techinside">shallow time</span></a> value in seconds,
+and the second is a memory limit in megabytes (note that they don&rsquo;t
+have to be integers).  Either one can be <span class="RktVal">#f</span> for disabling the
+corresponding limit; alternately, the parameter can be set to
+<span class="RktVal">#f</span> to disable all per-evaluation limits (useful in case more
+limit kinds are available in future versions). The default is
+<span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">30</span><span class="stt"> </span><span class="RktVal">20</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Note that these limits apply to the creation of the sandbox
+environment too &#8212;<wbr></wbr> even <span class="RktPn">(</span><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-evaluator</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">racket/base</span><span class="RktPn">)</span> can
+fail if the limits are strict enough.  For example,
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-eval-limits%29%29" class="RktValLink" data-pltdoc="x">sandbox-eval-limits</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">0.25</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-evaluator</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racket/base</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">sleep</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">will throw an error instead of creating an evaluator.  Therefore, to
+avoid surprises you need to catch errors that happen when the sandbox
+is created.</div></p><p>When limits are set, <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-limits%29%29" class="RktValLink" data-pltdoc="x">call-with-limits</a></span> (see below) is wrapped
+around each use of the evaluator, so consuming too much time or memory
+results in an exception.  Change the limits of a running evaluator
+using <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._set-eval-limits%29%29" class="RktValLink" data-pltdoc="x">set-eval-limits</a></span>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>A custodian&rsquo;s limit is checked only after a garbage
+collection, except that it may also be checked during
+certain large allocations that are individually larger
+than the custodian&rsquo;s limit.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara">The memory limit that is specified by this parameter applies to each
+individual evaluation, but not to the whole sandbox &#8212;<wbr></wbr> that limit is
+specified via <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-memory-limit%29%29" class="RktValLink" data-pltdoc="x">sandbox-memory-limit</a></span>.  When the global limit is
+exceeded, the sandbox is terminated, but when the per-evaluation limit
+is exceeded, an exception recognizable by <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._exn~3afail~3aresource~3f%29%29" class="RktValLink" data-pltdoc="x">exn:fail:resource?</a></span> is raised.  For example, say that
+you evaluate an expression like
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1000</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._make-bytes%29%29" class="RktValLink" data-pltdoc="x">make-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1000000</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="garbagecollection.html#%28def._%28%28quote._~23~25kernel%29._collect-garbage%29%29" class="RktValLink" data-pltdoc="x">collect-garbage</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">then, assuming sufficiently small limits,
+</div><div class="SIntrapara"><ul><li><p>if a global limit is set but no per-evaluation limit, the
+sandbox will eventually be terminated and no further
+evaluations possible;</p></li><li><p>if there is a per-evaluation limit, but no global limit, the
+evaluation will abort with an error and it can be used again
+&#8212;<wbr></wbr> specifically, <span class="RktSym">a</span> will still hold a number of
+blocks, and you can evaluate the same expression again which
+will add more blocks to it;</p></li><li><p>if both limits are set, with the global one larger than the
+per-evaluation limit, then the evaluation will abort and you
+will be able to repeat it, but doing so several times will
+eventually terminate the sandbox (this will be indicated by
+the error message, and by the <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._evaluator-alive~3f%29%29" class="RktValLink" data-pltdoc="x">evaluator-alive?</a></span>
+predicate).</p></li></ul></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-eval-handlers))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-eval-handlers%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-eval-handlers</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-eval-handlers%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-eval-handlers</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">handlers</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">handlers</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines two (optional) handlers that wrap
+sandboxed evaluations.  The first one is used when evaluating the
+initial program when the sandbox is being set-up, and the second is
+used for each interaction.  Each of these handlers should expect a
+thunk as an argument, and they should execute these thunks &#8212;<wbr></wbr>
+possibly imposing further restrictions.  The default values are
+<span class="RktVal">#f</span> and <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-custodian-shutdown%29%29" class="RktValLink" data-pltdoc="x">call-with-custodian-shutdown</a></span>, meaning no
+additional restrictions on initial sandbox code (e.g., it can start
+background threads), and a custodian-shutdown around each interaction
+that follows.  Another useful function for this is
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-killing-threads%29%29" class="RktValLink" data-pltdoc="x">call-with-killing-threads</a></span> which kills all threads, but leaves
+other resources intact.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-run-submodules))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-run-submodules%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-run-submodules</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-run-submodules%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-run-submodules</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">submod-syms</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">submod-syms</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines submodules to run when a sandbox is
+created by <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-module-evaluator%29%29" class="RktValLink" data-pltdoc="x">make-module-evaluator</a></span>. The parameter&rsquo;s default
+value is the empty list.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-make-inspector))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-inspector%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-make-inspector</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-inspector%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-make-inspector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">make</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">make</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the (nullary) procedure that is used to
+create the inspector for sandboxed evaluation.  The procedure is called
+when initializing an evaluator.  The default parameter value is
+<span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._make-inspector%29%29" class="RktValLink" data-pltdoc="x">make-inspector</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._current-inspector%29%29" class="RktValLink" data-pltdoc="x">current-inspector</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-make-code-inspector))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-code-inspector%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-make-code-inspector</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-code-inspector%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-make-code-inspector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">make</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">make</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the (nullary) procedure that is used to
+create the code inspector for sandboxed evaluation.  The procedure is
+called when initializing an evaluator.  The default parameter value is
+<span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._make-inspector%29%29" class="RktValLink" data-pltdoc="x">make-inspector</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="RktValLink" data-pltdoc="x">current-code-inspector</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p>The <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load%2Fuse-compiled%29%29" class="RktValLink" data-pltdoc="x">current-load/use-compiled</a></span> handler is setup to allow loading
+of bytecode files under the original code inspector when
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-path-permissions%29%29" class="RktValLink" data-pltdoc="x">sandbox-path-permissions</a></span> allows it through a
+<span class="RktVal">'</span><span class="RktVal">read-bytecode</span> mode symbol, which makes loading libraries
+possible.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-make-logger))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-logger%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-make-logger</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger~3f%29%29" class="RktValLink" data-pltdoc="x">logger?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-logger%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-make-logger</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">make</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">make</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger~3f%29%29" class="RktValLink" data-pltdoc="x">logger?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the procedure used to create the logger
+for sandboxed evaluation.  The procedure is called when initializing
+an evaluator, and the default parameter value is
+<span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._current-logger%29%29" class="RktValLink" data-pltdoc="x">current-logger</a></span>.  This means that it is not creating a new
+logger (this might change in the future).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-make-plumber))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-plumber%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-make-plumber</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber~3f%29%29" class="RktValLink" data-pltdoc="x">plumber?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">propagate</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-plumber%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-make-plumber</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">make</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">make</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber~3f%29%29" class="RktValLink" data-pltdoc="x">plumber?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">propagate</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the procedure used to create the
+plumber for sandboxed evaluation.  The procedure is called when
+initializing an evaluator.</div></p><p>If the value is <span class="RktVal">'</span><span class="RktVal">propagate</span> (the default), then a new plumber
+is created, and a <a href="plumbers.html#%28tech._flush._callback%29" class="techoutside" data-pltdoc="x"><span class="techinside">flush callback</span></a> is added to the current
+plumber to propagate the request to the new plumber within the created
+sandbox (if the sandbox has not already terminated).</p><p class="SHistory">Added in version 6.0.1.8 of package <span class="stt">sandbox-lib</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._sandbox-make-environment-variables))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-environment-variables%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-make-environment-variables</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables~3f%29%29" class="RktValLink" data-pltdoc="x">environment-variables?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-environment-variables%29%29" class="RktValDef RktValLink" data-pltdoc="x">sandbox-make-environment-variables</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">make</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">make</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables~3f%29%29" class="RktValLink" data-pltdoc="x">environment-variables?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the procedure used to create the
+<a href="envvars.html#%28tech._environment._variable._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">environment variable set</span></a> for sandboxed evaluation.  The
+procedure is called when initializing an evaluator, and the default
+parameter value constructs a new <a href="envvars.html#%28tech._environment._variable._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">environment variable set</span></a> using
+<span class="RktPn">(</span><span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables-copy%29%29" class="RktValLink" data-pltdoc="x">environment-variables-copy</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._current-environment-variables%29%29" class="RktValLink" data-pltdoc="x">current-environment-variables</a></span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._default-language-readers))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._default-language-readers%29%29" class="RktValDef RktValLink" data-pltdoc="x">default-language-readers</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lang</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lang</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a default list of readers that should be allowed to produce a
+module that uses <span class="RktVar">lang</span> as the language.</div></p><p>This default list includes the following (and more paths may be added
+in the future):</p><ul><li><p><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">submod</span><span class="stt"> </span><span class="RktRdr">,</span><span class="RktVar">lang</span><span class="stt"> </span><span class="RktVal">reader</span><span class="RktVal">)</span></p></li><li><p><span class="RktVal">&rsquo;</span><span class="RktVar">lang</span><span class="RktVal">/lang/reader</span> if <span class="RktVar">lang</span> is a symbol</p></li><li><p>the module path producing by adding the relative path <span class="RktVal">"lang/reader.rkt"</span>
+to <span class="RktVar">lang</span> if <span class="RktVar">lang</span> is not a symbol</p></li><li><p><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">submod</span><span class="stt"> </span><span class="RktVal">at-exp</span><span class="stt"> </span><span class="RktVal">reader</span><span class="RktVal">)</span></p></li><li><p><span class="RktVal">'</span><span class="RktVal">at-exp/lang/reader</span></p></li></ul><p class="SHistory">Added in version 1.2 of package <span class="stt">sandbox-lib</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Interacting_with_Evaluators&quot;">14.12.3<tt>&nbsp;</tt><a name="(part._.Interacting_with_.Evaluators)"></a>Interacting with Evaluators</h5><p>The following functions are used to interact with a sandboxed
+evaluator in addition to using it to evaluate code.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._evaluator-alive~3f))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._evaluator-alive~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">evaluator-alive?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">evaluator</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evaluator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Determines whether the evaluator is still alive.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._kill-evaluator))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._kill-evaluator%29%29" class="RktValDef RktValLink" data-pltdoc="x">kill-evaluator</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">evaluator</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evaluator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Releases the resources that are held by <span class="RktVar">evaluator</span> by shutting
+down the evaluator&rsquo;s custodian.  Attempting to use an evaluator after
+killing raises an exception, and attempts to kill a dead evaluator are
+ignored.</div></p><p>Killing an evaluator is similar to sending an <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> value to
+the evaluator, except that an <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> value will raise an error
+immediately.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._break-evaluator))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._break-evaluator%29%29" class="RktValDef RktValLink" data-pltdoc="x">break-evaluator</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">evaluator</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evaluator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Sends a break to the running evaluator.  The effect of this is as if
+Ctrl-C was typed when the evaluator is currently executing, which
+propagates the break to the evaluator&rsquo;s context.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._get-user-custodian))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._get-user-custodian%29%29" class="RktValDef RktValLink" data-pltdoc="x">get-user-custodian</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">evaluator</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evaluator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Retrieves the <span class="RktVar">evaluator</span>&rsquo;s toplevel custodian.  This returns a
+value that is different from <span class="RktPn">(</span><span class="RktVar">evaluator</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">current-custodian</span><span class="RktVal">)</span><span class="RktPn">)</span>
+or <span class="RktPn">(</span><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-in-sandbox-context%29%29" class="RktValLink" data-pltdoc="x">call-in-sandbox-context</a></span><span class="stt"> </span><span class="RktVar">evaluator</span><span class="stt"> </span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._current-custodian%29%29" class="RktValLink" data-pltdoc="x">current-custodian</a></span><span class="RktPn">)</span> &#8212;<wbr></wbr> each
+sandbox interaction is wrapped in its own custodian, which is what these
+would return.</div></p><p>(One use for this custodian is with <span class="RktSym"><a href="garbagecollection.html#%28def._%28%28quote._~23~25kernel%29._current-memory-use%29%29" class="RktValLink" data-pltdoc="x">current-memory-use</a></span>, where
+the per-interaction sub-custodians will not be charged with the memory
+for the whole sandbox.)</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._set-eval-limits))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._set-eval-limits%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-eval-limits</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">evaluator</span><span class="hspace">&nbsp;</span><span class="RktVar">secs</span><span class="hspace">&nbsp;</span><span class="RktVar">mb</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evaluator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">secs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mb</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Changes the per-expression limits that <span class="RktVar">evaluator</span> uses to
+<span class="RktVar">secs</span> seconds of <a href="Sandboxed_Evaluation.html#%28tech._shallow._time%29" class="techoutside" data-pltdoc="x"><span class="techinside">shallow time</span></a> and <span class="RktVar">mb</span>
+megabytes (either one can be <span class="RktVal">#f</span>, indicating no limit).</div></p><p>This procedure should be used to modify an existing evaluator limits,
+because changing the <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-eval-limits%29%29" class="RktValLink" data-pltdoc="x">sandbox-eval-limits</a></span> parameter does not
+affect existing evaluators. See also <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-limits%29%29" class="RktValLink" data-pltdoc="x">call-with-limits</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._set-eval-handler))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._set-eval-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-eval-handler</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">evaluator</span><span class="hspace">&nbsp;</span><span class="RktVar">handler</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evaluator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">handler</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Changes the per-expression handler that the <span class="RktVar">evaluator</span> uses
+around each interaction.  A <span class="RktVal">#f</span> value means no handler is
+used.</div></p><p>This procedure should be used to modify an existing evaluator handler,
+because changing the <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-eval-handlers%29%29" class="RktValLink" data-pltdoc="x">sandbox-eval-handlers</a></span> parameter does not
+affect existing evaluators. See also
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-custodian-shutdown%29%29" class="RktValLink" data-pltdoc="x">call-with-custodian-shutdown</a></span> and
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-killing-threads%29%29" class="RktValLink" data-pltdoc="x">call-with-killing-threads</a></span> for two useful handlers that are
+provided.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._call-with-custodian-shutdown))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-custodian-shutdown%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-custodian-shutdown</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thunk</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._call-with-killing-threads))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-killing-threads%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-killing-threads</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thunk</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">These functions are useful for use as an evaluation handler.
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-custodian-shutdown%29%29" class="RktValLink" data-pltdoc="x">call-with-custodian-shutdown</a></span> will execute the <span class="RktVar">thunk</span>
+in a fresh custodian, then shutdown that custodian, making sure that
+<span class="RktVar">thunk</span> could not have left behind any resources.
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-killing-threads%29%29" class="RktValLink" data-pltdoc="x">call-with-killing-threads</a></span> is similar, except that it kills
+threads that were left, but leaves other resources as is.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._put-input))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._put-input%29%29" class="RktValDef RktValLink" data-pltdoc="x">put-input</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">evaluator</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evaluator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._put-input%29%29" class="RktValDef RktValLink" data-pltdoc="x">put-input</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">evaluator</span><span class="hspace">&nbsp;</span><span class="RktVar">i/o</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evaluator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">i/o</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">If <span class="RktPn">(</span><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-input%29%29" class="RktValLink" data-pltdoc="x">sandbox-input</a></span><span class="RktPn">)</span> is <span class="RktVal">'</span><span class="RktVal">pipe</span> when an evaluator is
+created, then this procedure can be used to retrieve the output port
+end of the pipe (when used with no arguments), or to add a string or a
+byte string into the pipe.  It can also be used with <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>,
+which closes the pipe.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._get-output))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._get-output%29%29" class="RktValDef RktValLink" data-pltdoc="x">get-output</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">evaluator</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evaluator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._get-error-output))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._get-error-output%29%29" class="RktValDef RktValLink" data-pltdoc="x">get-error-output</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">evaluator</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evaluator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the output or error-output of the <span class="RktVar">evaluator</span>,
+in a way that depends on the setting of <span class="RktPn">(</span><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-output%29%29" class="RktValLink" data-pltdoc="x">sandbox-output</a></span><span class="RktPn">)</span> or
+<span class="RktPn">(</span><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-error-output%29%29" class="RktValLink" data-pltdoc="x">sandbox-error-output</a></span><span class="RktPn">)</span> when the evaluator was created:</div></p><ul><li><p>if it was <span class="RktVal">'</span><span class="RktVal">pipe</span>, then <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._get-output%29%29" class="RktValLink" data-pltdoc="x">get-output</a></span> returns the
+input port end of the created pipe;</p></li><li><p>if it was <span class="RktVal">'</span><span class="RktVal">bytes</span> or <span class="RktVal">'</span><span class="RktVal">string</span>, then the result
+is the accumulated output, and the output port is reset so each
+call returns a different piece of the evaluator&rsquo;s output (note
+that results are available only until the evaluator has
+terminated, and any allocations of the output are subject to
+the sandbox memory limit);</p></li><li><p>otherwise, it returns <span class="RktVal">#f</span>.</p></li></ul><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._get-uncovered-expressions))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._get-uncovered-expressions%29%29" class="RktValDef RktValLink" data-pltdoc="x">get-uncovered-expressions</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">evaluator</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">prog?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">src</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evaluator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prog?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">default-src</span></td></tr></table></blockquote></div><div class="SIntrapara">Retrieves uncovered expression from an evaluator, as longs as the
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-coverage-enabled%29%29" class="RktValLink" data-pltdoc="x">sandbox-coverage-enabled</a></span> parameter had a true value when the
+evaluator was created. Otherwise, an exception is raised to indicate
+that no coverage information is available.</div></p><p>The <span class="RktVar">prog?</span> argument specifies whether to obtain expressions that
+were uncovered after only the original input program was evaluated
+(<span class="RktVal">#t</span>) or after all later uses of the evaluator (<span class="RktVal">#f</span>).
+Using <span class="RktVal">#t</span> retrieves a list that is saved after the input
+program is evaluated, and before the evaluator is used, so the result is
+always the same.</p><p>A <span class="RktVal">#t</span> value of <span class="RktVar">prog?</span> is useful for testing student
+programs to find out whether a submission has sufficient test coverage
+built in. A <span class="RktVal">#f</span> value is useful for writing test suites for a
+program to ensure that your tests cover the whole code.</p><p>The second optional argument, <span class="RktVar">src</span>, specifies that the result
+should be filtered to hold only <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax objects</span></a> whose source
+matches <span class="RktVar">src</span>. The default is the source that was used in the
+program code, if there was one.  Note that <span class="RktVal">'</span><span class="RktVal">program</span> is used as
+the source value if the input program was given as S-expressions or as a
+string (and in these cases it will be the default for filtering).  If given
+<span class="RktVal">#f</span>, the result is the unfiltered list of expressions.</p><p>The resulting list of <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax objects</span></a> has at most one expression
+for each position and span.  Thus, the contents may be unreliable, but
+the position information is reliable (i.e., it always indicates source
+code that would be painted red in DrRacket when coverage information
+is used).</p><p>Note that if the input program is a sequence of syntax values, either
+make sure that they have <span class="RktVal">'</span><span class="RktVal">program</span> as the source field, or use
+the <span class="RktVar">src</span> argument.  Using a sequence of S-expressions (not
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax objects</span></a>) for an input program leads to unreliable
+coverage results, since each expression may be assigned a single
+source location.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._call-in-sandbox-context))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-in-sandbox-context%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-in-sandbox-context</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">evaluator</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">thunk</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">unrestricted?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evaluator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">unrestricted?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Calls the given <span class="RktVar">thunk</span> in the context of a sandboxed
+evaluator.  The call is performed under the resource limits and
+evaluation handler that are used for evaluating expressions, unless
+<span class="RktVar">unrestricted?</span> is specified as true.</div></p><p>This process is usually similar to <span class="RktPn">(</span><span class="RktVar">evaluator</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVar">thunk</span><span class="RktPn">)</span><span class="RktPn">)</span>,
+except that it does not rely on the common meaning of a sexpr-based
+syntax with list expressions as function application (which is not true
+in all languages).  Note that this is more useful for meta-level
+operations such as namespace manipulation, it is not intended to be used
+as a safe-evaluation replacement (i.e., using the sandbox evaluator as
+usual).</p><p><div class="SIntrapara">In addition, you can avoid some of the sandboxed restrictions by using
+your own permissions, for example,
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">guard</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._current-security-guard%29%29" class="RktValLink" data-pltdoc="x">current-security-guard</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-in-sandbox-context%29%29" class="RktValLink" data-pltdoc="x">call-in-sandbox-context</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">ev</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._current-security-guard%29%29" class="RktValLink" data-pltdoc="x">current-security-guard</a></span><span class="hspace">&nbsp;</span><span class="RktSym">guard</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">can access anything you want here</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._delete-file%29%29" class="RktValLink" data-pltdoc="x">delete-file</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"/some/file"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Miscellaneous&quot;">14.12.4<tt>&nbsp;</tt><a name="(part._.Miscellaneous)"></a>Miscellaneous</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/sandbox..rkt)._gui~3f))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._gui~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">gui?</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">For backward compatibility, only: the result of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=Dynamic_Loading.html%23%2528def._%2528%2528lib._racket%252Fgui%252Fdynamic..rkt%2529._gui-available%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">gui-available?</a></span>
+at the time that <a href="Sandboxed_Evaluation.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/sandbox</span></a> was instantiated.</div></p><p>The value of <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._gui~3f%29%29" class="RktValLink" data-pltdoc="x">gui?</a></span> is no longer used by
+<a href="Sandboxed_Evaluation.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/sandbox</span></a> itself. Instead,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=Dynamic_Loading.html%23%2528def._%2528%2528lib._racket%252Fgui%252Fdynamic..rkt%2529._gui-available%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">gui-available?</a></span>  and <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-gui-available%29%29" class="RktValLink" data-pltdoc="x">sandbox-gui-available</a></span> are
+checked at the time that a sandbox evaluator is created.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._call-with-limits))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-limits%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-limits</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">secs</span><span class="hspace">&nbsp;</span><span class="RktVar">mb</span><span class="hspace">&nbsp;</span><span class="RktVar">thunk</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">secs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mb</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Executes the given <span class="RktVar">thunk</span> with memory and time restrictions:
+if execution consumes more than <span class="RktVar">mb</span> megabytes or more than
+<span class="RktVar">secs</span> <a href="Sandboxed_Evaluation.html#%28tech._shallow._time%29" class="techoutside" data-pltdoc="x"><span class="techinside">shallow time</span></a> seconds, then the computation is
+aborted and an exception recognizable by <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._exn~3afail~3aresource~3f%29%29" class="RktValLink" data-pltdoc="x">exn:fail:resource?</a></span> is raised.  Otherwise, the result of
+the thunk is returned as usual (a value, multiple values, or an
+exception).  Each of the two limits can be <span class="RktVal">#f</span> to indicate the
+absence of a limit. See also <span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-limit-memory%29%29" class="RktValLink" data-pltdoc="x">custodian-limit-memory</a></span> for
+information on memory limits.</div></p><p>To enforce limits, <span class="RktVar">thunk</span> is run in a new thread. As usual,
+the new thread starts with the same parameter values as the one that
+calls <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-limits%29%29" class="RktValLink" data-pltdoc="x">call-with-limits</a></span>. <span class="emph">Not</span> as usual, parameter values
+from the thread used to run <span class="RktVar">thunk</span> are copied back to the
+thread that called <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-limits%29%29" class="RktValLink" data-pltdoc="x">call-with-limits</a></span> when <span class="RktVar">thunk</span>
+completes.</p><p>Sandboxed evaluators use <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-limits%29%29" class="RktValLink" data-pltdoc="x">call-with-limits</a></span>, according to the
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-eval-limits%29%29" class="RktValLink" data-pltdoc="x">sandbox-eval-limits</a></span> setting and uses of
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._set-eval-limits%29%29" class="RktValLink" data-pltdoc="x">set-eval-limits</a></span>: each expression evaluation is protected from
+timeouts and memory problems. Use <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-limits%29%29" class="RktValLink" data-pltdoc="x">call-with-limits</a></span> directly
+only to limit a whole testing session, instead of each expression.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/sandbox..rkt)._with-limits))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28form._%28%28lib._racket%2Fsandbox..rkt%29._with-limits%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">with-limits</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sec-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">mb-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A macro version of <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-limits%29%29" class="RktValLink" data-pltdoc="x">call-with-limits</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._call-with-deep-time-limit))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-deep-time-limit%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-deep-time-limit</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">secs</span><span class="hspace">&nbsp;</span><span class="RktVar">thunk</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">secs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Executes the given <span class="RktVar">thunk</span> with <a href="Sandboxed_Evaluation.html#%28tech._deep._time%29" class="techoutside" data-pltdoc="x"><span class="techinside">deep time</span></a> restrictions,
+and returns the values produced by <span class="RktVar">thunk</span>.</div></p><p>The given <span class="RktVar">thunk</span> is run in a new thread. If it errors or if
+the thread terminates returning a value, then <span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="RktPn">)</span> is
+returned.</p><p class="SHistory">Changed in version 1.1 of package <span class="stt">sandbox-lib</span>: Changed to return <span class="RktVar">thunk</span>&rsquo;s result
+if it completes normally.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/sandbox..rkt)._with-deep-time-limit))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28form._%28%28lib._racket%2Fsandbox..rkt%29._with-deep-time-limit%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">with-deep-time-limit</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">secs-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A macro version of <span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-deep-time-limit%29%29" class="RktValLink" data-pltdoc="x">call-with-deep-time-limit</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._exn~3afail~3aresource~3f))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._exn~3afail~3aresource~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:resource?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="RktPn">(</span><a name="(def._((lib._racket/sandbox..rkt)._exn~3afail~3aresource-resource))"></a><span title="Provided from: racket/sandbox | Package: sandbox-lib"><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._exn~3afail~3aresource-resource%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:resource-resource</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">exn</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">time</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">memory</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">deep-time</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">exn</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._exn~3afail~3aresource~3f%29%29" class="RktValLink" data-pltdoc="x">exn:fail:resource?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A predicate and accessor for exceptions that are raised by
+<span class="RktSym"><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-limits%29%29" class="RktValLink" data-pltdoc="x">call-with-limits</a></span>.  The <span class="RktSym">resource</span> field holds a
+symbol, representing the resource that was expended. <span class="RktVal">'</span><span class="RktVal">time</span> is
+used for <a href="Sandboxed_Evaluation.html#%28tech._shallow._time%29" class="techoutside" data-pltdoc="x"><span class="techinside">shallow time</span></a> and <span class="RktVal">'</span><span class="RktVal">deep-time</span> is used for
+<a href="Sandboxed_Evaluation.html#%28tech._deep._time%29" class="techoutside" data-pltdoc="x"><span class="techinside">deep time</span></a>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="plumbers.html" title="backward to &quot;14.11 Plumbers&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="repl-module.html" title="forward to &quot;14.13 The racket/repl Library&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Serializing_Syntax.html b/clones/docs.racket-lang.org/reference/Serializing_Syntax.html
new file mode 100644
index 00000000..5847692b
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Serializing_Syntax.html
@@ -0,0 +1,41 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>12.10&nbsp;Serializing Syntax</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">12.1&nbsp;</td><td><a href="stx-patterns.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Syntax Matching</a></td></tr><tr><td align="right">12.2&nbsp;</td><td><a href="stxops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Content</a></td></tr><tr><td align="right">12.3&nbsp;</td><td><a href="stxcmp.html" class="tocviewlink" data-pltdoc="x">Syntax Object Bindings</a></td></tr><tr><td align="right">12.4&nbsp;</td><td><a href="stxtrans.html" class="tocviewlink" data-pltdoc="x">Syntax Transformers</a></td></tr><tr><td align="right">12.5&nbsp;</td><td><a href="stxparam.html" class="tocviewlink" data-pltdoc="x">Syntax Parameters</a></td></tr><tr><td align="right">12.6&nbsp;</td><td><a href="splicing.html" class="tocviewlink" data-pltdoc="x">Local Binding with Splicing Body</a></td></tr><tr><td align="right">12.7&nbsp;</td><td><a href="stxprops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Properties</a></td></tr><tr><td align="right">12.8&nbsp;</td><td><a href="stxcerts.html" class="tocviewlink" data-pltdoc="x">Syntax Taints</a></td></tr><tr><td align="right">12.9&nbsp;</td><td><a href="Expanding_Top-Level_Forms.html" class="tocviewlink" data-pltdoc="x">Expanding Top-<wbr></wbr>Level Forms</a></td></tr><tr><td align="right">12.10&nbsp;</td><td><a href="Serializing_Syntax.html" class="tocviewselflink" data-pltdoc="x">Serializing Syntax</a></td></tr><tr><td align="right">12.11&nbsp;</td><td><a href="include.html" class="tocviewlink" data-pltdoc="x">File Inclusion</a></td></tr><tr><td align="right">12.12&nbsp;</td><td><a href="syntax-util.html" class="tocviewlink" data-pltdoc="x">Syntax Utilities</a></td></tr><tr><td align="right">12.13&nbsp;</td><td><a href="phase_space.html" class="tocviewlink" data-pltdoc="x">Phase and Space Utilities</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Serializing_Syntax.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._syntax-serialize%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>serialize</span></span></a></td></tr><tr><td><a href="Serializing_Syntax.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._syntax-deserialize%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>deserialize</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Expanding_Top-Level_Forms.html" title="backward to &quot;12.9 Expanding Top-Level Forms&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="include.html" title="forward to &quot;12.11 File Inclusion&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Serializing_Syntax&quot;">12.10<tt>&nbsp;</tt><a name="(part._.Serializing_.Syntax)"></a>Serializing Syntax</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top" colspan="3"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._syntax-serialize))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Serializing_Syntax.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._syntax-serialize%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-serialize</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:preserve-property-keys</span><span class="hspace">&nbsp;</span><span class="RktVar">preserve-property-keys</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:provides-namespace</span><span class="hspace">&nbsp;</span><span class="RktVar">provides-namespace</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:base-module-path-index</span><span class="hspace">&nbsp;</span><span class="RktVar">base-module-path-index</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">preserve-property-keys</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">provides-namespace</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">base-module-path-index</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Converts <span class="RktVar">stx</span> to a serialized form that is suitable for use
+with <span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._s-exp-~3efasl%29%29" class="RktValLink" data-pltdoc="x">s-exp-&gt;fasl</a></span> or <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span>. Although <span class="RktVar">stx</span>
+could be serialized with <span class="RktPn">(</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile%29%29" class="RktValLink" data-pltdoc="x">compile</a></span><span class="stt"> </span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">quote-syntax</span><span class="stt"> </span><span class="RktRdr">,</span><span class="RktVar">stx</span><span class="RktVal">)</span><span class="RktPn">)</span> and
+then writing the compiled form, <span class="RktSym"><a href="Serializing_Syntax.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._syntax-serialize%29%29" class="RktValLink" data-pltdoc="x">syntax-serialize</a></span> provides
+more control over serialization:</div></p><ul><li><p>The <span class="RktVar">preserve-property-keys</span> lists syntax-property keys
+to whose values should be preserved in serialization, even if
+the property value was not added as preserved with
+<span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property%29%29" class="RktValLink" data-pltdoc="x">syntax-property</a></span> (so it would be discarded in compiled
+form). The values associated with the properties to preserve
+must be serializable in the sense required by
+<span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property%29%29" class="RktValLink" data-pltdoc="x">syntax-property</a></span> for a preserved property.</p></li><li><p>The <span class="RktVar">provides-namespace</span> argument constrains how much
+the serialized syntax object can rely on <a name="(tech._bulk._binding)"></a><span style="font-style: italic">bulk
+bindings</span>, which are shared binding tables provided by
+exporting modules. If <span class="RktVar">provides-namespace</span> is
+<span class="RktVal">#f</span>, then complete binding information is recorded in
+the syntax object&rsquo;s serialized form, and no bulk bindings will
+be needed from the namespace at deserialization. Otherwise,
+bulk bindings will be used only for modules declared in
+<span class="RktVar">provides-namespace</span> (i.e., the deserialize-time
+namespace will have the same module declarations as
+<span class="RktVar">provides-namespace</span>); note that supplying a namespace
+with no module bindings is equivalent to supplying
+<span class="RktVal">#f</span>.</p></li><li><p>The <span class="RktVar">base-module-path-index</span> argument specifies a
+<a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a> to which binding information in
+<span class="RktVar">stx</span> is relative. For example, if a syntax object
+originates from <span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span> in the body of a module,
+then <span class="RktVar">base-module-path-index</span> could usefully be the
+enclosing module&rsquo;s module path index as produced by
+<span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3emodule-path-index%29%29" class="RktValLink" data-pltdoc="x">variable-reference-&gt;module-path-index</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="Locations____variable-reference.html#%28form._%28%28quote._~23~25kernel%29._~23~25variable-reference%29%29" class="RktStxLink" data-pltdoc="x">#%variable-reference</a></span><span class="RktPn">)</span><span class="RktPn">)</span> within the module. On deserialization,
+a different module path index can be supplied to substitute in
+place of <span class="RktVar">base-module-path-index</span>, which shifts any
+binding that is relative to the serialize-time module&rsquo;s
+identity to be relative to the module identity supplied at
+deserialize time. If <span class="RktVar">base-module-path-index</span> is
+<span class="RktVal">#f</span>, then no shifting is supported at deserialize time,
+and any <span class="RktVar">base-module-path-index</span> supplied at that time
+is ignored.</p></li></ul><p>A serialized syntax object is otherwise similar to compiled code: it
+is version-specific, and deserialization will require a sufficiently
+powerful <a href="modprotect.html#%28tech._code._inspector%29" class="techoutside" data-pltdoc="x"><span class="techinside">code inspector</span></a>.</p><p class="SHistory">Added in version 8.0.0.13 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top" colspan="3"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._syntax-deserialize))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Serializing_Syntax.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._syntax-deserialize%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-deserialize</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:base-module-path-index</span><span class="hspace">&nbsp;</span><span class="RktVar">base-module-path-index</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">base-module-path-index</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Converts the result of <span class="RktSym"><a href="Serializing_Syntax.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._syntax-serialize%29%29" class="RktValLink" data-pltdoc="x">syntax-serialize</a></span> back to a syntax
+object. See <span class="RktSym"><a href="Serializing_Syntax.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._syntax-serialize%29%29" class="RktValLink" data-pltdoc="x">syntax-serialize</a></span> for more information.</div></p><p class="SHistory">Added in version 8.0.0.13 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Expanding_Top-Level_Forms.html" title="backward to &quot;12.9 Expanding Top-Level Forms&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="include.html" title="forward to &quot;12.11 File Inclusion&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Single-Signature_Modules.html b/clones/docs.racket-lang.org/reference/Single-Signature_Modules.html
new file mode 100644
index 00000000..1ded975b
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Single-Signature_Modules.html
@@ -0,0 +1,15 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7.11&nbsp;Single-Signature Modules</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="creatingunits.html" class="tocviewlink" data-pltdoc="x">Creating Units</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="invokingunits.html" class="tocviewlink" data-pltdoc="x">Invoking Units</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="compoundunits.html" class="tocviewlink" data-pltdoc="x">Linking Units and Creating Compound Units</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="linkinference.html" class="tocviewlink" data-pltdoc="x">Inferred Linking</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="Generating_A_Unit_from_Context.html" class="tocviewlink" data-pltdoc="x">Generating A Unit from Context</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="Structural_Matching.html" class="tocviewlink" data-pltdoc="x">Structural Matching</a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="define-sig-form.html" class="tocviewlink" data-pltdoc="x">Extending the Syntax of Signatures</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Unit_Utilities.html" class="tocviewlink" data-pltdoc="x">Unit Utilities</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="unitcontracts.html" class="tocviewlink" data-pltdoc="x">Unit Contracts</a></td></tr><tr><td align="right">7.10&nbsp;</td><td><a href="single-unit.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Unit Modules</a></td></tr><tr><td align="right">7.11&nbsp;</td><td><a href="Single-Signature_Modules.html" class="tocviewselflink" data-pltdoc="x">Single-<wbr></wbr>Signature Modules</a></td></tr><tr><td align="right">7.12&nbsp;</td><td><a href="Transformer_Helpers.html" class="tocviewlink" data-pltdoc="x">Transformer Helpers</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="single-unit.html" title="backward to &quot;7.10 Single-Unit Modules&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Transformer_Helpers.html" title="forward to &quot;7.12 Transformer Helpers&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Single-Signature_Modules&quot;">7.11<tt>&nbsp;</tt><a name="(part._.Single-.Signature_.Modules)"></a><a name="(mod-path._racket/signature)"></a>Single-Signature Modules</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="Single-Signature_Modules.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/signature</span></a></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The <a href="Single-Signature_Modules.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/signature</span></a>
+language treats a module body as a unit signature.</div></p><p>The body must match the following <span class="RktVar">module-body</span> grammar:</p><p><table cellspacing="0" cellpadding="0"><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">module-body</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="hspace">&nbsp;</span><span class="RktVar">sig-spec</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span></td></tr></table></p><p>See <a href="creatingunits.html" data-pltdoc="x">Creating Units</a> for the grammar of <span class="RktVar">sig-spec</span>.
+Unlike the body of a <a href="mzlib_unit.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/unit</span></a> module, a
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> in a <a href="Single-Signature_Modules.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/signature</span></a> module must be
+a literal use of <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>.</p><p>The resulting signature is exported as
+<span class="RktVar">base</span><span class="RktSym">^</span>, where <span class="RktVar">base</span> is derived from
+the enclosing module&rsquo;s name (i.e., its symbolic name, or its path
+without the directory and file suffix). If the module name ends in
+<span class="RktSym">-sig</span>, then <span class="RktVar">base</span> corresponds to the module
+name before <span class="RktSym">-sig</span>. Otherwise, the module name serves as
+<span class="RktVar">base</span>.</p><p>A <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> form as a <span class="RktSym">sig-spec</span> is consistent with the
+definitions introduced by <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-struct%29%29" class="RktStxLink" data-pltdoc="x">define-struct</a></span>, as opposed to
+definitions introduced <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>. (That behavior was originally
+a bug, but it is preserved for compatibility.)</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="single-unit.html" title="backward to &quot;7.10 Single-Unit Modules&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Transformer_Helpers.html" title="forward to &quot;7.12 Transformer Helpers&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Structural_Matching.html b/clones/docs.racket-lang.org/reference/Structural_Matching.html
new file mode 100644
index 00000000..0fbad5b6
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Structural_Matching.html
@@ -0,0 +1,25 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7.6&nbsp;Structural Matching</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="creatingunits.html" class="tocviewlink" data-pltdoc="x">Creating Units</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="invokingunits.html" class="tocviewlink" data-pltdoc="x">Invoking Units</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="compoundunits.html" class="tocviewlink" data-pltdoc="x">Linking Units and Creating Compound Units</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="linkinference.html" class="tocviewlink" data-pltdoc="x">Inferred Linking</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="Generating_A_Unit_from_Context.html" class="tocviewlink" data-pltdoc="x">Generating A Unit from Context</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="Structural_Matching.html" class="tocviewselflink" data-pltdoc="x">Structural Matching</a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="define-sig-form.html" class="tocviewlink" data-pltdoc="x">Extending the Syntax of Signatures</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Unit_Utilities.html" class="tocviewlink" data-pltdoc="x">Unit Utilities</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="unitcontracts.html" class="tocviewlink" data-pltdoc="x">Unit Contracts</a></td></tr><tr><td align="right">7.10&nbsp;</td><td><a href="single-unit.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Unit Modules</a></td></tr><tr><td align="right">7.11&nbsp;</td><td><a href="Single-Signature_Modules.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Signature Modules</a></td></tr><tr><td align="right">7.12&nbsp;</td><td><a href="Transformer_Helpers.html" class="tocviewlink" data-pltdoc="x">Transformer Helpers</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Structural_Matching.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%2Fnew-import-export%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unit/<span class="mywbr"> &nbsp;</span>new-<wbr></wbr>import-<wbr></wbr>export</span></span></a></td></tr><tr><td><a href="Structural_Matching.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%2Fnew-import-export%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>unit/<span class="mywbr"> &nbsp;</span>new-<wbr></wbr>import-<wbr></wbr>export</span></span></a></td></tr><tr><td><a href="Structural_Matching.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%2Fs%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unit/<span class="mywbr"> &nbsp;</span>s</span></span></a></td></tr><tr><td><a href="Structural_Matching.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%2Fs%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>unit/<span class="mywbr"> &nbsp;</span>s</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Generating_A_Unit_from_Context.html" title="backward to &quot;7.5 Generating A Unit from Context&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="define-sig-form.html" title="forward to &quot;7.7 Extending the Syntax of Signatures&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Structural_Matching&quot;">7.6<tt>&nbsp;</tt><a name="(part._.Structural_.Matching)"></a>Structural Matching</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._unit/new-import-export))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="Structural_Matching.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%2Fnew-import-export%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">unit/new-import-export</a></span></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">init-depends-decl</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">unit-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span>, except the body of the unit is determined by
+an existing unit produced by <span class="RktVar">unit-expr</span>. The result is a unit
+whose implementation is <span class="RktVar">unit-expr</span>, but whose imports,
+exports, and initialization dependencies are as in the
+<span class="RktSym"><a href="Structural_Matching.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%2Fnew-import-export%29%29" class="RktStxLink" data-pltdoc="x">unit/new-import-export</a></span> form (instead of as in the unit
+produced by <span class="RktVar">unit-expr</span>).</div></p><p>The final clause of the <span class="RktSym"><a href="Structural_Matching.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%2Fnew-import-export%29%29" class="RktStxLink" data-pltdoc="x">unit/new-import-export</a></span> form
+determines the connection between the old and new imports and exports.
+The connection is similar to the way that <span class="RktSym"><a href="compoundunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%29%29" class="RktStxLink" data-pltdoc="x">compound-unit</a></span>
+propagates imports and exports; the difference is that the connection
+between <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span> and the right-hand side of the link clause is
+based on the names of elements in signatures, rather than the names of
+the signatures. That is, a <span class="RktVar">tagged-sig-spec</span> on the right-hand
+side of the link clause need not appear as a <span class="RktVar">tagged-sig-spec</span>
+in the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span> clause, but each of the bindings implied by the
+linking <span class="RktVar">tagged-sig-spec</span> must be implied by some
+<span class="RktVar">tagged-sig-spec</span> in the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span> clause. Similarly,
+each of the bindings implied by an <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span>
+<span class="RktVar">tagged-sig-spec</span> must be implied by some left-hand-side
+<span class="RktVar">tagged-sig-spec</span> in the linking clause.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._define-unit/new-import-export))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="Structural_Matching.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%2Fnew-import-export%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-unit/new-import-export</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">unit-id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">init-depends-decl</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">unit-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Structural_Matching.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%2Fnew-import-export%29%29" class="RktStxLink" data-pltdoc="x">unit/new-import-export</a></span>, but binds static information to
+<span class="RktVar">unit-id</span> like <span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%29%29" class="RktStxLink" data-pltdoc="x">define-unit</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._unit/s))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="Structural_Matching.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%2Fs%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">unit/s</a></span></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">init-depends-decl</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">unit-id</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Structural_Matching.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%2Fnew-import-export%29%29" class="RktStxLink" data-pltdoc="x">unit/new-import-export</a></span>, but the linking clause is
+inferred, so <span class="RktVar">unit-id</span> must have the appropriate static
+information.
+</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._define-unit/s))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="Structural_Matching.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%2Fs%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-unit/s</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">name-id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">init-depends-decl</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">unit-id</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Structural_Matching.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%2Fs%29%29" class="RktStxLink" data-pltdoc="x">unit/s</a></span>, but binds static information to <span class="RktVar">name-id</span>
+like <span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%29%29" class="RktStxLink" data-pltdoc="x">define-unit</a></span>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Generating_A_Unit_from_Context.html" title="backward to &quot;7.5 Generating A Unit from Context&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="define-sig-form.html" title="forward to &quot;7.7 Extending the Syntax of Signatures&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Structure_Type_Property_Contracts.html b/clones/docs.racket-lang.org/reference/Structure_Type_Property_Contracts.html
new file mode 100644
index 00000000..f881d5e7
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Structure_Type_Property_Contracts.html
@@ -0,0 +1,32 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>8.5&nbsp;Structure Type Property Contracts</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.1&nbsp;</td><td><a href="data-structure-contracts.html" class="tocviewlink" data-pltdoc="x">Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.2&nbsp;</td><td><a href="function-contracts.html" class="tocviewlink" data-pltdoc="x">Function Contracts</a></td></tr><tr><td align="right">8.3&nbsp;</td><td><a href="parametric-contracts.html" class="tocviewlink" data-pltdoc="x">Parametric Contracts</a></td></tr><tr><td align="right">8.4&nbsp;</td><td><a href="Lazy_Data-structure_Contracts.html" class="tocviewlink" data-pltdoc="x">Lazy Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.5&nbsp;</td><td><a href="Structure_Type_Property_Contracts.html" class="tocviewselflink" data-pltdoc="x">Structure Type Property Contracts</a></td></tr><tr><td align="right">8.6&nbsp;</td><td><a href="attaching-contracts-to-values.html" class="tocviewlink" data-pltdoc="x">Attaching Contracts to Values</a></td></tr><tr><td align="right">8.7&nbsp;</td><td><a href="Building_New_Contract_Combinators.html" class="tocviewlink" data-pltdoc="x">Building New Contract Combinators</a></td></tr><tr><td align="right">8.8&nbsp;</td><td><a href="contract-utilities.html" class="tocviewlink" data-pltdoc="x">Contract Utilities</a></td></tr><tr><td align="right">8.9&nbsp;</td><td><a href="racket_contract_base.html" class="tocviewlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>contract/<span class="mywbr"> &nbsp;</span>base</span></span></a></td></tr><tr><td align="right">8.10&nbsp;</td><td><a href="collapsible.html" class="tocviewlink" data-pltdoc="x">Collapsible Contracts</a></td></tr><tr><td align="right">8.11&nbsp;</td><td><a href="Legacy_Contracts.html" class="tocviewlink" data-pltdoc="x">Legacy Contracts</a></td></tr><tr><td align="right">8.12&nbsp;</td><td><a href="Random_generation.html" class="tocviewlink" data-pltdoc="x">Random generation</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Structure_Type_Property_Contracts.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._struct-type-property%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>type-<wbr></wbr>property/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="versionbox"><span class="version">8.6</span></div><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Lazy_Data-structure_Contracts.html" title="backward to &quot;8.4 Lazy Data-structure Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="attaching-contracts-to-values.html" title="forward to &quot;8.6 Attaching Contracts to Values&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Structure_Type_Property_Contracts&quot;">8.5<tt>&nbsp;</tt><a name="(part._.Structure_.Type_.Property_.Contracts)"></a>Structure Type Property Contracts</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract..rkt)._struct-type-property/c))"></a><span title="Provided from: racket/contract, racket | Package: base"><span class="RktSym"><a href="Structure_Type_Property_Contracts.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._struct-type-property%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-type-property/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">value-contract</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">value-contract</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a contract for a <a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property</span></a>. When the
+contract is applied to a struct type property, it produces a wrapped
+struct type property that applies <span class="RktVar">value-contract</span> to the value
+associated with the property when it used to create a new struct type
+(via <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>, <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span>, etc).</div></p><p>The struct type property&rsquo;s accessor function is not affected; if it is
+exported, it must be protected separately.</p><p>As an example, consider the following module. It creates a structure
+type property, <span class="RktSym">prop</span>, whose value should be a function mapping
+a structure instance to a numeric predicate. The module also exports
+<span class="RktSym">app-prop</span>, which extracts the predicate from a structure
+instance and applies it to a given value.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">propmod</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/contract</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">prop</span><span class="hspace">&nbsp;</span><span class="RktSym">prop?</span><span class="hspace">&nbsp;</span><span class="RktSym">prop-ref</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type-property%29%29" class="RktValLink" data-pltdoc="x">make-struct-type-property</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">prop</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">app-prop</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">prop-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fprovide..rkt%29._provide%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">provide/contract</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">prop?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">prop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Structure_Type_Property_Contracts.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._struct-type-property%2Fc%29%29" class="RktValLink" data-pltdoc="x">struct-type-property/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">prop?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">app-prop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">prop?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">prop-ref</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote><p>The <span class="RktSym">structmod</span> module creates a structure type named
+<span class="RktSym">s</span> with a single field; the value of <span class="RktSym">prop</span> is a
+function that extracts the field value from an instance. Thus the
+field ought to be an integer predicate, but notice that
+<span class="RktSym">structmod</span> places no contract on <span class="RktSym">s</span> enforcing that
+constraint.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">structmod</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">propmod</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:property</span><span class="hspace">&nbsp;</span><span class="RktSym">prop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s-f</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-out%29%29" class="RktStxLink" data-pltdoc="x">struct-out</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">propmod</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">structmod</span><span class="RktPn">)</span></td></tr></table></blockquote><p>First we create an <span class="RktSym">s</span> instance with an integer predicate, so
+the constraint on <span class="RktSym">prop</span> is in fact satisfied. The first call
+to <span class="RktSym">app-prop</span> is correct; the second simply violates the
+contract of <span class="RktSym">app-prop</span>.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">app-prop</span><span class="hspace">&nbsp;</span><span class="RktSym">s1</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">app-prop</span><span class="hspace">&nbsp;</span><span class="RktSym">s1</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">apple</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">app-prop: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 'apple</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 2nd argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; prop? integer? boolean?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: propmod</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr></table></blockquote><p>We are able to create <span class="RktSym">s</span> instances with values other than
+integer predicates, but applying <span class="RktSym">app-prop</span> on them blames
+<span class="RktSym">structmod</span>, because the function associated with
+<span class="RktSym">prop</span>&#8212;<wbr></wbr>that is, <span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">s-f</span><span class="stt"> </span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span>&#8212;<wbr></wbr>does not
+always produce a value satisfying <span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="stt"> </span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span>.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">"not a fun"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">app-prop</span><span class="hspace">&nbsp;</span><span class="RktSym">s2</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">prop: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: a procedure</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: "not a fun"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the range of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">the struct property value of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(struct-type-property/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; prop? (-&gt; integer? boolean?)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: propmod</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: structmod</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s3</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">app-prop</span><span class="hspace">&nbsp;</span><span class="RktSym">s3</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">prop: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: boolean?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: '(5)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the range of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">the range of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">the struct property value of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(struct-type-property/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; prop? (-&gt; integer? boolean?)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: propmod</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: structmod</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr></table></blockquote><p>The fix would be to propagate the obligation inherited from
+<span class="RktSym">prop</span> to <span class="RktSym">s</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._contract-out%29%29" class="RktStxLink" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Finally, if we directly apply the property accessor,
+<span class="RktSym">prop-ref</span>, and then misuse the resulting function, the
+<span class="RktSym">propmod</span> module is blamed:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">prop-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">s3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">apple</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">prop: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: prop?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: 'apple</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">the struct property value of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(struct-type-property/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; prop? (-&gt; integer? boolean?)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: propmod</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: propmod</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr></table></blockquote><p>The <span class="RktSym">propmod</span> module has an obligation to ensure a function
+associated with <span class="RktSym">prop</span> is applied only to values satisfying
+<span class="RktSym">prop?</span>. By directly providing <span class="RktSym">prop-ref</span>, it enables
+that constraint to be violated (and thus it is blamed), even though
+the bad application actually occurs elsewhere.</p><p>Generally there is no need to provide a structure type property
+accessor at all; it is typically only used by other functions within
+the module. But if it must be provided, it should be protected thus:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._contract-out%29%29" class="RktStxLink" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">prop-ref</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">prop?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">prop?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Lazy_Data-structure_Contracts.html" title="backward to &quot;8.4 Lazy Data-structure Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="attaching-contracts-to-values.html" title="forward to &quot;8.6 Attaching Contracts to Values&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Surrogates.html b/clones/docs.racket-lang.org/reference/Surrogates.html
new file mode 100644
index 00000000..dacac225
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Surrogates.html
@@ -0,0 +1,63 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6.12&nbsp;Surrogates</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewselflink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="createinterface.html" class="tocviewlink" data-pltdoc="x">Creating Interfaces</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="createclass.html" class="tocviewlink" data-pltdoc="x">Creating Classes</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="objcreation.html" class="tocviewlink" data-pltdoc="x">Creating Objects</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="ivaraccess.html" class="tocviewlink" data-pltdoc="x">Field and Method Access</a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="mixins.html" class="tocviewlink" data-pltdoc="x">Mixins</a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="trait.html" class="tocviewlink" data-pltdoc="x">Traits</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="Object_and_Class_Contracts.html" class="tocviewlink" data-pltdoc="x">Object and Class Contracts</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="objectequality.html" class="tocviewlink" data-pltdoc="x">Object Equality and Hashing</a></td></tr><tr><td align="right">6.9&nbsp;</td><td><a href="objectserialize.html" class="tocviewlink" data-pltdoc="x">Object Serialization</a></td></tr><tr><td align="right">6.10&nbsp;</td><td><a href="objectprinting.html" class="tocviewlink" data-pltdoc="x">Object Printing</a></td></tr><tr><td align="right">6.11&nbsp;</td><td><a href="objectutils.html" class="tocviewlink" data-pltdoc="x">Object, Class, and Interface Utilities</a></td></tr><tr><td align="right">6.12&nbsp;</td><td><a href="Surrogates.html" class="tocviewselflink" data-pltdoc="x">Surrogates</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Surrogates.html#%28form._%28%28lib._racket%2Fsurrogate..rkt%29._surrogate%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">surrogate</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="objectutils.html" title="backward to &quot;6.11 Object, Class, and Interface Utilities&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="forward to &quot;7 Units&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Surrogates&quot;">6.12<tt>&nbsp;</tt><a name="(part._.Surrogates)"></a><a name="(mod-path._racket/surrogate)"></a>Surrogates</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="Surrogates.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/surrogate</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="Surrogates.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/surrogate</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p>The <a href="Surrogates.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/surrogate</span></a> library provides an abstraction
+for building an instance of the <a name="(tech._proxy._design._pattern)"></a><span style="font-style: italic">proxy design pattern</span>. The
+pattern consists of two objects, a <span style="font-style: italic">host</span> and a
+<span style="font-style: italic">surrogate</span> object. The host object delegates method calls to
+its surrogate object. Each host has a dynamically assigned surrogate,
+so an object can completely change its behavior merely by changing the
+surrogate.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/surrogate..rkt)._surrogate))"></a><span title="Provided from: racket/surrogate | Package: base"><span class="RktSym"><a href="Surrogates.html#%28form._%28%28lib._racket%2Fsurrogate..rkt%29._surrogate%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">surrogate</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">use-wrapper-proc</span><span class="hspace">&nbsp;</span><span class="RktVar">method-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">use-wrapper-proc</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:use-wrapper-proc</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">method-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span><span class="hspace">&nbsp;</span><span class="RktVar">default-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">method-id</span><span class="hspace">&nbsp;</span><span class="RktVar">arg-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span><span class="hspace">&nbsp;</span><span class="RktVar">method-id</span><span class="hspace">&nbsp;</span><span class="RktVar">arg-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">arg-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="Surrogates.html#%28form._%28%28lib._racket%2Fsurrogate..rkt%29._surrogate%29%29" class="RktStxLink" data-pltdoc="x">surrogate</a></span> form produces four values: a host <a href="mixins.html#%28tech._mixin%29" class="techoutside" data-pltdoc="x"><span class="techinside">mixin</span></a> (a
+procedure that accepts and returns a class), a host <a href="mzlib_class.html#%28tech._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">interface</span></a>, a
+surrogate <a href="mzlib_class.html#%28tech._clas%29" class="techoutside" data-pltdoc="x"><span class="techinside">class</span></a>, and a surrogate <a href="mzlib_class.html#%28tech._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">interface</span></a>.</div></p><p>If <span class="RktPn">#:use-wrapper-proc</span> does not appear,
+the host mixin adds a single private field to its argument. It also adds getter and setter methods
+<span class="RktSym">get-surrogate</span> and <span class="RktSym">set-surrogate</span> to get and set the value of the field. The
+<span class="RktSym">set-surrogate</span> method accepts instances of the class returned by
+the <span class="RktSym"><a href="Surrogates.html#%28form._%28%28lib._racket%2Fsurrogate..rkt%29._surrogate%29%29" class="RktStxLink" data-pltdoc="x">surrogate</a></span> form or <span class="RktVal">#f</span>, and it updates the field with its
+argument; then, <span class="RktSym">set-surrogate</span> calls the <span class="RktSym">on-disable-surrogate</span> on the
+previous value of the field and <span class="RktSym">on-enable-surrogate</span> for the
+new value of the field. The <span class="RktSym">get-surrogate</span> method returns the
+current value of the field.</p><p><div class="SIntrapara">If <span class="RktPn">#:use-wrapper-proc</span> does appear, the the host mixin adds
+and a second private field and its getter and setter
+methods <span class="RktSym">get-surrogate-wrapper-proc</span> and <span class="RktSym">set-surrogate-wrapper-proc</span>.
+The additional field holds a wrapper procedure whose contract
+is <span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span>, so the procedure is invoked with two thunks.
+The first thunk is a fallback that invokes the original object&rsquo;s method,
+skipping the surrogate. The second thunk invokes the surrogate. The default
+wrapper procedure is
+ </div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fallback-thunk</span><span class="hspace">&nbsp;</span><span class="RktSym">surrogate-thunk</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">surrogate-thunk</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">That is, it simply defers to the method being invoked on the surrogate.
+Note that wrapper procedure can adjust the
+dynamic extent of calls to the surrogate
+by, for example, changing the values of parameters. The
+wrapper procedure  is also invoked when calling the
+<span class="RktSym">on-disable-surrogate</span> and <span class="RktSym">on-enable-surrogate</span> methods
+of the surrogate.</div></p><p>The host mixin has a single overriding method for each
+<span class="RktVar">method-id</span> in the <span class="RktSym"><a href="Surrogates.html#%28form._%28%28lib._racket%2Fsurrogate..rkt%29._surrogate%29%29" class="RktStxLink" data-pltdoc="x">surrogate</a></span> form (even the ones
+specified with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span>). Each of these
+methods is defined with a <span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span> with one arm for each
+<span class="RktVar">arg-spec</span>. Each arm has the variables as arguments in the
+<span class="RktVar">arg-spec</span>. The body of each method tests the
+private surrogate field. If the field value is <span class="RktVal">#f</span>, the method just
+returns the result of invoking the super or inner method. If the
+field value is not <span class="RktVal">#f</span>, the corresponding method
+of the object in the field is invoked. This method receives the same
+arguments as the original method, plus two extras. The extra arguments
+come at the beginning of the argument list. The first is the original
+object. The second is a procedure that calls the super or inner method
+(i.e., the method of the class that is passed to the mixin or an
+extension, or the method in an overriding class), with the arguments
+that the procedure receives.</p><p><div class="SIntrapara">For example, the host-mixin for this surrogate:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="Surrogates.html#%28form._%28%28lib._racket%2Fsurrogate..rkt%29._surrogate%29%29" class="RktStxLink" data-pltdoc="x">surrogate</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></div><div class="SIntrapara">will override the <span class="RktSym">m</span> method and call the surrogate like this:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Foverride%29%29" class="RktStxLink" data-pltdoc="x">define/override</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktVar">surrogate</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktVar">surrogate</span><span class="hspace">&nbsp;</span><span class="RktSym">m</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this%29%29" class="RktStxLink" data-pltdoc="x">this</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">where <span class="RktVar">surrogate</span> is bound to the value most recently passed
+to the host mixin&rsquo;s <span class="RktSym">set-surrogate</span> method.</div></p><p>The host interface has the names <span class="RktSym">set-surrogate</span>,
+<span class="RktSym">get-surrogate</span>, and each of the <span class="RktVar">method-id</span>s in the
+original form.</p><p>The surrogate class has a single public method for each
+<span class="RktVar">method-id</span> in the <span class="RktSym"><a href="Surrogates.html#%28form._%28%28lib._racket%2Fsurrogate..rkt%29._surrogate%29%29" class="RktStxLink" data-pltdoc="x">surrogate</a></span> form. These methods are
+invoked by classes constructed by the mixin. Each has a corresponding
+method signature, as described in the above paragraph. Each method
+just passes its argument along to the super procedure it receives.</p><p><div class="SIntrapara">In the example above, this is the <span class="RktVar">m</span> method in the surrogate class:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">original-object</span><span class="hspace">&nbsp;</span><span class="RktSym">original-super</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">original-super</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p>If you derive a class from the surrogate class, do not both call
+the <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span> argument and the super method of the surrogate
+class itself. Only call one or the other, since the default methods
+call the <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span> argument.</p><p>Finally, the interface contains all of the names specified in
+surrogate&rsquo;s argument, plus <span class="RktSym">on-enable-surrogate</span> and
+<span class="RktSym">on-disable-surrogate</span>. The class returned by
+<span class="RktSym"><a href="Surrogates.html#%28form._%28%28lib._racket%2Fsurrogate..rkt%29._surrogate%29%29" class="RktStxLink" data-pltdoc="x">surrogate</a></span> implements this interface.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="objectutils.html" title="backward to &quot;6.11 Object, Class, and Interface Utilities&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="forward to &quot;7 Units&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Syntax_Quoting__quote-syntax.html b/clones/docs.racket-lang.org/reference/Syntax_Quoting__quote-syntax.html
new file mode 100644
index 00000000..7e20d406
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Syntax_Quoting__quote-syntax.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.21&nbsp;Syntax Quoting: quote-syntax</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewselflink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="quasiquote.html" title="backward to &quot;3.20 Quasiquoting: quasiquote, unquote, and unquote-splicing&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="__top-interaction.html" title="forward to &quot;3.22 Interaction Wrapper: #%top-interaction&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Syntax_Quoting__quote-syntax&quot;">3.21<tt>&nbsp;</tt><a name="(part._.Syntax_.Quoting__quote-syntax)"></a>Syntax Quoting: <span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span></h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._quote-syntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">quote-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">datum</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">quote-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVar">datum</span><span class="hspace">&nbsp;</span><span class="RktPn">#:local</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span>, but produces a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>
+that preserves the <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> and source-location
+information attached to <span class="RktVar">datum</span> at expansion time.</div></p><p>When <span class="RktPn">#:local</span> is specified, then all <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scopes</span></a> in the
+syntax object&rsquo;s <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> are preserved. When
+<span class="RktPn">#:local</span> is omitted, then the <a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope sets</span></a> within
+<span class="RktVar">datum</span> are pruned to omit the <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a> for any binding
+form that appears between the <span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span> form and the
+enclosing top-level context, module body, or <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>
+crossing, whichever is closer.</p><p>Unlike <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%29%29" class="RktStxLink" data-pltdoc="x">syntax</a></span> (<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#'</span><span class="hspace"></span></span>), <span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span> does
+not substitute pattern variables bound by <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._with-syntax%29%29" class="RktStxLink" data-pltdoc="x">with-syntax</a></span>,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Parsing_Syntax.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._syntax-parse%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-parse</a></span>, or <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;syntax:eval:78:0 (1 2 3)&gt;</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._with-syntax%29%29" class="RktStxLink" data-pltdoc="x">with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;syntax:eval:79:0 (a b c)&gt;</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">#:local</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.3 of package <span class="stt">base</span>: Added <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a> pruning and support
+for <span class="RktPn">#:local</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="quasiquote.html" title="backward to &quot;3.20 Quasiquoting: quasiquote, unquote, and unquote-splicing&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="__top-interaction.html" title="forward to &quot;3.22 Interaction Wrapper: #%top-interaction&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Transformer_Helpers.html b/clones/docs.racket-lang.org/reference/Transformer_Helpers.html
new file mode 100644
index 00000000..b8cd06e6
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Transformer_Helpers.html
@@ -0,0 +1,36 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7.12&nbsp;Transformer Helpers</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="creatingunits.html" class="tocviewlink" data-pltdoc="x">Creating Units</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="invokingunits.html" class="tocviewlink" data-pltdoc="x">Invoking Units</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="compoundunits.html" class="tocviewlink" data-pltdoc="x">Linking Units and Creating Compound Units</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="linkinference.html" class="tocviewlink" data-pltdoc="x">Inferred Linking</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="Generating_A_Unit_from_Context.html" class="tocviewlink" data-pltdoc="x">Generating A Unit from Context</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="Structural_Matching.html" class="tocviewlink" data-pltdoc="x">Structural Matching</a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="define-sig-form.html" class="tocviewlink" data-pltdoc="x">Extending the Syntax of Signatures</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Unit_Utilities.html" class="tocviewlink" data-pltdoc="x">Unit Utilities</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="unitcontracts.html" class="tocviewlink" data-pltdoc="x">Unit Contracts</a></td></tr><tr><td align="right">7.10&nbsp;</td><td><a href="single-unit.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Unit Modules</a></td></tr><tr><td align="right">7.11&nbsp;</td><td><a href="Single-Signature_Modules.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Signature Modules</a></td></tr><tr><td align="right">7.12&nbsp;</td><td><a href="Transformer_Helpers.html" class="tocviewselflink" data-pltdoc="x">Transformer Helpers</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Transformer_Helpers.html#%28def._%28%28lib._racket%2Funit-exptime..rkt%29._unit-static-signatures%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unit-<wbr></wbr>static-<wbr></wbr>signatures</span></span></a></td></tr><tr><td><a href="Transformer_Helpers.html#%28def._%28%28lib._racket%2Funit-exptime..rkt%29._signature-members%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">signature-<wbr></wbr>members</span></span></a></td></tr><tr><td><a href="Transformer_Helpers.html#%28def._%28%28lib._racket%2Funit-exptime..rkt%29._unit-static-init-dependencies%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unit-<wbr></wbr>static-<wbr></wbr>init-<wbr></wbr>dependencies</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Single-Signature_Modules.html" title="backward to &quot;7.11 Single-Signature Modules&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contracts.html" title="forward to &quot;8 Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Transformer_Helpers&quot;">7.12<tt>&nbsp;</tt><a name="(part._.Transformer_.Helpers)"></a><a name="(mod-path._racket/unit-exptime)"></a>Transformer Helpers</h4><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="Transformer_Helpers.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/unit-exptime</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></p><p>The <a href="Transformer_Helpers.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/unit-exptime</span></a> library provides procedures
+that are intended for use by macro transformers. In particular, the
+library is typically imported using <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span> into a module
+that defines macro with <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unit-exptime..rkt)._unit-static-signatures))"></a><span title="Provided from: racket/unit-exptime | Package: base"><span class="RktSym"><a href="Transformer_Helpers.html#%28def._%28%28lib._racket%2Funit-exptime..rkt%29._unit-static-signatures%29%29" class="RktValDef RktValLink" data-pltdoc="x">unit-static-signatures</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">unit-identifier</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">err-syntax</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">unit-identifier</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">err-syntax</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">If <span class="RktVar">unit-identifier</span> is bound to static unit information via
+<span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%29%29" class="RktStxLink" data-pltdoc="x">define-unit</a></span> (or other such forms), the result is two
+values. The first value is for the unit&rsquo;s imports, and the second is
+for the unit&rsquo;s exports. Each result value is a list, where each list
+element pairs a symbol or <span class="RktVal">#f</span> with an identifier. The symbol
+or <span class="RktVal">#f</span> indicates the import&rsquo;s or export&rsquo;s tag (where
+<span class="RktVal">#f</span> indicates no tag), and the identifier indicates the
+binding of the corresponding signature.</div></p><p>If <span class="RktVar">unit-identifier</span> is not bound to static unit information,
+then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax</a></span> exception is raised. In that case, the given
+<span class="RktVar">err-syntax</span> argument is used as the source of the error, where
+<span class="RktVar">unit-identifier</span> is used as the detail source location.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unit-exptime..rkt)._signature-members))"></a><span title="Provided from: racket/unit-exptime | Package: base"><span class="RktSym"><a href="Transformer_Helpers.html#%28def._%28%28lib._racket%2Funit-exptime..rkt%29._signature-members%29%29" class="RktValDef RktValLink" data-pltdoc="x">signature-members</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">sig-identifier</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">err-syntax</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sig-identifier</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">err-syntax</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">If <span class="RktVar">sig-identifier</span> is bound to static unit information via
+<span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature%29%29" class="RktStxLink" data-pltdoc="x">define-signature</a></span> (or other such forms), the result is four
+values:</div></p><ul><li><p>an identifier or <span class="RktVal">#f</span> indicating the signature (of any)
+that is extended by the <span class="RktVar">sig-identifier</span> binding;</p></li><li><p>a list of identifiers representing the variables
+supplied/required by the signature;</p></li><li><p>a list of identifiers for variable definitions in the
+signature (i.e., variable bindings that are provided on
+import, but not defined by units that implement the
+signature); and</p></li><li><p>a list of identifiers with syntax definitions in the signature.</p></li></ul><p>Each of the result identifiers is given lexical information that is
+based on <span class="RktVar">sig-identifier</span>, so the names are suitable for
+reference or binding in the context of <span class="RktVar">sig-identifier</span>.
+See <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature%29%29" class="RktStxLink" data-pltdoc="x">define-signature</a></span> for more information.</p><p>If <span class="RktVar">sig-identifier</span> is not bound to a signature, then the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax</a></span> exception is raised. In that case, the given
+<span class="RktVar">err-syntax</span> argument is used as the source of the error, where
+<span class="RktVar">sig-identifier</span> is used as the detail source location.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unit-exptime..rkt)._unit-static-init-dependencies))"></a><span title="Provided from: racket/unit-exptime | Package: base"><span class="RktSym"><a href="Transformer_Helpers.html#%28def._%28%28lib._racket%2Funit-exptime..rkt%29._unit-static-init-dependencies%29%29" class="RktValDef RktValLink" data-pltdoc="x">unit-static-init-dependencies</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">unit-identifier</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">err-syntax</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">unit-identifier</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">err-syntax</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">If <span class="RktVar">unit-identifier</span> is bound to static unit information via
+<span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%29%29" class="RktStxLink" data-pltdoc="x">define-unit</a></span> (or other such forms), the result is a list of
+pairs. Each pair combines a tag (or <span class="RktVal">#f</span> for no tag) and a
+signature name, indicating an initialization dependency of the unit on
+the specified import (i.e., the same tag and signature are included in
+the first result from <span class="RktSym"><a href="Transformer_Helpers.html#%28def._%28%28lib._racket%2Funit-exptime..rkt%29._unit-static-signatures%29%29" class="RktValLink" data-pltdoc="x">unit-static-signatures</a></span>).</div></p><p>If <span class="RktVar">unit-identifier</span> is not bound to static unit information,
+then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax</a></span> exception is raised. In that case, the given
+<span class="RktVar">err-syntax</span> argument is used as the source of the error, where
+<span class="RktVar">unit-identifier</span> is used as the detail source location.</p><p class="SHistory">Added in version 6.1.1.8 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Single-Signature_Modules.html" title="backward to &quot;7.11 Single-Signature Modules&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contracts.html" title="forward to &quot;8 Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Unit_Utilities.html b/clones/docs.racket-lang.org/reference/Unit_Utilities.html
new file mode 100644
index 00000000..5e9e836f
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Unit_Utilities.html
@@ -0,0 +1,4 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7.8&nbsp;Unit Utilities</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="creatingunits.html" class="tocviewlink" data-pltdoc="x">Creating Units</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="invokingunits.html" class="tocviewlink" data-pltdoc="x">Invoking Units</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="compoundunits.html" class="tocviewlink" data-pltdoc="x">Linking Units and Creating Compound Units</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="linkinference.html" class="tocviewlink" data-pltdoc="x">Inferred Linking</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="Generating_A_Unit_from_Context.html" class="tocviewlink" data-pltdoc="x">Generating A Unit from Context</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="Structural_Matching.html" class="tocviewlink" data-pltdoc="x">Structural Matching</a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="define-sig-form.html" class="tocviewlink" data-pltdoc="x">Extending the Syntax of Signatures</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Unit_Utilities.html" class="tocviewselflink" data-pltdoc="x">Unit Utilities</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="unitcontracts.html" class="tocviewlink" data-pltdoc="x">Unit Contracts</a></td></tr><tr><td align="right">7.10&nbsp;</td><td><a href="single-unit.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Unit Modules</a></td></tr><tr><td align="right">7.11&nbsp;</td><td><a href="Single-Signature_Modules.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Signature Modules</a></td></tr><tr><td align="right">7.12&nbsp;</td><td><a href="Transformer_Helpers.html" class="tocviewlink" data-pltdoc="x">Transformer Helpers</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Unit_Utilities.html#%28def._%28%28lib._racket%2Funit..rkt%29._unit~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unit?</span></span></a></td></tr><tr><td><a href="Unit_Utilities.html#%28form._%28%28lib._racket%2Funit..rkt%29._provide-signature-elements%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">provide-<wbr></wbr>signature-<wbr></wbr>elements</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="define-sig-form.html" title="backward to &quot;7.7 Extending the Syntax of Signatures&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="unitcontracts.html" title="forward to &quot;7.9 Unit Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Unit_Utilities&quot;">7.8<tt>&nbsp;</tt><a name="(part._.Unit_.Utilities)"></a>Unit Utilities</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unit..rkt)._unit~3f))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="Unit_Utilities.html#%28def._%28%28lib._racket%2Funit..rkt%29._unit~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">unit?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a unit, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._provide-signature-elements))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="Unit_Utilities.html#%28form._%28%28lib._racket%2Funit..rkt%29._provide-signature-elements%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">provide-signature-elements</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Expands to a <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> of all identifiers implied by the
+<span class="RktVar">sig-spec</span>s. See <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span> for the grammar of
+<span class="RktVar">sig-spec</span>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="define-sig-form.html" title="backward to &quot;7.7 Extending the Syntax of Signatures&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="unitcontracts.html" title="forward to &quot;7.9 Unit Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/Writing.html b/clones/docs.racket-lang.org/reference/Writing.html
new file mode 100644
index 00000000..04e43ffb
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/Writing.html
@@ -0,0 +1,140 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.5&nbsp;Writing</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewselflink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">display</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._writeln%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">writeln</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">displayln</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._println%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">println</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._fprintf%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fprintf</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">printf</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._eprintf%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eprintf</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">format</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-pair-curly-braces%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-<wbr></wbr>pair-<wbr></wbr>curly-<wbr></wbr>braces</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-mpair-curly-braces%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-<wbr></wbr>mpair-<wbr></wbr>curly-<wbr></wbr>braces</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-unreadable%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-<wbr></wbr>unreadable</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-graph%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-<wbr></wbr>graph</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-struct%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-<wbr></wbr>struct</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-box%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-<wbr></wbr>box</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-vector-length%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-<wbr></wbr>vector-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-hash-table%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-<wbr></wbr>hash-<wbr></wbr>table</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-boolean-long-form%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-<wbr></wbr>boolean-<wbr></wbr>long-<wbr></wbr>form</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-reader-abbreviations%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-<wbr></wbr>reader-<wbr></wbr>abbreviations</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-<wbr></wbr>as-<wbr></wbr>expression</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-syntax-width%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-<wbr></wbr>syntax-<wbr></wbr>width</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._print-value-columns%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-<wbr></wbr>value-<wbr></wbr>columns</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._current-write-relative-directory%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>write-<wbr></wbr>relative-<wbr></wbr>directory</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._port-write-handler%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>write-<wbr></wbr>handler</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._port-display-handler%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>display-<wbr></wbr>handler</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._port-print-handler%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>print-<wbr></wbr>handler</span></span></a></td></tr><tr><td><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._global-port-print-handler%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">global-<wbr></wbr>port-<wbr></wbr>print-<wbr></wbr>handler</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Reading.html" title="backward to &quot;13.4 Reading&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="pretty-print.html" title="forward to &quot;13.6 Pretty Printing&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Writing&quot;">13.5<tt>&nbsp;</tt><a name="(part._.Writing)"></a>Writing</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._write))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValDef RktValLink" data-pltdoc="x">write</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">datum</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">out</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">datum</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Writes <span class="RktVar">datum</span> to <span class="RktVar">out</span>, normally in such a way that
+instances of core datatypes can be read back in. If <span class="RktVar">out</span> has a
+handler associated to it via <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._port-write-handler%29%29" class="RktValLink" data-pltdoc="x">port-write-handler</a></span>, then the
+handler is called. Otherwise, the <a href="printing.html" data-pltdoc="x">default printer</a> is used (in
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> mode), as configured by various parameters.</div></p><p>See <a href="printing.html" data-pltdoc="x">The Printer</a> for more information about the default
+printer. In particular, note that <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> may require memory
+proportional to the depth of the value being printed, due to the
+initial cycle check.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">hi</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">hi</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">#&lt;procedure&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-string%29%29" class="RktValLink" data-pltdoc="x">open-output-string</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-string%29%29" class="RktValLink" data-pltdoc="x">get-output-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"\"hello\""</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._display))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValDef RktValLink" data-pltdoc="x">display</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">datum</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">out</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">datum</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Displays <span class="RktVar">datum</span> to <span class="RktVar">out</span>, similar to <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>,
+but usually in such a way that byte- and character-based datatypes are
+written as raw bytes or characters. If <span class="RktVar">out</span> has a handler
+associated to it via <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._port-display-handler%29%29" class="RktValLink" data-pltdoc="x">port-display-handler</a></span>, then the handler
+is called. Otherwise, the <a href="printing.html" data-pltdoc="x">default printer</a> is used (in <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>
+mode), as configured by various parameters.</div></p><p>See <a href="printing.html" data-pltdoc="x">The Printer</a> for more information about the default
+printer. In particular, note that <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> may require memory
+proportional to the depth of the value being printed, due to the
+initial cycle check.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._print))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValDef RktValLink" data-pltdoc="x">print</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">datum</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span><span class="RktVar">quote-depth</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">datum</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">quote-depth</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr></table></blockquote></div><div class="SIntrapara">Prints <span class="RktVar">datum</span> to <span class="RktVar">out</span>. If <span class="RktVar">out</span> has a handler
+associated to it via <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._port-print-handler%29%29" class="RktValLink" data-pltdoc="x">port-print-handler</a></span>, then the handler is
+called. Otherwise, the handler specified by
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._global-port-print-handler%29%29" class="RktValLink" data-pltdoc="x">global-port-print-handler</a></span> is called; the default handler uses
+the <a href="printing.html" data-pltdoc="x">default printer</a> in <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode.</div></p><p>The optional <span class="RktVar">quote-depth</span> argument adjusts printing when the
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValLink" data-pltdoc="x">print-as-expression</a></span> parameter is set to <span class="RktVal">#t</span>. In that
+case, <span class="RktVar">quote-depth</span> specifies the starting quote depth for
+printing <span class="RktVar">datum</span>.</p><p>The rationale for providing <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> is that <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>
+and <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> both have specific output conventions, and those
+conventions restrict the ways that an environment can change the
+behavior of <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> and <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> procedures. No output
+conventions should be assumed for <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>, so that environments
+are free to modify the actual output generated by <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> in
+any way.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._writeln))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._writeln%29%29" class="RktValDef RktValLink" data-pltdoc="x">writeln</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">datum</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">out</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">datum</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span><span class="stt"> </span><span class="RktVar">datum</span><span class="stt"> </span><span class="RktVar">out</span><span class="RktPn">)</span> followed by <span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._newline%29%29" class="RktValLink" data-pltdoc="x">newline</a></span><span class="stt"> </span><span class="RktVar">out</span><span class="RktPn">)</span>.</div></p><p class="SHistory">Added in version 6.1.1.8 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._displayln))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValDef RktValLink" data-pltdoc="x">displayln</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">datum</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">out</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">datum</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="stt"> </span><span class="RktVar">datum</span><span class="stt"> </span><span class="RktVar">out</span><span class="RktPn">)</span> followed by <span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._newline%29%29" class="RktValLink" data-pltdoc="x">newline</a></span><span class="stt"> </span><span class="RktVar">out</span><span class="RktPn">)</span>,
+which is similar to <span class="stt">println</span> in Pascal or Java.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._println))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._println%29%29" class="RktValDef RktValLink" data-pltdoc="x">println</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">datum</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span><span class="RktVar">quote-depth</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">datum</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">quote-depth</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span><span class="stt"> </span><span class="RktVar">datum</span><span class="stt"> </span><span class="RktVar">out</span><span class="stt"> </span><span class="RktVar">quote-depth</span><span class="RktPn">)</span> followed by
+<span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._newline%29%29" class="RktValLink" data-pltdoc="x">newline</a></span><span class="stt"> </span><span class="RktVar">out</span><span class="RktPn">)</span>.</div></p><p>The <span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._println%29%29" class="RktValLink" data-pltdoc="x">println</a></span> function is not equivalent to <span class="stt">println</span> in
+other languages, because <span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._println%29%29" class="RktValLink" data-pltdoc="x">println</a></span> uses printing conventions
+that are closer to <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> than to <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>. For a closer
+analog to <span class="stt">println</span> in other languages, use <span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span>.</p><p class="SHistory">Added in version 6.1.1.8 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._fprintf))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._fprintf%29%29" class="RktValDef RktValLink" data-pltdoc="x">fprintf</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Prints formatted output to <span class="RktVar">out</span>, where <span class="RktVar">form</span> is a string
+that is printed directly, except for special formatting
+escapes:</div></p><ul><li><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">~n</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">~%</span><span class="hspace"></span></span> prints a newline character (which
+is equivalent to <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\n</span><span class="hspace"></span></span> in a literal format string)</p></li><li><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">~a</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">~A</span><span class="hspace"></span></span> <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>s the next argument
+among the <span class="RktVar">v</span>s</p></li><li><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">~s</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">~S</span><span class="hspace"></span></span> <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>s the next argument
+among the <span class="RktVar">v</span>s</p></li><li><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">~v</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">~V</span><span class="hspace"></span></span> <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>s the next argument
+among the <span class="RktVar">v</span>s</p></li><li><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">~.</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">c</span>&#8250;</span> where <span class="sroman">&#8249;<span style="font-style: italic">c</span>&#8250;</span> is <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">A</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">s</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">S</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">v</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">V</span><span class="hspace"></span></span>:
+truncates default-handler <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>, <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>, or <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> output
+to <span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-print-width%29%29" class="RktValLink" data-pltdoc="x">error-print-width</a></span><span class="RktPn">)</span> characters, using <span class="RktInBG"><span class="hspace"></span><span class="RktIn">...</span><span class="hspace"></span></span> as
+the last three characters if the untruncated output would be longer</p></li><li><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">~e</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">~E</span><span class="hspace"></span></span> outputs the next argument among the
+<span class="RktVar">v</span>s using the current error value conversion handler (see
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-value-~3estring-handler%29%29" class="RktValLink" data-pltdoc="x">error-value-&gt;string-handler</a></span>) and current error printing
+width</p></li><li><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">~c</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">~C</span><span class="hspace"></span></span> <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-char%29%29" class="RktValLink" data-pltdoc="x">write-char</a></span>s the
+next argument in <span class="RktVar">v</span>s; if the next argument is not a
+character, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised</p></li><li><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">~b</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">~B</span><span class="hspace"></span></span> prints the next argument among the
+<span class="RktVar">v</span>s in binary; if the next argument is not an exact number, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised</p></li><li><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">~o</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">~O</span><span class="hspace"></span></span> prints the next argument among the
+<span class="RktVar">v</span>s in octal; if the next argument is not an exact number, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised</p></li><li><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">~x</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">~X</span><span class="hspace"></span></span> prints the next argument among the
+<span class="RktVar">v</span>s in hexadecimal; if the next argument is not an exact
+number, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised</p></li><li><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">~~</span><span class="hspace"></span></span> prints a tilde.</p></li><li><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">~</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">w</span>&#8250;</span>, where <span class="sroman">&#8249;<span style="font-style: italic">w</span>&#8250;</span> is a whitespace
+character (see <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-whitespace~3f%29%29" class="RktValLink" data-pltdoc="x">char-whitespace?</a></span>), skips characters in
+<span class="RktVar">form</span> until a non-whitespace character is encountered or
+until a second end-of-line is encountered (whichever happens
+first). On all platforms, an end-of-line can be <span class="RktVal">#\return</span>,
+<span class="RktVal">#\newline</span>, or <span class="RktVal">#\return</span> followed immediately by
+<span class="RktVal">#\newline</span>.</p></li></ul><p>The <span class="RktVar">form</span> string must not contain any <span class="RktInBG"><span class="hspace"></span><span class="RktIn">~</span><span class="hspace"></span></span> that is
+not one of the above escapes, otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. When the format string requires more
+<span class="RktVar">v</span>s than are supplied, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. Similarly, when more <span class="RktVar">v</span>s are
+supplied than are used by the format string, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._fprintf%29%29" class="RktValLink" data-pltdoc="x">fprintf</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"~a as a string is ~s.\n"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"(3 4)"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">(3 4) as a string is "(3 4)".</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._printf))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValDef RktValLink" data-pltdoc="x">printf</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._fprintf%29%29" class="RktValLink" data-pltdoc="x">fprintf</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">form</span><span class="stt"> </span><span class="RktVar">v</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._eprintf))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._eprintf%29%29" class="RktValDef RktValLink" data-pltdoc="x">eprintf</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._fprintf%29%29" class="RktValLink" data-pltdoc="x">fprintf</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-error-port%29%29" class="RktValLink" data-pltdoc="x">current-error-port</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">form</span><span class="stt"> </span><span class="RktVar">v</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._format))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValDef RktValLink" data-pltdoc="x">format</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Formats to a string. The result is the same as</div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">o</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-string%29%29" class="RktValLink" data-pltdoc="x">open-output-string</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._fprintf%29%29" class="RktValLink" data-pltdoc="x">fprintf</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="hspace">&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-string%29%29" class="RktValLink" data-pltdoc="x">get-output-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a as a string is ~s.\n"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"(3 4)"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"(3 4) as a string is \"(3 4)\".\n"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._print-pair-curly-braces))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-pair-curly-braces%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-pair-curly-braces</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-pair-curly-braces%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-pair-curly-braces</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls pair printing. If the value is true, then
+pairs print using <span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span> instead of
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>. The default is <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._print-mpair-curly-braces))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-mpair-curly-braces%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-mpair-curly-braces</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-mpair-curly-braces%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-mpair-curly-braces</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls pair printing. If the value is true, then
+mutable pairs print using <span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span> instead of
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>. The default is <span class="RktVal">#t</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._print-unreadable))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-unreadable%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-unreadable</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-unreadable%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-unreadable</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that enables or disables printing of values that have no
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>able form (using the default reader), including
+structures that have a custom-write procedure (see
+<span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">prop:custom-write</a></span>), but not including <a href="symbols.html#%28tech._uninterned%29" class="techoutside" data-pltdoc="x"><span class="techinside">uninterned</span></a>
+symbols and <a href="symbols.html#%28tech._unreadable._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">unreadable symbols</span></a> (which print the same as
+<a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> symbols). If the parameter value is <span class="RktVal">#f</span>, an
+attempt to print an unreadable value raises <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span>. The
+parameter value defaults to <span class="RktVal">#t</span>. See <a href="printing.html" data-pltdoc="x">The Printer</a> for
+more information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._print-graph))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-graph%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-graph</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-graph%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-graph</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls printing data with sharing; defaults to
+<span class="RktVal">#f</span>. See <a href="printing.html" data-pltdoc="x">The Printer</a> for more information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._print-struct))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-struct%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-struct</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-struct%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-struct</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls printing structure values in vector or
+<a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> form; defaults to <span class="RktVal">#t</span>. See <a href="printing.html" data-pltdoc="x">The Printer</a>
+for more information. This parameter has no effect on the printing of
+structures that have a custom-write procedure (see
+<span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">prop:custom-write</a></span>).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._print-box))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-box%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-box</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-box%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-box</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls printing box values; defaults to
+<span class="RktVal">#t</span>. See <a href="printing.html#%28part._print-box%29" data-pltdoc="x">Printing Boxes</a> for more information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._print-vector-length))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-vector-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-vector-length</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-vector-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-vector-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls printing vectors; defaults to
+<span class="RktVal">#f</span>. See <a href="printing.html#%28part._print-vectors%29" data-pltdoc="x">Printing Vectors</a> for more information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._print-hash-table))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-hash-table%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-hash-table</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-hash-table%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-hash-table</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls printing hash tables; defaults to
+<span class="RktVal">#t</span>. See <a href="printing.html#%28part._print-hashtable%29" data-pltdoc="x">Printing Hash Tables</a> for more information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._print-boolean-long-form))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-boolean-long-form%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-boolean-long-form</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-boolean-long-form%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-boolean-long-form</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls printing of booleans. When the parameter&rsquo;s
+value is true, <span class="RktVal">#t</span> and <span class="RktVal">#f</span> print as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#true</span><span class="hspace"></span></span>
+and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#false</span><span class="hspace"></span></span>, otherwise they print as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#t</span><span class="hspace"></span></span>
+and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#f</span><span class="hspace"></span></span>. The default is <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._print-reader-abbreviations))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-reader-abbreviations%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-reader-abbreviations</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-reader-abbreviations%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-reader-abbreviations</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls printing of two-element lists that start
+with <span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span>, <span class="RktVal">'</span><span class="RktVal">quasiquote</span>, <span class="RktVal">'</span><span class="RktVal">unquote</span>,
+<span class="RktVal">'</span><span class="RktVal">unquote-splicing</span>, <span class="RktVal">'</span><span class="RktVal">syntax</span>, <span class="RktVal">'</span><span class="RktVal">quasisyntax</span>,
+<span class="RktVal">'</span><span class="RktVal">unsyntax</span>, or <span class="RktVal">'</span><span class="RktVal">unsyntax-splicing</span>; defaults to
+<span class="RktVal">#f</span>. See <a href="printing.html#%28part._print-pairs%29" data-pltdoc="x">Printing Pairs and Lists</a> for more information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._print-as-expression))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-as-expression</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-as-expression</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls printing in <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode (as opposed
+to <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> or <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>); defaults to <span class="RktVal">#t</span>. See
+<a href="printing.html" data-pltdoc="x">The Printer</a> for more information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._print-syntax-width))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-syntax-width%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-syntax-width</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-syntax-width%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-syntax-width</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">width</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls printing of <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax objects</span></a>. Up to
+<span class="RktVar">width</span> characters are used to show the datum form of a syntax
+object within <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&lt;syntax</span><span class="hspace"></span></span>...<span class="RktInBG"><span class="hspace"></span><span class="RktIn">&gt;</span><span class="hspace"></span></span> (after the
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>&rsquo;s source location, if any), where <span class="RktInBG"><span class="hspace"></span><span class="RktIn">...</span><span class="hspace"></span></span> is
+used as the last three characters if the printed form would otherwise be longer
+than <span class="RktVar">width</span> characters. A value of <span class="RktVal">0</span> for
+<span class="RktVar">width</span> means that the datum is not shown at all.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._print-value-columns))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._print-value-columns%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-value-columns</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._print-value-columns%29%29" class="RktValDef RktValLink" data-pltdoc="x">print-value-columns</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">columns</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">columns</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that contains a recommendation for the number of
+columns that should be used for printing values via <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>.
+May or may not be respected by <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> - the current default
+handler for <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> does not.  It is expected that REPLs that use
+some form of pretty-printing for values respect this parameter.</div></p><p class="SHistory">Added in version 8.0.0.13 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-write-relative-directory))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._current-write-relative-directory%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-write-relative-directory</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._current-write-relative-directory%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-write-relative-directory</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that is used when writing compiled code (see <a href="printing.html#%28part._print-compiled%29" data-pltdoc="x">Printing Compiled Code</a>) that contains
+pathname literals, including source-location pathnames for procedure
+names. When the parameter&rsquo;s value is a <span class="RktVar">path</span>, paths that syntactically extend <span class="RktVar">path</span>
+are converted to relative paths; when the resulting
+compiled code is read, relative paths are converted back to complete
+paths using the <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-load-relative-directory</a></span> parameter (if
+it is not <span class="RktVal">#f</span>; otherwise, the path is left relative).
+When the parameter&rsquo;s value is <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="stt"> </span><span class="RktVar">rel-to-path</span><span class="stt"> </span><span class="RktVar">base-path</span><span class="RktPn">)</span>, then
+paths that syntactically extend <span class="RktVar">base-path</span> are converted as relative to <span class="RktVar">rel-to-path</span>;
+the <span class="RktVar">rel-to-path</span> must extend <span class="RktVar">base-path</span>, in which case <span class="RktVal">'</span><span class="RktVal">up</span>
+path elements (in the sense of <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span>) may be used to make a path relative
+to <span class="RktVar">rel-to-path</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._port-write-handler))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._port-write-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-write-handler</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">out</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._port-write-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-write-handler</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._port-display-handler))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._port-display-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-display-handler</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">out</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._port-display-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-display-handler</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._port-print-handler))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._port-print-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-print-handler</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">out</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._port-print-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-print-handler</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Gets or sets the <a name="(tech._port._write._handler)"></a><span style="font-style: italic">port write handler</span>, <a name="(tech._port._display._handler)"></a><span style="font-style: italic">port display
+handler</span>, or <a name="(tech._port._print._handler)"></a><span style="font-style: italic">port print handler</span> for <span class="RktVar">out</span>. This
+handler is called to output to the port when <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>,
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>, or <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> (respectively) is applied to the
+port.  Each handler must accept two arguments: the value to be printed and
+the destination port. The handler&rsquo;s return value is ignored.</div></p><p>A <a href="Writing.html#%28tech._port._print._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">port print handler</span></a> optionally accepts a third argument, which
+corresponds to the optional third argument to <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>; if a
+procedure given to <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._port-print-handler%29%29" class="RktValLink" data-pltdoc="x">port-print-handler</a></span> does not accept a third
+argument, it is wrapped with a procedure that discards the optional
+third argument.</p><p>The default port display and write handlers print Racket expressions
+with Racket&rsquo;s built-in printer (see <a href="printing.html" data-pltdoc="x">The Printer</a>). The
+default print handler calls the global port print handler (the value
+of the <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._global-port-print-handler%29%29" class="RktValLink" data-pltdoc="x">global-port-print-handler</a></span> parameter); the default
+global port print handler is the same as the default write handler.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._global-port-print-handler))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._global-port-print-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">global-port-print-handler</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._global-port-print-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">global-port-print-handler</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines <a name="(tech._global._port._print._handler)"></a><span style="font-style: italic">global port print handler</span>,
+which is called by the default port print handler (see
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._port-print-handler%29%29" class="RktValLink" data-pltdoc="x">port-print-handler</a></span>) to <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> values into a port.
+The default value uses the built-in printer (see
+<a href="printing.html" data-pltdoc="x">The Printer</a>) in <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode.</div></p><p>A <a href="Writing.html#%28tech._global._port._print._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">global port print handler</span></a> optionally accepts a third
+argument, which corresponds to the optional third argument to
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>. If a procedure given to
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._global-port-print-handler%29%29" class="RktValLink" data-pltdoc="x">global-port-print-handler</a></span> does not accept a third argument,
+it is wrapped with a procedure that discards the optional third
+argument.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Reading.html" title="backward to &quot;13.4 Reading&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="pretty-print.html" title="forward to &quot;13.6 Pretty Printing&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/__expression.html b/clones/docs.racket-lang.org/reference/__expression.html
new file mode 100644
index 00000000..c1c2844d
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/__expression.html
@@ -0,0 +1,22 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.4&nbsp;Expression Wrapper: #%expression</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewselflink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="__expression.html#%28form._%28%28quote._~23~25kernel%29._~23~25expression%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="quote.html" title="backward to &quot;3.3 Literals: quote and #%datum&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="__top.html" title="forward to &quot;3.5 Variable References and #%top&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;#%expression&quot;">3.4<tt>&nbsp;</tt><a name="(part._~23~25expression)"></a>Expression Wrapper: <span class="RktSym"><a href="__expression.html#%28form._%28%28quote._~23~25kernel%29._~23~25expression%29%29" class="RktStxLink" data-pltdoc="x">#%expression</a></span></h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._~23~25expression))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="__expression.html#%28form._%28%28quote._~23~25kernel%29._~23~25expression%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">#%expression</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Produces the same result as <span class="RktVar">expr</span>. Using
+<span class="RktSym"><a href="__expression.html#%28form._%28%28quote._~23~25kernel%29._~23~25expression%29%29" class="RktStxLink" data-pltdoc="x">#%expression</a></span> forces the parsing of a form as an
+expression.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="__expression.html#%28form._%28%28quote._~23~25kernel%29._~23~25expression%29%29" class="RktStxLink" data-pltdoc="x">#%expression</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="__expression.html#%28form._%28%28quote._~23~25kernel%29._~23~25expression%29%29" class="RktStxLink" data-pltdoc="x">#%expression</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">eval:8:0: define: not allowed in an expression context</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (define x 10)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara">The <span class="RktSym"><a href="__expression.html#%28form._%28%28quote._~23~25kernel%29._~23~25expression%29%29" class="RktStxLink" data-pltdoc="x">#%expression</a></span> form is helpful in recursive definition contexts
+where expanding a subsequent definition can provide compile-time information
+for the current expression. For example, consider a <span class="RktSym">define-sym-case</span>
+macro that simply records some symbols at compile-time in a given identifier.
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-sym-case</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Library_Syntax_Classes_and_Literal_Sets.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._id%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">id</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sym</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._andmap%29%29" class="RktValLink" data-pltdoc="x">andmap</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3elist%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">sym</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Library_Syntax_Classes_and_Literal_Sets.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._id%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">id</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">sym</span><span class="hspace">&nbsp;</span><span class="RktVal">...</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">and then a variant of <span class="RktSym"><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="RktStxLink" data-pltdoc="x">case</a></span> that checks to make sure the symbols
+used in the expression match those given in the earlier definition:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">sym-case</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Library_Syntax_Classes_and_Literal_Sets.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._id%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">id</a></span><span class="hspace">&nbsp;</span><span class="RktSym">val-expr</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">sym</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">expected-ids</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Library_Syntax_Classes_and_Literal_Sets.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._id%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">id</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._raise-syntax-error%29%29" class="RktValLink" data-pltdoc="x">raise-syntax-error</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">sym-case</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"expected an identifier bound via define-sym-case"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">stx</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Library_Syntax_Classes_and_Literal_Sets.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._id%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">id</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">actual-ids</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">sym</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._unless%29%29" class="RktStxLink" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">expected-ids</span><span class="hspace">&nbsp;</span><span class="RktSym">actual-ids</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._raise-syntax-error%29%29" class="RktValLink" data-pltdoc="x">raise-syntax-error</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">sym-case</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"expected the symbols ~s"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">expected-ids</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="RktStxLink" data-pltdoc="x">case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">val-expr</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">sym</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara">If the definition follows the use like this, then
+the <span class="RktSym">define-sym-case</span> macro does not have
+a chance to bind <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Library_Syntax_Classes_and_Literal_Sets.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._id%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">id</a></span> and the <span class="RktSym">sym-case</span>
+macro signals an error:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">sym-case</span><span class="hspace">&nbsp;</span><span class="RktSym">land-creatures</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">bear</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">bear</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">fox</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-sym-case</span><span class="hspace">&nbsp;</span><span class="RktSym">land-creatures</span><span class="hspace">&nbsp;</span><span class="RktSym">bear</span><span class="hspace">&nbsp;</span><span class="RktSym">fox</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">eval:11:0: sym-case: expected an identifier bound via</span></p></td></tr><tr><td><p><span class="RktErr">define-sym-case</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: land-creatures</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (sym-case land-creatures (quote bear) ((bear) 1)</span></p></td></tr><tr><td><p><span class="RktErr">((fox) 2))</span></p></td></tr></table></blockquote></div><div class="SIntrapara">But if the <span class="RktSym">sym-case</span> is wrapped in an <span class="RktSym"><a href="__expression.html#%28form._%28%28quote._~23~25kernel%29._~23~25expression%29%29" class="RktStxLink" data-pltdoc="x">#%expression</a></span>,
+then the expander does not need to expand it to know it is
+an expression and it moves on to the <span class="RktSym">define-sym-case</span>
+expression.
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="__expression.html#%28form._%28%28quote._~23~25kernel%29._~23~25expression%29%29" class="RktStxLink" data-pltdoc="x">#%expression</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">sym-case</span><span class="hspace">&nbsp;</span><span class="RktSym">sea-creatures</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">whale</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">whale</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">squid</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-sym-case</span><span class="hspace">&nbsp;</span><span class="RktSym">sea-creatures</span><span class="hspace">&nbsp;</span><span class="RktSym">whale</span><span class="hspace">&nbsp;</span><span class="RktSym">squid</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">more...</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'more...</span></p></td></tr></table></blockquote></div><div class="SIntrapara">Of course, a macro like <span class="RktSym">sym-case</span> should not require its
+clients to add <span class="RktSym"><a href="__expression.html#%28form._%28%28quote._~23~25kernel%29._~23~25expression%29%29" class="RktStxLink" data-pltdoc="x">#%expression</a></span>; instead it should check
+the basic shape of its arguments and then expand to <span class="RktSym"><a href="__expression.html#%28form._%28%28quote._~23~25kernel%29._~23~25expression%29%29" class="RktStxLink" data-pltdoc="x">#%expression</a></span>
+wrapped around a helper macro that calls <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value</a></span>
+and finishes the expansion.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="quote.html" title="backward to &quot;3.3 Literals: quote and #%datum&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="__top.html" title="forward to &quot;3.5 Variable References and #%top&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/__top-interaction.html b/clones/docs.racket-lang.org/reference/__top-interaction.html
new file mode 100644
index 00000000..6ad4bd33
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/__top-interaction.html
@@ -0,0 +1,6 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.22&nbsp;Interaction Wrapper: #%top-interaction</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewselflink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="__top-interaction.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25top-interaction%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Syntax_Quoting__quote-syntax.html" title="backward to &quot;3.21 Syntax Quoting: quote-syntax&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="block.html" title="forward to &quot;3.23 Blocks: block&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;#%top-interaction&quot;">3.22<tt>&nbsp;</tt><a name="(part._~23~25top-interaction)"></a>Interaction Wrapper: <span class="RktSym"><a href="__top-interaction.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25top-interaction%29%29" class="RktStxLink" data-pltdoc="x">#%top-interaction</a></span></h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._~23~25top-interaction))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="__top-interaction.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25top-interaction%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">#%top-interaction</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">form</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Expands to simply <span class="RktVar">form</span>. The <span class="RktSym"><a href="__top-interaction.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25top-interaction%29%29" class="RktStxLink" data-pltdoc="x">#%top-interaction</a></span> form
+is similar to <span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25app%29%29" class="RktStxLink" data-pltdoc="x">#%app</a></span> and <span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25module-begin%29%29" class="RktStxLink" data-pltdoc="x">#%module-begin</a></span>, in that it
+provides a hook to control interactive evaluation through
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%29%29" class="RktValLink" data-pltdoc="x">load</a></span> (more precisely, the default <a href="eval.html#%28tech._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">load handler</span></a>) or
+<span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._read-eval-print-loop%29%29" class="RktValLink" data-pltdoc="x">read-eval-print-loop</a></span>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Syntax_Quoting__quote-syntax.html" title="backward to &quot;3.21 Syntax Quoting: quote-syntax&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="block.html" title="forward to &quot;3.23 Blocks: block&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/__top.html b/clones/docs.racket-lang.org/reference/__top.html
new file mode 100644
index 00000000..35529954
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/__top.html
@@ -0,0 +1,24 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.5&nbsp;Variable References and #%top</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewselflink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="__expression.html" title="backward to &quot;3.4 Expression Wrapper: #%expression&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Locations____variable-reference.html" title="forward to &quot;3.6 Locations: #%variable-reference&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;#%top&quot;">3.5<tt>&nbsp;</tt><a name="(part._~23~25top)"></a>Variable References and <span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span></h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktVar">id</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Refers to a top-level, module-level, or local binding, when <span class="RktVar">id</span> is
+not bound as a transformer (see <a href="syntax-model.html#%28part._expansion%29" data-pltdoc="x">Expansion</a>). At run-time,
+the reference evaluates to the value in the <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a> associated with
+the binding.</div></p><p>When the expander encounters an <span class="RktVar">id</span> that is not bound by a
+module-level or local binding, it converts the expression to
+<span class="RktPn">(</span><span class="RktSym">#%top</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">id</span><span class="RktPn">)</span> giving <span class="RktSym">#%top</span>
+the lexical context of the <span class="RktVar">id</span>; typically, that context refers
+to <span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span>. See also <a href="syntax-model.html#%28part._expand-steps%29" data-pltdoc="x">Expansion Steps</a>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">x</span></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._~23~25top))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">#%top</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">id</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to <span class="RktVar">id</span> when <span class="RktVar">id</span> is bound to a module-level
+or top-level variable. In a top-level context, <span class="RktPn">(</span><span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">id</span><span class="RktPn">)</span>
+always refers to a top-level variable, even if <span class="RktVar">id</span> is
+<a href="syntax-model.html#%28tech._unbound%29" class="techoutside" data-pltdoc="x"><span class="techinside">unbound</span></a> or bound to syntax, as long as <span class="RktVar">id</span> does not
+have a local binding. In all contexts, <span class="RktPn">(</span><span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">id</span><span class="RktPn">)</span> is
+a syntax error if <span class="RktVar">id</span> has a local binding.</div></p><p>Within a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> form, <span class="RktPn">(</span><span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">id</span><span class="RktPn">)</span> expands to just
+<span class="RktVar">id</span> as long as <span class="RktVar">id</span> is defined within
+the module and has no local binding in its context. At <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase
+level</span></a> 0, <span class="RktPn">(</span><span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">id</span><span class="RktPn">)</span> is an immediate syntax error if
+<span class="RktVar">id</span> is not bound. At <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 1 and higher, a syntax
+error is reported if <span class="RktVar">id</span> is not defined at the corresponding
+phase by the end of <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>-body <a href="syntax-model.html#%28tech._partial._expansion%29" class="techoutside" data-pltdoc="x"><span class="techinside">partial expansion</span></a>.</p><p>See also <a href="syntax-model.html#%28part._expand-steps%29" data-pltdoc="x">Expansion Steps</a> for information on how the expander
+introduces <span class="RktSym">#%top</span> identifiers.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">12</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">12</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.3 of package <span class="stt">base</span>: Changed the introduction of
+<span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span> in a top-level context
+to <a href="syntax-model.html#%28tech._unbound%29" class="techoutside" data-pltdoc="x"><span class="techinside">unbound</span></a> identifiers only.<br/>Changed in version 8.2.0.7: Changed treatment of locally bound <span class="RktVar">id</span> to
+always report a syntax error, even outside of a module.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="__expression.html" title="backward to &quot;3.4 Expression Wrapper: #%expression&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Locations____variable-reference.html" title="forward to &quot;3.6 Locations: #%variable-reference&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/all-sync.html b/clones/docs.racket-lang.org/reference/all-sync.html
new file mode 100644
index 00000000..920ea234
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/all-sync.html
@@ -0,0 +1,7 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>11.2&nbsp;Synchronization</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewselflink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.1&nbsp;</td><td><a href="threads.html" class="tocviewlink" data-pltdoc="x">Threads</a></td></tr><tr><td align="right">11.2&nbsp;</td><td><a href="all-sync.html" class="tocviewselflink" data-pltdoc="x">Synchronization</a></td></tr><tr><td align="right">11.3&nbsp;</td><td><a href="thread-local-storage.html" class="tocviewlink" data-pltdoc="x">Thread-<wbr></wbr>Local Storage</a></td></tr><tr><td align="right">11.4&nbsp;</td><td><a href="futures.html" class="tocviewlink" data-pltdoc="x">Futures</a></td></tr><tr><td align="right">11.5&nbsp;</td><td><a href="places.html" class="tocviewlink" data-pltdoc="x">Places</a></td></tr><tr><td align="right">11.6&nbsp;</td><td><a href="engine.html" class="tocviewlink" data-pltdoc="x">Engines</a></td></tr><tr><td align="right">11.7&nbsp;</td><td><a href="memory-order.html" class="tocviewlink" data-pltdoc="x">Machine Memory Order</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>11.2&nbsp;</td><td><a href="all-sync.html" class="tocviewselflink" data-pltdoc="x">Synchronization</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.2.1&nbsp;</td><td><a href="sync.html" class="tocviewlink" data-pltdoc="x">Events</a></td></tr><tr><td align="right">11.2.2&nbsp;</td><td><a href="channel.html" class="tocviewlink" data-pltdoc="x">Channels</a></td></tr><tr><td align="right">11.2.3&nbsp;</td><td><a href="semaphore.html" class="tocviewlink" data-pltdoc="x">Semaphores</a></td></tr><tr><td align="right">11.2.4&nbsp;</td><td><a href="async-channel.html" class="tocviewlink" data-pltdoc="x">Buffered Asynchronous Channels</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="threads.html" title="backward to &quot;11.1 Threads&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="concurrency.html" title="up to &quot;11 Concurrency and Parallelism&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="sync.html" title="forward to &quot;11.2.1 Events&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;all-sync&quot;">11.2<tt>&nbsp;</tt><a name="(part._all-sync)"></a>Synchronization</h4><p>Racket&rsquo;s synchronization toolbox spans four layers:</p><ul><li><p><a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable events</span></a> &#8212;<wbr></wbr> a general framework for
+synchronization;</p></li><li><p><a href="channel.html#%28tech._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">channels</span></a> &#8212;<wbr></wbr> a primitive that can be used, in principle,
+to build most other kinds of synchronizable events (except the ones
+that compose events); and</p></li><li><p><a href="semaphore.html#%28tech._semaphore%29" class="techoutside" data-pltdoc="x"><span class="techinside">semaphores</span></a> &#8212;<wbr></wbr> a simple and especially cheap primitive
+for synchronization.</p></li><li><p><a href="futures.html#%28tech._future._semaphore%29" class="techoutside" data-pltdoc="x"><span class="techinside">future semaphores</span></a> &#8212;<wbr></wbr> a simple synchronization primitive
+for use with <a href="futures.html#%28tech._future%29" class="techoutside" data-pltdoc="x"><span class="techinside">futures</span></a>.</p></li></ul><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sync.html" class="toclink" data-pltdoc="x">11.2.1<span class="hspace">&nbsp;</span>Events</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="channel.html" class="toclink" data-pltdoc="x">11.2.2<span class="hspace">&nbsp;</span>Channels</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="semaphore.html" class="toclink" data-pltdoc="x">11.2.3<span class="hspace">&nbsp;</span>Semaphores</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="async-channel.html" class="toclink" data-pltdoc="x">11.2.4<span class="hspace">&nbsp;</span>Buffered Asynchronous Channels</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="async-channel.html#%28part._.Creating_and_.Using_.Asynchronous_.Channels%29" class="toclink" data-pltdoc="x">11.2.4.1<span class="hspace">&nbsp;</span>Creating and Using Asynchronous Channels</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="async-channel.html#%28part._.Contracts_and_.Impersonators_on_.Asynchronous_.Channels%29" class="toclink" data-pltdoc="x">11.2.4.2<span class="hspace">&nbsp;</span>Contracts and Impersonators on Asynchronous Channels</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="threads.html" title="backward to &quot;11.1 Threads&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="concurrency.html" title="up to &quot;11 Concurrency and Parallelism&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="sync.html" title="forward to &quot;11.2.1 Events&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/application.html b/clones/docs.racket-lang.org/reference/application.html
new file mode 100644
index 00000000..a5bbe219
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/application.html
@@ -0,0 +1,29 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.7&nbsp;Procedure Applications and #%app</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewselflink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25app%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-app%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%plain-<wbr></wbr>app</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Locations____variable-reference.html" title="backward to &quot;3.6 Locations: #%variable-reference&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="lambda.html" title="forward to &quot;3.8 Procedure Expressions: lambda and case-lambda&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;application&quot;">3.7<tt>&nbsp;</tt><a name="(part._application)"></a><a name="(idx._(gentag._106._(lib._scribblings/reference/reference..scrbl)))"></a>Procedure Applications and <span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25app%29%29" class="RktStxLink" data-pltdoc="x">#%app</a></span></h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=application.html&amp;version=8.6" class="Sq" data-pltdoc="x">Function Calls</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces procedure applications.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktVar">proc-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Applies a procedure, when <span class="RktVar">proc-expr</span> is not an
+identifier that has a transformer binding (see
+<a href="syntax-model.html#%28part._expansion%29" data-pltdoc="x">Expansion</a>).</div></p><p>More precisely, the expander converts this form to
+<span class="RktPn">(</span><span class="RktSym">#%app</span><span class="stt"> </span><span class="RktVar">proc-expr</span><span class="stt"> </span><span class="RktVar">arg</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>, giving
+<span class="RktSym">#%app</span> the lexical context that is associated with the
+original form (i.e., the pair that combines <span class="RktVar">proc-expr</span> and its
+arguments). Typically, the lexical context of the pair indicates the
+procedure-application <span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25app%29%29" class="RktStxLink" data-pltdoc="x">#%app</a></span> that is described next. See also
+<a href="syntax-model.html#%28part._expand-steps%29" data-pltdoc="x">Expansion Steps</a>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">#:arg</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:arg</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(2 1)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._~23~25app))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25app%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">#%app</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Applies a procedure. Each <span class="RktVar">arg</span> is one of the following:</div></p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">arg-expr</span></td></tr></table></blockquote><p>The resulting value is a non-keyword
+argument.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktVar">arg-expr</span></td></tr></table></blockquote><p>The resulting value is a
+keyword argument using <span class="RktVar">keyword</span>. Each
+<span class="RktVar">keyword</span> in the application must be distinct.</p></blockquote><p>The <span class="RktVar">proc-expr</span> and <span class="RktVar">arg-expr</span>s are evaluated in order,
+left to right. If the result of <span class="RktVar">proc-expr</span> is a procedure that
+accepts as many arguments as non-<span class="RktVar">keyword</span>
+<span class="RktVar">arg-expr</span>s, if it accepts arguments for all of the
+<span class="RktVar">keyword</span>s in the application, and if all required
+keyword-based arguments are represented among the <span class="RktVar">keyword</span>s
+in the application, then the procedure is called with the values of
+the <span class="RktSym">arg-expr</span>s. Otherwise, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>The continuation of the procedure call is the same as the continuation
+of the application expression, so the results of the procedure are the
+results of the application expression.</p><p>The relative order of <span class="RktVar">keyword</span>-based arguments matters only
+for the order of <span class="RktVar">arg-expr</span> evaluations; the arguments are
+associated with argument variables in the applied procedure based on
+the <span class="RktVar">keyword</span>s, and not their positions. The other
+<span class="RktVar">arg-expr</span> values, in contrast, are associated with variables
+according to their order in the application form.</p><p>See also <a href="syntax-model.html#%28part._expand-steps%29" data-pltdoc="x">Expansion Steps</a> for information on how the
+expander introduces <span class="RktSym">#%app</span> identifiers.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25app%29%29" class="RktStxLink" data-pltdoc="x">#%app</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25app%29%29" class="RktStxLink" data-pltdoc="x">#%app</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">#:arg</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:arg</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(2 1)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25app%29%29" class="RktStxLink" data-pltdoc="x">#%app</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">cons: arity mismatch;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">the expected number of arguments does not match the given</span></p></td></tr><tr><td><p><span class="RktErr">number</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: 2</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._~23~25plain-app))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-app%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">#%plain-app</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">arg-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-app%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">#%plain-app</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25app%29%29" class="RktStxLink" data-pltdoc="x">#%app</a></span>, but without support for keyword arguments.
+As a special case, <span class="RktPn">(</span><span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-app%29%29" class="RktStxLink" data-pltdoc="x">#%plain-app</a></span><span class="RktPn">)</span> produces <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Locations____variable-reference.html" title="backward to &quot;3.6 Locations: #%variable-reference&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="lambda.html" title="forward to &quot;3.8 Procedure Expressions: lambda and case-lambda&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/async-channel.html b/clones/docs.racket-lang.org/reference/async-channel.html
new file mode 100644
index 00000000..33c38ccf
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/async-channel.html
@@ -0,0 +1,41 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>11.2.4&nbsp;Buffered Asynchronous Channels</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewselflink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.1&nbsp;</td><td><a href="threads.html" class="tocviewlink" data-pltdoc="x">Threads</a></td></tr><tr><td align="right">11.2&nbsp;</td><td><a href="all-sync.html" class="tocviewselflink" data-pltdoc="x">Synchronization</a></td></tr><tr><td align="right">11.3&nbsp;</td><td><a href="thread-local-storage.html" class="tocviewlink" data-pltdoc="x">Thread-<wbr></wbr>Local Storage</a></td></tr><tr><td align="right">11.4&nbsp;</td><td><a href="futures.html" class="tocviewlink" data-pltdoc="x">Futures</a></td></tr><tr><td align="right">11.5&nbsp;</td><td><a href="places.html" class="tocviewlink" data-pltdoc="x">Places</a></td></tr><tr><td align="right">11.6&nbsp;</td><td><a href="engine.html" class="tocviewlink" data-pltdoc="x">Engines</a></td></tr><tr><td align="right">11.7&nbsp;</td><td><a href="memory-order.html" class="tocviewlink" data-pltdoc="x">Machine Memory Order</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>11.2&nbsp;</td><td><a href="all-sync.html" class="tocviewlink" data-pltdoc="x">Synchronization</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.2.1&nbsp;</td><td><a href="sync.html" class="tocviewlink" data-pltdoc="x">Events</a></td></tr><tr><td align="right">11.2.2&nbsp;</td><td><a href="channel.html" class="tocviewlink" data-pltdoc="x">Channels</a></td></tr><tr><td align="right">11.2.3&nbsp;</td><td><a href="semaphore.html" class="tocviewlink" data-pltdoc="x">Semaphores</a></td></tr><tr><td align="right">11.2.4&nbsp;</td><td><a href="async-channel.html" class="tocviewselflink" data-pltdoc="x">Buffered Asynchronous Channels</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_3&quot;);">&#9658;</a></td><td>11.2.4&nbsp;</td><td><a href="async-channel.html" class="tocviewselflink" data-pltdoc="x">Buffered Asynchronous Channels</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_3"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.2.4.1&nbsp;</td><td><a href="async-channel.html#%28part._.Creating_and_.Using_.Asynchronous_.Channels%29" class="tocviewlink" data-pltdoc="x">Creating and Using Asynchronous Channels</a></td></tr><tr><td align="right">11.2.4.2&nbsp;</td><td><a href="async-channel.html#%28part._.Contracts_and_.Impersonators_on_.Asynchronous_.Channels%29" class="tocviewlink" data-pltdoc="x">Contracts and Impersonators on Asynchronous Channels</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">11.2.4.1<tt>&nbsp;</tt></span><a href="async-channel.html#%28part._.Creating_and_.Using_.Asynchronous_.Channels%29" class="tocsubseclink" data-pltdoc="x">Creating and Using Asynchronous Channels</a></td></tr><tr><td><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">async-<wbr></wbr>channel?</span></span></a></td></tr><tr><td><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._make-async-channel%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>async-<wbr></wbr>channel</span></span></a></td></tr><tr><td><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-get%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">async-<wbr></wbr>channel-<wbr></wbr>get</span></span></a></td></tr><tr><td><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-try-get%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">async-<wbr></wbr>channel-<wbr></wbr>try-<wbr></wbr>get</span></span></a></td></tr><tr><td><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-put%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">async-<wbr></wbr>channel-<wbr></wbr>put</span></span></a></td></tr><tr><td><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-put-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">async-<wbr></wbr>channel-<wbr></wbr>put-<wbr></wbr>evt</span></span></a></td></tr><tr><td><span class="tocsublinknumber">11.2.4.2<tt>&nbsp;</tt></span><a href="async-channel.html#%28part._.Contracts_and_.Impersonators_on_.Asynchronous_.Channels%29" class="tocsubseclink" data-pltdoc="x">Contracts and Impersonators on Asynchronous Channels</a></td></tr><tr><td><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel%2Fc%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">async-<wbr></wbr>channel/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._impersonate-async-channel%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-<wbr></wbr>async-<wbr></wbr>channel</span></span></a></td></tr><tr><td><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._chaperone-async-channel%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-<wbr></wbr>async-<wbr></wbr>channel</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="semaphore.html" title="backward to &quot;11.2.3 Semaphores&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="all-sync.html" title="up to &quot;11.2 Synchronization&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="thread-local-storage.html" title="forward to &quot;11.3 Thread-Local Storage&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;async-channel&quot;">11.2.4<tt>&nbsp;</tt><a name="(part._async-channel)"></a><a name="(mod-path._racket/async-channel)"></a>Buffered Asynchronous Channels</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="async-channel.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/async-channel</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="async-channel.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/async-channel</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Creating_and_Using_Asynchronous_Channels&quot;">11.2.4.1<tt>&nbsp;</tt><a name="(part._.Creating_and_.Using_.Asynchronous_.Channels)"></a>Creating and Using Asynchronous Channels</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span>See also <a href="threads.html#%28part._threadmbox%29" data-pltdoc="x">Thread Mailboxes</a>.</p></blockquote></blockquote></blockquote><p>An <a name="(tech._asynchronous._channel)"></a><span style="font-style: italic">asynchronous channel</span> is like a <a href="channel.html#%28tech._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">channel</span></a>, but it buffers
+values so that a send operation does not wait on a receive operation.</p><p>In addition to its use with procedures that are specific to
+asynchronous channels, an asynchronous channel can be used as a
+<a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> (see <a href="sync.html" data-pltdoc="x">Events</a>).  An asynchronous
+channel is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when
+<span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-get%29%29" class="RktValLink" data-pltdoc="x">async-channel-get</a></span> would not block; the asynchronous channel&rsquo;s
+<a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> is the same as the
+<span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-get%29%29" class="RktValLink" data-pltdoc="x">async-channel-get</a></span> result.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/async-channel..rkt)._async-channel~3f))"></a><span title="Provided from: racket/async-channel | Package: base"><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">async-channel?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is an asynchronous channel,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/async-channel..rkt)._make-async-channel))"></a><span title="Provided from: racket/async-channel | Package: base"><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._make-async-channel%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-async-channel</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">limit</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel~3f%29%29" class="RktValLink" data-pltdoc="x">async-channel?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an asynchronous channel with a buffer limit of <span class="RktVar">limit</span>
+items. A get operation blocks when the channel is empty, and a put
+operation blocks when the channel has <span class="RktVar">limit</span> items already.
+If <span class="RktVar">limit</span> is <span class="RktVal">#f</span>, the channel buffer has no limit (so
+a put never blocks).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/async-channel..rkt)._async-channel-get))"></a><span title="Provided from: racket/async-channel | Package: base"><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-get%29%29" class="RktValDef RktValLink" data-pltdoc="x">async-channel-get</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">ach</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ach</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel~3f%29%29" class="RktValLink" data-pltdoc="x">async-channel?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Blocks until at least one value is available in <span class="RktVar">ach</span>, and then
+returns the first of the values that were put into
+<span class="RktSym">async-channel</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/async-channel..rkt)._async-channel-try-get))"></a><span title="Provided from: racket/async-channel | Package: base"><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-try-get%29%29" class="RktValDef RktValLink" data-pltdoc="x">async-channel-try-get</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">ach</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ach</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel~3f%29%29" class="RktValLink" data-pltdoc="x">async-channel?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">If at least one value is immediately available in <span class="RktVar">ach</span>,
+returns the first of the values that were put into <span class="RktVar">ach</span>. If
+<span class="RktSym">async-channel</span> is empty, the result is <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/async-channel..rkt)._async-channel-put))"></a><span title="Provided from: racket/async-channel | Package: base"><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-put%29%29" class="RktValDef RktValLink" data-pltdoc="x">async-channel-put</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">ach</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ach</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel~3f%29%29" class="RktValLink" data-pltdoc="x">async-channel?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Puts <span class="RktVar">v</span> into <span class="RktVar">ach</span>, blocking if <span class="RktVar">ach</span>&rsquo;s buffer
+is full until space is available.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/async-channel..rkt)._async-channel-put-evt))"></a><span title="Provided from: racket/async-channel | Package: base"><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-put-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">async-channel-put-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">ach</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ach</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel~3f%29%29" class="RktValLink" data-pltdoc="x">async-channel?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> that is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for
+synchronization</span></a> when <span class="RktPn">(</span><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-put%29%29" class="RktValLink" data-pltdoc="x">async-channel-put</a></span><span class="stt"> </span><span class="RktVar">ach</span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span> would return
+a value (i.e., when the channel holds fewer values already than its
+limit); the <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> of a asynchronous channel-put event is the asynchronous channel-put event itself.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">server</span><span class="hspace">&nbsp;</span><span class="RktSym">input-channel</span><span class="hspace">&nbsp;</span><span class="RktSym">output-channel</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-get%29%29" class="RktValLink" data-pltdoc="x">async-channel-get</a></span><span class="hspace">&nbsp;</span><span class="RktSym">input-channel</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">put</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-put%29%29" class="RktValLink" data-pltdoc="x">async-channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">output-channel</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">do-large-computation</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sqrt%29%29" class="RktValLink" data-pltdoc="x">sqrt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">data</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="RktStxLink" data-pltdoc="x">case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">data</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">quit</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">add</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">put</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">long</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">put</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">do-large-computation</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">to-server</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._make-async-channel%29%29" class="RktValLink" data-pltdoc="x">make-async-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">from-server</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._make-async-channel%29%29" class="RktValLink" data-pltdoc="x">make-async-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">server</span><span class="hspace">&nbsp;</span><span class="RktSym">to-server</span><span class="hspace">&nbsp;</span><span class="RktSym">from-server</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;thread&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel~3f%29%29" class="RktValLink" data-pltdoc="x">async-channel?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">to-server</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Adding 1 to 4\n"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Adding 1 to 4</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-put%29%29" class="RktValLink" data-pltdoc="x">async-channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">to-server</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">add</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-put%29%29" class="RktValLink" data-pltdoc="x">async-channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">to-server</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Result is ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-get%29%29" class="RktValLink" data-pltdoc="x">async-channel-get</a></span><span class="hspace">&nbsp;</span><span class="RktSym">from-server</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Result is 5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Ask server to do a long computation\n"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Ask server to do a long computation</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-put%29%29" class="RktValLink" data-pltdoc="x">async-channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">to-server</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">long</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"I can do other stuff\n"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">I can do other stuff</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Ok, computation from server is ~a\n"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-get%29%29" class="RktValLink" data-pltdoc="x">async-channel-get</a></span><span class="hspace">&nbsp;</span><span class="RktSym">from-server</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">Ok, computation from server is 3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-put%29%29" class="RktValLink" data-pltdoc="x">async-channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">to-server</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">quit</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Contracts_and_Impersonators_on_Asynchronous_Channels&quot;">11.2.4.2<tt>&nbsp;</tt><a name="(part._.Contracts_and_.Impersonators_on_.Asynchronous_.Channels)"></a>Contracts and Impersonators on Asynchronous Channels</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/async-channel..rkt)._async-channel/c))"></a><span title="Provided from: racket/async-channel | Package: base"><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">async-channel/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a contract that recognizes asynchronous channels. Values put into or
+retrieved from the channel must match <span class="RktVar">c</span>.</div></p><p>If the <span class="RktVar">c</span> argument is a flat contract or a chaperone contract, then the
+result will be a chaperone contract. Otherwise, the result will be an
+impersonator contract.</p><p>When an <span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel%2Fc%29%29" class="RktValLink" data-pltdoc="x">async-channel/c</a></span> contract is applied to an asynchronous channel,
+the result is not <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to the input. The result will be either a
+<a href="chaperones.html#%28tech._chaperone%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone</span></a> or <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a> of the input depending on the type of
+contract.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/async-channel..rkt)._impersonate-async-channel))"></a><span title="Provided from: racket/async-channel | Package: base"><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._impersonate-async-channel%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonate-async-channel</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">channel</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">get-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">put-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel~3f%29%29" class="RktValLink" data-pltdoc="x">async-channel?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">channel</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel~3f%29%29" class="RktValLink" data-pltdoc="x">async-channel?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">get-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">put-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an impersonator of <span class="RktVar">channel</span>, which redirects the
+<span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-get%29%29" class="RktValLink" data-pltdoc="x">async-channel-get</a></span> and <span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-put%29%29" class="RktValLink" data-pltdoc="x">async-channel-put</a></span> operations.</div></p><p>The <span class="RktVar">get-proc</span> must accept the value that <span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-get%29%29" class="RktValLink" data-pltdoc="x">async-channel-get</a></span>
+produces on <span class="RktVar">channel</span>; it must produce a replacement value, which is the
+result of the get operation on the impersonator.</p><p>The <span class="RktVar">put-proc</span> must accept the value passed to <span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-put%29%29" class="RktValLink" data-pltdoc="x">async-channel-put</a></span>
+called on <span class="RktVar">channel</span>; it must produce a replacement value, which is the
+value passed to the put procedure called on the original channel.</p><p>The <span class="RktVar">get-proc</span> and <span class="RktVar">put-proc</span> procedures are called for all
+operations that get or put values from the channel, not just
+<span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-get%29%29" class="RktValLink" data-pltdoc="x">async-channel-get</a></span> and <span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-put%29%29" class="RktValLink" data-pltdoc="x">async-channel-put</a></span>.</p><p>Pairs of <span class="RktVar">prop</span> and <span class="RktVar">prop-val</span> (the number of arguments to
+<span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._impersonate-async-channel%29%29" class="RktValLink" data-pltdoc="x">impersonate-async-channel</a></span> must be odd) add
+<a href="chaperones.html#%28tech._impersonator._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator properties</span></a> or override <a href="chaperones.html#%28tech._impersonator._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator property</span></a> values
+of <span class="RktVar">channel</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/async-channel..rkt)._chaperone-async-channel))"></a><span title="Provided from: racket/async-channel | Package: base"><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._chaperone-async-channel%29%29" class="RktValDef RktValLink" data-pltdoc="x">chaperone-async-channel</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">channel</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">get-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">put-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel~3f%29%29" class="RktValLink" data-pltdoc="x">async-channel?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">channel</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel~3f%29%29" class="RktValLink" data-pltdoc="x">async-channel?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">get-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">put-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._impersonate-async-channel%29%29" class="RktValLink" data-pltdoc="x">impersonate-async-channel</a></span>, but the <span class="RktVar">get-proc</span> procedure
+must produce the same value or a chaperone of the original value, and
+<span class="RktVar">put-proc</span> must produce the same value or a chaperone of the original
+value.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="semaphore.html" title="backward to &quot;11.2.3 Semaphores&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="all-sync.html" title="up to &quot;11.2 Synchronization&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="thread-local-storage.html" title="forward to &quot;11.3 Thread-Local Storage&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/attaching-contracts-to-values.html b/clones/docs.racket-lang.org/reference/attaching-contracts-to-values.html
new file mode 100644
index 00000000..30b53028
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/attaching-contracts-to-values.html
@@ -0,0 +1,151 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>8.6&nbsp;Attaching Contracts to Values</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.1&nbsp;</td><td><a href="data-structure-contracts.html" class="tocviewlink" data-pltdoc="x">Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.2&nbsp;</td><td><a href="function-contracts.html" class="tocviewlink" data-pltdoc="x">Function Contracts</a></td></tr><tr><td align="right">8.3&nbsp;</td><td><a href="parametric-contracts.html" class="tocviewlink" data-pltdoc="x">Parametric Contracts</a></td></tr><tr><td align="right">8.4&nbsp;</td><td><a href="Lazy_Data-structure_Contracts.html" class="tocviewlink" data-pltdoc="x">Lazy Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.5&nbsp;</td><td><a href="Structure_Type_Property_Contracts.html" class="tocviewlink" data-pltdoc="x">Structure Type Property Contracts</a></td></tr><tr><td align="right">8.6&nbsp;</td><td><a href="attaching-contracts-to-values.html" class="tocviewselflink" data-pltdoc="x">Attaching Contracts to Values</a></td></tr><tr><td align="right">8.7&nbsp;</td><td><a href="Building_New_Contract_Combinators.html" class="tocviewlink" data-pltdoc="x">Building New Contract Combinators</a></td></tr><tr><td align="right">8.8&nbsp;</td><td><a href="contract-utilities.html" class="tocviewlink" data-pltdoc="x">Contract Utilities</a></td></tr><tr><td align="right">8.9&nbsp;</td><td><a href="racket_contract_base.html" class="tocviewlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>contract/<span class="mywbr"> &nbsp;</span>base</span></span></a></td></tr><tr><td align="right">8.10&nbsp;</td><td><a href="collapsible.html" class="tocviewlink" data-pltdoc="x">Collapsible Contracts</a></td></tr><tr><td align="right">8.11&nbsp;</td><td><a href="Legacy_Contracts.html" class="tocviewlink" data-pltdoc="x">Legacy Contracts</a></td></tr><tr><td align="right">8.12&nbsp;</td><td><a href="Random_generation.html" class="tocviewlink" data-pltdoc="x">Random generation</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>8.6&nbsp;</td><td><a href="attaching-contracts-to-values.html" class="tocviewselflink" data-pltdoc="x">Attaching Contracts to Values</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.6.1&nbsp;</td><td><a href="attaching-contracts-to-values.html#%28part._.Nested_.Contract_.Boundaries%29" class="tocviewlink" data-pltdoc="x">Nested Contract Boundaries</a></td></tr><tr><td align="right">8.6.2&nbsp;</td><td><a href="attaching-contracts-to-values.html#%28part._.Low-level_.Contract_.Boundaries%29" class="tocviewlink" data-pltdoc="x">Low-<wbr></wbr>level Contract Boundaries</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._contract-out%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">contract-<wbr></wbr>out</span></span></a></td></tr><tr><td><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._recontract-out%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">recontract-<wbr></wbr>out</span></span></a></td></tr><tr><td><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fprovide..rkt%29._provide%2Fcontract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">provide/<span class="mywbr"> &nbsp;</span>contract</span></span></a></td></tr><tr><td><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._struct-guard%2Fc%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct-<wbr></wbr>guard/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><span class="tocsublinknumber">8.6.1<tt>&nbsp;</tt></span><a href="attaching-contracts-to-values.html#%28part._.Nested_.Contract_.Boundaries%29" class="tocsubseclink" data-pltdoc="x">Nested Contract Boundaries</a></td></tr><tr><td><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._with-contract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/<span class="mywbr"> &nbsp;</span>contract</span></span></a></td></tr><tr><td><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._struct%2Fcontract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct/<span class="mywbr"> &nbsp;</span>contract</span></span></a></td></tr><tr><td><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define-struct%2Fcontract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>struct/<span class="mywbr"> &nbsp;</span>contract</span></span></a></td></tr><tr><td><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._invariant-assertion%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">invariant-<wbr></wbr>assertion</span></span></a></td></tr><tr><td><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._current-contract-region%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">current-<wbr></wbr>contract-<wbr></wbr>region</span></span></a></td></tr><tr><td><span class="tocsublinknumber">8.6.2<tt>&nbsp;</tt></span><a href="attaching-contracts-to-values.html#%28part._.Low-level_.Contract_.Boundaries%29" class="tocsubseclink" data-pltdoc="x">Low-<wbr></wbr>level Contract Boundaries</a></td></tr><tr><td><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fprovide..rkt%29._define-module-boundary-contract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>module-<wbr></wbr>boundary-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._contract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">contract</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Structure_Type_Property_Contracts.html" title="backward to &quot;8.5 Structure Type Property Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Building_New_Contract_Combinators.html" title="forward to &quot;8.7 Building New Contract Combinators&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;attaching-contracts-to-values&quot;">8.6<tt>&nbsp;</tt><a name="(part._attaching-contracts-to-values)"></a>Attaching Contracts to Values</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/base..rkt)._contract-out))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._contract-out%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">contract-out</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">unprotected-submodule</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-out-item</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">unprotected-submodule</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:unprotected-submodule</span><span class="hspace">&nbsp;</span><span class="RktVar">submodule-name</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">contract-out-item</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id/ignored</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">struct-option</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._rename%29%29" class="RktStxLink" data-pltdoc="x">rename</a></span><span class="hspace">&nbsp;</span><span class="RktVar">orig-id</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:&#8707;</span><span class="hspace">&nbsp;</span><span class="RktVar">poly-variables</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:exists</span><span class="hspace">&nbsp;</span><span class="RktVar">poly-variables</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:&#8704;</span><span class="hspace">&nbsp;</span><span class="RktVar">poly-variables</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:forall</span><span class="hspace">&nbsp;</span><span class="RktVar">poly-variables</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">poly-variables</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">id/ignored</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">ignored-id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">struct-option</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:omit-constructor</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <span class="RktVar">provide-spec</span> for use in <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> (currently only for
+the same <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> as the <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> form; for example,
+<span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._contract-out%29%29" class="RktStxLink" data-pltdoc="x">contract-out</a></span> cannot be nested within <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span>). Each <span class="RktVar">id</span>
+is provided from the module. In
+addition, clients of the module must live up to the contract specified
+by <span class="RktVar">contract-expr</span> for each export.</div></p><p>The <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._contract-out%29%29" class="RktStxLink" data-pltdoc="x">contract-out</a></span> form treats modules as units of
+blame. The module that defines the provided variable is expected to
+meet the positive (co-variant) positions of the contract. Each module
+that imports the provided variable must obey the negative
+(contra-variant) positions of the contract. Each <span class="RktVar">contract-expr</span>
+in a <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._contract-out%29%29" class="RktStxLink" data-pltdoc="x">contract-out</a></span> form is effectively moved to the end of the
+enclosing module, so a <span class="RktVar">contract-expr</span> can refer to variables
+that are defined later in the same module.</p><p>Only uses of the contracted variable outside the module are
+checked. Inside the module, no contract checking occurs.</p><p>The <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._rename%29%29" class="RktStxLink" data-pltdoc="x">rename</a></span> form of <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._contract-out%29%29" class="RktStxLink" data-pltdoc="x">contract-out</a></span> exports the
+first variable (the internal name) with the name specified by the
+second variable (the external name).</p><p>The <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> form of <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._contract-out%29%29" class="RktStxLink" data-pltdoc="x">contract-out</a></span>
+provides a structure-type definition <span class="RktVar">id</span>, and each field has a contract
+that dictates the contents of the fields. Unlike a <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>
+definition, however, all of the fields (and their contracts) must be
+listed. The contract on the fields that the sub-struct shares with its
+parent are only used in the contract for the sub-struct&rsquo;s constructor, and
+the selector or mutators for the super-struct are not provided. The
+exported structure-type name always doubles as a constructor, even if
+the original structure-type name does not act as a constructor.
+If the <span class="RktPn">#:omit-constructor</span> option is present, the constructor
+is not provided. The second form of <span class="RktVar">id/ignored</span>, which has both
+<span class="RktVar">id</span> and <span class="RktVar">ignored-id</span>, is deprecated and allowed
+in the grammar only for backward compatability, where <span class="RktVar">ignored-id</span> is ignored.
+The first form should be used instead.</p><p>Note that if the struct is created with <span class="RktSym"><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._serializable-struct%29%29" class="RktStxLink" data-pltdoc="x">serializable-struct</a></span>
+or <span class="RktSym"><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._define-serializable-struct%29%29" class="RktStxLink" data-pltdoc="x">define-serializable-struct</a></span>, <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._contract-out%29%29" class="RktStxLink" data-pltdoc="x">contract-out</a></span> does not
+protect struct instances that are created via
+<span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="RktValLink" data-pltdoc="x">deserialize</a></span>. Consider using <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._struct-guard%2Fc%29%29" class="RktStxLink" data-pltdoc="x">struct-guard/c</a></span> instead.</p><p>The <span class="RktPn">#:&#8707;</span>, <span class="RktPn">#:exists</span>, <span class="RktPn">#:&#8704;</span>, and <span class="RktPn">#:forall</span>
+clauses define new abstract contracts. The variables are bound in the
+remainder of the <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._contract-out%29%29" class="RktStxLink" data-pltdoc="x">contract-out</a></span> form to new contracts that hide
+the values they accept and ensure that the exported functions are treated
+parametrically. See <span class="RktSym"><a href="parametric-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._new-~e2~88~83%2Fc%29%29" class="RktValLink" data-pltdoc="x">new-&#8707;/c</a></span> and <span class="RktSym"><a href="parametric-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._new-~e2~88~80%2Fc%29%29" class="RktValLink" data-pltdoc="x">new-&#8704;/c</a></span> for details
+on how the clauses hide the values.</p><p>If <span class="RktPn">#:unprotected-submodule</span> appears, the identifier
+that follows it is used as the name of a submodule that
+<span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._contract-out%29%29" class="RktStxLink" data-pltdoc="x">contract-out</a></span> generates. The submodule exports all
+of the names in the <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._contract-out%29%29" class="RktStxLink" data-pltdoc="x">contract-out</a></span>, but without
+contracts.</p><p>The implementation of <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._contract-out%29%29" class="RktStxLink" data-pltdoc="x">contract-out</a></span> uses
+<span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property%29%29" class="RktValLink" data-pltdoc="x">syntax-property</a></span> to attach properties to the code it generates
+that records the syntax of the contracts in the fully expanded program.
+Specifically, the symbol <a name="(idx._(gentag._196._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">provide/contract-original-contract</span>
+is bound to vectors of two elements, the exported identifier and a
+syntax object for the expression that produces the contract controlling
+the export.</p><p class="SHistory">Changed in version 7.3.0.3 of package <span class="stt">base</span>: Added <span class="RktPn">#:unprotected-submodule</span>.<br/>Changed in version 7.7.0.9: Started ignoring <span class="RktVar">ignored-id</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/base..rkt)._recontract-out))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._recontract-out%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">recontract-out</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <span class="RktVar">provide-spec</span> for use in <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> (currently,
+  just like <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._contract-out%29%29" class="RktStxLink" data-pltdoc="x">contract-out</a></span>, only for
+  the same <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> as the <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> form).</div></p><p>It re-exports <span class="RktVar">id</span>, but with positive blame associated
+to the module containing <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._recontract-out%29%29" class="RktStxLink" data-pltdoc="x">recontract-out</a></span> instead of the
+location of the original site of <span class="RktVar">id</span>.</p><p>This can be useful when a public module wants to export an
+identifier from a private module but where any contract violations
+should be reported in terms of the public module instead of the
+private one.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">private-implementation</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/contract</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">recip</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2F%29%29" class="RktValLink" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">non-zero?</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fprovide..rkt%29._provide%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">provide/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">recip</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">non-zero?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._between%2Fc%29%29" class="RktValLink" data-pltdoc="x">between/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%29%29" class="RktStxLink" data-pltdoc="x">public</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/contract</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">private-implementation</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._recontract-out%29%29" class="RktStxLink" data-pltdoc="x">recontract-out</a></span><span class="hspace">&nbsp;</span><span class="RktSym">recip</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">public</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">recip</span><span class="hspace">&nbsp;</span><span class="RktVal">+nan.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">recip: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: (between/c -1 1)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: +nan.0</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the range of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(and/c real? non-zero?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(between/c -1 1))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: public</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: public</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:3:0</span></p></td></tr></table></blockquote></div></p><p>Replacing the use of <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._recontract-out%29%29" class="RktStxLink" data-pltdoc="x">recontract-out</a></span> with just
+<span class="RktSym">recip</span> would result in a contract violation blaming
+the private module.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/private/provide..rkt)._provide/contract))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fprovide..rkt%29._provide%2Fcontract%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">provide/contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">unprotected-submodule</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-out-item</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A legacy shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._contract-out%29%29" class="RktStxLink" data-pltdoc="x">contract-out</a></span><span class="stt"> </span><span class="RktVar">unprotected-submodule</span><span class="stt"> </span><span class="RktVar">contract-out-item</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span>,
+except that a <span class="RktVar">contract-expr</span> within <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fprovide..rkt%29._provide%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">provide/contract</a></span>
+is evaluated at the position of the <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fprovide..rkt%29._provide%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">provide/contract</a></span> form
+instead of at the end of the enclosing module.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/base..rkt)._struct-guard/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._struct-guard%2Fc%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">struct-guard/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns a procedure suitable to be passed as the <span class="RktPn">#:guard</span>
+argument to <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>, <span class="RktSym"><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._serializable-struct%29%29" class="RktStxLink" data-pltdoc="x">serializable-struct</a></span> (and related forms).
+The guard procedure ensures that each contract protects the
+corresponding field values, as long as the struct is not mutated.
+Mutations are not protected.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">snake</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">weight</span><span class="hspace">&nbsp;</span><span class="RktSym">hungry?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:guard</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._struct-guard%2Fc%29%29" class="RktStxLink" data-pltdoc="x">struct-guard/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">snake</span><span class="hspace">&nbsp;</span><span class="RktVal">1.5</span><span class="hspace">&nbsp;</span><span class="RktVal">"yep"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">snake, field 2: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: boolean?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: "yep"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: boolean?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Nested_Contract_Boundaries&quot;">8.6.1<tt>&nbsp;</tt><a name="(part._.Nested_.Contract_.Boundaries)"></a><a name="(mod-path._racket/contract/region)"></a>Nested Contract Boundaries</h5><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="attaching-contracts-to-values.html#%28mod-path._racket%2Fcontract%2Fregion%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/contract/region</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/region..rkt)._with-contract))"></a><span title="Provided from: racket/contract/region, racket/contract, racket | Package: base"><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._with-contract%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">with-contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">blame-id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">wc-export</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">free-var-list</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._with-contract%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">with-contract</a></span><span class="hspace">&nbsp;</span><span class="RktVar">blame-id</span><span class="hspace">&nbsp;</span><span class="RktVar">results-spec</span><span class="hspace">&nbsp;</span><span class="RktVar">free-var-list</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">wc-export</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">result-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:result</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:results</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">contract-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">free-var-list</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:freevar</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:freevars</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Generates a local contract boundary.</div></p><p>The first <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._with-contract%29%29" class="RktStxLink" data-pltdoc="x">with-contract</a></span> form cannot appear in expression position.
+All names defined within the first <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._with-contract%29%29" class="RktStxLink" data-pltdoc="x">with-contract</a></span> form are
+visible externally, but those names listed in the <span class="RktVar">wc-export</span>
+list are protected with the corresponding contract.  The <span class="RktVar">body</span> of
+the form allows definition/expression interleaving if its context does.</p><p>The second <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._with-contract%29%29" class="RktStxLink" data-pltdoc="x">with-contract</a></span> form must appear in expression position.
+The final <span class="RktVar">body</span> expression should return the same number of values
+as the number of contracts listed in the <span class="RktVar">result-spec</span>, and each
+returned value is contracted with its respective contract.  The sequence
+of <span class="RktVar">body</span> forms is treated as for <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span>.</p><p>The <span class="RktVar">blame-id</span> is used for the positive positions of
+contracts paired with exported <span class="RktVar">id</span>s.  Contracts broken
+within the <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._with-contract%29%29" class="RktStxLink" data-pltdoc="x">with-contract</a></span> <span class="RktVar">body</span> will use the
+<span class="RktVar">blame-id</span> for their negative position.</p><p>If a <span class="RktVar">free-var-list</span> is given, then any uses of the free variables
+inside the <span class="RktVar">body</span> will be protected with contracts that
+blame the context of the <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._with-contract%29%29" class="RktStxLink" data-pltdoc="x">with-contract</a></span> form for the positive
+positions and the <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._with-contract%29%29" class="RktStxLink" data-pltdoc="x">with-contract</a></span> form for the negative ones.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/region..rkt)._define/contract))"></a><span title="Provided from: racket/contract/region, racket/contract, racket | Package: base"><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">free-var-list</span><span class="hspace">&nbsp;</span><span class="RktVar">init-value-expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">head</span><span class="hspace">&nbsp;</span><span class="RktVar">args</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">free-var-list</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Works like <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span>, except that the contract
+<span class="RktVar">contract-expr</span> is attached to the bound value.  For the
+definition of <span class="RktVar">head</span> and <span class="RktVar">args</span>, see <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span>.
+For the definition of <span class="RktVar">free-var-list</span>, see <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._with-contract%29%29" class="RktStxLink" data-pltdoc="x">with-contract</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">distance</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">43.52</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">furlongs-&gt;feet</span><span class="hspace">&nbsp;</span><span class="RktSym">fr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">660</span><span class="hspace">&nbsp;</span><span class="RktSym">fr</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">a contract violation expected here:</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">furlongs-&gt;feet</span><span class="hspace">&nbsp;</span><span class="RktVal">"not a furlong"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">furlongs-&gt;feet: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: real?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: "not a furlong"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; real? real?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (function furlongs-&gt;feet)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:3:0</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span> form treats the individual definition as
+a contract region. The definition itself is responsible for positive
+(co-variant) positions of the contract, and references to
+<span class="RktVar">id</span> outside of the definition must meet the negative
+positions of the contract. Since the contract boundary is
+between the definition and the surrounding context, references to
+<span class="RktVar">id</span> inside the <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span> form are not checked.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">an unsual predicate that prints when called</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">printing-int?</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"I was called"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fact</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">printing-int?</span><span class="hspace">&nbsp;</span><span class="RktSym">printing-int?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fact</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">fact</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">only prints twice, not for each recursive call</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">I was called</span></p></td></tr><tr><td><p><span class="RktOut">I was called</span></p></td></tr></table></td></tr><tr><td><p><span class="RktRes">120</span></p></td></tr></table></blockquote></div></p><p>If a free-var-list is given, then any uses of the free variables
+inside the <span class="RktVar">body</span> will be protected with contracts that
+blame the context of the <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span> form for the positive
+positions and the <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span> form for the negative ones.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">integer-&gt;binary-string</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._number-~3estring%29%29" class="RktValLink" data-pltdoc="x">number-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">numbers-&gt;strings</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:freevar</span><span class="hspace">&nbsp;</span><span class="RktSym">integer-&gt;binary-string</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">mistake, lst might contain inexact numbers</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym">integer-&gt;binary-string</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">numbers-&gt;strings</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">4.0</span><span class="hspace">&nbsp;</span><span class="RktVal">3.3</span><span class="hspace">&nbsp;</span><span class="RktVal">5.8</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">integer-&gt;binary-string: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: exact-integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 4.0</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; exact-integer? string?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (function numbers-&gt;strings)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:3:0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/contract/region..rkt)._struct/contract))"></a><span title="Provided from: racket/contract/region, racket/contract, racket | Package: base"><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._struct%2Fcontract%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">struct/contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">struct-id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">field</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">struct-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._struct%2Fcontract%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">struct/contract</a></span><span class="hspace">&nbsp;</span><span class="RktVar">struct-id</span><span class="hspace">&nbsp;</span><span class="RktVar">super-struct-id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">field</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">struct-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Works like <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>, except that the arguments to the constructor,
+accessors, and mutators are protected by contracts.  For the definitions of
+<span class="RktVar">field</span> and <span class="RktVar">struct-option</span>, see <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>.</div></p><p>The <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._struct%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">struct/contract</a></span> form only allows a subset of the
+<span class="RktVar">struct-option</span> keywords: <span class="RktPn">#:mutable</span>, <span class="RktPn">#:transparent</span>,
+<span class="RktPn">#:auto-value</span>, <span class="RktPn">#:omit-define-syntaxes</span>, and <span class="RktPn">#:property</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._struct%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">struct/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fruit</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">seeds</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">fruit</span><span class="hspace">&nbsp;</span><span class="RktVal">60</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;fruit&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">fruit</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">fruit: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: number?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: #f</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; number? symbol? any)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (struct fruit)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._struct%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">struct/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">apple</span><span class="hspace">&nbsp;</span><span class="RktSym">fruit</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">type</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">apple</span><span class="hspace">&nbsp;</span><span class="RktVal">14</span><span class="hspace">&nbsp;</span><span class="RktVal">"golden delicious"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;apple&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">apple</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">30</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">apple: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: string?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 30</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 2nd argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; any/c string? symbol? any)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (struct apple)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">apple</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">"granny smith"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">fruit: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: number?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: #f</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; number? symbol? any)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (struct fruit)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/contract/region..rkt)._define-struct/contract))"></a><span title="Provided from: racket/contract/region, racket/contract, racket | Package: base"><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define-struct%2Fcontract%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-struct/contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">struct-id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">field</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">struct-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define-struct%2Fcontract%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-struct/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">struct-id</span><span class="hspace">&nbsp;</span><span class="RktVar">super-struct-id</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">field</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">struct-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Works like <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._struct%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">struct/contract</a></span>, except that the syntax for supplying a
+<span class="RktVar">super-struct-id</span> is different, and a <span class="RktVar">constructor-id</span> that
+has a <span class="RktSym">make-</span> prefix on <span class="RktVar">struct-id</span> is implicitly
+supplied.  For the definitions of
+<span class="RktVar">field</span> and <span class="RktVar">struct-option</span>, see <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-struct%29%29" class="RktStxLink" data-pltdoc="x">define-struct</a></span>.
+Like <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> versus <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-struct%29%29" class="RktStxLink" data-pltdoc="x">define-struct</a></span>,
+<span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._struct%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">struct/contract</a></span> is normally preferred to <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define-struct%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define-struct/contract</a></span>.</div></p><p>The <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define-struct%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define-struct/contract</a></span> form only allows a subset of the
+<span class="RktVar">struct-option</span> keywords: <span class="RktPn">#:mutable</span>, <span class="RktPn">#:transparent</span>,
+<span class="RktPn">#:auto-value</span>, <span class="RktPn">#:omit-define-syntaxes</span>, and <span class="RktPn">#:property</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define-struct%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define-struct/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">color</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">make-fish</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;fish&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">make-fish</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">make-fish: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: number?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: #f</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; number? symbol? any)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (struct fish)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define-struct%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define-struct/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">salmon</span><span class="hspace">&nbsp;</span><span class="RktSym">fish</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ocean</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">make-salmon</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">atlantic</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;salmon&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">make-salmon</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">make-salmon: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: symbol?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: #f</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 2nd argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; any/c symbol? symbol? any)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (struct salmon)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">make-salmon</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">pacific</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">make-fish: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: number?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: #f</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; number? symbol? any)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (struct fish)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/private/base..rkt)._invariant-assertion))"></a><span title="Provided from: racket/contract/region, racket/contract, racket | Package: base"><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._invariant-assertion%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">invariant-assertion</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">invariant-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Establishes an invariant of <span class="RktVar">expr</span>, determined by <span class="RktVar">invariant-expr</span>.</div></p><p>Unlike the specification of a contract, an
+<span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._invariant-assertion%29%29" class="RktStxLink" data-pltdoc="x">invariant-assertion</a></span> does not establish a boundary
+between two parties. Instead, it simply attaches a logical assertion
+to the value. Because the form uses contract machinery to check the
+assertion, the surrounding module is treated as the party to be blamed
+for any violations of the assertion.</p><p>This means, for example, that the assertion is checked on
+recursive calls, when an invariant is used on the right-hand
+side of a definition:</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">furlongss-&gt;feets</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._invariant-assertion%29%29" class="RktStxLink" data-pltdoc="x">invariant-assertion</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">l</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._empty~3f%29%29" class="RktValLink" data-pltdoc="x">empty?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._empty%29%29" class="RktValLink" data-pltdoc="x">empty</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">327</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">furlongss-&gt;feets</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"wha?"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">furlongs-&gt;feet</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._first%29%29" class="RktValLink" data-pltdoc="x">first</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">furlongss-&gt;feets</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">furlongss-&gt;feets</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(660 1320 1980)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">furlongss-&gt;feets</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">327</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">furlongss-&gt;feets: assertion violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: real?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: "wha?"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: an element of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; (listof real?) (listof real?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: invariant-assertion</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:5:0</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.0.1.11 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/contract/private/base..rkt)._current-contract-region))"></a><span title="Provided from: racket/contract/region, racket/contract, racket | Package: base"><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._current-contract-region%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">current-contract-region</a></span></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Bound by <span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._define-syntax-parameter%29%29" class="RktStxLink" data-pltdoc="x">define-syntax-parameter</a></span>, this contains
+information about the current contract region, used by
+the above forms to determine the candidates for blame
+assignment.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Low-level_Contract_Boundaries&quot;">8.6.2<tt>&nbsp;</tt><a name="(part._.Low-level_.Contract_.Boundaries)"></a>Low-level Contract Boundaries</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/contract/private/provide..rkt)._define-module-boundary-contract))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fprovide..rkt%29._define-module-boundary-contract%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-module-boundary-contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">orig-id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">contract-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos-blame-party</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">source-loc</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name-for-blame</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">context-limit</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">pos-blame-party</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:pos-source</span><span class="hspace">&nbsp;</span><span class="RktVar">pos-source-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">source-loc</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:srcloc</span><span class="hspace">&nbsp;</span><span class="RktVar">srcloc-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">name-for-blame</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:name-for-blame</span><span class="hspace">&nbsp;</span><span class="RktVar">blame-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">context-limit</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:context-limit</span><span class="hspace">&nbsp;</span><span class="RktVar">limit-expr</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Defines <span class="RktVar">id</span> to be <span class="RktVar">orig-id</span>, but with the contract
+<span class="RktVar">contract-expr</span>.</div></p><p>The identifier <span class="RktVar">id</span> is defined as a macro transformer that
+consults the context of its use to determine the name for negative
+blame assignment (using the entire module where a reference appears
+as the negative party).</p><p>The positive party defaults to the module containing the use of
+<span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fprovide..rkt%29._define-module-boundary-contract%29%29" class="RktStxLink" data-pltdoc="x">define-module-boundary-contract</a></span>, but can be specified explicitly
+via the <span class="RktPn">#:pos-source</span> keyword.</p><p>The source location used in the blame error messages for the location
+of the place where the contract was put on the value defaults to the
+source location of the use of <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fprovide..rkt%29._define-module-boundary-contract%29%29" class="RktStxLink" data-pltdoc="x">define-module-boundary-contract</a></span>,
+but can be specified via the <span class="RktPn">#:srcloc</span> argument, in which case
+it can be any of the things that the third argument to <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span>
+can be.</p><p>The name used in the error messages will be <span class="RktVar">orig-id</span>, unless
+<span class="RktPn">#:name-for-blame</span> is supplied, in which case the identifier
+following it is used as the name in the error messages.</p><p>If <span class="RktPn">#:context-limit</span> is supplied, it behaves the same as
+it does when supplied to <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._contract%29%29" class="RktStxLink" data-pltdoc="x">contract</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">server</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/contract/base</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fprovide..rkt%29._define-module-boundary-contract%29%29" class="RktStxLink" data-pltdoc="x">define-module-boundary-contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">g</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">g</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">client</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">server</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">clients-fault</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">g</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">servers-fault</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">g</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">servers-fault</span><span class="hspace">&nbsp;</span><span class="RktSym">clients-fault</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">client</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">clients-fault</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">g: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: #f</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; integer? integer?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: 'server</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: client</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">servers-fault</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">g: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: #f</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the range of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; integer? integer?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: 'server</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (quote server)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.7.0.4 of package <span class="stt">base</span>: Added the <span class="RktPn">#:name-for-blame</span> argument.<br/>Changed in version 6.90.0.29: Added the <span class="RktPn">#:context-limit</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/contract/private/base..rkt)._contract))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._contract%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">to-protect-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">positive-blame-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">negative-blame-expr</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._contract%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">contract</a></span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">to-protect-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">positive-blame-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">negative-blame-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:context-limit</span><span class="hspace">&nbsp;</span><span class="RktVar">limit-expr</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._contract%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">contract</a></span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">to-protect-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">positive-blame-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">negative-blame-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">value-name-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">source-location-expr</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The primitive mechanism for attaching a contract to a value. The
+purpose of <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._contract%29%29" class="RktStxLink" data-pltdoc="x">contract</a></span> is as a target for the expansion of some
+higher-level contract specifying form.</div></p><p>The <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._contract%29%29" class="RktStxLink" data-pltdoc="x">contract</a></span> expression adds the contract specified by
+<span class="RktVar">contract-expr</span> to the value produced by
+<span class="RktVar">to-protect-expr</span>. The result of a <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._contract%29%29" class="RktStxLink" data-pltdoc="x">contract</a></span> expression
+is the result of the <span class="RktVar">to-protect-expr</span> expression, but with the
+contract specified by <span class="RktVar">contract-expr</span> enforced on
+<span class="RktVar">to-protect-expr</span>.</p><p>The values of <span class="RktVar">positive-blame-expr</span> and <span class="RktVar">negative-blame-expr</span>
+indicate how to assign blame for positive and negative positions of the contract
+specified by <span class="RktVar">contract-expr</span>.  They may be any value, and are formatted
+as by <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> for purposes of contract violation error messages.</p><p><div class="SIntrapara">If specified, <span class="RktVar">value-name-expr</span> indicates a name for the protected value
+to be used in error messages.  If not supplied, or if <span class="RktVar">value-name-expr</span>
+produces <span class="RktVal">#f</span>, no name is printed.  Otherwise, it is also formatted as by
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>. More precisely, the <span class="RktVar">value-name-expr</span> ends up in the
+<span class="RktSym">blame-name</span> field of the blame record, which is used as the first portion
+of the error message.
+</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._contract%29%29" class="RktStxLink" data-pltdoc="x">contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">pos</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">neg</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">timothy</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">timothy: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: #f</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: pos</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: pos</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._contract%29%29" class="RktStxLink" data-pltdoc="x">contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">pos</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">neg</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: #f</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: pos</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: pos</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr></table></blockquote></div></p></div></p><p>If specified, <span class="RktVar">source-location-expr</span> indicates the source location
+reported by contract violations.  The expression must produce a <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span>
+structure, <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>, <span class="RktVal">#f</span>, or a list or vector in the format
+accepted by the third argument to <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span>.</p><p>If <span class="RktPn">#:context-limit</span> is supplied, the following expression
+ must evaluate to either <span class="RktVal">#f</span> or a natural number. If
+ the expression evaluates to an natural number, the number of
+ layers of context information is limited to at most that
+ many. For example, if the number is <span class="RktVal">0</span>, no context
+ information is recorded and the error messages do not contain
+ the section that starts with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">in:</span><span class="hspace"></span></span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Structure_Type_Property_Contracts.html" title="backward to &quot;8.5 Structure Type Property Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Building_New_Contract_Combinators.html" title="forward to &quot;8.7 Building New Contract Combinators&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/begin.html b/clones/docs.racket-lang.org/reference/begin.html
new file mode 100644
index 00000000..ff9d52e2
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/begin.html
@@ -0,0 +1,30 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.15&nbsp;Sequencing: begin, begin0, and begin-for-syntax</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewselflink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">begin</span></span></a></td></tr><tr><td><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin0%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">begin0</span></span></a></td></tr><tr><td><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="define.html" title="backward to &quot;3.14 Definitions: define, define-syntax, ...&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="when_unless.html" title="forward to &quot;3.16 Guarded Evaluation: when and unless&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;begin&quot;">3.15<tt>&nbsp;</tt><a name="(part._begin)"></a>Sequencing: <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span>, <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin0%29%29" class="RktStxLink" data-pltdoc="x">begin0</a></span>, and <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span></h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=begin.html&amp;version=8.6" class="Sq" data-pltdoc="x">Sequencing</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> and <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin0%29%29" class="RktStxLink" data-pltdoc="x">begin0</a></span>.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._begin))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">begin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">The first form applies when <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> appears at the top level,
+at module level, or in an internal-definition position (before any
+expression in the internal-definition sequence). In that case, the
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> form is equivalent to splicing the <span class="RktVar">form</span>s into
+the enclosing context.</div></p><p>The second form applies for <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> in an expression position.
+In that case, the <span class="RktVar">expr</span>s are evaluated in order, and the
+results are ignored for all but the last <span class="RktVar">expr</span>. The last
+<span class="RktVar">expr</span> is in tail position with respect to the <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span>
+form.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hi\n"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">hi</span></p></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(1 2)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._begin0))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin0%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">begin0</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Evaluates the first <span class="RktVar">expr</span>, then evaluates the other <span class="RktSym">exprs</span>s
+in order, ignoring their results. The results of the first <span class="RktVar">expr</span>
+are the results of the <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin0%29%29" class="RktStxLink" data-pltdoc="x">begin0</a></span> form; the first <span class="RktVar">expr</span> is
+in tail position only if no other <span class="RktVar">expr</span>s are present.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin0%29%29" class="RktStxLink" data-pltdoc="x">begin0</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hi\n"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">hi</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._begin-for-syntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">begin-for-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Allowed only in a <a href="syntax-model.html#%28tech._top._level._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level context</span></a> or <a href="syntax-model.html#%28tech._module._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">module context</span></a>,
+shifts the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> of each <span class="RktVar">form</span> by one:</div></p><ul><li><p>expressions reference bindings at a <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> one
+greater than in the context of the <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span>
+form;</p></li><li><p><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span>, <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span>,
+<span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span>, and <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span> forms bind
+at a <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> one greater than in the context of the
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> form;</p></li><li><p>in <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> and <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> forms, the default
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> is greater, which is roughly like wrapping
+the content of the <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> form with
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span>;</p></li><li><p>expression form <span class="RktVar">expr</span>: converted to
+<span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fdefine..rkt%29._define-values-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-values-for-syntax</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktVar">expr</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>, which
+effectively evaluates the expression at expansion time and, in
+the case of a <a href="syntax-model.html#%28tech._module._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">module context</span></a>, preserves the expression
+for future <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>s of the module.</p></li></ul><p>See also <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> for information about expansion order and
+partial expansion for <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> within a module
+context. Evaluation of an <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Library_Syntax_Classes_and_Literal_Sets.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._expr%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">expr</a></span> within
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> is <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>d to set
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span> as in <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntax%29%29" class="RktStxLink" data-pltdoc="x">let-syntax</a></span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="define.html" title="backward to &quot;3.14 Definitions: define, define-syntax, ...&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="when_unless.html" title="forward to &quot;3.16 Guarded Evaluation: when and unless&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/block.html b/clones/docs.racket-lang.org/reference/block.html
new file mode 100644
index 00000000..fc50c0d4
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/block.html
@@ -0,0 +1,8 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.23&nbsp;Blocks: block</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewselflink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="block.html#%28form._%28%28lib._racket%2Fblock..rkt%29._block%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="__top-interaction.html" title="backward to &quot;3.22 Interaction Wrapper: #%top-interaction&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stratified-body.html" title="forward to &quot;3.24 Internal-Definition Limiting: #%stratified-body&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;block&quot;">3.23<tt>&nbsp;</tt><a name="(part._block)"></a><a name="(mod-path._racket/block)"></a>Blocks: <span class="RktSym"><a href="block.html#%28form._%28%28lib._racket%2Fblock..rkt%29._block%29%29" class="RktStxLink" data-pltdoc="x">block</a></span></h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="block.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/block</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="block.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/block</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/block..rkt)._block))"></a><span title="Provided from: racket/block | Package: base"><span class="RktSym"><a href="block.html#%28form._%28%28lib._racket%2Fblock..rkt%29._block%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">block</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">defn-or-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Supports a mixture of expressions and mutually recursive definitions,
+as in a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> body. Unlike an <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition
+context</span></a>, the last <span class="RktVar">defn-or-expr</span> need not be an expression.</div></p><p>The result of the <span class="RktSym"><a href="block.html#%28form._%28%28lib._racket%2Fblock..rkt%29._block%29%29" class="RktStxLink" data-pltdoc="x">block</a></span> form is the result
+of the last <span class="RktVar">defn-or-expr</span> if it is an expression,
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a> otherwise. If no <span class="RktVar">defn-or-expr</span> is provided
+(after flattening <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> forms), the result is <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</p><p>The final <span class="RktVar">defn-or-expr</span> is executed in tail position, if it is
+an expression.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="block.html#%28form._%28%28lib._racket%2Fblock..rkt%29._block%29%29" class="RktStxLink" data-pltdoc="x">block</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">12</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">13</span></p></td></tr><tr><td><p><span class="RktRes">29</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="__top-interaction.html" title="backward to &quot;3.22 Interaction Wrapper: #%top-interaction&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stratified-body.html" title="forward to &quot;3.24 Internal-Definition Limiting: #%stratified-body&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/booleans.html b/clones/docs.racket-lang.org/reference/booleans.html
new file mode 100644
index 00000000..3d561a3d
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/booleans.html
@@ -0,0 +1,22 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.2&nbsp;Booleans</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewselflink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.2&nbsp;</td><td><a href="booleans.html" class="tocviewselflink" data-pltdoc="x">Booleans</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.2.1&nbsp;</td><td><a href="booleans.html#%28part._.Boolean_.Aliases%29" class="tocviewlink" data-pltdoc="x">Boolean Aliases</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">boolean?</span></span></a></td></tr><tr><td><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">not</span></span></a></td></tr><tr><td><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">immutable?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.2.1<tt>&nbsp;</tt></span><a href="booleans.html#%28part._.Boolean_.Aliases%29" class="tocsubseclink" data-pltdoc="x">Boolean Aliases</a></td></tr><tr><td><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._true%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">true</span></span></a></td></tr><tr><td><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._false%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">false</span></span></a></td></tr><tr><td><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._symbol~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">symbol=?</span></span></a></td></tr><tr><td><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._boolean~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">boolean=?</span></span></a></td></tr><tr><td><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._false~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">false?</span></span></a></td></tr><tr><td><a href="booleans.html#%28form._%28%28lib._racket%2Fbool..rkt%29._nand%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">nand</span></span></a></td></tr><tr><td><a href="booleans.html#%28form._%28%28lib._racket%2Fbool..rkt%29._nor%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">nor</span></span></a></td></tr><tr><td><a href="booleans.html#%28form._%28%28lib._racket%2Fbool..rkt%29._implies%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">implies</span></span></a></td></tr><tr><td><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._xor%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">xor</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Equality.html" title="backward to &quot;4.1 Equality&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="numbers.html" title="forward to &quot;4.3 Numbers&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;booleans&quot;">4.2<tt>&nbsp;</tt><a name="(part._booleans)"></a>Booleans</h4><p>True and false <a name="(tech._boolean)"></a><span style="font-style: italic">booleans</span> are represented by the values
+<span class="RktVal">#t</span> and <span class="RktVal">#f</span>, respectively, though operations that
+depend on a boolean value typically treat anything other than
+<span class="RktVal">#f</span> as true. The <span class="RktVal">#t</span> value is always <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to
+itself, and <span class="RktVal">#f</span> is always <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to itself.</p><p>See <a href="reader.html#%28part._parse-boolean%29" data-pltdoc="x">Reading Booleans</a>
+    for information on <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>ing
+    booleans and <a href="printing.html#%28part._print-booleans%29" data-pltdoc="x">Printing Booleans</a>
+    for information on <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>ing booleans.</p><p>See also <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span>, <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span>, <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._andmap%29%29" class="RktValLink" data-pltdoc="x">andmap</a></span>, and <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._ormap%29%29" class="RktValLink" data-pltdoc="x">ormap</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._boolean~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">boolean?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is <span class="RktVal">#t</span> or <span class="RktVal">#f</span>,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">true</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._not))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValDef RktValLink" data-pltdoc="x">not</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is <span class="RktVal">#f</span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">we-have-no-bananas</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._immutable~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">immutable?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is an immutable <a href="strings.html#%28tech._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">string</span></a>,
+<a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte string</span></a>, <a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vector</span></a>, <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash table</span></a>, or <a href="boxes.html#%28tech._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">box</span></a>,
+<span class="RktVal">#f</span> otherwise.</div></p><p>Note that <span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span> is not a general predicate for
+immutability (despite its name). It works only for a handful of
+datatypes for which a single predicate&#8212;<wbr></wbr><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span>,
+<span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span>, etc<span class="Sendabbrev">.</span>&#8212;<wbr></wbr>recognizes both mutable and immutable variants
+of the datatype. In particular, <span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span> produces
+<span class="RktVal">#f</span> for a <a href="pairs.html#%28tech._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">pair</span></a>, even though pairs are immutable, since
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span> implies immutability.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">hello</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a string"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValLink" data-pltdoc="x">box</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hash%29%29" class="RktValLink" data-pltdoc="x">make-immutable-hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">[</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="RktVal">]</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Boolean_Aliases&quot;">4.2.1<tt>&nbsp;</tt><a name="(part._.Boolean_.Aliases)"></a><a name="(mod-path._racket/bool)"></a>Boolean Aliases</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="booleans.html#%28mod-path._racket%2Fbool%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/bool</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="booleans.html#%28mod-path._racket%2Fbool%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/bool</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/bool..rkt)._true))"></a><span title="Provided from: racket/bool, racket | Package: base"><span class="RktSym"><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._true%29%29" class="RktValDef RktValLink" data-pltdoc="x">true</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">An alias for <span class="RktVal">#t</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/bool..rkt)._false))"></a><span title="Provided from: racket/bool, racket | Package: base"><span class="RktSym"><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._false%29%29" class="RktValDef RktValLink" data-pltdoc="x">false</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">An alias for <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/bool..rkt)._symbol~3d~3f))"></a><span title="Provided from: racket/bool, racket | Package: base"><span class="RktSym"><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._symbol~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">symbol=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="stt"> </span><span class="RktVar">a</span><span class="stt"> </span><span class="RktVar">b</span><span class="RktPn">)</span> (if <span class="RktVar">a</span> and <span class="RktVar">b</span> are symbols).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/bool..rkt)._boolean~3d~3f))"></a><span title="Provided from: racket/bool, racket | Package: base"><span class="RktSym"><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._boolean~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">boolean=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="stt"> </span><span class="RktVar">a</span><span class="stt"> </span><span class="RktVar">b</span><span class="RktPn">)</span> (if <span class="RktVar">a</span> and <span class="RktVar">b</span> are booleans).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/bool..rkt)._false~3f))"></a><span title="Provided from: racket/bool, racket | Package: base"><span class="RktSym"><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._false~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">false?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/bool..rkt)._nand))"></a><span title="Provided from: racket/bool, racket | Package: base"><span class="RktSym"><a href="booleans.html#%28form._%28%28lib._racket%2Fbool..rkt%29._nand%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">nand</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Same as <span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="stt"> </span><span class="RktVar">expr</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28form._%28%28lib._racket%2Fbool..rkt%29._nand%29%29" class="RktStxLink" data-pltdoc="x">nand</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28form._%28%28lib._racket%2Fbool..rkt%29._nand%29%29" class="RktStxLink" data-pltdoc="x">nand</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">ack</span><span class="hspace">&nbsp;</span><span class="RktVal">"we don't get here"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/bool..rkt)._nor))"></a><span title="Provided from: racket/bool, racket | Package: base"><span class="RktSym"><a href="booleans.html#%28form._%28%28lib._racket%2Fbool..rkt%29._nor%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">nor</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Same as <span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="stt"> </span><span class="RktVar">expr</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p>In the two argument case, returns <span class="RktVal">#t</span> if neither of the
+arguments is a true value.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28form._%28%28lib._racket%2Fbool..rkt%29._nor%29%29" class="RktStxLink" data-pltdoc="x">nor</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28form._%28%28lib._racket%2Fbool..rkt%29._nor%29%29" class="RktStxLink" data-pltdoc="x">nor</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">ack</span><span class="hspace">&nbsp;</span><span class="RktVal">"we don't get here"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/bool..rkt)._implies))"></a><span title="Provided from: racket/bool, racket | Package: base"><span class="RktSym"><a href="booleans.html#%28form._%28%28lib._racket%2Fbool..rkt%29._implies%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">implies</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">expr1</span><span class="hspace">&nbsp;</span><span class="RktVar">expr2</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Checks to be sure that the first
+expression implies the second.</div></p><p>Same as <span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="stt"> </span><span class="RktVar">expr1</span><span class="stt"> </span><span class="RktVar">expr2</span><span class="stt"> </span><span class="RktVal">#t</span><span class="RktPn">)</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28form._%28%28lib._racket%2Fbool..rkt%29._implies%29%29" class="RktStxLink" data-pltdoc="x">implies</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28form._%28%28lib._racket%2Fbool..rkt%29._implies%29%29" class="RktStxLink" data-pltdoc="x">implies</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28form._%28%28lib._racket%2Fbool..rkt%29._implies%29%29" class="RktStxLink" data-pltdoc="x">implies</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28form._%28%28lib._racket%2Fbool..rkt%29._implies%29%29" class="RktStxLink" data-pltdoc="x">implies</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">ack</span><span class="hspace">&nbsp;</span><span class="RktVal">"we don't get here"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/bool..rkt)._xor))"></a><span title="Provided from: racket/bool, racket | Package: base"><span class="RktSym"><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._xor%29%29" class="RktValDef RktValLink" data-pltdoc="x">xor</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">b1</span><span class="hspace">&nbsp;</span><span class="RktVar">b2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the exclusive or of <span class="RktVar">b1</span> and <span class="RktVar">b2</span>.</div></p><p>If exactly one of <span class="RktVar">b1</span> and <span class="RktVar">b2</span> is
+not <span class="RktVal">#f</span>, then return it. Otherwise, returns
+<span class="RktVal">#f</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._xor%29%29" class="RktValLink" data-pltdoc="x">xor</a></span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">11</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._xor%29%29" class="RktValLink" data-pltdoc="x">xor</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">22</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">22</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._xor%29%29" class="RktValLink" data-pltdoc="x">xor</a></span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="hspace">&nbsp;</span><span class="RktVal">22</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._xor%29%29" class="RktValLink" data-pltdoc="x">xor</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Equality.html" title="backward to &quot;4.1 Equality&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="numbers.html" title="forward to &quot;4.3 Numbers&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/boxes.html b/clones/docs.racket-lang.org/reference/boxes.html
new file mode 100644
index 00000000..fa3b4daa
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/boxes.html
@@ -0,0 +1,24 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.14&nbsp;Boxes</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewselflink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">box?</span></span></a></td></tr><tr><td><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">box</span></span></a></td></tr><tr><td><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box-immutable%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">box-<wbr></wbr>immutable</span></span></a></td></tr><tr><td><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unbox</span></span></a></td></tr><tr><td><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._set-box%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>box!</span></span></a></td></tr><tr><td><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%2A%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unbox*</span></span></a></td></tr><tr><td><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._set-box%2A%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>box*!</span></span></a></td></tr><tr><td><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box-cas%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">box-<wbr></wbr>cas!</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stencil_vectors.html" title="backward to &quot;4.13 Stencil Vectors&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="hashtables.html" title="forward to &quot;4.15 Hash Tables&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;boxes&quot;">4.14<tt>&nbsp;</tt><a name="(part._boxes)"></a>Boxes</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=boxes.html&amp;version=8.6" class="Sq" data-pltdoc="x">Boxes</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces boxes.</p></blockquote></blockquote></blockquote><p>A <a name="(tech._box)"></a><span style="font-style: italic">box</span> is like a single-element vector, normally used as
+minimal mutable storage.</p><p>A box can be <span style="font-style: italic">mutable</span> or
+<span style="font-style: italic">immutable</span>. When an immutable box is provided to a
+procedure like <span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._set-box%21%29%29" class="RktValLink" data-pltdoc="x">set-box!</a></span>, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. Box constants generated by the
+default reader (see <a href="reader.html#%28part._parse-string%29" data-pltdoc="x">Reading Strings</a>) are
+immutable. Use <span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span> to check whether a box is
+immutable.</p><p>A literal or printed box starts with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&amp;</span><span class="hspace"></span></span>. See <a href="reader.html#%28part._parse-box%29" data-pltdoc="x">Reading Boxes</a>
+    for information on <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>ing
+    boxes and <a href="printing.html#%28part._print-box%29" data-pltdoc="x">Printing Boxes</a>
+    for information on <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>ing boxes.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._box~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">box?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a box, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._box))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValDef RktValLink" data-pltdoc="x">box</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="RktValLink" data-pltdoc="x">box?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a new mutable box that contains <span class="RktVar">v</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._box-immutable))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box-immutable%29%29" class="RktValDef RktValLink" data-pltdoc="x">box-immutable</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="RktValLink" data-pltdoc="x">box?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a new immutable box that contains <span class="RktVar">v</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._unbox))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="RktValDef RktValLink" data-pltdoc="x">unbox</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">box</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">box</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="RktValLink" data-pltdoc="x">box?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the content of <span class="RktVar">box</span>.</div></p><p>For any <span class="RktSym">v</span>, <span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="RktValLink" data-pltdoc="x">unbox</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValLink" data-pltdoc="x">box</a></span><span class="stt"> </span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span> and <span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="RktValLink" data-pltdoc="x">unbox</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box-immutable%29%29" class="RktValLink" data-pltdoc="x">box-immutable</a></span><span class="stt"> </span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span> returns <span class="RktSym">v</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._set-box!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._set-box%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-box!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">box</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">box</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="RktValLink" data-pltdoc="x">box?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Sets the content of <span class="RktVar">box</span> to <span class="RktVar">v</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._unbox*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">unbox*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">box</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">box</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="RktValLink" data-pltdoc="x">box?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._set-box*!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._set-box%2A%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-box*!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">box</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">box</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="RktValLink" data-pltdoc="x">box?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="RktValLink" data-pltdoc="x">unbox</a></span> and <span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._set-box%21%29%29" class="RktValLink" data-pltdoc="x">set-box!</a></span>, but constrained to work on
+boxes that are not <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonators</span></a>.</div></p><p class="SHistory">Added in version 6.90.0.15 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._box-cas!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box-cas%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">box-cas!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">box</span><span class="hspace">&nbsp;</span><span class="RktVar">old</span><span class="hspace">&nbsp;</span><span class="RktVar">new</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">box</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="RktValLink" data-pltdoc="x">box?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">old</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">new</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Atomically updates the contents of <span class="RktVar">box</span> to <span class="RktVar">new</span>, provided
+that <span class="RktVar">box</span> currently contains a value that is <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to
+<span class="RktVar">old</span>, and returns <span class="RktVal">#t</span> in that case.  If <span class="RktVar">box</span>
+does not contain <span class="RktVar">old</span>, then the result is <span class="RktVal">#f</span>.</div></p><p>If no other <a href="eval-model.html#%28tech._thread%29" class="techoutside" data-pltdoc="x"><span class="techinside">threads</span></a> or <a href="futures.html#%28tech._future%29" class="techoutside" data-pltdoc="x"><span class="techinside">futures</span></a> attempt to access
+<span class="RktVar">box</span>, the operation is equivalent to</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">old</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="RktValLink" data-pltdoc="x">unbox</a></span><span class="hspace">&nbsp;</span><span class="RktVar">box</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._set-box%21%29%29" class="RktValLink" data-pltdoc="x">set-box!</a></span><span class="hspace">&nbsp;</span><span class="RktVar">box</span><span class="hspace">&nbsp;</span><span class="RktVar">new</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></p></blockquote><p>except that <span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box-cas%21%29%29" class="RktValLink" data-pltdoc="x">box-cas!</a></span> can spuriously fail on some platforms.
+That is, with low probability, the result can be <span class="RktVal">#f</span> with the
+value in <span class="RktVar">box</span> left unchanged, even if <span class="RktVar">box</span> contains
+<span class="RktVar">old</span>.</p><p>When Racket is compiled with support for <a href="futures.html#%28tech._future%29" class="techoutside" data-pltdoc="x"><span class="techinside">futures</span></a>,
+<span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box-cas%21%29%29" class="RktValLink" data-pltdoc="x">box-cas!</a></span> is guaranteed to use a hardware <span class="emph">compare and
+set</span> operation. Uses of <span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box-cas%21%29%29" class="RktValLink" data-pltdoc="x">box-cas!</a></span> be performed safely in a
+<a href="futures.html#%28tech._future%29" class="techoutside" data-pltdoc="x"><span class="techinside">future</span></a> (i.e., allowing the future thunk to continue in
+parallel). See also <a href="memory-order.html" data-pltdoc="x">Machine Memory Order</a>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stencil_vectors.html" title="backward to &quot;4.13 Stencil Vectors&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="hashtables.html" title="forward to &quot;4.15 Hash Tables&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/breakhandler.html b/clones/docs.racket-lang.org/reference/breakhandler.html
new file mode 100644
index 00000000..4ce0af18
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/breakhandler.html
@@ -0,0 +1,89 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>10.6&nbsp;Breaks</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewselflink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">10.1&nbsp;</td><td><a href="values.html" class="tocviewlink" data-pltdoc="x">Multiple Values</a></td></tr><tr><td align="right">10.2&nbsp;</td><td><a href="exns.html" class="tocviewlink" data-pltdoc="x">Exceptions</a></td></tr><tr><td align="right">10.3&nbsp;</td><td><a href="Delayed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Delayed Evaluation</a></td></tr><tr><td align="right">10.4&nbsp;</td><td><a href="cont.html" class="tocviewlink" data-pltdoc="x">Continuations</a></td></tr><tr><td align="right">10.5&nbsp;</td><td><a href="contmarks.html" class="tocviewlink" data-pltdoc="x">Continuation Marks</a></td></tr><tr><td align="right">10.6&nbsp;</td><td><a href="breakhandler.html" class="tocviewselflink" data-pltdoc="x">Breaks</a></td></tr><tr><td align="right">10.7&nbsp;</td><td><a href="Exiting.html" class="tocviewlink" data-pltdoc="x">Exiting</a></td></tr><tr><td align="right">10.8&nbsp;</td><td><a href="unreachable.html" class="tocviewlink" data-pltdoc="x">Unreachable Expressions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="breakhandler.html#%28def._%28%28quote._~23~25kernel%29._break-enabled%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">break-<wbr></wbr>enabled</span></span></a></td></tr><tr><td><a href="breakhandler.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize-break%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">parameterize-<wbr></wbr>break</span></span></a></td></tr><tr><td><a href="breakhandler.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._current-break-parameterization%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>break-<wbr></wbr>parameterization</span></span></a></td></tr><tr><td><a href="breakhandler.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call-with-break-parameterization%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>break-<wbr></wbr>parameterization</span></span></a></td></tr><tr><td><a href="breakhandler.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._break-parameterization~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">break-<wbr></wbr>parameterization?</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contmarks.html" title="backward to &quot;10.5 Continuation Marks&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Control Flow&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Exiting.html" title="forward to &quot;10.7 Exiting&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;breakhandler&quot;">10.6<tt>&nbsp;</tt><a name="(part._breakhandler)"></a><a name="(idx._(gentag._223._(lib._scribblings/reference/reference..scrbl)))"></a>Breaks</h4><p>A <a name="(tech._break)"></a><span style="font-style: italic">break</span> is an asynchronous exception, usually triggered
+through an external source controlled by the user, or through the
+<span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._break-thread%29%29" class="RktValLink" data-pltdoc="x">break-thread</a></span> procedure. For example, the user may type Ctl-C
+in a terminal to trigger a break. On some platforms, the Racket
+process may receive <a name="(idx._(gentag._224._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">SIGINT</span>, <a name="(idx._(gentag._225._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">SIGHUP</span>,
+or <a name="(idx._(gentag._226._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">SIGTERM</span>; the latter two correspond to hang-up and
+terminate breaks as reflected by <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak~3ahang-up%29%29" class="RktValLink" data-pltdoc="x">exn:break:hang-up</a></span> and
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak~3aterminate%29%29" class="RktValLink" data-pltdoc="x">exn:break:terminate</a></span>, respectively. Multiple breaks may be
+collapsed into a single exception, and multiple breaks of different
+kinds may be collapsed to a single &ldquo;strongest&rdquo; break, where a
+terminate break is stronger than a hang-up break which is stronger
+than an interrupt break.</p><p>A break exception can only occur in a
+thread while breaks are enabled. When a break is detected and enabled,
+the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak%29%29" class="RktValLink" data-pltdoc="x">exn:break</a></span> (or <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak~3ahang-up%29%29" class="RktValLink" data-pltdoc="x">exn:break:hang-up</a></span> or
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak~3aterminate%29%29" class="RktValLink" data-pltdoc="x">exn:break:terminate</a></span>) exception is raised
+in the thread sometime afterward; if breaking
+is disabled when <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._break-thread%29%29" class="RktValLink" data-pltdoc="x">break-thread</a></span> is called, the break is
+suspended until breaking is again enabled for the thread. While a
+thread has a suspended break, additional breaks are ignored.</p><p>Breaks are enabled through the <span class="RktSym"><a href="breakhandler.html#%28def._%28%28quote._~23~25kernel%29._break-enabled%29%29" class="RktValLink" data-pltdoc="x">break-enabled</a></span> parameter-like
+procedure and through the <span class="RktSym"><a href="breakhandler.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize-break%29%29" class="RktStxLink" data-pltdoc="x">parameterize-break</a></span> form, which is
+analogous to <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>. The <span class="RktSym"><a href="breakhandler.html#%28def._%28%28quote._~23~25kernel%29._break-enabled%29%29" class="RktValLink" data-pltdoc="x">break-enabled</a></span>
+procedure does not represent a parameter to be used with
+<span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>, because changing the break-enabled state of a
+thread requires an explicit check for breaks, and this check is
+incompatible with the tail evaluation of a <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>
+expression&rsquo;s body.</p><p>Certain procedures, such as <span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">semaphore-wait/enable-break</a></span>,
+enable breaks temporarily while performing a blocking action. If
+breaks are enabled for a thread, and if a break is triggered for the
+thread but not yet delivered as an <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak%29%29" class="RktValLink" data-pltdoc="x">exn:break</a></span> exception, then
+the break is guaranteed to be delivered before breaks can be disabled
+in the thread. The timing of <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak%29%29" class="RktValLink" data-pltdoc="x">exn:break</a></span> exceptions is not
+guaranteed in any other way.</p><p>Before calling a <span class="RktSym"><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%29%29" class="RktStxLink" data-pltdoc="x">with-handlers</a></span> predicate or handler, an
+exception handler, an error display handler, an error escape handler,
+an error value conversion handler, or a <span class="RktSym">pre-thunk</span> or
+<span class="RktSym">post-thunk</span> for a <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="RktValLink" data-pltdoc="x">dynamic-wind</a></span>, the call is
+<span class="RktSym"><a href="breakhandler.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize-break%29%29" class="RktStxLink" data-pltdoc="x">parameterize-break</a></span>ed to disable breaks. Furthermore, breaks
+are disabled during the transitions among handlers related to
+exceptions, during the transitions between <span class="RktSym">pre-thunk</span>s and
+<span class="RktSym">post-thunk</span>s for <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="RktValLink" data-pltdoc="x">dynamic-wind</a></span>, and during other
+transitions for a continuation jump. For example, if breaks are
+disabled when a continuation is invoked, and if breaks are also
+disabled in the target continuation, then breaks will remain disabled
+from the time of the invocation until the target continuation
+executes unless a relevant <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="RktValLink" data-pltdoc="x">dynamic-wind</a></span> <span class="RktSym">pre-thunk</span> or
+<span class="RktSym">post-thunk</span> explicitly enables breaks.</p><p>If a break is triggered for a thread that is blocked on a nested
+thread (see <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._call-in-nested-thread%29%29" class="RktValLink" data-pltdoc="x">call-in-nested-thread</a></span>), and if breaks are enabled
+in the blocked thread, the break is implicitly handled by transferring
+it to the nested thread.</p><p>When breaks are enabled, they can occur at any point within execution,
+which makes certain implementation tasks subtle. For example, assuming
+breaks are enabled when the following code is executed,</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%29%29" class="RktStxLink" data-pltdoc="x">with-handlers</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3abreak~3f%29%29" class="RktValLink" data-pltdoc="x">exn:break?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%29%29" class="RktValLink" data-pltdoc="x">semaphore-wait</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>then it is <span style="font-style: italic">not</span> the case that a <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a> result means the
+semaphore was decremented or a break was received, exclusively. It is
+possible that <span style="font-style: italic">both</span> occur: the break may occur after the
+semaphore is successfully decremented but before a <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>
+result is returned by <span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%29%29" class="RktValLink" data-pltdoc="x">semaphore-wait</a></span>. A break exception will
+never damage a semaphore, or any other built-in construct, but many
+built-in procedures (including <span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%29%29" class="RktValLink" data-pltdoc="x">semaphore-wait</a></span>) contain
+internal sub-expressions that can be interrupted by a break.</p><p>In general, it is impossible using only <span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%29%29" class="RktValLink" data-pltdoc="x">semaphore-wait</a></span> to
+implement the guarantee that either the semaphore is decremented or an
+exception is raised, but not both.  Racket therefore supplies
+<span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">semaphore-wait/enable-break</a></span> (see <a href="semaphore.html" data-pltdoc="x">Semaphores</a>),
+which does permit the implementation of such an exclusive guarantee:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="breakhandler.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize-break%29%29" class="RktStxLink" data-pltdoc="x">parameterize-break</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%29%29" class="RktStxLink" data-pltdoc="x">with-handlers</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3abreak~3f%29%29" class="RktValLink" data-pltdoc="x">exn:break?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">semaphore-wait/enable-break</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>In the above expression, a break can occur at any point until breaks
+are disabled, in which case a break exception is propagated to the
+enclosing exception handler. Otherwise, the break can only occur
+within <span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">semaphore-wait/enable-break</a></span>, which guarantees that if
+a break exception is raised, the semaphore will not have been
+decremented.</p><p>To allow similar implementation patterns over blocking port
+operations, Racket provides <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">read-bytes-avail!/enable-break</a></span>,
+<span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail/enable-break</a></span>, and other procedures.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._break-enabled))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="breakhandler.html#%28def._%28%28quote._~23~25kernel%29._break-enabled%29%29" class="RktValDef RktValLink" data-pltdoc="x">break-enabled</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="breakhandler.html#%28def._%28%28quote._~23~25kernel%29._break-enabled%29%29" class="RktValDef RktValLink" data-pltdoc="x">break-enabled</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Gets or sets the break enabled state of the current thread. If
+<span class="RktVar">on?</span> is not supplied, the result is <span class="RktVal">#t</span> if breaks are
+currently enabled, <span class="RktVal">#f</span> otherwise.  If <span class="RktVar">on?</span> is supplied
+as <span class="RktVal">#f</span>, breaks are disabled, and if <span class="RktVar">on?</span> is a true
+value, breaks are enabled.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/more-scheme..rkt)._parameterize-break))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="breakhandler.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize-break%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">parameterize-break</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">boolean-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Evaluates
+<span class="RktVar">boolean-expr</span> to determine whether breaks are initially
+enabled while evaluating the <span class="RktVar">body</span>s in sequence. The result
+of the <span class="RktSym"><a href="breakhandler.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize-break%29%29" class="RktStxLink" data-pltdoc="x">parameterize-break</a></span> expression is the result of the last
+<span class="RktSym">expr</span>.</div></p><p>As with <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>, a fresh <a href="eval-model.html#%28tech._thread._cell%29" class="techoutside" data-pltdoc="x"><span class="techinside">thread cell</span></a> is allocated to
+hold the break-enabled state of the continuation, and calls to
+<span class="RktSym"><a href="breakhandler.html#%28def._%28%28quote._~23~25kernel%29._break-enabled%29%29" class="RktValLink" data-pltdoc="x">break-enabled</a></span> within the continuation access or modify the
+new cell. Unlike a parameter, a mutation to the break setting via
+<span class="RktSym"><a href="breakhandler.html#%28def._%28%28quote._~23~25kernel%29._break-enabled%29%29" class="RktValLink" data-pltdoc="x">break-enabled</a></span> is not inherited by new threads (i.e., the
+thread cell is not <a href="eval-model.html#%28tech._preserved%29" class="techoutside" data-pltdoc="x"><span class="techinside">preserved</span></a>).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/more-scheme..rkt)._current-break-parameterization))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="breakhandler.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._current-break-parameterization%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-break-parameterization</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="breakhandler.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._break-parameterization~3f%29%29" class="RktValLink" data-pltdoc="x">break-parameterization?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Analogous to <span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._current-parameterization%29%29" class="RktValLink" data-pltdoc="x">current-parameterization</a></span><span class="RktPn">)</span> (see
+<a href="parameters.html" data-pltdoc="x">Parameters</a>); it returns a break parameterization
+(effectively, a thread cell) that holds the current continuation&rsquo;s
+break-enable state.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/more-scheme..rkt)._call-with-break-parameterization))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="breakhandler.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call-with-break-parameterization%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-break-parameterization</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">break-param</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">thunk</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">break-param</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="breakhandler.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._break-parameterization~3f%29%29" class="RktValLink" data-pltdoc="x">break-parameterization?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Analogous to <span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call-with-parameterization%29%29" class="RktValLink" data-pltdoc="x">call-with-parameterization</a></span><span class="stt"> </span><span class="RktSym">parameterization</span><span class="stt"> </span><span class="RktVar">thunk</span><span class="RktPn">)</span> (see <a href="parameters.html" data-pltdoc="x">Parameters</a>), calls <span class="RktVar">thunk</span> in a
+continuation whose break-enabled state is in <span class="RktVar">break-param</span>. The
+<span class="RktVar">thunk</span> is <span style="font-style: italic">not</span> called in tail position with respect to
+the <span class="RktSym"><a href="breakhandler.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call-with-break-parameterization%29%29" class="RktValLink" data-pltdoc="x">call-with-break-parameterization</a></span> call.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/more-scheme..rkt)._break-parameterization~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="breakhandler.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._break-parameterization~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">break-parameterization?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a break parameterization as produced by
+<span class="RktSym"><a href="breakhandler.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._current-break-parameterization%29%29" class="RktValLink" data-pltdoc="x">current-break-parameterization</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p class="SHistory">Added in version 6.1.1.8 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contmarks.html" title="backward to &quot;10.5 Continuation Marks&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Control Flow&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Exiting.html" title="forward to &quot;10.7 Exiting&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/bytestrings.html b/clones/docs.racket-lang.org/reference/bytestrings.html
new file mode 100644
index 00000000..50638b18
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/bytestrings.html
@@ -0,0 +1,246 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.5&nbsp;Byte Strings</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewselflink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewselflink" data-pltdoc="x">Byte Strings</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.5.1&nbsp;</td><td><a href="bytestrings.html#%28part._.Byte_.String_.Constructors__.Selectors__and_.Mutators%29" class="tocviewlink" data-pltdoc="x">Byte String Constructors, Selectors, and Mutators</a></td></tr><tr><td align="right">4.5.2&nbsp;</td><td><a href="bytestrings.html#%28part._.Byte_.String_.Comparisons%29" class="tocviewlink" data-pltdoc="x">Byte String Comparisons</a></td></tr><tr><td align="right">4.5.3&nbsp;</td><td><a href="bytestrings.html#%28part._.Bytes_to_from_.Characters__.Decoding_and_.Encoding%29" class="tocviewlink" data-pltdoc="x">Bytes to/<span class="mywbr"> &nbsp;</span>from Characters, Decoding and Encoding</a></td></tr><tr><td align="right">4.5.4&nbsp;</td><td><a href="bytestrings.html#%28part._.Bytes_to_.Bytes_.Encoding_.Conversion%29" class="tocviewlink" data-pltdoc="x">Bytes to Bytes Encoding Conversion</a></td></tr><tr><td align="right">4.5.5&nbsp;</td><td><a href="bytestrings.html#%28part._.Additional_.Byte_.String_.Functions%29" class="tocviewlink" data-pltdoc="x">Additional Byte String Functions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">4.5.1<tt>&nbsp;</tt></span><a href="bytestrings.html#%28part._.Byte_.String_.Constructors__.Selectors__and_.Mutators%29" class="tocsubseclink" data-pltdoc="x">Byte String Constructors, Selectors, and Mutators</a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes?</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._make-bytes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3eimmutable-bytes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>&gt;immutable-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">byte?</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._subbytes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subbytes</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-copy%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>copy</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-copy%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>copy!</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-fill%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>fill!</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-append%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>append</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3elist%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>&gt;list</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._list-~3ebytes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-<wbr></wbr>&gt;bytes</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._make-shared-bytes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>shared-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._shared-bytes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">shared-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.5.2<tt>&nbsp;</tt></span><a href="bytestrings.html#%28part._.Byte_.String_.Comparisons%29" class="tocsubseclink" data-pltdoc="x">Byte String Comparisons</a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes=?</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3c~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes&lt;?</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3e~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes&gt;?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.5.3<tt>&nbsp;</tt></span><a href="bytestrings.html#%28part._.Bytes_to_from_.Characters__.Decoding_and_.Encoding%29" class="tocsubseclink" data-pltdoc="x">Bytes to/<span class="mywbr"> &nbsp;</span>from Characters, Decoding and Encoding</a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Futf-8%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>&gt;string/<span class="mywbr"> &nbsp;</span>utf-<wbr></wbr>8</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Flocale%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>&gt;string/<span class="mywbr"> &nbsp;</span>locale</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Flatin-1%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>&gt;string/<span class="mywbr"> &nbsp;</span>latin-<wbr></wbr>1</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Futf-8%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>&gt;bytes/<span class="mywbr"> &nbsp;</span>utf-<wbr></wbr>8</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Flocale%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>&gt;bytes/<span class="mywbr"> &nbsp;</span>locale</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Flatin-1%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>&gt;bytes/<span class="mywbr"> &nbsp;</span>latin-<wbr></wbr>1</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-utf-8-length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>utf-<wbr></wbr>8-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>utf-<wbr></wbr>8-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>utf-<wbr></wbr>8-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-index%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>utf-<wbr></wbr>8-<wbr></wbr>index</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.5.4<tt>&nbsp;</tt></span><a href="bytestrings.html#%28part._.Bytes_to_.Bytes_.Encoding_.Conversion%29" class="tocsubseclink" data-pltdoc="x">Bytes to Bytes Encoding Conversion</a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>open-<wbr></wbr>converter</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-close-converter%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>close-<wbr></wbr>converter</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-convert%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>convert</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-convert-end%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>convert-<wbr></wbr>end</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-converter~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>converter?</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._locale-string-encoding%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">locale-<wbr></wbr>string-<wbr></wbr>encoding</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.5.5<tt>&nbsp;</tt></span><a href="bytestrings.html#%28part._.Additional_.Byte_.String_.Functions%29" class="tocsubseclink" data-pltdoc="x">Additional Byte String Functions</a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28lib._racket%2Fbytes..rkt%29._bytes-append%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>append*</span></span></a></td></tr><tr><td><a href="bytestrings.html#%28def._%28%28lib._racket%2Fbytes..rkt%29._bytes-join%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>join</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="strings.html" title="backward to &quot;4.4 Strings&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="characters.html" title="forward to &quot;4.6 Characters&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;bytestrings&quot;">4.5<tt>&nbsp;</tt><a name="(part._bytestrings)"></a>Byte Strings</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=bytestrings.html&amp;version=8.6" class="Sq" data-pltdoc="x">Bytes and Byte Strings</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces byte strings.</p></blockquote></blockquote></blockquote><p>A <a name="(tech._byte._string)"></a><span style="font-style: italic">byte string</span> is a fixed-length array of bytes. A
+ <a name="(idx._(gentag._139._(lib._scribblings/reference/reference..scrbl)))"></a><span style="font-style: italic">byte</span> is an exact integer between <span class="RktVal">0</span> and
+ <span class="RktVal">255</span> inclusive.</p><p><a name="(idx._(gentag._140._(lib._scribblings/reference/reference..scrbl)))"></a>A byte string can be
+<span style="font-style: italic">mutable</span> or <span style="font-style: italic">immutable</span>. When an immutable byte
+string is provided to a procedure like <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-set%21%29%29" class="RktValLink" data-pltdoc="x">bytes-set!</a></span>, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. Byte-string constants generated by the
+default reader (see <a href="reader.html#%28part._parse-string%29" data-pltdoc="x">Reading Strings</a>) are immutable,
+and they are <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> in <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode.
+Use <span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span> to check whether a byte string is
+immutable.</p><p>Two byte strings are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> when they have the same length
+and contain the same sequence of bytes.</p><p>A byte string can be used as a single-valued sequence (see
+<a href="sequences.html" data-pltdoc="x">Sequences</a>). The bytes of the string serve as elements
+of the sequence. See also <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-bytes%29%29" class="RktValLink" data-pltdoc="x">in-bytes</a></span>.</p><p>See <a href="reader.html#%28part._parse-string%29" data-pltdoc="x">Reading Strings</a>
+    for information on <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>ing
+    byte strings and <a href="printing.html#%28part._print-string%29" data-pltdoc="x">Printing Strings</a>
+    for information on <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>ing byte strings.</p><p>See also: <span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Byte_String_Constructors__Selectors__and_Mutators&quot;">4.5.1<tt>&nbsp;</tt><a name="(part._.Byte_.String_.Constructors__.Selectors__and_.Mutators)"></a>Byte String Constructors, Selectors, and Mutators</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span>
+ is a byte string, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"Apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-bytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._make-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">b</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns a new mutable byte string of length <span class="RktVar">k</span> where each
+position in the byte string is initialized with the byte <span class="RktVar">b</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._make-bytes%29%29" class="RktValLink" data-pltdoc="x">make-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"AAAAA"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns a new mutable byte
+string whose length is the number of provided <span class="RktVar">b</span>s, and whose
+positions are initialized with the given <span class="RktVar">b</span>s.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="hspace">&nbsp;</span><span class="RktVal">112</span><span class="hspace">&nbsp;</span><span class="RktVal">112</span><span class="hspace">&nbsp;</span><span class="RktVal">108</span><span class="hspace">&nbsp;</span><span class="RktVal">101</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"Apple"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-~3eimmutable-bytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3eimmutable-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-&gt;immutable-bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an immutable byte string with the same content
+ as <span class="RktVar">bstr</span>, returning <span class="RktVar">bstr</span> itself if <span class="RktVar">bstr</span> is
+ immutable.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3eimmutable-bytes%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;immutable-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"AAA"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3eimmutable-bytes%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;immutable-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._make-bytes%29%29" class="RktValLink" data-pltdoc="x">make-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3eimmutable-bytes%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;immutable-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"AAAAA"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3eimmutable-bytes%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;immutable-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._byte~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">byte?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is
+ a byte (i.e., an exact integer between <span class="RktVal">0</span> and <span class="RktVal">255</span>
+ inclusive), <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">256</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-length))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the length of <span class="RktVar">bstr</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"Apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-ref))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">  Returns the character at position <span class="RktVar">k</span> in <span class="RktVar">bstr</span>.
+ The first position in the bytes corresponds to <span class="RktVal">0</span>, so the
+ position <span class="RktVar">k</span> must be less than the length of the bytes,
+ otherwise the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-ref%29%29" class="RktValLink" data-pltdoc="x">bytes-ref</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">65</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-set!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">  Changes the
+ character position <span class="RktVar">k</span> in <span class="RktVar">bstr</span> to <span class="RktVar">b</span>.  The first
+ position in the byte string corresponds to <span class="RktVal">0</span>, so the position
+ <span class="RktVar">k</span> must be less than the length of the bytes, otherwise the
+ <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="hspace">&nbsp;</span><span class="RktVal">112</span><span class="hspace">&nbsp;</span><span class="RktVal">112</span><span class="hspace">&nbsp;</span><span class="RktVal">108</span><span class="hspace">&nbsp;</span><span class="RktVal">101</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-set%21%29%29" class="RktValLink" data-pltdoc="x">bytes-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">121</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">s</span></td></tr><tr><td><p><span class="RktRes">#"Apply"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._subbytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._subbytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">subbytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns
+ a new mutable byte string that is <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">end</span><span class="stt"> </span><span class="RktVar">start</span><span class="RktPn">)</span> bytes long,
+ and that contains the same bytes as <span class="RktVar">bstr</span> from <span class="RktVar">start</span>
+ inclusive to <span class="RktVar">end</span> exclusive.  The <span class="RktVar">start</span> and
+ <span class="RktVar">end</span> arguments must be less than or equal to the length of
+ <span class="RktVar">bstr</span>, and <span class="RktVar">end</span> must be greater than or equal to
+ <span class="RktVar">start</span>, otherwise the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._subbytes%29%29" class="RktValLink" data-pltdoc="x">subbytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"pp"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._subbytes%29%29" class="RktValLink" data-pltdoc="x">subbytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"pple"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-copy))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-copy%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-copy</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns
+<span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._subbytes%29%29" class="RktValLink" data-pltdoc="x">subbytes</a></span><span class="stt"> </span><span class="RktSym">str</span><span class="stt"> </span><span class="RktVal">0</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-copy!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-copy%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-copy!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">dest</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">dest-start</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">src</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">src-start</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">src-end</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dest</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dest-start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src-start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src-end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">src</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Changes the bytes of <span class="RktVar">dest</span> starting at position
+ <span class="RktVar">dest-start</span> to match the bytes in <span class="RktVar">src</span> from
+ <span class="RktVar">src-start</span> (inclusive) to <span class="RktVar">src-end</span> (exclusive). The
+ byte strings <span class="RktVar">dest</span> and <span class="RktVar">src</span> can be the same byte
+ string, and in that case the destination region can overlap with the
+ source region; the destination bytes after the copy match the source
+ bytes from before the copy. If any of <span class="RktVar">dest-start</span>,
+ <span class="RktVar">src-start</span>, or <span class="RktVar">src-end</span> are out of range (taking into
+ account the sizes of the byte strings and the source and destination
+ regions), the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="hspace">&nbsp;</span><span class="RktVal">112</span><span class="hspace">&nbsp;</span><span class="RktVal">112</span><span class="hspace">&nbsp;</span><span class="RktVal">108</span><span class="hspace">&nbsp;</span><span class="RktVal">101</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-copy%21%29%29" class="RktValLink" data-pltdoc="x">bytes-copy!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">#"y"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-copy%21%29%29" class="RktValLink" data-pltdoc="x">bytes-copy!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">s</span></td></tr><tr><td><p><span class="RktRes">#"lpply"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-fill!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-fill%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-fill!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dest</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dest</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Changes <span class="RktVar">dest</span> so that every position in the
+ bytes is filled with <span class="RktVar">b</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="hspace">&nbsp;</span><span class="RktVal">112</span><span class="hspace">&nbsp;</span><span class="RktVal">112</span><span class="hspace">&nbsp;</span><span class="RktVal">108</span><span class="hspace">&nbsp;</span><span class="RktVal">101</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-fill%21%29%29" class="RktValLink" data-pltdoc="x">bytes-fill!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">113</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">s</span></td></tr><tr><td><p><span class="RktRes">#"qqqqq"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-append))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-append%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-append</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"><a name="(idx._(gentag._141._(lib._scribblings/reference/reference..scrbl)))"></a>Returns a new mutable byte string
+that is as long as the sum of the given <span class="RktVar">bstr</span>s&rsquo; lengths, and
+that contains the concatenated bytes of the given <span class="RktVar">bstr</span>s. If
+no <span class="RktVar">bstr</span>s are provided, the result is a zero-length byte
+string.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-append%29%29" class="RktValLink" data-pltdoc="x">bytes-append</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"Banana"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"AppleBanana"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-~3elist))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3elist%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-&gt;list</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns a new
+ list of bytes corresponding to the content of <span class="RktVar">bstr</span>. That is,
+ the length of the list is <span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="stt"> </span><span class="RktVar">bstr</span><span class="RktPn">)</span>, and the
+ sequence of bytes in <span class="RktVar">bstr</span> is the same sequence in the
+ result list.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3elist%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"Apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(65 112 112 108 101)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._list-~3ebytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._list-~3ebytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">list-&gt;bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns a new
+ mutable byte string whose content is the list of bytes in <span class="RktVar">lst</span>.
+ That is, the length of the byte string is <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._length%29%29" class="RktValLink" data-pltdoc="x">length</a></span><span class="stt"> </span><span class="RktVar">lst</span><span class="RktPn">)</span>, and
+ the sequence of bytes in <span class="RktVar">lst</span> is the same sequence in
+ the result byte string.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._list-~3ebytes%29%29" class="RktValLink" data-pltdoc="x">list-&gt;bytes</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="hspace">&nbsp;</span><span class="RktVal">112</span><span class="hspace">&nbsp;</span><span class="RktVal">112</span><span class="hspace">&nbsp;</span><span class="RktVal">108</span><span class="hspace">&nbsp;</span><span class="RktVal">101</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"Apple"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-shared-bytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._make-shared-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-shared-bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">b</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns a new mutable byte string of length <span class="RktVar">k</span> where each
+position in the byte string is initialized with the byte <span class="RktVar">b</span>.
+For communication among <a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">places</span></a>, the new byte string is allocated in the
+<a href="places.html#%28tech._shared._memory._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">shared memory space</span></a>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._make-shared-bytes%29%29" class="RktValLink" data-pltdoc="x">make-shared-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"AAAAA"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._shared-bytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._shared-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">shared-bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns a new mutable byte
+string whose length is the number of provided <span class="RktVar">b</span>s, and whose
+positions are initialized with the given <span class="RktVar">b</span>s.
+For communication among <a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">places</span></a>, the new byte string is allocated in the
+<a href="places.html#%28tech._shared._memory._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">shared memory space</span></a>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._shared-bytes%29%29" class="RktValLink" data-pltdoc="x">shared-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="hspace">&nbsp;</span><span class="RktVal">112</span><span class="hspace">&nbsp;</span><span class="RktVal">112</span><span class="hspace">&nbsp;</span><span class="RktVal">108</span><span class="hspace">&nbsp;</span><span class="RktVal">101</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"Apple"</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Byte_String_Comparisons&quot;">4.5.2<tt>&nbsp;</tt><a name="(part._.Byte_.String_.Comparisons)"></a>Byte String Comparisons</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes~3d~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr1</span><span class="hspace">&nbsp;</span><span class="RktVar">bstr2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns
+ <span class="RktVal">#t</span> if all of the arguments are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3d~3f%29%29" class="RktValLink" data-pltdoc="x">bytes=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3d~3f%29%29" class="RktValLink" data-pltdoc="x">bytes=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"as"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"a"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes~3c~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3c~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes&lt;?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr1</span><span class="hspace">&nbsp;</span><span class="RktVar">bstr2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if the arguments are lexicographically sorted
+ increasing, where individual bytes are ordered by <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span>,
+ <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3c~3f%29%29" class="RktValLink" data-pltdoc="x">bytes&lt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3c~3f%29%29" class="RktValLink" data-pltdoc="x">bytes&lt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"Apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3c~3f%29%29" class="RktValLink" data-pltdoc="x">bytes&lt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"c"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes~3e~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3e~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes&gt;?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr1</span><span class="hspace">&nbsp;</span><span class="RktVar">bstr2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3c~3f%29%29" class="RktValLink" data-pltdoc="x">bytes&lt;?</a></span>, but checks whether the arguments are decreasing.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3e~3f%29%29" class="RktValLink" data-pltdoc="x">bytes&gt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3e~3f%29%29" class="RktValLink" data-pltdoc="x">bytes&gt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"Apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3e~3f%29%29" class="RktValLink" data-pltdoc="x">bytes&gt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"c"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"a"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Bytes_to_from_Characters__Decoding_and_Encoding&quot;">4.5.3<tt>&nbsp;</tt><a name="(part._.Bytes_to_from_.Characters__.Decoding_and_.Encoding)"></a>Bytes to/from Characters, Decoding and Encoding</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-~3estring/utf-8))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Futf-8%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-&gt;string/utf-8</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">err-char</span><span class="hspace">&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">err-char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a string by decoding the <span class="RktVar">start</span> to <span class="RktVar">end</span>
+ substring of <span class="RktVar">bstr</span> as a UTF-8 encoding of Unicode code
+ points.  If <span class="RktVar">err-char</span> is not <span class="RktVal">#f</span>, then it is used for
+ bytes that fall in the range <span class="RktVal">128</span> to <span class="RktVal">255</span> but are
+ not part of a valid encoding sequence. (This rule is consistent with
+ reading characters from a port; see <a href="encodings.html" data-pltdoc="x">Encodings and Locales</a> for more
+ details.)  If <span class="RktVar">err-char</span> is <span class="RktVal">#f</span>, and if the
+ <span class="RktVar">start</span> to <span class="RktVar">end</span> substring of <span class="RktVar">bstr</span> is not a
+ valid UTF-8 encoding overall, then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Futf-8%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;string/utf-8</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">167</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">176</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">182</span><span class="hspace">&nbsp;</span><span class="RktVal">194</span><span class="hspace">&nbsp;</span><span class="RktVal">163</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"&#231;&#240;&#246;&#163;"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-~3estring/locale))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Flocale%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-&gt;string/locale</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">err-char</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">err-char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a string by decoding the <span class="RktVar">start</span> to <span class="RktVar">end</span> substring
+of <span class="RktVar">bstr</span> using the current locale&rsquo;s encoding (see also
+<a href="encodings.html" data-pltdoc="x">Encodings and Locales</a>). If <span class="RktVar">err-char</span> is not
+<span class="RktVal">#f</span>, it is used for each byte in <span class="RktVar">bstr</span> that is not part
+of a valid encoding; if <span class="RktVar">err-char</span> is <span class="RktVal">#f</span>, and if the
+<span class="RktVar">start</span> to <span class="RktVar">end</span> substring of <span class="RktVar">bstr</span> is not a valid
+encoding overall, then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-~3estring/latin-1))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Flatin-1%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-&gt;string/latin-1</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">err-char</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">err-char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a string by decoding the <span class="RktVar">start</span> to <span class="RktVar">end</span> substring
+ of <span class="RktVar">bstr</span> as a Latin-1 encoding of Unicode code points; i.e.,
+ each byte is translated directly to a character using
+ <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._integer-~3echar%29%29" class="RktValLink" data-pltdoc="x">integer-&gt;char</a></span>, so the decoding always succeeds.
+ The <span class="RktVar">err-char</span>
+ argument is ignored, but present for consistency with the other
+ operations.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Flatin-1%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;string/latin-1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">254</span><span class="hspace">&nbsp;</span><span class="RktVal">211</span><span class="hspace">&nbsp;</span><span class="RktVal">209</span><span class="hspace">&nbsp;</span><span class="RktVal">165</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"&#254;&#211;&#209;&#165;"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-~3ebytes/utf-8))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Futf-8%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-&gt;bytes/utf-8</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">err-byte</span><span class="hspace">&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">err-byte</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="RktValLink" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a byte string by encoding the <span class="RktVar">start</span> to <span class="RktVar">end</span>
+ substring of <span class="RktVar">str</span> via UTF-8 (always succeeding). The
+ <span class="RktVar">err-byte</span> argument is ignored, but included for consistency with
+ the other operations.
+</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Futf-8%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;string/utf-8</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">167</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">176</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">182</span><span class="hspace">&nbsp;</span><span class="RktVal">194</span><span class="hspace">&nbsp;</span><span class="RktVal">163</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Futf-8%29%29" class="RktValLink" data-pltdoc="x">string-&gt;bytes/utf-8</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"\303\247\303\260\303\266\302\243"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Futf-8%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;string/utf-8</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Futf-8%29%29" class="RktValLink" data-pltdoc="x">string-&gt;bytes/utf-8</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"&#231;&#240;&#246;&#163;"</span></p></td></tr></table></blockquote></div></p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-~3ebytes/locale))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Flocale%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-&gt;bytes/locale</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">err-byte</span><span class="hspace">&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">err-byte</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="RktValLink" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a string by encoding the <span class="RktVar">start</span> to <span class="RktVar">end</span> substring
+of <span class="RktVar">str</span> using the current locale&rsquo;s encoding (see also
+<a href="encodings.html" data-pltdoc="x">Encodings and Locales</a>). If <span class="RktVar">err-byte</span> is not <span class="RktVal">#f</span>, it is used
+for each character in <span class="RktVar">str</span> that cannot be encoded for the
+current locale; if <span class="RktVar">err-byte</span> is <span class="RktVal">#f</span>, and if the
+<span class="RktVar">start</span> to <span class="RktVar">end</span> substring of <span class="RktVar">str</span> cannot be encoded,
+then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-~3ebytes/latin-1))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Flatin-1%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-&gt;bytes/latin-1</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">str</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">err-byte</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">err-byte</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="RktValLink" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a string by encoding the <span class="RktVar">start</span> to <span class="RktVar">end</span> substring
+ of <span class="RktVar">str</span> using Latin-1; i.e., each character is translated
+ directly to a byte using <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-~3einteger%29%29" class="RktValLink" data-pltdoc="x">char-&gt;integer</a></span>. If <span class="RktVar">err-byte</span> is
+ not <span class="RktVal">#f</span>, it is used for each character in <span class="RktVar">str</span> whose
+ value is greater than <span class="RktVal">255</span>.
+ If <span class="RktVar">err-byte</span> is <span class="RktVal">#f</span>, and if the
+ <span class="RktVar">start</span> to <span class="RktVar">end</span> substring of <span class="RktVar">str</span> has a character
+ with a value greater than <span class="RktVal">255</span>, then the
+ <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Flatin-1%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;string/latin-1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">254</span><span class="hspace">&nbsp;</span><span class="RktVal">211</span><span class="hspace">&nbsp;</span><span class="RktVal">209</span><span class="hspace">&nbsp;</span><span class="RktVal">165</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Flatin-1%29%29" class="RktValLink" data-pltdoc="x">string-&gt;bytes/latin-1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"\376\323\321\245"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Flatin-1%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;string/latin-1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Flatin-1%29%29" class="RktValLink" data-pltdoc="x">string-&gt;bytes/latin-1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"&#254;&#211;&#209;&#165;"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-utf-8-length))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-utf-8-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-utf-8-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="RktValLink" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the length in bytes of the UTF-8 encoding of <span class="RktVar">str</span>&rsquo;s
+ substring from <span class="RktVar">start</span> to <span class="RktVar">end</span>, but without actually
+ generating the encoded bytes.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-utf-8-length%29%29" class="RktValLink" data-pltdoc="x">string-utf-8-length</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Futf-8%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;string/utf-8</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">167</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">176</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">182</span><span class="hspace">&nbsp;</span><span class="RktVal">194</span><span class="hspace">&nbsp;</span><span class="RktVal">163</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">8</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-utf-8-length%29%29" class="RktValLink" data-pltdoc="x">string-utf-8-length</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-utf-8-length))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-utf-8-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">err-char</span><span class="hspace">&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">err-char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the length in characters of the UTF-8 decoding of
+ <span class="RktVar">bstr</span>&rsquo;s substring from <span class="RktVar">start</span> to <span class="RktVar">end</span>, but without
+ actually generating the decoded characters. If <span class="RktVar">err-char</span> is
+ <span class="RktVal">#f</span> and the substring is not a UTF-8 encoding overall, the
+ result is <span class="RktVal">#f</span>. Otherwise, <span class="RktVar">err-char</span> is used to resolve
+ decoding errors as in <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Futf-8%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;string/utf-8</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-length%29%29" class="RktValLink" data-pltdoc="x">bytes-utf-8-length</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">167</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">176</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">182</span><span class="hspace">&nbsp;</span><span class="RktVal">194</span><span class="hspace">&nbsp;</span><span class="RktVal">163</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-length%29%29" class="RktValLink" data-pltdoc="x">bytes-utf-8-length</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._make-bytes%29%29" class="RktValLink" data-pltdoc="x">make-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-utf-8-ref))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-utf-8-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">skip</span><span class="hspace">&nbsp;</span><span class="RktVar">err-char</span><span class="hspace">&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">err-char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <span class="RktVar">skip</span>th character in the UTF-8 decoding of
+ <span class="RktVar">bstr</span>&rsquo;s substring from <span class="RktVar">start</span> to <span class="RktVar">end</span>, but without
+ actually generating the other decoded characters. If the substring is
+ not a UTF-8 encoding up to the <span class="RktVar">skip</span>th character (when
+ <span class="RktVar">err-char</span> is <span class="RktVal">#f</span>), or if the substring decoding produces
+ fewer than <span class="RktVar">skip</span> characters, the result is <span class="RktVal">#f</span>. If
+ <span class="RktVar">err-char</span> is not <span class="RktVal">#f</span>, it is used to resolve decoding
+ errors as in <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Futf-8%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;string/utf-8</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-ref%29%29" class="RktValLink" data-pltdoc="x">bytes-utf-8-ref</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">167</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">176</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">182</span><span class="hspace">&nbsp;</span><span class="RktVal">194</span><span class="hspace">&nbsp;</span><span class="RktVal">163</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\&#231;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-ref%29%29" class="RktValLink" data-pltdoc="x">bytes-utf-8-ref</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">167</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">176</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">182</span><span class="hspace">&nbsp;</span><span class="RktVal">194</span><span class="hspace">&nbsp;</span><span class="RktVal">163</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\&#240;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-ref%29%29" class="RktValLink" data-pltdoc="x">bytes-utf-8-ref</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">167</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">176</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">182</span><span class="hspace">&nbsp;</span><span class="RktVal">194</span><span class="hspace">&nbsp;</span><span class="RktVal">163</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\&#246;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-ref%29%29" class="RktValLink" data-pltdoc="x">bytes-utf-8-ref</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="hspace">&nbsp;</span><span class="RktVal">66</span><span class="hspace">&nbsp;</span><span class="RktVal">67</span><span class="hspace">&nbsp;</span><span class="RktVal">68</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\A</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-ref%29%29" class="RktValLink" data-pltdoc="x">bytes-utf-8-ref</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="hspace">&nbsp;</span><span class="RktVal">66</span><span class="hspace">&nbsp;</span><span class="RktVal">67</span><span class="hspace">&nbsp;</span><span class="RktVal">68</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\B</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-ref%29%29" class="RktValLink" data-pltdoc="x">bytes-utf-8-ref</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="hspace">&nbsp;</span><span class="RktVal">66</span><span class="hspace">&nbsp;</span><span class="RktVal">67</span><span class="hspace">&nbsp;</span><span class="RktVal">68</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\C</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-utf-8-index))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-index%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-utf-8-index</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">skip</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">err-char</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">err-char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the offset in bytes into <span class="RktVar">bstr</span> at which the <span class="RktVar">skip</span>th
+ character&rsquo;s encoding starts in the UTF-8 decoding of <span class="RktVar">bstr</span>&rsquo;s
+ substring from <span class="RktVar">start</span> to <span class="RktVar">end</span> (but without actually
+ generating the other decoded characters). The result is relative to
+ the start of <span class="RktVar">bstr</span>, not to <span class="RktVar">start</span>. If the substring is not
+ a UTF-8 encoding up to the <span class="RktVar">skip</span>th character (when
+ <span class="RktVar">err-char</span> is <span class="RktVal">#f</span>), or if the substring decoding produces
+ fewer than <span class="RktVar">skip</span> characters, the result is <span class="RktVal">#f</span>. If
+ <span class="RktVar">err-char</span> is not <span class="RktVal">#f</span>, it is used to resolve decoding
+ errors as in <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Futf-8%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;string/utf-8</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-index%29%29" class="RktValLink" data-pltdoc="x">bytes-utf-8-index</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">167</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">176</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">182</span><span class="hspace">&nbsp;</span><span class="RktVal">194</span><span class="hspace">&nbsp;</span><span class="RktVal">163</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-index%29%29" class="RktValLink" data-pltdoc="x">bytes-utf-8-index</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">167</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">176</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">182</span><span class="hspace">&nbsp;</span><span class="RktVal">194</span><span class="hspace">&nbsp;</span><span class="RktVal">163</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-index%29%29" class="RktValLink" data-pltdoc="x">bytes-utf-8-index</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">167</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">176</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">182</span><span class="hspace">&nbsp;</span><span class="RktVal">194</span><span class="hspace">&nbsp;</span><span class="RktVal">163</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-index%29%29" class="RktValLink" data-pltdoc="x">bytes-utf-8-index</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="hspace">&nbsp;</span><span class="RktVal">66</span><span class="hspace">&nbsp;</span><span class="RktVal">67</span><span class="hspace">&nbsp;</span><span class="RktVal">68</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-index%29%29" class="RktValLink" data-pltdoc="x">bytes-utf-8-index</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="hspace">&nbsp;</span><span class="RktVal">66</span><span class="hspace">&nbsp;</span><span class="RktVal">67</span><span class="hspace">&nbsp;</span><span class="RktVal">68</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-index%29%29" class="RktValLink" data-pltdoc="x">bytes-utf-8-index</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="hspace">&nbsp;</span><span class="RktVal">66</span><span class="hspace">&nbsp;</span><span class="RktVal">67</span><span class="hspace">&nbsp;</span><span class="RktVal">68</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Bytes_to_Bytes_Encoding_Conversion&quot;">4.5.4<tt>&nbsp;</tt><a name="(part._.Bytes_to_.Bytes_.Encoding_.Conversion)"></a>Bytes to Bytes Encoding Conversion</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-open-converter))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-open-converter</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">from-name</span><span class="hspace">&nbsp;</span><span class="RktVar">to-name</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-converter~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-converter?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">from-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">to-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a <a name="(tech._byte._converter)"></a><span style="font-style: italic">byte converter</span> to go from the encoding named by
+<span class="RktVar">from-name</span> to the encoding named by <span class="RktVar">to-name</span>. If the
+requested conversion pair is not available, <span class="RktVal">#f</span> is returned
+instead of a converter.</div></p><p>Certain encoding combinations are always available:</p><ul><li><p><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span><span class="stt"> </span><span class="RktVal">"UTF-8"</span><span class="stt"> </span><span class="RktVal">"UTF-8"</span><span class="RktPn">)</span> &#8212;<wbr></wbr> the
+identity conversion, except that encoding errors in the input lead
+to a decoding failure.</p></li><li><p><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span><span class="stt"> </span><span class="RktVal">"UTF-8-permissive"</span><span class="stt"> </span><span class="RktVal">"UTF-8"</span><span class="RktPn">)</span> &#8212;<wbr></wbr>
+<a name="(idx._(gentag._142._(lib._scribblings/reference/reference..scrbl)))"></a>the identity conversion, except that
+any input byte that is not part of a valid encoding sequence is
+effectively replaced by the UTF-8 encoding sequence for
+<span class="RktVal">#\uFFFD</span>.  (This handling of invalid sequences is
+consistent with the interpretation of port bytes streams into
+characters; see <a href="ports.html" data-pltdoc="x">Ports</a>.)</p></li><li><p><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span><span class="stt"> </span><span class="RktVal">""</span><span class="stt"> </span><span class="RktVal">"UTF-8"</span><span class="RktPn">)</span> &#8212;<wbr></wbr> converts from
+the current locale&rsquo;s default encoding (see <a href="encodings.html" data-pltdoc="x">Encodings and Locales</a>)
+to UTF-8.</p></li><li><p><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span><span class="stt"> </span><span class="RktVal">"UTF-8"</span><span class="stt"> </span><span class="RktVal">""</span><span class="RktPn">)</span> &#8212;<wbr></wbr> converts from
+UTF-8 to the current locale&rsquo;s default encoding (see
+<a href="encodings.html" data-pltdoc="x">Encodings and Locales</a>).</p></li><li><p><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span><span class="stt"> </span><span class="RktVal">"platform-UTF-8"</span><span class="stt"> </span><span class="RktVal">"platform-UTF-16"</span><span class="RktPn">)</span>
+&#8212;<wbr></wbr> converts UTF-8 to UTF-16 on Unix and Mac OS, where each UTF-16
+code unit is a sequence of two bytes ordered by the current
+platform&rsquo;s endianness. On Windows, the conversion is the same
+as <span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span><span class="stt"> </span><span class="RktVal">"WTF-8"</span><span class="stt"> </span><span class="RktVal">"WTF-16"</span><span class="RktPn">)</span> to support
+unpaired surrogate code units.</p></li><li><p><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span><span class="stt"> </span><span class="RktVal">"platform-UTF-8-permissive"</span><span class="stt"> </span><span class="RktVal">"platform-UTF-16"</span><span class="RktPn">)</span>
+&#8212;<wbr></wbr> like <span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span><span class="stt"> </span><span class="RktVal">"platform-UTF-8"</span><span class="stt"> </span><span class="RktVal">"platform-UTF-16"</span><span class="RktPn">)</span>,
+but an input byte that is not part of a valid UTF-8 encoding
+sequence (or valid for the unpaired-surrogate extension on
+Windows) is effectively replaced with <span class="RktVal">#\uFFFD</span>.</p></li><li><p><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span><span class="stt"> </span><span class="RktVal">"platform-UTF-16"</span><span class="stt"> </span><span class="RktVal">"platform-UTF-8"</span><span class="RktPn">)</span>
+&#8212;<wbr></wbr> converts UTF-16 (bytes ordered by the current platform&rsquo;s
+endianness) to UTF-8 on Unix and Mac OS. On Windows, the conversion
+is the same as <span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span><span class="stt"> </span><span class="RktVal">"WTF-16"</span><span class="stt"> </span><span class="RktVal">"WTF-8"</span><span class="RktPn">)</span>
+to support unpaired surrogates. On Unix and Mac OS, surrogates are
+assumed to be paired: a pair of bytes with the bits <span class="RktVal">#xD800</span><span class="RktMeta"></span>
+starts a surrogate pair, and the <span class="RktVal">#x03FF</span><span class="RktMeta"></span> bits are used from
+the pair and following pair (independent of the value of the
+<span class="RktVal">#xDC00</span><span class="RktMeta"></span> bits). On all platforms, performance may be poor
+when decoding from an odd offset within an input byte string.</p></li><li><p><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span><span class="stt"> </span><span class="RktVal">"WTF-8"</span><span class="stt"> </span><span class="RktVal">"WTF-16"</span><span class="RktPn">)</span>
+&#8212;<wbr></wbr> converts the WTF-8 [<a href="doc-bibliography.html#%28cite._.Sapin18%29" data-pltdoc="x">Sapin18</a>] superset of UTF-8 to a
+superset of UTF-16 to support unpaired surrogate code units, where
+each UTF-16 code unit is a sequence of two bytes ordered by the
+current platform&rsquo;s endianness.</p></li><li><p><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span><span class="stt"> </span><span class="RktVal">"WTF-8-permissive"</span><span class="stt"> </span><span class="RktVal">"WTF-16"</span><span class="RktPn">)</span>
+&#8212;<wbr></wbr> like <span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span><span class="stt"> </span><span class="RktVal">"WTF-8"</span><span class="stt"> </span><span class="RktVal">"WTF-16"</span><span class="RktPn">)</span>,
+but an input byte that is not part of a valid WTF-8 encoding
+sequence is effectively replaced with <span class="RktVal">#\uFFFD</span>.</p></li><li><p><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span><span class="stt"> </span><span class="RktVal">"WTF-16"</span><span class="stt"> </span><span class="RktVal">"WTF-8"</span><span class="RktPn">)</span>
+&#8212;<wbr></wbr> converts the WTF-16 [<a href="doc-bibliography.html#%28cite._.Sapin18%29" data-pltdoc="x">Sapin18</a>] superset of UTF-16 to the
+WTF-8 superset of UTF-8. The input can include UTF-16 code units
+that are unpaired surrogates, and the corresponding output includes
+an encoding of each surrogate in a natural extension of UTF-8.</p></li></ul><p>A newly opened byte converter is registered with the current custodian
+(see <a href="custodians.html" data-pltdoc="x">Custodians</a>), so that the converter is closed when
+the custodian is shut down. A converter is not registered with a
+custodian (and does not need to be closed) if it is one of the
+guaranteed combinations not involving <span class="RktVal">""</span> on Unix, or if it
+is any of the guaranteed combinations (including <span class="RktVal">""</span>) on
+Windows and Mac OS.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>In the Racket software distributions for Windows, a suitable
+<span class="stt">"iconv.dll"</span> is included with <span class="stt">"libmzsch<span style="font-style: italic">VERS</span>.dll"</span>.</p></blockquote></blockquote></blockquote><p>The set of available encodings and combinations varies by platform,
+depending on the <span class="stt">iconv</span> library that is installed; the
+<span class="RktVar">from-name</span> and <span class="RktVar">to-name</span> arguments are passed on to
+<span class="stt">iconv_open</span>. On Windows, <span class="stt">"iconv.dll"</span> or
+<span class="stt">"libiconv.dll"</span> must be in the same directory as
+<span class="stt">"libmzsch<span style="font-style: italic">VERS</span>.dll"</span> (where <span style="font-style: italic">VERS</span> is a version
+number), in the user&rsquo;s path, in the system directory, or in the
+current executable&rsquo;s directory at run time, and the DLL must either
+supply <span class="stt">_errno</span> or link to <span class="stt">"msvcrt.dll"</span> for <span class="stt">_errno</span>;
+otherwise, only the guaranteed combinations are available.</p><p>Use <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-convert%29%29" class="RktValLink" data-pltdoc="x">bytes-convert</a></span> with the result to convert byte strings.</p><p class="SHistory">Changed in version 7.9.0.17 of package <span class="stt">base</span>: Added built-in converters for
+<span class="RktVal">"WTF-8"</span>,
+<span class="RktVal">"WTF-8-permissive"</span>, and
+<span class="RktVal">"WTF-16"</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-close-converter))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-close-converter%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-close-converter</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">converter</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">converter</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-converter~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-converter?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Closes the given converter, so that it can no longer be used with
+<span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-convert%29%29" class="RktValLink" data-pltdoc="x">bytes-convert</a></span> or <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-convert-end%29%29" class="RktValLink" data-pltdoc="x">bytes-convert-end</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-convert))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-convert%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-convert</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">converter</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">src-bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">src-start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">src-end-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">dest-bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">dest-start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">dest-end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">complete</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">continues</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">aborts</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">error</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">converter</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-converter~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-converter?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src-bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src-start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">src-end-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">src-bstr</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dest-bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dest-start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">dest-end-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktVar">dest-bstr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">dest-bstr</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Converts the bytes from <span class="RktVar">src-start-pos</span> to <span class="RktVar">src-end-pos</span>
+in <span class="RktVar">src-bstr</span>.</div></p><p>If <span class="RktVar">dest-bstr</span> is not <span class="RktVal">#f</span>, the converted bytes are
+written into <span class="RktVar">dest-bstr</span> from <span class="RktVar">dest-start-pos</span> to
+<span class="RktVar">dest-end-pos</span>. If <span class="RktVar">dest-bstr</span> is <span class="RktVal">#f</span>, then a
+newly allocated byte string holds the conversion results, and if
+<span class="RktVar">dest-end-pos</span> is not <span class="RktVal">#f</span>, the size of the result byte
+string is no more than <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">dest-end-pos</span><span class="stt"> </span><span class="RktVar">dest-start-pos</span><span class="RktPn">)</span>.</p><p>The result of <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-convert%29%29" class="RktValLink" data-pltdoc="x">bytes-convert</a></span> is three values:</p><ul><li><p><span class="RktVar">result-bstr</span> or <span class="RktVar">dest-wrote-amt</span> &#8212;<wbr></wbr> a byte
+string if <span class="RktVar">dest-bstr</span> is <span class="RktVal">#f</span> or not provided, or the
+number of bytes written into <span class="RktVar">dest-bstr</span> otherwise.</p></li><li><p><span class="RktVar">src-read-amt</span> &#8212;<wbr></wbr> the number of bytes successfully converted
+from <span class="RktVar">src-bstr</span>.</p></li><li><p><a name="(idx._(gentag._143._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">complete</span>, <a name="(idx._(gentag._144._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">continues</span>,
+<a name="(idx._(gentag._145._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">aborts</span>, or <a name="(idx._(gentag._146._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">error</span> &#8212;<wbr></wbr> indicates
+how conversion terminated:</p><ul><li><p><span class="RktVal">'</span><span class="RktVal">complete</span>: The entire input was processed, and
+<span class="RktVar">src-read-amt</span> will be equal to <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">src-end-pos</span><span class="stt"> </span><span class="RktVar">src-start-pos</span><span class="RktPn">)</span>.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">continues</span>: Conversion stopped due to the limit on
+the result size or the space in <span class="RktVar">dest-bstr</span>; in this case,
+fewer than <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">dest-end-pos</span><span class="stt"> </span><span class="RktVar">dest-start-pos</span><span class="RktPn">)</span> bytes may be
+returned if more space is needed to process the next complete
+encoding sequence in <span class="RktVar">src-bstr</span>.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">aborts</span>: The input stopped part-way through an
+encoding sequence, and more input bytes are necessary to continue.
+For example, if the last byte of input is <span class="RktVal">195</span> for a
+<span class="RktVal">"UTF-8-permissive"</span> decoding, the result is
+<span class="RktVal">'</span><span class="RktVal">aborts</span>, because another byte is needed to determine how to
+use the <span class="RktVal">195</span> byte.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">error</span>: The bytes starting at <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVar">src-start-pos</span><span class="stt"> </span><span class="RktVar">src-read-amt</span><span class="RktPn">)</span> bytes in <span class="RktVar">src-bstr</span> do not form
+a legal encoding sequence. This result is never produced for some
+encodings, where all byte sequences are valid encodings. For
+example, since <span class="RktVal">"UTF-8-permissive"</span> handles an invalid UTF-8
+sequence by dropping characters or generating &ldquo;?,&rdquo; every byte
+sequence is effectively valid.</p></li></ul></li></ul><p>Applying a converter accumulates state in the converter (even when the
+third result of <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-convert%29%29" class="RktValLink" data-pltdoc="x">bytes-convert</a></span> is <span class="RktVal">'</span><span class="RktVal">complete</span>). This
+state can affect both further processing of input and further
+generation of output, but only for conversions that involve &ldquo;shift
+sequences&rdquo; to change modes within a stream. To terminate an input
+sequence and reset the converter, use <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-convert-end%29%29" class="RktValLink" data-pltdoc="x">bytes-convert-end</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">convert</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"UTF-8"</span><span class="hspace">&nbsp;</span><span class="RktVal">"UTF-16"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-convert%29%29" class="RktValLink" data-pltdoc="x">bytes-convert</a></span><span class="hspace">&nbsp;</span><span class="RktSym">convert</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="hspace">&nbsp;</span><span class="RktVal">66</span><span class="hspace">&nbsp;</span><span class="RktVal">67</span><span class="hspace">&nbsp;</span><span class="RktVal">68</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">#"\377\376A\0B\0C\0D\0"</span></p></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><p><span class="RktRes">'complete</span></p></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">167</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">176</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">182</span><span class="hspace">&nbsp;</span><span class="RktVal">194</span><span class="hspace">&nbsp;</span><span class="RktVal">163</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"\303\247\303\260\303\266\302\243"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-convert%29%29" class="RktValLink" data-pltdoc="x">bytes-convert</a></span><span class="hspace">&nbsp;</span><span class="RktSym">convert</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">167</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">176</span><span class="hspace">&nbsp;</span><span class="RktVal">195</span><span class="hspace">&nbsp;</span><span class="RktVal">182</span><span class="hspace">&nbsp;</span><span class="RktVal">194</span><span class="hspace">&nbsp;</span><span class="RktVal">163</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">#"\347\0\360\0\366\0\243\0"</span></p></td></tr><tr><td><p><span class="RktRes">8</span></p></td></tr><tr><td><p><span class="RktRes">'complete</span></p></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-close-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-close-converter</a></span><span class="hspace">&nbsp;</span><span class="RktSym">convert</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-convert-end))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-convert-end%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-convert-end</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">converter</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">dest-bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">dest-start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">dest-end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">complete</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">continues</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">converter</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-converter~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-converter?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dest-bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dest-start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">dest-end-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktVar">dest-bstr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">dest-bstr</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-convert%29%29" class="RktValLink" data-pltdoc="x">bytes-convert</a></span>, but instead of converting bytes, this
+procedure generates an ending sequence for the conversion (sometimes
+called a &ldquo;shift sequence&rdquo;), if any. Few encodings use shift
+sequences, so this function will succeed with no output for most
+encodings. In any case, successful output of a (possibly empty) shift
+sequence resets the converter to its initial state.</div></p><p>The result of <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-convert-end%29%29" class="RktValLink" data-pltdoc="x">bytes-convert-end</a></span> is two values:</p><ul><li><p><span class="RktVar">result-bstr</span> or <span class="RktVar">dest-wrote-amt</span> &#8212;<wbr></wbr> a byte string if
+<span class="RktVar">dest-bstr</span> is <span class="RktVal">#f</span> or not provided, or the number of
+bytes written into <span class="RktVar">dest-bstr</span> otherwise.</p></li><li><p><a name="(idx._(gentag._147._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">complete</span> or <a name="(idx._(gentag._148._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">continues</span> &#8212;<wbr></wbr>
+indicates whether conversion completed. If <span class="RktVal">'</span><span class="RktVal">complete</span>, then
+an entire ending sequence was produced. If <span class="RktVal">'</span><span class="RktVal">continues</span>, then
+the conversion could not complete due to the limit on the result
+size or the space in <span class="RktVar">dest-bstr</span>, and the first result is
+either an empty byte string or <span class="RktVal">0</span>.</p></li></ul><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bytes-converter~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-converter~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-converter?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="bytestrings.html#%28tech._byte._converter%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte converter</span></a> produced
+by <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-converter~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-converter?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"UTF-8"</span><span class="hspace">&nbsp;</span><span class="RktVal">"UTF-16"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-converter~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-converter?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"whacky"</span><span class="hspace">&nbsp;</span><span class="RktVal">"not likely"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"UTF-8"</span><span class="hspace">&nbsp;</span><span class="RktVal">"UTF-16"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-close-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-close-converter</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-converter~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-converter?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._locale-string-encoding))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._locale-string-encoding%29%29" class="RktValDef RktValLink" data-pltdoc="x">locale-string-encoding</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns a string for the current locale&rsquo;s encoding (i.e., the encoding
+normally identified by <span class="RktVal">""</span>). See also
+<span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-language%2Bcountry%29%29" class="RktValLink" data-pltdoc="x">system-language+country</a></span>.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Additional_Byte_String_Functions&quot;">4.5.5<tt>&nbsp;</tt><a name="(part._.Additional_.Byte_.String_.Functions)"></a><a name="(mod-path._racket/bytes)"></a>Additional Byte String Functions</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="bytestrings.html#%28mod-path._racket%2Fbytes%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/bytes</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="bytestrings.html#%28mod-path._racket%2Fbytes%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/bytes</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/bytes..rkt)._bytes-append*))"></a><span title="Provided from: racket/bytes, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28lib._racket%2Fbytes..rkt%29._bytes-append%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-append*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">strs</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">strs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-append%29%29" class="RktValLink" data-pltdoc="x">bytes-append</a></span>, but the last argument is used as a list
+of arguments for <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-append%29%29" class="RktValLink" data-pltdoc="x">bytes-append</a></span>, so <span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28lib._racket%2Fbytes..rkt%29._bytes-append%2A%29%29" class="RktValLink" data-pltdoc="x">bytes-append*</a></span><span class="stt"> </span><span class="RktVar">str</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktVar">strs</span><span class="RktPn">)</span> is the same as <span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span><span class="stt"> </span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-append%29%29" class="RktValLink" data-pltdoc="x">bytes-append</a></span><span class="stt"> </span><span class="RktVar">str</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktVar">strs</span><span class="RktPn">)</span>.  In other words, the relationship between
+<span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-append%29%29" class="RktValLink" data-pltdoc="x">bytes-append</a></span> and <span class="RktSym"><a href="bytestrings.html#%28def._%28%28lib._racket%2Fbytes..rkt%29._bytes-append%2A%29%29" class="RktValLink" data-pltdoc="x">bytes-append*</a></span> is similar to the
+one between <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span> and <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%2A%29%29" class="RktValLink" data-pltdoc="x">list*</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28lib._racket%2Fbytes..rkt%29._bytes-append%2A%29%29" class="RktValLink" data-pltdoc="x">bytes-append*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">#"c"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"d"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"abcd"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28lib._racket%2Fbytes..rkt%29._bytes-append%2A%29%29" class="RktValLink" data-pltdoc="x">bytes-append*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._append%2A%29%29" class="RktValLink" data-pltdoc="x">append*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#", "</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">#"Alpha"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"Beta"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"Gamma"</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#"Alpha, Beta, Gamma"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/bytes..rkt)._bytes-join))"></a><span title="Provided from: racket/bytes, racket | Package: base"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28lib._racket%2Fbytes..rkt%29._bytes-join%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-join</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">strs</span><span class="hspace">&nbsp;</span><span class="RktVar">sep</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">strs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sep</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Appends the byte strings in <span class="RktVar">strs</span>, inserting <span class="RktVar">sep</span> between
+each pair of bytes in <span class="RktVar">strs</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28lib._racket%2Fbytes..rkt%29._bytes-join%29%29" class="RktValLink" data-pltdoc="x">bytes-join</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">#"one"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"two"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"three"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"four"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#" potato "</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"one potato two potato three potato four"</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="strings.html" title="backward to &quot;4.4 Strings&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="characters.html" title="forward to &quot;4.6 Characters&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/case.html b/clones/docs.racket-lang.org/reference/case.html
new file mode 100644
index 00000000..1e7a8ad9
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/case.html
@@ -0,0 +1,14 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.13&nbsp;Dispatch: case</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewselflink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="if.html" title="backward to &quot;3.12 Conditionals: if, cond, and, and or&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="define.html" title="forward to &quot;3.14 Definitions: define, define-syntax, ...&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;case&quot;">3.13<tt>&nbsp;</tt><a name="(part._case)"></a>Dispatch: <span class="RktSym"><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="RktStxLink" data-pltdoc="x">case</a></span></h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/more-scheme..rkt)._case))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">case</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">val-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">case-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">case-clause</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">datum</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">then-body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktVar">then-body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Evaluates <span class="RktVar">val-expr</span> and uses the result to select a
+<span class="RktVar">case-clause</span>. The selected clause is the first one with a
+<span class="RktVar">datum</span> whose <span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span>d form is <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to the
+result of <span class="RktVar">val-expr</span>. If no such <span class="RktVar">datum</span> is present, the
+<span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span> <span class="RktVar">case-clause</span> is selected; if no <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span>
+<span class="RktVar">case-clause</span> is present, either, then the result of the
+<span class="RktSym"><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="RktStxLink" data-pltdoc="x">case</a></span> form is <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The <span class="RktSym"><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="RktStxLink" data-pltdoc="x">case</a></span>
+form of <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> differs from that of <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=r6rs&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">R6RS: Scheme</a> or <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=r5rs&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">R5RS: Legacy Scheme</a> by being based on <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> instead of
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span> (in addition to allowing internal definitions).</p></blockquote></blockquote></blockquote></div></p><p>For the selected <span class="RktVar">case-clause</span>, the results of the last
+<span class="RktVar">then-body</span>, which is in tail position with respect to the
+<span class="RktSym"><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="RktStxLink" data-pltdoc="x">case</a></span> form, are the results for the whole <span class="RktSym"><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="RktStxLink" data-pltdoc="x">case</a></span> form.</p><p>A <span class="RktVar">case-clause</span> that starts with <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span> must be the last
+<span class="RktVar">case-clause</span>.</p><p>The <span class="RktSym"><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="RktStxLink" data-pltdoc="x">case</a></span> form can dispatch to a matching <span class="RktVar">case-clause</span>
+in <span style="font-style: italic">O</span>(<span style="font-style: italic">log N</span>)<span style="font-style: italic"></span> time for <span style="font-style: italic">N</span> <span class="RktVar">datum</span>s.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="RktStxLink" data-pltdoc="x">case</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">small</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="hspace">&nbsp;</span><span class="RktVal">12</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">big</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'big</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="RktStxLink" data-pltdoc="x">case</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">small</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="hspace">&nbsp;</span><span class="RktVal">12</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">big</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'small</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="RktStxLink" data-pltdoc="x">case</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append%29%29" class="RktValLink" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"do"</span><span class="hspace">&nbsp;</span><span class="RktVal">"g"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">"cat"</span><span class="hspace">&nbsp;</span><span class="RktVal">"dog"</span><span class="hspace">&nbsp;</span><span class="RktVal">"mouse"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"animal"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"mineral or vegetable"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"animal"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="RktStxLink" data-pltdoc="x">case</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">y</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">forwards</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">backwards</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'backwards</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="RktStxLink" data-pltdoc="x">case</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">x</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"ex"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">'</span><span class="RktVal">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"quoted ex"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"ex"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="RktStxLink" data-pltdoc="x">case</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">quote</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"ex"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">'</span><span class="RktVal">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"quoted ex"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"quoted ex"</span></p></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">classify</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="RktStxLink" data-pltdoc="x">case</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-general-category%29%29" class="RktValLink" data-pltdoc="x">char-general-category</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">ll</span><span class="hspace">&nbsp;</span><span class="RktSym">lu</span><span class="hspace">&nbsp;</span><span class="RktSym">lt</span><span class="hspace">&nbsp;</span><span class="RktSym">ln</span><span class="hspace">&nbsp;</span><span class="RktSym">lo</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"letter"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">nd</span><span class="hspace">&nbsp;</span><span class="RktSym">nl</span><span class="hspace">&nbsp;</span><span class="RktSym">no</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"number"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"other"</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">classify</span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"letter"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">classify</span><span class="hspace">&nbsp;</span><span class="RktVal">#\1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"number"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">classify</span><span class="hspace">&nbsp;</span><span class="RktVal">#\!</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"other"</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="if.html" title="backward to &quot;3.12 Conditionals: if, cond, and, and or&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="define.html" title="forward to &quot;3.14 Definitions: define, define-syntax, ...&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/channel.html b/clones/docs.racket-lang.org/reference/channel.html
new file mode 100644
index 00000000..85f2b640
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/channel.html
@@ -0,0 +1,25 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>11.2.2&nbsp;Channels</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewselflink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.1&nbsp;</td><td><a href="threads.html" class="tocviewlink" data-pltdoc="x">Threads</a></td></tr><tr><td align="right">11.2&nbsp;</td><td><a href="all-sync.html" class="tocviewselflink" data-pltdoc="x">Synchronization</a></td></tr><tr><td align="right">11.3&nbsp;</td><td><a href="thread-local-storage.html" class="tocviewlink" data-pltdoc="x">Thread-<wbr></wbr>Local Storage</a></td></tr><tr><td align="right">11.4&nbsp;</td><td><a href="futures.html" class="tocviewlink" data-pltdoc="x">Futures</a></td></tr><tr><td align="right">11.5&nbsp;</td><td><a href="places.html" class="tocviewlink" data-pltdoc="x">Places</a></td></tr><tr><td align="right">11.6&nbsp;</td><td><a href="engine.html" class="tocviewlink" data-pltdoc="x">Engines</a></td></tr><tr><td align="right">11.7&nbsp;</td><td><a href="memory-order.html" class="tocviewlink" data-pltdoc="x">Machine Memory Order</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>11.2&nbsp;</td><td><a href="all-sync.html" class="tocviewlink" data-pltdoc="x">Synchronization</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.2.1&nbsp;</td><td><a href="sync.html" class="tocviewlink" data-pltdoc="x">Events</a></td></tr><tr><td align="right">11.2.2&nbsp;</td><td><a href="channel.html" class="tocviewselflink" data-pltdoc="x">Channels</a></td></tr><tr><td align="right">11.2.3&nbsp;</td><td><a href="semaphore.html" class="tocviewlink" data-pltdoc="x">Semaphores</a></td></tr><tr><td align="right">11.2.4&nbsp;</td><td><a href="async-channel.html" class="tocviewlink" data-pltdoc="x">Buffered Asynchronous Channels</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">channel?</span></span></a></td></tr><tr><td><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._make-channel%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>channel</span></span></a></td></tr><tr><td><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-get%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">channel-<wbr></wbr>get</span></span></a></td></tr><tr><td><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-try-get%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">channel-<wbr></wbr>try-<wbr></wbr>get</span></span></a></td></tr><tr><td><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">channel-<wbr></wbr>put</span></span></a></td></tr><tr><td><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel-put-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">channel-<wbr></wbr>put-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel-put-evt~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">channel-<wbr></wbr>put-<wbr></wbr>evt?</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="sync.html" title="backward to &quot;11.2.1 Events&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="all-sync.html" title="up to &quot;11.2 Synchronization&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="semaphore.html" title="forward to &quot;11.2.3 Semaphores&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;channel&quot;">11.2.2<tt>&nbsp;</tt><a name="(part._channel)"></a>Channels</h5><p>A <a name="(tech._channel)"></a><span style="font-style: italic">channel</span> both synchronizes a pair of threads and passes a
+value from one to the other. Channels are synchronous; both the sender
+and the receiver must block until the (atomic) transaction is
+complete. Multiple senders and receivers can access a channel at once,
+but a single sender and receiver is selected for each transaction.</p><p>Channel synchronization is <span style="font-style: italic">fair</span>: if a thread is blocked on a
+channel and transaction opportunities for the channel occur infinitely
+often, then the thread eventually participates in a transaction.</p><p>In addition to its use with channel-specific procedures, a channel can
+be used as a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> (see <a href="sync.html" data-pltdoc="x">Events</a>).  A
+channel is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when <span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-get%29%29" class="RktValLink" data-pltdoc="x">channel-get</a></span>
+would not block; the channel&rsquo;s <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> is the
+same as the <span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-get%29%29" class="RktValLink" data-pltdoc="x">channel-get</a></span> result.</p><p>For buffered asynchronous channels, see <a href="async-channel.html" data-pltdoc="x">Buffered Asynchronous Channels</a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._channel~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">channel?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="channel.html#%28tech._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">channel</span></a>,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-channel))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._make-channel%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-channel</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel~3f%29%29" class="RktValLink" data-pltdoc="x">channel?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Creates and returns a new channel. The channel can be used with
+<span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-get%29%29" class="RktValLink" data-pltdoc="x">channel-get</a></span>, with <span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-try-get%29%29" class="RktValLink" data-pltdoc="x">channel-try-get</a></span>, or as a
+<a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> (see <a href="sync.html" data-pltdoc="x">Events</a>) to receive a value
+through the channel. The channel can be used with <span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span>
+or through the result of <span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel-put-evt%29%29" class="RktValLink" data-pltdoc="x">channel-put-evt</a></span> to send a value
+through the channel.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._channel-get))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-get%29%29" class="RktValDef RktValLink" data-pltdoc="x">channel-get</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">ch</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ch</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel~3f%29%29" class="RktValLink" data-pltdoc="x">channel?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Blocks until a sender is ready to provide a value through
+<span class="RktVar">ch</span>. The result is the sent value.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._channel-try-get))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-try-get%29%29" class="RktValDef RktValLink" data-pltdoc="x">channel-try-get</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">ch</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ch</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel~3f%29%29" class="RktValLink" data-pltdoc="x">channel?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Receives and returns a value from <span class="RktVar">ch</span> if a sender is
+immediately ready, otherwise returns <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._channel-put))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValDef RktValLink" data-pltdoc="x">channel-put</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">ch</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ch</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel~3f%29%29" class="RktValLink" data-pltdoc="x">channel?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Blocks until a receiver is ready to accept the value <span class="RktVar">v</span>
+through <span class="RktVar">ch</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._channel-put-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel-put-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">channel-put-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">ch</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel-put-evt~3f%29%29" class="RktValLink" data-pltdoc="x">channel-put-evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ch</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel~3f%29%29" class="RktValLink" data-pltdoc="x">channel?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a fresh <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> for use with
+<span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span>. The event is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when
+<span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span><span class="stt"> </span><span class="RktVar">ch</span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span> would not block, and the event&rsquo;s
+<a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> is the event itself.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._channel-put-evt~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel-put-evt~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">channel-put-evt?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a channel-put event produced by
+<span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel-put-evt%29%29" class="RktValLink" data-pltdoc="x">channel-put-evt</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="sync.html" title="backward to &quot;11.2.1 Events&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="all-sync.html" title="up to &quot;11.2 Synchronization&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="semaphore.html" title="forward to &quot;11.2.3 Semaphores&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/chaperones.html b/clones/docs.racket-lang.org/reference/chaperones.html
new file mode 100644
index 00000000..9ba3a728
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/chaperones.html
@@ -0,0 +1,469 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14.5&nbsp;Impersonators and Chaperones</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewselflink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Namespaces.html" class="tocviewlink" data-pltdoc="x">Namespaces</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="eval.html" class="tocviewlink" data-pltdoc="x">Evaluation and Compilation</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="load-lang.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>load</span></span> Language</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="Module_Names_and_Loading.html" class="tocviewlink" data-pltdoc="x">Module Names and Loading</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="chaperones.html" class="tocviewselflink" data-pltdoc="x">Impersonators and Chaperones</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="securityguards.html" class="tocviewlink" data-pltdoc="x">Security Guards</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="custodians.html" class="tocviewlink" data-pltdoc="x">Custodians</a></td></tr><tr><td align="right">14.8&nbsp;</td><td><a href="threadgroups.html" class="tocviewlink" data-pltdoc="x">Thread Groups</a></td></tr><tr><td align="right">14.9&nbsp;</td><td><a href="inspectors.html" class="tocviewlink" data-pltdoc="x">Structure Inspectors</a></td></tr><tr><td align="right">14.10&nbsp;</td><td><a href="modprotect.html" class="tocviewlink" data-pltdoc="x">Code Inspectors</a></td></tr><tr><td align="right">14.11&nbsp;</td><td><a href="plumbers.html" class="tocviewlink" data-pltdoc="x">Plumbers</a></td></tr><tr><td align="right">14.12&nbsp;</td><td><a href="Sandboxed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Sandboxed Evaluation</a></td></tr><tr><td align="right">14.13&nbsp;</td><td><a href="repl-module.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>repl</span></span> Library</a></td></tr><tr><td align="right">14.14&nbsp;</td><td><a href="linklets.html" class="tocviewlink" data-pltdoc="x">Linklets and the Core Compiler</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>14.5&nbsp;</td><td><a href="chaperones.html" class="tocviewselflink" data-pltdoc="x">Impersonators and Chaperones</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.5.1&nbsp;</td><td><a href="chaperones.html#%28part._.Impersonator_.Constructors%29" class="tocviewlink" data-pltdoc="x">Impersonator Constructors</a></td></tr><tr><td align="right">14.5.2&nbsp;</td><td><a href="chaperones.html#%28part._.Chaperone_.Constructors%29" class="tocviewlink" data-pltdoc="x">Chaperone Constructors</a></td></tr><tr><td align="right">14.5.3&nbsp;</td><td><a href="chaperones.html#%28part._.Impersonator_.Properties%29" class="tocviewlink" data-pltdoc="x">Impersonator Properties</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonator?</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone?</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonator-<wbr></wbr>of?</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-of~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-<wbr></wbr>of?</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-ephemeron%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonator-<wbr></wbr>ephemeron</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._procedure-impersonator%2A~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-<wbr></wbr>impersonator*?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">14.5.1<tt>&nbsp;</tt></span><a href="chaperones.html#%28part._.Impersonator_.Constructors%29" class="tocsubseclink" data-pltdoc="x">Impersonator Constructors</a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-<wbr></wbr>procedure</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-<wbr></wbr>procedure*</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-struct%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-<wbr></wbr>struct</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-vector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-<wbr></wbr>vector</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-vector%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-<wbr></wbr>vector*</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-box%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-<wbr></wbr>box</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-hash%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-<wbr></wbr>hash</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-channel%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-<wbr></wbr>channel</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-prompt-tag%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-<wbr></wbr>prompt-<wbr></wbr>tag</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-continuation-mark-key%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-<wbr></wbr>continuation-<wbr></wbr>mark-<wbr></wbr>key</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._prop~3aimpersonator-of%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>impersonator-<wbr></wbr>of</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._prop~3aauthentic%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>authentic</span></span></a></td></tr><tr><td><span class="tocsublinknumber">14.5.2<tt>&nbsp;</tt></span><a href="chaperones.html#%28part._.Chaperone_.Constructors%29" class="tocsubseclink" data-pltdoc="x">Chaperone Constructors</a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._chaperone-procedure%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-<wbr></wbr>procedure</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._chaperone-procedure%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-<wbr></wbr>procedure*</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-struct%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-<wbr></wbr>struct</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-vector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-<wbr></wbr>vector</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-vector%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-<wbr></wbr>vector*</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-box%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-<wbr></wbr>box</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-hash%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-<wbr></wbr>hash</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-struct-type%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-<wbr></wbr>struct-<wbr></wbr>type</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-channel%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-<wbr></wbr>channel</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-prompt-tag%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-<wbr></wbr>prompt-<wbr></wbr>tag</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-continuation-mark-key%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-<wbr></wbr>continuation-<wbr></wbr>mark-<wbr></wbr>key</span></span></a></td></tr><tr><td><span class="tocsublinknumber">14.5.3<tt>&nbsp;</tt></span><a href="chaperones.html#%28part._.Impersonator_.Properties%29" class="tocsubseclink" data-pltdoc="x">Impersonator Properties</a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._make-impersonator-property%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>impersonator-<wbr></wbr>property</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonator-<wbr></wbr>property?</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property-accessor-procedure~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonator-<wbr></wbr>property-<wbr></wbr>accessor-<wbr></wbr>procedure?</span></span></a></td></tr><tr><td><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-prop~3aapplication-mark%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonator-<wbr></wbr>prop:<span class="mywbr"> &nbsp;</span>application-<wbr></wbr>mark</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Module_Names_and_Loading.html" title="backward to &quot;14.4 Module Names and Loading&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="securityguards.html" title="forward to &quot;14.6 Security Guards&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;chaperones&quot;">14.5<tt>&nbsp;</tt><a name="(part._chaperones)"></a>Impersonators and Chaperones</h4><p>An <a name="(tech._impersonator)"></a><span style="font-style: italic">impersonator</span> is a wrapper for a value where the wrapper
+redirects some of the value&rsquo;s operations. Impersonators apply only to procedures,
+<a href="structures.html#%28tech._structure%29" class="techoutside" data-pltdoc="x"><span class="techinside">structures</span></a> for which an accessor or mutator is available,
+<a href="structures.html#%28tech._structure._type%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure types</span></a>, <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash tables</span></a>, <a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vectors</span></a>,
+<a href="boxes.html#%28tech._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">box</span></a>es, <a href="channel.html#%28tech._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">channels</span></a>, and <a href="eval-model.html#%28tech._prompt._tag%29" class="techoutside" data-pltdoc="x"><span class="techinside">prompt tag</span></a>s.
+An impersonator is <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to the original
+value, but not <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to the original value.</p><p>A <a name="(tech._chaperone)"></a><span style="font-style: italic">chaperone</span> is a kind of impersonator whose refinement of a value&rsquo;s
+operation is restricted to side effects (including, in particular,
+raising an exception) or chaperoning values supplied to or produced by
+the operation. For example, a vector chaperone can redirect
+<span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span> to raise an exception if the accessed vector slot
+contains a string, or it can cause the result of <span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span>
+to be a chaperoned variant of the value that is in the accessed vector
+slot, but it cannot redirect <span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span> to produce a value
+that is arbitrarily different from the value in the vector slot.</p><p>A non-<a href="chaperones.html#%28tech._chaperone%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone</span></a> <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a>, in contrast, can refine an operation to swap one
+value for any other. An impersonator cannot be applied to an immutable value
+or refine the access to an immutable field in an instance of a <a href="structures.html#%28tech._structure._type%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure
+type</span></a>, since arbitrary redirection of an operation amounts to
+mutation of the impersonated value.</p><p>Beware that each of the following operations can be redirected to an
+arbitrary procedure through an impersonator on the operation&rsquo;s
+argument&#8212;<wbr></wbr>assuming that the operation is available to the creator of
+the impersonator:</p><ul class="compact"><li><p>a structure-field accessor</p></li><li><p>a structure-field mutator</p></li><li><p>a structure type property accessor</p></li><li><p>application of a procedure</p></li><li><p><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="RktValLink" data-pltdoc="x">unbox</a></span></p></li><li><p><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._set-box%21%29%29" class="RktValLink" data-pltdoc="x">set-box!</a></span></p></li><li><p><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span></p></li><li><p><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="RktValLink" data-pltdoc="x">vector-set!</a></span></p></li><li><p><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span></p></li><li><p><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%29%29" class="RktValLink" data-pltdoc="x">hash-set</a></span></p></li><li><p><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%21%29%29" class="RktValLink" data-pltdoc="x">hash-set!</a></span></p></li><li><p><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%29%29" class="RktValLink" data-pltdoc="x">hash-remove</a></span></p></li><li><p><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%21%29%29" class="RktValLink" data-pltdoc="x">hash-remove!</a></span></p></li><li><p><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-get%29%29" class="RktValLink" data-pltdoc="x">channel-get</a></span></p></li><li><p><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span></p></li><li><p><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-prompt%29%29" class="RktValLink" data-pltdoc="x">call-with-continuation-prompt</a></span></p></li><li><p><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._abort-current-continuation%29%29" class="RktValLink" data-pltdoc="x">abort-current-continuation</a></span></p></li></ul><p>Derived operations, such as printing a value, can be redirected
+through impersonators due to their use of accessor functions. The
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-hash-code</a></span>, and
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-secondary-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-secondary-hash-code</a></span> operations, in contrast, may bypass
+impersonators (but they are not obliged to).</p><p>In addition to redirecting operations that work on a value, a
+impersonator can include <a name="(tech._impersonator._property)"></a><span style="font-style: italic">impersonator properties</span> for an impersonated
+value. An <a href="chaperones.html#%28tech._impersonator._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator property</span></a> is similar to a <a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure
+type property</span></a>, but it applies to impersonators instead of structure
+types and their instances.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._impersonator~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonator?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is an <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a> created by
+procedures like <span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span> or
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-struct%29%29" class="RktValLink" data-pltdoc="x">impersonate-struct</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p>Programs and libraries generally should avoid <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span> and
+treat impersonators the same as non-impersonator values. In rare cases,
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span> may be needed to guard against redirection by an
+impersonator of an operation to an arbitrary procedure.</p><p>A limitation of <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span> is that it does <span class="emph">not</span>
+recognize an <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a> that is created by instantiating a
+structure type with the <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._prop~3aimpersonator-of%29%29" class="RktValLink" data-pltdoc="x">prop:impersonator-of</a></span> property. The
+limitation reflects how those impersonators cannot redirect structure
+access and mutation operations to arbitrary procedures.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._chaperone~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">chaperone?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="chaperones.html#%28tech._chaperone%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone</span></a>, <span class="RktVal">#f</span> otherwise.</div></p><p>Programs and libraries generally should avoid <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone?</a></span> for
+the same reason that they should avoid <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span>. A true
+value for <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone?</a></span> implies a true value of
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._impersonator-of~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonator-of?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v1</span><span class="hspace">&nbsp;</span><span class="RktVar">v2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Indicates whether <span class="RktVar">v1</span> can be considered equivalent modulo
+impersonators to <span class="RktVar">v2</span>.</div></p><p>Any two values that are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to one another are also <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span>.
+For values that include no impersonators, <span class="RktVar">v1</span> and <span class="RktVar">v2</span> are
+considered impersonators of each other if they are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>.</p><p><div class="SIntrapara">If at least one of <span class="RktVar">v1</span> or <span class="RktVar">v2</span> is an impersonator:
+</div><div class="SIntrapara"><ul><li><p>If <span class="RktVar">v1</span> impersonates <span class="RktVar">v1*</span> then <span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span><span class="stt"> </span><span class="RktVar">v1</span><span class="stt"> </span><span class="RktVar">v2</span><span class="RktPn">)</span>
+   is <span class="RktVal">#t</span> if and only if <span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span><span class="stt"> </span><span class="RktVar">v1*</span><span class="stt"> </span><span class="RktVar">v2</span><span class="RktPn">)</span> is <span class="RktVal">#t</span>.</p></li><li><p>If <span class="RktVar">v2</span> is a non-interposing impersonator that impersonates <span class="RktVar">v2*</span>, i.e.,
+   all of its interposition procedures are <span class="RktVal">#f</span>, then <span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span><span class="stt"> </span><span class="RktVar">v1</span><span class="stt"> </span><span class="RktVar">v2</span><span class="RktPn">)</span>
+   is <span class="RktVal">#t</span> if and only if <span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span><span class="stt"> </span><span class="RktVar">v1</span><span class="stt"> </span><span class="RktVar">v2*</span><span class="RktPn">)</span> is <span class="RktVal">#t</span>.</p></li><li><p>When <span class="RktVar">v2</span> is an impersonator constructed with at least one non-<span class="RktVal">#f</span> interposition procedure,
+     but <span class="RktVar">v1</span> is not an impersonator then <span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span><span class="stt"> </span><span class="RktVar">v1</span><span class="stt"> </span><span class="RktVar">v2</span><span class="RktPn">)</span> is <span class="RktVal">#f</span>.</p></li></ul></div></p><p>Otherwise, if neither <span class="RktVar">v1</span> or <span class="RktVar">v2</span> is an impersonator, but either
+of them contains an impersonator as a subpart (e.g., <span class="RktVar">v1</span> is a list with
+an impersonator as one of its elements), then <span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span><span class="stt"> </span><span class="RktVar">v1</span><span class="stt"> </span><span class="RktVar">v2</span><span class="RktPn">)</span>
+proceeds by comparing <span class="RktVar">v1</span> and <span class="RktVar">v2</span> recursively (as with
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>), returning true if all subparts are <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._chaperone-of~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-of~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">chaperone-of?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v1</span><span class="hspace">&nbsp;</span><span class="RktVar">v2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Indicates whether <span class="RktVar">v1</span> can be considered equivalent modulo
+chaperones to <span class="RktVar">v2</span>.</div></p><p>For values that include no chaperones or other impersonators,
+<span class="RktVar">v1</span> and <span class="RktVar">v2</span> can be considered chaperones of each other
+if they are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, which requires that they are
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> except that corresponding mutable
+vectors, boxes, hash tables, strings, byte strings, <a href="mpairs.html#%28tech._mutable._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutable pairs</span></a>, and
+mutable structures within
+<span class="RktVar">v1</span> and <span class="RktVar">v2</span> must be <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>.</p><p>Otherwise, chaperones and other impersonators within <span class="RktVar">v2</span> must
+be intact within <span class="RktVar">v1</span> analogous to way that
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span> requires that impersonators are preserved.
+Furthermore, <span class="RktVar">v1</span> must not have any non-chaperone impersonators
+whose corresponding value in <span class="RktVar">v2</span> is not the same impersonator.
+Note that <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-of~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-of?</a></span> implies <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span>,
+but not vice-versa.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._impersonator-ephemeron))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-ephemeron%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonator-ephemeron</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="ephemerons.html#%28def._%28%28quote._~23~25kernel%29._ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">ephemeron?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces an <a href="ephemerons.html#%28tech._ephemeron%29" class="techoutside" data-pltdoc="x"><span class="techinside">ephemeron</span></a> that can be used to connect the
+reachability of <span class="RktVar">v</span> (in the sense of garbage collection; see
+<a href="eval-model.html#%28part._gc-model%29" data-pltdoc="x">Garbage Collection</a>) with the reachability of any value for which
+<span class="RktVar">v</span> is an <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a>. That is, the value <span class="RktVar">v</span>
+will be considered reachable as long as the result ephemeron is
+reachable in addition to any value that <span class="RktVar">v</span> impersonates
+(including itself).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._procedure-impersonator*~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._procedure-impersonator%2A~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">procedure-impersonator*?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> for any procedure impersonator that either was produced by
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%2A%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure*</a></span> or <span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._chaperone-procedure%2A%29%29" class="RktValLink" data-pltdoc="x">chaperone-procedure*</a></span>, or is
+an impersonator/chaperone of a value that was created with
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%2A%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure*</a></span> or <span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._chaperone-procedure%2A%29%29" class="RktValLink" data-pltdoc="x">chaperone-procedure*</a></span>
+(possibly transitively).</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Impersonator_Constructors&quot;">14.5.1<tt>&nbsp;</tt><a name="(part._.Impersonator_.Constructors)"></a>Impersonator Constructors</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._impersonate-procedure))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonate-procedure</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">wrapper-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">wrapper-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an impersonator procedure that has the same arity, name, and
+other attributes as <span class="RktVar">proc</span>. When the impersonator procedure is
+applied, the arguments are first passed to <span class="RktVar">wrapper-proc</span>
+(when it is not <span class="RktVal">#f</span>), and
+then the results from <span class="RktVar">wrapper-proc</span> are passed to
+<span class="RktVar">proc</span>. The <span class="RktVar">wrapper-proc</span> can also supply a procedure
+that processes the results of <span class="RktVar">proc</span>.</div></p><p>The arity of <span class="RktVar">wrapper-proc</span> must include the arity of
+<span class="RktVar">proc</span>. The allowed keyword arguments of <span class="RktVar">wrapper-proc</span>
+must be a superset of the allowed keywords of <span class="RktVar">proc</span>. The
+required keyword arguments of <span class="RktVar">wrapper-proc</span> must be a subset
+of the required keywords of <span class="RktVar">proc</span>.</p><p>For applications without keywords, the result of <span class="RktVar">wrapper-proc</span>
+must be at least the same number of values as supplied to it.
+Additional results can be supplied&#8212;<wbr></wbr>before the values that correspond
+to the supplied values&#8212;<wbr></wbr>in the following pattern:</p><ul><li><p>An optional procedure, <span class="RktVar">result-wrapper-proc</span>, which
+will be applied to the results of <span class="RktVar">proc</span>; followed by</p></li><li><p>any number of repetitions of <span class="RktVal">'</span><span class="RktVal">mark</span><span class="stt"> </span><span class="RktVar">key</span><span class="stt"> </span><span class="RktVar">val</span> (i.e.,
+three values), where the call <span class="RktVar">proc</span> is wrapped to
+install a <a href="eval-model.html#%28tech._continuation._mark%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation mark</span></a> <span class="RktVar">key</span> and <span class="RktVar">val</span>.</p></li></ul><p>If <span class="RktVar">result-wrapper-proc</span> is produced, it must be a procedure
+that accepts as many results as produced by <span class="RktVar">proc</span>; it must
+return the same number of results. If <span class="RktVar">result-wrapper-proc</span> is
+not supplied, then <span class="RktVar">proc</span> is called in <a href="eval-model.html#%28tech._tail._position%29" class="techoutside" data-pltdoc="x"><span class="techinside">tail position</span></a>
+with respect to the call to the impersonator.</p><p>For applications that include keyword arguments, <span class="RktVar">wrapper-proc</span>
+must return an additional value before any other values but after
+<span class="RktVar">result-wrapper-proc</span> and <span class="RktVal">'</span><span class="RktVal">mark</span><span class="stt"> </span><span class="RktVar">key</span><span class="stt"> </span><span class="RktVar">val</span>
+sequences (if any). The additional value must be a
+list of replacements for the keyword arguments that were supplied to the
+impersonator (i.e., not counting optional arguments that were
+not supplied). The arguments must be ordered according to the sorted
+order of the supplied arguments&rsquo; keywords.</p><p>If <span class="RktVar">wrapper-proc</span> is <span class="RktVal">#f</span>, then applying the resulting
+impersonator is the same as applying <span class="RktVar">proc</span>. If
+<span class="RktVar">wrapper-proc</span> is <span class="RktVal">#f</span> and no <span class="RktVar">prop</span> is provided, then
+<span class="RktVar">proc</span> is returned and is not impersonated.</p><p>Pairs of <span class="RktVar">prop</span> and <span class="RktVar">prop-val</span> (the number of arguments
+to <span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span> must be even) add impersonator properties
+or override impersonator-property values of <span class="RktVar">proc</span>.</p><p>If any <span class="RktVar">prop</span> is <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-prop~3aapplication-mark%29%29" class="RktValLink" data-pltdoc="x">impersonator-prop:application-mark</a></span> and if the
+associated <span class="RktVar">prop-val</span> is a pair, then the call to <span class="RktVar">proc</span>
+is wrapped with <span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span> using <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktVar">prop-val</span><span class="RktPn">)</span> as the mark key and <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktVar">prop-val</span><span class="RktPn">)</span> as the mark
+value. In addition, if the immediate
+continuation frame of the call to the impersonated procedure
+includes a value for <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktVar">prop-val</span><span class="RktPn">)</span>&#8212;<wbr></wbr>that is, if
+<span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._call-with-immediate-continuation-mark%29%29" class="RktValLink" data-pltdoc="x">call-with-immediate-continuation-mark</a></span> would produce a value
+for <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktVar">prop-val</span><span class="RktPn">)</span> in the call&rsquo;s continuation&#8212;<wbr></wbr>then the value is
+also installed as an immediate value for <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktVar">prop-val</span><span class="RktPn">)</span> as a
+mark during the call to <span class="RktVar">wrapper-proc</span> (which allows tail-calls
+of impersonators with respect to wrapping impersonators to be detected within
+<span class="RktVar">wrapper-proc</span>).</p><p class="SHistory">Changed in version 6.3.0.5 of package <span class="stt">base</span>: Added support for <span class="RktVal">'</span><span class="RktVal">mark</span><span class="stt"> </span><span class="RktVar">key</span><span class="stt"> </span><span class="RktVar">val</span> results from
+<span class="RktVar">wrapper-proc</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">add15</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">15</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">add15+print</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span><span class="hspace">&nbsp;</span><span class="RktSym">add15</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"called with ~s\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">res</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"returned ~s\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">res</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">res</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">add15</span><span class="hspace">&nbsp;</span><span class="RktVal">27</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">42</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">add15+print</span><span class="hspace">&nbsp;</span><span class="RktVal">27</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">called with 27</span></p></td></tr><tr><td><p><span class="RktOut">returned 42</span></p></td></tr></table></td></tr><tr><td><p><span class="RktRes">42</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">imp-prop:p1</span><span class="hspace">&nbsp;</span><span class="RktSym">imp-prop:p1?</span><span class="hspace">&nbsp;</span><span class="RktSym">imp-prop:p1-get</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._make-impersonator-property%29%29" class="RktValLink" data-pltdoc="x">make-impersonator-property</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">imp-prop:p1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">imp-prop:p2</span><span class="hspace">&nbsp;</span><span class="RktSym">imp-prop:p2?</span><span class="hspace">&nbsp;</span><span class="RktSym">imp-prop:p2-get</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._make-impersonator-property%29%29" class="RktValLink" data-pltdoc="x">make-impersonator-property</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">imp-prop:p2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">add15.2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span><span class="hspace">&nbsp;</span><span class="RktSym">add15</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym">imp-prop:p1</span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">add15.2</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">17</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">imp-prop:p1?</span><span class="hspace">&nbsp;</span><span class="RktSym">add15.2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">imp-prop:p1-get</span><span class="hspace">&nbsp;</span><span class="RktSym">add15.2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">11</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">imp-prop:p2?</span><span class="hspace">&nbsp;</span><span class="RktSym">add15.2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">add15.3</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span><span class="hspace">&nbsp;</span><span class="RktSym">add15.2</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym">imp-prop:p2</span><span class="hspace">&nbsp;</span><span class="RktVal">13</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">add15.3</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">18</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">imp-prop:p1?</span><span class="hspace">&nbsp;</span><span class="RktSym">add15.3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">imp-prop:p1-get</span><span class="hspace">&nbsp;</span><span class="RktSym">add15.3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">11</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">imp-prop:p2?</span><span class="hspace">&nbsp;</span><span class="RktSym">add15.3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">imp-prop:p2-get</span><span class="hspace">&nbsp;</span><span class="RktSym">add15.3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">13</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">add15.4</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span><span class="hspace">&nbsp;</span><span class="RktSym">add15.3</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym">imp-prop:p1</span><span class="hspace">&nbsp;</span><span class="RktVal">101</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">add15.4</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">19</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">imp-prop:p1?</span><span class="hspace">&nbsp;</span><span class="RktSym">add15.4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">imp-prop:p1-get</span><span class="hspace">&nbsp;</span><span class="RktSym">add15.4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">101</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">imp-prop:p2?</span><span class="hspace">&nbsp;</span><span class="RktSym">add15.4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">imp-prop:p2-get</span><span class="hspace">&nbsp;</span><span class="RktSym">add15.4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">13</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._impersonate-procedure*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonate-procedure*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">wrapper-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">wrapper-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span>, except that <span class="RktVar">wrapper-proc</span>
+receives an additional argument before all other arguments. The
+additional argument is the procedure <span class="RktVar">orig-proc</span> that was
+originally applied.</div></p><p>If the result of <span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%2A%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure*</a></span> is applied directly,
+then <span class="RktVar">orig-proc</span> is that result. If the result is further
+impersonated before being applied, however, <span class="RktVar">orig-proc</span> is the
+further impersonator.</p><p>An <span class="RktVar">orig-proc</span> argument might be useful so that
+<span class="RktVar">wrapper-proc</span> can extract <a href="chaperones.html#%28tech._impersonator._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator properties</span></a>
+that are overridden by further impersonators, for example.</p><p class="SHistory">Added in version 6.1.1.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._impersonate-struct))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-struct%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonate-struct</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">struct-type</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">orig-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">redirect-proc</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">struct-type</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-type~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">unspecified</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">orig-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-accessor-procedure~3f%29%29" class="RktValLink" data-pltdoc="x">struct-accessor-procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-mutator-procedure~3f%29%29" class="RktValLink" data-pltdoc="x">struct-mutator-procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property-accessor-procedure~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property-accessor-procedure?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">redirect-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an impersonator of <span class="RktVar">v</span>, which redirects certain
+operations on the impersonated value. The <span class="RktVar">orig-proc</span>s
+indicate the operations to redirect, and the corresponding
+<span class="RktVar">redirect-proc</span>s supply the redirections. The optional
+<span class="RktVar">struct-type</span> argument, when provided, acts as a witness for
+the representation of <span class="RktVar">v</span>, which must be an instance of
+<span class="RktVar">struct-type</span>.</div></p><p>The protocol for a <span class="RktVar">redirect-proc</span> depends on the corresponding
+<span class="RktVar">orig-proc</span>, where <span class="RktVar">self</span> refers to the value to which
+<span class="RktVar">orig-proc</span> is originally applied:</p><ul><li><p>A structure-field accessor: <span class="RktVar">redirect-proc</span>
+must accept two arguments, <span class="RktVar">self</span> and the value
+<span class="RktVar">field-v</span> that <span class="RktVar">orig-proc</span> produces for
+<span class="RktVar">v</span>; it must return a replacement for
+<span class="RktVar">field-v</span>. The corresponding field must not be
+immutable, and either the field&rsquo;s structure type must be
+accessible via the current <a href="inspectors.html#%28tech._inspector%29" class="techoutside" data-pltdoc="x"><span class="techinside">inspector</span></a> or one of the other
+<span class="RktVar">orig-proc</span>s must be a structure-field mutator for the
+same field.</p></li><li><p>A structure-field mutator: <span class="RktVar">redirect-proc</span> must accept
+two arguments, <span class="RktVar">self</span> and the value <span class="RktVar">field-v</span>
+supplied to the mutator; it must return a replacement for
+<span class="RktVar">field-v</span> to be propagated to <span class="RktVar">orig-proc</span> and
+<span class="RktVar">v</span>.</p></li><li><p>A property accessor: <span class="RktVar">redirect-proc</span> uses the same
+protocol as for a structure-field accessor. The accessor&rsquo;s
+property must have been created with <span class="RktVal">'</span><span class="RktVal">can-impersonate</span>
+as the second argument to <span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type-property%29%29" class="RktValLink" data-pltdoc="x">make-struct-type-property</a></span>.</p></li></ul><p>When a <span class="RktVar">redirect-proc</span> is <span class="RktVal">#f</span>, the corresponding
+<span class="RktVar">orig-proc</span> is unaffected. Supplying <span class="RktVal">#f</span> for a
+<span class="RktVar">redirect-proc</span> is useful to allow its <span class="RktVar">orig-proc</span> to
+act as a &ldquo;witness&rdquo; of <span class="RktVar">v</span>&rsquo;s representation and enable the
+addition of <span class="RktVar">prop</span>s.</p><p>Pairs of <span class="RktVar">prop</span> and <span class="RktVar">prop-val</span> (the number of arguments
+to <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-struct%29%29" class="RktValLink" data-pltdoc="x">impersonate-struct</a></span> must be even if <span class="RktVar">struct-type</span>
+is provided, odd otherwise) add impersonator properties
+or override impersonator-property values of <span class="RktVar">v</span>.</p><p>Each <span class="RktVar">orig-proc</span> must indicate a distinct operation. If no
+<span class="RktVar">struct-type</span> and no <span class="RktVar">orig-proc</span>s are supplied, then no <span class="RktVar">prop</span>s must be
+supplied. If <span class="RktVar">orig-proc</span>s are supplied only with <span class="RktVal">#f</span>
+<span class="RktVar">redirect-proc</span>s and no <span class="RktVar">prop</span>s are supplied, then
+<span class="RktVar">v</span> is returned and is not impersonated.</p><p>If any <span class="RktVar">orig-proc</span> is itself an impersonator, then a use of the
+accessor or mutator that <span class="RktVar">orig-proc</span> impersonates is redirected
+for the resulting impersonated structure to use <span class="RktVar">orig-proc</span> on
+<span class="RktVar">v</span> before <span class="RktVar">redirect-proc</span> (in the case of accessor) or
+after <span class="RktVar">redirect-proc</span> (in the case of a mutator).</p><p class="SHistory">Changed in version 6.1.1.2 of package <span class="stt">base</span>: Changed first argument to an
+accessor or mutator
+<span class="RktVar">redirect-proc</span> from
+<span class="RktVar">v</span> to <span class="RktVar">self</span>.<br/>Changed in version 6.1.1.8: Added optional <span class="RktVar">struct-type</span>
+argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._impersonate-vector))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-vector%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonate-vector</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">vec</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">ref-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">set-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ref-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an impersonator of <span class="RktVar">vec</span>, which redirects the
+<span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span> and <span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="RktValLink" data-pltdoc="x">vector-set!</a></span> operations.</div></p><p>The <span class="RktVar">ref-proc</span> and <span class="RktVar">set-proc</span> arguments must either both be procedures
+or both be <span class="RktVal">#f</span>. If they are <span class="RktVal">#f</span> then <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-vector%29%29" class="RktValLink" data-pltdoc="x">impersonate-vector</a></span> does not interpose
+on <span class="RktVar">vec</span>, but still allows attaching impersonator properties.</p><p>If <span class="RktVar">ref-proc</span> is a procedure it must accept <span class="RktVar">vec</span>, an index passed to
+<span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span>, and the value that <span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span> on
+<span class="RktVar">vec</span> produces for the given index; it must produce a
+replacement for the value, which is the result of <span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span>
+on the impersonator.</p><p>If <span class="RktVar">set-proc</span> is a procedure it must accept <span class="RktVar">vec</span>, an index passed to
+<span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="RktValLink" data-pltdoc="x">vector-set!</a></span>, and the value passed to <span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="RktValLink" data-pltdoc="x">vector-set!</a></span>; it
+must produce a replacement for the value, which is used
+with <span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="RktValLink" data-pltdoc="x">vector-set!</a></span> on the original <span class="RktVar">vec</span> to install the
+value.</p><p>Pairs of <span class="RktVar">prop</span> and <span class="RktVar">prop-val</span> (the number of arguments
+to <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-vector%29%29" class="RktValLink" data-pltdoc="x">impersonate-vector</a></span> must be odd) add impersonator properties
+or override impersonator-property values of <span class="RktVar">vec</span>.</p><p class="SHistory">Changed in version 6.9.0.2 of package <span class="stt">base</span>: Added non-interposing vector impersonators.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._impersonate-vector*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-vector%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonate-vector*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">vec</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">ref-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">set-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ref-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-vector%29%29" class="RktValLink" data-pltdoc="x">impersonate-vector</a></span>, except that <span class="RktVar">ref-proc</span> and <span class="RktVar">set-proc</span> each receive
+an additional vector as argument before other arguments. The additional argument is the original
+impersonated vector, access to which triggered interposition in the first place.</div></p><p>The additional vector argument might be useful so that <span class="RktVar">ref-proc</span> or <span class="RktVar">set-proc</span>
+can extract impersonator properties that are overridden by further impersonators, for example.</p><p class="SHistory">Added in version 6.9.0.2 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._impersonate-box))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-box%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonate-box</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">box</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">unbox-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">set-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="RktValLink" data-pltdoc="x">box?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">box</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="RktValLink" data-pltdoc="x">box?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">unbox-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="RktValLink" data-pltdoc="x">box?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="RktValLink" data-pltdoc="x">box?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an impersonator of <span class="RktVar">box</span>, which redirects the
+<span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="RktValLink" data-pltdoc="x">unbox</a></span> and <span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._set-box%21%29%29" class="RktValLink" data-pltdoc="x">set-box!</a></span> operations.</div></p><p>The <span class="RktVar">unbox-proc</span> must accept <span class="RktVar">box</span> and the value that
+<span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="RktValLink" data-pltdoc="x">unbox</a></span> produces on <span class="RktVar">box</span>; it must produce a replacement
+value, which is the result of <span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="RktValLink" data-pltdoc="x">unbox</a></span> on the impersonator.</p><p>The <span class="RktVar">set-proc</span> must accept <span class="RktVar">box</span> and the value passed to
+<span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._set-box%21%29%29" class="RktValLink" data-pltdoc="x">set-box!</a></span>; it must produce a replacement
+value, which is used with <span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._set-box%21%29%29" class="RktValLink" data-pltdoc="x">set-box!</a></span> on the original
+<span class="RktVar">box</span> to install the value.</p><p>Pairs of <span class="RktVar">prop</span> and <span class="RktVar">prop-val</span> (the number of arguments
+to <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-box%29%29" class="RktValLink" data-pltdoc="x">impersonate-box</a></span> must be odd) add impersonator properties
+or override impersonator-property values of <span class="RktVar">box</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._impersonate-hash))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-hash%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonate-hash</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">ref-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">set-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">remove-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">key-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">clear-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">equal-key-proc</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">ref-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">remove-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">clear-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">equal-key-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an impersonator of <span class="RktVar">hash</span>, which redirects the
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span>, <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%21%29%29" class="RktValLink" data-pltdoc="x">hash-set!</a></span> or <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%29%29" class="RktValLink" data-pltdoc="x">hash-set</a></span> (as
+applicable), <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%29%29" class="RktValLink" data-pltdoc="x">hash-remove</a></span> or <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%21%29%29" class="RktValLink" data-pltdoc="x">hash-remove!</a></span> (as
+applicable), <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-clear%29%29" class="RktValLink" data-pltdoc="x">hash-clear</a></span> or <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-clear%21%29%29" class="RktValLink" data-pltdoc="x">hash-clear!</a></span> (as
+applicable and if <span class="RktVar">clear-proc</span> is not <span class="RktVal">#f</span>) operations. When
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%29%29" class="RktValLink" data-pltdoc="x">hash-set</a></span>, <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%29%29" class="RktValLink" data-pltdoc="x">hash-remove</a></span> or <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-clear%29%29" class="RktValLink" data-pltdoc="x">hash-clear</a></span> is used on an impersonator of a hash
+table, the result is an impersonator with the same redirecting procedures.
+In addition, operations like
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-key%29%29" class="RktValLink" data-pltdoc="x">hash-iterate-key</a></span> or <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-map%29%29" class="RktValLink" data-pltdoc="x">hash-map</a></span>, which extract
+keys from the table, use <span class="RktVar">key-proc</span> to replace keys extracted
+from the table. Operations like <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-value%29%29" class="RktValLink" data-pltdoc="x">hash-iterate-value</a></span> or
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-values%29%29" class="RktValLink" data-pltdoc="x">hash-values</a></span> implicitly use <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span> and
+therefore redirect through <span class="RktVar">ref-proc</span>. The <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref-key%29%29" class="RktValLink" data-pltdoc="x">hash-ref-key</a></span>
+operation uses both <span class="RktVar">ref-proc</span> and <span class="RktVar">key-proc</span>, the
+former to lookup the requested key and the latter to extract it.</div></p><p>The <span class="RktVar">ref-proc</span> must accept <span class="RktVar">hash</span> and a key passed
+to <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span>. It must return a replacement key
+as well as a procedure. The returned procedure is called only if the
+returned key is found in <span class="RktVar">hash</span> via <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span>, in which
+case the procedure is called with <span class="RktVar">hash</span>, the previously
+returned key, and the found value. The returned procedure must itself
+return a replacement for the found value. The returned procedure
+is ignored by <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref-key%29%29" class="RktValLink" data-pltdoc="x">hash-ref-key</a></span>.</p><p>The <span class="RktVar">set-proc</span> must accept <span class="RktVar">hash</span>, a key passed to
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%21%29%29" class="RktValLink" data-pltdoc="x">hash-set!</a></span> or <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%29%29" class="RktValLink" data-pltdoc="x">hash-set</a></span>, and the value passed to
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%21%29%29" class="RktValLink" data-pltdoc="x">hash-set!</a></span> or <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%29%29" class="RktValLink" data-pltdoc="x">hash-set</a></span>; it must produce two values: a
+replacement for the key and a replacement for the value. The returned
+key and value are used with <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%21%29%29" class="RktValLink" data-pltdoc="x">hash-set!</a></span> or <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%29%29" class="RktValLink" data-pltdoc="x">hash-set</a></span> on
+the original <span class="RktVar">hash</span> to install the value.</p><p>The <span class="RktVar">remove-proc</span> must accept <span class="RktVar">hash</span> and a key passed to
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%21%29%29" class="RktValLink" data-pltdoc="x">hash-remove!</a></span> or <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%29%29" class="RktValLink" data-pltdoc="x">hash-remove</a></span>; it must produce a
+replacement for the key, which is used with <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%21%29%29" class="RktValLink" data-pltdoc="x">hash-remove!</a></span> or
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%29%29" class="RktValLink" data-pltdoc="x">hash-remove</a></span> on the original <span class="RktVar">hash</span> to remove any
+mapping using the (impersonator-replaced) key.</p><p>The <span class="RktVar">key-proc</span> must accept <span class="RktVar">hash</span> and a key that has
+been extracted from <span class="RktVar">hash</span> (by <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref-key%29%29" class="RktValLink" data-pltdoc="x">hash-ref-key</a></span>,
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-key%29%29" class="RktValLink" data-pltdoc="x">hash-iterate-key</a></span>, or other operations that use
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-key%29%29" class="RktValLink" data-pltdoc="x">hash-iterate-key</a></span> internally); it must produce a replacement
+for the key, which is then reported as a key extracted from the table.</p><p>If <span class="RktVar">clear-proc</span> is not <span class="RktVal">#f</span>, it must accept
+<span class="RktVar">hash</span> as an argument, and its result is ignored. The fact that
+<span class="RktVar">clear-proc</span> returns (as opposed to raising an exception or
+otherwise escaping) grants the capability to remove all keys from <span class="RktVar">hash</span>.
+If <span class="RktVar">clear-proc</span> is <span class="RktVal">#f</span>, then <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-clear%29%29" class="RktValLink" data-pltdoc="x">hash-clear</a></span> or
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-clear%21%29%29" class="RktValLink" data-pltdoc="x">hash-clear!</a></span> on the impersonator is implemented using
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-key%29%29" class="RktValLink" data-pltdoc="x">hash-iterate-key</a></span> and <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%29%29" class="RktValLink" data-pltdoc="x">hash-remove</a></span> or <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%21%29%29" class="RktValLink" data-pltdoc="x">hash-remove!</a></span>.</p><p>If <span class="RktVar">equal-key-proc</span> is not <span class="RktVal">#f</span>, it effectively
+interposes on calls to <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-hash-code</a></span>, and
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-secondary-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-secondary-hash-code</a></span> for the keys of <span class="RktVar">hash</span>. The
+<span class="RktVar">equal-key-proc</span> must accept as its arguments <span class="RktVar">hash</span> and
+a key that is either mapped by <span class="RktVar">hash</span> or passed to
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span>, etc., where the latter has potentially been
+adjusted by the corresponding <span class="RktVar">ref-proc</span>, etc<span class="Sendsentence">.</span> The result
+is a value that is passed to <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>,
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-hash-code</a></span>, and <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-secondary-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-secondary-hash-code</a></span> as
+needed to hash and compare keys. In the case of <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%21%29%29" class="RktValLink" data-pltdoc="x">hash-set!</a></span> or
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%29%29" class="RktValLink" data-pltdoc="x">hash-set</a></span>, the key that is passed to <span class="RktVar">equal-key-proc</span>
+is the one stored in the hash table for future lookup.</p><p>The <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-value%29%29" class="RktValLink" data-pltdoc="x">hash-iterate-value</a></span>, <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-map%29%29" class="RktValLink" data-pltdoc="x">hash-map</a></span>, or
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-for-each%29%29" class="RktValLink" data-pltdoc="x">hash-for-each</a></span> functions use a combination of
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-key%29%29" class="RktValLink" data-pltdoc="x">hash-iterate-key</a></span> and <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span>. If a key
+produced by <span class="RktVar">key-proc</span> does not yield a value through
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span>, then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>Pairs of <span class="RktVar">prop</span> and <span class="RktVar">prop-val</span> add impersonator properties
+or override impersonator-property values of <span class="RktVar">hash</span>.</p><p>In the case of an immutable hash table, two impersonated hash tables count as
+&ldquo;the same value&rdquo; (for purposes of <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span>) when their
+redirection procedures were originally attached to a hash table by the same
+call to <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-hash%29%29" class="RktValLink" data-pltdoc="x">impersonate-hash</a></span> or <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-hash%29%29" class="RktValLink" data-pltdoc="x">chaperone-hash</a></span> (and potentially
+propagated by <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%29%29" class="RktValLink" data-pltdoc="x">hash-set</a></span>, <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%29%29" class="RktValLink" data-pltdoc="x">hash-remove</a></span>, or <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-clear%29%29" class="RktValLink" data-pltdoc="x">hash-clear</a></span>),
+as long as the content of the first hash table is <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span> of
+the second hash table.</p><p class="SHistory">Changed in version 6.3.0.11 of package <span class="stt">base</span>: Added the <span class="RktVar">equal-key-proc</span>
+argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._impersonate-channel))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-channel%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonate-channel</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">channel</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">get-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">put-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel~3f%29%29" class="RktValLink" data-pltdoc="x">channel?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">channel</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel~3f%29%29" class="RktValLink" data-pltdoc="x">channel?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">get-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel~3f%29%29" class="RktValLink" data-pltdoc="x">channel?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel~3f%29%29" class="RktValLink" data-pltdoc="x">channel?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">put-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel~3f%29%29" class="RktValLink" data-pltdoc="x">channel?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an impersonator of <span class="RktVar">channel</span>, which redirects the
+<span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-get%29%29" class="RktValLink" data-pltdoc="x">channel-get</a></span> and <span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span> operations.</div></p><p>The <span class="RktVar">get-proc</span> generator is called on <span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-get%29%29" class="RktValLink" data-pltdoc="x">channel-get</a></span>
+or any other operation that fetches results from the channel (such
+as a <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span> on the channel). The <span class="RktVar">get-proc</span> must return
+two values: a <a href="channel.html#%28tech._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">channel</span></a> that is an impersonator of <span class="RktVar">channel</span>, and a
+procedure that is used to check the channel&rsquo;s contents.</p><p>The <span class="RktVar">put-proc</span> must accept <span class="RktVar">channel</span> and the value passed to
+<span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span>; it must produce a replacement
+value, which is used with <span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span> on the original
+<span class="RktVar">channel</span> to send the value over the channel.</p><p>Pairs of <span class="RktVar">prop</span> and <span class="RktVar">prop-val</span> (the number of arguments
+to <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-channel%29%29" class="RktValLink" data-pltdoc="x">impersonate-channel</a></span> must be odd) add impersonator properties
+or override impersonator-property values of <span class="RktVar">channel</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._impersonate-prompt-tag))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-prompt-tag%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonate-prompt-tag</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prompt-tag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">handle-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">abort-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">cc-guard-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">callcc-impersonate-proc</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-prompt-tag?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prompt-tag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-prompt-tag?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">handle-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">abort-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cc-guard-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">callcc-impersonate-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an impersonator of <span class="RktVar">prompt-tag</span>, which redirects
+the <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-prompt%29%29" class="RktValLink" data-pltdoc="x">call-with-continuation-prompt</a></span> and
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._abort-current-continuation%29%29" class="RktValLink" data-pltdoc="x">abort-current-continuation</a></span> operations.</div></p><p>The <span class="RktVar">handle-proc</span> must accept the values that the handler
+of a continuation prompt would take and it must produce replacement
+values, which will be passed to the handler.</p><p>The <span class="RktVar">abort-proc</span> must accept the values passed to
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._abort-current-continuation%29%29" class="RktValLink" data-pltdoc="x">abort-current-continuation</a></span>; it must produce replacement
+values, which are aborted to the appropriate prompt.</p><p>The <span class="RktVar">cc-guard-proc</span> must accept the values produced by
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-prompt%29%29" class="RktValLink" data-pltdoc="x">call-with-continuation-prompt</a></span> in the case that a
+non-composable continuation is applied to replace the continuation
+that is delimited by the prompt, but only if
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._abort-current-continuation%29%29" class="RktValLink" data-pltdoc="x">abort-current-continuation</a></span> is not later used to abort the
+continuation delimited by the prompt (in which case
+<span class="RktVar">abort-proc</span> is used).</p><p>The <span class="RktVar">callcc-impersonate-proc</span> must accept a procedure that
+guards the result of a continuation captured by
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-current-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-current-continuation</a></span> with the impersonated prompt
+tag. The <span class="RktVar">callcc-impersonate-proc</span> is applied (under a
+<a href="eval-model.html#%28tech._continuation._barrier%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation barrier</span></a>) when the captured continuation is applied
+to refine a guard function (initially <span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span>) that is
+specific to the delimiting prompt; this prompt-specific guard is
+ultimately composed with any <span class="RktVar">cc-guard-proc</span> that is in effect
+at the delimiting prompt, and it is not used in the same case that a
+<span class="RktVar">cc-guard-proc</span> is not used (i.e., when
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._abort-current-continuation%29%29" class="RktValLink" data-pltdoc="x">abort-current-continuation</a></span> is used to abort to the
+prompt). In the special case where the delimiting prompt at
+application time is a thread&rsquo;s built-in initial prompt,
+<span class="RktVar">callcc-impersonate-proc</span> is ignored (partly on the grounds
+that the initial prompt&rsquo;s result is ignored).</p><p>Pairs of <span class="RktVar">prop</span> and <span class="RktVar">prop-val</span> (the number of arguments
+to <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">impersonate-prompt-tag</a></span> must be odd) add impersonator properties
+or override impersonator-property values of <span class="RktVar">prompt-tag</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._tag%29%29" class="RktStxLink" data-pltdoc="x">tag</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">impersonate-prompt-tag</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">make-continuation-prompt-tag</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-prompt%29%29" class="RktValLink" data-pltdoc="x">call-with-continuation-prompt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._abort-current-continuation%29%29" class="RktValLink" data-pltdoc="x">abort-current-continuation</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._tag%29%29" class="RktStxLink" data-pltdoc="x">tag</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._tag%29%29" class="RktStxLink" data-pltdoc="x">tag</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">12</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._impersonate-continuation-mark-key))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-continuation-mark-key%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonate-continuation-mark-key</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">key</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">get-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">set-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">continuation-mark?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-key~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-key?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">get-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an impersonator of <span class="RktVar">key</span>, which redirects
+<span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span> and continuation mark accessors such
+as <span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3elist%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set-&gt;list</a></span>.</div></p><p>The <span class="RktVar">get-proc</span> must accept the value attached to a
+continuation mark and it must produce a replacement
+value, which will be returned by the continuation mark accessor.</p><p>The <span class="RktVar">set-proc</span> must accept a value passed to
+<span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span>; it must produce a replacement
+value, which is attached to the continuation frame.</p><p>Pairs of <span class="RktVar">prop</span> and <span class="RktVar">prop-val</span> (the number of arguments
+to <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-continuation-mark-key%29%29" class="RktValLink" data-pltdoc="x">impersonate-continuation-mark-key</a></span> must be odd) add impersonator properties
+or override impersonator-property values of <span class="RktVar">key</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mark-key</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-continuation-mark-key%29%29" class="RktValLink" data-pltdoc="x">impersonate-continuation-mark-key</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-mark-key%29%29" class="RktValLink" data-pltdoc="x">make-continuation-mark-key</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-upcase%29%29" class="RktValLink" data-pltdoc="x">char-upcase</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-~3elist%29%29" class="RktValLink" data-pltdoc="x">string-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mark-key</span><span class="hspace">&nbsp;</span><span class="RktVal">"quiche"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-first%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set-first</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="RktValLink" data-pltdoc="x">current-continuation-marks</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">mark-key</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(#\Q #\U #\I #\C #\H #\E)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._prop~3aimpersonator-of))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._prop~3aimpersonator-of%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:impersonator-of</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property</span></a> (see <a href="structprops.html" data-pltdoc="x">Structure Type Properties</a>) that
+supplies a procedure for extracting an impersonated value from a structure
+that represents an impersonator. The property is used for <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span>
+as well as <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>.</div></p><p>The property value must be a procedure of one argument, which is a
+structure whose structure type has the property. The result can be
+<span class="RktVal">#f</span> to indicate the structure does not represent an impersonator,
+otherwise the result is a value for which the original structure is an
+impersonator (so the original structure is an <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span> and
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to the result value). The result value must have the
+same <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._prop~3aimpersonator-of%29%29" class="RktValLink" data-pltdoc="x">prop:impersonator-of</a></span> and <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._prop~3aequal%2Bhash%29%29" class="RktValLink" data-pltdoc="x">prop:equal+hash</a></span> property
+values as the original structure, if any, and the property values must be
+inherited from the same structure type (which ensures some consistency
+between <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span> and <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>).</p><p><a href="chaperones.html#%28tech._impersonator._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">Impersonator property</span></a> predicates and accessors applied to a
+structure with the <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._prop~3aimpersonator-of%29%29" class="RktValLink" data-pltdoc="x">prop:impersonator-of</a></span> property first check
+for the property on the immediate structure, and if it is not found,
+the value produced by the <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._prop~3aimpersonator-of%29%29" class="RktValLink" data-pltdoc="x">prop:impersonator-of</a></span> procedure is
+checked (recursively).</p><p class="SHistory">Changed in version 6.1.1.8 of package <span class="stt">base</span>: Made <a href="chaperones.html#%28tech._impersonator._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator property</span></a>
+predicates and accessors sensitive
+to <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._prop~3aimpersonator-of%29%29" class="RktValLink" data-pltdoc="x">prop:impersonator-of</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._prop~3aauthentic))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._prop~3aauthentic%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:authentic</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property</span></a> that declares a structure type as
+<a name="(tech._authentic)"></a><span style="font-style: italic">authentic</span>. The value associated with the property is ignored;
+the presence of the property itself makes the structure type
+authentic.</div></p><p>Instances of an <a href="chaperones.html#%28tech._authentic%29" class="techoutside" data-pltdoc="x"><span class="techinside">authentic</span></a> structure type cannot be impersonated
+via <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-struct%29%29" class="RktValLink" data-pltdoc="x">impersonate-struct</a></span> or chaperoned via
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-struct%29%29" class="RktValLink" data-pltdoc="x">chaperone-struct</a></span>. As a consequence, an instance of an
+<a href="chaperones.html#%28tech._authentic%29" class="techoutside" data-pltdoc="x"><span class="techinside">authentic</span></a> structure type can be given a contract (see
+<span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fstruct-dc..rkt%29._struct%2Fc%29%29" class="RktStxLink" data-pltdoc="x">struct/c</a></span>) only if it is a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>.</p><p>Declaring a structure type as <a href="chaperones.html#%28tech._authentic%29" class="techoutside" data-pltdoc="x"><span class="techinside">authentic</span></a> can prevent unwanted
+structure impersonation, but exposed structure types normally should
+support impersonators or chaperones to facilitate contracts. Declaring
+a structure type as <a href="chaperones.html#%28tech._authentic%29" class="techoutside" data-pltdoc="x"><span class="techinside">authentic</span></a> can also slightly improve the
+performance of structure predicates, selectors, and mutators, which
+can be appropriate for data structures that are private
+and frequently used within a library.</p><p class="SHistory">Added in version 6.9.0.4 of package <span class="stt">base</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Chaperone_Constructors&quot;">14.5.2<tt>&nbsp;</tt><a name="(part._.Chaperone_.Constructors)"></a>Chaperone Constructors</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._chaperone-procedure))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._chaperone-procedure%29%29" class="RktValDef RktValLink" data-pltdoc="x">chaperone-procedure</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">wrapper-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">wrapper-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span>, but for each value supplied to
+<span class="RktVar">wrapper-proc</span>, the corresponding result must be the same or a
+chaperone of (in the sense of <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-of~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-of?</a></span>)  the supplied
+value. The additional result, if any, that precedes the chaperoned
+values must be a procedure that accepts as many results as produced by
+<span class="RktVar">proc</span>; it must return the same number of results, each of
+which is the same or a chaperone of the corresponding original result.</div></p><p>For applications that include keyword arguments, <span class="RktVar">wrapper-proc</span>
+must return an additional value before any other values but after the
+result-chaperoning procedure (if any). The additional value must be a
+list of chaperones of the keyword arguments that were supplied to the
+chaperone procedure (i.e., not counting optional arguments that were
+not supplied). The arguments must be ordered according to the sorted
+order of the supplied arguments&rsquo; keywords.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._chaperone-procedure*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._chaperone-procedure%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">chaperone-procedure*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">wrapper-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">wrapper-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._chaperone-procedure%29%29" class="RktValLink" data-pltdoc="x">chaperone-procedure</a></span>, but <span class="RktVar">wrapper-proc</span> receives
+an extra argument as with <span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%2A%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure*</a></span>.</div></p><p class="SHistory">Added in version 6.1.1.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._chaperone-struct))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-struct%29%29" class="RktValDef RktValLink" data-pltdoc="x">chaperone-struct</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">struct-type</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">orig-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">redirect-proc</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">struct-type</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-type~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">unspecified</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">orig-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-accessor-procedure~3f%29%29" class="RktValLink" data-pltdoc="x">struct-accessor-procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-mutator-procedure~3f%29%29" class="RktValLink" data-pltdoc="x">struct-mutator-procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property-accessor-procedure~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property-accessor-procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._one-of%2Fc%29%29" class="RktValLink" data-pltdoc="x">one-of/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-info%29%29" class="RktValLink" data-pltdoc="x">struct-info</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">redirect-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-struct%29%29" class="RktValLink" data-pltdoc="x">impersonate-struct</a></span>, but with the following refinements,
+where <span class="RktVar">self</span> refers to the value to which
+a <span class="RktVar">orig-proc</span> is originally applied:</div></p><ul><li><p>With a structure-field accessor as <span class="RktVar">orig-proc</span>,
+<span class="RktVar">redirect-proc</span> must accept two arguments, <span class="RktVar">self</span> and
+the value <span class="RktVar">field-v</span> that <span class="RktVar">orig-proc</span> produces for
+<span class="RktVar">v</span>; it must return a chaperone of <span class="RktVar">field-v</span>. The
+corresponding field may be immutable.</p></li><li><p>With structure-field mutator as <span class="RktVar">orig-proc</span>,
+<span class="RktVar">redirect-proc</span> must accept two arguments, <span class="RktVar">self</span> and
+the value <span class="RktVar">field-v</span> supplied to the mutator; it must
+return a chaperone of <span class="RktVar">field-v</span> to be propagated to
+<span class="RktVar">orig-proc</span> and <span class="RktVar">v</span>.</p></li><li><p>A property accessor can be supplied as <span class="RktVar">orig-proc</span>, and
+the property need not have been created with
+<span class="RktVal">'</span><span class="RktVal">can-impersonate</span>.  The corresponding
+<span class="RktVar">redirect-proc</span> uses the same protocol as for a
+structure-field accessor.</p></li><li><p>With <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-info%29%29" class="RktValLink" data-pltdoc="x">struct-info</a></span> as <span class="RktVar">orig-proc</span>, the
+corresponding <span class="RktVar">redirect-proc</span> must accept two values,
+which are the results of <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-info%29%29" class="RktValLink" data-pltdoc="x">struct-info</a></span> on <span class="RktVar">v</span>; it
+must return each values or a chaperone of each value. The
+<span class="RktVar">redirect-proc</span> is not called if <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-info%29%29" class="RktValLink" data-pltdoc="x">struct-info</a></span>
+would return <span class="RktVal">#f</span> as its first argument. An
+<span class="RktVar">orig-proc</span> can be <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-info%29%29" class="RktValLink" data-pltdoc="x">struct-info</a></span> only if
+<span class="RktVar">struct-type</span> or some other <span class="RktVar">orig-proc</span> is supplied.</p></li><li><p>Any accessor or mutator <span class="RktVar">orig-proc</span> that is an
+<a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a> must be specifically a <a href="chaperones.html#%28tech._chaperone%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone</span></a>.</p></li></ul><p>Supplying a property accessor for <span class="RktVar">orig-proc</span> enables
+<span class="RktVar">prop</span> arguments, the same as supplying an accessor, mutator,
+or structure type.</p><p class="SHistory">Changed in version 6.1.1.2 of package <span class="stt">base</span>: Changed first argument to an
+accessor or mutator
+<span class="RktVar">redirect-proc</span> from
+<span class="RktVar">v</span> to <span class="RktVar">self</span>.<br/>Changed in version 6.1.1.8: Added optional <span class="RktVar">struct-type</span>
+argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._chaperone-vector))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-vector%29%29" class="RktValDef RktValLink" data-pltdoc="x">chaperone-vector</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">vec</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">ref-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">set-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ref-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-vector%29%29" class="RktValLink" data-pltdoc="x">impersonate-vector</a></span>, but with support for immutable vectors. The
+<span class="RktVar">ref-proc</span> procedure must produce the same value or a chaperone
+of the original value, and <span class="RktVar">set-proc</span> must produce the value
+that is given or a chaperone of the value. The <span class="RktVar">set-proc</span> will
+not be used if <span class="RktVar">vec</span> is immutable.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._chaperone-vector*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-vector%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">chaperone-vector*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">vec</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">ref-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">set-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ref-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-vector%29%29" class="RktValLink" data-pltdoc="x">chaperone-vector</a></span>, but <span class="RktVar">ref-proc</span> and <span class="RktVar">set-proc</span> receive an extra argument
+as with <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-vector%2A%29%29" class="RktValLink" data-pltdoc="x">impersonate-vector*</a></span>.</div></p><p class="SHistory">Added in version 6.9.0.2 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._chaperone-box))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-box%29%29" class="RktValDef RktValLink" data-pltdoc="x">chaperone-box</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">box</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">unbox-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">set-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="RktValLink" data-pltdoc="x">box?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">box</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="RktValLink" data-pltdoc="x">box?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">unbox-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="RktValLink" data-pltdoc="x">box?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="RktValLink" data-pltdoc="x">box?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-box%29%29" class="RktValLink" data-pltdoc="x">impersonate-box</a></span>, but with support for immutable boxes. The
+<span class="RktVar">unbox-proc</span> procedure must produce the same value or a
+chaperone of the original value, and <span class="RktVar">set-proc</span> must produce
+the same value or a chaperone of the value that it is given.  The
+<span class="RktVar">set-proc</span> will not be used if <span class="RktVar">box</span> is immutable.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._chaperone-hash))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-hash%29%29" class="RktValDef RktValLink" data-pltdoc="x">chaperone-hash</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">ref-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">set-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">remove-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">key-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">clear-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">equal-key-proc</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">ref-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">remove-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">clear-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">equal-key-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-hash%29%29" class="RktValLink" data-pltdoc="x">impersonate-hash</a></span>, but with constraints on the given functions
+and support for immutable hashes. The <span class="RktVar">ref-proc</span> procedure must
+return a found value or a chaperone of the value. The
+<span class="RktVar">set-proc</span> procedure must produce two values: the key that it
+is given or a chaperone of the key and the value that it is given or a
+chaperone of the value. The <span class="RktVar">remove-proc</span>, <span class="RktVar">key-proc</span>,
+and <span class="RktVar">equal-key-proc</span>
+procedures must produce the given key or a chaperone of the key.</div></p><p class="SHistory">Changed in version 6.3.0.11 of package <span class="stt">base</span>: Added the <span class="RktVar">equal-key-proc</span>
+argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._chaperone-struct-type))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-struct-type%29%29" class="RktValDef RktValLink" data-pltdoc="x">chaperone-struct-type</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">struct-type</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">struct-info-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">make-constructor-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">guard-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-type~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">struct-type</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-type~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">struct-info-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">make-constructor-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">guard-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a chaperoned value like <span class="RktVar">struct-type</span>, but with
+<span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-info%29%29" class="RktValLink" data-pltdoc="x">struct-type-info</a></span> and <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-make-constructor%29%29" class="RktValLink" data-pltdoc="x">struct-type-make-constructor</a></span>
+operations on the chaperoned structure type redirected. In addition,
+when a new structure type is created as a subtype of the chaperoned
+structure type, <span class="RktVar">guard-proc</span> is interposed as an extra guard on
+creation of instances of the subtype.</div></p><p>The <span class="RktVar">struct-info-proc</span> must accept 8 arguments&#8212;<wbr></wbr>the result of
+<span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-info%29%29" class="RktValLink" data-pltdoc="x">struct-type-info</a></span> on <span class="RktVar">struct-type</span>. It must return 8
+values, where each is the same or a chaperone of the corresponding
+argument. The 8 values are used as the results of
+<span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-info%29%29" class="RktValLink" data-pltdoc="x">struct-type-info</a></span> for the chaperoned structure type.</p><p>The <span class="RktVar">make-constructor-proc</span> must accept a single procedure
+argument, which is a constructor produced by
+<span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-make-constructor%29%29" class="RktValLink" data-pltdoc="x">struct-type-make-constructor</a></span> on <span class="RktVar">struct-type</span>. It must
+return the same or a chaperone of the procedure, which is used as the
+result of <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-make-constructor%29%29" class="RktValLink" data-pltdoc="x">struct-type-make-constructor</a></span> on the chaperoned
+structure type.</p><p>The <span class="RktVar">guard-proc</span> is like a <span class="RktSym">guard</span> argument to
+<span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span>: it must accept one more argument
+than a constructor for <span class="RktVar">struct-type</span>, where the last argument
+is the name the name of the instantiated structure type.
+It must return the number of values needed by the constructor
+(i.e. one value for each argument but the last),
+and each returned value must be the same as
+or a chaperone of the corresponding argument.
+The <span class="RktVar">guard-proc</span> is added as a constructor guard when a subtype is
+created of the chaperoned structure type.</p><p>Pairs of <span class="RktVar">prop</span> and <span class="RktVar">prop-val</span> (the number of arguments
+to <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-struct-type%29%29" class="RktValLink" data-pltdoc="x">chaperone-struct-type</a></span> must be even) add impersonator properties
+or override impersonator-property values of <span class="RktVar">struct-type</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._chaperone-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">chaperone-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a chaperoned value like <span class="RktVar">evt</span>, but with <span class="RktVar">proc</span>
+as an event generator when the result is synchronized with functions
+like <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span>.</div></p><p>The <span class="RktVar">proc</span> generator is called on synchronization, much like
+the procedure passed to <span class="RktSym"><a href="sync.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._guard-evt%29%29" class="RktValLink" data-pltdoc="x">guard-evt</a></span>, except that <span class="RktVar">proc</span>
+is given <span class="RktVar">evt</span>. The <span class="RktVar">proc</span> must return two values: a
+<a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> that is a chaperone of <span class="RktVar">evt</span>, and a
+procedure that is used to check the event&rsquo;s result if it is chosen in
+a selection. The latter procedure accepts the result of <span class="RktVar">evt</span>,
+and it must return a chaperone of that value.</p><p>Pairs of <span class="RktVar">prop</span> and <span class="RktVar">prop-val</span> (the number of arguments
+to <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-evt%29%29" class="RktValLink" data-pltdoc="x">chaperone-evt</a></span> must be even) add impersonator properties
+or override impersonator-property values of <span class="RktVar">evt</span>.</p><p>The result is <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-of~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-of?</a></span> the argument <span class="RktVar">evt</span>.
+However, if <span class="RktVar">evt</span> is a <a href="eval-model.html#%28tech._thread%29" class="techoutside" data-pltdoc="x"><span class="techinside">thread</span></a>, <a href="semaphore.html#%28tech._semaphore%29" class="techoutside" data-pltdoc="x"><span class="techinside">semaphore</span></a>,
+<a href="ports.html#%28tech._input._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">input port</span></a>, <a href="ports.html#%28tech._output._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">output port</span></a>, or <a href="willexecutor.html#%28tech._will._executor%29" class="techoutside" data-pltdoc="x"><span class="techinside">will executor</span></a>, the
+result is not recognized as such. For example, <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="RktValLink" data-pltdoc="x">thread?</a></span>
+applied to the result of <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-evt%29%29" class="RktValLink" data-pltdoc="x">chaperone-evt</a></span> will always produce
+<span class="RktVal">#f</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._chaperone-channel))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-channel%29%29" class="RktValDef RktValLink" data-pltdoc="x">chaperone-channel</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">channel</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">get-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">put-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel~3f%29%29" class="RktValLink" data-pltdoc="x">channel?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">channel</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel~3f%29%29" class="RktValLink" data-pltdoc="x">channel?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">get-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel~3f%29%29" class="RktValLink" data-pltdoc="x">channel?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel~3f%29%29" class="RktValLink" data-pltdoc="x">channel?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">put-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel~3f%29%29" class="RktValLink" data-pltdoc="x">channel?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-channel%29%29" class="RktValLink" data-pltdoc="x">impersonate-channel</a></span>, but with restrictions on the
+<span class="RktVar">get-proc</span> and <span class="RktVar">put-proc</span> procedures.</div></p><p>The <span class="RktVar">get-proc</span> must return two values: a <a href="channel.html#%28tech._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">channel</span></a>
+that is a chaperone of <span class="RktVar">channel</span>, and a procedure that
+is used to check the channel&rsquo;s contents. The latter procedure
+must return the original value or a chaperone of that value.</p><p>The <span class="RktVar">put-proc</span> must produce a replacement value that is
+either the original value communicated on the channel or a
+chaperone of that value.</p><p>Pairs of <span class="RktVar">prop</span> and <span class="RktVar">prop-val</span> (the number of arguments
+to <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-channel%29%29" class="RktValLink" data-pltdoc="x">chaperone-channel</a></span> must be odd) add impersonator properties
+or override impersonator-property values of <span class="RktVar">channel</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._chaperone-prompt-tag))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-prompt-tag%29%29" class="RktValDef RktValLink" data-pltdoc="x">chaperone-prompt-tag</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prompt-tag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">handle-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">abort-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">cc-guard-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">callcc-chaperone-proc</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-prompt-tag?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prompt-tag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-prompt-tag?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">handle-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">abort-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cc-guard-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">callcc-chaperone-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">impersonate-prompt-tag</a></span>, but produces a chaperoned value.
+The <span class="RktVar">handle-proc</span> procedure must produce the same values or
+chaperones of the original values, <span class="RktVar">abort-proc</span> must produce
+the same values or chaperones of the values that it is given, and
+<span class="RktVar">cc-guard-proc</span> must produce the same values or chaperones of
+the original result values, and <span class="RktVar">callcc-chaperone-proc</span> must
+produce a procedure that is a chaperone or the same as the given
+procedure.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bad-chaperone</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">chaperone-prompt-tag</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">make-continuation-prompt-tag</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-prompt%29%29" class="RktValLink" data-pltdoc="x">call-with-continuation-prompt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._abort-current-continuation%29%29" class="RktValLink" data-pltdoc="x">abort-current-continuation</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bad-chaperone</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">bad-chaperone</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">abort-current-continuation: non-chaperone result; received a</span></p></td></tr><tr><td><p><span class="RktErr">prompt-abort argument that is not a chaperone of the</span></p></td></tr><tr><td><p><span class="RktErr">original prompt-abort argument</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">original: 5</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">received: 6</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">good-chaperone</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">chaperone-prompt-tag</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">make-continuation-prompt-tag</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"not even"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"not even"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-prompt%29%29" class="RktValLink" data-pltdoc="x">call-with-continuation-prompt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._abort-current-continuation%29%29" class="RktValLink" data-pltdoc="x">abort-current-continuation</a></span><span class="hspace">&nbsp;</span><span class="RktSym">good-chaperone</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">good-chaperone</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._chaperone-continuation-mark-key))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-continuation-mark-key%29%29" class="RktValDef RktValLink" data-pltdoc="x">chaperone-continuation-mark-key</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">key</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">get-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">set-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-key~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-key?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-key~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-key?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">get-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-continuation-mark-key%29%29" class="RktValLink" data-pltdoc="x">impersonate-continuation-mark-key</a></span>, but produces a
+chaperoned value.  The <span class="RktVar">get-proc</span> procedure must produce the
+same value or a chaperone of the original value, and <span class="RktVar">set-proc</span>
+must produce the same value or a chaperone of the value that it is
+given.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bad-chaperone</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-continuation-mark-key%29%29" class="RktValLink" data-pltdoc="x">chaperone-continuation-mark-key</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-mark-key%29%29" class="RktValLink" data-pltdoc="x">make-continuation-mark-key</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-upcase%29%29" class="RktValLink" data-pltdoc="x">char-upcase</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-~3elist%29%29" class="RktValLink" data-pltdoc="x">string-&gt;list</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bad-chaperone</span><span class="hspace">&nbsp;</span><span class="RktVal">"timballo"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-first%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set-first</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="RktValLink" data-pltdoc="x">current-continuation-marks</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">bad-chaperone</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">with-continuation-mark: non-chaperone result; received a</span></p></td></tr><tr><td><p><span class="RktErr">value that is not a chaperone of the original value</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">original: "timballo"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">received: '(#\t #\i #\m #\b #\a #\l #\l #\o)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">checker</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e%29%29" class="RktValLink" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="RktValLink" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">s</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"expected string of length at least 5"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">good-chaperone</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-continuation-mark-key%29%29" class="RktValLink" data-pltdoc="x">chaperone-continuation-mark-key</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-mark-key%29%29" class="RktValLink" data-pltdoc="x">make-continuation-mark-key</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">checker</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">checker</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span><span class="hspace">&nbsp;</span><span class="RktSym">good-chaperone</span><span class="hspace">&nbsp;</span><span class="RktVal">"zabaione"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-first%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set-first</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="RktValLink" data-pltdoc="x">current-continuation-marks</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">good-chaperone</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"zabaione"</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Impersonator_Properties&quot;">14.5.3<tt>&nbsp;</tt><a name="(part._.Impersonator_.Properties)"></a>Impersonator Properties</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-impersonator-property))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._make-impersonator-property%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-impersonator-property</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new <a href="chaperones.html#%28tech._impersonator._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator property</span></a> and returns three values:</div></p><ul><li><p>an <a name="(tech._impersonator._property._descriptor)"></a><span style="font-style: italic">impersonator property descriptor</span>, for use with
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span>, <span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._chaperone-procedure%29%29" class="RktValLink" data-pltdoc="x">chaperone-procedure</a></span>,
+and other impersonator constructors;</p></li><li><p>an <a name="(tech._impersonator._property._predicate)"></a><span style="font-style: italic">impersonator property predicate</span> procedure, which takes
+an arbitrary value and returns <span class="RktVal">#t</span> if the value is an
+impersonator with a value for the property, <span class="RktVal">#f</span>
+otherwise;</p></li><li><p>an <a name="(tech._impersonator._property._accessor)"></a><span style="font-style: italic">impersonator property accessor</span> procedure, which
+returns the value associated with an impersonator for the property;
+if a value given to the accessor is not an impersonator or does not
+have a value for the property (i.e. if the corresponding impersonator
+property predicate returns <span class="RktVal">#f</span>), then a second optional argument
+to the selector determines its response: the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised
+if a second argument is not provided, the second argument is tail-called
+with zero arguments if it is a procedure, and the second argument is returned
+otherwise.</p></li></ul><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._impersonator-property~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonator-property?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="chaperones.html#%28tech._impersonator._property._descriptor%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator property
+descriptor</span></a> value, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._impersonator-property-accessor-procedure~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property-accessor-procedure~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonator-property-accessor-procedure?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is an accessor procedure produced
+by <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._make-impersonator-property%29%29" class="RktValLink" data-pltdoc="x">make-impersonator-property</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._impersonator-prop~3aapplication-mark))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-prop~3aapplication-mark%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonator-prop:application-mark</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">An <a href="chaperones.html#%28tech._impersonator._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator property</span></a> that is recognized by <span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span>
+and <span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._chaperone-procedure%29%29" class="RktValLink" data-pltdoc="x">chaperone-procedure</a></span>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Module_Names_and_Loading.html" title="backward to &quot;14.4 Module Names and Loading&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="securityguards.html" title="forward to &quot;14.6 Security Guards&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/characters.html b/clones/docs.racket-lang.org/reference/characters.html
new file mode 100644
index 00000000..cf4e0064
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/characters.html
@@ -0,0 +1,71 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.6&nbsp;Characters</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewselflink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.6&nbsp;</td><td><a href="characters.html" class="tocviewselflink" data-pltdoc="x">Characters</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.6.1&nbsp;</td><td><a href="characters.html#%28part._.Characters_and_.Scalar_.Values%29" class="tocviewlink" data-pltdoc="x">Characters and Scalar Values</a></td></tr><tr><td align="right">4.6.2&nbsp;</td><td><a href="characters.html#%28part._.Character_.Comparisons%29" class="tocviewlink" data-pltdoc="x">Character Comparisons</a></td></tr><tr><td align="right">4.6.3&nbsp;</td><td><a href="characters.html#%28part._.Classifications%29" class="tocviewlink" data-pltdoc="x">Classifications</a></td></tr><tr><td align="right">4.6.4&nbsp;</td><td><a href="characters.html#%28part._.Character_.Conversions%29" class="tocviewlink" data-pltdoc="x">Character Conversions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">4.6.1<tt>&nbsp;</tt></span><a href="characters.html#%28part._.Characters_and_.Scalar_.Values%29" class="tocsubseclink" data-pltdoc="x">Characters and Scalar Values</a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char?</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-~3einteger%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>&gt;integer</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._integer-~3echar%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">integer-<wbr></wbr>&gt;char</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-utf-8-length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>utf-<wbr></wbr>8-<wbr></wbr>length</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.6.2<tt>&nbsp;</tt></span><a href="characters.html#%28part._.Character_.Comparisons%29" class="tocsubseclink" data-pltdoc="x">Character Comparisons</a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char=?</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3c~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char&lt;?</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3c~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char&lt;=?</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3e~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char&gt;?</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3e~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char&gt;=?</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>ci=?</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3c~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>ci&lt;?</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3c~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>ci&lt;=?</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3e~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>ci&gt;?</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3e~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>ci&gt;=?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.6.3<tt>&nbsp;</tt></span><a href="characters.html#%28part._.Classifications%29" class="tocsubseclink" data-pltdoc="x">Classifications</a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-alphabetic~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>alphabetic?</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-lower-case~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>lower-<wbr></wbr>case?</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-upper-case~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>upper-<wbr></wbr>case?</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-title-case~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>title-<wbr></wbr>case?</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-numeric~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>numeric?</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-symbolic~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>symbolic?</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-punctuation~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>punctuation?</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-graphic~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>graphic?</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-whitespace~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>whitespace?</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-blank~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>blank?</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-iso-control~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>iso-<wbr></wbr>control?</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-general-category%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>general-<wbr></wbr>category</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._make-known-char-range-list%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>known-<wbr></wbr>char-<wbr></wbr>range-<wbr></wbr>list</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.6.4<tt>&nbsp;</tt></span><a href="characters.html#%28part._.Character_.Conversions%29" class="tocsubseclink" data-pltdoc="x">Character Conversions</a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-upcase%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>upcase</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-downcase%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>downcase</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-titlecase%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>titlecase</span></span></a></td></tr><tr><td><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-foldcase%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>foldcase</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="bytestrings.html" title="backward to &quot;4.5 Byte Strings&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="symbols.html" title="forward to &quot;4.7 Symbols&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;characters&quot;">4.6<tt>&nbsp;</tt><a name="(part._characters)"></a>Characters</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=characters.html&amp;version=8.6" class="Sq" data-pltdoc="x">Characters</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces characters.</p></blockquote></blockquote></blockquote><p><a name="(tech._character)"></a><span style="font-style: italic">Characters</span> range over Unicode
+<a name="(idx._(gentag._149._(lib._scribblings/reference/reference..scrbl)))"></a>scalar values, which includes
+characters whose values range from <span class="RktVal">#x0</span> to
+<span class="RktVal">#x10FFFF</span>, but not including <span class="RktVal">#xD800</span> to
+<span class="RktVal">#xDFFF</span>. The scalar values are a subset of the Unicode
+<a name="(idx._(gentag._150._(lib._scribblings/reference/reference..scrbl)))"></a>code points.</p><p>Two characters are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span> if they correspond to the same scalar
+value. For each scalar value less than 256, character values that are
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span> are also <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>. Characters produced by the default
+reader are <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> in <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode.</p><p>See <a href="reader.html#%28part._parse-character%29" data-pltdoc="x">Reading Characters</a>
+    for information on <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>ing
+    characters and <a href="printing.html#%28part._print-character%29" data-pltdoc="x">Printing Characters</a>
+    for information on <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>ing characters.</p><p class="SHistory">Changed in version 6.1.1.8 of package <span class="stt">base</span>: Updated from Unicode 5.0.1 to Unicode 7.0.0.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Characters_and_Scalar_Values&quot;">4.6.1<tt>&nbsp;</tt><a name="(part._.Characters_and_.Scalar_.Values)"></a>Characters and Scalar Values</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Return <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a character, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-~3einteger))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-~3einteger%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-&gt;integer</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a character&rsquo;s code-point number.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-~3einteger%29%29" class="RktValLink" data-pltdoc="x">char-&gt;integer</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">65</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._integer-~3echar))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._integer-~3echar%29%29" class="RktValDef RktValLink" data-pltdoc="x">integer-&gt;char</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">k</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">#xD7FF</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#xE000</span><span class="hspace">&nbsp;</span><span class="RktVal">#x10FFFF</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Return the character whose code-point number is <span class="RktVar">k</span>. For
+<span class="RktVar">k</span> less than <span class="RktVal">256</span>, the result is the same object for
+the same <span class="RktVar">k</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._integer-~3echar%29%29" class="RktValLink" data-pltdoc="x">integer-&gt;char</a></span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\A</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-utf-8-length))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-utf-8-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-utf-8-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces the same result as <span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Futf-8%29%29" class="RktValLink" data-pltdoc="x">string-&gt;bytes/utf-8</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string%29%29" class="RktValLink" data-pltdoc="x">string</a></span><span class="stt"> </span><span class="RktVar">char</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Character_Comparisons&quot;">4.6.2<tt>&nbsp;</tt><a name="(part._.Character_.Comparisons)"></a>Character Comparisons</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char~3d~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char1</span><span class="hspace">&nbsp;</span><span class="RktVar">char2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if all of the arguments are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3d~3f%29%29" class="RktValLink" data-pltdoc="x">char=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3d~3f%29%29" class="RktValLink" data-pltdoc="x">char=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char~3c~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3c~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char&lt;?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char1</span><span class="hspace">&nbsp;</span><span class="RktVar">char2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if the arguments are sorted increasing, where
+two characters are ordered by their scalar values, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3c~3f%29%29" class="RktValLink" data-pltdoc="x">char&lt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3c~3f%29%29" class="RktValLink" data-pltdoc="x">char&lt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3c~3f%29%29" class="RktValLink" data-pltdoc="x">char&lt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\b</span><span class="hspace">&nbsp;</span><span class="RktVal">#\c</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char~3c~3d~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3c~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char&lt;=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char1</span><span class="hspace">&nbsp;</span><span class="RktVar">char2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3c~3f%29%29" class="RktValLink" data-pltdoc="x">char&lt;?</a></span>, but checks whether the arguments are nondecreasing.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3c~3d~3f%29%29" class="RktValLink" data-pltdoc="x">char&lt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3c~3d~3f%29%29" class="RktValLink" data-pltdoc="x">char&lt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3c~3d~3f%29%29" class="RktValLink" data-pltdoc="x">char&lt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\b</span><span class="hspace">&nbsp;</span><span class="RktVal">#\b</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char~3e~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3e~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char&gt;?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char1</span><span class="hspace">&nbsp;</span><span class="RktVar">char2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3c~3f%29%29" class="RktValLink" data-pltdoc="x">char&lt;?</a></span>, but checks whether the arguments are decreasing.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3e~3f%29%29" class="RktValLink" data-pltdoc="x">char&gt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3e~3f%29%29" class="RktValLink" data-pltdoc="x">char&gt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3e~3f%29%29" class="RktValLink" data-pltdoc="x">char&gt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\c</span><span class="hspace">&nbsp;</span><span class="RktVal">#\b</span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char~3e~3d~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3e~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char&gt;=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char1</span><span class="hspace">&nbsp;</span><span class="RktVar">char2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3c~3f%29%29" class="RktValLink" data-pltdoc="x">char&lt;?</a></span>, but checks whether the arguments are nonincreasing.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3e~3d~3f%29%29" class="RktValLink" data-pltdoc="x">char&gt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3e~3d~3f%29%29" class="RktValLink" data-pltdoc="x">char&gt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3e~3d~3f%29%29" class="RktValLink" data-pltdoc="x">char&gt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\c</span><span class="hspace">&nbsp;</span><span class="RktVal">#\b</span><span class="hspace">&nbsp;</span><span class="RktVal">#\b</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-ci~3d~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-ci=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char1</span><span class="hspace">&nbsp;</span><span class="RktVar">char2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if all of the arguments are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span> after
+ locale-insensitive case-folding via <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-foldcase%29%29" class="RktValLink" data-pltdoc="x">char-foldcase</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3d~3f%29%29" class="RktValLink" data-pltdoc="x">char-ci=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3d~3f%29%29" class="RktValLink" data-pltdoc="x">char-ci=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-ci~3c~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3c~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-ci&lt;?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char1</span><span class="hspace">&nbsp;</span><span class="RktVar">char2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3c~3f%29%29" class="RktValLink" data-pltdoc="x">char&lt;?</a></span>, but checks whether the arguments would be in
+ increasing order if each was first case-folded using
+ <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-foldcase%29%29" class="RktValLink" data-pltdoc="x">char-foldcase</a></span> (which is locale-insensitive).</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3c~3f%29%29" class="RktValLink" data-pltdoc="x">char-ci&lt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3c~3f%29%29" class="RktValLink" data-pltdoc="x">char-ci&lt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\b</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3c~3f%29%29" class="RktValLink" data-pltdoc="x">char-ci&lt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\b</span><span class="hspace">&nbsp;</span><span class="RktVal">#\c</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-ci~3c~3d~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3c~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-ci&lt;=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char1</span><span class="hspace">&nbsp;</span><span class="RktVar">char2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3c~3f%29%29" class="RktValLink" data-pltdoc="x">char-ci&lt;?</a></span>, but checks whether the arguments would be nondecreasing after case-folding.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3c~3d~3f%29%29" class="RktValLink" data-pltdoc="x">char-ci&lt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3c~3d~3f%29%29" class="RktValLink" data-pltdoc="x">char-ci&lt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3c~3d~3f%29%29" class="RktValLink" data-pltdoc="x">char-ci&lt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\b</span><span class="hspace">&nbsp;</span><span class="RktVal">#\b</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-ci~3e~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3e~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-ci&gt;?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char1</span><span class="hspace">&nbsp;</span><span class="RktVar">char2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3c~3f%29%29" class="RktValLink" data-pltdoc="x">char-ci&lt;?</a></span>, but checks whether the arguments would be decreasing after case-folding.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3e~3f%29%29" class="RktValLink" data-pltdoc="x">char-ci&gt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3e~3f%29%29" class="RktValLink" data-pltdoc="x">char-ci&gt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\b</span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3e~3f%29%29" class="RktValLink" data-pltdoc="x">char-ci&gt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\c</span><span class="hspace">&nbsp;</span><span class="RktVal">#\b</span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-ci~3e~3d~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3e~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-ci&gt;=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char1</span><span class="hspace">&nbsp;</span><span class="RktVar">char2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3c~3f%29%29" class="RktValLink" data-pltdoc="x">char-ci&lt;?</a></span>, but checks whether the arguments would be nonincreasing after case-folding.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3e~3d~3f%29%29" class="RktValLink" data-pltdoc="x">char-ci&gt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3e~3d~3f%29%29" class="RktValLink" data-pltdoc="x">char-ci&gt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3e~3d~3f%29%29" class="RktValLink" data-pltdoc="x">char-ci&gt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\c</span><span class="hspace">&nbsp;</span><span class="RktVal">#\b</span><span class="hspace">&nbsp;</span><span class="RktVal">#\b</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Classifications&quot;">4.6.3<tt>&nbsp;</tt><a name="(part._.Classifications)"></a>Classifications</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-alphabetic~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-alphabetic~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-alphabetic?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">char</span> has the Unicode &ldquo;Alphabetic&rdquo;
+property.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-lower-case~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-lower-case~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-lower-case?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">char</span> has the Unicode &ldquo;Lowercase&rdquo;
+property.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-upper-case~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-upper-case~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-upper-case?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">char</span> has the Unicode &ldquo;Uppercase&rdquo;
+property.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-title-case~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-title-case~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-title-case?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">char</span>&rsquo;s Unicode general category is
+Lt, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-numeric~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-numeric~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-numeric?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">char</span> has a Unicode &ldquo;Numeric_Type&rdquo;
+property value that is not <span class="RktInBG"><span class="hspace"></span><span class="RktIn">None</span><span class="hspace"></span></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-symbolic~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-symbolic~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-symbolic?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">char</span>&rsquo;s Unicode general category is
+Sm, Sc, Sk, or So, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-punctuation~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-punctuation~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-punctuation?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">char</span>&rsquo;s Unicode general category is
+Pc, Pd, Ps, Pe, Pi, Pf, or
+Po, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-graphic~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-graphic~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-graphic?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">char</span>&rsquo;s Unicode general category is
+Ll, Lm, Lo, Lt, Lu, Nd, Nl, No,
+Mn, Mc, or Me, or if one of the following produces
+<span class="RktVal">#t</span> when applied to <span class="RktVar">char</span>: <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-alphabetic~3f%29%29" class="RktValLink" data-pltdoc="x">char-alphabetic?</a></span>,
+<span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-numeric~3f%29%29" class="RktValLink" data-pltdoc="x">char-numeric?</a></span>, <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-symbolic~3f%29%29" class="RktValLink" data-pltdoc="x">char-symbolic?</a></span>, or
+<span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-punctuation~3f%29%29" class="RktValLink" data-pltdoc="x">char-punctuation?</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-whitespace~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-whitespace~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-whitespace?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">char</span> has the Unicode &ldquo;White_Space&rdquo;
+property.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-blank~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-blank~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-blank?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">char</span>&rsquo;s Unicode general category is
+Zs or if <span class="RktVar">char</span> is <span class="RktVal">#\tab</span>. (These correspond to
+horizontal whitespace.)</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-iso-control~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-iso-control~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-iso-control?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Return <span class="RktVal">#t</span> if <span class="RktVar">char</span> is between <span class="RktVal">#\nul</span> and
+<span class="RktVal">#\u001F</span> inclusive or <span class="RktVal">#\rubout</span> and <span class="RktVal">#\u009F</span>
+inclusive.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-general-category))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-general-category%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-general-category</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a symbol representing the character&rsquo;s Unicode general
+category, which is <a name="(idx._(gentag._151._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">lu</span>, <a name="(idx._(gentag._152._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">ll</span>,
+<a name="(idx._(gentag._153._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">lt</span>, <a name="(idx._(gentag._154._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">lm</span>, <a name="(idx._(gentag._155._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">lo</span>,
+<a name="(idx._(gentag._156._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">mn</span>, <a name="(idx._(gentag._157._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">mc</span>, <a name="(idx._(gentag._158._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">me</span>,
+<a name="(idx._(gentag._159._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">nd</span>, <a name="(idx._(gentag._160._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">nl</span>, <a name="(idx._(gentag._161._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">no</span>,
+<a name="(idx._(gentag._162._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">ps</span>, <a name="(idx._(gentag._163._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">pe</span>, <a name="(idx._(gentag._164._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">pi</span>,
+<a name="(idx._(gentag._165._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">pf</span>, <a name="(idx._(gentag._166._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">pd</span>, <a name="(idx._(gentag._167._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">pc</span>,
+<a name="(idx._(gentag._168._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">po</span>, <a name="(idx._(gentag._169._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">sc</span>, <a name="(idx._(gentag._170._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">sm</span>,
+<a name="(idx._(gentag._171._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">sk</span>, <a name="(idx._(gentag._172._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">so</span>, <a name="(idx._(gentag._173._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">zs</span>,
+<a name="(idx._(gentag._174._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">zp</span>, <a name="(idx._(gentag._175._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">zl</span>, <a name="(idx._(gentag._176._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">cc</span>,
+<a name="(idx._(gentag._177._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">cf</span>, <a name="(idx._(gentag._178._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">cs</span>, <a name="(idx._(gentag._179._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">co</span>, or
+<a name="(idx._(gentag._180._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">cn</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-known-char-range-list))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._make-known-char-range-list%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-known-char-range-list</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Produces a list of three-element lists, where each three-element list
+represents a set of consecutive code points for which the Unicode
+standard specifies character properties. Each three-element list
+contains two integers and a boolean; the first integer is a starting
+code-point value (inclusive), the second integer is an ending
+code-point value (inclusive), and the boolean is <span class="RktVal">#t</span> when all
+characters in the code-point range have identical results for all of
+the character predicates above, have analogous transformations
+(shifting by the same amount, if any, in code-point space) for
+<span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-downcase%29%29" class="RktValLink" data-pltdoc="x">char-downcase</a></span>, <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-upcase%29%29" class="RktValLink" data-pltdoc="x">char-upcase</a></span>, and
+<span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-titlecase%29%29" class="RktValLink" data-pltdoc="x">char-titlecase</a></span>, and have the same
+decomposition&ndash;normalization behavior.
+The three-element lists are ordered in
+the overall result list such that later lists represent larger
+code-point values, and all three-element lists are separated from
+every other by at least one code-point value that is not specified by
+Unicode.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Character_Conversions&quot;">4.6.4<tt>&nbsp;</tt><a name="(part._.Character_.Conversions)"></a>Character Conversions</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-upcase))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-upcase%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-upcase</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a character consistent with the 1-to-1 code point mapping
+defined by Unicode. If <span class="RktVar">char</span> has no upcase mapping,
+<span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-upcase%29%29" class="RktValLink" data-pltdoc="x">char-upcase</a></span> produces <span class="RktVar">char</span>.</div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>String procedures, such as <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-upcase%29%29" class="RktValLink" data-pltdoc="x">string-upcase</a></span>, handle
+the case where Unicode defines a locale-independent mapping from the
+code point to a code-point sequence (in addition to the 1-1 mapping on
+scalar values).</p></blockquote></blockquote></blockquote><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-upcase%29%29" class="RktValLink" data-pltdoc="x">char-upcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\A</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-upcase%29%29" class="RktValLink" data-pltdoc="x">char-upcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\&#955;</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\&#923;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-upcase%29%29" class="RktValLink" data-pltdoc="x">char-upcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\space</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\space</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-downcase))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-downcase%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-downcase</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-upcase%29%29" class="RktValLink" data-pltdoc="x">char-upcase</a></span>, but for the Unicode downcase mapping.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-downcase%29%29" class="RktValLink" data-pltdoc="x">char-downcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\a</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-downcase%29%29" class="RktValLink" data-pltdoc="x">char-downcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\&#923;</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\&#955;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-downcase%29%29" class="RktValLink" data-pltdoc="x">char-downcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\space</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\space</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-titlecase))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-titlecase%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-titlecase</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-upcase%29%29" class="RktValLink" data-pltdoc="x">char-upcase</a></span>, but for the Unicode titlecase mapping.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-upcase%29%29" class="RktValLink" data-pltdoc="x">char-upcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\A</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-upcase%29%29" class="RktValLink" data-pltdoc="x">char-upcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\&#955;</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\&#923;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-upcase%29%29" class="RktValLink" data-pltdoc="x">char-upcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\space</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\space</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._char-foldcase))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-foldcase%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-foldcase</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-upcase%29%29" class="RktValLink" data-pltdoc="x">char-upcase</a></span>, but for the Unicode case-folding mapping.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-foldcase%29%29" class="RktValLink" data-pltdoc="x">char-foldcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\a</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-foldcase%29%29" class="RktValLink" data-pltdoc="x">char-foldcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\&#931;</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\&#963;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-foldcase%29%29" class="RktValLink" data-pltdoc="x">char-foldcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\&#962;</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\&#963;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-foldcase%29%29" class="RktValLink" data-pltdoc="x">char-foldcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\space</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\space</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="bytestrings.html" title="backward to &quot;4.5 Byte Strings&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="symbols.html" title="forward to &quot;4.7 Symbols&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/collapsible.html b/clones/docs.racket-lang.org/reference/collapsible.html
new file mode 100644
index 00000000..f4422ade
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/collapsible.html
@@ -0,0 +1,57 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>8.10&nbsp;Collapsible Contracts</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.1&nbsp;</td><td><a href="data-structure-contracts.html" class="tocviewlink" data-pltdoc="x">Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.2&nbsp;</td><td><a href="function-contracts.html" class="tocviewlink" data-pltdoc="x">Function Contracts</a></td></tr><tr><td align="right">8.3&nbsp;</td><td><a href="parametric-contracts.html" class="tocviewlink" data-pltdoc="x">Parametric Contracts</a></td></tr><tr><td align="right">8.4&nbsp;</td><td><a href="Lazy_Data-structure_Contracts.html" class="tocviewlink" data-pltdoc="x">Lazy Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.5&nbsp;</td><td><a href="Structure_Type_Property_Contracts.html" class="tocviewlink" data-pltdoc="x">Structure Type Property Contracts</a></td></tr><tr><td align="right">8.6&nbsp;</td><td><a href="attaching-contracts-to-values.html" class="tocviewlink" data-pltdoc="x">Attaching Contracts to Values</a></td></tr><tr><td align="right">8.7&nbsp;</td><td><a href="Building_New_Contract_Combinators.html" class="tocviewlink" data-pltdoc="x">Building New Contract Combinators</a></td></tr><tr><td align="right">8.8&nbsp;</td><td><a href="contract-utilities.html" class="tocviewlink" data-pltdoc="x">Contract Utilities</a></td></tr><tr><td align="right">8.9&nbsp;</td><td><a href="racket_contract_base.html" class="tocviewlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>contract/<span class="mywbr"> &nbsp;</span>base</span></span></a></td></tr><tr><td align="right">8.10&nbsp;</td><td><a href="collapsible.html" class="tocviewselflink" data-pltdoc="x">Collapsible Contracts</a></td></tr><tr><td align="right">8.11&nbsp;</td><td><a href="Legacy_Contracts.html" class="tocviewlink" data-pltdoc="x">Legacy Contracts</a></td></tr><tr><td align="right">8.12&nbsp;</td><td><a href="Random_generation.html" class="tocviewlink" data-pltdoc="x">Random generation</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._get%2Fbuild-collapsible-late-neg-projection%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get/<span class="mywbr"> &nbsp;</span>build-<wbr></wbr>collapsible-<wbr></wbr>late-<wbr></wbr>neg-<wbr></wbr>projection</span></span></a></td></tr><tr><td><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._collapsible-contract-continuation-mark-key%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-<wbr></wbr>contract-<wbr></wbr>continuation-<wbr></wbr>mark-<wbr></wbr>key</span></span></a></td></tr><tr><td><a href="collapsible.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._with-collapsible-contract-continuation-mark%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>collapsible-<wbr></wbr>contract-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._prop~3acollapsible-contract%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>collapsible-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-<wbr></wbr>contract?</span></span></a></td></tr><tr><td><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._merge%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">merge</span></span></a></td></tr><tr><td><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-guard%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-<wbr></wbr>guard</span></span></a></td></tr><tr><td><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract-property~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-<wbr></wbr>contract-<wbr></wbr>property?</span></span></a></td></tr><tr><td><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._build-collapsible-contract-property%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">build-<wbr></wbr>collapsible-<wbr></wbr>contract-<wbr></wbr>property</span></span></a></td></tr><tr><td><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-ho%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-<wbr></wbr>ho/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-leaf%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-<wbr></wbr>leaf/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._impersonator-prop~3acollapsible%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonator-<wbr></wbr>prop:<span class="mywbr"> &nbsp;</span>collapsible</span></span></a></td></tr><tr><td><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._has-impersonator-prop~3acollapsible~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">has-<wbr></wbr>impersonator-<wbr></wbr>prop:<span class="mywbr"> &nbsp;</span>collapsible?</span></span></a></td></tr><tr><td><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._get-impersonator-prop~3acollapsible%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get-<wbr></wbr>impersonator-<wbr></wbr>prop:<span class="mywbr"> &nbsp;</span>collapsible</span></span></a></td></tr><tr><td><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-property%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-<wbr></wbr>property</span></span></a></td></tr><tr><td><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-count-property%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-<wbr></wbr>count-<wbr></wbr>property</span></span></a></td></tr><tr><td><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-wrapper-property%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-<wbr></wbr>wrapper-<wbr></wbr>property</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="racket_contract_base.html" title="backward to &quot;8.9 racket/contract/base&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Legacy_Contracts.html" title="forward to &quot;8.11 Legacy Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;collapsible&quot;">8.10<tt>&nbsp;</tt><a name="(part._collapsible)"></a><a name="(mod-path._racket/contract/collapsible)"></a>Collapsible Contracts</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="collapsible.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/contract/collapsible</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara"><p class="SHistory">Added in version 7.1.0.10 of package <span class="stt">base</span>.</p></div></p><p><a name="(tech._collapsible._contract)"></a><span style="font-style: italic">Collapsible contracts</span> are an optimization in the contract system designed
+to avoid a particular pathological build up of contract wrappers on higher-order
+values. The <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vectorof%29%29" class="RktValLink" data-pltdoc="x">vectorof</a></span>, <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector%2Fc%29%29" class="RktValLink" data-pltdoc="x">vector/c</a></span>, and <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span> contract
+combinators support collapsing for vector contracts and function contracts for
+functions returning a single value.</p><p>Intuitively, a collapsible contract is a tree structure.
+The <a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-ho%2Fc%29%29" data-pltdoc="x">tree nodes</a> represent higher-order contracts
+ (e.g., <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span>) and the <a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-leaf%2Fc%29%29" data-pltdoc="x">tree leaves</a>
+ represent sequences of flat contracts.
+Two trees can collapse into one tree via the <span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._merge%29%29" class="RktValLink" data-pltdoc="x">merge</a></span> procedure,
+ which removes unnecessary flat contracts from the leaves.</p><p>For more information on the motivation and design of collapsible contracts,
+ see [<a href="doc-bibliography.html#%28cite._.Feltey18%29" data-pltdoc="x">Feltey18</a>].
+For the theoretical foundations, see [<a href="doc-bibliography.html#%28cite._.Greenberg15%29" data-pltdoc="x">Greenberg15</a>].</p><p><span style="font-weight: bold">Warning</span>: the features described in this section are experimental
+and may not be sufficient to implement new collapsible contracts. Implementing
+new collapsible contracts requires the use of unsafe chaperones and impersonators
+which are only supported for vector and procedure values. This documentation exists
+primarily to allow future maintenance of the <span class="RktSym">racket/contract/collapsible</span>
+library. <span style="font-weight: bold">End Warning</span></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._get/build-collapsible-late-neg-projection))"></a><span title="Provided from: racket/contract/collapsible, racket/contract, racket | Package: base"><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._get%2Fbuild-collapsible-late-neg-projection%29%29" class="RktValDef RktValLink" data-pltdoc="x">get/build-collapsible-late-neg-projection</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract~3f%29%29" class="RktValLink" data-pltdoc="x">collapsible-contract?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <span class="RktVar">collapsible-late-neg</span> projection for <span class="RktVar">c</span>.</div></p><p>If <span class="RktVar">c</span> does not have a <span class="RktVar">collapsible-late-neg</span> projection,
+then this function uses the original projection for it and constructs a leaf
+as its collapsible representation.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/contract/private/guts..rkt)._collapsible-contract-continuation-mark-key))"></a><span title="Provided from: racket/contract/collapsible, racket/contract, racket | Package: base"><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._collapsible-contract-continuation-mark-key%29%29" class="RktValDef RktValLink" data-pltdoc="x">collapsible-contract-continuation-mark-key</a></span></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-key~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-key?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Key used by continuation marks that are present during collapsible contract checking.
+The value of these marks are <span class="RktVal">#t</span> if the current contract is collapsible.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/private/guts..rkt)._with-collapsible-contract-continuation-mark))"></a><span title="Provided from: racket/contract/collapsible, racket/contract, racket | Package: base"><span class="RktSym"><a href="collapsible.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._with-collapsible-contract-continuation-mark%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">with-collapsible-contract-continuation-mark</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Inserts a continuation mark that informs the contract profiler that the current contract
+is collapsible.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/contract/collapsible..rkt)._prop~3acollapsible-contract))"></a><span title="Provided from: racket/contract/collapsible, racket/contract, racket | Package: base"><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._prop~3acollapsible-contract%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:collapsible-contract</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Structures implementing this property are usable as collapsible contracts. The value
+associated with this property should be constructed by calling
+<span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._build-collapsible-contract-property%29%29" class="RktValLink" data-pltdoc="x">build-collapsible-contract-property</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-contract~3f))"></a><span title="Provided from: racket/contract/collapsible, racket/contract, racket | Package: base"><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">collapsible-contract?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A predicate recognizing structures with the <span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._prop~3acollapsible-contract%29%29" class="RktValLink" data-pltdoc="x">prop:collapsible-contract</a></span> property.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/collapsible..rkt)._merge))"></a><span title="Provided from: racket/contract/collapsible, racket/contract, racket | Package: base"><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._merge%29%29" class="RktValDef RktValLink" data-pltdoc="x">merge</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">new-cc</span><span class="hspace">&nbsp;</span><span class="RktVar">new-neg</span><span class="hspace">&nbsp;</span><span class="RktVar">old-cc</span><span class="hspace">&nbsp;</span><span class="RktVar">old-neg</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract~3f%29%29" class="RktValLink" data-pltdoc="x">collapsible-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">new-cc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract~3f%29%29" class="RktValLink" data-pltdoc="x">collapsible-contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">new-neg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">old-cc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract~3f%29%29" class="RktValLink" data-pltdoc="x">collapsible-contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">old-neg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Combine two collapsible contracts into a single collapsible contract.
+The <span class="RktVar">new-neg</span> and <span class="RktVar">old-neg</span> arguments are expected to be
+blame parties similar to those passed to a <a href="Building_New_Contract_Combinators.html#%28tech._late._neg._projection%29" class="techoutside" data-pltdoc="x"><span class="techinside">late neg projection</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-guard))"></a><span title="Provided from: racket/contract/collapsible, racket/contract, racket | Package: base"><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-guard%29%29" class="RktValDef RktValLink" data-pltdoc="x">collapsible-guard</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">cc</span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span><span class="RktVar">neg-party</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract~3f%29%29" class="RktValLink" data-pltdoc="x">collapsible-contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">neg-party</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to a <a href="Building_New_Contract_Combinators.html#%28tech._late._neg._projection%29" class="techoutside" data-pltdoc="x"><span class="techinside">late neg projection</span></a>, this function guards the value <span class="RktVar">val</span>
+with the collapsible contract <span class="RktVar">cc</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-contract-property~3f))"></a><span title="Provided from: racket/contract/collapsible, racket/contract, racket | Package: base"><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract-property~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">collapsible-contract-property?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">This predicate indicates that a value can be used as the property for
+<span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._prop~3acollapsible-contract%29%29" class="RktValLink" data-pltdoc="x">prop:collapsible-contract</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top" colspan="3"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/collapsible..rkt)._build-collapsible-contract-property))"></a><span title="Provided from: racket/contract/collapsible, racket/contract, racket | Package: base"><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._build-collapsible-contract-property%29%29" class="RktValDef RktValLink" data-pltdoc="x">build-collapsible-contract-property</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:try-merge</span><span class="hspace">&nbsp;</span><span class="RktVar">try-merge</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:collapsible-guard</span><span class="hspace">&nbsp;</span><span class="RktVar">collapsible-guard</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract-property~3f%29%29" class="RktValLink" data-pltdoc="x">collapsible-contract-property?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">try-merge</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract~3f%29%29" class="RktValLink" data-pltdoc="x">collapsible-contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract~3f%29%29" class="RktValLink" data-pltdoc="x">collapsible-contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract~3f%29%29" class="RktValLink" data-pltdoc="x">collapsible-contract?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">collapsible-guard</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract~3f%29%29" class="RktValLink" data-pltdoc="x">collapsible-contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">cc</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktSym">neg</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"internal error: contract does not support `collapsible-guard`"</span><span class="hspace">&nbsp;</span><span class="RktSym">cc</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Constructs a <a name="(tech._collapsible._contract._property)"></a><span style="font-style: italic">collapsible contract property</span> from a merging function and a guard.
+The <span class="RktVar">try-merge</span> argument is similar to <span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._merge%29%29" class="RktValLink" data-pltdoc="x">merge</a></span>, but may return <span class="RktVal">#f</span> instead
+of a collapsible contract and may be specialized to a particular collapsible contract.
+The <span class="RktVar">collapsible-guard</span> argument should be specialized to the particular collapsible
+contract being implemented.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="stt"> </span><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-ho/c-latest-ctc))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-ho/c-missing-party))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-ho/c-latest-blame))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-ho/c~3f))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._struct~3acollapsible-ho/c))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-ho/c))"></a><span title="Provided from: racket/contract/collapsible, racket/contract, racket | Package: base"><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-ho%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">collapsible-ho/c</a></span></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">latest-blame</span><span class="stt"> </span><span class="RktSym">missing-party</span><span class="stt"> </span><span class="RktSym">latest-ctc</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">latest-blame</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">missing-party</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">latest-ctc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A common parent structure for collapsible contracts for higher-order values.
+The <span class="RktSym">latest-blame</span> field holds the blame object for the most recent
+contract attached. Similarly, the <span class="RktSym">missing-party</span> field holds the latest
+missing party passed to the contract. The <span class="RktSym">latest-contract</span> field stores
+the most recent contract attached to the value.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="nobreak"><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-leaf/c-missing-party-list))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-leaf/c-blame-list))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-leaf/c-contract-list))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-leaf/c-proj-list))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-leaf/c~3f))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._struct~3acollapsible-leaf/c))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-leaf/c))"></a><span title="Provided from: racket/contract/collapsible, racket/contract, racket | Package: base"><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-leaf%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">collapsible-leaf/c</a></span></span></span></td><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span></td><td><span class="nobreak"><span class="RktSym">proj-list</span></span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym">contract-list</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym">blame-list</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym">missing-party-list</span><span class="RktPn">))</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">proj-list</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">contract-list</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">blame-list</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">missing-party-list</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A structure representing the leaf nodes of a collapsible contract. The <span class="RktSym">proj-list</span>
+field holds a list of partially applied <a href="Building_New_Contract_Combinators.html#%28tech._late._neg._projection%29" class="techoutside" data-pltdoc="x"><span class="techinside">late neg projections</span></a>. The <span class="RktSym">contract-list</span>,
+<span class="RktSym">blame-list</span>, and <span class="RktSym">missing-party-list</span> fields hold a list of contracts,
+blame objects, and blame missing parties respectively.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/contract/collapsible..rkt)._impersonator-prop~3acollapsible))"></a><span title="Provided from: racket/contract/collapsible, racket/contract, racket | Package: base"><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._impersonator-prop~3acollapsible%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonator-prop:collapsible</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/collapsible..rkt)._has-impersonator-prop~3acollapsible~3f))"></a><span title="Provided from: racket/contract/collapsible, racket/contract, racket | Package: base"><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._has-impersonator-prop~3acollapsible~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">has-impersonator-prop:collapsible?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/collapsible..rkt)._get-impersonator-prop~3acollapsible))"></a><span title="Provided from: racket/contract/collapsible, racket/contract, racket | Package: base"><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._get-impersonator-prop~3acollapsible%29%29" class="RktValDef RktValLink" data-pltdoc="x">get-impersonator-prop:collapsible</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-property~3f%29%29" class="RktValLink" data-pltdoc="x">collapsible-property?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">An impersonator property (and its accessors) that should be attached to chaperoned or impersonated
+values that are guarded with a collapsible contract.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="stt"> </span><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-property-ref))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-property-neg-party))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-property-c-c))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-property~3f))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._struct~3acollapsible-property))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-property))"></a><span title="Provided from: racket/contract/collapsible, racket/contract, racket | Package: base"><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-property%29%29" class="RktValDef RktValLink" data-pltdoc="x">collapsible-property</a></span></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">c-c</span><span class="stt"> </span><span class="RktSym">neg-party</span><span class="stt"> </span><span class="RktSym">ref</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">c-c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract~3f%29%29" class="RktValLink" data-pltdoc="x">collapsible-contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">neg-party</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">ref</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">The parent struct of properties that should be attached to chaperones or impersonators
+of values protected with a collapsible contract. The <span class="RktSym">c-c</span> field stores the collapsible
+contract that is or will in the future be attached to the the value. The <span class="RktSym">neg-party</span> field
+stores the latest missing blame party passed to the contract on the value. The <span class="RktSym">ref</span> field
+is mutable and stores a reference to the chaperone or impersonator to which this property is
+attached. This is necessary to determine whether an unknown chaperone has been attached to a value
+after it has been protected by a collapsible contract.
+</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="nobreak"><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-count-property-prev))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-count-property-count))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-count-property~3f))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._struct~3acollapsible-count-property))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-count-property))"></a><span title="Provided from: racket/contract/collapsible, racket/contract, racket | Package: base"><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-count-property%29%29" class="RktValDef RktValLink" data-pltdoc="x">collapsible-count-property</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-property%29%29" class="RktValLink" data-pltdoc="x">collapsible-property</a></span></span></td><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span></td><td><span class="nobreak"><span class="RktSym">count</span></span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym">prev</span><span class="RktPn">))</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">count</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._natural-number%2Fc%29%29" class="RktValLink" data-pltdoc="x">natural-number/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">prev</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-count-property~3f%29%29" class="RktValLink" data-pltdoc="x">collapsible-count-property?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">This property is associated with the <span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._impersonator-prop~3acollapsible%29%29" class="RktValLink" data-pltdoc="x">impersonator-prop:collapsible</a></span> property before
+the value completely enters the collapsible mode. These properties keep track of the number of
+contracts on a value in the <span class="RktVar">count</span> field, and hold a reference to the previous
+<a name="(tech._count._property)"></a><span style="font-style: italic">count property</span> in the <span class="RktSym">prev</span> field or the original value without a contract. This
+allows the contract system to traverse the chain of attached contracts and merge them into a single
+collapsible contract to protect the original value.
+</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="nobreak"><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-wrapper-property-checking-wrapper))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-wrapper-property~3f))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._struct~3acollapsible-wrapper-property))"></a><a name="(def._((lib._racket/contract/collapsible..rkt)._collapsible-wrapper-property))"></a><span title="Provided from: racket/contract/collapsible, racket/contract, racket | Package: base"><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-wrapper-property%29%29" class="RktValDef RktValLink" data-pltdoc="x">collapsible-wrapper-property</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-property%29%29" class="RktValLink" data-pltdoc="x">collapsible-property</a></span></span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktPn">(</span><span class="nobreak"><span class="RktSym">checking-wrapper</span><span class="RktPn">)</span></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">checking-wrapper</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">This property is used when a value is guarded by a collapsible contract. The
+<span class="RktSym">checking-wrapper</span> field holds a chaperone or impersonator that dispatches to the
+collapsible contract stored in this property to perform any necessary contract checks. When
+the value receives another contract and merging happens, the checking wrapper will remain the
+same even though the specific collapsible contract attached to the value may change.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="racket_contract_base.html" title="backward to &quot;8.9 racket/contract/base&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Legacy_Contracts.html" title="forward to &quot;8.11 Legacy Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/collects.html b/clones/docs.racket-lang.org/reference/collects.html
new file mode 100644
index 00000000..e5a59b54
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/collects.html
@@ -0,0 +1,205 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>18.2&nbsp;Libraries and Collections</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewselflink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">18.1&nbsp;</td><td><a href="running-sa.html" class="tocviewlink" data-pltdoc="x">Running Racket or GRacket</a></td></tr><tr><td align="right">18.2&nbsp;</td><td><a href="collects.html" class="tocviewselflink" data-pltdoc="x">Libraries and Collections</a></td></tr><tr><td align="right">18.3&nbsp;</td><td><a href="Interactive_Help.html" class="tocviewlink" data-pltdoc="x">Interactive Help</a></td></tr><tr><td align="right">18.4&nbsp;</td><td><a href="interaction-info.html" class="tocviewlink" data-pltdoc="x">Interaction Configuration</a></td></tr><tr><td align="right">18.5&nbsp;</td><td><a href="interactive.html" class="tocviewlink" data-pltdoc="x">Interactive Module Loading</a></td></tr><tr><td align="right">18.6&nbsp;</td><td><a href="debugging.html" class="tocviewlink" data-pltdoc="x">Debugging</a></td></tr><tr><td align="right">18.7&nbsp;</td><td><a href="compiler.html" class="tocviewlink" data-pltdoc="x">Controlling and Inspecting Compilation</a></td></tr><tr><td align="right">18.8&nbsp;</td><td><a href="Kernel_Forms_and_Functions.html" class="tocviewlink" data-pltdoc="x">Kernel Forms and Functions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>18.2&nbsp;</td><td><a href="collects.html" class="tocviewselflink" data-pltdoc="x">Libraries and Collections</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">18.2.1&nbsp;</td><td><a href="collects.html#%28part._collects-search%29" class="tocviewlink" data-pltdoc="x">Collection Search Configuration</a></td></tr><tr><td align="right">18.2.2&nbsp;</td><td><a href="collects.html#%28part._links-file%29" class="tocviewlink" data-pltdoc="x">Collection Links</a></td></tr><tr><td align="right">18.2.3&nbsp;</td><td><a href="collects.html#%28part._collects-api%29" class="tocviewlink" data-pltdoc="x">Collection Paths and Parameters</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">18.2.1<tt>&nbsp;</tt></span><a href="collects.html#%28part._collects-search%29" class="tocsubseclink" data-pltdoc="x">Collection Search Configuration</a></td></tr><tr><td><span class="tocsublinknumber">18.2.2<tt>&nbsp;</tt></span><a href="collects.html#%28part._links-file%29" class="tocsubseclink" data-pltdoc="x">Collection Links</a></td></tr><tr><td><span class="tocsublinknumber">18.2.3<tt>&nbsp;</tt></span><a href="collects.html#%28part._collects-api%29" class="tocsubseclink" data-pltdoc="x">Collection Paths and Parameters</a></td></tr><tr><td><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._find-library-collection-paths%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">find-<wbr></wbr>library-<wbr></wbr>collection-<wbr></wbr>paths</span></span></a></td></tr><tr><td><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._find-library-collection-links%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">find-<wbr></wbr>library-<wbr></wbr>collection-<wbr></wbr>links</span></span></a></td></tr><tr><td><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-file-path%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collection-<wbr></wbr>file-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-path%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collection-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>library-<wbr></wbr>collection-<wbr></wbr>paths</span></span></a></td></tr><tr><td><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-links%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>library-<wbr></wbr>collection-<wbr></wbr>links</span></span></a></td></tr><tr><td><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._use-user-specific-search-paths%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">use-<wbr></wbr>user-<wbr></wbr>specific-<wbr></wbr>search-<wbr></wbr>paths</span></span></a></td></tr><tr><td><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._use-collection-link-paths%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">use-<wbr></wbr>collection-<wbr></wbr>link-<wbr></wbr>paths</span></span></a></td></tr><tr><td><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._read-installation-configuration-table%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>installation-<wbr></wbr>configuration-<wbr></wbr>table</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="running-sa.html" title="backward to &quot;18.1 Running Racket or GRacket&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;18 Running Racket&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Interactive_Help.html" title="forward to &quot;18.3 Interactive Help&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;collects&quot;">18.2<tt>&nbsp;</tt><a name="(part._collects)"></a>Libraries and Collections</h4><p>A <a name="(tech._library)"></a><span style="font-style: italic">library</span> is <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> declaration for use by multiple
+programs. Racket further groups libraries into <a name="(tech._collection)"></a><span style="font-style: italic">collections</span>.
+Typically, collections are added via <a name="(tech._package)"></a><span style="font-style: italic">packages</span> (see
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=pkg&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">Package Management in Racket</a>); the package manager
+works outside of the Racket core, but it configures the core run-time
+system through <a href="collects.html#%28tech._collection._links._file%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection links files</span></a>.</p><p>Libraries in collections are referenced through <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span> paths
+(see <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>) or symbolic shorthands. For example, the
+following module uses the <span class="stt">"getinfo.rkt"</span> library module from
+the <span class="stt">"setup"</span> collection, and the <span class="stt">"cards.rkt"</span> library
+module from the <span class="stt">"games"</span> collection&rsquo;s <span class="stt">"cards"</span>
+subcollection:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"setup/getinfo.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"games/cards/cards.rkt"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktSym">....</span></td></tr></table></blockquote><p>This example is more compactly and more commonly written using
+symbolic shorthands:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">setup/getinfo</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">games/cards/cards</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktSym">....</span></td></tr></table></blockquote><p>When an identifier <span class="RktVar">id</span> is used in a <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> form, it
+is converted to <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span><span class="stt"> </span><span class="RktVar">rel-string</span><span class="RktPn">)</span> where <span class="RktVar">rel-string</span>
+is the string form of <span class="RktVar">id</span>.</p><p>A <span class="RktVar">rel-string</span> in <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span><span class="stt"> </span><span class="RktVar">rel-string</span><span class="RktPn">)</span> consists of one
+or more path elements that name collections, and then a final path
+element that names a library file; the path elements are separated by
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>. If <span class="RktVar">rel-string</span> contains no <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>s, then
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">/main.rkt</span><span class="hspace"></span></span> is implicitly appended to the path. If
+<span class="RktVar">rel-string</span> contains <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> but does not end with a file
+suffix, then <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.rkt</span><span class="hspace"></span></span> is implicitly appended to the path.</p><p>Libraries also can be distributed via <span class="planetName">PLaneT</span> packages. Such
+libraries are referenced through a <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._planet%29%29" class="RktStxLink" data-pltdoc="x">planet</a></span> module path (see
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>) and are downloaded by Racket on demand, instead of
+referenced through <a href="collects.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collections</span></a>.</p><p>The translation of a <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._planet%29%29" class="RktStxLink" data-pltdoc="x">planet</a></span> or <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span> path to a
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> declaration is determined by the <a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name
+resolver</span></a>, as specified by the <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-name-resolver%29%29" class="RktValLink" data-pltdoc="x">current-module-name-resolver</a></span>
+parameter.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;collects-search&quot;">18.2.1<tt>&nbsp;</tt><a name="(part._collects-search)"></a>Collection Search Configuration</h5><p>For the default <a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name resolver</span></a>, the search path for
+collections is determined by the
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-links%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-links</a></span> parameter and the
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-paths</a></span> parameter:</p><ul><li><p>The most primitive <a href="collects.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection</span></a>-based modules are located
+in <span class="stt">"collects"</span> directory relative to the Racket
+executable. Libraries for a collection are grouped within a
+directory whose name matches the collection name. The path to
+the <span class="stt">"collects"</span> directory is normally included in
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-paths</a></span>.</p></li><li><p>Collection-based libraries also can be installed other
+directories, perhaps user-specific, that are structured like
+the <span class="stt">"collects"</span> directory. Those additional directories
+can be included in the
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-paths</a></span> parameter either
+dynamically, through command-line arguments to <span class="stt">racket</span>,
+or by setting the <span class="stt">PLTCOLLECTS</span> environment variable;
+see <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._find-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">find-library-collection-paths</a></span>.</p></li><li><p><a href="collects.html#%28tech._collection._links._file%29" class="techoutside" data-pltdoc="x"><span class="techinside">Collection links files</span></a> provide a mapping from top-level
+collection names to directories, plus additional
+<span class="stt">"collects"</span>-like directories (that have subdirectories
+with names that match collection names). Each <a href="collects.html#%28tech._collection._links._file%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection
+links file</span></a> to be searched is referenced by the
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-links%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-links</a></span> parameter; the parameter
+references the file, and not the file&rsquo;s content, so
+that changes to the file can be detected and affect later
+module resolution. See also
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._find-library-collection-links%29%29" class="RktValLink" data-pltdoc="x">find-library-collection-links</a></span>.</p></li><li><p>The <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-links%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-links</a></span> parameter&rsquo;s value
+can also include hash tables that provide the same content as
+<a href="collects.html#%28tech._collection._links._file%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection links files</span></a>: a mapping from collection names
+in symbol form to a list of paths for the collection, or from
+<span class="RktVal">#f</span> to a list of <span class="stt">"collects"</span>-like paths.</p></li><li><p>Finally, the <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-links%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-links</a></span>
+parameter&rsquo;s value includes <span class="RktVal">#f</span> to indicate the point in
+the search process at which the <a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module-name resolver</span></a> should
+check <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-paths</a></span> relative to the
+files and hash tables in <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-links%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-links</a></span>.</p></li></ul><p>To resolve a module reference <span class="RktVar">rel-string</span>, the default
+<a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name resolver</span></a> searches collection links in
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-links%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-links</a></span> from first to last to locate
+the first directory that contains <span class="RktVar">rel-string</span>, splicing a
+search through in <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-paths</a></span> where in
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-links%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-links</a></span> contains <span class="RktVal">#f</span>.  The
+filesystem tree for each element in the link table and search path is
+effectively <a name="(tech._collection._splicing)"></a><span style="font-style: italic">spliced</span> together with the filesystem trees of other path
+elements that correspond to the same collection. Some Racket tools
+rely on unique resolution of module path names, so an installation and
+configuration should not allow multiple files to match the same
+collection and file combination.</p><p>The value of the <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-links%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-links</a></span> parameter
+is initialized by the <span class="stt">racket</span> executable to the result of
+<span class="RktPn">(</span><span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._find-library-collection-links%29%29" class="RktValLink" data-pltdoc="x">find-library-collection-links</a></span><span class="RktPn">)</span>, and the value of the
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-paths</a></span> parameter is initialized to
+the result of <span class="RktPn">(</span><span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._find-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">find-library-collection-paths</a></span><span class="RktPn">)</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;links-file&quot;">18.2.2<tt>&nbsp;</tt><a name="(part._links-file)"></a>Collection Links</h5><p><a name="(tech._collection._links._file)"></a><span style="font-style: italic">Collection links files</span> are used by
+<span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-file-path%29%29" class="RktValLink" data-pltdoc="x">collection-file-path</a></span>, <span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-path%29%29" class="RktValLink" data-pltdoc="x">collection-path</a></span>, and the
+default <a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name resolver</span></a> to locate collections before
+trying the <span class="RktPn">(</span><span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-paths</a></span><span class="RktPn">)</span> search
+path. The <a href="collects.html#%28tech._collection._links._file%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection links files</span></a> to use are determined by the
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-links%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-links</a></span> parameter, which is
+initialized to the result of <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._find-library-collection-links%29%29" class="RktValLink" data-pltdoc="x">find-library-collection-links</a></span>.</p><p>A <a href="collects.html#%28tech._collection._links._file%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection links file</span></a> is <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> with default reader
+parameter settings to obtain a list. Every element of the list must be
+a link specification with one of the forms <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVar">string</span><span class="stt"> </span><span class="RktVar">encoded-path</span><span class="RktPn">)</span>, <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVar">string</span><span class="stt"> </span><span class="RktVar">encoded-path</span><span class="stt"> </span><span class="RktVar">regexp</span><span class="RktPn">)</span>, <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">root</span><span class="stt"> </span><span class="RktVar">encoded-path</span><span class="RktPn">)</span>, <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">root</span><span class="stt"> </span><span class="RktVar">encoded-path</span><span class="stt"> </span><span class="RktVar">regexp</span><span class="RktPn">)</span>, <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">static-root</span><span class="stt"> </span><span class="RktVar">encoded-path</span><span class="RktPn">)</span>, <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">static-root</span><span class="stt"> </span><span class="RktVar">encoded-path</span><span class="stt"> </span><span class="RktVar">regexp</span><span class="RktPn">)</span>.
+A <span class="RktVar">string</span> names a
+top-level <a href="collects.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection</span></a>, in which case <span class="RktVar">encoded-path</span> describes a path
+that can be used as the collection&rsquo;s path (directly, as opposed to a
+subdirectory of <span class="RktVar">encoded-path</span> named by <span class="RktVar">string</span>). A
+<span class="RktVal">'</span><span class="RktVal">root</span> entry, in contrast, acts like an path in
+<span class="RktPn">(</span><span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-paths</a></span><span class="RktPn">)</span>.  A
+<span class="RktVal">'</span><span class="RktVal">static-root</span> entry is like a <span class="RktVal">'</span><span class="RktVal">root</span> entry, but
+where the immediate content of the directory is assumed not to change unless the
+<a href="collects.html#%28tech._collection._links._file%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection links file</span></a> changes.
+Each <span class="RktVar">encoded-path</span> is either a string, a
+byte string that is converted to a path with <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;path</a></span>,
+or a list of relative path-element byte strings, <span class="RktVal">'</span><span class="RktVal">up</span>, and <span class="RktVal">'</span><span class="RktVal">same</span>
+indicators that are combined with <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span> with the byte
+strings converted with <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath-element%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;path-element</a></span>.
+If <span class="RktVar">encoded-path</span> describes a
+relative path, it is relative to the directory containing the
+<a href="collects.html#%28tech._collection._links._file%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection links file</span></a>. If <span class="RktVar">regexp</span> is specified in a
+link, then the link is used only if <span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match~3f%29%29" class="RktValLink" data-pltdoc="x">regexp-match?</a></span><span class="stt"> </span><span class="RktVar">regexp</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._version%29%29" class="RktValLink" data-pltdoc="x">version</a></span><span class="RktPn">)</span><span class="RktPn">)</span> produces a true result.</p><p>A single top-level collection can have multiple links in a
+<a href="collects.html#%28tech._collection._links._file%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection links file</span></a>, and any number of <span class="RktVal">'</span><span class="RktVal">root</span> entries
+can appear. The corresponding paths are effectively spliced together,
+since the paths are tried in order to locate a file or sub-collection.</p><p>The <span class="stt">raco link</span> command-link tool can display, install, and
+remove links in a <a href="collects.html#%28tech._collection._links._file%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection links file</span></a>. See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=link.html&amp;version=8.6" class="Sq" data-pltdoc="x"><span class="stt">raco link</span>: Library Collection Links</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x"><span class="stt">raco</span>: Racket Command-Line Tools</a> for more information.</p><p class="SHistory">Changed in version 8.1.0.6 of package <span class="stt">base</span>: Changed <span class="RktVar">encoded-path</span> to
+allow bytes strings and lists.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;collects-api&quot;">18.2.3<tt>&nbsp;</tt><a name="(part._collects-api)"></a>Collection Paths and Parameters</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._find-library-collection-paths))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._find-library-collection-paths%29%29" class="RktValDef RktValLink" data-pltdoc="x">find-library-collection-paths</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">pre-extras</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">post-extras</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">config</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pre-extras</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">post-extras</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">config</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._read-installation-configuration-table%29%29" class="RktValLink" data-pltdoc="x">read-installation-configuration-table</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=dirs.html%23%2528def._%2528%2528lib._setup%252Fdirs..rkt%2529._get-installation-name%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">get-installation-name</a></span><span class="hspace">&nbsp;</span><span class="RktVar">config</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a list of paths, which is normally used to initialize
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-paths</a></span>, as follows:</div></p><ul><li><p>The path produced by <span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">addon-dir</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">name</span><span class="stt"> </span><span class="RktVal">"collects"</span><span class="RktPn">)</span> is the first element of the
+default collection path list, unless the value of the
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._use-user-specific-search-paths%29%29" class="RktValLink" data-pltdoc="x">use-user-specific-search-paths</a></span> parameter is <span class="RktVal">#f</span>.</p></li><li><p>Extra directories provided in <span class="RktVar">pre-extras</span> are included
+next to the default collection path list, converted to complete
+paths relative to the executable.</p></li><li><p>If the directory specified by <span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">collects-dir</span><span class="RktPn">)</span> is absolute, or if it is relative (to the
+executable) and it exists, then it is added to the end of the
+default collection path list.</p></li><li><p>Extra directories provided in <span class="RktVar">post-extras</span> are included
+last in the default collection path list, converted to complete
+paths relative to the executable.</p></li><li><p>If <span class="RktVar">config</span> has a value for
+<span class="RktVal">'</span><span class="RktVal">collects-search-dirs</span>, then it is used in place of the
+default collection path list (as constructed by the preceding three
+bullets), and the default is spliced in place of any <span class="RktVal">#f</span>
+within the <span class="RktVal">'</span><span class="RktVal">collects-search-dirs</span> list. If <span class="RktVar">config</span>
+does not have a <span class="RktVal">'</span><span class="RktVal">collects-search-dirs</span> value, then the
+default collection path list is used.</p></li><li><p>If the <a name="(idx._(gentag._562._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLTCOLLECTS</span> environment variable is
+defined, it is combined with the default list using
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-list-string-~3epath-list%29%29" class="RktValLink" data-pltdoc="x">path-list-string-&gt;path-list</a></span>, as long as the value of
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._use-user-specific-search-paths%29%29" class="RktValLink" data-pltdoc="x">use-user-specific-search-paths</a></span> is true. If it is not
+defined or if the value <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._use-user-specific-search-paths%29%29" class="RktValLink" data-pltdoc="x">use-user-specific-search-paths</a></span> is
+<span class="RktVal">#f</span>, the collection path list as constructed by the
+preceding four bullets is used directly.</p><p>Note that on Unix and Mac OS, paths are separated by <span class="RktInBG"><span class="hspace"></span><span class="RktIn">:</span><span class="hspace"></span></span>, and
+on Windows by <span class="RktInBG"><span class="hspace"></span><span class="RktIn">;</span><span class="hspace"></span></span>.  Also,
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-list-string-~3epath-list%29%29" class="RktValLink" data-pltdoc="x">path-list-string-&gt;path-list</a></span> splices the default paths at an
+empty path, for example, with many Unix shells you can set
+<span class="stt">PLTCOLLECTS</span> to <span class="stt">":</span><span class="stt">&lsquo;</span><span class="stt">pwd</span><span class="stt">&lsquo;</span><span class="stt">"</span>, <span class="stt">"</span><span class="stt">&lsquo;</span><span class="stt">pwd</span><span class="stt">&lsquo;</span><span class="stt">:"</span>, or
+<span class="stt">"</span><span class="stt">&lsquo;</span><span class="stt">pwd</span><span class="stt">&lsquo;</span><span class="stt">"</span> to specify search the current directory after, before,
+or instead of the default paths, respectively.</p></li></ul><p class="SHistory">Changed in version 8.4.0.3 of package <span class="stt">base</span>: Added the <span class="RktVar">config</span> and
+<span class="RktVar">name</span> arguments.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._find-library-collection-links))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._find-library-collection-links%29%29" class="RktValDef RktValLink" data-pltdoc="x">find-library-collection-links</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">config</span><span class="RktOpt">]</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">config</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._read-installation-configuration-table%29%29" class="RktValLink" data-pltdoc="x">read-installation-configuration-table</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=dirs.html%23%2528def._%2528%2528lib._setup%252Fdirs..rkt%2529._get-installation-name%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">get-installation-name</a></span><span class="hspace">&nbsp;</span><span class="RktVar">config</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a list of paths and <span class="RktVal">#f</span>, which is normally used to
+initialize <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-links%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-links</a></span>, as follows:</div></p><ul><li><p>The list starts with <span class="RktVal">#f</span>, which causes the default
+<a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name resolver</span></a>, <span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-file-path%29%29" class="RktValLink" data-pltdoc="x">collection-file-path</a></span>,
+and <span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-path%29%29" class="RktValLink" data-pltdoc="x">collection-path</a></span> to try paths in
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-paths</a></span> before
+<a href="collects.html#%28tech._collection._links._file%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection links files</span></a>.</p></li><li><p>As long as the values of
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._use-user-specific-search-paths%29%29" class="RktValLink" data-pltdoc="x">use-user-specific-search-paths</a></span> and
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._use-collection-link-paths%29%29" class="RktValLink" data-pltdoc="x">use-collection-link-paths</a></span> are true, the second element
+in the result list is the path of the user&ndash;specific
+<a href="collects.html#%28tech._collection._links._file%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection links file</span></a>, which is <span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">addon-dir</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">name</span><span class="stt"> </span><span class="RktVal">"links.rktd"</span><span class="RktPn">)</span> by default,
+but it can be replaced by a <span class="RktVal">'</span><span class="RktVal">links-file</span> value in
+<span class="RktVar">config</span>.</p></li><li><p>As long as the value of <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._use-collection-link-paths%29%29" class="RktValLink" data-pltdoc="x">use-collection-link-paths</a></span> is
+true, the rest of the list contains a result like that of
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=dirs.html%23%2528def._%2528%2528lib._setup%252Fdirs..rkt%2529._get-links-search-files%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">get-links-search-files</a></span>, but using <span class="RktVar">config</span> if
+supplied instead of reading the installation&rsquo;s
+<span class="stt">"config.rktd"</span> file. Typically, that result is a list
+with a single path, <span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=dirs.html%23%2528def._%2528%2528lib._setup%252Fdirs..rkt%2529._find-config-dir%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">find-config-dir</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">"links.rktd"</span><span class="RktPn">)</span>.</p></li></ul><p class="SHistory">Changed in version 8.4.0.3 of package <span class="stt">base</span>: Added the <span class="RktVar">config</span> and
+<span class="RktVar">name</span> arguments.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._collection-file-path))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-file-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">collection-file-path</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">file</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">collection</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:check-compiled?</span><span class="hspace">&nbsp;</span><span class="RktVar">check-compiled?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">file</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">collection</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">check-compiled?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match~3f%29%29" class="RktValLink" data-pltdoc="x">regexp-match?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"[.]rkt$"</span><span class="hspace">&nbsp;</span><span class="RktVar">file</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-file-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">collection-file-path</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">file</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">collection</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:fail</span><span class="hspace">&nbsp;</span><span class="RktVar">fail-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:check-compiled?</span><span class="hspace">&nbsp;</span><span class="RktVar">check-compiled?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">file</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">collection</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fail-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">check-compiled?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match~3f%29%29" class="RktValLink" data-pltdoc="x">regexp-match?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"[.]rkt$"</span><span class="hspace">&nbsp;</span><span class="RktVar">file</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the path to the file indicated by <span class="RktVar">file</span> in the
+collection specified by the <span class="RktVar">collection</span>s, where the second
+<span class="RktVar">collection</span> (if any) names a sub-collection, and so on.  The
+search uses the values of <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-links%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-links</a></span>
+and <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-paths</a></span>.</div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See also <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=collection-search.html%23%2528def._%2528%2528lib._setup%252Fcollection-search..rkt%2529._collection-search%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">collection-search</a></span> in
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=collection-search.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">setup/collection-search</span></a>.</p></blockquote></blockquote></blockquote><p>If <span class="RktVar">file</span> is not found, but <span class="RktVar">file</span> ends in
+<span class="stt">".rkt"</span> and a file with the suffix <span class="stt">".ss"</span> exists, then
+the directory of the <span class="stt">".ss"</span> file is used. If <span class="RktVar">file</span> is
+not found and the <span class="stt">".rkt"</span>/<span class="stt">".ss"</span> conversion does not
+apply, but a directory corresponding to the <span class="RktVar">collection</span>s is
+found, then a path using the first such directory is
+returned.</p><p>If <span class="RktVar">check-compiled?</span> is true, then the search also depends on
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._use-compiled-file-paths%29%29" class="RktValLink" data-pltdoc="x">use-compiled-file-paths</a></span> and
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compiled-file-roots%29%29" class="RktValLink" data-pltdoc="x">current-compiled-file-roots</a></span>; if <span class="RktVar">file</span> is not found,
+then a compiled form of <span class="RktVar">file</span> with the suffix <span class="stt">".zo"</span>
+is checked in the same way as the default <a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load
+handler</span></a>.  If a compiled file is found, the result from
+<span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-file-path%29%29" class="RktValLink" data-pltdoc="x">collection-file-path</a></span> reports the location that <span class="RktVar">file</span>
+itself would occupy (if it existed) for the found compiled file.</p><p>Finally, if the collection is not found, and if <span class="RktVar">fail-proc</span> is
+provided, then <span class="RktVar">fail-proc</span> is applied to an error message (that
+does not start <span class="RktVal">"collection-file-path:"</span> or otherwise claim a
+source), and its result is the result of
+<span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-file-path%29%29" class="RktValLink" data-pltdoc="x">collection-file-path</a></span>.  If <span class="RktVar">fail-proc</span> is not provided
+and the collection is not found, then the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> exception is raised.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-file-path%29%29" class="RktValLink" data-pltdoc="x">collection-file-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"main.rkt"</span><span class="hspace">&nbsp;</span><span class="RktVal">"racket"</span><span class="hspace">&nbsp;</span><span class="RktVal">"base"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;path:path/to/collects/racket/base/main.rkt&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-file-path%29%29" class="RktValLink" data-pltdoc="x">collection-file-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"sandwich.rkt"</span><span class="hspace">&nbsp;</span><span class="RktVal">"bologna"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">collection-file-path: collection not found</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">collection: "bologna"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in collection directories:</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">/home/scheme/pltbuild/racket/racket/collects/</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">... [245 additional linked and package directories]</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.0.1.12 of package <span class="stt">base</span>: Added the <span class="RktVar">check-compiled?</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._collection-path))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">collection-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">collection</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">collection</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">collection-path</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">collection</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...+</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:fail</span><span class="hspace">&nbsp;</span><span class="RktVar">fail-proc</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">collection</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fail-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote><p><span style="background-color: yellow"><span style="font-weight: bold">NOTE:</span></span> This function is deprecated; use <span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-file-path%29%29" class="RktValLink" data-pltdoc="x">collection-file-path</a></span>, instead. <a href="collects.html#%28tech._collection._splicing%29" class="techoutside" data-pltdoc="x"><span class="techinside">Collection splicing</span></a> implies that a given collection can have
+multiple paths, such as when multiple <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=module-basics.html%23%2528tech._package%2529&amp;version=8.6" class="techoutside Sq" data-pltdoc="x"><span class="techinside">packages</span></a> provide modules for a
+collection.</p></blockquote></div></p><p>Like <span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-file-path%29%29" class="RktValLink" data-pltdoc="x">collection-file-path</a></span>, but without a specified file name,
+so that a directory indicated by <span class="RktVar">collection</span>s is returned.</p><p>When multiple directories correspond to the collection, the first one
+found in the search sequence (see <a href="collects.html#%28part._collects-search%29" data-pltdoc="x">Collection Search Configuration</a>) is returned.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-library-collection-paths))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-library-collection-paths</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-library-collection-paths</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">paths</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">paths</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Parameter that determines a list of complete directory paths for
+finding libraries (as referenced in <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>, for example)
+through the default <a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name resolver</span></a> and for finding paths
+through <span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-path%29%29" class="RktValLink" data-pltdoc="x">collection-path</a></span> and
+<span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-file-path%29%29" class="RktValLink" data-pltdoc="x">collection-file-path</a></span>. See <a href="collects.html#%28part._collects-search%29" data-pltdoc="x">Collection Search Configuration</a> for more
+information.</div></p><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-library-collection-links))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-links%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-library-collection-links</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fc%29%29" class="RktValLink" data-pltdoc="x">hash/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-links%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-library-collection-links</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">paths</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">paths</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fc%29%29" class="RktValLink" data-pltdoc="x">hash/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote><p>Parameter that determines <a href="collects.html#%28tech._collection._links._file%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection links files</span></a>, additional
+paths, and the relative search order of
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-paths</a></span> for finding libraries (as
+referenced in <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>, for example) through the default
+<a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name resolver</span></a> and for finding paths through
+<span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-path%29%29" class="RktValLink" data-pltdoc="x">collection-path</a></span> and <span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-file-path%29%29" class="RktValLink" data-pltdoc="x">collection-file-path</a></span>. See
+<a href="collects.html#%28part._collects-search%29" data-pltdoc="x">Collection Search Configuration</a> for more information.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._use-user-specific-search-paths))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._use-user-specific-search-paths%29%29" class="RktValDef RktValLink" data-pltdoc="x">use-user-specific-search-paths</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._use-user-specific-search-paths%29%29" class="RktValDef RktValLink" data-pltdoc="x">use-user-specific-search-paths</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Parameter that determines whether user-specific paths, which are in
+the directory produced by <span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">addon-dir</span><span class="RktPn">)</span>, are
+included in search paths for collections and other files. For example,
+the initial value of <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._find-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">find-library-collection-paths</a></span> omits the
+user-specific collection directory when this parameter&rsquo;s value is
+<span class="RktVal">#f</span>.</div></p><p>If <span class="nobreak"><span class="stt">-U</span></span> or <span class="nobreak"><span class="stt">--no-user-path</span></span> argument to <span class="stt">racket</span>, then
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._use-user-specific-search-paths%29%29" class="RktValLink" data-pltdoc="x">use-user-specific-search-paths</a></span> is initialized to
+<span class="RktVal">#f</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._use-collection-link-paths))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._use-collection-link-paths%29%29" class="RktValDef RktValLink" data-pltdoc="x">use-collection-link-paths</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._use-collection-link-paths%29%29" class="RktValDef RktValLink" data-pltdoc="x">use-collection-link-paths</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Parameter that determines whether <a href="collects.html#%28tech._collection._links._file%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection links files</span></a> are
+included in the result of <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._find-library-collection-links%29%29" class="RktValLink" data-pltdoc="x">find-library-collection-links</a></span>.</div></p><p>If this parameter&rsquo;s value is <span class="RktVal">#f</span> on start-up, then
+<a href="collects.html#%28tech._collection._links._file%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection links files</span></a> are effectively disabled permanently for
+the Racket process. In particular, if an empty string is provided as
+the <span class="nobreak"><span class="stt">-X</span></span> or <span class="nobreak"><span class="stt">--collects</span></span> argument to <span class="stt">racket</span>, then not
+only is <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-paths</a></span> initialized to the
+empty list, but <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._use-collection-link-paths%29%29" class="RktValLink" data-pltdoc="x">use-collection-link-paths</a></span> is initialized to
+<span class="RktVal">#f</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._read-installation-configuration-table))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._read-installation-configuration-table%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-installation-configuration-table</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the content of the installation&rsquo;s <span class="stt">"config.rktd"</span> file
+(see <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=config-file.html&amp;version=8.6" class="Sq" data-pltdoc="x">Installation Configuration and Search Paths</a>) as long as that content is
+a <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash table</span></a>, and otherwise returns an empty hash table.</div></p><p class="SHistory">Added in version 8.4.0.3 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="running-sa.html" title="backward to &quot;18.1 Running Racket or GRacket&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;18 Running Racket&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Interactive_Help.html" title="forward to &quot;18.3 Interactive Help&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/compiler.html b/clones/docs.racket-lang.org/reference/compiler.html
new file mode 100644
index 00000000..f932d4f4
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/compiler.html
@@ -0,0 +1,70 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>18.7&nbsp;Controlling and Inspecting Compilation</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewselflink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">18.1&nbsp;</td><td><a href="running-sa.html" class="tocviewlink" data-pltdoc="x">Running Racket or GRacket</a></td></tr><tr><td align="right">18.2&nbsp;</td><td><a href="collects.html" class="tocviewlink" data-pltdoc="x">Libraries and Collections</a></td></tr><tr><td align="right">18.3&nbsp;</td><td><a href="Interactive_Help.html" class="tocviewlink" data-pltdoc="x">Interactive Help</a></td></tr><tr><td align="right">18.4&nbsp;</td><td><a href="interaction-info.html" class="tocviewlink" data-pltdoc="x">Interaction Configuration</a></td></tr><tr><td align="right">18.5&nbsp;</td><td><a href="interactive.html" class="tocviewlink" data-pltdoc="x">Interactive Module Loading</a></td></tr><tr><td align="right">18.6&nbsp;</td><td><a href="debugging.html" class="tocviewlink" data-pltdoc="x">Debugging</a></td></tr><tr><td align="right">18.7&nbsp;</td><td><a href="compiler.html" class="tocviewselflink" data-pltdoc="x">Controlling and Inspecting Compilation</a></td></tr><tr><td align="right">18.8&nbsp;</td><td><a href="Kernel_Forms_and_Functions.html" class="tocviewlink" data-pltdoc="x">Kernel Forms and Functions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>18.7&nbsp;</td><td><a href="compiler.html" class="tocviewselflink" data-pltdoc="x">Controlling and Inspecting Compilation</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">18.7.1&nbsp;</td><td><a href="compiler.html#%28part._compiler-modes%29" class="tocviewlink" data-pltdoc="x">Compilation Modes</a></td></tr><tr><td align="right">18.7.2&nbsp;</td><td><a href="compiler.html#%28part._compiler-inspect%29" class="tocviewlink" data-pltdoc="x">Inspecting Compiler Passes</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">18.7.1<tt>&nbsp;</tt></span><a href="compiler.html#%28part._compiler-modes%29" class="tocsubseclink" data-pltdoc="x">Compilation Modes</a></td></tr><tr><td><span class="tocsublinknumber">18.7.1.1<tt>&nbsp;</tt></span><a href="compiler.html#%28part._3m-compiler-modes%29" class="tocsubseclink" data-pltdoc="x">BC Compilation Modes</a></td></tr><tr><td><span class="tocsublinknumber">18.7.1.2<tt>&nbsp;</tt></span><a href="compiler.html#%28part._cs-compiler-modes%29" class="tocsubseclink" data-pltdoc="x">CS Compilation Modes</a></td></tr><tr><td><span class="tocsublinknumber">18.7.2<tt>&nbsp;</tt></span><a href="compiler.html#%28part._compiler-inspect%29" class="tocsubseclink" data-pltdoc="x">Inspecting Compiler Passes</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="debugging.html" title="backward to &quot;18.6 Debugging&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;18 Running Racket&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Kernel_Forms_and_Functions.html" title="forward to &quot;18.8 Kernel Forms and Functions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;compiler&quot;">18.7<tt>&nbsp;</tt><a name="(part._compiler)"></a>Controlling and Inspecting Compilation</h4><p>Racket programs and expressions are compiled automatically and
+on-the-fly. The <span class="stt">raco make</span> tool (see <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=make.html&amp;version=8.6" class="Sq" data-pltdoc="x"><span class="stt">raco make</span>: Compiling Source to Bytecode</a>) can compile a Racket module to a compiled <span class="stt">".zo"</span>
+file, but that kind of ahead-to-time compilation simply allows a
+program takes to start more quickly, and it does not affect the
+performance of a Racket program.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;compiler-modes&quot;">18.7.1<tt>&nbsp;</tt><a name="(part._compiler-modes)"></a>Compilation Modes</h5><p>All Racket variants suppose a machine-independent compilation mode,
+which generates compiled <span class="stt">".zo"</span> files that work with all
+Racket variants on all platforms. To select machine-independent
+compilation mode, set the <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile-target-machine%29%29" class="RktValLink" data-pltdoc="x">current-compile-target-machine</a></span>
+parameter to <span class="RktVal">#f</span> or supplying the <span class="nobreak"><span class="stt">--compile-any</span></span>/<span class="nobreak"><span class="stt">-M</span></span>
+flag on startup. See <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile-target-machine%29%29" class="RktValLink" data-pltdoc="x">current-compile-target-machine</a></span> for more
+information.</p><p>Other compilation modes depend on the Racket implementation (see
+<a href="implementations.html" data-pltdoc="x">Implementations</a>).</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;3m-compiler-modes&quot;">18.7.1.1<tt>&nbsp;</tt><a name="(part._3m-compiler-modes)"></a>BC Compilation Modes</h5><p>The <a href="implementations.html#%28tech._bc%29" class="techoutside" data-pltdoc="x"><span class="techinside">BC</span></a> implementation of Racket supports two
+compilation modes: bytecode and machine-independent. The bytecode
+format is also machine-independent in the sense that it works the same
+on all operating systems for the BC implementation
+of Racket, but it does not work with the CS implementation of Racket.</p><p>Bytecode is further compiled to machine code at run time, unless the
+JIT compiler is disabled. See <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval-jit-enabled%29%29" class="RktValLink" data-pltdoc="x">eval-jit-enabled</a></span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;cs-compiler-modes&quot;">18.7.1.2<tt>&nbsp;</tt><a name="(part._cs-compiler-modes)"></a>CS Compilation Modes</h5><p>The <a href="implementations.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a> implementation of Racket supports several compilation modes:
+machine code, machine-independent, interpreted, and JIT. Machine code
+is the primary mode, and the machine-independent mode is the same as
+for BC. Interpreted mode uses an interpreter at
+the level of core <a href="linklets.html#%28tech._linklet%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet</span></a> forms with no compilation. JIT mode
+triggers compilation of individual function forms on demand.</p><p>The default mode is a hybrid of machine-code and interpreter modes,
+where interpreter mode is used only for the outer contour of an
+especially large linklet, and machine-code mode is used for functions
+that are small enough within that outer contour. &ldquo;Small enough&rdquo; is
+determined by the <a name="(idx._(gentag._564._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_CS_COMPILE_LIMIT</span> environment
+variable, and the default value of 10000 means that most Racket
+modules have no interpreted component.</p><p>JIT compilation mode is used only if the <a name="(idx._(gentag._565._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_CS_JIT</span>
+environment variable is set on startup, otherwise pure interpreter
+mode is used only if <a name="(idx._(gentag._566._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_CS_INTERP</span> is set on startup,
+and the default hybrid machine code and interpreter mode is used if
+<a name="(idx._(gentag._567._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_CS_MACH</span> is set and <span class="stt">PLT_CS_JIT</span> is not set
+or if none of those environment variables is set. A module compiled in
+any mode can be loaded into the CS variant of Racket independent of
+the current compilation mode.</p><p>The <span class="stt">PLT_CS_DEBUG</span> environment variable, as described in
+<a href="debugging.html" data-pltdoc="x">Debugging</a>, affects only compilation in machine-code mode.
+Generated machine code is much larger when <span class="stt">PLT_CS_DEBUG</span> is
+enabled, but performance is not otherwise affected.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;compiler-inspect&quot;">18.7.2<tt>&nbsp;</tt><a name="(part._compiler-inspect)"></a>Inspecting Compiler Passes</h5><p>When the <a name="(idx._(gentag._568._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_LINKLET_SHOW</span> environment variable is set
+on startup, the Racket process&rsquo;s standard output shows intermediate
+compiled forms whenever a Racket form is compiled. For all Racket
+variants, the output shows one or more <a href="linklets.html#%28tech._linklet%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklets</span></a> that are
+generated from the original Racket form.</p><p>For the <a href="implementations.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a> implementation of Racket, a &ldquo;schemified&rdquo; version of the linklet
+is also shown as the translation of the <span class="RktSym">linklet</span> form to a
+Chez Scheme procedure form. The following environment variables imply
+<span class="stt">PLT_LINKLET_SHOW</span> and show additional intermediate compiled
+forms or adjust the way forms are displayed:</p><ul><li><p><a name="(idx._(gentag._569._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_LINKLET_SHOW_GENSYM</span> &#8212;<wbr></wbr> prints full
+generated names, instead of abbreviations that may conflate
+different symbols</p></li><li><p><a name="(idx._(gentag._570._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_LINKLET_SHOW_PRE_JIT</span> &#8212;<wbr></wbr> shows a
+schemified forms before a transformation to JIT mode, which
+applies only when <span class="stt">PLT_CS_JIT</span> is set</p></li><li><p><a name="(idx._(gentag._571._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_LINKLET_SHOW_LAMBDA</span> &#8212;<wbr></wbr> shows individual
+schemified forms that are compiled within a larger form that
+has an interpreted outer contour</p></li><li><p><a name="(idx._(gentag._572._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_LINKLET_SHOW_POST_LAMBDA</span> &#8212;<wbr></wbr> shows an
+outer form after inner individual forms are compiled</p></li><li><p><a name="(idx._(gentag._573._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_LINKLET_SHOW_POST_INTERP</span> &#8212;<wbr></wbr> shows an
+outer form after its transformation to interpretable form</p></li><li><p><a name="(idx._(gentag._574._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_LINKLET_SHOW_JIT_DEMAND</span> &#8212;<wbr></wbr> shows JIT
+compilation of form that were previously prepared by
+compilation with <span class="stt">PLT_CS_JIT</span> set</p></li><li><p><a name="(idx._(gentag._575._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_LINKLET_SHOW_PATHS</span> &#8212;<wbr></wbr> show lifted
+path and serialization information alongside a schemified form</p></li><li><p><a name="(idx._(gentag._576._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_LINKLET_SHOW_KNOWN</span> &#8212;<wbr></wbr> show recorded
+known-binding information alongside a schemified form</p></li><li><p><a name="(idx._(gentag._577._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_LINKLET_SHOW_CP0</span> &#8212;<wbr></wbr> show a schemified
+form after transformation by Chez Scheme&rsquo;s front-end
+optimizer</p></li><li><p><a name="(idx._(gentag._578._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_LINKLET_SHOW_PASSES</span> &#8212;<wbr></wbr> show the
+intermediate form of a schemified linklet after the specified
+passes (listed space-separated) in Chez Scheme&rsquo;s internal
+representation</p></li><li><p><a name="(idx._(gentag._579._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_LINKLET_SHOW_ASSEMBLY</span> &#8212;<wbr></wbr> show the
+compiled form of a schemified linklet in Chez Scheme&rsquo;s
+abstraction of machine instructions</p></li></ul><p>When the <a name="(idx._(gentag._580._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_LINKLET_TIMES</span> environment variable is
+set on startup, then Racket prints cumulative timing information about
+compilation and evaluation times on exit. When the
+<a name="(idx._(gentag._581._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_EXPANDER_TIMES</span> environment variable is set,
+information about macro-expansion time is printed on exit.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="debugging.html" title="backward to &quot;18.6 Debugging&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;18 Running Racket&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Kernel_Forms_and_Functions.html" title="forward to &quot;18.8 Kernel Forms and Functions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/compoundunits.html b/clones/docs.racket-lang.org/reference/compoundunits.html
new file mode 100644
index 00000000..8221de00
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/compoundunits.html
@@ -0,0 +1,46 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7.3&nbsp;Linking Units and Creating Compound Units</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="creatingunits.html" class="tocviewlink" data-pltdoc="x">Creating Units</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="invokingunits.html" class="tocviewlink" data-pltdoc="x">Invoking Units</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="compoundunits.html" class="tocviewselflink" data-pltdoc="x">Linking Units and Creating Compound Units</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="linkinference.html" class="tocviewlink" data-pltdoc="x">Inferred Linking</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="Generating_A_Unit_from_Context.html" class="tocviewlink" data-pltdoc="x">Generating A Unit from Context</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="Structural_Matching.html" class="tocviewlink" data-pltdoc="x">Structural Matching</a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="define-sig-form.html" class="tocviewlink" data-pltdoc="x">Extending the Syntax of Signatures</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Unit_Utilities.html" class="tocviewlink" data-pltdoc="x">Unit Utilities</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="unitcontracts.html" class="tocviewlink" data-pltdoc="x">Unit Contracts</a></td></tr><tr><td align="right">7.10&nbsp;</td><td><a href="single-unit.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Unit Modules</a></td></tr><tr><td align="right">7.11&nbsp;</td><td><a href="Single-Signature_Modules.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Signature Modules</a></td></tr><tr><td align="right">7.12&nbsp;</td><td><a href="Transformer_Helpers.html" class="tocviewlink" data-pltdoc="x">Transformer Helpers</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="compoundunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">compound-<wbr></wbr>unit</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="invokingunits.html" title="backward to &quot;7.2 Invoking Units&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="linkinference.html" title="forward to &quot;7.4 Inferred Linking&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;compoundunits&quot;">7.3<tt>&nbsp;</tt><a name="(part._compoundunits)"></a>Linking Units and Creating Compound Units</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._compound-unit))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="compoundunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">compound-unit</a></span></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span><span class="hspace">&nbsp;</span><span class="RktVar">link-binding</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-link-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="RktStxLink" data-pltdoc="x">link</a></span><span class="hspace">&nbsp;</span><span class="RktVar">linkage-decl</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">link-binding</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">link-id</span><span class="hspace">&nbsp;</span><span class="RktSym">:</span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">tagged-link-id</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._tag%29%29" class="RktStxLink" data-pltdoc="x">tag</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">link-id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">link-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">linkage-decl</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVar">link-binding</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">unit-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-link-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Links several units into one new compound unit without immediately
+invoking any of the linked units.  The <span class="RktVar">unit-expr</span>s in the
+<span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="RktStxLink" data-pltdoc="x">link</a></span> clause determine the units to be linked in creating the
+compound unit. The <span class="RktVar">unit-expr</span>s are evaluated when the
+<span class="RktSym"><a href="compoundunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%29%29" class="RktStxLink" data-pltdoc="x">compound-unit</a></span> form is evaluated.</div></p><p>The <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span> clause determines the imports of the compound
+unit. Outside the compound unit, these imports behave as for a plain
+unit; inside the compound unit, they are propagated to some of the
+linked units. The <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span> clause determines the exports of the
+compound unit.  Again, outside the compound unit, these exports are
+treated the same as for a plain unit; inside the compound unit, they
+are drawn from the exports of the linked units. Finally, the left-hand
+and right-hand parts of each declaration in the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="RktStxLink" data-pltdoc="x">link</a></span> clause
+specify how the compound unit&rsquo;s imports and exports are propagated to
+the linked units.</p><p>Individual elements of an imported or exported signature are not
+available within the compound unit. Instead, imports and exports are
+connected at the level of whole signatures. Each specific import or
+export (i.e., an instance of some signature, possibly tagged) is given
+a <span class="RktVar">link-id</span> name. Specifically, a <span class="RktVar">link-id</span> is bound by
+the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span> clause or the left-hand part of a declaration in
+the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="RktStxLink" data-pltdoc="x">link</a></span> clause. A bound <span class="RktVar">link-id</span> is referenced in
+the right-hand part of a declaration in the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="RktStxLink" data-pltdoc="x">link</a></span> clause or by
+the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span> clause.</p><p>The left-hand side of a <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="RktStxLink" data-pltdoc="x">link</a></span> declaration gives names to each
+expected export of the unit produced by the corresponding
+<span class="RktVar">unit-expr</span>. The actual unit may export additional signatures,
+and it may export an extension of a specific signature instead of just
+the specified one. If the unit does not export one of the specified
+signatures (with the specified tag, if any), the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised when the <span class="RktSym"><a href="compoundunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%29%29" class="RktStxLink" data-pltdoc="x">compound-unit</a></span> form is
+evaluated.</p><p>The right-hand side of a <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="RktStxLink" data-pltdoc="x">link</a></span> declaration specifies the
+imports to be supplied to the unit produced by the corresponding
+<span class="RktVar">unit-expr</span>. The actual unit may import fewer signatures, and
+it may import a signature that is extended by the specified one.  If
+the unit imports a signature (with a particular tag) that is not
+included in the supplied imports, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised
+when the <span class="RktSym"><a href="compoundunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%29%29" class="RktStxLink" data-pltdoc="x">compound-unit</a></span> form is evaluated. Each
+<span class="RktVar">link-id</span> supplied as an import must be bound either in the
+<span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span> clause or in some declaration within the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="RktStxLink" data-pltdoc="x">link</a></span>
+clause.</p><p>The order of declarations in the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="RktStxLink" data-pltdoc="x">link</a></span> clause determines the
+order of invocation of the linked units. When the compound unit is
+invoked, the unit produced by the first <span class="RktVar">unit-expr</span> is invoked
+first, then the second, and so on. If the order specified in the
+<span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="RktStxLink" data-pltdoc="x">link</a></span> clause is inconsistent with <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._init-depend%29%29" class="RktStxLink" data-pltdoc="x">init-depend</a></span>
+declarations of the actual units, then the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised when the <span class="RktSym"><a href="compoundunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%29%29" class="RktStxLink" data-pltdoc="x">compound-unit</a></span> form is
+evaluated.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="invokingunits.html" title="backward to &quot;7.2 Invoking Units&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="linkinference.html" title="forward to &quot;7.4 Inferred Linking&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/concurrency.html b/clones/docs.racket-lang.org/reference/concurrency.html
new file mode 100644
index 00000000..d441d561
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/concurrency.html
@@ -0,0 +1,6 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>11&nbsp;Concurrency and Parallelism</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewselflink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>11&nbsp;</td><td><a href="concurrency.html" class="tocviewselflink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.1&nbsp;</td><td><a href="threads.html" class="tocviewlink" data-pltdoc="x">Threads</a></td></tr><tr><td align="right">11.2&nbsp;</td><td><a href="all-sync.html" class="tocviewlink" data-pltdoc="x">Synchronization</a></td></tr><tr><td align="right">11.3&nbsp;</td><td><a href="thread-local-storage.html" class="tocviewlink" data-pltdoc="x">Thread-<wbr></wbr>Local Storage</a></td></tr><tr><td align="right">11.4&nbsp;</td><td><a href="futures.html" class="tocviewlink" data-pltdoc="x">Futures</a></td></tr><tr><td align="right">11.5&nbsp;</td><td><a href="places.html" class="tocviewlink" data-pltdoc="x">Places</a></td></tr><tr><td align="right">11.6&nbsp;</td><td><a href="engine.html" class="tocviewlink" data-pltdoc="x">Engines</a></td></tr><tr><td align="right">11.7&nbsp;</td><td><a href="memory-order.html" class="tocviewlink" data-pltdoc="x">Machine Memory Order</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="unreachable.html" title="backward to &quot;10.8 Unreachable Expressions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="threads.html" title="forward to &quot;11.1 Threads&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;concurrency&quot;">11<tt>&nbsp;</tt><a name="(part._concurrency)"></a>Concurrency and Parallelism</h3><p>Racket supports multiple threads of control within a program,
+thread-local storage, some primitive synchronization mechanisms, and a
+framework for composing synchronization abstractions. In addition, the
+<span class="RktSym">racket/future</span> and <span class="RktSym">racket/place</span> libraries provide
+support for parallelism to improve performance.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="threads.html" class="toclink" data-pltdoc="x">11.1<span class="hspace">&nbsp;</span>Threads</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="threads.html#%28part._.Creating_.Threads%29" class="toclink" data-pltdoc="x">11.1.1<span class="hspace">&nbsp;</span>Creating Threads</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="threads.html#%28part._threadkill%29" class="toclink" data-pltdoc="x">11.1.2<span class="hspace">&nbsp;</span>Suspending, Resuming, and Killing Threads</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="threads.html#%28part._threadsync%29" class="toclink" data-pltdoc="x">11.1.3<span class="hspace">&nbsp;</span>Synchronizing Thread State</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="threads.html#%28part._threadmbox%29" class="toclink" data-pltdoc="x">11.1.4<span class="hspace">&nbsp;</span>Thread Mailboxes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="all-sync.html" class="toclink" data-pltdoc="x">11.2<span class="hspace">&nbsp;</span>Synchronization</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sync.html" class="toclink" data-pltdoc="x">11.2.1<span class="hspace">&nbsp;</span>Events</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="channel.html" class="toclink" data-pltdoc="x">11.2.2<span class="hspace">&nbsp;</span>Channels</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="semaphore.html" class="toclink" data-pltdoc="x">11.2.3<span class="hspace">&nbsp;</span>Semaphores</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="async-channel.html" class="toclink" data-pltdoc="x">11.2.4<span class="hspace">&nbsp;</span>Buffered Asynchronous Channels</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="async-channel.html#%28part._.Creating_and_.Using_.Asynchronous_.Channels%29" class="toclink" data-pltdoc="x">11.2.4.1<span class="hspace">&nbsp;</span>Creating and Using Asynchronous Channels</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="async-channel.html#%28part._.Contracts_and_.Impersonators_on_.Asynchronous_.Channels%29" class="toclink" data-pltdoc="x">11.2.4.2<span class="hspace">&nbsp;</span>Contracts and Impersonators on Asynchronous Channels</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="thread-local-storage.html" class="toclink" data-pltdoc="x">11.3<span class="hspace">&nbsp;</span>Thread-Local Storage</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="threadcells.html" class="toclink" data-pltdoc="x">11.3.1<span class="hspace">&nbsp;</span>Thread Cells</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="parameters.html" class="toclink" data-pltdoc="x">11.3.2<span class="hspace">&nbsp;</span>Parameters</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="futures.html" class="toclink" data-pltdoc="x">11.4<span class="hspace">&nbsp;</span>Futures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="futures.html#%28part._.Creating_and_.Touching_.Futures%29" class="toclink" data-pltdoc="x">11.4.1<span class="hspace">&nbsp;</span>Creating and Touching Futures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="futures.html#%28part._.Future_.Semaphores%29" class="toclink" data-pltdoc="x">11.4.2<span class="hspace">&nbsp;</span>Future Semaphores</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="futures.html#%28part._future-logging%29" class="toclink" data-pltdoc="x">11.4.3<span class="hspace">&nbsp;</span>Future Performance Logging</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="places.html" class="toclink" data-pltdoc="x">11.5<span class="hspace">&nbsp;</span>Places</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="places.html#%28part._places-api%29" class="toclink" data-pltdoc="x">11.5.1<span class="hspace">&nbsp;</span>Using Places</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="places.html#%28part._places-syntax%29" class="toclink" data-pltdoc="x">11.5.2<span class="hspace">&nbsp;</span>Syntactic Support for Using Places</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="places.html#%28part._place-logging%29" class="toclink" data-pltdoc="x">11.5.3<span class="hspace">&nbsp;</span>Places Logging</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="engine.html" class="toclink" data-pltdoc="x">11.6<span class="hspace">&nbsp;</span>Engines</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="memory-order.html" class="toclink" data-pltdoc="x">11.7<span class="hspace">&nbsp;</span>Machine Memory Order</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="unreachable.html" title="backward to &quot;10.8 Unreachable Expressions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="threads.html" title="forward to &quot;11.1 Threads&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/cont.html b/clones/docs.racket-lang.org/reference/cont.html
new file mode 100644
index 00000000..359f1b86
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/cont.html
@@ -0,0 +1,177 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>10.4&nbsp;Continuations</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewselflink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">10.1&nbsp;</td><td><a href="values.html" class="tocviewlink" data-pltdoc="x">Multiple Values</a></td></tr><tr><td align="right">10.2&nbsp;</td><td><a href="exns.html" class="tocviewlink" data-pltdoc="x">Exceptions</a></td></tr><tr><td align="right">10.3&nbsp;</td><td><a href="Delayed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Delayed Evaluation</a></td></tr><tr><td align="right">10.4&nbsp;</td><td><a href="cont.html" class="tocviewselflink" data-pltdoc="x">Continuations</a></td></tr><tr><td align="right">10.5&nbsp;</td><td><a href="contmarks.html" class="tocviewlink" data-pltdoc="x">Continuation Marks</a></td></tr><tr><td align="right">10.6&nbsp;</td><td><a href="breakhandler.html" class="tocviewlink" data-pltdoc="x">Breaks</a></td></tr><tr><td align="right">10.7&nbsp;</td><td><a href="Exiting.html" class="tocviewlink" data-pltdoc="x">Exiting</a></td></tr><tr><td align="right">10.8&nbsp;</td><td><a href="unreachable.html" class="tocviewlink" data-pltdoc="x">Unreachable Expressions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>10.4&nbsp;</td><td><a href="cont.html" class="tocviewselflink" data-pltdoc="x">Continuations</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">10.4.1&nbsp;</td><td><a href="cont.html#%28part._.Additional_.Control_.Operators%29" class="tocviewlink" data-pltdoc="x">Additional Control Operators</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-prompt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>continuation-<wbr></wbr>prompt</span></span></a></td></tr><tr><td><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._abort-current-continuation%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">abort-<wbr></wbr>current-<wbr></wbr>continuation</span></span></a></td></tr><tr><td><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-prompt-tag%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>continuation-<wbr></wbr>prompt-<wbr></wbr>tag</span></span></a></td></tr><tr><td><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">default-<wbr></wbr>continuation-<wbr></wbr>prompt-<wbr></wbr>tag</span></span></a></td></tr><tr><td><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-current-continuation%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>current-<wbr></wbr>continuation</span></span></a></td></tr><tr><td><a href="cont.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call%2Fcc%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call/<span class="mywbr"> &nbsp;</span>cc</span></span></a></td></tr><tr><td><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-composable-continuation%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>composable-<wbr></wbr>continuation</span></span></a></td></tr><tr><td><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-escape-continuation%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>escape-<wbr></wbr>continuation</span></span></a></td></tr><tr><td><a href="cont.html#%28def._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._call%2Fec%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call/<span class="mywbr"> &nbsp;</span>ec</span></span></a></td></tr><tr><td><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-in-continuation%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>in-<wbr></wbr>continuation</span></span></a></td></tr><tr><td><a href="cont.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._let%2Fcc%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">let/<span class="mywbr"> &nbsp;</span>cc</span></span></a></td></tr><tr><td><a href="cont.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2Fec%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">let/<span class="mywbr"> &nbsp;</span>ec</span></span></a></td></tr><tr><td><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-barrier%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>continuation-<wbr></wbr>barrier</span></span></a></td></tr><tr><td><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-available~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-<wbr></wbr>prompt-<wbr></wbr>available?</span></span></a></td></tr><tr><td><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation?</span></span></a></td></tr><tr><td><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-<wbr></wbr>prompt-<wbr></wbr>tag?</span></span></a></td></tr><tr><td><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-<wbr></wbr>wind</span></span></a></td></tr><tr><td><span class="tocsublinknumber">10.4.1<tt>&nbsp;</tt></span><a href="cont.html#%28part._.Additional_.Control_.Operators%29" class="tocsubseclink" data-pltdoc="x">Additional Control Operators</a></td></tr><tr><td><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._call%2Fprompt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call/<span class="mywbr"> &nbsp;</span>prompt</span></span></a></td></tr><tr><td><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._abort%2Fcc%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">abort/<span class="mywbr"> &nbsp;</span>cc</span></span></a></td></tr><tr><td><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._call%2Fcomp%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call/<span class="mywbr"> &nbsp;</span>comp</span></span></a></td></tr><tr><td><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._abort%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">abort</span></span></a></td></tr><tr><td><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._~25%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">%</span></span></a></td></tr><tr><td><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._fcontrol%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fcontrol</span></span></a></td></tr><tr><td><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">prompt</span></span></a></td></tr><tr><td><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">control</span></span></a></td></tr><tr><td><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt-at%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">prompt-<wbr></wbr>at</span></span></a></td></tr><tr><td><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control-at%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">control-<wbr></wbr>at</span></span></a></td></tr><tr><td><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">reset</span></span></a></td></tr><tr><td><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._shift%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">shift</span></span></a></td></tr><tr><td><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset-at%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">reset-<wbr></wbr>at</span></span></a></td></tr><tr><td><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._shift-at%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">shift-<wbr></wbr>at</span></span></a></td></tr><tr><td><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt0%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">prompt0</span></span></a></td></tr><tr><td><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset0%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">reset0</span></span></a></td></tr><tr><td><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control0%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">control0</span></span></a></td></tr><tr><td><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._shift0%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">shift0</span></span></a></td></tr><tr><td><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt0-at%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">prompt0-<wbr></wbr>at</span></span></a></td></tr><tr><td><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset0-at%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">reset0-<wbr></wbr>at</span></span></a></td></tr><tr><td><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control0-at%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">control0-<wbr></wbr>at</span></span></a></td></tr><tr><td><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._shift0-at%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">shift0-<wbr></wbr>at</span></span></a></td></tr><tr><td><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._spawn%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">spawn</span></span></a></td></tr><tr><td><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._splitter%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">splitter</span></span></a></td></tr><tr><td><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._new-prompt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">new-<wbr></wbr>prompt</span></span></a></td></tr><tr><td><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._set%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">set</span></span></a></td></tr><tr><td><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._cupto%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">cupto</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Delayed_Evaluation.html" title="backward to &quot;10.3 Delayed Evaluation&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Control Flow&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contmarks.html" title="forward to &quot;10.5 Continuation Marks&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;cont&quot;">10.4<tt>&nbsp;</tt><a name="(part._cont)"></a>Continuations</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=conts.html&amp;version=8.6" class="Sq" data-pltdoc="x">Continuations</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces continuations.</p></blockquote></blockquote></blockquote><p>See <a href="eval-model.html#%28part._cont-model%29" data-pltdoc="x">Sub-expression Evaluation and Continuations</a> and <a href="eval-model.html#%28part._prompt-model%29" data-pltdoc="x">Prompts, Delimited Continuations, and Barriers</a> for general
+information about continuations. Racket&rsquo;s support for prompts and
+composable continuations most closely resembles Dorai Sitaram&rsquo;s
+<span class="RktSym">%</span> and <span class="RktSym">fcontrol</span> operator [<a href="doc-bibliography.html#%28cite._.Sitaram93%29" data-pltdoc="x">Sitaram93</a>].</p><p>Racket installs a <a href="eval-model.html#%28tech._continuation._barrier%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation barrier</span></a> around evaluation in the
+following contexts, preventing full-continuation jumps into the
+evaluation context protected by the barrier:</p><ul><li><p>applying an exception handler, an error escape handler, or an
+error display handler (see <a href="exns.html" data-pltdoc="x">Exceptions</a>);</p></li><li><p>applying a macro transformer (see <a href="stxtrans.html" data-pltdoc="x">Syntax Transformers</a>),
+evaluating a compile-time expression, or applying a module name
+resolver (see <a href="Module_Names_and_Loading.html#%28part._modnameresolver%29" data-pltdoc="x">Resolving Module Names</a>);</p></li><li><p>applying a custom-port procedure (see <a href="customport.html" data-pltdoc="x">Custom Ports</a>), an
+event guard procedure (see <a href="sync.html" data-pltdoc="x">Events</a>), or a parameter guard
+procedure (see <a href="parameters.html" data-pltdoc="x">Parameters</a>);</p></li><li><p>applying a security-guard procedure (see
+<a href="securityguards.html" data-pltdoc="x">Security Guards</a>);</p></li><li><p>applying a will procedure (see <a href="willexecutor.html" data-pltdoc="x">Wills and Executors</a>); or</p></li><li><p>evaluating or loading code from the stand-alone Racket
+command line (see <a href="running-sa.html" data-pltdoc="x">Running Racket or GRacket</a>).</p></li></ul><p>In addition, extensions of Racket may install barriers in
+additional contexts. Finally,
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-barrier%29%29" class="RktValLink" data-pltdoc="x">call-with-continuation-barrier</a></span> applies a thunk barrier
+between the application and the current continuation.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._call-with-continuation-prompt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-prompt%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-continuation-prompt</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">prompt-tag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">handler</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">prompt-tag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-prompt-tag?</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">handler</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Applies <span class="RktVar">proc</span> to the given <span class="RktVar">arg</span>s with the current
+continuation extended by a prompt. The prompt is tagged by
+<span class="RktVar">prompt-tag</span>, which must be a result from either
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span> (the default) or
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">make-continuation-prompt-tag</a></span>. The call to
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-prompt%29%29" class="RktValLink" data-pltdoc="x">call-with-continuation-prompt</a></span> returns the result of
+<span class="RktVar">proc</span>.</div></p><p>The <span class="RktVar">handler</span> argument specifies a handler procedure to be
+called in tail position with respect to the
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-prompt%29%29" class="RktValLink" data-pltdoc="x">call-with-continuation-prompt</a></span> call when the installed prompt
+is the target of an <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._abort-current-continuation%29%29" class="RktValLink" data-pltdoc="x">abort-current-continuation</a></span> call with
+<span class="RktVar">prompt-tag</span>; the remaining arguments of
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._abort-current-continuation%29%29" class="RktValLink" data-pltdoc="x">abort-current-continuation</a></span> are supplied to the handler
+procedure. If <span class="RktVar">handler</span> is <span class="RktVal">#f</span>, the default handler
+accepts a single <span class="RktVar">abort-thunk</span> argument and calls
+<span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-prompt%29%29" class="RktValLink" data-pltdoc="x">call-with-continuation-prompt</a></span><span class="stt"> </span><span class="RktVar">abort-thunk</span><span class="stt"> </span><span class="RktVar">prompt-tag</span><span class="stt"> </span><span class="RktVal">#f</span><span class="RktPn">)</span>;
+that is, the default handler re-installs the prompt and continues with
+a given thunk.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._abort-current-continuation))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._abort-current-continuation%29%29" class="RktValDef RktValLink" data-pltdoc="x">abort-current-continuation</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prompt-tag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prompt-tag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Resets the current continuation to that of the nearest prompt tagged
+by <span class="RktVar">prompt-tag</span> in the current continuation; if no such prompt exists,
+the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3acontinuation%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:continuation</a></span> exception is raised. The <span class="RktVar">v</span>s are delivered
+as arguments to the target prompt&rsquo;s handler procedure.</div></p><p>The protocol for <span class="RktVar">v</span>s supplied to an abort is specific to the
+<span class="RktVar">prompt-tag</span>. When <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._abort-current-continuation%29%29" class="RktValLink" data-pltdoc="x">abort-current-continuation</a></span> is used with
+<span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span><span class="RktPn">)</span>, generally, a single thunk
+should be supplied that is suitable for use with the default prompt
+handler. Similarly, when <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-prompt%29%29" class="RktValLink" data-pltdoc="x">call-with-continuation-prompt</a></span> is
+used with <span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span><span class="RktPn">)</span>, the associated
+handler should generally accept a single thunk argument.</p><p>Each <a href="eval-model.html#%28tech._thread%29" class="techoutside" data-pltdoc="x"><span class="techinside">thread</span></a>&rsquo;s continuation starts with a prompt for
+<span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span><span class="RktPn">)</span> that uses the default
+handler, which accepts a single thunk to apply (with the prompt
+intact).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-continuation-prompt-tag))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-prompt-tag%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-continuation-prompt-tag</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-prompt-tag?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-prompt-tag%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-continuation-prompt-tag</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-prompt-tag?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a prompt tag that is not <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to the result of any
+other value (including prior or future results from
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">make-continuation-prompt-tag</a></span>). The optional <span class="RktVar">name</span>
+argument, if supplied, specifies the name of the prompt tag
+for printing or <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span>.</div></p><p class="SHistory">Changed in version 7.9.0.13 of package <span class="stt">base</span>: The <span class="RktVar">name</span> argument
+gives the name of the prompt tag.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._default-continuation-prompt-tag))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValDef RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-prompt-tag?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns a constant prompt tag for which a prompt is installed at the
+start of every thread&rsquo;s continuation; the handler for each thread&rsquo;s
+initial prompt accepts any number of values and returns. The result of
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span> is the default tag for
+any procedure that accepts a prompt tag.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._call-with-current-continuation))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-current-continuation%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-current-continuation</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">prompt-tag</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation~3f%29%29" class="RktValLink" data-pltdoc="x">continuation?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">prompt-tag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-prompt-tag?</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Captures the current continuation up to the nearest prompt tagged by
+<span class="RktVar">prompt-tag</span>; if no such prompt exists, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3acontinuation%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:continuation</a></span> exception is raised. The truncated continuation
+includes only continuation marks and <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="RktValLink" data-pltdoc="x">dynamic-wind</a></span> frames
+installed since the prompt.</div></p><p>The captured continuation is delivered to <span class="RktVar">proc</span>, which is
+called in tail position with respect to the
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-current-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-current-continuation</a></span> call.</p><p>If the continuation argument to <span class="RktVar">proc</span> is ever applied, then it
+removes the portion of the current continuation up to the nearest
+prompt tagged by <span class="RktVar">prompt-tag</span> (not including the prompt; if no
+such prompt exists, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3acontinuation%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:continuation</a></span> exception is raised), or
+up to the nearest continuation frame (if any) shared by the current
+and captured continuations&#8212;<wbr></wbr>whichever is first. While removing
+continuation frames, <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="RktValLink" data-pltdoc="x">dynamic-wind</a></span> <span class="RktVar">post-thunk</span>s are
+executed. Finally, the (unshared portion of the) captured continuation
+is appended to the remaining continuation, applying
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="RktValLink" data-pltdoc="x">dynamic-wind</a></span> <span class="RktVar">pre-thunk</span>s.</p><p>The arguments supplied to an applied procedure become the result
+values for the restored continuation. In particular, if multiple
+arguments are supplied, then the continuation receives multiple
+results.</p><p>If, at application time, a <a href="eval-model.html#%28tech._continuation._barrier%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation barrier</span></a> would be
+introduced by replacing the current continuation with the applied one,
+then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3acontinuation%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:continuation</a></span> exception is raised.</p><p>A continuation can be invoked from the thread (see
+<a href="threads.html" data-pltdoc="x">Threads</a>) other than the one where it was captured.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/more-scheme..rkt)._call/cc))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call%2Fcc%29%29" class="RktValDef RktValLink" data-pltdoc="x">call/cc</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">prompt-tag</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation~3f%29%29" class="RktValLink" data-pltdoc="x">continuation?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">prompt-tag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-prompt-tag?</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call%2Fcc%29%29" class="RktValLink" data-pltdoc="x">call/cc</a></span> binding is an alias for <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-current-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-current-continuation</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._call-with-composable-continuation))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-composable-continuation%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-composable-continuation</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">prompt-tag</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation~3f%29%29" class="RktValLink" data-pltdoc="x">continuation?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">prompt-tag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-prompt-tag?</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-current-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-current-continuation</a></span>, but applying
+the resulting continuation procedure does not remove any portion of
+the current continuation. Instead, application always extends the
+current continuation with the captured continuation (without
+installing any prompts other than those captured in the
+continuation).</div></p><p>When <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-composable-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-composable-continuation</a></span> is called, if a
+continuation barrier appears in the continuation before the closest
+prompt tagged by <span class="RktVar">prompt-tag</span>, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3acontinuation%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:continuation</a></span> exception is raised (because attempting to apply
+the continuation would always fail).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._call-with-escape-continuation))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-escape-continuation%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-escape-continuation</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation~3f%29%29" class="RktValLink" data-pltdoc="x">continuation?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-current-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-current-continuation</a></span>, but <span class="RktVar">proc</span> is not
+called in tail position, and the continuation procedure supplied to
+<span class="RktVar">proc</span> can only be called during the dynamic extent of the
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-escape-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-escape-continuation</a></span> call.</div></p><p>A continuation obtained from <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-escape-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-escape-continuation</a></span> is
+actually a kind of prompt. Escape continuations are provided mainly
+for backwards compatibility, since they pre-date general prompts in
+Racket. In the <a href="implementations.html#%28tech._bc%29" class="techoutside" data-pltdoc="x"><span class="techinside">BC</span></a> implementation of Racket,
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-escape-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-escape-continuation</a></span> is implemented more efficiently
+than <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-current-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-current-continuation</a></span>, so
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-escape-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-escape-continuation</a></span> can sometimes replace
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-current-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-current-continuation</a></span> to improve performance in
+those older Racket variants.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/letstx-scheme..rkt)._call/ec))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._call%2Fec%29%29" class="RktValDef RktValLink" data-pltdoc="x">call/ec</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation~3f%29%29" class="RktValLink" data-pltdoc="x">continuation?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._call%2Fec%29%29" class="RktValLink" data-pltdoc="x">call/ec</a></span> binding is an alias for <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-escape-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-escape-continuation</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._call-in-continuation))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-in-continuation%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-in-continuation</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation~3f%29%29" class="RktValLink" data-pltdoc="x">continuation?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to applying the continuation <span class="RktVar">k</span>, but instead of
+delivering values to the continuation, <span class="RktVar">proc</span> is called with
+<span class="RktVar">k</span> as the continuation of the call (so the result of
+<span class="RktVar">proc</span> is returned to the continuation). If <span class="RktVar">k</span>
+is a composable continuation, the continuation of the call to
+<span class="RktVar">proc</span> is the current continuation extended with <span class="RktVar">k</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call%2Fcc%29%29" class="RktValLink" data-pltdoc="x">call/cc</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">k</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-in-continuation%29%29" class="RktValLink" data-pltdoc="x">call-in-continuation</a></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call%2Fcc%29%29" class="RktValLink" data-pltdoc="x">call/cc</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">k</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="RktValLink" data-pltdoc="x">dynamic-wind</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"><span class="RktSym">n</span> accessed after post thunk</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-in-continuation%29%29" class="RktValLink" data-pltdoc="x">call-in-continuation</a></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">n</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call%2Fcc%29%29" class="RktValLink" data-pltdoc="x">call/cc</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">k</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">n</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-in-continuation%29%29" class="RktValLink" data-pltdoc="x">call-in-continuation</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">k</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"><span class="RktVal">'</span><span class="RktVal">n</span> mark accessed in continuation</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-first%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set-first</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 7.6.0.17 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/more-scheme..rkt)._let/cc))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._let%2Fcc%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">let/cc</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call%2Fcc%29%29" class="RktValLink" data-pltdoc="x">call/cc</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/letstx-scheme..rkt)._let/ec))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2Fec%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">let/ec</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._call%2Fec%29%29" class="RktValLink" data-pltdoc="x">call/ec</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._call-with-continuation-barrier))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-barrier%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-continuation-barrier</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thunk</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Applies <span class="RktVar">thunk</span> with a <a href="eval-model.html#%28tech._continuation._barrier%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation barrier</span></a> between the
+application and the current continuation. The results of
+<span class="RktVar">thunk</span> are the results of the
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-barrier%29%29" class="RktValLink" data-pltdoc="x">call-with-continuation-barrier</a></span> call.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._continuation-prompt-available~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-available~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">continuation-prompt-available?</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prompt-tag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">cont</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prompt-tag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-prompt-tag?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cont</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation~3f%29%29" class="RktValLink" data-pltdoc="x">continuation?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call%2Fcc%29%29" class="RktValLink" data-pltdoc="x">call/cc</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">cont</span>, which must be a continuation,
+includes a prompt tagged by <span class="RktVar">prompt-tag</span>, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._continuation~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">continuation?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Return <span class="RktVal">#t</span> if
+<span class="RktVar">v</span> is a continuation as produced by
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-current-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-current-continuation</a></span>,
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-composable-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-composable-continuation</a></span>, or
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-escape-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-escape-continuation</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._continuation-prompt-tag~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">continuation-prompt-tag?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a continuation prompt tag as produced by
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span> or <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">make-continuation-prompt-tag</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._dynamic-wind))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="RktValDef RktValLink" data-pltdoc="x">dynamic-wind</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pre-thunk</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">value-thunk</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">post-thunk</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pre-thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">value-thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">post-thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Applies its three thunk arguments in order.  The value of a
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="RktValLink" data-pltdoc="x">dynamic-wind</a></span> expression is the value returned by
+<span class="RktVar">value-thunk</span>. The <span class="RktVar">pre-thunk</span> procedure is invoked
+before calling <span class="RktVar">value-thunk</span> and <span class="RktVar">post-thunk</span> is invoked
+after <span class="RktVar">value-thunk</span> returns. The special properties of
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="RktValLink" data-pltdoc="x">dynamic-wind</a></span> are manifest when control jumps into or out of
+the <span class="RktVar">value-thunk</span> application (either due to a prompt abort or
+a continuation invocation): every time control jumps into the
+<span class="RktVar">value-thunk</span> application, <span class="RktVar">pre-thunk</span> is invoked, and
+every time control jumps out of <span class="RktVar">value-thunk</span>,
+<span class="RktVar">post-thunk</span> is invoked. (No special handling is performed for
+jumps into or out of the <span class="RktVar">pre-thunk</span> and <span class="RktVar">post-thunk</span>
+applications.)</div></p><p>When <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="RktValLink" data-pltdoc="x">dynamic-wind</a></span> calls <span class="RktVar">pre-thunk</span> for normal
+evaluation of <span class="RktVar">value-thunk</span>, the continuation of the
+<span class="RktVar">pre-thunk</span> application calls <span class="RktVar">value-thunk</span> (with
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="RktValLink" data-pltdoc="x">dynamic-wind</a></span>&rsquo;s special jump handling) and then
+<span class="RktVar">post-thunk</span>.  Similarly, the continuation of the
+<span class="RktVar">post-thunk</span> application returns the value of the preceding
+<span class="RktVar">value-thunk</span> application to the continuation of the entire
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="RktValLink" data-pltdoc="x">dynamic-wind</a></span> application.</p><p>When <span class="RktVar">pre-thunk</span> is called due to a continuation jump, the
+continuation of <span class="RktVar">pre-thunk</span></p><ul><li><p>jumps to a more deeply nested <span class="RktVar">pre-thunk</span>, if any, or jumps
+to the destination continuation; then</p></li><li><p>continues with the context of the <span class="RktVar">pre-thunk</span>&rsquo;s
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="RktValLink" data-pltdoc="x">dynamic-wind</a></span> call.</p></li></ul><p>Normally, the second part of this continuation is never reached, due
+to a jump in the first part. However, the second part is relevant
+because it enables jumps to escape continuations that are contained in
+the context of the <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="RktValLink" data-pltdoc="x">dynamic-wind</a></span> call. Furthermore, it means
+that the continuation marks (see <a href="contmarks.html" data-pltdoc="x">Continuation Marks</a>) and
+parameterization (see <a href="parameters.html" data-pltdoc="x">Parameters</a>) for <span class="RktVar">pre-thunk</span>
+correspond to those of the <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="RktValLink" data-pltdoc="x">dynamic-wind</a></span> call that installed
+<span class="RktVar">pre-thunk</span>. The <span class="RktVar">pre-thunk</span> call, however, is
+<span class="RktSym"><a href="breakhandler.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize-break%29%29" class="RktStxLink" data-pltdoc="x">parameterize-break</a></span>ed to disable breaks (see also
+<a href="breakhandler.html" data-pltdoc="x">Breaks</a>).</p><p>Similarly, when <span class="RktVar">post-thunk</span> is called due to a continuation
+jump, the continuation of <span class="RktVar">post-thunk</span> jumps to a less deeply
+nested <span class="RktVar">post-thunk</span>, if any, or jumps to a <span class="RktVar">pre-thunk</span>
+protecting the destination, if any, or jumps to the destination
+continuation, then continues from the <span class="RktVar">post-thunk</span>&rsquo;s
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="RktValLink" data-pltdoc="x">dynamic-wind</a></span> application. As for <span class="RktVar">pre-thunk</span>, the
+parameterization of the original <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="RktValLink" data-pltdoc="x">dynamic-wind</a></span> call is
+restored for the call, and the call is <span class="RktSym"><a href="breakhandler.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize-break%29%29" class="RktStxLink" data-pltdoc="x">parameterize-break</a></span>ed
+to disable breaks.</p><p>In both cases, the target for a jump is recomputed after each
+<span class="RktVar">pre-thunk</span> or <span class="RktVar">post-thunk</span> completes. When a
+prompt-delimited continuation (see <a href="eval-model.html#%28part._prompt-model%29" data-pltdoc="x">Prompts, Delimited Continuations, and Barriers</a>) is
+captured in a <span class="RktVar">post-thunk</span>, it might be delimited and
+instantiated in such a way that the target of a jump turns out to be
+different when the continuation is applied than when the continuation
+was captured. There may even be no appropriate target, if a relevant
+prompt or escape continuation is not in the continuation after the
+restore; in that case, the first step in a <span class="RktVar">pre-thunk</span> or
+<span class="RktVar">post-thunk</span>&rsquo;s continuation can raise an exception.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2Fec%29%29" class="RktStxLink" data-pltdoc="x">let/ec</a></span><span class="hspace">&nbsp;</span><span class="RktSym">out</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="RktValLink" data-pltdoc="x">dynamic-wind</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"in "</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"pre "</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call%2Fcc%29%29" class="RktValLink" data-pltdoc="x">call/cc</a></span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"out "</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxLink" data-pltdoc="x">when</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktVal">"post "</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">in pre out in post out </span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2Fec%29%29" class="RktStxLink" data-pltdoc="x">let/ec</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2Fec%29%29" class="RktStxLink" data-pltdoc="x">let/ec</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="RktValLink" data-pltdoc="x">dynamic-wind</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k0</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">cancel</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k1</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">cancel-canceled</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'cancel-canceled</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A%29%29" class="RktStxLink" data-pltdoc="x">let*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._make-parameter%29%29" class="RktValLink" data-pltdoc="x">make-parameter</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">add</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._append%29%29" class="RktValLink" data-pltdoc="x">append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="RktValLink" data-pltdoc="x">dynamic-wind</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">add</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">k+e</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._let%2Fcc%29%29" class="RktStxLink" data-pltdoc="x">let/cc</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">add</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k+e</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k+e</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">add</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._let%2Fcc%29%29" class="RktStxLink" data-pltdoc="x">let/cc</a></span><span class="hspace">&nbsp;</span><span class="RktSym">esc</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="hspace">&nbsp;</span><span class="RktSym">esc</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'((1 . 5) (2 . 6) (3 . 5) (1 . 5) (2 . 6) (3 . 5))</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Additional_Control_Operators&quot;">10.4.1<tt>&nbsp;</tt><a name="(part._.Additional_.Control_.Operators)"></a><a name="(mod-path._racket/control)"></a>Additional Control Operators</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="cont.html#%28mod-path._racket%2Fcontrol%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/control</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="cont.html#%28mod-path._racket%2Fcontrol%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/control</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p>The <span class="RktSym">racket/control</span> library provides various control operators
+from the research literature on higher-order control operators, plus a
+few extra convenience forms. These control operators are implemented
+in terms of <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-prompt%29%29" class="RktValLink" data-pltdoc="x">call-with-continuation-prompt</a></span>,
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-composable-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-composable-continuation</a></span>, etc<span class="Sendabbrev">.</span>, and they generally
+work sensibly together. Many are redundant; for example,
+<span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset%29%29" class="RktStxLink" data-pltdoc="x">reset</a></span> and <span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="RktStxLink" data-pltdoc="x">prompt</a></span> are aliases.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/control..rkt)._call/prompt))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._call%2Fprompt%29%29" class="RktValDef RktValLink" data-pltdoc="x">call/prompt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">prompt-tag</span><span class="hspace">&nbsp;</span><span class="RktVar">handler</span><span class="RktOpt">]</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">prompt-tag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-prompt-tag?</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">handler</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._call%2Fprompt%29%29" class="RktValLink" data-pltdoc="x">call/prompt</a></span> binding is an alias for <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-prompt%29%29" class="RktValLink" data-pltdoc="x">call-with-continuation-prompt</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/control..rkt)._abort/cc))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._abort%2Fcc%29%29" class="RktValDef RktValLink" data-pltdoc="x">abort/cc</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">prompt-tag</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prompt-tag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._abort%2Fcc%29%29" class="RktValLink" data-pltdoc="x">abort/cc</a></span> binding is an alias for <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._abort-current-continuation%29%29" class="RktValLink" data-pltdoc="x">abort-current-continuation</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/control..rkt)._call/comp))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._call%2Fcomp%29%29" class="RktValDef RktValLink" data-pltdoc="x">call/comp</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">prompt-tag</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation~3f%29%29" class="RktValLink" data-pltdoc="x">continuation?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">prompt-tag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-prompt-tag?</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._call%2Fcomp%29%29" class="RktValLink" data-pltdoc="x">call/comp</a></span> binding is an alias for <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-composable-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-composable-continuation</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/control..rkt)._abort))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._abort%29%29" class="RktValDef RktValLink" data-pltdoc="x">abort</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <span class="RktVar">v</span>s to a prompt using the default continuation
+prompt tag and the default abort handler.</div></p><p>That is, <span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._abort%29%29" class="RktValLink" data-pltdoc="x">abort</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> is equivalent to</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._abort-current-continuation%29%29" class="RktValLink" data-pltdoc="x">abort-current-continuation</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="RktStxLink" data-pltdoc="x">prompt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"start here\n"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"answer is ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._abort%29%29" class="RktValLink" data-pltdoc="x">abort</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">start here</span></p></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></blockquote></div></p><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/control..rkt)._~25))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._~25%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">%</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._~25%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">%</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktVar">handler-expr</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._~25%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">%</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktVar">handler-expr</span><span class="hspace">&nbsp;</span><span class="RktPn">#:tag</span><span class="hspace">&nbsp;</span><span class="RktVar">tag-expr</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/control..rkt)._fcontrol))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._fcontrol%29%29" class="RktValDef RktValLink" data-pltdoc="x">fcontrol</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktPn">#:tag</span><span class="hspace">&nbsp;</span><span class="RktVar">prompt-tag</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prompt-tag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote><p>Sitaram&rsquo;s operators [<a href="doc-bibliography.html#%28cite._.Sitaram93%29" data-pltdoc="x">Sitaram93</a>].</p><p>The essential reduction rules are:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._~25%29%29" class="RktStxLink" data-pltdoc="x">%</a></span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span><span class="RktSym">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktVar">val</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._~25%29%29" class="RktStxLink" data-pltdoc="x">%</a></span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._fcontrol%29%29" class="RktValLink" data-pltdoc="x">fcontrol</a></span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktVar">x</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">where </span><span class="RktVar">E</span><span class="RktCmt"> has no </span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._~25%29%29" class="RktStxLink" data-pltdoc="x">%</a></span></td></tr></table></blockquote><p>When <span class="RktVar">handler-expr</span> is omitted, <span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._~25%29%29" class="RktStxLink" data-pltdoc="x">%</a></span> is the same as
+<span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="RktStxLink" data-pltdoc="x">prompt</a></span>. If <span class="RktVar">prompt-tag</span> is provided, <span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._~25%29%29" class="RktStxLink" data-pltdoc="x">%</a></span>
+uses specific prompt tags like <span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt-at%29%29" class="RktStxLink" data-pltdoc="x">prompt-at</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._~25%29%29" class="RktStxLink" data-pltdoc="x">%</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._fcontrol%29%29" class="RktValLink" data-pltdoc="x">fcontrol</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">7</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._~25%29%29" class="RktStxLink" data-pltdoc="x">%</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._fcontrol%29%29" class="RktValLink" data-pltdoc="x">fcontrol</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/control..rkt)._prompt))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">prompt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/control..rkt)._control))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">control</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Among the earliest operators for higher-order control
+[<a href="doc-bibliography.html#%28cite._.Felleisen88a%29" data-pltdoc="x">Felleisen88a</a>, <a href="doc-bibliography.html#%28cite._.Felleisen88%29" data-pltdoc="x">Felleisen88</a>, <a href="doc-bibliography.html#%28cite._.Sitaram90%29" data-pltdoc="x">Sitaram90</a>].</div></p><p><div class="SIntrapara">The essential reduction rules are:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="RktStxLink" data-pltdoc="x">prompt</a></span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktVar">val</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="RktStxLink" data-pltdoc="x">prompt</a></span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control%29%29" class="RktStxLink" data-pltdoc="x">control</a></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="RktStxLink" data-pltdoc="x">prompt</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktVar">v</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">where </span><span class="RktVar">E</span><span class="RktCmt"> has no </span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="RktStxLink" data-pltdoc="x">prompt</a></span></td></tr></table></blockquote></div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="RktStxLink" data-pltdoc="x">prompt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control%29%29" class="RktStxLink" data-pltdoc="x">control</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">7</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="RktStxLink" data-pltdoc="x">prompt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control%29%29" class="RktStxLink" data-pltdoc="x">control</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="RktStxLink" data-pltdoc="x">prompt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control%29%29" class="RktStxLink" data-pltdoc="x">control</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control%29%29" class="RktStxLink" data-pltdoc="x">control</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k1</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">7</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="RktStxLink" data-pltdoc="x">prompt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control%29%29" class="RktStxLink" data-pltdoc="x">control</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control%29%29" class="RktStxLink" data-pltdoc="x">control</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">8</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="RktStxLink" data-pltdoc="x">prompt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control%29%29" class="RktStxLink" data-pltdoc="x">control</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control%29%29" class="RktStxLink" data-pltdoc="x">control</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control%29%29" class="RktStxLink" data-pltdoc="x">control</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k2</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">6</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/control..rkt)._prompt-at))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt-at%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">prompt-at</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">prompt-tag-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/control..rkt)._control-at))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control-at%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">control-at</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">prompt-tag-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="RktStxLink" data-pltdoc="x">prompt</a></span> and <span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control%29%29" class="RktStxLink" data-pltdoc="x">control</a></span>, but using specific prompt
+tags:</div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt-at%29%29" class="RktStxLink" data-pltdoc="x">prompt-at</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tag</span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktVar">val</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt-at%29%29" class="RktStxLink" data-pltdoc="x">prompt-at</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tag</span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control-at%29%29" class="RktStxLink" data-pltdoc="x">control-at</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tag</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt-at%29%29" class="RktStxLink" data-pltdoc="x">prompt-at</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tag</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktVar">v</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">where </span><span class="RktVar">E</span><span class="RktCmt"> has no </span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt-at%29%29" class="RktStxLink" data-pltdoc="x">prompt-at</a></span><span class="RktCmt"> for </span><span class="RktVar">tag</span></td></tr></table></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/control..rkt)._reset))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">reset</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/control..rkt)._shift))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._shift%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">shift</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Danvy and Filinski&rsquo;s operators [<a href="doc-bibliography.html#%28cite._.Danvy90%29" data-pltdoc="x">Danvy90</a>].</div></p><p>The essential reduction rules are:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset%29%29" class="RktStxLink" data-pltdoc="x">reset</a></span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktVar">val</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset%29%29" class="RktStxLink" data-pltdoc="x">reset</a></span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._shift%29%29" class="RktStxLink" data-pltdoc="x">shift</a></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset%29%29" class="RktStxLink" data-pltdoc="x">reset</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset%29%29" class="RktStxLink" data-pltdoc="x">reset</a></span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktVar">v</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">where </span><span class="RktVar">E</span><span class="RktCmt"> has no </span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset%29%29" class="RktStxLink" data-pltdoc="x">reset</a></span></td></tr></table></blockquote><p>The <span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset%29%29" class="RktStxLink" data-pltdoc="x">reset</a></span> and <span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="RktStxLink" data-pltdoc="x">prompt</a></span> forms are interchangeable.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/control..rkt)._reset-at))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset-at%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">reset-at</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">prompt-tag-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/control..rkt)._shift-at))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._shift-at%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">shift-at</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">prompt-tag-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">identifier</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset%29%29" class="RktStxLink" data-pltdoc="x">reset</a></span> and <span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._shift%29%29" class="RktStxLink" data-pltdoc="x">shift</a></span>, but using the specified prompt
+tags.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/control..rkt)._prompt0))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt0%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">prompt0</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/control..rkt)._reset0))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset0%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">reset0</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/control..rkt)._control0))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control0%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">control0</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/control..rkt)._shift0))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._shift0%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">shift0</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Generalizations of <span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="RktStxLink" data-pltdoc="x">prompt</a></span>, etc<span class="Sendabbrev">.</span> [<a href="doc-bibliography.html#%28cite._.Shan04%29" data-pltdoc="x">Shan04</a>].</div></p><p>The essential reduction rules are:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt0%29%29" class="RktStxLink" data-pltdoc="x">prompt0</a></span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktVar">val</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt0%29%29" class="RktStxLink" data-pltdoc="x">prompt0</a></span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control0%29%29" class="RktStxLink" data-pltdoc="x">control0</a></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktVar">v</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset0%29%29" class="RktStxLink" data-pltdoc="x">reset0</a></span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktVar">val</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset0%29%29" class="RktStxLink" data-pltdoc="x">reset0</a></span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._shift0%29%29" class="RktStxLink" data-pltdoc="x">shift0</a></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset0%29%29" class="RktStxLink" data-pltdoc="x">reset0</a></span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktVar">v</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The <span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset0%29%29" class="RktStxLink" data-pltdoc="x">reset0</a></span> and <span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt0%29%29" class="RktStxLink" data-pltdoc="x">prompt0</a></span> forms are interchangeable.
+Furthermore, the following reductions apply:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="RktStxLink" data-pltdoc="x">prompt</a></span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control0%29%29" class="RktStxLink" data-pltdoc="x">control0</a></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="RktStxLink" data-pltdoc="x">prompt</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktVar">v</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset%29%29" class="RktStxLink" data-pltdoc="x">reset</a></span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._shift0%29%29" class="RktStxLink" data-pltdoc="x">shift0</a></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset%29%29" class="RktStxLink" data-pltdoc="x">reset</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset0%29%29" class="RktStxLink" data-pltdoc="x">reset0</a></span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktVar">v</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt0%29%29" class="RktStxLink" data-pltdoc="x">prompt0</a></span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control%29%29" class="RktStxLink" data-pltdoc="x">control</a></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt0%29%29" class="RktStxLink" data-pltdoc="x">prompt0</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktVar">v</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset0%29%29" class="RktStxLink" data-pltdoc="x">reset0</a></span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._shift%29%29" class="RktStxLink" data-pltdoc="x">shift</a></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset0%29%29" class="RktStxLink" data-pltdoc="x">reset0</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset%29%29" class="RktStxLink" data-pltdoc="x">reset</a></span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktVar">v</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>That is, both the <span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="RktStxLink" data-pltdoc="x">prompt</a></span>/<span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset%29%29" class="RktStxLink" data-pltdoc="x">reset</a></span> and
+<span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control%29%29" class="RktStxLink" data-pltdoc="x">control</a></span>/<span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._shift%29%29" class="RktStxLink" data-pltdoc="x">shift</a></span> sites must agree for <span class="RktVal">0</span>-like
+behavior, otherwise the non-<span class="RktVal">0</span> behavior applies.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/control..rkt)._prompt0-at))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt0-at%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">prompt0-at</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">prompt-tag-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/control..rkt)._reset0-at))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset0-at%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">reset0-at</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">prompt-tag-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/control..rkt)._control0-at))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control0-at%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">control0-at</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">prompt-tag-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/control..rkt)._shift0-at))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._shift0-at%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">shift0-at</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">prompt-tag-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Variants of <span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt0%29%29" class="RktStxLink" data-pltdoc="x">prompt0</a></span>, etc<span class="Sendabbrev">.</span>, that accept a prompt tag.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/control..rkt)._spawn))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._spawn%29%29" class="RktValDef RktValLink" data-pltdoc="x">spawn</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">The operators of Hieb and Dybvig [<a href="doc-bibliography.html#%28cite._.Hieb90%29" data-pltdoc="x">Hieb90</a>].</div></p><p>The essential reduction rules are:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt-at%29%29" class="RktStxLink" data-pltdoc="x">prompt-at</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tag</span><span class="hspace">&nbsp;</span><span class="RktVar">obj</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktVar">obj</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._spawn%29%29" class="RktValLink" data-pltdoc="x">spawn</a></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="RktStxLink" data-pltdoc="x">prompt</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tag</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._abort%29%29" class="RktValLink" data-pltdoc="x">abort</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tag</span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt-at%29%29" class="RktStxLink" data-pltdoc="x">prompt-at</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tag</span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._abort%29%29" class="RktValLink" data-pltdoc="x">abort</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tag</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt-at%29%29" class="RktStxLink" data-pltdoc="x">prompt-at</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tag</span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktVar">x</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">where </span><span class="RktVar">E</span><span class="RktCmt"> has no </span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt-at%29%29" class="RktStxLink" data-pltdoc="x">prompt-at</a></span><span class="RktCmt"> for </span><span class="RktVar">tag</span></td></tr></table></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/control..rkt)._splitter))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._splitter%29%29" class="RktValDef RktValLink" data-pltdoc="x">splitter</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation~3f%29%29" class="RktValLink" data-pltdoc="x">continuation?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The operator of Queinnec and Serpette [<a href="doc-bibliography.html#%28cite._.Queinnec91%29" data-pltdoc="x">Queinnec91</a>].</div></p><p><div class="SIntrapara">The essential reduction rules are:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._splitter%29%29" class="RktValLink" data-pltdoc="x">splitter</a></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt-at%29%29" class="RktStxLink" data-pltdoc="x">prompt-at</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tag</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">thunk</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._abort%29%29" class="RktValLink" data-pltdoc="x">abort</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tag</span><span class="hspace">&nbsp;</span><span class="RktVar">thunk</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">proc</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control0-at%29%29" class="RktStxLink" data-pltdoc="x">control0-at</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tag</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt-at%29%29" class="RktStxLink" data-pltdoc="x">prompt-at</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tag</span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._abort%29%29" class="RktValLink" data-pltdoc="x">abort</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tag</span><span class="hspace">&nbsp;</span><span class="RktVar">thunk</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">thunk</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">where </span><span class="RktVar">E</span><span class="RktCmt"> has no </span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt-at%29%29" class="RktStxLink" data-pltdoc="x">prompt-at</a></span><span class="RktCmt"> for </span><span class="RktVar">tag</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt-at%29%29" class="RktStxLink" data-pltdoc="x">prompt-at</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tag</span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control0-at%29%29" class="RktStxLink" data-pltdoc="x">control0-at</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tag</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">E</span><span class="RktPn">[</span><span class="RktVar">x</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">where </span><span class="RktVar">E</span><span class="RktCmt"> has no </span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt-at%29%29" class="RktStxLink" data-pltdoc="x">prompt-at</a></span><span class="RktCmt"> for </span><span class="RktVar">tag</span></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/control..rkt)._new-prompt))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._new-prompt%29%29" class="RktValDef RktValLink" data-pltdoc="x">new-prompt</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/control..rkt)._set))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._set%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">set</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">prompt-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/control..rkt)._cupto))"></a><span title="Provided from: racket/control | Package: base"><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._cupto%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">cupto</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">prompt-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The operators of Gunter et al. [<a href="doc-bibliography.html#%28cite._.Gunter95%29" data-pltdoc="x">Gunter95</a>].</div></p><p>In this library, <span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._new-prompt%29%29" class="RktValLink" data-pltdoc="x">new-prompt</a></span> is an alias for
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">make-continuation-prompt-tag</a></span>, <span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._set%29%29" class="RktStxLink" data-pltdoc="x">set</a></span> is an alias for
+<span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt0-at%29%29" class="RktStxLink" data-pltdoc="x">prompt0-at</a></span>, and <span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._cupto%29%29" class="RktStxLink" data-pltdoc="x">cupto</a></span> is an alias for <span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control0-at%29%29" class="RktStxLink" data-pltdoc="x">control0-at</a></span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Delayed_Evaluation.html" title="backward to &quot;10.3 Delayed Evaluation&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Control Flow&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contmarks.html" title="forward to &quot;10.5 Continuation Marks&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/contmarks.html b/clones/docs.racket-lang.org/reference/contmarks.html
new file mode 100644
index 00000000..70abdf36
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/contmarks.html
@@ -0,0 +1,110 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>10.5&nbsp;Continuation Marks</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewselflink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">10.1&nbsp;</td><td><a href="values.html" class="tocviewlink" data-pltdoc="x">Multiple Values</a></td></tr><tr><td align="right">10.2&nbsp;</td><td><a href="exns.html" class="tocviewlink" data-pltdoc="x">Exceptions</a></td></tr><tr><td align="right">10.3&nbsp;</td><td><a href="Delayed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Delayed Evaluation</a></td></tr><tr><td align="right">10.4&nbsp;</td><td><a href="cont.html" class="tocviewlink" data-pltdoc="x">Continuations</a></td></tr><tr><td align="right">10.5&nbsp;</td><td><a href="contmarks.html" class="tocviewselflink" data-pltdoc="x">Continuation Marks</a></td></tr><tr><td align="right">10.6&nbsp;</td><td><a href="breakhandler.html" class="tocviewlink" data-pltdoc="x">Breaks</a></td></tr><tr><td align="right">10.7&nbsp;</td><td><a href="Exiting.html" class="tocviewlink" data-pltdoc="x">Exiting</a></td></tr><tr><td align="right">10.8&nbsp;</td><td><a href="unreachable.html" class="tocviewlink" data-pltdoc="x">Unreachable Expressions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-marks%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-<wbr></wbr>marks</span></span></a></td></tr><tr><td><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>continuation-<wbr></wbr>marks</span></span></a></td></tr><tr><td><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3elist%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-<wbr></wbr>mark-<wbr></wbr>set-<wbr></wbr>&gt;list</span></span></a></td></tr><tr><td><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3elist%2A%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-<wbr></wbr>mark-<wbr></wbr>set-<wbr></wbr>&gt;list*</span></span></a></td></tr><tr><td><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3eiterator%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-<wbr></wbr>mark-<wbr></wbr>set-<wbr></wbr>&gt;iterator</span></span></a></td></tr><tr><td><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-first%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-<wbr></wbr>mark-<wbr></wbr>set-<wbr></wbr>first</span></span></a></td></tr><tr><td><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._call-with-immediate-continuation-mark%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>immediate-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-mark-key%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>continuation-<wbr></wbr>mark-<wbr></wbr>key</span></span></a></td></tr><tr><td><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-key~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-<wbr></wbr>mark-<wbr></wbr>key?</span></span></a></td></tr><tr><td><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-<wbr></wbr>mark-<wbr></wbr>set?</span></span></a></td></tr><tr><td><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3econtext%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-<wbr></wbr>mark-<wbr></wbr>set-<wbr></wbr>&gt;context</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="cont.html" title="backward to &quot;10.4 Continuations&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Control Flow&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="breakhandler.html" title="forward to &quot;10.6 Breaks&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contmarks&quot;">10.5<tt>&nbsp;</tt><a name="(part._contmarks)"></a>Continuation Marks</h4><p>See <a href="eval-model.html#%28part._mark-model%29" data-pltdoc="x">Continuation Frames and Marks</a> and <a href="eval-model.html#%28part._prompt-model%29" data-pltdoc="x">Prompts, Delimited Continuations, and Barriers</a> for
+general information about continuation marks.</p><p>The list of continuation marks for a key <span class="RktVar">k</span> and a continuation
+<span class="RktVar">C</span> that extends <span class="RktVar">C<span style="vertical-align: sub; font-size: 80%">0</span></span> is defined as follows:</p><ul><li><p>If <span class="RktVar">C</span> is an empty continuation, then the mark list is
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span>.</p></li><li><p>If <span class="RktVar">C</span>&rsquo;s first frame contains a mark <span class="RktVar">m</span> for <span class="RktVar">k</span>,
+then the mark list for <span class="RktVar">C</span> is <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="stt"> </span><span class="RktVar">m</span><span class="stt"> </span><span class="RktVar">lst</span><span class="RktPn">)</span>,
+where <span class="RktVar">lst</span> is the mark list for <span class="RktVar">k</span> in <span class="RktVar">C<span style="vertical-align: sub; font-size: 80%">0</span></span>.</p></li><li><p>If <span class="RktVar">C</span>&rsquo;s first frame does not contain a mark keyed by
+<span class="RktVar">k</span>, then the mark list for <span class="RktVar">C</span> is the mark list for
+<span class="RktVar">C<span style="vertical-align: sub; font-size: 80%">0</span></span>.</p></li></ul><p>The <span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span> form installs a mark on the first
+frame of the current continuation (see <a href="wcm.html" data-pltdoc="x">Continuation Marks: <span class="RktSym"><span class="RktStxLink">with-continuation-mark</span></span></a>).  Procedures
+such as <span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="RktValLink" data-pltdoc="x">current-continuation-marks</a></span> allow inspection of marks.</p><p>Whenever Racket creates an exception record for a primitive exception,
+it fills the <span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-marks%29%29" class="RktValLink" data-pltdoc="x">continuation-marks</a></span> field with the value of
+<span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="RktValLink" data-pltdoc="x">current-continuation-marks</a></span><span class="RktPn">)</span>, thus providing a snapshot of
+the continuation marks at the time of the exception.</p><p>When a continuation procedure returned by
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-current-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-current-continuation</a></span> or
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-composable-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-composable-continuation</a></span> is invoked, it restores the
+captured continuation, and also restores the marks in the
+continuation&rsquo;s frames to the marks that were present when
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-current-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-current-continuation</a></span> or
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-composable-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-composable-continuation</a></span> was invoked.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._continuation-marks))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-marks%29%29" class="RktValDef RktValLink" data-pltdoc="x">continuation-marks</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">cont</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">prompt-tag</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cont</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation~3f%29%29" class="RktValLink" data-pltdoc="x">continuation?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="RktValLink" data-pltdoc="x">thread?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">prompt-tag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-prompt-tag?</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns an opaque value containing the set of continuation marks for
+all keys in the continuation <span class="RktVar">cont</span> (or the current
+continuation of <span class="RktVar">cont</span> if it is a thread) up to the prompt
+tagged by <span class="RktVar">prompt-tag</span>. If <span class="RktVar">cont</span> is <span class="RktVal">#f</span>, the
+resulting set of continuation marks is empty. If <span class="RktVar">cont</span> is an escape
+continuation (see <a href="eval-model.html#%28part._prompt-model%29" data-pltdoc="x">Prompts, Delimited Continuations, and Barriers</a>), then the current
+continuation must extend <span class="RktVar">cont</span>, or the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. If <span class="RktVar">cont</span> was not captured with
+respect to <span class="RktVar">prompt-tag</span> and does not include a prompt for
+<span class="RktVar">prompt-tag</span>, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. If
+<span class="RktVar">cont</span> is a dead thread, the result is an empty set of
+continuation marks.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-continuation-marks))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-continuation-marks</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">prompt-tag</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">prompt-tag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-prompt-tag?</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns an opaque value containing the set of continuation marks for
+all keys in the current continuation up to <span class="RktVar">prompt-tag</span>. In
+other words, it produces the same value as</div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-current-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-current-continuation</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-marks%29%29" class="RktValLink" data-pltdoc="x">continuation-marks</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktVar">prompt-tag</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prompt-tag</span><span class="RktPn">)</span></td></tr></table></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._continuation-mark-set-~3elist))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3elist%29%29" class="RktValDef RktValLink" data-pltdoc="x">continuation-mark-set-&gt;list</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">mark-set</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">key-v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">prompt-tag</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mark-set</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">prompt-tag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-prompt-tag?</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns a newly-created list containing the marks for <span class="RktVar">key-v</span>
+in <span class="RktVar">mark-set</span>, which is a set of marks returned by
+<span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="RktValLink" data-pltdoc="x">current-continuation-marks</a></span> or <span class="RktVal">#f</span> as a shorthand for
+<span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="RktValLink" data-pltdoc="x">current-continuation-marks</a></span><span class="stt"> </span><span class="RktVar">prompt-tag</span><span class="RktPn">)</span>. The result list is truncated at
+the first point, if any, where continuation frames were originally
+separated by a prompt tagged with <span class="RktVar">prompt-tag</span>. Producing the result
+takes time proportional to the size of the continuation reflected by
+<span class="RktVar">mark-set</span>.</div></p><p class="SHistory">Changed in version 8.0.0.1 of package <span class="stt">base</span>: Changed to allow <span class="RktVar">mark-set</span> as <span class="RktVal">#f</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._continuation-mark-set-~3elist*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3elist%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">continuation-mark-set-&gt;list*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">mark-set</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">key-list</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">none-v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prompt-tag</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mark-set</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key-list</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">none-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">prompt-tag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-prompt-tag?</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns a newly-created list containing vectors of marks in
+<span class="RktVar">mark-set</span> for the keys in <span class="RktVar">key-list</span>, up to
+<span class="RktVar">prompt-tag</span>, where a <span class="RktVal">#f</span> value for <span class="RktVar">mark-set</span>
+is equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="RktValLink" data-pltdoc="x">current-continuation-marks</a></span><span class="stt"> </span><span class="RktVar">prompt-tag</span><span class="RktPn">)</span>.
+The length of each vector in the result list is
+the same as the length of <span class="RktVar">key-list</span>, and a value in a
+particular vector position is the value for the corresponding key in
+<span class="RktVar">key-list</span>. Values for multiple keys appear in a single vector
+only when the marks are for the same continuation frame in
+<span class="RktVar">mark-set</span>. The <span class="RktVar">none-v</span> argument is used for vector
+elements to indicate the lack of a value. Producing the result
+takes time proportional to the size of the continuation reflected by
+<span class="RktVar">mark-set</span> times the length of <span class="RktVar">key-list</span>.</div></p><p class="SHistory">Changed in version 8.0.0.1 of package <span class="stt">base</span>: Changed to allow <span class="RktVar">mark-set</span> as <span class="RktVal">#f</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._continuation-mark-set-~3eiterator))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3eiterator%29%29" class="RktValDef RktValLink" data-pltdoc="x">continuation-mark-set-&gt;iterator</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">mark-set</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">key-list</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">none-v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prompt-tag</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mark-set</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key-list</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">none-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">prompt-tag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-prompt-tag?</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3elist%2A%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set-&gt;list*</a></span>, but instead of returning a
+list of values, returns a functional iterator in the form of a
+procedure that returns one element of the would-be list and a new
+iterator function for the rest of the would-be list. An iterator
+procedure returns <span class="RktVal">#f</span> instead of a vector when no more
+elements are available; in that case, the returned iterator
+procedure is like the called one, producing no further values.
+The time required for each step is proportional to the length of
+<span class="RktVar">key-list</span> times the size of the segment of the continuation
+reflected by <span class="RktVar">mark-set</span> between frames that have keys in
+<span class="RktVar">key-list</span>.</div></p><p class="SHistory">Added in version 7.5.0.7 of package <span class="stt">base</span>.<br/>Changed in version 8.0.0.1: Changed to allow <span class="RktVar">mark-set</span> as <span class="RktVal">#f</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._continuation-mark-set-first))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-first%29%29" class="RktValDef RktValLink" data-pltdoc="x">continuation-mark-set-first</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">mark-set</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">key-v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">none-v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prompt-tag</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mark-set</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">none-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">prompt-tag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-prompt-tag?</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns the first element of the list that would be returned by
+<span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3elist%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set-&gt;list</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="stt"> </span><span class="RktVar">mark-set</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="RktValLink" data-pltdoc="x">current-continuation-marks</a></span><span class="stt"> </span><span class="RktVar">prompt-tag</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">key-v</span><span class="stt"> </span><span class="RktVar">prompt-tag</span><span class="RktPn">)</span>, or
+<span class="RktVar">none-v</span> if the result would be the empty list.</div></p><p>The result
+is produced in (amortized) constant time. Typically, this
+result can be computed more quickly using
+<span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-first%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set-first</a></span> than using
+<span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3elist%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set-&gt;list</a></span> or by using
+<span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3eiterator%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set-&gt;iterator</a></span> and iterating just once.</p><p>Although <span class="RktVal">#f</span> and <span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="RktValLink" data-pltdoc="x">current-continuation-marks</a></span><span class="stt"> </span><span class="RktVar">prompt-tag</span><span class="RktPn">)</span> are equivalent for <span class="RktVar">mark-set</span>, providing <span class="RktVal">#f</span>
+as <span class="RktVar">mark-set</span> can enable shortcuts that make it even faster.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._call-with-immediate-continuation-mark))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._call-with-immediate-continuation-mark%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-immediate-continuation-mark</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">key-v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">default-v</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">default-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Calls <span class="RktVar">proc</span> with the value associated with <span class="RktVar">key-v</span> in
+the first frame of the current continuation (i.e., a value that would
+be replaced if the call to
+<span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._call-with-immediate-continuation-mark%29%29" class="RktValLink" data-pltdoc="x">call-with-immediate-continuation-mark</a></span> were replaced with a
+<span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span> form using <span class="RktVar">key-v</span> as the key
+expression). If no such value exists in the first frame,
+<span class="RktVar">default-v</span> is passed to <span class="RktVar">proc</span>. The <span class="RktVar">proc</span> is
+called in tail position with respect to the
+<span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._call-with-immediate-continuation-mark%29%29" class="RktValLink" data-pltdoc="x">call-with-immediate-continuation-mark</a></span> call.</div></p><p>This function could be implemented with a combination of
+<span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span>, <span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="RktValLink" data-pltdoc="x">current-continuation-marks</a></span>,
+and <span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3elist%2A%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set-&gt;list*</a></span>, as shown below, but
+<span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._call-with-immediate-continuation-mark%29%29" class="RktValLink" data-pltdoc="x">call-with-immediate-continuation-mark</a></span> is implemented more
+efficiently; it inspects only the first frame of the current
+continuation.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Equivalent, but inefficient:</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._call-with-immediate-continuation-mark%29%29" class="RktValLink" data-pltdoc="x">call-with-immediate-continuation-mark</a></span><span class="hspace">&nbsp;</span><span class="RktVar">key-v</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">default-v</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">private-key</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._gensym%29%29" class="RktValLink" data-pltdoc="x">gensym</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">private-key</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">vecs</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3elist%2A%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set-&gt;list*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="RktValLink" data-pltdoc="x">current-continuation-marks</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVar">key-v</span><span class="hspace">&nbsp;</span><span class="RktSym">private-key</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">default-v</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">vecs</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-continuation-mark-key))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-mark-key%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-continuation-mark-key</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-key~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-key?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-mark-key%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-continuation-mark-key</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sym</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-key~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-key?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a continuation mark key that is not <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to the result
+of any other value (including prior and future results from
+<span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-mark-key%29%29" class="RktValLink" data-pltdoc="x">make-continuation-mark-key</a></span>). The continuation mark key can be used
+as the key argument for <span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span> or accessor procedures
+like <span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-first%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set-first</a></span>. The mark key can be chaperoned
+or impersonated, unlike other values that are used as the mark key.</div></p><p>The optional <span class="RktVar">sym</span> argument, if provided, is used when printing
+the continuation mark.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._continuation-mark-key~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-key~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">continuation-mark-key?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a mark key created by
+<span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-mark-key%29%29" class="RktValLink" data-pltdoc="x">make-continuation-mark-key</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._continuation-mark-set~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">continuation-mark-set?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a mark set created by
+<span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-marks%29%29" class="RktValLink" data-pltdoc="x">continuation-marks</a></span> or <span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="RktValLink" data-pltdoc="x">current-continuation-marks</a></span>,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._continuation-mark-set-~3econtext))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3econtext%29%29" class="RktValDef RktValLink" data-pltdoc="x">continuation-mark-set-&gt;context</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">mark-set</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">realms?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mark-set</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">realms?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list representing an approximate &ldquo;<a name="(idx._(gentag._221._(lib._scribblings/reference/reference..scrbl)))"></a><a name="(idx._(gentag._222._(lib._scribblings/reference/reference..scrbl)))"></a>stack trace&rdquo; for <span class="RktVar">mark-set</span>&rsquo;s continuation.
+The list contains pairs if <span class="RktVar">realms?</span> is <span class="RktVal">#f</span>, where the
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> of each pair contains either <span class="RktVal">#f</span> or a symbol for
+a procedure name, and the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> of each pair contains either
+<span class="RktVal">#f</span> or a <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span> value for the procedure&rsquo;s source
+location (see <a href="linecol.html" data-pltdoc="x">Counting Positions, Lines, and Columns</a>); the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> and <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span>
+are never both <span class="RktVal">#f</span>. If <span class="RktVar">realms?</span> is true, the list
+contains 3-element vectors, where the first two elements are like the
+values for a pair, and the third element is a realm symbol.</div></p><p>Conceptually, the stack-trace list is the result of
+<span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3elist%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set-&gt;list</a></span> with <span class="RktVar">mark-set</span> and
+Racket&rsquo;s private key for procedure-call marks. The implementation may
+be different, however, and the results may merely approximate the
+correct answer. Thus, while the result may contain useful hints to
+humans about the context of an expression, it is not reliable enough
+for programmatic use.</p><p>A stack trace is extracted from an exception and displayed by the
+default error display handler (see
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-display-handler%29%29" class="RktValLink" data-pltdoc="x">error-display-handler</a></span>) for exceptions other than
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3auser%29%29" class="RktValLink" data-pltdoc="x">exn:fail:user</a></span> (see <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-user-error%29%29" class="RktValLink" data-pltdoc="x">raise-user-error</a></span> in
+<a href="exns.html#%28part._errorproc%29" data-pltdoc="x">Raising Exceptions</a>).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">extract-current-continuation-marks</span><span class="hspace">&nbsp;</span><span class="RktSym">key</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3elist%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set-&gt;list</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="RktValLink" data-pltdoc="x">current-continuation-marks</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">key</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">key</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">mark</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">extract-current-continuation-marks</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">key</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(mark)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">key1</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">mark1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">key2</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">mark2</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">extract-current-continuation-marks</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">key1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">extract-current-continuation-marks</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">key2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'((mark1) (mark2))</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">key</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">mark1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">key</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">mark2</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">replaces previous mark</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">extract-current-continuation-marks</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">key</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(mark2)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">key</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">mark1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">continuation extended to evaluate the argument</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">key</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">mark2</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">extract-current-continuation-marks</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">key</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'((mark2 mark1))</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">1000</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">extract-current-continuation-marks</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">key</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">key</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(1)</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 8.4.0.2 of package <span class="stt">base</span>: Added the <span class="RktVar">realms?</span> argument.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="cont.html" title="backward to &quot;10.4 Continuations&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Control Flow&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="breakhandler.html" title="forward to &quot;10.6 Breaks&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/contract-utilities.html b/clones/docs.racket-lang.org/reference/contract-utilities.html
new file mode 100644
index 00000000..f293ed17
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/contract-utilities.html
@@ -0,0 +1,98 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>8.8&nbsp;Contract Utilities</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.1&nbsp;</td><td><a href="data-structure-contracts.html" class="tocviewlink" data-pltdoc="x">Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.2&nbsp;</td><td><a href="function-contracts.html" class="tocviewlink" data-pltdoc="x">Function Contracts</a></td></tr><tr><td align="right">8.3&nbsp;</td><td><a href="parametric-contracts.html" class="tocviewlink" data-pltdoc="x">Parametric Contracts</a></td></tr><tr><td align="right">8.4&nbsp;</td><td><a href="Lazy_Data-structure_Contracts.html" class="tocviewlink" data-pltdoc="x">Lazy Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.5&nbsp;</td><td><a href="Structure_Type_Property_Contracts.html" class="tocviewlink" data-pltdoc="x">Structure Type Property Contracts</a></td></tr><tr><td align="right">8.6&nbsp;</td><td><a href="attaching-contracts-to-values.html" class="tocviewlink" data-pltdoc="x">Attaching Contracts to Values</a></td></tr><tr><td align="right">8.7&nbsp;</td><td><a href="Building_New_Contract_Combinators.html" class="tocviewlink" data-pltdoc="x">Building New Contract Combinators</a></td></tr><tr><td align="right">8.8&nbsp;</td><td><a href="contract-utilities.html" class="tocviewselflink" data-pltdoc="x">Contract Utilities</a></td></tr><tr><td align="right">8.9&nbsp;</td><td><a href="racket_contract_base.html" class="tocviewlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>contract/<span class="mywbr"> &nbsp;</span>base</span></span></a></td></tr><tr><td align="right">8.10&nbsp;</td><td><a href="collapsible.html" class="tocviewlink" data-pltdoc="x">Collapsible Contracts</a></td></tr><tr><td align="right">8.11&nbsp;</td><td><a href="Legacy_Contracts.html" class="tocviewlink" data-pltdoc="x">Legacy Contracts</a></td></tr><tr><td align="right">8.12&nbsp;</td><td><a href="Random_generation.html" class="tocviewlink" data-pltdoc="x">Random generation</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract?</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._chaperone-contract~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-<wbr></wbr>contract?</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._impersonator-contract~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonator-<wbr></wbr>contract?</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flat-<wbr></wbr>contract?</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._list-contract~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-<wbr></wbr>contract?</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-name%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-<wbr></wbr>name</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._value-contract%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">value-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._has-contract~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">has-<wbr></wbr>contract?</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._value-blame%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">value-<wbr></wbr>blame</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._has-blame~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">has-<wbr></wbr>blame?</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-late-neg-projection%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-<wbr></wbr>late-<wbr></wbr>neg-<wbr></wbr>projection</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-projection%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-<wbr></wbr>projection</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-val-first-projection%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-<wbr></wbr>val-<wbr></wbr>first-<wbr></wbr>projection</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._make-none%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>none/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._recursive-contract%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">recursive-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fopt..rkt%29._opt%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">opt/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fopt..rkt%29._define-opt%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>opt/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-continuation-mark-key%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-<wbr></wbr>continuation-<wbr></wbr>mark-<wbr></wbr>key</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-custom-write-property-proc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-<wbr></wbr>custom-<wbr></wbr>write-<wbr></wbr>property-<wbr></wbr>proc</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._rename-contract%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">rename-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._contract-first-order-okay-to-give-up~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym">contract-<wbr></wbr>first-<wbr></wbr>order-<wbr></wbr>okay-<wbr></wbr>to-<wbr></wbr>give-<wbr></wbr>up?</span></a></td></tr><tr><td><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._contract-first-order-try-less-hard%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym">contract-<wbr></wbr>first-<wbr></wbr>order-<wbr></wbr>try-<wbr></wbr>less-<wbr></wbr>hard</span></a></td></tr><tr><td><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._if%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">if/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._failure-result%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">failure-<wbr></wbr>result/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._get%2Fbuild-val-first-projection%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get/<span class="mywbr"> &nbsp;</span>build-<wbr></wbr>val-<wbr></wbr>first-<wbr></wbr>projection</span></span></a></td></tr><tr><td><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._get%2Fbuild-late-neg-projection%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get/<span class="mywbr"> &nbsp;</span>build-<wbr></wbr>late-<wbr></wbr>neg-<wbr></wbr>projection</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Building_New_Contract_Combinators.html" title="backward to &quot;8.7 Building New Contract Combinators&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="racket_contract_base.html" title="forward to &quot;8.9 racket/contract/base&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contract-utilities&quot;">8.8<tt>&nbsp;</tt><a name="(part._contract-utilities)"></a>Contract Utilities</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._contract~3f))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">contract?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if its argument is a <a href="contracts.html#%28tech._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">contract</span></a> (i.e., constructed
+with one of the combinators described in this section or a value that
+can be used as a contract) and <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._chaperone-contract~3f))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._chaperone-contract~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">chaperone-contract?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if its argument is a <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contract</span></a>,
+i.e., one that guarantees that
+it returns a value which passes <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-of~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-of?</a></span> when compared to
+the original, uncontracted value.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._impersonator-contract~3f))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._impersonator-contract~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonator-contract?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if its argument is an <a href="contracts.html#%28tech._impersonator._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator contract</span></a>,
+i.e., a <a href="contracts.html#%28tech._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">contract</span></a> that is neither a <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contract</span></a>
+nor a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._flat-contract~3f))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">flat-contract?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> when its argument is a contract that can be
+checked immediately (unlike, say, a function contract).</div></p><p>For example,
+<span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._flat-contract%29%29" class="RktValLink" data-pltdoc="x">flat-contract</a></span> constructs <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a> from predicates, and
+symbols, booleans, numbers, and other ordinary Racket values
+(that are defined as <a href="contracts.html#%28tech._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">contracts</span></a>) are also
+<a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._list-contract~3f))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._list-contract~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">list-contract?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Recognizes certain <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span> values that accept <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span>s.</div></p><p>A list contract is one that insists that its argument
+is a <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span>, meaning that the value cannot be cyclic
+and must either be the empty list or a pair constructed
+with <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span> and another list.</p><p class="SHistory">Added in version 6.0.1.13 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._contract-name))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-name%29%29" class="RktValDef RktValLink" data-pltdoc="x">contract-name</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces the name used to describe the contract in error messages.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._value-contract))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._value-contract%29%29" class="RktValDef RktValLink" data-pltdoc="x">value-contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._has-contract~3f%29%29" class="RktValLink" data-pltdoc="x">has-contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the contract attached to <span class="RktVar">v</span>, if recorded.
+Otherwise it returns <span class="RktVal">#f</span>.</div></p><p>To support <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._value-contract%29%29" class="RktValLink" data-pltdoc="x">value-contract</a></span> and <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._value-contract%29%29" class="RktValLink" data-pltdoc="x">value-contract</a></span>
+in your own contract combinators, use <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._prop~3acontracted%29%29" class="RktValLink" data-pltdoc="x">prop:contracted</a></span> or
+<span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._impersonator-prop~3acontracted%29%29" class="RktValLink" data-pltdoc="x">impersonator-prop:contracted</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._has-contract~3f))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._has-contract~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">has-contract?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a value that
+has a recorded contract attached to it.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._value-blame))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._value-blame%29%29" class="RktValDef RktValLink" data-pltdoc="x">value-blame</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._has-blame~3f%29%29" class="RktValLink" data-pltdoc="x">has-blame?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <a href="Building_New_Contract_Combinators.html#%28tech._blame._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">blame object</span></a> for the contract attached
+to <span class="RktVar">v</span>, if recorded. Otherwise it returns <span class="RktVal">#f</span>.</div></p><p>To support <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._value-contract%29%29" class="RktValLink" data-pltdoc="x">value-contract</a></span> and <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._value-blame%29%29" class="RktValLink" data-pltdoc="x">value-blame</a></span>
+in your own contract combinators, use <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._prop~3ablame%29%29" class="RktValLink" data-pltdoc="x">prop:blame</a></span> or
+<span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._impersonator-prop~3ablame%29%29" class="RktValLink" data-pltdoc="x">impersonator-prop:blame</a></span>.</p><p class="SHistory">Added in version 6.0.1.12 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._has-blame~3f))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._has-blame~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">has-blame?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a value that
+has a contract with blame information attached to it.</div></p><p class="SHistory">Added in version 6.0.1.12 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._contract-late-neg-projection))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-late-neg-projection%29%29" class="RktValDef RktValLink" data-pltdoc="x">contract-late-neg-projection</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces the projection defining a contract&rsquo;s behavior.</div></p><p>The first argument, <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span> object encapsulates information about
+the contract checking, mostly used to create a meaningful error message if
+a contract violation is detected. The resulting function&rsquo;s first argument
+is the value that should have the contract and its second argument is
+a missing party for the <a href="Building_New_Contract_Combinators.html#%28tech._blame._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">blame object</span></a>, to be passed to <span class="RktSym"><a href="Legacy_Contracts.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._raise-contract-error%29%29" class="RktValLink" data-pltdoc="x">raise-contract-error</a></span>.</p><p>If possible, use this function instead of <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-val-first-projection%29%29" class="RktValLink" data-pltdoc="x">contract-val-first-projection</a></span> or
+<span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-projection%29%29" class="RktValLink" data-pltdoc="x">contract-projection</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._contract-projection))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-projection%29%29" class="RktValDef RktValLink" data-pltdoc="x">contract-projection</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a projection defining a contract&rsquo;s behavior.
+This projection is a curried function of two arguments: the first application
+accepts a blame object, and the second accepts a value to protect with the
+contract.</div></p><p>If possible, use <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-late-neg-projection%29%29" class="RktValLink" data-pltdoc="x">contract-late-neg-projection</a></span> instead.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._contract-val-first-projection))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-val-first-projection%29%29" class="RktValDef RktValLink" data-pltdoc="x">contract-val-first-projection</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a projection defining a contract&rsquo;s behavior.
+This projection is similar to the result of <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-late-neg-projection%29%29" class="RktValLink" data-pltdoc="x">contract-late-neg-projection</a></span>
+except with an extra layer of currying.</div></p><p>If possible, use <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-late-neg-projection%29%29" class="RktValLink" data-pltdoc="x">contract-late-neg-projection</a></span> instead.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._make-none/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._make-none%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-none/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sexp-name</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sexp-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Makes a contract that accepts no values, and reports the
+name <span class="RktVar">sexp-name</span> when signaling a contract violation.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/private/base..rkt)._recursive-contract))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._recursive-contract%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">recursive-contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">recursive-contract-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._recursive-contract%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">recursive-contract</a></span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">type</span><span class="hspace">&nbsp;</span><span class="RktVar">recursive-contract-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">recursive-contract-option</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:list-contract?</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:extra-delay</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">type</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:impersonator</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:chaperone</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:flat</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Delays the evaluation of its argument until the contract is checked,
+making recursive contracts possible.
+If <span class="RktVar">type</span> is not given, an impersonator contract is created.</div></p><p>If the <span class="RktVar">recursive-contract-option</span>
+<span class="RktPn">#:list-contract?</span> is given, then the result is a
+<span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._list-contract~3f%29%29" class="RktValLink" data-pltdoc="x">list-contract?</a></span> and the <span class="RktVar">contract-expr</span> must
+evaluate to a <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._list-contract~3f%29%29" class="RktValLink" data-pltdoc="x">list-contract?</a></span>.</p><p>If the <span class="RktVar">recursive-contract-option</span> <span class="RktPn">#:extra-delay</span> is given,
+then the <span class="RktVar">contract-expr</span> expression is evaluated only when the first
+value to be checked against the contract is supplied to the contract.
+Without it, the <span class="RktVar">contract-expr</span> is evaluated earlier. This option
+is supported only when <span class="RktVar">type</span> is <span class="RktPn">#:flat</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">even-length-list/c</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null~3f%29%29" class="RktValLink" data-pltdoc="x">null?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._recursive-contract%29%29" class="RktStxLink" data-pltdoc="x">recursive-contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">even-length-list/c</span><span class="hspace">&nbsp;</span><span class="RktPn">#:flat</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">even-length-list/c</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">A</span><span class="hspace">&nbsp;</span><span class="RktVal">B</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">even-length-list/c</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.0.1.13 of package <span class="stt">base</span>: Added the <span class="RktPn">#:list-contract?</span> option.<br/>Changed in version 6.7.0.3: Added the <span class="RktPn">#:extra-delay</span> option.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/private/opt..rkt)._opt/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fopt..rkt%29._opt%2Fc%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">opt/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-name</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">maybe-name</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:error-name</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">This optimizes its argument contract expression by
+traversing its syntax and, for known contract combinators,
+fuses them into a single contract combinator that avoids as
+much allocation overhead as possible. The result is a
+contract that should behave identically to its argument,
+except faster.</div></p><p>If the <span class="RktPn">#:error-name</span> argument is present, and
+<span class="RktVar">contract-expr</span> evaluates to a non-contract
+expression, then <span class="RktSym"><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fopt..rkt%29._opt%2Fc%29%29" class="RktStxLink" data-pltdoc="x">opt/c</a></span> raises an error using
+<span class="RktVar">id</span> as the name of the primitive, instead of using
+the name <span class="RktSym"><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fopt..rkt%29._opt%2Fc%29%29" class="RktStxLink" data-pltdoc="x">opt/c</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fopt..rkt%29._opt%2Fc%29%29" class="RktStxLink" data-pltdoc="x">opt/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">not-a-contract</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">opt/c: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: contract?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: '(not-a-contract)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fopt..rkt%29._opt%2Fc%29%29" class="RktStxLink" data-pltdoc="x">opt/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">not-a-contract</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:error-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">define/contract: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: contract?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: '(not-a-contract)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/private/opt..rkt)._define-opt/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fopt..rkt%29._define-opt%2Fc%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-opt/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">This defines a recursive contract and simultaneously
+optimizes it. As long as the defined function terminates,
+<span class="RktSym"><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fopt..rkt%29._define-opt%2Fc%29%29" class="RktStxLink" data-pltdoc="x">define-opt/c</a></span> behaves just as if
+the <span class="RktSym"><span class="nobreak">-o</span>pt/c</span> were not present, defining a function on
+contracts (except that the body expression must return a
+contract). But, it also optimizes that contract definition,
+avoiding extra allocation, much like <span class="RktSym"><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fopt..rkt%29._opt%2Fc%29%29" class="RktStxLink" data-pltdoc="x">opt/c</a></span> does.</div></p><p>For example,</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Lazy_Data-structure_Contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fds..rkt%29._define-contract-struct%29%29" class="RktStxLink" data-pltdoc="x">define-contract-struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktSym">left</span><span class="hspace">&nbsp;</span><span class="RktSym">right</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fopt..rkt%29._define-opt%2Fc%29%29" class="RktStxLink" data-pltdoc="x">define-opt/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bst-between/c</span><span class="hspace">&nbsp;</span><span class="RktSym">lo</span><span class="hspace">&nbsp;</span><span class="RktSym">hi</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null~3f%29%29" class="RktValLink" data-pltdoc="x">null?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bt/c</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._real-in%29%29" class="RktValLink" data-pltdoc="x">real-in</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lo</span><span class="hspace">&nbsp;</span><span class="RktSym">hi</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">left</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bst-between/c</span><span class="hspace">&nbsp;</span><span class="RktSym">lo</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">right</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bst-between/c</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktSym">hi</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bst/c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bst-between/c</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-i</span>nf.0</span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>defines the <span class="RktSym">bst/c</span> contract that checks the binary
+search tree invariant. Removing the <span class="RktSym"><span class="nobreak">-o</span>pt/c</span> also
+makes a binary search tree contract, but one that is
+(approximately) 20 times slower.</p><p>Note that in some cases, a call to a function defined by
+<span class="RktSym"><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fopt..rkt%29._define-opt%2Fc%29%29" class="RktStxLink" data-pltdoc="x">define-opt/c</a></span> may terminate, even if the corresponding
+<span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span>-based function would not terminate. This is a
+shortcoming in <span class="RktSym"><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fopt..rkt%29._define-opt%2Fc%29%29" class="RktStxLink" data-pltdoc="x">define-opt/c</a></span> that we hope to understand
+and fix at some point, but have no concrete plans currently.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/contract/private/guts..rkt)._contract-continuation-mark-key))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-continuation-mark-key%29%29" class="RktValDef RktValLink" data-pltdoc="x">contract-continuation-mark-key</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-key~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-key?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Key used by continuation marks that are present during contract checking.
+The value of these marks are the <a href="Building_New_Contract_Combinators.html#%28tech._blame._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">blame objects</span></a> that correspond to the contract
+currently being checked.</div></p><p class="SHistory">Added in version 6.4.0.4 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._contract-custom-write-property-proc))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-custom-write-property-proc%29%29" class="RktValDef RktValLink" data-pltdoc="x">contract-custom-write-property-proc</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">c</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">p</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">mode</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Prints <span class="RktVar">c</span> to <span class="RktVar">p</span> using the contract&rsquo;s name.</div></p><p class="SHistory">Added in version 6.1.1.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._rename-contract))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._rename-contract%29%29" class="RktValDef RktValLink" data-pltdoc="x">rename-contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">contract</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">contract</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a contract that acts like <span class="RktVar">contract</span> but with the name
+<span class="RktVar">name</span>.</div></p><p>The resulting contract is a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> if <span class="RktVar">contract</span> is a
+<a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>.</p><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/private/base..rkt)._contract-first-order-okay-to-give-up~3f))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><span class="RktSymDef RktSym">contract-first-order-okay-to-give-up?</span></span></span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">This form returns a boolean that controls the result
+of first-order contact checks. More specifically, if
+it returns <span class="RktVal">#t</span>, then a first-order check may
+return <span class="RktVal">#t</span> even when the entire first-order
+checks have not happened. If it returns <span class="RktVal">#f</span>
+then the first order checks must continue until a
+definitive answer is returned.</div></p><p>This will only return <span class="RktVal">#t</span> in the dynamic
+extent of <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span> or <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._first-or%2Fc%29%29" class="RktValLink" data-pltdoc="x">first-or/c</a></span>&rsquo;s
+checking to determine which branch to use.</p><p><div class="SIntrapara"><p class="SHistory">Added in version 6.3.0.9 of package <span class="stt">base</span>.</p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/private/base..rkt)._contract-first-order-try-less-hard))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><span class="RktSymDef RktSym">contract-first-order-try-less-hard</span></span></span><span class="hspace">&nbsp;</span><span class="RktVar">e</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Encourages first-order checks that happen in the
+dynamic-extent of <span class="RktVar">e</span> to be more likely to
+give up. That is, makes it more likely that
+<span class="RktSym">contract-first-order-okay-to-give-up?</span> might
+return <span class="RktVal">#t</span>.</div></p><p>If not in the dynamic-extent of <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span>&rsquo;s or
+<span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._first-or%2Fc%29%29" class="RktValLink" data-pltdoc="x">first-or/c</a></span>&rsquo;s checking to determine the branch,
+then this form has no effect.</p><p class="SHistory">Added in version 6.3.0.9 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._if/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._if%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">if/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">predicate</span><span class="hspace">&nbsp;</span><span class="RktVar">then-contract</span><span class="hspace">&nbsp;</span><span class="RktVar">else-contract</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">predicate</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">then-contract</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">else-contract</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a contract that, when applied to a value, first tests the
+value with <span class="RktVar">predicate</span>; if <span class="RktVar">predicate</span> returns true, the
+<span class="RktVar">then-contract</span> is applied; otherwise, the
+<span class="RktVar">else-contract</span> is applied. The resulting contract is a
+<a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> if both <span class="RktVar">then-contract</span> and <span class="RktVar">else-contract</span> are
+<a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a>.</div></p><p><div class="SIntrapara">For example, the following contract enforces that if a value is a
+procedure, it is a thunk; otherwise it can be any (non-procedure)
+value:
+  </div><div class="SIntrapara"><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._if%2Fc%29%29" class="RktValLink" data-pltdoc="x">if/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></div><div class="SIntrapara">Note that the following contract is <span style="font-weight: bold">not</span> equivalent:
+  </div><div class="SIntrapara"><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">wrong!</span></p></blockquote></div><div class="SIntrapara">The last contract is the same as <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span> because
+<span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span> tries <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a> before higher-order contracts.</div></p><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/contract/base..rkt)._failure-result/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._failure-result%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">failure-result/c</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A contract that describes the failure result arguments of procedures
+such as <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span>.</div></p><p>Equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._if%2Fc%29%29" class="RktValLink" data-pltdoc="x">if/c</a></span><span class="stt"> </span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span>.</p><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._get/build-val-first-projection))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._get%2Fbuild-val-first-projection%29%29" class="RktValDef RktValLink" data-pltdoc="x">get/build-val-first-projection</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <span class="RktVar">val-first</span> projection for <span class="RktVar">c</span>.</div></p><p>See <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._make-contract%29%29" class="RktValLink" data-pltdoc="x">make-contract</a></span> for more details.</p><p class="SHistory">Added in version 6.1.1.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/guts..rkt)._get/build-late-neg-projection))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._get%2Fbuild-late-neg-projection%29%29" class="RktValDef RktValLink" data-pltdoc="x">get/build-late-neg-projection</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <span class="RktVar">late-neg</span> projection for <span class="RktVar">c</span>.</div></p><p>If <span class="RktVar">c</span> does not have a <span class="RktVar">late-neg</span> contract,
+then this function uses the original projection for it
+and logs a warning to the <span class="RktVal">'</span><span class="RktVal">racket/contract</span> logger.</p><p>See <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._make-contract%29%29" class="RktValLink" data-pltdoc="x">make-contract</a></span> for more details.</p><p class="SHistory">Added in version 6.2.900.11 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Building_New_Contract_Combinators.html" title="backward to &quot;8.7 Building New Contract Combinators&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="racket_contract_base.html" title="forward to &quot;8.9 racket/contract/base&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/contracts.html b/clones/docs.racket-lang.org/reference/contracts.html
new file mode 100644
index 00000000..a8566ffc
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/contracts.html
@@ -0,0 +1,47 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>8&nbsp;Contracts</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>8&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.1&nbsp;</td><td><a href="data-structure-contracts.html" class="tocviewlink" data-pltdoc="x">Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.2&nbsp;</td><td><a href="function-contracts.html" class="tocviewlink" data-pltdoc="x">Function Contracts</a></td></tr><tr><td align="right">8.3&nbsp;</td><td><a href="parametric-contracts.html" class="tocviewlink" data-pltdoc="x">Parametric Contracts</a></td></tr><tr><td align="right">8.4&nbsp;</td><td><a href="Lazy_Data-structure_Contracts.html" class="tocviewlink" data-pltdoc="x">Lazy Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.5&nbsp;</td><td><a href="Structure_Type_Property_Contracts.html" class="tocviewlink" data-pltdoc="x">Structure Type Property Contracts</a></td></tr><tr><td align="right">8.6&nbsp;</td><td><a href="attaching-contracts-to-values.html" class="tocviewlink" data-pltdoc="x">Attaching Contracts to Values</a></td></tr><tr><td align="right">8.7&nbsp;</td><td><a href="Building_New_Contract_Combinators.html" class="tocviewlink" data-pltdoc="x">Building New Contract Combinators</a></td></tr><tr><td align="right">8.8&nbsp;</td><td><a href="contract-utilities.html" class="tocviewlink" data-pltdoc="x">Contract Utilities</a></td></tr><tr><td align="right">8.9&nbsp;</td><td><a href="racket_contract_base.html" class="tocviewlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>contract/<span class="mywbr"> &nbsp;</span>base</span></span></a></td></tr><tr><td align="right">8.10&nbsp;</td><td><a href="collapsible.html" class="tocviewlink" data-pltdoc="x">Collapsible Contracts</a></td></tr><tr><td align="right">8.11&nbsp;</td><td><a href="Legacy_Contracts.html" class="tocviewlink" data-pltdoc="x">Legacy Contracts</a></td></tr><tr><td align="right">8.12&nbsp;</td><td><a href="Random_generation.html" class="tocviewlink" data-pltdoc="x">Random generation</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Transformer_Helpers.html" title="backward to &quot;7.12 Transformer Helpers&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="data-structure-contracts.html" title="forward to &quot;8.1 Data-structure Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts&quot;">8<tt>&nbsp;</tt><a name="(part._contracts)"></a><a name="(mod-path._racket/contract)"></a>Contracts</h3><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=contracts.html&amp;version=8.6" class="Sq" data-pltdoc="x">Contracts</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces contracts.</p></blockquote></blockquote></blockquote><p>The contract system guards one part of a program from
+another. Programmers specify the behavior of a module&rsquo;s exports via
+<span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._contract-out%29%29" class="RktStxLink" data-pltdoc="x">contract-out</a></span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span>, and the contract system enforces those
+constraints.</p><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="contracts.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/contract</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="contracts.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/contract</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p><div class="SIntrapara"><a name="(tech._contract)"></a><span style="font-style: italic">Contracts</span> come in two forms: those constructed by the
+various operations listed in this section of the manual, and various
+ordinary Racket values that double as contracts, including
+</div><div class="SIntrapara"><ul><li><p><a href="symbols.html#%28tech._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">symbols</span></a>, <a href="booleans.html#%28tech._boolean%29" class="techoutside" data-pltdoc="x"><span class="techinside">booleans</span></a>, <a href="keywords.html#%28tech._keyword%29" class="techoutside" data-pltdoc="x"><span class="techinside">keywords</span></a>, and
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span>, which are treated as contracts that recognize
+themselves, using <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>, </p></li><li><p><a href="strings.html#%28tech._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">strings</span></a>, <a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte strings</span></a>, <a href="characters.html#%28tech._character%29" class="techoutside" data-pltdoc="x"><span class="techinside">characters</span></a>,
+<span class="RktVal">+nan.0</span>, and <span class="RktVal">+nan.f</span>, which are treated
+as contracts that recognize themselves using <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>, </p></li><li><p><a href="numbers.html#%28tech._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">numbers</span></a> (except <span class="RktVal">+nan.0</span> and
+       <span class="RktVal">+nan.f</span>), which are treated as contracts
+that recognize themselves using <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span>,</p></li><li><p><a href="regexp.html#%28tech._regular._expression%29" class="techoutside" data-pltdoc="x"><span class="techinside">regular expressions</span></a>, which are treated as contracts
+ that recognize <a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte strings</span></a> and <a href="strings.html#%28tech._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">strings</span></a> that
+ match the regular expression, and </p></li><li><p>predicates: any procedure of arity 1 is treated as a
+predicate. During contract checking, it is applied to the values that
+appear and should return <span class="RktVal">#f</span> to indicate that the contract
+failed, and anything else to indicate it passed.</p></li></ul></div></p><p><a name="(tech._contract._combinator)"></a><span style="font-style: italic">Contract combinators</span> are functions such as <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span> and
+<span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span> that take contracts and produce other contracts.</p><p><div class="SIntrapara">Contracts in Racket are subdivided into three different categories:
+</div><div class="SIntrapara"><ul><li><p><a name="(tech._flat._contract)"></a><span style="font-style: italic">Flat <a href="contracts.html#%28tech._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">contracts</span></a></span> can be fully checked immediately for
+ a given value. These kinds of <a href="contracts.html#%28tech._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">contracts</span></a> are essentially
+ predicate functions. Using <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._flat-contract-predicate%29%29" class="RktValLink" data-pltdoc="x">flat-contract-predicate</a></span>,
+ you can extract the predicate from an arbitrary flat contract; some
+ flat contracts can be applied like functions, in which case
+ they accept a single argument and return <span class="RktVal">#t</span> or
+ <span class="RktVal">#f</span> to indicate if the given value would be accepted
+ by the contract. All of the flat contracts returned by functions
+ in this library can be used directly as predicates, but ordinary
+ Racket values that double as flat contracts (e.g., numbers or symbols)
+ cannot.</p><p>The function <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span> recognizes a flat contract.</p></li><li><p><a name="(tech._chaperone._contract)"></a><span style="font-style: italic">Chaperone <a href="contracts.html#%28tech._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">contracts</span></a></span> may wrap a value in such
+ a way that it signals contract violations later, as the value
+ is used, but are guaranteed to not otherwise change behavior.
+ For example, a function contract wraps a function value and
+ later checks inputs and outputs; any properties that the
+ function value had before being wrapped by the contract are
+ preserved by the contract wrapper.</p><p>All <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a> may be used where <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contracts</span></a> are expected
+ (but not vice-versa). The function <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._chaperone-contract~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-contract?</a></span>
+ recognizes a chaperone contract.</p></li><li><p><a name="(tech._impersonator._contract)"></a><span style="font-style: italic">Impersonator <a href="contracts.html#%28tech._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">contracts</span></a></span> may wrap values and do
+ not provide any guarantees. Impersonator contracts
+ may hide properties of values, or even make them completely
+ opaque (e.g, <span class="RktSym"><a href="parametric-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._new-~e2~88~80%2Fc%29%29" class="RktValLink" data-pltdoc="x">new-&#8704;/c</a></span>).</p><p>All <a href="contracts.html#%28tech._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">contracts</span></a> may be used where impersonator contracts are expected.
+ The function <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._impersonator-contract~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-contract?</a></span> recognizes an
+ impersonator contract.</p></li></ul></div></p><p>For more about this hierarchy, see the section &ldquo;<a href="chaperones.html" data-pltdoc="x">Impersonators and Chaperones</a>&rdquo;
+as well as a research paper [<a href="doc-bibliography.html#%28cite._.Strickland12%29" data-pltdoc="x">Strickland12</a>] on chaperones, impersonators,
+and how they can be used to implement contracts.</p><p class="SHistory">Changed in version 6.1.1.8 of package <span class="stt">base</span>: Changed <span class="RktVal">+nan.0</span> and <span class="RktVal">+nan.f</span> to
+        be <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>-based contracts.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="data-structure-contracts.html" class="toclink" data-pltdoc="x">8.1<span class="hspace">&nbsp;</span>Data-structure Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="function-contracts.html" class="toclink" data-pltdoc="x">8.2<span class="hspace">&nbsp;</span>Function Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="parametric-contracts.html" class="toclink" data-pltdoc="x">8.3<span class="hspace">&nbsp;</span>Parametric Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Lazy_Data-structure_Contracts.html" class="toclink" data-pltdoc="x">8.4<span class="hspace">&nbsp;</span>Lazy Data-structure Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Structure_Type_Property_Contracts.html" class="toclink" data-pltdoc="x">8.5<span class="hspace">&nbsp;</span>Structure Type Property Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="attaching-contracts-to-values.html" class="toclink" data-pltdoc="x">8.6<span class="hspace">&nbsp;</span>Attaching Contracts to Values</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="attaching-contracts-to-values.html#%28part._.Nested_.Contract_.Boundaries%29" class="toclink" data-pltdoc="x">8.6.1<span class="hspace">&nbsp;</span>Nested Contract Boundaries</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="attaching-contracts-to-values.html#%28part._.Low-level_.Contract_.Boundaries%29" class="toclink" data-pltdoc="x">8.6.2<span class="hspace">&nbsp;</span>Low-level Contract Boundaries</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Building_New_Contract_Combinators.html" class="toclink" data-pltdoc="x">8.7<span class="hspace">&nbsp;</span>Building New Contract Combinators</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Building_New_Contract_Combinators.html#%28part._.Blame_.Objects%29" class="toclink" data-pltdoc="x">8.7.1<span class="hspace">&nbsp;</span>Blame Objects</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Building_New_Contract_Combinators.html#%28part._.Contracts_as_structs%29" class="toclink" data-pltdoc="x">8.7.2<span class="hspace">&nbsp;</span>Contracts as structs</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Building_New_Contract_Combinators.html#%28part._.Obligation_.Information_in_.Check_.Syntax%29" class="toclink" data-pltdoc="x">8.7.3<span class="hspace">&nbsp;</span>Obligation Information in Check Syntax</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Building_New_Contract_Combinators.html#%28part._.Utilities_for_.Building_.New_.Combinators%29" class="toclink" data-pltdoc="x">8.7.4<span class="hspace">&nbsp;</span>Utilities for Building New Combinators</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-utilities.html" class="toclink" data-pltdoc="x">8.8<span class="hspace">&nbsp;</span>Contract Utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="racket_contract_base.html" class="toclink" data-pltdoc="x">8.9<span class="hspace">&nbsp;</span><span class="RktModLink"><span class="RktSym">racket/contract/base</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="collapsible.html" class="toclink" data-pltdoc="x">8.10<span class="hspace">&nbsp;</span>Collapsible Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Legacy_Contracts.html" class="toclink" data-pltdoc="x">8.11<span class="hspace">&nbsp;</span>Legacy Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Random_generation.html" class="toclink" data-pltdoc="x">8.12<span class="hspace">&nbsp;</span>Random generation</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Transformer_Helpers.html" title="backward to &quot;7.12 Transformer Helpers&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="data-structure-contracts.html" title="forward to &quot;8.1 Data-structure Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/control.html b/clones/docs.racket-lang.org/reference/control.html
new file mode 100644
index 00000000..3dae2f71
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/control.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>10&nbsp;Control Flow</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewselflink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>10&nbsp;</td><td><a href="control.html" class="tocviewselflink" data-pltdoc="x">Control Flow</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">10.1&nbsp;</td><td><a href="values.html" class="tocviewlink" data-pltdoc="x">Multiple Values</a></td></tr><tr><td align="right">10.2&nbsp;</td><td><a href="exns.html" class="tocviewlink" data-pltdoc="x">Exceptions</a></td></tr><tr><td align="right">10.3&nbsp;</td><td><a href="Delayed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Delayed Evaluation</a></td></tr><tr><td align="right">10.4&nbsp;</td><td><a href="cont.html" class="tocviewlink" data-pltdoc="x">Continuations</a></td></tr><tr><td align="right">10.5&nbsp;</td><td><a href="contmarks.html" class="tocviewlink" data-pltdoc="x">Continuation Marks</a></td></tr><tr><td align="right">10.6&nbsp;</td><td><a href="breakhandler.html" class="tocviewlink" data-pltdoc="x">Breaks</a></td></tr><tr><td align="right">10.7&nbsp;</td><td><a href="Exiting.html" class="tocviewlink" data-pltdoc="x">Exiting</a></td></tr><tr><td align="right">10.8&nbsp;</td><td><a href="unreachable.html" class="tocviewlink" data-pltdoc="x">Unreachable Expressions</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="match.html" title="backward to &quot;9 Pattern Matching&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="values.html" title="forward to &quot;10.1 Multiple Values&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;control&quot;">10<tt>&nbsp;</tt><a name="(part._control)"></a>Control Flow</h3><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="values.html" class="toclink" data-pltdoc="x">10.1<span class="hspace">&nbsp;</span>Multiple Values</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="exns.html" class="toclink" data-pltdoc="x">10.2<span class="hspace">&nbsp;</span>Exceptions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="exns.html#%28part._err-msg-conventions%29" class="toclink" data-pltdoc="x">10.2.1<span class="hspace">&nbsp;</span>Error Message Conventions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="exns.html#%28part._errorproc%29" class="toclink" data-pltdoc="x">10.2.2<span class="hspace">&nbsp;</span>Raising Exceptions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="exns.html#%28part._.Handling_.Exceptions%29" class="toclink" data-pltdoc="x">10.2.3<span class="hspace">&nbsp;</span>Handling Exceptions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="exns.html#%28part._.Configuring_.Default_.Handling%29" class="toclink" data-pltdoc="x">10.2.4<span class="hspace">&nbsp;</span>Configuring Default Handling</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="exns.html#%28part._.Built-in_.Exception_.Types%29" class="toclink" data-pltdoc="x">10.2.5<span class="hspace">&nbsp;</span>Built-in Exception Types</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="exns.html#%28part._.Additional_.Exception_.Functions%29" class="toclink" data-pltdoc="x">10.2.6<span class="hspace">&nbsp;</span>Additional Exception Functions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="exns.html#%28part._err-realm%29" class="toclink" data-pltdoc="x">10.2.7<span class="hspace">&nbsp;</span>Realms and Error Message Adjusters</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Delayed_Evaluation.html" class="toclink" data-pltdoc="x">10.3<span class="hspace">&nbsp;</span>Delayed Evaluation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Delayed_Evaluation.html#%28part._.Additional_.Promise_.Kinds%29" class="toclink" data-pltdoc="x">10.3.1<span class="hspace">&nbsp;</span>Additional Promise Kinds</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="cont.html" class="toclink" data-pltdoc="x">10.4<span class="hspace">&nbsp;</span>Continuations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="cont.html#%28part._.Additional_.Control_.Operators%29" class="toclink" data-pltdoc="x">10.4.1<span class="hspace">&nbsp;</span>Additional Control Operators</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contmarks.html" class="toclink" data-pltdoc="x">10.5<span class="hspace">&nbsp;</span>Continuation Marks</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="breakhandler.html" class="toclink" data-pltdoc="x">10.6<span class="hspace">&nbsp;</span>Breaks</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Exiting.html" class="toclink" data-pltdoc="x">10.7<span class="hspace">&nbsp;</span>Exiting</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="unreachable.html" class="toclink" data-pltdoc="x">10.8<span class="hspace">&nbsp;</span>Unreachable Expressions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="unreachable.html#%28part._with-unreachable%29" class="toclink" data-pltdoc="x">10.8.1<span class="hspace">&nbsp;</span>Customized Unreachable Reporting</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="match.html" title="backward to &quot;9 Pattern Matching&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="values.html" title="forward to &quot;10.1 Multiple Values&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/createclass.html b/clones/docs.racket-lang.org/reference/createclass.html
new file mode 100644
index 00000000..790fb0a4
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/createclass.html
@@ -0,0 +1,324 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6.2&nbsp;Creating Classes</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewselflink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="createinterface.html" class="tocviewlink" data-pltdoc="x">Creating Interfaces</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="createclass.html" class="tocviewselflink" data-pltdoc="x">Creating Classes</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="objcreation.html" class="tocviewlink" data-pltdoc="x">Creating Objects</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="ivaraccess.html" class="tocviewlink" data-pltdoc="x">Field and Method Access</a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="mixins.html" class="tocviewlink" data-pltdoc="x">Mixins</a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="trait.html" class="tocviewlink" data-pltdoc="x">Traits</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="Object_and_Class_Contracts.html" class="tocviewlink" data-pltdoc="x">Object and Class Contracts</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="objectequality.html" class="tocviewlink" data-pltdoc="x">Object Equality and Hashing</a></td></tr><tr><td align="right">6.9&nbsp;</td><td><a href="objectserialize.html" class="tocviewlink" data-pltdoc="x">Object Serialization</a></td></tr><tr><td align="right">6.10&nbsp;</td><td><a href="objectprinting.html" class="tocviewlink" data-pltdoc="x">Object Printing</a></td></tr><tr><td align="right">6.11&nbsp;</td><td><a href="objectutils.html" class="tocviewlink" data-pltdoc="x">Object, Class, and Interface Utilities</a></td></tr><tr><td align="right">6.12&nbsp;</td><td><a href="Surrogates.html" class="tocviewlink" data-pltdoc="x">Surrogates</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>6.2&nbsp;</td><td><a href="createclass.html" class="tocviewselflink" data-pltdoc="x">Creating Classes</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.2.1&nbsp;</td><td><a href="createclass.html#%28part._clinitvars%29" class="tocviewlink" data-pltdoc="x">Initialization Variables</a></td></tr><tr><td align="right">6.2.2&nbsp;</td><td><a href="createclass.html#%28part._clfields%29" class="tocviewlink" data-pltdoc="x">Fields</a></td></tr><tr><td align="right">6.2.3&nbsp;</td><td><a href="createclass.html#%28part._clmethods%29" class="tocviewlink" data-pltdoc="x">Methods</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">object%</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">class*</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">class</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">this</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this~25%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">this%</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inspect%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">inspect</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">init</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-field%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">init-<wbr></wbr>field</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">field</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit-field%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">inherit-<wbr></wbr>field</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-rest%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">init-<wbr></wbr>rest</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">public</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._pubment%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">pubment</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public-final%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">public-<wbr></wbr>final</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">override</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">overment</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">override-<wbr></wbr>final</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">augment</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">augride</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment-final%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">augment-<wbr></wbr>final</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._private%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">private</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._abstract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">abstract</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">inherit</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Fsuper%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">inherit/<span class="mywbr"> &nbsp;</span>super</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Finner%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">inherit/<span class="mywbr"> &nbsp;</span>inner</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-super%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">rename-<wbr></wbr>super</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-inner%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">rename-<wbr></wbr>inner</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">public*</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._pubment%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">pubment*</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public-final%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">public-<wbr></wbr>final*</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">override*</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">overment*</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">override-<wbr></wbr>final*</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">augment*</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">augride*</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment-final%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">augment-<wbr></wbr>final*</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._private%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">private*</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/<span class="mywbr"> &nbsp;</span>public</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpubment%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/<span class="mywbr"> &nbsp;</span>pubment</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic-final%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/<span class="mywbr"> &nbsp;</span>public-<wbr></wbr>final</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Foverride%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/<span class="mywbr"> &nbsp;</span>override</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Foverment%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/<span class="mywbr"> &nbsp;</span>overment</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Foverride-final%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/<span class="mywbr"> &nbsp;</span>override-<wbr></wbr>final</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Faugment%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/<span class="mywbr"> &nbsp;</span>augment</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Faugride%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/<span class="mywbr"> &nbsp;</span>augride</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Faugment-final%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/<span class="mywbr"> &nbsp;</span>augment-<wbr></wbr>final</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fprivate%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/<span class="mywbr"> &nbsp;</span>private</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2Fderived%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">class/<span class="mywbr"> &nbsp;</span>derived</span></span></a></td></tr><tr><td><span class="tocsublinknumber">6.2.1<tt>&nbsp;</tt></span><a href="createclass.html#%28part._clinitvars%29" class="tocsubseclink" data-pltdoc="x">Initialization Variables</a></td></tr><tr><td><span class="tocsublinknumber">6.2.2<tt>&nbsp;</tt></span><a href="createclass.html#%28part._clfields%29" class="tocsubseclink" data-pltdoc="x">Fields</a></td></tr><tr><td><span class="tocsublinknumber">6.2.3<tt>&nbsp;</tt></span><a href="createclass.html#%28part._clmethods%29" class="tocsubseclink" data-pltdoc="x">Methods</a></td></tr><tr><td><span class="tocsublinknumber">6.2.3.1<tt>&nbsp;</tt></span><a href="createclass.html#%28part._clmethoddefs%29" class="tocsubseclink" data-pltdoc="x">Method Definitions</a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">super</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inner%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">inner</span></span></a></td></tr><tr><td><span class="tocsublinknumber">6.2.3.2<tt>&nbsp;</tt></span><a href="createclass.html#%28part._classinherit%29" class="tocsubseclink" data-pltdoc="x">Inherited and Superclass Methods</a></td></tr><tr><td><span class="tocsublinknumber">6.2.3.3<tt>&nbsp;</tt></span><a href="createclass.html#%28part._extnames%29" class="tocsubseclink" data-pltdoc="x">Internal and External Names</a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-local-member-name%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>local-<wbr></wbr>member-<wbr></wbr>name</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-member-name%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>member-<wbr></wbr>name</span></span></a></td></tr><tr><td><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">member-<wbr></wbr>name-<wbr></wbr>key</span></span></a></td></tr><tr><td><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._generate-member-key%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">generate-<wbr></wbr>member-<wbr></wbr>key</span></span></a></td></tr><tr><td><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">member-<wbr></wbr>name-<wbr></wbr>key?</span></span></a></td></tr><tr><td><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">member-<wbr></wbr>name-<wbr></wbr>key=?</span></span></a></td></tr><tr><td><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key-hash-code%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">member-<wbr></wbr>name-<wbr></wbr>key-<wbr></wbr>hash-<wbr></wbr>code</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="createinterface.html" title="backward to &quot;6.1 Creating Interfaces&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="objcreation.html" title="forward to &quot;6.3 Creating Objects&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;createclass&quot;">6.2<tt>&nbsp;</tt><a name="(part._createclass)"></a>Creating Classes</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=classes.html&amp;version=8.6" class="Sq" data-pltdoc="x">Classes and Objects</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces classes and objects.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/private/class-internal..rkt)._object~25))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValDef RktValLink" data-pltdoc="x">object%</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A built-in class that has no methods fields, implements only its own
+interface <span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-~3einterface%29%29" class="RktValLink" data-pltdoc="x">class-&gt;interface</a></span><span class="stt"> </span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="RktPn">)</span>, and is transparent
+(i.e,. its inspector is <span class="RktVal">#f</span>, so all immediate instances are
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>). All other classes are derived from <span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._class*))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">class*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">superclass-expr</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">interface-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">class-clause</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">class-clause</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inspect%29%29" class="RktStxLink" data-pltdoc="x">inspect</a></span><span class="hspace">&nbsp;</span><span class="RktVar">inspector-expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init%29%29" class="RktStxLink" data-pltdoc="x">init</a></span><span class="hspace">&nbsp;</span><span class="RktVar">init-decl</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-field%29%29" class="RktStxLink" data-pltdoc="x">init-field</a></span><span class="hspace">&nbsp;</span><span class="RktVar">init-decl</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktVar">field-decl</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit-field%29%29" class="RktStxLink" data-pltdoc="x">inherit-field</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-rest%29%29" class="RktStxLink" data-pltdoc="x">init-rest</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-rest%29%29" class="RktStxLink" data-pltdoc="x">init-rest</a></span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%29%29" class="RktStxLink" data-pltdoc="x">public</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._pubment%29%29" class="RktStxLink" data-pltdoc="x">pubment</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public-final%29%29" class="RktStxLink" data-pltdoc="x">public-final</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="RktStxLink" data-pltdoc="x">overment</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%29%29" class="RktStxLink" data-pltdoc="x">override-final</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%29%29" class="RktStxLink" data-pltdoc="x">augride</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment-final%29%29" class="RktStxLink" data-pltdoc="x">augment-final</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._private%29%29" class="RktStxLink" data-pltdoc="x">private</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._abstract%29%29" class="RktStxLink" data-pltdoc="x">abstract</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Fsuper%29%29" class="RktStxLink" data-pltdoc="x">inherit/super</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Finner%29%29" class="RktStxLink" data-pltdoc="x">inherit/inner</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-super%29%29" class="RktStxLink" data-pltdoc="x">rename-super</a></span><span class="hspace">&nbsp;</span><span class="RktVar">renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-inner%29%29" class="RktStxLink" data-pltdoc="x">rename-inner</a></span><span class="hspace">&nbsp;</span><span class="RktVar">renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">method-definition</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">definition</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktVar">class-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">init-decl</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">renamed</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktVar">default-value-expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">field-decl</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktVar">default-value-expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">maybe-renamed</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">renamed</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">renamed</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">internal-id</span><span class="hspace">&nbsp;</span><span class="RktVar">external-id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">method-definition</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">method-procedure</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">method-procedure</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktVar">kw-formals</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">formals</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-lambda%29%29" class="RktStxLink" data-pltdoc="x">#%plain-lambda</a></span><span class="hspace">&nbsp;</span><span class="RktVar">formals</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">method-procedure</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">method-procedure</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-values%29%29" class="RktStxLink" data-pltdoc="x">letrec-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">method-procedure</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">method-procedure</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">method-procedure</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-values%29%29" class="RktStxLink" data-pltdoc="x">letrec-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">method-procedure</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._chaperone-procedure%29%29" class="RktValLink" data-pltdoc="x">chaperone-procedure</a></span><span class="hspace">&nbsp;</span><span class="RktVar">method-procedure</span><span class="hspace">&nbsp;</span><span class="RktVar">wrapper-proc</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">other-arg-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Produces a class value.</div></p><p>The <span class="RktVar">superclass-expr</span> expression is evaluated when the
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> expression is evaluated. The result must be a class
+value (possibly <span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span>), otherwise the
+<span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised.  The result of the
+<span class="RktVar">superclass-expr</span> expression is the new class&rsquo;s superclass.</p><p>The <span class="RktVar">interface-expr</span> expressions are also evaluated when the
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> expression is evaluated, after
+<span class="RktVar">superclass-expr</span> is evaluated. The result of each
+<span class="RktVar">interface-expr</span> must be an interface value, otherwise the
+<span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised.  The interfaces returned by the
+<span class="RktVar">interface-expr</span>s are all implemented by the class. For each
+identifier in each interface, the class (or one of its ancestors) must
+declare a public method with the same name, otherwise the
+<span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised. The class&rsquo;s superclass must satisfy the
+implementation requirement of each interface, otherwise the
+<span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised.</p><p>An <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inspect%29%29" class="RktStxLink" data-pltdoc="x">inspect</a></span> <span class="RktVar">class-clause</span> selects an inspector (see
+<a href="inspectors.html" data-pltdoc="x">Structure Inspectors</a>) for the class extension. The
+<span class="RktVar">inspector-expr</span> must evaluate to an inspector or <span class="RktVal">#f</span>
+when the <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is evaluated. Just as for structure
+types, an inspector controls access to the class&rsquo;s fields, including
+private fields, and also affects comparisons using <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>. If
+no <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inspect%29%29" class="RktStxLink" data-pltdoc="x">inspect</a></span> clause is provided, access to the class is
+controlled by the parent of the current inspector (see
+<a href="inspectors.html" data-pltdoc="x">Structure Inspectors</a>). A syntax error is reported if more than one
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inspect%29%29" class="RktStxLink" data-pltdoc="x">inspect</a></span> clause is specified.</p><p>The other <span class="RktVar">class-clause</span>s define initialization arguments,
+public and private fields, and public and private methods. For each
+<span class="RktVar">id</span> or <span class="RktVar">maybe-renamed</span> in a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%29%29" class="RktStxLink" data-pltdoc="x">public</a></span>,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._pubment%29%29" class="RktStxLink" data-pltdoc="x">pubment</a></span>,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="RktStxLink" data-pltdoc="x">overment</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%29%29" class="RktStxLink" data-pltdoc="x">augride</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public-final%29%29" class="RktStxLink" data-pltdoc="x">public-final</a></span>,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%29%29" class="RktStxLink" data-pltdoc="x">override-final</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment-final%29%29" class="RktStxLink" data-pltdoc="x">augment-final</a></span>, or <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._private%29%29" class="RktStxLink" data-pltdoc="x">private</a></span>
+clause, there must be one <span class="RktVar">method-definition</span>. All other
+definition <span class="RktVar">class-clause</span>s create private fields. All remaining
+<span class="RktVar">expr</span>s are initialization expressions to be evaluated when the
+class is instantiated (see <a href="objcreation.html" data-pltdoc="x">Creating Objects</a>).</p><p>The result of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> expression is a new class, derived
+from the specified superclass and implementing the specified
+interfaces. Instances of the class are created with the
+<span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._instantiate%29%29" class="RktStxLink" data-pltdoc="x">instantiate</a></span> form or <span class="RktSym"><a href="objcreation.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._make-object%29%29" class="RktValLink" data-pltdoc="x">make-object</a></span> procedure, as
+described in <a href="objcreation.html" data-pltdoc="x">Creating Objects</a>.</p><p>Each <span class="RktVar">class-clause</span> is (partially) macro-expanded to reveal its
+shapes. If a <span class="RktVar">class-clause</span> is a <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> expression, its
+sub-expressions are lifted out of the <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> and treated as
+<span class="RktVar">class-clause</span>s, in the same way that <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> is
+flattened for top-level and embedded definitions.</p><p>Within a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form for instances of the new class,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this%29%29" class="RktStxLink" data-pltdoc="x">this</a></span> is bound to the object itself;
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this~25%29%29" class="RktStxLink" data-pltdoc="x">this%</a></span> is bound to the class of the object;
+<span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-instantiate%29%29" class="RktStxLink" data-pltdoc="x">super-instantiate</a></span>, <span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-make-object%29%29" class="RktStxLink" data-pltdoc="x">super-make-object</a></span>, and
+<span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span> are bound to forms to initialize fields in the
+superclass (see <a href="objcreation.html" data-pltdoc="x">Creating Objects</a>); <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span> is
+available for calling superclass methods (see
+<a href="createclass.html#%28part._clmethoddefs%29" data-pltdoc="x">Method Definitions</a>); and <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inner%29%29" class="RktStxLink" data-pltdoc="x">inner</a></span> is available for
+calling subclass augmentations of methods (see
+<a href="createclass.html#%28part._clmethoddefs%29" data-pltdoc="x">Method Definitions</a>).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._class))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">class</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">superclass-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">class-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span>, but omits the <span class="RktVar">interface-expr</span>s, for the case that none are needed.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">book-class%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">pages</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">letters</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pages</span><span class="hspace">&nbsp;</span><span class="RktVal">500</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/private/class-internal..rkt)._this))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">this</a></span></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"><a name="(idx._(gentag._195._(lib._scribblings/reference/reference..scrbl)))"></a>Within a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this%29%29" class="RktStxLink" data-pltdoc="x">this</a></span> refers
+to the current object (i.e., the object being initialized or whose
+method was called). Use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is
+a syntax error.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">describe</span><span class="hspace">&nbsp;</span><span class="RktSym">obj</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Hello ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">obj</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">describe-self</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">describe</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this%29%29" class="RktStxLink" data-pltdoc="x">this</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">describe-self</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Hello #(struct:object:table% ...)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/private/class-internal..rkt)._this~25))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this~25%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">this%</a></span></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Within a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this~25%29%29" class="RktStxLink" data-pltdoc="x">this%</a></span> refers to the class
+of the current object (i.e., the object being initialized or whose
+method was called).  Use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is
+a syntax error.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">account%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-field%29%29" class="RktStxLink" data-pltdoc="x">init-field</a></span><span class="hspace">&nbsp;</span><span class="RktSym">balance</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">add</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this~25%29%29" class="RktStxLink" data-pltdoc="x">this%</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">balance</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">balance</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">savings%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">account%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit-field%29%29" class="RktStxLink" data-pltdoc="x">inherit-field</a></span><span class="hspace">&nbsp;</span><span class="RktSym">balance</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">interest</span><span class="hspace">&nbsp;</span><span class="RktVal">0.04</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">add-interest</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this%29%29" class="RktStxLink" data-pltdoc="x">this</a></span><span class="hspace">&nbsp;</span><span class="RktSym">add</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">interest</span><span class="hspace">&nbsp;</span><span class="RktSym">balance</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A%29%29" class="RktStxLink" data-pltdoc="x">let*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">acct</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">savings%</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">balance</span><span class="hspace">&nbsp;</span><span class="RktVal">500</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">acct</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">acct</span><span class="hspace">&nbsp;</span><span class="RktSym">add</span><span class="hspace">&nbsp;</span><span class="RktVal">500</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">acct</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">acct</span><span class="hspace">&nbsp;</span><span class="RktSym">add-interest</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Current balance: ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._get-field%29%29" class="RktStxLink" data-pltdoc="x">get-field</a></span><span class="hspace">&nbsp;</span><span class="RktSym">balance</span><span class="hspace">&nbsp;</span><span class="RktSym">acct</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">Current balance: 1040.0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._inspect))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inspect%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">inspect</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">inspector-expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._init))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">init</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">init-decl</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> and <a href="createclass.html#%28part._clinitvars%29" data-pltdoc="x">Initialization Variables</a>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init%29%29" class="RktStxLink" data-pltdoc="x">init</a></span><span class="hspace">&nbsp;</span><span class="RktSym">turnip</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">internal-potato</span><span class="hspace">&nbsp;</span><span class="RktSym">potato</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">carrot</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">good</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">internal-rutabaga</span><span class="hspace">&nbsp;</span><span class="RktSym">rutabaga</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">okay</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;class:eval:10:0&gt;</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._init-field))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-field%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">init-field</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">init-decl</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span>, <a href="createclass.html#%28part._clinitvars%29" data-pltdoc="x">Initialization Variables</a>, and <a href="createclass.html#%28part._clfields%29" data-pltdoc="x">Fields</a>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-field%29%29" class="RktStxLink" data-pltdoc="x">init-field</a></span><span class="hspace">&nbsp;</span><span class="RktSym">turkey</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">internal-ostrich</span><span class="hspace">&nbsp;</span><span class="RktSym">ostrich</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">chicken</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">internal-emu</span><span class="hspace">&nbsp;</span><span class="RktSym">emu</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">13</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;class:eval:11:0&gt;</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._field))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">field</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">field-decl</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> and <a href="createclass.html#%28part._clfields%29" data-pltdoc="x">Fields</a>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">minestrone</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">ready</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">internal-coq-au-vin</span><span class="hspace">&nbsp;</span><span class="RktSym">coq-au-vin</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">stewing</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;class:eval:12:0&gt;</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._inherit-field))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit-field%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">inherit-field</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> and <a href="createclass.html#%28part._clfields%29" data-pltdoc="x">Fields</a>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cookbook%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">recipes</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">caldo-verde</span><span class="hspace">&nbsp;</span><span class="RktVal">oyakodon</span><span class="hspace">&nbsp;</span><span class="RktVal">eggs-benedict</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">pages</span><span class="hspace">&nbsp;</span><span class="RktVal">389</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cookbook%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit-field%29%29" class="RktStxLink" data-pltdoc="x">inherit-field</a></span><span class="hspace">&nbsp;</span><span class="RktSym">recipes</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">internal-pages</span><span class="hspace">&nbsp;</span><span class="RktSym">pages</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;class:eval:14:0&gt;</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._init-rest))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-rest%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">init-rest</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-rest%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">init-rest</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> and <a href="createclass.html#%28part._clinitvars%29" data-pltdoc="x">Initialization Variables</a>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fruit-basket%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-rest%29%29" class="RktStxLink" data-pltdoc="x">init-rest</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fruits</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fruits</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._make-object%29%29" class="RktValLink" data-pltdoc="x">make-object</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fruit-basket%</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">kiwi</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">lychee</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">melon</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">(kiwi lychee melon)</span></p></td></tr><tr><td><p><span class="RktRes">(object:fruit-basket% ...)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._public))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">public</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> and <a href="createclass.html#%28part._clmethoddefs%29" data-pltdoc="x">Method Definitions</a>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">jumper%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">skip</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">skip</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hop</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">hop</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%29%29" class="RktStxLink" data-pltdoc="x">public</a></span><span class="hspace">&nbsp;</span><span class="RktSym">skip</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">hop</span><span class="hspace">&nbsp;</span><span class="RktSym">jump</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">jumper%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">skip</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'skip</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">jumper%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">jump</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'hop</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._pubment))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._pubment%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">pubment</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> and <a href="createclass.html#%28part._clmethoddefs%29" data-pltdoc="x">Method Definitions</a>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">runner%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">run</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">run</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">trot</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">trot</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._pubment%29%29" class="RktStxLink" data-pltdoc="x">pubment</a></span><span class="hspace">&nbsp;</span><span class="RktSym">run</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">trot</span><span class="hspace">&nbsp;</span><span class="RktSym">jog</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">runner%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">run</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'run</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">runner%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">jog</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'trot</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._public-final))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public-final%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">public-final</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> and <a href="createclass.html#%28part._clmethoddefs%29" data-pltdoc="x">Method Definitions</a>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">point%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-field%29%29" class="RktStxLink" data-pltdoc="x">init-field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">do-get-y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public-final%29%29" class="RktStxLink" data-pltdoc="x">public-final</a></span><span class="hspace">&nbsp;</span><span class="RktSym">get-x</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">do-get-y</span><span class="hspace">&nbsp;</span><span class="RktSym">get-y</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">point%</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">get-y</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">point%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">3.14</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span><span class="hspace">&nbsp;</span><span class="RktSym">get-x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">class*: cannot override or augment final method</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">method name: get-x</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">class name: eval:25:0</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._override))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">override</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> and <a href="createclass.html#%28part._clmethoddefs%29" data-pltdoc="x">Method Definitions</a>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sheep%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bleat</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"baaaaaaaaah"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">confused-sheep%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sheep%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bleat</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bleat</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"???"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bleat</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sheep%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">bleat</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">baaaaaaaaah</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">confused-sheep%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">bleat</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">baaaaaaaaah</span></p></td></tr><tr><td><p><span class="RktOut">???</span></p></td></tr></table></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._overment))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">overment</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> and <a href="createclass.html#%28part._clmethoddefs%29" data-pltdoc="x">Method Definitions</a>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">turkey%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gobble</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"gobble gobble"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">extra-turkey%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">turkey%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gobble</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span><span class="hspace">&nbsp;</span><span class="RktSym">gobble</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"gobble gobble gobble"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inner%29%29" class="RktStxLink" data-pltdoc="x">inner</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">gobble</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="RktStxLink" data-pltdoc="x">overment</a></span><span class="hspace">&nbsp;</span><span class="RktSym">gobble</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cyborg-turkey%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">extra-turkey%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Faugment%29%29" class="RktStxLink" data-pltdoc="x">define/augment</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gobble</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"110011111011111100010110001011011001100101"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">extra-turkey%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">gobble</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">gobble gobble</span></p></td></tr><tr><td><p><span class="RktOut">gobble gobble gobble</span></p></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cyborg-turkey%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">gobble</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">gobble gobble</span></p></td></tr><tr><td><p><span class="RktOut">gobble gobble gobble</span></p></td></tr><tr><td><p><span class="RktOut">110011111011111100010110001011011001100101</span></p></td></tr></table></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._override-final))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">override-final</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> and <a href="createclass.html#%28part._clmethoddefs%29" data-pltdoc="x">Method Definitions</a>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">meeper%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">meep</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"meep"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">final-meeper%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">meeper%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">meep</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span><span class="hspace">&nbsp;</span><span class="RktSym">meep</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"This meeping ends with me"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%29%29" class="RktStxLink" data-pltdoc="x">override-final</a></span><span class="hspace">&nbsp;</span><span class="RktSym">meep</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">meeper%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">meep</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">meep</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">final-meeper%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">meep</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">meep</span></p></td></tr><tr><td><p><span class="RktOut">This meeping ends with me</span></p></td></tr></table></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._augment))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">augment</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> and <a href="createclass.html#%28part._clmethoddefs%29" data-pltdoc="x">Method Definitions</a>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">buzzer%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpubment%29%29" class="RktStxLink" data-pltdoc="x">define/pubment</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">buzz</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"bzzzt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inner%29%29" class="RktStxLink" data-pltdoc="x">inner</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">buzz</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loud-buzzer%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">buzzer%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">buzz</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"BZZZZZZZZZT"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span><span class="hspace">&nbsp;</span><span class="RktSym">buzz</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">buzzer%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">buzz</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">bzzzt</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loud-buzzer%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">buzz</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">bzzzt</span></p></td></tr><tr><td><p><span class="RktOut">BZZZZZZZZZT</span></p></td></tr></table></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._augride))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">augride</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> and <a href="createclass.html#%28part._clmethoddefs%29" data-pltdoc="x">Method Definitions</a>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._augment-final))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment-final%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">augment-final</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> and <a href="createclass.html#%28part._clmethoddefs%29" data-pltdoc="x">Method Definitions</a>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._private))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._private%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">private</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> and <a href="createclass.html#%28part._clmethoddefs%29" data-pltdoc="x">Method Definitions</a>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">light%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">on?</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">toggle</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">on?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktSym">on?</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._private%29%29" class="RktStxLink" data-pltdoc="x">private</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toggle</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">flick</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">toggle</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%29%29" class="RktStxLink" data-pltdoc="x">public</a></span><span class="hspace">&nbsp;</span><span class="RktSym">flick</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">light%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">toggle</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">send: no such method</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">method name: toggle</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">class name: light%</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">light%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">flick</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._abstract))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._abstract%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">abstract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> and <a href="createclass.html#%28part._clmethoddefs%29" data-pltdoc="x">Method Definitions</a>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">train%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._abstract%29%29" class="RktStxLink" data-pltdoc="x">abstract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">get-speed</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-field%29%29" class="RktStxLink" data-pltdoc="x">init-field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">position</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">move</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this~25%29%29" class="RktStxLink" data-pltdoc="x">this%</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">position</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">position</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-speed</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">acela%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">train%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Foverride%29%29" class="RktStxLink" data-pltdoc="x">define/override</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-speed</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">241</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">talgo-350%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">train%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Foverride%29%29" class="RktStxLink" data-pltdoc="x">define/override</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-speed</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">330</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">train%</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">instantiate: cannot instantiate class with abstract methods</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">class: #&lt;class:train%&gt;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">abstract methods:</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">get-speed</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">acela%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">move</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(object:acela% ...)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._inherit))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">inherit</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> and <a href="createclass.html#%28part._classinherit%29" data-pltdoc="x">Inherited and Superclass Methods</a>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">alarm%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">alarm</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"beeeeeeeep"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">car-alarm%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">alarm%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-field%29%29" class="RktStxLink" data-pltdoc="x">init-field</a></span><span class="hspace">&nbsp;</span><span class="RktSym">proximity</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span><span class="hspace">&nbsp;</span><span class="RktSym">alarm</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxLink" data-pltdoc="x">when</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span><span class="hspace">&nbsp;</span><span class="RktSym">proximity</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">alarm</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">car-alarm%</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">proximity</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">beeeeeeeep</span></p></td></tr><tr><td><p><span class="RktRes">(object:car-alarm% ...)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._inherit/super))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Fsuper%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">inherit/super</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> and <a href="createclass.html#%28part._classinherit%29" data-pltdoc="x">Inherited and Superclass Methods</a>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._inherit/inner))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Finner%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">inherit/inner</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> and <a href="createclass.html#%28part._classinherit%29" data-pltdoc="x">Inherited and Superclass Methods</a>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._rename-super))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-super%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">rename-super</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> and <a href="createclass.html#%28part._classinherit%29" data-pltdoc="x">Inherited and Superclass Methods</a>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._rename-inner))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-inner%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">rename-inner</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> and <a href="createclass.html#%28part._classinherit%29" data-pltdoc="x">Inherited and Superclass Methods</a>; use outside the body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form is a syntax error.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._public*))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">public*</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%29%29" class="RktStxLink" data-pltdoc="x">public</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._pubment*))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._pubment%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">pubment*</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._pubment%29%29" class="RktStxLink" data-pltdoc="x">pubment</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._public-final*))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public-final%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">public-final*</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public-final%29%29" class="RktStxLink" data-pltdoc="x">public-final</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._override*))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">override*</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._overment*))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">overment*</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="RktStxLink" data-pltdoc="x">overment</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._override-final*))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">override-final*</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%29%29" class="RktStxLink" data-pltdoc="x">override-final</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._augment*))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">augment*</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._augride*))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">augride*</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%29%29" class="RktStxLink" data-pltdoc="x">augride</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._augment-final*))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment-final%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">augment-final*</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment-final%29%29" class="RktStxLink" data-pltdoc="x">augment-final</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._private*))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._private%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">private*</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._private%29%29" class="RktStxLink" data-pltdoc="x">private</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._define/public))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/public</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">formals</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%29%29" class="RktStxLink" data-pltdoc="x">public</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="RktPn">)</span> or <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%29%29" class="RktStxLink" data-pltdoc="x">public</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">id</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">formals</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="RktPn">)</span></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._define/pubment))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpubment%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/pubment</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpubment%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/pubment</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">formals</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._pubment%29%29" class="RktStxLink" data-pltdoc="x">pubment</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="RktPn">)</span> or <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._pubment%29%29" class="RktStxLink" data-pltdoc="x">pubment</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">id</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">formals</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="RktPn">)</span></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._define/public-final))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic-final%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/public-final</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic-final%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/public-final</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">formals</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public-final%29%29" class="RktStxLink" data-pltdoc="x">public-final</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="RktPn">)</span> or <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public-final%29%29" class="RktStxLink" data-pltdoc="x">public-final</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">id</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">formals</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="RktPn">)</span></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._define/override))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Foverride%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/override</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Foverride%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/override</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">formals</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="RktPn">)</span> or <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">id</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">formals</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="RktPn">)</span></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._define/overment))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Foverment%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/overment</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Foverment%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/overment</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">formals</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="RktStxLink" data-pltdoc="x">overment</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="RktPn">)</span> or <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="RktStxLink" data-pltdoc="x">overment</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">id</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">formals</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="RktPn">)</span></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._define/override-final))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Foverride-final%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/override-final</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Foverride-final%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/override-final</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">formals</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%29%29" class="RktStxLink" data-pltdoc="x">override-final</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="RktPn">)</span> or <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%29%29" class="RktStxLink" data-pltdoc="x">override-final</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">id</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">formals</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="RktPn">)</span></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._define/augment))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Faugment%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/augment</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Faugment%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/augment</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">formals</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="RktPn">)</span> or <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">id</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">formals</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="RktPn">)</span></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._define/augride))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Faugride%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/augride</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Faugride%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/augride</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">formals</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%29%29" class="RktStxLink" data-pltdoc="x">augride</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="RktPn">)</span> or <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%29%29" class="RktStxLink" data-pltdoc="x">augride</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">id</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">formals</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="RktPn">)</span></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._define/augment-final))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Faugment-final%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/augment-final</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Faugment-final%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/augment-final</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">formals</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment-final%29%29" class="RktStxLink" data-pltdoc="x">augment-final</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="RktPn">)</span> or <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment-final%29%29" class="RktStxLink" data-pltdoc="x">augment-final</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">id</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">formals</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="RktPn">)</span></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._define/private))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fprivate%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/private</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fprivate%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/private</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">formals</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._private%29%29" class="RktStxLink" data-pltdoc="x">private</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="RktPn">)</span> or <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._private%29%29" class="RktStxLink" data-pltdoc="x">private</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">id</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">formals</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="RktPn">)</span></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._class/derived))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2Fderived%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">class/derived</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">original-datum</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">name-id</span><span class="hspace">&nbsp;</span><span class="RktVar">super-expr</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">interface-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">deserialize-id-expr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">class-clause</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span>, but includes a sub-expression to be used as the
+source for all syntax errors within the class definition. For example,
+<span class="RktSym"><a href="objectserialize.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-serializable-class%29%29" class="RktStxLink" data-pltdoc="x">define-serializable-class</a></span> expands to <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2Fderived%29%29" class="RktStxLink" data-pltdoc="x">class/derived</a></span>
+so that errors in the body of the class are reported in terms of
+<span class="RktSym"><a href="objectserialize.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-serializable-class%29%29" class="RktStxLink" data-pltdoc="x">define-serializable-class</a></span> instead of <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span>.</div></p><p>The <span class="RktVar">original-datum</span> is the original expression to use for
+reporting errors.</p><p>The <span class="RktVar">name-id</span> is used to name the resulting class; if it
+is <span class="RktVal">#f</span>, the class name is inferred.</p><p>The <span class="RktVar">super-expr</span>, <span class="RktVar">interface-expr</span>s, and
+<span class="RktVar">class-clause</span>s are as for <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span>.</p><p>If the <span class="RktVar">deserialize-id-expr</span> is not literally <span class="RktVal">#f</span>, then
+a serializable class is generated, and the result is two values
+instead of one: the class and a deserialize-info structure produced by
+<span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._make-deserialize-info%29%29" class="RktValLink" data-pltdoc="x">make-deserialize-info</a></span>. The <span class="RktVar">deserialize-id-expr</span>
+should produce a value suitable as the second argument to
+<span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._make-serialize-info%29%29" class="RktValLink" data-pltdoc="x">make-serialize-info</a></span>, and it should refer to an export whose
+value is the deserialize-info structure.</p><p>Future optional forms may be added to the sequence that currently ends
+with <span class="RktVar">deserialize-id-expr</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;clinitvars&quot;">6.2.1<tt>&nbsp;</tt><a name="(part._clinitvars)"></a>Initialization Variables</h5><p>A class&rsquo;s initialization variables, declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init%29%29" class="RktStxLink" data-pltdoc="x">init</a></span>,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-field%29%29" class="RktStxLink" data-pltdoc="x">init-field</a></span>, and <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-rest%29%29" class="RktStxLink" data-pltdoc="x">init-rest</a></span>, are instantiated
+for each object of a class. Initialization variables can be used in
+the initial value expressions of fields, default value expressions
+for initialization arguments, and in initialization expressions.  Only
+initialization variables declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-field%29%29" class="RktStxLink" data-pltdoc="x">init-field</a></span> can be
+accessed from methods; accessing any other initialization variable
+from a method is a syntax error.</p><p>The values bound to initialization variables are</p><ul><li><p>the arguments provided with <span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._instantiate%29%29" class="RktStxLink" data-pltdoc="x">instantiate</a></span> or passed to
+<span class="RktSym"><a href="objcreation.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._make-object%29%29" class="RktValLink" data-pltdoc="x">make-object</a></span>, if the object is created as a direct instance
+of the class; or,</p></li><li><p>the arguments passed to the superclass initialization form or
+procedure, if the object is created as an instance of a derived
+class.</p></li></ul><p>If an initialization argument is not provided for an initialization
+variable that has an associated <span class="RktVar">default-value-expr</span>, then the
+<span class="RktVar">default-value-expr</span> expression is evaluated to obtain a value
+for the variable. A <span class="RktVar">default-value-expr</span> is only evaluated when
+an argument is not provided for its variable. The environment of
+<span class="RktVar">default-value-expr</span> includes all of the initialization
+variables, all of the fields, and all of the methods of the class. If
+multiple <span class="RktVar">default-value-expr</span>s are evaluated, they are
+evaluated from left to right. Object creation and field initialization
+are described in detail in <a href="objcreation.html" data-pltdoc="x">Creating Objects</a>.</p><p>If an initialization variable has no <span class="RktVar">default-value-expr</span>, then
+the object creation or superclass initialization call must supply an
+argument for the variable, otherwise the <span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised.</p><p>Initialization arguments can be provided by name or by position.  The
+external name of an initialization variable can be used with
+<span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._instantiate%29%29" class="RktStxLink" data-pltdoc="x">instantiate</a></span> or with the superclass initialization form. Those
+forms also accept by-position arguments. The <span class="RktSym"><a href="objcreation.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._make-object%29%29" class="RktValLink" data-pltdoc="x">make-object</a></span>
+procedure and the superclass initialization procedure accept only
+by-position arguments.</p><p>Arguments provided by position are converted into by-name arguments
+using the order of <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init%29%29" class="RktStxLink" data-pltdoc="x">init</a></span> and <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-field%29%29" class="RktStxLink" data-pltdoc="x">init-field</a></span> clauses and
+the order of variables within each clause. When an <span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._instantiate%29%29" class="RktStxLink" data-pltdoc="x">instantiate</a></span>
+form provides both by-position and by-name arguments, the converted
+arguments are placed before by-name arguments. (The order can be
+significant; see also <a href="objcreation.html" data-pltdoc="x">Creating Objects</a>.)</p><p>Unless a class contains an <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-rest%29%29" class="RktStxLink" data-pltdoc="x">init-rest</a></span> clause, when the number
+of by-position arguments exceeds the number of declared initialization
+variables, the order of variables in the superclass (and so on, up the
+superclass chain) determines the by-name conversion.</p><p>If a class expression contains an <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-rest%29%29" class="RktStxLink" data-pltdoc="x">init-rest</a></span> clause, there
+must be only one, and it must be last. If it declares a variable, then
+the variable receives extra by-position initialization arguments as a
+list (similar to a dotted &ldquo;rest argument&rdquo; in a procedure).  An
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-rest%29%29" class="RktStxLink" data-pltdoc="x">init-rest</a></span> variable can receive by-position initialization
+arguments that are left over from a by-name conversion for a derived
+class. When a derived class&rsquo;s superclass initialization provides even
+more by-position arguments, they are prefixed onto the by-position
+arguments accumulated so far.</p><p>If too few or too many by-position initialization arguments are
+provided to an object creation or superclass initialization, then the
+<span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised. Similarly, if extra by-position arguments
+are provided to a class with an <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-rest%29%29" class="RktStxLink" data-pltdoc="x">init-rest</a></span> clause, the
+<span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised.</p><p>Unused (by-name) arguments are to be propagated to the superclass, as
+described in <a href="objcreation.html" data-pltdoc="x">Creating Objects</a>.  Multiple initialization
+arguments can use the same name if the class derivation contains
+multiple declarations (in different classes) of initialization
+variables with the name. See <a href="objcreation.html" data-pltdoc="x">Creating Objects</a> for further
+details.</p><p>See also <a href="createclass.html#%28part._extnames%29" data-pltdoc="x">Internal and External Names</a> for information about internal and
+external names.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;clfields&quot;">6.2.2<tt>&nbsp;</tt><a name="(part._clfields)"></a>Fields</h5><p>Each <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-field%29%29" class="RktStxLink" data-pltdoc="x">init-field</a></span>, and non-method
+<span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span> clause in a class declares one or more new
+fields for the class. Fields declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span> or
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-field%29%29" class="RktStxLink" data-pltdoc="x">init-field</a></span> are public. Public fields can be accessed and
+mutated by subclasses using <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit-field%29%29" class="RktStxLink" data-pltdoc="x">inherit-field</a></span>. Public fields are
+also accessible outside the class via <span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-field-accessor%29%29" class="RktStxLink" data-pltdoc="x">class-field-accessor</a></span>
+and mutable via <span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-field-mutator%29%29" class="RktStxLink" data-pltdoc="x">class-field-mutator</a></span> (see
+<a href="ivaraccess.html" data-pltdoc="x">Field and Method Access</a>). Fields declared with <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span>
+are accessible only within the class.</p><p>A field declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-field%29%29" class="RktStxLink" data-pltdoc="x">init-field</a></span> is both a public field and
+an initialization variable. See <a href="createclass.html#%28part._clinitvars%29" data-pltdoc="x">Initialization Variables</a> for
+information about initialization variables.</p><p>An <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit-field%29%29" class="RktStxLink" data-pltdoc="x">inherit-field</a></span> declaration makes a public field defined by
+a superclass directly accessible in the class expression. If the
+indicated field is not defined in the superclass, the
+<span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised when the class expression is evaluated.
+Every field in a superclass is present in a derived class, even if it
+is not declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit-field%29%29" class="RktStxLink" data-pltdoc="x">inherit-field</a></span> in the derived class. The
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit-field%29%29" class="RktStxLink" data-pltdoc="x">inherit-field</a></span> clause does not control inheritance, but merely
+controls lexical scope within a class expression.</p><p>When an object is first created, all of its fields have the
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;undefined&gt;</span></span></a> value (see <a href="void.html" data-pltdoc="x">Void</a>). The fields of a
+class are initialized at the same time that the class&rsquo;s initialization
+expressions are evaluated; see <a href="objcreation.html" data-pltdoc="x">Creating Objects</a> for more
+information.</p><p>See also <a href="createclass.html#%28part._extnames%29" data-pltdoc="x">Internal and External Names</a> for information about internal and
+external names.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;clmethods&quot;">6.2.3<tt>&nbsp;</tt><a name="(part._clmethods)"></a>Methods</h5><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;clmethoddefs&quot;">6.2.3.1<tt>&nbsp;</tt><a name="(part._clmethoddefs)"></a>Method Definitions</h5><p>Each <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%29%29" class="RktStxLink" data-pltdoc="x">public</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span>,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._pubment%29%29" class="RktStxLink" data-pltdoc="x">pubment</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="RktStxLink" data-pltdoc="x">overment</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%29%29" class="RktStxLink" data-pltdoc="x">augride</a></span>,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public-final%29%29" class="RktStxLink" data-pltdoc="x">public-final</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%29%29" class="RktStxLink" data-pltdoc="x">override-final</a></span>,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment-final%29%29" class="RktStxLink" data-pltdoc="x">augment-final</a></span>, and <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._private%29%29" class="RktStxLink" data-pltdoc="x">private</a></span>
+clause in a class declares one or more method names. Each method name
+must have a corresponding <span class="RktVar">method-definition</span>. The order of
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%29%29" class="RktStxLink" data-pltdoc="x">public</a></span>, etc<span class="Sendabbrev">.</span>, clauses and their corresponding definitions
+(among themselves, and with respect to other clauses in the class)
+does not matter.</p><p>As shown in the grammar for <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span>, a method definition is
+syntactically restricted to certain procedure forms, as defined by the
+grammar for <span class="RktVar">method-procedure</span>; in the last two forms of
+<span class="RktVar">method-procedure</span>, the body <span class="RktSym">id</span> must be one of the
+<span class="RktSym">id</span>s bound by <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span> or <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-values%29%29" class="RktStxLink" data-pltdoc="x">letrec-values</a></span>. A
+<span class="RktVar">method-procedure</span> expression is not evaluated
+directly. Instead, for each method, a class-specific method procedure
+is created; it takes an initial object argument, in addition to the
+arguments the procedure would accept if the <span class="RktVar">method-procedure</span>
+expression were evaluated directly. The body of the procedure is
+transformed to access methods and fields through the object argument.</p><p>A method declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%29%29" class="RktStxLink" data-pltdoc="x">public</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._pubment%29%29" class="RktStxLink" data-pltdoc="x">pubment</a></span>, or
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public-final%29%29" class="RktStxLink" data-pltdoc="x">public-final</a></span> introduces a new method into a class. The method
+must not be present already in the superclass, otherwise the
+<span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised when the class expression is evaluated. A
+method declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%29%29" class="RktStxLink" data-pltdoc="x">public</a></span> can be overridden in a subclass
+that uses <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="RktStxLink" data-pltdoc="x">overment</a></span>, or
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%29%29" class="RktStxLink" data-pltdoc="x">override-final</a></span>.  A method declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._pubment%29%29" class="RktStxLink" data-pltdoc="x">pubment</a></span> can
+be augmented in a subclass that uses <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span>,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%29%29" class="RktStxLink" data-pltdoc="x">augride</a></span>, or <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment-final%29%29" class="RktStxLink" data-pltdoc="x">augment-final</a></span>. A method declared with
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public-final%29%29" class="RktStxLink" data-pltdoc="x">public-final</a></span> cannot be overridden or augmented in a subclass.</p><p>A method declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="RktStxLink" data-pltdoc="x">overment</a></span>, or
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%29%29" class="RktStxLink" data-pltdoc="x">override-final</a></span> overrides a definition already present in the
+superclass. If the method is not already present, the
+<span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised when the class expression is evaluated.  A
+method declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span> can be overridden again in a
+subclass that uses <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="RktStxLink" data-pltdoc="x">overment</a></span>, or
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%29%29" class="RktStxLink" data-pltdoc="x">override-final</a></span>.  A method declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="RktStxLink" data-pltdoc="x">overment</a></span> can
+be augmented in a subclass that uses <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span>,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%29%29" class="RktStxLink" data-pltdoc="x">augride</a></span>, or <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment-final%29%29" class="RktStxLink" data-pltdoc="x">augment-final</a></span>. A method declared with
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%29%29" class="RktStxLink" data-pltdoc="x">override-final</a></span> cannot be overridden further or augmented in a
+subclass.</p><p>A method declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%29%29" class="RktStxLink" data-pltdoc="x">augride</a></span>, or
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment-final%29%29" class="RktStxLink" data-pltdoc="x">augment-final</a></span> augments a definition already present in the
+superclass. If the method is not already present, the
+<span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised when the class expression is evaluated.  A
+method declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span> can be augmented further in a
+subclass that uses <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%29%29" class="RktStxLink" data-pltdoc="x">augride</a></span>, or
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment-final%29%29" class="RktStxLink" data-pltdoc="x">augment-final</a></span>. A method declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%29%29" class="RktStxLink" data-pltdoc="x">augride</a></span> can be
+overridden in a subclass that uses <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span>,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="RktStxLink" data-pltdoc="x">overment</a></span>, or <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%29%29" class="RktStxLink" data-pltdoc="x">override-final</a></span>. (Such an override
+merely replaces the augmentation, not the method that is augmented.)
+A method declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment-final%29%29" class="RktStxLink" data-pltdoc="x">augment-final</a></span> cannot be overridden or
+augmented further in a subclass.</p><p>A method declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._private%29%29" class="RktStxLink" data-pltdoc="x">private</a></span> is not accessible outside the
+class expression, cannot be overridden, and never overrides a method
+in the superclass.</p><p>When a method is declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="RktStxLink" data-pltdoc="x">overment</a></span>,
+or <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%29%29" class="RktStxLink" data-pltdoc="x">override-final</a></span>, then the superclass implementation of the
+method can be called using <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span> form.</p><p>When a method is declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._pubment%29%29" class="RktStxLink" data-pltdoc="x">pubment</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span>, or
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="RktStxLink" data-pltdoc="x">overment</a></span>, then a subclass augmenting method can be called
+using the <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inner%29%29" class="RktStxLink" data-pltdoc="x">inner</a></span> form. The only difference between
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public-final%29%29" class="RktStxLink" data-pltdoc="x">public-final</a></span> and <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._pubment%29%29" class="RktStxLink" data-pltdoc="x">pubment</a></span> without a corresponding
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inner%29%29" class="RktStxLink" data-pltdoc="x">inner</a></span> is that <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public-final%29%29" class="RktStxLink" data-pltdoc="x">public-final</a></span> prevents the declaration
+of augmenting methods that would be ignored.</p><p>A method declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._abstract%29%29" class="RktStxLink" data-pltdoc="x">abstract</a></span> must be declared without
+an implementation. Subclasses may implement abstract methods via the
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="RktStxLink" data-pltdoc="x">overment</a></span>, or <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%29%29" class="RktStxLink" data-pltdoc="x">override-final</a></span>
+forms. Any class that contains or inherits any abstract methods is
+considered abstract and cannot be instantiated.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._super))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">super</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">super</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">arg-list-expr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Always accesses the superclass method, independent of whether the
+method is overridden again in subclasses. Using the <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span>
+form outside of <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> is a syntax error. Each <span class="RktVar">arg</span>
+is as for <span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25app%29%29" class="RktStxLink" data-pltdoc="x">#%app</a></span>: either <span class="RktVar">arg-expr</span> or
+<span class="RktVar">keyword</span><span class="stt"> </span><span class="RktVar">arg-expr</span>.</div></p><p>The second form is analogous to using <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span> with a procedure;
+the <span class="RktVar">arg-list-expr</span> must not be a parenthesized expression.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._inner))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inner%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">inner</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">default-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inner%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">inner</a></span><span class="hspace">&nbsp;</span><span class="RktVar">default-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">arg-list-expr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">If the object&rsquo;s class does not supply an augmenting method, then
+<span class="RktVar">default-expr</span> is evaluated, and the <span class="RktVar">arg</span> expressions
+are not evaluated. Otherwise, the augmenting method is called with the
+<span class="RktVar">arg</span> results as arguments, and <span class="RktVar">default-expr</span> is not
+evaluated. If no <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inner%29%29" class="RktStxLink" data-pltdoc="x">inner</a></span> call is evaluated for a particular
+method, then augmenting methods supplied by subclasses are never
+used. Using the <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inner%29%29" class="RktStxLink" data-pltdoc="x">inner</a></span> form outside of <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> is an
+syntax error.</div></p><p>The second form is analogous to using <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span> with a procedure;
+the <span class="RktVar">arg-list-expr</span> must not be a parenthesized expression.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;classinherit&quot;">6.2.3.2<tt>&nbsp;</tt><a name="(part._classinherit)"></a>Inherited and Superclass Methods</h5><p>Each <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Fsuper%29%29" class="RktStxLink" data-pltdoc="x">inherit/super</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Finner%29%29" class="RktStxLink" data-pltdoc="x">inherit/inner</a></span>,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-super%29%29" class="RktStxLink" data-pltdoc="x">rename-super</a></span>, and <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-inner%29%29" class="RktStxLink" data-pltdoc="x">rename-inner</a></span> clause declares one
+or more methods that are defined in the class, but must be present in
+the superclass. The <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-super%29%29" class="RktStxLink" data-pltdoc="x">rename-super</a></span> and <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-inner%29%29" class="RktStxLink" data-pltdoc="x">rename-inner</a></span>
+declarations are rarely used, since <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Fsuper%29%29" class="RktStxLink" data-pltdoc="x">inherit/super</a></span> and
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Finner%29%29" class="RktStxLink" data-pltdoc="x">inherit/inner</a></span> provide the same access. Also, superclass and
+augmenting methods are typically accessed through <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span> and
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inner%29%29" class="RktStxLink" data-pltdoc="x">inner</a></span> in a class that also declares the methods, instead of
+through <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Fsuper%29%29" class="RktStxLink" data-pltdoc="x">inherit/super</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Finner%29%29" class="RktStxLink" data-pltdoc="x">inherit/inner</a></span>,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-super%29%29" class="RktStxLink" data-pltdoc="x">rename-super</a></span>, or <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-inner%29%29" class="RktStxLink" data-pltdoc="x">rename-inner</a></span>.</p><p>Method names declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Fsuper%29%29" class="RktStxLink" data-pltdoc="x">inherit/super</a></span>,
+or <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Finner%29%29" class="RktStxLink" data-pltdoc="x">inherit/inner</a></span> access overriding declarations, if any, at
+run time. Method names declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Fsuper%29%29" class="RktStxLink" data-pltdoc="x">inherit/super</a></span> can also
+be used with the <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span> form to access the superclass
+implementation, and method names declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Finner%29%29" class="RktStxLink" data-pltdoc="x">inherit/inner</a></span>
+can also be used with the <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inner%29%29" class="RktStxLink" data-pltdoc="x">inner</a></span> form to access an augmenting
+method, if any.</p><p>Method names declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-super%29%29" class="RktStxLink" data-pltdoc="x">rename-super</a></span> always access the
+superclass&rsquo;s implementation at run-time. Methods declared with
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-inner%29%29" class="RktStxLink" data-pltdoc="x">rename-inner</a></span> access a subclass&rsquo;s augmenting method, if any,
+and must be called with the form</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">default-expr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></p></blockquote><p>so that a <span class="RktSym">default-expr</span> is available to evaluate when no
+augmenting method is available. In such a form, <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span> is a
+literal identifier to separate the <span class="RktSym">default-expr</span> from the
+<span class="RktSym">arg</span>. When an augmenting method is available, it receives the
+results of the <span class="RktSym">arg</span> expressions as arguments.</p><p>Methods that are present in the superclass but not declared with
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Fsuper%29%29" class="RktStxLink" data-pltdoc="x">inherit/super</a></span>, or <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Finner%29%29" class="RktStxLink" data-pltdoc="x">inherit/inner</a></span> or
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-super%29%29" class="RktStxLink" data-pltdoc="x">rename-super</a></span> are not directly accessible in the class
+(though they can be called with <span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span>).  Every public method
+in a superclass is present in a derived class, even if it is not
+declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span> in the derived class; the
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span> clause does not control inheritance, but merely
+controls lexical scope within a class expression.</p><p>If a method declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Fsuper%29%29" class="RktStxLink" data-pltdoc="x">inherit/super</a></span>,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Finner%29%29" class="RktStxLink" data-pltdoc="x">inherit/inner</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-super%29%29" class="RktStxLink" data-pltdoc="x">rename-super</a></span>, or
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-inner%29%29" class="RktStxLink" data-pltdoc="x">rename-inner</a></span> is not present in the superclass, the
+<span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised when the class expression is evaluated.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;extnames&quot;">6.2.3.3<tt>&nbsp;</tt><a name="(part._extnames)"></a>Internal and External Names</h5><p>Each method declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%29%29" class="RktStxLink" data-pltdoc="x">public</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span>,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._pubment%29%29" class="RktStxLink" data-pltdoc="x">pubment</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="RktStxLink" data-pltdoc="x">overment</a></span>,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%29%29" class="RktStxLink" data-pltdoc="x">augride</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public-final%29%29" class="RktStxLink" data-pltdoc="x">public-final</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%29%29" class="RktStxLink" data-pltdoc="x">override-final</a></span>,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment-final%29%29" class="RktStxLink" data-pltdoc="x">augment-final</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Fsuper%29%29" class="RktStxLink" data-pltdoc="x">inherit/super</a></span>,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Finner%29%29" class="RktStxLink" data-pltdoc="x">inherit/inner</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-super%29%29" class="RktStxLink" data-pltdoc="x">rename-super</a></span>, and
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-inner%29%29" class="RktStxLink" data-pltdoc="x">rename-inner</a></span> can have separate internal and external names
+when <span class="RktPn">(</span><span class="RktSym">internal-id</span><span class="stt"> </span><span class="RktSym">external-id</span><span class="RktPn">)</span> is used for declaring the
+method. The internal name is used to access the method directly within
+the class expression (including within <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span> or
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inner%29%29" class="RktStxLink" data-pltdoc="x">inner</a></span> forms), while the external name is used with
+<span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span> and <span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._generic%29%29" class="RktStxLink" data-pltdoc="x">generic</a></span> (see <a href="ivaraccess.html" data-pltdoc="x">Field and Method Access</a>).  If
+a single <span class="RktSym">id</span> is provided for a method declaration, the
+identifier is used for both the internal and external names.</p><p>Method inheritance, overriding, and augmentation are based on external
+names only.  Separate internal and external names are required for
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-super%29%29" class="RktStxLink" data-pltdoc="x">rename-super</a></span> and <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-inner%29%29" class="RktStxLink" data-pltdoc="x">rename-inner</a></span> (for historical
+reasons, mainly).</p><p>Each <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init%29%29" class="RktStxLink" data-pltdoc="x">init</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-field%29%29" class="RktStxLink" data-pltdoc="x">init-field</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span>, or
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit-field%29%29" class="RktStxLink" data-pltdoc="x">inherit-field</a></span> variable similarly has an internal and an
+external name. The internal name is used within the class to access
+the variable, while the external name is used outside the class when
+providing initialization arguments (e.g., to <span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._instantiate%29%29" class="RktStxLink" data-pltdoc="x">instantiate</a></span>),
+inheriting a field, or accessing a field externally (e.g., with
+<span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-field-accessor%29%29" class="RktStxLink" data-pltdoc="x">class-field-accessor</a></span>). As for methods, when inheriting a
+field with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit-field%29%29" class="RktStxLink" data-pltdoc="x">inherit-field</a></span>, the external name is matched to an
+external field name in the superclass, while the internal name is
+bound in the <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span> expression.</p><p>A single identifier can be used as an internal identifier and an
+external identifier, and it is possible to use the same identifier as
+internal and external identifiers for different bindings. Furthermore,
+within a single class, a single name can be used as an external method
+name, an external field name, and an external initialization argument
+name. Overall, each internal identifier must be distinct from all
+other internal identifiers, each external method name must be distinct
+from all other method names, each external field name must be distinct
+from all other field names, and each initialization argument name must
+be distinct from all other initialization argument names.</p><p>By default, external names have no lexical scope, which means, for
+example, that an external method name matches the same syntactic
+symbol in all uses of <span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span>. The
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-local-member-name%29%29" class="RktStxLink" data-pltdoc="x">define-local-member-name</a></span> and <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-member-name%29%29" class="RktStxLink" data-pltdoc="x">define-member-name</a></span> forms
+introduce scoped external names.</p><p>When a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span> expression is compiled, identifiers used in
+place of external names must be symbolically distinct (when the
+corresponding external names are required to be distinct), otherwise a
+syntax error is reported. When no external name is bound by
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-member-name%29%29" class="RktStxLink" data-pltdoc="x">define-member-name</a></span>, then the actual external names are
+guaranteed to be distinct when <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span> expression is evaluated.
+When any external name is bound by <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-member-name%29%29" class="RktStxLink" data-pltdoc="x">define-member-name</a></span>, the
+<span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised by <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span> if the actual external
+names are not distinct.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._define-local-member-name))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-local-member-name%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-local-member-name</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Unless it appears as the top-level definition, binds each <span class="RktVar">id</span>
+so that, within the scope of the definition, each use of each
+<span class="RktVar">id</span> as an external name is resolved to a hidden name generated
+by the <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-local-member-name%29%29" class="RktStxLink" data-pltdoc="x">define-local-member-name</a></span> declaration. Thus, methods,
+fields, and initialization arguments declared with such external-name
+<span class="RktVar">id</span>s are accessible only in the scope of the
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-local-member-name%29%29" class="RktStxLink" data-pltdoc="x">define-local-member-name</a></span> declaration.  As a top-level
+definition, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-local-member-name%29%29" class="RktStxLink" data-pltdoc="x">define-local-member-name</a></span> binds <span class="RktVar">id</span> to its
+symbolic form.</div></p><p>The binding introduced by <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-local-member-name%29%29" class="RktStxLink" data-pltdoc="x">define-local-member-name</a></span> is a
+syntax binding that can be exported and imported with
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>s. Each evaluation of a
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-local-member-name%29%29" class="RktStxLink" data-pltdoc="x">define-local-member-name</a></span> declaration generates a distinct
+hidden name (except as a top-level definition). The
+<span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface-~3emethod-names%29%29" class="RktValLink" data-pltdoc="x">interface-&gt;method-names</a></span> procedure does not expose hidden
+names.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-local-member-name%29%29" class="RktStxLink" data-pltdoc="x">define-local-member-name</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c%</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">o</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">r</span></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">send: no such method</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">method name: m</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">class name: c%</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._define-member-name))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-member-name%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-member-name</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">key-expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Maps a single external name to an external name that is determined by
+an expression. The value of <span class="RktVar">key-expr</span> must be the result of either a
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key%29%29" class="RktStxLink" data-pltdoc="x">member-name-key</a></span> expression or a <span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._generate-member-key%29%29" class="RktValLink" data-pltdoc="x">generate-member-key</a></span> call.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._member-name-key))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">member-name-key</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">identifier</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Produces a representation of the external name for <span class="RktSym">id</span> in the
+environment of the <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key%29%29" class="RktStxLink" data-pltdoc="x">member-name-key</a></span> expression.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._generate-member-key))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._generate-member-key%29%29" class="RktValDef RktValLink" data-pltdoc="x">generate-member-key</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key~3f%29%29" class="RktValLink" data-pltdoc="x">member-name-key?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Produces a hidden name, just like the binding for
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-local-member-name%29%29" class="RktStxLink" data-pltdoc="x">define-local-member-name</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._member-name-key~3f))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">member-name-key?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> for values produced by <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key%29%29" class="RktStxLink" data-pltdoc="x">member-name-key</a></span>
+and <span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._generate-member-key%29%29" class="RktValLink" data-pltdoc="x">generate-member-key</a></span>, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._member-name-key~3d~3f))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">member-name-key=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a-key</span><span class="hspace">&nbsp;</span><span class="RktVar">b-key</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a-key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key~3f%29%29" class="RktValLink" data-pltdoc="x">member-name-key?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b-key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key~3f%29%29" class="RktValLink" data-pltdoc="x">member-name-key?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces <span class="RktVal">#t</span> if member-name keys <span class="RktVar">a-key</span> and
+<span class="RktVar">b-key</span> represent the same external name, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._member-name-key-hash-code))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key-hash-code%29%29" class="RktValDef RktValLink" data-pltdoc="x">member-name-key-hash-code</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a-key</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a-key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key~3f%29%29" class="RktValLink" data-pltdoc="x">member-name-key?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces an integer hash code consistent with
+<span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key~3d~3f%29%29" class="RktValLink" data-pltdoc="x">member-name-key=?</a></span>  comparisons, analogous to
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-hash-code</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-c%</span><span class="hspace">&nbsp;</span><span class="RktSym">key</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-member-name%29%29" class="RktStxLink" data-pltdoc="x">define-member-name</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">key</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-c%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key%29%29" class="RktStxLink" data-pltdoc="x">member-name-key</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-c%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key%29%29" class="RktStxLink" data-pltdoc="x">member-name-key</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">send: no such method</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">method name: m</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">class name: make-c%</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-c%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key%29%29" class="RktStxLink" data-pltdoc="x">member-name-key</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fresh-c%</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">key</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._generate-member-key%29%29" class="RktValLink" data-pltdoc="x">generate-member-key</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-c%</span><span class="hspace">&nbsp;</span><span class="RktSym">key</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">key</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fc%</span><span class="hspace">&nbsp;</span><span class="RktSym">key</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fresh-c%</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fc%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">send: no such method</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">method name: m</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">class name: make-c%</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-member-name%29%29" class="RktStxLink" data-pltdoc="x">define-member-name</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktSym">key</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fc%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="createinterface.html" title="backward to &quot;6.1 Creating Interfaces&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="objcreation.html" title="forward to &quot;6.3 Creating Objects&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/createinterface.html b/clones/docs.racket-lang.org/reference/createinterface.html
new file mode 100644
index 00000000..2b0f3ee8
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/createinterface.html
@@ -0,0 +1,30 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6.1&nbsp;Creating Interfaces</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewselflink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="createinterface.html" class="tocviewselflink" data-pltdoc="x">Creating Interfaces</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="createclass.html" class="tocviewlink" data-pltdoc="x">Creating Classes</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="objcreation.html" class="tocviewlink" data-pltdoc="x">Creating Objects</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="ivaraccess.html" class="tocviewlink" data-pltdoc="x">Field and Method Access</a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="mixins.html" class="tocviewlink" data-pltdoc="x">Mixins</a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="trait.html" class="tocviewlink" data-pltdoc="x">Traits</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="Object_and_Class_Contracts.html" class="tocviewlink" data-pltdoc="x">Object and Class Contracts</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="objectequality.html" class="tocviewlink" data-pltdoc="x">Object Equality and Hashing</a></td></tr><tr><td align="right">6.9&nbsp;</td><td><a href="objectserialize.html" class="tocviewlink" data-pltdoc="x">Object Serialization</a></td></tr><tr><td align="right">6.10&nbsp;</td><td><a href="objectprinting.html" class="tocviewlink" data-pltdoc="x">Object Printing</a></td></tr><tr><td align="right">6.11&nbsp;</td><td><a href="objectutils.html" class="tocviewlink" data-pltdoc="x">Object, Class, and Interface Utilities</a></td></tr><tr><td align="right">6.12&nbsp;</td><td><a href="Surrogates.html" class="tocviewlink" data-pltdoc="x">Surrogates</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">interface</span></span></a></td></tr><tr><td><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%2A%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">interface*</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="mzlib_class.html" title="backward to &quot;6 Classes and Objects&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="createclass.html" title="forward to &quot;6.2 Creating Classes&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;createinterface&quot;">6.1<tt>&nbsp;</tt><a name="(part._createinterface)"></a>Creating Interfaces</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=classes.html&amp;version=8.6" class="Sq" data-pltdoc="x">Classes and Objects</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces classes, objects, and interfaces.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._interface))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">interface</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">super-interface-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">name-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">name-clause</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Produces an interface. The <span class="RktVar">id</span>s must be mutually distinct.</div></p><p>Each <span class="RktVar">super-interface-expr</span> is evaluated (in order) when the
+<span class="RktSym"><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%29%29" class="RktStxLink" data-pltdoc="x">interface</a></span> expression is evaluated. The result of each
+<span class="RktVar">super-interface-expr</span> must be an interface value, otherwise
+the <span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised.  The interfaces returned by the
+<span class="RktVar">super-interface-expr</span>s are the new interface&rsquo;s
+superinterfaces, which are all extended by the new interface. Any
+class that implements the new interface also implements all of the
+superinterfaces.</p><p>The result of an <span class="RktSym"><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%29%29" class="RktStxLink" data-pltdoc="x">interface</a></span> expression is an interface that
+includes all of the specified <span class="RktVar">id</span>s, plus all identifiers from
+the superinterfaces. Duplicate identifier names among the
+superinterfaces are ignored, but if a superinterface contains one of
+the <span class="RktVar">id</span>s in the <span class="RktSym"><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%29%29" class="RktStxLink" data-pltdoc="x">interface</a></span> expression, the
+<span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised. A given <span class="RktVar">id</span> may be paired with
+a corresponding <span class="RktVar">contract-expr</span>.</p><p>If no <span class="RktVar">super-interface-expr</span>s are provided, then the derivation
+requirement of the resulting interface is trivial: any class that
+implements the interface must be derived from <span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span>.
+Otherwise, the implementation requirement of the resulting interface
+is the most specific requirement from its superinterfaces. If the
+superinterfaces specify inconsistent derivation requirements, the
+<span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">file-interface&lt;%&gt;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%29%29" class="RktStxLink" data-pltdoc="x">interface</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._open%29%29" class="RktStxLink" data-pltdoc="x">open</a></span><span class="hspace">&nbsp;</span><span class="RktSym">close</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-byte%29%29" class="RktValLink" data-pltdoc="x">read-byte</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-byte%29%29" class="RktValLink" data-pltdoc="x">write-byte</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">directory-interface&lt;%&gt;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%29%29" class="RktStxLink" data-pltdoc="x">interface</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">file-interface&lt;%&gt;</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">file-list</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._-~3em%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>m</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._is-a~3f%2Fc%29%29" class="RktValLink" data-pltdoc="x">is-a?/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">file-interface&lt;%&gt;</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">parent-directory</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._interface*))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">interface*</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">super-interface-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">property-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">val-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">name-clause</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%29%29" class="RktStxLink" data-pltdoc="x">interface</a></span>, but also associates to the interface the
+structure-type properties produced by the <span class="RktVar">property-expr</span>s with
+the corresponding <span class="RktVar">val-expr</span>s.</div></p><p>Whenever the resulting interface (or a sub-interface derived from it)
+is explicitly implemented by a class through the <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form,
+each property is attached with its value to a structure type that
+instantiated by instances of the class. Specifically, the property is
+attached to a structure type with zero immediate fields, which is
+extended to produce the internal structure type for instances of the
+class (so that no information about fields is accessible to the
+structure type property&rsquo;s guard, if any).</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i&lt;%&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%2A%29%29" class="RktStxLink" data-pltdoc="x">interface*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">prop:custom-write</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">obj</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktSym">mode</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">method1</span><span class="hspace">&nbsp;</span><span class="RktSym">method2</span><span class="hspace">&nbsp;</span><span class="RktSym">method3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="mzlib_class.html" title="backward to &quot;6 Classes and Objects&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="createclass.html" title="forward to &quot;6.2 Creating Classes&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/creatingmorestructs.html b/clones/docs.racket-lang.org/reference/creatingmorestructs.html
new file mode 100644
index 00000000..08618347
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/creatingmorestructs.html
@@ -0,0 +1,88 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>5.2&nbsp;Creating Structure Types</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewselflink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">5.1&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Defining Structure Types:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">struct</span></span></a></td></tr><tr><td align="right">5.2&nbsp;</td><td><a href="creatingmorestructs.html" class="tocviewselflink" data-pltdoc="x">Creating Structure Types</a></td></tr><tr><td align="right">5.3&nbsp;</td><td><a href="structprops.html" class="tocviewlink" data-pltdoc="x">Structure Type Properties</a></td></tr><tr><td align="right">5.4&nbsp;</td><td><a href="struct-generics.html" class="tocviewlink" data-pltdoc="x">Generic Interfaces</a></td></tr><tr><td align="right">5.5&nbsp;</td><td><a href="struct-copy.html" class="tocviewlink" data-pltdoc="x">Copying and Updating Structures</a></td></tr><tr><td align="right">5.6&nbsp;</td><td><a href="structutils.html" class="tocviewlink" data-pltdoc="x">Structure Utilities</a></td></tr><tr><td align="right">5.7&nbsp;</td><td><a href="structinfo.html" class="tocviewlink" data-pltdoc="x">Structure Type Transformer Binding</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>struct-<wbr></wbr>type</span></span></a></td></tr><tr><td><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-field-accessor%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>struct-<wbr></wbr>field-<wbr></wbr>accessor</span></span></a></td></tr><tr><td><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-field-mutator%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>struct-<wbr></wbr>field-<wbr></wbr>mutator</span></span></a></td></tr><tr><td><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3asealed%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>sealed</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="define-struct.html" title="backward to &quot;5.1 Defining Structure Types: struct&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="structures.html" title="up to &quot;5 Structures&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="structprops.html" title="forward to &quot;5.3 Structure Type Properties&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;creatingmorestructs&quot;">5.2<tt>&nbsp;</tt><a name="(part._creatingmorestructs)"></a>Creating Structure Types</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-struct-type))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-struct-type</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">super-type</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">init-field-cnt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">auto-field-cnt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">auto-v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">props</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">inspector</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc-spec</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">immutables</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">guard</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">constructor-name</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-type~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type?</a></span></td></tr><tr><td><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-constructor-procedure~3f%29%29" class="RktValLink" data-pltdoc="x">struct-constructor-procedure?</a></span></td></tr><tr><td><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-predicate-procedure~3f%29%29" class="RktValLink" data-pltdoc="x">struct-predicate-procedure?</a></span></td></tr><tr><td><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-accessor-procedure~3f%29%29" class="RktValLink" data-pltdoc="x">struct-accessor-procedure?</a></span></td></tr><tr><td><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-mutator-procedure~3f%29%29" class="RktValLink" data-pltdoc="x">struct-mutator-procedure?</a></span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">super-type</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-type~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">init-field-cnt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">auto-field-cnt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">auto-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">props</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">inspector</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">prefab</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._current-inspector%29%29" class="RktValLink" data-pltdoc="x">current-inspector</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proc-spec</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">immutables</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">guard</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">constructor-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new structure type, unless <span class="RktVar">inspector</span> is
+<span class="RktVal">'</span><span class="RktVal">prefab</span>, in which case <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span> accesses a
+<a href="structures.html#%28tech._prefab%29" data-pltdoc="x">prefab</a> structure type.  The <span class="RktVar">name</span> argument is used
+as the type name. If <span class="RktVar">super-type</span> is not <span class="RktVal">#f</span>, the
+resulting type is a subtype of the corresponding structure type.</div></p><p>The resulting structure type has
+<span class="RktVar">init-field-cnt</span><span style="font-style: italic">+</span><span class="RktVar">auto-field-cnt</span> fields (in
+addition to any fields from <span class="RktVar">super-type</span>), but only
+<span class="RktVar">init-field-cnt</span> constructor arguments (in addition to any
+constructor arguments from <span class="RktVar">super-type</span>). The remaining fields
+are initialized with <span class="RktVar">auto-v</span>. The total field count (including
+<span class="RktVar">super-type</span> fields) must be no more than 32768.</p><p>The <span class="RktVar">props</span> argument is a list of pairs, where the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span>
+of each pair is a structure type property descriptor, and the
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is an arbitrary value. A property can be specified
+multiple times in <span class="RktVar">props</span> (including properties that are
+automatically added by properties that are directly included in
+<span class="RktVar">props</span>) only if the associated values are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>,
+otherwise the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. See <a href="structprops.html" data-pltdoc="x">Structure Type Properties</a>
+for more information about properties. When <span class="RktVar">inspector</span> is
+<span class="RktVal">'</span><span class="RktVal">prefab</span>, then <span class="RktVar">props</span> must be <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span>.</p><p>The <span class="RktVar">inspector</span> argument normally controls access to reflective
+information about the structure type and its instances; see
+<a href="inspectors.html" data-pltdoc="x">Structure Inspectors</a> for more information. If <span class="RktVar">inspector</span> is
+<span class="RktVal">'</span><span class="RktVal">prefab</span>, then the resulting <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure type and
+its instances are always transparent. If <span class="RktVar">inspector</span> is
+<span class="RktVal">#f</span>, then the structure type&rsquo;s instances are transparent.</p><p>If <span class="RktVar">proc-spec</span> is an integer or procedure, instances of the
+structure type act as procedures. See <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="RktValLink" data-pltdoc="x">prop:procedure</a></span> for
+further information.  Providing a non-<span class="RktVal">#f</span> value for
+<span class="RktVar">proc-spec</span> is the same as pairing the value with
+<span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="RktValLink" data-pltdoc="x">prop:procedure</a></span> at the end of <span class="RktVar">props</span>, plus including
+<span class="RktVar">proc-spec</span> in <span class="RktVar">immutables</span> when <span class="RktVar">proc-spec</span> is
+an integer.</p><p>The <span class="RktVar">immutables</span> argument provides a list of field
+positions. Each element in the list must be unique, otherwise
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. Each element must also fall in the range
+<span class="RktVal">0</span> (inclusive) to <span class="RktVar">init-field-cnt</span> (exclusive), otherwise
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>The <span class="RktVar">guard</span> argument is either a procedure of <span style="font-style: italic">n+</span>1<span style="font-style: italic"></span>
+arguments or <span class="RktVal">#f</span>, where <span style="font-style: italic">n</span> is the number of arguments
+for the new structure type&rsquo;s constructor (i.e.,
+<span class="RktVar">init-field-cnt</span> plus constructor arguments implied by
+<span class="RktVar">super-type</span>, if any). If <span class="RktVar">guard</span> is a procedure, then
+the procedure is called whenever an instance of the type is
+constructed, or whenever an instance of a subtype is created.  The
+arguments to <span class="RktVar">guard</span> are the values provided for the
+structure&rsquo;s first <span style="font-style: italic">n</span> fields, followed by the name of the
+instantiated structure type (which is <span class="RktVar">name</span>, unless a subtype
+is instantiated). The <span class="RktVar">guard</span> result must be <span style="font-style: italic">n</span> values,
+which become the actual values for the structure&rsquo;s fields. The
+<span class="RktVar">guard</span> can raise an exception to prevent creation of a
+structure with the given field values. If a structure subtype has its
+own guard, the subtype guard is applied first, and the first <span style="font-style: italic">n</span>
+values produced by the subtype&rsquo;s guard procedure become the first
+<span style="font-style: italic">n</span> arguments to <span class="RktVar">guard</span>. When <span class="RktVar">inspector</span> is
+<span class="RktVal">'</span><span class="RktVal">prefab</span>, then <span class="RktVar">guard</span> must be <span class="RktVal">#f</span>.</p><p>If <span class="RktVar">constructor-name</span> is not <span class="RktVal">#f</span>, it is used as the
+name of the generated <a href="define-struct.html#%28tech._constructor%29" class="techoutside" data-pltdoc="x"><span class="techinside">constructor</span></a> procedure as returned by
+<span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span> or in the printed form of the constructor value.</p><p>The result of <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span> is five values:</p><ul><li><p>a <a href="define-struct.html#%28tech._structure._type._descriptor%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type descriptor</span></a>,</p></li><li><p>a <a href="define-struct.html#%28tech._constructor%29" class="techoutside" data-pltdoc="x"><span class="techinside">constructor</span></a> procedure,</p></li><li><p>a <a href="define-struct.html#%28tech._predicate%29" class="techoutside" data-pltdoc="x"><span class="techinside">predicate</span></a> procedure,</p></li><li><p>an <a href="define-struct.html#%28tech._accessor%29" class="techoutside" data-pltdoc="x"><span class="techinside">accessor</span></a> procedure, which consumes a structure and a field
+index between <span style="font-style: italic"></span>0<span style="font-style: italic"></span> (inclusive) and
+<span class="RktVar">init-field-cnt</span><span style="font-style: italic">+</span><span class="RktVar">auto-field-cnt</span> (exclusive),
+and</p></li><li><p>a <a href="define-struct.html#%28tech._mutator%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutator</span></a> procedure, which consumes a structure, a field
+index, and a field value.</p></li></ul><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">struct:a</span><span class="hspace">&nbsp;</span><span class="RktSym">make-a</span><span class="hspace">&nbsp;</span><span class="RktSym">a?</span><span class="hspace">&nbsp;</span><span class="RktSym">a-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">a-set!</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">uninitialized</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">an-a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-a</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">a-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">an-a</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'y</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">a-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">an-a</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'uninitialized</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a-first</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-field-accessor%29%29" class="RktValLink" data-pltdoc="x">make-struct-field-accessor</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a-ref</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">a-first</span><span class="hspace">&nbsp;</span><span class="RktSym">an-a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'x</span></p></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">struct:b</span><span class="hspace">&nbsp;</span><span class="RktSym">make-b</span><span class="hspace">&nbsp;</span><span class="RktSym">b?</span><span class="hspace">&nbsp;</span><span class="RktSym">b-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">b-set!</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktSym">struct:a</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b-uninitialized</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a-b</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-b</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">y</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">z</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">a-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">a-b</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'y</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">a-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">a-b</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'uninitialized</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">b-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">a-b</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'z</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">b-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">a-b</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'b-uninitialized</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">b-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">a-b</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'b-uninitialized</span></p></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">struct:c</span><span class="hspace">&nbsp;</span><span class="RktSym">make-c</span><span class="hspace">&nbsp;</span><span class="RktSym">c?</span><span class="hspace">&nbsp;</span><span class="RktSym">c-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">c-set!</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="hspace">&nbsp;</span><span class="RktSym">struct:b</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._make-inspector%29%29" class="RktValLink" data-pltdoc="x">make-inspector</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">guard checks for a number, and makes it inexact</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">a1</span><span class="hspace">&nbsp;</span><span class="RktSym">a2</span><span class="hspace">&nbsp;</span><span class="RktSym">b1</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._unless%29%29" class="RktStxLink" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3esymbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;symbol</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"make-~a"</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"second field must be a number"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-~3einexact%29%29" class="RktValLink" data-pltdoc="x">exact-&gt;inexact</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">b1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">make-c</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">y</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">z</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">make-c: second field must be a number</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a-c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-c</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">z</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">a-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">a-c</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2.0</span></p></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p1</span><span class="hspace">&nbsp;</span><span class="RktVal">#s</span><span class="RktVal">(</span><span class="RktVal">p</span><span class="hspace">&nbsp;</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">c</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">struct:p</span><span class="hspace">&nbsp;</span><span class="RktSym">make-p</span><span class="hspace">&nbsp;</span><span class="RktSym">p?</span><span class="hspace">&nbsp;</span><span class="RktSym">p-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">p-set!</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">p</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">prefab</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">p?</span><span class="hspace">&nbsp;</span><span class="RktSym">p1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">p-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">p1</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'a</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">make-p</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">y</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">z</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#s(p x y z)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-struct-field-accessor))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-field-accessor%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-struct-field-accessor</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">accessor-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">field-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">field/proc-name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arg-contract-str</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">realm</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">accessor-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-accessor-procedure~3f%29%29" class="RktValLink" data-pltdoc="x">struct-accessor-procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">field-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">field/proc-name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-~3estring%29%29" class="RktValLink" data-pltdoc="x">symbol-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"field~a"</span><span class="hspace">&nbsp;</span><span class="RktVar">field-pos</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg-contract-str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">realm</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racket</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a field accessor that is equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">accessor-proc</span><span class="stt"> </span><span class="RktSym">s</span><span class="stt"> </span><span class="RktVar">field-pos</span><span class="RktPn">)</span><span class="RktPn">)</span>.  The <span class="RktVar">accessor-proc</span> must be
+an <a href="define-struct.html#%28tech._accessor%29" class="techoutside" data-pltdoc="x"><span class="techinside">accessor</span></a> returned by <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span>.</div></p><p>The <span class="RktVar">field/proc-name</span> argument determines the name of the
+resulting procedure for error reporting and debugging purposes. If
+<span class="RktVar">field/proc-name</span> is a symbol and <span class="RktVar">arg-contract-str</span> is not
+<span class="RktVal">#f</span>, then <span class="RktVar">field/proc-name</span> is used as the procedure
+name. If <span class="RktVar">field/proc-name</span> is a symbol and
+<span class="RktVar">arg-contract-str</span> is <span class="RktVal">#f</span>, then <span class="RktVar">field/proc-name</span> is
+combined with the name of <span class="RktVar">accessor-proc</span>&rsquo;s structure type to
+form the procedure name. If <span class="RktVar">field/proc-name</span> is <span class="RktVal">#f</span>,
+then <span class="RktVal">'</span><span class="RktVal">accessor</span> is used as the procedure name.</p><p>The <span class="RktVar">arg-contract-str</span> argument determines how the accessor
+procedure reports an error when it is applied to a value that is not
+an instance of the <span class="RktVar">accessor-proc</span>&rsquo;s structure type. If it is a
+string or symbol, the text of the string or symbol is used as a
+contract for error reporting. Otherwise, contract text is synthesized
+from the name of <span class="RktVar">accessor-proc</span>&rsquo;s structure type.</p><p>The <span class="RktVar">realm</span> argument is also used for error reporting. It
+specifies a <a href="exns.html#%28tech._realm%29" class="techoutside" data-pltdoc="x"><span class="techinside">realm</span></a> that an error-message adjuster may use to
+determine how to adjust an error message. The <span class="RktVar">realm</span> argument
+also determines the result of <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-realm%29%29" class="RktValLink" data-pltdoc="x">procedure-realm</a></span> for the
+accessor procedure.</p><p>For examples, see <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span>.</p><p class="SHistory">Changed in version 8.4.0.2 of package <span class="stt">base</span>: Added the <span class="RktVar">arg-contract-str</span>
+ and <span class="RktVar">realm</span> arguments.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-struct-field-mutator))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-field-mutator%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-struct-field-mutator</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">mutator-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">field-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">field/proc-name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arg-contract-str</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">realm</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mutator-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-mutator-procedure~3f%29%29" class="RktValLink" data-pltdoc="x">struct-mutator-procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">field-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">field/proc-name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-~3estring%29%29" class="RktValLink" data-pltdoc="x">symbol-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"field~a"</span><span class="hspace">&nbsp;</span><span class="RktVar">field-pos</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg-contract-str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">realm</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racket</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a field mutator that is equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">s</span><span class="stt"> </span><span class="RktSym">v</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">mutator-proc</span><span class="stt"> </span><span class="RktSym">s</span><span class="stt"> </span><span class="RktVar">field-pos</span><span class="stt"> </span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span>.  The <span class="RktVar">mutator-proc</span> must be
+a <a href="define-struct.html#%28tech._mutator%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutator</span></a> returned by <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span>.</div></p><p>The <span class="RktSym">field-name</span>, <span class="RktVar">arg-contract-str</span>, and <span class="RktVar">realm</span>
+arguments are used for error and debugging purposes analogous to the
+same arguments to <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-field-accessor%29%29" class="RktValLink" data-pltdoc="x">make-struct-field-accessor</a></span>.</p><p>For examples, see <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span>.</p><p class="SHistory">Changed in version 8.4.0.2 of package <span class="stt">base</span>: Added the <span class="RktVar">arg-contract-str</span>
+ and <span class="RktVar">realm</span> arguments.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._prop~3asealed))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3asealed%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:sealed</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property</span></a> that declares a structure type as
+<a name="(tech._sealed)"></a><span style="font-style: italic">sealed</span>. The value associated with the property is ignored;
+the presence of the property itself makes the structure type
+sealed.</div></p><p>A <a href="creatingmorestructs.html#%28tech._sealed%29" class="techoutside" data-pltdoc="x"><span class="techinside">sealed</span></a> structure type cannot be used as the supertype of
+another structure type. Declaring a structure type as <a href="creatingmorestructs.html#%28tech._sealed%29" class="techoutside" data-pltdoc="x"><span class="techinside">sealed</span></a> is
+typically just a performance hint, since checking for an instance of a
+sealed structure type can be slightly faster than checking for an
+instance of a structure type that might have subtypes.</p><p class="SHistory">Added in version 8.0.0.7 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="define-struct.html" title="backward to &quot;5.1 Defining Structure Types: struct&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="structures.html" title="up to &quot;5 Structures&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="structprops.html" title="forward to &quot;5.3 Structure Type Properties&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/creatingunits.html b/clones/docs.racket-lang.org/reference/creatingunits.html
new file mode 100644
index 00000000..37935c31
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/creatingunits.html
@@ -0,0 +1,101 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7.1&nbsp;Creating Units</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="creatingunits.html" class="tocviewselflink" data-pltdoc="x">Creating Units</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="invokingunits.html" class="tocviewlink" data-pltdoc="x">Invoking Units</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="compoundunits.html" class="tocviewlink" data-pltdoc="x">Linking Units and Creating Compound Units</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="linkinference.html" class="tocviewlink" data-pltdoc="x">Inferred Linking</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="Generating_A_Unit_from_Context.html" class="tocviewlink" data-pltdoc="x">Generating A Unit from Context</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="Structural_Matching.html" class="tocviewlink" data-pltdoc="x">Structural Matching</a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="define-sig-form.html" class="tocviewlink" data-pltdoc="x">Extending the Syntax of Signatures</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Unit_Utilities.html" class="tocviewlink" data-pltdoc="x">Unit Utilities</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="unitcontracts.html" class="tocviewlink" data-pltdoc="x">Unit Contracts</a></td></tr><tr><td align="right">7.10&nbsp;</td><td><a href="single-unit.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Unit Modules</a></td></tr><tr><td align="right">7.11&nbsp;</td><td><a href="Single-Signature_Modules.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Signature Modules</a></td></tr><tr><td align="right">7.12&nbsp;</td><td><a href="Transformer_Helpers.html" class="tocviewlink" data-pltdoc="x">Transformer Helpers</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unit</span></span></a></td></tr><tr><td><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>signature</span></span></a></td></tr><tr><td><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._open%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">open</span></span></a></td></tr><tr><td><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-values-for-export%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>values-<wbr></wbr>for-<wbr></wbr>export</span></span></a></td></tr><tr><td><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._contracted%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">contracted</span></span></a></td></tr><tr><td><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._only%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">only</span></span></a></td></tr><tr><td><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._except%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">except</span></span></a></td></tr><tr><td><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._rename%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">rename</span></span></a></td></tr><tr><td><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._prefix%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">prefix</span></span></a></td></tr><tr><td><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">import</span></span></a></td></tr><tr><td><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">export</span></span></a></td></tr><tr><td><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">link</span></span></a></td></tr><tr><td><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._tag%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">tag</span></span></a></td></tr><tr><td><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._init-depend%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">init-<wbr></wbr>depend</span></span></a></td></tr><tr><td><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._extends%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">extends</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="mzlib_unit.html" title="backward to &quot;7 Units&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="invokingunits.html" title="forward to &quot;7.2 Invoking Units&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;creatingunits&quot;">7.1<tt>&nbsp;</tt><a name="(part._creatingunits)"></a>Creating Units</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._unit))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">unit</a></span></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">init-depends-decl</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">unit-body-expr-or-defn</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">tagged-sig-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">sig-spec</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._tag%29%29" class="RktStxLink" data-pltdoc="x">tag</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">sig-spec</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">sig-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">sig-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._prefix%29%29" class="RktStxLink" data-pltdoc="x">prefix</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">sig-spec</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._rename%29%29" class="RktStxLink" data-pltdoc="x">rename</a></span><span class="hspace">&nbsp;</span><span class="RktVar">sig-spec</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._only%29%29" class="RktStxLink" data-pltdoc="x">only</a></span><span class="hspace">&nbsp;</span><span class="RktVar">sig-spec</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._except%29%29" class="RktStxLink" data-pltdoc="x">except</a></span><span class="hspace">&nbsp;</span><span class="RktVar">sig-spec</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">init-depends-decl</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._init-depend%29%29" class="RktStxLink" data-pltdoc="x">init-depend</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">tagged-sig-id</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">sig-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._tag%29%29" class="RktStxLink" data-pltdoc="x">tag</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">sig-id</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Produces a unit that encapsulates its
+<span class="RktVar">unit-body-expr-or-defn</span>s. Expressions in the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span>
+body can refer to identifiers bound by the <span class="RktVar">sig-spec</span>s of the
+<span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span> clause, and the body must include one definition for
+each identifier of a <span class="RktVar">sig-spec</span> in the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span> clause.
+An identifier that is exported cannot be <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>ed in either the
+defining unit or in importing units, although the implicit assignment
+to initialize the variable may be visible as a mutation.</div></p><p>Each import or export <span class="RktVar">sig-spec</span> ultimately refers to a
+<span class="RktVar">sig-id</span>, which is an identifier that is bound to a signature
+by <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature%29%29" class="RktStxLink" data-pltdoc="x">define-signature</a></span>. The <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> of each
+identifier imported through a <span class="RktVar">sig-id</span> starts with the lexical
+information of the <span class="RktVar">sig-id</span>; see <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature%29%29" class="RktStxLink" data-pltdoc="x">define-signature</a></span> form
+more information.</p><p>In a specific import or export position, the set of identifiers bound
+or required by a particular <span class="RktVar">sig-id</span> can be adjusted in a few
+ways:</p><ul><li><p><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._prefix%29%29" class="RktStxLink" data-pltdoc="x">prefix</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">sig-spec</span><span class="RktPn">)</span> as an import binds the same as
+<span class="RktVar">sig-spec</span>, except that each binding is prefixed with <span class="RktVar">id</span>.
+As an export, this form causes definitions using the <span class="RktVar">id</span>
+prefix to satisfy the exports required by <span class="RktVar">sig-spec</span>.</p></li><li><p><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._rename%29%29" class="RktStxLink" data-pltdoc="x">rename</a></span><span class="stt"> </span><span class="RktVar">sig-spec</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> as an import binds the
+same as <span class="RktVar">sig-spec</span>, except that the first <span class="RktVar">id</span> is used
+for the binding instead of the second <span class="RktVar">id</span> (where
+<span class="RktVar">sig-spec</span> by itself must imply a binding that is
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._bound-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">bound-identifier=?</a></span> to second <span class="RktVar">id</span>).  As an export,
+this form causes a definition for the first <span class="RktVar">id</span> to satisfy
+the export named by the second <span class="RktVar">id</span> in <span class="RktVar">sig-spec</span>.</p></li><li><p><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._only%29%29" class="RktStxLink" data-pltdoc="x">only</a></span><span class="stt"> </span><span class="RktVar">sig-spec</span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> as an import binds the same as
+<span class="RktVar">sig-spec</span>, but restricted to just the listed <span class="RktVar">id</span>s
+(where <span class="RktVar">sig-spec</span> by itself must imply a binding that is
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._bound-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">bound-identifier=?</a></span> to each <span class="RktVar">id</span>).  This form is not
+allowed for an export.</p></li><li><p><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._except%29%29" class="RktStxLink" data-pltdoc="x">except</a></span><span class="stt"> </span><span class="RktVar">sig-spec</span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> as an import binds the same
+as <span class="RktVar">sig-spec</span>, but excluding all listed <span class="RktVar">id</span>s (where
+<span class="RktVar">sig-spec</span> by itself must imply a binding that is
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._bound-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">bound-identifier=?</a></span> to each <span class="RktVar">id</span>).  This form is not
+allowed for an export.</p></li></ul><p>As suggested by the grammar, these adjustments to a signature can be
+nested arbitrarily.</p><p>A unit&rsquo;s declared imports are matched with actual supplied imports by
+signature. That is, the order in which imports are supplied to a unit
+when linking is irrelevant; all that matters is the signature
+implemented by each supplied import. One actual import must be
+provided for each declared import. Similarly, when a unit implements
+multiple signatures, the order of the export signatures does not
+matter.</p><p>To support multiple imports or exports for the same signature, an
+import or export can be tagged using the form <span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._tag%29%29" class="RktStxLink" data-pltdoc="x">tag</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">sig-spec</span><span class="RktPn">)</span>. When an import declaration of a unit is
+tagged, then one actual import must be given the same tag (with the
+same signature) when the unit is linked. Similarly, when an export
+declaration is tagged for a unit, then references to that particular
+export must explicitly use the tag.</p><p>A unit is prohibited syntactically from importing two signatures that
+are not distinct, unless they have different tags; two signatures are
+<span style="font-style: italic">distinct</span> only if they share no ancestor through
+<span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._extends%29%29" class="RktStxLink" data-pltdoc="x">extends</a></span>. The same syntactic constraint applies to exported
+signatures. In addition, a unit is prohibited syntactically from
+importing the same identifier twice (after renaming and other
+transformations on a <span class="RktVar">sig-spec</span>), exporting the same identifier
+twice (again, after renaming), or exporting an identifier that is
+imported.</p><p>When units are linked, the bodies of the linked units are
+executed in an order that is specified at the linking site. An
+optional <span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._init-depend%29%29" class="RktStxLink" data-pltdoc="x">init-depend</a></span><span class="stt"> </span><span class="RktVar">tagged-sig-id</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>
+declaration constrains the allowed orders of linking by specifying
+that the current unit must be initialized after the unit that supplies
+the corresponding import. Each <span class="RktVar">tagged-sig-id</span> in an
+<span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._init-depend%29%29" class="RktStxLink" data-pltdoc="x">init-depend</a></span> declaration must have a corresponding import in the
+<span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span> clause.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._define-signature))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-signature</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sig-id</span><span class="hspace">&nbsp;</span><span class="RktVar">extension-decl</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">sig-elem</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">extension-decl</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._extends%29%29" class="RktStxLink" data-pltdoc="x">extends</a></span><span class="hspace">&nbsp;</span><span class="RktVar">sig-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">sig-elem</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-values-for-export%29%29" class="RktStxLink" data-pltdoc="x">define-values-for-export</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._contracted%29%29" class="RktStxLink" data-pltdoc="x">contracted</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">contract</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._open%29%29" class="RktStxLink" data-pltdoc="x">open</a></span><span class="hspace">&nbsp;</span><span class="RktVar">sig-spec</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">field</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">struct-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">sig-form-id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">datum</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">field</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mutable</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">struct-option</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:mutable</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:constructor-name</span><span class="hspace">&nbsp;</span><span class="RktVar">constructor-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktVar">constructor-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:omit-constructor</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:omit-define-syntaxes</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:omit-define-values</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Binds an identifier <span class="RktVar">sig-id</span> to a signature that specifies a group
+of bindings for import or export:</div></p><ul><li><p>Each <span class="RktVar">id</span> in a signature declaration means that a unit
+implementing the signature must supply a variable definition for the
+<span class="RktVar">id</span>. That is, <span class="RktVar">id</span> is available for use in units
+importing the signature, and <span class="RktVar">id</span> must be defined by units
+exporting the signature.</p></li><li><p>Each <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span> form in a signature declaration
+introduces a macro that is available for use in any unit that
+imports the signature.  Free variables in the definition&rsquo;s
+<span class="RktVar">expr</span> refer to other identifiers in the signature first, or
+the context of the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature%29%29" class="RktStxLink" data-pltdoc="x">define-signature</a></span> form if the signature
+does not include the identifier.</p></li><li><p>Each <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span> form in a signature declaration
+introduces code that effectively prefixes every unit that imports the
+signature.  Free variables in the definition&rsquo;s <span class="RktVar">expr</span> are
+treated the same as for <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span>.</p></li><li><p>Each <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-values-for-export%29%29" class="RktStxLink" data-pltdoc="x">define-values-for-export</a></span> form in a signature
+declaration introduces code that effectively suffixes every unit that
+exports the signature.  Free variables in the definition&rsquo;s
+<span class="RktVar">expr</span> are treated the same as for <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span>.</p></li><li><p>Each <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._contracted%29%29" class="RktStxLink" data-pltdoc="x">contracted</a></span> form in a signature declaration means
+that a unit exporting the signature must supply a variable definition
+for each <span class="RktVar">id</span> in that form.  If the signature is imported, then
+uses of <span class="RktVar">id</span> inside the unit are protected by the appropriate
+contracts using the unit as the negative blame.  If the signature is
+exported, then the exported values are protected by the appropriate
+contracts which use the unit as the positive blame, but internal uses
+of the exported identifiers are not protected.  Variables in the
+<span class="RktVar">contract</span> expressions are treated the same as for
+<span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span>.</p></li><li><p>Each <span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._open%29%29" class="RktStxLink" data-pltdoc="x">open</a></span><span class="stt"> </span><span class="RktVar">sig-spec</span><span class="RktPn">)</span> adds to the signature everything
+specified by <span class="RktVar">sig-spec</span>.</p></li><li><p>Each <span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">field</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">struct-option</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>  adds
+all of the identifiers that would be bound by <span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">field</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym">field-option</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>, where the extra option
+<span class="RktPn">#:omit-constructor</span> omits the constructor identifier.</p></li><li><p>Each <span class="RktPn">(</span><span class="RktVar">sig-form-id</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">datum</span><span class="RktPn">)</span> extends the signature in a
+way that is defined by <span class="RktVar">sig-form-id</span>, which must be bound by
+<span class="RktSym"><a href="define-sig-form.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature-form%29%29" class="RktStxLink" data-pltdoc="x">define-signature-form</a></span>.  One such binding is for
+<span class="RktSym"><a href="define-sig-form.html#%28form._%28%28lib._racket%2Funit..rkt%29._struct%2Fctc%29%29" class="RktStxLink" data-pltdoc="x">struct/ctc</a></span>.</p></li></ul><p>When a <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature%29%29" class="RktStxLink" data-pltdoc="x">define-signature</a></span> form includes an <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._extends%29%29" class="RktStxLink" data-pltdoc="x">extends</a></span>
+clause, then the define signature automatically includes everything in
+the extended signature. Furthermore, any implementation of the new
+signature can be used as an implementation of the extended signature.</p><p>The <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> of each <span class="RktVar">id</span> within a signature is
+compared to the lexical information of <span class="RktVar">sig-id</span>. The extra scopes
+of <span class="RktVar">id</span> relative to <span class="RktVar">sig-id</span> are recorded for the
+<span class="RktVar">id</span>. When the <span class="RktVar">sig-id</span> is used as a reference (e.g., in
+the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span> clause of <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span>), a variant of <span class="RktVar">id</span>
+is created for the referencing context by starting with the lexical
+information of the referencing <span class="RktVar">sig-id</span>, and then adding the extra
+scopes for <span class="RktVar">id</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._open))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._open%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">open</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sig-spec</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Allowed only in a <span class="RktVar">sig-elem</span>; see <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature%29%29" class="RktStxLink" data-pltdoc="x">define-signature</a></span>.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._define-values-for-export))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-values-for-export%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-values-for-export</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Allowed only in a <span class="RktVar">sig-elem</span>; see <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature%29%29" class="RktStxLink" data-pltdoc="x">define-signature</a></span>.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._contracted))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._contracted%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">contracted</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">contract</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Allowed only in a <span class="RktVar">sig-elem</span>; see <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature%29%29" class="RktStxLink" data-pltdoc="x">define-signature</a></span>.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._only))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._only%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">only</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sig-spec</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Allowed only in a <span class="RktVar">sig-spec</span>; see <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span>.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._except))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._except%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">except</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sig-spec</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Allowed only in a <span class="RktVar">sig-spec</span>; see <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span>.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._rename))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._rename%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">rename</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sig-spec</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Allowed only in a <span class="RktVar">sig-spec</span>; see <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span>.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._prefix))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._prefix%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">prefix</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">sig-spec</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Allowed only in a <span class="RktVar">sig-spec</span>; see <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span>.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._import))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">import</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Allowed only in certain forms; see, for example, <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span>.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._export))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">export</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Allowed only in certain forms; see, for example, <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span>.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._link))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">link</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">linkage-decl</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Allowed only in certain forms; see, for example, <span class="RktSym"><a href="compoundunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%29%29" class="RktStxLink" data-pltdoc="x">compound-unit</a></span>.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._tag))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._tag%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">tag</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">sig-spec</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._tag%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">tag</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">sig-id</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Allowed only in certain forms; see, for example, <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span>.</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._init-depend))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._init-depend%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">init-depend</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Allowed only in a <span class="RktSym">init-depend-decl</span>; see <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/unit..rkt)._extends))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._extends%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">extends</a></span></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Allowed only within <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature%29%29" class="RktStxLink" data-pltdoc="x">define-signature</a></span>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="mzlib_unit.html" title="backward to &quot;7 Units&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="invokingunits.html" title="forward to &quot;7.2 Invoking Units&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/custodians.html b/clones/docs.racket-lang.org/reference/custodians.html
new file mode 100644
index 00000000..93a56811
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/custodians.html
@@ -0,0 +1,64 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14.7&nbsp;Custodians</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewselflink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Namespaces.html" class="tocviewlink" data-pltdoc="x">Namespaces</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="eval.html" class="tocviewlink" data-pltdoc="x">Evaluation and Compilation</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="load-lang.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>load</span></span> Language</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="Module_Names_and_Loading.html" class="tocviewlink" data-pltdoc="x">Module Names and Loading</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="chaperones.html" class="tocviewlink" data-pltdoc="x">Impersonators and Chaperones</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="securityguards.html" class="tocviewlink" data-pltdoc="x">Security Guards</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="custodians.html" class="tocviewselflink" data-pltdoc="x">Custodians</a></td></tr><tr><td align="right">14.8&nbsp;</td><td><a href="threadgroups.html" class="tocviewlink" data-pltdoc="x">Thread Groups</a></td></tr><tr><td align="right">14.9&nbsp;</td><td><a href="inspectors.html" class="tocviewlink" data-pltdoc="x">Structure Inspectors</a></td></tr><tr><td align="right">14.10&nbsp;</td><td><a href="modprotect.html" class="tocviewlink" data-pltdoc="x">Code Inspectors</a></td></tr><tr><td align="right">14.11&nbsp;</td><td><a href="plumbers.html" class="tocviewlink" data-pltdoc="x">Plumbers</a></td></tr><tr><td align="right">14.12&nbsp;</td><td><a href="Sandboxed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Sandboxed Evaluation</a></td></tr><tr><td align="right">14.13&nbsp;</td><td><a href="repl-module.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>repl</span></span> Library</a></td></tr><tr><td align="right">14.14&nbsp;</td><td><a href="linklets.html" class="tocviewlink" data-pltdoc="x">Linklets and the Core Compiler</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custodian?</span></span></a></td></tr><tr><td><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._make-custodian%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>custodian</span></span></a></td></tr><tr><td><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-shutdown-all%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custodian-<wbr></wbr>shutdown-<wbr></wbr>all</span></span></a></td></tr><tr><td><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-shut-down~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custodian-<wbr></wbr>shut-<wbr></wbr>down?</span></span></a></td></tr><tr><td><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._current-custodian%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>custodian</span></span></a></td></tr><tr><td><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-managed-list%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custodian-<wbr></wbr>managed-<wbr></wbr>list</span></span></a></td></tr><tr><td><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-memory-accounting-available~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custodian-<wbr></wbr>memory-<wbr></wbr>accounting-<wbr></wbr>available?</span></span></a></td></tr><tr><td><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-require-memory%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custodian-<wbr></wbr>require-<wbr></wbr>memory</span></span></a></td></tr><tr><td><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-limit-memory%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custodian-<wbr></wbr>limit-<wbr></wbr>memory</span></span></a></td></tr><tr><td><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._make-custodian-box%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>custodian-<wbr></wbr>box</span></span></a></td></tr><tr><td><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-box~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custodian-<wbr></wbr>box?</span></span></a></td></tr><tr><td><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-box-value%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custodian-<wbr></wbr>box-<wbr></wbr>value</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="securityguards.html" title="backward to &quot;14.6 Security Guards&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="threadgroups.html" title="forward to &quot;14.8 Thread Groups&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;custodians&quot;">14.7<tt>&nbsp;</tt><a name="(part._custodians)"></a>Custodians</h4><p>See <a href="eval-model.html#%28part._custodian-model%29" data-pltdoc="x">Custodians</a> for basic information on the Racket
+custodian model.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._custodian~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">custodian?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="eval-model.html#%28tech._custodian%29" class="techoutside" data-pltdoc="x"><span class="techinside">custodian</span></a> value,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-custodian))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._make-custodian%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-custodian</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">cust</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian~3f%29%29" class="RktValLink" data-pltdoc="x">custodian?</a></span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">cust</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian~3f%29%29" class="RktValLink" data-pltdoc="x">custodian?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-shut-down~3f%29%29" class="RktValLink" data-pltdoc="x">custodian-shut-down?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._current-custodian%29%29" class="RktValLink" data-pltdoc="x">current-custodian</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new custodian that is subordinate to <span class="RktVar">cust</span>. When
+<span class="RktVar">cust</span> is directed (via <span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-shutdown-all%29%29" class="RktValLink" data-pltdoc="x">custodian-shutdown-all</a></span>) to
+shut down all of its managed values, the new subordinate custodian is
+automatically directed to shut down its managed values as well.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._custodian-shutdown-all))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-shutdown-all%29%29" class="RktValDef RktValLink" data-pltdoc="x">custodian-shutdown-all</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">cust</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cust</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian~3f%29%29" class="RktValLink" data-pltdoc="x">custodian?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>In <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/gui/base</span></a>,
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=windowing-overview.html%23%2528tech._eventspace%2529&amp;version=8.6" class="techoutside Sq" data-pltdoc="x"><span class="techinside">eventspaces</span></a> managed by <span class="RktVar">cust</span> are also
+shut down.</p></blockquote></blockquote></blockquote></div></p><p>Closes all <a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file-stream ports</span></a>, <a href="tcp.html#%28tech._tcp._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">TCP ports</span></a>, <a href="tcp.html#%28tech._tcp._listener%29" class="techoutside" data-pltdoc="x"><span class="techinside">TCP
+listeners</span></a>, and <a href="udp.html#%28tech._udp._socket%29" class="techoutside" data-pltdoc="x"><span class="techinside">UDP sockets</span></a> that are managed by <span class="RktVar">cust</span>
+(and its subordinates), and empties all <a href="eval-model.html#%28tech._custodian._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">custodian box</span></a>es
+associated with <span class="RktVar">cust</span> (and its subordinates). It also removes
+<span class="RktVar">cust</span> (and its subordinates) as managers of all threads; when
+a thread has no managers, it is killed (or suspended; see
+<span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%2Fsuspend-to-kill%29%29" class="RktValLink" data-pltdoc="x">thread/suspend-to-kill</a></span>) If the current thread is to be
+killed, all other shut-down actions take place before killing the
+thread.</p><p>If <span class="RktVar">cust</span> is already shut down, then
+<span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-shutdown-all%29%29" class="RktValLink" data-pltdoc="x">custodian-shutdown-all</a></span> has no effect. When a custodian is
+shut down and it has subordinate custodians, the subordinates are not
+only shut down, they no longer count as subordinates.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._custodian-shut-down~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-shut-down~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">custodian-shut-down?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">cust</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cust</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian~3f%29%29" class="RktValLink" data-pltdoc="x">custodian?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">cust</span> has been shut down with
+<span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-shutdown-all%29%29" class="RktValLink" data-pltdoc="x">custodian-shutdown-all</a></span> or if it was a subordinate of a
+custodian that is shut down, <span class="RktVal">#f</span> otherwise.</div></p><p class="SHistory">Added in version 6.11.0.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-custodian))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._current-custodian%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-custodian</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian~3f%29%29" class="RktValLink" data-pltdoc="x">custodian?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._current-custodian%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-custodian</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">cust</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cust</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian~3f%29%29" class="RktValLink" data-pltdoc="x">custodian?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Custodians also manage <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=windowing-overview.html%23%2528tech._eventspace%2529&amp;version=8.6" class="techoutside Sq" data-pltdoc="x"><span class="techinside">eventspaces</span></a>
+from <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/gui/base</span></a>.</p></blockquote></blockquote></blockquote></div></p><p>A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines a custodian that assumes responsibility
+for newly created threads, <a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file-stream ports</span></a>, TCP ports,
+<a href="tcp.html#%28tech._tcp._listener%29" class="techoutside" data-pltdoc="x"><span class="techinside">TCP listeners</span></a>, <a href="udp.html#%28tech._udp._socket%29" class="techoutside" data-pltdoc="x"><span class="techinside">UDP sockets</span></a>, and <a href="bytestrings.html#%28tech._byte._converter%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte converters</span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._custodian-managed-list))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-managed-list%29%29" class="RktValDef RktValLink" data-pltdoc="x">custodian-managed-list</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">cust</span><span class="hspace">&nbsp;</span><span class="RktVar">super</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cust</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian~3f%29%29" class="RktValLink" data-pltdoc="x">custodian?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">super</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian~3f%29%29" class="RktValLink" data-pltdoc="x">custodian?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of immediately managed objects (not including
+<a href="eval-model.html#%28tech._custodian._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">custodian box</span></a>es) and subordinate custodians for <span class="RktVar">cust</span>,
+where <span class="RktVar">cust</span> is itself subordinate to <span class="RktVar">super</span> (directly
+or indirectly). If <span class="RktVar">cust</span> is not strictly subordinate to
+<span class="RktVar">super</span>, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p>If <span class="RktVar">cust</span> has been shut down, the result is <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span>. If
+<span class="RktVar">cust</span> was a subordinate of a custodian that was shut
+down, then it cannot be a subordinate of <span class="RktVar">super</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._custodian-memory-accounting-available~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-memory-accounting-available~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">custodian-memory-accounting-available?</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Memory accounting is normally available, but not in
+the <a href="implementations.html#%28tech._cgc%29" class="techoutside" data-pltdoc="x"><span class="techinside">CGC</span></a> implementation.</p></blockquote></blockquote></blockquote></div></p><p>Returns <span class="RktVal">#t</span> if Racket is compiled with support for
+per-custodian memory accounting, <span class="RktVal">#f</span> otherwise.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._custodian-require-memory))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-require-memory%29%29" class="RktValDef RktValLink" data-pltdoc="x">custodian-require-memory</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">limit-cust</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">need-amt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">stop-cust</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit-cust</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian~3f%29%29" class="RktValLink" data-pltdoc="x">custodian?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">need-amt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stop-cust</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian~3f%29%29" class="RktValLink" data-pltdoc="x">custodian?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Registers a required-memory check if Racket is compiled with
+support for per-custodian memory accounting, otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aunsupported%29%29" class="RktValLink" data-pltdoc="x">exn:fail:unsupported</a></span> exception is raised.</div></p><p>If a check is registered, and if Racket later reaches a state after
+garbage collection (see <a href="eval-model.html#%28part._gc-model%29" data-pltdoc="x">Garbage Collection</a>) where allocating
+<span class="RktVar">need-amt</span> bytes charged to <span class="RktVar">limit-cust</span> would fail or
+trigger some shutdown, then <span class="RktVar">stop-cust</span> is shut down.</p><p>The <span class="RktVar">stop-cust</span> must be a subordinate custodian of
+<span class="RktVar">limit-cust</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._custodian-limit-memory))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-limit-memory%29%29" class="RktValDef RktValLink" data-pltdoc="x">custodian-limit-memory</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">limit-cust</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">limit-amt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">stop-cust</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit-cust</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian~3f%29%29" class="RktValLink" data-pltdoc="x">custodian?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit-amt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stop-cust</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian~3f%29%29" class="RktValLink" data-pltdoc="x">custodian?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">limit-cust</span></td></tr></table></blockquote></div><div class="SIntrapara">Registers a limited-memory check if Racket is compiled with
+support for per-custodian memory accounting, otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aunsupported%29%29" class="RktValLink" data-pltdoc="x">exn:fail:unsupported</a></span> exception is raised.</div></p><p>If a check is registered, and if Racket later reaches a state
+after garbage collection (see <a href="eval-model.html#%28part._gc-model%29" data-pltdoc="x">Garbage Collection</a>) where
+<span class="RktVar">limit-cust</span> owns more than <span class="RktVar">limit-amt</span> bytes, then
+<span class="RktVar">stop-cust</span> is shut down.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>A custodian&rsquo;s limit is checked only after a garbage
+collection, except that it may also be checked during
+certain large allocations that are individually larger
+than the custodian&rsquo;s limit. A single garbage collection
+may shut down multiple custodians, even if shutting down
+only one of the custodians would have reduced memory use
+for other custodians.</p></blockquote></blockquote></blockquote><p>For reliable shutdown, <span class="RktVar">limit-amt</span> for
+<span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-limit-memory%29%29" class="RktValLink" data-pltdoc="x">custodian-limit-memory</a></span> must be much lower than the total
+amount of memory available (minus the size of memory that is
+potentially used and not charged to <span class="RktVar">limit-cust</span>). Moreover, if
+individual allocations that are initially charged to
+<span class="RktVar">limit-cust</span> can be arbitrarily large, then <span class="RktVar">stop-cust</span>
+must be the same as <span class="RktVar">limit-cust</span>, so that excessively large
+immediate allocations can be rejected with an
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aout-of-memory%29%29" class="RktValLink" data-pltdoc="x">exn:fail:out-of-memory</a></span> exception.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-custodian-box))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._make-custodian-box%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-custodian-box</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">cust</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-box~3f%29%29" class="RktValLink" data-pltdoc="x">custodian-box?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cust</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian~3f%29%29" class="RktValLink" data-pltdoc="x">custodian?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="eval-model.html#%28tech._custodian._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">custodian box</span></a> that contains <span class="RktVar">v</span> as long as
+<span class="RktVar">cust</span> has not been shut down. If <span class="RktVar">cust</span> is already
+shut down, the custodian box&rsquo;s value is immediately removed.</div></p><p>A <a href="eval-model.html#%28tech._custodian._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">custodian box</span></a> is a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> (see <a href="sync.html" data-pltdoc="x">Events</a>).
+The <a href="eval-model.html#%28tech._custodian._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">custodian box</span></a> becomes ready when its custodian is shut down;
+the <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> of a <a href="eval-model.html#%28tech._custodian._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">custodian box</span></a> is the <a href="eval-model.html#%28tech._custodian._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">custodian box</span></a> itself.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._custodian-box~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-box~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">custodian-box?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="eval-model.html#%28tech._custodian._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">custodian box</span></a> produced
+by <span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._make-custodian-box%29%29" class="RktValLink" data-pltdoc="x">make-custodian-box</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._custodian-box-value))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-box-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">custodian-box-value</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">cb</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cb</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-box~3f%29%29" class="RktValLink" data-pltdoc="x">custodian-box?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the value in the given <a href="eval-model.html#%28tech._custodian._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">custodian box</span></a>, or <span class="RktVal">#f</span> if
+the value has been removed.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="securityguards.html" title="backward to &quot;14.6 Security Guards&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="threadgroups.html" title="forward to &quot;14.8 Thread Groups&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/customport.html b/clones/docs.racket-lang.org/reference/customport.html
new file mode 100644
index 00000000..5e54b44f
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/customport.html
@@ -0,0 +1,370 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.1.9&nbsp;Custom Ports</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewselflink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1.1&nbsp;</td><td><a href="encodings.html" class="tocviewlink" data-pltdoc="x">Encodings and Locales</a></td></tr><tr><td align="right">13.1.2&nbsp;</td><td><a href="port-ops.html" class="tocviewlink" data-pltdoc="x">Managing Ports</a></td></tr><tr><td align="right">13.1.3&nbsp;</td><td><a href="port-buffers.html" class="tocviewlink" data-pltdoc="x">Port Buffers and Positions</a></td></tr><tr><td align="right">13.1.4&nbsp;</td><td><a href="linecol.html" class="tocviewlink" data-pltdoc="x">Counting Positions, Lines, and Columns</a></td></tr><tr><td align="right">13.1.5&nbsp;</td><td><a href="file-ports.html" class="tocviewlink" data-pltdoc="x">File Ports</a></td></tr><tr><td align="right">13.1.6&nbsp;</td><td><a href="stringport.html" class="tocviewlink" data-pltdoc="x">String Ports</a></td></tr><tr><td align="right">13.1.7&nbsp;</td><td><a href="pipeports.html" class="tocviewlink" data-pltdoc="x">Pipes</a></td></tr><tr><td align="right">13.1.8&nbsp;</td><td><a href="portstructs.html" class="tocviewlink" data-pltdoc="x">Structures as Ports</a></td></tr><tr><td align="right">13.1.9&nbsp;</td><td><a href="customport.html" class="tocviewselflink" data-pltdoc="x">Custom Ports</a></td></tr><tr><td align="right">13.1.10&nbsp;</td><td><a href="port-lib.html" class="tocviewlink" data-pltdoc="x">More Port Constructors, Procedures, and Events</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-input-port%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>input-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-output-port%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>output-<wbr></wbr>port</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="portstructs.html" title="backward to &quot;13.1.8 Structures as Ports&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ports.html" title="up to &quot;13.1 Ports&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="port-lib.html" title="forward to &quot;13.1.10 More Port Constructors, Procedures, and Events&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;customport&quot;">13.1.9<tt>&nbsp;</tt><a name="(part._customport)"></a>Custom Ports</h5><p>The <span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-input-port%29%29" class="RktValLink" data-pltdoc="x">make-input-port</a></span> and <span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-output-port%29%29" class="RktValLink" data-pltdoc="x">make-output-port</a></span> procedures
+create <a name="(tech._custom._port)"></a><span style="font-style: italic">custom ports</span> with arbitrary control procedures (much like
+implementing a device driver). Custom ports are mainly useful to
+obtain fine control over the action of committing bytes as read or
+written.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-input-port))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-input-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-input-port</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">read-in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">peek</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">close</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">get-progress-evt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">commit</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">get-location</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">count-lines!</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">init-position</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">buffer-mode</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">read-in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">peek</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">close</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">get-progress-evt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">commit</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">get-location</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">count-lines!</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">init-position</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._port~3f%29%29" class="RktValLink" data-pltdoc="x">port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">1</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">buffer-mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._case-~3e%29%29" class="RktStxLink" data-pltdoc="x">case-&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">block</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">none</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">block</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">none</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Creates an input port, which is immediately open for reading. If
+<span class="RktVar">close</span> procedure has no side effects, then the port need not
+be explicitly closed. See also <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._make-input-port%2Fread-to-peek%29%29" class="RktValLink" data-pltdoc="x">make-input-port/read-to-peek</a></span>.</div></p><p>The arguments implement the port as follows:</p><ul><li><p><span class="RktVar">name</span> &#8212;<wbr></wbr> the name for the input port.</p></li><li><p><div class="SIntrapara"><span class="RktVar">read-in</span> &#8212;<wbr></wbr> either an input port, in which case reads
+    are redirected to the given port, or a procedure that takes a single
+    argument:
+    a mutable byte string to receive read bytes. The procedure&rsquo;s
+    result is one of the following:
+    </div><div class="SIntrapara"><ul><li><p>the number of bytes read, as an exact, non-negative integer;</p></li><li><p><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>;</p></li><li><p>a procedure of arity four (representing a &ldquo;special&rdquo;
+result, as discussed <a href="customport.html#%28elem._special%29" data-pltdoc="x">further below</a>),
+but a procedure result is allowed only
+when <span class="RktVar">peek</span> is not <span class="RktVal">#f</span>;</p></li><li><p>a <a href="pipeports.html#%28tech._pipe%29" data-pltdoc="x">pipe</a> input port that supplies bytes to be
+used as long as the pipe has content (see
+<span class="RktSym"><a href="pipeports.html#%28def._%28%28quote._~23~25kernel%29._pipe-content-length%29%29" class="RktValLink" data-pltdoc="x">pipe-content-length</a></span>) or until <span class="RktVar">read-in</span> or
+<span class="RktVar">peek</span> is called again; or</p></li><li><p>a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> (see <a href="sync.html" data-pltdoc="x">Events</a>) other
+than a pipe input port or procedure of arity four; the event
+becomes ready when the read is complete (roughly): the event&rsquo;s
+value can be one of the above four results or another event like
+itself; in the last case, a reading process loops with
+<span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span> until it gets a non-event result.</p></li></ul></div></p><p>The <span class="RktVar">read-in</span> procedure must not block indefinitely. If no
+    bytes are immediately available for reading, the <span class="RktVar">read-in</span>
+    must return <span class="RktVal">0</span> or an event, and preferably an event (to
+    avoid busy waits). The <span class="RktVar">read-in</span> should not return
+    <span class="RktVal">0</span> (or an event whose value is <span class="RktVal">0</span>) when data is
+    available in the port, otherwise polling the port will behave
+    incorrectly. An event result from an event can also break polling.</p><p>If the result of a <span class="RktVar">read-in</span> call is not one of the above
+    values, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. If a returned integer is
+    larger than the supplied byte string&rsquo;s length, the
+    <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. If <span class="RktVar">peek</span> is <span class="RktVal">#f</span> and
+    a procedure for a <a href="customport.html#%28elem._special%29" data-pltdoc="x">special</a> result is returned,
+    the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>The <span class="RktVar">read-in</span> procedure can report an error by raising an
+    exception, but only if no bytes are read. Similarly, no bytes
+    should be read if <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>, an event, or a procedure is
+    returned. In other words, no bytes should be lost due to spurious
+    exceptions or non-byte data.</p><p>A port&rsquo;s reading procedure may be called in multiple threads
+    simultaneously (if the port is accessible in multiple threads),
+    and the port is responsible for its own internal
+    synchronization. Note that improper implementation of such
+    synchronization mechanisms might cause a non-blocking read
+    procedure to block indefinitely.</p><p>If the result is a pipe input port, then previous
+    <span class="RktVar">get-progress-evt</span> calls whose event is not yet ready must
+    have been the pipe input port itself. Furthermore,
+    <span class="RktVar">get-progress-evt</span> must continue to return the pipe as long
+    as it contains data, or until the <span class="RktVar">read-in</span> or
+    <span class="RktSym">peek-in</span> procedure is called again (instead of using the
+    pipe, for whatever reason). If <span class="RktVar">read-in</span> or
+    <span class="RktSym">peek-in</span> is called, any previously associated pipe (as
+    returned by a previous call) is disassociated from the
+    port and is not in use by any other thread as a result of the
+    previous association.</p><p>If <span class="RktVar">peek</span>, <span class="RktVar">get-progress-evt</span>, and
+    <span class="RktVar">commit</span> are all provided and
+    non-<span class="RktVal">#f</span>, then the following is an acceptable implementation
+    of <span class="RktVar">read-in</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bstr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A%29%29" class="RktStxLink" data-pltdoc="x">let*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">progress-evt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">get-progress-evt</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">peek</span><span class="hspace">&nbsp;</span><span class="RktSym">bstr</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">progress-evt</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">sync/timeout</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">progress-evt</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">try again</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._wrap-evt%29%29" class="RktValLink" data-pltdoc="x">wrap-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">sync, try again</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">try again</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">commit</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">progress-evt</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._always-evt%29%29" class="RktValLink" data-pltdoc="x">always-evt</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">got a result</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">try again</span></td></tr></table></blockquote><p>An implementor may choose not to implement the <span class="RktVar">peek</span>,
+    <span class="RktVar">get-progress-evt</span>, and <span class="RktVar">commit</span>
+    procedures, however, and even an implementor who does supply
+    them may provide a different <span class="RktVar">read-in</span>
+    that uses a fast path for non-blocking reads.</p><p>In an input port is provided for <span class="RktVar">read-in</span>, then an input port
+    must also be provided for <span class="RktVar">peek</span>.</p></li><li><p><span class="RktVar">peek</span> &#8212;<wbr></wbr> either <span class="RktVal">#f</span>, an input port (in which
+case peeks are redirected to the given port), or a procedure
+that takes three arguments:</p><ul><li><p>a mutable byte string to receive peeked bytes;</p></li><li><p>a non-negative number of bytes (or
+<a href="customport.html#%28elem._special%29" data-pltdoc="x">specials</a>) to skip before peeking; and</p></li><li><p>either <span class="RktVal">#f</span> or a progress event produced by
+<span class="RktVar">get-progress-evt</span>.</p></li></ul><p>The results and conventions for <span class="RktVar">peek</span> are mostly the same
+ as for <span class="RktVar">read-in</span>. The main difference is in the handling of
+ the progress event, if it is not <span class="RktVal">#f</span>.  If the given
+ progress event becomes ready, the <span class="RktVar">peek</span> must abort any
+ skip attempts and not peek any values. In particular,
+ <span class="RktVar">peek</span> must not peek any values if the progress event is
+ initially ready. If the port has been closed, the progress event
+ should be ready, in which case <span class="RktVar">peek</span> should complete
+ (instead of failing because the port is closed).</p><p>Unlike <span class="RktVar">read-in</span>, <span class="RktVar">peek</span> should produce
+ <span class="RktVal">#f</span> (or an event whose value is <span class="RktVal">#f</span>) if no bytes
+ were peeked because the progress event became ready. Like
+ <span class="RktVar">read-in</span>, a <span class="RktVal">0</span> result indicates that another
+ attempt is likely to succeed, so <span class="RktVal">0</span> is inappropriate when
+ the progress event is ready. Also like <span class="RktVar">read-in</span>,
+ <span class="RktVar">peek</span> must not block indefinitely.</p><p>The skip count provided to <span class="RktVar">peek</span> is a number of bytes (or
+ <a href="customport.html#%28elem._special%29" data-pltdoc="x">specials</a>) that must remain present in the
+ port&#8212;<wbr></wbr>in addition to the peek results&#8212;<wbr></wbr>when the peek results are
+ reported. If the skip count requests reading data that is past an eof,
+ it should not, and instead produce <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> (until the eof is
+ consumed).</p><p>If a progress event is supplied, then the peek is
+ effectively canceled when another process reads data before the
+ given number can be skipped. If a progress event is not supplied
+ and data is read, then the peek must effectively restart with the
+ original skip count.</p><p>The system does not check that multiple peeks return consistent
+ results, or that peeking and reading produce consistent results,
+ although they must.</p><p>If <span class="RktVar">peek</span> is <span class="RktVal">#f</span>, then peeking for the port is
+ implemented automatically in terms of reads, but with several
+ limitations. First, the automatic implementation is not
+ thread-safe. Second, the automatic implementation cannot handle
+ <a href="customport.html#%28elem._special%29" data-pltdoc="x">special</a> results (non-byte and non-eof), so
+ <span class="RktVar">read-in</span> cannot return a procedure for a
+ <a href="customport.html#%28elem._special%29" data-pltdoc="x">special</a> when <span class="RktVar">peek</span> is
+ <span class="RktVal">#f</span>. Finally, the automatic peek implementation is
+ incompatible with progress events, so if <span class="RktVar">peek</span> is
+ <span class="RktVal">#f</span>, then <span class="RktVar">get-progress-evt</span> and <span class="RktVar">commit</span> must
+ be <span class="RktVal">#f</span>. See also <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._make-input-port%2Fread-to-peek%29%29" class="RktValLink" data-pltdoc="x">make-input-port/read-to-peek</a></span>,
+ which implements peeking in terms of <span class="RktVar">read-in</span> without
+ these constraints.</p><p>In an input port is provided for <span class="RktVar">peek</span>, then an input port
+ must also be provided for <span class="RktVar">read-in</span>.</p></li><li><p><span class="RktVar">close</span> &#8212;<wbr></wbr> a procedure of zero arguments that is
+called to close the port. The port is not considered closed until
+the closing procedure returns. The port&rsquo;s procedures will never be
+used again via the port after it is closed. However, the closing
+procedure can be called simultaneously in multiple threads (if the
+port is accessible in multiple threads), and it may be called
+during a call to the other procedures in another thread; in the
+latter case, any outstanding reads and peeks should be terminated
+with an error.</p></li><li><p><span class="RktVar">get-progress-evt</span> &#8212;<wbr></wbr> either <span class="RktVal">#f</span> (the
+default), or a procedure that takes no arguments and returns an
+event. The event must become ready only after data is next read
+from the port or the port is closed. If the port is already closed,
+the event must be ready. After the event becomes
+ready, it must remain so. See the description of <span class="RktVar">read-in</span>
+for information about the allowed results of this function when
+<span class="RktVar">read-in</span> returns a pipe input port. See also
+<span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-peek-evt%29%29" class="RktValLink" data-pltdoc="x">semaphore-peek-evt</a></span>, which is sometimes useful for
+implementing <span class="RktVar">get-progress-evt</span>.</p><p>If <span class="RktVar">get-progress-evt</span> is <span class="RktVal">#f</span>, then
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-provides-progress-evts~3f%29%29" class="RktValLink" data-pltdoc="x">port-provides-progress-evts?</a></span> applied to the port will
+produce <span class="RktVal">#f</span>, and the port will not be a valid argument to
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-progress-evt%29%29" class="RktValLink" data-pltdoc="x">port-progress-evt</a></span>.</p><p>The result event will not be exposed directly by
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-progress-evt%29%29" class="RktValLink" data-pltdoc="x">port-progress-evt</a></span>. Instead, it will be wrapped in an
+event for which <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._progress-evt~3f%29%29" class="RktValLink" data-pltdoc="x">progress-evt?</a></span> returns true.</p></li><li><p><span class="RktVar">commit</span> &#8212;<wbr></wbr> either <span class="RktVal">#f</span> (the
+default), or a procedure that takes three arguments:</p><ul><li><p>an exact, positive integer <span style="font-style: italic">k</span><span style="vertical-align: sub; font-size: 80%"><span style="font-style: italic">r</span></span><span style="font-style: italic"></span>;</p></li><li><p>a progress event produced by <span class="RktVar">get-progress-evt</span>;</p></li><li><p>an event, <span class="RktVar">done</span>, that is either a channel-put
+event, channel, semaphore, semaphore-peek event, always
+event, or never event.</p></li></ul><p>A <span style="font-style: italic">commit</span> corresponds to removing data from the stream
+ that was previously peeked, but only if no other process removed
+ data first. (The removed data does not need to be reported,
+ because it has been peeked already.) More precisely, assuming
+ that <span style="font-style: italic">k</span><span style="vertical-align: sub; font-size: 80%"><span style="font-style: italic">p</span></span><span style="font-style: italic"></span> bytes, <a href="customport.html#%28elem._special%29" data-pltdoc="x">specials</a>, and
+ mid-stream <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>s have been previously peeked or skipped
+ at the start of the port&rsquo;s stream, <span class="RktVar">commit</span> must satisfy
+ the following constraints:</p><ul><li><p>It must return only when the commit is complete or when the
+given progress event becomes ready.</p></li><li><p>It must commit only if <span style="font-style: italic">k</span><span style="vertical-align: sub; font-size: 80%"><span style="font-style: italic">p</span></span><span style="font-style: italic"></span> is positive.</p></li><li><p>If it commits, then it must do so with either <span style="font-style: italic">k</span><span style="vertical-align: sub; font-size: 80%"><span style="font-style: italic">r</span></span><span style="font-style: italic"></span> items
+or <span style="font-style: italic">k</span><span style="vertical-align: sub; font-size: 80%"><span style="font-style: italic">p</span></span><span style="font-style: italic"></span> items, whichever is smaller, and only if <span style="font-style: italic">k</span><span style="vertical-align: sub; font-size: 80%"><span style="font-style: italic">p</span></span><span style="font-style: italic"></span> is
+positive.</p></li><li><p>It must never choose <span class="RktVar">done</span> in a synchronization
+after the given progress event is ready, or after <span class="RktVar">done</span>
+has been synchronized once.</p></li><li><p>It must not treat any data as read from the port unless
+<span class="RktVar">done</span> is chosen in a synchronization.</p></li><li><p>It must not block indefinitely if <span class="RktVar">done</span> is ready;
+it must return soon after the read completes or soon after the
+given progress event is ready, whichever is first.</p></li><li><p>It can report an error by raising an exception, but only if
+no data has been committed. In other words, no data should be lost due to
+an exception, including a break exception.</p></li><li><p>It must return a true value if data has been committed,
+<span class="RktVal">#f</span> otherwise. When it returns a value, the given
+progress event must be ready (perhaps because data has just been
+committed).</p></li><li><p>It should return a byte string as a true result when line
+counting is enabled and <span class="RktVar">get-location</span> is <span class="RktVal">#f</span> (so
+that line counting is implemented the default way); the result
+byte string represents the data that was committed for the
+purposes of character and line counting. If any other true result
+is returned when a byte string is expected, it is treated like a
+byte string where each byte corresponds to a non-newline
+character.</p></li><li><p>It must raise an exception if no data (including
+<span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>) has been peeked from the beginning of the port&rsquo;s
+stream, or if it would have to block indefinitely to wait for the
+given progress event to become ready.</p></li></ul><p>A call to <span class="RktVar">commit</span> is <span class="RktSym"><a href="breakhandler.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize-break%29%29" class="RktStxLink" data-pltdoc="x">parameterize-break</a></span>ed to
+disable breaks.</p></li><li><p><span class="RktVar">get-location</span> &#8212;<wbr></wbr> either <span class="RktVal">#f</span> (the
+default), or a procedure that takes no arguments and returns three
+values: the line number for the next item in the port&rsquo;s stream (a
+positive number or <span class="RktVal">#f</span>), the column number for the next
+item in the port&rsquo;s stream (a non-negative number or <span class="RktVal">#f</span>),
+and the position for the next item in the port&rsquo;s stream (a
+positive number or <span class="RktVal">#f</span>). See also <a href="linecol.html" data-pltdoc="x">Counting Positions, Lines, and Columns</a>.</p><p>This procedure is called to implement <span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-next-location%29%29" class="RktValLink" data-pltdoc="x">port-next-location</a></span>,
+but only if line counting is enabled for the port via
+<span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-count-lines%21%29%29" class="RktValLink" data-pltdoc="x">port-count-lines!</a></span> (in which case <span class="RktVar">count-lines!</span> is
+called). The <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> and <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> procedures
+assume that reading a non-whitespace character increments the
+column and position by one.</p></li><li><p><span class="RktVar">count-lines!</span> &#8212;<wbr></wbr> a procedure of no arguments
+that is called if and when line counting is enabled for the port.
+The default procedure is <span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span>.</p></li><li><p><span class="RktVar">init-position</span> &#8212;<wbr></wbr> normally an exact, positive integer
+that determines the position of the port&rsquo;s first item, which is
+used by <span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%29%29" class="RktValLink" data-pltdoc="x">file-position</a></span> or when line counting is
+<span style="font-style: italic">not</span> enabled for the port. The default is <span class="RktVal">1</span>.  If
+<span class="RktVar">init-position</span> is <span class="RktVal">#f</span>, the port is treated as
+having an unknown position. If <span class="RktVar">init-position</span> is a port,
+then the given port&rsquo;s position is always used for the new port&rsquo;s
+position. If <span class="RktVar">init-position</span> is a procedure, it is called
+as needed to obtain the port&rsquo;s position.</p></li><li><p><span class="RktVar">buffer-mode</span> &#8212;<wbr></wbr> either <span class="RktVal">#f</span> (the default) or a
+procedure that accepts zero or one arguments. If
+<span class="RktVar">buffer-mode</span> is <span class="RktVal">#f</span>, then the resulting port does
+not support a buffer-mode setting. Otherwise, the procedure is
+called with one symbol argument (<span class="RktVal">'</span><span class="RktVal">block</span> or
+<span class="RktVal">'</span><span class="RktVal">none</span>) to set the buffer mode, and it is called with zero
+arguments to get the current buffer mode. In the latter case, the
+result must be <span class="RktVal">'</span><span class="RktVal">block</span>, <span class="RktVal">'</span><span class="RktVal">none</span>, or <span class="RktVal">#f</span>
+(unknown). See <a href="port-buffers.html" data-pltdoc="x">Port Buffers and Positions</a> for more information on
+buffer modes.</p></li></ul><p><a name="(elem._special)"></a><span style="font-weight: bold">&ldquo;Special&rdquo; results:</span> When
+ <span class="RktVar">read-in</span> or <span class="RktVar">peek</span> (or an event produced by one of
+ these) returns a procedure, the procedure is used to obtain a
+ non-byte result. (This non-byte result is <span style="font-style: italic">not</span> intended to
+ return a character or <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>; in particular, <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char%29%29" class="RktValLink" data-pltdoc="x">read-char</a></span>
+ raises an exception if it encounters a special-result procedure, even
+ if the procedure produces a byte.) A special-result procedure must
+ accept four arguments that represent a source location. The first
+ argument is <span class="RktVal">#f</span> when the special read is triggered by <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>
+ or <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read/recursive</a></span>.</p><p>The special-value procedure can return an arbitrary value, and it
+ will be called zero or one times (not necessarily before further
+ reads or peeks from the port). See <a href="reader-procs.html" data-pltdoc="x">Reader-Extension Procedures</a> for
+ more details on the procedure&rsquo;s result.</p><p>If <span class="RktVar">read-in</span> or <span class="RktVar">peek</span> returns a special
+ procedure when called by any reading procedure other than
+ <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>, <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>, <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char-or-special%29%29" class="RktValLink" data-pltdoc="x">read-char-or-special</a></span>,
+ <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-char-or-special%29%29" class="RktValLink" data-pltdoc="x">peek-char-or-special</a></span>, <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-byte-or-special%29%29" class="RktValLink" data-pltdoc="x">read-byte-or-special</a></span>, or
+ <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-byte-or-special%29%29" class="RktValLink" data-pltdoc="x">peek-byte-or-special</a></span>, then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">A port with no input...</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Easy: </span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-bytes%29%29" class="RktValLink" data-pltdoc="x">open-input-bytes</a></span><span class="stt"> </span><span class="RktVal">#""</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Hard:</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">/dev/null-in</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-input-port%29%29" class="RktValLink" data-pltdoc="x">make-input-port</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">null</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">skip</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">progress-evt</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._never-evt%29%29" class="RktValLink" data-pltdoc="x">never-evt</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">progress-evt</span><span class="hspace">&nbsp;</span><span class="RktSym">done-evt</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"no successful peeks!"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char%29%29" class="RktValLink" data-pltdoc="x">read-char</a></span><span class="hspace">&nbsp;</span><span class="RktSym">/dev/null-in</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;eof&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-char%29%29" class="RktValLink" data-pltdoc="x">peek-char</a></span><span class="hspace">&nbsp;</span><span class="RktSym">/dev/null-in</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;eof&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-byte-or-special%29%29" class="RktValLink" data-pltdoc="x">read-byte-or-special</a></span><span class="hspace">&nbsp;</span><span class="RktSym">/dev/null-in</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;eof&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-byte-or-special%29%29" class="RktValLink" data-pltdoc="x">peek-byte-or-special</a></span><span class="hspace">&nbsp;</span><span class="RktSym">/dev/null-in</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;eof&gt;</span></p></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">A port that produces a stream of 1s:</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">infinite-ones</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-input-port%29%29" class="RktValLink" data-pltdoc="x">make-input-port</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">ones</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-set%21%29%29" class="RktValLink" data-pltdoc="x">bytes-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-~3einteger%29%29" class="RktValLink" data-pltdoc="x">char-&gt;integer</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="RktValLink" data-pltdoc="x">read-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktSym">infinite-ones</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"11111"</span></p></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">But we can</span><span class="RktCmt">'</span><span class="RktCmt">t peek ahead arbitrarily far, because the</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">automatic peek must record the skipped bytes, so</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">we</span><span class="RktCmt">'</span><span class="RktCmt">d run out of memory.</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">An infinite stream of 1s with a specific peek procedure:</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">infinite-ones</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">one!</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-set%21%29%29" class="RktValLink" data-pltdoc="x">bytes-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-~3einteger%29%29" class="RktValLink" data-pltdoc="x">char-&gt;integer</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-input-port%29%29" class="RktValLink" data-pltdoc="x">make-input-port</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">ones</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">one!</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">skip</span><span class="hspace">&nbsp;</span><span class="RktSym">progress-evt</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">one!</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="RktValLink" data-pltdoc="x">read-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktSym">infinite-ones</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"11111"</span></p></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Now we can peek ahead arbitrarily far:</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-string%29%29" class="RktValLink" data-pltdoc="x">peek-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">5000</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">infinite-ones</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"11111"</span></p></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">The port doesn</span><span class="RktCmt">'</span><span class="RktCmt">t supply procedures to implement progress events:</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-provides-progress-evts~3f%29%29" class="RktValLink" data-pltdoc="x">port-provides-progress-evts?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">infinite-ones</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-progress-evt%29%29" class="RktValLink" data-pltdoc="x">port-progress-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">infinite-ones</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">port-progress-evt: port does not provide progress evts</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">port: #&lt;input-port:ones&gt;</span></p></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Non-byte port results:</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">infinite-voids</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-input-port%29%29" class="RktValLink" data-pltdoc="x">make-input-port</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">voids</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktSym">args</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">void</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">skip</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktSym">args</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">void</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char%29%29" class="RktValLink" data-pltdoc="x">read-char</a></span><span class="hspace">&nbsp;</span><span class="RktSym">infinite-voids</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">read-char: non-character in an unsupported context</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">port: #&lt;input-port:voids&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char-or-special%29%29" class="RktValLink" data-pltdoc="x">read-char-or-special</a></span><span class="hspace">&nbsp;</span><span class="RktSym">infinite-voids</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'void</span></p></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">This port produces 0, 1, 2, 0, 1, 2, etc., but it is not</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">thread-safe, because multiple threads might read and change </span><span class="RktSym">n</span><span class="RktCmt">.</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mod3-cycle/one-thread</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A%29%29" class="RktStxLink" data-pltdoc="x">let*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">mod!</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">delta</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-set%21%29%29" class="RktValLink" data-pltdoc="x">bytes-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">48</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._modulo%29%29" class="RktValLink" data-pltdoc="x">modulo</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">delta</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-input-port%29%29" class="RktValLink" data-pltdoc="x">make-input-port</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">mod3-cycle/not-thread-safe</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._modulo%29%29" class="RktValLink" data-pltdoc="x">modulo</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mod!</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">skip</span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mod!</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">skip</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="RktValLink" data-pltdoc="x">read-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktSym">mod3-cycle/one-thread</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"01201"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-string%29%29" class="RktValLink" data-pltdoc="x">peek-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">5000</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">mod3-cycle/one-thread</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"20120"</span></p></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Same thing, but thread-safe and kill-safe, and with progress</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">events. Only the server thread touches the stateful part</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">directly. (See the output port examples for a simpler thread-safe</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">example, but this one is more general.)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-mod3-cycle</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">read-req-ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._make-channel%29%29" class="RktValLink" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">peek-req-ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._make-channel%29%29" class="RktValLink" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">progress-req-ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._make-channel%29%29" class="RktValLink" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">commit-req-ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._make-channel%29%29" class="RktValLink" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">close-req-ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._make-channel%29%29" class="RktValLink" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">closed?</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">progress-sema</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mod!</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">delta</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-set%21%29%29" class="RktValLink" data-pltdoc="x">bytes-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">48</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._modulo%29%29" class="RktValLink" data-pltdoc="x">modulo</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">delta</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">-</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">The server has a list of outstanding commit requests,</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"> and it also must service each port operation (read, </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"> progress-evt, etc.)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">serve</span><span class="hspace">&nbsp;</span><span class="RktSym">commit-reqs</span><span class="hspace">&nbsp;</span><span class="RktSym">response-evts</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt%29%29" class="RktValLink" data-pltdoc="x">handle-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">read-req-ch</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">handle-read</span><span class="hspace">&nbsp;</span><span class="RktSym">commit-reqs</span><span class="hspace">&nbsp;</span><span class="RktSym">response-evts</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt%29%29" class="RktValLink" data-pltdoc="x">handle-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">progress-req-ch</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">handle-progress</span><span class="hspace">&nbsp;</span><span class="RktSym">commit-reqs</span><span class="hspace">&nbsp;</span><span class="RktSym">response-evts</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt%29%29" class="RktValLink" data-pltdoc="x">handle-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">commit-req-ch</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">add-commit</span><span class="hspace">&nbsp;</span><span class="RktSym">commit-reqs</span><span class="hspace">&nbsp;</span><span class="RktSym">response-evts</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt%29%29" class="RktValLink" data-pltdoc="x">handle-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">close-req-ch</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">handle-close</span><span class="hspace">&nbsp;</span><span class="RktSym">commit-reqs</span><span class="hspace">&nbsp;</span><span class="RktSym">response-evts</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._append%29%29" class="RktValLink" data-pltdoc="x">append</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-handle-response</span><span class="hspace">&nbsp;</span><span class="RktSym">commit-reqs</span><span class="hspace">&nbsp;</span><span class="RktSym">response-evts</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">response-evts</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-handle-commit</span><span class="hspace">&nbsp;</span><span class="RktSym">commit-reqs</span><span class="hspace">&nbsp;</span><span class="RktSym">response-evts</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">commit-reqs</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Read/peek request: fill in the string and commit</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">handle-read</span><span class="hspace">&nbsp;</span><span class="RktSym">commit-reqs</span><span class="hspace">&nbsp;</span><span class="RktSym">response-evts</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">skip</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadr%29%29" class="RktValLink" data-pltdoc="x">cadr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caddr%29%29" class="RktValLink" data-pltdoc="x">caddr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">nack</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadddr%29%29" class="RktValLink" data-pltdoc="x">cadddr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">evt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddddr%29%29" class="RktValLink" data-pltdoc="x">cddddr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">peek?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddddr%29%29" class="RktValLink" data-pltdoc="x">cddddr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">fail?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">sync/timeout</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._unless%29%29" class="RktStxLink" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktSym">closed?</span><span class="hspace">&nbsp;</span><span class="RktSym">fail?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mod!</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">skip</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._unless%29%29" class="RktStxLink" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktSym">peek?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">commit!</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Add an event to respond:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">serve</span><span class="hspace">&nbsp;</span><span class="RktSym">commit-reqs</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._choice-evt%29%29" class="RktValLink" data-pltdoc="x">choice-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">nack</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel-put-evt%29%29" class="RktValLink" data-pltdoc="x">channel-put-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktSym">closed?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fail?</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">response-evts</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Progress request: send a peek evt for the current </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"> progress-sema</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">handle-progress</span><span class="hspace">&nbsp;</span><span class="RktSym">commit-reqs</span><span class="hspace">&nbsp;</span><span class="RktSym">response-evts</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">nack</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._unless%29%29" class="RktStxLink" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktSym">progress-sema</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">progress-sema</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._make-semaphore%29%29" class="RktValLink" data-pltdoc="x">make-semaphore</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktSym">closed?</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Add an event to respond:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">serve</span><span class="hspace">&nbsp;</span><span class="RktSym">commit-reqs</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._choice-evt%29%29" class="RktValLink" data-pltdoc="x">choice-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">nack</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel-put-evt%29%29" class="RktValLink" data-pltdoc="x">channel-put-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">ch</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-peek-evt%29%29" class="RktValLink" data-pltdoc="x">semaphore-peek-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">progress-sema</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">response-evts</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Commit request: add the request to the list</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">add-commit</span><span class="hspace">&nbsp;</span><span class="RktSym">commit-reqs</span><span class="hspace">&nbsp;</span><span class="RktSym">response-evts</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">serve</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktSym">commit-reqs</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">response-evts</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Commit handling: watch out for progress, in which case</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"> the response is a commit failure; otherwise, try</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"> to sync for a commit. In either event, remove the</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"> request from the list</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">make-handle-commit</span><span class="hspace">&nbsp;</span><span class="RktSym">commit-reqs</span><span class="hspace">&nbsp;</span><span class="RktSym">response-evts</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">progress-evt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadr%29%29" class="RktValLink" data-pltdoc="x">cadr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">done-evt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caddr%29%29" class="RktValLink" data-pltdoc="x">caddr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadddr%29%29" class="RktValLink" data-pltdoc="x">cadddr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">nack</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddddr%29%29" class="RktValLink" data-pltdoc="x">cddddr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Note: we don</span><span class="RktCmt">'</span><span class="RktCmt">t check that k is </span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c~3d%29%29" class="RktValLink" data-pltdoc="x">&lt;=</a></span><span class="RktCmt"> the sum of</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"> previous peeks, because the entire stream is actually</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"> known, but we could send an exception in that case.</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._choice-evt%29%29" class="RktValLink" data-pltdoc="x">choice-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt%29%29" class="RktValLink" data-pltdoc="x">handle-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">progress-evt</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nack</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel-put-evt%29%29" class="RktValLink" data-pltdoc="x">channel-put-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">serve</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remq%29%29" class="RktValLink" data-pltdoc="x">remq</a></span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktSym">commit-reqs</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">response-evts</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Only create an event to satisfy done-evt if progress-evt</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"> isn</span><span class="RktCmt">'</span><span class="RktCmt">t already ready.</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Afterward, if progress-evt becomes ready, then this</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"> event-making function will be called again, because</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"> the server controls all posts to progress-evt.</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">sync/timeout</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">progress-evt</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._never-evt%29%29" class="RktValLink" data-pltdoc="x">never-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt%29%29" class="RktValLink" data-pltdoc="x">handle-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">done-evt</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">commit!</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nack</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel-put-evt%29%29" class="RktValLink" data-pltdoc="x">channel-put-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">serve</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remq%29%29" class="RktValLink" data-pltdoc="x">remq</a></span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktSym">commit-reqs</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">response-evts</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Response handling: as soon as the respondee listens,</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"> remove the response</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">make-handle-response</span><span class="hspace">&nbsp;</span><span class="RktSym">commit-reqs</span><span class="hspace">&nbsp;</span><span class="RktSym">response-evts</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt%29%29" class="RktValLink" data-pltdoc="x">handle-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">serve</span><span class="hspace">&nbsp;</span><span class="RktSym">commit-reqs</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remq%29%29" class="RktValLink" data-pltdoc="x">remq</a></span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span><span class="hspace">&nbsp;</span><span class="RktSym">response-evts</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Close handling: post the progress sema, if any, and set</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">the </span><span class="RktSym">closed?</span><span class="RktCmt"> flag</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">handle-close</span><span class="hspace">&nbsp;</span><span class="RktSym">commit-reqs</span><span class="hspace">&nbsp;</span><span class="RktSym">response-evts</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">nack</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">closed?</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxLink" data-pltdoc="x">when</a></span><span class="hspace">&nbsp;</span><span class="RktSym">progress-sema</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-post%29%29" class="RktValLink" data-pltdoc="x">semaphore-post</a></span><span class="hspace">&nbsp;</span><span class="RktSym">progress-sema</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">serve</span><span class="hspace">&nbsp;</span><span class="RktSym">commit-reqs</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._choice-evt%29%29" class="RktValLink" data-pltdoc="x">choice-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nack</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel-put-evt%29%29" class="RktValLink" data-pltdoc="x">channel-put-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">response-evts</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Helper for reads and post-peek commits:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">commit!</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxLink" data-pltdoc="x">when</a></span><span class="hspace">&nbsp;</span><span class="RktSym">progress-sema</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-post%29%29" class="RktValLink" data-pltdoc="x">semaphore-post</a></span><span class="hspace">&nbsp;</span><span class="RktSym">progress-sema</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">progress-sema</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Start the server thread:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">server-thread</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">serve</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt">-</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Client-side helpers:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">req-evt</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._nack-guard-evt%29%29" class="RktValLink" data-pltdoc="x">nack-guard-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">nack</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Be sure that the server thread is running:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-resume%29%29" class="RktValLink" data-pltdoc="x">thread-resume</a></span><span class="hspace">&nbsp;</span><span class="RktSym">server-thread</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._current-thread%29%29" class="RktValLink" data-pltdoc="x">current-thread</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Create a channel to hold the reply:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._make-channel%29%29" class="RktValLink" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktSym">nack</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">read-or-peek-evt</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">skip</span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span><span class="hspace">&nbsp;</span><span class="RktSym">peek?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">req-evt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktSym">nack</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">read-req-ch</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%2A%29%29" class="RktValLink" data-pltdoc="x">list*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">skip</span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktSym">nack</span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span><span class="hspace">&nbsp;</span><span class="RktSym">peek?</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Make the port:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-input-port%29%29" class="RktValLink" data-pltdoc="x">make-input-port</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">mod3-cycle</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Each handler for the port just sends</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"> a request to the server</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">read-or-peek-evt</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">skip</span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">read-or-peek-evt</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">skip</span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">close</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">req-evt</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktSym">nack</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">progress-req-ch</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%2A%29%29" class="RktValLink" data-pltdoc="x">list*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktSym">nack</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">progress-evt</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">req-evt</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktSym">nack</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">progress-req-ch</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%2A%29%29" class="RktValLink" data-pltdoc="x">list*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktSym">nack</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">progress-evt</span><span class="hspace">&nbsp;</span><span class="RktSym">done-evt</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">commit</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">req-evt</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktSym">nack</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">commit-req-ch</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%2A%29%29" class="RktValLink" data-pltdoc="x">list*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">progress-evt</span><span class="hspace">&nbsp;</span><span class="RktSym">done-evt</span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">nack</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mod3-cycle</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-mod3-cycle</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">result1</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result2</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">t1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">result1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="RktValLink" data-pltdoc="x">read-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktSym">mod3-cycle</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">t2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">result2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="RktValLink" data-pltdoc="x">read-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktSym">mod3-cycle</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-wait%29%29" class="RktValLink" data-pltdoc="x">thread-wait</a></span><span class="hspace">&nbsp;</span><span class="RktSym">t1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-wait%29%29" class="RktValLink" data-pltdoc="x">thread-wait</a></span><span class="hspace">&nbsp;</span><span class="RktSym">t2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append%29%29" class="RktValLink" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">result1</span><span class="hspace">&nbsp;</span><span class="RktVal">","</span><span class="hspace">&nbsp;</span><span class="RktSym">result2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"11120,02020"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._make-bytes%29%29" class="RktValLink" data-pltdoc="x">make-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">progress-evt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-progress-evt%29%29" class="RktValLink" data-pltdoc="x">port-progress-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mod3-cycle</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes-avail%21%29%29" class="RktValLink" data-pltdoc="x">peek-bytes-avail!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">progress-evt</span><span class="hspace">&nbsp;</span><span class="RktSym">mod3-cycle</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">s</span></td></tr><tr><td><p><span class="RktRes">#"1"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-commit-peeked%29%29" class="RktValLink" data-pltdoc="x">port-commit-peeked</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">progress-evt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._make-semaphore%29%29" class="RktValLink" data-pltdoc="x">make-semaphore</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">mod3-cycle</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">sync/timeout</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">progress-evt</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;progress-evt&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes-avail%21%29%29" class="RktValLink" data-pltdoc="x">peek-bytes-avail!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">progress-evt</span><span class="hspace">&nbsp;</span><span class="RktSym">mod3-cycle</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-commit-peeked%29%29" class="RktValLink" data-pltdoc="x">port-commit-peeked</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">progress-evt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._make-semaphore%29%29" class="RktValLink" data-pltdoc="x">make-semaphore</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">mod3-cycle</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-input-port%29%29" class="RktValLink" data-pltdoc="x">close-input-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mod3-cycle</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-output-port))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-output-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-output-port</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">evt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">write-out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">close</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">write-out-special</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">get-write-evt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">get-write-special-evt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">get-location</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">count-lines!</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">init-position</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">buffer-mode</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">write-out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">close</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">write-out-special</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">get-write-evt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">get-write-special-evt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">get-location</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">count-lines!</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">init-position</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._port~3f%29%29" class="RktValLink" data-pltdoc="x">port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">1</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">buffer-mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._case-~3e%29%29" class="RktStxLink" data-pltdoc="x">case-&gt;</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">block</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">line</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">none</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">block</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">line</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">none</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Creates an output port, which is immediately open for
+writing. If <span class="RktVar">close</span> procedure has no side effects, then
+the port need not be explicitly closed. The port can buffer data
+within its <span class="RktVar">write-out</span> and <span class="RktVar">write-out-special</span>
+procedures.</div></p><ul><li><p><span class="RktVar">name</span> &#8212;<wbr></wbr> the name for the output port.</p></li><li><p><span class="RktVar">evt</span> &#8212;<wbr></wbr> a synchronization event (see <a href="sync.html" data-pltdoc="x">Events</a>;
+e.g., a semaphore or another port). The event is used in place of
+the output port when the port is supplied to synchronization
+procedures like <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span>.  Thus, the event should be
+unblocked when the port is ready for writing at least one byte
+without blocking, or ready to make progress in flushing an
+internal buffer without blocking. The event must not unblock
+unless the port is ready for writing; otherwise, the guarantees of
+<span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span> will be broken for the output port. Use
+<span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._always-evt%29%29" class="RktValLink" data-pltdoc="x">always-evt</a></span> if writes to the port always succeed without
+blocking.</p></li><li><p><span class="RktVar">write-out</span> &#8212;<wbr></wbr> either an output port, which indicates that
+     writes should be redirected to the given port, or a procedure
+     of five arguments:</p><ul><li><p>an immutable byte string containing bytes to write;</p></li><li><p>a non-negative exact integer for a starting offset
+(inclusive) into the byte string;</p></li><li><p>a non-negative exact integer for an ending offset
+(exclusive) into the byte string;</p></li><li><p>a boolean; <span class="RktVal">#f</span> indicates that the port is allowed
+to keep the written bytes in a buffer, and that it is
+allowed to block indefinitely; <span class="RktVal">#t</span> indicates that the
+write should not block, and that the port should attempt to flush
+its buffer and completely write new bytes instead of
+buffering them;</p></li><li><p>a boolean; <span class="RktVal">#t</span> indicates that if the port blocks
+for a write, then it should enable breaks while blocking (e.g.,
+using <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">sync/enable-break</a></span>); this argument is always
+<span class="RktVal">#f</span> if the fourth argument is <span class="RktVal">#t</span>.</p></li></ul><p>The procedure returns one of the following:</p><ul><li><p>a non-negative exact integer representing the number of
+bytes written or buffered;</p></li><li><p><span class="RktVal">#f</span> if no bytes could be written, perhaps because
+the internal buffer could not be completely flushed;</p></li><li><p>a <a href="pipeports.html#%28tech._pipe%29" data-pltdoc="x">pipe</a> output port (when buffering is allowed
+and not when flushing) for buffering bytes as long as the pipe is
+not full and until <span class="RktVar">write-out</span> or
+<span class="RktVar">write-out-special</span> is called; or</p></li><li><p>a synchronizable event (see <a href="sync.html" data-pltdoc="x">Events</a>) other than a
+pipe output port that acts like the result of
+<span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail-evt%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail-evt</a></span> to complete the write.</p></li></ul><p>Since <span class="RktVar">write-out</span> can produce an event, an acceptable
+implementation of <span class="RktVar">write-out</span> is to pass its first three
+arguments to the port&rsquo;s <span class="RktVar">get-write-evt</span>. Some port
+implementors, however, may choose not to provide
+<span class="RktVar">get-write-evt</span> (perhaps because writes cannot be
+made atomic), or may implement <span class="RktVar">write-out</span> to
+enable a fast path for non-blocking writes or to
+enable buffering.</p><p>From a user&rsquo;s perspective, the difference between buffered and
+completely written data is (1) buffered data can be lost in the
+future due to a failed write, and (2) <span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._flush-output%29%29" class="RktValLink" data-pltdoc="x">flush-output</a></span> forces
+all buffered data to be completely written. Under no circumstances
+is buffering required.</p><p>If the start and end indices are the same, then the fourth
+argument to <span class="RktVar">write-out</span> will be <span class="RktVal">#f</span>, and the write
+request is actually a flush request for the port&rsquo;s buffer (if
+any), and the result should be <span class="RktVal">0</span> for a successful flush
+(or if there is no buffer).</p><p>The result should never be <span class="RktVal">0</span> if the start and end indices
+are different, otherwise the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.
+Similarly, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised if <span class="RktVar">write-out</span>
+returns a pipe output port when buffering is disallowed or when it
+is called for flushing.  If a returned integer is larger than the
+supplied byte-string range, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>The <span class="RktVal">#f</span> result should be avoided, unless the next write
+attempt is likely to work. Otherwise, if data cannot be written,
+return an event instead.</p><p>An event returned by <span class="RktVar">write-out</span> can return <span class="RktVal">#f</span> or
+another event like itself, in contrast to events produced by
+<span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail-evt%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail-evt</a></span> or <span class="RktVar">get-write-evt</span>.
+A writing process loops with <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span> until it obtains a
+non-event result.</p><p>The <span class="RktVar">write-out</span> procedure is always called with breaks
+disabled, independent of whether breaks were enabled when the write
+was requested by a client of the port. If breaks were enabled for
+a blocking operation, then the fifth argument to <span class="RktVar">write-out</span>
+will be <span class="RktVal">#t</span>, which indicates that <span class="RktVar">write-out</span> should
+re-enable breaks while blocking.</p><p>If the writing procedure raises an exception, due to write
+or commit operations, it must not have committed any bytes
+(though it may have committed previously buffered bytes).</p><p>A port&rsquo;s writing procedure may be called in multiple threads
+simultaneously (if the port is accessible in multiple
+threads). The port is responsible for its own internal
+synchronization. Note that improper implementation of such
+synchronization mechanisms might cause a non-blocking write
+procedure to block.</p></li><li><p><span class="RktVar">close</span> &#8212;<wbr></wbr> a procedure of zero arguments that is
+called to close the port. The port is not considered closed until
+the closing procedure returns. The port&rsquo;s procedures will never be
+used again via the port after it is closed. However, the closing
+procedure can be called simultaneously in multiple threads (if the
+port is accessible in multiple threads), and it may be called
+during a call to the other procedures in another thread; in the
+latter case, any outstanding writes or flushes should be
+terminated immediately with an error.</p></li><li><p><span class="RktVar">write-out-special</span> &#8212;<wbr></wbr> either <span class="RktVal">#f</span> (the
+default), an output port (which indicates that
+special writes should be redirected to the given port),
+or a procedure to handle <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-special%29%29" class="RktValLink" data-pltdoc="x">write-special</a></span> calls
+for the port. If <span class="RktVal">#f</span>, then the port does not support
+special output, and <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._port-writes-special~3f%29%29" class="RktValLink" data-pltdoc="x">port-writes-special?</a></span> will return
+<span class="RktVal">#f</span> when applied to the port.</p><p>If a procedure is supplied, it takes three arguments: the special
+value to write, a boolean that is <span class="RktVal">#f</span> if the procedure can
+buffer the special value and block indefinitely, and a boolean
+that is <span class="RktVal">#t</span> if the procedure should enable breaks while
+blocking. The result is one of the following:</p><ul><li><p>a non-event true value, which indicates that the special is
+written;</p></li><li><p><span class="RktVal">#f</span> if the special could not be written, perhaps
+because an internal buffer could not be completely flushed;</p></li><li><p>a synchronizable event (see <a href="sync.html" data-pltdoc="x">Events</a>) that acts like
+the result of <span class="RktVar">get-write-special-evt</span> to complete the write.</p></li></ul><p>Since <span class="RktVar">write-out-special</span> can return an event,
+passing the first argument to an implementation of
+<span class="RktVar">get-write-special-evt</span> is acceptable as a
+<span class="RktVar">write-out-special</span>.</p><p>As for <span class="RktVar">write-out</span>, the <span class="RktVal">#f</span> result is discouraged,
+since it can lead to busy waiting. Also as for <span class="RktVar">write-out</span>,
+an event produced by <span class="RktVar">write-out-special</span> is allowed
+to produce <span class="RktVal">#f</span> or another event like itself.  The
+<span class="RktVar">write-out-special</span> procedure is always called with
+breaks disabled, independent of whether breaks were enabled when
+the write was requested by a client of the port.</p></li><li><p><span class="RktVar">get-write-evt</span> &#8212;<wbr></wbr> either <span class="RktVal">#f</span> (the
+default) or a procedure of three arguments:</p><ul><li><p>an immutable byte string containing bytes to write;</p></li><li><p>a non-negative exact integer for a starting offset
+(inclusive) into the byte string; and</p></li><li><p>a non-negative exact integer for an ending offset
+(exclusive) into the byte string.</p></li></ul><p>The result is a synchronizable event (see <a href="sync.html" data-pltdoc="x">Events</a>) to act as
+ the result of <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail-evt%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail-evt</a></span> for the port (i.e.,
+ to complete a write or flush), which becomes available only as
+ data is committed to the port&rsquo;s underlying device, and whose
+ result is the number of bytes written.</p><p>If <span class="RktVar">get-write-evt</span> is <span class="RktVal">#f</span>, then
+ <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._port-writes-atomic~3f%29%29" class="RktValLink" data-pltdoc="x">port-writes-atomic?</a></span> will produce <span class="RktVal">#f</span> when applied
+ to the port, and the port will not be a valid argument to
+ procedures such as <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail-evt%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail-evt</a></span>.
+ Otherwise, an event returned by <span class="RktVar">get-write-evt</span> must
+ not cause data to be written to the port unless the event is
+ chosen in a synchronization, and it must write to the port if the
+ event is chosen (i.e., the write must appear atomic with respect
+ to the synchronization).</p><p>If the event&rsquo;s result integer is larger than the supplied
+ byte-string range, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised by a wrapper
+ on the event. If the start and end indices are the same (i.e., no
+ bytes are to be written), then the event should produce <span class="RktVal">0</span>
+ when the buffer is completely flushed. (If the port has no buffer,
+ then it is effectively always flushed.)</p><p>If the event raises an exception, due to write or commit
+ operations, it must not have committed any new bytes (though it
+ may have committed previously buffered bytes).</p><p>Naturally, a port&rsquo;s events may be used in multiple threads
+ simultaneously (if the port is accessible in multiple
+ threads). The port is responsible for its own internal
+ synchronization.</p></li><li><p><span class="RktVar">get-write-special-evt</span> &#8212;<wbr></wbr> either <span class="RktVal">#f</span>
+(the default), or a procedure to handle <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-special-evt%29%29" class="RktValLink" data-pltdoc="x">write-special-evt</a></span>
+calls for the port. This argument must be <span class="RktVal">#f</span> if either
+<span class="RktVar">write-out-special</span> or <span class="RktVar">get-write-evt</span>
+is <span class="RktVal">#f</span>, and it must be a procedure if both of those
+arguments are procedures.</p><p>If it is a procedure, it takes one argument: the special value to
+write. The resulting event (with its constraints) is analogous to
+the result of <span class="RktVar">get-write-evt</span>.</p><p>If the event raises an exception, due to write or commit
+operations, it must not have committed the special value (though
+it may have committed previously buffered bytes and values).</p></li><li><p><span class="RktVar">get-location</span> &#8212;<wbr></wbr> either <span class="RktVal">#f</span> (the
+default), or a procedure that takes no arguments and returns three
+values: the line number for the next item written to the port&rsquo;s
+stream (a positive number or <span class="RktVal">#f</span>), the column number for
+the next item written to port&rsquo;s stream (a non-negative number or
+<span class="RktVal">#f</span>), and the position for the next item written to port&rsquo;s
+stream (a positive number or <span class="RktVal">#f</span>). See also
+<a href="linecol.html" data-pltdoc="x">Counting Positions, Lines, and Columns</a>.</p><p>This procedure is called to implement <span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-next-location%29%29" class="RktValLink" data-pltdoc="x">port-next-location</a></span>
+for the port, but only if line counting is enabled for the port
+via <span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-count-lines%21%29%29" class="RktValLink" data-pltdoc="x">port-count-lines!</a></span> (in which case
+<span class="RktVar">count-lines!</span> is called).</p></li><li><p><span class="RktVar">count-lines!</span> &#8212;<wbr></wbr> a procedure of no arguments
+that is called if and when line counting is enabled for the port.
+The default procedure is <span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span>.</p></li><li><p><span class="RktVar">init-position</span> &#8212;<wbr></wbr> normally an exact, positive integer
+that determines the position of the port&rsquo;s first item, which is
+used by <span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%29%29" class="RktValLink" data-pltdoc="x">file-position</a></span> or when line counting is
+<span style="font-style: italic">not</span> enabled for the port. The default is <span class="RktVal">1</span>.  If
+<span class="RktVar">init-position</span> is <span class="RktVal">#f</span>, the port is treated as
+having an unknown position. If <span class="RktVar">init-position</span> is a port,
+then the given port&rsquo;s position is always used for the new port&rsquo;s
+position. If <span class="RktVar">init-position</span> is a procedure, it is called
+as needed to obtain the port&rsquo;s position.</p></li><li><p><span class="RktVar">buffer-mode</span> &#8212;<wbr></wbr> either <span class="RktVal">#f</span> (the
+default) or a procedure that accepts zero or one arguments. If
+<span class="RktVar">buffer-mode</span> is <span class="RktVal">#f</span>, then the resulting
+port does not support a buffer-mode setting. Otherwise, the
+procedure is called with one symbol argument (<span class="RktVal">'</span><span class="RktVal">block</span>,
+<span class="RktVal">'</span><span class="RktVal">line</span>, or <span class="RktVal">'</span><span class="RktVal">none</span>) to set the buffer mode, and it is
+called with zero arguments to get the current buffer mode. In the
+latter case, the result must be <span class="RktVal">'</span><span class="RktVal">block</span>, <span class="RktVal">'</span><span class="RktVal">line</span>,
+<span class="RktVal">'</span><span class="RktVal">none</span>, or <span class="RktVal">#f</span> (unknown). See <a href="port-buffers.html" data-pltdoc="x">Port Buffers and Positions</a>
+for more information on buffer modes.</p></li></ul><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">A port that writes anything to nowhere:</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">/dev/null-out</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-output-port%29%29" class="RktValLink" data-pltdoc="x">make-output-port</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">null</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._always-evt%29%29" class="RktValLink" data-pltdoc="x">always-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">start</span><span class="hspace">&nbsp;</span><span class="RktSym">end</span><span class="hspace">&nbsp;</span><span class="RktSym">non-block?</span><span class="hspace">&nbsp;</span><span class="RktSym">breakable?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">end</span><span class="hspace">&nbsp;</span><span class="RktSym">start</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">special</span><span class="hspace">&nbsp;</span><span class="RktSym">non-block?</span><span class="hspace">&nbsp;</span><span class="RktSym">breakable?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">start</span><span class="hspace">&nbsp;</span><span class="RktSym">end</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._wrap-evt%29%29" class="RktValLink" data-pltdoc="x">wrap-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._always-evt%29%29" class="RktValLink" data-pltdoc="x">always-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">end</span><span class="hspace">&nbsp;</span><span class="RktSym">start</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">special</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._always-evt%29%29" class="RktValLink" data-pltdoc="x">always-evt</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="hspace">&nbsp;</span><span class="RktSym">/dev/null-out</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"hello"</span><span class="hspace">&nbsp;</span><span class="RktSym">/dev/null-out</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-special%29%29" class="RktValLink" data-pltdoc="x">write-special</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">hello</span><span class="hspace">&nbsp;</span><span class="RktSym">/dev/null-out</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail-evt%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail-evt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"hello"</span><span class="hspace">&nbsp;</span><span class="RktSym">/dev/null-out</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">A port that accumulates bytes as characters in a list,</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"> but not in a thread-safe way:</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">accum-list</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">accumulator/not-thread-safe</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-output-port%29%29" class="RktValLink" data-pltdoc="x">make-output-port</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">accum/not-thread-safe</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._always-evt%29%29" class="RktValLink" data-pltdoc="x">always-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">start</span><span class="hspace">&nbsp;</span><span class="RktSym">end</span><span class="hspace">&nbsp;</span><span class="RktSym">non-block?</span><span class="hspace">&nbsp;</span><span class="RktSym">breakable?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">accum-list</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._append%29%29" class="RktValLink" data-pltdoc="x">append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">accum-list</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._integer-~3echar%29%29" class="RktValLink" data-pltdoc="x">integer-&gt;char</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3elist%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._subbytes%29%29" class="RktValLink" data-pltdoc="x">subbytes</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">start</span><span class="hspace">&nbsp;</span><span class="RktSym">end</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">end</span><span class="hspace">&nbsp;</span><span class="RktSym">start</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="hspace">&nbsp;</span><span class="RktSym">accumulator/not-thread-safe</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">accum-list</span></td></tr><tr><td><p><span class="RktRes">'(#\h #\e #\l #\l #\o)</span></p></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Same as before, but with simple thread-safety:</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">accum-list</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">accumulator</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A%29%29" class="RktStxLink" data-pltdoc="x">let*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">lock</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._make-semaphore%29%29" class="RktValLink" data-pltdoc="x">make-semaphore</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">lock-peek-evt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-peek-evt%29%29" class="RktValLink" data-pltdoc="x">semaphore-peek-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lock</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-output-port%29%29" class="RktValLink" data-pltdoc="x">make-output-port</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">accum</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">lock-peek-evt</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">start</span><span class="hspace">&nbsp;</span><span class="RktSym">end</span><span class="hspace">&nbsp;</span><span class="RktSym">non-block?</span><span class="hspace">&nbsp;</span><span class="RktSym">breakable?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-try-wait~3f%29%29" class="RktValLink" data-pltdoc="x">semaphore-try-wait?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lock</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">accum-list</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._append%29%29" class="RktValLink" data-pltdoc="x">append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">accum-list</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._integer-~3echar%29%29" class="RktValLink" data-pltdoc="x">integer-&gt;char</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3elist%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;list</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._subbytes%29%29" class="RktValLink" data-pltdoc="x">subbytes</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">start</span><span class="hspace">&nbsp;</span><span class="RktSym">end</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-post%29%29" class="RktValLink" data-pltdoc="x">semaphore-post</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lock</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">end</span><span class="hspace">&nbsp;</span><span class="RktSym">start</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Cheap strategy: block until the list is unlocked,</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">then return 0, so we get called again</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._wrap-evt%29%29" class="RktValLink" data-pltdoc="x">wrap-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">lock-peek-evt</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="hspace">&nbsp;</span><span class="RktSym">accumulator</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">accum-list</span></td></tr><tr><td><p><span class="RktRes">'(#\h #\e #\l #\l #\o)</span></p></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">A port that transforms data before sending it on</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"> to another port. Atomic writes exploit the</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"> underlying port</span><span class="RktCmt">'</span><span class="RktCmt">s ability for atomic writes.</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-latin-1-capitalize</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">byte-upcase</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">start</span><span class="hspace">&nbsp;</span><span class="RktSym">end</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._list-~3ebytes%29%29" class="RktValLink" data-pltdoc="x">list-&gt;bytes</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-~3einteger%29%29" class="RktValLink" data-pltdoc="x">char-&gt;integer</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-upcase%29%29" class="RktValLink" data-pltdoc="x">char-upcase</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._integer-~3echar%29%29" class="RktValLink" data-pltdoc="x">integer-&gt;char</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3elist%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._subbytes%29%29" class="RktValLink" data-pltdoc="x">subbytes</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">start</span><span class="hspace">&nbsp;</span><span class="RktSym">end</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-output-port%29%29" class="RktValLink" data-pltdoc="x">make-output-port</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">byte-upcase</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">This port is ready when the original is ready:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">port</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Writing procedure:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">start</span><span class="hspace">&nbsp;</span><span class="RktSym">end</span><span class="hspace">&nbsp;</span><span class="RktSym">non-block?</span><span class="hspace">&nbsp;</span><span class="RktSym">breakable?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">byte-upcase</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">start</span><span class="hspace">&nbsp;</span><span class="RktSym">end</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktSym">non-block?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%2A%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Close procedure </span><span class="RktCmt">&#8212;<wbr></wbr></span><span class="RktCmt"> close original port:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-output-port%29%29" class="RktValLink" data-pltdoc="x">close-output-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Write event:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._port-writes-atomic~3f%29%29" class="RktValLink" data-pltdoc="x">port-writes-atomic?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">start</span><span class="hspace">&nbsp;</span><span class="RktSym">end</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail-evt%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">byte-upcase</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">start</span><span class="hspace">&nbsp;</span><span class="RktSym">end</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">orig-port</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-string%29%29" class="RktValLink" data-pltdoc="x">open-output-string</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cap-port</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-latin-1-capitalize</span><span class="hspace">&nbsp;</span><span class="RktSym">orig-port</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Hello"</span><span class="hspace">&nbsp;</span><span class="RktSym">cap-port</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-string%29%29" class="RktValLink" data-pltdoc="x">get-output-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">orig-port</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"HELLO"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail-evt%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail-evt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"Bye"</span><span class="hspace">&nbsp;</span><span class="RktSym">cap-port</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-string%29%29" class="RktValLink" data-pltdoc="x">get-output-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">orig-port</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"HELLOBYE"</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="portstructs.html" title="backward to &quot;13.1.8 Structures as Ports&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ports.html" title="up to &quot;13.1 Ports&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="port-lib.html" title="forward to &quot;13.1.10 More Port Constructors, Procedures, and Events&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/data-structure-contracts.html b/clones/docs.racket-lang.org/reference/data-structure-contracts.html
new file mode 100644
index 00000000..c4c784b2
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/data-structure-contracts.html
@@ -0,0 +1,281 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>8.1&nbsp;Data-structure Contracts</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.1&nbsp;</td><td><a href="data-structure-contracts.html" class="tocviewselflink" data-pltdoc="x">Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.2&nbsp;</td><td><a href="function-contracts.html" class="tocviewlink" data-pltdoc="x">Function Contracts</a></td></tr><tr><td align="right">8.3&nbsp;</td><td><a href="parametric-contracts.html" class="tocviewlink" data-pltdoc="x">Parametric Contracts</a></td></tr><tr><td align="right">8.4&nbsp;</td><td><a href="Lazy_Data-structure_Contracts.html" class="tocviewlink" data-pltdoc="x">Lazy Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.5&nbsp;</td><td><a href="Structure_Type_Property_Contracts.html" class="tocviewlink" data-pltdoc="x">Structure Type Property Contracts</a></td></tr><tr><td align="right">8.6&nbsp;</td><td><a href="attaching-contracts-to-values.html" class="tocviewlink" data-pltdoc="x">Attaching Contracts to Values</a></td></tr><tr><td align="right">8.7&nbsp;</td><td><a href="Building_New_Contract_Combinators.html" class="tocviewlink" data-pltdoc="x">Building New Contract Combinators</a></td></tr><tr><td align="right">8.8&nbsp;</td><td><a href="contract-utilities.html" class="tocviewlink" data-pltdoc="x">Contract Utilities</a></td></tr><tr><td align="right">8.9&nbsp;</td><td><a href="racket_contract_base.html" class="tocviewlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>contract/<span class="mywbr"> &nbsp;</span>base</span></span></a></td></tr><tr><td align="right">8.10&nbsp;</td><td><a href="collapsible.html" class="tocviewlink" data-pltdoc="x">Collapsible Contracts</a></td></tr><tr><td align="right">8.11&nbsp;</td><td><a href="Legacy_Contracts.html" class="tocviewlink" data-pltdoc="x">Legacy Contracts</a></td></tr><tr><td align="right">8.12&nbsp;</td><td><a href="Random_generation.html" class="tocviewlink" data-pltdoc="x">Random generation</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._flat-contract-with-explanation%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flat-<wbr></wbr>contract-<wbr></wbr>with-<wbr></wbr>explanation</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._flat-named-contract%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flat-<wbr></wbr>named-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">any/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._none%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">none/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">or/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._first-or%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">first-<wbr></wbr>or/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">and/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">not/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3d%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">=/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3c%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">&lt;/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">&gt;/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3c~3d%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">&lt;=/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">&gt;=/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._between%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">between/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._real-in%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">real-<wbr></wbr>in</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">integer-<wbr></wbr>in</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._char-in%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-<wbr></wbr>in</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._natural-number%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">natural-<wbr></wbr>number/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._string-len%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>len/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._false%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">false/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._printable%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">printable/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._one-of%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">one-<wbr></wbr>of/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._symbols%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">symbols</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vectorof%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vectorof</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector-immutableof%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>immutableof</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector-immutable%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>immutable/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fbox..rkt%29._box%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">box/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fbox..rkt%29._box-immutable%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">box-<wbr></wbr>immutable/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">listof</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._non-empty-listof%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">non-<wbr></wbr>empty-<wbr></wbr>listof</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Aof%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list*of</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cons/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fdc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">cons/<span class="mywbr"> &nbsp;</span>dc</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._%2Alist%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">*list/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._syntax%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fstruct-dc..rkt%29._struct%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fstruct-dc..rkt%29._struct%2Fdc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct/<span class="mywbr"> &nbsp;</span>dc</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._parameter%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">parameter/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._procedure-arity-includes%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-<wbr></wbr>arity-<wbr></wbr>includes/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fdc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">hash/<span class="mywbr"> &nbsp;</span>dc</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._channel%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">channel/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._prompt-tag%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">prompt-<wbr></wbr>tag/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._continuation-mark-key%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-<wbr></wbr>mark-<wbr></wbr>key/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._evt%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">evt/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._flat-rec-contract%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">flat-<wbr></wbr>rec-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._flat-murec-contract%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">flat-<wbr></wbr>murec-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">any</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._promise%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">promise/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._flat-contract%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flat-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._flat-contract-predicate%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flat-<wbr></wbr>contract-<wbr></wbr>predicate</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._property%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">property/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._suggest%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">suggest/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contracts.html" title="backward to &quot;8 Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="function-contracts.html" title="forward to &quot;8.2 Function Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;data-structure-contracts&quot;">8.1<tt>&nbsp;</tt><a name="(part._data-structure-contracts)"></a>Data-structure Contracts</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._flat-contract-with-explanation))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._flat-contract-with-explanation%29%29" class="RktValDef RktValLink" data-pltdoc="x">flat-contract-with-explanation</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">get-explanation</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:name</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">get-explanation</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="RktValLink" data-pltdoc="x">blame?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span><span class="hspace">&nbsp;</span><span class="RktVar">get-explanation</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Provides a way to use flat contracts that, when a contract fails,
+ provide more information about the failure.</div></p><p>If <span class="RktVar">get-explanation</span> returns a boolean, then that boolean value is
+ treated as the predicate in a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>. If it returns
+ a procedure, then it is treated similarly to returning <span class="RktVal">#f</span>,
+ except the result procedure is called to actually signal the contract
+ violation.</p><p>The <span class="RktVar">name</span> argument is used as the name of the contract; it defaults
+ to the name of the <span class="RktVar">get-explanation</span> function.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._flat-contract-with-explanation%29%29" class="RktValLink" data-pltdoc="x">flat-contract-with-explanation</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">val</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">blame</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">more-information</span><span class="hspace">&nbsp;</span><span class="RktSym">...do-some-complex-computation-here...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._raise-blame-error%29%29" class="RktValLink" data-pltdoc="x">raise-blame-error</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">expected:</span><span class="hspace">&nbsp;</span><span class="RktVal">"an even number"</span><span class="hspace">&nbsp;</span><span class="RktVal">given:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~e"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"and, here is more help: ~s"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktSym">more-information</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._flat-named-contract))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._flat-named-contract%29%29" class="RktValDef RktValLink" data-pltdoc="x">flat-named-contract</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">flat-contract</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">generator</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">flat-contract</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">generator</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Produces a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> like <span class="RktVar">flat-contract</span>, but with the name <span class="RktVar">name</span>.</div></p><p><div class="SIntrapara">For example,
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._flat-named-contract%29%29" class="RktValLink" data-pltdoc="x">flat-named-contract</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">odd-integer</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._odd~3f%29%29" class="RktValLink" data-pltdoc="x">odd?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p>The generator argument adds a generator for the flat-named-contract. See
+<span class="RktSym"><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate%29%29" class="RktValLink" data-pltdoc="x">contract-random-generate</a></span> for more information.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/contract/private/misc..rkt)._any/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">any/c</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> that accepts any value.</div></p><p>When using this contract as the result portion of a function contract,
+consider using <span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span> instead; using <span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span> leads to
+better memory performance, but it also allows multiple results.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/contract/private/misc..rkt)._none/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._none%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">none/c</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> that accepts no values.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/base..rkt)._or/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">or/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">contract</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">contract</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Takes any number of <a href="contracts.html#%28tech._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">contracts</span></a> and returns
+a <a href="contracts.html#%28tech._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">contract</span></a> that accepts any value that any one of the contracts
+accepts individually.</div></p><p>The <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span> result tests any value by applying the contracts in
+order, from left to right, with the exception that it always moves the
+non-<a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a> (if any) to the end, checking them
+last. Thus, a contract such as <span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="RktPn">)</span> is guaranteed to only invoke the <span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span>
+predicate on real numbers.</p><p>If all of the arguments are procedures or <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a>, the
+result is a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>. If only one of the arguments is a
+higher-order contract, the result is a contract that just checks the
+flat contracts and, if they don&rsquo;t pass, applies the higher-order
+contract.</p><p><div class="SIntrapara">If there are multiple higher-order contracts, <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span> uses
+<span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-first-order-passes~3f%29%29" class="RktValLink" data-pltdoc="x">contract-first-order-passes?</a></span> to distinguish between
+them. More precisely, when an <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span> is checked, it first
+checks all of the <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a>. If none of them pass, it
+calls <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-first-order-passes~3f%29%29" class="RktValLink" data-pltdoc="x">contract-first-order-passes?</a></span> with each of the
+higher-order contracts. If only one returns true, <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span> uses
+that contract. If none of them return true, it signals a contract
+violation. If more than one returns true, it also signals a contract
+violation.
+For example, this contract
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">does not accept a function like this one: <span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktSym">args</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>
+since it cannot tell which of the two arrow contracts should be used
+with the function.</div></p><p>If all of its arguments are <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._list-contract~3f%29%29" class="RktValLink" data-pltdoc="x">list-contract?</a></span>s, then <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span>
+returns a <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._list-contract~3f%29%29" class="RktValLink" data-pltdoc="x">list-contract?</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/base..rkt)._first-or/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._first-or%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">first-or/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">contract</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">contract</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Takes any number of <a href="contracts.html#%28tech._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">contracts</span></a> and returns a <a href="contracts.html#%28tech._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">contract</span></a> that
+accepts any value that any one of the contracts accepts
+individually.</div></p><p>The <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._first-or%2Fc%29%29" class="RktValLink" data-pltdoc="x">first-or/c</a></span> result tests any value by applying the
+contracts in order from left to right. Thus, a contract
+such as <span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._first-or%2Fc%29%29" class="RktValLink" data-pltdoc="x">first-or/c</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="RktPn">)</span>
+is guaranteed to only invoke the
+<span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span> predicate on real numbers.</p><p>If all of the arguments are procedures or <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat
+contracts</span></a>, the result is a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> and
+similarly if all of the arguments are <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone
+contracts</span></a> the result is too. Otherwise, the result is an
+<a href="contracts.html#%28tech._impersonator._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator contract</span></a>.</p><p>If there are multiple higher-order contracts,
+<span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._first-or%2Fc%29%29" class="RktValLink" data-pltdoc="x">first-or/c</a></span> uses <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-first-order-passes~3f%29%29" class="RktValLink" data-pltdoc="x">contract-first-order-passes?</a></span>
+to distinguish between them. More precisely, when an
+<span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._first-or%2Fc%29%29" class="RktValLink" data-pltdoc="x">first-or/c</a></span> is checked, it checks the first order passes
+of the first contract against the value. If it succeeds,
+then it uses only that contract. If it fails, then it moves
+to the second contract, continuing until it finds one of
+the contracts where the first order check succeeds. If none
+of them do, a contract violation is signaled.</p><p><div class="SIntrapara">For example, this contract
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._first-or%2Fc%29%29" class="RktValLink" data-pltdoc="x">first-or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">accepts the function <span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="stt"> </span><span class="RktSym">args</span><span class="stt"> </span><span class="RktVal">0</span><span class="RktPn">)</span>,
+applying the <span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">)</span> contract to the function
+because it comes first, even though
+<span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="stt"> </span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="stt"> </span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span> also applies.</div></p><p>If all of its arguments are <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._list-contract~3f%29%29" class="RktValLink" data-pltdoc="x">list-contract?</a></span>s, then <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._first-or%2Fc%29%29" class="RktValLink" data-pltdoc="x">first-or/c</a></span>
+returns a <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._list-contract~3f%29%29" class="RktValLink" data-pltdoc="x">list-contract?</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/base..rkt)._and/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">and/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">contract</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">contract</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Takes any number of <a href="contracts.html#%28tech._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">contracts</span></a> and returns a <a href="contracts.html#%28tech._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">contract</span></a> that
+accepts any value that satisfies all of the contracts simultaneously.</div></p><p>If all of the arguments are procedures or <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a>,
+the result is a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>.</p><p>The contract produced by <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span> tests any value by applying
+the contracts in order, from left to right.</p><p>This means that <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span> can be used to guard predicates that are not
+total in contracts. For example, this contract is well-behaved, correctly
+blaming the definition of <span class="RktSym">whoops-not-a-number</span> for not being
+a number:</p><p><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">whoops-not-a-number</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"four"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">whoops-not-a-number: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: real?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: "four"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: an and/c case of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(and/c real? even?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: </span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(definition whoops-not-a-number)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition whoops-not-a-number)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara">but if the arguments to <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span> are reversed, then the contract itself raises
+ an error:
+ </div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">whoops-not-a-number</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"four"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">even?: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: "four"</span></p></td></tr></table></blockquote></div></p></div></p><p>If more than one of the contracts are not <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a>,
+ then the order in which the higher-order parts of the contract are tested
+ can be counter-intuitive. As an example, consider this function that
+ uses <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span> in a higher-order manner with contracts that
+ always succeed, but that print when they are called, in order for us
+ to see the order in which they are called.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">show-me</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"show-me ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">identity-with-complex-printing-contract</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show-me</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show-me</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show-me</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show-me</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show-me</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show-me</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show-me</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show-me</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">identity-with-complex-printing-contract</span><span class="hspace">&nbsp;</span><span class="RktVal">101</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">show-me 1</span></p></td></tr><tr><td><p><span class="RktOut">show-me 2</span></p></td></tr><tr><td><p><span class="RktOut">show-me 3</span></p></td></tr><tr><td><p><span class="RktOut">show-me 4</span></p></td></tr><tr><td><p><span class="RktOut">show-me 5</span></p></td></tr><tr><td><p><span class="RktOut">show-me 6</span></p></td></tr><tr><td><p><span class="RktOut">show-me 7</span></p></td></tr><tr><td><p><span class="RktOut">show-me 8</span></p></td></tr></table></td></tr><tr><td><p><span class="RktRes">101</span></p></td></tr></table></blockquote></div></p><p>The checking order is just like the usual ordering when a contract
+ is double-wrapped. The contract that is first put on has its domain checked
+ second but its range checked first and we see a similar pattern here in
+ this example, because <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span> simply applies the contracts in order.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._not/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">not/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">flat-contract</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">flat-contract</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Accepts a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> or a predicate and returns a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>
+that checks the inverse of the argument.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._~3d/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3d%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">=/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> that requires the input to be a number and
+<span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span> to <span class="RktVar">z</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._~3c/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3c%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">&lt;/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> that requires the input to be a number and
+<span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span> than <span class="RktVar">n</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._~3e/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">&gt;/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3c%2Fc%29%29" class="RktValLink" data-pltdoc="x">&lt;/c</a></span>, but for <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e%29%29" class="RktValLink" data-pltdoc="x">&gt;</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._~3c~3d/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3c~3d%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">&lt;=/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3c%2Fc%29%29" class="RktValLink" data-pltdoc="x">&lt;/c</a></span>, but for <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c~3d%29%29" class="RktValLink" data-pltdoc="x">&lt;=</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._~3e~3d/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">&gt;=/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3c%2Fc%29%29" class="RktValLink" data-pltdoc="x">&lt;/c</a></span>, but for <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e~3d%29%29" class="RktValLink" data-pltdoc="x">&gt;=</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._between/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._between%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">between/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span><span class="RktVar">m</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">m</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> that requires the
+input to be a real number between <span class="RktVar">n</span> and <span class="RktVar">m</span> or equal to
+one of them.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._real-in))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._real-in%29%29" class="RktValDef RktValLink" data-pltdoc="x">real-in</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span><span class="RktVar">m</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">m</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">An alias for <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._between%2Fc%29%29" class="RktValLink" data-pltdoc="x">between/c</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/base..rkt)._integer-in))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValDef RktValLink" data-pltdoc="x">integer-in</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">j</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">j</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> that requires the input to be an exact integer
+between <span class="RktVar">j</span> and <span class="RktVar">k</span>, inclusive. If either <span class="RktVar">j</span> or <span class="RktVar">k</span>
+is <span class="RktVal">#f</span>, then the range is unbounded on that end.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">two-digit-number</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">99</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">23</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">not-a-two-digit-number</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">99</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">124</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">not-a-two-digit-number: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: (integer-in 10 99)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: 124</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (integer-in 10 99)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: </span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(definition not-a-two-digit-number)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition not-a-two-digit-number)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:3:0</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">negative-number</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal"><span class="nobreak">-4</span></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">not-a-negative-number</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">not-a-negative-number: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: (integer-in #f -1)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: 4</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (integer-in #f -1)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: </span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(definition not-a-negative-number)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition not-a-negative-number)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:5:0</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.8.0.2 of package <span class="stt">base</span>: Allow <span class="RktVar">j</span> and <span class="RktVar">k</span> to be <span class="RktVal">#f</span></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._char-in))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._char-in%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-in</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> that requires the input to be a character whose
+code point number is between the code point numbers of <span class="RktVar">a</span> and
+<span class="RktVar">b</span>, inclusive.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/contract/private/misc..rkt)._natural-number/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._natural-number%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">natural-number/c</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> that requires the input to be an exact non-negative integer.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._string-len/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._string-len%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-len/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">len</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">len</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> that recognizes strings that have fewer than
+<span class="RktVar">len</span> characters.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/contract/private/misc..rkt)._false/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._false%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">false/c</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">An alias for <span class="RktVal">#f</span> for backwards compatibility.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/contract/private/misc..rkt)._printable/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._printable%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">printable/c</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> that recognizes values that can be written out and
+read back in with <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> and <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/base..rkt)._one-of/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._one-of%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">one-of/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Accepts any number of atomic values and returns a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> that
+recognizes those values, using <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>  as the comparison
+predicate.  For the purposes of <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._one-of%2Fc%29%29" class="RktValLink" data-pltdoc="x">one-of/c</a></span>, atomic values are
+defined to be: <a href="characters.html#%28tech._character%29" class="techoutside" data-pltdoc="x"><span class="techinside">characters</span></a>, <a href="symbols.html#%28tech._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">symbols</span></a>, <a href="booleans.html#%28tech._boolean%29" class="techoutside" data-pltdoc="x"><span class="techinside">booleans</span></a>,
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span>, <a href="keywords.html#%28tech._keyword%29" class="techoutside" data-pltdoc="x"><span class="techinside">keywords</span></a>, <a href="numbers.html#%28tech._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">numbers</span></a>,
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>, and <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;undefined&gt;</span></span></a>.</div></p><p>This is a backwards compatibility contract constructor. If
+neither <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a> nor <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;undefined&gt;</span></span></a> are arguments,
+it simply passes its arguments to <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/base..rkt)._symbols))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._symbols%29%29" class="RktValDef RktValLink" data-pltdoc="x">symbols</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Accepts any number of symbols and returns a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> that
+recognizes those symbols.</div></p><p>This is a backwards compatibility constructor; it merely
+passes its arguments to <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/vector..rkt)._vectorof))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vectorof%29%29" class="RktValDef RktValLink" data-pltdoc="x">vectorof</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">c</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:immutable</span><span class="hspace">&nbsp;</span><span class="RktVar">immutable</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:flat?</span><span class="hspace">&nbsp;</span><span class="RktVar">flat?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:eager</span><span class="hspace">&nbsp;</span><span class="RktVar">eager</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">immutable</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dont-care</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dont-care</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">flat?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">eager</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="contracts.html#%28tech._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">contract</span></a> that recognizes vectors. The elements of the vector must
+match <span class="RktVar">c</span>.</div></p><p>If the <span class="RktVar">flat?</span> argument is <span class="RktVal">#t</span>, then the resulting contract is
+a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>, and the <span class="RktVar">c</span> argument must also be a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>.  Such
+<a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a> will be unsound if applied to mutable vectors, as they will not
+check future operations on the vector.</p><p>If the <span class="RktVar">immutable</span> argument is <span class="RktVal">#t</span> and the <span class="RktVar">c</span> argument is
+a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> and the <span class="RktVar">eager</span> argument is <span class="RktVal">#t</span>,
+the result will be a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>.  If the <span class="RktVar">c</span> argument
+is a <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contract</span></a>, then the result will be a <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contract</span></a>.</p><p>If the <span class="RktVar">eager</span> argument is <span class="RktVal">#t</span>, then immutable vectors are
+checked eagerly when <span class="RktVar">c</span> is a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>. If the
+<span class="RktVar">eager</span> argument is a number <span class="RktSym">n</span>, then immutable vectors are checked
+eagerly when <span class="RktVar">c</span> is a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> and the length of the vector
+is less than or equal to <span class="RktSym">n</span>.</p><p>When a higher-order <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vectorof%29%29" class="RktValLink" data-pltdoc="x">vectorof</a></span> contract is applied to a vector, the result
+is not <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to the input.  The result will be a copy for immutable vectors
+and a <a href="chaperones.html#%28tech._chaperone%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone</span></a> or <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a> of the input for mutable vectors,
+unless the <span class="RktVar">c</span> argument is a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> and the vector is immutable,
+in which case the result is the original vector.</p><p class="SHistory">Changed in version 6.3.0.5 of package <span class="stt">base</span>: Changed flat vector contracts to not copy
+immutable vectors.<br/>Changed in version 6.7.0.3: Added the <span class="RktPn">#:eager</span> option.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/vector..rkt)._vector-immutableof))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector-immutableof%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-immutableof</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the same <a href="contracts.html#%28tech._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">contract</span></a> as <span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vectorof%29%29" class="RktValLink" data-pltdoc="x">vectorof</a></span><span class="stt"> </span><span class="RktVar">c</span><span class="stt"> </span><span class="RktPn">#:immutable</span><span class="stt"> </span><span class="RktVal">#t</span><span class="RktPn">)</span>. This form exists for
+backwards compatibility.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/vector..rkt)._vector/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector/c</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">c</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:immutable</span><span class="hspace">&nbsp;</span><span class="RktVar">immutable</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:flat?</span><span class="hspace">&nbsp;</span><span class="RktVar">flat?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">immutable</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dont-care</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dont-care</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">flat?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="contracts.html#%28tech._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">contract</span></a> that recognizes vectors whose lengths match the number of
+contracts given. Each element of the vector must match its corresponding contract.</div></p><p>If the <span class="RktVar">flat?</span> argument is <span class="RktVal">#t</span>, then the resulting contract is
+a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>, and the <span class="RktVar">c</span> arguments must also be <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a>.  Such
+<a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a> will be unsound if applied to mutable vectors, as they will not
+check future operations on the vector.</p><p>If the <span class="RktVar">immutable</span> argument is <span class="RktVal">#t</span> and the <span class="RktVar">c</span> arguments are
+<a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a>, the result will be a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>.  If the <span class="RktVar">c</span> arguments
+are <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contracts</span></a>, then the result will be a <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contract</span></a>.</p><p>When a higher-order <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector%2Fc%29%29" class="RktValLink" data-pltdoc="x">vector/c</a></span> contract is applied to a vector, the result
+is not <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to the input.  The result will be a copy for immutable vectors
+and a <a href="chaperones.html#%28tech._chaperone%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone</span></a> or <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a> of the input for mutable vectors.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/vector..rkt)._vector-immutable/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector-immutable%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-immutable/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the same contract as <span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector%2Fc%29%29" class="RktValLink" data-pltdoc="x">vector/c</a></span><span class="stt"> </span><span class="RktVar">c</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktPn">#:immutable</span><span class="stt"> </span><span class="RktVal">#t</span><span class="RktPn">)</span>. This form exists for
+reasons of backwards compatibility.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/box..rkt)._box/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fbox..rkt%29._box%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">box/c</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in-c</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">c</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:immutable</span><span class="hspace">&nbsp;</span><span class="RktVar">immutable</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:flat?</span><span class="hspace">&nbsp;</span><span class="RktVar">flat?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in-c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">in-c</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">immutable</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dont-care</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dont-care</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">flat?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a contract that recognizes boxes. The content of the box must match <span class="RktVar">c</span>,
+and mutations on mutable boxes must match <span class="RktVar">in-c</span>.</div></p><p>If the <span class="RktVar">flat?</span> argument is <span class="RktVal">#t</span>, then the resulting contract is
+a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>, and the <span class="RktSym">out</span> argument must also be a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>.  Such
+<a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a> will be unsound if applied to mutable boxes, as they will not check
+future operations on the box.</p><p>If the <span class="RktVar">immutable</span> argument is <span class="RktVal">#t</span> and the <span class="RktVar">c</span> argument is
+a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>, the result will be a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>.  If the <span class="RktVar">c</span> argument is
+a <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contract</span></a>, then the result will be a <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contract</span></a>.</p><p>When a higher-order <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fbox..rkt%29._box%2Fc%29%29" class="RktValLink" data-pltdoc="x">box/c</a></span> contract is applied to a box, the result
+is not <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to the input.  The result will be a copy for immutable boxes
+and either a <a href="chaperones.html#%28tech._chaperone%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone</span></a> or <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a> of the input for mutable boxes.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/box..rkt)._box-immutable/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fbox..rkt%29._box-immutable%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">box-immutable/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the same contract as <span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fbox..rkt%29._box%2Fc%29%29" class="RktValLink" data-pltdoc="x">box/c</a></span><span class="stt"> </span><span class="RktVar">c</span><span class="stt"> </span><span class="RktPn">#:immutable</span><span class="stt"> </span><span class="RktVal">#t</span><span class="RktPn">)</span>. This form exists for
+reasons of backwards compatibility.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/base..rkt)._listof))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValDef RktValLink" data-pltdoc="x">listof</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._list-contract~3f%29%29" class="RktValLink" data-pltdoc="x">list-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a contract that recognizes a list whose every element matches
+the contract <span class="RktVar">c</span>. Beware that when this contract is applied to
+a value, the result is not necessarily <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to the input.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">some-numbers</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">just-one-number</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">11</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">just-one-number: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: list?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: 11</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (listof number?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition just-one-number)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition just-one-number)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:3:0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/base..rkt)._non-empty-listof))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._non-empty-listof%29%29" class="RktValDef RktValLink" data-pltdoc="x">non-empty-listof</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._list-contract~3f%29%29" class="RktValLink" data-pltdoc="x">list-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a contract that recognizes non-empty lists whose elements match
+the contract <span class="RktVar">c</span>. Beware that when this contract is applied to
+a value, the result is not necessarily <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to the input.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">some-numbers</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._non-empty-listof%29%29" class="RktValLink" data-pltdoc="x">non-empty-listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">not-enough-numbers</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._non-empty-listof%29%29" class="RktValLink" data-pltdoc="x">non-empty-listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">not-enough-numbers: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: (and/c list? pair?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: '()</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (non-empty-listof number?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: </span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(definition not-enough-numbers)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition not-enough-numbers)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:3:0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/base..rkt)._list*of))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Aof%29%29" class="RktValDef RktValLink" data-pltdoc="x">list*of</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">ele-c</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">last-c</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ele-c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">last-c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">ele-c</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a contract that recognizes improper lists whose elements match
+the contract <span class="RktVar">ele-c</span> and whose last position matches <span class="RktVar">last-c</span>.
+If an improper list is created with <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span>,
+then its <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> position is expected to match <span class="RktVar">ele-c</span> and
+its <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> position is expected to be <span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Aof%29%29" class="RktValLink" data-pltdoc="x">list*of</a></span><span class="stt"> </span><span class="RktVar">ele-c</span><span class="stt"> </span><span class="RktSym">list-c</span><span class="RktPn">)</span>. Otherwise,
+it is expected to match <span class="RktVar">last-c</span>. Beware that when this contract is applied to
+a value, the result is not necessarily <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to the input.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">improper-numbers</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Aof%29%29" class="RktValLink" data-pltdoc="x">list*of</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">not-improper-numbers</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Aof%29%29" class="RktValLink" data-pltdoc="x">list*of</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">not-improper-numbers: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: number?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: '()</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: an element of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(list*of number?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: </span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(definition not-improper-numbers)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition not-improper-numbers)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:3:0</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.1.1.1 of package <span class="stt">base</span>.<br/>Changed in version 6.4.0.4: Added the <span class="RktVar">last-c</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/base..rkt)._cons/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">cons/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">car-c</span><span class="hspace">&nbsp;</span><span class="RktVar">cdr-c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">car-c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cdr-c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a contract that recognizes pairs whose first and second elements
+match <span class="RktVar">car-c</span> and <span class="RktVar">cdr-c</span>, respectively. Beware that
+when this contract is applied to a value, the result is not
+necessarily <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to the input.</div></p><p>If the <span class="RktVar">cdr-c</span> contract is a <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._list-contract~3f%29%29" class="RktValLink" data-pltdoc="x">list-contract?</a></span>, then
+<span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span> returns a <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._list-contract~3f%29%29" class="RktValLink" data-pltdoc="x">list-contract?</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a-pair-of-numbers</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">not-a-pair-of-numbers</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">not-a-pair-of-numbers: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: number?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: #f</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the car of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(cons/c number? number?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: </span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(definition not-a-pair-of-numbers)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition not-a-pair-of-numbers)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:3:0</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.0.1.13 of package <span class="stt">base</span>: Added the <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._list-contract~3f%29%29" class="RktValLink" data-pltdoc="x">list-contract?</a></span> propagating behavior.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/base..rkt)._cons/dc))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fdc%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">cons/dc</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">car-id</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">cdr-id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">car-id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktVar">cons/dc-option</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fdc%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">cons/dc</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">car-id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">cdr-id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">cdr-id</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktVar">cons/dc-option</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">cons/dc-option</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:flat</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:chaperone</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:impersonator</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Produces a contract that recognizes pairs whose first and second elements
+match the expressions after <span class="RktVar">car-id</span> and <span class="RktVar">cdr-id</span>, respectively.</div></p><p>In the first case, the contract on the <span class="RktVar">cdr-id</span> portion of the contract
+may depend on the value in the <span class="RktVar">car-id</span> portion of the pair and in
+the second case, the reverse is true.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">an-ordered-pair-of-reals</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fdc%29%29" class="RktStxLink" data-pltdoc="x">cons/dc</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">hd</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">tl</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hd</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hd</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">not-an-ordered-pair-of-reals</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fdc%29%29" class="RktStxLink" data-pltdoc="x">cons/dc</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">hd</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">tl</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hd</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hd</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">not-an-ordered-pair-of-reals: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: (&gt;=/c 2)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: 1</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the cdr of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(cons/dc (hd real?) (tl (hd) (&gt;=/c hd)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: </span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(definition not-an-ordered-pair-of-reals)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition not-an-ordered-pair-of-reals)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:3:0</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.1.1.6 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/base..rkt)._list/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">list/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._list-contract~3f%29%29" class="RktValLink" data-pltdoc="x">list-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a contract for a list. The number of elements in the list
+must match the number of arguments supplied to <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span>, and
+each element of the list must match the corresponding contract. Beware
+that when this contract is applied to a value, the result is not
+necessarily <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to the input.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/base..rkt)._*list/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._%2Alist%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">*list/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">prefix</span><span class="hspace">&nbsp;</span><span class="RktVar">suffix</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._list-contract~3f%29%29" class="RktValLink" data-pltdoc="x">list-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">suffix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a contract for a list. The number of elements in the list
+must be at least as long as the number of <span class="RktVar">suffix</span> contracts
+and the tail of the list must match those contracts, one for each
+element. The beginning portion of the list can be arbitrarily long,
+and each element must match <span class="RktVar">prefix</span>.</div></p><p>Beware that when this contract is applied to a value, the result is not
+necessarily <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to the input.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a-list-of-numbers-ending-with-two-integers</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._%2Alist%2Fc%29%29" class="RktValLink" data-pltdoc="x">*list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1/2</span><span class="hspace">&nbsp;</span><span class="RktVal">4/5</span><span class="hspace">&nbsp;</span><span class="RktVal">0+1i</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span>1</span><span class="hspace">&nbsp;</span><span class="RktVal">322</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">not-enough-integers-at-the-end</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._%2Alist%2Fc%29%29" class="RktValLink" data-pltdoc="x">*list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1/2</span><span class="hspace">&nbsp;</span><span class="RktVal">4/5</span><span class="hspace">&nbsp;</span><span class="RktVal">1/2</span><span class="hspace">&nbsp;</span><span class="RktVal">321</span><span class="hspace">&nbsp;</span><span class="RktVal">322</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">not-enough-integers-at-the-end: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: 1/2</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 3rd to the last element of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(*list/c number? integer? integer? integer?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: </span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(definition not-enough-integers-at-the-end)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition not-enough-integers-at-the-end)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:3:0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._syntax/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._syntax%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> that recognizes syntax objects whose
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span> content matches <span class="RktVar">c</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/private/struct-dc..rkt)._struct/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fstruct-dc..rkt%29._struct%2Fc%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">struct/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">struct-id</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Produces a contract that recognizes instances of the structure
+type named by <span class="RktVar">struct-id</span>, and whose field values match the
+contracts produced by the <span class="RktVar">contract-expr</span>s.</div></p><p>Contracts for immutable fields must be either flat or <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contracts</span></a>.
+Contracts for mutable fields may be impersonator contracts.
+If all fields are immutable and the <span class="RktVar">contract-expr</span>s evaluate
+to <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a>, a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> is produced.  If all the
+<span class="RktVar">contract-expr</span>s are <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contracts</span></a>, a <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contract</span></a> is
+produced.  Otherwise, an impersonator contract is produced.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/private/struct-dc..rkt)._struct/dc))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fstruct-dc..rkt%29._struct%2Fdc%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">struct/dc</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">struct-id</span><span class="hspace">&nbsp;</span><span class="RktVar">field-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-inv</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">field-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">field-name</span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-lazy</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">[</span><span class="RktVar">field-name</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">dep-field-name</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">maybe-lazy</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">maybe-contract-type</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">maybe-dep-state</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">]</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">field-name</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">field-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktPn">#:selector</span><span class="hspace">&nbsp;</span><span class="RktVar">selector-id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">field-id</span><span class="hspace">&nbsp;</span><span class="RktPn">#:parent</span><span class="hspace">&nbsp;</span><span class="RktVar">struct-id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">maybe-lazy</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:lazy</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">maybe-contract-type</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:flat</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:chaperone</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:impersonator</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">maybe-dep-state</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:depends-on-state</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">maybe-inv</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:inv</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">dep-field-name</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">invariant-expr</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Produces a contract that recognizes instances of the structure
+type named by <span class="RktVar">struct-id</span>, and whose field values match the
+contracts produced by the <span class="RktVar">field-spec</span>s.</div></p><p>If the <span class="RktVar">field-spec</span> lists the names of other fields,
+then the contract depends on values in those fields, and the <span class="RktVar">contract-expr</span>
+expression is evaluated each time a selector is applied, building a new contract
+for the fields based on the values of the <span class="RktVar">dep-field-name</span> fields (the
+<span class="RktVar">dep-field-name</span> syntax is the same as the <span class="RktVar">field-name</span> syntax).
+If the field is a dependent field and no <span class="RktSym">contract-type</span> annotation
+appears, then it is assumed that the contract is
+a chaperone, but not always a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> (and thus the entire <span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fstruct-dc..rkt%29._struct%2Fdc%29%29" class="RktStxLink" data-pltdoc="x">struct/dc</a></span>
+contract is not a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>).
+If this is not the case, and the contract is
+always flat then the field must be annotated with
+the <span class="RktPn">#:flat</span>, or the field must be annotated with
+<span class="RktPn">#:impersonator</span> (in which case, it must be a mutable field).</p><p>A <span class="RktVar">field-name</span> is either an identifier naming a field in the first
+case, an identifier naming a selector in the second case indicated
+by the <span class="RktPn">#:selector</span> keyword, or
+a field id for a struct that is a parent of <span class="RktVar">struct-id</span>, indicated
+by the <span class="RktPn">#:parent</span> keyword.</p><p>If the <span class="RktPn">#:lazy</span> keyword appears, then the contract
+on the field is checked lazily (only when a selector is applied);
+<span class="RktPn">#:lazy</span> contracts cannot be put on mutable fields.</p><p>If a dependent contract depends on some mutable state, then use the
+<span class="RktPn">#:depends-on-state</span> keyword argument (if a field&rsquo;s dependent contract
+depends on a mutable field, this keyword is automatically inferred).
+The presence of this keyword means that the contract expression is evaluated
+each time the corresponding field is accessed (or mutated, if it is a mutable
+field). Otherwise, the contract expression for a dependent field contract
+is evaluated when the contract is applied to a value.</p><p>If the <span class="RktPn">#:inv</span> clause appears, then the invariant expression is
+evaluated (and must return a non-<span class="RktVal">#f</span> value) when the contract
+is applied to a struct.</p><p>Contracts for immutable fields must be either flat or <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contracts</span></a>.
+Contracts for mutable fields may be impersonator contracts.
+If all fields are immutable and the <span class="RktVar">contract-expr</span>s evaluate
+to <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a>, a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> is produced.  If all the
+<span class="RktVar">contract-expr</span>s are <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contracts</span></a>, a <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contract</span></a> is
+produced.  Otherwise, an impersonator contract is produced.</p><p>As an example, the function <span class="RktSym">bst/c</span> below
+returns a contract for binary search trees whose values
+are all between <span class="RktSym">lo</span> and <span class="RktSym">hi</span>.
+The lazy annotations ensure that this contract does not
+change the running time of operations that do not
+inspect the entire tree.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktSym">left</span><span class="hspace">&nbsp;</span><span class="RktSym">right</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bst/c</span><span class="hspace">&nbsp;</span><span class="RktSym">lo</span><span class="hspace">&nbsp;</span><span class="RktSym">hi</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fstruct-dc..rkt%29._struct%2Fdc%29%29" class="RktStxLink" data-pltdoc="x">struct/dc</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bt</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._between%2Fc%29%29" class="RktValLink" data-pltdoc="x">between/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lo</span><span class="hspace">&nbsp;</span><span class="RktSym">hi</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">left</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:lazy</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bst/c</span><span class="hspace">&nbsp;</span><span class="RktSym">lo</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">right</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:lazy</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bst/c</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktSym">hi</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">not-really-a-bst</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bst/c</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-i</span>nf.0</span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bt</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bt</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bt</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bt</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">bt-right</span><span class="hspace">&nbsp;</span><span class="RktSym">not-really-a-bst</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">bt-val</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bt-left</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bt-left</span><span class="hspace">&nbsp;</span><span class="RktSym">not-really-a-bst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">bt-right</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bt-left</span><span class="hspace">&nbsp;</span><span class="RktSym">not-really-a-bst</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">not-really-a-bst: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: (between/c 4 5)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: 6</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the val field of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">a part of the or/c of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">the right field of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">a part of the or/c of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">the left field of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">a part of the or/c of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(or/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">#f</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(struct/dc</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">bt</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(val (between/c -inf.0 +inf.0))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(left (val) #:lazy ...)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(right (val) #:lazy ...)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition not-really-a-bst)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition not-really-a-bst)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:4:0</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.0.1.6 of package <span class="stt">base</span>: Added <span class="RktPn">#:inv</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._parameter/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._parameter%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">parameter/c</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:impersonator?</span><span class="hspace">&nbsp;</span><span class="RktVar">impersonator?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">in</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">impersonator?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a contract on parameters whose values must match
+<span class="RktVar">out</span>. When the value in the contracted parameter
+is set, it must match <span class="RktVar">in</span>.</div></p><p>If <span class="RktVar">impersonator?</span> is a true value, then
+ <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._parameter%2Fc%29%29" class="RktValLink" data-pltdoc="x">parameter/c</a></span> always returns an <a href="contracts.html#%28tech._impersonator._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator
+contract</span></a>. If it is <span class="RktVal">#f</span>, then the result will be a
+ <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contract</span></a> when both <span class="RktVar">in</span> and
+ <span class="RktVar">out</span> are <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contracts</span></a>, and an <a href="contracts.html#%28tech._impersonator._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator contract</span></a> otherwise.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">current-snack</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._parameter%2Fc%29%29" class="RktValLink" data-pltdoc="x">parameter/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._make-parameter%29%29" class="RktValLink" data-pltdoc="x">make-parameter</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"potato-chip"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">baked/c</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._flat-named-contract%29%29" class="RktValLink" data-pltdoc="x">flat-named-contract</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">baked/c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"baked"</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">current-dinner</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._parameter%2Fc%29%29" class="RktValLink" data-pltdoc="x">parameter/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">baked/c</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._make-parameter%29%29" class="RktValLink" data-pltdoc="x">make-parameter</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"turkey"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append%29%29" class="RktValLink" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"roasted "</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">current-snack</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">not-a-snack</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">current-snack: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: string?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 'not-a-snack</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the parameter of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(parameter/c string?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition current-snack)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">current-dinner</span><span class="hspace">&nbsp;</span><span class="RktVal">"tofurkey"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">current-dinner</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">current-dinner: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: baked/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: "roasted tofurkey"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the parameter of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(parameter/c string? baked/c)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition current-dinner)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition current-dinner)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:4:0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._procedure-arity-includes/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._procedure-arity-includes%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">procedure-arity-includes/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a contract for procedures that accept <span class="RktVar">n</span> argument
+(i.e,. the <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span> contract is implied).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/hash..rkt)._hash/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash/c</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">key</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">val</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:immutable</span><span class="hspace">&nbsp;</span><span class="RktVar">immutable</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:flat?</span><span class="hspace">&nbsp;</span><span class="RktVar">flat?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._chaperone-contract~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">immutable</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dont-care</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dont-care</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">flat?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a contract that recognizes <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash%29%29" class="RktValLink" data-pltdoc="x">hash</a></span> tables with keys and values
+as specified by the <span class="RktVar">key</span> and <span class="RktVar">val</span> arguments.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">good-hash</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fc%29%29" class="RktValLink" data-pltdoc="x">hash/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash%29%29" class="RktValLink" data-pltdoc="x">hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bad-hash</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fc%29%29" class="RktValLink" data-pltdoc="x">hash/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash%29%29" class="RktValLink" data-pltdoc="x">hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">"elephant"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">"monkey"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">"manatee"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">bad-hash: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: boolean?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: "elephant"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the values of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(hash/c integer? boolean?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition bad-hash)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition bad-hash)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:3:0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara">There are a number of technicalities that control how <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fc%29%29" class="RktValLink" data-pltdoc="x">hash/c</a></span> contracts
+behave.
+</div><div class="SIntrapara"><ul><li><p>If the <span class="RktVar">flat?</span> argument is <span class="RktVal">#t</span>, then the resulting contract is
+ a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>, and the <span class="RktVar">key</span> and <span class="RktVar">val</span> arguments must also be
+ <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fc%29%29" class="RktValLink" data-pltdoc="x">hash/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fc%29%29" class="RktValLink" data-pltdoc="x">hash/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:flat?</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fc%29%29" class="RktValLink" data-pltdoc="x">hash/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:flat?</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">hash/c: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: flat-contract?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: (-&gt; integer? integer?)</span></p></td></tr></table></blockquote></div></p><p>Such <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a> will be unsound if applied to mutable hash tables,
+ as they will not check future mutations to the hash table.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">original-h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hasheq%29%29" class="RktValLink" data-pltdoc="x">make-hasheq</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ctc-h</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fc%29%29" class="RktValLink" data-pltdoc="x">hash/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:flat?</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">original-h</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%21%29%29" class="RktValLink" data-pltdoc="x">hash-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">original-h</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">"not a boolean"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ctc-h</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"not a boolean"</span></p></td></tr></table></blockquote></div></p></li><li><p>If the <span class="RktVar">immutable</span> argument is <span class="RktVal">#t</span> and the <span class="RktVar">key</span> and
+<span class="RktVar">val</span> arguments are <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span>s, the result will be a
+<span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span>.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fc%29%29" class="RktValLink" data-pltdoc="x">hash/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:immutable</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p>If either the domain or the range is a <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._chaperone-contract~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-contract?</a></span>, then the result will
+be a <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._chaperone-contract~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-contract?</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fc%29%29" class="RktValLink" data-pltdoc="x">hash/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:immutable</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._chaperone-contract~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-contract?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fc%29%29" class="RktValLink" data-pltdoc="x">hash/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:immutable</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p></li><li><p><div class="SIntrapara">If the <span class="RktVar">key</span> argument is a <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._chaperone-contract~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-contract?</a></span> but not a
+<span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span>, then the resulting contract
+can be applied only to <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>-based hash tables.
+</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fc%29%29" class="RktValLink" data-pltdoc="x">hash/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hasheq%29%29" class="RktValLink" data-pltdoc="x">make-hasheq</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">h: broke its own contract;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">promised equal?-based hash table due to higher-order domain</span></p></td></tr><tr><td><p><span class="RktErr">contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: '#hasheq()</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (hash/c (-&gt; integer? integer?) any/c)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition h)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition h)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara">Also, when such a <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fc%29%29" class="RktValLink" data-pltdoc="x">hash/c</a></span> contract is applied to a hash table, the result is not
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>
+to the input. The result of applying the contract will be a copy for immutable hash tables,
+and either a <a href="chaperones.html#%28tech._chaperone%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone</span></a> or <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a> of the original hash table
+for mutable hash tables.</div></p></li></ul></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/contract/private/hash..rkt)._hash/dc))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fdc%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">hash/dc</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">key-id</span><span class="hspace">&nbsp;</span><span class="RktVar">key-contract-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">value-id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">key-id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">value-contract-expr</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">hash/dc-option</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">hash/dc-option</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:immutable</span><span class="hspace">&nbsp;</span><span class="RktVar">immutable?-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">hash/dc-option</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:kind</span><span class="hspace">&nbsp;</span><span class="RktVar">kind-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">hash/dc-option</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Creates a contract for <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span> tables with keys matching <span class="RktVar">key-contract-expr</span>
+and where the contract on the values can depend on the key itself, since
+<span class="RktVar">key-id</span> will be bound to the corresponding key before evaluating
+the <span class="RktSym">values-contract-expr</span>.</div></p><p>If <span class="RktVar">immutable?-expr</span> is <span class="RktVal">#t</span>, then only <span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span> hashes
+are accepted. If it is <span class="RktVal">#f</span> then <span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span> hashes are always
+rejected. It defaults to <span class="RktVal">'</span><span class="RktVal">dont-care</span>, in which case both mutable and
+immutable hashes are accepted.</p><p>If <span class="RktVar">kind-expr</span> evaluates to <span class="RktVal">'</span><span class="RktVal">flat</span>, then <span class="RktVar">key-contract-expr</span>
+and <span class="RktVar">value-contract-expr</span> are expected to evaluate to <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span>s.
+If it is <span class="RktVal">'</span><span class="RktVal">chaperone</span>, then they are expected to be <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._chaperone-contract~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-contract?</a></span>s,
+and it may also be <span class="RktVal">'</span><span class="RktVal">impersonator</span>, in which case they may be any <span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span>s.
+The default is <span class="RktVal">'</span><span class="RktVal">chaperone</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fdc%29%29" class="RktStxLink" data-pltdoc="x">hash/dc</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash%29%29" class="RktValLink" data-pltdoc="x">hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fdc%29%29" class="RktStxLink" data-pltdoc="x">hash/dc</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash%29%29" class="RktValLink" data-pltdoc="x">hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">h: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: (&gt;=/c 3)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: 1</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the values of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(hash/dc (k real?) (v (k) (&gt;=/c k)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition h)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition h)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:3:0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._channel/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._channel%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">channel/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a contract that recognizes <a href="channel.html#%28tech._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">channel</span></a>s that communicate
+values as specified by the <span class="RktVar">val</span> argument.</div></p><p>If the <span class="RktVar">val</span> argument is a <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contract</span></a>, then the resulting contract
+is a <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contract</span></a>. Otherwise, the resulting contract is an impersonator
+contract. When a channel contract is applied to a channel, the resulting channel
+is not <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to the input.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chan</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._channel%2Fc%29%29" class="RktValLink" data-pltdoc="x">channel/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._make-channel%29%29" class="RktValLink" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-get%29%29" class="RktValLink" data-pltdoc="x">channel-get</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chan</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;thread&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chan</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">not-a-string</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">chan: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: string?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 'not-a-string</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (channel/c string?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition chan)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/private/misc..rkt)._prompt-tag/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._prompt-tag%2Fc%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">prompt-tag/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">contract</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-call/cc</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">maybe-call/cc</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:call/cc</span><span class="hspace">&nbsp;</span><span class="RktVar">contract</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:call/cc</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVar">contract</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">contract</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Takes any number of contracts and returns a contract that recognizes
+continuation prompt tags and will check any aborts or prompt handlers that
+use the contracted prompt tag.</div></p><p>Each <span class="RktVar">contract</span> will check the corresponding value passed to
+an <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._abort-current-continuation%29%29" class="RktValLink" data-pltdoc="x">abort-current-continuation</a></span> and handled by the handler of a
+call to <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-prompt%29%29" class="RktValLink" data-pltdoc="x">call-with-continuation-prompt</a></span>.</p><p>If all of the <span class="RktVar">contract</span>s are <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contracts</span></a>, the resulting
+contract will also be a <a href="chaperones.html#%28tech._chaperone%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone</span></a> contract. Otherwise, the contract is
+an <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a> contract.</p><p>If <span class="RktVar">maybe-call/cc</span> is provided, then the provided contracts
+are used to check the return values from a continuation captured with
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-current-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-current-continuation</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._tag%29%29" class="RktStxLink" data-pltdoc="x">tag</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._prompt-tag%2Fc%29%29" class="RktStxLink" data-pltdoc="x">prompt-tag/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">make-continuation-prompt-tag</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-prompt%29%29" class="RktValLink" data-pltdoc="x">call-with-continuation-prompt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._number-~3estring%29%29" class="RktValLink" data-pltdoc="x">number-&gt;string</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-composable-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-composable-continuation</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._abort-current-continuation%29%29" class="RktValLink" data-pltdoc="x">abort-current-continuation</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._tag%29%29" class="RktStxLink" data-pltdoc="x">tag</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._tag%29%29" class="RktStxLink" data-pltdoc="x">tag</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktVal">"not a number"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">tag: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: number?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: "not a number"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(prompt-tag/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; number? string?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">#:call/cc)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition tag)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._continuation-mark-key/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._continuation-mark-key%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">continuation-mark-key/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">contract</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">contract</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Takes a single contract and returns a contract that recognizes
+continuation marks and will check any mappings of marks to values
+or any accesses of the mark value.</div></p><p>If the argument <span class="RktVar">contract</span> is a <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contract</span></a>, the resulting
+contract will also be a <a href="chaperones.html#%28tech._chaperone%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone</span></a> contract. Otherwise, the contract is
+an <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a> contract.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mark-key</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._continuation-mark-key%2Fc%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-key/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-mark-key%29%29" class="RktValLink" data-pltdoc="x">make-continuation-mark-key</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">mark-key</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._append%29%29" class="RktValLink" data-pltdoc="x">append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">truffle</span><span class="hspace">&nbsp;</span><span class="RktVal">fudge</span><span class="hspace">&nbsp;</span><span class="RktVal">ganache</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">mark-value</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-first%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set-first</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="RktValLink" data-pltdoc="x">current-continuation-marks</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">mark-key</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mark-value</span><span class="hspace">&nbsp;</span><span class="RktVal">"chocolate-bar"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">mark-key: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: symbol?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: "chocolate-bar"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(continuation-mark-key/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; symbol? (listof symbol?)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition mark-key)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._evt/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._evt%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">evt/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">contract</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._chaperone-contract~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">contract</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._chaperone-contract~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a contract that recognizes <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a>s whose
+<a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a>s are checked by the given
+<span class="RktVar">contract</span>s.</div></p><p>The resulting contract is always a <a href="chaperones.html#%28tech._chaperone%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone</span></a> contract and its
+arguments must all be <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contracts</span></a>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-evt</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._evt%2Fc%29%29" class="RktValLink" data-pltdoc="x">evt/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._always-evt%29%29" class="RktValLink" data-pltdoc="x">always-evt</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">failing-evt</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._evt%2Fc%29%29" class="RktValLink" data-pltdoc="x">evt/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._alarm-evt%29%29" class="RktValLink" data-pltdoc="x">alarm-evt</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-inexact-milliseconds%29%29" class="RktValLink" data-pltdoc="x">current-inexact-milliseconds</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">50</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-evt</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;always-evt&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span><span class="hspace">&nbsp;</span><span class="RktSym">failing-evt</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">failing-evt: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: event that produces 2 values</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: event that produces 1 values</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (evt/c number? number?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition failing-evt)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition failing-evt)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:3:0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/base..rkt)._flat-rec-contract))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._flat-rec-contract%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">flat-rec-contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">flat-contract-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Constructs a recursive <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>. A
+<span class="RktVar">flat-contract-expr</span> can refer to <span class="RktVar">id</span> to refer
+recursively to the generated contract.</div></p><p>For example, the contract</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._flat-rec-contract%29%29" class="RktStxLink" data-pltdoc="x">flat-rec-contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sexp</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sexp</span><span class="hspace">&nbsp;</span><span class="RktSym">sexp</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr></table></blockquote><p>is a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> that checks for (a limited form of)
+S-expressions. It says that a <span class="RktVar">sexp</span> is either two
+<span class="RktVar">sexp</span>s combined with <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span>, or a number, or a symbol.</p><p>Note that if the contract is applied to a circular value, contract
+checking will not terminate.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/base..rkt)._flat-murec-contract))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._flat-murec-contract%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">flat-murec-contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">flat-contract-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A generalization of <span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._flat-rec-contract%29%29" class="RktStxLink" data-pltdoc="x">flat-rec-contract</a></span> for defining several
+mutually recursive <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a> simultaneously. Each <span class="RktVar">id</span> is
+visible in the entire <span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._flat-murec-contract%29%29" class="RktStxLink" data-pltdoc="x">flat-murec-contract</a></span> form, and the
+result of the final <span class="RktVar">body</span> is the result of the entire form.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/contract/private/misc..rkt)._any))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">any</a></span></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Represents a contract that is always satisfied. In particular, it can accept
+multiple values.  It can only be used in a result position of contracts like
+<span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span>. Using <span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span> elsewhere is a syntax error.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._promise/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._promise%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">promise/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Constructs a contract on a promise. The contract does not force the
+promise, but when the promise is forced, the contract checks that the
+result value meets the contract <span class="RktVar">c</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._flat-contract))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._flat-contract%29%29" class="RktValDef RktValLink" data-pltdoc="x">flat-contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">predicate</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">predicate</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Constructs a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> from <span class="RktVar">predicate</span>. A value
+satisfies the contract if the predicate returns a true value.</div></p><p>This function is a holdover from before predicates could be used
+directly as <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a>. It exists today for backwards compatibility.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._flat-contract-predicate))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._flat-contract-predicate%29%29" class="RktValDef RktValLink" data-pltdoc="x">flat-contract-predicate</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Extracts the predicate from a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>.</div></p><p>Note that most <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a> can be used directly as predicates, but not all.
+This function can be used to build predicates for ordinary Racket values that double
+as contracts, such as numbers and symbols. When building a <a href="contracts.html#%28tech._contract._combinator%29" class="techoutside" data-pltdoc="x"><span class="techinside">contract combinator</span></a>
+that needs to explicitly convert ordinary racket values to flat contracts, consider
+using <span class="RktSym"><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-flat-contract%29%29" class="RktValLink" data-pltdoc="x">coerce-flat-contract</a></span> instead of <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._flat-contract-predicate%29%29" class="RktValLink" data-pltdoc="x">flat-contract-predicate</a></span> so
+that the combinator can raise errors that use the combinator&rsquo;s name in the error
+message.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/base..rkt)._property/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._property%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">property/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">accessor</span><span class="hspace">&nbsp;</span><span class="RktVar">ctc</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktPn">#:name</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">accessor</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ctc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span><span class="hspace">&nbsp;</span><span class="RktVar">accessor</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Constructs a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> that checks that the first-order property
+accessed by <span class="RktVar">accessor</span> satisfies <span class="RktVar">ctc</span>. The resulting contract
+is equivalent to</div></p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">ctc</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">accessor</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>except that more information is included in error messages produced by
+violations of the contract. The <span class="RktVar">name</span> argument is used to describe the
+property being checked in error messages.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">sum-triple</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._property%2Fc%29%29" class="RktValLink" data-pltdoc="x">property/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._length%29%29" class="RktValLink" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._first%29%29" class="RktValLink" data-pltdoc="x">first</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._second%29%29" class="RktValLink" data-pltdoc="x">second</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._third%29%29" class="RktValLink" data-pltdoc="x">third</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">sum-triple</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">6</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">sum-triple</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">sum-triple: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: (=/c 3)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 2</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the length of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">an and/c case of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(and/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(listof number?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(property/c length (=/c 3)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">number?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (function sum-triple)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 7.3.0.11 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/private/misc..rkt)._suggest/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._suggest%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">suggest/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span><span class="RktVar">field</span><span class="hspace">&nbsp;</span><span class="RktVar">message</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">field</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">message</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a contract that behaves like <span class="RktVar">c</span>, except
+that it adds an extra line to the error message on a contract
+violation.</div></p><p>The <span class="RktVar">field</span> and <span class="RktVar">message</span> strings are added
+following the guidelines in
+<a href="exns.html#%28part._err-msg-conventions%29" data-pltdoc="x">Error Message Conventions</a>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">allow-calls?</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._suggest%2Fc%29%29" class="RktValLink" data-pltdoc="x">suggest/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:pre</span><span class="hspace">&nbsp;</span><span class="RktSym">allow-calls?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"suggestion"</span><span class="hspace">&nbsp;</span><span class="RktVal">"maybe you should set! allow-calls? to #t"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">f: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">#:pre condition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">suggestion: maybe you should set! allow-calls? to #t</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (-&gt;* () #:pre ... any)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (function f)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:3:0</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contracts.html" title="backward to &quot;8 Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="function-contracts.html" title="forward to &quot;8.2 Function Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/data.html b/clones/docs.racket-lang.org/reference/data.html
new file mode 100644
index 00000000..e50f7aa7
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/data.html
@@ -0,0 +1,3 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4&nbsp;Datatypes</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="lazy-require.html" title="backward to &quot;3.26 Importing Modules Lazily: lazy-require&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Equality.html" title="forward to &quot;4.1 Equality&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;data&quot;">4<tt>&nbsp;</tt><a name="(part._data)"></a>Datatypes</h3><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=datatypes.html&amp;version=8.6" class="Sq" data-pltdoc="x">Built-In Datatypes</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces Datatypes.</p></blockquote></blockquote></blockquote><p>Each pre-defined datatype comes with a set of procedures for
+manipulating instances of the datatype.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Equality.html" class="toclink" data-pltdoc="x">4.1<span class="hspace">&nbsp;</span>Equality</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="booleans.html" class="toclink" data-pltdoc="x">4.2<span class="hspace">&nbsp;</span>Booleans</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="numbers.html" class="toclink" data-pltdoc="x">4.3<span class="hspace">&nbsp;</span>Numbers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="strings.html" class="toclink" data-pltdoc="x">4.4<span class="hspace">&nbsp;</span>Strings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="bytestrings.html" class="toclink" data-pltdoc="x">4.5<span class="hspace">&nbsp;</span>Byte Strings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="characters.html" class="toclink" data-pltdoc="x">4.6<span class="hspace">&nbsp;</span>Characters</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="symbols.html" class="toclink" data-pltdoc="x">4.7<span class="hspace">&nbsp;</span>Symbols</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp.html" class="toclink" data-pltdoc="x">4.8<span class="hspace">&nbsp;</span>Regular Expressions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="keywords.html" class="toclink" data-pltdoc="x">4.9<span class="hspace">&nbsp;</span>Keywords</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pairs.html" class="toclink" data-pltdoc="x">4.10<span class="hspace">&nbsp;</span>Pairs and Lists</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="mpairs.html" class="toclink" data-pltdoc="x">4.11<span class="hspace">&nbsp;</span>Mutable Pairs and Lists</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="vectors.html" class="toclink" data-pltdoc="x">4.12<span class="hspace">&nbsp;</span>Vectors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stencil_vectors.html" class="toclink" data-pltdoc="x">4.13<span class="hspace">&nbsp;</span>Stencil Vectors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="boxes.html" class="toclink" data-pltdoc="x">4.14<span class="hspace">&nbsp;</span>Boxes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="hashtables.html" class="toclink" data-pltdoc="x">4.15<span class="hspace">&nbsp;</span>Hash Tables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sequences_streams.html" class="toclink" data-pltdoc="x">4.16<span class="hspace">&nbsp;</span>Sequences and Streams</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="dicts.html" class="toclink" data-pltdoc="x">4.17<span class="hspace">&nbsp;</span>Dictionaries</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sets.html" class="toclink" data-pltdoc="x">4.18<span class="hspace">&nbsp;</span>Sets</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="procedures.html" class="toclink" data-pltdoc="x">4.19<span class="hspace">&nbsp;</span>Procedures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="void.html" class="toclink" data-pltdoc="x">4.20<span class="hspace">&nbsp;</span>Void</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="undefined.html" class="toclink" data-pltdoc="x">4.21<span class="hspace">&nbsp;</span>Undefined</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="lazy-require.html" title="backward to &quot;3.26 Importing Modules Lazily: lazy-require&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Equality.html" title="forward to &quot;4.1 Equality&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/debugging.html b/clones/docs.racket-lang.org/reference/debugging.html
new file mode 100644
index 00000000..2511b87b
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/debugging.html
@@ -0,0 +1,87 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>18.6&nbsp;Debugging</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewselflink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">18.1&nbsp;</td><td><a href="running-sa.html" class="tocviewlink" data-pltdoc="x">Running Racket or GRacket</a></td></tr><tr><td align="right">18.2&nbsp;</td><td><a href="collects.html" class="tocviewlink" data-pltdoc="x">Libraries and Collections</a></td></tr><tr><td align="right">18.3&nbsp;</td><td><a href="Interactive_Help.html" class="tocviewlink" data-pltdoc="x">Interactive Help</a></td></tr><tr><td align="right">18.4&nbsp;</td><td><a href="interaction-info.html" class="tocviewlink" data-pltdoc="x">Interaction Configuration</a></td></tr><tr><td align="right">18.5&nbsp;</td><td><a href="interactive.html" class="tocviewlink" data-pltdoc="x">Interactive Module Loading</a></td></tr><tr><td align="right">18.6&nbsp;</td><td><a href="debugging.html" class="tocviewselflink" data-pltdoc="x">Debugging</a></td></tr><tr><td align="right">18.7&nbsp;</td><td><a href="compiler.html" class="tocviewlink" data-pltdoc="x">Controlling and Inspecting Compilation</a></td></tr><tr><td align="right">18.8&nbsp;</td><td><a href="Kernel_Forms_and_Functions.html" class="tocviewlink" data-pltdoc="x">Kernel Forms and Functions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>18.6&nbsp;</td><td><a href="debugging.html" class="tocviewselflink" data-pltdoc="x">Debugging</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">18.6.1&nbsp;</td><td><a href="debugging.html#%28part._.Tracing%29" class="tocviewlink" data-pltdoc="x">Tracing</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">18.6.1<tt>&nbsp;</tt></span><a href="debugging.html#%28part._.Tracing%29" class="tocsubseclink" data-pltdoc="x">Tracing</a></td></tr><tr><td><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">trace</span></span></a></td></tr><tr><td><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-define%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">trace-<wbr></wbr>define</span></span></a></td></tr><tr><td><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-define-syntax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">trace-<wbr></wbr>define-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-lambda%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">trace-<wbr></wbr>lambda</span></span></a></td></tr><tr><td><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-let%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">trace-<wbr></wbr>let</span></span></a></td></tr><tr><td><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._untrace%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">untrace</span></span></a></td></tr><tr><td><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-notify%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>trace-<wbr></wbr>notify</span></span></a></td></tr><tr><td><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._trace-call%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">trace-<wbr></wbr>call</span></span></a></td></tr><tr><td><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-args%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>trace-<wbr></wbr>print-<wbr></wbr>args</span></span></a></td></tr><tr><td><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-results%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>trace-<wbr></wbr>print-<wbr></wbr>results</span></span></a></td></tr><tr><td><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-prefix-in%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>prefix-<wbr></wbr>in</span></span></a></td></tr><tr><td><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-prefix-out%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>prefix-<wbr></wbr>out</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="interactive.html" title="backward to &quot;18.5 Interactive Module Loading&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;18 Running Racket&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="compiler.html" title="forward to &quot;18.7 Controlling and Inspecting Compilation&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;debugging&quot;">18.6<tt>&nbsp;</tt><a name="(part._debugging)"></a>Debugging</h4><p>Racket&rsquo;s built-in debugging support is limited to context (i.e.,
+&ldquo;stack trace&rdquo;) information that is printed with an exception. In
+some cases, for <a href="implementations.html#%28tech._bc%29" class="techoutside" data-pltdoc="x"><span class="techinside">BC</span></a> implementation of Racket, disabling the
+<a href="eval.html#%28tech._jit%29" class="techoutside" data-pltdoc="x"><span class="techinside">JIT</span></a> compiler can affect context information. For the <a href="implementations.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a>
+implementation of Racket, setting the <a name="(idx._(gentag._563._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_CS_DEBUG</span> environment
+variable causes compilation to record expression-level context
+information, instead of just function-level information.</p><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=errortrace&amp;rel=using-errortrace.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">errortrace</span></a> library supports more consistent
+(independent of the compiler) and precise context
+information. The <a href="debugging.html#%28mod-path._racket%2Ftrace%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/trace</span></a> library provides simple
+tracing support. Finally, the <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?tag=%28part._%28.%27%28lib._scribblings%2Fdrracket%2Fdrracket..scrbl%29.%27._.%27top.%27%29%29&amp;version=8.6" class="Sq" data-pltdoc="x">DrRacket</a>
+programming environment provides much more debugging support.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Tracing&quot;">18.6.1<tt>&nbsp;</tt><a name="(part._.Tracing)"></a><a name="(mod-path._racket/trace)"></a>Tracing</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="debugging.html#%28mod-path._racket%2Ftrace%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/trace</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="debugging.html#%28mod-path._racket%2Ftrace%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/trace</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p>The <a href="debugging.html#%28mod-path._racket%2Ftrace%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/trace</span></a> library mimics the tracing facility
+available in Chez Scheme.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/trace..rkt)._trace))"></a><span title="Provided from: racket/trace | Package: base"><span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">trace</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Each <span class="RktVar">id</span> must be bound to a procedure in the environment of
+the <span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace%29%29" class="RktStxLink" data-pltdoc="x">trace</a></span> expression, and must not be imported from another module.
+Each <span class="RktVar">id</span> is <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>ed to
+a new procedure that traces procedure calls and returns by printing
+the arguments and results of the call via
+<span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-notify%29%29" class="RktValLink" data-pltdoc="x">current-trace-notify</a></span>.  If multiple values are returned, each
+value is displayed starting on a separate line.</div></p><p>When traced procedures invoke each other, nested invocations are shown
+by printing a nesting prefix. If the nesting depth grows to ten and
+beyond, a number is printed to show the actual nesting depth.</p><p>The <span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace%29%29" class="RktStxLink" data-pltdoc="x">trace</a></span> form can be used on an identifier that is already
+traced.  In this case, assuming that the variable&rsquo;s value has not been
+changed, <span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace%29%29" class="RktStxLink" data-pltdoc="x">trace</a></span> has no effect.  If the variable has been
+changed to a different procedure, then a new trace is installed.</p><p>Tracing respects tail calls to preserve loops, but its effect may be
+visible through continuation marks. When a call to a traced procedure
+occurs in tail position with respect to a previous traced call, then
+the tailness of the call is preserved (and the result of the call is
+not printed for the tail call, because the same result will be printed
+for an enclosing call). Otherwise, however, the body of a traced
+procedure is not evaluated in tail position with respect to a call to
+the procedure.</p><p>The result of a <span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace%29%29" class="RktStxLink" data-pltdoc="x">trace</a></span> expression is <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace%29%29" class="RktStxLink" data-pltdoc="x">trace</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">&gt;(f 10)</span></p></td></tr><tr><td><p><span class="RktOut">&gt; (f 9)</span></p></td></tr><tr><td><p><span class="RktOut">&gt; &gt;(f 8)</span></p></td></tr><tr><td><p><span class="RktOut">&gt; &gt; (f 7)</span></p></td></tr><tr><td><p><span class="RktOut">&gt; &gt; &gt;(f 6)</span></p></td></tr><tr><td><p><span class="RktOut">&gt; &gt; &gt; (f 5)</span></p></td></tr><tr><td><p><span class="RktOut">&gt; &gt; &gt; &gt;(f 4)</span></p></td></tr><tr><td><p><span class="RktOut">&gt; &gt; &gt; &gt; (f 3)</span></p></td></tr><tr><td><p><span class="RktOut">&gt; &gt; &gt; &gt; &gt;(f 2)</span></p></td></tr><tr><td><p><span class="RktOut">&gt; &gt; &gt; &gt; &gt; (f 1)</span></p></td></tr><tr><td><p><span class="RktOut">&gt; &gt; &gt; &gt;[10] (f 0)</span></p></td></tr><tr><td><p><span class="RktOut">&lt; &lt; &lt; &lt;[10] 0</span></p></td></tr><tr><td><p><span class="RktOut">&lt; &lt; &lt; &lt; &lt; 1</span></p></td></tr><tr><td><p><span class="RktOut">&lt; &lt; &lt; &lt; &lt;2</span></p></td></tr><tr><td><p><span class="RktOut">&lt; &lt; &lt; &lt; 3</span></p></td></tr><tr><td><p><span class="RktOut">&lt; &lt; &lt; &lt;4</span></p></td></tr><tr><td><p><span class="RktOut">&lt; &lt; &lt; 5</span></p></td></tr><tr><td><p><span class="RktOut">&lt; &lt; &lt;6</span></p></td></tr><tr><td><p><span class="RktOut">&lt; &lt; 7</span></p></td></tr><tr><td><p><span class="RktOut">&lt; &lt;8</span></p></td></tr><tr><td><p><span class="RktOut">&lt; 9</span></p></td></tr><tr><td><p><span class="RktOut">&lt;10</span></p></td></tr></table></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr></table></blockquote></div></p><p><span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace%29%29" class="RktStxLink" data-pltdoc="x">trace</a></span> can also be used to debug <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformers</span></a>.
+This is verbose to do directly with <span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace%29%29" class="RktStxLink" data-pltdoc="x">trace</a></span>; refer to <span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-define-syntax%29%29" class="RktStxLink" data-pltdoc="x">trace-define-syntax</a></span> for a
+simpler way to do this.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/trace</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktVar">let</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="RktStxLink" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">e</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">e</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace%29%29" class="RktStxLink" data-pltdoc="x">trace</a></span><span class="hspace">&nbsp;</span><span class="RktVar">let</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktVar">let</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">120</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">&gt;(_let #&lt;syntax:eval:9:0 (let ((x 120)) x)&gt;)</span></p></td></tr><tr><td><p><span class="RktOut">&lt;#&lt;syntax:eval:9:0 ((lambda (x) x) 120)&gt;</span></p></td></tr></table></td></tr><tr><td><p><span class="RktRes">120</span></p></td></tr></table></blockquote></div></p><p>When tracing syntax transformers, it may be helpful to modify <span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-args%29%29" class="RktValLink" data-pltdoc="x">current-trace-print-args</a></span> and
+<span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-results%29%29" class="RktValLink" data-pltdoc="x">current-trace-print-results</a></span> to make the trace output more readable; see
+<span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-args%29%29" class="RktValLink" data-pltdoc="x">current-trace-print-args</a></span> for an extended example.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/trace..rkt)._trace-define))"></a><span title="Provided from: racket/trace | Package: base"><span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-define%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">trace-define</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-define%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">trace-define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">head</span><span class="hspace">&nbsp;</span><span class="RktVar">args</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-define%29%29" class="RktStxLink" data-pltdoc="x">trace-define</a></span> form is short-hand for first defining a
+function then tracing it. This form supports all <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span> forms.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-define%29%29" class="RktStxLink" data-pltdoc="x">trace-define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">&gt;(f 5)</span></p></td></tr><tr><td><p><span class="RktOut">&gt; (f 4)</span></p></td></tr><tr><td><p><span class="RktOut">&gt; &gt;(f 3)</span></p></td></tr><tr><td><p><span class="RktOut">&gt; &gt; (f 2)</span></p></td></tr><tr><td><p><span class="RktOut">&gt; &gt; &gt;(f 1)</span></p></td></tr><tr><td><p><span class="RktOut">&gt; &gt; &gt; (f 0)</span></p></td></tr><tr><td><p><span class="RktOut">&lt; &lt; &lt; 0</span></p></td></tr><tr><td><p><span class="RktOut">&lt; &lt; &lt;1</span></p></td></tr><tr><td><p><span class="RktOut">&lt; &lt; 2</span></p></td></tr><tr><td><p><span class="RktOut">&lt; &lt;3</span></p></td></tr><tr><td><p><span class="RktOut">&lt; 4</span></p></td></tr><tr><td><p><span class="RktOut">&lt;5</span></p></td></tr></table></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-define%29%29" class="RktStxLink" data-pltdoc="x">trace-define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">+n</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">+n</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">&gt;(+n 5)</span></p></td></tr><tr><td><p><span class="RktOut">&lt;#&lt;procedure&gt;</span></p></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(6 8 9)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/trace..rkt)._trace-define-syntax))"></a><span title="Provided from: racket/trace | Package: base"><span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-define-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">trace-define-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-define-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">trace-define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">head</span><span class="hspace">&nbsp;</span><span class="RktVar">args</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-define-syntax%29%29" class="RktStxLink" data-pltdoc="x">trace-define-syntax</a></span> form is short-hand for first defining a
+syntax transformer then tracing it. This form supports all <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span> forms.</div></p><p>For example:</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-define-syntax%29%29" class="RktStxLink" data-pltdoc="x">trace-define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fact</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="RktStxLink" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">120</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">fact</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">&gt;(fact #&lt;syntax:eval:15:0 (fact 5)&gt;)</span></p></td></tr><tr><td><p><span class="RktOut">&lt;#&lt;syntax:eval:15:0 120&gt;</span></p></td></tr></table></td></tr><tr><td><p><span class="RktRes">120</span></p></td></tr></table></blockquote></div></p><p>By default, <span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace%29%29" class="RktStxLink" data-pltdoc="x">trace</a></span> prints out syntax objects when tracing a
+syntax transformer. This can result in too much output if you do not need to see,
+e.g., source information.
+To get more readable output by printing syntax objects as datums, we can modify the
+<span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-args%29%29" class="RktValLink" data-pltdoc="x">current-trace-print-args</a></span> and <span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-results%29%29" class="RktValLink" data-pltdoc="x">current-trace-print-results</a></span>.
+See <span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-args%29%29" class="RktValLink" data-pltdoc="x">current-trace-print-args</a></span> for an example.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/trace..rkt)._trace-lambda))"></a><span title="Provided from: racket/trace | Package: base"><span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-lambda%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">trace-lambda</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">#:name</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktVar">args</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-lambda%29%29" class="RktStxLink" data-pltdoc="x">trace-lambda</a></span> form enables tracing an anonymous function. This
+form will attempt to infer a name using
+<span class="RktSym">syntax-local-infer-name</span>, or a name can be specified using the
+optional <span class="RktPn">#:name</span> argument.  A syntax error is raised if a name
+is not given and a name cannot be inferred.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-lambda%29%29" class="RktStxLink" data-pltdoc="x">trace-lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">120</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">&gt;(eval:16:0 5)</span></p></td></tr><tr><td><p><span class="RktOut">&lt;120</span></p></td></tr></table></td></tr><tr><td><p><span class="RktRes">120</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/trace..rkt)._trace-let))"></a><span title="Provided from: racket/trace | Package: base"><span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-let%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">trace-let</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-let%29%29" class="RktStxLink" data-pltdoc="x">trace-let</a></span> form enables tracing a named let.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-let%29%29" class="RktStxLink" data-pltdoc="x">trace-let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">&gt;(f 5)</span></p></td></tr><tr><td><p><span class="RktOut">&gt; (f 4)</span></p></td></tr><tr><td><p><span class="RktOut">&gt; &gt;(f 3)</span></p></td></tr><tr><td><p><span class="RktOut">&gt; &gt; (f 2)</span></p></td></tr><tr><td><p><span class="RktOut">&gt; &gt; &gt;(f 1)</span></p></td></tr><tr><td><p><span class="RktOut">&gt; &gt; &gt; (f 0)</span></p></td></tr><tr><td><p><span class="RktOut">&lt; &lt; &lt; 1</span></p></td></tr><tr><td><p><span class="RktOut">&lt; &lt; &lt;1</span></p></td></tr><tr><td><p><span class="RktOut">&lt; &lt; 2</span></p></td></tr><tr><td><p><span class="RktOut">&lt; &lt;6</span></p></td></tr><tr><td><p><span class="RktOut">&lt; 24</span></p></td></tr><tr><td><p><span class="RktOut">&lt;120</span></p></td></tr></table></td></tr><tr><td><p><span class="RktRes">120</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/trace..rkt)._untrace))"></a><span title="Provided from: racket/trace | Package: base"><span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._untrace%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">untrace</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Undoes the effects of the <span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace%29%29" class="RktStxLink" data-pltdoc="x">trace</a></span> form for each <span class="RktVar">id</span>,
+<span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>ing each <span class="RktVar">id</span> back to the untraced procedure, but
+only if the current value of <span class="RktVar">id</span> is a traced procedure.  If
+the current value of a <span class="RktVar">id</span> is not a procedure installed by
+<span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace%29%29" class="RktStxLink" data-pltdoc="x">trace</a></span>, then the variable is not changed.</div></p><p>The result of an <span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._untrace%29%29" class="RktStxLink" data-pltdoc="x">untrace</a></span> expression is <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/trace..rkt)._current-trace-notify))"></a><span title="Provided from: racket/trace | Package: base"><span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-notify%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-trace-notify</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/trace | Package: base"><span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-notify%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-trace-notify</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the way that trace output is
+displayed. The string given to <span class="RktVar">proc</span> is a trace; it does not
+end with a newline, but it may contain internal newlines. Each call or
+result is converted into a string using <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print%29%29" class="RktValLink" data-pltdoc="x">pretty-print</a></span>.  The
+parameter&rsquo;s default value prints the given string followed by a newline to
+<span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/trace..rkt)._trace-call))"></a><span title="Provided from: racket/trace | Package: base"><span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._trace-call%29%29" class="RktValDef RktValLink" data-pltdoc="x">trace-call</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktPn">#:&lt;kw&gt;</span><span class="hspace">&nbsp;</span><span class="RktVar">kw-arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">kw-arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Calls <span class="RktVar">proc</span> with the arguments supplied in
+<span class="RktVar">args</span>, and possibly using keyword arguments. Also prints out the
+trace information during the call, as described above in the docs for
+<span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace%29%29" class="RktStxLink" data-pltdoc="x">trace</a></span>, using <span class="RktVar">id</span> as the name of <span class="RktVar">proc</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/trace..rkt)._current-trace-print-args))"></a><span title="Provided from: racket/trace | Package: base"><span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-args%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-trace-print-args</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/trace | Package: base"><span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-args%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-trace-print-args</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">trace-print-args</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">trace-print-args</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The value of this parameter is invoked to print out the arguments of a
+traced call. It receives the name of the function, the function&rsquo;s
+ordinary arguments, its keywords, the values of the keywords, and a
+number indicating the depth of the call.</div></p><p>Modifying this and <span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-results%29%29" class="RktValLink" data-pltdoc="x">current-trace-print-results</a></span> is useful to to get more
+readable or additional output when tracing syntax transformers.
+For example, we can use <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?tag=%28mod-path._.%27debug-scopes.%27%29&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">debug-scopes</span></a> to add scopes information
+to the trace, (see <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?tag=%28mod-path._.%27debug-scopes.%27%29&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">debug-scopes</span></a> for an example),
+or remove source location information to just display the shape of the syntax
+object</p><p>In this example, we update the printers <span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-args%29%29" class="RktValLink" data-pltdoc="x">current-trace-print-args</a></span> and
+<span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-results%29%29" class="RktValLink" data-pltdoc="x">current-trace-print-results</a></span>
+by storing the current printers (<span class="RktSym">ctpa</span> and
+<span class="RktSym">ctpr</span>) to cast syntax objects to datum using <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span> and then
+pass the transformed arguments and results to the previous printer.
+When tracing, syntax arguments will be displayed without source location
+information, shortening the output.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/trace</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-args%29%29" class="RktValLink" data-pltdoc="x">current-trace-print-args</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ctpa</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-args%29%29" class="RktValLink" data-pltdoc="x">current-trace-print-args</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktSym">kw</span><span class="hspace">&nbsp;</span><span class="RktSym">l2</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ctpa</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">kw</span><span class="hspace">&nbsp;</span><span class="RktSym">l2</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-results%29%29" class="RktValLink" data-pltdoc="x">current-trace-print-results</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ctpr</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-results%29%29" class="RktValLink" data-pltdoc="x">current-trace-print-results</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ctpr</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-define-syntax%29%29" class="RktStxLink" data-pltdoc="x">trace-define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fact</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="RktStxLink" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">120</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">fact</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">&gt;(fact '(fact 5))</span></p></td></tr><tr><td><p><span class="RktOut">&lt;120</span></p></td></tr></table></td></tr><tr><td><p><span class="RktRes">120</span></p></td></tr></table></blockquote></div></p><p>We must take care when modifying these parameters, especially when the
+transformation makes assumptions about or changes the type of the
+argument/result of the traced identifier.
+This modification of <span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-args%29%29" class="RktValLink" data-pltdoc="x">current-trace-print-args</a></span> and
+<span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-results%29%29" class="RktValLink" data-pltdoc="x">current-trace-print-results</a></span> is an imperative update, and will affect all traced identifiers.
+This example assumes all arguments and results to <span class="emph">all traced functions</span> will be syntax objects,
+which is the case only if you are only tracing syntax transformers.
+If used as-is, the above code could result in type errors when tracing both functions and syntax transformers.
+It would be better to use <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span> only when the argument or result is actually a syntax
+object, for example, by defining <span class="RktSym">maybe-syntax-&gt;datum</span> as follows.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/trace</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">maybe-syntax-&gt;datum</span><span class="hspace">&nbsp;</span><span class="RktSym">syn?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">syn?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktSym">syn?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">syn?</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-args%29%29" class="RktValLink" data-pltdoc="x">current-trace-print-args</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ctpa</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-args%29%29" class="RktValLink" data-pltdoc="x">current-trace-print-args</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktSym">kw</span><span class="hspace">&nbsp;</span><span class="RktSym">l2</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ctpa</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym">maybe-syntax-&gt;datum</span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">kw</span><span class="hspace">&nbsp;</span><span class="RktSym">l2</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-results%29%29" class="RktValLink" data-pltdoc="x">current-trace-print-results</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ctpr</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-results%29%29" class="RktValLink" data-pltdoc="x">current-trace-print-results</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ctpr</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym">maybe-syntax-&gt;datum</span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-define%29%29" class="RktStxLink" data-pltdoc="x">trace-define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">precompute-fact</span><span class="hspace">&nbsp;</span><span class="RktSym">syn</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">syn</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._build-list%29%29" class="RktValLink" data-pltdoc="x">build-list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-define%29%29" class="RktStxLink" data-pltdoc="x">trace-define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">run-time-fact</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._build-list%29%29" class="RktValLink" data-pltdoc="x">build-list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">syntax/parse</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-define-syntax%29%29" class="RktStxLink" data-pltdoc="x">trace-define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fact</span><span class="hspace">&nbsp;</span><span class="RktSym">syn</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">syntax-parse</span><span class="hspace">&nbsp;</span><span class="RktSym">syn</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x:nat</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">precompute-fact</span><span class="hspace">&nbsp;</span><span class="RktSym">syn</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">run-time-fact</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">fact</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">&gt;(fact '(fact 5))</span></p></td></tr><tr><td><p><span class="RktOut">&gt;(precompute-fact '(fact 5) 5)</span></p></td></tr><tr><td><p><span class="RktOut">&lt;120</span></p></td></tr></table></td></tr><tr><td><p><span class="RktRes">120</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">fact</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">&gt;(fact '(fact (+ 2 3)))</span></p></td></tr><tr><td><p><span class="RktOut">&lt;'(run-time-fact (+ 2 3))</span></p></td></tr><tr><td><p><span class="RktOut">&gt;(run-time-fact 5)</span></p></td></tr><tr><td><p><span class="RktOut">&lt;120</span></p></td></tr></table></td></tr><tr><td><p><span class="RktRes">120</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/trace..rkt)._current-trace-print-results))"></a><span title="Provided from: racket/trace | Package: base"><span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-results%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-trace-print-results</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/trace | Package: base"><span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-results%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-trace-print-results</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">trace-print-results</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">trace-print-results</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The value of this parameter is invoked to print out the results of a
+traced call. It receives the name of the function, the function&rsquo;s
+results, and a number indicating the depth of the call.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/trace..rkt)._current-prefix-in))"></a><span title="Provided from: racket/trace | Package: base"><span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-prefix-in%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-prefix-in</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/trace | Package: base"><span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-prefix-in%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-prefix-in</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">prefix</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">This string is used by the default value of <span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-args%29%29" class="RktValLink" data-pltdoc="x">current-trace-print-args</a></span>
+indicating that the current line is showing the a call to a
+traced function.</div></p><p>It defaults to <span class="RktVal">"&gt;"</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/trace..rkt)._current-prefix-out))"></a><span title="Provided from: racket/trace | Package: base"><span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-prefix-out%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-prefix-out</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/trace | Package: base"><span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-prefix-out%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-prefix-out</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">prefix</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">This string is used by the default value of <span class="RktSym"><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-results%29%29" class="RktValLink" data-pltdoc="x">current-trace-print-results</a></span>
+indicating that the current line is showing the result
+of a traced call.</div></p><p>It defaults to <span class="RktVal">"&lt;"</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="interactive.html" title="backward to &quot;18.5 Interactive Module Loading&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;18 Running Racket&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="compiler.html" title="forward to &quot;18.7 Controlling and Inspecting Compilation&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/define-sig-form.html b/clones/docs.racket-lang.org/reference/define-sig-form.html
new file mode 100644
index 00000000..9a5f9cd4
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/define-sig-form.html
@@ -0,0 +1,16 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7.7&nbsp;Extending the Syntax of Signatures</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="creatingunits.html" class="tocviewlink" data-pltdoc="x">Creating Units</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="invokingunits.html" class="tocviewlink" data-pltdoc="x">Invoking Units</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="compoundunits.html" class="tocviewlink" data-pltdoc="x">Linking Units and Creating Compound Units</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="linkinference.html" class="tocviewlink" data-pltdoc="x">Inferred Linking</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="Generating_A_Unit_from_Context.html" class="tocviewlink" data-pltdoc="x">Generating A Unit from Context</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="Structural_Matching.html" class="tocviewlink" data-pltdoc="x">Structural Matching</a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="define-sig-form.html" class="tocviewselflink" data-pltdoc="x">Extending the Syntax of Signatures</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Unit_Utilities.html" class="tocviewlink" data-pltdoc="x">Unit Utilities</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="unitcontracts.html" class="tocviewlink" data-pltdoc="x">Unit Contracts</a></td></tr><tr><td align="right">7.10&nbsp;</td><td><a href="single-unit.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Unit Modules</a></td></tr><tr><td align="right">7.11&nbsp;</td><td><a href="Single-Signature_Modules.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Signature Modules</a></td></tr><tr><td align="right">7.12&nbsp;</td><td><a href="Transformer_Helpers.html" class="tocviewlink" data-pltdoc="x">Transformer Helpers</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="define-sig-form.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature-form%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>signature-<wbr></wbr>form</span></span></a></td></tr><tr><td><a href="define-sig-form.html#%28form._%28%28lib._racket%2Funit..rkt%29._struct%2Fctc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct/<span class="mywbr"> &nbsp;</span>ctc</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Structural_Matching.html" title="backward to &quot;7.6 Structural Matching&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Unit_Utilities.html" title="forward to &quot;7.8 Unit Utilities&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;define-sig-form&quot;">7.7<tt>&nbsp;</tt><a name="(part._define-sig-form)"></a>Extending the Syntax of Signatures</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._define-signature-form))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="define-sig-form.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature-form%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-signature-form</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sig-form-id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-sig-form.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature-form%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-signature-form</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">sig-form-id</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-sig-form.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature-form%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-signature-form</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">sig-form-id</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">intro-id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Binds <span class="RktVar">sig-form-id</span> for use within a <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature%29%29" class="RktStxLink" data-pltdoc="x">define-signature</a></span>
+form.</div></p><p>In the first form, the result of <span class="RktVar">expr</span> must be a transformer
+procedure that accepts one argument.  In the second form, <span class="RktVar">sig-form-id</span> is bound to a
+transformer procedure whose argument is <span class="RktVar">id</span> and whose body is
+the <span class="RktVar">body</span>s. The third form is like the second one, but
+<span class="RktVar">intro-id</span> is bound to a procedure that is analogous to <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-introduce%29%29" class="RktValLink" data-pltdoc="x">syntax-local-introduce</a></span>
+for the signature-form expansion.</p><p>The result of the transformer procedure must be a list of
+syntax objects, which are substituted for a use of
+<span class="RktVar">sig-form-id</span> in a <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature%29%29" class="RktStxLink" data-pltdoc="x">define-signature</a></span> expansion. (The
+result is a list so that the transformer can produce multiple
+declarations; <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature%29%29" class="RktStxLink" data-pltdoc="x">define-signature</a></span> has no splicing <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span>
+form.)</p><p class="SHistory">Changed in version 8.1.0.7 of package <span class="stt">base</span>: Added support for the form with a transformer
+<span class="RktVar">expr</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._struct/ctc))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="define-sig-form.html#%28form._%28%28lib._racket%2Funit..rkt%29._struct%2Fctc%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">struct/ctc</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">field</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">struct-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">field</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mutable</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">struct-option</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:mutable</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:omit-constructor</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:omit-define-syntaxes</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:omit-define-values</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">For use with <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature%29%29" class="RktStxLink" data-pltdoc="x">define-signature</a></span>. The <span class="RktSym"><a href="define-sig-form.html#%28form._%28%28lib._racket%2Funit..rkt%29._struct%2Fctc%29%29" class="RktStxLink" data-pltdoc="x">struct/ctc</a></span> form works
+similarly to <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>, but the constructor, predicate, field
+accessors, and field mutators are contracted appropriately.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Structural_Matching.html" title="backward to &quot;7.6 Structural Matching&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Unit_Utilities.html" title="forward to &quot;7.8 Unit Utilities&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/define-struct.html b/clones/docs.racket-lang.org/reference/define-struct.html
new file mode 100644
index 00000000..ecb9878e
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/define-struct.html
@@ -0,0 +1,146 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>5.1&nbsp;Defining Structure Types: struct</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewselflink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">5.1&nbsp;</td><td><a href="define-struct.html" class="tocviewselflink" data-pltdoc="x">Defining Structure Types:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">struct</span></span></a></td></tr><tr><td align="right">5.2&nbsp;</td><td><a href="creatingmorestructs.html" class="tocviewlink" data-pltdoc="x">Creating Structure Types</a></td></tr><tr><td align="right">5.3&nbsp;</td><td><a href="structprops.html" class="tocviewlink" data-pltdoc="x">Structure Type Properties</a></td></tr><tr><td align="right">5.4&nbsp;</td><td><a href="struct-generics.html" class="tocviewlink" data-pltdoc="x">Generic Interfaces</a></td></tr><tr><td align="right">5.5&nbsp;</td><td><a href="struct-copy.html" class="tocviewlink" data-pltdoc="x">Copying and Updating Structures</a></td></tr><tr><td align="right">5.6&nbsp;</td><td><a href="structutils.html" class="tocviewlink" data-pltdoc="x">Structure Utilities</a></td></tr><tr><td align="right">5.7&nbsp;</td><td><a href="structinfo.html" class="tocviewlink" data-pltdoc="x">Structure Type Transformer Binding</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct</span></span></a></td></tr><tr><td><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-field-index%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct-<wbr></wbr>field-<wbr></wbr>index</span></span></a></td></tr><tr><td><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-struct%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>struct</span></span></a></td></tr><tr><td><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%2Fderived%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct/<span class="mywbr"> &nbsp;</span>derived</span></span></a></td></tr><tr><td><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-struct%2Fderived%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>struct/<span class="mywbr"> &nbsp;</span>derived</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="structures.html" title="backward to &quot;5 Structures&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="structures.html" title="up to &quot;5 Structures&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="creatingmorestructs.html" title="forward to &quot;5.2 Creating Structure Types&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;define-struct&quot;">5.1<tt>&nbsp;</tt><a name="(part._define-struct)"></a>Defining Structure Types: <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=define-struct.html&amp;version=8.6" class="Sq" data-pltdoc="x">Programmer-Defined Datatypes</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._struct))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">struct</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-super</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">field</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">struct-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">maybe-super</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">super-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">field</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">field-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">field-id</span><span class="hspace">&nbsp;</span><span class="RktVar">field-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">struct-option</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:mutable</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:super</span><span class="hspace">&nbsp;</span><span class="RktVar">super-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:inspector</span><span class="hspace">&nbsp;</span><span class="RktVar">inspector-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:auto-value</span><span class="hspace">&nbsp;</span><span class="RktVar">auto-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:guard</span><span class="hspace">&nbsp;</span><span class="RktVar">guard-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:property</span><span class="hspace">&nbsp;</span><span class="RktVar">prop-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">val-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:transparent</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:prefab</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:sealed</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:authentic</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:name</span><span class="hspace">&nbsp;</span><span class="RktVar">name-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:extra-name</span><span class="hspace">&nbsp;</span><span class="RktVar">name-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:constructor-name</span><span class="hspace">&nbsp;</span><span class="RktVar">constructor-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktVar">constructor-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:reflection-name</span><span class="hspace">&nbsp;</span><span class="RktVar">symbol-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktVar">gen:name-id</span><span class="hspace">&nbsp;</span><span class="RktVar">method-defs</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:omit-define-syntaxes</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:omit-define-values</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">field-option</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:mutable</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:auto</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">method-defs</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">definition</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new <a href="structures.html#%28tech._structure._type%29" data-pltdoc="x">structure type</a> (or uses a pre-existing
+structure type if <span class="RktPn">#:prefab</span> is specified), and binds
+transformers and variables related to the <a href="structures.html#%28tech._structure._type%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type</span></a>.</div></p><p>A <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> form with <span style="font-style: italic">n</span> <span class="RktVar">field</span>s defines up
+to <span style="font-style: italic"></span>4<span style="font-style: italic">+</span>2<span style="font-style: italic">n</span> names:</p><ul><li><p><span class="RktSym">struct:</span><span class="RktVar">id</span>, a <a name="(tech._structure._type._descriptor)"></a><span style="font-style: italic">structure type
+descriptor</span> value that represents the <a href="structures.html#%28tech._structure._type%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type</span></a>.</p></li><li><p><span class="RktVar">constructor-id</span> (which defaults to <span class="RktVar">id</span>), a
+<a name="(tech._constructor)"></a><span style="font-style: italic">constructor</span> procedure that takes <span style="font-style: italic">m</span> arguments
+and returns a new instance of the <a href="structures.html#%28tech._structure._type%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type</span></a>, where
+<span style="font-style: italic">m</span> is the number of <span class="RktVar">field</span>s that do not include
+an <span class="RktPn">#:auto</span> option.</p></li><li><p><span class="RktVar">name-id</span> (which defaults to <span class="RktVar">id</span>),
+a <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding that encapsulates
+information about the structure type declaration. This binding
+is used to define subtypes, and it also works with the
+<span class="RktSym"><a href="shared.html#%28form._%28%28lib._racket%2Fshared..rkt%29._shared%29%29" class="RktStxLink" data-pltdoc="x">shared</a></span> and <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span> forms. For detailed
+information about the binding of <span class="RktVar">name-id</span>, see
+<a href="structinfo.html" data-pltdoc="x">Structure Type Transformer Binding</a>.</p><p>The <span class="RktVar">constructor-id</span> and <span class="RktVar">name-id</span> can be the same, in
+which case <span class="RktVar">name-id</span> performs both roles. In that case, the
+expansion of <span class="RktVar">name-id</span> as an expression produces an otherwise
+inaccessible identifier that is bound to the constructor
+procedure; the expanded identifier has a
+<span class="RktVal">'</span><span class="RktVal">constructor-for</span> property whose value is an identifier
+that is <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span> to <span class="RktVar">name-id</span> as well as
+a syntax property accessible via
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fkeyword-transform..rkt%29._syntax-procedure-alias-property%29%29" class="RktValLink" data-pltdoc="x">syntax-procedure-alias-property</a></span> with an identifier
+that is <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span> to <span class="RktVar">name-id</span>.</p></li><li><p><span class="RktVar">id</span><span class="RktSym">?</span>, a <a name="(tech._predicate)"></a><span style="font-style: italic">predicate</span> procedure
+that returns <span class="RktVal">#t</span> for instances of the <a href="structures.html#%28tech._structure._type%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure
+type</span></a> (constructed by <span class="RktVar">constructor-id</span> or the
+<a href="define-struct.html#%28tech._constructor%29" class="techoutside" data-pltdoc="x"><span class="techinside">constructor</span></a> for a subtype) and <span class="RktVal">#f</span> for any other
+value.</p></li><li><p><span class="RktVar">id</span><span class="RktSym">-</span><span class="RktVar">field-id</span>, for each
+<span class="RktVar">field</span>; an <a name="(tech._accessor)"></a><span style="font-style: italic">accessor</span> procedure that takes an
+instance of the <a href="structures.html#%28tech._structure._type%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type</span></a> and extracts the value
+for the corresponding field.</p></li><li><p><span class="RktSym">set-</span><span class="RktVar">id</span><span class="RktSym">-</span><span class="RktVar">field-id</span><span class="RktSym">!</span>,
+for each <span class="RktVar">field</span> that includes a
+<span class="RktPn">#:mutable</span> option, or when the
+<span class="RktPn">#:mutable</span> option is specified as a
+<span class="RktVar">struct-option</span>; a <a name="(tech._mutator)"></a><span style="font-style: italic">mutator</span> procedure that
+takes an instance of the <a href="structures.html#%28tech._structure._type%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type</span></a> and a new field
+value. The structure is destructively updated with the new
+value, and <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a> is returned.</p></li></ul><p>If <span class="RktVar">super-id</span> is provided, it must have a transformer binding
+of the same sort bound to <span class="RktVar">name-id</span> (see <a href="structinfo.html" data-pltdoc="x">Structure Type Transformer Binding</a>),
+and it specifies a supertype for the structure type. Alternately,
+the <span class="RktPn">#:super</span> option can be used to specify an expression that
+must produce a <a href="define-struct.html#%28tech._structure._type._descriptor%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type descriptor</span></a>. See
+<a href="structures.html" data-pltdoc="x">Structures</a> for more information on structure subtypes
+and supertypes. If both <span class="RktVar">super-id</span> and <span class="RktPn">#:super</span> are
+provided, a syntax error is reported.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">document</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">author</span><span class="hspace">&nbsp;</span><span class="RktSym">title</span><span class="hspace">&nbsp;</span><span class="RktSym">content</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktSym">document</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">publisher</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">paper</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">journal</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:super</span><span class="hspace">&nbsp;</span><span class="RktSym">struct:document</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p>If the <span class="RktPn">#:mutable</span> option is specified for an individual
+field, then the field can be mutated in instances of the structure
+type, and a <a href="define-struct.html#%28tech._mutator%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutator</span></a> procedure is bound. Supplying
+<span class="RktPn">#:mutable</span> as a <span class="RktVar">struct-option</span> is the same as
+supplying it for all <span class="RktVar">field</span>s. If <span class="RktPn">#:mutable</span> is
+specified as both a <span class="RktVar">field-option</span> and <span class="RktVar">struct-option</span>,
+a syntax error is reported.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cell</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">content</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mutable</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a-cell</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">cell</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">set-cell-content!</span><span class="hspace">&nbsp;</span><span class="RktSym">a-cell</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p>The <span class="RktPn">#:inspector</span>, <span class="RktPn">#:auto-value</span>, and <span class="RktPn">#:guard</span>
+options specify an inspector, value for automatic fields, and guard
+procedure, respectively. See <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span> for more
+information on these attributes of a structure type.  The
+<span class="RktPn">#:property</span> option, which can be supplied
+multiple times, attaches a property value to the structure type; see
+<a href="structprops.html" data-pltdoc="x">Structure Type Properties</a> for more information on properties. The
+<span class="RktPn">#:transparent</span> option is a shorthand for <span class="RktPn">#:inspector</span><span class="stt"> </span><span class="RktVal">#f</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:inspector</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(point 3 5)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">celsius</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">temp</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:guard</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">temp</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._unless%29%29" class="RktStxLink" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">temp</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e~3d%29%29" class="RktValLink" data-pltdoc="x">&gt;=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">temp</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-2</span>73.15</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"not a valid temperature"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">temp</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">celsius</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-2</span>75</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">not a valid temperature</span></p></td></tr></table></blockquote></div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Use the <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="RktValLink" data-pltdoc="x">prop:procedure</a></span> property to implement an
+<a name="(idx._(gentag._194._(lib._scribblings/reference/reference..scrbl)))"></a>applicable structure, use <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._prop~3aevt%29%29" class="RktValLink" data-pltdoc="x">prop:evt</a></span> to create a
+structure type whose instances are <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable events</span></a>, and
+so on. By convention, property names start with <span class="RktSym">prop:</span>.</p></blockquote></blockquote></blockquote><p>The <span class="RktPn">#:prefab</span> option obtains a <a href="structures.html#%28tech._prefab%29" data-pltdoc="x">prefab</a> (pre-defined,
+globally shared) structure type, as opposed to creating a new
+structure type. Such a structure type is inherently transparent and
+non-sealed, and it cannot have a guard or properties, so using <span class="RktPn">#:prefab</span> with
+<span class="RktPn">#:transparent</span>, <span class="RktPn">#:inspector</span>, <span class="RktPn">#:guard</span>,
+<span class="RktPn">#:property</span>, <span class="RktPn">#:sealed</span>, <span class="RktPn">#:authentic</span>,
+or <span class="RktPn">#:methods</span> is a syntax error.
+If a supertype is specified, it must also be a <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure type.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">prefab-point</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:prefab</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">prefab-point</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#s(prefab-point 1 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">prefab-point?</span><span class="hspace">&nbsp;</span><span class="RktVal">#s</span><span class="RktVal">(</span><span class="RktVal">prefab-point</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktPn">#:sealed</span> option is a shorthand for <span class="RktPn">#:property</span><span class="stt"> </span><span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3asealed%29%29" class="RktValLink" data-pltdoc="x">prop:sealed</a></span><span class="stt"> </span><span class="RktVal">#t</span>, which prevents the structure type from being
+used as the supertype of another structure type. See
+<span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3asealed%29%29" class="RktValLink" data-pltdoc="x">prop:sealed</a></span> for more information.</p><p>The <span class="RktPn">#:authentic</span> option is a shorthand for <span class="RktPn">#:property</span><span class="stt"> </span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._prop~3aauthentic%29%29" class="RktValLink" data-pltdoc="x">prop:authentic</a></span><span class="stt"> </span><span class="RktVal">#t</span>, which prevents instances of the structure type
+from being impersonated (see <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-struct%29%29" class="RktValLink" data-pltdoc="x">impersonate-struct</a></span>), chaperoned
+(see <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-struct%29%29" class="RktValLink" data-pltdoc="x">chaperone-struct</a></span>), or acquiring a non-<a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat
+contract</span></a> (see <span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fstruct-dc..rkt%29._struct%2Fc%29%29" class="RktStxLink" data-pltdoc="x">struct/c</a></span>). See <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._prop~3aauthentic%29%29" class="RktValLink" data-pltdoc="x">prop:authentic</a></span> for
+more information. If a supertype is specified, it must also have the
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._prop~3aauthentic%29%29" class="RktValLink" data-pltdoc="x">prop:authentic</a></span> property.</p><p>If <span class="RktVar">name-id</span> is supplied via <span class="RktPn">#:extra-name</span> and it is
+not <span class="RktVar">id</span>, then both <span class="RktVar">name-id</span> and <span class="RktVar">id</span> are bound
+to information about the structure type. Only one of
+<span class="RktPn">#:extra-name</span> and <span class="RktPn">#:name</span> can be provided within a
+<span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> form, and <span class="RktPn">#:extra-name</span> cannot be combined
+with <span class="RktPn">#:omit-define-syntaxes</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ghost</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">color</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:prefab</span><span class="hspace">&nbsp;</span><span class="RktPn">#:extra-name</span><span class="hspace">&nbsp;</span><span class="RktSym">GHOST</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ghost</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">red</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">blinky</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">GHOST</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'red</span></p></td></tr></table></blockquote></div></p><p>If <span class="RktVar">constructor-id</span> is supplied, then the <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a>
+binding of <span class="RktVar">name-id</span> records <span class="RktVar">constructor-id</span> as the
+constructor binding; as a result, for example, <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-out%29%29" class="RktStxLink" data-pltdoc="x">struct-out</a></span>
+includes <span class="RktVar">constructor-id</span> as an export. If
+<span class="RktVar">constructor-id</span> is supplied via
+<span class="RktPn">#:extra-constructor-name</span> and it is not <span class="RktVar">id</span>, applying
+<span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span> on the constructor produces the symbolic form of
+<span class="RktVar">id</span> rather than <span class="RktVar">constructor-id</span>. If
+<span class="RktVar">constructor-id</span> is supplied via <span class="RktPn">#:constructor-name</span>
+and it is not the same as <span class="RktVar">name-id</span>, then <span class="RktVar">name-id</span> does not serve
+as a constructor, and <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span> on the constructor produces
+the symbolic form of <span class="RktVar">constructor-id</span>. Only one of
+<span class="RktPn">#:extra-constructor-name</span> and <span class="RktPn">#:constructor-name</span>
+can be provided within a <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> form.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">color</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktSym">g</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><span class="nobreak">-c</span>olor</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rectangle</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">w</span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktSym">color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym">rect</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">rectangle</span><span class="hspace">&nbsp;</span><span class="RktVal">13</span><span class="hspace">&nbsp;</span><span class="RktVal">50</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><span class="nobreak">-c</span>olor</span><span class="hspace">&nbsp;</span><span class="RktVal">192</span><span class="hspace">&nbsp;</span><span class="RktVal">157</span><span class="hspace">&nbsp;</span><span class="RktVal">235</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;rectangle&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">rect</span><span class="hspace">&nbsp;</span><span class="RktVal">50</span><span class="hspace">&nbsp;</span><span class="RktVal">37</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><span class="nobreak">-c</span>olor</span><span class="hspace">&nbsp;</span><span class="RktVal">35</span><span class="hspace">&nbsp;</span><span class="RktVal">183</span><span class="hspace">&nbsp;</span><span class="RktVal">252</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;rectangle&gt;</span></p></td></tr></table></blockquote></div></p><p>If <span class="RktPn">#:reflection-name</span><span class="stt"> </span><span class="RktVar">symbol-expr</span> is provided, then
+<span class="RktVar">symbol-expr</span> must produce a symbol that is used to identify
+the structure type in reflective operations such as
+<span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-info%29%29" class="RktValLink" data-pltdoc="x">struct-type-info</a></span>. It corresponds to the first argument of
+<span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span>. Structure printing uses the reflective
+name, as do the various procedures that are bound by <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">circle</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">radius</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:reflection-name</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">&lt;circle&gt;</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">circle</span><span class="hspace">&nbsp;</span><span class="RktVal">15</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;&lt;circle&gt;&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">circle-radius</span><span class="hspace">&nbsp;</span><span class="RktVal">"bad"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">&lt;circle&gt;-radius: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: &lt;circle&gt;?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: "bad"</span></p></td></tr></table></blockquote></div></p><p>If <span class="RktPn">#:methods</span><span class="stt"> </span><span class="RktVar">gen:name-id</span><span class="stt"> </span><span class="RktVar">method-defs</span> is provided (potentially multiple times), then
+<span class="RktVar">gen:name-id</span> must be a transformer binding for the static
+information about a generic interface produced by <span class="RktSym"><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._define-generics%29%29" class="RktStxLink" data-pltdoc="x">define-generics</a></span>.
+The <span class="RktVar">method-defs</span> define the methods of the <span class="RktVar">gen:name-id</span>
+interface. A <span class="RktSym"><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._define%2Fgeneric%29%29" class="RktStxLink" data-pltdoc="x">define/generic</a></span> form or auxiliary definitions
+and expressions may also appear in <span class="RktVar">method-defs</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">constant-stream</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">val</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._gen~3astream%29%29" class="RktValLink" data-pltdoc="x">gen:stream</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-empty~3f%29%29" class="RktValLink" data-pltdoc="x">stream-empty?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream%29%29" class="RktStxLink" data-pltdoc="x">stream</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-first%29%29" class="RktValLink" data-pltdoc="x">stream-first</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream%29%29" class="RktStxLink" data-pltdoc="x">stream</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">constant-stream-val</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream%29%29" class="RktStxLink" data-pltdoc="x">stream</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-rest%29%29" class="RktValLink" data-pltdoc="x">stream-rest</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream%29%29" class="RktStxLink" data-pltdoc="x">stream</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream%29%29" class="RktStxLink" data-pltdoc="x">stream</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-ref%29%29" class="RktValLink" data-pltdoc="x">stream-ref</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">constant-stream</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">forever</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'forever</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-ref%29%29" class="RktValLink" data-pltdoc="x">stream-ref</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">constant-stream</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">forever</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">50</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'forever</span></p></td></tr></table></blockquote></div></p><p>If the <span class="RktPn">#:omit-define-syntaxes</span> option is supplied, then
+<span class="RktVar">name-id</span> (and <span class="RktVar">id</span>, if <span class="RktPn">#:extra-name</span> is specified)
+is not bound as a transformer. If the
+<span class="RktPn">#:omit-define-values</span> option is supplied, then none of the
+usual variables are bound, but <span class="RktVar">id</span> is bound. If both are
+supplied, then the <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> form is equivalent to
+<span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="RktPn">)</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">square</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">side</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:omit-define-syntaxes</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">square</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">fails to match because syntax is omitted</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">square</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">eval:28:0: match: square does not refer to a structure</span></p></td></tr><tr><td><p><span class="RktErr">definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: square</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (struct square x)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ellipse</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">width</span><span class="hspace">&nbsp;</span><span class="RktSym">height</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:omit-define-values</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">ellipse-width</span></td></tr><tr><td><p><span class="RktErr">ellipse-width: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Expressions supplied to <span class="RktPn">#:auto-value</span> are evaluated once and shared
+between every instance of the structure type. In particular, updates to
+a mutable <span class="RktPn">#:auto-value</span> affect all current and future instances.</p></blockquote></blockquote></blockquote></div><div class="SIntrapara">If <span class="RktPn">#:auto</span> is supplied as a <span class="RktVar">field-option</span>, then the
+<a href="define-struct.html#%28tech._constructor%29" class="techoutside" data-pltdoc="x"><span class="techinside">constructor</span></a> procedure for the structure type does not accept an
+argument corresponding to the field. Instead, the structure type&rsquo;s
+automatic value is used for the field, as specified by the
+<span class="RktPn">#:auto-value</span> option, or as defaults to <span class="RktVal">#f</span> when
+<span class="RktPn">#:auto-value</span> is not supplied. The field is mutable (e.g.,
+through reflective operations), but a mutator procedure is bound only
+if <span class="RktPn">#:mutable</span> is specified.</div></p><p>If a <span class="RktVar">field</span> includes the <span class="RktPn">#:auto</span> option, then all
+fields after it must also include <span class="RktPn">#:auto</span>, otherwise a syntax
+error is reported. If any <span class="RktVar">field-option</span> or
+<span class="RktVar">struct-option</span> keyword is repeated, other than
+<span class="RktPn">#:property</span>, a syntax error is reported.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">z</span><span class="hspace">&nbsp;</span><span class="RktPn">#:auto</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mutable</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:auto-value</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(posn 1 2 0)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">posn?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">posn-y</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">posn-z</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">color-posn</span><span class="hspace">&nbsp;</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hue</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mutable</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cp</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">color-posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">"blue"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">color-posn-hue</span><span class="hspace">&nbsp;</span><span class="RktSym">cp</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"blue"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">cp</span></td></tr><tr><td><p><span class="RktRes">(color-posn 1 2 0 ...)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">set-posn-z!</span><span class="hspace">&nbsp;</span><span class="RktSym">cp</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p>For serialization, see <span class="RktSym"><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._define-serializable-struct%29%29" class="RktStxLink" data-pltdoc="x">define-serializable-struct</a></span>.</p><p class="SHistory">Changed in version 6.9.0.4 of package <span class="stt">base</span>: Added <span class="RktPn">#:authentic</span>.<br/>Changed in version 8.0.0.7: Added <span class="RktPn">#:sealed</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._struct-field-index))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-field-index%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">struct-field-index</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">field-id</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">This form can only appear as an expression within a
+<span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> form; normally, it is used with
+<span class="RktPn">#:property</span>, especially for a property like
+<span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="RktValLink" data-pltdoc="x">prop:procedure</a></span>. The result of a <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-field-index%29%29" class="RktStxLink" data-pltdoc="x">struct-field-index</a></span>
+expression is an exact, non-negative integer that corresponds to the
+position within the structure declaration of the field named by
+<span class="RktVar">field-id</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mood-procedure</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">base</span><span class="hspace">&nbsp;</span><span class="RktSym">rating</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:property</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="RktValLink" data-pltdoc="x">prop:procedure</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-field-index%29%29" class="RktStxLink" data-pltdoc="x">struct-field-index</a></span><span class="hspace">&nbsp;</span><span class="RktSym">base</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">happy+</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mood-procedure</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">happy+</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">mood-procedure-rating</span><span class="hspace">&nbsp;</span><span class="RktSym">happy+</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._define-struct))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-struct%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-struct</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id-maybe-super</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">field</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">struct-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">id-maybe-super</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">super-id</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>, except that the syntax for supplying a
+<span class="RktVar">super-id</span> is different, and a <span class="RktVar">constructor-id</span> that
+has a <span class="RktSym">make-</span> prefix on <span class="RktVar">id</span> is implicitly
+supplied via <span class="RktPn">#:extra-constructor-name</span> if neither
+<span class="RktPn">#:extra-constructor-name</span> nor <span class="RktPn">#:constructor-name</span> is
+provided.</div></p><p>This form is provided for backwards compatibility; <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> is
+preferred.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-struct%29%29" class="RktStxLink" data-pltdoc="x">define-struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">z</span><span class="hspace">&nbsp;</span><span class="RktPn">#:auto</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:auto-value</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">make-posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(posn 1 2 0)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">posn?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">posn-y</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._struct/derived))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%2Fderived%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">struct/derived</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">rest-form</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">field</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">struct-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%2Fderived%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">struct/derived</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">rest-form</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">super-id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">field</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">struct-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>, but with an extra <span class="RktPn">(</span><span class="RktVar">id</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">rest-form</span><span class="RktPn">)</span> sub-form that is treated as the overall form for
+syntax-error reporting and otherwise ignored.  The only constraint on
+the sub-form for error reporting is that it starts with <span class="RktVar">id</span>.
+The <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%2Fderived%29%29" class="RktStxLink" data-pltdoc="x">struct/derived</a></span> form is intended for use by macros
+that expand to <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>.</div></p><p><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fruit-struct</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">ds</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._with-syntax%29%29" class="RktStxLink" data-pltdoc="x">with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">orig</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%2Fderived%29%29" class="RktStxLink" data-pltdoc="x">struct/derived</a></span><span class="hspace">&nbsp;</span><span class="RktSym">orig</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">seeds</span><span class="hspace">&nbsp;</span><span class="RktSym">color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">fruit-struct</span><span class="hspace">&nbsp;</span><span class="RktSym">apple</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">apple-seeds</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">apple</span><span class="hspace">&nbsp;</span><span class="RktVal">12</span><span class="hspace">&nbsp;</span><span class="RktVal">"red"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">12</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">fruit-struct</span><span class="hspace">&nbsp;</span><span class="RktSym">apple</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mutable</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">set-apple-seeds!</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">apple</span><span class="hspace">&nbsp;</span><span class="RktVal">12</span><span class="hspace">&nbsp;</span><span class="RktVal">"red"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">this next line will cause an error due to a bad keyword</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">fruit-struct</span><span class="hspace">&nbsp;</span><span class="RktSym">apple</span><span class="hspace">&nbsp;</span><span class="RktPn">#:bad-option</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">eval:54:0: fruit-struct: unrecognized struct-specification</span></p></td></tr><tr><td><p><span class="RktErr">keyword</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: #:bad-option</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (fruit-struct apple #:bad-option)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><p class="SHistory">Added in version 7.5.0.16 of package <span class="stt">base</span>.</p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._define-struct/derived))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-struct%2Fderived%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-struct/derived</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">rest-form</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id-maybe-super</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">field</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">struct-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%2Fderived%29%29" class="RktStxLink" data-pltdoc="x">struct/derived</a></span>, except that the syntax for supplying a
+<span class="RktSym">super-id</span> is different, and a <span class="RktVar">constructor-id</span> that
+has a <span class="RktSym">make-</span> prefix on <span class="RktVar">id</span> is implicitly
+supplied via <span class="RktPn">#:extra-constructor-name</span> if neither
+<span class="RktPn">#:extra-constructor-name</span> nor <span class="RktPn">#:constructor-name</span> is
+provided. The <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-struct%2Fderived%29%29" class="RktStxLink" data-pltdoc="x">define-struct/derived</a></span> form is intended for use by macros
+that expand to <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-struct%29%29" class="RktStxLink" data-pltdoc="x">define-struct</a></span>.</div></p><p><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-xy-struct</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">ds</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._with-syntax%29%29" class="RktStxLink" data-pltdoc="x">with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">orig</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-struct%2Fderived%29%29" class="RktStxLink" data-pltdoc="x">define-struct/derived</a></span><span class="hspace">&nbsp;</span><span class="RktSym">orig</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">define-xy-struct</span><span class="hspace">&nbsp;</span><span class="RktSym">posn</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">posn-x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">define-xy-struct</span><span class="hspace">&nbsp;</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mutable</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">set-posn-x!</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">this next line will cause an error due to a bad keyword</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">define-xy-struct</span><span class="hspace">&nbsp;</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktPn">#:bad-option</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">eval:60:0: define-xy-struct: unrecognized</span></p></td></tr><tr><td><p><span class="RktErr">struct-specification keyword</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: #:bad-option</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (define-xy-struct posn #:bad-option)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><p class="SHistory">Changed in version 7.5.0.16 of package <span class="stt">base</span>: Moved main description to <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%2Fderived%29%29" class="RktStxLink" data-pltdoc="x">struct/derived</a></span>
+and replaced with differences.</p></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="structures.html" title="backward to &quot;5 Structures&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="structures.html" title="up to &quot;5 Structures&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="creatingmorestructs.html" title="forward to &quot;5.2 Creating Structure Types&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/define.html b/clones/docs.racket-lang.org/reference/define.html
new file mode 100644
index 00000000..5aba831e
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/define.html
@@ -0,0 +1,70 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.14&nbsp;Definitions: define, define-syntax, ...</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewselflink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>3.14&nbsp;</td><td><a href="define.html" class="tocviewselflink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.14.1&nbsp;</td><td><a href="define.html#%28part._require-syntax%29" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">require</span></span> Macros</a></td></tr><tr><td align="right">3.14.2&nbsp;</td><td><a href="define.html#%28part._provide-syntax%29" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">provide</span></span> Macros</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define</span></span></a></td></tr><tr><td><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>values</span></span></a></td></tr><tr><td><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntaxes</span></span></a></td></tr><tr><td><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-for-syntax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fdefine..rkt%29._define-values-for-syntax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>values-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><span class="tocsublinknumber">3.14.1<tt>&nbsp;</tt></span><a href="define.html#%28part._require-syntax%29" class="tocsubseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">require</span></span> Macros</a></td></tr><tr><td><a href="define.html#%28form._%28%28lib._racket%2Frequire-syntax..rkt%29._define-require-syntax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>require-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><a href="define.html#%28def._%28%28lib._racket%2Frequire-syntax..rkt%29._syntax-local-require-introduce%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>require-<wbr></wbr>introduce</span></span></a></td></tr><tr><td><span class="tocsublinknumber">3.14.2<tt>&nbsp;</tt></span><a href="define.html#%28part._provide-syntax%29" class="tocsubseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">provide</span></span> Macros</a></td></tr><tr><td><a href="define.html#%28form._%28%28lib._racket%2Fprovide-syntax..rkt%29._define-provide-syntax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>provide-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><a href="define.html#%28def._%28%28lib._racket%2Fprovide-syntax..rkt%29._syntax-local-provide-introduce%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>provide-<wbr></wbr>introduce</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="case.html" title="backward to &quot;3.13 Dispatch: case&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="begin.html" title="forward to &quot;3.15 Sequencing: begin, begin0, and begin-for-syntax&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;define&quot;">3.14<tt>&nbsp;</tt><a name="(part._define)"></a>Definitions: <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span>, <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span>, ...</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=define.html&amp;version=8.6" class="Sq" data-pltdoc="x">Definitions: <span class="RktSym"><span class="RktStxLink">define</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces definitions.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._define))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">head</span><span class="hspace">&nbsp;</span><span class="RktVar">args</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">head</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">head</span><span class="hspace">&nbsp;</span><span class="RktVar">args</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">args</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktPn">.</span><span class="hspace">&nbsp;</span><span class="RktVar">rest-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">arg</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">arg-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">arg-id</span><span class="hspace">&nbsp;</span><span class="RktVar">default-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktVar">arg-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">arg-id</span><span class="hspace">&nbsp;</span><span class="RktVar">default-expr</span><span class="RktPn">]</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The first form <a href="syntax-model.html#%28tech._bind%29" class="techoutside" data-pltdoc="x"><span class="techinside">bind</span></a>s <span class="RktVar">id</span> to the result of
+<span class="RktVar">expr</span>, and the second form <a href="syntax-model.html#%28tech._bind%29" class="techoutside" data-pltdoc="x"><span class="techinside">bind</span></a>s <span class="RktVar">id</span> to a
+procedure. In the second case, the generated procedure is
+<span class="RktPn">(</span><span class="stt">CVT</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">head</span><span class="stt"> </span><span class="RktVar">args</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-patterns.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._......%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...+</a></span><span class="RktPn">)</span>, using the <span class="stt">CVT</span> meta-function
+defined as follows:</div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="stt">CVT</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">kw-formals</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">datum</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktVar">kw-formals</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">datum</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="stt">CVT</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">head</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">kw-formals</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">datum</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktVar">kw-formals</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>if<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="stt">CVT</span><span class="hspace">&nbsp;</span><span class="RktVar">head</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">datum</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span></td></tr></table></blockquote><p>In an <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a>, a <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span> form
+introduces a local binding; see <a href="syntax-model.html#%28part._intdef-body%29" data-pltdoc="x">Internal Definitions</a>.
+At the top level, the top-level binding for <span class="RktVar">id</span> is created after
+evaluating <span class="RktVar">expr</span>, if it does not exist already, and the
+top-level mapping of <span class="RktVar">id</span> (in the <a href="syntax-model.html#%28tech._namespace%29" data-pltdoc="x">namespace</a> linked
+with the compiled definition) is set to the binding at the same time.</p><p>In a context that allows <a href="stxtrans.html#%28tech._liberal._expansion%29" class="techoutside" data-pltdoc="x"><span class="techinside">liberal expansion</span></a> of <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span>,
+<span class="RktVar">id</span> is bound as syntax if <span class="RktVar">expr</span> is an immediate
+<span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span> form with keyword arguments or <span class="RktVar">args</span> include
+keyword arguments.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">x</span></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">11</span></p></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">30</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">40</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">30</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._define-values))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-values</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Evaluates the <span class="RktVar">expr</span>, and <a href="syntax-model.html#%28tech._bind%29" class="techoutside" data-pltdoc="x"><span class="techinside">bind</span></a>s the results to the
+<span class="RktVar">id</span>s, in order, if the number of results matches the number of
+<span class="RktVar">id</span>s; if <span class="RktVar">expr</span> produces a different number of results,
+the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p>In an <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a> (see <a href="syntax-model.html#%28part._intdef-body%29" data-pltdoc="x">Internal Definitions</a>),
+a <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span> form introduces local bindings.
+At the top level, the top-level binding for each <span class="RktVar">id</span> is
+created after evaluating <span class="RktVar">expr</span>, if it does not exist already,
+and the top-level mapping of each <span class="RktVar">id</span> (in the
+<a href="syntax-model.html#%28tech._namespace%29" data-pltdoc="x">namespace</a> linked with the compiled definition) is set to
+the binding at the same time.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">z</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></blockquote></div></p><p>If a <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span> form for a function definition in a module
+body has a <a name="(idx._(gentag._109._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">compiler-hint:cross-module-inline</span>
+<a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax property</span></a> with a true value, then the Racket treats the
+property as a performance hint.  See
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=performance.html%23%2528part._func-call-performance%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Function-Call Optimizations</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> for more
+information, and see also <span class="RktSym"><a href="performance-hint.html#%28form._%28%28lib._racket%2Fperformance-hint..rkt%29._begin-encourage-inline%29%29" class="RktStxLink" data-pltdoc="x">begin-encourage-inline</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._define-syntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">head</span><span class="hspace">&nbsp;</span><span class="RktVar">args</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">The first form creates a <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding (see
+<a href="syntax-model.html#%28part._transformer-model%29" data-pltdoc="x">Transformer Bindings</a>) of <span class="RktVar">id</span> with the value of
+<span class="RktVar">expr</span>, which is an expression at <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 1 relative
+to the surrounding context. (See <a href="syntax-model.html#%28part._id-model%29" data-pltdoc="x">Identifiers, Binding, and Scopes</a> for information
+on <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase levels</span></a>.)  Evaluation of <span class="RktVar">expr</span> side is
+<span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>d to set <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span> as in
+<span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntax%29%29" class="RktStxLink" data-pltdoc="x">let-syntax</a></span>.</div></p><p>The second form is a shorthand the same as for <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span>; it
+expands to a definition of the first form where the <span class="RktVar">expr</span> is a
+<span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span> form.</p><p>In an <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a> (see <a href="syntax-model.html#%28part._intdef-body%29" data-pltdoc="x">Internal Definitions</a>),
+a <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span> form introduces a local binding.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">foo</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="RktStxLink" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">foo</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">(1 2 3 4)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bar</span><span class="hspace">&nbsp;</span><span class="RktSym">syntax-object</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">syntax-object</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">bar</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">(1 2 3 4)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._define-syntaxes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-syntaxes</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span>, but creates a <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding
+for each <span class="RktVar">id</span>.  The <span class="RktVar">expr</span> should produce as many values
+as <span class="RktVar">id</span>s, and each value is bound to the corresponding
+<span class="RktVar">id</span>.</div></p><p>When <span class="RktVar">expr</span> produces zero values for a top-level
+<span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span> (i.e., not in a module or internal-definition
+position), then the <span class="RktVar">id</span>s are effectively declared without
+binding; see <a href="syntax-model.html#%28part._macro-introduced-bindings%29" data-pltdoc="x">Macro-Introduced Bindings</a>.</p><p>In an <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a> (see <a href="syntax-model.html#%28part._intdef-body%29" data-pltdoc="x">Internal Definitions</a>),
+a <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span> form introduces local bindings.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">foo1</span><span class="hspace">&nbsp;</span><span class="RktSym">foo2</span><span class="hspace">&nbsp;</span><span class="RktSym">foo3</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">transformer1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">syntax-object</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">syntax-object</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">1</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">transformer2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">syntax-object</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">syntax-object</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">2</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">transformer3</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">syntax-object</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">syntax-object</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">3</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">transformer1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">transformer2</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">transformer3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">foo1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">foo2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">foo3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._define-for-syntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-for-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-for-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-for-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">head</span><span class="hspace">&nbsp;</span><span class="RktVar">args</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span>, except that the binding is at <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>
+1 instead of <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 0 relative to its context. The
+expression for the binding is also at <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 1. (See
+<a href="syntax-model.html#%28part._id-model%29" data-pltdoc="x">Identifiers, Binding, and Scopes</a> for information on <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase levels</span></a>.)  The form
+is a shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span><span class="RktPn">)</span> or
+<span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">head</span><span class="stt"> </span><span class="RktVar">args</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-patterns.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._......%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...+</a></span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p>Within a module, bindings introduced by <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-for-syntax</a></span>
+must appear before their uses or in the same
+<span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-for-syntax</a></span> form (i.e., the <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-for-syntax</a></span>
+form must be expanded before the use is expanded). In particular,
+mutually recursive functions bound by <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-for-syntax</a></span> must
+be defined by the same <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-for-syntax</a></span> form.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">helper</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-two</span><span class="hspace">&nbsp;</span><span class="RktSym">syntax-object</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"helper is ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">helper</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">make-two</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">helper is 2</span></p></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">&lsquo;</span><span class="RktCmt">helper</span><span class="RktCmt">'</span><span class="RktCmt"> is not bound in the runtime phase</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">helper</span></td></tr><tr><td><p><span class="RktErr">helper: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">filter-ids</span><span class="hspace">&nbsp;</span><span class="RktSym">ids</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._filter%29%29" class="RktValLink" data-pltdoc="x">filter</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ids</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show-variables</span><span class="hspace">&nbsp;</span><span class="RktSym">syntax-object</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">syntax-object</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._with-syntax%29%29" class="RktStxLink" data-pltdoc="x">with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">only-ids</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">filter-ids</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3elist%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">only-ids</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show-variables</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(1 2 3)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/define..rkt)._define-values-for-syntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fdefine..rkt%29._define-values-for-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-values-for-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-for-syntax</a></span>, but <span class="RktVar">expr</span> must produce as
+many values as supplied <span class="RktVar">id</span>s, and all of the <span class="RktVar">id</span>s are
+bound (at <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 1).</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fdefine..rkt%29._define-values-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-values-for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">foo1</span><span class="hspace">&nbsp;</span><span class="RktSym">foo2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bar</span><span class="hspace">&nbsp;</span><span class="RktSym">syntax-object</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"foo1 is ~a foo2 is ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">foo1</span><span class="hspace">&nbsp;</span><span class="RktSym">foo2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">bar</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">foo1 is 1 foo2 is 2</span></p></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;require-syntax&quot;">3.14.1<tt>&nbsp;</tt><a name="(part._require-syntax)"></a><a name="(mod-path._racket/require-syntax)"></a><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> Macros</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="define.html#%28mod-path._racket%2Frequire-syntax%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/require-syntax</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="define.html#%28mod-path._racket%2Frequire-syntax%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/require-syntax</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/require-syntax..rkt)._define-require-syntax))"></a><span title="Provided from: racket/require-syntax | Package: base"><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Frequire-syntax..rkt%29._define-require-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-require-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">proc-expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Frequire-syntax..rkt%29._define-require-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-require-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">args</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">The first form is like <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span>, but for a
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> sub-form. The <span class="RktVar">proc-expr</span> must produce a
+procedure that accepts and returns a syntax object representing a
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> sub-form.</div></p><p>This form expands to <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span> with a use of
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._make-require-transformer%29%29" class="RktValLink" data-pltdoc="x">make-require-transformer</a></span> (see <a href="stxtrans.html#%28part._require-trans%29" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">require</span></span> Transformers</a> for
+more information).</p><p>The second form is a shorthand the same as for <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span>; it
+expands to a definition of the first form where the <span class="RktVar">proc-expr</span> is a
+<span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span> form.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/require-syntax..rkt)._syntax-local-require-introduce))"></a><span title="Provided from: racket/require-syntax | Package: base"><span class="RktSym"><a href="define.html#%28def._%28%28lib._racket%2Frequire-syntax..rkt%29._syntax-local-require-introduce%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-require-introduce</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">For backward compatibility only; equivalent to <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-introduce%29%29" class="RktValLink" data-pltdoc="x">syntax-local-introduce</a></span>.</div></p><p class="SHistory">Changed in version 6.90.0.29 of package <span class="stt">base</span>: Made equivalent to <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-introduce%29%29" class="RktValLink" data-pltdoc="x">syntax-local-introduce</a></span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;provide-syntax&quot;">3.14.2<tt>&nbsp;</tt><a name="(part._provide-syntax)"></a><a name="(mod-path._racket/provide-syntax)"></a><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> Macros</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="define.html#%28mod-path._racket%2Fprovide-syntax%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/provide-syntax</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="define.html#%28mod-path._racket%2Fprovide-syntax%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/provide-syntax</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/provide-syntax..rkt)._define-provide-syntax))"></a><span title="Provided from: racket/provide-syntax | Package: base"><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprovide-syntax..rkt%29._define-provide-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-provide-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">proc-expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprovide-syntax..rkt%29._define-provide-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-provide-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">args</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">The first form is like <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span>, but for a
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> sub-form. The <span class="RktVar">proc-expr</span> must produce a
+procedure that accepts and returns a syntax object representing a
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> sub-form.</div></p><p>This form expands to <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span> with a use of
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._make-provide-transformer%29%29" class="RktValLink" data-pltdoc="x">make-provide-transformer</a></span> (see <a href="stxtrans.html#%28part._provide-trans%29" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">provide</span></span> Transformers</a> for
+more information).</p><p>The second form is a shorthand the same as for <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span>; it
+expands to a definition of the first form where the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Library_Syntax_Classes_and_Literal_Sets.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._expr%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">expr</a></span> is a
+<span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span> form.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/provide-syntax..rkt)._syntax-local-provide-introduce))"></a><span title="Provided from: racket/provide-syntax | Package: base"><span class="RktSym"><a href="define.html#%28def._%28%28lib._racket%2Fprovide-syntax..rkt%29._syntax-local-provide-introduce%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-provide-introduce</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">For backward compatibility only; equivalent to <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-introduce%29%29" class="RktValLink" data-pltdoc="x">syntax-local-introduce</a></span>.</div></p><p class="SHistory">Changed in version 6.90.0.29 of package <span class="stt">base</span>: Made equivalent to <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-introduce%29%29" class="RktValLink" data-pltdoc="x">syntax-local-introduce</a></span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="case.html" title="backward to &quot;3.13 Dispatch: case&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="begin.html" title="forward to &quot;3.15 Sequencing: begin, begin0, and begin-for-syntax&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/dicts.html b/clones/docs.racket-lang.org/reference/dicts.html
new file mode 100644
index 00000000..6b71b25e
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/dicts.html
@@ -0,0 +1,202 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.17&nbsp;Dictionaries</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewselflink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.17&nbsp;</td><td><a href="dicts.html" class="tocviewselflink" data-pltdoc="x">Dictionaries</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.17.1&nbsp;</td><td><a href="dicts.html#%28part._.Dictionary_.Predicates_and_.Contracts%29" class="tocviewlink" data-pltdoc="x">Dictionary Predicates and Contracts</a></td></tr><tr><td align="right">4.17.2&nbsp;</td><td><a href="dicts.html#%28part._.Generic_.Dictionary_.Interface%29" class="tocviewlink" data-pltdoc="x">Generic Dictionary Interface</a></td></tr><tr><td align="right">4.17.3&nbsp;</td><td><a href="dicts.html#%28part._.Dictionary_.Sequences%29" class="tocviewlink" data-pltdoc="x">Dictionary Sequences</a></td></tr><tr><td align="right">4.17.4&nbsp;</td><td><a href="dicts.html#%28part._.Contracted_.Dictionaries%29" class="tocviewlink" data-pltdoc="x">Contracted Dictionaries</a></td></tr><tr><td align="right">4.17.5&nbsp;</td><td><a href="dicts.html#%28part._.Custom_.Hash_.Tables%29" class="tocviewlink" data-pltdoc="x">Custom Hash Tables</a></td></tr><tr><td align="right">4.17.6&nbsp;</td><td><a href="dicts.html#%28part._.Passing_keyword_arguments_in_dictionaries%29" class="tocviewlink" data-pltdoc="x">Passing keyword arguments in dictionaries</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">4.17.1<tt>&nbsp;</tt></span><a href="dicts.html#%28part._.Dictionary_.Predicates_and_.Contracts%29" class="tocsubseclink" data-pltdoc="x">Dictionary Predicates and Contracts</a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict?</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-implements~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>implements?</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-implements%2Fc%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>implements/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-mutable~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>mutable?</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-can-remove-keys~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>can-<wbr></wbr>remove-<wbr></wbr>keys?</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-can-functional-set~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>can-<wbr></wbr>functional-<wbr></wbr>set?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.17.2<tt>&nbsp;</tt></span><a href="dicts.html#%28part._.Generic_.Dictionary_.Interface%29" class="tocsubseclink" data-pltdoc="x">Generic Dictionary Interface</a></td></tr><tr><td><a href="dicts.html#%28form._%28%28lib._racket%2Fdict..rkt%29._gen~3adict%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">gen:<span class="mywbr"> &nbsp;</span>dict</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._prop~3adict%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>dict</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.17.2.1<tt>&nbsp;</tt></span><a href="dicts.html#%28part._primitive-dict-methods%29" class="tocsubseclink" data-pltdoc="x">Primitive Dictionary Methods</a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>set</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-remove%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>remove!</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-remove%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>remove</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>iterate-<wbr></wbr>first</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>iterate-<wbr></wbr>next</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-key%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>iterate-<wbr></wbr>key</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-value%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>iterate-<wbr></wbr>value</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.17.2.2<tt>&nbsp;</tt></span><a href="dicts.html#%28part._derived-dict-methods%29" class="tocsubseclink" data-pltdoc="x">Derived Dictionary Methods</a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-has-key~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>has-<wbr></wbr>key?</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%2A%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>set*!</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>set*</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>ref!</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-update%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>update!</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-update%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>update</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-map%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>map</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-map%2Fcopy%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>map/<span class="mywbr"> &nbsp;</span>copy</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-for-each%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>for-<wbr></wbr>each</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-empty~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>empty?</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-count%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>count</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-copy%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>copy</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-clear%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>clear</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-clear%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>clear!</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-keys%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>keys</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-values%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>values</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-~3elist%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>&gt;list</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.17.3<tt>&nbsp;</tt></span><a href="dicts.html#%28part._.Dictionary_.Sequences%29" class="tocsubseclink" data-pltdoc="x">Dictionary Sequences</a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._in-dict%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>dict</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._in-dict-keys%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>dict-<wbr></wbr>keys</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._in-dict-values%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>dict-<wbr></wbr>values</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._in-dict-pairs%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>dict-<wbr></wbr>pairs</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.17.4<tt>&nbsp;</tt></span><a href="dicts.html#%28part._.Contracted_.Dictionaries%29" class="tocsubseclink" data-pltdoc="x">Contracted Dictionaries</a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._prop~3adict%2Fcontract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>dict/<span class="mywbr"> &nbsp;</span>contract</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-key-contract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>key-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-value-contract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>value-<wbr></wbr>contract</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iter-contract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-<wbr></wbr>iter-<wbr></wbr>contract</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.17.5<tt>&nbsp;</tt></span><a href="dicts.html#%28part._.Custom_.Hash_.Tables%29" class="tocsubseclink" data-pltdoc="x">Custom Hash Tables</a></td></tr><tr><td><a href="dicts.html#%28form._%28%28lib._racket%2Fdict..rkt%29._define-custom-hash-types%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>custom-<wbr></wbr>hash-<wbr></wbr>types</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._make-custom-hash-types%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>custom-<wbr></wbr>hash-<wbr></wbr>types</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._make-custom-hash%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>custom-<wbr></wbr>hash</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._make-weak-custom-hash%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>weak-<wbr></wbr>custom-<wbr></wbr>hash</span></span></a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._make-immutable-custom-hash%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>immutable-<wbr></wbr>custom-<wbr></wbr>hash</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.17.6<tt>&nbsp;</tt></span><a href="dicts.html#%28part._.Passing_keyword_arguments_in_dictionaries%29" class="tocsubseclink" data-pltdoc="x">Passing keyword arguments in dictionaries</a></td></tr><tr><td><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._keyword-apply%2Fdict%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">keyword-<wbr></wbr>apply/<span class="mywbr"> &nbsp;</span>dict</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Generators.html" title="backward to &quot;4.16.3 Generators&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="sets.html" title="forward to &quot;4.18 Sets&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;dicts&quot;">4.17<tt>&nbsp;</tt><a name="(part._dicts)"></a><a name="(mod-path._racket/dict)"></a>Dictionaries</h4><p>A <a name="(tech._dictionary)"></a><span style="font-style: italic">dictionary</span> is an instance of a datatype that maps keys to
+values. The following datatypes are all dictionaries:</p><ul><li><p><a href="hashtables.html#%28tech._hash._table%29" data-pltdoc="x">hash tables</a>;</p></li><li><p><a href="vectors.html#%28tech._vector%29" data-pltdoc="x">vectors</a> (using only exact integers as keys);</p></li><li><p><a href="pairs.html#%28tech._list%29" data-pltdoc="x">lists</a> of <a href="pairs.html#%28tech._pair%29" data-pltdoc="x">pairs</a> as an <a name="(tech._association._list)"></a><span style="font-style: italic">association
+list</span> using <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to compare keys, which must be distinct; and</p></li><li><p><a href="structures.html#%28tech._structure%29" data-pltdoc="x">structures</a> whose types implement the <span class="RktSym"><a href="dicts.html#%28form._%28%28lib._racket%2Fdict..rkt%29._gen~3adict%29%29" class="RktStxLink" data-pltdoc="x">gen:dict</a></span>
+<a href="struct-generics.html#%28tech._generic._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">generic interface</span></a>.</p></li></ul><p>When list of pairs is used as <a href="dicts.html#%28tech._association._list%29" class="techoutside" data-pltdoc="x"><span class="techinside">association list</span></a> but does not
+have distinct keys (so it&rsquo;s not an association list), operations like
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span> and <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-remove%29%29" class="RktValLink" data-pltdoc="x">dict-remove</a></span> operate on the first
+instance of the key, while operations like <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-map%29%29" class="RktValLink" data-pltdoc="x">dict-map</a></span> and
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-keys%29%29" class="RktValLink" data-pltdoc="x">dict-keys</a></span> produce an element for every instance of the key.</p><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="dicts.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/dict</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="dicts.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/dict</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Dictionary_Predicates_and_Contracts&quot;">4.17.1<tt>&nbsp;</tt><a name="(part._.Dictionary_.Predicates_and_.Contracts)"></a>Dictionary Predicates and Contracts</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict~3f))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="dicts.html#%28tech._dictionary%29" class="techoutside" data-pltdoc="x"><span class="techinside">dictionary</span></a>, <span class="RktVal">#f</span>
+otherwise.</div></p><p>Beware that <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span> is not a constant-time test on pairs, since
+checking that <span class="RktVar">v</span> is an <a href="dicts.html#%28tech._association._list%29" class="techoutside" data-pltdoc="x"><span class="techinside">association list</span></a> may require
+traversing the list.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"apple"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-implements~3f))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-implements~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-implements?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">d</span><span class="hspace">&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">d</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">d</span> implements all of the methods from
+<span class="RktSym"><a href="dicts.html#%28form._%28%28lib._racket%2Fdict..rkt%29._gen~3adict%29%29" class="RktStxLink" data-pltdoc="x">gen:dict</a></span> named by the <span class="RktVar">sym</span>s; returns <span class="RktVal">#f</span> otherwise.
+Fallback implementations do not affect the result; <span class="RktVar">d</span> may support the
+given methods via fallback implementations yet produce <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-implements~3f%29%29" class="RktValLink" data-pltdoc="x">dict-implements?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash%29%29" class="RktValLink" data-pltdoc="x">hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dict-set!</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-implements~3f%29%29" class="RktValLink" data-pltdoc="x">dict-implements?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"apple"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dict-set!</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-implements~3f%29%29" class="RktValLink" data-pltdoc="x">dict-implements?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"apple"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dict-remove!</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-implements~3f%29%29" class="RktValLink" data-pltdoc="x">dict-implements?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dict-set!</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-implements~3f%29%29" class="RktValLink" data-pltdoc="x">dict-implements?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dict-remove!</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-implements~3f%29%29" class="RktValLink" data-pltdoc="x">dict-implements?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dict-set!</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dict-remove!</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-implements/c))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-implements%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-implements/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Recognizes dictionaries that support all of the methods from <span class="RktSym"><a href="dicts.html#%28form._%28%28lib._racket%2Fdict..rkt%29._gen~3adict%29%29" class="RktStxLink" data-pltdoc="x">gen:dict</a></span>
+named by the <span class="RktVar">sym</span>s. Note that the generated contract is not similar to
+<span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fc%29%29" class="RktValLink" data-pltdoc="x">hash/c</a></span>, but closer to <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-implements~3f%29%29" class="RktValLink" data-pltdoc="x">dict-implements?</a></span>.
+</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">deformed-dict</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28form._%28%28lib._racket%2Fdict..rkt%29._gen~3adict%29%29" class="RktStxLink" data-pltdoc="x">gen:dict</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">good-dict</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-implements%2Fc%29%29" class="RktValLink" data-pltdoc="x">dict-implements/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">deformed-dict</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bad-dict</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-implements%2Fc%29%29" class="RktValLink" data-pltdoc="x">dict-implements/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dict-ref</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">deformed-dict</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">bad-dict: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: (dict-implements/c dict-ref)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: #&lt;deformed-dict&gt;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (dict-implements/c dict-ref)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition bad-dict)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition bad-dict)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:14:0</span></p></td></tr></table></blockquote></div></p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-mutable~3f))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-mutable~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-mutable?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">d</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">d</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">d</span> is mutable via <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%21%29%29" class="RktValLink" data-pltdoc="x">dict-set!</a></span>,
+<span class="RktVal">#f</span> otherwise.</div></p><p>Equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-implements~3f%29%29" class="RktValLink" data-pltdoc="x">dict-implements?</a></span><span class="stt"> </span><span class="RktVar">d</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">dict-set!</span><span class="RktPn">)</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-mutable~3f%29%29" class="RktValLink" data-pltdoc="x">dict-mutable?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-mutable~3f%29%29" class="RktValLink" data-pltdoc="x">dict-mutable?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-mutable~3f%29%29" class="RktValLink" data-pltdoc="x">dict-mutable?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-mutable~3f%29%29" class="RktValLink" data-pltdoc="x">dict-mutable?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-mutable~3f%29%29" class="RktValLink" data-pltdoc="x">dict-mutable?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"apple"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-can-remove-keys~3f))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-can-remove-keys~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-can-remove-keys?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">d</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">d</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">d</span> supports removing mappings via
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-remove%21%29%29" class="RktValLink" data-pltdoc="x">dict-remove!</a></span> and/or <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-remove%29%29" class="RktValLink" data-pltdoc="x">dict-remove</a></span>, <span class="RktVal">#f</span>
+otherwise.</div></p><p>Equivalent to
+<span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-implements~3f%29%29" class="RktValLink" data-pltdoc="x">dict-implements?</a></span><span class="stt"> </span><span class="RktVar">d</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">dict-remove!</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-implements~3f%29%29" class="RktValLink" data-pltdoc="x">dict-implements?</a></span><span class="stt"> </span><span class="RktVar">d</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">dict-remove</span><span class="RktPn">)</span><span class="RktPn">)</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-can-remove-keys~3f%29%29" class="RktValLink" data-pltdoc="x">dict-can-remove-keys?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-can-remove-keys~3f%29%29" class="RktValLink" data-pltdoc="x">dict-can-remove-keys?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-can-remove-keys~3f%29%29" class="RktValLink" data-pltdoc="x">dict-can-remove-keys?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"apple"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-can-functional-set~3f))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-can-functional-set~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-can-functional-set?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">d</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">d</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">d</span> supports functional update via
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%29%29" class="RktValLink" data-pltdoc="x">dict-set</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p>Equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-implements~3f%29%29" class="RktValLink" data-pltdoc="x">dict-implements?</a></span><span class="stt"> </span><span class="RktVar">d</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">dict-set</span><span class="RktPn">)</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-can-functional-set~3f%29%29" class="RktValLink" data-pltdoc="x">dict-can-functional-set?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-can-functional-set~3f%29%29" class="RktValLink" data-pltdoc="x">dict-can-functional-set?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-can-functional-set~3f%29%29" class="RktValLink" data-pltdoc="x">dict-can-functional-set?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-can-functional-set~3f%29%29" class="RktValLink" data-pltdoc="x">dict-can-functional-set?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"apple"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Generic_Dictionary_Interface&quot;">4.17.2<tt>&nbsp;</tt><a name="(part._.Generic_.Dictionary_.Interface)"></a>Generic Dictionary Interface</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/dict..rkt)._gen~3adict))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28form._%28%28lib._racket%2Fdict..rkt%29._gen~3adict%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">gen:dict</a></span></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="struct-generics.html#%28tech._generic._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">generic interface</span></a> (see <a href="struct-generics.html" data-pltdoc="x">Generic Interfaces</a>) that
+supplies dictionary method implementations for a structure type via the
+<span class="RktPn">#:methods</span> option of <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> definitions.  This interface can
+be used to implement any of the methods documented as
+<a href="dicts.html#%28part._primitive-dict-methods%29" data-pltdoc="x">Primitive Dictionary Methods</a> and <a href="dicts.html#%28part._derived-dict-methods%29" data-pltdoc="x">Derived Dictionary Methods</a>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">alist</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28form._%28%28lib._racket%2Fdict..rkt%29._gen~3adict%29%29" class="RktStxLink" data-pltdoc="x">gen:dict</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dict</span><span class="hspace">&nbsp;</span><span class="RktSym">key</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">default</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"key not found"</span><span class="hspace">&nbsp;</span><span class="RktSym">key</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assoc%29%29" class="RktValLink" data-pltdoc="x">assoc</a></span><span class="hspace">&nbsp;</span><span class="RktSym">key</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">alist-v</span><span class="hspace">&nbsp;</span><span class="RktSym">dict</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">default</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">default</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">default</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%29%29" class="RktValLink" data-pltdoc="x">dict-set</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dict</span><span class="hspace">&nbsp;</span><span class="RktSym">key</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">alist</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">key</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">alist-v</span><span class="hspace">&nbsp;</span><span class="RktSym">dict</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-remove%29%29" class="RktValLink" data-pltdoc="x">dict-remove</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dict</span><span class="hspace">&nbsp;</span><span class="RktSym">key</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">al</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">alist-v</span><span class="hspace">&nbsp;</span><span class="RktSym">dict</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">alist</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remove%2A%29%29" class="RktValLink" data-pltdoc="x">remove*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._filter%29%29" class="RktValLink" data-pltdoc="x">filter</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">key</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">al</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">al</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-count%29%29" class="RktValLink" data-pltdoc="x">dict-count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dict</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._length%29%29" class="RktValLink" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._remove-duplicates%29%29" class="RktValLink" data-pltdoc="x">remove-duplicates</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">alist-v</span><span class="hspace">&nbsp;</span><span class="RktSym">dict</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:key</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">etc. other methods</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">d1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">alist</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">a</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">b</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">d1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">d1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'a</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-remove%29%29" class="RktValLink" data-pltdoc="x">dict-remove</a></span><span class="hspace">&nbsp;</span><span class="RktSym">d1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;alist&gt;</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/dict..rkt)._prop~3adict))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._prop~3adict%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:dict</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A structure type property used to define custom extensions
+to the dictionary API. Using the <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._prop~3adict%29%29" class="RktValLink" data-pltdoc="x">prop:dict</a></span> property is
+discouraged; use the <span class="RktSym"><a href="dicts.html#%28form._%28%28lib._racket%2Fdict..rkt%29._gen~3adict%29%29" class="RktStxLink" data-pltdoc="x">gen:dict</a></span> <a href="struct-generics.html#%28tech._generic._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">generic interface</span></a>
+instead. Accepts a vector of 10 method implementations:</div></p><ul><li><p><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span></p></li><li><p><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%21%29%29" class="RktValLink" data-pltdoc="x">dict-set!</a></span>, or <span class="RktVal">#f</span> if unsupported</p></li><li><p><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%29%29" class="RktValLink" data-pltdoc="x">dict-set</a></span>, or <span class="RktVal">#f</span> if unsupported</p></li><li><p><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-remove%21%29%29" class="RktValLink" data-pltdoc="x">dict-remove!</a></span>, or <span class="RktVal">#f</span> if unsupported</p></li><li><p><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-remove%29%29" class="RktValLink" data-pltdoc="x">dict-remove</a></span>, or <span class="RktVal">#f</span> if unsupported</p></li><li><p><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-count%29%29" class="RktValLink" data-pltdoc="x">dict-count</a></span></p></li><li><p><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span></p></li><li><p><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-next</a></span></p></li><li><p><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-key%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-key</a></span></p></li><li><p><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-value%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-value</a></span></p></li></ul><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;primitive-dict-methods&quot;">4.17.2.1<tt>&nbsp;</tt><a name="(part._primitive-dict-methods)"></a>Primitive Dictionary Methods</h5><p>These methods of <span class="RktSym"><a href="dicts.html#%28form._%28%28lib._racket%2Fdict..rkt%29._gen~3adict%29%29" class="RktStxLink" data-pltdoc="x">gen:dict</a></span> have no fallback implementations; they are
+only supported for dictionary types that directly implement them.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-ref))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">failure-result</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">failure-result</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._failure-result%2Fc%29%29" class="RktValLink" data-pltdoc="x">failure-result/c</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail</a></span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns the value for <span class="RktVar">key</span> in <span class="RktVar">dict</span>. If no value
+is found for <span class="RktVar">key</span>, then <span class="RktVar">failure-result</span> determines the
+result:</div></p><ul><li><p>If <span class="RktVar">failure-result</span> is a procedure, it is called
+(through a tail call) with no arguments to produce the result.</p></li><li><p>Otherwise, <span class="RktVar">failure-result</span> is returned as the result.</p></li></ul><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"beer"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"apple"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"beer"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">hash-ref: no value found for key</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">key: 'c</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"beer"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"apple"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"banana"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"banana"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-3</span></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">dict-ref: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: natural?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: -3</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the k argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt;i</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">((d dict?) (k (d) (dict-key-contract d)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">((default any/c))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">any)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: &lt;collects&gt;/racket/dict.rkt</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: &lt;collects&gt;/racket/dict.rkt:182:2</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-set!))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Maps <span class="RktVar">key</span> to <span class="RktVar">v</span> in <span class="RktVar">dict</span>, overwriting any
+existing mapping for <span class="RktVar">key</span>. The update can fail with a
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception if <span class="RktVar">dict</span> is not mutable
+or if <span class="RktVar">key</span> is not an allowed key for the dictionary (e.g., not
+an exact integer in the appropriate range when <span class="RktVar">dict</span> is a
+<a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vector</span></a>).</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%21%29%29" class="RktValLink" data-pltdoc="x">dict-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">h</span></td></tr><tr><td><p><span class="RktRes">'#hash((a . "apple"))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%21%29%29" class="RktValLink" data-pltdoc="x">dict-set!</a></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVar">v</span></td></tr><tr><td><p><span class="RktRes">'#("apple" #f #f)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-set))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-set</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Functionally extends <span class="RktVar">dict</span> by mapping <span class="RktVar">key</span> to
+<span class="RktVar">v</span>, overwriting any existing mapping for <span class="RktVar">key</span>, and
+returning an extended dictionary. The update can fail with a
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception if <span class="RktVar">dict</span> does not support
+functional extension or if <span class="RktVar">key</span> is not an allowed key for the
+dictionary.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%29%29" class="RktValLink" data-pltdoc="x">dict-set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#hash((a . "apple"))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%29%29" class="RktValLink" data-pltdoc="x">dict-set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"beer"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#hash((a . "apple") (b . "banana"))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%29%29" class="RktValLink" data-pltdoc="x">dict-set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((a . "apple"))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%29%29" class="RktValLink" data-pltdoc="x">dict-set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"apple"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"beer"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((a . "apple") (b . "banana"))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-remove!))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-remove%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-remove!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Removes any existing mapping for <span class="RktVar">key</span> in <span class="RktVar">dict</span>. The
+update can fail if <span class="RktVar">dict</span> is not mutable or does not support
+removing keys (as is the case for <a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vectors</span></a>, for example).</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%21%29%29" class="RktValLink" data-pltdoc="x">dict-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">h</span></td></tr><tr><td><p><span class="RktRes">'#hash((a . "apple"))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-remove%21%29%29" class="RktValLink" data-pltdoc="x">dict-remove!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">h</span></td></tr><tr><td><p><span class="RktRes">'#hash()</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-remove))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-remove%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-remove</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Functionally removes any existing mapping for <span class="RktVar">key</span> in
+<span class="RktVar">dict</span>, returning the fresh dictionary.  The update can fail
+if <span class="RktVar">dict</span> does not support functional update or does not
+support removing keys.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%29%29" class="RktValLink" data-pltdoc="x">dict-set</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">h</span></td></tr><tr><td><p><span class="RktRes">'#hash((a . "apple"))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-remove%29%29" class="RktValLink" data-pltdoc="x">dict-remove</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#hash()</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">h</span></td></tr><tr><td><p><span class="RktRes">'#hash((a . "apple"))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-remove%29%29" class="RktValLink" data-pltdoc="x">dict-remove</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">z</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#hash((a . "apple"))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-remove%29%29" class="RktValLink" data-pltdoc="x">dict-remove</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"apple"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((b . "banana"))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-iterate-first))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-iterate-first</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#f</span> if <span class="RktVar">dict</span> contains no elements, otherwise
+it returns a non-<span class="RktVal">#f</span> value that is an index to the first
+element in the dict table; &ldquo;first&rdquo; refers to an unspecified ordering
+of the dictionary elements. For a mutable <span class="RktVar">dict</span>, this index is
+guaranteed to refer to the first item only as long as no mappings are
+added to or removed from <span class="RktVar">dict</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"banana"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"apple"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;assoc-iter&gt;</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-iterate-next))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-iterate-next</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns either a non-<span class="RktVal">#f</span> that is an index to the element in
+<span class="RktVar">dict</span> after the element indexed by <span class="RktVar">pos</span> or <span class="RktVal">#f</span>
+if <span class="RktVar">pos</span> refers to the last element in <span class="RktVar">dict</span>. If
+<span class="RktVar">pos</span> is not a valid index, then the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. For a mutable <span class="RktVar">dict</span>, the result
+index is guaranteed to refer to its item only as long as no items are
+added to or removed from <span class="RktVar">dict</span>. The <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-next</a></span>
+operation should take constant time.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"banana"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">i</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-next</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-next</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-next</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-iterate-key))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-key%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-iterate-key</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the key for the element in <span class="RktVar">dict</span> at index
+<span class="RktVar">pos</span>. If <span class="RktVar">pos</span> is not a valid index for <span class="RktVar">dict</span>,
+the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. The <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-key%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-key</a></span>
+operation should take constant time.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"apple"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-key%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-key</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'a</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-key%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-key</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-next</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'b</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-iterate-value))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-iterate-value</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the value for the element in <span class="RktVar">dict</span> at index
+<span class="RktVar">pos</span>. If <span class="RktVar">pos</span> is not a valid index for <span class="RktVar">dict</span>,
+the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. The <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-key%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-key</a></span>
+operation should take constant time.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"apple"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-value%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-value</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"apple"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-value%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-value</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-next</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"banana"</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;derived-dict-methods&quot;">4.17.2.2<tt>&nbsp;</tt><a name="(part._derived-dict-methods)"></a>Derived Dictionary Methods</h5><p>These methods of <span class="RktSym"><a href="dicts.html#%28form._%28%28lib._racket%2Fdict..rkt%29._gen~3adict%29%29" class="RktStxLink" data-pltdoc="x">gen:dict</a></span> have fallback implementations in terms of
+the other methods; they may be supported even by dictionary types that do not
+directly implement them.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-has-key~3f))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-has-key~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-has-key?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">dict</span> contains a value for the given
+<span class="RktVar">key</span>, <span class="RktVal">#f</span> otherwise.</div></p><p>Supported for any <span class="RktVar">dict</span> that implements <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-has-key~3f%29%29" class="RktValLink" data-pltdoc="x">dict-has-key?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"beer"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-has-key~3f%29%29" class="RktValLink" data-pltdoc="x">dict-has-key?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"beer"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-has-key~3f%29%29" class="RktValLink" data-pltdoc="x">dict-has-key?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"apple"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-has-key~3f%29%29" class="RktValLink" data-pltdoc="x">dict-has-key?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-has-key~3f%29%29" class="RktValLink" data-pltdoc="x">dict-has-key?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-has-key~3f%29%29" class="RktValLink" data-pltdoc="x">dict-has-key?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-3</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-set*!))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%2A%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-set*!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Maps each <span class="RktVar">key</span> to each <span class="RktVar">v</span> in <span class="RktVar">dict</span>, overwriting any
+existing mapping for each <span class="RktVar">key</span>. The update can fail with a
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception if <span class="RktVar">dict</span> is not mutable
+or if any <span class="RktVar">key</span> is not an allowed key for the dictionary (e.g., not
+an exact integer in the appropriate range when <span class="RktVar">dict</span> is a
+<a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vector</span></a>). The update takes place from the left, so later mappings overwrite
+earlier mappings.</div></p><p>Supported for any <span class="RktVar">dict</span> that implements <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%21%29%29" class="RktValLink" data-pltdoc="x">dict-set!</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%2A%21%29%29" class="RktValLink" data-pltdoc="x">dict-set*!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">h</span></td></tr><tr><td><p><span class="RktRes">'#hash((a . "apple") (b . "banana"))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%2A%21%29%29" class="RktValLink" data-pltdoc="x">dict-set*!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v1</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">v1</span></td></tr><tr><td><p><span class="RktRes">'#("apple" "banana" #f)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%2A%21%29%29" class="RktValLink" data-pltdoc="x">dict-set*!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v2</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">v2</span></td></tr><tr><td><p><span class="RktRes">'#("banana" #f #f)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-set*))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-set*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Functionally extends <span class="RktVar">dict</span> by mapping each <span class="RktVar">key</span> to
+each <span class="RktVar">v</span>, overwriting any existing mapping for each <span class="RktVar">key</span>, and
+returning an extended dictionary. The update can fail with a
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception if <span class="RktVar">dict</span> does not support
+functional extension or if any <span class="RktVar">key</span> is not an allowed key for the
+dictionary. The update takes place from the left, so later mappings overwrite
+earlier mappings.</div></p><p>Supported for any <span class="RktVar">dict</span> that implements <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%29%29" class="RktValLink" data-pltdoc="x">dict-set</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%2A%29%29" class="RktValLink" data-pltdoc="x">dict-set*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">"beer"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#hash((a . "apple") (b . "beer"))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%2A%29%29" class="RktValLink" data-pltdoc="x">dict-set*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"beer"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">"anchor"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#hash((a . "anchor") (b . "banana"))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%2A%29%29" class="RktValLink" data-pltdoc="x">dict-set*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">"beer"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((a . "apple") (b . "beer"))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%2A%29%29" class="RktValLink" data-pltdoc="x">dict-set*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"apple"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"beer"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">"anchor"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((a . "anchor") (b . "banana"))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%2A%29%29" class="RktValLink" data-pltdoc="x">dict-set*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"apple"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"beer"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">"ballistic"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((a . "apple") (b . "ballistic"))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-ref!))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-ref!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">to-set</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">to-set</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the value for <span class="RktVar">key</span> in <span class="RktVar">dict</span>. If no value
+is found for <span class="RktVar">key</span>, then <span class="RktVar">to-set</span> determines the
+result as in <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span> (i.e., it is either a thunk that computes a value
+or a plain value), and this result is stored in <span class="RktVar">dict</span> for the
+<span class="RktVar">key</span>.  (Note that if <span class="RktVar">to-set</span> is a thunk, it is not
+invoked in tail position.)</div></p><p>Supported for any <span class="RktVar">dict</span> that implements <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span> and
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%21%29%29" class="RktValLink" data-pltdoc="x">dict-set!</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%21%29%29" class="RktValLink" data-pltdoc="x">dict-ref!</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hasheq%29%29" class="RktValLink" data-pltdoc="x">make-hasheq</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"apple"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"beer"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"apple"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%21%29%29" class="RktValLink" data-pltdoc="x">dict-ref!</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hasheq%29%29" class="RktValLink" data-pltdoc="x">make-hasheq</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"apple"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"beer"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">cabbage</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'cabbage</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hasheq%29%29" class="RktValLink" data-pltdoc="x">make-hasheq</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"apple"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"beer"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">hash-ref: no value found for key</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">key: 'c</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%21%29%29" class="RktValLink" data-pltdoc="x">dict-ref!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">cabbage</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'cabbage</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'cabbage</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-update!))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-update%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-update!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">dict</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">key</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">updater</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">failure-result</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">updater</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">failure-result</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._failure-result%2Fc%29%29" class="RktValLink" data-pltdoc="x">failure-result/c</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail</a></span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Composes <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span> and <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%21%29%29" class="RktValLink" data-pltdoc="x">dict-set!</a></span> to update an
+existing mapping in <span class="RktVar">dict</span>, where the optional <span class="RktVar">failure-result</span>
+argument is used as in <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span> when no mapping exists for
+<span class="RktVar">key</span> already.</div></p><p>Supported for any <span class="RktVar">dict</span> that implements <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span> and
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%21%29%29" class="RktValLink" data-pltdoc="x">dict-set!</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-update%21%29%29" class="RktValLink" data-pltdoc="x">dict-update!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">hash-update!: no value found for key: 'a</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-update%21%29%29" class="RktValLink" data-pltdoc="x">dict-update!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">h</span></td></tr><tr><td><p><span class="RktRes">'#hash((a . 1))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-update%21%29%29" class="RktValLink" data-pltdoc="x">dict-update!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">v</span></td></tr><tr><td><p><span class="RktRes">'#(#t #f #f)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-update))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-update%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-update</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">updater</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">failure-result</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">updater</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">failure-result</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._failure-result%2Fc%29%29" class="RktValLink" data-pltdoc="x">failure-result/c</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail</a></span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Composes <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span> and <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%29%29" class="RktValLink" data-pltdoc="x">dict-set</a></span> to functionally
+update an existing mapping in <span class="RktVar">dict</span>, where the optional <span class="RktVar">failure-result</span>
+argument is used as in <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span> when no mapping exists for
+<span class="RktVar">key</span> already.</div></p><p>Supported for any <span class="RktVar">dict</span> that implements <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span> and
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%29%29" class="RktValLink" data-pltdoc="x">dict-set</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-update%29%29" class="RktValLink" data-pltdoc="x">dict-update</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">hash-update: no value found for key: 'a</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-update%29%29" class="RktValLink" data-pltdoc="x">dict-update</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#hash((a . 1))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-update%29%29" class="RktValLink" data-pltdoc="x">dict-update</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"beer"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="RktValLink" data-pltdoc="x">string-length</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#hash((a . "apple") (b . 4))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-map))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-map%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-map</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Applies the procedure <span class="RktVar">proc</span> to each element in
+<span class="RktVar">dict</span> in an unspecified order, accumulating the results
+into a list. The procedure <span class="RktVar">proc</span> is called each time with a
+key and its value.</div></p><p>Supported for any <span class="RktVar">dict</span> that implements <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span>,
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-next</a></span>, <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-key%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-key</a></span>, and
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-value%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-value</a></span>.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-map%29%29" class="RktValLink" data-pltdoc="x">dict-map</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"banana"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#(b "banana") #(a "apple"))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-map/copy))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-map%2Fcopy%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-map/copy</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Applies the procedure <span class="RktVar">proc</span> to each element in
+<span class="RktVar">dict</span> in an unspecified order, accumulating the results
+into a dict of the same kind.
+The procedure <span class="RktVar">proc</span> is called each time with a key
+and its value, and must return a corresponding key and
+value.</div></p><p>Supported for any <span class="RktVar">dict</span> that implements
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span>, <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-next</a></span>,
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-key%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-key</a></span>, and <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-value%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-value</a></span>,
+and either <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%29%29" class="RktValLink" data-pltdoc="x">dict-set</a></span> and <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-clear%29%29" class="RktValLink" data-pltdoc="x">dict-clear</a></span>, or
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%21%29%29" class="RktValLink" data-pltdoc="x">dict-set!</a></span>, <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-copy%29%29" class="RktValLink" data-pltdoc="x">dict-copy</a></span>, and
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-clear%21%29%29" class="RktValLink" data-pltdoc="x">dict-clear!</a></span>.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-map%2Fcopy%29%29" class="RktValLink" data-pltdoc="x">dict-map/copy</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"banana"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-upcase%29%29" class="RktValLink" data-pltdoc="x">string-upcase</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#hash((a . "APPLE") (b . "BANANA"))</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 8.5.0.2 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-for-each))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-for-each%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-for-each</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Applies <span class="RktVar">proc</span> to each element in <span class="RktVar">dict</span> (for the
+side-effects of <span class="RktVar">proc</span>) in an unspecified order. The procedure
+<span class="RktVar">proc</span> is called each time with a key and its value.</div></p><p>Supported for any <span class="RktVar">dict</span> that implements <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span>,
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-next</a></span>, <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-key%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-key</a></span>, and
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-value%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-value</a></span>.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-for-each%29%29" class="RktValLink" data-pltdoc="x">dict-for-each</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"banana"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a = ~s\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">b = "banana"</span></p></td></tr><tr><td><p><span class="RktOut">a = "apple"</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-empty~3f))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-empty~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-empty?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Reports whether <span class="RktVar">dict</span> is empty.</div></p><p>Supported for any <span class="RktVar">dict</span> that implements <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-empty~3f%29%29" class="RktValLink" data-pltdoc="x">dict-empty?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"banana"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-empty~3f%29%29" class="RktValLink" data-pltdoc="x">dict-empty?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-count))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-count%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-count</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the number of keys mapped by <span class="RktVar">dict</span>, usually in
+constant time.</div></p><p>Supported for any <span class="RktVar">dict</span> that implements <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span>
+and <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-next</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-count%29%29" class="RktValLink" data-pltdoc="x">dict-count</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"banana"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-count%29%29" class="RktValLink" data-pltdoc="x">dict-count</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-copy))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-copy%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-copy</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a new, mutable dictionary of the same type as <span class="RktVar">dict</span> and with
+the same key/value associations.</div></p><p>Supported for any <span class="RktVar">dict</span> that implements <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-clear%29%29" class="RktValLink" data-pltdoc="x">dict-clear</a></span>,
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%21%29%29" class="RktValLink" data-pltdoc="x">dict-set!</a></span>, <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span>, <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-next</a></span>,
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-key%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-key</a></span>, and <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-value%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-value</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">original</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">copy</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-copy%29%29" class="RktValLink" data-pltdoc="x">dict-copy</a></span><span class="hspace">&nbsp;</span><span class="RktSym">original</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">original</span></td></tr><tr><td><p><span class="RktRes">'#("apple" "banana")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">copy</span></td></tr><tr><td><p><span class="RktRes">'#("apple" "banana")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%21%29%29" class="RktValLink" data-pltdoc="x">dict-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">copy</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">"carrot"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">original</span></td></tr><tr><td><p><span class="RktRes">'#("apple" "banana")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">copy</span></td></tr><tr><td><p><span class="RktRes">'#("apple" "carrot")</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-clear))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-clear%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-clear</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces an empty dictionary of the same type as <span class="RktVar">dict</span>.  If
+<span class="RktVar">dict</span> is mutable, the result must be a new dictionary.</div></p><p>Supported for any <span class="RktVar">dict</span> that supports <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-remove%29%29" class="RktValLink" data-pltdoc="x">dict-remove</a></span>,
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span>, <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-next</a></span>, and
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-key%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-key</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-clear%29%29" class="RktValLink" data-pltdoc="x">dict-clear</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">"banana"</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#hash()</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-clear%29%29" class="RktValLink" data-pltdoc="x">dict-clear</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">two</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">three</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"four"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-clear!))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-clear%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-clear!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Removes all of the key/value associations in <span class="RktVar">dict</span>.</div></p><p>Supported for any <span class="RktVar">dict</span> that supports <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-remove%21%29%29" class="RktValLink" data-pltdoc="x">dict-remove!</a></span>,
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span>, and <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-key%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-key</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%21%29%29" class="RktValLink" data-pltdoc="x">dict-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%21%29%29" class="RktValLink" data-pltdoc="x">dict-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">table</span></td></tr><tr><td><p><span class="RktRes">'#hash((a . "apple") ("banana" . b))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-clear%21%29%29" class="RktValLink" data-pltdoc="x">dict-clear!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">table</span></td></tr><tr><td><p><span class="RktRes">'#hash()</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-keys))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-keys%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-keys</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of the keys from
+<span class="RktVar">dict</span> in an unspecified order.</div></p><p>Supported for any <span class="RktVar">dict</span> that implements <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span>,
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-next</a></span>, and <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-key%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-key</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"banana"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-keys%29%29" class="RktValLink" data-pltdoc="x">dict-keys</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(b a)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-values))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-values%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-values</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of the values from
+<span class="RktVar">dict</span> in an unspecified order.</div></p><p>Supported for any <span class="RktVar">dict</span> that implements <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span>,
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-next</a></span>, and <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-value%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-value</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"banana"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-values%29%29" class="RktValLink" data-pltdoc="x">dict-values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("banana" "apple")</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-~3elist))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-~3elist%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-&gt;list</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of the associations from
+<span class="RktVar">dict</span> in an unspecified order.</div></p><p>Supported for any <span class="RktVar">dict</span> that implements <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span>,
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-next</a></span>, <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-key%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-key</a></span>, and
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-value%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-value</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"banana"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-~3elist%29%29" class="RktValLink" data-pltdoc="x">dict-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((b . "banana") (a . "apple"))</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Dictionary_Sequences&quot;">4.17.3<tt>&nbsp;</tt><a name="(part._.Dictionary_.Sequences)"></a>Dictionary Sequences</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._in-dict))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._in-dict%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-dict</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns a <a href="sequences.html#%28tech._sequence%29" class="techoutside" data-pltdoc="x"><span class="techinside">sequence</span></a>
+whose each element is two values: a key and corresponding value from
+<span class="RktVar">dict</span>.</div></p><p>Supported for any <span class="RktVar">dict</span> that implements <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span>,
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-next</a></span>, <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-key%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-key</a></span>, and
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-value%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-value</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"banana"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._in-dict%29%29" class="RktValLink" data-pltdoc="x">in-dict</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a = ~s"</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("b = \"banana\"" "a = \"apple\"")</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._in-dict-keys))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._in-dict-keys%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-dict-keys</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence whose elements are the keys of <span class="RktVar">dict</span>.</div></p><p>Supported for any <span class="RktVar">dict</span> that implements <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span>,
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-next</a></span>, and <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-key%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-key</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"banana"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._in-dict-keys%29%29" class="RktValLink" data-pltdoc="x">in-dict-keys</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(b a)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._in-dict-values))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._in-dict-values%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-dict-values</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence whose elements are the values of <span class="RktVar">dict</span>.</div></p><p>Supported for any <span class="RktVar">dict</span> that implements <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span>,
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-next</a></span>, and <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-value%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-value</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"banana"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._in-dict-values%29%29" class="RktValLink" data-pltdoc="x">in-dict-values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("banana" "apple")</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._in-dict-pairs))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._in-dict-pairs%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-dict-pairs</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dict</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns a sequence
+whose elements are pairs, each containing a key and its value from
+<span class="RktVar">dict</span> (as opposed to using <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._in-dict%29%29" class="RktValLink" data-pltdoc="x">in-dict</a></span>, which gets the
+key and value as separate values for each element).</div></p><p>Supported for any <span class="RktVar">dict</span> that implements <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-first</a></span>,
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-next</a></span>, <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-key%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-key</a></span>, and
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-value%29%29" class="RktValLink" data-pltdoc="x">dict-iterate-value</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"banana"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._in-dict-pairs%29%29" class="RktValLink" data-pltdoc="x">in-dict-pairs</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'((b . "banana") (a . "apple"))</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Contracted_Dictionaries&quot;">4.17.4<tt>&nbsp;</tt><a name="(part._.Contracted_.Dictionaries)"></a>Contracted Dictionaries</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/dict..rkt)._prop~3adict/contract))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._prop~3adict%2Fcontract%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:dict/contract</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A structure type property for defining dictionaries with
+contracts. The value associated with <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._prop~3adict%2Fcontract%29%29" class="RktValLink" data-pltdoc="x">prop:dict/contract</a></span> must
+be a list of two immutable vectors:</div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVar">dict-vector</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVar">type-key-contract</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">type-value-contract</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">type-iter-contract</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">instance-key-contract</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">instance-value-contract</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">instance-iter-contract</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The first vector must be a vector of 10 procedures which match the
+<span class="RktSym"><a href="dicts.html#%28form._%28%28lib._racket%2Fdict..rkt%29._gen~3adict%29%29" class="RktStxLink" data-pltdoc="x">gen:dict</a></span> <a href="struct-generics.html#%28tech._generic._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">generic interface</span></a> (in addition, it must be an
+immutable vector). The second vector must contain six elements; each
+of the first three is a contract for the dictionary type&rsquo;s keys,
+values, and positions, respectively. Each of the second three is
+either <span class="RktVal">#f</span> or a procedure used to extract the contract from
+a dictionary instance.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-key-contract))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-key-contract%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-key-contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">d</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">d</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-value-contract))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-value-contract%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-value-contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">d</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">d</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._dict-iter-contract))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iter-contract%29%29" class="RktValDef RktValLink" data-pltdoc="x">dict-iter-contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">d</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">d</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns the contract that <span class="RktVar">d</span> imposes on its keys, values, or
+iterators, respectively, if <span class="RktVar">d</span> implements the
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._prop~3adict%2Fcontract%29%29" class="RktValLink" data-pltdoc="x">prop:dict/contract</a></span> interface.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Custom_Hash_Tables&quot;">4.17.5<tt>&nbsp;</tt><a name="(part._.Custom_.Hash_.Tables)"></a>Custom Hash Tables</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/dict..rkt)._define-custom-hash-types))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28form._%28%28lib._racket%2Fdict..rkt%29._define-custom-hash-types%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-custom-hash-types</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">name</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">optional-predicate</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">comparison-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">optional-hash-functions</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">optional-predicate</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:key?</span><span class="hspace">&nbsp;</span><span class="RktVar">predicate-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">optional-hash-functions</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">hash1-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">hash1-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">hash2-expr</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new dictionary type based on the given comparison
+<span class="RktVar">comparison-expr</span>, hash functions <span class="RktVar">hash1-expr</span> and
+<span class="RktVar">hash2-expr</span>, and key predicate <span class="RktVar">predicate-expr</span>; the interfaces
+for these functions are the same as in <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._make-custom-hash-types%29%29" class="RktValLink" data-pltdoc="x">make-custom-hash-types</a></span>.
+The new dictionary type has three variants: immutable, mutable with
+strongly-held keys, and mutable with weakly-held keys.</div></p><p>Defines seven names:</p><ul><li><p><span class="RktVar">name</span><span class="RktSym">?</span> recognizes instances of the new type,</p></li><li><p><span class="RktSym">immutable-</span><span class="RktVar">name</span><span class="RktSym">?</span> recognizes
+immutable instances of the new type,</p></li><li><p><span class="RktSym">mutable-</span><span class="RktVar">name</span><span class="RktSym">?</span> recognizes
+mutable instances of the new type with strongly-held keys,</p></li><li><p><span class="RktSym">weak-</span><span class="RktVar">name</span><span class="RktSym">?</span> recognizes
+mutable instances of the new type with weakly-held keys,</p></li><li><p><span class="RktSym">make-immutable-</span><span class="RktVar">name</span> constructs
+immutable instances of the new type,</p></li><li><p><span class="RktSym">make-mutable-</span><span class="RktVar">name</span> constructs
+mutable instances of the new type with strongly-held keys, and</p></li><li><p><span class="RktSym">make-weak-</span><span class="RktVar">name</span> constructs
+mutable instances of the new type with weakly-held keys.</p></li></ul><p>The constructors all accept a dictionary as an optional argument, providing
+initial key/value pairs.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28form._%28%28lib._racket%2Fdict..rkt%29._define-custom-hash-types%29%29" class="RktStxLink" data-pltdoc="x">define-custom-hash-types</a></span><span class="hspace">&nbsp;</span><span class="RktSym">string-hash</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:key?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string=?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="RktValLink" data-pltdoc="x">string-length</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">imm</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-immutable-string-hash</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">a</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">"banana"</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">b</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mut</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-mutable-string-hash</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">a</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">"banana"</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">b</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">imm</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mut</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">string-hash?</span><span class="hspace">&nbsp;</span><span class="RktSym">imm</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">string-hash?</span><span class="hspace">&nbsp;</span><span class="RktSym">mut</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">immutable-string-hash?</span><span class="hspace">&nbsp;</span><span class="RktSym">imm</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">immutable-string-hash?</span><span class="hspace">&nbsp;</span><span class="RktSym">mut</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">imm</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'a</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mut</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'b</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%21%29%29" class="RktValLink" data-pltdoc="x">dict-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mut</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">berry</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mut</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'berry</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">imm</span><span class="hspace">&nbsp;</span><span class="RktSym">mut</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-remove%29%29" class="RktValLink" data-pltdoc="x">dict-remove</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-remove%29%29" class="RktValLink" data-pltdoc="x">dict-remove</a></span><span class="hspace">&nbsp;</span><span class="RktSym">imm</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-immutable-string-hash</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._make-custom-hash-types))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._make-custom-hash-types%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-custom-hash-types</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">eql?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">hash1</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash2</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:key?</span><span class="hspace">&nbsp;</span><span class="RktVar">key?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:name</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:for</span><span class="hspace">&nbsp;</span><span class="RktVar">who</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">eql?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">hash1</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._const%29%29" class="RktValLink" data-pltdoc="x">const</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">hash2</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._const%29%29" class="RktValLink" data-pltdoc="x">const</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._const%29%29" class="RktValLink" data-pltdoc="x">const</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#true</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">custom-hash</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">who</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">make-custom-hash-types</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new dictionary type based on the given comparison function
+<span class="RktVar">eql?</span>, hash functions <span class="RktVar">hash1</span> and <span class="RktVar">hash2</span>, and predicate
+<span class="RktVar">key?</span>.  The new dictionary type has variants that are immutable,
+mutable with strongly-held keys, and mutable with weakly-held keys.  The given
+<span class="RktVar">name</span> is used when printing instances of the new dictionary type, and
+the symbol <span class="RktVar">who</span> is used for reporting errors.</div></p><p>The comparison function <span class="RktVar">eql?</span> may accept 2 or 3 arguments.  If it
+accepts 2 arguments, it given two keys to compare them.  If it accepts
+3 arguments and does not accept 2 arguments, it is also given a
+recursive comparison function that handles data cycles when comparing sub-parts
+of the keys.</p><p>The hash functions <span class="RktVar">hash1</span> and <span class="RktVar">hash2</span> may accept 1 or 2
+arguments.  If either hash function accepts 1 argument, it is applied to a key
+to compute the corresponding hash value.  If either hash function accepts 2
+arguments and does not accept 1 argument, it is also given a recursive hash
+function that handles data cycles when computing hash values of sub-parts of
+the keys.</p><p>The predicate <span class="RktVar">key?</span> must accept 1 argument and is used to recognize
+valid keys for the new dictionary type.</p><p>Produces seven values:</p><ul><li><p>a predicate recognizing all instances of the new dictionary type,</p></li><li><p>a predicate recognizing immutable instances,</p></li><li><p>a predicate recognizing mutable instances,</p></li><li><p>a predicate recognizing weak instances,</p></li><li><p>a constructor for immutable instances,</p></li><li><p>a constructor for mutable instances, and</p></li><li><p>a constructor for weak instances.</p></li></ul><p>See <span class="RktSym"><a href="dicts.html#%28form._%28%28lib._racket%2Fdict..rkt%29._define-custom-hash-types%29%29" class="RktStxLink" data-pltdoc="x">define-custom-hash-types</a></span> for an example.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._make-custom-hash))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._make-custom-hash%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-custom-hash</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">eql?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">hash1</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash2</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:key?</span><span class="hspace">&nbsp;</span><span class="RktVar">key?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">eql?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">hash1</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._const%29%29" class="RktValLink" data-pltdoc="x">const</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">hash2</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._const%29%29" class="RktValLink" data-pltdoc="x">const</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#true</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._make-weak-custom-hash))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._make-weak-custom-hash%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-weak-custom-hash</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">eql?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">hash1</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash2</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:key?</span><span class="hspace">&nbsp;</span><span class="RktVar">key?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">eql?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">hash1</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._const%29%29" class="RktValLink" data-pltdoc="x">const</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">hash2</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._const%29%29" class="RktValLink" data-pltdoc="x">const</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#true</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._make-immutable-custom-hash))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._make-immutable-custom-hash%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-immutable-custom-hash</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">eql?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">hash1</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash2</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:key?</span><span class="hspace">&nbsp;</span><span class="RktVar">key?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">eql?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">hash1</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._const%29%29" class="RktValLink" data-pltdoc="x">const</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">hash2</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._const%29%29" class="RktValLink" data-pltdoc="x">const</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#true</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Creates an instance of a new dictionary type, implemented
+ in terms of a hash table where keys are compared with
+ <span class="RktVar">eql?</span>, hashed with <span class="RktVar">hash1</span> and
+ <span class="RktVar">hash2</span>, and where the key predicate is
+ <span class="RktVar">key?</span>. See <span class="RktSym">gen:equal</span> and <span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal+hash</a></span> for information
+ on suitable equality and hashing functions.</div></p><p>The <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._make-custom-hash%29%29" class="RktValLink" data-pltdoc="x">make-custom-hash</a></span> and <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._make-weak-custom-hash%29%29" class="RktValLink" data-pltdoc="x">make-weak-custom-hash</a></span>
+functions create a mutable dictionary that does not support functional
+update, while <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._make-immutable-custom-hash%29%29" class="RktValLink" data-pltdoc="x">make-immutable-custom-hash</a></span> creates an immutable
+dictionary that supports functional update. The dictionary created by
+<span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._make-weak-custom-hash%29%29" class="RktValLink" data-pltdoc="x">make-weak-custom-hash</a></span> retains its keys weakly, like the result
+of <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-weak-hash%29%29" class="RktValLink" data-pltdoc="x">make-weak-hash</a></span>.</p><p>Dictionaries created by <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._make-custom-hash%29%29" class="RktValLink" data-pltdoc="x">make-custom-hash</a></span> and company are
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> when they have the same mutability and key strength,
+the associated procedures are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>, and the key&ndash;value
+mappings are the same when keys and values are compared with
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>.</p><p>See also <span class="RktSym"><a href="dicts.html#%28form._%28%28lib._racket%2Fdict..rkt%29._define-custom-hash-types%29%29" class="RktStxLink" data-pltdoc="x">define-custom-hash-types</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._make-custom-hash%29%29" class="RktValLink" data-pltdoc="x">make-custom-hash</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string=?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a"</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a"</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-hash-code</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a"</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%21%29%29" class="RktValLink" data-pltdoc="x">dict-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">one</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="RktValLink" data-pltdoc="x">dict-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">"1"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'one</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Passing_keyword_arguments_in_dictionaries&quot;">4.17.6<tt>&nbsp;</tt><a name="(part._.Passing_keyword_arguments_in_dictionaries)"></a>Passing keyword arguments in dictionaries</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/dict..rkt)._keyword-apply/dict))"></a><span title="Provided from: racket/dict, racket | Package: base"><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._keyword-apply%2Fdict%29%29" class="RktValDef RktValLink" data-pltdoc="x">keyword-apply/dict</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">kw-dict</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos-arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos-args</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:&lt;kw&gt;</span><span class="hspace">&nbsp;</span><span class="RktVar">kw-arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">kw-dict</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="RktValLink" data-pltdoc="x">dict?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos-arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos-args</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">kw-arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Applies the <span class="RktVar">proc</span> using the positional arguments
+from <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%2A%29%29" class="RktValLink" data-pltdoc="x">list*</a></span><span class="stt"> </span><span class="RktVar">pos-arg</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktVar">pos-args</span><span class="RktPn">)</span>, and the keyword
+arguments from <span class="RktVar">kw-dict</span> in addition to the directly
+supplied keyword arguments in the <span class="RktPn">#:&lt;kw&gt;</span><span class="stt"> </span><span class="RktVar">kw-arg</span>
+ sequence.</div></p><p>All the keys in <span class="RktVar">kw-dict</span> must be keywords.
+The keywords in the <span class="RktVar">kw-dict</span> do not have to be
+sorted. However, the keywords in <span class="RktVar">kw-dict</span> and the
+directly supplied <span class="RktPn">#:&lt;kw&gt;</span> keywords must not overlap.
+The given <span class="RktVar">proc</span> must accept all of the keywords in
+<span class="RktVar">kw-dict</span> plus the <span class="RktPn">#:&lt;kw&gt;</span>s.</p><p><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">sundae</span><span class="hspace">&nbsp;</span><span class="RktPn">#:ice-cream</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">ice-cream</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"vanilla"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:toppings</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">toppings</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"brownie-bits"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:sprinkles</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">sprinkles</span><span class="hspace">&nbsp;</span><span class="RktVal">"chocolate"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:syrup</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">syrup</span><span class="hspace">&nbsp;</span><span class="RktVal">"caramel"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"A sundae with ~a ice cream, ~a, ~a sprinkles, and ~a syrup."</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-join%29%29" class="RktValLink" data-pltdoc="x">string-join</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ice-cream</span><span class="hspace">&nbsp;</span><span class="RktPn">#:before-last</span><span class="hspace">&nbsp;</span><span class="RktVal">" and "</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-join%29%29" class="RktValLink" data-pltdoc="x">string-join</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toppings</span><span class="hspace">&nbsp;</span><span class="RktPn">#:before-last</span><span class="hspace">&nbsp;</span><span class="RktVal">" and "</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">sprinkles</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">syrup</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._keyword-apply%2Fdict%29%29" class="RktValLink" data-pltdoc="x">keyword-apply/dict</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sundae</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">#:ice-cream</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"chocolate"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"A sundae with chocolate ice cream, brownie-bits, chocolate sprinkles, and caramel syrup."</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._keyword-apply%2Fdict%29%29" class="RktValLink" data-pltdoc="x">keyword-apply/dict</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sundae</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash%29%29" class="RktValLink" data-pltdoc="x">hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#:toppings</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"cookie-dough"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#:sprinkles</span><span class="hspace">&nbsp;</span><span class="RktVal">"rainbow"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#:syrup</span><span class="hspace">&nbsp;</span><span class="RktVal">"chocolate"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"A sundae with vanilla ice cream, cookie-dough, rainbow sprinkles, and chocolate syrup."</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._keyword-apply%2Fdict%29%29" class="RktValLink" data-pltdoc="x">keyword-apply/dict</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sundae</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:sprinkles</span><span class="hspace">&nbsp;</span><span class="RktVal">"rainbow"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash%29%29" class="RktValLink" data-pltdoc="x">hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#:toppings</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"cookie-dough"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#:syrup</span><span class="hspace">&nbsp;</span><span class="RktVal">"chocolate"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"A sundae with vanilla ice cream, cookie-dough, rainbow sprinkles, and chocolate syrup."</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><p class="SHistory">Added in version 7.9 of package <span class="stt">base</span>.</p></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Generators.html" title="backward to &quot;4.16.3 Generators&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="sets.html" title="forward to &quot;4.18 Sets&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/doc-bibliography.html b/clones/docs.racket-lang.org/reference/doc-bibliography.html
new file mode 100644
index 00000000..cf9b204f
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/doc-bibliography.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>Bibliography</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9660;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublistonly" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewselflink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Kernel_Forms_and_Functions.html" title="backward to &quot;18.8 Kernel Forms and Functions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="doc-index.html" title="forward to &quot;Index&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;doc-bibliography&quot;"><a name="(part._doc-bibliography)"></a>Bibliography</h3><p><table cellspacing="0" cellpadding="0" class="RBibliography"><tr><td><a name="(cite._.C99)"></a>[C99]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">ISO/IEC, &ldquo;ISO/IEC 9899:1999 Cor. 3:2007(E).&rdquo; 2007.</span></td></tr><tr><td><a name="(cite._.Culpepper07)"></a>[Culpepper07]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Ryan Culpepper, Sam Tobin-Hochstadt, and Matthew Flatt, &ldquo;Advanced Macrology and the Implementation of Typed Scheme,&rdquo; Workshop on Scheme and Functional Programming, 2007. <a href="https://www2.ccs.neu.edu/racket/pubs/scheme2007-ctf.pdf"><span class="stt">https://www2.ccs.neu.edu/racket/pubs/scheme2007-ctf.pdf</span></a></span></td></tr><tr><td><a name="(cite._.Danvy90)"></a>[Danvy90]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Olivier Danvy and Andre Filinski, &ldquo;Abstracting Control,&rdquo; LISP and Functional Programming, 1990. <a href="http://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.6.960&amp;rep=rep1&amp;type=pdf"><span class="stt">http://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.6.960&amp;rep=rep1&amp;type=pdf</span></a></span></td></tr><tr><td><a name="(cite._.Felleisen88a)"></a>[Felleisen88a]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Matthias Felleisen, &ldquo;The theory and practice of first-class prompts,&rdquo; Principles of Programming Languages, 1988. <a href="https://www.cs.tufts.edu/~nr/cs257/archive/matthias-felleisen/prompts.pdf"><span class="stt">https://www.cs.tufts.edu/~nr/cs257/archive/matthias-felleisen/prompts.pdf</span></a></span></td></tr><tr><td><a name="(cite._.Felleisen88)"></a>[Felleisen88]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Matthias Felleisen, Mitch Wand, Dan Friedman, and Bruce Duba, &ldquo;Abstract Continuations: A Mathematical Semantics for Handling Full Functional Jumps,&rdquo; LISP and Functional Programming, 1988. <a href="https://help.luddy.indiana.edu/techreports/TRNNN.cgi?trnum=TR248"><span class="stt">https://help.luddy.indiana.edu/techreports/TRNNN.cgi?trnum=TR248</span></a></span></td></tr><tr><td><a name="(cite._.Feltey18)"></a>[Feltey18]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Daniel Feltey, Ben Greenman, Christophe Scholliers, Robert Bruce Findler, and Vincent St-Amour, &ldquo;Collapsible Contracts: Fixing a Pathology of Gradual Typing,&rdquo; Object-Oriented Programming, Systems, and Languages (OOPSLA), 2018. <a href="https://www.ccis.northeastern.edu/~types/publications/collapsible/fgsfs-oopsla-2018.pdf"><span class="stt">https://www.ccis.northeastern.edu/~types/publications/collapsible/fgsfs-oopsla-2018.pdf</span></a></span></td></tr><tr><td><a name="(cite._.Flatt02)"></a>[Flatt02]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Matthew Flatt, &ldquo;Composable and Compilable Macros: You Want it When?,&rdquo; International Conference on Functional Programming (ICFP), 2002. <a href="http://www.cs.utah.edu/plt/publications/gpce13-f-color.pdf"><span class="stt">http://www.cs.utah.edu/plt/publications/gpce13-f-color.pdf</span></a></span></td></tr><tr><td><a name="(cite._.Friedman95)"></a>[Friedman95]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Daniel P. Friedman, C. T. Haynes, and R. Kent Dybvig, &ldquo;Exception system proposal,&rdquo; web page, 1995. <a href="https://web.archive.org/web/20161012054505/http://www.cs.indiana.edu/scheme-repository/doc.proposals.exceptions.html"><span class="stt">https://web.archive.org/web/20161012054505/http://www.cs.indiana.edu/scheme-repository/doc.proposals.exceptions.html</span></a></span></td></tr><tr><td><a name="(cite._.Gasbichler02)"></a>[Gasbichler02]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Martin Gasbichler and Michael Sperber, &ldquo;Processes vs. User-Level Threads in Scsh,&rdquo; Workshop on Scheme and Functional Programming, 2002. <a href="http://www.ccs.neu.edu/home/shivers/papers/scheme02/article/threads.pdf"><span class="stt">http://www.ccs.neu.edu/home/shivers/papers/scheme02/article/threads.pdf</span></a></span></td></tr><tr><td><a name="(cite._.Greenberg15)"></a>[Greenberg15]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Michael Greenberg, &ldquo;Space-Efficient Manifest Contracts,&rdquo; Principles of Programming Languages (POPL), 2015. <a href="https://cs.pomona.edu/~michael/papers/popl2015_space.pdf"><span class="stt">https://cs.pomona.edu/~michael/papers/popl2015_space.pdf</span></a></span></td></tr><tr><td><a name="(cite._.Gunter95)"></a>[Gunter95]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Carl Gunter, Didier Remy, and Jon Rieke, &ldquo;A Generalization of Exceptions and Control in ML-like Languages,&rdquo; Functional Programming Languages and Computer Architecture, 1995. <a href="http://gallium.inria.fr/~remy/ftp/prompt.pdf"><span class="stt">http://gallium.inria.fr/~remy/ftp/prompt.pdf</span></a></span></td></tr><tr><td><a name="(cite._.Haynes84)"></a>[Haynes84]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Christopher T. Haynes and Daniel P. Friedman, &ldquo;Engines Build Process Abstractions,&rdquo; Symposium on LISP and Functional Programming, 1984. <a href="https://legacy.cs.indiana.edu/ftp/techreports/TR159.pdf"><span class="stt">https://legacy.cs.indiana.edu/ftp/techreports/TR159.pdf</span></a></span></td></tr><tr><td><a name="(cite._.Hayes97)"></a>[Hayes97]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Barry Hayes, &ldquo;Ephemerons: a New Finalization Mechanism,&rdquo; Object-Oriented Languages, Programming, Systems, and Applications, 1997. <a href="https://static.aminer.org/pdf/PDF/000/522/273/ephemerons_a_new_finalization_mechanism.pdf"><span class="stt">https://static.aminer.org/pdf/PDF/000/522/273/ephemerons_a_new_finalization_mechanism.pdf</span></a></span></td></tr><tr><td><a name="(cite._.Hieb90)"></a>[Hieb90]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Robert Hieb and R. Kent Dybvig, &ldquo;Continuations and Concurrency,&rdquo; Principles and Practice of Parallel Programming, 1990. <a href="https://legacy.cs.indiana.edu/ftp/techreports/TR256.pdf"><span class="stt">https://legacy.cs.indiana.edu/ftp/techreports/TR256.pdf</span></a></span></td></tr><tr><td><a name="(cite._.Lamport79)"></a>[Lamport79]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Leslie Lamport, &ldquo;How to Make a Multiprocessor Computer That Correctly Executes Multiprocess Programs,&rdquo; IEEE Transactions on Computers, 179. <a href="https://www.microsoft.com/en-us/research/uploads/prod/2016/12/How-to-Make-a-Multiprocessor-Computer-That-Correctly-Executes-Multiprocess-Programs.pdf"><span class="stt">https://www.microsoft.com/en-us/research/uploads/prod/2016/12/How-to-Make-a-Multiprocessor-Computer-That-Correctly-Executes-Multiprocess-Programs.pdf</span></a></span></td></tr><tr><td><a name="(cite._.L'.Ecuyer02)"></a>[L'Ecuyer02]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Pierre L&rsquo;Ecuyer, Richard Simard, E. Jack Chen, and W. David Kelton, &ldquo;An Object-Oriented Random-Number Package With Many Long Streams and Substreams,&rdquo; Operations Research, 50(6), 2002. <a href="https://www.iro.umontreal.ca/~lecuyer/myftp/papers/streams00.pdf"><span class="stt">https://www.iro.umontreal.ca/~lecuyer/myftp/papers/streams00.pdf</span></a></span></td></tr><tr><td><a name="(cite._.Queinnec91)"></a>[Queinnec91]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Queinnec and Serpette, &ldquo;A Dynamic Extent Control Operator for Partial Continuations,&rdquo; Principles of Programming Languages, 1991. <a href="https://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.40.9946&amp;rep=rep1&amp;type=pdf"><span class="stt">https://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.40.9946&amp;rep=rep1&amp;type=pdf</span></a></span></td></tr><tr><td><a name="(cite._.Reppy99)"></a>[Reppy99]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">John H. Reppy, <span style="font-style: italic">Concurrent Programming in ML</span>, Cambridge University Press, 1999. <a href="https://doi.org/10.1017/CBO9780511574962"><span class="stt">https://doi.org/10.1017/CBO9780511574962</span></a></span></td></tr><tr><td><a name="(cite._.Roux14)"></a>[Roux14]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Pierre Roux, &ldquo;Innocuous Double Rounding of Basic Arithmetic Operations,&rdquo; <span style="font-style: italic">Journal of Formalized Reasoning</span>, 7(1), 2014.</span></td></tr><tr><td><a name="(cite._.Sapin18)"></a>[Sapin18]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Simon Sapin, &ldquo;The WTF-8 Encoding.&rdquo; 2018. <a href="https://simonsapin.github.io/wtf-8/"><span class="stt">http://simonsapin.github.io/wtf-8/</span></a></span></td></tr><tr><td><a name="(cite._.Shan04)"></a>[Shan04]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Ken Shan, &ldquo;Shift to Control,&rdquo; Workshop on Scheme and Functional Programming, 2004. <a href="http://homes.sice.indiana.edu/ccshan/recur/recur.pdf"><span class="stt">http://homes.sice.indiana.edu/ccshan/recur/recur.pdf</span></a></span></td></tr><tr><td><a name="(cite._.Sperber07)"></a>[Sperber07]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Michael Sperber, R. Kent Dybvig, Matthew Flatt, and Anton van Straaten (editors), &ldquo;The Revised<span style="vertical-align: super; font-size: 80%">6</span> Report on the Algorithmic Language Scheme.&rdquo; 2007. <a href="http://www.r6rs.org/"><span class="stt">http://www.r6rs.org/</span></a></span></td></tr><tr><td><a name="(cite._.Sitaram90)"></a>[Sitaram90]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Dorai Sitaram and Matthias Felleisen, &ldquo;Control Delimiters and Their Hierarchies,&rdquo; <span style="font-style: italic">Lisp and Symbolic Computation</span>, 1990. <a href="https://www2.ccs.neu.edu/racket/pubs/lasc1990-sf.pdf"><span class="stt">https://www2.ccs.neu.edu/racket/pubs/lasc1990-sf.pdf</span></a></span></td></tr><tr><td><a name="(cite._.Sitaram93)"></a>[Sitaram93]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Dorai Sitaram, &ldquo;Handling Control,&rdquo; Programming Language Design and Implementation, 1993. <a href="http://citeseerx.ist.psu.edu/viewdoc/summary?doi=10.1.1.22.7256"><span class="stt">http://citeseerx.ist.psu.edu/viewdoc/summary?doi=10.1.1.22.7256</span></a></span></td></tr><tr><td><a name="(cite._.S.R.F.I-42)"></a>[SRFI-42]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Sebastian Egner, &ldquo;SRFI-42: Eager Comprehensions,&rdquo; SRFI, 2003. <a href="http://srfi.schemers.org/srfi-42/"><span class="stt">http://srfi.schemers.org/srfi-42/</span></a></span></td></tr><tr><td><a name="(cite._.Strickland12)"></a>[Strickland12]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">T. Stephen Strickland, Sam Tobin-Hochstadt, Matthew Flatt, and Robert Bruce Findler, &ldquo;Chaperones and Impersonators: Run-time Support for Reasonable Interposition,&rdquo; Object-Oriented Programming, Systems, and Languages (OOPSLA), 2012. <a href="http://www.eecs.northwestern.edu/~robby/pubs/papers/oopsla2012-stff.pdf"><span class="stt">http://www.eecs.northwestern.edu/~robby/pubs/papers/oopsla2012-stff.pdf</span></a></span></td></tr><tr><td><a name="(cite._.Torosyan21)"></a>[Torosyan21]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Son Torosyan, Jon Zeppieri, and Matthew Flatt, &ldquo;Runtime and Compiler Support for HAMTs,&rdquo; Dynamic Languages Symposium (DLS), 2021. <a href="https://www.cs.utah.edu/plt/publications/dls21-tzf.pdf"><span class="stt">https://www.cs.utah.edu/plt/publications/dls21-tzf.pdf</span></a></span></td></tr></table></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Kernel_Forms_and_Functions.html" title="backward to &quot;18.8 Kernel Forms and Functions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="doc-index.html" title="forward to &quot;Index&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/doc-index.html b/clones/docs.racket-lang.org/reference/doc-index.html
new file mode 100644
index 00000000..5c0e9c89
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/doc-index.html
@@ -0,0 +1,35 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>Index</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9660;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublistonly" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewselflink" data-pltdoc="x">Index</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="doc-bibliography.html" title="backward to &quot;Bibliography&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<span class="nonavigation">next &rarr;</span></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;doc-index&quot;"><a name="(part._doc-index)"></a>Index</h3><table cellspacing="0" cellpadding="0"><tr><td><p><a href="doc-index.html#alpha:A">A</a> <a href="doc-index.html#alpha:B">B</a> <a href="doc-index.html#alpha:C">C</a> <a href="doc-index.html#alpha:D">D</a> <a href="doc-index.html#alpha:E">E</a> <a href="doc-index.html#alpha:F">F</a> <a href="doc-index.html#alpha:G">G</a> <a href="doc-index.html#alpha:H">H</a> <a href="doc-index.html#alpha:I">I</a> <a href="doc-index.html#alpha:J">J</a> <a href="doc-index.html#alpha:K">K</a> <a href="doc-index.html#alpha:L">L</a> <a href="doc-index.html#alpha:M">M</a> <a href="doc-index.html#alpha:N">N</a> <a href="doc-index.html#alpha:O">O</a> <a href="doc-index.html#alpha:P">P</a> <a href="doc-index.html#alpha:Q">Q</a> <a href="doc-index.html#alpha:R">R</a> <a href="doc-index.html#alpha:S">S</a> <a href="doc-index.html#alpha:T">T</a> <a href="doc-index.html#alpha:U">U</a> <a href="doc-index.html#alpha:V">V</a> <a href="doc-index.html#alpha:W">W</a> <a href="doc-index.html#alpha:X">X</a> <a href="doc-index.html#alpha:Y">Y</a> <a href="doc-index.html#alpha:Z">Z</a> </p></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><p><a href="reader.html#%28idx._%28gentag._37._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">"</span><span class="hspace"></span></span><br/></a><a href="extflonums.html#%28idx._%28gentag._132._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"longdouble.dll"</span><br/></a><a href="reader.html#%28idx._%28gentag._69._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!</span><span class="hspace">&nbsp;</span></span><br/></a><a href="reader.html#%28idx._%28gentag._95._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._70._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!/</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._55._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#"</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._5._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#%</span><span class="hspace"></span></span><br/></a><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25app%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%app</span></span><br/></a><a href="reader.html#%28idx._%28gentag._33._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">#%braces</span><br/></a><a href="reader.html#%28idx._%28gentag._32._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">#%brackets</span><br/></a><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._~23~25datum%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%datum</span></span><br/></a><a href="module.html#%28form._%28%28quote._~23~25kernel%29._~23~25declare%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%declare</span></span><br/></a><a href="reader.html#%28idx._%28gentag._96._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">#%dot</span><br/></a><a href="__expression.html#%28form._%28%28quote._~23~25kernel%29._~23~25expression%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%expression</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._457._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">#%kernel</span><br/></a><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25module-begin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%module-begin</span></span><br/></a><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-app%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%plain-app</span></span><br/></a><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-lambda%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%plain-lambda</span></span><br/></a><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-module-begin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%plain-module-begin</span></span><br/></a><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25printing-module-begin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%printing-module-begin</span></span><br/></a><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25provide%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%provide</span></span><br/></a><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25require%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%require</span></span><br/></a><a href="stratified-body.html#%28form._%28%28quote._~23~25kernel%29._~23~25stratified-body%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%stratified-body</span></span><br/></a><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%top</span></span><br/></a><a href="__top-interaction.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25top-interaction%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%top-interaction</span></span><br/></a><a href="Locations____variable-reference.html#%28form._%28%28quote._~23~25kernel%29._~23~25variable-reference%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%variable-reference</span></span><br/></a><a href="reader.html#%28idx._%28gentag._75._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&amp;</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._62._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#'</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._64._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#,</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._65._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#,@</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._91._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">#0#<br/></a><a href="reader.html#%28idx._%28gentag._92._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">#0=<br/></a><a href="reader.html#%28idx._%28gentag._88._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#:</span><span class="hspace"></span></span><br/></a><a href="module.html#%28idx._%28gentag._100._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktPn">#:cross-phase-persistent</span><br/></a><a href="module.html#%28idx._%28gentag._101._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktPn">#:empty-namespace</span><br/></a><a href="module.html#%28idx._%28gentag._103._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktPn">#:realm</span><br/></a><a href="module.html#%28idx._%28gentag._102._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktPn">#:unsafe</span><br/></a><a href="reader.html#%28idx._%28gentag._68._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#;</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._56._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&lt;&lt;</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._76._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._79._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\backspace</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._82._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\linefeed</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._81._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\newline</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._77._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\nul</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._78._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\null</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._84._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\page</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._85._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\return</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._87._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\rubout</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._86._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\space</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._80._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\tab</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._83._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\vtab</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._63._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#`</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._13._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#b</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._8._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#ci</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._9._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#cs</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._15._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#d</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._11._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#e</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._22._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#F</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._21._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#f</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._20._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#false</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._71._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hash</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._72._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hashalw</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._73._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hasheq</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._74._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hasheqv</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._12._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#i</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._94._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._14._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#o</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._90._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#px</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._93._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#reader</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._89._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#rx</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._19._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#T</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._18._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#t</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._17._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#true</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._16._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#x</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._67._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#|</span><span class="hspace"></span></span><br/></a><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._~25%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">%</span></span><br/></a><a href="reader.html#%28idx._%28gentag._58._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._23._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._26._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">*</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._%2Alist%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">*list/c</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">+</span></span><br/></a><a href="numbers.html#%28idx._%28gentag._111._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">+inf.0</span><br/></a><a href="numbers.html#%28idx._%28gentag._113._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">+inf.f</span><br/></a><a href="extflonums.html#%28idx._%28gentag._133._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">+inf.t</span><br/></a><a href="numbers.html#%28idx._%28gentag._116._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">+nan.0</span><br/></a><a href="numbers.html#%28idx._%28gentag._118._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">+nan.f</span><br/></a><a href="extflonums.html#%28idx._%28gentag._135._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">+nan.t</span><br/></a><a href="running-sa.html#%28idx._%28gentag._552._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">+rv</span></span><br/></a><a href="reader.html#%28idx._%28gentag._60._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">,</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._61._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">,@</span><span class="hspace"></span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink"><span class="nobreak">-</span></span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._537._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._505._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--addon</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._509._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--addon</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._482._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--back</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._529._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--binary</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._499._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--collects</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._525._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--compile-any</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._511._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--compiled</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._503._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--config</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._513._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--cross</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._515._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--cross</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._459._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--eval</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._519._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--exe</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._539._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--help</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._465._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--lib</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._461._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--load</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._474._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--main</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._486._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--make</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._490._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--make</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._517._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--name</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._488._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--no-compiled</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._492._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--no-compiled</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._527._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--no-delay</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._494._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--no-init-file</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._523._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--no-jit</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._478._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--no-lib</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._507._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--no-user-path</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._484._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--no-yield</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._476._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--repl</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._463._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--require</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._470._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--require-script</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._468._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--script</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._501._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--search</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._533._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--stdout</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._535._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--syslog</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._496._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--text-repl</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._480._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--version</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._531._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--warn</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._521._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">--wm-class</span></span><br/></a><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink"><span class="nobreak">-&gt;</span></span></span><br/></a><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink"><span class="nobreak">-&gt;</span>*</span></span><br/></a><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._-~3e%2Am%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink"><span class="nobreak">-&gt;</span>*m</span></span><br/></a><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ed%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink"><span class="nobreak">-&gt;</span>d</span></span><br/></a><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._-~3edm%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink"><span class="nobreak">-&gt;</span>dm</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._-~3eextfl%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink"><span class="nobreak">-&gt;</span>extfl</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._-~3efl%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink"><span class="nobreak">-&gt;</span>fl</span></span><br/></a><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink"><span class="nobreak">-&gt;</span>i</span></span><br/></a><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._-~3em%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink"><span class="nobreak">-&gt;</span>m</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._504._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-A</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._508._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-A</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._528._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-b</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._543._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-background</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._542._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-bg</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._512._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-C</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._514._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-C</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._487._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-c</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._491._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-c</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._526._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-d</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._540._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-display</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._518._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-E</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._458._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-e</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._460._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-f</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._544._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-fg</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._546._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-fn</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._547._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-font</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._545._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-foreground</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._502._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-G</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._541._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-geometry</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._538._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-h</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._497._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-I</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._475._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-i</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._548._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-iconic</span></span><br/></a><a href="numbers.html#%28idx._%28gentag._114._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal"><span class="nobreak">-i</span>nf.0</span><br/></a><a href="numbers.html#%28idx._%28gentag._115._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">-inf.f</span><br/></a><a href="extflonums.html#%28idx._%28gentag._134._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal"><span class="nobreak">-i</span>nf.t</span><br/></a><a href="running-sa.html#%28idx._%28gentag._520._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-J</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._522._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-j</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._481._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-K</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._471._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-k</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._534._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-L</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._464._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-l</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._524._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-M</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._473._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-m</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._516._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-N</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._477._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-n</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._549._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-name</span></span><br/></a><a href="numbers.html#%28idx._%28gentag._121._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">-nan.0</span><br/></a><a href="numbers.html#%28idx._%28gentag._122._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">-nan.f</span><br/></a><a href="extflonums.html#%28idx._%28gentag._136._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal"><span class="nobreak">-n</span>an.t</span><br/></a><a href="running-sa.html#%28idx._%28gentag._532._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-O</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._466._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-p</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._559._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-psn_</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._493._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-q</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._510._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-R</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._467._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-r</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._551._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-reverse</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._550._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-rv</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._500._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-S</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._553._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-selectionTimeout</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._558._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-singleInstance</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._554._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-synchronous</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._462._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-t</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._555._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-title</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._506._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-U</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._469._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-u</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._483._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-V</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._479._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-v</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._530._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-W</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._498._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-X</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._556._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-xnllanguage</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._557._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-xrm</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._472._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-Y</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._485._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-y</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._489._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-y</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._536._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-Z</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._495._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="nobreak"><span class="stt">-z</span></span><br/></a><a href="reader.html#%28idx._%28gentag._29._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span><br/></a><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="indexlink" data-pltdoc="x"><span class="RktMeta"><span class="RktStxLink">...</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._336._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">".racketrc"</span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2F%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">/</span></span><br/></a><a href="runtime.html#%28idx._%28gentag._426._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">3m</span><br/></a><a href="implementations.html#%28tech._3m%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">3m</span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~3ado-in%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">:do-in</span></span><br/></a><a href="reader.html#%28idx._%28gentag._66._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">;</span><span class="hspace"></span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">&lt;</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3c%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">&lt;/c</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">&lt;=</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3c~3d%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">&lt;=/c</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">=</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3d%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">=/c</span></span><br/></a><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._~3d~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">==</span></span><br/></a><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">=&gt;</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">&gt;</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">&gt;/c</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">&gt;=</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">&gt;=/c</span></span><br/></a><a href="match.html#%28idx._%28gentag._219._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">?<br/></a><a href="reader.html#%28idx._%28gentag._24._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._4._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._46._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\"</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._47._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\'</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._49._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">8</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,3}</span></span><br/></a><a href="reader.html#%28idx._%28gentag._54._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">newline</span>&#8250;</span><br/></a><a href="reader.html#%28idx._%28gentag._48._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._38._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\a</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._39._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\b</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._45._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\e</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._43._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\f</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._41._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\n</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._44._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\r</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._40._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\t</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._51._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\u</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">16</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,4}</span></span><br/></a><a href="reader.html#%28idx._%28gentag._53._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\U</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">16</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,8}</span></span><br/></a><a href="reader.html#%28idx._%28gentag._52._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\u</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">16</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{4,4}</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\u</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">16</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{4,4}</span></span><br/></a><a href="reader.html#%28idx._%28gentag._42._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\v</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._50._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\x</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">16</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,2}</span></span><br/></a><a href="reader.html#%28idx._%28gentag._27._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span><br/></a><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">_</span></span><br/></a><a href="match.html#%28idx._%28gentag._202._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">_<br/></a><a href="reader.html#%28idx._%28gentag._59._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">`</span><span class="hspace"></span></span><br/></a><a name="alpha:A"></a><span><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._abort%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">abort</span></span><br/></a></span><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._abort-current-continuation%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">abort-current-continuation</span></span><br/></a><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._abort%2Fcc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">abort/cc</span></span><br/></a><a href="bytestrings.html#%28idx._%28gentag._145._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">aborts</span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._abs%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">abs</span></span><br/></a><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._absent%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">absent</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._absolute-path~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">absolute-path?</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._abstract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">abstract</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._374._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">access-time-nanoseconds</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._370._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">access-time-seconds</span><br/></a><a href="define-struct.html#%28tech._accessor%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">accessor</span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._acos%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">acos</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._add-between%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">add-between</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">add1</span></span><br/></a><a href="bytestrings.html#%28part._.Additional_.Byte_.String_.Functions%29" class="indexlink" data-pltdoc="x">Additional Byte String Functions<br/></a><a href="cont.html#%28part._.Additional_.Control_.Operators%29" class="indexlink" data-pltdoc="x">Additional Control Operators<br/></a><a href="pretty-print.html#%28part._.Additional_.Custom-.Output_.Support%29" class="indexlink" data-pltdoc="x">Additional Custom-Output Support<br/></a><a href="exns.html#%28part._.Additional_.Exception_.Functions%29" class="indexlink" data-pltdoc="x">Additional Exception Functions<br/></a><a href="hashtables.html#%28part._.Additional_.Hash_.Table_.Functions%29" class="indexlink" data-pltdoc="x">Additional Hash Table Functions<br/></a><a href="procedures.html#%28part._.Additional_.Higher-.Order_.Functions%29" class="indexlink" data-pltdoc="x">Additional Higher-Order Functions<br/></a><a href="keywords.html#%28part._.Additional_.Keyword_.Functions%29" class="indexlink" data-pltdoc="x">Additional Keyword Functions<br/></a><a href="pairs.html#%28part._.Additional_.List_.Functions_and_.Synonyms%29" class="indexlink" data-pltdoc="x">Additional List Functions and Synonyms<br/></a><a href="logging.html#%28part._.Additional_.Logging_.Functions%29" class="indexlink" data-pltdoc="x">Additional Logging Functions<br/></a><a href="match.html#%28part._.Additional_.Matching_.Forms%29" class="indexlink" data-pltdoc="x">Additional Matching Forms<br/></a><a href="os-lib.html" class="indexlink" data-pltdoc="x">Additional Operating System Functions<br/></a><a href="Delayed_Evaluation.html#%28part._.Additional_.Promise_.Kinds%29" class="indexlink" data-pltdoc="x">Additional Promise Kinds<br/></a><a href="require.html#%28part._.Additional_provide_.Forms%29" class="indexlink" data-pltdoc="x">Additional <span class="RktSym"><span class="RktStxLink">provide</span></span> Forms<br/></a><a href="require.html#%28part._.Additional_require_.Forms%29" class="indexlink" data-pltdoc="x">Additional <span class="RktSym"><span class="RktStxLink">require</span></span> Forms<br/></a><a href="sequences.html#%28part._.Additional_.Sequence_.Constructors%29" class="indexlink" data-pltdoc="x">Additional Sequence Constructors<br/></a><a href="sequences.html#%28part._more-sequences%29" class="indexlink" data-pltdoc="x">Additional Sequence Operations<br/></a><a href="strings.html#%28part._.Additional_.String_.Functions%29" class="indexlink" data-pltdoc="x">Additional String Functions<br/></a><a href="structutils.html#%28part._.Additional_.Structure_.Utilities%29" class="indexlink" data-pltdoc="x">Additional Structure Utilities<br/></a><a href="symbols.html#%28part._.Additional_.Symbol_.Functions%29" class="indexlink" data-pltdoc="x">Additional Symbol Functions<br/></a><a href="regexp.html#%28part._.Additional_.Syntactic_.Constraints%29" class="indexlink" data-pltdoc="x">Additional Syntactic Constraints<br/></a><a href="vectors.html#%28part._.Additional_.Vector_.Functions%29" class="indexlink" data-pltdoc="x">Additional Vector Functions<br/></a><a href="Filesystem.html#%28idx._%28gentag._340._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">addon-dir</span><br/></a><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._alarm-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">alarm-evt</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-defined-out%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">all-defined-out</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-from-out%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">all-from-out</span></span><br/></a><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._always-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">always-evt</span></span><br/></a><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">and</span></span><br/></a><a href="match.html#%28idx._%28gentag._215._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">and<br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">and/c</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._andmap%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">andmap</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._angle%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">angle</span></span><br/></a><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">any</span></span><br/></a><a href="Byte_and_String_Input.html#%28idx._%28gentag._266._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">any</span><br/></a><a href="Byte_and_String_Input.html#%28idx._%28gentag._267._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">any-one</span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">any/c</span></span><br/></a><a href="match.html#%28idx._%28gentag._218._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">app<br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._append%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">append</span></span><br/></a><a href="file-ports.html#%28idx._%28gentag._260._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">append</span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._append%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">append*</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._append-map%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">append-map</span></span><br/></a><a href="define-struct.html#%28idx._%28gentag._194._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">applicable structure<br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">apply</span></span><br/></a><a href="runtime.html#%28idx._%28gentag._419._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">arch</span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._argmax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">argmax</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._argmin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">argmin</span></span><br/></a><a href="generic-numbers.html#%28part._.Arithmetic%29" class="indexlink" data-pltdoc="x">Arithmetic<br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._arithmetic-shift%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">arithmetic-shift</span></span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">arity-at-least</span></span><br/></a><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._arity-at-least-value%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">arity-at-least-value</span></span><br/></a><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._arity-at-least~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">arity-at-least?</span></span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity-includes~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">arity-includes?</span></span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">arity=?</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._asin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">asin</span></span><br/></a><a href="unreachable.html#%28def._%28%28quote._~23~25kernel%29._assert-unreachable%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">assert-unreachable</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assf%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">assf</span></span><br/></a><a href="syntax-model.html#%28tech._assignment._transformer%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">assignment transformers</span><br/></a><a href="set_.html" class="indexlink" data-pltdoc="x">Assignment: <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-values</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assoc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">assoc</span></span><br/></a><a href="dicts.html#%28tech._association._list%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">association
+list</span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">assq</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">assv</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">assw</span></span><br/></a><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-get%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">async-channel-get</span></span><br/></a><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-put%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">async-channel-put</span></span><br/></a><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-put-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">async-channel-put-evt</span></span><br/></a><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel-try-get%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">async-channel-try-get</span></span><br/></a><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">async-channel/c</span></span><br/></a><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._async-channel~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">async-channel?</span></span><br/></a><a href="async-channel.html#%28tech._asynchronous._channel%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">asynchronous channel</span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._atan%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">atan</span></span><br/></a><a href="plumbers.html#%28idx._%28gentag._287._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">atexit</span><br/></a><a href="attaching-contracts-to-values.html" class="indexlink" data-pltdoc="x">Attaching Contracts to Values<br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">augment</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">augment*</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment-final%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">augment-final</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment-final%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">augment-final*</span></span><br/></a><a href="mzlib_class.html#%28tech._augmenting%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">augmenting</span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">augride</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">augride*</span></span><br/></a><a href="chaperones.html#%28tech._authentic%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">authentic</span><br/></a><a href="structures.html#%28tech._automatic._field%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">automatic fields</span><br/></a><a href="windowspaths.html#%28idx._%28gentag._296._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"AUX"</span><br/></a><a href="eval-model.html#%28tech._available%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">available</span><br/></a><a name="alpha:B"></a><span><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._banner%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">banner</span></span><br/></a></span><a href="syntax-model.html#%28tech._base._environment%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">base environment</span><br/></a><a href="syntax-model.html#%28tech._base._phase%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">base
+phase</span><br/></a><a href="pretty-print.html#%28part._.Basic_.Pretty-.Print_.Options%29" class="indexlink" data-pltdoc="x">Basic Pretty-Print Options<br/></a><a href="implementations.html#%28tech._bc%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">BC</span><br/></a><a href="compiler.html#%28part._3m-compiler-modes%29" class="indexlink" data-pltdoc="x">BC Compilation Modes<br/></a><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">begin</span></span><br/></a><a href="performance-hint.html#%28form._%28%28lib._racket%2Fperformance-hint..rkt%29._begin-encourage-inline%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">begin-encourage-inline</span></span><br/></a><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">begin-for-syntax</span></span><br/></a><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin0%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">begin0</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._between%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">between/c</span></span><br/></a><a href="file-ports.html#%28idx._%28gentag._251._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">binary</span><br/></a><a href="syntax-model.html#%28tech._binding%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">binding</span><br/></a><a href="syntax-model.html#%28tech._binding._space%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">binding space</span><br/></a><a href="syntax-model.html#%28tech._bind%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">binds</span><br/></a><a href="generic-numbers.html#%28part._.Bitwise_.Operations%29" class="indexlink" data-pltdoc="x">Bitwise Operations<br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-and%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bitwise-and</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-bit-field%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bitwise-bit-field</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-bit-set~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bitwise-bit-set?</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-ior%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bitwise-ior</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-not%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bitwise-not</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-xor%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bitwise-xor</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28part._.Blame_.Objects%29" class="indexlink" data-pltdoc="x">Blame Objects<br/></a><a href="Building_New_Contract_Combinators.html#%28tech._blame._object%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">blame objects</span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-add-context%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-add-context</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-add-missing-party%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-add-missing-party</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-context%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-context</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-contract</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-missing-party~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-missing-party?</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-negative%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-negative</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-original~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-original?</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-positive%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-positive</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-replace-negative%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-replace-negative</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-replaced-negative~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-replaced-negative?</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-source%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-source</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-swap%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-swap</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-swapped~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-swapped?</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-update%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-update</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame-value%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame-value</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._blame~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">blame?</span></span><br/></a><a href="block.html#%28form._%28%28lib._racket%2Fblock..rkt%29._block%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">block</span></span><br/></a><a href="port-buffers.html#%28idx._%28gentag._247._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">block</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._369._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">block-count</span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._block-device-type-bits%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">block-device-type-bits</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._368._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">block-size</span><br/></a><a href="block.html" class="indexlink" data-pltdoc="x">Blocks: <span class="RktSym"><span class="RktStxLink">block</span></span><br/></a><a href="booleans.html#%28part._.Boolean_.Aliases%29" class="indexlink" data-pltdoc="x">Boolean Aliases<br/></a><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._boolean~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">boolean=?</span></span><br/></a><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">boolean?</span></span><br/></a><a href="booleans.html" class="indexlink" data-pltdoc="x">Booleans<br/></a><a href="booleans.html#%28tech._boolean%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">booleans</span><br/></a><a href="syntax-model.html#%28tech._bound%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">bound</span><br/></a><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._bound-identifier~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bound-identifier=?</span></span><br/></a><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">box</span></span><br/></a><a href="match.html#%28idx._%28gentag._211._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">box<br/></a><a href="boxes.html#%28tech._box%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">box</span><br/></a><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box-cas%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">box-cas!</span></span><br/></a><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box-immutable%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">box-immutable</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fbox..rkt%29._box-immutable%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">box-immutable/c</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fbox..rkt%29._box%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">box/c</span></span><br/></a><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">box?</span></span><br/></a><a href="boxes.html" class="indexlink" data-pltdoc="x">Boxes<br/></a><a href="breakhandler.html#%28tech._break%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">break</span><br/></a><a href="breakhandler.html#%28def._%28%28quote._~23~25kernel%29._break-enabled%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">break-enabled</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._break-evaluator%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">break-evaluator</span></span><br/></a><a href="breakhandler.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._break-parameterization~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">break-parameterization?</span></span><br/></a><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._break-thread%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">break-thread</span></span><br/></a><a href="breakhandler.html" class="indexlink" data-pltdoc="x">Breaks<br/></a><a href="async-channel.html" class="indexlink" data-pltdoc="x">Buffered Asynchronous Channels<br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._build-chaperone-contract-property%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">build-chaperone-contract-property</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._build-collapsible-contract-property%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">build-collapsible-contract-property</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._build-compound-type-name%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">build-compound-type-name</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._build-contract-property%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">build-contract-property</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._build-flat-contract-property%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">build-flat-contract-property</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._build-list%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">build-list</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">build-path</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%2Fconvention-type%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">build-path/convention-type</span></span><br/></a><a href="strings.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._build-string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">build-string</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._build-vector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">build-vector</span></span><br/></a><a href="Building_New_Contract_Combinators.html" class="indexlink" data-pltdoc="x">Building New Contract Combinators<br/></a><a href="exns.html#%28part._.Built-in_.Exception_.Types%29" class="indexlink" data-pltdoc="x">Built-in Exception Types<br/></a><a href="Serializing_Syntax.html#%28tech._bulk._binding%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">bulk
+bindings</span><br/></a><a href="Byte_and_String_Input.html" class="indexlink" data-pltdoc="x">Byte and String Input<br/></a><a href="Byte_and_String_Output.html" class="indexlink" data-pltdoc="x">Byte and String Output<br/></a><a href="bytestrings.html#%28tech._byte._converter%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">byte converter</span><br/></a><a href="bytestrings.html#%28tech._byte._string%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">byte string</span><br/></a><a href="bytestrings.html#%28part._.Byte_.String_.Comparisons%29" class="indexlink" data-pltdoc="x">Byte String Comparisons<br/></a><a href="bytestrings.html#%28part._.Byte_.String_.Constructors__.Selectors__and_.Mutators%29" class="indexlink" data-pltdoc="x">Byte String Constructors, Selectors, and Mutators<br/></a><a href="reader.html#%28idx._%28gentag._35._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">byte strings, parsing<br/></a><a href="bytestrings.html#%28idx._%28gentag._140._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">byte strings, immutable<br/></a><a href="bytestrings.html#%28idx._%28gentag._141._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">byte strings, concatenate<br/></a><a href="bytestrings.html" class="indexlink" data-pltdoc="x">Byte Strings<br/></a><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-pregexp%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">byte-pregexp</span></span><br/></a><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-pregexp~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">byte-pregexp?</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._byte-ready~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">byte-ready?</span></span><br/></a><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">byte-regexp</span></span><br/></a><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">byte-regexp?</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">byte?</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes</span></span><br/></a><a href="bytestrings.html#%28idx._%28gentag._139._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">bytes<br/></a><a href="bytestrings.html#%28part._.Bytes_to_.Bytes_.Encoding_.Conversion%29" class="indexlink" data-pltdoc="x">Bytes to Bytes Encoding Conversion<br/></a><a href="bytestrings.html#%28part._.Bytes_to_from_.Characters__.Decoding_and_.Encoding%29" class="indexlink" data-pltdoc="x">Bytes to/from Characters, Decoding and Encoding<br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3eimmutable-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-&gt;immutable-bytes</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3elist%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-&gt;list</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-&gt;path</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath-element%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-&gt;path-element</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Flatin-1%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-&gt;string/latin-1</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Flocale%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-&gt;string/locale</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Futf-8%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-&gt;string/utf-8</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-append%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-append</span></span><br/></a><a href="bytestrings.html#%28def._%28%28lib._racket%2Fbytes..rkt%29._bytes-append%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-append*</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-close-converter%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-close-converter</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-convert%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-convert</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-convert-end%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-convert-end</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-converter~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-converter?</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-copy%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-copy</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-copy%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-copy!</span></span><br/></a><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._bytes-environment-variable-name~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-environment-variable-name?</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-fill%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-fill!</span></span><br/></a><a href="bytestrings.html#%28def._%28%28lib._racket%2Fbytes..rkt%29._bytes-join%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-join</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-length</span></span><br/></a><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._bytes-no-nuls~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-no-nuls?</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-open-converter</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-ref</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-set!</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-index%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-utf-8-index</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-utf-8-length</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-utf-8-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-utf-8-ref</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3c~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes&lt;?</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes=?</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3e~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes&gt;?</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes?</span></span><br/></a><a name="alpha:C"></a><span><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caaaar%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">caaaar</span></span><br/></a></span><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caaadr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">caaadr</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caaar%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">caaar</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caadar%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">caadar</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caaddr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">caaddr</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caadr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">caadr</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caar%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">caar</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._343._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">cache-dir</span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadaar%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cadaar</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadadr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cadadr</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadar%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cadar</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caddar%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">caddar</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadddr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cadddr</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caddr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">caddr</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cadr</span></span><br/></a><a href="eval-model.html#%28tech._call._by._value%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">call-by-value</span><br/></a><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-in-continuation%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-in-continuation</span></span><br/></a><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._call-in-nested-thread%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-in-nested-thread</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-in-sandbox-context%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-in-sandbox-context</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._call-with-atomic-output-file%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-atomic-output-file</span></span><br/></a><a href="breakhandler.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call-with-break-parameterization%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-break-parameterization</span></span><br/></a><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-composable-continuation%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-composable-continuation</span></span><br/></a><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-barrier%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-continuation-barrier</span></span><br/></a><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-prompt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-continuation-prompt</span></span><br/></a><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-current-continuation%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-current-continuation</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-custodian-shutdown%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-custodian-shutdown</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-deep-time-limit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-deep-time-limit</span></span><br/></a><a href="Reading.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._call-with-default-reading-parameterization%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-default-reading-parameterization</span></span><br/></a><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-escape-continuation%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-escape-continuation</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call-with-exception-handler%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-exception-handler</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._call-with-file-lock%2Ftimeout%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-file-lock/timeout</span></span><br/></a><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._call-with-immediate-continuation-mark%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-immediate-continuation-mark</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._call-with-input-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-input-bytes</span></span><br/></a><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-input-file%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-input-file</span></span><br/></a><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-input-file%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-input-file*</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._call-with-input-string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-input-string</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-killing-threads%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-killing-threads</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-limits%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-limits</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._call-with-output-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-output-bytes</span></span><br/></a><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-output-file%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-output-file</span></span><br/></a><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-output-file%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-output-file*</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._call-with-output-string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-output-string</span></span><br/></a><a href="parameters.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call-with-parameterization%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-parameterization</span></span><br/></a><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._call-with-semaphore%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-semaphore</span></span><br/></a><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._call-with-semaphore%2Fenable-break%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-semaphore/enable-break</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._call-with-trusted-sandbox-configuration%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-trusted-sandbox-configuration</span></span><br/></a><a href="values.html#%28def._%28%28quote._~23~25kernel%29._call-with-values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-with-values</span></span><br/></a><a href="cont.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call%2Fcc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call/cc</span></span><br/></a><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._call%2Fcomp%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call/comp</span></span><br/></a><a href="cont.html#%28def._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._call%2Fec%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call/ec</span></span><br/></a><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._call%2Fprompt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call/prompt</span></span><br/></a><a href="file-ports.html#%28idx._%28gentag._259._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">can-update</span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">car</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._cartesian-product%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cartesian-product</span></span><br/></a><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">case</span></span><br/></a><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._case-~3e%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">case-&gt;</span></span><br/></a><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._case-~3em%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">case-&gt;m</span></span><br/></a><a href="reader.html#%28idx._%28gentag._7._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">case-insensitive<br/></a><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">case-lambda</span></span><br/></a><a href="reader.html#%28idx._%28gentag._6._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">case-sensitivity<br/></a><a href="eval-model.html#%28tech._catch%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">catch</span><br/></a><a href="characters.html#%28idx._%28gentag._176._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">cc</span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdaaar%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cdaaar</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdaadr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cdaadr</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdaar%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cdaar</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdadar%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cdadar</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdaddr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cdaddr</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdadr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cdadr</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdar%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cdar</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddaar%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cddaar</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddadr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cddadr</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddar%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cddar</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdddar%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cdddar</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddddr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cddddr</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdddr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cdddr</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cddr</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cdr</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._ceiling%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">ceiling</span></span><br/></a><a href="stxcerts.html#%28idx._%28gentag._240._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">certify-mode</span><br/></a><a href="characters.html#%28idx._%28gentag._177._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">cf</span><br/></a><a href="implementations.html#%28tech._cgc%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">CGC</span><br/></a><a href="runtime.html#%28idx._%28gentag._425._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">cgc</span><br/></a><a href="reader.html#%28part._.Chaining_.Reader_.Language%29" class="indexlink" data-pltdoc="x">Chaining Reader Language<br/></a><a href="Filesystem.html#%28idx._%28gentag._376._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">change-time-nanoseconds</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._372._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">change-time-seconds</span><br/></a><a href="channel.html#%28tech._channel%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">channel</span><br/></a><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-get%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">channel-get</span></span><br/></a><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">channel-put</span></span><br/></a><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel-put-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">channel-put-evt</span></span><br/></a><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel-put-evt~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">channel-put-evt?</span></span><br/></a><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-try-get%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">channel-try-get</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._channel%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">channel/c</span></span><br/></a><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._channel~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">channel?</span></span><br/></a><a href="channel.html" class="indexlink" data-pltdoc="x">Channels<br/></a><a href="chaperones.html#%28tech._chaperone%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">chaperone</span><br/></a><a href="chaperones.html#%28part._.Chaperone_.Constructors%29" class="indexlink" data-pltdoc="x">Chaperone Constructors<br/></a><a href="Building_New_Contract_Combinators.html#%28tech._chaperone._contract._property%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">chaperone contract property</span><br/></a><a href="contracts.html#%28tech._chaperone._contract%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">Chaperone <span class="techoutside"><span class="techinside">contracts</span></span></span><br/></a><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._chaperone-async-channel%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-async-channel</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-box%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-box</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-channel%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-channel</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-continuation-mark-key%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-continuation-mark-key</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._chaperone-contract-property~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-contract-property?</span></span><br/></a><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._chaperone-contract~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-contract?</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-evt</span></span><br/></a><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._chaperone-generics%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">chaperone-generics</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-hash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-hash</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._chaperone-hash-set%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-hash-set</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-of~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-of?</span></span><br/></a><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._chaperone-procedure%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-procedure</span></span><br/></a><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._chaperone-procedure%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-procedure*</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-prompt-tag%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-prompt-tag</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-struct%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-struct</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-struct-type%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-struct-type</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._chaperone-struct-unsafe-undefined%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-struct-unsafe-undefined</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-vector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-vector</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-vector%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-vector*</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone?</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-~3einteger%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-&gt;integer</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-alphabetic~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-alphabetic?</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-blank~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-blank?</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3c~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-ci&lt;=?</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3c~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-ci&lt;?</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-ci=?</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3e~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-ci&gt;=?</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-ci~3e~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-ci&gt;?</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-downcase%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-downcase</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-foldcase%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-foldcase</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-general-category%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-general-category</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-graphic~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-graphic?</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._char-in%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-in</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-iso-control~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-iso-control?</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-lower-case~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-lower-case?</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-numeric~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-numeric?</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-punctuation~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-punctuation?</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._char-ready~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-ready?</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-symbolic~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-symbolic?</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-title-case~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-title-case?</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-titlecase%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-titlecase</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-upcase%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-upcase</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-upper-case~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-upper-case?</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-utf-8-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-utf-8-length</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-whitespace~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char-whitespace?</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3c~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char&lt;=?</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3c~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char&lt;?</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char=?</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3e~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char&gt;=?</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3e~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char&gt;?</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">char?</span></span><br/></a><a href="characters.html#%28part._.Character_.Comparisons%29" class="indexlink" data-pltdoc="x">Character Comparisons<br/></a><a href="characters.html#%28part._.Character_.Conversions%29" class="indexlink" data-pltdoc="x">Character Conversions<br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._character-device-type-bits%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">character-device-type-bits</span></span><br/></a><a href="characters.html" class="indexlink" data-pltdoc="x">Characters<br/></a><a href="characters.html#%28tech._character%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">Characters</span><br/></a><a href="characters.html#%28part._.Characters_and_.Scalar_.Values%29" class="indexlink" data-pltdoc="x">Characters and Scalar Values<br/></a><a href="stxcmp.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._check-duplicate-identifier%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">check-duplicate-identifier</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._check-duplicates%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">check-duplicates</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._check-not-unsafe-undefined%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">check-not-unsafe-undefined</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._check-not-unsafe-undefined%2Fassign%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">check-not-unsafe-undefined/assign</span></span><br/></a><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._checked-procedure-check-and-extract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">checked-procedure-check-and-extract</span></span><br/></a><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._checked-struct-info~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">checked-struct-info?</span></span><br/></a><a href="runtime.html#%28idx._%28gentag._423._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">chez-scheme</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._355._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">chmod<br/></a><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._choice-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">choice-evt</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">class</span></span><br/></a><a href="mzlib_class.html#%28tech._clas%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">class</span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">class*</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-~3einterface%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">class-&gt;interface</span></span><br/></a><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-field-accessor%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">class-field-accessor</span></span><br/></a><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-field-mutator%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">class-field-mutator</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-info%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">class-info</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-seal%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">class-seal</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-unseal%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">class-unseal</span></span><br/></a><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._class%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">class/c</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2Fderived%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">class/derived</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">class?</span></span><br/></a><a href="mzlib_class.html" class="indexlink" data-pltdoc="x">Classes and Objects<br/></a><a href="characters.html#%28part._.Classifications%29" class="indexlink" data-pltdoc="x">Classifications<br/></a><a href="pathutils.html#%28tech._cleanse%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">cleanse</span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._cleanse-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cleanse-path</span></span><br/></a><a href="securityguards.html#%28idx._%28gentag._285._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">client</span><br/></a><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-input-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">close-input-port</span></span><br/></a><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-output-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">close-output-port</span></span><br/></a><a href="characters.html#%28idx._%28gentag._180._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">cn</span><br/></a><a href="characters.html#%28idx._%28gentag._179._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">co</span><br/></a><a href="modprotect.html" class="indexlink" data-pltdoc="x">Code Inspectors<br/></a><a href="modprotect.html#%28tech._code._inspector%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">code
+inspectors</span><br/></a><a href="characters.html#%28idx._%28gentag._150._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">code point<br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-chaperone-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">coerce-chaperone-contract</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-chaperone-contracts%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">coerce-chaperone-contracts</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">coerce-contract</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-contract%2Ff%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">coerce-contract/f</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-contracts%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">coerce-contracts</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-flat-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">coerce-flat-contract</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._coerce-flat-contracts%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">coerce-flat-contracts</span></span><br/></a><a href="collapsible.html#%28tech._collapsible._contract._property%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">collapsible contract property</span><br/></a><a href="collapsible.html" class="indexlink" data-pltdoc="x">Collapsible Contracts<br/></a><a href="collapsible.html#%28tech._collapsible._contract%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">Collapsible contracts</span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._collapsible-contract-continuation-mark-key%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-contract-continuation-mark-key</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract-property~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-contract-property?</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-contract~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-contract?</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-count-property%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-count-property</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-count-property-count%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-count-property-count</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-count-property-prev%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-count-property-prev</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-count-property~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-count-property?</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-guard%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-guard</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-ho%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-ho/c</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-ho%2Fc-latest-blame%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-ho/c-latest-blame</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-ho%2Fc-latest-ctc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-ho/c-latest-ctc</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-ho%2Fc-missing-party%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-ho/c-missing-party</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-ho%2Fc~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-ho/c?</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-leaf%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-leaf/c</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-leaf%2Fc-blame-list%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-leaf/c-blame-list</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-leaf%2Fc-contract-list%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-leaf/c-contract-list</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-leaf%2Fc-missing-party-list%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-leaf/c-missing-party-list</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-leaf%2Fc-proj-list%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-leaf/c-proj-list</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-leaf%2Fc~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-leaf/c?</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-property%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-property</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-property-c-c%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-property-c-c</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-property-neg-party%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-property-neg-party</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-property-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-property-ref</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-property~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-property?</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-wrapper-property%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-wrapper-property</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-wrapper-property-checking-wrapper%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-wrapper-property-checking-wrapper</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._collapsible-wrapper-property~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collapsible-wrapper-property?</span></span><br/></a><a href="garbagecollection.html#%28def._%28%28quote._~23~25kernel%29._collect-garbage%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collect-garbage</span></span><br/></a><a href="collects.html#%28part._links-file%29" class="indexlink" data-pltdoc="x">Collection Links<br/></a><a href="collects.html#%28tech._collection._links._file%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">Collection links files</span><br/></a><a href="collects.html#%28part._collects-api%29" class="indexlink" data-pltdoc="x">Collection Paths and Parameters<br/></a><a href="collects.html#%28part._collects-search%29" class="indexlink" data-pltdoc="x">Collection Search Configuration<br/></a><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-file-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collection-file-path</span></span><br/></a><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collection-path</span></span><br/></a><a href="collects.html#%28tech._collection%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">collections</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._350._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">collects-dir</span><br/></a><a href="linecol.html#%28tech._column._location%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">column
+locations</span><br/></a><a href="linecol.html" class="indexlink" data-pltdoc="x">column numbers<br/></a><a href="windowspaths.html#%28idx._%28gentag._297._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"COM1"</span><br/></a><a href="windowspaths.html#%28idx._%28gentag._298._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"COM2"</span><br/></a><a href="windowspaths.html#%28idx._%28gentag._299._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"COM3"</span><br/></a><a href="windowspaths.html#%28idx._%28gentag._300._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"COM4"</span><br/></a><a href="windowspaths.html#%28idx._%28gentag._301._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"COM5"</span><br/></a><a href="windowspaths.html#%28idx._%28gentag._302._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"COM6"</span><br/></a><a href="windowspaths.html#%28idx._%28gentag._303._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"COM7"</span><br/></a><a href="windowspaths.html#%28idx._%28gentag._304._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"COM8"</span><br/></a><a href="windowspaths.html#%28idx._%28gentag._305._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"COM9"</span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._combinations%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">combinations</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._combine-in%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">combine-in</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._combine-out%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">combine-out</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._combine-output%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">combine-output</span></span><br/></a><a href="running-sa.html#%28part._mz-cmdline%29" class="indexlink" data-pltdoc="x">Command Line<br/></a><a href="Command-Line_Parsing.html#%28form._%28%28lib._racket%2Fcmdline..rkt%29._command-line%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">command-line</span></span><br/></a><a href="Command-Line_Parsing.html" class="indexlink" data-pltdoc="x">Command-Line Parsing<br/></a><a href="ports.html#%28tech._commit%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">committed</span><br/></a><a href="syntax-model.html#%28part._compilation-model%29" class="indexlink" data-pltdoc="x">Compilation<br/></a><a href="eval.html#%28tech._compilation._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">compilation handler</span><br/></a><a href="compiler.html#%28part._compiler-modes%29" class="indexlink" data-pltdoc="x">Compilation Modes<br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compile</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-allow-set%21-undefined%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compile-allow-set!-undefined</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-context-preservation-enabled%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compile-context-preservation-enabled</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-enforce-module-constants%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compile-enforce-module-constants</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._compile-linklet%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compile-linklet</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compile-syntax</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-target-machine~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compile-target-machine?</span></span><br/></a><a href="syntax-model.html#%28tech._compiled%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">compiled</span><br/></a><a href="Module_Names_and_Loading.html#%28part._modpathidx%29" class="indexlink" data-pltdoc="x">Compiled Modules and References<br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compiled-expression-recompile%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compiled-expression-recompile</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compiled-expression~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compiled-expression?</span></span><br/></a><a href="eval.html#%28tech._compiled._load._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">compiled-load
+handler</span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._compiled-module-expression~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compiled-module-expression?</span></span><br/></a><a href="define.html#%28idx._%28gentag._109._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">compiler-hint:cross-module-inline</span><br/></a><a href="bytestrings.html#%28idx._%28gentag._143._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">complete</span><br/></a><a href="bytestrings.html#%28idx._%28gentag._147._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">complete</span><br/></a><a href="Manipulating_Paths.html#%28tech._complete%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">complete</span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">complete-path?</span></span><br/></a><a href="places.html#%28tech._completion._value%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">completion value</span><br/></a><a href="generic-numbers.html#%28part._.Complex_.Numbers%29" class="indexlink" data-pltdoc="x">Complex Numbers<br/></a><a href="numbers.html#%28tech._complex._number%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">complex numbers</span><br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._complex~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">complex?</span></span><br/></a><a href="eval-model.html#%28tech._composable._continuation%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">composable continuation</span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._compose%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compose</span></span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._compose1%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compose1</span></span><br/></a><a href="compoundunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">compound-unit</span></span><br/></a><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%2Finfer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">compound-unit/infer</span></span><br/></a><a href="windowspaths.html#%28idx._%28gentag._294._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"CON"</span><br/></a><a href="concurrency.html" class="indexlink" data-pltdoc="x">Concurrency and Parallelism<br/></a><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">cond</span></span><br/></a><a href="if.html" class="indexlink" data-pltdoc="x">Conditionals: <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._337._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">config-dir</span><br/></a><a href="running-sa.html#%28tech._configuration._option%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">Configuration options</span><br/></a><a href="running-sa.html#%28idx._%28gentag._561._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">configure-runtime</span><br/></a><a href="exns.html#%28part._.Configuring_.Default_.Handling%29" class="indexlink" data-pltdoc="x">Configuring Default Handling<br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._conjoin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">conjoin</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._conjugate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">conjugate</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cons</span></span><br/></a><a href="match.html#%28idx._%28gentag._209._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">cons<br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cons/c</span></span><br/></a><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fdc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">cons/dc</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._cons~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cons?</span></span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._const%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">const</span></span><br/></a><a href="shared.html" class="indexlink" data-pltdoc="x">Constructing Graphs: <span class="RktSym"><span class="RktStxLink">shared</span></span><br/></a><a href="define-struct.html#%28tech._constructor%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">constructor</span><br/></a><a href="syntax-model.html#%28tech._context%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">context</span><br/></a><a href="eval-model.html#%28tech._continuation%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">continuation</span><br/></a><a href="eval-model.html#%28tech._continuation._barrier%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">continuation barrier</span><br/></a><a href="eval-model.html#%28tech._continuation._frame%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">continuation frames</span><br/></a><a href="eval-model.html#%28part._mark-model%29" class="indexlink" data-pltdoc="x">Continuation Frames and Marks<br/></a><a href="contmarks.html" class="indexlink" data-pltdoc="x">Continuation Marks<br/></a><a href="eval-model.html#%28tech._continuation._mark%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">continuation marks</span><br/></a><a href="wcm.html" class="indexlink" data-pltdoc="x">Continuation Marks: <span class="RktSym"><span class="RktStxLink">with-continuation-mark</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._continuation-mark-key%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-mark-key/c</span></span><br/></a><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-key~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-mark-key?</span></span><br/></a><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3econtext%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-mark-set-&gt;context</span></span><br/></a><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3eiterator%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-mark-set-&gt;iterator</span></span><br/></a><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3elist%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-mark-set-&gt;list</span></span><br/></a><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3elist%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-mark-set-&gt;list*</span></span><br/></a><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-first%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-mark-set-first</span></span><br/></a><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-mark-set?</span></span><br/></a><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-marks%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-marks</span></span><br/></a><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-available~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-prompt-available?</span></span><br/></a><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation-prompt-tag~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation-prompt-tag?</span></span><br/></a><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">continuation?</span></span><br/></a><a href="cont.html" class="indexlink" data-pltdoc="x">Continuations<br/></a><a href="bytestrings.html#%28idx._%28gentag._144._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">continues</span><br/></a><a href="bytestrings.html#%28idx._%28gentag._148._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">continues</span><br/></a><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">contract</span></span><br/></a><a href="contracts.html#%28tech._contract._combinator%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">Contract combinators</span><br/></a><a href="Building_New_Contract_Combinators.html#%28tech._contract._property%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">contract property</span><br/></a><a href="contract-utilities.html" class="indexlink" data-pltdoc="x">Contract Utilities<br/></a><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-continuation-mark-key%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-continuation-mark-key</span></span><br/></a><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-custom-write-property-proc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-custom-write-property-proc</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-equivalent~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-equivalent?</span></span><br/></a><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-exercise%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-exercise</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-first-order%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-first-order</span></span><br/></a><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._contract-first-order-okay-to-give-up~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym">contract-first-order-okay-to-give-up?</span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-first-order-passes~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-first-order-passes?</span></span><br/></a><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._contract-first-order-try-less-hard%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym">contract-first-order-try-less-hard</span><br/></a><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-late-neg-projection%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-late-neg-projection</span></span><br/></a><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-name%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-name</span></span><br/></a><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._contract-out%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">contract-out</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-pos%2Fneg-doubling%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">contract-pos/neg-doubling</span></span><br/></a><a href="Legacy_Contracts.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-proc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-proc</span></span><br/></a><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-projection%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-projection</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._contract-property~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-property?</span></span><br/></a><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-random-generate</span></span><br/></a><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-env~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-random-generate-env?</span></span><br/></a><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-fail%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-random-generate-fail</span></span><br/></a><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-fail~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-random-generate-fail?</span></span><br/></a><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-get-current-environment%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-random-generate-get-current-environment</span></span><br/></a><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate-stash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-random-generate-stash</span></span><br/></a><a href="Random_generation.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._contract-random-generate%2Fchoose%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-random-generate/choose</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-stronger~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-stronger?</span></span><br/></a><a href="Lazy_Data-structure_Contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fds..rkt%29._contract-struct%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">contract-struct</span></span><br/></a><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract-val-first-projection%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract-val-first-projection</span></span><br/></a><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">contract?</span></span><br/></a><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._contracted%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">contracted</span></span><br/></a><a href="dicts.html#%28part._.Contracted_.Dictionaries%29" class="indexlink" data-pltdoc="x">Contracted Dictionaries<br/></a><a href="contracts.html" class="indexlink" data-pltdoc="x">Contracts<br/></a><a href="contracts.html#%28tech._contract%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">Contracts</span><br/></a><a href="async-channel.html#%28part._.Contracts_and_.Impersonators_on_.Asynchronous_.Channels%29" class="indexlink" data-pltdoc="x">Contracts and Impersonators on Asynchronous Channels<br/></a><a href="Building_New_Contract_Combinators.html#%28part._.Contracts_as_structs%29" class="indexlink" data-pltdoc="x">Contracts as structs<br/></a><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">control</span></span><br/></a><a href="control.html" class="indexlink" data-pltdoc="x">Control Flow<br/></a><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control-at%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">control-at</span></span><br/></a><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control0%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">control0</span></span><br/></a><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._control0-at%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">control0-at</span></span><br/></a><a href="compiler.html" class="indexlink" data-pltdoc="x">Controlling and Inspecting Compilation<br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._convert-relative-module-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">convert-relative-module-path</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._convert-stream%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">convert-stream</span></span><br/></a><a href="strings.html#%28part._format%29" class="indexlink" data-pltdoc="x">Converting Values to Strings<br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._copy-directory%2Ffiles%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">copy-directory/files</span></span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._copy-file%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">copy-file</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._copy-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">copy-port</span></span><br/></a><a href="struct-copy.html" class="indexlink" data-pltdoc="x">Copying and Updating Structures<br/></a><a href="port-lib.html#%28part._.Copying_.Streams%29" class="indexlink" data-pltdoc="x">Copying Streams<br/></a><a href="syntax-model.html#%28tech._core._form%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">core form</span><br/></a><a href="linklets.html#%28tech._correlated._object%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">correlated objects</span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-~3edatum%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">correlated-&gt;datum</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-column%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">correlated-column</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-e%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">correlated-e</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-line%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">correlated-line</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-position%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">correlated-position</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-property%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">correlated-property</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-property-symbol-keys%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">correlated-property-symbol-keys</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-source%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">correlated-source</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-span%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">correlated-span</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">correlated?</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._cos%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cos</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._cosh%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cosh</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._count%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">count</span></span><br/></a><a href="collapsible.html#%28tech._count._property%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">count property</span><br/></a><a href="linecol.html" class="indexlink" data-pltdoc="x">Counting Positions, Lines, and Columns<br/></a><a href="futures.html#%28part._.Creating_and_.Touching_.Futures%29" class="indexlink" data-pltdoc="x">Creating and Touching Futures<br/></a><a href="async-channel.html#%28part._.Creating_and_.Using_.Asynchronous_.Channels%29" class="indexlink" data-pltdoc="x">Creating and Using Asynchronous Channels<br/></a><a href="createclass.html" class="indexlink" data-pltdoc="x">Creating Classes<br/></a><a href="syntax-util.html#%28part._.Creating_formatted_identifiers%29" class="indexlink" data-pltdoc="x">Creating formatted identifiers<br/></a><a href="createinterface.html" class="indexlink" data-pltdoc="x">Creating Interfaces<br/></a><a href="logging.html#%28part._.Creating_.Loggers%29" class="indexlink" data-pltdoc="x">Creating Loggers<br/></a><a href="objcreation.html" class="indexlink" data-pltdoc="x">Creating Objects<br/></a><a href="port-lib.html#%28part._.Creating_.Ports%29" class="indexlink" data-pltdoc="x">Creating Ports<br/></a><a href="creatingmorestructs.html" class="indexlink" data-pltdoc="x">Creating Structure Types<br/></a><a href="threads.html#%28part._.Creating_.Threads%29" class="indexlink" data-pltdoc="x">Creating Threads<br/></a><a href="creatingunits.html" class="indexlink" data-pltdoc="x">Creating Units<br/></a><a href="Filesystem.html#%28idx._%28gentag._377._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">creation-time-nanoseconds</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._373._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">creation-time-seconds</span><br/></a><a href="runtime.html#%28idx._%28gentag._442._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">cross</span><br/></a><a href="eval-model.html#%28tech._cross._phase._persistent%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">cross-phase persistent</span><br/></a><a href="syntax-model.html#%28part._cross-phase._persistent-grammar%29" class="indexlink" data-pltdoc="x">Cross-Phase Persistent Module Declarations<br/></a><a href="eval-model.html#%28part._cross-phase._persistent-modules%29" class="indexlink" data-pltdoc="x">Cross-Phase Persistent Modules<br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Frandom..rkt%29._crypto-random-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">crypto-random-bytes</span></span><br/></a><a href="sha.html" class="indexlink" data-pltdoc="x">Cryptographic Hashing<br/></a><a href="implementations.html#%28tech._c%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">CS</span><br/></a><a href="characters.html#%28idx._%28gentag._178._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">cs</span><br/></a><a href="runtime.html#%28idx._%28gentag._427._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">cs</span><br/></a><a href="compiler.html#%28part._cs-compiler-modes%29" class="indexlink" data-pltdoc="x">CS Compilation Modes<br/></a><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._cupto%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">cupto</span></span><br/></a><a href="eval-model.html#%28tech._current._custodian%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">current
+custodian</span><br/></a><a href="logging.html#%28tech._current._logger%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">current logger</span><br/></a><a href="syntax-model.html#%28tech._current._namespace%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">current namespace</span><br/></a><a href="plumbers.html#%28tech._current._plumber%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">current plumber</span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._current-blame-format%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-blame-format</span></span><br/></a><a href="breakhandler.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._current-break-parameterization%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-break-parameterization</span></span><br/></a><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-code-inspector</span></span><br/></a><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._current-command-line-arguments%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-command-line-arguments</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._560._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-command-line-arguments</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-compile</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile-realm%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-compile-realm</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile-target-machine%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-compile-target-machine</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compiled-file-roots%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-compiled-file-roots</span></span><br/></a><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-continuation-marks</span></span><br/></a><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._current-contract-region%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">current-contract-region</span></span><br/></a><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._current-custodian%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-custodian</span></span><br/></a><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._current-date%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-date</span></span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-directory</span></span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory-for-user%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-directory-for-user</span></span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-drive%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-drive</span></span><br/></a><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._current-environment-variables%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-environment-variables</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._current-error-message-adjuster%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-error-message-adjuster</span></span><br/></a><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-error-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-error-port</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-eval%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-eval</span></span><br/></a><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._current-evt-pseudo-random-generator%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-evt-pseudo-random-generator</span></span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-force-delete-permissions%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-force-delete-permissions</span></span><br/></a><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._current-future%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-future</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-gc-milliseconds%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-gc-milliseconds</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-get-interaction-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-get-interaction-evt</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-get-interaction-input-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-get-interaction-input-port</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-inexact-milliseconds%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-inexact-milliseconds</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-inexact-monotonic-milliseconds%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-inexact-monotonic-milliseconds</span></span><br/></a><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-input-port</span></span><br/></a><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._current-inspector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-inspector</span></span><br/></a><a href="interaction-info.html#%28def._%28%28lib._racket%2Finteraction-info..rkt%29._current-interaction-info%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym">current-interaction-info</span><br/></a><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-links%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-library-collection-links</span></span><br/></a><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-library-collection-paths</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-load</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-extension%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-load-extension</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-load-relative-directory</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load%2Fuse-compiled%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-load/use-compiled</span></span><br/></a><a href="encodings.html#%28def._%28%28quote._~23~25kernel%29._current-locale%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-locale</span></span><br/></a><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._current-logger%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-logger</span></span><br/></a><a href="garbagecollection.html#%28def._%28%28quote._~23~25kernel%29._current-memory-use%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-memory-use</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-milliseconds%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-milliseconds</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-declare-name%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-module-declare-name</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-declare-source%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-module-declare-source</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-name-resolver%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-module-name-resolver</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-path-for-load%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-module-path-for-load</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-namespace</span></span><br/></a><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-output-port</span></span><br/></a><a href="parameters.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._current-parameterization%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-parameterization</span></span><br/></a><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._current-plumber%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-plumber</span></span><br/></a><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-prefix-in%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-prefix-in</span></span><br/></a><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-prefix-out%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-prefix-out</span></span><br/></a><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._current-preserved-thread-cell-values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-preserved-thread-cell-values</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-print%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-print</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-process-milliseconds%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-process-milliseconds</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-prompt-read%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-prompt-read</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._current-pseudo-random-generator%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-pseudo-random-generator</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-read-interaction%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-read-interaction</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-reader-guard%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-reader-guard</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-readtable%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-readtable</span></span><br/></a><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._current-recorded-disappeared-uses%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-recorded-disappeared-uses</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._current-require-module-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-require-module-path</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-seconds%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-seconds</span></span><br/></a><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._current-security-guard%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-security-guard</span></span><br/></a><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._current-subprocess-custodian-mode%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-subprocess-custodian-mode</span></span><br/></a><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._current-subprocess-keep-file-descriptors%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-subprocess-keep-file-descriptors</span></span><br/></a><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._current-syntax-context%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-syntax-context</span></span><br/></a><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._current-thread%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-thread</span></span><br/></a><a href="threadgroups.html#%28def._%28%28quote._~23~25kernel%29._current-thread-group%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-thread-group</span></span><br/></a><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._current-thread-initial-stack-size%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-thread-initial-stack-size</span></span><br/></a><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-notify%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-trace-notify</span></span><br/></a><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-args%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-trace-print-args</span></span><br/></a><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._current-trace-print-results%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-trace-print-results</span></span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._current-write-relative-directory%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-write-relative-directory</span></span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">curry</span></span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curryr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">curryr</span></span><br/></a><a href="eval-model.html#%28tech._custodian%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">custodian</span><br/></a><a href="eval-model.html#%28tech._custodian._box%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">custodian box</span><br/></a><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-box-value%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custodian-box-value</span></span><br/></a><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-box~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custodian-box?</span></span><br/></a><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-limit-memory%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custodian-limit-memory</span></span><br/></a><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-managed-list%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custodian-managed-list</span></span><br/></a><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-memory-accounting-available~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custodian-memory-accounting-available?</span></span><br/></a><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-require-memory%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custodian-require-memory</span></span><br/></a><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-shut-down~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custodian-shut-down?</span></span><br/></a><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-shutdown-all%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custodian-shutdown-all</span></span><br/></a><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custodian?</span></span><br/></a><a href="eval-model.html#%28part._custodian-model%29" class="indexlink" data-pltdoc="x">Custodians<br/></a><a href="custodians.html" class="indexlink" data-pltdoc="x">Custodians<br/></a><a href="sets.html#%28part._.Custom_.Hash_.Sets%29" class="indexlink" data-pltdoc="x">Custom Hash Sets<br/></a><a href="dicts.html#%28part._.Custom_.Hash_.Tables%29" class="indexlink" data-pltdoc="x">Custom Hash Tables<br/></a><a href="customport.html" class="indexlink" data-pltdoc="x">Custom Ports<br/></a><a href="customport.html#%28tech._custom._port%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">custom ports</span><br/></a><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._custom-print-quotable-accessor%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custom-print-quotable-accessor</span></span><br/></a><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._custom-print-quotable~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custom-print-quotable?</span></span><br/></a><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._custom-write-accessor%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custom-write-accessor</span></span><br/></a><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._custom-write~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">custom-write?</span></span><br/></a><a href="unreachable.html#%28part._with-unreachable%29" class="indexlink" data-pltdoc="x">Customized Unreachable Reporting<br/></a><a href="Sandboxed_Evaluation.html#%28part._.Customizing_.Evaluators%29" class="indexlink" data-pltdoc="x">Customizing Evaluators<br/></a><a name="alpha:D"></a><span><a href="data-structure-contracts.html" class="indexlink" data-pltdoc="x">Data-structure Contracts<br/></a></span><a href="data.html" class="indexlink" data-pltdoc="x">Datatypes<br/></a><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date</span></span><br/></a><a href="time.html#%28part._date-string%29" class="indexlink" data-pltdoc="x">Date Utilities<br/></a><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date*</span></span><br/></a><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date%2A-~3eseconds%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date*-&gt;seconds</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date%2A-nanosecond%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date*-nanosecond</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date%2A-time-zone-name%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date*-time-zone-name</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date%2A~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date*?</span></span><br/></a><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date-~3ejulian%2Fscaliger%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date-&gt;julian/scaliger</span></span><br/></a><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date-~3ejulian%2Fscalinger%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date-&gt;julian/scalinger</span></span><br/></a><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date-~3eseconds%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date-&gt;seconds</span></span><br/></a><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date-~3estring%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date-&gt;string</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date-day%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date-day</span></span><br/></a><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date-display-format%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date-display-format</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date-dst~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date-dst?</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date-hour%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date-hour</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date-minute%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date-minute</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date-month%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date-month</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date-second%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date-second</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date-time-zone-offset%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date-time-zone-offset</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date-week-day%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date-week-day</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date-year%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date-year</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date-year-day%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date-year-day</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date?</span></span><br/></a><a href="reader.html#%28tech._datum%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">datum</span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._datum-~3ecorrelated%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">datum-&gt;correlated</span></span><br/></a><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">datum-&gt;syntax</span></span><br/></a><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-intern-literal%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">datum-intern-literal</span></span><br/></a><a href="debugging.html" class="indexlink" data-pltdoc="x">Debugging<br/></a><a href="eval-model.html#%28tech._declare%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">declared</span><br/></a><a href="Filesystem.html#%28part._runtime-path%29" class="indexlink" data-pltdoc="x">Declaring Paths Needed at Run Time<br/></a><a href="Sandboxed_Evaluation.html#%28tech._deep._time%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">Deep time</span><br/></a><a href="syntax-model.html#%28tech._default._binding._space%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">default binding space</span><br/></a><a href="struct-generics.html#%28tech._default._method%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">default method</span><br/></a><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">default-continuation-prompt-tag</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._default-language-readers%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">default-language-readers</span></span><br/></a><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define</span></span><br/></a><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-compound-unit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-compound-unit</span></span><br/></a><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-compound-unit%2Finfer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-compound-unit/infer</span></span><br/></a><a href="Lazy_Data-structure_Contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fds..rkt%29._define-contract-struct%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-contract-struct</span></span><br/></a><a href="dicts.html#%28form._%28%28lib._racket%2Fdict..rkt%29._define-custom-hash-types%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-custom-hash-types</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._define-custom-set-types%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-custom-set-types</span></span><br/></a><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-for-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-for-syntax</span></span><br/></a><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._define-generics%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-generics</span></span><br/></a><a href="performance-hint.html#%28form._%28%28lib._racket%2Fperformance-hint..rkt%29._define-inline%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-inline</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-local-member-name%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-local-member-name</span></span><br/></a><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._define-logger%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-logger</span></span><br/></a><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._define-match-expander%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-match-expander</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-member-name%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-member-name</span></span><br/></a><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fprovide..rkt%29._define-module-boundary-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-module-boundary-contract</span></span><br/></a><a href="Namespaces.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-namespace-anchor%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-namespace-anchor</span></span><br/></a><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fopt..rkt%29._define-opt%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-opt/c</span></span><br/></a><a href="define.html#%28form._%28%28lib._racket%2Fprovide-syntax..rkt%29._define-provide-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-provide-syntax</span></span><br/></a><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._define-rename-transformer-parameter%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-rename-transformer-parameter</span></span><br/></a><a href="define.html#%28form._%28%28lib._racket%2Frequire-syntax..rkt%29._define-require-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-require-syntax</span></span><br/></a><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-module-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-runtime-module-path</span></span><br/></a><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-module-path-index%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-runtime-module-path-index</span></span><br/></a><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-runtime-path</span></span><br/></a><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path-list%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-runtime-path-list</span></span><br/></a><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-paths%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-runtime-paths</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-sequence-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-sequence-syntax</span></span><br/></a><a href="objectserialize.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-serializable-class%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-serializable-class</span></span><br/></a><a href="objectserialize.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-serializable-class%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-serializable-class*</span></span><br/></a><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._define-serializable-struct%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-serializable-struct</span></span><br/></a><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._define-serializable-struct%2Fversions%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-serializable-struct/versions</span></span><br/></a><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-signature</span></span><br/></a><a href="define-sig-form.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature-form%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-signature-form</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-splicing-for-clause-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-splicing-for-clause-syntax</span></span><br/></a><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-struct%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-struct</span></span><br/></a><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define-struct%2Fcontract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-struct/contract</span></span><br/></a><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-struct%2Fderived%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-struct/derived</span></span><br/></a><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-syntax</span></span><br/></a><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._define-syntax-parameter%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-syntax-parameter</span></span><br/></a><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._define-syntax-rule%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-syntax-rule</span></span><br/></a><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-syntaxes</span></span><br/></a><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-unit</span></span><br/></a><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit-binding%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-unit-binding</span></span><br/></a><a href="Generating_A_Unit_from_Context.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit-from-context%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-unit-from-context</span></span><br/></a><a href="unitcontracts.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%2Fcontract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-unit/contract</span></span><br/></a><a href="Structural_Matching.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%2Fnew-import-export%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-unit/new-import-export</span></span><br/></a><a href="Structural_Matching.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%2Fs%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-unit/s</span></span><br/></a><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-values</span></span><br/></a><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-values-for-export%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-values-for-export</span></span><br/></a><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fdefine..rkt%29._define-values-for-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-values-for-syntax</span></span><br/></a><a href="invokingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-values%2Finvoke-unit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-values/invoke-unit</span></span><br/></a><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-values%2Finvoke-unit%2Finfer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-values/invoke-unit/infer</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Faugment%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/augment</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Faugment-final%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/augment-final</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Faugride%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/augride</span></span><br/></a><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/contract</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._define%2Ffinal-prop%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/final-prop</span></span><br/></a><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._define%2Fgeneric%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/generic</span></span><br/></a><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._define%2Fmatch%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/match</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Foverment%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/overment</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Foverride%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/override</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Foverride-final%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/override-final</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fprivate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/private</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/public</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic-final%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/public-final</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpubment%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/pubment</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._define%2Fsubexpression-pos-prop%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/subexpression-pos-prop</span></span><br/></a><a href="syntax-util.html#%28form._%28%28lib._racket%2Fsyntax..rkt%29._define%2Fwith-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/with-syntax</span></span><br/></a><a href="define-struct.html" class="indexlink" data-pltdoc="x">Defining Structure Types: <span class="RktSym"><span class="RktStxLink">struct</span></span><br/></a><a href="define.html" class="indexlink" data-pltdoc="x">Definitions: <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-syntax</span></span>, ...<br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._degrees-~3eradians%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">degrees-&gt;radians</span></span><br/></a><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">delay</span></span><br/></a><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fidle%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">delay/idle</span></span><br/></a><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fname%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">delay/name</span></span><br/></a><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fstrict%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">delay/strict</span></span><br/></a><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fsync%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">delay/sync</span></span><br/></a><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fthread%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">delay/thread</span></span><br/></a><a href="Delayed_Evaluation.html" class="indexlink" data-pltdoc="x">Delayed Evaluation<br/></a><a href="securityguards.html#%28idx._%28gentag._283._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">delete</span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._delete-directory%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">delete-directory</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._delete-directory%2Ffiles%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">delete-directory/files</span></span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._delete-file%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">delete-file</span></span><br/></a><a href="eval-model.html#%28tech._delimited._continuation%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">delimited continuation</span><br/></a><a href="reader.html#%28tech._delimiter%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">delimiters</span><br/></a><a href="reader.html#%28part._default-readtable-dispatch%29" class="indexlink" data-pltdoc="x">Delimiters and Dispatch<br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._denominator%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">denominator</span></span><br/></a><a href="stx-patterns.html#%28tech._depth._marker%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">depth marker</span><br/></a><a href="mzlib_class.html#%28tech._derived._clas%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">derived class</span><br/></a><a href="dicts.html#%28part._derived-dict-methods%29" class="indexlink" data-pltdoc="x">Derived Dictionary Methods<br/></a><a href="for.html#%28part._.Deriving_.New_.Iteration_.Forms%29" class="indexlink" data-pltdoc="x">Deriving New Iteration Forms<br/></a><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">deserialize</span></span><br/></a><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize-module-guard%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">deserialize-module-guard</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._346._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">desk-dir</span><br/></a><a href="Filesystem.html#%28part._filesystem-change%29" class="indexlink" data-pltdoc="x">Detecting Filesystem Changes<br/></a><a href="Filesystem.html#%28idx._%28gentag._360._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">device-id</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._366._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">device-id-for-special-file</span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-~3elist%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-&gt;list</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-can-functional-set~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-can-functional-set?</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-can-remove-keys~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-can-remove-keys?</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-clear%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-clear</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-clear%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-clear!</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-copy%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-copy</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-count%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-count</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-empty~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-empty?</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-for-each%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-for-each</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-has-key~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-has-key?</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-implements%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-implements/c</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-implements~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-implements?</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iter-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-iter-contract</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-first%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-iterate-first</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-key%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-iterate-key</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-next%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-iterate-next</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-iterate-value%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-iterate-value</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-key-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-key-contract</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-keys%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-keys</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-map%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-map</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-map%2Fcopy%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-map/copy</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-mutable~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-mutable?</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-ref</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-ref%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-ref!</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-remove%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-remove</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-remove%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-remove!</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-set</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-set!</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-set*</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-set%2A%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-set*!</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-update%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-update</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-update%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-update!</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-value-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-value-contract</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict-values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict-values</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._dict~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dict?</span></span><br/></a><a href="dicts.html" class="indexlink" data-pltdoc="x">Dictionaries<br/></a><a href="dicts.html#%28tech._dictionary%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">dictionary</span><br/></a><a href="dicts.html#%28part._.Dictionary_.Predicates_and_.Contracts%29" class="indexlink" data-pltdoc="x">Dictionary Predicates and Contracts<br/></a><a href="dicts.html#%28part._.Dictionary_.Sequences%29" class="indexlink" data-pltdoc="x">Dictionary Sequences<br/></a><a href="Filesystem.html#%28part._directories%29" class="indexlink" data-pltdoc="x">Directories<br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._directory-exists~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">directory-exists?</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._directory-list%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">directory-list</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._directory-type-bits%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">directory-type-bits</span></span><br/></a><a href="stxprops.html#%28idx._%28gentag._236._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">disappeared-binding</span><br/></a><a href="stxprops.html#%28idx._%28gentag._237._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">disappeared-use</span><br/></a><a href="port-lib.html#%28idx._%28gentag._262._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">Opening a null output port<br/></a><a href="eval-model.html#%28tech._discarded%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">discarded</span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._disjoin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">disjoin</span></span><br/></a><a href="readtables.html#%28idx._%28gentag._271._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">dispatch-macro</span><br/></a><a href="case.html" class="indexlink" data-pltdoc="x">Dispatch: <span class="RktSym"><span class="RktStxLink">case</span></span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">display</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._display-lines%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">display-lines</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._display-lines-to-file%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">display-lines-to-file</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._display-to-file%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">display-to-file</span></span><br/></a><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">displayln</span></span><br/></a><a href="numbers.html#%28idx._%28gentag._120._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">division by inexact zero<br/></a><a href="runtime.html#%28idx._%28gentag._431._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">dll</span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._do%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">do</span></span><br/></a><a href="for.html#%28part._.Do_.Loops%29" class="indexlink" data-pltdoc="x">Do Loops<br/></a><a href="Filesystem.html#%28idx._%28gentag._345._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">doc-dir</span><br/></a><a href="number-types.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._double-flonum~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">double-flonum?</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._drop%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">drop</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._drop-common-prefix%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">drop-common-prefix</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._drop-right%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">drop-right</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._dropf%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dropf</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._dropf-right%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dropf-right</span></span><br/></a><a href="garbagecollection.html#%28def._%28%28quote._~23~25kernel%29._dump-memory-stats%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dump-memory-stats</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._dup-input-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dup-input-port</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._dup-output-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dup-output-port</span></span><br/></a><a href="eval.html#%28tech._dynamic._extension%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">dynamic extension</span><br/></a><a href="eval-model.html#%28tech._dynamic._extent%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">dynamic extent</span><br/></a><a href="Module_Names_and_Loading.html#%28part._dynreq%29" class="indexlink" data-pltdoc="x">Dynamic Module Access<br/></a><a href="function-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._dynamic-~3e%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-&gt;*</span></span><br/></a><a href="interactive.html#%28def._%28%28lib._racket%2Fenter..rkt%29._dynamic-enter%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-enter!</span></span><br/></a><a href="ivaraccess.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._dynamic-get-field%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-get-field</span></span><br/></a><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._dynamic-object%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-object/c</span></span><br/></a><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-place</span></span><br/></a><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-place*</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-require</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require-for-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-require-for-syntax</span></span><br/></a><a href="interactive.html#%28def._%28%28lib._racket%2Frerequire..rkt%29._dynamic-rerequire%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-rerequire</span></span><br/></a><a href="ivaraccess.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._dynamic-send%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-send</span></span><br/></a><a href="ivaraccess.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._dynamic-set-field%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-set-field!</span></span><br/></a><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._dynamic-wind%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-wind</span></span><br/></a><a name="alpha:E"></a><span><a href="eval-model.html#%28tech._effect%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">effects</span><br/></a></span><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._eighth%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eighth</span></span><br/></a><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">else</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._empty%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">empty</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._empty-sequence%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">empty-sequence</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._empty-stream%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">empty-stream</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._empty~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">empty?</span></span><br/></a><a href="module.html#%28idx._%28gentag._98._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">enclosing-module-name</span><br/></a><a href="encodings.html" class="indexlink" data-pltdoc="x">Encodings and Locales<br/></a><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">engine</span></span><br/></a><a href="engine.html#%28tech._engine%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">engine</span><br/></a><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine-kill%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">engine-kill</span></span><br/></a><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine-result%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">engine-result</span></span><br/></a><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine-run%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">engine-run</span></span><br/></a><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">engine?</span></span><br/></a><a href="engine.html" class="indexlink" data-pltdoc="x">Engines<br/></a><a href="interactive.html#%28form._%28%28lib._racket%2Fenter..rkt%29._enter%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">enter!</span></span><br/></a><a href="interactive.html#%28part._enter%29" class="indexlink" data-pltdoc="x">Entering Modules<br/></a><a href="runtime.html" class="indexlink" data-pltdoc="x">Environment and Runtime Information<br/></a><a href="envvars.html#%28tech._environment._variable._set%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">environment variable set</span><br/></a><a href="envvars.html" class="indexlink" data-pltdoc="x">Environment Variables<br/></a><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables-copy%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">environment-variables-copy</span></span><br/></a><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables-names%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">environment-variables-names</span></span><br/></a><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">environment-variables-ref</span></span><br/></a><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">environment-variables-set!</span></span><br/></a><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">environment-variables?</span></span><br/></a><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eof</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._eof-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eof-evt</span></span><br/></a><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eof-object?</span></span><br/></a><a href="ephemerons.html#%28tech._ephemeron%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">ephemeron</span><br/></a><a href="ephemerons.html#%28def._%28%28quote._~23~25kernel%29._ephemeron-value%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">ephemeron-value</span></span><br/></a><a href="ephemerons.html#%28def._%28%28quote._~23~25kernel%29._ephemeron~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">ephemeron?</span></span><br/></a><a href="ephemerons.html" class="indexlink" data-pltdoc="x">Ephemerons<br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._eprintf%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eprintf</span></span><br/></a><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq-hash-code%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eq-hash-code</span></span><br/></a><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eq?</span></span><br/></a><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always-hash-code%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">equal-always-hash-code</span></span><br/></a><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always-secondary-hash-code%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">equal-always-secondary-hash-code</span></span><br/></a><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">equal-always?</span></span><br/></a><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%2Frecur%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">equal-always?/recur</span></span><br/></a><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-hash-code%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">equal-hash-code</span></span><br/></a><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-secondary-hash-code%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">equal-secondary-hash-code</span></span><br/></a><a href="objectequality.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._equal~3c~25~3e%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">equal&lt;%&gt;</span></span><br/></a><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">equal?</span></span><br/></a><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%2Frecur%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">equal?/recur</span></span><br/></a><a href="Equality.html" class="indexlink" data-pltdoc="x">Equality<br/></a><a href="Equality.html#%28part._.Equality_and_.Hashing%29" class="indexlink" data-pltdoc="x">Equality and Hashing<br/></a><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv-hash-code%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eqv-hash-code</span></span><br/></a><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eqv?</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error</span></span><br/></a><a href="bytestrings.html#%28idx._%28gentag._146._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">error</span><br/></a><a href="file-ports.html#%28idx._%28gentag._253._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">error</span><br/></a><a href="exns.html#%28tech._error._display._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">error display handler</span><br/></a><a href="exns.html#%28tech._error._escape._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">error escape handler</span><br/></a><a href="exns.html#%28tech._error._message._convention%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">error message convention</span><br/></a><a href="exns.html#%28part._err-msg-conventions%29" class="indexlink" data-pltdoc="x">Error Message Conventions<br/></a><a href="syntax-util.html#%28part._.Error_reporting%29" class="indexlink" data-pltdoc="x">Error reporting<br/></a><a href="exns.html#%28tech._error._syntax._conversion._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">error syntax
+conversion handler</span><br/></a><a href="exns.html#%28tech._error._value._conversion._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">error value conversion
+handler</span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-contract-~3eadjusted-string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error-contract-&gt;adjusted-string</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-display-handler%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error-display-handler</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-escape-handler%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error-escape-handler</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-message-~3eadjusted-string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error-message-&gt;adjusted-string</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-message-adjuster-key%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error-message-adjuster-key</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-print-context-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error-print-context-length</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-print-source-location%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error-print-source-location</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-print-width%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error-print-width</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-syntax-~3estring-handler%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error-syntax-&gt;string-handler</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-value-~3estring-handler%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error-value-&gt;string-handler</span></span><br/></a><a href="eval-model.html#%28tech._escape._continuation%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">escape continuation</span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eval</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval-jit-enabled%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eval-jit-enabled</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._eval-linklet%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eval-linklet</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eval-syntax</span></span><br/></a><a href="eval.html" class="indexlink" data-pltdoc="x">Evaluation and Compilation<br/></a><a href="eval.html#%28tech._evaluation._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">evaluation handler</span><br/></a><a href="eval-model.html" class="indexlink" data-pltdoc="x">Evaluation Model<br/></a><a href="application.html" class="indexlink" data-pltdoc="x">evaluation order<br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._evaluator-alive~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">evaluator-alive?</span></span><br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">even?</span></span><br/></a><a href="sync.html" class="indexlink" data-pltdoc="x">Events<br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._evt%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">evt/c</span></span><br/></a><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">evt?</span></span><br/></a><a href="subprocess.html#%28idx._%28gentag._384._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">exact</span><br/></a><a href="numbers.html#%28tech._exact._number%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">exact number</span><br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-~3einexact%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exact-&gt;inexact</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._exact-ceiling%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exact-ceiling</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._exact-floor%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exact-floor</span></span><br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exact-integer?</span></span><br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exact-nonnegative-integer?</span></span><br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exact-positive-integer?</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._exact-round%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exact-round</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._exact-truncate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exact-truncate</span></span><br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exact?</span></span><br/></a><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._except%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">except</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._except-in%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">except-in</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._except-out%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">except-out</span></span><br/></a><a href="eval-model.html#%28tech._exception._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">exception handler</span><br/></a><a href="eval-model.html#%28part._exn-model%29" class="indexlink" data-pltdoc="x">Exceptions<br/></a><a href="exns.html" class="indexlink" data-pltdoc="x">Exceptions<br/></a><a href="eval-model.html#%28tech._exception%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">Exceptions</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._348._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">exec-file</span><br/></a><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._executable-yield-handler%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">executable-yield-handler</span></span><br/></a><a href="securityguards.html#%28idx._%28gentag._282._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">execute</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._358._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">execute</span><br/></a><a href="securityguards.html#%28idx._%28gentag._284._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">exists</span><br/></a><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._exit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exit</span></span><br/></a><a href="Exiting.html#%28tech._exit._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">exit handler</span><br/></a><a href="running-sa.html#%28part._exit-status%29" class="indexlink" data-pltdoc="x">Exit Status<br/></a><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._exit-handler%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exit-handler</span></span><br/></a><a href="Exiting.html" class="indexlink" data-pltdoc="x">Exiting<br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fexn..rkt%29._exn-~3estring%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym">exn-&gt;string</span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn-continuation-marks%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn-continuation-marks</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn-message%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn-message</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:break</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3abreak-continuation%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:break-continuation</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak~3ahang-up%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:break:hang-up</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3abreak~3ahang-up~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:break:hang-up?</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak~3aterminate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:break:terminate</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3abreak~3aterminate~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:break:terminate?</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3abreak~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:break?</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:contract</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3aarity%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:contract:arity</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3acontract~3aarity~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:contract:arity?</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._exn~3afail~3acontract~3ablame%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:contract:blame</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._exn~3afail~3acontract~3ablame-object%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:contract:blame-object</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._exn~3afail~3acontract~3ablame~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:contract:blame?</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3acontinuation%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:contract:continuation</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3acontract~3acontinuation~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:contract:continuation?</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3adivide-by-zero%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:contract:divide-by-zero</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3acontract~3adivide-by-zero~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:contract:divide-by-zero?</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3anon-fixnum-result%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:contract:non-fixnum-result</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3acontract~3anon-fixnum-result~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:contract:non-fixnum-result?</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3avariable%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:contract:variable</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3acontract~3avariable-id%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:contract:variable-id</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3acontract~3avariable~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:contract:variable?</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3acontract~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:contract?</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:filesystem</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3aerrno%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:filesystem:errno</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3afilesystem~3aerrno-errno%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:filesystem:errno-errno</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3afilesystem~3aerrno~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:filesystem:errno?</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3aexists%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:filesystem:exists</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3afilesystem~3aexists~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:filesystem:exists?</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3amissing-module%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:filesystem:missing-module</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3afilesystem~3amissing-module-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:filesystem:missing-module-path</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3afilesystem~3amissing-module~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:filesystem:missing-module?</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3aversion%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:filesystem:version</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3afilesystem~3aversion~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:filesystem:version?</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3afilesystem~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:filesystem?</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:network</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork~3aerrno%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:network:errno</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3anetwork~3aerrno-errno%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:network:errno-errno</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3anetwork~3aerrno~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:network:errno?</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3anetwork~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:network?</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:object</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:object?</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aout-of-memory%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:out-of-memory</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3aout-of-memory~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:out-of-memory?</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:read</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3aread-srclocs%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:read-srclocs</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread~3aeof%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:read:eof</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3aread~3aeof~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:read:eof?</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread~3anon-char%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:read:non-char</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3aread~3anon-char~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:read:non-char?</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3aread~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:read?</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._exn~3afail~3aresource-resource%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:resource-resource</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._exn~3afail~3aresource~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:resource?</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._exn~3afail~3asandbox-terminated-reason%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:sandbox-terminated-reason</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._exn~3afail~3asandbox-terminated~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:sandbox-terminated?</span></span><br/></a><a href="struct-generics.html#%28def._%28%28lib._racket%2Fgeneric..rkt%29._exn~3afail~3asupport%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:support</span></span><br/></a><a href="struct-generics.html#%28def._%28%28lib._racket%2Fgeneric..rkt%29._exn~3afail~3asupport~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:support?</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:syntax</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3asyntax-exprs%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:syntax-exprs</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax~3amissing-module%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:syntax:missing-module</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3asyntax~3amissing-module-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:syntax:missing-module-path</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3asyntax~3amissing-module~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:syntax:missing-module?</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax~3aunbound%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:syntax:unbound</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3asyntax~3aunbound~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:syntax:unbound?</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3asyntax~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:syntax?</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aunsupported%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:unsupported</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3aunsupported~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:unsupported?</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3auser%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:user</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3auser~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail:user?</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:fail?</span></span><br/></a><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._exn~3amisc~3amatch~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:misc:match?</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3amissing-module-accessor%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:missing-module-accessor</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3amissing-module~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:missing-module?</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3asrclocs-accessor%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:srclocs-accessor</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3asrclocs~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:srclocs?</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn?</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._exp%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exp</span></span><br/></a><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">expand</span></span><br/></a><a href="syntax-model.html#%28tech._expand%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">expand</span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._expand-export%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">expand-export</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._expand-import%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">expand-import</span></span><br/></a><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand-once%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">expand-once</span></span><br/></a><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">expand-syntax</span></span><br/></a><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand-syntax-once%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">expand-syntax-once</span></span><br/></a><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand-syntax-to-top-form%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">expand-syntax-to-top-form</span></span><br/></a><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand-to-top-form%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">expand-to-top-form</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._expand-user-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">expand-user-path</span></span><br/></a><a href="Expanding_Top-Level_Forms.html" class="indexlink" data-pltdoc="x">Expanding Top-Level Forms<br/></a><a href="syntax-model.html#%28tech._expansion%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">Expansion</span><br/></a><a href="syntax-model.html#%28part._expansion%29" class="indexlink" data-pltdoc="x">Expansion (Parsing)<br/></a><a href="syntax-model.html#%28part._expand-context-model%29" class="indexlink" data-pltdoc="x">Expansion Context<br/></a><a href="syntax-model.html#%28part._expand-steps%29" class="indexlink" data-pltdoc="x">Expansion Steps<br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._explode-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">explode-path</span></span><br/></a><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">export</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._export%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">export</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._export-local-id%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">export-local-id</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._export-mode%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">export-mode</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._export-orig-stx%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">export-orig-stx</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._export-out-sym%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">export-out-sym</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._export-protect~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">export-protect?</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._export~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">export?</span></span><br/></a><a href="syntax-model.html#%28tech._expression._context%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">expression context</span><br/></a><a href="__expression.html" class="indexlink" data-pltdoc="x">Expression Wrapper: <span class="RktSym"><span class="RktStxLink">#%expression</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">expt</span></span><br/></a><a href="mzlib_class.html#%28tech._extend%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">extend</span><br/></a><a href="match.html#%28part._.Extending_match%29" class="indexlink" data-pltdoc="x">Extending <span class="RktSym"><span class="RktStxLink">match</span></span><br/></a><a href="define-sig-form.html" class="indexlink" data-pltdoc="x">Extending the Syntax of Signatures<br/></a><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._extends%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">extends</span></span><br/></a><a href="eval.html#%28tech._extension._load._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">extension-load handler</span><br/></a><a href="objectserialize.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._externalizable~3c~25~3e%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">externalizable&lt;%&gt;</span></span><br/></a><a href="fasl.html#%28tech._externally._lifted%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">externally lifted</span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl*</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl%2B%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl+</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl-</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-~3eexact%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl-&gt;exact</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-~3eexact-integer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl-&gt;exact-integer</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-~3efloating-point-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl-&gt;floating-point-bytes</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-~3efx%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl-&gt;fx</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-~3einexact%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl-&gt;inexact</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl%2F%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl/</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl~3c%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl&lt;</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl~3c~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl&lt;=</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl=</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl~3e%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl&gt;</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl~3e~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl&gt;=</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflabs%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflabs</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflacos%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflacos</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflasin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflasin</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflatan%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflatan</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflceiling%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflceiling</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflcos%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflcos</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflexp%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflexp</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflexpt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflexpt</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflfloor%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflfloor</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfllog%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfllog</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflmax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflmax</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflmin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflmin</span></span><br/></a><a href="extflonums.html#%28tech._extflonum%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">extflonum</span><br/></a><a href="extflonums.html#%28part._.Extflonum_.Arithmetic%29" class="indexlink" data-pltdoc="x">Extflonum Arithmetic<br/></a><a href="extflonums.html#%28part._extflutils%29" class="indexlink" data-pltdoc="x">Extflonum Byte Strings<br/></a><a href="extflonums.html#%28part._.Extflonum_.Constants%29" class="indexlink" data-pltdoc="x">Extflonum Constants<br/></a><a href="extflonums.html#%28part._extflvectors%29" class="indexlink" data-pltdoc="x">Extflonum Vectors<br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum-available~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflonum-available?</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflonum?</span></span><br/></a><a href="extflonums.html" class="indexlink" data-pltdoc="x">Extflonums<br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflround%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflround</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflsin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflsin</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflsqrt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflsqrt</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfltan%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfltan</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfltruncate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfltruncate</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflvector</span></span><br/></a><a href="extflonums.html#%28tech._extflvector%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">extflvector</span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector-copy%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflvector-copy</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflvector-length</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflvector-ref</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflvector-set!</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflvector?</span></span><br/></a><a href="generic-numbers.html#%28part._.Extra_.Constants_and_.Functions%29" class="indexlink" data-pltdoc="x">Extra Constants and Functions<br/></a><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._extract-struct-info%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extract-struct-info</span></span><br/></a><a name="alpha:F"></a><span><a href="match.html#%28tech._failure._procedure%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">failure procedure</span><br/></a></span><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._failure-cont%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">failure-cont</span></span><br/></a><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._failure-result%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">failure-result/c</span></span><br/></a><a href="struct-generics.html#%28tech._fallback._method%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">fallback method</span><br/></a><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._false%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">false</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._false%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">false/c</span></span><br/></a><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._false~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">false?</span></span><br/></a><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._fasl-~3es-exp%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fasl-&gt;s-exp</span></span><br/></a><a href="fasl.html" class="indexlink" data-pltdoc="x">Fast-Load Serialization<br/></a><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._fcontrol%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fcontrol</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">field</span></span><br/></a><a href="ivaraccess.html" class="indexlink" data-pltdoc="x">Field and Method Access<br/></a><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field-bound~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">field-bound?</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field-names%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">field-names</span></span><br/></a><a href="ivaraccess.html#%28part._.Fields%29" class="indexlink" data-pltdoc="x">Fields<br/></a><a href="createclass.html#%28part._clfields%29" class="indexlink" data-pltdoc="x">Fields<br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._fifo-type-bits%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fifo-type-bits</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._fifth%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fifth</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._file%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">file</span></span><br/></a><a href="include.html" class="indexlink" data-pltdoc="x">File Inclusion<br/></a><a href="Filesystem.html#%28idx._%28gentag._354._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">file modification date and time<br/></a><a href="file-ports.html" class="indexlink" data-pltdoc="x">File Ports<br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-~3ebytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-&gt;bytes</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-~3ebytes-lines%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-&gt;bytes-lines</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-~3elines%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-&gt;lines</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-~3elist%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-&gt;list</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-~3estring%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-&gt;string</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-~3evalue%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-&gt;value</span></span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-exists~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-exists?</span></span><br/></a><a href="runtime.html#%28idx._%28gentag._441._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">file-level</span><br/></a><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._file-name-from-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-name-from-path</span></span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-identity%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-or-directory-identity</span></span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-modify-seconds%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-or-directory-modify-seconds</span></span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-permissions%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-or-directory-permissions</span></span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-stat%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-or-directory-stat</span></span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-type%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-or-directory-type</span></span><br/></a><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-position</span></span><br/></a><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-position*</span></span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-size%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-size</span></span><br/></a><a href="file-ports.html#%28tech._file._stream._port%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">file-stream
+port</span><br/></a><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-stream-buffer-mode%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-stream-buffer-mode</span></span><br/></a><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._file-stream-port~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-stream-port?</span></span><br/></a><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-truncate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-truncate</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._file-type-bits%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-type-bits</span></span><br/></a><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._filename-extension%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">filename-extension</span></span><br/></a><a href="Filesystem.html#%28part._fileutils%29" class="indexlink" data-pltdoc="x">Files<br/></a><a href="Filesystem.html" class="indexlink" data-pltdoc="x">Filesystem<br/></a><a href="Filesystem.html#%28tech._filesystem._change._event%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">filesystem change event</span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._filesystem-change-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">filesystem-change-evt</span></span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._filesystem-change-evt-cancel%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">filesystem-change-evt-cancel</span></span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._filesystem-change-evt~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">filesystem-change-evt?</span></span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._filesystem-root-list%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">filesystem-root-list</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._filter%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">filter</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._filter-map%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">filter-map</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._filter-not%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">filter-not</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._filter-read-input-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">filter-read-input-port</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._filtered-in%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">filtered-in</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprovide..rkt%29._filtered-out%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">filtered-out</span></span><br/></a><a href="willexecutor.html#%28tech._finalizer%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">finalizers</span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._find-compiled-file-roots%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">find-compiled-file-roots</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._find-executable-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">find-executable-path</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._find-files%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">find-files</span></span><br/></a><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._find-library-collection-links%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">find-library-collection-links</span></span><br/></a><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._find-library-collection-paths%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">find-library-collection-paths</span></span><br/></a><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._find-relative-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">find-relative-path</span></span><br/></a><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._find-seconds%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">find-seconds</span></span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">find-system-path</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._findf%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">findf</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._first%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">first</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._first-or%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">first-or/c</span></span><br/></a><a href="numbers.html#%28tech._fixnum%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">fixnum</span><br/></a><a href="fixnums.html#%28part._.Fixnum_.Arithmetic%29" class="indexlink" data-pltdoc="x">Fixnum Arithmetic<br/></a><a href="fixnums.html#%28part._fxrange%29" class="indexlink" data-pltdoc="x">Fixnum Range<br/></a><a href="fixnums.html#%28part._fxvectors%29" class="indexlink" data-pltdoc="x">Fixnum Vectors<br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fixnum-for-every-system~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fixnum-for-every-system?</span></span><br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fixnum?</span></span><br/></a><a href="fixnums.html" class="indexlink" data-pltdoc="x">Fixnums<br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl*</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2B%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl+</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl-%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl-</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl-~3eexact-integer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl-&gt;exact-integer</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fl-~3efx%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl-&gt;fx</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2F%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl/</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3c%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl&lt;</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3c~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl&lt;=</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl=</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3e%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl&gt;</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3e~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl&gt;=</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flabs%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flabs</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flacos%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flacos</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flasin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flasin</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28tech._flat._contract._property%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">flat contract property</span><br/></a><a href="contracts.html#%28tech._flat._contract%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">Flat <span class="techoutside"><span class="techinside">contracts</span></span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._flat-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flat-contract</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._flat-contract-predicate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flat-contract-predicate</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._flat-contract-property~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flat-contract-property?</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._flat-contract-with-explanation%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flat-contract-with-explanation</span></span><br/></a><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flat-contract?</span></span><br/></a><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._flat-murec-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">flat-murec-contract</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._flat-named-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flat-named-contract</span></span><br/></a><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._flat-rec-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">flat-rec-contract</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flatan%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flatan</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._flatten%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flatten</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flceiling%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flceiling</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flcos%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flcos</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flexp%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flexp</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flexpt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flexpt</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flfloor%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flfloor</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flimag-part%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flimag-part</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fllog%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fllog</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flmax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flmax</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flmin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flmin</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._floating-point-bytes-~3eextfl%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">floating-point-bytes-&gt;extfl</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._floating-point-bytes-~3ereal%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">floating-point-bytes-&gt;real</span></span><br/></a><a href="flonums.html#%28part._.Flonum_.Arithmetic%29" class="indexlink" data-pltdoc="x">Flonum Arithmetic<br/></a><a href="flonums.html#%28part._flvectors%29" class="indexlink" data-pltdoc="x">Flonum Vectors<br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flonum?</span></span><br/></a><a href="flonums.html" class="indexlink" data-pltdoc="x">Flonums<br/></a><a href="numbers.html#%28tech._flonum%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">flonums</span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._floor%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">floor</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flrandom%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flrandom</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flreal-part%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flreal-part</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flround%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flround</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flsin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flsin</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flsingle%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flsingle</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flsqrt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flsqrt</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fltan%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fltan</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fltruncate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fltruncate</span></span><br/></a><a href="plumbers.html#%28tech._flush._callback%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">flush callbacks</span><br/></a><a href="plumbers.html#%28tech._flush._handle%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">flush handle</span><br/></a><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._flush-output%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flush-output</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flvector</span></span><br/></a><a href="flonums.html#%28tech._flvector%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">flvector</span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector-copy%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flvector-copy</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flvector-length</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flvector-ref</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flvector-set!</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flvector?</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._fold-files%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fold-files</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldl%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">foldl</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">foldr</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fand%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/and</span></span><br/></a><a href="futures.html#%28form._%28%28lib._racket%2Ffuture..rkt%29._for%2A%2Fasync%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/async</span></span><br/></a><a href="extflonums.html#%28form._%28%28lib._racket%2Fextflonum..rkt%29._for%2A%2Fextflvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/extflvector</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Ffirst%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/first</span></span><br/></a><a href="flonums.html#%28form._%28%28lib._racket%2Fflonum..rkt%29._for%2A%2Fflvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/flvector</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Ffold%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/fold</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Ffold%2Fderived%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/fold/derived</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Ffoldr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/foldr</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Ffoldr%2Fderived%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/foldr/derived</span></span><br/></a><a href="fixnums.html#%28form._%28%28lib._racket%2Ffixnum..rkt%29._for%2A%2Ffxvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/fxvector</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fhash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/hash</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fhashalw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/hashalw</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fhasheq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/hasheq</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fhasheqv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/hasheqv</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Flast%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/last</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Flist%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/list</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Flists%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/lists</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fmutable-set%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/mutable-set</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fmutable-setalw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/mutable-setalw</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fmutable-seteq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/mutable-seteq</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fmutable-seteqv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/mutable-seteqv</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2For%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/or</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fproduct%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/product</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fset%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/set</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fsetalw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/setalw</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fseteq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/seteq</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fseteqv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/seteqv</span></span><br/></a><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._for%2A%2Fstream%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/stream</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fsum%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/sum</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/vector</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fweak-set%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/weak-set</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fweak-setalw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/weak-setalw</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fweak-seteq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/weak-seteq</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fweak-seteqv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/weak-seteqv</span></span><br/></a><a href="for.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-clause-syntax-protect%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">for-clause-syntax-protect</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._for-each%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">for-each</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-label%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for-label</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-meta%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for-meta</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-space%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for-space</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for-syntax</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-template%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for-template</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fand%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/and</span></span><br/></a><a href="futures.html#%28form._%28%28lib._racket%2Ffuture..rkt%29._for%2Fasync%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/async</span></span><br/></a><a href="extflonums.html#%28form._%28%28lib._racket%2Fextflonum..rkt%29._for%2Fextflvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/extflvector</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffirst%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/first</span></span><br/></a><a href="flonums.html#%28form._%28%28lib._racket%2Fflonum..rkt%29._for%2Fflvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/flvector</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffold%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/fold</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffold%2Fderived%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/fold/derived</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffoldr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/foldr</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffoldr%2Fderived%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/foldr/derived</span></span><br/></a><a href="fixnums.html#%28form._%28%28lib._racket%2Ffixnum..rkt%29._for%2Ffxvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/fxvector</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fhash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/hash</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fhashalw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/hashalw</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fhasheq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/hasheq</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fhasheqv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/hasheqv</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flast%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/last</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/list</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flists%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/lists</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fmutable-set%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/mutable-set</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fmutable-setalw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/mutable-setalw</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fmutable-seteq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/mutable-seteq</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fmutable-seteqv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/mutable-seteqv</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2For%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/or</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fproduct%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/product</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fset%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/set</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fsetalw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/setalw</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fseteq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/seteq</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fseteqv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/seteqv</span></span><br/></a><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._for%2Fstream%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/stream</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fsum%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/sum</span></span><br/></a><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/vector</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fweak-set%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/weak-set</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fweak-setalw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/weak-setalw</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fweak-seteq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/weak-seteq</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fweak-seteqv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/weak-seteqv</span></span><br/></a><a href="for.html#%28idx._%28gentag._110._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">for:no-implicit-optimization</span><br/></a><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">force</span></span><br/></a><a href="runtime.html#%28idx._%28gentag._444._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">force</span><br/></a><a href="syntax-model.html#%28tech._form%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">form</span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">format</span></span><br/></a><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._format-id%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">format-id</span></span><br/></a><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._format-symbol%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">format-symbol</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._fourth%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fourth</span></span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._fprintf%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fprintf</span></span><br/></a><a href="runtime.html#%28idx._%28gentag._432._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">framework</span><br/></a><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">free-identifier=?</span></span><br/></a><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-label-identifier~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">free-label-identifier=?</span></span><br/></a><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-template-identifier~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">free-template-identifier=?</span></span><br/></a><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-transformer-identifier~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">free-transformer-identifier=?</span></span><br/></a><a href="runtime.html#%28idx._%28gentag._437._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">fs-change</span><br/></a><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore-count%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fsemaphore-count</span></span><br/></a><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore-post%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fsemaphore-post</span></span><br/></a><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore-try-wait~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fsemaphore-try-wait?</span></span><br/></a><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore-wait%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fsemaphore-wait</span></span><br/></a><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fsemaphore?</span></span><br/></a><a href="syntax-model.html#%28part._fully-expanded%29" class="indexlink" data-pltdoc="x">Fully Expanded Programs<br/></a><a href="syntax-model.html#%28tech._fully._expanded%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">fully-expanded</span><br/></a><a href="function-contracts.html#%28tech._function._contract%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">function contract</span><br/></a><a href="function-contracts.html" class="indexlink" data-pltdoc="x">Function Contracts<br/></a><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._future%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">future</span></span><br/></a><a href="futures.html#%28tech._future%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">future</span><br/></a><a href="futures.html#%28part._future-logging%29" class="indexlink" data-pltdoc="x">Future Performance Logging<br/></a><a href="futures.html#%28tech._future._semaphore%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">future semaphore</span><br/></a><a href="futures.html#%28part._.Future_.Semaphores%29" class="indexlink" data-pltdoc="x">Future Semaphores<br/></a><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._future~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">future?</span></span><br/></a><a href="futures.html" class="indexlink" data-pltdoc="x">Futures<br/></a><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._futures-enabled~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">futures-enabled?</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx*</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2A%2Fwraparound%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx*/wraparound</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2B%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx+</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2B%2Fwraparound%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx+/wraparound</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx-%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx-</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx-%2Fwraparound%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx-/wraparound</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._fx-~3eextfl%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx-&gt;extfl</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx-~3efl%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx-&gt;fl</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx~3c%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx&lt;</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx~3c~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx&lt;=</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx=</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx~3e%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx&gt;</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx~3e~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx&gt;=</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxabs%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxabs</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxand%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxand</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxior%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxior</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxlshift%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxlshift</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxlshift%2Fwraparound%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxlshift/wraparound</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxmax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxmax</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxmin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxmin</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxmodulo%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxmodulo</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxnot%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxnot</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxpopcount%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxpopcount</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxpopcount16%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxpopcount16</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxpopcount32%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxpopcount32</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxquotient%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxquotient</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxremainder%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxremainder</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxrshift%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxrshift</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxvector</span></span><br/></a><a href="fixnums.html#%28tech._fxvector%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">fxvector</span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector-copy%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxvector-copy</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxvector-length</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxvector-ref</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxvector-set!</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxvector?</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxxor%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxxor</span></span><br/></a><a name="alpha:G"></a><span><a href="garbagecollection.html" class="indexlink" data-pltdoc="x">Garbage Collection<br/></a></span><a href="eval-model.html#%28part._gc-model%29" class="indexlink" data-pltdoc="x">Garbage Collection<br/></a><a href="eval-model.html#%28tech._garbage._collection%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">garbage
+collection</span><br/></a><a href="runtime.html#%28idx._%28gentag._424._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">gc</span><br/></a><a href="garbagecollection.html#%28idx._%28gentag._451._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym">gc-info</span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._gcd%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">gcd</span></span><br/></a><a href="Printer_Extension.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3acustom-write%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">gen:custom-write</span></span><br/></a><a href="dicts.html#%28form._%28%28lib._racket%2Fdict..rkt%29._gen~3adict%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">gen:dict</span></span><br/></a><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal%2Bhash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">gen:equal+hash</span></span><br/></a><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal-mode%2Bhash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">gen:equal-mode+hash</span></span><br/></a><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._gen~3aset%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">gen:set</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._gen~3astream%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">gen:stream</span></span><br/></a><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._generate-member-key%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">generate-member-key</span></span><br/></a><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._generate-temporaries%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">generate-temporaries</span></span><br/></a><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._generate-temporary%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">generate-temporary</span></span><br/></a><a href="Generating_A_Unit_from_Context.html" class="indexlink" data-pltdoc="x">Generating A Unit from Context<br/></a><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._generator%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">generator</span></span><br/></a><a href="Generators.html#%28tech._generator%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">generator</span><br/></a><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._generator-state%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">generator-state</span></span><br/></a><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._generator~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">generator?</span></span><br/></a><a href="Generators.html" class="indexlink" data-pltdoc="x">Generators<br/></a><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._generic%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">generic</span></span><br/></a><a href="ivaraccess.html#%28tech._generic%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">generic</span><br/></a><a href="dicts.html#%28part._.Generic_.Dictionary_.Interface%29" class="indexlink" data-pltdoc="x">Generic Dictionary Interface<br/></a><a href="struct-generics.html#%28tech._generic._instance%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">generic instance</span><br/></a><a href="struct-generics.html#%28tech._generic._interface%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">generic interface</span><br/></a><a href="struct-generics.html" class="indexlink" data-pltdoc="x">Generic Interfaces<br/></a><a href="struct-generics.html#%28tech._generic._method%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">generic method</span><br/></a><a href="generic-numbers.html" class="indexlink" data-pltdoc="x">Generic Numerics<br/></a><a href="sets.html#%28part._.Generic_.Set_.Interface%29" class="indexlink" data-pltdoc="x">Generic Set Interface<br/></a><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._generic-instance%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">generic-instance/c</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">generic-set?</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._generic~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">generic?</span></span><br/></a><a href="ivaraccess.html#%28part._.Generics%29" class="indexlink" data-pltdoc="x">Generics<br/></a><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._gensym%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">gensym</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._get-error-output%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get-error-output</span></span><br/></a><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._get-field%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">get-field</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._get-impersonator-prop~3acollapsible%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get-impersonator-prop:collapsible</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._get-output%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get-output</span></span><br/></a><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get-output-bytes</span></span><br/></a><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get-output-string</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._get-preference%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get-preference</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._get-uncovered-expressions%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get-uncovered-expressions</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._get-user-custodian%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get-user-custodian</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._get%2Fbuild-collapsible-late-neg-projection%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get/build-collapsible-late-neg-projection</span></span><br/></a><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._get%2Fbuild-late-neg-projection%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get/build-late-neg-projection</span></span><br/></a><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._get%2Fbuild-val-first-projection%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get/build-val-first-projection</span></span><br/></a><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._getenv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">getenv</span></span><br/></a><a href="os-lib.html#%28def._%28%28lib._racket%2Fos..rkt%29._gethostname%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">gethostname</span></span><br/></a><a href="os-lib.html#%28def._%28%28lib._racket%2Fos..rkt%29._getpid%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">getpid</span></span><br/></a><a href="Writing.html#%28tech._global._port._print._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">global port print handler</span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._global-port-print-handler%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">global-port-print-handler</span></span><br/></a><a href="running-sa.html#%28idx._%28gentag._454._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">gracket</span><br/></a><a href="running-sa.html#%28idx._%28gentag._456._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">GRacket.app</span><br/></a><a href="running-sa.html#%28idx._%28gentag._455._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">GRacket.exe</span><br/></a><a href="generic-numbers.html#%28idx._%28gentag._123._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">greatest common divisor<br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._group-by%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">group-by</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._group-execute-bit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">group-execute-bit</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._365._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">group-id</span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._group-permission-bits%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">group-permission-bits</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._group-read-bit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">group-read-bit</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._group-write-bit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">group-write-bit</span></span><br/></a><a href="sync.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._guard-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">guard-evt</span></span><br/></a><a href="when_unless.html" class="indexlink" data-pltdoc="x">Guarded Evaluation: <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._gui~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">gui?</span></span><br/></a><a name="alpha:H"></a><span><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">handle-evt</span></span><br/></a></span><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">handle-evt?</span></span><br/></a><a href="exns.html#%28part._.Handling_.Exceptions%29" class="indexlink" data-pltdoc="x">Handling Exceptions<br/></a><a href="Filesystem.html#%28idx._%28gentag._363._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">hardlink-count</span><br/></a><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._has-blame~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">has-blame?</span></span><br/></a><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._has-contract~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">has-contract?</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._has-impersonator-prop~3acollapsible~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">has-impersonator-prop:collapsible?</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash</span></span><br/></a><a href="hashtables.html#%28tech._hash%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">hash</span><br/></a><a href="Equality.html#%28tech._hash._code%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">hash code</span><br/></a><a href="pairs.html#%28tech._hash._placeholder%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">hash placeholders</span><br/></a><a href="sets.html#%28tech._hash._set%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">hash set</span><br/></a><a href="sets.html#%28part._.Hash_.Sets%29" class="indexlink" data-pltdoc="x">Hash Sets<br/></a><a href="hashtables.html#%28tech._hash._table%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">hash table</span><br/></a><a href="hashtables.html" class="indexlink" data-pltdoc="x">Hash Tables<br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._hash-~3elinklet-bundle%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-&gt;linklet-bundle</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._hash-~3elinklet-directory%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-&gt;linklet-directory</span></span><br/></a><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-~3elist%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-&gt;list</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-clear%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-clear</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-clear%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-clear!</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-copy%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-copy</span></span><br/></a><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-copy-clear%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-copy-clear</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-count%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-count</span></span><br/></a><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-empty~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-empty?</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-ephemeron?</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-eq~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-eq?</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-equal-always~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-equal-always?</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-equal~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-equal?</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-eqv~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-eqv?</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-for-each%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-for-each</span></span><br/></a><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-has-key~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-has-key?</span></span><br/></a><a href="hashtables.html#%28def._%28%28lib._racket%2Fhash..rkt%29._hash-intersect%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-intersect</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-first%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-iterate-first</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-key%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-iterate-key</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-key%2Bvalue%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-iterate-key+value</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-next%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-iterate-next</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-pair%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-iterate-pair</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-value%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-iterate-value</span></span><br/></a><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-keys%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-keys</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-keys-subset~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-keys-subset?</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-map%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-map</span></span><br/></a><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-map%2Fcopy%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-map/copy</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._hash-placeholder~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-placeholder?</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-ref</span></span><br/></a><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-ref%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-ref!</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref-key%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-ref-key</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-remove</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-remove!</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-set</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-set!</span></span><br/></a><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-set%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-set*</span></span><br/></a><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-set%2A%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-set*!</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-strong?</span></span><br/></a><a href="match.html#%28idx._%28gentag._208._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">hash-table<br/></a><a href="hashtables.html#%28def._%28%28lib._racket%2Fhash..rkt%29._hash-union%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-union</span></span><br/></a><a href="hashtables.html#%28def._%28%28lib._racket%2Fhash..rkt%29._hash-union%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-union!</span></span><br/></a><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-update%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-update</span></span><br/></a><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-update%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-update!</span></span><br/></a><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-values</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-weak?</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash/c</span></span><br/></a><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fhash..rkt%29._hash%2Fdc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">hash/dc</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash?</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hashalw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hashalw</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hasheq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hasheq</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hasheqv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hasheqv</span></span><br/></a><a href="Interactive_Help.html#%28form._%28%28lib._racket%2Fhelp..rkt%29._help%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">help</span></span><br/></a><a href="reader.html#%28idx._%28gentag._57._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">here strings<br/></a><a href="reader.html#%28idx._%28gentag._34._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">heredoc<br/></a><a href="Filesystem.html#%28idx._%28gentag._319._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">HOME</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._317._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">home-dir</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._323._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">HOMEDRIVE</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._324._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">HOMEPATH</span><br/></a><a href="Equality.html#%28part._.Honest_.Custom_.Equality%29" class="indexlink" data-pltdoc="x">Honest Custom Equality<br/></a><a href="Filesystem.html#%28idx._%28gentag._351._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">host-collects-dir</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._339._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">host-config-dir</span><br/></a><a name="alpha:I"></a><span><a href="syntax-model.html#%28tech._identifier%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">identifier</span><br/></a></span><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier-binding</span></span><br/></a><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding-portal-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier-binding-portal-syntax</span></span><br/></a><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding-symbol%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier-binding-symbol</span></span><br/></a><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-distinct-binding%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier-distinct-binding</span></span><br/></a><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-label-binding%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier-label-binding</span></span><br/></a><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._identifier-prune-lexical-context%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier-prune-lexical-context</span></span><br/></a><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._identifier-prune-to-source-module%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier-prune-to-source-module</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._identifier-remove-from-definition-context%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier-remove-from-definition-context</span></span><br/></a><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-template-binding%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier-template-binding</span></span><br/></a><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-transformer-binding%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier-transformer-binding</span></span><br/></a><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier?</span></span><br/></a><a href="syntax-model.html#%28part._id-model%29" class="indexlink" data-pltdoc="x">Identifiers, Binding, and Scopes<br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._identity%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identity</span></span><br/></a><a href="numbers.html#%28idx._%28gentag._119._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">IEEE floating-point numbers<br/></a><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">if</span></span><br/></a><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._if%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">if/c</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._imag-part%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imag-part</span></span><br/></a><a href="pairs.html#%28part._.Immutable_.Cyclic_.Data%29" class="indexlink" data-pltdoc="x">Immutable Cyclic Data<br/></a><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">immutable?</span></span><br/></a><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._impersonate-async-channel%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-async-channel</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-box%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-box</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-channel%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-channel</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-continuation-mark-key%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-continuation-mark-key</span></span><br/></a><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._impersonate-generics%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">impersonate-generics</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-hash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-hash</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._impersonate-hash-set%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-hash-set</span></span><br/></a><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-procedure</span></span><br/></a><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-procedure*</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-prompt-tag%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-prompt-tag</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-struct%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-struct</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-vector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-vector</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-vector%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-vector*</span></span><br/></a><a href="chaperones.html#%28tech._impersonator%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">impersonator</span><br/></a><a href="chaperones.html#%28part._.Impersonator_.Constructors%29" class="indexlink" data-pltdoc="x">Impersonator Constructors<br/></a><a href="contracts.html#%28tech._impersonator._contract%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">Impersonator <span class="techoutside"><span class="techinside">contracts</span></span></span><br/></a><a href="chaperones.html#%28part._.Impersonator_.Properties%29" class="indexlink" data-pltdoc="x">Impersonator Properties<br/></a><a href="chaperones.html#%28tech._impersonator._property%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">impersonator properties</span><br/></a><a href="chaperones.html#%28tech._impersonator._property._accessor%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">impersonator property accessor</span><br/></a><a href="chaperones.html#%28tech._impersonator._property._descriptor%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">impersonator property descriptor</span><br/></a><a href="chaperones.html#%28tech._impersonator._property._predicate%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">impersonator property predicate</span><br/></a><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._impersonator-contract~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonator-contract?</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-ephemeron%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonator-ephemeron</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonator-of?</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-prop~3aapplication-mark%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonator-prop:application-mark</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._impersonator-prop~3ablame%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonator-prop:blame</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._impersonator-prop~3acollapsible%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonator-prop:collapsible</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._impersonator-prop~3acontracted%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonator-prop:contracted</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property-accessor-procedure~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonator-property-accessor-procedure?</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonator-property?</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonator?</span></span><br/></a><a href="chaperones.html" class="indexlink" data-pltdoc="x">Impersonators and Chaperones<br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._implementation~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">implementation?</span></span><br/></a><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._implementation~3f%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">implementation?/c</span></span><br/></a><a href="implementations.html" class="indexlink" data-pltdoc="x">Implementations<br/></a><a href="struct-generics.html#%28tech._implemented._generic._method%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">implemented generic method</span><br/></a><a href="Equality.html#%28part._.Implementing_.Equality_for_.Custom_.Types%29" class="indexlink" data-pltdoc="x">Implementing Equality for Custom Types<br/></a><a href="mzlib_class.html#%28tech._implement%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">implements</span><br/></a><a href="syntax-model.html#%28tech._implicit._made._explicit._property%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">implicit-made-explicit properties</span><br/></a><a href="booleans.html#%28form._%28%28lib._racket%2Fbool..rkt%29._implies%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">implies</span></span><br/></a><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">import</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">import</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import-local-id%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">import-local-id</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import-mode%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">import-mode</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import-orig-mode%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">import-orig-mode</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import-orig-stx%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">import-orig-stx</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import-req-mode%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">import-req-mode</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import-source%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">import-source</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import-source-mod-path-stx%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">import-source-mod-path-stx</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import-source-mode%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">import-source-mode</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import-source~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">import-source?</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import-src-mod-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">import-src-mod-path</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import-src-sym%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">import-src-sym</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">import?</span></span><br/></a><a href="require.html" class="indexlink" data-pltdoc="x">Importing and Exporting: <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span><br/></a><a href="lazy-require.html" class="indexlink" data-pltdoc="x">Importing Modules Lazily: <span class="RktSym"><span class="RktStxLink">lazy-require</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-bytes</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-bytes-lines%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-bytes-lines</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._in-combinations%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-combinations</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-cycle%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-cycle</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._in-dict%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-dict</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._in-dict-keys%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-dict-keys</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._in-dict-pairs%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-dict-pairs</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._in-dict-values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-dict-values</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-directory%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-directory</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-ephemeron-hash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-ephemeron-hash</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-ephemeron-hash-keys%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-ephemeron-hash-keys</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-ephemeron-hash-pairs%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-ephemeron-hash-pairs</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-ephemeron-hash-values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-ephemeron-hash-values</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._in-extflvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-extflvector</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._in-flvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-flvector</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._in-fxvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-fxvector</span></span><br/></a><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._in-generator%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">in-generator</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-hash</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash-keys%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-hash-keys</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash-pairs%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-hash-pairs</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash-values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-hash-values</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-immutable-hash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-immutable-hash</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-immutable-hash-keys%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-immutable-hash-keys</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-immutable-hash-pairs%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-immutable-hash-pairs</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-immutable-hash-values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-immutable-hash-values</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._in-immutable-set%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-immutable-set</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-inclusive-range%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-inclusive-range</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-indexed%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-indexed</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-input-port-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-input-port-bytes</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-input-port-chars%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-input-port-chars</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-lines%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-lines</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-list</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mlist%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-mlist</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mutable-hash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-mutable-hash</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mutable-hash-keys%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-mutable-hash-keys</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mutable-hash-pairs%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-mutable-hash-pairs</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mutable-hash-values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-mutable-hash-values</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._in-mutable-set%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-mutable-set</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-naturals%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-naturals</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-parallel%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-parallel</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._in-permutations%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-permutations</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-port</span></span><br/></a><a href="pairs.html#%28idx._%28gentag._188._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">in-powerset<br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-producer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-producer</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-range</span></span><br/></a><a href="pairs.html#%28idx._%28gentag._190._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">in-rearrangements<br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-sequences%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-sequences</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._in-set%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-set</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._in-slice%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-slice</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._in-stream%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-stream</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-string</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._in-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-syntax</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-value%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-value</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-values%2A-sequence%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-values*-sequence</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-values-sequence%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-values-sequence</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-vector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-vector</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-weak-hash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-weak-hash</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-weak-hash-keys%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-weak-hash-keys</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-weak-hash-pairs%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-weak-hash-pairs</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-weak-hash-values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-weak-hash-values</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._in-weak-set%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-weak-set</span></span><br/></a><a href="include.html#%28form._%28%28lib._racket%2Finclude..rkt%29._include%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">include</span></span><br/></a><a href="include.html#%28form._%28%28lib._racket%2Finclude..rkt%29._include-at%2Frelative-to%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">include-at/relative-to</span></span><br/></a><a href="include.html#%28form._%28%28lib._racket%2Finclude..rkt%29._include-at%2Frelative-to%2Freader%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">include-at/relative-to/reader</span></span><br/></a><a href="include.html#%28form._%28%28lib._racket%2Finclude..rkt%29._include%2Freader%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">include/reader</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._inclusive-range%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">inclusive-range</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._index-of%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">index-of</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._index-where%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">index-where</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._indexes-of%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">indexes-of</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._indexes-where%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">indexes-where</span></span><br/></a><a href="numbers.html#%28tech._inexact._number%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">inexact number</span><br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact-~3eexact%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">inexact-&gt;exact</span></span><br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact-real~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">inexact-real?</span></span><br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">inexact?</span></span><br/></a><a href="runtime.html#%28idx._%28gentag._443._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">infer</span><br/></a><a href="linkinference.html" class="indexlink" data-pltdoc="x">Inferred Linking<br/></a><a href="syntax-model.html#%28part._infernames%29" class="indexlink" data-pltdoc="x">Inferred Value Names<br/></a><a href="syntax-model.html#%28idx._%28gentag._2._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">inferred-name</span><br/></a><a href="Generators.html#%28form._%28%28lib._racket%2Fgenerator..rkt%29._infinite-generator%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">infinite-generator</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._infinite~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">infinite?</span></span><br/></a><a href="numbers.html#%28idx._%28gentag._112._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">infinity<br/></a><a href="reader.html#%28idx._%28gentag._30._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">infix<br/></a><a href="Expanding_Top-Level_Forms.html#%28part._modinfo%29" class="indexlink" data-pltdoc="x">Information on Expanded Modules<br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">inherit</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit-field%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">inherit-field</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Finner%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">inherit/inner</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Fsuper%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">inherit/super</span></span><br/></a><a href="mzlib_class.html#%28tech._inheritance%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">inheritance</span><br/></a><a href="createclass.html#%28part._classinherit%29" class="indexlink" data-pltdoc="x">Inherited and Superclass Methods<br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">init</span></span><br/></a><a href="running-sa.html#%28part._.Init_.Libraries%29" class="indexlink" data-pltdoc="x">Init Libraries<br/></a><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._init-depend%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">init-depend</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._332._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">init-dir</span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-field%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">init-field</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._333._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">init-file</span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-rest%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">init-rest</span></span><br/></a><a href="running-sa.html#%28part._init-actions%29" class="indexlink" data-pltdoc="x">Initialization<br/></a><a href="createclass.html#%28part._clinitvars%29" class="indexlink" data-pltdoc="x">Initialization Variables<br/></a><a href="sequences.html#%28tech._initiate%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">initiate</span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inner%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">inner</span></span><br/></a><a href="file-ports.html#%28idx._%28gentag._261._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">inode<br/></a><a href="Filesystem.html#%28idx._%28gentag._359._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">inode<br/></a><a href="Filesystem.html#%28idx._%28gentag._361._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">inode</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._379._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">inode<br/></a><a href="input-and-output.html" class="indexlink" data-pltdoc="x">Input and Output<br/></a><a href="ports.html#%28tech._input._port%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">input port</span><br/></a><a href="regexp.html" class="indexlink" data-pltdoc="x">input ports, pattern matching<br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._input-port-append%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">input-port-append</span></span><br/></a><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">input-port?</span></span><br/></a><a href="syntax-model.html#%28tech._inside._edge._scope%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">inside-edge scope</span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inspect%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">inspect</span></span><br/></a><a href="compiler.html#%28part._compiler-inspect%29" class="indexlink" data-pltdoc="x">Inspecting Compiler Passes<br/></a><a href="inspectors.html#%28tech._inspector%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">inspector</span><br/></a><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector-superior~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">inspector-superior?</span></span><br/></a><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">inspector?</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-data%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">instance-data</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-describe-variable%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym">instance-describe-variable!</span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-name%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">instance-name</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-set-variable-value%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">instance-set-variable-value!</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-unset-variable%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">instance-unset-variable!</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-variable-names%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">instance-variable-names</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-variable-value%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">instance-variable-value</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">instance?</span></span><br/></a><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._instanceof%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">instanceof/c</span></span><br/></a><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._instantiate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">instantiate</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instantiate-linklet%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">instantiate-linklet</span></span><br/></a><a href="eval-model.html#%28tech._instantiate%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">instantiates</span><br/></a><a href="eval-model.html#%28tech._instantiation%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">instantiation</span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._integer-~3echar%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">integer-&gt;char</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-~3einteger-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">integer-&gt;integer-bytes</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-bytes-~3einteger%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">integer-bytes-&gt;integer</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">integer-in</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">integer-length</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-sqrt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">integer-sqrt</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-sqrt%2Fremainder%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">integer-sqrt/remainder</span></span><br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">integer?</span></span><br/></a><a href="numbers.html#%28tech._integer%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">integers</span><br/></a><a href="Sandboxed_Evaluation.html#%28part._.Interacting_with_.Evaluators%29" class="indexlink" data-pltdoc="x">Interacting with Evaluators<br/></a><a href="interaction-info.html" class="indexlink" data-pltdoc="x">Interaction Configuration<br/></a><a href="eval.html#%28tech._interaction._event._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">interaction event
+handler</span><br/></a><a href="eval.html#%28tech._interaction._port._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">interaction port handler</span><br/></a><a href="__top-interaction.html" class="indexlink" data-pltdoc="x">Interaction Wrapper: <span class="RktSym"><span class="RktStxLink">#%top-interaction</span></span><br/></a><a href="Interactive_Help.html" class="indexlink" data-pltdoc="x">Interactive Help<br/></a><a href="interactive.html" class="indexlink" data-pltdoc="x">Interactive Module Loading<br/></a><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">interface</span></span><br/></a><a href="mzlib_class.html#%28tech._interface%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">interface</span><br/></a><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">interface*</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface-~3emethod-names%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">interface-&gt;method-names</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface-extension~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">interface-extension?</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">interface?</span></span><br/></a><a href="createclass.html#%28part._extnames%29" class="indexlink" data-pltdoc="x">Internal and External Names<br/></a><a href="syntax-model.html#%28part._intdef-body%29" class="indexlink" data-pltdoc="x">Internal Definitions<br/></a><a href="syntax-model.html#%28tech._internal._definition._context%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">internal-definition context</span><br/></a><a href="stratified-body.html" class="indexlink" data-pltdoc="x">Internal-Definition Limiting: <span class="RktSym"><span class="RktStxLink">#%stratified-body</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-add-scopes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">internal-definition-context-add-scopes</span></span><br/></a><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._internal-definition-context-apply%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">internal-definition-context-apply</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-binding-identifiers%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">internal-definition-context-binding-identifiers</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-introduce%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">internal-definition-context-introduce</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-seal%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">internal-definition-context-seal</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-splice-binding-identifier%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">internal-definition-context-splice-binding-identifier</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">internal-definition-context?</span></span><br/></a><a href="reader.html#%28tech._interned%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">interned</span><br/></a><a href="syntax-model.html#%28part._intro-binding%29" class="indexlink" data-pltdoc="x">Introducing Bindings<br/></a><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._invariant-assertion%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">invariant-assertion</span></span><br/></a><a href="invokingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._invoke-unit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">invoke-unit</span></span><br/></a><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._invoke-unit%2Finfer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">invoke-unit/infer</span></span><br/></a><a href="mzlib_unit.html#%28tech._invoked%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">invoked</span><br/></a><a href="invokingunits.html" class="indexlink" data-pltdoc="x">Invoking Units<br/></a><a href="udp.html#%28idx._%28gentag._382._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">IP_MULTICAST_LOOP</span><br/></a><a href="udp.html#%28idx._%28gentag._383._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">IP_MULTICAST_TTL</span><br/></a><a href="udp.html#%28idx._%28gentag._381._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">IP_TTL</span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._is-a~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">is-a?</span></span><br/></a><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._is-a~3f%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">is-a?/c</span></span><br/></a><a href="for.html#%28part._.Iteration_and_.Comprehension_.Forms%29" class="indexlink" data-pltdoc="x">Iteration and Comprehension Forms<br/></a><a href="stx-patterns.html#%28tech._iteration._pattern._variable%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">iteration pattern variable</span><br/></a><a href="for.html" class="indexlink" data-pltdoc="x">Iterations and Comprehensions: <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/list</span></span>, ...<br/></a><a href="sequences.html#%28tech._iterator%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">iterator</span><br/></a><a name="alpha:J"></a><span><a href="eval.html#%28tech._jit%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">JIT</span><br/></a></span><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._julian%2Fscaliger-~3estring%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">julian/scaliger-&gt;string</span></span><br/></a><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._julian%2Fscalinger-~3estring%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">julian/scalinger-&gt;string</span></span><br/></a><a name="alpha:K"></a><span><a href="Kernel_Forms_and_Functions.html" class="indexlink" data-pltdoc="x">Kernel Forms and Functions<br/></a></span><a href="keywords.html#%28tech._keyword%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">keyword</span><br/></a><a href="keywords.html#%28def._%28%28lib._racket%2Fkeyword..rkt%29._keyword-~3eimmutable-string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">keyword-&gt;immutable-string</span></span><br/></a><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword-~3estring%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">keyword-&gt;string</span></span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._keyword-apply%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">keyword-apply</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._keyword-apply%2Fdict%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">keyword-apply/dict</span></span><br/></a><a href="stxtrans.html#%28part._keyword-trans%29" class="indexlink" data-pltdoc="x">Keyword-Argument Conversion Introspection<br/></a><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3c~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">keyword&lt;?</span></span><br/></a><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">keyword?</span></span><br/></a><a href="keywords.html" class="indexlink" data-pltdoc="x">Keywords<br/></a><a href="procedures.html#%28part._.Keywords_and_.Arity%29" class="indexlink" data-pltdoc="x">Keywords and Arity<br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._kill-evaluator%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">kill-evaluator</span></span><br/></a><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._kill-thread%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">kill-thread</span></span><br/></a><a name="alpha:L"></a><span><a href="syntax-model.html#%28tech._label._phase._level%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">label phase level</span><br/></a></span><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">lambda</span></span><br/></a><a href="runtime.html#%28idx._%28gentag._447._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">LANG</span><br/></a><a href="model.html" class="indexlink" data-pltdoc="x">Language Model<br/></a><a href="running-sa.html#%28part._configure-runtime%29" class="indexlink" data-pltdoc="x">Language Run-Time Configuration<br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._last%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">last</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._last-pair%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">last-pair</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28tech._late._neg._projection%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">late neg projection</span><br/></a><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._lazy%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">lazy</span></span><br/></a><a href="Lazy_Data-structure_Contracts.html" class="indexlink" data-pltdoc="x">Lazy Data-structure Contracts<br/></a><a href="lazy-require.html#%28form._%28%28lib._racket%2Flazy-require..rkt%29._lazy-require%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">lazy-require</span></span><br/></a><a href="lazy-require.html#%28form._%28%28lib._racket%2Flazy-require..rkt%29._lazy-require-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">lazy-require-syntax</span></span><br/></a><a href="runtime.html#%28idx._%28gentag._445._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">LC_ALL</span><br/></a><a href="runtime.html#%28idx._%28gentag._446._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">LC_TYPE</span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._lcm%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">lcm</span></span><br/></a><a href="generic-numbers.html#%28idx._%28gentag._124._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">least common multiple<br/></a><a href="Legacy_Contracts.html" class="indexlink" data-pltdoc="x">Legacy Contracts<br/></a><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._legacy-match-expander~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">legacy-match-expander?</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">length</span></span><br/></a><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">let</span></span><br/></a><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">let*</span></span><br/></a><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A-values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">let*-values</span></span><br/></a><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">let-syntax</span></span><br/></a><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntaxes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">let-syntaxes</span></span><br/></a><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">let-values</span></span><br/></a><a href="cont.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._let%2Fcc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">let/cc</span></span><br/></a><a href="cont.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2Fec%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">let/ec</span></span><br/></a><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">letrec</span></span><br/></a><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">letrec-syntax</span></span><br/></a><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec-syntaxes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">letrec-syntaxes</span></span><br/></a><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">letrec-syntaxes+values</span></span><br/></a><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">letrec-values</span></span><br/></a><a href="stxcmp.html#%28idx._%28gentag._231._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">lexical</span><br/></a><a href="syntax-model.html#%28tech._lexical._information%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">lexical information</span><br/></a><a href="eval-model.html#%28tech._lexical._scoping%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">lexical scoping</span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">lib</span></span><br/></a><a href="stxtrans.html#%28tech._liberal._expansion%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">liberal expansion</span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._liberal-define-context~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">liberal-define-context?</span></span><br/></a><a href="collects.html" class="indexlink" data-pltdoc="x">Libraries and Collections<br/></a><a href="collects.html#%28tech._library%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">library</span><br/></a><a href="match.html#%28part._.Library_.Extensions%29" class="indexlink" data-pltdoc="x">Library Extensions<br/></a><a href="port-buffers.html#%28idx._%28gentag._246._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">line</span><br/></a><a href="linecol.html#%28tech._line._location%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">line locations</span><br/></a><a href="linecol.html" class="indexlink" data-pltdoc="x">line numbers<br/></a><a href="pretty-print.html#%28part._.Line-.Output_.Hook%29" class="indexlink" data-pltdoc="x">Line-Output Hook<br/></a><a href="Byte_and_String_Input.html#%28idx._%28gentag._263._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">linefeed</span><br/></a><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">link</span></span><br/></a><a href="runtime.html#%28idx._%28gentag._428._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">link</span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._link-exists~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">link-exists?</span></span><br/></a><a href="mzlib_unit.html#%28tech._linked%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">linked</span><br/></a><a href="compoundunits.html" class="indexlink" data-pltdoc="x">Linking Units and Creating Compound Units<br/></a><a href="linklets.html#%28tech._linklet%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">linklet</span><br/></a><a href="linklets.html#%28tech._linklet._bundle%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">linklet bundle</span><br/></a><a href="linklets.html#%28tech._linklet._directory%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">linklet directory</span><br/></a><a href="linklets.html#%28tech._linklet._instance%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">linklet instance</span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-body-reserved-symbol~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">linklet-body-reserved-symbol?</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-bundle-~3ehash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">linklet-bundle-&gt;hash</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-bundle~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">linklet-bundle?</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-directory-~3ehash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">linklet-directory-&gt;hash</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-directory~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">linklet-directory?</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-export-variables%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">linklet-export-variables</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-import-variables%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">linklet-import-variables</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">linklet?</span></span><br/></a><a href="linklets.html" class="indexlink" data-pltdoc="x">Linklets and the Core Compiler<br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list</span></span><br/></a><a href="match.html#%28idx._%28gentag._203._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">list<br/></a><a href="pairs.html#%28tech._list%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">list</span><br/></a><a href="pairs.html#%28part._.List_.Filtering%29" class="indexlink" data-pltdoc="x">List Filtering<br/></a><a href="pairs.html#%28part._.List_.Iteration%29" class="indexlink" data-pltdoc="x">List Iteration<br/></a><a href="pairs.html#%28part._.List_.Operations%29" class="indexlink" data-pltdoc="x">List Operations<br/></a><a href="pairs.html#%28part._.List_.Searching%29" class="indexlink" data-pltdoc="x">List Searching<br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list*</span></span><br/></a><a href="match.html#%28idx._%28gentag._205._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">list*<br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Aof%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list*of</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._list-~3ebytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-&gt;bytes</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3emutable-set%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-&gt;mutable-set</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3emutable-setalw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-&gt;mutable-setalw</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3emutable-seteq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-&gt;mutable-seteq</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3emutable-seteqv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-&gt;mutable-seteqv</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eset%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-&gt;set</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3esetalw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-&gt;setalw</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eseteq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-&gt;seteq</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eseteqv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-&gt;seteqv</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._list-~3estring%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-&gt;string</span></span><br/></a><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._list-~3evector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-&gt;vector</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eweak-set%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-&gt;weak-set</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eweak-setalw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-&gt;weak-setalw</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eweak-seteq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-&gt;weak-seteq</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eweak-seteqv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-&gt;weak-seteqv</span></span><br/></a><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._list-contract~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-contract?</span></span><br/></a><a href="match.html#%28idx._%28gentag._206._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">list-no-order<br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._list-prefix~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-prefix?</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-ref</span></span><br/></a><a href="match.html#%28idx._%28gentag._204._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">list-rest<br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._list-set%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-set</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list-tail%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-tail</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._list-update%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-update</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list/c</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list?</span></span><br/></a><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._listen-port-number~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">listen-port-number?</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">listof</span></span><br/></a><a href="quote.html" class="indexlink" data-pltdoc="x">Literals: <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span><br/></a><a href="characters.html#%28idx._%28gentag._152._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">ll</span><br/></a><a href="characters.html#%28idx._%28gentag._154._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">lm</span><br/></a><a href="characters.html#%28idx._%28gentag._155._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">lo</span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">load</span></span><br/></a><a href="eval.html#%28tech._load._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">load handler</span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load-extension%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">load-extension</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load-on-demand-enabled%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">load-on-demand-enabled</span></span><br/></a><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._load-relative%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">load-relative</span></span><br/></a><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._load-relative-extension%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">load-relative-extension</span></span><br/></a><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._load%2Fcd%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">load/cd</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%2Fuse-compiled%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">load/use-compiled</span></span><br/></a><a href="interactive.html#%28part._rerequire%29" class="indexlink" data-pltdoc="x">Loading and Reloading Modules<br/></a><a href="local.html#%28form._%28%28lib._racket%2Flocal..rkt%29._local%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">local</span></span><br/></a><a href="syntax-model.html#%28part._local-binding-context%29" class="indexlink" data-pltdoc="x">Local Binding Context<br/></a><a href="syntax-model.html#%28tech._local._binding._context%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">local binding context</span><br/></a><a href="splicing.html" class="indexlink" data-pltdoc="x">Local Binding with Splicing Body<br/></a><a href="let.html" class="indexlink" data-pltdoc="x">Local Binding: <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...<br/></a><a href="syntax-model.html#%28tech._local._binding%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">local
+bindings</span><br/></a><a href="local.html" class="indexlink" data-pltdoc="x">Local Definitions: <span class="RktSym"><span class="RktStxLink">local</span></span><br/></a><a href="eval-model.html#%28tech._local._variable%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">local variable</span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">local-expand</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%2Fcapture-lifts%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">local-expand/capture-lifts</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._local-require%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">local-require</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-transformer-expand%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">local-transformer-expand</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-transformer-expand%2Fcapture-lifts%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">local-transformer-expand/capture-lifts</span></span><br/></a><a href="encodings.html#%28tech._locale%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">locale</span><br/></a><a href="strings.html#%28part._.Locale-.Specific_.String_.Operations%29" class="indexlink" data-pltdoc="x">Locale-Specific String Operations<br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._locale-string-encoding%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">locale-string-encoding</span></span><br/></a><a href="Filesystem.html#%28part._findpaths%29" class="indexlink" data-pltdoc="x">Locating Paths<br/></a><a href="eval-model.html#%28tech._location%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">location</span><br/></a><a href="Locations____variable-reference.html" class="indexlink" data-pltdoc="x">Locations: <span class="RktSym"><span class="RktStxLink">#%variable-reference</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._log%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">log</span></span><br/></a><a href="logging.html#%28tech._log._receiver%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">log receiver</span><br/></a><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-all-levels%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">log-all-levels</span></span><br/></a><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-debug%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">log-debug</span></span><br/></a><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-error%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">log-error</span></span><br/></a><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-fatal%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">log-fatal</span></span><br/></a><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-info%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">log-info</span></span><br/></a><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-level-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">log-level-evt</span></span><br/></a><a href="logging.html#%28def._%28%28lib._racket%2Flogging..rkt%29._log-level%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">log-level/c</span></span><br/></a><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-level~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">log-level?</span></span><br/></a><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-max-level%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">log-max-level</span></span><br/></a><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-message%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">log-message</span></span><br/></a><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-receiver~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">log-receiver?</span></span><br/></a><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-warning%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">log-warning</span></span><br/></a><a href="logging.html#%28tech._logger%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">logger</span><br/></a><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger-name%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">logger-name</span></span><br/></a><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">logger?</span></span><br/></a><a href="logging.html" class="indexlink" data-pltdoc="x">Logging<br/></a><a href="logging.html#%28part._.Logging_.Events%29" class="indexlink" data-pltdoc="x">Logging Events<br/></a><a href="generic-numbers.html#%28idx._%28gentag._126._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">logical operators<br/></a><a href="Filesystem.html#%28idx._%28gentag._321._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">LOGNAME</span><br/></a><a href="runtime.html#%28idx._%28gentag._440._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">low-latency</span><br/></a><a href="attaching-contracts-to-values.html#%28part._.Low-level_.Contract_.Boundaries%29" class="indexlink" data-pltdoc="x">Low-level Contract Boundaries<br/></a><a href="windowspaths.html#%28idx._%28gentag._306._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"LPT1"</span><br/></a><a href="windowspaths.html#%28idx._%28gentag._307._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"LPT2"</span><br/></a><a href="windowspaths.html#%28idx._%28gentag._308._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"LPT3"</span><br/></a><a href="windowspaths.html#%28idx._%28gentag._309._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"LPT4"</span><br/></a><a href="windowspaths.html#%28idx._%28gentag._310._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"LPT5"</span><br/></a><a href="windowspaths.html#%28idx._%28gentag._311._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"LPT6"</span><br/></a><a href="windowspaths.html#%28idx._%28gentag._312._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"LPT7"</span><br/></a><a href="windowspaths.html#%28idx._%28gentag._313._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"LPT8"</span><br/></a><a href="windowspaths.html#%28idx._%28gentag._314._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"LPT9"</span><br/></a><a href="characters.html#%28idx._%28gentag._153._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">lt</span><br/></a><a href="characters.html#%28idx._%28gentag._151._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">lu</span><br/></a><a name="alpha:M"></a><span><a href="runtime.html#%28idx._%28gentag._433._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">machine</span><br/></a></span><a href="memory-order.html" class="indexlink" data-pltdoc="x">Machine Memory Order<br/></a><a href="runtime.html#%28idx._%28gentag._417._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">macosx</span><br/></a><a href="syntax-model.html#%28tech._macro%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">macro</span><br/></a><a href="syntax-model.html#%28part._macro-introduced-bindings%29" class="indexlink" data-pltdoc="x">Macro-Introduced Bindings<br/></a><a href="syntax-model.html#%28tech._macro._introduction._scope%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">macro-introduction scope</span><br/></a><a href="Macros.html" class="indexlink" data-pltdoc="x">Macros<br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._magnitude%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">magnitude</span></span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-arity-at-least%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-arity-at-least</span></span><br/></a><a href="async-channel.html#%28def._%28%28lib._racket%2Fasync-channel..rkt%29._make-async-channel%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-async-channel</span></span><br/></a><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-base-empty-namespace%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-base-empty-namespace</span></span><br/></a><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-base-namespace%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-base-namespace</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._make-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-bytes</span></span><br/></a><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._make-channel%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-channel</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._make-chaperone-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-chaperone-contract</span></span><br/></a><a href="structutils.html#%28def._%28%28lib._racket%2Fstruct..rkt%29._make-constructor-style-printer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-constructor-style-printer</span></span><br/></a><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-mark-key%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-continuation-mark-key</span></span><br/></a><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-prompt-tag%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-continuation-prompt-tag</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._make-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-contract</span></span><br/></a><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._make-custodian%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-custodian</span></span><br/></a><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._make-custodian-box%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-custodian-box</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._make-custom-hash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-custom-hash</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._make-custom-hash-types%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-custom-hash-types</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._make-custom-set-types%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-custom-set-types</span></span><br/></a><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-date%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-date</span></span><br/></a><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-date%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-date*</span></span><br/></a><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._make-derived-parameter%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-derived-parameter</span></span><br/></a><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._make-deserialize-info%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-deserialize-info</span></span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._make-directory%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-directory</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-directory%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-directory*</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-do-sequence%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-do-sequence</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._make-empty-namespace%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-empty-namespace</span></span><br/></a><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._make-environment-variables%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-environment-variables</span></span><br/></a><a href="ephemerons.html#%28def._%28%28quote._~23~25kernel%29._make-ephemeron%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-ephemeron</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-ephemeron-hash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-ephemeron-hash</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-ephemeron-hashalw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-ephemeron-hashalw</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-ephemeron-hasheq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-ephemeron-hasheq</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-ephemeron-hasheqv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-ephemeron-hasheqv</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-evaluator%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-evaluator</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3abreak%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:break</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3abreak~3ahang-up%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:break:hang-up</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3abreak~3aterminate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:break:terminate</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3acontract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:contract</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3acontract~3aarity%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:contract:arity</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._make-exn~3afail~3acontract~3ablame%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:contract:blame</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3acontract~3acontinuation%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:contract:continuation</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3acontract~3adivide-by-zero%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:contract:divide-by-zero</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3acontract~3anon-fixnum-result%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:contract:non-fixnum-result</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3acontract~3avariable%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:contract:variable</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3afilesystem%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:filesystem</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3afilesystem~3aerrno%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:filesystem:errno</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3afilesystem~3aexists%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:filesystem:exists</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3afilesystem~3amissing-module%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:filesystem:missing-module</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3afilesystem~3aversion%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:filesystem:version</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3anetwork%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:network</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3anetwork~3aerrno%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:network:errno</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._make-exn~3afail~3aobject%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:object</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3aout-of-memory%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:out-of-memory</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3aread%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:read</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3aread~3aeof%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:read:eof</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3aread~3anon-char%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:read:non-char</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3asyntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:syntax</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3asyntax~3amissing-module%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:syntax:missing-module</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3asyntax~3aunbound%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:syntax:unbound</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3aunsupported%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:unsupported</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3auser%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-exn:fail:user</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._make-export%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-export</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._make-extflvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-extflvector</span></span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._make-file-or-directory-link%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-file-or-directory-link</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._make-flat-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-flat-contract</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._make-flrectangular%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-flrectangular</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._make-flvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-flvector</span></span><br/></a><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._make-fsemaphore%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-fsemaphore</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._make-fxvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-fxvector</span></span><br/></a><a href="ivaraccess.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._make-generic%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-generic</span></span><br/></a><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._make-generic-struct-type-property%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">make-generic-struct-type-property</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-handle-get-preference-locked%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-handle-get-preference-locked</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-hash</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-hash-placeholder%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-hash-placeholder</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hashalw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-hashalw</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-hashalw-placeholder%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-hashalw-placeholder</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hasheq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-hasheq</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-hasheq-placeholder%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-hasheq-placeholder</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hasheqv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-hasheqv</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-hasheqv-placeholder%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-hasheqv-placeholder</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._make-immutable-custom-hash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-immutable-custom-hash</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-immutable-hash</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hashalw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-immutable-hashalw</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hasheq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-immutable-hasheq</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hasheqv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-immutable-hasheqv</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._make-impersonator-property%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-impersonator-property</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._make-import%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-import</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._make-import-source%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-import-source</span></span><br/></a><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-input-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-input-port</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._make-input-port%2Fread-to-peek%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-input-port/read-to-peek</span></span><br/></a><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._make-inspector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-inspector</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._make-instance%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-instance</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-interned-syntax-introducer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-interned-syntax-introducer</span></span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-keyword-procedure%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-keyword-procedure</span></span><br/></a><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._make-known-char-range-list%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-known-char-range-list</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._make-limited-input-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-limited-input-port</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._make-list%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-list</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-lock-file-name%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-lock-file-name</span></span><br/></a><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._make-log-receiver%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-log-receiver</span></span><br/></a><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._make-logger%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-logger</span></span><br/></a><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._make-mixin-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-mixin-contract</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._make-module-evaluator%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-module-evaluator</span></span><br/></a><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._make-none%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-none/c</span></span><br/></a><a href="objcreation.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._make-object%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-object</span></span><br/></a><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-output-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-output-port</span></span><br/></a><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._make-parameter%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-parameter</span></span><br/></a><a href="stxparam.html#%28def._%28%28lib._racket%2Fstxparam-exptime..rkt%29._make-parameter-rename-transformer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-parameter-rename-transformer</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-parent-directory%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-parent-directory*</span></span><br/></a><a href="phantom-bytes.html#%28def._%28%28quote._~23~25kernel%29._make-phantom-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-phantom-bytes</span></span><br/></a><a href="pipeports.html#%28def._%28%28quote._~23~25kernel%29._make-pipe%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-pipe</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._make-pipe-with-specials%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-pipe-with-specials</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-placeholder%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-placeholder</span></span><br/></a><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._make-plumber%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-plumber</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._make-polar%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-polar</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-portal-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-portal-syntax</span></span><br/></a><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._make-prefab-struct%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-prefab-struct</span></span><br/></a><a href="Legacy_Contracts.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._make-proj-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-proj-contract</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._make-provide-pre-transformer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-provide-pre-transformer</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._make-provide-transformer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-provide-transformer</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._make-pseudo-random-generator%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-pseudo-random-generator</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-reader-graph%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-reader-graph</span></span><br/></a><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._make-readtable%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-readtable</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._make-rectangular%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-rectangular</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-rename-transformer</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._make-require-transformer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-require-transformer</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._make-resolved-module-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-resolved-module-path</span></span><br/></a><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._make-security-guard%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-security-guard</span></span><br/></a><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._make-semaphore%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-semaphore</span></span><br/></a><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._make-serialize-info%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-serialize-info</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-set%21-transformer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-set!-transformer</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._make-shared-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-shared-bytes</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._make-shared-extflvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-shared-extflvector</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._make-shared-flvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-shared-flvector</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._make-shared-fxvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-shared-fxvector</span></span><br/></a><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._make-sibling-inspector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-sibling-inspector</span></span><br/></a><a href="special-comments.html#%28def._%28%28quote._~23~25kernel%29._make-special-comment%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-special-comment</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-srcloc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-srcloc</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._make-string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-string</span></span><br/></a><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-field-accessor%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-struct-field-accessor</span></span><br/></a><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-field-mutator%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-struct-field-mutator</span></span><br/></a><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._make-struct-info%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-struct-info</span></span><br/></a><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-struct-type</span></span><br/></a><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type-property%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-struct-type-property</span></span><br/></a><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._make-struct-type-property%2Fgeneric%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">make-struct-type-property/generic</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-syntax-delta-introducer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-syntax-delta-introducer</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-syntax-introducer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-syntax-introducer</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-directory%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-temporary-directory</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-directory%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-temporary-directory*</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-file%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-temporary-file</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._make-temporary-file%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-temporary-file*</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._make-tentative-pretty-print-output-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-tentative-pretty-print-output-port</span></span><br/></a><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._make-thread-cell%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-thread-cell</span></span><br/></a><a href="threadgroups.html#%28def._%28%28quote._~23~25kernel%29._make-thread-group%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-thread-group</span></span><br/></a><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._make-vector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-vector</span></span><br/></a><a href="weakbox.html#%28def._%28%28quote._~23~25kernel%29._make-weak-box%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-weak-box</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._make-weak-custom-hash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-weak-custom-hash</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-weak-hash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-weak-hash</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-weak-hashalw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-weak-hashalw</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-weak-hasheq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-weak-hasheq</span></span><br/></a><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-weak-hasheqv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-weak-hasheqv</span></span><br/></a><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._make-will-executor%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-will-executor</span></span><br/></a><a href="port-ops.html" class="indexlink" data-pltdoc="x">Managing Ports<br/></a><a href="Manipulating_Paths.html" class="indexlink" data-pltdoc="x">Manipulating Paths<br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">map</span></span><br/></a><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match</span></span><br/></a><a href="match.html#%28tech._match._expander%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">match expander</span><br/></a><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match*</span></span><br/></a><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%2A%2Fderived%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match*/derived</span></span><br/></a><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-define%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-define</span></span><br/></a><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-define-values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-define-values</span></span><br/></a><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._match-equality-test%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">match-equality-test</span></span><br/></a><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._match-expander~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">match-expander?</span></span><br/></a><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-lambda%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-lambda</span></span><br/></a><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-lambda%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-lambda*</span></span><br/></a><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-lambda%2A%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-lambda**</span></span><br/></a><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-let%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-let</span></span><br/></a><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-let%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-let*</span></span><br/></a><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-let%2A-values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-let*-values</span></span><br/></a><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-let-values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-let-values</span></span><br/></a><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-letrec%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-letrec</span></span><br/></a><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-letrec-values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-letrec-values</span></span><br/></a><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%2Fderived%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match/derived</span></span><br/></a><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%2Fvalues%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match/values</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._matching-identifiers-in%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">matching-identifiers-in</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprovide..rkt%29._matching-identifiers-out%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">matching-identifiers-out</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._max%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">max</span></span><br/></a><a href="characters.html#%28idx._%28gentag._157._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">mc</span><br/></a><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcar%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">mcar</span></span><br/></a><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcdr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">mcdr</span></span><br/></a><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">mcons</span></span><br/></a><a href="match.html#%28idx._%28gentag._210._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">mcons<br/></a><a href="characters.html#%28idx._%28gentag._158._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">me</span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">member</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">member-name-key</span></span><br/></a><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key-hash-code%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">member-name-key-hash-code</span></span><br/></a><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">member-name-key=?</span></span><br/></a><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._member-name-key~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">member-name-key?</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._memf%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">memf</span></span><br/></a><a href="memory.html" class="indexlink" data-pltdoc="x">Memory Management<br/></a><a href="memory-order.html#%28def._%28%28quote._~23~25kernel%29._memory-order-acquire%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">memory-order-acquire</span></span><br/></a><a href="memory-order.html#%28def._%28%28quote._~23~25kernel%29._memory-order-release%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">memory-order-release</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._memq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">memq</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._memv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">memv</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._memw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">memw</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._merge%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">merge</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._merge-input%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">merge-input</span></span><br/></a><a href="notation.html#%28tech._metavariable%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">metavariables</span><br/></a><a href="createclass.html#%28part._clmethoddefs%29" class="indexlink" data-pltdoc="x">Method Definitions<br/></a><a href="lambda.html#%28idx._%28gentag._107._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">method-arity-error</span><br/></a><a href="procedures.html#%28idx._%28gentag._192._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">method-arity-error</span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._method-in-interface~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">method-in-interface?</span></span><br/></a><a href="createclass.html#%28part._clmethods%29" class="indexlink" data-pltdoc="x">Methods<br/></a><a href="ivaraccess.html#%28part._methodcalls%29" class="indexlink" data-pltdoc="x">Methods<br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._min%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">min</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28part._.Miscellaneous%29" class="indexlink" data-pltdoc="x">Miscellaneous<br/></a><a href="syntax-util.html#%28part._.Miscellaneous_utilities%29" class="indexlink" data-pltdoc="x">Miscellaneous utilities<br/></a><a href="mixins.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._mixin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">mixin</span></span><br/></a><a href="mixins.html#%28tech._mixin%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">mixin</span><br/></a><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._mixin-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">mixin-contract</span></span><br/></a><a href="mixins.html" class="indexlink" data-pltdoc="x">Mixins<br/></a><a href="characters.html#%28idx._%28gentag._156._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">mn</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._362._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">mode</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._375._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">modify-time-nanoseconds</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._371._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">modify-time-seconds</span><br/></a><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">module</span></span><br/></a><a href="syntax-model.html#%28tech._module._binding%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">module binding</span><br/></a><a href="Module_Names_and_Loading.html#%28part._modcache%29" class="indexlink" data-pltdoc="x">Module Cache<br/></a><a href="syntax-model.html#%28tech._module._context%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">module context</span><br/></a><a href="syntax-model.html#%28part._mod-parse%29" class="indexlink" data-pltdoc="x">Module Expansion, Phases, and Visits<br/></a><a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">module name
+resolver</span><br/></a><a href="Module_Names_and_Loading.html" class="indexlink" data-pltdoc="x">Module Names and Loading<br/></a><a href="Module_Names_and_Loading.html#%28tech._module._path%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">module path</span><br/></a><a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">module path index</span><br/></a><a href="Module_Names_and_Loading.html#%28tech._module._path._resolver%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">module path resolver</span><br/></a><a href="eval-model.html#%28part._module-redeclare%29" class="indexlink" data-pltdoc="x">Module Redeclarations<br/></a><a href="syntax-model.html#%28tech._module._registry%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">module registry</span><br/></a><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">module*</span></span><br/></a><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._module%2B%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">module+</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3eexports%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-&gt;exports</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3eimports%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-&gt;imports</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3eindirect-exports%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-&gt;indirect-exports</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3elanguage-info%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-&gt;language-info</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._module-~3enamespace%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-&gt;namespace</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3erealm%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-&gt;realm</span></span><br/></a><a href="syntax-model.html#%28tech._module._begin._context%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">module-begin context</span><br/></a><a href="Expanding_Top-Level_Forms.html#%28idx._%28gentag._241._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">module-body-context</span><br/></a><a href="Expanding_Top-Level_Forms.html#%28idx._%28gentag._243._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">module-body-context-simple?</span><br/></a><a href="Expanding_Top-Level_Forms.html#%28idx._%28gentag._242._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">module-body-inside-context</span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-cache-clear%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-cache-clear!</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-cross-phase-persistent~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-compiled-cross-phase-persistent?</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-exports%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-compiled-exports</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-imports%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-compiled-imports</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-indirect-exports%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-compiled-indirect-exports</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-language-info%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-compiled-language-info</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-name%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-compiled-name</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-realm%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-compiled-realm</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-submodules%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-compiled-submodules</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-declared~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-declared?</span></span><br/></a><a href="Module_Names_and_Loading.html#%28idx._%28gentag._279._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">module-language</span><br/></a><a href="module.html#%28idx._%28gentag._99._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">module-language</span><br/></a><a href="eval-model.html#%28tech._module._level._variable%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">module-level
+variable</span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index-join%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-path-index-join</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index-resolve%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-path-index-resolve</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index-split%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-path-index-split</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index-submodule%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-path-index-submodule</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-path-index?</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-path?</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-predefined~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-predefined?</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._module-provide-protected~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">module-provide-protected?</span></span><br/></a><a href="eval-model.html#%28idx._%28gentag._1._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">modules, re-define<br/></a><a href="require.html" class="indexlink" data-pltdoc="x">modules, imports<br/></a><a href="require.html" class="indexlink" data-pltdoc="x">modules, exports<br/></a><a href="eval-model.html#%28tech._module%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">modules</span><br/></a><a href="eval-model.html#%28part._module-eval-model%29" class="indexlink" data-pltdoc="x">Modules and Module-Level Variables<br/></a><a href="module.html" class="indexlink" data-pltdoc="x">Modules: <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...<br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._modulo%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">modulo</span></span><br/></a><a href="Filesystem.html#%28part._file-lib%29" class="indexlink" data-pltdoc="x">More File and Directory Utilities<br/></a><a href="More_Path_Utilities.html" class="indexlink" data-pltdoc="x">More Path Utilities<br/></a><a href="port-lib.html" class="indexlink" data-pltdoc="x">More Port Constructors, Procedures, and Events<br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._most-negative-fixnum%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">most-negative-fixnum</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._most-positive-fixnum%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">most-positive-fixnum</span></span><br/></a><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mpair~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">mpair?</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._multi-in%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">multi-in</span></span><br/></a><a href="eval-model.html#%28part._values-model%29" class="indexlink" data-pltdoc="x">Multiple Return Values<br/></a><a href="values.html" class="indexlink" data-pltdoc="x">Multiple Values<br/></a><a href="eval-model.html#%28tech._multiple._value%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">multiple values</span><br/></a><a href="file-ports.html#%28idx._%28gentag._256._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">must-truncate</span><br/></a><a href="mpairs.html#%28tech._mutable._list%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">mutable list</span><br/></a><a href="mpairs.html#%28tech._mutable._pair%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">mutable pair</span><br/></a><a href="mpairs.html#%28part._.Mutable_.Pair_.Constructors_and_.Selectors%29" class="indexlink" data-pltdoc="x">Mutable Pair Constructors and Selectors<br/></a><a href="mpairs.html" class="indexlink" data-pltdoc="x">Mutable Pairs and Lists<br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._mutable-set%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">mutable-set</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._mutable-setalw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">mutable-setalw</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._mutable-seteq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">mutable-seteq</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._mutable-seteqv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">mutable-seteqv</span></span><br/></a><a href="define-struct.html#%28tech._mutator%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">mutator</span><br/></a><a name="alpha:N"></a><span><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._nack-guard-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">nack-guard-evt</span></span><br/></a></span><a href="let.html#%28tech._named._let%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">named <span class="RktSym"><span class="RktStxLink">let</span></span></span><br/></a><a href="syntax-model.html#%28tech._namespace%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">namespace</span><br/></a><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._namespace-anchor-~3eempty-namespace%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-anchor-&gt;empty-namespace</span></span><br/></a><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._namespace-anchor-~3enamespace%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-anchor-&gt;namespace</span></span><br/></a><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._namespace-anchor~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-anchor?</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-attach-module%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-attach-module</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-attach-module-declaration%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-attach-module-declaration</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-base-phase%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-base-phase</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-call-with-registry-lock%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-call-with-registry-lock</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-mapped-symbols%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-mapped-symbols</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-module-identifier%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-module-identifier</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-module-registry%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-module-registry</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-require</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%2Fconstant%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-require/constant</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%2Fcopy%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-require/copy</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%2Fexpansion-time%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-require/expansion-time</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-set-variable-value%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-set-variable-value!</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-symbol-~3eidentifier%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-symbol-&gt;identifier</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-syntax-introduce%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-syntax-introduce</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-undefine-variable%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-undefine-variable!</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-unprotect-module%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-unprotect-module</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-variable-value%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace-variable-value</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">namespace?</span></span><br/></a><a href="Namespaces.html" class="indexlink" data-pltdoc="x">Namespaces<br/></a><a href="syntax-model.html#%28part._namespace-model%29" class="indexlink" data-pltdoc="x">Namespaces<br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._nan~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">nan?</span></span><br/></a><a href="booleans.html#%28form._%28%28lib._racket%2Fbool..rkt%29._nand%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">nand</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._natural-number%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">natural-number/c</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._natural~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">natural?</span></span><br/></a><a href="characters.html#%28idx._%28gentag._159._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">nd</span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._negate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">negate</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._negative-integer~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">negative-integer?</span></span><br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._negative~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">negative?</span></span><br/></a><a href="attaching-contracts-to-values.html#%28part._.Nested_.Contract_.Boundaries%29" class="indexlink" data-pltdoc="x">Nested Contract Boundaries<br/></a><a href="networking.html" class="indexlink" data-pltdoc="x">Networking<br/></a><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._never-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">never-evt</span></span><br/></a><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">new</span></span><br/></a><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._new-prompt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">new-prompt</span></span><br/></a><a href="parametric-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._new-~e2~88~80%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">new-&#8704;/c</span></span><br/></a><a href="parametric-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._new-~e2~88~83%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">new-&#8707;/c</span></span><br/></a><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._newline%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">newline</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._ninth%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">ninth</span></span><br/></a><a href="characters.html#%28idx._%28gentag._160._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">nl</span><br/></a><a href="characters.html#%28idx._%28gentag._161._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">no</span><br/></a><a href="stxtrans.html#%28idx._%28gentag._233._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">nominal-id</span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._non-empty-listof%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">non-empty-listof</span></span><br/></a><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">non-empty-string?</span></span><br/></a><a href="readtables.html#%28idx._%28gentag._270._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">non-terminating-macro</span><br/></a><a href="readtables.html#%28idx._%28gentag._272._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">non-terminating-macro</span><br/></a><a href="port-buffers.html#%28idx._%28gentag._245._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">none</span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._none%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">none/c</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._nonnegative-integer~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">nonnegative-integer?</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._nonpositive-integer~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">nonpositive-integer?</span></span><br/></a><a href="booleans.html#%28form._%28%28lib._racket%2Fbool..rkt%29._nor%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">nor</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._normal-case-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">normal-case-path</span></span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalize-arity%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">normalize-arity</span></span><br/></a><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._normalize-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">normalize-path</span></span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalized-arity~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">normalized-arity?</span></span><br/></a><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">not</span></span><br/></a><a href="match.html#%28idx._%28gentag._217._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">not<br/></a><a href="numbers.html#%28idx._%28gentag._117._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">not-a-number<br/></a><a href="stxtrans.html#%28idx._%28gentag._232._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">not-free-identifier=?</span><br/></a><a href="stxtrans.html#%28idx._%28gentag._234._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">not-provide-all-defined</span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">not/c</span></span><br/></a><a href="notation.html" class="indexlink" data-pltdoc="x">Notation for Documentation<br/></a><a href="notation.html#%28part._.Notation_for_.Function_.Documentation%29" class="indexlink" data-pltdoc="x">Notation for Function Documentation<br/></a><a href="notation.html#%28part._.Notation_for_.Module_.Documentation%29" class="indexlink" data-pltdoc="x">Notation for Module Documentation<br/></a><a href="notation.html#%28part._.Notation_for_.Other_.Documentation%29" class="indexlink" data-pltdoc="x">Notation for Other Documentation<br/></a><a href="notation.html#%28part._.Notation_for_.Parameter_.Documentation%29" class="indexlink" data-pltdoc="x">Notation for Parameter Documentation<br/></a><a href="notation.html#%28part._.Notation_for_.Structure_.Type_.Documentation%29" class="indexlink" data-pltdoc="x">Notation for Structure Type Documentation<br/></a><a href="notation.html#%28part._.Notation_for_.Syntactic_.Form_.Documentation%29" class="indexlink" data-pltdoc="x">Notation for Syntactic Form Documentation<br/></a><a href="windowspaths.html#%28idx._%28gentag._293._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"NUL"</span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">null</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">null?</span></span><br/></a><a href="generic-numbers.html#%28part._.Number_.Comparison%29" class="indexlink" data-pltdoc="x">Number Comparison<br/></a><a href="number-types.html" class="indexlink" data-pltdoc="x">Number Types<br/></a><a href="generic-numbers.html#%28part._.Number--.String_.Conversions%29" class="indexlink" data-pltdoc="x">Number&ndash;String Conversions<br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._number-~3estring%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">number-&gt;string</span></span><br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">number?</span></span><br/></a><a href="reader.html#%28idx._%28gentag._10._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">numbers, parsing<br/></a><a href="generic-numbers.html#%28idx._%28gentag._131._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">numbers, machine representations<br/></a><a href="generic-numbers.html#%28idx._%28gentag._128._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">numbers, little-endian<br/></a><a href="generic-numbers.html#%28idx._%28gentag._130._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">numbers, floating-point<br/></a><a href="generic-numbers.html#%28idx._%28gentag._127._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">numbers, converting<br/></a><a href="generic-numbers.html#%28idx._%28gentag._129._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">numbers, big-endian<br/></a><a href="numbers.html" class="indexlink" data-pltdoc="x">Numbers<br/></a><a href="numbers.html#%28tech._number%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">numbers</span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._numerator%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">numerator</span></span><br/></a><a name="alpha:O"></a><span><a href="Object_and_Class_Contracts.html" class="indexlink" data-pltdoc="x">Object and Class Contracts<br/></a></span><a href="objectequality.html" class="indexlink" data-pltdoc="x">Object Equality and Hashing<br/></a><a href="Equality.html#%28part._model-eq%29" class="indexlink" data-pltdoc="x">Object Identity and Comparisons<br/></a><a href="objectprinting.html" class="indexlink" data-pltdoc="x">Object Printing<br/></a><a href="objectserialize.html" class="indexlink" data-pltdoc="x">Object Serialization<br/></a><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">object%</span></span><br/></a><a href="objectutils.html" class="indexlink" data-pltdoc="x">Object, Class, and Interface Utilities<br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-~3evector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">object-&gt;vector</span></span><br/></a><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._object-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">object-contract</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-info%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">object-info</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-interface%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">object-interface</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-method-arity-includes~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">object-method-arity-includes?</span></span><br/></a><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">object-name</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-or-false~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">object-or-false=?</span></span><br/></a><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._object%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">object/c</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3d-hash-code%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">object=-hash-code</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">object=?</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">object?</span></span><br/></a><a href="eval-model.html#%28tech._object%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">objects</span><br/></a><a href="eval-model.html#%28part._.Objects_and_.Imperative_.Update%29" class="indexlink" data-pltdoc="x">Objects and Imperative Update<br/></a><a href="Building_New_Contract_Combinators.html#%28part._.Obligation_.Information_in_.Check_.Syntax%29" class="indexlink" data-pltdoc="x">Obligation Information in Check Syntax<br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._odd~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">odd?</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._one-of%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">one-of/c</span></span><br/></a><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._only%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">only</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-in%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">only-in</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-meta-in%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">only-meta-in</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-space-in%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">only-space-in</span></span><br/></a><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._open%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">open</span></span><br/></a><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">open-input-bytes</span></span><br/></a><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-input-file%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">open-input-file</span></span><br/></a><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-input-output-file%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">open-input-output-file</span></span><br/></a><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">open-input-string</span></span><br/></a><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">open-output-bytes</span></span><br/></a><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-output-file%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">open-output-file</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._open-output-nowhere%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">open-output-nowhere</span></span><br/></a><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">open-output-string</span></span><br/></a><a href="os.html" class="indexlink" data-pltdoc="x">Operating System<br/></a><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fopt..rkt%29._opt%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">opt/c</span></span><br/></a><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">or</span></span><br/></a><a href="match.html#%28idx._%28gentag._216._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">or<br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">or/c</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._order-of-magnitude%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">order-of-magnitude</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._352._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">orig-dir</span><br/></a><a href="stxprops.html#%28idx._%28gentag._235._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">origin</span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._ormap%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">ormap</span></span><br/></a><a href="runtime.html#%28idx._%28gentag._414._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">os</span><br/></a><a href="runtime.html#%28idx._%28gentag._418._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">os*</span><br/></a><a href="generic-numbers.html#%28part._.Other_.Randomness_.Utilities%29" class="indexlink" data-pltdoc="x">Other Randomness Utilities<br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._other-execute-bit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">other-execute-bit</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._other-permission-bits%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">other-permission-bits</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._other-read-bit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">other-read-bit</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._other-write-bit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">other-write-bit</span></span><br/></a><a href="ports.html#%28tech._output._port%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">output port</span><br/></a><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">output-port?</span></span><br/></a><a href="syntax-model.html#%28tech._outside._edge._scope%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">outside-edge
+scope</span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">overment</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">overment*</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">override</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">override*</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">override-final</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">override-final*</span></span><br/></a><a href="mzlib_class.html#%28tech._overriding%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">overriding</span><br/></a><a name="alpha:P"></a><span><a href="collects.html#%28tech._package%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">packages</span><br/></a></span><a href="pairs.html#%28tech._pair%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">pair</span><br/></a><a href="pairs.html#%28part._.Pair_.Accessor_.Shorthands%29" class="indexlink" data-pltdoc="x">Pair Accessor Shorthands<br/></a><a href="pairs.html#%28part._.Pair_.Constructors_and_.Selectors%29" class="indexlink" data-pltdoc="x">Pair Constructors and Selectors<br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pair?</span></span><br/></a><a href="pairs.html" class="indexlink" data-pltdoc="x">Pairs and Lists<br/></a><a href="eval-model.html#%28tech._parameter._procedure%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">parameter procedure</span><br/></a><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._parameter-procedure~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">parameter-procedure=?</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._parameter%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">parameter/c</span></span><br/></a><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._parameter~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">parameter?</span></span><br/></a><a href="eval-model.html#%28tech._parameterization%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">parameterization</span><br/></a><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._parameterization~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">parameterization?</span></span><br/></a><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">parameterize</span></span><br/></a><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">parameterize*</span></span><br/></a><a href="breakhandler.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize-break%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">parameterize-break</span></span><br/></a><a href="eval-model.html#%28part._parameter-model%29" class="indexlink" data-pltdoc="x">Parameters<br/></a><a href="parameters.html" class="indexlink" data-pltdoc="x">Parameters<br/></a><a href="eval-model.html#%28tech._parameter%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">Parameters</span><br/></a><a href="parametric-contracts.html" class="indexlink" data-pltdoc="x">Parametric Contracts<br/></a><a href="parametric-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._parametric-~3e%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">parametric-&gt;/c</span></span><br/></a><a href="reader.html#%28idx._%28gentag._31._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">paren-shape</span><br/></a><a href="stxtrans.html#%28tech._parent._internal._definition._context%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">parent
+internal-definition context</span><br/></a><a href="syntax-model.html#%28tech._parse%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">parse</span><br/></a><a href="Command-Line_Parsing.html#%28def._%28%28lib._racket%2Fcmdline..rkt%29._parse-command-line%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">parse-command-line</span></span><br/></a><a href="syntax-model.html#%28tech._parsed%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">parsed</span><br/></a><a href="syntax-model.html#%28part._partial-expansion%29" class="indexlink" data-pltdoc="x">Partial Expansion<br/></a><a href="syntax-model.html#%28tech._partial._expansion%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">partial expansion</span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._partition%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">partition</span></span><br/></a><a href="dicts.html#%28part._.Passing_keyword_arguments_in_dictionaries%29" class="indexlink" data-pltdoc="x">Passing keyword arguments in dictionaries<br/></a><a href="shared.html#%28tech._patched%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">patched</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._353._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PATH</span><br/></a><a href="pathutils.html#%28tech._path%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">path</span><br/></a><a href="More_Path_Utilities.html#%28tech._path._element%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">path element</span><br/></a><a href="Manipulating_Paths.html#%28tech._path._or._string%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">path
+or string</span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3ebytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-&gt;bytes</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3ecomplete-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-&gt;complete-path</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3edirectory-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-&gt;directory-path</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3estring%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-&gt;string</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-add-extension%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-add-extension</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-add-suffix%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-add-suffix</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-convention-type%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-convention-type</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-element-~3ebytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-element-&gt;bytes</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-element-~3estring%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-element-&gt;string</span></span><br/></a><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-element~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-element?</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-for-some-system~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-for-some-system?</span></span><br/></a><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-get-extension%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-get-extension</span></span><br/></a><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-has-extension~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-has-extension?</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-list-string-~3epath-list%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-list-string-&gt;path-list</span></span><br/></a><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._path-only%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-only</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-replace-extension%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-replace-extension</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-replace-suffix%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-replace-suffix</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path-string?</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._path-up%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">path-up</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3c~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path&lt;?</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">path?</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._pathlist-closure%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pathlist-closure</span></span><br/></a><a href="pathutils.html" class="indexlink" data-pltdoc="x">Paths<br/></a><a href="match.html" class="indexlink" data-pltdoc="x">Pattern Matching<br/></a><a href="regexp.html" class="indexlink" data-pltdoc="x">pattern matching<br/></a><a href="stx-patterns.html#%28tech._pattern._variable%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">pattern variable</span><br/></a><a href="syntax-util.html#%28part._.Pattern_variables%29" class="indexlink" data-pltdoc="x">Pattern variables<br/></a><a href="stx-patterns.html" class="indexlink" data-pltdoc="x">Pattern-Based Syntax Matching<br/></a><a href="characters.html#%28idx._%28gentag._167._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">pc</span><br/></a><a href="characters.html#%28idx._%28gentag._166._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">pd</span><br/></a><a href="characters.html#%28idx._%28gentag._163._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">pe</span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-byte%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-byte</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-byte-or-special%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-byte-or-special</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-bytes</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-bytes!</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._peek-bytes%21-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-bytes!-evt</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes-avail%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-bytes-avail!</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes-avail%21%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-bytes-avail!*</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._peek-bytes-avail%21-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-bytes-avail!-evt</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes-avail%21%2Fenable-break%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-bytes-avail!/enable-break</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._peek-bytes-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-bytes-evt</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-char%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-char</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-char-or-special%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-char-or-special</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-string</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-string%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-string!</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._peek-string%21-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-string!-evt</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._peek-string-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-string-evt</span></span><br/></a><a href="ports.html#%28tech._peek%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">peeked</span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._peeking-input-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peeking-input-port</span></span><br/></a><a href="pretty-print.html#%28part._.Per-.Symbol_.Special_.Printing%29" class="indexlink" data-pltdoc="x">Per-Symbol Special Printing<br/></a><a href="performance-hint.html" class="indexlink" data-pltdoc="x">Performance Hints: <span class="RktSym"><span class="RktStxLink">begin-encourage-inline</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._permutations%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">permutations</span></span><br/></a><a href="characters.html#%28idx._%28gentag._165._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">pf</span><br/></a><a href="phantom-bytes.html#%28tech._phantom._byte._string%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">phantom byte string</span><br/></a><a href="phantom-bytes.html" class="indexlink" data-pltdoc="x">Phantom Byte Strings<br/></a><a href="phantom-bytes.html#%28def._%28%28quote._~23~25kernel%29._phantom-bytes~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">phantom-bytes?</span></span><br/></a><a href="phase_space.html" class="indexlink" data-pltdoc="x">Phase and Space Utilities<br/></a><a href="syntax-model.html#%28tech._phase._level%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">phase level</span><br/></a><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">phase+space</span></span><br/></a><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace%2B%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">phase+space+</span></span><br/></a><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-phase%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">phase+space-phase</span></span><br/></a><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-shift%2B%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">phase+space-shift+</span></span><br/></a><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-shift~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">phase+space-shift?</span></span><br/></a><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-space%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">phase+space-space</span></span><br/></a><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">phase+space?</span></span><br/></a><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">phase?</span></span><br/></a><a href="eval-model.html#%28part._module-phase%29" class="indexlink" data-pltdoc="x">Phases<br/></a><a href="eval-model.html#%28tech._phase%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">phases</span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pi</span></span><br/></a><a href="characters.html#%28idx._%28gentag._164._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">pi</span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi..f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pi.f</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._pi..t%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pi.t</span></span><br/></a><a href="pipeports.html#%28tech._pipe%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">pipe</span><br/></a><a href="pipeports.html#%28def._%28%28quote._~23~25kernel%29._pipe-content-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pipe-content-length</span></span><br/></a><a href="pipeports.html" class="indexlink" data-pltdoc="x">Pipes<br/></a><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">place</span></span><br/></a><a href="places.html#%28tech._place%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">place</span><br/></a><a href="places.html#%28tech._place._channel%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">place channels</span><br/></a><a href="places.html#%28tech._place._descriptor%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">place descriptor</span><br/></a><a href="places.html#%28tech._place._location%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">place locations</span><br/></a><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">place*</span></span><br/></a><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-break%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-break</span></span><br/></a><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-channel</span></span><br/></a><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel-get%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-channel-get</span></span><br/></a><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel-put%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-channel-put</span></span><br/></a><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel-put%2Fget%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-channel-put/get</span></span><br/></a><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-channel?</span></span><br/></a><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-dead-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-dead-evt</span></span><br/></a><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-enabled~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-enabled?</span></span><br/></a><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-kill%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-kill</span></span><br/></a><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-location~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-location?</span></span><br/></a><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-message-allowed~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-message-allowed?</span></span><br/></a><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-wait%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-wait</span></span><br/></a><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%2Fcontext%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">place/context</span></span><br/></a><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place?</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._placeholder-get%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">placeholder-get</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._placeholder-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">placeholder-set!</span></span><br/></a><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._placeholder~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">placeholder?</span></span><br/></a><a href="pairs.html#%28tech._placeholder%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">placeholders</span><br/></a><a href="places.html" class="indexlink" data-pltdoc="x">Places<br/></a><a href="places.html#%28part._place-logging%29" class="indexlink" data-pltdoc="x">Places Logging<br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._planet%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">planet</span></span><br/></a><a href="eval.html#%28idx._%28gentag._277._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_COMPILE_ANY</span><br/></a><a href="eval.html#%28idx._%28gentag._275._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_COMPILED_FILE_CHECK</span><br/></a><a href="compiler.html#%28idx._%28gentag._564._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_CS_COMPILE_LIMIT</span><br/></a><a href="debugging.html#%28idx._%28gentag._563._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_CS_DEBUG</span><br/></a><a href="compiler.html#%28idx._%28gentag._566._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_CS_INTERP</span><br/></a><a href="compiler.html#%28idx._%28gentag._565._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_CS_JIT</span><br/></a><a href="compiler.html#%28idx._%28gentag._567._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_CS_MACH</span><br/></a><a href="Reading.html#%28idx._%28gentag._268._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_DELAY_FROM_ZO</span><br/></a><a href="compiler.html#%28idx._%28gentag._581._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_EXPANDER_TIMES</span><br/></a><a href="garbagecollection.html#%28idx._%28gentag._449._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_INCREMENTAL_GC</span><br/></a><a href="garbagecollection.html#%28idx._%28gentag._450._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_INCREMENTAL_GC</span><br/></a><a href="compiler.html#%28idx._%28gentag._568._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_LINKLET_SHOW</span><br/></a><a href="compiler.html#%28idx._%28gentag._579._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_LINKLET_SHOW_ASSEMBLY</span><br/></a><a href="compiler.html#%28idx._%28gentag._577._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_LINKLET_SHOW_CP0</span><br/></a><a href="compiler.html#%28idx._%28gentag._569._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_LINKLET_SHOW_GENSYM</span><br/></a><a href="compiler.html#%28idx._%28gentag._574._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_LINKLET_SHOW_JIT_DEMAND</span><br/></a><a href="compiler.html#%28idx._%28gentag._576._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_LINKLET_SHOW_KNOWN</span><br/></a><a href="compiler.html#%28idx._%28gentag._571._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_LINKLET_SHOW_LAMBDA</span><br/></a><a href="compiler.html#%28idx._%28gentag._578._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_LINKLET_SHOW_PASSES</span><br/></a><a href="compiler.html#%28idx._%28gentag._575._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_LINKLET_SHOW_PATHS</span><br/></a><a href="compiler.html#%28idx._%28gentag._573._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_LINKLET_SHOW_POST_INTERP</span><br/></a><a href="compiler.html#%28idx._%28gentag._572._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_LINKLET_SHOW_POST_LAMBDA</span><br/></a><a href="compiler.html#%28idx._%28gentag._570._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_LINKLET_SHOW_PRE_JIT</span><br/></a><a href="compiler.html#%28idx._%28gentag._580._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_LINKLET_TIMES</span><br/></a><a href="eval.html#%28idx._%28gentag._276._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_VALIDATE_COMPILE</span><br/></a><a href="printing.html#%28idx._%28gentag._97._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_VALIDATE_LOAD</span><br/></a><a href="eval.html#%28idx._%28gentag._273._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLT_ZO_PATH</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._341._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLTADDONDIR</span><br/></a><a href="collects.html#%28idx._%28gentag._562._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLTCOLLECTS</span><br/></a><a href="eval.html#%28idx._%28gentag._274._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLTCOMPILEDROOTS</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._338._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLTCONFIGDIR</span><br/></a><a href="garbagecollection.html#%28idx._%28gentag._448._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLTDISABLEGC</span><br/></a><a href="eval.html#%28idx._%28gentag._278._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLTNOMZJIT</span><br/></a><a href="logging.html#%28idx._%28gentag._411._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLTSTDERR</span><br/></a><a href="logging.html#%28idx._%28gentag._412._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLTSTDOUT</span><br/></a><a href="logging.html#%28idx._%28gentag._413._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLTSYSLOG</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._318._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PLTUSERHOME</span><br/></a><a href="plumbers.html#%28tech._plumber%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">plumber</span><br/></a><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-add-flush%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">plumber-add-flush!</span></span><br/></a><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-flush-all%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">plumber-flush-all</span></span><br/></a><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-flush-handle-remove%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">plumber-flush-handle-remove!</span></span><br/></a><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-flush-handle~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">plumber-flush-handle?</span></span><br/></a><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">plumber?</span></span><br/></a><a href="plumbers.html" class="indexlink" data-pltdoc="x">Plumbers<br/></a><a href="characters.html#%28idx._%28gentag._168._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">po</span><br/></a><a href="sync.html" class="indexlink" data-pltdoc="x">poll<br/></a><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._poll-guard-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">poll-guard-evt</span></span><br/></a><a href="port-buffers.html" class="indexlink" data-pltdoc="x">Port Buffers and Positions<br/></a><a href="Writing.html#%28tech._port._display._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">port display
+handler</span><br/></a><a href="port-lib.html#%28part._.Port_.Events%29" class="indexlink" data-pltdoc="x">Port Events<br/></a><a href="linecol.html" class="indexlink" data-pltdoc="x">port positions<br/></a><a href="Writing.html#%28tech._port._print._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">port print handler</span><br/></a><a href="Reading.html#%28tech._port._read._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">port read handler</span><br/></a><a href="port-lib.html#%28part._.Port_.String_and_.List_.Conversions%29" class="indexlink" data-pltdoc="x">Port String and List Conversions<br/></a><a href="Writing.html#%28tech._port._write._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">port write handler</span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3ebytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-&gt;bytes</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3ebytes-lines%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-&gt;bytes-lines</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3elines%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-&gt;lines</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3elist%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-&gt;list</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3estring%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-&gt;string</span></span><br/></a><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._port-closed-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-closed-evt</span></span><br/></a><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._port-closed~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-closed?</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-commit-peeked%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-commit-peeked</span></span><br/></a><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-count-lines%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-count-lines!</span></span><br/></a><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-count-lines-enabled%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-count-lines-enabled</span></span><br/></a><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-counts-lines~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-counts-lines?</span></span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._port-display-handler%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-display-handler</span></span><br/></a><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-file-identity%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-file-identity</span></span><br/></a><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-file-unlock%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-file-unlock</span></span><br/></a><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-next-location%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-next-location</span></span><br/></a><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._port-number~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-number?</span></span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._port-print-handler%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-print-handler</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-progress-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-progress-evt</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-provides-progress-evts~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-provides-progress-evts?</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._port-read-handler%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-read-handler</span></span><br/></a><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-try-file-lock~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-try-file-lock?</span></span><br/></a><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._port-waiting-peer~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-waiting-peer?</span></span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._port-write-handler%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-write-handler</span></span><br/></a><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._port-writes-atomic~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-writes-atomic?</span></span><br/></a><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._port-writes-special~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-writes-special?</span></span><br/></a><a href="port-ops.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._port~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port?</span></span><br/></a><a href="stxtrans.html#%28tech._portal._syntax%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">portal syntax</span><br/></a><a href="stxtrans.html#%28part._portal-syntax%29" class="indexlink" data-pltdoc="x">Portal Syntax Bindings<br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._portal-syntax-content%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">portal-syntax-content</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._portal-syntax~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">portal-syntax?</span></span><br/></a><a href="port-buffers.html#%28idx._%28gentag._244._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">ports, flushing<br/></a><a href="ports.html" class="indexlink" data-pltdoc="x">Ports<br/></a><a href="ports.html#%28tech._port%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">Ports</span><br/></a><a href="linecol.html#%28tech._position%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">position</span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._positive-integer~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">positive-integer?</span></span><br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">positive?</span></span><br/></a><a href="generic-numbers.html#%28part._.Powers_and_.Roots%29" class="indexlink" data-pltdoc="x">Powers and Roots<br/></a><a href="pairs.html#%28idx._%28gentag._187._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">powerset<br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._pre-expand-export%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pre-expand-export</span></span><br/></a><a href="define-struct.html#%28tech._predicate%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">predicate</span><br/></a><a href="function-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._predicate%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">predicate/c</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._325._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">pref-dir</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._327._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">pref-file</span><br/></a><a href="structures.html#%28tech._prefab%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">prefab</span><br/></a><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._prefab-key-~3estruct-type%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prefab-key-&gt;struct-type</span></span><br/></a><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._prefab-key~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prefab-key?</span></span><br/></a><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._prefab-struct-key%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prefab-struct-key</span></span><br/></a><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._prefab-struct-type-key%2Bfield-count%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prefab-struct-type-key+field-count</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._preferences-lock-file-mode%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">preferences-lock-file-mode</span></span><br/></a><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._prefix%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">prefix</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prefix-in%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">prefix-in</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prefix-out%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">prefix-out</span></span><br/></a><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._pregexp%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pregexp</span></span><br/></a><a href="match.html#%28idx._%28gentag._214._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">pregexp<br/></a><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._pregexp~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pregexp?</span></span><br/></a><a href="eval-model.html#%28tech._preserved%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">preserved</span><br/></a><a href="stxprops.html#%28tech._stx._prop._preserved%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">preserved</span><br/></a><a href="pretty-print.html" class="indexlink" data-pltdoc="x">Pretty Printing<br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-display%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-display</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-format%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-format</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-print</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-..-symbol-without-bars%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-print-.-symbol-without-bars</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-abbreviate-read-macros%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-print-abbreviate-read-macros</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-columns%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-print-columns</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-current-style-table%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-print-current-style-table</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-depth%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-print-depth</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-exact-as-decimal%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-print-exact-as-decimal</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-extend-style-table%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-print-extend-style-table</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-handler%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-print-handler</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-newline%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-print-newline</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-post-print-hook%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-print-post-print-hook</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-pre-print-hook%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-print-pre-print-hook</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-print-hook%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-print-print-hook</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-print-line%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-print-print-line</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-remap-stylable%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-print-remap-stylable</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-show-inexactness%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-print-show-inexactness</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-size-hook%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-print-size-hook</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-style-table~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-print-style-table?</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-printing%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-printing</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-write%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-write</span></span><br/></a><a href="dicts.html#%28part._primitive-dict-methods%29" class="indexlink" data-pltdoc="x">Primitive Dictionary Methods<br/></a><a href="procedures.html#%28tech._primitive._procedure%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">primitive procedure</span><br/></a><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._primitive-closure~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">primitive-closure?</span></span><br/></a><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._primitive-result-arity%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">primitive-result-arity</span></span><br/></a><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._primitive~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">primitive?</span></span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print</span></span><br/></a><a href="eval.html#%28tech._print._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">print handler</span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-as-expression</span></span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-boolean-long-form%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-boolean-long-form</span></span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-box%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-box</span></span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-graph%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-graph</span></span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-hash-table%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-hash-table</span></span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-mpair-curly-braces%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-mpair-curly-braces</span></span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-pair-curly-braces%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-pair-curly-braces</span></span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-reader-abbreviations%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-reader-abbreviations</span></span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-struct%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-struct</span></span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-syntax-width%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-syntax-width</span></span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-unreadable%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-unreadable</span></span><br/></a><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._print-value-columns%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-value-columns</span></span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-vector-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">print-vector-length</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._printable%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">printable/c</span></span><br/></a><a href="objectprinting.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._printable~3c~25~3e%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">printable&lt;%&gt;</span></span><br/></a><a href="Printer_Extension.html" class="indexlink" data-pltdoc="x">Printer Extension<br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">printf</span></span><br/></a><a href="printing.html#%28part._print-booleans%29" class="indexlink" data-pltdoc="x">Printing Booleans<br/></a><a href="printing.html#%28part._print-box%29" class="indexlink" data-pltdoc="x">Printing Boxes<br/></a><a href="printing.html#%28part._print-character%29" class="indexlink" data-pltdoc="x">Printing Characters<br/></a><a href="printing.html#%28part._print-compiled%29" class="indexlink" data-pltdoc="x">Printing Compiled Code<br/></a><a href="printing.html#%28part._print-extflonum%29" class="indexlink" data-pltdoc="x">Printing Extflonums<br/></a><a href="printing.html#%28part._print-hashtable%29" class="indexlink" data-pltdoc="x">Printing Hash Tables<br/></a><a href="printing.html#%28part._print-keyword%29" class="indexlink" data-pltdoc="x">Printing Keywords<br/></a><a href="printing.html#%28part._print-number%29" class="indexlink" data-pltdoc="x">Printing Numbers<br/></a><a href="printing.html#%28part._print-pairs%29" class="indexlink" data-pltdoc="x">Printing Pairs and Lists<br/></a><a href="printing.html#%28part._print-path%29" class="indexlink" data-pltdoc="x">Printing Paths<br/></a><a href="printing.html#%28part._print-regexp%29" class="indexlink" data-pltdoc="x">Printing Regular Expressions<br/></a><a href="printing.html#%28part._print-string%29" class="indexlink" data-pltdoc="x">Printing Strings<br/></a><a href="printing.html#%28part._print-structure%29" class="indexlink" data-pltdoc="x">Printing Structures<br/></a><a href="printing.html#%28part._print-symbol%29" class="indexlink" data-pltdoc="x">Printing Symbols<br/></a><a href="printing.html#%28part._print-unreadable%29" class="indexlink" data-pltdoc="x">Printing Unreadable Values<br/></a><a href="printing.html#%28part._print-vectors%29" class="indexlink" data-pltdoc="x">Printing Vectors<br/></a><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._println%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">println</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._private%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">private</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._private%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">private*</span></span><br/></a><a href="windowspaths.html#%28idx._%28gentag._295._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"PRN"</span><br/></a><a href="application.html" class="indexlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span><br/></a><a href="eval-model.html#%28part._.Procedure_.Applications_and_.Local_.Variables%29" class="indexlink" data-pltdoc="x">Procedure Applications and Local Variables<br/></a><a href="lambda.html" class="indexlink" data-pltdoc="x">Procedure Expressions: <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-lambda</span></span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-~3emethod%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-&gt;method</span></span><br/></a><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-arity</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._procedure-arity-includes%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-arity-includes/c</span></span><br/></a><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity-includes~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-arity-includes?</span></span><br/></a><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity-mask%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-arity-mask</span></span><br/></a><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-arity?</span></span><br/></a><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-closure-contents-eq~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-closure-contents-eq?</span></span><br/></a><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-extract-target%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-extract-target</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._procedure-impersonator%2A~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-impersonator*?</span></span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-keywords%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-keywords</span></span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-realm%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-realm</span></span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-reduce-arity%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-reduce-arity</span></span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-reduce-arity-mask%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-reduce-arity-mask</span></span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-reduce-keyword-arity%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-reduce-keyword-arity</span></span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-reduce-keyword-arity-mask%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-reduce-keyword-arity-mask</span></span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-rename%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-rename</span></span><br/></a><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-result-arity%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-result-arity</span></span><br/></a><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-specialize%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-specialize</span></span><br/></a><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-struct-type~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-struct-type?</span></span><br/></a><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure?</span></span><br/></a><a href="procedures.html" class="indexlink" data-pltdoc="x">Procedures<br/></a><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">process</span></span><br/></a><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">process*</span></span><br/></a><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%2A%2Fports%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">process*/ports</span></span><br/></a><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%2Fports%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">process/ports</span></span><br/></a><a href="subprocess.html" class="indexlink" data-pltdoc="x">Processes<br/></a><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._processor-count%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">processor-count</span></span><br/></a><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._processor-count%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">processor-count</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._progress-evt~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">progress-evt?</span></span><br/></a><a href="Delayed_Evaluation.html#%28tech._promise%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">promise</span><br/></a><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._promise-forced~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">promise-forced?</span></span><br/></a><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._promise-running~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">promise-running?</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._promise%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">promise/c</span></span><br/></a><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._promise%2Fname~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">promise/name?</span></span><br/></a><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._promise~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">promise?</span></span><br/></a><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">prompt</span></span><br/></a><a href="eval-model.html#%28tech._prompt%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">prompt</span><br/></a><a href="eval.html#%28tech._prompt._read._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">prompt read handler</span><br/></a><a href="eval-model.html#%28tech._prompt._tag%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">prompt tag</span><br/></a><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt-at%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">prompt-at</span></span><br/></a><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._prompt-tag%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">prompt-tag/c</span></span><br/></a><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt0%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">prompt0</span></span><br/></a><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._prompt0-at%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">prompt0-at</span></span><br/></a><a href="eval-model.html#%28part._prompt-model%29" class="indexlink" data-pltdoc="x">Prompts, Delimited Continuations, and Barriers<br/></a><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._prop~3aarity-string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:arity-string</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._prop~3aauthentic%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:authentic</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._prop~3ablame%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:blame</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3achaperone-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:chaperone-contract</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._prop~3achaperone-unsafe-undefined%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:chaperone-unsafe-undefined</span></span><br/></a><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._prop~3achecked-procedure%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:checked-procedure</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._prop~3acollapsible-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:collapsible-contract</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3acontract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:contract</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._prop~3acontracted%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:contracted</span></span><br/></a><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-print-quotable%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:custom-print-quotable</span></span><br/></a><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-write%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:custom-write</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._prop~3adict%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:dict</span></span><br/></a><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._prop~3adict%2Fcontract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:dict/contract</span></span><br/></a><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._prop~3aequal%2Bhash%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:equal+hash</span></span><br/></a><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._prop~3aevt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:evt</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._prop~3aexn~3amissing-module%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:exn:missing-module</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._prop~3aexn~3asrclocs%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:exn:srclocs</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aexpansion-contexts%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:expansion-contexts</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fprop..rkt%29._prop~3aflat-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:flat-contract</span></span><br/></a><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._prop~3aimpersonator-of%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:impersonator-of</span></span><br/></a><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3ainput-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:input-port</span></span><br/></a><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._prop~3alegacy-match-expander%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:legacy-match-expander</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aliberal-define-context%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:liberal-define-context</span></span><br/></a><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._prop~3amatch-expander%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:match-expander</span></span><br/></a><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._prop~3aobject-name%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:object-name</span></span><br/></a><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3aoutput-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:output-port</span></span><br/></a><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._prop~3aplace-location%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:place-location</span></span><br/></a><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:procedure</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._prop~3aprovide-pre-transformer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:provide-pre-transformer</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._prop~3aprovide-transformer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:provide-transformer</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3arename-transformer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:rename-transformer</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._prop~3arequire-transformer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:require-transformer</span></span><br/></a><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3asealed%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:sealed</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3asequence%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:sequence</span></span><br/></a><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._prop~3aserializable%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:serializable</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aset%21-transformer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:set!-transformer</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._prop~3astream%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:stream</span></span><br/></a><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._prop~3astruct-auto-info%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:struct-auto-info</span></span><br/></a><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._prop~3astruct-field-info%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:struct-field-info</span></span><br/></a><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._prop~3astruct-info%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:struct-info</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._proper-subset~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">proper-subset?</span></span><br/></a><a href="structprops.html#%28tech._property._accessor%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">property accessor</span><br/></a><a href="structprops.html#%28tech._property._predicate%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">property predicate</span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._property%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">property/c</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._protect-out%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">protect-out</span></span><br/></a><a href="stxprops.html#%28idx._%28gentag._238._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">protected</span><br/></a><a href="modprotect.html#%28tech._protected%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">protected</span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">provide</span></span><br/></a><a href="define.html#%28part._provide-syntax%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">provide</span></span> Macros<br/></a><a href="stxtrans.html#%28tech._provide._pre._transformer%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">provide
+pre-transformer</span><br/></a><a href="stxtrans.html#%28tech._provide._transformer%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">provide transformer</span><br/></a><a href="stxtrans.html#%28part._provide-trans%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">provide</span></span> Transformers<br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._provide-pre-transformer~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">provide-pre-transformer?</span></span><br/></a><a href="Unit_Utilities.html#%28form._%28%28lib._racket%2Funit..rkt%29._provide-signature-elements%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">provide-signature-elements</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._provide-transformer~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">provide-transformer?</span></span><br/></a><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fprovide..rkt%29._provide%2Fcontract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">provide/contract</span></span><br/></a><a href="attaching-contracts-to-values.html#%28idx._%28gentag._196._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">provide/contract-original-contract</span><br/></a><a href="Surrogates.html#%28tech._proxy._design._pattern%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">proxy design pattern</span><br/></a><a href="characters.html#%28idx._%28gentag._162._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">ps</span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator-~3evector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pseudo-random-generator-&gt;vector</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator-vector~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pseudo-random-generator-vector?</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pseudo-random-generator?</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">public</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">public*</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public-final%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">public-final</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public-final%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">public-final*</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._pubment%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">pubment</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._pubment%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">pubment*</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._put-input%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">put-input</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._put-preferences%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">put-preferences</span></span><br/></a><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._putenv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">putenv</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._380._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">PWD</span><br/></a><a name="alpha:Q"></a><span><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">quasiquote</span></span><br/></a></span><a href="match.html#%28idx._%28gentag._220._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">quasiquote<br/></a><a href="quasiquote.html" class="indexlink" data-pltdoc="x">Quasiquoting: <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-splicing</span></span><br/></a><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._quasisyntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">quasisyntax</span></span><br/></a><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._quasisyntax%2Floc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">quasisyntax/loc</span></span><br/></a><a href="printing.html#%28tech._quotable%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">quotable</span><br/></a><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">quote</span></span><br/></a><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">quote-syntax</span></span><br/></a><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._quote-syntax%2Fprune%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">quote-syntax/prune</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._quotient%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">quotient</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._quotient%2Fremainder%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">quotient/remainder</span></span><br/></a><a href="printing.html#%28tech._quoting._depth%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">quoting
+depth</span><br/></a><a name="alpha:R"></a><span><a href="index.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket</span></span><br/></a></span><a href="runtime.html#%28idx._%28gentag._422._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">racket</span><br/></a><a href="running-sa.html#%28idx._%28gentag._452._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">racket</span><br/></a><a href="running-sa.html#%28idx._%28gentag._453._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">Racket.exe</span><br/></a><a href="async-channel.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/async-channel</span></span><br/></a><a href="index.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/base</span></span><br/></a><a href="block.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/block</span></span><br/></a><a href="booleans.html#%28mod-path._racket%2Fbool%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/bool</span></span><br/></a><a href="bytestrings.html#%28mod-path._racket%2Fbytes%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/bytes</span></span><br/></a><a href="mzlib_class.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/class</span></span><br/></a><a href="Command-Line_Parsing.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/cmdline</span></span><br/></a><a href="contracts.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/contract</span></span><br/></a><a href="racket_contract_base.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/contract/base</span></span><br/></a><a href="racket_contract_base.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/contract/base</span></span><br/></a><a href="collapsible.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/contract/collapsible</span></span><br/></a><a href="Building_New_Contract_Combinators.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/contract/combinator</span></span><br/></a><a href="parametric-contracts.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/contract/parametric</span></span><br/></a><a href="attaching-contracts-to-values.html#%28mod-path._racket%2Fcontract%2Fregion%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/contract/region</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28idx._%28gentag._197._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">racket/contract:contract<br/></a><a href="Building_New_Contract_Combinators.html#%28idx._%28gentag._200._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">racket/contract:contract-on-boundary<br/></a><a href="Building_New_Contract_Combinators.html#%28idx._%28gentag._201._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">racket/contract:internal-contract<br/></a><a href="Building_New_Contract_Combinators.html#%28idx._%28gentag._198._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">racket/contract:negative-position<br/></a><a href="Building_New_Contract_Combinators.html#%28idx._%28gentag._199._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">racket/contract:positive-position<br/></a><a href="cont.html#%28mod-path._racket%2Fcontrol%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/control</span></span><br/></a><a href="time.html#%28mod-path._racket%2Fdate%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/date</span></span><br/></a><a href="dicts.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/dict</span></span><br/></a><a href="engine.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/engine</span></span><br/></a><a href="interactive.html#%28mod-path._racket%2Fenter%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/enter</span></span><br/></a><a href="exns.html#%28mod-path._racket%2Fexn%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/exn</span></span><br/></a><a href="extflonums.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/extflonum</span></span><br/></a><a href="fasl.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/fasl</span></span><br/></a><a href="Filesystem.html#%28mod-path._racket%2Ffile%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/file</span></span><br/></a><a href="fixnums.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/fixnum</span></span><br/></a><a href="flonums.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/flonum</span></span><br/></a><a href="strings.html#%28mod-path._racket%2Fformat%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/format</span></span><br/></a><a href="procedures.html#%28mod-path._racket%2Ffunction%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/function</span></span><br/></a><a href="futures.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/future</span></span><br/></a><a href="Generators.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/generator</span></span><br/></a><a href="struct-generics.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/generic</span></span><br/></a><a href="hashtables.html#%28mod-path._racket%2Fhash%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/hash</span></span><br/></a><a href="Interactive_Help.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/help</span></span><br/></a><a href="include.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/include</span></span><br/></a><a href="running-sa.html#%28mod-path._racket%2Finit%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/init</span></span><br/></a><a href="interaction-info.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/interaction-info</span></span><br/></a><a href="running-sa.html#%28mod-path._racket%2Finteractive%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/interactive</span></span><br/></a><a href="Kernel_Forms_and_Functions.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/kernel</span></span><br/></a><a href="Kernel_Forms_and_Functions.html#%28mod-path._racket%2Fkernel%2Finit%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/kernel/init</span></span><br/></a><a href="keywords.html#%28mod-path._racket%2Fkeyword%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/keyword</span></span><br/></a><a href="stxtrans.html#%28mod-path._racket%2Fkeyword-transform%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/keyword-transform</span></span><br/></a><a href="running-sa.html#%28mod-path._racket%2Flanguage-info%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/language-info</span></span><br/></a><a href="lazy-require.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/lazy-require</span></span><br/></a><a href="linklets.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/linklet</span></span><br/></a><a href="pairs.html#%28mod-path._racket%2Flist%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/list</span></span><br/></a><a href="load-lang.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/load</span></span><br/></a><a href="local.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/local</span></span><br/></a><a href="logging.html#%28mod-path._racket%2Flogging%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/logging</span></span><br/></a><a href="match.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/match</span></span><br/></a><a href="generic-numbers.html#%28mod-path._racket%2Fmath%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/math</span></span><br/></a><a href="os-lib.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/os</span></span><br/></a><a href="More_Path_Utilities.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/path</span></span><br/></a><a href="performance-hint.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/performance-hint</span></span><br/></a><a href="phase_space.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/phase+space</span></span><br/></a><a href="places.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/place</span></span><br/></a><a href="places.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/place/dynamic</span></span><br/></a><a href="port-lib.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/port</span></span><br/></a><a href="pretty-print.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/pretty</span></span><br/></a><a href="Delayed_Evaluation.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/promise</span></span><br/></a><a href="require.html#%28mod-path._racket%2Fprovide%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/provide</span></span><br/></a><a href="define.html#%28mod-path._racket%2Fprovide-syntax%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/provide-syntax</span></span><br/></a><a href="stxtrans.html#%28mod-path._racket%2Fprovide-transform%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/provide-transform</span></span><br/></a><a href="generic-numbers.html#%28mod-path._racket%2Frandom%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/random</span></span><br/></a><a href="repl-module.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/repl</span></span><br/></a><a href="require.html#%28mod-path._racket%2Frequire%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/require</span></span><br/></a><a href="define.html#%28mod-path._racket%2Frequire-syntax%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/require-syntax</span></span><br/></a><a href="stxtrans.html#%28mod-path._racket%2Frequire-transform%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/require-transform</span></span><br/></a><a href="interactive.html#%28mod-path._racket%2Frerequire%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/rerequire</span></span><br/></a><a href="running-sa.html#%28mod-path._racket%2Fruntime-config%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/runtime-config</span></span><br/></a><a href="Filesystem.html#%28mod-path._racket%2Fruntime-path%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/runtime-path</span></span><br/></a><a href="Sandboxed_Evaluation.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/sandbox</span></span><br/></a><a href="sequences.html#%28mod-path._racket%2Fsequence%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/sequence</span></span><br/></a><a href="serialization.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/serialize</span></span><br/></a><a href="sets.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/set</span></span><br/></a><a href="shared.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/shared</span></span><br/></a><a href="Single-Signature_Modules.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/signature</span></span><br/></a><a href="splicing.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/splicing</span></span><br/></a><a href="streams.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/stream</span></span><br/></a><a href="strings.html#%28mod-path._racket%2Fstring%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/string</span></span><br/></a><a href="structutils.html#%28mod-path._racket%2Fstruct%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/struct</span></span><br/></a><a href="structinfo.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/struct-info</span></span><br/></a><a href="stxparam.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/stxparam</span></span><br/></a><a href="stxparam.html#%28mod-path._racket%2Fstxparam-exptime%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/stxparam-exptime</span></span><br/></a><a href="Surrogates.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/surrogate</span></span><br/></a><a href="symbols.html#%28mod-path._racket%2Fsymbol%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/symbol</span></span><br/></a><a href="syntax-util.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/syntax</span></span><br/></a><a href="stxops.html#%28mod-path._racket%2Fsyntax-srcloc%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/syntax-srcloc</span></span><br/></a><a href="subprocess.html#%28mod-path._racket%2Fsystem%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/system</span></span><br/></a><a href="tcp.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/tcp</span></span><br/></a><a href="debugging.html#%28mod-path._racket%2Ftrace%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/trace</span></span><br/></a><a href="trait.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/trait</span></span><br/></a><a href="udp.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/udp</span></span><br/></a><a href="undefined.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/undefined</span></span><br/></a><a href="mzlib_unit.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/unit</span></span><br/></a><a href="Transformer_Helpers.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/unit-exptime</span></span><br/></a><a href="unreachable.html#%28mod-path._racket%2Funreachable%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/unreachable</span></span><br/></a><a href="unsafe.html" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/unsafe/ops</span></span><br/></a><a href="unsafe.html#%28mod-path._racket%2Funsafe%2Fundefined%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/unsafe/undefined</span></span><br/></a><a href="vectors.html#%28mod-path._racket%2Fvector%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/vector</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._334._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"racketrc.rktl"</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._335._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"racketrc.rktl"</span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._radians-~3edegrees%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">radians-&gt;degrees</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-argument-error%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-argument-error</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-argument-error%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-argument-error*</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arguments-error%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-arguments-error</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arguments-error%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-arguments-error*</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arity-error%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-arity-error</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arity-error%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-arity-error*</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arity-mask-error%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-arity-mask-error</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arity-mask-error%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-arity-mask-error*</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._raise-blame-error%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-blame-error</span></span><br/></a><a href="Legacy_Contracts.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._raise-contract-error%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-contract-error</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-mismatch-error%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-mismatch-error</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-range-error%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-range-error</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-range-error%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-range-error*</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-result-arity-error%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-result-arity-error</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-result-arity-error%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-result-arity-error*</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-result-error%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-result-error</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-result-error%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-result-error*</span></span><br/></a><a href="struct-generics.html#%28def._%28%28lib._racket%2Fgeneric..rkt%29._raise-support-error%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-support-error</span></span><br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._raise-syntax-error%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-syntax-error</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-type-error%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-type-error</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-user-error%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-user-error</span></span><br/></a><a href="exns.html#%28part._errorproc%29" class="indexlink" data-pltdoc="x">Raising Exceptions<br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._random%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">random</span></span><br/></a><a href="Random_generation.html" class="indexlink" data-pltdoc="x">Random generation<br/></a><a href="generic-numbers.html#%28part._.Random_.Numbers%29" class="indexlink" data-pltdoc="x">Random Numbers<br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Frandom..rkt%29._random-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">random-ref</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Frandom..rkt%29._random-sample%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">random-sample</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._random-seed%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">random-seed</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._range%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">range</span></span><br/></a><a href="numbers.html#%28tech._rational._number%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">rational numbers</span><br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._rational~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">rational?</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._rationalize%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">rationalize</span></span><br/></a><a href="eval-model.html#%28tech._reachable%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">reachable</span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read</span></span><br/></a><a href="securityguards.html#%28idx._%28gentag._280._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">read</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._356._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">read</span><br/></a><a href="syntax-model.html#%28tech._read%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">read</span><br/></a><a href="eval.html#%28tech._read._interaction._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">read interaction
+handler</span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-bar-quote%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-accept-bar-quote</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-box%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-accept-box</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-compiled%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-accept-compiled</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-dot%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-accept-dot</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-graph%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-accept-graph</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-infix-dot%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-accept-infix-dot</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-lang%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-accept-lang</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-quasiquote%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-accept-quasiquote</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-reader%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-accept-reader</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-byte%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-byte</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-byte-or-special%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-byte-or-special</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-bytes</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-bytes!</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-bytes%21-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-bytes!-evt</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-bytes-avail!</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-bytes-avail!*</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-bytes-avail%21-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-bytes-avail!-evt</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%2Fenable-break%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-bytes-avail!/enable-break</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-bytes-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-bytes-evt</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-line%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-bytes-line</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-bytes-line-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-bytes-line-evt</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-case-sensitive%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-case-sensitive</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-cdot%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-cdot</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-char</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char-or-special%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-char-or-special</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-curly-brace-as-paren%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-curly-brace-as-paren</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-curly-brace-with-tag%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-curly-brace-with-tag</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-decimal-as-inexact%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-decimal-as-inexact</span></span><br/></a><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._read-eval-print-loop%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-eval-print-loop</span></span><br/></a><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._read-installation-configuration-table%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-installation-configuration-table</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-language%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-language</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-line</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-line-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-line-evt</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-on-demand-source%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-on-demand-source</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-single-flonum%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-single-flonum</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-square-bracket-as-paren%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-square-bracket-as-paren</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-square-bracket-with-tag%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-square-bracket-with-tag</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-string</span></span><br/></a><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-string!</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-string%21-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-string!-evt</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-string-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-string-evt</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-syntax</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax-accept-graph%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-syntax-accept-graph</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%2Frecursive%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-syntax/recursive</span></span><br/></a><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%2Frecursive%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read/recursive</span></span><br/></a><a href="reader.html#%28mod-path._reader%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">reader</span></span><br/></a><a href="Reader_Extension.html" class="indexlink" data-pltdoc="x">Reader Extension<br/></a><a href="Reader_Extension.html#%28tech._reader._extension._procedure%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">reader
+extension procedures</span><br/></a><a href="Reading.html#%28tech._reader._language%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">reader language</span><br/></a><a href="readtables.html#%28tech._reader._macro%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">reader macro</span><br/></a><a href="reader-procs.html" class="indexlink" data-pltdoc="x">Reader-Extension Procedures<br/></a><a href="Reading.html" class="indexlink" data-pltdoc="x">Reading<br/></a><a href="reader.html#%28part._parse-boolean%29" class="indexlink" data-pltdoc="x">Reading Booleans<br/></a><a href="reader.html#%28part._parse-box%29" class="indexlink" data-pltdoc="x">Reading Boxes<br/></a><a href="reader.html#%28part._parse-character%29" class="indexlink" data-pltdoc="x">Reading Characters<br/></a><a href="reader.html#%28part._parse-comment%29" class="indexlink" data-pltdoc="x">Reading Comments<br/></a><a href="reader.html#%28part._parse-extflonum%29" class="indexlink" data-pltdoc="x">Reading Extflonums<br/></a><a href="reader.html#%28part._parse-graph%29" class="indexlink" data-pltdoc="x">Reading Graph Structure<br/></a><a href="reader.html#%28part._parse-hashtable%29" class="indexlink" data-pltdoc="x">Reading Hash Tables<br/></a><a href="reader.html#%28part._parse-keyword%29" class="indexlink" data-pltdoc="x">Reading Keywords<br/></a><a href="reader.html#%28part._parse-number%29" class="indexlink" data-pltdoc="x">Reading Numbers<br/></a><a href="reader.html#%28part._parse-pair%29" class="indexlink" data-pltdoc="x">Reading Pairs and Lists<br/></a><a href="reader.html#%28part._parse-quote%29" class="indexlink" data-pltdoc="x">Reading Quotes<br/></a><a href="reader.html#%28part._parse-regexp%29" class="indexlink" data-pltdoc="x">Reading Regular Expressions<br/></a><a href="reader.html#%28part._parse-string%29" class="indexlink" data-pltdoc="x">Reading Strings<br/></a><a href="reader.html#%28part._parse-structure%29" class="indexlink" data-pltdoc="x">Reading Structures<br/></a><a href="reader.html#%28part._parse-symbol%29" class="indexlink" data-pltdoc="x">Reading Symbols<br/></a><a href="reader.html#%28part._parse-vector%29" class="indexlink" data-pltdoc="x">Reading Vectors<br/></a><a href="reader.html#%28part._parse-reader%29" class="indexlink" data-pltdoc="x">Reading via an Extension<br/></a><a href="reader.html#%28part._parse-cdot%29" class="indexlink" data-pltdoc="x">Reading with C-style Infix-Dot Notation<br/></a><a href="readtables.html#%28tech._readtable%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">readtable</span><br/></a><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._readtable-mapping%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">readtable-mapping</span></span><br/></a><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._readtable~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">readtable?</span></span><br/></a><a href="readtables.html" class="indexlink" data-pltdoc="x">Readtables<br/></a><a href="sync.html#%28tech._ready._for._synchronization%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">ready for
+synchronization</span><br/></a><a href="numbers.html#%28tech._real._number%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">real numbers</span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._real-~3edecimal-string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">real-&gt;decimal-string</span></span><br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real-~3edouble-flonum%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">real-&gt;double-flonum</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._real-~3eextfl%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">real-&gt;extfl</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._real-~3efloating-point-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">real-&gt;floating-point-bytes</span></span><br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real-~3esingle-flonum%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">real-&gt;single-flonum</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._real-in%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">real-in</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._real-part%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">real-part</span></span><br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">real?</span></span><br/></a><a href="exns.html#%28tech._realm%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">realm</span><br/></a><a href="exns.html#%28part._err-realm%29" class="indexlink" data-pltdoc="x">Realms and Error Message Adjusters<br/></a><a href="pairs.html#%28idx._%28gentag._189._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">rearrangements<br/></a><a href="logging.html#%28part._receiving-logged-events%29" class="indexlink" data-pltdoc="x">Receiving Logged Events<br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._recompile-linklet%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">recompile-linklet</span></span><br/></a><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._recontract-out%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">recontract-out</span></span><br/></a><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._record-disappeared-uses%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">record-disappeared-uses</span></span><br/></a><a href="syntax-util.html#%28part._.Recording_disappeared_uses%29" class="indexlink" data-pltdoc="x">Recording disappeared uses<br/></a><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._recursive-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">recursive-contract</span></span><br/></a><a href="windowspaths.html#%28idx._%28gentag._316._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">RED</span><span class="hspace"></span></span><br/></a><a href="eval-model.html#%28tech._redex%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">redex</span><br/></a><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._redirect-generics%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">redirect-generics</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._reencode-input-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">reencode-input-port</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._reencode-output-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">reencode-output-port</span></span><br/></a><a href="syntax-model.html#%28tech._reference%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">reference</span><br/></a><a href="procedures.html#%28part._.Reflecting_on_.Primitives%29" class="indexlink" data-pltdoc="x">Reflecting on Primitives<br/></a><a href="security.html" class="indexlink" data-pltdoc="x">Reflection and Security<br/></a><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp</span></span><br/></a><a href="match.html#%28idx._%28gentag._213._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">regexp<br/></a><a href="regexp.html#%28part._.Regexp_.Constructors%29" class="indexlink" data-pltdoc="x">Regexp Constructors<br/></a><a href="regexp.html#%28part._.Regexp_.Matching%29" class="indexlink" data-pltdoc="x">Regexp Matching<br/></a><a href="regexp.html#%28part._.Regexp_.Splitting%29" class="indexlink" data-pltdoc="x">Regexp Splitting<br/></a><a href="regexp.html#%28part._.Regexp_.Substitution%29" class="indexlink" data-pltdoc="x">Regexp Substitution<br/></a><a href="regexp.html#%28part._regexp-syntax%29" class="indexlink" data-pltdoc="x">Regexp Syntax<br/></a><a href="regexp.html#%28tech._regexp._value%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">regexp value</span><br/></a><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-match</span></span><br/></a><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-match*</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._regexp-match-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-match-evt</span></span><br/></a><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match-exact~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-match-exact?</span></span><br/></a><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-match-peek</span></span><br/></a><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek-immediate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-match-peek-immediate</span></span><br/></a><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek-positions%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-match-peek-positions</span></span><br/></a><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match-peek-positions%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-match-peek-positions*</span></span><br/></a><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek-positions-immediate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-match-peek-positions-immediate</span></span><br/></a><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek-positions-immediate%2Fend%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-match-peek-positions-immediate/end</span></span><br/></a><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek-positions%2Fend%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-match-peek-positions/end</span></span><br/></a><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-positions%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-match-positions</span></span><br/></a><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match-positions%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-match-positions*</span></span><br/></a><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-positions%2Fend%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-match-positions/end</span></span><br/></a><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%2Fend%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-match/end</span></span><br/></a><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-match?</span></span><br/></a><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-max-lookbehind%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-max-lookbehind</span></span><br/></a><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-quote%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-quote</span></span><br/></a><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-replace%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-replace</span></span><br/></a><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-replace%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-replace*</span></span><br/></a><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-replace-quote%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-replace-quote</span></span><br/></a><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-replaces%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-replaces</span></span><br/></a><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-split%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-split</span></span><br/></a><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-try-match%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-try-match</span></span><br/></a><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp?</span></span><br/></a><a href="regexp.html" class="indexlink" data-pltdoc="x">regexps<br/></a><a href="regexp.html" class="indexlink" data-pltdoc="x">Regular Expressions<br/></a><a href="regexp.html#%28tech._regular._expression%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">Regular expressions</span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._regular-file-type-bits%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regular-file-type-bits</span></span><br/></a><a href="windowspaths.html#%28idx._%28gentag._315._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">REL</span><span class="hspace"></span></span><br/></a><a href="Manipulating_Paths.html#%28idx._%28gentag._292._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">relative</span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._relative-in%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">relative-in</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._relative-path~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">relative-path?</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._relocate-input-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">relocate-input-port</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._relocate-output-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">relocate-output-port</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._remainder%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remainder</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._remf%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remf</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._remf%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remf*</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remove%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remove</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remove%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remove*</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._remove-duplicates%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remove-duplicates</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remq</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remq%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remq*</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remv</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remv%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remv*</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remw</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remw%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remw*</span></span><br/></a><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._rename%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">rename</span></span><br/></a><a href="syntax-model.html#%28tech._rename._transformer%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">rename transformer</span><br/></a><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._rename-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">rename-contract</span></span><br/></a><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._rename-file-or-directory%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">rename-file-or-directory</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._rename-in%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">rename-in</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-inner%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">rename-inner</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._rename-out%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">rename-out</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._rename-super%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">rename-super</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._rename-transformer-target%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">rename-transformer-target</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._rename-transformer~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">rename-transformer?</span></span><br/></a><a href="eval.html#%28tech._repl%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">REPL</span><br/></a><a href="file-ports.html#%28idx._%28gentag._254._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">replace</span><br/></a><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._replace-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">replace-evt</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">require</span></span><br/></a><a href="define.html#%28part._require-syntax%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">require</span></span> Macros<br/></a><a href="stxtrans.html#%28tech._require._transformer%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">require
+transformer</span><br/></a><a href="stxtrans.html#%28part._require-trans%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">require</span></span> Transformers<br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._require-transformer~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">require-transformer?</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._reroot-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">reroot-path</span></span><br/></a><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">reset</span></span><br/></a><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset-at%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">reset-at</span></span><br/></a><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset0%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">reset0</span></span><br/></a><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._reset0-at%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">reset0-at</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._resolve-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">resolve-path</span></span><br/></a><a href="Module_Names_and_Loading.html#%28tech._resolved%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">resolved</span><br/></a><a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">resolved
+module path</span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path-name%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">resolved-module-path-name</span></span><br/></a><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">resolved-module-path?</span></span><br/></a><a href="Module_Names_and_Loading.html#%28part._modnameresolver%29" class="indexlink" data-pltdoc="x">Resolving Module Names<br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">rest</span></span><br/></a><a href="Byte_and_String_Input.html#%28idx._%28gentag._264._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">return</span><br/></a><a href="Byte_and_String_Input.html#%28idx._%28gentag._265._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">return-linefeed</span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._reverse%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">reverse</span></span><br/></a><a href="Namespaces.html#%28tech._root._namespace%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">root namespace</span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._round%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">round</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._349._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">run-file</span><br/></a><a href="subprocess.html#%28idx._%28gentag._385._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">running</span><br/></a><a href="running.html" class="indexlink" data-pltdoc="x">Running Racket<br/></a><a href="running-sa.html" class="indexlink" data-pltdoc="x">Running Racket or GRacket<br/></a><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._runtime-paths%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">runtime-paths</span></span><br/></a><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._runtime-require%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">runtime-require</span></span><br/></a><a name="alpha:S"></a><span><a href="reader.html#%28mod-path._s-exp%29" class="indexlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">s-exp</span></span><br/></a></span><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._s-exp-~3efasl%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">s-exp-&gt;fasl</span></span><br/></a><a href="reader.html#%28part._.S-.Expression_.Reader_.Language%29" class="indexlink" data-pltdoc="x">S-Expression Reader Language<br/></a><a href="Manipulating_Paths.html#%28idx._%28gentag._291._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">same</span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-coverage-enabled%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-coverage-enabled</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-error-output%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-error-output</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-eval-handlers%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-eval-handlers</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-eval-limits%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-eval-limits</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-exit-handler%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-exit-handler</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-gui-available%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-gui-available</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-init-hook%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-init-hook</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-input%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-input</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-code-inspector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-make-code-inspector</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-environment-variables%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-make-environment-variables</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-inspector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-make-inspector</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-logger%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-make-logger</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-namespace%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-make-namespace</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-make-plumber%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-make-plumber</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-memory-limit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-memory-limit</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-namespace-specs%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-namespace-specs</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-network-guard%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-network-guard</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-output%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-output</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-override-collection-paths%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-override-collection-paths</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-path-permissions%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-path-permissions</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-propagate-breaks%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-propagate-breaks</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-propagate-exceptions%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-propagate-exceptions</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-reader%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-reader</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-run-submodules%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-run-submodules</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._sandbox-security-guard%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sandbox-security-guard</span></span><br/></a><a href="Sandboxed_Evaluation.html" class="indexlink" data-pltdoc="x">Sandboxed Evaluation<br/></a><a href="characters.html#%28idx._%28gentag._169._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">sc</span><br/></a><a href="runtime.html#%28idx._%28gentag._439._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">scalable</span><br/></a><a href="characters.html#%28idx._%28gentag._149._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">scalar value<br/></a><a href="syntax-model.html#%28tech._scope%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">scope</span><br/></a><a href="syntax-model.html#%28tech._scope._set%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">scope set</span><br/></a><a href="creatingmorestructs.html#%28tech._sealed%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">sealed</span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._second%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">second</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._seconds-~3edate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">seconds-&gt;date</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28part._.Security_.Considerations%29" class="indexlink" data-pltdoc="x">Security Considerations<br/></a><a href="securityguards.html#%28tech._security._guard%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">security guard</span><br/></a><a href="securityguards.html" class="indexlink" data-pltdoc="x">Security Guards<br/></a><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._security-guard~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">security-guard?</span></span><br/></a><a href="sync.html" class="indexlink" data-pltdoc="x">select<br/></a><a href="createclass.html#%28idx._%28gentag._195._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">self<br/></a><a href="semaphore.html#%28tech._semaphore%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">semaphore</span><br/></a><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-peek-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">semaphore-peek-evt</span></span><br/></a><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-peek-evt~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">semaphore-peek-evt?</span></span><br/></a><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-post%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">semaphore-post</span></span><br/></a><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-try-wait~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">semaphore-try-wait?</span></span><br/></a><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">semaphore-wait</span></span><br/></a><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%2Fenable-break%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">semaphore-wait/enable-break</span></span><br/></a><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">semaphore?</span></span><br/></a><a href="semaphore.html" class="indexlink" data-pltdoc="x">Semaphores<br/></a><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">send</span></span><br/></a><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">send*</span></span><br/></a><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%2B%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">send+</span></span><br/></a><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send-generic%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">send-generic</span></span><br/></a><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%2Fapply%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">send/apply</span></span><br/></a><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%2Fkeyword-apply%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">send/keyword-apply</span></span><br/></a><a href="eval-model.html#%28idx._%28gentag._0._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">separate compilation guarantee<br/></a><a href="sequences.html#%28tech._sequence%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">sequence</span><br/></a><a href="sequences.html#%28part._.Sequence_.Conversion%29" class="indexlink" data-pltdoc="x">Sequence Conversion<br/></a><a href="sequences.html#%28part._.Sequence_.Predicate_and_.Constructors%29" class="indexlink" data-pltdoc="x">Sequence Predicate and Constructors<br/></a><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._sequence-~3egenerator%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-&gt;generator</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-~3elist%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-&gt;list</span></span><br/></a><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._sequence-~3erepeated-generator%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-&gt;repeated-generator</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-~3estream%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-&gt;stream</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-add-between%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-add-between</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-andmap%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-andmap</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-append%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-append</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-count%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-count</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-filter%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-filter</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-fold%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-fold</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-for-each%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-for-each</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-generate</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-generate*</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-length</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-map%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-map</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-ormap%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-ormap</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-ref</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-tail%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-tail</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence/c</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence?</span></span><br/></a><a href="sequences.html" class="indexlink" data-pltdoc="x">Sequences<br/></a><a href="sequences_streams.html" class="indexlink" data-pltdoc="x">Sequences and Streams<br/></a><a href="begin.html" class="indexlink" data-pltdoc="x">Sequencing: <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-for-syntax</span></span><br/></a><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._serializable-struct%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">serializable-struct</span></span><br/></a><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._serializable-struct%2Fversions%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">serializable-struct/versions</span></span><br/></a><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serializable~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">serializable?</span></span><br/></a><a href="serialization.html" class="indexlink" data-pltdoc="x">Serialization<br/></a><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">serialize</span></span><br/></a><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialized~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">serialized=?</span></span><br/></a><a href="Serializing_Syntax.html" class="indexlink" data-pltdoc="x">Serializing Syntax<br/></a><a href="securityguards.html#%28idx._%28gentag._286._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">server</span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set</span></span><br/></a><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._set%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">set</span></span><br/></a><a href="sets.html#%28tech._set%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">set</span><br/></a><a href="sets.html#%28part._set-methods%29" class="indexlink" data-pltdoc="x">Set Methods<br/></a><a href="sets.html#%28part._.Set_.Predicates_and_.Contracts%29" class="indexlink" data-pltdoc="x">Set Predicates and Contracts<br/></a><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">set!</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._set%21-transformer-procedure%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set!-transformer-procedure</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._set%21-transformer~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set!-transformer?</span></span><br/></a><a href="set_.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._set%21-values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">set!-values</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3elist%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-&gt;list</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-&gt;stream</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-add%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-add</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-add%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-add!</span></span><br/></a><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._set-box%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-box!</span></span><br/></a><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._set-box%2A%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-box*!</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-clear%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-clear</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-clear%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-clear!</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-copy%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-copy</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-copy-clear%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-copy-clear</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-count%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-count</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-empty~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-empty?</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-eq~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-eq?</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-equal-always~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-equal-always?</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-equal~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-equal?</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-eqv~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-eqv?</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._set-eval-handler%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-eval-handler</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28def._%28%28lib._racket%2Fsandbox..rkt%29._set-eval-limits%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-eval-limits</span></span><br/></a><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._set-field%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">set-field!</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-first%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-first</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-for-each%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-for-each</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._set-group-id-bit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-group-id-bit</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-implements%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-implements/c</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-implements~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-implements?</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-intersect%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-intersect</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-intersect%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-intersect!</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-map%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-map</span></span><br/></a><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._set-mcar%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-mcar!</span></span><br/></a><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._set-mcdr%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-mcdr!</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-member~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-member?</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-mutable~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-mutable?</span></span><br/></a><a href="phantom-bytes.html#%28def._%28%28quote._~23~25kernel%29._set-phantom-bytes%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-phantom-bytes!</span></span><br/></a><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._set-port-next-location%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-port-next-location!</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-remove</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-remove!</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-rest%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-rest</span></span><br/></a><a href="sets.html#%28idx._%28gentag._191._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">set-subset?<br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-subtract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-subtract</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-subtract%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-subtract!</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-symmetric-difference%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-symmetric-difference</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-symmetric-difference%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-symmetric-difference!</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-union%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-union</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-union%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-union!</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._set-user-id-bit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-user-id-bit</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-weak~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-weak?</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set/c</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set=?</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set?</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._setalw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">setalw</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._seteq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">seteq</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._seteqv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">seteqv</span></span><br/></a><a href="sets.html" class="indexlink" data-pltdoc="x">Sets<br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._seventh%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">seventh</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._sgn%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sgn</span></span><br/></a><a href="sha.html#%28def._%28%28quote._~23~25kernel%29._sha1-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sha1-bytes</span></span><br/></a><a href="sha.html#%28def._%28%28quote._~23~25kernel%29._sha224-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sha224-bytes</span></span><br/></a><a href="sha.html#%28def._%28%28quote._~23~25kernel%29._sha256-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sha256-bytes</span></span><br/></a><a href="syntax-model.html#%28tech._shadowing%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">shadowing</span><br/></a><a href="syntax-model.html#%28tech._shadow%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">shadows</span><br/></a><a href="Sandboxed_Evaluation.html#%28tech._shallow._time%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">Shallow time</span><br/></a><a href="shared.html#%28form._%28%28lib._racket%2Fshared..rkt%29._shared%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">shared</span></span><br/></a><a href="runtime.html#%28idx._%28gentag._430._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">shared</span><br/></a><a href="places.html#%28tech._shared._memory._space%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">shared memory space</span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._shared-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">shared-bytes</span></span><br/></a><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._shared-extflvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">shared-extflvector</span></span><br/></a><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._shared-flvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">shared-flvector</span></span><br/></a><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._shared-fxvector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">shared-fxvector</span></span><br/></a><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._shell-execute%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">shell-execute</span></span><br/></a><a href="subprocess.html#%28idx._%28gentag._386._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">ShellExecute<br/></a><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._shift%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">shift</span></span><br/></a><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._shift-at%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">shift-at</span></span><br/></a><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._shift0%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">shift0</span></span><br/></a><a href="cont.html#%28form._%28%28lib._racket%2Fcontrol..rkt%29._shift0-at%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">shift0-at</span></span><br/></a><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._shrink-path-wrt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">shrink-path-wrt</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._shuffle%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">shuffle</span></span><br/></a><a href="breakhandler.html#%28idx._%28gentag._225._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">SIGHUP</span><br/></a><a href="breakhandler.html#%28idx._%28gentag._224._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">SIGINT</span><br/></a><a href="mzlib_unit.html#%28tech._signature%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">signature</span><br/></a><a href="Transformer_Helpers.html#%28def._%28%28lib._racket%2Funit-exptime..rkt%29._signature-members%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">signature-members</span></span><br/></a><a href="breakhandler.html#%28idx._%28gentag._226._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">SIGTERM</span><br/></a><a href="subprocess.html#%28part._.Simple_.Subprocesses%29" class="indexlink" data-pltdoc="x">Simple Subprocesses<br/></a><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._simple-form-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">simple-form-path</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._simplify-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">simplify-path</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sin</span></span><br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._single-flonum-available~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">single-flonum-available?</span></span><br/></a><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._single-flonum~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">single-flonum?</span></span><br/></a><a href="numbers.html#%28tech._single._flonum%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">single-flonums</span><br/></a><a href="Single-Signature_Modules.html" class="indexlink" data-pltdoc="x">Single-Signature Modules<br/></a><a href="single-unit.html" class="indexlink" data-pltdoc="x">Single-Unit Modules<br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._sinh%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sinh</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._sixth%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sixth</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._367._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">size</span><br/></a><a href="characters.html#%28idx._%28gentag._171._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">sk</span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fcombinator..rkt%29._skip-projection-wrapper~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">skip-projection-wrapper?</span></span><br/></a><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._sleep%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sleep</span></span><br/></a><a href="characters.html#%28idx._%28gentag._170._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">sm</span><br/></a><a href="characters.html#%28idx._%28gentag._172._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">so</span><br/></a><a href="runtime.html#%28idx._%28gentag._436._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">so-mode</span><br/></a><a href="runtime.html#%28idx._%28gentag._435._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">so-suffix</span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._socket-type-bits%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">socket-type-bits</span></span><br/></a><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._some-system-path-~3estring%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">some-system-path-&gt;string</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._sort%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sort</span></span><br/></a><a href="exns.html#%28tech._source._location%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">source location</span><br/></a><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._space~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">space?</span></span><br/></a><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._spawn%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">spawn</span></span><br/></a><a href="ports.html#%28tech._special%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">special</span><br/></a><a href="special-comments.html" class="indexlink" data-pltdoc="x">Special Comments<br/></a><a href="special-comments.html#%28def._%28%28quote._~23~25kernel%29._special-comment-value%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">special-comment-value</span></span><br/></a><a href="special-comments.html#%28def._%28%28quote._~23~25kernel%29._special-comment~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">special-comment?</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._special-filter-input-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">special-filter-input-port</span></span><br/></a><a href="collects.html#%28tech._collection._splicing%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">spliced</span><br/></a><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-let%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-let</span></span><br/></a><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-let-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-let-syntax</span></span><br/></a><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-let-syntaxes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-let-syntaxes</span></span><br/></a><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-let-values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-let-values</span></span><br/></a><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-letrec%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-letrec</span></span><br/></a><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-letrec-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-letrec-syntax</span></span><br/></a><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-letrec-syntaxes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-letrec-syntaxes</span></span><br/></a><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-letrec-syntaxes%2Bvalues%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-letrec-syntaxes+values</span></span><br/></a><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-letrec-values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-letrec-values</span></span><br/></a><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-local%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-local</span></span><br/></a><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-parameterize%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-parameterize</span></span><br/></a><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-syntax-parameterize%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-syntax-parameterize</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._split-at%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">split-at</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._split-at-right%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">split-at-right</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._split-common-prefix%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">split-common-prefix</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._split-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">split-path</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._splitf-at%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">splitf-at</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._splitf-at-right%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">splitf-at-right</span></span><br/></a><a href="cont.html#%28def._%28%28lib._racket%2Fcontrol..rkt%29._splitter%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">splitter</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._sqr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sqr</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sqrt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sqrt</span></span><br/></a><a href="generic-numbers.html#%28idx._%28gentag._125._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">square root<br/></a><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">srcloc</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._srcloc-~3estring%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">srcloc-&gt;string</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._srcloc-column%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">srcloc-column</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._srcloc-line%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">srcloc-line</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._srcloc-position%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">srcloc-position</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._srcloc-source%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">srcloc-source</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._srcloc-span%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">srcloc-span</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._srcloc~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">srcloc?</span></span><br/></a><a href="contmarks.html#%28idx._%28gentag._221._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">stack
+dump<br/></a><a href="contmarks.html#%28idx._%28gentag._222._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">stack trace<br/></a><a href="runtime.html#%28idx._%28gentag._429._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">static</span><br/></a><a href="stencil_vectors.html#%28tech._stencil._vector%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">stencil vector</span><br/></a><a href="stencil_vectors.html" class="indexlink" data-pltdoc="x">Stencil Vectors<br/></a><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stencil-vector</span></span><br/></a><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stencil-vector-length</span></span><br/></a><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-mask%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stencil-vector-mask</span></span><br/></a><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-mask-width%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stencil-vector-mask-width</span></span><br/></a><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stencil-vector-ref</span></span><br/></a><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stencil-vector-set!</span></span><br/></a><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-update%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stencil-vector-update</span></span><br/></a><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stencil-vector?</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._sticky-bit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sticky-bit</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._stop-after%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stop-after</span></span><br/></a><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._stop-before%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stop-before</span></span><br/></a><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">stream</span></span><br/></a><a href="streams.html#%28tech._stream%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">stream</span><br/></a><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">stream*</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-~3elist%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-&gt;list</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-add-between%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-add-between</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-andmap%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-andmap</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-append%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-append</span></span><br/></a><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream-cons%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">stream-cons</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-count%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-count</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-empty~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-empty?</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-filter%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-filter</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-first%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-first</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-fold%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-fold</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-for-each%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-for-each</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-force%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-force</span></span><br/></a><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream-lazy%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">stream-lazy</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-length</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-map%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-map</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-ormap%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-ormap</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-ref</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-rest%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-rest</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-tail%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-tail</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-take%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-take</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream/c</span></span><br/></a><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream?</span></span><br/></a><a href="streams.html" class="indexlink" data-pltdoc="x">Streams<br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string</span></span><br/></a><a href="strings.html#%28tech._string%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">string</span><br/></a><a href="strings.html#%28part._.String_.Comparisons%29" class="indexlink" data-pltdoc="x">String Comparisons<br/></a><a href="strings.html#%28part._.String_.Constructors__.Selectors__and_.Mutators%29" class="indexlink" data-pltdoc="x">String Constructors, Selectors, and Mutators<br/></a><a href="strings.html#%28part._.String_.Conversions%29" class="indexlink" data-pltdoc="x">String Conversions<br/></a><a href="stringport.html#%28tech._string._port%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">string port</span><br/></a><a href="stringport.html" class="indexlink" data-pltdoc="x">String Ports<br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Flatin-1%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-&gt;bytes/latin-1</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Flocale%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-&gt;bytes/locale</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Futf-8%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-&gt;bytes/utf-8</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-~3eimmutable-string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-&gt;immutable-string</span></span><br/></a><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._string-~3ekeyword%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-&gt;keyword</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-~3elist%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-&gt;list</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._string-~3enumber%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-&gt;number</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._string-~3epath%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-&gt;path</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._string-~3epath-element%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-&gt;path-element</span></span><br/></a><a href="More_Path_Utilities.html#%28def._%28%28lib._racket%2Fpath..rkt%29._string-~3esome-system-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-&gt;some-system-path</span></span><br/></a><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3esymbol%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-&gt;symbol</span></span><br/></a><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3euninterned-symbol%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-&gt;uninterned-symbol</span></span><br/></a><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3eunreadable-symbol%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-&gt;unreadable-symbol</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-append</span></span><br/></a><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-append%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-append*</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append-immutable%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-append-immutable</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3c~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-ci&lt;=?</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3c~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-ci&lt;?</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-ci=?</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3e~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-ci&gt;=?</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3e~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-ci&gt;?</span></span><br/></a><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-contains~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-contains?</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-copy%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-copy</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-copy%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-copy!</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-downcase%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-downcase</span></span><br/></a><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._string-environment-variable-name~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-environment-variable-name?</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-fill%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-fill!</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-foldcase%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-foldcase</span></span><br/></a><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-join%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-join</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._string-len%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-len/c</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-length</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale-ci~3c~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-locale-ci&lt;?</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale-ci~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-locale-ci=?</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale-ci~3e~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-locale-ci&gt;?</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale-downcase%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-locale-downcase</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale-upcase%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-locale-upcase</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale~3c~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-locale&lt;?</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-locale=?</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale~3e~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-locale&gt;?</span></span><br/></a><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._string-no-nuls~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-no-nuls?</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-normalize-nfc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-normalize-nfc</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-normalize-nfd%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-normalize-nfd</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-normalize-nfkc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-normalize-nfkc</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-normalize-nfkd%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-normalize-nfkd</span></span><br/></a><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-normalize-spaces%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-normalize-spaces</span></span><br/></a><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._string-port~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-port?</span></span><br/></a><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-prefix~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-prefix?</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-ref</span></span><br/></a><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-replace%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-replace</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-set!</span></span><br/></a><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-split%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-split</span></span><br/></a><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-suffix~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-suffix?</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-titlecase%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-titlecase</span></span><br/></a><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-trim%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-trim</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-upcase%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-upcase</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-utf-8-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-utf-8-length</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string&lt;=?</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string&lt;?</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string=?</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3e~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string&gt;=?</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3e~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string&gt;?</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string?</span></span><br/></a><a href="regexp.html" class="indexlink" data-pltdoc="x">strings, pattern matching<br/></a><a href="reader.html#%28idx._%28gentag._36._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">strings, parsing<br/></a><a href="strings.html#%28idx._%28gentag._137._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">strings, immutable<br/></a><a href="strings.html#%28idx._%28gentag._138._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">strings, concatenate<br/></a><a href="strings.html" class="indexlink" data-pltdoc="x">Strings<br/></a><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct</span></span><br/></a><a href="match.html#%28idx._%28gentag._212._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">struct<br/></a><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._struct%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct*</span></span><br/></a><a href="structutils.html#%28def._%28%28lib._racket%2Fstruct..rkt%29._struct-~3elist%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-&gt;list</span></span><br/></a><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-~3evector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-&gt;vector</span></span><br/></a><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-accessor-procedure~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-accessor-procedure?</span></span><br/></a><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-auto-info-lists%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-auto-info-lists</span></span><br/></a><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-auto-info~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-auto-info?</span></span><br/></a><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-constructor-procedure~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-constructor-procedure?</span></span><br/></a><a href="struct-copy.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-copy%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct-copy</span></span><br/></a><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-field-index%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct-field-index</span></span><br/></a><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-field-info-list%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-field-info-list</span></span><br/></a><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-field-info~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-field-info?</span></span><br/></a><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._struct-guard%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct-guard/c</span></span><br/></a><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-info%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-info</span></span><br/></a><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-info~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-info?</span></span><br/></a><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-mutator-procedure~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-mutator-procedure?</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-out%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct-out</span></span><br/></a><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-predicate-procedure~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-predicate-procedure?</span></span><br/></a><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-authentic~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-type-authentic?</span></span><br/></a><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-info%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-type-info</span></span><br/></a><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-make-constructor%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-type-make-constructor</span></span><br/></a><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-make-predicate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-type-make-predicate</span></span><br/></a><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property-accessor-procedure~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-type-property-accessor-procedure?</span></span><br/></a><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property-predicate-procedure~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-type-property-predicate-procedure?</span></span><br/></a><a href="Structure_Type_Property_Contracts.html#%28def._%28%28lib._racket%2Fcontract..rkt%29._struct-type-property%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-type-property/c</span></span><br/></a><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-type-property?</span></span><br/></a><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-sealed~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-type-sealed?</span></span><br/></a><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-type~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-type?</span></span><br/></a><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fstruct-dc..rkt%29._struct%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct/c</span></span><br/></a><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._struct%2Fcontract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct/contract</span></span><br/></a><a href="define-sig-form.html#%28form._%28%28lib._racket%2Funit..rkt%29._struct%2Fctc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct/ctc</span></span><br/></a><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fstruct-dc..rkt%29._struct%2Fdc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct/dc</span></span><br/></a><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%2Fderived%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct/derived</span></span><br/></a><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._struct~3aarity-at-least%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:arity-at-least</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._struct~3acollapsible-count-property%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:collapsible-count-property</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._struct~3acollapsible-ho%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:collapsible-ho/c</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._struct~3acollapsible-leaf%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:collapsible-leaf/c</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._struct~3acollapsible-property%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:collapsible-property</span></span><br/></a><a href="collapsible.html#%28def._%28%28lib._racket%2Fcontract%2Fcollapsible..rkt%29._struct~3acollapsible-wrapper-property%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:collapsible-wrapper-property</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._struct~3adate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:date</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._struct~3adate%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:date*</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3abreak%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:break</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3abreak~3ahang-up%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:break:hang-up</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3abreak~3aterminate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:break:terminate</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3acontract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:contract</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3acontract~3aarity%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:contract:arity</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fblame..rkt%29._struct~3aexn~3afail~3acontract~3ablame%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:contract:blame</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3acontract~3acontinuation%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:contract:continuation</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3acontract~3adivide-by-zero%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:contract:divide-by-zero</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3acontract~3anon-fixnum-result%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:contract:non-fixnum-result</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3acontract~3avariable%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:contract:variable</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3afilesystem%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:filesystem</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3afilesystem~3aerrno%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:filesystem:errno</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3afilesystem~3aexists%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:filesystem:exists</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3afilesystem~3amissing-module%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:filesystem:missing-module</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3afilesystem~3aversion%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:filesystem:version</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3anetwork%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:network</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3anetwork~3aerrno%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:network:errno</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._struct~3aexn~3afail~3aobject%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:object</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3aout-of-memory%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:out-of-memory</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3aread%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:read</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3aread~3aeof%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:read:eof</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3aread~3anon-char%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:read:non-char</span></span><br/></a><a href="struct-generics.html#%28def._%28%28lib._racket%2Fgeneric..rkt%29._struct~3aexn~3afail~3asupport%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:support</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3asyntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:syntax</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3asyntax~3amissing-module%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:syntax:missing-module</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3asyntax~3aunbound%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:syntax:unbound</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3aunsupported%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:unsupported</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3aexn~3afail~3auser%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:exn:fail:user</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._struct~3aexport%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:export</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._struct~3aimport%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:import</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._struct~3aimport-source%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:import-source</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._struct~3asrcloc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:srcloc</span></span><br/></a><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct~3astruct-info%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:struct-info</span></span><br/></a><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct?</span></span><br/></a><a href="Structural_Matching.html" class="indexlink" data-pltdoc="x">Structural Matching<br/></a><a href="structures.html#%28tech._structure%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">structure</span><br/></a><a href="inspectors.html" class="indexlink" data-pltdoc="x">Structure Inspectors<br/></a><a href="structures.html#%28tech._structure._subtype%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">structure subtype</span><br/></a><a href="structures.html#%28tech._structure._type%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">structure type</span><br/></a><a href="define-struct.html#%28tech._structure._type._descriptor%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">structure type
+descriptor</span><br/></a><a href="structprops.html" class="indexlink" data-pltdoc="x">Structure Type Properties<br/></a><a href="structprops.html#%28tech._structure._type._property%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">structure type property</span><br/></a><a href="Structure_Type_Property_Contracts.html" class="indexlink" data-pltdoc="x">Structure Type Property Contracts<br/></a><a href="structprops.html#%28tech._structure._type._property._descriptor%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">structure type property descriptor</span><br/></a><a href="structinfo.html" class="indexlink" data-pltdoc="x">Structure Type Transformer Binding<br/></a><a href="structutils.html" class="indexlink" data-pltdoc="x">Structure Utilities<br/></a><a href="structures.html#%28idx._%28gentag._193._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">structures, equality<br/></a><a href="structures.html" class="indexlink" data-pltdoc="x">Structures<br/></a><a href="portstructs.html" class="indexlink" data-pltdoc="x">Structures as Ports<br/></a><a href="eval-model.html#%28part._cont-model%29" class="indexlink" data-pltdoc="x">Sub-expression Evaluation and Continuations<br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sub1</span></span><br/></a><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._subbytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subbytes</span></span><br/></a><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._subclass~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subclass?</span></span><br/></a><a href="Object_and_Class_Contracts.html#%28def._%28%28lib._racket%2Fclass..rkt%29._subclass~3f%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subclass?/c</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">submod</span></span><br/></a><a href="eval-model.html#%28tech._submodule%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">submodule</span><br/></a><a href="eval-model.html#%28part._submodules%29" class="indexlink" data-pltdoc="x">Submodules<br/></a><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subprocess</span></span><br/></a><a href="subprocess.html#%28tech._subproces%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">subprocess</span><br/></a><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-group-enabled%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subprocess-group-enabled</span></span><br/></a><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-kill%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subprocess-kill</span></span><br/></a><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-pid%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subprocess-pid</span></span><br/></a><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-status%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subprocess-status</span></span><br/></a><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-wait%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subprocess-wait</span></span><br/></a><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subprocess?</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._subset~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subset?</span></span><br/></a><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._substring%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">substring</span></span><br/></a><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._subtract-in%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">subtract-in</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._suggest%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">suggest/c</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">super</span></span><br/></a><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-instantiate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">super-instantiate</span></span><br/></a><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-make-object%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">super-make-object</span></span><br/></a><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">super-new</span></span><br/></a><a href="mzlib_class.html#%28tech._superclas%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">superclass</span><br/></a><a href="runtime.html#%28idx._%28gentag._438._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">supported</span><br/></a><a href="struct-generics.html#%28tech._supported._generic._method%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">supported generic method</span><br/></a><a href="Surrogates.html#%28form._%28%28lib._racket%2Fsurrogate..rkt%29._surrogate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">surrogate</span></span><br/></a><a href="Surrogates.html" class="indexlink" data-pltdoc="x">Surrogates<br/></a><a href="threads.html#%28part._threadkill%29" class="indexlink" data-pltdoc="x">Suspending, Resuming, and Killing Threads<br/></a><a href="subprocess.html#%28idx._%28gentag._388._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">SW_HIDE</span><br/></a><a href="subprocess.html#%28idx._%28gentag._387._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">sw_hide</span><br/></a><a href="subprocess.html#%28idx._%28gentag._390._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">SW_MAXIMIZE</span><br/></a><a href="subprocess.html#%28idx._%28gentag._389._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">sw_maximize</span><br/></a><a href="subprocess.html#%28idx._%28gentag._392._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">SW_MINIMIZE</span><br/></a><a href="subprocess.html#%28idx._%28gentag._391._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">sw_minimize</span><br/></a><a href="subprocess.html#%28idx._%28gentag._394._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">SW_RESTORE</span><br/></a><a href="subprocess.html#%28idx._%28gentag._393._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">sw_restore</span><br/></a><a href="subprocess.html#%28idx._%28gentag._396._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">SW_SHOW</span><br/></a><a href="subprocess.html#%28idx._%28gentag._395._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">sw_show</span><br/></a><a href="subprocess.html#%28idx._%28gentag._398._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">SW_SHOWDEFAULT</span><br/></a><a href="subprocess.html#%28idx._%28gentag._397._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">sw_showdefault</span><br/></a><a href="subprocess.html#%28idx._%28gentag._400._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">SW_SHOWMAXIMIZED</span><br/></a><a href="subprocess.html#%28idx._%28gentag._399._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">sw_showmaximized</span><br/></a><a href="subprocess.html#%28idx._%28gentag._402._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">SW_SHOWMINIMIZED</span><br/></a><a href="subprocess.html#%28idx._%28gentag._401._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">sw_showminimized</span><br/></a><a href="subprocess.html#%28idx._%28gentag._404._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">SW_SHOWMINNOACTIVE</span><br/></a><a href="subprocess.html#%28idx._%28gentag._403._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">sw_showminnoactive</span><br/></a><a href="subprocess.html#%28idx._%28gentag._406._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">SW_SHOWNA</span><br/></a><a href="subprocess.html#%28idx._%28gentag._405._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">sw_showna</span><br/></a><a href="subprocess.html#%28idx._%28gentag._408._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">SW_SHOWNOACTIVATE</span><br/></a><a href="subprocess.html#%28idx._%28gentag._407._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">sw_shownoactivate</span><br/></a><a href="subprocess.html#%28idx._%28gentag._410._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">SW_SHOWNORMAL</span><br/></a><a href="subprocess.html#%28idx._%28gentag._409._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">sw_shownormal</span><br/></a><a href="symbols.html#%28tech._symbol%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">symbol</span><br/></a><a href="symbols.html#%28def._%28%28lib._racket%2Fsymbol..rkt%29._symbol-~3eimmutable-string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">symbol-&gt;immutable-string</span></span><br/></a><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-~3estring%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">symbol-&gt;string</span></span><br/></a><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-interned~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">symbol-interned?</span></span><br/></a><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-unreadable~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">symbol-unreadable?</span></span><br/></a><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3c~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">symbol&lt;?</span></span><br/></a><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._symbol~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">symbol=?</span></span><br/></a><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">symbol?</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._symbolic-link-type-bits%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">symbolic-link-type-bits</span></span><br/></a><a href="symbols.html" class="indexlink" data-pltdoc="x">symbols, unique<br/></a><a href="symbols.html" class="indexlink" data-pltdoc="x">symbols, generating<br/></a><a href="symbols.html" class="indexlink" data-pltdoc="x">Symbols<br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._symbols%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">symbols</span></span><br/></a><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sync</span></span><br/></a><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Fenable-break%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sync/enable-break</span></span><br/></a><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sync/timeout</span></span><br/></a><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%2Fenable-break%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sync/timeout/enable-break</span></span><br/></a><a href="sync.html#%28tech._synchronizable._event%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">synchronizable event</span><br/></a><a href="all-sync.html" class="indexlink" data-pltdoc="x">Synchronization<br/></a><a href="sync.html#%28tech._synchronization._result%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">synchronization result</span><br/></a><a href="threads.html#%28part._threadsync%29" class="indexlink" data-pltdoc="x">Synchronizing Thread State<br/></a><a href="syntax-model.html#%28tech._syntactic._form%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">syntactic form</span><br/></a><a href="syntax.html" class="indexlink" data-pltdoc="x">Syntactic Forms<br/></a><a href="places.html#%28part._places-syntax%29" class="indexlink" data-pltdoc="x">Syntactic Support for Using Places<br/></a><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">syntax</span></span><br/></a><a href="stxops.html#%28tech._syntax._binding._set%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">syntax binding set</span><br/></a><a href="syntax-model.html" class="indexlink" data-pltdoc="x">Syntax Model<br/></a><a href="syntax-model.html#%28tech._syntax._object%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">syntax object</span><br/></a><a href="stxcmp.html" class="indexlink" data-pltdoc="x">Syntax Object Bindings<br/></a><a href="stxops.html" class="indexlink" data-pltdoc="x">Syntax Object Content<br/></a><a href="stxprops.html" class="indexlink" data-pltdoc="x">Syntax Object Properties<br/></a><a href="stxops.html#%28part._.Syntax_.Object_.Source_.Locations%29" class="indexlink" data-pltdoc="x">Syntax Object Source Locations<br/></a><a href="syntax-model.html#%28part._stxobj-model%29" class="indexlink" data-pltdoc="x">Syntax Objects<br/></a><a href="stxops.html#%28tech._syntax._pair%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">syntax pair</span><br/></a><a href="stxparam.html#%28tech._syntax._parameter%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">syntax
+parameter</span><br/></a><a href="stxparam.html#%28part._.Syntax_.Parameter_.Inspection%29" class="indexlink" data-pltdoc="x">Syntax Parameter Inspection<br/></a><a href="stxparam.html" class="indexlink" data-pltdoc="x">Syntax Parameters<br/></a><a href="stxprops.html#%28tech._syntax._property%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">syntax property</span><br/></a><a href="Syntax_Quoting__quote-syntax.html" class="indexlink" data-pltdoc="x">Syntax Quoting: <span class="RktSym"><span class="RktStxLink">quote-syntax</span></span><br/></a><a href="stxcerts.html" class="indexlink" data-pltdoc="x">Syntax Taints<br/></a><a href="syntax-model.html#%28tech._syntax._transformer%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">syntax transformer</span><br/></a><a href="stxtrans.html" class="indexlink" data-pltdoc="x">Syntax Transformers<br/></a><a href="syntax-util.html" class="indexlink" data-pltdoc="x">Syntax Utilities<br/></a><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-&gt;datum</span></span><br/></a><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3elist%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-&gt;list</span></span><br/></a><a href="stxcerts.html#%28def._%28%28quote._~23~25kernel%29._syntax-arm%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-arm</span></span><br/></a><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-binding-set%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-binding-set</span></span><br/></a><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-binding-set-~3esyntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-binding-set-&gt;syntax</span></span><br/></a><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._syntax-binding-set-extend%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-binding-set-extend</span></span><br/></a><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-binding-set~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-binding-set?</span></span><br/></a><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">syntax-case</span></span><br/></a><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">syntax-case*</span></span><br/></a><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-column%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-column</span></span><br/></a><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-debug-info%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-debug-info</span></span><br/></a><a href="Serializing_Syntax.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._syntax-deserialize%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-deserialize</span></span><br/></a><a href="stxcerts.html#%28def._%28%28quote._~23~25kernel%29._syntax-disarm%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-disarm</span></span><br/></a><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-e</span></span><br/></a><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-id-rules%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">syntax-id-rules</span></span><br/></a><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-line%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-line</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-apply-transformer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-apply-transformer</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-bind-syntaxes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-bind-syntaxes</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._syntax-local-certifier%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-certifier</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-context%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-context</span></span><br/></a><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._syntax-local-eval%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-eval</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-expand-expression%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-expand-expression</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-get-shadower%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-get-shadower</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-identifier-as-binding%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-identifier-as-binding</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-introduce%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-introduce</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-context%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-lift-context</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-expression%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-lift-expression</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-module%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-lift-module</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-module-end-declaration%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-lift-module-end-declaration</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-provide%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-lift-provide</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-require%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-lift-require</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-values-expression%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-lift-values-expression</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-make-definition-context%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-make-definition-context</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-make-delta-introducer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-make-delta-introducer</span></span><br/></a><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._syntax-local-match-introduce%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-match-introduce</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-module-defined-identifiers%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-module-defined-identifiers</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-module-exports%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-module-exports</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-module-interned-scope-symbols%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-module-interned-scope-symbols</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-module-required-identifiers%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-module-required-identifiers</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-name%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-name</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-phase-level%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-phase-level</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._syntax-local-provide-certifier%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-provide-certifier</span></span><br/></a><a href="define.html#%28def._%28%28lib._racket%2Fprovide-syntax..rkt%29._syntax-local-provide-introduce%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-provide-introduce</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._syntax-local-require-certifier%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-require-certifier</span></span><br/></a><a href="define.html#%28def._%28%28lib._racket%2Frequire-syntax..rkt%29._syntax-local-require-introduce%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-require-introduce</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-submodules%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-submodules</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-transforming-module-provides~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-transforming-module-provides?</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-value</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%2Fimmediate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-value/immediate</span></span><br/></a><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._syntax-local-value%2Frecord%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-local-value/record</span></span><br/></a><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-original~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-original?</span></span><br/></a><a href="stxparam.html#%28def._%28%28lib._racket%2Fstxparam-exptime..rkt%29._syntax-parameter-value%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-parameter-value</span></span><br/></a><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._syntax-parameterize%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">syntax-parameterize</span></span><br/></a><a href="stx-patterns.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-pattern-variable~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-pattern-variable?</span></span><br/></a><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-position%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-position</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Fkeyword-transform..rkt%29._syntax-procedure-alias-property%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-procedure-alias-property</span></span><br/></a><a href="stxtrans.html#%28def._%28%28lib._racket%2Fkeyword-transform..rkt%29._syntax-procedure-converted-arguments-property%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-procedure-converted-arguments-property</span></span><br/></a><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-property</span></span><br/></a><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property-preserved~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-property-preserved?</span></span><br/></a><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property-remove%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-property-remove</span></span><br/></a><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property-symbol-keys%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-property-symbol-keys</span></span><br/></a><a href="stxcerts.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-protect%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-protect</span></span><br/></a><a href="stxcerts.html#%28def._%28%28quote._~23~25kernel%29._syntax-rearm%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-rearm</span></span><br/></a><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._syntax-recertify%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-recertify</span></span><br/></a><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">syntax-rules</span></span><br/></a><a href="Serializing_Syntax.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._syntax-serialize%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-serialize</span></span><br/></a><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-shift-phase-level%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-shift-phase-level</span></span><br/></a><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-source%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-source</span></span><br/></a><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-source-module%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-source-module</span></span><br/></a><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-span%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-span</span></span><br/></a><a href="stxops.html#%28def._%28%28lib._racket%2Fsyntax-srcloc..rkt%29._syntax-srcloc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-srcloc</span></span><br/></a><a href="stxcerts.html#%28def._%28%28quote._~23~25kernel%29._syntax-taint%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-taint</span></span><br/></a><a href="stxcerts.html#%28def._%28%28quote._~23~25kernel%29._syntax-tainted~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-tainted?</span></span><br/></a><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-track-origin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-track-origin</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming-module-expression~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-transforming-module-expression?</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming-with-lifts~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-transforming-with-lifts?</span></span><br/></a><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-transforming?</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._syntax%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax/c</span></span><br/></a><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%2Floc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">syntax/loc</span></span><br/></a><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax?</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._347._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">sys-dir</span><br/></a><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">system</span></span><br/></a><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">system*</span></span><br/></a><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%2A%2Fexit-code%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">system*/exit-code</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._system-big-endian~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">system-big-endian?</span></span><br/></a><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._system-idle-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">system-idle-evt</span></span><br/></a><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-language%2Bcountry%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">system-language+country</span></span><br/></a><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-library-subpath%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">system-library-subpath</span></span><br/></a><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._system-path-convention-type%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">system-path-convention-type</span></span><br/></a><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">system-type</span></span><br/></a><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%2Fexit-code%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">system/exit-code</span></span><br/></a><a name="alpha:T"></a><span><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._tag%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">tag</span></span><br/></a></span><a href="eval-model.html#%28part._.Tail_.Position%29" class="indexlink" data-pltdoc="x">Tail Position<br/></a><a href="eval-model.html#%28tech._tail._position%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">tail position</span><br/></a><a href="stxcerts.html#%28idx._%28gentag._239._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">taint-mode</span><br/></a><a href="stxcerts.html#%28tech._tainted%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">tainted</span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._take%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">take</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._take-common-prefix%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">take-common-prefix</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._take-right%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">take-right</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._takef%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">takef</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._takef-right%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">takef-right</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._tan%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tan</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._tanh%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tanh</span></span><br/></a><a href="runtime.html#%28idx._%28gentag._434._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">target-machine</span><br/></a><a href="tcp.html" class="indexlink" data-pltdoc="x">TCP<br/></a><a href="tcp.html#%28tech._tcp._listener%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">TCP
+listener</span><br/></a><a href="tcp.html#%28tech._tcp._port%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">TCP port</span><br/></a><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-abandon-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-abandon-port</span></span><br/></a><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-accept</span></span><br/></a><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-accept-evt</span></span><br/></a><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept-ready~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-accept-ready?</span></span><br/></a><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%2Fenable-break%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-accept/enable-break</span></span><br/></a><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-addresses%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-addresses</span></span><br/></a><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-close%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-close</span></span><br/></a><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-connect%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-connect</span></span><br/></a><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-connect%2Fenable-break%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-connect/enable-break</span></span><br/></a><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listen%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-listen</span></span><br/></a><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listener~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-listener?</span></span><br/></a><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-port~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-port?</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._331._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">TEMP</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._328._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">temp-dir</span><br/></a><a href="syntax-model.html#%28tech._template._environment%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">template environment</span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._tentative-pretty-print-port-cancel%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tentative-pretty-print-port-cancel</span></span><br/></a><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._tentative-pretty-print-port-transfer%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tentative-pretty-print-port-transfer</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._tenth%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tenth</span></span><br/></a><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._terminal-port~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">terminal-port?</span></span><br/></a><a href="readtables.html#%28idx._%28gentag._269._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">terminating-macro</span><br/></a><a href="file-ports.html#%28idx._%28gentag._252._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">text</span><br/></a><a href="time.html#%28tech._the._epoch%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">the epoch</span><br/></a><a href="printing.html" class="indexlink" data-pltdoc="x">The Printer<br/></a><a href="index.html" class="indexlink" data-pltdoc="x">The Racket Reference<br/></a><a href="load-lang.html" class="indexlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/load</span></span> Language<br/></a><a href="repl-module.html" class="indexlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/repl</span></span> Library<br/></a><a href="reader.html" class="indexlink" data-pltdoc="x">The Reader<br/></a><a href="eval-model.html#%28part._separate-compilation%29" class="indexlink" data-pltdoc="x">The Separate Compilation Guarantee<br/></a><a href="function-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._the-unsupplied-arg%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">the-unsupplied-arg</span></span><br/></a><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._third%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">third</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">this</span></span><br/></a><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this~25%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">this%</span></span><br/></a><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread</span></span><br/></a><a href="threadcells.html" class="indexlink" data-pltdoc="x">Thread Cells<br/></a><a href="eval-model.html#%28tech._thread._cell%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">thread
+cells</span><br/></a><a href="threads.html#%28tech._thread._descriptor%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">thread
+descriptor</span><br/></a><a href="threadgroups.html#%28tech._thread._group%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">thread group</span><br/></a><a href="threadgroups.html" class="indexlink" data-pltdoc="x">Thread Groups<br/></a><a href="threads.html#%28part._threadmbox%29" class="indexlink" data-pltdoc="x">Thread Mailboxes<br/></a><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-cell-ref</span></span><br/></a><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-cell-set!</span></span><br/></a><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-values~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-cell-values?</span></span><br/></a><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-cell?</span></span><br/></a><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-dead-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-dead-evt</span></span><br/></a><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-dead~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-dead?</span></span><br/></a><a href="threadgroups.html#%28def._%28%28quote._~23~25kernel%29._thread-group~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-group?</span></span><br/></a><a href="thread-local-storage.html" class="indexlink" data-pltdoc="x">Thread-Local Storage<br/></a><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-receive%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-receive</span></span><br/></a><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-receive-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-receive-evt</span></span><br/></a><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-resume%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-resume</span></span><br/></a><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-resume-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-resume-evt</span></span><br/></a><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-rewind-receive%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-rewind-receive</span></span><br/></a><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-running~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-running?</span></span><br/></a><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-send%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-send</span></span><br/></a><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-suspend%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-suspend</span></span><br/></a><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-suspend-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-suspend-evt</span></span><br/></a><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-try-receive%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-try-receive</span></span><br/></a><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-wait%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-wait</span></span><br/></a><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%2Fsuspend-to-kill%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread/suspend-to-kill</span></span><br/></a><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread?</span></span><br/></a><a href="threads.html#%28idx._%28gentag._228._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">threads, run state<br/></a><a href="breakhandler.html" class="indexlink" data-pltdoc="x">threads, breaking<br/></a><a href="threads.html#%28idx._%28gentag._227._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">threads, breaking<br/></a><a href="eval-model.html#%28part._thread-model%29" class="indexlink" data-pltdoc="x">Threads<br/></a><a href="threads.html" class="indexlink" data-pltdoc="x">Threads<br/></a><a href="eval-model.html#%28tech._thread%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">threads</span><br/></a><a href="procedures.html#%28form._%28%28lib._racket%2Ffunction..rkt%29._thunk%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">thunk</span></span><br/></a><a href="procedures.html#%28form._%28%28lib._racket%2Ffunction..rkt%29._thunk%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">thunk*</span></span><br/></a><a href="time.html" class="indexlink" data-pltdoc="x">Time<br/></a><a href="time.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._time%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">time</span></span><br/></a><a href="time.html#%28def._%28%28quote._~23~25kernel%29._time-apply%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">time-apply</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._330._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">TMP</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._329._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">TMPDIR</span><br/></a><a href="syntax-model.html#%28tech._top._level._binding%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">top-level binding</span><br/></a><a href="syntax-model.html#%28tech._top._level._context%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">top-level context</span><br/></a><a href="eval-model.html#%28tech._top._level._variable%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">top-level variable</span><br/></a><a href="eval-model.html#%28part._.Top-.Level_.Variables%29" class="indexlink" data-pltdoc="x">Top-Level Variables<br/></a><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">touch</span></span><br/></a><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">trace</span></span><br/></a><a href="debugging.html#%28def._%28%28lib._racket%2Ftrace..rkt%29._trace-call%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">trace-call</span></span><br/></a><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-define%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">trace-define</span></span><br/></a><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-define-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">trace-define-syntax</span></span><br/></a><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-lambda%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">trace-lambda</span></span><br/></a><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._trace-let%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">trace-let</span></span><br/></a><a href="debugging.html#%28part._.Tracing%29" class="indexlink" data-pltdoc="x">Tracing<br/></a><a href="trait.html#%28form._%28%28lib._racket%2Ftrait..rkt%29._trait%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym">trait</span><br/></a><a href="trait.html#%28tech._trait%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">trait</span><br/></a><a href="trait.html#%28def._%28%28lib._racket%2Ftrait..rkt%29._trait-~3emixin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym">trait-&gt;mixin</span><br/></a><a href="trait.html#%28form._%28%28lib._racket%2Ftrait..rkt%29._trait-alias%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym">trait-alias</span><br/></a><a href="trait.html#%28form._%28%28lib._racket%2Ftrait..rkt%29._trait-exclude%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym">trait-exclude</span><br/></a><a href="trait.html#%28form._%28%28lib._racket%2Ftrait..rkt%29._trait-exclude-field%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym">trait-exclude-field</span><br/></a><a href="trait.html#%28form._%28%28lib._racket%2Ftrait..rkt%29._trait-rename%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym">trait-rename</span><br/></a><a href="trait.html#%28form._%28%28lib._racket%2Ftrait..rkt%29._trait-rename-field%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym">trait-rename-field</span><br/></a><a href="trait.html#%28def._%28%28lib._racket%2Ftrait..rkt%29._trait-sum%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym">trait-sum</span><br/></a><a href="trait.html#%28def._%28%28lib._racket%2Ftrait..rkt%29._trait~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym">trait?</span><br/></a><a href="trait.html" class="indexlink" data-pltdoc="x">Traits<br/></a><a href="syntax-model.html#%28tech._transformer%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">transformer</span><br/></a><a href="syntax-model.html#%28part._transformer-model%29" class="indexlink" data-pltdoc="x">Transformer Bindings<br/></a><a href="syntax-model.html#%28tech._transformer._environment%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">transformer environment</span><br/></a><a href="Transformer_Helpers.html" class="indexlink" data-pltdoc="x">Transformer Helpers<br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._transplant-input-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">transplant-input-port</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._transplant-output-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">transplant-output-port</span></span><br/></a><a href="generic-numbers.html#%28part._.Trigonometric_.Functions%29" class="indexlink" data-pltdoc="x">Trigonometric Functions<br/></a><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._true%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">true</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._truncate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">truncate</span></span><br/></a><a href="file-ports.html#%28idx._%28gentag._255._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">truncate</span><br/></a><a href="file-ports.html#%28idx._%28gentag._257._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">truncate/replace</span><br/></a><a name="alpha:U"></a><span><a href="udp.html" class="indexlink" data-pltdoc="x">UDP<br/></a></span><a href="udp.html#%28tech._udp._socket%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">UDP socket</span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-addresses%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-addresses</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-bind%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-bind!</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-bound~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-bound?</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-close%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-close</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-connect%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-connect!</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-connected~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-connected?</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-interface%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-multicast-interface</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-join-group%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-multicast-join-group!</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-leave-group%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-multicast-leave-group!</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-loopback~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-multicast-loopback?</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-set-interface%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-multicast-set-interface!</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-set-loopback%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-multicast-set-loopback!</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-set-ttl%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-multicast-set-ttl!</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-ttl%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-multicast-ttl</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-open-socket%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-open-socket</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-receive!</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive%21%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-receive!*</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive%21-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-receive!-evt</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive%21%2Fenable-break%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-receive!/enable-break</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive-ready-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-receive-ready-evt</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-send</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-send*</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-send-evt</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-ready-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-send-ready-evt</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-send-to</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-send-to*</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-send-to-evt</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%2Fenable-break%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-send-to/enable-break</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send%2Fenable-break%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-send/enable-break</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-set-receive-buffer-size%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-set-receive-buffer-size!</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-set-ttl%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-set-ttl!</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-ttl%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-ttl</span></span><br/></a><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp?</span></span><br/></a><a href="syntax-model.html#%28tech._unbound%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">unbound</span><br/></a><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unbox</span></span><br/></a><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unbox*</span></span><br/></a><a href="exns.html#%28tech._uncaught._exception._handler%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">uncaught-exception handler</span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._uncaught-exception-handler%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">uncaught-exception-handler</span></span><br/></a><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._unconstrained-domain-~3e%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unconstrained-domain-&gt;</span></span><br/></a><a href="undefined.html" class="indexlink" data-pltdoc="x">Undefined<br/></a><a href="undefined.html#%28def._%28%28lib._racket%2Fundefined..rkt%29._undefined%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">undefined</span></span><br/></a><a href="let.html#%28idx._%28gentag._108._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">undefined-error-name</span><br/></a><a href="symbols.html#%28tech._uninterned%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">uninterned</span><br/></a><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unit</span></span><br/></a><a href="unitcontracts.html#%28tech._unit._contract%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">unit contract</span><br/></a><a href="unitcontracts.html" class="indexlink" data-pltdoc="x">Unit Contracts<br/></a><a href="Unit_Utilities.html" class="indexlink" data-pltdoc="x">Unit Utilities<br/></a><a href="Generating_A_Unit_from_Context.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit-from-context%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unit-from-context</span></span><br/></a><a href="Transformer_Helpers.html#%28def._%28%28lib._racket%2Funit-exptime..rkt%29._unit-static-init-dependencies%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unit-static-init-dependencies</span></span><br/></a><a href="Transformer_Helpers.html#%28def._%28%28lib._racket%2Funit-exptime..rkt%29._unit-static-signatures%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unit-static-signatures</span></span><br/></a><a href="unitcontracts.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unit/c</span></span><br/></a><a href="Structural_Matching.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%2Fnew-import-export%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unit/new-import-export</span></span><br/></a><a href="Structural_Matching.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%2Fs%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unit/s</span></span><br/></a><a href="Unit_Utilities.html#%28def._%28%28lib._racket%2Funit..rkt%29._unit~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unit?</span></span><br/></a><a href="mzlib_unit.html" class="indexlink" data-pltdoc="x">Units<br/></a><a href="mzlib_unit.html#%28tech._unit%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">Units</span><br/></a><a href="Manipulating_Paths.html#%28idx._%28gentag._288._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">unix</span><br/></a><a href="runtime.html#%28idx._%28gentag._415._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">unix</span><br/></a><a href="unixpaths.html" class="indexlink" data-pltdoc="x">Unix and Mac OS Paths<br/></a><a href="unixpaths.html#%28part._unixpathrep%29" class="indexlink" data-pltdoc="x">Unix Path Representation<br/></a><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._unless%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unless</span></span><br/></a><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unquote</span></span><br/></a><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unquote-splicing</span></span><br/></a><a href="exns.html#%28tech._unquoted._printing._string%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">unquoted-printing string</span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._unquoted-printing-string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unquoted-printing-string</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._unquoted-printing-string-value%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unquoted-printing-string-value</span></span><br/></a><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._unquoted-printing-string~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unquoted-printing-string?</span></span><br/></a><a href="unreachable.html" class="indexlink" data-pltdoc="x">Unreachable Expressions<br/></a><a href="symbols.html#%28tech._unreadable._symbol%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">unreadable symbol</span><br/></a><a href="unsafe.html#%28tech._unsafe%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">unsafe</span><br/></a><a href="unsafe.html#%28part._unsafeassert%29" class="indexlink" data-pltdoc="x">Unsafe Assertions<br/></a><a href="unsafe.html#%28part._.Unsafe_.Character_.Operations%29" class="indexlink" data-pltdoc="x">Unsafe Character Operations<br/></a><a href="unsafe.html#%28part._.Unsafe._.Data._.Extraction%29" class="indexlink" data-pltdoc="x">Unsafe Compound-Data Operations<br/></a><a href="unsafe.html#%28part._unsafeextfl%29" class="indexlink" data-pltdoc="x">Unsafe Extflonum Operations<br/></a><a href="unsafe.html#%28part._.Unsafe_.Impersonators_and_.Chaperones%29" class="indexlink" data-pltdoc="x">Unsafe Impersonators and Chaperones<br/></a><a href="linklets.html#%28tech._unsafe._mode%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">unsafe mode</span><br/></a><a href="unsafe.html#%28part._.Unsafe_.Numeric_.Operations%29" class="indexlink" data-pltdoc="x">Unsafe Numeric Operations<br/></a><a href="unsafe.html" class="indexlink" data-pltdoc="x">Unsafe Operations<br/></a><a href="unsafe.html#%28part._unsafe-undefined%29" class="indexlink" data-pltdoc="x">Unsafe Undefined<br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-assert-unreachable%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-assert-unreachable</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-box%2A-cas%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-box*-cas!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-bytes-~3eimmutable-bytes%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-bytes-&gt;immutable-bytes!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-bytes-copy%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-bytes-copy!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-bytes-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-bytes-length</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-bytes-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-bytes-ref</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-bytes-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-bytes-set!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-car%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-car</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-cdr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-cdr</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-chaperone-procedure%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-chaperone-procedure</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-chaperone-vector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-chaperone-vector</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-char-~3einteger%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-char-&gt;integer</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-char~3c~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-char&lt;=?</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-char~3c~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-char&lt;?</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-char~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-char=?</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-char~3e~3d~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-char&gt;=?</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-char~3e~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-char&gt;?</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-cons-list%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-cons-list</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-first%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-ephemeron-hash-iterate-first</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-key%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-ephemeron-hash-iterate-key</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-key%2Bvalue%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-ephemeron-hash-iterate-key+value</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-next%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-ephemeron-hash-iterate-next</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-pair%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-ephemeron-hash-iterate-pair</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-value%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-ephemeron-hash-iterate-value</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extfl*</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl%2B%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extfl+</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl-%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extfl-</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl-~3efx%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extfl-&gt;fx</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl%2F%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extfl/</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl~3c%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extfl&lt;</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl~3c~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extfl&lt;=</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extfl=</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl~3e%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extfl&gt;</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl~3e~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extfl&gt;=</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflabs%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extflabs</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflacos%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extflacos</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflasin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extflasin</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflatan%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extflatan</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflceiling%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extflceiling</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflcos%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extflcos</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflexp%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extflexp</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflexpt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extflexpt</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflfloor%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extflfloor</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfllog%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extfllog</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflmax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extflmax</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflmin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extflmin</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflround%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extflround</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflsin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extflsin</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflsqrt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extflsqrt</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfltan%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extfltan</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfltruncate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extfltruncate</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflvector-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extflvector-length</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflvector-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extflvector-ref</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflvector-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-extflvector-set!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-f64vector-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-f64vector-ref</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-f64vector-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-f64vector-set!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fl*</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl%2B%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fl+</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl-%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fl-</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl-~3efx%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fl-&gt;fx</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl%2F%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fl/</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl~3c%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fl&lt;</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl~3c~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fl&lt;=</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fl=</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl~3e%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fl&gt;</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl~3e~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fl&gt;=</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flabs%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-flabs</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flacos%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-flacos</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flasin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-flasin</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flatan%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-flatan</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flceiling%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-flceiling</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flcos%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-flcos</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flexp%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-flexp</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flexpt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-flexpt</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flfloor%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-flfloor</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flimag-part%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-flimag-part</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fllog%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fllog</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flmax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-flmax</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flmin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-flmin</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flrandom%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-flrandom</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flreal-part%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-flreal-part</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flround%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-flround</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flsin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-flsin</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flsingle%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-flsingle</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flsqrt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-flsqrt</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fltan%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fltan</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fltruncate%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fltruncate</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flvector-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-flvector-length</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flvector-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-flvector-ref</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flvector-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-flvector-set!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fx*</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx%2A%2Fwraparound%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fx*/wraparound</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx%2B%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fx+</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx%2B%2Fwraparound%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fx+/wraparound</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx-%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fx-</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx-%2Fwraparound%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fx-/wraparound</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx-~3eextfl%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fx-&gt;extfl</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx-~3efl%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fx-&gt;fl</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx~3c%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fx&lt;</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx~3c~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fx&lt;=</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fx=</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx~3e%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fx&gt;</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx~3e~3d%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fx&gt;=</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxabs%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fxabs</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxand%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fxand</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxior%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fxior</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxlshift%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fxlshift</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxlshift%2Fwraparound%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fxlshift/wraparound</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxmax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fxmax</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxmin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fxmin</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxmodulo%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fxmodulo</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxnot%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fxnot</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxpopcount%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fxpopcount</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxpopcount16%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fxpopcount16</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxpopcount32%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fxpopcount32</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxquotient%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fxquotient</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxremainder%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fxremainder</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxrshift%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fxrshift</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxvector-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fxvector-length</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxvector-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fxvector-ref</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxvector-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fxvector-set!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxxor%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-fxxor</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-first%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-immutable-hash-iterate-first</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-key%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-immutable-hash-iterate-key</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-key%2Bvalue%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-immutable-hash-iterate-key+value</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-next%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-immutable-hash-iterate-next</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-pair%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-immutable-hash-iterate-pair</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-value%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-immutable-hash-iterate-value</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-impersonate-procedure%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-impersonate-procedure</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-impersonate-vector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-impersonate-vector</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-list-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-list-ref</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-list-tail%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-list-tail</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-make-flrectangular%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-make-flrectangular</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-make-srcloc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-make-srcloc</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mcar%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-mcar</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mcdr%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-mcdr</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-first%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-mutable-hash-iterate-first</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-key%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-mutable-hash-iterate-key</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-key%2Bvalue%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-mutable-hash-iterate-key+value</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-next%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-mutable-hash-iterate-next</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-pair%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-mutable-hash-iterate-pair</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-value%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-mutable-hash-iterate-value</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-s16vector-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-s16vector-ref</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-s16vector-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-s16vector-set!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-box%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-set-box!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-box%2A%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-set-box*!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-immutable-car%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-set-immutable-car!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-immutable-cdr%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-set-immutable-cdr!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-mcar%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-set-mcar!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-mcdr%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-set-mcdr!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-stencil-vector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-stencil-vector</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-stencil-vector-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-stencil-vector-length</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-stencil-vector-mask%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-stencil-vector-mask</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-stencil-vector-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-stencil-vector-ref</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-stencil-vector-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-stencil-vector-set!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-stencil-vector-update%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-stencil-vector-update</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-string-~3eimmutable-string%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-string-&gt;immutable-string!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-string-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-string-length</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-string-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-string-ref</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-string-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-string-set!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-struct%2A-cas%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-struct*-cas!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-struct%2A-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-struct*-ref</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-struct%2A-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-struct*-set!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-struct-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-struct-ref</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-struct-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-struct-set!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-u16vector-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-u16vector-ref</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-u16vector-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-u16vector-set!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-unbox%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-unbox</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-unbox%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-unbox*</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._unsafe-undefined%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-undefined</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector%2A-~3eimmutable-vector%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-vector*-&gt;immutable-vector!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector%2A-cas%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-vector*-cas!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector%2A-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-vector*-length</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector%2A-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-vector*-ref</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector%2A-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-vector*-set!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-vector-length</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-vector-ref</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-vector-set!</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-first%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-weak-hash-iterate-first</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-key%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-weak-hash-iterate-key</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-key%2Bvalue%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-weak-hash-iterate-key+value</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-next%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-weak-hash-iterate-next</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-pair%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-weak-hash-iterate-pair</span></span><br/></a><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-value%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-weak-hash-iterate-value</span></span><br/></a><a href="function-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._unsupplied-arg~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsupplied-arg?</span></span><br/></a><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._unsyntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unsyntax</span></span><br/></a><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._unsyntax-splicing%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unsyntax-splicing</span></span><br/></a><a href="debugging.html#%28form._%28%28lib._racket%2Ftrace..rkt%29._untrace%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">untrace</span></span><br/></a><a href="Manipulating_Paths.html#%28idx._%28gentag._290._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">up</span><br/></a><a href="file-ports.html#%28idx._%28gentag._258._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">update</span><br/></a><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._use-collection-link-paths%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">use-collection-link-paths</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._use-compiled-file-check%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">use-compiled-file-check</span></span><br/></a><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._use-compiled-file-paths%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">use-compiled-file-paths</span></span><br/></a><a href="syntax-model.html#%28tech._use._site._scope%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">use-site scope</span><br/></a><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._use-user-specific-search-paths%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">use-user-specific-search-paths</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._320._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">USER</span><br/></a><a href="Filesystem.html#%28tech._user%27s._home._directory%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">user&rsquo;s home
+directory</span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._user-execute-bit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">user-execute-bit</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._364._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">user-id</span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._user-permission-bits%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">user-permission-bits</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._user-read-bit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">user-read-bit</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._378._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">user-read-bit</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._user-write-bit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">user-write-bit</span></span><br/></a><a href="Filesystem.html#%28idx._%28gentag._322._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">USERPROFILE</span><br/></a><a href="places.html#%28part._places-api%29" class="indexlink" data-pltdoc="x">Using Places<br/></a><a href="bytestrings.html#%28idx._%28gentag._142._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">UTF-8-permissive<br/></a><a href="Building_New_Contract_Combinators.html#%28part._.Utilities_for_.Building_.New_.Combinators%29" class="indexlink" data-pltdoc="x">Utilities for Building New Combinators<br/></a><a name="alpha:V"></a><span><a href="hashtables.html#%28tech._valid._hash._index%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">valid hash index</span><br/></a></span><a href="eval-model.html#%28tech._value%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">value</span><br/></a><a href="pretty-print.html#%28part._.Value_.Output_.Hook%29" class="indexlink" data-pltdoc="x">Value Output Hook<br/></a><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._value-blame%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">value-blame</span></span><br/></a><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._value-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">value-contract</span></span><br/></a><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">values</span></span><br/></a><a href="eval-model.html#%28tech._variable%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">variable</span><br/></a><a href="Locations____variable-reference.html#%28tech._variable._reference%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">variable reference</span><br/></a><a href="__top.html" class="indexlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3eempty-namespace%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-reference-&gt;empty-namespace</span></span><br/></a><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._variable-reference-~3einstance%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-reference-&gt;instance</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3emodule-base-phase%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-reference-&gt;module-base-phase</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3emodule-declaration-inspector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-reference-&gt;module-declaration-inspector</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3emodule-path-index%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-reference-&gt;module-path-index</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3emodule-source%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-reference-&gt;module-source</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3enamespace%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-reference-&gt;namespace</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3ephase%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-reference-&gt;phase</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-~3eresolved-module-path%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-reference-&gt;resolved-module-path</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-constant~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-reference-constant?</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-from-unsafe~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-reference-from-unsafe?</span></span><br/></a><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-reference?</span></span><br/></a><a href="eval-model.html#%28part._vars-and-locs%29" class="indexlink" data-pltdoc="x">Variables and Locations<br/></a><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector</span></span><br/></a><a href="match.html#%28idx._%28gentag._207._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x">vector<br/></a><a href="vectors.html#%28tech._vector%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">vector</span><br/></a><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%2A-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector*-length</span></span><br/></a><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%2A-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector*-ref</span></span><br/></a><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%2A-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector*-set!</span></span><br/></a><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-~3eimmutable-vector%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-&gt;immutable-vector</span></span><br/></a><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-~3elist%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-&gt;list</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._vector-~3epseudo-random-generator%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-&gt;pseudo-random-generator</span></span><br/></a><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._vector-~3epseudo-random-generator%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-&gt;pseudo-random-generator!</span></span><br/></a><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-~3evalues%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-&gt;values</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-append%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-append</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-argmax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-argmax</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-argmin%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-argmin</span></span><br/></a><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-cas%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-cas!</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-copy%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-copy</span></span><br/></a><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-copy%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-copy!</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-count%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-count</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-drop%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-drop</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-drop-right%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-drop-right</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-empty~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-empty?</span></span><br/></a><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-fill%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-fill!</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-filter%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-filter</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-filter-not%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-filter-not</span></span><br/></a><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-immutable%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-immutable</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector-immutable%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-immutable/c</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector-immutableof%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-immutableof</span></span><br/></a><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-length</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-map%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-map</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-map%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-map!</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-member%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-member</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-memq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-memq</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-memv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-memv</span></span><br/></a><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-ref</span></span><br/></a><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-set!</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-set%2A%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-set*!</span></span><br/></a><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._vector-set-performance-stats%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-set-performance-stats!</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-sort%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-sort</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-sort%21%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-sort!</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-split-at%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-split-at</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-split-at-right%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-split-at-right</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-take%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-take</span></span><br/></a><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-take-right%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-take-right</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector%2Fc%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector/c</span></span><br/></a><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector?</span></span><br/></a><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vectorof%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vectorof</span></span><br/></a><a href="vectors.html" class="indexlink" data-pltdoc="x">Vectors<br/></a><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._version%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">version</span></span><br/></a><a href="syntax-model.html#%28tech._visit%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">visits</span><br/></a><a href="runtime.html#%28idx._%28gentag._421._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">vm</span><br/></a><a href="void.html" class="indexlink" data-pltdoc="x">Void<br/></a><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">void</span></span><br/></a><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">void?</span></span><br/></a><a name="alpha:W"></a><span><a href="weakbox.html#%28tech._weak._box%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">weak box</span><br/></a></span><a href="weakbox.html" class="indexlink" data-pltdoc="x">Weak Boxes<br/></a><a href="eval-model.html#%28tech._weak._reference%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">weak references</span><br/></a><a href="weakbox.html#%28def._%28%28quote._~23~25kernel%29._weak-box-value%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">weak-box-value</span></span><br/></a><a href="weakbox.html#%28def._%28%28quote._~23~25kernel%29._weak-box~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">weak-box?</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._weak-set%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">weak-set</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._weak-setalw%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">weak-setalw</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._weak-seteq%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">weak-seteq</span></span><br/></a><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._weak-seteqv%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">weak-seteqv</span></span><br/></a><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">when</span></span><br/></a><a href="willexecutor.html#%28tech._will%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">will</span><br/></a><a href="willexecutor.html#%28tech._will._executor%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">will executor</span><br/></a><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-execute%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">will-execute</span></span><br/></a><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-executor~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">will-executor?</span></span><br/></a><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-register%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">will-register</span></span><br/></a><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-try-execute%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">will-try-execute</span></span><br/></a><a href="willexecutor.html" class="indexlink" data-pltdoc="x">Wills and Executors<br/></a><a href="Manipulating_Paths.html#%28idx._%28gentag._289._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">windows</span><br/></a><a href="runtime.html#%28idx._%28gentag._416._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">windows</span><br/></a><a href="windowspaths.html#%28part._windowspathrep%29" class="indexlink" data-pltdoc="x">Windows Path Representation<br/></a><a href="windowspaths.html" class="indexlink" data-pltdoc="x">Windows Paths<br/></a><a href="unreachable.html#%28form._%28%28lib._racket%2Funreachable..rkt%29._with-assert-unreachable%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-assert-unreachable</span></span><br/></a><a href="collapsible.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._with-collapsible-contract-continuation-mark%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-collapsible-contract-continuation-mark</span></span><br/></a><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-continuation-mark</span></span><br/></a><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._with-contract%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-contract</span></span><br/></a><a href="Building_New_Contract_Combinators.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._with-contract-continuation-mark%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-contract-continuation-mark</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28form._%28%28lib._racket%2Fsandbox..rkt%29._with-deep-time-limit%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-deep-time-limit</span></span><br/></a><a href="syntax-util.html#%28form._%28%28lib._racket%2Fsyntax..rkt%29._with-disappeared-uses%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-disappeared-uses</span></span><br/></a><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-handlers</span></span><br/></a><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-handlers*</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._with-input-from-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">with-input-from-bytes</span></span><br/></a><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._with-input-from-file%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">with-input-from-file</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._with-input-from-string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">with-input-from-string</span></span><br/></a><a href="logging.html#%28def._%28%28lib._racket%2Flogging..rkt%29._with-intercepted-logging%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">with-intercepted-logging</span></span><br/></a><a href="Sandboxed_Evaluation.html#%28form._%28%28lib._racket%2Fsandbox..rkt%29._with-limits%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-limits</span></span><br/></a><a href="logging.html#%28def._%28%28lib._racket%2Flogging..rkt%29._with-logging-to-port%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">with-logging-to-port</span></span><br/></a><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._with-method%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-method</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._with-output-to-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">with-output-to-bytes</span></span><br/></a><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._with-output-to-file%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">with-output-to-file</span></span><br/></a><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._with-output-to-string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">with-output-to-string</span></span><br/></a><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._with-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-syntax</span></span><br/></a><a href="syntax-util.html#%28form._%28%28lib._racket%2Fsyntax..rkt%29._with-syntax%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-syntax*</span></span><br/></a><a href="runtime.html#%28idx._%28gentag._420._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">word</span><br/></a><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._would-be-future%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">would-be-future</span></span><br/></a><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._wrap-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">wrap-evt</span></span><br/></a><a href="objectprinting.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._writable~3c~25~3e%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">writable&lt;%&gt;</span></span><br/></a><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write</span></span><br/></a><a href="securityguards.html#%28idx._%28gentag._281._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">write</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._357._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">write</span><br/></a><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-byte%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-byte</span></span><br/></a><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-bytes</span></span><br/></a><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-bytes-avail</span></span><br/></a><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-bytes-avail*</span></span><br/></a><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-bytes-avail-evt</span></span><br/></a><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%2Fenable-break%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-bytes-avail/enable-break</span></span><br/></a><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-char%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-char</span></span><br/></a><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-special%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-special</span></span><br/></a><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-special-avail%2A%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-special-avail*</span></span><br/></a><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-special-evt%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-special-evt</span></span><br/></a><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-string%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-string</span></span><br/></a><a href="Filesystem.html#%28def._%28%28lib._racket%2Ffile..rkt%29._write-to-file%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">write-to-file</span></span><br/></a><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._writeln%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">writeln</span></span><br/></a><a href="Writing.html" class="indexlink" data-pltdoc="x">Writing<br/></a><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._wrong-syntax%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">wrong-syntax</span></span><br/></a><a name="alpha:X"></a><span><a href="Filesystem.html#%28idx._%28gentag._344._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">XDG_CACHE_HOME</span><br/></a></span><a href="Filesystem.html#%28idx._%28gentag._326._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">XDG_CONFIG_HOME</span><br/></a><a href="Filesystem.html#%28idx._%28gentag._342._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">XDG_DATA_HOME</span><br/></a><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._xor%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">xor</span></span><br/></a><a name="alpha:Y"></a><span><a href="Generators.html#%28def._%28%28lib._racket%2Fgenerator..rkt%29._yield%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">yield</span></span><br/></a></span><a name="alpha:Z"></a><span><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">zero?</span></span><br/></a></span><a href="characters.html#%28idx._%28gentag._175._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">zl</span><br/></a><a href="characters.html#%28idx._%28gentag._174._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">zp</span><br/></a><a href="characters.html#%28idx._%28gentag._173._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktVal">'</span><span class="RktVal">zs</span><br/></a><a href="reader.html#%28idx._%28gentag._25._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._3._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span><br/></a><a href="reader.html#%28idx._%28gentag._28._%28lib._scribblings%2Freference%2Freference..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span><br/></a><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7e..a%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">~.a</span></span><br/></a><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7e..s%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">~.s</span></span><br/></a><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7e..v%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">~.v</span></span><br/></a><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~3f%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">~?</span></span><br/></a><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~40%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">~@</span></span><br/></a><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">~a</span></span><br/></a><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ee%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">~e</span></span><br/></a><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">~r</span></span><br/></a><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7es%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">~s</span></span><br/></a><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ev%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">~v</span></span><br/></a><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">&#955;</span></span><br/></a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="doc-bibliography.html" title="backward to &quot;Bibliography&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<span class="nonavigation">next &rarr;</span></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/encodings.html b/clones/docs.racket-lang.org/reference/encodings.html
new file mode 100644
index 00000000..67193363
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/encodings.html
@@ -0,0 +1,72 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.1.1&nbsp;Encodings and Locales</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewselflink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1.1&nbsp;</td><td><a href="encodings.html" class="tocviewselflink" data-pltdoc="x">Encodings and Locales</a></td></tr><tr><td align="right">13.1.2&nbsp;</td><td><a href="port-ops.html" class="tocviewlink" data-pltdoc="x">Managing Ports</a></td></tr><tr><td align="right">13.1.3&nbsp;</td><td><a href="port-buffers.html" class="tocviewlink" data-pltdoc="x">Port Buffers and Positions</a></td></tr><tr><td align="right">13.1.4&nbsp;</td><td><a href="linecol.html" class="tocviewlink" data-pltdoc="x">Counting Positions, Lines, and Columns</a></td></tr><tr><td align="right">13.1.5&nbsp;</td><td><a href="file-ports.html" class="tocviewlink" data-pltdoc="x">File Ports</a></td></tr><tr><td align="right">13.1.6&nbsp;</td><td><a href="stringport.html" class="tocviewlink" data-pltdoc="x">String Ports</a></td></tr><tr><td align="right">13.1.7&nbsp;</td><td><a href="pipeports.html" class="tocviewlink" data-pltdoc="x">Pipes</a></td></tr><tr><td align="right">13.1.8&nbsp;</td><td><a href="portstructs.html" class="tocviewlink" data-pltdoc="x">Structures as Ports</a></td></tr><tr><td align="right">13.1.9&nbsp;</td><td><a href="customport.html" class="tocviewlink" data-pltdoc="x">Custom Ports</a></td></tr><tr><td align="right">13.1.10&nbsp;</td><td><a href="port-lib.html" class="tocviewlink" data-pltdoc="x">More Port Constructors, Procedures, and Events</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="encodings.html#%28def._%28%28quote._~23~25kernel%29._current-locale%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>locale</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="ports.html" title="backward to &quot;13.1 Ports&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ports.html" title="up to &quot;13.1 Ports&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="port-ops.html" title="forward to &quot;13.1.2 Managing Ports&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;encodings&quot;">13.1.1<tt>&nbsp;</tt><a name="(part._encodings)"></a>Encodings and Locales</h5><p>When a port is provided to a character-based operation, such as
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char%29%29" class="RktValLink" data-pltdoc="x">read-char</a></span> or <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>, the port&rsquo;s bytes are read and
+interpreted as a UTF-8 encoding of characters. Thus, reading a single
+character may require reading multiple bytes, and a procedure like
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._char-ready~3f%29%29" class="RktValLink" data-pltdoc="x">char-ready?</a></span> may need to peek several bytes into the stream to
+determine whether a character is available. In the case of a byte
+stream that does not correspond to a valid UTF-8 encoding, functions
+such as <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char%29%29" class="RktValLink" data-pltdoc="x">read-char</a></span> may need to peek one byte ahead in the
+stream to discover that the stream is not a valid encoding.</p><p>When an input port produces a sequence of bytes that is not a valid
+UTF-8 encoding in a character-reading context, then bytes that
+constitute an invalid sequence are converted to the character
+<span class="RktVal">#\uFFFD</span>. Specifically, bytes 255 and 254 are always converted
+to <span class="RktVal">#\uFFFD</span>, bytes in the range 192 to 253 produce
+<span class="RktVal">#\uFFFD</span> when they are not followed by bytes that form a valid
+UTF-8 encoding, and bytes in the range 128 to 191 are converted to
+<span class="RktVal">#\uFFFD</span> when they are not part of a valid encoding that was
+started by a preceding byte in the range 192 to 253. To put it another
+way, when reading a sequence of bytes as characters, a minimal set of
+bytes are changed to the encoding of <span class="RktVal">#\uFFFD</span> so that the
+entire sequence of bytes is a valid UTF-8 encoding.</p><p>See <a href="bytestrings.html" data-pltdoc="x">Byte Strings</a> for procedures that facilitate
+conversions using UTF-8 or other encodings. See also
+<span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._reencode-input-port%29%29" class="RktValLink" data-pltdoc="x">reencode-input-port</a></span> and <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._reencode-output-port%29%29" class="RktValLink" data-pltdoc="x">reencode-output-port</a></span> for
+obtaining a UTF-8-based port from one that uses a different encoding
+of characters.</p><p>A <a name="(tech._locale)"></a><span style="font-style: italic">locale</span> captures information about a user&rsquo;s
+language-specific interpretation of character sequences. In particular,
+a locale determines how strings are &ldquo;alphabetized,&rdquo; how a lowercase
+character is converted to an uppercase character, and how strings are
+compared without regard to case. String operations such as
+<span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string-ci=?</a></span> are <span style="font-style: italic">not</span> sensitive to the current locale,
+but operations such as <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale-ci~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string-locale-ci=?</a></span> (see
+<a href="strings.html" data-pltdoc="x">Strings</a>) produce results consistent with the current
+locale.</p><p>A locale also designates a particular encoding of code-point sequences
+into byte sequences. Racket generally ignores this aspect of the
+locale, with a few notable exceptions: command-line arguments passed
+to Racket as byte strings are converted to character strings using the
+locale&rsquo;s encoding; command-line strings passed as byte strings to
+other processes (through <span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess%29%29" class="RktValLink" data-pltdoc="x">subprocess</a></span>) are converted to byte
+strings using the locale&rsquo;s encoding; environment variables are
+converted to and from strings using the locale&rsquo;s encoding; filesystem
+paths are converted to and from strings (for display purposes) using
+the locale&rsquo;s encoding; and, finally, Racket provides functions such as
+<span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Flocale%29%29" class="RktValLink" data-pltdoc="x">string-&gt;bytes/locale</a></span> to specifically invoke a locale-specific
+encoding.</p><p>A Unix user selects a locale by setting environment variables, such as
+<span class="stt">LC_ALL</span>. On Windows and Mac OS, the operating system
+provides other mechanisms for setting the locale. Within Racket, the
+current locale can be changed by setting the <span class="RktSym"><a href="encodings.html#%28def._%28%28quote._~23~25kernel%29._current-locale%29%29" class="RktValLink" data-pltdoc="x">current-locale</a></span>
+parameter. The locale name within Racket is a string, and the
+available locale names depend on the platform and its configuration,
+but the <span class="RktVal">""</span> locale means the current user&rsquo;s default locale;
+on Windows and Mac OS, the encoding for <span class="RktVal">""</span> is always
+UTF-8, and locale-sensitive operations use the operating system&rsquo;s
+native interface. (In particular, setting the <span class="stt">LC_ALL</span> and
+<span class="stt">LC_CTYPE</span> environment variables does not affect the locale
+<span class="RktVal">""</span> on Mac OS. Use <span class="RktSym"><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._getenv%29%29" class="RktValLink" data-pltdoc="x">getenv</a></span> and
+<span class="RktSym"><a href="encodings.html#%28def._%28%28quote._~23~25kernel%29._current-locale%29%29" class="RktValLink" data-pltdoc="x">current-locale</a></span> to explicitly install the
+environment-specified locale, if desired.) Setting the current locale
+to <span class="RktVal">#f</span> makes locale-sensitive operations locale-insensitive,
+which means using the Unicode mapping for case operations and using
+UTF-8 for encoding.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-locale))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="encodings.html#%28def._%28%28quote._~23~25kernel%29._current-locale%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-locale</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="encodings.html#%28def._%28%28quote._~23~25kernel%29._current-locale%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-locale</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">locale</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">locale</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the current <a href="encodings.html#%28tech._locale%29" class="techoutside" data-pltdoc="x"><span class="techinside">locale</span></a> for
+procedures such as <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale-ci~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string-locale-ci=?</a></span>.</div></p><p>When locale sensitivity is disabled by setting the parameter to
+<span class="RktVal">#f</span>, strings are compared, etc., in a fully portable manner,
+which is the same as the standard procedures. Otherwise, strings are
+interpreted according to a locale setting (in the sense of the C
+library&rsquo;s <span class="stt">setlocale</span>). The <span class="RktVal">""</span> locale is always an alias
+for the current machine&rsquo;s default locale, and it is the default.  The
+<span class="RktVal">"C"</span> locale is also always available; setting the locale to
+<span class="RktVal">"C"</span> is the same as disabling locale sensitivity with
+<span class="RktVal">#f</span> only when string operations are restricted to the first
+128 characters. Other locale names are platform-specific.</p><p>String or character printing with <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> is not affected by
+the parameter, and neither are symbol case or regular expressions (see
+<a href="regexp.html" data-pltdoc="x">Regular Expressions</a>).</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="ports.html" title="backward to &quot;13.1 Ports&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ports.html" title="up to &quot;13.1 Ports&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="port-ops.html" title="forward to &quot;13.1.2 Managing Ports&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/engine.html b/clones/docs.racket-lang.org/reference/engine.html
new file mode 100644
index 00000000..0e9b4175
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/engine.html
@@ -0,0 +1,39 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>11.6&nbsp;Engines</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewselflink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.1&nbsp;</td><td><a href="threads.html" class="tocviewlink" data-pltdoc="x">Threads</a></td></tr><tr><td align="right">11.2&nbsp;</td><td><a href="all-sync.html" class="tocviewlink" data-pltdoc="x">Synchronization</a></td></tr><tr><td align="right">11.3&nbsp;</td><td><a href="thread-local-storage.html" class="tocviewlink" data-pltdoc="x">Thread-<wbr></wbr>Local Storage</a></td></tr><tr><td align="right">11.4&nbsp;</td><td><a href="futures.html" class="tocviewlink" data-pltdoc="x">Futures</a></td></tr><tr><td align="right">11.5&nbsp;</td><td><a href="places.html" class="tocviewlink" data-pltdoc="x">Places</a></td></tr><tr><td align="right">11.6&nbsp;</td><td><a href="engine.html" class="tocviewselflink" data-pltdoc="x">Engines</a></td></tr><tr><td align="right">11.7&nbsp;</td><td><a href="memory-order.html" class="tocviewlink" data-pltdoc="x">Machine Memory Order</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">engine</span></span></a></td></tr><tr><td><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">engine?</span></span></a></td></tr><tr><td><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine-run%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">engine-<wbr></wbr>run</span></span></a></td></tr><tr><td><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine-result%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">engine-<wbr></wbr>result</span></span></a></td></tr><tr><td><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine-kill%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">engine-<wbr></wbr>kill</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="places.html" title="backward to &quot;11.5 Places&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="concurrency.html" title="up to &quot;11 Concurrency and Parallelism&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="memory-order.html" title="forward to &quot;11.7 Machine Memory Order&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;engine&quot;">11.6<tt>&nbsp;</tt><a name="(part._engine)"></a><a name="(mod-path._racket/engine)"></a>Engines</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="engine.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/engine</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="engine.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/engine</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p>An <a name="(tech._engine)"></a><span style="font-style: italic">engine</span> is an abstraction that models processes that
+can be preempted by a timer or other external trigger. They are
+inspired by the work of Haynes and Friedman [<a href="doc-bibliography.html#%28cite._.Haynes84%29" data-pltdoc="x">Haynes84</a>].</p><p><div class="SIntrapara">Engines log their behavior via a logger with the name
+<span class="RktVal">'</span><span class="RktVal">racket/engine</span>. The logger is created when the module
+is instantiated and uses the result of <span class="RktPn">(</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._current-logger%29%29" class="RktValLink" data-pltdoc="x">current-logger</a></span><span class="RktPn">)</span>
+as its parent. The library adds logs a <span class="RktVal">'</span><span class="RktVal">debug</span> level
+message: when <span class="RktSym"><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine-run%29%29" class="RktValLink" data-pltdoc="x">engine-run</a></span>
+is called, when the engine timeout expires, and when the engine is
+stopped (either because it terminated or it reached a safe point to
+stop). Each log message holds a value of the struct:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">engine-info</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">msec</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:prefab</span><span class="RktPn">)</span></p></blockquote></div><div class="SIntrapara">where the <span class="RktVar">msec</span> field holds the result of
+<span class="RktPn">(</span><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-inexact-milliseconds%29%29" class="RktValLink" data-pltdoc="x">current-inexact-milliseconds</a></span><span class="RktPn">)</span> at the moment of logging,
+and the <span class="RktVar">name</span> field holds the name of the procedure
+passed to <span class="RktSym"><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine%29%29" class="RktValLink" data-pltdoc="x">engine</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/engine..rkt)._engine))"></a><span title="Provided from: racket/engine | Package: base"><span class="RktSym"><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine%29%29" class="RktValDef RktValLink" data-pltdoc="x">engine</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine~3f%29%29" class="RktValLink" data-pltdoc="x">engine?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an engine object to encapsulate a thread that runs only when
+allowed. The <span class="RktVar">proc</span> procedure should accept one argument, and
+<span class="RktVar">proc</span> is run in the engine thread when
+<span class="RktSym"><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine-run%29%29" class="RktValLink" data-pltdoc="x">engine-run</a></span> is called. If <span class="RktSym"><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine-run%29%29" class="RktValLink" data-pltdoc="x">engine-run</a></span> returns
+due to a timeout, then the engine thread is suspended until a
+future call to <span class="RktSym"><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine-run%29%29" class="RktValLink" data-pltdoc="x">engine-run</a></span>. Thus, <span class="RktVar">proc</span> only
+executes during the dynamic extent of a <span class="RktSym"><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine-run%29%29" class="RktValLink" data-pltdoc="x">engine-run</a></span> call.</div></p><p>The argument to <span class="RktVar">proc</span> is a procedure that takes a boolean, and
+it can be used to disable suspends (in case <span class="RktVar">proc</span> has critical
+regions where it should not be suspended). A true value passed to the
+procedure enables suspends, and <span class="RktVal">#f</span> disables
+suspends. Initially, suspends are allowed.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/engine..rkt)._engine~3f))"></a><span title="Provided from: racket/engine | Package: base"><span class="RktSym"><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">engine?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is an engine produced by
+<span class="RktSym"><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine%29%29" class="RktValLink" data-pltdoc="x">engine</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/engine..rkt)._engine-run))"></a><span title="Provided from: racket/engine | Package: base"><span class="RktSym"><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine-run%29%29" class="RktValDef RktValLink" data-pltdoc="x">engine-run</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">until</span><span class="hspace">&nbsp;</span><span class="RktVar">engine</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">until</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">engine</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine~3f%29%29" class="RktValLink" data-pltdoc="x">engine?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Allows the thread associated with <span class="RktVar">engine</span> to execute for up
+as long as <span class="RktVar">until</span> milliseconds (if <span class="RktVar">until</span> is a real
+number) or <span class="RktVar">until</span> is ready (if <span class="RktVar">until</span> is an event). If
+<span class="RktVar">engine</span>&rsquo;s procedure disables suspends, then the engine
+can run arbitrarily long until it re-enables suspends.</div></p><p>The <span class="RktSym"><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine-run%29%29" class="RktValLink" data-pltdoc="x">engine-run</a></span> procedure returns <span class="RktVal">#t</span> if
+<span class="RktVar">engine</span>&rsquo;s procedure completes (or if it completed earlier),
+and the result is available via <span class="RktSym"><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine-result%29%29" class="RktValLink" data-pltdoc="x">engine-result</a></span>.  The
+<span class="RktSym"><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine-run%29%29" class="RktValLink" data-pltdoc="x">engine-run</a></span> procedure returns <span class="RktVal">#f</span> if
+<span class="RktVar">engine</span>&rsquo;s procedure does not complete before it is
+suspended after the <span class="RktVar">until</span> condition is met. If <span class="RktVar">engine</span>&rsquo;s
+procedure raises an exception, then it is re-raised by
+<span class="RktSym"><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine-run%29%29" class="RktValLink" data-pltdoc="x">engine-run</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/engine..rkt)._engine-result))"></a><span title="Provided from: racket/engine | Package: base"><span class="RktSym"><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine-result%29%29" class="RktValDef RktValLink" data-pltdoc="x">engine-result</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">engine</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">engine</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine~3f%29%29" class="RktValLink" data-pltdoc="x">engine?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the result for <span class="RktVar">engine</span> if it has completed with a
+value (as opposed to an exception), <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/engine..rkt)._engine-kill))"></a><span title="Provided from: racket/engine | Package: base"><span class="RktSym"><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine-kill%29%29" class="RktValDef RktValLink" data-pltdoc="x">engine-kill</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">engine</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">engine</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="engine.html#%28def._%28%28lib._racket%2Fengine..rkt%29._engine~3f%29%29" class="RktValLink" data-pltdoc="x">engine?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Forcibly terminates the thread associated with <span class="RktVar">engine</span> if
+it is still running, leaving the engine result unchanged.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="places.html" title="backward to &quot;11.5 Places&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="concurrency.html" title="up to &quot;11 Concurrency and Parallelism&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="memory-order.html" title="forward to &quot;11.7 Machine Memory Order&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/envvars.html b/clones/docs.racket-lang.org/reference/envvars.html
new file mode 100644
index 00000000..bf1af773
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/envvars.html
@@ -0,0 +1,48 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15.7&nbsp;Environment Variables</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewselflink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewlink" data-pltdoc="x">Paths</a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="Filesystem.html" class="tocviewlink" data-pltdoc="x">Filesystem</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="networking.html" class="tocviewlink" data-pltdoc="x">Networking</a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="subprocess.html" class="tocviewlink" data-pltdoc="x">Processes</a></td></tr><tr><td align="right">15.5&nbsp;</td><td><a href="logging.html" class="tocviewlink" data-pltdoc="x">Logging</a></td></tr><tr><td align="right">15.6&nbsp;</td><td><a href="time.html" class="tocviewlink" data-pltdoc="x">Time</a></td></tr><tr><td align="right">15.7&nbsp;</td><td><a href="envvars.html" class="tocviewselflink" data-pltdoc="x">Environment Variables</a></td></tr><tr><td align="right">15.8&nbsp;</td><td><a href="runtime.html" class="tocviewlink" data-pltdoc="x">Environment and Runtime Information</a></td></tr><tr><td align="right">15.9&nbsp;</td><td><a href="Command-Line_Parsing.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Parsing</a></td></tr><tr><td align="right">15.10&nbsp;</td><td><a href="os-lib.html" class="tocviewlink" data-pltdoc="x">Additional Operating System Functions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">environment-<wbr></wbr>variables?</span></span></a></td></tr><tr><td><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._current-environment-variables%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>environment-<wbr></wbr>variables</span></span></a></td></tr><tr><td><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._bytes-environment-variable-name~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>environment-<wbr></wbr>variable-<wbr></wbr>name?</span></span></a></td></tr><tr><td><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._make-environment-variables%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>environment-<wbr></wbr>variables</span></span></a></td></tr><tr><td><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables-ref%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">environment-<wbr></wbr>variables-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables-set%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">environment-<wbr></wbr>variables-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables-names%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">environment-<wbr></wbr>variables-<wbr></wbr>names</span></span></a></td></tr><tr><td><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables-copy%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">environment-<wbr></wbr>variables-<wbr></wbr>copy</span></span></a></td></tr><tr><td><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._getenv%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">getenv</span></span></a></td></tr><tr><td><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._putenv%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">putenv</span></span></a></td></tr><tr><td><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._string-environment-variable-name~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>environment-<wbr></wbr>variable-<wbr></wbr>name?</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="time.html" title="backward to &quot;15.6 Time&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="os.html" title="up to &quot;15 Operating System&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="runtime.html" title="forward to &quot;15.8 Environment and Runtime Information&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;envvars&quot;">15.7<tt>&nbsp;</tt><a name="(part._envvars)"></a>Environment Variables</h4><p>An <a name="(tech._environment._variable._set)"></a><span style="font-style: italic">environment variable set</span> encapsulates a partial mapping
+from byte strings to byte strings. A Racket process&rsquo;s initial
+<a href="envvars.html#%28tech._environment._variable._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">environment variable set</span></a> is connected to the operating system&rsquo;s
+environment variables: accesses or changes to the set read or change
+operating-system environment variables for the Racket process.</p><p>Since Windows environment variables are case-insensitive,
+<a href="envvars.html#%28tech._environment._variable._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">environment variable set</span></a>&rsquo;s key byte strings on Windows are
+case-folded. More precisely, key byte strings are coerced to a UTF-8
+encoding of characters that are converted to lowercase via
+<span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale-downcase%29%29" class="RktValLink" data-pltdoc="x">string-locale-downcase</a></span>.</p><p>The current <a href="envvars.html#%28tech._environment._variable._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">environment variable set</span></a>, which is determined by
+the <span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._current-environment-variables%29%29" class="RktValLink" data-pltdoc="x">current-environment-variables</a></span> parameter, is propagated to
+a <a href="subprocess.html#%28tech._subproces%29" class="techoutside" data-pltdoc="x"><span class="techinside">subprocess</span></a> when the <a href="subprocess.html#%28tech._subproces%29" class="techoutside" data-pltdoc="x"><span class="techinside">subprocess</span></a> is created.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._environment-variables~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">environment-variables?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is an <a href="envvars.html#%28tech._environment._variable._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">environment variable
+set</span></a>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-environment-variables))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._current-environment-variables%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-environment-variables</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables~3f%29%29" class="RktValLink" data-pltdoc="x">environment-variables?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._current-environment-variables%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-environment-variables</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">env</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">env</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables~3f%29%29" class="RktValLink" data-pltdoc="x">environment-variables?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the <a href="envvars.html#%28tech._environment._variable._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">environment variable set</span></a>
+that is propagated to a <a href="subprocess.html#%28tech._subproces%29" class="techoutside" data-pltdoc="x"><span class="techinside">subprocess</span></a> and that is used as the
+default set for <span class="RktSym"><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._getenv%29%29" class="RktValLink" data-pltdoc="x">getenv</a></span> and <span class="RktSym"><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._putenv%29%29" class="RktValLink" data-pltdoc="x">putenv</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._bytes-environment-variable-name~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._bytes-environment-variable-name~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-environment-variable-name?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a byte string and if it is valid
+for an environment variable name. An environment variable name must
+contain no bytes with the value <span class="RktVal">0</span> or <span class="RktVal">61</span>, where
+<span class="RktVal">61</span> is <span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-~3einteger%29%29" class="RktValLink" data-pltdoc="x">char-&gt;integer</a></span><span class="stt"> </span><span class="RktVal">#\=</span><span class="RktPn">)</span>. On Windows, an
+environment variable name also must have a non-zero length.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-environment-variables))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._make-environment-variables%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-environment-variables</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables~3f%29%29" class="RktValLink" data-pltdoc="x">environment-variables?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._bytes-environment-variable-name~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-environment-variable-name?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._bytes-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-no-nuls?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a fresh <a href="envvars.html#%28tech._environment._variable._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">environment variable set</span></a> that is initialized
+with the given <span class="RktVar">name</span> to <span class="RktVar">val</span> mappings.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._environment-variables-ref))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">environment-variables-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">env</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._bytes-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-no-nuls?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">env</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables~3f%29%29" class="RktValLink" data-pltdoc="x">environment-variables?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._bytes-environment-variable-name~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-environment-variable-name?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the mapping for <span class="RktVar">name</span> in <span class="RktVar">env</span>, returning
+<span class="RktVal">#f</span> if <span class="RktVar">name</span> has no mapping.</div></p><p>Normally, <span class="RktVar">name</span> should be a byte-string encoding of a string
+using the default encoding of the current <a href="encodings.html#%28tech._locale%29" class="techoutside" data-pltdoc="x"><span class="techinside">locale</span></a>. On Windows,
+<span class="RktVar">name</span> is coerced to a UTF-8 encoding and case-normalized.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._environment-variables-set!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">environment-variables-set!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">env</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">maybe-bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">fail</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">env</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables~3f%29%29" class="RktValLink" data-pltdoc="x">environment-variables?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._bytes-environment-variable-name~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-environment-variable-name?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">maybe-bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._bytes-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-no-nuls?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">fail</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail</a></span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Changes the mapping for <span class="RktVar">name</span> in <span class="RktVar">env</span> to
+<span class="RktVar">maybe-bstr</span>.  If <span class="RktVar">maybe-bstr</span> is <span class="RktVal">#f</span> and
+<span class="RktVar">env</span> is the initial <a href="envvars.html#%28tech._environment._variable._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">environment variable set</span></a> of the
+Racket process, then the operating system environment-variable mapping
+for <span class="RktVar">name</span> is removed.</div></p><p>Normally, <span class="RktVar">name</span> and <span class="RktVar">maybe-bstr</span> should be a
+byte-string encoding of a string using the default encoding of the
+current <a href="encodings.html#%28tech._locale%29" class="techoutside" data-pltdoc="x"><span class="techinside">locale</span></a>. On Windows, <span class="RktVar">name</span> is
+coerced to a UTF-8 encoding and case-normalized, and
+<span class="RktVar">maybe-bstr</span> is coerced to a UTF-8 encoding if <span class="RktVar">env</span> is
+the initial <a href="envvars.html#%28tech._environment._variable._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">environment variable set</span></a> of the Racket process.</p><p>On success, the result of <span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables-set%21%29%29" class="RktValLink" data-pltdoc="x">environment-variables-set!</a></span> is
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>. If <span class="RktVar">env</span> is the initial <a href="envvars.html#%28tech._environment._variable._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">environment
+variable set</span></a> of the Racket process, then attempting to adjust the
+operating system environment-variable mapping might fail for some reason,
+in which case <span class="RktVar">fail</span> is called in tail position with respect to the
+<span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables-set%21%29%29" class="RktValLink" data-pltdoc="x">environment-variables-set!</a></span>. The default <span class="RktVar">fail</span> raises
+an exception.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._environment-variables-names))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables-names%29%29" class="RktValDef RktValLink" data-pltdoc="x">environment-variables-names</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">env</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._bytes-environment-variable-name~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-environment-variable-name?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">env</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables~3f%29%29" class="RktValLink" data-pltdoc="x">environment-variables?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of byte strings that corresponds to names mapped by
+<span class="RktVar">env</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._environment-variables-copy))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables-copy%29%29" class="RktValDef RktValLink" data-pltdoc="x">environment-variables-copy</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">env</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables~3f%29%29" class="RktValLink" data-pltdoc="x">environment-variables?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">env</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables~3f%29%29" class="RktValLink" data-pltdoc="x">environment-variables?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an <a href="envvars.html#%28tech._environment._variable._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">environment variable set</span></a> that is initialized with
+the same mappings as <span class="RktVar">env</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._getenv))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._getenv%29%29" class="RktValDef RktValLink" data-pltdoc="x">getenv</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._string-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">string-no-nuls?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._string-environment-variable-name~3f%29%29" class="RktValLink" data-pltdoc="x">string-environment-variable-name?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._putenv))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._putenv%29%29" class="RktValDef RktValLink" data-pltdoc="x">putenv</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span><span class="RktVar">value</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._string-environment-variable-name~3f%29%29" class="RktValLink" data-pltdoc="x">string-environment-variable-name?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">value</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._string-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">string-no-nuls?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Convenience wrappers for <span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables-ref%29%29" class="RktValLink" data-pltdoc="x">environment-variables-ref</a></span> and
+<span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._environment-variables-set%21%29%29" class="RktValLink" data-pltdoc="x">environment-variables-set!</a></span> that convert between strings and
+byte strings using the current <a href="encodings.html#%28tech._locale%29" class="techoutside" data-pltdoc="x"><span class="techinside">locale</span></a>&rsquo;s default encoding (using
+<span class="RktVal">#\?</span> as the replacement character for encoding errors) and
+always using the current <a href="envvars.html#%28tech._environment._variable._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">environment variable set</span></a> from
+<span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._current-environment-variables%29%29" class="RktValLink" data-pltdoc="x">current-environment-variables</a></span>. The <span class="RktSym"><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._putenv%29%29" class="RktValLink" data-pltdoc="x">putenv</a></span> function
+returns <span class="RktVal">#t</span> for success and <span class="RktVal">#f</span> for failure.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._string-environment-variable-name~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._string-environment-variable-name~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-environment-variable-name?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a string and if its encoding
+using the current <a href="encodings.html#%28tech._locale%29" class="techoutside" data-pltdoc="x"><span class="techinside">locale</span></a>&rsquo;s encoding is valid for an environment
+variable name according to <span class="RktSym"><a href="envvars.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._bytes-environment-variable-name~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-environment-variable-name?</a></span>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="time.html" title="backward to &quot;15.6 Time&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="os.html" title="up to &quot;15 Operating System&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="runtime.html" title="forward to &quot;15.8 Environment and Runtime Information&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/ephemerons.html b/clones/docs.racket-lang.org/reference/ephemerons.html
new file mode 100644
index 00000000..f556efaf
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/ephemerons.html
@@ -0,0 +1,40 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>16.2&nbsp;Ephemerons</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewselflink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.1&nbsp;</td><td><a href="weakbox.html" class="tocviewlink" data-pltdoc="x">Weak Boxes</a></td></tr><tr><td align="right">16.2&nbsp;</td><td><a href="ephemerons.html" class="tocviewselflink" data-pltdoc="x">Ephemerons</a></td></tr><tr><td align="right">16.3&nbsp;</td><td><a href="willexecutor.html" class="tocviewlink" data-pltdoc="x">Wills and Executors</a></td></tr><tr><td align="right">16.4&nbsp;</td><td><a href="garbagecollection.html" class="tocviewlink" data-pltdoc="x">Garbage Collection</a></td></tr><tr><td align="right">16.5&nbsp;</td><td><a href="phantom-bytes.html" class="tocviewlink" data-pltdoc="x">Phantom Byte Strings</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="ephemerons.html#%28def._%28%28quote._~23~25kernel%29._make-ephemeron%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>ephemeron</span></span></a></td></tr><tr><td><a href="ephemerons.html#%28def._%28%28quote._~23~25kernel%29._ephemeron-value%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">ephemeron-<wbr></wbr>value</span></span></a></td></tr><tr><td><a href="ephemerons.html#%28def._%28%28quote._~23~25kernel%29._ephemeron~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">ephemeron?</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="weakbox.html" title="backward to &quot;16.1 Weak Boxes&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="memory.html" title="up to &quot;16 Memory Management&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="willexecutor.html" title="forward to &quot;16.3 Wills and Executors&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;ephemerons&quot;">16.2<tt>&nbsp;</tt><a name="(part._ephemerons)"></a>Ephemerons</h4><p>An <a name="(tech._ephemeron)"></a><span style="font-style: italic">ephemeron</span> [<a href="doc-bibliography.html#%28cite._.Hayes97%29" data-pltdoc="x">Hayes97</a>] is a generalization of a
+<a href="weakbox.html#%28tech._weak._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">weak box</span></a> (see <a href="weakbox.html" data-pltdoc="x">Weak Boxes</a>). Instead of just containing
+one value, an ephemeron holds two values: one that is considered the
+value of the ephemeron and another that is the ephemeron&rsquo;s key. Like
+the value in a weak box, the value in an ephemeron may be replaced by
+<span class="RktVal">#f</span>, but when the <span class="emph">key</span> is no longer reachable (except
+possibly via weak references) instead of when the value is no longer
+reachable.</p><p>As long as an ephemeron&rsquo;s value is retained, the reference is
+considered a non-weak reference. References to the key via the value
+are treated specially, however, in that the reference does not
+necessarily count toward the key&rsquo;s reachability. A <a href="weakbox.html#%28tech._weak._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">weak box</span></a> can
+be seen as a specialization of an ephemeron where the key and value
+are the same.</p><p>One particularly common use of ephemerons is to combine them with a
+weak hash table (see <a href="hashtables.html" data-pltdoc="x">Hash Tables</a>) to produce a mapping where
+the memory manager can reclaim key&ndash;value pairs even when the value
+refers to the key; see <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-ephemeron-hash%29%29" class="RktValLink" data-pltdoc="x">make-ephemeron-hash</a></span>.
+A related use is to retain a reference to a value
+as long as any value for which it is an <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a> is
+reachable; see <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-ephemeron%29%29" class="RktValLink" data-pltdoc="x">impersonator-ephemeron</a></span>.</p><p><div class="SIntrapara">More precisely,
+</div><div class="SIntrapara"><ul><li><p>the value in an ephemeron is replaced
+by <span class="RktVal">#f</span> when the automatic memory manager can prove that
+either the ephemeron or the key is reachable only through weak
+references (see <a href="weakbox.html" data-pltdoc="x">Weak Boxes</a>); and</p></li><li><p>nothing reachable from the value in an ephemeron counts toward
+the reachability of an ephemeron key (whether for the same ephemeron
+or another), unless the same value is reachable through a non-weak
+reference, or unless the value&rsquo;s ephemeron key is reachable through a
+non-weak reference (see <a href="weakbox.html" data-pltdoc="x">Weak Boxes</a> for information on weak
+references).</p></li></ul></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-ephemeron))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="ephemerons.html#%28def._%28%28quote._~23~25kernel%29._make-ephemeron%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-ephemeron</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="ephemerons.html#%28def._%28%28quote._~23~25kernel%29._ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">ephemeron?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a new <a href="ephemerons.html#%28tech._ephemeron%29" class="techoutside" data-pltdoc="x"><span class="techinside">ephemeron</span></a> whose key is <span class="RktVar">key</span> and whose
+value is initially <span class="RktVar">v</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._ephemeron-value))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="ephemerons.html#%28def._%28%28quote._~23~25kernel%29._ephemeron-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">ephemeron-value</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">ephemeron</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">gced-v</span><span class="hspace">&nbsp;</span><span class="RktVar">retain-v</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ephemeron</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="ephemerons.html#%28def._%28%28quote._~23~25kernel%29._ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">ephemeron?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">gced-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">retain-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the value contained in <span class="RktVar">ephemeron</span>. If the garbage
+collector has proven that the key for <span class="RktVar">ephemeron</span> is only
+weakly reachable, then the result is <span class="RktVar">gced-v</span> (which defaults to <span class="RktVal">#f</span>).</div></p><p>The <span class="RktVar">retain-v</span> argument is retained as reachable until the
+ephemeron&rsquo;s value is extracted. It is useful, for example, when
+<span class="RktVar">ephemeron</span> was obtained through a weak, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>-based
+mapping from <span class="RktVar">key</span> and <span class="RktVar">ephemeron</span> was created with
+<span class="RktVar">key</span> as the key; in that case, supplying <span class="RktVar">key</span> as
+<span class="RktVar">retain-v</span> ensures that <span class="RktVar">ephemeron</span> retains its value
+long enough for it to be extracted, even if <span class="RktVar">key</span> is otherwise
+unreachable.</p><p class="SHistory">Changed in version 7.1.0.10 of package <span class="stt">base</span>: Added the <span class="RktVar">retain-v</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._ephemeron~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="ephemerons.html#%28def._%28%28quote._~23~25kernel%29._ephemeron~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">ephemeron?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is an <a href="ephemerons.html#%28tech._ephemeron%29" class="techoutside" data-pltdoc="x"><span class="techinside">ephemeron</span></a>, <span class="RktVal">#f</span>
+otherwise.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="weakbox.html" title="backward to &quot;16.1 Weak Boxes&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="memory.html" title="up to &quot;16 Memory Management&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="willexecutor.html" title="forward to &quot;16.3 Wills and Executors&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/eval-model.html b/clones/docs.racket-lang.org/reference/eval-model.html
new file mode 100644
index 00000000..323e5e85
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/eval-model.html
@@ -0,0 +1,515 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>1.1&nbsp;Evaluation Model</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewselflink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">1.1&nbsp;</td><td><a href="eval-model.html" class="tocviewselflink" data-pltdoc="x">Evaluation Model</a></td></tr><tr><td align="right">1.2&nbsp;</td><td><a href="syntax-model.html" class="tocviewlink" data-pltdoc="x">Syntax Model</a></td></tr><tr><td align="right">1.3&nbsp;</td><td><a href="reader.html" class="tocviewlink" data-pltdoc="x">The Reader</a></td></tr><tr><td align="right">1.4&nbsp;</td><td><a href="printing.html" class="tocviewlink" data-pltdoc="x">The Printer</a></td></tr><tr><td align="right">1.5&nbsp;</td><td><a href="implementations.html" class="tocviewlink" data-pltdoc="x">Implementations</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>1.1&nbsp;</td><td><a href="eval-model.html" class="tocviewselflink" data-pltdoc="x">Evaluation Model</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">1.1.1&nbsp;</td><td><a href="eval-model.html#%28part._cont-model%29" class="tocviewlink" data-pltdoc="x">Sub-<wbr></wbr>expression Evaluation and Continuations</a></td></tr><tr><td align="right">1.1.2&nbsp;</td><td><a href="eval-model.html#%28part._.Tail_.Position%29" class="tocviewlink" data-pltdoc="x">Tail Position</a></td></tr><tr><td align="right">1.1.3&nbsp;</td><td><a href="eval-model.html#%28part._values-model%29" class="tocviewlink" data-pltdoc="x">Multiple Return Values</a></td></tr><tr><td align="right">1.1.4&nbsp;</td><td><a href="eval-model.html#%28part._.Top-.Level_.Variables%29" class="tocviewlink" data-pltdoc="x">Top-<wbr></wbr>Level Variables</a></td></tr><tr><td align="right">1.1.5&nbsp;</td><td><a href="eval-model.html#%28part._.Objects_and_.Imperative_.Update%29" class="tocviewlink" data-pltdoc="x">Objects and Imperative Update</a></td></tr><tr><td align="right">1.1.6&nbsp;</td><td><a href="eval-model.html#%28part._gc-model%29" class="tocviewlink" data-pltdoc="x">Garbage Collection</a></td></tr><tr><td align="right">1.1.7&nbsp;</td><td><a href="eval-model.html#%28part._.Procedure_.Applications_and_.Local_.Variables%29" class="tocviewlink" data-pltdoc="x">Procedure Applications and Local Variables</a></td></tr><tr><td align="right">1.1.8&nbsp;</td><td><a href="eval-model.html#%28part._vars-and-locs%29" class="tocviewlink" data-pltdoc="x">Variables and Locations</a></td></tr><tr><td align="right">1.1.9&nbsp;</td><td><a href="eval-model.html#%28part._module-eval-model%29" class="tocviewlink" data-pltdoc="x">Modules and Module-<wbr></wbr>Level Variables</a></td></tr><tr><td align="right">1.1.10&nbsp;</td><td><a href="eval-model.html#%28part._mark-model%29" class="tocviewlink" data-pltdoc="x">Continuation Frames and Marks</a></td></tr><tr><td align="right">1.1.11&nbsp;</td><td><a href="eval-model.html#%28part._prompt-model%29" class="tocviewlink" data-pltdoc="x">Prompts, Delimited Continuations, and Barriers</a></td></tr><tr><td align="right">1.1.12&nbsp;</td><td><a href="eval-model.html#%28part._thread-model%29" class="tocviewlink" data-pltdoc="x">Threads</a></td></tr><tr><td align="right">1.1.13&nbsp;</td><td><a href="eval-model.html#%28part._parameter-model%29" class="tocviewlink" data-pltdoc="x">Parameters</a></td></tr><tr><td align="right">1.1.14&nbsp;</td><td><a href="eval-model.html#%28part._exn-model%29" class="tocviewlink" data-pltdoc="x">Exceptions</a></td></tr><tr><td align="right">1.1.15&nbsp;</td><td><a href="eval-model.html#%28part._custodian-model%29" class="tocviewlink" data-pltdoc="x">Custodians</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">1.1.1<tt>&nbsp;</tt></span><a href="eval-model.html#%28part._cont-model%29" class="tocsubseclink" data-pltdoc="x">Sub-<wbr></wbr>expression Evaluation and Continuations</a></td></tr><tr><td><span class="tocsublinknumber">1.1.2<tt>&nbsp;</tt></span><a href="eval-model.html#%28part._.Tail_.Position%29" class="tocsubseclink" data-pltdoc="x">Tail Position</a></td></tr><tr><td><span class="tocsublinknumber">1.1.3<tt>&nbsp;</tt></span><a href="eval-model.html#%28part._values-model%29" class="tocsubseclink" data-pltdoc="x">Multiple Return Values</a></td></tr><tr><td><span class="tocsublinknumber">1.1.4<tt>&nbsp;</tt></span><a href="eval-model.html#%28part._.Top-.Level_.Variables%29" class="tocsubseclink" data-pltdoc="x">Top-<wbr></wbr>Level Variables</a></td></tr><tr><td><span class="tocsublinknumber">1.1.5<tt>&nbsp;</tt></span><a href="eval-model.html#%28part._.Objects_and_.Imperative_.Update%29" class="tocsubseclink" data-pltdoc="x">Objects and Imperative Update</a></td></tr><tr><td><span class="tocsublinknumber">1.1.6<tt>&nbsp;</tt></span><a href="eval-model.html#%28part._gc-model%29" class="tocsubseclink" data-pltdoc="x">Garbage Collection</a></td></tr><tr><td><span class="tocsublinknumber">1.1.7<tt>&nbsp;</tt></span><a href="eval-model.html#%28part._.Procedure_.Applications_and_.Local_.Variables%29" class="tocsubseclink" data-pltdoc="x">Procedure Applications and Local Variables</a></td></tr><tr><td><span class="tocsublinknumber">1.1.8<tt>&nbsp;</tt></span><a href="eval-model.html#%28part._vars-and-locs%29" class="tocsubseclink" data-pltdoc="x">Variables and Locations</a></td></tr><tr><td><span class="tocsublinknumber">1.1.9<tt>&nbsp;</tt></span><a href="eval-model.html#%28part._module-eval-model%29" class="tocsubseclink" data-pltdoc="x">Modules and Module-<wbr></wbr>Level Variables</a></td></tr><tr><td><span class="tocsublinknumber">1.1.9.1<tt>&nbsp;</tt></span><a href="eval-model.html#%28part._module-phase%29" class="tocsubseclink" data-pltdoc="x">Phases</a></td></tr><tr><td><span class="tocsublinknumber">1.1.9.2<tt>&nbsp;</tt></span><a href="eval-model.html#%28part._separate-compilation%29" class="tocsubseclink" data-pltdoc="x">The Separate Compilation Guarantee</a></td></tr><tr><td><span class="tocsublinknumber">1.1.9.3<tt>&nbsp;</tt></span><a href="eval-model.html#%28part._cross-phase._persistent-modules%29" class="tocsubseclink" data-pltdoc="x">Cross-<wbr></wbr>Phase Persistent Modules</a></td></tr><tr><td><span class="tocsublinknumber">1.1.9.4<tt>&nbsp;</tt></span><a href="eval-model.html#%28part._module-redeclare%29" class="tocsubseclink" data-pltdoc="x">Module Redeclarations</a></td></tr><tr><td><span class="tocsublinknumber">1.1.9.5<tt>&nbsp;</tt></span><a href="eval-model.html#%28part._submodules%29" class="tocsubseclink" data-pltdoc="x">Submodules</a></td></tr><tr><td><span class="tocsublinknumber">1.1.10<tt>&nbsp;</tt></span><a href="eval-model.html#%28part._mark-model%29" class="tocsubseclink" data-pltdoc="x">Continuation Frames and Marks</a></td></tr><tr><td><span class="tocsublinknumber">1.1.11<tt>&nbsp;</tt></span><a href="eval-model.html#%28part._prompt-model%29" class="tocsubseclink" data-pltdoc="x">Prompts, Delimited Continuations, and Barriers</a></td></tr><tr><td><span class="tocsublinknumber">1.1.12<tt>&nbsp;</tt></span><a href="eval-model.html#%28part._thread-model%29" class="tocsubseclink" data-pltdoc="x">Threads</a></td></tr><tr><td><span class="tocsublinknumber">1.1.13<tt>&nbsp;</tt></span><a href="eval-model.html#%28part._parameter-model%29" class="tocsubseclink" data-pltdoc="x">Parameters</a></td></tr><tr><td><span class="tocsublinknumber">1.1.14<tt>&nbsp;</tt></span><a href="eval-model.html#%28part._exn-model%29" class="tocsubseclink" data-pltdoc="x">Exceptions</a></td></tr><tr><td><span class="tocsublinknumber">1.1.15<tt>&nbsp;</tt></span><a href="eval-model.html#%28part._custodian-model%29" class="tocsubseclink" data-pltdoc="x">Custodians</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="versionbox"><span class="version">8.6</span></div><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="model.html" title="backward to &quot;1 Language Model&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="model.html" title="up to &quot;1 Language Model&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="syntax-model.html" title="forward to &quot;1.2 Syntax Model&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;eval-model&quot;">1.1<tt>&nbsp;</tt><a name="(part._eval-model)"></a>Evaluation Model</h4><p>Racket evaluation can be viewed as the simplification of expressions
+to obtain values. For example, just as an elementary-school student
+simplifies</p><p><table cellspacing="0" cellpadding="0" class="SVerbatim"><tr><td><p><span class="stt"></span><span class="hspace">&nbsp;&nbsp;</span><span class="stt">1 + 1 = 2</span></p></td></tr></table></p><p>Racket evaluation simplifies</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktVal">2</span></p></blockquote><p>The arrow &rarr; replaces the more traditional <span class="stt">=</span> to
+emphasize that evaluation proceeds in a particular direction toward
+simpler expressions. In particular, a <a name="(tech._value)"></a><span style="font-style: italic">value</span>, such as the number <span class="RktVal">2</span>,
+is an expression that evaluation simplifies no further.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;cont-model&quot;">1.1.1<tt>&nbsp;</tt><a name="(part._cont-model)"></a>Sub-expression Evaluation and Continuations</h5><p>Some simplifications require more than one step. For example:</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="highlighted"><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="highlighted"><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVal">4</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span></span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktVal">2</span></p></blockquote><p>An expression that is not a <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">value</span></a> can always be partitioned
+into two parts: a <a name="(tech._redex)"></a><span style="font-style: italic">redex</span> (&ldquo;reducible expression&rdquo;),
+which is the part that can change in a
+single-step simplification (highlighted), and the
+<a name="(tech._continuation)"></a><span style="font-style: italic">continuation</span>, which is the evaluation
+context surrounding the redex. In <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVal">4</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span>, the redex is <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span>, and
+the continuation is <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVal">4</span><span class="stt"> </span>[]<span class="RktPn">)</span>, where [] takes the place
+of the <a href="eval-model.html#%28tech._redex%29" class="techoutside" data-pltdoc="x"><span class="techinside">redex</span></a> as it is reduced. That is, the continuation says how to &ldquo;continue&rdquo;
+after the <a href="eval-model.html#%28tech._redex%29" class="techoutside" data-pltdoc="x"><span class="techinside">redex</span></a> is reduced to a <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">value</span></a>.</p><p>Before some expressions can be evaluated, some or all of their sub-expressions must be
+evaluated. For example, in the application <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVal">4</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span>, the
+application of <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span> cannot be reduced until the sub-expression
+<span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span> is reduced.
+Thus, the specification of each syntactic form specifies how (some of)
+its sub-expressions are evaluated and then how the results are
+combined to reduce the form away.</p><p>The <a name="(tech._dynamic._extent)"></a><span style="font-style: italic">dynamic extent</span> of an expression is the sequence of
+evaluation steps during which the expression contains the <a href="eval-model.html#%28tech._redex%29" class="techoutside" data-pltdoc="x"><span class="techinside">redex</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Tail_Position&quot;">1.1.2<tt>&nbsp;</tt><a name="(part._.Tail_.Position)"></a>Tail Position</h5><p>An expression <span class="RktVar">expr1</span> is in <a name="(tech._tail._position)"></a><span style="font-style: italic">tail position</span> with
+respect to an enclosing expression <span class="RktVar">expr2</span> if, whenever
+<span class="RktVar">expr1</span> becomes a redex, its <a href="eval-model.html#%28tech._continuation%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation</span></a> is the same
+as was the enclosing <span class="RktVar">expr2</span>&rsquo;s <a href="eval-model.html#%28tech._continuation%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation</span></a>.</p><p>For example, the <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span> expression is <span style="font-style: italic">not</span> in <a href="eval-model.html#%28tech._tail._position%29" class="techoutside" data-pltdoc="x"><span class="techinside">tail
+position</span></a> with respect to <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVal">4</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span>. To illustrate, we use
+the notation <span class="RktVar">C</span>[<span class="RktVar">expr</span>] to mean the expression that is produced by
+substituting <span class="RktVar">expr</span> in place of [] in some <a href="eval-model.html#%28tech._continuation%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation</span></a>
+<span class="RktVar">C</span>:</p><blockquote class="SCodeFlow"><p><span class="RktVar">C</span>[<span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVal">4</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span>]<span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktVar">C</span>[<span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVal">4</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span>]</p></blockquote><p>In this case, the <a href="eval-model.html#%28tech._continuation%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation</span></a> for reducing <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span> is
+<span class="RktVar">C</span>[<span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVal">4</span><span class="stt"> </span>[]<span class="RktPn">)</span>], not just <span class="RktVar">C</span>. The requirement specified in the first paragraph above is not met.</p><p>In contrast, <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span> is in <a href="eval-model.html#%28tech._tail._position%29" class="techoutside" data-pltdoc="x"><span class="techinside">tail position</span></a> with respect
+to <span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="stt"> </span><span class="RktVal">0</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">3</span><span class="RktPn">)</span> because, for any continuation
+<span class="RktVar">C</span>,</p><blockquote class="SCodeFlow"><p><span class="RktVar">C</span>[<span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="stt"> </span><span class="RktVal">0</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">3</span><span class="RktPn">)</span>]<span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktVar">C</span>[<span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="stt"> </span><span class="RktVal">#t</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">3</span><span class="RktPn">)</span>]<span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktVar">C</span>[<span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span>]</p></blockquote><p>The requirement specified in the first paragraph is met.
+The steps in this reduction sequence are driven by the definition of
+<span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span>, and they do not depend on the <a href="eval-model.html#%28tech._continuation%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation</span></a>
+<span class="RktVar">C</span>. The &ldquo;then&rdquo; branch of an <span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span> form is always in
+<a href="eval-model.html#%28tech._tail._position%29" class="techoutside" data-pltdoc="x"><span class="techinside">tail position</span></a> with respect to the <span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span> form. Due to a
+similar reduction rule for <span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span> and <span class="RktVal">#f</span>, the &ldquo;else&rdquo;
+branch of an <span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span> form is also in <a href="eval-model.html#%28tech._tail._position%29" class="techoutside" data-pltdoc="x"><span class="techinside">tail position</span></a>.</p><p><a href="eval-model.html#%28tech._tail._position%29" class="techoutside" data-pltdoc="x"><span class="techinside">Tail-position</span></a> specifications provide a guarantee about the
+asymptotic space consumption of a computation. In general, the
+specification of <a href="eval-model.html#%28tech._tail._position%29" class="techoutside" data-pltdoc="x"><span class="techinside">tail positions</span></a> accompanies the description of
+each syntactic form, such as <span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;values-model&quot;">1.1.3<tt>&nbsp;</tt><a name="(part._values-model)"></a>Multiple Return Values</h5><p>A Racket expression can evaluate to <a name="(tech._multiple._value)"></a><span style="font-style: italic">multiple values</span>, to
+provide symmetry with the fact that a procedure can accept multiple arguments.</p><p>Most <a href="eval-model.html#%28tech._continuation%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuations</span></a> expect a certain number of result
+<a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">values</span></a>, although some <a href="eval-model.html#%28tech._continuation%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuations</span></a> can accept
+an arbitrary number. Indeed, most <a href="eval-model.html#%28tech._continuation%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuations</span></a>, such as <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span>[]<span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span>, expect a single <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">value</span></a>. The <a href="eval-model.html#%28tech._continuation%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation</span></a>
+<span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="stt"> </span><span class="RktSym">y</span><span class="RktPn">)</span><span class="stt"> </span>[]<span class="RktPn">]</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span> expects two result
+<a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">values</span></a>; the first result replaces <span class="RktSym">x</span> in the body
+<span class="RktVar">expr</span>, and the second replaces <span class="RktSym">y</span> in
+<span class="RktVar">expr</span>. The <a href="eval-model.html#%28tech._continuation%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation</span></a> <span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span>[]<span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span> accepts any number of result <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">values</span></a>, because it ignores
+the result(s).</p><p>In general, the specification of a syntactic form indicates the
+number of <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">values</span></a> that it produces and the number that it
+expects from each of its sub-expressions. In addition, some procedures
+(notably <span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span>) produce multiple <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">values</span></a>, and some
+procedures (notably <span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._call-with-values%29%29" class="RktValLink" data-pltdoc="x">call-with-values</a></span>) create continuations
+internally that accept a certain number of <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">values</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Top-Level_Variables&quot;">1.1.4<tt>&nbsp;</tt><a name="(part._.Top-.Level_.Variables)"></a>Top-Level Variables</h5><p>Given</p><p><table cellspacing="0" cellpadding="0" class="SVerbatim"><tr><td><p><span class="stt"></span><span class="hspace">&nbsp;&nbsp;</span><span class="stt">x = 10</span></p></td></tr></table></p><p>then an algebra student simplifies <span class="stt">x + 1</span> as follows:</p><p><table cellspacing="0" cellpadding="0" class="SVerbatim"><tr><td><p><span class="stt"></span><span class="hspace">&nbsp;&nbsp;</span><span class="stt">x + 1 = 10 + 1 = 11</span></p></td></tr></table></p><p>Racket works much the same way, in that a set of <a href="eval-model.html#%28tech._top._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level
+variables</span></a> (see also <a href="eval-model.html#%28part._vars-and-locs%29" data-pltdoc="x">Variables and Locations</a>) are available for substitutions on demand during
+evaluation. For example, given</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></p></blockquote><p>then</p><blockquote class="SCodeFlow"><p><span class="highlighted"><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktSym">x</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span></span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="highlighted"><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">10</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span></span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktVal">11</span></p></blockquote><p>In Racket, the way definitions are created is just as important as the way
+they are used. Racket evaluation thus keeps track of both
+definitions and the current expression, and it extends the set of
+definitions in response to evaluating forms such as <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span>.</p><p>Each evaluation step, then, transforms the current set of definitions and
+program into a new set of definitions and program. Before a
+<span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span> can be moved into the set of definitions, its
+expression (i.e., its right-hand side) must be reduced to a <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">value</span></a>.
+(The left-hand side is not an expression position, and so it is not evaluated.)</p><p><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">9</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">1</span></span><span class="highlighted"><span class="RktPn">)</span></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktSym">x</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">10</span></span><span class="highlighted"><span class="RktPn">)</span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span></span><span class="highlighted"><span class="RktPn">)</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktSym">x</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">1</span></span><span class="highlighted"><span class="RktPn">)</span></span><span class="highlighted"><span class="RktPn">)</span></span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="highlighted"><span class="RktSym">x</span></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">10</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">1</span></span><span class="highlighted"><span class="RktPn">)</span></span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktVal">11</span></td></tr></table></p><p>Using <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>, a program can change the value associated with an
+existing <a href="eval-model.html#%28tech._top._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level variable</span></a>:</p><p><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktSym">x</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">8</span></span><span class="highlighted"><span class="RktPn">)</span></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span></span><span class="highlighted"><span class="RktPn">)</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktSym">x</span></span><span class="highlighted"><span class="RktPn">)</span></span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="highlighted"><span class="RktSym">x</span></span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktVal">8</span></td></tr></table></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Objects_and_Imperative_Update&quot;">1.1.5<tt>&nbsp;</tt><a name="(part._.Objects_and_.Imperative_.Update)"></a>Objects and Imperative Update</h5><p>In addition to <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span> for imperative update of <a href="eval-model.html#%28tech._top._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level
+variables</span></a>, various procedures enable the modification of elements
+within a compound data structure. For example, <span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="RktValLink" data-pltdoc="x">vector-set!</a></span>
+modifies the content of a vector.</p><p>To explain such modifications to data, we must distinguish between
+<a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">values</span></a>, which are the results of expressions, and
+<a name="(tech._object)"></a><span style="font-style: italic">objects</span>, which actually hold data.</p><p>A few kinds of <a href="eval-model.html#%28tech._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">objects</span></a> can serve directly as values, including
+booleans, <span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span>, and small exact integers. More generally,
+however, a <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">value</span></a> is a reference to an <a href="eval-model.html#%28tech._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">object</span></a> stored somewhere
+else. For example, a <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">value</span></a> can refer to a particular vector that
+currently holds the value <span class="RktVal">10</span> in its first slot. If an
+<a href="eval-model.html#%28tech._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">object</span></a> is modified via one <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">value</span></a>,
+then the modification is visible through
+all the <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">values</span></a> that reference the <a href="eval-model.html#%28tech._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">object</span></a>.</p><p>In the evaluation model, a set of <a href="eval-model.html#%28tech._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">objects</span></a> must be carried along
+with each step in evaluation, just like the definition set. Operations
+that create <a href="eval-model.html#%28tech._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">objects</span></a>, such as <span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span>, add to the set of
+<a href="eval-model.html#%28tech._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">objects</span></a>:</p><p><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">10</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">20</span></span><span class="highlighted"><span class="RktPn">)</span></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="RktValLink" data-pltdoc="x">vector-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktSym">x</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktSym">&lt;o1&gt;</span></span><span class="highlighted"><span class="RktPn">)</span></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="RktValLink" data-pltdoc="x">vector-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span></span><span class="highlighted"><span class="RktPn">)</span></span></td></tr><tr><td><span class="highlighted"><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span></span><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktSym">y</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktSym">x</span></span><span class="highlighted"><span class="RktPn">)</span></span></td></tr><tr><td><span class="highlighted"><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span></span><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="RktValLink" data-pltdoc="x">vector-set!</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktSym">x</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">0</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">11</span></span><span class="highlighted"><span class="RktPn">)</span></span></td></tr><tr><td><span class="highlighted"><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span></span><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktSym">y</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">0</span></span><span class="highlighted"><span class="RktPn">)</span></span><span class="highlighted"><span class="RktPn">)</span></span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="highlighted"><span class="RktSym">x</span></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="RktValLink" data-pltdoc="x">vector-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktSym">y</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktSym">&lt;o1&gt;</span></span><span class="highlighted"><span class="RktPn">)</span></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="RktValLink" data-pltdoc="x">vector-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span></span><span class="highlighted"><span class="RktPn">)</span></span></td></tr><tr><td><span class="highlighted"><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span></span><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="RktValLink" data-pltdoc="x">vector-set!</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktSym">x</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">0</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">11</span></span><span class="highlighted"><span class="RktPn">)</span></span></td></tr><tr><td><span class="highlighted"><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span></span><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktSym">y</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">0</span></span><span class="highlighted"><span class="RktPn">)</span></span><span class="highlighted"><span class="RktPn">)</span></span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="RktValLink" data-pltdoc="x">vector-set!</a></span><span class="hspace">&nbsp;</span><span class="highlighted"><span class="RktSym">x</span></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="RktValLink" data-pltdoc="x">vector-set!</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktSym">&lt;o1&gt;</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">0</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">11</span></span><span class="highlighted"><span class="RktPn">)</span></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span></span><span class="highlighted"><span class="RktPn">)</span></span></td></tr><tr><td><span class="highlighted"><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span></span><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktSym">y</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">0</span></span><span class="highlighted"><span class="RktPn">)</span></span><span class="highlighted"><span class="RktPn">)</span></span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span><span class="hspace">&nbsp;</span><span class="highlighted"><span class="RktSym">y</span></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktSym">&lt;o1&gt;</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">0</span></span><span class="highlighted"><span class="RktPn">)</span></span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktVal">11</span></td></tr></table></p><p>The distinction between a <a href="eval-model.html#%28tech._top._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level variable</span></a> and an object
+reference is crucial. A <a href="eval-model.html#%28tech._top._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level variable</span></a> is not a
+<a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">value</span></a>, so it must be evaluated. Each time
+a <a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable</span></a> expression is evaluated, the
+value of the variable is extracted from the current set of definitions. An object
+reference, in contrast, is a value and therefore needs no further
+evaluation. The evaluation steps above use angle-bracketed
+<span class="RktSym">&lt;o1&gt;</span> for an object reference to distinguish it from a
+<a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable</span></a> name.</p><p>An object reference can never appear directly in a text-based source
+program. A program representation created with
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span>, however, can embed direct references to
+existing <a href="eval-model.html#%28tech._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">objects</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;gc-model&quot;">1.1.6<tt>&nbsp;</tt><a name="(part._gc-model)"></a>Garbage Collection</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span>See <a href="memory.html" data-pltdoc="x">Memory Management</a> for functions related to
+garbage collection.</p></blockquote></blockquote></blockquote><p>In the program state</p><p><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o2&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;o1&gt;</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr></table></p><p>evaluation cannot depend on <span class="RktSym">&lt;o2&gt;</span>, because it is not part of
+the program to evaluate, and it is not referenced by any definition
+that is accessible by the program. The object is said to not
+be <a name="(tech._reachable)"></a><span style="font-style: italic">reachable</span>. The <a href="eval-model.html#%28tech._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">object</span></a> <span class="RktSym">&lt;o2&gt;</span> may
+therefore be removed from the program state by <a name="(tech._garbage._collection)"></a><span style="font-style: italic">garbage
+collection</span>.</p><p>A few special compound datatypes hold <a name="(tech._weak._reference)"></a><span style="font-style: italic">weak references</span> to
+objects. Such weak references are treated specially by the garbage
+collector in determining which <a href="eval-model.html#%28tech._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">objects</span></a> are reachable for the
+remainder of the computation. If an <a href="eval-model.html#%28tech._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">object</span></a> is reachable <span style="font-style: italic">only</span>
+via a <a href="eval-model.html#%28tech._weak._reference%29" class="techoutside" data-pltdoc="x"><span class="techinside">weak reference</span></a>, then the object can be reclaimed, and the
+<a href="eval-model.html#%28tech._weak._reference%29" class="techoutside" data-pltdoc="x"><span class="techinside">weak reference</span></a> is replaced by a different <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">value</span></a>
+(typically <span class="RktVal">#f</span>).</p><p>As a special case, a <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a> is always considered reachable by
+the garbage collector. Many other values are always reachable due to
+the way they are implemented and used: A <a href="characters.html#%28tech._character%29" class="techoutside" data-pltdoc="x"><span class="techinside">character</span></a> in the
+Latin-1 range is always reachable, because <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> Latin-1
+characters are always <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>, and all of the Latin-1 characters
+are referenced by an internal module. Similarly, <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span>,
+<span class="RktVal">#t</span>, <span class="RktVal">#f</span>, <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>, and <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a> are
+always reachable. Values produced by <span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span> remain reachable
+when the <span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span> expression itself is reachable.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Procedure_Applications_and_Local_Variables&quot;">1.1.7<tt>&nbsp;</tt><a name="(part._.Procedure_.Applications_and_.Local_.Variables)"></a>Procedure Applications and Local Variables</h5><p>Given</p><p><table cellspacing="0" cellpadding="0" class="SVerbatim"><tr><td><p><span class="stt"></span><span class="hspace">&nbsp;&nbsp;</span><span class="stt">f(x) = x + 10</span></p></td></tr></table></p><p>an algebra student simplifies <span class="stt">f(7)</span> as follows:</p><p><table cellspacing="0" cellpadding="0" class="SVerbatim"><tr><td><p><span class="stt"></span><span class="hspace">&nbsp;&nbsp;</span><span class="stt">f(7) = 7 + 10 = 17</span></p></td></tr></table></p><p>The key step in this simplification is to take the body of the defined
+function <span class="stt">f</span> and replace each <span class="stt">x</span> with the actual
+<a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">value</span></a> <span class="stt">7</span>.</p><p>Racket procedure application works much the same way. A procedure is
+an <a href="eval-model.html#%28tech._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">object</span></a>, so evaluating <span class="RktPn">(</span><span class="RktSym">f</span><span class="stt"> </span><span class="RktVal">7</span><span class="RktPn">)</span> starts with a
+<a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable</span></a> lookup:</p><p><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="highlighted"><span class="RktSym">f</span></span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym">&lt;p1&gt;</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">7</span></span><span class="highlighted"><span class="RktPn">)</span></span></td></tr></table></p><p>Unlike in algebra, however, the <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">value</span></a> associated with a procedure
+argument variable can be changed in the body of a procedure by using
+<span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>, as in the example <span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="stt"> </span><span class="RktSym">x</span><span class="stt"> </span><span class="RktVal">3</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span>. Since the <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">value</span></a> associated with argument variable <span class="RktSym">x</span> should be
+able to change, we cannot just substitute the value in for <span class="RktSym">x</span> when
+we first apply the procedure.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>We do not use the term &ldquo;parameter variable&rdquo; to refer to
+the argument variable names declared with a function. This choice avoids
+confusion with <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameters</span></a>.</p></blockquote></blockquote></blockquote><p>Instead, a new <a name="(tech._location)"></a><span style="font-style: italic">location</span> is created for each <a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable</span></a>
+on each application. The argument <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">value</span></a> is placed in the
+<a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a>, and each instance of the <a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable</span></a> in the
+procedure body is replaced with the new <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a>:</p><p><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym">&lt;p1&gt;</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">7</span></span><span class="highlighted"><span class="RktPn">)</span></span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">xloc</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="highlighted"><span class="RktSym">xloc</span></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">xloc</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">7</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">10</span></span><span class="highlighted"><span class="RktPn">)</span></span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">xloc</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktVal">17</span></td></tr></table></p><p>A <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a> is the same as a <a href="eval-model.html#%28tech._top._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level variable</span></a>, but when
+a <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a> is generated, it (conceptually) uses a name that has
+not been used before and that cannot be generated again or
+accessed directly.</p><p>Generating a <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a> in this way means that <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>
+evaluates for <a href="eval-model.html#%28tech._local._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">local variables</span></a>, including argument
+variables, in the same way as for
+<a href="eval-model.html#%28tech._top._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level variables</span></a>, because the <a href="eval-model.html#%28tech._local._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">local variable</span></a> is
+always replaced with a <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a> by the time the <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>
+form is evaluated:</p><p><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="highlighted"><span class="RktSym">f</span></span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym">&lt;p1&gt;</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">7</span></span><span class="highlighted"><span class="RktPn">)</span></span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">xloc</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktSym">xloc</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktVal">3</span></span><span class="highlighted"><span class="RktPn">)</span></span><span class="hspace">&nbsp;</span><span class="RktSym">xloc</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">xloc</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktPn">(</span></span><span class="highlighted"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span></span><span class="highlighted"><span class="RktPn">)</span></span><span class="highlighted"><span class="hspace">&nbsp;</span></span><span class="highlighted"><span class="RktSym">xloc</span></span><span class="highlighted"><span class="RktPn">)</span></span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">xloc</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="highlighted"><span class="RktSym">xloc</span></span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p>&rarr;</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>objects:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>defined:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">&lt;p1&gt;</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">xloc</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p>evaluate:</p></td><td valign="baseline"><p> </p></td><td valign="baseline"><span class="RktVal">3</span></td></tr></table></p><p>The <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a>-generation and substitution step of procedure
+application requires that the argument is a <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">value</span></a>. Therefore,
+in <span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktSym">x</span><span class="stt"> </span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span>, the <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span>
+sub-expression must be simplified to the <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">value</span></a> <span class="RktVal">3</span>, and
+then <span class="RktVal">3</span> can be placed into a <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a> for
+<span class="RktSym">x</span>. In other words, Racket is a <a name="(tech._call._by._value)"></a><span style="font-style: italic">call-by-value</span>
+language.</p><p>Evaluation of a local-variable form, such as <span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span>, is the same as for a procedure call. After <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span> produces a <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">value</span></a>, it is stored in a fresh <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a>
+that replaces every instance of <span class="RktSym">x</span> in <span class="RktVar">expr</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;vars-and-locs&quot;">1.1.8<tt>&nbsp;</tt><a name="(part._vars-and-locs)"></a>Variables and Locations</h5><p>A <a name="(tech._variable)"></a><span style="font-style: italic">variable</span> is a placeholder for a <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">value</span></a>, and
+expressions in an initial program refer to <a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variables</span></a>. A
+<a name="(tech._top._level._variable)"></a><span style="font-style: italic">top-level variable</span> is both a <a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable</span></a> and a
+<a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a>. Any other <a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable</span></a> is always replaced by a
+<a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a> at run-time; thus, evaluation of expressions
+involves only <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">locations</span></a>. A single <a name="(tech._local._variable)"></a><span style="font-style: italic">local variable</span>
+(i.e., a non-top-level, non-module-level <a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable</span></a>), such as an
+argument variable, can correspond to different <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">locations</span></a>
+during different applications.</p><p>For example, in the program</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>both <span class="RktSym">y</span> and <span class="RktSym">x</span> are <a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variables</span></a>. The <span class="RktSym">y</span>
+<a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable</span></a> is a <a href="eval-model.html#%28tech._top._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level variable</span></a>, and the <span class="RktSym">x</span> is
+a <a href="eval-model.html#%28tech._local._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">local variable</span></a>. When this code is evaluated, a
+<a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a> is created for <span class="RktSym">x</span> to hold the value
+<span class="RktVal">5</span>, and a <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a> is also created for <span class="RktSym">y</span> to
+hold the value <span class="RktVal">11</span>.</p><p>The replacement of a <a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable</span></a> with a <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a> during
+evaluation implements Racket&rsquo;s <a name="(tech._lexical._scoping)"></a><span style="font-style: italic">lexical scoping</span>.
+<span class="refelem"><span class="refcolumn"><span class="refcontent">For the purposes of substituting <span class="RktSym">xloc</span> for <span class="RktSym">x</span>,
+all variable bindings must use distinct names, so no <span class="RktSym">x</span> that
+is really a different variable will get replaced. Ensuring that
+distinction is one of the jobs of the macro expander; see <a href="syntax-model.html" data-pltdoc="x">Syntax Model</a>.</span></span></span>
+For example, when an argument variable <span class="RktSym">x</span> is replaced by
+the <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a> <span class="RktSym">xloc</span>, it is replaced <span style="font-style: italic">throughout</span> the
+body of the procedure, including any nested <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span>
+forms. As a result, future references to the <a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable</span></a> always
+access the same <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;module-eval-model&quot;">1.1.9<tt>&nbsp;</tt><a name="(part._module-eval-model)"></a>Modules and Module-Level Variables</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span>See <a href="module.html" data-pltdoc="x">Modules: <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a> for the syntax of modules.</p></blockquote></blockquote></blockquote><p>Most definitions in Racket are in <a name="(tech._module)"></a><span style="font-style: italic">modules</span>. In terms of evaluation,
+a module is essentially a prefix on a defined name, so that different
+modules can define the same name. That is, a <a name="(tech._module._level._variable)"></a><span style="font-style: italic">module-level
+variable</span> is like a <a href="eval-model.html#%28tech._top._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level variable</span></a> from the perspective of
+evaluation.</p><p>One difference between a module and a top-level definition
+is that a module can be <a name="(tech._declare)"></a><span style="font-style: italic">declared</span>
+without instantiating its module-level definitions.
+Evaluation of a <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> <a name="(tech._instantiate)"></a><span style="font-style: italic">instantiates</span>
+(i.e., triggers the <a name="(tech._instantiation)"></a><span style="font-style: italic">instantiation</span> of) the declared
+module, which creates variables that correspond to its
+module-level definitions.</p><p>For example, given the module declaration</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>the evaluation of <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">m</span><span class="RktPn">)</span> creates the variable <span class="RktSym">x</span>
+and installs <span class="RktVal">10</span> as its value. This <span class="RktSym">x</span> is unrelated to
+any top-level definition of <span class="RktSym">x</span> (as if it were given a unique,
+module-specific prefix).</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;module-phase&quot;">1.1.9.1<tt>&nbsp;</tt><a name="(part._module-phase)"></a>Phases</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span>See also <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=phases.html&amp;version=8.6" class="Sq" data-pltdoc="x">General Phase Levels</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a>.</p></blockquote></blockquote></blockquote><p>The purpose of <a name="(tech._phase)"></a><span style="font-style: italic">phases</span> is to
+address the necessary separation of names defined at execution time versus
+names defined at expansion time.</p><p>A module can be <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d in multiple <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phases</span></a>. A
+phase is an integer that, like a module name, is effectively a prefix on the names
+of module-level definitions. Phase 0 is the execution-time phase.</p><p>A top-level <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>
+<a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiates</span></a> a module at <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> 0, if the module is not
+already <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d at phase 0.  A top-level
+<span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span> <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiates</span></a> a module at
+<a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> 1 (if it is not already <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d at that
+phase); <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span> also has a different binding
+effect on further program parsing, as described in
+<a href="syntax-model.html#%28part._intro-binding%29" data-pltdoc="x">Introducing Bindings</a>.</p><p>Within a module, some definitions are already shifted by a phase: the
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> form is similar to <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span>, but it
+shifts expressions and definitions by a relative <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> +1.
+Likewise, the <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-for-syntax</a></span> form is similar to <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span>,
+but shifts the definition by +1.
+Thus, if the module is <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d at phase 1,
+the variables defined with <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> are created at phase 2,
+and so on. Moreover, this relative phase acts as another layer of
+prefixing, so that <span class="RktSym">x</span> defined with <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span> and
+<span class="RktSym">x</span> defined with <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-for-syntax</a></span> can co-exist in a module
+without colliding. A <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> form can be nested
+within a <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> form, in which case the inner definitions and
+expressions are in relative <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> +2, and so on. Higher phases are
+mainly related to program parsing instead of normal evaluation.</p><p>If a module <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d at <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> <span style="font-style: italic">n</span>
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s another module, then the <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>d module is
+first <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d at phase <span style="font-style: italic">n</span>, and so on
+transitively. (Module <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s cannot form cycles.) If a
+module <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d at phase <span style="font-style: italic">n</span> <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s
+another module <span class="RktVar">M</span> <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span>, then <span class="RktVar">M</span> becomes
+<a name="(tech._available)"></a><span style="font-style: italic">available</span> at <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> <span style="font-style: italic">n+</span>1<span style="font-style: italic"></span>, and it later may be
+<a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d at <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> <span style="font-style: italic">n+</span>1<span style="font-style: italic"></span>.  If a module that is
+<a href="eval-model.html#%28tech._available%29" class="techoutside" data-pltdoc="x"><span class="techinside">available</span></a> at phase <span style="font-style: italic">n</span> (for <span style="font-style: italic">n&gt;</span>0<span style="font-style: italic"></span>) <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s
+another module <span class="RktVar">M</span> <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-template%29%29" class="RktStxLink" data-pltdoc="x">for-template</a></span>, then <span class="RktVar">M</span> becomes
+<a href="eval-model.html#%28tech._available%29" class="techoutside" data-pltdoc="x"><span class="techinside">available</span></a> at <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> <span style="font-style: italic">n-</span>1<span style="font-style: italic"></span>, and so
+on. <a href="eval-model.html#%28tech._instantiation%29" class="techoutside" data-pltdoc="x"><span class="techinside">Instantiation</span></a>s of <a href="eval-model.html#%28tech._available%29" class="techoutside" data-pltdoc="x"><span class="techinside">available</span></a> modules above
+<a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> 0 are triggered on demand as described in
+<a href="syntax-model.html#%28part._mod-parse%29" data-pltdoc="x">Module Expansion, Phases, and Visits</a>.</p><p>A final distinction among module <a href="eval-model.html#%28tech._instantiation%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiations</span></a> is that
+multiple <a href="eval-model.html#%28tech._instantiation%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiations</span></a> may exist at <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> 1 and
+higher. These <a href="eval-model.html#%28tech._instantiation%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiations</span></a> are created by the parsing of
+module forms (see <a href="syntax-model.html#%28part._mod-parse%29" data-pltdoc="x">Module Expansion, Phases, and Visits</a>), and are, again, conceptually
+distinguished by prefixes.</p><p>Top-level variables can exist in multiple phases in the same way as
+within modules. For example, <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span> within <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> creates a
+<a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> 1 variable. Furthermore, reflective operations like
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-base-namespace%29%29" class="RktValLink" data-pltdoc="x">make-base-namespace</a></span> and <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span> provide access to
+top-level variables in higher <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phases</span></a>, while module
+<a href="eval-model.html#%28tech._instantiation%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiations</span></a> (triggered by <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>) relative to such
+top-levels are in correspondingly higher <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a>s.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;separate-compilation&quot;">1.1.9.2<tt>&nbsp;</tt><a name="(part._separate-compilation)"></a>The Separate Compilation Guarantee</h5><p>When a module is compiled, its <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> 1 is instantiated. This
+can, in turn, trigger the transitive instantiation of many other
+modules at other phases, including phase 1. Racket provides a very
+strong guarantee about this instantiation called
+<a name="(idx._(gentag._0._(lib._scribblings/reference/reference..scrbl)))"></a>&ldquo;The Separate
+Compilation Guarantee&rdquo;:</p><blockquote><p>Any <a href="eval-model.html#%28tech._effect%29" class="techoutside" data-pltdoc="x"><span class="techinside">effects</span></a> of the instantiation of the module&rsquo;s phase 1 due
+to compilation on the Racket runtime system are <a href="eval-model.html#%28tech._discarded%29" class="techoutside" data-pltdoc="x"><span class="techinside">discarded</span></a>.</p></blockquote><p>The guarantee concerns <a name="(tech._effect)"></a><span style="font-style: italic">effects</span>. There are two different
+kinds of effects: internal and external.</p><p>Internal effects are exemplified by mutation.  Mutation is the action
+of a function such as <span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._set-box%21%29%29" class="RktValLink" data-pltdoc="x">set-box!</a></span>, which changes the value
+contained in the box. The modified box is not observable outside
+Racket, so the effect is said to be &ldquo;internal.&rdquo; By definition,
+internal effects are not detectable outside the Racket program.</p><p>External effects are exemplified by input/output (I/O). I/O is the
+action of a function such as <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-connect%29%29" class="RktValLink" data-pltdoc="x">tcp-connect</a></span>, which communicates
+with the operating system to send network packets outside the
+machine running Racket. The transmission of these packets is
+observable outside Racket, in particular by the receiving computer
+or any routers in between. External effects exist to be detectable
+outside the Racket program and are often detectable using physical
+processes.</p><p>An effect is <a name="(tech._discarded)"></a><span style="font-style: italic">discarded</span> when it is no longer detectable. For
+instance, the mutation of a box from <span class="RktVal">3</span> to <span class="RktVal">4</span> is
+discarded when it ceases to be detectable that it was ever changed and
+thus would still contain <span class="RktVal">3</span>. Because external effects are
+intrinsically observable outside Racket, they are irreversible and
+cannot be discarded.</p><p>Thus, The Separate Compilation Guarantee only concerns effects like
+mutation, because they are exclusively effects &ldquo;on the Racket runtime
+system&rdquo; and not &ldquo;on the physical universe.&rdquo;</p><p>There are many things a Racket program can do that appear to be
+internal effects but are actually external effects. For instance,
+<span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-set%21%29%29" class="RktValLink" data-pltdoc="x">bytes-set!</a></span> is typically an internal effect, except when the
+bytes are created by <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._make-shared-bytes%29%29" class="RktValLink" data-pltdoc="x">make-shared-bytes</a></span>, which allocates in
+space observable by other processes. Thus, effects which modify those
+bytes are not discardable, so <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-set%21%29%29" class="RktValLink" data-pltdoc="x">bytes-set!</a></span>, in this case, has an
+external effect.</p><p>The opposite is also true: some things which appear to be external are
+actually internal. For instance, if a Racket program starts multiple
+threads and uses mutation to communicate between them, that mutation
+is purely internal, because Racket&rsquo;s threads are defined entirely
+internally (they are not related to operating system threads).</p><p>Furthermore, whenever a Racket program calls an <a href="unsafe.html#%28tech._unsafe%29" class="techoutside" data-pltdoc="x"><span class="techinside">unsafe</span></a>
+function, the Racket runtime system makes no promises about its
+effects. For instance, all foreign calls use
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">ffi/unsafe</span></a>, so all foreign calls are unsafe and their
+effects cannot be discarded by Racket.</p><p>Finally, The Separate Compilation Guarantee only concerns
+instantiations at phase 1 during compilation and not all phase 1
+instantiations generally, such as when its phase 1 is required and
+used for effects via reflective mechanisms.</p><p>The practical consequence of this guarantee is that because effects
+are never visible, no module can detect whether a module it
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s is already compiled. Thus, it can never change the
+compilation of one module to have already compiled a different module.
+In particular, if module A is shared by the phase 1 portion of modules
+X and Y, then any internal effects while X is compiled are not visible
+during the compilation of Y, regardless of whether X and Y are
+compiled during the same execution of Racket&rsquo;s runtime system and
+regardless of the order of compilation.</p><p>The following set of modules demonstrate this guarantee. First, we
+define a module with the ability to observe effects via a
+<span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValLink" data-pltdoc="x">box</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValLink" data-pltdoc="x">box</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-defined-out%29%29" class="RktStxLink" data-pltdoc="x">all-defined-out</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValLink" data-pltdoc="x">box</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Next, we define two syntax transformers that use and mutate this box:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">transformers</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-defined-out%29%29" class="RktStxLink" data-pltdoc="x">all-defined-out</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">box</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">sett</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._set-box%21%29%29" class="RktValLink" data-pltdoc="x">set-box!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gett</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#`</span><span class="RktRdr">#,</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="RktValLink" data-pltdoc="x">unbox</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Next, we define a module that uses these transformers:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">user</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-defined-out%29%29" class="RktStxLink" data-pltdoc="x">all-defined-out</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">transformers</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">sett</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">gott</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gett</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Finally, we define a second module that uses these
+transformers and the <span class="RktSym">user</span> module:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">test</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">box</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">transformers</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">user</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktSym">gott</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gett</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">sett</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gett</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="RktValLink" data-pltdoc="x">unbox</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p><div class="SIntrapara">This module displays:
+</div><div class="SIntrapara"><ul><li><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">2</span><span class="hspace"></span></span>, because the <span class="RktPn">(</span><span class="RktSym">gett</span><span class="RktPn">)</span> in module <span class="RktSym">user</span> expanded to <span class="RktVal">2</span>.</p></li><li><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">0</span><span class="hspace"></span></span>, because the effects of compiling <span class="RktSym">user</span> were discarded.</p></li><li><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">2</span><span class="hspace"></span></span>, because the effect of <span class="RktPn">(</span><span class="RktSym">sett</span><span class="RktPn">)</span> inside <span class="RktSym">test</span> has
+not yet been discarded.</p></li><li><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">0</span><span class="hspace"></span></span>, because the effects of <span class="RktSym">sett</span> at
+phase 1 are irrelevant to the phase 0 use of <span class="RktSym">b</span> in <span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="RktValLink" data-pltdoc="x">unbox</a></span><span class="stt"> </span><span class="RktSym">b</span><span class="RktPn">)</span>.</p></li></ul></div></p><p>Furthermore, this display will never change, regardless of which order
+these modules are compiled in or whether they are compiled at the same
+time or separately.</p><p>In contrast, if these modules were changed to store the value of
+<span class="RktSym">b</span> in a file on the filesystem, then the program would only
+display <span class="RktInBG"><span class="hspace"></span><span class="RktIn">2</span><span class="hspace"></span></span>.</p><p>The Separate Compilation Guarantee is described in more detail
+in the paper &ldquo;Composable and Compilable Macros&rdquo; [<a href="doc-bibliography.html#%28cite._.Flatt02%29" data-pltdoc="x">Flatt02</a>], including
+informative examples. The paper &ldquo;Advanced Macrology and the
+implementation of Typed Scheme&rdquo; [<a href="doc-bibliography.html#%28cite._.Culpepper07%29" data-pltdoc="x">Culpepper07</a>] also contains an
+extended example of why it is important and how to design effectful
+syntactic extensions in its presence.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;cross-phase persistent-modules&quot;">1.1.9.3<tt>&nbsp;</tt><a name="(part._cross-phase._persistent-modules)"></a>Cross-Phase Persistent Modules</h5><p>Module declarations that fit a highly constrained
+form&#8212;<wbr></wbr>including a
+<span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._~23~25declare%29%29" class="RktStxLink" data-pltdoc="x">#%declare</a></span><span class="stt"> </span><span class="RktPn">#:cross-phase-persistent</span><span class="RktPn">)</span> form in the
+module body&#8212;<wbr></wbr>create <a name="(tech._cross._phase._persistent)"></a><span style="font-style: italic">cross-phase persistent</span>
+modules. A <a href="eval-model.html#%28tech._cross._phase._persistent%29" class="techoutside" data-pltdoc="x"><span class="techinside">cross-phase persistent</span></a> module&rsquo;s
+instantiations across all phases share the variables
+produced by the first instantiation of the module.
+Additionally, <a href="eval-model.html#%28tech._cross._phase._persistent%29" class="techoutside" data-pltdoc="x"><span class="techinside">cross-phase persistent</span></a> module
+instantiations persist across <a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module registries</span></a> when
+they share a common module declaration.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cross</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#%kernel</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._~23~25declare%29%29" class="RktStxLink" data-pltdoc="x">#%declare</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:cross-phase-persistent</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25provide%29%29" class="RktStxLink" data-pltdoc="x">#%provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._gensym%29%29" class="RktValLink" data-pltdoc="x">gensym</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">noncross</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#%kernel</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25provide%29%29" class="RktStxLink" data-pltdoc="x">#%provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._gensym%29%29" class="RktValLink" data-pltdoc="x">gensym</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ns</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">same-instance?</span><span class="hspace">&nbsp;</span><span class="RktSym">mod</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%29%29" class="RktValLink" data-pltdoc="x">namespace-require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mod</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-base-namespace%29%29" class="RktValLink" data-pltdoc="x">make-base-namespace</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-attach-module-declaration%29%29" class="RktValLink" data-pltdoc="x">namespace-attach-module-declaration</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ns</span><span class="hspace">&nbsp;</span><span class="RktSym">mod</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%29%29" class="RktValLink" data-pltdoc="x">namespace-require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mod</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-variable-value%29%29" class="RktValLink" data-pltdoc="x">namespace-variable-value</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-base-namespace%29%29" class="RktValLink" data-pltdoc="x">make-base-namespace</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-attach-module-declaration%29%29" class="RktValLink" data-pltdoc="x">namespace-attach-module-declaration</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ns</span><span class="hspace">&nbsp;</span><span class="RktSym">mod</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%29%29" class="RktValLink" data-pltdoc="x">namespace-require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mod</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-variable-value%29%29" class="RktValLink" data-pltdoc="x">namespace-variable-value</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">same-instance?</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">noncross</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">same-instance?</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">cross</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p>The intent of a <a href="eval-model.html#%28tech._cross._phase._persistent%29" class="techoutside" data-pltdoc="x"><span class="techinside">cross-phase persistent</span></a> module is to support values that are
+recognizable after <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> crossings. For example, when a macro
+transformer running in phase 1 raises a syntax error as represented by
+an <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax</a></span> instance, the instance is recognizable by a
+phase-0 exception handler wrapping a call to <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span> or
+<span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand%29%29" class="RktValLink" data-pltdoc="x">expand</a></span> that triggered the syntax error, because the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax</a></span> structure type is defined by a
+<a href="eval-model.html#%28tech._cross._phase._persistent%29" class="techoutside" data-pltdoc="x"><span class="techinside">cross-phase persistent</span></a> module.</p><p>A <a href="eval-model.html#%28tech._cross._phase._persistent%29" class="techoutside" data-pltdoc="x"><span class="techinside">cross-phase persistent</span></a> module imports only other <a href="eval-model.html#%28tech._cross._phase._persistent%29" class="techoutside" data-pltdoc="x"><span class="techinside">cross-phase persistent</span></a> modules,
+and it contains only definitions that bind variables to functions,
+structure types and related functions, or structure-type properties
+and related functions. A <a href="eval-model.html#%28tech._cross._phase._persistent%29" class="techoutside" data-pltdoc="x"><span class="techinside">cross-phase persistent</span></a> module never includes syntax
+literals (via <span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span>) or variable references (via
+<span class="RktSym"><a href="Locations____variable-reference.html#%28form._%28%28quote._~23~25kernel%29._~23~25variable-reference%29%29" class="RktStxLink" data-pltdoc="x">#%variable-reference</a></span>). See <a href="syntax-model.html#%28part._cross-phase._persistent-grammar%29" data-pltdoc="x">Cross-Phase Persistent Module Declarations</a> for
+the syntactic specification of a <a href="eval-model.html#%28tech._cross._phase._persistent%29" class="techoutside" data-pltdoc="x"><span class="techinside">cross-phase persistent</span></a> module
+declaration.</p><p>A documented module should be assumed non&ndash;<a href="eval-model.html#%28tech._cross._phase._persistent%29" class="techoutside" data-pltdoc="x"><span class="techinside">cross-phase persistent</span></a> unless it
+is specified as <a href="eval-model.html#%28tech._cross._phase._persistent%29" class="techoutside" data-pltdoc="x"><span class="techinside">cross-phase persistent</span></a> (such as
+<a href="Kernel_Forms_and_Functions.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/kernel</span></a>).</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;module-redeclare&quot;">1.1.9.4<tt>&nbsp;</tt><a name="(part._module-redeclare)"></a><a name="(idx._(gentag._1._(lib._scribblings/reference/reference..scrbl)))"></a>Module Redeclarations</h5><p>When a module is declared using a name with which a module is already
+declared, the new declaration&rsquo;s definitions replace and extend the old
+declarations. If a variable in the old declaration has no counterpart
+in the new declaration, the old variable continues to exist, but its
+binding is not included in the <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> for the
+module body. If a new variable definition has a counterpart in the old
+declaration, it effectively assigns to the old variable.</p><p>If a module is <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d in the current namespace&rsquo;s
+<a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a> before the module is redeclared, the redeclaration
+of the module is immediately <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d in that
+<a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a>.</p><p>If the current <a href="inspectors.html#%28tech._inspector%29" class="techoutside" data-pltdoc="x"><span class="techinside">inspector</span></a> does not manage a module&rsquo;s declaration
+inspector (see <a href="modprotect.html" data-pltdoc="x">Code Inspectors</a>), then the module cannot be
+redeclared. Similarly, a <a href="eval-model.html#%28tech._cross._phase._persistent%29" class="techoutside" data-pltdoc="x"><span class="techinside">cross-phase persistent</span></a> module cannot be redeclared.
+Even if redeclaration succeeds, instantiation of a module that is
+previously instantiated may fail if instantiation for the
+redeclaration attempts to modify variables that are constant (see
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-enforce-module-constants%29%29" class="RktValLink" data-pltdoc="x">compile-enforce-module-constants</a></span>).</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;submodules&quot;">1.1.9.5<tt>&nbsp;</tt><a name="(part._submodules)"></a>Submodules</h5><p>A <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> or <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> form within a top-level
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> form declares a <a name="(tech._submodule)"></a><span style="font-style: italic">submodule</span>. A submodule is
+accessed relative to its enclosing module, usually with a
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxLink" data-pltdoc="x">submod</a></span> path. Submodules can be nested to any depth.</p><p>Although a submodule is lexically nested within a module, it cannot
+necessarily access the bindings of its enclosing module directly.
+More specifically, a submodule declared with <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> cannot
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> from its enclosing module, but the enclosing module
+can <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> the submodule. In contrast, a submodule declared
+with <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> conceptually follows its enclosing module, so
+can <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> from its enclosing module, but the enclosing
+module cannot <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> the submodule. Unless a submodule
+imports from its enclosing module or vice versa, then <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visits</span></a> or
+<a href="eval-model.html#%28tech._instantiation%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiations</span></a> of the two modules are independent, and their
+implementations may even be loaded from bytecode sources at different times.</p><p>A submodule declared with <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> can import any preceding
+submodule declared with <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>. A submodule declared with
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> can import any preceding module declared with
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> and any submodule declared with <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>.</p><p>When a submodule declaration has the form <span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span><span class="stt"> </span><span class="RktVar">name</span><span class="stt"> </span><span class="RktVal">#f</span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span>, then all of the bindings of the enclosing module&rsquo;s bodies are
+visible in the submodule&rsquo;s body, and the submodule implicitly imports
+the enclosing module. The submodule can <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> any bindings
+that it inherits from its enclosing module.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;mark-model&quot;">1.1.10<tt>&nbsp;</tt><a name="(part._mark-model)"></a>Continuation Frames and Marks</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span>See <a href="contmarks.html" data-pltdoc="x">Continuation Marks</a> for continuation-mark forms and functions.</p></blockquote></blockquote></blockquote><p>Every continuation <span class="RktVar">C</span> can be partitioned into
+<a name="(tech._continuation._frame)"></a><span style="font-style: italic">continuation frames</span> <span class="RktVar">C<span style="vertical-align: sub; font-size: 80%">1</span></span>, <span class="RktVar">C<span style="vertical-align: sub; font-size: 80%">2</span></span>, ..., <span class="RktVar">C<span style="vertical-align: sub; font-size: 80%">n</span></span>
+such that <span class="RktVar">C</span> = <span class="RktVar">C<span style="vertical-align: sub; font-size: 80%">1</span></span>[<span class="RktVar">C<span style="vertical-align: sub; font-size: 80%">2</span></span>[...[<span class="RktVar">C<span style="vertical-align: sub; font-size: 80%">n</span></span>]]], and no frame <span class="RktVar">C<span style="vertical-align: sub; font-size: 80%">i</span></span> can be itself partitioned
+into smaller continuations. Evaluation steps add frames to and remove frames from
+the current continuation, typically one at a time.</p><p>Each frame is conceptually annotated with a set of
+<a name="(tech._continuation._mark)"></a><span style="font-style: italic">continuation marks</span>. A mark consists of a key and its value.
+The key is an arbitrary value, and each frame includes at most one
+mark for any given key. Various operations set and extract marks from
+continuations, so that marks can be used to attach information to a
+<a href="eval-model.html#%28tech._dynamic._extent%29" class="techoutside" data-pltdoc="x"><span class="techinside">dynamic extent</span></a>. For example, marks can be used to record information
+for a &ldquo;stack trace&rdquo; to be presented when an exception is raised, or
+to implement dynamic scope.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;prompt-model&quot;">1.1.11<tt>&nbsp;</tt><a name="(part._prompt-model)"></a>Prompts, Delimited Continuations, and Barriers</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span>See <a href="cont.html" data-pltdoc="x">Continuations</a> for continuation and prompt functions.</p></blockquote></blockquote></blockquote><p>A <a name="(tech._prompt)"></a><span style="font-style: italic">prompt</span> is a special kind of continuation frame that is
+annotated with a specific <a name="(tech._prompt._tag)"></a><span style="font-style: italic">prompt tag</span> (essentially a
+<a href="eval-model.html#%28tech._continuation._mark%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation mark</span></a>). Various operations allow the capture of frames in
+the continuation from the redex position out to the nearest enclosing
+prompt with a particular prompt tag; such a continuation is sometimes
+called a <a name="(tech._delimited._continuation)"></a><span style="font-style: italic">delimited continuation</span>. Other operations allow the
+current continuation to be extended with a captured continuation
+(specifically, a <a name="(tech._composable._continuation)"></a><span style="font-style: italic">composable continuation</span>). Yet other
+operations abort the computation to the nearest enclosing prompt with
+a particular tag, or replace the continuation to the nearest enclosing
+prompt with another one. When a delimited continuation is captured,
+the marks associated with the relevant frames are also captured.</p><p>A <a name="(tech._continuation._barrier)"></a><span style="font-style: italic">continuation barrier</span> is another kind of continuation frame
+that prohibits certain replacements of the current continuation with
+another. Specifically, a continuation can be replaced by another only
+when the replacement does not introduce any continuation barriers.
+A continuation barrier
+thus prevents &ldquo;downward jumps&rdquo; into a continuation that is protected
+by a barrier. Certain operations install barriers automatically; in
+particular, when an exception handler is called, a continuation
+barrier prohibits the continuation of the handler from capturing the
+continuation past the exception point.</p><p>An <a name="(tech._escape._continuation)"></a><span style="font-style: italic">escape continuation</span> is essentially a derived concept. It
+combines a prompt for escape purposes with a continuation for
+mark-gathering purposes. As the name implies, escape continuations are
+used only to abort to the point of capture.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;thread-model&quot;">1.1.12<tt>&nbsp;</tt><a name="(part._thread-model)"></a>Threads</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span>See <a href="concurrency.html" data-pltdoc="x">Concurrency and Parallelism</a> for thread and synchronization functions.</p></blockquote></blockquote></blockquote><p>Racket supports multiple <a name="(tech._thread)"></a><span style="font-style: italic">threads</span> of evaluation.  Threads run
+concurrently, in the sense that one thread can preempt another without
+its cooperation, but threads currently all run on the same processor
+(i.e., the same underlying operating system process and thread).</p><p>Threads are created explicitly by functions such as <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span>.
+In terms of the evaluation model, each step in evaluation
+actually deals with multiple concurrent
+expressions, up to one per thread, rather than a single expression. The expressions all
+share the same objects and top-level variables, so that they can
+communicate through shared state, and <span style="font-style: italic">sequential consistency</span> [<a href="doc-bibliography.html#%28cite._.Lamport79%29" data-pltdoc="x">Lamport79</a>] is
+guaranteed (i.e., the result is consistent with some global sequence
+imposed on all evaluation steps across threads). Most evaluation steps involve a
+single step in a single thread, but certain synchronization
+primitives require multiple threads to progress together in one step; for example,
+an exchange of a value through a <a href="channel.html#%28tech._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">channel</span></a> progresses in two
+threads simultaneously.</p><p>Unless otherwise noted, all constant-time procedures and operations
+provided by Racket are thread-safe in the sense that they are
+<span style="font-style: italic">atomic</span>: they happen as a single evaluation step.
+For example, <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span> assigns to a variable as an atomic action
+with respect to all threads, so that no thread can see a
+&ldquo;half-assigned&rdquo; variable. Similarly, <span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="RktValLink" data-pltdoc="x">vector-set!</a></span> assigns to
+a vector atomically. Note that the evaluation of a <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>
+expression with its subexpression is not necessarily atomic, because
+evaluating the subexpression involves a separate step of evaluation.
+Only the assignment action itself (which takes after the subexpression
+is evaluated to obtain a value) is atomic. Similarly, a procedure
+application can involve multiple steps that are not atomic, even if
+the procedure itself performs an atomic action.</p><p>The <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%21%29%29" class="RktValLink" data-pltdoc="x">hash-set!</a></span> procedure is not atomic, but the table is
+protected by a lock; see <a href="hashtables.html" data-pltdoc="x">Hash Tables</a> for more information.
+Port operations are generally not atomic, but they are thread-safe in
+the sense that a byte consumed by one thread from an input port will
+not be returned also to another thread, and procedures like
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-commit-peeked%29%29" class="RktValLink" data-pltdoc="x">port-commit-peeked</a></span> and <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail</a></span> offer
+specific concurrency guarantees.</p><p>In addition to the state that is shared among all threads, each thread
+has its own private state that is accessed through <a name="(tech._thread._cell)"></a><span style="font-style: italic">thread
+cells</span>. A thread cell is similar to a normal mutable object, but a
+change to the value inside a thread cell is seen only when extracting
+a value from that cell in the same thread. A thread cell can be
+<a name="(tech._preserved)"></a><span style="font-style: italic">preserved</span>; when a new thread is created, the creating
+thread&rsquo;s value for a preserved thread cell serves as the initial value
+for the cell in the created thread. For a non-preserved thread cell, a
+new thread sees the same initial value (specified when the thread cell
+is created) as all other threads.</p><p><a href="futures.html#%28tech._future%29" class="techoutside" data-pltdoc="x"><span class="techinside">Futures</span></a> and <a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">places</span></a> offer different kinds of concurrency
+and parallelism, and they have weaker guarantees about shared state.
+(Places can share state through functions like
+<span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._make-shared-bytes%29%29" class="RktValLink" data-pltdoc="x">make-shared-bytes</a></span>.) Each thread of evaluation in a future or
+place is constrained to behave consistent with the possibility of some
+other thread that might inspect any shared data starting at any point
+that a future or place starts. In the case that two futures or two
+places share state, each read or write operation to shared state
+corresponds to a read or write operation at the virtual-memory level,
+and the operations are constrained to the order they could be observed
+or affected by a thread. However, Racket does not enforce additional
+guarantees about reordering that might be performed at the
+virtual-memory level or below, except in the case of operations that
+specify such guarantees explicitly (e.g., <span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box-cas%21%29%29" class="RktValLink" data-pltdoc="x">box-cas!</a></span>).</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parameter-model&quot;">1.1.13<tt>&nbsp;</tt><a name="(part._parameter-model)"></a>Parameters</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span>See <a href="parameters.html" data-pltdoc="x">Parameters</a> for parameter forms and functions.</p></blockquote></blockquote></blockquote><p><a name="(tech._parameter)"></a><span style="font-style: italic">Parameters</span> are essentially a derived concept in Racket; they
+are defined in terms of <a href="eval-model.html#%28tech._continuation._mark%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation marks</span></a> and <a href="eval-model.html#%28tech._thread._cell%29" class="techoutside" data-pltdoc="x"><span class="techinside">thread
+cells</span></a>. However, parameters are also &ldquo;built in,&rdquo; due to the fact that some
+primitive procedures consult parameter values. For example, the
+default output stream for primitive output operations is specified by
+a parameter.</p><p>A parameter is a setting that is both thread-specific and
+continuation-specific. In the empty continuation, each parameter
+corresponds to a <a href="eval-model.html#%28tech._preserved%29" class="techoutside" data-pltdoc="x"><span class="techinside">preserved</span></a> <a href="eval-model.html#%28tech._thread._cell%29" class="techoutside" data-pltdoc="x"><span class="techinside">thread cell</span></a>; a corresponding
+<a name="(tech._parameter._procedure)"></a><span style="font-style: italic">parameter procedure</span> accesses and sets the thread cell&rsquo;s
+value for the current thread.</p><p>In a non-empty continuation, a parameter&rsquo;s value is determined through
+a <a name="(tech._parameterization)"></a><span style="font-style: italic">parameterization</span> that is associated with the nearest
+enclosing continuation frame via a continuation mark (whose key is
+not directly accessible). A parameterization maps each parameter to a
+preserved thread cell, and the combination of the thread cell and the current
+thread yields the parameter&rsquo;s value. A <a href="eval-model.html#%28tech._parameter._procedure%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter procedure</span></a> sets or
+accesses the relevant thread cell for its parameter.</p><p>Various operations, such as <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span> or
+<span class="RktSym"><a href="parameters.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call-with-parameterization%29%29" class="RktValLink" data-pltdoc="x">call-with-parameterization</a></span>, install a parameterization into
+the current continuation&rsquo;s frame.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;exn-model&quot;">1.1.14<tt>&nbsp;</tt><a name="(part._exn-model)"></a>Exceptions</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span>See <a href="exns.html" data-pltdoc="x">Exceptions</a> for exception forms, functions, and types.</p></blockquote></blockquote></blockquote><p><a name="(tech._exception)"></a><span style="font-style: italic">Exceptions</span> are essentially a derived concept in Racket; they
+are defined in terms of continuations, prompts, and continuation
+marks.  However, exceptions are also &ldquo;built in,&rdquo; due to the fact that
+primitive forms and procedures may raise exceptions.</p><p>An <a name="(tech._exception._handler)"></a><span style="font-style: italic">exception handler</span> to <a name="(tech._catch)"></a><span style="font-style: italic">catch</span> exceptions can be associated
+with a continuation frame though a <a href="eval-model.html#%28tech._continuation._mark%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation mark</span></a> (whose key
+is not directly accessible). When an exception is raised, the current
+continuation&rsquo;s marks determine a chain of <a href="eval-model.html#%28tech._exception._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">exception handler</span></a>
+procedures that are consulted to handle the exception.
+A handler for uncaught exceptions is designated through a built-in <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a>.</p><p>One potential action of an <a href="eval-model.html#%28tech._exception._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">exception handler</span></a> is to abort the
+current <a href="eval-model.html#%28tech._continuation%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation</span></a> up to an enclosing <a href="eval-model.html#%28tech._prompt%29" class="techoutside" data-pltdoc="x"><span class="techinside">prompt</span></a> with a
+particular <a href="eval-model.html#%28tech._prompt._tag%29" class="techoutside" data-pltdoc="x"><span class="techinside">prompt tag</span></a>.  The default handler for uncaught
+exceptions, in particular, aborts to a particular tag for which a
+prompt is always present, because the prompt is installed in the
+outermost frame of the continuation for any new thread.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;custodian-model&quot;">1.1.15<tt>&nbsp;</tt><a name="(part._custodian-model)"></a>Custodians</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span>See <a href="custodians.html" data-pltdoc="x">Custodians</a> for custodian functions.</p></blockquote></blockquote></blockquote><p>A <a name="(tech._custodian)"></a><span style="font-style: italic">custodian</span> manages a collection of threads,
+<a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file-stream ports</span></a>, TCP ports, <a href="tcp.html#%28tech._tcp._listener%29" class="techoutside" data-pltdoc="x"><span class="techinside">TCP listeners</span></a>, <a href="udp.html#%28tech._udp._socket%29" class="techoutside" data-pltdoc="x"><span class="techinside">UDP
+sockets</span></a>, <a href="bytestrings.html#%28tech._byte._converter%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte converters</span></a>, and <a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">places</span></a>.  Whenever a thread, etc<span class="Sendabbrev">.</span>, is
+created, it is placed under the management of the <a name="(tech._current._custodian)"></a><span style="font-style: italic">current
+custodian</span> as determined by the <span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._current-custodian%29%29" class="RktValLink" data-pltdoc="x">current-custodian</a></span>
+<a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Custodians also manage eventspaces from
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/gui/base</span></a>.</p></blockquote></blockquote></blockquote><p>Except for the root custodian, every <a href="eval-model.html#%28tech._custodian%29" class="techoutside" data-pltdoc="x"><span class="techinside">custodian</span></a> itself is
+managed by a <a href="eval-model.html#%28tech._custodian%29" class="techoutside" data-pltdoc="x"><span class="techinside">custodian</span></a>, so that custodians form a hierarchy.
+Every object managed by a subordinate custodian is also managed by the
+custodian&rsquo;s owner.</p><p>When a <a href="eval-model.html#%28tech._custodian%29" class="techoutside" data-pltdoc="x"><span class="techinside">custodian</span></a> is shut down via
+<span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-shutdown-all%29%29" class="RktValLink" data-pltdoc="x">custodian-shutdown-all</a></span>, it forcibly and immediately closes
+the ports, TCP connections, etc<span class="Sendabbrev">.</span>, that it manages, as well as
+terminating (or suspending) its threads. A custodian that has been
+shut down cannot manage new objects.  After the current custodian is shut
+down, if a procedure is called that attempts to create a managed resource (e.g.,
+<span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-input-file%29%29" class="RktValLink" data-pltdoc="x">open-input-file</a></span>, <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span>), then the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>A thread can have multiple managing custodians, and a suspended thread
+created with <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%2Fsuspend-to-kill%29%29" class="RktValLink" data-pltdoc="x">thread/suspend-to-kill</a></span> can have zero
+custodians. Extra custodians become associated with a thread through
+<span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-resume%29%29" class="RktValLink" data-pltdoc="x">thread-resume</a></span> (see <a href="threads.html#%28part._threadkill%29" data-pltdoc="x">Suspending, Resuming, and Killing Threads</a>). When a thread
+has multiple custodians, it is not necessarily killed by a
+<span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-shutdown-all%29%29" class="RktValLink" data-pltdoc="x">custodian-shutdown-all</a></span>. Instead, shut-down custodians are removed
+from the thread&rsquo;s managing custodian set, and the thread is killed when its
+managing set becomes empty.</p><p>The values managed by a custodian are semi-weakly held by the
+custodian: a <a href="willexecutor.html#%28tech._will%29" data-pltdoc="x">will</a> can be executed for a value that is
+managed by a custodian; in addition, weak references via weak
+<a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash tables</span></a>, <a href="ephemerons.html#%28tech._ephemeron%29" class="techoutside" data-pltdoc="x"><span class="techinside">ephemerons</span></a>, or <a href="weakbox.html#%28tech._weak._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">weak box</span></a>es can be
+dropped on the <a href="implementations.html#%28tech._bc%29" class="techoutside" data-pltdoc="x"><span class="techinside">BC</span></a> implementation of Racket, but not on the <a href="implementations.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a>
+implementation. For all variants, a custodian only weakly
+references its subordinate custodians; if a subordinate custodian is
+unreferenced but has its own subordinates, then the custodian may be
+garbage collected, at which point its subordinates become immediately
+subordinate to the collected custodian&rsquo;s superordinate (owner) custodian.</p><p>In addition to the other entities managed by a custodian, a
+<a name="(tech._custodian._box)"></a><span style="font-style: italic">custodian box</span> created with <span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._make-custodian-box%29%29" class="RktValLink" data-pltdoc="x">make-custodian-box</a></span>
+strongly holds onto a value placed in the box until the box&rsquo;s
+custodian is shut down. However, the custodian only weakly retains the box
+itself, so the box and its content can be collected if there
+are no other references to them.</p><p>When Racket is compiled with support for per-custodian memory
+accounting (see <span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-memory-accounting-available~3f%29%29" class="RktValLink" data-pltdoc="x">custodian-memory-accounting-available?</a></span>), the
+<span class="RktSym"><a href="garbagecollection.html#%28def._%28%28quote._~23~25kernel%29._current-memory-use%29%29" class="RktValLink" data-pltdoc="x">current-memory-use</a></span> procedure can report a custodian-specific
+result.  This result determines how much memory is occupied by objects
+that are <a href="eval-model.html#%28tech._reachable%29" class="techoutside" data-pltdoc="x"><span class="techinside">reachable</span></a> from the custodian&rsquo;s managed values, especially its
+threads, and including its sub-custodians&rsquo; managed values. If an
+object is reachable from two custodians where neither is an ancestor
+of the other, an object is arbitrarily charged to one or the other,
+and the choice can change after each collection; objects reachable
+from both a custodian and its descendant, however, are reliably
+charged to the custodian and not to the descendants, unless the
+custodian can reach the objects only through a descendant custodian or
+a descendant&rsquo;s thread.  Reachability for per-custodian accounting does
+not include weak references, references to threads managed by other
+custodians, references to other custodians, or references to custodian
+boxes for other custodians.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="model.html" title="backward to &quot;1 Language Model&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="model.html" title="up to &quot;1 Language Model&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="syntax-model.html" title="forward to &quot;1.2 Syntax Model&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/eval.html b/clones/docs.racket-lang.org/reference/eval.html
new file mode 100644
index 00000000..d08369d8
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/eval.html
@@ -0,0 +1,347 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14.2&nbsp;Evaluation and Compilation</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewselflink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Namespaces.html" class="tocviewlink" data-pltdoc="x">Namespaces</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="eval.html" class="tocviewselflink" data-pltdoc="x">Evaluation and Compilation</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="load-lang.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>load</span></span> Language</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="Module_Names_and_Loading.html" class="tocviewlink" data-pltdoc="x">Module Names and Loading</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="chaperones.html" class="tocviewlink" data-pltdoc="x">Impersonators and Chaperones</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="securityguards.html" class="tocviewlink" data-pltdoc="x">Security Guards</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="custodians.html" class="tocviewlink" data-pltdoc="x">Custodians</a></td></tr><tr><td align="right">14.8&nbsp;</td><td><a href="threadgroups.html" class="tocviewlink" data-pltdoc="x">Thread Groups</a></td></tr><tr><td align="right">14.9&nbsp;</td><td><a href="inspectors.html" class="tocviewlink" data-pltdoc="x">Structure Inspectors</a></td></tr><tr><td align="right">14.10&nbsp;</td><td><a href="modprotect.html" class="tocviewlink" data-pltdoc="x">Code Inspectors</a></td></tr><tr><td align="right">14.11&nbsp;</td><td><a href="plumbers.html" class="tocviewlink" data-pltdoc="x">Plumbers</a></td></tr><tr><td align="right">14.12&nbsp;</td><td><a href="Sandboxed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Sandboxed Evaluation</a></td></tr><tr><td align="right">14.13&nbsp;</td><td><a href="repl-module.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>repl</span></span> Library</a></td></tr><tr><td align="right">14.14&nbsp;</td><td><a href="linklets.html" class="tocviewlink" data-pltdoc="x">Linklets and the Core Compiler</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-eval%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>eval</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eval</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval-syntax%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eval-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>load</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">load</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._load-relative%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">load-<wbr></wbr>relative</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._load%2Fcd%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">load/<span class="mywbr"> &nbsp;</span>cd</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-extension%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>load-<wbr></wbr>extension</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load-extension%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">load-<wbr></wbr>extension</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._load-relative-extension%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">load-<wbr></wbr>relative-<wbr></wbr>extension</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load%2Fuse-compiled%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>load/<span class="mywbr"> &nbsp;</span>use-<wbr></wbr>compiled</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%2Fuse-compiled%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">load/<span class="mywbr"> &nbsp;</span>use-<wbr></wbr>compiled</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>load-<wbr></wbr>relative-<wbr></wbr>directory</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._use-compiled-file-paths%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">use-<wbr></wbr>compiled-<wbr></wbr>file-<wbr></wbr>paths</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compiled-file-roots%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>compiled-<wbr></wbr>file-<wbr></wbr>roots</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._find-compiled-file-roots%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">find-<wbr></wbr>compiled-<wbr></wbr>file-<wbr></wbr>roots</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._use-compiled-file-check%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">use-<wbr></wbr>compiled-<wbr></wbr>file-<wbr></wbr>check</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._read-eval-print-loop%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>eval-<wbr></wbr>print-<wbr></wbr>loop</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-prompt-read%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>prompt-<wbr></wbr>read</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-get-interaction-input-port%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>get-<wbr></wbr>interaction-<wbr></wbr>input-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-get-interaction-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>get-<wbr></wbr>interaction-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-read-interaction%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>read-<wbr></wbr>interaction</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-print%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>print</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>compile</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compile</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-syntax%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compile-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compiled-expression-recompile%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compiled-<wbr></wbr>expression-<wbr></wbr>recompile</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compiled-expression~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compiled-<wbr></wbr>expression?</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-enforce-module-constants%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compile-<wbr></wbr>enforce-<wbr></wbr>module-<wbr></wbr>constants</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-allow-set%21-undefined%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compile-<wbr></wbr>allow-<wbr></wbr>set!-<wbr></wbr>undefined</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-context-preservation-enabled%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compile-<wbr></wbr>context-<wbr></wbr>preservation-<wbr></wbr>enabled</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile-target-machine%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>compile-<wbr></wbr>target-<wbr></wbr>machine</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-target-machine~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compile-<wbr></wbr>target-<wbr></wbr>machine?</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile-realm%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>compile-<wbr></wbr>realm</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval-jit-enabled%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eval-<wbr></wbr>jit-<wbr></wbr>enabled</span></span></a></td></tr><tr><td><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load-on-demand-enabled%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">load-<wbr></wbr>on-<wbr></wbr>demand-<wbr></wbr>enabled</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Namespaces.html" title="backward to &quot;14.1 Namespaces&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="load-lang.html" title="forward to &quot;14.3 The racket/load Language&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;eval&quot;">14.2<tt>&nbsp;</tt><a name="(part._eval)"></a>Evaluation and Compilation</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=reflection.html&amp;version=8.6" class="Sq" data-pltdoc="x">Reflection and Dynamic Evaluation</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces dynamic evaluation.</p></blockquote></blockquote></blockquote><p>Racket provides programmatic control over evaluation through
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span> and related functions. See <a href="compiler.html" data-pltdoc="x">Controlling and Inspecting Compilation</a> for
+information about extra-linguistic facilities related to the Racket
+compiler.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-eval))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-eval%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-eval</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-eval%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-eval</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the current <a name="(tech._evaluation._handler)"></a><span style="font-style: italic">evaluation handler</span>.
+The evaluation handler is a procedure that takes a top-level form and
+evaluates it, returning the resulting values. The <a href="eval.html#%28tech._evaluation._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">evaluation
+handler</span></a> is called by <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span>, <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval-syntax%29%29" class="RktValLink" data-pltdoc="x">eval-syntax</a></span>, the default
+<a href="eval.html#%28tech._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">load handler</span></a>, and <span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._read-eval-print-loop%29%29" class="RktValLink" data-pltdoc="x">read-eval-print-loop</a></span> to evaluate a
+top-level form. The handler should evaluate its argument in tail
+position.</div></p><p>The <span class="RktVar">top-level-form</span> provided to the handler can be a
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>, a compiled form, a compiled form wrapped as a
+syntax object, or an arbitrary datum.</p><p>The default handler converts an arbitrary datum to a syntax object
+using <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span>, and then enriches its <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical
+information</span></a> in the same way as <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span>. (If
+<span class="RktVar">top-level-form</span> is a syntax object, then its <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical
+information</span></a> is not enriched.)  The default evaluation handler
+partially expands the form to splice the body of top-level
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> forms into the top level (see
+<span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand-to-top-form%29%29" class="RktValLink" data-pltdoc="x">expand-to-top-form</a></span>), and then individually compiles and
+evaluates each spliced form before continuing to expand, compile, and
+evaluate later forms.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._eval))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValDef RktValLink" data-pltdoc="x">eval</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">top-level-form</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">namespace</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">top-level-form</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">namespace</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span>See also <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=eval.html%23%2528part._namespaces%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Namespaces</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a>.</p></blockquote></blockquote></blockquote></div></p><p>Calls the current <a href="eval.html#%28tech._evaluation._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">evaluation handler</span></a> to evaluate
+<span class="RktVar">top-level-form</span>. The <a href="eval.html#%28tech._evaluation._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">evaluation handler</span></a> is called in
+tail position with respect to the <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span> call, and
+<span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>d to set <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span> to
+<span class="RktVar">namespace</span>.</p><p>If <span class="RktVar">top-level-form</span> is a syntax object whose datum is not a
+compiled form, then its <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> is enriched before
+it is sent to the <a href="eval.html#%28tech._evaluation._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">evaluation handler</span></a>:</p><ul><li><p>If <span class="RktVar">top-level-form</span> is a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is a
+symbol or identifier, and if applying
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-syntax-introduce%29%29" class="RktValLink" data-pltdoc="x">namespace-syntax-introduce</a></span> to the
+(<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span>-converted) identifier produces an
+identifier bound to <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> in a <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>
+that corresponds to <span class="RktVar">namespace</span>&rsquo;s <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a>,
+then only that identifier is enriched.</p></li><li><p>For any other <span class="RktVar">top-level-form</span>,
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-syntax-introduce%29%29" class="RktValLink" data-pltdoc="x">namespace-syntax-introduce</a></span> is applied to the entire
+syntax object.</p></li></ul><p>For interactive evaluation in the style of
+<span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._read-eval-print-loop%29%29" class="RktValLink" data-pltdoc="x">read-eval-print-loop</a></span> and <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%29%29" class="RktValLink" data-pltdoc="x">load</a></span>, wrap each expression
+with <span class="RktSym">#%top-interaction</span>, which is normally bound to
+<span class="RktSym"><a href="__top-interaction.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25top-interaction%29%29" class="RktStxLink" data-pltdoc="x">#%top-interaction</a></span>, before passing it to <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._eval-syntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval-syntax%29%29" class="RktValDef RktValLink" data-pltdoc="x">eval-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">namespace</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">namespace</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace~3f%29%29" class="RktValLink" data-pltdoc="x">namespace?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span>, except that <span class="RktVar">stx</span> must be a syntax object,
+and its lexical context is not enriched before it is passed to the
+<a href="eval.html#%28tech._evaluation._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">evaluation handler</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-load))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-load</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._non-empty-listof%29%29" class="RktValLink" data-pltdoc="x">non-empty-listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-load</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._non-empty-listof%29%29" class="RktValLink" data-pltdoc="x">non-empty-listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the current <a name="(tech._load._handler)"></a><span style="font-style: italic">load handler</span> to load
+top-level forms from a file. The <a href="eval.html#%28tech._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">load handler</span></a> is called by
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%29%29" class="RktValLink" data-pltdoc="x">load</a></span>, <span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._load-relative%29%29" class="RktValLink" data-pltdoc="x">load-relative</a></span>, <span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._load%2Fcd%29%29" class="RktValLink" data-pltdoc="x">load/cd</a></span>, and the
+default <a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a>.</div></p><p>A load handler takes two arguments: a path (see <a href="pathutils.html" data-pltdoc="x">Paths</a>)
+and an expected module name. The expected module name is a symbol or a
+list when the call is to load a module declaration in response to a
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> (in which case the file should contain a module
+declaration), or <span class="RktVal">#f</span> for any other load.</p><p>When loading a module from a stream that starts with a compiled module
+that contains submodules, the load handler should load only the
+requested module, where a symbol as the load handler&rsquo;s indicates the
+root module and a list indicates a submodule whose path relative to
+the root module is given by the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> of the list. The list
+starts with <span class="RktVal">#f</span> when a submodule should be loaded <span class="emph">only</span>
+if it can be loaded independently (i.e., from compiled form&#8212;<wbr></wbr>never
+from source); if the submodule cannot be loaded independently, the
+load handler should return without loading from a file. When the
+expected module name is a list that starts with a symbol, the root
+module and any other submodules can be loaded from the given file,
+which might be from source, and the load handler still should not
+complain if the expected submodule is not found.
+When loading modules from a nonexistent source file, the load handler
+may raise an exception regardless of whether submodules are
+requested or not.</p><p>The default load handler reads forms from the file in
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode with line-counting enabled for the file
+port, unless the path has a <span class="RktVal">".zo"</span> suffix. It also
+<span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>s each read to set <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-compiled%29%29" class="RktValLink" data-pltdoc="x">read-accept-compiled</a></span>,
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-reader%29%29" class="RktValLink" data-pltdoc="x">read-accept-reader</a></span>, and <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-lang%29%29" class="RktValLink" data-pltdoc="x">read-accept-lang</a></span> to
+<span class="RktVal">#t</span>. In addition, if <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load-on-demand-enabled%29%29" class="RktValLink" data-pltdoc="x">load-on-demand-enabled</a></span> is
+<span class="RktVal">#t</span>, then <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-on-demand-source%29%29" class="RktValLink" data-pltdoc="x">read-on-demand-source</a></span> is set to
+the <a href="pathutils.html#%28tech._cleanse%29" class="techoutside" data-pltdoc="x"><span class="techinside">cleanse</span></a>d, absolute form of <span class="RktSym">path</span> during the
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> call. After reading a single form, the form is
+passed to the current <a href="eval.html#%28tech._evaluation._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">evaluation handler</span></a>, wrapping the
+evaluation in a continuation prompt (see
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-prompt%29%29" class="RktValLink" data-pltdoc="x">call-with-continuation-prompt</a></span>) for the default continuation
+prompt tag with handler that propagates the abort to the continuation
+of the <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%29%29" class="RktValLink" data-pltdoc="x">load</a></span> call.</p><p>If the second argument to the load handler is a symbol, then:</p><ul><li><p>The <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> from the file is additionally
+<span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>d as follows (to provide consistent reading
+of module source):</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-readtable%29%29" class="RktValLink" data-pltdoc="x">current-readtable</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-case-sensitive%29%29" class="RktValLink" data-pltdoc="x">read-case-sensitive</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-square-bracket-as-paren%29%29" class="RktValLink" data-pltdoc="x">read-square-bracket-as-paren</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-curly-brace-as-paren%29%29" class="RktValLink" data-pltdoc="x">read-curly-brace-as-paren</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-box%29%29" class="RktValLink" data-pltdoc="x">read-accept-box</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-compiled%29%29" class="RktValLink" data-pltdoc="x">read-accept-compiled</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-bar-quote%29%29" class="RktValLink" data-pltdoc="x">read-accept-bar-quote</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-graph%29%29" class="RktValLink" data-pltdoc="x">read-accept-graph</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax-accept-graph%29%29" class="RktValLink" data-pltdoc="x">read-syntax-accept-graph</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-decimal-as-inexact%29%29" class="RktValLink" data-pltdoc="x">read-decimal-as-inexact</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-dot%29%29" class="RktValLink" data-pltdoc="x">read-accept-dot</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-infix-dot%29%29" class="RktValLink" data-pltdoc="x">read-accept-infix-dot</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-quasiquote%29%29" class="RktValLink" data-pltdoc="x">read-accept-quasiquote</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-reader%29%29" class="RktValLink" data-pltdoc="x">read-accept-reader</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-lang%29%29" class="RktValLink" data-pltdoc="x">read-accept-lang</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr></table></blockquote></li><li><p>If the read result is not a <span class="RktSym">module</span> form, or if a
+second <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> does not produce an end-of-file,
+then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span> exception is raised without evaluating the form that
+was read from the file. (In previous versions, the module
+declaration was checked to match the name given as the second
+argument to the load handler, but this check is no longer
+performed.)</p></li><li><p>The <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> of the initial
+<span class="RktSym">module</span> identifier is enriched with a binding for
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>, so that the form corresponds to a module
+declaration independent of the current namespace&rsquo;s bindings.</p></li></ul><p>If the second argument to the load handler is <span class="RktVal">#f</span>, then each
+expression read from the file is wrapped with
+<span class="RktSym">#%top-interaction</span>, which is normally bound to
+<span class="RktSym"><a href="__top-interaction.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25top-interaction%29%29" class="RktStxLink" data-pltdoc="x">#%top-interaction</a></span>, before passing it to the <a href="eval.html#%28tech._evaluation._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">evaluation
+handler</span></a>.</p><p>The return value from the default <a href="eval.html#%28tech._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">load handler</span></a> is the value of
+the last form from the loaded file, or <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a> if the file
+contains no forms. If the given path is a relative path, then it is
+resolved using the value of <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._load))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%29%29" class="RktValDef RktValLink" data-pltdoc="x">load</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">file</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">file</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span>See also <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=eval.html%23%2528part._namespaces%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Namespaces</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a>.</p></blockquote></blockquote></blockquote></div></p><p>Calls the current <a href="eval.html#%28tech._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">load handler</span></a> in tail position. The call is
+<span class="RktSym">parameterized</span> to set <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-load-relative-directory</a></span>
+to the directory of <span class="RktVar">file</span>, which is resolved relative to
+the value of <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._load-relative))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._load-relative%29%29" class="RktValDef RktValLink" data-pltdoc="x">load-relative</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">file</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">file</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%2Fuse-compiled%29%29" class="RktValLink" data-pltdoc="x">load/use-compiled</a></span>, but when <span class="RktVar">file</span> is a relative
+path, it is resolved using the value of
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-load-relative-directory</a></span> instead of the value of
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span> if the former is not <span class="RktVal">#f</span>, otherwise
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span> is used.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._load/cd))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._load%2Fcd%29%29" class="RktValDef RktValLink" data-pltdoc="x">load/cd</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">file</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">file</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%29%29" class="RktValLink" data-pltdoc="x">load</a></span>, but <span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._load%2Fcd%29%29" class="RktValLink" data-pltdoc="x">load/cd</a></span> sets both
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span> and
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-load-relative-directory</a></span> before calling the <a href="eval.html#%28tech._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">load
+handler</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-load-extension))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-extension%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-load-extension</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._non-empty-listof%29%29" class="RktValLink" data-pltdoc="x">non-empty-listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-extension%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-load-extension</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._non-empty-listof%29%29" class="RktValLink" data-pltdoc="x">non-empty-listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines a <a name="(tech._extension._load._handler)"></a><span style="font-style: italic">extension-load handler</span>, which is
+called by <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load-extension%29%29" class="RktValLink" data-pltdoc="x">load-extension</a></span> and the default <a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load
+handler</span></a>.</div></p><p>An <a href="eval.html#%28tech._extension._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">extension-load handler</span></a> takes the same arguments as a
+<a href="eval.html#%28tech._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">load handler</span></a>, but the file should be a platform-specific
+<a name="(tech._dynamic._extension)"></a><span style="font-style: italic">dynamic extension</span>, typically with the file suffix
+<span class="stt">".so"</span> (Unix), <span class="stt">".dll"</span> (Windows), or <span class="stt">".dylib"</span>
+(Mac OS).  The file is loaded using internal, OS-specific
+primitives. See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=inside&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">Inside: Racket C API</a> for more information on
+<a href="eval.html#%28tech._dynamic._extension%29" class="techoutside" data-pltdoc="x"><span class="techinside">dynamic extensions</span></a>.</p><p>Extensions are supported only when <span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">vm</span><span class="RktPn">)</span> returns
+<span class="RktVal">'</span><span class="RktVal">racket</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._load-extension))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load-extension%29%29" class="RktValDef RktValLink" data-pltdoc="x">load-extension</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">file</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">file</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Sets <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-load-relative-directory</a></span> like <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%29%29" class="RktValLink" data-pltdoc="x">load</a></span>, and
+calls the <a href="eval.html#%28tech._extension._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">extension-load handler</span></a> in tail position.</div></p><p>Extensions are supported only when <span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">vm</span><span class="RktPn">)</span> returns
+<span class="RktVal">'</span><span class="RktVal">racket</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._load-relative-extension))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._load-relative-extension%29%29" class="RktValDef RktValLink" data-pltdoc="x">load-relative-extension</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">file</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">file</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load-extension%29%29" class="RktValLink" data-pltdoc="x">load-extension</a></span>, but resolves <span class="RktVar">file</span> using
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-load-relative-directory</a></span> like <span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._load-relative%29%29" class="RktValLink" data-pltdoc="x">load-relative</a></span>.</div></p><p>Extensions are supported only when <span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">vm</span><span class="RktPn">)</span> returns
+<span class="RktVal">'</span><span class="RktVal">racket</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-load/use-compiled))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load%2Fuse-compiled%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-load/use-compiled</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._non-empty-listof%29%29" class="RktValLink" data-pltdoc="x">non-empty-listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load%2Fuse-compiled%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-load/use-compiled</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._non-empty-listof%29%29" class="RktValLink" data-pltdoc="x">non-empty-listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the current <a name="(tech._compiled._load._handler)"></a><span style="font-style: italic">compiled-load
+handler</span> to load from a file that may have a compiled form. The
+<a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a> is called by <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%2Fuse-compiled%29%29" class="RktValLink" data-pltdoc="x">load/use-compiled</a></span>.</div></p><p>The protocol for a <a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a> is the same as for the
+<a href="eval.html#%28tech._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">load handler</span></a> (see <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load%29%29" class="RktValLink" data-pltdoc="x">current-load</a></span>), except that a
+<a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a> is expected to set
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-load-relative-directory</a></span> itself. Additionally, the default
+<a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a> does the following:</p><ul><li><p>When the given path ends with <span class="stt">".rkt"</span>, no <span class="stt">".rkt"</span>
+file exists, and when the handler&rsquo;s second argument is not <span class="RktVal">#f</span>,
+the default <a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a> checks for a <span class="stt">".ss"</span> file.</p></li><li><p>The default <a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a> checks for the opportunity
+to load from <span class="stt">".zo"</span> (bytecode) files and, when <span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">vm</span><span class="RktPn">)</span>
+returns <span class="RktVal">'</span><span class="RktVal">racket</span>, for <span class="stt">".so"</span> (native Unix), <span class="stt">".dll"</span> (native Windows),
+or <span class="stt">".dylib"</span> (native Mac OS) files.</p></li><li><p>When the default <a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a> needs to load from
+the given path, the given path does not exist, and when the handler&rsquo;s
+second argument is not <span class="RktVal">#f</span>,
+the default <a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a> returns without
+raising an exception.</p></li></ul><p>The check for a compiled file occurs whenever the given path
+<span class="RktVar">file</span> ends with any extension (e.g., <span class="stt">".rkt"</span> or
+<span class="stt">".scrbl"</span>), and the check consults the subdirectories
+indicated by the <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compiled-file-roots%29%29" class="RktValLink" data-pltdoc="x">current-compiled-file-roots</a></span> and
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._use-compiled-file-paths%29%29" class="RktValLink" data-pltdoc="x">use-compiled-file-paths</a></span> parameters relative to
+<span class="RktVar">file</span>, where the former supplies &ldquo;roots&rdquo; for compiled files
+and the latter provides subdirectories.
+<span class="refelem"><span class="refcolumn"><span class="refcontent">See also <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=api_compile-path.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">compiler/compilation-path</span></a>.</span></span></span>
+A &ldquo;root&rdquo; can be an absolute
+path, in which case <span class="RktVar">file</span>&rsquo;s directory is combined with
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._reroot-path%29%29" class="RktValLink" data-pltdoc="x">reroot-path</a></span> and the root as the second argument; if the
+&ldquo;root&rdquo; is a relative path, then the relative path is instead
+suffixed onto the directory of <span class="RktVar">file</span>. The roots are tried in
+order, and the subdirectories are checked in order within each root. A
+<span class="stt">".zo"</span> version of the file (whose name is formed by passing
+<span class="RktVar">file</span> and <span class="RktVal">#".zo"</span> to <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-add-extension%29%29" class="RktValLink" data-pltdoc="x">path-add-extension</a></span>) is
+loaded if it exists directly in one of the indicated subdirectories,
+or when <span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">vm</span><span class="RktPn">)</span> returns
+<span class="RktVal">'</span><span class="RktVal">racket</span>, then a <span class="stt">".so"</span>/<span class="stt">".dll"</span>/<span class="stt">".dylib"</span> version of the
+file is loaded if it exists within a <span class="stt">"native"</span> subdirectory of
+a <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._use-compiled-file-paths%29%29" class="RktValLink" data-pltdoc="x">use-compiled-file-paths</a></span> directory, in an even deeper
+subdirectory as named by <span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-library-subpath%29%29" class="RktValLink" data-pltdoc="x">system-library-subpath</a></span>. A compiled
+file is loaded only if it checks out according to
+<span class="RktPn">(</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._use-compiled-file-check%29%29" class="RktValLink" data-pltdoc="x">use-compiled-file-check</a></span><span class="RktPn">)</span>; with the default parameter value
+of <span class="RktVal">'</span><span class="RktVal">modify-seconds</span>, a compiled file is used only if its
+modification date is not older than the
+date for <span class="RktVar">file</span>. If both <span class="stt">".zo"</span> and
+<span class="stt">".so"</span>/<span class="stt">".dll"</span>/<span class="stt">".dylib"</span> files are available
+when <span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">vm</span><span class="RktPn">)</span> returns <span class="RktVal">'</span><span class="RktVal">racket</span>,
+the <span class="stt">".so"</span>/<span class="stt">".dll"</span>/<span class="stt">".dylib"</span> file is used.  If
+<span class="RktVar">file</span> ends with <span class="stt">".rkt"</span>, no such file exists, the
+handler&rsquo;s second argument is a symbol, and a <span class="stt">".ss"</span> file
+exists, then <span class="stt">".zo"</span> and
+<span class="stt">".so"</span>/<span class="stt">".dll"</span>/<span class="stt">".dylib"</span> files are used only
+with names based on <span class="RktVar">file</span> with its suffixed replaced by
+<span class="stt">".ss"</span>.</p><p>While a <span class="stt">".zo"</span>, <span class="stt">".so"</span>, <span class="stt">".dll"</span>, or
+<span class="stt">".dylib"</span> file is loaded, the current <span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._load-relative%29%29" class="RktValLink" data-pltdoc="x">load-relative</a></span>
+directory is set to the directory of the original <span class="RktVar">file</span>.  If
+the file to be loaded has the suffix <span class="stt">".ss"</span> while the
+requested file has the suffix <span class="stt">".rkt"</span>, then the
+<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-declare-source%29%29" class="RktValLink" data-pltdoc="x">current-module-declare-source</a></span> parameter is set to the full
+path of the loaded file, otherwise the
+<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-declare-source%29%29" class="RktValLink" data-pltdoc="x">current-module-declare-source</a></span> parameter is set to
+<span class="RktVal">#f</span>.</p><p>If the original <span class="RktVar">file</span> is loaded or a <span class="stt">".zo"</span> variant is
+loaded, the <a href="eval.html#%28tech._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">load handler</span></a> is called to load the file. If any
+other kind of file is loaded, the <a href="eval.html#%28tech._extension._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">extension-load handler</span></a> is
+called.</p><p>When the default <a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a> loads a module from a
+bytecode (i.e., <span class="stt">".zo"</span>) file, the handler records the bytecode
+file path in the current namespace&rsquo;s <a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module registry</span></a>. More
+specifically, the handler records the path for the top-level module of
+the loaded module, which is an enclosing module if the loaded module
+is a submodule. Thereafter, loads via the default <a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load
+handler</span></a> for modules within the same top-level module use the recorded
+file, independent of the file that otherwise would be selected by the
+<a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a> (e.g., even if the
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._use-compiled-file-paths%29%29" class="RktValLink" data-pltdoc="x">use-compiled-file-paths</a></span> parameter value changes). The default
+<a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name resolver</span></a> transfers bytecode-file information when a
+module declaration is attached to a new namespace. This protocol supports
+independent but consistent loading of submodules from bytecode files.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._load/use-compiled))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%2Fuse-compiled%29%29" class="RktValDef RktValLink" data-pltdoc="x">load/use-compiled</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">file</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">file</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Calls the current <a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a> in tail position.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-load-relative-directory))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-load-relative-directory</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-load-relative-directory</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that is set by <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%29%29" class="RktValLink" data-pltdoc="x">load</a></span>, <span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._load-relative%29%29" class="RktValLink" data-pltdoc="x">load-relative</a></span>,
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load-extension%29%29" class="RktValLink" data-pltdoc="x">load-extension</a></span>, <span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._load-relative-extension%29%29" class="RktValLink" data-pltdoc="x">load-relative-extension</a></span>, and the
+default <a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a>, and used by
+<span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._load-relative%29%29" class="RktValLink" data-pltdoc="x">load-relative</a></span>, <span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._load-relative-extension%29%29" class="RktValLink" data-pltdoc="x">load-relative-extension</a></span>, and the
+default <a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a>.</div></p><p>When a new path or string is provided as the parameter&rsquo;s value, it is
+immediately expanded (see <a href="pathutils.html" data-pltdoc="x">Paths</a>) and converted to a
+path. (The directory need not exist.)</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._use-compiled-file-paths))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._use-compiled-file-paths%29%29" class="RktValDef RktValLink" data-pltdoc="x">use-compiled-file-paths</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._relative-path~3f%29%29" class="RktValLink" data-pltdoc="x">relative-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._use-compiled-file-paths%29%29" class="RktValDef RktValLink" data-pltdoc="x">use-compiled-file-paths</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">paths</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">paths</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._relative-path~3f%29%29" class="RktValLink" data-pltdoc="x">relative-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A list of relative paths, which defaults to <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._string-~3epath%29%29" class="RktValLink" data-pltdoc="x">string-&gt;path</a></span><span class="stt"> </span><span class="RktVal">"compiled"</span><span class="RktPn">)</span><span class="RktPn">)</span>. It is used by the <a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load
+handler</span></a> (see <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load%2Fuse-compiled%29%29" class="RktValLink" data-pltdoc="x">current-load/use-compiled</a></span>).</div></p><p>If the <a name="(idx._(gentag._273._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_ZO_PATH</span> environment variable is set on
+startup, it supplies a path instead of <span class="RktVal">"compiled"</span> to
+use for the initial parameter value.</p><p class="SHistory">Changed in version 7.7.0.9 of package <span class="stt">base</span>: Added <span class="stt">PLT_ZO_PATH</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-compiled-file-roots))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compiled-file-roots%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-compiled-file-roots</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">same</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compiled-file-roots%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-compiled-file-roots</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">paths</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">paths</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">same</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A list of paths and <span class="RktVal">'</span><span class="RktVal">same</span>s that is is used by the default
+<a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a> (see <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load%2Fuse-compiled%29%29" class="RktValLink" data-pltdoc="x">current-load/use-compiled</a></span>).</div></p><p>The parameter is normally initialized to <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">same</span><span class="RktPn">)</span>, but
+the parameter&rsquo;s initial value can be adjusted by the installation
+configuration as reported by <span class="RktPn">(</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._find-compiled-file-roots%29%29" class="RktValLink" data-pltdoc="x">find-compiled-file-roots</a></span><span class="RktPn">)</span>,
+and it can be further adjusted by the
+<a name="(idx._(gentag._274._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLTCOMPILEDROOTS</span> environment variable or the
+<span class="nobreak"><span class="stt">--compiled</span></span> or <span class="nobreak"><span class="stt">-R</span></span> command-line flag for <span class="stt">racket</span>.  If
+the environment variable is defined and not overridden by a
+command-line flag, it is parsed by first replacing any
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">@(version)</span><span class="hspace"></span></span> with the result of <span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._version%29%29" class="RktValLink" data-pltdoc="x">version</a></span><span class="RktPn">)</span>, then using
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-list-string-~3epath-list%29%29" class="RktValLink" data-pltdoc="x">path-list-string-&gt;path-list</a></span> with a path list produced by
+<span class="RktPn">(</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._find-compiled-file-roots%29%29" class="RktValLink" data-pltdoc="x">find-compiled-file-roots</a></span><span class="RktPn">)</span> to arrive at the parameter&rsquo;s
+initial value.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._find-compiled-file-roots))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._find-compiled-file-roots%29%29" class="RktValDef RktValLink" data-pltdoc="x">find-compiled-file-roots</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">same</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Produces a list of paths and <span class="RktVal">'</span><span class="RktVal">same</span>, which is normally used to
+initialize <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compiled-file-roots%29%29" class="RktValLink" data-pltdoc="x">current-compiled-file-roots</a></span>. The list is
+determined by consulting the <span class="stt">"config.rtkd"</span> file in the
+directory reported by <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=dirs.html%23%2528def._%2528%2528lib._setup%252Fdirs..rkt%2529._find-config-dir%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">find-config-dir</a></span><span class="RktPn">)</span>, and it defaults to
+<span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">same</span><span class="RktPn">)</span> if not configured there.</div></p><p>See also <span class="RktVal">'</span><span class="RktVal">compiled-file-roots</span> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=config-file.html&amp;version=8.6" class="Sq" data-pltdoc="x">Installation Configuration and Search Paths</a>.</p><p class="SHistory">Added in version 8.0.0.9 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._use-compiled-file-check))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._use-compiled-file-check%29%29" class="RktValDef RktValLink" data-pltdoc="x">use-compiled-file-check</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">modify-seconds</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exists</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._use-compiled-file-check%29%29" class="RktValDef RktValLink" data-pltdoc="x">use-compiled-file-check</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">check</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">check</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">modify-seconds</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exists</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines how a compiled file is checked
+against its source to enable use of the compiled file. By default, the
+file-check mode is <span class="RktVal">'</span><span class="RktVal">modify-seconds</span>, which uses a compiled
+file when its filesystem modification date is at least as new as the
+source file&rsquo;s. The <span class="RktVal">'</span><span class="RktVal">exists</span> mode causes a compiled file to be
+used in place of its source as long as the compiled file exists.</div></p><p>If the <a name="(idx._(gentag._275._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_COMPILED_FILE_CHECK</span> environment variable is
+set to <span class="RktInBG"><span class="hspace"></span><span class="RktIn">modify-seconds</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">exists</span><span class="hspace"></span></span>, then the
+environment variable&rsquo;s value configures the parameter when Racket
+starts.</p><p class="SHistory">Added in version 6.6.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._read-eval-print-loop))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._read-eval-print-loop%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-eval-print-loop</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Starts a new <a name="(tech._repl)"></a><span style="font-style: italic">REPL</span> using the current input, output, and error
+ports. The REPL wraps each expression to evaluate with
+<span class="RktSym">#%top-interaction</span>, which is normally bound to
+<span class="RktSym"><a href="__top-interaction.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25top-interaction%29%29" class="RktStxLink" data-pltdoc="x">#%top-interaction</a></span>, and it wraps each evaluation with a
+continuation prompt using the default continuation prompt tag and
+prompt handler (see <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-prompt%29%29" class="RktValLink" data-pltdoc="x">call-with-continuation-prompt</a></span>). The REPL
+also wraps the read and print operations with a prompt for the default
+tag whose handler ignores abort arguments and continues the loop. The
+<span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._read-eval-print-loop%29%29" class="RktValLink" data-pltdoc="x">read-eval-print-loop</a></span> procedure does not return until
+<span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> is read, at which point it returns <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</div></p><p>The <span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._read-eval-print-loop%29%29" class="RktValLink" data-pltdoc="x">read-eval-print-loop</a></span> procedure can be configured through
+the <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-prompt-read%29%29" class="RktValLink" data-pltdoc="x">current-prompt-read</a></span>, <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-eval%29%29" class="RktValLink" data-pltdoc="x">current-eval</a></span>, and
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-print%29%29" class="RktValLink" data-pltdoc="x">current-print</a></span> parameters.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-prompt-read))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-prompt-read%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-prompt-read</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-prompt-read%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-prompt-read</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines a <a name="(tech._prompt._read._handler)"></a><span style="font-style: italic">prompt read handler</span>, which is
+a procedure that takes no arguments, displays a prompt string, and
+returns a top-level form to evaluate. The prompt read handler is
+called by <span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._read-eval-print-loop%29%29" class="RktValLink" data-pltdoc="x">read-eval-print-loop</a></span>, and after printing a prompt,
+the handler typically should call the <a href="eval.html#%28tech._read._interaction._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">read interaction handler</span></a>
+(as determined by the <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-read-interaction%29%29" class="RktValLink" data-pltdoc="x">current-read-interaction</a></span> parameter)
+with the port produced by the <a href="eval.html#%28tech._interaction._port._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">interaction port handler</span></a>
+(as determined by the <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-get-interaction-input-port%29%29" class="RktValLink" data-pltdoc="x">current-get-interaction-input-port</a></span> parameter).</div></p><p>The default prompt read handler prints <span class="RktInBG"><span class="hspace"></span><span class="RktIn">&gt;</span><span class="hspace">&nbsp;</span></span> and returns the
+result of</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">in</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-get-interaction-input-port%29%29" class="RktValLink" data-pltdoc="x">current-get-interaction-input-port</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-read-interaction%29%29" class="RktValLink" data-pltdoc="x">current-read-interaction</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>If the input and output ports are both terminals (in the sense of
+<span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._terminal-port~3f%29%29" class="RktValLink" data-pltdoc="x">terminal-port?</a></span>) and if the output port appears to be counting
+lines (because <span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-next-location%29%29" class="RktValLink" data-pltdoc="x">port-next-location</a></span> returns a non-<span class="RktVal">#f</span>
+line and column), then the output port&rsquo;s line is incremented and its
+column is reset to <span class="RktVal">0</span> via <span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._set-port-next-location%21%29%29" class="RktValLink" data-pltdoc="x">set-port-next-location!</a></span>
+before returning the read result.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-get-interaction-input-port))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-get-interaction-input-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-get-interaction-input-port</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-get-interaction-input-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-get-interaction-input-port</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the <a name="(tech._interaction._port._handler)"></a><span style="font-style: italic">interaction port handler</span>,
+which returns a port to use for <span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._read-eval-print-loop%29%29" class="RktValLink" data-pltdoc="x">read-eval-print-loop</a></span> inputs.</div></p><p>The default interaction port handler returns the current input port.
+In addition, if that port is the initial current input port,
+the initial current output and error ports are flushed.</p><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/gui/base</span></a> library adjusts this parameter&rsquo;s
+value by extending the current value. The extension wraps the result
+port so that GUI events can be handled when reading from the port
+blocks.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-get-interaction-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-get-interaction-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-get-interaction-evt</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-get-interaction-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-get-interaction-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the <a name="(tech._interaction._event._handler)"></a><span style="font-style: italic">interaction event
+handler</span>, which returns an <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> that should be
+used in combination with blocking that is similar to
+<span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._read-eval-print-loop%29%29" class="RktValLink" data-pltdoc="x">read-eval-print-loop</a></span> waiting for input&#8212;<wbr></wbr>but where an input
+port is not read directly, so
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-get-interaction-input-port%29%29" class="RktValLink" data-pltdoc="x">current-get-interaction-input-port</a></span> does not apply.</div></p><p>When the interaction event handler returns an event that becomes
+ready, and when the event&rsquo;s ready value is a procedure, then the
+procedure is meant to be called with zero arguments blocking resumes.
+The default interaction event handler returns <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._never-evt%29%29" class="RktValLink" data-pltdoc="x">never-evt</a></span>.</p><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/gui/base</span></a> library adjusts this parameter&rsquo;s
+value by extending the current value. The extension combines the
+current value&rsquo;s result with <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._choice-evt%29%29" class="RktValLink" data-pltdoc="x">choice-evt</a></span> and an event that
+becomes ready when a GUI event is available, and the event&rsquo;s value is
+a procedure that yields to one or more available GUI events.</p><p class="SHistory">Added in version 8.3.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-read-interaction))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-read-interaction%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-read-interaction</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-read-interaction%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-read-interaction</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the current <a name="(tech._read._interaction._handler)"></a><span style="font-style: italic">read interaction
+handler</span>, which is procedure that takes an arbitrary value and an
+input port and returns an expression read from the input port.</div></p><p>The default read interaction handler accepts <span class="RktVar">src</span> and
+<span class="RktVar">in</span> and returns</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-reader%29%29" class="RktValLink" data-pltdoc="x">read-accept-reader</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-lang%29%29" class="RktValLink" data-pltdoc="x">read-accept-lang</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVar">src</span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-print))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-print%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-print</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-print%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-print</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the <a name="(tech._print._handler)"></a><span style="font-style: italic">print handler</span> that is called
+ by <span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._read-eval-print-loop%29%29" class="RktValLink" data-pltdoc="x">read-eval-print-loop</a></span> to print the result of an evaluation
+ (and the result is ignored).</div></p><p>The default <a href="eval.html#%28tech._print._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">print handler</span></a> <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>s the value to the
+ current output port (as determined by the
+ <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span> parameter) and then outputs a newline,
+ except that it prints nothing when the value is <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-compile))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-compile</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compiled-expression~3f%29%29" class="RktValLink" data-pltdoc="x">compiled-expression?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-compile</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compiled-expression~3f%29%29" class="RktValLink" data-pltdoc="x">compiled-expression?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the current <a name="(tech._compilation._handler)"></a><span style="font-style: italic">compilation handler</span>.
+The <a href="eval.html#%28tech._compilation._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compilation handler</span></a> is a procedure that takes a top-level form and
+returns a compiled form; see <a href="syntax-model.html#%28part._compilation-model%29" data-pltdoc="x">Compilation</a> for
+more information on compilation.</div></p><p>The <a href="eval.html#%28tech._compilation._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compilation handler</span></a> is called by <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile%29%29" class="RktValLink" data-pltdoc="x">compile</a></span>, and
+indirectly by the default <a href="eval.html#%28tech._evaluation._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">evaluation handler</span></a> and the default
+<a href="eval.html#%28tech._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">load handler</span></a>.</p><p>The handler&rsquo;s second argument is <span class="RktVal">#t</span> if the compiled form will
+be used only for immediate evaluation, or <span class="RktVal">#f</span> if the compiled
+form may be saved for later use; the default compilation handler is
+optimized for the special case of immediate evaluation.</p><p>When a compiled form is written to an output port, the written form
+starts with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#~</span><span class="hspace"></span></span>. See <a href="printing.html#%28part._print-compiled%29" data-pltdoc="x">Printing Compiled Code</a> for more
+information.</p><p>For internal testing purposes, when the
+<a name="(idx._(gentag._276._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_VALIDATE_COMPILE</span> environment variable is set,
+the default compilation handler runs a bytecode validator immediately
+on its own compilation results (instead of relying only on validation
+when compiled bytecode is loaded).</p><p>The <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile%29%29" class="RktValLink" data-pltdoc="x">current-compile</a></span> binding is provided as <a href="modprotect.html#%28tech._protected%29" class="techoutside" data-pltdoc="x"><span class="techinside">protected</span></a>
+in the sense of <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._protect-out%29%29" class="RktStxLink" data-pltdoc="x">protect-out</a></span>.</p><p class="SHistory">Changed in version 8.2.0.4 of package <span class="stt">base</span>: Changed binding to protected.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._compile))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile%29%29" class="RktValDef RktValLink" data-pltdoc="x">compile</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">top-level-form</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compiled-expression~3f%29%29" class="RktValLink" data-pltdoc="x">compiled-expression?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">top-level-form</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span>, but calls the current <a href="eval.html#%28tech._compilation._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compilation handler</span></a> in
+tail position with <span class="RktVar">top-level-form</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._compile-syntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-syntax%29%29" class="RktValDef RktValLink" data-pltdoc="x">compile-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compiled-expression~3f%29%29" class="RktValLink" data-pltdoc="x">compiled-expression?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval-syntax%29%29" class="RktValLink" data-pltdoc="x">eval-syntax</a></span>, but calls the current <a href="eval.html#%28tech._compilation._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compilation
+handler</span></a> in tail position with <span class="RktVar">stx</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._compiled-expression-recompile))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compiled-expression-recompile%29%29" class="RktValDef RktValLink" data-pltdoc="x">compiled-expression-recompile</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">ce</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compiled-expression~3f%29%29" class="RktValLink" data-pltdoc="x">compiled-expression?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ce</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compiled-expression~3f%29%29" class="RktValLink" data-pltdoc="x">compiled-expression?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Recompiles <span class="RktVar">ce</span>. If <span class="RktVar">ce</span> was compiled as
+machine-independent and <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile-target-machine%29%29" class="RktValLink" data-pltdoc="x">current-compile-target-machine</a></span> is
+not set to <span class="RktVal">#f</span>, then recompiling effectively converts to the current
+machine format. Otherwise, recompiling effectively re-runs
+optimization passes to produce an equivalent compiled form with
+potentially different performance characteristics.</div></p><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._compiled-expression~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compiled-expression~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">compiled-expression?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a compiled form, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._compile-enforce-module-constants))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-enforce-module-constants%29%29" class="RktValDef RktValLink" data-pltdoc="x">compile-enforce-module-constants</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-enforce-module-constants%29%29" class="RktValDef RktValLink" data-pltdoc="x">compile-enforce-module-constants</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines how a module declaration is compiled.</div></p><p>When constants are enforced, and when the macro-expanded body of a
+module contains no <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span> assignment to a particular variable
+defined within the module, then the variable is marked as constant
+when the definition is evaluated. Afterward, the variable&rsquo;s value
+cannot be assigned or undefined through <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._module-~3enamespace%29%29" class="RktValLink" data-pltdoc="x">module-&gt;namespace</a></span>,
+and it cannot be defined by redeclaring the module.</p><p>Enforcing constants allows the compiler to inline some variable
+values, and it allows the native-code just-in-time compiler to
+generate code that skips certain run-time checks.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._compile-allow-set!-undefined))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-allow-set%21-undefined%29%29" class="RktValDef RktValLink" data-pltdoc="x">compile-allow-set!-undefined</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-allow-set%21-undefined%29%29" class="RktValDef RktValLink" data-pltdoc="x">compile-allow-set!-undefined</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">allow?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">allow?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines how a <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span> expression is compiled
+when it mutates a global variable. If the value of this parameter is a
+true value, <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span> expressions for global variables are
+compiled so that the global variable is set even if it was not
+previously defined.  Otherwise, <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span> expressions for global
+variables are compiled to raise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3avariable%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:variable</a></span> exception if the global variable
+is not defined at the time the <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span> is performed.  Note that
+this parameter is used when an expression is <span style="font-style: italic">compiled</span>, not
+when it is <span style="font-style: italic">evaluated</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._compile-context-preservation-enabled))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-context-preservation-enabled%29%29" class="RktValDef RktValLink" data-pltdoc="x">compile-context-preservation-enabled</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-context-preservation-enabled%29%29" class="RktValDef RktValLink" data-pltdoc="x">compile-context-preservation-enabled</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines whether compilation should avoid
+function-call inlining and other optimizations that may cause
+information to be lost from stack traces (as reported by
+<span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3econtext%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set-&gt;context</a></span>). The default is <span class="RktVal">#f</span>,
+which allows such optimizations.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-compile-target-machine))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile-target-machine%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-compile-target-machine</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-target-machine~3f%29%29" class="RktValLink" data-pltdoc="x">compile-target-machine?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile-target-machine%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-compile-target-machine</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">target</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">target</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-target-machine~3f%29%29" class="RktValLink" data-pltdoc="x">compile-target-machine?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the platform and/or virtual machine
+target for a newly compiled expression.</div></p><p>If the target is <span class="RktVal">#f</span>, the the compiled expression writes in a
+machine-independent format (usually in <span class="stt">".zo"</span> files).
+Machine-independent compiled code works for any platform and any
+Racket virtual machine. When the machine-independent compiled
+expression is read back in, it is subject to further compilation for
+the current platform and virtual machine, which can be considerably
+slower than reading a format that is fully compiled for a platform and
+virtual machine.</p><p>The default is something other than <span class="RktVal">#f</span>, unless
+machine-independent mode is enabled through the
+<span class="nobreak"><span class="stt">-M</span></span>/<span class="nobreak"><span class="stt">--compile-any</span></span> command-line flag to stand-alone Racket
+(or GRacket) or through the <a name="(idx._(gentag._277._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_COMPILE_ANY</span>
+environment variable (set to any value).</p><p class="SHistory">Added in version 7.1.0.6 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._compile-target-machine~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-target-machine~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">compile-target-machine?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sym</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Reports whether <span class="RktVar">sym</span> is a supported compilation target for the
+currently running Racket.</div></p><p>When <span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">vm</span><span class="RktPn">)</span> reports <span class="RktVal">'</span><span class="RktVal">racket</span>, then the
+only target symbol is <span class="RktVal">'</span><span class="RktVal">racket</span>. When <span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">vm</span><span class="RktPn">)</span> reports <span class="RktVal">'</span><span class="RktVal">chez-scheme</span>, then a symbol corresponding to
+the current platform is a target, and other targets may also be
+supported. The <span class="RktVal">'</span><span class="RktVal">target-machine</span> mode of <span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span>
+reports the running Racket&rsquo;s native target machine.</p><p class="SHistory">Added in version 7.1.0.6 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-compile-realm))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile-realm%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-compile-realm</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile-realm%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-compile-realm</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">realm</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">realm</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Determines the <a href="exns.html#%28tech._realm%29" class="techoutside" data-pltdoc="x"><span class="techinside">realm</span></a> that is assigned to modules and procedures
+when they are compiled.</div></p><p class="SHistory">Added in version 8.4.0.2 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._eval-jit-enabled))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval-jit-enabled%29%29" class="RktValDef RktValLink" data-pltdoc="x">eval-jit-enabled</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval-jit-enabled%29%29" class="RktValDef RktValLink" data-pltdoc="x">eval-jit-enabled</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span>See also <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=performance.html%23%2528part._.J.I.T%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Bytecode, Machine Code, and Just-in-Time (JIT) Compilers</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a>.</p></blockquote></blockquote></blockquote></div></p><p>A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines whether the native-code just-in-time
+compiler (<a name="(tech._jit)"></a><span style="font-style: italic">JIT</span>) is enabled for code (compiled or not) that is passed to
+the default evaluation handler. A true parameter value is effective
+only on platforms for which the JIT is supported and for Racket virtual machines
+that rely on a JIT.</p><p>The default is <span class="RktVal">#t</span>, unless the JIT is not supported by the
+current platform but is supported on the same virtual machine for other
+platforms, unless it is disabled through the
+<span class="nobreak"><span class="stt">-j</span></span>/<span class="nobreak"><span class="stt">--no-jit</span></span> command-line flag to stand-alone Racket (or
+GRacket), and unless it is disabled through the
+<a name="(idx._(gentag._278._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLTNOMZJIT</span> environment variable (set to any
+value).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._load-on-demand-enabled))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load-on-demand-enabled%29%29" class="RktValDef RktValLink" data-pltdoc="x">load-on-demand-enabled</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load-on-demand-enabled%29%29" class="RktValDef RktValLink" data-pltdoc="x">load-on-demand-enabled</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines whether the default <a href="eval.html#%28tech._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">load handler</span></a>
+sets <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-on-demand-source%29%29" class="RktValLink" data-pltdoc="x">read-on-demand-source</a></span>. See <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load%29%29" class="RktValLink" data-pltdoc="x">current-load</a></span> for
+more information. The default is <span class="RktVal">#t</span>, unless it is disabled
+through the <span class="nobreak"><span class="stt">-d</span></span>/<span class="nobreak"><span class="stt">--no-delay</span></span> command-line flag.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Namespaces.html" title="backward to &quot;14.1 Namespaces&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="load-lang.html" title="forward to &quot;14.3 The racket/load Language&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/exns.html b/clones/docs.racket-lang.org/reference/exns.html
new file mode 100644
index 00000000..f955a218
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/exns.html
@@ -0,0 +1,507 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>10.2&nbsp;Exceptions</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewselflink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">10.1&nbsp;</td><td><a href="values.html" class="tocviewlink" data-pltdoc="x">Multiple Values</a></td></tr><tr><td align="right">10.2&nbsp;</td><td><a href="exns.html" class="tocviewselflink" data-pltdoc="x">Exceptions</a></td></tr><tr><td align="right">10.3&nbsp;</td><td><a href="Delayed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Delayed Evaluation</a></td></tr><tr><td align="right">10.4&nbsp;</td><td><a href="cont.html" class="tocviewlink" data-pltdoc="x">Continuations</a></td></tr><tr><td align="right">10.5&nbsp;</td><td><a href="contmarks.html" class="tocviewlink" data-pltdoc="x">Continuation Marks</a></td></tr><tr><td align="right">10.6&nbsp;</td><td><a href="breakhandler.html" class="tocviewlink" data-pltdoc="x">Breaks</a></td></tr><tr><td align="right">10.7&nbsp;</td><td><a href="Exiting.html" class="tocviewlink" data-pltdoc="x">Exiting</a></td></tr><tr><td align="right">10.8&nbsp;</td><td><a href="unreachable.html" class="tocviewlink" data-pltdoc="x">Unreachable Expressions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>10.2&nbsp;</td><td><a href="exns.html" class="tocviewselflink" data-pltdoc="x">Exceptions</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">10.2.1&nbsp;</td><td><a href="exns.html#%28part._err-msg-conventions%29" class="tocviewlink" data-pltdoc="x">Error Message Conventions</a></td></tr><tr><td align="right">10.2.2&nbsp;</td><td><a href="exns.html#%28part._errorproc%29" class="tocviewlink" data-pltdoc="x">Raising Exceptions</a></td></tr><tr><td align="right">10.2.3&nbsp;</td><td><a href="exns.html#%28part._.Handling_.Exceptions%29" class="tocviewlink" data-pltdoc="x">Handling Exceptions</a></td></tr><tr><td align="right">10.2.4&nbsp;</td><td><a href="exns.html#%28part._.Configuring_.Default_.Handling%29" class="tocviewlink" data-pltdoc="x">Configuring Default Handling</a></td></tr><tr><td align="right">10.2.5&nbsp;</td><td><a href="exns.html#%28part._.Built-in_.Exception_.Types%29" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>in Exception Types</a></td></tr><tr><td align="right">10.2.6&nbsp;</td><td><a href="exns.html#%28part._.Additional_.Exception_.Functions%29" class="tocviewlink" data-pltdoc="x">Additional Exception Functions</a></td></tr><tr><td align="right">10.2.7&nbsp;</td><td><a href="exns.html#%28part._err-realm%29" class="tocviewlink" data-pltdoc="x">Realms and Error Message Adjusters</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">10.2.1<tt>&nbsp;</tt></span><a href="exns.html#%28part._err-msg-conventions%29" class="tocsubseclink" data-pltdoc="x">Error Message Conventions</a></td></tr><tr><td><span class="tocsublinknumber">10.2.2<tt>&nbsp;</tt></span><a href="exns.html#%28part._errorproc%29" class="tocsubseclink" data-pltdoc="x">Raising Exceptions</a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-user-error%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-<wbr></wbr>user-<wbr></wbr>error</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-argument-error%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-<wbr></wbr>argument-<wbr></wbr>error</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-argument-error%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-<wbr></wbr>argument-<wbr></wbr>error*</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-result-error%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-<wbr></wbr>result-<wbr></wbr>error</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-result-error%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-<wbr></wbr>result-<wbr></wbr>error*</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arguments-error%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-<wbr></wbr>arguments-<wbr></wbr>error</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arguments-error%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-<wbr></wbr>arguments-<wbr></wbr>error*</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-range-error%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-<wbr></wbr>range-<wbr></wbr>error</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-range-error%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-<wbr></wbr>range-<wbr></wbr>error*</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-type-error%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-<wbr></wbr>type-<wbr></wbr>error</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-mismatch-error%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-<wbr></wbr>mismatch-<wbr></wbr>error</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arity-error%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-<wbr></wbr>arity-<wbr></wbr>error</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arity-error%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-<wbr></wbr>arity-<wbr></wbr>error*</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arity-mask-error%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-<wbr></wbr>arity-<wbr></wbr>mask-<wbr></wbr>error</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arity-mask-error%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-<wbr></wbr>arity-<wbr></wbr>mask-<wbr></wbr>error*</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-result-arity-error%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-<wbr></wbr>result-<wbr></wbr>arity-<wbr></wbr>error</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-result-arity-error%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-<wbr></wbr>result-<wbr></wbr>arity-<wbr></wbr>error*</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._raise-syntax-error%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-<wbr></wbr>syntax-<wbr></wbr>error</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._unquoted-printing-string~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unquoted-<wbr></wbr>printing-<wbr></wbr>string?</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._unquoted-printing-string%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unquoted-<wbr></wbr>printing-<wbr></wbr>string</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._unquoted-printing-string-value%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unquoted-<wbr></wbr>printing-<wbr></wbr>string-<wbr></wbr>value</span></span></a></td></tr><tr><td><span class="tocsublinknumber">10.2.3<tt>&nbsp;</tt></span><a href="exns.html#%28part._.Handling_.Exceptions%29" class="tocsubseclink" data-pltdoc="x">Handling Exceptions</a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call-with-exception-handler%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>exception-<wbr></wbr>handler</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._uncaught-exception-handler%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">uncaught-<wbr></wbr>exception-<wbr></wbr>handler</span></span></a></td></tr><tr><td><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>handlers</span></span></a></td></tr><tr><td><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>handlers*</span></span></a></td></tr><tr><td><span class="tocsublinknumber">10.2.4<tt>&nbsp;</tt></span><a href="exns.html#%28part._.Configuring_.Default_.Handling%29" class="tocsubseclink" data-pltdoc="x">Configuring Default Handling</a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-escape-handler%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error-<wbr></wbr>escape-<wbr></wbr>handler</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-display-handler%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error-<wbr></wbr>display-<wbr></wbr>handler</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-print-width%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error-<wbr></wbr>print-<wbr></wbr>width</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-print-context-length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error-<wbr></wbr>print-<wbr></wbr>context-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-print-source-location%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error-<wbr></wbr>print-<wbr></wbr>source-<wbr></wbr>location</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-value-~3estring-handler%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error-<wbr></wbr>value-<wbr></wbr>&gt;string-<wbr></wbr>handler</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-syntax-~3estring-handler%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error-<wbr></wbr>syntax-<wbr></wbr>&gt;string-<wbr></wbr>handler</span></span></a></td></tr><tr><td><span class="tocsublinknumber">10.2.5<tt>&nbsp;</tt></span><a href="exns.html#%28part._.Built-in_.Exception_.Types%29" class="tocsubseclink" data-pltdoc="x">Built-<wbr></wbr>in Exception Types</a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>contract</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3aarity%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>contract:<span class="mywbr"> &nbsp;</span>arity</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3adivide-by-zero%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>contract:<span class="mywbr"> &nbsp;</span>divide-<wbr></wbr>by-<wbr></wbr>zero</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3anon-fixnum-result%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>contract:<span class="mywbr"> &nbsp;</span>non-<wbr></wbr>fixnum-<wbr></wbr>result</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3acontinuation%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>contract:<span class="mywbr"> &nbsp;</span>continuation</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3avariable%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>contract:<span class="mywbr"> &nbsp;</span>variable</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>syntax</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax~3aunbound%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>syntax:<span class="mywbr"> &nbsp;</span>unbound</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax~3amissing-module%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>syntax:<span class="mywbr"> &nbsp;</span>missing-<wbr></wbr>module</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>read</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread~3aeof%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>read:<span class="mywbr"> &nbsp;</span>eof</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread~3anon-char%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>read:<span class="mywbr"> &nbsp;</span>non-<wbr></wbr>char</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>filesystem</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3aexists%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>filesystem:<span class="mywbr"> &nbsp;</span>exists</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3aversion%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>filesystem:<span class="mywbr"> &nbsp;</span>version</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3aerrno%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>filesystem:<span class="mywbr"> &nbsp;</span>errno</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3amissing-module%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>filesystem:<span class="mywbr"> &nbsp;</span>missing-<wbr></wbr>module</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>network</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork~3aerrno%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>network:<span class="mywbr"> &nbsp;</span>errno</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aout-of-memory%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>out-<wbr></wbr>of-<wbr></wbr>memory</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aunsupported%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>unsupported</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3auser%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>user</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>break</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak~3ahang-up%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>break:<span class="mywbr"> &nbsp;</span>hang-<wbr></wbr>up</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak~3aterminate%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>break:<span class="mywbr"> &nbsp;</span>terminate</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._prop~3aexn~3asrclocs%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>exn:<span class="mywbr"> &nbsp;</span>srclocs</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3asrclocs~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>srclocs?</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3asrclocs-accessor%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>srclocs-<wbr></wbr>accessor</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">srcloc</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._srcloc-~3estring%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">srcloc-<wbr></wbr>&gt;string</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._prop~3aexn~3amissing-module%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>exn:<span class="mywbr"> &nbsp;</span>missing-<wbr></wbr>module</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3amissing-module~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>missing-<wbr></wbr>module?</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3amissing-module-accessor%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>missing-<wbr></wbr>module-<wbr></wbr>accessor</span></span></a></td></tr><tr><td><span class="tocsublinknumber">10.2.6<tt>&nbsp;</tt></span><a href="exns.html#%28part._.Additional_.Exception_.Functions%29" class="tocsubseclink" data-pltdoc="x">Additional Exception Functions</a></td></tr><tr><td><a href="exns.html#%28def._%28%28lib._racket%2Fexn..rkt%29._exn-~3estring%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym">exn-<wbr></wbr>&gt;string</span></a></td></tr><tr><td><span class="tocsublinknumber">10.2.7<tt>&nbsp;</tt></span><a href="exns.html#%28part._err-realm%29" class="tocsubseclink" data-pltdoc="x">Realms and Error Message Adjusters</a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-message-~3eadjusted-string%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error-<wbr></wbr>message-<wbr></wbr>&gt;adjusted-<wbr></wbr>string</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-contract-~3eadjusted-string%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error-<wbr></wbr>contract-<wbr></wbr>&gt;adjusted-<wbr></wbr>string</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._current-error-message-adjuster%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>error-<wbr></wbr>message-<wbr></wbr>adjuster</span></span></a></td></tr><tr><td><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-message-adjuster-key%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">error-<wbr></wbr>message-<wbr></wbr>adjuster-<wbr></wbr>key</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="values.html" title="backward to &quot;10.1 Multiple Values&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Control Flow&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Delayed_Evaluation.html" title="forward to &quot;10.3 Delayed Evaluation&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;exns&quot;">10.2<tt>&nbsp;</tt><a name="(part._exns)"></a>Exceptions</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=exns.html&amp;version=8.6" class="Sq" data-pltdoc="x">Exceptions</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces exceptions.</p></blockquote></blockquote></blockquote><p>See <a href="eval-model.html#%28part._exn-model%29" data-pltdoc="x">Exceptions</a> for information on the Racket exception
+model. It is based on a proposal by Friedman, Haynes, and Dybvig
+[<a href="doc-bibliography.html#%28cite._.Friedman95%29" data-pltdoc="x">Friedman95</a>].</p><p>Whenever a primitive error occurs in Racket, an exception is
+raised.  The value that is passed to the current <a href="eval-model.html#%28tech._exception._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">exception
+handler</span></a> for a primitive error is always an instance of the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn%29%29" class="RktValLink" data-pltdoc="x">exn</a></span> structure type. Every <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn%29%29" class="RktValLink" data-pltdoc="x">exn</a></span> structure value has a
+<span class="RktSym">message</span> field that is a string, the primitive error message.
+The default exception handler recognizes exception values with the
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3f%29%29" class="RktValLink" data-pltdoc="x">exn?</a></span> predicate and passes the error message to the current
+<a href="exns.html#%28tech._error._display._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">error display handler</span></a> (see <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-display-handler%29%29" class="RktValLink" data-pltdoc="x">error-display-handler</a></span>).</p><p>Primitive procedures that accept a procedure argument with a
+particular required arity (e.g., <span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-input-file%29%29" class="RktValLink" data-pltdoc="x">call-with-input-file</a></span>,
+<span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call%2Fcc%29%29" class="RktValLink" data-pltdoc="x">call/cc</a></span>) check the argument&rsquo;s arity immediately, raising
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> if the arity is incorrect.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;err-msg-conventions&quot;">10.2.1<tt>&nbsp;</tt><a name="(part._err-msg-conventions)"></a>Error Message Conventions</h5><p>Racket&rsquo;s <a name="(tech._error._message._convention)"></a><span style="font-style: italic">error message convention</span> is to produce error
+messages with the following shape:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="sroman">&#8249;<span style="font-style: italic">srcloc</span>&#8250;</span><span class="RktSym">:</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">name</span>&#8250;</span><span class="RktSym">:</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">message</span>&#8250;</span><span class="stt">;</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">continued-message</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">field</span>&#8250;</span><span class="RktSym">:</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">detail</span>&#8250;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span></td></tr></table></blockquote><p>The message starts with an optional source location, <span class="sroman">&#8249;<span style="font-style: italic">srcloc</span>&#8250;</span>,
+which is followed by a colon and space when present. The message
+continues with an optional <span class="sroman">&#8249;<span style="font-style: italic">name</span>&#8250;</span> that usually identifies the
+complaining function, syntactic form, or other entity, but may also
+refer to an entity being complained about; the <span class="sroman">&#8249;<span style="font-style: italic">name</span>&#8250;</span> is also
+followed by a colon and space when present.</p><p>The <span class="sroman">&#8249;<span style="font-style: italic">message</span>&#8250;</span> should be relatively short, and it should be
+largely independent of specific values that triggered the error. More
+detailed explanation that requires multiple lines should continue with
+each line indented by a single space, in which case <span class="sroman">&#8249;<span style="font-style: italic">message</span>&#8250;</span>
+should end in a semi-colon (but the semi-colon should be omitted if
+<span class="sroman">&#8249;<span style="font-style: italic">continued-message</span>&#8250;</span> is not present). Message text should be
+lowercase&#8212;<wbr></wbr>using semi-colons to separate sentences if needed,
+although long explanations may be better deferred to extra fields.</p><p>Specific values that triggered the error or other helpful information
+should appear in separate <span class="sroman">&#8249;<span style="font-style: italic">field</span>&#8250;</span> lines, each of which is
+indented by two spaces. If a <span class="sroman">&#8249;<span style="font-style: italic">detail</span>&#8250;</span> is especially long or
+takes multiple lines, it should start on its own line after the
+<span class="sroman">&#8249;<span style="font-style: italic">field</span>&#8250;</span> label, and each of its lines should be indented by
+three spaces. Field names should be all lowercase.</p><p>A <span class="sroman">&#8249;<span style="font-style: italic">field</span>&#8250;</span> name should end with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">...</span><span class="hspace"></span></span> if the field
+provides relatively detailed information that might be distracting in
+common cases but useful in others. For example, when a contract
+failure is reported for a particular argument of a function, other
+arguments to the function might be shown in an &ldquo;other arguments...&rdquo;
+field. The intent is that fields whose names end in <span class="RktInBG"><span class="hspace"></span><span class="RktIn">...</span><span class="hspace"></span></span>
+might be hidden by default in an environment such as DrRacket.</p><p>Make <span class="sroman">&#8249;<span style="font-style: italic">field</span>&#8250;</span> names as short as possible, relying on
+<span class="sroman">&#8249;<span style="font-style: italic">message</span>&#8250;</span> or <span class="sroman">&#8249;<span style="font-style: italic">continued message</span>&#8250;</span> text to clarify the
+meaning for a field. For example, prefer &ldquo;given&rdquo; to &ldquo;given turtle&rdquo;
+as a field name, where <span class="sroman">&#8249;<span style="font-style: italic">message</span>&#8250;</span> is something like &ldquo;given
+turtle is too sleepy&rdquo; to clarify that &ldquo;given&rdquo; refers to a turtle.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;errorproc&quot;">10.2.2<tt>&nbsp;</tt><a name="(part._errorproc)"></a>Raising Exceptions</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._raise))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">barrier?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">barrier?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Raises an exception, where <span class="RktVar">v</span> represents the exception being
+raised. The <span class="RktVar">v</span> argument can be anything; it is passed to the
+current <a href="eval-model.html#%28tech._exception._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">exception handler</span></a>.</div></p><p>If <span class="RktVar">barrier?</span> is true, then the call to the <a href="eval-model.html#%28tech._exception._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">exception
+handler</span></a> is protected by a <a href="eval-model.html#%28tech._continuation._barrier%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation barrier</span></a>, so that
+multiple returns/escapes are impossible. All exceptions raised by
+<a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> functions effectively use <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span> with a
+<span class="RktVal">#t</span> value for <span class="RktVar">barrier?</span>.</p><p>Breaks are disabled from the time the exception is raised until the
+exception handler obtains control, and the handler itself is
+<span class="RktSym"><a href="breakhandler.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize-break%29%29" class="RktStxLink" data-pltdoc="x">parameterize-break</a></span>ed to disable breaks initially; see
+<a href="breakhandler.html" data-pltdoc="x">Breaks</a> for more information on breaks.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%29%29" class="RktStxLink" data-pltdoc="x">with-handlers</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span><span class="hspace">&nbsp;</span><span class="RktVal">18</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">23</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-exception</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3auser%29%29" class="RktValLink" data-pltdoc="x">exn:fail:user</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%29%29" class="RktStxLink" data-pltdoc="x">with-handlers</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">my-exception?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">e</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">my-exception</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"failed"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="RktValLink" data-pltdoc="x">current-continuation-marks</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">failed</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">uncaught exception: failed</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._error))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValDef RktValLink" data-pltdoc="x">error</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">message-sym</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">message-sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValDef RktValLink" data-pltdoc="x">error</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">message-str</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">message-str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValDef RktValLink" data-pltdoc="x">error</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">who-sym</span><span class="hspace">&nbsp;</span><span class="RktVar">format-str</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">who-sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">format-str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Raises the exception <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span>, which contains an error
+string. The different forms produce the error string in different
+ways:</div></p><ul><li><p><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="stt"> </span><span class="RktVar">message-sym</span><span class="RktPn">)</span> creates a message string by concatenating
+<span class="RktVal">"error: "</span> with the string form of <span class="RktVar">message-sym</span>. Use this
+form sparingly.</p></li><li><p><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="stt"> </span><span class="RktVar">message-str</span><span class="stt"> </span><span class="RktVar">v</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> creates a message string by
+concatenating <span class="RktVar">message-str</span> with string versions of the <span class="RktVar">v</span>s
+(as produced by the current error value conversion handler; see
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-value-~3estring-handler%29%29" class="RktValLink" data-pltdoc="x">error-value-&gt;string-handler</a></span>). A space is inserted before
+each <span class="RktVar">v</span>. Use this form sparingly, because it does not conform
+well to Racket&rsquo;s <a href="exns.html#%28tech._error._message._convention%29" class="techoutside" data-pltdoc="x"><span class="techinside">error message conventions</span></a>; consider
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arguments-error%29%29" class="RktValLink" data-pltdoc="x">raise-arguments-error</a></span>, instead. </p></li><li><p><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="stt"> </span><span class="RktVar">who-sym</span><span class="stt"> </span><span class="RktVar">format-str</span><span class="stt"> </span><span class="RktVar">v</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> creates a
+message string equivalent to the string created by</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append%29%29" class="RktValLink" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~s: "</span><span class="hspace">&nbsp;</span><span class="RktVar">format-str</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">who-sym</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></p></blockquote><p>When possible, use functions such as <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-argument-error%29%29" class="RktValLink" data-pltdoc="x">raise-argument-error</a></span>,
+instead, which construct messages that follow Racket&rsquo;s <a href="exns.html#%28tech._error._message._convention%29" class="techoutside" data-pltdoc="x"><span class="techinside">error message
+conventions</span></a>.</p></li></ul><p>In all cases, the constructed message string is passed to
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail</a></span>, and the resulting exception is raised.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">failed</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">error: failed</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"failed"</span><span class="hspace">&nbsp;</span><span class="RktVal">23</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">pizza</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">failed 23 'pizza '(1 2 3)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">method-a</span><span class="hspace">&nbsp;</span><span class="RktVal">"failed because ~a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"no argument supplied"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">method-a: failed because no argument supplied</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._raise-user-error))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-user-error%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-user-error</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">message-sym</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">message-sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-user-error%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-user-error</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">message-str</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">message-str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-user-error%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-user-error</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">who-sym</span><span class="hspace">&nbsp;</span><span class="RktVar">format-str</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">who-sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">format-str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span>, but constructs an exception with
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3auser%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:user</a></span> instead of <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail</a></span>. The
+default <a href="exns.html#%28tech._error._display._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">error display handler</span></a> does not show a &ldquo;stack trace&rdquo; for
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3auser%29%29" class="RktValLink" data-pltdoc="x">exn:fail:user</a></span> exceptions (see <a href="contmarks.html" data-pltdoc="x">Continuation Marks</a>), so
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-user-error%29%29" class="RktValLink" data-pltdoc="x">raise-user-error</a></span> should be used for errors that are intended
+for end users.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._raise-argument-error))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-argument-error%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-argument-error</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span><span class="RktVar">expected</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">expected</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-argument-error%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-argument-error</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">expected</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bad-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">expected</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates an <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> value and <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span>s it as
+an exception.  The <span class="RktVar">name</span> argument is used as the source
+procedure&rsquo;s name in the error message. The <span class="RktVar">expected</span> argument
+is used as a description of the expected contract (i.e., as a string,
+but the string is intended to contain a contract expression).</div></p><p>In the first form, <span class="RktVar">v</span> is the value received by the procedure
+that does not have the expected type.</p><p>In the second form, the bad argument is indicated by an index
+<span class="RktVar">bad-pos</span> (counting from <span style="font-style: italic"></span>0<span style="font-style: italic"></span>), and all of the original
+arguments <span class="RktVar">v</span> are provided (in order). The resulting error
+message names the bad argument and also lists the other arguments. If
+<span class="RktVar">bad-pos</span> is not less than the number of <span class="RktVar">v</span>s, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>The error message generated by <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-argument-error%29%29" class="RktValLink" data-pltdoc="x">raise-argument-error</a></span> is
+adjusted via <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-contract-~3eadjusted-string%29%29" class="RktValLink" data-pltdoc="x">error-contract-&gt;adjusted-string</a></span> and then
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-message-~3eadjusted-string%29%29" class="RktValLink" data-pltdoc="x">error-message-&gt;adjusted-string</a></span> using the default
+<span class="RktVal">'</span><span class="RktVal">racket</span> realm.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">feed-machine</span><span class="hspace">&nbsp;</span><span class="RktSym">bits</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bits</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-argument-error%29%29" class="RktValLink" data-pltdoc="x">raise-argument-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">feed-machine</span><span class="hspace">&nbsp;</span><span class="RktVal">"integer?"</span><span class="hspace">&nbsp;</span><span class="RktSym">bits</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"fed the machine"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">feed-machine</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">turkey</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">feed-machine: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 'turkey</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">feed-cow</span><span class="hspace">&nbsp;</span><span class="RktSym">animal</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">animal</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">cow</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-argument-error%29%29" class="RktValLink" data-pltdoc="x">raise-argument-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">feed-cow</span><span class="hspace">&nbsp;</span><span class="RktVal">"'cow"</span><span class="hspace">&nbsp;</span><span class="RktSym">animal</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"fed the cow"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">feed-cow</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">turkey</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">feed-cow: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: 'cow</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 'turkey</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">feed-animals</span><span class="hspace">&nbsp;</span><span class="RktSym">cow</span><span class="hspace">&nbsp;</span><span class="RktSym">sheep</span><span class="hspace">&nbsp;</span><span class="RktSym">goose</span><span class="hspace">&nbsp;</span><span class="RktSym">cat</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">goose</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">goose</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-argument-error%29%29" class="RktValLink" data-pltdoc="x">raise-argument-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">feed-animals</span><span class="hspace">&nbsp;</span><span class="RktVal">"'goose"</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym">cow</span><span class="hspace">&nbsp;</span><span class="RktSym">sheep</span><span class="hspace">&nbsp;</span><span class="RktSym">goose</span><span class="hspace">&nbsp;</span><span class="RktSym">cat</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"fed the animals"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">feed-animals</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">cow</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">sheep</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dog</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">cat</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">feed-animals: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: 'goose</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 'dog</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">argument position: 3rd</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">other arguments...:</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">'cow</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">'sheep</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">'cat</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._raise-argument-error*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-argument-error%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-argument-error*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span><span class="RktVar">realm</span><span class="hspace">&nbsp;</span><span class="RktVar">expected</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">realm</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">expected</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-argument-error%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-argument-error*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">realm</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">expected</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bad-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">realm</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">expected</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-argument-error%29%29" class="RktValLink" data-pltdoc="x">raise-argument-error</a></span>, but using the given <span class="RktVar">realm</span>
+for error-message adjustments.</div></p><p class="SHistory">Added in version 8.4.0.2 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._raise-result-error))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-result-error%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-result-error</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span><span class="RktVar">expected</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">expected</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-result-error%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-result-error</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">expected</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bad-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">expected</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-argument-error%29%29" class="RktValLink" data-pltdoc="x">raise-argument-error</a></span>, but the error message describe <span class="RktVar">v</span>
+as a &ldquo;result&rdquo; instead of an &ldquo;argument.&rdquo;</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._raise-result-error*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-result-error%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-result-error*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span><span class="RktVar">realm</span><span class="hspace">&nbsp;</span><span class="RktVar">expected</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">realm</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">expected</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-result-error%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-result-error*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">realm</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">expected</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bad-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">realm</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">expected</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-result-error%29%29" class="RktValLink" data-pltdoc="x">raise-result-error</a></span>, but using the given <span class="RktVar">realm</span>
+for error-message adjustments.</div></p><p class="SHistory">Added in version 8.4.0.2 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._raise-arguments-error))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arguments-error%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-arguments-error</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">message</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">field</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">message</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">field</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates an <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> value and <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span>s it as
+an exception.  The <span class="RktVar">name</span> is used as the source procedure&rsquo;s
+name in the error message. The <span class="RktVar">message</span> is the error
+message; if <span class="RktVar">message</span> contains newline characters, each extra line should be
+suitably indented (with one extra space at the start of each line), but it should not end with a newline character.
+Each <span class="RktVar">field</span> must have a corresponding <span class="RktVar">v</span>,
+and the two are rendered on their own
+line in the error message; each <span class="RktVar">v</span> is formatted
+using the error value conversion handler (see
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-value-~3estring-handler%29%29" class="RktValLink" data-pltdoc="x">error-value-&gt;string-handler</a></span>), unless <span class="RktVar">v</span> is a
+<a href="exns.html#%28tech._unquoted._printing._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">unquoted-printing string</span></a>, in which case the string content is
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>ed without using the error value conversion handler.</div></p><p>The error message generated by <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-result-error%29%29" class="RktValLink" data-pltdoc="x">raise-result-error</a></span> is adjusted
+via <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-contract-~3eadjusted-string%29%29" class="RktValLink" data-pltdoc="x">error-contract-&gt;adjusted-string</a></span> and then
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-message-~3eadjusted-string%29%29" class="RktValLink" data-pltdoc="x">error-message-&gt;adjusted-string</a></span> using the default
+<span class="RktVal">'</span><span class="RktVal">racket</span> realm.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arguments-error%29%29" class="RktValLink" data-pltdoc="x">raise-arguments-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">eat</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"fish is smaller than its given meal"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"fish"</span><span class="hspace">&nbsp;</span><span class="RktVal">12</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"meal"</span><span class="hspace">&nbsp;</span><span class="RktVal">13</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">eat: fish is smaller than its given meal</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">fish: 12</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">meal: 13</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._raise-arguments-error*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arguments-error%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-arguments-error*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">realm</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">message</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">field</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">realm</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">message</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">field</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arguments-error%29%29" class="RktValLink" data-pltdoc="x">raise-arguments-error</a></span>, but using the given <span class="RktVar">realm</span>
+for error-message adjustments.</div></p><p class="SHistory">Added in version 8.4.0.2 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._raise-range-error))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-range-error%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-range-error</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">type-description</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">index-prefix</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">index</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in-value</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">lower-bound</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">upper-bound</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">alt-lower-bound</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">type-description</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">index-prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">index</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in-value</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lower-bound</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">upper-bound</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">alt-lower-bound</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates an <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> value and <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span>s it as
+an exception to report an out-of-range error. The <span class="RktVar">type-description</span>
+string describes the value for which the index is meant to select an element,
+and <span class="RktVar">index-prefix</span> is a prefix for the word &ldquo;index.&rdquo; The <span class="RktVar">index</span>
+argument is the rejected index. The <span class="RktVar">in-value</span> argument is the value
+for which the index was meant. The <span class="RktVar">lower-bound</span> and <span class="RktVar">upper-bound</span>
+arguments specify the valid range of indices, inclusive; if <span class="RktVar">upper-bound</span>
+is below <span class="RktVar">lower-bound</span>, the value is characterized as &ldquo;empty.&rdquo; If <span class="RktVar">alt-lower-bound</span>
+is not <span class="RktVal">#f</span>, and if <span class="RktVar">index</span> is between <span class="RktVar">alt-lower-bound</span>
+and <span class="RktVar">upper-bound</span>, then the error is report as <span class="RktVar">index</span> being less
+than the &ldquo;starting&rdquo; index <span class="RktVar">lower-bound</span>.</div></p><p>Since <span class="RktVar">upper-bound</span> is inclusive, a typical value is <span class="emph">one
+less than</span> the size of a collection&#8212;<wbr></wbr>for example, <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="RktValLink" data-pltdoc="x">vector-length</a></span><span class="stt"> </span><span class="RktVar">vec</span><span class="RktPn">)</span><span class="RktPn">)</span>, <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._length%29%29" class="RktValLink" data-pltdoc="x">length</a></span><span class="stt"> </span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="RktPn">)</span>, and so on.</p><p>The error message generated by <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-range-error%29%29" class="RktValLink" data-pltdoc="x">raise-range-error</a></span> is adjusted
+via <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-message-~3eadjusted-string%29%29" class="RktValLink" data-pltdoc="x">error-message-&gt;adjusted-string</a></span> using the default
+<span class="RktVal">'</span><span class="RktVal">racket</span> realm.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-range-error%29%29" class="RktValLink" data-pltdoc="x">raise-range-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">vector-ref</span><span class="hspace">&nbsp;</span><span class="RktVal">"vector"</span><span class="hspace">&nbsp;</span><span class="RktVal">"starting "</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">vector-ref: starting index is out of range</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">starting index: 5</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">valid range: [0, 3]</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">vector: '#(1 2 3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-range-error%29%29" class="RktValLink" data-pltdoc="x">raise-range-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">vector-ref</span><span class="hspace">&nbsp;</span><span class="RktVal">"vector"</span><span class="hspace">&nbsp;</span><span class="RktVal">"ending "</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">vector-ref: ending index is out of range</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">ending index: 5</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">valid range: [0, 3]</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">vector: '#(1 2 3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-range-error%29%29" class="RktValLink" data-pltdoc="x">raise-range-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">vector-ref</span><span class="hspace">&nbsp;</span><span class="RktVal">"vector"</span><span class="hspace">&nbsp;</span><span class="RktVal">""</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">vector-ref: index is out of range for empty vector</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">index: 3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-range-error%29%29" class="RktValLink" data-pltdoc="x">raise-range-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">vector-ref</span><span class="hspace">&nbsp;</span><span class="RktVal">"vector"</span><span class="hspace">&nbsp;</span><span class="RktVal">"ending "</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">vector-ref: ending index is smaller than starting index</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">ending index: 1</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">starting index: 2</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">valid range: [0, 3]</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">vector: '#(1 2 3 4)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._raise-range-error*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-range-error%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-range-error*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">realm</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">type-description</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">index-prefix</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">index</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in-value</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">lower-bound</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">upper-bound</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">alt-lower-bound</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">realm</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">type-description</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">index-prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">index</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in-value</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lower-bound</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">upper-bound</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">alt-lower-bound</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-range-error%29%29" class="RktValLink" data-pltdoc="x">raise-range-error</a></span>, but using the given <span class="RktVar">realm</span>
+for error-message adjustments.</div></p><p class="SHistory">Added in version 8.4.0.2 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._raise-type-error))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-type-error%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-type-error</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span><span class="RktVar">expected</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">expected</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-type-error%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-type-error</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span><span class="RktVar">expected</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-pos</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">expected</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-argument-error%29%29" class="RktValLink" data-pltdoc="x">raise-argument-error</a></span>, but with Racket&rsquo;s old formatting
+conventions, and where <span class="RktVar">expected</span> is used as a &ldquo;type&rdquo;
+description instead of a contract expression. Use <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-argument-error%29%29" class="RktValLink" data-pltdoc="x">raise-argument-error</a></span>
+or <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-result-error%29%29" class="RktValLink" data-pltdoc="x">raise-result-error</a></span>, instead.</div></p><p>The error message generated by <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-type-error%29%29" class="RktValLink" data-pltdoc="x">raise-type-error</a></span> is adjusted
+via <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-message-~3eadjusted-string%29%29" class="RktValLink" data-pltdoc="x">error-message-&gt;adjusted-string</a></span> using the default
+<span class="RktVal">'</span><span class="RktVal">racket</span> realm.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._raise-mismatch-error))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-mismatch-error%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-mismatch-error</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">message</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...+</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">message</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arguments-error%29%29" class="RktValLink" data-pltdoc="x">raise-arguments-error</a></span>, but using Racket&rsquo;s old
+formatting conventions, with a required <span class="RktVar">v</span> immediately
+after the first <span class="RktVar">message</span> string, and with further <span class="RktVar">message</span>
+strings that are spliced into the message without line breaks or
+space. Use <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arguments-error%29%29" class="RktValLink" data-pltdoc="x">raise-arguments-error</a></span>, instead.</div></p><p>The error message generated by <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-mismatch-error%29%29" class="RktValLink" data-pltdoc="x">raise-mismatch-error</a></span> is adjusted
+via <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-message-~3eadjusted-string%29%29" class="RktValLink" data-pltdoc="x">error-message-&gt;adjusted-string</a></span> using the default
+<span class="RktVal">'</span><span class="RktVal">racket</span> realm.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._raise-arity-error))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arity-error%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-arity-error</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span><span class="RktVar">arity-v</span><span class="hspace">&nbsp;</span><span class="RktVar">arg-v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">arity-v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._arity-at-least~3f%29%29" class="RktValLink" data-pltdoc="x">arity-at-least?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._arity-at-least~3f%29%29" class="RktValLink" data-pltdoc="x">arity-at-least?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates an <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3aarity%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:arity</a></span> value and <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span>s
+it as an exception.  The <span class="RktVar">name</span> is used for the source
+procedure&rsquo;s name in the error message.</div></p><p>The <span class="RktVar">arity-v</span> value must
+be a possible result from <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-arity</a></span>, except
+that it does not have to be normalized (see <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity?</a></span> for
+the details of normalized arities); <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arity-error%29%29" class="RktValLink" data-pltdoc="x">raise-arity-error</a></span>
+will normalize the arity and use the normalized form in the error message.
+If <span class="RktVar">name</span> is a procedure, its actual arity is
+ignored.</p><p>The <span class="RktVar">arg-v</span> arguments are the actual supplied
+arguments, which are shown in the error message (using the error value
+conversion handler; see <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-value-~3estring-handler%29%29" class="RktValLink" data-pltdoc="x">error-value-&gt;string-handler</a></span>); also,
+the number of supplied <span class="RktVar">arg-v</span>s is explicitly mentioned in the
+message.</p><p>The error message generated by <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arity-error%29%29" class="RktValLink" data-pltdoc="x">raise-arity-error</a></span> is adjusted
+via <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-message-~3eadjusted-string%29%29" class="RktValLink" data-pltdoc="x">error-message-&gt;adjusted-string</a></span> using the default
+<span class="RktVal">'</span><span class="RktVal">racket</span> realm.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arity-error%29%29" class="RktValLink" data-pltdoc="x">raise-arity-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">unite</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">13</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"Virginia"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Maryland"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">unite: arity mismatch;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">the expected number of arguments does not match the given</span></p></td></tr><tr><td><p><span class="RktErr">number</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: at least 13</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 2</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">arguments...:</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">"Virginia"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">"Maryland"</span></p></td></tr></table></blockquote></div></p><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._raise-arity-error*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arity-error%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-arity-error*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">realm</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arity-v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arg-v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">realm</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">arity-v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._arity-at-least~3f%29%29" class="RktValLink" data-pltdoc="x">arity-at-least?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._arity-at-least~3f%29%29" class="RktValLink" data-pltdoc="x">arity-at-least?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote><p>Like <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arity-error%29%29" class="RktValLink" data-pltdoc="x">raise-arity-error</a></span>, but using the given <span class="RktVar">realm</span>
+for error-message adjustments.</p><p class="SHistory">Added in version 8.4.0.2 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._raise-arity-mask-error))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arity-mask-error%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-arity-mask-error</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span><span class="RktVar">mask</span><span class="hspace">&nbsp;</span><span class="RktVar">arg-v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mask</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arity-error%29%29" class="RktValLink" data-pltdoc="x">raise-arity-error</a></span>, but using the arity representation
+described with <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity-mask%29%29" class="RktValLink" data-pltdoc="x">procedure-arity-mask</a></span>.</div></p><p class="SHistory">Added in version 7.0.0.11 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._raise-arity-mask-error*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arity-mask-error%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-arity-mask-error*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">realm</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">mask</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arg-v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">realm</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mask</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arity-mask-error%29%29" class="RktValLink" data-pltdoc="x">raise-arity-mask-error</a></span>, but using the given <span class="RktVar">realm</span>
+for error-message adjustments.</div></p><p class="SHistory">Added in version 8.4.0.2 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._raise-result-arity-error))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-result-arity-error%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-result-arity-error</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arity-v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">detail-str</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">result-v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arity-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">detail-str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">result-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arity-error%29%29" class="RktValLink" data-pltdoc="x">raise-arity-error</a></span>, but reports a &ldquo;result&rdquo; mismatch
+instead of an &ldquo;argument&rdquo; mismatch. The <span class="RktVar">name</span> argument can be
+<span class="RktVal">#f</span> to omit an initial source for the error. The
+<span class="RktVar">detail-str</span> argument, if non-<span class="RktVal">#f</span>, should be a string
+that starts with a newline, since it is added near the end of the
+generated error message.</div></p><p>The error message generated by <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-result-arity-error%29%29" class="RktValLink" data-pltdoc="x">raise-result-arity-error</a></span> is
+adjusted via <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-message-~3eadjusted-string%29%29" class="RktValLink" data-pltdoc="x">error-message-&gt;adjusted-string</a></span> using the default
+<span class="RktVal">'</span><span class="RktVal">racket</span> realm.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-result-arity-error%29%29" class="RktValLink" data-pltdoc="x">raise-result-arity-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">let-values</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">"\n</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">in: example"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">2.0</span><span class="hspace">&nbsp;</span><span class="RktVal">"three"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">let-values: result arity mismatch;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">expected number of values not received</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: 2</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">received: 3</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: example</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">arguments...:</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">'a</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">2.0</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">"three"</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.90.0.26 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._raise-result-arity-error*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-result-arity-error%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-result-arity-error*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">realm</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arity-v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">detail-str</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">result-v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">realm</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arity-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">detail-str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">result-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-result-arity-error%29%29" class="RktValLink" data-pltdoc="x">raise-result-arity-error</a></span>, but using the given <span class="RktVar">realm</span>
+for error-message adjustments.</div></p><p class="SHistory">Added in version 8.4.0.2 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._raise-syntax-error))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._raise-syntax-error%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-syntax-error</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">message</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">expr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">sub-expr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">extra-sources</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">message-suffix</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:exn</span><span class="hspace">&nbsp;</span><span class="RktVar">exn</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">message</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sub-expr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">extra-sources</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">message-suffix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">""</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">exn</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3asyntax~3f%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax?</a></span><span class="RktPn">)</span></td></tr></table></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Creates an <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3asyntax~3f%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax?</a></span> value and <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span>s it as an
+exception.  Macros use this procedure to report syntax errors.</div></p><p>The <span class="RktVar">name</span> argument is usually <span class="RktVal">#f</span> when <span class="RktVar">expr</span>
+is provided; it is described in more detail below. The
+<span class="RktVar">message</span> is used as the main body of the error message; if
+<span class="RktVar">message</span> contains newline characters, each new line should be
+suitably indented (with one space at the start), and it should not end with a newline character.</p><p>The optional <span class="RktVar">expr</span> argument is the erroneous source syntax
+object or S-expression (but the expression <span class="RktVal">#f</span> cannot be
+represented by itself; it must be wrapped as a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax
+object</span></a>). The optional <span class="RktVar">sub-expr</span> argument is a syntax object
+or S-expression (again, <span class="RktVal">#f</span> cannot represent itself) within
+<span class="RktVar">expr</span> that more precisely locates the error.  Both may appear
+in the generated error-message text if
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-print-source-location%29%29" class="RktValLink" data-pltdoc="x">error-print-source-location</a></span> is <span class="RktVal">#t</span>. Source location
+information in the error-message text is similarly extracted from
+<span class="RktVar">sub-expr</span> or <span class="RktVar">expr</span> when at least one is a syntax
+object and <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-print-source-location%29%29" class="RktValLink" data-pltdoc="x">error-print-source-location</a></span> is <span class="RktVal">#t</span>.</p><p>If <span class="RktVar">sub-expr</span> is provided and not <span class="RktVal">#f</span>, it is used (in
+syntax form) for the <span class="RktSym">exprs</span> field of the generated exception
+record, else the <span class="RktVar">expr</span> is used if provided and not
+<span class="RktVal">#f</span>. In either case, the syntax object is <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span>ed onto
+<span class="RktVar">extra-sources</span> to produce the <span class="RktSym">exprs</span> field, or
+<span class="RktVar">extra-sources</span> is used directly for <span class="RktSym">exprs</span> if neither
+<span class="RktVar">expr</span> nor <span class="RktVar">sub-expr</span> is provided and not <span class="RktVal">#f</span>.
+The <span class="RktVar">extra-sources</span> argument is also used directly for
+<span class="RktSym">exprs</span> in the unusual case that the <span class="RktVar">sub-expr</span> or
+<span class="RktVar">expr</span> that would be included in <span class="RktSym">exprs</span> cannot be
+converted to a syntax object (because it contains a cycle).</p><p>The form name used in the generated error message is determined
+through a combination of the <span class="RktVar">name</span>, <span class="RktVar">expr</span>, and
+<span class="RktVar">sub-expr</span> arguments:</p><ul><li><p>When <span class="RktVar">name</span> is <span class="RktVal">#f</span>, and when <span class="RktVar">expr</span> is
+either an identifier or a syntax pair containing an identifier as
+its first element, then the form name from the error message is the
+identifier&rsquo;s symbol.</p></li><li><p>When <span class="RktVar">name</span> is <span class="RktVal">#f</span> and when <span class="RktVar">expr</span> is not
+an identifier or a syntax pair containing an identifier as its
+first element, then the form name in the error message is
+<span class="RktVal">"?"</span>.</p></li><li><p>When <span class="RktVar">name</span> is a symbol, then the symbol
+is used as the form name in the generated error message.</p></li></ul><p>The <span class="RktVar">message-suffix</span> string is appended to the end of the error
+message. If not <span class="RktVal">""</span>, it should normally start with a newline
+and two spaces to add extra fields to the message (see
+<a href="exns.html#%28part._err-msg-conventions%29" data-pltdoc="x">Error Message Conventions</a>).</p><p>If specified, <span class="RktVar">exn</span> should be a constructor or function that
+has the same signature as the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax</a></span> constructor.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._raise-syntax-error%29%29" class="RktValLink" data-pltdoc="x">raise-syntax-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">"bad syntax"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">bad</span><span class="hspace">&nbsp;</span><span class="RktVal">syntax</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">?: bad syntax</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (bad syntax)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._raise-syntax-error%29%29" class="RktValLink" data-pltdoc="x">raise-syntax-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">"unbound identifier"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">unbound-id</span><span class="hspace">&nbsp;</span><span class="RktPn">#:exn</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax~3aunbound%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax:unbound</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">?: unbound identifier</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: unbound-id</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.90.0.18 of package <span class="stt">base</span>: Added the <span class="RktVar">message-suffix</span> optional argument.<br/>Changed in version 8.4.0.6: Added the <span class="RktVar">exn</span> optional argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._unquoted-printing-string~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._unquoted-printing-string~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">unquoted-printing-string?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._unquoted-printing-string))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._unquoted-printing-string%29%29" class="RktValDef RktValLink" data-pltdoc="x">unquoted-printing-string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._unquoted-printing-string~3f%29%29" class="RktValLink" data-pltdoc="x">unquoted-printing-string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._unquoted-printing-string-value))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._unquoted-printing-string-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">unquoted-printing-string-value</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">ups</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ups</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._unquoted-printing-string~3f%29%29" class="RktValLink" data-pltdoc="x">unquoted-printing-string?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">An <a name="(tech._unquoted._printing._string)"></a><span style="font-style: italic">unquoted-printing string</span> wraps a string and
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>s, <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>s, and <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>s the same way
+that the string <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>s. An <a href="exns.html#%28tech._unquoted._printing._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">unquoted-printing string</span></a>
+is especially useful with <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arguments-error%29%29" class="RktValLink" data-pltdoc="x">raise-arguments-error</a></span> to serve as a
+field &ldquo;value&rdquo; that causes literal text to be printed as the field
+content.</div></p><p>The <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._unquoted-printing-string~3f%29%29" class="RktValLink" data-pltdoc="x">unquoted-printing-string?</a></span> procedure returns <span class="RktVal">#t</span>
+if <span class="RktVar">v</span> is a <a href="exns.html#%28tech._unquoted._printing._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">unquoted-printing string</span></a>, <span class="RktVal">#f</span>
+otherwise. The <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._unquoted-printing-string%29%29" class="RktValLink" data-pltdoc="x">unquoted-printing-string</a></span> creates a
+<a href="exns.html#%28tech._unquoted._printing._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">unquoted-printing string</span></a> value that encapsulates the string
+<span class="RktVar">s</span>, and <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._unquoted-printing-string-value%29%29" class="RktValLink" data-pltdoc="x">unquoted-printing-string-value</a></span> returns the
+string within a <a href="exns.html#%28tech._unquoted._printing._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">unquoted-printing string</span></a>.</p><p class="SHistory">Added in version 6.10.0.2 of package <span class="stt">base</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Handling_Exceptions&quot;">10.2.3<tt>&nbsp;</tt><a name="(part._.Handling_.Exceptions)"></a>Handling Exceptions</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/more-scheme..rkt)._call-with-exception-handler))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call-with-exception-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-exception-handler</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVar">thunk</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Installs <span class="RktVar">f</span> as the <a href="eval-model.html#%28tech._exception._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">exception handler</span></a> for the
+<a href="eval-model.html#%28tech._dynamic._extent%29" class="techoutside" data-pltdoc="x"><span class="techinside">dynamic extent</span></a> of the call to <span class="RktVar">thunk</span>. If an exception
+is raised during the evaluation of <span class="RktVar">thunk</span> (in an extension of
+the current continuation that does not have its own exception
+handler), then <span class="RktVar">f</span> is applied to the <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span>d value in
+the continuation of the <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span> call (but the continuation is
+normally extended
+with a <a href="eval-model.html#%28tech._continuation._barrier%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation barrier</span></a>; see <a href="eval-model.html#%28part._prompt-model%29" data-pltdoc="x">Prompts, Delimited Continuations, and Barriers</a> and
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span>).</div></p><p>Any procedure that takes one argument can be an exception handler.
+Normally, an exception handler escapes from the context of the
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span> call via <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._abort-current-continuation%29%29" class="RktValLink" data-pltdoc="x">abort-current-continuation</a></span> or some other escape
+mechanism. To propagate an exception to the &ldquo;previous&rdquo; exception
+handler&#8212;<wbr></wbr>that is, the exception handler associated with the rest of
+the continuation after the point where the called exception handler
+was associated with the continuation&#8212;<wbr></wbr>an exception handler can simply
+return a result instead of escaping, in which case the <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span> call
+propagates the value to the previous exception handler (still in the
+dynamic extent of the call to <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span>, and under the same
+barrier, if any). If an exception handler returns a result and no
+previous handler is available, the <a href="exns.html#%28tech._uncaught._exception._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">uncaught-exception handler</span></a>
+is used.</p><p>A call to an exception handler is <span class="RktSym"><a href="breakhandler.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize-break%29%29" class="RktStxLink" data-pltdoc="x">parameterize-break</a></span>ed to
+disable breaks, and it is wrapped with
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call-with-exception-handler%29%29" class="RktValLink" data-pltdoc="x">call-with-exception-handler</a></span> to install an exception handler
+that reports both the original and newly raised exceptions via the
+<a href="exns.html#%28tech._error._display._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">error display handler</span></a> and then escapes via the <a href="exns.html#%28tech._error._escape._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">error
+escape handler</span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._uncaught-exception-handler))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._uncaught-exception-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">uncaught-exception-handler</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._uncaught-exception-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">uncaught-exception-handler</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines an <a name="(tech._uncaught._exception._handler)"></a><span style="font-style: italic">uncaught-exception handler</span> used by
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span> when the relevant continuation has no exception handler
+installed with <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call-with-exception-handler%29%29" class="RktValLink" data-pltdoc="x">call-with-exception-handler</a></span> or
+<span class="RktSym"><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%29%29" class="RktStxLink" data-pltdoc="x">with-handlers</a></span>. Unlike exception handlers installed with
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call-with-exception-handler%29%29" class="RktValLink" data-pltdoc="x">call-with-exception-handler</a></span>, the uncaught-exception
+handler must not return a value when called by <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span>; if
+it returns, an exception is raised (to be handled by an exception
+handler that reports both the original and newly raised exception).</div></p><p>The default uncaught-exception handler prints an error message using
+the current <a href="exns.html#%28tech._error._display._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">error display handler</span></a> (see <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-display-handler%29%29" class="RktValLink" data-pltdoc="x">error-display-handler</a></span>),
+unless the argument to the handler is an instance of <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak~3ahang-up%29%29" class="RktValLink" data-pltdoc="x">exn:break:hang-up</a></span>.
+If the argument to the handler is an instance of <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak~3ahang-up%29%29" class="RktValLink" data-pltdoc="x">exn:break:hang-up</a></span>
+or <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak~3aterminate%29%29" class="RktValLink" data-pltdoc="x">exn:break:terminate</a></span>, the default uncaught-exception handler
+then calls the <a href="Exiting.html#%28tech._exit._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">exit handler</span></a> with <span class="RktVal">1</span>, which normally exits
+or escapes. For any argument, the default uncaught-exception handler
+then escapes by calling the current <a href="exns.html#%28tech._error._escape._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">error escape handler</span></a> (see
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-escape-handler%29%29" class="RktValLink" data-pltdoc="x">error-escape-handler</a></span>). The call to each handler is
+<span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>d to set <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-display-handler%29%29" class="RktValLink" data-pltdoc="x">error-display-handler</a></span> to the
+default <a href="exns.html#%28tech._error._display._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">error display handler</span></a>, and it is <span class="RktSym"><a href="breakhandler.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize-break%29%29" class="RktStxLink" data-pltdoc="x">parameterize-break</a></span>ed
+to disable breaks. The call to the <a href="exns.html#%28tech._error._escape._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">error escape handler</span></a> is further
+parameterized to set <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-escape-handler%29%29" class="RktValLink" data-pltdoc="x">error-escape-handler</a></span> to the default
+<a href="exns.html#%28tech._error._escape._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">error escape handler</span></a>; if the <a href="exns.html#%28tech._error._escape._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">error escape handler</span></a> returns, then
+the default <a href="exns.html#%28tech._error._escape._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">error escape handler</span></a> is called.</p><p>When the current <a href="exns.html#%28tech._error._display._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">error display handler</span></a> is the default handler, then the
+error-display call is parameterized to install an emergency error
+display handler that logs an error (see <span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-error%29%29" class="RktStxLink" data-pltdoc="x">log-error</a></span>) and never
+fails.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/more-scheme..rkt)._with-handlers))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">with-handlers</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">pred-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">handler-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Evaluates each <span class="RktVar">pred-expr</span> and <span class="RktVar">handler-expr</span> in the
+order that they are specified, and then evaluates the <span class="RktVar">body</span>s
+with a new exception handler during its dynamic extent.</div></p><p>The new exception handler processes an exception only if one of the
+<span class="RktVar">pred-expr</span> procedures returns a true value when applied to the
+exception, otherwise the exception handler is invoked from the
+continuation of the <span class="RktSym"><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%29%29" class="RktStxLink" data-pltdoc="x">with-handlers</a></span> expression (by raising the
+exception again). If an exception is handled by one of the
+<span class="RktVar">handler-expr</span> procedures, the result of the entire
+<span class="RktSym"><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%29%29" class="RktStxLink" data-pltdoc="x">with-handlers</a></span> expression is the return value of the handler.</p><p>When an exception is raised during the evaluation of <span class="RktVar">body</span>s,
+each predicate procedure <span class="RktVar">pred-expr</span> is applied to the
+exception value; if a predicate returns a true value, the
+corresponding <span class="RktVar">handler-expr</span> procedure is invoked with the
+exception as an argument. The predicates are tried in the order that
+they are specified.</p><p>Before any predicate or handler procedure is invoked, the continuation
+of the entire <span class="RktSym"><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%29%29" class="RktStxLink" data-pltdoc="x">with-handlers</a></span> expression is restored, but also
+<span class="RktSym"><a href="breakhandler.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize-break%29%29" class="RktStxLink" data-pltdoc="x">parameterize-break</a></span>ed to disable breaks. Thus, breaks are
+disabled by default during the predicate and handler procedures (see
+<a href="breakhandler.html" data-pltdoc="x">Breaks</a>), and the exception handler is the one from
+the continuation of the <span class="RktSym"><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%29%29" class="RktStxLink" data-pltdoc="x">with-handlers</a></span> expression.</p><p>The <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3f%29%29" class="RktValLink" data-pltdoc="x">exn:fail?</a></span> procedure is useful as a handler predicate to
+catch all error exceptions. Avoid using <span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">#t</span><span class="RktPn">)</span> as a
+predicate, because the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak%29%29" class="RktValLink" data-pltdoc="x">exn:break</a></span> exception typically should
+not be caught (unless it will be re-raised to cooperatively
+break). Beware, also, of catching and discarding exceptions, because
+discarding an error message can make debugging unnecessarily
+difficult; instead of discarding an error message, consider logging it
+via <span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-error%29%29" class="RktStxLink" data-pltdoc="x">log-error</a></span> or a logging form created by
+<span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._define-logger%29%29" class="RktStxLink" data-pltdoc="x">define-logger</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%29%29" class="RktStxLink" data-pltdoc="x">with-handlers</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3asyntax~3f%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">e</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"got a syntax error"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._raise-syntax-error%29%29" class="RktValLink" data-pltdoc="x">raise-syntax-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">"a syntax error"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">got a syntax error</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%29%29" class="RktStxLink" data-pltdoc="x">with-handlers</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3asyntax~3f%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">e</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"got a syntax error"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3f%29%29" class="RktValLink" data-pltdoc="x">exn:fail?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">e</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"fallback clause"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._raise-syntax-error%29%29" class="RktValLink" data-pltdoc="x">raise-syntax-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">"a syntax error"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">got a syntax error</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/more-scheme..rkt)._with-handlers*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">with-handlers*</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">pred-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">handler-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%29%29" class="RktStxLink" data-pltdoc="x">with-handlers</a></span>, but if a <span class="RktVar">handler-expr</span> procedure
+is called, breaks are not explicitly disabled, and the handler call is
+in tail position with respect to the <span class="RktSym"><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%2A%29%29" class="RktStxLink" data-pltdoc="x">with-handlers*</a></span> form.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Configuring_Default_Handling&quot;">10.2.4<tt>&nbsp;</tt><a name="(part._.Configuring_.Default_.Handling)"></a>Configuring Default Handling</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._error-escape-handler))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-escape-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">error-escape-handler</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-escape-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">error-escape-handler</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A parameter for the <a name="(tech._error._escape._handler)"></a><span style="font-style: italic">error escape handler</span>, which takes no
+arguments and escapes from the dynamic context of an exception.  The
+default error escape handler escapes using
+<span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._abort-current-continuation%29%29" class="RktValLink" data-pltdoc="x">abort-current-continuation</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._default-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">default-continuation-prompt-tag</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span>.</div></p><p>The error escape handler is normally called directly by an exception
+handler, in a <a href="eval-model.html#%28tech._parameterization%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameterization</span></a> that sets the <a href="exns.html#%28tech._error._display._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">error
+display handler</span></a> and <a href="exns.html#%28tech._error._escape._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">error escape handler</span></a> to the default
+handlers, and it is normally <span class="RktSym"><a href="breakhandler.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize-break%29%29" class="RktStxLink" data-pltdoc="x">parameterize-break</a></span>ed to disable
+breaks. To escape from a run-time error in a different context, use
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span> or <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span>.</p><p>Due to a <a href="eval-model.html#%28tech._continuation._barrier%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation barrier</span></a> around exception-handling calls,
+an error escape handler cannot invoke a full continuation that was
+created prior to the exception, but it can abort to a prompt (see
+<span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-prompt%29%29" class="RktValLink" data-pltdoc="x">call-with-continuation-prompt</a></span>) or invoke an escape
+continuation (see <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-escape-continuation%29%29" class="RktValLink" data-pltdoc="x">call-with-escape-continuation</a></span>).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._error-display-handler))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-display-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">error-display-handler</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-display-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">error-display-handler</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A parameter for the <a name="(tech._error._display._handler)"></a><span style="font-style: italic">error display handler</span>, which is called
+by the default exception handler with an error message and the
+exception value. More generally, the handler&rsquo;s first argument is a
+string to print as an error message, and the second is a value
+representing a raised exception. An error display handler can
+print errors in different ways, but it should always print to the
+current error port.</div></p><p>The default error display handler <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>s its first argument
+to the current error port (determined by the
+<span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-error-port%29%29" class="RktValLink" data-pltdoc="x">current-error-port</a></span> parameter) and extracts a stack trace (see
+<span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3econtext%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set-&gt;context</a></span>) to display from the second
+argument if it is an <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn%29%29" class="RktValLink" data-pltdoc="x">exn</a></span> value but not an
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3auser%29%29" class="RktValLink" data-pltdoc="x">exn:fail:user</a></span> value.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The default error display handler in DrRacket also uses
+the second argument to highlight source locations.</p></blockquote></blockquote></blockquote><p>To report a run-time error, use <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span> or procedures like
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span>, instead of calling the error display handler
+directly.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._error-print-width))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-print-width%29%29" class="RktValDef RktValLink" data-pltdoc="x">error-print-width</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-print-width%29%29" class="RktValDef RktValLink" data-pltdoc="x">error-print-width</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">width</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A parameter whose value is used as the maximum number of characters
+used to print a Racket value that is embedded in a primitive error
+message.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._error-print-context-length))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-print-context-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">error-print-context-length</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-print-context-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">error-print-context-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">cnt</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cnt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A parameter whose value is used by the default <a href="exns.html#%28tech._error._display._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">error display handler</span></a>
+as the maximum number of lines of context (or &ldquo;stack trace&rdquo;) to
+print; a single &ldquo;...&rdquo; line is printed if more lines are available
+after the first <span class="RktVar">cnt</span> lines. A <span class="RktVal">0</span> value for
+<span class="RktVar">cnt</span> disables context printing entirely.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._error-print-source-location))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-print-source-location%29%29" class="RktValDef RktValLink" data-pltdoc="x">error-print-source-location</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-print-source-location%29%29" class="RktValDef RktValLink" data-pltdoc="x">error-print-source-location</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">include?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">include?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls whether read and syntax error messages
+include source information, such as the source line and column or the
+expression.  This parameter also controls the error message when a
+module-defined variable is accessed before its definition is executed;
+the parameter determines whether the message includes a module
+name. Only the message field of an <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span>,
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax</a></span>, or <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3avariable%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:variable</a></span>
+structure is affected by the parameter. The default is <span class="RktVal">#t</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._error-value-~3estring-handler))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-value-~3estring-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">error-value-&gt;string-handler</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-value-~3estring-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">error-value-&gt;string-handler</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the <a name="(tech._error._value._conversion._handler)"></a><span style="font-style: italic">error value conversion
+handler</span>, which is used to print a Racket value that is embedded in a
+primitive error message.</div></p><p>The integer argument to the handler specifies the maximum number of
+characters that should be used to represent the value in the resulting
+string.  The default error value conversion handler <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>s
+the value into a string (using the current <a href="Writing.html#%28tech._global._port._print._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">global port print
+handler</span></a>; see <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._global-port-print-handler%29%29" class="RktValLink" data-pltdoc="x">global-port-print-handler</a></span>). If the printed form
+is too long, the printed form is truncated and the last three
+characters of the return string are set to &ldquo;...&rdquo;.</p><p>If the string returned by an error value conversion handler is longer
+than requested, the string is destructively &ldquo;truncated&rdquo; by setting
+the first extra position in the string to the null character. If a
+non-string is returned, then the string <span class="RktVal">"..."</span> is used. If a
+primitive error string needs to be generated before the handler has
+returned, the default error value conversion handler is used.</p><p>Calls to an error value conversion handler are <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>d
+to re-install the default error value conversion handler, and to
+enable printing of unreadable values (see <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-unreadable%29%29" class="RktValLink" data-pltdoc="x">print-unreadable</a></span>).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._error-syntax-~3estring-handler))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-syntax-~3estring-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">error-syntax-&gt;string-handler</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-syntax-~3estring-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">error-syntax-&gt;string-handler</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the <a name="(tech._error._syntax._conversion._handler)"></a><span style="font-style: italic">error syntax
+conversion handler</span>, which is used to print a syntax form that is
+embedded in an error message, such as from <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._raise-syntax-error%29%29" class="RktValLink" data-pltdoc="x">raise-syntax-error</a></span>
+when <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-print-source-location%29%29" class="RktValLink" data-pltdoc="x">error-print-source-location</a></span> is <span class="RktVal">#t</span>.</div></p><p>The arguments to the handler are analogous to the arguments for a
+<a href="exns.html#%28tech._error._value._conversion._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">error value conversion handler</span></a> as configured with
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-value-~3estring-handler%29%29" class="RktValLink" data-pltdoc="x">error-value-&gt;string-handler</a></span>, except that <span class="RktVal">#f</span> can be
+provided instead of an integer for the length, meaning that the
+printed form should not be truncated. The first argument is normally a
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>, but in the same way that
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._raise-syntax-error%29%29" class="RktValLink" data-pltdoc="x">raise-syntax-error</a></span> accepts other S-expressions, the error
+syntax conversion handler must also handle representations that are
+not syntax objects.</p><p class="SHistory">Added in version 8.2.0.8 of package <span class="stt">base</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Built-in_Exception_Types&quot;">10.2.5<tt>&nbsp;</tt><a name="(part._.Built-in_.Exception_.Types)"></a>Built-in Exception Types</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((quote._~23~25kernel)._exn-continuation-marks))"></a><a name="(def._((quote._~23~25kernel)._exn-message))"></a><a name="(def._((lib._racket/private/base..rkt)._make-exn))"></a><a name="(def._((quote._~23~25kernel)._exn~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn))"></a><a name="(def._((lib._racket/private/base..rkt)._exn))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">message</span><span class="stt"> </span><span class="RktSym">continuation-marks</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn%29%29" class="RktValLink" data-pltdoc="x">make-exn</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">message</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">continuation-marks</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set~3f%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">The base <a href="structures.html#%28tech._structure._type%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type</span></a> for exceptions. The <span class="RktSym">message</span>
+field contains an error message, and the <span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-marks%29%29" class="RktValLink" data-pltdoc="x">continuation-marks</a></span>
+field contains the value produced by <span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="RktValLink" data-pltdoc="x">current-continuation-marks</a></span><span class="RktPn">)</span>
+immediately before the exception was raised.</div></p><p>Exceptions raised by Racket form a hierarchy under <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn%29%29" class="RktValLink" data-pltdoc="x">exn</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn%29%29" class="RktValLink" data-pltdoc="x">exn</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3aarity%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:arity</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3adivide-by-zero%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:divide-by-zero</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3anon-fixnum-result%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:non-fixnum-result</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3acontinuation%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:continuation</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3avariable%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:variable</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax~3aunbound%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax:unbound</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax~3amissing-module%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax:missing-module</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread~3aeof%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read:eof</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread~3anon-char%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read:non-char</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3aexists%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem:exists</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3aversion%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem:version</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3aerrno%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem:errno</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3amissing-module%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem:missing-module</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork%29%29" class="RktValLink" data-pltdoc="x">exn:fail:network</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork~3aerrno%29%29" class="RktValLink" data-pltdoc="x">exn:fail:network:errno</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aout-of-memory%29%29" class="RktValLink" data-pltdoc="x">exn:fail:out-of-memory</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aunsupported%29%29" class="RktValLink" data-pltdoc="x">exn:fail:unsupported</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3auser%29%29" class="RktValLink" data-pltdoc="x">exn:fail:user</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak%29%29" class="RktValLink" data-pltdoc="x">exn:break</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak~3ahang-up%29%29" class="RktValLink" data-pltdoc="x">exn:break:hang-up</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak~3aterminate%29%29" class="RktValLink" data-pltdoc="x">exn:break:terminate</a></span></td></tr></table></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn%29%29" class="RktValLink" data-pltdoc="x">exn</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised for exceptions that represent errors, as opposed to
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak%29%29" class="RktValLink" data-pltdoc="x">exn:break</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3acontract))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3acontract~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3acontract))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3acontract))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:contract</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised for errors from the inappropriate run-time use of a function or
+syntactic form.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3acontract~3aarity))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3acontract~3aarity~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3acontract~3aarity))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3acontract~3aarity))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3aarity%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:contract:arity</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3acontract~3aarity%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:contract:arity</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised when a procedure is applied to the wrong number of arguments.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3acontract~3adivide-by-zero))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3acontract~3adivide-by-zero~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3acontract~3adivide-by-zero))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3acontract~3adivide-by-zero))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3adivide-by-zero%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:contract:divide-by-zero</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3acontract~3adivide-by-zero%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:contract:divide-by-zero</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised for division by exact zero.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3acontract~3anon-fixnum-result))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3acontract~3anon-fixnum-result~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3acontract~3anon-fixnum-result))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3acontract~3anon-fixnum-result))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3anon-fixnum-result%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:contract:non-fixnum-result</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3acontract~3anon-fixnum-result%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:contract:non-fixnum-result</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised by functions like <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2B%29%29" class="RktValLink" data-pltdoc="x">fx+</a></span> when the result would not be a fixnum.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3acontract~3acontinuation))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3acontract~3acontinuation~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3acontract~3acontinuation))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3acontract~3acontinuation))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3acontinuation%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:contract:continuation</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3acontract~3acontinuation%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:contract:continuation</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised when a continuation is applied where the jump would cross a
+continuation barrier.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((quote._~23~25kernel)._exn~3afail~3acontract~3avariable-id))"></a><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3acontract~3avariable))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3acontract~3avariable~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3acontract~3avariable))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3acontract~3avariable))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3avariable%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:contract:variable</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">id</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3acontract~3avariable%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:contract:variable</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Raised for a reference to a not-yet-defined <a href="eval-model.html#%28tech._top._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level variable</span></a>
+or <a href="eval-model.html#%28tech._module._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">module-level variable</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((quote._~23~25kernel)._exn~3afail~3asyntax-exprs))"></a><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3asyntax))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3asyntax~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3asyntax))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3asyntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">exprs</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3asyntax%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">exprs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised for a syntax error that is not a <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> error. The
+<span class="RktSym">exprs</span> indicate the relevant source expressions,
+least-specific to most-specific.</div></p><p>This structure type implements the <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._prop~3aexn~3asrclocs%29%29" class="RktValLink" data-pltdoc="x">prop:exn:srclocs</a></span> property.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3asyntax~3aunbound))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3asyntax~3aunbound~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3asyntax~3aunbound))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3asyntax~3aunbound))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax~3aunbound%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:syntax:unbound</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3asyntax~3aunbound%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:syntax:unbound</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised by <span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span> or <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span> for an
+unbound identifier within a module.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((quote._~23~25kernel)._exn~3afail~3asyntax~3amissing-module-path))"></a><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3asyntax~3amissing-module))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3asyntax~3amissing-module~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3asyntax~3amissing-module))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3asyntax~3amissing-module))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax~3amissing-module%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:syntax:missing-module</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">path</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3asyntax~3amissing-module%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:syntax:missing-module</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Raised by the default <a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name resolver</span></a> or default
+<a href="eval.html#%28tech._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">load handler</span></a> to report a module path&#8212;<wbr></wbr>a reported in the
+<span class="RktSym">path</span> field&#8212;<wbr></wbr>whose implementation file cannot be
+found.</div></p><p>The default <a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name resolver</span></a> raises this exception only
+when it is given a syntax object as its second argument, and the
+default <a href="eval.html#%28tech._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">load handler</span></a> raises this exception only when the value
+of <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-path-for-load%29%29" class="RktValLink" data-pltdoc="x">current-module-path-for-load</a></span> is a syntax object (in which
+case both the <span class="RktSym">exprs</span> field and the <span class="RktSym">path</span> field
+are determined by the syntax object).</p><p>This structure type implements the <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._prop~3aexn~3amissing-module%29%29" class="RktValLink" data-pltdoc="x">prop:exn:missing-module</a></span> property.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((quote._~23~25kernel)._exn~3afail~3aread-srclocs))"></a><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3aread))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3aread~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3aread))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3aread))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:read</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">srclocs</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:read</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">srclocs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._srcloc~3f%29%29" class="RktValLink" data-pltdoc="x">srcloc?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised for a <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> error. The <span class="RktSym">srclocs</span> indicate the
+relevant source expressions.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3aread~3aeof))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3aread~3aeof~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3aread~3aeof))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3aread~3aeof))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread~3aeof%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:read:eof</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3aread~3aeof%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:read:eof</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised for a <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> error, specifically when the error is due
+to an unexpected end-of-file.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3aread~3anon-char))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3aread~3anon-char~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3aread~3anon-char))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3aread~3anon-char))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread~3anon-char%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:read:non-char</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3aread~3anon-char%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:read:non-char</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised for a <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> error, specifically when the error is due
+to an unexpected non-character (i.e., &ldquo;special&rdquo;) element in the
+input stream.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3afilesystem))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3afilesystem~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3afilesystem))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3afilesystem))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:filesystem</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised for an error related to the filesystem (such as a file not
+found).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3afilesystem~3aexists))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3afilesystem~3aexists~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3afilesystem~3aexists))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3afilesystem~3aexists))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3aexists%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:filesystem:exists</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3afilesystem~3aexists%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:filesystem:exists</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised for an error when attempting to create a file that exists
+already.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3afilesystem~3aversion))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3afilesystem~3aversion~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3afilesystem~3aversion))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3afilesystem~3aversion))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3aversion%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:filesystem:version</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3afilesystem~3aversion%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:filesystem:version</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised for a version-mismatch error when loading an extension.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((quote._~23~25kernel)._exn~3afail~3afilesystem~3aerrno-errno))"></a><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3afilesystem~3aerrno))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3afilesystem~3aerrno~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3afilesystem~3aerrno))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3afilesystem~3aerrno))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3aerrno%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:filesystem:errno</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">errno</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3afilesystem~3aerrno%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:filesystem:errno</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">errno</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">posix</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">windows</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">gai</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised for a filesystem error for which a system error code is
+available. The symbol part of an <span class="RktSym">errno</span> field indicates the
+category of the error code: <span class="RktVal">'</span><span class="RktVal">posix</span> indicates a C/Posix
+<span class="stt">errno</span> value, <span class="RktVal">'</span><span class="RktVal">windows</span> indicates a Windows system error
+code (under Windows, only), and <span class="RktVal">'</span><span class="RktVal">gai</span> indicates a
+<span class="stt">getaddrinfo</span> error code (which shows up only in
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork~3aerrno%29%29" class="RktValLink" data-pltdoc="x">exn:fail:network:errno</a></span> exceptions for operations that resolve
+hostnames, but is allowed in <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3aerrno%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem:errno</a></span>
+instances for consistency).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="nobreak"><a name="(def._((quote._~23~25kernel)._exn~3afail~3afilesystem~3amissing-module-path))"></a><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3afilesystem~3amissing-module))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3afilesystem~3amissing-module~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3afilesystem~3amissing-module))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3afilesystem~3amissing-module))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3amissing-module%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:filesystem:missing-module</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span></span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktPn">(</span><span class="nobreak"><span class="RktSym">path</span><span class="RktPn">)</span></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3afilesystem~3amissing-module%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:filesystem:missing-module</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Raised by the default <a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name resolver</span></a> or default
+<a href="eval.html#%28tech._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">load handler</span></a> to report a module path&#8212;<wbr></wbr>a reported in the
+<span class="RktSym">path</span> field&#8212;<wbr></wbr>whose implementation file cannot be
+found.</div></p><p>The default <a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name resolver</span></a> raises this exception only
+when it is <span class="emph">not</span> given a syntax object as its second argument, and the
+default <a href="eval.html#%28tech._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">load handler</span></a> raises this exception only when the value
+of <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-path-for-load%29%29" class="RktValLink" data-pltdoc="x">current-module-path-for-load</a></span> is <span class="emph">not</span> a syntax object.</p><p>This structure type implements the <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._prop~3aexn~3amissing-module%29%29" class="RktValLink" data-pltdoc="x">prop:exn:missing-module</a></span> property.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3anetwork))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3anetwork~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3anetwork))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3anetwork))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:network</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3anetwork%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:network</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised for TCP and UDP errors.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((quote._~23~25kernel)._exn~3afail~3anetwork~3aerrno-errno))"></a><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3anetwork~3aerrno))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3anetwork~3aerrno~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3anetwork~3aerrno))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3anetwork~3aerrno))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork~3aerrno%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:network:errno</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork%29%29" class="RktValLink" data-pltdoc="x">exn:fail:network</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">errno</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3anetwork~3aerrno%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:network:errno</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">errno</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">posix</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">windows</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">gai</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised for a TCP or UDP error for which a system error code is
+available, where the <span class="RktSym">errno</span> field is as for
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3aerrno%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem:errno</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3aout-of-memory))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3aout-of-memory~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3aout-of-memory))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3aout-of-memory))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aout-of-memory%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:out-of-memory</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3aout-of-memory%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:out-of-memory</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised for an error due to insufficient memory, in cases where sufficient
+memory is at least available for raising the exception.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3aunsupported))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3aunsupported~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3aunsupported))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3aunsupported))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aunsupported%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:unsupported</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3aunsupported%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:unsupported</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised for an error due to an unsupported feature on the current
+platform or configuration.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/private/base..rkt)._make-exn~3afail~3auser))"></a><a name="(def._((quote._~23~25kernel)._exn~3afail~3auser~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3afail~3auser))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3afail~3auser))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3auser%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:user</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3auser%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:user</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised for errors that are intended to be seen by end users. In
+particular, the default error printer does not show the program
+context when printing the error message.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((quote._~23~25kernel)._exn~3abreak-continuation))"></a><a name="(def._((lib._racket/private/base..rkt)._make-exn~3abreak))"></a><a name="(def._((quote._~23~25kernel)._exn~3abreak~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3abreak))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3abreak))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:break</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn%29%29" class="RktValLink" data-pltdoc="x">exn</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">continuation</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3abreak%29%29" class="RktValLink" data-pltdoc="x">make-exn:break</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">continuation</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._continuation~3f%29%29" class="RktValLink" data-pltdoc="x">continuation?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Raised asynchronously (when enabled) in response to a break request.
+The <span class="RktSym">continuation</span> field can be used to resume the interrupted
+computation in the <a href="exns.html#%28tech._uncaught._exception._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">uncaught-exception handler</span></a> or
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call-with-exception-handler%29%29" class="RktValLink" data-pltdoc="x">call-with-exception-handler</a></span> (but <span class="emph">not</span>
+<span class="RktSym"><a href="exns.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._with-handlers%29%29" class="RktStxLink" data-pltdoc="x">with-handlers</a></span> because it escapes from the exception context
+before evaluating any predicates or handlers).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/private/base..rkt)._make-exn~3abreak~3ahang-up))"></a><a name="(def._((quote._~23~25kernel)._exn~3abreak~3ahang-up~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3abreak~3ahang-up))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3abreak~3ahang-up))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak~3ahang-up%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:break:hang-up</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak%29%29" class="RktValLink" data-pltdoc="x">exn:break</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3abreak~3ahang-up%29%29" class="RktValLink" data-pltdoc="x">make-exn:break:hang-up</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised asynchronously for hang-up breaks. The default
+ <a href="exns.html#%28tech._uncaught._exception._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">uncaught-exception handler</span></a> reacts to this exception type by
+ calling the <a href="Exiting.html#%28tech._exit._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">exit handler</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/private/base..rkt)._make-exn~3abreak~3aterminate))"></a><a name="(def._((quote._~23~25kernel)._exn~3abreak~3aterminate~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aexn~3abreak~3aterminate))"></a><a name="(def._((lib._racket/private/base..rkt)._exn~3abreak~3aterminate))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak~3aterminate%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:break:terminate</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak%29%29" class="RktValLink" data-pltdoc="x">exn:break</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3abreak~3aterminate%29%29" class="RktValLink" data-pltdoc="x">make-exn:break:terminate</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised asynchronously for termination-request breaks. The default
+ <a href="exns.html#%28tech._uncaught._exception._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">uncaught-exception handler</span></a> reacts to this exception type by
+ calling the <a href="Exiting.html#%28tech._exit._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">exit handler</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._prop~3aexn~3asrclocs))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._prop~3aexn~3asrclocs%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:exn:srclocs</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A property that identifies structure types that provide a list of
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span> values. The property is normally attached to structure
+types used to represent exception information.</div></p><p>The property value must be a procedure that accepts a single
+value&#8212;<wbr></wbr>the structure type instance from which to extract source
+locations&#8212;<wbr></wbr>and returns a list of <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span>s. Some <a href="exns.html#%28tech._error._display._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">error
+display handlers</span></a> use only the first returned location.</p><p><div class="SIntrapara">As an example,
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">We</span><span class="hspace">&nbsp;</span><span class="RktCmt">create</span><span class="hspace">&nbsp;</span><span class="RktCmt">a</span><span class="hspace">&nbsp;</span><span class="RktCmt">structure</span><span class="hspace">&nbsp;</span><span class="RktCmt">that</span><span class="hspace">&nbsp;</span><span class="RktCmt">supports</span><span class="hspace">&nbsp;</span><span class="RktCmt">the</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">prop:exn:srcloc</span><span class="hspace">&nbsp;</span><span class="RktCmt">protocol.</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">It</span><span class="hspace">&nbsp;</span><span class="RktCmt">carries</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">with</span><span class="hspace">&nbsp;</span><span class="RktCmt">it</span><span class="hspace">&nbsp;</span><span class="RktCmt">the</span><span class="hspace">&nbsp;</span><span class="RktCmt">location</span><span class="hspace">&nbsp;</span><span class="RktCmt">of</span><span class="hspace">&nbsp;</span><span class="RktCmt">the</span><span class="hspace">&nbsp;</span><span class="RktCmt">syntax</span><span class="hspace">&nbsp;</span><span class="RktCmt">that</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">is</span><span class="hspace">&nbsp;</span><span class="RktCmt">guilty.</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">exn:fail:he-who-shall-not-be-named</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">a-srcloc</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">#:property</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._prop~3aexn~3asrclocs%29%29" class="RktValLink" data-pltdoc="x">prop:exn:srclocs</a></span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">a-struct</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">a-struct</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">exn:fail:he-who-shall-not-be-named</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">msg</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">marks</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">a-srcloc</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">a-srcloc</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">We</span><span class="hspace">&nbsp;</span><span class="RktCmt">can</span><span class="hspace">&nbsp;</span><span class="RktCmt">play</span><span class="hspace">&nbsp;</span><span class="RktCmt">with</span><span class="hspace">&nbsp;</span><span class="RktCmt">this</span><span class="hspace">&nbsp;</span><span class="RktCmt">by</span><span class="hspace">&nbsp;</span><span class="RktCmt">creating</span><span class="hspace">&nbsp;</span><span class="RktCmt">a</span><span class="hspace">&nbsp;</span><span class="RktCmt">form</span><span class="hspace">&nbsp;</span><span class="RktCmt">that</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">looks</span><span class="hspace">&nbsp;</span><span class="RktCmt">at</span><span class="hspace">&nbsp;</span><span class="RktCmt">identifiers,</span><span class="hspace">&nbsp;</span><span class="RktCmt">and</span><span class="hspace">&nbsp;</span><span class="RktCmt">only</span><span class="hspace">&nbsp;</span><span class="RktCmt">flags</span><span class="hspace">&nbsp;</span><span class="RktCmt">specific</span><span class="hspace">&nbsp;</span><span class="RktCmt">ones.</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">skeeterize</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">stx</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">stx</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">expr</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%29%29" class="RktStxLink" data-pltdoc="x">#'</a></span><span class="RktSym">expr</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%29%29" class="RktStxLink" data-pltdoc="x">#'</a></span><span class="RktSym">expr</span><span class="RktPn">)</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">'</a></span><span class="RktSym">voldemort</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._quasisyntax%2Floc%29%29" class="RktStxLink" data-pltdoc="x">quasisyntax/loc</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">stx</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">exn:fail:he-who-shall-not-be-named</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktVal">"oh</span><span class="hspace">&nbsp;</span><span class="RktVal">dear</span><span class="hspace">&nbsp;</span><span class="RktVal">don't</span><span class="hspace">&nbsp;</span><span class="RktVal">say</span><span class="hspace">&nbsp;</span><span class="RktVal">his</span><span class="hspace">&nbsp;</span><span class="RktVal">name"</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="RktValLink" data-pltdoc="x">current-continuation-marks</a></span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">'</a></span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._unsyntax%29%29" class="RktStxLink" data-pltdoc="x">#,</a></span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-source%29%29" class="RktValLink" data-pltdoc="x">syntax-source</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%29%29" class="RktStxLink" data-pltdoc="x">#'</a></span><span class="RktSym">expr</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">'</a></span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._unsyntax%29%29" class="RktStxLink" data-pltdoc="x">#,</a></span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-line%29%29" class="RktValLink" data-pltdoc="x">syntax-line</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%29%29" class="RktStxLink" data-pltdoc="x">#'</a></span><span class="RktSym">expr</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">'</a></span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._unsyntax%29%29" class="RktStxLink" data-pltdoc="x">#,</a></span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-column%29%29" class="RktValLink" data-pltdoc="x">syntax-column</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%29%29" class="RktStxLink" data-pltdoc="x">#'</a></span><span class="RktSym">expr</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">'</a></span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._unsyntax%29%29" class="RktStxLink" data-pltdoc="x">#,</a></span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-position%29%29" class="RktValLink" data-pltdoc="x">syntax-position</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%29%29" class="RktStxLink" data-pltdoc="x">#'</a></span><span class="RktSym">expr</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">'</a></span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._unsyntax%29%29" class="RktStxLink" data-pltdoc="x">#,</a></span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-span%29%29" class="RktValLink" data-pltdoc="x">syntax-span</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%29%29" class="RktStxLink" data-pltdoc="x">#'</a></span><span class="RktSym">expr</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">[</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">Otherwise,</span><span class="hspace">&nbsp;</span><span class="RktCmt">leave</span><span class="hspace">&nbsp;</span><span class="RktCmt">the</span><span class="hspace">&nbsp;</span><span class="RktCmt">expression</span><span class="hspace">&nbsp;</span><span class="RktCmt">alone.</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%29%29" class="RktStxLink" data-pltdoc="x">#'</a></span><span class="RktSym">expr</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">skeeterize</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">g</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">voldemort</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">skeeterize</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">voldemort</span><span class="RktPn">)</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">voldemort</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">Examples:</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">7</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">g</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">7</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">The</span><span class="hspace">&nbsp;</span><span class="RktCmt">error</span><span class="hspace">&nbsp;</span><span class="RktCmt">should</span><span class="hspace">&nbsp;</span><span class="RktCmt">highlight</span><span class="hspace">&nbsp;</span><span class="RktCmt">the</span><span class="hspace">&nbsp;</span><span class="RktCmt">use</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">of</span><span class="hspace">&nbsp;</span><span class="RktCmt">voldemort</span><span class="hspace">&nbsp;</span><span class="RktCmt">in</span><span class="hspace">&nbsp;</span><span class="RktCmt">g.</span><span class="RktMeta"></span></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._exn~3asrclocs~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3asrclocs~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:srclocs?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> has the <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._prop~3aexn~3asrclocs%29%29" class="RktValLink" data-pltdoc="x">prop:exn:srclocs</a></span>
+property, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._exn~3asrclocs-accessor))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3asrclocs-accessor%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:srclocs-accessor</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3asrclocs~3f%29%29" class="RktValLink" data-pltdoc="x">exn:srclocs?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3asrclocs~3f%29%29" class="RktValLink" data-pltdoc="x">exn:srclocs?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span>-getting procedure associated with <span class="RktVar">v</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((quote._~23~25kernel)._srcloc-span))"></a><a name="(def._((quote._~23~25kernel)._srcloc-position))"></a><a name="(def._((quote._~23~25kernel)._srcloc-column))"></a><a name="(def._((quote._~23~25kernel)._srcloc-line))"></a><a name="(def._((quote._~23~25kernel)._srcloc-source))"></a><a name="(def._((lib._racket/private/base..rkt)._make-srcloc))"></a><a name="(def._((quote._~23~25kernel)._srcloc~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3asrcloc))"></a><a name="(def._((lib._racket/private/base..rkt)._srcloc))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValDef RktValLink" data-pltdoc="x">srcloc</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">source</span><span class="stt"> </span><span class="RktSym">line</span><span class="stt"> </span><span class="RktSym">column</span><span class="stt"> </span><span class="RktSym">position</span><span class="stt"> </span><span class="RktSym">span</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-srcloc%29%29" class="RktValLink" data-pltdoc="x">make-srcloc</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">source</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">line</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">column</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">position</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">span</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a name="(tech._source._location)"></a><span style="font-style: italic">source location</span> is most frequently represented by a
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span> structure. More generally, a source location has the
+same information as a <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span> structure, but potentially
+represented or accessed differently. For example, source-location
+information is accessed from a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> with functions
+like <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-source%29%29" class="RktValLink" data-pltdoc="x">syntax-source</a></span> and <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-line%29%29" class="RktValLink" data-pltdoc="x">syntax-line</a></span>, while
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span> accepts a source location as a list, vector, or
+another syntax object. For ports, a combination of
+<span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span> and <span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-next-location%29%29" class="RktValLink" data-pltdoc="x">port-next-location</a></span> provides location
+information, especially in a port for which counting has been enabled
+through <span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-count-lines%21%29%29" class="RktValLink" data-pltdoc="x">port-count-lines!</a></span>.</div></p><p>The fields of a <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span> instance are as follows:</p><ul><li><p><span class="RktSym">source</span> &#8212;<wbr></wbr> An arbitrary value identifying the source,
+often a path (see <a href="pathutils.html" data-pltdoc="x">Paths</a>).</p></li><li><p><span class="RktSym">line</span> &#8212;<wbr></wbr> The line number (counts from 1) or
+<span class="RktVal">#f</span> (unknown).</p></li><li><p><span class="RktSym">column</span> &#8212;<wbr></wbr> The column number (counts from 0) or
+<span class="RktVal">#f</span> (unknown).</p></li><li><p><span class="RktSym">position</span> &#8212;<wbr></wbr> The starting position (counts from 1) or
+<span class="RktVal">#f</span> (unknown).</p></li><li><p><span class="RktSym">span</span> &#8212;<wbr></wbr> The number of covered positions (counts from
+0) or <span class="RktVal">#f</span> (unknown).</p></li></ul><p>See <a href="printing.html#%28part._print-compiled%29" data-pltdoc="x">Printing Compiled Code</a> for information about the treatment of
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span> values that are embedded in compiled code.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._srcloc-~3estring))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._srcloc-~3estring%29%29" class="RktValDef RktValLink" data-pltdoc="x">srcloc-&gt;string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">srcloc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">srcloc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._srcloc~3f%29%29" class="RktValLink" data-pltdoc="x">srcloc?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Formats <span class="RktVar">srcloc</span> as a string suitable for error reporting.  A
+path source in <span class="RktVar">srcloc</span> is shown relative to the value of
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory-for-user%29%29" class="RktValLink" data-pltdoc="x">current-directory-for-user</a></span>. The result is <span class="RktVal">#f</span> if
+<span class="RktVar">srcloc</span> does not contain enough information to format a
+string.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._prop~3aexn~3amissing-module))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._prop~3aexn~3amissing-module%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:exn:missing-module</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A property that identifies structure types that provide a module path
+for a load that fails because a module is not found.</div></p><p>The property value must be a procedure that accepts a single
+value&#8212;<wbr></wbr>the structure type instance from which to extract source
+locations&#8212;<wbr></wbr>and returns a <a href="Module_Names_and_Loading.html#%28tech._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path</span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._exn~3amissing-module~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3amissing-module~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:missing-module?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> has the <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._prop~3aexn~3amissing-module%29%29" class="RktValLink" data-pltdoc="x">prop:exn:missing-module</a></span>
+property, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._exn~3amissing-module-accessor))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3amissing-module-accessor%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:missing-module-accessor</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3amissing-module~3f%29%29" class="RktValLink" data-pltdoc="x">exn:missing-module?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3asrclocs~3f%29%29" class="RktValLink" data-pltdoc="x">exn:srclocs?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <a href="Module_Names_and_Loading.html#%28tech._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path</span></a>-getting procedure associated with <span class="RktVar">v</span>.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Additional_Exception_Functions&quot;">10.2.6<tt>&nbsp;</tt><a name="(part._.Additional_.Exception_.Functions)"></a><a name="(mod-path._racket/exn)"></a>Additional Exception Functions</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="exns.html#%28mod-path._racket%2Fexn%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/exn</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="exns.html#%28mod-path._racket%2Fexn%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/exn</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/exn..rkt)._exn-~3estring))"></a><span title="Provided from: racket/exn | Package: base"><span class="RktSym"><span class="RktSymDef RktSym">exn-&gt;string</span></span></span><span class="hspace">&nbsp;</span><span class="RktVar">exn</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">exn</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3f%29%29" class="RktValLink" data-pltdoc="x">exn?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Formats <span class="RktVar">exn</span> as a string. If <span class="RktVar">exn</span> is an <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3f%29%29" class="RktValLink" data-pltdoc="x">exn?</a></span>,
+collects and returns the output from the current
+<span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-display-handler%29%29" class="RktValLink" data-pltdoc="x">error-display-handler</a></span><span class="RktPn">)</span>; otherwise, simply converts
+<span class="RktVar">exn</span> to a string using <span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="stt"> </span><span class="RktVal">"~s\n"</span><span class="stt"> </span><span class="RktVar">exn</span><span class="RktPn">)</span>.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;err-realm&quot;">10.2.7<tt>&nbsp;</tt><a name="(part._err-realm)"></a>Realms and Error Message Adjusters</h5><p>A <a name="(tech._realm)"></a><span style="font-style: italic">realm</span> identifies a convention for naming functions and
+specifying contracts for function arguments and results. Realms are
+intended to help improve layering and interoperability among languages
+that are implemented on top of Racket.</p><p>Realms primarily enable a language to recognize and rewrite error
+messages that are generated by lower layers of an implementation. For
+example, a language&rsquo;s implementation of &ldquo;arrays&rdquo; might use Racket
+vectors directly, but when an object-type or primitive bounds check
+fails for a vector, the generated error message mentions &ldquo;vector&rdquo;
+and possibly a contract like <span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span> and a function name like
+<span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span>. Since these error messages are identified as
+being from the <span class="RktVal">'</span><span class="RktVal">racket/primitive</span> realm, a language
+implementation can look for <span class="RktVal">'</span><span class="RktVal">racket/primitive</span> to detect and
+rewrite error messages with minimal danger of mangling error messages
+from other parts of an application (possibly implemented in the new
+language) that happen to use the word &ldquo;vector.&rdquo;</p><p>Each procedure and each module also has a realm. A procedure&rsquo;s realm
+is relevant, for example, when it is applied to the wrong number of
+arguments; in that case, the arity-error message itself is from the
+<span class="RktVal">'</span><span class="RktVal">racket/primitive</span> realm, but the error message also should
+include the name of the procedure, which can be from some different
+realm. Along similar lines, <span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-~3econtext%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set-&gt;context</a></span>
+can report the realm associated with (the procedure for) each frame in
+a continuation, which might be useful to identify boundary crossings.</p><p>The construction of an error message must cooperate explicitly with
+error-message adjusting. The most basic may to cooperate is through
+functions like <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-message-~3eadjusted-string%29%29" class="RktValLink" data-pltdoc="x">error-message-&gt;adjusted-string</a></span> and
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-contract-~3eadjusted-string%29%29" class="RktValLink" data-pltdoc="x">error-contract-&gt;adjusted-string</a></span>, which run error-message
+adjusters via the <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._current-error-message-adjuster%29%29" class="RktValLink" data-pltdoc="x">current-error-message-adjuster</a></span> parameter
+and other adjusters associated with the current continuation using
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-message-adjuster-key%29%29" class="RktValLink" data-pltdoc="x">error-message-adjuster-key</a></span> as a <a href="eval-model.html#%28tech._continuation._mark%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation-mark</span></a> key.
+Functions like <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-argument-error%29%29" class="RktValLink" data-pltdoc="x">raise-argument-error</a></span> and
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arity-error%29%29" class="RktValLink" data-pltdoc="x">raise-arity-error</a></span> use <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-message-~3eadjusted-string%29%29" class="RktValLink" data-pltdoc="x">error-message-&gt;adjusted-string</a></span>
+and <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-contract-~3eadjusted-string%29%29" class="RktValLink" data-pltdoc="x">error-contract-&gt;adjusted-string</a></span> with the default realm,
+<span class="RktVal">'</span><span class="RktVal">racket</span>. Functions like <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-argument-error%2A%29%29" class="RktValLink" data-pltdoc="x">raise-argument-error*</a></span> and
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-arity-error%2A%29%29" class="RktValLink" data-pltdoc="x">raise-arity-error*</a></span> accept an explicit realm argument.</p><p>Not all error functions automatically cooperate with error-message
+adjusting. For example, the <span class="RktSym">raise-reader-error</span> and
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._raise-syntax-error%29%29" class="RktValLink" data-pltdoc="x">raise-syntax-error</a></span> functions do not call adjusters, because
+they report errors that are intimately tied to syntax (and, along
+those lines, errors of a more static nature).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._error-message-~3eadjusted-string))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-message-~3eadjusted-string%29%29" class="RktValDef RktValLink" data-pltdoc="x">error-message-&gt;adjusted-string</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name-realm</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">message</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">message-realm</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name-realm</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">message</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">message-realm</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Combines <span class="RktVar">name</span> (if it is not <span class="RktVal">#f</span>) with <span class="RktVal">": "</span>
+and then <span class="RktVar">message</span> to generate an error-message string, but
+first giving error-message adjusters a chance to adjust <span class="RktVar">name</span>
+and/or <span class="RktVar">message</span>.</div></p><p>Any adjuster functions associated with the current continuation as a
+<a href="eval-model.html#%28tech._continuation._mark%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation mark</span></a> with <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-message-adjuster-key%29%29" class="RktValLink" data-pltdoc="x">error-message-adjuster-key</a></span> are
+run first; the adjusters are run in order from shallowest to deepest.
+Then, the adjuster value of <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._current-error-message-adjuster%29%29" class="RktValLink" data-pltdoc="x">current-error-message-adjuster</a></span> is
+used.</p><p>Each adjuster is tried with the <span class="RktVal">'</span><span class="RktVal">message</span> protocol, first. If
+the adjuster responds with <span class="RktVal">#f</span> for <span class="RktVal">'</span><span class="RktVal">message</span>, then the
+<span class="RktVal">'</span><span class="RktVal">name</span> protocol is tried. See
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._current-error-message-adjuster%29%29" class="RktValLink" data-pltdoc="x">current-error-message-adjuster</a></span> for information on the
+protocols. An adjuster that responds with <span class="RktVal">#f</span> for both is
+skipped, as is any value associated as continuation mark using
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-message-adjuster-key%29%29" class="RktValLink" data-pltdoc="x">error-message-adjuster-key</a></span> where the value is not a procedure
+that accepts one argument. In addition, the <span class="RktVal">'</span><span class="RktVal">name</span> protocol is
+skipped if the (possibly adjusted) <span class="RktVar">name</span> is <span class="RktVal">#f</span>.</p><p class="SHistory">Added in version 8.4.0.2 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._error-contract-~3eadjusted-string))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-contract-~3eadjusted-string%29%29" class="RktValDef RktValLink" data-pltdoc="x">error-contract-&gt;adjusted-string</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">contract-str</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">contract-realm</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">contract-str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">contract-realm</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Analogous to <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-message-~3eadjusted-string%29%29" class="RktValLink" data-pltdoc="x">error-message-&gt;adjusted-string</a></span>, but for just the
+contract part of an error message. The result string is typically
+incorporated into a larger error message that may then be adjusted
+further.</div></p><p>Adjustment of contract string uses the <span class="RktVal">'</span><span class="RktVal">contract</span> protocol as
+described for <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._current-error-message-adjuster%29%29" class="RktValLink" data-pltdoc="x">current-error-message-adjuster</a></span>.</p><p class="SHistory">Added in version 8.4.0.2 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-error-message-adjuster))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._current-error-message-adjuster%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-error-message-adjuster</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._current-error-message-adjuster%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-error-message-adjuster</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines an error-message adjuster that is
+applied after any adjusters associated to the current continuation via
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-message-adjuster-key%29%29" class="RktValLink" data-pltdoc="x">error-message-adjuster-key</a></span>.</div></p><p>An adjuster procedure receives a symbol identifying a protocol, and it
+must return either <span class="RktVal">#f</span> or a procedure for performing
+adjustments through that protocol. The following protocols are
+currently defined, but more may be added in the future:</p><ul><li><p><span class="RktVal">'</span><span class="RktVal">name</span>: the procedure receives two arguments, a name
+symbol and a realm symbol; it returns an adjusted name symbol
+and an adjusted realm symbol.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">message</span>: the procedure receives four arguments: a
+name symbol or <span class="RktVal">#f</span> (which means that no name will be
+prefixed on the message), a name-realm symbol, an message
+string, and a message-realm symbol; it returns four adjusted
+values.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">contract</span>: the procedure receives two arguments, a
+contract string and a realm symbol; it returns an adjusted
+contract string and an adjusted realm symbol.</p></li></ul><p>A new library or language can introduce additional mode symbols, too.
+To avoid conflicts, prefix the mode symbol with a collection or
+library name followed by <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>.</p><p>If an adjuster procedure returns <span class="RktVal">#f</span> for a protocol, it&rsquo;s the
+same as returning a function that performs no adjustment and returns
+its arguments. The default value of this parameter returns <span class="RktVal">#f</span>
+for any symbol argument except the protocols listed above, for which
+it returns a procedure that checks its arguments and returns them with
+no adjustment.</p><p class="SHistory">Added in version 8.4.0.2 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._error-message-adjuster-key))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-message-adjuster-key%29%29" class="RktValDef RktValLink" data-pltdoc="x">error-message-adjuster-key</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">An <a href="symbols.html#%28tech._uninterned%29" class="techoutside" data-pltdoc="x"><span class="techinside">uninterned</span></a> symbol intended for use as a <a href="eval-model.html#%28tech._continuation._mark%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation
+mark</span></a> key with an error-adjuster procedure value. An error adjuster
+associated with the key should follow the same protocol as a value of
+<span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._current-error-message-adjuster%29%29" class="RktValLink" data-pltdoc="x">current-error-message-adjuster</a></span>.</div></p><p>See <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error-message-~3eadjusted-string%29%29" class="RktValLink" data-pltdoc="x">error-message-&gt;adjusted-string</a></span> for a description of how
+marks using this key are can adjust error messages.</p><p class="SHistory">Added in version 8.4.0.2 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="values.html" title="backward to &quot;10.1 Multiple Values&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Control Flow&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Delayed_Evaluation.html" title="forward to &quot;10.3 Delayed Evaluation&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/extflonums.html b/clones/docs.racket-lang.org/reference/extflonums.html
new file mode 100644
index 00000000..bf5ae02b
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/extflonums.html
@@ -0,0 +1,51 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.3.5&nbsp;Extflonums</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewselflink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.3.1&nbsp;</td><td><a href="number-types.html" class="tocviewlink" data-pltdoc="x">Number Types</a></td></tr><tr><td align="right">4.3.2&nbsp;</td><td><a href="generic-numbers.html" class="tocviewlink" data-pltdoc="x">Generic Numerics</a></td></tr><tr><td align="right">4.3.3&nbsp;</td><td><a href="flonums.html" class="tocviewlink" data-pltdoc="x">Flonums</a></td></tr><tr><td align="right">4.3.4&nbsp;</td><td><a href="fixnums.html" class="tocviewlink" data-pltdoc="x">Fixnums</a></td></tr><tr><td align="right">4.3.5&nbsp;</td><td><a href="extflonums.html" class="tocviewselflink" data-pltdoc="x">Extflonums</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_3&quot;);">&#9658;</a></td><td>4.3.5&nbsp;</td><td><a href="extflonums.html" class="tocviewselflink" data-pltdoc="x">Extflonums</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_3"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.3.5.1&nbsp;</td><td><a href="extflonums.html#%28part._.Extflonum_.Arithmetic%29" class="tocviewlink" data-pltdoc="x">Extflonum Arithmetic</a></td></tr><tr><td align="right">4.3.5.2&nbsp;</td><td><a href="extflonums.html#%28part._.Extflonum_.Constants%29" class="tocviewlink" data-pltdoc="x">Extflonum Constants</a></td></tr><tr><td align="right">4.3.5.3&nbsp;</td><td><a href="extflonums.html#%28part._extflvectors%29" class="tocviewlink" data-pltdoc="x">Extflonum Vectors</a></td></tr><tr><td align="right">4.3.5.4&nbsp;</td><td><a href="extflonums.html#%28part._extflutils%29" class="tocviewlink" data-pltdoc="x">Extflonum Byte Strings</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflonum?</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum-available~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflonum-<wbr></wbr>available?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.3.5.1<tt>&nbsp;</tt></span><a href="extflonums.html#%28part._.Extflonum_.Arithmetic%29" class="tocsubseclink" data-pltdoc="x">Extflonum Arithmetic</a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl%2B%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl+</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl-</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl*</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl%2F%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl/</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflabs%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflabs</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl=</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl~3c%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl&lt;</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl~3e%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl&gt;</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl~3c~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl&lt;=</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl~3e~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl&gt;=</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflmin%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflmin</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflmax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflmax</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflround%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflround</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflfloor%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflfloor</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflceiling%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflceiling</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfltruncate%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfltruncate</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflsin%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflsin</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflcos%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflcos</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfltan%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfltan</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflasin%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflasin</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflacos%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflacos</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflatan%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflatan</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfllog%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfllog</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflexp%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflexp</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflsqrt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflsqrt</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflexpt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflexpt</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._-~3eextfl%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink"><span class="nobreak">-<wbr></wbr>&gt;</span>extfl</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-~3eexact-integer%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl-<wbr></wbr>&gt;exact-<wbr></wbr>integer</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._real-~3eextfl%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">real-<wbr></wbr>&gt;extfl</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-~3eexact%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl-<wbr></wbr>&gt;exact</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-~3efx%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl-<wbr></wbr>&gt;fx</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._fx-~3eextfl%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx-<wbr></wbr>&gt;extfl</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-~3einexact%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl-<wbr></wbr>&gt;inexact</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.3.5.2<tt>&nbsp;</tt></span><a href="extflonums.html#%28part._.Extflonum_.Constants%29" class="tocsubseclink" data-pltdoc="x">Extflonum Constants</a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._pi..t%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pi.t</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.3.5.3<tt>&nbsp;</tt></span><a href="extflonums.html#%28part._extflvectors%29" class="tocsubseclink" data-pltdoc="x">Extflonum Vectors</a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflvector?</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflvector</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._make-extflvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>extflvector</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector-length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflvector-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflvector-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflvector-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector-copy%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extflvector-<wbr></wbr>copy</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._in-extflvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>extflvector</span></span></a></td></tr><tr><td><a href="extflonums.html#%28form._%28%28lib._racket%2Fextflonum..rkt%29._for%2Fextflvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>extflvector</span></span></a></td></tr><tr><td><a href="extflonums.html#%28form._%28%28lib._racket%2Fextflonum..rkt%29._for%2A%2Fextflvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>extflvector</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._shared-extflvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">shared-<wbr></wbr>extflvector</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._make-shared-extflvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>shared-<wbr></wbr>extflvector</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.3.5.4<tt>&nbsp;</tt></span><a href="extflonums.html#%28part._extflutils%29" class="tocsubseclink" data-pltdoc="x">Extflonum Byte Strings</a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._floating-point-bytes-~3eextfl%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">floating-<wbr></wbr>point-<wbr></wbr>bytes-<wbr></wbr>&gt;extfl</span></span></a></td></tr><tr><td><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-~3efloating-point-bytes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extfl-<wbr></wbr>&gt;floating-<wbr></wbr>point-<wbr></wbr>bytes</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="fixnums.html" title="backward to &quot;4.3.4 Fixnums&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="numbers.html" title="up to &quot;4.3 Numbers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="strings.html" title="forward to &quot;4.4 Strings&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;extflonums&quot;">4.3.5<tt>&nbsp;</tt><a name="(part._extflonums)"></a><a name="(mod-path._racket/extflonum)"></a>Extflonums</h5><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="extflonums.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/extflonum</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></p><p>An <a name="(tech._extflonum)"></a><span style="font-style: italic">extflonum</span> is an extended-precision (80-bit)
+floating-point number. Extflonum arithmetic is supported on
+platforms with extended-precision hardware and where the
+extflonum implementation does not conflict with normal
+double-precision arithmetic (i.e., on x86 and x86_64 platforms when
+Racket is compiled to use SSE instructions for floating-point
+operations, and on Windows when <a name="(idx._(gentag._132._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"longdouble.dll"</span>
+is available).</p><p>A extflonum is <span style="font-weight: bold">not</span> a <a href="numbers.html#%28tech._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">number</span></a> in the sense of
+<span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span>. Only extflonum-specific operations such as
+<span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl%2B%29%29" class="RktValLink" data-pltdoc="x">extfl+</a></span> perform extflonum arithmetic.</p><p>A literal extflonum is written like an <a href="numbers.html#%28tech._inexact._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">inexact number</span></a>,
+but using an explicit <span class="RktInBG"><span class="hspace"></span><span class="RktIn">t</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">T</span><span class="hspace"></span></span> exponent marker (see
+<a href="reader.html#%28part._parse-extflonum%29" data-pltdoc="x">Reading Extflonums</a>). For example, <span class="RktVal">3.5t0</span> is an
+extflonum. The extflonum values for infinity are
+<a name="(idx._(gentag._133._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">+inf.t</span> and <a name="(idx._(gentag._134._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal"><span class="nobreak">-i</span>nf.t</span>. The
+extflonum value for not-a-number is <a name="(idx._(gentag._135._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">+nan.t</span> or
+<a name="(idx._(gentag._136._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal"><span class="nobreak">-n</span>an.t</span>.</p><p>If <span class="RktPn">(</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum-available~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum-available?</a></span><span class="RktPn">)</span> produces <span class="RktVal">#f</span>, then all
+operations exported by <a href="extflonums.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/extflonum</span></a> raise
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aunsupported%29%29" class="RktValLink" data-pltdoc="x">exn:fail:unsupported</a></span>, except for <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span>,
+<span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum-available~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum-available?</a></span>, and <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector~3f%29%29" class="RktValLink" data-pltdoc="x">extflvector?</a></span> (which always
+work). The reader (see <a href="reader.html" data-pltdoc="x">The Reader</a>) always accepts extflonum
+input; when extflonum operations are not supported, printing an
+extflonum from the reader uses its source notation (as opposed to
+normalizing the format).</p><p>Two extflonums are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> if <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl~3d%29%29" class="RktValLink" data-pltdoc="x">extfl=</a></span>
+produces <span class="RktVal">#t</span> for the extflonums. If extflonums
+are not supported in a platform, extflonums are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>
+only if they are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflonum~3f))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflonum?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is an extflonum, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflonum-available~3f))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum-available~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflonum-available?</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonum</span></a> operations are supported on the
+current platform, <span class="RktVal">#f</span> otherwise.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Extflonum_Arithmetic&quot;">4.3.5.1<tt>&nbsp;</tt><a name="(part._.Extflonum_.Arithmetic)"></a>Extflonum Arithmetic</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extfl+))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl%2B%29%29" class="RktValDef RktValLink" data-pltdoc="x">extfl+</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extfl-))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-%29%29" class="RktValDef RktValLink" data-pltdoc="x">extfl-</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extfl*))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">extfl*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extfl/))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl%2F%29%29" class="RktValDef RktValLink" data-pltdoc="x">extfl/</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflabs))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflabs%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflabs</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2B%29%29" class="RktValLink" data-pltdoc="x">fl+</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl-%29%29" class="RktValLink" data-pltdoc="x">fl-</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2A%29%29" class="RktValLink" data-pltdoc="x">fl*</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2F%29%29" class="RktValLink" data-pltdoc="x">fl/</a></span>, and <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flabs%29%29" class="RktValLink" data-pltdoc="x">flabs</a></span>,
+but for <a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonums</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extfl~3d))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl~3d%29%29" class="RktValDef RktValLink" data-pltdoc="x">extfl=</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extfl~3c))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl~3c%29%29" class="RktValDef RktValLink" data-pltdoc="x">extfl&lt;</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extfl~3e))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl~3e%29%29" class="RktValDef RktValLink" data-pltdoc="x">extfl&gt;</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extfl~3c~3d))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl~3c~3d%29%29" class="RktValDef RktValLink" data-pltdoc="x">extfl&lt;=</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extfl~3e~3d))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl~3e~3d%29%29" class="RktValDef RktValLink" data-pltdoc="x">extfl&gt;=</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflmin))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflmin%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflmin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflmax))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflmax%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflmax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3d%29%29" class="RktValLink" data-pltdoc="x">fl=</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3c%29%29" class="RktValLink" data-pltdoc="x">fl&lt;</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3e%29%29" class="RktValLink" data-pltdoc="x">fl&gt;</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3c~3d%29%29" class="RktValLink" data-pltdoc="x">fl&lt;=</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3e~3d%29%29" class="RktValLink" data-pltdoc="x">fl&gt;=</a></span>,
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flmin%29%29" class="RktValLink" data-pltdoc="x">flmin</a></span>, and <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flmax%29%29" class="RktValLink" data-pltdoc="x">flmax</a></span>, but for <a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonums</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflround))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflround%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflround</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflfloor))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflfloor%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflfloor</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflceiling))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflceiling%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflceiling</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extfltruncate))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfltruncate%29%29" class="RktValDef RktValLink" data-pltdoc="x">extfltruncate</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flround%29%29" class="RktValLink" data-pltdoc="x">flround</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flfloor%29%29" class="RktValLink" data-pltdoc="x">flfloor</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flceiling%29%29" class="RktValLink" data-pltdoc="x">flceiling</a></span>, and
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fltruncate%29%29" class="RktValLink" data-pltdoc="x">fltruncate</a></span>, but for <a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonums</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflsin))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflsin%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflsin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflcos))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflcos%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflcos</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extfltan))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfltan%29%29" class="RktValDef RktValLink" data-pltdoc="x">extfltan</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflasin))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflasin%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflasin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflacos))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflacos%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflacos</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflatan))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflatan%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflatan</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extfllog))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfllog%29%29" class="RktValDef RktValLink" data-pltdoc="x">extfllog</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflexp))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflexp%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflexp</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflsqrt))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflsqrt%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflsqrt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflexpt))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflexpt%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflexpt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flsin%29%29" class="RktValLink" data-pltdoc="x">flsin</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flcos%29%29" class="RktValLink" data-pltdoc="x">flcos</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fltan%29%29" class="RktValLink" data-pltdoc="x">fltan</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flasin%29%29" class="RktValLink" data-pltdoc="x">flasin</a></span>,
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flacos%29%29" class="RktValLink" data-pltdoc="x">flacos</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flatan%29%29" class="RktValLink" data-pltdoc="x">flatan</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fllog%29%29" class="RktValLink" data-pltdoc="x">fllog</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flexp%29%29" class="RktValLink" data-pltdoc="x">flexp</a></span>, and
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flsqrt%29%29" class="RktValLink" data-pltdoc="x">flsqrt</a></span>, and <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flexpt%29%29" class="RktValLink" data-pltdoc="x">flexpt</a></span>, but for <a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonums</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._-~3eextfl))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._-~3eextfl%29%29" class="RktValDef RktValLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>extfl</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extfl-~3eexact-integer))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-~3eexact-integer%29%29" class="RktValDef RktValLink" data-pltdoc="x">extfl-&gt;exact-integer</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._real-~3eextfl))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._real-~3eextfl%29%29" class="RktValDef RktValLink" data-pltdoc="x">real-&gt;extfl</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extfl-~3eexact))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-~3eexact%29%29" class="RktValDef RktValLink" data-pltdoc="x">extfl-&gt;exact</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact~3f%29%29" class="RktValLink" data-pltdoc="x">exact?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extfl-~3efx))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-~3efx%29%29" class="RktValDef RktValLink" data-pltdoc="x">extfl-&gt;fx</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._fx-~3eextfl))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._fx-~3eextfl%29%29" class="RktValDef RktValLink" data-pltdoc="x">fx-&gt;extfl</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extfl-~3einexact))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-~3einexact%29%29" class="RktValDef RktValLink" data-pltdoc="x">extfl-&gt;inexact</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The first six are like <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._-~3efl%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>fl</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl-~3eexact-integer%29%29" class="RktValLink" data-pltdoc="x">fl-&gt;exact-integer</a></span>,
+<span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real-~3edouble-flonum%29%29" class="RktValLink" data-pltdoc="x">real-&gt;double-flonum</a></span>, <span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact-~3eexact%29%29" class="RktValLink" data-pltdoc="x">inexact-&gt;exact</a></span>, <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fl-~3efx%29%29" class="RktValLink" data-pltdoc="x">fl-&gt;fx</a></span>,
+and <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx-~3efl%29%29" class="RktValLink" data-pltdoc="x">fx-&gt;fl</a></span>, but for <a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonums</span></a>.
+The <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-~3einexact%29%29" class="RktValLink" data-pltdoc="x">extfl-&gt;inexact</a></span> function converts a <a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonum</span></a> to
+its closest <a href="numbers.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonum</span></a> approximation.</div></p><p class="SHistory">Changed in version 7.7.0.8 of package <span class="stt">base</span>: Changed <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-~3efx%29%29" class="RktValLink" data-pltdoc="x">extfl-&gt;fx</a></span> to truncate.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Extflonum_Constants&quot;">4.3.5.2<tt>&nbsp;</tt><a name="(part._.Extflonum_.Constants)"></a>Extflonum Constants</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/extflonum..rkt)._pi..t))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._pi..t%29%29" class="RktValDef RktValLink" data-pltdoc="x">pi.t</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span>, but with 80 bits precision.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;extflvectors&quot;">4.3.5.3<tt>&nbsp;</tt><a name="(part._extflvectors)"></a>Extflonum Vectors</h5><p>An <a name="(tech._extflvector)"></a><span style="font-style: italic">extflvector</span> is like an <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a>, but it holds only
+<a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonums</span></a>. See also <a href="unsafe.html#%28part._unsafeextfl%29" data-pltdoc="x">Unsafe Extflonum Operations</a>.</p><p>Two <a href="extflonums.html#%28tech._extflvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflvectors</span></a> are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> if they have the same length,
+and if the values in corresponding slots of the <a href="extflonums.html#%28tech._extflvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflvectors</span></a> are
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflvector~3f))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflvector?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflvector))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflvector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector~3f%29%29" class="RktValLink" data-pltdoc="x">extflvector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._make-extflvector))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._make-extflvector%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-extflvector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">size</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">x</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector~3f%29%29" class="RktValLink" data-pltdoc="x">extflvector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">size</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0.0t0</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflvector-length))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflvector-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector~3f%29%29" class="RktValLink" data-pltdoc="x">extflvector?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflvector-ref))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflvector-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector~3f%29%29" class="RktValLink" data-pltdoc="x">extflvector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflvector-set!))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflvector-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector~3f%29%29" class="RktValLink" data-pltdoc="x">extflvector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extflvector-copy))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector-copy%29%29" class="RktValDef RktValLink" data-pltdoc="x">extflvector-copy</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector~3f%29%29" class="RktValLink" data-pltdoc="x">extflvector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector~3f%29%29" class="RktValLink" data-pltdoc="x">extflvector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="RktValLink" data-pltdoc="x">vector-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector~3f%29%29" class="RktValLink" data-pltdoc="x">flvector?</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector%29%29" class="RktValLink" data-pltdoc="x">flvector</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._make-flvector%29%29" class="RktValLink" data-pltdoc="x">make-flvector</a></span>,
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector-length%29%29" class="RktValLink" data-pltdoc="x">flvector-length</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector-ref%29%29" class="RktValLink" data-pltdoc="x">flvector-ref</a></span>, <span class="RktSym">flvector-set</span>,
+and <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector-copy%29%29" class="RktValLink" data-pltdoc="x">flvector-copy</a></span>, but for <a href="extflonums.html#%28tech._extflvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflvectors</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._in-extflvector))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._in-extflvector%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-extflvector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">stop</span><span class="hspace">&nbsp;</span><span class="RktVar">step</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector~3f%29%29" class="RktValLink" data-pltdoc="x">extflvector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">step</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/extflonum..rkt)._for/extflvector))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28form._%28%28lib._racket%2Fextflonum..rkt%29._for%2Fextflvector%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/extflvector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-length</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/extflonum..rkt)._for*/extflvector))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28form._%28%28lib._racket%2Fextflonum..rkt%29._for%2A%2Fextflvector%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/extflvector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-length</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">maybe-length</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:length</span><span class="hspace">&nbsp;</span><span class="RktVar">length-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:length</span><span class="hspace">&nbsp;</span><span class="RktVar">length-expr</span><span class="hspace">&nbsp;</span><span class="RktPn">#:fill</span><span class="hspace">&nbsp;</span><span class="RktVar">fill-expr</span></td></tr></table></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><blockquote class="SubFlow"><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">length-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">fill-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._in-flvector%29%29" class="RktValLink" data-pltdoc="x">in-flvector</a></span>, <span class="RktSym"><a href="flonums.html#%28form._%28%28lib._racket%2Fflonum..rkt%29._for%2Fflvector%29%29" class="RktStxLink" data-pltdoc="x">for/flvector</a></span>, and <span class="RktSym"><a href="flonums.html#%28form._%28%28lib._racket%2Fflonum..rkt%29._for%2A%2Fflvector%29%29" class="RktStxLink" data-pltdoc="x">for*/flvector</a></span>,
+but for <a href="extflonums.html#%28tech._extflvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflvectors</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._shared-extflvector))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._shared-extflvector%29%29" class="RktValDef RktValLink" data-pltdoc="x">shared-extflvector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector~3f%29%29" class="RktValLink" data-pltdoc="x">extflvector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._make-shared-extflvector))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._make-shared-extflvector%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-shared-extflvector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">size</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">x</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector~3f%29%29" class="RktValLink" data-pltdoc="x">extflvector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">size</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0.0t0</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._shared-flvector%29%29" class="RktValLink" data-pltdoc="x">shared-flvector</a></span> and <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._make-shared-flvector%29%29" class="RktValLink" data-pltdoc="x">make-shared-flvector</a></span>,
+but for <a href="extflonums.html#%28tech._extflvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflvectors</span></a>.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;extflutils&quot;">4.3.5.4<tt>&nbsp;</tt><a name="(part._extflutils)"></a>Extflonum Byte Strings</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._floating-point-bytes-~3eextfl))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._floating-point-bytes-~3eextfl%29%29" class="RktValDef RktValLink" data-pltdoc="x">floating-point-bytes-&gt;extfl</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">big-endian?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">big-endian?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._system-big-endian~3f%29%29" class="RktValLink" data-pltdoc="x">system-big-endian?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._floating-point-bytes-~3ereal%29%29" class="RktValLink" data-pltdoc="x">floating-point-bytes-&gt;real</a></span>, but  for <a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonums</span></a>:
+Converts the extended-precision floating-point number encoded in
+<span class="RktVar">bstr</span> from position <span class="RktVar">start</span> (inclusive) to <span class="RktVar">end</span>
+(exclusive) to an <a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonum</span></a>. The difference between
+<span class="RktVar">start</span> an <span class="RktVar">end</span> must be 10 bytes.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/extflonum..rkt)._extfl-~3efloating-point-bytes))"></a><span title="Provided from: racket/extflonum | Package: base"><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-~3efloating-point-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">extfl-&gt;floating-point-bytes</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">x</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">big-endian?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">dest-bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">big-endian?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._system-big-endian~3f%29%29" class="RktValLink" data-pltdoc="x">system-big-endian?</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">dest-bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._make-bytes%29%29" class="RktValLink" data-pltdoc="x">make-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._real-~3efloating-point-bytes%29%29" class="RktValLink" data-pltdoc="x">real-&gt;floating-point-bytes</a></span>, but  for <a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonums</span></a>:
+Converts <span class="RktVar">x</span> to its representation in a byte
+string of length 10.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="fixnums.html" title="backward to &quot;4.3.4 Fixnums&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="numbers.html" title="up to &quot;4.3 Numbers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="strings.html" title="forward to &quot;4.4 Strings&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/extras.css b/clones/docs.racket-lang.org/reference/extras.css
new file mode 100644
index 00000000..3a091557
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/extras.css
@@ -0,0 +1,12 @@
+
+.ghost {
+  color: white;
+}
+
+.inferencetop {
+  border-bottom: 1px solid black;
+  text-align: center;
+}
+.inferencebottom {
+  text-align: center;
+}
diff --git a/clones/docs.racket-lang.org/reference/fasl.html b/clones/docs.racket-lang.org/reference/fasl.html
new file mode 100644
index 00000000..f4224c9b
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/fasl.html
@@ -0,0 +1,56 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.10&nbsp;Fast-Load Serialization</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewselflink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._s-exp-~3efasl%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">s-<wbr></wbr>exp-<wbr></wbr>&gt;fasl</span></span></a></td></tr><tr><td><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._fasl-~3es-exp%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fasl-<wbr></wbr>&gt;s-<wbr></wbr>exp</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="serialization.html" title="backward to &quot;13.9 Serialization&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="sha.html" title="forward to &quot;13.11 Cryptographic Hashing&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;fasl&quot;">13.10<tt>&nbsp;</tt><a name="(part._fasl)"></a><a name="(mod-path._racket/fasl)"></a>Fast-Load Serialization</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="fasl.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/fasl</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="fasl.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/fasl</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/fasl..rkt)._s-exp-~3efasl))"></a><span title="Provided from: racket/fasl | Package: base"><span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._s-exp-~3efasl%29%29" class="RktValDef RktValLink" data-pltdoc="x">s-exp-&gt;fasl</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:keep-mutable?</span><span class="hspace">&nbsp;</span><span class="RktVar">keep-mutable?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:handle-fail</span><span class="hspace">&nbsp;</span><span class="RktVar">handle-fail</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:external-lift?</span><span class="hspace">&nbsp;</span><span class="RktVar">external-lift?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:skip-prefix?</span><span class="hspace">&nbsp;</span><span class="RktVar">skip-prefix?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">keep-mutable?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">handle-fail</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">external-lift?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip-prefix?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/fasl..rkt)._fasl-~3es-exp))"></a><span title="Provided from: racket/fasl | Package: base"><span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._fasl-~3es-exp%29%29" class="RktValDef RktValLink" data-pltdoc="x">fasl-&gt;s-exp</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:datum-intern?</span><span class="hspace">&nbsp;</span><span class="RktVar">datum-intern?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:external-lifts</span><span class="hspace">&nbsp;</span><span class="RktVar">external-lifts</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:skip-prefix?</span><span class="hspace">&nbsp;</span><span class="RktVar">skip-prefix?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">datum-intern?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">external-lifts</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip-prefix?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._s-exp-~3efasl%29%29" class="RktValLink" data-pltdoc="x">s-exp-&gt;fasl</a></span> function serializes <span class="RktVar">v</span> to a byte
+string, printing it directly to <span class="RktVar">out</span> if <span class="RktVar">out</span> is an
+output port or returning the byte string otherwise. The
+<span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._fasl-~3es-exp%29%29" class="RktValLink" data-pltdoc="x">fasl-&gt;s-exp</a></span> function decodes a value from a byte string
+(supplied either directly or as an input port) that was encoded with
+<span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._s-exp-~3efasl%29%29" class="RktValLink" data-pltdoc="x">s-exp-&gt;fasl</a></span>.</div></p><p>The <span class="RktVar">v</span> argument must be a value that could be <span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span>d
+as a literal&#8212;<wbr></wbr>that is, a value without syntax objects for which
+<span class="RktPn">(</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile%29%29" class="RktValLink" data-pltdoc="x">compile</a></span><span class="stt"> </span><span class="RktVal">`</span><span class="RktVal">'</span><span class="RktVal">,</span><span class="RktVal">v</span><span class="RktPn">)</span> would work and be <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>able
+after <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>&#8212;<wbr></wbr>or it can include <a href="linklets.html#%28tech._correlated._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">correlated
+objects</span></a> mixed with those values. The byte string produced by
+<span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._s-exp-~3efasl%29%29" class="RktValLink" data-pltdoc="x">s-exp-&gt;fasl</a></span> does not use the same format as compiled code,
+however.</p><p>If a value within <span class="RktVar">v</span> is not valid as a <span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span>d
+literal, and if <span class="RktVar">handle-fail</span> is not <span class="RktVal">#f</span>, then
+<span class="RktVar">handle-fail</span> is called on the nested value, and the result of
+<span class="RktVar">handle-fail</span> is written in that value&rsquo;s place. The
+<span class="RktVar">handle-fail</span> procedure might raise an exception instead of
+returning a replacement value. If <span class="RktVar">handle-fail</span> is <span class="RktVal">#f</span>,
+then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised when an invalid value is
+encountered.</p><p>If <span class="RktVar">external-lift?</span> is not <span class="RktVal">#f</span>, then it receives each
+value <span class="RktVar">v-sub</span> encountered in <span class="RktVar">v</span> by
+<span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._s-exp-~3efasl%29%29" class="RktValLink" data-pltdoc="x">s-exp-&gt;fasl</a></span>. If the result of <span class="RktVar">external-lift?</span> on
+<span class="RktVar">v-sub</span> is true, then <span class="RktVar">v-sub</span> is not encoded in the
+result, and it instead treated as <a name="(tech._externally._lifted)"></a><span style="font-style: italic">externally lifted</span>. A
+deserializing <span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._fasl-~3es-exp%29%29" class="RktValLink" data-pltdoc="x">fasl-&gt;s-exp</a></span> receives a <span class="RktVar">external-lifts</span>
+vector that has one value for each externally lifted value, in the
+same order as passed to <span class="RktVar">external-lift?</span> on serialization.</p><p>Like <span class="RktPn">(</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile%29%29" class="RktValLink" data-pltdoc="x">compile</a></span><span class="stt"> </span><span class="RktVal">`</span><span class="RktVal">'</span><span class="RktVal">,</span><span class="RktVal">v</span><span class="RktPn">)</span>, <span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._s-exp-~3efasl%29%29" class="RktValLink" data-pltdoc="x">s-exp-&gt;fasl</a></span> does not
+preserve graph structure, support cycles, or handle non-<a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a>
+structures. Compose <span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._s-exp-~3efasl%29%29" class="RktValLink" data-pltdoc="x">s-exp-&gt;fasl</a></span> with <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span> to
+preserve graph structure, handle cyclic data, and encode serializable
+structures. The <span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._s-exp-~3efasl%29%29" class="RktValLink" data-pltdoc="x">s-exp-&gt;fasl</a></span> and <span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._fasl-~3es-exp%29%29" class="RktValLink" data-pltdoc="x">fasl-&gt;s-exp</a></span>
+functions consult <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._current-write-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-write-relative-directory</a></span> and
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-load-relative-directory</a></span>
+(falling back to <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span>), respectively, in the same
+way as bytecode saving and loading to store paths in relative form,
+and they similarly allow and convert constrained <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span>
+values (see <a href="printing.html#%28part._print-compiled%29" data-pltdoc="x">Printing Compiled Code</a>).</p><p>Unless <span class="RktVar">keep-mutable?</span> is provided as true to
+<span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._s-exp-~3efasl%29%29" class="RktValLink" data-pltdoc="x">s-exp-&gt;fasl</a></span>, then mutable values in <span class="RktVar">v</span> are replaced
+by immutable values when the result is decoded by
+<span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._fasl-~3es-exp%29%29" class="RktValLink" data-pltdoc="x">fasl-&gt;s-exp</a></span>. Unless <span class="RktVar">datum-intern?</span> is provided as
+<span class="RktVal">#f</span>, then any immutable value produced by <span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._fasl-~3es-exp%29%29" class="RktValLink" data-pltdoc="x">fasl-&gt;s-exp</a></span>
+is filtered by <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-intern-literal%29%29" class="RktValLink" data-pltdoc="x">datum-intern-literal</a></span>. The defaults make the
+composition of <span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._s-exp-~3efasl%29%29" class="RktValLink" data-pltdoc="x">s-exp-&gt;fasl</a></span> and <span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._fasl-~3es-exp%29%29" class="RktValLink" data-pltdoc="x">fasl-&gt;s-exp</a></span> behave
+like the composition of <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> and <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>.</p><p>If <span class="RktVar">skip-prefix?</span> is not <span class="RktVal">#f</span>, then a prefix that
+identifies the stream as a serialization is not written by
+<span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._s-exp-~3efasl%29%29" class="RktValLink" data-pltdoc="x">s-exp-&gt;fasl</a></span> or read by <span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._fasl-~3es-exp%29%29" class="RktValLink" data-pltdoc="x">fasl-&gt;s-exp</a></span>. Omitting a
+prefix can save a small amount of space, which can useful when
+serializing small values, but it gives up a sanity check on the
+<span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._fasl-~3es-exp%29%29" class="RktValLink" data-pltdoc="x">fasl-&gt;s-exp</a></span> that is often useful.</p><p>The byte-string encoding produced by <span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._s-exp-~3efasl%29%29" class="RktValLink" data-pltdoc="x">s-exp-&gt;fasl</a></span> is
+independent of the Racket version, except as future Racket versions
+introduce extensions that are not currently recognized. In particular,
+the result of <span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._s-exp-~3efasl%29%29" class="RktValLink" data-pltdoc="x">s-exp-&gt;fasl</a></span> will be valid as input to any
+future version of <span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._fasl-~3es-exp%29%29" class="RktValLink" data-pltdoc="x">fasl-&gt;s-exp</a></span> (as long as the
+<span class="RktVar">skip-prefix?</span> arguments are consistent).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fasl</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._s-exp-~3efasl%29%29" class="RktValLink" data-pltdoc="x">s-exp-&gt;fasl</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">"speed"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racer</span><span class="hspace">&nbsp;</span><span class="RktVal">#\!</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">fasl</span></td></tr><tr><td><p><span class="RktRes">#"racket/fasl:\0\24\34\3 \1\23\5speed\16\5racer\r!"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._fasl-~3es-exp%29%29" class="RktValLink" data-pltdoc="x">fasl-&gt;s-exp</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fasl</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#("speed") racer #\!)</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.90.0.21 of package <span class="stt">base</span>: Made <span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._s-exp-~3efasl%29%29" class="RktValLink" data-pltdoc="x">s-exp-&gt;fasl</a></span> format version-independent
+and added the <span class="RktPn">#:keep-mutable?</span>
+and <span class="RktPn">#:datum-intern?</span> arguments.<br/>Changed in version 7.3.0.7: Added support for <a href="linklets.html#%28tech._correlated._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">correlated objects</span></a>.<br/>Changed in version 7.5.0.3: Added the <span class="RktPn">#:handle-fail</span> argument.<br/>Changed in version 7.5.0.9: Added the <span class="RktPn">#:external-lift?</span> and <span class="RktPn">#:external-lifts</span> arguments.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="serialization.html" title="backward to &quot;13.9 Serialization&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="sha.html" title="forward to &quot;13.11 Cryptographic Hashing&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/file-ports.html b/clones/docs.racket-lang.org/reference/file-ports.html
new file mode 100644
index 00000000..2788c98b
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/file-ports.html
@@ -0,0 +1,163 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.1.5&nbsp;File Ports</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewselflink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1.1&nbsp;</td><td><a href="encodings.html" class="tocviewlink" data-pltdoc="x">Encodings and Locales</a></td></tr><tr><td align="right">13.1.2&nbsp;</td><td><a href="port-ops.html" class="tocviewlink" data-pltdoc="x">Managing Ports</a></td></tr><tr><td align="right">13.1.3&nbsp;</td><td><a href="port-buffers.html" class="tocviewlink" data-pltdoc="x">Port Buffers and Positions</a></td></tr><tr><td align="right">13.1.4&nbsp;</td><td><a href="linecol.html" class="tocviewlink" data-pltdoc="x">Counting Positions, Lines, and Columns</a></td></tr><tr><td align="right">13.1.5&nbsp;</td><td><a href="file-ports.html" class="tocviewselflink" data-pltdoc="x">File Ports</a></td></tr><tr><td align="right">13.1.6&nbsp;</td><td><a href="stringport.html" class="tocviewlink" data-pltdoc="x">String Ports</a></td></tr><tr><td align="right">13.1.7&nbsp;</td><td><a href="pipeports.html" class="tocviewlink" data-pltdoc="x">Pipes</a></td></tr><tr><td align="right">13.1.8&nbsp;</td><td><a href="portstructs.html" class="tocviewlink" data-pltdoc="x">Structures as Ports</a></td></tr><tr><td align="right">13.1.9&nbsp;</td><td><a href="customport.html" class="tocviewlink" data-pltdoc="x">Custom Ports</a></td></tr><tr><td align="right">13.1.10&nbsp;</td><td><a href="port-lib.html" class="tocviewlink" data-pltdoc="x">More Port Constructors, Procedures, and Events</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-input-file%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">open-<wbr></wbr>input-<wbr></wbr>file</span></span></a></td></tr><tr><td><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-output-file%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">open-<wbr></wbr>output-<wbr></wbr>file</span></span></a></td></tr><tr><td><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-input-output-file%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">open-<wbr></wbr>input-<wbr></wbr>output-<wbr></wbr>file</span></span></a></td></tr><tr><td><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-input-file%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>input-<wbr></wbr>file</span></span></a></td></tr><tr><td><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-output-file%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>output-<wbr></wbr>file</span></span></a></td></tr><tr><td><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-input-file%2A%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>input-<wbr></wbr>file*</span></span></a></td></tr><tr><td><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-output-file%2A%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>output-<wbr></wbr>file*</span></span></a></td></tr><tr><td><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._with-input-from-file%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">with-<wbr></wbr>input-<wbr></wbr>from-<wbr></wbr>file</span></span></a></td></tr><tr><td><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._with-output-to-file%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">with-<wbr></wbr>output-<wbr></wbr>to-<wbr></wbr>file</span></span></a></td></tr><tr><td><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-try-file-lock~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>try-<wbr></wbr>file-<wbr></wbr>lock?</span></span></a></td></tr><tr><td><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-file-unlock%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>file-<wbr></wbr>unlock</span></span></a></td></tr><tr><td><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-file-identity%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>file-<wbr></wbr>identity</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="linecol.html" title="backward to &quot;13.1.4 Counting Positions, Lines, and Columns&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ports.html" title="up to &quot;13.1 Ports&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stringport.html" title="forward to &quot;13.1.6 String Ports&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;file-ports&quot;">13.1.5<tt>&nbsp;</tt><a name="(part._file-ports)"></a>File Ports</h5><p>A port created by <span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-input-file%29%29" class="RktValLink" data-pltdoc="x">open-input-file</a></span>, <span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-output-file%29%29" class="RktValLink" data-pltdoc="x">open-output-file</a></span>,
+<span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess%29%29" class="RktValLink" data-pltdoc="x">subprocess</a></span>, and related functions is a <a name="(tech._file._stream._port)"></a><span style="font-style: italic">file-stream
+port</span>.  The initial input, output, and error ports in <span class="stt">racket</span>
+are also file-stream ports. The <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._file-stream-port~3f%29%29" class="RktValLink" data-pltdoc="x">file-stream-port?</a></span>  predicate
+recognizes file-stream ports.</p><p>When an input or output file-stream port is created, it is placed into
+the management of the current custodian (see
+<a href="custodians.html" data-pltdoc="x">Custodians</a>). In the case of an output port, a <a href="plumbers.html#%28tech._flush._callback%29" class="techoutside" data-pltdoc="x"><span class="techinside">flush
+callback</span></a> is registered with the <a href="plumbers.html#%28tech._current._plumber%29" class="techoutside" data-pltdoc="x"><span class="techinside">current plumber</span></a> to flush the port.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._open-input-file))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-input-file%29%29" class="RktValDef RktValLink" data-pltdoc="x">open-input-file</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVar">mode-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:for-module?</span><span class="hspace">&nbsp;</span><span class="RktVar">for-module?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode-flag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">text</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">for-module?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Opens the file specified by <span class="RktVar">path</span> for input. The
+<span class="RktVar">mode-flag</span> argument specifies how the file&rsquo;s bytes are
+translated on input:</div></p><ul><li><p><a name="(idx._(gentag._251._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">binary</span> &#8212;<wbr></wbr> bytes are returned from the port
+exactly as they are read from the file.</p></li><li><p><a name="(idx._(gentag._252._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">text</span> &#8212;<wbr></wbr> return and linefeed bytes (10 and
+13) as read from the file are filtered by the port in a platform
+specific manner:</p><ul><li><p>Unix and Mac OS: no filtering occurs.</p></li><li><p>Windows: a return-linefeed combination from a file is returned
+by the port as a single linefeed; no filtering occurs for
+return bytes that are not followed by a linefeed, or for a
+linefeed that is not preceded by a return.</p></li></ul></li></ul><p>On Windows, <span class="RktVal">'</span><span class="RktVal">text</span> mode works only with regular files;
+attempting to use <span class="RktVal">'</span><span class="RktVal">text</span> with other kinds of files triggers an
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> exception.</p><p>Otherwise, the file specified by <span class="RktVar">path</span> need not be a regular
+file. It might be a device that is connected through the filesystem, such
+as <span class="stt">"aux"</span> on Windows or <span class="stt">"/dev/null"</span> on Unix. In all
+cases, the port is buffered by default.</p><p>The port produced by <span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-input-file%29%29" class="RktValLink" data-pltdoc="x">open-input-file</a></span> should be explicitly
+closed, either though <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-input-port%29%29" class="RktValLink" data-pltdoc="x">close-input-port</a></span> or indirectly via
+<span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-shutdown-all%29%29" class="RktValLink" data-pltdoc="x">custodian-shutdown-all</a></span>, to release the OS-level file
+handle. The input port will not be closed automatically if it is
+otherwise available for garbage collection (see
+<a href="eval-model.html#%28part._gc-model%29" data-pltdoc="x">Garbage Collection</a>); a <a href="willexecutor.html#%28tech._will%29" class="techoutside" data-pltdoc="x"><span class="techinside">will</span></a> could be associated with an input port
+to close it more automatically (see <a href="willexecutor.html" data-pltdoc="x">Wills and Executors</a>).</p><p>A <a href="pathutils.html#%28tech._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">path</span></a> value that is the <a href="pathutils.html#%28tech._cleanse%29" class="techoutside" data-pltdoc="x"><span class="techinside">cleanse</span></a>d version of
+<span class="RktVar">path</span> is used as the name of the opened port.</p><p>If opening the file fails due to an error in the filesystem,
+then <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3aerrno%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem:errno</a></span> exception is raised&#8212;<wbr></wbr>as long as
+<span class="RktVar">for-module?</span> is <span class="RktVal">#f</span>,
+<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-path-for-load%29%29" class="RktValLink" data-pltdoc="x">current-module-path-for-load</a></span> has a non-<span class="RktVal">#f</span> value, or
+the filesystem error is not recognized as a file-not-found error. Otherwise,
+when <span class="RktVar">for-module?</span> is true,
+<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-path-for-load%29%29" class="RktValLink" data-pltdoc="x">current-module-path-for-load</a></span> has a non-<span class="RktVal">#f</span> value,
+and the filesystem error is recognized as a file-not-found error,
+then the raised exception is either
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax~3amissing-module%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax:missing-module</a></span> (if the value of
+<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-path-for-load%29%29" class="RktValLink" data-pltdoc="x">current-module-path-for-load</a></span> is a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>) or
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3amissing-module%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem:missing-module</a></span> (otherwise).</p><p class="SHistory">Changed in version 6.0.1.6 of package <span class="stt">base</span>: Added <span class="RktPn">#:for-module?</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._with-output-to-file%29%29" class="RktValLink" data-pltdoc="x">with-output-to-file</a></span><span class="hspace">&nbsp;</span><span class="RktSym">some-file</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello world"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-input-file%29%29" class="RktValLink" data-pltdoc="x">open-input-file</a></span><span class="hspace">&nbsp;</span><span class="RktSym">some-file</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="RktValLink" data-pltdoc="x">read-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"hello world"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-input-port%29%29" class="RktValLink" data-pltdoc="x">close-input-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._open-output-file))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-output-file%29%29" class="RktValDef RktValLink" data-pltdoc="x">open-output-file</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVar">mode-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:exists</span><span class="hspace">&nbsp;</span><span class="RktVar">exists-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:permissions</span><span class="hspace">&nbsp;</span><span class="RktVar">permissions</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode-flag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">text</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">exists-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">error</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">append</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">update</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">can-update</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">replace</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">truncate</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">must-truncate</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">truncate/replace</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">error</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">permissions</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">65535</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#o666</span></td></tr></table></blockquote></div><div class="SIntrapara">Opens the file specified by <span class="RktVar">path</span> for output. The
+<span class="RktVar">mode-flag</span> argument specifies how bytes written to the port
+are translated when written to the file:</div></p><ul><li><p><span class="RktVal">'</span><span class="RktVal">binary</span> &#8212;<wbr></wbr> bytes are written to the file exactly
+as written to the port.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">text</span> &#8212;<wbr></wbr> on Windows, a linefeed byte (10) written
+to the port is translated to a return-linefeed combination in the
+file; no filtering occurs for returns.</p></li></ul><p>On Windows, <span class="RktVal">'</span><span class="RktVal">text</span> mode works only with regular files;
+attempting to use <span class="RktVal">'</span><span class="RktVal">text</span> with other kinds of files triggers an
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> exception.</p><p>The <span class="RktVar">exists-flag</span> argument specifies how to handle/require
+files that already exist:</p><ul><li><p><a name="(idx._(gentag._253._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">error</span> &#8212;<wbr></wbr> raise <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span>
+if the file exists.</p></li><li><p><a name="(idx._(gentag._254._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">replace</span> &#8212;<wbr></wbr> remove the old file, if it
+exists, and write a new one.</p></li><li><p><a name="(idx._(gentag._255._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">truncate</span> &#8212;<wbr></wbr> remove all old data, if the file
+exists.</p></li><li><p><a name="(idx._(gentag._256._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">must-truncate</span> &#8212;<wbr></wbr> remove all old data in an
+existing file; if the file does not exist, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> exception is raised.</p></li><li><p><a name="(idx._(gentag._257._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">truncate/replace</span> &#8212;<wbr></wbr> try <span class="RktVal">'</span><span class="RktVal">truncate</span>;
+if it fails (perhaps due to file permissions), try
+<span class="RktVal">'</span><span class="RktVal">replace</span>.</p></li><li><p><a name="(idx._(gentag._258._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">update</span> &#8212;<wbr></wbr> open an existing file without
+truncating it; if the file does not exist, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> exception is raised. Use <span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%29%29" class="RktValLink" data-pltdoc="x">file-position</a></span>
+to change the current read/write position.</p></li><li><p><a name="(idx._(gentag._259._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">can-update</span> &#8212;<wbr></wbr> open an existing file without
+truncating it, or create the file if it does not exist.</p></li><li><p><a name="(idx._(gentag._260._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">append</span> &#8212;<wbr></wbr> append to the end of the file,
+whether it already exists or not; on Windows,
+<span class="RktVal">'</span><span class="RktVal">append</span> is equivalent to <span class="RktVal">'</span><span class="RktVal">update</span>, except that
+the file is not required to exist, and the file position is
+immediately set to the end of the file after opening it.</p></li></ul><p>When the file specified by <span class="RktVar">path</span> is created,
+<span class="RktVar">permissions</span> specifies the permissions of the created file,
+where an integer representation of permissions is treated the same as
+for <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-permissions%29%29" class="RktValLink" data-pltdoc="x">file-or-directory-permissions</a></span>. On Unix and Mac OS, these
+permissions bits are combined with the process&rsquo;s umask. On Windows,
+the only relevant property of <span class="RktVar">permissions</span> is whether it has
+the <span class="RktVal">#o2</span> bit set for write permission. Note that a
+read-only file can be created with <span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-output-file%29%29" class="RktValLink" data-pltdoc="x">open-output-file</a></span>, in which
+case writing is prohibited only for later attempts to open the file.</p><p>The file specified by <span class="RktVar">path</span> need not be a regular file. It
+might be a device that is connected through the filesystem, such as
+<span class="stt">"aux"</span> on Windows or <span class="stt">"/dev/null"</span> on Unix. The output
+port is block-buffered by default, unless the file corresponds to a
+terminal, in which case it is line-buffered by default. On Unix and
+Mac OS, if the file is a fifo, then the port will block for writing
+until a reader for the fifo is available; see also
+<span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._port-waiting-peer~3f%29%29" class="RktValLink" data-pltdoc="x">port-waiting-peer?</a></span>.</p><p>The port produced by <span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-output-file%29%29" class="RktValLink" data-pltdoc="x">open-output-file</a></span> should be explicitly
+closed, either though <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-output-port%29%29" class="RktValLink" data-pltdoc="x">close-output-port</a></span> or indirectly via
+<span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-shutdown-all%29%29" class="RktValLink" data-pltdoc="x">custodian-shutdown-all</a></span>, to release the OS-level file
+handle. The output port will not be closed automatically if it is
+otherwise available for garbage collection (see
+<a href="eval-model.html#%28part._gc-model%29" data-pltdoc="x">Garbage Collection</a>); a <a href="willexecutor.html#%28tech._will%29" class="techoutside" data-pltdoc="x"><span class="techinside">will</span></a> could be associated with an output port
+to close it more automatically (see <a href="willexecutor.html" data-pltdoc="x">Wills and Executors</a>).</p><p>A <a href="pathutils.html#%28tech._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">path</span></a> value that is the <a href="pathutils.html#%28tech._cleanse%29" class="techoutside" data-pltdoc="x"><span class="techinside">cleanse</span></a>d version of
+<span class="RktVar">path</span> is used as the name of the opened port.</p><p>If opening the file fails due to an error in the underlying filesystem
+then <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem~3aerrno%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem:errno</a></span> exception is raised.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-output-file%29%29" class="RktValLink" data-pltdoc="x">open-output-file</a></span><span class="hspace">&nbsp;</span><span class="RktSym">some-file</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello world"</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-output-port%29%29" class="RktValLink" data-pltdoc="x">close-output-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.9.0.6 of package <span class="stt">base</span>: On Unix and Mac OS, make <span class="RktVal">'</span><span class="RktVal">truncate/replace</span>
+replace on a permission error. On Windows, make
+<span class="RktVal">'</span><span class="RktVal">replace</span> always replace instead truncating
+like <span class="RktVal">'</span><span class="RktVal">truncate/replace</span>.<br/>Changed in version 7.4.0.5: Changed handling of a fifo on Unix and Mac OS to
+make the port block for output until the fifo has a
+reader.<br/>Changed in version 8.1.0.3: Added the <span class="RktPn">#:permissions</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._open-input-output-file))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-input-output-file%29%29" class="RktValDef RktValLink" data-pltdoc="x">open-input-output-file</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVar">mode-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:exists</span><span class="hspace">&nbsp;</span><span class="RktVar">exists-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:permissions</span><span class="hspace">&nbsp;</span><span class="RktVar">permissions</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode-flag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">text</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">exists-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">error</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">append</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">update</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">can-update</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">replace</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">truncate</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">truncate/replace</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">error</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">permissions</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">65535</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#o666</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-output-file%29%29" class="RktValLink" data-pltdoc="x">open-output-file</a></span>, but producing two values: an input
+port and an output port. The two ports are connected in that they
+share the underlying file descriptor. This procedure is intended for use
+with special devices that can be opened by only one process, such as
+<span class="stt">"COM1"</span> in Windows. For regular files, sharing the file descriptor can be
+confusing. For example, using one port does not automatically flush
+the other port&rsquo;s buffer, and reading or writing in one port moves the
+file position (if any) for the other port. For regular files, use
+separate <span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-input-file%29%29" class="RktValLink" data-pltdoc="x">open-input-file</a></span> and <span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-output-file%29%29" class="RktValLink" data-pltdoc="x">open-output-file</a></span> calls
+to avoid confusion.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._call-with-input-file))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-input-file%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-input-file</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVar">mode-flag</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode-flag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">text</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span></td></tr></table></blockquote></div><div class="SIntrapara">Calls <span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-input-file%29%29" class="RktValLink" data-pltdoc="x">open-input-file</a></span> with the <span class="RktVar">path</span> and
+<span class="RktVar">mode-flag</span> arguments, and passes the resulting port
+to <span class="RktVar">proc</span>. The result of <span class="RktVar">proc</span> is the result of the
+<span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-input-file%29%29" class="RktValLink" data-pltdoc="x">call-with-input-file</a></span> call, but the newly opened port is closed
+when <span class="RktVar">proc</span> returns.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._with-output-to-file%29%29" class="RktValLink" data-pltdoc="x">with-output-to-file</a></span><span class="hspace">&nbsp;</span><span class="RktSym">some-file</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"text in a file"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-input-file%29%29" class="RktValLink" data-pltdoc="x">call-with-input-file</a></span><span class="hspace">&nbsp;</span><span class="RktSym">some-file</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="RktValLink" data-pltdoc="x">read-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">14</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"text in a file"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._call-with-output-file))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-output-file%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-output-file</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVar">mode-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:exists</span><span class="hspace">&nbsp;</span><span class="RktVar">exists-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:permissions</span><span class="hspace">&nbsp;</span><span class="RktVar">permissions</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode-flag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">text</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">exists-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">error</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">append</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">update</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">replace</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">truncate</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">truncate/replace</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">error</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">permissions</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">65535</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#o666</span></td></tr></table></blockquote></div><div class="SIntrapara">Analogous to <span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-input-file%29%29" class="RktValLink" data-pltdoc="x">call-with-input-file</a></span>, but passing <span class="RktVar">path</span>,
+<span class="RktVar">mode-flag</span>, <span class="RktVar">exists-flag</span>, and <span class="RktVar">permissions</span> to
+<span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-output-file%29%29" class="RktValLink" data-pltdoc="x">open-output-file</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-output-file%29%29" class="RktValLink" data-pltdoc="x">call-with-output-file</a></span><span class="hspace">&nbsp;</span><span class="RktSym">some-file</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">out</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">hello</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-input-file%29%29" class="RktValLink" data-pltdoc="x">call-with-input-file</a></span><span class="hspace">&nbsp;</span><span class="RktSym">some-file</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="RktValLink" data-pltdoc="x">read-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"hello"</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 8.1.0.3 of package <span class="stt">base</span>: Added the <span class="RktPn">#:permissions</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._call-with-input-file*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-input-file%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-input-file*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVar">mode-flag</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode-flag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">text</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-input-file%29%29" class="RktValLink" data-pltdoc="x">call-with-input-file</a></span>, but the newly opened port is
+closed whenever control escapes the dynamic extent of the
+<span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-input-file%2A%29%29" class="RktValLink" data-pltdoc="x">call-with-input-file*</a></span> call, whether through <span class="RktVar">proc</span>&rsquo;s
+return, a continuation application, or a prompt-based abort.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._call-with-output-file*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-output-file%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-output-file*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVar">mode-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:exists</span><span class="hspace">&nbsp;</span><span class="RktVar">exists-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:permissions</span><span class="hspace">&nbsp;</span><span class="RktVar">permissions</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode-flag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">text</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">exists-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">error</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">append</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">update</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">replace</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">truncate</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">truncate/replace</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">error</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">permissions</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">65535</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#o666</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-output-file%29%29" class="RktValLink" data-pltdoc="x">call-with-output-file</a></span>, but the newly opened port is
+closed whenever control escapes the dynamic extent of the
+<span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-output-file%2A%29%29" class="RktValLink" data-pltdoc="x">call-with-output-file*</a></span> call, whether through <span class="RktVar">proc</span>&rsquo;s
+return, a continuation application, or a prompt-based abort.</div></p><p class="SHistory">Changed in version 8.1.0.3 of package <span class="stt">base</span>: Added the <span class="RktPn">#:permissions</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._with-input-from-file))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._with-input-from-file%29%29" class="RktValDef RktValLink" data-pltdoc="x">with-input-from-file</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">thunk</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVar">mode-flag</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode-flag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">text</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-input-file%2A%29%29" class="RktValLink" data-pltdoc="x">call-with-input-file*</a></span>, but instead of passing the newly
+opened port to the given procedure argument, the port is installed as
+the current input port (see <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span>) using
+<span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span> around the call to <span class="RktVar">thunk</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._with-output-to-file%29%29" class="RktValLink" data-pltdoc="x">with-output-to-file</a></span><span class="hspace">&nbsp;</span><span class="RktSym">some-file</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._with-input-from-file%29%29" class="RktValLink" data-pltdoc="x">with-input-from-file</a></span><span class="hspace">&nbsp;</span><span class="RktSym">some-file</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="RktValLink" data-pltdoc="x">read-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"hello"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._with-output-to-file))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._with-output-to-file%29%29" class="RktValDef RktValLink" data-pltdoc="x">with-output-to-file</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">thunk</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVar">mode-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:exists</span><span class="hspace">&nbsp;</span><span class="RktVar">exists-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:permissions</span><span class="hspace">&nbsp;</span><span class="RktVar">permissions</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode-flag</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">text</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binary</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">exists-flag</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">error</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">append</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">update</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">replace</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">truncate</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">truncate/replace</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">error</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">permissions</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">65535</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#o666</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._call-with-output-file%2A%29%29" class="RktValLink" data-pltdoc="x">call-with-output-file*</a></span>, but instead of passing the newly
+opened port to the given procedure argument, the port is installed as
+the current output port (see <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span>) using
+<span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span> around the call to <span class="RktVar">thunk</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._with-output-to-file%29%29" class="RktValLink" data-pltdoc="x">with-output-to-file</a></span><span class="hspace">&nbsp;</span><span class="RktSym">some-file</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._with-input-from-file%29%29" class="RktValLink" data-pltdoc="x">with-input-from-file</a></span><span class="hspace">&nbsp;</span><span class="RktSym">some-file</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="RktValLink" data-pltdoc="x">read-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"hello"</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 8.1.0.3 of package <span class="stt">base</span>: Added the <span class="RktPn">#:permissions</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._port-try-file-lock~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-try-file-lock~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-try-file-lock?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span><span class="RktVar">mode</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._file-stream-port~3f%29%29" class="RktValLink" data-pltdoc="x">file-stream-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">shared</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exclusive</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Attempts to acquire a lock on the file using the current platform&rsquo;s
+facilities for file locking. Multiple processes can acquire a
+<span class="RktVal">'</span><span class="RktVal">shared</span> lock on a file, but at most one process can hold an
+<span class="RktVal">'</span><span class="RktVal">exclusive</span> lock, and <span class="RktVal">'</span><span class="RktVal">shared</span> and <span class="RktVal">'</span><span class="RktVal">exclusive</span>
+locks are mutually exclusive. When <span class="RktVar">mode</span> is <span class="RktVal">'</span><span class="RktVal">shared</span>,
+then <span class="RktVar">port</span> must be an input port; when <span class="RktVar">mode</span> is
+<span class="RktVal">'</span><span class="RktVal">exclusive</span>, then <span class="RktVar">port</span> must be an output port.</div></p><p>The result is <span class="RktVal">#t</span> if the requested lock is acquired,
+<span class="RktVal">#f</span> otherwise. When a lock is acquired, it is held until
+either it is released with <span class="RktSym"><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-file-unlock%29%29" class="RktValLink" data-pltdoc="x">port-file-unlock</a></span> or the port is closed
+(perhaps because the process terminates).</p><p>Depending on the platform, locks may be merely advisory (i.e., locks
+affect only the ability of processes to acquire locks) or they may
+correspond to mandatory locks that prevent reads and writes to the
+locked file. Specifically, locks are mandatory on Windows and advisory
+on other platforms. Multiple tries for a <span class="RktVal">'</span><span class="RktVal">shared</span> lock on a
+single port can succeed; on Unix and Mac OS, a single
+<span class="RktSym"><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-file-unlock%29%29" class="RktValLink" data-pltdoc="x">port-file-unlock</a></span> release the lock, while on other Windows, a
+<span class="RktSym"><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-file-unlock%29%29" class="RktValLink" data-pltdoc="x">port-file-unlock</a></span> is needed for each successful
+<span class="RktSym"><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-try-file-lock~3f%29%29" class="RktValLink" data-pltdoc="x">port-try-file-lock?</a></span>. On Unix and Mac OS, multiple tries for
+a <span class="RktVal">'</span><span class="RktVal">exclusive</span> lock can succeed and a single
+<span class="RktSym"><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-file-unlock%29%29" class="RktValLink" data-pltdoc="x">port-file-unlock</a></span> releases the lock, while on Windows, a try
+for an <span class="RktVal">'</span><span class="RktVal">exclusive</span> lock fails for a given port if the port
+already holds the lock.</p><p>A lock acquired for an input port from <span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-input-output-file%29%29" class="RktValLink" data-pltdoc="x">open-input-output-file</a></span>
+can be released through <span class="RktSym"><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-file-unlock%29%29" class="RktValLink" data-pltdoc="x">port-file-unlock</a></span> on the corresponding
+output port, and vice versa. If the output port from
+<span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-input-output-file%29%29" class="RktValLink" data-pltdoc="x">open-input-output-file</a></span> holds an <span class="RktVal">'</span><span class="RktVal">exclusive</span> lock, the
+corresponding input port can still acquire a <span class="RktVal">'</span><span class="RktVal">shared</span> lock,
+even multiple times; on Windows, a <span class="RktSym"><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-file-unlock%29%29" class="RktValLink" data-pltdoc="x">port-file-unlock</a></span> is needed
+for each successful lock try, while a single <span class="RktSym"><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-file-unlock%29%29" class="RktValLink" data-pltdoc="x">port-file-unlock</a></span>
+balances the lock tries on Unix and Mac OS. A <span class="RktVal">'</span><span class="RktVal">shared</span> lock on
+an input port can be upgraded to an <span class="RktVal">'</span><span class="RktVal">exclusive</span> lock through the
+corresponding output port on Unix and Mac OS, in which case a single
+<span class="RktSym"><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-file-unlock%29%29" class="RktValLink" data-pltdoc="x">port-file-unlock</a></span> (on either port) releases the lock, while
+such upgrades are not allowed on Windows.</p><p>Locking is normally supported only for file ports, and attempting to
+acquire a lock with other kinds of file-stream ports raises an
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> exception.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._port-file-unlock))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-file-unlock%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-file-unlock</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">port</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._file-stream-port~3f%29%29" class="RktValLink" data-pltdoc="x">file-stream-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Releases a lock held by the current process on the file of
+<span class="RktVar">port</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._port-file-identity))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-file-identity%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-file-identity</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">port</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._file-stream-port~3f%29%29" class="RktValLink" data-pltdoc="x">file-stream-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"><a name="(idx._(gentag._261._(lib._scribblings/reference/reference..scrbl)))"></a>Returns a number that represents
+the identity of the device and file read or written by
+<span class="RktVar">port</span>. For two ports whose open times overlap, the
+result of <span class="RktSym"><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-file-identity%29%29" class="RktValLink" data-pltdoc="x">port-file-identity</a></span> is the same for both ports if
+and only if the ports access the same device and file. For ports whose
+open times do not overlap, no guarantee can be provided for the port
+identities (even if the ports actually access the same file)&#8212;<wbr></wbr>except
+as can be inferred through relationships with other ports. If
+<span class="RktVar">port</span> is closed, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span> exception is raised.  On
+Windows 95, 98, and Me, if <span class="RktVar">port</span> is connected to a
+pipe instead of a file, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> exception is raised.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">file1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-output-file%29%29" class="RktValLink" data-pltdoc="x">open-output-file</a></span><span class="hspace">&nbsp;</span><span class="RktSym">some-file</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">file2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-output-file%29%29" class="RktValLink" data-pltdoc="x">open-output-file</a></span><span class="hspace">&nbsp;</span><span class="RktSym">some-other-file</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-file-identity%29%29" class="RktValLink" data-pltdoc="x">port-file-identity</a></span><span class="hspace">&nbsp;</span><span class="RktSym">file1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">7653369648741355870027010</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="file-ports.html#%28def._%28%28quote._~23~25kernel%29._port-file-identity%29%29" class="RktValLink" data-pltdoc="x">port-file-identity</a></span><span class="hspace">&nbsp;</span><span class="RktSym">file2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">7653388095485429579578626</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-output-port%29%29" class="RktValLink" data-pltdoc="x">close-output-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">file1</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-output-port%29%29" class="RktValLink" data-pltdoc="x">close-output-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">file2</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="linecol.html" title="backward to &quot;13.1.4 Counting Positions, Lines, and Columns&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ports.html" title="up to &quot;13.1 Ports&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stringport.html" title="forward to &quot;13.1.6 String Ports&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/finger.png b/clones/docs.racket-lang.org/reference/finger.png
new file mode 100644
index 0000000000000000000000000000000000000000..af521e80ad42a9ae5407c620edc296e7c4bba598
GIT binary patch
literal 430
zcmV;f0a5;mP)<h;3K|Lk000e1NJLTq000;O000;W1^@s6;CDUv0004XNkl<Zc%1Fi
z&r6h16vpw-sHs^JZ440;{{a(MLIg!3wJ-#68?_JuS7OoDaMiD65EN4cE`*`Q6y?@U
zhz12MqNs)FriFr_WHdA_?lE2lXDV6+^M%9Zy}b86=RD_J>eTsH8vpRWL7c@7w$U2V
zgi@`8IW*&B=1?m>V;Oz8ig#GY1&kt(uaRJL+|!8fSVRHkJ&~^XDC0gRu!4Eqz@dty
zF5_O6gc~p!Nf9Mxd4uOT6++))|5)r5@Cfa=i3Q1`CbZ!=hVh`9z`<BIGnd1c5IBLm
zA@l-cxFuP$jkkC#*;i9wuiP{Egn@`6X0U+~JjI;U{C#PtA@BoRxP;SqiQBk_Rm@^Z
z#_#>8RzWV-*AXPoi+C>$z!PbFr~XFZC^~RnYUHzs60YM8UZEf3*hQz`yoc<V?&1Tc
zaX^~;hf*W2;G)#XA<5nz$)-xHf009r^muylQEFTzhtZ8AI2V=fNRyVwS~Y<>b^Zf>
Y0+i!VsAM9jdH?_b07*qoM6N<$g28abDF6Tf

literal 0
HcmV?d00001

diff --git a/clones/docs.racket-lang.org/reference/fixnums.html b/clones/docs.racket-lang.org/reference/fixnums.html
new file mode 100644
index 00000000..0649eeac
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/fixnums.html
@@ -0,0 +1,79 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.3.4&nbsp;Fixnums</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewselflink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.3.1&nbsp;</td><td><a href="number-types.html" class="tocviewlink" data-pltdoc="x">Number Types</a></td></tr><tr><td align="right">4.3.2&nbsp;</td><td><a href="generic-numbers.html" class="tocviewlink" data-pltdoc="x">Generic Numerics</a></td></tr><tr><td align="right">4.3.3&nbsp;</td><td><a href="flonums.html" class="tocviewlink" data-pltdoc="x">Flonums</a></td></tr><tr><td align="right">4.3.4&nbsp;</td><td><a href="fixnums.html" class="tocviewselflink" data-pltdoc="x">Fixnums</a></td></tr><tr><td align="right">4.3.5&nbsp;</td><td><a href="extflonums.html" class="tocviewlink" data-pltdoc="x">Extflonums</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_3&quot;);">&#9658;</a></td><td>4.3.4&nbsp;</td><td><a href="fixnums.html" class="tocviewselflink" data-pltdoc="x">Fixnums</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_3"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.3.4.1&nbsp;</td><td><a href="fixnums.html#%28part._.Fixnum_.Arithmetic%29" class="tocviewlink" data-pltdoc="x">Fixnum Arithmetic</a></td></tr><tr><td align="right">4.3.4.2&nbsp;</td><td><a href="fixnums.html#%28part._fxvectors%29" class="tocviewlink" data-pltdoc="x">Fixnum Vectors</a></td></tr><tr><td align="right">4.3.4.3&nbsp;</td><td><a href="fixnums.html#%28part._fxrange%29" class="tocviewlink" data-pltdoc="x">Fixnum Range</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">4.3.4.1<tt>&nbsp;</tt></span><a href="fixnums.html#%28part._.Fixnum_.Arithmetic%29" class="tocsubseclink" data-pltdoc="x">Fixnum Arithmetic</a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2B%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx+</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx-%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx-</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx*</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxquotient%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxquotient</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxremainder%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxremainder</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxmodulo%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxmodulo</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxabs%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxabs</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxand%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxand</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxior%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxior</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxxor%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxxor</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxnot%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxnot</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxlshift%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxlshift</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxrshift%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxrshift</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxpopcount%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxpopcount</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxpopcount32%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxpopcount32</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxpopcount16%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxpopcount16</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2B%2Fwraparound%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx+<span class="mywbr"> &nbsp;</span>/<span class="mywbr"> &nbsp;</span>wraparound</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx-%2Fwraparound%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx-<wbr></wbr>/<span class="mywbr"> &nbsp;</span>wraparound</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2A%2Fwraparound%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx*/<span class="mywbr"> &nbsp;</span>wraparound</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxlshift%2Fwraparound%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxlshift/<span class="mywbr"> &nbsp;</span>wraparound</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx=</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx~3c%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx&lt;</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx~3e%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx&gt;</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx~3c~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx&lt;=</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx~3e~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx&gt;=</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxmin%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxmin</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxmax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxmax</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx-~3efl%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fx-<wbr></wbr>&gt;fl</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fl-~3efx%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl-<wbr></wbr>&gt;fx</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fixnum-for-every-system~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fixnum-<wbr></wbr>for-<wbr></wbr>every-<wbr></wbr>system?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.3.4.2<tt>&nbsp;</tt></span><a href="fixnums.html#%28part._fxvectors%29" class="tocsubseclink" data-pltdoc="x">Fixnum Vectors</a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxvector?</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxvector</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._make-fxvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>fxvector</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector-length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxvector-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxvector-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxvector-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector-copy%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fxvector-<wbr></wbr>copy</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._in-fxvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>fxvector</span></span></a></td></tr><tr><td><a href="fixnums.html#%28form._%28%28lib._racket%2Ffixnum..rkt%29._for%2Ffxvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>fxvector</span></span></a></td></tr><tr><td><a href="fixnums.html#%28form._%28%28lib._racket%2Ffixnum..rkt%29._for%2A%2Ffxvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>fxvector</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._shared-fxvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">shared-<wbr></wbr>fxvector</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._make-shared-fxvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>shared-<wbr></wbr>fxvector</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.3.4.3<tt>&nbsp;</tt></span><a href="fixnums.html#%28part._fxrange%29" class="tocsubseclink" data-pltdoc="x">Fixnum Range</a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._most-positive-fixnum%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">most-<wbr></wbr>positive-<wbr></wbr>fixnum</span></span></a></td></tr><tr><td><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._most-negative-fixnum%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">most-<wbr></wbr>negative-<wbr></wbr>fixnum</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="flonums.html" title="backward to &quot;4.3.3 Flonums&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="numbers.html" title="up to &quot;4.3 Numbers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="extflonums.html" title="forward to &quot;4.3.5 Extflonums&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;fixnums&quot;">4.3.4<tt>&nbsp;</tt><a name="(part._fixnums)"></a><a name="(mod-path._racket/fixnum)"></a>Fixnums</h5><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="fixnums.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/fixnum</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></p><p>The <a href="fixnums.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/fixnum</span></a> library provides operations like
+<span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2B%29%29" class="RktValLink" data-pltdoc="x">fx+</a></span> that consume and produce only <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnums</span></a>. The operations in
+this library are meant to be safe versions of unsafe operations like
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx%2B%29%29" class="RktValLink" data-pltdoc="x">unsafe-fx+</a></span>. These safe operations are generally no faster
+than using generic primitives like <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span>.</p><p>The expected use of the <a href="fixnums.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/fixnum</span></a> library is for
+code where the <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> of <a href="fixnums.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/fixnum</span></a> is
+replaced with</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._filtered-in%29%29" class="RktStxLink" data-pltdoc="x">filtered-in</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">name</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"^unsafe-fx"</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-replace%29%29" class="RktValLink" data-pltdoc="x">regexp-replace</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"unsafe-"</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktVal">""</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">racket/unsafe/ops</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>to drop in unsafe versions of the library. Alternately, when
+encountering crashes with code that uses unsafe fixnum operations, use
+the <a href="fixnums.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/fixnum</span></a> library to help debug the problems.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Fixnum_Arithmetic&quot;">4.3.4.1<tt>&nbsp;</tt><a name="(part._.Fixnum_.Arithmetic)"></a>Fixnum Arithmetic</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fx+))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2B%29%29" class="RktValDef RktValLink" data-pltdoc="x">fx+</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fx-))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx-%29%29" class="RktValDef RktValLink" data-pltdoc="x">fx-</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fx*))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">fx*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxquotient))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxquotient%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxquotient</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxremainder))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxremainder%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxremainder</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxmodulo))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxmodulo%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxmodulo</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxabs))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxabs%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxabs</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Safe versions of <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx%2B%29%29" class="RktValLink" data-pltdoc="x">unsafe-fx+</a></span>, <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx-%29%29" class="RktValLink" data-pltdoc="x">unsafe-fx-</a></span>,
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx%2A%29%29" class="RktValLink" data-pltdoc="x">unsafe-fx*</a></span>, <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxquotient%29%29" class="RktValLink" data-pltdoc="x">unsafe-fxquotient</a></span>,
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxremainder%29%29" class="RktValLink" data-pltdoc="x">unsafe-fxremainder</a></span>, <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxmodulo%29%29" class="RktValLink" data-pltdoc="x">unsafe-fxmodulo</a></span>, and
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxabs%29%29" class="RktValLink" data-pltdoc="x">unsafe-fxabs</a></span>. The
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3anon-fixnum-result%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:non-fixnum-result</a></span> exception is raised if the arithmetic
+result would not be a fixnum.</div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow zero or more arguments for <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2B%29%29" class="RktValLink" data-pltdoc="x">fx+</a></span> and <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2A%29%29" class="RktValLink" data-pltdoc="x">fx*</a></span>
+and one or more arguments for <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx-%29%29" class="RktValLink" data-pltdoc="x">fx-</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxand))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxand%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxand</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxior))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxior%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxior</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxxor))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxxor%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxxor</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxnot))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxnot%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxnot</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxlshift))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxlshift%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxlshift</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxrshift))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxrshift%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxrshift</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-and%29%29" class="RktValLink" data-pltdoc="x">bitwise-and</a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-ior%29%29" class="RktValLink" data-pltdoc="x">bitwise-ior</a></span>,
+<span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-xor%29%29" class="RktValLink" data-pltdoc="x">bitwise-xor</a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-not%29%29" class="RktValLink" data-pltdoc="x">bitwise-not</a></span>, and
+<span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._arithmetic-shift%29%29" class="RktValLink" data-pltdoc="x">arithmetic-shift</a></span>, but constrained to consume <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnums</span></a>;
+the result is always a <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a>. The <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxlshift%29%29" class="RktValLink" data-pltdoc="x">unsafe-fxlshift</a></span> and
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxrshift%29%29" class="RktValLink" data-pltdoc="x">unsafe-fxrshift</a></span> operations correspond to
+<span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._arithmetic-shift%29%29" class="RktValLink" data-pltdoc="x">arithmetic-shift</a></span>, but require non-negative arguments;
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxlshift%29%29" class="RktValLink" data-pltdoc="x">unsafe-fxlshift</a></span> is a positive (i.e., left) shift, and
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxrshift%29%29" class="RktValLink" data-pltdoc="x">unsafe-fxrshift</a></span> is a negative (i.e., right) shift, where the
+number of bits to shift must be no more than the number of bits used to
+represent a <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a>. The
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3anon-fixnum-result%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:non-fixnum-result</a></span> exception is raised if the arithmetic
+result would not be a fixnum.</div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow any number of arguments for <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxand%29%29" class="RktValLink" data-pltdoc="x">fxand</a></span>, <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxior%29%29" class="RktValLink" data-pltdoc="x">fxior</a></span>,
+and <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxxor%29%29" class="RktValLink" data-pltdoc="x">fxxor</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxpopcount))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxpopcount%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxpopcount</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._negative~3f%29%29" class="RktValLink" data-pltdoc="x">negative?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxpopcount32))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxpopcount32%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxpopcount32</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">#xFFFFFFFF</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxpopcount16))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxpopcount16%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxpopcount16</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">#xFFFF</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Counts the number of bits in the two&rsquo;s complement representation of
+<span class="RktVar">a</span>. Depending on the platform, the <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxpopcount32%29%29" class="RktValLink" data-pltdoc="x">fxpopcount32</a></span> and
+<span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxpopcount16%29%29" class="RktValLink" data-pltdoc="x">fxpopcount16</a></span> operations can be faster when the result is
+known to be no more than 32 or 16, respectively.</div></p><p class="SHistory">Added in version 8.5.0.7 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fx+/wraparound))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2B%2Fwraparound%29%29" class="RktValDef RktValLink" data-pltdoc="x">fx+/wraparound</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fx-/wraparound))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx-%2Fwraparound%29%29" class="RktValDef RktValLink" data-pltdoc="x">fx-/wraparound</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fx*/wraparound))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2A%2Fwraparound%29%29" class="RktValDef RktValLink" data-pltdoc="x">fx*/wraparound</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxlshift/wraparound))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxlshift%2Fwraparound%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxlshift/wraparound</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2B%29%29" class="RktValLink" data-pltdoc="x">fx+</a></span>, <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx-%29%29" class="RktValLink" data-pltdoc="x">fx-</a></span>, <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2A%29%29" class="RktValLink" data-pltdoc="x">fx*</a></span>, and <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxlshift%29%29" class="RktValLink" data-pltdoc="x">fxlshift</a></span>,
+but a fixnum result is produced for any allowed arguments (i.e., for
+any fixnum argument, except that the second
+<span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxlshift%2Fwraparound%29%29" class="RktValLink" data-pltdoc="x">fxlshift/wraparound</a></span> argument must be between 0 and the number
+of bits in a fixnum, inclusive). The result is produced by simply discarding bits
+that do not fit in a fixnum representation. The result is negative if
+the highest of the retained bits is set&#8212;<wbr></wbr>even, for example, if the
+value was produced by adding two positive fixnums.</div></p><p class="SHistory">Added in version 7.9.0.6 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fx~3d))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx~3d%29%29" class="RktValDef RktValLink" data-pltdoc="x">fx=</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fx~3c))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx~3c%29%29" class="RktValDef RktValLink" data-pltdoc="x">fx&lt;</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fx~3e))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx~3e%29%29" class="RktValDef RktValLink" data-pltdoc="x">fx&gt;</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fx~3c~3d))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx~3c~3d%29%29" class="RktValDef RktValLink" data-pltdoc="x">fx&lt;=</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fx~3e~3d))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx~3e~3d%29%29" class="RktValDef RktValLink" data-pltdoc="x">fx&gt;=</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxmin))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxmin%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxmin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxmax))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxmax%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxmax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e%29%29" class="RktValLink" data-pltdoc="x">&gt;</a></span>,
+<span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c~3d%29%29" class="RktValLink" data-pltdoc="x">&lt;=</a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e~3d%29%29" class="RktValLink" data-pltdoc="x">&gt;=</a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._min%29%29" class="RktValLink" data-pltdoc="x">min</a></span>, and <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._max%29%29" class="RktValLink" data-pltdoc="x">max</a></span>, but
+constrained to consume <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnums</span></a>.</div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fx-~3efl))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx-~3efl%29%29" class="RktValDef RktValLink" data-pltdoc="x">fx-&gt;fl</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fl-~3efx))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fl-~3efx%29%29" class="RktValDef RktValLink" data-pltdoc="x">fl-&gt;fx</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">fl</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fl</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Conversion between <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnums</span></a> and <a href="numbers.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonums</span></a> with truncation
+in the case of converting a <a href="numbers.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonum</span></a> to a <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a>.</div></p><p>The <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx-~3efl%29%29" class="RktValLink" data-pltdoc="x">fx-&gt;fl</a></span> function is the same as <span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-~3einexact%29%29" class="RktValLink" data-pltdoc="x">exact-&gt;inexact</a></span> or
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._-~3efl%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>fl</a></span> constrained to a fixnum argument.</p><p>The <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fl-~3efx%29%29" class="RktValLink" data-pltdoc="x">fl-&gt;fx</a></span> function is the same as <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._truncate%29%29" class="RktValLink" data-pltdoc="x">truncate</a></span> followed
+by <span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact-~3eexact%29%29" class="RktValLink" data-pltdoc="x">inexact-&gt;exact</a></span> or <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl-~3eexact-integer%29%29" class="RktValLink" data-pltdoc="x">fl-&gt;exact-integer</a></span> constrained
+to returning a fixnum. If the truncated flonum does not fit into a
+fixnum, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p class="SHistory">Changed in version 7.7.0.8 of package <span class="stt">base</span>: Changed <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fl-~3efx%29%29" class="RktValLink" data-pltdoc="x">fl-&gt;fx</a></span> to truncate.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fixnum-for-every-system~3f))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fixnum-for-every-system~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">fixnum-for-every-system?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a> and is
+represented by fixnum by every Racket implementation, <span class="RktVal">#f</span>
+otherwise.</div></p><p class="SHistory">Added in version 7.3.0.11 of package <span class="stt">base</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;fxvectors&quot;">4.3.4.2<tt>&nbsp;</tt><a name="(part._fxvectors)"></a>Fixnum Vectors</h5><p>A <a name="(tech._fxvector)"></a><span style="font-style: italic">fxvector</span> is like a <a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vector</span></a>, but it holds only
+<a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnums</span></a>. The only advantage of a <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a> over a
+<a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vector</span></a> is that a shared version can be created with functions
+like <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._shared-fxvector%29%29" class="RktValLink" data-pltdoc="x">shared-fxvector</a></span>.</p><p>Two <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvectors</span></a> are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> if they have the same length,
+and if the values in corresponding slots of the <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvectors</span></a> are
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>.</p><p>A printed <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a> starts with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fx(</span><span class="hspace"></span></span>, optionally with
+a number between the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fx</span><span class="hspace"></span></span> and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span>. See <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a>
+    for information on <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>ing
+    fxvectors and <a href="printing.html#%28part._print-vectors%29" data-pltdoc="x">Printing Vectors</a>
+    for information on <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>ing fxvectors.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxvector~3f))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxvector?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxvector))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxvector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector~3f%29%29" class="RktValLink" data-pltdoc="x">fxvector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a> containing the given <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnums</span></a>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector%29%29" class="RktValLink" data-pltdoc="x">fxvector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(fxvector 2 3 4 5)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._make-fxvector))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._make-fxvector%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-fxvector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">size</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">x</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector~3f%29%29" class="RktValLink" data-pltdoc="x">fxvector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">size</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a> with <span class="RktVar">size</span> elements, where every
+slot in the <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a> is filled with <span class="RktVar">x</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._make-fxvector%29%29" class="RktValLink" data-pltdoc="x">make-fxvector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(fxvector 3 3 3 3)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxvector-length))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxvector-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector~3f%29%29" class="RktValLink" data-pltdoc="x">fxvector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the length of <span class="RktVar">vec</span> (i.e., the number of slots in the
+<a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a>).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxvector-ref))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxvector-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector~3f%29%29" class="RktValLink" data-pltdoc="x">fxvector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a> in slot <span class="RktVar">pos</span> of
+<span class="RktVar">vec</span>. The first slot is position <span class="RktVal">0</span>, and the last slot
+is one less than <span class="RktPn">(</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector-length%29%29" class="RktValLink" data-pltdoc="x">fxvector-length</a></span><span class="stt"> </span><span class="RktVar">vec</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxvector-set!))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxvector-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector~3f%29%29" class="RktValLink" data-pltdoc="x">fxvector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Sets the <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a> in slot <span class="RktVar">pos</span> of <span class="RktVar">vec</span>. The
+first slot is position <span class="RktVal">0</span>, and the last slot is one less than
+<span class="RktPn">(</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector-length%29%29" class="RktValLink" data-pltdoc="x">fxvector-length</a></span><span class="stt"> </span><span class="RktVar">vec</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._fxvector-copy))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector-copy%29%29" class="RktValDef RktValLink" data-pltdoc="x">fxvector-copy</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector~3f%29%29" class="RktValLink" data-pltdoc="x">fxvector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector~3f%29%29" class="RktValLink" data-pltdoc="x">fxvector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="RktValLink" data-pltdoc="x">vector-length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a fresh <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a> of size <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">end</span><span class="stt"> </span><span class="RktVar">start</span><span class="RktPn">)</span>, with all of the
+elements of <span class="RktVar">vec</span> from <span class="RktVar">start</span> (inclusive) to
+<span class="RktVar">end</span> (exclusive).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._in-fxvector))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._in-fxvector%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-fxvector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">stop</span><span class="hspace">&nbsp;</span><span class="RktVar">step</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector~3f%29%29" class="RktValLink" data-pltdoc="x">fxvector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">step</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence equivalent to <span class="RktVar">vec</span> when no optional
+arguments are supplied.</div></p><p>The optional arguments <span class="RktVar">start</span>, <span class="RktVar">stop</span>, and
+<span class="RktVar">step</span> are as in <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-vector%29%29" class="RktValLink" data-pltdoc="x">in-vector</a></span>.</p><p>An <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._in-fxvector%29%29" class="RktValLink" data-pltdoc="x">in-fxvector</a></span> application can provide better
+performance for <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a> iteration when it appears directly in a <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> clause.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/fixnum..rkt)._for/fxvector))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28form._%28%28lib._racket%2Ffixnum..rkt%29._for%2Ffxvector%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/fxvector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-length</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/fixnum..rkt)._for*/fxvector))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28form._%28%28lib._racket%2Ffixnum..rkt%29._for%2A%2Ffxvector%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/fxvector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-length</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">maybe-length</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:length</span><span class="hspace">&nbsp;</span><span class="RktVar">length-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:length</span><span class="hspace">&nbsp;</span><span class="RktVar">length-expr</span><span class="hspace">&nbsp;</span><span class="RktPn">#:fill</span><span class="hspace">&nbsp;</span><span class="RktVar">fill-expr</span></td></tr></table></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><blockquote class="SubFlow"><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">length-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">fill-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fvector%29%29" class="RktStxLink" data-pltdoc="x">for/vector</a></span> or <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fvector%29%29" class="RktStxLink" data-pltdoc="x">for*/vector</a></span>, but for
+<a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a>s. The default <span class="RktVar">fill-expr</span> produces <span class="RktVal">0</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._shared-fxvector))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._shared-fxvector%29%29" class="RktValDef RktValLink" data-pltdoc="x">shared-fxvector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector~3f%29%29" class="RktValLink" data-pltdoc="x">fxvector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a> containing the given <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnums</span></a>.
+For communication among <a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">places</span></a>, the new <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a> is
+allocated in the <a href="places.html#%28tech._shared._memory._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">shared memory space</span></a>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._shared-fxvector%29%29" class="RktValLink" data-pltdoc="x">shared-fxvector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(fxvector 2 3 4 5)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._make-shared-fxvector))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._make-shared-fxvector%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-shared-fxvector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">size</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">x</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector~3f%29%29" class="RktValLink" data-pltdoc="x">fxvector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">size</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a> with <span class="RktVar">size</span> elements, where every
+slot in the <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a> is filled with <span class="RktVar">x</span>.
+For communication among <a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">places</span></a>, the new <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a> is
+allocated in the <a href="places.html#%28tech._shared._memory._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">shared memory space</span></a>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._make-shared-fxvector%29%29" class="RktValLink" data-pltdoc="x">make-shared-fxvector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(fxvector 3 3 3 3)</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;fxrange&quot;">4.3.4.3<tt>&nbsp;</tt><a name="(part._fxrange)"></a>Fixnum Range</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._most-positive-fixnum))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._most-positive-fixnum%29%29" class="RktValDef RktValLink" data-pltdoc="x">most-positive-fixnum</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/fixnum..rkt)._most-negative-fixnum))"></a><span title="Provided from: racket/fixnum | Package: base"><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._most-negative-fixnum%29%29" class="RktValDef RktValLink" data-pltdoc="x">most-negative-fixnum</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns the largest-magnitude positive and negative <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnums</span></a>.
+The values of <span class="RktPn">(</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._most-positive-fixnum%29%29" class="RktValLink" data-pltdoc="x">most-positive-fixnum</a></span><span class="RktPn">)</span> and
+<span class="RktPn">(</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._most-negative-fixnum%29%29" class="RktValLink" data-pltdoc="x">most-negative-fixnum</a></span><span class="RktPn">)</span> depend on the platform and virtual
+machine, but all fixnums are in the range
+<span class="RktPn">(</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._most-negative-fixnum%29%29" class="RktValLink" data-pltdoc="x">most-negative-fixnum</a></span><span class="RktPn">)</span> to <span class="RktPn">(</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._most-positive-fixnum%29%29" class="RktValLink" data-pltdoc="x">most-positive-fixnum</a></span><span class="RktPn">)</span>
+inclusive, and all exact integers in that range are fixnums.</div></p><p class="SHistory">Added in version 8.1.0.7 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="flonums.html" title="backward to &quot;4.3.3 Flonums&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="numbers.html" title="up to &quot;4.3 Numbers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="extflonums.html" title="forward to &quot;4.3.5 Extflonums&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/flonums.html b/clones/docs.racket-lang.org/reference/flonums.html
new file mode 100644
index 00000000..3307c2d8
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/flonums.html
@@ -0,0 +1,73 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.3.3&nbsp;Flonums</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewselflink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.3.1&nbsp;</td><td><a href="number-types.html" class="tocviewlink" data-pltdoc="x">Number Types</a></td></tr><tr><td align="right">4.3.2&nbsp;</td><td><a href="generic-numbers.html" class="tocviewlink" data-pltdoc="x">Generic Numerics</a></td></tr><tr><td align="right">4.3.3&nbsp;</td><td><a href="flonums.html" class="tocviewselflink" data-pltdoc="x">Flonums</a></td></tr><tr><td align="right">4.3.4&nbsp;</td><td><a href="fixnums.html" class="tocviewlink" data-pltdoc="x">Fixnums</a></td></tr><tr><td align="right">4.3.5&nbsp;</td><td><a href="extflonums.html" class="tocviewlink" data-pltdoc="x">Extflonums</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_3&quot;);">&#9658;</a></td><td>4.3.3&nbsp;</td><td><a href="flonums.html" class="tocviewselflink" data-pltdoc="x">Flonums</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_3"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.3.3.1&nbsp;</td><td><a href="flonums.html#%28part._.Flonum_.Arithmetic%29" class="tocviewlink" data-pltdoc="x">Flonum Arithmetic</a></td></tr><tr><td align="right">4.3.3.2&nbsp;</td><td><a href="flonums.html#%28part._flvectors%29" class="tocviewlink" data-pltdoc="x">Flonum Vectors</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">4.3.3.1<tt>&nbsp;</tt></span><a href="flonums.html#%28part._.Flonum_.Arithmetic%29" class="tocsubseclink" data-pltdoc="x">Flonum Arithmetic</a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2B%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl+</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl-%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl-</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl*</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2F%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl/</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flabs%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flabs</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl=</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3c%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl&lt;</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3e%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl&gt;</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3c~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl&lt;=</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3e~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl&gt;=</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flmin%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flmin</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flmax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flmax</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flround%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flround</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flfloor%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flfloor</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flceiling%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flceiling</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fltruncate%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fltruncate</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flsingle%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flsingle</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flsin%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flsin</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flcos%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flcos</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fltan%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fltan</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flasin%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flasin</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flacos%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flacos</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flatan%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flatan</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fllog%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fllog</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flexp%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flexp</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flsqrt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flsqrt</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flexpt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flexpt</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._-~3efl%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink"><span class="nobreak">-<wbr></wbr>&gt;</span>fl</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl-~3eexact-integer%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fl-<wbr></wbr>&gt;exact-<wbr></wbr>integer</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._make-flrectangular%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>flrectangular</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flreal-part%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flreal-<wbr></wbr>part</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flimag-part%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flimag-<wbr></wbr>part</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flrandom%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flrandom</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.3.3.2<tt>&nbsp;</tt></span><a href="flonums.html#%28part._flvectors%29" class="tocsubseclink" data-pltdoc="x">Flonum Vectors</a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flvector?</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flvector</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._make-flvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>flvector</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector-length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flvector-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flvector-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flvector-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector-copy%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flvector-<wbr></wbr>copy</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._in-flvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>flvector</span></span></a></td></tr><tr><td><a href="flonums.html#%28form._%28%28lib._racket%2Fflonum..rkt%29._for%2Fflvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>flvector</span></span></a></td></tr><tr><td><a href="flonums.html#%28form._%28%28lib._racket%2Fflonum..rkt%29._for%2A%2Fflvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>flvector</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._shared-flvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">shared-<wbr></wbr>flvector</span></span></a></td></tr><tr><td><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._make-shared-flvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>shared-<wbr></wbr>flvector</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="generic-numbers.html" title="backward to &quot;4.3.2 Generic Numerics&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="numbers.html" title="up to &quot;4.3 Numbers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="fixnums.html" title="forward to &quot;4.3.4 Fixnums&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;flonums&quot;">4.3.3<tt>&nbsp;</tt><a name="(part._flonums)"></a><a name="(mod-path._racket/flonum)"></a>Flonums</h5><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="flonums.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/flonum</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></p><p>The <a href="flonums.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/flonum</span></a> library provides operations like
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2B%29%29" class="RktValLink" data-pltdoc="x">fl+</a></span> that consume and produce only
+<a href="numbers.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonums</span></a>. Flonum-specific operations can provide better
+performance when used consistently, and they are as safe as generic
+operations like <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span>See also <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=performance.html%23%2528part._fixnums%252Bflonums%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Fixnum and Flonum Optimizations</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a>.</p></blockquote></blockquote></blockquote><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Flonum_Arithmetic&quot;">4.3.3.1<tt>&nbsp;</tt><a name="(part._.Flonum_.Arithmetic)"></a>Flonum Arithmetic</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._fl+))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2B%29%29" class="RktValDef RktValLink" data-pltdoc="x">fl+</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._fl-))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl-%29%29" class="RktValDef RktValLink" data-pltdoc="x">fl-</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._fl*))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">fl*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._fl/))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2F%29%29" class="RktValDef RktValLink" data-pltdoc="x">fl/</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flabs))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flabs%29%29" class="RktValDef RktValLink" data-pltdoc="x">flabs</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2F%29%29" class="RktValLink" data-pltdoc="x">/</a></span>, and <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._abs%29%29" class="RktValLink" data-pltdoc="x">abs</a></span>,
+but constrained to consume <a href="numbers.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonums</span></a>. The result is always a
+<a href="numbers.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonum</span></a>.</div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow zero or more arguments for <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2B%29%29" class="RktValLink" data-pltdoc="x">fl+</a></span> and <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2A%29%29" class="RktValLink" data-pltdoc="x">fl*</a></span>
+and one or more arguments for <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl-%29%29" class="RktValLink" data-pltdoc="x">fl-</a></span> and <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2F%29%29" class="RktValLink" data-pltdoc="x">fl/</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._fl~3d))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3d%29%29" class="RktValDef RktValLink" data-pltdoc="x">fl=</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._fl~3c))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3c%29%29" class="RktValDef RktValLink" data-pltdoc="x">fl&lt;</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._fl~3e))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3e%29%29" class="RktValDef RktValLink" data-pltdoc="x">fl&gt;</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._fl~3c~3d))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3c~3d%29%29" class="RktValDef RktValLink" data-pltdoc="x">fl&lt;=</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._fl~3e~3d))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3e~3d%29%29" class="RktValDef RktValLink" data-pltdoc="x">fl&gt;=</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flmin))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flmin%29%29" class="RktValDef RktValLink" data-pltdoc="x">flmin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flmax))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flmax%29%29" class="RktValDef RktValLink" data-pltdoc="x">flmax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e%29%29" class="RktValLink" data-pltdoc="x">&gt;</a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c~3d%29%29" class="RktValLink" data-pltdoc="x">&lt;=</a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e~3d%29%29" class="RktValLink" data-pltdoc="x">&gt;=</a></span>,
+<span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._min%29%29" class="RktValLink" data-pltdoc="x">min</a></span>, and <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._max%29%29" class="RktValLink" data-pltdoc="x">max</a></span>, but constrained to consume
+<a href="numbers.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonums</span></a>.</div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flround))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flround%29%29" class="RktValDef RktValLink" data-pltdoc="x">flround</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flfloor))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flfloor%29%29" class="RktValDef RktValLink" data-pltdoc="x">flfloor</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flceiling))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flceiling%29%29" class="RktValDef RktValLink" data-pltdoc="x">flceiling</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._fltruncate))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fltruncate%29%29" class="RktValDef RktValLink" data-pltdoc="x">fltruncate</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._round%29%29" class="RktValLink" data-pltdoc="x">round</a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._floor%29%29" class="RktValLink" data-pltdoc="x">floor</a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._ceiling%29%29" class="RktValLink" data-pltdoc="x">ceiling</a></span>, and
+<span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._truncate%29%29" class="RktValLink" data-pltdoc="x">truncate</a></span>, but constrained to consume <a href="numbers.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonums</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flsingle))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flsingle%29%29" class="RktValDef RktValLink" data-pltdoc="x">flsingle</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a value like <span class="RktVar">a</span>, but potentially discards precision
+and range so that the result can be represented as a single-precision
+IEEE floating-point number (even if <a href="numbers.html#%28tech._single._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">single-flonums</span></a> are not
+supported).</div></p><p>Using <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flsingle%29%29" class="RktValLink" data-pltdoc="x">flsingle</a></span> on the arguments and results of <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2B%29%29" class="RktValLink" data-pltdoc="x">fl+</a></span>,
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl-%29%29" class="RktValLink" data-pltdoc="x">fl-</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2A%29%29" class="RktValLink" data-pltdoc="x">fl*</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2F%29%29" class="RktValLink" data-pltdoc="x">fl/</a></span>, and <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flsqrt%29%29" class="RktValLink" data-pltdoc="x">flsqrt</a></span>&#8212;<wbr></wbr>that
+is, performing double-precision operations on values representable in
+single precision and then rounding the result to single precision&#8212;<wbr></wbr>is
+always the same as performing the corresponding single-precision
+operation [<a href="doc-bibliography.html#%28cite._.Roux14%29" data-pltdoc="x">Roux14</a>]. (For other operations, the IEEE
+floating-point specification does not make enough guarantees to say
+more about the interaction with <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flsingle%29%29" class="RktValLink" data-pltdoc="x">flsingle</a></span>.)</p><p class="SHistory">Added in version 7.8.0.7 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flsin))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flsin%29%29" class="RktValDef RktValLink" data-pltdoc="x">flsin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flcos))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flcos%29%29" class="RktValDef RktValLink" data-pltdoc="x">flcos</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._fltan))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fltan%29%29" class="RktValDef RktValLink" data-pltdoc="x">fltan</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flasin))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flasin%29%29" class="RktValDef RktValLink" data-pltdoc="x">flasin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flacos))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flacos%29%29" class="RktValDef RktValLink" data-pltdoc="x">flacos</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flatan))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flatan%29%29" class="RktValDef RktValLink" data-pltdoc="x">flatan</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._fllog))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fllog%29%29" class="RktValDef RktValLink" data-pltdoc="x">fllog</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flexp))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flexp%29%29" class="RktValDef RktValLink" data-pltdoc="x">flexp</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flsqrt))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flsqrt%29%29" class="RktValDef RktValLink" data-pltdoc="x">flsqrt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sin%29%29" class="RktValLink" data-pltdoc="x">sin</a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._cos%29%29" class="RktValLink" data-pltdoc="x">cos</a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._tan%29%29" class="RktValLink" data-pltdoc="x">tan</a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._asin%29%29" class="RktValLink" data-pltdoc="x">asin</a></span>,
+<span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._acos%29%29" class="RktValLink" data-pltdoc="x">acos</a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._atan%29%29" class="RktValLink" data-pltdoc="x">atan</a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._log%29%29" class="RktValLink" data-pltdoc="x">log</a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._exp%29%29" class="RktValLink" data-pltdoc="x">exp</a></span>, and
+<span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sqrt%29%29" class="RktValLink" data-pltdoc="x">sqrt</a></span>, but constrained to consume and produce
+<a href="numbers.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonums</span></a>. The result is <span class="RktVal">+nan.0</span> when a number outside
+the range <span class="RktVal"><span class="nobreak">-1</span>.0</span> to <span class="RktVal">1.0</span> is given to <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flasin%29%29" class="RktValLink" data-pltdoc="x">flasin</a></span> or
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flacos%29%29" class="RktValLink" data-pltdoc="x">flacos</a></span>, or when a negative number is given to <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fllog%29%29" class="RktValLink" data-pltdoc="x">fllog</a></span>
+or <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flsqrt%29%29" class="RktValLink" data-pltdoc="x">flsqrt</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flexpt))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flexpt%29%29" class="RktValDef RktValLink" data-pltdoc="x">flexpt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span>, but constrained to consume and produce
+<a href="numbers.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonums</span></a>.</div></p><p><div class="SIntrapara">Due to the result constraint, the results compared to <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span>
+differ in the following cases:
+<span class="refelem"><span class="refcolumn"><span class="refcontent">These special cases correspond to <span class="stt">pow</span> in C99 [<a href="doc-bibliography.html#%28cite._.C99%29" data-pltdoc="x">C99</a>].</span></span></span>
+</div><div class="SIntrapara"><ul class="compact"><li><p><span class="RktPn">(</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flexpt%29%29" class="RktValLink" data-pltdoc="x">flexpt</a></span><span class="stt"> </span><span class="RktVal"><span class="nobreak">-1</span>.0</span><span class="stt"> </span><span class="RktVal">+inf.0</span><span class="RktPn">)</span> &#8212;<wbr></wbr> <span class="RktVal">1.0</span></p></li><li><p><span class="RktPn">(</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flexpt%29%29" class="RktValLink" data-pltdoc="x">flexpt</a></span><span class="stt"> </span><span class="RktVar">a</span><span class="stt"> </span><span class="RktVal">+inf.0</span><span class="RktPn">)</span> where <span class="RktVar">a</span> is
+negative &#8212;<wbr></wbr> <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._abs%29%29" class="RktValLink" data-pltdoc="x">abs</a></span><span class="stt"> </span><span class="RktVar">a</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></p></li><li><p><span class="RktPn">(</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flexpt%29%29" class="RktValLink" data-pltdoc="x">flexpt</a></span><span class="stt"> </span><span class="RktVar">a</span><span class="stt"> </span><span class="RktVal"><span class="nobreak">-i</span>nf.0</span><span class="RktPn">)</span> where <span class="RktVar">a</span> is
+negative &#8212;<wbr></wbr> <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._abs%29%29" class="RktValLink" data-pltdoc="x">abs</a></span><span class="stt"> </span><span class="RktVar">a</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal"><span class="nobreak">-i</span>nf.0</span><span class="RktPn">)</span></p></li><li><p><div class="SIntrapara"><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="stt"> </span><span class="RktVal"><span class="nobreak">-i</span>nf.0</span><span class="stt"> </span><span class="RktVar">b</span><span class="RktPn">)</span> where <span class="RktVar">b</span> is a non-integer:
+</div><div class="SIntrapara"><ul class="compact"><li><p><span class="RktVar">b</span> is negative &#8212;<wbr></wbr> <span class="RktVal">0.0</span></p></li><li><p><span class="RktVar">b</span> is positive &#8212;<wbr></wbr> <span class="RktVal">+inf.0</span></p></li></ul></div></p></li><li><p><span class="RktPn">(</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flexpt%29%29" class="RktValLink" data-pltdoc="x">flexpt</a></span><span class="stt"> </span><span class="RktVar">a</span><span class="stt"> </span><span class="RktVar">b</span><span class="RktPn">)</span> where <span class="RktVar">a</span> is
+negative and <span class="RktVar">b</span> is not an integer &#8212;<wbr></wbr> <span class="RktVal">+nan.0</span></p></li></ul></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._-~3efl))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._-~3efl%29%29" class="RktValDef RktValLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>fl</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-~3einexact%29%29" class="RktValLink" data-pltdoc="x">exact-&gt;inexact</a></span>, but constrained to consume exact
+integers, so the result is always a <a href="numbers.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonum</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._fl-~3eexact-integer))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl-~3eexact-integer%29%29" class="RktValDef RktValLink" data-pltdoc="x">fl-&gt;exact-integer</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact-~3eexact%29%29" class="RktValLink" data-pltdoc="x">inexact-&gt;exact</a></span>, but constrained to consume an
+<a href="numbers.html#%28tech._integer%29" class="techoutside" data-pltdoc="x"><span class="techinside">integer</span></a> <a href="numbers.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonum</span></a>, so the result is always an exact
+integer.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._make-flrectangular))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._make-flrectangular%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-flrectangular</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._complex~3f%29%29" class="RktValLink" data-pltdoc="x">complex?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._real-part%29%29" class="RktValLink" data-pltdoc="x">real-part</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._imag-part%29%29" class="RktValLink" data-pltdoc="x">imag-part</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flreal-part))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flreal-part%29%29" class="RktValDef RktValLink" data-pltdoc="x">flreal-part</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">a</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._complex~3f%29%29" class="RktValLink" data-pltdoc="x">complex?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._real-part%29%29" class="RktValLink" data-pltdoc="x">real-part</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._imag-part%29%29" class="RktValLink" data-pltdoc="x">imag-part</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flimag-part))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flimag-part%29%29" class="RktValDef RktValLink" data-pltdoc="x">flimag-part</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">a</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._complex~3f%29%29" class="RktValLink" data-pltdoc="x">complex?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._real-part%29%29" class="RktValLink" data-pltdoc="x">real-part</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._imag-part%29%29" class="RktValLink" data-pltdoc="x">imag-part</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._make-rectangular%29%29" class="RktValLink" data-pltdoc="x">make-rectangular</a></span>, <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._real-part%29%29" class="RktValLink" data-pltdoc="x">real-part</a></span>, and
+<span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._imag-part%29%29" class="RktValLink" data-pltdoc="x">imag-part</a></span>, but both parts of the complex number must be
+inexact.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flrandom))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flrandom%29%29" class="RktValDef RktValLink" data-pltdoc="x">flrandom</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">rand-gen</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3c%2Fc%29%29" class="RktValLink" data-pltdoc="x">&lt;/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">rand-gen</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator~3f%29%29" class="RktValLink" data-pltdoc="x">pseudo-random-generator?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._random%29%29" class="RktValLink" data-pltdoc="x">random</a></span><span class="stt"> </span><span class="RktVar">rand-gen</span><span class="RktPn">)</span>.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;flvectors&quot;">4.3.3.2<tt>&nbsp;</tt><a name="(part._flvectors)"></a>Flonum Vectors</h5><p>A <a name="(tech._flvector)"></a><span style="font-style: italic">flvector</span> is like a <a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vector</span></a>, but it holds only
+inexact real numbers. This representation can be more compact, and
+unsafe operations on <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a>s (see
+<a href="unsafe.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/unsafe/ops</span></a>) can execute more efficiently than
+unsafe operations on <a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vectors</span></a> of inexact reals.</p><p>An f64vector as provided by <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=homogeneous-vectors.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">ffi/vector</span></a> stores the
+same kinds of values as a <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a>, but with extra
+indirections that make f64vectors more convenient for working with
+foreign libraries. The lack of indirections makes unsafe
+<a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a> access more efficient.</p><p>Two <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvectors</span></a> are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> if they have the same length,
+and if the values in corresponding slots of the <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvectors</span></a> are
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>.</p><p>A printed <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a> starts with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fl(</span><span class="hspace"></span></span>, optionally with
+a number between the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fl</span><span class="hspace"></span></span> and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span>. See <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a>
+    for information on <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>ing
+    flvectors and <a href="printing.html#%28part._print-vectors%29" data-pltdoc="x">Printing Vectors</a>
+    for information on <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>ing flvectors.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flvector~3f))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">flvector?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flvector))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector%29%29" class="RktValDef RktValLink" data-pltdoc="x">flvector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector~3f%29%29" class="RktValLink" data-pltdoc="x">flvector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a> containing the given inexact real numbers.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector%29%29" class="RktValLink" data-pltdoc="x">flvector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2.0</span><span class="hspace">&nbsp;</span><span class="RktVal">3.0</span><span class="hspace">&nbsp;</span><span class="RktVal">4.0</span><span class="hspace">&nbsp;</span><span class="RktVal">5.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(flvector 2.0 3.0 4.0 5.0)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._make-flvector))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._make-flvector%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-flvector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">size</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">x</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector~3f%29%29" class="RktValLink" data-pltdoc="x">flvector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">size</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0.0</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a> with <span class="RktVar">size</span> elements, where every
+slot in the <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a> is filled with <span class="RktVar">x</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._make-flvector%29%29" class="RktValLink" data-pltdoc="x">make-flvector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(flvector 3.0 3.0 3.0 3.0)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flvector-length))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">flvector-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector~3f%29%29" class="RktValLink" data-pltdoc="x">flvector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the length of <span class="RktVar">vec</span> (i.e., the number of slots in the
+<a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a>).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flvector-ref))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">flvector-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector~3f%29%29" class="RktValLink" data-pltdoc="x">flvector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the inexact real number in slot <span class="RktVar">pos</span> of
+<span class="RktVar">vec</span>. The first slot is position <span class="RktVal">0</span>, and the last slot
+is one less than <span class="RktPn">(</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector-length%29%29" class="RktValLink" data-pltdoc="x">flvector-length</a></span><span class="stt"> </span><span class="RktVar">vec</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flvector-set!))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">flvector-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector~3f%29%29" class="RktValLink" data-pltdoc="x">flvector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Sets the inexact real number in slot <span class="RktVar">pos</span> of <span class="RktVar">vec</span>. The
+first slot is position <span class="RktVal">0</span>, and the last slot is one less than
+<span class="RktPn">(</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector-length%29%29" class="RktValLink" data-pltdoc="x">flvector-length</a></span><span class="stt"> </span><span class="RktVar">vec</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._flvector-copy))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector-copy%29%29" class="RktValDef RktValLink" data-pltdoc="x">flvector-copy</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector~3f%29%29" class="RktValLink" data-pltdoc="x">flvector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector~3f%29%29" class="RktValLink" data-pltdoc="x">flvector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="RktValLink" data-pltdoc="x">vector-length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a fresh <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a> of size <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">end</span><span class="stt"> </span><span class="RktVar">start</span><span class="RktPn">)</span>, with all of the
+elements of <span class="RktVar">vec</span> from <span class="RktVar">start</span> (inclusive) to
+<span class="RktVar">end</span> (exclusive).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._in-flvector))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._in-flvector%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-flvector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">stop</span><span class="hspace">&nbsp;</span><span class="RktVar">step</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector~3f%29%29" class="RktValLink" data-pltdoc="x">flvector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">step</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence equivalent to <span class="RktVar">vec</span> when no optional
+arguments are supplied.</div></p><p>The optional arguments <span class="RktVar">start</span>, <span class="RktVar">stop</span>, and
+<span class="RktVar">step</span> are as in <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-vector%29%29" class="RktValLink" data-pltdoc="x">in-vector</a></span>.</p><p>A <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._in-flvector%29%29" class="RktValLink" data-pltdoc="x">in-flvector</a></span> application can provide better
+performance for <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a> iteration when it appears directly in a <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> clause.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/flonum..rkt)._for/flvector))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28form._%28%28lib._racket%2Fflonum..rkt%29._for%2Fflvector%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/flvector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-length</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/flonum..rkt)._for*/flvector))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28form._%28%28lib._racket%2Fflonum..rkt%29._for%2A%2Fflvector%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/flvector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-length</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">maybe-length</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:length</span><span class="hspace">&nbsp;</span><span class="RktVar">length-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:length</span><span class="hspace">&nbsp;</span><span class="RktVar">length-expr</span><span class="hspace">&nbsp;</span><span class="RktPn">#:fill</span><span class="hspace">&nbsp;</span><span class="RktVar">fill-expr</span></td></tr></table></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><blockquote class="SubFlow"><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">length-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">fill-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fvector%29%29" class="RktStxLink" data-pltdoc="x">for/vector</a></span> or <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fvector%29%29" class="RktStxLink" data-pltdoc="x">for*/vector</a></span>, but for
+<a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a>s. The default <span class="RktVar">fill-expr</span> produces <span class="RktVal">0.0</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._shared-flvector))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._shared-flvector%29%29" class="RktValDef RktValLink" data-pltdoc="x">shared-flvector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector~3f%29%29" class="RktValLink" data-pltdoc="x">flvector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a> containing the given inexact real numbers.
+For communication among <a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">places</span></a>, the new <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a> is
+allocated in the <a href="places.html#%28tech._shared._memory._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">shared memory space</span></a>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._shared-flvector%29%29" class="RktValLink" data-pltdoc="x">shared-flvector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2.0</span><span class="hspace">&nbsp;</span><span class="RktVal">3.0</span><span class="hspace">&nbsp;</span><span class="RktVal">4.0</span><span class="hspace">&nbsp;</span><span class="RktVal">5.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(flvector 2.0 3.0 4.0 5.0)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/flonum..rkt)._make-shared-flvector))"></a><span title="Provided from: racket/flonum | Package: base"><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._make-shared-flvector%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-shared-flvector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">size</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">x</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector~3f%29%29" class="RktValLink" data-pltdoc="x">flvector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">size</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0.0</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a> with <span class="RktVar">size</span> elements, where every
+slot in the <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a> is filled with <span class="RktVar">x</span>.
+For communication among <a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">places</span></a>, the new <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a> is
+allocated in the <a href="places.html#%28tech._shared._memory._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">shared memory space</span></a>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._make-shared-flvector%29%29" class="RktValLink" data-pltdoc="x">make-shared-flvector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(flvector 3.0 3.0 3.0 3.0)</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="generic-numbers.html" title="backward to &quot;4.3.2 Generic Numerics&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="numbers.html" title="up to &quot;4.3 Numbers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="fixnums.html" title="forward to &quot;4.3.4 Fixnums&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/for.html b/clones/docs.racket-lang.org/reference/for.html
new file mode 100644
index 00000000..27385b75
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/for.html
@@ -0,0 +1,259 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.18&nbsp;Iterations and Comprehensions: for, for/list, ...</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewselflink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>3.18&nbsp;</td><td><a href="for.html" class="tocviewselflink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.18.1&nbsp;</td><td><a href="for.html#%28part._.Iteration_and_.Comprehension_.Forms%29" class="tocviewlink" data-pltdoc="x">Iteration and Comprehension Forms</a></td></tr><tr><td align="right">3.18.2&nbsp;</td><td><a href="for.html#%28part._.Deriving_.New_.Iteration_.Forms%29" class="tocviewlink" data-pltdoc="x">Deriving New Iteration Forms</a></td></tr><tr><td align="right">3.18.3&nbsp;</td><td><a href="for.html#%28part._.Do_.Loops%29" class="tocviewlink" data-pltdoc="x">Do Loops</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">3.18.1<tt>&nbsp;</tt></span><a href="for.html#%28part._.Iteration_and_.Comprehension_.Forms%29" class="tocsubseclink" data-pltdoc="x">Iteration and Comprehension Forms</a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>vector</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fhash%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>hash</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fhasheq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>hasheq</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fhasheqv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>hasheqv</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fhashalw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>hashalw</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fand%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>and</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2For%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>or</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fsum%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>sum</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fproduct%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>product</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flists%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>lists</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffirst%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>first</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flast%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>last</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffold%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>fold</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffoldr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>foldr</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Flist%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>list</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Flists%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>lists</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fvector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>vector</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fhash%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>hash</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fhasheq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>hasheq</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fhasheqv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>hasheqv</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fhashalw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>hashalw</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fand%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>and</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2For%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>or</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fsum%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>sum</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fproduct%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>product</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Ffirst%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>first</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Flast%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>last</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Ffold%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>fold</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Ffoldr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>foldr</span></span></a></td></tr><tr><td><span class="tocsublinknumber">3.18.2<tt>&nbsp;</tt></span><a href="for.html#%28part._.Deriving_.New_.Iteration_.Forms%29" class="tocsubseclink" data-pltdoc="x">Deriving New Iteration Forms</a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffold%2Fderived%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>fold/<span class="mywbr"> &nbsp;</span>derived</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Ffold%2Fderived%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>fold/<span class="mywbr"> &nbsp;</span>derived</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffoldr%2Fderived%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>foldr/<span class="mywbr"> &nbsp;</span>derived</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Ffoldr%2Fderived%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>foldr/<span class="mywbr"> &nbsp;</span>derived</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-sequence-syntax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>sequence-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~3ado-in%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">:<span class="mywbr"> &nbsp;</span>do-<wbr></wbr>in</span></span></a></td></tr><tr><td><a href="for.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-clause-syntax-protect%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">for-<wbr></wbr>clause-<wbr></wbr>syntax-<wbr></wbr>protect</span></span></a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-splicing-for-clause-syntax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>splicing-<wbr></wbr>for-<wbr></wbr>clause-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><span class="tocsublinknumber">3.18.3<tt>&nbsp;</tt></span><a href="for.html#%28part._.Do_.Loops%29" class="tocsubseclink" data-pltdoc="x">Do Loops</a></td></tr><tr><td><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._do%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">do</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="set_.html" title="backward to &quot;3.17 Assignment: set! and set!-values&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="wcm.html" title="forward to &quot;3.19 Continuation Marks: with-continuation-mark&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;for&quot;">3.18<tt>&nbsp;</tt><a name="(part._for)"></a>Iterations and Comprehensions: <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span>, <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span>, ...</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=for.html&amp;version=8.6" class="Sq" data-pltdoc="x">Iterations and Comprehensions</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces iterations and comprehensions.</p></blockquote></blockquote></blockquote><p>The <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> iteration forms are based on SRFI-42
+[<a href="doc-bibliography.html#%28cite._.S.R.F.I-42%29" data-pltdoc="x">SRFI-42</a>].</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Iteration_and_Comprehension_Forms&quot;">3.18.1<tt>&nbsp;</tt><a name="(part._.Iteration_and_.Comprehension_.Forms)"></a>Iteration and Comprehension Forms</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">for-clause</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">seq-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">seq-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktVar">guard-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:unless</span><span class="hspace">&nbsp;</span><span class="RktVar">guard-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:do</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">do-body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">break-clause</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:splice</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">splicing-id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">form</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">break-clause</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:break</span><span class="hspace">&nbsp;</span><span class="RktVar">guard-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:final</span><span class="hspace">&nbsp;</span><span class="RktVar">guard-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">body-or-break</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">body</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">break-clause</span></td></tr></table></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">seq-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Iteratively evaluates <span class="RktVar">body</span>s. The <span class="RktVar">for-clause</span>s
+introduce bindings whose scope includes <span class="RktVar">body</span> and that
+determine the number of times that <span class="RktVar">body</span> is evaluated.
+A <span class="RktVar">break-clause</span> either among the <span class="RktVar">for-clause</span>s
+or <span class="RktVar">body</span>s stops further iteration.</div></p><p>In the simple case, each <span class="RktVar">for-clause</span> has one of its first two
+forms, where <span class="RktPn">[</span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">seq-expr</span><span class="RktPn">]</span> is a shorthand for <span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">seq-expr</span><span class="RktPn">]</span>.  In this simple case, the <span class="RktVar">seq-expr</span>s are evaluated
+left-to-right, and each must produce a sequence value (see
+<a href="sequences.html" data-pltdoc="x">Sequences</a>).</p><p>The <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> form iterates by drawing an element from each
+sequence; if any sequence is empty, then the iteration stops, and
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a> is the result of the <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> expression. Otherwise
+a location is created for each <span class="RktVar">id</span> to hold the values of each
+element; the sequence produced by a <span class="RktVar">seq-expr</span> must return as
+many values for each iteration as corresponding <span class="RktVar">id</span>s.</p><p>The <span class="RktVar">id</span>s are then bound in the <span class="RktVar">body</span>, which is
+evaluated, and whose results are ignored. Iteration continues with the
+next element in each sequence and with fresh locations for each
+<span class="RktVar">id</span>.</p><p>A <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> form with zero <span class="RktVar">for-clause</span>s is equivalent to a
+single <span class="RktVar">for-clause</span> that binds an unreferenced <span class="RktVar">id</span> to
+a sequence containing a single element. All of the <span class="RktVar">id</span>s must
+be distinct according to <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._bound-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">bound-identifier=?</a></span>.</p><p>If any <span class="RktVar">for-clause</span> has the form <span class="RktPn">#:when</span><span class="stt"> </span><span class="RktVar">guard-expr</span>,
+then only the preceding clauses (containing no <span class="RktPn">#:when</span>, <span class="RktPn">#:unless</span>, or <span class="RktPn">#:do</span>)
+determine iteration as above, and the <span class="RktVar">body</span> is effectively
+wrapped as</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxLink" data-pltdoc="x">when</a></span><span class="hspace">&nbsp;</span><span class="RktVar">guard-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-patterns.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._......%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...+</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>using the remaining <span class="RktVar">for-clause</span>s. A <span class="RktVar">for-clause</span> of
+the form <span class="RktPn">#:unless</span><span class="stt"> </span><span class="RktVar">guard-expr</span> corresponds to the same transformation
+with <span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._unless%29%29" class="RktStxLink" data-pltdoc="x">unless</a></span> in place of <span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxLink" data-pltdoc="x">when</a></span>. A <span class="RktVar">for-clause</span> of
+the form <span class="RktPn">#:do</span><span class="stt"> </span><span class="RktPn">[</span><span class="RktVar">do-body</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">]</span> similarly creates nesting and
+corresponds to</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">do-body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-patterns.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._......%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...+</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>where the <span class="RktVar">do-body</span> forms may introduce definitions that are
+visible in the remaining <span class="RktVar">for-clause</span>s.</p><p>A <span class="RktPn">#:break</span><span class="stt"> </span><span class="RktVar">guard-expr</span> clause is similar to a
+<span class="RktPn">#:unless</span><span class="stt"> </span><span class="RktVar">guard-expr</span> clause, but when <span class="RktPn">#:break</span>
+avoids evaluation of the <span class="RktVar">body</span>s, it also effectively ends all
+sequences within the <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> form.  A <span class="RktPn">#:final</span><span class="stt"> </span><span class="RktVar">guard-expr</span> clause is similar to <span class="RktPn">#:break</span><span class="stt"> </span><span class="RktVar">guard-expr</span>, but
+instead of immediately ending sequences and skipping the
+<span class="RktVar">body</span>s, it allows at most one more element from each later
+sequence and at most one more evaluation of the following
+<span class="RktVar">body</span>s. Among the <span class="RktVar">body</span>s, besides stopping the
+iteration and preventing later <span class="RktVar">body</span> evaluations, a
+<span class="RktPn">#:break</span><span class="stt"> </span><span class="RktVar">guard-expr</span> or <span class="RktPn">#:final</span><span class="stt"> </span><span class="RktVar">guard-expr</span>
+clause starts a new internal-definition context.</p><p>A <span class="RktPn">#:splice</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">splicing-id</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">form</span><span class="RktPn">)</span> clause is replaced by the
+sequence of forms that are produced by expanding <span class="RktPn">(</span><span class="RktVar">splicing-id</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">form</span><span class="RktPn">)</span>, where <span class="RktVar">splicing-id</span> is bound using
+<span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-splicing-for-clause-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-splicing-for-clause-syntax</a></span>. The binding context of
+that expansion includes previous binding from any clause preceding
+both the <span class="RktPn">#:splice</span> form and a <span class="RktPn">#:when</span>,
+<span class="RktPn">#:unless</span>, <span class="RktPn">#:do</span>, <span class="RktPn">#:break</span>, or
+<span class="RktPn">#:final</span> form. The result of a <span class="RktPn">#:splice</span> expansion can
+include more <span class="RktPn">#:splice</span> forms to further interleave clause
+binding and expansion. Support for <span class="RktPn">#:splicing</span> clauses is
+intended less for direct use in source <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> forms than for
+building new forms that expand to <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span>.</p><p>In the case of <a href="pairs.html#%28tech._list%29" class="techoutside" data-pltdoc="x"><span class="techinside">list</span></a> and <a href="streams.html#%28tech._stream%29" class="techoutside" data-pltdoc="x"><span class="techinside">stream</span></a> sequences, the
+<span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> form itself does not keep each element reachable. If a
+list or stream produced by a <span class="RktVar">seq-expr</span> is otherwise
+unreachable, and if the <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> body can no longer reference an
+<span class="RktVar">id</span> for a list element, then the element is subject to
+<a href="eval-model.html#%28tech._garbage._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">garbage collection</span></a>. The <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-do-sequence%29%29" class="RktValLink" data-pltdoc="x">make-do-sequence</a></span> sequence
+constructor supports additional sequences that behave like lists and
+streams in this way.</p><p>If a <span class="RktVar">seq-expr</span> is a quoted literal list, vector, exact integer,
+string, byte string, immutable hash, or expands to such a literal,
+then it may be treated as if a sequence transformer such as
+<span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="RktValLink" data-pltdoc="x">in-list</a></span> was used, unless the <span class="RktVar">seq-expr</span> has a true
+value for the <a name="(idx._(gentag._110._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">for:no-implicit-optimization</span> syntax
+property; in most cases this improves performance.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">j</span><span class="hspace">&nbsp;</span><span class="RktVal">"abc"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._odd~3f%29%29" class="RktValLink" data-pltdoc="x">odd?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">j</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">(1 a #t)(1 a #f)(3 c #t)(3 c #f)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:do</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">neg-i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">j</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">neg-i</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">j</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">(-1)(0)(1)(-2)(0)(2)(-3)(0)(3)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">j</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">20</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">j</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">(a 1)(b 20)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">j</span><span class="hspace">&nbsp;</span><span class="RktVal">"abc"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:break</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._odd~3f%29%29" class="RktValLink" data-pltdoc="x">odd?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">j</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">(1 a #t)(1 a #f)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">j</span><span class="hspace">&nbsp;</span><span class="RktVal">"abc"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:final</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._odd~3f%29%29" class="RktValLink" data-pltdoc="x">odd?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">j</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">(1 a #t)(1 a #f)(2 b #t)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">j</span><span class="hspace">&nbsp;</span><span class="RktVal">"abc"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:break</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._odd~3f%29%29" class="RktValLink" data-pltdoc="x">odd?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">j</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">(1 a #t)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"here"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">here</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"doesn't get here"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.7.0.4 of package <span class="stt">base</span>: Added support for the optional second result.<br/>Changed in version 7.8.0.11: Added support for implicit optimization.<br/>Changed in version 8.4.0.2: Added <span class="RktPn">#:do</span>.<br/>Changed in version 8.4.0.3: Added <span class="RktPn">#:splice</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for/list))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/list</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"> Iterates like
+<span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span>, but that the last expression in the <span class="RktVar">body</span>s must
+produce a single value, and the result of the <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span>
+expression is a list of the results in order.
+When evaluation of a <span class="RktVar">body</span> is skipped due to a <span class="RktPn">#:when</span>
+or <span class="RktPn">#:unless</span> clause, the result list includes no corresponding
+element.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">j</span><span class="hspace">&nbsp;</span><span class="RktVal">"abc"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._odd~3f%29%29" class="RktValLink" data-pltdoc="x">odd?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">j</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'((1 #\a #t) (1 #\a #f) (3 #\c #t) (3 #\c #f))</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">j</span><span class="hspace">&nbsp;</span><span class="RktVal">"abc"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:break</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._odd~3f%29%29" class="RktValLink" data-pltdoc="x">odd?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">j</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'((1 #\a #t) (1 #\a #f))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(any)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"doesn't get here"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for/vector))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fvector%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/vector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-length</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">maybe-length</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:length</span><span class="hspace">&nbsp;</span><span class="RktVar">length-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:length</span><span class="hspace">&nbsp;</span><span class="RktVar">length-expr</span><span class="hspace">&nbsp;</span><span class="RktPn">#:fill</span><span class="hspace">&nbsp;</span><span class="RktVar">fill-expr</span></td></tr></table></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">length-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Iterates like <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span>, but results are accumulated into
+a vector instead of a list.</div></p><p>If the optional <span class="RktPn">#:length</span> clause is specified, the result of
+<span class="RktVar">length-expr</span> determines the length of the result vector.  In
+that case, the iteration can be performed more efficiently, and it
+terminates when the vector is full or the requested number of
+iterations have been performed, whichever comes first. If
+<span class="RktVar">length-expr</span> specifies a length longer than the number of
+iterations, then the remaining slots of the vector are initialized to
+the value of <span class="RktVar">fill-expr</span>, which defaults to <span class="RktVal">0</span> (i.e.,
+the default argument of <span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._make-vector%29%29" class="RktValLink" data-pltdoc="x">make-vector</a></span>).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fvector%29%29" class="RktStxLink" data-pltdoc="x">for/vector</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._number-~3estring%29%29" class="RktValLink" data-pltdoc="x">number-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#("1" "2" "3")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fvector%29%29" class="RktStxLink" data-pltdoc="x">for/vector</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:length</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._number-~3estring%29%29" class="RktValLink" data-pltdoc="x">number-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#("1" "2")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fvector%29%29" class="RktStxLink" data-pltdoc="x">for/vector</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:length</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._number-~3estring%29%29" class="RktValLink" data-pltdoc="x">number-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#("1" "2" "3" 0)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fvector%29%29" class="RktStxLink" data-pltdoc="x">for/vector</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:length</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktPn">#:fill</span><span class="hspace">&nbsp;</span><span class="RktVal">"?"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._number-~3estring%29%29" class="RktValLink" data-pltdoc="x">number-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#("1" "2" "3" "?")</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fvector%29%29" class="RktStxLink" data-pltdoc="x">for/vector</a></span> form may allocate a vector and mutate it after
+each iteration of <span class="RktVar">body</span>, which means that capturing a
+continuation during <span class="RktVar">body</span> and applying it multiple times may
+mutate a shared vector.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for/hash))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fhash%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/hash</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for/hasheq))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fhasheq%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/hasheq</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for/hasheqv))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fhasheqv%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/hasheqv</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for/hashalw))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fhashalw%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/hashalw</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span>, but the result is an immutable <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash
+table</span></a>; <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fhash%29%29" class="RktStxLink" data-pltdoc="x">for/hash</a></span> creates a table using <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to
+distinguish keys, <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fhasheq%29%29" class="RktStxLink" data-pltdoc="x">for/hasheq</a></span> produces a table using
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>, <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fhasheqv%29%29" class="RktStxLink" data-pltdoc="x">for/hasheqv</a></span> produces a table using
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, and <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fhashalw%29%29" class="RktStxLink" data-pltdoc="x">for/hashalw</a></span> produces a table using
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>.
+The last expression in the <span class="RktVar">body</span>s must return
+two values: a key and a value to extend the hash table accumulated by
+the iteration.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fhash%29%29" class="RktStxLink" data-pltdoc="x">for/hash</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._number-~3estring%29%29" class="RktValLink" data-pltdoc="x">number-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'#hash((1 . "1") (2 . "2") (3 . "3"))</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 8.5.0.3 of package <span class="stt">base</span>: Added the <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fhashalw%29%29" class="RktStxLink" data-pltdoc="x">for/hashalw</a></span> form.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for/and))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fand%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/and</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"> Iterates like
+<span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span>, but when last expression of <span class="RktVar">body</span> produces
+<span class="RktVal">#f</span>, then iteration terminates, and the result of the
+<span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fand%29%29" class="RktStxLink" data-pltdoc="x">for/and</a></span> expression is <span class="RktVal">#f</span>. If the <span class="RktVar">body</span>
+is never evaluated, then the result of the <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fand%29%29" class="RktStxLink" data-pltdoc="x">for/and</a></span>
+expression is <span class="RktVal">#t</span>. Otherwise, the result is the (single)
+result from the last evaluation of <span class="RktVar">body</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fand%29%29" class="RktStxLink" data-pltdoc="x">for/and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">"x"</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fand%29%29" class="RktStxLink" data-pltdoc="x">for/and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fand%29%29" class="RktStxLink" data-pltdoc="x">for/and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:break</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fand%29%29" class="RktStxLink" data-pltdoc="x">for/and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"doesn't get here"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for/or))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2For%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/or</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"> Iterates like
+<span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span>, but when last expression of <span class="RktVar">body</span> produces
+a value other than <span class="RktVal">#f</span>, then iteration terminates, and
+the result of the <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2For%29%29" class="RktStxLink" data-pltdoc="x">for/or</a></span> expression is the same
+(single) value. If the <span class="RktVar">body</span> is never evaluated, then the
+result of the <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2For%29%29" class="RktStxLink" data-pltdoc="x">for/or</a></span> expression is
+<span class="RktVal">#f</span>. Otherwise, the result is <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2For%29%29" class="RktStxLink" data-pltdoc="x">for/or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">"x"</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2For%29%29" class="RktStxLink" data-pltdoc="x">for/or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2For%29%29" class="RktStxLink" data-pltdoc="x">for/or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"doesn't get here"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for/sum))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fsum%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/sum</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Iterates like <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span>, but each result of the last <span class="RktVar">body</span>
+is accumulated into a result with <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fsum%29%29" class="RktStxLink" data-pltdoc="x">for/sum</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for/product))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fproduct%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/product</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Iterates like <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span>, but each result of the last <span class="RktVar">body</span>
+is accumulated into a result with <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fproduct%29%29" class="RktStxLink" data-pltdoc="x">for/product</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">24</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for/lists))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flists%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/lists</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-result</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">maybe-result</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:result</span><span class="hspace">&nbsp;</span><span class="RktVar">result-expr</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span>, but the last <span class="RktVar">body</span> expression
+should produce as many values as given <span class="RktVar">id</span>s.
+The <span class="RktVar">id</span>s are bound to
+the reversed lists accumulated so far in the <span class="RktVar">for-clause</span>s and
+<span class="RktVar">body</span>s.</div></p><p>If a <span class="RktVar">result-expr</span> is provided, it is used as with <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffold%29%29" class="RktStxLink" data-pltdoc="x">for/fold</a></span>
+when iteration terminates;
+otherwise, the result is as many lists as supplied <span class="RktVar">id</span>s.</p><p>The scope of <span class="RktVar">id</span> bindings is the same as for accumulator
+identifiers in <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffold%29%29" class="RktStxLink" data-pltdoc="x">for/fold</a></span>. Mutating a <span class="RktVar">id</span> affects the
+accumulated lists, and mutating it in a way that produces a non-list
+can cause a final <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._reverse%29%29" class="RktValLink" data-pltdoc="x">reverse</a></span> for each <span class="RktVar">id</span> to fail.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flists%29%29" class="RktStxLink" data-pltdoc="x">for/lists</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">l1</span><span class="hspace">&nbsp;</span><span class="RktSym">l2</span><span class="hspace">&nbsp;</span><span class="RktSym">l3</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">j</span><span class="hspace">&nbsp;</span><span class="RktVal">"abc"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._odd~3f%29%29" class="RktValLink" data-pltdoc="x">odd?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">j</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">'(1 1 3 3)</span></p></td></tr><tr><td><p><span class="RktRes">'(#\a #\a #\c #\c)</span></p></td></tr><tr><td><p><span class="RktRes">'(#t #f #t #f)</span></p></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flists%29%29" class="RktStxLink" data-pltdoc="x">for/lists</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">acc</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">tvp</span><span class="hspace">&nbsp;</span><span class="RktVal">tofu</span><span class="hspace">&nbsp;</span><span class="RktVal">seitan</span><span class="hspace">&nbsp;</span><span class="RktVal">tvp</span><span class="hspace">&nbsp;</span><span class="RktVal">tofu</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:unless</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">acc</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(tvp tofu seitan)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flists%29%29" class="RktStxLink" data-pltdoc="x">for/lists</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">firsts</span><span class="hspace">&nbsp;</span><span class="RktSym">seconds</span><span class="hspace">&nbsp;</span><span class="RktPn">#:result</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">firsts</span><span class="hspace">&nbsp;</span><span class="RktSym">seconds</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">pr</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">6</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pr</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'((1 3 5) (2 4 6))</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.1.0.2 of package <span class="stt">base</span>: Added the <span class="RktPn">#:result</span> form.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for/first))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffirst%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/first</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"> Iterates like
+<span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span>, but after <span class="RktVar">body</span> is evaluated the first
+time, then the iteration terminates, and the <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffirst%29%29" class="RktStxLink" data-pltdoc="x">for/first</a></span>
+result is the (single) result of <span class="RktVar">body</span>. If the
+<span class="RktVar">body</span> is never evaluated, then the result of the
+<span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffirst%29%29" class="RktStxLink" data-pltdoc="x">for/first</a></span> expression is <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffirst%29%29" class="RktStxLink" data-pltdoc="x">for/first</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">"x"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._number-~3estring%29%29" class="RktValLink" data-pltdoc="x">number-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"2"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffirst%29%29" class="RktStxLink" data-pltdoc="x">for/first</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"doesn't get here"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for/last))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flast%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/last</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"> Iterates like
+<span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span>, but the <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flast%29%29" class="RktStxLink" data-pltdoc="x">for/last</a></span> result is the (single)
+result of the last evaluation of <span class="RktVar">body</span>. If the
+<span class="RktVar">body</span> is never evaluated, then the result of the
+<span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flast%29%29" class="RktStxLink" data-pltdoc="x">for/last</a></span> expression is <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flast%29%29" class="RktStxLink" data-pltdoc="x">for/last</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._number-~3estring%29%29" class="RktValLink" data-pltdoc="x">number-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"4"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flast%29%29" class="RktStxLink" data-pltdoc="x">for/last</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"doesn't get here"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for/fold))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffold%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/fold</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">accum-id</span><span class="hspace">&nbsp;</span><span class="RktVar">init-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-result</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">maybe-result</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:result</span><span class="hspace">&nbsp;</span><span class="RktVar">result-expr</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Iterates like <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span>. Before iteration starts, the
+<span class="RktVar">init-expr</span>s are evaluated to produce initial accumulator
+values. At the start of each iteration, a location is generated
+for each <span class="RktVar">accum-id</span>, and the corresponding current accumulator
+value is placed into the location. The last expression in
+<span class="RktVar">body</span> must produce as many values as <span class="RktVar">accum-id</span>s, and
+those values become the current accumulator values. When iteration
+terminates, if a <span class="RktVar">result-expr</span> is provided then the result of the
+ <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffold%29%29" class="RktStxLink" data-pltdoc="x">for/fold</a></span> is the result of evaluating <span class="RktVar">result-expr</span>
+ (with <span class="RktVar">accum-id</span>s in scope and bound to their final values),
+ otherwise the results of the <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffold%29%29" class="RktStxLink" data-pltdoc="x">for/fold</a></span> expression are the
+ accumulator values.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffold%29%29" class="RktStxLink" data-pltdoc="x">for/fold</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">sum</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">rev-roots</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sum</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sqrt%29%29" class="RktValLink" data-pltdoc="x">sqrt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">rev-roots</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">10</span></p></td></tr><tr><td><p><span class="RktRes">'(2 1.7320508075688772 1.4142135623730951 1)</span></p></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffold%29%29" class="RktStxLink" data-pltdoc="x">for/fold</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">acc</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">seen</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash%29%29" class="RktValLink" data-pltdoc="x">hash</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:result</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._reverse%29%29" class="RktValLink" data-pltdoc="x">reverse</a></span><span class="hspace">&nbsp;</span><span class="RktSym">acc</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="RktValLink" data-pltdoc="x">in-list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">seen</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">acc</span><span class="hspace">&nbsp;</span><span class="RktSym">seen</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">acc</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%29%29" class="RktValLink" data-pltdoc="x">hash-set</a></span><span class="hspace">&nbsp;</span><span class="RktSym">seen</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(0 1 2 3 4)</span></p></td></tr></table></blockquote></div></p><p>The binding and evaluation order of <span class="RktVar">accum-id</span>s and
+<span class="RktVar">init-expr</span>s do not completely follow the textual,
+left-to-right order relative to the <span class="RktVar">for-clause</span>s. Instead, the
+sequence expressions in <span class="RktVar">for-clause</span>s that determine the
+outermost iteration are evaluated first, then the <span class="RktVar">init-expr</span>s
+are evaluated and the <span class="RktVar">accum-id</span>s are bound, and finally the
+outermost iteration&rsquo;s identifiers are bound. One consequence is that
+the <span class="RktVar">accum-id</span>s are not bound in <span class="RktVar">for-clause</span>s for the
+outermost initialization. At the same time, when a <span class="RktVar">accum-id</span>
+is used as a <span class="RktVar">for-clause</span> binding for the outermost iteration,
+the <span class="RktVar">for-clause</span> binding shadows the <span class="RktVar">accum-id</span> binding
+in the loop body (which is what you would expect syntactically).
+A fresh variable for each <span class="RktVar">accum-id</span> (at a
+fresh location) is bound in each nested iteration that is created by a
+later group for <span class="RktVar">for-clause</span>s (after a <span class="RktPn">#:when</span> or
+<span class="RktPn">#:unless</span>, for example).</p><p class="SHistory">Changed in version 6.11.0.1 of package <span class="stt">base</span>: Added the <span class="RktPn">#:result</span> form.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for/foldr))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffoldr%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/foldr</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">accum-id</span><span class="hspace">&nbsp;</span><span class="RktVar">init-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">accum-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">accum-option</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:result</span><span class="hspace">&nbsp;</span><span class="RktVar">result-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:delay</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:delay-as</span><span class="hspace">&nbsp;</span><span class="RktVar">delayed-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:delay-with</span><span class="hspace">&nbsp;</span><span class="RktVar">delayer-id</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffold%29%29" class="RktStxLink" data-pltdoc="x">for/fold</a></span>, but analogous to <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldr%29%29" class="RktValLink" data-pltdoc="x">foldr</a></span> rather than
+<span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldl%29%29" class="RktValLink" data-pltdoc="x">foldl</a></span>: the given sequences are still iterated in the same order, but
+the loop body is evaluated in reverse order. Evaluation of a <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffoldr%29%29" class="RktStxLink" data-pltdoc="x">for/foldr</a></span>
+expression uses space proportional to the number of iterations it performs, and
+all elements produced by the given sequences are retained until backwards
+evaluation of the loop body begins (assuming the element is, in fact,
+referenced in the body).</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">in-printing</span><span class="hspace">&nbsp;</span><span class="RktSym">seq</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-map%29%29" class="RktValLink" data-pltdoc="x">sequence-map</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._println%29%29" class="RktValLink" data-pltdoc="x">println</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">seq</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffoldr%29%29" class="RktStxLink" data-pltdoc="x">for/foldr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">acc</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">in-printing</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._println%29%29" class="RktValLink" data-pltdoc="x">println</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktSym">acc</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">1</span></p></td></tr><tr><td><p><span class="RktOut">2</span></p></td></tr><tr><td><p><span class="RktOut">3</span></p></td></tr><tr><td><p><span class="RktOut">3</span></p></td></tr><tr><td><p><span class="RktOut">2</span></p></td></tr><tr><td><p><span class="RktOut">1</span></p></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(1 2 3)</span></p></td></tr></table></blockquote></div></p><p>Furthermore, unlike <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffold%29%29" class="RktStxLink" data-pltdoc="x">for/fold</a></span>, the <span class="RktVar">accum-id</span>s are not bound
+within <span class="RktVar">guard-expr</span>s or <span class="RktVar">body-or-break</span> forms that appear before
+a <span class="RktVar">break-clause</span>.</p><p>While the aforementioned limitations make <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffoldr%29%29" class="RktStxLink" data-pltdoc="x">for/foldr</a></span> less generally
+useful than <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffold%29%29" class="RktStxLink" data-pltdoc="x">for/fold</a></span>, <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffoldr%29%29" class="RktStxLink" data-pltdoc="x">for/foldr</a></span> provides the additional
+capability to iterate lazily via the <span class="RktPn">#:delay</span>, <span class="RktPn">#:delay-as</span>, and
+<span class="RktPn">#:delay-with</span> options, which can mitigate many of <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffoldr%29%29" class="RktStxLink" data-pltdoc="x">for/foldr</a></span>&rsquo;s
+disadvantages. If at least one such option is specified, the loop body is given
+explicit control over when iteration continues: by default, each
+<span class="RktVar">accum-id</span> is bound to a <a href="Delayed_Evaluation.html#%28tech._promise%29" class="techoutside" data-pltdoc="x"><span class="techinside">promise</span></a> that, when forced, produces the
+<span class="RktVar">accum-id</span>&rsquo;s current value.</p><p>In this mode, iteration does not continue until one such promise is forced,
+which triggers any additional iteration necessary to produce a value. If the
+loop body is lazy in its <span class="RktVar">accum-id</span>s&#8212;<wbr></wbr>that is, it returns a value
+without forcing any of them&#8212;<wbr></wbr>then the loop (or any of its iterations) will
+produce a value before iteration has completely finished. If a reference to at
+least one such promise is retained, then forcing it will resume iteration from
+the point at which it was suspended, even if control has left the dynamic extent
+of the loop body.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffoldr%29%29" class="RktStxLink" data-pltdoc="x">for/foldr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">acc</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">#:delay</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"--&gt; ~v\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin0%29%29" class="RktStxLink" data-pltdoc="x">begin0</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span><span class="hspace">&nbsp;</span><span class="RktSym">acc</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"&lt;-- ~v\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">--&gt; 1</span></p></td></tr><tr><td><p><span class="RktOut">--&gt; 2</span></p></td></tr><tr><td><p><span class="RktOut">--&gt; 3</span></p></td></tr><tr><td><p><span class="RktOut">&lt;-- 3</span></p></td></tr><tr><td><p><span class="RktOut">&lt;-- 2</span></p></td></tr><tr><td><p><span class="RktOut">&lt;-- 1</span></p></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(1 2 3)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">resume</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffoldr%29%29" class="RktStxLink" data-pltdoc="x">for/foldr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">acc</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">#:delay</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"--&gt; ~v\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin0%29%29" class="RktStxLink" data-pltdoc="x">begin0</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span><span class="hspace">&nbsp;</span><span class="RktSym">acc</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">acc</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span><span class="hspace">&nbsp;</span><span class="RktSym">acc</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"&lt;-- ~v\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">--&gt; 1</span></p></td></tr><tr><td><p><span class="RktOut">--&gt; 2</span></p></td></tr><tr><td><p><span class="RktOut">&lt;-- 2</span></p></td></tr><tr><td><p><span class="RktOut">&lt;-- 1</span></p></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span><span class="hspace">&nbsp;</span><span class="RktSym">resume</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">--&gt; 3</span></p></td></tr><tr><td><p><span class="RktOut">--&gt; 4</span></p></td></tr><tr><td><p><span class="RktOut">&lt;-- 4</span></p></td></tr><tr><td><p><span class="RktOut">&lt;-- 3</span></p></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(3 4)</span></p></td></tr></table></blockquote></div></p><p>This extra control over iteration order allows <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffoldr%29%29" class="RktStxLink" data-pltdoc="x">for/foldr</a></span> to both
+consume and construct infinite sequences, so long as it is at least sometimes
+lazy in its accumulators.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span>See also <span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._for%2Fstream%29%29" class="RktStxLink" data-pltdoc="x">for/stream</a></span> for a more convenient (albeit less flexible) way
+to lazily transform infinite sequences. (Internally, <span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._for%2Fstream%29%29" class="RktStxLink" data-pltdoc="x">for/stream</a></span> is
+defined in terms of <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffoldr%29%29" class="RktStxLink" data-pltdoc="x">for/foldr</a></span>.)</p></blockquote></blockquote></blockquote><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">squares</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffoldr%29%29" class="RktStxLink" data-pltdoc="x">for/foldr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._empty-stream%29%29" class="RktValLink" data-pltdoc="x">empty-stream</a></span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">#:delay</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-naturals%29%29" class="RktValLink" data-pltdoc="x">in-naturals</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream-cons%29%29" class="RktStxLink" data-pltdoc="x">stream-cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-~3elist%29%29" class="RktValLink" data-pltdoc="x">stream-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-take%29%29" class="RktValLink" data-pltdoc="x">stream-take</a></span><span class="hspace">&nbsp;</span><span class="RktSym">squares</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(0 1 4 9 16 25 36 49 64 81)</span></p></td></tr></table></blockquote></div></p><p>The suspension introduced by the <span class="RktPn">#:delay</span> option does not ordinarily
+affect the loop&rsquo;s eventual return value, but if <span class="RktPn">#:delay</span> and
+<span class="RktPn">#:result</span> are combined, the <span class="RktVar">accum-id</span>s will be delayed in the
+scope of the <span class="RktVar">result-expr</span> in the same way they are delayed within the
+loop body. This can be used to introduce an additional layer of suspension
+around the evaluation of the entire loop, if desired.</p><p><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">evaluated-yet?</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffoldr%29%29" class="RktStxLink" data-pltdoc="x">for/foldr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">acc</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">evaluated-yet?</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">#:delay</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span><span class="hspace">&nbsp;</span><span class="RktSym">acc</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">evaluated-yet?</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">evaluated-yet?</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">start</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffoldr%29%29" class="RktStxLink" data-pltdoc="x">for/foldr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">acc</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">evaluated-yet?</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">#:delay</span><span class="hspace">&nbsp;</span><span class="RktPn">#:result</span><span class="hspace">&nbsp;</span><span class="RktSym">acc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span><span class="hspace">&nbsp;</span><span class="RktSym">acc</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">evaluated-yet?</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Delayed_Evaluation.html#%28def._%28%28lib._racket%2Fpromise..rkt%29._force%29%29" class="RktValLink" data-pltdoc="x">force</a></span><span class="hspace">&nbsp;</span><span class="RktSym">start</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">evaluated-yet?</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p>If the <span class="RktPn">#:delay-as</span> option is provided, then <span class="RktVar">delayed-id</span> is
+bound to an additional promise that returns the values of all <span class="RktVar">accum-id</span>s
+at once. When multiple <span class="RktVar">accum-id</span>s are provided, forcing this promise can
+be slightly more efficient than forcing the promises bound to the
+<span class="RktVar">accum-id</span>s individually.</p><p>If the <span class="RktPn">#:delay-with</span> option is provided, the given <span class="RktVar">delayer-id</span>
+is used to suspend nested iterations (instead of the default, <span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%29%29" class="RktStxLink" data-pltdoc="x">delay</a></span>).
+A form of the shape <span class="RktPn">(</span><span class="RktVar">delayer-id</span><span class="stt"> </span><span class="RktVar">recur-expr</span><span class="RktPn">)</span> is constructed and placed
+in expression position, where <span class="RktVar">recur-expr</span> is an expression that, when
+evaluated, will perform the next iteration and return its result (or results).
+Sensible choices for <span class="RktVar">delayer-id</span> include <span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._lazy%29%29" class="RktStxLink" data-pltdoc="x">lazy</a></span>,
+<span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fsync%29%29" class="RktStxLink" data-pltdoc="x">delay/sync</a></span>, <span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fthread%29%29" class="RktStxLink" data-pltdoc="x">delay/thread</a></span>, or any of the other promise
+constructors from <a href="Delayed_Evaluation.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/promise</span></a>, as well as <span class="RktSym"><a href="procedures.html#%28form._%28%28lib._racket%2Ffunction..rkt%29._thunk%29%29" class="RktStxLink" data-pltdoc="x">thunk</a></span> from
+<a href="procedures.html#%28mod-path._racket%2Ffunction%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/function</span></a>. However, beware that choices such as
+<span class="RktSym"><a href="procedures.html#%28form._%28%28lib._racket%2Ffunction..rkt%29._thunk%29%29" class="RktStxLink" data-pltdoc="x">thunk</a></span> or <span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fname%29%29" class="RktStxLink" data-pltdoc="x">delay/name</a></span> may evaluate their subexpression multiple
+times, which can lead to nonsensical results for sequences that have state, as
+the state will be shared between all evaluations of the <span class="RktVar">recur-expr</span>.</p><p>If multiple <span class="RktVar">accum-id</span>s are given, the <span class="RktPn">#:delay-with</span> option is
+provided, and <span class="RktVar">delayer-id</span> is not bound to one of <span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%29%29" class="RktStxLink" data-pltdoc="x">delay</a></span>,
+<span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._lazy%29%29" class="RktStxLink" data-pltdoc="x">lazy</a></span>, <span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fstrict%29%29" class="RktStxLink" data-pltdoc="x">delay/strict</a></span>, <span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fsync%29%29" class="RktStxLink" data-pltdoc="x">delay/sync</a></span>,
+<span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fthread%29%29" class="RktStxLink" data-pltdoc="x">delay/thread</a></span>, or <span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%2Fidle%29%29" class="RktStxLink" data-pltdoc="x">delay/idle</a></span>, the <span class="RktVar">accum-id</span>s will not
+be bound at all, even within the loop body. Instead, the <span class="RktPn">#:delay-as</span>
+option must be specified to access the accumulator values via
+<span class="RktVar">delayed-id</span>.</p><p class="SHistory">Added in version 7.3.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span>, but with an implicit <span class="RktPn">#:when</span><span class="stt"> </span><span class="RktVal">#t</span> between
+each pair of <span class="RktSym">for-clauses</span>, so that all sequence iterations are
+nested.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%29%29" class="RktStxLink" data-pltdoc="x">for*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">j</span><span class="hspace">&nbsp;</span><span class="RktVal">"ab"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">j</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">(1 a)(1 b)(2 a)(2 b)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for*/list))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Flist%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/list</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for*/lists))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Flists%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/lists</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-result</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for*/vector))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fvector%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/vector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-length</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for*/hash))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fhash%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/hash</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for*/hasheq))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fhasheq%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/hasheq</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for*/hasheqv))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fhasheqv%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/hasheqv</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for*/hashalw))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fhashalw%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/hashalw</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for*/and))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fand%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/and</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for*/or))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2For%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/or</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for*/sum))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fsum%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/sum</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for*/product))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fproduct%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/product</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for*/first))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Ffirst%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/first</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for*/last))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Flast%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/last</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for*/fold))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Ffold%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/fold</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">accum-id</span><span class="hspace">&nbsp;</span><span class="RktVar">init-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-result</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for*/foldr))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Ffoldr%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/foldr</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">accum-id</span><span class="hspace">&nbsp;</span><span class="RktVar">init-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">accum-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span>, etc., but with the implicit nesting of
+<span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%29%29" class="RktStxLink" data-pltdoc="x">for*</a></span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for*/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">j</span><span class="hspace">&nbsp;</span><span class="RktVal">"ab"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">j</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'((1 #\a) (1 #\b) (2 #\a) (2 #\b))</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.3.0.3 of package <span class="stt">base</span>: Added the <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Ffoldr%29%29" class="RktStxLink" data-pltdoc="x">for*/foldr</a></span> form.<br/>Changed in version 8.5.0.3: Added the <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Fhashalw%29%29" class="RktStxLink" data-pltdoc="x">for*/hashalw</a></span> form.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Deriving_New_Iteration_Forms&quot;">3.18.2<tt>&nbsp;</tt><a name="(part._.Deriving_.New_.Iteration_.Forms)"></a>Deriving New Iteration Forms</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for/fold/derived))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffold%2Fderived%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/fold/derived</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">orig-datum</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">accum-id</span><span class="hspace">&nbsp;</span><span class="RktVar">init-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-result</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffold%29%29" class="RktStxLink" data-pltdoc="x">for/fold</a></span>, but the extra <span class="RktVar">orig-datum</span> is used as the
+source for all syntax errors.</div></p><p>A macro that expands to <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffold%2Fderived%29%29" class="RktStxLink" data-pltdoc="x">for/fold/derived</a></span> should typically use
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Parsing_for_Bodies.html%23%2528def._%2528%2528lib._syntax%252Ffor-body..rkt%2529._split-for-body%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">split-for-body</a></span> to handle the possibility of macros and other
+definitions mixed with keywords like <span class="RktPn">#:break</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">syntax/for-body</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">syntax/parse/define</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Defining_Simple_Macros.html%23%2528form._%2528%2528lib._syntax%252Fparse%252Fdefine..rkt%2529._define-syntax-parse-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-parse-rule</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">for/digits</span><span class="hspace">&nbsp;</span><span class="RktSym">clauses</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tail-expr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:with</span><span class="hspace">&nbsp;</span><span class="RktSym">original</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-specifying.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._this-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">this-syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:with</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">pre-body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">post-body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Parsing_for_Bodies.html%23%2528def._%2528%2528lib._syntax%252Ffor-body..rkt%2529._split-for-body%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">split-for-body</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-specifying.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._this-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">this-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tail-expr</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffold%2Fderived%29%29" class="RktStxLink" data-pltdoc="x">for/fold/derived</a></span><span class="hspace">&nbsp;</span><span class="RktSym">original</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">#:result</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">clauses</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">pre-body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">post-body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">If we misuse for/digits, we can get good error reporting</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">because the use of orig-datum allows for source correlation:</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">for/digits</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="RktValLink" data-pltdoc="x">in-list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="RktValLink" data-pltdoc="x">in-list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">eval:4:0: for/digits: bad sequence binding clause</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: a</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (for/digits (a (in-list (quote (1 2 3)))) (b (in-list</span></p></td></tr><tr><td><p><span class="RktErr">(quote (4 5 6)))) (+ a b))</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">for/digits</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="RktValLink" data-pltdoc="x">in-list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="RktValLink" data-pltdoc="x">in-list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">963</span></p></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Another example: compute the max during iteration:</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Defining_Simple_Macros.html%23%2528form._%2528%2528lib._syntax%252Fparse%252Fdefine..rkt%2529._define-syntax-parse-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-parse-rule</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">for/max</span><span class="hspace">&nbsp;</span><span class="RktSym">clauses</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tail-expr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:with</span><span class="hspace">&nbsp;</span><span class="RktSym">original</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-specifying.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._this-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">this-syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:with</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">pre-body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">post-body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Parsing_for_Bodies.html%23%2528def._%2528%2528lib._syntax%252Ffor-body..rkt%2529._split-for-body%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">split-for-body</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-specifying.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._this-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">this-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tail-expr</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffold%2Fderived%29%29" class="RktStxLink" data-pltdoc="x">for/fold/derived</a></span><span class="hspace">&nbsp;</span><span class="RktSym">original</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">current-max</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-i</span>nf.0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">clauses</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">pre-body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">maybe-new-max</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">post-body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e%29%29" class="RktValLink" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktSym">maybe-new-max</span><span class="hspace">&nbsp;</span><span class="RktSym">current-max</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">maybe-new-max</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">current-max</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">for/max</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">3.14159</span><span class="hspace">&nbsp;</span><span class="RktVal">2.71828</span><span class="hspace">&nbsp;</span><span class="RktVal">1.61803</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">2.71828</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.11.0.1 of package <span class="stt">base</span>: Added the <span class="RktPn">#:result</span> form.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for*/fold/derived))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Ffold%2Fderived%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/fold/derived</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">orig-datum</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">accum-id</span><span class="hspace">&nbsp;</span><span class="RktVar">init-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-result</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Ffold%29%29" class="RktStxLink" data-pltdoc="x">for*/fold</a></span>, but the extra <span class="RktVar">orig-datum</span> is used as the source for all syntax errors.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">syntax/for-body</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">syntax/parse/define</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Defining_Simple_Macros.html%23%2528form._%2528%2528lib._syntax%252Fparse%252Fdefine..rkt%2529._define-syntax-parse-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-parse-rule</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">for*/digits</span><span class="hspace">&nbsp;</span><span class="RktSym">clauses</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tail-expr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:with</span><span class="hspace">&nbsp;</span><span class="RktSym">original</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-specifying.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._this-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">this-syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:with</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">pre-body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">post-body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Parsing_for_Bodies.html%23%2528def._%2528%2528lib._syntax%252Ffor-body..rkt%2529._split-for-body%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">split-for-body</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-specifying.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._this-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">this-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tail-expr</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Ffold%2Fderived%29%29" class="RktStxLink" data-pltdoc="x">for*/fold/derived</a></span><span class="hspace">&nbsp;</span><span class="RktSym">original</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">#:result</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">clauses</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">pre-body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">post-body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">for*/digits</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">ds</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="RktValLink" data-pltdoc="x">in-list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="RktValLink" data-pltdoc="x">in-list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ds</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">eval:10:0: for*/digits: bad sequence binding clause</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: ds</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (for*/digits (ds (in-list (quote ((8 3) (1 1))))) (d</span></p></td></tr><tr><td><p><span class="RktErr">(in-list ds)) d)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">for*/digits</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ds</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="RktValLink" data-pltdoc="x">in-list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="RktValLink" data-pltdoc="x">in-list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ds</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">1138</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.11.0.1 of package <span class="stt">base</span>: Added the <span class="RktPn">#:result</span> form.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for/foldr/derived))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffoldr%2Fderived%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/foldr/derived</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">orig-datum</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">accum-id</span><span class="hspace">&nbsp;</span><span class="RktVar">init-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">accum-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for*/foldr/derived))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Ffoldr%2Fderived%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/foldr/derived</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">orig-datum</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">accum-id</span><span class="hspace">&nbsp;</span><span class="RktVar">init-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">accum-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffoldr%29%29" class="RktStxLink" data-pltdoc="x">for/foldr</a></span> and <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Ffoldr%29%29" class="RktStxLink" data-pltdoc="x">for*/foldr</a></span>, but the extra
+<span class="RktVar">orig-datum</span> is used as the source for all syntax errors as in
+<span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Ffold%2Fderived%29%29" class="RktStxLink" data-pltdoc="x">for/fold/derived</a></span> and <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Ffold%2Fderived%29%29" class="RktStxLink" data-pltdoc="x">for*/fold/derived</a></span>.</div></p><p class="SHistory">Added in version 7.3.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._define-sequence-syntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-sequence-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-sequence-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">expr-transform-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">clause-transform-expr</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><blockquote class="SubFlow"><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">expr-transform-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">clause-transform-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Defines <span class="RktVar">id</span> as syntax. An <span class="RktPn">(</span><span class="RktVar">id</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">rest</span><span class="RktPn">)</span> form is
+treated specially when used to generate a sequence in a
+<span class="RktVar">for-clause</span> of <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> (or one of its variants). In that
+case, the procedure result of <span class="RktVar">clause-transform-expr</span> is called
+to transform the clause.</div></p><p>When <span class="RktVar">id</span> is used in any other expression position, the result
+of <span class="RktVar">expr-transform-expr</span> is used. If it is a procedure of zero
+arguments, then the result must be an identifier <span class="RktVar">other-id</span>,
+and any use of <span class="RktVar">id</span> is converted to a use of
+<span class="RktVar">other-id</span>. Otherwise, <span class="RktVar">expr-transform-expr</span> must
+produce a procedure (of one argument) that is used as a macro
+transformer.</p><p>When the <span class="RktVar">clause-transform-expr</span> transformer is used, it is
+given a <span class="RktVar">for-clause</span> as an argument, where the clause&rsquo;s form is
+normalized so that the left-hand side is a parenthesized sequence of
+identifiers. The right-hand side is of the form <span class="RktPn">(</span><span class="RktVar">id</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">rest</span><span class="RktPn">)</span>.
+The result can be either <span class="RktVal">#f</span>, to indicate that the forms
+should not be treated specially (perhaps because the number of bound
+identifiers is inconsistent with the <span class="RktPn">(</span><span class="RktVar">id</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">rest</span><span class="RktPn">)</span> form), or a
+new <span class="RktVar">for-clause</span> to replace the given one. The new clause might
+use <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~3ado-in%29%29" class="RktStxLink" data-pltdoc="x">:do-in</a></span>. To protect identifiers in the result of
+<span class="RktVar">clause-transform-expr</span>, use <span class="RktSym"><a href="for.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-clause-syntax-protect%29%29" class="RktValLink" data-pltdoc="x">for-clause-syntax-protect</a></span>
+instead of <span class="RktSym"><a href="stxcerts.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-protect%29%29" class="RktValLink" data-pltdoc="x">syntax-protect</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check-nat</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._unless%29%29" class="RktStxLink" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-argument-error%29%29" class="RktValLink" data-pltdoc="x">raise-argument-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">in-digits</span><span class="hspace">&nbsp;</span><span class="RktVal">"exact-nonnegative-integer?"</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-sequence-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-sequence-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in-digits</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">in-digits/proc</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Library_Syntax_Classes_and_Literal_Sets.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._nat%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">nat</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">d</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~3ado-in%29%29" class="RktStxLink" data-pltdoc="x">:do-in</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Library_Syntax_Classes_and_Literal_Sets.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._nat%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">nat</a></span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check-nat</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">j</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._quotient%2Fremainder%29%29" class="RktValLink" data-pltdoc="x">quotient/remainder</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">j</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">in-digits/proc</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">in-digits</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">in-digits</span><span class="hspace">&nbsp;</span><span class="RktVal">1138</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(8 3 1 1)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in-digits</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">137</span><span class="hspace">&nbsp;</span><span class="RktVal">216</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((7 3 1) (6 1 2))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._~3ado-in))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~3ado-in%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">:do-in</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">outer-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">outer-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">outer-check</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">loop-id</span><span class="hspace">&nbsp;</span><span class="RktVar">loop-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">pos-guard</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">inner-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">inner-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">pre-guard</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">post-guard</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">loop-arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A form that can only be used as a <span class="RktVar">seq-expr</span> in a
+<span class="RktVar">for-clause</span> of <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> (or one of its variants).</div></p><p>Within a <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span>, the pieces of the <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~3ado-in%29%29" class="RktStxLink" data-pltdoc="x">:do-in</a></span> form are
+spliced into the iteration essentially as follows:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">outer-id</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">outer-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">outer-check</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">loop-id</span><span class="hspace">&nbsp;</span><span class="RktVar">loop-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktVar">pos-guard</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">inner-id</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">inner-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktVar">pre-guard</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktVar">body-bindings</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktVar">post-guard</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktVar">loop-arg</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">done-expr</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">done-expr</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">done-expr</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>where <span class="RktVar">body-bindings</span> and <span class="RktVar">done-expr</span> are from the
+context of the <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~3ado-in%29%29" class="RktStxLink" data-pltdoc="x">:do-in</a></span> use. The identifiers bound by the
+<span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> clause are typically part of the <span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">inner-id</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">inner-expr</span><span class="RktPn">]</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> section.</p><p>Beware that <span class="RktVar">body-bindings</span> and <span class="RktVar">done-expr</span> can
+contain arbitrary expressions, potentially including <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span> on
+<span class="RktVar">outer-id</span> or <span class="RktVar">inner-id</span> identifiers if they are visible
+in the original <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> form, so beware of depending on such
+identifiers in <span class="RktVar">post-guard</span> and <span class="RktVar">loop-arg</span>.</p><p>The actual <span class="RktSym">loop</span> binding and call has additional loop
+arguments to support iterations in parallel with the <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~3ado-in%29%29" class="RktStxLink" data-pltdoc="x">:do-in</a></span>
+form, and the other pieces are similarly accompanied by pieces from
+parallel iterations.</p><p>For an example of <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~3ado-in%29%29" class="RktStxLink" data-pltdoc="x">:do-in</a></span>, see <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-sequence-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-sequence-syntax</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._for-clause-syntax-protect))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-clause-syntax-protect%29%29" class="RktValDef RktValLink" data-pltdoc="x">for-clause-syntax-protect</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Provided <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span>: Like <span class="RktSym"><a href="stxcerts.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-protect%29%29" class="RktValLink" data-pltdoc="x">syntax-protect</a></span>, just
+returns its argument.</div></p><p class="SHistory">Changed in version 8.2.0.4 of package <span class="stt">base</span>: Changed to just return <span class="RktVar">stx</span> instead
+of returning &ldquo;armed&rdquo; syntax.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._define-splicing-for-clause-syntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-splicing-for-clause-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-splicing-for-clause-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">proc-expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Binds <span class="RktVar">id</span> for reference via a <span class="RktPn">#:splicing</span> clause in a
+<span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> form. The <span class="RktVar">proc-expr</span> expression is evaluated in
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 1, and it must produce a procedure that accepts a
+syntax object and returns a syntax object.</div></p><p>The procedure&rsquo;s input is a syntax object that appears after
+<span class="RktPn">#:splicing</span>. The result syntax object must be a parenthesized
+sequence of forms, and the forms are spliced in place of the
+<span class="RktPn">#:splicing</span> clause in the enclosing <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> form.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-splicing-for-clause-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-splicing-for-clause-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cross3</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">#:splice</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">cross3</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._println%29%29" class="RktValLink" data-pltdoc="x">println</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">'(0 0)</span></p></td></tr><tr><td><p><span class="RktOut">'(0 1)</span></p></td></tr><tr><td><p><span class="RktOut">'(0 2)</span></p></td></tr><tr><td><p><span class="RktOut">'(1 0)</span></p></td></tr><tr><td><p><span class="RktOut">'(1 1)</span></p></td></tr><tr><td><p><span class="RktOut">'(1 2)</span></p></td></tr><tr><td><p><span class="RktOut">'(2 0)</span></p></td></tr><tr><td><p><span class="RktOut">'(2 1)</span></p></td></tr><tr><td><p><span class="RktOut">'(2 2)</span></p></td></tr></table></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 8.4.0.3 of package <span class="stt">base</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Do_Loops&quot;">3.18.3<tt>&nbsp;</tt><a name="(part._.Do_.Loops)"></a>Do Loops</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/more-scheme..rkt)._do))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._do%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">do</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">init-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">step-expr-maybe</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">stop?-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">finish-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">step-expr-maybe</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">step-expr</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Iteratively evaluates the <span class="RktVar">expr</span>s for as long as
+<span class="RktVar">stop?-expr</span> returns <span class="RktVal">#f</span>.</div></p><p>To initialize the loop, the <span class="RktVar">init-expr</span>s are evaluated in order
+and bound to the corresponding <span class="RktVar">id</span>s. The <span class="RktVar">id</span>s are
+bound in all expressions within the form other than the
+<span class="RktVar">init-expr</span>s.</p><p>After the <span class="RktVar">id</span>s have been bound, the <span class="RktVar">stop?-expr</span> is
+evaluated. If it produces <span class="RktVal">#f</span>, each <span class="RktVar">expr</span> is evaluated
+for its side-effect. The <span class="RktVar">id</span>s are then effectively updated
+with the values of the <span class="RktVar">step-expr</span>s, where the default
+<span class="RktVar">step-expr</span> for <span class="RktVar">id</span> is just <span class="RktVar">id</span>; more
+precisely, iteration continues with fresh locations for the
+<span class="RktVar">id</span>s that are initialized with the values of the corresponding
+<span class="RktVar">step-expr</span>s.</p><p>When <span class="RktVar">stop?-expr</span> produces a true value, then the
+<span class="RktVar">finish-expr</span>s are evaluated in order, and the last one is
+evaluated in tail position to produce the overall value for the
+<span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._do%29%29" class="RktStxLink" data-pltdoc="x">do</a></span> form. If no <span class="RktVar">finish-expr</span> is provided, the value of
+the <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._do%29%29" class="RktStxLink" data-pltdoc="x">do</a></span> form is <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="set_.html" title="backward to &quot;3.17 Assignment: set! and set!-values&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="wcm.html" title="forward to &quot;3.19 Continuation Marks: with-continuation-mark&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/function-contracts.html b/clones/docs.racket-lang.org/reference/function-contracts.html
new file mode 100644
index 00000000..f6b262fe
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/function-contracts.html
@@ -0,0 +1,192 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>8.2&nbsp;Function Contracts</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.1&nbsp;</td><td><a href="data-structure-contracts.html" class="tocviewlink" data-pltdoc="x">Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.2&nbsp;</td><td><a href="function-contracts.html" class="tocviewselflink" data-pltdoc="x">Function Contracts</a></td></tr><tr><td align="right">8.3&nbsp;</td><td><a href="parametric-contracts.html" class="tocviewlink" data-pltdoc="x">Parametric Contracts</a></td></tr><tr><td align="right">8.4&nbsp;</td><td><a href="Lazy_Data-structure_Contracts.html" class="tocviewlink" data-pltdoc="x">Lazy Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.5&nbsp;</td><td><a href="Structure_Type_Property_Contracts.html" class="tocviewlink" data-pltdoc="x">Structure Type Property Contracts</a></td></tr><tr><td align="right">8.6&nbsp;</td><td><a href="attaching-contracts-to-values.html" class="tocviewlink" data-pltdoc="x">Attaching Contracts to Values</a></td></tr><tr><td align="right">8.7&nbsp;</td><td><a href="Building_New_Contract_Combinators.html" class="tocviewlink" data-pltdoc="x">Building New Contract Combinators</a></td></tr><tr><td align="right">8.8&nbsp;</td><td><a href="contract-utilities.html" class="tocviewlink" data-pltdoc="x">Contract Utilities</a></td></tr><tr><td align="right">8.9&nbsp;</td><td><a href="racket_contract_base.html" class="tocviewlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>contract/<span class="mywbr"> &nbsp;</span>base</span></span></a></td></tr><tr><td align="right">8.10&nbsp;</td><td><a href="collapsible.html" class="tocviewlink" data-pltdoc="x">Collapsible Contracts</a></td></tr><tr><td align="right">8.11&nbsp;</td><td><a href="Legacy_Contracts.html" class="tocviewlink" data-pltdoc="x">Legacy Contracts</a></td></tr><tr><td align="right">8.12&nbsp;</td><td><a href="Random_generation.html" class="tocviewlink" data-pltdoc="x">Random generation</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink"><span class="nobreak">-<wbr></wbr>&gt;</span></span></span></a></td></tr><tr><td><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink"><span class="nobreak">-<wbr></wbr>&gt;</span>*</span></span></a></td></tr><tr><td><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink"><span class="nobreak">-<wbr></wbr>&gt;</span>i</span></span></a></td></tr><tr><td><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ed%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink"><span class="nobreak">-<wbr></wbr>&gt;</span>d</span></span></a></td></tr><tr><td><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._case-~3e%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>&gt;</span></span></a></td></tr><tr><td><a href="function-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._dynamic-~3e%2A%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-<wbr></wbr>&gt;*</span></span></a></td></tr><tr><td><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._unconstrained-domain-~3e%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unconstrained-<wbr></wbr>domain-<wbr></wbr>&gt;</span></span></a></td></tr><tr><td><a href="function-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._predicate%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">predicate/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="function-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._the-unsupplied-arg%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">the-<wbr></wbr>unsupplied-<wbr></wbr>arg</span></span></a></td></tr><tr><td><a href="function-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._unsupplied-arg~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsupplied-<wbr></wbr>arg?</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="data-structure-contracts.html" title="backward to &quot;8.1 Data-structure Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="parametric-contracts.html" title="forward to &quot;8.3 Parametric Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;function-contracts&quot;">8.2<tt>&nbsp;</tt><a name="(part._function-contracts)"></a>Function Contracts</h4><p>A <a name="(tech._function._contract)"></a><span style="font-style: italic">function contract</span> wraps a procedure to delay
+checks for its arguments and results. There are three
+primary function contract combinators that have increasing
+amounts of expressiveness and increasing additional
+overheads. The first <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span> is the cheapest. It
+generates wrapper functions that can call the original
+function directly. Contracts built with <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span> require
+packaging up arguments as lists in the wrapper function and
+then using either <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._keyword-apply%29%29" class="RktValLink" data-pltdoc="x">keyword-apply</a></span> or
+<span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span>. Finally, <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span>
+is the most expensive (along with <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ed%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span>),
+because it requires delaying the evaluation of the contract
+expressions for the domain and range until the function
+itself is called or returns.</p><p>The <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._case-~3e%29%29" class="RktStxLink" data-pltdoc="x">case-&gt;</a></span> contract is a specialized contract,
+designed to match <span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span> and
+<span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._unconstrained-domain-~3e%29%29" class="RktStxLink" data-pltdoc="x">unconstrained-domain-&gt;</a></span> allows range checking
+without requiring that the domain have any particular shape
+(see below for an example use).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/base..rkt)._-~3e))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxDef RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dom</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">range</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxDef RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktVar">dom</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">ellipsis</span><span class="hspace">&nbsp;</span><span class="RktVar">dom-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">range</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">dom</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">dom-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktVar">dom-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">range</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">range-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVar">range-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">ellipsis</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Produces a contract for a function that accepts the argument
+specified by the <span class="RktVar">dom-expr</span> contracts and returns
+either a fixed number of
+results or completely unspecified results (the latter when
+<span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span> is specified).</div></p><p>Each <span class="RktVar">dom-expr</span> is a contract on an argument to a
+function, and each <span class="RktVar">range-expr</span> is a contract on a
+result of the function.</p><p>If the domain contain <span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span>
+then the function accepts as many arguments as the rest of
+the contracts in the domain portion specify, as well as
+arbitrarily many more that match the contract just before the
+<span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span>. Otherwise, the contract accepts exactly the
+argument specified.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Using a <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span> between two whitespace-delimited
+<span class="RktPn">.</span>s is the same as putting the <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span> right
+after the enclosing opening parenthesis. See
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Pairs__Lists__and_Racket_Syntax.html%23%2528part._lists-and-syntax%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Lists and Racket Syntax</a> or <a href="reader.html#%28part._parse-pair%29" data-pltdoc="x">Reading Pairs and Lists</a> for more
+information.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara">For example,
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span></p></blockquote></div><div class="SIntrapara">produces a contract on functions of two arguments. The first argument
+must be an integer, and the second argument must be a boolean. The
+function must produce an integer.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">maybe-invert</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">maybe-invert</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">maybe-invert</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">maybe-invert: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: #f</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; integer? boolean? integer?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (function maybe-invert)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara">A domain specification may include a keyword. If so, the function must
+accept corresponding (mandatory) keyword arguments, and the values for
+the keyword arguments must match the corresponding contracts. For
+example:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:invert?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span></p></blockquote></div><div class="SIntrapara">is a contract on a function that accepts a by-position argument that
+is an integer and an <span class="RktPn">#:invert?</span> argument that is a boolean.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">maybe-invert</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">#:invert?</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:invert?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">maybe-invert</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">#:invert?</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">maybe-invert</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">maybe-invert: arity mismatch;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">the expected number of arguments does not match the given</span></p></td></tr><tr><td><p><span class="RktErr">number</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: 1 plus an argument with keyword #:invert?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 2</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">arguments...:</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">1</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara">As an example that uses an <span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span>, this contract:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote></div><div class="SIntrapara">on a function insists that the first and last arguments to
+the function must be integers (and there must be at least
+two arguments) and any other arguments must be strings.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">string-length/between?</span><span class="hspace">&nbsp;</span><span class="RktSym">lower-bound</span><span class="hspace">&nbsp;</span><span class="RktSym">s1</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">more-args</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">all-but-first-arg-backwards</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._reverse%29%29" class="RktValLink" data-pltdoc="x">reverse</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s1</span><span class="hspace">&nbsp;</span><span class="RktSym">more-args</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">upper-bound</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._first%29%29" class="RktValLink" data-pltdoc="x">first</a></span><span class="hspace">&nbsp;</span><span class="RktSym">all-but-first-arg-backwards</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">strings</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span><span class="hspace">&nbsp;</span><span class="RktSym">all-but-first-arg-backwards</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">strings-length</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fsum%29%29" class="RktStxLink" data-pltdoc="x">for/sum</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">str</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="RktValLink" data-pltdoc="x">in-list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">strings</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="RktValLink" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c~3d%29%29" class="RktValLink" data-pltdoc="x">&lt;=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lower-bound</span><span class="hspace">&nbsp;</span><span class="RktSym">strings-length</span><span class="hspace">&nbsp;</span><span class="RktSym">upper-bound</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">string-length/between?</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">"farmer"</span><span class="hspace">&nbsp;</span><span class="RktVal">"john"</span><span class="hspace">&nbsp;</span><span class="RktVal">40</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">string-length/between?</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">"farmer"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">john</span><span class="hspace">&nbsp;</span><span class="RktVal">40</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">string-length/between?: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: string?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 'john</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the repeated argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; integer? string? ... integer? boolean?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: </span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(function string-length/between?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">string-length/between?</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">"farmer"</span><span class="hspace">&nbsp;</span><span class="RktVal">"john"</span><span class="hspace">&nbsp;</span><span class="RktVal">"fourty"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">string-length/between?: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: "fourty"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the last argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; integer? string? ... integer? boolean?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: </span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(function string-length/between?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr></table></blockquote></div></p><p>If <span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span> is used as the last sub-form for <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span>, no
+contract checking is performed on the result of the function, and
+thus any number of values is legal (even different numbers on different
+invocations of the function).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">multiple-xs</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._natural~3f%29%29" class="RktValLink" data-pltdoc="x">natural?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">multiple-xs</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">"four"</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr></table></td></tr></table></blockquote></div></p><p>If <span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="stt"> </span><span class="RktVar">range-expr</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> is used as the last sub-form of
+<span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span>, the function must produce a result for each contract, and
+each value must match its respective contract.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">multiple-xs</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._natural~3f%29%29" class="RktValLink" data-pltdoc="x">natural?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">multiple-xs</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">"three"</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">multiple-xs</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">"four"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">multiple-xs: broke its own contract;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">expected 3 values, returned 4 values</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the range of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">natural?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">any/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(values any/c any/c any/c))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (function multiple-xs)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (function multiple-xs)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.4.0.5 of package <span class="stt">base</span>: Added support for ellipses</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/base..rkt)._-~3e*))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">mandatory-dom</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">optional-doms</span><span class="hspace">&nbsp;</span><span class="RktVar">rest</span><span class="hspace">&nbsp;</span><span class="RktVar">pre</span><span class="hspace">&nbsp;</span><span class="RktVar">range</span><span class="hspace">&nbsp;</span><span class="RktVar">post</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">mandatory-dom</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">dom-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktVar">dom-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">optional-doms</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">optional-dom</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">optional-dom</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">dom-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktVar">dom-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">rest</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktVar">rest-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">pre</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:pre</span><span class="hspace">&nbsp;</span><span class="RktVar">pre-cond-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:pre/desc</span><span class="hspace">&nbsp;</span><span class="RktVar">pre-cond-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">range</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">range-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVar">range-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">post</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:post</span><span class="hspace">&nbsp;</span><span class="RktVar">post-cond-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:post/desc</span><span class="hspace">&nbsp;</span><span class="RktVar">post-cond-expr</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span> contract combinator produces contracts for functions
+that accept optional arguments (either keyword or positional) and/or
+arbitrarily many arguments. The first clause of a <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span>
+contract describes the mandatory arguments, and is similar to the
+argument description of a <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span> contract. The second clause
+describes the optional arguments. The range of description can either
+be <span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span> or a sequence of contracts, indicating that the
+function must return multiple values.</div></p><p><div class="SIntrapara">If present, the
+<span class="RktVar">rest-expr</span> contract governs the arguments in the rest
+parameter. Note that the <span class="RktVar">rest-expr</span> contract governs only
+the arguments in the rest parameter, not those in mandatory arguments.
+For example, this contract:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote></div><div class="SIntrapara">does not match the function
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">rest</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></p></blockquote></div><div class="SIntrapara">because the contract insists that the function accept zero arguments
+(because there are no mandatory arguments listed in the contract). The
+<span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span> contract does not know that the contract on the rest argument is
+going to end up disallowing empty argument lists.</div></p><p>The <span class="RktVar">pre-cond-expr</span> and <span class="RktVar">post-cond-expr</span>
+expressions are checked as the function is called and returns,
+respectively, and allow checking of the environment without an
+explicit connection to an argument (or a result). If the <span class="RktPn">#:pre</span>
+or <span class="RktPn">#:post</span> keywords are used, then a <span class="RktVal">#f</span> result is
+treated as a failure and any other result is treated as success.
+If the <span class="RktPn">#:pre/desc</span> or <span class="RktPn">#:post/desc</span> keyword is used,
+the result of the expression must be either a boolean, a string, or a
+list of strings, where <span class="RktVal">#t</span> means success and any of the other
+results mean failure. If the result is a string or a list of strings,
+the strings are expected to have at exactly one space after each
+newline and multiple are used as lines in the error message; the contract
+itself adds single space of indentation to each of the strings in that case.
+The formatting requirements are not checked but they
+match the recommendations in <a href="exns.html#%28part._err-msg-conventions%29" data-pltdoc="x">Error Message Conventions</a>.</p><p><div class="SIntrapara">As an example, the contract
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:x</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></p></blockquote></div><div class="SIntrapara">matches functions that optionally accept a boolean, an
+integer keyword argument <span class="RktPn">#:x</span> and arbitrarily more
+symbols, and that return a symbol.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/contract/base..rkt)._-~3ei))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxDef RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-chaperone</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">mandatory-dependent-dom</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">dependent-rest</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">pre-condition</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">dependent-range</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">post-condition</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxDef RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-chaperone</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">mandatory-dependent-dom</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">optional-dependent-dom</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">dependent-rest</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">pre-condition</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">dependent-range</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">post-condition</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">maybe-chaperone</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:chaperone</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">mandatory-dependent-dom</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id+ctc</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktVar">id+ctc</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">optional-dependent-dom</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id+ctc</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktVar">id+ctc</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">dependent-rest</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktVar">id+ctc</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">pre-condition</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">#:pre</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktVar">boolean-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">pre-condition</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">#:pre/desc</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktVar">pre-condition</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">#:pre/name</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktVar">string</span><span class="hspace">&nbsp;</span><span class="RktVar">boolean-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">pre-condition</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">dependent-range</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id+ctc</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">un+ctc</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id+ctc</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVar">un+ctc</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">post-condition</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">#:post</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktVar">boolean-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">post-condition</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">#:post/desc</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktVar">post-condition</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">#:post/name</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktVar">string</span><span class="hspace">&nbsp;</span><span class="RktVar">boolean-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">post-condition</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">id+ctc</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">un+ctc</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">_</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">_</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">contract-expr</span><span class="RktPn">]</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span> contract combinator differs from the <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span>
+combinator in that each argument and result is named and these names can
+be used in the subcontracts and in the pre-/post-condition clauses.
+In other words, <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span> expresses dependencies among arguments and results.</div></p><p>The optional first keyword argument to <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span> indicates if the result
+contract will be a chaperone. If it is <span class="RktPn">#:chaperone</span>, all of the contract for the arguments
+and results must be <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contracts</span></a> and the result of <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span> will be
+a <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contract</span></a>. If it is not present, then the result
+contract will not be a <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contract</span></a>.</p><p>The first sub-form of a <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span> contract covers the mandatory and the
+second sub-form covers the optional arguments. Following that is an optional
+rest-args contract, and an optional pre-condition. The pre-condition is
+introduced with the <span class="RktPn">#:pre</span> keyword followed by the list of names on
+which it depends. If the <span class="RktPn">#:pre/name</span> keyword is used, the string
+supplied is used as part of the error message; similarly with <span class="RktPn">#:post/name</span>.
+If <span class="RktPn">#:pre/desc</span> or <span class="RktPn">#:post/desc</span> is used, the the result of
+the expression is treated the same way as <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span>.</p><p>The <span class="RktVar">dependent-range</span> non-terminal specifies the possible result
+contracts. If it is <span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span>, then any value is allowed. Otherwise, the
+result contract pairs a name and a contract or a multiple values return
+with names and contracts. In the last two cases, the range contract may be
+optionally followed by a post-condition; the post-condition expression is
+not allowed if the range contract is <span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span>. Like the pre-condition,
+the post-condition must specify the variables on which it depends.</p><p><div class="SIntrapara">Consider this sample contract:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">It specifies a function of two arguments, both numbers. The contract on the
+second argument (<span class="RktSym">y</span>) demands that it is greater than the first
+argument. The result contract promises a number that is greater than the
+sum of the two arguments. While the dependency specification for <span class="RktSym">y</span>
+signals that the argument contract depends on the value of the first
+argument, the dependency sequence for <span class="RktSym">result</span> indicates that the
+contract depends on both argument values. <span class="refelem"><span class="refcolumn"><span class="refcontent">In general, an
+empty sequence is (nearly) equivalent to not adding
+a sequence at all except that the former is more expensive than the latter.</span></span></span>
+Since the contract for <span class="RktSym">x</span> does not depend on anything else, it does
+not come with any dependency sequence, not even <span class="RktPn">(</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">This example is like the previous one, except the <span class="RktSym">x</span> and <span class="RktSym">y</span>
+arguments are now optional keyword arguments, instead of mandatory, by-position
+arguments:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">#:x</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:y</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">The conditional in the range that tests <span class="RktVar">x</span> and <span class="RktVar">y</span>
+is necessary to cover the situation where <span class="RktVar">x</span> or <span class="RktVar">y</span>
+are not supplied by the calling context (meaning they might be bound
+to <span class="RktSym"><a href="function-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._the-unsupplied-arg%29%29" class="RktValLink" data-pltdoc="x">the-unsupplied-arg</a></span>).</div></p><p>The contract expressions are not always evaluated in
+order. First, if there is no dependency for a given contract expression,
+the contract expression is evaluated at the time that the <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span>
+expression is evaluated rather than the time when the function is called or
+returns.  These dependency-free contract expressions are evaluated in the
+order in which they are listed.
+Second, the dependent contract sub-expressions are evaluated when the
+contracted function is called or returns in some order that satisfies the
+dependencies. That is, if a contract for an argument depends on the value
+of some other contract, the former is evaluated first (so that the
+argument, with its contract checked, is available for the other).  When
+there is no dependency between two arguments (or the result and an
+argument), then the contract that appears earlier in the source text is
+evaluated first.</p><p>If all of the identifier positions of a range contract with
+ a dependency are <span class="RktVar">_</span>s (underscores), then the range
+ contract expressions are evaluated when the function is
+ called instead of when it returns. Otherwise, dependent
+ range expressions are evaluated when the function returns.</p><p><div class="SIntrapara">If there are optional arguments that are not supplied, then
+ the corresponding variables will be bound to a special value
+ called <span class="RktSym"><a href="function-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._the-unsupplied-arg%29%29" class="RktValLink" data-pltdoc="x">the-unsupplied-arg</a></span> value. For example, in
+ this contract:
+ </div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._unsupplied-arg~3f%29%29" class="RktValLink" data-pltdoc="x">unsupplied-arg?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">the contract on <span class="RktSym">x</span> depends on <span class="RktVar">y</span>, but
+ <span class="RktVar">y</span> might not be supplied at the call site. In that
+ case, the value of <span class="RktVar">y</span> in the contract on
+ <span class="RktVar">x</span> is <span class="RktSym"><a href="function-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._the-unsupplied-arg%29%29" class="RktValLink" data-pltdoc="x">the-unsupplied-arg</a></span>
+ and the <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span> contract must check for it and tailor
+ the contract on <span class="RktVar">x</span> to
+ account for <span class="RktVar">y</span> not being supplied.</div></p><p><div class="SIntrapara">When the contract expressions for unsupplied arguments are dependent,
+and the argument is not supplied at the call site, the contract
+expressions are not evaluated at all. For example, in this contract,
+<span class="RktVar">y</span>&rsquo;s contract expression is evaluated only when <span class="RktVar">y</span>
+is supplied:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">In contrast, <span class="RktVar">x</span>&rsquo;s expression is always evaluated (indeed,
+it is evaluated when the <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span> expression is evaluated because
+it does not have any dependencies).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/contract/base..rkt)._-~3ed))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ed%29%29" class="RktStxDef RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">mandatory-dependent-dom</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">dependent-rest</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">pre-condition</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">dependent-range</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">post-condition</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ed%29%29" class="RktStxDef RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">mandatory-dependent-dom</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">optional-dependent-dom</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">dependent-rest</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">pre-condition</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">dependent-range</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">post-condition</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">mandatory-dependent-dom</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">dom-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">dom-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">optional-dependent-dom</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">dom-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">dom-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">dependent-rest</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">rest-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">pre-condition</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:pre</span><span class="hspace">&nbsp;</span><span class="RktVar">boolean-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:pre-cond</span><span class="hspace">&nbsp;</span><span class="RktVar">boolean-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">dependent-range</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">_</span><span class="hspace">&nbsp;</span><span class="RktVar">range-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">_</span><span class="hspace">&nbsp;</span><span class="RktVar">range-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">range-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">range-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">post-condition</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:post-cond</span><span class="hspace">&nbsp;</span><span class="RktVar">boolean-expr</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">This contract is here for backwards compatibility; any new code should
+use <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span> instead.</div></p><p><div class="SIntrapara">This contract is similar to <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span>, but is &ldquo;lax&rdquo;, meaning
+that it does not enforce contracts internally. For example, using
+this contract
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ed%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:pre</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">will allow <span class="RktSym">f</span> to be called with <span class="RktVal">#f</span>, trigger whatever bad
+behavior the author of <span class="RktSym">f</span> was trying to prohibit by insisting that
+<span class="RktSym">f</span>&rsquo;s contract accept only integers.</div></p><p>The <span class="RktPn">#:pre-cond</span> and <span class="RktPn">#:post-cond</span> keywords are aliases for
+<span class="RktPn">#:pre</span> and <span class="RktPn">#:post</span> and are provided for backwards compatibility.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/base..rkt)._case-~3e))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._case-~3e%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">case-&gt;</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktVar">dom-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">rest</span><span class="hspace">&nbsp;</span><span class="RktVar">range</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">rest</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktVar">rest-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">range</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">range-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVar">range-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">This contract form is designed to match
+<span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span>. Each argument to <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._case-~3e%29%29" class="RktStxLink" data-pltdoc="x">case-&gt;</a></span> is a
+contract that governs a clause in the
+<span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span>. If the <span class="RktPn">#:rest</span> keyword is
+present, the corresponding clause must accept an arbitrary
+number of arguments. The <span class="RktVar">range</span> specification is
+just like that for <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span> and <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span>.</div></p><p><div class="SIntrapara">For example, this contract matches a function with two
+cases, one that accepts an integer, returning void, and one
+that accepts no arguments and returns an integer.
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._case-~3e%29%29" class="RktStxLink" data-pltdoc="x">case-&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Such a contract could be used to guard a function that controls
+access to a single shared integer.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top" colspan="3"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/base..rkt)._dynamic-~3e*))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="function-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._dynamic-~3e%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">dynamic-&gt;*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:mandatory-domain-contracts</span><span class="hspace">&nbsp;</span><span class="RktVar">mandatory-domain-contracts</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:optional-domain-contracts</span><span class="hspace">&nbsp;</span><span class="RktVar">optional-domain-contracts</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:mandatory-keywords</span><span class="hspace">&nbsp;</span><span class="RktVar">mandatory-keywords</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:mandatory-keyword-contracts</span><span class="hspace">&nbsp;</span><span class="RktVar">mandatory-keyword-contracts</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:optional-keywords</span><span class="hspace">&nbsp;</span><span class="RktVar">optional-keywords</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:optional-keyword-contracts</span><span class="hspace">&nbsp;</span><span class="RktVar">optional-keyword-contracts</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:rest-contract</span><span class="hspace">&nbsp;</span><span class="RktVar">rest-contract</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:range-contracts</span><span class="hspace">&nbsp;</span><span class="RktVar">range-contracts</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mandatory-domain-contracts</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">optional-domain-contracts</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mandatory-keywords</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mandatory-keyword-contracts</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">optional-keywords</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">optional-keyword-contracts</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">rest-contract</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">range-contracts</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span>, except the number of arguments and results can be computed
+at runtime, instead of being fixed at compile-time. Passing <span class="RktVal">#f</span> as the
+<span class="RktPn">#:range-contracts</span> argument produces a contract like one where <span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span>
+is used with <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span> or <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span>.</div></p><p>For many uses, <span class="RktSym"><a href="function-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._dynamic-~3e%2A%29%29" class="RktValLink" data-pltdoc="x">dynamic-&gt;*</a></span>&rsquo;s result is slower than <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span> (or <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span>),
+but for some it has comparable speed. The name of the contract returned by
+<span class="RktSym"><a href="function-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._dynamic-~3e%2A%29%29" class="RktValLink" data-pltdoc="x">dynamic-&gt;*</a></span> uses the <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span> or <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span> syntax.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/base..rkt)._unconstrained-domain-~3e))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._unconstrained-domain-~3e%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">unconstrained-domain-&gt;</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">range-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Constructs a contract that accepts a function, but makes no constraint
+on the function&rsquo;s domain. The <span class="RktVar">range-expr</span>s determine the number
+of results and the contract for each result.</div></p><p>Generally, this contract must be combined with another contract to
+ensure that the domain is actually known to be able to safely call the
+function itself.</p><p>For example, the contract</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._contract-out%29%29" class="RktStxLink" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ed%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._natural-number%2Fc%29%29" class="RktValLink" data-pltdoc="x">natural-number/c</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">proc</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._unconstrained-domain-~3e%29%29" class="RktStxLink" data-pltdoc="x">unconstrained-domain-&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>says that the function <span class="RktSym">f</span> accepts a natural number
+and a function. The domain of the function that <span class="RktSym">f</span>
+accepts must include a case for <span class="RktSym">size</span> arguments,
+meaning that <span class="RktSym">f</span> can safely supply <span class="RktSym">size</span>
+arguments to its input.</p><p>For example, the following is a definition of <span class="RktSym">f</span> that cannot
+be blamed using the above contract:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">g</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym">g</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._build-list%29%29" class="RktValLink" data-pltdoc="x">build-list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/contract/base..rkt)._predicate/c))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="function-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._predicate%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">predicate/c</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Use this contract to indicate that some function
+is a predicate. It is semantically equivalent to
+<span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span>.</div></p><p>This contract also includes an optimization so that functions returning
+<span class="RktVal">#t</span> from <span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-predicate-procedure~3f%29%29" class="RktValLink" data-pltdoc="x">struct-predicate-procedure?</a></span> are just returned directly, without
+being wrapped. This contract is used by <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fprovide..rkt%29._provide%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">provide/contract</a></span>&rsquo;s
+<span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> sub-form so that struct predicates end up not being wrapped.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/contract/base..rkt)._the-unsupplied-arg))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="function-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._the-unsupplied-arg%29%29" class="RktValDef RktValLink" data-pltdoc="x">the-unsupplied-arg</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="function-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._unsupplied-arg~3f%29%29" class="RktValLink" data-pltdoc="x">unsupplied-arg?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Used by <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ei%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span> (and <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3ed%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span>) to bind
+optional arguments that are not supplied by a call site.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/base..rkt)._unsupplied-arg~3f))"></a><span title="Provided from: racket/contract/base, racket/contract, racket | Package: base"><span class="RktSym"><a href="function-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._unsupplied-arg~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsupplied-arg?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A predicate to determine whether <span class="RktVar">v</span> is
+<span class="RktSym"><a href="function-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._the-unsupplied-arg%29%29" class="RktValLink" data-pltdoc="x">the-unsupplied-arg</a></span>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="data-structure-contracts.html" title="backward to &quot;8.1 Data-structure Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="parametric-contracts.html" title="forward to &quot;8.3 Parametric Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/futures.html b/clones/docs.racket-lang.org/reference/futures.html
new file mode 100644
index 00000000..0e493818
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/futures.html
@@ -0,0 +1,140 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>11.4&nbsp;Futures</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewselflink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.1&nbsp;</td><td><a href="threads.html" class="tocviewlink" data-pltdoc="x">Threads</a></td></tr><tr><td align="right">11.2&nbsp;</td><td><a href="all-sync.html" class="tocviewlink" data-pltdoc="x">Synchronization</a></td></tr><tr><td align="right">11.3&nbsp;</td><td><a href="thread-local-storage.html" class="tocviewlink" data-pltdoc="x">Thread-<wbr></wbr>Local Storage</a></td></tr><tr><td align="right">11.4&nbsp;</td><td><a href="futures.html" class="tocviewselflink" data-pltdoc="x">Futures</a></td></tr><tr><td align="right">11.5&nbsp;</td><td><a href="places.html" class="tocviewlink" data-pltdoc="x">Places</a></td></tr><tr><td align="right">11.6&nbsp;</td><td><a href="engine.html" class="tocviewlink" data-pltdoc="x">Engines</a></td></tr><tr><td align="right">11.7&nbsp;</td><td><a href="memory-order.html" class="tocviewlink" data-pltdoc="x">Machine Memory Order</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>11.4&nbsp;</td><td><a href="futures.html" class="tocviewselflink" data-pltdoc="x">Futures</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.4.1&nbsp;</td><td><a href="futures.html#%28part._.Creating_and_.Touching_.Futures%29" class="tocviewlink" data-pltdoc="x">Creating and Touching Futures</a></td></tr><tr><td align="right">11.4.2&nbsp;</td><td><a href="futures.html#%28part._.Future_.Semaphores%29" class="tocviewlink" data-pltdoc="x">Future Semaphores</a></td></tr><tr><td align="right">11.4.3&nbsp;</td><td><a href="futures.html#%28part._future-logging%29" class="tocviewlink" data-pltdoc="x">Future Performance Logging</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">11.4.1<tt>&nbsp;</tt></span><a href="futures.html#%28part._.Creating_and_.Touching_.Futures%29" class="tocsubseclink" data-pltdoc="x">Creating and Touching Futures</a></td></tr><tr><td><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._future%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">future</span></span></a></td></tr><tr><td><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">touch</span></span></a></td></tr><tr><td><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._futures-enabled~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">futures-<wbr></wbr>enabled?</span></span></a></td></tr><tr><td><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._current-future%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>future</span></span></a></td></tr><tr><td><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._future~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">future?</span></span></a></td></tr><tr><td><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._would-be-future%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">would-<wbr></wbr>be-<wbr></wbr>future</span></span></a></td></tr><tr><td><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._processor-count%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">processor-<wbr></wbr>count</span></span></a></td></tr><tr><td><a href="futures.html#%28form._%28%28lib._racket%2Ffuture..rkt%29._for%2Fasync%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>async</span></span></a></td></tr><tr><td><a href="futures.html#%28form._%28%28lib._racket%2Ffuture..rkt%29._for%2A%2Fasync%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>async</span></span></a></td></tr><tr><td><span class="tocsublinknumber">11.4.2<tt>&nbsp;</tt></span><a href="futures.html#%28part._.Future_.Semaphores%29" class="tocsubseclink" data-pltdoc="x">Future Semaphores</a></td></tr><tr><td><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._make-fsemaphore%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>fsemaphore</span></span></a></td></tr><tr><td><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fsemaphore?</span></span></a></td></tr><tr><td><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore-post%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fsemaphore-<wbr></wbr>post</span></span></a></td></tr><tr><td><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore-wait%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fsemaphore-<wbr></wbr>wait</span></span></a></td></tr><tr><td><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore-try-wait~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fsemaphore-<wbr></wbr>try-<wbr></wbr>wait?</span></span></a></td></tr><tr><td><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore-count%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fsemaphore-<wbr></wbr>count</span></span></a></td></tr><tr><td><span class="tocsublinknumber">11.4.3<tt>&nbsp;</tt></span><a href="futures.html#%28part._future-logging%29" class="tocsubseclink" data-pltdoc="x">Future Performance Logging</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="parameters.html" title="backward to &quot;11.3.2 Parameters&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="concurrency.html" title="up to &quot;11 Concurrency and Parallelism&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="places.html" title="forward to &quot;11.5 Places&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;futures&quot;">11.4<tt>&nbsp;</tt><a name="(part._futures)"></a><a name="(mod-path._racket/future)"></a>Futures</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=parallelism.html%23%2528part._effective-futures%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Parallelism with Futures</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces futures.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="futures.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/future</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="futures.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/future</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Currently, parallel support for <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._future%29%29" class="RktValLink" data-pltdoc="x">future</a></span> is enabled
+by default for Windows, Linux x86/x86_64, and Mac OS x86/x86_64. To
+enable support for other platforms, use <span class="nobreak"><span class="stt">--enable-futures</span></span> with
+<span class="stt">configure</span> when building Racket.</p></blockquote></blockquote></blockquote><p>The <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._future%29%29" class="RktValLink" data-pltdoc="x">future</a></span> and <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="RktValLink" data-pltdoc="x">touch</a></span> functions from
+<a href="futures.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/future</span></a> provide access to parallelism as supported
+by the hardware and operating system.  In contrast to <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span>,
+which provides concurrency for arbitrary computations without
+parallelism, <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._future%29%29" class="RktValLink" data-pltdoc="x">future</a></span> provides parallelism for limited
+computations. A <a name="(tech._future)"></a><span style="font-style: italic">future</span> executes its work in parallel (assuming that
+support for parallelism is available) until it detects an attempt to
+perform an operation that is too complex for the system to run safely in
+parallel. Similarly, work in a future is suspended if it depends in some
+way on the current continuation, such as raising an exception. A
+suspended computation for a future is resumed when <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="RktValLink" data-pltdoc="x">touch</a></span> is
+applied to the future.</p><p>&ldquo;Safe&rdquo; parallel execution of a future means that all operations
+provided by the system must be able to enforce contracts and produce
+results as documented. &ldquo;Safe&rdquo; does not preclude concurrent access to
+mutable data that is visible in the program.  For example, a computation
+in a future might use <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span> to modify a shared variable, in
+which case concurrent assignment to the variable can be visible in other
+futures and threads. Furthermore, guarantees about the visibility of
+effects and ordering are determined by the operating system and
+hardware&#8212;<wbr></wbr>which rarely support, for example, the guarantee of
+sequential consistency that is provided for <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span>-based
+concurrency; see also <a href="memory-order.html" data-pltdoc="x">Machine Memory Order</a>. At the same time, operations
+that seem obviously safe may
+have a complex enough implementation internally that they cannot run in
+parallel. See also <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=parallelism.html%23%2528part._effective-futures%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Parallelism with Futures</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a>.</p><p>A future never runs in parallel if all of the <a href="eval-model.html#%28tech._custodian%29" class="techoutside" data-pltdoc="x"><span class="techinside">custodians</span></a> that
+allow its creating thread to run are shut down. Such futures can
+execute through a call to <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="RktValLink" data-pltdoc="x">touch</a></span>, however.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Creating_and_Touching_Futures&quot;">11.4.1<tt>&nbsp;</tt><a name="(part._.Creating_and_.Touching_.Futures)"></a>Creating and Touching Futures</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/future..rkt)._future))"></a><span title="Provided from: racket/future, racket | Package: base"><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._future%29%29" class="RktValDef RktValLink" data-pltdoc="x">future</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thunk</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._future~3f%29%29" class="RktValLink" data-pltdoc="x">future?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/future..rkt)._touch))"></a><span title="Provided from: racket/future, racket | Package: base"><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="RktValDef RktValLink" data-pltdoc="x">touch</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._future~3f%29%29" class="RktValLink" data-pltdoc="x">future?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._future%29%29" class="RktValLink" data-pltdoc="x">future</a></span> procedure returns a future value that encapsulates
+<span class="RktVar">thunk</span>.  The <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="RktValLink" data-pltdoc="x">touch</a></span> function forces the evaluation of
+the <span class="RktVar">thunk</span> inside the given future, returning the values
+produced by <span class="RktVar">thunk</span>.  After <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="RktValLink" data-pltdoc="x">touch</a></span> forces the evaluation
+of a <span class="RktVar">thunk</span>, the resulting values are retained by the future
+in place of <span class="RktVar">thunk</span>, and additional <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="RktValLink" data-pltdoc="x">touch</a></span>es of the
+future return those values.</div></p><p>Between a call to <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._future%29%29" class="RktValLink" data-pltdoc="x">future</a></span> and <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="RktValLink" data-pltdoc="x">touch</a></span> for a given
+future, the given <span class="RktVar">thunk</span> may run speculatively in parallel to
+other computations, as described above.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._future%29%29" class="RktValLink" data-pltdoc="x">future</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="RktValLink" data-pltdoc="x">touch</a></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(7 3)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/future..rkt)._futures-enabled~3f))"></a><span title="Provided from: racket/future, racket | Package: base"><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._futures-enabled~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">futures-enabled?</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns whether parallel support for futures is enabled
+in the current Racket configuration.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/future..rkt)._current-future))"></a><span title="Provided from: racket/future, racket | Package: base"><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._current-future%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-future</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._future~3f%29%29" class="RktValLink" data-pltdoc="x">future?</a></span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns the descriptor of the future whose thunk execution is the
+current continuation; that is, if a future descriptor <span class="RktSym">f</span> is returned,
+<span class="RktPn">(</span><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="RktValLink" data-pltdoc="x">touch</a></span><span class="stt"> </span><span class="RktSym">f</span><span class="RktPn">)</span> will produce the result of the current continuation.
+If a future thunk itself uses <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="RktValLink" data-pltdoc="x">touch</a></span>,
+future-thunk executions can be nested, in which case the descriptor of
+the most immediately executing future is returned.  If the current
+continuation does not return to the <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="RktValLink" data-pltdoc="x">touch</a></span> of any future, the result is
+<span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/future..rkt)._future~3f))"></a><span title="Provided from: racket/future, racket | Package: base"><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._future~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">future?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a future value, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/future..rkt)._would-be-future))"></a><span title="Provided from: racket/future, racket | Package: base"><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._would-be-future%29%29" class="RktValDef RktValLink" data-pltdoc="x">would-be-future</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thunk</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._future~3f%29%29" class="RktValLink" data-pltdoc="x">future?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a future that never runs in parallel, but that consistently
+logs all potentially &ldquo;unsafe&rdquo; operations during the execution of
+the future&rsquo;s thunk (i.e., operations that interfere with parallel
+execution).</div></p><p>With a normal future, certain circumstances might prevent the logging
+of unsafe operations. For example, when executed with debug-level logging,</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="RktValLink" data-pltdoc="x">touch</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._future%29%29" class="RktValLink" data-pltdoc="x">future</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello1"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello2"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello3"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>might log three messages, one for each <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span>
+invocation.  However, if the <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="RktValLink" data-pltdoc="x">touch</a></span> is performed before the future
+has a chance to start running in parallel, the future thunk evaluates
+in the same manner as any ordinary thunk, and no unsafe operations
+are logged.  Replacing <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._future%29%29" class="RktValLink" data-pltdoc="x">future</a></span> with <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._would-be-future%29%29" class="RktValLink" data-pltdoc="x">would-be-future</a></span>
+ensures the logging of all three calls to <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/future..rkt)._processor-count))"></a><span title="Provided from: racket/future, racket | Package: base"><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._processor-count%29%29" class="RktValDef RktValLink" data-pltdoc="x">processor-count</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns the number of parallel computation units (e.g., processors or
+cores) that are available on the current machine.</div></p><p>This is the same binding as available from <a href="places.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/place</span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/future..rkt)._for/async))"></a><span title="Provided from: racket/future, racket | Package: base"><span class="RktSym"><a href="futures.html#%28form._%28%28lib._racket%2Ffuture..rkt%29._for%2Fasync%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/async</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/future..rkt)._for*/async))"></a><span title="Provided from: racket/future, racket | Package: base"><span class="RktSym"><a href="futures.html#%28form._%28%28lib._racket%2Ffuture..rkt%29._for%2A%2Fasync%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/async</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> and <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%29%29" class="RktStxLink" data-pltdoc="x">for*</a></span>, but each iteration of the
+<span class="RktVar">body</span> is executed in a separate <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._future%29%29" class="RktValLink" data-pltdoc="x">future</a></span>, and
+the futures may be <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="RktValLink" data-pltdoc="x">touch</a></span>ed in any order.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Future_Semaphores&quot;">11.4.2<tt>&nbsp;</tt><a name="(part._.Future_.Semaphores)"></a>Future Semaphores</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/future..rkt)._make-fsemaphore))"></a><span title="Provided from: racket/future, racket | Package: base"><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._make-fsemaphore%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-fsemaphore</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">init</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore~3f%29%29" class="RktValLink" data-pltdoc="x">fsemaphore?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">init</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates and returns a new <a name="(tech._future._semaphore)"></a><span style="font-style: italic">future semaphore</span> with the
+counter initially set to <span class="RktVar">init</span>.</div></p><p>A future semaphore is similar to a plain <a href="semaphore.html#%28tech._semaphore%29" class="techoutside" data-pltdoc="x"><span class="techinside">semaphore</span></a>, but
+future-semaphore operations can be performed safely in parallel (to synchronize
+parallel computations). In contrast, operations on plain <a href="semaphore.html#%28tech._semaphore%29" class="techoutside" data-pltdoc="x"><span class="techinside">semaphores</span></a>
+are not safe to perform in parallel, and they therefore prevent
+a computation from continuing in parallel.</p><p>Beware of trying to use an fsemaphore to implement a lock. A future
+may run concurrently and in parallel to other futures, but a future
+that is not demanded by a Racket thread can be suspended at any
+time&#8212;<wbr></wbr>such as just after it takes a lock and before it releases the
+lock. If you must share mutable data among futures, lock-free data
+structures are generally a better fit.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/future..rkt)._fsemaphore~3f))"></a><span title="Provided from: racket/future, racket | Package: base"><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">fsemaphore?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is an <a href="futures.html#%28tech._future._semaphore%29" class="techoutside" data-pltdoc="x"><span class="techinside">future semaphore</span></a>
+value, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/future..rkt)._fsemaphore-post))"></a><span title="Provided from: racket/future, racket | Package: base"><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore-post%29%29" class="RktValDef RktValLink" data-pltdoc="x">fsemaphore-post</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">fsema</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fsema</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore~3f%29%29" class="RktValLink" data-pltdoc="x">fsemaphore?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Increments the <a href="futures.html#%28tech._future._semaphore%29" class="techoutside" data-pltdoc="x"><span class="techinside">future semaphore</span></a>&rsquo;s internal counter and
+returns <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/future..rkt)._fsemaphore-wait))"></a><span title="Provided from: racket/future, racket | Package: base"><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore-wait%29%29" class="RktValDef RktValLink" data-pltdoc="x">fsemaphore-wait</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">fsema</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fsema</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore~3f%29%29" class="RktValLink" data-pltdoc="x">fsemaphore?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Blocks until the internal counter for <span class="RktVar">fsema</span> is non-zero.
+When the counter is non-zero, it is decremented and
+<span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore-wait%29%29" class="RktValLink" data-pltdoc="x">fsemaphore-wait</a></span> returns <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/future..rkt)._fsemaphore-try-wait~3f))"></a><span title="Provided from: racket/future, racket | Package: base"><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore-try-wait~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">fsemaphore-try-wait?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">fsema</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fsema</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore~3f%29%29" class="RktValLink" data-pltdoc="x">fsemaphore?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore-wait%29%29" class="RktValLink" data-pltdoc="x">fsemaphore-wait</a></span>, but <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore-try-wait~3f%29%29" class="RktValLink" data-pltdoc="x">fsemaphore-try-wait?</a></span>
+never blocks execution.  If <span class="RktVar">fsema</span>&rsquo;s internal counter is zero,
+<span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore-try-wait~3f%29%29" class="RktValLink" data-pltdoc="x">fsemaphore-try-wait?</a></span> returns <span class="RktVal">#f</span> immediately without
+decrementing the counter.  If <span class="RktVar">fsema</span>&rsquo;s counter is positive, it
+is decremented and <span class="RktVal">#t</span> is returned.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/future..rkt)._fsemaphore-count))"></a><span title="Provided from: racket/future, racket | Package: base"><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore-count%29%29" class="RktValDef RktValLink" data-pltdoc="x">fsemaphore-count</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">fsema</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fsema</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._fsemaphore~3f%29%29" class="RktValLink" data-pltdoc="x">fsemaphore?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVar">fsema</span>&rsquo;s current internal counter value.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;future-logging&quot;">11.4.3<tt>&nbsp;</tt><a name="(part._future-logging)"></a>Future Performance Logging</h5><p>Racket traces use logging (see <a href="logging.html" data-pltdoc="x">Logging</a>) extensively to
+report information about how futures are evaluated.  Logging output is
+useful for debugging the performance of programs that use futures.</p><p>Though textual log output can be viewed directly (or retrieved in
+code via <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=future-visualizer&amp;rel=futures-trace.html%23%2528form._%2528%2528lib._future-visualizer%252Ftrace..rkt%2529._trace-futures%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">trace-futures</a></span>), it is much
+easier to use the graphical profiler tool provided by
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=future-visualizer&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">future-visualizer</span></a>.</p><p>Future events are logged with the topic <span class="RktVal">'</span><span class="RktVal">future</span>.
+In addition to its string message, each event logged for a future has
+a data value that is an instance of a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=future-visualizer&amp;rel=futures-trace.html%23%2528def._%2528%2528lib._future-visualizer%252Ftrace..rkt%2529._future-event%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">future-event</a></span>
+<a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=future-visualizer&amp;rel=futures-trace.html%23%2528def._%2528%2528lib._future-visualizer%252Ftrace..rkt%2529._future-event%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">future-event</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">future-id</span><span class="hspace">&nbsp;</span><span class="RktSym">proc-id</span><span class="hspace">&nbsp;</span><span class="RktSym">action</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="time.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._time%29%29" class="RktStxLink" data-pltdoc="x">time</a></span><span class="hspace">&nbsp;</span><span class="RktSym">prim-name</span><span class="hspace">&nbsp;</span><span class="RktSym">user-data</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:prefab</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The <span class="RktSym">future-id</span> field is an exact integer that identifies a
+future, or it is <span class="RktVal">#f</span> when <span class="RktSym">action</span> is
+<span class="RktVal">'</span><span class="RktVal">missing</span>. The <span class="RktSym">future-id</span> field is particularly useful
+for correlating logged events.</p><p>The <span class="RktSym">proc-id</span> fields is an exact, non-negative integer that
+identifies a parallel process. Process 0 is the main Racket process,
+where all expressions other than future thunks evaluate.</p><p>The <span class="RktSym"><a href="time.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._time%29%29" class="RktStxLink" data-pltdoc="x">time</a></span> field is an inexact number that represents time in
+the same way as <span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-inexact-milliseconds%29%29" class="RktValLink" data-pltdoc="x">current-inexact-milliseconds</a></span>.</p><p>The <span class="RktSym">action</span> field is a symbol:</p><ul><li><p><span class="RktVal">'</span><span class="RktVal">create</span>: a future was created.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">complete</span>: a future&rsquo;s thunk evaluated successfully, so
+that <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="RktValLink" data-pltdoc="x">touch</a></span> will produce a value for the future
+immediately.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">start-work</span> and <span class="RktVal">'</span><span class="RktVal">end-work</span>: a particular
+process started and ended working on a particular future.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">start-0-work</span>: like <span class="RktVal">'</span><span class="RktVal">start-work</span>, but for a
+future thunk that for some structural reason could not be
+started in a process other than 0 (e.g., the thunk requires too
+much local storage to start).</p></li><li><p><span class="RktVal">'</span><span class="RktVal">start-overflow-work</span>: like <span class="RktVal">'</span><span class="RktVal">start-work</span>, where
+the future thunk&rsquo;s work was previously stopped due to an
+internal stack overflow.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">sync</span>: blocking (processes other than 0) or initiation
+of handing (process 0) for an &ldquo;unsafe&rdquo; operation in a future
+thunk&rsquo;s evaluation; the operation must run in process 0.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">block</span>: like <span class="RktVal">'</span><span class="RktVal">sync</span>, but for a part of
+evaluation that must be delayed until the future is
+<span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="RktValLink" data-pltdoc="x">touch</a></span>ed, because the evaluation may depend on the
+current continuation.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">touch</span> (never in process 0): like <span class="RktVal">'</span><span class="RktVal">sync</span> or
+<span class="RktVal">'</span><span class="RktVal">block</span>, but for a <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="RktValLink" data-pltdoc="x">touch</a></span> operation within a
+future thunk.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">overflow</span> (never in process 0): like <span class="RktVal">'</span><span class="RktVal">sync</span> or
+<span class="RktVal">'</span><span class="RktVal">block</span>, but for the case that a process encountered an
+internal stack overflow while evaluating a future thunk.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">result</span> or <span class="RktVal">'</span><span class="RktVal">abort</span>: waiting or handling for
+<span class="RktVal">'</span><span class="RktVal">sync</span>, <span class="RktVal">'</span><span class="RktVal">block</span>, or <span class="RktVal">'</span><span class="RktVal">touch</span> ended with
+a value or an error, respectively.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">suspend</span> (never in process 0): a process blocked by
+<span class="RktVal">'</span><span class="RktVal">sync</span>, <span class="RktVal">'</span><span class="RktVal">block</span>, or <span class="RktVal">'</span><span class="RktVal">touch</span> abandoned
+evaluation of a future; some other process may pick up the
+future later.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">touch-pause</span> and <span class="RktVal">'</span><span class="RktVal">touch-resume</span> (in process 0,
+only): waiting in <span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="RktValLink" data-pltdoc="x">touch</a></span> for a future whose thunk is
+being evaluated in another process.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">missing</span>: one or more events for the process were lost
+due to internal buffer limits before they could be reported,
+and the <span class="RktSym">time-id</span> field reports an upper limit on the time
+of the missing events; this kind of event is rare.</p></li></ul><p>Assuming no <span class="RktVal">'</span><span class="RktVal">missing</span> events, then <span class="RktVal">'</span><span class="RktVal">start-work</span>,
+<span class="RktVal">'</span><span class="RktVal">start-0-work</span>, <span class="RktVal">'</span><span class="RktVal">start-overflow-work</span> is always paired with <span class="RktVal">'</span><span class="RktVal">end-work</span>;
+<span class="RktVal">'</span><span class="RktVal">sync</span>, <span class="RktVal">'</span><span class="RktVal">block</span>, and <span class="RktVal">'</span><span class="RktVal">touch</span> are always paired
+with <span class="RktVal">'</span><span class="RktVal">result</span>, <span class="RktVal">'</span><span class="RktVal">abort</span>, or <span class="RktVal">'</span><span class="RktVal">suspend</span>; and
+<span class="RktVal">'</span><span class="RktVal">touch-pause</span> is always paired with <span class="RktVal">'</span><span class="RktVal">touch-resume</span>.</p><p>In process 0, some event pairs can be nested within other event pairs:
+<span class="RktVal">'</span><span class="RktVal">sync</span>, <span class="RktVal">'</span><span class="RktVal">block</span>, or <span class="RktVal">'</span><span class="RktVal">touch</span> with
+<span class="RktVal">'</span><span class="RktVal">result</span> or <span class="RktVal">'</span><span class="RktVal">abort</span>; <span class="RktVal">'</span><span class="RktVal">touch-pause</span> with
+<span class="RktVal">'</span><span class="RktVal">touch-resume</span>; and <span class="RktVal">'</span><span class="RktVal">start-work</span> with <span class="RktVal">'</span><span class="RktVal">end-work</span>.</p><p>A <span class="RktVal">'</span><span class="RktVal">block</span> in process 0 is generated when an unsafe operation
+is handled.  This type of event will contain a symbol in the
+<span class="RktSym">unsafe-op-name</span> field that is the name of the operation.  In all
+other cases, this field contains <span class="RktVal">#f</span>.</p><p>The <span class="RktSym">prim-name</span> field will always be <span class="RktVal">#f</span> unless the event occurred
+on process 0 and its <span class="RktSym">action</span> is either <span class="RktVal">'</span><span class="RktVal">block</span> or <span class="RktVal">'</span><span class="RktVal">sync</span>.  If
+these conditions are met, <span class="RktSym">prim-name</span> will contain the name
+of the Racket primitive which required the future to synchronize with the runtime
+thread (represented as a symbol).</p><p>The <span class="RktSym">user-data</span> field may take on a number of different
+values depending on both the <span class="RktSym">action</span> and <span class="RktSym">prim-name</span> fields:</p><ul><li><p><span class="RktVal">'</span><span class="RktVal">touch</span> on process 0: contains the integer ID of the future
+ being touched.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">sync</span> and <span class="RktSym">prim-name</span> is <span class="RktVal">'</span><span class="RktVal">|allocate memory|</span>:
+ The size (in bytes) of the requested allocation.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">sync</span> and <span class="RktSym">prim-name</span> is <span class="RktVal">'</span><span class="RktVal">jit_on_demand</span>:
+ The runtime thread is performing a JIT compilation on behalf of the
+ future <span class="RktSym">future-id</span>.  The field contains the name of the function
+ being JIT compiled (as a symbol).</p></li><li><p><span class="RktVal">'</span><span class="RktVal">create</span>: A new future was created.  The field contains the integer ID
+ of the newly created future.</p></li></ul><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="parameters.html" title="backward to &quot;11.3.2 Parameters&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="concurrency.html" title="up to &quot;11 Concurrency and Parallelism&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="places.html" title="forward to &quot;11.5 Places&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/garbagecollection.html b/clones/docs.racket-lang.org/reference/garbagecollection.html
new file mode 100644
index 00000000..a797522a
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/garbagecollection.html
@@ -0,0 +1,101 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>16.4&nbsp;Garbage Collection</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewselflink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.1&nbsp;</td><td><a href="weakbox.html" class="tocviewlink" data-pltdoc="x">Weak Boxes</a></td></tr><tr><td align="right">16.2&nbsp;</td><td><a href="ephemerons.html" class="tocviewlink" data-pltdoc="x">Ephemerons</a></td></tr><tr><td align="right">16.3&nbsp;</td><td><a href="willexecutor.html" class="tocviewlink" data-pltdoc="x">Wills and Executors</a></td></tr><tr><td align="right">16.4&nbsp;</td><td><a href="garbagecollection.html" class="tocviewselflink" data-pltdoc="x">Garbage Collection</a></td></tr><tr><td align="right">16.5&nbsp;</td><td><a href="phantom-bytes.html" class="tocviewlink" data-pltdoc="x">Phantom Byte Strings</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="garbagecollection.html#%28def._%28%28quote._~23~25kernel%29._collect-garbage%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">collect-<wbr></wbr>garbage</span></span></a></td></tr><tr><td><a href="garbagecollection.html#%28def._%28%28quote._~23~25kernel%29._current-memory-use%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>memory-<wbr></wbr>use</span></span></a></td></tr><tr><td><a href="garbagecollection.html#%28def._%28%28quote._~23~25kernel%29._dump-memory-stats%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dump-<wbr></wbr>memory-<wbr></wbr>stats</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="willexecutor.html" title="backward to &quot;16.3 Wills and Executors&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="memory.html" title="up to &quot;16 Memory Management&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="phantom-bytes.html" title="forward to &quot;16.5 Phantom Byte Strings&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;garbagecollection&quot;">16.4<tt>&nbsp;</tt><a name="(part._garbagecollection)"></a>Garbage Collection</h4><p>Set the <a name="(idx._(gentag._448._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLTDISABLEGC</span> environment variable (to any
+value) before Racket starts to disable <a href="eval-model.html#%28tech._garbage._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">garbage collection</span></a>. Set
+the <a name="(idx._(gentag._449._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_INCREMENTAL_GC</span> environment variable
+to a value that starts with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">1</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">y</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Y</span><span class="hspace"></span></span> to
+request incremental mode at all times, but calling
+<span class="RktPn">(</span><span class="RktSym"><a href="garbagecollection.html#%28def._%28%28quote._~23~25kernel%29._collect-garbage%29%29" class="RktValLink" data-pltdoc="x">collect-garbage</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">incremental</span><span class="RktPn">)</span> in a program with a periodic
+task is generally a better mechanism for requesting incremental mode.
+Set the <a name="(idx._(gentag._450._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_INCREMENTAL_GC</span> environment variable
+to a value that starts with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">0</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">n</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">N</span><span class="hspace"></span></span> to
+disable incremental-mode requests.</p><p>Each garbage collection logs a message (see <a href="logging.html" data-pltdoc="x">Logging</a>) at the
+<span class="RktVal">'</span><span class="RktVal">debug</span> level with topic <span class="RktVal">'</span><span class="RktVal">GC</span>. In the <a href="implementations.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a> and <a href="implementations.html#%28tech._3m%29" class="techoutside" data-pltdoc="x"><span class="techinside">3m</span></a>
+implementations of Racket, &ldquo;major&rdquo; collections are also logged at the
+<span class="RktVal">'</span><span class="RktVal">debug</span> level with the topic <span class="RktVal">'</span><span class="RktVal">GC:major</span>. In the <a href="implementations.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a>
+and <a href="implementations.html#%28tech._3m%29" class="techoutside" data-pltdoc="x"><span class="techinside">3m</span></a> implementations of Racket, the data portion of the message is an
+instance of a <a name="(idx._(gentag._451._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym">gc-info</span> <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure type
+with 10 fields as follows, but future versions of Racket may use a
+<span class="RktSym">gc-info</span> <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure with additional fields:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">gc-info</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mode</span><span class="hspace">&nbsp;</span><span class="RktSym">pre-amount</span><span class="hspace">&nbsp;</span><span class="RktSym">pre-admin-amount</span><span class="hspace">&nbsp;</span><span class="RktSym">code-amount</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">post-amount</span><span class="hspace">&nbsp;</span><span class="RktSym">post-admin-amount</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">start-process-time</span><span class="hspace">&nbsp;</span><span class="RktSym">end-process-time</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">start-time</span><span class="hspace">&nbsp;</span><span class="RktSym">end-time</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:prefab</span><span class="RktPn">)</span></td></tr></table></blockquote><ul><li><p>The <span class="RktSym">mode</span> field is a symbol <span class="RktVal">'</span><span class="RktVal">major</span>,
+<span class="RktVal">'</span><span class="RktVal">minor</span>, or <span class="RktVal">'</span><span class="RktVal">incremental</span>; <span class="RktVal">'</span><span class="RktVal">major</span>
+indicates a collection that inspects all memory,
+<span class="RktVal">'</span><span class="RktVal">minor</span> indicates collection that mostly inspects just
+recent allocations, and <span class="RktVal">'</span><span class="RktVal">incremental</span> indicates a minor
+collection that performs extra work toward the next major
+collection.</p><p class="SHistory">Changed in version 6.3.0.7 of package <span class="stt">base</span>: Changed first field from a
+boolean (<span class="RktVal">#t</span> for
+<span class="RktVal">'</span><span class="RktVal">major</span>, <span class="RktVal">#f</span>
+for <span class="RktVal">'</span><span class="RktVal">minor</span>) to a
+mode symbol.</p></li><li><p>The <span class="RktSym">pre-amount</span> field reports place-local memory use
+(i.e., not counting the memory use of child places) in bytes at
+the time that the <a href="eval-model.html#%28tech._garbage._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">garbage collection</span></a> started. Additional
+bytes registered via <span class="RktSym"><a href="phantom-bytes.html#%28def._%28%28quote._~23~25kernel%29._make-phantom-bytes%29%29" class="RktValLink" data-pltdoc="x">make-phantom-bytes</a></span> are included.</p></li><li><p>The <span class="RktSym">pre-admin-amount</span> is a larger number that includes
+memory use for the garbage collector&rsquo;s overhead, such as space
+on memory pages that are mapped but not currently used.</p></li><li><p>The <span class="RktSym">code-amount</span> field reports additional memory use
+for generated native code (which is the same just before and
+after a garbage collection, since it is released via
+finalization).</p></li><li><p>The <span class="RktSym">post-amount</span> and <span class="RktSym">post-admin-amount</span> fields
+correspond to <span class="RktSym">pre-amount</span> and
+<span class="RktSym">pre-admin-amount</span>, but after garbage collection. In
+typical configurations, the difference between
+<span class="RktSym">post-amount</span> and <span class="RktSym">pre-amount</span> contributes to
+<span class="RktSym">post-admin-amount</span>, since reclaimed pages tend to stay
+in reserve with the expectation that they&rsquo;ll be needed again
+(but the pages are released if multiple collections pass
+without need for the pages).</p></li><li><p>The <span class="RktSym">start-process-time</span> and <span class="RktSym">end-process-time</span>
+fields report processor time (in the sense of
+<span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-process-milliseconds%29%29" class="RktValLink" data-pltdoc="x">current-process-milliseconds</a></span>) at the start and end of
+garbage collection. The difference between the times is the
+processor time consumed by collection.</p></li><li><p>The <span class="RktSym">start-time</span> and <span class="RktSym">end-time</span> fields report
+real time (in the sense of
+<span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-inexact-milliseconds%29%29" class="RktValLink" data-pltdoc="x">current-inexact-milliseconds</a></span>) at the start and end of
+garbage collection. The difference between the times is the
+real time consumed by garbage collection.</p></li></ul><p>The format of the logged message&rsquo;s text is subject to change.
+Currently, after a prefix that indicates the <a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">place</span></a> and
+collection mode, the text has the format</p><blockquote><p><span class="sroman">&#8249;<span style="font-style: italic">used</span>&#8250;</span><span class="stt">(</span><span class="sroman">&#8249;<span style="font-style: italic">admin</span>&#8250;</span><span class="stt">)[</span><span class="sroman">&#8249;<span style="font-style: italic">code</span>&#8250;</span><span class="stt">]; free </span><span class="sroman">&#8249;<span style="font-style: italic">reclaimed</span>&#8250;</span><span class="stt">(</span><span class="sroman">&#8249;<span style="font-style: italic">adjust</span>&#8250;</span><span class="stt">) </span><span class="sroman">&#8249;<span style="font-style: italic">elapsed</span>&#8250;</span><span class="stt"> @ </span><span class="sroman">&#8249;<span style="font-style: italic">timestamp</span>&#8250;</span></p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="sroman">&#8249;<span style="font-style: italic">used</span>&#8250;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>Collectable memory in use just prior to garbage collection</p></td></tr><tr><td><p><span class="sroman">&#8249;<span style="font-style: italic">admin</span>&#8250;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>Additional memory used as to manage collectable memory</p></td></tr><tr><td><p><span class="sroman">&#8249;<span style="font-style: italic">code</span>&#8250;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>Additional memory used for generated machine code</p></td></tr><tr><td><p><span class="sroman">&#8249;<span style="font-style: italic">reclaimed</span>&#8250;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>Collectable memory reclaimed by garbage collection</p></td></tr><tr><td><p><span class="sroman">&#8249;<span style="font-style: italic">adjust</span>&#8250;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>Negation of change to administrative memory minus <span class="sroman">&#8249;<span style="font-style: italic">reclaimed</span>&#8250;</span></p></td></tr><tr><td><p><span class="sroman">&#8249;<span style="font-style: italic">elapsed</span>&#8250;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>Processor time used to perform garbage collection</p></td></tr><tr><td><p><span class="sroman">&#8249;<span style="font-style: italic">timestamp</span>&#8250;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>Processor time since startup of garbage collection&rsquo;s start</p></td></tr></table></blockquote><p class="SHistory">Changed in version 6.3.0.7 of package <span class="stt">base</span>: Added <span class="stt">PLT_INCREMENTAL_GC</span>.<br/>Changed in version 7.6.0.9: Added major-collection logging for the topic <span class="RktVal">'</span><span class="RktVal">GC:major</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._collect-garbage))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="garbagecollection.html#%28def._%28%28quote._~23~25kernel%29._collect-garbage%29%29" class="RktValDef RktValLink" data-pltdoc="x">collect-garbage</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">request</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">request</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">major</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">minor</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">incremental</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">major</span></td></tr></table></blockquote></div><div class="SIntrapara">Requests an immediate <a href="eval-model.html#%28tech._garbage._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">garbage collection</span></a> or requests a
+garbage-collection mode, depending on <span class="RktVar">request</span>:</div></p><ul><li><p><span class="RktVal">'</span><span class="RktVal">major</span> &#8212;<wbr></wbr> Forces a &ldquo;major&rdquo; collection, which
+inspects all memory. Some effectively unreachable data may
+remain uncollected, because the collector cannot prove that it
+is unreachable.</p><p>This mode of <span class="RktSym"><a href="garbagecollection.html#%28def._%28%28quote._~23~25kernel%29._collect-garbage%29%29" class="RktValLink" data-pltdoc="x">collect-garbage</a></span> procedure provides some
+control over the timing of collections, but garbage will
+obviously be collected even if this procedure is never
+called&#8212;<wbr></wbr>unless garbage collection is disabled by setting
+<span class="stt">PLTDISABLEGC</span>.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">minor</span> &#8212;<wbr></wbr> Requests a &ldquo;minor&rdquo; collection, which
+mostly inspects only recent allocations. If minor collection is
+not supported (e.g., when <span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">gc</span><span class="RktPn">)</span> returns
+<span class="RktVal">'</span><span class="RktVal">cgc</span>) or if the next collection must be a major
+collection, no collection is performed. More generally, minor collections
+triggered by <span class="RktPn">(</span><span class="RktSym"><a href="garbagecollection.html#%28def._%28%28quote._~23~25kernel%29._collect-garbage%29%29" class="RktValLink" data-pltdoc="x">collect-garbage</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">minor</span><span class="RktPn">)</span> do not cause
+major collections any sooner than they would occur otherwise.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">incremental</span> &#8212;<wbr></wbr> Does not request an immediate
+collection, but requests extra effort going forward to avoid
+major collections, even if it requires more work per minor
+collection to incrementally perform the work of a major
+collection. This incremental-mode request expires at the next
+major collection.</p><p>The intent of incremental mode is to significantly reduce pause
+times due to major collections, but incremental mode may imply
+longer minor-collection times and higher memory use. Currently,
+incremental mode is only meaningful for <a href="implementations.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a> and <a href="implementations.html#%28tech._3m%29" class="techoutside" data-pltdoc="x"><span class="techinside">3m</span></a>
+Racket implementations; it has no effect in
+other Racket implementations.</p><p>If the <span class="stt">PLT_INCREMENTAL_GC</span> environment variable&rsquo;s value
+starts with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">0</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">n</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">N</span><span class="hspace"></span></span> on
+start-up, then incremental-mode requests are ignored.</p></li></ul><p class="SHistory">Changed in version 6.3 of package <span class="stt">base</span>: Added the <span class="RktVar">request</span> argument.<br/>Changed in version 6.3.0.2: Added <span class="RktVal">'</span><span class="RktVal">incremental</span> mode.<br/>Changed in version 7.7.0.4: Added <span class="RktVal">'</span><span class="RktVal">incremental</span> effect
+for Racket <a href="implementations.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-memory-use))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="garbagecollection.html#%28def._%28%28quote._~23~25kernel%29._current-memory-use%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-memory-use</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">mode</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">cumulative</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian~3f%29%29" class="RktValLink" data-pltdoc="x">custodian?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns information about memory use:</div></p><ul><li><p>If <span class="RktVar">mode</span> is <span class="RktVal">#f</span> (the default), the result is an
+estimate of the number of bytes reachable from any custodian.</p></li><li><p>If <span class="RktVar">mode</span> is <span class="RktVal">'</span><span class="RktVal">cumulative</span>, returns an estimate
+of the total number of bytes allocated since start up,
+including bytes that have since been reclaimed by garbage
+collection.</p></li><li><p>If <span class="RktVar">mode</span> is a custodian, returns an estimate of the
+number of bytes of memory occupied by reachable data from
+<span class="RktVar">mode</span>. This estimate is calculated by the last garbage
+collection, and can be 0 if none occurred (or if none occurred
+since the given custodian was created). The
+<span class="RktSym"><a href="garbagecollection.html#%28def._%28%28quote._~23~25kernel%29._current-memory-use%29%29" class="RktValLink" data-pltdoc="x">current-memory-use</a></span> function does <span style="font-style: italic">not</span> perform
+a collection by itself; doing one before the call will
+generally decrease the result (or increase it from 0 if no
+collections happened yet).</p><p>When Racket is compiled without support for memory accounting,
+the estimate is the same as when <span class="RktVar">mode</span> is <span class="RktVal">#f</span>
+(i.e., all memory) for any individual custodian. See also
+<span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-memory-accounting-available~3f%29%29" class="RktValLink" data-pltdoc="x">custodian-memory-accounting-available?</a></span>.</p></li></ul><p>See also <span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._vector-set-performance-stats%21%29%29" class="RktValLink" data-pltdoc="x">vector-set-performance-stats!</a></span>.</p><p class="SHistory">Changed in version 6.6.0.3 of package <span class="stt">base</span>: Added <span class="RktVal">'</span><span class="RktVal">cumulative</span> mode.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._dump-memory-stats))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="garbagecollection.html#%28def._%28%28quote._~23~25kernel%29._dump-memory-stats%29%29" class="RktValDef RktValLink" data-pltdoc="x">dump-memory-stats</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Dumps information about memory usage to the low-level error port
+ or console.</div></p><p>Various combinations of <span class="RktVar">v</span> arguments can control the
+information in a dump. The information that is available depends on
+your Racket build; check the end of a dump from a particular build to
+see if it offers additional information; otherwise, all <span class="RktVar">v</span>s are
+ignored.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="willexecutor.html" title="backward to &quot;16.3 Wills and Executors&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="memory.html" title="up to &quot;16 Memory Management&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="phantom-bytes.html" title="forward to &quot;16.5 Phantom Byte Strings&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/generic-numbers.html b/clones/docs.racket-lang.org/reference/generic-numbers.html
new file mode 100644
index 00000000..7d2207f9
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/generic-numbers.html
@@ -0,0 +1,273 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.3.2&nbsp;Generic Numerics</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewselflink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.3.1&nbsp;</td><td><a href="number-types.html" class="tocviewlink" data-pltdoc="x">Number Types</a></td></tr><tr><td align="right">4.3.2&nbsp;</td><td><a href="generic-numbers.html" class="tocviewselflink" data-pltdoc="x">Generic Numerics</a></td></tr><tr><td align="right">4.3.3&nbsp;</td><td><a href="flonums.html" class="tocviewlink" data-pltdoc="x">Flonums</a></td></tr><tr><td align="right">4.3.4&nbsp;</td><td><a href="fixnums.html" class="tocviewlink" data-pltdoc="x">Fixnums</a></td></tr><tr><td align="right">4.3.5&nbsp;</td><td><a href="extflonums.html" class="tocviewlink" data-pltdoc="x">Extflonums</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_3&quot;);">&#9658;</a></td><td>4.3.2&nbsp;</td><td><a href="generic-numbers.html" class="tocviewselflink" data-pltdoc="x">Generic Numerics</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_3"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.3.2.1&nbsp;</td><td><a href="generic-numbers.html#%28part._.Arithmetic%29" class="tocviewlink" data-pltdoc="x">Arithmetic</a></td></tr><tr><td align="right">4.3.2.2&nbsp;</td><td><a href="generic-numbers.html#%28part._.Number_.Comparison%29" class="tocviewlink" data-pltdoc="x">Number Comparison</a></td></tr><tr><td align="right">4.3.2.3&nbsp;</td><td><a href="generic-numbers.html#%28part._.Powers_and_.Roots%29" class="tocviewlink" data-pltdoc="x">Powers and Roots</a></td></tr><tr><td align="right">4.3.2.4&nbsp;</td><td><a href="generic-numbers.html#%28part._.Trigonometric_.Functions%29" class="tocviewlink" data-pltdoc="x">Trigonometric Functions</a></td></tr><tr><td align="right">4.3.2.5&nbsp;</td><td><a href="generic-numbers.html#%28part._.Complex_.Numbers%29" class="tocviewlink" data-pltdoc="x">Complex Numbers</a></td></tr><tr><td align="right">4.3.2.6&nbsp;</td><td><a href="generic-numbers.html#%28part._.Bitwise_.Operations%29" class="tocviewlink" data-pltdoc="x">Bitwise Operations</a></td></tr><tr><td align="right">4.3.2.7&nbsp;</td><td><a href="generic-numbers.html#%28part._.Random_.Numbers%29" class="tocviewlink" data-pltdoc="x">Random Numbers</a></td></tr><tr><td align="right">4.3.2.8&nbsp;</td><td><a href="generic-numbers.html#%28part._.Other_.Randomness_.Utilities%29" class="tocviewlink" data-pltdoc="x">Other Randomness Utilities</a></td></tr><tr><td align="right">4.3.2.9&nbsp;</td><td><a href="generic-numbers.html#%28part._.Number--.String_.Conversions%29" class="tocviewlink" data-pltdoc="x">Number&ndash;String Conversions</a></td></tr><tr><td align="right">4.3.2.10&nbsp;</td><td><a href="generic-numbers.html#%28part._.Extra_.Constants_and_.Functions%29" class="tocviewlink" data-pltdoc="x">Extra Constants and Functions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">4.3.2.1<tt>&nbsp;</tt></span><a href="generic-numbers.html#%28part._.Arithmetic%29" class="tocsubseclink" data-pltdoc="x">Arithmetic</a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">+</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink"><span class="nobreak">-</span></span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">*</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2F%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">/</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._quotient%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">quotient</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._remainder%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remainder</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._quotient%2Fremainder%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">quotient/<span class="mywbr"> &nbsp;</span>remainder</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._modulo%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">modulo</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">add1</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sub1</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._abs%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">abs</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._max%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">max</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._min%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">min</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._gcd%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">gcd</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._lcm%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">lcm</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._round%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">round</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._floor%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">floor</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._ceiling%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">ceiling</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._truncate%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">truncate</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._numerator%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">numerator</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._denominator%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">denominator</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._rationalize%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">rationalize</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.3.2.2<tt>&nbsp;</tt></span><a href="generic-numbers.html#%28part._.Number_.Comparison%29" class="tocsubseclink" data-pltdoc="x">Number Comparison</a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">=</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">&lt;</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">&lt;=</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">&gt;</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">&gt;=</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.3.2.3<tt>&nbsp;</tt></span><a href="generic-numbers.html#%28part._.Powers_and_.Roots%29" class="tocsubseclink" data-pltdoc="x">Powers and Roots</a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sqrt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sqrt</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-sqrt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">integer-<wbr></wbr>sqrt</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-sqrt%2Fremainder%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">integer-<wbr></wbr>sqrt/<span class="mywbr"> &nbsp;</span>remainder</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">expt</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._exp%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exp</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._log%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">log</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.3.2.4<tt>&nbsp;</tt></span><a href="generic-numbers.html#%28part._.Trigonometric_.Functions%29" class="tocsubseclink" data-pltdoc="x">Trigonometric Functions</a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sin%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sin</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._cos%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cos</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._tan%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tan</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._asin%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">asin</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._acos%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">acos</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._atan%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">atan</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.3.2.5<tt>&nbsp;</tt></span><a href="generic-numbers.html#%28part._.Complex_.Numbers%29" class="tocsubseclink" data-pltdoc="x">Complex Numbers</a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._make-rectangular%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>rectangular</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._make-polar%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>polar</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._real-part%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">real-<wbr></wbr>part</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._imag-part%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imag-<wbr></wbr>part</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._magnitude%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">magnitude</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._angle%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">angle</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.3.2.6<tt>&nbsp;</tt></span><a href="generic-numbers.html#%28part._.Bitwise_.Operations%29" class="tocsubseclink" data-pltdoc="x">Bitwise Operations</a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-ior%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bitwise-<wbr></wbr>ior</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-and%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bitwise-<wbr></wbr>and</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-xor%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bitwise-<wbr></wbr>xor</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-not%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bitwise-<wbr></wbr>not</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-bit-set~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bitwise-<wbr></wbr>bit-<wbr></wbr>set?</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-bit-field%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bitwise-<wbr></wbr>bit-<wbr></wbr>field</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._arithmetic-shift%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">arithmetic-<wbr></wbr>shift</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">integer-<wbr></wbr>length</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.3.2.7<tt>&nbsp;</tt></span><a href="generic-numbers.html#%28part._.Random_.Numbers%29" class="tocsubseclink" data-pltdoc="x">Random Numbers</a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._random%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">random</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._random-seed%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">random-<wbr></wbr>seed</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._make-pseudo-random-generator%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>pseudo-<wbr></wbr>random-<wbr></wbr>generator</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pseudo-<wbr></wbr>random-<wbr></wbr>generator?</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._current-pseudo-random-generator%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>pseudo-<wbr></wbr>random-<wbr></wbr>generator</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator-~3evector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pseudo-<wbr></wbr>random-<wbr></wbr>generator-<wbr></wbr>&gt;vector</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._vector-~3epseudo-random-generator%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>&gt;pseudo-<wbr></wbr>random-<wbr></wbr>generator</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._vector-~3epseudo-random-generator%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>&gt;pseudo-<wbr></wbr>random-<wbr></wbr>generator!</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator-vector~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pseudo-<wbr></wbr>random-<wbr></wbr>generator-<wbr></wbr>vector?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.3.2.8<tt>&nbsp;</tt></span><a href="generic-numbers.html#%28part._.Other_.Randomness_.Utilities%29" class="tocsubseclink" data-pltdoc="x">Other Randomness Utilities</a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Frandom..rkt%29._crypto-random-bytes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">crypto-<wbr></wbr>random-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Frandom..rkt%29._random-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">random-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Frandom..rkt%29._random-sample%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">random-<wbr></wbr>sample</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.3.2.9<tt>&nbsp;</tt></span><a href="generic-numbers.html#%28part._.Number--.String_.Conversions%29" class="tocsubseclink" data-pltdoc="x">Number&ndash;String Conversions</a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._number-~3estring%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">number-<wbr></wbr>&gt;string</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._string-~3enumber%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>&gt;number</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._real-~3edecimal-string%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">real-<wbr></wbr>&gt;decimal-<wbr></wbr>string</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-bytes-~3einteger%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">integer-<wbr></wbr>bytes-<wbr></wbr>&gt;integer</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-~3einteger-bytes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">integer-<wbr></wbr>&gt;integer-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._floating-point-bytes-~3ereal%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">floating-<wbr></wbr>point-<wbr></wbr>bytes-<wbr></wbr>&gt;real</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._real-~3efloating-point-bytes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">real-<wbr></wbr>&gt;floating-<wbr></wbr>point-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._system-big-endian~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">system-<wbr></wbr>big-<wbr></wbr>endian?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.3.2.10<tt>&nbsp;</tt></span><a href="generic-numbers.html#%28part._.Extra_.Constants_and_.Functions%29" class="tocsubseclink" data-pltdoc="x">Extra Constants and Functions</a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pi</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi..f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pi.f</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._degrees-~3eradians%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">degrees-<wbr></wbr>&gt;radians</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._radians-~3edegrees%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">radians-<wbr></wbr>&gt;degrees</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._sqr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sqr</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._sgn%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sgn</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._conjugate%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">conjugate</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._sinh%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sinh</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._cosh%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cosh</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._tanh%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tanh</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._exact-round%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exact-<wbr></wbr>round</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._exact-floor%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exact-<wbr></wbr>floor</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._exact-ceiling%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exact-<wbr></wbr>ceiling</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._exact-truncate%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exact-<wbr></wbr>truncate</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._order-of-magnitude%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">order-<wbr></wbr>of-<wbr></wbr>magnitude</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._nan~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">nan?</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._infinite~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">infinite?</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._positive-integer~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">positive-<wbr></wbr>integer?</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._negative-integer~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">negative-<wbr></wbr>integer?</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._nonpositive-integer~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">nonpositive-<wbr></wbr>integer?</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._nonnegative-integer~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">nonnegative-<wbr></wbr>integer?</span></span></a></td></tr><tr><td><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._natural~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">natural?</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="number-types.html" title="backward to &quot;4.3.1 Number Types&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="numbers.html" title="up to &quot;4.3 Numbers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="flonums.html" title="forward to &quot;4.3.3 Flonums&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;generic-numbers&quot;">4.3.2<tt>&nbsp;</tt><a name="(part._generic-numbers)"></a>Generic Numerics</h5><p>Most Racket numeric operations work on any kind of number.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Arithmetic&quot;">4.3.2.1<tt>&nbsp;</tt><a name="(part._.Arithmetic)"></a>Arithmetic</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._+))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValDef RktValLink" data-pltdoc="x">+</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the sum of the <span class="RktVar">z</span>s, adding pairwise from left to
+ right. If no arguments are provided, the result is <span class="RktVal">0</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1.0</span><span class="hspace">&nbsp;</span><span class="RktVal">2+3i</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">8.0+3.0i</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._-))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValDef RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValDef RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span><span class="RktVar">w</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">w</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">When no <span class="RktVar">w</span>s are supplied, returns <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVal">0</span><span class="stt"> </span><span class="RktVar">z</span><span class="RktPn">)</span>.
+ Otherwise, returns the subtraction of the <span class="RktVar">w</span>s from <span class="RktVar">z</span>
+ working pairwise from left to right.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">3.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktVal">2+7i</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-2+7i</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the product of the <span class="RktVar">z</span>s, multiplying pairwise from left
+ to right. If no arguments are provided, the result is
+ <span class="RktVal">1</span>. Multiplying any number by exact <span class="RktVal">0</span> produces exact
+ <span class="RktVal">0</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">6</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">8.0</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">72.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1+2i</span><span class="hspace">&nbsp;</span><span class="RktVal">3+4i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-5+10i</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._/))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2F%29%29" class="RktValDef RktValLink" data-pltdoc="x">/</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2F%29%29" class="RktValDef RktValLink" data-pltdoc="x">/</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span><span class="RktVar">w</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">w</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">When no <span class="RktVar">w</span>s are supplied, returns <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2F%29%29" class="RktValLink" data-pltdoc="x">/</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVar">z</span><span class="RktPn">)</span>.
+ Otherwise, returns the division of <span class="RktVar">z</span> by the <span class="RktVar">w</span>s working
+ pairwise from left to right.</div></p><p>If <span class="RktVar">z</span> is exact <span class="RktVal">0</span> and no <span class="RktVar">w</span> is exact
+ <span class="RktVal">0</span>, then the result is exact <span class="RktVal">0</span>. If any <span class="RktVar">w</span> is
+ exact <span class="RktVal">0</span>, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3adivide-by-zero%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:divide-by-zero</a></span> exception is raised.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2F%29%29" class="RktValLink" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3/4</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2F%29%29" class="RktValLink" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktVal">81</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">9</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2F%29%29" class="RktValLink" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0.1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2F%29%29" class="RktValLink" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1+2i</span><span class="hspace">&nbsp;</span><span class="RktVal">3+4i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">11/25+2/25i</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._quotient))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._quotient%29%29" class="RktValDef RktValLink" data-pltdoc="x">quotient</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span><span class="RktVar">m</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">m</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._truncate%29%29" class="RktValLink" data-pltdoc="x">truncate</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2F%29%29" class="RktValLink" data-pltdoc="x">/</a></span><span class="stt"> </span><span class="RktVar">n</span><span class="stt"> </span><span class="RktVar">m</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._quotient%29%29" class="RktValLink" data-pltdoc="x">quotient</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._quotient%29%29" class="RktValLink" data-pltdoc="x">quotient</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span>0.0</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-3.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._quotient%29%29" class="RktValLink" data-pltdoc="x">quotient</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">quotient: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: +inf.0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._remainder))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._remainder%29%29" class="RktValDef RktValLink" data-pltdoc="x">remainder</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span><span class="RktVar">m</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">m</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVar">q</span> with the same sign as <span class="RktVar">n</span> such that</div></p><ul><li><p><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._abs%29%29" class="RktValLink" data-pltdoc="x">abs</a></span><span class="stt"> </span><span class="RktVar">q</span><span class="RktPn">)</span> is between <span class="RktVal">0</span> (inclusive) and <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._abs%29%29" class="RktValLink" data-pltdoc="x">abs</a></span><span class="stt"> </span><span class="RktVar">m</span><span class="RktPn">)</span> (exclusive), and</p></li><li><p><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVar">q</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="stt"> </span><span class="RktVar">m</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._quotient%29%29" class="RktValLink" data-pltdoc="x">quotient</a></span><span class="stt"> </span><span class="RktVar">n</span><span class="stt"> </span><span class="RktVar">m</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span> equals <span class="RktVar">n</span>.</p></li></ul><p>If <span class="RktVar">m</span> is exact <span class="RktVal">0</span>, the
+ <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3adivide-by-zero%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:divide-by-zero</a></span> exception is raised.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._remainder%29%29" class="RktValLink" data-pltdoc="x">remainder</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._remainder%29%29" class="RktValLink" data-pltdoc="x">remainder</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span>0.0</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-1.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._remainder%29%29" class="RktValLink" data-pltdoc="x">remainder</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10.0</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-3</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._remainder%29%29" class="RktValLink" data-pltdoc="x">remainder</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span>0</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-3</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._remainder%29%29" class="RktValLink" data-pltdoc="x">remainder</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">remainder: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: +inf.0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._quotient/remainder))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._quotient%2Fremainder%29%29" class="RktValDef RktValLink" data-pltdoc="x">quotient/remainder</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span><span class="RktVar">m</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">m</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._quotient%29%29" class="RktValLink" data-pltdoc="x">quotient</a></span><span class="stt"> </span><span class="RktVar">n</span><span class="stt"> </span><span class="RktVar">m</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._remainder%29%29" class="RktValLink" data-pltdoc="x">remainder</a></span><span class="stt"> </span><span class="RktVar">n</span><span class="stt"> </span><span class="RktVar">m</span><span class="RktPn">)</span><span class="RktPn">)</span>, but the
+ combination may be computed more efficiently than separate calls to
+ <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._quotient%29%29" class="RktValLink" data-pltdoc="x">quotient</a></span> and <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._remainder%29%29" class="RktValLink" data-pltdoc="x">remainder</a></span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._quotient%2Fremainder%29%29" class="RktValLink" data-pltdoc="x">quotient/remainder</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._modulo))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._modulo%29%29" class="RktValDef RktValLink" data-pltdoc="x">modulo</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span><span class="RktVar">m</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">m</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVar">q</span> with the same sign as <span class="RktVar">m</span> where</div></p><ul><li><p><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._abs%29%29" class="RktValLink" data-pltdoc="x">abs</a></span><span class="stt"> </span><span class="RktVar">q</span><span class="RktPn">)</span> is between <span class="RktVal">0</span> (inclusive) and <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._abs%29%29" class="RktValLink" data-pltdoc="x">abs</a></span><span class="stt"> </span><span class="RktVar">m</span><span class="RktPn">)</span> (exclusive), and</p></li><li><p>the difference between <span class="RktVar">q</span> and <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">n</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="stt"> </span><span class="RktVar">m</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._quotient%29%29" class="RktValLink" data-pltdoc="x">quotient</a></span><span class="stt"> </span><span class="RktVar">n</span><span class="stt"> </span><span class="RktVar">m</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span> is a multiple of <span class="RktVar">m</span>.</p></li></ul><p>If <span class="RktVar">m</span> is exact <span class="RktVal">0</span>, the
+ <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3adivide-by-zero%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:divide-by-zero</a></span> exception is raised.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._modulo%29%29" class="RktValLink" data-pltdoc="x">modulo</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._modulo%29%29" class="RktValLink" data-pltdoc="x">modulo</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span>0.0</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._modulo%29%29" class="RktValLink" data-pltdoc="x">modulo</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10.0</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-3</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-2.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._modulo%29%29" class="RktValLink" data-pltdoc="x">modulo</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span>0</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-3</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._modulo%29%29" class="RktValLink" data-pltdoc="x">modulo</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">modulo: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: +inf.0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._add1))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValDef RktValLink" data-pltdoc="x">add1</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVar">z</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._sub1))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValDef RktValLink" data-pltdoc="x">sub1</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">z</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._abs))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._abs%29%29" class="RktValDef RktValLink" data-pltdoc="x">abs</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns the absolute value of
+ <span class="RktVar">x</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._abs%29%29" class="RktValLink" data-pltdoc="x">abs</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._abs%29%29" class="RktValLink" data-pltdoc="x">abs</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._max))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._max%29%29" class="RktValDef RktValLink" data-pltdoc="x">max</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the largest of the <span class="RktVar">x</span>s, or <span class="RktVal">+nan.0</span> if any
+ <span class="RktVar">x</span> is <span class="RktVal">+nan.0</span>.  If any <span class="RktVar">x</span> is inexact, the
+ result is coerced to inexact.  See also <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._argmax%29%29" class="RktValLink" data-pltdoc="x">argmax</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._max%29%29" class="RktValLink" data-pltdoc="x">max</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._max%29%29" class="RktValLink" data-pltdoc="x">max</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3.0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._min))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._min%29%29" class="RktValDef RktValLink" data-pltdoc="x">min</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the smallest of the <span class="RktVar">x</span>s, or <span class="RktVal">+nan.0</span> if any
+ <span class="RktVar">x</span> is <span class="RktVal">+nan.0</span>.  If any <span class="RktVar">x</span> is inexact, the
+ result is coerced to inexact.  See also <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._argmin%29%29" class="RktValLink" data-pltdoc="x">argmin</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._min%29%29" class="RktValLink" data-pltdoc="x">min</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._min%29%29" class="RktValLink" data-pltdoc="x">min</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1.0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._gcd))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._gcd%29%29" class="RktValDef RktValLink" data-pltdoc="x">gcd</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._rational~3f%29%29" class="RktValLink" data-pltdoc="x">rational?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._rational~3f%29%29" class="RktValLink" data-pltdoc="x">rational?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <a name="(idx._(gentag._123._(lib._scribblings/reference/reference..scrbl)))"></a>greatest common divisor (a non-negative
+ number) of the <span class="RktVar">n</span>s; for non-integer <span class="RktVar">n</span>s, the result
+ is the <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._gcd%29%29" class="RktValLink" data-pltdoc="x">gcd</a></span> of the numerators divided
+ by the <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._lcm%29%29" class="RktValLink" data-pltdoc="x">lcm</a></span> of the denominators.
+ If no arguments are provided, the result
+ is <span class="RktVal">0</span>. If all arguments are zero, the result is zero.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._gcd%29%29" class="RktValLink" data-pltdoc="x">gcd</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._gcd%29%29" class="RktValLink" data-pltdoc="x">gcd</a></span><span class="hspace">&nbsp;</span><span class="RktVal">12</span><span class="hspace">&nbsp;</span><span class="RktVal">81.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._gcd%29%29" class="RktValLink" data-pltdoc="x">gcd</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1/2</span><span class="hspace">&nbsp;</span><span class="RktVal">1/3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1/6</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._lcm))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._lcm%29%29" class="RktValDef RktValLink" data-pltdoc="x">lcm</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._rational~3f%29%29" class="RktValLink" data-pltdoc="x">rational?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._rational~3f%29%29" class="RktValLink" data-pltdoc="x">rational?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <a name="(idx._(gentag._124._(lib._scribblings/reference/reference..scrbl)))"></a>least common multiple (a non-negative number)
+ of the <span class="RktVar">n</span>s; non-integer <span class="RktVar">n</span>s, the result is
+ the absolute value of the product divided by the
+ <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._gcd%29%29" class="RktValLink" data-pltdoc="x">gcd</a></span>. If no arguments are provided, the result is
+ <span class="RktVal">1</span>. If any argument is zero, the result is zero; furthermore,
+ if any argument is exact <span class="RktVal">0</span>, the result is exact <span class="RktVal">0</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._lcm%29%29" class="RktValLink" data-pltdoc="x">lcm</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._lcm%29%29" class="RktValLink" data-pltdoc="x">lcm</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">12.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._lcm%29%29" class="RktValLink" data-pltdoc="x">lcm</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1/2</span><span class="hspace">&nbsp;</span><span class="RktVal">2/3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._round))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._round%29%29" class="RktValDef RktValLink" data-pltdoc="x">round</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-i</span>nf.0</span><span class="hspace">&nbsp;</span><span class="RktVal">+nan.0</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the integer closest to <span class="RktVar">x</span>, resolving ties in favor of
+ an even number, but <span class="RktVal">+inf.0</span>, <span class="RktVal"><span class="nobreak">-i</span>nf.0</span>, and <span class="RktVal">+nan.0</span>
+ round to themselves.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._round%29%29" class="RktValLink" data-pltdoc="x">round</a></span><span class="hspace">&nbsp;</span><span class="RktVal">17/4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._round%29%29" class="RktValLink" data-pltdoc="x">round</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span>7/4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-4</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._round%29%29" class="RktValLink" data-pltdoc="x">round</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2.5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._round%29%29" class="RktValLink" data-pltdoc="x">round</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-2</span>.5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-2.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._round%29%29" class="RktValLink" data-pltdoc="x">round</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">+inf.0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._floor))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._floor%29%29" class="RktValDef RktValLink" data-pltdoc="x">floor</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-i</span>nf.0</span><span class="hspace">&nbsp;</span><span class="RktVal">+nan.0</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the largest integer that is no more than <span class="RktVar">x</span>, but
+ <span class="RktVal">+inf.0</span>, <span class="RktVal"><span class="nobreak">-i</span>nf.0</span>, and <span class="RktVal">+nan.0</span> floor to
+ themselves.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._floor%29%29" class="RktValLink" data-pltdoc="x">floor</a></span><span class="hspace">&nbsp;</span><span class="RktVal">17/4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._floor%29%29" class="RktValLink" data-pltdoc="x">floor</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span>7/4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._floor%29%29" class="RktValLink" data-pltdoc="x">floor</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2.5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._floor%29%29" class="RktValLink" data-pltdoc="x">floor</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-2</span>.5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-3.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._floor%29%29" class="RktValLink" data-pltdoc="x">floor</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">+inf.0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._ceiling))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._ceiling%29%29" class="RktValDef RktValLink" data-pltdoc="x">ceiling</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-i</span>nf.0</span><span class="hspace">&nbsp;</span><span class="RktVal">+nan.0</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the smallest integer that is at least as large as <span class="RktVar">x</span>,
+ but <span class="RktVal">+inf.0</span>, <span class="RktVal"><span class="nobreak">-i</span>nf.0</span>, and <span class="RktVal">+nan.0</span> ceiling to
+ themselves.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._ceiling%29%29" class="RktValLink" data-pltdoc="x">ceiling</a></span><span class="hspace">&nbsp;</span><span class="RktVal">17/4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._ceiling%29%29" class="RktValLink" data-pltdoc="x">ceiling</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span>7/4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-4</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._ceiling%29%29" class="RktValLink" data-pltdoc="x">ceiling</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2.5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._ceiling%29%29" class="RktValLink" data-pltdoc="x">ceiling</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-2</span>.5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-2.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._ceiling%29%29" class="RktValLink" data-pltdoc="x">ceiling</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">+inf.0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._truncate))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._truncate%29%29" class="RktValDef RktValLink" data-pltdoc="x">truncate</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-i</span>nf.0</span><span class="hspace">&nbsp;</span><span class="RktVal">+nan.0</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the integer farthest from <span class="RktVal">0</span> that is not farther from
+ <span class="RktVal">0</span> than <span class="RktVar">x</span>, but <span class="RktVal">+inf.0</span>, <span class="RktVal"><span class="nobreak">-i</span>nf.0</span>, and
+ <span class="RktVal">+nan.0</span> truncate to themselves.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._truncate%29%29" class="RktValLink" data-pltdoc="x">truncate</a></span><span class="hspace">&nbsp;</span><span class="RktVal">17/4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._truncate%29%29" class="RktValLink" data-pltdoc="x">truncate</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span>7/4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-4</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._truncate%29%29" class="RktValLink" data-pltdoc="x">truncate</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2.5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._truncate%29%29" class="RktValLink" data-pltdoc="x">truncate</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-2</span>.5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-2.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._truncate%29%29" class="RktValLink" data-pltdoc="x">truncate</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">+inf.0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._numerator))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._numerator%29%29" class="RktValDef RktValLink" data-pltdoc="x">numerator</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">q</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">q</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._rational~3f%29%29" class="RktValLink" data-pltdoc="x">rational?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Coerces <span class="RktVar">q</span> to an exact number, finds the numerator of the
+ number expressed in its simplest fractional form, and returns this
+ number coerced to the exactness of <span class="RktVar">q</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._numerator%29%29" class="RktValLink" data-pltdoc="x">numerator</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._numerator%29%29" class="RktValLink" data-pltdoc="x">numerator</a></span><span class="hspace">&nbsp;</span><span class="RktVal">17/4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">17</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._numerator%29%29" class="RktValLink" data-pltdoc="x">numerator</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2.3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2589569785738035.0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._denominator))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._denominator%29%29" class="RktValDef RktValLink" data-pltdoc="x">denominator</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">q</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">q</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._rational~3f%29%29" class="RktValLink" data-pltdoc="x">rational?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Coerces <span class="RktVar">q</span> to an exact number, finds the denominator of the
+ number expressed in its simplest fractional form, and returns this
+ number coerced to the exactness of <span class="RktVar">q</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._denominator%29%29" class="RktValLink" data-pltdoc="x">denominator</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._denominator%29%29" class="RktValLink" data-pltdoc="x">denominator</a></span><span class="hspace">&nbsp;</span><span class="RktVal">17/4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._denominator%29%29" class="RktValLink" data-pltdoc="x">denominator</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2.3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1125899906842624.0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._rationalize))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._rationalize%29%29" class="RktValDef RktValLink" data-pltdoc="x">rationalize</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktVar">tolerance</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">tolerance</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Among the real numbers within <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._abs%29%29" class="RktValLink" data-pltdoc="x">abs</a></span><span class="stt"> </span><span class="RktVar">tolerance</span><span class="RktPn">)</span> of <span class="RktVar">x</span>,
+ returns the one corresponding to an exact number whose
+ <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._denominator%29%29" class="RktValLink" data-pltdoc="x">denominator</a></span> is the smallest.  If multiple integers are within
+ <span class="RktVar">tolerance</span> of <span class="RktVar">x</span>, the one closest to <span class="RktVal">0</span> is
+ used.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._rationalize%29%29" class="RktValLink" data-pltdoc="x">rationalize</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1/4</span><span class="hspace">&nbsp;</span><span class="RktVal">1/10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1/3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._rationalize%29%29" class="RktValLink" data-pltdoc="x">rationalize</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span>/4</span><span class="hspace">&nbsp;</span><span class="RktVal">1/10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-1/3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._rationalize%29%29" class="RktValLink" data-pltdoc="x">rationalize</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1/4</span><span class="hspace">&nbsp;</span><span class="RktVal">1/4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._rationalize%29%29" class="RktValLink" data-pltdoc="x">rationalize</a></span><span class="hspace">&nbsp;</span><span class="RktVal">11/40</span><span class="hspace">&nbsp;</span><span class="RktVal">1/4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1/2</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Number_Comparison&quot;">4.3.2.2<tt>&nbsp;</tt><a name="(part._.Number_.Comparison)"></a>Number Comparison</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._~3d))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValDef RktValLink" data-pltdoc="x">=</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span><span class="RktVar">w</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">w</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns
+ <span class="RktVal">#t</span> if all of the arguments are numerically equal,
+ <span class="RktVal">#f</span> otherwise.  An inexact number is numerically equal to an
+ exact number when the exact coercion of the inexact number is the
+ exact number. Also, <span class="RktVal">0.0</span> and <span class="RktVal"><span class="nobreak">-0</span>.0</span> are numerically
+ equal, but <span class="RktVal">+nan.0</span> is not numerically equal to itself.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2+3i</span><span class="hspace">&nbsp;</span><span class="RktVal">2+3i</span><span class="hspace">&nbsp;</span><span class="RktVal">2+3i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._~3c))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValDef RktValLink" data-pltdoc="x">&lt;</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktVar">y</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">y</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktVal">#t</span> if
+ the arguments in the given order are strictly increasing,
+ <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">+nan.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._~3c~3d))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c~3d%29%29" class="RktValDef RktValLink" data-pltdoc="x">&lt;=</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktVar">y</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">y</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktVal">#t</span>
+ if the arguments in the given order are non-decreasing,
+ <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c~3d%29%29" class="RktValLink" data-pltdoc="x">&lt;=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c~3d%29%29" class="RktValLink" data-pltdoc="x">&lt;=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._~3e))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e%29%29" class="RktValDef RktValLink" data-pltdoc="x">&gt;</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktVar">y</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">y</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktVal">#t</span> if
+ the arguments in the given order are strictly decreasing,
+ <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e%29%29" class="RktValLink" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e%29%29" class="RktValLink" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e%29%29" class="RktValLink" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e%29%29" class="RktValLink" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+nan.0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._~3e~3d))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e~3d%29%29" class="RktValDef RktValLink" data-pltdoc="x">&gt;=</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktVar">y</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">y</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktVal">#t</span>
+ if the arguments in the given order are non-increasing,
+ <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e~3d%29%29" class="RktValLink" data-pltdoc="x">&gt;=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e~3d%29%29" class="RktValLink" data-pltdoc="x">&gt;=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Powers_and_Roots&quot;">4.3.2.3<tt>&nbsp;</tt><a name="(part._.Powers_and_.Roots)"></a>Powers and Roots</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._sqrt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sqrt%29%29" class="RktValDef RktValLink" data-pltdoc="x">sqrt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the principal <a name="(idx._(gentag._125._(lib._scribblings/reference/reference..scrbl)))"></a>square root of <span class="RktVar">z</span>.  The
+ result is exact if <span class="RktVar">z</span> is exact and <span class="RktVar">z</span>&rsquo;s square root
+ is rational. See also <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-sqrt%29%29" class="RktValLink" data-pltdoc="x">integer-sqrt</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sqrt%29%29" class="RktValLink" data-pltdoc="x">sqrt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4/9</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2/3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sqrt%29%29" class="RktValLink" data-pltdoc="x">sqrt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1.4142135623730951</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sqrt%29%29" class="RktValLink" data-pltdoc="x">sqrt</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0+1i</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._integer-sqrt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-sqrt%29%29" class="RktValDef RktValLink" data-pltdoc="x">integer-sqrt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._complex~3f%29%29" class="RktValLink" data-pltdoc="x">complex?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._floor%29%29" class="RktValLink" data-pltdoc="x">floor</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sqrt%29%29" class="RktValLink" data-pltdoc="x">sqrt</a></span><span class="stt"> </span><span class="RktVar">n</span><span class="RktPn">)</span><span class="RktPn">)</span> for positive <span class="RktVar">n</span>.  The
+ result is exact if <span class="RktVar">n</span> is exact.  For
+ negative <span class="RktVar">n</span>, the result is <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-sqrt%29%29" class="RktValLink" data-pltdoc="x">integer-sqrt</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">0+1i</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-sqrt%29%29" class="RktValLink" data-pltdoc="x">integer-sqrt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-sqrt%29%29" class="RktValLink" data-pltdoc="x">integer-sqrt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-sqrt%29%29" class="RktValLink" data-pltdoc="x">integer-sqrt</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-4</span>.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0.0+2.0i</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-sqrt%29%29" class="RktValLink" data-pltdoc="x">integer-sqrt</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-4</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0+2i</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._integer-sqrt/remainder))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-sqrt%2Fremainder%29%29" class="RktValDef RktValLink" data-pltdoc="x">integer-sqrt/remainder</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._complex~3f%29%29" class="RktValLink" data-pltdoc="x">complex?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-sqrt%29%29" class="RktValLink" data-pltdoc="x">integer-sqrt</a></span><span class="stt"> </span><span class="RktVar">n</span><span class="RktPn">)</span> and <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">n</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-sqrt%29%29" class="RktValLink" data-pltdoc="x">integer-sqrt</a></span><span class="stt"> </span><span class="RktVar">n</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-sqrt%2Fremainder%29%29" class="RktValLink" data-pltdoc="x">integer-sqrt/remainder</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4.0</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">2.0</span></p></td></tr><tr><td><p><span class="RktRes">0.0</span></p></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-sqrt%2Fremainder%29%29" class="RktValLink" data-pltdoc="x">integer-sqrt/remainder</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._expt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValDef RktValLink" data-pltdoc="x">expt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span><span class="RktVar">w</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">w</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVar">z</span> raised to the power of <span class="RktVar">w</span>.</div></p><p>If <span class="RktVar">w</span> is
+ exact <span class="RktVal">0</span>, the result is exact <span class="RktVal">1</span>.
+ If <span class="RktVar">w</span> is <span class="RktVal">0.0</span> or <span class="RktVal"><span class="nobreak">-0</span>.0</span>  and <span class="RktVar">z</span> is a <a href="numbers.html#%28tech._real._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">real number</span></a>
+ other than exact <span class="RktVal">1</span> or <span class="RktVal">0</span>, the
+ result is <span class="RktVal">1.0</span> (even if <span class="RktVar">z</span> is <span class="RktVal">+nan.0</span>).</p><p>If <span class="RktVar">z</span> is exact <span class="RktVal">1</span>, the result is exact <span class="RktVal">1</span>.
+ If <span class="RktVar">z</span> is <span class="RktVal">1.0</span> and <span class="RktVar">w</span> is a <a href="numbers.html#%28tech._real._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">real number</span></a>, the
+ result is <span class="RktVal">1.0</span> (even if <span class="RktVar">w</span> is <span class="RktVal">+nan.0</span>).</p><p><div class="SIntrapara">If <span class="RktVar">z</span> is exact <span class="RktVal">0</span>, the result is as follows:
+</div><div class="SIntrapara"><ul class="compact"><li><p><span class="RktVar">w</span> is exact <span class="RktVal">0</span> &#8212;<wbr></wbr> result is <span class="RktVal">1</span></p></li><li><p><span class="RktVar">w</span> is <span class="RktVal">0.0</span> or <span class="RktVal"><span class="nobreak">-0</span>.0</span> &#8212;<wbr></wbr> result is <span class="RktVal">1.0</span></p></li><li><p>real part of <span class="RktVar">w</span> is negative &#8212;<wbr></wbr> the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3adivide-by-zero%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:divide-by-zero</a></span> exception is raised</p></li><li><p><span class="RktVar">w</span> is nonreal with a nonpositive real part  &#8212;<wbr></wbr> the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3adivide-by-zero%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:divide-by-zero</a></span> exception is raised</p></li><li><p><span class="RktVar">w</span> is <span class="RktVal">+nan.0</span> &#8212;<wbr></wbr> result is <span class="RktVal">+nan.0</span></p></li><li><p>otherwise &#8212;<wbr></wbr> result is <span class="RktVal">0</span></p></li></ul></div></p><p><div class="SIntrapara">If <span class="RktVar">w</span> is exact <span class="RktVal">1/2</span>, the result is the same as <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sqrt%29%29" class="RktValLink" data-pltdoc="x">sqrt</a></span><span class="stt"> </span><span class="RktVar">z</span><span class="RktPn">)</span>,
+which can be exact. Other fractional powers are not treated specially in this manner:
+</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">1/2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">0.5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">16</span><span class="hspace">&nbsp;</span><span class="RktVal">1/4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">16</span><span class="hspace">&nbsp;</span><span class="RktVal">0.25</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2.0</span></p></td></tr></table></blockquote></div></p></div></p><p><div class="SIntrapara">Further special cases when <span class="RktVar">w</span> is a <a href="numbers.html#%28tech._real._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">real number</span></a>:
+<span class="refelem"><span class="refcolumn"><span class="refcontent">These special cases correspond to <span class="stt">pow</span> in C99 [<a href="doc-bibliography.html#%28cite._.C99%29" data-pltdoc="x">C99</a>],
+except when <span class="RktVar">z</span> is negative and <span class="RktVar">w</span> is a not an
+integer.</span></span></span>
+</div><div class="SIntrapara"><ul class="compact"><li><p><div class="SIntrapara"><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="stt"> </span><span class="RktVal">0.0</span><span class="stt"> </span><span class="RktVar">w</span><span class="RktPn">)</span>:
+</div><div class="SIntrapara"><ul class="compact"><li><p><span class="RktVar">w</span> is negative &#8212;<wbr></wbr> result is <span class="RktVal">+inf.0</span></p></li><li><p><span class="RktVar">w</span> is positive &#8212;<wbr></wbr> result is <span class="RktVal">0.0</span></p></li></ul></div></p></li><li><p><div class="SIntrapara"><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="stt"> </span><span class="RktVal"><span class="nobreak">-0</span>.0</span><span class="stt"> </span><span class="RktVar">w</span><span class="RktPn">)</span>:
+</div><div class="SIntrapara"><ul class="compact"><li><p><div class="SIntrapara"><span class="RktVar">w</span> is negative:
+</div><div class="SIntrapara"><ul class="compact"><li><p><span class="RktVar">w</span> is an odd integer &#8212;<wbr></wbr> result is <span class="RktVal"><span class="nobreak">-i</span>nf.0</span></p></li><li><p><span class="RktVar">w</span> otherwise rational &#8212;<wbr></wbr> result is <span class="RktVal">+inf.0</span></p></li></ul></div></p></li><li><p><div class="SIntrapara"><span class="RktVar">w</span> is positive:
+</div><div class="SIntrapara"><ul class="compact"><li><p><span class="RktVar">w</span> is an odd integer &#8212;<wbr></wbr> result is <span class="RktVal"><span class="nobreak">-0</span>.0</span></p></li><li><p><span class="RktVar">w</span> otherwise rational &#8212;<wbr></wbr> result is <span class="RktVal">0.0</span></p></li></ul></div></p></li></ul></div></p></li><li><p><div class="SIntrapara"><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="stt"> </span><span class="RktVar">z</span><span class="stt"> </span><span class="RktVal"><span class="nobreak">-i</span>nf.0</span><span class="RktPn">)</span> for positive <span class="RktVar">z</span>:
+</div><div class="SIntrapara"><ul class="compact"><li><p><span class="RktVar">z</span> is less than <span class="RktVal">1.0</span> &#8212;<wbr></wbr> result is <span class="RktVal">+inf.0</span></p></li><li><p><span class="RktVar">z</span> is greater than <span class="RktVal">1.0</span> &#8212;<wbr></wbr> result is <span class="RktVal">0.0</span></p></li></ul></div></p></li><li><p><div class="SIntrapara"><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="stt"> </span><span class="RktVar">z</span><span class="stt"> </span><span class="RktVal">+inf.0</span><span class="RktPn">)</span> for positive <span class="RktVar">z</span>:
+</div><div class="SIntrapara"><ul class="compact"><li><p><span class="RktVar">z</span> is less than <span class="RktVal">1.0</span> &#8212;<wbr></wbr> result is <span class="RktVal">0.0</span></p></li><li><p><span class="RktVar">z</span> is greater than <span class="RktVal">1.0</span> &#8212;<wbr></wbr> result is <span class="RktVal">+inf.0</span></p></li></ul></div></p></li><li><p><div class="SIntrapara"><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="stt"> </span><span class="RktVal"><span class="nobreak">-i</span>nf.0</span><span class="stt"> </span><span class="RktVar">w</span><span class="RktPn">)</span> for integer <span class="RktVar">w</span>:
+</div><div class="SIntrapara"><ul class="compact"><li><p><div class="SIntrapara"><span class="RktVar">w</span> is negative:
+</div><div class="SIntrapara"><ul class="compact"><li><p><span class="RktVar">w</span> is odd &#8212;<wbr></wbr> result is <span class="RktVal"><span class="nobreak">-0</span>.0</span></p></li><li><p><span class="RktVar">w</span> is even &#8212;<wbr></wbr> result is <span class="RktVal">0.0</span></p></li></ul></div></p></li><li><p><div class="SIntrapara"><span class="RktVar">w</span> is positive:
+</div><div class="SIntrapara"><ul class="compact"><li><p><span class="RktVar">w</span> is odd &#8212;<wbr></wbr> result is <span class="RktVal"><span class="nobreak">-i</span>nf.0</span></p></li><li><p><span class="RktVar">w</span> is even &#8212;<wbr></wbr> result is <span class="RktVal">+inf.0</span></p></li></ul></div></p></li></ul></div></p></li><li><p><div class="SIntrapara"><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="stt"> </span><span class="RktVal">+inf.0</span><span class="stt"> </span><span class="RktVar">w</span><span class="RktPn">)</span>:
+</div><div class="SIntrapara"><ul class="compact"><li><p><span class="RktVar">w</span> is negative &#8212;<wbr></wbr> result is <span class="RktVal">0.0</span></p></li><li><p><span class="RktVar">w</span> is positive &#8212;<wbr></wbr> result is <span class="RktVal">+inf.0</span></p></li></ul></div></p></li></ul></div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">8</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">0.5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._exp))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._exp%29%29" class="RktValDef RktValLink" data-pltdoc="x">exp</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns Euler&rsquo;s number raised to the power of <span class="RktVar">z</span>. The result
+ is normally inexact, but it is exact <span class="RktVal">1</span> when <span class="RktVar">z</span> is an
+ exact <span class="RktVal">0</span>. See also <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._exp%29%29" class="RktValLink" data-pltdoc="x">exp</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2.718281828459045</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._exp%29%29" class="RktValLink" data-pltdoc="x">exp</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2+3i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-7.315110094901103+1.0427436562359045i</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._exp%29%29" class="RktValLink" data-pltdoc="x">exp</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._log))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._log%29%29" class="RktValDef RktValLink" data-pltdoc="x">log</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">b</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._exp%29%29" class="RktValLink" data-pltdoc="x">exp</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the natural logarithm of <span class="RktVar">z</span>.  The result is normally
+ inexact, but it is exact <span class="RktVal">0</span> when <span class="RktVar">z</span> is an exact
+ <span class="RktVal">1</span>. When <span class="RktVar">z</span> is exact <span class="RktVal">0</span>,
+ <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3adivide-by-zero%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:divide-by-zero</a></span> exception is raised.</div></p><p>If <span class="RktVar">b</span> is provided, it serves as an alternative
+ base. It is equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2F%29%29" class="RktValLink" data-pltdoc="x">/</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._log%29%29" class="RktValLink" data-pltdoc="x">log</a></span><span class="stt"> </span><span class="RktVar">z</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._log%29%29" class="RktValLink" data-pltdoc="x">log</a></span><span class="stt"> </span><span class="RktVar">b</span><span class="RktPn">)</span><span class="RktPn">)</span>, but
+ can potentially run faster. If <span class="RktVar">b</span> is exact
+ <span class="RktVal">1</span>, <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3adivide-by-zero%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:divide-by-zero</a></span> exception is raised.</p><p>Consider using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=math&amp;rel=flonum.html%23%2528def._%2528%2528lib._math%252Fflonum..rkt%2529._fllogb%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">fllogb</a></span> instead when accuracy is
+ important.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._log%29%29" class="RktValLink" data-pltdoc="x">log</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._exp%29%29" class="RktValLink" data-pltdoc="x">exp</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._log%29%29" class="RktValLink" data-pltdoc="x">log</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2+3i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1.2824746787307684+0.982793723247329i</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._log%29%29" class="RktValLink" data-pltdoc="x">log</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._log%29%29" class="RktValLink" data-pltdoc="x">log</a></span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._log%29%29" class="RktValLink" data-pltdoc="x">log</a></span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._log%29%29" class="RktValLink" data-pltdoc="x">log</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1.0</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.9.0.1 of package <span class="stt">base</span>: Added second argument for arbitrary bases.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Trigonometric_Functions&quot;">4.3.2.4<tt>&nbsp;</tt><a name="(part._.Trigonometric_.Functions)"></a>Trigonometric Functions</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._sin))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sin%29%29" class="RktValDef RktValLink" data-pltdoc="x">sin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the sine of <span class="RktVar">z</span>, where <span class="RktVar">z</span> is in radians. The
+ result is normally inexact, but it is exact <span class="RktVal">0</span> if <span class="RktVar">z</span>
+ is exact <span class="RktVal">0</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sin%29%29" class="RktValLink" data-pltdoc="x">sin</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3.14159</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2.65358979335273e-6</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sin%29%29" class="RktValLink" data-pltdoc="x">sin</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1.0+5.0i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">62.44551846769654+40.0921657779984i</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cos))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._cos%29%29" class="RktValDef RktValLink" data-pltdoc="x">cos</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the cosine of <span class="RktVar">z</span>, where <span class="RktVar">z</span> is in radians.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._cos%29%29" class="RktValLink" data-pltdoc="x">cos</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3.14159</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-0.9999999999964793</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._cos%29%29" class="RktValLink" data-pltdoc="x">cos</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1.0+5.0i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">40.09580630629883-62.43984868079963i</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._tan))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._tan%29%29" class="RktValDef RktValLink" data-pltdoc="x">tan</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the tangent of <span class="RktVar">z</span>, where <span class="RktVar">z</span> is in radians. The
+ result is normally inexact, but it is exact <span class="RktVal">0</span> if <span class="RktVar">z</span>
+ is exact <span class="RktVal">0</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._tan%29%29" class="RktValLink" data-pltdoc="x">tan</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0.7854</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1.0000036732118496</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._tan%29%29" class="RktValLink" data-pltdoc="x">tan</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1.0+5.0i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">8.256719834229597e-5+1.0000377833796008i</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._asin))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._asin%29%29" class="RktValDef RktValLink" data-pltdoc="x">asin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the arcsine in radians of <span class="RktVar">z</span>. The result is normally
+ inexact, but it is exact <span class="RktVal">0</span> if <span class="RktVar">z</span> is exact <span class="RktVal">0</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._asin%29%29" class="RktValLink" data-pltdoc="x">asin</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0.25</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0.25268025514207865</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._asin%29%29" class="RktValLink" data-pltdoc="x">asin</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1.0+5.0i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0.1937931365549322+2.3309746530493123i</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._acos))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._acos%29%29" class="RktValDef RktValLink" data-pltdoc="x">acos</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the arccosine in radians of <span class="RktVar">z</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._acos%29%29" class="RktValLink" data-pltdoc="x">acos</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0.25</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1.318116071652818</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._acos%29%29" class="RktValLink" data-pltdoc="x">acos</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1.0+5.0i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1.3770031902399644-2.3309746530493123i</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._atan))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._atan%29%29" class="RktValDef RktValLink" data-pltdoc="x">atan</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._atan%29%29" class="RktValDef RktValLink" data-pltdoc="x">atan</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">y</span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">y</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">In the one-argument case, returns the arctangent of the inexact
+ approximation of <span class="RktVar">z</span>, except that the result is an exact
+ <span class="RktVal">0</span> for <span class="RktVar">z</span> as <span class="RktVal">0</span>, and the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3adivide-by-zero%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:divide-by-zero</a></span> exception is raised
+ for <span class="RktVar">z</span> as exact <span class="RktVal">0+1i</span> or exact <span class="RktVal">0-1i</span>.</div></p><p>In the two-argument case, the result is roughly the same as <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._atan%29%29" class="RktValLink" data-pltdoc="x">atan</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2F%29%29" class="RktValLink" data-pltdoc="x">/</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-~3einexact%29%29" class="RktValLink" data-pltdoc="x">exact-&gt;inexact</a></span><span class="stt"> </span><span class="RktVar">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-~3einexact%29%29" class="RktValLink" data-pltdoc="x">exact-&gt;inexact</a></span><span class="stt"> </span><span class="RktVar">x</span><span class="RktPn">)</span><span class="RktPn">)</span>, but the signs of <span class="RktVar">y</span>
+ and <span class="RktVar">x</span> determine the quadrant of the result. Moreover, a
+ suitable angle is returned when <span class="RktVar">y</span> divided by <span class="RktVar">x</span>
+ produces <span class="RktVal">+nan.0</span> in the case that neither <span class="RktVar">y</span> nor
+ <span class="RktVar">x</span> is <span class="RktVal">+nan.0</span>. Finally, if <span class="RktVar">y</span> is exact
+ <span class="RktVal">0</span> and <span class="RktVar">x</span> is a positive number, the result is
+ exact <span class="RktVal">0</span>. If both <span class="RktVar">x</span> and <span class="RktVar">y</span> are exact
+ <span class="RktVal">0</span>, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3adivide-by-zero%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:divide-by-zero</a></span> exception is raised.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._atan%29%29" class="RktValLink" data-pltdoc="x">atan</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0.5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0.4636476090008061</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._atan%29%29" class="RktValLink" data-pltdoc="x">atan</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1.1071487177940904</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._atan%29%29" class="RktValLink" data-pltdoc="x">atan</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-2</span></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-2.0344439357957027</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._atan%29%29" class="RktValLink" data-pltdoc="x">atan</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1.0+5.0i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1.530881333938778+0.19442614214700213i</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._atan%29%29" class="RktValLink" data-pltdoc="x">atan</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-i</span>nf.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2.356194490192345</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.2.0.2 of package <span class="stt">base</span>: Changed to raise <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3adivide-by-zero%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:divide-by-zero</a></span>
+for <span class="RktVal">0+1i</span> and <span class="RktVal">0-1i</span> and to produce exact <span class="RktVal">0</span>
+for any positive <span class="RktVar">x</span> (not just exact values) when <span class="RktVar">y</span> is <span class="RktVal">0</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Complex_Numbers&quot;">4.3.2.5<tt>&nbsp;</tt><a name="(part._.Complex_.Numbers)"></a>Complex Numbers</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-rectangular))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._make-rectangular%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-rectangular</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktVar">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">y</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a complex number with <span class="RktVar">x</span> as the real part
+and <span class="RktVar">y</span> as the imaginary part. That is, returns <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVar">x</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="stt"> </span><span class="RktVar">y</span><span class="stt"> </span><span class="RktVal">0+1i</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._make-rectangular%29%29" class="RktValLink" data-pltdoc="x">make-rectangular</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3.0+4.0i</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-polar))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._make-polar%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-polar</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">magnitude</span><span class="hspace">&nbsp;</span><span class="RktVar">angle</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">magnitude</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">angle</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a complex number which, if thought of as a point,
+is <span class="RktVar">magnitude</span> away from the origin and is rotated
+<span class="RktVar">angle</span> radians counter clockwise from the positive x-axis.
+That is, returns <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="stt"> </span><span class="RktVar">magnitude</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._cos%29%29" class="RktValLink" data-pltdoc="x">cos</a></span><span class="stt"> </span><span class="RktVar">angle</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="stt"> </span><span class="RktVar">magnitude</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sin%29%29" class="RktValLink" data-pltdoc="x">sin</a></span><span class="stt"> </span><span class="RktVar">angle</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">0+1i</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._make-polar%29%29" class="RktValLink" data-pltdoc="x">make-polar</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1/2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">6.123233995736766e-16+10.0i</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._make-polar%29%29" class="RktValLink" data-pltdoc="x">make-polar</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1/4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">7.0710678118654755+7.071067811865475i</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._real-part))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._real-part%29%29" class="RktValDef RktValLink" data-pltdoc="x">real-part</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the real part of the complex number <span class="RktVar">z</span> in rectangle
+ coordinates.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._real-part%29%29" class="RktValLink" data-pltdoc="x">real-part</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3+4i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._real-part%29%29" class="RktValLink" data-pltdoc="x">real-part</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5.0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._imag-part))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._imag-part%29%29" class="RktValDef RktValLink" data-pltdoc="x">imag-part</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the imaginary part of the complex number <span class="RktVar">z</span> in
+ rectangle coordinates.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._imag-part%29%29" class="RktValLink" data-pltdoc="x">imag-part</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3+4i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._imag-part%29%29" class="RktValLink" data-pltdoc="x">imag-part</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._imag-part%29%29" class="RktValLink" data-pltdoc="x">imag-part</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5.0+0.0i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0.0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._magnitude))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._magnitude%29%29" class="RktValDef RktValLink" data-pltdoc="x">magnitude</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._negative~3f%29%29" class="RktValLink" data-pltdoc="x">negative?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the magnitude of the complex number <span class="RktVar">z</span> in polar
+ coordinates. A complex number with <span class="RktVal">+inf.0</span> or <span class="RktVal"><span class="nobreak">-i</span>nf.0</span>
+ as a component has magnitude <span class="RktVal">+inf.0</span>, even if the other
+ component is <span class="RktVal">+nan.0</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._magnitude%29%29" class="RktValLink" data-pltdoc="x">magnitude</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-3</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._magnitude%29%29" class="RktValLink" data-pltdoc="x">magnitude</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._magnitude%29%29" class="RktValLink" data-pltdoc="x">magnitude</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3+4i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.2.0.2 of package <span class="stt">base</span>: Changed to always return <span class="RktVal">+inf.0</span>
+for a complex number with a <span class="RktVal">+inf.0</span>
+or <span class="RktVal"><span class="nobreak">-i</span>nf.0</span> component.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._angle))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._angle%29%29" class="RktValDef RktValLink" data-pltdoc="x">angle</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns the angle of
+ the complex number <span class="RktVar">z</span> in polar coordinates.</div></p><p>The result is guaranteed to be between <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="RktPn">)</span> and
+ <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span>, possibly equal to <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span> (but never equal
+ to <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="RktPn">)</span>).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._angle%29%29" class="RktValLink" data-pltdoc="x">angle</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-3</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3.141592653589793</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._angle%29%29" class="RktValLink" data-pltdoc="x">angle</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._angle%29%29" class="RktValLink" data-pltdoc="x">angle</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3+4i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0.9272952180016122</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._angle%29%29" class="RktValLink" data-pltdoc="x">angle</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0+inf.0i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0.7853981633974483</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._angle%29%29" class="RktValLink" data-pltdoc="x">angle</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3.141592653589793</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Bitwise_Operations&quot;">4.3.2.6<tt>&nbsp;</tt><a name="(part._.Bitwise_.Operations)"></a><a name="(idx._(gentag._126._(lib._scribblings/reference/reference..scrbl)))"></a>Bitwise Operations</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bitwise-ior))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-ior%29%29" class="RktValDef RktValLink" data-pltdoc="x">bitwise-ior</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns
+ the bitwise &ldquo;inclusive or&rdquo; of the <span class="RktVar">n</span>s in their (semi-infinite)
+ two&rsquo;s complement representation. If no arguments are provided, the
+ result is <span class="RktVal">0</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-ior%29%29" class="RktValLink" data-pltdoc="x">bitwise-ior</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-ior%29%29" class="RktValLink" data-pltdoc="x">bitwise-ior</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-3</span>2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-31</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bitwise-and))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-and%29%29" class="RktValDef RktValLink" data-pltdoc="x">bitwise-and</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns
+ the bitwise &ldquo;and&rdquo; of the <span class="RktVar">n</span>s in their (semi-infinite) two&rsquo;s
+ complement representation. If no arguments are provided, the result
+ is <span class="RktVal"><span class="nobreak">-1</span></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-and%29%29" class="RktValLink" data-pltdoc="x">bitwise-and</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-and%29%29" class="RktValLink" data-pltdoc="x">bitwise-and</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-3</span>2</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-32</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bitwise-xor))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-xor%29%29" class="RktValDef RktValLink" data-pltdoc="x">bitwise-xor</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns
+ the bitwise &ldquo;exclusive or&rdquo; of the <span class="RktVar">n</span>s in their (semi-infinite)
+ two&rsquo;s complement representation. If no arguments are provided, the
+ result is <span class="RktVal">0</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-xor%29%29" class="RktValLink" data-pltdoc="x">bitwise-xor</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-xor%29%29" class="RktValLink" data-pltdoc="x">bitwise-xor</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-3</span>2</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">31</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bitwise-not))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-not%29%29" class="RktValDef RktValLink" data-pltdoc="x">bitwise-not</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns the
+ bitwise &ldquo;not&rdquo; of <span class="RktVar">n</span> in its (semi-infinite) two&rsquo;s complement
+ representation.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-not%29%29" class="RktValLink" data-pltdoc="x">bitwise-not</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-6</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-not%29%29" class="RktValLink" data-pltdoc="x">bitwise-not</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bitwise-bit-set~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-bit-set~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">bitwise-bit-set?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span><span class="RktVar">m</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">m</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> when the <span class="RktVar">m</span>th bit of <span class="RktVar">n</span> is set in <span class="RktVar">n</span>&rsquo;s
+        (semi-infinite) two&rsquo;s complement representation.</div></p><p>This operation is equivalent to
+<span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-and%29%29" class="RktValLink" data-pltdoc="x">bitwise-and</a></span><span class="stt"> </span><span class="RktVar">n</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._arithmetic-shift%29%29" class="RktValLink" data-pltdoc="x">arithmetic-shift</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVar">m</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>,
+but it is faster and runs in constant time when <span class="RktVar">n</span> is positive.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-bit-set~3f%29%29" class="RktValLink" data-pltdoc="x">bitwise-bit-set?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-bit-set~3f%29%29" class="RktValLink" data-pltdoc="x">bitwise-bit-set?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-bit-set~3f%29%29" class="RktValLink" data-pltdoc="x">bitwise-bit-set?</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-5</span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">700</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bitwise-bit-field))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-bit-field%29%29" class="RktValDef RktValLink" data-pltdoc="x">bitwise-bit-field</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">end</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">end</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVar">start</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Extracts the bits between position <span class="RktVar">start</span> and <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">end</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span> (inclusive)
+from <span class="RktVar">n</span> and shifts them down to the least significant portion of the number.</div></p><p>This operation is equivalent to the computation</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-and%29%29" class="RktValLink" data-pltdoc="x">bitwise-and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._arithmetic-shift%29%29" class="RktValLink" data-pltdoc="x">arithmetic-shift</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span><span class="RktVar">start</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._arithmetic-shift%29%29" class="RktValLink" data-pltdoc="x">arithmetic-shift</a></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktVar">start</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>but it runs in constant time when <span class="RktVar">n</span> is positive, <span class="RktVar">start</span> and
+<span class="RktVar">end</span> are fixnums, and <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">end</span><span class="stt"> </span><span class="RktVar">start</span><span class="RktPn">)</span> is no more than
+the maximum width of a fixnum.</p><p>Each pair of examples below uses the same numbers, showing the result
+both in binary and as integers.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~b"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-bit-field%29%29" class="RktValLink" data-pltdoc="x">bitwise-bit-field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._string-~3enumber%29%29" class="RktValLink" data-pltdoc="x">string-&gt;number</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"1101"</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"0"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-bit-field%29%29" class="RktValLink" data-pltdoc="x">bitwise-bit-field</a></span><span class="hspace">&nbsp;</span><span class="RktVal">13</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~b"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-bit-field%29%29" class="RktValLink" data-pltdoc="x">bitwise-bit-field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._string-~3enumber%29%29" class="RktValLink" data-pltdoc="x">string-&gt;number</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"1101"</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"10"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-bit-field%29%29" class="RktValLink" data-pltdoc="x">bitwise-bit-field</a></span><span class="hspace">&nbsp;</span><span class="RktVal">13</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~b"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-bit-field%29%29" class="RktValLink" data-pltdoc="x">bitwise-bit-field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._string-~3enumber%29%29" class="RktValLink" data-pltdoc="x">string-&gt;number</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"1101"</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"110"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-bit-field%29%29" class="RktValLink" data-pltdoc="x">bitwise-bit-field</a></span><span class="hspace">&nbsp;</span><span class="RktVal">13</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">6</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._arithmetic-shift))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._arithmetic-shift%29%29" class="RktValDef RktValLink" data-pltdoc="x">arithmetic-shift</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span><span class="RktVar">m</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">m</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns the bitwise &ldquo;shift&rdquo; of <span class="RktVar">n</span> in its
+ (semi-infinite) two&rsquo;s complement representation.  If <span class="RktVar">m</span> is
+ non-negative, the integer <span class="RktVar">n</span> is shifted left by <span class="RktVar">m</span> bits;
+ i.e., <span class="RktVar">m</span> new zeros are introduced as rightmost digits. If
+ <span class="RktVar">m</span> is negative, <span class="RktVar">n</span> is shifted right by <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">m</span><span class="RktPn">)</span>
+ bits; i.e., the rightmost <span class="RktVar">m</span> digits are dropped.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._arithmetic-shift%29%29" class="RktValLink" data-pltdoc="x">arithmetic-shift</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1024</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._arithmetic-shift%29%29" class="RktValLink" data-pltdoc="x">arithmetic-shift</a></span><span class="hspace">&nbsp;</span><span class="RktVal">255</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-3</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">31</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._integer-length))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">integer-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns
+ the number of bits in the (semi-infinite) two&rsquo;s complement
+ representation of <span class="RktVar">n</span> after removing all leading zeros (for
+ non-negative <span class="RktVar">n</span>) or ones (for negative <span class="RktVar">n</span>).</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-length%29%29" class="RktValLink" data-pltdoc="x">integer-length</a></span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-length%29%29" class="RktValLink" data-pltdoc="x">integer-length</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-8</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Random_Numbers&quot;">4.3.2.7<tt>&nbsp;</tt><a name="(part._.Random_.Numbers)"></a>Random Numbers</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>When security is a concern, use <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Frandom..rkt%29._crypto-random-bytes%29%29" class="RktValLink" data-pltdoc="x">crypto-random-bytes</a></span> instead of <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._random%29%29" class="RktValLink" data-pltdoc="x">random</a></span>.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._random))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._random%29%29" class="RktValDef RktValLink" data-pltdoc="x">random</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">rand-gen</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">4294967087</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">rand-gen</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator~3f%29%29" class="RktValLink" data-pltdoc="x">pseudo-random-generator?</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._current-pseudo-random-generator%29%29" class="RktValLink" data-pltdoc="x">current-pseudo-random-generator</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._random%29%29" class="RktValDef RktValLink" data-pltdoc="x">random</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">min</span><span class="hspace">&nbsp;</span><span class="RktVar">max</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">rand-gen</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">min</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">max</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVar">min</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4294967087</span><span class="hspace">&nbsp;</span><span class="RktVar">min</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">rand-gen</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator~3f%29%29" class="RktValLink" data-pltdoc="x">pseudo-random-generator?</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._current-pseudo-random-generator%29%29" class="RktValLink" data-pltdoc="x">current-pseudo-random-generator</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._random%29%29" class="RktValDef RktValLink" data-pltdoc="x">random</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">rand-gen</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact~3f%29%29" class="RktValLink" data-pltdoc="x">inexact?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3c%2Fc%29%29" class="RktValLink" data-pltdoc="x">&lt;/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">rand-gen</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator~3f%29%29" class="RktValLink" data-pltdoc="x">pseudo-random-generator?</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._current-pseudo-random-generator%29%29" class="RktValLink" data-pltdoc="x">current-pseudo-random-generator</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">When called with an integer argument <span class="RktVar">k</span>, returns a random
+exact integer in the range <span class="RktVal">0</span> to <span class="RktVar">k</span><span style="font-style: italic">-</span>1<span style="font-style: italic"></span>.</div></p><p>When called with two integer arguments <span class="RktVar">min</span> and <span class="RktVar">max</span>, returns a
+random exact integer in the range <span class="RktVar">min</span> to <span class="RktVar">max</span><span style="font-style: italic">-</span>1<span style="font-style: italic"></span>.</p><p>When called with zero arguments, returns a random inexact number between
+<span class="RktVal">0</span> and <span class="RktVal">1</span>, exclusive.</p><p>In each case, the number is provided by the given pseudo-random number
+generator (which defaults to the current one, as produced by
+<span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._current-pseudo-random-generator%29%29" class="RktValLink" data-pltdoc="x">current-pseudo-random-generator</a></span>). The generator maintains an
+internal state for generating numbers. The random number generator
+uses L&rsquo;Ecuyer&rsquo;s MRG32k3a algorithm [<a href="doc-bibliography.html#%28cite._.L%27.Ecuyer02%29" data-pltdoc="x">L'Ecuyer02</a>] that has a
+state space of practically 192 bits.</p><p class="SHistory">Changed in version 6.4 of package <span class="stt">base</span>: Added support for ranges.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._random-seed))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._random-seed%29%29" class="RktValDef RktValLink" data-pltdoc="x">random-seed</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">31</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Seeds the current pseudo-random number generator with
+<span class="RktVar">k</span>. Seeding a generator sets its internal state
+deterministically; that is, seeding a generator with a particular
+number forces it to produce a sequence of pseudo-random numbers that
+is the same across runs and across platforms.</div></p><p>The <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._random-seed%29%29" class="RktValLink" data-pltdoc="x">random-seed</a></span> function is convenient for some purposes, but
+note that the space of states for a pseudo-random number generator is
+much larger that the space of allowed values for <span class="RktVar">k</span>. Use
+<span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._vector-~3epseudo-random-generator%21%29%29" class="RktValLink" data-pltdoc="x">vector-&gt;pseudo-random-generator!</a></span> to set a pseudo-random
+number generator to any of its possible states.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-pseudo-random-generator))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._make-pseudo-random-generator%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-pseudo-random-generator</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator~3f%29%29" class="RktValLink" data-pltdoc="x">pseudo-random-generator?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns a new pseudo-random number generator. The new generator is
+seeded with a number derived from <span class="RktPn">(</span><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-milliseconds%29%29" class="RktValLink" data-pltdoc="x">current-milliseconds</a></span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._pseudo-random-generator~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">pseudo-random-generator?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a pseudo-random number generator,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-pseudo-random-generator))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._current-pseudo-random-generator%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-pseudo-random-generator</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator~3f%29%29" class="RktValLink" data-pltdoc="x">pseudo-random-generator?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._current-pseudo-random-generator%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-pseudo-random-generator</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">rand-gen</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">rand-gen</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator~3f%29%29" class="RktValLink" data-pltdoc="x">pseudo-random-generator?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the pseudo-random number generator
+used by <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._random%29%29" class="RktValLink" data-pltdoc="x">random</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._pseudo-random-generator-~3evector))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator-~3evector%29%29" class="RktValDef RktValLink" data-pltdoc="x">pseudo-random-generator-&gt;vector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">rand-gen</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator-vector~3f%29%29" class="RktValLink" data-pltdoc="x">pseudo-random-generator-vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">rand-gen</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator~3f%29%29" class="RktValLink" data-pltdoc="x">pseudo-random-generator?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a vector that represents the complete internal state of
+<span class="RktVar">rand-gen</span>. The vector is suitable as an argument to
+<span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._vector-~3epseudo-random-generator%29%29" class="RktValLink" data-pltdoc="x">vector-&gt;pseudo-random-generator</a></span> to recreate the generator in
+its current state (across runs and across platforms).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._vector-~3epseudo-random-generator))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._vector-~3epseudo-random-generator%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-&gt;pseudo-random-generator</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator~3f%29%29" class="RktValLink" data-pltdoc="x">pseudo-random-generator?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator-vector~3f%29%29" class="RktValLink" data-pltdoc="x">pseudo-random-generator-vector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a pseudo-random number generator whose internal state
+corresponds to <span class="RktVar">vec</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._vector-~3epseudo-random-generator!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._vector-~3epseudo-random-generator%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-&gt;pseudo-random-generator!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">rand-gen</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">vec</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">rand-gen</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator~3f%29%29" class="RktValLink" data-pltdoc="x">pseudo-random-generator?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator-vector~3f%29%29" class="RktValLink" data-pltdoc="x">pseudo-random-generator-vector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._vector-~3epseudo-random-generator%29%29" class="RktValLink" data-pltdoc="x">vector-&gt;pseudo-random-generator</a></span>, but changes
+<span class="RktVar">rand-gen</span> to the given state, instead of creating a new
+generator.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._pseudo-random-generator-vector~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator-vector~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">pseudo-random-generator-vector?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a vector of six exact integers,
+where the first three integers are in the range <span class="RktVal">0</span> to
+<span class="RktVal">4294967086</span>, inclusive; the last three integers are in the
+range <span class="RktVal">0</span> to <span class="RktVal">4294944442</span>, inclusive; at least one of
+the first three integers is non-zero; and at least one of the last
+three integers is non-zero. Otherwise, the result is <span class="RktVal">#f</span>.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Other_Randomness_Utilities&quot;">4.3.2.8<tt>&nbsp;</tt><a name="(part._.Other_.Randomness_.Utilities)"></a><a name="(mod-path._racket/random)"></a>Other Randomness Utilities</h5><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="generic-numbers.html#%28mod-path._racket%2Frandom%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/random</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/random..rkt)._crypto-random-bytes))"></a><span title="Provided from: racket/random | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Frandom..rkt%29._crypto-random-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">crypto-random-bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Provides an interface to randomness from the underlying operating system. Use
+<span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Frandom..rkt%29._crypto-random-bytes%29%29" class="RktValLink" data-pltdoc="x">crypto-random-bytes</a></span> instead of <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._random%29%29" class="RktValLink" data-pltdoc="x">random</a></span> wherever security is a
+concern.</div></p><p>Returns <span class="RktVar">n</span> random bytes. On Unix systems, the bytes are
+obtained from <span class="stt">"/dev/urandom"</span>, while Windows uses
+the <span class="stt">RtlGenRand</span> system function.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Frandom..rkt%29._crypto-random-bytes%29%29" class="RktValLink" data-pltdoc="x">crypto-random-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">14</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"\0\1\1\2\3\5\b\r\25\"7Y\220\351"</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/random..rkt)._random-ref))"></a><span title="Provided from: racket/random | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Frandom..rkt%29._random-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">random-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">seq</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">rand-gen</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">seq</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">rand-gen</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator~3f%29%29" class="RktValLink" data-pltdoc="x">pseudo-random-generator?</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._current-pseudo-random-generator%29%29" class="RktValLink" data-pltdoc="x">current-pseudo-random-generator</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns a random element of the sequence. Like <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-length%29%29" class="RktValLink" data-pltdoc="x">sequence-length</a></span>, does
+not terminate on infinite sequences, and evaluates the entire sequence.</div></p><p class="SHistory">Added in version 6.4 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/random..rkt)._random-sample))"></a><span title="Provided from: racket/random | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Frandom..rkt%29._random-sample%29%29" class="RktValDef RktValLink" data-pltdoc="x">random-sample</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">seq</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">n</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">rand-gen</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:replacement?</span><span class="hspace">&nbsp;</span><span class="RktVar">replacement?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">seq</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">rand-gen</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator~3f%29%29" class="RktValLink" data-pltdoc="x">pseudo-random-generator?</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._current-pseudo-random-generator%29%29" class="RktValLink" data-pltdoc="x">current-pseudo-random-generator</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">replacement?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of <span class="RktVar">n</span> elements of <span class="RktVar">seq</span>, picked at random, listed
+in any order.
+If <span class="RktVar">replacement?</span> is non-false, elements are drawn with replacement,
+which allows for duplicates.</div></p><p>Like <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-length%29%29" class="RktValLink" data-pltdoc="x">sequence-length</a></span>, does not terminate on infinite sequences, and
+evaluates the entire sequence.</p><p class="SHistory">Added in version 6.4 of package <span class="stt">base</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Number--String_Conversions&quot;">4.3.2.9<tt>&nbsp;</tt><a name="(part._.Number--.String_.Conversions)"></a><a name="(idx._(gentag._127._(lib._scribblings/reference/reference..scrbl)))"></a><a name="(idx._(gentag._128._(lib._scribblings/reference/reference..scrbl)))"></a><a name="(idx._(gentag._129._(lib._scribblings/reference/reference..scrbl)))"></a><a name="(idx._(gentag._130._(lib._scribblings/reference/reference..scrbl)))"></a><a name="(idx._(gentag._131._(lib._scribblings/reference/reference..scrbl)))"></a>Number&ndash;String Conversions</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._number-~3estring))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._number-~3estring%29%29" class="RktValDef RktValLink" data-pltdoc="x">number-&gt;string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">radix</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">radix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">16</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">10</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a string that is the printed form of <span class="RktVar">z</span> (see <a href="printing.html#%28part._print-number%29" data-pltdoc="x">Printing Numbers</a>)
+ in the base specified by <span class="RktVar">radix</span>. If <span class="RktVar">z</span> is inexact,
+ <span class="RktVar">radix</span> must be <span class="RktVal">10</span>, otherwise the
+ <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._number-~3estring%29%29" class="RktValLink" data-pltdoc="x">number-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"3.0"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._number-~3estring%29%29" class="RktValLink" data-pltdoc="x">number-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">255</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"377"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-~3enumber))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._string-~3enumber%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-&gt;number</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">s</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">radix</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">convert-mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">decimal-mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">single-mode</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">extflonum?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">radix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">16</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">10</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">convert-mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">number-or-false</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">read</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">number-or-false</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">decimal-mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">decimal-as-inexact</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">decimal-as-exact</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-decimal-as-inexact%29%29" class="RktValLink" data-pltdoc="x">read-decimal-as-inexact</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">decimal-as-inexact</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">decimal-as-exact</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">single-mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">single</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">double</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-single-flonum%29%29" class="RktValLink" data-pltdoc="x">read-single-flonum</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">single</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">double</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Reads and returns a number datum from <span class="RktVar">s</span> (see
+<a href="reader.html#%28part._parse-number%29" data-pltdoc="x">Reading Numbers</a>). The optional <span class="RktVar">radix</span> argument
+specifies the default base for the number, which can be overridden by
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#b</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#o</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#d</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#x</span><span class="hspace"></span></span> in the
+string.</div></p><p>If <span class="RktVar">convert-mode</span> is <span class="RktVal">'</span><span class="RktVal">number-or-false</span>, the result is
+<span class="RktVal">#f</span> if <span class="RktVar">s</span> does not parse exactly as a number datum
+(with no whitespace). If <span class="RktVar">convert-mode</span> is <span class="RktVal">'</span><span class="RktVal">read</span>, the
+result can be an <a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonum</span></a>, and it can be a string that
+contains an error message if <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> of <span class="RktVar">s</span> would report
+a reader exception (but the result can still be <span class="RktVal">#f</span> if
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> would report a symbol).</p><p>The <span class="RktVar">decimal-mode</span> argument controls number parsing the same
+way that the <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-decimal-as-inexact%29%29" class="RktValLink" data-pltdoc="x">read-decimal-as-inexact</a></span> parameter affects
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>.</p><p>The <span class="RktVar">single-mode</span> argument controls number parsing the same way
+that the <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-single-flonum%29%29" class="RktValLink" data-pltdoc="x">read-single-flonum</a></span> parameter affects <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._string-~3enumber%29%29" class="RktValLink" data-pltdoc="x">string-&gt;number</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"3.0+2.5i"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3.0+2.5i</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._string-~3enumber%29%29" class="RktValLink" data-pltdoc="x">string-&gt;number</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._string-~3enumber%29%29" class="RktValLink" data-pltdoc="x">string-&gt;number</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"111"</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">57</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._string-~3enumber%29%29" class="RktValLink" data-pltdoc="x">string-&gt;number</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"#b111"</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">7</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._string-~3enumber%29%29" class="RktValLink" data-pltdoc="x">string-&gt;number</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"#e+inf.0"</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">read</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"no exact representation for +inf.0"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._string-~3enumber%29%29" class="RktValLink" data-pltdoc="x">string-&gt;number</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"10.3"</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">read</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">decimal-as-exact</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">103/10</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.8.0.2 of package <span class="stt">base</span>: Added the <span class="RktVar">convert-mode</span> and
+<span class="RktVar">decimal-mode</span> arguments.<br/>Changed in version 7.3.0.5: Added the <span class="RktVar">single-mode</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._real-~3edecimal-string))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._real-~3edecimal-string%29%29" class="RktValDef RktValLink" data-pltdoc="x">real-&gt;decimal-string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">decimal-digits</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._rational~3f%29%29" class="RktValLink" data-pltdoc="x">rational?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">decimal-digits</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">2</span></td></tr></table></blockquote></div><div class="SIntrapara">Prints <span class="RktVar">n</span> into a string and returns the string. The printed
+form of <span class="RktVar">n</span> shows exactly <span class="RktVar">decimal-digits</span> digits after
+the decimal point. The printed form uses a minus sign if <span class="RktVar">n</span> is
+negative, and it does not use a plus sign if <span class="RktVar">n</span> is positive.</div></p><p>Before printing, <span class="RktVar">n</span> is converted to an exact number,
+multiplied by <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="stt"> </span><span class="RktVal">10</span><span class="stt"> </span><span class="RktVar">decimal-digits</span><span class="RktPn">)</span>, rounded, and then
+divided again by <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="stt"> </span><span class="RktVal">10</span><span class="stt"> </span><span class="RktVar">decimal-digits</span><span class="RktPn">)</span>.  The result of this
+process is an exact number whose decimal representation has no more
+than <span class="RktVar">decimal-digits</span> digits after the decimal (and it is
+padded with trailing zeros if necessary).</p><p>If <span class="RktVar">n</span> is a real number with no decimal representation (e.g.
+<span class="RktVal">+nan.0</span>, <span class="RktVal">+inf.0</span>), then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.
+(Any real number that is convertible to decimal notation is rational,
+so <span class="RktVar">n</span> must be <span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._rational~3f%29%29" class="RktValLink" data-pltdoc="x">rational?</a></span>, despite the name of the
+function.)</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._real-~3edecimal-string%29%29" class="RktValLink" data-pltdoc="x">real-&gt;decimal-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"3.14"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._real-~3edecimal-string%29%29" class="RktValLink" data-pltdoc="x">real-&gt;decimal-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"3.14159"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._integer-bytes-~3einteger))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-bytes-~3einteger%29%29" class="RktValDef RktValLink" data-pltdoc="x">integer-bytes-&gt;integer</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">signed?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">big-endian?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">signed?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">big-endian?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._system-big-endian~3f%29%29" class="RktValLink" data-pltdoc="x">system-big-endian?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Converts the machine-format number encoded in <span class="RktVar">bstr</span> to an
+exact integer. The <span class="RktVar">start</span> and <span class="RktVar">end</span> arguments specify
+the substring to decode, where <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">end</span><span class="stt"> </span><span class="RktVar">start</span><span class="RktPn">)</span> must be <span class="RktVal">1</span>,
+<span class="RktVal">2</span>, <span class="RktVal">4</span>, or <span class="RktVal">8</span>. If <span class="RktVar">signed?</span> is true,
+then the bytes are decoded as a two&rsquo;s-complement number, otherwise it
+is decoded as an unsigned integer. If <span class="RktVar">big-endian?</span> is true,
+then the first byte&rsquo;s value provides the most significant
+eight bits of the number, otherwise the first byte provides the
+least-significant eight bits, and so on.</div></p><p class="SHistory">Changed in version 6.10.0.1 of package <span class="stt">base</span>: Added support for decoding a 1-byte string.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._integer-~3einteger-bytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._integer-~3einteger-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">integer-&gt;integer-bytes</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">n</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">size-n</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">signed?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">big-endian?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">dest-bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">size-n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">signed?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">big-endian?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._system-big-endian~3f%29%29" class="RktValLink" data-pltdoc="x">system-big-endian?</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">dest-bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._make-bytes%29%29" class="RktValLink" data-pltdoc="x">make-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVar">size-n</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr></table></blockquote></div><div class="SIntrapara">Converts the exact integer <span class="RktVar">n</span> to a machine-format number
+encoded in a byte string of length <span class="RktVar">size-n</span>, which must be <span class="RktVal">1</span>,
+<span class="RktVal">2</span>, <span class="RktVal">4</span>, or <span class="RktVal">8</span>. If <span class="RktVar">signed?</span> is true,
+then the number is encoded as two&rsquo;s complement, otherwise it is
+encoded as an unsigned bit stream. If <span class="RktVar">big-endian?</span> is true,
+then the most significant eight bits of the number are encoded in the
+first byte of the resulting byte string, otherwise the
+least-significant bits are encoded in the first byte, and so on.</div></p><p>The <span class="RktVar">dest-bstr</span> argument must be a mutable byte string of
+length <span class="RktVar">size-n</span>. The encoding of <span class="RktVar">n</span> is written into
+<span class="RktVar">dest-bstr</span> starting at offset <span class="RktVar">start</span>, and
+<span class="RktVar">dest-bstr</span> is returned as the result.</p><p>If <span class="RktVar">n</span> cannot be encoded in a byte string of the requested size and
+format, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. If <span class="RktVar">dest-bstr</span> is not
+of length <span class="RktVar">size-n</span>, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p class="SHistory">Changed in version 6.10.0.1 of package <span class="stt">base</span>: Added support for encoding a 1-byte value.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._floating-point-bytes-~3ereal))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._floating-point-bytes-~3ereal%29%29" class="RktValDef RktValLink" data-pltdoc="x">floating-point-bytes-&gt;real</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">big-endian?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">big-endian?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._system-big-endian~3f%29%29" class="RktValLink" data-pltdoc="x">system-big-endian?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Converts the IEEE floating-point number encoded in <span class="RktVar">bstr</span> from
+position <span class="RktVar">start</span> (inclusive) to <span class="RktVar">end</span> (exclusive) to an
+inexact real number. The difference between <span class="RktVar">start</span> an
+<span class="RktVar">end</span> must be either 4 or 8 bytes. If <span class="RktVar">big-endian?</span> is
+true, then the first byte&rsquo;s ASCII value provides the most significant
+eight bits of the IEEE representation, otherwise the first byte
+provides the least-significant eight bits, and so on.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._real-~3efloating-point-bytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._real-~3efloating-point-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">real-&gt;floating-point-bytes</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">x</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">size-n</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">big-endian?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">dest-bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">size-n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">big-endian?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._system-big-endian~3f%29%29" class="RktValLink" data-pltdoc="x">system-big-endian?</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">dest-bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._make-bytes%29%29" class="RktValLink" data-pltdoc="x">make-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVar">size-n</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr></table></blockquote></div><div class="SIntrapara">Converts the real number <span class="RktVar">x</span> to its IEEE representation in a
+byte string of length <span class="RktVar">size-n</span>, which must be <span class="RktVal">4</span> or
+<span class="RktVal">8</span>. If <span class="RktVar">big-endian?</span> is true, then the most significant
+eight bits of the number are encoded in the first byte of the
+resulting byte string, otherwise the least-significant bits are
+encoded in the first character, and so on.</div></p><p>The <span class="RktVar">dest-bstr</span> argument must be a mutable byte string of
+length <span class="RktVar">size-n</span>. The encoding of <span class="RktSym">n</span> is written into
+<span class="RktVar">dest-bstr</span> starting with byte <span class="RktVar">start</span>, and
+<span class="RktVar">dest-bstr</span> is returned as the result.</p><p>If <span class="RktVar">dest-bstr</span> is provided and it has less than <span class="RktVar">start</span>
+plus <span class="RktVar">size-n</span> bytes, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._system-big-endian~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._system-big-endian~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">system-big-endian?</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if the native encoding of numbers is big-endian
+for the machine running Racket, <span class="RktVal">#f</span> if the native encoding
+is little-endian.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Extra_Constants_and_Functions&quot;">4.3.2.10<tt>&nbsp;</tt><a name="(part._.Extra_.Constants_and_.Functions)"></a><a name="(mod-path._racket/math)"></a>Extra Constants and Functions</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="generic-numbers.html#%28mod-path._racket%2Fmath%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/math</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="generic-numbers.html#%28mod-path._racket%2Fmath%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/math</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/math..rkt)._pi))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValDef RktValLink" data-pltdoc="x">pi</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">An approximation of &#960;, the ratio of a circle&rsquo;s circumference to its
+diameter.
+</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span></td></tr><tr><td><p><span class="RktRes">3.141592653589793</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._cos%29%29" class="RktValLink" data-pltdoc="x">cos</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-1.0</span></p></td></tr></table></blockquote></div></p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/math..rkt)._pi..f))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi..f%29%29" class="RktValDef RktValLink" data-pltdoc="x">pi.f</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._single-flonum~3f%29%29" class="RktValLink" data-pltdoc="x">single-flonum?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">The same value as <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span>, but as a single-precision
+floating-point number if the current platform supports it.</div></p><p class="SHistory">Changed in version 7.3.0.5 of package <span class="stt">base</span>: Allow value to be a double-precision flonum.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/math..rkt)._degrees-~3eradians))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._degrees-~3eradians%29%29" class="RktValDef RktValLink" data-pltdoc="x">degrees-&gt;radians</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Converts an <span class="RktVar">x</span>-degree angle to radians.
+</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._degrees-~3eradians%29%29" class="RktValLink" data-pltdoc="x">degrees-&gt;radians</a></span><span class="hspace">&nbsp;</span><span class="RktVal">180</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3.141592653589793</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sin%29%29" class="RktValLink" data-pltdoc="x">sin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._degrees-~3eradians%29%29" class="RktValLink" data-pltdoc="x">degrees-&gt;radians</a></span><span class="hspace">&nbsp;</span><span class="RktVal">45</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0.7071067811865475</span></p></td></tr></table></blockquote></div></p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/math..rkt)._radians-~3edegrees))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._radians-~3edegrees%29%29" class="RktValDef RktValLink" data-pltdoc="x">radians-&gt;degrees</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Converts <span class="RktVar">x</span> radians to degrees.
+</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._radians-~3edegrees%29%29" class="RktValLink" data-pltdoc="x">radians-&gt;degrees</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">180.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._radians-~3edegrees%29%29" class="RktValLink" data-pltdoc="x">radians-&gt;degrees</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1/4</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">45.0</span></p></td></tr></table></blockquote></div></p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/math..rkt)._sqr))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._sqr%29%29" class="RktValDef RktValLink" data-pltdoc="x">sqr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="stt"> </span><span class="RktVar">z</span><span class="stt"> </span><span class="RktVar">z</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/math..rkt)._sgn))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._sgn%29%29" class="RktValDef RktValLink" data-pltdoc="x">sgn</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">+nan.0</span><span class="hspace">&nbsp;</span><span class="RktVal">+nan.f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the sign of <span class="RktVar">x</span> as either <span style="font-style: italic">-</span>1<span style="font-style: italic"></span>, <span style="font-style: italic"></span>0<span style="font-style: italic"></span> (or a signed-zero variant, when
+inexact), <span style="font-style: italic"></span>1<span style="font-style: italic"></span>, or not-a-number.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._sgn%29%29" class="RktValLink" data-pltdoc="x">sgn</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._sgn%29%29" class="RktValLink" data-pltdoc="x">sgn</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span>0.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-1.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._sgn%29%29" class="RktValLink" data-pltdoc="x">sgn</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._sgn%29%29" class="RktValLink" data-pltdoc="x">sgn</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-0</span>.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-0.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._sgn%29%29" class="RktValLink" data-pltdoc="x">sgn</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._sgn%29%29" class="RktValLink" data-pltdoc="x">sgn</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+nan.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">+nan.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._sgn%29%29" class="RktValLink" data-pltdoc="x">sgn</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._sgn%29%29" class="RktValLink" data-pltdoc="x">sgn</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-i</span>nf.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-1.0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/math..rkt)._conjugate))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._conjugate%29%29" class="RktValDef RktValLink" data-pltdoc="x">conjugate</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the complex conjugate of <span class="RktVar">z</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._conjugate%29%29" class="RktValLink" data-pltdoc="x">conjugate</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._conjugate%29%29" class="RktValLink" data-pltdoc="x">conjugate</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3+4i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3-4i</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/math..rkt)._sinh))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._sinh%29%29" class="RktValDef RktValLink" data-pltdoc="x">sinh</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the hyperbolic sine of <span class="RktVar">z</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/math..rkt)._cosh))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._cosh%29%29" class="RktValDef RktValLink" data-pltdoc="x">cosh</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the hyperbolic cosine of <span class="RktVar">z</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/math..rkt)._tanh))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._tanh%29%29" class="RktValDef RktValLink" data-pltdoc="x">tanh</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the hyperbolic tangent of <span class="RktVar">z</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/math..rkt)._exact-round))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._exact-round%29%29" class="RktValDef RktValLink" data-pltdoc="x">exact-round</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._rational~3f%29%29" class="RktValLink" data-pltdoc="x">rational?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact-~3eexact%29%29" class="RktValLink" data-pltdoc="x">inexact-&gt;exact</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._round%29%29" class="RktValLink" data-pltdoc="x">round</a></span><span class="stt"> </span><span class="RktVar">x</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/math..rkt)._exact-floor))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._exact-floor%29%29" class="RktValDef RktValLink" data-pltdoc="x">exact-floor</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._rational~3f%29%29" class="RktValLink" data-pltdoc="x">rational?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact-~3eexact%29%29" class="RktValLink" data-pltdoc="x">inexact-&gt;exact</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._floor%29%29" class="RktValLink" data-pltdoc="x">floor</a></span><span class="stt"> </span><span class="RktVar">x</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/math..rkt)._exact-ceiling))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._exact-ceiling%29%29" class="RktValDef RktValLink" data-pltdoc="x">exact-ceiling</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._rational~3f%29%29" class="RktValLink" data-pltdoc="x">rational?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact-~3eexact%29%29" class="RktValLink" data-pltdoc="x">inexact-&gt;exact</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._ceiling%29%29" class="RktValLink" data-pltdoc="x">ceiling</a></span><span class="stt"> </span><span class="RktVar">x</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/math..rkt)._exact-truncate))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._exact-truncate%29%29" class="RktValDef RktValLink" data-pltdoc="x">exact-truncate</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._rational~3f%29%29" class="RktValLink" data-pltdoc="x">rational?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact-~3eexact%29%29" class="RktValLink" data-pltdoc="x">inexact-&gt;exact</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._truncate%29%29" class="RktValLink" data-pltdoc="x">truncate</a></span><span class="stt"> </span><span class="RktVar">x</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/math..rkt)._order-of-magnitude))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._order-of-magnitude%29%29" class="RktValDef RktValLink" data-pltdoc="x">order-of-magnitude</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">r</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact~3f%29%29" class="RktValLink" data-pltdoc="x">exact?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">r</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Computes the greatest exact integer <span class="RktSym">m</span> such that:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c~3d%29%29" class="RktValLink" data-pltdoc="x">&lt;=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact-~3eexact%29%29" class="RktValLink" data-pltdoc="x">inexact-&gt;exact</a></span><span class="hspace">&nbsp;</span><span class="RktVar">r</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Hence also:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact-~3eexact%29%29" class="RktValLink" data-pltdoc="x">inexact-&gt;exact</a></span><span class="hspace">&nbsp;</span><span class="RktVar">r</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._order-of-magnitude%29%29" class="RktValLink" data-pltdoc="x">order-of-magnitude</a></span><span class="hspace">&nbsp;</span><span class="RktVal">999</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._order-of-magnitude%29%29" class="RktValLink" data-pltdoc="x">order-of-magnitude</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1000</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._order-of-magnitude%29%29" class="RktValLink" data-pltdoc="x">order-of-magnitude</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1/100</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._order-of-magnitude%29%29" class="RktValLink" data-pltdoc="x">order-of-magnitude</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1/101</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-3</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/math..rkt)._nan~3f))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._nan~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">nan?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">x</span> is <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span> to <span class="RktVal">+nan.0</span> or <span class="RktVal">+nan.f</span>; otherwise <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/math..rkt)._infinite~3f))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._infinite~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">infinite?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">x</span> is <span class="RktVal">+inf.0</span>, <span class="RktVal"><span class="nobreak">-i</span>nf.0</span>, <span class="RktVal">+inf.f</span>, <span class="RktVal">-inf.f</span>; otherwise <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/math..rkt)._positive-integer~3f))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._positive-integer~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">positive-integer?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span>, but also returns
+<span class="RktVal">#t</span> for positive <span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact~3f%29%29" class="RktValLink" data-pltdoc="x">inexact?</a></span> integers.
+</div><div class="SIntrapara"><p class="SHistory">Added in version 6.8.0.2 of package <span class="stt">base</span>.</p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/math..rkt)._negative-integer~3f))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._negative-integer~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">negative-integer?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="stt"> </span><span class="RktVar">x</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._negative~3f%29%29" class="RktValLink" data-pltdoc="x">negative?</a></span><span class="stt"> </span><span class="RktVar">x</span><span class="RktPn">)</span><span class="RktPn">)</span>.
+</div><div class="SIntrapara"><p class="SHistory">Added in version 6.8.0.2 of package <span class="stt">base</span>.</p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/math..rkt)._nonpositive-integer~3f))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._nonpositive-integer~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">nonpositive-integer?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="stt"> </span><span class="RktVar">x</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="stt"> </span><span class="RktVar">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.
+</div><div class="SIntrapara"><p class="SHistory">Added in version 6.8.0.2 of package <span class="stt">base</span>.</p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/math..rkt)._nonnegative-integer~3f))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._nonnegative-integer~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">nonnegative-integer?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span>, but also returns
+<span class="RktVal">#t</span> for non-negative <span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact~3f%29%29" class="RktValLink" data-pltdoc="x">inexact?</a></span> integers.
+</div><div class="SIntrapara"><p class="SHistory">Added in version 6.8.0.2 of package <span class="stt">base</span>.</p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/math..rkt)._natural~3f))"></a><span title="Provided from: racket/math, racket | Package: base"><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._natural~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">natural?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">An alias for <span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span>.
+</div><div class="SIntrapara"><p class="SHistory">Added in version 6.8.0.2 of package <span class="stt">base</span>.</p></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="number-types.html" title="backward to &quot;4.3.1 Number Types&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="numbers.html" title="up to &quot;4.3 Numbers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="flonums.html" title="forward to &quot;4.3.3 Flonums&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/hashtables.html b/clones/docs.racket-lang.org/reference/hashtables.html
new file mode 100644
index 00000000..3b997b4a
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/hashtables.html
@@ -0,0 +1,278 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.15&nbsp;Hash Tables</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewselflink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewselflink" data-pltdoc="x">Hash Tables</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.15.1&nbsp;</td><td><a href="hashtables.html#%28part._.Additional_.Hash_.Table_.Functions%29" class="tocviewlink" data-pltdoc="x">Additional Hash Table Functions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash?</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-equal~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>equal?</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-equal-always~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>equal-<wbr></wbr>always?</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-eqv~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>eqv?</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-eq~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>eq?</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>strong?</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>weak?</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>ephemeron?</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hashalw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hashalw</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hasheq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hasheq</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hasheqv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hasheqv</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>hash</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hashalw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>hashalw</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hasheqv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>hasheqv</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hasheq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>hasheq</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-weak-hash%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>weak-<wbr></wbr>hash</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-weak-hashalw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>weak-<wbr></wbr>hashalw</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-weak-hasheqv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>weak-<wbr></wbr>hasheqv</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-weak-hasheq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>weak-<wbr></wbr>hasheq</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-ephemeron-hash%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>ephemeron-<wbr></wbr>hash</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-ephemeron-hashalw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>ephemeron-<wbr></wbr>hashalw</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-ephemeron-hasheqv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>ephemeron-<wbr></wbr>hasheqv</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-ephemeron-hasheq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>ephemeron-<wbr></wbr>hasheq</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hash%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>immutable-<wbr></wbr>hash</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hashalw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>immutable-<wbr></wbr>hashalw</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hasheqv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>immutable-<wbr></wbr>hasheqv</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hasheq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>immutable-<wbr></wbr>hasheq</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-set%2A%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>set*!</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>set</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-set%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>set*</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref-key%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>ref-<wbr></wbr>key</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-ref%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>ref!</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-has-key~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>has-<wbr></wbr>key?</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-update%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>update!</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-update%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>update</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>remove!</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>remove</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-clear%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>clear!</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-clear%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>clear</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-copy-clear%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>copy-<wbr></wbr>clear</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-map%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>map</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-map%2Fcopy%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>map/<span class="mywbr"> &nbsp;</span>copy</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-keys%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>keys</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-values%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>values</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-~3elist%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>&gt;list</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-keys-subset~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>keys-<wbr></wbr>subset?</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-for-each%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>for-<wbr></wbr>each</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-count%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>count</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-empty~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>empty?</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-first%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>iterate-<wbr></wbr>first</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-next%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>iterate-<wbr></wbr>next</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-key%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>iterate-<wbr></wbr>key</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-value%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>iterate-<wbr></wbr>value</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-pair%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>iterate-<wbr></wbr>pair</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-key%2Bvalue%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>iterate-<wbr></wbr>key+<span class="mywbr"> &nbsp;</span>value</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-copy%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>copy</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.15.1<tt>&nbsp;</tt></span><a href="hashtables.html#%28part._.Additional_.Hash_.Table_.Functions%29" class="tocsubseclink" data-pltdoc="x">Additional Hash Table Functions</a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28lib._racket%2Fhash..rkt%29._hash-union%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>union</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28lib._racket%2Fhash..rkt%29._hash-union%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>union!</span></span></a></td></tr><tr><td><a href="hashtables.html#%28def._%28%28lib._racket%2Fhash..rkt%29._hash-intersect%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>intersect</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="boxes.html" title="backward to &quot;4.14 Boxes&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="sequences_streams.html" title="forward to &quot;4.16 Sequences and Streams&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;hashtables&quot;">4.15<tt>&nbsp;</tt><a name="(part._hashtables)"></a>Hash Tables</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=hash-tables.html&amp;version=8.6" class="Sq" data-pltdoc="x">Hash Tables</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces hash tables.</p></blockquote></blockquote></blockquote><p>A <a name="(tech._hash._table)"></a><span style="font-style: italic">hash table</span> (or simply <a name="(tech._hash)"></a><span style="font-style: italic">hash</span>) maps each of its
+keys to a single value. For a given hash table, keys are equivalent
+via <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>, and keys are retained either strongly, weakly
+(see <a href="weakbox.html" data-pltdoc="x">Weak Boxes</a>), or like <a href="ephemerons.html#%28tech._ephemeron%29" class="techoutside" data-pltdoc="x"><span class="techinside">ephemerons</span></a>.
+A hash table is also either mutable or immutable.
+Immutable hash tables support effectively constant-time access and
+update, just like mutable hash tables; the constant on immutable
+operations is usually larger, but the functional nature of immutable
+hash tables can pay off in certain algorithms. Use <span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span>
+to check whether a hash table is immutable.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Immutable hash tables actually provide <span style="font-style: italic">O</span>(<span style="font-style: italic">log N</span>)<span style="font-style: italic"></span>
+access and update. Since <span style="font-style: italic">N</span> is limited by the address space so
+that <span style="font-style: italic">log N</span> is limited to less than 30 or 62 (depending on the
+platform), <span style="font-style: italic">log N</span> can be treated reasonably as a constant.</p></blockquote></blockquote></blockquote><p>For <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>-based hashing, the built-in hash functions on
+<a href="strings.html#%28tech._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">strings</span></a>, <a href="pairs.html#%28tech._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">pairs</span></a>, <a href="pairs.html#%28tech._list%29" class="techoutside" data-pltdoc="x"><span class="techinside">lists</span></a>, <a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vectors</span></a>,
+<a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> or transparent <a href="structures.html#%28tech._structure%29" class="techoutside" data-pltdoc="x"><span class="techinside">structures</span></a>, etc<span class="Sendabbrev">.</span>, take time
+proportional to the size of the value. The hash code for a compound
+data structure, such as a list or vector, depends on hashing each item
+of the container, but the depth of such recursive hashing is
+limited (to avoid potential problems with cyclic data). For a
+non-<a href="pairs.html#%28tech._list%29" class="techoutside" data-pltdoc="x"><span class="techinside">list</span></a> <a href="pairs.html#%28tech._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">pair</span></a>, both <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> and <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span>
+hashing is treated as a deeper hash, but the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> of a
+<a href="pairs.html#%28tech._list%29" class="techoutside" data-pltdoc="x"><span class="techinside">list</span></a> is treated as having the same hashing depth as the list.</p><p>A hash table can be used as a two-valued <a href="sequences.html#%28tech._sequence%29" class="techoutside" data-pltdoc="x"><span class="techinside">sequence</span></a> (see
+<a href="sequences.html" data-pltdoc="x">Sequences</a>). The keys and values of the hash table serve as
+elements of the sequence (i.e., each element is a key and its
+associated value). If a mapping is added to or removed from the hash
+table during iteration, then an iteration step may fail with
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span>, or the iteration may skip or duplicate
+keys and values.  See also <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash%29%29" class="RktValLink" data-pltdoc="x">in-hash</a></span>, <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash-keys%29%29" class="RktValLink" data-pltdoc="x">in-hash-keys</a></span>,
+<span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash-values%29%29" class="RktValLink" data-pltdoc="x">in-hash-values</a></span>, and <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash-pairs%29%29" class="RktValLink" data-pltdoc="x">in-hash-pairs</a></span>.</p><p>Two hash tables cannot be <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> unless they have the same
+mutability, use the same key-comparison procedure (<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>,
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>), both hold
+keys strongly, weakly, or like <a href="ephemerons.html#%28tech._ephemeron%29" class="techoutside" data-pltdoc="x"><span class="techinside">ephemerons</span></a>.
+Empty immutable hash tables are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>
+when they are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>.</p><p class="SHistory">Changed in version 7.2.0.9 of package <span class="stt">base</span>: Made empty immutable hash tables
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> when they are
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>.</p><p><a name="(elem._(caveat._concurrency))"></a><span style="font-weight: bold">Caveats concerning concurrent
+modification:</span> A mutable hash table can be manipulated with
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span>, <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%21%29%29" class="RktValLink" data-pltdoc="x">hash-set!</a></span>, and <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%21%29%29" class="RktValLink" data-pltdoc="x">hash-remove!</a></span>
+concurrently by multiple threads, and the operations are protected by
+a table-specific semaphore as needed. Several caveats apply, however:</p><ul><li><p>If a thread is terminated while applying <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span>,
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref-key%29%29" class="RktValLink" data-pltdoc="x">hash-ref-key</a></span>, <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%21%29%29" class="RktValLink" data-pltdoc="x">hash-set!</a></span>, <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%21%29%29" class="RktValLink" data-pltdoc="x">hash-remove!</a></span>,
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-ref%21%29%29" class="RktValLink" data-pltdoc="x">hash-ref!</a></span>, <span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-update%21%29%29" class="RktValLink" data-pltdoc="x">hash-update!</a></span>, or <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-clear%21%29%29" class="RktValLink" data-pltdoc="x">hash-clear!</a></span>
+to a hash table that
+uses <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span> key
+comparisons, all current and future operations on the hash table may
+block indefinitely.</p></li><li><p>The <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-map%29%29" class="RktValLink" data-pltdoc="x">hash-map</a></span>, <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-for-each%29%29" class="RktValLink" data-pltdoc="x">hash-for-each</a></span>, and <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-clear%21%29%29" class="RktValLink" data-pltdoc="x">hash-clear!</a></span> procedures do
+not use the table&rsquo;s semaphore to guard the traversal as a whole
+(if a traversal is needed, in the case of <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-clear%21%29%29" class="RktValLink" data-pltdoc="x">hash-clear!</a></span>).
+Changes by one thread to a hash table can affect the keys and values
+seen by another thread part-way through its traversal of the same
+hash table.</p></li><li><p>The <span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-update%21%29%29" class="RktValLink" data-pltdoc="x">hash-update!</a></span> and <span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-ref%21%29%29" class="RktValLink" data-pltdoc="x">hash-ref!</a></span> functions
+use a table&rsquo;s semaphore
+independently for the <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span> and <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%21%29%29" class="RktValLink" data-pltdoc="x">hash-set!</a></span> parts
+of their functionality, which means that the update as a whole is not
+&ldquo;atomic.&rdquo;</p></li><li><p>Adding a mutable hash table as a key in itself is trouble on
+the grounds that the key is being mutated (see the caveat below),
+but it is also a kind of concurrent use of the hash table: computing
+a hash table&rsquo;s hash code may require waiting on the table&rsquo;s
+semaphore, but the semaphore is already held for modifying the hash
+table, so the hash-table addition can block indefinitely.</p></li></ul><p><a name="(elem._(caveat._mutable-keys))"></a><span style="font-weight: bold">Caveat concerning mutable
+keys:</span> If a key in an <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>-based hash table is mutated
+(e.g., a key string is modified with <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-set%21%29%29" class="RktValLink" data-pltdoc="x">string-set!</a></span>), then the
+hash table&rsquo;s behavior for insertion and lookup operations becomes
+unpredictable.</p><p>A literal or printed hash table starts with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hash</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hashalw</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hasheqv</span><span class="hspace"></span></span>, or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hasheq</span><span class="hspace"></span></span>. See <a href="reader.html#%28part._parse-hashtable%29" data-pltdoc="x">Reading Hash Tables</a>
+    for information on <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>ing
+    hash tables and <a href="printing.html#%28part._print-hashtable%29" data-pltdoc="x">Printing Hash Tables</a>
+    for information on <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>ing hash tables.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash table</span></a>, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-equal~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-equal~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-equal?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">hash</span> compares keys with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>,
+<span class="RktVal">#f</span> if it compares with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-equal-always~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-equal-always~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-equal-always?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">hash</span> compares keys with
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, <span class="RktVal">#f</span> if it compares with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>,
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>.</div></p><p class="SHistory">Added in version 8.5.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-eqv~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-eqv~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-eqv?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">hash</span> compares keys with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>,
+<span class="RktVal">#f</span> if it compares with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>,
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-eq~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-eq~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-eq?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">hash</span> compares keys with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>,
+<span class="RktVal">#f</span> if it compares with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>,
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-strong~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-strong?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">hash</span> retains its keys strongly,
+<span class="RktVal">#f</span> if it retains keys weakly or like <a href="ephemerons.html#%28tech._ephemeron%29" class="techoutside" data-pltdoc="x"><span class="techinside">ephemerons</span></a>.</div></p><p class="SHistory">Added in version 8.0.0.10 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-weak~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-weak?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">hash</span> retains its keys weakly,
+<span class="RktVal">#f</span> if it retains keys strongly or like <a href="ephemerons.html#%28tech._ephemeron%29" class="techoutside" data-pltdoc="x"><span class="techinside">ephemerons</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-ephemeron~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-ephemeron?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">hash</span> retains its keys like
+<a href="ephemerons.html#%28tech._ephemeron%29" class="techoutside" data-pltdoc="x"><span class="techinside">ephemerons</span></a>, <span class="RktVal">#f</span> if it retains keys strongly or merely
+weakly.</div></p><p class="SHistory">Added in version 8.0.0.10 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-equal~3f%29%29" class="RktValLink" data-pltdoc="x">hash-equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hashalw))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hashalw%29%29" class="RktValDef RktValLink" data-pltdoc="x">hashalw</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">hash-equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hasheq))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hasheq%29%29" class="RktValDef RktValLink" data-pltdoc="x">hasheq</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-eq~3f%29%29" class="RktValLink" data-pltdoc="x">hash-eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hasheqv))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hasheqv%29%29" class="RktValDef RktValLink" data-pltdoc="x">hasheqv</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-eqv~3f%29%29" class="RktValLink" data-pltdoc="x">hash-eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Creates an immutable hash table with each given <span class="RktVar">key</span> mapped to
+the following <span class="RktVar">val</span>; each <span class="RktVar">key</span> must have a <span class="RktVar">val</span>,
+so the total number of arguments to <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash%29%29" class="RktValLink" data-pltdoc="x">hash</a></span> must be even.</div></p><p>The <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash%29%29" class="RktValLink" data-pltdoc="x">hash</a></span> procedure creates a table where keys are compared
+with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>, <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hashalw%29%29" class="RktValLink" data-pltdoc="x">hashalw</a></span> creates a table where keys are compared with
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hasheq%29%29" class="RktValLink" data-pltdoc="x">hasheq</a></span> procedure creates a table where
+keys are compared with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>, <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hasheqv%29%29" class="RktValLink" data-pltdoc="x">hasheqv</a></span> procedure
+creates a table where keys are compared with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>.</p><p>The <span class="RktVar">key</span> to <span class="RktVar">val</span> mappings are added to the table in
+the order that they appear in the argument list, so later mappings can
+hide earlier mappings if the <span class="RktVar">key</span>s are equal.</p><p class="SHistory">Changed in version 8.5.0.3 of package <span class="stt">base</span>: Added <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hashalw%29%29" class="RktValLink" data-pltdoc="x">hashalw</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-hash))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-hash</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">assocs</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-equal~3f%29%29" class="RktValLink" data-pltdoc="x">hash-equal?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">assocs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-hashalw))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hashalw%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-hashalw</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">assocs</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">hash-equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">assocs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-hasheqv))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hasheqv%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-hasheqv</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">assocs</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-eqv~3f%29%29" class="RktValLink" data-pltdoc="x">hash-eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">assocs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-hasheq))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hasheq%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-hasheq</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">assocs</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-eq~3f%29%29" class="RktValLink" data-pltdoc="x">hash-eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">assocs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Creates a mutable hash table that holds keys strongly.</div></p><p>The <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span> procedure creates a table where keys are
+compared with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>, <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hasheq%29%29" class="RktValLink" data-pltdoc="x">make-hasheq</a></span> procedure creates
+a table where keys are compared with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>,
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hasheqv%29%29" class="RktValLink" data-pltdoc="x">make-hasheqv</a></span> procedure creates a table where keys are
+compared with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, and <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hashalw%29%29" class="RktValLink" data-pltdoc="x">make-hashalw</a></span> creates a table
+where keys are compared with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>.</p><p>The table is initialized with the content of <span class="RktVar">assocs</span>.  In each
+element of <span class="RktVar">assocs</span>, the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is a key, and the
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is the corresponding value. The mappings are added to the
+table in the order that they appear in <span class="RktVar">assocs</span>, so later
+mappings can hide earlier mappings.</p><p>See also <span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._make-custom-hash%29%29" class="RktValLink" data-pltdoc="x">make-custom-hash</a></span>.</p><p class="SHistory">Changed in version 8.5.0.3 of package <span class="stt">base</span>: Added <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hashalw%29%29" class="RktValLink" data-pltdoc="x">make-hashalw</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-weak-hash))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-weak-hash%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-weak-hash</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">assocs</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-equal~3f%29%29" class="RktValLink" data-pltdoc="x">hash-equal?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">assocs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-weak-hashalw))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-weak-hashalw%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-weak-hashalw</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">assocs</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">hash-equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">assocs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-weak-hasheqv))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-weak-hasheqv%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-weak-hasheqv</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">assocs</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-eqv~3f%29%29" class="RktValLink" data-pltdoc="x">hash-eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">assocs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-weak-hasheq))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-weak-hasheq%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-weak-hasheq</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">assocs</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-eq~3f%29%29" class="RktValLink" data-pltdoc="x">hash-eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">assocs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span>, <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hasheq%29%29" class="RktValLink" data-pltdoc="x">make-hasheq</a></span>,
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hasheqv%29%29" class="RktValLink" data-pltdoc="x">make-hasheqv</a></span>, and <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hashalw%29%29" class="RktValLink" data-pltdoc="x">make-hashalw</a></span>, but creates a
+mutable hash table that holds keys weakly.</div></p><p>Beware that values in a weak hash table are retained normally. If a value in
+the table refers back to its key, then the table will retain the value
+and therefore the key; the mapping will never be removed from the
+table even if the key becomes otherwise inaccessible. To avoid that
+problem, use an ephemeron hash table as created by
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-ephemeron-hash%29%29" class="RktValLink" data-pltdoc="x">make-ephemeron-hash</a></span>, <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-ephemeron-hashalw%29%29" class="RktValLink" data-pltdoc="x">make-ephemeron-hashalw</a></span>,
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-ephemeron-hasheqv%29%29" class="RktValLink" data-pltdoc="x">make-ephemeron-hasheqv</a></span>, or <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-ephemeron-hasheq%29%29" class="RktValLink" data-pltdoc="x">make-ephemeron-hasheq</a></span>.
+For values that do not refer to keys,
+there is a modest extra cost to using an ephemeron hash table instead
+of a weak hash table, but prefer an ephemeron hash table when in
+doubt.</p><p class="SHistory">Changed in version 8.5.0.3 of package <span class="stt">base</span>: Added <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-weak-hashalw%29%29" class="RktValLink" data-pltdoc="x">make-weak-hashalw</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-ephemeron-hash))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-ephemeron-hash%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-ephemeron-hash</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">assocs</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-equal~3f%29%29" class="RktValLink" data-pltdoc="x">hash-equal?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">assocs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-ephemeron-hashalw))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-ephemeron-hashalw%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-ephemeron-hashalw</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">assocs</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">hash-equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">assocs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-ephemeron-hasheqv))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-ephemeron-hasheqv%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-ephemeron-hasheqv</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">assocs</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-eqv~3f%29%29" class="RktValLink" data-pltdoc="x">hash-eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">assocs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-ephemeron-hasheq))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-ephemeron-hasheq%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-ephemeron-hasheq</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">assocs</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-eq~3f%29%29" class="RktValLink" data-pltdoc="x">hash-eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">assocs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span>, <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hasheq%29%29" class="RktValLink" data-pltdoc="x">make-hasheq</a></span>,
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hasheqv%29%29" class="RktValLink" data-pltdoc="x">make-hasheqv</a></span>, and <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hashalw%29%29" class="RktValLink" data-pltdoc="x">make-hashalw</a></span>,
+but creates a mutable hash table that holds
+key-value combinations in the same way as an <a href="ephemerons.html#%28tech._ephemeron%29" class="techoutside" data-pltdoc="x"><span class="techinside">ephemeron</span></a>.</div></p><p>Using an ephemeron hash table is like using a weak hash table and
+mapping each key to a <a href="ephemerons.html#%28tech._ephemeron%29" class="techoutside" data-pltdoc="x"><span class="techinside">ephemeron</span></a> that pairs the key and value.
+An advantage of an ephemeron hash table is that the value need not be
+extracted with <span class="RktSym"><a href="ephemerons.html#%28def._%28%28quote._~23~25kernel%29._ephemeron-value%29%29" class="RktValLink" data-pltdoc="x">ephemeron-value</a></span> from the result of functions
+like <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span>. An ephemeron hash table might also be
+represented more compactly than a weak hash table with explicit
+<a href="ephemerons.html#%28tech._ephemeron%29" class="techoutside" data-pltdoc="x"><span class="techinside">ephemeron</span></a> values.</p><p class="SHistory">Added in version 8.0.0.10 of package <span class="stt">base</span>.<br/>Changed in version 8.5.0.3: Added <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-ephemeron-hashalw%29%29" class="RktValLink" data-pltdoc="x">make-ephemeron-hashalw</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-immutable-hash))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hash%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-immutable-hash</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">assocs</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-equal~3f%29%29" class="RktValLink" data-pltdoc="x">hash-equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">assocs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-immutable-hashalw))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hashalw%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-immutable-hashalw</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">assocs</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">hash-equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">assocs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-immutable-hasheqv))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hasheqv%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-immutable-hasheqv</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">assocs</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-eqv~3f%29%29" class="RktValLink" data-pltdoc="x">hash-eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">assocs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-immutable-hasheq))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hasheq%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-immutable-hasheq</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">assocs</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-eq~3f%29%29" class="RktValLink" data-pltdoc="x">hash-eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">assocs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash%29%29" class="RktValLink" data-pltdoc="x">hash</a></span>, <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hashalw%29%29" class="RktValLink" data-pltdoc="x">hashalw</a></span>, <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hasheq%29%29" class="RktValLink" data-pltdoc="x">hasheq</a></span>, and
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hasheqv%29%29" class="RktValLink" data-pltdoc="x">hasheqv</a></span>, but accepts
+the key&ndash;value mapping in association-list form like
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span>, <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hashalw%29%29" class="RktValLink" data-pltdoc="x">make-hashalw</a></span>, <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hasheq%29%29" class="RktValLink" data-pltdoc="x">make-hasheq</a></span>, and
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hasheqv%29%29" class="RktValLink" data-pltdoc="x">make-hasheqv</a></span>.</div></p><p class="SHistory">Changed in version 8.5.0.3 of package <span class="stt">base</span>: Added <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hashalw%29%29" class="RktValLink" data-pltdoc="x">make-immutable-hashalw</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-set!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Maps <span class="RktVar">key</span> to <span class="RktVar">v</span> in <span class="RktVar">hash</span>, overwriting
+any existing mapping for <span class="RktVar">key</span>.</div></p><p>See also the <a href="hashtables.html#%28elem._%28caveat._concurrency%29%29" data-pltdoc="x">caveats concerning concurrent modification</a> and the <a href="hashtables.html#%28elem._%28caveat._mutable-keys%29%29" data-pltdoc="x">caveat concerning mutable keys</a> above.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._hash-set*!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-set%2A%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-set*!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Maps each <span class="RktVar">key</span> to each <span class="RktVar">v</span> in <span class="RktVar">hash</span>, overwriting
+any existing mapping for each <span class="RktVar">key</span>. Mappings are added from the left, so
+later mappings overwrite earlier mappings.</div></p><p>See also the <a href="hashtables.html#%28elem._%28caveat._concurrency%29%29" data-pltdoc="x">caveats concerning concurrent modification</a> and the <a href="hashtables.html#%28elem._%28caveat._mutable-keys%29%29" data-pltdoc="x">caveat concerning mutable keys</a> above.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-set))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-set</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Functionally extends <span class="RktVar">hash</span> by mapping <span class="RktVar">key</span> to
+<span class="RktVar">v</span>, overwriting any existing mapping for <span class="RktVar">key</span>, and
+returning the extended hash table.</div></p><p>See also the <a href="hashtables.html#%28elem._%28caveat._mutable-keys%29%29" data-pltdoc="x">caveat concerning mutable keys</a> above.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._hash-set*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-set%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-set*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Functionally extends <span class="RktVar">hash</span> by mapping each <span class="RktVar">key</span> to
+<span class="RktVar">v</span>, overwriting any existing mapping for each <span class="RktVar">key</span>, and
+returning the extended hash table. Mappings are added from the left, so
+later mappings overwrite earlier mappings.</div></p><p>See also the <a href="hashtables.html#%28elem._%28caveat._mutable-keys%29%29" data-pltdoc="x">caveat concerning mutable keys</a> above.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-ref))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">failure-result</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">failure-result</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._failure-result%2Fc%29%29" class="RktValLink" data-pltdoc="x">failure-result/c</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns the value for <span class="RktVar">key</span> in <span class="RktVar">hash</span>. If no value
+is found for <span class="RktVar">key</span>, then <span class="RktVar">failure-result</span> determines the
+result:</div></p><ul><li><p>If <span class="RktVar">failure-result</span> is a procedure, it is called
+(through a tail call) with no arguments to produce the result.</p></li><li><p>Otherwise, <span class="RktVar">failure-result</span> is returned as the result.</p></li></ul><p>See also the <a href="hashtables.html#%28elem._%28caveat._concurrency%29%29" data-pltdoc="x">caveats concerning concurrent modification</a> and the <a href="hashtables.html#%28elem._%28caveat._mutable-keys%29%29" data-pltdoc="x">caveat concerning mutable keys</a> above.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-ref-key))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref-key%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-ref-key</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">failure-result</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">failure-result</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._failure-result%2Fc%29%29" class="RktValLink" data-pltdoc="x">failure-result/c</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns the key held by <span class="RktVar">hash</span> that is equivalent to <span class="RktVar">key</span>
+according to <span class="RktVar">hash</span>&rsquo;s key-comparison function. If no key is found,
+then <span class="RktVar">failure-result</span> is used as in <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span> to determine
+the result.</div></p><p>If <span class="RktVar">hash</span> is not an <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a>, then the returned key,
+assuming it is found, will be <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>-equivalent to the one
+actually retained by <span class="RktVar">hash</span>:</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">original-key</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">key-copy</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-copy%29%29" class="RktValLink" data-pltdoc="x">string-copy</a></span><span class="hspace">&nbsp;</span><span class="RktSym">original-key</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">original-key</span><span class="hspace">&nbsp;</span><span class="RktSym">key-copy</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">original-key</span><span class="hspace">&nbsp;</span><span class="RktSym">key-copy</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%21%29%29" class="RktValLink" data-pltdoc="x">hash-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table</span><span class="hspace">&nbsp;</span><span class="RktSym">original-key</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">value</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref-key%29%29" class="RktValLink" data-pltdoc="x">hash-ref-key</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">original-key</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref-key%29%29" class="RktValLink" data-pltdoc="x">hash-ref-key</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">key-copy</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p>If a mutable hash is updated multiple times using keys that are
+not <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>-equivalent but are equivalent according to the
+hash&rsquo;s key-comparison procedure, the hash retains the first one:</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">original-key</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">key-copy</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-copy%29%29" class="RktValLink" data-pltdoc="x">string-copy</a></span><span class="hspace">&nbsp;</span><span class="RktSym">original-key</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%21%29%29" class="RktValLink" data-pltdoc="x">hash-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table</span><span class="hspace">&nbsp;</span><span class="RktSym">original-key</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">one</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%21%29%29" class="RktValLink" data-pltdoc="x">hash-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table</span><span class="hspace">&nbsp;</span><span class="RktSym">key-copy</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">two</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref-key%29%29" class="RktValLink" data-pltdoc="x">hash-ref-key</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">original-key</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref-key%29%29" class="RktValLink" data-pltdoc="x">hash-ref-key</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">key-copy</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara">Conversely, an immutable hash retains the key that was most-recently
+used to update it:
+</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">original-key</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">key-copy</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-copy%29%29" class="RktValLink" data-pltdoc="x">string-copy</a></span><span class="hspace">&nbsp;</span><span class="RktSym">original-key</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%29%29" class="RktValLink" data-pltdoc="x">hash-set</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table0</span><span class="hspace">&nbsp;</span><span class="RktSym">original-key</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">one</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%29%29" class="RktValLink" data-pltdoc="x">hash-set</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table1</span><span class="hspace">&nbsp;</span><span class="RktSym">key-copy</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">two</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref-key%29%29" class="RktValLink" data-pltdoc="x">hash-ref-key</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table2</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">original-key</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref-key%29%29" class="RktValLink" data-pltdoc="x">hash-ref-key</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table2</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">key-copy</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p></div></p><p>If <span class="RktVar">hash</span> is an <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a>, then the returned key
+will be determined as described in the documentation to
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-hash%29%29" class="RktValLink" data-pltdoc="x">impersonate-hash</a></span>.</p><p>See also the <a href="hashtables.html#%28elem._%28caveat._concurrency%29%29" data-pltdoc="x">caveats concerning concurrent modification</a> and the <a href="hashtables.html#%28elem._%28caveat._mutable-keys%29%29" data-pltdoc="x">caveat concerning mutable keys</a> above.</p><p class="SHistory">Added in version 7.4.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/more-scheme..rkt)._hash-ref!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-ref%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-ref!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">to-set</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">to-set</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._failure-result%2Fc%29%29" class="RktValLink" data-pltdoc="x">failure-result/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the value for <span class="RktVar">key</span> in <span class="RktVar">hash</span>.  If no value is
+found for <span class="RktVar">key</span>, then <span class="RktVar">to-set</span> determines the result as
+in <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span> (i.e., it is either a thunk that computes a value
+or a plain value), and this result is stored in <span class="RktVar">hash</span> for the
+<span class="RktVar">key</span>.  (Note that if <span class="RktVar">to-set</span> is a thunk, it is not
+invoked in tail position.)</div></p><p>See also the <a href="hashtables.html#%28elem._%28caveat._concurrency%29%29" data-pltdoc="x">caveats concerning concurrent modification</a> and the <a href="hashtables.html#%28elem._%28caveat._mutable-keys%29%29" data-pltdoc="x">caveat concerning mutable keys</a> above.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/more-scheme..rkt)._hash-has-key~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-has-key~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-has-key?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">hash</span> contains a value for the given
+<span class="RktVar">key</span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/more-scheme..rkt)._hash-update!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-update%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-update!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">key</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">updater</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">failure-result</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">updater</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">failure-result</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._failure-result%2Fc%29%29" class="RktValLink" data-pltdoc="x">failure-result/c</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Updates the value mapped by <span class="RktVar">key</span> in <span class="RktVar">hash</span> by applying <span class="RktVar">updater</span> to the value.
+The value returned by <span class="RktVar">updater</span> becomes the new mapping for <span class="RktVar">key</span>, overwriting the
+original value in <span class="RktVar">hash</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%21%29%29" class="RktValLink" data-pltdoc="x">hash-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-update%21%29%29" class="RktValLink" data-pltdoc="x">hash-update!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">h</span></td></tr><tr><td><p><span class="RktRes">'#hash((a . 6))</span></p></td></tr></table></blockquote></div></p><p>The optional <span class="RktVar">failure-result</span> argument is used when no mapping exists for <span class="RktVar">key</span>
+already, in the same manner as in <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-update%21%29%29" class="RktValLink" data-pltdoc="x">hash-update!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">hash-update!: no value found for key: 'b</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-update%21%29%29" class="RktValLink" data-pltdoc="x">hash-update!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">h</span></td></tr><tr><td><p><span class="RktRes">'#hash((b . 1))</span></p></td></tr></table></blockquote></div></p><p>See also the <a href="hashtables.html#%28elem._%28caveat._concurrency%29%29" data-pltdoc="x">caveats concerning concurrent modification</a> and the <a href="hashtables.html#%28elem._%28caveat._mutable-keys%29%29" data-pltdoc="x">caveat concerning mutable keys</a> above.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/more-scheme..rkt)._hash-update))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-update%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-update</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">updater</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">failure-result</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">updater</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">failure-result</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._failure-result%2Fc%29%29" class="RktValLink" data-pltdoc="x">failure-result/c</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise%29%29" class="RktValLink" data-pltdoc="x">raise</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Functionally updates the value mapped by <span class="RktVar">key</span> in <span class="RktVar">hash</span> by applying <span class="RktVar">updater</span>
+to the value and returning a new hash table. The value returned by <span class="RktVar">updater</span> becomes the new
+mapping for <span class="RktVar">key</span> in the returned hash table.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-update%29%29" class="RktValLink" data-pltdoc="x">hash-update</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#hash((a . 6))</span></p></td></tr></table></blockquote></div></p><p>The optional <span class="RktVar">failure-result</span> argument is used when no mapping exists for <span class="RktVar">key</span>
+already, in the same manner as in <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-update%29%29" class="RktValLink" data-pltdoc="x">hash-update</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">hash-update: no value found for key: 'b</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._hash-update%29%29" class="RktValLink" data-pltdoc="x">hash-update</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#hash((b . 1))</span></p></td></tr></table></blockquote></div></p><p>See also the <a href="hashtables.html#%28elem._%28caveat._mutable-keys%29%29" data-pltdoc="x">caveat concerning mutable keys</a> above.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-remove!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-remove!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Removes any existing mapping for <span class="RktVar">key</span> in <span class="RktVar">hash</span>.</div></p><p>See also the <a href="hashtables.html#%28elem._%28caveat._concurrency%29%29" data-pltdoc="x">caveats concerning concurrent modification</a> and the <a href="hashtables.html#%28elem._%28caveat._mutable-keys%29%29" data-pltdoc="x">caveat concerning mutable keys</a> above.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-remove))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-remove</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Functionally removes any existing mapping for <span class="RktVar">key</span> in
+<span class="RktVar">hash</span>, returning the fresh hash table.</div></p><p>See also the <a href="hashtables.html#%28elem._%28caveat._mutable-keys%29%29" data-pltdoc="x">caveat concerning mutable keys</a> above.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-clear!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-clear%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-clear!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Removes all mappings from <span class="RktVar">hash</span>.</div></p><p>If <span class="RktVar">hash</span> is not an <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a>, then all mappings are
+removed in constant time. If <span class="RktVar">hash</span> is an <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a>,
+then each key is removed one-by-one using <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%21%29%29" class="RktValLink" data-pltdoc="x">hash-remove!</a></span>.</p><p>See also the <a href="hashtables.html#%28elem._%28caveat._concurrency%29%29" data-pltdoc="x">caveats concerning concurrent modification</a> and the <a href="hashtables.html#%28elem._%28caveat._mutable-keys%29%29" data-pltdoc="x">caveat concerning mutable keys</a> above.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-clear))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-clear%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-clear</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Functionally removes all mappings from <span class="RktVar">hash</span>.</div></p><p>If <span class="RktVar">hash</span> is not a <a href="chaperones.html#%28tech._chaperone%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone</span></a>, then clearing is
+equivalent to creating a new <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash table</span></a>, and the operation is
+performed in constant time.  If <span class="RktVar">hash</span> is a <a href="chaperones.html#%28tech._chaperone%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone</span></a>,
+then each key is removed one-by-one using <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-remove%29%29" class="RktValLink" data-pltdoc="x">hash-remove</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._hash-copy-clear))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-copy-clear%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-copy-clear</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktPn">#:kind</span><span class="hspace">&nbsp;</span><span class="RktVar">kind</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">kind</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">immutable</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">mutable</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">weak</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">ephemeron</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces an empty <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash table</span></a> with the same key-comparison
+procedure as <span class="RktVar">hash</span>, with either the given <span class="RktVar">kind</span>
+or the same kind as the given <span class="RktVar">hash</span>.</div></p><p>If <span class="RktVar">kind</span> is not supplied or <span class="RktVal">#f</span>, produces a hash
+table of the same kind and mutability as the given <span class="RktVar">hash</span>.
+If <span class="RktVar">kind</span> is <span class="RktVal">'</span><span class="RktVal">immutable</span>, <span class="RktVal">'</span><span class="RktVal">mutable</span>,
+<span class="RktVal">'</span><span class="RktVal">weak</span>, or <span class="RktVal">'</span><span class="RktVal">ephemeron</span>, produces a table that&rsquo;s
+immutable, mutable with strongly-held keys, mutable with
+weakly-held keys, or mutable with ephemeron-held keys
+respectively.</p><p class="SHistory">Changed in version 8.5.0.2 of package <span class="stt">base</span>: Added the <span class="RktVar">kind</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-map))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-map%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-map</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">try-order?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">try-order?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Applies the procedure <span class="RktVar">proc</span> to each element in
+<span class="RktVar">hash</span> in an unspecified order, accumulating the results
+into a list. The procedure <span class="RktVar">proc</span> is called each time with a
+key and its value, and the procedure&rsquo;s individual results appear in
+order in the result list.</div></p><p>If a hash table is extended with new keys (either through
+<span class="RktVar">proc</span> or by another thread) while a <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-map%29%29" class="RktValLink" data-pltdoc="x">hash-map</a></span> or
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-for-each%29%29" class="RktValLink" data-pltdoc="x">hash-for-each</a></span> traversal is in process, arbitrary key&ndash;value
+pairs can be dropped or duplicated in the traversal. Key mappings can
+be deleted or remapped (by any thread) with no adverse affects; the
+change does not affect a traversal if the key has been seen already,
+otherwise the traversal skips a deleted key or uses the remapped key&rsquo;s
+new value.</p><p>See also the <a href="hashtables.html#%28elem._%28caveat._concurrency%29%29" data-pltdoc="x">caveats concerning concurrent modification</a> above.</p><p>If <span class="RktVar">try-order?</span> is true, then the order of keys and values
+passed to <span class="RktVar">proc</span> is normalized under certain
+circumstances&#8212;<wbr></wbr>including when every key is one of the following and
+with the following order (earlier bullets before later):</p><ul><li><p><a href="booleans.html#%28tech._boolean%29" class="techoutside" data-pltdoc="x"><span class="techinside">booleans</span></a> sorted <span class="RktVal">#f</span> before <span class="RktVal">#t</span>;</p></li><li><p><a href="characters.html#%28tech._character%29" class="techoutside" data-pltdoc="x"><span class="techinside">characters</span></a> sorted by <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3c~3f%29%29" class="RktValLink" data-pltdoc="x">char&lt;?</a></span>;</p></li><li><p><a href="numbers.html#%28tech._real._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">real numbers</span></a> sorted by <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span>;</p></li><li><p><a href="symbols.html#%28tech._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">symbols</span></a> sorted with <a href="symbols.html#%28tech._uninterned%29" class="techoutside" data-pltdoc="x"><span class="techinside">uninterned</span></a> symbols before
+<a href="symbols.html#%28tech._unreadable._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">unreadable symbols</span></a> before <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> symbols,
+then sorted by <span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3c~3f%29%29" class="RktValLink" data-pltdoc="x">symbol&lt;?</a></span>;</p></li><li><p><a href="keywords.html#%28tech._keyword%29" class="techoutside" data-pltdoc="x"><span class="techinside">keywords</span></a> sorted by <span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3c~3f%29%29" class="RktValLink" data-pltdoc="x">keyword&lt;?</a></span>;</p></li><li><p><a href="strings.html#%28tech._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">strings</span></a> sorted by <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3f%29%29" class="RktValLink" data-pltdoc="x">string&lt;?</a></span>;</p></li><li><p><a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte strings</span></a> sorted by <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3c~3f%29%29" class="RktValLink" data-pltdoc="x">bytes&lt;?</a></span>;</p></li><li><p><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span>;</p></li><li><p><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>; and</p></li><li><p><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>.</p></li></ul><p class="SHistory">Changed in version 6.3 of package <span class="stt">base</span>: Added the <span class="RktVar">try-order?</span> argument.<br/>Changed in version 7.1.0.7: Added guarantees for <span class="RktVar">try-order?</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._hash-map/copy))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-map%2Fcopy%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-map/copy</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktPn">#:kind</span><span class="hspace">&nbsp;</span><span class="RktVar">kind</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">kind</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">immutable</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">mutable</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">weak</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">ephemeron</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Applies the procedure <span class="RktVar">proc</span> to each element in
+<span class="RktVar">hash</span> in an unspecified order, accumulating the results
+into a new hash with the same key-comparison procedure as
+<span class="RktVar">hash</span>, with either the given <span class="RktVar">kind</span> or the same
+kind as the given <span class="RktVar">hash</span>.</div></p><p>If <span class="RktVar">kind</span> is not supplied or <span class="RktVal">#f</span>, produces a hash
+table of the same kind and mutability as the given <span class="RktVar">hash</span>.
+If <span class="RktVar">kind</span> is <span class="RktVal">'</span><span class="RktVal">immutable</span>, <span class="RktVal">'</span><span class="RktVal">mutable</span>,
+<span class="RktVal">'</span><span class="RktVal">weak</span>, or <span class="RktVal">'</span><span class="RktVal">ephemeron</span>, produces a table that&rsquo;s
+immutable, mutable with strongly-held keys, mutable with
+weakly-held keys, or mutable with ephemeron-held keys
+respectively.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-map%2Fcopy%29%29" class="RktValLink" data-pltdoc="x">hash-map/copy</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"banana"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-upcase%29%29" class="RktValLink" data-pltdoc="x">string-upcase</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'#hash((a . "APPLE") (b . "BANANA"))</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">frozen-capital</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-map%2Fcopy%29%29" class="RktValLink" data-pltdoc="x">hash-map/copy</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"apple"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-upcase%29%29" class="RktValLink" data-pltdoc="x">string-upcase</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:kind</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">immutable</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">frozen-capital</span></td></tr><tr><td><p><span class="RktRes">'#hash((a . "APPLE") (b . "BANANA"))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">frozen-capital</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 8.5.0.2 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._hash-keys))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-keys%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-keys</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">try-order?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">try-order?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of the keys of <span class="RktVar">hash</span> in an unspecified order.</div></p><p><div class="SIntrapara">If <span class="RktVar">try-order?</span> is true, then the order of keys is normalized under
+certain circumstances.  See <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-map%29%29" class="RktValLink" data-pltdoc="x">hash-map</a></span> for further explanations on
+<span class="RktVar">try-order?</span> and on information about modifying <span class="RktVar">hash</span> during
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-keys%29%29" class="RktValLink" data-pltdoc="x">hash-keys</a></span>. </div><div class="SIntrapara">See also the <a href="hashtables.html#%28elem._%28caveat._concurrency%29%29" data-pltdoc="x">caveats concerning concurrent modification</a> above.</div></p><p class="SHistory">Changed in version 8.3.0.11 of package <span class="stt">base</span>: Added the <span class="RktVar">try-order?</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._hash-values))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-values%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-values</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">try-order?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">try-order?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of the values of <span class="RktVar">hash</span> in an unspecified order.</div></p><p><div class="SIntrapara">If <span class="RktVar">try-order?</span> is true, then the order of values is normalized under
+certain circumstances, based on the ordering of the associated keys.
+See <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-map%29%29" class="RktValLink" data-pltdoc="x">hash-map</a></span> for further explanations on <span class="RktVar">try-order?</span> and on
+information about modifying <span class="RktVar">hash</span> during
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-values%29%29" class="RktValLink" data-pltdoc="x">hash-values</a></span>. </div><div class="SIntrapara">See also the <a href="hashtables.html#%28elem._%28caveat._concurrency%29%29" data-pltdoc="x">caveats concerning concurrent modification</a> above.</div></p><p class="SHistory">Changed in version 8.3.0.11 of package <span class="stt">base</span>: Added the <span class="RktVar">try-order?</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._hash-~3elist))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-~3elist%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-&gt;list</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">try-order?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">try-order?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of the key&ndash;value pairs of <span class="RktVar">hash</span> in an unspecified order.</div></p><p><div class="SIntrapara">If <span class="RktVar">try-order?</span> is true, then the order of keys and values is normalized
+under certain circumstances. See <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-map%29%29" class="RktValLink" data-pltdoc="x">hash-map</a></span> for further explanations on
+<span class="RktVar">try-order?</span> and on information about modifying <span class="RktVar">hash</span> during
+<span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-~3elist%29%29" class="RktValLink" data-pltdoc="x">hash-&gt;list</a></span>. </div><div class="SIntrapara">See also the <a href="hashtables.html#%28elem._%28caveat._concurrency%29%29" data-pltdoc="x">caveats concerning concurrent modification</a> above.</div></p><p class="SHistory">Changed in version 8.3.0.11 of package <span class="stt">base</span>: Added the <span class="RktVar">try-order?</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-keys-subset~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-keys-subset~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-keys-subset?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash1</span><span class="hspace">&nbsp;</span><span class="RktVar">hash2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if the keys of <span class="RktVar">hash1</span> are a subset of or
+the same as the keys of <span class="RktVar">hash2</span>. The hash tables must both use
+the same key-comparison function (<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>,
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p>Using <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-keys-subset~3f%29%29" class="RktValLink" data-pltdoc="x">hash-keys-subset?</a></span> on immutable hash tables can be much
+faster than iterating through the keys of <span class="RktVar">hash1</span> to make sure
+that each is in <span class="RktVar">hash2</span>.</p><p class="SHistory">Added in version 6.5.0.8 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-for-each))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-for-each%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-for-each</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">try-order?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">try-order?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Applies <span class="RktVar">proc</span> to each element in <span class="RktVar">hash</span> (for the
+side-effects of <span class="RktVar">proc</span>) in an unspecified order. The procedure
+<span class="RktVar">proc</span> is called each time with a key and its value.</div></p><p><div class="SIntrapara">See <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-map%29%29" class="RktValLink" data-pltdoc="x">hash-map</a></span> for information about <span class="RktVar">try-order?</span> and
+about modifying <span class="RktVar">hash</span> within <span class="RktVar">proc</span>.
+</div><div class="SIntrapara">See also the <a href="hashtables.html#%28elem._%28caveat._concurrency%29%29" data-pltdoc="x">caveats concerning concurrent modification</a> above.</div></p><p class="SHistory">Changed in version 6.3 of package <span class="stt">base</span>: Added the <span class="RktVar">try-order?</span> argument.<br/>Changed in version 7.1.0.7: Added guarantees for <span class="RktVar">try-order?</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-count))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-count%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-count</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the number of keys mapped by <span class="RktVar">hash</span>.</div></p><p>For the <a href="implementations.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a> implementation of Racket, the result is always
+computed in constant time and atomically. For the <a href="implementations.html#%28tech._bc%29" class="techoutside" data-pltdoc="x"><span class="techinside">BC</span></a> implementation
+of Racket, the result is computed in constant time and atomically only if
+<span class="RktVar">hash</span> does not retain keys weakly or like an <a href="ephemerons.html#%28tech._ephemeron%29" class="techoutside" data-pltdoc="x"><span class="techinside">ephemeron</span></a>,
+otherwise, a traversal is required to count the keys.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._hash-empty~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._hash-empty~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-empty?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-count%29%29" class="RktValLink" data-pltdoc="x">hash-count</a></span><span class="stt"> </span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-iterate-first))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-first%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-iterate-first</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#f</span> if <span class="RktVar">hash</span> contains no elements, otherwise
+it returns an integer that is an index to the first element in the hash
+table; &ldquo;first&rdquo; refers to an unspecified ordering of the table
+elements, and the index values are not necessarily consecutive
+integers.</div></p><p>For a mutable <span class="RktVar">hash</span>, this index is guaranteed to refer to the
+first item only as long as no items are added to or removed from
+<span class="RktVar">hash</span>. More generally, an index is guaranteed to be a
+<a name="(tech._valid._hash._index)"></a><span style="font-style: italic">valid hash index</span> for a given hash table only as long it
+comes from <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-first%29%29" class="RktValLink" data-pltdoc="x">hash-iterate-first</a></span> or <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-next%29%29" class="RktValLink" data-pltdoc="x">hash-iterate-next</a></span>,
+and only as long as the hash table is not modified. In the case of a
+hash table with weakly held keys or keys held like <a href="ephemerons.html#%28tech._ephemeron%29" class="techoutside" data-pltdoc="x"><span class="techinside">ephemerons</span></a>,
+the hash table can be implicitly modified by the garbage collector
+(see <a href="eval-model.html#%28part._gc-model%29" data-pltdoc="x">Garbage Collection</a>) when it discovers that the key is not
+reachable.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-iterate-next))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-next%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-iterate-next</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns either an integer that is an index to the element in
+<span class="RktVar">hash</span> after the element indexed by <span class="RktVar">pos</span> (which is not
+necessarily one more than <span class="RktVar">pos</span>) or <span class="RktVal">#f</span> if <span class="RktVar">pos</span>
+refers to the last element in <span class="RktVar">hash</span>.</div></p><p>If <span class="RktVar">pos</span> is not a <a href="hashtables.html#%28tech._valid._hash._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">valid hash index</span></a> of <span class="RktVar">hash</span>,
+then the result may be <span class="RktVal">#f</span> or it may be the next later index
+that remains valid. The latter result is guaranteed if a hash table
+has been modified only by the removal of keys.</p><p class="SHistory">Changed in version 7.0.0.10 of package <span class="stt">base</span>: Handle an invalid index by returning <span class="RktVal">#f</span>
+instead of raising <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-iterate-key))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-key%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-iterate-key</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-key%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-iterate-key</a></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns the key for the element in <span class="RktVar">hash</span> at index
+<span class="RktVar">pos</span>.</div></p><p>If <span class="RktVar">pos</span> is not a <a href="hashtables.html#%28tech._valid._hash._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">valid hash index</span></a> for <span class="RktVar">hash</span>,
+the result is <span class="RktVar">bad-index-v</span> if provided, otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p class="SHistory">Changed in version 7.0.0.10 of package <span class="stt">base</span>: Added the optional <span class="RktVar">bad-index-v</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-iterate-value))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-iterate-value</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-iterate-value</a></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns the value for the element in <span class="RktVar">hash</span> at index
+<span class="RktVar">pos</span>.</div></p><p>If <span class="RktVar">pos</span> is not a <a href="hashtables.html#%28tech._valid._hash._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">valid hash index</span></a> for <span class="RktVar">hash</span>,
+the result is <span class="RktVar">bad-index-v</span> if provided, otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p class="SHistory">Changed in version 7.0.0.10 of package <span class="stt">base</span>: Added the optional <span class="RktVar">bad-index-v</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-iterate-pair))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-pair%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-iterate-pair</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-pair%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-iterate-pair</a></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns a pair containing the key and value for the element
+in <span class="RktVar">hash</span> at index <span class="RktVar">pos</span>.</div></p><p>If <span class="RktVar">pos</span> is not a <a href="hashtables.html#%28tech._valid._hash._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">valid hash index</span></a> for <span class="RktVar">hash</span>,
+the result is <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="stt"> </span><span class="RktVar">bad-index-v</span><span class="stt"> </span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span> if
+<span class="RktVar">bad-index-v</span> is provided, otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p class="SHistory">Added in version 6.4.0.5 of package <span class="stt">base</span>.<br/>Changed in version 7.0.0.10: Added the optional <span class="RktVar">bad-index-v</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-iterate-key+value))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-key%2Bvalue%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-iterate-key+value</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-key%2Bvalue%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-iterate-key+value</a></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bad-index-v</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns the key and value for the element in <span class="RktVar">hash</span> at index
+<span class="RktVar">pos</span>.</div></p><p>If <span class="RktVar">pos</span> is not a <a href="hashtables.html#%28tech._valid._hash._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">valid hash index</span></a> for <span class="RktVar">hash</span>,
+the result is <span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="stt"> </span><span class="RktVar">bad-index-v</span><span class="stt"> </span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span> if
+<span class="RktVar">bad-index-v</span> is provided, otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p class="SHistory">Added in version 6.4.0.5 of package <span class="stt">base</span>.<br/>Changed in version 7.0.0.10: Added the optional <span class="RktVar">bad-index-v</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-copy))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-copy%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-copy</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a mutable hash table with the same mappings, same
+key-comparison mode, and same key-holding strength as <span class="RktVar">hash</span>.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Additional_Hash_Table_Functions&quot;">4.15.1<tt>&nbsp;</tt><a name="(part._.Additional_.Hash_.Table_.Functions)"></a><a name="(mod-path._racket/hash)"></a>Additional Hash Table Functions</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="hashtables.html#%28mod-path._racket%2Fhash%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/hash</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="hashtables.html#%28mod-path._racket%2Fhash%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/hash</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/hash..rkt)._hash-union))"></a><span title="Provided from: racket/hash | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fhash..rkt%29._hash-union%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-union</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">h0</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">h</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:combine</span><span class="hspace">&nbsp;</span><span class="RktVar">combine</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:combine/key</span><span class="hspace">&nbsp;</span><span class="RktVar">combine/key</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">h0</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">h</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">combine</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">hash-union</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">combine/key</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">combine</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Computes the union of <span class="RktVar">h0</span> with each hash table <span class="RktVar">h</span> by functional
+update, adding each element of each <span class="RktVar">h</span> to <span class="RktVar">h0</span> in turn.  For each
+key <span class="RktSym">k</span> and value <span class="RktSym">v</span>, if a mapping from <span class="RktSym">k</span> to some value
+<span class="RktSym">v0</span> already exists, it is replaced with a mapping from <span class="RktSym">k</span> to
+<span class="RktPn">(</span><span class="RktVar">combine/key</span><span class="stt"> </span><span class="RktSym">k</span><span class="stt"> </span><span class="RktSym">v0</span><span class="stt"> </span><span class="RktSym">v</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fhash..rkt%29._hash-union%29%29" class="RktValLink" data-pltdoc="x">hash-union</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hash%29%29" class="RktValLink" data-pltdoc="x">make-immutable-hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">[</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">one</span><span class="RktVal">]</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hash%29%29" class="RktValLink" data-pltdoc="x">make-immutable-hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">[</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">two</span><span class="RktVal">]</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hash%29%29" class="RktValLink" data-pltdoc="x">make-immutable-hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">[</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">three</span><span class="RktVal">]</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'#hash((1 . one) (2 . two) (3 . three))</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fhash..rkt%29._hash-union%29%29" class="RktValLink" data-pltdoc="x">hash-union</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hash%29%29" class="RktValLink" data-pltdoc="x">make-immutable-hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">[</span><span class="RktVal">1</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">one</span><span class="hspace">&nbsp;</span><span class="RktVal">uno</span><span class="RktVal">]</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">[</span><span class="RktVal">2</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">two</span><span class="hspace">&nbsp;</span><span class="RktVal">dos</span><span class="RktVal">]</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hash%29%29" class="RktValLink" data-pltdoc="x">make-immutable-hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">[</span><span class="RktVal">1</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">eins</span><span class="hspace">&nbsp;</span><span class="RktVal">un</span><span class="RktVal">]</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">[</span><span class="RktVal">2</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">zwei</span><span class="hspace">&nbsp;</span><span class="RktVal">deux</span><span class="RktVal">]</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:combine/key</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">v1</span><span class="hspace">&nbsp;</span><span class="RktSym">v2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._append%29%29" class="RktValLink" data-pltdoc="x">append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v1</span><span class="hspace">&nbsp;</span><span class="RktSym">v2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'#hash((1 . (one uno eins un)) (2 . (two dos zwei deux)))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/hash..rkt)._hash-union!))"></a><span title="Provided from: racket/hash | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fhash..rkt%29._hash-union%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-union!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">h0</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">h</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:combine</span><span class="hspace">&nbsp;</span><span class="RktVar">combine</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:combine/key</span><span class="hspace">&nbsp;</span><span class="RktVar">combine/key</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">h0</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">h</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">combine</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">hash-union</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">combine/key</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">combine</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Computes the union of <span class="RktVar">h0</span> with each hash table <span class="RktVar">h</span> by mutable
+update, adding each element of each <span class="RktVar">h</span> to <span class="RktVar">h0</span> in turn.  For each
+key <span class="RktSym">k</span> and value <span class="RktSym">v</span>, if a mapping from <span class="RktSym">k</span> to some value
+<span class="RktSym">v0</span> already exists, it is replaced with a mapping from <span class="RktSym">k</span> to
+<span class="RktPn">(</span><span class="RktVar">combine/key</span><span class="stt"> </span><span class="RktSym">k</span><span class="stt"> </span><span class="RktSym">v0</span><span class="stt"> </span><span class="RktSym">v</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktVar">h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVar">h</span></td></tr><tr><td><p><span class="RktRes">'#hash()</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fhash..rkt%29._hash-union%21%29%29" class="RktValLink" data-pltdoc="x">hash-union!</a></span><span class="hspace">&nbsp;</span><span class="RktVar">h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hash%29%29" class="RktValLink" data-pltdoc="x">make-immutable-hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">[</span><span class="RktVal">1</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">one</span><span class="hspace">&nbsp;</span><span class="RktVal">uno</span><span class="RktVal">]</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">[</span><span class="RktVal">2</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">two</span><span class="hspace">&nbsp;</span><span class="RktVal">dos</span><span class="RktVal">]</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVar">h</span></td></tr><tr><td><p><span class="RktRes">'#hash((1 . (one uno)) (2 . (two dos)))</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fhash..rkt%29._hash-union%21%29%29" class="RktValLink" data-pltdoc="x">hash-union!</a></span><span class="hspace">&nbsp;</span><span class="RktVar">h</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hash%29%29" class="RktValLink" data-pltdoc="x">make-immutable-hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">[</span><span class="RktVal">1</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">eins</span><span class="hspace">&nbsp;</span><span class="RktVal">un</span><span class="RktVal">]</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">[</span><span class="RktVal">2</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">zwei</span><span class="hspace">&nbsp;</span><span class="RktVal">deux</span><span class="RktVal">]</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:combine/key</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">v1</span><span class="hspace">&nbsp;</span><span class="RktSym">v2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._append%29%29" class="RktValLink" data-pltdoc="x">append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v1</span><span class="hspace">&nbsp;</span><span class="RktSym">v2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVar">h</span></td></tr><tr><td><p><span class="RktRes">'#hash((1 . (one uno eins un)) (2 . (two dos zwei deux)))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/hash..rkt)._hash-intersect))"></a><span title="Provided from: racket/hash | Package: base"><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fhash..rkt%29._hash-intersect%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-intersect</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">h0</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">h</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:combine</span><span class="hspace">&nbsp;</span><span class="RktVar">combine</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:combine/key</span><span class="hspace">&nbsp;</span><span class="RktVar">combine/key</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">h0</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">h</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">combine</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">hash-intersect</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">combine/key</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">combine</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Constructs the hash table which is the intersection of <span class="RktVar">h0</span>
+with every hash table <span class="RktVar">h</span>.  In the resulting hash table, a key
+<span class="RktSym">k</span> is mapped to a combination of the values to which
+<span class="RktSym">k</span> is mapped in each of the hash tables.  The final values are
+computed by stepwise combination of the values appearing in each of
+the hash tables by applying <span class="RktPn">(</span><span class="RktVar">combine/key</span><span class="stt"> </span><span class="RktSym">k</span><span class="stt"> </span><span class="RktSym">v</span><span class="stt"> </span><span class="RktSym">vi</span><span class="RktPn">)</span> or
+<span class="RktPn">(</span><span class="RktVar">combine</span><span class="stt"> </span><span class="RktSym">v</span><span class="stt"> </span><span class="RktSym">vi</span><span class="RktPn">)</span>, where <span class="RktSym">vi</span> is the value to which
+<span class="RktSym">k</span> is mapped in the i-th hash table <span class="RktVar">h</span>, and
+<span class="RktSym">v</span> is the accumulation of the values from the previous steps.
+The comparison predicate of the first argument (<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>,
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>) determines the
+one for the result.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fhash..rkt%29._hash-intersect%29%29" class="RktValLink" data-pltdoc="x">hash-intersect</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hash%29%29" class="RktValLink" data-pltdoc="x">make-immutable-hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">c</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hash%29%29" class="RktValLink" data-pltdoc="x">make-immutable-hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">5</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:combine</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'#hash((a . 5) (b . 7))</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28lib._racket%2Fhash..rkt%29._hash-intersect%29%29" class="RktValLink" data-pltdoc="x">hash-intersect</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hash%29%29" class="RktValLink" data-pltdoc="x">make-immutable-hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">c</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hash%29%29" class="RktValLink" data-pltdoc="x">make-immutable-hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">5</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:combine/key</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">v1</span><span class="hspace">&nbsp;</span><span class="RktSym">v2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v1</span><span class="hspace">&nbsp;</span><span class="RktSym">v2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">v1</span><span class="hspace">&nbsp;</span><span class="RktSym">v2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'#hash((a . 5) (b . -3))</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 7.9.0.1 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="boxes.html" title="backward to &quot;4.14 Boxes&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="sequences_streams.html" title="forward to &quot;4.16 Sequences and Streams&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/icons.css b/clones/docs.racket-lang.org/reference/icons.css
new file mode 100644
index 00000000..4923ee0f
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/icons.css
@@ -0,0 +1,8 @@
+.imageleft {
+  float: left;
+  margin-right: 0.3em;
+}
+
+.imageleft img {
+  width: 1.5em;
+}
diff --git a/clones/docs.racket-lang.org/reference/if.html b/clones/docs.racket-lang.org/reference/if.html
new file mode 100644
index 00000000..da59e635
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/if.html
@@ -0,0 +1,42 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.12&nbsp;Conditionals: if, cond, and, and or</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewselflink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">if</span></span></a></td></tr><tr><td><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">cond</span></span></a></td></tr><tr><td><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">else</span></span></a></td></tr><tr><td><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">=&gt;</span></span></a></td></tr><tr><td><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">and</span></span></a></td></tr><tr><td><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="shared.html" title="backward to &quot;3.11 Constructing Graphs: shared&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="case.html" title="forward to &quot;3.13 Dispatch: case&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;if&quot;">3.12<tt>&nbsp;</tt><a name="(part._if)"></a>Conditionals: <span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span>, <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span>, <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span>, and <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span></h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=conditionals.html&amp;version=8.6" class="Sq" data-pltdoc="x">Conditionals</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces conditionals.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._if))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">if</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">test-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">then-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">else-expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Evaluates <span class="RktVar">test-expr</span>. If it produces any value other than
+<span class="RktVal">#f</span>, then <span class="RktVar">then-expr</span> is evaluated, and its results are
+the result for the <span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span> form. Otherwise, <span class="RktVar">else-expr</span> is
+evaluated, and its results are the result for the <span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span>
+form. The <span class="RktVar">then-expr</span> and <span class="RktVar">else-expr</span> are in tail
+position with respect to the <span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span> form.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-5</span></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"doesn't get here"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"doesn't get here"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">we-have-no-bananas</span><span class="hspace">&nbsp;</span><span class="RktVal">"yes"</span><span class="hspace">&nbsp;</span><span class="RktVal">"no"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"yes"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/letstx-scheme..rkt)._cond))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">cond</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">cond-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">cond-clause</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">test-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">then-body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktVar">then-body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">test-expr</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktVar">proc-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">test-expr</span><span class="RktPn">]</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=conditionals.html%23%2528part._cond%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Chaining Tests: <span class="RktSym"><span class="RktStxLink">cond</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span>.</p></blockquote></blockquote></blockquote></div></p><p>A <span class="RktVar">cond-clause</span> that starts with <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span> must be the last
+<span class="RktVar">cond-clause</span>.</p><p>If no <span class="RktVar">cond-clause</span>s are present, the result is <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</p><p>If only a <span class="RktPn">[</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span><span class="stt"> </span><span class="RktVar">then-body</span><span class="stt"> </span><span class="RktMeta"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-patterns.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._......%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...+</a></span><span class="RktPn">]</span> is present, then the
+<span class="RktVar">then-body</span>s are evaluated. The results from all but the last
+<span class="RktVar">then-body</span> are ignored. The results of the last
+<span class="RktVar">then-body</span>, which is in tail position with respect to the
+<span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span> form, are the results for the whole <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span>
+form.</p><p>Otherwise, the first <span class="RktVar">test-expr</span> is evaluated. If it produces
+<span class="RktVal">#f</span>, then the result is the same as a <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span> form with
+the remaining <span class="RktVar">cond-clause</span>s, in tail position with respect to
+the original <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span> form. Otherwise, evaluation depends on the
+form of the <span class="RktVar">cond-clause</span>:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">[</span><span class="RktVar">test-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">then-body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span></td></tr></table></blockquote><p>The <span class="RktVar">then-body</span>s are
+evaluated in order, and the results from all but the last
+<span class="RktVar">then-body</span> are ignored. The results of the last
+<span class="RktVar">then-body</span>, which is in tail position with respect to the
+<span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span> form, provides the result for the whole <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span>
+form.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">[</span><span class="RktVar">test-expr</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktVar">proc-expr</span><span class="RktPn">]</span></td></tr></table></blockquote><p>The <span class="RktVar">proc-expr</span> is
+evaluated, and it must produce a procedure that accepts one argument,
+otherwise the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. The procedure is applied
+to the result of <span class="RktVar">test-expr</span> in tail position with respect to
+the <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span> expression.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">[</span><span class="RktVar">test-expr</span><span class="RktPn">]</span></td></tr></table></blockquote><p>The result of the <span class="RktVar">test-expr</span> is
+returned as the result of the <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span> form. The
+<span class="RktVar">test-expr</span> is not in tail position.</p></blockquote><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-5</span></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"doesn't get here"</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-5</span></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"doesn't get here, either"</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">here</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'here</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(-2 -3)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(2 3)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/private/letstx-scheme..rkt)._else))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">else</a></span></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Recognized specially within forms like <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span>. An
+<span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span> form as an expression is a syntax error.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/private/letstx-scheme..rkt)._~3d~3e))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">=&gt;</a></span></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Recognized specially within forms like <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span>. A
+<span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span> form as an expression is a syntax error.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/letstx-scheme..rkt)._and))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">and</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=conditionals.html%23%2528part._and%252Bor%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Combining Tests: <span class="RktSym"><span class="RktStxLink">and</span></span> and <span class="RktSym"><span class="RktStxLink">or</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span>.</p></blockquote></blockquote></blockquote></div></p><p>If no <span class="RktVar">expr</span>s are provided, then result is <span class="RktVal">#t</span>.</p><p>If a single <span class="RktVar">expr</span> is provided, then it is in tail position, so
+the results of the <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span> expression are the results of the
+<span class="RktVar">expr</span>.</p><p>Otherwise, the first <span class="RktVar">expr</span> is evaluated. If it produces
+<span class="RktVal">#f</span>, the result of the <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span> expression is
+<span class="RktVal">#f</span>. Otherwise, the result is the same as an <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span>
+expression with the remaining <span class="RktVar">expr</span>s in tail position with
+respect to the original <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span> form.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"doesn't get here"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/letstx-scheme..rkt)._or))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">or</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=conditionals.html%23%2528part._and%252Bor%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Combining Tests: <span class="RktSym"><span class="RktStxLink">and</span></span> and <span class="RktSym"><span class="RktStxLink">or</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span>.</p></blockquote></blockquote></blockquote></div></p><p>If no <span class="RktVar">expr</span>s are provided, then result is <span class="RktVal">#f</span>.</p><p>If a single <span class="RktVar">expr</span> is provided, then it is in tail position, so
+the results of the <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span> expression are the results of the
+<span class="RktVar">expr</span>.</p><p>Otherwise, the first <span class="RktVar">expr</span> is evaluated. If it produces a
+value other than <span class="RktVal">#f</span>, that result is the result of the
+<span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span> expression. Otherwise, the result is the same as an
+<span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span> expression with the remaining <span class="RktVar">expr</span>s in tail
+position with respect to the original <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span> form.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"doesn't get here"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="shared.html" title="backward to &quot;3.11 Constructing Graphs: shared&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="case.html" title="forward to &quot;3.13 Dispatch: case&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/implementations.html b/clones/docs.racket-lang.org/reference/implementations.html
new file mode 100644
index 00000000..9316fb4e
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/implementations.html
@@ -0,0 +1,26 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>1.5&nbsp;Implementations</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewselflink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">1.1&nbsp;</td><td><a href="eval-model.html" class="tocviewlink" data-pltdoc="x">Evaluation Model</a></td></tr><tr><td align="right">1.2&nbsp;</td><td><a href="syntax-model.html" class="tocviewlink" data-pltdoc="x">Syntax Model</a></td></tr><tr><td align="right">1.3&nbsp;</td><td><a href="reader.html" class="tocviewlink" data-pltdoc="x">The Reader</a></td></tr><tr><td align="right">1.4&nbsp;</td><td><a href="printing.html" class="tocviewlink" data-pltdoc="x">The Printer</a></td></tr><tr><td align="right">1.5&nbsp;</td><td><a href="implementations.html" class="tocviewselflink" data-pltdoc="x">Implementations</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="printing.html" title="backward to &quot;1.4 The Printer&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="model.html" title="up to &quot;1 Language Model&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="notation.html" title="forward to &quot;2 Notation for Documentation&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;implementations&quot;">1.5<tt>&nbsp;</tt><a name="(part._implementations)"></a>Implementations</h4><p>The definition of Racket aims for determinism and independence from
+its implementation. Nevertheless, some details inevitably vary with
+the implementation. Racket currently has two main implementations:</p><ul><li><p>The <a name="(tech._c)"></a><span style="font-style: italic">CS</span> implementation is the default implementation
+as of Racket version 8.0. This variant is called &ldquo;CS&rdquo; because
+it uses Chez Scheme as its core compiler and runtime system.</p><p>The CS implementation typically provides the best performance
+for Racket programs. Compiled Racket CS code in a
+<span class="stt">".zo"</span> file normally contains machine code that is
+specific to an operating system and architecture.</p></li><li><p>The <a name="(tech._bc)"></a><span style="font-style: italic">BC</span> implementation was the default implementation
+up until version 7.9. The &ldquo;BC&rdquo; label stands for &ldquo;before
+Chez&rdquo; or &ldquo;bytecode.&rdquo;</p><p>Compiled Racket BC code in a <span class="stt">".zo"</span> file normally
+contains platform-independent bytecode that is further compiled
+to machine code &ldquo;just in time&rdquo; as the code is loaded.</p><p>Racket BC has two variants: <a name="(tech._3m)"></a><span style="font-style: italic">3m</span> and <a name="(tech._cgc)"></a><span style="font-style: italic">CGC</span>.
+The difference is the <a href="eval-model.html#%28tech._garbage._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">garbage collection</span></a> implementation,
+where 3m uses a garbage collector that moves objects in memory
+(an effect that is visible to foreign libraries, for example)
+and keeps precise track of allocated objects, while CGC uses a
+&ldquo;conservative&rdquo; collector that requires less cooperation from
+an embedding foreign environment. The 3m subvariant tends to
+perform much better than CGC, and it became the default
+variant in version 370 (which would be v3.7 in the current
+versioning convention).</p></li></ul><p>Most Racket programs run the same in all implementation variants, but some Racket
+features are available only on some implementation variants, and the
+interaction of Racket and foreign functions is significantly different
+across the variants. Use <span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span> to get information about
+the current running implementation.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="printing.html" title="backward to &quot;1.4 The Printer&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="model.html" title="up to &quot;1 Language Model&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="notation.html" title="forward to &quot;2 Notation for Documentation&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/include.html b/clones/docs.racket-lang.org/reference/include.html
new file mode 100644
index 00000000..4827e340
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/include.html
@@ -0,0 +1,28 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>12.11&nbsp;File Inclusion</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">12.1&nbsp;</td><td><a href="stx-patterns.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Syntax Matching</a></td></tr><tr><td align="right">12.2&nbsp;</td><td><a href="stxops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Content</a></td></tr><tr><td align="right">12.3&nbsp;</td><td><a href="stxcmp.html" class="tocviewlink" data-pltdoc="x">Syntax Object Bindings</a></td></tr><tr><td align="right">12.4&nbsp;</td><td><a href="stxtrans.html" class="tocviewlink" data-pltdoc="x">Syntax Transformers</a></td></tr><tr><td align="right">12.5&nbsp;</td><td><a href="stxparam.html" class="tocviewlink" data-pltdoc="x">Syntax Parameters</a></td></tr><tr><td align="right">12.6&nbsp;</td><td><a href="splicing.html" class="tocviewlink" data-pltdoc="x">Local Binding with Splicing Body</a></td></tr><tr><td align="right">12.7&nbsp;</td><td><a href="stxprops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Properties</a></td></tr><tr><td align="right">12.8&nbsp;</td><td><a href="stxcerts.html" class="tocviewlink" data-pltdoc="x">Syntax Taints</a></td></tr><tr><td align="right">12.9&nbsp;</td><td><a href="Expanding_Top-Level_Forms.html" class="tocviewlink" data-pltdoc="x">Expanding Top-<wbr></wbr>Level Forms</a></td></tr><tr><td align="right">12.10&nbsp;</td><td><a href="Serializing_Syntax.html" class="tocviewlink" data-pltdoc="x">Serializing Syntax</a></td></tr><tr><td align="right">12.11&nbsp;</td><td><a href="include.html" class="tocviewselflink" data-pltdoc="x">File Inclusion</a></td></tr><tr><td align="right">12.12&nbsp;</td><td><a href="syntax-util.html" class="tocviewlink" data-pltdoc="x">Syntax Utilities</a></td></tr><tr><td align="right">12.13&nbsp;</td><td><a href="phase_space.html" class="tocviewlink" data-pltdoc="x">Phase and Space Utilities</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="include.html#%28form._%28%28lib._racket%2Finclude..rkt%29._include%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">include</span></span></a></td></tr><tr><td><a href="include.html#%28form._%28%28lib._racket%2Finclude..rkt%29._include-at%2Frelative-to%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">include-<wbr></wbr>at/<span class="mywbr"> &nbsp;</span>relative-<wbr></wbr>to</span></span></a></td></tr><tr><td><a href="include.html#%28form._%28%28lib._racket%2Finclude..rkt%29._include%2Freader%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">include/<span class="mywbr"> &nbsp;</span>reader</span></span></a></td></tr><tr><td><a href="include.html#%28form._%28%28lib._racket%2Finclude..rkt%29._include-at%2Frelative-to%2Freader%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">include-<wbr></wbr>at/<span class="mywbr"> &nbsp;</span>relative-<wbr></wbr>to/<span class="mywbr"> &nbsp;</span>reader</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Serializing_Syntax.html" title="backward to &quot;12.10 Serializing Syntax&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="syntax-util.html" title="forward to &quot;12.12 Syntax Utilities&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;include&quot;">12.11<tt>&nbsp;</tt><a name="(part._include)"></a><a name="(mod-path._racket/include)"></a>File Inclusion</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="include.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/include</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="include.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/include</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/include..rkt)._include))"></a><span title="Provided from: racket/include, racket | Package: base"><span class="RktSym"><a href="include.html#%28form._%28%28lib._racket%2Finclude..rkt%29._include%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">include</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path-spec</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">path-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">string</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._file%29%29" class="RktStxLink" data-pltdoc="x">file</a></span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Inlines the syntax in the file designated by <span class="RktVar">path-spec</span> in
+place of the <span class="RktSym"><a href="include.html#%28form._%28%28lib._racket%2Finclude..rkt%29._include%29%29" class="RktStxLink" data-pltdoc="x">include</a></span> expression.</div></p><p>A <span class="RktVar">path-spec</span> resembles a subset of the <span class="RktVar">mod-path</span>
+forms for <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>, but it specifies a file whose content need
+not be a module. That is, <span class="RktVar">string</span> refers to a file using a
+platform-independent relative path, <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._file%29%29" class="RktStxLink" data-pltdoc="x">file</a></span><span class="stt"> </span><span class="RktVar">string</span><span class="RktPn">)</span> refers to a
+file using platform-specific notation, and <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span><span class="stt"> </span><span class="RktVar">string</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>
+refers to a file within a collection.</p><p>If <span class="RktVar">path-spec</span> specifies a relative path, the path is resolved
+relative to the source for the <span class="RktSym"><a href="include.html#%28form._%28%28lib._racket%2Finclude..rkt%29._include%29%29" class="RktStxLink" data-pltdoc="x">include</a></span> expression, if that
+source is a complete path string. If the source is not a complete path
+string, then <span class="RktVar">path-spec</span> is resolved relative to
+<span class="RktPn">(</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-load-relative-directory</a></span><span class="RktPn">)</span> if it is not <span class="RktVal">#f</span>,
+or relative to <span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span><span class="RktPn">)</span> otherwise.</p><p>The included syntax is given the lexical context of the
+<span class="RktSym"><a href="include.html#%28form._%28%28lib._racket%2Finclude..rkt%29._include%29%29" class="RktStxLink" data-pltdoc="x">include</a></span> expression, while the included syntax&rsquo;s source
+location refers to its actual source.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/include..rkt)._include-at/relative-to))"></a><span title="Provided from: racket/include, racket | Package: base"><span class="RktSym"><a href="include.html#%28form._%28%28lib._racket%2Finclude..rkt%29._include-at%2Frelative-to%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">include-at/relative-to</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">context</span><span class="hspace">&nbsp;</span><span class="RktVar">source</span><span class="hspace">&nbsp;</span><span class="RktVar">path-spec</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="include.html#%28form._%28%28lib._racket%2Finclude..rkt%29._include%29%29" class="RktStxLink" data-pltdoc="x">include</a></span>, except that the lexical context of
+<span class="RktVar">context</span> is used for the included syntax, and a relative
+<span class="RktVar">path-spec</span> is resolved with respect to the source of
+<span class="RktVar">source</span>. The <span class="RktVar">context</span> and <span class="RktVar">source</span> elements are
+otherwise discarded by expansion.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/include..rkt)._include/reader))"></a><span title="Provided from: racket/include, racket | Package: base"><span class="RktSym"><a href="include.html#%28form._%28%28lib._racket%2Finclude..rkt%29._include%2Freader%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">include/reader</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">path-spec</span><span class="hspace">&nbsp;</span><span class="RktVar">reader-expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="include.html#%28form._%28%28lib._racket%2Finclude..rkt%29._include%29%29" class="RktStxLink" data-pltdoc="x">include</a></span>, except that the procedure produced by the
+expression <span class="RktVar">reader-expr</span> is used to read the included file,
+instead of <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>.</div></p><p>The <span class="RktVar">reader-expr</span> is evaluated at expansion time in the
+<a href="syntax-model.html#%28tech._transformer._environment%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer environment</span></a>. Since it serves as a replacement for
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>, the expression&rsquo;s value should be a procedure
+that consumes two inputs&#8212;<wbr></wbr>a string representing the source and an
+input port&#8212;<wbr></wbr>and produces a syntax object or <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>. The
+procedure will be called repeatedly until it produces <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>.</p><p>The syntax objects returned by the procedure should have source
+location information, but usually no lexical context; any lexical
+context in the syntax objects will be ignored.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/include..rkt)._include-at/relative-to/reader))"></a><span title="Provided from: racket/include, racket | Package: base"><span class="RktSym"><a href="include.html#%28form._%28%28lib._racket%2Finclude..rkt%29._include-at%2Frelative-to%2Freader%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">include-at/relative-to/reader</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">context</span><span class="hspace">&nbsp;</span><span class="RktVar">source</span><span class="hspace">&nbsp;</span><span class="RktVar">path-spec</span><span class="hspace">&nbsp;</span><span class="RktVar">reader-expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Combines <span class="RktSym"><a href="include.html#%28form._%28%28lib._racket%2Finclude..rkt%29._include-at%2Frelative-to%29%29" class="RktStxLink" data-pltdoc="x">include-at/relative-to</a></span> and <span class="RktSym"><a href="include.html#%28form._%28%28lib._racket%2Finclude..rkt%29._include%2Freader%29%29" class="RktStxLink" data-pltdoc="x">include/reader</a></span>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Serializing_Syntax.html" title="backward to &quot;12.10 Serializing Syntax&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="syntax-util.html" title="forward to &quot;12.12 Syntax Utilities&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/index.html b/clones/docs.racket-lang.org/reference/index.html
new file mode 100644
index 00000000..6aa9d2db
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/index.html
@@ -0,0 +1,10 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>The Racket Reference</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9660;</a></td><td></td><td><a href="index.html" class="tocviewselflink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublistonly" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber"></span><a href="index.html#%28part._top%29" class="tocsubseclink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="versionbox"><span class="version">8.6</span></div><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<span class="nonavigation">&larr; prev</span>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">up</a>&nbsp;&nbsp;<a href="model.html" title="forward to &quot;1 Language Model&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h2 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;top&quot;"><a name="(part._top)"></a><a name="(part._.The_.Racket_.Reference)"></a><a name="(mod-path._racket/base)"></a><a name="(mod-path._racket)"></a>The Racket Reference</h2><div class="SAuthorListBox"><span class="SAuthorList"><p class="author">Matthew Flatt<br/>and PLT</p></span></div><p>This manual defines the core Racket language and describes its
+most prominent libraries. The companion manual <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> provides a
+friendlier (though less precise and less complete) overview of the
+language.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The source of this manual is available on
+<a href="https://github.com/racket/racket/tree/master/pkgs/racket-doc/scribblings/reference">GitHub</a>.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr><tr><td align="left" colspan="2"><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr></table></div><div class="SIntrapara">Unless otherwise noted, the bindings defined in this manual are
+exported by the <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>
+languages.</div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> library is much smaller than
+the <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> library and will typically load faster.</p><p>The <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> library combines
+<a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>, <a href="booleans.html#%28mod-path._racket%2Fbool%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/bool</span></a>, <a href="bytestrings.html#%28mod-path._racket%2Fbytes%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/bytes</span></a>, <a href="mzlib_class.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/class</span></a>, <a href="Command-Line_Parsing.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/cmdline</span></a>, <a href="contracts.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/contract</span></a>, <a href="dicts.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/dict</span></a>, <a href="Filesystem.html#%28mod-path._racket%2Ffile%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/file</span></a>, <a href="strings.html#%28mod-path._racket%2Fformat%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/format</span></a>, <a href="procedures.html#%28mod-path._racket%2Ffunction%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/function</span></a>, <a href="futures.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/future</span></a>, <a href="include.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/include</span></a>, <a href="keywords.html#%28mod-path._racket%2Fkeyword%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/keyword</span></a>, <a href="pairs.html#%28mod-path._racket%2Flist%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/list</span></a>, <a href="local.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/local</span></a>, <a href="match.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/match</span></a>, <a href="generic-numbers.html#%28mod-path._racket%2Fmath%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/math</span></a>, <a href="More_Path_Utilities.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/path</span></a>, <a href="places.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/place</span></a>, <a href="port-lib.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/port</span></a>, <a href="pretty-print.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/pretty</span></a>, <a href="Delayed_Evaluation.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/promise</span></a>, <a href="sequences.html#%28mod-path._racket%2Fsequence%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/sequence</span></a>, <a href="sets.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/set</span></a>, <a href="shared.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/shared</span></a>, <a href="streams.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/stream</span></a>, <a href="strings.html#%28mod-path._racket%2Fstring%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/string</span></a>, <a href="symbols.html#%28mod-path._racket%2Fsymbol%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/symbol</span></a>, <a href="subprocess.html#%28mod-path._racket%2Fsystem%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/system</span></a>, <a href="tcp.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/tcp</span></a>, <a href="udp.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/udp</span></a>, <a href="mzlib_unit.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/unit</span></a>, and <a href="vectors.html#%28mod-path._racket%2Fvector%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/vector</span></a>.</p></blockquote></blockquote></blockquote><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="model.html" class="toptoclink" data-pltdoc="x">1<span class="hspace">&nbsp;</span>Language Model</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html" class="toclink" data-pltdoc="x">1.1<span class="hspace">&nbsp;</span>Evaluation Model</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._cont-model%29" class="toclink" data-pltdoc="x">1.1.1<span class="hspace">&nbsp;</span>Sub-expression Evaluation and Continuations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._.Tail_.Position%29" class="toclink" data-pltdoc="x">1.1.2<span class="hspace">&nbsp;</span>Tail Position</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._values-model%29" class="toclink" data-pltdoc="x">1.1.3<span class="hspace">&nbsp;</span>Multiple Return Values</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._.Top-.Level_.Variables%29" class="toclink" data-pltdoc="x">1.1.4<span class="hspace">&nbsp;</span>Top-Level Variables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._.Objects_and_.Imperative_.Update%29" class="toclink" data-pltdoc="x">1.1.5<span class="hspace">&nbsp;</span>Objects and Imperative Update</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._gc-model%29" class="toclink" data-pltdoc="x">1.1.6<span class="hspace">&nbsp;</span>Garbage Collection</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._.Procedure_.Applications_and_.Local_.Variables%29" class="toclink" data-pltdoc="x">1.1.7<span class="hspace">&nbsp;</span>Procedure Applications and Local Variables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._vars-and-locs%29" class="toclink" data-pltdoc="x">1.1.8<span class="hspace">&nbsp;</span>Variables and Locations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._module-eval-model%29" class="toclink" data-pltdoc="x">1.1.9<span class="hspace">&nbsp;</span>Modules and Module-Level Variables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._module-phase%29" class="toclink" data-pltdoc="x">1.1.9.1<span class="hspace">&nbsp;</span>Phases</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._separate-compilation%29" class="toclink" data-pltdoc="x">1.1.9.2<span class="hspace">&nbsp;</span>The Separate Compilation Guarantee</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._cross-phase._persistent-modules%29" class="toclink" data-pltdoc="x">1.1.9.3<span class="hspace">&nbsp;</span>Cross-Phase Persistent Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._module-redeclare%29" class="toclink" data-pltdoc="x">1.1.9.4<span class="hspace">&nbsp;</span>Module Redeclarations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._submodules%29" class="toclink" data-pltdoc="x">1.1.9.5<span class="hspace">&nbsp;</span>Submodules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._mark-model%29" class="toclink" data-pltdoc="x">1.1.10<span class="hspace">&nbsp;</span>Continuation Frames and Marks</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._prompt-model%29" class="toclink" data-pltdoc="x">1.1.11<span class="hspace">&nbsp;</span>Prompts, Delimited Continuations, and Barriers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._thread-model%29" class="toclink" data-pltdoc="x">1.1.12<span class="hspace">&nbsp;</span>Threads</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._parameter-model%29" class="toclink" data-pltdoc="x">1.1.13<span class="hspace">&nbsp;</span>Parameters</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._exn-model%29" class="toclink" data-pltdoc="x">1.1.14<span class="hspace">&nbsp;</span>Exceptions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._custodian-model%29" class="toclink" data-pltdoc="x">1.1.15<span class="hspace">&nbsp;</span>Custodians</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html" class="toclink" data-pltdoc="x">1.2<span class="hspace">&nbsp;</span>Syntax Model</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._id-model%29" class="toclink" data-pltdoc="x">1.2.1<span class="hspace">&nbsp;</span>Identifiers, Binding, and Scopes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._stxobj-model%29" class="toclink" data-pltdoc="x">1.2.2<span class="hspace">&nbsp;</span>Syntax Objects</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._expansion%29" class="toclink" data-pltdoc="x">1.2.3<span class="hspace">&nbsp;</span>Expansion (Parsing)</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._fully-expanded%29" class="toclink" data-pltdoc="x">1.2.3.1<span class="hspace">&nbsp;</span>Fully Expanded Programs</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._expand-steps%29" class="toclink" data-pltdoc="x">1.2.3.2<span class="hspace">&nbsp;</span>Expansion Steps</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._expand-context-model%29" class="toclink" data-pltdoc="x">1.2.3.3<span class="hspace">&nbsp;</span>Expansion Context</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._intro-binding%29" class="toclink" data-pltdoc="x">1.2.3.4<span class="hspace">&nbsp;</span>Introducing Bindings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._transformer-model%29" class="toclink" data-pltdoc="x">1.2.3.5<span class="hspace">&nbsp;</span>Transformer Bindings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._local-binding-context%29" class="toclink" data-pltdoc="x">1.2.3.6<span class="hspace">&nbsp;</span>Local Binding Context</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._partial-expansion%29" class="toclink" data-pltdoc="x">1.2.3.7<span class="hspace">&nbsp;</span>Partial Expansion</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._intdef-body%29" class="toclink" data-pltdoc="x">1.2.3.8<span class="hspace">&nbsp;</span>Internal Definitions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._mod-parse%29" class="toclink" data-pltdoc="x">1.2.3.9<span class="hspace">&nbsp;</span>Module Expansion, Phases, and Visits</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._macro-introduced-bindings%29" class="toclink" data-pltdoc="x">1.2.3.10<span class="hspace">&nbsp;</span>Macro-Introduced Bindings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._compilation-model%29" class="toclink" data-pltdoc="x">1.2.4<span class="hspace">&nbsp;</span>Compilation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._namespace-model%29" class="toclink" data-pltdoc="x">1.2.5<span class="hspace">&nbsp;</span>Namespaces</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._infernames%29" class="toclink" data-pltdoc="x">1.2.6<span class="hspace">&nbsp;</span>Inferred Value Names</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._cross-phase._persistent-grammar%29" class="toclink" data-pltdoc="x">1.2.7<span class="hspace">&nbsp;</span>Cross-Phase Persistent Module Declarations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="reader.html" class="toclink" data-pltdoc="x">1.3<span class="hspace">&nbsp;</span>The Reader</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="printing.html" class="toclink" data-pltdoc="x">1.4<span class="hspace">&nbsp;</span>The Printer</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="implementations.html" class="toclink" data-pltdoc="x">1.5<span class="hspace">&nbsp;</span>Implementations</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="notation.html" class="toptoclink" data-pltdoc="x">2<span class="hspace">&nbsp;</span>Notation for Documentation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="notation.html#%28part._.Notation_for_.Module_.Documentation%29" class="toclink" data-pltdoc="x">2.1<span class="hspace">&nbsp;</span>Notation for Module Documentation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="notation.html#%28part._.Notation_for_.Syntactic_.Form_.Documentation%29" class="toclink" data-pltdoc="x">2.2<span class="hspace">&nbsp;</span>Notation for Syntactic Form Documentation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="notation.html#%28part._.Notation_for_.Function_.Documentation%29" class="toclink" data-pltdoc="x">2.3<span class="hspace">&nbsp;</span>Notation for Function Documentation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="notation.html#%28part._.Notation_for_.Structure_.Type_.Documentation%29" class="toclink" data-pltdoc="x">2.4<span class="hspace">&nbsp;</span>Notation for Structure Type Documentation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="notation.html#%28part._.Notation_for_.Parameter_.Documentation%29" class="toclink" data-pltdoc="x">2.5<span class="hspace">&nbsp;</span>Notation for Parameter Documentation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="notation.html#%28part._.Notation_for_.Other_.Documentation%29" class="toclink" data-pltdoc="x">2.6<span class="hspace">&nbsp;</span>Notation for Other Documentation</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax.html" class="toptoclink" data-pltdoc="x">3<span class="hspace">&nbsp;</span>Syntactic Forms</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module.html" class="toclink" data-pltdoc="x">3.1<span class="hspace">&nbsp;</span>Modules: <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="require.html" class="toclink" data-pltdoc="x">3.2<span class="hspace">&nbsp;</span>Importing and Exporting: <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="require.html#%28part._.Additional_require_.Forms%29" class="toclink" data-pltdoc="x">3.2.1<span class="hspace">&nbsp;</span>Additional <span class="RktSym"><span class="RktStxLink">require</span></span> Forms</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="require.html#%28part._.Additional_provide_.Forms%29" class="toclink" data-pltdoc="x">3.2.2<span class="hspace">&nbsp;</span>Additional <span class="RktSym"><span class="RktStxLink">provide</span></span> Forms</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="quote.html" class="toclink" data-pltdoc="x">3.3<span class="hspace">&nbsp;</span>Literals: <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="__expression.html" class="toclink" data-pltdoc="x">3.4<span class="hspace">&nbsp;</span>Expression Wrapper: <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="__top.html" class="toclink" data-pltdoc="x">3.5<span class="hspace">&nbsp;</span>Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Locations____variable-reference.html" class="toclink" data-pltdoc="x">3.6<span class="hspace">&nbsp;</span>Locations: <span class="RktSym"><span class="RktStxLink">#%variable-reference</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="application.html" class="toclink" data-pltdoc="x">3.7<span class="hspace">&nbsp;</span>Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="lambda.html" class="toclink" data-pltdoc="x">3.8<span class="hspace">&nbsp;</span>Procedure Expressions: <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-lambda</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="let.html" class="toclink" data-pltdoc="x">3.9<span class="hspace">&nbsp;</span>Local Binding: <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="local.html" class="toclink" data-pltdoc="x">3.10<span class="hspace">&nbsp;</span>Local Definitions: <span class="RktSym"><span class="RktStxLink">local</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="shared.html" class="toclink" data-pltdoc="x">3.11<span class="hspace">&nbsp;</span>Constructing Graphs: <span class="RktSym"><span class="RktStxLink">shared</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="if.html" class="toclink" data-pltdoc="x">3.12<span class="hspace">&nbsp;</span>Conditionals: <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="case.html" class="toclink" data-pltdoc="x">3.13<span class="hspace">&nbsp;</span>Dispatch: <span class="RktSym"><span class="RktStxLink">case</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define.html" class="toclink" data-pltdoc="x">3.14<span class="hspace">&nbsp;</span>Definitions: <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-syntax</span></span>, ...</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define.html#%28part._require-syntax%29" class="toclink" data-pltdoc="x">3.14.1<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">require</span></span> Macros</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define.html#%28part._provide-syntax%29" class="toclink" data-pltdoc="x">3.14.2<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">provide</span></span> Macros</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="begin.html" class="toclink" data-pltdoc="x">3.15<span class="hspace">&nbsp;</span>Sequencing: <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-for-syntax</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="when_unless.html" class="toclink" data-pltdoc="x">3.16<span class="hspace">&nbsp;</span>Guarded Evaluation: <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="set_.html" class="toclink" data-pltdoc="x">3.17<span class="hspace">&nbsp;</span>Assignment: <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-values</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="for.html" class="toclink" data-pltdoc="x">3.18<span class="hspace">&nbsp;</span>Iterations and Comprehensions: <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/list</span></span>, ...</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="for.html#%28part._.Iteration_and_.Comprehension_.Forms%29" class="toclink" data-pltdoc="x">3.18.1<span class="hspace">&nbsp;</span>Iteration and Comprehension Forms</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="for.html#%28part._.Deriving_.New_.Iteration_.Forms%29" class="toclink" data-pltdoc="x">3.18.2<span class="hspace">&nbsp;</span>Deriving New Iteration Forms</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="for.html#%28part._.Do_.Loops%29" class="toclink" data-pltdoc="x">3.18.3<span class="hspace">&nbsp;</span>Do Loops</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="wcm.html" class="toclink" data-pltdoc="x">3.19<span class="hspace">&nbsp;</span>Continuation Marks: <span class="RktSym"><span class="RktStxLink">with-continuation-mark</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="quasiquote.html" class="toclink" data-pltdoc="x">3.20<span class="hspace">&nbsp;</span>Quasiquoting: <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-splicing</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Syntax_Quoting__quote-syntax.html" class="toclink" data-pltdoc="x">3.21<span class="hspace">&nbsp;</span>Syntax Quoting: <span class="RktSym"><span class="RktStxLink">quote-syntax</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="__top-interaction.html" class="toclink" data-pltdoc="x">3.22<span class="hspace">&nbsp;</span>Interaction Wrapper: <span class="RktSym"><span class="RktStxLink">#%top-interaction</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="block.html" class="toclink" data-pltdoc="x">3.23<span class="hspace">&nbsp;</span>Blocks: <span class="RktSym"><span class="RktStxLink">block</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stratified-body.html" class="toclink" data-pltdoc="x">3.24<span class="hspace">&nbsp;</span>Internal-Definition Limiting: <span class="RktSym"><span class="RktStxLink">#%stratified-body</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="performance-hint.html" class="toclink" data-pltdoc="x">3.25<span class="hspace">&nbsp;</span>Performance Hints: <span class="RktSym"><span class="RktStxLink">begin-encourage-inline</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="lazy-require.html" class="toclink" data-pltdoc="x">3.26<span class="hspace">&nbsp;</span>Importing Modules Lazily: <span class="RktSym"><span class="RktStxLink">lazy-require</span></span></a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="data.html" class="toptoclink" data-pltdoc="x">4<span class="hspace">&nbsp;</span>Datatypes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Equality.html" class="toclink" data-pltdoc="x">4.1<span class="hspace">&nbsp;</span>Equality</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Equality.html#%28part._model-eq%29" class="toclink" data-pltdoc="x">4.1.1<span class="hspace">&nbsp;</span>Object Identity and Comparisons</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Equality.html#%28part._.Equality_and_.Hashing%29" class="toclink" data-pltdoc="x">4.1.2<span class="hspace">&nbsp;</span>Equality and Hashing</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Equality.html#%28part._.Implementing_.Equality_for_.Custom_.Types%29" class="toclink" data-pltdoc="x">4.1.3<span class="hspace">&nbsp;</span>Implementing Equality for Custom Types</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Equality.html#%28part._.Honest_.Custom_.Equality%29" class="toclink" data-pltdoc="x">4.1.4<span class="hspace">&nbsp;</span>Honest Custom Equality</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="booleans.html" class="toclink" data-pltdoc="x">4.2<span class="hspace">&nbsp;</span>Booleans</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="booleans.html#%28part._.Boolean_.Aliases%29" class="toclink" data-pltdoc="x">4.2.1<span class="hspace">&nbsp;</span>Boolean Aliases</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="numbers.html" class="toclink" data-pltdoc="x">4.3<span class="hspace">&nbsp;</span>Numbers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="number-types.html" class="toclink" data-pltdoc="x">4.3.1<span class="hspace">&nbsp;</span>Number Types</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html" class="toclink" data-pltdoc="x">4.3.2<span class="hspace">&nbsp;</span>Generic Numerics</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html#%28part._.Arithmetic%29" class="toclink" data-pltdoc="x">4.3.2.1<span class="hspace">&nbsp;</span>Arithmetic</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html#%28part._.Number_.Comparison%29" class="toclink" data-pltdoc="x">4.3.2.2<span class="hspace">&nbsp;</span>Number Comparison</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html#%28part._.Powers_and_.Roots%29" class="toclink" data-pltdoc="x">4.3.2.3<span class="hspace">&nbsp;</span>Powers and Roots</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html#%28part._.Trigonometric_.Functions%29" class="toclink" data-pltdoc="x">4.3.2.4<span class="hspace">&nbsp;</span>Trigonometric Functions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html#%28part._.Complex_.Numbers%29" class="toclink" data-pltdoc="x">4.3.2.5<span class="hspace">&nbsp;</span>Complex Numbers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html#%28part._.Bitwise_.Operations%29" class="toclink" data-pltdoc="x">4.3.2.6<span class="hspace">&nbsp;</span>Bitwise Operations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html#%28part._.Random_.Numbers%29" class="toclink" data-pltdoc="x">4.3.2.7<span class="hspace">&nbsp;</span>Random Numbers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html#%28part._.Other_.Randomness_.Utilities%29" class="toclink" data-pltdoc="x">4.3.2.8<span class="hspace">&nbsp;</span>Other Randomness Utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html#%28part._.Number--.String_.Conversions%29" class="toclink" data-pltdoc="x">4.3.2.9<span class="hspace">&nbsp;</span>Number&ndash;String Conversions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html#%28part._.Extra_.Constants_and_.Functions%29" class="toclink" data-pltdoc="x">4.3.2.10<span class="hspace">&nbsp;</span>Extra Constants and Functions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="flonums.html" class="toclink" data-pltdoc="x">4.3.3<span class="hspace">&nbsp;</span>Flonums</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="flonums.html#%28part._.Flonum_.Arithmetic%29" class="toclink" data-pltdoc="x">4.3.3.1<span class="hspace">&nbsp;</span>Flonum Arithmetic</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="flonums.html#%28part._flvectors%29" class="toclink" data-pltdoc="x">4.3.3.2<span class="hspace">&nbsp;</span>Flonum Vectors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="fixnums.html" class="toclink" data-pltdoc="x">4.3.4<span class="hspace">&nbsp;</span>Fixnums</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="fixnums.html#%28part._.Fixnum_.Arithmetic%29" class="toclink" data-pltdoc="x">4.3.4.1<span class="hspace">&nbsp;</span>Fixnum Arithmetic</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="fixnums.html#%28part._fxvectors%29" class="toclink" data-pltdoc="x">4.3.4.2<span class="hspace">&nbsp;</span>Fixnum Vectors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="fixnums.html#%28part._fxrange%29" class="toclink" data-pltdoc="x">4.3.4.3<span class="hspace">&nbsp;</span>Fixnum Range</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="extflonums.html" class="toclink" data-pltdoc="x">4.3.5<span class="hspace">&nbsp;</span>Extflonums</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="extflonums.html#%28part._.Extflonum_.Arithmetic%29" class="toclink" data-pltdoc="x">4.3.5.1<span class="hspace">&nbsp;</span>Extflonum Arithmetic</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="extflonums.html#%28part._.Extflonum_.Constants%29" class="toclink" data-pltdoc="x">4.3.5.2<span class="hspace">&nbsp;</span>Extflonum Constants</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="extflonums.html#%28part._extflvectors%29" class="toclink" data-pltdoc="x">4.3.5.3<span class="hspace">&nbsp;</span>Extflonum Vectors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="extflonums.html#%28part._extflutils%29" class="toclink" data-pltdoc="x">4.3.5.4<span class="hspace">&nbsp;</span>Extflonum Byte Strings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="strings.html" class="toclink" data-pltdoc="x">4.4<span class="hspace">&nbsp;</span>Strings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="strings.html#%28part._.String_.Constructors__.Selectors__and_.Mutators%29" class="toclink" data-pltdoc="x">4.4.1<span class="hspace">&nbsp;</span>String Constructors, Selectors, and Mutators</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="strings.html#%28part._.String_.Comparisons%29" class="toclink" data-pltdoc="x">4.4.2<span class="hspace">&nbsp;</span>String Comparisons</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="strings.html#%28part._.String_.Conversions%29" class="toclink" data-pltdoc="x">4.4.3<span class="hspace">&nbsp;</span>String Conversions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="strings.html#%28part._.Locale-.Specific_.String_.Operations%29" class="toclink" data-pltdoc="x">4.4.4<span class="hspace">&nbsp;</span>Locale-Specific String Operations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="strings.html#%28part._.Additional_.String_.Functions%29" class="toclink" data-pltdoc="x">4.4.5<span class="hspace">&nbsp;</span>Additional String Functions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="strings.html#%28part._format%29" class="toclink" data-pltdoc="x">4.4.6<span class="hspace">&nbsp;</span>Converting Values to Strings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="bytestrings.html" class="toclink" data-pltdoc="x">4.5<span class="hspace">&nbsp;</span>Byte Strings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="bytestrings.html#%28part._.Byte_.String_.Constructors__.Selectors__and_.Mutators%29" class="toclink" data-pltdoc="x">4.5.1<span class="hspace">&nbsp;</span>Byte String Constructors, Selectors, and Mutators</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="bytestrings.html#%28part._.Byte_.String_.Comparisons%29" class="toclink" data-pltdoc="x">4.5.2<span class="hspace">&nbsp;</span>Byte String Comparisons</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="bytestrings.html#%28part._.Bytes_to_from_.Characters__.Decoding_and_.Encoding%29" class="toclink" data-pltdoc="x">4.5.3<span class="hspace">&nbsp;</span>Bytes to/from Characters, Decoding and Encoding</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="bytestrings.html#%28part._.Bytes_to_.Bytes_.Encoding_.Conversion%29" class="toclink" data-pltdoc="x">4.5.4<span class="hspace">&nbsp;</span>Bytes to Bytes Encoding Conversion</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="bytestrings.html#%28part._.Additional_.Byte_.String_.Functions%29" class="toclink" data-pltdoc="x">4.5.5<span class="hspace">&nbsp;</span>Additional Byte String Functions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="characters.html" class="toclink" data-pltdoc="x">4.6<span class="hspace">&nbsp;</span>Characters</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="characters.html#%28part._.Characters_and_.Scalar_.Values%29" class="toclink" data-pltdoc="x">4.6.1<span class="hspace">&nbsp;</span>Characters and Scalar Values</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="characters.html#%28part._.Character_.Comparisons%29" class="toclink" data-pltdoc="x">4.6.2<span class="hspace">&nbsp;</span>Character Comparisons</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="characters.html#%28part._.Classifications%29" class="toclink" data-pltdoc="x">4.6.3<span class="hspace">&nbsp;</span>Classifications</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="characters.html#%28part._.Character_.Conversions%29" class="toclink" data-pltdoc="x">4.6.4<span class="hspace">&nbsp;</span>Character Conversions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="symbols.html" class="toclink" data-pltdoc="x">4.7<span class="hspace">&nbsp;</span>Symbols</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="symbols.html#%28part._.Additional_.Symbol_.Functions%29" class="toclink" data-pltdoc="x">4.7.1<span class="hspace">&nbsp;</span>Additional Symbol Functions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp.html" class="toclink" data-pltdoc="x">4.8<span class="hspace">&nbsp;</span>Regular Expressions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp.html#%28part._regexp-syntax%29" class="toclink" data-pltdoc="x">4.8.1<span class="hspace">&nbsp;</span>Regexp Syntax</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp.html#%28part._.Additional_.Syntactic_.Constraints%29" class="toclink" data-pltdoc="x">4.8.2<span class="hspace">&nbsp;</span>Additional Syntactic Constraints</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp.html#%28part._.Regexp_.Constructors%29" class="toclink" data-pltdoc="x">4.8.3<span class="hspace">&nbsp;</span>Regexp Constructors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp.html#%28part._.Regexp_.Matching%29" class="toclink" data-pltdoc="x">4.8.4<span class="hspace">&nbsp;</span>Regexp Matching</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp.html#%28part._.Regexp_.Splitting%29" class="toclink" data-pltdoc="x">4.8.5<span class="hspace">&nbsp;</span>Regexp Splitting</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp.html#%28part._.Regexp_.Substitution%29" class="toclink" data-pltdoc="x">4.8.6<span class="hspace">&nbsp;</span>Regexp Substitution</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="keywords.html" class="toclink" data-pltdoc="x">4.9<span class="hspace">&nbsp;</span>Keywords</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="keywords.html#%28part._.Additional_.Keyword_.Functions%29" class="toclink" data-pltdoc="x">4.9.1<span class="hspace">&nbsp;</span>Additional Keyword Functions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pairs.html" class="toclink" data-pltdoc="x">4.10<span class="hspace">&nbsp;</span>Pairs and Lists</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pairs.html#%28part._.Pair_.Constructors_and_.Selectors%29" class="toclink" data-pltdoc="x">4.10.1<span class="hspace">&nbsp;</span>Pair Constructors and Selectors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pairs.html#%28part._.List_.Operations%29" class="toclink" data-pltdoc="x">4.10.2<span class="hspace">&nbsp;</span>List Operations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pairs.html#%28part._.List_.Iteration%29" class="toclink" data-pltdoc="x">4.10.3<span class="hspace">&nbsp;</span>List Iteration</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pairs.html#%28part._.List_.Filtering%29" class="toclink" data-pltdoc="x">4.10.4<span class="hspace">&nbsp;</span>List Filtering</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pairs.html#%28part._.List_.Searching%29" class="toclink" data-pltdoc="x">4.10.5<span class="hspace">&nbsp;</span>List Searching</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pairs.html#%28part._.Pair_.Accessor_.Shorthands%29" class="toclink" data-pltdoc="x">4.10.6<span class="hspace">&nbsp;</span>Pair Accessor Shorthands</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pairs.html#%28part._.Additional_.List_.Functions_and_.Synonyms%29" class="toclink" data-pltdoc="x">4.10.7<span class="hspace">&nbsp;</span>Additional List Functions and Synonyms</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pairs.html#%28part._.Immutable_.Cyclic_.Data%29" class="toclink" data-pltdoc="x">4.10.8<span class="hspace">&nbsp;</span>Immutable Cyclic Data</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="mpairs.html" class="toclink" data-pltdoc="x">4.11<span class="hspace">&nbsp;</span>Mutable Pairs and Lists</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="mpairs.html#%28part._.Mutable_.Pair_.Constructors_and_.Selectors%29" class="toclink" data-pltdoc="x">4.11.1<span class="hspace">&nbsp;</span>Mutable Pair Constructors and Selectors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="vectors.html" class="toclink" data-pltdoc="x">4.12<span class="hspace">&nbsp;</span>Vectors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="vectors.html#%28part._.Additional_.Vector_.Functions%29" class="toclink" data-pltdoc="x">4.12.1<span class="hspace">&nbsp;</span>Additional Vector Functions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stencil_vectors.html" class="toclink" data-pltdoc="x">4.13<span class="hspace">&nbsp;</span>Stencil Vectors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="boxes.html" class="toclink" data-pltdoc="x">4.14<span class="hspace">&nbsp;</span>Boxes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="hashtables.html" class="toclink" data-pltdoc="x">4.15<span class="hspace">&nbsp;</span>Hash Tables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="hashtables.html#%28part._.Additional_.Hash_.Table_.Functions%29" class="toclink" data-pltdoc="x">4.15.1<span class="hspace">&nbsp;</span>Additional Hash Table Functions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sequences_streams.html" class="toclink" data-pltdoc="x">4.16<span class="hspace">&nbsp;</span>Sequences and Streams</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sequences.html" class="toclink" data-pltdoc="x">4.16.1<span class="hspace">&nbsp;</span>Sequences</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sequences.html#%28part._.Sequence_.Predicate_and_.Constructors%29" class="toclink" data-pltdoc="x">4.16.1.1<span class="hspace">&nbsp;</span>Sequence Predicate and Constructors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sequences.html#%28part._.Sequence_.Conversion%29" class="toclink" data-pltdoc="x">4.16.1.2<span class="hspace">&nbsp;</span>Sequence Conversion</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sequences.html#%28part._more-sequences%29" class="toclink" data-pltdoc="x">4.16.1.3<span class="hspace">&nbsp;</span>Additional Sequence Operations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sequences.html#%28part._.Additional_.Sequence_.Constructors%29" class="toclink" data-pltdoc="x">4.16.1.3.1<span class="hspace">&nbsp;</span>Additional Sequence Constructors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="streams.html" class="toclink" data-pltdoc="x">4.16.2<span class="hspace">&nbsp;</span>Streams</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Generators.html" class="toclink" data-pltdoc="x">4.16.3<span class="hspace">&nbsp;</span>Generators</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="dicts.html" class="toclink" data-pltdoc="x">4.17<span class="hspace">&nbsp;</span>Dictionaries</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="dicts.html#%28part._.Dictionary_.Predicates_and_.Contracts%29" class="toclink" data-pltdoc="x">4.17.1<span class="hspace">&nbsp;</span>Dictionary Predicates and Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="dicts.html#%28part._.Generic_.Dictionary_.Interface%29" class="toclink" data-pltdoc="x">4.17.2<span class="hspace">&nbsp;</span>Generic Dictionary Interface</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="dicts.html#%28part._primitive-dict-methods%29" class="toclink" data-pltdoc="x">4.17.2.1<span class="hspace">&nbsp;</span>Primitive Dictionary Methods</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="dicts.html#%28part._derived-dict-methods%29" class="toclink" data-pltdoc="x">4.17.2.2<span class="hspace">&nbsp;</span>Derived Dictionary Methods</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="dicts.html#%28part._.Dictionary_.Sequences%29" class="toclink" data-pltdoc="x">4.17.3<span class="hspace">&nbsp;</span>Dictionary Sequences</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="dicts.html#%28part._.Contracted_.Dictionaries%29" class="toclink" data-pltdoc="x">4.17.4<span class="hspace">&nbsp;</span>Contracted Dictionaries</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="dicts.html#%28part._.Custom_.Hash_.Tables%29" class="toclink" data-pltdoc="x">4.17.5<span class="hspace">&nbsp;</span>Custom Hash Tables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="dicts.html#%28part._.Passing_keyword_arguments_in_dictionaries%29" class="toclink" data-pltdoc="x">4.17.6<span class="hspace">&nbsp;</span>Passing keyword arguments in dictionaries</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sets.html" class="toclink" data-pltdoc="x">4.18<span class="hspace">&nbsp;</span>Sets</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sets.html#%28part._.Hash_.Sets%29" class="toclink" data-pltdoc="x">4.18.1<span class="hspace">&nbsp;</span>Hash Sets</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sets.html#%28part._.Set_.Predicates_and_.Contracts%29" class="toclink" data-pltdoc="x">4.18.2<span class="hspace">&nbsp;</span>Set Predicates and Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sets.html#%28part._.Generic_.Set_.Interface%29" class="toclink" data-pltdoc="x">4.18.3<span class="hspace">&nbsp;</span>Generic Set Interface</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sets.html#%28part._set-methods%29" class="toclink" data-pltdoc="x">4.18.3.1<span class="hspace">&nbsp;</span>Set Methods</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sets.html#%28part._.Custom_.Hash_.Sets%29" class="toclink" data-pltdoc="x">4.18.4<span class="hspace">&nbsp;</span>Custom Hash Sets</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="procedures.html" class="toclink" data-pltdoc="x">4.19<span class="hspace">&nbsp;</span>Procedures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="procedures.html#%28part._.Keywords_and_.Arity%29" class="toclink" data-pltdoc="x">4.19.1<span class="hspace">&nbsp;</span>Keywords and Arity</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="procedures.html#%28part._.Reflecting_on_.Primitives%29" class="toclink" data-pltdoc="x">4.19.2<span class="hspace">&nbsp;</span>Reflecting on Primitives</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="procedures.html#%28part._.Additional_.Higher-.Order_.Functions%29" class="toclink" data-pltdoc="x">4.19.3<span class="hspace">&nbsp;</span>Additional Higher-Order Functions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="void.html" class="toclink" data-pltdoc="x">4.20<span class="hspace">&nbsp;</span>Void</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="undefined.html" class="toclink" data-pltdoc="x">4.21<span class="hspace">&nbsp;</span>Undefined</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="structures.html" class="toptoclink" data-pltdoc="x">5<span class="hspace">&nbsp;</span>Structures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define-struct.html" class="toclink" data-pltdoc="x">5.1<span class="hspace">&nbsp;</span>Defining Structure Types: <span class="RktSym"><span class="RktStxLink">struct</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="creatingmorestructs.html" class="toclink" data-pltdoc="x">5.2<span class="hspace">&nbsp;</span>Creating Structure Types</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="structprops.html" class="toclink" data-pltdoc="x">5.3<span class="hspace">&nbsp;</span>Structure Type Properties</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="struct-generics.html" class="toclink" data-pltdoc="x">5.4<span class="hspace">&nbsp;</span>Generic Interfaces</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="struct-copy.html" class="toclink" data-pltdoc="x">5.5<span class="hspace">&nbsp;</span>Copying and Updating Structures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="structutils.html" class="toclink" data-pltdoc="x">5.6<span class="hspace">&nbsp;</span>Structure Utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="structutils.html#%28part._.Additional_.Structure_.Utilities%29" class="toclink" data-pltdoc="x">5.6.1<span class="hspace">&nbsp;</span>Additional Structure Utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="structinfo.html" class="toclink" data-pltdoc="x">5.7<span class="hspace">&nbsp;</span>Structure Type Transformer Binding</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="mzlib_class.html" class="toptoclink" data-pltdoc="x">6<span class="hspace">&nbsp;</span>Classes and Objects</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="createinterface.html" class="toclink" data-pltdoc="x">6.1<span class="hspace">&nbsp;</span>Creating Interfaces</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="createclass.html" class="toclink" data-pltdoc="x">6.2<span class="hspace">&nbsp;</span>Creating Classes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="createclass.html#%28part._clinitvars%29" class="toclink" data-pltdoc="x">6.2.1<span class="hspace">&nbsp;</span>Initialization Variables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="createclass.html#%28part._clfields%29" class="toclink" data-pltdoc="x">6.2.2<span class="hspace">&nbsp;</span>Fields</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="createclass.html#%28part._clmethods%29" class="toclink" data-pltdoc="x">6.2.3<span class="hspace">&nbsp;</span>Methods</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="createclass.html#%28part._clmethoddefs%29" class="toclink" data-pltdoc="x">6.2.3.1<span class="hspace">&nbsp;</span>Method Definitions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="createclass.html#%28part._classinherit%29" class="toclink" data-pltdoc="x">6.2.3.2<span class="hspace">&nbsp;</span>Inherited and Superclass Methods</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="createclass.html#%28part._extnames%29" class="toclink" data-pltdoc="x">6.2.3.3<span class="hspace">&nbsp;</span>Internal and External Names</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="objcreation.html" class="toclink" data-pltdoc="x">6.3<span class="hspace">&nbsp;</span>Creating Objects</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="ivaraccess.html" class="toclink" data-pltdoc="x">6.4<span class="hspace">&nbsp;</span>Field and Method Access</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="ivaraccess.html#%28part._methodcalls%29" class="toclink" data-pltdoc="x">6.4.1<span class="hspace">&nbsp;</span>Methods</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="ivaraccess.html#%28part._.Fields%29" class="toclink" data-pltdoc="x">6.4.2<span class="hspace">&nbsp;</span>Fields</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="ivaraccess.html#%28part._.Generics%29" class="toclink" data-pltdoc="x">6.4.3<span class="hspace">&nbsp;</span>Generics</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="mixins.html" class="toclink" data-pltdoc="x">6.5<span class="hspace">&nbsp;</span>Mixins</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="trait.html" class="toclink" data-pltdoc="x">6.6<span class="hspace">&nbsp;</span>Traits</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Object_and_Class_Contracts.html" class="toclink" data-pltdoc="x">6.7<span class="hspace">&nbsp;</span>Object and Class Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="objectequality.html" class="toclink" data-pltdoc="x">6.8<span class="hspace">&nbsp;</span>Object Equality and Hashing</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="objectserialize.html" class="toclink" data-pltdoc="x">6.9<span class="hspace">&nbsp;</span>Object Serialization</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="objectprinting.html" class="toclink" data-pltdoc="x">6.10<span class="hspace">&nbsp;</span>Object Printing</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="objectutils.html" class="toclink" data-pltdoc="x">6.11<span class="hspace">&nbsp;</span>Object, Class, and Interface Utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Surrogates.html" class="toclink" data-pltdoc="x">6.12<span class="hspace">&nbsp;</span>Surrogates</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="mzlib_unit.html" class="toptoclink" data-pltdoc="x">7<span class="hspace">&nbsp;</span>Units</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="creatingunits.html" class="toclink" data-pltdoc="x">7.1<span class="hspace">&nbsp;</span>Creating Units</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="invokingunits.html" class="toclink" data-pltdoc="x">7.2<span class="hspace">&nbsp;</span>Invoking Units</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="compoundunits.html" class="toclink" data-pltdoc="x">7.3<span class="hspace">&nbsp;</span>Linking Units and Creating Compound Units</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="linkinference.html" class="toclink" data-pltdoc="x">7.4<span class="hspace">&nbsp;</span>Inferred Linking</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Generating_A_Unit_from_Context.html" class="toclink" data-pltdoc="x">7.5<span class="hspace">&nbsp;</span>Generating A Unit from Context</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Structural_Matching.html" class="toclink" data-pltdoc="x">7.6<span class="hspace">&nbsp;</span>Structural Matching</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define-sig-form.html" class="toclink" data-pltdoc="x">7.7<span class="hspace">&nbsp;</span>Extending the Syntax of Signatures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Unit_Utilities.html" class="toclink" data-pltdoc="x">7.8<span class="hspace">&nbsp;</span>Unit Utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="unitcontracts.html" class="toclink" data-pltdoc="x">7.9<span class="hspace">&nbsp;</span>Unit Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="single-unit.html" class="toclink" data-pltdoc="x">7.10<span class="hspace">&nbsp;</span>Single-Unit Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Single-Signature_Modules.html" class="toclink" data-pltdoc="x">7.11<span class="hspace">&nbsp;</span>Single-Signature Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Transformer_Helpers.html" class="toclink" data-pltdoc="x">7.12<span class="hspace">&nbsp;</span>Transformer Helpers</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts.html" class="toptoclink" data-pltdoc="x">8<span class="hspace">&nbsp;</span>Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="data-structure-contracts.html" class="toclink" data-pltdoc="x">8.1<span class="hspace">&nbsp;</span>Data-structure Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="function-contracts.html" class="toclink" data-pltdoc="x">8.2<span class="hspace">&nbsp;</span>Function Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="parametric-contracts.html" class="toclink" data-pltdoc="x">8.3<span class="hspace">&nbsp;</span>Parametric Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Lazy_Data-structure_Contracts.html" class="toclink" data-pltdoc="x">8.4<span class="hspace">&nbsp;</span>Lazy Data-structure Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Structure_Type_Property_Contracts.html" class="toclink" data-pltdoc="x">8.5<span class="hspace">&nbsp;</span>Structure Type Property Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="attaching-contracts-to-values.html" class="toclink" data-pltdoc="x">8.6<span class="hspace">&nbsp;</span>Attaching Contracts to Values</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="attaching-contracts-to-values.html#%28part._.Nested_.Contract_.Boundaries%29" class="toclink" data-pltdoc="x">8.6.1<span class="hspace">&nbsp;</span>Nested Contract Boundaries</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="attaching-contracts-to-values.html#%28part._.Low-level_.Contract_.Boundaries%29" class="toclink" data-pltdoc="x">8.6.2<span class="hspace">&nbsp;</span>Low-level Contract Boundaries</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Building_New_Contract_Combinators.html" class="toclink" data-pltdoc="x">8.7<span class="hspace">&nbsp;</span>Building New Contract Combinators</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Building_New_Contract_Combinators.html#%28part._.Blame_.Objects%29" class="toclink" data-pltdoc="x">8.7.1<span class="hspace">&nbsp;</span>Blame Objects</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Building_New_Contract_Combinators.html#%28part._.Contracts_as_structs%29" class="toclink" data-pltdoc="x">8.7.2<span class="hspace">&nbsp;</span>Contracts as structs</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Building_New_Contract_Combinators.html#%28part._.Obligation_.Information_in_.Check_.Syntax%29" class="toclink" data-pltdoc="x">8.7.3<span class="hspace">&nbsp;</span>Obligation Information in Check Syntax</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Building_New_Contract_Combinators.html#%28part._.Utilities_for_.Building_.New_.Combinators%29" class="toclink" data-pltdoc="x">8.7.4<span class="hspace">&nbsp;</span>Utilities for Building New Combinators</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-utilities.html" class="toclink" data-pltdoc="x">8.8<span class="hspace">&nbsp;</span>Contract Utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="racket_contract_base.html" class="toclink" data-pltdoc="x">8.9<span class="hspace">&nbsp;</span><span class="RktModLink"><span class="RktSym">racket/contract/base</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="collapsible.html" class="toclink" data-pltdoc="x">8.10<span class="hspace">&nbsp;</span>Collapsible Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Legacy_Contracts.html" class="toclink" data-pltdoc="x">8.11<span class="hspace">&nbsp;</span>Legacy Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Random_generation.html" class="toclink" data-pltdoc="x">8.12<span class="hspace">&nbsp;</span>Random generation</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="match.html" class="toptoclink" data-pltdoc="x">9<span class="hspace">&nbsp;</span>Pattern Matching</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="match.html#%28part._.Additional_.Matching_.Forms%29" class="toclink" data-pltdoc="x">9.1<span class="hspace">&nbsp;</span>Additional Matching Forms</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="match.html#%28part._.Extending_match%29" class="toclink" data-pltdoc="x">9.2<span class="hspace">&nbsp;</span>Extending <span class="RktSym"><span class="RktStxLink">match</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="match.html#%28part._.Library_.Extensions%29" class="toclink" data-pltdoc="x">9.3<span class="hspace">&nbsp;</span>Library Extensions</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="control.html" class="toptoclink" data-pltdoc="x">10<span class="hspace">&nbsp;</span>Control Flow</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="values.html" class="toclink" data-pltdoc="x">10.1<span class="hspace">&nbsp;</span>Multiple Values</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="exns.html" class="toclink" data-pltdoc="x">10.2<span class="hspace">&nbsp;</span>Exceptions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="exns.html#%28part._err-msg-conventions%29" class="toclink" data-pltdoc="x">10.2.1<span class="hspace">&nbsp;</span>Error Message Conventions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="exns.html#%28part._errorproc%29" class="toclink" data-pltdoc="x">10.2.2<span class="hspace">&nbsp;</span>Raising Exceptions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="exns.html#%28part._.Handling_.Exceptions%29" class="toclink" data-pltdoc="x">10.2.3<span class="hspace">&nbsp;</span>Handling Exceptions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="exns.html#%28part._.Configuring_.Default_.Handling%29" class="toclink" data-pltdoc="x">10.2.4<span class="hspace">&nbsp;</span>Configuring Default Handling</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="exns.html#%28part._.Built-in_.Exception_.Types%29" class="toclink" data-pltdoc="x">10.2.5<span class="hspace">&nbsp;</span>Built-in Exception Types</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="exns.html#%28part._.Additional_.Exception_.Functions%29" class="toclink" data-pltdoc="x">10.2.6<span class="hspace">&nbsp;</span>Additional Exception Functions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="exns.html#%28part._err-realm%29" class="toclink" data-pltdoc="x">10.2.7<span class="hspace">&nbsp;</span>Realms and Error Message Adjusters</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Delayed_Evaluation.html" class="toclink" data-pltdoc="x">10.3<span class="hspace">&nbsp;</span>Delayed Evaluation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Delayed_Evaluation.html#%28part._.Additional_.Promise_.Kinds%29" class="toclink" data-pltdoc="x">10.3.1<span class="hspace">&nbsp;</span>Additional Promise Kinds</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="cont.html" class="toclink" data-pltdoc="x">10.4<span class="hspace">&nbsp;</span>Continuations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="cont.html#%28part._.Additional_.Control_.Operators%29" class="toclink" data-pltdoc="x">10.4.1<span class="hspace">&nbsp;</span>Additional Control Operators</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contmarks.html" class="toclink" data-pltdoc="x">10.5<span class="hspace">&nbsp;</span>Continuation Marks</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="breakhandler.html" class="toclink" data-pltdoc="x">10.6<span class="hspace">&nbsp;</span>Breaks</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Exiting.html" class="toclink" data-pltdoc="x">10.7<span class="hspace">&nbsp;</span>Exiting</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="unreachable.html" class="toclink" data-pltdoc="x">10.8<span class="hspace">&nbsp;</span>Unreachable Expressions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="unreachable.html#%28part._with-unreachable%29" class="toclink" data-pltdoc="x">10.8.1<span class="hspace">&nbsp;</span>Customized Unreachable Reporting</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="concurrency.html" class="toptoclink" data-pltdoc="x">11<span class="hspace">&nbsp;</span>Concurrency and Parallelism</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="threads.html" class="toclink" data-pltdoc="x">11.1<span class="hspace">&nbsp;</span>Threads</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="threads.html#%28part._.Creating_.Threads%29" class="toclink" data-pltdoc="x">11.1.1<span class="hspace">&nbsp;</span>Creating Threads</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="threads.html#%28part._threadkill%29" class="toclink" data-pltdoc="x">11.1.2<span class="hspace">&nbsp;</span>Suspending, Resuming, and Killing Threads</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="threads.html#%28part._threadsync%29" class="toclink" data-pltdoc="x">11.1.3<span class="hspace">&nbsp;</span>Synchronizing Thread State</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="threads.html#%28part._threadmbox%29" class="toclink" data-pltdoc="x">11.1.4<span class="hspace">&nbsp;</span>Thread Mailboxes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="all-sync.html" class="toclink" data-pltdoc="x">11.2<span class="hspace">&nbsp;</span>Synchronization</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sync.html" class="toclink" data-pltdoc="x">11.2.1<span class="hspace">&nbsp;</span>Events</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="channel.html" class="toclink" data-pltdoc="x">11.2.2<span class="hspace">&nbsp;</span>Channels</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="semaphore.html" class="toclink" data-pltdoc="x">11.2.3<span class="hspace">&nbsp;</span>Semaphores</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="async-channel.html" class="toclink" data-pltdoc="x">11.2.4<span class="hspace">&nbsp;</span>Buffered Asynchronous Channels</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="async-channel.html#%28part._.Creating_and_.Using_.Asynchronous_.Channels%29" class="toclink" data-pltdoc="x">11.2.4.1<span class="hspace">&nbsp;</span>Creating and Using Asynchronous Channels</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="async-channel.html#%28part._.Contracts_and_.Impersonators_on_.Asynchronous_.Channels%29" class="toclink" data-pltdoc="x">11.2.4.2<span class="hspace">&nbsp;</span>Contracts and Impersonators on Asynchronous Channels</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="thread-local-storage.html" class="toclink" data-pltdoc="x">11.3<span class="hspace">&nbsp;</span>Thread-Local Storage</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="threadcells.html" class="toclink" data-pltdoc="x">11.3.1<span class="hspace">&nbsp;</span>Thread Cells</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="parameters.html" class="toclink" data-pltdoc="x">11.3.2<span class="hspace">&nbsp;</span>Parameters</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="futures.html" class="toclink" data-pltdoc="x">11.4<span class="hspace">&nbsp;</span>Futures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="futures.html#%28part._.Creating_and_.Touching_.Futures%29" class="toclink" data-pltdoc="x">11.4.1<span class="hspace">&nbsp;</span>Creating and Touching Futures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="futures.html#%28part._.Future_.Semaphores%29" class="toclink" data-pltdoc="x">11.4.2<span class="hspace">&nbsp;</span>Future Semaphores</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="futures.html#%28part._future-logging%29" class="toclink" data-pltdoc="x">11.4.3<span class="hspace">&nbsp;</span>Future Performance Logging</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="places.html" class="toclink" data-pltdoc="x">11.5<span class="hspace">&nbsp;</span>Places</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="places.html#%28part._places-api%29" class="toclink" data-pltdoc="x">11.5.1<span class="hspace">&nbsp;</span>Using Places</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="places.html#%28part._places-syntax%29" class="toclink" data-pltdoc="x">11.5.2<span class="hspace">&nbsp;</span>Syntactic Support for Using Places</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="places.html#%28part._place-logging%29" class="toclink" data-pltdoc="x">11.5.3<span class="hspace">&nbsp;</span>Places Logging</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="engine.html" class="toclink" data-pltdoc="x">11.6<span class="hspace">&nbsp;</span>Engines</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="memory-order.html" class="toclink" data-pltdoc="x">11.7<span class="hspace">&nbsp;</span>Machine Memory Order</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Macros.html" class="toptoclink" data-pltdoc="x">12<span class="hspace">&nbsp;</span>Macros</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stx-patterns.html" class="toclink" data-pltdoc="x">12.1<span class="hspace">&nbsp;</span>Pattern-Based Syntax Matching</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxops.html" class="toclink" data-pltdoc="x">12.2<span class="hspace">&nbsp;</span>Syntax Object Content</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxops.html#%28part._.Syntax_.Object_.Source_.Locations%29" class="toclink" data-pltdoc="x">12.2.1<span class="hspace">&nbsp;</span>Syntax Object Source Locations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxcmp.html" class="toclink" data-pltdoc="x">12.3<span class="hspace">&nbsp;</span>Syntax Object Bindings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxtrans.html" class="toclink" data-pltdoc="x">12.4<span class="hspace">&nbsp;</span>Syntax Transformers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxtrans.html#%28part._require-trans%29" class="toclink" data-pltdoc="x">12.4.1<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">require</span></span> Transformers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxtrans.html#%28part._provide-trans%29" class="toclink" data-pltdoc="x">12.4.2<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">provide</span></span> Transformers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxtrans.html#%28part._keyword-trans%29" class="toclink" data-pltdoc="x">12.4.3<span class="hspace">&nbsp;</span>Keyword-Argument Conversion Introspection</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxtrans.html#%28part._portal-syntax%29" class="toclink" data-pltdoc="x">12.4.4<span class="hspace">&nbsp;</span>Portal Syntax Bindings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxparam.html" class="toclink" data-pltdoc="x">12.5<span class="hspace">&nbsp;</span>Syntax Parameters</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxparam.html#%28part._.Syntax_.Parameter_.Inspection%29" class="toclink" data-pltdoc="x">12.5.1<span class="hspace">&nbsp;</span>Syntax Parameter Inspection</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="splicing.html" class="toclink" data-pltdoc="x">12.6<span class="hspace">&nbsp;</span>Local Binding with Splicing Body</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxprops.html" class="toclink" data-pltdoc="x">12.7<span class="hspace">&nbsp;</span>Syntax Object Properties</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stxcerts.html" class="toclink" data-pltdoc="x">12.8<span class="hspace">&nbsp;</span>Syntax Taints</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Expanding_Top-Level_Forms.html" class="toclink" data-pltdoc="x">12.9<span class="hspace">&nbsp;</span>Expanding Top-Level Forms</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Expanding_Top-Level_Forms.html#%28part._modinfo%29" class="toclink" data-pltdoc="x">12.9.1<span class="hspace">&nbsp;</span>Information on Expanded Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Serializing_Syntax.html" class="toclink" data-pltdoc="x">12.10<span class="hspace">&nbsp;</span>Serializing Syntax</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="include.html" class="toclink" data-pltdoc="x">12.11<span class="hspace">&nbsp;</span>File Inclusion</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-util.html" class="toclink" data-pltdoc="x">12.12<span class="hspace">&nbsp;</span>Syntax Utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-util.html#%28part._.Creating_formatted_identifiers%29" class="toclink" data-pltdoc="x">12.12.1<span class="hspace">&nbsp;</span>Creating formatted identifiers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-util.html#%28part._.Pattern_variables%29" class="toclink" data-pltdoc="x">12.12.2<span class="hspace">&nbsp;</span>Pattern variables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-util.html#%28part._.Error_reporting%29" class="toclink" data-pltdoc="x">12.12.3<span class="hspace">&nbsp;</span>Error reporting</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-util.html#%28part._.Recording_disappeared_uses%29" class="toclink" data-pltdoc="x">12.12.4<span class="hspace">&nbsp;</span>Recording disappeared uses</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-util.html#%28part._.Miscellaneous_utilities%29" class="toclink" data-pltdoc="x">12.12.5<span class="hspace">&nbsp;</span>Miscellaneous utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="phase_space.html" class="toclink" data-pltdoc="x">12.13<span class="hspace">&nbsp;</span>Phase and Space Utilities</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="input-and-output.html" class="toptoclink" data-pltdoc="x">13<span class="hspace">&nbsp;</span>Input and Output</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="ports.html" class="toclink" data-pltdoc="x">13.1<span class="hspace">&nbsp;</span>Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="encodings.html" class="toclink" data-pltdoc="x">13.1.1<span class="hspace">&nbsp;</span>Encodings and Locales</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="port-ops.html" class="toclink" data-pltdoc="x">13.1.2<span class="hspace">&nbsp;</span>Managing Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="port-buffers.html" class="toclink" data-pltdoc="x">13.1.3<span class="hspace">&nbsp;</span>Port Buffers and Positions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="linecol.html" class="toclink" data-pltdoc="x">13.1.4<span class="hspace">&nbsp;</span>Counting Positions, Lines, and Columns</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="file-ports.html" class="toclink" data-pltdoc="x">13.1.5<span class="hspace">&nbsp;</span>File Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stringport.html" class="toclink" data-pltdoc="x">13.1.6<span class="hspace">&nbsp;</span>String Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pipeports.html" class="toclink" data-pltdoc="x">13.1.7<span class="hspace">&nbsp;</span>Pipes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="portstructs.html" class="toclink" data-pltdoc="x">13.1.8<span class="hspace">&nbsp;</span>Structures as Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="customport.html" class="toclink" data-pltdoc="x">13.1.9<span class="hspace">&nbsp;</span>Custom Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="port-lib.html" class="toclink" data-pltdoc="x">13.1.10<span class="hspace">&nbsp;</span>More Port Constructors, Procedures, and Events</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="port-lib.html#%28part._.Port_.String_and_.List_.Conversions%29" class="toclink" data-pltdoc="x">13.1.10.1<span class="hspace">&nbsp;</span>Port String and List Conversions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="port-lib.html#%28part._.Creating_.Ports%29" class="toclink" data-pltdoc="x">13.1.10.2<span class="hspace">&nbsp;</span>Creating Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="port-lib.html#%28part._.Port_.Events%29" class="toclink" data-pltdoc="x">13.1.10.3<span class="hspace">&nbsp;</span>Port Events</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="port-lib.html#%28part._.Copying_.Streams%29" class="toclink" data-pltdoc="x">13.1.10.4<span class="hspace">&nbsp;</span>Copying Streams</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Byte_and_String_Input.html" class="toclink" data-pltdoc="x">13.2<span class="hspace">&nbsp;</span>Byte and String Input</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Byte_and_String_Output.html" class="toclink" data-pltdoc="x">13.3<span class="hspace">&nbsp;</span>Byte and String Output</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Reading.html" class="toclink" data-pltdoc="x">13.4<span class="hspace">&nbsp;</span>Reading</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Writing.html" class="toclink" data-pltdoc="x">13.5<span class="hspace">&nbsp;</span>Writing</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pretty-print.html" class="toclink" data-pltdoc="x">13.6<span class="hspace">&nbsp;</span>Pretty Printing</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pretty-print.html#%28part._.Basic_.Pretty-.Print_.Options%29" class="toclink" data-pltdoc="x">13.6.1<span class="hspace">&nbsp;</span>Basic Pretty-Print Options</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pretty-print.html#%28part._.Per-.Symbol_.Special_.Printing%29" class="toclink" data-pltdoc="x">13.6.2<span class="hspace">&nbsp;</span>Per-Symbol Special Printing</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pretty-print.html#%28part._.Line-.Output_.Hook%29" class="toclink" data-pltdoc="x">13.6.3<span class="hspace">&nbsp;</span>Line-Output Hook</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pretty-print.html#%28part._.Value_.Output_.Hook%29" class="toclink" data-pltdoc="x">13.6.4<span class="hspace">&nbsp;</span>Value Output Hook</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pretty-print.html#%28part._.Additional_.Custom-.Output_.Support%29" class="toclink" data-pltdoc="x">13.6.5<span class="hspace">&nbsp;</span>Additional Custom-Output Support</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Reader_Extension.html" class="toclink" data-pltdoc="x">13.7<span class="hspace">&nbsp;</span>Reader Extension</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="readtables.html" class="toclink" data-pltdoc="x">13.7.1<span class="hspace">&nbsp;</span>Readtables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="reader-procs.html" class="toclink" data-pltdoc="x">13.7.2<span class="hspace">&nbsp;</span>Reader-Extension Procedures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="special-comments.html" class="toclink" data-pltdoc="x">13.7.3<span class="hspace">&nbsp;</span>Special Comments</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Printer_Extension.html" class="toclink" data-pltdoc="x">13.8<span class="hspace">&nbsp;</span>Printer Extension</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="serialization.html" class="toclink" data-pltdoc="x">13.9<span class="hspace">&nbsp;</span>Serialization</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="fasl.html" class="toclink" data-pltdoc="x">13.10<span class="hspace">&nbsp;</span>Fast-Load Serialization</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sha.html" class="toclink" data-pltdoc="x">13.11<span class="hspace">&nbsp;</span>Cryptographic Hashing</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="security.html" class="toptoclink" data-pltdoc="x">14<span class="hspace">&nbsp;</span>Reflection and Security</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Namespaces.html" class="toclink" data-pltdoc="x">14.1<span class="hspace">&nbsp;</span>Namespaces</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval.html" class="toclink" data-pltdoc="x">14.2<span class="hspace">&nbsp;</span>Evaluation and Compilation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="load-lang.html" class="toclink" data-pltdoc="x">14.3<span class="hspace">&nbsp;</span>The <span class="RktModLink"><span class="RktSym">racket/load</span></span> Language</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Module_Names_and_Loading.html" class="toclink" data-pltdoc="x">14.4<span class="hspace">&nbsp;</span>Module Names and Loading</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Module_Names_and_Loading.html#%28part._modnameresolver%29" class="toclink" data-pltdoc="x">14.4.1<span class="hspace">&nbsp;</span>Resolving Module Names</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Module_Names_and_Loading.html#%28part._modpathidx%29" class="toclink" data-pltdoc="x">14.4.2<span class="hspace">&nbsp;</span>Compiled Modules and References</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Module_Names_and_Loading.html#%28part._dynreq%29" class="toclink" data-pltdoc="x">14.4.3<span class="hspace">&nbsp;</span>Dynamic Module Access</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Module_Names_and_Loading.html#%28part._modcache%29" class="toclink" data-pltdoc="x">14.4.4<span class="hspace">&nbsp;</span>Module Cache</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="chaperones.html" class="toclink" data-pltdoc="x">14.5<span class="hspace">&nbsp;</span>Impersonators and Chaperones</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="chaperones.html#%28part._.Impersonator_.Constructors%29" class="toclink" data-pltdoc="x">14.5.1<span class="hspace">&nbsp;</span>Impersonator Constructors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="chaperones.html#%28part._.Chaperone_.Constructors%29" class="toclink" data-pltdoc="x">14.5.2<span class="hspace">&nbsp;</span>Chaperone Constructors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="chaperones.html#%28part._.Impersonator_.Properties%29" class="toclink" data-pltdoc="x">14.5.3<span class="hspace">&nbsp;</span>Impersonator Properties</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="securityguards.html" class="toclink" data-pltdoc="x">14.6<span class="hspace">&nbsp;</span>Security Guards</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="custodians.html" class="toclink" data-pltdoc="x">14.7<span class="hspace">&nbsp;</span>Custodians</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="threadgroups.html" class="toclink" data-pltdoc="x">14.8<span class="hspace">&nbsp;</span>Thread Groups</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="inspectors.html" class="toclink" data-pltdoc="x">14.9<span class="hspace">&nbsp;</span>Structure Inspectors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="modprotect.html" class="toclink" data-pltdoc="x">14.10<span class="hspace">&nbsp;</span>Code Inspectors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="plumbers.html" class="toclink" data-pltdoc="x">14.11<span class="hspace">&nbsp;</span>Plumbers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Sandboxed_Evaluation.html" class="toclink" data-pltdoc="x">14.12<span class="hspace">&nbsp;</span>Sandboxed Evaluation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Sandboxed_Evaluation.html#%28part._.Security_.Considerations%29" class="toclink" data-pltdoc="x">14.12.1<span class="hspace">&nbsp;</span>Security Considerations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Sandboxed_Evaluation.html#%28part._.Customizing_.Evaluators%29" class="toclink" data-pltdoc="x">14.12.2<span class="hspace">&nbsp;</span>Customizing Evaluators</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Sandboxed_Evaluation.html#%28part._.Interacting_with_.Evaluators%29" class="toclink" data-pltdoc="x">14.12.3<span class="hspace">&nbsp;</span>Interacting with Evaluators</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Sandboxed_Evaluation.html#%28part._.Miscellaneous%29" class="toclink" data-pltdoc="x">14.12.4<span class="hspace">&nbsp;</span>Miscellaneous</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="repl-module.html" class="toclink" data-pltdoc="x">14.13<span class="hspace">&nbsp;</span>The <span class="RktModLink"><span class="RktSym">racket/repl</span></span> Library</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="linklets.html" class="toclink" data-pltdoc="x">14.14<span class="hspace">&nbsp;</span>Linklets and the Core Compiler</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="os.html" class="toptoclink" data-pltdoc="x">15<span class="hspace">&nbsp;</span>Operating System</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pathutils.html" class="toclink" data-pltdoc="x">15.1<span class="hspace">&nbsp;</span>Paths</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Manipulating_Paths.html" class="toclink" data-pltdoc="x">15.1.1<span class="hspace">&nbsp;</span>Manipulating Paths</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="More_Path_Utilities.html" class="toclink" data-pltdoc="x">15.1.2<span class="hspace">&nbsp;</span>More Path Utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="unixpaths.html" class="toclink" data-pltdoc="x">15.1.3<span class="hspace">&nbsp;</span>Unix and Mac OS Paths</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="unixpaths.html#%28part._unixpathrep%29" class="toclink" data-pltdoc="x">15.1.3.1<span class="hspace">&nbsp;</span>Unix Path Representation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="windowspaths.html" class="toclink" data-pltdoc="x">15.1.4<span class="hspace">&nbsp;</span>Windows Paths</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="windowspaths.html#%28part._windowspathrep%29" class="toclink" data-pltdoc="x">15.1.4.1<span class="hspace">&nbsp;</span>Windows Path Representation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Filesystem.html" class="toclink" data-pltdoc="x">15.2<span class="hspace">&nbsp;</span>Filesystem</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Filesystem.html#%28part._findpaths%29" class="toclink" data-pltdoc="x">15.2.1<span class="hspace">&nbsp;</span>Locating Paths</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Filesystem.html#%28part._fileutils%29" class="toclink" data-pltdoc="x">15.2.2<span class="hspace">&nbsp;</span>Files</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Filesystem.html#%28part._directories%29" class="toclink" data-pltdoc="x">15.2.3<span class="hspace">&nbsp;</span>Directories</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Filesystem.html#%28part._filesystem-change%29" class="toclink" data-pltdoc="x">15.2.4<span class="hspace">&nbsp;</span>Detecting Filesystem Changes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Filesystem.html#%28part._runtime-path%29" class="toclink" data-pltdoc="x">15.2.5<span class="hspace">&nbsp;</span>Declaring Paths Needed at Run Time</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Filesystem.html#%28part._file-lib%29" class="toclink" data-pltdoc="x">15.2.6<span class="hspace">&nbsp;</span>More File and Directory Utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="networking.html" class="toclink" data-pltdoc="x">15.3<span class="hspace">&nbsp;</span>Networking</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="tcp.html" class="toclink" data-pltdoc="x">15.3.1<span class="hspace">&nbsp;</span>TCP</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="udp.html" class="toclink" data-pltdoc="x">15.3.2<span class="hspace">&nbsp;</span>UDP</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="subprocess.html" class="toclink" data-pltdoc="x">15.4<span class="hspace">&nbsp;</span>Processes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="subprocess.html#%28part._.Simple_.Subprocesses%29" class="toclink" data-pltdoc="x">15.4.1<span class="hspace">&nbsp;</span>Simple Subprocesses</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="logging.html" class="toclink" data-pltdoc="x">15.5<span class="hspace">&nbsp;</span>Logging</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="logging.html#%28part._.Creating_.Loggers%29" class="toclink" data-pltdoc="x">15.5.1<span class="hspace">&nbsp;</span>Creating Loggers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="logging.html#%28part._.Logging_.Events%29" class="toclink" data-pltdoc="x">15.5.2<span class="hspace">&nbsp;</span>Logging Events</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="logging.html#%28part._receiving-logged-events%29" class="toclink" data-pltdoc="x">15.5.3<span class="hspace">&nbsp;</span>Receiving Logged Events</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="logging.html#%28part._.Additional_.Logging_.Functions%29" class="toclink" data-pltdoc="x">15.5.4<span class="hspace">&nbsp;</span>Additional Logging Functions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="time.html" class="toclink" data-pltdoc="x">15.6<span class="hspace">&nbsp;</span>Time</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="time.html#%28part._date-string%29" class="toclink" data-pltdoc="x">15.6.1<span class="hspace">&nbsp;</span>Date Utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="envvars.html" class="toclink" data-pltdoc="x">15.7<span class="hspace">&nbsp;</span>Environment Variables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="runtime.html" class="toclink" data-pltdoc="x">15.8<span class="hspace">&nbsp;</span>Environment and Runtime Information</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Command-Line_Parsing.html" class="toclink" data-pltdoc="x">15.9<span class="hspace">&nbsp;</span>Command-Line Parsing</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="os-lib.html" class="toclink" data-pltdoc="x">15.10<span class="hspace">&nbsp;</span>Additional Operating System Functions</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="memory.html" class="toptoclink" data-pltdoc="x">16<span class="hspace">&nbsp;</span>Memory Management</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="weakbox.html" class="toclink" data-pltdoc="x">16.1<span class="hspace">&nbsp;</span>Weak Boxes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="ephemerons.html" class="toclink" data-pltdoc="x">16.2<span class="hspace">&nbsp;</span>Ephemerons</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="willexecutor.html" class="toclink" data-pltdoc="x">16.3<span class="hspace">&nbsp;</span>Wills and Executors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="garbagecollection.html" class="toclink" data-pltdoc="x">16.4<span class="hspace">&nbsp;</span>Garbage Collection</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="phantom-bytes.html" class="toclink" data-pltdoc="x">16.5<span class="hspace">&nbsp;</span>Phantom Byte Strings</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="unsafe.html" class="toptoclink" data-pltdoc="x">17<span class="hspace">&nbsp;</span>Unsafe Operations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="unsafe.html#%28part._.Unsafe_.Numeric_.Operations%29" class="toclink" data-pltdoc="x">17.1<span class="hspace">&nbsp;</span>Unsafe Numeric Operations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="unsafe.html#%28part._.Unsafe_.Character_.Operations%29" class="toclink" data-pltdoc="x">17.2<span class="hspace">&nbsp;</span>Unsafe Character Operations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="unsafe.html#%28part._.Unsafe._.Data._.Extraction%29" class="toclink" data-pltdoc="x">17.3<span class="hspace">&nbsp;</span>Unsafe Compound-Data Operations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="unsafe.html#%28part._unsafeextfl%29" class="toclink" data-pltdoc="x">17.4<span class="hspace">&nbsp;</span>Unsafe Extflonum Operations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="unsafe.html#%28part._.Unsafe_.Impersonators_and_.Chaperones%29" class="toclink" data-pltdoc="x">17.5<span class="hspace">&nbsp;</span>Unsafe Impersonators and Chaperones</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="unsafe.html#%28part._unsafeassert%29" class="toclink" data-pltdoc="x">17.6<span class="hspace">&nbsp;</span>Unsafe Assertions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="unsafe.html#%28part._unsafe-undefined%29" class="toclink" data-pltdoc="x">17.7<span class="hspace">&nbsp;</span>Unsafe Undefined</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="running.html" class="toptoclink" data-pltdoc="x">18<span class="hspace">&nbsp;</span>Running Racket</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="running-sa.html" class="toclink" data-pltdoc="x">18.1<span class="hspace">&nbsp;</span>Running Racket or GRacket</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="running-sa.html#%28part._init-actions%29" class="toclink" data-pltdoc="x">18.1.1<span class="hspace">&nbsp;</span>Initialization</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="running-sa.html#%28part._exit-status%29" class="toclink" data-pltdoc="x">18.1.2<span class="hspace">&nbsp;</span>Exit Status</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="running-sa.html#%28part._.Init_.Libraries%29" class="toclink" data-pltdoc="x">18.1.3<span class="hspace">&nbsp;</span>Init Libraries</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="running-sa.html#%28part._mz-cmdline%29" class="toclink" data-pltdoc="x">18.1.4<span class="hspace">&nbsp;</span>Command Line</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="running-sa.html#%28part._configure-runtime%29" class="toclink" data-pltdoc="x">18.1.5<span class="hspace">&nbsp;</span>Language Run-Time Configuration</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="collects.html" class="toclink" data-pltdoc="x">18.2<span class="hspace">&nbsp;</span>Libraries and Collections</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="collects.html#%28part._collects-search%29" class="toclink" data-pltdoc="x">18.2.1<span class="hspace">&nbsp;</span>Collection Search Configuration</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="collects.html#%28part._links-file%29" class="toclink" data-pltdoc="x">18.2.2<span class="hspace">&nbsp;</span>Collection Links</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="collects.html#%28part._collects-api%29" class="toclink" data-pltdoc="x">18.2.3<span class="hspace">&nbsp;</span>Collection Paths and Parameters</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Interactive_Help.html" class="toclink" data-pltdoc="x">18.3<span class="hspace">&nbsp;</span>Interactive Help</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="interaction-info.html" class="toclink" data-pltdoc="x">18.4<span class="hspace">&nbsp;</span>Interaction Configuration</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="interactive.html" class="toclink" data-pltdoc="x">18.5<span class="hspace">&nbsp;</span>Interactive Module Loading</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="interactive.html#%28part._enter%29" class="toclink" data-pltdoc="x">18.5.1<span class="hspace">&nbsp;</span>Entering Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="interactive.html#%28part._rerequire%29" class="toclink" data-pltdoc="x">18.5.2<span class="hspace">&nbsp;</span>Loading and Reloading Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="debugging.html" class="toclink" data-pltdoc="x">18.6<span class="hspace">&nbsp;</span>Debugging</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="debugging.html#%28part._.Tracing%29" class="toclink" data-pltdoc="x">18.6.1<span class="hspace">&nbsp;</span>Tracing</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="compiler.html" class="toclink" data-pltdoc="x">18.7<span class="hspace">&nbsp;</span>Controlling and Inspecting Compilation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="compiler.html#%28part._compiler-modes%29" class="toclink" data-pltdoc="x">18.7.1<span class="hspace">&nbsp;</span>Compilation Modes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="compiler.html#%28part._3m-compiler-modes%29" class="toclink" data-pltdoc="x">18.7.1.1<span class="hspace">&nbsp;</span>BC Compilation Modes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="compiler.html#%28part._cs-compiler-modes%29" class="toclink" data-pltdoc="x">18.7.1.2<span class="hspace">&nbsp;</span>CS Compilation Modes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="compiler.html#%28part._compiler-inspect%29" class="toclink" data-pltdoc="x">18.7.2<span class="hspace">&nbsp;</span>Inspecting Compiler Passes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Kernel_Forms_and_Functions.html" class="toclink" data-pltdoc="x">18.8<span class="hspace">&nbsp;</span>Kernel Forms and Functions</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="doc-bibliography.html" class="toptoclink" data-pltdoc="x">Bibliography</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="doc-index.html" class="toptoclink" data-pltdoc="x">Index</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<span class="nonavigation">&larr; prev</span>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">up</a>&nbsp;&nbsp;<a href="model.html" title="forward to &quot;1 Language Model&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/input-and-output.html b/clones/docs.racket-lang.org/reference/input-and-output.html
new file mode 100644
index 00000000..6ee3b1f6
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/input-and-output.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13&nbsp;Input and Output</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="phase_space.html" title="backward to &quot;12.13 Phase and Space Utilities&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="ports.html" title="forward to &quot;13.1 Ports&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;input-and-output&quot;">13<tt>&nbsp;</tt><a name="(part._input-and-output)"></a>Input and Output</h3><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=i_o.html&amp;version=8.6" class="Sq" data-pltdoc="x">Input and Output</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces Ports and I/O.</p></blockquote></blockquote></blockquote><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="ports.html" class="toclink" data-pltdoc="x">13.1<span class="hspace">&nbsp;</span>Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="encodings.html" class="toclink" data-pltdoc="x">13.1.1<span class="hspace">&nbsp;</span>Encodings and Locales</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="port-ops.html" class="toclink" data-pltdoc="x">13.1.2<span class="hspace">&nbsp;</span>Managing Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="port-buffers.html" class="toclink" data-pltdoc="x">13.1.3<span class="hspace">&nbsp;</span>Port Buffers and Positions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="linecol.html" class="toclink" data-pltdoc="x">13.1.4<span class="hspace">&nbsp;</span>Counting Positions, Lines, and Columns</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="file-ports.html" class="toclink" data-pltdoc="x">13.1.5<span class="hspace">&nbsp;</span>File Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stringport.html" class="toclink" data-pltdoc="x">13.1.6<span class="hspace">&nbsp;</span>String Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pipeports.html" class="toclink" data-pltdoc="x">13.1.7<span class="hspace">&nbsp;</span>Pipes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="portstructs.html" class="toclink" data-pltdoc="x">13.1.8<span class="hspace">&nbsp;</span>Structures as Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="customport.html" class="toclink" data-pltdoc="x">13.1.9<span class="hspace">&nbsp;</span>Custom Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="port-lib.html" class="toclink" data-pltdoc="x">13.1.10<span class="hspace">&nbsp;</span>More Port Constructors, Procedures, and Events</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="port-lib.html#%28part._.Port_.String_and_.List_.Conversions%29" class="toclink" data-pltdoc="x">13.1.10.1<span class="hspace">&nbsp;</span>Port String and List Conversions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="port-lib.html#%28part._.Creating_.Ports%29" class="toclink" data-pltdoc="x">13.1.10.2<span class="hspace">&nbsp;</span>Creating Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="port-lib.html#%28part._.Port_.Events%29" class="toclink" data-pltdoc="x">13.1.10.3<span class="hspace">&nbsp;</span>Port Events</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="port-lib.html#%28part._.Copying_.Streams%29" class="toclink" data-pltdoc="x">13.1.10.4<span class="hspace">&nbsp;</span>Copying Streams</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Byte_and_String_Input.html" class="toclink" data-pltdoc="x">13.2<span class="hspace">&nbsp;</span>Byte and String Input</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Byte_and_String_Output.html" class="toclink" data-pltdoc="x">13.3<span class="hspace">&nbsp;</span>Byte and String Output</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Reading.html" class="toclink" data-pltdoc="x">13.4<span class="hspace">&nbsp;</span>Reading</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Writing.html" class="toclink" data-pltdoc="x">13.5<span class="hspace">&nbsp;</span>Writing</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pretty-print.html" class="toclink" data-pltdoc="x">13.6<span class="hspace">&nbsp;</span>Pretty Printing</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pretty-print.html#%28part._.Basic_.Pretty-.Print_.Options%29" class="toclink" data-pltdoc="x">13.6.1<span class="hspace">&nbsp;</span>Basic Pretty-Print Options</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pretty-print.html#%28part._.Per-.Symbol_.Special_.Printing%29" class="toclink" data-pltdoc="x">13.6.2<span class="hspace">&nbsp;</span>Per-Symbol Special Printing</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pretty-print.html#%28part._.Line-.Output_.Hook%29" class="toclink" data-pltdoc="x">13.6.3<span class="hspace">&nbsp;</span>Line-Output Hook</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pretty-print.html#%28part._.Value_.Output_.Hook%29" class="toclink" data-pltdoc="x">13.6.4<span class="hspace">&nbsp;</span>Value Output Hook</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pretty-print.html#%28part._.Additional_.Custom-.Output_.Support%29" class="toclink" data-pltdoc="x">13.6.5<span class="hspace">&nbsp;</span>Additional Custom-Output Support</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Reader_Extension.html" class="toclink" data-pltdoc="x">13.7<span class="hspace">&nbsp;</span>Reader Extension</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="readtables.html" class="toclink" data-pltdoc="x">13.7.1<span class="hspace">&nbsp;</span>Readtables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="reader-procs.html" class="toclink" data-pltdoc="x">13.7.2<span class="hspace">&nbsp;</span>Reader-Extension Procedures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="special-comments.html" class="toclink" data-pltdoc="x">13.7.3<span class="hspace">&nbsp;</span>Special Comments</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Printer_Extension.html" class="toclink" data-pltdoc="x">13.8<span class="hspace">&nbsp;</span>Printer Extension</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="serialization.html" class="toclink" data-pltdoc="x">13.9<span class="hspace">&nbsp;</span>Serialization</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="fasl.html" class="toclink" data-pltdoc="x">13.10<span class="hspace">&nbsp;</span>Fast-Load Serialization</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sha.html" class="toclink" data-pltdoc="x">13.11<span class="hspace">&nbsp;</span>Cryptographic Hashing</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="phase_space.html" title="backward to &quot;12.13 Phase and Space Utilities&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="ports.html" title="forward to &quot;13.1 Ports&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/inspectors.html b/clones/docs.racket-lang.org/reference/inspectors.html
new file mode 100644
index 00000000..db6e4d96
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/inspectors.html
@@ -0,0 +1,90 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14.9&nbsp;Structure Inspectors</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewselflink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Namespaces.html" class="tocviewlink" data-pltdoc="x">Namespaces</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="eval.html" class="tocviewlink" data-pltdoc="x">Evaluation and Compilation</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="load-lang.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>load</span></span> Language</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="Module_Names_and_Loading.html" class="tocviewlink" data-pltdoc="x">Module Names and Loading</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="chaperones.html" class="tocviewlink" data-pltdoc="x">Impersonators and Chaperones</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="securityguards.html" class="tocviewlink" data-pltdoc="x">Security Guards</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="custodians.html" class="tocviewlink" data-pltdoc="x">Custodians</a></td></tr><tr><td align="right">14.8&nbsp;</td><td><a href="threadgroups.html" class="tocviewlink" data-pltdoc="x">Thread Groups</a></td></tr><tr><td align="right">14.9&nbsp;</td><td><a href="inspectors.html" class="tocviewselflink" data-pltdoc="x">Structure Inspectors</a></td></tr><tr><td align="right">14.10&nbsp;</td><td><a href="modprotect.html" class="tocviewlink" data-pltdoc="x">Code Inspectors</a></td></tr><tr><td align="right">14.11&nbsp;</td><td><a href="plumbers.html" class="tocviewlink" data-pltdoc="x">Plumbers</a></td></tr><tr><td align="right">14.12&nbsp;</td><td><a href="Sandboxed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Sandboxed Evaluation</a></td></tr><tr><td align="right">14.13&nbsp;</td><td><a href="repl-module.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>repl</span></span> Library</a></td></tr><tr><td align="right">14.14&nbsp;</td><td><a href="linklets.html" class="tocviewlink" data-pltdoc="x">Linklets and the Core Compiler</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">inspector?</span></span></a></td></tr><tr><td><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._make-inspector%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>inspector</span></span></a></td></tr><tr><td><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._make-sibling-inspector%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>sibling-<wbr></wbr>inspector</span></span></a></td></tr><tr><td><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector-superior~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">inspector-<wbr></wbr>superior?</span></span></a></td></tr><tr><td><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._current-inspector%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>inspector</span></span></a></td></tr><tr><td><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-info%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>info</span></span></a></td></tr><tr><td><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-info%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>type-<wbr></wbr>info</span></span></a></td></tr><tr><td><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-sealed~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>type-<wbr></wbr>sealed?</span></span></a></td></tr><tr><td><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-authentic~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>type-<wbr></wbr>authentic?</span></span></a></td></tr><tr><td><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-make-constructor%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>type-<wbr></wbr>make-<wbr></wbr>constructor</span></span></a></td></tr><tr><td><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-make-predicate%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>type-<wbr></wbr>make-<wbr></wbr>predicate</span></span></a></td></tr><tr><td><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">object-<wbr></wbr>name</span></span></a></td></tr><tr><td><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._prop~3aobject-name%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>object-<wbr></wbr>name</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="threadgroups.html" title="backward to &quot;14.8 Thread Groups&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="modprotect.html" title="forward to &quot;14.10 Code Inspectors&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;inspectors&quot;">14.9<tt>&nbsp;</tt><a name="(part._inspectors)"></a>Structure Inspectors</h4><p>An <a name="(tech._inspector)"></a><span style="font-style: italic">inspector</span> provides access to structure fields and
+structure type information without the normal field accessors and
+mutators. (Inspectors are also used to control access to module
+bindings; see <a href="modprotect.html" data-pltdoc="x">Code Inspectors</a>.) Inspectors are primarily
+intended for use by debuggers.</p><p>When a structure type is created, an inspector can be supplied. The
+given inspector is not the one that will control the new structure
+type; instead, the given inspector&rsquo;s parent will control the type. By
+using the parent of the given inspector, the structure type remains
+opaque to &ldquo;peer&rdquo; code that cannot access the parent inspector.</p><p>The <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._current-inspector%29%29" class="RktValLink" data-pltdoc="x">current-inspector</a></span> <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> determines a default
+inspector argument for new structure types. An alternate inspector can
+be provided though the <span class="RktPn">#:inspector</span> option of the
+<span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> form (see <a href="define-struct.html" data-pltdoc="x">Defining Structure Types: <span class="RktSym"><span class="RktStxLink">struct</span></span></a>), or
+through an optional <span class="RktSym">inspector</span> argument to
+<span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._inspector~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">inspector?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if
+<span class="RktVar">v</span> is an inspector, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-inspector))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._make-inspector%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-inspector</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">inspector</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">inspector</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._current-inspector%29%29" class="RktValLink" data-pltdoc="x">current-inspector</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a new inspector that is a subinspector of
+<span class="RktVar">inspector</span>. Any structure type controlled by the new inspector
+is also controlled by its ancestor inspectors, but no other
+inspectors.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-sibling-inspector))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._make-sibling-inspector%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-sibling-inspector</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">inspector</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">inspector</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._current-inspector%29%29" class="RktValLink" data-pltdoc="x">current-inspector</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a new inspector that is a subinspector of the same inspector
+as <span class="RktVar">inspector</span>. That is, <span class="RktVar">inspector</span> and the result
+inspector control mutually disjoint sets of structure types.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._inspector-superior~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector-superior~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">inspector-superior?</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">inspector</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">maybe-subinspector</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">inspector</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">maybe-subinspector</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">inspector</span> is an ancestor of
+<span class="RktVar">maybe-subinspector</span> (and not equal to
+<span class="RktVar">maybe-subinspector</span>), <span class="RktVal">#f</span> otherwise.</div></p><p class="SHistory">Added in version 6.5.0.6 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-inspector))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._current-inspector%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-inspector</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._current-inspector%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-inspector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">insp</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">insp</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the default inspector for newly created
+structure types.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._struct-info))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-info%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-info</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-type~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns two values:</div></p><ul><li><p><span class="RktVar">struct-type</span>: a structure type descriptor or <span class="RktVal">#f</span>;
+the result is a structure type descriptor of the most specific type
+for which <span class="RktVar">v</span> is an instance, and for which the current
+inspector has control, or the result is <span class="RktVal">#f</span> if the current
+inspector does not control any structure type for which the
+<span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> is an instance.</p></li><li><p><span class="RktVar">skipped?</span>: <span class="RktVal">#f</span> if the first result corresponds to
+the most specific structure type of <span class="RktVar">v</span>, <span class="RktVal">#t</span> otherwise.</p></li></ul><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._struct-type-info))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-info%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-type-info</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">struct-type</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-accessor-procedure~3f%29%29" class="RktValLink" data-pltdoc="x">struct-accessor-procedure?</a></span></td></tr><tr><td><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-mutator-procedure~3f%29%29" class="RktValLink" data-pltdoc="x">struct-mutator-procedure?</a></span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-type~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">struct-type</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-type~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns eight values that provide information about the structure type
+ descriptor <span class="RktVar">struct-type</span>, assuming that the type is controlled
+ by the current inspector:</div></p><ul><li><p><span class="RktVar">name</span>: the structure type&rsquo;s name as a symbol;</p></li><li><p><span class="RktVar">init-field-cnt</span>: the number of fields defined by the
+structure type provided to the constructor procedure (not counting
+fields created by its ancestor types);</p></li><li><p><span class="RktVar">auto-field-cnt</span>: the number of fields defined by the
+structure type without a counterpart in the constructor procedure
+(not counting fields created by its ancestor types);</p></li><li><p><span class="RktVar">accessor-proc</span>: an accessor procedure for the structure
+type, like the one returned by <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span>;</p></li><li><p><span class="RktVar">mutator-proc</span>: a mutator procedure for the structure
+type, like the one returned by <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span>;</p></li><li><p><span class="RktVar">immutable-k-list</span>: an immutable list of exact
+non-negative integers that correspond to immutable fields for the
+structure type;</p></li><li><p><span class="RktVar">super-type</span>: a structure type descriptor for the
+most specific ancestor of the type that is controlled by the
+current inspector, or <span class="RktVal">#f</span> if no ancestor is controlled by
+the current inspector;</p></li><li><p><span class="RktVar">skipped?</span>: <span class="RktVal">#f</span> if the seventh result is the
+most specific ancestor type or if the type has no supertype,
+<span class="RktVal">#t</span> otherwise.</p></li></ul><p>If the type for <span class="RktVar">struct-type</span> is not controlled by the current inspector,
+the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._struct-type-sealed~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-sealed~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-type-sealed?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">struct-type</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">struct-type</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-type~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Reports whether <span class="RktVar">struct-type</span> has the <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3asealed%29%29" class="RktValLink" data-pltdoc="x">prop:sealed</a></span>
+structure type property.</div></p><p class="SHistory">Added in version 8.0.0.7 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._struct-type-authentic~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-authentic~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-type-authentic?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">struct-type</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">struct-type</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-type~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Reports whether <span class="RktVar">struct-type</span> has the <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._prop~3aauthentic%29%29" class="RktValLink" data-pltdoc="x">prop:authentic</a></span>
+structure type property.</div></p><p class="SHistory">Added in version 8.0.0.7 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._struct-type-make-constructor))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-make-constructor%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-type-make-constructor</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">struct-type</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">constructor-name</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-constructor-procedure~3f%29%29" class="RktValLink" data-pltdoc="x">struct-constructor-procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">struct-type</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-type~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">constructor-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="define-struct.html#%28tech._constructor%29" class="techoutside" data-pltdoc="x"><span class="techinside">constructor</span></a> procedure to create instances of the type
+for <span class="RktVar">struct-type</span>.  If <span class="RktVar">constructor-name</span> is not <span class="RktVal">#f</span>,
+it is used as the name of the generated <a href="define-struct.html#%28tech._constructor%29" class="techoutside" data-pltdoc="x"><span class="techinside">constructor</span></a> procedure.
+If the type for <span class="RktVar">struct-type</span> is not
+controlled by the current inspector, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._struct-type-make-predicate))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-make-predicate%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-type-make-predicate</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">struct-type</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">struct-type</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="define-struct.html#%28tech._predicate%29" class="techoutside" data-pltdoc="x"><span class="techinside">predicate</span></a> procedure to recognize instances of the
+type for <span class="RktVar">struct-type</span>.  If the type for <span class="RktVar">struct-type</span>
+is not controlled by the current inspector, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._object-name))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValDef RktValLink" data-pltdoc="x">object-name</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a value for the name of <span class="RktVar">v</span> if <span class="RktVar">v</span> has a name,
+<span class="RktVal">#f</span> otherwise. The argument <span class="RktVar">v</span> can be any value, but
+only (some) procedures, <a href="structures.html#%28tech._structure%29" class="techoutside" data-pltdoc="x"><span class="techinside">structures</span></a>, <a href="structures.html#%28tech._structure._type%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure types</span></a>,
+<a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type properties</span></a>, <a href="regexp.html#%28tech._regexp._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp values</span></a>,
+<a href="ports.html#%28tech._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">ports</span></a>, <a href="logging.html#%28tech._logger%29" class="techoutside" data-pltdoc="x"><span class="techinside">loggers</span></a>, and <a href="eval-model.html#%28tech._prompt._tag%29" class="techoutside" data-pltdoc="x"><span class="techinside">prompt tags</span></a> have names.
+See also <a href="syntax-model.html#%28part._infernames%29" data-pltdoc="x">Inferred Value Names</a>.</div></p><p>If a <a href="structures.html#%28tech._structure%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure</span></a>&rsquo;s type implements the <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._prop~3aobject-name%29%29" class="RktValLink" data-pltdoc="x">prop:object-name</a></span> property,
+and the value of the <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._prop~3aobject-name%29%29" class="RktValLink" data-pltdoc="x">prop:object-name</a></span> property is an integer, then the
+corresponding field of the structure is the name of the structure.
+Otherwise, the property value must be a procedure, which is called with the
+structure as argument, and the result is the name of the structure.
+If a <a href="structures.html#%28tech._structure%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure</span></a> is a procedure as implemented by one of its
+fields (i.e., the <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="RktValLink" data-pltdoc="x">prop:procedure</a></span> property value for the structure&rsquo;s
+type is an integer), then its name is the implementing procedure&rsquo;s name.
+Otherwise, its name matches the name of the <a href="structures.html#%28tech._structure._type%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type</span></a> that it
+instantiates.</p><p>The name (if any) of a procedure is a symbol, unless the procedure is
+also a structure whose type has the <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._prop~3aobject-name%29%29" class="RktValLink" data-pltdoc="x">prop:object-name</a></span>
+property, in which case <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._prop~3aobject-name%29%29" class="RktValLink" data-pltdoc="x">prop:object-name</a></span> takes precedence.
+The <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-rename%29%29" class="RktValLink" data-pltdoc="x">procedure-rename</a></span> function creates a procedure with a
+specific name.</p><p>The name of a <a href="regexp.html#%28tech._regexp._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp value</span></a> is a string or byte string. Passing
+the string or byte string to <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="RktValLink" data-pltdoc="x">regexp</a></span>, <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp%29%29" class="RktValLink" data-pltdoc="x">byte-regexp</a></span>,
+<span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._pregexp%29%29" class="RktValLink" data-pltdoc="x">pregexp</a></span>, or <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-pregexp%29%29" class="RktValLink" data-pltdoc="x">byte-pregexp</a></span> (depending on the kind of
+regexp whose name was extracted) produces a value that matches the
+same inputs.</p><p>The name of a port can be any value, but many tools use a path or
+string name as the port&rsquo;s for (to report source locations, for
+example).</p><p>The name of a <a href="logging.html#%28tech._logger%29" class="techoutside" data-pltdoc="x"><span class="techinside">logger</span></a> is either a symbol or <span class="RktVal">#f</span>.</p><p>The name of a <a href="eval-model.html#%28tech._prompt._tag%29" class="techoutside" data-pltdoc="x"><span class="techinside">prompt tag</span></a> is either the optional symbol
+given to <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._make-continuation-prompt-tag%29%29" class="RktValLink" data-pltdoc="x">make-continuation-prompt-tag</a></span> or <span class="RktVal">#f</span>.</p><p class="SHistory">Changed in version 7.9.0.13 of package <span class="stt">base</span>: Recognize the name of
+continuation prompt tags.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._prop~3aobject-name))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._prop~3aobject-name%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:object-name</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property</span></a> that allows structure types to customize
+ the result of <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span> applied to their instances. The property value can
+ be any of the following:</div></p><ul><li><p>A procedure <span class="RktVar">proc</span> of one argument: In this case,
+procedure <span class="RktVar">proc</span> receives the structure as an argument, and the result
+of <span class="RktVar">proc</span> is the <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span> of the structure.</p></li><li><p>An exact, non-negative integer between <span class="RktVal">0</span> (inclusive) and the
+number of non-automatic fields in the structure type (exclusive, not counting
+supertype fields): The integer identifies a field in the structure, and the
+field must be designated as immutable. The value of the field is used as the
+<span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span> of the structure.</p></li></ul><p class="SHistory">Added in version 6.2 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="threadgroups.html" title="backward to &quot;14.8 Thread Groups&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="modprotect.html" title="forward to &quot;14.10 Code Inspectors&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/interaction-info.html b/clones/docs.racket-lang.org/reference/interaction-info.html
new file mode 100644
index 00000000..30754c05
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/interaction-info.html
@@ -0,0 +1,16 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>18.4&nbsp;Interaction Configuration</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewselflink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">18.1&nbsp;</td><td><a href="running-sa.html" class="tocviewlink" data-pltdoc="x">Running Racket or GRacket</a></td></tr><tr><td align="right">18.2&nbsp;</td><td><a href="collects.html" class="tocviewlink" data-pltdoc="x">Libraries and Collections</a></td></tr><tr><td align="right">18.3&nbsp;</td><td><a href="Interactive_Help.html" class="tocviewlink" data-pltdoc="x">Interactive Help</a></td></tr><tr><td align="right">18.4&nbsp;</td><td><a href="interaction-info.html" class="tocviewselflink" data-pltdoc="x">Interaction Configuration</a></td></tr><tr><td align="right">18.5&nbsp;</td><td><a href="interactive.html" class="tocviewlink" data-pltdoc="x">Interactive Module Loading</a></td></tr><tr><td align="right">18.6&nbsp;</td><td><a href="debugging.html" class="tocviewlink" data-pltdoc="x">Debugging</a></td></tr><tr><td align="right">18.7&nbsp;</td><td><a href="compiler.html" class="tocviewlink" data-pltdoc="x">Controlling and Inspecting Compilation</a></td></tr><tr><td align="right">18.8&nbsp;</td><td><a href="Kernel_Forms_and_Functions.html" class="tocviewlink" data-pltdoc="x">Kernel Forms and Functions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="interaction-info.html#%28def._%28%28lib._racket%2Finteraction-info..rkt%29._current-interaction-info%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym">current-<wbr></wbr>interaction-<wbr></wbr>info</span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Interactive_Help.html" title="backward to &quot;18.3 Interactive Help&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;18 Running Racket&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="interactive.html" title="forward to &quot;18.5 Interactive Module Loading&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;interaction-info&quot;">18.4<tt>&nbsp;</tt><a name="(part._interaction-info)"></a><a name="(mod-path._racket/interaction-info)"></a>Interaction Configuration</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="interaction-info.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/interaction-info</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="interaction-info.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/interaction-info</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p>The <a href="interaction-info.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/interaction-info</span></a> library provides a way to
+register a langauge&rsquo;s configuration for a
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>-<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span>-<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> loop and editor.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/interaction-info..rkt)._current-interaction-info))"></a><span title="Provided from: racket/interaction-info | Package: base"><span class="RktSym"><span class="RktSymDef RktSym">current-interaction-info</span></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector%2Fc%29%29" class="RktValLink" data-pltdoc="x">vector/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/interaction-info | Package: base"><span class="RktSym"><span class="RktSymDef RktSym">current-interaction-info</span></span></span><span class="hspace">&nbsp;</span><span class="RktVar">info</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">info</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector%2Fc%29%29" class="RktValLink" data-pltdoc="x">vector/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that provides configuration for a language for use
+by interactive development tools, such as a command-line evaluation
+prompt with syntax coloring and indentation support. This parameter is
+typically set by a <span class="RktSym">configure-runtime</span> module; see also
+<a href="running-sa.html#%28part._configure-runtime%29" data-pltdoc="x">Language Run-Time Configuration</a>.</div></p><p>Instead of providing configuration information directly, the the
+<span class="RktSym">current-interaction-info</span> parameter specifies a module to
+load, a exported function to call, and data to pass as an argument to
+the exported function. The result of that function should be another
+one that accepts two arguments: a symbol a symbol indicating the kind
+of information requested (as defined by external tools), and a default
+value that normally should be returned if the symbol is not
+recognized.</p><p>For information on defining a new <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a> language, see
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=reader-helpers.html%23%2528mod-path._syntax%252Fmodule-reader%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">syntax/module-reader</span></a>.</p><p class="SHistory">Added in version 8.3.0.2 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Interactive_Help.html" title="backward to &quot;18.3 Interactive Help&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;18 Running Racket&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="interactive.html" title="forward to &quot;18.5 Interactive Module Loading&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/interactive.html b/clones/docs.racket-lang.org/reference/interactive.html
new file mode 100644
index 00000000..3041a5d8
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/interactive.html
@@ -0,0 +1,38 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>18.5&nbsp;Interactive Module Loading</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewselflink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">18.1&nbsp;</td><td><a href="running-sa.html" class="tocviewlink" data-pltdoc="x">Running Racket or GRacket</a></td></tr><tr><td align="right">18.2&nbsp;</td><td><a href="collects.html" class="tocviewlink" data-pltdoc="x">Libraries and Collections</a></td></tr><tr><td align="right">18.3&nbsp;</td><td><a href="Interactive_Help.html" class="tocviewlink" data-pltdoc="x">Interactive Help</a></td></tr><tr><td align="right">18.4&nbsp;</td><td><a href="interaction-info.html" class="tocviewlink" data-pltdoc="x">Interaction Configuration</a></td></tr><tr><td align="right">18.5&nbsp;</td><td><a href="interactive.html" class="tocviewselflink" data-pltdoc="x">Interactive Module Loading</a></td></tr><tr><td align="right">18.6&nbsp;</td><td><a href="debugging.html" class="tocviewlink" data-pltdoc="x">Debugging</a></td></tr><tr><td align="right">18.7&nbsp;</td><td><a href="compiler.html" class="tocviewlink" data-pltdoc="x">Controlling and Inspecting Compilation</a></td></tr><tr><td align="right">18.8&nbsp;</td><td><a href="Kernel_Forms_and_Functions.html" class="tocviewlink" data-pltdoc="x">Kernel Forms and Functions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>18.5&nbsp;</td><td><a href="interactive.html" class="tocviewselflink" data-pltdoc="x">Interactive Module Loading</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">18.5.1&nbsp;</td><td><a href="interactive.html#%28part._enter%29" class="tocviewlink" data-pltdoc="x">Entering Modules</a></td></tr><tr><td align="right">18.5.2&nbsp;</td><td><a href="interactive.html#%28part._rerequire%29" class="tocviewlink" data-pltdoc="x">Loading and Reloading Modules</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">18.5.1<tt>&nbsp;</tt></span><a href="interactive.html#%28part._enter%29" class="tocsubseclink" data-pltdoc="x">Entering Modules</a></td></tr><tr><td><a href="interactive.html#%28form._%28%28lib._racket%2Fenter..rkt%29._enter%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">enter!</span></span></a></td></tr><tr><td><a href="interactive.html#%28def._%28%28lib._racket%2Fenter..rkt%29._dynamic-enter%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-<wbr></wbr>enter!</span></span></a></td></tr><tr><td><span class="tocsublinknumber">18.5.2<tt>&nbsp;</tt></span><a href="interactive.html#%28part._rerequire%29" class="tocsubseclink" data-pltdoc="x">Loading and Reloading Modules</a></td></tr><tr><td><a href="interactive.html#%28def._%28%28lib._racket%2Frerequire..rkt%29._dynamic-rerequire%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-<wbr></wbr>rerequire</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="interaction-info.html" title="backward to &quot;18.4 Interaction Configuration&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;18 Running Racket&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="debugging.html" title="forward to &quot;18.6 Debugging&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;interactive&quot;">18.5<tt>&nbsp;</tt><a name="(part._interactive)"></a>Interactive Module Loading</h4><p>The <a href="interactive.html#%28mod-path._racket%2Frerequire%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/rerequire</span></a> and <a href="interactive.html#%28mod-path._racket%2Fenter%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/enter</span></a>
+libraries provide support for loading, reloading, and using modules.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;enter&quot;">18.5.1<tt>&nbsp;</tt><a name="(part._enter)"></a><a name="(mod-path._racket/enter)"></a>Entering Modules</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="interactive.html#%28mod-path._racket%2Fenter%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/enter</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="interactive.html#%28mod-path._racket%2Fenter%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/enter</span></a> and <a href="running-sa.html#%28mod-path._racket%2Finit%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/init</span></a> libraries, which means that they are available when  the Racket executable is started with no command-line arguments. They are not provided by <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/enter..rkt)._enter!))"></a><span title="Provided from: racket/enter, racket/init | Package: base"><span class="RktSym"><a href="interactive.html#%28form._%28%28lib._racket%2Fenter..rkt%29._enter%21%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">enter!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="interactive.html#%28form._%28%28lib._racket%2Fenter..rkt%29._enter%21%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">enter!</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="interactive.html#%28form._%28%28lib._racket%2Fenter..rkt%29._enter%21%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">enter!</a></span><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span><span class="hspace">&nbsp;</span><span class="RktVar">flag</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">flag</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:quiet</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:verbose-reload</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:verbose</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:dont-re-require-enter</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Intended for use in a <a href="eval.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>, such as when <span class="stt">racket</span> is
+started in interactive mode. When a <span class="RktVar">module-path</span> is provided
+(in the same sense as for <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>), the corresponding module
+is loaded or invoked via <span class="RktSym"><a href="interactive.html#%28def._%28%28lib._racket%2Frerequire..rkt%29._dynamic-rerequire%29%29" class="RktValLink" data-pltdoc="x">dynamic-rerequire</a></span>, and the current <a href="syntax-model.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespace</span></a> is changed to
+the body of the module via <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._module-~3enamespace%29%29" class="RktValLink" data-pltdoc="x">module-&gt;namespace</a></span>. When
+<span class="RktVal">#f</span> is provided, then the current <a href="syntax-model.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespace</span></a> is restored
+to the original one.</div></p><p><div class="SIntrapara">Additional <span class="RktVar">flag</span>s can customize aspects of <span class="RktSym"><a href="interactive.html#%28form._%28%28lib._racket%2Fenter..rkt%29._enter%21%29%29" class="RktStxLink" data-pltdoc="x">enter!</a></span>:
+</div><div class="SIntrapara"><ul><li><p>The <span class="RktPn">#:verbose</span>, <span class="RktPn">#:verbose-reload</span>, and
+<span class="RktPn">#:quiet</span> flags correspond to <span class="RktVal">'</span><span class="RktVal">all</span>,
+<span class="RktVal">'</span><span class="RktVal">reload</span>, and <span class="RktVal">'</span><span class="RktVal">none</span> verbosity for
+<span class="RktSym"><a href="interactive.html#%28def._%28%28lib._racket%2Frerequire..rkt%29._dynamic-rerequire%29%29" class="RktValLink" data-pltdoc="x">dynamic-rerequire</a></span>. The default corresponds to
+<span class="RktPn">#:verbose-reload</span>.</p></li><li><p>After switching namespaces to the designated module,
+<span class="RktSym"><a href="interactive.html#%28form._%28%28lib._racket%2Fenter..rkt%29._enter%21%29%29" class="RktStxLink" data-pltdoc="x">enter!</a></span> automatically requires <span class="RktSym">racket/enter</span> into the
+namespace, so that <span class="RktSym"><a href="interactive.html#%28form._%28%28lib._racket%2Fenter..rkt%29._enter%21%29%29" class="RktStxLink" data-pltdoc="x">enter!</a></span> can be used to switch namespaces
+again.  In some cases, requiring <span class="RktSym">racket/enter</span>
+might not be desirable (e.g., in a tool
+that uses <span class="RktSym">racket/enter</span>); use the
+<span class="RktPn">#:dont-re-require-enter</span> flag to disable the require.</p></li></ul></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/enter..rkt)._dynamic-enter!))"></a><span title="Provided from: racket/enter, racket/init | Package: base"><span class="RktSym"><a href="interactive.html#%28def._%28%28lib._racket%2Fenter..rkt%29._dynamic-enter%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">dynamic-enter!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">mod</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:verbosity</span><span class="hspace">&nbsp;</span><span class="RktVar">verbosity</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:re-require-enter?</span><span class="hspace">&nbsp;</span><span class="RktVar">re-require-enter?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mod</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">verbosity</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">all</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">reload</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">none</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">reload</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">re-require-enter?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Procedure variant of <span class="RktSym"><a href="interactive.html#%28form._%28%28lib._racket%2Fenter..rkt%29._enter%21%29%29" class="RktStxLink" data-pltdoc="x">enter!</a></span>, where <span class="RktVar">verbosity</span> is
+passed along to <span class="RktSym"><a href="interactive.html#%28def._%28%28lib._racket%2Frerequire..rkt%29._dynamic-rerequire%29%29" class="RktValLink" data-pltdoc="x">dynamic-rerequire</a></span> and
+<span class="RktVar">re-require-enter?</span>  determines whether <span class="RktSym"><a href="interactive.html#%28def._%28%28lib._racket%2Fenter..rkt%29._dynamic-enter%21%29%29" class="RktValLink" data-pltdoc="x">dynamic-enter!</a></span>
+requires <span class="RktSym">racket/enter</span> in a newly entered namespace.</div></p><p class="SHistory">Added in version 6.0.0.1 of package <span class="stt">base</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;rerequire&quot;">18.5.2<tt>&nbsp;</tt><a name="(part._rerequire)"></a><a name="(mod-path._racket/rerequire)"></a>Loading and Reloading Modules</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="interactive.html#%28mod-path._racket%2Frerequire%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/rerequire</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="interactive.html#%28mod-path._racket%2Frerequire%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/rerequire</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/rerequire..rkt)._dynamic-rerequire))"></a><span title="Provided from: racket/rerequire | Package: base"><span class="RktSym"><a href="interactive.html#%28def._%28%28lib._racket%2Frerequire..rkt%29._dynamic-rerequire%29%29" class="RktValDef RktValLink" data-pltdoc="x">dynamic-rerequire</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">module-path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:verbosity</span><span class="hspace">&nbsp;</span><span class="RktVar">verbosity</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">module-path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">verbosity</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">all</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">reload</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">none</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">reload</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span><span class="stt"> </span><span class="RktVar">module-path</span><span class="stt"> </span><span class="RktVal">0</span><span class="RktPn">)</span>, but with reloading
+support. The <span class="RktSym"><a href="interactive.html#%28def._%28%28lib._racket%2Frerequire..rkt%29._dynamic-rerequire%29%29" class="RktValLink" data-pltdoc="x">dynamic-rerequire</a></span> function is intended for use
+in an interactive environment, especially via <span class="RktSym">enter!</span>.</div></p><p>If invoking <span class="RktVar">module-path</span> requires loading any files, then
+modification dates of the files are recorded. If the file is modified,
+then a later <span class="RktSym"><a href="interactive.html#%28def._%28%28lib._racket%2Frerequire..rkt%29._dynamic-rerequire%29%29" class="RktValLink" data-pltdoc="x">dynamic-rerequire</a></span> re-loads the module from source; see also
+<a href="eval-model.html#%28part._module-redeclare%29" data-pltdoc="x">Module Redeclarations</a>. Similarly if a later <span class="RktSym"><a href="interactive.html#%28def._%28%28lib._racket%2Frerequire..rkt%29._dynamic-rerequire%29%29" class="RktValLink" data-pltdoc="x">dynamic-rerequire</a></span>
+transitively <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s a modified module, then the required
+module is re-loaded. Re-loading support works only for modules that
+are first loaded (either directly or indirectly through transitive
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s) via <span class="RktSym"><a href="interactive.html#%28def._%28%28lib._racket%2Frerequire..rkt%29._dynamic-rerequire%29%29" class="RktValLink" data-pltdoc="x">dynamic-rerequire</a></span>.</p><p>The returned list contains the absolute paths to the modules that were
+reloaded on this call to <span class="RktSym"><a href="interactive.html#%28def._%28%28lib._racket%2Frerequire..rkt%29._dynamic-rerequire%29%29" class="RktValLink" data-pltdoc="x">dynamic-rerequire</a></span>. If the returned
+list is empty, no modules were changed or loaded.</p><p>When <span class="RktSym">enter!</span> loads or re-loads a module from a file, it can
+print a message to <span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-error-port%29%29" class="RktValLink" data-pltdoc="x">current-error-port</a></span><span class="RktPn">)</span>, depending on
+<span class="RktVar">verbosity</span>: <span class="RktVal">'</span><span class="RktVal">all</span> prints a message for all loads and
+re-loads, <span class="RktVal">'</span><span class="RktVal">reload</span> prints a message only for
+re-loaded modules, and <span class="RktVal">'</span><span class="RktVal">none</span> disables printouts.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="interaction-info.html" title="backward to &quot;18.4 Interaction Configuration&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;18 Running Racket&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="debugging.html" title="forward to &quot;18.6 Debugging&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/invokingunits.html b/clones/docs.racket-lang.org/reference/invokingunits.html
new file mode 100644
index 00000000..56b5ceec
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/invokingunits.html
@@ -0,0 +1,26 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7.2&nbsp;Invoking Units</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="creatingunits.html" class="tocviewlink" data-pltdoc="x">Creating Units</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="invokingunits.html" class="tocviewselflink" data-pltdoc="x">Invoking Units</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="compoundunits.html" class="tocviewlink" data-pltdoc="x">Linking Units and Creating Compound Units</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="linkinference.html" class="tocviewlink" data-pltdoc="x">Inferred Linking</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="Generating_A_Unit_from_Context.html" class="tocviewlink" data-pltdoc="x">Generating A Unit from Context</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="Structural_Matching.html" class="tocviewlink" data-pltdoc="x">Structural Matching</a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="define-sig-form.html" class="tocviewlink" data-pltdoc="x">Extending the Syntax of Signatures</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Unit_Utilities.html" class="tocviewlink" data-pltdoc="x">Unit Utilities</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="unitcontracts.html" class="tocviewlink" data-pltdoc="x">Unit Contracts</a></td></tr><tr><td align="right">7.10&nbsp;</td><td><a href="single-unit.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Unit Modules</a></td></tr><tr><td align="right">7.11&nbsp;</td><td><a href="Single-Signature_Modules.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Signature Modules</a></td></tr><tr><td align="right">7.12&nbsp;</td><td><a href="Transformer_Helpers.html" class="tocviewlink" data-pltdoc="x">Transformer Helpers</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="invokingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._invoke-unit%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">invoke-<wbr></wbr>unit</span></span></a></td></tr><tr><td><a href="invokingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-values%2Finvoke-unit%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>values/<span class="mywbr"> &nbsp;</span>invoke-<wbr></wbr>unit</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="creatingunits.html" title="backward to &quot;7.1 Creating Units&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="compoundunits.html" title="forward to &quot;7.3 Linking Units and Creating Compound Units&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;invokingunits&quot;">7.2<tt>&nbsp;</tt><a name="(part._invokingunits)"></a>Invoking Units</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._invoke-unit))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="invokingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._invoke-unit%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">invoke-unit</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">unit-expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="invokingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._invoke-unit%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">invoke-unit</a></span><span class="hspace">&nbsp;</span><span class="RktVar">unit-expr</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Invokes the unit produced by <span class="RktVar">unit-expr</span>. For each of the
+unit&rsquo;s imports, the <span class="RktSym"><a href="invokingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._invoke-unit%29%29" class="RktStxLink" data-pltdoc="x">invoke-unit</a></span> expression must contain a
+<span class="RktVar">tagged-sig-spec</span> in the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span> clause; see
+<span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span> for the grammar of <span class="RktVar">tagged-sig-spec</span>. If the unit
+has no imports, the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span> clause can be omitted.</div></p><p>When no <span class="RktVar">tagged-sig-spec</span>s are provided, <span class="RktVar">unit-expr</span>
+must produce a unit that expects no imports. To invoke the unit, all
+bindings are first initialized to the <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;undefined&gt;</span></span></a> value. Next,
+the unit&rsquo;s body definitions and expressions are evaluated in order; in
+the case of a definition, evaluation sets the value of the
+corresponding variable(s). Finally, the result of the last expression
+in the unit is the result of the <span class="RktSym"><a href="invokingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._invoke-unit%29%29" class="RktStxLink" data-pltdoc="x">invoke-unit</a></span> expression.</p><p>Each supplied <span class="RktVar">tagged-sig-spec</span> takes bindings from the
+surrounding context and turns them into imports for the invoked unit.
+The unit need not declare an import for every provided
+<span class="RktVar">tagged-sig-spec</span>, but one <span class="RktVar">tagged-sig-spec</span> must be
+provided for each declared import of the unit. For each variable
+identifier in each provided <span class="RktVar">tagged-sig-spec</span>, the value of the
+identifier&rsquo;s binding in the surrounding context is used for the
+corresponding import in the invoked unit.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._define-values/invoke-unit))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="invokingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-values%2Finvoke-unit%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-values/invoke-unit</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">unit-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="invokingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._invoke-unit%29%29" class="RktStxLink" data-pltdoc="x">invoke-unit</a></span>, but the values of the unit&rsquo;s exports are
+copied to new bindings.</div></p><p>The unit produced by <span class="RktVar">unit-expr</span> is linked and invoked as for
+<span class="RktSym"><a href="invokingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._invoke-unit%29%29" class="RktStxLink" data-pltdoc="x">invoke-unit</a></span>. In addition, the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span> clause is
+treated as a kind of import into the local definition context. That
+is, for every binding that would be available in a unit that used the
+<span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span> clause&rsquo;s <span class="RktVar">tagged-sig-spec</span> as an import, a
+definition is generated for the context of the
+<span class="RktSym"><a href="invokingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-values%2Finvoke-unit%29%29" class="RktStxLink" data-pltdoc="x">define-values/invoke-unit</a></span> form.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="creatingunits.html" title="backward to &quot;7.1 Creating Units&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="compoundunits.html" title="forward to &quot;7.3 Linking Units and Creating Compound Units&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/ivaraccess.html b/clones/docs.racket-lang.org/reference/ivaraccess.html
new file mode 100644
index 00000000..52e8ce56
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/ivaraccess.html
@@ -0,0 +1,69 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6.4&nbsp;Field and Method Access</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewselflink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="createinterface.html" class="tocviewlink" data-pltdoc="x">Creating Interfaces</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="createclass.html" class="tocviewlink" data-pltdoc="x">Creating Classes</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="objcreation.html" class="tocviewlink" data-pltdoc="x">Creating Objects</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="ivaraccess.html" class="tocviewselflink" data-pltdoc="x">Field and Method Access</a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="mixins.html" class="tocviewlink" data-pltdoc="x">Mixins</a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="trait.html" class="tocviewlink" data-pltdoc="x">Traits</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="Object_and_Class_Contracts.html" class="tocviewlink" data-pltdoc="x">Object and Class Contracts</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="objectequality.html" class="tocviewlink" data-pltdoc="x">Object Equality and Hashing</a></td></tr><tr><td align="right">6.9&nbsp;</td><td><a href="objectserialize.html" class="tocviewlink" data-pltdoc="x">Object Serialization</a></td></tr><tr><td align="right">6.10&nbsp;</td><td><a href="objectprinting.html" class="tocviewlink" data-pltdoc="x">Object Printing</a></td></tr><tr><td align="right">6.11&nbsp;</td><td><a href="objectutils.html" class="tocviewlink" data-pltdoc="x">Object, Class, and Interface Utilities</a></td></tr><tr><td align="right">6.12&nbsp;</td><td><a href="Surrogates.html" class="tocviewlink" data-pltdoc="x">Surrogates</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>6.4&nbsp;</td><td><a href="ivaraccess.html" class="tocviewselflink" data-pltdoc="x">Field and Method Access</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.4.1&nbsp;</td><td><a href="ivaraccess.html#%28part._methodcalls%29" class="tocviewlink" data-pltdoc="x">Methods</a></td></tr><tr><td align="right">6.4.2&nbsp;</td><td><a href="ivaraccess.html#%28part._.Fields%29" class="tocviewlink" data-pltdoc="x">Fields</a></td></tr><tr><td align="right">6.4.3&nbsp;</td><td><a href="ivaraccess.html#%28part._.Generics%29" class="tocviewlink" data-pltdoc="x">Generics</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">6.4.1<tt>&nbsp;</tt></span><a href="ivaraccess.html#%28part._methodcalls%29" class="tocsubseclink" data-pltdoc="x">Methods</a></td></tr><tr><td><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">send</span></span></a></td></tr><tr><td><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%2Fapply%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">send/<span class="mywbr"> &nbsp;</span>apply</span></span></a></td></tr><tr><td><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%2Fkeyword-apply%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">send/<span class="mywbr"> &nbsp;</span>keyword-<wbr></wbr>apply</span></span></a></td></tr><tr><td><a href="ivaraccess.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._dynamic-send%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-<wbr></wbr>send</span></span></a></td></tr><tr><td><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">send*</span></span></a></td></tr><tr><td><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%2B%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">send+</span></span></a></td></tr><tr><td><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._with-method%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>method</span></span></a></td></tr><tr><td><span class="tocsublinknumber">6.4.2<tt>&nbsp;</tt></span><a href="ivaraccess.html#%28part._.Fields%29" class="tocsubseclink" data-pltdoc="x">Fields</a></td></tr><tr><td><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._get-field%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">get-<wbr></wbr>field</span></span></a></td></tr><tr><td><a href="ivaraccess.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._dynamic-get-field%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-<wbr></wbr>get-<wbr></wbr>field</span></span></a></td></tr><tr><td><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._set-field%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">set-<wbr></wbr>field!</span></span></a></td></tr><tr><td><a href="ivaraccess.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._dynamic-set-field%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-<wbr></wbr>set-<wbr></wbr>field!</span></span></a></td></tr><tr><td><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field-bound~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">field-<wbr></wbr>bound?</span></span></a></td></tr><tr><td><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-field-accessor%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">class-<wbr></wbr>field-<wbr></wbr>accessor</span></span></a></td></tr><tr><td><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-field-mutator%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">class-<wbr></wbr>field-<wbr></wbr>mutator</span></span></a></td></tr><tr><td><span class="tocsublinknumber">6.4.3<tt>&nbsp;</tt></span><a href="ivaraccess.html#%28part._.Generics%29" class="tocsubseclink" data-pltdoc="x">Generics</a></td></tr><tr><td><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._generic%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">generic</span></span></a></td></tr><tr><td><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send-generic%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">send-<wbr></wbr>generic</span></span></a></td></tr><tr><td><a href="ivaraccess.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._make-generic%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>generic</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="objcreation.html" title="backward to &quot;6.3 Creating Objects&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="mixins.html" title="forward to &quot;6.5 Mixins&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;ivaraccess&quot;">6.4<tt>&nbsp;</tt><a name="(part._ivaraccess)"></a>Field and Method Access</h4><p>In expressions within a class definition, the initialization
+variables, fields, and methods of the class are all part of the
+environment. Within a method body, only the fields and other methods
+of the class can be referenced; a reference to any other
+class-introduced identifier is a syntax error.  Elsewhere within the
+class, all class-introduced identifiers are available, and fields and
+initialization variables can be mutated with <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;methodcalls&quot;">6.4.1<tt>&nbsp;</tt><a name="(part._methodcalls)"></a>Methods</h5><p>Method names used within a class can only be used in the procedure position
+of an application expression; any other use is a syntax error.</p><p>To allow methods to be applied to lists of arguments, a method
+application can have the following form:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktVar">method-id</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">arg-list-expr</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>This form calls the method in a way analogous to <span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span><span class="stt"> </span><span class="RktVar">method-id</span><span class="stt"> </span><span class="RktVar">arg</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktVar">arg-list-expr</span><span class="RktPn">)</span>. The <span class="RktSym">arg-list-expr</span>
+must not be a parenthesized expression.</p><p>Methods are called from outside a class with the <span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span>,
+<span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%2Fapply%29%29" class="RktStxLink" data-pltdoc="x">send/apply</a></span>, and <span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%2Fkeyword-apply%29%29" class="RktStxLink" data-pltdoc="x">send/keyword-apply</a></span> forms.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._send))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">send</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">obj-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">method-id</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktVar">obj-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">method-id</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">arg-list-expr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Evaluates <span class="RktVar">obj-expr</span> to obtain an object, and calls the method
+with (external) name <span class="RktVar">method-id</span> on the object, providing the
+<span class="RktVar">arg</span> results as arguments. Each <span class="RktVar">arg</span> is as for
+<span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25app%29%29" class="RktStxLink" data-pltdoc="x">#%app</a></span>: either <span class="RktVar">arg-expr</span> or <span class="RktVar">keyword</span><span class="stt"> </span><span class="RktVar">arg-expr</span>. In the second form, <span class="RktVar">arg-list-expr</span> cannot be a
+parenthesized expression.</div></p><p>If <span class="RktVar">obj-expr</span> does not produce an object, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. If the object has no public method named
+<span class="RktVar">method-id</span>, the <span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._send/apply))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%2Fapply%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">send/apply</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">obj-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">method-id</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">arg-list-expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like the dotted form of <span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span>, but <span class="RktVar">arg-list-expr</span> can
+be any expression.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._send/keyword-apply))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%2Fkeyword-apply%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">send/keyword-apply</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">obj-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">method-id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">keyword-list-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">value-list-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">arg-list-expr</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%2Fapply%29%29" class="RktStxLink" data-pltdoc="x">send/apply</a></span>, but with expressions for keyword and
+argument lists like <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._keyword-apply%29%29" class="RktValLink" data-pltdoc="x">keyword-apply</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._dynamic-send))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="ivaraccess.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._dynamic-send%29%29" class="RktValDef RktValLink" data-pltdoc="x">dynamic-send</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">obj</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">method-name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:&lt;kw&gt;</span><span class="hspace">&nbsp;</span><span class="RktVar">kw-arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">obj</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3f%29%29" class="RktValLink" data-pltdoc="x">object?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">method-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">kw-arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Calls the method on <span class="RktVar">obj</span> whose name matches
+<span class="RktVar">method-name</span>, passing along all given <span class="RktVar">v</span>s and
+<span class="RktVar">kw-arg</span>s.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._send*))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">send*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">obj-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">msg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">msg</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">method-id</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">method-id</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">arg-list-expr</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Calls multiple methods (in order) of the same object. Each
+<span class="RktVar">msg</span> corresponds to a use of <span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span>.</div></p><p>For example,</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%2A%29%29" class="RktStxLink" data-pltdoc="x">send*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">edit</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">begin-edit-sequence</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">insert</span><span class="hspace">&nbsp;</span><span class="RktVal">"Hello"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">insert</span><span class="hspace">&nbsp;</span><span class="RktVal">#\newline</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">end-edit-sequence</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>is the same as</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">o</span><span class="hspace">&nbsp;</span><span class="RktSym">edit</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="hspace">&nbsp;</span><span class="RktSym">begin-edit-sequence</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="hspace">&nbsp;</span><span class="RktSym">insert</span><span class="hspace">&nbsp;</span><span class="RktVal">"Hello"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="hspace">&nbsp;</span><span class="RktSym">insert</span><span class="hspace">&nbsp;</span><span class="RktVal">#\newline</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="hspace">&nbsp;</span><span class="RktSym">end-edit-sequence</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._send+))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%2B%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">send+</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">obj-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">msg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">msg</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">method-id</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">method-id</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">arg-list-expr</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Calls methods (in order) starting with the object produced by
+<span class="RktVar">obj-expr</span>. Each method call will be invoked on the result of
+the last method call, which is expected to be an object. Each
+<span class="RktVar">msg</span> corresponds to a use of <span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span>.</div></p><p>This is the functional analogue of <span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%2A%29%29" class="RktStxLink" data-pltdoc="x">send*</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">point%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-field%29%29" class="RktStxLink" data-pltdoc="x">init-field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">move-x</span><span class="hspace">&nbsp;</span><span class="RktSym">dx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this~25%29%29" class="RktStxLink" data-pltdoc="x">this%</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">dx</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">move-y</span><span class="hspace">&nbsp;</span><span class="RktSym">dy</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this~25%29%29" class="RktStxLink" data-pltdoc="x">this%</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">dy</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%2B%29%29" class="RktStxLink" data-pltdoc="x">send+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">point%</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">move-x</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">move-y</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">move-x</span><span class="hspace">&nbsp;</span><span class="RktVal">12</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">(object:point% ...)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._with-method))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._with-method%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">with-method</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">obj-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">method-id</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Extracts methods from an object and binds a local name that can be
+applied directly (in the same way as declared methods within a class)
+for each method. Each <span class="RktVar">obj-expr</span> must produce an object,
+which must have a public method named by the corresponding
+<span class="RktVar">method-id</span>. The corresponding <span class="RktVar">id</span> is bound so that it
+can be applied directly (see <a href="ivaraccess.html#%28part._methodcalls%29" data-pltdoc="x">Methods</a>).</div></p><p>Example:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stack%</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._with-method%29%29" class="RktStxLink" data-pltdoc="x">with-method</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">push</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">push!</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">pop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">pop!</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">push</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">push</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">pop</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>is the same as</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stack%</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">push!</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">push!</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send%29%29" class="RktStxLink" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">pop!</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Fields&quot;">6.4.2<tt>&nbsp;</tt><a name="(part._.Fields)"></a>Fields</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._get-field))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._get-field%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">get-field</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">obj-expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Extracts the field with (external) name <span class="RktVar">id</span> from the value of
+<span class="RktVar">obj-expr</span>.</div></p><p>If <span class="RktVar">obj-expr</span> does not produce an object, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. If the object has no <span class="RktVar">id</span> field,
+the <span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._dynamic-get-field))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="ivaraccess.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._dynamic-get-field%29%29" class="RktValDef RktValLink" data-pltdoc="x">dynamic-get-field</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">field-name</span><span class="hspace">&nbsp;</span><span class="RktVar">obj</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">field-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">obj</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3f%29%29" class="RktValLink" data-pltdoc="x">object?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Extracts the field from <span class="RktVar">obj</span> with the (external) name that
+matches <span class="RktVar">field-name</span>. If the object has no field matching <span class="RktVar">field-name</span>,
+the <span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._set-field!))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._set-field%21%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">set-field!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">obj-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Sets the field with (external) name <span class="RktVar">id</span> from the value of
+<span class="RktVar">obj-expr</span> to the value of <span class="RktVar">expr</span>.</div></p><p>If <span class="RktVar">obj-expr</span> does not produce an object, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.  If the object has no <span class="RktVar">id</span> field,
+the <span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._dynamic-set-field!))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="ivaraccess.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._dynamic-set-field%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">dynamic-set-field!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">field-name</span><span class="hspace">&nbsp;</span><span class="RktVar">obj</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">field-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">obj</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3f%29%29" class="RktValLink" data-pltdoc="x">object?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Sets the field from <span class="RktVar">obj</span> with the (external) name that
+matches <span class="RktVar">field-name</span> to <span class="RktVar">v</span>. If the object has no field matching <span class="RktVar">field-name</span>,
+the <span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._field-bound~3f))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field-bound~3f%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">field-bound?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">obj-expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Produces <span class="RktVal">#t</span> if the object result of <span class="RktVar">obj-expr</span> has a
+field with (external) name <span class="RktVar">id</span>, <span class="RktVal">#f</span> otherwise.</div></p><p>If <span class="RktVar">obj-expr</span> does not produce an object, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._class-field-accessor))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-field-accessor%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">class-field-accessor</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">class-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">field-id</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns an accessor procedure that takes an instance of the class
+produced by <span class="RktVar">class-expr</span> and returns the value of the object&rsquo;s
+field with (external) name <span class="RktVar">field-id</span>.</div></p><p>If <span class="RktVar">class-expr</span> does not produce a class, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. If the class has no <span class="RktVar">field-id</span>
+field, the <span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._class-field-mutator))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-field-mutator%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">class-field-mutator</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">class-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">field-id</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns a mutator procedure that takes an instance of the class
+produced by <span class="RktVar">class-expr</span> and a value, and sets the value of the
+object&rsquo;s field with (external) name <span class="RktVar">field-id</span> to the given
+value. The result is <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</div></p><p>If <span class="RktVar">class-expr</span> does not produce a class, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. If the class has no <span class="RktVar">field-id</span>
+field, the <span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Generics&quot;">6.4.3<tt>&nbsp;</tt><a name="(part._.Generics)"></a>Generics</h5><p>A <a name="(tech._generic)"></a><span style="font-style: italic">generic</span> can be used instead of a method name to avoid the
+cost of relocating a method by name within a class.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._generic))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._generic%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">generic</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">class-or-interface-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Produces a generic that works on instances of the class or interface
+produced by <span class="RktVar">class-or-interface-expr</span> (or an instance of a
+class/interface derived from <span class="RktSym">class-or-interface</span>) to call the
+method with (external) name <span class="RktVar">id</span>.</div></p><p>If <span class="RktVar">class-or-interface-expr</span> does not produce a class or
+interface, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. If the resulting class or
+interface does not contain a method named <span class="RktVar">id</span>, the
+<span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._send-generic))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send-generic%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">send-generic</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">obj-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">generic-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._send-generic%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">send-generic</a></span><span class="hspace">&nbsp;</span><span class="RktVar">obj-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">generic-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">arg-list-expr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Calls a method of the object produced by <span class="RktVar">obj-expr</span> as
+indicated by the generic produced by <span class="RktVar">generic-expr</span>. Each
+<span class="RktVar">arg</span> is as for <span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25app%29%29" class="RktStxLink" data-pltdoc="x">#%app</a></span>: either <span class="RktVar">arg-expr</span> or
+<span class="RktVar">keyword</span><span class="stt"> </span><span class="RktVar">arg-expr</span>. The second form is analogous to calling a
+procedure with <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span>, where <span class="RktVar">arg-list-expr</span> is not a
+parenthesized expression.</div></p><p>If <span class="RktVar">obj-expr</span> does not produce an object, or if
+<span class="RktVar">generic-expr</span> does not produce a generic, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. If the result of <span class="RktVar">obj-expr</span> is
+not an instance of the class or interface encapsulated by the result
+of <span class="RktVar">generic-expr</span>, the <span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._make-generic))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="ivaraccess.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._make-generic%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-generic</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">type</span><span class="hspace">&nbsp;</span><span class="RktVar">method-name</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._generic~3f%29%29" class="RktValLink" data-pltdoc="x">generic?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">type</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface~3f%29%29" class="RktValLink" data-pltdoc="x">interface?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">method-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like the <span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._generic%29%29" class="RktStxLink" data-pltdoc="x">generic</a></span> form, but as a procedure that accepts a
+symbolic method name.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="objcreation.html" title="backward to &quot;6.3 Creating Objects&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="mixins.html" title="forward to &quot;6.5 Mixins&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/keywords.html b/clones/docs.racket-lang.org/reference/keywords.html
new file mode 100644
index 00000000..b34dfa0e
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/keywords.html
@@ -0,0 +1,18 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.9&nbsp;Keywords</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewselflink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.9&nbsp;</td><td><a href="keywords.html" class="tocviewselflink" data-pltdoc="x">Keywords</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.9.1&nbsp;</td><td><a href="keywords.html#%28part._.Additional_.Keyword_.Functions%29" class="tocviewlink" data-pltdoc="x">Additional Keyword Functions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">keyword?</span></span></a></td></tr><tr><td><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword-~3estring%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">keyword-<wbr></wbr>&gt;string</span></span></a></td></tr><tr><td><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._string-~3ekeyword%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>&gt;keyword</span></span></a></td></tr><tr><td><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3c~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">keyword&lt;?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.9.1<tt>&nbsp;</tt></span><a href="keywords.html#%28part._.Additional_.Keyword_.Functions%29" class="tocsubseclink" data-pltdoc="x">Additional Keyword Functions</a></td></tr><tr><td><a href="keywords.html#%28def._%28%28lib._racket%2Fkeyword..rkt%29._keyword-~3eimmutable-string%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">keyword-<wbr></wbr>&gt;immutable-<wbr></wbr>string</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="regexp.html" title="backward to &quot;4.8 Regular Expressions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="pairs.html" title="forward to &quot;4.10 Pairs and Lists&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;keywords&quot;">4.9<tt>&nbsp;</tt><a name="(part._keywords)"></a>Keywords</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=keywords.html&amp;version=8.6" class="Sq" data-pltdoc="x">Keywords</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces keywords.</p></blockquote></blockquote></blockquote><p>A <a name="(tech._keyword)"></a><span style="font-style: italic">keyword</span> is like an <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> symbol, but its printed
+form starts with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#:</span><span class="hspace"></span></span>, and a keyword cannot be used as an
+identifier. Furthermore, a keyword by itself is not a valid
+expression, though a keyword can be <span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span>d to form an
+expression that produces the symbol.</p><p>Two keywords are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> if and only if they print the same
+(i.e., keywords are always <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a>).</p><p>Like symbols, keywords are only weakly held by the internal keyword
+table; see <a href="symbols.html" data-pltdoc="x">Symbols</a> for more information.</p><p>See <a href="reader.html#%28part._parse-keyword%29" data-pltdoc="x">Reading Keywords</a>
+    for information on <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>ing
+    keywords and <a href="printing.html#%28part._print-keyword%29" data-pltdoc="x">Printing Keywords</a>
+    for information on <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>ing keywords.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._keyword~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">keyword?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a keyword, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#:apple</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">define</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#:define</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._keyword-~3estring))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword-~3estring%29%29" class="RktValDef RktValLink" data-pltdoc="x">keyword-&gt;string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">keyword</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a string for the <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>ed form of <span class="RktVar">keyword</span>,
+not including the leading <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#:</span><span class="hspace"></span></span>.</div></p><p>See also <span class="RktSym"><a href="keywords.html#%28def._%28%28lib._racket%2Fkeyword..rkt%29._keyword-~3eimmutable-string%29%29" class="RktValLink" data-pltdoc="x">keyword-&gt;immutable-string</a></span> from
+<a href="keywords.html#%28mod-path._racket%2Fkeyword%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/keyword</span></a>.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword-~3estring%29%29" class="RktValLink" data-pltdoc="x">keyword-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#:apple</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"apple"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-~3ekeyword))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._string-~3ekeyword%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-&gt;keyword</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a keyword whose <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>ed form is the same as that of
+<span class="RktVar">str</span>, but with a leading <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#:</span><span class="hspace"></span></span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._string-~3ekeyword%29%29" class="RktValLink" data-pltdoc="x">string-&gt;keyword</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#:apple</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._keyword~3c~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3c~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">keyword&lt;?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a-keyword</span><span class="hspace">&nbsp;</span><span class="RktVar">b-keyword</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a-keyword</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b-keyword</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if the arguments are sorted, where the comparison
+for each pair of keywords is the same as using
+<span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword-~3estring%29%29" class="RktValLink" data-pltdoc="x">keyword-&gt;string</a></span> with <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Futf-8%29%29" class="RktValLink" data-pltdoc="x">string-&gt;bytes/utf-8</a></span> and
+<span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3c~3f%29%29" class="RktValLink" data-pltdoc="x">bytes&lt;?</a></span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3c~3f%29%29" class="RktValLink" data-pltdoc="x">keyword&lt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#:apple</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#:banana</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Additional_Keyword_Functions&quot;">4.9.1<tt>&nbsp;</tt><a name="(part._.Additional_.Keyword_.Functions)"></a><a name="(mod-path._racket/keyword)"></a>Additional Keyword Functions</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="keywords.html#%28mod-path._racket%2Fkeyword%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/keyword</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="keywords.html#%28mod-path._racket%2Fkeyword%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/keyword</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p class="SHistory">Added in version 7.6 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/keyword..rkt)._keyword-~3eimmutable-string))"></a><span title="Provided from: racket/keyword, racket | Package: base"><span class="RktSym"><a href="keywords.html#%28def._%28%28lib._racket%2Fkeyword..rkt%29._keyword-~3eimmutable-string%29%29" class="RktValDef RktValLink" data-pltdoc="x">keyword-&gt;immutable-string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sym</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword-~3estring%29%29" class="RktValLink" data-pltdoc="x">keyword-&gt;string</a></span>, but the result is an immutable string,
+not necessarily freshly allocated.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="keywords.html#%28def._%28%28lib._racket%2Fkeyword..rkt%29._keyword-~3eimmutable-string%29%29" class="RktValLink" data-pltdoc="x">keyword-&gt;immutable-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#:apple</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"apple"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="keywords.html#%28def._%28%28lib._racket%2Fkeyword..rkt%29._keyword-~3eimmutable-string%29%29" class="RktValLink" data-pltdoc="x">keyword-&gt;immutable-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#:apple</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 7.6 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="regexp.html" title="backward to &quot;4.8 Regular Expressions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="pairs.html" title="forward to &quot;4.10 Pairs and Lists&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/lambda.html b/clones/docs.racket-lang.org/reference/lambda.html
new file mode 100644
index 00000000..fc57ab77
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/lambda.html
@@ -0,0 +1,94 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.8&nbsp;Procedure Expressions: lambda and case-lambda</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewselflink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">lambda</span></span></a></td></tr><tr><td><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">&#955;</span></span></a></td></tr><tr><td><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-lambda%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%plain-<wbr></wbr>lambda</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="application.html" title="backward to &quot;3.7 Procedure Applications and #%app&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="let.html" title="forward to &quot;3.9 Local Binding: let, let*, letrec, ...&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;lambda&quot;">3.8<tt>&nbsp;</tt><a name="(part._lambda)"></a>Procedure Expressions: <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span> and <span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span></h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=lambda.html&amp;version=8.6" class="Sq" data-pltdoc="x">Functions: <span class="RktSym"><span class="RktStxLink">lambda</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces procedure expressions.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._lambda))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">lambda</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">kw-formals</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._~ce~bb))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">&#955;</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">kw-formals</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">kw-formals</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">rest-id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">rest-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">arg</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">default-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">default-expr</span><span class="RktPn">]</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Produces a procedure. The <span class="RktVar">kw-formals</span> determines the number of
+arguments and which keyword arguments that the procedure accepts.</div></p><p>Considering only the first <span class="RktVar">arg</span> case, a simple
+<span class="RktVar">kw-formals</span> has one of the following three forms:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p> The procedure accepts as many non-keyword
+argument values as the number of <span class="RktVar">id</span>s. Each <span class="RktVar">id</span>
+is associated with an argument value by position.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">rest-id</span><span class="RktPn">)</span></td></tr></table></blockquote><p> The procedure accepts any number of
+non-keyword arguments greater or equal to the number of
+<span class="RktVar">id</span>s. When the procedure is applied, the <span class="RktVar">id</span>s
+are associated with argument values by position, and all
+leftover arguments are placed into a list that is associated to
+<span class="RktVar">rest-id</span>.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">rest-id</span></td></tr></table></blockquote><p> The procedure accepts any number of non-keyword
+arguments. All arguments are placed into a list that is
+associated with <span class="RktVar">rest-id</span>.</p></blockquote><p>More generally, an <span class="RktVar">arg</span> can include a keyword and/or default
+value. Thus, the first two cases above are more completely specified
+as follows:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p> Each <span class="RktVar">arg</span> has the following
+ four forms:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">id</span></td></tr></table></blockquote><p>Adds one to both the minimum and maximum
+number of non-keyword arguments accepted by the procedure. The
+<span class="RktVar">id</span> is associated with an actual argument by
+position.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">default-expr</span><span class="RktPn">]</span></td></tr></table></blockquote><p>Adds one to the maximum number
+of non-keyword arguments accepted by the procedure. The
+<span class="RktVar">id</span> is associated with an actual argument by position,
+and if no such argument is provided, the <span class="RktVar">default-expr</span>
+is evaluated to produce a value associated with <span class="RktVar">id</span>.
+No <span class="RktVar">arg</span> with a <span class="RktVar">default-expr</span> can appear
+before an <span class="RktVar">id</span> without a <span class="RktVar">default-expr</span> and
+without a <span class="RktVar">keyword</span>.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span></td></tr></table></blockquote><p>The procedure requires a
+keyword-based argument using <span class="RktVar">keyword</span>. The <span class="RktVar">id</span>
+is associated with a keyword-based actual argument using
+<span class="RktVar">keyword</span>.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">default-expr</span><span class="RktPn">]</span></td></tr></table></blockquote><p>The
+procedure accepts a keyword-based argument using <span class="RktVar">keyword</span>. The
+<span class="RktVar">id</span> is associated with a keyword-based actual argument
+using <span class="RktVar">keyword</span>, if supplied in an application;
+otherwise, the <span class="RktVar">default-expr</span> is evaluated to obtain a
+value to associate with <span class="RktVar">id</span>.</p></blockquote><p>The position of a <span class="RktVar">keyword</span> <span class="RktVar">arg</span> in
+<span class="RktVar">kw-formals</span> does not matter, but each specified
+<span class="RktVar">keyword</span> must be distinct.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">rest-id</span><span class="RktPn">)</span></td></tr></table></blockquote><p> Like the previous case, but
+the procedure accepts any number of non-keyword arguments
+beyond its minimum number of arguments. When more arguments are
+provided than non-<span class="RktVar">keyword</span> arguments among the
+<span class="RktVar">arg</span>s, the extra arguments are placed into a
+list that is associated to <span class="RktVar">rest-id</span>.</p></blockquote><p><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>In other words, argument bindings with
+default-value expressions are evaluated analogous to <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A%29%29" class="RktStxLink" data-pltdoc="x">let*</a></span>.</p></blockquote></blockquote></blockquote></div><div class="SIntrapara">The <span class="RktVar">kw-formals</span> identifiers are bound in the
+<span class="RktVar">body</span>s. When the procedure is applied, a new <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a>
+is created for each identifier, and the location is filled with the
+associated argument value. The <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">locations</span></a> are created and filled
+in order, with <span class="RktVar">default-expr</span>s evaluated as needed to fill
+locations.</div></p><p>If any identifier appears in the <span class="RktVar">body</span>s that is not one of the
+identifiers in <span class="RktVar">kw-formals</span>, then it refers to the same
+location that it would if it appeared in place of the <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span>
+expression. (In other words, variable reference is lexically scoped.)</p><p>When multiple identifiers appear in a <span class="RktVar">kw-formals</span>, they must
+be distinct according to <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._bound-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">bound-identifier=?</a></span>.</p><p>If the procedure produced by <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span> is applied to fewer or
+more by-position or by-keyword arguments than it accepts, to by-keyword arguments
+that it does not accept, or without required by-keyword arguments, then
+the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>The last <span class="RktVar">body</span> expression is in tail position with respect to
+the procedure body.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(2 1)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(2 1)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">#:arg</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">#:arg</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">#:arg</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'((2 1) (2 1))</span></p></td></tr></table></blockquote></div></p><p>When compiling a <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span> or <span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span> expression,
+Racket looks for a <a name="(idx._(gentag._107._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">method-arity-error</span> property
+attached to the expression (see <a href="stxprops.html" data-pltdoc="x">Syntax Object Properties</a>). If it is
+present with a true value, and if no case of the procedure accepts
+zero arguments, then the procedure is marked so that an
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3aarity%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:arity</a></span> exception involving the procedure
+will hide the first argument, if one was provided. (Hiding the first
+argument is useful when the procedure implements a method, where the
+first argument is implicit in the original source). The property
+affects only the format of <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3aarity%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:arity</a></span>
+exceptions, not the result of <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-arity</a></span>.</p><p>When a keyword-accepting procedure is bound to an identifier in
+certain ways, and when the identifier is used in the function position
+of an application form, then the application form may be expanded in
+such a way that the original binding is obscured as the target of the
+application. To help expose the connection between the function
+application and function declaration, an identifier in the expansion
+of the function application is tagged with a <a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax property</span></a>
+accessible via <span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fkeyword-transform..rkt%29._syntax-procedure-alias-property%29%29" class="RktValLink" data-pltdoc="x">syntax-procedure-alias-property</a></span> if it is effectively an alias
+for the original identifier. An identifier in the expansion is tagged with a
+<a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax property</span></a> accessible via <span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fkeyword-transform..rkt%29._syntax-procedure-converted-arguments-property%29%29" class="RktValLink" data-pltdoc="x">syntax-procedure-converted-arguments-property</a></span> if it
+is like the original identifier except that the arguments are converted to a
+flattened form: keyword arguments, required by-position arguments,
+by-position optional arguments, and rest arguments&#8212;<wbr></wbr>all as required,
+by-position arguments; the keyword arguments are sorted by keyword
+name, each optional keyword argument is followed by a boolean to
+indicate whether a value is provided, and <span class="RktVal">#f</span> is used for an
+optional keyword argument whose value is not provided; optional
+by-position arguments include <span class="RktVal">#f</span> for each non-provided
+argument, and then the sequence of optional-argument values is
+followed by a parallel sequence of booleans to indicate whether each
+optional-argument value was provided.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._case-lambda))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">case-lambda</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">formals</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">formals</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">rest-id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">rest-id</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Produces a procedure. Each <span class="RktPn">[</span><span class="RktVar">formals</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-patterns.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._......%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...+</a></span><span class="RktPn">]</span>
+clause is analogous to a single <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span> procedure; applying
+the <span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span>-generated procedure is the same as applying a
+procedure that corresponds to one of the clauses&#8212;<wbr></wbr>the first procedure
+that accepts the given number of arguments. If no corresponding
+procedure accepts the given number of arguments, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p>Note that a <span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span> clause supports only
+<span class="RktVar">formals</span>, not the more general <span class="RktVar">kw-formals</span> of
+<span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span>. That is, <span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span> does not directly
+support keyword and optional arguments.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(10 1 (2 1) (1 2 3))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._~23~25plain-lambda))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-lambda%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">#%plain-lambda</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">formals</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span>, but without support for keyword or optional arguments.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="application.html" title="backward to &quot;3.7 Procedure Applications and #%app&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="let.html" title="forward to &quot;3.9 Local Binding: let, let*, letrec, ...&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/lazy-require.html b/clones/docs.racket-lang.org/reference/lazy-require.html
new file mode 100644
index 00000000..15c0a3ab
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/lazy-require.html
@@ -0,0 +1,44 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.26&nbsp;Importing Modules Lazily: lazy-require</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewselflink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="lazy-require.html#%28form._%28%28lib._racket%2Flazy-require..rkt%29._lazy-require%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr><tr><td><a href="lazy-require.html#%28form._%28%28lib._racket%2Flazy-require..rkt%29._lazy-require-syntax%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require-<wbr></wbr>syntax</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="performance-hint.html" title="backward to &quot;3.25 Performance Hints: begin-encourage-inline&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="data.html" title="forward to &quot;4 Datatypes&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;lazy-require&quot;">3.26<tt>&nbsp;</tt><a name="(part._lazy-require)"></a><a name="(mod-path._racket/lazy-require)"></a>Importing Modules Lazily: <span class="RktSym"><a href="lazy-require.html#%28form._%28%28lib._racket%2Flazy-require..rkt%29._lazy-require%29%29" class="RktStxLink" data-pltdoc="x">lazy-require</a></span></h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="lazy-require.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/lazy-require</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="lazy-require.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/lazy-require</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/lazy-require..rkt)._lazy-require))"></a><span title="Provided from: racket/lazy-require | Package: base"><span class="RktSym"><a href="lazy-require.html#%28form._%28%28lib._racket%2Flazy-require..rkt%29._lazy-require%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">lazy-require</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">module-path</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">fun-import</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">fun-import</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">fun-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">orig-fun-id</span><span class="hspace">&nbsp;</span><span class="RktVar">fun-id</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Defines each <span class="RktVar">fun-id</span> as a function that, when called,
+dynamically requires the export named <span class="RktVar">orig-fun-id</span> from the
+module specified by <span class="RktVar">module-path</span> and calls it with the same
+arguments. If <span class="RktVar">orig-fun-id</span> is not given, it defaults to
+<span class="RktVar">fun-id</span>.</div></p><p>If the enclosing relative phase level is not 0, then
+<span class="RktVar">module-path</span> is also placed in a submodule (with a use of
+<span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-module-path-index%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-module-path-index</a></span> at phase level 0 within the
+submodule). Introduced submodules have the names
+<span class="RktSym">lazy-require-aux</span><span class="RktVar">n</span><span class="RktSym">-</span><span class="RktVar">m</span>, where
+<span class="RktVar">n</span> is a phase-level number and <span class="RktVar">m</span> is a number.</p><p>When the use of a lazily-required function triggers module loading, it
+also triggers a use of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=cm-accomplice.html%23%2528def._%2528%2528lib._compiler%252Fcm-accomplice..rkt%2529._register-external-module%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">register-external-module</a></span> to declare an
+indirect compilation dependency (in case the function is used in the
+process of compiling a module).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="lazy-require.html#%28form._%28%28lib._racket%2Flazy-require..rkt%29._lazy-require%29%29" class="RktStxLink" data-pltdoc="x">lazy-require</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">racket/list</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._partition%29%29" class="RktValLink" data-pltdoc="x">partition</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._partition%29%29" class="RktValLink" data-pltdoc="x">partition</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">'(2 4)</span></p></td></tr><tr><td><p><span class="RktRes">'(1 3 5)</span></p></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hello</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hello</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"starting hello server\n"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hello</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello!\n"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="lazy-require.html#%28form._%28%28lib._racket%2Flazy-require..rkt%29._lazy-require%29%29" class="RktStxLink" data-pltdoc="x">lazy-require</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVal">'</span><span class="RktVal">hello</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">hello</span><span class="hspace">&nbsp;</span><span class="RktSym">greet</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">starting hello server</span></p></td></tr><tr><td><p><span class="RktOut">hello!</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/lazy-require..rkt)._lazy-require-syntax))"></a><span title="Provided from: racket/lazy-require | Package: base"><span class="RktSym"><a href="lazy-require.html#%28form._%28%28lib._racket%2Flazy-require..rkt%29._lazy-require-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">lazy-require-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">module-path</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">macro-import</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">macro-import</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">macro-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">orig-macro-id</span><span class="hspace">&nbsp;</span><span class="RktVar">macro-id</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="lazy-require.html#%28form._%28%28lib._racket%2Flazy-require..rkt%29._lazy-require%29%29" class="RktStxLink" data-pltdoc="x">lazy-require</a></span> but for macros. That is, it defines each
+<span class="RktVar">macro-id</span> as a macro that, when used, dynamically loads the
+macro&rsquo;s implementation from the given <span class="RktVar">module-path</span>. If
+<span class="RktVar">orig-macro-id</span> is not given, it defaults to <span class="RktVar">macro-id</span>.</div></p><p>Use <span class="RktSym"><a href="lazy-require.html#%28form._%28%28lib._racket%2Flazy-require..rkt%29._lazy-require-syntax%29%29" class="RktStxLink" data-pltdoc="x">lazy-require-syntax</a></span> in the <span class="emph">implementation</span> of a library
+with large, complicated macros to avoid a dependence from clients of
+the library on the macro &ldquo;compilers.&rdquo; Note that only macros with
+exceptionally large compile-time components (such as Typed Racket,
+which includes a type checker and optimizer) benefit from
+<span class="RktSym"><a href="lazy-require.html#%28form._%28%28lib._racket%2Flazy-require..rkt%29._lazy-require-syntax%29%29" class="RktStxLink" data-pltdoc="x">lazy-require-syntax</a></span>; typical macros do not.</p><p><div class="SIntrapara"><span style="font-weight: bold">Warning:</span> <span class="RktSym"><a href="lazy-require.html#%28form._%28%28lib._racket%2Flazy-require..rkt%29._lazy-require-syntax%29%29" class="RktStxLink" data-pltdoc="x">lazy-require-syntax</a></span> breaks the invariants
+that Racket&rsquo;s module loader and linker rely on; these invariants
+normally ensure that the references in code produced by a macro are
+loaded before the code runs. Safe use of <span class="RktSym"><a href="lazy-require.html#%28form._%28%28lib._racket%2Flazy-require..rkt%29._lazy-require-syntax%29%29" class="RktStxLink" data-pltdoc="x">lazy-require-syntax</a></span>
+requires a particular structure in the macro implementation. (In
+particular, <span class="RktSym"><a href="lazy-require.html#%28form._%28%28lib._racket%2Flazy-require..rkt%29._lazy-require-syntax%29%29" class="RktStxLink" data-pltdoc="x">lazy-require-syntax</a></span> cannot simply be introduced
+in the client code.) The macro implementation must follow these rules:
+</div><div class="SIntrapara"><ol><li><p>the interface module must <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> the runtime-support module</p></li><li><p>the compiler module must <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> the runtime-support module via
+an <span class="emph">absolute</span> module path rather than a <span class="emph">relative</span> path</p></li></ol></div></p><p><div class="SIntrapara">To explain the concepts of &ldquo;interface, compiler, and runtime-support
+modules&rdquo;, here is an example module that exports a macro:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">original</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ntimes-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28form._%28%28lib._racket%2Ffunction..rkt%29._thunk%29%29" class="RktStxLink" data-pltdoc="x">thunk</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28form._%28%28lib._racket%2Ffunction..rkt%29._thunk%29%29" class="RktStxLink" data-pltdoc="x">thunk</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._define-syntax-rule%29%29" class="RktStxLink" data-pltdoc="x">define-syntax-rule</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ntimes</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Library_Syntax_Classes_and_Literal_Sets.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._expr%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">expr</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ntimes-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Library_Syntax_Classes_and_Literal_Sets.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._expr%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">expr</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ntimes</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Suppose we want to use <span class="RktSym"><a href="lazy-require.html#%28form._%28%28lib._racket%2Flazy-require..rkt%29._lazy-require-syntax%29%29" class="RktStxLink" data-pltdoc="x">lazy-require-syntax</a></span> to lazily load the
+implementation of the <span class="RktSym">ntimes</span> macro transformer. The original
+module must be split into three parts:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">runtime-support</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ntimes-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28form._%28%28lib._racket%2Ffunction..rkt%29._thunk%29%29" class="RktStxLink" data-pltdoc="x">thunk</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28form._%28%28lib._racket%2Ffunction..rkt%29._thunk%29%29" class="RktStxLink" data-pltdoc="x">thunk</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ntimes-proc</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">compiler</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">runtime-support</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._define-syntax-rule%29%29" class="RktStxLink" data-pltdoc="x">define-syntax-rule</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ntimes</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Library_Syntax_Classes_and_Literal_Sets.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._expr%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">expr</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ntimes-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Library_Syntax_Classes_and_Literal_Sets.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._expr%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">expr</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ntimes</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%29%29" class="RktStxLink" data-pltdoc="x">interface</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/lazy-require</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">runtime-support</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lazy-require.html#%28form._%28%28lib._racket%2Flazy-require..rkt%29._lazy-require-syntax%29%29" class="RktStxLink" data-pltdoc="x">lazy-require-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVal">'</span><span class="RktVal">compiler</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ntimes</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ntimes</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">The runtime support module contains the function and value definitions
+that the macro refers to. The compiler module contains the macro
+definition(s) themselves&#8212;<wbr></wbr>the part of the code that &ldquo;disappears&rdquo;
+after compile time. The interface module lazily loads the macro
+transformer, but it makes sure the runtime support module is defined at
+run time by requiring it normally. In a larger example, of course, the
+runtime support and compiler may both consist of multiple modules.</div></p><p><div class="SIntrapara">Here what happens when we don&rsquo;t separate the runtime support into a
+separate module:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bad-no-runtime</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ntimes-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28form._%28%28lib._racket%2Ffunction..rkt%29._thunk%29%29" class="RktStxLink" data-pltdoc="x">thunk</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28form._%28%28lib._racket%2Ffunction..rkt%29._thunk%29%29" class="RktStxLink" data-pltdoc="x">thunk</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._define-syntax-rule%29%29" class="RktStxLink" data-pltdoc="x">define-syntax-rule</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ntimes</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Library_Syntax_Classes_and_Literal_Sets.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._expr%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">expr</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ntimes-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Library_Syntax_Classes_and_Literal_Sets.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._expr%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">expr</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ntimes</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bad-client</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/lazy-require</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lazy-require.html#%28form._%28%28lib._racket%2Flazy-require..rkt%29._lazy-require-syntax%29%29" class="RktStxLink" data-pltdoc="x">lazy-require-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVal">'</span><span class="RktVal">bad-no-runtime</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ntimes</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ntimes</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello?\n"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">bad-client</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">require: namespace mismatch;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">reference to a module that is not instantiated</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">module: 'bad-no-runtime</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">phase: 0</span></p></td></tr></table></blockquote></div><div class="SIntrapara">A similar error occurs when the interface module doesn&rsquo;t introduce a
+dependency on the runtime support module.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="performance-hint.html" title="backward to &quot;3.25 Performance Hints: begin-encourage-inline&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="data.html" title="forward to &quot;4 Datatypes&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/let.html b/clones/docs.racket-lang.org/reference/let.html
new file mode 100644
index 00000000..62efd90c
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/let.html
@@ -0,0 +1,78 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.9&nbsp;Local Binding: let, let*, letrec, ...</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewselflink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">let</span></span></a></td></tr><tr><td><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">let*</span></span></a></td></tr><tr><td><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">letrec</span></span></a></td></tr><tr><td><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">let-<wbr></wbr>values</span></span></a></td></tr><tr><td><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A-values%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">let*-<wbr></wbr>values</span></span></a></td></tr><tr><td><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-values%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">letrec-<wbr></wbr>values</span></span></a></td></tr><tr><td><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntax%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">let-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec-syntax%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">letrec-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntaxes%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">let-<wbr></wbr>syntaxes</span></span></a></td></tr><tr><td><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec-syntaxes%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">letrec-<wbr></wbr>syntaxes</span></span></a></td></tr><tr><td><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">letrec-<wbr></wbr>syntaxes+<span class="mywbr"> &nbsp;</span>values</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="lambda.html" title="backward to &quot;3.8 Procedure Expressions: lambda and case-lambda&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="local.html" title="forward to &quot;3.10 Local Definitions: local&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;let&quot;">3.9<tt>&nbsp;</tt><a name="(part._let)"></a>Local Binding: <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span>, <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A%29%29" class="RktStxLink" data-pltdoc="x">let*</a></span>, <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec%29%29" class="RktStxLink" data-pltdoc="x">letrec</a></span>, ...</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=let.html&amp;version=8.6" class="Sq" data-pltdoc="x">Local Binding</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces local binding.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/letstx-scheme..rkt)._let))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">let</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">val-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktVar">proc-id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">init-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">The first form evaluates the <span class="RktVar">val-expr</span>s left-to-right, creates
+a new <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a> for each <span class="RktVar">id</span>, and places the values into the
+locations. It then evaluates the <span class="RktVar">body</span>s, in which the
+<span class="RktVar">id</span>s are bound. The last <span class="RktVar">body</span> expression is in
+tail position with respect to the <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span> form. The <span class="RktVar">id</span>s
+must be distinct according to <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._bound-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">bound-identifier=?</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(5 2)</span></p></td></tr></table></blockquote></div></p><p>The second form, usually known as <a name="(tech._named._let)"></a><span style="font-style: italic">named <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span></span>, evaluates the <span class="RktVar">init-expr</span>s; the resulting
+values become arguments in an application of a procedure
+<span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">id</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-patterns.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._......%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...+</a></span><span class="RktPn">)</span>, where <span class="RktVar">proc-id</span> is bound
+within the <span class="RktVar">body</span>s to the procedure itself.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fac</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fac</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">3628800</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/letstx-scheme..rkt)._let*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">let*</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">val-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span>, but evaluates the <span class="RktVar">val-expr</span>s one by
+one, creating a <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a> for each <span class="RktVar">id</span> as soon as the value is
+available. The <span class="RktVar">id</span>s are bound in the remaining <span class="RktVar">val-expr</span>s
+as well as the <span class="RktVar">body</span>s, and the <span class="RktVar">id</span>s need not be
+distinct; later bindings shadow earlier bindings.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A%29%29" class="RktStxLink" data-pltdoc="x">let*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(2 1)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/letstx-scheme..rkt)._letrec))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">letrec</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">val-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span>, including left-to-right evaluation of the <span class="RktVar">val-expr</span>s,
+but the <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">locations</span></a> for all <span class="RktVar">id</span>s are
+created first, all
+<span class="RktVar">id</span>s are bound in all <span class="RktVar">val-expr</span>s as well as the
+<span class="RktVar">body</span>s, and each <span class="RktVar">id</span> is initialized immediately after the
+corresponding <span class="RktVar">val-expr</span> is evaluated. The <span class="RktVar">id</span>s must be distinct according to
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._bound-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">bound-identifier=?</a></span>.</div></p><p>Referencing or assigning to an <span class="RktVar">id</span> before its initialization
+raises <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3avariable%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:variable</a></span>. If an <span class="RktVar">id</span> (i.e.,
+the binding instance or <span class="RktVar">id</span>) has an
+<a name="(idx._(gentag._108._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">undefined-error-name</span> <a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax property</span></a> whose
+value is a symbol, the symbol is used as the name of the variable for
+error reporting, instead of the symbolic form of <span class="RktVar">id</span>.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec%29%29" class="RktStxLink" data-pltdoc="x">letrec</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">is-even?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">is-odd?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">is-odd?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">is-even?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">is-odd?</span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.0.1.2 of package <span class="stt">base</span>: Changed reference or assignment of an uninitialized <span class="RktVar">id</span> to an error.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._let-values))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">let-values</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">val-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"> Like
+<span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span>, except that each <span class="RktVar">val-expr</span> must produce as many
+values as corresponding <span class="RktVar">id</span>s, otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. A separate <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a> is created for each
+<span class="RktVar">id</span>, all of which are bound in the <span class="RktVar">body</span>s.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._quotient%2Fremainder%29%29" class="RktValLink" data-pltdoc="x">quotient/remainder</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(1 3)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/letstx-scheme..rkt)._let*-values))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A-values%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">let*-values</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">val-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"> Like
+<span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A%29%29" class="RktStxLink" data-pltdoc="x">let*</a></span>, except that each <span class="RktVar">val-expr</span> must produce as many
+values as corresponding <span class="RktVar">id</span>s. A separate <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a> is created
+for each <span class="RktVar">id</span>, all of which are bound in the later
+<span class="RktVar">val-expr</span>s and in the <span class="RktVar">body</span>s.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A-values%29%29" class="RktStxLink" data-pltdoc="x">let*-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._quotient%2Fremainder%29%29" class="RktValLink" data-pltdoc="x">quotient/remainder</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(1 3)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._letrec-values))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-values%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">letrec-values</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">val-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"> Like
+<span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec%29%29" class="RktStxLink" data-pltdoc="x">letrec</a></span>, except that each <span class="RktVar">val-expr</span> must produce as
+many values as corresponding <span class="RktVar">id</span>s. A separate <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a> is
+created for each <span class="RktVar">id</span>, all of which are bound in all <span class="RktVar">val-expr</span>s
+and in the <span class="RktVar">body</span>s.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-values%29%29" class="RktStxLink" data-pltdoc="x">letrec-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">is-even?</span><span class="hspace">&nbsp;</span><span class="RktSym">is-odd?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">is-odd?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">is-even?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">is-odd?</span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/letstx-scheme..rkt)._let-syntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">let-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">trans-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span>See also <span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-let-syntax%29%29" class="RktStxLink" data-pltdoc="x">splicing-let-syntax</a></span>.</p></blockquote></blockquote></blockquote></div></p><p>Creates a <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding (see
+<a href="syntax-model.html#%28part._transformer-model%29" data-pltdoc="x">Transformer Bindings</a>) of each <span class="RktVar">id</span> with the value of
+<span class="RktVar">trans-expr</span>, which is an expression at <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 1
+relative to the surrounding context. (See <a href="syntax-model.html#%28part._id-model%29" data-pltdoc="x">Identifiers, Binding, and Scopes</a> for
+information on <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase levels</span></a>.)</p><p>The evaluation of each <span class="RktVar">trans-expr</span> is <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>d
+to set <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span> to a <a href="syntax-model.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespace</span></a> that shares
+<a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">bindings</span></a> and <a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variables</span></a> with the namespace being used to
+expand the <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntax%29%29" class="RktStxLink" data-pltdoc="x">let-syntax</a></span> form, except that its <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a>
+is one greater.</p><p>Each <span class="RktVar">id</span> is bound in the <span class="RktVar">body</span>s, and not in other
+<span class="RktVar">trans-expr</span>s.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/letstx-scheme..rkt)._letrec-syntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">letrec-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">trans-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span>See also <span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-letrec-syntax%29%29" class="RktStxLink" data-pltdoc="x">splicing-letrec-syntax</a></span>.</p></blockquote></blockquote></blockquote></div></p><p>Like <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntax%29%29" class="RktStxLink" data-pltdoc="x">let-syntax</a></span>, except that each <span class="RktVar">id</span> is also bound
+within all <span class="RktVar">trans-expr</span>s.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/letstx-scheme..rkt)._let-syntaxes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntaxes%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">let-syntaxes</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">trans-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span>See also <span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-let-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">splicing-let-syntaxes</a></span>.</p></blockquote></blockquote></blockquote></div></p><p>Like <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntax%29%29" class="RktStxLink" data-pltdoc="x">let-syntax</a></span>, but each <span class="RktVar">trans-expr</span> must produce as
+many values as corresponding <span class="RktVar">id</span>s, each of which is bound to
+the corresponding value.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/letstx-scheme..rkt)._letrec-syntaxes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec-syntaxes%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">letrec-syntaxes</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">trans-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span>See also <span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-letrec-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">splicing-letrec-syntaxes</a></span>.</p></blockquote></blockquote></blockquote></div></p><p>Like <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntax%29%29" class="RktStxLink" data-pltdoc="x">let-syntax</a></span>, except that each <span class="RktVar">id</span> is also bound
+within all <span class="RktVar">trans-expr</span>s.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._letrec-syntaxes+values))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">trans-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">trans-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">val-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">val-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Combines <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes</a></span> with a variant of
+<span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-values%29%29" class="RktStxLink" data-pltdoc="x">letrec-values</a></span>: each <span class="RktVar">trans-id</span> and <span class="RktVar">val-id</span> is
+bound in all <span class="RktVar">trans-expr</span>s and <span class="RktVar">val-expr</span>s.</div></p><p>The <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span> form is the core form for local
+compile-time bindings, since forms like <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec-syntax%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntax</a></span> and
+<a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition contexts</span></a> expand to it. In a fully expanded
+expression (see <a href="syntax-model.html#%28part._fully-expanded%29" data-pltdoc="x">Fully Expanded Programs</a>), the <span class="RktVar">trans-id</span>
+bindings are discarded and the form reduces to a combination of
+<span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-values%29%29" class="RktStxLink" data-pltdoc="x">letrec-values</a></span> or <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span>.</p><p>For variables bound by <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span>, the
+<a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a>-creation rules differ slightly from
+<span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-values%29%29" class="RktStxLink" data-pltdoc="x">letrec-values</a></span>. The <span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">val-id</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">val-expr</span><span class="RktPn">]</span> binding
+clauses are partitioned into minimal sets of clauses that satisfy the
+following rule: if a clause has a <span class="RktVar">val-id</span> binding that is
+referenced (in a full expansion) by the <span class="RktVar">val-expr</span> of an
+earlier clause, the two clauses and all in between are in the same
+set. If a set consists of a single clause whose <span class="RktVar">val-expr</span> does
+not refer to any of the clause&rsquo;s <span class="RktVar">val-id</span>s, then
+<a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">locations</span></a> for the <span class="RktVar">val-id</span>s are created <span class="emph">after</span> the
+<span class="RktVar">val-expr</span> is evaluated. Otherwise, <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">locations</span></a> for all
+<span class="RktVar">val-id</span>s in a set are created just before the first
+<span class="RktVar">val-expr</span> in the set is evaluated. For the purposes
+of forming sets, a <span class="RktPn">(</span><span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span><span class="stt"> </span><span class="RktVar">datum</span><span class="stt"> </span><span class="RktPn">#:local</span><span class="RktPn">)</span> form counts
+as a reference to all bindings in the <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span>
+form</p><p>The end result of the <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a>-creation rules is that scoping
+and evaluation order are the same as for <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-values%29%29" class="RktStxLink" data-pltdoc="x">letrec-values</a></span>, but
+the compiler has more freedom to optimize away <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">location</span></a>
+creation. The rules also correspond to a nesting of
+<span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span> and <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-values%29%29" class="RktStxLink" data-pltdoc="x">letrec-values</a></span>, which is how
+<span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span> for a fully-expanded expression.</p><p>See also <span class="RktSym"><a href="local.html#%28form._%28%28lib._racket%2Flocal..rkt%29._local%29%29" class="RktStxLink" data-pltdoc="x">local</a></span>, which supports local bindings with
+<span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span>, <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span>, and more.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="lambda.html" title="backward to &quot;3.8 Procedure Expressions: lambda and case-lambda&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="local.html" title="forward to &quot;3.10 Local Definitions: local&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/linecol.html b/clones/docs.racket-lang.org/reference/linecol.html
new file mode 100644
index 00000000..90fe245c
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/linecol.html
@@ -0,0 +1,60 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.1.4&nbsp;Counting Positions, Lines, and Columns</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewselflink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1.1&nbsp;</td><td><a href="encodings.html" class="tocviewlink" data-pltdoc="x">Encodings and Locales</a></td></tr><tr><td align="right">13.1.2&nbsp;</td><td><a href="port-ops.html" class="tocviewlink" data-pltdoc="x">Managing Ports</a></td></tr><tr><td align="right">13.1.3&nbsp;</td><td><a href="port-buffers.html" class="tocviewlink" data-pltdoc="x">Port Buffers and Positions</a></td></tr><tr><td align="right">13.1.4&nbsp;</td><td><a href="linecol.html" class="tocviewselflink" data-pltdoc="x">Counting Positions, Lines, and Columns</a></td></tr><tr><td align="right">13.1.5&nbsp;</td><td><a href="file-ports.html" class="tocviewlink" data-pltdoc="x">File Ports</a></td></tr><tr><td align="right">13.1.6&nbsp;</td><td><a href="stringport.html" class="tocviewlink" data-pltdoc="x">String Ports</a></td></tr><tr><td align="right">13.1.7&nbsp;</td><td><a href="pipeports.html" class="tocviewlink" data-pltdoc="x">Pipes</a></td></tr><tr><td align="right">13.1.8&nbsp;</td><td><a href="portstructs.html" class="tocviewlink" data-pltdoc="x">Structures as Ports</a></td></tr><tr><td align="right">13.1.9&nbsp;</td><td><a href="customport.html" class="tocviewlink" data-pltdoc="x">Custom Ports</a></td></tr><tr><td align="right">13.1.10&nbsp;</td><td><a href="port-lib.html" class="tocviewlink" data-pltdoc="x">More Port Constructors, Procedures, and Events</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-count-lines%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>count-<wbr></wbr>lines!</span></span></a></td></tr><tr><td><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-counts-lines~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>counts-<wbr></wbr>lines?</span></span></a></td></tr><tr><td><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-next-location%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>next-<wbr></wbr>location</span></span></a></td></tr><tr><td><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._set-port-next-location%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>port-<wbr></wbr>next-<wbr></wbr>location!</span></span></a></td></tr><tr><td><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-count-lines-enabled%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>count-<wbr></wbr>lines-<wbr></wbr>enabled</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="port-buffers.html" title="backward to &quot;13.1.3 Port Buffers and Positions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ports.html" title="up to &quot;13.1 Ports&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="file-ports.html" title="forward to &quot;13.1.5 File Ports&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;linecol&quot;">13.1.4<tt>&nbsp;</tt><a name="(part._linecol)"></a><a name="(idx._(gentag._248._(lib._scribblings/reference/reference..scrbl)))"></a><a name="(idx._(gentag._249._(lib._scribblings/reference/reference..scrbl)))"></a><a name="(idx._(gentag._250._(lib._scribblings/reference/reference..scrbl)))"></a>Counting Positions, Lines, and Columns</h5><p>By default, Racket keeps track of the <a name="(tech._position)"></a><span style="font-style: italic">position</span> in a port as
+the number of bytes that have been read from or written to any port
+(independent of the read/write position, which is accessed or changed
+with <span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%29%29" class="RktValLink" data-pltdoc="x">file-position</a></span>). Optionally, however, Racket can track
+the position in terms of characters (after UTF-8 decoding), instead of
+bytes, and it can track <a name="(tech._line._location)"></a><span style="font-style: italic">line locations</span> and <a name="(tech._column._location)"></a><span style="font-style: italic">column
+locations</span>; this optional tracking must be specifically enabled for a
+port via <span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-count-lines%21%29%29" class="RktValLink" data-pltdoc="x">port-count-lines!</a></span> or the
+<span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-count-lines-enabled%29%29" class="RktValLink" data-pltdoc="x">port-count-lines-enabled</a></span> parameter. Position, line, and
+column locations for a port are used by <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>.
+Position and line locations are numbered
+from <span style="font-style: italic"></span>1<span style="font-style: italic"></span>; column locations are numbered from <span style="font-style: italic"></span>0<span style="font-style: italic"></span>.</p><p>When counting lines, Racket treats linefeed, return, and
+return-linefeed combinations as a line terminator and as a single
+position (on all platforms). Each tab advances the column count to one
+before the next multiple of <span style="font-style: italic"></span>8<span style="font-style: italic"></span>. When a sequence of bytes in the
+range 128 to 253 forms a UTF-8 encoding of a character, the
+position/column is incremented once for each byte, and
+then decremented appropriately when a complete encoding sequence is
+discovered. See also <a href="ports.html" data-pltdoc="x">Ports</a> for more information on UTF-8
+decoding for ports.</p><p>A position is known for any port as long as its value can be expressed
+as a fixnum (which is more than enough tracking for realistic
+applications in, say, syntax-error reporting).  If the position for a
+port exceeds the value of the largest fixnum, then the position for
+the port becomes unknown, and line and column tacking is disabled.
+Return-linefeed combinations are treated as a single character
+position only when line and column counting is enabled.</p><p><a href="customport.html#%28tech._custom._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">Custom ports</span></a> can define their own counting functions, which are
+not subject to the rules above, except that the counting functions are
+invoked only when tracking is specifically enabled with
+<span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-count-lines%21%29%29" class="RktValLink" data-pltdoc="x">port-count-lines!</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._port-count-lines!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-count-lines%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-count-lines!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">port</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._port~3f%29%29" class="RktValLink" data-pltdoc="x">port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Turns on <a href="linecol.html#%28tech._line._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">line location</span></a> and <a href="linecol.html#%28tech._column._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">column location</span></a> counting
+for a port. Counting can be turned
+on at any time, though generally it is turned on before any data is
+read from or written to a port. At the point that line counting is
+turned on, <span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-next-location%29%29" class="RktValLink" data-pltdoc="x">port-next-location</a></span> typically starts reporting as
+its last result (one more than) the number of characters read since
+line counting was enabled, instead of (one more than) bytes read since
+the port was opened.</div></p><p>When a port is created, if the value of the
+<span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-count-lines-enabled%29%29" class="RktValLink" data-pltdoc="x">port-count-lines-enabled</a></span> parameter is true, then line
+counting is automatically enabled for the port. Line counting cannot
+be disabled for a port after it is enabled.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._port-counts-lines~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-counts-lines~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-counts-lines?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">port</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._port~3f%29%29" class="RktValLink" data-pltdoc="x">port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <a href="linecol.html#%28tech._line._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">line location</span></a> and <a href="linecol.html#%28tech._column._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">column location</span></a>
+counting has been enabled for
+<span class="RktVar">port</span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._port-next-location))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-next-location%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-next-location</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">port</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._port~3f%29%29" class="RktValLink" data-pltdoc="x">port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns three values: an integer or <span class="RktVal">#f</span> for the line number of
+the next read/written item, an integer or <span class="RktVal">#f</span> for the next
+item&rsquo;s column, and an integer or <span class="RktVal">#f</span> for the next item&rsquo;s
+position. The next column and position normally increase as bytes are
+read from or written to the port, but if line/character counting is
+enabled for <span class="RktVar">port</span>, the column and position results can
+decrease after reading or writing a byte that ends a UTF-8 encoding
+sequence.</div></p><p>If line counting is not enabled for a port, than the first two results
+are <span class="RktVal">#f</span>, and the last result is one more than the number of
+bytes read so far. At the point when line counting is enabled, the
+first two results typically become non-<span class="RktVal">#f</span>, and last result
+starts reporting characters instead of bytes, typically starting from
+the point when line counting is enabled.</p><p>Even with line counting enabled, a port may return <span class="RktVal">#f</span> values
+if it somehow cannot keep track of lines, columns, or positions.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._set-port-next-location!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._set-port-next-location%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-port-next-location!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">port</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">line</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">column</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">position</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._port~3f%29%29" class="RktValLink" data-pltdoc="x">port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">line</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">column</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">position</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Sets the next line, column, and position for <span class="RktVar">port</span>. If line
+counting has not been enabled for <span class="RktVar">port</span> or if <span class="RktVar">port</span> is
+a <a href="customport.html#%28tech._custom._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">custom port</span></a> that defines its own counting function, then
+<span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._set-port-next-location%21%29%29" class="RktValLink" data-pltdoc="x">set-port-next-location!</a></span> has no effect.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._port-count-lines-enabled))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-count-lines-enabled%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-count-lines-enabled</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-count-lines-enabled%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-count-lines-enabled</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines whether line counting is enabled
+automatically for newly created ports. The default value is
+<span class="RktVal">#f</span>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="port-buffers.html" title="backward to &quot;13.1.3 Port Buffers and Positions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ports.html" title="up to &quot;13.1 Ports&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="file-ports.html" title="forward to &quot;13.1.5 File Ports&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/linkinference.html b/clones/docs.racket-lang.org/reference/linkinference.html
new file mode 100644
index 00000000..39371448
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/linkinference.html
@@ -0,0 +1,70 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7.4&nbsp;Inferred Linking</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="creatingunits.html" class="tocviewlink" data-pltdoc="x">Creating Units</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="invokingunits.html" class="tocviewlink" data-pltdoc="x">Invoking Units</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="compoundunits.html" class="tocviewlink" data-pltdoc="x">Linking Units and Creating Compound Units</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="linkinference.html" class="tocviewselflink" data-pltdoc="x">Inferred Linking</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="Generating_A_Unit_from_Context.html" class="tocviewlink" data-pltdoc="x">Generating A Unit from Context</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="Structural_Matching.html" class="tocviewlink" data-pltdoc="x">Structural Matching</a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="define-sig-form.html" class="tocviewlink" data-pltdoc="x">Extending the Syntax of Signatures</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Unit_Utilities.html" class="tocviewlink" data-pltdoc="x">Unit Utilities</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="unitcontracts.html" class="tocviewlink" data-pltdoc="x">Unit Contracts</a></td></tr><tr><td align="right">7.10&nbsp;</td><td><a href="single-unit.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Unit Modules</a></td></tr><tr><td align="right">7.11&nbsp;</td><td><a href="Single-Signature_Modules.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Signature Modules</a></td></tr><tr><td align="right">7.12&nbsp;</td><td><a href="Transformer_Helpers.html" class="tocviewlink" data-pltdoc="x">Transformer Helpers</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>unit</span></span></a></td></tr><tr><td><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%2Finfer%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">compound-<wbr></wbr>unit/<span class="mywbr"> &nbsp;</span>infer</span></span></a></td></tr><tr><td><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-compound-unit%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>compound-<wbr></wbr>unit</span></span></a></td></tr><tr><td><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-compound-unit%2Finfer%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>compound-<wbr></wbr>unit/<span class="mywbr"> &nbsp;</span>infer</span></span></a></td></tr><tr><td><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit-binding%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>unit-<wbr></wbr>binding</span></span></a></td></tr><tr><td><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._invoke-unit%2Finfer%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">invoke-<wbr></wbr>unit/<span class="mywbr"> &nbsp;</span>infer</span></span></a></td></tr><tr><td><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-values%2Finvoke-unit%2Finfer%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>values/<span class="mywbr"> &nbsp;</span>invoke-<wbr></wbr>unit/<span class="mywbr"> &nbsp;</span>infer</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="compoundunits.html" title="backward to &quot;7.3 Linking Units and Creating Compound Units&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Generating_A_Unit_from_Context.html" title="forward to &quot;7.5 Generating A Unit from Context&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;linkinference&quot;">7.4<tt>&nbsp;</tt><a name="(part._linkinference)"></a>Inferred Linking</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._define-unit))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-unit</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">unit-id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">init-depends-decl</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">unit-body-expr-or-defn</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Binds <span class="RktVar">unit-id</span> to both a unit and static information about the
+unit.</div></p><p>Evaluating a reference to a <span class="RktVar">unit-id</span> bound by
+<span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%29%29" class="RktStxLink" data-pltdoc="x">define-unit</a></span> produces a unit, just like evaluating an
+<span class="RktSym">id</span> bound by <span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktSym">id</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span>. In addition,
+however, <span class="RktVar">unit-id</span> can be used in <span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%2Finfer%29%29" class="RktStxLink" data-pltdoc="x">compound-unit/infer</a></span>.
+See <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span> for information on <span class="RktVar">tagged-sig-spec</span>,
+<span class="RktVar">init-depends-decl</span>, and <span class="RktVar">unit-body-expr-or-defn</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._compound-unit/infer))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%2Finfer%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">compound-unit/infer</a></span></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-infer-link-import</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-infer-link-export</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="RktStxLink" data-pltdoc="x">link</a></span><span class="hspace">&nbsp;</span><span class="RktVar">infer-linkage-decl</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">tagged-infer-link-import</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">tagged-sig-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">link-id</span><span class="hspace">&nbsp;</span><span class="RktSym">:</span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">tagged-infer-link-export</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._tag%29%29" class="RktStxLink" data-pltdoc="x">tag</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">infer-link-export</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">infer-link-export</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">infer-link-export</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">link-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">sig-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">infer-linkage-decl</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVar">link-binding</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">unit-id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">tagged-link-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">unit-id</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="compoundunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%29%29" class="RktStxLink" data-pltdoc="x">compound-unit</a></span>. Syntactically, the difference between
+<span class="RktSym"><a href="compoundunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%29%29" class="RktStxLink" data-pltdoc="x">compound-unit</a></span> and <span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%2Finfer%29%29" class="RktStxLink" data-pltdoc="x">compound-unit/infer</a></span> is that the
+<span class="RktVar">unit-expr</span> for a linked unit is replaced with a
+<span class="RktVar">unit-id</span>, where a <span class="RktVar">unit-id</span> is bound by
+<span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%29%29" class="RktStxLink" data-pltdoc="x">define-unit</a></span> (or one of the other unit-binding forms that we
+introduce later in this section). Furthermore, an import can name just
+a <span class="RktVar">sig-id</span> without locally binding a <span class="RktVar">link-id</span>, and an
+export can be based on a <span class="RktVar">sig-id</span> instead of a
+<span class="RktVar">link-id</span>, and a declaration in the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="RktStxLink" data-pltdoc="x">link</a></span> clause can be
+simply a <span class="RktVar">unit-id</span> with no specified exports or imports.</div></p><p>The <span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%2Finfer%29%29" class="RktStxLink" data-pltdoc="x">compound-unit/infer</a></span> form expands to
+<span class="RktSym"><a href="compoundunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%29%29" class="RktStxLink" data-pltdoc="x">compound-unit</a></span> by adding <span class="RktSym">sig-ids</span> as needed to
+the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span> clause, by replacing <span class="RktVar">sig-id</span>s in the
+<span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span> clause by <span class="RktVar">link-id</span>s, and by completing
+the declarations of the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="RktStxLink" data-pltdoc="x">link</a></span> clause. This completion is based
+on static information associated with each
+<span class="RktVar">unit-id</span>. Links and exports can be inferred when all
+signatures exported by the linked units are distinct from each other
+and from all imported signatures, and when all imported signatures are
+distinct. Two signatures are <span style="font-style: italic">distinct</span> only if they
+share no ancestor through <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._extends%29%29" class="RktStxLink" data-pltdoc="x">extends</a></span>.</p><p>The long form of a <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="RktStxLink" data-pltdoc="x">link</a></span> declaration can be used to resolve
+ambiguity by giving names to some of a unit&rsquo;s exports and supplying
+specific bindings for some of a unit&rsquo;s imports. The long form need not
+name all of a unit&rsquo;s exports or supply all of a unit&rsquo;s imports if the
+remaining parts can be inferred.</p><p>When a unit declares initialization dependencies,
+<span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%2Finfer%29%29" class="RktStxLink" data-pltdoc="x">compound-unit/infer</a></span> checks that the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="RktStxLink" data-pltdoc="x">link</a></span> declaration
+is consistent with those dependencies, and it reports a syntax error if
+not.</p><p>Like <span class="RktSym"><a href="compoundunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%29%29" class="RktStxLink" data-pltdoc="x">compound-unit</a></span>, the <span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%2Finfer%29%29" class="RktStxLink" data-pltdoc="x">compound-unit/infer</a></span> form
+produces a (compound) unit without statically binding information
+about the result unit&rsquo;s imports and exports. That is,
+<span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%2Finfer%29%29" class="RktStxLink" data-pltdoc="x">compound-unit/infer</a></span> consumes static information, but it does
+not generate it. Two additional forms,
+<span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-compound-unit%29%29" class="RktStxLink" data-pltdoc="x">define-compound-unit</a></span> and
+<span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-compound-unit%2Finfer%29%29" class="RktStxLink" data-pltdoc="x">define-compound-unit/infer</a></span>, generate static information
+(where the former does not consume static information).</p><p class="SHistory">Changed in version 6.1.1.8 of package <span class="stt">base</span>: Added static checking of the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="RktStxLink" data-pltdoc="x">link</a></span>
+clause with respect to declared
+initialization dependencies.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._define-compound-unit))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-compound-unit%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-compound-unit</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span><span class="hspace">&nbsp;</span><span class="RktVar">link-binding</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-link-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="RktStxLink" data-pltdoc="x">link</a></span><span class="hspace">&nbsp;</span><span class="RktVar">linkage-decl</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="compoundunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%29%29" class="RktStxLink" data-pltdoc="x">compound-unit</a></span>, but binds static information about the
+compound unit like <span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%29%29" class="RktStxLink" data-pltdoc="x">define-unit</a></span>, including the propagation of
+initialization-dependency information (on remaining inports) from the
+linked units.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._define-compound-unit/infer))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-compound-unit%2Finfer%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-compound-unit/infer</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span><span class="hspace">&nbsp;</span><span class="RktVar">link-binding</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-infer-link-export</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="RktStxLink" data-pltdoc="x">link</a></span><span class="hspace">&nbsp;</span><span class="RktVar">infer-linkage-decl</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._compound-unit%2Finfer%29%29" class="RktStxLink" data-pltdoc="x">compound-unit/infer</a></span>, but binds static information about
+the compound unit like <span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-compound-unit%29%29" class="RktStxLink" data-pltdoc="x">define-compound-unit</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._define-unit-binding))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit-binding%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-unit-binding</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">unit-id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">unit-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">init-depends-decl</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%29%29" class="RktStxLink" data-pltdoc="x">define-unit</a></span>, but the unit implementation is determined
+from an existing unit produced by <span class="RktVar">unit-expr</span>. The imports and
+exports of the unit produced by <span class="RktVar">unit-expr</span> must be consistent
+with the declared imports and exports, otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised when the <span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit-binding%29%29" class="RktStxLink" data-pltdoc="x">define-unit-binding</a></span>
+form is evaluated.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._invoke-unit/infer))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._invoke-unit%2Finfer%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">invoke-unit/infer</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">unit-spec</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">unit-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">unit-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="RktStxLink" data-pltdoc="x">link</a></span><span class="hspace">&nbsp;</span><span class="RktVar">link-unit-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="invokingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._invoke-unit%29%29" class="RktStxLink" data-pltdoc="x">invoke-unit</a></span>, but uses static information associated with
+<span class="RktVar">unit-id</span> to infer which imports must be assembled from the
+current context.  If given a link form containing multiple
+<span class="RktVar">link-unit-id</span>s, then the units are first linked via
+<span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-compound-unit%2Finfer%29%29" class="RktStxLink" data-pltdoc="x">define-compound-unit/infer</a></span>.</div></p><p>When assembling imports from the current context, the <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical
+information</span></a> of a <span class="RktVar">unit-id</span> is used for constructing the lexical
+information of the signatures for the unit&rsquo;s imports (i.e., the lexical
+information that would normally be derived from the signature reference).
+See <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature%29%29" class="RktStxLink" data-pltdoc="x">define-signature</a></span> for more information.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._define-values/invoke-unit/infer))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-values%2Finvoke-unit%2Finfer%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-values/invoke-unit/infer</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-exports</span><span class="hspace">&nbsp;</span><span class="RktVar">unit-spec</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">maybe-exports</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">unit-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">unit-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._link%29%29" class="RktStxLink" data-pltdoc="x">link</a></span><span class="hspace">&nbsp;</span><span class="RktVar">link-unit-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="invokingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-values%2Finvoke-unit%29%29" class="RktStxLink" data-pltdoc="x">define-values/invoke-unit</a></span>, but uses static information
+associated with <span class="RktVar">unit-id</span> to infer which imports must be
+assembled from the current context and, if no <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span> clause
+is present, which exports should be bound by the definition. If given
+a link form containing multiple <span class="RktVar">link-unit-id</span>s, then the units
+are first linked via <span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-compound-unit%2Finfer%29%29" class="RktStxLink" data-pltdoc="x">define-compound-unit/infer</a></span>.</div></p><p>Similar to <span class="RktSym"><a href="linkinference.html#%28form._%28%28lib._racket%2Funit..rkt%29._invoke-unit%2Finfer%29%29" class="RktStxLink" data-pltdoc="x">invoke-unit/infer</a></span>, the <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a>
+of a <span class="RktVar">unit-id</span> is used for constructing the lexical information
+of the signatures for the unit&rsquo;s inferred imports and inferred exports
+(i.e., the lexical information that would normally be derived from a
+signature reference). See <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-signature%29%29" class="RktStxLink" data-pltdoc="x">define-signature</a></span> for more
+information.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="compoundunits.html" title="backward to &quot;7.3 Linking Units and Creating Compound Units&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Generating_A_Unit_from_Context.html" title="forward to &quot;7.5 Generating A Unit from Context&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/linklets.html b/clones/docs.racket-lang.org/reference/linklets.html
new file mode 100644
index 00000000..f71ca9c5
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/linklets.html
@@ -0,0 +1,247 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14.14&nbsp;Linklets and the Core Compiler</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewselflink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Namespaces.html" class="tocviewlink" data-pltdoc="x">Namespaces</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="eval.html" class="tocviewlink" data-pltdoc="x">Evaluation and Compilation</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="load-lang.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>load</span></span> Language</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="Module_Names_and_Loading.html" class="tocviewlink" data-pltdoc="x">Module Names and Loading</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="chaperones.html" class="tocviewlink" data-pltdoc="x">Impersonators and Chaperones</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="securityguards.html" class="tocviewlink" data-pltdoc="x">Security Guards</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="custodians.html" class="tocviewlink" data-pltdoc="x">Custodians</a></td></tr><tr><td align="right">14.8&nbsp;</td><td><a href="threadgroups.html" class="tocviewlink" data-pltdoc="x">Thread Groups</a></td></tr><tr><td align="right">14.9&nbsp;</td><td><a href="inspectors.html" class="tocviewlink" data-pltdoc="x">Structure Inspectors</a></td></tr><tr><td align="right">14.10&nbsp;</td><td><a href="modprotect.html" class="tocviewlink" data-pltdoc="x">Code Inspectors</a></td></tr><tr><td align="right">14.11&nbsp;</td><td><a href="plumbers.html" class="tocviewlink" data-pltdoc="x">Plumbers</a></td></tr><tr><td align="right">14.12&nbsp;</td><td><a href="Sandboxed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Sandboxed Evaluation</a></td></tr><tr><td align="right">14.13&nbsp;</td><td><a href="repl-module.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>repl</span></span> Library</a></td></tr><tr><td align="right">14.14&nbsp;</td><td><a href="linklets.html" class="tocviewselflink" data-pltdoc="x">Linklets and the Core Compiler</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">linklet?</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._compile-linklet%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compile-<wbr></wbr>linklet</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._recompile-linklet%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">recompile-<wbr></wbr>linklet</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._eval-linklet%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eval-<wbr></wbr>linklet</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instantiate-linklet%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">instantiate-<wbr></wbr>linklet</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-import-variables%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">linklet-<wbr></wbr>import-<wbr></wbr>variables</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-export-variables%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">linklet-<wbr></wbr>export-<wbr></wbr>variables</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-directory~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">linklet-<wbr></wbr>directory?</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._hash-~3elinklet-directory%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>&gt;linklet-<wbr></wbr>directory</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-directory-~3ehash%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">linklet-<wbr></wbr>directory-<wbr></wbr>&gt;hash</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-bundle~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">linklet-<wbr></wbr>bundle?</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._hash-~3elinklet-bundle%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>&gt;linklet-<wbr></wbr>bundle</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-bundle-~3ehash%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">linklet-<wbr></wbr>bundle-<wbr></wbr>&gt;hash</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-body-reserved-symbol~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">linklet-<wbr></wbr>body-<wbr></wbr>reserved-<wbr></wbr>symbol?</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">instance?</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._make-instance%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>instance</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-name%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">instance-<wbr></wbr>name</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-data%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">instance-<wbr></wbr>data</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-variable-names%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">instance-<wbr></wbr>variable-<wbr></wbr>names</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-variable-value%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">instance-<wbr></wbr>variable-<wbr></wbr>value</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-set-variable-value%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">instance-<wbr></wbr>set-<wbr></wbr>variable-<wbr></wbr>value!</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-unset-variable%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">instance-<wbr></wbr>unset-<wbr></wbr>variable!</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-describe-variable%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym">instance-<wbr></wbr>describe-<wbr></wbr>variable!</span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._variable-reference-~3einstance%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">variable-<wbr></wbr>reference-<wbr></wbr>&gt;instance</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">correlated?</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-source%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">correlated-<wbr></wbr>source</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-line%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">correlated-<wbr></wbr>line</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-column%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">correlated-<wbr></wbr>column</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-position%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">correlated-<wbr></wbr>position</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-span%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">correlated-<wbr></wbr>span</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-e%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">correlated-<wbr></wbr>e</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-~3edatum%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">correlated-<wbr></wbr>&gt;datum</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._datum-~3ecorrelated%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">datum-<wbr></wbr>&gt;correlated</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-property%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">correlated-<wbr></wbr>property</span></span></a></td></tr><tr><td><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-property-symbol-keys%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">correlated-<wbr></wbr>property-<wbr></wbr>symbol-<wbr></wbr>keys</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="repl-module.html" title="backward to &quot;14.13 The racket/repl Library&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="os.html" title="forward to &quot;15 Operating System&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;linklets&quot;">14.14<tt>&nbsp;</tt><a name="(part._linklets)"></a><a name="(mod-path._racket/linklet)"></a>Linklets and the Core Compiler</h4><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="linklets.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/linklet</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></p><p>A <a name="(tech._linklet)"></a><span style="font-style: italic">linklet</span> is a primitive element of compilation, bytecode
+marshaling, and evaluation. Racket&rsquo;s implementations of modules,
+macros, and top-level evaluation are all built on linklets. Racket
+programmers generally do not encounter linklets directly, but the
+<a href="linklets.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/linklet</span></a> library provides access to linklet
+facilities.</p><p>A single Racket module (or collection of top-level forms) is typically
+implemented by multiple linklets. For example, each phase of
+evaluation that exists in a module is implemented in a separate
+linklet. A linklet is also used for metadata such as the <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module
+path index</span></a>es for a module&rsquo;s <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s. These linklets, plus
+some other metadata, are combined to form a <a name="(tech._linklet._bundle)"></a><span style="font-style: italic">linklet bundle</span>.
+Information in a <a href="linklets.html#%28tech._linklet._bundle%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet bundle</span></a> is keyed by either a symbol or
+a <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a>. A <a href="linklets.html#%28tech._linklet._bundle%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet bundle</span></a> containing
+<a href="linklets.html#%28tech._linklet%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet</span></a>s can be marshaled to and from a byte stream by
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> and (with <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-compiled%29%29" class="RktValLink" data-pltdoc="x">read-accept-compiled</a></span> is enabled)
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>.</p><p>When a Racket module has submodules, the <a href="linklets.html#%28tech._linklet._bundle%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet bundles</span></a> for
+the module and the submodules are grouped together in a
+<a name="(tech._linklet._directory)"></a><span style="font-style: italic">linklet directory</span>. A <a href="linklets.html#%28tech._linklet._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet directory</span></a> can have
+nested linklet directories. Information in a linklet directory is
+keyed by <span class="RktVal">#f</span> or a symbol, where <span class="RktVal">#f</span> must be mapped to
+a <a href="linklets.html#%28tech._linklet._bundle%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet bundle</span></a> (if anything) and each symbol must be mapped
+to a <a href="linklets.html#%28tech._linklet._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet directory</span></a>. A <a href="linklets.html#%28tech._linklet._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet directory</span></a> can be
+equivalently viewed as a mapping from a lists of symbols to a
+<a href="linklets.html#%28tech._linklet._bundle%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet bundle</span></a>. Like <a href="linklets.html#%28tech._linklet._bundle%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet bundles</span></a>, a <a href="linklets.html#%28tech._linklet._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet
+directory</span></a> can be marshaled to and from a byte stream by
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> and <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>; the marshaled form allows individual
+<a href="linklets.html#%28tech._linklet._bundle%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet bundles</span></a> to be loaded independently.</p><p>A linklet consists of a set of variable definitions and expressions,
+an exported subset of the defined variable names, a set of variables to export
+from the linklet despite having no corresponding definition, and a set
+of imports that provide other variables for the linklet to use. To run
+a linklet, it is instantiated as as <a name="(tech._linklet._instance)"></a><span style="font-style: italic">linklet instance</span> (or
+just <span style="font-style: italic">instance</span>, for short). When a linklet is instantiated,
+it receives other <a href="linklets.html#%28tech._linklet._instance%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet instances</span></a> for its imports, and it
+extracts a specified set of variables that are exported from each of
+the given instances. The newly created <a href="linklets.html#%28tech._linklet._instance%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet instance</span></a>
+provides its exported variables for use by other linklets or for
+direct access via <span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-variable-value%29%29" class="RktValLink" data-pltdoc="x">instance-variable-value</a></span>. A <a href="linklets.html#%28tech._linklet._instance%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet
+instance</span></a> can be synthesized directly with <span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._make-instance%29%29" class="RktValLink" data-pltdoc="x">make-instance</a></span>.</p><p>A linklet is created by compiling an enriched S-expression
+representation of its source. Since linklets exist below the layer of
+macros and syntax objects, linklet compilation does not use
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax objects</span></a>. Instead, linklet compilation uses
+<a name="(tech._correlated._object)"></a><span style="font-style: italic">correlated objects</span>, which are like <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax objects</span></a>
+without lexical-context information and without the constraint that
+content is coerced to correlated objects. Using an S-expression or
+<a href="linklets.html#%28tech._correlated._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">correlated object</span></a>, the grammar of a linklet as recognized by
+<span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._compile-linklet%29%29" class="RktValLink" data-pltdoc="x">compile-linklet</a></span> is</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym">linklet</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">[</span><span class="RktVar">imported-id/renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVar">exported-id/renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">defn-or-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">imported-id/renamed</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">imported-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">external-imported-id</span><span class="hspace">&nbsp;</span><span class="RktVar">internal-imported-id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">exported-id/renamed</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">exported-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">internal-exported-id</span><span class="hspace">&nbsp;</span><span class="RktVar">external-exported-id</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote><p>Each import set <span class="RktPn">[</span><span class="RktVar">imported-id/renamed</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">]</span> refers to a single
+imported instance, and each <span class="RktVar">import-id/renamed</span> corresponds to
+a variable from that instance. If separate
+<span class="RktVar">external-imported-id</span> and <span class="RktVar">internal-imported-id</span> are
+specified, then <span class="RktVar">external-imported-id</span> is the name of the
+variable as exported by the instance, and
+<span class="RktVar">internal-imported-id</span> is the name used to refer to the
+variable in the <span class="RktVar">defn-or-expr</span>s. For exports, separate
+<span class="RktVar">internal-exported-id</span> and <span class="RktVar">external-exported-id</span>
+names corresponds to the variable name as exported as referenced
+in the <span class="RktVar">defn-or-expr</span>s, respectively.</p><p>The grammar of an <span class="RktVar">defn-or-expr</span> is similar to the expander&rsquo;s
+grammar of fully expanded expressions (see <a href="syntax-model.html#%28part._fully-expanded%29" data-pltdoc="x">Fully Expanded Programs</a>)
+with some exceptions: <span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span> and <span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span> are not allowed;
+<span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-lambda%29%29" class="RktStxLink" data-pltdoc="x">#%plain-lambda</a></span> is spelled <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span>;
+<span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-app%29%29" class="RktStxLink" data-pltdoc="x">#%plain-app</a></span> is omitted (i.e., application is implicit);
+<span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span>, <span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span>, <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span>, and
+<span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-values%29%29" class="RktStxLink" data-pltdoc="x">letrec-values</a></span> can have only a single body expression; and
+numbers, booleans, strings, and byte strings are self-quoting.
+Primitives are accessed directly by name, and shadowing is not allowed
+within a <span class="RktSym">linklet</span> form for primitive names (see
+<span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-body-reserved-symbol~3f%29%29" class="RktValLink" data-pltdoc="x">linklet-body-reserved-symbol?</a></span>), imported variables, defined
+variables, or local variables.</p><p>When an <span class="RktVar">exported-id/renamed</span> has no corresponding definition
+among the <span class="RktVar">defn-or-expr</span>s, then the variable is effectively
+defined as uninitialized; referencing the variable will trigger
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3avariable%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:variable</a></span>, the same as referencing a
+variable before it is defined. When a target instance is provided to
+<span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instantiate-linklet%29%29" class="RktValLink" data-pltdoc="x">instantiate-linklet</a></span>, any existing variable with the same name
+will be left as-is, instead of set to undefined. This treatment of
+uninitialized variables provides core support for top-level evaluation
+where variables may be referenced and then defined in a separate
+element of compilation.</p><p class="SHistory">Added in version 6.90.0.1 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._linklet~3f))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">linklet?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="linklets.html#%28tech._linklet%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet</span></a>, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._compile-linklet))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._compile-linklet%29%29" class="RktValDef RktValLink" data-pltdoc="x">compile-linklet</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">form</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">import-keys</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">get-import</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">options</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet~3f%29%29" class="RktValLink" data-pltdoc="x">linklet?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated~3f%29%29" class="RktValLink" data-pltdoc="x">correlated?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">import-keys</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">get-import</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">options</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">serializable</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">unsafe</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">static</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">quick</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">use-prompt</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">uninterned-literal</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">serializable</span><span class="RktVal">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="RktPn">(</span><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._compile-linklet%29%29" class="RktValDef RktValLink" data-pltdoc="x">compile-linklet</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">form</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">import-keys</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">get-import</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">options</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet~3f%29%29" class="RktValLink" data-pltdoc="x">linklet?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated~3f%29%29" class="RktValLink" data-pltdoc="x">correlated?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">import-keys</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">get-import</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet~3f%29%29" class="RktValLink" data-pltdoc="x">linklet?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance~3f%29%29" class="RktValLink" data-pltdoc="x">instance?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">options</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">serializable</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">unsafe</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">static</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">quick</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">use-prompt</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">uninterned-literal</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">serializable</span><span class="RktVal">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Takes an S-expression or <a href="linklets.html#%28tech._correlated._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">correlated object</span></a> for a
+<span class="RktSym">linklet</span> form and produces a <a href="linklets.html#%28tech._linklet%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet</span></a>.
+As long as <span class="RktVal">'</span><span class="RktVal">serializable</span> included in <span class="RktVar">options</span>, the
+resulting linklet can be marshaled to and from a byte stream when it is
+part of a <a href="linklets.html#%28tech._linklet._bundle%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet bundle</span></a> (possibly in a <a href="linklets.html#%28tech._linklet._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet directory</span></a>).</div></p><p>The optional <span class="RktVar">name</span> is associated to the linklet for debugging
+purposes and as the default name of the linklet&rsquo;s instance.</p><p>The optional <span class="RktVar">import-keys</span> and <span class="RktVar">get-import</span> arguments
+support cross-linklet optimization. If <span class="RktVar">import-keys</span> is a
+vector, it must have as many elements as sets of imports in
+<span class="RktVar">form</span>. If the compiler becomes interested in optimizing a
+reference to an imported variable, it passes back to
+<span class="RktVar">get-import</span> (if non-<span class="RktVal">#f</span>) the element of <span class="RktVar">import-keys</span> that
+corresponds to the variable&rsquo;s import set. The <span class="RktVar">get-import</span>
+function can then return a linklet or instance that represents an instance to be
+provided to the compiled linklet when it is eventually instantiated;
+ensuring consistency between reported linklet or instance and the eventual
+instance is up to the caller of <span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._compile-linklet%29%29" class="RktValLink" data-pltdoc="x">compile-linklet</a></span>. If
+<span class="RktVar">get-import</span> returns <span class="RktVal">#f</span> as its first value, the
+compiler will be prevented from making any assumptions about the
+imported instance. The second result from <span class="RktVar">get-import</span> is an
+optional vector of keys to provide transitive information on a
+returned linklet&rsquo;s imports (and is not allowed for a returned instance);
+the returned vector must have the same
+number of elements as the linklet has imports. When vector elements
+are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> and non-<span class="RktVal">#f</span>, the compiler can assume that
+they correspond to the same run-time instance. A <span class="RktVal">#f</span>
+value for <span class="RktVar">get-import</span> is equivalent to a function that
+always returns two <span class="RktVal">#f</span> results.</p><p>When <span class="RktVar">import-keys</span> is not <span class="RktVal">#f</span>, then the compiler is
+allowed to grow or shrink the set of imported instances for the
+linklet. The result vector specifies the keys of the imports for the
+returned linklet. Any key that is <span class="RktVal">#f</span> or a <a href="linklets.html#%28tech._linklet._instance%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet instance</span></a>
+must be preserved intact, however.</p><p>If <span class="RktVal">'</span><span class="RktVal">unsafe</span> is included in <span class="RktVar">options</span>, then the linklet
+is compiled in <a name="(tech._unsafe._mode)"></a><span style="font-style: italic">unsafe mode</span>: uses of safe operations within
+the linklet can be converted to unsafe operations on the assumption
+that the relevant contracts are satisfied. For example, <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span>
+is converted to <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-car%29%29" class="RktValLink" data-pltdoc="x">unsafe-car</a></span>. Some substituted unsafe
+operations may not have directly accessible names, such as the unsafe
+variant of <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="RktValLink" data-pltdoc="x">in-list</a></span> that can be substituted in <a href="linklets.html#%28tech._unsafe._mode%29" class="techoutside" data-pltdoc="x"><span class="techinside">unsafe
+mode</span></a>. An unsafe operation is substituted only if its (unchecked)
+contract is subsumed by the safe operation&rsquo;s contract. The fact that
+the linklet is compiled in <a href="linklets.html#%28tech._unsafe._mode%29" class="techoutside" data-pltdoc="x"><span class="techinside">unsafe mode</span></a> can be exposed through
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-from-unsafe~3f%29%29" class="RktValLink" data-pltdoc="x">variable-reference-from-unsafe?</a></span> using a variable reference
+produced by a <span class="RktSym"><a href="Locations____variable-reference.html#%28form._%28%28quote._~23~25kernel%29._~23~25variable-reference%29%29" class="RktStxLink" data-pltdoc="x">#%variable-reference</a></span> form within the module
+body.</p><p>If <span class="RktVal">'</span><span class="RktVal">static</span> is included in <span class="RktVar">options</span>, then the linklet
+must be instantiated only once; if the linklet is serialized, then any
+individual instance read from the serialized form must be instantiated
+at most once. Compilation with <span class="RktVal">'</span><span class="RktVal">static</span> is intended to improve
+the performance of references within the linklet to defined and
+imported variables.</p><p>If <span class="RktVal">'</span><span class="RktVal">quick</span> is included in <span class="RktVar">options</span>, then linklet
+compilation may trade run-time performance for compile-time
+performance&#8212;<wbr></wbr>that is, spend less time compiling the linklet, but the
+resulting linklet may run more slowly.</p><p>If <span class="RktVal">'</span><span class="RktVal">use-prompt</span> is included in <span class="RktVar">options</span>, then
+instantiating resulting linklet always wraps a prompt around each
+definition and immediate expression in the linklet. Otherwise,
+supplying <span class="RktVal">#t</span> as the <span class="RktVar">use-prompt?</span> argument to
+<span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instantiate-linklet%29%29" class="RktValLink" data-pltdoc="x">instantiate-linklet</a></span> may only wrap a prompt around the entire
+instantiation.</p><p>If <span class="RktVal">'</span><span class="RktVal">uninterned-literal</span> is included in <span class="RktVar">options</span>, then
+literals in <span class="RktVar">form</span> will not necessarily be interned via
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-intern-literal%29%29" class="RktValLink" data-pltdoc="x">datum-intern-literal</a></span> when compiling or loading the linklet.
+Disabling the use of <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-intern-literal%29%29" class="RktValLink" data-pltdoc="x">datum-intern-literal</a></span> can be especially
+useful of the linklet includes a large string or byte string constant
+that is not meant to be shared.</p><p>The symbols in <span class="RktVar">options</span> must be distinct, otherwise
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p class="SHistory">Changed in version 7.1.0.8 of package <span class="stt">base</span>: Added the <span class="RktVal">'</span><span class="RktVal">use-prompt</span> option.<br/>Changed in version 7.1.0.10: Added the <span class="RktVal">'</span><span class="RktVal">uninterned-literal</span> option.<br/>Changed in version 7.5.0.14: Added the <span class="RktVal">'</span><span class="RktVal">quick</span> option.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._recompile-linklet))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._recompile-linklet%29%29" class="RktValDef RktValLink" data-pltdoc="x">recompile-linklet</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">linklet</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">import-keys</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">get-import</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">options</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet~3f%29%29" class="RktValLink" data-pltdoc="x">linklet?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">linklet</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet~3f%29%29" class="RktValLink" data-pltdoc="x">linklet?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">import-keys</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">get-import</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">options</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">serializable</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">unsafe</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">static</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">quick</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">use-prompt</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">uninterned-literal</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">serializable</span><span class="RktVal">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="RktPn">(</span><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._recompile-linklet%29%29" class="RktValDef RktValLink" data-pltdoc="x">recompile-linklet</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">linklet</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">import-keys</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">get-import</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">options</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet~3f%29%29" class="RktValLink" data-pltdoc="x">linklet?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">linklet</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet~3f%29%29" class="RktValLink" data-pltdoc="x">linklet?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">import-keys</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">get-import</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet~3f%29%29" class="RktValLink" data-pltdoc="x">linklet?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">import-key</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">options</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">serializable</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">unsafe</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">static</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">quick</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">use-prompt</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">uninterned-literal</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">serializable</span><span class="RktVal">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._compile-linklet%29%29" class="RktValLink" data-pltdoc="x">compile-linklet</a></span>, but takes an already-compiled linklet
+and potentially optimizes it further.</div></p><p class="SHistory">Changed in version 7.1.0.6 of package <span class="stt">base</span>: Added the <span class="RktVar">options</span> argument.<br/>Changed in version 7.1.0.8: Added the <span class="RktVal">'</span><span class="RktVal">use-prompt</span> option.<br/>Changed in version 7.1.0.10: Added the <span class="RktVal">'</span><span class="RktVal">uninterned-literal</span> option.<br/>Changed in version 7.5.0.14: Added the <span class="RktVal">'</span><span class="RktVal">quick</span> option.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._eval-linklet))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._eval-linklet%29%29" class="RktValDef RktValLink" data-pltdoc="x">eval-linklet</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">linklet</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet~3f%29%29" class="RktValLink" data-pltdoc="x">linklet?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">linklet</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet~3f%29%29" class="RktValLink" data-pltdoc="x">linklet?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a variant of a <span class="RktVar">linklet</span> that is prepared for JIT
+compilation such that every later use of the result linklet with
+<span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instantiate-linklet%29%29" class="RktValLink" data-pltdoc="x">instantiate-linklet</a></span> shares the JIT-generated code. However,
+the result of <span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._eval-linklet%29%29" class="RktValLink" data-pltdoc="x">eval-linklet</a></span> cannot be marshaled to a byte
+stream as part of a <a href="linklets.html#%28tech._linklet._bundle%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet bundle</span></a>, and it cannot be used with
+<span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._recompile-linklet%29%29" class="RktValLink" data-pltdoc="x">recompile-linklet</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._instantiate-linklet))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instantiate-linklet%29%29" class="RktValDef RktValLink" data-pltdoc="x">instantiate-linklet</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">linklet</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">import-instances</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">target-instance?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">use-prompt?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance~3f%29%29" class="RktValLink" data-pltdoc="x">instance?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">linklet</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet~3f%29%29" class="RktValLink" data-pltdoc="x">linklet?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">import-instances</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance~3f%29%29" class="RktValLink" data-pltdoc="x">instance?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">target-instance?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">use-prompt?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="RktPn">(</span><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instantiate-linklet%29%29" class="RktValDef RktValLink" data-pltdoc="x">instantiate-linklet</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">linklet</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">import-instances</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">target-instance</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">use-prompt?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">linklet</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet~3f%29%29" class="RktValLink" data-pltdoc="x">linklet?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">import-instances</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance~3f%29%29" class="RktValLink" data-pltdoc="x">instance?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">target-instance</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance~3f%29%29" class="RktValLink" data-pltdoc="x">instance?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">use-prompt?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Instantiates <span class="RktVar">linklet</span> by running its definitions and
+expressions, using the given <span class="RktVar">import-instances</span> for its
+imports. The number of instances in <span class="RktVar">import-instances</span> must
+match the number of import sets in <span class="RktVar">linklet</span>.</div></p><p>If <span class="RktVar">target-instance</span> is <span class="RktVal">#f</span> or not provided, the result
+is a fresh instance for the linklet. If <span class="RktVar">target-instance</span> is an
+instance, then the instance is used and modified for the linklet
+definitions and expressions, and the result is the value of the last
+expression in the linklet.</p><p>The linklet&rsquo;s exported variables are accessible in the result instance
+or in <span class="RktVar">target-instance</span> using the linklet&rsquo;s external name for
+each export. If <span class="RktVar">target-instance</span> is provided as
+non-<span class="RktVal">#f</span>, its existing variables remain intact if they are not
+modified by a linklet definition.</p><p>If <span class="RktVar">use-prompt?</span> is true, then a a <a href="eval-model.html#%28tech._prompt%29" class="techoutside" data-pltdoc="x"><span class="techinside">prompt</span></a> is wrapped
+around the linklet instantiation in same ways as an expression in a
+module body. If the linklet contains multiple definitions or immediate
+expressions, then a prompt may or may not be wrapped around each
+definition or expression; supply <span class="RktVal">'</span><span class="RktVal">use-prompt</span> to
+<span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._compile-linklet%29%29" class="RktValLink" data-pltdoc="x">compile-linklet</a></span> to ensure that a prompt is used around each
+definition and expression.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._linklet-import-variables))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-import-variables%29%29" class="RktValDef RktValLink" data-pltdoc="x">linklet-import-variables</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">linklet</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">linklet</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet~3f%29%29" class="RktValLink" data-pltdoc="x">linklet?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a description of a linklet&rsquo;s imports. Each element of the
+result list corresponds to an import set as satisfied by a single
+instance on instantiation, and each member of the set is a variable
+name that is used from the corresponding imported instance.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._linklet-export-variables))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-export-variables%29%29" class="RktValDef RktValLink" data-pltdoc="x">linklet-export-variables</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">linklet</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">linklet</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet~3f%29%29" class="RktValLink" data-pltdoc="x">linklet?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a description of a linklet&rsquo;s exports. Each element of the list
+corresponds to a variable that is made available by the linklet in its
+instance.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._linklet-directory~3f))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-directory~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">linklet-directory?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="linklets.html#%28tech._linklet._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet directory</span></a>,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._hash-~3elinklet-directory))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._hash-~3elinklet-directory%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-&gt;linklet-directory</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">content</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-directory~3f%29%29" class="RktValLink" data-pltdoc="x">linklet-directory?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">content</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-eq~3f%29%29" class="RktValLink" data-pltdoc="x">hash-eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Constructs a <a href="linklets.html#%28tech._linklet._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet directory</span></a> given mappings in the form of a
+<a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash table</span></a>. Each key of <span class="RktVar">content</span> must be either a
+symbol or <span class="RktVal">#f</span>, each symbol must be mapped to a <a href="linklets.html#%28tech._linklet._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet
+directory</span></a>, and <span class="RktVal">#f</span> must be mapped to a <a href="linklets.html#%28tech._linklet._bundle%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet bundle</span></a>
+or not mapped.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._linklet-directory-~3ehash))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-directory-~3ehash%29%29" class="RktValDef RktValLink" data-pltdoc="x">linklet-directory-&gt;hash</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">linklet-directory</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-eq~3f%29%29" class="RktValLink" data-pltdoc="x">hash-eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">linklet-directory</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-directory~3f%29%29" class="RktValLink" data-pltdoc="x">linklet-directory?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Extracts the content of a <a href="linklets.html#%28tech._linklet._directory%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet directory</span></a> into a <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash
+table</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._linklet-bundle~3f))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-bundle~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">linklet-bundle?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="linklets.html#%28tech._linklet._bundle%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet bundle</span></a>,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._hash-~3elinklet-bundle))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._hash-~3elinklet-bundle%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-&gt;linklet-bundle</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">content</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-bundle~3f%29%29" class="RktValLink" data-pltdoc="x">linklet-bundle?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">content</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-eq~3f%29%29" class="RktValLink" data-pltdoc="x">hash-eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Constructs a <a href="linklets.html#%28tech._linklet._bundle%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet bundle</span></a> given mappings in the form of a
+<a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash table</span></a>. Each key of <span class="RktVar">content</span> must be either a
+symbol or a <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a>. Values in the hash table are unconstrained,
+but the intent is that they are all <a href="linklets.html#%28tech._linklet%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklets</span></a> or values that can
+be recovered from <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> output by <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._linklet-bundle-~3ehash))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-bundle-~3ehash%29%29" class="RktValDef RktValLink" data-pltdoc="x">linklet-bundle-&gt;hash</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">linklet-bundle</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-eq~3f%29%29" class="RktValLink" data-pltdoc="x">hash-eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">linklet-bundle</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-bundle~3f%29%29" class="RktValLink" data-pltdoc="x">linklet-bundle?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Extracts the content of a <a href="linklets.html#%28tech._linklet._bundle%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet bundle</span></a> into a <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash
+table</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._linklet-body-reserved-symbol~3f))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._linklet-body-reserved-symbol~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">linklet-body-reserved-symbol?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sym</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Return <span class="RktVal">#t</span> if <span class="RktVar">sym</span> is a primitive name or other
+identifier that is not allowed as a binding within a linklet,
+<span class="RktVal">#f</span> otherwise.</div></p><p class="SHistory">Added in version 8.2.0.1 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._instance~3f))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">instance?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="linklets.html#%28tech._linklet._instance%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet instance</span></a>,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._make-instance))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._make-instance%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-instance</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">data</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">mode</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">variable-name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">variable-value</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance~3f%29%29" class="RktValLink" data-pltdoc="x">instance?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">data</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">constant</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">consistent</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">variable-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">variable-value</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Constructs a <a href="linklets.html#%28tech._linklet._instance%29" class="techoutside" data-pltdoc="x"><span class="techinside">linklet instance</span></a> directly. Besides associating an
+arbitrary <span class="RktVar">name</span> and <span class="RktVar">data</span> value to the instance, the
+instance is populated with variables as specified by
+<span class="RktVar">variable-name</span> and <span class="RktVar">variable-value</span>.</div></p><p>The optional <span class="RktVar">data</span> and <span class="RktVar">mode</span> arguments must be
+provided if any <span class="RktVar">variable-name</span> and <span class="RktVar">variable-value</span>
+arguments are provided. The <span class="RktVar">mode</span> argument is used as in
+<span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-set-variable-value%21%29%29" class="RktValLink" data-pltdoc="x">instance-set-variable-value!</a></span> for every
+<span class="RktVar">variable-name</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._instance-name))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-name%29%29" class="RktValDef RktValLink" data-pltdoc="x">instance-name</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">instance</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">instance</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance~3f%29%29" class="RktValLink" data-pltdoc="x">instance?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the value associated to <span class="RktVar">instance</span> as its name&#8212;<wbr></wbr>either
+the first value provided to <span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._make-instance%29%29" class="RktValLink" data-pltdoc="x">make-instance</a></span> or the name of a
+linklet that was instantiated to create the instance.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._instance-data))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-data%29%29" class="RktValDef RktValLink" data-pltdoc="x">instance-data</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">instance</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">instance</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance~3f%29%29" class="RktValLink" data-pltdoc="x">instance?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the value associated to <span class="RktVar">instance</span> as its data&#8212;<wbr></wbr>either
+the second value provided to <span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._make-instance%29%29" class="RktValLink" data-pltdoc="x">make-instance</a></span> or the default
+<span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._instance-variable-names))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-variable-names%29%29" class="RktValDef RktValLink" data-pltdoc="x">instance-variable-names</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">instance</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">instance</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance~3f%29%29" class="RktValLink" data-pltdoc="x">instance?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of all names for all variables accessible from
+<span class="RktVar">instance</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._instance-variable-value))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-variable-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">instance-variable-value</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">instance</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">fail-k</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">instance</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance~3f%29%29" class="RktValLink" data-pltdoc="x">instance?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fail-k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the value of the variable exported as <span class="RktVar">name</span> from
+<span class="RktVar">instance</span>. If no such variable is exported, then
+<span class="RktVar">fail-k</span> is used in the same way as by <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._instance-set-variable-value!))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-set-variable-value%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">instance-set-variable-value!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">instance</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">mode</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">instance</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance~3f%29%29" class="RktValLink" data-pltdoc="x">instance?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">constant</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">consistent</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Sets or creates the variable exported as <span class="RktVar">name</span> in
+<span class="RktVar">instance</span> so that its value is <span class="RktVar">v</span>, as long as the
+variable does not exist already as constant. If a variable for
+<span class="RktVar">name</span> exists as constant, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p>If <span class="RktVar">mode</span> is <span class="RktVal">'</span><span class="RktVal">constant</span> or <span class="RktVal">'</span><span class="RktVal">consistent</span>, then
+the variable is created or changed to be constant. Furthermore, when
+the instance is reported for a linklet&rsquo;s import though a
+<span class="RktVar">get-import</span> callback to <span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._compile-linklet%29%29" class="RktValLink" data-pltdoc="x">compile-linklet</a></span>, the
+compiler can assume that the variable will be constant in all future
+instances that are used to satisfy a linklet&rsquo;s imports.</p><p>If <span class="RktVar">mode</span> is <span class="RktVal">'</span><span class="RktVal">consistent</span>, when the instance is
+reported though a callback to <span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._compile-linklet%29%29" class="RktValLink" data-pltdoc="x">compile-linklet</a></span>, the compiler
+can further assume that the variable&rsquo;s value will be the same for
+future instances. For compilation purposes, &ldquo;the same&rdquo; can mean that
+a procedure value will have the same arity and implementation details,
+a <a href="structures.html#%28tech._structure._type%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type</span></a> value will have the same configuration, a
+marshalable constant will be <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to the current value, and
+so on.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._instance-unset-variable!))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance-unset-variable%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">instance-unset-variable!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">instance</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">instance</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance~3f%29%29" class="RktValLink" data-pltdoc="x">instance?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Changes <span class="RktVar">instance</span> so that it does not export a variable as
+<span class="RktVar">name</span>, as long as <span class="RktVar">name</span> does not exist as a constant
+variable. If a variable for <span class="RktVar">name</span> exists as constant, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._instance-describe-variable!))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><span class="RktSymDef RktSym">instance-describe-variable!</span></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">instance</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">desc-v</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">instance</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance~3f%29%29" class="RktValLink" data-pltdoc="x">instance?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">desc-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Registers information about <span class="RktVar">name</span> in <span class="RktVar">instance</span> that
+may be useful for compiling linklets where the instance is return via
+the <span class="RktVar">get-import</span> callback to <span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._compile-linklet%29%29" class="RktValLink" data-pltdoc="x">compile-linklet</a></span>. The
+<span class="RktVar">desc-v</span> description can be any value; the recognized
+descriptions depend on virtual machine, but may include the following:</div></p><ul><li><p><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">procedure</span><span class="stt"> </span><span class="RktRdr">,</span><span class="RktSym">arity-mask</span><span class="RktVal">)</span> &#8212;<wbr></wbr> the value is always a
+procedure that is not impersonated and not a structure, and its
+arity in the style of <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity-mask%29%29" class="RktValLink" data-pltdoc="x">procedure-arity-mask</a></span> is
+<span class="RktSym">arity-mask</span>.</p></li><li><p><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">procedure/succeeds</span><span class="stt"> </span><span class="RktRdr">,</span><span class="RktSym">arity-mask</span><span class="RktVal">)</span> &#8212;<wbr></wbr> like
+<span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">procedure</span><span class="stt"> </span><span class="RktRdr">,</span><span class="RktSym">arity-mask</span><span class="RktVal">)</span>, but for a procedure that
+never raises an exception of otherwise captures or escapes the
+calling context.</p></li><li><p><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">procedure/pure</span><span class="stt"> </span><span class="RktRdr">,</span><span class="RktSym">arity-mask</span><span class="RktVal">)</span> &#8212;<wbr></wbr> like
+<span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">procedure/succeeds</span><span class="stt"> </span><span class="RktRdr">,</span><span class="RktSym">arity-mask</span><span class="RktVal">)</span>, but with no
+observable side effects, so a call to the procedure can be
+reordered.</p></li></ul><p class="SHistory">Added in version 7.1.0.8 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._variable-reference-~3einstance))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._variable-reference-~3einstance%29%29" class="RktValDef RktValLink" data-pltdoc="x">variable-reference-&gt;instance</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">varref</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">ref-site?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktVar">ref-site?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance~3f%29%29" class="RktValLink" data-pltdoc="x">instance?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._instance~3f%29%29" class="RktValLink" data-pltdoc="x">instance?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">varref</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference~3f%29%29" class="RktValLink" data-pltdoc="x">variable-reference?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ref-site?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Extracts the instance where the variable of <span class="RktVar">varref</span> is defined
+if <span class="RktVar">ref-site?</span> is <span class="RktVal">#f</span>, and returns the instance where
+<span class="RktVar">varref</span> itself resides if <span class="RktVar">ref-site?</span> is true. This
+notion of <a href="Locations____variable-reference.html#%28tech._variable._reference%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable reference</span></a> is the same as at the module level
+and can reflect the linklet instance that implements a particular
+phase of a module instance.</div></p><p>When <span class="RktVar">ref-site?</span> is <span class="RktVal">#f</span>, the result is <span class="RktVal">#f</span> when
+<span class="RktVar">varref</span> is from <span class="RktPn">(</span><span class="RktSym"><a href="Locations____variable-reference.html#%28form._%28%28quote._~23~25kernel%29._~23~25variable-reference%29%29" class="RktStxLink" data-pltdoc="x">#%variable-reference</a></span><span class="RktPn">)</span> with no
+identifier. The result is a symbol if <span class="RktVar">varref</span> refers to a
+primitive.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._correlated~3f))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">correlated?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._correlated-source))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-source%29%29" class="RktValDef RktValLink" data-pltdoc="x">correlated-source</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">crlt</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">crlt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated~3f%29%29" class="RktValLink" data-pltdoc="x">correlated?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._correlated-line))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-line%29%29" class="RktValDef RktValLink" data-pltdoc="x">correlated-line</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">crlt</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">crlt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated~3f%29%29" class="RktValLink" data-pltdoc="x">correlated?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._correlated-column))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-column%29%29" class="RktValDef RktValLink" data-pltdoc="x">correlated-column</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">crlt</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">crlt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated~3f%29%29" class="RktValLink" data-pltdoc="x">correlated?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._correlated-position))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-position%29%29" class="RktValDef RktValLink" data-pltdoc="x">correlated-position</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">crlt</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">crlt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated~3f%29%29" class="RktValLink" data-pltdoc="x">correlated?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._correlated-span))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-span%29%29" class="RktValDef RktValLink" data-pltdoc="x">correlated-span</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">crlt</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">crlt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated~3f%29%29" class="RktValLink" data-pltdoc="x">correlated?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._correlated-e))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-e%29%29" class="RktValDef RktValLink" data-pltdoc="x">correlated-e</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">crlt</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">crlt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated~3f%29%29" class="RktValLink" data-pltdoc="x">correlated?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._correlated-~3edatum))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-~3edatum%29%29" class="RktValDef RktValLink" data-pltdoc="x">correlated-&gt;datum</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">crlt</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">crlt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated~3f%29%29" class="RktValLink" data-pltdoc="x">correlated?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._datum-~3ecorrelated))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._datum-~3ecorrelated%29%29" class="RktValDef RktValLink" data-pltdoc="x">datum-&gt;correlated</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">srcloc</span><span class="hspace">&nbsp;</span><span class="RktVar">prop</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated~3f%29%29" class="RktValLink" data-pltdoc="x">correlated?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">srcloc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated~3f%29%29" class="RktValLink" data-pltdoc="x">correlated?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector%2Fc%29%29" class="RktValLink" data-pltdoc="x">vector/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated~3f%29%29" class="RktValLink" data-pltdoc="x">correlated?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._correlated-property))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-property%29%29" class="RktValDef RktValLink" data-pltdoc="x">correlated-property</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">crlt</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated~3f%29%29" class="RktValLink" data-pltdoc="x">correlated?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">crlt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated~3f%29%29" class="RktValLink" data-pltdoc="x">correlated?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-property%29%29" class="RktValDef RktValLink" data-pltdoc="x">correlated-property</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">crlt</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">crlt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated~3f%29%29" class="RktValLink" data-pltdoc="x">correlated?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/linklet..rkt)._correlated-property-symbol-keys))"></a><span title="Provided from: racket/linklet | Package: base"><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-property-symbol-keys%29%29" class="RktValDef RktValLink" data-pltdoc="x">correlated-property-symbol-keys</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">crlt</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">crlt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated~3f%29%29" class="RktValLink" data-pltdoc="x">correlated?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span>, <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-source%29%29" class="RktValLink" data-pltdoc="x">syntax-source</a></span>, <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-line%29%29" class="RktValLink" data-pltdoc="x">syntax-line</a></span>,
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-column%29%29" class="RktValLink" data-pltdoc="x">syntax-column</a></span>, <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-position%29%29" class="RktValLink" data-pltdoc="x">syntax-position</a></span>,
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-span%29%29" class="RktValLink" data-pltdoc="x">syntax-span</a></span>, <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span>, <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span>,
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span>, <span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property%29%29" class="RktValLink" data-pltdoc="x">syntax-property</a></span>, and
+<span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property-symbol-keys%29%29" class="RktValLink" data-pltdoc="x">syntax-property-symbol-keys</a></span>, but for <a href="linklets.html#%28tech._correlated._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">correlated
+objects</span></a>.</div></p><p>Unlike <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span>, <span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._datum-~3ecorrelated%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;correlated</a></span> does not
+recur through the given S-expression and convert pieces to
+<a href="linklets.html#%28tech._correlated._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">correlated objects</span></a>. Instead, a <a href="linklets.html#%28tech._correlated._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">correlated object</span></a> is
+simply wrapped around the immediate value. In contrast,
+<span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._correlated-~3edatum%29%29" class="RktValLink" data-pltdoc="x">correlated-&gt;datum</a></span> recurs through its argument (which is not
+necessarily a <a href="linklets.html#%28tech._correlated._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">correlated object</span></a>) to discover any
+<a href="linklets.html#%28tech._correlated._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">correlated objects</span></a> and convert them to plain S-expressions.</p><p class="SHistory">Changed in version 7.6.0.6 of package <span class="stt">base</span>: Added the <span class="RktVar">prop</span> argument
+to <span class="RktSym"><a href="linklets.html#%28def._%28%28lib._racket%2Flinklet..rkt%29._datum-~3ecorrelated%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;correlated</a></span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="repl-module.html" title="backward to &quot;14.13 The racket/repl Library&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="os.html" title="forward to &quot;15 Operating System&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/load-lang.html b/clones/docs.racket-lang.org/reference/load-lang.html
new file mode 100644
index 00000000..9a1df51c
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/load-lang.html
@@ -0,0 +1,24 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14.3&nbsp;The racket/load Language</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewselflink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Namespaces.html" class="tocviewlink" data-pltdoc="x">Namespaces</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="eval.html" class="tocviewlink" data-pltdoc="x">Evaluation and Compilation</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="load-lang.html" class="tocviewselflink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>load</span></span> Language</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="Module_Names_and_Loading.html" class="tocviewlink" data-pltdoc="x">Module Names and Loading</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="chaperones.html" class="tocviewlink" data-pltdoc="x">Impersonators and Chaperones</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="securityguards.html" class="tocviewlink" data-pltdoc="x">Security Guards</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="custodians.html" class="tocviewlink" data-pltdoc="x">Custodians</a></td></tr><tr><td align="right">14.8&nbsp;</td><td><a href="threadgroups.html" class="tocviewlink" data-pltdoc="x">Thread Groups</a></td></tr><tr><td align="right">14.9&nbsp;</td><td><a href="inspectors.html" class="tocviewlink" data-pltdoc="x">Structure Inspectors</a></td></tr><tr><td align="right">14.10&nbsp;</td><td><a href="modprotect.html" class="tocviewlink" data-pltdoc="x">Code Inspectors</a></td></tr><tr><td align="right">14.11&nbsp;</td><td><a href="plumbers.html" class="tocviewlink" data-pltdoc="x">Plumbers</a></td></tr><tr><td align="right">14.12&nbsp;</td><td><a href="Sandboxed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Sandboxed Evaluation</a></td></tr><tr><td align="right">14.13&nbsp;</td><td><a href="repl-module.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>repl</span></span> Library</a></td></tr><tr><td align="right">14.14&nbsp;</td><td><a href="linklets.html" class="tocviewlink" data-pltdoc="x">Linklets and the Core Compiler</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="eval.html" title="backward to &quot;14.2 Evaluation and Compilation&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Module_Names_and_Loading.html" title="forward to &quot;14.4 Module Names and Loading&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;load-lang&quot;">14.3<tt>&nbsp;</tt><a name="(part._load-lang)"></a><a name="(mod-path._racket/load)"></a>The <a href="load-lang.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/load</span></a> Language</h4><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="load-lang.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/load</span></a></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></p><p>The <a href="load-lang.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/load</span></a> language supports evaluation where
+each top-level form in the module body is separately passed to
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span> in the same way as for <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%29%29" class="RktValLink" data-pltdoc="x">load</a></span>.</p><p>The namespace for evaluation shares the <a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module registry</span></a> with
+the <a href="load-lang.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/load</span></a> module instance, but it has a separate
+top-level environment, and it is initialized with the bindings of
+<a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>. A single namespace is created for each
+instance of the <a href="load-lang.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/load</span></a> module (i.e., multiple
+modules using the <a href="load-lang.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/load</span></a> language share a
+namespace). The <span class="RktSym">racket/load</span> library exports only
+<span class="RktSym">#%module-begin</span> and <span class="RktSym">#%top-interaction</span>
+forms that effectively swap in the evaluation namespace and call
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span>.</p><p>For example, the body of a module using <span class="RktSym">racket/load</span> can
+include <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> forms, so that running the following module
+prints <span class="RktRes">5</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="load-lang.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/load</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">m</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">n</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Definitions in a module using <span class="RktSym">racket/load</span> are evaluated in
+the current namespace, which means that <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%29%29" class="RktValLink" data-pltdoc="x">load</a></span> and
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span> can see the definitions. For example, running the
+following module prints <span class="RktRes">6</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="load-lang.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/load</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Since all forms within a <a href="load-lang.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/load</span></a> module are
+evaluated in the top level, bindings cannot be exported from the
+module using <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span>. Similarly, since evaluation of the
+module-body forms is inherently dynamic, compilation of the module
+provides essentially no benefit. For these reasons, use
+<a href="load-lang.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/load</span></a> for interactive exploration of top-level
+forms only, and not for constructing larger programs.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="eval.html" title="backward to &quot;14.2 Evaluation and Compilation&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Module_Names_and_Loading.html" title="forward to &quot;14.4 Module Names and Loading&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/local.html b/clones/docs.racket-lang.org/reference/local.html
new file mode 100644
index 00000000..411b0886
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/local.html
@@ -0,0 +1,9 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.10&nbsp;Local Definitions: local</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewselflink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="local.html#%28form._%28%28lib._racket%2Flocal..rkt%29._local%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="let.html" title="backward to &quot;3.9 Local Binding: let, let*, letrec, ...&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="shared.html" title="forward to &quot;3.11 Constructing Graphs: shared&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;local&quot;">3.10<tt>&nbsp;</tt><a name="(part._local)"></a><a name="(mod-path._racket/local)"></a>Local Definitions: <span class="RktSym"><a href="local.html#%28form._%28%28lib._racket%2Flocal..rkt%29._local%29%29" class="RktStxLink" data-pltdoc="x">local</a></span></h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="local.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/local</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="local.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/local</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/local..rkt)._local))"></a><span title="Provided from: racket/local, racket | Package: base"><span class="RktSym"><a href="local.html#%28form._%28%28lib._racket%2Flocal..rkt%29._local%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">local</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">definition</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span>, except that the bindings are
+expressed in the same way as in the top-level or in a module body:
+using <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span>, <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span>, <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span>,
+<span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>, etc.  Definitions are distinguished from
+non-definitions by partially expanding <span class="RktVar">definition</span> forms (see
+<a href="syntax-model.html#%28part._partial-expansion%29" data-pltdoc="x">Partial Expansion</a>). As in the top-level or in a module
+body, a <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span>-wrapped sequence is spliced into the sequence
+of <span class="RktVar">definition</span>s.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="let.html" title="backward to &quot;3.9 Local Binding: let, let*, letrec, ...&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="shared.html" title="forward to &quot;3.11 Constructing Graphs: shared&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/logging.html b/clones/docs.racket-lang.org/reference/logging.html
new file mode 100644
index 00000000..514a4c02
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/logging.html
@@ -0,0 +1,155 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15.5&nbsp;Logging</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewselflink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewlink" data-pltdoc="x">Paths</a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="Filesystem.html" class="tocviewlink" data-pltdoc="x">Filesystem</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="networking.html" class="tocviewlink" data-pltdoc="x">Networking</a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="subprocess.html" class="tocviewlink" data-pltdoc="x">Processes</a></td></tr><tr><td align="right">15.5&nbsp;</td><td><a href="logging.html" class="tocviewselflink" data-pltdoc="x">Logging</a></td></tr><tr><td align="right">15.6&nbsp;</td><td><a href="time.html" class="tocviewlink" data-pltdoc="x">Time</a></td></tr><tr><td align="right">15.7&nbsp;</td><td><a href="envvars.html" class="tocviewlink" data-pltdoc="x">Environment Variables</a></td></tr><tr><td align="right">15.8&nbsp;</td><td><a href="runtime.html" class="tocviewlink" data-pltdoc="x">Environment and Runtime Information</a></td></tr><tr><td align="right">15.9&nbsp;</td><td><a href="Command-Line_Parsing.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Parsing</a></td></tr><tr><td align="right">15.10&nbsp;</td><td><a href="os-lib.html" class="tocviewlink" data-pltdoc="x">Additional Operating System Functions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>15.5&nbsp;</td><td><a href="logging.html" class="tocviewselflink" data-pltdoc="x">Logging</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.5.1&nbsp;</td><td><a href="logging.html#%28part._.Creating_.Loggers%29" class="tocviewlink" data-pltdoc="x">Creating Loggers</a></td></tr><tr><td align="right">15.5.2&nbsp;</td><td><a href="logging.html#%28part._.Logging_.Events%29" class="tocviewlink" data-pltdoc="x">Logging Events</a></td></tr><tr><td align="right">15.5.3&nbsp;</td><td><a href="logging.html#%28part._receiving-logged-events%29" class="tocviewlink" data-pltdoc="x">Receiving Logged Events</a></td></tr><tr><td align="right">15.5.4&nbsp;</td><td><a href="logging.html#%28part._.Additional_.Logging_.Functions%29" class="tocviewlink" data-pltdoc="x">Additional Logging Functions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">15.5.1<tt>&nbsp;</tt></span><a href="logging.html#%28part._.Creating_.Loggers%29" class="tocsubseclink" data-pltdoc="x">Creating Loggers</a></td></tr><tr><td><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">logger?</span></span></a></td></tr><tr><td><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._make-logger%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>logger</span></span></a></td></tr><tr><td><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger-name%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">logger-<wbr></wbr>name</span></span></a></td></tr><tr><td><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._current-logger%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>logger</span></span></a></td></tr><tr><td><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._define-logger%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>logger</span></span></a></td></tr><tr><td><span class="tocsublinknumber">15.5.2<tt>&nbsp;</tt></span><a href="logging.html#%28part._.Logging_.Events%29" class="tocsubseclink" data-pltdoc="x">Logging Events</a></td></tr><tr><td><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-message%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">log-<wbr></wbr>message</span></span></a></td></tr><tr><td><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-level~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">log-<wbr></wbr>level?</span></span></a></td></tr><tr><td><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-max-level%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">log-<wbr></wbr>max-<wbr></wbr>level</span></span></a></td></tr><tr><td><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-all-levels%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">log-<wbr></wbr>all-<wbr></wbr>levels</span></span></a></td></tr><tr><td><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-level-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">log-<wbr></wbr>level-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-fatal%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">log-<wbr></wbr>fatal</span></span></a></td></tr><tr><td><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-error%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">log-<wbr></wbr>error</span></span></a></td></tr><tr><td><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-warning%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">log-<wbr></wbr>warning</span></span></a></td></tr><tr><td><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-info%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">log-<wbr></wbr>info</span></span></a></td></tr><tr><td><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-debug%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">log-<wbr></wbr>debug</span></span></a></td></tr><tr><td><span class="tocsublinknumber">15.5.3<tt>&nbsp;</tt></span><a href="logging.html#%28part._receiving-logged-events%29" class="tocsubseclink" data-pltdoc="x">Receiving Logged Events</a></td></tr><tr><td><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-receiver~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">log-<wbr></wbr>receiver?</span></span></a></td></tr><tr><td><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._make-log-receiver%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>log-<wbr></wbr>receiver</span></span></a></td></tr><tr><td><span class="tocsublinknumber">15.5.4<tt>&nbsp;</tt></span><a href="logging.html#%28part._.Additional_.Logging_.Functions%29" class="tocsubseclink" data-pltdoc="x">Additional Logging Functions</a></td></tr><tr><td><a href="logging.html#%28def._%28%28lib._racket%2Flogging..rkt%29._log-level%2Fc%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">log-<wbr></wbr>level/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="logging.html#%28def._%28%28lib._racket%2Flogging..rkt%29._with-intercepted-logging%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">with-<wbr></wbr>intercepted-<wbr></wbr>logging</span></span></a></td></tr><tr><td><a href="logging.html#%28def._%28%28lib._racket%2Flogging..rkt%29._with-logging-to-port%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">with-<wbr></wbr>logging-<wbr></wbr>to-<wbr></wbr>port</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="subprocess.html" title="backward to &quot;15.4 Processes&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="os.html" title="up to &quot;15 Operating System&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="time.html" title="forward to &quot;15.6 Time&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;logging&quot;">15.5<tt>&nbsp;</tt><a name="(part._logging)"></a>Logging</h4><p>A <a name="(tech._logger)"></a><span style="font-style: italic">logger</span> accepts events that contain information to be
+logged for interested parties. A <a name="(tech._log._receiver)"></a><span style="font-style: italic">log receiver</span> represents an
+interested party that receives logged events asynchronously. Each
+event has a topic and level of detail, and a <a href="logging.html#%28tech._log._receiver%29" class="techoutside" data-pltdoc="x"><span class="techinside">log receiver</span></a> subscribes to
+logging events at a certain level of detail (and lower) for a specific topic or for all topics. The
+levels, in increasing order of detail, are <span class="RktVal">'</span><span class="RktVal">none</span>, <span class="RktVal">'</span><span class="RktVal">fatal</span>,
+<span class="RktVal">'</span><span class="RktVal">error</span>, <span class="RktVal">'</span><span class="RktVal">warning</span>, <span class="RktVal">'</span><span class="RktVal">info</span>, and
+<span class="RktVal">'</span><span class="RktVal">debug</span>.</p><p>To help organize logged events, a <a href="logging.html#%28tech._logger%29" class="techoutside" data-pltdoc="x"><span class="techinside">logger</span></a> can have a default topic and/or
+a parent logger. Every event reported to a logger is propagated to
+its parent (if any), and the event message is prefixed with the logger&rsquo;s topic (if
+any) if the message doesn&rsquo;t already have a topic. Furthermore, events that are propagated
+from a logger to its parent can be filtered by level and topic.</p><p>On start-up, Racket creates an initial logger that is used to
+record events from the core run-time system. For example, a
+<span class="RktVal">'</span><span class="RktVal">debug</span> event is reported for each garbage collection (see
+<a href="eval-model.html#%28part._gc-model%29" data-pltdoc="x">Garbage Collection</a>). For this initial logger, two log receivers are
+also created: one that writes events to the process&rsquo;s original error
+output port, and one that writes events to the system log. The level
+of written events in each case is system-specific, and the default can
+be changed through command-line flags (see <a href="running-sa.html#%28part._mz-cmdline%29" data-pltdoc="x">Command Line</a>) or
+through environment variables:</p><ul><li><p>If the <a name="(idx._(gentag._411._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLTSTDERR</span> environment variable is
+defined and is not overridden by a command-line flag, it
+determines the level of the <a href="logging.html#%28tech._log._receiver%29" class="techoutside" data-pltdoc="x"><span class="techinside">log receiver</span></a> that propagates
+events to the original error port.</p><p>The environment variable&rsquo;s value can be a <span class="sroman">&#8249;<span style="font-style: italic">level</span>&#8250;</span>:
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">none</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">fatal</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">error</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">warning</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">info</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">debug</span><span class="hspace"></span></span> (from low detail
+to high detail); all
+events at the corresponding level of detail or lower are printed. After an
+initial <span class="sroman">&#8249;<span style="font-style: italic">level</span>&#8250;</span>, the value can contain
+whitespace-separated specifications of the form
+<span class="sroman">&#8249;<span style="font-style: italic">level</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">@</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">topic</span>&#8250;</span>, which prints
+events whose topics match <span class="sroman">&#8249;<span style="font-style: italic">topic</span>&#8250;</span> only at the given
+<span class="sroman">&#8249;<span style="font-style: italic">level</span>&#8250;</span> or higher (where a <span class="sroman">&#8249;<span style="font-style: italic">topic</span>&#8250;</span> contains any
+character other than whitespace or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">@</span><span class="hspace"></span></span>). Leading and
+trailing whitespace is ignored. For example, the value
+<span class="RktVal">"error debug@GC"</span> prints all events at the
+<span class="RktVal">'</span><span class="RktVal">error</span> level and higher, but prints events for the
+topic <span class="RktVal">'</span><span class="RktVal">GC</span> at the <span class="RktVal">'</span><span class="RktVal">debug</span> level and higher
+(which includes all levels).</p><p>The default is <span class="RktVal">"error"</span>.</p></li><li><p>If the <a name="(idx._(gentag._412._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLTSTDOUT</span> environment variable is
+defined and is not overridden by a command-line flag, it
+determines the level of the <a href="logging.html#%28tech._log._receiver%29" class="techoutside" data-pltdoc="x"><span class="techinside">log receiver</span></a> that propagates
+events to the original output port. The possible values are the
+same as for <span class="stt">PLTSTDERR</span>.</p><p>The default is <span class="RktVal">"none"</span>.</p></li><li><p>If the <a name="(idx._(gentag._413._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLTSYSLOG</span> environment variable is
+defined and is not overridden by a command-line flag, it
+determines the level of the <a href="logging.html#%28tech._log._receiver%29" class="techoutside" data-pltdoc="x"><span class="techinside">log receiver</span></a> that propagates
+events to the system log. The possible values are the
+same as for <span class="stt">PLTSTDERR</span>.</p><p>The default is <span class="RktVal">"none"</span> for Unix or <span class="RktVal">"error"</span> for
+Windows and Mac OS.</p></li></ul><p>The <span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._current-logger%29%29" class="RktValLink" data-pltdoc="x">current-logger</a></span> <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> determines the
+<a name="(tech._current._logger)"></a><span style="font-style: italic">current logger</span> that is used by forms such as
+<span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-warning%29%29" class="RktStxLink" data-pltdoc="x">log-warning</a></span>. On start-up, the initial value of this parameter
+is the initial logger. The run-time system sometimes uses the current
+logger to report events. For example, the bytecode compiler sometimes
+reports <span class="RktVal">'</span><span class="RktVal">warning</span> events when it detects an expression that
+would produce a run-time error if evaluated.</p><p class="SHistory">Changed in version 6.6.0.2 of package <span class="stt">base</span>: Prior to version 6.6.0.2, parsing
+of <span class="stt">PLTSTDERR</span> and <span class="stt">PLTSYSLOG</span> was very strict.
+Leading and trailing whitespace was forbidden, and anything other
+than exactly one space character separating two specifications was
+rejected.<br/>Changed in version 6.90.0.17: Added <span class="stt">PLTSTDOUT</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Creating_Loggers&quot;">15.5.1<tt>&nbsp;</tt><a name="(part._.Creating_.Loggers)"></a>Creating Loggers</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._logger~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">logger?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="logging.html#%28tech._logger%29" class="techoutside" data-pltdoc="x"><span class="techinside">logger</span></a>, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-logger))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._make-logger%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-logger</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">topic</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">parent</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">propagate-level</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">propagate-topic</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger~3f%29%29" class="RktValLink" data-pltdoc="x">logger?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">topic</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">parent</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger~3f%29%29" class="RktValLink" data-pltdoc="x">logger?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">propagate-level</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28lib._racket%2Flogging..rkt%29._log-level%2Fc%29%29" class="RktValLink" data-pltdoc="x">log-level/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">debug</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">propagate-topic</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new <a href="logging.html#%28tech._logger%29" class="techoutside" data-pltdoc="x"><span class="techinside">logger</span></a> with an optional topic and parent.</div></p><p>The optional <span class="RktVar">propagate-level</span> and <span class="RktVar">propagate-topic</span>
+arguments constrain the events that are propagated from the new logger
+to <span class="RktVar">parent</span> (when <span class="RktVar">parent</span> is not <span class="RktVal">#f</span>) in the
+same way that events are described for a log receiver in
+<span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._make-log-receiver%29%29" class="RktValLink" data-pltdoc="x">make-log-receiver</a></span>. By default, all events are propagated to
+<span class="RktVar">parent</span>.</p><p class="SHistory">Changed in version 6.1.1.3 of package <span class="stt">base</span>: Removed an optional argument to
+specify a notification callback,
+and added <span class="RktVar">propagate-level</span> and
+<span class="RktVar">propagate-topic</span> constraints for
+events to propagate.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._logger-name))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger-name%29%29" class="RktValDef RktValLink" data-pltdoc="x">logger-name</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">logger</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">logger</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger~3f%29%29" class="RktValLink" data-pltdoc="x">logger?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Reports <span class="RktVar">logger</span>&rsquo;s default topic, if any.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-logger))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._current-logger%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-logger</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger~3f%29%29" class="RktValLink" data-pltdoc="x">logger?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._current-logger%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-logger</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">logger</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">logger</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger~3f%29%29" class="RktValLink" data-pltdoc="x">logger?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the <a href="logging.html#%28tech._current._logger%29" class="techoutside" data-pltdoc="x"><span class="techinside">current logger</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/more-scheme..rkt)._define-logger))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._define-logger%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-logger</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-parent</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">maybe-parent</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:parent</span><span class="hspace">&nbsp;</span><span class="RktVar">parent-expr</span></td></tr></table></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">parent-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger~3f%29%29" class="RktValLink" data-pltdoc="x">logger?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Defines <span class="RktKw">log-</span><span class="RktVar">id</span><span class="RktKw">-fatal</span>,
+<span class="RktKw">log-</span><span class="RktVar">id</span><span class="RktKw">-error</span>,
+<span class="RktKw">log-</span><span class="RktVar">id</span><span class="RktKw">-warning</span>,
+<span class="RktKw">log-</span><span class="RktVar">id</span><span class="RktKw">-info</span>, and
+<span class="RktKw">log-</span><span class="RktVar">id</span><span class="RktKw">-debug</span> as forms
+like <span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-fatal%29%29" class="RktStxLink" data-pltdoc="x">log-fatal</a></span>, <span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-error%29%29" class="RktStxLink" data-pltdoc="x">log-error</a></span>,<span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-warning%29%29" class="RktStxLink" data-pltdoc="x">log-warning</a></span>,
+<span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-info%29%29" class="RktStxLink" data-pltdoc="x">log-info</a></span>, and <span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-debug%29%29" class="RktStxLink" data-pltdoc="x">log-debug</a></span>. The <span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._define-logger%29%29" class="RktStxLink" data-pltdoc="x">define-logger</a></span>
+form also defines <span class="RktVar">id</span><span class="RktSym">-logger</span>, which is a logger with
+default topic <span class="RktVal">'</span><span class="RktVar">id</span> that is a child of the result of
+<span class="RktVar">parent-expr</span> (if <span class="RktVar">parent-expr</span> does not produce <span class="RktVal">#f</span>),
+or of <span class="RktPn">(</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._current-logger%29%29" class="RktValLink" data-pltdoc="x">current-logger</a></span><span class="RktPn">)</span> if <span class="RktVar">parent-expr</span> not provided; the
+<span class="RktKw">log-</span><span class="RktVar">id</span><span class="RktKw">-fatal</span>, etc<span class="Sendabbrev">.</span> forms
+use this new logger. The new logger is created when <span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._define-logger%29%29" class="RktStxLink" data-pltdoc="x">define-logger</a></span>
+is evaluated.</div></p><p class="SHistory">Changed in version 7.1.0.9 of package <span class="stt">base</span>: Added the <span class="RktPn">#:parent</span> option.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Logging_Events&quot;">15.5.2<tt>&nbsp;</tt><a name="(part._.Logging_.Events)"></a>Logging Events</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._log-message))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-message%29%29" class="RktValDef RktValLink" data-pltdoc="x">log-message</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">logger</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">level</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">topic</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">message</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">data</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prefix-message?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">logger</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger~3f%29%29" class="RktValLink" data-pltdoc="x">logger?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">level</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28lib._racket%2Flogging..rkt%29._log-level%2Fc%29%29" class="RktValLink" data-pltdoc="x">log-level/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">topic</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger-name%29%29" class="RktValLink" data-pltdoc="x">logger-name</a></span><span class="hspace">&nbsp;</span><span class="RktVar">logger</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">message</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">data</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prefix-message?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Reports an event to <span class="RktVar">logger</span>, which in turn distributes the
+information to any <a href="logging.html#%28tech._log._receiver%29" class="techoutside" data-pltdoc="x"><span class="techinside">log receivers</span></a> attached to <span class="RktVar">logger</span> or
+its ancestors that are interested in events at <span class="RktVar">level</span> or
+higher.</div></p><p><a href="logging.html#%28tech._log._receiver%29" class="techoutside" data-pltdoc="x"><span class="techinside">Log receivers</span></a> can filter events based on <span class="RktVar">topic</span>.  In
+addition, if <span class="RktVar">topic</span> and <span class="RktVar">prefix-message?</span> are not
+<span class="RktVal">#f</span>, then <span class="RktVar">message</span> is prefixed with the topic followed
+by <span class="RktVal">": "</span> before it is sent to receivers.</p><p class="SHistory">Changed in version 6.0.1.10 of package <span class="stt">base</span>: Added the <span class="RktVar">prefix-message?</span> argument.<br/>Changed in version 7.2.0.7: Made the <span class="RktVar">data</span> argument optional.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._log-level~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-level~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">log-level?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">logger</span><span class="hspace">&nbsp;</span><span class="RktVar">level</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">topic</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">logger</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger~3f%29%29" class="RktValLink" data-pltdoc="x">logger?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">level</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28lib._racket%2Flogging..rkt%29._log-level%2Fc%29%29" class="RktValLink" data-pltdoc="x">log-level/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">topic</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Reports whether any <a href="logging.html#%28tech._log._receiver%29" class="techoutside" data-pltdoc="x"><span class="techinside">log receiver</span></a> attached to <span class="RktVar">logger</span> or
+one of its ancestors is interested in <span class="RktVar">level</span> events (or
+potentially lower) for <span class="RktVar">topic</span>. If <span class="RktVar">topic</span> is <span class="RktVal">#f</span>,
+the result indicates whether a <a href="logging.html#%28tech._log._receiver%29" class="techoutside" data-pltdoc="x"><span class="techinside">log receiver</span></a> is interested in
+events at <span class="RktVar">level</span> for any topic.</div></p><p>Use this function to avoid work generating an
+event for <span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-message%29%29" class="RktValLink" data-pltdoc="x">log-message</a></span> if no receiver is interested in the
+information; this shortcut is built into <span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-fatal%29%29" class="RktStxLink" data-pltdoc="x">log-fatal</a></span>,
+<span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-error%29%29" class="RktStxLink" data-pltdoc="x">log-error</a></span>, <span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-warning%29%29" class="RktStxLink" data-pltdoc="x">log-warning</a></span>, <span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-info%29%29" class="RktStxLink" data-pltdoc="x">log-info</a></span>,
+<span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-debug%29%29" class="RktStxLink" data-pltdoc="x">log-debug</a></span>, and forms bound by <span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._define-logger%29%29" class="RktStxLink" data-pltdoc="x">define-logger</a></span>,
+however, so it should not be used with those forms.</p><p>The result of this function can change if a garbage collection
+determines that a log receiver is no longer accessible (and therefore
+that any event information it receives will never become accessible).</p><p class="SHistory">Changed in version 6.1.1.3 of package <span class="stt">base</span>: Added the <span class="RktVar">topic</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._log-max-level))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-max-level%29%29" class="RktValDef RktValLink" data-pltdoc="x">log-max-level</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">logger</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">topic</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28lib._racket%2Flogging..rkt%29._log-level%2Fc%29%29" class="RktValLink" data-pltdoc="x">log-level/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">logger</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger~3f%29%29" class="RktValLink" data-pltdoc="x">logger?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">topic</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-level~3f%29%29" class="RktValLink" data-pltdoc="x">log-level?</a></span>, but reports the maximum-detail level of logging for
+which <span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-level~3f%29%29" class="RktValLink" data-pltdoc="x">log-level?</a></span> on <span class="RktVar">logger</span> and <span class="RktVar">topic</span> returns <span class="RktVal">#t</span>. The
+result is <span class="RktVal">#f</span> if <span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-level~3f%29%29" class="RktValLink" data-pltdoc="x">log-level?</a></span> with <span class="RktVar">logger</span> and <span class="RktVar">topic</span>
+currently returns <span class="RktVal">#f</span> for all levels.</div></p><p class="SHistory">Changed in version 6.1.1.3 of package <span class="stt">base</span>: Added the <span class="RktVar">topic</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._log-all-levels))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-all-levels%29%29" class="RktValDef RktValLink" data-pltdoc="x">log-all-levels</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">logger</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28lib._racket%2Flogging..rkt%29._log-level%2Fc%29%29" class="RktValLink" data-pltdoc="x">log-level/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">logger</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger~3f%29%29" class="RktValLink" data-pltdoc="x">logger?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Summarizes the possible results of <span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-max-level%29%29" class="RktValLink" data-pltdoc="x">log-max-level</a></span> on all
+possible <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> symbols. The result list contains a sequence
+of symbols and <span class="RktVal">#f</span>, where the first, third, etc., list element
+corresponds to a level, and the second, fourth, etc., list element
+indicates a corresponding topic. The level is the result that
+<span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-max-level%29%29" class="RktValLink" data-pltdoc="x">log-max-level</a></span> would produce for the topic, where the level for
+the <span class="RktVal">#f</span> topic (which is always present in the result list)
+indicates the result for any <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a>-symbol topic that does not
+appear in the list.</div></p><p>The result is suitable as a sequence of arguments to
+<span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._make-log-receiver%29%29" class="RktValLink" data-pltdoc="x">make-log-receiver</a></span> (after a <a href="logging.html#%28tech._logger%29" class="techoutside" data-pltdoc="x"><span class="techinside">logger</span></a> argument) to create
+a new receiver for events that currently have receivers in <span class="RktVar">logger</span>.</p><p class="SHistory">Added in version 6.1.1.4 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._log-level-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-level-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">log-level-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">logger</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">logger</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger~3f%29%29" class="RktValLink" data-pltdoc="x">logger?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> that is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for
+synchronization</span></a> when the result of <span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-level~3f%29%29" class="RktValLink" data-pltdoc="x">log-level?</a></span>,
+<span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-max-level%29%29" class="RktValLink" data-pltdoc="x">log-max-level</a></span>, or <span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-all-levels%29%29" class="RktValLink" data-pltdoc="x">log-all-levels</a></span> can be different
+than before <span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-level-evt%29%29" class="RktValLink" data-pltdoc="x">log-level-evt</a></span> was called. The event&rsquo;s
+<a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> is the event itself.</div></p><p>The condition reported by the event is a conservative approximation:
+the event can become <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> even if the
+results of <span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-level~3f%29%29" class="RktValLink" data-pltdoc="x">log-level?</a></span>, <span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-max-level%29%29" class="RktValLink" data-pltdoc="x">log-max-level</a></span>, and
+<span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-all-levels%29%29" class="RktValLink" data-pltdoc="x">log-all-levels</a></span> are unchanged. Nevertheless, the expectation
+is that events produced by <span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-level-evt%29%29" class="RktValLink" data-pltdoc="x">log-level-evt</a></span> become ready infrequently,
+because they are triggered by the creation of a log receiver.</p><p class="SHistory">Added in version 6.1.1.4 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/more-scheme..rkt)._log-fatal))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-fatal%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">log-fatal</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">string-expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-fatal%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">log-fatal</a></span><span class="hspace">&nbsp;</span><span class="RktVar">format-string-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/more-scheme..rkt)._log-error))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-error%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">log-error</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">string-expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-error%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">log-error</a></span><span class="hspace">&nbsp;</span><span class="RktVar">format-string-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/more-scheme..rkt)._log-warning))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-warning%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">log-warning</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">string-expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-warning%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">log-warning</a></span><span class="hspace">&nbsp;</span><span class="RktVar">format-string-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/more-scheme..rkt)._log-info))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-info%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">log-info</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">string-expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-info%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">log-info</a></span><span class="hspace">&nbsp;</span><span class="RktVar">format-string-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/more-scheme..rkt)._log-debug))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-debug%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">log-debug</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">string-expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-debug%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">log-debug</a></span><span class="hspace">&nbsp;</span><span class="RktVar">format-string-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Log an event with the <a href="logging.html#%28tech._current._logger%29" class="techoutside" data-pltdoc="x"><span class="techinside">current logger</span></a>, evaluating
+<span class="RktVar">string-expr</span> or <span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="stt"> </span><span class="RktVar">format-string-expr</span><span class="stt"> </span><span class="RktVar">v</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>
+only if the logger has receivers that are interested in the event. In
+addition, the current continuation&rsquo;s <a href="eval-model.html#%28tech._continuation._mark%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation marks</span></a> are
+sent to the logger with the message string.</div></p><p>These form are convenient for using the current logger, but libraries
+should generally use a logger for a specific topic&#8212;<wbr></wbr>typically through
+similar convenience forms generated by <span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._define-logger%29%29" class="RktStxLink" data-pltdoc="x">define-logger</a></span>.</p><p>For each <span class="RktKw">log-</span><span class="RktVar">level</span>,</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktKw">log-</span><span class="RktVar">level</span><span class="hspace">&nbsp;</span><span class="RktVar">string-expr</span><span class="RktPn">)</span></p></blockquote><p>is equivalent to</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._current-logger%29%29" class="RktValLink" data-pltdoc="x">current-logger</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxLink" data-pltdoc="x">when</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-level~3f%29%29" class="RktValLink" data-pltdoc="x">log-level?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVar">level</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-message%29%29" class="RktValLink" data-pltdoc="x">log-message</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVar">level</span><span class="hspace">&nbsp;</span><span class="RktVar">string-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._current-continuation-marks%29%29" class="RktValLink" data-pltdoc="x">current-continuation-marks</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>while</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktKw">log-</span><span class="RktVar">level</span><span class="hspace">&nbsp;</span><span class="RktVar">format-string-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></p></blockquote><p>is equivalent to</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktKw">log-</span><span class="RktVar">level</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVar">format-string-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;receiving-logged-events&quot;">15.5.3<tt>&nbsp;</tt><a name="(part._receiving-logged-events)"></a>Receiving Logged Events</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._log-receiver~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-receiver~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">log-receiver?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="logging.html#%28tech._log._receiver%29" class="techoutside" data-pltdoc="x"><span class="techinside">log receiver</span></a>, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-log-receiver))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._make-log-receiver%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-log-receiver</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">logger</span><span class="hspace">&nbsp;</span><span class="RktVar">level</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">topic</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktOpt">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-receiver~3f%29%29" class="RktValLink" data-pltdoc="x">log-receiver?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">logger</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger~3f%29%29" class="RktValLink" data-pltdoc="x">logger?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">level</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28lib._racket%2Flogging..rkt%29._log-level%2Fc%29%29" class="RktValLink" data-pltdoc="x">log-level/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">topic</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a <a href="logging.html#%28tech._log._receiver%29" class="techoutside" data-pltdoc="x"><span class="techinside">log receiver</span></a> to receive events of detail
+<span class="RktVar">level</span> and lower as reported to <span class="RktVar">logger</span> and its
+descendants, as long as either <span class="RktVar">topic</span> is <span class="RktVal">#f</span> or the
+event&rsquo;s topic matches <span class="RktVar">topic</span>.</div></p><p>A <a href="logging.html#%28tech._log._receiver%29" class="techoutside" data-pltdoc="x"><span class="techinside">log receiver</span></a> is a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a>. It becomes
+<a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when a logging event is
+received, so use <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span> to receive a logged event. The
+<a href="logging.html#%28tech._log._receiver%29" class="techoutside" data-pltdoc="x"><span class="techinside">log receiver</span></a>&rsquo;s <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> is an immutable vector containing
+four values: the level of the event as a symbol, an immutable string
+for the event message, an arbitrary value that was supplied as the
+last argument to <span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._log-message%29%29" class="RktValLink" data-pltdoc="x">log-message</a></span> when the event was logged, and a
+symbol or <span class="RktVal">#f</span> for the event topic.</p><p>Multiple pairs of <span class="RktVar">level</span> and <span class="RktVar">topic</span> can be provided to
+indicate different specific <span class="RktVar">level</span>s for different
+<span class="RktVar">topic</span>s (where <span class="RktVar">topic</span> defaults to <span class="RktVal">#f</span> only for
+the last given <span class="RktVar">level</span>). A <span class="RktVar">level</span> for a <span class="RktVal">#f</span>
+<span class="RktVar">topic</span> applies only to events whose topic does not match any other
+provided <span class="RktVar">topic</span>. If the same <span class="RktVar">topic</span> is provided multiple
+times, the <span class="RktVar">level</span> provided with the last instance in the
+argument list takes precedence.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Additional_Logging_Functions&quot;">15.5.4<tt>&nbsp;</tt><a name="(part._.Additional_.Logging_.Functions)"></a><a name="(mod-path._racket/logging)"></a>Additional Logging Functions</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="logging.html#%28mod-path._racket%2Flogging%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/logging</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="logging.html#%28mod-path._racket%2Flogging%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/logging</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/logging..rkt)._log-level/c))"></a><span title="Provided from: racket/logging | Package: base"><span class="RktSym"><a href="logging.html#%28def._%28%28lib._racket%2Flogging..rkt%29._log-level%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">log-level/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a valid logging level (<span class="RktVal">'</span><span class="RktVal">none</span>,
+<span class="RktVal">'</span><span class="RktVal">fatal</span>, <span class="RktVal">'</span><span class="RktVal">error</span>, <span class="RktVal">'</span><span class="RktVal">warning</span>, <span class="RktVal">'</span><span class="RktVal">info</span>, or
+<span class="RktVal">'</span><span class="RktVal">debug</span>), <span class="RktVal">#f</span> otherwise.</div></p><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/logging..rkt)._with-intercepted-logging))"></a><span title="Provided from: racket/logging | Package: base"><span class="RktSym"><a href="logging.html#%28def._%28%28lib._racket%2Flogging..rkt%29._with-intercepted-logging%29%29" class="RktValDef RktValLink" data-pltdoc="x">with-intercepted-logging</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">interceptor</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:logger</span><span class="hspace">&nbsp;</span><span class="RktVar">logger</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">level</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">topic</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">interceptor</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector%2Fc%29%29" class="RktValLink" data-pltdoc="x">vector/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28lib._racket%2Flogging..rkt%29._log-level%2Fc%29%29" class="RktValLink" data-pltdoc="x">log-level/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">logger</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger~3f%29%29" class="RktValLink" data-pltdoc="x">logger?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">level</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28lib._racket%2Flogging..rkt%29._log-level%2Fc%29%29" class="RktValLink" data-pltdoc="x">log-level/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">topic</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Runs <span class="RktVar">proc</span>, calling <span class="RktVar">interceptor</span> on any log event that the
+execution of <span class="RktVar">proc</span> emits to <span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._current-logger%29%29" class="RktValLink" data-pltdoc="x">current-logger</a></span> at the specified
+levels and topics.
+If <span class="RktPn">#:logger</span> is specified, intercepts events sent to that logger,
+otherwise uses a new child logger of the current logger.
+Returns whatever <span class="RktVar">proc</span> returns.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">warning-counter</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="logging.html#%28def._%28%28lib._racket%2Flogging..rkt%29._with-intercepted-logging%29%29" class="RktValLink" data-pltdoc="x">with-intercepted-logging</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">l</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxLink" data-pltdoc="x">when</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">warning</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">warning-counter</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">warning-counter</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-warning%29%29" class="RktStxLink" data-pltdoc="x">log-warning</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Warning!"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-warning%29%29" class="RktStxLink" data-pltdoc="x">log-warning</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Warning again!"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">warning</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">warning-counter</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.<br/>Changed in version 6.7.0.1: Added <span class="RktPn">#:logger</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/logging..rkt)._with-logging-to-port))"></a><span title="Provided from: racket/logging | Package: base"><span class="RktSym"><a href="logging.html#%28def._%28%28lib._racket%2Flogging..rkt%29._with-logging-to-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">with-logging-to-port</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">port</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:logger</span><span class="hspace">&nbsp;</span><span class="RktVar">logger</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">level</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">topic</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">logger</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._logger~3f%29%29" class="RktValLink" data-pltdoc="x">logger?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">level</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="logging.html#%28def._%28%28lib._racket%2Flogging..rkt%29._log-level%2Fc%29%29" class="RktValLink" data-pltdoc="x">log-level/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">topic</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Runs <span class="RktVar">proc</span>, outputting any logging that the execution of <span class="RktVar">proc</span>
+emits to <span class="RktSym"><a href="logging.html#%28def._%28%28quote._~23~25kernel%29._current-logger%29%29" class="RktValLink" data-pltdoc="x">current-logger</a></span> at the specified levels and topics.
+If <span class="RktPn">#:logger</span> is specified, intercepts events sent to that logger,
+otherwise uses a new child logger of the current logger.
+Returns whatever <span class="RktVar">proc</span> returns.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">my-log</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-string%29%29" class="RktValLink" data-pltdoc="x">open-output-string</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="logging.html#%28def._%28%28lib._racket%2Flogging..rkt%29._with-logging-to-port%29%29" class="RktValLink" data-pltdoc="x">with-logging-to-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-log</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="logging.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._log-warning%29%29" class="RktStxLink" data-pltdoc="x">log-warning</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Warning World!"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">warning</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-string%29%29" class="RktValLink" data-pltdoc="x">get-output-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-log</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"Warning World!\n"</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.<br/>Changed in version 6.7.0.1: Added <span class="RktPn">#:logger</span> argument.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="subprocess.html" title="backward to &quot;15.4 Processes&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="os.html" title="up to &quot;15 Operating System&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="time.html" title="forward to &quot;15.6 Time&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/magnify.png b/clones/docs.racket-lang.org/reference/magnify.png
new file mode 100644
index 0000000000000000000000000000000000000000..8556e407323719a5099dd6518622cfeb86a2bf4f
GIT binary patch
literal 323
zcmV-J0lfZ+P)<h;3K|Lk000e1NJLTq000;O000;W1^@s6;CDUv0003BNkl<Zc%1Fj
ztxf|$6vgph`KW6(rfOC3JV6Dv9>*&n3&CLE8Ne1^0)+#CL^Wwri-Lq8NEXq%q-k0@
zJAi1yKN&H1&zy6UxwEW0jm&dx^iafpgj>AK3pX>&2e`ow-qFH7F0hTe49_plQKGZp
zTL<F^&*C@?n%`)e(ZHatc?-`LcRo)iv~Ac(4CvtjlLYMq_i-jUpukh2R%nYl0okMm
zjIdk7w;N}YY2#JKC8yB96+TQyaMhTO)fm&tyo~i`I!((ST8Y!y;?@fDOB~MBuA{@p
z2&yKli#?p+ET{7__SMg^g+7jA^`n-=D)S%lZ@!d+zcil@_*L`j9Smn`!w6arJ^{}{
VNxoaDPc8re002ovPDHLkV1m?Rj)?#O

literal 0
HcmV?d00001

diff --git a/clones/docs.racket-lang.org/reference/match.html b/clones/docs.racket-lang.org/reference/match.html
new file mode 100644
index 00000000..3b505f3f
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/match.html
@@ -0,0 +1,195 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>9&nbsp;Pattern Matching</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9660;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewselflink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>9&nbsp;</td><td><a href="match.html" class="tocviewselflink" data-pltdoc="x">Pattern Matching</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">9.1&nbsp;</td><td><a href="match.html#%28part._.Additional_.Matching_.Forms%29" class="tocviewlink" data-pltdoc="x">Additional Matching Forms</a></td></tr><tr><td align="right">9.2&nbsp;</td><td><a href="match.html#%28part._.Extending_match%29" class="tocviewlink" data-pltdoc="x">Extending <span class="RktSym"><span class="RktStxLink">match</span></span></a></td></tr><tr><td align="right">9.3&nbsp;</td><td><a href="match.html#%28part._.Library_.Extensions%29" class="tocviewlink" data-pltdoc="x">Library Extensions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match</span></span></a></td></tr><tr><td><span class="tocsublinknumber">9.1<tt>&nbsp;</tt></span><a href="match.html#%28part._.Additional_.Matching_.Forms%29" class="tocsubseclink" data-pltdoc="x">Additional Matching Forms</a></td></tr><tr><td><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match*</span></span></a></td></tr><tr><td><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%2Fvalues%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match/<span class="mywbr"> &nbsp;</span>values</span></span></a></td></tr><tr><td><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._define%2Fmatch%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/<span class="mywbr"> &nbsp;</span>match</span></span></a></td></tr><tr><td><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-lambda%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-<wbr></wbr>lambda</span></span></a></td></tr><tr><td><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-lambda%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-<wbr></wbr>lambda*</span></span></a></td></tr><tr><td><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-lambda%2A%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-<wbr></wbr>lambda**</span></span></a></td></tr><tr><td><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-let%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-<wbr></wbr>let</span></span></a></td></tr><tr><td><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-let%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-<wbr></wbr>let*</span></span></a></td></tr><tr><td><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-let-values%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-<wbr></wbr>let-<wbr></wbr>values</span></span></a></td></tr><tr><td><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-let%2A-values%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-<wbr></wbr>let*-<wbr></wbr>values</span></span></a></td></tr><tr><td><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-letrec%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-<wbr></wbr>letrec</span></span></a></td></tr><tr><td><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-letrec-values%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-<wbr></wbr>letrec-<wbr></wbr>values</span></span></a></td></tr><tr><td><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-define%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-<wbr></wbr>define</span></span></a></td></tr><tr><td><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-define-values%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match-<wbr></wbr>define-<wbr></wbr>values</span></span></a></td></tr><tr><td><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._exn~3amisc~3amatch~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>misc:<span class="mywbr"> &nbsp;</span>match?</span></span></a></td></tr><tr><td><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._failure-cont%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">failure-<wbr></wbr>cont</span></span></a></td></tr><tr><td><span class="tocsublinknumber">9.2<tt>&nbsp;</tt></span><a href="match.html#%28part._.Extending_match%29" class="tocsubseclink" data-pltdoc="x">Extending <span class="RktSym"><span class="RktStxLink">match</span></span></a></td></tr><tr><td><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._define-match-expander%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>match-<wbr></wbr>expander</span></span></a></td></tr><tr><td><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._prop~3amatch-expander%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>match-<wbr></wbr>expander</span></span></a></td></tr><tr><td><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._prop~3alegacy-match-expander%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>legacy-<wbr></wbr>match-<wbr></wbr>expander</span></span></a></td></tr><tr><td><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._match-expander~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">match-<wbr></wbr>expander?</span></span></a></td></tr><tr><td><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._legacy-match-expander~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">legacy-<wbr></wbr>match-<wbr></wbr>expander?</span></span></a></td></tr><tr><td><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._syntax-local-match-introduce%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>match-<wbr></wbr>introduce</span></span></a></td></tr><tr><td><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._match-equality-test%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">match-<wbr></wbr>equality-<wbr></wbr>test</span></span></a></td></tr><tr><td><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%2Fderived%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match/<span class="mywbr"> &nbsp;</span>derived</span></span></a></td></tr><tr><td><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%2A%2Fderived%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">match*/<span class="mywbr"> &nbsp;</span>derived</span></span></a></td></tr><tr><td><span class="tocsublinknumber">9.3<tt>&nbsp;</tt></span><a href="match.html#%28part._.Library_.Extensions%29" class="tocsubseclink" data-pltdoc="x">Library Extensions</a></td></tr><tr><td><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._~3d~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">==</span></span></a></td></tr><tr><td><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._struct%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct*</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Random_generation.html" title="backward to &quot;8.12 Random generation&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="control.html" title="forward to &quot;10 Control Flow&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;match&quot;">9<tt>&nbsp;</tt><a name="(part._match)"></a><a name="(mod-path._racket/match)"></a>Pattern Matching</h3><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=match.html&amp;version=8.6" class="Sq" data-pltdoc="x">Pattern Matching</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces pattern matching.</p></blockquote></blockquote></blockquote><p>The <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span> form and related forms support general pattern
+matching on Racket values. See also <a href="regexp.html" data-pltdoc="x">Regular Expressions</a> for information
+on regular-expression matching on strings, bytes, and streams.</p><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="match.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/match</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="match.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/match</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/match..rkt)._match))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">match</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">val-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">clause</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">pat</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">pat</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">=&gt;</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">pat</span><span class="hspace">&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktVar">cond-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Finds the first <span class="RktVar">pat</span> that matches the result of
+<span class="RktVar">val-expr</span>, and evaluates the corresponding <span class="RktVar">body</span>s with
+bindings introduced by <span class="RktVar">pat</span> (if any). Bindings introduced by
+<span class="RktVar">pat</span> are not available in other parts of <span class="RktVar">pat</span>.
+The last <span class="RktVar">body</span>
+in the matching clause is evaluated in tail position with respect to
+the <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span> expression.</div></p><p>To find a match, the <span class="RktVar">clause</span>s are tried in order. If no
+<span class="RktVar">clause</span> matches, then the <span class="RktSym"><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._exn~3amisc~3amatch~3f%29%29" class="RktValLink" data-pltdoc="x">exn:misc:match?</a></span> exception is raised.</p><p>An optional <span class="RktPn">#:when</span><span class="stt"> </span><span class="RktVar">cond-expr</span> specifies that the pattern
+should only match if <span class="RktVar">cond-expr</span> produces a true value.
+<span class="RktVar">cond-expr</span> is in the scope of all of the variables bound in
+<span class="RktVar">pat</span>. <span class="RktVar">cond-expr</span> must not mutate the object being
+matched before calling the failure procedure, otherwise the behavior
+of matching is unpredictable. See also <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._failure-cont%29%29" class="RktStxLink" data-pltdoc="x">failure-cont</a></span>, which is
+a lower-level mechanism achieving the same ends.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">sum-is-six</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">sum-is-not-six</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'sum-is-six</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'sum-is-not-six</span></p></td></tr></table></blockquote></div></p><p>An optional <span class="RktPn">(</span><span class="RktVar">=&gt;</span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span> between a <span class="RktVar">pat</span> and the
+<span class="RktVar">body</span>s is bound to a <a name="(tech._failure._procedure)"></a><span style="font-style: italic">failure procedure</span> of zero
+arguments.  If this procedure is invoked, it escapes back to the
+pattern matching expression, and resumes the matching process as if
+the pattern had failed to match.  The <span class="RktVar">body</span>s must not mutate
+the object being matched before calling the failure procedure,
+otherwise the behavior of matching is unpredictable.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">=&gt;</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._exit%29%29" class="RktValLink" data-pltdoc="x">exit</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._exit%29%29" class="RktValLink" data-pltdoc="x">exit</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">sum-is-not-six</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._exit%29%29" class="RktValLink" data-pltdoc="x">exit</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">sum-is-six</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._exit%29%29" class="RktValLink" data-pltdoc="x">exit</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'sum-is-six</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'sum-is-not-six</span></p></td></tr></table></blockquote></div></p><p>The grammar of <span class="RktVar">pat</span> is as follows, where non-italicized
+identifiers are recognized symbolically (i.e., not by binding).</p><p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktVar">pat</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="stt">::=</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktVar">id</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match anything, bind identifier</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">var</span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match anything, bind identifier</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktSym">_</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match anything</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktVar">literal</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match literal</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">quote</span><span class="stt"> </span><span class="RktVar">datum</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> value</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">list</span><span class="stt"> </span><span class="RktVar">lvp</span><span class="stt"> </span><span class="RktSym">...</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match sequence of <span class="RktVar">lvp</span>s</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">list-rest</span><span class="stt"> </span><span class="RktVar">lvp</span><span class="stt"> </span><span class="RktSym">...</span><span class="stt"> </span><span class="RktVar">pat</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match <span class="RktVar">lvp</span>s consed onto a <span class="RktVar">pat</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">list*</span><span class="stt"> </span><span class="RktVar">lvp</span><span class="stt"> </span><span class="RktSym">...</span><span class="stt"> </span><span class="RktVar">pat</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match <span class="RktVar">lvp</span>s consed onto a <span class="RktVar">pat</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">list-no-order</span><span class="stt"> </span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktSym">...</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match <span class="RktVar">pat</span>s in any order</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">list-no-order</span><span class="stt"> </span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktSym">...</span><span class="stt"> </span><span class="RktVar">lvp</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match <span class="RktVar">pat</span>s in any order</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">vector</span><span class="stt"> </span><span class="RktVar">lvp</span><span class="stt"> </span><span class="RktSym">...</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match vector of <span class="RktVar">pat</span>s</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">hash-table</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktVar">pat</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym">...</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match hash table</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">hash-table</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktVar">pat</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym">...+</span><span class="stt"> </span><span class="RktVar">ooo</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match hash table</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">cons</span><span class="stt"> </span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktVar">pat</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match pair of <span class="RktVar">pat</span>s</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">mcons</span><span class="stt"> </span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktVar">pat</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match mutable pair of <span class="RktVar">pat</span>s</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">box</span><span class="stt"> </span><span class="RktVar">pat</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match boxed <span class="RktVar">pat</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktVar">struct-id</span><span class="stt"> </span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktSym">...</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match <span class="RktVar">struct-id</span> instance</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">struct</span><span class="stt"> </span><span class="RktVar">struct-id</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktSym">...</span><span class="RktPn">)</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match <span class="RktVar">struct-id</span> instance</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">regexp</span><span class="stt"> </span><span class="RktVar">rx-expr</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match string</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">regexp</span><span class="stt"> </span><span class="RktVar">rx-expr</span><span class="stt"> </span><span class="RktVar">pat</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match string, result with <span class="RktVar">pat</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">pregexp</span><span class="stt"> </span><span class="RktVar">px-expr</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match string</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">pregexp</span><span class="stt"> </span><span class="RktVar">px-expr</span><span class="stt"> </span><span class="RktVar">pat</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match string, result with <span class="RktVar">pat</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">and</span><span class="stt"> </span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktSym">...</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match when all <span class="RktVar">pat</span>s match</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">or</span><span class="stt"> </span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktSym">...</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match when any <span class="RktVar">pat</span> match</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">not</span><span class="stt"> </span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktSym">...</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match when no <span class="RktVar">pat</span> matches</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">app</span><span class="stt"> </span><span class="RktVar">expr</span><span class="stt"> </span><span class="RktSym">pats</span><span class="stt"> </span><span class="RktSym">...</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match <span class="RktPn">(</span><span class="RktVar">expr</span> value<span class="RktPn">)</span> output values to <span class="RktVar">pat</span>s</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">?</span><span class="stt"> </span><span class="RktVar">expr</span><span class="stt"> </span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktSym">...</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match if <span class="RktPn">(</span><span class="RktVar">expr</span> value<span class="RktPn">)</span> and <span class="RktVar">pat</span>s</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktSym">quasiquote</span><span class="stt"> </span><span class="RktVar">qp</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match a quasipattern</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktVar">derived-pattern</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match using extension</p></td></tr><tr><td><p><span class="RktVar">literal</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="stt">::=</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktVal">#t</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match true</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktVal">#f</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match false</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktVar">string</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> string</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktVar">bytes</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> byte string</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktVar">number</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> number</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktSym">char</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> character</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktSym">keyword</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> keyword</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktSym">regexp</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> regexp literal</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktSym">pregexp</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> pregexp literal</p></td></tr><tr><td><p><span class="RktVar">lvp</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="stt">::=</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktVar">pat</span><span class="stt"> </span><span class="RktVar">ooo</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>greedily match <span class="RktVar">pat</span> instances</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktVar">pat</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match <span class="RktVar">pat</span></p></td></tr><tr><td><p><span class="RktVar">qp</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="stt">::=</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktVar">literal</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match literal</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktVar">id</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match symbol</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktVar">qp</span><span class="stt"> </span><span class="RktSym">...</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match sequences of <span class="RktVar">qp</span>s</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktVar">qp</span><span class="stt"> </span><span class="RktSym">...</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">qp</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match <span class="RktVar">qp</span>s ending <span class="RktVar">qp</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktPn">(</span><span class="RktVar">qp</span><span class="stt"> </span><span class="RktVar">ooo</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">qp</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match <span class="RktVar">qp</span>s beginning with repeated <span class="RktVar">qp</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVar">qp</span><span class="stt"> </span><span class="RktVal">...</span><span class="RktVal">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match vector of <span class="RktVar">qp</span>s</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktVal">#&amp;</span><span class="RktVar">qp</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match boxed <span class="RktVar">qp</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktVal">#s</span><span class="RktVal">(</span><span class="RktVal">prefab-key</span><span class="stt"> </span><span class="RktVar">qp</span><span class="stt"> </span><span class="RktVal">...</span><span class="RktVal">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match prefab struct with <span class="RktVar">qp</span> fields</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktRdr">,</span><span class="RktVar">pat</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match <span class="RktVar">pat</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktRdr">,@</span><span class="RktPn">(</span><span class="RktSym">list</span><span class="stt"> </span><span class="RktVar">lvp</span><span class="stt"> </span><span class="RktSym">...</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match <span class="RktVar">lvp</span>s, spliced</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktRdr">,@</span><span class="RktPn">(</span><span class="RktSym">list-rest</span><span class="stt"> </span><span class="RktVar">lvp</span><span class="stt"> </span><span class="RktSym">...</span><span class="stt"> </span><span class="RktVar">pat</span><span class="RktPn">)</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match <span class="RktVar">lvp</span>s plus <span class="RktVar">pat</span>, spliced</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktRdr">,@</span><span class="RktVal">'</span><span class="RktVar">qp</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>match list-matching <span class="RktVar">qp</span>, spliced</p></td></tr><tr><td><p><span class="RktVar">ooo</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="stt">::=</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktSym">...</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>zero or more; <span class="RktSym">...</span> is literal</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktSym">___</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p>zero or more</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktSym">..</span><span class="RktVar">k</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktVar">k</span> or more</p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="hspace">&nbsp;</span><span class="stt">| </span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktSym">__</span><span class="RktVar">k</span></p></td><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktVar">k</span> or more</p></td></tr></table></p><p>In more detail, patterns match as follows:</p><ul><li><p><div class="SIntrapara"><span class="RktVar">id</span> (excluding the reserved names <span class="RktSym">_</span>,
+<span class="RktSym">...</span>, <span class="RktSym">___</span>,
+<span class="RktSym">..</span><span class="RktVar">k</span>, and
+<span class="RktSym">__</span><span class="RktVar">k</span> for non-negative integers
+<span class="RktVar">k</span>) </div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Unlike in <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span> and <span class="RktSym"><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="RktStxLink" data-pltdoc="x">case</a></span>,
+<span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span> is not a keyword in <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span>.</p></blockquote></blockquote></blockquote></div><div class="SIntrapara"> or <span class="RktPn">(</span><span class="RktSym">var</span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span>
+&#8212;<wbr></wbr> matches anything, and binds <span class="RktVar">id</span> to the
+matching values. If an <span class="RktVar">id</span> is used multiple times
+within a pattern, the corresponding matches must be the same
+according to <span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._match-equality-test%29%29" class="RktValLink" data-pltdoc="x">match-equality-test</a></span><span class="RktPn">)</span>, except that
+instances of an <span class="RktVar">id</span> in different <span class="RktSym">or</span> and
+<span class="RktSym">not</span> sub-patterns are independent. The binding for <span class="RktVar">id</span> is
+not available in other parts of the same pattern.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(3 2 1)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktVal">y</span><span class="hspace">&nbsp;</span><span class="RktVal">z</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(1 (x y z))</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">not-evaluated</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">also-not-evaluated</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div></p></li><li><p><a name="(idx._(gentag._202._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym">_</span> &#8212;<wbr></wbr> matches anything, without binding any
+identifiers.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktVal">#t</span>, <span class="RktVal">#f</span>, <span class="RktVar">string</span>, <span class="RktVar">bytes</span>,
+<span class="RktVar">number</span>, <span class="RktVar">char</span>, or <span class="RktPn">(</span><span class="RktSym">quote</span><span class="stt"> </span><span class="RktVar">datum</span><span class="RktPn">)</span> &#8212;<wbr></wbr> matches an <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> constant.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"yes"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVal">"no"</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVal">"yes"</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktPn">(</span><a name="(idx._(gentag._203._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym">list</span><span class="stt"> </span><span class="RktVar">lvp</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> &#8212;<wbr></wbr> matches a list
+of elements. In the case of <span class="RktPn">(</span><span class="RktSym">list</span><span class="stt"> </span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>, the pattern matches a list with as many elements as
+<span class="RktVar">pat</span>s, and each element must match the corresponding
+<span class="RktVar">pat</span>. In the more general case, each <span class="RktVar">lvp</span>
+corresponds to a &ldquo;spliced&rdquo; list of greedy matches.</p><p>For spliced lists, <span class="RktSym">...</span> and <span class="RktSym">___</span>
+are aliases for zero or more matches. The
+<span class="RktSym">..</span><span class="RktVar">k</span> and <span class="RktSym">__</span><span class="RktVar">k</span>
+forms are also aliases, specifying <span class="RktVar">k</span> or more
+matches. Pattern variables that precede these splicing
+operators are bound to lists of matching forms.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(3 2 1)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(2 3)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">..3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">else</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'else</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">..3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">else</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(2 3 4)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">..3</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">else</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(2 3 4)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">..3</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">else</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(2 2 2)</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktPn">(</span><a name="(idx._(gentag._204._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym">list-rest</span><span class="stt"> </span><span class="RktVar">lvp</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktVar">pat</span><span class="RktPn">)</span>
+ or <span class="RktPn">(</span><a name="(idx._(gentag._205._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym">list*</span><span class="stt"> </span><span class="RktVar">lvp</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktVar">pat</span><span class="RktPn">)</span> &#8212;<wbr></wbr>
+ similar to a <span class="RktSym">list</span> pattern, but the final
+ <span class="RktVar">pat</span> matches the &ldquo;rest&rdquo; of the list after the last
+ <span class="RktVar">lvp</span>. In fact, the matched value can be a non-list
+ chain of pairs (i.e., an &ldquo;improper list&rdquo;) if <span class="RktVar">pat</span>
+ matches non-list values.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">4</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">list-rest</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">4</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">list-rest</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'((1 2 3) 4)</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktPn">(</span><a name="(idx._(gentag._206._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym">list-no-order</span><span class="stt"> </span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> &#8212;<wbr></wbr>
+similar to a <span class="RktSym">list</span> pattern, but the elements to
+match each <span class="RktVar">pat</span> can appear in the list in any order.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">list-no-order</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></blockquote></div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Unlike other patterns, <span class="RktSym">list-no-order</span> doesn&rsquo;t
+allow duplicate identifiers between subpatterns. For example
+the patterns <span class="RktPn">(</span><span class="RktSym">list-no-order</span><span class="stt"> </span><span class="RktSym">x</span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktSym">x</span><span class="RktPn">)</span> and
+<span class="RktPn">(</span><span class="RktSym">list-no-order</span><span class="stt"> </span><span class="RktSym">x</span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktSym">x</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> both produce syntax errors.</p></blockquote></blockquote></blockquote></li><li><p><span class="RktPn">(</span><span class="RktSym">list-no-order</span><span class="stt"> </span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktVar">lvp</span><span class="RktPn">)</span> &#8212;<wbr></wbr>
+generalizes <span class="RktSym">list-no-order</span> to allow a pattern
+that matches multiple list elements that are interspersed in
+any order with matches for the other patterns.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">list-no-order</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(1 3 4 5)</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktPn">(</span><a name="(idx._(gentag._207._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym">vector</span><span class="stt"> </span><span class="RktVar">lvp</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> &#8212;<wbr></wbr> like a
+<span class="RktSym">list</span> pattern, but matching a vector.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">..3</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(2 2 2)</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktPn">(</span><a name="(idx._(gentag._208._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym">hash-table</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktVar">pat</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> &#8212;<wbr></wbr>
+similar to <span class="RktSym">list-no-order</span>, but matching against
+hash table&rsquo;s key&ndash;value pairs.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">hash-table</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(2 1)</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktPn">(</span><span class="RktSym">hash-table</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktVar">pat</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktMeta">...+</span><span class="stt"> </span><span class="RktVar">ooo</span><span class="RktPn">)</span>
+&#8212;<wbr></wbr> Generalizes <span class="RktSym">hash-table</span> to support a final
+repeating pattern.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">hash-table</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">key</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">key</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("b" "a")</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktPn">(</span><a name="(idx._(gentag._209._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym">cons</span><span class="stt"> </span><span class="RktVar">pat1</span><span class="stt"> </span><span class="RktVar">pat2</span><span class="RktPn">)</span> &#8212;<wbr></wbr> matches a pair value.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktPn">(</span><a name="(idx._(gentag._210._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym">mcons</span><span class="stt"> </span><span class="RktVar">pat1</span><span class="stt"> </span><span class="RktVar">pat2</span><span class="RktPn">)</span> &#8212;<wbr></wbr> matches a mutable pair value.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="RktValLink" data-pltdoc="x">mcons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">immutable</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="RktValLink" data-pltdoc="x">mcons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">mutable</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'mutable</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktPn">(</span><a name="(idx._(gentag._211._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym">box</span><span class="stt"> </span><span class="RktVar">pat</span><span class="RktPn">)</span> &#8212;<wbr></wbr> matches a boxed value.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#&amp;</span><span class="RktVal">1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValLink" data-pltdoc="x">box</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktPn">(</span><span class="RktVar">struct-id</span><span class="stt"> </span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> or
+<span class="RktPn">(</span><a name="(idx._(gentag._212._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym">struct</span><span class="stt"> </span><span class="RktVar">struct-id</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span> &#8212;<wbr></wbr>
+matches an instance of a structure type named
+<span class="RktVar">struct-id</span>, where each field in the instance matches
+the corresponding <span class="RktVar">pat</span>. See also <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._struct%2A%29%29" class="RktStxLink" data-pltdoc="x">struct*</a></span>.</p><p>Usually, <span class="RktVar">struct-id</span> is defined with
+<span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>.  More generally, <span class="RktVar">struct-id</span>
+must be bound to expansion-time information for a structure
+type (see <a href="structinfo.html" data-pltdoc="x">Structure Type Transformer Binding</a>), where the information
+includes at least a predicate binding and field accessor
+bindings corresponding to the number of field
+<span class="RktVar">pat</span>s. In particular, a module import or a
+<span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span> import with a signature containing a
+<span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> declaration can provide the structure type
+information.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktSym">left</span><span class="hspace">&nbsp;</span><span class="RktSym">right</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(0 1)</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktPn">(</span><span class="RktSym">struct</span><span class="stt"> </span><span class="RktVar">struct-id</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="RktPn">)</span> &#8212;<wbr></wbr>
+matches any instance of <span class="RktVar">struct-id</span>, without regard to
+contents of the fields of the instance.</p></li><li><p><span class="RktPn">(</span><a name="(idx._(gentag._213._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym">regexp</span><span class="stt"> </span><span class="RktVar">rx-expr</span><span class="RktPn">)</span> &#8212;<wbr></wbr> matches a
+string that matches the regexp pattern produced by
+<span class="RktVar">rx-expr</span>; see <a href="regexp.html" data-pltdoc="x">Regular Expressions</a> for more information
+about regexps.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="RktValLink" data-pltdoc="x">regexp</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"p+"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">no</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'yes</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="RktValLink" data-pltdoc="x">regexp</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"p+"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">no</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'no</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktPn">(</span><span class="RktSym">regexp</span><span class="stt"> </span><span class="RktVar">rx-expr</span><span class="stt"> </span><span class="RktVar">pat</span><span class="RktPn">)</span> &#8212;<wbr></wbr> extends
+the <span class="RktSym">regexp</span> form to further constrain the match
+where the result of <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span> is matched against
+<span class="RktVar">pat</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="RktValLink" data-pltdoc="x">regexp</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"p+(.)"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"l"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">no</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'yes</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"append"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="RktValLink" data-pltdoc="x">regexp</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"p+(.)"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"l"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">no</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'no</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktPn">(</span><a name="(idx._(gentag._214._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym">pregexp</span><span class="stt"> </span><span class="RktVar">rx-expr</span><span class="RktPn">)</span> or
+<span class="RktPn">(</span><span class="RktSym">pregexp</span><span class="stt"> </span><span class="RktVar">rx-expr</span><span class="stt"> </span><span class="RktVar">pat</span><span class="RktPn">)</span> &#8212;<wbr></wbr> like the
+<span class="RktSym">regexp</span> patterns, but if <span class="RktVar">rx-expr</span>
+produces a string, it is converted to a pattern using
+<span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._pregexp%29%29" class="RktValLink" data-pltdoc="x">pregexp</a></span> instead of <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="RktValLink" data-pltdoc="x">regexp</a></span>.</p></li><li><p><span class="RktPn">(</span><a name="(idx._(gentag._215._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym">and</span><span class="stt"> </span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> &#8212;<wbr></wbr> matches if all
+of the <span class="RktVar">pat</span>s match.  This pattern is often used as
+<span class="RktPn">(</span><span class="RktSym">and</span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">pat</span><span class="RktPn">)</span> to bind <span class="RktVar">id</span>
+to the entire value that matches <span class="RktVar">pat</span>. The <span class="RktVar">pat</span>s are
+matched in the order that they appear.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(2 3)</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktPn">(</span><a name="(idx._(gentag._216._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym">or</span><span class="stt"> </span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> &#8212;<wbr></wbr> matches if any of
+the <span class="RktVar">pat</span>s match. Each <span class="RktVar">pat</span> must bind the same set
+of identifiers.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktPn">(</span><a name="(idx._(gentag._217._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym">not</span><span class="stt"> </span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> &#8212;<wbr></wbr> matches when
+none of the <span class="RktVar">pat</span>s match, and binds no identifiers.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">no</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'yes</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">no</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'no</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktPn">(</span><a name="(idx._(gentag._218._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym">app</span><span class="stt"> </span><span class="RktVar">expr</span><span class="stt"> </span><span class="RktVar">pats</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> &#8212;<wbr></wbr> applies
+<span class="RktVar">expr</span> to the value to be matched; each result of the
+application is matched against one of the <span class="RktVar">pats</span>,
+respectively.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">app</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._length%29%29" class="RktValLink" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'yes</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"3.14"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">app</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._string-~3enumber%29%29" class="RktValLink" data-pltdoc="x">string-&gt;number</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">I</span><span class="hspace">&nbsp;</span><span class="RktVal">got</span><span class="hspace">&nbsp;</span><span class="RktRdr">,</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(I got 3.14)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">app</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._split-at%29%29" class="RktValLink" data-pltdoc="x">split-at</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'yes</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">app</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ls</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ls</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._odd~3f%29%29" class="RktValLink" data-pltdoc="x">odd?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(yes 1 2 3)</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktPn">(</span><a name="(idx._(gentag._219._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym">?</span><span class="stt"> </span><span class="RktVar">expr</span><span class="stt"> </span><span class="RktVar">pat</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> &#8212;<wbr></wbr> applies
+<span class="RktVar">expr</span> to the value to be matched, and checks whether
+the result is a true value; the additional <span class="RktVar">pat</span>s must
+also match; i.e., <span class="RktSym">?</span> combines a predicate
+application and an <span class="RktSym">and</span> pattern.  However,
+<span class="RktSym">?</span>, unlike <span class="RktSym">and</span>, guarantees that
+<span class="RktVar">expr</span> is matched before any of the <span class="RktVar">pat</span>s.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The <span class="RktVar">expr</span> procedure may be called more than once
+on identical input (although this happens only rarely),
+and the order in which calls to <span class="RktVar">expr</span> are
+made should not be relied upon.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._odd~3f%29%29" class="RktValLink" data-pltdoc="x">odd?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'yes</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktPn">(</span><a name="(idx._(gentag._220._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym">quasiquote</span><span class="stt"> </span><span class="RktVar">qp</span><span class="RktPn">)</span> &#8212;<wbr></wbr> introduces a
+quasipattern, in which identifiers match symbols. Like the
+<span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span> expression form, <span class="RktSym">unquote</span>
+and <span class="RktSym">unquote-splicing</span> escape back to normal
+patterns.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktRdr">,</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktRdr">,</span><span class="RktPn">(</span><span class="RktSym">?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._odd~3f%29%29" class="RktValLink" data-pltdoc="x">odd?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(2 3)</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktVar">derived-pattern</span> &#8212;<wbr></wbr> matches a pattern defined by a
+macro extension via <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._define-match-expander%29%29" class="RktStxLink" data-pltdoc="x">define-match-expander</a></span>.</p></li></ul><p>Note that the matching process may destructure the input multiple times, and
+may evaluate expressions embedded in patterns such as <span class="RktPn">(</span><span class="RktSym">app</span><span class="stt"> </span><span class="RktSym">expr</span><span class="stt"> </span><span class="RktVar">pat</span><span class="RktPn">)</span> in arbitrary order, or multiple times.  Therefore, such
+expressions must be safe to call multiple times, or in an order other than they
+appear in the original program.</p><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Additional_Matching_Forms&quot;">9.1<tt>&nbsp;</tt><a name="(part._.Additional_.Matching_.Forms)"></a>Additional Matching Forms</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/match..rkt)._match*))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">match*</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">val-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">clause*</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">clause*</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">pat</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">pat</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">=&gt;</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">pat</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktVar">cond-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Matches a sequence of values against each clause in order, matching
+only when all patterns in a clause match.  Each clause must have the
+same number of patterns as the number of <span class="RktVar">val-expr</span>s.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%2A%29%29" class="RktStxLink" data-pltdoc="x">match*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%2A%29%29" class="RktStxLink" data-pltdoc="x">match*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">15</span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">diff-by-two</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'diff-by-two</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/match..rkt)._match/values))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%2Fvalues%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">match/values</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktVar">clause</span><span class="hspace">&nbsp;</span><span class="RktVar">clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">If <span class="RktVar">expr</span> evaluates to <span class="RktSym">n</span> values, then match all <span class="RktSym">n</span>
+values against the patterns in <span class="RktVar">clause</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span>. Each clause must contain
+exactly <span class="RktSym">n</span> patterns. At least one clause is required to determine how
+many values to expect from <span class="RktVar">expr</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/match..rkt)._define/match))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._define%2Fmatch%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/match</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">head</span><span class="hspace">&nbsp;</span><span class="RktVar">args</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">match*-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">head</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">head</span><span class="hspace">&nbsp;</span><span class="RktVar">args</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">args</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktPn">.</span><span class="hspace">&nbsp;</span><span class="RktVar">rest-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">arg</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">arg-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">arg-id</span><span class="hspace">&nbsp;</span><span class="RktVar">default-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktVar">arg-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">arg-id</span><span class="hspace">&nbsp;</span><span class="RktVar">default-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">match*-clause</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">pat</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">pat</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">=&gt;</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">pat</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktVar">cond-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Binds <span class="RktVar">id</span> to a procedure that is defined by pattern matching
+clauses using <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%2A%29%29" class="RktStxLink" data-pltdoc="x">match*</a></span>. Each clause takes a sequence of
+patterns that correspond to the arguments in the function header.
+The arguments are ordered as they appear in the function header for
+matching purposes.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._define%2Fmatch%29%29" class="RktStxLink" data-pltdoc="x">define/match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fact</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fact</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">fact</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">120</span></p></td></tr></table></blockquote></div></p><p>The function header may also contain optional or keyword arguments,
+may have curried arguments, and may also contain a rest argument.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._define%2Fmatch%29%29" class="RktStxLink" data-pltdoc="x">define/match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:y</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="RktValLink" data-pltdoc="x">regexp</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"p+"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktRdr">,</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">"ape"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:y</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">"dog"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._define%2Fmatch%29%29" class="RktStxLink" data-pltdoc="x">define/match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">g</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">rst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">g</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">g</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">g</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/match..rkt)._match-lambda))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-lambda%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">match-lambda</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">id</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="stt"> </span><span class="RktSym">id</span><span class="stt"> </span><span class="RktVar">clause</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/match..rkt)._match-lambda*))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-lambda%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">match-lambda*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktSym">lst</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="stt"> </span><span class="RktSym">lst</span><span class="stt"> </span><span class="RktVar">clause</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/match..rkt)._match-lambda**))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-lambda%2A%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">match-lambda**</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">clause*</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">args</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%2A%29%29" class="RktStxLink" data-pltdoc="x">match*</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">args</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">clause*</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span>,
+where the number of <span class="RktSym">args</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span> is computed from the number of patterns
+appearing in each of the <span class="RktVar">clause*</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/match..rkt)._match-let))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-let%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">match-let</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">pat</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Generalizes <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span> to support pattern bindings. Each
+<span class="RktVar">expr</span> is matched against its corresponding <span class="RktVar">pat</span> (the
+match must succeed), and the bindings that <span class="RktVar">pat</span> introduces are
+visible in the <span class="RktVar">body</span>s.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-let%29%29" class="RktStxLink" data-pltdoc="x">match-let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(2 1 (1 2 3 4))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/match..rkt)._match-let*))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-let%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">match-let*</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">pat</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-let%29%29" class="RktStxLink" data-pltdoc="x">match-let</a></span>, but generalizes <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A%29%29" class="RktStxLink" data-pltdoc="x">let*</a></span>, so that the
+bindings of each <span class="RktVar">pat</span> are available in each subsequent
+<span class="RktVar">expr</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-let%2A%29%29" class="RktStxLink" data-pltdoc="x">match-let*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(1 2 3 4)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/match..rkt)._match-let-values))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-let-values%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">match-let-values</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">pat</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-let%29%29" class="RktStxLink" data-pltdoc="x">match-let</a></span>, but generalizes <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/match..rkt)._match-let*-values))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-let%2A-values%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">match-let*-values</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">pat</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-let%2A%29%29" class="RktStxLink" data-pltdoc="x">match-let*</a></span>, but generalizes <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A-values%29%29" class="RktStxLink" data-pltdoc="x">let*-values</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/match..rkt)._match-letrec))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-letrec%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">match-letrec</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">pat</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-let%29%29" class="RktStxLink" data-pltdoc="x">match-let</a></span>, but generalizes <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec%29%29" class="RktStxLink" data-pltdoc="x">letrec</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/match..rkt)._match-letrec-values))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-letrec-values%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">match-letrec-values</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">pat</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-let%29%29" class="RktStxLink" data-pltdoc="x">match-let</a></span>, but generalizes <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-values%29%29" class="RktStxLink" data-pltdoc="x">letrec-values</a></span>.</div></p><p class="SHistory">Added in version 6.1.1.8 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/match..rkt)._match-define))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-define%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">match-define</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">pat</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Defines the names bound by <span class="RktVar">pat</span> to the values produced by
+matching against the result of <span class="RktVar">expr</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-define%29%29" class="RktStxLink" data-pltdoc="x">match-define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">b</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/match..rkt)._match-define-values))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-define-values%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">match-define-values</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">pat</span><span class="hspace">&nbsp;</span><span class="RktVar">pats</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-define%29%29" class="RktStxLink" data-pltdoc="x">match-define</a></span> but for when expr produces multiple values.
+Like match/values, it requires at least one pattern to determine the
+number of values to expect.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-define-values%29%29" class="RktStxLink" data-pltdoc="x">match-define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">b</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/match..rkt)._exn~3amisc~3amatch~3f))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._exn~3amisc~3amatch~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:misc:match?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A predicate for the exception raised in the case of a match failure.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/match..rkt)._failure-cont))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._failure-cont%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">failure-cont</a></span></span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Continues matching as if the current pattern failed.  Note that unlike
+use of the <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span> form, this does <span class="emph">not</span> escape the current
+context, and thus should only be used in tail position with respect to
+the <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span> form.</div></p><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Extending_match&quot;">9.2<tt>&nbsp;</tt><a name="(part._.Extending_match)"></a>Extending <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span></h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/match..rkt)._define-match-expander))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._define-match-expander%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-match-expander</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">proc-expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._define-match-expander%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-match-expander</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">proc-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">proc-expr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Binds <span class="RktVar">id</span> to a <a name="(tech._match._expander)"></a><span style="font-style: italic">match expander</span>.</div></p><p>The first <span class="RktVar">proc-expr</span> sub-expression must evaluate to a
+ transformer that produces a <span class="RktVar">pat</span> for <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span>.
+ Whenever <span class="RktVar">id</span> appears as the beginning of a pattern, this
+ transformer is given, at expansion time, a syntax object
+ corresponding to the entire pattern (including <span class="RktVar">id</span>).  The
+ pattern is replaced with the result of the transformer.</p><p>A transformer produced by a second <span class="RktVar">proc-expr</span> sub-expression is
+ used when <span class="RktVar">id</span> is used in an expression context. Using the
+ second <span class="RktVar">proc-expr</span>, <span class="RktVar">id</span> can be given meaning both
+ inside and outside patterns.</p><p>Match expanders are not invoked unless <span class="RktVar">id</span> appears in the first
+position in a sequence. Instead, identifiers bound by <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._define-match-expander%29%29" class="RktStxLink" data-pltdoc="x">define-match-expander</a></span>
+are used as binding identifiers (like any other identifier) when they appear
+anywhere except the first position in a sequence.</p><p><div class="SIntrapara">For example, to extend the pattern matcher and destructure syntax lists,
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">syntax-list?</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3elist%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._define-match-expander%29%29" class="RktStxLink" data-pltdoc="x">define-match-expander</a></span><span class="hspace">&nbsp;</span><span class="RktSym">syntax-list</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">elts</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">?</span><span class="hspace">&nbsp;</span><span class="RktSym">syntax-list?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">app</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3elist%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">elts</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-keyword-predicate</span><span class="hspace">&nbsp;</span><span class="RktSym">keyword</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktSym">keyword</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">or-keyword?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-keyword-predicate</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">and-keyword?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-keyword-predicate</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">syntax-list</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">?</span><span class="hspace">&nbsp;</span><span class="RktSym">or-keyword?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"OOORRR!"</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">syntax-list</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">?</span><span class="hspace">&nbsp;</span><span class="RktSym">and-keyword?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"AAANND!"</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("OOORRR!" #&lt;syntax:eval:69:0 3&gt; #&lt;syntax:eval:69:0 4&gt;)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">syntax-list</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">?</span><span class="hspace">&nbsp;</span><span class="RktSym">or-keyword?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"OOORRR!"</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">syntax-list</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">?</span><span class="hspace">&nbsp;</span><span class="RktSym">and-keyword?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"AAANND!"</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("AAANND!" #&lt;syntax:eval:70:0 5&gt; #&lt;syntax:eval:70:0 6&gt;)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara">And here is an example showing how
+<span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._define-match-expander%29%29" class="RktStxLink" data-pltdoc="x">define-match-expander</a></span>-bound identifiers are
+<span class="emph">not</span> treated specially unless they appear
+in the first position of pattern sequence. Consider
+this (incorrect) definition of a length function:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._define-match-expander%29%29" class="RktStxLink" data-pltdoc="x">define-match-expander</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nil</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">len</span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">nil</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hd</span><span class="hspace">&nbsp;</span><span class="RktSym">tl</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">len</span><span class="hspace">&nbsp;</span><span class="RktSym">tl</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div></p><p>Because there are no parenthesis around <span class="RktSym">nil</span>,
+<span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span> treats the first case as an identifier
+(which matches everything) instead of a use of the match
+expander and <span class="RktSym">len</span> always returns <span class="RktVal">0</span>.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">len</span><span class="hspace">&nbsp;</span><span class="RktSym">nil</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">len</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">nil</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">len</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym">nil</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr></table></blockquote><p><div class="SIntrapara">Match expanders accept any syntax pair whose first element is an
+<span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span> bound to the expander. The following example
+shows a match expander which can be called with an improper syntax
+list of the form <span class="RktPn">(</span><span class="RktSym">expander</span><span class="stt"> </span><span class="RktSym">a</span><span class="stt"> </span><span class="RktSym">b</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span><span class="RktPn">)</span>.
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._define-match-expander%29%29" class="RktStxLink" data-pltdoc="x">define-match-expander</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-vector</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pat</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pat</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pat</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">rest-pat</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">app</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-~3elist%29%29" class="RktValLink" data-pltdoc="x">vector-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">list-rest</span><span class="hspace">&nbsp;</span><span class="RktSym">pat</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rest-pat</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">my-vector</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._list-~3evector%29%29" class="RktValLink" data-pltdoc="x">list-&gt;vector</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._append%29%29" class="RktValLink" data-pltdoc="x">append</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'#(3 4 5 1 2)</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.7.0.2 of package <span class="stt">base</span>: Match expanders now allowed any syntax pair whose first element is an
+<span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span> bound to the expander. The example above did not work
+with previous versions.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/match..rkt)._prop~3amatch-expander))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._prop~3amatch-expander%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:match-expander</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property</span></a> to identify structure types that act
+as <a href="match.html#%28tech._match._expander%29" class="techoutside" data-pltdoc="x"><span class="techinside">match expanders</span></a> like the ones created by
+<span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._define-match-expander%29%29" class="RktStxLink" data-pltdoc="x">define-match-expander</a></span>.</div></p><p>The property value must be an exact non-negative integer or a
+procedure of one or two arguments.  In the former case, the integer
+designates a field within the structure that should contain a
+procedure; the integer must be between <span class="RktVal">0</span> (inclusive) and the
+number of non-automatic fields in the structure type (exclusive, not
+counting supertype fields), and the designated field must also be
+specified as immutable.</p><p>If the property value is a procedure of one argument, then the
+procedure serves as the transformer for match expansion. If the property value is a procedure of two
+arguments, then the first argument is the structure whose type has
+<span class="RktSym"><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._prop~3amatch-expander%29%29" class="RktValLink" data-pltdoc="x">prop:match-expander</a></span> property, and the second argument is a
+syntax object as for a <a href="match.html#%28tech._match._expander%29" class="techoutside" data-pltdoc="x"><span class="techinside">match expander</span></a>..</p><p>If the property value is a <a href="syntax-model.html#%28tech._assignment._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">assignment transformer</span></a>, then the wrapped
+procedure is extracted with
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._set%21-transformer-procedure%29%29" class="RktValLink" data-pltdoc="x">set!-transformer-procedure</a></span> before it is called.</p><p>This binding is provided <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/match..rkt)._prop~3alegacy-match-expander))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._prop~3alegacy-match-expander%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:legacy-match-expander</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._prop~3amatch-expander%29%29" class="RktValLink" data-pltdoc="x">prop:match-expander</a></span>, but for the legacy match syntax.</div></p><p>This binding is provided <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/match..rkt)._match-expander~3f))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._match-expander~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">match-expander?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/match..rkt)._legacy-match-expander~3f))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._legacy-match-expander~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">legacy-match-expander?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Predicates for values which implement the appropriate match expander
+properties.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/match..rkt)._syntax-local-match-introduce))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._syntax-local-match-introduce%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-match-introduce</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">For backward compatibility only; equivalent to <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-introduce%29%29" class="RktValLink" data-pltdoc="x">syntax-local-introduce</a></span>.</div></p><p class="SHistory">Changed in version 6.90.0.29 of package <span class="stt">base</span>: Made equivalent to <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-introduce%29%29" class="RktValLink" data-pltdoc="x">syntax-local-introduce</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/match..rkt)._match-equality-test))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._match-equality-test%29%29" class="RktValDef RktValLink" data-pltdoc="x">match-equality-test</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28def._%28%28lib._racket%2Fmatch..rkt%29._match-equality-test%29%29" class="RktValDef RktValLink" data-pltdoc="x">match-equality-test</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">comp-proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">comp-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the comparison procedure used to check
+whether multiple uses of an identifier match the &ldquo;same&rdquo; value. The
+default is <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/match..rkt)._match/derived))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%2Fderived%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">match/derived</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">val-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">original-datum</span><span class="hspace">&nbsp;</span><span class="RktVar">clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/match..rkt)._match*/derived))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%2A%2Fderived%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">match*/derived</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">val-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">original-datum</span><span class="hspace">&nbsp;</span><span class="RktVar">clause*</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span> and <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%2A%29%29" class="RktStxLink" data-pltdoc="x">match*</a></span> respectively, but includes a
+sub-expression to be used as the source for all syntax errors within the form.
+For example, <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-lambda%29%29" class="RktStxLink" data-pltdoc="x">match-lambda</a></span> expands to <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%2Fderived%29%29" class="RktStxLink" data-pltdoc="x">match/derived</a></span> so that
+errors in the body of the form are reported in terms of <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match-lambda%29%29" class="RktStxLink" data-pltdoc="x">match-lambda</a></span>
+instead of <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span>.</div></p><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Library_Extensions&quot;">9.3<tt>&nbsp;</tt><a name="(part._.Library_.Extensions)"></a>Library Extensions</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/match..rkt)._~3d~3d))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._~3d~3d%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">==</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span><span class="RktVar">comparator</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._~3d~3d%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">==</a></span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="match.html#%28tech._match._expander%29" class="techoutside" data-pltdoc="x"><span class="techinside">match expander</span></a>
+which checks if the matched value is the same as <span class="RktVar">val</span> when
+compared by <span class="RktVar">comparator</span>.  If <span class="RktVar">comparator</span> is
+not provided, it defaults to <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._~3d~3d%29%29" class="RktStxLink" data-pltdoc="x">==</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">no</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'yes</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._~3d~3d%29%29" class="RktStxLink" data-pltdoc="x">==</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">no</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'no</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._~3d~3d%29%29" class="RktStxLink" data-pltdoc="x">==</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">no</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'yes</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/match..rkt)._struct*))"></a><span title="Provided from: racket/match, racket | Package: base"><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._struct%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">struct*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">struct-id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">field</span><span class="hspace">&nbsp;</span><span class="RktVar">pat</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span> pattern form that matches an instance of a structure
+type named <span class="RktVar">struct-id</span>, where the field <span class="RktVar">field</span> in the
+instance matches the corresponding <span class="RktVar">pat</span>.
+The fields do not include those from super types.</div></p><p>Any field of <span class="RktVar">struct-id</span> may be omitted, and such fields can
+occur in any order.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktSym">left</span><span class="hspace">&nbsp;</span><span class="RktSym">right</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tree*</span><span class="hspace">&nbsp;</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._struct%2A%29%29" class="RktStxLink" data-pltdoc="x">struct*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">left</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._struct%2A%29%29" class="RktStxLink" data-pltdoc="x">struct*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">right</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(0 1)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">tree*</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">42</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._struct%2A%29%29" class="RktStxLink" data-pltdoc="x">struct*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tree*</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._struct%2A%29%29" class="RktStxLink" data-pltdoc="x">struct*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(42 0)</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Random_generation.html" title="backward to &quot;8.12 Random generation&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="control.html" title="forward to &quot;10 Control Flow&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/memory-order.html b/clones/docs.racket-lang.org/reference/memory-order.html
new file mode 100644
index 00000000..0b14e4e2
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/memory-order.html
@@ -0,0 +1,26 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>11.7&nbsp;Machine Memory Order</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewselflink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.1&nbsp;</td><td><a href="threads.html" class="tocviewlink" data-pltdoc="x">Threads</a></td></tr><tr><td align="right">11.2&nbsp;</td><td><a href="all-sync.html" class="tocviewlink" data-pltdoc="x">Synchronization</a></td></tr><tr><td align="right">11.3&nbsp;</td><td><a href="thread-local-storage.html" class="tocviewlink" data-pltdoc="x">Thread-<wbr></wbr>Local Storage</a></td></tr><tr><td align="right">11.4&nbsp;</td><td><a href="futures.html" class="tocviewlink" data-pltdoc="x">Futures</a></td></tr><tr><td align="right">11.5&nbsp;</td><td><a href="places.html" class="tocviewlink" data-pltdoc="x">Places</a></td></tr><tr><td align="right">11.6&nbsp;</td><td><a href="engine.html" class="tocviewlink" data-pltdoc="x">Engines</a></td></tr><tr><td align="right">11.7&nbsp;</td><td><a href="memory-order.html" class="tocviewselflink" data-pltdoc="x">Machine Memory Order</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="memory-order.html#%28def._%28%28quote._~23~25kernel%29._memory-order-acquire%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">memory-<wbr></wbr>order-<wbr></wbr>acquire</span></span></a></td></tr><tr><td><a href="memory-order.html#%28def._%28%28quote._~23~25kernel%29._memory-order-release%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">memory-<wbr></wbr>order-<wbr></wbr>release</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="engine.html" title="backward to &quot;11.6 Engines&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="concurrency.html" title="up to &quot;11 Concurrency and Parallelism&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Macros.html" title="forward to &quot;12 Macros&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;memory-order&quot;">11.7<tt>&nbsp;</tt><a name="(part._memory-order)"></a>Machine Memory Order</h4><p>Unlike Racket <a href="eval-model.html#%28tech._thread%29" class="techoutside" data-pltdoc="x"><span class="techinside">threads</span></a>, futures and places can expose the
+underlying machine&rsquo;s memory model, including a weak memory ordering.
+For example, when a future writes to multiple slots in a mutable
+vector, it&rsquo;s possible on some platforms for another future to observe
+the writes in a different order or not at all, unless the futures are
+explicitly synchronized. Similarly, shared byte strings or
+<a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvectors</span></a> can expose the machine&rsquo;s memory model across places.</p><p>Racket ensures that a machine&rsquo;s memory model is not observed in a way
+that unsafely exposes the implementation of primitive datatypes. For
+example, it is not possible for one future to see a partially
+constructed primitive value as a result of reading a vector that is
+mutated by another future.</p><p>The <span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box-cas%21%29%29" class="RktValLink" data-pltdoc="x">box-cas!</a></span>, <span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-cas%21%29%29" class="RktValLink" data-pltdoc="x">vector-cas!</a></span>,
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-box%2A-cas%21%29%29" class="RktValLink" data-pltdoc="x">unsafe-box*-cas!</a></span>, <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector%2A-cas%21%29%29" class="RktValLink" data-pltdoc="x">unsafe-vector*-cas!</a></span>, and
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-struct%2A-cas%21%29%29" class="RktValLink" data-pltdoc="x">unsafe-struct*-cas!</a></span> operations all provide a machine-level
+compare-and-set, so they can be used in ways that are specifically
+supported by the a machine&rsquo;s memory model. The
+<span class="RktPn">(</span><span class="RktSym"><a href="memory-order.html#%28def._%28%28quote._~23~25kernel%29._memory-order-acquire%29%29" class="RktValLink" data-pltdoc="x">memory-order-acquire</a></span><span class="RktPn">)</span> and <span class="RktPn">(</span><span class="RktSym"><a href="memory-order.html#%28def._%28%28quote._~23~25kernel%29._memory-order-release%29%29" class="RktValLink" data-pltdoc="x">memory-order-release</a></span><span class="RktPn">)</span>
+operations similarly constrain machine-level stores and loads.
+Synchronization operations such as place messages, future
+<span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._touch%29%29" class="RktValLink" data-pltdoc="x">touch</a></span>es, and <a href="futures.html#%28tech._future._semaphore%29" class="techoutside" data-pltdoc="x"><span class="techinside">future semaphores</span></a> imply suitable
+machine-level acquire and release ordering.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._memory-order-acquire))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="memory-order.html#%28def._%28%28quote._~23~25kernel%29._memory-order-acquire%29%29" class="RktValDef RktValLink" data-pltdoc="x">memory-order-acquire</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._memory-order-release))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="memory-order.html#%28def._%28%28quote._~23~25kernel%29._memory-order-release%29%29" class="RktValDef RktValLink" data-pltdoc="x">memory-order-release</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Those operations implement a machine-level memory fence on platforms
+where one is needed for synchronization. The
+<span class="RktSym"><a href="memory-order.html#%28def._%28%28quote._~23~25kernel%29._memory-order-acquire%29%29" class="RktValLink" data-pltdoc="x">memory-order-acquire</a></span> operation ensures at least a load&ndash;load
+and load&ndash;store fence at the machine level, and the
+<span class="RktSym"><a href="memory-order.html#%28def._%28%28quote._~23~25kernel%29._memory-order-release%29%29" class="RktValLink" data-pltdoc="x">memory-order-release</a></span> operation ensures at least a
+store&ndash;store and store&ndash;load fence at the machine level.</div></p><p class="SHistory">Added in version 7.7.0.11 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="engine.html" title="backward to &quot;11.6 Engines&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="concurrency.html" title="up to &quot;11 Concurrency and Parallelism&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Macros.html" title="forward to &quot;12 Macros&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/memory.html b/clones/docs.racket-lang.org/reference/memory.html
new file mode 100644
index 00000000..c9e752e6
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/memory.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>16&nbsp;Memory Management</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewselflink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>16&nbsp;</td><td><a href="memory.html" class="tocviewselflink" data-pltdoc="x">Memory Management</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.1&nbsp;</td><td><a href="weakbox.html" class="tocviewlink" data-pltdoc="x">Weak Boxes</a></td></tr><tr><td align="right">16.2&nbsp;</td><td><a href="ephemerons.html" class="tocviewlink" data-pltdoc="x">Ephemerons</a></td></tr><tr><td align="right">16.3&nbsp;</td><td><a href="willexecutor.html" class="tocviewlink" data-pltdoc="x">Wills and Executors</a></td></tr><tr><td align="right">16.4&nbsp;</td><td><a href="garbagecollection.html" class="tocviewlink" data-pltdoc="x">Garbage Collection</a></td></tr><tr><td align="right">16.5&nbsp;</td><td><a href="phantom-bytes.html" class="tocviewlink" data-pltdoc="x">Phantom Byte Strings</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="versionbox"><span class="version">8.6</span></div><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="os-lib.html" title="backward to &quot;15.10 Additional Operating System Functions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="weakbox.html" title="forward to &quot;16.1 Weak Boxes&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;memory&quot;">16<tt>&nbsp;</tt><a name="(part._memory)"></a>Memory Management</h3><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="weakbox.html" class="toclink" data-pltdoc="x">16.1<span class="hspace">&nbsp;</span>Weak Boxes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="ephemerons.html" class="toclink" data-pltdoc="x">16.2<span class="hspace">&nbsp;</span>Ephemerons</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="willexecutor.html" class="toclink" data-pltdoc="x">16.3<span class="hspace">&nbsp;</span>Wills and Executors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="garbagecollection.html" class="toclink" data-pltdoc="x">16.4<span class="hspace">&nbsp;</span>Garbage Collection</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="phantom-bytes.html" class="toclink" data-pltdoc="x">16.5<span class="hspace">&nbsp;</span>Phantom Byte Strings</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="os-lib.html" title="backward to &quot;15.10 Additional Operating System Functions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="weakbox.html" title="forward to &quot;16.1 Weak Boxes&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/mixins.html b/clones/docs.racket-lang.org/reference/mixins.html
new file mode 100644
index 00000000..4677bb3e
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/mixins.html
@@ -0,0 +1,12 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6.5&nbsp;Mixins</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewselflink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="createinterface.html" class="tocviewlink" data-pltdoc="x">Creating Interfaces</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="createclass.html" class="tocviewlink" data-pltdoc="x">Creating Classes</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="objcreation.html" class="tocviewlink" data-pltdoc="x">Creating Objects</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="ivaraccess.html" class="tocviewlink" data-pltdoc="x">Field and Method Access</a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="mixins.html" class="tocviewselflink" data-pltdoc="x">Mixins</a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="trait.html" class="tocviewlink" data-pltdoc="x">Traits</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="Object_and_Class_Contracts.html" class="tocviewlink" data-pltdoc="x">Object and Class Contracts</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="objectequality.html" class="tocviewlink" data-pltdoc="x">Object Equality and Hashing</a></td></tr><tr><td align="right">6.9&nbsp;</td><td><a href="objectserialize.html" class="tocviewlink" data-pltdoc="x">Object Serialization</a></td></tr><tr><td align="right">6.10&nbsp;</td><td><a href="objectprinting.html" class="tocviewlink" data-pltdoc="x">Object Printing</a></td></tr><tr><td align="right">6.11&nbsp;</td><td><a href="objectutils.html" class="tocviewlink" data-pltdoc="x">Object, Class, and Interface Utilities</a></td></tr><tr><td align="right">6.12&nbsp;</td><td><a href="Surrogates.html" class="tocviewlink" data-pltdoc="x">Surrogates</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="mixins.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._mixin%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">mixin</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="ivaraccess.html" title="backward to &quot;6.4 Field and Method Access&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="trait.html" title="forward to &quot;6.6 Traits&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;mixins&quot;">6.5<tt>&nbsp;</tt><a name="(part._mixins)"></a>Mixins</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._mixin))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="mixins.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._mixin%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">mixin</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">interface-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">interface-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">class-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Produces a <a name="(tech._mixin)"></a><span style="font-style: italic">mixin</span>, which is a procedure that encapsulates a
+class extension, leaving the superclass unspecified.  Each time that a
+mixin is applied to a specific superclass, it produces a new derived
+class using the encapsulated extension.</div></p><p>The given class must implement interfaces produced by the first set of
+<span class="RktVar">interface-expr</span>s.  The result of the procedure is a subclass
+of the given class that implements the interfaces produced by the
+second set of <span class="RktVar">interface-expr</span>s. The <span class="RktVar">class-clause</span>s are
+as for <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span>, to define the class extension encapsulated by
+the mixin.</p><p>Evaluation of a <span class="RktSym"><a href="mixins.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._mixin%29%29" class="RktStxLink" data-pltdoc="x">mixin</a></span> form checks that the
+<span class="RktVar">class-clause</span>s are consistent with both sets of
+<span class="RktVar">interface-expr</span>s.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="ivaraccess.html" title="backward to &quot;6.4 Field and Method Access&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="trait.html" title="forward to &quot;6.6 Traits&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/model.html b/clones/docs.racket-lang.org/reference/model.html
new file mode 100644
index 00000000..38ddfe4c
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/model.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>1&nbsp;Language Model</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewselflink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>1&nbsp;</td><td><a href="model.html" class="tocviewselflink" data-pltdoc="x">Language Model</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">1.1&nbsp;</td><td><a href="eval-model.html" class="tocviewlink" data-pltdoc="x">Evaluation Model</a></td></tr><tr><td align="right">1.2&nbsp;</td><td><a href="syntax-model.html" class="tocviewlink" data-pltdoc="x">Syntax Model</a></td></tr><tr><td align="right">1.3&nbsp;</td><td><a href="reader.html" class="tocviewlink" data-pltdoc="x">The Reader</a></td></tr><tr><td align="right">1.4&nbsp;</td><td><a href="printing.html" class="tocviewlink" data-pltdoc="x">The Printer</a></td></tr><tr><td align="right">1.5&nbsp;</td><td><a href="implementations.html" class="tocviewlink" data-pltdoc="x">Implementations</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="index.html" title="backward to &quot;The Racket Reference&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="eval-model.html" title="forward to &quot;1.1 Evaluation Model&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;model&quot;">1<tt>&nbsp;</tt><a name="(part._model)"></a>Language Model</h3><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html" class="toclink" data-pltdoc="x">1.1<span class="hspace">&nbsp;</span>Evaluation Model</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._cont-model%29" class="toclink" data-pltdoc="x">1.1.1<span class="hspace">&nbsp;</span>Sub-expression Evaluation and Continuations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._.Tail_.Position%29" class="toclink" data-pltdoc="x">1.1.2<span class="hspace">&nbsp;</span>Tail Position</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._values-model%29" class="toclink" data-pltdoc="x">1.1.3<span class="hspace">&nbsp;</span>Multiple Return Values</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._.Top-.Level_.Variables%29" class="toclink" data-pltdoc="x">1.1.4<span class="hspace">&nbsp;</span>Top-Level Variables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._.Objects_and_.Imperative_.Update%29" class="toclink" data-pltdoc="x">1.1.5<span class="hspace">&nbsp;</span>Objects and Imperative Update</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._gc-model%29" class="toclink" data-pltdoc="x">1.1.6<span class="hspace">&nbsp;</span>Garbage Collection</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._.Procedure_.Applications_and_.Local_.Variables%29" class="toclink" data-pltdoc="x">1.1.7<span class="hspace">&nbsp;</span>Procedure Applications and Local Variables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._vars-and-locs%29" class="toclink" data-pltdoc="x">1.1.8<span class="hspace">&nbsp;</span>Variables and Locations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._module-eval-model%29" class="toclink" data-pltdoc="x">1.1.9<span class="hspace">&nbsp;</span>Modules and Module-Level Variables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._module-phase%29" class="toclink" data-pltdoc="x">1.1.9.1<span class="hspace">&nbsp;</span>Phases</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._separate-compilation%29" class="toclink" data-pltdoc="x">1.1.9.2<span class="hspace">&nbsp;</span>The Separate Compilation Guarantee</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._cross-phase._persistent-modules%29" class="toclink" data-pltdoc="x">1.1.9.3<span class="hspace">&nbsp;</span>Cross-Phase Persistent Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._module-redeclare%29" class="toclink" data-pltdoc="x">1.1.9.4<span class="hspace">&nbsp;</span>Module Redeclarations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._submodules%29" class="toclink" data-pltdoc="x">1.1.9.5<span class="hspace">&nbsp;</span>Submodules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._mark-model%29" class="toclink" data-pltdoc="x">1.1.10<span class="hspace">&nbsp;</span>Continuation Frames and Marks</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._prompt-model%29" class="toclink" data-pltdoc="x">1.1.11<span class="hspace">&nbsp;</span>Prompts, Delimited Continuations, and Barriers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._thread-model%29" class="toclink" data-pltdoc="x">1.1.12<span class="hspace">&nbsp;</span>Threads</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._parameter-model%29" class="toclink" data-pltdoc="x">1.1.13<span class="hspace">&nbsp;</span>Parameters</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._exn-model%29" class="toclink" data-pltdoc="x">1.1.14<span class="hspace">&nbsp;</span>Exceptions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval-model.html#%28part._custodian-model%29" class="toclink" data-pltdoc="x">1.1.15<span class="hspace">&nbsp;</span>Custodians</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html" class="toclink" data-pltdoc="x">1.2<span class="hspace">&nbsp;</span>Syntax Model</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._id-model%29" class="toclink" data-pltdoc="x">1.2.1<span class="hspace">&nbsp;</span>Identifiers, Binding, and Scopes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._stxobj-model%29" class="toclink" data-pltdoc="x">1.2.2<span class="hspace">&nbsp;</span>Syntax Objects</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._expansion%29" class="toclink" data-pltdoc="x">1.2.3<span class="hspace">&nbsp;</span>Expansion (Parsing)</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._fully-expanded%29" class="toclink" data-pltdoc="x">1.2.3.1<span class="hspace">&nbsp;</span>Fully Expanded Programs</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._expand-steps%29" class="toclink" data-pltdoc="x">1.2.3.2<span class="hspace">&nbsp;</span>Expansion Steps</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._expand-context-model%29" class="toclink" data-pltdoc="x">1.2.3.3<span class="hspace">&nbsp;</span>Expansion Context</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._intro-binding%29" class="toclink" data-pltdoc="x">1.2.3.4<span class="hspace">&nbsp;</span>Introducing Bindings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._transformer-model%29" class="toclink" data-pltdoc="x">1.2.3.5<span class="hspace">&nbsp;</span>Transformer Bindings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._local-binding-context%29" class="toclink" data-pltdoc="x">1.2.3.6<span class="hspace">&nbsp;</span>Local Binding Context</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._partial-expansion%29" class="toclink" data-pltdoc="x">1.2.3.7<span class="hspace">&nbsp;</span>Partial Expansion</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._intdef-body%29" class="toclink" data-pltdoc="x">1.2.3.8<span class="hspace">&nbsp;</span>Internal Definitions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._mod-parse%29" class="toclink" data-pltdoc="x">1.2.3.9<span class="hspace">&nbsp;</span>Module Expansion, Phases, and Visits</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._macro-introduced-bindings%29" class="toclink" data-pltdoc="x">1.2.3.10<span class="hspace">&nbsp;</span>Macro-Introduced Bindings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._compilation-model%29" class="toclink" data-pltdoc="x">1.2.4<span class="hspace">&nbsp;</span>Compilation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._namespace-model%29" class="toclink" data-pltdoc="x">1.2.5<span class="hspace">&nbsp;</span>Namespaces</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._infernames%29" class="toclink" data-pltdoc="x">1.2.6<span class="hspace">&nbsp;</span>Inferred Value Names</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-model.html#%28part._cross-phase._persistent-grammar%29" class="toclink" data-pltdoc="x">1.2.7<span class="hspace">&nbsp;</span>Cross-Phase Persistent Module Declarations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="reader.html" class="toclink" data-pltdoc="x">1.3<span class="hspace">&nbsp;</span>The Reader</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="printing.html" class="toclink" data-pltdoc="x">1.4<span class="hspace">&nbsp;</span>The Printer</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="implementations.html" class="toclink" data-pltdoc="x">1.5<span class="hspace">&nbsp;</span>Implementations</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="index.html" title="backward to &quot;The Racket Reference&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="eval-model.html" title="forward to &quot;1.1 Evaluation Model&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/modprotect.html b/clones/docs.racket-lang.org/reference/modprotect.html
new file mode 100644
index 00000000..fc1a209c
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/modprotect.html
@@ -0,0 +1,50 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14.10&nbsp;Code Inspectors</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewselflink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Namespaces.html" class="tocviewlink" data-pltdoc="x">Namespaces</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="eval.html" class="tocviewlink" data-pltdoc="x">Evaluation and Compilation</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="load-lang.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>load</span></span> Language</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="Module_Names_and_Loading.html" class="tocviewlink" data-pltdoc="x">Module Names and Loading</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="chaperones.html" class="tocviewlink" data-pltdoc="x">Impersonators and Chaperones</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="securityguards.html" class="tocviewlink" data-pltdoc="x">Security Guards</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="custodians.html" class="tocviewlink" data-pltdoc="x">Custodians</a></td></tr><tr><td align="right">14.8&nbsp;</td><td><a href="threadgroups.html" class="tocviewlink" data-pltdoc="x">Thread Groups</a></td></tr><tr><td align="right">14.9&nbsp;</td><td><a href="inspectors.html" class="tocviewlink" data-pltdoc="x">Structure Inspectors</a></td></tr><tr><td align="right">14.10&nbsp;</td><td><a href="modprotect.html" class="tocviewselflink" data-pltdoc="x">Code Inspectors</a></td></tr><tr><td align="right">14.11&nbsp;</td><td><a href="plumbers.html" class="tocviewlink" data-pltdoc="x">Plumbers</a></td></tr><tr><td align="right">14.12&nbsp;</td><td><a href="Sandboxed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Sandboxed Evaluation</a></td></tr><tr><td align="right">14.13&nbsp;</td><td><a href="repl-module.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>repl</span></span> Library</a></td></tr><tr><td align="right">14.14&nbsp;</td><td><a href="linklets.html" class="tocviewlink" data-pltdoc="x">Linklets and the Core Compiler</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>code-<wbr></wbr>inspector</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="inspectors.html" title="backward to &quot;14.9 Structure Inspectors&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="plumbers.html" title="forward to &quot;14.11 Plumbers&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;modprotect&quot;">14.10<tt>&nbsp;</tt><a name="(part._modprotect)"></a>Code Inspectors</h4><p>In the same way that inspectors control access to structure fields
+(see <a href="inspectors.html" data-pltdoc="x">Structure Inspectors</a>), inspectors also control access to
+<a href="syntax-model.html#%28tech._module._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">module bindings</span></a>. Inspectors used this way are <a name="(tech._code._inspector)"></a><span style="font-style: italic">code
+inspectors</span>. The default code inspector for <a href="syntax-model.html#%28tech._module._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">module
+bindings</span></a> is determined by the <span class="RktSym"><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="RktValLink" data-pltdoc="x">current-code-inspector</a></span>
+parameter, instead of the <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._current-inspector%29%29" class="RktValLink" data-pltdoc="x">current-inspector</a></span> parameter.</p><p>When a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> declaration is evaluated, the value of the
+<span class="RktSym"><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="RktValLink" data-pltdoc="x">current-code-inspector</a></span> parameter is associated with the
+module declaration. When the module is invoked via <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> or
+<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span>, a sub-inspector of the module&rsquo;s
+declaration-time inspector is created, and this sub-inspector is
+associated with the module invocation. Any inspector that controls the
+sub-inspector (including the declaration-time inspector and its
+superior) controls the module invocation. In particular, if the value
+of <span class="RktSym"><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="RktValLink" data-pltdoc="x">current-code-inspector</a></span> never changes, then no control is
+lost for any module invocation, since the module&rsquo;s invocation is
+associated with a sub-inspector of <span class="RktSym"><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="RktValLink" data-pltdoc="x">current-code-inspector</a></span>.</p><p>When an inspector that controls a module invocation is installed with
+<span class="RktSym"><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="RktValLink" data-pltdoc="x">current-code-inspector</a></span>, it enables using
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._module-~3enamespace%29%29" class="RktValLink" data-pltdoc="x">module-&gt;namespace</a></span> on the module, and it enables access to the
+module&rsquo;s <a name="(tech._protected)"></a><span style="font-style: italic">protected</span> exports (i.e., those identifiers exported from the
+module with <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._protect-out%29%29" class="RktStxLink" data-pltdoc="x">protect-out</a></span>) via <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span>. A
+module cannot <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> a module that has a weaker
+declaration-time code inspector.</p><p>When a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> form is expanded or a <a href="syntax-model.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespace</span></a> is
+created, the value of <span class="RktSym"><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="RktValLink" data-pltdoc="x">current-code-inspector</a></span> is associated
+with the module or namespace&rsquo;s top-level <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a>.
+Syntax objects with that <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> gain access to the
+protected and unexported bindings of any module that the inspector
+controls. In the case of a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>, the inspector sticks with
+such syntax objects even the syntax object is used in the expansion of
+code in a less powerful context; furthermore, if the syntax object is
+an identifier that is compiled as a variable reference, the inspector
+sticks with the variable reference even if it appears in a module form
+that is evaluated (i.e., declared) with a weaker inspector. When a
+syntax object or variable reference is within compiled code that is
+printed (see <a href="printing.html#%28part._print-compiled%29" data-pltdoc="x">Printing Compiled Code</a>), the associated inspector is
+not preserved.</p><p>When compiled code in printed form is <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> back in, no
+inspectors are associated with the code. When the code is
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span>uated, the instantiated syntax-object literals and
+module-variable references acquire value of
+<span class="RktSym"><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="RktValLink" data-pltdoc="x">current-code-inspector</a></span> as their inspector.</p><p>When a module instantiation is attached to multiple <a href="syntax-model.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespaces</span></a>,
+each with its own <a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module registry</span></a>, the inspector for the module
+invocation can be registry-specific. The invocation inspector in a
+particular module registry can be changed via
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-unprotect-module%29%29" class="RktValLink" data-pltdoc="x">namespace-unprotect-module</a></span> (but changing the inspector
+requires control over the old one).</p><p class="SHistory">Changed in version 8.1.0.8 of package <span class="stt">base</span>: Added constraint against
+ <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> of a module with
+ a weaker code inspector.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-code-inspector))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-code-inspector</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-code-inspector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">insp</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">insp</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines an inspector to control access to
+module bindings and redefinitions.</div></p><p>If the code inspector is changed from its original value, then
+bytecode loaded by the default <a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a> is marked
+as non-runnable.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="inspectors.html" title="backward to &quot;14.9 Structure Inspectors&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="plumbers.html" title="forward to &quot;14.11 Plumbers&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/module.html b/clones/docs.racket-lang.org/reference/module.html
new file mode 100644
index 00000000..cc6ffb6a
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/module.html
@@ -0,0 +1,196 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.1&nbsp;Modules: module, module*, ...</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewselflink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">module</span></span></a></td></tr><tr><td><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">module*</span></span></a></td></tr><tr><td><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._module%2B%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">module+</span></span></a></td></tr><tr><td><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25module-begin%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%module-<wbr></wbr>begin</span></span></a></td></tr><tr><td><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25printing-module-begin%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%printing-<wbr></wbr>module-<wbr></wbr>begin</span></span></a></td></tr><tr><td><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-module-begin%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%plain-<wbr></wbr>module-<wbr></wbr>begin</span></span></a></td></tr><tr><td><a href="module.html#%28form._%28%28quote._~23~25kernel%29._~23~25declare%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%declare</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="syntax.html" title="backward to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="require.html" title="forward to &quot;3.2 Importing and Exporting: require and provide&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;module&quot;">3.1<tt>&nbsp;</tt><a name="(part._module)"></a>Modules: <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>, <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span>, ...</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._module-syntax%2529&amp;version=8.6" class="Sq" data-pltdoc="x">The <span class="RktSym"><span class="RktStxLink">module</span></span> Form</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._module))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">module</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span><span class="hspace">&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Declares a top-level module or a <a href="eval-model.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodule</span></a>. For a top-level
+module, if the <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-declare-name%29%29" class="RktValLink" data-pltdoc="x">current-module-declare-name</a></span> parameter is set,
+the parameter value is used for the module name and <span class="RktVar">id</span> is
+ignored, otherwise <span class="RktPn">(</span><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span> is the name of the
+declared module. For a <a href="eval-model.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodule</span></a>, <span class="RktVar">id</span> is the name of
+the submodule to be used as an element within a <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxLink" data-pltdoc="x">submod</a></span> module
+path. A <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> form is not allowed in an <a href="syntax-model.html#%28tech._expression._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">expression context</span></a>
+or <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a>.</div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span>For a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>-like form that works in
+definitions context other than the top level or a module body, see
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=compatibility&amp;rel=compatibility-package.html%23%2528form._%2528%2528lib._compatibility%252Fpackage..rkt%2529._define-package%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-package</a></span>.</p></blockquote></blockquote></blockquote><p>The <span class="RktVar">module-path</span> form must be as for <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>, and it
+supplies the initial bindings for the body <span class="RktVar">form</span>s. That is, it
+is treated like a <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktVar">module-path</span><span class="RktPn">)</span> prefix before the
+<span class="RktVar">form</span>s, except that the bindings introduced by
+<span class="RktVar">module-path</span> can be shadowed by definitions and
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s in the module body <span class="RktVar">form</span>s.</p><p>If a single <span class="RktVar">form</span> is provided, then it is partially expanded
+in a <a href="syntax-model.html#%28tech._module._begin._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">module-begin context</span></a>. If the expansion leads to
+<span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-module-begin%29%29" class="RktStxLink" data-pltdoc="x">#%plain-module-begin</a></span>, then the body of the
+<span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-module-begin%29%29" class="RktStxLink" data-pltdoc="x">#%plain-module-begin</a></span> is the body of the module. If partial
+expansion leads to any other primitive form, then the form is wrapped
+with <span class="RktSym">#%module-begin</span> using the lexical context of the
+module body; this identifier must be bound by the initial
+<span class="RktVar">module-path</span> import, and its expansion must produce a
+<span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-module-begin%29%29" class="RktStxLink" data-pltdoc="x">#%plain-module-begin</a></span> to supply the module body. Finally, if
+multiple <span class="RktVar">form</span>s are provided, they are wrapped with
+<span class="RktSym">#%module-begin</span>, as in the case where a single
+<span class="RktVar">form</span> does not expand to <span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-module-begin%29%29" class="RktStxLink" data-pltdoc="x">#%plain-module-begin</a></span>.</p><p>After such wrapping, if any, and before any expansion, an
+<a name="(idx._(gentag._98._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">enclosing-module-name</span> property is attached to the
+<span class="RktSym">#%module-begin</span> syntax object (see
+<a href="stxprops.html" data-pltdoc="x">Syntax Object Properties</a>); the property&rsquo;s value is a symbol
+corresponding to <span class="RktVar">id</span>.</p><p>Each <span class="RktVar">form</span> is partially expanded (see
+<a href="syntax-model.html#%28part._partial-expansion%29" data-pltdoc="x">Partial Expansion</a>) in a <a href="syntax-model.html#%28tech._module._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">module context</span></a>. Further
+action depends on the shape of the form:</p><ul><li><p>If it is a <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> form, the sub-forms are flattened
+out into the module&rsquo;s body and immediately processed in place of the
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span>.</p></li><li><p>If it is a <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span> form, then the right-hand side is
+evaluated (in <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> 1), and the binding is immediately
+installed for further partial expansion within the
+module. Evaluation of the right-hand side is <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>d
+to set <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span> as in <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntax%29%29" class="RktStxLink" data-pltdoc="x">let-syntax</a></span>.</p></li><li><p>If it is a <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> form, then the body is
+expanded (in <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> 1) and evaluated. Expansion within a
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> form proceeds with the same
+partial-expansion process as for a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> body, but in a
+higher <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a>, and saving all <span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25provide%29%29" class="RktStxLink" data-pltdoc="x">#%provide</a></span> forms for all
+phases until the end of the <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>&rsquo;s expansion. Evaluation
+of the body is <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>d to set
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span> as in <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntax%29%29" class="RktStxLink" data-pltdoc="x">let-syntax</a></span>.</p></li><li><p>If the form is a <span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25require%29%29" class="RktStxLink" data-pltdoc="x">#%require</a></span> form, bindings are introduced
+immediately, and the imported modules are <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d or
+<a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed as appropriate.</p></li><li><p>If the form is a <span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25provide%29%29" class="RktStxLink" data-pltdoc="x">#%provide</a></span> form, then it is recorded for
+processing after the rest of the body.</p></li><li><p>If the form is a <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span> form, then the binding
+is installed immediately, but the right-hand expression is not
+expanded further.</p></li><li><p>If the form is a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> form, then it is immediately
+expanded and declared for the extent of the current top-level
+enclosing module&rsquo;s expansion.</p></li><li><p>If the form is a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> form, then it is not
+expanded further.</p></li><li><p>Similarly, if the form is an expression, it is
+not expanded further.</p></li></ul><p>After all <span class="RktVar">form</span>s have been partially expanded this way, then
+the remaining expression forms (including those on the right-hand side
+of a definition) are expanded in an expression context. After all
+expression forms, <span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25provide%29%29" class="RktStxLink" data-pltdoc="x">#%provide</a></span> forms are processed in the order
+in which they appear (independent of <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a>) in the expanded
+module. Finally, all <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> forms are expanded in order, so
+that each becomes available for use by subsequent <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span>
+forms; the enclosing module itself is also available for use by
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> <a href="eval-model.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodules</span></a>.</p><p>The scope of all imported identifiers covers the entire module body,
+except for nested <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> and <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> forms (assuming
+a non-<span class="RktVal">#f</span> <span class="RktVar">module-path</span> in the latter case).
+The scope of any identifier defined within the module body similarly
+covers the entire module body except for such nested <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>
+and <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> forms.
+The ordering of syntax definitions does not affect the scope of the
+syntax names; a transformer for <span class="RktSym">A</span> can produce expressions
+containing <span class="RktSym">B</span>, while the transformer for <span class="RktSym">B</span> produces
+expressions containing <span class="RktSym">A</span>, regardless of the order of
+declarations for <span class="RktSym">A</span> and <span class="RktSym">B</span>. However, a syntactic form
+that produces syntax definitions must be defined before it is used.</p><p>No identifier can be imported or defined more than once at any
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> within a single module, except that a definition
+via <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span> or <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span> can shadow a
+preceding import via <span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25require%29%29" class="RktStxLink" data-pltdoc="x">#%require</a></span>.
+Every exported identifier must be imported or
+defined. No expression can refer to a <a href="eval-model.html#%28tech._top._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level variable</span></a>.
+A <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> form in which the enclosing module&rsquo;s bindings are visible
+(i.e., a nested <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> with <span class="RktVal">#f</span> instead of a <span class="RktVar">module-path</span>)
+can define or import bindings that <a href="syntax-model.html#%28tech._shadow%29" class="techoutside" data-pltdoc="x"><span class="techinside">shadow</span></a> the enclosing module&rsquo;s bindings.</p><p>The evaluation of a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> form does not evaluate the
+expressions in the body of the module (except sometimes for redeclarations;
+see <a href="eval-model.html#%28part._module-redeclare%29" data-pltdoc="x">Module Redeclarations</a>). Evaluation merely declares a
+module, whose full name depends both on <span class="RktVar">id</span> or
+<span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-declare-name%29%29" class="RktValLink" data-pltdoc="x">current-module-declare-name</a></span><span class="RktPn">)</span>.</p><p>A module body is executed only when the module is explicitly
+<a href="eval-model.html#%28tech._instantiate%29" data-pltdoc="x">instantiate</a>d via <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> or
+<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span>. On invocation, imported modules are
+instantiated in the order in which they are <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>d
+into the module (although earlier instantiations or transitive
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s can trigger the instantiation of a module before
+its order within a given module). Then, expressions and definitions
+are evaluated in order as they appear within the module. Each
+evaluation of an expression or definition is wrapped with a
+continuation prompt (see <span class="RktSym"><a href="cont.html#%28def._%28%28quote._~23~25kernel%29._call-with-continuation-prompt%29%29" class="RktValLink" data-pltdoc="x">call-with-continuation-prompt</a></span>) for
+the default <a href="eval-model.html#%28tech._prompt._tag%29" class="techoutside" data-pltdoc="x"><span class="techinside">prompt tag</span></a> and using a prompt handler that re-aborts
+and propagates its argument to the next enclosing prompt. Each evaluation
+of a definition is followed, outside of the prompt, by a check that
+each of the definition&rsquo;s variables has a value; if the portion of the
+prompt-delimited continuation that installs values is skipped, then
+the <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3acontract~3avariable~3f%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:variable?</a></span> exception is raised.</p><p>Portions of a module body at higher phase levels are delimited
+similarly to run-time portions. For example, portions of a module
+within <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> are delimited by a continuation
+prompt both as the module is expanded and when it is visited. The
+evaluation of a <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span> form is delimited, but unlike
+<span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span>, there is no check that the syntax definition
+completed.</p><p>Accessing a <a href="eval-model.html#%28tech._module._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">module-level variable</span></a> before it is defined signals
+a run-time error, just like accessing an undefined global variable.
+If a module (in its fully expanded form) does not contain a
+<span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>  for an identifier that defined within the module, then
+the identifier is a <span style="font-style: italic">constant</span> after it is defined; its value
+cannot be changed afterward, not even through reflective
+mechanisms. The <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-enforce-module-constants%29%29" class="RktValLink" data-pltdoc="x">compile-enforce-module-constants</a></span> parameter,
+however, can be used to disable enforcement of constants.</p><p>When a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> representing a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> form has a
+<a name="(idx._(gentag._99._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">module-language</span> <a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax property</span></a> attached, and
+when the property value is a vector of three elements where the first
+is a module path (in the sense of <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span>) and the
+second is a symbol, then the property value is preserved in the
+corresponding compiled and/or declared module. The third component of
+the vector should be printable and <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>able, so that it can
+be preserved in marshaled bytecode. The <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>
+and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> languages attach
+<span class="RktVal">'</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">racket/language-info</span><span class="stt"> </span><span class="RktVal">get-info</span><span class="stt"> </span><span class="RktVal">#f</span><span class="RktVal">)</span> to a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>
+form. See also <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-language-info%29%29" class="RktValLink" data-pltdoc="x">module-compiled-language-info</a></span>,
+<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3elanguage-info%29%29" class="RktValLink" data-pltdoc="x">module-&gt;language-info</a></span>, and
+<a href="running-sa.html#%28mod-path._racket%2Flanguage-info%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/language-info</span></a>.</p><p>See also <a href="eval-model.html#%28part._module-eval-model%29" data-pltdoc="x">Modules and Module-Level Variables</a>, <a href="syntax-model.html#%28part._mod-parse%29" data-pltdoc="x">Module Expansion, Phases, and Visits</a>, and
+<a href="Expanding_Top-Level_Forms.html#%28part._modinfo%29" data-pltdoc="x">Information on Expanded Modules</a>.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">duck</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-eggs</span><span class="hspace">&nbsp;</span><span class="RktSym">quack</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-eggs</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">quack</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._unless%29%29" class="RktStxLink" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"quack\n"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">quack</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.3 of package <span class="stt">base</span>: Changed <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span>
+and <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span> to
+shadow any preceding import, and
+dropped the use of <span class="RktVal">'</span><span class="RktVal">submodule</span>
+<a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax property</span></a> values on nested
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> or <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span>
+forms.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._module*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">module*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span><span class="hspace">&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">module*</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._submodules%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Submodules</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span>.</p></blockquote></blockquote></blockquote></div></p><p>Like <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>, but only for declaring a <a href="eval-model.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodule</span></a> within
+a module, and for submodules that may <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> the enclosing module.</p><p>Instead of a <span class="RktVar">module-path</span> after <span class="RktVar">id</span>, <span class="RktVal">#f</span>
+indicates that all bindings from the enclosing module are visible in
+the submodule. In that case, <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> forms that wrap
+the <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> form shift the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> of the
+enclosing module&rsquo;s bindings relative to the submodule. The macro
+expander handles such nesting by shifting the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> of
+the <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> form so that its body starts at <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase
+level</span></a> 0, expanding, and then reverting the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> shift;
+beware that this process can leave <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax objects</span></a> as
+<span class="RktVal">'</span><span class="RktVal">origin</span> <a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax property</span></a> values out-of-sync with the
+expanded module.</p><p>When a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> form has a <span class="RktVar">module-path</span>, the submodule
+expansion starts by removing the <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scopes</span></a> of the enclosing
+module, the same as the <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> form. No shifting compensates
+for any <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> forms that may wrap the submodule.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._module+))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._module%2B%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">module+</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._main-and-test%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Main and Test Submodules</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces <span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._module%2B%29%29" class="RktStxLink" data-pltdoc="x">module+</a></span>.</p></blockquote></blockquote></blockquote></div></p><p>Declares and/or adds to a <a href="eval-model.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodule</span></a> named <span class="RktVar">id</span>.</p><p>Each addition for <span class="RktVar">id</span> is combined in order to form the entire
+submodule using <span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVal">#f</span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span> at the end of the
+enclosing module. If there is only one <span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._module%2B%29%29" class="RktStxLink" data-pltdoc="x">module+</a></span> for a given
+<span class="RktVar">id</span>, then <span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._module%2B%29%29" class="RktStxLink" data-pltdoc="x">module+</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">form</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> is equivalent to
+<span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVal">#f</span><span class="stt"> </span><span class="RktVar">form</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>, but still moved to the end of the
+enclosing module.</p><p>When a module contains multiple submodules declared with
+<span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._module%2B%29%29" class="RktStxLink" data-pltdoc="x">module+</a></span>, then the relative order of the initial
+<span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._module%2B%29%29" class="RktStxLink" data-pltdoc="x">module+</a></span> declarations for each submodule determines the
+relative order of the <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> declarations at the end of the
+enclosing module.</p><p>A submodule must not be defined using <span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._module%2B%29%29" class="RktStxLink" data-pltdoc="x">module+</a></span> <span class="emph">and</span>
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> or <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span>. That is, if a submodule is made
+of <span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._module%2B%29%29" class="RktStxLink" data-pltdoc="x">module+</a></span> pieces, then it must be made <span class="emph">only</span> of
+<span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._module%2B%29%29" class="RktStxLink" data-pltdoc="x">module+</a></span> pieces. </p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._~23~25module-begin))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25module-begin%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">#%module-begin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Legal only in a <a href="syntax-model.html#%28tech._module._begin._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">module begin context</span></a>, and handled by the
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> and <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> forms.</div></p><p>The <span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25module-begin%29%29" class="RktStxLink" data-pltdoc="x">#%module-begin</a></span> form of <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> wraps
+every top-level expression to print non-<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a> results using
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-print%29%29" class="RktValLink" data-pltdoc="x">current-print</a></span>.</p><p>The <span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25module-begin%29%29" class="RktStxLink" data-pltdoc="x">#%module-begin</a></span> form of <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> also
+declares a <span class="RktSym">configure-runtime</span> submodule (before any other
+<span class="RktVar">form</span>), unless some <span class="RktVar">form</span> is either an immediate
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> or <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> form with the name
+<span class="RktSym">configure-runtime</span>. If a <span class="RktSym">configure-runtime</span> submodule
+is added, the submodule calls the <span class="RktSym">configure</span> function of
+<a href="running-sa.html#%28mod-path._racket%2Fruntime-config%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/runtime-config</span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._~23~25printing-module-begin))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25printing-module-begin%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">#%printing-module-begin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Legal only in a <a href="syntax-model.html#%28tech._module._begin._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">module begin context</span></a>.</div></p><p>Like <span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25module-begin%29%29" class="RktStxLink" data-pltdoc="x">#%module-begin</a></span>, but without adding a
+<span class="RktSym">configure-runtime</span> submodule.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._~23~25plain-module-begin))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-module-begin%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">#%plain-module-begin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Legal only in a <a href="syntax-model.html#%28tech._module._begin._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">module begin context</span></a>, and handled by the
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> and <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> forms.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._~23~25declare))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._~23~25declare%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">#%declare</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">declaration-keyword</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">declaration-keyword</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:cross-phase-persistent</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:empty-namespace</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:unsafe</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:realm</span><span class="hspace">&nbsp;</span><span class="RktVar">identifier</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Declarations that affect run-time or reflective properties of the
+module:</div></p><ul><li><p><a name="(idx._(gentag._100._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktPn">#:cross-phase-persistent</span> &#8212;<wbr></wbr> declares the
+module as <a href="eval-model.html#%28tech._cross._phase._persistent%29" class="techoutside" data-pltdoc="x"><span class="techinside">cross-phase persistent</span></a>, and reports a syntax
+error if the module does not meet the import or syntactic
+constraints of a <a href="eval-model.html#%28tech._cross._phase._persistent%29" class="techoutside" data-pltdoc="x"><span class="techinside">cross-phase persistent</span></a> module.</p></li><li><p><a name="(idx._(gentag._101._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktPn">#:empty-namespace</span> &#8212;<wbr></wbr> declares that
+ <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._module-~3enamespace%29%29" class="RktValLink" data-pltdoc="x">module-&gt;namespace</a></span> for this module should produce a
+ namespace with no bindings; limiting namespace support in this
+ way can reduce the <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> that
+ otherwise must be preserved for the module.</p></li><li><p><a name="(idx._(gentag._102._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktPn">#:unsafe</span> &#8212;<wbr></wbr> declares that the module can be
+ compiled without checks that could trigger
+ <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span>, and the resulting behavior is
+ unspecified for an evaluation where <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span>
+ should have been raised; see also <a href="unsafe.html" data-pltdoc="x">Unsafe Operations</a>. For
+ example, a use of <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> can be compiled as a use of
+ <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-car%29%29" class="RktValLink" data-pltdoc="x">unsafe-car</a></span>, and the behavior is unspecified is
+ <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-car%29%29" class="RktValLink" data-pltdoc="x">unsafe-car</a></span> is applied to a non-pair. The
+ <span class="RktPn">#:unsafe</span> declaration keyword is allowed only when the
+ current <a href="modprotect.html#%28tech._code._inspector%29" class="techoutside" data-pltdoc="x"><span class="techinside">code inspector</span></a> is the initial one. Macros can
+ generate conditionally unsafe code, depending on the expansion
+ context, by expanding to a use of
+ <span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-from-unsafe~3f%29%29" class="RktValLink" data-pltdoc="x">variable-reference-from-unsafe?</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="Locations____variable-reference.html#%28form._%28%28quote._~23~25kernel%29._~23~25variable-reference%29%29" class="RktStxLink" data-pltdoc="x">#%variable-reference</a></span><span class="RktPn">)</span><span class="RktPn">)</span>.</p></li><li><p><a name="(idx._(gentag._103._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktPn">#:realm</span><span class="stt"> </span><span class="RktVar">identifier</span> &#8212;<wbr></wbr> declares that
+ the module and any procedures within the module are given a
+ <a href="exns.html#%28tech._realm%29" class="techoutside" data-pltdoc="x"><span class="techinside">realm</span></a> that is the symbol form of <span class="RktVar">identifier</span>, effectively
+ overriding the value of <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile-realm%29%29" class="RktValLink" data-pltdoc="x">current-compile-realm</a></span>.</p></li></ul><p>A <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._~23~25declare%29%29" class="RktStxLink" data-pltdoc="x">#%declare</a></span> form must appear in a <a href="syntax-model.html#%28tech._module._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">module
+context</span></a> or a <a href="syntax-model.html#%28tech._module._begin._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">module-begin context</span></a>. Each
+<span class="RktVar">declaration-keyword</span> can be declared at most once within a
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> body.</p><p class="SHistory">Changed in version 6.3 of package <span class="stt">base</span>: Added <span class="RktPn">#:empty-namespace</span>.<br/>Changed in version 7.9.0.5: Added <span class="RktPn">#:unsafe</span>.<br/>Changed in version 8.4.0.2: Added <span class="RktPn">#:realm</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="syntax.html" title="backward to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="require.html" title="forward to &quot;3.2 Importing and Exporting: require and provide&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/mpairs.html b/clones/docs.racket-lang.org/reference/mpairs.html
new file mode 100644
index 00000000..32a776fc
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/mpairs.html
@@ -0,0 +1,20 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.11&nbsp;Mutable Pairs and Lists</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewselflink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewselflink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.11.1&nbsp;</td><td><a href="mpairs.html#%28part._.Mutable_.Pair_.Constructors_and_.Selectors%29" class="tocviewlink" data-pltdoc="x">Mutable Pair Constructors and Selectors</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">4.11.1<tt>&nbsp;</tt></span><a href="mpairs.html#%28part._.Mutable_.Pair_.Constructors_and_.Selectors%29" class="tocsubseclink" data-pltdoc="x">Mutable Pair Constructors and Selectors</a></td></tr><tr><td><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mpair~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">mpair?</span></span></a></td></tr><tr><td><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">mcons</span></span></a></td></tr><tr><td><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcar%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">mcar</span></span></a></td></tr><tr><td><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcdr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">mcdr</span></span></a></td></tr><tr><td><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._set-mcar%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>mcar!</span></span></a></td></tr><tr><td><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._set-mcdr%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>mcdr!</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="pairs.html" title="backward to &quot;4.10 Pairs and Lists&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="vectors.html" title="forward to &quot;4.12 Vectors&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;mpairs&quot;">4.11<tt>&nbsp;</tt><a name="(part._mpairs)"></a>Mutable Pairs and Lists</h4><p>A <a name="(tech._mutable._pair)"></a><span style="font-style: italic">mutable pair</span> is like a pair created by <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span>, but
+it supports <span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._set-mcar%21%29%29" class="RktValLink" data-pltdoc="x">set-mcar!</a></span> and <span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._set-mcdr%21%29%29" class="RktValLink" data-pltdoc="x">set-mcdr!</a></span> mutation
+operations to change the parts of the mutable pair (like traditional Lisp and
+Scheme pairs).</p><p>A <a name="(tech._mutable._list)"></a><span style="font-style: italic">mutable list</span> is analogous to a list created with pairs, but
+instead created with <a href="mpairs.html#%28tech._mutable._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutable pairs</span></a>.</p><p>A <a href="mpairs.html#%28tech._mutable._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutable pair</span></a> is not a <a href="pairs.html#%28tech._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">pair</span></a>; they are completely
+separate datatypes. Similarly, a <a href="mpairs.html#%28tech._mutable._list%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutable list</span></a> is not a
+<a href="pairs.html#%28tech._list%29" class="techoutside" data-pltdoc="x"><span class="techinside">list</span></a>, except that the empty list is also the empty mutable
+list. Instead of programming with mutable pairs and mutable lists,
+data structures such as pairs, lists, and hash tables are practically
+always better choices.</p><p>A <a href="mpairs.html#%28tech._mutable._list%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutable list</span></a> can be used as a single-valued sequence (see
+<a href="sequences.html" data-pltdoc="x">Sequences</a>). The elements of the <a href="mpairs.html#%28tech._mutable._list%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutable list</span></a> serve as elements
+of the sequence. See also <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mlist%29%29" class="RktValLink" data-pltdoc="x">in-mlist</a></span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Mutable_Pair_Constructors_and_Selectors&quot;">4.11.1<tt>&nbsp;</tt><a name="(part._.Mutable_.Pair_.Constructors_and_.Selectors)"></a>Mutable Pair Constructors and Selectors</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._mpair~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mpair~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">mpair?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is
+a <a href="mpairs.html#%28tech._mutable._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutable pair</span></a>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._mcons))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="RktValDef RktValLink" data-pltdoc="x">mcons</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">d</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mpair~3f%29%29" class="RktValLink" data-pltdoc="x">mpair?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">d</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a newly allocated
+<a href="mpairs.html#%28tech._mutable._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutable pair</span></a> whose first
+element is <span class="RktVar">a</span> and second element is <span class="RktVar">d</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._mcar))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcar%29%29" class="RktValDef RktValLink" data-pltdoc="x">mcar</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mpair~3f%29%29" class="RktValLink" data-pltdoc="x">mpair?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the first element of the
+<a href="mpairs.html#%28tech._mutable._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutable pair</span></a> <span class="RktVar">p</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._mcdr))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcdr%29%29" class="RktValDef RktValLink" data-pltdoc="x">mcdr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mpair~3f%29%29" class="RktValLink" data-pltdoc="x">mpair?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the second element of the
+<a href="mpairs.html#%28tech._mutable._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutable pair</span></a> <span class="RktVar">p</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._set-mcar!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._set-mcar%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-mcar!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mpair~3f%29%29" class="RktValLink" data-pltdoc="x">mpair?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Changes the <a href="mpairs.html#%28tech._mutable._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutable pair</span></a> <span class="RktVar">p</span> so that its first element is
+<span class="RktVar">v</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._set-mcdr!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._set-mcdr%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-mcdr!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mpair~3f%29%29" class="RktValLink" data-pltdoc="x">mpair?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Changes the <a href="mpairs.html#%28tech._mutable._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutable pair</span></a> <span class="RktVar">p</span> so that its second element is
+<span class="RktVar">v</span>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="pairs.html" title="backward to &quot;4.10 Pairs and Lists&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="vectors.html" title="forward to &quot;4.12 Vectors&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/mzlib_class.html b/clones/docs.racket-lang.org/reference/mzlib_class.html
new file mode 100644
index 00000000..dcff48de
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/mzlib_class.html
@@ -0,0 +1,29 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6&nbsp;Classes and Objects</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewselflink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewselflink" data-pltdoc="x">Classes and Objects</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="createinterface.html" class="tocviewlink" data-pltdoc="x">Creating Interfaces</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="createclass.html" class="tocviewlink" data-pltdoc="x">Creating Classes</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="objcreation.html" class="tocviewlink" data-pltdoc="x">Creating Objects</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="ivaraccess.html" class="tocviewlink" data-pltdoc="x">Field and Method Access</a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="mixins.html" class="tocviewlink" data-pltdoc="x">Mixins</a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="trait.html" class="tocviewlink" data-pltdoc="x">Traits</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="Object_and_Class_Contracts.html" class="tocviewlink" data-pltdoc="x">Object and Class Contracts</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="objectequality.html" class="tocviewlink" data-pltdoc="x">Object Equality and Hashing</a></td></tr><tr><td align="right">6.9&nbsp;</td><td><a href="objectserialize.html" class="tocviewlink" data-pltdoc="x">Object Serialization</a></td></tr><tr><td align="right">6.10&nbsp;</td><td><a href="objectprinting.html" class="tocviewlink" data-pltdoc="x">Object Printing</a></td></tr><tr><td align="right">6.11&nbsp;</td><td><a href="objectutils.html" class="tocviewlink" data-pltdoc="x">Object, Class, and Interface Utilities</a></td></tr><tr><td align="right">6.12&nbsp;</td><td><a href="Surrogates.html" class="tocviewlink" data-pltdoc="x">Surrogates</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="structinfo.html" title="backward to &quot;5.7 Structure Type Transformer Binding&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="createinterface.html" title="forward to &quot;6.1 Creating Interfaces&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;mzlib:class&quot;">6<tt>&nbsp;</tt><a name="(part._mzlib~3aclass)"></a><a name="(mod-path._racket/class)"></a>Classes and Objects</h3><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=classes.html&amp;version=8.6" class="Sq" data-pltdoc="x">Classes and Objects</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces classes and objects.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="mzlib_class.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/class</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="mzlib_class.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/class</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p>A <a name="(tech._clas)"></a><span style="font-style: italic">class</span> specifies</p><ul><li><p>a collection of fields;</p></li><li><p>a collection of methods;</p></li><li><p>initial value expressions for the fields;  and</p></li><li><p>initialization variables that are bound to initialization
+arguments.</p></li></ul><p>In the context of the class system, an <span style="font-style: italic">object</span> is a
+collection of bindings for fields that are instantiated according to a
+class description.</p><p>The class system allows a program to define a new class (a
+<a name="(tech._derived._clas)"></a><span style="font-style: italic">derived class</span>) in terms of an existing class (the
+<a name="(tech._superclas)"></a><span style="font-style: italic">superclass</span>) using inheritance, overriding, and augmenting:</p><ul><li><p><a name="(tech._inheritance)"></a><span style="font-style: italic">inheritance</span>: An object of a derived class supports
+methods and instantiates fields declared by the derived class&rsquo;s
+superclass, as well as methods and fields declared in the derived
+class expression.</p></li><li><p><a name="(tech._overriding)"></a><span style="font-style: italic">overriding</span>: Some methods declared in a superclass can
+be replaced in the derived class. References to the overridden method
+in the superclass use the implementation in the derived class.</p></li><li><p><a name="(tech._augmenting)"></a><span style="font-style: italic">augmenting</span>: Some methods declared in a superclass can
+be merely extended in the derived class. The superclass method
+specifically delegates to the augmenting method in the derived class.</p></li></ul><p>An <a name="(tech._interface)"></a><span style="font-style: italic">interface</span> is a collection of method names to be
+implemented by a class, combined with a derivation requirement. A
+class <a name="(tech._implement)"></a><span style="font-style: italic">implements</span> an interface when it</p><ul><li><p>declares (or inherits) a public method for each variable in the
+interface;</p></li><li><p>is derived from the class required by the interface, if any; and</p></li><li><p>specifically declares its intention to implement the interface.</p></li></ul><p>A class can implement any number of interfaces. A derived class
+automatically implements any interface that its superclass
+implements. Each class also implements an implicitly-defined interface
+that is associated with the class. The implicitly-defined interface
+contains all of the class&rsquo;s public method names, and it requires that
+all other implementations of the interface are derived from the class.</p><p>A new interface can <a name="(tech._extend)"></a><span style="font-style: italic">extend</span> one or more interfaces with
+additional method names; each class that implements the extended
+interface also implements the original interfaces. The derivation
+requirements of the original interface must be consistent, and the
+extended interface inherits the most specific derivation requirement
+from the original interfaces.</p><p>Classes, objects, and interfaces are all values. However, a class or
+interface is not an object (i.e., there are no &ldquo;meta-classes&rdquo; or
+&ldquo;meta-interfaces&rdquo;).</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="createinterface.html" class="toclink" data-pltdoc="x">6.1<span class="hspace">&nbsp;</span>Creating Interfaces</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="createclass.html" class="toclink" data-pltdoc="x">6.2<span class="hspace">&nbsp;</span>Creating Classes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="createclass.html#%28part._clinitvars%29" class="toclink" data-pltdoc="x">6.2.1<span class="hspace">&nbsp;</span>Initialization Variables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="createclass.html#%28part._clfields%29" class="toclink" data-pltdoc="x">6.2.2<span class="hspace">&nbsp;</span>Fields</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="createclass.html#%28part._clmethods%29" class="toclink" data-pltdoc="x">6.2.3<span class="hspace">&nbsp;</span>Methods</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="createclass.html#%28part._clmethoddefs%29" class="toclink" data-pltdoc="x">6.2.3.1<span class="hspace">&nbsp;</span>Method Definitions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="createclass.html#%28part._classinherit%29" class="toclink" data-pltdoc="x">6.2.3.2<span class="hspace">&nbsp;</span>Inherited and Superclass Methods</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="createclass.html#%28part._extnames%29" class="toclink" data-pltdoc="x">6.2.3.3<span class="hspace">&nbsp;</span>Internal and External Names</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="objcreation.html" class="toclink" data-pltdoc="x">6.3<span class="hspace">&nbsp;</span>Creating Objects</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="ivaraccess.html" class="toclink" data-pltdoc="x">6.4<span class="hspace">&nbsp;</span>Field and Method Access</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="ivaraccess.html#%28part._methodcalls%29" class="toclink" data-pltdoc="x">6.4.1<span class="hspace">&nbsp;</span>Methods</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="ivaraccess.html#%28part._.Fields%29" class="toclink" data-pltdoc="x">6.4.2<span class="hspace">&nbsp;</span>Fields</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="ivaraccess.html#%28part._.Generics%29" class="toclink" data-pltdoc="x">6.4.3<span class="hspace">&nbsp;</span>Generics</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="mixins.html" class="toclink" data-pltdoc="x">6.5<span class="hspace">&nbsp;</span>Mixins</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="trait.html" class="toclink" data-pltdoc="x">6.6<span class="hspace">&nbsp;</span>Traits</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Object_and_Class_Contracts.html" class="toclink" data-pltdoc="x">6.7<span class="hspace">&nbsp;</span>Object and Class Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="objectequality.html" class="toclink" data-pltdoc="x">6.8<span class="hspace">&nbsp;</span>Object Equality and Hashing</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="objectserialize.html" class="toclink" data-pltdoc="x">6.9<span class="hspace">&nbsp;</span>Object Serialization</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="objectprinting.html" class="toclink" data-pltdoc="x">6.10<span class="hspace">&nbsp;</span>Object Printing</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="objectutils.html" class="toclink" data-pltdoc="x">6.11<span class="hspace">&nbsp;</span>Object, Class, and Interface Utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Surrogates.html" class="toclink" data-pltdoc="x">6.12<span class="hspace">&nbsp;</span>Surrogates</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="structinfo.html" title="backward to &quot;5.7 Structure Type Transformer Binding&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="createinterface.html" title="forward to &quot;6.1 Creating Interfaces&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/mzlib_unit.html b/clones/docs.racket-lang.org/reference/mzlib_unit.html
new file mode 100644
index 00000000..cfd8244e
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/mzlib_unit.html
@@ -0,0 +1,10 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7&nbsp;Units</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="creatingunits.html" class="tocviewlink" data-pltdoc="x">Creating Units</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="invokingunits.html" class="tocviewlink" data-pltdoc="x">Invoking Units</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="compoundunits.html" class="tocviewlink" data-pltdoc="x">Linking Units and Creating Compound Units</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="linkinference.html" class="tocviewlink" data-pltdoc="x">Inferred Linking</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="Generating_A_Unit_from_Context.html" class="tocviewlink" data-pltdoc="x">Generating A Unit from Context</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="Structural_Matching.html" class="tocviewlink" data-pltdoc="x">Structural Matching</a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="define-sig-form.html" class="tocviewlink" data-pltdoc="x">Extending the Syntax of Signatures</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Unit_Utilities.html" class="tocviewlink" data-pltdoc="x">Unit Utilities</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="unitcontracts.html" class="tocviewlink" data-pltdoc="x">Unit Contracts</a></td></tr><tr><td align="right">7.10&nbsp;</td><td><a href="single-unit.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Unit Modules</a></td></tr><tr><td align="right">7.11&nbsp;</td><td><a href="Single-Signature_Modules.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Signature Modules</a></td></tr><tr><td align="right">7.12&nbsp;</td><td><a href="Transformer_Helpers.html" class="tocviewlink" data-pltdoc="x">Transformer Helpers</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Surrogates.html" title="backward to &quot;6.12 Surrogates&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="creatingunits.html" title="forward to &quot;7.1 Creating Units&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;mzlib:unit&quot;">7<tt>&nbsp;</tt><a name="(part._mzlib~3aunit)"></a><a name="(mod-path._racket/unit)"></a>Units</h3><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=units.html&amp;version=8.6" class="Sq" data-pltdoc="x">Units</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces units.</p></blockquote></blockquote></blockquote><p><a name="(tech._unit)"></a><span style="font-style: italic">Units</span> organize a program into separately compilable and
+reusable components. The imports and exports of a unit are grouped
+into a <a name="(tech._signature)"></a><span style="font-style: italic">signature</span>, which can include &ldquo;static&rdquo; information
+(such as macros) in addition to placeholders for run-time values.
+Units with suitably matching signatures can be <a name="(tech._linked)"></a><span style="font-style: italic">linked</span>
+together to form a larger unit, and a unit with no imports can be
+<a name="(tech._invoked)"></a><span style="font-style: italic">invoked</span> to execute its body.</p><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="mzlib_unit.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/unit</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="mzlib_unit.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/unit</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>. The
+<a href="mzlib_unit.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/unit</span></a> module name can be used as a language name
+with <span class="stt">#lang</span>; see <a href="single-unit.html" data-pltdoc="x">Single-Unit Modules</a>.</div></p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="creatingunits.html" class="toclink" data-pltdoc="x">7.1<span class="hspace">&nbsp;</span>Creating Units</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="invokingunits.html" class="toclink" data-pltdoc="x">7.2<span class="hspace">&nbsp;</span>Invoking Units</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="compoundunits.html" class="toclink" data-pltdoc="x">7.3<span class="hspace">&nbsp;</span>Linking Units and Creating Compound Units</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="linkinference.html" class="toclink" data-pltdoc="x">7.4<span class="hspace">&nbsp;</span>Inferred Linking</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Generating_A_Unit_from_Context.html" class="toclink" data-pltdoc="x">7.5<span class="hspace">&nbsp;</span>Generating A Unit from Context</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Structural_Matching.html" class="toclink" data-pltdoc="x">7.6<span class="hspace">&nbsp;</span>Structural Matching</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define-sig-form.html" class="toclink" data-pltdoc="x">7.7<span class="hspace">&nbsp;</span>Extending the Syntax of Signatures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Unit_Utilities.html" class="toclink" data-pltdoc="x">7.8<span class="hspace">&nbsp;</span>Unit Utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="unitcontracts.html" class="toclink" data-pltdoc="x">7.9<span class="hspace">&nbsp;</span>Unit Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="single-unit.html" class="toclink" data-pltdoc="x">7.10<span class="hspace">&nbsp;</span>Single-Unit Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Single-Signature_Modules.html" class="toclink" data-pltdoc="x">7.11<span class="hspace">&nbsp;</span>Single-Signature Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Transformer_Helpers.html" class="toclink" data-pltdoc="x">7.12<span class="hspace">&nbsp;</span>Transformer Helpers</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Surrogates.html" title="backward to &quot;6.12 Surrogates&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="creatingunits.html" title="forward to &quot;7.1 Creating Units&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/networking.html b/clones/docs.racket-lang.org/reference/networking.html
new file mode 100644
index 00000000..b0cb6197
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/networking.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15.3&nbsp;Networking</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewselflink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewlink" data-pltdoc="x">Paths</a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="Filesystem.html" class="tocviewlink" data-pltdoc="x">Filesystem</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="networking.html" class="tocviewselflink" data-pltdoc="x">Networking</a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="subprocess.html" class="tocviewlink" data-pltdoc="x">Processes</a></td></tr><tr><td align="right">15.5&nbsp;</td><td><a href="logging.html" class="tocviewlink" data-pltdoc="x">Logging</a></td></tr><tr><td align="right">15.6&nbsp;</td><td><a href="time.html" class="tocviewlink" data-pltdoc="x">Time</a></td></tr><tr><td align="right">15.7&nbsp;</td><td><a href="envvars.html" class="tocviewlink" data-pltdoc="x">Environment Variables</a></td></tr><tr><td align="right">15.8&nbsp;</td><td><a href="runtime.html" class="tocviewlink" data-pltdoc="x">Environment and Runtime Information</a></td></tr><tr><td align="right">15.9&nbsp;</td><td><a href="Command-Line_Parsing.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Parsing</a></td></tr><tr><td align="right">15.10&nbsp;</td><td><a href="os-lib.html" class="tocviewlink" data-pltdoc="x">Additional Operating System Functions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>15.3&nbsp;</td><td><a href="networking.html" class="tocviewselflink" data-pltdoc="x">Networking</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.3.1&nbsp;</td><td><a href="tcp.html" class="tocviewlink" data-pltdoc="x">TCP</a></td></tr><tr><td align="right">15.3.2&nbsp;</td><td><a href="udp.html" class="tocviewlink" data-pltdoc="x">UDP</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Filesystem.html" title="backward to &quot;15.2 Filesystem&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="os.html" title="up to &quot;15 Operating System&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="tcp.html" title="forward to &quot;15.3.1 TCP&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;networking&quot;">15.3<tt>&nbsp;</tt><a name="(part._networking)"></a>Networking</h4><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="tcp.html" class="toclink" data-pltdoc="x">15.3.1<span class="hspace">&nbsp;</span>TCP</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="udp.html" class="toclink" data-pltdoc="x">15.3.2<span class="hspace">&nbsp;</span>UDP</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Filesystem.html" title="backward to &quot;15.2 Filesystem&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="os.html" title="up to &quot;15 Operating System&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="tcp.html" title="forward to &quot;15.3.1 TCP&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/notation.html b/clones/docs.racket-lang.org/reference/notation.html
new file mode 100644
index 00000000..1ff3ade5
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/notation.html
@@ -0,0 +1,113 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>2&nbsp;Notation for Documentation</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9660;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewselflink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>2&nbsp;</td><td><a href="notation.html" class="tocviewselflink" data-pltdoc="x">Notation for Documentation</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">2.1&nbsp;</td><td><a href="notation.html#%28part._.Notation_for_.Module_.Documentation%29" class="tocviewlink" data-pltdoc="x">Notation for Module Documentation</a></td></tr><tr><td align="right">2.2&nbsp;</td><td><a href="notation.html#%28part._.Notation_for_.Syntactic_.Form_.Documentation%29" class="tocviewlink" data-pltdoc="x">Notation for Syntactic Form Documentation</a></td></tr><tr><td align="right">2.3&nbsp;</td><td><a href="notation.html#%28part._.Notation_for_.Function_.Documentation%29" class="tocviewlink" data-pltdoc="x">Notation for Function Documentation</a></td></tr><tr><td align="right">2.4&nbsp;</td><td><a href="notation.html#%28part._.Notation_for_.Structure_.Type_.Documentation%29" class="tocviewlink" data-pltdoc="x">Notation for Structure Type Documentation</a></td></tr><tr><td align="right">2.5&nbsp;</td><td><a href="notation.html#%28part._.Notation_for_.Parameter_.Documentation%29" class="tocviewlink" data-pltdoc="x">Notation for Parameter Documentation</a></td></tr><tr><td align="right">2.6&nbsp;</td><td><a href="notation.html#%28part._.Notation_for_.Other_.Documentation%29" class="tocviewlink" data-pltdoc="x">Notation for Other Documentation</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">2.1<tt>&nbsp;</tt></span><a href="notation.html#%28part._.Notation_for_.Module_.Documentation%29" class="tocsubseclink" data-pltdoc="x">Notation for Module Documentation</a></td></tr><tr><td><span class="tocsublinknumber">2.2<tt>&nbsp;</tt></span><a href="notation.html#%28part._.Notation_for_.Syntactic_.Form_.Documentation%29" class="tocsubseclink" data-pltdoc="x">Notation for Syntactic Form Documentation</a></td></tr><tr><td><span class="tocsublinknumber">2.3<tt>&nbsp;</tt></span><a href="notation.html#%28part._.Notation_for_.Function_.Documentation%29" class="tocsubseclink" data-pltdoc="x">Notation for Function Documentation</a></td></tr><tr><td><span class="tocsublinknumber">2.4<tt>&nbsp;</tt></span><a href="notation.html#%28part._.Notation_for_.Structure_.Type_.Documentation%29" class="tocsubseclink" data-pltdoc="x">Notation for Structure Type Documentation</a></td></tr><tr><td><span class="tocsublinknumber">2.5<tt>&nbsp;</tt></span><a href="notation.html#%28part._.Notation_for_.Parameter_.Documentation%29" class="tocsubseclink" data-pltdoc="x">Notation for Parameter Documentation</a></td></tr><tr><td><span class="tocsublinknumber">2.6<tt>&nbsp;</tt></span><a href="notation.html#%28part._.Notation_for_.Other_.Documentation%29" class="tocsubseclink" data-pltdoc="x">Notation for Other Documentation</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="implementations.html" title="backward to &quot;1.5 Implementations&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="syntax.html" title="forward to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;notation&quot;">2<tt>&nbsp;</tt><a name="(part._notation)"></a>Notation for Documentation</h3><p>This chapter introduces essential terminology and notation that is
+used throughout Racket documentation.</p><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Notation_for_Module_Documentation&quot;">2.1<tt>&nbsp;</tt><a name="(part._.Notation_for_.Module_.Documentation)"></a>Notation for Module Documentation</h4><p>Since Racket programs are organized into <a href="eval-model.html#%28tech._module%29" class="techoutside" data-pltdoc="x"><span class="techinside">module</span></a>s, documentation
+reflects that organization with an annotation at the beginning of a
+section or subsection that describes the bindings that a particular
+module provides.</p><p>For example, the section that describes the functionality provided by
+<a href="pairs.html#%28mod-path._racket%2Flist%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/list</span></a> starts</p><blockquote><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="pairs.html#%28mod-path._racket%2Flist%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/list</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></blockquote><p>Instead of <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>, some modules are introduced with
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a>:</p><blockquote><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></blockquote><p>Using <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a> means that the module is normally used as the
+language of a whole module&#8212;<wbr></wbr>that is, by a module that starts
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a> followed by the language&#8212;<wbr></wbr>instead of imported with
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>. Unless otherwise specified, however, a module name
+documented with <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a> can also be used with <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> to
+obtain the language&rsquo;s bindings.</p><p>The module annotation also shows the
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=pkg&amp;rel=Package_Concepts.html%23%2528tech._package%2529&amp;version=8.6" class="techoutside Sq" data-pltdoc="x"><span class="techinside">package</span></a>
+that the module belongs to on the right-hand side. For more details
+about packages, see
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=pkg&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">Package Management in Racket</a>.</p><p>Sometimes, a module specification appears at the beginning of a
+document or at the start of a section that contains many subsections.
+The document&rsquo;s section or section&rsquo;s subsections are meant to
+&ldquo;inherit&rdquo; the module declaration of the enclosing document or
+section. Thus, bindings documented in <a href="index.html" data-pltdoc="x">The Racket Reference</a> are available from
+<a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> and <span class="RktSym">racket/base</span> unless otherwise
+specified in a section or subsection.</p><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Notation_for_Syntactic_Form_Documentation&quot;">2.2<tt>&nbsp;</tt><a name="(part._.Notation_for_.Syntactic_.Form_.Documentation)"></a>Notation for Syntactic Form Documentation</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=syntax-notation.html&amp;version=8.6" class="Sq" data-pltdoc="x">Notation</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces this notation for syntactic forms.</p></blockquote></blockquote></blockquote><p>Syntactic forms are specified with a grammar. Typically, the grammar
+starts with an open parenthesis followed by the syntactic form&rsquo;s name,
+as in the grammar for <span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span>:</p><blockquote><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktVar">test-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">then-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">else-expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></blockquote><p>Since every <a href="syntax-model.html#%28tech._form%29" class="techoutside" data-pltdoc="x"><span class="techinside">form</span></a> is expressed in terms of <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax
+objects</span></a>, parentheses in a grammar specification indicate a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax
+object</span></a> wrapping a list, and the leading <span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span> is an identifier
+that starts the list whose <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a> is the <span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span> binding
+of the module being documented&#8212;<wbr></wbr>in this case,
+<a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.  Square brackets in the grammar indicate
+a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax-object</span></a> list in the same way as parentheses, but in
+places square brackets are normally used by convention in a program&rsquo;s
+source.</p><p>Italic <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifiers</span></a> in the grammar are <a name="(tech._metavariable)"></a><span style="font-style: italic">metavariables</span>
+that correspond to other grammar productions. Certain metavariable
+names have implicit grammar productions:</p><ul><li><p>A metavariable that ends in <span class="RktVar">id</span> stands for an
+<a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a>.</p></li><li><p>A metavariable that ends in <span class="RktVar">keyword</span> stands
+for a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax-object</span></a> <a href="keywords.html#%28tech._keyword%29" class="techoutside" data-pltdoc="x"><span class="techinside">keyword</span></a>.</p></li><li><p>A metavariable that ends with <span class="RktVar">expr</span> stands for any
+form, and the form will be parsed as an expression.</p></li><li><p>A metavariable that ends with <span class="RktVar">body</span> stands for any
+<a href="syntax-model.html#%28tech._form%29" class="techoutside" data-pltdoc="x"><span class="techinside">form</span></a>; the form will be parsed as either a local definition or
+an expression. A <span class="RktVar">body</span> can parse as a definition only
+if it is not preceded by any expression, and the last
+<span class="RktVar">body</span> must be an expression; see also
+<a href="syntax-model.html#%28part._intdef-body%29" data-pltdoc="x">Internal Definitions</a>.</p></li><li><p>A metavariable that ends with <span class="RktVar">datum</span> stands for any
+<a href="syntax-model.html#%28tech._form%29" class="techoutside" data-pltdoc="x"><span class="techinside">form</span></a>, and the form is normally uninterpreted (e.g.,
+<span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span>d).</p></li><li><p>A metavariable that ends with <span class="RktVar">number</span> or
+<span class="RktVar">boolean</span> stands for any <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax-object</span></a> (i.e.,
+literal) <a href="numbers.html#%28tech._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">number</span></a> or <a href="booleans.html#%28tech._boolean%29" class="techoutside" data-pltdoc="x"><span class="techinside">boolean</span></a>, respectively.</p></li></ul><p>In a grammar, <span class="RktVar">form</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span> stands for any number of forms
+(possibly zero) matching <span class="RktVar">form</span>, while <span class="RktVar">form</span><span class="stt"> </span><span class="RktSym">...+</span>
+stands for one or more forms matching <span class="RktVar">form</span>.</p><p>Metavariables without an implicit grammar are defined by productions
+alongside the syntactic form&rsquo;s overall grammar. For example, in</p><blockquote><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktVar">formals</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">formals</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">rest-id</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote><p>the <span class="RktVar">formals</span> metavariable stands for either an
+<a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a>, zero or more <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifiers</span></a> in a
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax-object</span></a> list, or a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> corresponding to
+a chain of one or more pairs where the chain ends in an
+<a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> instead of an empty list.</p><p>Some syntactic forms have multiple top-level grammars, in which case
+the documentation of the syntactic forms shows multiple grammars. For
+example,</p><blockquote><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-rest%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">init-rest</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-rest%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">init-rest</a></span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>indicates that <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-rest%29%29" class="RktStxLink" data-pltdoc="x">init-rest</a></span> can either be alone in its
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax-object</span></a> list or followed by a single <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a>.</p><p>Finally, a grammar specification that includes <span class="RktVar">expr</span>
+metavariables may be augmented with run-time <a href="contracts.html#%28tech._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">contract</span></a>s on some
+of the metavariables, which indicate a predicate that the result of
+the expression must satisfy at run time. For example,</p><blockquote><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">parameter-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">value-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">parameter-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._parameter~3f%29%29" class="RktValLink" data-pltdoc="x">parameter?</a></span></td></tr></table></td></tr></table></blockquote></blockquote><p>indicates that the result of each <span class="RktVar">parameter-expr</span> must be a
+value <span class="RktVar">v</span> for which <span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._parameter~3f%29%29" class="RktValLink" data-pltdoc="x">parameter?</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span> returns true.</p><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Notation_for_Function_Documentation&quot;">2.3<tt>&nbsp;</tt><a name="(part._.Notation_for_.Function_.Documentation)"></a>Notation for Function Documentation</h4><p>Procedures and other values are described using a notation based on
+<a href="contracts.html#%28tech._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">contract</span></a>s. In essence, these contracts describe the interfaces of
+the documented library using Racket predicates and expressions.</p><p>For example, the following is the header of the definition of a
+typical procedure:</p><blockquote><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-~3einteger%29%29" class="RktValDef RktValLink" data-pltdoc="x">char-&gt;integer</a></span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></blockquote><p>The function being defined, <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-~3einteger%29%29" class="RktValLink" data-pltdoc="x">char-&gt;integer</a></span>, is typeset as if it
+were being applied. The metavariables that come after the function name
+stand in for arguments. The white text in the corner identifies the
+kind of value that is being documented.</p><p>Each metavariable is described with a contract. In the preceding
+example, the metavariable <span class="RktVar">char</span> has the contract
+<span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span>. This contract specifies that any argument
+<span class="RktVar">char</span> that answers true to the <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span> predicate is
+valid. The documented function may or may not actually check this
+property, but the contract signals the intent of the implementer.</p><p>The contract on the right of the arrow, <span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span> in this case,
+specifies the expected result that is produced by the function.</p><p>Contract specifications can be more expressive than just names of
+predicates. Consider the following header for <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._argmax%29%29" class="RktValLink" data-pltdoc="x">argmax</a></span>:</p><blockquote><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._argmax%29%29" class="RktValDef RktValLink" data-pltdoc="x">argmax</a></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>The contract <span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="RktPn">)</span> denotes a function contract specifying
+that <span class="RktSym">proc</span>&rsquo;s argument can be any single value and the result should be
+a real number. The contract <span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="stt"> </span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="stt"> </span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span> for <span class="RktVar">lst</span>
+specifies that <span class="RktVar">lst</span> should pass both <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span> and <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span>
+(i.e., that it is a non-empty list).</p><p>Both <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span> and <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span> are examples of <a href="contracts.html#%28tech._contract._combinator%29" class="techoutside" data-pltdoc="x"><span class="techinside">contract combinator</span></a>s.
+Contract combinators such as <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span>, <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span>, <span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span>,
+and others are used throughout the documentation. Clicking on the hyperlinked
+combinator name will provide more information on its meaning.</p><p>A Racket function may be documented as having one or more optional arguments.
+The <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> function is an example of such a function:</p><blockquote><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValDef RktValLink" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>The brackets surrounding the <span class="RktVar">in</span> argument in the application
+syntax indicates that it is an optional argument.</p><p>The header for <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> specifies a contract for the parameter
+<span class="RktVar">in</span> as usual. To the right of the contract, it also specifies
+a default value <span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span> that is used if
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> is called with no arguments.</p><p>Functions may also be documented as accepting mandatory or optional
+keyword-based arguments.  For example, the <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._sort%29%29" class="RktValLink" data-pltdoc="x">sort</a></span> function has
+two optional, keyword-based arguments:</p><blockquote><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._sort%29%29" class="RktValDef RktValLink" data-pltdoc="x">sort</a></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">lst</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">less-than?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:key</span><span class="hspace">&nbsp;</span><span class="RktVar">extract-key</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:cache-keys?</span><span class="hspace">&nbsp;</span><span class="RktVar">cache-keys?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">less-than?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">extract-key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cache-keys?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></blockquote><p>The brackets around the <span class="RktVar">extract-key</span> and
+<span class="RktVar">cache-keys?</span>  arguments indicate that they are optional as
+before. The contract section of the header shows the default values
+that are provided for these keyword arguments.</p><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Notation_for_Structure_Type_Documentation&quot;">2.4<tt>&nbsp;</tt><a name="(part._.Notation_for_.Structure_.Type_.Documentation)"></a>Notation for Structure Type Documentation</h4><p>A <a href="structures.html#%28tech._structure._type%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type</span></a> is also documented using contract notation:</p><blockquote><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="stt"> </span><span class="RktSym"><span class="RktSymDef RktSym">color</span></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">red</span><span class="stt"> </span><span class="RktSym">green</span><span class="stt"> </span><span class="RktSym">blue</span><span class="stt"> </span><span class="RktSym">alpha</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">red</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._natural-number%2Fc%29%29" class="RktValLink" data-pltdoc="x">natural-number/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3c~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&lt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">255</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">green</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._natural-number%2Fc%29%29" class="RktValLink" data-pltdoc="x">natural-number/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3c~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&lt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">255</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">blue</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._natural-number%2Fc%29%29" class="RktValLink" data-pltdoc="x">natural-number/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3c~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&lt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">255</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">alpha</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._natural-number%2Fc%29%29" class="RktValLink" data-pltdoc="x">natural-number/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3c~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&lt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">255</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>The structure type is typeset as it were declared in
+the source code of a program using the <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> form.
+Each field of the structure is documented with a corresponding
+contract that specifies the values that are accepted for that field.</p><p>In the example above, the structure type <span class="RktVar">color</span> has
+four fields: <span class="RktVar">red</span>, <span class="RktVar">green</span>, <span class="RktVar">blue</span>,
+and <span class="RktVar">alpha</span>. The constructor for the structure type
+accepts field values that satisfy
+<span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="stt"> </span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._natural-number%2Fc%29%29" class="RktValLink" data-pltdoc="x">natural-number/c</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3c~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&lt;=/c</a></span><span class="stt"> </span><span class="RktVal">255</span><span class="RktPn">)</span><span class="RktPn">)</span>, i.e., non-negative
+exact integers up to 255.</p><p>Additional keywords may appear after the field names in the
+documentation for a structure type:</p><blockquote><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><span class="RktSymDef RktSym">data-source</span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">connector</span><span class="stt"> </span><span class="RktSym">args</span><span class="stt"> </span><span class="RktSym">extensions</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:mutable</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">connector</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">postgresql</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">mysql</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">sqlite3</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">odbc</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">args</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">extensions</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>Here, the <span class="RktPn">#:mutable</span> keyword indicates that the fields of
+instances of the <span class="RktVar">data-source</span> structure type can be
+mutated with their respective setter functions.</p><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Notation_for_Parameter_Documentation&quot;">2.5<tt>&nbsp;</tt><a name="(part._.Notation_for_.Parameter_.Documentation)"></a>Notation for Parameter Documentation</h4><p>A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> is documented the same way as a function:</p><blockquote><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._current-command-line-arguments%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-command-line-arguments</a></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vectorof%29%29" class="RktValLink" data-pltdoc="x">vectorof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._current-command-line-arguments%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-command-line-arguments</a></span><span class="hspace">&nbsp;</span><span class="RktVar">argv</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">argv</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vectorof%29%29" class="RktValLink" data-pltdoc="x">vectorof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>Since <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameters</span></a> can be referenced or set, there are two entries in the
+header above. Calling <span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._current-command-line-arguments%29%29" class="RktValLink" data-pltdoc="x">current-command-line-arguments</a></span> with no
+arguments accesses the parameter&rsquo;s value, which must be a vector whose elements
+pass both <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span> and <span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span>. Calling
+<span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._current-command-line-arguments%29%29" class="RktValLink" data-pltdoc="x">current-command-line-arguments</a></span> with a single argument
+sets the parameter&rsquo;s value, where the value must be a vector whose
+elements pass <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span> (and a guard on the <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a>
+coerces the strings to immutable form, if necessary).</p><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Notation_for_Other_Documentation&quot;">2.6<tt>&nbsp;</tt><a name="(part._.Notation_for_.Other_.Documentation)"></a>Notation for Other Documentation</h4><p>Some libraries provide bindings to constant values. These values are
+documented with a separate header:</p><blockquote><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValDef RktValLink" data-pltdoc="x">object%</a></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span></p></blockquote></td></tr></table></blockquote></blockquote><p>The <a href="mzlib_class.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/class</span></a> library provides the <span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span>
+value, which is the root of the class hierarchy in Racket. Its
+documentation header just indicates that it is a value that satisfies
+the predicate <span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="implementations.html" title="backward to &quot;1.5 Implementations&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="syntax.html" title="forward to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/number-types.html b/clones/docs.racket-lang.org/reference/number-types.html
new file mode 100644
index 00000000..b60023ca
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/number-types.html
@@ -0,0 +1,28 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.3.1&nbsp;Number Types</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewselflink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.3.1&nbsp;</td><td><a href="number-types.html" class="tocviewselflink" data-pltdoc="x">Number Types</a></td></tr><tr><td align="right">4.3.2&nbsp;</td><td><a href="generic-numbers.html" class="tocviewlink" data-pltdoc="x">Generic Numerics</a></td></tr><tr><td align="right">4.3.3&nbsp;</td><td><a href="flonums.html" class="tocviewlink" data-pltdoc="x">Flonums</a></td></tr><tr><td align="right">4.3.4&nbsp;</td><td><a href="fixnums.html" class="tocviewlink" data-pltdoc="x">Fixnums</a></td></tr><tr><td align="right">4.3.5&nbsp;</td><td><a href="extflonums.html" class="tocviewlink" data-pltdoc="x">Extflonums</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">number?</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._complex~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">complex?</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">real?</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._rational~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">rational?</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">integer?</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exact-<wbr></wbr>integer?</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exact-<wbr></wbr>nonnegative-<wbr></wbr>integer?</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exact-<wbr></wbr>positive-<wbr></wbr>integer?</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact-real~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">inexact-<wbr></wbr>real?</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fixnum?</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flonum?</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._double-flonum~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">double-<wbr></wbr>flonum?</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._single-flonum~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">single-<wbr></wbr>flonum?</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._single-flonum-available~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">single-<wbr></wbr>flonum-<wbr></wbr>available?</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">zero?</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">positive?</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._negative~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">negative?</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">even?</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._odd~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">odd?</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exact?</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">inexact?</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact-~3eexact%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">inexact-<wbr></wbr>&gt;exact</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-~3einexact%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exact-<wbr></wbr>&gt;inexact</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real-~3esingle-flonum%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">real-<wbr></wbr>&gt;single-<wbr></wbr>flonum</span></span></a></td></tr><tr><td><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real-~3edouble-flonum%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">real-<wbr></wbr>&gt;double-<wbr></wbr>flonum</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="numbers.html" title="backward to &quot;4.3 Numbers&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="numbers.html" title="up to &quot;4.3 Numbers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="generic-numbers.html" title="forward to &quot;4.3.2 Generic Numerics&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;number-types&quot;">4.3.1<tt>&nbsp;</tt><a name="(part._number-types)"></a>Number Types</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._number~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">number?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span>
+ is a number, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2+3i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+nan.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._complex~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._complex~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">complex?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span>,
+because all numbers are <a href="numbers.html#%28tech._complex._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">complex numbers</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._real~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">real?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is
+ a <a href="numbers.html#%28tech._real._number%29" data-pltdoc="x">real number</a>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2+3i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2.0+0.0i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._rational~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._rational~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">rational?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktVal">#t</span> if
+ <span class="RktVar">v</span> is a <a href="numbers.html#%28tech._rational._number%29" data-pltdoc="x">rational number</a>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._rational~3f%29%29" class="RktValLink" data-pltdoc="x">rational?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._rational~3f%29%29" class="RktValLink" data-pltdoc="x">rational?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._rational~3f%29%29" class="RktValLink" data-pltdoc="x">rational?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._integer~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">integer?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span>
+ is a number that is an <a href="numbers.html#%28tech._integer%29" data-pltdoc="x">integer</a>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2.3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2+3i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._exact-integer~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">exact-integer?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact~3f%29%29" class="RktValLink" data-pltdoc="x">exact?</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._exact-nonnegative-integer~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._negative~3f%29%29" class="RktValLink" data-pltdoc="x">negative?</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._exact-positive-integer~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">exact-positive-integer?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._inexact-real~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact-real~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">inexact-real?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact~3f%29%29" class="RktValLink" data-pltdoc="x">inexact?</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._fixnum~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">fixnum?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Return <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="numbers.html#%28tech._fixnum%29" data-pltdoc="x">fixnum</a>, <span class="RktVal">#f</span>
+otherwise.</div></p><p>Note: the result of this function is platform-dependent, so using it in
+syntax transformers can lead to platform-dependent bytecode files.
+See also <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fixnum-for-every-system~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum-for-every-system?</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._flonum~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">flonum?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Return <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="numbers.html#%28tech._flonum%29" data-pltdoc="x">flonum</a>, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._double-flonum~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._double-flonum~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">double-flonum?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Identical to <span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._single-flonum~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._single-flonum~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">single-flonum?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Return <span class="RktVal">#t</span> if
+<span class="RktVar">v</span> is a <a href="numbers.html#%28tech._single._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">single-flonum</span></a> (i.e., a single-precision
+floating-point number), <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._single-flonum-available~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._single-flonum-available~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">single-flonum-available?</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <a href="numbers.html#%28tech._single._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">single-flonums</span></a> are supported on
+the current platform, <span class="RktVal">#f</span> otherwise.</div></p><p>Currently, <span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._single-flonum-available~3f%29%29" class="RktValLink" data-pltdoc="x">single-flonum-available?</a></span> produces <span class="RktVal">#t</span> when
+<span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">vm</span><span class="RktPn">)</span> produces <span class="RktVal">'</span><span class="RktVal">racket</span>, and
+<span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._single-flonum-available~3f%29%29" class="RktValLink" data-pltdoc="x">single-flonum-available?</a></span> produces <span class="RktVal">#f</span> otherwise.</p><p>If the result is <span class="RktVal">#f</span>, then <span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._single-flonum~3f%29%29" class="RktValLink" data-pltdoc="x">single-flonum?</a></span> also
+produces <span class="RktVal">#f</span> for all arguments.</p><p class="SHistory">Added in version 7.3.0.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._zero~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">zero?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="stt"> </span><span class="RktVal">0</span><span class="stt"> </span><span class="RktVar">z</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-0</span>.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._positive~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">positive?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e%29%29" class="RktValLink" data-pltdoc="x">&gt;</a></span><span class="stt"> </span><span class="RktVar">x</span><span class="stt"> </span><span class="RktVal">0</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span>0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._negative~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._negative~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">negative?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span><span class="stt"> </span><span class="RktVar">x</span><span class="stt"> </span><span class="RktVal">0</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._negative~3f%29%29" class="RktValLink" data-pltdoc="x">negative?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._negative~3f%29%29" class="RktValLink" data-pltdoc="x">negative?</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span>0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._negative~3f%29%29" class="RktValLink" data-pltdoc="x">negative?</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-0</span>.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._even~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">even?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._modulo%29%29" class="RktValLink" data-pltdoc="x">modulo</a></span><span class="stt"> </span><span class="RktVar">n</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">even?: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: +inf.0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._odd~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._odd~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">odd?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="stt"> </span><span class="RktVar">n</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._odd~3f%29%29" class="RktValLink" data-pltdoc="x">odd?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._odd~3f%29%29" class="RktValLink" data-pltdoc="x">odd?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._odd~3f%29%29" class="RktValLink" data-pltdoc="x">odd?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">odd?: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: +inf.0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._exact~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">exact?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktVal">#t</span> if <span class="RktVar">z</span>
+ is an exact number, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact~3f%29%29" class="RktValLink" data-pltdoc="x">exact?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact~3f%29%29" class="RktValLink" data-pltdoc="x">exact?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._inexact~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">inexact?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktVal">#t</span> if <span class="RktVar">z</span>
+ is an inexact number, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact~3f%29%29" class="RktValLink" data-pltdoc="x">inexact?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact~3f%29%29" class="RktValLink" data-pltdoc="x">inexact?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._inexact-~3eexact))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact-~3eexact%29%29" class="RktValDef RktValLink" data-pltdoc="x">inexact-&gt;exact</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact~3f%29%29" class="RktValLink" data-pltdoc="x">exact?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Coerces <span class="RktVar">z</span> to an
+ exact number. If <span class="RktVar">z</span> is already exact, it is returned. If <span class="RktVar">z</span>
+ is <span class="RktVal">+inf.0</span>, <span class="RktVal"><span class="nobreak">-i</span>nf.0</span>, <span class="RktVal">+nan.0</span>,
+ <span class="RktVal">+inf.f</span>, <span class="RktVal">-inf.f</span>, or <span class="RktVal">+nan.f</span>, then the
+ <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact-~3eexact%29%29" class="RktValLink" data-pltdoc="x">inexact-&gt;exact</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact-~3eexact%29%29" class="RktValLink" data-pltdoc="x">inexact-&gt;exact</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._exact-~3einexact))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-~3einexact%29%29" class="RktValDef RktValLink" data-pltdoc="x">exact-&gt;inexact</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._inexact~3f%29%29" class="RktValLink" data-pltdoc="x">inexact?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">z</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Coerces <span class="RktVar">z</span> to an
+ inexact number. If <span class="RktVar">z</span> is already inexact, it is returned.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-~3einexact%29%29" class="RktValLink" data-pltdoc="x">exact-&gt;inexact</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-~3einexact%29%29" class="RktValLink" data-pltdoc="x">exact-&gt;inexact</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1.0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._real-~3esingle-flonum))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real-~3esingle-flonum%29%29" class="RktValDef RktValLink" data-pltdoc="x">real-&gt;single-flonum</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._single-flonum~3f%29%29" class="RktValLink" data-pltdoc="x">single-flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Coerces <span class="RktVar">x</span>
+to a single-precision floating-point number. If <span class="RktVar">x</span> is already
+a single-precision floating-point number, it is returned.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._real-~3edouble-flonum))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real-~3edouble-flonum%29%29" class="RktValDef RktValLink" data-pltdoc="x">real-&gt;double-flonum</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Coerces <span class="RktVar">x</span>
+to a double-precision floating-point number. If <span class="RktVar">x</span> is already
+a double-precision floating-point number, it is returned.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="numbers.html" title="backward to &quot;4.3 Numbers&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="numbers.html" title="up to &quot;4.3 Numbers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="generic-numbers.html" title="forward to &quot;4.3.2 Generic Numerics&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/numbers.html b/clones/docs.racket-lang.org/reference/numbers.html
new file mode 100644
index 00000000..9e6d638f
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/numbers.html
@@ -0,0 +1,71 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.3&nbsp;Numbers</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewselflink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>4.3&nbsp;</td><td><a href="numbers.html" class="tocviewselflink" data-pltdoc="x">Numbers</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.3.1&nbsp;</td><td><a href="number-types.html" class="tocviewlink" data-pltdoc="x">Number Types</a></td></tr><tr><td align="right">4.3.2&nbsp;</td><td><a href="generic-numbers.html" class="tocviewlink" data-pltdoc="x">Generic Numerics</a></td></tr><tr><td align="right">4.3.3&nbsp;</td><td><a href="flonums.html" class="tocviewlink" data-pltdoc="x">Flonums</a></td></tr><tr><td align="right">4.3.4&nbsp;</td><td><a href="fixnums.html" class="tocviewlink" data-pltdoc="x">Fixnums</a></td></tr><tr><td align="right">4.3.5&nbsp;</td><td><a href="extflonums.html" class="tocviewlink" data-pltdoc="x">Extflonums</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="booleans.html" title="backward to &quot;4.2 Booleans&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="number-types.html" title="forward to &quot;4.3.1 Number Types&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;numbers&quot;">4.3<tt>&nbsp;</tt><a name="(part._numbers)"></a>Numbers</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=numbers.html&amp;version=8.6" class="Sq" data-pltdoc="x">Numbers</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces numbers.</p></blockquote></blockquote></blockquote><p>All <a name="(tech._number)"></a><span style="font-style: italic">numbers</span> are <a name="(tech._complex._number)"></a><span style="font-style: italic">complex numbers</span>. Some of them are
+<a name="(tech._real._number)"></a><span style="font-style: italic">real numbers</span>, and all of the real numbers that can be
+represented are also <a name="(tech._rational._number)"></a><span style="font-style: italic">rational numbers</span>, except for
+<a name="(idx._(gentag._111._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">+inf.0</span> (positive <a name="(idx._(gentag._112._(lib._scribblings/reference/reference..scrbl)))"></a>infinity),
+<a name="(idx._(gentag._113._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">+inf.f</span> (single-precision variant, when
+enabled via <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-single-flonum%29%29" class="RktValLink" data-pltdoc="x">read-single-flonum</a></span>),
+<a name="(idx._(gentag._114._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal"><span class="nobreak">-i</span>nf.0</span> (negative infinity),
+<a name="(idx._(gentag._115._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">-inf.f</span> (single-precision variant, when
+enabled), <a name="(idx._(gentag._116._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">+nan.0</span> (<a name="(idx._(gentag._117._(lib._scribblings/reference/reference..scrbl)))"></a>not-a-number), and
+<a name="(idx._(gentag._118._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">+nan.f</span> (single-precision variant, when
+enabled). Among the rational numbers, some are <a name="(tech._integer)"></a><span style="font-style: italic">integers</span>,
+because <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._round%29%29" class="RktValLink" data-pltdoc="x">round</a></span> applied to the number produces the same number.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span>See <a href="reader.html#%28part._parse-number%29" data-pltdoc="x">Reading Numbers</a> for information on the
+syntax of number literals.</p></blockquote></blockquote></blockquote><p>Orthogonal to those categories, each number is also either an
+<a name="(tech._exact._number)"></a><span style="font-style: italic">exact number</span> or an <a name="(tech._inexact._number)"></a><span style="font-style: italic">inexact number</span>. Unless
+otherwise specified, computations that involve an inexact number
+produce inexact results. Certain operations on inexact numbers,
+however, produce an exact number, such as multiplying an inexact
+number with an exact <span class="RktVal">0</span>. Operations that mathematically produce
+irrational numbers for some rational arguments (e.g., <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sqrt%29%29" class="RktValLink" data-pltdoc="x">sqrt</a></span>) may
+produce inexact results even for exact arguments.</p><p>In the case of complex numbers, either the real and imaginary parts
+are both exact or inexact with the same precision, or the number has
+an exact zero real part and an inexact imaginary part; a complex
+number with an exact zero imaginary part is a real number.</p><p>Inexact real numbers are implemented as double-precision
+<a name="(idx._(gentag._119._(lib._scribblings/reference/reference..scrbl)))"></a>IEEE floating-point numbers, also known as
+<a name="(tech._flonum)"></a><span style="font-style: italic">flonums</span>, or as single-precision IEEE floating-point numbers,
+also known as <a name="(tech._single._flonum)"></a><span style="font-style: italic">single-flonums</span>. Single-flonums are
+supported only when <span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._single-flonum-available~3f%29%29" class="RktValLink" data-pltdoc="x">single-flonum-available?</a></span><span class="RktPn">)</span> reports
+<span class="RktVal">#t</span>. Although we write <span class="RktVal">+inf.f</span>,
+<span class="RktVal">-inf.f</span>, and <span class="RktVal">+nan.f</span> to mean
+single-flonums, those forms read as double-precision flonums by
+default, since <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-single-flonum%29%29" class="RktValLink" data-pltdoc="x">read-single-flonum</a></span> is <span class="RktVal">#f</span> by default.
+When single-flonums are supported, inexact numbers are still
+represented as flonums by default, and single precision is used only
+when a computation starts with single-flonums.</p><p>Inexact numbers can be coerced to exact form, except for the inexact
+numbers <span class="RktVal">+inf.0</span>, <span class="RktVal">+inf.f</span>,
+<span class="RktVal"><span class="nobreak">-i</span>nf.0</span>, <span class="RktVal">-inf.f</span>, <span class="RktVal">+nan.0</span>, and <span class="RktVal">+nan.f</span>, which
+have no exact form. <a name="(idx._(gentag._120._(lib._scribblings/reference/reference..scrbl)))"></a>Dividing a
+number by exact zero raises an exception; dividing a non-zero number
+other than <span class="RktVal">+nan.0</span> or <span class="RktVal">+nan.f</span> by an inexact zero returns <span class="RktVal">+inf.0</span>,
+<span class="RktVal">+inf.f</span>, <span class="RktVal"><span class="nobreak">-i</span>nf.0</span>
+or <span class="RktVal">-inf.f</span>, depending on the sign and precision of the dividend. The
+<span class="RktVal">+nan.0</span> value is not <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span> to itself, but <span class="RktVal">+nan.0</span>
+is <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span> to itself, and <span class="RktVal">+nan.f</span> is similarly <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span> but
+not <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span> to itself. Conversely, <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="stt"> </span><span class="RktVal">0.0</span><span class="stt"> </span><span class="RktVal"><span class="nobreak">-0</span>.0</span><span class="RktPn">)</span> is
+<span class="RktVal">#t</span>, but <span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span><span class="stt"> </span><span class="RktVal">0.0</span><span class="stt"> </span><span class="RktVal"><span class="nobreak">-0</span>.0</span><span class="RktPn">)</span> is <span class="RktVal">#f</span>, and the
+same for <span class="RktVal">0.0f0</span> and <span class="RktVal">-0.0f0</span> (which are single-precision variants). The datum
+<a name="(idx._(gentag._121._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">-nan.0</span> refers to the same constant as <span class="RktVal">+nan.0</span>,
+and <a name="(idx._(gentag._122._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">-nan.f</span> is the same as <span class="RktVal">+nan.f</span>.</p><p>Calculations with infinities produce results consistent with IEEE
+double- or single-precision floating point where IEEE specifies the result; in
+cases where IEEE provides no specification,
+the result corresponds to the limit approaching
+infinity, or <span class="RktVal">+nan.0</span> or <span class="RktVal">+nan.f</span> if no such limit exists.</p><p>The precision and size of exact numbers is limited only by available
+memory (and the precision of operations that can produce irrational
+numbers). In particular, adding, multiplying, subtracting, and
+dividing exact numbers always produces an exact result.</p><p>A <a name="(tech._fixnum)"></a><span style="font-style: italic">fixnum</span> is an exact integer whose two&rsquo;s complement
+representation fits into 30 or 31 bits (depending on the Racket variant)
+on a 32-bit platform or 61 or 63 bits (depending on the Racket variant) on a
+64-bit platform. No allocation is required when computing
+with fixnums. See also the <a href="fixnums.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/fixnum</span></a> module, below.</p><p>Two fixnums that are <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span> are also the same
+according to <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>. Otherwise, the result of <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>
+applied to two numbers is undefined, except that numbers produced
+by the default reader in <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode are <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> and therefore <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>
+when they are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>.</p><p>Two real numbers are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span> when they are both inexact with the same precision or both
+exact, and when they are <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span> (except for <span class="RktVal">+nan.0</span>, <span class="RktVal">+nan.f</span>,
+<span class="RktVal">0.0</span>, <span class="RktVal">+0.0f0</span>, <span class="RktVal"><span class="nobreak">-0</span>.0</span>, and <span class="RktVal">-0.0f0</span>, as noted above).
+Two complex numbers are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span> when their real and imaginary parts are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>.
+Two numbers are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> when they are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>.</p><p>See <a href="reader.html#%28part._parse-number%29" data-pltdoc="x">Reading Numbers</a>
+    for information on <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>ing
+    numbers and <a href="printing.html#%28part._print-number%29" data-pltdoc="x">Printing Numbers</a>
+    for information on <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>ing numbers.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="number-types.html" class="toclink" data-pltdoc="x">4.3.1<span class="hspace">&nbsp;</span>Number Types</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html" class="toclink" data-pltdoc="x">4.3.2<span class="hspace">&nbsp;</span>Generic Numerics</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html#%28part._.Arithmetic%29" class="toclink" data-pltdoc="x">4.3.2.1<span class="hspace">&nbsp;</span>Arithmetic</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html#%28part._.Number_.Comparison%29" class="toclink" data-pltdoc="x">4.3.2.2<span class="hspace">&nbsp;</span>Number Comparison</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html#%28part._.Powers_and_.Roots%29" class="toclink" data-pltdoc="x">4.3.2.3<span class="hspace">&nbsp;</span>Powers and Roots</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html#%28part._.Trigonometric_.Functions%29" class="toclink" data-pltdoc="x">4.3.2.4<span class="hspace">&nbsp;</span>Trigonometric Functions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html#%28part._.Complex_.Numbers%29" class="toclink" data-pltdoc="x">4.3.2.5<span class="hspace">&nbsp;</span>Complex Numbers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html#%28part._.Bitwise_.Operations%29" class="toclink" data-pltdoc="x">4.3.2.6<span class="hspace">&nbsp;</span>Bitwise Operations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html#%28part._.Random_.Numbers%29" class="toclink" data-pltdoc="x">4.3.2.7<span class="hspace">&nbsp;</span>Random Numbers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html#%28part._.Other_.Randomness_.Utilities%29" class="toclink" data-pltdoc="x">4.3.2.8<span class="hspace">&nbsp;</span>Other Randomness Utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html#%28part._.Number--.String_.Conversions%29" class="toclink" data-pltdoc="x">4.3.2.9<span class="hspace">&nbsp;</span>Number&ndash;String Conversions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="generic-numbers.html#%28part._.Extra_.Constants_and_.Functions%29" class="toclink" data-pltdoc="x">4.3.2.10<span class="hspace">&nbsp;</span>Extra Constants and Functions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="flonums.html" class="toclink" data-pltdoc="x">4.3.3<span class="hspace">&nbsp;</span>Flonums</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="flonums.html#%28part._.Flonum_.Arithmetic%29" class="toclink" data-pltdoc="x">4.3.3.1<span class="hspace">&nbsp;</span>Flonum Arithmetic</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="flonums.html#%28part._flvectors%29" class="toclink" data-pltdoc="x">4.3.3.2<span class="hspace">&nbsp;</span>Flonum Vectors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="fixnums.html" class="toclink" data-pltdoc="x">4.3.4<span class="hspace">&nbsp;</span>Fixnums</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="fixnums.html#%28part._.Fixnum_.Arithmetic%29" class="toclink" data-pltdoc="x">4.3.4.1<span class="hspace">&nbsp;</span>Fixnum Arithmetic</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="fixnums.html#%28part._fxvectors%29" class="toclink" data-pltdoc="x">4.3.4.2<span class="hspace">&nbsp;</span>Fixnum Vectors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="fixnums.html#%28part._fxrange%29" class="toclink" data-pltdoc="x">4.3.4.3<span class="hspace">&nbsp;</span>Fixnum Range</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="extflonums.html" class="toclink" data-pltdoc="x">4.3.5<span class="hspace">&nbsp;</span>Extflonums</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="extflonums.html#%28part._.Extflonum_.Arithmetic%29" class="toclink" data-pltdoc="x">4.3.5.1<span class="hspace">&nbsp;</span>Extflonum Arithmetic</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="extflonums.html#%28part._.Extflonum_.Constants%29" class="toclink" data-pltdoc="x">4.3.5.2<span class="hspace">&nbsp;</span>Extflonum Constants</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="extflonums.html#%28part._extflvectors%29" class="toclink" data-pltdoc="x">4.3.5.3<span class="hspace">&nbsp;</span>Extflonum Vectors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="extflonums.html#%28part._extflutils%29" class="toclink" data-pltdoc="x">4.3.5.4<span class="hspace">&nbsp;</span>Extflonum Byte Strings</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="booleans.html" title="backward to &quot;4.2 Booleans&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="number-types.html" title="forward to &quot;4.3.1 Number Types&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/objcreation.html b/clones/docs.racket-lang.org/reference/objcreation.html
new file mode 100644
index 00000000..fdcf7485
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/objcreation.html
@@ -0,0 +1,53 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6.3&nbsp;Creating Objects</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewselflink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="createinterface.html" class="tocviewlink" data-pltdoc="x">Creating Interfaces</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="createclass.html" class="tocviewlink" data-pltdoc="x">Creating Classes</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="objcreation.html" class="tocviewselflink" data-pltdoc="x">Creating Objects</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="ivaraccess.html" class="tocviewlink" data-pltdoc="x">Field and Method Access</a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="mixins.html" class="tocviewlink" data-pltdoc="x">Mixins</a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="trait.html" class="tocviewlink" data-pltdoc="x">Traits</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="Object_and_Class_Contracts.html" class="tocviewlink" data-pltdoc="x">Object and Class Contracts</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="objectequality.html" class="tocviewlink" data-pltdoc="x">Object Equality and Hashing</a></td></tr><tr><td align="right">6.9&nbsp;</td><td><a href="objectserialize.html" class="tocviewlink" data-pltdoc="x">Object Serialization</a></td></tr><tr><td align="right">6.10&nbsp;</td><td><a href="objectprinting.html" class="tocviewlink" data-pltdoc="x">Object Printing</a></td></tr><tr><td align="right">6.11&nbsp;</td><td><a href="objectutils.html" class="tocviewlink" data-pltdoc="x">Object, Class, and Interface Utilities</a></td></tr><tr><td align="right">6.12&nbsp;</td><td><a href="Surrogates.html" class="tocviewlink" data-pltdoc="x">Surrogates</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="objcreation.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._make-object%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>object</span></span></a></td></tr><tr><td><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">new</span></span></a></td></tr><tr><td><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._instantiate%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">instantiate</span></span></a></td></tr><tr><td><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-make-object%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">super-<wbr></wbr>make-<wbr></wbr>object</span></span></a></td></tr><tr><td><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-instantiate%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">super-<wbr></wbr>instantiate</span></span></a></td></tr><tr><td><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">super-<wbr></wbr>new</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="createclass.html" title="backward to &quot;6.2 Creating Classes&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="ivaraccess.html" title="forward to &quot;6.4 Field and Method Access&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;objcreation&quot;">6.3<tt>&nbsp;</tt><a name="(part._objcreation)"></a>Creating Objects</h4><p>The <span class="RktSym"><a href="objcreation.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._make-object%29%29" class="RktValLink" data-pltdoc="x">make-object</a></span> procedure creates a new object with
+by-position initialization arguments, the <span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span> form
+creates a new object with by-name initialization arguments, and
+the <span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._instantiate%29%29" class="RktStxLink" data-pltdoc="x">instantiate</a></span> form creates a new object with both
+by-position and by-name initialization arguments.</p><p>All fields in the newly created object are initially bound to the
+special <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;undefined&gt;</span></span></a> value (see
+<a href="void.html" data-pltdoc="x">Void</a>). Initialization variables with default value
+expressions (and no provided value) are also initialized to
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;undefined&gt;</span></span></a>. After argument values are assigned to
+initialization variables, expressions in <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span> clauses,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-field%29%29" class="RktStxLink" data-pltdoc="x">init-field</a></span> clauses with no provided argument,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init%29%29" class="RktStxLink" data-pltdoc="x">init</a></span> clauses with no provided argument, private field
+definitions, and other expressions are evaluated. Those
+expressions are evaluated as they appear in the class expression,
+from left to right.</p><p>Sometime during the evaluation of the expressions,
+superclass-declared initializations must be evaluated once by
+using the <span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-make-object%29%29" class="RktStxLink" data-pltdoc="x">super-make-object</a></span> procedure,
+<span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span> form, or <span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-instantiate%29%29" class="RktStxLink" data-pltdoc="x">super-instantiate</a></span> form.</p><p>By-name initialization arguments to a class that have no matching
+initialization variable are implicitly added as by-name arguments
+to a <span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-make-object%29%29" class="RktStxLink" data-pltdoc="x">super-make-object</a></span>, <span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span>, or
+<span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-instantiate%29%29" class="RktStxLink" data-pltdoc="x">super-instantiate</a></span> invocation, after the explicit
+arguments.  If multiple initialization arguments are provided for
+the same name, the first (if any) is used, and the unused
+arguments are propagated to the superclass. (Note that converted
+by-position arguments are always placed before explicit by-name
+arguments.)  The initialization procedure for the
+<span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span> class accepts zero initialization arguments; if
+it receives any by-name initialization arguments, then
+<span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised.</p><p>If the end of initialization is reached for any class in the
+hierarchy without invoking the superclass&rsquo;s initialization, the
+<span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised. Also, if superclass initialization is
+invoked more than once, the <span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">exn:fail:object</a></span> exception is raised.</p><p>Fields inherited from a superclass are not initialized until the
+superclass&rsquo;s initialization procedure is invoked. In contrast,
+all methods are available for an object as soon as the object is
+created; the overriding of methods is not affected by
+initialization (unlike objects in C++).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._make-object))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objcreation.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._make-object%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-object</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">class</span><span class="hspace">&nbsp;</span><span class="RktVar">init-v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3f%29%29" class="RktValLink" data-pltdoc="x">object?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">class</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">init-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates an instance of <span class="RktVar">class</span>. The <span class="RktVar">init-v</span>s are
+passed as initialization arguments, bound to the initialization
+variables of <span class="RktVar">class</span> for the newly created object as
+described in <a href="createclass.html#%28part._clinitvars%29" data-pltdoc="x">Initialization Variables</a>. If <span class="RktVar">class</span> is not a
+class, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._new))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">new</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">class-expr</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">by-name-expr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Creates an instance of the value of <span class="RktVar">class-expr</span> (which
+must be a class), and the value of each <span class="RktVar">by-name-expr</span> is
+provided as a by-name argument for the corresponding
+<span class="RktVar">id</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._instantiate))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._instantiate%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">instantiate</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">class-expr</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">by-pos-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">by-name-expr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Creates an instance of the value of <span class="RktVar">class-expr</span> (which
+must be a class), and the values of the <span class="RktVar">by-pos-expr</span>s are
+provided as by-position initialization arguments. In addition,
+the value of each <span class="RktVar">by-name-expr</span> is provided as a by-name
+argument for the corresponding <span class="RktVar">id</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/private/class-internal..rkt)._super-make-object))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-make-object%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">super-make-object</a></span></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Produces a procedure that takes by-position arguments an invokes
+superclass initialization. See <a href="objcreation.html" data-pltdoc="x">Creating Objects</a> for more
+information.</div></p><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._super-instantiate))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-instantiate%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">super-instantiate</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">by-pos-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">by-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote><p>Invokes superclass initialization with the specified by-position and
+by-name arguments. See <a href="objcreation.html" data-pltdoc="x">Creating Objects</a> for more
+information.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._super-new))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">super-new</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">by-name-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Invokes superclass initialization with the specified by-name
+arguments. See <a href="objcreation.html" data-pltdoc="x">Creating Objects</a> for more information.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="createclass.html" title="backward to &quot;6.2 Creating Classes&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="ivaraccess.html" title="forward to &quot;6.4 Field and Method Access&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/objectequality.html b/clones/docs.racket-lang.org/reference/objectequality.html
new file mode 100644
index 00000000..82c69240
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/objectequality.html
@@ -0,0 +1,31 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6.8&nbsp;Object Equality and Hashing</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewselflink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="createinterface.html" class="tocviewlink" data-pltdoc="x">Creating Interfaces</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="createclass.html" class="tocviewlink" data-pltdoc="x">Creating Classes</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="objcreation.html" class="tocviewlink" data-pltdoc="x">Creating Objects</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="ivaraccess.html" class="tocviewlink" data-pltdoc="x">Field and Method Access</a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="mixins.html" class="tocviewlink" data-pltdoc="x">Mixins</a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="trait.html" class="tocviewlink" data-pltdoc="x">Traits</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="Object_and_Class_Contracts.html" class="tocviewlink" data-pltdoc="x">Object and Class Contracts</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="objectequality.html" class="tocviewselflink" data-pltdoc="x">Object Equality and Hashing</a></td></tr><tr><td align="right">6.9&nbsp;</td><td><a href="objectserialize.html" class="tocviewlink" data-pltdoc="x">Object Serialization</a></td></tr><tr><td align="right">6.10&nbsp;</td><td><a href="objectprinting.html" class="tocviewlink" data-pltdoc="x">Object Printing</a></td></tr><tr><td align="right">6.11&nbsp;</td><td><a href="objectutils.html" class="tocviewlink" data-pltdoc="x">Object, Class, and Interface Utilities</a></td></tr><tr><td align="right">6.12&nbsp;</td><td><a href="Surrogates.html" class="tocviewlink" data-pltdoc="x">Surrogates</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="objectequality.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._equal~3c~25~3e%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">equal&lt;%&gt;</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Object_and_Class_Contracts.html" title="backward to &quot;6.7 Object and Class Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="objectserialize.html" title="forward to &quot;6.9 Object Serialization&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;objectequality&quot;">6.8<tt>&nbsp;</tt><a name="(part._objectequality)"></a>Object Equality and Hashing</h4><p>By default, objects that are instances of different classes or that
+are instances of a non-transparent class are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> only if
+they are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>. Like transparent structures, two objects that
+are instances of the same transparent class (i.e., every superclass of
+the class has <span class="RktVal">#f</span> as its inspector) are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> when
+their field values are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>.</p><p>To customize the way that a class instance is compared to other
+instances by <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>, implement the <span class="RktSym"><a href="objectequality.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._equal~3c~25~3e%29%29" class="RktValLink" data-pltdoc="x">equal&lt;%&gt;</a></span>
+interface.</p><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>interface</p></div></div><p class="RForeground"><a name="(def._((lib._racket/private/class-internal..rkt)._equal~3c~25~3e))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectequality.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._equal~3c~25~3e%29%29" class="RktValDef RktValLink" data-pltdoc="x">equal&lt;%&gt;</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface~3f%29%29" class="RktValLink" data-pltdoc="x">interface?</a></span></p></blockquote></td></tr></table></div><div class="SIntrapara">The <span class="RktSym"><a href="objectequality.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._equal~3c~25~3e%29%29" class="RktValLink" data-pltdoc="x">equal&lt;%&gt;</a></span> interface includes three methods, which are
+analogous to the functions provided for a structure type with
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._prop~3aequal%2Bhash%29%29" class="RktValLink" data-pltdoc="x">prop:equal+hash</a></span>:</div><div class="SIntrapara"><ul><li><p><span class="RktSym">equal-to?</span> &#8212;<wbr></wbr> Takes two arguments. The first argument
+is an object that is an instance of the same class (or a subclass
+that does not re-declare its implementation of <span class="RktSym"><a href="objectequality.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._equal~3c~25~3e%29%29" class="RktValLink" data-pltdoc="x">equal&lt;%&gt;</a></span>)
+and that is being compared to the target object. The second argument
+is an <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>-like procedure of two arguments that should be
+used for recursive equality testing. The result should be a true
+value if the object and the first argument of the method are equal,
+<span class="RktVal">#f</span> otherwise.</p></li><li><p><span class="RktSym">equal-hash-code-of</span> &#8212;<wbr></wbr> Takes one argument, which is a
+procedure of one argument that should be used for recursive hash-code
+computation. The result should be an exact integer representing the
+target object&rsquo;s hash code.</p></li><li><p><span class="RktSym">equal-secondary-hash-code-of</span> &#8212;<wbr></wbr> Takes one argument,
+which is a procedure of one argument that should be used for
+recursive hash-code computation. The result should be an exact
+integer representing the target object&rsquo;s secondary hash code.</p></li></ul></div><div class="SIntrapara">The <span class="RktSym"><a href="objectequality.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._equal~3c~25~3e%29%29" class="RktValLink" data-pltdoc="x">equal&lt;%&gt;</a></span> interface is unusual in that declaring the
+implementation of the interface is different from inheriting the
+interface. Two objects can be equal only if they are instances of
+classes whose most specific ancestor to explicitly implement
+<span class="RktSym"><a href="objectequality.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._equal~3c~25~3e%29%29" class="RktValLink" data-pltdoc="x">equal&lt;%&gt;</a></span> is the same ancestor.</div><div class="SIntrapara">See <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._prop~3aequal%2Bhash%29%29" class="RktValLink" data-pltdoc="x">prop:equal+hash</a></span> for more information on equality
+comparisons and hash codes. The <span class="RktSym"><a href="objectequality.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._equal~3c~25~3e%29%29" class="RktValLink" data-pltdoc="x">equal&lt;%&gt;</a></span> interface is
+implemented with <span class="RktSym"><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%2A%29%29" class="RktStxLink" data-pltdoc="x">interface*</a></span> and <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._prop~3aequal%2Bhash%29%29" class="RktValLink" data-pltdoc="x">prop:equal+hash</a></span>.</div><div class="SIntrapara"><blockquote class="leftindent"></blockquote></div></p><p><div class="SIntrapara">Example:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">Case</span><span class="hspace">&nbsp;</span><span class="RktCmt">insensitive</span><span class="hspace">&nbsp;</span><span class="RktCmt">words:</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">ci-word%</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="objectequality.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._equal~3c~25~3e%29%29" class="RktValLink" data-pltdoc="x">equal&lt;%&gt;</a></span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">Initialization</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._init-field%29%29" class="RktStxLink" data-pltdoc="x">init-field</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">word</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">We</span><span class="hspace">&nbsp;</span><span class="RktCmt">define</span><span class="hspace">&nbsp;</span><span class="RktCmt">equality</span><span class="hspace">&nbsp;</span><span class="RktCmt">to</span><span class="hspace">&nbsp;</span><span class="RktCmt">ignore</span><span class="hspace">&nbsp;</span><span class="RktCmt">case:</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">equal-to?</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">other</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">recur</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string-ci=?</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">word</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._get-field%29%29" class="RktStxLink" data-pltdoc="x">get-field</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">word</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">other</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">The</span><span class="hspace">&nbsp;</span><span class="RktCmt">hash</span><span class="hspace">&nbsp;</span><span class="RktCmt">codes</span><span class="hspace">&nbsp;</span><span class="RktCmt">need</span><span class="hspace">&nbsp;</span><span class="RktCmt">to</span><span class="hspace">&nbsp;</span><span class="RktCmt">be</span><span class="hspace">&nbsp;</span><span class="RktCmt">insensitive</span><span class="hspace">&nbsp;</span><span class="RktCmt">to</span><span class="hspace">&nbsp;</span><span class="RktCmt">casing</span><span class="hspace">&nbsp;</span><span class="RktCmt">as</span><span class="hspace">&nbsp;</span><span class="RktCmt">well.</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">We'll</span><span class="hspace">&nbsp;</span><span class="RktCmt">just</span><span class="hspace">&nbsp;</span><span class="RktCmt">downcase</span><span class="hspace">&nbsp;</span><span class="RktCmt">the</span><span class="hspace">&nbsp;</span><span class="RktCmt">word</span><span class="hspace">&nbsp;</span><span class="RktCmt">and</span><span class="hspace">&nbsp;</span><span class="RktCmt">get</span><span class="hspace">&nbsp;</span><span class="RktCmt">its</span><span class="hspace">&nbsp;</span><span class="RktCmt">hash</span><span class="hspace">&nbsp;</span><span class="RktCmt">code.</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">equal-hash-code-of</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">hash-code</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">hash-code</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-downcase%29%29" class="RktValLink" data-pltdoc="x">string-downcase</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">word</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">equal-secondary-hash-code-of</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">hash-code</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">hash-code</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-downcase%29%29" class="RktValLink" data-pltdoc="x">string-downcase</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">word</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">We</span><span class="hspace">&nbsp;</span><span class="RktCmt">can</span><span class="hspace">&nbsp;</span><span class="RktCmt">create</span><span class="hspace">&nbsp;</span><span class="RktCmt">a</span><span class="hspace">&nbsp;</span><span class="RktCmt">hash</span><span class="hspace">&nbsp;</span><span class="RktCmt">with</span><span class="hspace">&nbsp;</span><span class="RktCmt">a</span><span class="hspace">&nbsp;</span><span class="RktCmt">single</span><span class="hspace">&nbsp;</span><span class="RktCmt">word:</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">h</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%21%29%29" class="RktValLink" data-pltdoc="x">hash-set!</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">h</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">ci-word%</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">[</span><span class="RktSym">word</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">"inconceivable!"</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">'</a></span><span class="RktSym">value</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">Lookup</span><span class="hspace">&nbsp;</span><span class="RktCmt">into</span><span class="hspace">&nbsp;</span><span class="RktCmt">the</span><span class="hspace">&nbsp;</span><span class="RktCmt">hash</span><span class="hspace">&nbsp;</span><span class="RktCmt">should</span><span class="hspace">&nbsp;</span><span class="RktCmt">be</span><span class="hspace">&nbsp;</span><span class="RktCmt">case-insensitive,</span><span class="hspace">&nbsp;</span><span class="RktCmt">so</span><span class="hspace">&nbsp;</span><span class="RktCmt">that</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">both</span><span class="hspace">&nbsp;</span><span class="RktCmt">of</span><span class="hspace">&nbsp;</span><span class="RktCmt">these</span><span class="hspace">&nbsp;</span><span class="RktCmt">should</span><span class="hspace">&nbsp;</span><span class="RktCmt">return</span><span class="hspace">&nbsp;</span><span class="RktCmt">'value.</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">h</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">ci-word%</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">[</span><span class="RktSym">word</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">"inconceivable!"</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">h</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">ci-word%</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">[</span><span class="RktSym">word</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">"INCONCEIVABLE!"</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">Comparison</span><span class="hspace">&nbsp;</span><span class="RktCmt">fails</span><span class="hspace">&nbsp;</span><span class="RktCmt">if</span><span class="hspace">&nbsp;</span><span class="RktCmt">we</span><span class="hspace">&nbsp;</span><span class="RktCmt">use</span><span class="hspace">&nbsp;</span><span class="RktCmt">a</span><span class="hspace">&nbsp;</span><span class="RktCmt">non-ci-word%:</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">h</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">"inconceivable!"</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">'</a></span><span class="RktSym">i-dont-think-it-means-what-you-think-it-means</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Object_and_Class_Contracts.html" title="backward to &quot;6.7 Object and Class Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="objectserialize.html" title="forward to &quot;6.9 Object Serialization&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/objectprinting.html b/clones/docs.racket-lang.org/reference/objectprinting.html
new file mode 100644
index 00000000..efa95c13
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/objectprinting.html
@@ -0,0 +1,19 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6.10&nbsp;Object Printing</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewselflink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="createinterface.html" class="tocviewlink" data-pltdoc="x">Creating Interfaces</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="createclass.html" class="tocviewlink" data-pltdoc="x">Creating Classes</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="objcreation.html" class="tocviewlink" data-pltdoc="x">Creating Objects</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="ivaraccess.html" class="tocviewlink" data-pltdoc="x">Field and Method Access</a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="mixins.html" class="tocviewlink" data-pltdoc="x">Mixins</a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="trait.html" class="tocviewlink" data-pltdoc="x">Traits</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="Object_and_Class_Contracts.html" class="tocviewlink" data-pltdoc="x">Object and Class Contracts</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="objectequality.html" class="tocviewlink" data-pltdoc="x">Object Equality and Hashing</a></td></tr><tr><td align="right">6.9&nbsp;</td><td><a href="objectserialize.html" class="tocviewlink" data-pltdoc="x">Object Serialization</a></td></tr><tr><td align="right">6.10&nbsp;</td><td><a href="objectprinting.html" class="tocviewselflink" data-pltdoc="x">Object Printing</a></td></tr><tr><td align="right">6.11&nbsp;</td><td><a href="objectutils.html" class="tocviewlink" data-pltdoc="x">Object, Class, and Interface Utilities</a></td></tr><tr><td align="right">6.12&nbsp;</td><td><a href="Surrogates.html" class="tocviewlink" data-pltdoc="x">Surrogates</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="objectprinting.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._printable~3c~25~3e%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">printable&lt;%&gt;</span></span></a></td></tr><tr><td><a href="objectprinting.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._writable~3c~25~3e%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">writable&lt;%&gt;</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="objectserialize.html" title="backward to &quot;6.9 Object Serialization&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="objectutils.html" title="forward to &quot;6.11 Object, Class, and Interface Utilities&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;objectprinting&quot;">6.10<tt>&nbsp;</tt><a name="(part._objectprinting)"></a>Object Printing</h4><p>To customize the way that a class instance is printed by
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>, <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> and <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>, implement the
+<span class="RktSym"><a href="objectprinting.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._printable~3c~25~3e%29%29" class="RktValLink" data-pltdoc="x">printable&lt;%&gt;</a></span> interface.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/private/class-internal..rkt)._printable~3c~25~3e))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectprinting.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._printable~3c~25~3e%29%29" class="RktValDef RktValLink" data-pltdoc="x">printable&lt;%&gt;</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface~3f%29%29" class="RktValLink" data-pltdoc="x">interface?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="objectprinting.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._printable~3c~25~3e%29%29" class="RktValLink" data-pltdoc="x">printable&lt;%&gt;</a></span> interface includes only the
+<span class="RktSym">custom-print</span>, <span class="RktSym">custom-write</span>, and
+<span class="RktSym">custom-display</span> methods. The <span class="RktSym">custom-print</span> method
+accepts two arguments: the destination port and the current
+<span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span> depth as an exact nonnegative integer. The
+<span class="RktSym">custom-write</span> and <span class="RktSym">custom-display</span> methods each accepts
+a single argument, which is the destination port to <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> or
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> the object.</div></p><p>Calls to the <span class="RktSym">custom-print</span>, <span class="RktSym">custom-write</span>, or
+<span class="RktSym">custom-display</span> methods are like calls to a procedure attached
+to a structure type through the <span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">prop:custom-write</a></span>
+property. In particular, recursive printing can trigger an escape from
+the call.</p><p>See <span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">prop:custom-write</a></span> for more information. The
+<span class="RktSym"><a href="objectprinting.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._printable~3c~25~3e%29%29" class="RktValLink" data-pltdoc="x">printable&lt;%&gt;</a></span> interface is implemented with
+<span class="RktSym"><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%2A%29%29" class="RktStxLink" data-pltdoc="x">interface*</a></span> and <span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">prop:custom-write</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/private/class-internal..rkt)._writable~3c~25~3e))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectprinting.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._writable~3c~25~3e%29%29" class="RktValDef RktValLink" data-pltdoc="x">writable&lt;%&gt;</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface~3f%29%29" class="RktValLink" data-pltdoc="x">interface?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="objectprinting.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._printable~3c~25~3e%29%29" class="RktValLink" data-pltdoc="x">printable&lt;%&gt;</a></span>, but includes only the
+<span class="RktSym">custom-write</span> and <span class="RktSym">custom-display</span> methods.
+A <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> request is directed to <span class="RktSym">custom-write</span>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="objectserialize.html" title="backward to &quot;6.9 Object Serialization&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="objectutils.html" title="forward to &quot;6.11 Object, Class, and Interface Utilities&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/objectserialize.html b/clones/docs.racket-lang.org/reference/objectserialize.html
new file mode 100644
index 00000000..072984d3
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/objectserialize.html
@@ -0,0 +1,40 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6.9&nbsp;Object Serialization</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewselflink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="createinterface.html" class="tocviewlink" data-pltdoc="x">Creating Interfaces</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="createclass.html" class="tocviewlink" data-pltdoc="x">Creating Classes</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="objcreation.html" class="tocviewlink" data-pltdoc="x">Creating Objects</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="ivaraccess.html" class="tocviewlink" data-pltdoc="x">Field and Method Access</a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="mixins.html" class="tocviewlink" data-pltdoc="x">Mixins</a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="trait.html" class="tocviewlink" data-pltdoc="x">Traits</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="Object_and_Class_Contracts.html" class="tocviewlink" data-pltdoc="x">Object and Class Contracts</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="objectequality.html" class="tocviewlink" data-pltdoc="x">Object Equality and Hashing</a></td></tr><tr><td align="right">6.9&nbsp;</td><td><a href="objectserialize.html" class="tocviewselflink" data-pltdoc="x">Object Serialization</a></td></tr><tr><td align="right">6.10&nbsp;</td><td><a href="objectprinting.html" class="tocviewlink" data-pltdoc="x">Object Printing</a></td></tr><tr><td align="right">6.11&nbsp;</td><td><a href="objectutils.html" class="tocviewlink" data-pltdoc="x">Object, Class, and Interface Utilities</a></td></tr><tr><td align="right">6.12&nbsp;</td><td><a href="Surrogates.html" class="tocviewlink" data-pltdoc="x">Surrogates</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="objectserialize.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-serializable-class%2A%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>serializable-<wbr></wbr>class*</span></span></a></td></tr><tr><td><a href="objectserialize.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-serializable-class%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>serializable-<wbr></wbr>class</span></span></a></td></tr><tr><td><a href="objectserialize.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._externalizable~3c~25~3e%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">externalizable&lt;%&gt;</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="objectequality.html" title="backward to &quot;6.8 Object Equality and Hashing&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="objectprinting.html" title="forward to &quot;6.10 Object Printing&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;objectserialize&quot;">6.9<tt>&nbsp;</tt><a name="(part._objectserialize)"></a>Object Serialization</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._define-serializable-class*))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectserialize.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-serializable-class%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-serializable-class*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">class-id</span><span class="hspace">&nbsp;</span><span class="RktVar">superclass-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">interface-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">class-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Binds <span class="RktVar">class-id</span> to a class, where <span class="RktVar">superclass-expr</span>,
+the <span class="RktVar">interface-expr</span>s, and the <span class="RktVar">class-clause</span>s are as in
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span>.</div></p><p>This form can only be used at the top level, either within a module
+or outside. The <span class="RktVar">class-id</span> identifier is bound to the new
+class, and <span class="RktSym">deserialize-info:</span><span class="RktVar">class-id</span> is also
+defined; if the definition is within a module, then the latter is
+provided from a <span class="RktSym">deserialize-info</span> submodule via <span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._module%2B%29%29" class="RktStxLink" data-pltdoc="x">module+</a></span>.</p><p>Serialization for the class works in one of two ways:</p><ul><li><p>If the class implements the built-in interface
+<span class="RktSym"><a href="objectserialize.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._externalizable~3c~25~3e%29%29" class="RktValLink" data-pltdoc="x">externalizable&lt;%&gt;</a></span>, then an object is serialized by
+calling its <span class="RktSym">externalize</span> method; the result can be
+anything that is serializable (but, obviously, should not be
+the object itself). Deserialization creates an instance of the
+class with no initialization arguments, and then calls the
+object&rsquo;s <span class="RktSym">internalize</span> method with the result of
+<span class="RktSym">externalize</span> (or, more precisely, a deserialized
+version of the serialized result of a previous call).</p><p>To support this form of serialization, the class must be
+instantiable with no initialization arguments. Furthermore,
+cycles involving only instances of the class (and other such
+classes) cannot be serialized.</p></li><li><p>If the class does not implement <span class="RktSym"><a href="objectserialize.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._externalizable~3c~25~3e%29%29" class="RktValLink" data-pltdoc="x">externalizable&lt;%&gt;</a></span>,
+then every superclass of the class must be either serializable
+or transparent (i.e,. have <span class="RktVal">#f</span> as its
+inspector). Serialization and deserialization are fully
+automatic, and may involve cycles of instances.</p><p>To support cycles of instances, deserialization may create an
+instance of the call with all fields as the undefined value,
+and then mutate the object to set the field
+values. Serialization support does not otherwise make an
+object&rsquo;s fields mutable.</p></li></ul><p>In the second case, a serializable subclass can implement
+<span class="RktSym"><a href="objectserialize.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._externalizable~3c~25~3e%29%29" class="RktValLink" data-pltdoc="x">externalizable&lt;%&gt;</a></span>, in which case the <span class="RktSym">externalize</span>
+method is responsible for all serialization (i.e., automatic
+serialization is lost for instances of the subclass). In the first
+case, all serializable subclasses implement
+<span class="RktSym"><a href="objectserialize.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._externalizable~3c~25~3e%29%29" class="RktValLink" data-pltdoc="x">externalizable&lt;%&gt;</a></span>, since a subclass implements all of the
+interfaces of its parent class.</p><p>In either case, if an object is an immediate instance of a subclass
+(that is not itself serializable), the object is serialized as if it
+was an immediate instance of the serializable class. In particular,
+overriding declarations of the <span class="RktSym">externalize</span> method are ignored
+for instances of non-serializable subclasses.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/class-internal..rkt)._define-serializable-class))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectserialize.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-serializable-class%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-serializable-class</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">class-id</span><span class="hspace">&nbsp;</span><span class="RktVar">superclass-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">class-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="objectserialize.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-serializable-class%2A%29%29" class="RktStxLink" data-pltdoc="x">define-serializable-class*</a></span>, but without interface
+expressions (analogous to <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span>).</div></p><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>interface</p></div></div><p class="RForeground"><a name="(def._((lib._racket/private/class-internal..rkt)._externalizable~3c~25~3e))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectserialize.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._externalizable~3c~25~3e%29%29" class="RktValDef RktValLink" data-pltdoc="x">externalizable&lt;%&gt;</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface~3f%29%29" class="RktValLink" data-pltdoc="x">interface?</a></span></p></blockquote></td></tr></table></div><div class="SIntrapara">The <span class="RktSym"><a href="objectserialize.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._externalizable~3c~25~3e%29%29" class="RktValLink" data-pltdoc="x">externalizable&lt;%&gt;</a></span> interface includes only the
+<span class="RktSym">externalize</span> and <span class="RktSym">internalize</span> methods. See
+<span class="RktSym"><a href="objectserialize.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-serializable-class%2A%29%29" class="RktStxLink" data-pltdoc="x">define-serializable-class*</a></span> for more information.</div><div class="SIntrapara"><blockquote class="leftindent"></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="objectequality.html" title="backward to &quot;6.8 Object Equality and Hashing&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="objectprinting.html" title="forward to &quot;6.10 Object Printing&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/objectutils.html b/clones/docs.racket-lang.org/reference/objectutils.html
new file mode 100644
index 00000000..9872ce17
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/objectutils.html
@@ -0,0 +1,61 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6.11&nbsp;Object, Class, and Interface Utilities</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewselflink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="createinterface.html" class="tocviewlink" data-pltdoc="x">Creating Interfaces</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="createclass.html" class="tocviewlink" data-pltdoc="x">Creating Classes</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="objcreation.html" class="tocviewlink" data-pltdoc="x">Creating Objects</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="ivaraccess.html" class="tocviewlink" data-pltdoc="x">Field and Method Access</a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="mixins.html" class="tocviewlink" data-pltdoc="x">Mixins</a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="trait.html" class="tocviewlink" data-pltdoc="x">Traits</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="Object_and_Class_Contracts.html" class="tocviewlink" data-pltdoc="x">Object and Class Contracts</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="objectequality.html" class="tocviewlink" data-pltdoc="x">Object Equality and Hashing</a></td></tr><tr><td align="right">6.9&nbsp;</td><td><a href="objectserialize.html" class="tocviewlink" data-pltdoc="x">Object Serialization</a></td></tr><tr><td align="right">6.10&nbsp;</td><td><a href="objectprinting.html" class="tocviewlink" data-pltdoc="x">Object Printing</a></td></tr><tr><td align="right">6.11&nbsp;</td><td><a href="objectutils.html" class="tocviewselflink" data-pltdoc="x">Object, Class, and Interface Utilities</a></td></tr><tr><td align="right">6.12&nbsp;</td><td><a href="Surrogates.html" class="tocviewlink" data-pltdoc="x">Surrogates</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">object?</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">class?</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">interface?</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._generic~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">generic?</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3d~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">object=?</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-or-false~3d~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">object-<wbr></wbr>or-<wbr></wbr>false=?</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3d-hash-code%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">object=-<wbr></wbr>hash-<wbr></wbr>code</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-~3evector%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">object-<wbr></wbr>&gt;vector</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-~3einterface%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">class-<wbr></wbr>&gt;interface</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-interface%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">object-<wbr></wbr>interface</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._is-a~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">is-<wbr></wbr>a?</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._subclass~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subclass?</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._implementation~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">implementation?</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface-extension~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">interface-<wbr></wbr>extension?</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._method-in-interface~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">method-<wbr></wbr>in-<wbr></wbr>interface?</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface-~3emethod-names%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">interface-<wbr></wbr>&gt;method-<wbr></wbr>names</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-method-arity-includes~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">object-<wbr></wbr>method-<wbr></wbr>arity-<wbr></wbr>includes?</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field-names%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">field-<wbr></wbr>names</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-info%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">object-<wbr></wbr>info</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-info%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">class-<wbr></wbr>info</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>object</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-seal%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">class-<wbr></wbr>seal</span></span></a></td></tr><tr><td><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-unseal%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">class-<wbr></wbr>unseal</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="objectprinting.html" title="backward to &quot;6.10 Object Printing&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Surrogates.html" title="forward to &quot;6.12 Surrogates&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;objectutils&quot;">6.11<tt>&nbsp;</tt><a name="(part._objectutils)"></a>Object, Class, and Interface Utilities</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._object~3f))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">object?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is an object, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3f%29%29" class="RktValLink" data-pltdoc="x">object?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3f%29%29" class="RktValLink" data-pltdoc="x">object?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3f%29%29" class="RktValLink" data-pltdoc="x">object?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"clam chowder"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._class~3f))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">class?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a class, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"corn chowder"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._interface~3f))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">interface?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is an interface, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface~3f%29%29" class="RktValLink" data-pltdoc="x">interface?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%29%29" class="RktStxLink" data-pltdoc="x">interface</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._empty%29%29" class="RktValLink" data-pltdoc="x">empty</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._first%29%29" class="RktValLink" data-pltdoc="x">first</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface~3f%29%29" class="RktValLink" data-pltdoc="x">interface?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface~3f%29%29" class="RktValLink" data-pltdoc="x">interface?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"gazpacho"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._generic~3f))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._generic~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">generic?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="ivaraccess.html#%28tech._generic%29" class="techoutside" data-pltdoc="x"><span class="techinside">generic</span></a>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3.14</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._generic~3f%29%29" class="RktValLink" data-pltdoc="x">generic?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="ivaraccess.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._generic%29%29" class="RktStxLink" data-pltdoc="x">generic</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c%</span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._generic~3f%29%29" class="RktValLink" data-pltdoc="x">generic?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c%</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._generic~3f%29%29" class="RktValLink" data-pltdoc="x">generic?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"borscht"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._object~3d~3f))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">object=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3f%29%29" class="RktValLink" data-pltdoc="x">object?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3f%29%29" class="RktValLink" data-pltdoc="x">object?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Determines whether <span class="RktVar">a</span> and <span class="RktVar">b</span> were returned from
+the same call to <span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span> or not. If the two objects
+have fields, this procedure determines whether mutating a field
+of one would change that field in the other.</div></p><p>This procedure is similar in spirit to
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> but also works properly with contracts
+(and has a stronger guarantee).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">obj-1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">obj-2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">obj-3</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Object_and_Class_Contracts.html#%28form._%28%28lib._racket%2Fclass..rkt%29._object%2Fc%29%29" class="RktStxLink" data-pltdoc="x">object/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">obj-1</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3d~3f%29%29" class="RktValLink" data-pltdoc="x">object=?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">obj-1</span><span class="hspace">&nbsp;</span><span class="RktSym">obj-1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3d~3f%29%29" class="RktValLink" data-pltdoc="x">object=?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">obj-1</span><span class="hspace">&nbsp;</span><span class="RktSym">obj-2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3d~3f%29%29" class="RktValLink" data-pltdoc="x">object=?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">obj-1</span><span class="hspace">&nbsp;</span><span class="RktSym">obj-3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">obj-1</span><span class="hspace">&nbsp;</span><span class="RktSym">obj-1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">obj-1</span><span class="hspace">&nbsp;</span><span class="RktSym">obj-2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">obj-1</span><span class="hspace">&nbsp;</span><span class="RktSym">obj-3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._object-or-false~3d~3f))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-or-false~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">object-or-false=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3f%29%29" class="RktValLink" data-pltdoc="x">object?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3f%29%29" class="RktValLink" data-pltdoc="x">object?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3d~3f%29%29" class="RktValLink" data-pltdoc="x">object=?</a></span>, but accepts <span class="RktVal">#f</span> for either argument and
+returns <span class="RktVal">#t</span> if both arguments are <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-or-false~3d~3f%29%29" class="RktValLink" data-pltdoc="x">object-or-false=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-or-false~3d~3f%29%29" class="RktValLink" data-pltdoc="x">object-or-false=?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-or-false~3d~3f%29%29" class="RktValLink" data-pltdoc="x">object-or-false=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.1.1.8 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._object~3d-hash-code))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3d-hash-code%29%29" class="RktValDef RktValLink" data-pltdoc="x">object=-hash-code</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">o</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">o</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3f%29%29" class="RktValLink" data-pltdoc="x">object?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the hash code for <span class="RktVar">o</span> that corresponds to
+ the equality relation <span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3d~3f%29%29" class="RktValLink" data-pltdoc="x">object=?</a></span>.</div></p><p class="SHistory">Added in version 7.1.0.6 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._object-~3evector))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-~3evector%29%29" class="RktValDef RktValLink" data-pltdoc="x">object-&gt;vector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">object</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">opaque-v</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">object</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3f%29%29" class="RktValLink" data-pltdoc="x">object?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">opaque-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a vector representing <span class="RktVar">object</span> that shows its
+inspectable fields, analogous to <span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-~3evector%29%29" class="RktValLink" data-pltdoc="x">struct-&gt;vector</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-~3evector%29%29" class="RktValLink" data-pltdoc="x">object-&gt;vector</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#(object:object% ...)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-~3evector%29%29" class="RktValLink" data-pltdoc="x">object-&gt;vector</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'#(object:eval:107:0 ...)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._class-~3einterface))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-~3einterface%29%29" class="RktValDef RktValLink" data-pltdoc="x">class-&gt;interface</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">class</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface~3f%29%29" class="RktValLink" data-pltdoc="x">interface?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">class</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the interface implicitly defined by <span class="RktVar">class</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-~3einterface%29%29" class="RktValLink" data-pltdoc="x">class-&gt;interface</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;interface:object%&gt;</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._object-interface))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-interface%29%29" class="RktValDef RktValLink" data-pltdoc="x">object-interface</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">object</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface~3f%29%29" class="RktValLink" data-pltdoc="x">interface?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">object</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3f%29%29" class="RktValLink" data-pltdoc="x">object?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the interface implicitly defined by the class of
+<span class="RktVar">object</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-interface%29%29" class="RktValLink" data-pltdoc="x">object-interface</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;interface:object%&gt;</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._is-a~3f))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._is-a~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">is-a?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">type</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">type</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface~3f%29%29" class="RktValLink" data-pltdoc="x">interface?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is an instance of a class
+<span class="RktVar">type</span> or a class that implements an interface <span class="RktVar">type</span>,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">point&lt;%&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%29%29" class="RktStxLink" data-pltdoc="x">interface</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">get-x</span><span class="hspace">&nbsp;</span><span class="RktSym">get-y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">2d-point%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point&lt;%&gt;</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._is-a~3f%29%29" class="RktValLink" data-pltdoc="x">is-a?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">2d-point%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">2d-point%</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._is-a~3f%29%29" class="RktValLink" data-pltdoc="x">is-a?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">2d-point%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">point&lt;%&gt;</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._is-a~3f%29%29" class="RktValLink" data-pltdoc="x">is-a?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">2d-point%</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._is-a~3f%29%29" class="RktValLink" data-pltdoc="x">is-a?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">point&lt;%&gt;</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._subclass~3f))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._subclass~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">subclass?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">cls</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cls</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a class derived from (or equal
+to) <span class="RktVar">cls</span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._subclass~3f%29%29" class="RktValLink" data-pltdoc="x">subclass?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._subclass~3f%29%29" class="RktValLink" data-pltdoc="x">subclass?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._subclass~3f%29%29" class="RktValLink" data-pltdoc="x">subclass?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._implementation~3f))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._implementation~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">implementation?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">intf</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">intf</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface~3f%29%29" class="RktValLink" data-pltdoc="x">interface?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a class that implements
+<span class="RktVar">intf</span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i&lt;%&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%29%29" class="RktStxLink" data-pltdoc="x">interface</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">go</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">i&lt;%&gt;</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">go</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">go</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._implementation~3f%29%29" class="RktValLink" data-pltdoc="x">implementation?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c%</span><span class="hspace">&nbsp;</span><span class="RktSym">i&lt;%&gt;</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._implementation~3f%29%29" class="RktValLink" data-pltdoc="x">implementation?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i&lt;%&gt;</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._interface-extension~3f))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface-extension~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">interface-extension?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">intf</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">intf</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface~3f%29%29" class="RktValLink" data-pltdoc="x">interface?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is an interface that extends
+<span class="RktVar">intf</span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">point&lt;%&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%29%29" class="RktStxLink" data-pltdoc="x">interface</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">get-x</span><span class="hspace">&nbsp;</span><span class="RktSym">get-y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">colored-point&lt;%&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%29%29" class="RktStxLink" data-pltdoc="x">interface</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point&lt;%&gt;</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">color</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface-extension~3f%29%29" class="RktValLink" data-pltdoc="x">interface-extension?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">colored-point&lt;%&gt;</span><span class="hspace">&nbsp;</span><span class="RktSym">point&lt;%&gt;</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface-extension~3f%29%29" class="RktValLink" data-pltdoc="x">interface-extension?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">point&lt;%&gt;</span><span class="hspace">&nbsp;</span><span class="RktSym">colored-point&lt;%&gt;</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface-extension~3f%29%29" class="RktValLink" data-pltdoc="x">interface-extension?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%29%29" class="RktStxLink" data-pltdoc="x">interface</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">get-x</span><span class="hspace">&nbsp;</span><span class="RktSym">get-y</span><span class="hspace">&nbsp;</span><span class="RktSym">get-z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">point&lt;%&gt;</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._method-in-interface~3f))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._method-in-interface~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">method-in-interface?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span><span class="RktVar">intf</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">intf</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface~3f%29%29" class="RktValLink" data-pltdoc="x">interface?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">intf</span> (or any of its ancestor
+interfaces) includes a member with the name <span class="RktVar">sym</span>, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i&lt;%&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%29%29" class="RktStxLink" data-pltdoc="x">interface</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">get-x</span><span class="hspace">&nbsp;</span><span class="RktSym">get-y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._method-in-interface~3f%29%29" class="RktValLink" data-pltdoc="x">method-in-interface?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">get-x</span><span class="hspace">&nbsp;</span><span class="RktSym">i&lt;%&gt;</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._method-in-interface~3f%29%29" class="RktValLink" data-pltdoc="x">method-in-interface?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">get-z</span><span class="hspace">&nbsp;</span><span class="RktSym">i&lt;%&gt;</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._interface-~3emethod-names))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface-~3emethod-names%29%29" class="RktValDef RktValLink" data-pltdoc="x">interface-&gt;method-names</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">intf</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">intf</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface~3f%29%29" class="RktValLink" data-pltdoc="x">interface?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of symbols for the method names in <span class="RktVar">intf</span>,
+including methods inherited from superinterfaces, but not including
+methods whose names are local (i.e., declared with
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-local-member-name%29%29" class="RktStxLink" data-pltdoc="x">define-local-member-name</a></span>).</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i&lt;%&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createinterface.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface%29%29" class="RktStxLink" data-pltdoc="x">interface</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">get-x</span><span class="hspace">&nbsp;</span><span class="RktSym">get-y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._interface-~3emethod-names%29%29" class="RktValLink" data-pltdoc="x">interface-&gt;method-names</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i&lt;%&gt;</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(get-y get-x)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._object-method-arity-includes~3f))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-method-arity-includes~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">object-method-arity-includes?</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">object</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">sym</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">cnt</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">object</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3f%29%29" class="RktValLink" data-pltdoc="x">object?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cnt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">object</span> has a method named <span class="RktVar">sym</span>
+that accepts <span class="RktVar">cnt</span> arguments, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-method-arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">object-method-arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">m</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-method-arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">object-method-arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">m</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-method-arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">object-method-arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">m</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-method-arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">object-method-arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">n</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._field-names))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field-names%29%29" class="RktValDef RktValLink" data-pltdoc="x">field-names</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">object</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">object</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3f%29%29" class="RktValLink" data-pltdoc="x">object?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of all of the names of the fields bound in
+<span class="RktVar">object</span>, including fields inherited from superinterfaces, but
+not including fields whose names are local (i.e., declared with
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-local-member-name%29%29" class="RktStxLink" data-pltdoc="x">define-local-member-name</a></span>).</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field-names%29%29" class="RktValLink" data-pltdoc="x">field-names</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field-names%29%29" class="RktValLink" data-pltdoc="x">field-names</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._new%29%29" class="RktStxLink" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~25%29%29" class="RktValLink" data-pltdoc="x">object%</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(y x)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._object-info))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object-info%29%29" class="RktValDef RktValLink" data-pltdoc="x">object-info</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">object</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">object</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._object~3f%29%29" class="RktValLink" data-pltdoc="x">object?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns two values, analogous to the return
+values of <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-info%29%29" class="RktValLink" data-pltdoc="x">struct-info</a></span>:
+</div><div class="SIntrapara"><ul><li><p><span class="RktVar">class</span>: a class or <span class="RktVal">#f</span>; the result is
+<span class="RktVal">#f</span> if the current inspector does not control any class for
+which the <span class="RktVar">object</span> is an instance.</p></li><li><p><span class="RktVar">skipped?</span>: <span class="RktVal">#f</span> if the first result corresponds
+to the most specific class of <span class="RktVar">object</span>, <span class="RktVal">#t</span>
+otherwise.</p></li></ul></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._class-info))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-info%29%29" class="RktValDef RktValLink" data-pltdoc="x">class-info</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">class</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">class</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns seven values, analogous to the return
+values of <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-info%29%29" class="RktValLink" data-pltdoc="x">struct-type-info</a></span>:</div></p><ul><li><p><span class="RktVar">name</span>: the class&rsquo;s name as a symbol;</p></li><li><p><span class="RktVar">field-cnt</span>: the number of fields (public and private)
+defined by the class;</p></li><li><p><span class="RktVar">field-name-list</span>: a list of symbols corresponding to the
+class&rsquo;s public fields; this list can be larger than <span class="RktVar">field-cnt</span>
+because it includes inherited fields;</p></li><li><p><span class="RktVar">field-accessor</span>: an accessor procedure for obtaining
+field values in instances of the class; the accessor takes an
+instance and a field index between <span class="RktVal">0</span> (inclusive)
+and <span class="RktVar">field-cnt</span> (exclusive);</p></li><li><p><span class="RktVar">field-mutator</span>: a mutator procedure for modifying
+field values in instances of the class; the mutator takes an
+instance, a field index between <span class="RktVal">0</span> (inclusive)
+and <span class="RktVar">field-cnt</span> (exclusive), and a new field value;</p></li><li><p><span class="RktVar">super-class</span>: a class for the most specific ancestor of
+the given class that is controlled by the current inspector,
+or <span class="RktVal">#f</span> if no ancestor is controlled by the current
+inspector;</p></li><li><p><span class="RktVar">skipped?</span>: <span class="RktVal">#f</span> if the sixth result is the most
+specific ancestor class, <span class="RktVal">#t</span> otherwise.</p></li></ul><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/private/class-internal..rkt)._make-exn~3afail~3aobject))"></a><a name="(def._((lib._racket/private/class-internal..rkt)._exn~3afail~3aobject~3f))"></a><a name="(def._((lib._racket/private/class-internal..rkt)._struct~3aexn~3afail~3aobject))"></a><a name="(def._((lib._racket/private/class-internal..rkt)._exn~3afail~3aobject))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._exn~3afail~3aobject%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:object</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._make-exn~3afail~3aobject%29%29" class="RktValLink" data-pltdoc="x">make-exn:fail:object</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised for <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span>-related failures, such as attempting to call
+a method that is not supplied by an object.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._class-seal))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-seal%29%29" class="RktValDef RktValLink" data-pltdoc="x">class-seal</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">class</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">key</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">unsealed-inits</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">unsealed-fields</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">unsealed-methods</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">inst-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">member-proc</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">class</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">unsealed-inits</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">unsealed-fields</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">unsealed-methods</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">inst-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">member-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Adds a seal to a given class keyed with the symbol <span class="RktVar">key</span>. The
+given <span class="RktVar">unsealed-inits</span>, <span class="RktVar">unsealed-fields</span>, and
+<span class="RktVar">unsealed-methods</span> list corresponding class members that are
+unaffected by sealing.</div></p><p>When a class has any seals, the <span class="RktVar">inst-proc</span> procedure is called
+on instantiation (normally, this is used to raise an error on
+instantiation) and the <span class="RktVar">member-proc</span> function is called
+(again, this is normally used to raise an error) when a subclass
+attempts to add class members that are not listed in the unsealed lists.</p><p>The <span class="RktVar">inst-proc</span> is called with the class value on which an
+instantiation was attempted. The <span class="RktVar">member-proc</span> is called with
+the class value and the list of initialization argument, field, or
+method names.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/class-internal..rkt)._class-unseal))"></a><span title="Provided from: racket/class, racket | Package: base"><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-unseal%29%29" class="RktValDef RktValLink" data-pltdoc="x">class-unseal</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">class</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">wrong-key-proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">class</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">wrong-key-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Removes a seal on a class that has been previously sealed with the
+<span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class-seal%29%29" class="RktValLink" data-pltdoc="x">class-seal</a></span> function and the given <span class="RktVar">key</span>.</div></p><p>If the unseal removed all of the seals in the class, the class
+value can be instantiated or subclassed freely. If the given
+class value does not contain or any seals or does not contain
+any seals with the given key, the <span class="RktVar">wrong-key-proc</span> function
+is called with the class value.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="objectprinting.html" title="backward to &quot;6.10 Object Printing&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Surrogates.html" title="forward to &quot;6.12 Surrogates&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/os-lib.html b/clones/docs.racket-lang.org/reference/os-lib.html
new file mode 100644
index 00000000..686b5ffb
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/os-lib.html
@@ -0,0 +1,3 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15.10&nbsp;Additional Operating System Functions</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewselflink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewlink" data-pltdoc="x">Paths</a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="Filesystem.html" class="tocviewlink" data-pltdoc="x">Filesystem</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="networking.html" class="tocviewlink" data-pltdoc="x">Networking</a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="subprocess.html" class="tocviewlink" data-pltdoc="x">Processes</a></td></tr><tr><td align="right">15.5&nbsp;</td><td><a href="logging.html" class="tocviewlink" data-pltdoc="x">Logging</a></td></tr><tr><td align="right">15.6&nbsp;</td><td><a href="time.html" class="tocviewlink" data-pltdoc="x">Time</a></td></tr><tr><td align="right">15.7&nbsp;</td><td><a href="envvars.html" class="tocviewlink" data-pltdoc="x">Environment Variables</a></td></tr><tr><td align="right">15.8&nbsp;</td><td><a href="runtime.html" class="tocviewlink" data-pltdoc="x">Environment and Runtime Information</a></td></tr><tr><td align="right">15.9&nbsp;</td><td><a href="Command-Line_Parsing.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Parsing</a></td></tr><tr><td align="right">15.10&nbsp;</td><td><a href="os-lib.html" class="tocviewselflink" data-pltdoc="x">Additional Operating System Functions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="os-lib.html#%28def._%28%28lib._racket%2Fos..rkt%29._gethostname%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">gethostname</span></span></a></td></tr><tr><td><a href="os-lib.html#%28def._%28%28lib._racket%2Fos..rkt%29._getpid%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">getpid</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Command-Line_Parsing.html" title="backward to &quot;15.9 Command-Line Parsing&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="os.html" title="up to &quot;15 Operating System&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="memory.html" title="forward to &quot;16 Memory Management&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;os-lib&quot;">15.10<tt>&nbsp;</tt><a name="(part._os-lib)"></a><a name="(mod-path._racket/os)"></a>Additional Operating System Functions</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="os-lib.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/os</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The <a href="os-lib.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/os</span></a> library
+additional functions for querying the operating system.</div></p><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/os..rkt)._gethostname))"></a><span title="Provided from: racket/os | Package: base"><span class="RktSym"><a href="os-lib.html#%28def._%28%28lib._racket%2Fos..rkt%29._gethostname%29%29" class="RktValDef RktValLink" data-pltdoc="x">gethostname</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns a string for the current machine&rsquo;s hostname (including its domain).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/os..rkt)._getpid))"></a><span title="Provided from: racket/os | Package: base"><span class="RktSym"><a href="os-lib.html#%28def._%28%28lib._racket%2Fos..rkt%29._getpid%29%29" class="RktValDef RktValLink" data-pltdoc="x">getpid</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns an integer identifying the current process within the operating system.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Command-Line_Parsing.html" title="backward to &quot;15.9 Command-Line Parsing&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="os.html" title="up to &quot;15 Operating System&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="memory.html" title="forward to &quot;16 Memory Management&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/os.html b/clones/docs.racket-lang.org/reference/os.html
new file mode 100644
index 00000000..d20e1294
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/os.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15&nbsp;Operating System</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewselflink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>15&nbsp;</td><td><a href="os.html" class="tocviewselflink" data-pltdoc="x">Operating System</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewlink" data-pltdoc="x">Paths</a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="Filesystem.html" class="tocviewlink" data-pltdoc="x">Filesystem</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="networking.html" class="tocviewlink" data-pltdoc="x">Networking</a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="subprocess.html" class="tocviewlink" data-pltdoc="x">Processes</a></td></tr><tr><td align="right">15.5&nbsp;</td><td><a href="logging.html" class="tocviewlink" data-pltdoc="x">Logging</a></td></tr><tr><td align="right">15.6&nbsp;</td><td><a href="time.html" class="tocviewlink" data-pltdoc="x">Time</a></td></tr><tr><td align="right">15.7&nbsp;</td><td><a href="envvars.html" class="tocviewlink" data-pltdoc="x">Environment Variables</a></td></tr><tr><td align="right">15.8&nbsp;</td><td><a href="runtime.html" class="tocviewlink" data-pltdoc="x">Environment and Runtime Information</a></td></tr><tr><td align="right">15.9&nbsp;</td><td><a href="Command-Line_Parsing.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Parsing</a></td></tr><tr><td align="right">15.10&nbsp;</td><td><a href="os-lib.html" class="tocviewlink" data-pltdoc="x">Additional Operating System Functions</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="linklets.html" title="backward to &quot;14.14 Linklets and the Core Compiler&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="pathutils.html" title="forward to &quot;15.1 Paths&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;os&quot;">15<tt>&nbsp;</tt><a name="(part._os)"></a>Operating System</h3><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pathutils.html" class="toclink" data-pltdoc="x">15.1<span class="hspace">&nbsp;</span>Paths</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Manipulating_Paths.html" class="toclink" data-pltdoc="x">15.1.1<span class="hspace">&nbsp;</span>Manipulating Paths</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="More_Path_Utilities.html" class="toclink" data-pltdoc="x">15.1.2<span class="hspace">&nbsp;</span>More Path Utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="unixpaths.html" class="toclink" data-pltdoc="x">15.1.3<span class="hspace">&nbsp;</span>Unix and Mac OS Paths</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="unixpaths.html#%28part._unixpathrep%29" class="toclink" data-pltdoc="x">15.1.3.1<span class="hspace">&nbsp;</span>Unix Path Representation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="windowspaths.html" class="toclink" data-pltdoc="x">15.1.4<span class="hspace">&nbsp;</span>Windows Paths</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="windowspaths.html#%28part._windowspathrep%29" class="toclink" data-pltdoc="x">15.1.4.1<span class="hspace">&nbsp;</span>Windows Path Representation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Filesystem.html" class="toclink" data-pltdoc="x">15.2<span class="hspace">&nbsp;</span>Filesystem</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Filesystem.html#%28part._findpaths%29" class="toclink" data-pltdoc="x">15.2.1<span class="hspace">&nbsp;</span>Locating Paths</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Filesystem.html#%28part._fileutils%29" class="toclink" data-pltdoc="x">15.2.2<span class="hspace">&nbsp;</span>Files</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Filesystem.html#%28part._directories%29" class="toclink" data-pltdoc="x">15.2.3<span class="hspace">&nbsp;</span>Directories</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Filesystem.html#%28part._filesystem-change%29" class="toclink" data-pltdoc="x">15.2.4<span class="hspace">&nbsp;</span>Detecting Filesystem Changes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Filesystem.html#%28part._runtime-path%29" class="toclink" data-pltdoc="x">15.2.5<span class="hspace">&nbsp;</span>Declaring Paths Needed at Run Time</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Filesystem.html#%28part._file-lib%29" class="toclink" data-pltdoc="x">15.2.6<span class="hspace">&nbsp;</span>More File and Directory Utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="networking.html" class="toclink" data-pltdoc="x">15.3<span class="hspace">&nbsp;</span>Networking</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="tcp.html" class="toclink" data-pltdoc="x">15.3.1<span class="hspace">&nbsp;</span>TCP</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="udp.html" class="toclink" data-pltdoc="x">15.3.2<span class="hspace">&nbsp;</span>UDP</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="subprocess.html" class="toclink" data-pltdoc="x">15.4<span class="hspace">&nbsp;</span>Processes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="subprocess.html#%28part._.Simple_.Subprocesses%29" class="toclink" data-pltdoc="x">15.4.1<span class="hspace">&nbsp;</span>Simple Subprocesses</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="logging.html" class="toclink" data-pltdoc="x">15.5<span class="hspace">&nbsp;</span>Logging</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="logging.html#%28part._.Creating_.Loggers%29" class="toclink" data-pltdoc="x">15.5.1<span class="hspace">&nbsp;</span>Creating Loggers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="logging.html#%28part._.Logging_.Events%29" class="toclink" data-pltdoc="x">15.5.2<span class="hspace">&nbsp;</span>Logging Events</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="logging.html#%28part._receiving-logged-events%29" class="toclink" data-pltdoc="x">15.5.3<span class="hspace">&nbsp;</span>Receiving Logged Events</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="logging.html#%28part._.Additional_.Logging_.Functions%29" class="toclink" data-pltdoc="x">15.5.4<span class="hspace">&nbsp;</span>Additional Logging Functions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="time.html" class="toclink" data-pltdoc="x">15.6<span class="hspace">&nbsp;</span>Time</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="time.html#%28part._date-string%29" class="toclink" data-pltdoc="x">15.6.1<span class="hspace">&nbsp;</span>Date Utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="envvars.html" class="toclink" data-pltdoc="x">15.7<span class="hspace">&nbsp;</span>Environment Variables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="runtime.html" class="toclink" data-pltdoc="x">15.8<span class="hspace">&nbsp;</span>Environment and Runtime Information</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Command-Line_Parsing.html" class="toclink" data-pltdoc="x">15.9<span class="hspace">&nbsp;</span>Command-Line Parsing</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="os-lib.html" class="toclink" data-pltdoc="x">15.10<span class="hspace">&nbsp;</span>Additional Operating System Functions</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="linklets.html" title="backward to &quot;14.14 Linklets and the Core Compiler&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="pathutils.html" title="forward to &quot;15.1 Paths&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/pairs.html b/clones/docs.racket-lang.org/reference/pairs.html
new file mode 100644
index 00000000..b033d171
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/pairs.html
@@ -0,0 +1,243 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.10&nbsp;Pairs and Lists</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewselflink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.10&nbsp;</td><td><a href="pairs.html" class="tocviewselflink" data-pltdoc="x">Pairs and Lists</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.10.1&nbsp;</td><td><a href="pairs.html#%28part._.Pair_.Constructors_and_.Selectors%29" class="tocviewlink" data-pltdoc="x">Pair Constructors and Selectors</a></td></tr><tr><td align="right">4.10.2&nbsp;</td><td><a href="pairs.html#%28part._.List_.Operations%29" class="tocviewlink" data-pltdoc="x">List Operations</a></td></tr><tr><td align="right">4.10.3&nbsp;</td><td><a href="pairs.html#%28part._.List_.Iteration%29" class="tocviewlink" data-pltdoc="x">List Iteration</a></td></tr><tr><td align="right">4.10.4&nbsp;</td><td><a href="pairs.html#%28part._.List_.Filtering%29" class="tocviewlink" data-pltdoc="x">List Filtering</a></td></tr><tr><td align="right">4.10.5&nbsp;</td><td><a href="pairs.html#%28part._.List_.Searching%29" class="tocviewlink" data-pltdoc="x">List Searching</a></td></tr><tr><td align="right">4.10.6&nbsp;</td><td><a href="pairs.html#%28part._.Pair_.Accessor_.Shorthands%29" class="tocviewlink" data-pltdoc="x">Pair Accessor Shorthands</a></td></tr><tr><td align="right">4.10.7&nbsp;</td><td><a href="pairs.html#%28part._.Additional_.List_.Functions_and_.Synonyms%29" class="tocviewlink" data-pltdoc="x">Additional List Functions and Synonyms</a></td></tr><tr><td align="right">4.10.8&nbsp;</td><td><a href="pairs.html#%28part._.Immutable_.Cyclic_.Data%29" class="tocviewlink" data-pltdoc="x">Immutable Cyclic Data</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">4.10.1<tt>&nbsp;</tt></span><a href="pairs.html#%28part._.Pair_.Constructors_and_.Selectors%29" class="tocsubseclink" data-pltdoc="x">Pair Constructors and Selectors</a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pair?</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">null?</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cons</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">car</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cdr</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">null</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list?</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list*</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._build-list%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">build-<wbr></wbr>list</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.10.2<tt>&nbsp;</tt></span><a href="pairs.html#%28part._.List_.Operations%29" class="tocsubseclink" data-pltdoc="x">List Operations</a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">length</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list-tail%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-<wbr></wbr>tail</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._append%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">append</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._reverse%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">reverse</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.10.3<tt>&nbsp;</tt></span><a href="pairs.html#%28part._.List_.Iteration%29" class="tocsubseclink" data-pltdoc="x">List Iteration</a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">map</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._andmap%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">andmap</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._ormap%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">ormap</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._for-each%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">for-<wbr></wbr>each</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldl%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">foldl</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">foldr</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.10.4<tt>&nbsp;</tt></span><a href="pairs.html#%28part._.List_.Filtering%29" class="tocsubseclink" data-pltdoc="x">List Filtering</a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._filter%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">filter</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remove%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remove</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remq</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remv</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remw</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remove%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remove*</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remq%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remq*</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remv%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remv*</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remw%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remw*</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._sort%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sort</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.10.5<tt>&nbsp;</tt></span><a href="pairs.html#%28part._.List_.Searching%29" class="tocsubseclink" data-pltdoc="x">List Searching</a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">member</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._memw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">memw</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._memv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">memv</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._memq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">memq</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._memf%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">memf</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._findf%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">findf</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assoc%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">assoc</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">assw</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">assv</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">assq</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assf%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">assf</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.10.6<tt>&nbsp;</tt></span><a href="pairs.html#%28part._.Pair_.Accessor_.Shorthands%29" class="tocsubseclink" data-pltdoc="x">Pair Accessor Shorthands</a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caar%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">caar</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cadr</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdar%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cdar</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cddr</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caaar%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">caaar</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caadr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">caadr</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadar%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cadar</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caddr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">caddr</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdaar%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cdaar</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdadr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cdadr</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddar%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cddar</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdddr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cdddr</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caaaar%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">caaaar</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caaadr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">caaadr</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caadar%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">caadar</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caaddr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">caaddr</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadaar%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cadaar</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadadr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cadadr</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caddar%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">caddar</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadddr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cadddr</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdaaar%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cdaaar</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdaadr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cdaadr</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdadar%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cdadar</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdaddr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cdaddr</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddaar%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cddaar</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddadr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cddadr</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdddar%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cdddar</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddddr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cddddr</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.10.7<tt>&nbsp;</tt></span><a href="pairs.html#%28part._.Additional_.List_.Functions_and_.Synonyms%29" class="tocsubseclink" data-pltdoc="x">Additional List Functions and Synonyms</a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._empty%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">empty</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._cons~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cons?</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._empty~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">empty?</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._first%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">first</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">rest</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._second%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">second</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._third%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">third</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._fourth%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fourth</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._fifth%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">fifth</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._sixth%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sixth</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._seventh%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">seventh</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._eighth%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eighth</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._ninth%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">ninth</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._tenth%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tenth</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._last%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">last</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._last-pair%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">last-<wbr></wbr>pair</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._make-list%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>list</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._list-update%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-<wbr></wbr>update</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._list-set%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-<wbr></wbr>set</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._index-of%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">index-<wbr></wbr>of</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._index-where%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">index-<wbr></wbr>where</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._indexes-of%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">indexes-<wbr></wbr>of</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._indexes-where%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">indexes-<wbr></wbr>where</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._take%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">take</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._drop%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">drop</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._split-at%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">split-<wbr></wbr>at</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._takef%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">takef</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._dropf%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dropf</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._splitf-at%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">splitf-<wbr></wbr>at</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._take-right%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">take-<wbr></wbr>right</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._drop-right%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">drop-<wbr></wbr>right</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._split-at-right%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">split-<wbr></wbr>at-<wbr></wbr>right</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._takef-right%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">takef-<wbr></wbr>right</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._dropf-right%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dropf-<wbr></wbr>right</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._splitf-at-right%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">splitf-<wbr></wbr>at-<wbr></wbr>right</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._list-prefix~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-<wbr></wbr>prefix?</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._take-common-prefix%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">take-<wbr></wbr>common-<wbr></wbr>prefix</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._drop-common-prefix%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">drop-<wbr></wbr>common-<wbr></wbr>prefix</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._split-common-prefix%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">split-<wbr></wbr>common-<wbr></wbr>prefix</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._add-between%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">add-<wbr></wbr>between</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._append%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">append*</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._flatten%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flatten</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._check-duplicates%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">check-<wbr></wbr>duplicates</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._remove-duplicates%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remove-<wbr></wbr>duplicates</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._filter-map%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">filter-<wbr></wbr>map</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._count%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">count</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._partition%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">partition</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._range%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">range</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._inclusive-range%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">inclusive-<wbr></wbr>range</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._append-map%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">append-<wbr></wbr>map</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._filter-not%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">filter-<wbr></wbr>not</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._shuffle%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">shuffle</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._combinations%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">combinations</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._in-combinations%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>combinations</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._permutations%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">permutations</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._in-permutations%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>permutations</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._argmin%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">argmin</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._argmax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">argmax</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._group-by%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">group-<wbr></wbr>by</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._cartesian-product%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">cartesian-<wbr></wbr>product</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._remf%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remf</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._remf%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">remf*</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.10.8<tt>&nbsp;</tt></span><a href="pairs.html#%28part._.Immutable_.Cyclic_.Data%29" class="tocsubseclink" data-pltdoc="x">Immutable Cyclic Data</a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-reader-graph%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>reader-<wbr></wbr>graph</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._placeholder~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">placeholder?</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-placeholder%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>placeholder</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._placeholder-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">placeholder-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._placeholder-get%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">placeholder-<wbr></wbr>get</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._hash-placeholder~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">hash-<wbr></wbr>placeholder?</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-hash-placeholder%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>hash-<wbr></wbr>placeholder</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-hasheq-placeholder%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>hasheq-<wbr></wbr>placeholder</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-hasheqv-placeholder%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>hasheqv-<wbr></wbr>placeholder</span></span></a></td></tr><tr><td><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-hashalw-placeholder%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>hashalw-<wbr></wbr>placeholder</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="keywords.html" title="backward to &quot;4.9 Keywords&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="mpairs.html" title="forward to &quot;4.11 Mutable Pairs and Lists&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;pairs&quot;">4.10<tt>&nbsp;</tt><a name="(part._pairs)"></a>Pairs and Lists</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=pairs.html&amp;version=8.6" class="Sq" data-pltdoc="x">Pairs and Lists</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces pairs and lists.</p></blockquote></blockquote></blockquote><p>A <a name="(tech._pair)"></a><span style="font-style: italic">pair</span> combines exactly two values. The first value is
+accessed with the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> procedure, and the second value is
+accessed with the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> procedure. Pairs are not mutable (but
+see <a href="mpairs.html" data-pltdoc="x">Mutable Pairs and Lists</a>).</p><p>A <a name="(tech._list)"></a><span style="font-style: italic">list</span> is recursively defined: it is either the constant
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span>, or it is a pair whose second value is a list.</p><p>A list can be used as a single-valued sequence (see
+<a href="sequences.html" data-pltdoc="x">Sequences</a>). The elements of the list serve as elements
+of the sequence. See also <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="RktValLink" data-pltdoc="x">in-list</a></span>.</p><p>Cyclic data structures can be created using only immutable pairs via
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> or <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-reader-graph%29%29" class="RktValLink" data-pltdoc="x">make-reader-graph</a></span>. If starting with a pair
+and using some number of <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span>s returns to the starting pair,
+then the pair is not a list.</p><p>See <a href="reader.html#%28part._parse-pair%29" data-pltdoc="x">Reading Pairs and Lists</a>
+    for information on <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>ing
+    pairs and lists and <a href="printing.html#%28part._print-pairs%29" data-pltdoc="x">Printing Pairs and Lists</a>
+    for information on <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>ing pairs and lists.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Pair_Constructors_and_Selectors&quot;">4.10.1<tt>&nbsp;</tt><a name="(part._.Pair_.Constructors_and_.Selectors)"></a>Pair Constructors and Selectors</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._pair~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">pair?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a pair, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._null~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">null?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is the empty list, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null~3f%29%29" class="RktValLink" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null~3f%29%29" class="RktValLink" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null~3f%29%29" class="RktValLink" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null~3f%29%29" class="RktValLink" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cons))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValDef RktValLink" data-pltdoc="x">cons</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">d</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">d</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a newly allocated pair whose first element is <span class="RktVar">a</span> and
+second element is <span class="RktVar">d</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 . 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._car))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValDef RktValLink" data-pltdoc="x">car</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the first element of the pair <span class="RktVar">p</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cdr))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValDef RktValLink" data-pltdoc="x">cdr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the second element of the pair <span class="RktVar">p</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._null))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValDef RktValLink" data-pltdoc="x">null</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null~3f%29%29" class="RktValLink" data-pltdoc="x">null?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">The empty list.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._list~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">list?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a list: either the empty list, or a
+pair whose second element is a list.  This procedure effectively takes
+constant time due to internal caching (so that any necessary traversals
+of pairs can in principle count as an extra cost of allocating the
+pairs).</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._list))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValDef RktValLink" data-pltdoc="x">list</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a newly allocated list containing the <span class="RktVar">v</span>s as its
+elements.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((1 2) (3 4))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._list*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">list*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">tail</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">tail</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span>, but the last argument is used as the tail of the
+result, instead of the final element.  The result is a list only if the
+last argument is a list.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%2A%29%29" class="RktValLink" data-pltdoc="x">list*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 . 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%2A%29%29" class="RktValLink" data-pltdoc="x">list*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3 4)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._build-list))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._build-list%29%29" class="RktValDef RktValLink" data-pltdoc="x">build-list</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a list of <span class="RktVar">n</span> elements by applying <span class="RktVar">proc</span> to the
+integers from <span class="RktVal">0</span> to <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="stt"> </span><span class="RktVar">n</span><span class="RktPn">)</span> in order.  If
+<span class="RktVar">lst</span> is the resulting list, then <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list-ref%29%29" class="RktValLink" data-pltdoc="x">list-ref</a></span><span class="stt"> </span><span class="RktVar">lst</span><span class="stt"> </span><span class="RktVar">i</span><span class="RktPn">)</span> is
+the value produced by <span class="RktPn">(</span><span class="RktVar">proc</span><span class="stt"> </span><span class="RktVar">i</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._build-list%29%29" class="RktValLink" data-pltdoc="x">build-list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(0 1 2 3 4 5 6 7 8 9)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._build-list%29%29" class="RktValLink" data-pltdoc="x">build-list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(0 1 4 9 16)</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;List_Operations&quot;">4.10.2<tt>&nbsp;</tt><a name="(part._.List_.Operations)"></a>List Operations</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._length))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._length%29%29" class="RktValDef RktValLink" data-pltdoc="x">length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the number of elements in <span class="RktVar">lst</span>. This function takes
+time proportional to that length.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._length%29%29" class="RktValLink" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._length%29%29" class="RktValLink" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._list-ref))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">list-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the element of <span class="RktVar">lst</span> at position <span class="RktVar">pos</span>, where the
+list&rsquo;s first element is position <span class="RktVal">0</span>.  If the list has
+<span class="RktVar">pos</span> or fewer elements, then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p>The <span class="RktVar">lst</span> argument need not actually be a list; <span class="RktVar">lst</span> must
+merely start with a chain of at least <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="stt"> </span><span class="RktVar">pos</span><span class="RktPn">)</span> pairs.</p><p>This function takes time proportional to <span class="RktVar">pos</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list-ref%29%29" class="RktValLink" data-pltdoc="x">list-ref</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'a</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list-ref%29%29" class="RktValLink" data-pltdoc="x">list-ref</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'b</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list-ref%29%29" class="RktValLink" data-pltdoc="x">list-ref</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'c</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list-ref%29%29" class="RktValLink" data-pltdoc="x">list-ref</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list-ref%29%29" class="RktValLink" data-pltdoc="x">list-ref</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">list-ref: index reaches a non-pair</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">index: 1</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: '(1 . 2)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._list-tail))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list-tail%29%29" class="RktValDef RktValLink" data-pltdoc="x">list-tail</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the list after the first <span class="RktVar">pos</span> elements of <span class="RktVar">lst</span>.
+If the list has fewer than <span class="RktVar">pos</span> elements, then the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p>The <span class="RktVar">lst</span> argument need not actually be a list; <span class="RktVar">lst</span>
+must merely start with a chain of at least <span class="RktVar">pos</span> pairs.</p><p>This function takes time proportional to <span class="RktVar">pos</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list-tail%29%29" class="RktValLink" data-pltdoc="x">list-tail</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(3 4 5)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list-tail%29%29" class="RktValLink" data-pltdoc="x">list-tail</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list-tail%29%29" class="RktValLink" data-pltdoc="x">list-tail</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">list-tail: index reaches a non-pair</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">index: 2</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: '(1 . 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list-tail%29%29" class="RktValLink" data-pltdoc="x">list-tail</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">not-a-pair</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'not-a-pair</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._append))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._append%29%29" class="RktValDef RktValLink" data-pltdoc="x">append</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._append%29%29" class="RktValDef RktValLink" data-pltdoc="x">append</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">When given all list arguments, the result is a list that contains all of
+the elements of the given lists in order.  The last argument is used
+directly in the tail of the result.</div></p><p>The last argument need not be a list, in which case the result is an
+&ldquo;improper list.&rdquo;</p><p>This function takes time proportional to the length of all arguments
+(added together) except the last argument.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._append%29%29" class="RktValLink" data-pltdoc="x">append</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._append%29%29" class="RktValLink" data-pltdoc="x">append</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3 4 5 6 7 8)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._reverse))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._reverse%29%29" class="RktValDef RktValLink" data-pltdoc="x">reverse</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list that has the same elements as <span class="RktVar">lst</span>, but in
+reverse order.</div></p><p>This function takes time proportional to the length of <span class="RktVar">lst</span>.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._reverse%29%29" class="RktValLink" data-pltdoc="x">reverse</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(4 3 2 1)</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;List_Iteration&quot;">4.10.3<tt>&nbsp;</tt><a name="(part._.List_.Iteration)"></a>List Iteration</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/map..rkt)._map))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValDef RktValLink" data-pltdoc="x">map</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Applies <span class="RktVar">proc</span> to the elements of the <span class="RktVar">lst</span>s from the
+first elements to the last.  The <span class="RktVar">proc</span> argument must accept the
+same number of arguments as the number of supplied <span class="RktVar">lst</span>s, and
+all <span class="RktVar">lst</span>s must have the same number of elements.  The result is
+a list containing each result of <span class="RktVar">proc</span> in order.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">number</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">number</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(2 3 4 5)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">number1</span><span class="hspace">&nbsp;</span><span class="RktSym">number2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">number1</span><span class="hspace">&nbsp;</span><span class="RktSym">number2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="hspace">&nbsp;</span><span class="RktVal">1000</span><span class="hspace">&nbsp;</span><span class="RktVal">10000</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(11 102 1003 10004)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/map..rkt)._andmap))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._andmap%29%29" class="RktValDef RktValLink" data-pltdoc="x">andmap</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span> in the sense that <span class="RktVar">proc</span> is applied to
+each element of <span class="RktVar">lst</span>, but</div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._andmap%29%29" class="RktValLink" data-pltdoc="x">andmap</a></span> function is actually closer to
+<span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldl%29%29" class="RktValLink" data-pltdoc="x">foldl</a></span> than <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span>, since <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._andmap%29%29" class="RktValLink" data-pltdoc="x">andmap</a></span> doesn&rsquo;t
+produce a list.  Still, <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._andmap%29%29" class="RktValLink" data-pltdoc="x">andmap</a></span><span class="stt"> </span><span class="RktSym">f</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktSym">x</span><span class="stt"> </span><span class="RktSym">y</span><span class="stt"> </span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktPn">)</span> is equivalent
+to <span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="stt"> </span><span class="RktSym">x</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="stt"> </span><span class="RktSym">y</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="stt"> </span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktPn">)</span> in the same way that
+<span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="stt"> </span><span class="RktSym">f</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktSym">x</span><span class="stt"> </span><span class="RktSym">y</span><span class="stt"> </span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktPn">)</span> is equivalent to
+<span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="stt"> </span><span class="RktSym">x</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="stt"> </span><span class="RktSym">y</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="stt"> </span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktPn">)</span>.</p></blockquote></blockquote></blockquote><ul><li><p>the result is <span class="RktVal">#f</span> if any application of <span class="RktVar">proc</span>
+produces <span class="RktVal">#f</span>, in which case <span class="RktVar">proc</span> is not applied
+to later elements of the <span class="RktVar">lst</span>s; and</p></li><li><p>the result is that of <span class="RktVar">proc</span> applied to the last elements
+of the <span class="RktVar">lst</span>s; more specifically, the application of
+<span class="RktVar">proc</span> to the last elements in the <span class="RktVar">lst</span>s is in tail
+position with respect to the <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._andmap%29%29" class="RktValLink" data-pltdoc="x">andmap</a></span> call.</p></li></ul><p>If the <span class="RktVar">lst</span>s are empty, then <span class="RktVal">#t</span> is returned.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._andmap%29%29" class="RktValLink" data-pltdoc="x">andmap</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._andmap%29%29" class="RktValLink" data-pltdoc="x">andmap</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">a</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">positive?: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: real?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 'a</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._andmap%29%29" class="RktValLink" data-pltdoc="x">andmap</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-2</span></span><span class="hspace">&nbsp;</span><span class="RktVal">a</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._andmap%29%29" class="RktValLink" data-pltdoc="x">andmap</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">9</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/map..rkt)._ormap))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._ormap%29%29" class="RktValDef RktValLink" data-pltdoc="x">ormap</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span> in the sense that <span class="RktVar">proc</span> is applied to
+each element of <span class="RktVar">lst</span>, but</div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>To continue the <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._andmap%29%29" class="RktValLink" data-pltdoc="x">andmap</a></span> note above,
+<span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._ormap%29%29" class="RktValLink" data-pltdoc="x">ormap</a></span><span class="stt"> </span><span class="RktSym">f</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktSym">x</span><span class="stt"> </span><span class="RktSym">y</span><span class="stt"> </span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktPn">)</span> is equivalent to
+<span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="stt"> </span><span class="RktSym">x</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="stt"> </span><span class="RktSym">y</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="stt"> </span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktPn">)</span>.</p></blockquote></blockquote></blockquote><ul><li><p>the result is <span class="RktVal">#f</span> if every application of <span class="RktVar">proc</span>
+produces <span class="RktVal">#f</span>; and</p></li><li><p>the result is that of the first application of <span class="RktVar">proc</span>
+producing a value other than <span class="RktVal">#f</span>, in which case
+<span class="RktVar">proc</span> is not applied to later elements of the
+<span class="RktVar">lst</span>s; the application of <span class="RktVar">proc</span> to the last
+elements of the <span class="RktVar">lst</span>s is in tail position with respect to
+the <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._ormap%29%29" class="RktValLink" data-pltdoc="x">ormap</a></span> call.</p></li></ul><p>If the <span class="RktVar">lst</span>s are empty, then <span class="RktVal">#f</span> is returned.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._ormap%29%29" class="RktValLink" data-pltdoc="x">ormap</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">c</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">c</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._ormap%29%29" class="RktValLink" data-pltdoc="x">ormap</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">a</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._ormap%29%29" class="RktValLink" data-pltdoc="x">ormap</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/map..rkt)._for-each))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._for-each%29%29" class="RktValDef RktValLink" data-pltdoc="x">for-each</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span>, but <span class="RktVar">proc</span> is called only for its
+effect, and its result (which can be any number of values) is ignored.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._for-each%29%29" class="RktValLink" data-pltdoc="x">for-each</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">arg</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Got ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">arg</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">23</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">Got 1</span></p></td></tr><tr><td><p><span class="RktOut">Got 2</span></p></td></tr><tr><td><p><span class="RktOut">Got 3</span></p></td></tr><tr><td><p><span class="RktOut">Got 4</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._foldl))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldl%29%29" class="RktValDef RktValLink" data-pltdoc="x">foldl</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">init</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">init</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span>, <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldl%29%29" class="RktValLink" data-pltdoc="x">foldl</a></span> applies a procedure to the elements of
+one or more lists.  Whereas <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span> combines the return values into
+a list, <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldl%29%29" class="RktValLink" data-pltdoc="x">foldl</a></span> combines the return values in an arbitrary way
+that is determined by <span class="RktVar">proc</span>.</div></p><p>If <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldl%29%29" class="RktValLink" data-pltdoc="x">foldl</a></span> is called with <span style="font-style: italic">n</span> lists, then <span class="RktVar">proc</span> must
+take <span style="font-style: italic">n+</span>1<span style="font-style: italic"></span> arguments.  The extra argument is the combined return
+values so far.  The <span class="RktVar">proc</span> is initially invoked with the first
+item of each list, and the final argument is <span class="RktVar">init</span>.  In
+subsequent invocations of <span class="RktVar">proc</span>, the last argument is the return
+value from the previous invocation of <span class="RktVar">proc</span>.  The input
+<span class="RktVar">lst</span>s are traversed from left to right, and the result of the
+whole <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldl%29%29" class="RktValLink" data-pltdoc="x">foldl</a></span> application is the result of the last application
+of <span class="RktVar">proc</span>.  If the <span class="RktVar">lst</span>s are empty, the result is
+<span class="RktVar">init</span>.</p><p>Unlike <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldr%29%29" class="RktValLink" data-pltdoc="x">foldr</a></span>, <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldl%29%29" class="RktValLink" data-pltdoc="x">foldl</a></span> processes the <span class="RktVar">lst</span>s in
+constant space (plus the space for each call to <span class="RktVar">proc</span>).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldl%29%29" class="RktValLink" data-pltdoc="x">foldl</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(4 3 2 1)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldl%29%29" class="RktValLink" data-pltdoc="x">foldl</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldl%29%29" class="RktValLink" data-pltdoc="x">foldl</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">result</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">-27</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._foldr))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldr%29%29" class="RktValDef RktValLink" data-pltdoc="x">foldr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">init</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">init</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldl%29%29" class="RktValLink" data-pltdoc="x">foldl</a></span>, but the lists are traversed from right to left.
+Unlike <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldl%29%29" class="RktValLink" data-pltdoc="x">foldl</a></span>, <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldr%29%29" class="RktValLink" data-pltdoc="x">foldr</a></span> processes the <span class="RktVar">lst</span>s in
+space proportional to the length of <span class="RktVar">lst</span>s (plus the space for
+each call to <span class="RktVar">proc</span>).</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldr%29%29" class="RktValLink" data-pltdoc="x">foldr</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldr%29%29" class="RktValLink" data-pltdoc="x">foldr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(2 3 4 5)</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;List_Filtering&quot;">4.10.4<tt>&nbsp;</tt><a name="(part._.List_.Filtering)"></a>List Filtering</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._filter))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._filter%29%29" class="RktValDef RktValLink" data-pltdoc="x">filter</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list with the elements of <span class="RktVar">lst</span> for which <span class="RktVar">pred</span>
+produces a true value.  The <span class="RktVar">pred</span> procedure is applied to each
+element from first to last.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._filter%29%29" class="RktValLink" data-pltdoc="x">filter</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-2</span></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-5</span></span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 3 4)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._remove))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remove%29%29" class="RktValDef RktValLink" data-pltdoc="x">remove</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">proc</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list that is like <span class="RktVar">lst</span>, omitting the first element of
+<span class="RktVar">lst</span> that is equal to <span class="RktVar">v</span> using the comparison procedure
+<span class="RktVar">proc</span> (which must accept two arguments),
+with <span class="RktVar">v</span> as the first argument and an element in <span class="RktVar">lst</span> as the second argument.
+If no element in <span class="RktVar">lst</span> is equal to <span class="RktVar">v</span> (according to <span class="RktVar">proc</span>),
+<span class="RktVar">lst</span> is returned unchanged.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remove%29%29" class="RktValLink" data-pltdoc="x">remove</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 3 2 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remove%29%29" class="RktValLink" data-pltdoc="x">remove</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((1) (3))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remove%29%29" class="RktValLink" data-pltdoc="x">remove</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"2"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"1"</span><span class="hspace">&nbsp;</span><span class="RktVal">"2"</span><span class="hspace">&nbsp;</span><span class="RktVal">"3"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("1" "3")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remove%29%29" class="RktValLink" data-pltdoc="x">remove</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\b</span><span class="hspace">&nbsp;</span><span class="RktVal">#\c</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#\a #\b)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remove%29%29" class="RktValLink" data-pltdoc="x">remove</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"B"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"A"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"B"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string-ci=?</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("a" "A" "B")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remove%29%29" class="RktValLink" data-pltdoc="x">remove</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3 2 4)</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 8.2.0.2 of package <span class="stt">base</span>: Guaranteed that the output is <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to <span class="RktVar">lst</span>
+if no removal occurs.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._remq))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remq%29%29" class="RktValDef RktValLink" data-pltdoc="x">remq</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remove%29%29" class="RktValLink" data-pltdoc="x">remove</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="stt"> </span><span class="RktVar">lst</span><span class="stt"> </span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remq%29%29" class="RktValLink" data-pltdoc="x">remq</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 3 4 5)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remq%29%29" class="RktValLink" data-pltdoc="x">remq</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((1) (2) (3))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remq%29%29" class="RktValLink" data-pltdoc="x">remq</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"2"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"1"</span><span class="hspace">&nbsp;</span><span class="RktVal">"2"</span><span class="hspace">&nbsp;</span><span class="RktVal">"3"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("1" "3")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remq%29%29" class="RktValLink" data-pltdoc="x">remq</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\b</span><span class="hspace">&nbsp;</span><span class="RktVal">#\c</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#\a #\b)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._remv))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remv%29%29" class="RktValDef RktValLink" data-pltdoc="x">remv</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remove%29%29" class="RktValLink" data-pltdoc="x">remove</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="stt"> </span><span class="RktVar">lst</span><span class="stt"> </span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remv%29%29" class="RktValLink" data-pltdoc="x">remv</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 3 4 5)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remv%29%29" class="RktValLink" data-pltdoc="x">remv</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((1) (2) (3))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remv%29%29" class="RktValLink" data-pltdoc="x">remv</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"2"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"1"</span><span class="hspace">&nbsp;</span><span class="RktVal">"2"</span><span class="hspace">&nbsp;</span><span class="RktVal">"3"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("1" "3")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remv%29%29" class="RktValLink" data-pltdoc="x">remv</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\b</span><span class="hspace">&nbsp;</span><span class="RktVal">#\c</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#\a #\b)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._remw))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remw%29%29" class="RktValDef RktValLink" data-pltdoc="x">remw</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remove%29%29" class="RktValLink" data-pltdoc="x">remove</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="stt"> </span><span class="RktVar">lst</span><span class="stt"> </span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remw%29%29" class="RktValLink" data-pltdoc="x">remw</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 3 4 5)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remw%29%29" class="RktValLink" data-pltdoc="x">remw</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((1) (3))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remw%29%29" class="RktValLink" data-pltdoc="x">remw</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"2"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"1"</span><span class="hspace">&nbsp;</span><span class="RktVal">"2"</span><span class="hspace">&nbsp;</span><span class="RktVal">"3"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("1" "3")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remw%29%29" class="RktValLink" data-pltdoc="x">remw</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\b</span><span class="hspace">&nbsp;</span><span class="RktVal">#\c</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#\a #\b)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValLink" data-pltdoc="x">box</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValLink" data-pltdoc="x">box</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remw%29%29" class="RktValLink" data-pltdoc="x">remw</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">b1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">b2</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(0 #&amp;5 1 2)</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 8.5.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._remove*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remove%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">remove*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v-lst</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">proc</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v-lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remove%29%29" class="RktValLink" data-pltdoc="x">remove</a></span>, but removes from <span class="RktVar">lst</span> every instance of
+every element of <span class="RktVar">v-lst</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remove%2A%29%29" class="RktValLink" data-pltdoc="x">remove*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(3 4 5)</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 8.2.0.2 of package <span class="stt">base</span>: Guaranteed that the output is <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to <span class="RktVar">lst</span>
+if no removal occurs.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._remq*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remq%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">remq*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v-lst</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v-lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remove%2A%29%29" class="RktValLink" data-pltdoc="x">remove*</a></span><span class="stt"> </span><span class="RktVar">v-lst</span><span class="stt"> </span><span class="RktVar">lst</span><span class="stt"> </span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remq%2A%29%29" class="RktValLink" data-pltdoc="x">remq*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(3 4 5)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._remv*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remv%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">remv*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v-lst</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v-lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remove%2A%29%29" class="RktValLink" data-pltdoc="x">remove*</a></span><span class="stt"> </span><span class="RktVar">v-lst</span><span class="stt"> </span><span class="RktVar">lst</span><span class="stt"> </span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remv%2A%29%29" class="RktValLink" data-pltdoc="x">remv*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(3 4 5)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._remw*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remw%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">remw*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v-lst</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v-lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remove%2A%29%29" class="RktValLink" data-pltdoc="x">remove*</a></span><span class="stt"> </span><span class="RktVar">v-lst</span><span class="stt"> </span><span class="RktVar">lst</span><span class="stt"> </span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remw%2A%29%29" class="RktValLink" data-pltdoc="x">remw*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(3 4 5)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValLink" data-pltdoc="x">box</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValLink" data-pltdoc="x">box</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._remw%2A%29%29" class="RktValLink" data-pltdoc="x">remw*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">b1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">b2</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym">b2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(0 #&amp;5 1 2 3)</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 8.5.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._sort))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._sort%29%29" class="RktValDef RktValLink" data-pltdoc="x">sort</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">lst</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">less-than?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:key</span><span class="hspace">&nbsp;</span><span class="RktVar">extract-key</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:cache-keys?</span><span class="hspace">&nbsp;</span><span class="RktVar">cache-keys?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">less-than?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">extract-key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cache-keys?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list sorted according to the <span class="RktVar">less-than?</span> procedure,
+which takes two elements of <span class="RktVar">lst</span> and returns a true value if the
+first is less (i.e., should be sorted earlier) than the second.</div></p><p>The sort is stable; if two elements of <span class="RktVar">lst</span> are &ldquo;equal&rdquo;
+(i.e., <span class="RktVar">less-than?</span> does not return a true value when given the pair in
+either order), then the elements preserve their relative order from
+<span class="RktVar">lst</span> in the output list.  To preserve this guarantee, use
+<span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._sort%29%29" class="RktValLink" data-pltdoc="x">sort</a></span> with a strict comparison functions (e.g., <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span> or
+<span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3f%29%29" class="RktValLink" data-pltdoc="x">string&lt;?</a></span>; not <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c~3d%29%29" class="RktValLink" data-pltdoc="x">&lt;=</a></span> or <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string&lt;=?</a></span>).</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Because of the peculiar fact that the IEEE-754 number system
+specifies that +nan.0 is neither greater nor less than nor equal to any other
+number, sorting lists containing this value may produce a surprising result.</p></blockquote></blockquote></blockquote><p>The <span class="RktPn">#:key</span> argument <span class="RktVar">extract-key</span> is used to extract a
+key value for comparison from each list element.  That is, the full
+comparison procedure is essentially</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">less-than?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">extract-key</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">extract-key</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>By default, <span class="RktVar">extract-key</span> is applied to two list elements for
+every comparison, but if <span class="RktVar">cache-keys?</span> is true, then the
+<span class="RktVar">extract-key</span> function is used exactly once for each list item.
+Supply a true value for <span class="RktVar">cache-keys?</span> when <span class="RktVar">extract-key</span>
+is an expensive operation; for example, if
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-modify-seconds%29%29" class="RktValLink" data-pltdoc="x">file-or-directory-modify-seconds</a></span> is used to extract a timestamp
+for every file in a list, then <span class="RktVar">cache-keys?</span> should be
+<span class="RktVal">#t</span> to minimize file-system calls, but if <span class="RktVar">extract-key</span>
+is <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span>, then <span class="RktVar">cache-keys?</span>  should be <span class="RktVal">#f</span>.  As
+another example, providing <span class="RktVar">extract-key</span> as
+<span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._random%29%29" class="RktValLink" data-pltdoc="x">random</a></span><span class="RktPn">)</span><span class="RktPn">)</span> and <span class="RktVal">#t</span> for <span class="RktVar">cache-keys?</span>
+effectively shuffles the list.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._sort%29%29" class="RktValLink" data-pltdoc="x">sort</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._sort%29%29" class="RktValLink" data-pltdoc="x">sort</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"aardvark"</span><span class="hspace">&nbsp;</span><span class="RktVal">"dingo"</span><span class="hspace">&nbsp;</span><span class="RktVal">"cow"</span><span class="hspace">&nbsp;</span><span class="RktVal">"bear"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3f%29%29" class="RktValLink" data-pltdoc="x">string&lt;?</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("aardvark" "bear" "cow" "dingo")</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._sort%29%29" class="RktValLink" data-pltdoc="x">sort</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">"aardvark"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">"dingo"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">"cow"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">"bear"</span><span class="RktVal">)</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:key</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3f%29%29" class="RktValLink" data-pltdoc="x">string&lt;?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(("aardvark") ("bear") ("cow") ("dingo"))</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;List_Searching&quot;">4.10.5<tt>&nbsp;</tt><a name="(part._.List_.Searching)"></a>List Searching</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._member))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValDef RktValLink" data-pltdoc="x">member</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">is-equal?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">is-equal?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Locates the first element of <span class="RktVar">lst</span> that is <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to
+<span class="RktVar">v</span>.  If such an element exists, the tail of <span class="RktVar">lst</span>
+starting with that element is returned.  Otherwise, the result is
+<span class="RktVal">#f</span>.</div></p><p>The <span class="RktVar">lst</span> argument need not actually be a list; <span class="RktVar">lst</span>
+must merely start with a chain of pairs until a matching element is
+found. If no matching element is found, then <span class="RktVar">lst</span> must be a
+list (and not a cyclic list). The result can be a non-list in the case
+that an element is found and the returned tail of <span class="RktVar">lst</span> is a
+non-list.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(2 3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#&lt;syntax:eval:551:0 x&gt; #&lt;syntax:eval:551:0 y&gt;)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">etc</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(b . etc)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._memw))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._memw%29%29" class="RktValDef RktValLink" data-pltdoc="x">memw</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span>, but finds an element using <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._memw%29%29" class="RktValLink" data-pltdoc="x">memw</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(2 3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._memw%29%29" class="RktValLink" data-pltdoc="x">memw</a></span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValLink" data-pltdoc="x">box</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValLink" data-pltdoc="x">box</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._memw%29%29" class="RktValLink" data-pltdoc="x">memw</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">b1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">b2</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#&amp;5 2)</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 8.5.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._memv))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._memv%29%29" class="RktValDef RktValLink" data-pltdoc="x">memv</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span>, but finds an element using <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._memv%29%29" class="RktValLink" data-pltdoc="x">memv</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(2 3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._memv%29%29" class="RktValLink" data-pltdoc="x">memv</a></span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._memq))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._memq%29%29" class="RktValDef RktValLink" data-pltdoc="x">memq</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span>, but finds an element using <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._memq%29%29" class="RktValLink" data-pltdoc="x">memq</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(2 3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._memq%29%29" class="RktValLink" data-pltdoc="x">memq</a></span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._memf))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._memf%29%29" class="RktValDef RktValLink" data-pltdoc="x">memf</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span>, but finds an element using the predicate
+<span class="RktVar">proc</span>; an element is found when <span class="RktVar">proc</span> applied to the
+element returns a true value.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._memf%29%29" class="RktValLink" data-pltdoc="x">memf</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">arg</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e%29%29" class="RktValLink" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktSym">arg</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(10 11)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._findf))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._findf%29%29" class="RktValDef RktValLink" data-pltdoc="x">findf</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._memf%29%29" class="RktValLink" data-pltdoc="x">memf</a></span>, but returns the element or <span class="RktVal">#f</span> instead of a
+tail of <span class="RktVar">lst</span> or <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._findf%29%29" class="RktValLink" data-pltdoc="x">findf</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">arg</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e%29%29" class="RktValLink" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktSym">arg</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._assoc))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assoc%29%29" class="RktValDef RktValLink" data-pltdoc="x">assoc</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">is-equal?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">is-equal?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Locates the first element of <span class="RktVar">lst</span> whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is equal to
+<span class="RktVar">v</span> according to <span class="RktVar">is-equal?</span>.  If such an element exists,
+the pair (i.e., an element of <span class="RktVar">lst</span>) is returned.  Otherwise, the
+result is <span class="RktVal">#f</span>.</div></p><p>The <span class="RktVar">lst</span> argument need not actually be a list of pairs;
+<span class="RktVar">lst</span> must merely start with a chain of pairs contains pairs
+until a matching element is found. If no matching element is found,
+then <span class="RktVar">lst</span> must be a list of pairs (and not a cyclic list).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assoc%29%29" class="RktValLink" data-pltdoc="x">assoc</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assoc%29%29" class="RktValLink" data-pltdoc="x">assoc</a></span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assoc%29%29" class="RktValLink" data-pltdoc="x">assoc</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3.5</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._abs%29%29" class="RktValLink" data-pltdoc="x">abs</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(3 4)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._assw))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assw%29%29" class="RktValDef RktValLink" data-pltdoc="x">assw</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assoc%29%29" class="RktValLink" data-pltdoc="x">assoc</a></span>, but finds an element using <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assw%29%29" class="RktValLink" data-pltdoc="x">assw</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValLink" data-pltdoc="x">box</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValLink" data-pltdoc="x">box</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assw%29%29" class="RktValLink" data-pltdoc="x">assw</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b2</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#&amp;0 . 2)</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 8.5.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._assv))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assv%29%29" class="RktValDef RktValLink" data-pltdoc="x">assv</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assoc%29%29" class="RktValLink" data-pltdoc="x">assoc</a></span>, but finds an element using <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assv%29%29" class="RktValLink" data-pltdoc="x">assv</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(3 4)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._assq))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assq%29%29" class="RktValDef RktValLink" data-pltdoc="x">assq</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assoc%29%29" class="RktValLink" data-pltdoc="x">assoc</a></span>, but finds an element using <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assq%29%29" class="RktValLink" data-pltdoc="x">assq</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">d</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">e</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(c d)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._assf))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assf%29%29" class="RktValDef RktValLink" data-pltdoc="x">assf</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assoc%29%29" class="RktValLink" data-pltdoc="x">assoc</a></span>, but finds an element using the predicate
+<span class="RktVar">proc</span>; an element is found when <span class="RktVar">proc</span> applied to the
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> of an <span class="RktVar">lst</span> element returns a true value.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._assf%29%29" class="RktValLink" data-pltdoc="x">assf</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">arg</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e%29%29" class="RktValLink" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktSym">arg</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(3 4)</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Pair_Accessor_Shorthands&quot;">4.10.6<tt>&nbsp;</tt><a name="(part._.Pair_.Accessor_.Shorthands)"></a>Pair Accessor Shorthands</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._caar))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caar%29%29" class="RktValDef RktValLink" data-pltdoc="x">caar</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caar%29%29" class="RktValLink" data-pltdoc="x">caar</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cadr))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadr%29%29" class="RktValDef RktValLink" data-pltdoc="x">cadr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadr%29%29" class="RktValLink" data-pltdoc="x">cadr</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cdar))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdar%29%29" class="RktValDef RktValLink" data-pltdoc="x">cdar</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdar%29%29" class="RktValLink" data-pltdoc="x">cdar</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(6 5 4 3 2 1)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cddr))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddr%29%29" class="RktValDef RktValLink" data-pltdoc="x">cddr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddr%29%29" class="RktValLink" data-pltdoc="x">cddr</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._caaar))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caaar%29%29" class="RktValDef RktValLink" data-pltdoc="x">caaar</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caaar%29%29" class="RktValLink" data-pltdoc="x">caaar</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">6</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._caadr))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caadr%29%29" class="RktValDef RktValLink" data-pltdoc="x">caadr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caadr%29%29" class="RktValLink" data-pltdoc="x">caadr</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">7</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cadar))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadar%29%29" class="RktValDef RktValLink" data-pltdoc="x">cadar</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadar%29%29" class="RktValLink" data-pltdoc="x">cadar</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">6</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._caddr))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caddr%29%29" class="RktValDef RktValLink" data-pltdoc="x">caddr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caddr%29%29" class="RktValLink" data-pltdoc="x">caddr</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cdaar))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdaar%29%29" class="RktValDef RktValLink" data-pltdoc="x">cdaar</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdaar%29%29" class="RktValLink" data-pltdoc="x">cdaar</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(5 4 3 2 1)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cdadr))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdadr%29%29" class="RktValDef RktValLink" data-pltdoc="x">cdadr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdadr%29%29" class="RktValLink" data-pltdoc="x">cdadr</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(6 5 4 3 2 1)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cddar))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddar%29%29" class="RktValDef RktValLink" data-pltdoc="x">cddar</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddar%29%29" class="RktValLink" data-pltdoc="x">cddar</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(5 4 3 2 1)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cdddr))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdddr%29%29" class="RktValDef RktValLink" data-pltdoc="x">cdddr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdddr%29%29" class="RktValLink" data-pltdoc="x">cdddr</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._caaaar))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caaaar%29%29" class="RktValDef RktValLink" data-pltdoc="x">caaaar</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caaaar%29%29" class="RktValLink" data-pltdoc="x">caaaar</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._caaadr))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caaadr%29%29" class="RktValDef RktValLink" data-pltdoc="x">caaadr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caaadr%29%29" class="RktValLink" data-pltdoc="x">caaadr</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">6</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._caadar))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caadar%29%29" class="RktValDef RktValLink" data-pltdoc="x">caadar</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caadar%29%29" class="RktValLink" data-pltdoc="x">caadar</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._caaddr))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caaddr%29%29" class="RktValDef RktValLink" data-pltdoc="x">caaddr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caaddr%29%29" class="RktValLink" data-pltdoc="x">caaddr</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">6</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cadaar))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadaar%29%29" class="RktValDef RktValLink" data-pltdoc="x">cadaar</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadaar%29%29" class="RktValLink" data-pltdoc="x">cadaar</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cadadr))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadadr%29%29" class="RktValDef RktValLink" data-pltdoc="x">cadadr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadadr%29%29" class="RktValLink" data-pltdoc="x">cadadr</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">6</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._caddar))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caddar%29%29" class="RktValDef RktValLink" data-pltdoc="x">caddar</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caddar%29%29" class="RktValLink" data-pltdoc="x">caddar</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cadddr))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadddr%29%29" class="RktValDef RktValLink" data-pltdoc="x">cadddr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadddr%29%29" class="RktValLink" data-pltdoc="x">cadddr</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cdaaar))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdaaar%29%29" class="RktValDef RktValLink" data-pltdoc="x">cdaaar</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdaaar%29%29" class="RktValLink" data-pltdoc="x">cdaaar</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(4 3 2 1)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cdaadr))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdaadr%29%29" class="RktValDef RktValLink" data-pltdoc="x">cdaadr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdaadr%29%29" class="RktValLink" data-pltdoc="x">cdaadr</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(5 4 3 2 1)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cdadar))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdadar%29%29" class="RktValDef RktValLink" data-pltdoc="x">cdadar</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdadar%29%29" class="RktValLink" data-pltdoc="x">cdadar</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(4 3 2 1)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cdaddr))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdaddr%29%29" class="RktValDef RktValLink" data-pltdoc="x">cdaddr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdaddr%29%29" class="RktValLink" data-pltdoc="x">cdaddr</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(5 4 3 2 1)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cddaar))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddaar%29%29" class="RktValDef RktValLink" data-pltdoc="x">cddaar</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddaar%29%29" class="RktValLink" data-pltdoc="x">cddaar</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(4 3 2 1)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cddadr))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddadr%29%29" class="RktValDef RktValLink" data-pltdoc="x">cddadr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddadr%29%29" class="RktValLink" data-pltdoc="x">cddadr</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(5 4 3 2 1)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cdddar))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdddar%29%29" class="RktValDef RktValLink" data-pltdoc="x">cdddar</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdddar%29%29" class="RktValLink" data-pltdoc="x">cdddar</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(4 3 2 1)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._cddddr))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddddr%29%29" class="RktValDef RktValLink" data-pltdoc="x">cddddr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddddr%29%29" class="RktValLink" data-pltdoc="x">cddddr</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr></table></blockquote></div></p></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Additional_List_Functions_and_Synonyms&quot;">4.10.7<tt>&nbsp;</tt><a name="(part._.Additional_.List_.Functions_and_.Synonyms)"></a><a name="(mod-path._racket/list)"></a>Additional List Functions and Synonyms</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="pairs.html#%28mod-path._racket%2Flist%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/list</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="pairs.html#%28mod-path._racket%2Flist%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/list</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/list..rkt)._empty))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._empty%29%29" class="RktValDef RktValLink" data-pltdoc="x">empty</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null~3f%29%29" class="RktValLink" data-pltdoc="x">null?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">The empty list.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._empty%29%29" class="RktValLink" data-pltdoc="x">empty</a></span></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._empty%29%29" class="RktValLink" data-pltdoc="x">empty</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._cons~3f))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._cons~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">cons?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._cons~3f%29%29" class="RktValLink" data-pltdoc="x">cons?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._empty~3f))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._empty~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">empty?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null~3f%29%29" class="RktValLink" data-pltdoc="x">null?</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._empty~3f%29%29" class="RktValLink" data-pltdoc="x">empty?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._empty~3f%29%29" class="RktValLink" data-pltdoc="x">empty?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._first))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._first%29%29" class="RktValDef RktValLink" data-pltdoc="x">first</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="stt"> </span><span class="RktVar">lst</span><span class="RktPn">)</span>, but only for lists (that are not empty).</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._first%29%29" class="RktValLink" data-pltdoc="x">first</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._rest))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValDef RktValLink" data-pltdoc="x">rest</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="stt"> </span><span class="RktVar">lst</span><span class="RktPn">)</span>, but only for lists (that are not empty).</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(2 3 4 5 6 7 8 9 10)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._second))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._second%29%29" class="RktValDef RktValLink" data-pltdoc="x">second</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the second element of the list.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._second%29%29" class="RktValLink" data-pltdoc="x">second</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._third))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._third%29%29" class="RktValDef RktValLink" data-pltdoc="x">third</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the third element of the list.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._third%29%29" class="RktValLink" data-pltdoc="x">third</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._fourth))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._fourth%29%29" class="RktValDef RktValLink" data-pltdoc="x">fourth</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the fourth element of the list.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._fourth%29%29" class="RktValLink" data-pltdoc="x">fourth</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._fifth))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._fifth%29%29" class="RktValDef RktValLink" data-pltdoc="x">fifth</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the fifth element of the list.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._fifth%29%29" class="RktValLink" data-pltdoc="x">fifth</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._sixth))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._sixth%29%29" class="RktValDef RktValLink" data-pltdoc="x">sixth</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the sixth element of the list.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._sixth%29%29" class="RktValLink" data-pltdoc="x">sixth</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">6</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._seventh))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._seventh%29%29" class="RktValDef RktValLink" data-pltdoc="x">seventh</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the seventh element of the list.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._seventh%29%29" class="RktValLink" data-pltdoc="x">seventh</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">7</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._eighth))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._eighth%29%29" class="RktValDef RktValLink" data-pltdoc="x">eighth</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the eighth element of the list.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._eighth%29%29" class="RktValLink" data-pltdoc="x">eighth</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">8</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._ninth))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._ninth%29%29" class="RktValDef RktValLink" data-pltdoc="x">ninth</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the ninth element of the list.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._ninth%29%29" class="RktValLink" data-pltdoc="x">ninth</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">9</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._tenth))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._tenth%29%29" class="RktValDef RktValLink" data-pltdoc="x">tenth</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the tenth element of the list.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._tenth%29%29" class="RktValLink" data-pltdoc="x">tenth</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._last))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._last%29%29" class="RktValDef RktValLink" data-pltdoc="x">last</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the last element of the list.</div></p><p>This function takes time proportional to the length of <span class="RktVar">lst</span>.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._last%29%29" class="RktValLink" data-pltdoc="x">last</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._last-pair))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._last-pair%29%29" class="RktValDef RktValLink" data-pltdoc="x">last-pair</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the last pair of a (possibly improper) list.</div></p><p>This function takes time proportional to the &ldquo;length&rdquo; of <span class="RktVar">p</span>.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._last-pair%29%29" class="RktValLink" data-pltdoc="x">last-pair</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(4)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._make-list))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._make-list%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-list</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a newly constructed list of length <span class="RktVar">k</span>, holding
+<span class="RktVar">v</span> in all positions.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._make-list%29%29" class="RktValLink" data-pltdoc="x">make-list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">foo</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(foo foo foo foo foo foo foo)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._list-update))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._list-update%29%29" class="RktValDef RktValLink" data-pltdoc="x">list-update</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span><span class="RktVar">updater</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3c%2Fc%29%29" class="RktValLink" data-pltdoc="x">&lt;/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._length%29%29" class="RktValLink" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">updater</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list that is the same as <span class="RktVar">lst</span> except at the specified index.
+The element at the specified index is <span class="RktPn">(</span><span class="RktVar">updater</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list-ref%29%29" class="RktValLink" data-pltdoc="x">list-ref</a></span><span class="stt"> </span><span class="RktVar">lst</span><span class="stt"> </span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p>This function takes time proportional to <span class="RktVar">pos</span>.</p><p><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._list-update%29%29" class="RktValLink" data-pltdoc="x">list-update</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">zero</span><span class="hspace">&nbsp;</span><span class="RktVal">one</span><span class="hspace">&nbsp;</span><span class="RktVal">two</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-~3estring%29%29" class="RktValLink" data-pltdoc="x">symbol-&gt;string</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(zero "one" two)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._list-set))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._list-set%29%29" class="RktValDef RktValLink" data-pltdoc="x">list-set</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span><span class="RktVar">value</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3c%2Fc%29%29" class="RktValLink" data-pltdoc="x">&lt;/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._length%29%29" class="RktValLink" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">value</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list that is the same as <span class="RktVar">lst</span> except at the specified index.
+The element at the specified index is <span class="RktVar">value</span>.</div></p><p>This function takes time proportional to <span class="RktVar">pos</span>.</p><p><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._list-set%29%29" class="RktValLink" data-pltdoc="x">list-set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">zero</span><span class="hspace">&nbsp;</span><span class="RktVal">one</span><span class="hspace">&nbsp;</span><span class="RktVal">two</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">"two"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(zero one "two")</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._index-of))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._index-of%29%29" class="RktValDef RktValLink" data-pltdoc="x">index-of</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">is-equal?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">is-equal?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span>, but returns the index of the first element found
+instead of the tail of the list.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._index-of%29%29" class="RktValLink" data-pltdoc="x">index-of</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.7.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._index-where))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._index-where%29%29" class="RktValDef RktValLink" data-pltdoc="x">index-where</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._index-of%29%29" class="RktValLink" data-pltdoc="x">index-of</a></span> but with the predicate-searching behavior of
+<span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._memf%29%29" class="RktValLink" data-pltdoc="x">memf</a></span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._index-where%29%29" class="RktValLink" data-pltdoc="x">index-where</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.7.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._indexes-of))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._indexes-of%29%29" class="RktValDef RktValLink" data-pltdoc="x">indexes-of</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">is-equal?</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">is-equal?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._index-of%29%29" class="RktValLink" data-pltdoc="x">index-of</a></span>, but returns the a list of all the indexes
+where the element occurs in the list instead of just the first one.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._indexes-of%29%29" class="RktValLink" data-pltdoc="x">indexes-of</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 3)</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.7.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._indexes-where))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._indexes-where%29%29" class="RktValDef RktValLink" data-pltdoc="x">indexes-where</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._indexes-of%29%29" class="RktValLink" data-pltdoc="x">indexes-of</a></span> but with the predicate-searching behavior of
+<span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._index-where%29%29" class="RktValLink" data-pltdoc="x">index-where</a></span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._indexes-where%29%29" class="RktValLink" data-pltdoc="x">indexes-where</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 3)</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.7.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._take))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._take%29%29" class="RktValDef RktValLink" data-pltdoc="x">take</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a fresh list whose elements are the first <span class="RktVar">pos</span> elements
+of <span class="RktVar">lst</span>.  If <span class="RktVar">lst</span> has fewer than <span class="RktVar">pos</span> elements,
+the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p>The <span class="RktVar">lst</span> argument need not actually be a list; <span class="RktVar">lst</span>
+must merely start with a chain of at least <span class="RktVar">pos</span> pairs.</p><p>This function takes time proportional to <span class="RktVar">pos</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._take%29%29" class="RktValLink" data-pltdoc="x">take</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._take%29%29" class="RktValLink" data-pltdoc="x">take</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">non-list</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._drop))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._drop%29%29" class="RktValDef RktValLink" data-pltdoc="x">drop</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Just like <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list-tail%29%29" class="RktValLink" data-pltdoc="x">list-tail</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._split-at))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._split-at%29%29" class="RktValDef RktValLink" data-pltdoc="x">split-at</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the same result as</div></p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._take%29%29" class="RktValLink" data-pltdoc="x">take</a></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._drop%29%29" class="RktValLink" data-pltdoc="x">drop</a></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>except that it can be faster, but it will still take time
+proportional to <span class="RktVar">pos</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._takef))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._takef%29%29" class="RktValDef RktValLink" data-pltdoc="x">takef</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pred</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a fresh list whose elements are taken successively from
+<span class="RktVar">lst</span> as long as they satisfy <span class="RktVar">pred</span>.  The returned list
+includes up to, but not including, the first element in <span class="RktVar">lst</span> for
+which <span class="RktVar">pred</span> returns <span class="RktVal">#f</span>.</div></p><p>The <span class="RktVar">lst</span> argument need not actually be a list; the chain of
+pairs in <span class="RktVar">lst</span> will be traversed until a non-pair is encountered.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._takef%29%29" class="RktValLink" data-pltdoc="x">takef</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(2 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._takef%29%29" class="RktValLink" data-pltdoc="x">takef</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._odd~3f%29%29" class="RktValLink" data-pltdoc="x">odd?</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._takef%29%29" class="RktValLink" data-pltdoc="x">takef</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">6</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(2 4)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._dropf))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._dropf%29%29" class="RktValDef RktValLink" data-pltdoc="x">dropf</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pred</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Drops elements from the front of <span class="RktVar">lst</span> as long as they satisfy
+<span class="RktVar">pred</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._dropf%29%29" class="RktValLink" data-pltdoc="x">dropf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(5 8)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._dropf%29%29" class="RktValLink" data-pltdoc="x">dropf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._odd~3f%29%29" class="RktValLink" data-pltdoc="x">odd?</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(2 4 6 8)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._splitf-at))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._splitf-at%29%29" class="RktValDef RktValLink" data-pltdoc="x">splitf-at</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pred</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the same result as</div></p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._takef%29%29" class="RktValLink" data-pltdoc="x">takef</a></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pred</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._dropf%29%29" class="RktValLink" data-pltdoc="x">dropf</a></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pred</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>except that it can be faster.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._take-right))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._take-right%29%29" class="RktValDef RktValLink" data-pltdoc="x">take-right</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span>&rsquo;s <span class="RktVar">pos</span>-length tail. If <span class="RktVar">lst</span>
+has fewer than <span class="RktVar">pos</span> elements, then the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p>The <span class="RktVar">lst</span> argument need not actually be a list; <span class="RktVar">lst</span>
+must merely end with a chain of at least <span class="RktVar">pos</span> pairs.</p><p>This function takes time proportional to the length of <span class="RktVar">lst</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._take-right%29%29" class="RktValLink" data-pltdoc="x">take-right</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(4 5)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._take-right%29%29" class="RktValLink" data-pltdoc="x">take-right</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">non-list</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'non-list</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._drop-right))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._drop-right%29%29" class="RktValDef RktValLink" data-pltdoc="x">drop-right</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a fresh list whose elements are the prefix of <span class="RktVar">lst</span>,
+dropping its <span class="RktVar">pos</span>-length tail.  If <span class="RktVar">lst</span> has fewer than
+<span class="RktVar">pos</span> elements, then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p>The <span class="RktVar">lst</span> argument need not actually be a list; <span class="RktVar">lst</span> must
+merely end with a chain of at least <span class="RktVar">pos</span> pairs.</p><p>This function takes time proportional to the length of <span class="RktVar">lst</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._drop-right%29%29" class="RktValLink" data-pltdoc="x">drop-right</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._drop-right%29%29" class="RktValLink" data-pltdoc="x">drop-right</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">non-list</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._split-at-right))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._split-at-right%29%29" class="RktValDef RktValLink" data-pltdoc="x">split-at-right</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the same result as</div></p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._drop-right%29%29" class="RktValLink" data-pltdoc="x">drop-right</a></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._take-right%29%29" class="RktValLink" data-pltdoc="x">take-right</a></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>except that it can be faster, but it will still take time proportional
+to the length of <span class="RktVar">lst</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._split-at-right%29%29" class="RktValLink" data-pltdoc="x">split-at-right</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">'(1 2 3)</span></p></td></tr><tr><td><p><span class="RktRes">'(4 5 6)</span></p></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._split-at-right%29%29" class="RktValLink" data-pltdoc="x">split-at-right</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">'(1 2)</span></p></td></tr><tr><td><p><span class="RktRes">'(3 4 5 6)</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._takef-right))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._takef-right%29%29" class="RktValDef RktValLink" data-pltdoc="x">takef-right</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pred</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._dropf-right))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._dropf-right%29%29" class="RktValDef RktValLink" data-pltdoc="x">dropf-right</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pred</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._splitf-at-right))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._splitf-at-right%29%29" class="RktValDef RktValLink" data-pltdoc="x">splitf-at-right</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pred</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._takef%29%29" class="RktValLink" data-pltdoc="x">takef</a></span>, <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._dropf%29%29" class="RktValLink" data-pltdoc="x">dropf</a></span>, and <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._splitf-at%29%29" class="RktValLink" data-pltdoc="x">splitf-at</a></span>, but
+combined with the from-right functionality of <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._take-right%29%29" class="RktValLink" data-pltdoc="x">take-right</a></span>,
+<span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._drop-right%29%29" class="RktValLink" data-pltdoc="x">drop-right</a></span>, and <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._split-at-right%29%29" class="RktValLink" data-pltdoc="x">split-at-right</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._list-prefix~3f))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._list-prefix~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">list-prefix?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">l</span><span class="hspace">&nbsp;</span><span class="RktVar">r</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">same?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">l</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">r</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">same?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">True if <span class="RktVar">l</span> is a prefix of <span class="RktVar">r</span>.
+</div><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._list-prefix~3f%29%29" class="RktValLink" data-pltdoc="x">list-prefix?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._take-common-prefix))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._take-common-prefix%29%29" class="RktValDef RktValLink" data-pltdoc="x">take-common-prefix</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">l</span><span class="hspace">&nbsp;</span><span class="RktVar">r</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">same?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">l</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">r</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">same?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the longest common prefix of <span class="RktVar">l</span> and <span class="RktVar">r</span>.</div></p><p><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._take-common-prefix%29%29" class="RktValLink" data-pltdoc="x">take-common-prefix</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">c</span><span class="hspace">&nbsp;</span><span class="RktVal">d</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktVal">y</span><span class="hspace">&nbsp;</span><span class="RktVal">z</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(a b)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._drop-common-prefix))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._drop-common-prefix%29%29" class="RktValDef RktValLink" data-pltdoc="x">drop-common-prefix</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">l</span><span class="hspace">&nbsp;</span><span class="RktVar">r</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">same?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">l</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">r</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">same?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the tails of <span class="RktVar">l</span> and <span class="RktVar">r</span> with the common
+  prefix removed.</div></p><p><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._drop-common-prefix%29%29" class="RktValLink" data-pltdoc="x">drop-common-prefix</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">c</span><span class="hspace">&nbsp;</span><span class="RktVal">d</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktVal">y</span><span class="hspace">&nbsp;</span><span class="RktVal">z</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">'(c d)</span></p></td></tr><tr><td><p><span class="RktRes">'(x y z)</span></p></td></tr></table></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._split-common-prefix))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._split-common-prefix%29%29" class="RktValDef RktValLink" data-pltdoc="x">split-common-prefix</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">l</span><span class="hspace">&nbsp;</span><span class="RktVar">r</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">same?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">l</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">r</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">same?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the longest common prefix together with the tails of
+  <span class="RktVar">l</span> and <span class="RktVar">r</span> with the common prefix removed.</div></p><p><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._split-common-prefix%29%29" class="RktValLink" data-pltdoc="x">split-common-prefix</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">c</span><span class="hspace">&nbsp;</span><span class="RktVal">d</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktVal">y</span><span class="hspace">&nbsp;</span><span class="RktVal">z</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">'(a b)</span></p></td></tr><tr><td><p><span class="RktRes">'(c d)</span></p></td></tr><tr><td><p><span class="RktRes">'(x y z)</span></p></td></tr></table></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._add-between))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._add-between%29%29" class="RktValDef RktValLink" data-pltdoc="x">add-between</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">lst</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:before-first</span><span class="hspace">&nbsp;</span><span class="RktVar">before-first</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:before-last</span><span class="hspace">&nbsp;</span><span class="RktVar">before-last</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:after-last</span><span class="hspace">&nbsp;</span><span class="RktVar">after-last</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:splice?</span><span class="hspace">&nbsp;</span><span class="RktVar">splice?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">before-first</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">before-last</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">v</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">after-last</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">splice?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list with the same elements as <span class="RktVar">lst</span>, but with
+<span class="RktVar">v</span> between each pair of elements in <span class="RktVar">lst</span>; the last pair
+of elements will have <span class="RktVar">before-last</span> between them, instead of
+<span class="RktVar">v</span> (but <span class="RktVar">before-last</span> defaults to <span class="RktVar">v</span>).</div></p><p>If <span class="RktVar">splice?</span> is true, then <span class="RktVar">v</span> and <span class="RktVar">before-last</span>
+should be lists, and the list elements are spliced into the result.  In
+addition, when <span class="RktVar">splice?</span> is true, <span class="RktVar">before-first</span> and
+<span class="RktVar">after-last</span> are inserted before the first element and after the
+last element respectively.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._add-between%29%29" class="RktValLink" data-pltdoc="x">add-between</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktVal">y</span><span class="hspace">&nbsp;</span><span class="RktVal">z</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">and</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(x and y and z)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._add-between%29%29" class="RktValLink" data-pltdoc="x">add-between</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">x</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">and</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(x)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._add-between%29%29" class="RktValLink" data-pltdoc="x">add-between</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="hspace">&nbsp;</span><span class="RktVal">"d"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">","</span><span class="hspace">&nbsp;</span><span class="RktPn">#:before-last</span><span class="hspace">&nbsp;</span><span class="RktVal">"and"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("a" "," "b" "," "c" "and" "d")</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._add-between%29%29" class="RktValLink" data-pltdoc="x">add-between</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktVal">y</span><span class="hspace">&nbsp;</span><span class="RktVal">z</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal"><span class="nobreak">-</span></span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:before-last</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal"><span class="nobreak">-</span></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-</span></span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:before-first</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">begin</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:after-last</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">end</span><span class="hspace">&nbsp;</span><span class="RktVal">LF</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:splice?</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(begin x - y - - z end LF)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._append*))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._append%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">append*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">lsts</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lsts</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._append%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">append*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">lsts</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lsts</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._append%29%29" class="RktValLink" data-pltdoc="x">append</a></span>, but the last argument is used as a list of
+arguments for <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._append%29%29" class="RktValLink" data-pltdoc="x">append</a></span>, so <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._append%2A%29%29" class="RktValLink" data-pltdoc="x">append*</a></span><span class="stt"> </span><span class="RktVar">lst</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktVar">lsts</span><span class="RktPn">)</span> is the
+same as <span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span><span class="stt"> </span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._append%29%29" class="RktValLink" data-pltdoc="x">append</a></span><span class="stt"> </span><span class="RktVar">lst</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktVar">lsts</span><span class="RktPn">)</span>.  In other words, the
+relationship between <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._append%29%29" class="RktValLink" data-pltdoc="x">append</a></span> and <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._append%2A%29%29" class="RktValLink" data-pltdoc="x">append*</a></span> is similar to
+the one between <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span> and <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%2A%29%29" class="RktValLink" data-pltdoc="x">list*</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._append%2A%29%29" class="RktValLink" data-pltdoc="x">append*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">c</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">d</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(a b c d)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._append%2A%29%29" class="RktValLink" data-pltdoc="x">append*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">", "</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Alpha"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Beta"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Gamma"</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("Alpha" ", " "Beta" ", " "Gamma")</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._flatten))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._flatten%29%29" class="RktValDef RktValLink" data-pltdoc="x">flatten</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Flattens an arbitrary S-expression structure of pairs into a list. More
+precisely, <span class="RktVar">v</span> is treated as a binary tree where pairs are
+interior nodes, and the resulting list contains all of the
+non-<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span> leaves of the tree in the same order as an inorder
+traversal.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._flatten%29%29" class="RktValLink" data-pltdoc="x">flatten</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">c</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">d</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">e</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(a b c d e)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._flatten%29%29" class="RktValLink" data-pltdoc="x">flatten</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(a)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._check-duplicates))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._check-duplicates%29%29" class="RktValDef RktValLink" data-pltdoc="x">check-duplicates</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">lst</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">same?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:key</span><span class="hspace">&nbsp;</span><span class="RktVar">extract-key</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:default</span><span class="hspace">&nbsp;</span><span class="RktVar">failure-result</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">same?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">extract-key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">failure-result</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._failure-result%2Fc%29%29" class="RktValLink" data-pltdoc="x">failure-result/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the first duplicate item in <span class="RktVar">lst</span>. More precisely, it
+returns the first <span class="RktVar">x</span> such that there was a previous
+<span class="RktVar">y</span> where <span class="RktPn">(</span><span class="RktVar">same?</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">extract-key</span><span class="stt"> </span><span class="RktVar">x</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">extract-key</span><span class="stt"> </span><span class="RktVar">y</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p>If no duplicate is found, then <span class="RktVar">failure-result</span> determines the
+result:</p><ul><li><p>If <span class="RktVar">failure-result</span> is a procedure, it is called
+(through a tail call) with no arguments to produce the result.</p></li><li><p>Otherwise, <span class="RktVar">failure-result</span> is returned as the result.</p></li></ul><p>The <span class="RktVar">same?</span> argument should be an equivalence predicate such as
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span> or a dictionary.
+The procedures <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, and <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> automatically
+use a dictionary for speed.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._check-duplicates%29%29" class="RktValLink" data-pltdoc="x">check-duplicates</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._check-duplicates%29%29" class="RktValLink" data-pltdoc="x">check-duplicates</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._check-duplicates%29%29" class="RktValLink" data-pltdoc="x">check-duplicates</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:key</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(a 3)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._check-duplicates%29%29" class="RktValLink" data-pltdoc="x">check-duplicates</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._modulo%29%29" class="RktValLink" data-pltdoc="x">modulo</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._modulo%29%29" class="RktValLink" data-pltdoc="x">modulo</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._check-duplicates%29%29" class="RktValLink" data-pltdoc="x">check-duplicates</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:default</span><span class="hspace">&nbsp;</span><span class="RktVal">"no duplicates"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"no duplicates"</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.<br/>Changed in version 6.11.0.2: Added the <span class="RktPn">#:default</span> optional argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._remove-duplicates))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._remove-duplicates%29%29" class="RktValDef RktValLink" data-pltdoc="x">remove-duplicates</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">lst</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">same?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:key</span><span class="hspace">&nbsp;</span><span class="RktVar">extract-key</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">same?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">extract-key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list that has all items in <span class="RktVar">lst</span>, but without duplicate
+items, where <span class="RktVar">same?</span> determines whether two elements of the list
+are equivalent.  The resulting list is in the same order as
+<span class="RktVar">lst</span>, and for any item that occurs multiple times, the first one
+is kept.</div></p><p>The <span class="RktPn">#:key</span> argument <span class="RktVar">extract-key</span> is used to extract a
+key value from each list element, so two items are considered equal if
+<span class="RktPn">(</span><span class="RktVar">same?</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">extract-key</span><span class="stt"> </span><span class="RktSym">x</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">extract-key</span><span class="stt"> </span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span> is true.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._remove-duplicates%29%29" class="RktValLink" data-pltdoc="x">remove-duplicates</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">a</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(a b)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._remove-duplicates%29%29" class="RktValLink" data-pltdoc="x">remove-duplicates</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1.0</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 1.0 0)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._remove-duplicates%29%29" class="RktValLink" data-pltdoc="x">remove-duplicates</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1.0</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 0)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._filter-map))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._filter-map%29%29" class="RktValDef RktValLink" data-pltdoc="x">filter-map</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="stt"> </span><span class="RktVar">proc</span><span class="stt"> </span><span class="RktVar">lst</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>, except that, if <span class="RktVar">proc</span>
+returns <span class="RktVal">#false</span>, that element is omitted from the resulting list.
+In other words, <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._filter-map%29%29" class="RktValLink" data-pltdoc="x">filter-map</a></span> is equivalent to
+<span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._filter%29%29" class="RktValLink" data-pltdoc="x">filter</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym">x</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="stt"> </span><span class="RktVar">proc</span><span class="stt"> </span><span class="RktVar">lst</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span>, but more efficient,
+because <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._filter-map%29%29" class="RktValLink" data-pltdoc="x">filter-map</a></span> avoids
+building the intermediate list.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._filter-map%29%29" class="RktValLink" data-pltdoc="x">filter-map</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._negative~3f%29%29" class="RktValLink" data-pltdoc="x">negative?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._abs%29%29" class="RktValLink" data-pltdoc="x">abs</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-3</span></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-4</span></span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(3 4)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._count))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._count%29%29" class="RktValDef RktValLink" data-pltdoc="x">count</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._length%29%29" class="RktValLink" data-pltdoc="x">length</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._filter-map%29%29" class="RktValLink" data-pltdoc="x">filter-map</a></span><span class="stt"> </span><span class="RktVar">proc</span><span class="stt"> </span><span class="RktVar">lst</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span>, but without building
+the intermediate list.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._count%29%29" class="RktValLink" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-2</span></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._partition))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._partition%29%29" class="RktValDef RktValLink" data-pltdoc="x">partition</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._filter%29%29" class="RktValLink" data-pltdoc="x">filter</a></span>, except that two values are returned: the
+items for which <span class="RktVar">pred</span> returns a true value, and the items for
+which <span class="RktVar">pred</span> returns <span class="RktVal">#f</span>.</div></p><p>The result is the same as</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._filter%29%29" class="RktValLink" data-pltdoc="x">filter</a></span><span class="hspace">&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._filter%29%29" class="RktValLink" data-pltdoc="x">filter</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._negate%29%29" class="RktValLink" data-pltdoc="x">negate</a></span><span class="hspace">&nbsp;</span><span class="RktVar">pred</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>but <span class="RktVar">pred</span> is applied to each item in <span class="RktVar">lst</span> only once.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._partition%29%29" class="RktValLink" data-pltdoc="x">partition</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">'(2 4 6)</span></p></td></tr><tr><td><p><span class="RktRes">'(1 3 5)</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._range))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._range%29%29" class="RktValDef RktValLink" data-pltdoc="x">range</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">end</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._range%29%29" class="RktValDef RktValLink" data-pltdoc="x">range</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">step</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">step</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span>, but returns lists.</div></p><p>The resulting list holds numbers starting at <span class="RktVar">start</span> and whose
+successive elements are computed by adding <span class="RktVar">step</span> to their
+predecessor until <span class="RktVar">end</span> (excluded) is reached.  If no starting
+point is provided, <span class="RktVal">0</span> is used. If no <span class="RktVar">step</span> argument is
+provided, <span class="RktVal">1</span> is used.</p><p>Like <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span>, a <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._range%29%29" class="RktValLink" data-pltdoc="x">range</a></span> application can provide better
+performance when it appears directly in a <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> clause.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._range%29%29" class="RktValLink" data-pltdoc="x">range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(0 1 2 3 4 5 6 7 8 9)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._range%29%29" class="RktValLink" data-pltdoc="x">range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(10 11 12 13 14 15 16 17 18 19)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._range%29%29" class="RktValLink" data-pltdoc="x">range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="hspace">&nbsp;</span><span class="RktVal">40</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(20 22 24 26 28 30 32 34 36 38)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._range%29%29" class="RktValLink" data-pltdoc="x">range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(20 19 18 17 16 15 14 13 12 11)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._range%29%29" class="RktValLink" data-pltdoc="x">range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">15</span><span class="hspace">&nbsp;</span><span class="RktVal">1.5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(10 11.5 13.0 14.5)</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.7.0.4 of package <span class="stt">base</span>: Adjusted to cooperate with <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> in the same
+way that <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span> does.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._inclusive-range))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._inclusive-range%29%29" class="RktValDef RktValLink" data-pltdoc="x">inclusive-range</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">step</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">step</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-inclusive-range%29%29" class="RktValLink" data-pltdoc="x">in-inclusive-range</a></span>, but returns lists.</div></p><p>The resulting list holds numbers starting at <span class="RktVar">start</span> and whose
+successive elements are computed by adding <span class="RktVar">step</span> to their
+predecessor until <span class="RktVar">end</span> (included) is reached.
+If no <span class="RktVar">step</span> argument is provided, <span class="RktVal">1</span> is used.</p><p>Like <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-inclusive-range%29%29" class="RktValLink" data-pltdoc="x">in-inclusive-range</a></span>, an <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._inclusive-range%29%29" class="RktValLink" data-pltdoc="x">inclusive-range</a></span> application can provide better
+performance when it appears directly in a <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> clause.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._inclusive-range%29%29" class="RktValLink" data-pltdoc="x">inclusive-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(10 11 12 13 14 15 16 17 18 19 20)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._inclusive-range%29%29" class="RktValLink" data-pltdoc="x">inclusive-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="hspace">&nbsp;</span><span class="RktVal">40</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(20 22 24 26 28 30 32 34 36 38 40)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._inclusive-range%29%29" class="RktValLink" data-pltdoc="x">inclusive-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(20 19 18 17 16 15 14 13 12 11 10)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._inclusive-range%29%29" class="RktValLink" data-pltdoc="x">inclusive-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">15</span><span class="hspace">&nbsp;</span><span class="RktVal">1.5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(10 11.5 13.0 14.5)</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 8.0.0.13 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._append-map))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._append-map%29%29" class="RktValDef RktValLink" data-pltdoc="x">append-map</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._append%2A%29%29" class="RktValLink" data-pltdoc="x">append*</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="stt"> </span><span class="RktVar">proc</span><span class="stt"> </span><span class="RktVar">lst</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._append-map%29%29" class="RktValLink" data-pltdoc="x">append-map</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-~3elist%29%29" class="RktValLink" data-pltdoc="x">vector-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3 4)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._filter-not))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._filter-not%29%29" class="RktValDef RktValLink" data-pltdoc="x">filter-not</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._filter%29%29" class="RktValLink" data-pltdoc="x">filter</a></span>, but the meaning of the <span class="RktVar">pred</span> predicate is
+reversed: the result is a list of all items for which <span class="RktVar">pred</span>
+returns <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._filter-not%29%29" class="RktValLink" data-pltdoc="x">filter-not</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 3 5)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._shuffle))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._shuffle%29%29" class="RktValDef RktValLink" data-pltdoc="x">shuffle</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list with all elements from <span class="RktVar">lst</span>, randomly shuffled.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._shuffle%29%29" class="RktValLink" data-pltdoc="x">shuffle</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(2 4 5 3 6 1)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._shuffle%29%29" class="RktValLink" data-pltdoc="x">shuffle</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(2 5 4 3 6 1)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._shuffle%29%29" class="RktValLink" data-pltdoc="x">shuffle</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(6 1 4 5 2 3)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._combinations))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._combinations%29%29" class="RktValDef RktValLink" data-pltdoc="x">combinations</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._combinations%29%29" class="RktValDef RktValLink" data-pltdoc="x">combinations</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">size</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">size</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Wikipedia <a href="https://en.wikipedia.org/wiki/Combination">combinations</a></p></blockquote></blockquote></blockquote></div><div class="SIntrapara">Return a list of all combinations of elements in the input list
+(aka the <a name="(idx._(gentag._187._(lib._scribblings/reference/reference..scrbl)))"></a>powerset of <span class="RktVar">lst</span>).
+If <span class="RktVar">size</span> is given, limit results to combinations of <span class="RktVar">size</span> elements.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._combinations%29%29" class="RktValLink" data-pltdoc="x">combinations</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(() (1) (2) (1 2) (3) (1 3) (2 3) (1 2 3))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._combinations%29%29" class="RktValLink" data-pltdoc="x">combinations</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((1 2) (1 3) (2 3))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._in-combinations))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._in-combinations%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-combinations</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._in-combinations%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-combinations</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">size</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">size</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"><a name="(idx._(gentag._188._(lib._scribblings/reference/reference..scrbl)))"></a>Returns a sequence of all combinations of elements in the input list,
+ or all combinations of length <span class="RktVar">size</span> if <span class="RktVar">size</span> is given.
+Builds combinations one-by-one instead of all at once.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="time.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._time%29%29" class="RktStxLink" data-pltdoc="x">time</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._combinations%29%29" class="RktValLink" data-pltdoc="x">combinations</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._range%29%29" class="RktValLink" data-pltdoc="x">range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">15</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">cpu time: 10 real time: 5 gc time: 0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="time.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._time%29%29" class="RktStxLink" data-pltdoc="x">time</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._in-combinations%29%29" class="RktValLink" data-pltdoc="x">in-combinations</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._range%29%29" class="RktValLink" data-pltdoc="x">range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">15</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">cpu time: 0 real time: 0 gc time: 0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._permutations))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._permutations%29%29" class="RktValDef RktValLink" data-pltdoc="x">permutations</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"><a name="(idx._(gentag._189._(lib._scribblings/reference/reference..scrbl)))"></a>Returns a list of all permutations of the input list.  Note that this
+function works without inspecting the elements, and therefore it ignores
+repeated elements (which will result in repeated permutations).
+Raises an error if the input list contains more than 256 elements.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._permutations%29%29" class="RktValLink" data-pltdoc="x">permutations</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((1 2 3) (2 1 3) (1 3 2) (3 1 2) (2 3 1) (3 2 1))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._permutations%29%29" class="RktValLink" data-pltdoc="x">permutations</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktVal">x</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((x x) (x x))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._in-permutations))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._in-permutations%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-permutations</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"><a name="(idx._(gentag._190._(lib._scribblings/reference/reference..scrbl)))"></a>Returns a sequence of all permutations of the input list.  It is
+equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="RktValLink" data-pltdoc="x">in-list</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._permutations%29%29" class="RktValLink" data-pltdoc="x">permutations</a></span><span class="stt"> </span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span> but much faster since
+it builds the permutations one-by-one on each iteration.
+Raises an error if the input list contains more than 256 elements.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._argmin))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._argmin%29%29" class="RktValDef RktValLink" data-pltdoc="x">argmin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the first element in the list <span class="RktVar">lst</span> that minimizes the
+result of <span class="RktVar">proc</span>.  Signals an error on an empty list.
+See also <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._min%29%29" class="RktValLink" data-pltdoc="x">min</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._argmin%29%29" class="RktValLink" data-pltdoc="x">argmin</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">pears</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">banana</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">apples</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 banana)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._argmin%29%29" class="RktValLink" data-pltdoc="x">argmin</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">banana</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">orange</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 banana)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._argmax))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._argmax%29%29" class="RktValDef RktValLink" data-pltdoc="x">argmax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the first element in the list <span class="RktVar">lst</span> that maximizes the
+result of <span class="RktVar">proc</span>.  Signals an error on an empty list.
+See also <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._max%29%29" class="RktValLink" data-pltdoc="x">max</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._argmax%29%29" class="RktValLink" data-pltdoc="x">argmax</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">pears</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">banana</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">apples</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(3 pears)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._argmax%29%29" class="RktValLink" data-pltdoc="x">argmax</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">pears</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">oranges</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(3 pears)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._group-by))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._group-by%29%29" class="RktValDef RktValLink" data-pltdoc="x">group-by</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">same?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">same?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Groups the given list into equivalence classes, with equivalence being
+determined by <span class="RktVar">same?</span>. Within each equivalence class, <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._group-by%29%29" class="RktValLink" data-pltdoc="x">group-by</a></span>
+preserves the ordering of the original list. Equivalence classes themselves are
+in order of first appearance in the input.</div></p><p><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._group-by%29%29" class="RktValLink" data-pltdoc="x">group-by</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._modulo%29%29" class="RktValLink" data-pltdoc="x">modulo</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">54</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">43</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">643</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((1 1 43 7 643 1) (2 2 2 5 2 2) (54 0))</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._cartesian-product))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._cartesian-product%29%29" class="RktValDef RktValLink" data-pltdoc="x">cartesian-product</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Computes the n-ary cartesian product of the given lists.</div></p><p><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._cartesian-product%29%29" class="RktValLink" data-pltdoc="x">cartesian-product</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">c</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((1 a) (1 b) (1 c) (2 a) (2 b) (2 c) (3 a) (3 b) (3 c))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._cartesian-product%29%29" class="RktValLink" data-pltdoc="x">cartesian-product</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">d</span><span class="hspace">&nbsp;</span><span class="RktVal">e</span><span class="hspace">&nbsp;</span><span class="RktVal">f</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">'((4 d #t)</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(4 d #f)</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(4 e #t)</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(4 e #f)</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(4 f #t)</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(4 f #f)</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(5 d #t)</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(5 d #f)</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(5 e #t)</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(5 e #f)</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(5 f #t)</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(5 f #f)</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(6 d #t)</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(6 d #f)</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(6 e #t)</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(6 e #f)</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(6 f #t)</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(6 f #f))</span></p></td></tr></table></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._remf))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._remf%29%29" class="RktValDef RktValLink" data-pltdoc="x">remf</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list that is like <span class="RktVar">lst</span>, omitting the first element of <span class="RktVar">lst</span>
+for which <span class="RktVar">pred</span> produces a true value.</div></p><p><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._remf%29%29" class="RktValLink" data-pltdoc="x">remf</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._negative~3f%29%29" class="RktValLink" data-pltdoc="x">negative?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-2</span></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-5</span></span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 3 4 -5)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/list..rkt)._remf*))"></a><span title="Provided from: racket/list, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._remf%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">remf*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._remf%29%29" class="RktValLink" data-pltdoc="x">remf</a></span>, but removes all the elements for which <span class="RktVar">pred</span>
+produces a true value.</div></p><p><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._remf%2A%29%29" class="RktValLink" data-pltdoc="x">remf*</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._negative~3f%29%29" class="RktValLink" data-pltdoc="x">negative?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-2</span></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-5</span></span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 3 4)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Immutable_Cyclic_Data&quot;">4.10.8<tt>&nbsp;</tt><a name="(part._.Immutable_.Cyclic_.Data)"></a>Immutable Cyclic Data</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-reader-graph))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-reader-graph%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-reader-graph</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a value like <span class="RktVar">v</span>, with <a name="(tech._placeholder)"></a><span style="font-style: italic">placeholders</span> created by
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-placeholder%29%29" class="RktValLink" data-pltdoc="x">make-placeholder</a></span> replaced with the values that they contain, and
+with <a name="(tech._hash._placeholder)"></a><span style="font-style: italic">hash placeholders</span> created by <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-hash-placeholder%29%29" class="RktValLink" data-pltdoc="x">make-hash-placeholder</a></span>
+with an immutable hash table.  No part of <span class="RktVar">v</span> is mutated; instead,
+parts of <span class="RktVar">v</span> are copied as necessary to construct the resulting
+graph, where at most one copy is created for any given value.</div></p><p>Since the copied values can be immutable, and since the copy is also
+immutable, <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-reader-graph%29%29" class="RktValLink" data-pltdoc="x">make-reader-graph</a></span> can create cycles involving only
+immutable pairs, vectors, boxes, and hash tables.</p><p>Only the following kinds of values are copied and traversed to detect
+placeholders:</p><ul><li><p>pairs</p></li><li><p>vectors, both mutable and immutable</p></li><li><p>boxes, both mutable and immutable</p></li><li><p>hash tables, both mutable and immutable</p></li><li><p>instances of a <a href="structures.html#%28tech._prefab%29" data-pltdoc="x">prefab</a> structure type</p></li><li><p>placeholders created by <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-placeholder%29%29" class="RktValLink" data-pltdoc="x">make-placeholder</a></span> and
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-hash-placeholder%29%29" class="RktValLink" data-pltdoc="x">make-hash-placeholder</a></span></p></li></ul><p>Due to these restrictions, <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-reader-graph%29%29" class="RktValLink" data-pltdoc="x">make-reader-graph</a></span> creates exactly
+the same sort of cyclic values as <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A%29%29" class="RktStxLink" data-pltdoc="x">let*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ph</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-placeholder%29%29" class="RktValLink" data-pltdoc="x">make-placeholder</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">ph</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._placeholder-set%21%29%29" class="RktValLink" data-pltdoc="x">placeholder-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ph</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-reader-graph%29%29" class="RktValLink" data-pltdoc="x">make-reader-graph</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#0='(1 . #0#)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._placeholder~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._placeholder~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">placeholder?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="pairs.html#%28tech._placeholder%29" class="techoutside" data-pltdoc="x"><span class="techinside">placeholder</span></a> created by
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-placeholder%29%29" class="RktValLink" data-pltdoc="x">make-placeholder</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-placeholder))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-placeholder%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-placeholder</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._placeholder~3f%29%29" class="RktValLink" data-pltdoc="x">placeholder?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="pairs.html#%28tech._placeholder%29" class="techoutside" data-pltdoc="x"><span class="techinside">placeholder</span></a> for use with <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._placeholder-set%21%29%29" class="RktValLink" data-pltdoc="x">placeholder-set!</a></span>
+and <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-reader-graph%29%29" class="RktValLink" data-pltdoc="x">make-reader-graph</a></span>. The <span class="RktVar">v</span> argument supplies the
+initial value for the placeholder.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._placeholder-set!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._placeholder-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">placeholder-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">ph</span><span class="hspace">&nbsp;</span><span class="RktVar">datum</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ph</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._placeholder~3f%29%29" class="RktValLink" data-pltdoc="x">placeholder?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">datum</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Changes the value of <span class="RktVar">ph</span> to <span class="RktSym">v</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._placeholder-get))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._placeholder-get%29%29" class="RktValDef RktValLink" data-pltdoc="x">placeholder-get</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">ph</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ph</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._placeholder~3f%29%29" class="RktValLink" data-pltdoc="x">placeholder?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the value of <span class="RktVar">ph</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._hash-placeholder~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._hash-placeholder~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">hash-placeholder?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="pairs.html#%28tech._hash._placeholder%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash placeholder</span></a> created
+by <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-hash-placeholder%29%29" class="RktValLink" data-pltdoc="x">make-hash-placeholder</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-hash-placeholder))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-hash-placeholder%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-hash-placeholder</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">assocs</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._hash-placeholder~3f%29%29" class="RktValLink" data-pltdoc="x">hash-placeholder?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">assocs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hash%29%29" class="RktValLink" data-pltdoc="x">make-immutable-hash</a></span>, but produces a <a href="pairs.html#%28tech._hash._placeholder%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash placeholder</span></a>
+for use with <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-reader-graph%29%29" class="RktValLink" data-pltdoc="x">make-reader-graph</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-hasheq-placeholder))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-hasheq-placeholder%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-hasheq-placeholder</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">assocs</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._hash-placeholder~3f%29%29" class="RktValLink" data-pltdoc="x">hash-placeholder?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">assocs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hasheq%29%29" class="RktValLink" data-pltdoc="x">make-immutable-hasheq</a></span>, but produces a <a href="pairs.html#%28tech._hash._placeholder%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash placeholder</span></a>
+for use with <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-reader-graph%29%29" class="RktValLink" data-pltdoc="x">make-reader-graph</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-hasheqv-placeholder))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-hasheqv-placeholder%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-hasheqv-placeholder</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">assocs</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._hash-placeholder~3f%29%29" class="RktValLink" data-pltdoc="x">hash-placeholder?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">assocs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hasheqv%29%29" class="RktValLink" data-pltdoc="x">make-immutable-hasheqv</a></span>, but produces a <a href="pairs.html#%28tech._hash._placeholder%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash placeholder</span></a>
+for use with <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-reader-graph%29%29" class="RktValLink" data-pltdoc="x">make-reader-graph</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-hashalw-placeholder))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-hashalw-placeholder%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-hashalw-placeholder</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">assocs</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._hash-placeholder~3f%29%29" class="RktValLink" data-pltdoc="x">hash-placeholder?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">assocs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hashalw%29%29" class="RktValLink" data-pltdoc="x">make-immutable-hashalw</a></span>, but produces a <a href="pairs.html#%28tech._hash._placeholder%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash placeholder</span></a>
+for use with <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-reader-graph%29%29" class="RktValLink" data-pltdoc="x">make-reader-graph</a></span>.</div></p><p class="SHistory">Added in version 8.5.0.3 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="keywords.html" title="backward to &quot;4.9 Keywords&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="mpairs.html" title="forward to &quot;4.11 Mutable Pairs and Lists&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/parameters.html b/clones/docs.racket-lang.org/reference/parameters.html
new file mode 100644
index 00000000..1c8fb0e4
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/parameters.html
@@ -0,0 +1,57 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>11.3.2&nbsp;Parameters</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewselflink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.1&nbsp;</td><td><a href="threads.html" class="tocviewlink" data-pltdoc="x">Threads</a></td></tr><tr><td align="right">11.2&nbsp;</td><td><a href="all-sync.html" class="tocviewlink" data-pltdoc="x">Synchronization</a></td></tr><tr><td align="right">11.3&nbsp;</td><td><a href="thread-local-storage.html" class="tocviewselflink" data-pltdoc="x">Thread-<wbr></wbr>Local Storage</a></td></tr><tr><td align="right">11.4&nbsp;</td><td><a href="futures.html" class="tocviewlink" data-pltdoc="x">Futures</a></td></tr><tr><td align="right">11.5&nbsp;</td><td><a href="places.html" class="tocviewlink" data-pltdoc="x">Places</a></td></tr><tr><td align="right">11.6&nbsp;</td><td><a href="engine.html" class="tocviewlink" data-pltdoc="x">Engines</a></td></tr><tr><td align="right">11.7&nbsp;</td><td><a href="memory-order.html" class="tocviewlink" data-pltdoc="x">Machine Memory Order</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>11.3&nbsp;</td><td><a href="thread-local-storage.html" class="tocviewlink" data-pltdoc="x">Thread-<wbr></wbr>Local Storage</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.3.1&nbsp;</td><td><a href="threadcells.html" class="tocviewlink" data-pltdoc="x">Thread Cells</a></td></tr><tr><td align="right">11.3.2&nbsp;</td><td><a href="parameters.html" class="tocviewselflink" data-pltdoc="x">Parameters</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._make-parameter%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>parameter</span></span></a></td></tr><tr><td><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">parameterize</span></span></a></td></tr><tr><td><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%2A%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">parameterize*</span></span></a></td></tr><tr><td><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._make-derived-parameter%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>derived-<wbr></wbr>parameter</span></span></a></td></tr><tr><td><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._parameter~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">parameter?</span></span></a></td></tr><tr><td><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._parameter-procedure~3d~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">parameter-<wbr></wbr>procedure=?</span></span></a></td></tr><tr><td><a href="parameters.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._current-parameterization%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>parameterization</span></span></a></td></tr><tr><td><a href="parameters.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call-with-parameterization%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>parameterization</span></span></a></td></tr><tr><td><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._parameterization~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">parameterization?</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="threadcells.html" title="backward to &quot;11.3.1 Thread Cells&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="thread-local-storage.html" title="up to &quot;11.3 Thread-Local Storage&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="futures.html" title="forward to &quot;11.4 Futures&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parameters&quot;">11.3.2<tt>&nbsp;</tt><a name="(part._parameters)"></a>Parameters</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=parameterize.html&amp;version=8.6" class="Sq" data-pltdoc="x">Dynamic Binding: <span class="RktSym"><span class="RktStxLink">parameterize</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces parameters.</p></blockquote></blockquote></blockquote><p>See <a href="eval-model.html#%28part._parameter-model%29" data-pltdoc="x">Parameters</a> for basic information on the
+parameter model. Parameters correspond to <span style="font-style: italic">preserved thread
+fluids</span> in Scsh [<a href="doc-bibliography.html#%28cite._.Gasbichler02%29" data-pltdoc="x">Gasbichler02</a>].</p><p>To parameterize code in a thread- and continuation-friendly manner,
+use <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>. The <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span> form introduces a
+fresh <a href="eval-model.html#%28tech._thread._cell%29" class="techoutside" data-pltdoc="x"><span class="techinside">thread cell</span></a> for the dynamic extent of its body
+expressions.</p><p>When a new thread is created, the <a href="eval-model.html#%28tech._parameterization%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameterization</span></a> for the new
+thread&rsquo;s initial continuation is the <a href="eval-model.html#%28tech._parameterization%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameterization</span></a> of the
+creator thread.  Since each parameter&rsquo;s <a href="eval-model.html#%28tech._thread._cell%29" class="techoutside" data-pltdoc="x"><span class="techinside">thread cell</span></a> is
+<a href="eval-model.html#%28tech._preserved%29" class="techoutside" data-pltdoc="x"><span class="techinside">preserved</span></a>, the new thread &ldquo;inherits&rdquo; the parameter values of
+its creating thread. When a continuation is moved from one thread to
+another, settings introduced with <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span> effectively
+move with the continuation.</p><p>In contrast, direct assignment to a parameter (by calling the
+parameter procedure with a value) changes the value in a thread cell,
+and therefore changes the setting only for the current
+thread. Consequently, as far as the memory manager is concerned, the
+value originally associated with a parameter through
+<span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span> remains reachable as long the continuation is
+reachable, even if the parameter is mutated.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-parameter))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._make-parameter%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-parameter</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">guard</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._parameter~3f%29%29" class="RktValLink" data-pltdoc="x">parameter?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">guard</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">parameter-procedure</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a new parameter procedure. The value of the parameter is
+initialized to <span class="RktVar">v</span> in all threads.</div></p><p>If <span class="RktVar">guard</span> is not <span class="RktVal">#f</span>,
+it is used as the parameter&rsquo;s guard procedure.  A guard
+procedure takes one argument. Whenever the parameter procedure is
+applied to an argument, the argument is passed on to the guard
+procedure. The result returned by the guard procedure is used as the
+new parameter value.  A guard procedure can raise an exception to
+reject a change to the parameter&rsquo;s value. The <span class="RktVar">guard</span> is not
+applied to the initial <span class="RktVar">v</span>.</p><p>The <span class="RktVar">name</span> argument is used as the parameter procedure&rsquo;s name
+as reported by <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span>.</p><p class="SHistory">Changed in version 7.4.0.6 of package <span class="stt">base</span>: Added the <span class="RktVar">name</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/more-scheme..rkt)._parameterize))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">parameterize</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">parameter-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">value-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">parameter-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._parameter~3f%29%29" class="RktValLink" data-pltdoc="x">parameter?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=parameterize.html&amp;version=8.6" class="Sq" data-pltdoc="x">Dynamic Binding: <span class="RktSym"><span class="RktStxLink">parameterize</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>.</p></blockquote></blockquote></blockquote></div></p><p>The result of a <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span> expression is the result of the
+last <span class="RktVar">body</span>. The <span class="RktVar">parameter-expr</span>s determine the
+parameters to set, and the <span class="RktVar">value-expr</span>s determine the
+corresponding values to install while evaluating the
+<span class="RktVar">body</span>s. The <span class="RktVar">parameter-expr</span>s and
+<span class="RktVar">value-expr</span>s are evaluated left-to-right (interleaved), and
+then the parameters are bound in the continuation to preserved thread
+cells that contain the values of the <span class="RktVar">value-expr</span>s; the result
+of each <span class="RktVar">parameter-expr</span> is checked with <span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._parameter~3f%29%29" class="RktValLink" data-pltdoc="x">parameter?</a></span>
+just before it is bound. The last <span class="RktVar">body</span> is in tail
+position with respect to the entire <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span> form.</p><p>Outside the dynamic extent of a <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span> expression,
+parameters remain bound to other thread cells. Effectively, therefore,
+old parameters settings are restored as control exits the
+<span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span> expression.</p><p>If a continuation is captured during the evaluation of
+<span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>, invoking the continuation effectively
+re-introduces the <a href="eval-model.html#%28tech._parameterization%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameterization</span></a>, since a parameterization is
+associated to a continuation via a continuation mark (see
+<a href="contmarks.html" data-pltdoc="x">Continuation Marks</a>) using a private key.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._exit-handler%29%29" class="RktValLink" data-pltdoc="x">exit-handler</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">no-exit</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._exit%29%29" class="RktValLink" data-pltdoc="x">exit</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._make-parameter%29%29" class="RktValLink" data-pltdoc="x">make-parameter</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._make-parameter%29%29" class="RktValLink" data-pltdoc="x">make-parameter</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">p1</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">p2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p1</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(3 . 1)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._let%2Fcc%29%29" class="RktStxLink" data-pltdoc="x">let/cc</a></span><span class="hspace">&nbsp;</span><span class="RktSym">out</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">p1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p1</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._let%2Fcc%29%29" class="RktStxLink" data-pltdoc="x">let/cc</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">out</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(1 . 3)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._make-channel%29%29" class="RktValLink" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">p1</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;thread&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-get%29%29" class="RktValLink" data-pltdoc="x">channel-get</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(0 . 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k-ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._make-channel%29%29" class="RktValLink" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">send-k</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">p1</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2Fec%29%29" class="RktStxLink" data-pltdoc="x">let/ec</a></span><span class="hspace">&nbsp;</span><span class="RktSym">esc</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._let%2Fcc%29%29" class="RktStxLink" data-pltdoc="x">let/cc</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k-ch</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">esc</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">send-k</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;thread&gt;</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-get%29%29" class="RktValLink" data-pltdoc="x">channel-get</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k-ch</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p1</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;thread&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-get%29%29" class="RktValLink" data-pltdoc="x">channel-get</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">send-k</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;thread&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-get%29%29" class="RktValLink" data-pltdoc="x">channel-get</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k-ch</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">p1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;thread&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-get%29%29" class="RktValLink" data-pltdoc="x">channel-get</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/more-scheme..rkt)._parameterize*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">parameterize*</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVar">parameter-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">value-expr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Analogous to <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A%29%29" class="RktStxLink" data-pltdoc="x">let*</a></span> compared to <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span>, <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%2A%29%29" class="RktStxLink" data-pltdoc="x">parameterize*</a></span>
+is the same as a nested series of single-parameter <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>
+forms.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-derived-parameter))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._make-derived-parameter%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-derived-parameter</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">parameter</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">guard</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">wrap</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._parameter~3f%29%29" class="RktValLink" data-pltdoc="x">parameter?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">parameter</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._parameter~3f%29%29" class="RktValLink" data-pltdoc="x">parameter?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">guard</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">wrap</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a parameter procedure that sets or retrieves the same value as
+<span class="RktVar">parameter</span>, but with:</div></p><ul><li><p><span class="RktVar">guard</span> applied when setting the parameter (before any
+guard associated with <span class="RktVar">parameter</span>), and</p></li><li><p><span class="RktVar">wrap</span> applied when obtaining the parameter&rsquo;s value.</p></li></ul><p>See also <span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._chaperone-procedure%29%29" class="RktValLink" data-pltdoc="x">chaperone-procedure</a></span>, which can also be used to guard
+parameter procedures.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._parameter~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._parameter~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">parameter?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a parameter procedure,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._parameter-procedure~3d~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._parameter-procedure~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">parameter-procedure=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._parameter~3f%29%29" class="RktValLink" data-pltdoc="x">parameter?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._parameter~3f%29%29" class="RktValLink" data-pltdoc="x">parameter?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if the parameter procedures <span class="RktVar">a</span> and
+<span class="RktVar">b</span> always modify the same parameter with the same guards
+(although possibly with different <a href="chaperones.html#%28tech._chaperone%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperones</span></a>), <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/more-scheme..rkt)._current-parameterization))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="parameters.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._current-parameterization%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-parameterization</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._parameterization~3f%29%29" class="RktValLink" data-pltdoc="x">parameterization?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns the
+current continuation&rsquo;s <a href="eval-model.html#%28tech._parameterization%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameterization</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/more-scheme..rkt)._call-with-parameterization))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="parameters.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call-with-parameterization%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-parameterization</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">parameterization</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">thunk</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">parameterization</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._parameterization~3f%29%29" class="RktValLink" data-pltdoc="x">parameterization?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Calls <span class="RktVar">thunk</span> (via a tail call) with <span class="RktVar">parameterization</span>
+as the current <a href="eval-model.html#%28tech._parameterization%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameterization</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._parameterization~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="parameters.html#%28def._%28%28quote._~23~25kernel%29._parameterization~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">parameterization?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="eval-model.html#%28tech._parameterization%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameterization</span></a>
+returned by <span class="RktSym"><a href="parameters.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._current-parameterization%29%29" class="RktValLink" data-pltdoc="x">current-parameterization</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="threadcells.html" title="backward to &quot;11.3.1 Thread Cells&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="thread-local-storage.html" title="up to &quot;11.3 Thread-Local Storage&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="futures.html" title="forward to &quot;11.4 Futures&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/parametric-contracts.html b/clones/docs.racket-lang.org/reference/parametric-contracts.html
new file mode 100644
index 00000000..59c19754
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/parametric-contracts.html
@@ -0,0 +1,34 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>8.3&nbsp;Parametric Contracts</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.1&nbsp;</td><td><a href="data-structure-contracts.html" class="tocviewlink" data-pltdoc="x">Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.2&nbsp;</td><td><a href="function-contracts.html" class="tocviewlink" data-pltdoc="x">Function Contracts</a></td></tr><tr><td align="right">8.3&nbsp;</td><td><a href="parametric-contracts.html" class="tocviewselflink" data-pltdoc="x">Parametric Contracts</a></td></tr><tr><td align="right">8.4&nbsp;</td><td><a href="Lazy_Data-structure_Contracts.html" class="tocviewlink" data-pltdoc="x">Lazy Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.5&nbsp;</td><td><a href="Structure_Type_Property_Contracts.html" class="tocviewlink" data-pltdoc="x">Structure Type Property Contracts</a></td></tr><tr><td align="right">8.6&nbsp;</td><td><a href="attaching-contracts-to-values.html" class="tocviewlink" data-pltdoc="x">Attaching Contracts to Values</a></td></tr><tr><td align="right">8.7&nbsp;</td><td><a href="Building_New_Contract_Combinators.html" class="tocviewlink" data-pltdoc="x">Building New Contract Combinators</a></td></tr><tr><td align="right">8.8&nbsp;</td><td><a href="contract-utilities.html" class="tocviewlink" data-pltdoc="x">Contract Utilities</a></td></tr><tr><td align="right">8.9&nbsp;</td><td><a href="racket_contract_base.html" class="tocviewlink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>contract/<span class="mywbr"> &nbsp;</span>base</span></span></a></td></tr><tr><td align="right">8.10&nbsp;</td><td><a href="collapsible.html" class="tocviewlink" data-pltdoc="x">Collapsible Contracts</a></td></tr><tr><td align="right">8.11&nbsp;</td><td><a href="Legacy_Contracts.html" class="tocviewlink" data-pltdoc="x">Legacy Contracts</a></td></tr><tr><td align="right">8.12&nbsp;</td><td><a href="Random_generation.html" class="tocviewlink" data-pltdoc="x">Random generation</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="parametric-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._parametric-~3e%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">parametric-<wbr></wbr>&gt;/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="parametric-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._new-~e2~88~80%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">new-<wbr></wbr>∀/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="parametric-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._new-~e2~88~83%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">new-<wbr></wbr>∃/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="function-contracts.html" title="backward to &quot;8.2 Function Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Lazy_Data-structure_Contracts.html" title="forward to &quot;8.4 Lazy Data-structure Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parametric-contracts&quot;">8.3<tt>&nbsp;</tt><a name="(part._parametric-contracts)"></a><a name="(mod-path._racket/contract/parametric)"></a>Parametric Contracts</h4><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="parametric-contracts.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/contract/parametric</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></p><p>The most convenient way to use parametric contract is to use
+<span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._contract-out%29%29" class="RktStxLink" data-pltdoc="x">contract-out</a></span>&rsquo;s <span class="RktPn">#:exists</span> keyword.
+The <a href="parametric-contracts.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/contract/parametric</span></a> provides a few more,
+general-purpose parametric contracts.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/contract/parametric..rkt)._parametric-~3e/c))"></a><span title="Provided from: racket/contract/parametric, racket/contract, racket | Package: base"><span class="RktSym"><a href="parametric-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._parametric-~3e%2Fc%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">parametric-&gt;/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Creates a contract for parametric polymorphic functions.  Each function is
+protected by <span class="RktVar">c</span>, where each <span class="RktVar">x</span> is bound in <span class="RktVar">c</span> and refers
+to a polymorphic type that is instantiated each time the function is applied.</div></p><p>At each application of a function, the <span class="RktSym"><a href="parametric-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._parametric-~3e%2Fc%29%29" class="RktStxLink" data-pltdoc="x">parametric-&gt;/c</a></span> contract constructs
+a new opaque wrapper for each <span class="RktVar">x</span>; values flowing into the polymorphic
+function (i.e. values protected by some <span class="RktVar">x</span> in negative position with
+respect to <span class="RktSym"><a href="parametric-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._parametric-~3e%2Fc%29%29" class="RktStxLink" data-pltdoc="x">parametric-&gt;/c</a></span>) are wrapped in the corresponding opaque
+wrapper.  Values flowing out of the polymorphic function (i.e. values protected
+by some <span class="RktVar">x</span> in positive position with respect to <span class="RktSym"><a href="parametric-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._parametric-~3e%2Fc%29%29" class="RktStxLink" data-pltdoc="x">parametric-&gt;/c</a></span>)
+are checked for the appropriate wrapper.  If they have it, they are unwrapped;
+if they do not, a contract violation is signaled.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">swap-ctc</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parametric-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._parametric-~3e%2Fc%29%29" class="RktStxLink" data-pltdoc="x">parametric-&gt;/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">A</span><span class="hspace">&nbsp;</span><span class="RktSym">B</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">A</span><span class="hspace">&nbsp;</span><span class="RktSym">B</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">B</span><span class="hspace">&nbsp;</span><span class="RktSym">A</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">good-swap</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">swap-ctc</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">good-swap</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bad-swap</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">swap-ctc</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">bad-swap</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">bad-swap: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: B</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: #&lt;A&gt;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the range of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(parametric-&gt;/c (A B) (-&gt; A B (values B A)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (function bad-swap)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (function bad-swap)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:5:0</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">copy-first</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">swap-ctc</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">same-symbol</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">copy-first</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">copy-first: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: B</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: #&lt;A&gt;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the range of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(parametric-&gt;/c (A B) (-&gt; A B (values B A)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (function copy-first)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (function copy-first)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:7:0</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">inspect-first</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">swap-ctc</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-user-error%29%29" class="RktValLink" data-pltdoc="x">raise-user-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"an opaque wrapped value is not an integer"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">inspect-first</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">an opaque wrapped value is not an integer</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/parametric..rkt)._new-~e2~88~80/c))"></a><span title="Provided from: racket/contract/parametric, racket/contract, racket | Package: base"><span class="RktSym"><a href="parametric-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._new-~e2~88~80%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">new-&#8704;/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">name</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Constructs a new universal contract.</div></p><p>Universal contracts accept all values when in negative positions (e.g., function
+inputs) and wrap them in an opaque struct, hiding the precise value.
+In positive positions (e.g. function returns),
+a universal contract accepts only values that were previously accepted
+in negative positions (by checking for the wrappers).</p><p>The name is used to identify the contract in error messages and defaults
+to a name based on the lexical context of <span class="RktSym"><a href="parametric-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._new-~e2~88~80%2Fc%29%29" class="RktValLink" data-pltdoc="x">new-&#8704;/c</a></span>.</p><p><div class="SIntrapara">For example, this contract:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parametric-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._new-~e2~88~80%2Fc%29%29" class="RktValLink" data-pltdoc="x">new-&#8704;/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">describes the identity function (or a non-terminating function).
+That is, the first use of the <span class="RktSym">a</span> appears in a
+negative position and thus inputs to that function are wrapped with an opaque struct.
+Then, when the function returns, it is checked to determine whether the result is wrapped, since
+the second <span class="RktSym">a</span> appears in a positive position.</div></p><p>The <span class="RktSym"><a href="parametric-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._new-~e2~88~80%2Fc%29%29" class="RktValLink" data-pltdoc="x">new-&#8704;/c</a></span> contract constructor is dual to <span class="RktSym"><a href="parametric-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._new-~e2~88~83%2Fc%29%29" class="RktValLink" data-pltdoc="x">new-&#8707;/c</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/contract/parametric..rkt)._new-~e2~88~83/c))"></a><span title="Provided from: racket/contract/parametric, racket/contract, racket | Package: base"><span class="RktSym"><a href="parametric-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._new-~e2~88~83%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">new-&#8707;/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">name</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Constructs a new existential contract.</div></p><p>Existential contracts accept all values when in positive positions (e.g., function
+returns) and wrap them in an opaque struct, hiding the precise value.
+In negative positions (e.g. function inputs),
+they accepts only values that were previously accepted in positive positions (by checking
+for the wrappers).</p><p>The name is used to identify the contract in error messages and defaults
+to a name based on the lexical context of <span class="RktSym"><a href="parametric-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._new-~e2~88~80%2Fc%29%29" class="RktValLink" data-pltdoc="x">new-&#8704;/c</a></span>.</p><p><div class="SIntrapara">For example, this contract:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parametric-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._new-~e2~88~83%2Fc%29%29" class="RktValLink" data-pltdoc="x">new-&#8707;/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">describes a function that accepts the identity function (or a non-terminating function)
+and returns an arbitrary value. That is, the first use of the <span class="RktSym">a</span> appears in a
+positive position and thus inputs to that function are wrapped with an opaque struct.
+Then, when the function returns, it is checked to see if the result is wrapped, since
+the second <span class="RktSym">a</span> appears in a negative position.</div></p><p>The <span class="RktSym"><a href="parametric-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._new-~e2~88~83%2Fc%29%29" class="RktValLink" data-pltdoc="x">new-&#8707;/c</a></span> construct constructor is dual to <span class="RktSym"><a href="parametric-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fparametric..rkt%29._new-~e2~88~80%2Fc%29%29" class="RktValLink" data-pltdoc="x">new-&#8704;/c</a></span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="function-contracts.html" title="backward to &quot;8.2 Function Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Lazy_Data-structure_Contracts.html" title="forward to &quot;8.4 Lazy Data-structure Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/pathutils.html b/clones/docs.racket-lang.org/reference/pathutils.html
new file mode 100644
index 00000000..6fcc0822
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/pathutils.html
@@ -0,0 +1,30 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15.1&nbsp;Paths</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewselflink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewselflink" data-pltdoc="x">Paths</a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="Filesystem.html" class="tocviewlink" data-pltdoc="x">Filesystem</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="networking.html" class="tocviewlink" data-pltdoc="x">Networking</a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="subprocess.html" class="tocviewlink" data-pltdoc="x">Processes</a></td></tr><tr><td align="right">15.5&nbsp;</td><td><a href="logging.html" class="tocviewlink" data-pltdoc="x">Logging</a></td></tr><tr><td align="right">15.6&nbsp;</td><td><a href="time.html" class="tocviewlink" data-pltdoc="x">Time</a></td></tr><tr><td align="right">15.7&nbsp;</td><td><a href="envvars.html" class="tocviewlink" data-pltdoc="x">Environment Variables</a></td></tr><tr><td align="right">15.8&nbsp;</td><td><a href="runtime.html" class="tocviewlink" data-pltdoc="x">Environment and Runtime Information</a></td></tr><tr><td align="right">15.9&nbsp;</td><td><a href="Command-Line_Parsing.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Parsing</a></td></tr><tr><td align="right">15.10&nbsp;</td><td><a href="os-lib.html" class="tocviewlink" data-pltdoc="x">Additional Operating System Functions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewselflink" data-pltdoc="x">Paths</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1.1&nbsp;</td><td><a href="Manipulating_Paths.html" class="tocviewlink" data-pltdoc="x">Manipulating Paths</a></td></tr><tr><td align="right">15.1.2&nbsp;</td><td><a href="More_Path_Utilities.html" class="tocviewlink" data-pltdoc="x">More Path Utilities</a></td></tr><tr><td align="right">15.1.3&nbsp;</td><td><a href="unixpaths.html" class="tocviewlink" data-pltdoc="x">Unix and Mac OS Paths</a></td></tr><tr><td align="right">15.1.4&nbsp;</td><td><a href="windowspaths.html" class="tocviewlink" data-pltdoc="x">Windows Paths</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="os.html" title="backward to &quot;15 Operating System&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="os.html" title="up to &quot;15 Operating System&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Manipulating_Paths.html" title="forward to &quot;15.1.1 Manipulating Paths&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;pathutils&quot;">15.1<tt>&nbsp;</tt><a name="(part._pathutils)"></a>Paths</h4><p>When a Racket procedure takes a filesystem path as an argument, the
+path can be provided either as a string or as an instance of the
+<a name="(tech._path)"></a><span style="font-style: italic">path</span> datatype. If a string is provided, it is converted to a
+path using <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._string-~3epath%29%29" class="RktValLink" data-pltdoc="x">string-&gt;path</a></span>. Beware that some paths may not
+be representable as strings; see <a href="unixpaths.html#%28part._unixpathrep%29" data-pltdoc="x">Unix Path Representation</a> and
+<a href="windowspaths.html#%28part._windowspathrep%29" data-pltdoc="x">Windows Path Representation</a> for more information.
+A Racket procedure that generates a
+filesystem path always generates a <a href="pathutils.html#%28tech._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">path</span></a> value.</p><p>By default, paths are created and manipulated for the current
+platform, but procedures that merely manipulate paths (without using
+the filesystem) can manipulate paths using conventions for other
+supported platforms. The <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;path</a></span> procedure accepts an
+optional argument that indicates the platform for the path, either
+<span class="RktVal">'</span><span class="RktVal">unix</span> or <span class="RktVal">'</span><span class="RktVal">windows</span>. For other functions, such as
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span> or <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._simplify-path%29%29" class="RktValLink" data-pltdoc="x">simplify-path</a></span>, the behavior is
+sensitive to the kind of path that is supplied. Unless otherwise
+specified, a procedure that requires a path accepts only paths for the
+current platform.</p><p>Two <a href="pathutils.html#%28tech._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">path</span></a> values are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> when they are use the same
+convention type and when their byte-string representations are
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>. A path string (or byte string) cannot be empty, and
+it cannot contain a nul character or byte. When an empty string or a
+string containing nul is provided as a path to any procedure except
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._absolute-path~3f%29%29" class="RktValLink" data-pltdoc="x">absolute-path?</a></span>, <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._relative-path~3f%29%29" class="RktValLink" data-pltdoc="x">relative-path?</a></span>, or
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span>, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>Most Racket primitives that accept paths first <a name="(tech._cleanse)"></a><span style="font-style: italic">cleanse</span> the
+path before using it. Procedures that build paths or merely check the
+form of a path do not cleanse paths, with the exceptions of
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._cleanse-path%29%29" class="RktValLink" data-pltdoc="x">cleanse-path</a></span>, <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._expand-user-path%29%29" class="RktValLink" data-pltdoc="x">expand-user-path</a></span>, and
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._simplify-path%29%29" class="RktValLink" data-pltdoc="x">simplify-path</a></span>.  For more information about path cleansing and
+other platform-specific details, see <a href="unixpaths.html" data-pltdoc="x">Unix and Mac OS Paths</a> and
+<a href="windowspaths.html" data-pltdoc="x">Windows Paths</a>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="os.html" title="backward to &quot;15 Operating System&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="os.html" title="up to &quot;15 Operating System&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Manipulating_Paths.html" title="forward to &quot;15.1.1 Manipulating Paths&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/performance-hint.html b/clones/docs.racket-lang.org/reference/performance-hint.html
new file mode 100644
index 00000000..ae997790
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/performance-hint.html
@@ -0,0 +1,12 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.25&nbsp;Performance Hints: begin-encourage-inline</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewselflink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="performance-hint.html#%28form._%28%28lib._racket%2Fperformance-hint..rkt%29._begin-encourage-inline%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td><a href="performance-hint.html#%28form._%28%28lib._racket%2Fperformance-hint..rkt%29._define-inline%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>inline</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stratified-body.html" title="backward to &quot;3.24 Internal-Definition Limiting: #%stratified-body&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="lazy-require.html" title="forward to &quot;3.26 Importing Modules Lazily: lazy-require&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;performance-hint&quot;">3.25<tt>&nbsp;</tt><a name="(part._performance-hint)"></a><a name="(mod-path._racket/performance-hint)"></a>Performance Hints: <span class="RktSym"><a href="performance-hint.html#%28form._%28%28lib._racket%2Fperformance-hint..rkt%29._begin-encourage-inline%29%29" class="RktStxLink" data-pltdoc="x">begin-encourage-inline</a></span></h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="performance-hint.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/performance-hint</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="performance-hint.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/performance-hint</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/performance-hint..rkt)._begin-encourage-inline))"></a><span title="Provided from: racket/performance-hint | Package: base"><span class="RktSym"><a href="performance-hint.html#%28form._%28%28lib._racket%2Fperformance-hint..rkt%29._begin-encourage-inline%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">begin-encourage-inline</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Attaches a <span class="RktVal">'</span><span class="RktVal">compiler-hint:cross-module-inline</span>
+<a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax property</span></a> to each <span class="RktVar">form</span>, which is useful when a
+<span class="RktVar">form</span> is a function definition. See <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span>.</div></p><p>The <span class="RktSym"><a href="performance-hint.html#%28form._%28%28lib._racket%2Fperformance-hint..rkt%29._begin-encourage-inline%29%29" class="RktStxLink" data-pltdoc="x">begin-encourage-inline</a></span> form is also provided by the
+<span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxLink" data-pltdoc="x">submod</a></span><span class="stt"> </span><span class="RktSym">racket/performance-hint</span><span class="stt"> </span><span class="RktSym"><a href="performance-hint.html#%28form._%28%28lib._racket%2Fperformance-hint..rkt%29._begin-encourage-inline%29%29" class="RktStxLink" data-pltdoc="x">begin-encourage-inline</a></span><span class="RktPn">)</span> module,
+which has fewer dependencies than <a href="performance-hint.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/performance-hint</span></a>.</p><p class="SHistory">Changed in version 6.2 of package <span class="stt">base</span>: Added the <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxLink" data-pltdoc="x">submod</a></span><span class="stt"> </span><span class="RktSym">racket/performance-hint</span><span class="stt"> </span><span class="RktSym"><a href="performance-hint.html#%28form._%28%28lib._racket%2Fperformance-hint..rkt%29._begin-encourage-inline%29%29" class="RktStxLink" data-pltdoc="x">begin-encourage-inline</a></span><span class="RktPn">)</span> submodule.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/performance-hint..rkt)._define-inline))"></a><span title="Provided from: racket/performance-hint | Package: base"><span class="RktSym"><a href="performance-hint.html#%28form._%28%28lib._racket%2Fperformance-hint..rkt%29._define-inline%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-inline</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="performance-hint.html#%28form._%28%28lib._racket%2Fperformance-hint..rkt%29._define-inline%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-inline</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">head</span><span class="hspace">&nbsp;</span><span class="RktVar">args</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">head</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">head</span><span class="hspace">&nbsp;</span><span class="RktVar">args</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">args</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktPn">.</span><span class="hspace">&nbsp;</span><span class="RktVar">rest-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">arg</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">arg-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">arg-id</span><span class="hspace">&nbsp;</span><span class="RktVar">default-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktVar">arg-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">arg-id</span><span class="hspace">&nbsp;</span><span class="RktVar">default-expr</span><span class="RktPn">]</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span>, but ensures that the definition will be inlined at its
+call sites. Recursive calls are not inlined, to avoid infinite inlining.
+Higher-order uses are supported, but also not inlined. Misapplication (by
+supplying the wrong number of arguments or incorrect keyword arguments) is
+also not inlined and left as a run-time error.</div></p><p>The <span class="RktSym"><a href="performance-hint.html#%28form._%28%28lib._racket%2Fperformance-hint..rkt%29._define-inline%29%29" class="RktStxLink" data-pltdoc="x">define-inline</a></span> form may interfere with the Racket compiler&rsquo;s own inlining
+heuristics, and should only be used when other inlining attempts (such as
+<span class="RktSym"><a href="performance-hint.html#%28form._%28%28lib._racket%2Fperformance-hint..rkt%29._begin-encourage-inline%29%29" class="RktStxLink" data-pltdoc="x">begin-encourage-inline</a></span>) fail.</p><p class="SHistory">Changed in version 8.1.0.5 of package <span class="stt">base</span>: Changed to treat misapplication as a run-time error.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stratified-body.html" title="backward to &quot;3.24 Internal-Definition Limiting: #%stratified-body&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="lazy-require.html" title="forward to &quot;3.26 Importing Modules Lazily: lazy-require&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/phantom-bytes.html b/clones/docs.racket-lang.org/reference/phantom-bytes.html
new file mode 100644
index 00000000..8e1baf5e
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/phantom-bytes.html
@@ -0,0 +1,19 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>16.5&nbsp;Phantom Byte Strings</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewselflink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.1&nbsp;</td><td><a href="weakbox.html" class="tocviewlink" data-pltdoc="x">Weak Boxes</a></td></tr><tr><td align="right">16.2&nbsp;</td><td><a href="ephemerons.html" class="tocviewlink" data-pltdoc="x">Ephemerons</a></td></tr><tr><td align="right">16.3&nbsp;</td><td><a href="willexecutor.html" class="tocviewlink" data-pltdoc="x">Wills and Executors</a></td></tr><tr><td align="right">16.4&nbsp;</td><td><a href="garbagecollection.html" class="tocviewlink" data-pltdoc="x">Garbage Collection</a></td></tr><tr><td align="right">16.5&nbsp;</td><td><a href="phantom-bytes.html" class="tocviewselflink" data-pltdoc="x">Phantom Byte Strings</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="phantom-bytes.html#%28def._%28%28quote._~23~25kernel%29._phantom-bytes~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">phantom-<wbr></wbr>bytes?</span></span></a></td></tr><tr><td><a href="phantom-bytes.html#%28def._%28%28quote._~23~25kernel%29._make-phantom-bytes%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>phantom-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><a href="phantom-bytes.html#%28def._%28%28quote._~23~25kernel%29._set-phantom-bytes%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>phantom-<wbr></wbr>bytes!</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="garbagecollection.html" title="backward to &quot;16.4 Garbage Collection&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="memory.html" title="up to &quot;16 Memory Management&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="unsafe.html" title="forward to &quot;17 Unsafe Operations&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;phantom-bytes&quot;">16.5<tt>&nbsp;</tt><a name="(part._phantom-bytes)"></a>Phantom Byte Strings</h4><p>A <a name="(tech._phantom._byte._string)"></a><span style="font-style: italic">phantom byte string</span> is a small Racket value that is
+treated by the Racket memory manager as having an arbitrary size,
+which is specified when the <a href="phantom-bytes.html#%28tech._phantom._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">phantom byte string</span></a> is created or
+when it is changed via <span class="RktSym"><a href="phantom-bytes.html#%28def._%28%28quote._~23~25kernel%29._set-phantom-bytes%21%29%29" class="RktValLink" data-pltdoc="x">set-phantom-bytes!</a></span>.</p><p>A <a href="phantom-bytes.html#%28tech._phantom._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">phantom byte string</span></a> acts as a hint to Racket&rsquo;s memory
+manager that memory is allocated within the process but through a
+separate allocator, such as through a foreign library that is accessed
+via <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">ffi/unsafe</span></a>. This hint is used to trigger
+<a href="eval-model.html#%28tech._garbage._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">garbage collections</span></a> or to compute the result of
+<span class="RktSym"><a href="garbagecollection.html#%28def._%28%28quote._~23~25kernel%29._current-memory-use%29%29" class="RktValLink" data-pltdoc="x">current-memory-use</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._phantom-bytes~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="phantom-bytes.html#%28def._%28%28quote._~23~25kernel%29._phantom-bytes~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">phantom-bytes?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="phantom-bytes.html#%28tech._phantom._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">phantom byte string</span></a>,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-phantom-bytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="phantom-bytes.html#%28def._%28%28quote._~23~25kernel%29._make-phantom-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-phantom-bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="phantom-bytes.html#%28def._%28%28quote._~23~25kernel%29._phantom-bytes~3f%29%29" class="RktValLink" data-pltdoc="x">phantom-bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a <a href="phantom-bytes.html#%28tech._phantom._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">phantom byte string</span></a> that is treated by the Racket
+memory manager as being <span class="RktVar">k</span> bytes in size. For a large enough
+<span class="RktVar">k</span>, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aout-of-memory%29%29" class="RktValLink" data-pltdoc="x">exn:fail:out-of-memory</a></span> exception is raised&#8212;<wbr></wbr>either because the
+size is implausibly large, or because a memory limit has been
+installed with <span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-limit-memory%29%29" class="RktValLink" data-pltdoc="x">custodian-limit-memory</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._set-phantom-bytes!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="phantom-bytes.html#%28def._%28%28quote._~23~25kernel%29._set-phantom-bytes%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-phantom-bytes!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">phantom-bstr</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="phantom-bytes.html#%28def._%28%28quote._~23~25kernel%29._phantom-bytes~3f%29%29" class="RktValLink" data-pltdoc="x">phantom-bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">phantom-bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="phantom-bytes.html#%28def._%28%28quote._~23~25kernel%29._phantom-bytes~3f%29%29" class="RktValLink" data-pltdoc="x">phantom-bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Adjusts the size of a <a href="phantom-bytes.html#%28tech._phantom._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">phantom byte string</span></a> as it is treated by
+the Racket memory manager.</div></p><p>For example, if the memory that <span class="RktVar">phantom-bstr</span> represents is
+released through a foreign library, then <span class="RktPn">(</span><span class="RktSym"><a href="phantom-bytes.html#%28def._%28%28quote._~23~25kernel%29._set-phantom-bytes%21%29%29" class="RktValLink" data-pltdoc="x">set-phantom-bytes!</a></span><span class="stt"> </span><span class="RktVar">phantom-bstr</span><span class="stt"> </span><span class="RktVal">0</span><span class="RktPn">)</span> can reflect the change in memory use.</p><p>When <span class="RktVar">k</span> is larger than the current size of
+<span class="RktVar">phantom-bstr</span>, then this function can raise
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aout-of-memory%29%29" class="RktValLink" data-pltdoc="x">exn:fail:out-of-memory</a></span>, like <span class="RktSym"><a href="phantom-bytes.html#%28def._%28%28quote._~23~25kernel%29._make-phantom-bytes%29%29" class="RktValLink" data-pltdoc="x">make-phantom-bytes</a></span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="garbagecollection.html" title="backward to &quot;16.4 Garbage Collection&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="memory.html" title="up to &quot;16 Memory Management&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="unsafe.html" title="forward to &quot;17 Unsafe Operations&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/phase_space.html b/clones/docs.racket-lang.org/reference/phase_space.html
new file mode 100644
index 00000000..ad4e079d
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/phase_space.html
@@ -0,0 +1,39 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>12.13&nbsp;Phase and Space Utilities</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">12.1&nbsp;</td><td><a href="stx-patterns.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Syntax Matching</a></td></tr><tr><td align="right">12.2&nbsp;</td><td><a href="stxops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Content</a></td></tr><tr><td align="right">12.3&nbsp;</td><td><a href="stxcmp.html" class="tocviewlink" data-pltdoc="x">Syntax Object Bindings</a></td></tr><tr><td align="right">12.4&nbsp;</td><td><a href="stxtrans.html" class="tocviewlink" data-pltdoc="x">Syntax Transformers</a></td></tr><tr><td align="right">12.5&nbsp;</td><td><a href="stxparam.html" class="tocviewlink" data-pltdoc="x">Syntax Parameters</a></td></tr><tr><td align="right">12.6&nbsp;</td><td><a href="splicing.html" class="tocviewlink" data-pltdoc="x">Local Binding with Splicing Body</a></td></tr><tr><td align="right">12.7&nbsp;</td><td><a href="stxprops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Properties</a></td></tr><tr><td align="right">12.8&nbsp;</td><td><a href="stxcerts.html" class="tocviewlink" data-pltdoc="x">Syntax Taints</a></td></tr><tr><td align="right">12.9&nbsp;</td><td><a href="Expanding_Top-Level_Forms.html" class="tocviewlink" data-pltdoc="x">Expanding Top-<wbr></wbr>Level Forms</a></td></tr><tr><td align="right">12.10&nbsp;</td><td><a href="Serializing_Syntax.html" class="tocviewlink" data-pltdoc="x">Serializing Syntax</a></td></tr><tr><td align="right">12.11&nbsp;</td><td><a href="include.html" class="tocviewlink" data-pltdoc="x">File Inclusion</a></td></tr><tr><td align="right">12.12&nbsp;</td><td><a href="syntax-util.html" class="tocviewlink" data-pltdoc="x">Syntax Utilities</a></td></tr><tr><td align="right">12.13&nbsp;</td><td><a href="phase_space.html" class="tocviewselflink" data-pltdoc="x">Phase and Space Utilities</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">phase?</span></span></a></td></tr><tr><td><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._space~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">space?</span></span></a></td></tr><tr><td><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">phase+<span class="mywbr"> &nbsp;</span>space?</span></span></a></td></tr><tr><td><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">phase+<span class="mywbr"> &nbsp;</span>space</span></span></a></td></tr><tr><td><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-phase%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">phase+<span class="mywbr"> &nbsp;</span>space-<wbr></wbr>phase</span></span></a></td></tr><tr><td><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-space%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">phase+<span class="mywbr"> &nbsp;</span>space-<wbr></wbr>space</span></span></a></td></tr><tr><td><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-shift~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">phase+<span class="mywbr"> &nbsp;</span>space-<wbr></wbr>shift?</span></span></a></td></tr><tr><td><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace%2B%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">phase+<span class="mywbr"> &nbsp;</span>space+</span></span></a></td></tr><tr><td><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-shift%2B%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">phase+<span class="mywbr"> &nbsp;</span>space-<wbr></wbr>shift+</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="syntax-util.html" title="backward to &quot;12.12 Syntax Utilities&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="input-and-output.html" title="forward to &quot;13 Input and Output&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;phase+space&quot;">12.13<tt>&nbsp;</tt><a name="(part._phase+space)"></a><a name="(mod-path._racket/phase+space)"></a>Phase and Space Utilities</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="phase_space.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/phase+space</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="phase_space.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/phase+space</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p>The <a href="phase_space.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/phase+space</span></a> library provides functions for
+manipulating combined representations of <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase levels</span></a> and
+<a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding spaces</span></a>, particularly as used for <a href="stxtrans.html#%28tech._require._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">require
+transformers</span></a> and <a href="stxtrans.html#%28tech._provide._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide transformers</span></a>.</p><p>When <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="RktValLink" data-pltdoc="x">identifier-binding</a></span> (and related functions, like
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-transformer-binding%29%29" class="RktValLink" data-pltdoc="x">identifier-transformer-binding</a></span>),
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-module-exports%29%29" class="RktValLink" data-pltdoc="x">syntax-local-module-exports</a></span>,
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-module-required-identifiers%29%29" class="RktValLink" data-pltdoc="x">syntax-local-module-required-identifiers</a></span>,
+<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-exports%29%29" class="RktValLink" data-pltdoc="x">module-compiled-exports</a></span>, or <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-~3eexports%29%29" class="RktValLink" data-pltdoc="x">module-&gt;exports</a></span> produces
+a phase&ndash;space combination (or phase&ndash;space shift combination), then
+two such values that are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> will be <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>.</p><p class="SHistory">Added in version 8.2.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/phase+space..rkt)._phase~3f))"></a><span title="Provided from: racket/phase+space | Package: base"><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">phase?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a valid representation of a
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>, <span class="RktVal">#f</span> otherwise. A valid representation
+is either an exact integer representing a numbered
+phase level or <span class="RktVal">#f</span> representing the <a href="syntax-model.html#%28tech._label._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">label phase level</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/phase+space..rkt)._space~3f))"></a><span title="Provided from: racket/phase+space | Package: base"><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._space~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">space?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a valid representation of a
+<a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a>, <span class="RktVal">#f</span> otherwise. A valid representation
+is either an <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> symbol representing the space whose
+scope is accessed via <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-interned-syntax-introducer%29%29" class="RktValLink" data-pltdoc="x">make-interned-syntax-introducer</a></span>, or
+<span class="RktVal">#f</span> representing the default binding space.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/phase+space..rkt)._phase+space~3f))"></a><span title="Provided from: racket/phase+space | Package: base"><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">phase+space?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a valid representation of a
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> and <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a> combination,
+<span class="RktVal">#f</span> otherwise. The possible
+representations are as follows:</div></p><ul><li><p>a phase (in the sense of <span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase~3f%29%29" class="RktValLink" data-pltdoc="x">phase?</a></span>) by itself, which
+represents that phase plus the default binding space</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is a phase and whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is
+a non-<span class="RktVal">#f</span> space (in the sense of <span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._space~3f%29%29" class="RktValLink" data-pltdoc="x">space?</a></span>)</p></li></ul><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/phase+space..rkt)._phase+space))"></a><span title="Provided from: racket/phase+space | Package: base"><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace%29%29" class="RktValDef RktValLink" data-pltdoc="x">phase+space</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">phase</span><span class="hspace">&nbsp;</span><span class="RktVar">space</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">phase</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase~3f%29%29" class="RktValLink" data-pltdoc="x">phase?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">space</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._space~3f%29%29" class="RktValLink" data-pltdoc="x">space?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a value to represent the combination of <span class="RktVar">phase</span> and
+<span class="RktVar">space</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/phase+space..rkt)._phase+space-phase))"></a><span title="Provided from: racket/phase+space | Package: base"><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-phase%29%29" class="RktValDef RktValLink" data-pltdoc="x">phase+space-phase</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p+s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase~3f%29%29" class="RktValLink" data-pltdoc="x">phase?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p+s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/phase+space..rkt)._phase+space-space))"></a><span title="Provided from: racket/phase+space | Package: base"><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-space%29%29" class="RktValDef RktValLink" data-pltdoc="x">phase+space-space</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p+s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase~3f%29%29" class="RktValLink" data-pltdoc="x">phase?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p+s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Extracts the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> or <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a> component from
+a combination.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/phase+space..rkt)._phase+space-shift~3f))"></a><span title="Provided from: racket/phase+space | Package: base"><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-shift~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">phase+space-shift?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a valid representation of a
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> shift and <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a> shift combination,
+<span class="RktVal">#f</span> otherwise. A
+shift can be applied to a combination of a phase level and binding
+space using <span class="RktSym">phase+shift+</span>. The possible representations of a
+shift are as follows:</div></p><ul><li><p>exact integer &#8212;<wbr></wbr> represents an amount to shift a phase level
+                  and no change to the binding space</p></li><li><p><span class="RktVal">#f</span> &#8212;<wbr></wbr> represents a shift to the <a href="syntax-model.html#%28tech._label._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">label phase level</span></a>
+                and no change to the binding space</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is an exact integer or <span class="RktVal">#f</span>,
+and whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a space (in the sense of
+<span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._space~3f%29%29" class="RktValLink" data-pltdoc="x">space?</a></span>) &#8212;<wbr></wbr> represents a phase level shift in the
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> and a change to the binding space that is in the
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span></p></li></ul><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/phase+space..rkt)._phase+space+))"></a><span title="Provided from: racket/phase+space | Package: base"><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace%2B%29%29" class="RktValDef RktValLink" data-pltdoc="x">phase+space+</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p+s</span><span class="hspace">&nbsp;</span><span class="RktVar">shift</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p+s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">shift</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-shift~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space-shift?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Applies <span class="RktVar">shift</span> to <span class="RktVar">p+s</span> to produce a new combination of
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> and <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/phase+space..rkt)._phase+space-shift+))"></a><span title="Provided from: racket/phase+space | Package: base"><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-shift%2B%29%29" class="RktValDef RktValLink" data-pltdoc="x">phase+space-shift+</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">shift</span><span class="hspace">&nbsp;</span><span class="RktVar">additional-shift</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-shift~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space-shift?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">shift</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">additional-shift</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-shift~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space-shift?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Composes <span class="RktVar">shift</span> and <span class="RktVar">additional-shift</span> to produce a new
+shift that behaves the same as applying <span class="RktVar">shift</span> followed by
+<span class="RktVar">additional-shift</span>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="syntax-util.html" title="backward to &quot;12.12 Syntax Utilities&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="input-and-output.html" title="forward to &quot;13 Input and Output&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/pipeports.html b/clones/docs.racket-lang.org/reference/pipeports.html
new file mode 100644
index 00000000..e0f680ec
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/pipeports.html
@@ -0,0 +1,23 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.1.7&nbsp;Pipes</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewselflink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1.1&nbsp;</td><td><a href="encodings.html" class="tocviewlink" data-pltdoc="x">Encodings and Locales</a></td></tr><tr><td align="right">13.1.2&nbsp;</td><td><a href="port-ops.html" class="tocviewlink" data-pltdoc="x">Managing Ports</a></td></tr><tr><td align="right">13.1.3&nbsp;</td><td><a href="port-buffers.html" class="tocviewlink" data-pltdoc="x">Port Buffers and Positions</a></td></tr><tr><td align="right">13.1.4&nbsp;</td><td><a href="linecol.html" class="tocviewlink" data-pltdoc="x">Counting Positions, Lines, and Columns</a></td></tr><tr><td align="right">13.1.5&nbsp;</td><td><a href="file-ports.html" class="tocviewlink" data-pltdoc="x">File Ports</a></td></tr><tr><td align="right">13.1.6&nbsp;</td><td><a href="stringport.html" class="tocviewlink" data-pltdoc="x">String Ports</a></td></tr><tr><td align="right">13.1.7&nbsp;</td><td><a href="pipeports.html" class="tocviewselflink" data-pltdoc="x">Pipes</a></td></tr><tr><td align="right">13.1.8&nbsp;</td><td><a href="portstructs.html" class="tocviewlink" data-pltdoc="x">Structures as Ports</a></td></tr><tr><td align="right">13.1.9&nbsp;</td><td><a href="customport.html" class="tocviewlink" data-pltdoc="x">Custom Ports</a></td></tr><tr><td align="right">13.1.10&nbsp;</td><td><a href="port-lib.html" class="tocviewlink" data-pltdoc="x">More Port Constructors, Procedures, and Events</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="pipeports.html#%28def._%28%28quote._~23~25kernel%29._make-pipe%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>pipe</span></span></a></td></tr><tr><td><a href="pipeports.html#%28def._%28%28quote._~23~25kernel%29._pipe-content-length%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pipe-<wbr></wbr>content-<wbr></wbr>length</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stringport.html" title="backward to &quot;13.1.6 String Ports&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ports.html" title="up to &quot;13.1 Ports&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="portstructs.html" title="forward to &quot;13.1.8 Structures as Ports&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;pipeports&quot;">13.1.7<tt>&nbsp;</tt><a name="(part._pipeports)"></a>Pipes</h5><p>A Racket <a name="(tech._pipe)"></a><span style="font-style: italic">pipe</span> is internal to Racket, and not related to
+OS-level pipes for communicating between different
+processes.<span class="refelem"><span class="refcolumn"><span class="refcontent">OS-level pipes may be created by
+<span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess%29%29" class="RktValLink" data-pltdoc="x">subprocess</a></span>, opening an existing named file on a Unix
+filesystem, or starting Racket with pipes for its original input,
+output, or error port. Such pipes are <a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file-stream ports</span></a>,
+unlike the pipes produced by <span class="RktSym"><a href="pipeports.html#%28def._%28%28quote._~23~25kernel%29._make-pipe%29%29" class="RktValLink" data-pltdoc="x">make-pipe</a></span>.</span></span></span></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-pipe))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pipeports.html#%28def._%28%28quote._~23~25kernel%29._make-pipe%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-pipe</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">limit</span><span class="hspace">&nbsp;</span><span class="RktVar">input-name</span><span class="hspace">&nbsp;</span><span class="RktVar">output-name</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">pipe</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">output-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">pipe</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns two port values: the first port is an input port and the
+second is an output port. Data written to the output port is read from
+the input port, with no intermediate buffering. Unlike some other
+kinds of ports, pipe ports do not need to be explicitly closed to be
+reclaimed by <a href="eval-model.html#%28part._gc-model%29" data-pltdoc="x">garbage collection</a>.</div></p><p>If <span class="RktVar">limit</span> is <span class="RktVal">#f</span>, the new pipe holds an unlimited
+number of unread bytes (i.e., limited only by the available
+memory). If <span class="RktVar">limit</span> is a positive number, then the pipe will
+hold at most <span class="RktVar">limit</span> unread/unpeeked bytes; writing to the
+pipe&rsquo;s output port thereafter will block until a read or peek from the
+input port makes more space available. (Peeks effectively extend the
+port&rsquo;s capacity until the peeked bytes are read.)</p><p>The optional <span class="RktVar">input-name</span> and <span class="RktVar">output-name</span> are used
+as the names for the returned input and output ports, respectively.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._pipe-content-length))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="pipeports.html#%28def._%28%28quote._~23~25kernel%29._pipe-content-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">pipe-content-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">pipe-port</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pipe-port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._port~3f%29%29" class="RktValLink" data-pltdoc="x">port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the number of bytes contained in a pipe, where
+<span class="RktVar">pipe-port</span> is either of the pipe&rsquo;s ports produced by
+<span class="RktSym"><a href="pipeports.html#%28def._%28%28quote._~23~25kernel%29._make-pipe%29%29" class="RktValLink" data-pltdoc="x">make-pipe</a></span>. The pipe&rsquo;s content length counts all bytes that
+have been written to the pipe and not yet read (though possibly
+peeked).</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stringport.html" title="backward to &quot;13.1.6 String Ports&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ports.html" title="up to &quot;13.1 Ports&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="portstructs.html" title="forward to &quot;13.1.8 Structures as Ports&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/places.html b/clones/docs.racket-lang.org/reference/places.html
new file mode 100644
index 00000000..e0fa24d7
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/places.html
@@ -0,0 +1,215 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>11.5&nbsp;Places</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewselflink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.1&nbsp;</td><td><a href="threads.html" class="tocviewlink" data-pltdoc="x">Threads</a></td></tr><tr><td align="right">11.2&nbsp;</td><td><a href="all-sync.html" class="tocviewlink" data-pltdoc="x">Synchronization</a></td></tr><tr><td align="right">11.3&nbsp;</td><td><a href="thread-local-storage.html" class="tocviewlink" data-pltdoc="x">Thread-<wbr></wbr>Local Storage</a></td></tr><tr><td align="right">11.4&nbsp;</td><td><a href="futures.html" class="tocviewlink" data-pltdoc="x">Futures</a></td></tr><tr><td align="right">11.5&nbsp;</td><td><a href="places.html" class="tocviewselflink" data-pltdoc="x">Places</a></td></tr><tr><td align="right">11.6&nbsp;</td><td><a href="engine.html" class="tocviewlink" data-pltdoc="x">Engines</a></td></tr><tr><td align="right">11.7&nbsp;</td><td><a href="memory-order.html" class="tocviewlink" data-pltdoc="x">Machine Memory Order</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>11.5&nbsp;</td><td><a href="places.html" class="tocviewselflink" data-pltdoc="x">Places</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.5.1&nbsp;</td><td><a href="places.html#%28part._places-api%29" class="tocviewlink" data-pltdoc="x">Using Places</a></td></tr><tr><td align="right">11.5.2&nbsp;</td><td><a href="places.html#%28part._places-syntax%29" class="tocviewlink" data-pltdoc="x">Syntactic Support for Using Places</a></td></tr><tr><td align="right">11.5.3&nbsp;</td><td><a href="places.html#%28part._place-logging%29" class="tocviewlink" data-pltdoc="x">Places Logging</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">11.5.1<tt>&nbsp;</tt></span><a href="places.html#%28part._places-api%29" class="tocsubseclink" data-pltdoc="x">Using Places</a></td></tr><tr><td><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-enabled~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-<wbr></wbr>enabled?</span></span></a></td></tr><tr><td><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place?</span></span></a></td></tr><tr><td><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-<wbr></wbr>channel?</span></span></a></td></tr><tr><td><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-<wbr></wbr>place</span></span></a></td></tr><tr><td><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dynamic-<wbr></wbr>place*</span></span></a></td></tr><tr><td><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-wait%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-<wbr></wbr>wait</span></span></a></td></tr><tr><td><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-dead-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-<wbr></wbr>dead-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-kill%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-<wbr></wbr>kill</span></span></a></td></tr><tr><td><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-break%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-<wbr></wbr>break</span></span></a></td></tr><tr><td><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-<wbr></wbr>channel</span></span></a></td></tr><tr><td><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel-put%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-<wbr></wbr>channel-<wbr></wbr>put</span></span></a></td></tr><tr><td><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel-get%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-<wbr></wbr>channel-<wbr></wbr>get</span></span></a></td></tr><tr><td><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel-put%2Fget%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-<wbr></wbr>channel-<wbr></wbr>put/<span class="mywbr"> &nbsp;</span>get</span></span></a></td></tr><tr><td><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-message-allowed~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-<wbr></wbr>message-<wbr></wbr>allowed?</span></span></a></td></tr><tr><td><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._prop~3aplace-location%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>place-<wbr></wbr>location</span></span></a></td></tr><tr><td><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-location~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">place-<wbr></wbr>location?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">11.5.2<tt>&nbsp;</tt></span><a href="places.html#%28part._places-syntax%29" class="tocsubseclink" data-pltdoc="x">Syntactic Support for Using Places</a></td></tr><tr><td><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">place</span></span></a></td></tr><tr><td><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">place*</span></span></a></td></tr><tr><td><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%2Fcontext%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">place/<span class="mywbr"> &nbsp;</span>context</span></span></a></td></tr><tr><td><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._processor-count%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">processor-<wbr></wbr>count</span></span></a></td></tr><tr><td><span class="tocsublinknumber">11.5.3<tt>&nbsp;</tt></span><a href="places.html#%28part._place-logging%29" class="tocsubseclink" data-pltdoc="x">Places Logging</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="futures.html" title="backward to &quot;11.4 Futures&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="concurrency.html" title="up to &quot;11 Concurrency and Parallelism&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="engine.html" title="forward to &quot;11.6 Engines&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;places&quot;">11.5<tt>&nbsp;</tt><a name="(part._places)"></a><a name="(mod-path._racket/place)"></a><a name="(mod-path._racket/place/dynamic)"></a>Places</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=parallelism.html%23%2528part._effective-places%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Parallelism with Places</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces places.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="places.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/place</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr><tr><td align="left" colspan="2"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="places.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/place/dynamic</span></a><span class="RktPn">)</span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="places.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/place</span></a>, <a href="places.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/place/dynamic</span></a>, and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p><a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">Places</span></a> enable the development of parallel programs that
+take advantage of machines with multiple processors, cores, or
+hardware threads.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Currently, parallel support for places is enabled
+on all platforms that support Racket <a href="implementations.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a>, the default implementation of Racket.
+The <a href="implementations.html#%28tech._3m%29" class="techoutside" data-pltdoc="x"><span class="techinside">3m</span></a> implementation also supports parallel execution of places
+by default on Windows, Linux x86/x86_64, and Mac OS x86/x86_64. To
+enable support for other platforms with <a href="implementations.html#%28tech._3m%29" class="techoutside" data-pltdoc="x"><span class="techinside">3m</span></a>, use <span class="nobreak"><span class="stt">--enable-places</span></span> with
+<span class="stt">configure</span> when building Racket. The <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-enabled~3f%29%29" class="RktValLink" data-pltdoc="x">place-enabled?</a></span>
+function reports whether places run in parallel.</p><p>Implementation and operating-system constraints may limit the
+scalability of places. For example, although places can perform
+garbage collections in parallel in the <a href="implementations.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a> implementation or independently
+in the <a href="implementations.html#%28tech._3m%29" class="techoutside" data-pltdoc="x"><span class="techinside">3m</span></a> implementation, a garbage collection
+may need to manipulate a page table that is shared across all
+places, and that shared page table can be a bottleneck with enough
+places&#8212;<wbr></wbr>perhaps around 8 or 16.</p></blockquote></blockquote></blockquote><p>A <a name="(tech._place)"></a><span style="font-style: italic">place</span> is a parallel task that is effectively a separate
+instance of the Racket virtual machine, although all places run within
+a single operating-system process. Places communicate through
+<a name="(tech._place._channel)"></a><span style="font-style: italic">place channels</span>, which are endpoints for a two-way buffered
+communication.</p><p>To a first approximation, place channels support only immutable,
+transparent values as messages. In addition, place
+channels themselves can be sent across channels to establish new
+(possibly more direct) lines of communication in addition to any
+existing lines. Finally, mutable values produced by
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._shared-flvector%29%29" class="RktValLink" data-pltdoc="x">shared-flvector</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._make-shared-flvector%29%29" class="RktValLink" data-pltdoc="x">make-shared-flvector</a></span>,
+<span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._shared-fxvector%29%29" class="RktValLink" data-pltdoc="x">shared-fxvector</a></span>, <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._make-shared-fxvector%29%29" class="RktValLink" data-pltdoc="x">make-shared-fxvector</a></span>,
+<span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._shared-bytes%29%29" class="RktValLink" data-pltdoc="x">shared-bytes</a></span>, and <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._make-shared-bytes%29%29" class="RktValLink" data-pltdoc="x">make-shared-bytes</a></span> can be sent
+across place channels; mutation of such values is visible to all
+places that share the value, because they are allowed in a
+<a name="(tech._shared._memory._space)"></a><span style="font-style: italic">shared memory space</span>. See <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-message-allowed~3f%29%29" class="RktValLink" data-pltdoc="x">place-message-allowed?</a></span>.</p><p>A <a href="places.html#%28tech._place._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">place channel</span></a> can be used as a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a>
+(see <a href="sync.html" data-pltdoc="x">Events</a>) to receive a value through the channel.
+A <a href="places.html#%28tech._place._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">place channel</span></a> is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when
+a message is available on the channel, and the <a href="places.html#%28tech._place._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">place channel</span></a>&rsquo;s
+<a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> is the message (which is removed on
+synchronization). A place
+can also receive messages with <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel-get%29%29" class="RktValLink" data-pltdoc="x">place-channel-get</a></span>, and
+messages can be sent with <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel-put%29%29" class="RktValLink" data-pltdoc="x">place-channel-put</a></span>.</p><p>Two <a href="places.html#%28tech._place._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">place channels</span></a> are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> if they are endpoints
+for the same underlying channels while both or neither is a
+<a href="places.html#%28tech._place._descriptor%29" class="techoutside" data-pltdoc="x"><span class="techinside">place descriptor</span></a>. <a href="places.html#%28tech._place._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">Place channels</span></a> can be <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>
+without being <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> after being sent messages through a
+<a href="places.html#%28tech._place._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">place channel</span></a>.</p><p>Constraints on messages across a place channel&#8212;<wbr></wbr>and therefore on the
+kinds of data that places share&#8212;<wbr></wbr>enable greater parallelism than
+<span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._future%29%29" class="RktValLink" data-pltdoc="x">future</a></span>, even including separate <a href="eval-model.html#%28tech._garbage._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">garbage collection</span></a> of
+separate places. At the same time, the setup and communication costs
+for places can be higher than for <a href="futures.html#%28tech._future%29" class="techoutside" data-pltdoc="x"><span class="techinside">futures</span></a>.</p><p>For example, the following expression launches two places, echoes a
+message to each, and then waits for the places to terminate:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">pls</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%29%29" class="RktValLink" data-pltdoc="x">dynamic-place</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"place-worker.rkt"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">place-main</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktSym">pls</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel-put%29%29" class="RktValLink" data-pltdoc="x">place-channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel-get%29%29" class="RktValLink" data-pltdoc="x">place-channel-get</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-wait%29%29" class="RktValLink" data-pltdoc="x">place-wait</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pls</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The <span class="stt">"place-worker.rkt"</span> module (in a file that
+is separate from the above code) must export the
+<span class="RktSym">place-main</span> function that each place executes, where
+<span class="RktSym">place-main</span> must accept a single <a href="places.html#%28tech._place._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">place channel</span></a>
+argument:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"place-worker.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">place-main</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">place-main</span><span class="hspace">&nbsp;</span><span class="RktSym">pch</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel-put%29%29" class="RktValLink" data-pltdoc="x">place-channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Hello from place ~a"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel-get%29%29" class="RktValLink" data-pltdoc="x">place-channel-get</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pch</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>Place channels are subject to <a href="eval-model.html#%28tech._garbage._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">garbage collection</span></a>, like other
+Racket values, and a <a href="eval-model.html#%28tech._thread%29" class="techoutside" data-pltdoc="x"><span class="techinside">thread</span></a> that is blocked reading from a
+<a href="places.html#%28tech._place._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">place channel</span></a> can be garbage collected if <a href="places.html#%28tech._place._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">place
+channel</span></a>&rsquo;s writing end becomes unreachable. <a name="(elem._(caveat._place-channel-gc))"></a>However, unlike normal <a href="channel.html#%28tech._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">channel</span></a> blocking,
+if otherwise unreachable threads are mutually blocked on place
+channels that are reachable only from the same threads, the threads
+and place channels are all considered reachable, instead of
+unreachable.</p><p>When a place is created, its <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> values are generally set
+to the <span class="emph">initial</span> values of the parameters in the creating place,
+except that the <span class="emph">current</span> values of the following parameters are
+used: <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-paths</a></span>,
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-links%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-links</a></span>, and
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compiled-file-roots%29%29" class="RktValLink" data-pltdoc="x">current-compiled-file-roots</a></span>.</p><p>A newly created place is registered with the <a href="eval-model.html#%28tech._current._custodian%29" class="techoutside" data-pltdoc="x"><span class="techinside">current custodian</span></a>,
+so that the place is terminated when the custodian is shut down.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;places-api&quot;">11.5.1<tt>&nbsp;</tt><a name="(part._places-api)"></a>Using Places</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/place..rkt)._place-enabled~3f))"></a><span title="Provided from: racket/place, racket/place/dynamic, racket | Package: base"><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-enabled~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">place-enabled?</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if Racket is configured so that
+<span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%29%29" class="RktValLink" data-pltdoc="x">dynamic-place</a></span> and <span class="RktSym"><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%29%29" class="RktStxLink" data-pltdoc="x">place</a></span> create places that can run
+in parallel, <span class="RktVal">#f</span> if <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%29%29" class="RktValLink" data-pltdoc="x">dynamic-place</a></span> and <span class="RktSym"><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%29%29" class="RktStxLink" data-pltdoc="x">place</a></span>
+are simulated using <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/place..rkt)._place~3f))"></a><span title="Provided from: racket/place, racket/place/dynamic, racket | Package: base"><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">place?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a name="(tech._place._descriptor)"></a><span style="font-style: italic">place descriptor</span>
+value, <span class="RktVal">#f</span> otherwise. Every <a href="places.html#%28tech._place._descriptor%29" class="techoutside" data-pltdoc="x"><span class="techinside">place descriptor</span></a>
+is also a <a href="places.html#%28tech._place._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">place channel</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/place..rkt)._place-channel~3f))"></a><span title="Provided from: racket/place, racket/place/dynamic, racket | Package: base"><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">place-channel?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is <a href="places.html#%28tech._place._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">place channel</span></a>,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/place..rkt)._dynamic-place))"></a><span title="Provided from: racket/place, racket/place/dynamic, racket | Package: base"><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%29%29" class="RktValDef RktValLink" data-pltdoc="x">dynamic-place</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">module-path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start-name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:at</span><span class="hspace">&nbsp;</span><span class="RktVar">location</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:named</span><span class="hspace">&nbsp;</span><span class="RktVar">named</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place~3f%29%29" class="RktValLink" data-pltdoc="x">place?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">module-path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">location</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-location~3f%29%29" class="RktValLink" data-pltdoc="x">place-location?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">named</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a <a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">place</span></a> to run the procedure that is identified by
+ <span class="RktVar">module-path</span> and <span class="RktVar">start-name</span>. The result is a
+ <a href="places.html#%28tech._place._descriptor%29" class="techoutside" data-pltdoc="x"><span class="techinside">place descriptor</span></a> value that represents the new parallel task;
+ the place descriptor is returned immediately. The place descriptor
+ value is also a <a href="places.html#%28tech._place._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">place channel</span></a> that permits communication with
+ the place.</div></p><p>The module indicated by <span class="RktVar">module-path</span> must export a function
+ with the name <span class="RktVar">start-name</span>. The function must accept a single
+ argument, which is a <a href="places.html#%28tech._place._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">place channel</span></a> that corresponds to the
+ other end of communication for the <a href="places.html#%28tech._place._descriptor%29" class="techoutside" data-pltdoc="x"><span class="techinside">place descriptor</span></a> returned
+ by <span class="RktSym"><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%29%29" class="RktStxLink" data-pltdoc="x">place</a></span>.</p><p>If <span class="RktVar">location</span> is provided, it must be a <a href="places.html#%28tech._place._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">place location</span></a>,
+such as a distributed places node produced by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528def._%2528%2528lib._racket%252Fplace%252Fdistributed..rkt%2529._create-place-node%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">create-place-node</a></span>.</p><p>When the <a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">place</span></a> is created, the initial <a href="Exiting.html#%28tech._exit._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">exit handler</span></a>
+ terminates the place, using the argument to the exit handler as the
+ place&rsquo;s <a name="(tech._completion._value)"></a><span style="font-style: italic">completion value</span>. Use <span class="RktPn">(</span><span class="RktSym"><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._exit%29%29" class="RktValLink" data-pltdoc="x">exit</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span> to
+ immediately terminate a place with the completion value
+ <span class="RktVar">v</span>. Since a completion value is limited to an exact integer
+ between <span class="RktVal">0</span> and <span class="RktVal">255</span>, any other value for <span class="RktSym">v</span>
+ is converted to <span class="RktVal">0</span>.</p><p>If the function indicated by <span class="RktVar">module-path</span> and
+ <span class="RktVar">start-name</span> returns, then the place terminates with the
+ <a href="places.html#%28tech._completion._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">completion value</span></a> <span class="RktVal">0</span>.</p><p>In the created place, the <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span> parameter is
+ set to an empty input port, while the values of the
+ <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span> and <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-error-port%29%29" class="RktValLink" data-pltdoc="x">current-error-port</a></span>
+ parameters are connected to the current ports in the creating place.
+ If the output ports in the creating place are <a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file-stream
+ports</span></a>, then the connected ports in the created place share the
+ underlying streams, otherwise a <a href="eval-model.html#%28tech._thread%29" class="techoutside" data-pltdoc="x"><span class="techinside">thread</span></a> in the creating place
+ pumps bytes from the created place&rsquo;s ports to the current ports in the
+ creating place.</p><p>Most <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameters</span></a> in the created place have their original
+ initial values, but the created place inherits the creating place&rsquo;s
+ values for the following parameters: <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span>,
+ <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-paths</a></span>,
+ <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-links%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-links</a></span>,
+ and <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compiled-file-roots%29%29" class="RktValLink" data-pltdoc="x">current-compiled-file-roots</a></span>.</p><p>The <span class="RktVar">module-path</span> argument must not be a module path of the
+ form <span class="RktPn">(</span><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span><span class="stt"> </span><span class="RktVar">sym</span><span class="RktPn">)</span> unless the module is predefined (see
+ <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-predefined~3f%29%29" class="RktValLink" data-pltdoc="x">module-predefined?</a></span>).</p><p>The <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%29%29" class="RktValLink" data-pltdoc="x">dynamic-place</a></span> binding is protected in the sense of
+ <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._protect-out%29%29" class="RktStxLink" data-pltdoc="x">protect-out</a></span>, so access to this operation can be prevented
+ by adjusting the code inspector (see <a href="modprotect.html" data-pltdoc="x">Code Inspectors</a>).</p><p class="SHistory">Changed in version 8.2.0.7 of package <span class="stt">base</span>: Changed created place to inherit
+the creating place&rsquo;s <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span>
+value.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/place..rkt)._dynamic-place*))"></a><span title="Provided from: racket/place, racket/place/dynamic, racket | Package: base"><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">dynamic-place*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">module-path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start-name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:in</span><span class="hspace">&nbsp;</span><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:out</span><span class="hspace">&nbsp;</span><span class="RktVar">out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:err</span><span class="hspace">&nbsp;</span><span class="RktVar">err</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place~3f%29%29" class="RktValLink" data-pltdoc="x">place?</a></span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">module-path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">err</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-error-port%29%29" class="RktValLink" data-pltdoc="x">current-error-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%29%29" class="RktValLink" data-pltdoc="x">dynamic-place</a></span>, but accepts specific ports to the new
+ place&rsquo;s ports, and returns a created port when <span class="RktVal">#f</span> is
+ supplied for a port. The <span class="RktVar">in</span>, <span class="RktVar">out</span>, and
+ <span class="RktVar">err</span> ports are connected to the <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span>,
+ <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span>, and <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-error-port%29%29" class="RktValLink" data-pltdoc="x">current-error-port</a></span> ports,
+ respectively, for the
+ <a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">place</span></a>.  Any of the ports can be <span class="RktVal">#f</span>, in which case a
+ <a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file-stream port</span></a> (for an operating-system pipe)
+ is created and returned by <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%2A%29%29" class="RktValLink" data-pltdoc="x">dynamic-place*</a></span>. The
+ <span class="RktVar">err</span> argument can be <span class="RktVal">'</span><span class="RktVal">stdout</span>, in which case the
+ same <a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file-stream port</span></a> or that is supplied as standard
+ output is also used for standard error.  For each port or
+ <span class="RktVal">'</span><span class="RktVal">stdout</span> that is provided, no pipe is created and the
+ corresponding returned value is <span class="RktVal">#f</span>.</div></p><p>The caller of <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%2A%29%29" class="RktValLink" data-pltdoc="x">dynamic-place*</a></span> is responsible for closing all
+ returned ports; none are closed automatically.</p><p>The <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%2A%29%29" class="RktValLink" data-pltdoc="x">dynamic-place*</a></span> procedure returns four values:</p><ul><li><p>a place descriptor value representing the created place;</p></li><li><p>an output port piped to the place&rsquo;s standard input, or
+<span class="RktVal">#f</span> if <span class="RktVar">in</span> was a port;</p></li><li><p>an input port piped from the place&rsquo;s standard output, or
+<span class="RktVal">#f</span> if <span class="RktVar">out</span> was a port;</p></li><li><p>an input port piped from the place&rsquo;s standard error, or
+<span class="RktVal">#f</span> if <span class="RktVar">err</span> was a port or <span class="RktVal">'</span><span class="RktVal">stdout</span>.</p></li></ul><p>The <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%2A%29%29" class="RktValLink" data-pltdoc="x">dynamic-place*</a></span> binding is protected in the same way as
+ <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%29%29" class="RktValLink" data-pltdoc="x">dynamic-place</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/place..rkt)._place-wait))"></a><span title="Provided from: racket/place, racket/place/dynamic, racket | Package: base"><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-wait%29%29" class="RktValDef RktValLink" data-pltdoc="x">place-wait</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place~3f%29%29" class="RktValLink" data-pltdoc="x">place?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <a href="places.html#%28tech._completion._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">completion value</span></a> of the place indicated by <span class="RktVar">p</span>,
+blocking until the place has terminated.</div></p><p>If any pumping threads were created to connect a
+non-<a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file-stream port</span></a> to the ports in the place for <span class="RktVar">p</span>
+(see <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%29%29" class="RktValLink" data-pltdoc="x">dynamic-place</a></span>), <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-wait%29%29" class="RktValLink" data-pltdoc="x">place-wait</a></span> returns only when
+the pumping threads have completed.  </p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/place..rkt)._place-dead-evt))"></a><span title="Provided from: racket/place, racket/place/dynamic, racket | Package: base"><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-dead-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">place-dead-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place~3f%29%29" class="RktValLink" data-pltdoc="x">place?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> (see <a href="sync.html" data-pltdoc="x">Events</a>) that is
+<a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> if and only if <span class="RktVar">p</span> has terminated.
+The <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> of a place-dead event is the place-dead event itself.</div></p><p>If any pumping threads were created to connect a non-<a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file-stream
+port</span></a> to the ports in the place for <span class="RktVar">p</span> (see
+  <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%29%29" class="RktValLink" data-pltdoc="x">dynamic-place</a></span>), the event returned by
+  <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-dead-evt%29%29" class="RktValLink" data-pltdoc="x">place-dead-evt</a></span> may become ready even if a pumping thread is
+  still running.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/place..rkt)._place-kill))"></a><span title="Provided from: racket/place, racket/place/dynamic, racket | Package: base"><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-kill%29%29" class="RktValDef RktValLink" data-pltdoc="x">place-kill</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place~3f%29%29" class="RktValLink" data-pltdoc="x">place?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Immediately terminates the place, setting the place&rsquo;s
+<a href="places.html#%28tech._completion._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">completion value</span></a> to <span class="RktVal">1</span> if the place does not have a
+completion value already.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/place..rkt)._place-break))"></a><span title="Provided from: racket/place, racket/place/dynamic, racket | Package: base"><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-break%29%29" class="RktValDef RktValLink" data-pltdoc="x">place-break</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">kind</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place~3f%29%29" class="RktValLink" data-pltdoc="x">place?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">kind</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">hang-up</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">terminate</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Sends the main thread of place <span class="RktVar">p</span> a break; see <a href="breakhandler.html" data-pltdoc="x">Breaks</a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/place..rkt)._place-channel))"></a><span title="Provided from: racket/place, racket/place/dynamic, racket | Package: base"><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel%29%29" class="RktValDef RktValLink" data-pltdoc="x">place-channel</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel~3f%29%29" class="RktValLink" data-pltdoc="x">place-channel?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel~3f%29%29" class="RktValLink" data-pltdoc="x">place-channel?</a></span></td></tr></table></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns two <a href="places.html#%28tech._place._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">place channels</span></a>. Data sent through the first
+channel can be received through the second channel, and data sent
+through the second channel can be received from the first.</div></p><p>Typically, one place channel is used by the current <a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">place</span></a> to
+send messages to a destination <a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">place</span></a>; the other place channel
+is sent to the destination <a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">place</span></a> (via an existing <a href="places.html#%28tech._place._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">place
+channel</span></a>).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/place..rkt)._place-channel-put))"></a><span title="Provided from: racket/place, racket/place/dynamic, racket | Package: base"><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel-put%29%29" class="RktValDef RktValLink" data-pltdoc="x">place-channel-put</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">pch</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pch</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel~3f%29%29" class="RktValLink" data-pltdoc="x">place-channel?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-message-allowed~3f%29%29" class="RktValLink" data-pltdoc="x">place-message-allowed?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Sends a message <span class="RktVar">v</span> on channel <span class="RktVar">pch</span>. Since place channels
+ are asynchronous, <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel-put%29%29" class="RktValLink" data-pltdoc="x">place-channel-put</a></span> calls are non-blocking.</div></p><p>See <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-message-allowed~3f%29%29" class="RktValLink" data-pltdoc="x">place-message-allowed?</a></span> form information on automatic
+coercions in <span class="RktVar">v</span>, such as converting a mutable string to an
+immutable string.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/place..rkt)._place-channel-get))"></a><span title="Provided from: racket/place, racket/place/dynamic, racket | Package: base"><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel-get%29%29" class="RktValDef RktValLink" data-pltdoc="x">place-channel-get</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">pch</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-message-allowed~3f%29%29" class="RktValLink" data-pltdoc="x">place-message-allowed?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pch</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel~3f%29%29" class="RktValLink" data-pltdoc="x">place-channel?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a message received on channel <span class="RktVar">pch</span>, blocking until a
+message is available.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/place..rkt)._place-channel-put/get))"></a><span title="Provided from: racket/place, racket/place/dynamic, racket | Package: base"><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel-put%2Fget%29%29" class="RktValDef RktValLink" data-pltdoc="x">place-channel-put/get</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">pch</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pch</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-channel~3f%29%29" class="RktValLink" data-pltdoc="x">place-channel?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Sends an immutable message <span class="RktVar">v</span> on channel <span class="RktVar">pch</span> and then
+waits for a message (perhaps a reply) on the same channel.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/place..rkt)._place-message-allowed~3f))"></a><span title="Provided from: racket/place, racket/place/dynamic, racket | Package: base"><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-message-allowed~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">place-message-allowed?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is allowed as a message on a place channel,
+<span class="RktVal">#f</span> otherwise.</div></p><p>If <span class="RktPn">(</span><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-enabled~3f%29%29" class="RktValLink" data-pltdoc="x">place-enabled?</a></span><span class="RktPn">)</span> returns <span class="RktVal">#f</span>, then the result is
+always <span class="RktVal">#t</span> and no conversions are performed on <span class="RktVar">v</span> as a
+message. Otherwise, the following kinds of data are allowed as
+messages:</p><ul><li><p><a href="numbers.html#%28tech._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">numbers</span></a>, <a href="characters.html#%28tech._character%29" class="techoutside" data-pltdoc="x"><span class="techinside">characters</span></a>, <a href="booleans.html#%28tech._boolean%29" class="techoutside" data-pltdoc="x"><span class="techinside">booleans</span></a>, <a href="keywords.html#%28tech._keyword%29" class="techoutside" data-pltdoc="x"><span class="techinside">keywords</span></a>, and
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>;</p></li><li><p><a href="symbols.html#%28tech._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">symbols</span></a>, where the <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>ness of <a href="symbols.html#%28tech._uninterned%29" class="techoutside" data-pltdoc="x"><span class="techinside">uninterned</span></a>
+symbols is preserved within a single message, but not across
+messages;</p></li><li><p><a href="strings.html#%28tech._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">strings</span></a> and <a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte strings</span></a>, where mutable strings
+and byte strings are automatically replaced by immutable
+variants;</p></li><li><p><a href="pathutils.html#%28tech._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">paths</span></a> (for any platform);</p></li><li><p><a href="pairs.html#%28tech._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">pairs</span></a>, <a href="pairs.html#%28tech._list%29" class="techoutside" data-pltdoc="x"><span class="techinside">lists</span></a>, <a href="boxes.html#%28tech._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">box</span></a>es, <a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vectors</span></a>, and immutable
+<a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structures containing message-allowed values,
+where a mutable box is automatically replaced by an
+immutable box, a mutable vector is automatically replaced by an
+immutable vector and where <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonators</span></a> of boxes, vectors and
+<a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structures are copied;</p></li><li><p><a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash tables</span></a> where mutable hash tables are automatically
+replaced by immutable variants, and where a
+hash table <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a> is copied;</p></li><li><p><a href="places.html#%28tech._place._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">place channels</span></a>, where a <a href="places.html#%28tech._place._descriptor%29" class="techoutside" data-pltdoc="x"><span class="techinside">place descriptor</span></a> is
+automatically replaced by a plain place channel;</p></li><li><p><a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file-stream ports</span></a> and <a href="tcp.html#%28tech._tcp._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">TCP ports</span></a>, where the
+underlying representation (such as a file descriptor, socket,
+or handle) is duplicated in the sending place and attached to
+a fresh port in the receiving place;</p></li><li><p><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=Pointer_Types.html%23%2528tech._c._pointer%2529&amp;version=8.6" class="techoutside Sq" data-pltdoc="x"><span class="techinside">C
+pointers</span></a> as created or accessed via <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">ffi/unsafe</span></a>; and</p></li><li><p>values produced by <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._shared-flvector%29%29" class="RktValLink" data-pltdoc="x">shared-flvector</a></span>,
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._make-shared-flvector%29%29" class="RktValLink" data-pltdoc="x">make-shared-flvector</a></span>, <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._shared-fxvector%29%29" class="RktValLink" data-pltdoc="x">shared-fxvector</a></span>,
+<span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._make-shared-fxvector%29%29" class="RktValLink" data-pltdoc="x">make-shared-fxvector</a></span>, <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._shared-bytes%29%29" class="RktValLink" data-pltdoc="x">shared-bytes</a></span>, and
+<span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._make-shared-bytes%29%29" class="RktValLink" data-pltdoc="x">make-shared-bytes</a></span>.</p></li></ul><p class="SHistory">Changed in version 8.4.0.7 of package <span class="stt">base</span>: Include boxes in allowed messages.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/place..rkt)._prop~3aplace-location))"></a><span title="Provided from: racket/place, racket/place/dynamic, racket | Package: base"><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._prop~3aplace-location%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:place-location</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/place..rkt)._place-location~3f))"></a><span title="Provided from: racket/place, racket/place/dynamic, racket | Package: base"><span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-location~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">place-location?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property</span></a> and associated predicate for
+implementations of <a name="(tech._place._location)"></a><span style="font-style: italic">place locations</span>. The value of
+<span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._prop~3aplace-location%29%29" class="RktValLink" data-pltdoc="x">prop:place-location</a></span> must be a procedure of four arguments:
+the <a href="places.html#%28tech._place._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">place location</span></a> itself, a module path, a symbol for the
+start function exported by the module, and a place name (which can be
+<span class="RktVal">#f</span> for an anonymous place).</div></p><p>A <a href="places.html#%28tech._place._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">place location</span></a> can be passed as the <span class="RktPn">#:at</span> argument to
+<span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%29%29" class="RktValLink" data-pltdoc="x">dynamic-place</a></span>, which in turn simply calls the
+<span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._prop~3aplace-location%29%29" class="RktValLink" data-pltdoc="x">prop:place-location</a></span> value of the <a href="places.html#%28tech._place._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">place location</span></a>.</p><p>A distributed places note created with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528def._%2528%2528lib._racket%252Fplace%252Fdistributed..rkt%2529._create-place-node%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">create-place-node</a></span>
+is an example of a <a href="places.html#%28tech._place._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">place location</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;places-syntax&quot;">11.5.2<tt>&nbsp;</tt><a name="(part._places-syntax)"></a>Syntactic Support for Using Places</h5><p>The bindings in this section are <span class="emph">not</span> provided by
+<a href="places.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/place/dynamic</span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/place..rkt)._place))"></a><span title="Provided from: racket/place | Package: base"><span class="RktSym"><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">place</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Creates a place that evaluates <span class="RktVar">body</span>
+  expressions with <span class="RktVar">id</span> bound to a place channel.  The
+  <span class="RktVar">body</span>s close only over <span class="RktVar">id</span> plus the top-level
+  bindings of the enclosing module, because the
+  <span class="RktVar">body</span>s are lifted to a submodule.
+  The result of <span class="RktSym"><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%29%29" class="RktStxLink" data-pltdoc="x">place</a></span> is a place descriptor,
+  like the result of <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%29%29" class="RktValLink" data-pltdoc="x">dynamic-place</a></span>.</div></p><p>The generated submodule has the name <span class="RktSym">place-body-<span class="RktVar">n</span></span>
+for an integer <span class="RktVar">n</span>, and the submodule exports a <span class="RktSym">main</span>
+function that takes a place channel for the new place. The submodule
+is not intended for use, however, except by the expansion of the
+<span class="RktSym"><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%29%29" class="RktStxLink" data-pltdoc="x">place</a></span> form.</p><p>The <span class="RktSym"><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%29%29" class="RktStxLink" data-pltdoc="x">place</a></span> binding is protected in the same way as
+ <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%29%29" class="RktValLink" data-pltdoc="x">dynamic-place</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/place..rkt)._place*))"></a><span title="Provided from: racket/place | Package: base"><span class="RktSym"><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">place*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-port</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">maybe-port</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:in</span><span class="hspace">&nbsp;</span><span class="RktVar">in-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:out</span><span class="hspace">&nbsp;</span><span class="RktVar">out-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:err</span><span class="hspace">&nbsp;</span><span class="RktVar">err-expr</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%29%29" class="RktStxLink" data-pltdoc="x">place</a></span>, but supports optional <span class="RktPn">#:in</span>, <span class="RktPn">#:out</span>,
+ and <span class="RktPn">#:err</span> expressions (at most one of each) to specify ports in the same way and
+ with the same defaults as <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%2A%29%29" class="RktValLink" data-pltdoc="x">dynamic-place*</a></span>. The result of
+ a <span class="RktSym"><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%2A%29%29" class="RktStxLink" data-pltdoc="x">place*</a></span> form is also the same as for  <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%2A%29%29" class="RktValLink" data-pltdoc="x">dynamic-place*</a></span>.</div></p><p>The <span class="RktSym"><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%2A%29%29" class="RktStxLink" data-pltdoc="x">place*</a></span> binding is protected in the same way as
+ <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._dynamic-place%29%29" class="RktValLink" data-pltdoc="x">dynamic-place</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/place..rkt)._place/context))"></a><span title="Provided from: racket/place | Package: base"><span class="RktSym"><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%2Fcontext%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">place/context</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%29%29" class="RktStxLink" data-pltdoc="x">place</a></span>, but <span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span> may have free lexical
+variables, which are automatically sent to the newly-created place.
+Note that these variables must have values accepted by
+<span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-message-allowed~3f%29%29" class="RktValLink" data-pltdoc="x">place-message-allowed?</a></span>, otherwise an <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/place..rkt)._processor-count))"></a><span title="Provided from: racket/place | Package: base"><span class="RktSym"><a href="futures.html#%28def._%28%28lib._racket%2Ffuture..rkt%29._processor-count%29%29" class="RktValDef RktValLink" data-pltdoc="x">processor-count</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns the number of parallel computation units (e.g., processors or
+cores) that are available on the current machine.</div></p><p>This is the same binding as available from <a href="futures.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/future</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;place-logging&quot;">11.5.3<tt>&nbsp;</tt><a name="(part._place-logging)"></a>Places Logging</h5><p>Place events are reported to a logger named <span class="RktVal">'</span><span class="RktVal">place</span>.
+In addition to its string message, each event logged for a place has
+a data value that is an instance of a <span class="RktSym">place-event</span>
+<a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">place-event</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">place-id</span><span class="hspace">&nbsp;</span><span class="RktSym">action</span><span class="hspace">&nbsp;</span><span class="RktSym">value</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="time.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._time%29%29" class="RktStxLink" data-pltdoc="x">time</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:prefab</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The <span class="RktSym">place-id</span> field is an exact integer that identifies a
+place.</p><p>The <span class="RktSym"><a href="time.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._time%29%29" class="RktStxLink" data-pltdoc="x">time</a></span> field is an inexact number that represents time in
+the same way as <span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-inexact-milliseconds%29%29" class="RktValLink" data-pltdoc="x">current-inexact-milliseconds</a></span>.</p><p>The <span class="RktSym">action</span> field is a symbol:</p><ul><li><p><span class="RktVal">'</span><span class="RktVal">create</span>: a place was created. This event is logged in the
+creating place, and the event&rsquo;s <span class="RktSym">value</span> field has the
+ID for the created place.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">reap</span>: a place that was previously created in the
+current place has exited (and that fact has been detected,
+possibly via <span class="RktSym"><a href="places.html#%28def._%28%28lib._racket%2Fplace..rkt%29._place-wait%29%29" class="RktValLink" data-pltdoc="x">place-wait</a></span>). The event&rsquo;s <span class="RktSym">value</span>
+field has the ID for the exited place.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">enter</span>: a place has started, logged within the started
+place. The event&rsquo;s <span class="RktSym">value</span> field has <span class="RktVal">#f</span>.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">exit</span>: a place is exiting, logged within the exiting
+place. The event&rsquo;s <span class="RktSym">value</span> field has <span class="RktVal">#f</span>.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">put</span>: a place-channel message has been sent. The
+event&rsquo;s <span class="RktSym">value</span> field is a positive exact integer that
+approximates the message&rsquo;s size.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">get</span>: a place-channel message has been received. The
+event&rsquo;s <span class="RktSym">value</span> field is a positive exact integer that
+approximates the message&rsquo;s size.</p></li></ul><p class="SHistory">Changed in version 6.0.0.2 of package <span class="stt">base</span>: Added logging via <span class="RktVal">'</span><span class="RktVal">place</span>
+and <span class="RktSym">place-event</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="futures.html" title="backward to &quot;11.4 Futures&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="concurrency.html" title="up to &quot;11 Concurrency and Parallelism&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="engine.html" title="forward to &quot;11.6 Engines&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/plumbers.html b/clones/docs.racket-lang.org/reference/plumbers.html
new file mode 100644
index 00000000..6087e3e3
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/plumbers.html
@@ -0,0 +1,35 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14.11&nbsp;Plumbers</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewselflink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Namespaces.html" class="tocviewlink" data-pltdoc="x">Namespaces</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="eval.html" class="tocviewlink" data-pltdoc="x">Evaluation and Compilation</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="load-lang.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>load</span></span> Language</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="Module_Names_and_Loading.html" class="tocviewlink" data-pltdoc="x">Module Names and Loading</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="chaperones.html" class="tocviewlink" data-pltdoc="x">Impersonators and Chaperones</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="securityguards.html" class="tocviewlink" data-pltdoc="x">Security Guards</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="custodians.html" class="tocviewlink" data-pltdoc="x">Custodians</a></td></tr><tr><td align="right">14.8&nbsp;</td><td><a href="threadgroups.html" class="tocviewlink" data-pltdoc="x">Thread Groups</a></td></tr><tr><td align="right">14.9&nbsp;</td><td><a href="inspectors.html" class="tocviewlink" data-pltdoc="x">Structure Inspectors</a></td></tr><tr><td align="right">14.10&nbsp;</td><td><a href="modprotect.html" class="tocviewlink" data-pltdoc="x">Code Inspectors</a></td></tr><tr><td align="right">14.11&nbsp;</td><td><a href="plumbers.html" class="tocviewselflink" data-pltdoc="x">Plumbers</a></td></tr><tr><td align="right">14.12&nbsp;</td><td><a href="Sandboxed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Sandboxed Evaluation</a></td></tr><tr><td align="right">14.13&nbsp;</td><td><a href="repl-module.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>repl</span></span> Library</a></td></tr><tr><td align="right">14.14&nbsp;</td><td><a href="linklets.html" class="tocviewlink" data-pltdoc="x">Linklets and the Core Compiler</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">plumber?</span></span></a></td></tr><tr><td><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._make-plumber%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>plumber</span></span></a></td></tr><tr><td><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._current-plumber%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>plumber</span></span></a></td></tr><tr><td><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-flush-all%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">plumber-<wbr></wbr>flush-<wbr></wbr>all</span></span></a></td></tr><tr><td><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-flush-handle~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">plumber-<wbr></wbr>flush-<wbr></wbr>handle?</span></span></a></td></tr><tr><td><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-add-flush%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">plumber-<wbr></wbr>add-<wbr></wbr>flush!</span></span></a></td></tr><tr><td><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-flush-handle-remove%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">plumber-<wbr></wbr>flush-<wbr></wbr>handle-<wbr></wbr>remove!</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="modprotect.html" title="backward to &quot;14.10 Code Inspectors&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Sandboxed_Evaluation.html" title="forward to &quot;14.12 Sandboxed Evaluation&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;plumbers&quot;">14.11<tt>&nbsp;</tt><a name="(part._plumbers)"></a>Plumbers</h4><p><div class="SIntrapara">A <a name="(tech._plumber)"></a><span style="font-style: italic">plumber</span> supports <a name="(tech._flush._callback)"></a><span style="font-style: italic">flush callbacks</span>, which are
+normally triggered just before a Racket process or <a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">place</span></a> exits.
+For example, a <a href="plumbers.html#%28tech._flush._callback%29" class="techoutside" data-pltdoc="x"><span class="techinside">flush callback</span></a> might flush an output port&rsquo;s
+buffer.</div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><a href="plumbers.html#%28tech._flush._callback%29" class="techoutside" data-pltdoc="x"><span class="techinside">Flush callbacks</span></a> are roughly analogous to the standard C
+library&rsquo;s <a name="(idx._(gentag._287._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">atexit</span>, but flush callback can also be used in other,
+similar scenarios.</p></blockquote></blockquote></blockquote></div></p><p>There is no guarantee that a flush callback will be called before a
+process terminates&#8212;<wbr></wbr>either because the plumber is not the original
+plumber that is flushed by the default <a href="Exiting.html#%28tech._exit._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">exit handler</span></a>, or because
+the process is terminated forcibly (e.g., through a custodian
+shutdown).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._plumber~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">plumber?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="plumbers.html#%28tech._plumber%29" class="techoutside" data-pltdoc="x"><span class="techinside">plumber</span></a> value,
+<span class="RktVal">#f</span> otherwise.</div></p><p class="SHistory">Added in version 6.0.1.8 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-plumber))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._make-plumber%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-plumber</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber~3f%29%29" class="RktValLink" data-pltdoc="x">plumber?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new <a href="plumbers.html#%28tech._plumber%29" class="techoutside" data-pltdoc="x"><span class="techinside">plumber</span></a>.</div></p><p>Plumbers have no hierarchy (unlike <a href="eval-model.html#%28tech._custodian%29" class="techoutside" data-pltdoc="x"><span class="techinside">custodians</span></a> or
+<a href="inspectors.html#%28tech._inspector%29" class="techoutside" data-pltdoc="x"><span class="techinside">inspectors</span></a>), but a <a href="plumbers.html#%28tech._flush._callback%29" class="techoutside" data-pltdoc="x"><span class="techinside">flush callback</span></a> can be registered in
+one plumber to call <span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-flush-all%29%29" class="RktValLink" data-pltdoc="x">plumber-flush-all</a></span> with another plumber.</p><p class="SHistory">Added in version 6.0.1.8 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-plumber))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._current-plumber%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-plumber</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber~3f%29%29" class="RktValLink" data-pltdoc="x">plumber?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._current-plumber%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-plumber</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">plumber</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">plumber</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber~3f%29%29" class="RktValLink" data-pltdoc="x">plumber?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines a <a name="(tech._current._plumber)"></a><span style="font-style: italic">current plumber</span> for
+<a href="plumbers.html#%28tech._flush._callback%29" class="techoutside" data-pltdoc="x"><span class="techinside">flush callbacks</span></a>. For example, creating an output <a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file
+stream port</span></a> registers a <a href="plumbers.html#%28tech._flush._callback%29" class="techoutside" data-pltdoc="x"><span class="techinside">flush callback</span></a> with the <a href="plumbers.html#%28tech._current._plumber%29" class="techoutside" data-pltdoc="x"><span class="techinside">current
+plumber</span></a> to flush the port as long as the port is opened.</div></p><p class="SHistory">Added in version 6.0.1.8 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._plumber-flush-all))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-flush-all%29%29" class="RktValDef RktValLink" data-pltdoc="x">plumber-flush-all</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">plumber</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">plumber</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber~3f%29%29" class="RktValLink" data-pltdoc="x">plumber?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Calls all <a href="plumbers.html#%28tech._flush._callback%29" class="techoutside" data-pltdoc="x"><span class="techinside">flush callbacks</span></a> that are registered with <span class="RktVar">plumber</span>.</div></p><p>The <a href="plumbers.html#%28tech._flush._callback%29" class="techoutside" data-pltdoc="x"><span class="techinside">flush callbacks</span></a> to call are collected from <span class="RktVar">plumber</span>
+before the first one is called. If a <a href="plumbers.html#%28tech._flush._callback%29" class="techoutside" data-pltdoc="x"><span class="techinside">flush callback</span></a> registers a
+new <a href="plumbers.html#%28tech._flush._callback%29" class="techoutside" data-pltdoc="x"><span class="techinside">flush callback</span></a>, the new one is <span class="emph">not</span> called. If a
+<a href="plumbers.html#%28tech._flush._callback%29" class="techoutside" data-pltdoc="x"><span class="techinside">flush callback</span></a> raises an exception or otherwise escapes, then
+the remaining <a href="plumbers.html#%28tech._flush._callback%29" class="techoutside" data-pltdoc="x"><span class="techinside">flush callbacks</span></a> are not called.</p><p class="SHistory">Added in version 6.0.1.8 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._plumber-flush-handle~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-flush-handle~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">plumber-flush-handle?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a name="(tech._flush._handle)"></a><span style="font-style: italic">flush handle</span>
+represents the registration of a <a href="plumbers.html#%28tech._flush._callback%29" class="techoutside" data-pltdoc="x"><span class="techinside">flush callback</span></a>, <span class="RktVal">#f</span>
+otherwise.</div></p><p class="SHistory">Added in version 6.0.1.8 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._plumber-add-flush!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-add-flush%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">plumber-add-flush!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">plumber</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">weak?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-flush-handle~3f%29%29" class="RktValLink" data-pltdoc="x">plumber-flush-handle?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">plumber</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber~3f%29%29" class="RktValLink" data-pltdoc="x">plumber?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-flush-handle~3f%29%29" class="RktValLink" data-pltdoc="x">plumber-flush-handle?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">weak?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Registers <span class="RktVar">proc</span> as a <a href="plumbers.html#%28tech._flush._callback%29" class="techoutside" data-pltdoc="x"><span class="techinside">flush callback</span></a> with <span class="RktVar">plumber</span>, so
+that <span class="RktVar">proc</span> is called when <span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-flush-all%29%29" class="RktValLink" data-pltdoc="x">plumber-flush-all</a></span> is
+applied to <span class="RktVar">plumber</span>.</div></p><p>The result <a href="plumbers.html#%28tech._flush._handle%29" class="techoutside" data-pltdoc="x"><span class="techinside">flush handle</span></a> represents the registration of the
+callback, and it can be used with <span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-flush-handle-remove%21%29%29" class="RktValLink" data-pltdoc="x">plumber-flush-handle-remove!</a></span> to
+unregister the callback.</p><p>The given <span class="RktVar">proc</span> is reachable from the <a href="plumbers.html#%28tech._flush._handle%29" class="techoutside" data-pltdoc="x"><span class="techinside">flush handle</span></a>, but
+if <span class="RktVar">weak?</span> is true, then <span class="RktVar">plumber</span> retains only a
+<a href="eval-model.html#%28tech._weak._reference%29" class="techoutside" data-pltdoc="x"><span class="techinside">weak reference</span></a> to the result <a href="plumbers.html#%28tech._flush._handle%29" class="techoutside" data-pltdoc="x"><span class="techinside">flush handle</span></a> (and
+thus <span class="RktVar">proc</span>).</p><p>When <span class="RktVar">proc</span> is called as a <a href="plumbers.html#%28tech._flush._callback%29" class="techoutside" data-pltdoc="x"><span class="techinside">flush callback</span></a>, it is passed
+the same value that is returned by <span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-add-flush%21%29%29" class="RktValLink" data-pltdoc="x">plumber-add-flush!</a></span> so
+that <span class="RktVar">proc</span> can conveniently unregister itself. The call of
+<span class="RktVar">proc</span> is within a <a href="eval-model.html#%28tech._continuation._barrier%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation barrier</span></a>.</p><p class="SHistory">Added in version 6.0.1.8 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._plumber-flush-handle-remove!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-flush-handle-remove%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">plumber-flush-handle-remove!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">handle</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">handle</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-flush-handle~3f%29%29" class="RktValLink" data-pltdoc="x">plumber-flush-handle?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Unregisters the <a href="plumbers.html#%28tech._flush._callback%29" class="techoutside" data-pltdoc="x"><span class="techinside">flush callback</span></a> that was registered by the
+<span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-add-flush%21%29%29" class="RktValLink" data-pltdoc="x">plumber-add-flush!</a></span> call that produced <span class="RktVar">handle</span>.</div></p><p>If the registration represented by <span class="RktVar">handle</span> has been removed already,
+then <span class="RktSym"><a href="plumbers.html#%28def._%28%28quote._~23~25kernel%29._plumber-flush-handle-remove%21%29%29" class="RktValLink" data-pltdoc="x">plumber-flush-handle-remove!</a></span> has no effect.</p><p class="SHistory">Added in version 6.0.1.8 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="modprotect.html" title="backward to &quot;14.10 Code Inspectors&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Sandboxed_Evaluation.html" title="forward to &quot;14.12 Sandboxed Evaluation&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/port-buffers.html b/clones/docs.racket-lang.org/reference/port-buffers.html
new file mode 100644
index 00000000..b7799e22
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/port-buffers.html
@@ -0,0 +1,86 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.1.3&nbsp;Port Buffers and Positions</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewselflink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1.1&nbsp;</td><td><a href="encodings.html" class="tocviewlink" data-pltdoc="x">Encodings and Locales</a></td></tr><tr><td align="right">13.1.2&nbsp;</td><td><a href="port-ops.html" class="tocviewlink" data-pltdoc="x">Managing Ports</a></td></tr><tr><td align="right">13.1.3&nbsp;</td><td><a href="port-buffers.html" class="tocviewselflink" data-pltdoc="x">Port Buffers and Positions</a></td></tr><tr><td align="right">13.1.4&nbsp;</td><td><a href="linecol.html" class="tocviewlink" data-pltdoc="x">Counting Positions, Lines, and Columns</a></td></tr><tr><td align="right">13.1.5&nbsp;</td><td><a href="file-ports.html" class="tocviewlink" data-pltdoc="x">File Ports</a></td></tr><tr><td align="right">13.1.6&nbsp;</td><td><a href="stringport.html" class="tocviewlink" data-pltdoc="x">String Ports</a></td></tr><tr><td align="right">13.1.7&nbsp;</td><td><a href="pipeports.html" class="tocviewlink" data-pltdoc="x">Pipes</a></td></tr><tr><td align="right">13.1.8&nbsp;</td><td><a href="portstructs.html" class="tocviewlink" data-pltdoc="x">Structures as Ports</a></td></tr><tr><td align="right">13.1.9&nbsp;</td><td><a href="customport.html" class="tocviewlink" data-pltdoc="x">Custom Ports</a></td></tr><tr><td align="right">13.1.10&nbsp;</td><td><a href="port-lib.html" class="tocviewlink" data-pltdoc="x">More Port Constructors, Procedures, and Events</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._flush-output%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">flush-<wbr></wbr>output</span></span></a></td></tr><tr><td><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-stream-buffer-mode%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-<wbr></wbr>stream-<wbr></wbr>buffer-<wbr></wbr>mode</span></span></a></td></tr><tr><td><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-<wbr></wbr>position</span></span></a></td></tr><tr><td><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%2A%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-<wbr></wbr>position*</span></span></a></td></tr><tr><td><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-truncate%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-<wbr></wbr>truncate</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="port-ops.html" title="backward to &quot;13.1.2 Managing Ports&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ports.html" title="up to &quot;13.1 Ports&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="linecol.html" title="forward to &quot;13.1.4 Counting Positions, Lines, and Columns&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;port-buffers&quot;">13.1.3<tt>&nbsp;</tt><a name="(part._port-buffers)"></a>Port Buffers and Positions</h5><p>Some ports&#8212;<wbr></wbr>especially those that read from and write to files&#8212;<wbr></wbr>are
+internally buffered:</p><ul><li><p>An input port is typically block-buffered by default, which
+means that on any read, the buffer is filled with
+immediately-available bytes to speed up future reads. Thus, if
+a file is modified between a pair of reads to the file, the
+second read can produce stale data. Calling
+<span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%29%29" class="RktValLink" data-pltdoc="x">file-position</a></span> to set an input port&rsquo;s file position
+flushes its buffer.</p></li><li><p>An output port is typically block-buffered by default, though
+a terminal output port is line-buffered, and the initial error
+output port is unbuffered.  An output buffer is filled with a
+sequence of written bytes to be committed as a group, either
+when the buffer is full (in block mode), when a newline is
+written (in line mode), when the port is closed via
+<span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-output-port%29%29" class="RktValLink" data-pltdoc="x">close-output-port</a></span>, or when a flush is explicitly
+requested via a procedure like <span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._flush-output%29%29" class="RktValLink" data-pltdoc="x">flush-output</a></span>.</p></li></ul><p>If a port supports buffering, its buffer mode can be changed via
+<span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-stream-buffer-mode%29%29" class="RktValLink" data-pltdoc="x">file-stream-buffer-mode</a></span> (even if the port is not a
+<a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file-stream port</span></a>).</p><p>For an input port, peeking always places peeked bytes into the port&rsquo;s
+buffer, even when the port&rsquo;s buffer mode is <span class="RktVal">'</span><span class="RktVal">none</span>;
+furthermore, on some platforms, testing the port for input (via
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._char-ready~3f%29%29" class="RktValLink" data-pltdoc="x">char-ready?</a></span> or <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span>) may be implemented with a
+peek. If an input port&rsquo;s buffer mode is <span class="RktVal">'</span><span class="RktVal">none</span>, then at most
+one byte is read for <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%2A%29%29" class="RktValLink" data-pltdoc="x">read-bytes-avail!*</a></span>,
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%29%29" class="RktValLink" data-pltdoc="x">read-bytes-avail!</a></span>, <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes-avail%21%2A%29%29" class="RktValLink" data-pltdoc="x">peek-bytes-avail!*</a></span>, or
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes-avail%21%29%29" class="RktValLink" data-pltdoc="x">peek-bytes-avail!</a></span>; if any bytes are buffered in the port
+(e.g., to satisfy a previous peek), the procedures may access multiple
+buffered bytes, but no further bytes are read.</p><p>In addition, the initial current output and error ports are
+automatically flushed when they are terminal ports (see
+<span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._terminal-port~3f%29%29" class="RktValLink" data-pltdoc="x">terminal-port?</a></span>) and when <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>, <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="RktValLink" data-pltdoc="x">read-line</a></span>,
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes%29%29" class="RktValLink" data-pltdoc="x">read-bytes</a></span>, <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="RktValLink" data-pltdoc="x">read-string</a></span>, etc., are performed on the
+initial standard input port. (More precisely, instead of
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>, flushing is performed by the default port read handler;
+see <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._port-read-handler%29%29" class="RktValLink" data-pltdoc="x">port-read-handler</a></span>.)</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._flush-output))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._flush-output%29%29" class="RktValDef RktValLink" data-pltdoc="x">flush-output</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">out</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara"><a name="(idx._(gentag._244._(lib._scribblings/reference/reference..scrbl)))"></a>Forces all buffered data in the given
+output port to be physically written. Only <a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file-stream ports</span></a>,
+TCP ports, and custom ports (see <a href="customport.html" data-pltdoc="x">Custom Ports</a>) use
+buffers; when called on a port without a buffer, <span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._flush-output%29%29" class="RktValLink" data-pltdoc="x">flush-output</a></span>
+has no effect.</div></p><p>If flushing a <a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file-stream port</span></a> or <a href="tcp.html#%28tech._tcp._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">TCP port</span></a> encounters an
+error when writing, then all buffered bytes in the port are discarded.
+Consequently, a further attempt to flush or close the port will not
+fail.</p><p class="SHistory">Changed in version 7.4.0.10 of package <span class="stt">base</span>: Consistently, discard buffered bytes on error,
+including in a TCP output port.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._file-stream-buffer-mode))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-stream-buffer-mode%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-stream-buffer-mode</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">port</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">none</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">line</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">block</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._port~3f%29%29" class="RktValLink" data-pltdoc="x">port?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-stream-buffer-mode%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-stream-buffer-mode</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span><span class="RktVar">mode</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._port~3f%29%29" class="RktValLink" data-pltdoc="x">port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">none</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">line</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">block</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Gets or sets the buffer mode for <span class="RktVar">port</span>, if
+possible. <a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">File-stream ports</span></a> support setting the buffer mode,
+TCP ports (see <a href="networking.html" data-pltdoc="x">Networking</a>) support setting and getting
+the buffer mode, and custom ports (see <a href="customport.html" data-pltdoc="x">Custom Ports</a>) may
+support getting and setting buffer modes.</div></p><p>If <span class="RktVar">mode</span> is provided, it must be one of
+<a name="(idx._(gentag._245._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">none</span>, <a name="(idx._(gentag._246._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">line</span> (output only), or
+<a name="(idx._(gentag._247._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">block</span>, and the port&rsquo;s buffering is set
+accordingly. If the port does not support setting the mode, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span> exception is raised.</p><p>If <span class="RktVar">mode</span> is not provided, the current mode is returned, or
+<span class="RktVal">#f</span> is returned if the mode cannot be determined. If
+<span class="RktVar">port</span> is an input port and <span class="RktVar">mode</span> is
+<span class="RktVal">'</span><span class="RktVal">line</span>, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._file-position))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-position</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">port</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._port~3f%29%29" class="RktValLink" data-pltdoc="x">port?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-position</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._port~3f%29%29" class="RktValLink" data-pltdoc="x">port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns or sets the current read/write position of <span class="RktVar">port</span>.</div></p><p>Calling <span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%29%29" class="RktValLink" data-pltdoc="x">file-position</a></span> without a position on a port other
+than a <a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file-stream port</span></a> or <a href="stringport.html#%28tech._string._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">string port</span></a>
+returns the number of bytes that have
+been read from that port if the position is known (see
+<a href="linecol.html" data-pltdoc="x">Counting Positions, Lines, and Columns</a>), otherwise the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> exception is raised.</p><p>For <a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file-stream ports</span></a> and <a href="stringport.html#%28tech._string._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">string ports</span></a>, the position-setting
+variant sets the read/write position to <span class="RktVar">pos</span> relative to the
+beginning of the file or (byte) string if <span class="RktVar">pos</span> is a number, or to the
+current end of the file or (byte) string if <span class="RktVar">pos</span> is <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>. In
+position-setting mode, <span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%29%29" class="RktValLink" data-pltdoc="x">file-position</a></span> raises the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception for port kinds other than
+<a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file-stream ports</span></a> and <a href="stringport.html#%28tech._string._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">string ports</span></a>. Furthermore, not all <a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file-stream
+ports</span></a> support setting the position; if <span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%29%29" class="RktValLink" data-pltdoc="x">file-position</a></span> is
+called with a position argument on such a <a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file-stream port</span></a>, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3afilesystem%29%29" class="RktValLink" data-pltdoc="x">exn:fail:filesystem</a></span> exception is raised.</p><p>When <span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%29%29" class="RktValLink" data-pltdoc="x">file-position</a></span> sets the position <span class="RktVar">pos</span> beyond the
+current size of an output file or (byte) string, the file/string is
+enlarged to size <span class="RktVar">pos</span> and the new region is filled with
+<span class="RktVal">0</span> bytes; in the case of a file. In the case of a file output
+port, the file might not be enlarged until more data is written to the
+file; in that case, beware that writing to a file opened in
+<span class="RktVal">'</span><span class="RktVal">append</span> mode on Unix and Mac OS will reset the file pointer
+to the end of a file <span class="emph">before</span> each write, which defeats file
+enlargement via <span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%29%29" class="RktValLink" data-pltdoc="x">file-position</a></span>. If <span class="RktVar">pos</span> is beyond the
+end of an input file or (byte) string, then reading thereafter returns
+<span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> without changing the port&rsquo;s position.</p><p>When changing the file position for an output port, the port is first
+flushed if its buffer is not empty. Similarly, setting the position
+for an input port clears the port&rsquo;s buffer (even if the new position
+is the same as the old position). However, although input and output
+ports produced by <span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-input-output-file%29%29" class="RktValLink" data-pltdoc="x">open-input-output-file</a></span> share the file
+position, setting the position via one port does not flush the other
+port&rsquo;s buffer.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._file-position*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-position*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">port</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._port~3f%29%29" class="RktValLink" data-pltdoc="x">port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%29%29" class="RktValLink" data-pltdoc="x">file-position</a></span> on a single argument, but returns
+<span class="RktVal">#f</span> if the position is not known.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._file-truncate))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-truncate%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-truncate</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span><span class="RktVar">size</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._file-stream-port~3f%29%29" class="RktValLink" data-pltdoc="x">file-stream-port?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">size</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Sets the size of the file written by <span class="RktVar">port</span> to <span class="RktVar">size</span>,
+assuming that the port is associated to a file whose size can be set.</div></p><p>The new file size can be either larger or smaller than its current
+size, but &ldquo;truncate&rdquo; in this function&rsquo;s name reflects that it is
+normally used to decrease the size of a file, since writing to a file
+or using <span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%29%29" class="RktValLink" data-pltdoc="x">file-position</a></span> can extend a file&rsquo;s size.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="port-ops.html" title="backward to &quot;13.1.2 Managing Ports&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ports.html" title="up to &quot;13.1 Ports&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="linecol.html" title="forward to &quot;13.1.4 Counting Positions, Lines, and Columns&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/port-lib.html b/clones/docs.racket-lang.org/reference/port-lib.html
new file mode 100644
index 00000000..3cda1571
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/port-lib.html
@@ -0,0 +1,290 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.1.10&nbsp;More Port Constructors, Procedures, and Events</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewselflink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1.1&nbsp;</td><td><a href="encodings.html" class="tocviewlink" data-pltdoc="x">Encodings and Locales</a></td></tr><tr><td align="right">13.1.2&nbsp;</td><td><a href="port-ops.html" class="tocviewlink" data-pltdoc="x">Managing Ports</a></td></tr><tr><td align="right">13.1.3&nbsp;</td><td><a href="port-buffers.html" class="tocviewlink" data-pltdoc="x">Port Buffers and Positions</a></td></tr><tr><td align="right">13.1.4&nbsp;</td><td><a href="linecol.html" class="tocviewlink" data-pltdoc="x">Counting Positions, Lines, and Columns</a></td></tr><tr><td align="right">13.1.5&nbsp;</td><td><a href="file-ports.html" class="tocviewlink" data-pltdoc="x">File Ports</a></td></tr><tr><td align="right">13.1.6&nbsp;</td><td><a href="stringport.html" class="tocviewlink" data-pltdoc="x">String Ports</a></td></tr><tr><td align="right">13.1.7&nbsp;</td><td><a href="pipeports.html" class="tocviewlink" data-pltdoc="x">Pipes</a></td></tr><tr><td align="right">13.1.8&nbsp;</td><td><a href="portstructs.html" class="tocviewlink" data-pltdoc="x">Structures as Ports</a></td></tr><tr><td align="right">13.1.9&nbsp;</td><td><a href="customport.html" class="tocviewlink" data-pltdoc="x">Custom Ports</a></td></tr><tr><td align="right">13.1.10&nbsp;</td><td><a href="port-lib.html" class="tocviewselflink" data-pltdoc="x">More Port Constructors, Procedures, and Events</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_3&quot;);">&#9658;</a></td><td>13.1.10&nbsp;</td><td><a href="port-lib.html" class="tocviewselflink" data-pltdoc="x">More Port Constructors, Procedures, and Events</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_3"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1.10.1&nbsp;</td><td><a href="port-lib.html#%28part._.Port_.String_and_.List_.Conversions%29" class="tocviewlink" data-pltdoc="x">Port String and List Conversions</a></td></tr><tr><td align="right">13.1.10.2&nbsp;</td><td><a href="port-lib.html#%28part._.Creating_.Ports%29" class="tocviewlink" data-pltdoc="x">Creating Ports</a></td></tr><tr><td align="right">13.1.10.3&nbsp;</td><td><a href="port-lib.html#%28part._.Port_.Events%29" class="tocviewlink" data-pltdoc="x">Port Events</a></td></tr><tr><td align="right">13.1.10.4&nbsp;</td><td><a href="port-lib.html#%28part._.Copying_.Streams%29" class="tocviewlink" data-pltdoc="x">Copying Streams</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">13.1.10.1<tt>&nbsp;</tt></span><a href="port-lib.html#%28part._.Port_.String_and_.List_.Conversions%29" class="tocsubseclink" data-pltdoc="x">Port String and List Conversions</a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3elist%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>&gt;list</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3estring%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>&gt;string</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3ebytes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>&gt;bytes</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3elines%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>&gt;lines</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3ebytes-lines%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>&gt;bytes-<wbr></wbr>lines</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._display-lines%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">display-<wbr></wbr>lines</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._call-with-output-string%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>output-<wbr></wbr>string</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._call-with-output-bytes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>output-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._with-output-to-string%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">with-<wbr></wbr>output-<wbr></wbr>to-<wbr></wbr>string</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._with-output-to-bytes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">with-<wbr></wbr>output-<wbr></wbr>to-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._call-with-input-string%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>input-<wbr></wbr>string</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._call-with-input-bytes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>input-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._with-input-from-string%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">with-<wbr></wbr>input-<wbr></wbr>from-<wbr></wbr>string</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._with-input-from-bytes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">with-<wbr></wbr>input-<wbr></wbr>from-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><span class="tocsublinknumber">13.1.10.2<tt>&nbsp;</tt></span><a href="port-lib.html#%28part._.Creating_.Ports%29" class="tocsubseclink" data-pltdoc="x">Creating Ports</a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._input-port-append%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">input-<wbr></wbr>port-<wbr></wbr>append</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._make-input-port%2Fread-to-peek%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>input-<wbr></wbr>port/<span class="mywbr"> &nbsp;</span>read-<wbr></wbr>to-<wbr></wbr>peek</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._make-limited-input-port%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>limited-<wbr></wbr>input-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._make-pipe-with-specials%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>pipe-<wbr></wbr>with-<wbr></wbr>specials</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._combine-output%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">combine-<wbr></wbr>output</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._merge-input%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">merge-<wbr></wbr>input</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._open-output-nowhere%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">open-<wbr></wbr>output-<wbr></wbr>nowhere</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._peeking-input-port%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peeking-<wbr></wbr>input-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._reencode-input-port%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">reencode-<wbr></wbr>input-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._reencode-output-port%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">reencode-<wbr></wbr>output-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._dup-input-port%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dup-<wbr></wbr>input-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._dup-output-port%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">dup-<wbr></wbr>output-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._relocate-input-port%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">relocate-<wbr></wbr>input-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._relocate-output-port%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">relocate-<wbr></wbr>output-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._transplant-input-port%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">transplant-<wbr></wbr>input-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._transplant-output-port%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">transplant-<wbr></wbr>output-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._filter-read-input-port%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">filter-<wbr></wbr>read-<wbr></wbr>input-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._special-filter-input-port%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">special-<wbr></wbr>filter-<wbr></wbr>input-<wbr></wbr>port</span></span></a></td></tr><tr><td><span class="tocsublinknumber">13.1.10.3<tt>&nbsp;</tt></span><a href="port-lib.html#%28part._.Port_.Events%29" class="tocsubseclink" data-pltdoc="x">Port Events</a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._eof-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eof-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-bytes-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>bytes-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-bytes%21-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>bytes!-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-bytes-avail%21-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>bytes-<wbr></wbr>avail!-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-string-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>string-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-string%21-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>string!-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-line-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>line-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-bytes-line-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">read-<wbr></wbr>bytes-<wbr></wbr>line-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._peek-bytes-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-<wbr></wbr>bytes-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._peek-bytes%21-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-<wbr></wbr>bytes!-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._peek-bytes-avail%21-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-<wbr></wbr>bytes-<wbr></wbr>avail!-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._peek-string-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-<wbr></wbr>string-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._peek-string%21-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">peek-<wbr></wbr>string!-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._regexp-match-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>match-<wbr></wbr>evt</span></span></a></td></tr><tr><td><span class="tocsublinknumber">13.1.10.4<tt>&nbsp;</tt></span><a href="port-lib.html#%28part._.Copying_.Streams%29" class="tocsubseclink" data-pltdoc="x">Copying Streams</a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._convert-stream%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">convert-<wbr></wbr>stream</span></span></a></td></tr><tr><td><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._copy-port%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">copy-<wbr></wbr>port</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="customport.html" title="backward to &quot;13.1.9 Custom Ports&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ports.html" title="up to &quot;13.1 Ports&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Byte_and_String_Input.html" title="forward to &quot;13.2 Byte and String Input&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;port-lib&quot;">13.1.10<tt>&nbsp;</tt><a name="(part._port-lib)"></a><a name="(mod-path._racket/port)"></a>More Port Constructors, Procedures, and Events</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="port-lib.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/port</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="port-lib.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/port</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Port_String_and_List_Conversions&quot;">13.1.10.1<tt>&nbsp;</tt><a name="(part._.Port_.String_and_.List_.Conversions)"></a>Port String and List Conversions</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._port-~3elist))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3elist%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-&gt;list</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">r</span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">r</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list whose elements are produced by calling <span class="RktVar">r</span>
+on <span class="RktVar">in</span> until it produces <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">read-number</span><span class="hspace">&nbsp;</span><span class="RktSym">input-port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">char</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char%29%29" class="RktValLink" data-pltdoc="x">read-char</a></span><span class="hspace">&nbsp;</span><span class="RktSym">input-port</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">char</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">char</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._string-~3enumber%29%29" class="RktValLink" data-pltdoc="x">string-&gt;number</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string%29%29" class="RktValLink" data-pltdoc="x">string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">char</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3elist%29%29" class="RktValLink" data-pltdoc="x">port-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">read-number</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"12345"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3 4 5)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._port-~3estring))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3estring%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-&gt;string</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktPn">#:close?</span><span class="hspace">&nbsp;</span><span class="RktVar">close?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">close?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Reads all characters from <span class="RktVar">in</span> and returns them as a string.
+The input port is closed unless <span class="RktVar">close?</span> is <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3estring%29%29" class="RktValLink" data-pltdoc="x">port-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello world"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"hello world"</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.8.0.2 of package <span class="stt">base</span>: Added the <span class="RktPn">#:close?</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._port-~3ebytes))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3ebytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-&gt;bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktPn">#:close?</span><span class="hspace">&nbsp;</span><span class="RktVar">close?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">close?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Reads all bytes from <span class="RktVar">in</span> and returns them as a <a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte string</span></a>.
+The input port is closed unless <span class="RktVar">close?</span> is <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3ebytes%29%29" class="RktValLink" data-pltdoc="x">port-&gt;bytes</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello world"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"hello world"</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.8.0.2 of package <span class="stt">base</span>: Added the <span class="RktPn">#:close?</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._port-~3elines))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3elines%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-&gt;lines</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:line-mode</span><span class="hspace">&nbsp;</span><span class="RktVar">line-mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:close?</span><span class="hspace">&nbsp;</span><span class="RktVar">close?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">line-mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">linefeed</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return-linefeed</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any-one</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">any</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">close?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Read all characters from <span class="RktVar">in</span>, breaking them into lines. The
+<span class="RktVar">line-mode</span> argument is the same as the second argument to
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="RktValLink" data-pltdoc="x">read-line</a></span>, but the default is <span class="RktVal">'</span><span class="RktVal">any</span> instead of
+<span class="RktVal">'</span><span class="RktVal">linefeed</span>.
+The input port is closed unless <span class="RktVar">close?</span> is <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3elines%29%29" class="RktValLink" data-pltdoc="x">port-&gt;lines</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"line 1\nline 2\n</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">line 3\nline 4"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("line 1" "line 2" "</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">line 3" "line 4")</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.8.0.2 of package <span class="stt">base</span>: Added the <span class="RktPn">#:close?</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._port-~3ebytes-lines))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3ebytes-lines%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-&gt;bytes-lines</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:line-mode</span><span class="hspace">&nbsp;</span><span class="RktVar">line-mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:close?</span><span class="hspace">&nbsp;</span><span class="RktVar">close?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">line-mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">linefeed</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return-linefeed</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any-one</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">any</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">close?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3elines%29%29" class="RktValLink" data-pltdoc="x">port-&gt;lines</a></span>, but reading bytes and collecting them into
+lines like <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-line%29%29" class="RktValLink" data-pltdoc="x">read-bytes-line</a></span>.
+The input port is closed unless <span class="RktVar">close?</span> is <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3ebytes-lines%29%29" class="RktValLink" data-pltdoc="x">port-&gt;bytes-lines</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"line 1\nline 2\n</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">line 3\nline 4"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(#"line 1" #"line 2" #"</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">line 3" #"line 4")</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.8.0.2 of package <span class="stt">base</span>: Added the <span class="RktPn">#:close?</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._display-lines))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._display-lines%29%29" class="RktValDef RktValLink" data-pltdoc="x">display-lines</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">lst</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:separator</span><span class="hspace">&nbsp;</span><span class="RktVar">separator</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">separator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#"\n"</span></td></tr></table></blockquote></div><div class="SIntrapara">Uses <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> on each element of <span class="RktVar">lst</span> to <span class="RktVar">out</span>, adding
+<span class="RktVar">separator</span> after each element.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._call-with-output-string))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._call-with-output-string%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-output-string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Calls <span class="RktVar">proc</span> with an output port that accumulates all output
+into a string, and returns the string.</div></p><p>The port passed to <span class="RktVar">proc</span> is like the one created by
+<span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-string%29%29" class="RktValLink" data-pltdoc="x">open-output-string</a></span>, except that it is wrapped via
+<span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._dup-output-port%29%29" class="RktValLink" data-pltdoc="x">dup-output-port</a></span>, so that <span class="RktVar">proc</span> cannot access the
+port&rsquo;s content using <span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-string%29%29" class="RktValLink" data-pltdoc="x">get-output-string</a></span>. If control jumps back
+into <span class="RktVar">proc</span>, the port continues to accumulate new data, and
+<span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._call-with-output-string%29%29" class="RktValLink" data-pltdoc="x">call-with-output-string</a></span> returns both the old data and newly
+accumulated data.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._call-with-output-bytes))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._call-with-output-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-output-bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._call-with-output-string%29%29" class="RktValLink" data-pltdoc="x">call-with-output-string</a></span>, but returns the accumulated result
+in a <a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte string</span></a> instead of a string. Furthermore, the port&rsquo;s
+content is emptied when <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._call-with-output-bytes%29%29" class="RktValLink" data-pltdoc="x">call-with-output-bytes</a></span> returns, so
+that if control jumps back into <span class="RktVar">proc</span> and returns a second
+time, only the newly accumulated bytes are returned.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._with-output-to-string))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._with-output-to-string%29%29" class="RktValDef RktValLink" data-pltdoc="x">with-output-to-string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to</div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._call-with-output-string%29%29" class="RktValLink" data-pltdoc="x">call-with-output-string</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._with-output-to-bytes))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._with-output-to-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">with-output-to-bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to</div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._call-with-output-bytes%29%29" class="RktValLink" data-pltdoc="x">call-with-output-bytes</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._call-with-input-string))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._call-with-input-string%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-input-string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to <span class="RktPn">(</span><span class="RktVar">proc</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="stt"> </span><span class="RktVar">str</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._call-with-input-bytes))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._call-with-input-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-input-bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to <span class="RktPn">(</span><span class="RktVar">proc</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-bytes%29%29" class="RktValLink" data-pltdoc="x">open-input-bytes</a></span><span class="stt"> </span><span class="RktVar">bstr</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._with-input-from-string))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._with-input-from-string%29%29" class="RktValDef RktValLink" data-pltdoc="x">with-input-from-string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to</div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._with-input-from-bytes))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._with-input-from-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">with-input-from-bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to</div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-bytes%29%29" class="RktValLink" data-pltdoc="x">open-input-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Creating_Ports&quot;">13.1.10.2<tt>&nbsp;</tt><a name="(part._.Creating_.Ports)"></a>Creating Ports</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._input-port-append))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._input-port-append%29%29" class="RktValDef RktValLink" data-pltdoc="x">input-port-append</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">close-at-eof?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:name</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">close-at-eof?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Takes any number of input ports and returns an input port. Reading
+from the input port draws bytes (and special non-byte values) from the
+given input ports in order. If <span class="RktVar">close-at-eof?</span> is true, then
+each port is closed when an end-of-file is encountered from the port,
+or when the result input port is closed. Otherwise, data not read from
+the returned input port remains available for reading in its original
+input port.</div></p><p>The <span class="RktVar">name</span> argument determines the name as reported by
+<span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span> for the returned input port.</p><p>See also <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._merge-input%29%29" class="RktValLink" data-pltdoc="x">merge-input</a></span>, which interleaves data from multiple
+input ports as it becomes available.</p><p class="SHistory">Changed in version 6.90.0.19 of package <span class="stt">base</span>: Added the <span class="RktVar">name</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._make-input-port/read-to-peek))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._make-input-port%2Fread-to-peek%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-input-port/read-to-peek</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">read-in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">fast-peek</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">close</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">get-location</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">count-lines!</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">init-position</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">buffer-mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">buffering?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">on-consumed</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">read-in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">fast-peek</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">close</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">get-location</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">count-lines!</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">init-position</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">buffer-mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._case-~3e%29%29" class="RktStxLink" data-pltdoc="x">case-&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">block</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">none</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">block</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">none</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">buffering?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">on-consumed</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-input-port%29%29" class="RktValLink" data-pltdoc="x">make-input-port</a></span>, but if the given <span class="RktVar">read-in</span>
+returns an event, the event&rsquo;s value must be <span class="RktVal">0</span>.  The resulting
+port&rsquo;s peek operation is implemented automatically (in terms of
+<span class="RktVar">read-in</span>) in a way that can handle special non-byte
+values. The progress-event and commit operations are also implemented
+automatically. The resulting port is thread-safe, but not kill-safe
+(i.e., if a thread is terminated or suspended while using the port,
+the port may become damaged).</div></p><p>The <span class="RktVar">read-in</span>, <span class="RktVar">close</span>, <span class="RktVar">get-location</span>,
+<span class="RktVar">count-lines!</span>, <span class="RktVar">init-position</span>, and
+<span class="RktVar">buffer-mode</span> procedures are the same as for
+<span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-input-port%29%29" class="RktValLink" data-pltdoc="x">make-input-port</a></span>.</p><p>The <span class="RktVar">fast-peek</span> argument can be either <span class="RktVal">#f</span> or a
+procedure of three arguments: a byte string to receive a peek, a skip
+count, and a procedure of two arguments. The <span class="RktVar">fast-peek</span>
+procedure can either implement the requested peek, or it can dispatch
+to its third argument to implement the peek. The <span class="RktVar">fast-peek</span> is
+not used when a peek request has an associated progress event.</p><p>The <span class="RktVar">buffering?</span> argument determines whether <span class="RktVar">read-in</span>
+can be called to read more characters than are immediately demanded by
+the user of the new port. If <span class="RktVar">buffer-mode</span> is not <span class="RktVal">#f</span>,
+then <span class="RktVar">buffering?</span> determines the initial buffer mode, and
+<span class="RktVar">buffering?</span> is enabled after a buffering change only if the
+new mode is <span class="RktVal">'</span><span class="RktVal">block</span>.</p><p>If <span class="RktVar">on-consumed</span> is not <span class="RktVal">#f</span>, it is called when data is
+read (or committed) from the port, as opposed to merely peeked. The argument to
+<span class="RktVar">on-consumed</span> is the result value of the port&rsquo;s reading
+procedure, so it can be an integer or any result from
+<span class="RktVar">read-in</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._make-limited-input-port))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._make-limited-input-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-limited-input-port</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">limit</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">close-orig?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">close-orig?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a port whose content is drawn from <span class="RktVar">in</span>, but where an
+end-of-file is reported after <span class="RktVar">limit</span> bytes (and non-byte
+special values) have been read.  If <span class="RktVar">close-orig?</span> is true, then the
+original port is closed if the returned port is closed.</div></p><p>Bytes are consumed from <span class="RktVar">in</span> only when they are consumed from
+the returned port. In particular, peeking into the returned port peeks
+into the original port.</p><p>If <span class="RktVar">in</span> is used directly while the resulting port is also used,
+then the <span class="RktVar">limit</span> bytes provided by the port need not be
+contiguous parts of the original port&rsquo;s stream.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._make-pipe-with-specials))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._make-pipe-with-specials%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-pipe-with-specials</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">limit</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in-name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">out-name</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">pipe</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">pipe</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns two ports: an input port and an output port. The ports behave
+like those returned by <span class="RktSym"><a href="pipeports.html#%28def._%28%28quote._~23~25kernel%29._make-pipe%29%29" class="RktValLink" data-pltdoc="x">make-pipe</a></span>, except that the ports
+support non-byte values written with procedures such as
+<span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-special%29%29" class="RktValLink" data-pltdoc="x">write-special</a></span> and read with procedures such as
+<span class="RktSym">get-byte-or-special</span>.</div></p><p>The <span class="RktVar">limit</span> argument determines the maximum capacity of the
+pipe in bytes, but this limit is disabled if special values are
+written to the pipe before <span class="RktVar">limit</span> is reached. The limit is
+re-enabled after the special value is read from the pipe.</p><p>The optional <span class="RktVar">in-name</span> and <span class="RktVar">out-name</span> arguments
+determine the names of the result ports.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._combine-output))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._combine-output%29%29" class="RktValDef RktValLink" data-pltdoc="x">combine-output</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a-out</span><span class="hspace">&nbsp;</span><span class="RktVar">b-out</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a-out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b-out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Accepts two output ports and returns a new output port
+combining the original ports. When written to, the combined port
+first writes as many bytes as possible to <span class="RktVar">a-out</span>, and then
+tries to write the same number of bytes to <span class="RktVar">b-out</span>. If that
+doesn&rsquo;t succeed, what is left over is buffered and no further writes
+can go through until the ports are evened out. The port is ready (for
+the purposes of synchronization) when each port reports being ready.
+However, the first port may stop being ready while waiting on
+the second port to sync, so it cannot be guaranteed that both
+ports are ready at once. Closing the combined port is done
+after writing all remaining bytes to <span class="RktVar">b-out</span>.</div></p><p class="SHistory">Added in version 7.7.0.10 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._merge-input))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._merge-input%29%29" class="RktValDef RktValLink" data-pltdoc="x">merge-input</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a-in</span><span class="hspace">&nbsp;</span><span class="RktVar">b-in</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">buffer-limit</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a-in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b-in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">buffer-limit</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">4096</span></td></tr></table></blockquote></div><div class="SIntrapara">Accepts two input ports and returns a new input port. The new port
+merges the data from two original ports, so data can be read from the
+new port whenever it is available from either of the two original ports. The data
+from the original ports are interleaved. When an end-of-file has been
+read from an original port, it no longer contributes characters to the
+new port. After an end-of-file has been read from both original ports,
+the new port returns end-of-file. Closing the merged port does not
+close the original ports.</div></p><p>The optional <span class="RktVar">buffer-limit</span> argument limits the number of bytes
+to be buffered from <span class="RktVar">a-in</span> and <span class="RktVar">b-in</span>, so that the merge
+process does not advance arbitrarily beyond the rate of consumption of
+the merged data. A <span class="RktVal">#f</span> value disables the limit. As for
+<span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._make-pipe-with-specials%29%29" class="RktValLink" data-pltdoc="x">make-pipe-with-specials</a></span>, <span class="RktVar">buffer-limit</span> does not apply
+when a special value is produced by one of the input ports before the
+limit is reached.</p><p>See also <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._input-port-append%29%29" class="RktValLink" data-pltdoc="x">input-port-append</a></span>, which concatenates input streams
+instead of interleaving them.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._open-output-nowhere))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._open-output-nowhere%29%29" class="RktValDef RktValLink" data-pltdoc="x">open-output-nowhere</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span><span class="RktVar">special-ok?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">nowhere</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">special-ok?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara"><a name="(idx._(gentag._262._(lib._scribblings/reference/reference..scrbl)))"></a>Creates and returns an output port that discards all output sent to it
+(without blocking). The <span class="RktVar">name</span> argument is used as the port&rsquo;s
+name. If the <span class="RktVar">special-ok?</span>  argument is true, then the
+resulting port supports <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-special%29%29" class="RktValLink" data-pltdoc="x">write-special</a></span>, otherwise it does not.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._peeking-input-port))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._peeking-input-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">peeking-input-port</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">skip</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:init-position</span><span class="hspace">&nbsp;</span><span class="RktVar">init-position</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">init-position</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an input port whose content is determined by peeking into
+<span class="RktVar">in</span>. In other words, the resulting port contains an internal
+skip count, and each read of the port peeks into <span class="RktVar">in</span> with the
+internal skip count, and then increments the skip count according to
+the amount of data successfully peeked.</div></p><p>The optional <span class="RktVar">name</span> argument is the name of the resulting
+port. The <span class="RktVar">skip</span> argument is the port initial skip count, and
+it defaults to <span class="RktVal">0</span>.</p><p>The resulting port&rsquo;s initial position (as reported by <span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%29%29" class="RktValLink" data-pltdoc="x">file-position</a></span>)
+is <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">init-position</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span>, no matter the position of <span class="RktVar">in</span>.</p><p>The resulting port supports buffering, and a <span class="RktVal">'</span><span class="RktVal">block</span> buffer
+mode allows the port to peek further into <span class="RktVar">in</span> than
+requested. The resulting port&rsquo;s initial buffer mode is
+<span class="RktVal">'</span><span class="RktVal">block</span>, unless <span class="RktVar">in</span> supports buffer mode and its mode
+is initially <span class="RktVal">'</span><span class="RktVal">none</span> (i.e., the initial buffer mode is taken
+from <span class="RktVar">in</span> when it supports buffering). If <span class="RktVar">in</span> supports
+buffering, adjusting the resulting port&rsquo;s buffer mode via
+<span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-stream-buffer-mode%29%29" class="RktValLink" data-pltdoc="x">file-stream-buffer-mode</a></span> adjusts <span class="RktVar">in</span>&rsquo;s buffer mode.</p><p>For example, when you read from a peeking port, you
+see the same answers as when you read from the original port:</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">an-original-port</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"123456789"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a-peeking-port</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._peeking-input-port%29%29" class="RktValLink" data-pltdoc="x">peeking-input-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">an-original-port</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-stream-buffer-mode%29%29" class="RktValLink" data-pltdoc="x">file-stream-buffer-mode</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a-peeking-port</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">none</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="RktValLink" data-pltdoc="x">read-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktSym">a-peeking-port</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"123"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="RktValLink" data-pltdoc="x">read-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktSym">an-original-port</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"123"</span></p></td></tr></table></blockquote></div></p><p>Beware that the read from the original port is invisible to the peeking
+port, which keeps its own separate internal counter, and thus
+interleaving reads on the two ports can produce confusing results.
+Continuing the example before, if we read three more characters from
+the peeking port, we end up skipping over the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">456</span><span class="hspace"></span></span> in the port
+(but only because we disabled buffering above):</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="RktValLink" data-pltdoc="x">read-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktSym">a-peeking-port</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"789"</span></p></td></tr></table></blockquote></div></p><p>If we had left the buffer mode of <span class="RktSym">a-peeking-port</span> alone, that
+last <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-string%29%29" class="RktValLink" data-pltdoc="x">read-string</a></span> would have likely produced <span class="RktVal">"456"</span> as
+a result of buffering bytes from <span class="RktSym">an-original-port</span> earlier.</p><p class="SHistory">Changed in version 6.1.0.3 of package <span class="stt">base</span>: Enabled buffering and buffer-mode
+adjustments via <span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-stream-buffer-mode%29%29" class="RktValLink" data-pltdoc="x">file-stream-buffer-mode</a></span>,
+and set the port&rsquo;s initial buffer mode to that of
+<span class="RktVar">in</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._reencode-input-port))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._reencode-input-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">reencode-input-port</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">encoding</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">error-bytes</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">close?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">convert-newlines?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">enc-error</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">encoding</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">error-bytes</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">close?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">convert-newlines?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">enc-error</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">msg</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Produces an input port that draws bytes from <span class="RktVar">in</span>, but converts
+the byte stream using <span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span><span class="stt"> </span><span class="RktSym">encoding-str</span><span class="stt"> </span><span class="RktVal">"UTF-8"</span><span class="RktPn">)</span>. In addition, if <span class="RktVar">convert-newlines?</span> is true, then
+decoded sequences that correspond to UTF-8 encodings of <span class="RktVal">"\r\n"</span>,
+<span class="RktVal">"\r\u0085"</span>, <span class="RktVal">"\r"</span>, <span class="RktVal">"\u0085"</span>, and <span class="RktVal">"\u2028"</span>
+are all converted to the UTF-8 encoding of <span class="RktVal">"\n"</span>.</div></p><p>If <span class="RktVar">error-bytes</span> is provided and not <span class="RktVal">#f</span>, then the
+given byte sequence is used in place of bytes from <span class="RktVar">in</span> that
+trigger conversion errors.  Otherwise, if a conversion is encountered,
+<span class="RktVar">enc-error</span> is called, which must raise an exception.</p><p>If <span class="RktVar">close?</span> is true, then closing the result input port also
+closes <span class="RktVar">in</span>. The <span class="RktVar">name</span> argument is used as the name of
+the result input port.</p><p>In non-buffered mode, the resulting input port attempts to draw bytes
+from <span class="RktVar">in</span> only as needed to satisfy requests. Toward that end,
+the input port assumes that at least <span style="font-style: italic">n</span> bytes must be read to
+satisfy a request for <span style="font-style: italic">n</span> bytes. (This is true even if the port
+has already drawn some bytes, as long as those bytes form an
+incomplete encoding sequence.)</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._reencode-output-port))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._reencode-output-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">reencode-output-port</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">encoding</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">error-bytes</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">close?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">newline-bytes</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">enc-error</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">encoding</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">error-bytes</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">close?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span><span class="hspace">&nbsp;</span><span class="RktVar">out</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">newline-bytes</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">enc-error</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">msg</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Produces an output port that directs bytes to <span class="RktVar">out</span>, but
+converts its byte stream using <span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span><span class="stt"> </span><span class="RktVal">"UTF-8"</span><span class="stt"> </span><span class="RktSym">encoding-str</span><span class="RktPn">)</span>. In addition, if <span class="RktVar">newline-bytes</span> is not
+<span class="RktVal">#f</span>, then bytes written to the port that are the UTF-8
+encoding of <span class="RktVal">"\n"</span> are first converted to
+<span class="RktVar">newline-bytes</span> (before applying the convert from UTF-8 to
+<span class="RktSym">encoding-str</span>).</div></p><p>If <span class="RktVar">error-bytes</span> is provided and not <span class="RktVal">#f</span>, then the
+given byte sequence is used in place of bytes that have been sent to the output port
+and that trigger conversion errors. Otherwise, <span class="RktVar">enc-error</span> is
+called, which must raise an exception.</p><p>If <span class="RktVar">close?</span> is true, then closing the result output port also
+closes <span class="RktVar">out</span>. The <span class="RktVar">name</span> argument is used as the name of
+the result output port.</p><p>The resulting port supports buffering, and the initial buffer mode is
+<span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-stream-buffer-mode%29%29" class="RktValLink" data-pltdoc="x">file-stream-buffer-mode</a></span><span class="stt"> </span><span class="RktVar">out</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">block</span><span class="RktPn">)</span>. In <span class="RktVal">'</span><span class="RktVal">block</span>
+mode, the port&rsquo;s buffer is flushed only when it is full or a flush is
+requested explicitly. In <span class="RktVal">'</span><span class="RktVal">line</span> mode, the buffer is flushed
+whenever a newline or carriage-return byte is written to the port. In
+<span class="RktVal">'</span><span class="RktVal">none</span> mode, the port&rsquo;s buffer is flushed after every write.
+Implicit flushes for <span class="RktVal">'</span><span class="RktVal">line</span> or <span class="RktVal">'</span><span class="RktVal">none</span> leave bytes in
+the buffer when they are part of an incomplete encoding sequence.</p><p>The resulting output port does not support atomic writes. An explicit
+flush or special-write to the output port can hang if the most
+recently written bytes form an incomplete encoding sequence.</p><p>When the port is buffered, a <a href="plumbers.html#%28tech._flush._callback%29" class="techoutside" data-pltdoc="x"><span class="techinside">flush callback</span></a> is registered with
+the <a href="plumbers.html#%28tech._current._plumber%29" class="techoutside" data-pltdoc="x"><span class="techinside">current plumber</span></a> to flush the buffer.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._dup-input-port))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._dup-input-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">dup-input-port</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">close?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">close?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an input port that draws directly from <span class="RktVar">in</span>. Closing
+the resulting port closes <span class="RktVar">in</span> only if <span class="RktVar">close?</span> is
+<span class="RktVal">#t</span>.</div></p><p>The new port is initialized with the <a href="Reading.html#%28tech._port._read._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">port read handler</span></a> of
+<span class="RktVar">in</span>, but setting the handler on the result port does not
+affect reading directly from <span class="RktVar">in</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._dup-output-port))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._dup-output-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">dup-output-port</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">close?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">close?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an output port that propagates data directly to
+<span class="RktVar">out</span>. Closing the resulting port closes <span class="RktVar">out</span> only if
+<span class="RktVar">close?</span> is <span class="RktVal">#t</span>.</div></p><p>The new port is initialized with the <a href="Writing.html#%28tech._port._display._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">port display handler</span></a> and
+<a href="Writing.html#%28tech._port._write._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">port write handler</span></a> of <span class="RktVar">out</span>, but setting the handlers on
+the result port does not affect writing directly to <span class="RktVar">out</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._relocate-input-port))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._relocate-input-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">relocate-input-port</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">line</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">column</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">position</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">close?</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:name</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">line</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">column</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">position</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">close?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces an input port that is equivalent to <span class="RktVar">in</span> except in how
+it reports location information (and possibly its name). The resulting port&rsquo;s content starts
+with the remaining content of <span class="RktVar">in</span>, and it starts at the given
+line, column, and position. A <span class="RktVal">#f</span> for the line or column means
+that the line and column will always be reported as <span class="RktVal">#f</span>.</div></p><p>The <span class="RktVar">line</span> and <span class="RktVar">column</span> values are used only if line
+counting is enabled for <span class="RktVar">in</span> and for the resulting port,
+typically through <span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-count-lines%21%29%29" class="RktValLink" data-pltdoc="x">port-count-lines!</a></span>. The <span class="RktVar">column</span>
+value determines the column for the first line (i.e., the one numbered
+<span class="RktVar">line</span>), and later lines start at column <span class="RktVal">0</span>. The given
+<span class="RktVar">position</span> is used even if line counting is not enabled.</p><p>When line counting is on for the resulting port, reading from
+<span class="RktVar">in</span> instead of the resulting port increments location reports
+from the resulting port. Otherwise, the resulting port&rsquo;s position does
+not increment when data is read from <span class="RktVar">in</span>.</p><p>If <span class="RktVar">close?</span> is true, then closing the resulting port also
+closes <span class="RktVar">in</span>. If <span class="RktVar">close?</span> is <span class="RktVal">#f</span>, then closing
+the resulting port does not close <span class="RktVar">in</span>.</p><p>The <span class="RktVar">name</span> argument is used as the name for the resulting port;
+the default value keeps the same name as <span class="RktVar">in</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._relocate-output-port))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._relocate-output-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">relocate-output-port</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">line</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">column</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">position</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">close?</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:name</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">line</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">column</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">position</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">close?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span><span class="hspace">&nbsp;</span><span class="RktVar">out</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._relocate-input-port%29%29" class="RktValLink" data-pltdoc="x">relocate-input-port</a></span>, but for output ports.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._transplant-input-port))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._transplant-input-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">transplant-input-port</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">get-location</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">init-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">close?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">count-lines!</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:name</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">get-location</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">init-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">close?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">count-lines!</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._relocate-input-port%29%29" class="RktValLink" data-pltdoc="x">relocate-input-port</a></span>, except that arbitrary position
+information can be produced (when line counting is enabled) via
+<span class="RktVar">get-location</span>, which is used as for <span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-input-port%29%29" class="RktValLink" data-pltdoc="x">make-input-port</a></span>. If
+<span class="RktVar">get-location</span> is <span class="RktVal">#f</span>, then the port counts lines in
+the usual way starting from <span class="RktVar">init-pos</span>, independent of
+locations reported by <span class="RktVar">in</span>.</div></p><p>If <span class="RktVar">count-lines!</span> is supplied, it is called when line counting
+is enabled for the resulting port. The default is <span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._transplant-output-port))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._transplant-output-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">transplant-output-port</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">get-location</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">init-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">close?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">count-lines!</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:name</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">get-location</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">init-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">close?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">count-lines!</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span><span class="hspace">&nbsp;</span><span class="RktVar">out</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._transplant-input-port%29%29" class="RktValLink" data-pltdoc="x">transplant-input-port</a></span>, but for output ports.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._filter-read-input-port))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._filter-read-input-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">filter-read-input-port</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">read-wrap</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">peek-wrap</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">close?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">read-wrap</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">peek-wrap</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">close?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a port that draws from <span class="RktVar">in</span>, but each result from the
+port&rsquo;s read and peek procedures (in the sense of <span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-input-port%29%29" class="RktValLink" data-pltdoc="x">make-input-port</a></span>)
+is filtered by <span class="RktVar">read-wrap</span> and
+<span class="RktVar">peek-wrap</span>. The filtering procedures each receive both the
+arguments and results of the read and peek procedures on <span class="RktVar">in</span>
+for each call.</div></p><p>If <span class="RktVar">close?</span> is true, then closing the resulting port also
+closes <span class="RktVar">in</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._special-filter-input-port))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._special-filter-input-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">special-filter-input-port</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">close?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">close?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces an input port that is equivalent to <span class="RktVar">in</span>, except
+that when <span class="RktVar">in</span> produces a procedure to access a special value,
+<span class="RktVar">proc</span> is applied to the procedure to allow the special value
+to be replaced with an alternative. The <span class="RktVar">proc</span> is called with
+the special-value procedure and the byte string that was given to the
+port&rsquo;s read or peek function (see <span class="RktSym"><a href="customport.html#%28def._%28%28quote._~23~25kernel%29._make-input-port%29%29" class="RktValLink" data-pltdoc="x">make-input-port</a></span>), and the
+result is used as the read or peek function&rsquo;s result.  The
+<span class="RktVar">proc</span> can modify the byte string to substitute a byte for the
+special value, but the byte string is guaranteed only to hold at least
+one byte.</div></p><p>If <span class="RktVar">close?</span> is true, then closing the resulting input port also
+closes <span class="RktVar">in</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Port_Events&quot;">13.1.10.3<tt>&nbsp;</tt><a name="(part._.Port_.Events)"></a>Port Events</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._eof-evt))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._eof-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">eof-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> that is ready when
+<span class="RktVar">in</span> produces an <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>. If <span class="RktVar">in</span> produces a
+mid-stream <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>, the <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> is consumed by the event
+only if the event is chosen in a synchronization.</div></p><p>If attempting to read from <span class="RktVar">in</span> raises an exception during a
+synchronization attempt, then the exception may be reported during the
+synchronization attempt, but it will silently discarded if some another
+event in the same synchronization is selected or if some other event
+raises an exception first.</p><p class="SHistory">Changed in version 7.5.0.3 of package <span class="stt">base</span>: Changed handling of read errors so
+they are propagated to a synchronization attempt,
+instead of treated as unhandled errors in a
+background thread.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._read-bytes-evt))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-bytes-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-bytes-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> that is ready when <span class="RktVar">k</span>
+bytes can be read from <span class="RktVar">in</span>, or when an end-of-file is
+encountered in <span class="RktVar">in</span>. If <span class="RktVar">k</span> is <span class="RktVal">0</span>, then the
+event is ready immediately with <span class="RktVal">""</span>. For non-zero <span class="RktVar">k</span>,
+if no bytes are available before an end-of-file, the event&rsquo;s result is
+<span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>. Otherwise, the event&rsquo;s result is a byte string of up to
+<span class="RktVar">k</span> bytes, which contains as many bytes as are available (up to
+<span class="RktVar">k</span>) before an available end-of-file. (The result is a byte
+string on less than <span class="RktVar">k</span> bytes only when an end-of-file is
+encountered.)</div></p><p>Bytes are read from the port if and only if the event is chosen in a
+synchronization, and the returned bytes always represent contiguous
+bytes in the port&rsquo;s stream.</p><p>The event can be synchronized multiple times&#8212;<wbr></wbr>event
+concurrently&#8212;<wbr></wbr>and each synchronization corresponds to a distinct read
+request.</p><p>The <span class="RktVar">in</span> must support progress events, and it must not produce
+a special non-byte value during the read attempt.</p><p>Exceptions attempting to read from <span class="RktVar">in</span> are handled in the same
+way as by <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._eof-evt%29%29" class="RktValLink" data-pltdoc="x">eof-evt</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._read-bytes!-evt))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-bytes%21-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-bytes!-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-bytes-evt%29%29" class="RktValLink" data-pltdoc="x">read-bytes-evt</a></span>, except that the read bytes are placed
+into <span class="RktVar">bstr</span>, and the number of bytes to read corresponds to
+<span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="stt"> </span><span class="RktVar">bstr</span><span class="RktPn">)</span>. The event&rsquo;s result is either
+<span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> or the number of read bytes.</div></p><p>The <span class="RktVar">bstr</span> may be mutated any time after the first
+synchronization attempt on the event and until either the event is
+selected, a non-<span class="RktVal">#f</span> <span class="RktSym">progress-evt</span> is ready, or the
+current <a href="eval-model.html#%28tech._custodian%29" class="techoutside" data-pltdoc="x"><span class="techinside">custodian</span></a> (at the time of synchronization) is shut
+down. Note that there is no time bound otherwise on when <span class="RktVar">bstr</span>
+might be mutated if the event is not selected by a synchronzation;
+nevertheless, multiple synchronization attempts can use the same
+result from <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-bytes%21-evt%29%29" class="RktValLink" data-pltdoc="x">read-bytes!-evt</a></span> as long as there is no
+intervening read on <span class="RktVar">in</span> until one of the synchronization
+attempts selects the event.</p><p>Exceptions attempting to read from <span class="RktVar">in</span> are handled in the same
+way as by <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._eof-evt%29%29" class="RktValLink" data-pltdoc="x">eof-evt</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._read-bytes-avail!-evt))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-bytes-avail%21-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-bytes-avail!-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-bytes%21-evt%29%29" class="RktValLink" data-pltdoc="x">read-bytes!-evt</a></span>, except that the event reads only as
+many bytes as are immediately available, after at least one byte or
+one <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> becomes available.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._read-string-evt))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-string-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-string-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-bytes-evt%29%29" class="RktValLink" data-pltdoc="x">read-bytes-evt</a></span>, but for character strings instead of
+byte strings.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._read-string!-evt))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-string%21-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-string!-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-bytes%21-evt%29%29" class="RktValLink" data-pltdoc="x">read-bytes!-evt</a></span>, but for a character string instead of
+a byte string.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._read-line-evt))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-line-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-line-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">mode</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">linefeed</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return-linefeed</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any-one</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">linefeed</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> that is ready when a line of
+characters or end-of-file can be read from <span class="RktVar">in</span>. The
+meaning of <span class="RktVar">mode</span> is the same as for <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="RktValLink" data-pltdoc="x">read-line</a></span>. The
+event result is the read line of characters (not including the line
+separator).</div></p><p>A line is read from the port if and only if the event is chosen in a
+synchronization, and the returned line always represents contiguous
+bytes in the port&rsquo;s stream.</p><p>Exceptions attempting to read from <span class="RktVar">in</span> are handled in the same
+way as by <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._eof-evt%29%29" class="RktValLink" data-pltdoc="x">eof-evt</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._read-bytes-line-evt))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-bytes-line-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">read-bytes-line-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">mode</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">linefeed</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return-linefeed</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any-one</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">linefeed</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-line-evt%29%29" class="RktValLink" data-pltdoc="x">read-line-evt</a></span>, but returns a byte string instead of a
+string.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._peek-bytes-evt))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._peek-bytes-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">peek-bytes-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">skip</span><span class="hspace">&nbsp;</span><span class="RktVar">progress-evt</span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">progress-evt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._progress-evt~3f%29%29" class="RktValLink" data-pltdoc="x">progress-evt?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._peek-bytes!-evt))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._peek-bytes%21-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">peek-bytes!-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktVar">skip</span><span class="hspace">&nbsp;</span><span class="RktVar">progress-evt</span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">progress-evt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._progress-evt~3f%29%29" class="RktValLink" data-pltdoc="x">progress-evt?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._peek-bytes-avail!-evt))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._peek-bytes-avail%21-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">peek-bytes-avail!-evt</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">skip</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">progress-evt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">progress-evt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._progress-evt~3f%29%29" class="RktValLink" data-pltdoc="x">progress-evt?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._peek-string-evt))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._peek-string-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">peek-string-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">skip</span><span class="hspace">&nbsp;</span><span class="RktVar">progress-evt</span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">progress-evt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._progress-evt~3f%29%29" class="RktValLink" data-pltdoc="x">progress-evt?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._peek-string!-evt))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._peek-string%21-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">peek-string!-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktVar">skip</span><span class="hspace">&nbsp;</span><span class="RktVar">progress-evt</span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">skip</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">progress-evt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._progress-evt~3f%29%29" class="RktValLink" data-pltdoc="x">progress-evt?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like the <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._read-bytes-evt%29%29" class="RktValLink" data-pltdoc="x">read-bytes-evt</a></span>, etc., functions, but for peeking. The
+<span class="RktVar">skip</span> argument indicates the number of bytes to skip, and
+<span class="RktVar">progress-evt</span> indicates an event that effectively cancels the peek
+(so that the event never becomes ready). The <span class="RktVar">progress-evt</span>
+argument can be <span class="RktVal">#f</span>, in which case the event is never
+canceled.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._regexp-match-evt))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._regexp-match-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-match-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> that is ready when
+<span class="RktVar">pattern</span> matches the stream of bytes/characters from
+<span class="RktVar">in</span>; see also <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span>. The event&rsquo;s value is the
+result of the match, in the same form as the result of
+<span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span>.</div></p><p>If <span class="RktVar">pattern</span> does not require a start-of-stream match, then
+bytes skipped to complete the match are read and discarded when the
+event is chosen in a synchronization.</p><p>Bytes are read from the port if and only if the event is chosen in a
+synchronization, and the returned match always represents contiguous
+bytes in the port&rsquo;s stream. If not-yet-available bytes from the port
+might contribute to the match, the event is not ready.  Similarly, if
+<span class="RktVar">pattern</span> begins with a start-of-stream <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span> and the
+<span class="RktVar">pattern</span> does not initially match, then the event cannot
+become ready until bytes have been read from the port.</p><p>The event can be synchronized multiple times&#8212;<wbr></wbr>even concurrently&#8212;<wbr></wbr>and
+each synchronization corresponds to a distinct match request.</p><p>The <span class="RktVar">in</span> port must support progress events. If <span class="RktVar">in</span>
+returns a special non-byte value during the match attempt, it is
+treated like <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>.</p><p>Exceptions attempting to read from <span class="RktVar">in</span> are handled in the same
+way as by <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._eof-evt%29%29" class="RktValLink" data-pltdoc="x">eof-evt</a></span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Copying_Streams&quot;">13.1.10.4<tt>&nbsp;</tt><a name="(part._.Copying_.Streams)"></a>Copying Streams</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._convert-stream))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._convert-stream%29%29" class="RktValDef RktValLink" data-pltdoc="x">convert-stream</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">from-encoding</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">to-encoding</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">out</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">from-encoding</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">to-encoding</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Reads data from <span class="RktVar">in</span>, converts it using
+<span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span><span class="stt"> </span><span class="RktVar">from-encoding</span><span class="stt"> </span><span class="RktVar">to-encoding</span><span class="RktPn">)</span> and writes the converted bytes to
+<span class="RktVar">out</span>. The <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._convert-stream%29%29" class="RktValLink" data-pltdoc="x">convert-stream</a></span> procedure returns after
+reaching <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> in <span class="RktVar">in</span>.</div></p><p>If opening the converter fails, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span> exception is raised. Similarly, if
+a conversion error occurs at any point while reading from <span class="RktVar">in</span>, then
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/port..rkt)._copy-port))"></a><span title="Provided from: racket/port, racket | Package: base"><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._copy-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">copy-port</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Reads data from <span class="RktVar">in</span> and writes it back out to <span class="RktVar">out</span>,
+returning when <span class="RktVar">in</span> produces <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>.  The copy is
+efficient, and it is without significant buffer delays (i.e., a byte
+that becomes available on <span class="RktVar">in</span> is immediately transferred to
+<span class="RktVar">out</span>, even if future reads on <span class="RktVar">in</span> must block). If
+<span class="RktVar">in</span> produces a special non-byte value, it is transferred to
+<span class="RktVar">out</span> using <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-special%29%29" class="RktValLink" data-pltdoc="x">write-special</a></span>.</div></p><p>This function is often called from a &ldquo;background&rdquo; thread to
+continuously pump data from one stream to another.</p><p>If multiple <span class="RktVar">out</span>s are provided, data from <span class="RktVar">in</span> is
+written to every <span class="RktVar">out</span>. The different <span class="RktVar">out</span>s block
+output to each other, because each block of data read from <span class="RktVar">in</span>
+is written completely to one <span class="RktVar">out</span> before moving to the next
+<span class="RktVar">out</span>. The <span class="RktVar">out</span>s are written in the provided order, so
+non-blocking ports (e.g., file output ports) should be placed first in the
+argument list.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="customport.html" title="backward to &quot;13.1.9 Custom Ports&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ports.html" title="up to &quot;13.1 Ports&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Byte_and_String_Input.html" title="forward to &quot;13.2 Byte and String Input&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/port-ops.html b/clones/docs.racket-lang.org/reference/port-ops.html
new file mode 100644
index 00000000..4eab9524
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/port-ops.html
@@ -0,0 +1,34 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.1.2&nbsp;Managing Ports</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewselflink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1.1&nbsp;</td><td><a href="encodings.html" class="tocviewlink" data-pltdoc="x">Encodings and Locales</a></td></tr><tr><td align="right">13.1.2&nbsp;</td><td><a href="port-ops.html" class="tocviewselflink" data-pltdoc="x">Managing Ports</a></td></tr><tr><td align="right">13.1.3&nbsp;</td><td><a href="port-buffers.html" class="tocviewlink" data-pltdoc="x">Port Buffers and Positions</a></td></tr><tr><td align="right">13.1.4&nbsp;</td><td><a href="linecol.html" class="tocviewlink" data-pltdoc="x">Counting Positions, Lines, and Columns</a></td></tr><tr><td align="right">13.1.5&nbsp;</td><td><a href="file-ports.html" class="tocviewlink" data-pltdoc="x">File Ports</a></td></tr><tr><td align="right">13.1.6&nbsp;</td><td><a href="stringport.html" class="tocviewlink" data-pltdoc="x">String Ports</a></td></tr><tr><td align="right">13.1.7&nbsp;</td><td><a href="pipeports.html" class="tocviewlink" data-pltdoc="x">Pipes</a></td></tr><tr><td align="right">13.1.8&nbsp;</td><td><a href="portstructs.html" class="tocviewlink" data-pltdoc="x">Structures as Ports</a></td></tr><tr><td align="right">13.1.9&nbsp;</td><td><a href="customport.html" class="tocviewlink" data-pltdoc="x">Custom Ports</a></td></tr><tr><td align="right">13.1.10&nbsp;</td><td><a href="port-lib.html" class="tocviewlink" data-pltdoc="x">More Port Constructors, Procedures, and Events</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">input-<wbr></wbr>port?</span></span></a></td></tr><tr><td><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">output-<wbr></wbr>port?</span></span></a></td></tr><tr><td><a href="port-ops.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._port~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port?</span></span></a></td></tr><tr><td><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-input-port%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">close-<wbr></wbr>input-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-output-port%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">close-<wbr></wbr>output-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._port-closed~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>closed?</span></span></a></td></tr><tr><td><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._port-closed-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>closed-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>input-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>output-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-error-port%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>error-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._file-stream-port~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">file-<wbr></wbr>stream-<wbr></wbr>port?</span></span></a></td></tr><tr><td><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._terminal-port~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">terminal-<wbr></wbr>port?</span></span></a></td></tr><tr><td><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._port-waiting-peer~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>waiting-<wbr></wbr>peer?</span></span></a></td></tr><tr><td><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eof</span></span></a></td></tr><tr><td><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eof-<wbr></wbr>object?</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="encodings.html" title="backward to &quot;13.1.1 Encodings and Locales&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ports.html" title="up to &quot;13.1 Ports&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="port-buffers.html" title="forward to &quot;13.1.3 Port Buffers and Positions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;port-ops&quot;">13.1.2<tt>&nbsp;</tt><a name="(part._port-ops)"></a>Managing Ports</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._input-port~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">input-port?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is an <a href="ports.html#%28tech._input._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">input port</span></a>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._output-port~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">output-port?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is an <a href="ports.html#%28tech._output._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">output port</span></a>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._port~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-ops.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._port~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">port?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if either <span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span> or
+<span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span> is <span class="RktVal">#t</span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._close-input-port))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-input-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">close-input-port</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Closes the input port <span class="RktVar">in</span>. For some kinds of ports, closing
+the port releases lower-level resources, such as a file handle. If
+the port is already closed, <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-input-port%29%29" class="RktValLink" data-pltdoc="x">close-input-port</a></span> has no effect.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._close-output-port))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-output-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">close-output-port</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">out</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Closes the output port <span class="RktVar">out</span>. For some kinds of ports, closing
+the port releases lower-level resources, such as a file handle. Also,
+if the port is buffered, closing may first flush the port before
+closing it, and this flushing process can block. If the port is
+already closed, <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-output-port%29%29" class="RktValLink" data-pltdoc="x">close-output-port</a></span> has no effect.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._port-closed~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._port-closed~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-closed?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">port</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._port~3f%29%29" class="RktValLink" data-pltdoc="x">port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if the input or output port <span class="RktVar">port</span> is
+closed, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._port-closed-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._port-closed-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-closed-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">port</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._port~3f%29%29" class="RktValLink" data-pltdoc="x">port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Return a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> that becomes <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for
+synchronization</span></a> when <span class="RktVar">port</span> is
+closed. The <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> of a port-closed event is the port-closed event itself.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-input-port))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-input-port</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-input-port</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that
+determines a default input port for many operations, such as
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-output-port))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-output-port</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-output-port</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">out</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that
+determines a default output port for many operations, such as
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-error-port))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-error-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-error-port</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-error-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-error-port</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">out</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that
+determines an output port that is typically used for errors and
+logging. For example, the default error display handler writes to this
+port.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._file-stream-port~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._file-stream-port~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">file-stream-port?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file-stream port</span></a> (see
+<a href="file-ports.html" data-pltdoc="x">File Ports</a>), <span class="RktVal">#f</span> otherwise.</div></p><p class="SHistory">Changed in version 7.2.0.5 of package <span class="stt">base</span>: Extended <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._file-stream-port~3f%29%29" class="RktValLink" data-pltdoc="x">file-stream-port?</a></span>
+to any value, instead of resticting
+the domain to ports</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._terminal-port~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._terminal-port~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">terminal-port?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a port that is attached to an
+interactive terminal, <span class="RktVal">#f</span> otherwise.</div></p><p class="SHistory">Changed in version 7.2.0.5 of package <span class="stt">base</span>: Extended <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._terminal-port~3f%29%29" class="RktValLink" data-pltdoc="x">terminal-port?</a></span>
+to any value, instead of resticting
+the domain to ports</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._port-waiting-peer~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._port-waiting-peer~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-waiting-peer?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">port</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._port~3f%29%29" class="RktValLink" data-pltdoc="x">port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">port</span> is not ready for reading or
+writing because it is waiting for a peer process to complete a stream
+construction, <span class="RktVal">#f</span> otherwise.</div></p><p>On Unix and Mac OS, opening a fifo for output creates a peer-waiting
+port if no reader for the same fifo is already opened. In that case,
+the output port is not ready for writing until a reader is opened;
+that is, write opertaions will block. Use <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span> if necessary
+to wait until writing will not block&#8212;<wbr></wbr>that is, until the read end of
+the fifo is opened.</p><p class="SHistory">Added in version 7.4.0.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._eof))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValDef RktValLink" data-pltdoc="x">eof</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A value (distinct from all other values)
+that represents an end-of-file.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._eof-object~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">eof-object?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if
+<span class="RktVar">v</span> is <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="encodings.html" title="backward to &quot;13.1.1 Encodings and Locales&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ports.html" title="up to &quot;13.1 Ports&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="port-buffers.html" title="forward to &quot;13.1.3 Port Buffers and Positions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/ports.html b/clones/docs.racket-lang.org/reference/ports.html
new file mode 100644
index 00000000..f5bf80bc
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/ports.html
@@ -0,0 +1,40 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.1&nbsp;Ports</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewselflink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>13.1&nbsp;</td><td><a href="ports.html" class="tocviewselflink" data-pltdoc="x">Ports</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1.1&nbsp;</td><td><a href="encodings.html" class="tocviewlink" data-pltdoc="x">Encodings and Locales</a></td></tr><tr><td align="right">13.1.2&nbsp;</td><td><a href="port-ops.html" class="tocviewlink" data-pltdoc="x">Managing Ports</a></td></tr><tr><td align="right">13.1.3&nbsp;</td><td><a href="port-buffers.html" class="tocviewlink" data-pltdoc="x">Port Buffers and Positions</a></td></tr><tr><td align="right">13.1.4&nbsp;</td><td><a href="linecol.html" class="tocviewlink" data-pltdoc="x">Counting Positions, Lines, and Columns</a></td></tr><tr><td align="right">13.1.5&nbsp;</td><td><a href="file-ports.html" class="tocviewlink" data-pltdoc="x">File Ports</a></td></tr><tr><td align="right">13.1.6&nbsp;</td><td><a href="stringport.html" class="tocviewlink" data-pltdoc="x">String Ports</a></td></tr><tr><td align="right">13.1.7&nbsp;</td><td><a href="pipeports.html" class="tocviewlink" data-pltdoc="x">Pipes</a></td></tr><tr><td align="right">13.1.8&nbsp;</td><td><a href="portstructs.html" class="tocviewlink" data-pltdoc="x">Structures as Ports</a></td></tr><tr><td align="right">13.1.9&nbsp;</td><td><a href="customport.html" class="tocviewlink" data-pltdoc="x">Custom Ports</a></td></tr><tr><td align="right">13.1.10&nbsp;</td><td><a href="port-lib.html" class="tocviewlink" data-pltdoc="x">More Port Constructors, Procedures, and Events</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="input-and-output.html" title="backward to &quot;13 Input and Output&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="encodings.html" title="forward to &quot;13.1.1 Encodings and Locales&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;ports&quot;">13.1<tt>&nbsp;</tt><a name="(part._ports)"></a>Ports</h4><p><a name="(tech._port)"></a><span style="font-style: italic">Ports</span> produce and/or consume bytes. An <a name="(tech._input._port)"></a><span style="font-style: italic">input port</span>
+produces bytes, while an <a name="(tech._output._port)"></a><span style="font-style: italic">output port</span> consumes bytes (and
+some ports are both input ports and output ports). When an input port
+is provided to a character-based operation, the bytes are decoded to a
+character, and character-based output operations similarly encode the
+character to bytes; see <a href="encodings.html" data-pltdoc="x">Encodings and Locales</a>. In addition to bytes and
+characters encoded as bytes, some ports can produce and/or consume
+arbitrary values as <a name="(tech._special)"></a><span style="font-style: italic">special</span> results.</p><p>When a port corresponds to a file, network connection, or some other
+system resource, it must be explicitly closed via
+<span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-input-port%29%29" class="RktValLink" data-pltdoc="x">close-input-port</a></span> or <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-output-port%29%29" class="RktValLink" data-pltdoc="x">close-output-port</a></span> (or indirectly
+via <span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-shutdown-all%29%29" class="RktValLink" data-pltdoc="x">custodian-shutdown-all</a></span>) to release low-level resources
+associated with the port. For any kind of port, after it is closed,
+attempting to read from or write to the port raises <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span>.</p><p>Data produced by a <a href="ports.html#%28tech._input._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">input port</span></a> can be read or <a name="(tech._peek)"></a><span style="font-style: italic">peeked</span>. When data is read, it is considered consumed and
+removed from the port&rsquo;s stream. When data is <a href="ports.html#%28tech._peek%29" class="techoutside" data-pltdoc="x"><span class="techinside">peek</span></a>ed, it remains
+in the port&rsquo;s stream to be returned again by the next read or
+<a href="ports.html#%28tech._peek%29" class="techoutside" data-pltdoc="x"><span class="techinside">peek</span></a>. Previously peeked data can be <a name="(tech._commit)"></a><span style="font-style: italic">committed</span>, which causes the data to be removed from the
+port as for a read in a way that can be synchronized with other
+attempts to <a href="ports.html#%28tech._peek%29" class="techoutside" data-pltdoc="x"><span class="techinside">peek</span></a> or read through a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable
+event</span></a>. Both read and <a href="ports.html#%28tech._peek%29" class="techoutside" data-pltdoc="x"><span class="techinside">peek</span></a> operations are normally blocking, in
+the sense that the read or <a href="ports.html#%28tech._peek%29" class="techoutside" data-pltdoc="x"><span class="techinside">peek</span></a> operation does not complete
+until data is available from the port; non-blocking variants of read
+and <a href="ports.html#%28tech._peek%29" class="techoutside" data-pltdoc="x"><span class="techinside">peek</span></a> operations are also available.</p><p>The global variable <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span> is bound to the end-of-file value,
+and <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span> returns <span class="RktVal">#t</span> only when applied to this
+value. Reading from a port produces an end-of-file result when the
+port has no more data, but some ports may also return end-of-file
+mid-stream. For example, a port connected to a Unix terminal returns
+an end-of-file when the user types control-D; if the user provides
+more input, the port returns additional bytes after the end-of-file.</p><p>Every port has a name, as reported by <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span>. The name
+can be any value, and it is used mostly for error-reporting
+purposes. The <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> procedure uses the name of an input
+port as the default source location for the <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax objects</span></a> that
+it produces.</p><p>A port can be used as a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a>. An input port is
+<a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-byte%29%29" class="RktValLink" data-pltdoc="x">read-byte</a></span> would not
+block, and an output port is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when
+<span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail</a></span> would not block or when the port contains
+buffered characters and <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%2A%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail*</a></span> can flush part of
+the buffer (although <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes-avail%29%29" class="RktValLink" data-pltdoc="x">write-bytes-avail</a></span> might block). A value
+that can act as both an input port and an output port acts as an input
+port for a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a>. The <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> of a port is the port itself.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="encodings.html" class="toclink" data-pltdoc="x">13.1.1<span class="hspace">&nbsp;</span>Encodings and Locales</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="port-ops.html" class="toclink" data-pltdoc="x">13.1.2<span class="hspace">&nbsp;</span>Managing Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="port-buffers.html" class="toclink" data-pltdoc="x">13.1.3<span class="hspace">&nbsp;</span>Port Buffers and Positions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="linecol.html" class="toclink" data-pltdoc="x">13.1.4<span class="hspace">&nbsp;</span>Counting Positions, Lines, and Columns</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="file-ports.html" class="toclink" data-pltdoc="x">13.1.5<span class="hspace">&nbsp;</span>File Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stringport.html" class="toclink" data-pltdoc="x">13.1.6<span class="hspace">&nbsp;</span>String Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pipeports.html" class="toclink" data-pltdoc="x">13.1.7<span class="hspace">&nbsp;</span>Pipes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="portstructs.html" class="toclink" data-pltdoc="x">13.1.8<span class="hspace">&nbsp;</span>Structures as Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="customport.html" class="toclink" data-pltdoc="x">13.1.9<span class="hspace">&nbsp;</span>Custom Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="port-lib.html" class="toclink" data-pltdoc="x">13.1.10<span class="hspace">&nbsp;</span>More Port Constructors, Procedures, and Events</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="port-lib.html#%28part._.Port_.String_and_.List_.Conversions%29" class="toclink" data-pltdoc="x">13.1.10.1<span class="hspace">&nbsp;</span>Port String and List Conversions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="port-lib.html#%28part._.Creating_.Ports%29" class="toclink" data-pltdoc="x">13.1.10.2<span class="hspace">&nbsp;</span>Creating Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="port-lib.html#%28part._.Port_.Events%29" class="toclink" data-pltdoc="x">13.1.10.3<span class="hspace">&nbsp;</span>Port Events</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="port-lib.html#%28part._.Copying_.Streams%29" class="toclink" data-pltdoc="x">13.1.10.4<span class="hspace">&nbsp;</span>Copying Streams</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="input-and-output.html" title="backward to &quot;13 Input and Output&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="encodings.html" title="forward to &quot;13.1.1 Encodings and Locales&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/portstructs.html b/clones/docs.racket-lang.org/reference/portstructs.html
new file mode 100644
index 00000000..824712c0
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/portstructs.html
@@ -0,0 +1,16 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.1.8&nbsp;Structures as Ports</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewselflink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1.1&nbsp;</td><td><a href="encodings.html" class="tocviewlink" data-pltdoc="x">Encodings and Locales</a></td></tr><tr><td align="right">13.1.2&nbsp;</td><td><a href="port-ops.html" class="tocviewlink" data-pltdoc="x">Managing Ports</a></td></tr><tr><td align="right">13.1.3&nbsp;</td><td><a href="port-buffers.html" class="tocviewlink" data-pltdoc="x">Port Buffers and Positions</a></td></tr><tr><td align="right">13.1.4&nbsp;</td><td><a href="linecol.html" class="tocviewlink" data-pltdoc="x">Counting Positions, Lines, and Columns</a></td></tr><tr><td align="right">13.1.5&nbsp;</td><td><a href="file-ports.html" class="tocviewlink" data-pltdoc="x">File Ports</a></td></tr><tr><td align="right">13.1.6&nbsp;</td><td><a href="stringport.html" class="tocviewlink" data-pltdoc="x">String Ports</a></td></tr><tr><td align="right">13.1.7&nbsp;</td><td><a href="pipeports.html" class="tocviewlink" data-pltdoc="x">Pipes</a></td></tr><tr><td align="right">13.1.8&nbsp;</td><td><a href="portstructs.html" class="tocviewselflink" data-pltdoc="x">Structures as Ports</a></td></tr><tr><td align="right">13.1.9&nbsp;</td><td><a href="customport.html" class="tocviewlink" data-pltdoc="x">Custom Ports</a></td></tr><tr><td align="right">13.1.10&nbsp;</td><td><a href="port-lib.html" class="tocviewlink" data-pltdoc="x">More Port Constructors, Procedures, and Events</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3ainput-port%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>input-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3aoutput-port%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>output-<wbr></wbr>port</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="pipeports.html" title="backward to &quot;13.1.7 Pipes&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ports.html" title="up to &quot;13.1 Ports&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="customport.html" title="forward to &quot;13.1.9 Custom Ports&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;portstructs&quot;">13.1.8<tt>&nbsp;</tt><a name="(part._portstructs)"></a>Structures as Ports</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._prop~3ainput-port))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3ainput-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:input-port</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._prop~3aoutput-port))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3aoutput-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:output-port</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3ainput-port%29%29" class="RktValLink" data-pltdoc="x">prop:input-port</a></span> and <span class="RktSym"><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3aoutput-port%29%29" class="RktValLink" data-pltdoc="x">prop:output-port</a></span> structure type
+properties identify structure types whose instances can serve as input
+and output ports, respectively.</p><p>Each property value can be either of the following:</p><ul><li><p>An input port (for <span class="RktSym"><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3ainput-port%29%29" class="RktValLink" data-pltdoc="x">prop:input-port</a></span>) or output port
+(for <span class="RktSym"><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3aoutput-port%29%29" class="RktValLink" data-pltdoc="x">prop:output-port</a></span>): In this case, using the structure
+as port is equivalent to using the given input or output port.</p></li><li><p>An exact, non-negative integer between <span class="RktVal">0</span> (inclusive) and
+the number of non-automatic fields in the structure type (exclusive, not
+counting supertype fields): The integer identifies a field in
+the structure, and the field must be designated as immutable. If the
+field contains an input port (for <span class="RktSym"><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3ainput-port%29%29" class="RktValLink" data-pltdoc="x">prop:input-port</a></span>) or
+output port (for <span class="RktSym"><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3aoutput-port%29%29" class="RktValLink" data-pltdoc="x">prop:output-port</a></span>), the port is used.
+Otherwise, an empty string input port is used for <span class="RktSym"><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3ainput-port%29%29" class="RktValLink" data-pltdoc="x">prop:input-port</a></span>,
+and a port that discards all data is used for <span class="RktSym"><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3aoutput-port%29%29" class="RktValLink" data-pltdoc="x">prop:output-port</a></span>.</p></li></ul><p>Some procedures, such as <span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%29%29" class="RktValLink" data-pltdoc="x">file-position</a></span>, work on both input
+and output ports. When given an instance of a structure type with both
+the <span class="RktSym"><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3ainput-port%29%29" class="RktValLink" data-pltdoc="x">prop:input-port</a></span> and <span class="RktSym"><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3aoutput-port%29%29" class="RktValLink" data-pltdoc="x">prop:output-port</a></span> properties,
+the instance is used as an input port.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="pipeports.html" title="backward to &quot;13.1.7 Pipes&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ports.html" title="up to &quot;13.1 Ports&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="customport.html" title="forward to &quot;13.1.9 Custom Ports&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/pretty-print.html b/clones/docs.racket-lang.org/reference/pretty-print.html
new file mode 100644
index 00000000..07a660ad
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/pretty-print.html
@@ -0,0 +1,173 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.6&nbsp;Pretty Printing</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewselflink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewselflink" data-pltdoc="x">Pretty Printing</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.6.1&nbsp;</td><td><a href="pretty-print.html#%28part._.Basic_.Pretty-.Print_.Options%29" class="tocviewlink" data-pltdoc="x">Basic Pretty-<wbr></wbr>Print Options</a></td></tr><tr><td align="right">13.6.2&nbsp;</td><td><a href="pretty-print.html#%28part._.Per-.Symbol_.Special_.Printing%29" class="tocviewlink" data-pltdoc="x">Per-<wbr></wbr>Symbol Special Printing</a></td></tr><tr><td align="right">13.6.3&nbsp;</td><td><a href="pretty-print.html#%28part._.Line-.Output_.Hook%29" class="tocviewlink" data-pltdoc="x">Line-<wbr></wbr>Output Hook</a></td></tr><tr><td align="right">13.6.4&nbsp;</td><td><a href="pretty-print.html#%28part._.Value_.Output_.Hook%29" class="tocviewlink" data-pltdoc="x">Value Output Hook</a></td></tr><tr><td align="right">13.6.5&nbsp;</td><td><a href="pretty-print.html#%28part._.Additional_.Custom-.Output_.Support%29" class="tocviewlink" data-pltdoc="x">Additional Custom-<wbr></wbr>Output Support</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>print</span></span></a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-write%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>write</span></span></a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-display%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>display</span></span></a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-format%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>format</span></span></a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-handler%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>print-<wbr></wbr>handler</span></span></a></td></tr><tr><td><span class="tocsublinknumber">13.6.1<tt>&nbsp;</tt></span><a href="pretty-print.html#%28part._.Basic_.Pretty-.Print_.Options%29" class="tocsubseclink" data-pltdoc="x">Basic Pretty-<wbr></wbr>Print Options</a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-columns%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>print-<wbr></wbr>columns</span></span></a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-depth%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>print-<wbr></wbr>depth</span></span></a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-exact-as-decimal%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>print-<wbr></wbr>exact-<wbr></wbr>as-<wbr></wbr>decimal</span></span></a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-..-symbol-without-bars%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>print-<wbr></wbr>.-<wbr></wbr>symbol-<wbr></wbr>without-<wbr></wbr>bars</span></span></a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-show-inexactness%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>print-<wbr></wbr>show-<wbr></wbr>inexactness</span></span></a></td></tr><tr><td><span class="tocsublinknumber">13.6.2<tt>&nbsp;</tt></span><a href="pretty-print.html#%28part._.Per-.Symbol_.Special_.Printing%29" class="tocsubseclink" data-pltdoc="x">Per-<wbr></wbr>Symbol Special Printing</a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-abbreviate-read-macros%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>print-<wbr></wbr>abbreviate-<wbr></wbr>read-<wbr></wbr>macros</span></span></a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-style-table~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>print-<wbr></wbr>style-<wbr></wbr>table?</span></span></a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-current-style-table%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>print-<wbr></wbr>current-<wbr></wbr>style-<wbr></wbr>table</span></span></a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-extend-style-table%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>print-<wbr></wbr>extend-<wbr></wbr>style-<wbr></wbr>table</span></span></a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-remap-stylable%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>print-<wbr></wbr>remap-<wbr></wbr>stylable</span></span></a></td></tr><tr><td><span class="tocsublinknumber">13.6.3<tt>&nbsp;</tt></span><a href="pretty-print.html#%28part._.Line-.Output_.Hook%29" class="tocsubseclink" data-pltdoc="x">Line-<wbr></wbr>Output Hook</a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-newline%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>print-<wbr></wbr>newline</span></span></a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-print-line%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>print-<wbr></wbr>print-<wbr></wbr>line</span></span></a></td></tr><tr><td><span class="tocsublinknumber">13.6.4<tt>&nbsp;</tt></span><a href="pretty-print.html#%28part._.Value_.Output_.Hook%29" class="tocsubseclink" data-pltdoc="x">Value Output Hook</a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-size-hook%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>print-<wbr></wbr>size-<wbr></wbr>hook</span></span></a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-print-hook%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>print-<wbr></wbr>print-<wbr></wbr>hook</span></span></a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-pre-print-hook%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>print-<wbr></wbr>pre-<wbr></wbr>print-<wbr></wbr>hook</span></span></a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-post-print-hook%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>print-<wbr></wbr>post-<wbr></wbr>print-<wbr></wbr>hook</span></span></a></td></tr><tr><td><span class="tocsublinknumber">13.6.5<tt>&nbsp;</tt></span><a href="pretty-print.html#%28part._.Additional_.Custom-.Output_.Support%29" class="tocsubseclink" data-pltdoc="x">Additional Custom-<wbr></wbr>Output Support</a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-printing%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pretty-<wbr></wbr>printing</span></span></a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._make-tentative-pretty-print-output-port%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>tentative-<wbr></wbr>pretty-<wbr></wbr>print-<wbr></wbr>output-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._tentative-pretty-print-port-transfer%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tentative-<wbr></wbr>pretty-<wbr></wbr>print-<wbr></wbr>port-<wbr></wbr>transfer</span></span></a></td></tr><tr><td><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._tentative-pretty-print-port-cancel%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tentative-<wbr></wbr>pretty-<wbr></wbr>print-<wbr></wbr>port-<wbr></wbr>cancel</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Writing.html" title="backward to &quot;13.5 Writing&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Reader_Extension.html" title="forward to &quot;13.7 Reader Extension&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;pretty-print&quot;">13.6<tt>&nbsp;</tt><a name="(part._pretty-print)"></a><a name="(mod-path._racket/pretty)"></a>Pretty Printing</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="pretty-print.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/pretty</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="pretty-print.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/pretty</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-print))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">port</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">quote-depth</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:newline?</span><span class="hspace">&nbsp;</span><span class="RktVar">newline?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">quote-depth</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">newline?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Pretty-prints the value <span class="RktVar">v</span> using the same printed form as the
+default <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode, but with newlines and whitespace inserted
+to avoid lines longer than <span class="RktPn">(</span><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-columns%29%29" class="RktValLink" data-pltdoc="x">pretty-print-columns</a></span><span class="RktPn">)</span>, as
+controlled by <span class="RktPn">(</span><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-current-style-table%29%29" class="RktValLink" data-pltdoc="x">pretty-print-current-style-table</a></span><span class="RktPn">)</span>. The printed
+form ends in a newline by default, unless the <span class="RktVar">newline?</span>
+argument is supplied with false or the <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-columns%29%29" class="RktValLink" data-pltdoc="x">pretty-print-columns</a></span>
+parameter is set to <span class="RktVal">'</span><span class="RktVal">infinity</span>. When <span class="RktVar">port</span> has line
+counting enabled (see <a href="linecol.html" data-pltdoc="x">Counting Positions, Lines, and Columns</a>), then printing is sensitive
+to the column when printing starts&#8212;<wbr></wbr>both for determining an initial
+line break and indenting subsequent lines.</div></p><p>In addition to the parameters defined in this section,
+<span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print%29%29" class="RktValLink" data-pltdoc="x">pretty-print</a></span> conforms to the <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-graph%29%29" class="RktValLink" data-pltdoc="x">print-graph</a></span>,
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-struct%29%29" class="RktValLink" data-pltdoc="x">print-struct</a></span>, <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-hash-table%29%29" class="RktValLink" data-pltdoc="x">print-hash-table</a></span>,
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-vector-length%29%29" class="RktValLink" data-pltdoc="x">print-vector-length</a></span>, <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-box%29%29" class="RktValLink" data-pltdoc="x">print-box</a></span>, and
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValLink" data-pltdoc="x">print-as-expression</a></span> parameters.</p><p>The pretty printer detects structures that have the
+<span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">prop:custom-write</a></span> property and calls the corresponding
+custom-write procedure. The custom-write procedure can check the
+parameter <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-printing%29%29" class="RktValLink" data-pltdoc="x">pretty-printing</a></span> to cooperate with the
+pretty-printer. Recursive printing to the port automatically uses
+pretty printing, but if the structure has multiple recursively printed
+sub-expressions, a custom-write procedure may need to cooperate more
+to insert explicit newlines. Use <span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-next-location%29%29" class="RktValLink" data-pltdoc="x">port-next-location</a></span> to
+determine the current output column, use <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-columns%29%29" class="RktValLink" data-pltdoc="x">pretty-print-columns</a></span>
+to determine the target printing width, and use
+<span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-newline%29%29" class="RktValLink" data-pltdoc="x">pretty-print-newline</a></span> to insert a newline (so that the
+function in the <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-print-line%29%29" class="RktValLink" data-pltdoc="x">pretty-print-print-line</a></span> parameter can be
+called appropriately). Use
+<span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._make-tentative-pretty-print-output-port%29%29" class="RktValLink" data-pltdoc="x">make-tentative-pretty-print-output-port</a></span> to obtain a port for
+tentative recursive prints (e.g., to check the length of the output).</p><p>If the <span class="RktVar">newline?</span> argument is omitted or supplied with true,
+the <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-print-line%29%29" class="RktValLink" data-pltdoc="x">pretty-print-print-line</a></span> callback is called with false as
+the first argument to print the last newline after the printed value.
+If it is supplied with false, the <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-print-line%29%29" class="RktValLink" data-pltdoc="x">pretty-print-print-line</a></span>
+callback is not called after the printed value.</p><p class="SHistory">Changed in version 6.6.0.3 of package <span class="stt">base</span>: Added <span class="RktVar">newline?</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-write))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-write%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-write</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span><span class="RktPn">#:newline?</span><span class="hspace">&nbsp;</span><span class="RktVar">newline?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">newline?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Same as <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print%29%29" class="RktValLink" data-pltdoc="x">pretty-print</a></span>, but <span class="RktVar">v</span> is printed like
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> instead of like <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>.</div></p><p class="SHistory">Changed in version 6.6.0.3 of package <span class="stt">base</span>: Added <span class="RktVar">newline?</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-display))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-display%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-display</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span><span class="RktPn">#:newline?</span><span class="hspace">&nbsp;</span><span class="RktVar">newline?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">newline?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Same as <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print%29%29" class="RktValLink" data-pltdoc="x">pretty-print</a></span>, but <span class="RktVar">v</span> is printed like
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> instead of like <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>.</div></p><p class="SHistory">Changed in version 6.6.0.3 of package <span class="stt">base</span>: Added <span class="RktVar">newline?</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-format))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-format%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-format</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">columns</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVar">mode</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">columns</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-columns%29%29" class="RktValLink" data-pltdoc="x">pretty-print-columns</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">print</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">write</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">display</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">print</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print%29%29" class="RktValLink" data-pltdoc="x">pretty-print</a></span>, except that it returns a string containing
+the pretty-printed value, rather than sending the output to a port.</div></p><p>The optional argument <span class="RktVar">columns</span> argument is used to
+parameterize <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-columns%29%29" class="RktValLink" data-pltdoc="x">pretty-print-columns</a></span>.</p><p>The keyword argument <span class="RktVar">mode</span> controls whether printing is done like
+either <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print%29%29" class="RktValLink" data-pltdoc="x">pretty-print</a></span> (the default), <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-write%29%29" class="RktValLink" data-pltdoc="x">pretty-write</a></span> or
+<span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-display%29%29" class="RktValLink" data-pltdoc="x">pretty-display</a></span>.</p><p class="SHistory">Changed in version 6.3 of package <span class="stt">base</span>: Added a <span class="RktVar">mode</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-print-handler))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-handler%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-handler</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Pretty-prints <span class="RktVar">v</span> if <span class="RktVar">v</span> is not <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>, or prints
+nothing if <span class="RktVar">v</span> is <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>. Pass this procedure to
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-print%29%29" class="RktValLink" data-pltdoc="x">current-print</a></span> to install the pretty printer into the REPL run
+by <span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._read-eval-print-loop%29%29" class="RktValLink" data-pltdoc="x">read-eval-print-loop</a></span>.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Basic_Pretty-Print_Options&quot;">13.6.1<tt>&nbsp;</tt><a name="(part._.Basic_.Pretty-.Print_.Options)"></a>Basic Pretty-Print Options</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-print-columns))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-columns%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-columns</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">infinity</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-columns%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-columns</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">width</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">infinity</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the default width for pretty printing.</div></p><p>If the display width is <span class="RktVal">'</span><span class="RktVal">infinity</span>, then pretty-printed output
+is never broken into lines, and a newline is not added to the end of
+the output.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-print-depth))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-depth%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-depth</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-depth%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-depth</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">depth</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">depth</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Parameter that controls the default depth for recursive pretty
+printing. Printing to <span class="RktVar">depth</span> means that elements nested more
+deeply than <span class="RktVar">depth</span> are replaced with &ldquo;...&rdquo;; in particular, a
+depth of <span class="RktVal">0</span> indicates that only simple values are printed. A depth of
+<span class="RktVal">#f</span> (the default) allows printing to arbitrary
+depths.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-print-exact-as-decimal))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-exact-as-decimal%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-exact-as-decimal</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-exact-as-decimal%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-exact-as-decimal</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">as-decimal?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">as-decimal?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines how exact non-integers are printed.  If
+the parameter&rsquo;s value is <span class="RktVal">#t</span>, then an exact non-integer with a
+decimal representation is printed as a decimal number instead of a
+fraction. The initial value is <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-print-..-symbol-without-bars))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-..-symbol-without-bars%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-.-symbol-without-bars</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-..-symbol-without-bars%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-.-symbol-without-bars</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls the printing of the symbol whose print name
+is just a period. If set to a true value, then such a symbol is
+printed as only the period.  If set to a false value, it is printed as
+a period with vertical bars surrounding it.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-print-show-inexactness))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-show-inexactness%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-show-inexactness</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-show-inexactness%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-show-inexactness</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">show?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">show?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines how inexact numbers are printed.  If the
+parameter&rsquo;s value is <span class="RktVal">#t</span>, then inexact numbers are always
+printed with a leading <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#i</span><span class="hspace"></span></span>. The initial value is <span class="RktVal">#f</span>.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Per-Symbol_Special_Printing&quot;">13.6.2<tt>&nbsp;</tt><a name="(part._.Per-.Symbol_.Special_.Printing)"></a>Per-Symbol Special Printing</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-print-abbreviate-read-macros))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-abbreviate-read-macros%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-abbreviate-read-macros</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-abbreviate-read-macros%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-abbreviate-read-macros</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">abbrev?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">abbrev?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls whether or not <span class="RktSym">quote</span>,
+<span class="RktSym">unquote</span>, <span class="RktSym">unquote-splicing</span>, etc<span class="Sendabbrev">.</span>, are
+abbreviated with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">,</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">,@</span><span class="hspace"></span></span>, etc.
+By default, the abbreviations are enabled.</div></p><p>See also <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-remap-stylable%29%29" class="RktValLink" data-pltdoc="x">pretty-print-remap-stylable</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-print-style-table~3f))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-style-table~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-style-table?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a style table for use with
+<span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-current-style-table%29%29" class="RktValLink" data-pltdoc="x">pretty-print-current-style-table</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-print-current-style-table))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-current-style-table%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-current-style-table</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-style-table~3f%29%29" class="RktValLink" data-pltdoc="x">pretty-print-style-table?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-current-style-table%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-current-style-table</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">style-table</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">style-table</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-style-table~3f%29%29" class="RktValLink" data-pltdoc="x">pretty-print-style-table?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that holds a table of style mappings. See
+<span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-extend-style-table%29%29" class="RktValLink" data-pltdoc="x">pretty-print-extend-style-table</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-print-extend-style-table))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-extend-style-table%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-extend-style-table</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">style-table</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">symbol-list</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">like-symbol-list</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-style-table~3f%29%29" class="RktValLink" data-pltdoc="x">pretty-print-style-table?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">style-table</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-style-table~3f%29%29" class="RktValLink" data-pltdoc="x">pretty-print-style-table?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">symbol-list</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">like-symbol-list</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new style table by extending an existing
+<span class="RktVar">style-table</span>, so that the style mapping for each symbol of
+<span class="RktVar">like-symbol-list</span> in the original table is used for the
+corresponding symbol of <span class="RktVar">symbol-list</span> in the new table. The
+<span class="RktVar">symbol-list</span> and <span class="RktVar">like-symbol-list</span> lists must have the
+same length. The <span class="RktVar">style-table</span> argument can be <span class="RktVal">#f</span>, in
+which case the default mappings are used from the original table (see
+below).</div></p><p>The style mapping for a symbol controls the way that whitespace is
+inserted when printing a list that starts with the symbol. In the
+absence of any mapping, when a list is broken across multiple lines,
+each element of the list is printed on its own line, each with the
+same indentation.</p><p>The default style mapping includes mappings for the following symbols,
+so that the output follows popular code-formatting rules:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktVal">'</span><span class="RktVal">lambda</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">&#955;</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">case-lambda</span></td></tr><tr><td><span class="RktVal">'</span><span class="RktVal">define</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">define-macro</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">define-syntax</span></td></tr><tr><td><span class="RktVal">'</span><span class="RktVal">let</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">letrec</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">let*</span></td></tr><tr><td><span class="RktVal">'</span><span class="RktVal">let-syntax</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">letrec-syntax</span></td></tr><tr><td><span class="RktVal">'</span><span class="RktVal">let-values</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">letrec-values</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">let*-values</span></td></tr><tr><td><span class="RktVal">'</span><span class="RktVal">let-syntaxes</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">letrec-syntaxes</span></td></tr><tr><td><span class="RktVal">'</span><span class="RktVal">begin</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">begin0</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">do</span></td></tr><tr><td><span class="RktVal">'</span><span class="RktVal">if</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">set!</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">set!-values</span></td></tr><tr><td><span class="RktVal">'</span><span class="RktVal">unless</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">when</span></td></tr><tr><td><span class="RktVal">'</span><span class="RktVal">cond</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">case</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">and</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">or</span></td></tr><tr><td><span class="RktVal">'</span><span class="RktVal">module</span></td></tr><tr><td><span class="RktVal">'</span><span class="RktVal">syntax-rules</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">syntax-case</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">letrec-syntaxes+values</span></td></tr><tr><td><span class="RktVal">'</span><span class="RktVal">import</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">export</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">link</span></td></tr><tr><td><span class="RktVal">'</span><span class="RktVal">require</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">require-for-syntax</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">require-for-template</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">provide</span></td></tr><tr><td><span class="RktVal">'</span><span class="RktVal">public</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">private</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">override</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">rename</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">inherit</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">field</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">init</span></td></tr><tr><td><span class="RktVal">'</span><span class="RktVal">shared</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">send</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">class</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">instantiate</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">make-object</span></td></tr></table></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-print-remap-stylable))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-remap-stylable%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-remap-stylable</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-remap-stylable%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-remap-stylable</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that controls remapping for styles and for the determination of
+the reader shorthands.</div></p><p>This procedure is
+called with each sub-expression that appears as the first element in a
+sequence. If it returns a symbol, the style table is used, as if that
+symbol were at the head of the sequence. If it returns <span class="RktVal">#f</span>,
+the style table is treated normally.
+Similarly, when determining whether to abbreviate reader macros,
+this parameter is consulted.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Line-Output_Hook&quot;">13.6.3<tt>&nbsp;</tt><a name="(part._.Line-.Output_.Hook)"></a>Line-Output Hook</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-print-newline))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-newline%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-newline</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span><span class="RktVar">width</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Calls the procedure associated with the
+<span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-print-line%29%29" class="RktValLink" data-pltdoc="x">pretty-print-print-line</a></span> parameter to print a newline to
+<span class="RktVar">port</span>, if <span class="RktVar">port</span> is the output port that is redirected
+to the original output port for printing, otherwise a plain newline is
+printed to <span class="RktVar">port</span>. The <span class="RktVar">width</span> argument should be the
+target column width, typically obtained from
+<span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-columns%29%29" class="RktValLink" data-pltdoc="x">pretty-print-columns</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-print-print-line))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-print-line%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-print-line</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">infinity</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-print-line%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-print-line</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">infinity</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines a procedure for printing the newline
+separator between lines of a pretty-printed value. The procedure is
+called with four arguments: a new line number, an output port, the old
+line&rsquo;s length, and the number of destination columns. The return value
+from <span class="RktVar">proc</span> is the number of extra characters it printed at the
+beginning of the new line.</div></p><p>The <span class="RktVar">proc</span> procedure is called before any characters are
+printed with <span class="RktVal">0</span> as the line number and <span class="RktVal">0</span> as the old
+line length. Whenever the pretty-printer starts a new line,
+<span class="RktVar">proc</span> is called with the new line&rsquo;s number (where the first
+new line is numbered <span class="RktVal">1</span>) and the just-finished line&rsquo;s length.
+The destination-columns argument to <span class="RktVar">proc</span> is always
+the total width of the destination printing area, or
+<span class="RktVal">'</span><span class="RktVal">infinity</span> if pretty-printed values are not broken into lines.</p><p>If the <span class="RktPn">#:newline?</span> argument was omitted or supplied with
+a true value, <span class="RktVar">proc</span> is also called after the last character of the
+value has been printed, with <span class="RktVal">#f</span> as the line number and with
+the length of the last line.</p><p>The default <span class="RktVar">proc</span> procedure prints a newline whenever the line
+number is not <span class="RktVal">0</span> and the column count is not
+<span class="RktVal">'</span><span class="RktVal">infinity</span>, always returning <span class="RktVal">0</span>. A custom
+<span class="RktVar">proc</span> procedure can be used to print extra text before each
+line of pretty-printed output; the number of characters printed before
+each line should be returned by <span class="RktVar">proc</span> so that the next line
+break can be chosen correctly.</p><p>The destination port supplied to <span class="RktVar">proc</span> is generally not the
+port supplied to <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print%29%29" class="RktValLink" data-pltdoc="x">pretty-print</a></span> or <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-display%29%29" class="RktValLink" data-pltdoc="x">pretty-display</a></span> (or
+the current output port), but output to this port is ultimately
+redirected to the port supplied to <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print%29%29" class="RktValLink" data-pltdoc="x">pretty-print</a></span> or
+<span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-display%29%29" class="RktValLink" data-pltdoc="x">pretty-display</a></span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Value_Output_Hook&quot;">13.6.4<tt>&nbsp;</tt><a name="(part._.Value_.Output_.Hook)"></a>Value Output Hook</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-print-size-hook))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-size-hook%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-size-hook</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-size-hook%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-size-hook</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines a sizing hook for pretty-printing.</div></p><p>The sizing hook is applied to each value to be printed. If the hook
+returns <span class="RktVal">#f</span>, then printing is handled internally by the
+pretty-printer. Otherwise, the value should be an integer specifying
+the length of the printed value in characters; the print hook will be
+called to actually print the value (see
+<span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-print-hook%29%29" class="RktValLink" data-pltdoc="x">pretty-print-print-hook</a></span>).</p><p>The sizing hook receives three arguments. The first argument is the
+value to print.  The second argument is a boolean: <span class="RktVal">#t</span> for
+printing like <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> and <span class="RktVal">#f</span> for printing like
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>. The third argument is the destination port; the port
+is the one supplied to <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print%29%29" class="RktValLink" data-pltdoc="x">pretty-print</a></span> or
+<span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-display%29%29" class="RktValLink" data-pltdoc="x">pretty-display</a></span> (or the current output port).  The sizing hook
+may be applied to a single value multiple times during
+pretty-printing.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-print-print-hook))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-print-hook%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-print-hook</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-print-hook%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-print-hook</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines a print hook for pretty-printing.  The
+print-hook procedure is applied to a value for printing when the
+sizing hook (see <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-size-hook%29%29" class="RktValLink" data-pltdoc="x">pretty-print-size-hook</a></span>) returns an integer
+size for the value.</div></p><p>The print hook receives three arguments. The first argument is the
+value to print.  The second argument is a boolean: <span class="RktVal">#t</span> for
+printing like <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> and <span class="RktVal">#f</span> for printing like
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>. The third argument is the destination port; this port
+is generally not the port supplied to <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print%29%29" class="RktValLink" data-pltdoc="x">pretty-print</a></span> or
+<span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-display%29%29" class="RktValLink" data-pltdoc="x">pretty-display</a></span> (or the current output port), but output to
+this port is ultimately redirected to the port supplied to
+<span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print%29%29" class="RktValLink" data-pltdoc="x">pretty-print</a></span> or <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-display%29%29" class="RktValLink" data-pltdoc="x">pretty-display</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-print-pre-print-hook))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-pre-print-hook%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-pre-print-hook</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-pre-print-hook%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-pre-print-hook</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines a hook procedure to be called just before
+an object is printed. The hook receives two arguments: the object and
+the output port. The port is the one supplied to <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print%29%29" class="RktValLink" data-pltdoc="x">pretty-print</a></span>
+or <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-display%29%29" class="RktValLink" data-pltdoc="x">pretty-display</a></span> (or the current output port).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-print-post-print-hook))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-post-print-hook%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-post-print-hook</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-post-print-hook%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-print-post-print-hook</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines a hook procedure to be called just after
+an object is printed. The hook receives two arguments: the object and
+the output port. The port is the one supplied to <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print%29%29" class="RktValLink" data-pltdoc="x">pretty-print</a></span>
+or <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-display%29%29" class="RktValLink" data-pltdoc="x">pretty-display</a></span> (or the current output port).</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Additional_Custom-Output_Support&quot;">13.6.5<tt>&nbsp;</tt><a name="(part._.Additional_.Custom-.Output_.Support)"></a>Additional Custom-Output Support</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._pretty-printing))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-printing%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-printing</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-printing%29%29" class="RktValDef RktValLink" data-pltdoc="x">pretty-printing</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that is set to <span class="RktVal">#t</span> when the pretty printer calls a
+custom-write procedure (see <span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">prop:custom-write</a></span>) for output in
+a mode that supports line breaks.  When pretty printer calls a
+custom-write procedure merely to detect cycles or to try to print on a
+single line, it sets this parameter to <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._make-tentative-pretty-print-output-port))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._make-tentative-pretty-print-output-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-tentative-pretty-print-output-port</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">overflow-thunk</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">overflow-thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces an output port that is suitable for recursive pretty printing
+without actually producing output. Use such a port to tentatively
+print when proper output depends on the size of recursive
+prints. After printing, determine the size of the tentative output
+using <span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%29%29" class="RktValLink" data-pltdoc="x">file-position</a></span>.</div></p><p>The <span class="RktVar">out</span> argument should be a pretty-printing port, such as
+the one supplied to a custom-write procedure when
+<span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-printing%29%29" class="RktValLink" data-pltdoc="x">pretty-printing</a></span> is set to true, or another tentative output
+port. The <span class="RktVar">width</span> argument should be a target column width,
+usually obtained from <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-columns%29%29" class="RktValLink" data-pltdoc="x">pretty-print-columns</a></span>, possibly
+decremented to leave room for a terminator. The
+<span class="RktVar">overflow-thunk</span> procedure is called if more than
+<span class="RktVar">width</span> items are printed to the port or if a newline is
+printed to the port via <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-newline%29%29" class="RktValLink" data-pltdoc="x">pretty-print-newline</a></span>; it can escape from the
+recursive print through a continuation as a shortcut, but
+<span class="RktVar">overflow-thunk</span> can also return, in which case it is called
+every time afterward that additional output is written to the port.</p><p>After tentative printing, either accept the result with
+<span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._tentative-pretty-print-port-transfer%29%29" class="RktValLink" data-pltdoc="x">tentative-pretty-print-port-transfer</a></span> or reject it with
+<span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._tentative-pretty-print-port-cancel%29%29" class="RktValLink" data-pltdoc="x">tentative-pretty-print-port-cancel</a></span>. Failure to accept or
+cancel properly interferes with graph-structure printing, calls to
+hook procedures, etc.  Explicitly cancel the tentative print even when
+<span class="RktVar">overflow-thunk</span> escapes from a recursive print.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._tentative-pretty-print-port-transfer))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._tentative-pretty-print-port-transfer%29%29" class="RktValDef RktValLink" data-pltdoc="x">tentative-pretty-print-port-transfer</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">tentative-out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">orig-out</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">tentative-out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">orig-out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Causes the data written to <span class="RktVar">tentative-out</span> to be transferred as
+if written to <span class="RktVar">orig-out</span>. The <span class="RktVar">tentative-out</span> argument
+should be a port produced by
+<span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._make-tentative-pretty-print-output-port%29%29" class="RktValLink" data-pltdoc="x">make-tentative-pretty-print-output-port</a></span>, and
+<span class="RktVar">orig-out</span> should be either a pretty-printing port (provided to
+a custom-write procedure) or another tentative output port.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/pretty..rkt)._tentative-pretty-print-port-cancel))"></a><span title="Provided from: racket/pretty, racket | Package: base"><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._tentative-pretty-print-port-cancel%29%29" class="RktValDef RktValLink" data-pltdoc="x">tentative-pretty-print-port-cancel</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">tentative-out</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">tentative-out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Cancels the content of <span class="RktVar">tentative-out</span>, which was produced by
+<span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._make-tentative-pretty-print-output-port%29%29" class="RktValLink" data-pltdoc="x">make-tentative-pretty-print-output-port</a></span>. The main effect of
+canceling is that graph-reference definitions are undone, so that a
+future print of a graph-referenced object includes the defining
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">=</span><span class="hspace"></span></span>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Writing.html" title="backward to &quot;13.5 Writing&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Reader_Extension.html" title="forward to &quot;13.7 Reader Extension&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/printing.html b/clones/docs.racket-lang.org/reference/printing.html
new file mode 100644
index 00000000..e461e4da
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/printing.html
@@ -0,0 +1,425 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>1.4&nbsp;The Printer</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewselflink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">1.1&nbsp;</td><td><a href="eval-model.html" class="tocviewlink" data-pltdoc="x">Evaluation Model</a></td></tr><tr><td align="right">1.2&nbsp;</td><td><a href="syntax-model.html" class="tocviewlink" data-pltdoc="x">Syntax Model</a></td></tr><tr><td align="right">1.3&nbsp;</td><td><a href="reader.html" class="tocviewlink" data-pltdoc="x">The Reader</a></td></tr><tr><td align="right">1.4&nbsp;</td><td><a href="printing.html" class="tocviewselflink" data-pltdoc="x">The Printer</a></td></tr><tr><td align="right">1.5&nbsp;</td><td><a href="implementations.html" class="tocviewlink" data-pltdoc="x">Implementations</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>1.4&nbsp;</td><td><a href="printing.html" class="tocviewselflink" data-pltdoc="x">The Printer</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">1.4.1&nbsp;</td><td><a href="printing.html#%28part._print-symbol%29" class="tocviewlink" data-pltdoc="x">Printing Symbols</a></td></tr><tr><td align="right">1.4.2&nbsp;</td><td><a href="printing.html#%28part._print-number%29" class="tocviewlink" data-pltdoc="x">Printing Numbers</a></td></tr><tr><td align="right">1.4.3&nbsp;</td><td><a href="printing.html#%28part._print-extflonum%29" class="tocviewlink" data-pltdoc="x">Printing Extflonums</a></td></tr><tr><td align="right">1.4.4&nbsp;</td><td><a href="printing.html#%28part._print-booleans%29" class="tocviewlink" data-pltdoc="x">Printing Booleans</a></td></tr><tr><td align="right">1.4.5&nbsp;</td><td><a href="printing.html#%28part._print-pairs%29" class="tocviewlink" data-pltdoc="x">Printing Pairs and Lists</a></td></tr><tr><td align="right">1.4.6&nbsp;</td><td><a href="printing.html#%28part._print-string%29" class="tocviewlink" data-pltdoc="x">Printing Strings</a></td></tr><tr><td align="right">1.4.7&nbsp;</td><td><a href="printing.html#%28part._print-vectors%29" class="tocviewlink" data-pltdoc="x">Printing Vectors</a></td></tr><tr><td align="right">1.4.8&nbsp;</td><td><a href="printing.html#%28part._print-structure%29" class="tocviewlink" data-pltdoc="x">Printing Structures</a></td></tr><tr><td align="right">1.4.9&nbsp;</td><td><a href="printing.html#%28part._print-hashtable%29" class="tocviewlink" data-pltdoc="x">Printing Hash Tables</a></td></tr><tr><td align="right">1.4.10&nbsp;</td><td><a href="printing.html#%28part._print-box%29" class="tocviewlink" data-pltdoc="x">Printing Boxes</a></td></tr><tr><td align="right">1.4.11&nbsp;</td><td><a href="printing.html#%28part._print-character%29" class="tocviewlink" data-pltdoc="x">Printing Characters</a></td></tr><tr><td align="right">1.4.12&nbsp;</td><td><a href="printing.html#%28part._print-keyword%29" class="tocviewlink" data-pltdoc="x">Printing Keywords</a></td></tr><tr><td align="right">1.4.13&nbsp;</td><td><a href="printing.html#%28part._print-regexp%29" class="tocviewlink" data-pltdoc="x">Printing Regular Expressions</a></td></tr><tr><td align="right">1.4.14&nbsp;</td><td><a href="printing.html#%28part._print-path%29" class="tocviewlink" data-pltdoc="x">Printing Paths</a></td></tr><tr><td align="right">1.4.15&nbsp;</td><td><a href="printing.html#%28part._print-unreadable%29" class="tocviewlink" data-pltdoc="x">Printing Unreadable Values</a></td></tr><tr><td align="right">1.4.16&nbsp;</td><td><a href="printing.html#%28part._print-compiled%29" class="tocviewlink" data-pltdoc="x">Printing Compiled Code</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">1.4.1<tt>&nbsp;</tt></span><a href="printing.html#%28part._print-symbol%29" class="tocsubseclink" data-pltdoc="x">Printing Symbols</a></td></tr><tr><td><span class="tocsublinknumber">1.4.2<tt>&nbsp;</tt></span><a href="printing.html#%28part._print-number%29" class="tocsubseclink" data-pltdoc="x">Printing Numbers</a></td></tr><tr><td><span class="tocsublinknumber">1.4.3<tt>&nbsp;</tt></span><a href="printing.html#%28part._print-extflonum%29" class="tocsubseclink" data-pltdoc="x">Printing Extflonums</a></td></tr><tr><td><span class="tocsublinknumber">1.4.4<tt>&nbsp;</tt></span><a href="printing.html#%28part._print-booleans%29" class="tocsubseclink" data-pltdoc="x">Printing Booleans</a></td></tr><tr><td><span class="tocsublinknumber">1.4.5<tt>&nbsp;</tt></span><a href="printing.html#%28part._print-pairs%29" class="tocsubseclink" data-pltdoc="x">Printing Pairs and Lists</a></td></tr><tr><td><span class="tocsublinknumber">1.4.6<tt>&nbsp;</tt></span><a href="printing.html#%28part._print-string%29" class="tocsubseclink" data-pltdoc="x">Printing Strings</a></td></tr><tr><td><span class="tocsublinknumber">1.4.7<tt>&nbsp;</tt></span><a href="printing.html#%28part._print-vectors%29" class="tocsubseclink" data-pltdoc="x">Printing Vectors</a></td></tr><tr><td><span class="tocsublinknumber">1.4.8<tt>&nbsp;</tt></span><a href="printing.html#%28part._print-structure%29" class="tocsubseclink" data-pltdoc="x">Printing Structures</a></td></tr><tr><td><span class="tocsublinknumber">1.4.9<tt>&nbsp;</tt></span><a href="printing.html#%28part._print-hashtable%29" class="tocsubseclink" data-pltdoc="x">Printing Hash Tables</a></td></tr><tr><td><span class="tocsublinknumber">1.4.10<tt>&nbsp;</tt></span><a href="printing.html#%28part._print-box%29" class="tocsubseclink" data-pltdoc="x">Printing Boxes</a></td></tr><tr><td><span class="tocsublinknumber">1.4.11<tt>&nbsp;</tt></span><a href="printing.html#%28part._print-character%29" class="tocsubseclink" data-pltdoc="x">Printing Characters</a></td></tr><tr><td><span class="tocsublinknumber">1.4.12<tt>&nbsp;</tt></span><a href="printing.html#%28part._print-keyword%29" class="tocsubseclink" data-pltdoc="x">Printing Keywords</a></td></tr><tr><td><span class="tocsublinknumber">1.4.13<tt>&nbsp;</tt></span><a href="printing.html#%28part._print-regexp%29" class="tocsubseclink" data-pltdoc="x">Printing Regular Expressions</a></td></tr><tr><td><span class="tocsublinknumber">1.4.14<tt>&nbsp;</tt></span><a href="printing.html#%28part._print-path%29" class="tocsubseclink" data-pltdoc="x">Printing Paths</a></td></tr><tr><td><span class="tocsublinknumber">1.4.15<tt>&nbsp;</tt></span><a href="printing.html#%28part._print-unreadable%29" class="tocsubseclink" data-pltdoc="x">Printing Unreadable Values</a></td></tr><tr><td><span class="tocsublinknumber">1.4.16<tt>&nbsp;</tt></span><a href="printing.html#%28part._print-compiled%29" class="tocsubseclink" data-pltdoc="x">Printing Compiled Code</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="reader.html" title="backward to &quot;1.3 The Reader&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="model.html" title="up to &quot;1 Language Model&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="implementations.html" title="forward to &quot;1.5 Implementations&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;printing&quot;">1.4<tt>&nbsp;</tt><a name="(part._printing)"></a>The Printer</h4><p>The Racket printer supports three modes:</p><ul><li><p><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> mode prints core datatypes in such a way that
+using <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> on the output produces a value that is
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to the printed value;</p></li><li><p><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> mode prints core datatypes in a more
+&ldquo;end-user&rdquo; style rather than &ldquo;programmer&rdquo; style; for
+example, a string <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>s as its content characters
+without surrounding <span class="RktInBG"><span class="hspace"></span><span class="RktIn">"</span><span class="hspace"></span></span>s or escapes;</p></li><li><p><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode by default&#8212;<wbr></wbr>when
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValLink" data-pltdoc="x">print-as-expression</a></span> is <span class="RktVal">#t</span>&#8212;<wbr></wbr>prints most
+datatypes in such a way that evaluating the output as an
+expression produces a value that is <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to the
+printed value; when <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValLink" data-pltdoc="x">print-as-expression</a></span> is set to
+<span class="RktVal">#f</span>, then <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode is like <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>
+mode.</p></li></ul><p>In <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode when <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValLink" data-pltdoc="x">print-as-expression</a></span> is
+<span class="RktVal">#t</span> (as is the default), a value prints at a <a name="(tech._quoting._depth)"></a><span style="font-style: italic">quoting
+depth</span> of either <span class="RktVal">0</span> (unquoted) or <span class="RktVal">1</span> (quoted). The
+initial quoting depth is accepted as an optional argument by
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>, and printing of some compound datatypes adjusts the
+print depth for component values. For example, when a list is printed
+at quoting depth <span class="RktVal">0</span> and all of its elements are
+<a name="(tech._quotable)"></a><span style="font-style: italic">quotable</span>, the list is printed with a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> prefix, and
+the list&rsquo;s elements are printed at quoting depth <span class="RktVal">1</span>.</p><p>When the <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-graph%29%29" class="RktValLink" data-pltdoc="x">print-graph</a></span> parameter is set to <span class="RktVal">#t</span>, then
+the printer first scans an object to detect cycles. The scan traverses
+the components of pairs, mutable pairs, vectors, boxes (when
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-box%29%29" class="RktValLink" data-pltdoc="x">print-box</a></span> is <span class="RktVal">#t</span>), hash tables (when
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-hash-table%29%29" class="RktValLink" data-pltdoc="x">print-hash-table</a></span> is <span class="RktVal">#t</span> and when key are held strongly), fields of structures
+exposed by <span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-~3evector%29%29" class="RktValLink" data-pltdoc="x">struct-&gt;vector</a></span> (when <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-struct%29%29" class="RktValLink" data-pltdoc="x">print-struct</a></span> is
+<span class="RktVal">#t</span>), and fields of structures exposed by printing when the
+structure&rsquo;s type has the <span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">prop:custom-write</a></span> property. If
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-graph%29%29" class="RktValLink" data-pltdoc="x">print-graph</a></span> is <span class="RktVal">#t</span>, then this information is used to
+print sharing through graph definitions and references (see
+<a href="reader.html#%28part._parse-graph%29" data-pltdoc="x">Reading Graph Structure</a>). If a cycle is detected in the initial scan,
+then <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-graph%29%29" class="RktValLink" data-pltdoc="x">print-graph</a></span> is effectively set to <span class="RktVal">#t</span>
+automatically.</p><p>With the exception of displaying <a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte strings</span></a>, printing is defined in
+terms of Unicode characters; see <a href="ports.html" data-pltdoc="x">Ports</a> for information
+on how a character stream is written to a port&rsquo;s underlying byte
+stream.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;print-symbol&quot;">1.4.1<tt>&nbsp;</tt><a name="(part._print-symbol)"></a>Printing Symbols</h5><p><a href="symbols.html#%28tech._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">Symbols</span></a> containing spaces or special characters <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> using
+escaping <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> and quoting <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span>s. When the
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-case-sensitive%29%29" class="RktValLink" data-pltdoc="x">read-case-sensitive</a></span> parameter is set to <span class="RktVal">#f</span>, then
+symbols containing uppercase characters also use escaping
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> and quoting <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span>s. In addition, symbols are
+quoted with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span>s or leading <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> when they would
+otherwise print the same as a numerical constant or as a delimited
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> (when <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-dot%29%29" class="RktValLink" data-pltdoc="x">read-accept-dot</a></span> is <span class="RktVal">#t</span>).</p><p>When <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-bar-quote%29%29" class="RktValLink" data-pltdoc="x">read-accept-bar-quote</a></span> is <span class="RktVal">#t</span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span>s are
+used in printing when one <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span> at the beginning and one
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span> at the end suffice to correctly print the
+symbol. Otherwise, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s are always used to escape special
+characters, instead of quoting them with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span>s.</p><p>When <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-bar-quote%29%29" class="RktValLink" data-pltdoc="x">read-accept-bar-quote</a></span> is <span class="RktVal">#f</span>, then <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span>
+is not treated as a special character. The following are always
+special characters:</p><p><span class="hspace">&nbsp;&nbsp;</span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span>
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span>
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">"</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">,</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">`</span><span class="hspace"></span></span>
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">;</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span></p><p>In addition, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> is a special character when it appears at the
+beginning of the symbol, and when it is not followed by <span class="RktInBG"><span class="hspace"></span><span class="RktIn">%</span><span class="hspace"></span></span>.</p><p>Symbols <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> without escaping or quoting special
+characters. That is, the display form of a symbol is the same as the
+display form of <span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-~3estring%29%29" class="RktValLink" data-pltdoc="x">symbol-&gt;string</a></span> applied to the symbol.</p><p>Symbols <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> the same as they <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>, unless
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValLink" data-pltdoc="x">print-as-expression</a></span> is set to <span class="RktVal">#t</span> (as is the default) and the current
+<a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> is <span class="RktVal">0</span>. In that case, the symbol&rsquo;s
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>ed form is prefixed with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span>. For the purposes
+of printing enclosing datatypes, a symbol is <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;print-number&quot;">1.4.2<tt>&nbsp;</tt><a name="(part._print-number)"></a>Printing Numbers</h5><p>A <a href="numbers.html#%28tech._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">number</span></a> prints the same way in <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>, <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>, and
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> modes. For the purposes of printing enclosing
+datatypes, a number is <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>.</p><p>A <a href="numbers.html#%28tech._complex._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">complex number</span></a> that is not a <a href="numbers.html#%28tech._real._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">real number</span></a> always prints
+as <span class="sroman">&#8249;<span style="font-style: italic">m</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">i</span><span class="hspace"></span></span> or
+<span class="sroman">&#8249;<span style="font-style: italic">m</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">i</span><span class="hspace"></span></span>, where <span class="sroman">&#8249;<span style="font-style: italic">m</span>&#8250;</span> and
+<span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span> (for a non-negative imaginary part) or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span> (for a negative imaginary part) are the printed
+forms of its real and imaginary parts, respectively.</p><p>An exact <span class="RktVal">0</span> prints as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">0</span><span class="hspace"></span></span>. A positive, exact
+<a href="numbers.html#%28tech._integer%29" class="techoutside" data-pltdoc="x"><span class="techinside">integer</span></a> prints as a sequence of digits that does not start with
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">0</span><span class="hspace"></span></span>. A positive, exact, real, non-integer number prints as
+<span class="sroman">&#8249;<span style="font-style: italic">m</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span>, where <span class="sroman">&#8249;<span style="font-style: italic">m</span>&#8250;</span> and <span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span>
+are the printed forms of the number&rsquo;s numerator and denominator (as
+determined by <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._numerator%29%29" class="RktValLink" data-pltdoc="x">numerator</a></span> and <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._denominator%29%29" class="RktValLink" data-pltdoc="x">denominator</a></span>). A negative
+<a href="numbers.html#%28tech._exact._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">exact number</span></a> prints with a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span> prefix on the printed
+form of the number&rsquo;s exact negation. When printing a number as
+hexadecimal (e.g., via <span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._number-~3estring%29%29" class="RktValLink" data-pltdoc="x">number-&gt;string</a></span>), digits <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>
+though <span class="RktInBG"><span class="hspace"></span><span class="RktIn">f</span><span class="hspace"></span></span> are printed in lowercase. A <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#e</span><span class="hspace"></span></span> or radix
+marker such as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#d</span><span class="hspace"></span></span> <span class="emph">does not</span> prefix the number.</p><p>A double-precision <a href="numbers.html#%28tech._inexact._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">inexact number</span></a> (i.e., a <a href="numbers.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonum</span></a>) that
+is a <a href="numbers.html#%28tech._rational._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">rational number</span></a> prints with either a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> decimal
+point, an <span class="RktInBG"><span class="hspace"></span><span class="RktIn">e</span><span class="hspace"></span></span> exponent marker and non-zero exponent, or both.
+The form is selected to keep the output short, with
+the constraint that reading the printed form back in produces an
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> number. A <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#i</span><span class="hspace"></span></span> <span class="emph">does not</span> prefix the
+number, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> is never used in place of a digit. A
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span> does not prefix a positive number, but a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span> or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span> is printed before the exponent if <span class="RktInBG"><span class="hspace"></span><span class="RktIn">e</span><span class="hspace"></span></span> is present.
+Positive infinity prints as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+inf.0</span><span class="hspace"></span></span>, negative infinity prints
+as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-inf.0</span><span class="hspace"></span></span>, and not-a-number prints as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+nan.0</span><span class="hspace"></span></span>.</p><p>A single-precision <a href="numbers.html#%28tech._inexact._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">inexact number</span></a> that is a <a href="numbers.html#%28tech._rational._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">rational
+number</span></a> prints like a double-precision number, but always with an
+exponent, using <span class="RktInBG"><span class="hspace"></span><span class="RktIn">f</span><span class="hspace"></span></span> in place of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">e</span><span class="hspace"></span></span> to indicate the
+number&rsquo;s precision; if the number would otherwise print without an
+exponent, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">0</span><span class="hspace"></span></span> (with no <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span>) is printed as the exponent
+part. Single-precision positive infinity prints as
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">+inf.f</span><span class="hspace"></span></span>, negative infinity prints as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-inf.f</span><span class="hspace"></span></span>, and
+not-a-number prints as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+nan.f</span><span class="hspace"></span></span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;print-extflonum&quot;">1.4.3<tt>&nbsp;</tt><a name="(part._print-extflonum)"></a>Printing Extflonums</h5><p>An <a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonum</span></a> prints the same way in <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>,
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>, and <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> modes. For the purposes of
+printing enclosing datatypes, an extflonum is <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>.</p><p>An extflonum prints in the same way a single-precision inexact number
+(see <a href="printing.html#%28part._print-number%29" data-pltdoc="x">Printing Numbers</a>), but always with a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">t</span><span class="hspace"></span></span> or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">T</span><span class="hspace"></span></span> exponent marker or as a suffix for <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+inf.t</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-inf.t</span><span class="hspace"></span></span>,
+or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+nan.t</span><span class="hspace"></span></span>. When
+extflonum operations are supported, printing always uses lowercase
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">t</span><span class="hspace"></span></span>; when extflonum operations are not supported, an
+extflonum prints the same as its reader (see <a href="reader.html" data-pltdoc="x">The Reader</a>)
+source, since reading is the only way to produce an extflonum.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;print-booleans&quot;">1.4.4<tt>&nbsp;</tt><a name="(part._print-booleans)"></a>Printing Booleans</h5><p>The <a href="booleans.html#%28tech._boolean%29" class="techoutside" data-pltdoc="x"><span class="techinside">boolean</span></a> constant <span class="RktVal">#t</span> prints as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#true</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#t</span><span class="hspace"></span></span> in
+all modes (<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>, <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>, and <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>),
+depending on the value of <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-boolean-long-form%29%29" class="RktValLink" data-pltdoc="x">print-boolean-long-form</a></span>, and the
+constant <span class="RktVal">#f</span> prints as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#false</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#f</span><span class="hspace"></span></span>. For
+the purposes of printing enclosing datatypes, a symbol is
+<a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;print-pairs&quot;">1.4.5<tt>&nbsp;</tt><a name="(part._print-pairs)"></a>Printing Pairs and Lists</h5><p>In <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> and <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> modes, an empty <a href="pairs.html#%28tech._list%29" class="techoutside" data-pltdoc="x"><span class="techinside">list</span></a> prints as
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">()</span><span class="hspace"></span></span>. A <a href="pairs.html#%28tech._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">pair</span></a> normally prints starting with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span>
+followed by the printed form of its <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span>. The rest of the
+printed form depends on the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span>:</p><ul><li><p>If the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a pair or the empty list, then the
+printed form of the pair completes with the printed form of the
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span>, except that the leading <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span> in the
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span>&rsquo;s printed form is omitted.</p></li><li><p>Otherwise, the printed for of the pair continues with a space,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>, another space, the printed form of the
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span>, and a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>.</p></li></ul><p>If <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-reader-abbreviations%29%29" class="RktValLink" data-pltdoc="x">print-reader-abbreviations</a></span> is set to <span class="RktVal">#t</span>, then
+pair printing in <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> mode is adjusted in the case of a pair
+that starts a two-element list whose first element is <span class="RktVal">'</span><span class="RktVal">quote</span>,
+<span class="RktVal">'</span><span class="RktVal">quasiquote</span>, <span class="RktVal">'</span><span class="RktVal">unquote</span>, <span class="RktVal">'</span><span class="RktVal">unquote-splicing</span>,
+<span class="RktVal">'</span><span class="RktVal">syntax</span>, <span class="RktVal">'</span><span class="RktVal">quasisyntax</span>, <span class="RktVal">'</span><span class="RktVal">unsyntax</span>, or
+<span class="RktVal">'</span><span class="RktVal">unsyntax-splicing</span>. In that case, the pair is printed with
+the corresponding reader syntax: <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">`</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">,</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">,@</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#'</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#`</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#,</span><span class="hspace"></span></span>,
+or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#,@</span><span class="hspace"></span></span>, respectively. After the reader syntax, the second
+element of the list is printed. When the list is a tail of an
+enclosing list, the tail is printed after a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> in the
+enclosing list (after which the reader abbreviations work), instead of
+including the tail as two elements of the enclosing list. If the
+reader syntax <span class="RktInBG"><span class="hspace"></span><span class="RktIn">,</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#,</span><span class="hspace"></span></span> is followed by a symbol
+that prints with a leading <span class="RktInBG"><span class="hspace"></span><span class="RktIn">@</span><span class="hspace"></span></span>, then the printer adds an
+extra space before the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">@</span><span class="hspace"></span></span>.</p><p>The printed form of a pair is the same in both <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> and
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> modes, except as the printed form of the pair&rsquo;s
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> and <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> vary with the mode. The <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>
+form is also the same if <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValLink" data-pltdoc="x">print-as-expression</a></span> is <span class="RktVal">#f</span>
+or the quoting depth is <span class="RktVal">1</span>.</p><p>For <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode when <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValLink" data-pltdoc="x">print-as-expression</a></span> is
+<span class="RktVal">#t</span> and the <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> is <span class="RktVal">0</span>, then the empty
+list prints as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'()</span><span class="hspace"></span></span>. For a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> and
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> are <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>, the pair prints in <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>
+mode but with a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> prefix; the pair&rsquo;s content is printed with
+<a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> <span class="RktVal">1</span>. Otherwise, when the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> or
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is not <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>, then pair prints with either
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">cons</span><span class="hspace"></span></span> (when the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is not a pair), <span class="RktInBG"><span class="hspace"></span><span class="RktIn">list</span><span class="hspace"></span></span>
+(when the pair is a list), or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">list*</span><span class="hspace"></span></span> (otherwise) after the
+opening <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span>, any <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> that would otherwise be printed
+is suppressed, and the pair content is printed at <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a>
+<span class="RktVal">0</span>. In all cases, when <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValLink" data-pltdoc="x">print-as-expression</a></span> is
+<span class="RktVal">#t</span> for <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode, then the value of
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-reader-abbreviations%29%29" class="RktValLink" data-pltdoc="x">print-reader-abbreviations</a></span> is ignored and reader
+abbreviations are always used for lists printed at <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting
+depth</span></a> <span class="RktVal">1</span>.</p><p>By default, mutable pairs (as created with <span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="RktValLink" data-pltdoc="x">mcons</a></span>) print the
+same as pairs for <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> and <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>, except that
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span> are used instead of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span> and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>. Note that the reader treats <span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span>...<span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span>
+and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span>...<span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span> equivalently on input, creating
+immutable pairs in both cases. Mutable pairs in <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode with
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValLink" data-pltdoc="x">print-as-expression</a></span> as <span class="RktVal">#f</span> or a <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a>
+of <span class="RktVal">1</span> also use <span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span>. In
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode with <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValLink" data-pltdoc="x">print-as-expression</a></span> as <span class="RktVal">#t</span>
+and a <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> of <span class="RktVal">0</span>, a mutable pair prints as
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">(mcons</span><span class="hspace">&nbsp;</span></span>, the <span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcar%29%29" class="RktValLink" data-pltdoc="x">mcar</a></span> and <span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcdr%29%29" class="RktValLink" data-pltdoc="x">mcdr</a></span> printed at
+<a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> <span class="RktVal">0</span> and separated by a space, and a
+closing <span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>.</p><p>If the <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-pair-curly-braces%29%29" class="RktValLink" data-pltdoc="x">print-pair-curly-braces</a></span> parameter is set to
+<span class="RktVal">#t</span>, then pairs print using <span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span>
+when not using <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode with <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValLink" data-pltdoc="x">print-as-expression</a></span> as
+<span class="RktVal">#t</span> and a <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> of <span class="RktVal">0</span>.  If the
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-mpair-curly-braces%29%29" class="RktValLink" data-pltdoc="x">print-mpair-curly-braces</a></span> parameter is set to <span class="RktVal">#f</span>,
+then mutable pairs print using <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span> in that
+mode.</p><p>For the purposes of printing enclosing datatypes, an empty list is
+always <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>, a pair is <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a> when its
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> and <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> are <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>, and a mutable list
+is never <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>.</p><p class="SHistory">Changed in version 6.9.0.6 of package <span class="stt">base</span>: Added a space when printing <span class="RktInBG"><span class="hspace"></span><span class="RktIn">,</span><span class="hspace"></span></span>
+or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#,</span><span class="hspace"></span></span> followed by a symbol
+that prints with a leading <span class="RktInBG"><span class="hspace"></span><span class="RktIn">@</span><span class="hspace"></span></span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;print-string&quot;">1.4.6<tt>&nbsp;</tt><a name="(part._print-string)"></a>Printing Strings</h5><p>All <a href="strings.html#%28tech._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">strings</span></a> <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> as their literal character sequences.</p><p>The <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> or <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> form of a string starts with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">"</span><span class="hspace"></span></span> and ends
+with another <span class="RktInBG"><span class="hspace"></span><span class="RktIn">"</span><span class="hspace"></span></span>. Between the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">"</span><span class="hspace"></span></span>s, each character is
+represented. Each graphic or blank character is represented as itself,
+with two exceptions: <span class="RktInBG"><span class="hspace"></span><span class="RktIn">"</span><span class="hspace"></span></span> is printed as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\"</span><span class="hspace"></span></span>, and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> is printed as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\</span><span class="hspace"></span></span>. Each non-graphic, non-blank
+character (according to <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-graphic~3f%29%29" class="RktValLink" data-pltdoc="x">char-graphic?</a></span> and
+<span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-blank~3f%29%29" class="RktValLink" data-pltdoc="x">char-blank?</a></span>) is printed using the escape sequences described
+in <a href="reader.html#%28part._parse-string%29" data-pltdoc="x">Reading Strings</a>, using <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\a</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\b</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\t</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\n</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\v</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\f</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\r</span><span class="hspace"></span></span>,
+or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\e</span><span class="hspace"></span></span> if possible, otherwise using <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\u</span><span class="hspace"></span></span> with four
+hexadecimal digits or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\U</span><span class="hspace"></span></span> with eight hexadecimal digits
+(using the latter only if the character value does not fit into four
+digits).</p><p>All byte strings <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> as their literal byte sequence; this
+byte sequence may not be a valid UTF-8 encoding, so it may not
+correspond to a sequence of characters.</p><p>The <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> or <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> form of a byte string starts with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#"</span><span class="hspace"></span></span> and
+ends with a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">"</span><span class="hspace"></span></span>. Between the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">"</span><span class="hspace"></span></span>s, each byte is
+written using the corresponding ASCII decoding if the byte is between
+0 and 127 and the character is graphic or blank (according to
+<span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-graphic~3f%29%29" class="RktValLink" data-pltdoc="x">char-graphic?</a></span> and <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-blank~3f%29%29" class="RktValLink" data-pltdoc="x">char-blank?</a></span>). Otherwise, the byte
+is written using <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\a</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\b</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\t</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\n</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\v</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\f</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\r</span><span class="hspace"></span></span>, or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\e</span><span class="hspace"></span></span> if possible, otherwise using <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> followed by one
+to three octal digits (only as many as necessary).</p><p>For the purposes of printing enclosing datatypes, a string or a byte
+string is <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;print-vectors&quot;">1.4.7<tt>&nbsp;</tt><a name="(part._print-vectors)"></a>Printing Vectors</h5><p>In <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> mode, the printed form of a <a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vector</span></a> is <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span>
+followed by the printed form of <span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-~3elist%29%29" class="RktValLink" data-pltdoc="x">vector-&gt;list</a></span> applied to the
+vector. In <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> mode, the printed form is the same, except
+that when the <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-vector-length%29%29" class="RktValLink" data-pltdoc="x">print-vector-length</a></span> parameter is <span class="RktVal">#t</span>, a
+decimal integer is printed after the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span>, and a repeated last
+element is printed only once.</p><p>Vectors <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> the same as they <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>, unless
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValLink" data-pltdoc="x">print-as-expression</a></span> is set to <span class="RktVal">#t</span> and the current
+<a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> is <span class="RktVal">0</span>. In that case, if all of the
+vector&rsquo;s elements are <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>, then the vector&rsquo;s
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>ed form is prefixed with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> and its elements
+printed with <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> <span class="RktVal">1</span>. If its elements are not
+all <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>, then the vector <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>s as
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">(vector</span><span class="hspace">&nbsp;</span></span>, the elements at <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> <span class="RktVal">0</span>,
+and a closing <span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>. A vector is <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a> when all of
+its elements are <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>.</p><p>In <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> or <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> mode, a <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a> prints
+like a <a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vector</span></a>, but with a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fl</span><span class="hspace"></span></span> prefix instead of
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span>. A <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a> similarly prints with a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fx</span><span class="hspace"></span></span>
+prefix instead of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span>. The <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-vector-length%29%29" class="RktValLink" data-pltdoc="x">print-vector-length</a></span>
+parameter affects <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a> and <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a> printing the
+same as <a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vector</span></a> printing. In <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode,
+<a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvectors</span></a> and <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvectors</span></a> are not <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>, and
+they print like a <a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vector</span></a> at <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> 0 using a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">(flvector</span><span class="hspace">&nbsp;</span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(fxvector</span><span class="hspace">&nbsp;</span></span> prefix, respectively.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;print-structure&quot;">1.4.8<tt>&nbsp;</tt><a name="(part._print-structure)"></a>Printing Structures</h5><p>When the <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-struct%29%29" class="RktValLink" data-pltdoc="x">print-struct</a></span> parameter is set to <span class="RktVal">#t</span>, then
+the way that <a href="structures.html#%28tech._structure%29" class="techoutside" data-pltdoc="x"><span class="techinside">structures</span></a> print depends on details of the structure type
+for which the structure is an instance:</p><ul><li><p>If the structure type is a <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure type,
+then it prints in <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> or <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> mode using
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#s(</span><span class="hspace"></span></span> followed by the <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure type key,
+then the printed form of each field in the structure, and then
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>.</p><p>In <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode when <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValLink" data-pltdoc="x">print-as-expression</a></span> is set
+to <span class="RktVal">#t</span> and the current <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> is
+<span class="RktVal">0</span>, if the structure&rsquo;s content is all <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>,
+then the structure&rsquo;s <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>ed form is prefixed with
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> and its content is printed with <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting
+depth</span></a> <span class="RktVal">1</span>. If any of its content is not quotable, then
+the structure type prints the same as a non-<a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a>
+structure type.</p><p>An instance of a <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure type is <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>
+when all of its content is <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>.</p></li><li><p>If the structure has a <span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">prop:custom-write</a></span> property
+value, then the associated procedure is used to print the
+structure, unless the <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-unreadable%29%29" class="RktValLink" data-pltdoc="x">print-unreadable</a></span> parameter is
+set to <span class="RktVal">#f</span>.</p><p>For <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode, an instance of a structure type with a
+<span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">prop:custom-write</a></span> property is treated as
+<a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a> if it has the
+<span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-print-quotable%29%29" class="RktValLink" data-pltdoc="x">prop:custom-print-quotable</a></span> property with a value of
+<span class="RktVal">'</span><span class="RktVal">always</span>. If it has <span class="RktVal">'</span><span class="RktVal">maybe</span> as the property
+value, then the structure is treated as <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a> if its
+content is <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>, where the content is determined by
+the values recursively printed by the structure&rsquo;s
+<span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">prop:custom-write</a></span> procedure. Finally, if the structure
+has <span class="RktVal">'</span><span class="RktVal">self</span> as the property value, then it is treated as
+<a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>.</p><p>In <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode when <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValLink" data-pltdoc="x">print-as-expression</a></span> is
+<span class="RktVal">#t</span>, the structure&rsquo;s <span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">prop:custom-write</a></span>
+procedure is called with either <span class="RktVal">0</span> or <span class="RktVal">1</span> as the
+<a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a>, normally depending on the structure&rsquo;s
+<span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-print-quotable%29%29" class="RktValLink" data-pltdoc="x">prop:custom-print-quotable</a></span> property value. If the
+property value is <span class="RktVal">'</span><span class="RktVal">always</span>, the <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> is
+normally <span class="RktVal">1</span>. If the property value is <span class="RktVal">'</span><span class="RktVal">maybe</span>,
+then the <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> is <span class="RktVal">1</span> if the structure is
+<a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>, or normally <span class="RktVal">0</span> otherwise. If the
+property value is <span class="RktVal">'</span><span class="RktVal">self</span>, then the quoting depth may be
+<span class="RktVal">0</span> or <span class="RktVal">1</span>; it is normally <span class="RktVal">0</span> if the
+structure is not printed as a part of an enclosing
+<a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a> value, even though the structure is treated as
+<a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>. Finally, if the property value is
+<span class="RktVal">'</span><span class="RktVal">never</span>, then the <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> is normally
+<span class="RktVal">0</span>. The <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> can vary from its normal
+value if the structure is printed with an explicit quoting
+depth of <span class="RktVal">1</span>.</p></li><li><p>If the structure&rsquo;s type is transparent or if any ancestor is
+transparent (i.e., <span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct~3f%29%29" class="RktValLink" data-pltdoc="x">struct?</a></span> on the instance produces
+<span class="RktVal">#t</span>), then the structure prints as the vector produced
+by <span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-~3evector%29%29" class="RktValLink" data-pltdoc="x">struct-&gt;vector</a></span> in <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> mode, in
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> mode, or in <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode when
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValLink" data-pltdoc="x">print-as-expression</a></span> is set to <span class="RktVal">#f</span> or when the
+<a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> is <span class="RktVal">0</span>.</p><p>In <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode with <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValLink" data-pltdoc="x">print-as-expression</a></span> as
+<span class="RktVal">#t</span> and a <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> of <span class="RktVal">0</span>, the
+structure content is printed with a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span> followed by
+the structure&rsquo;s type name (as determined by
+<span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span>) in <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> mode; the remaining
+elements are <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>ed at <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a>
+<span class="RktVal">0</span> and separated by a space, and finally a closing
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>.</p><p>A transparent structure type that is not a <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a>
+structure type is never <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>.</p></li><li><p>For any other structure type, the structure prints as an
+unreadable value; see <a href="printing.html#%28part._print-unreadable%29" data-pltdoc="x">Printing Unreadable Values</a> for more
+information.</p></li></ul><p>If the <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-struct%29%29" class="RktValLink" data-pltdoc="x">print-struct</a></span> parameter is set to <span class="RktVal">#f</span>, then all
+structures without a <span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">prop:custom-write</a></span> property print as
+unreadable values (see <a href="printing.html#%28part._print-unreadable%29" data-pltdoc="x">Printing Unreadable Values</a>) and count as
+<a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;print-hashtable&quot;">1.4.9<tt>&nbsp;</tt><a name="(part._print-hashtable)"></a>Printing Hash Tables</h5><p>When the <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-hash-table%29%29" class="RktValLink" data-pltdoc="x">print-hash-table</a></span> parameter is set to <span class="RktVal">#t</span>, in
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> and <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> modes, a <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash table</span></a> prints
+starting with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hash(</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hasheqv(</span><span class="hspace"></span></span>, or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hasheq(</span><span class="hspace"></span></span> for a table using <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>,
+or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> key comparisons, respectively, as long as the hash table
+retains keys strongly. After the prefix, each
+key&ndash;value mapping is shown as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span>, the printed form of a key,
+a space, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>, a space, the printed form the corresponding
+value, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>, with an additional space if the key&ndash;value
+pair is not the last to be printed.  After all key&ndash;value pairs, the
+printed form completes with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>.</p><p>In <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode when <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValLink" data-pltdoc="x">print-as-expression</a></span> is
+<span class="RktVal">#f</span> or the <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> is <span class="RktVal">1</span>, the printed form
+is the same as for <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>. Otherwise, if the hash table&rsquo;s keys
+and values are all <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>, the table prints with a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> prefix, and the table&rsquo;s key and values are <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>ed
+at <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> <span class="RktVal">1</span>. If some key or value is not
+<a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>, the hash table prints as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(hash</span><span class="hspace">&nbsp;</span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">(hasheqv</span><span class="hspace">&nbsp;</span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(hasheq</span><span class="hspace">&nbsp;</span></span> followed by alternating
+keys and values <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>ed at <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> <span class="RktVal">1</span> and
+separated by spaces, and finally a closing <span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>. A hash table
+is <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a> when all of its keys and values are
+<a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>.</p><p>When the <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-hash-table%29%29" class="RktValLink" data-pltdoc="x">print-hash-table</a></span> parameter is set to <span class="RktVal">#f</span>
+or when a hash table retains its keys weakly, a
+hash table prints as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&lt;hash&gt;</span><span class="hspace"></span></span> and counts as <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;print-box&quot;">1.4.10<tt>&nbsp;</tt><a name="(part._print-box)"></a>Printing Boxes</h5><p>When the <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-box%29%29" class="RktValLink" data-pltdoc="x">print-box</a></span> parameter is set to <span class="RktVal">#t</span>, a <a href="boxes.html#%28tech._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">box</span></a>
+prints as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&amp;</span><span class="hspace"></span></span> followed by the printed form of its content in
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>, <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>, or <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode when
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValLink" data-pltdoc="x">print-as-expression</a></span> is <span class="RktVal">#f</span> or the <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting
+depth</span></a> is <span class="RktVal">1</span>.</p><p>In <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> mode when <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValLink" data-pltdoc="x">print-as-expression</a></span> is
+<span class="RktVal">#t</span> and the <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> is <span class="RktVal">0</span>, a box prints
+with a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> prefix and its value is printed at <a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting
+depth</span></a> <span class="RktVal">1</span> when its content is <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>, otherwise the
+box prints a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(box</span><span class="hspace">&nbsp;</span></span> followed by the content at
+<a href="printing.html#%28tech._quoting._depth%29" class="techoutside" data-pltdoc="x"><span class="techinside">quoting depth</span></a> <span class="RktVal">0</span> and a closing <span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>. A box is
+<a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a> when its content is <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>.</p><p>When the <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-box%29%29" class="RktValLink" data-pltdoc="x">print-box</a></span> parameter is set to <span class="RktVal">#f</span>, a box
+prints as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&lt;box&gt;</span><span class="hspace"></span></span> and counts as <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;print-character&quot;">1.4.11<tt>&nbsp;</tt><a name="(part._print-character)"></a>Printing Characters</h5><p><a href="characters.html#%28tech._character%29" class="techoutside" data-pltdoc="x"><span class="techinside">Characters</span></a> with the special names described in
+<a href="reader.html#%28part._parse-character%29" data-pltdoc="x">Reading Characters</a> <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> and <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> using the
+same name.  (Some characters have multiple names; the
+<span class="RktVal">#\newline</span> and <span class="RktVal">#\nul</span> names are used instead of
+<span class="RktVal">#\linefeed</span> and <span class="RktVal">#\null</span>.)  Other graphic characters
+(according to <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-graphic~3f%29%29" class="RktValLink" data-pltdoc="x">char-graphic?</a></span>) <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\</span><span class="hspace"></span></span>
+followed by the single character, and all others characters are
+written in <span class="RktVal">#\u</span> notation with four digits or <span class="RktVal">#\U</span>
+notation with eight digits (using the latter only if the character
+value does not fit in four digits).</p><p>All characters <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> directly as themselves (i.e., a single
+character).</p><p>For the purposes of printing enclosing datatypes, a character is
+<a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;print-keyword&quot;">1.4.12<tt>&nbsp;</tt><a name="(part._print-keyword)"></a>Printing Keywords</h5><p><a href="keywords.html#%28tech._keyword%29" class="techoutside" data-pltdoc="x"><span class="techinside">Keywords</span></a> <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>, <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>, and <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> the same
+as symbols (see <a href="printing.html#%28part._print-symbol%29" data-pltdoc="x">Printing Symbols</a>) except with a leading
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#:</span><span class="hspace"></span></span> (after any <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> prefix added in <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>
+mode), and without special handling for an initial <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> or when
+the printed form would match a number or a delimited <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>
+(since <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#:</span><span class="hspace"></span></span> distinguishes the keyword).</p><p>For the purposes of printing enclosing datatypes, a keyword is
+<a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;print-regexp&quot;">1.4.13<tt>&nbsp;</tt><a name="(part._print-regexp)"></a>Printing Regular Expressions</h5><p><a href="regexp.html#%28tech._regexp._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">Regexp values</span></a> <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>, <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>, and <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>
+starting with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#px</span><span class="hspace"></span></span> (for <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._pregexp%29%29" class="RktValLink" data-pltdoc="x">pregexp</a></span>-based regexps) or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#rx</span><span class="hspace"></span></span> (for <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="RktValLink" data-pltdoc="x">regexp</a></span>-based regexps) followed by the
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> form of the regexp&rsquo;s source string or byte string.</p><p>For the purposes of printing enclosing datatypes, a regexp value is
+<a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;print-path&quot;">1.4.14<tt>&nbsp;</tt><a name="(part._print-path)"></a>Printing Paths</h5><p><a href="pathutils.html#%28tech._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">Paths</span></a> <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> and <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span> as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&lt;path:....&gt;</span><span class="hspace"></span></span>. A
+path <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span>s the same as the string produced by
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3estring%29%29" class="RktValLink" data-pltdoc="x">path-&gt;string</a></span>. For the purposes of printing enclosing
+datatypes, a path counts as <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>.</p><p>Although a path can be converted to a string with
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3estring%29%29" class="RktValLink" data-pltdoc="x">path-&gt;string</a></span> or to a byte string with <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3ebytes%29%29" class="RktValLink" data-pltdoc="x">path-&gt;bytes</a></span>,
+neither is clearly the right choice for printing a path and reading it
+back. If the path value is meant to be moved among platforms, then a
+string is probably the right choice, despite the potential for losing
+information when converting a path to a string. For a path that is
+intended to be re-read on the same platform, a byte string is probably
+the right choice, since it preserves information in an unportable
+way. Paths do not print in a readable way so that programmers are not
+misled into thinking that either choice is always appropriate.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;print-unreadable&quot;">1.4.15<tt>&nbsp;</tt><a name="(part._print-unreadable)"></a>Printing Unreadable Values</h5><p>For any value with no other printing specification, assuming that the
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-unreadable%29%29" class="RktValLink" data-pltdoc="x">print-unreadable</a></span> parameter is set to <span class="RktVal">#t</span>, the output
+form is <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&lt;</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">something</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">&gt;</span><span class="hspace"></span></span>, where
+<span class="sroman">&#8249;<span style="font-style: italic">something</span>&#8250;</span> is specific to the type of the value and sometimes
+to the value itself. If <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-unreadable%29%29" class="RktValLink" data-pltdoc="x">print-unreadable</a></span> is set to
+<span class="RktVal">#f</span>, then attempting to print an unreadable value raises
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span>.</p><p>For the purposes of printing enclosing datatypes, a value that prints
+unreadably nevertheless counts as <a href="printing.html#%28tech._quotable%29" class="techoutside" data-pltdoc="x"><span class="techinside">quotable</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;print-compiled&quot;">1.4.16<tt>&nbsp;</tt><a name="(part._print-compiled)"></a>Printing Compiled Code</h5><p>Compiled code as produced by <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile%29%29" class="RktValLink" data-pltdoc="x">compile</a></span> prints using
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#~</span><span class="hspace"></span></span>. Compiled code printed with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#~</span><span class="hspace"></span></span> is essentially
+assembly code for Racket, and reading such a form produces a compiled
+form when the <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-compiled%29%29" class="RktValLink" data-pltdoc="x">read-accept-compiled</a></span> parameter is set to
+<span class="RktVal">#t</span>.</p><p>Compiled code parsed from <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#~</span><span class="hspace"></span></span> is marked as non-runnable if
+the current code inspector (see <span class="RktSym"><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="RktValLink" data-pltdoc="x">current-code-inspector</a></span>) is
+not the original code inspector; on attempting to evaluate or reoptimize
+non-runnable bytecode, <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span> exception is raised. Otherwise, compiled
+code parsed from <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#~</span><span class="hspace"></span></span> may contain references to unexported or
+protected bindings from a module. Conceptually, the references in
+bytecode are associated with the current code inspector, where the
+code will only execute if that inspector controls the relevant module
+invocation (see <a href="modprotect.html" data-pltdoc="x">Code Inspectors</a>)&#8212;<wbr></wbr>but the original code
+inspector controls all other inspectors, anyway.</p><p>A compiled-form object may contain <a href="symbols.html#%28tech._uninterned%29" class="techoutside" data-pltdoc="x"><span class="techinside">uninterned</span></a> symbols (see
+<a href="symbols.html" data-pltdoc="x">Symbols</a>) that were created by <span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._gensym%29%29" class="RktValLink" data-pltdoc="x">gensym</a></span> or
+<span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3euninterned-symbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;uninterned-symbol</a></span>. When the compiled object is read
+via <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#~</span><span class="hspace"></span></span>, each uninterned symbol in the original form is
+mapped to a new uninterned symbol, where multiple instances of a
+single symbol are consistently mapped to the same new symbol. The
+original and new symbols have the same printed
+representation. <a href="symbols.html#%28tech._unreadable._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">Unreadable symbols</span></a>, which are typically
+generated indirectly during expansion and compilation, are saved and
+restored consistently through <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#~</span><span class="hspace"></span></span>.</p><p>The dynamic nature of <a href="symbols.html#%28tech._uninterned%29" class="techoutside" data-pltdoc="x"><span class="techinside">uninterned</span></a> symbols and their localization
+within <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#~</span><span class="hspace"></span></span> can cause problems when <span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._gensym%29%29" class="RktValLink" data-pltdoc="x">gensym</a></span> or
+<span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3euninterned-symbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;uninterned-symbol</a></span> is used to construct an identifier
+for a top-level or module binding (depending on how the identifier and
+its references are compiled). To avoid problems, generate distinct
+identifiers either with <span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._generate-temporaries%29%29" class="RktValLink" data-pltdoc="x">generate-temporaries</a></span> or by applying
+the result of <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-syntax-introducer%29%29" class="RktValLink" data-pltdoc="x">make-syntax-introducer</a></span> to an existing
+identifier; those functions lead to top-level and module variables
+with <a href="symbols.html#%28tech._unreadable._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">unreadable symbol</span></a>ic names, and the names are deterministic
+as long as expansion is otherwise deterministic.</p><p>When a compiled-form object has string and byte string literals, they
+are <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> using <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-intern-literal%29%29" class="RktValLink" data-pltdoc="x">datum-intern-literal</a></span> when the
+compiled-object for is read back in. Numbers and other values that
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> would intern, however, are not interned when read
+back as quoted literals in a compiled object.</p><p>A compiled form may contain path literals. Although paths are
+not normally printed in a way that can be read back in, path literals
+can be written and read as part of compiled code. The
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._current-write-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-write-relative-directory</a></span> parameter is used to convert
+the path to a relative path as is it written, and then
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-load-relative-directory</a></span> parameter (falling back to
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span>) is used to convert
+any relative path back as it is read.</p><p>For a path in a syntax object&rsquo;s source, if the
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._current-write-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-write-relative-directory</a></span> parameter is not set or the
+path is not relative to the value of the
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._current-write-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-write-relative-directory</a></span> parameter, then the path is
+coerced to a string that preserves only part of the path (an in effort
+to make it less tied to the build-time filesystem, which can be
+different than the run-time filesystem).</p><p>Finally, a compiled form may contain <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span> structures if the
+source field of the structure is a path for some system, a string, a
+byte string, a symbol, or <span class="RktVal">#f</span>. For a path value (matching the
+current platform&rsquo;s convention), if the path cannot be recorded as a
+relative path based on <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._current-write-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-write-relative-directory</a></span>, then
+it is converted to a string with at most two path elements; if the
+path contains more than two elements, then the string contains
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">.../</span><span class="hspace"></span></span>, the next-to-last element, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> and the last
+element. The intent of the constraints on <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span> values and
+the conversion of the source field is to preserve some source
+information but not expose or record a path that makes no sense on
+a different filesystem or platform.</p><p>For internal testing purposes in the <a href="implementations.html#%28tech._bc%29" class="techoutside" data-pltdoc="x"><span class="techinside">BC</span></a> implementation of Racket, when the
+<a name="(idx._(gentag._97._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">PLT_VALIDATE_LOAD</span> environment variable is set, the
+reader runs a validator on bytecode parsed from <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#~</span><span class="hspace"></span></span>. The
+validator may catch miscompilations or bytecode-file corruption. The
+validator may run lazily, such as checking a procedure only when the
+procedure is called.</p><p class="SHistory">Changed in version 6.90.0.21 of package <span class="stt">base</span>: Adjusted the effect of changing
+the code inspector on parsed
+bytecode, causing the reader to
+mark the loaded code as generally
+unrunnable instead of rejecting at
+read time references to unsafe
+operations.<br/>Changed in version 7.0: Allowed some <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span> values
+embedded in compiled code.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="reader.html" title="backward to &quot;1.3 The Reader&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="model.html" title="up to &quot;1 Language Model&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="implementations.html" title="forward to &quot;1.5 Implementations&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/procedures.html b/clones/docs.racket-lang.org/reference/procedures.html
new file mode 100644
index 00000000..d8cceaee
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/procedures.html
@@ -0,0 +1,262 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.19&nbsp;Procedures</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewselflink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.19&nbsp;</td><td><a href="procedures.html" class="tocviewselflink" data-pltdoc="x">Procedures</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.19.1&nbsp;</td><td><a href="procedures.html#%28part._.Keywords_and_.Arity%29" class="tocviewlink" data-pltdoc="x">Keywords and Arity</a></td></tr><tr><td align="right">4.19.2&nbsp;</td><td><a href="procedures.html#%28part._.Reflecting_on_.Primitives%29" class="tocviewlink" data-pltdoc="x">Reflecting on Primitives</a></td></tr><tr><td align="right">4.19.3&nbsp;</td><td><a href="procedures.html#%28part._.Additional_.Higher-.Order_.Functions%29" class="tocviewlink" data-pltdoc="x">Additional Higher-<wbr></wbr>Order Functions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure?</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">apply</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._compose%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compose</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._compose1%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">compose1</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-rename%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-<wbr></wbr>rename</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-realm%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-<wbr></wbr>realm</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-~3emethod%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-<wbr></wbr>&gt;method</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-closure-contents-eq~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-<wbr></wbr>closure-<wbr></wbr>contents-<wbr></wbr>eq?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.19.1<tt>&nbsp;</tt></span><a href="procedures.html#%28part._.Keywords_and_.Arity%29" class="tocsubseclink" data-pltdoc="x">Keywords and Arity</a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._keyword-apply%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">keyword-<wbr></wbr>apply</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-<wbr></wbr>arity</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-<wbr></wbr>arity?</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity-mask%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-<wbr></wbr>arity-<wbr></wbr>mask</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity-includes~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-<wbr></wbr>arity-<wbr></wbr>includes?</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-reduce-arity%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-<wbr></wbr>reduce-<wbr></wbr>arity</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-reduce-arity-mask%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-<wbr></wbr>reduce-<wbr></wbr>arity-<wbr></wbr>mask</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-keywords%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-<wbr></wbr>keywords</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-result-arity%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-<wbr></wbr>result-<wbr></wbr>arity</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-keyword-procedure%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>keyword-<wbr></wbr>procedure</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-reduce-keyword-arity%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-<wbr></wbr>reduce-<wbr></wbr>keyword-<wbr></wbr>arity</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-reduce-keyword-arity-mask%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-<wbr></wbr>reduce-<wbr></wbr>keyword-<wbr></wbr>arity-<wbr></wbr>mask</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">arity-<wbr></wbr>at-<wbr></wbr>least</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>procedure</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-struct-type~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-<wbr></wbr>struct-<wbr></wbr>type?</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-extract-target%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-<wbr></wbr>extract-<wbr></wbr>target</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._prop~3aarity-string%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>arity-<wbr></wbr>string</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._prop~3achecked-procedure%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>checked-<wbr></wbr>procedure</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._checked-procedure-check-and-extract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">checked-<wbr></wbr>procedure-<wbr></wbr>check-<wbr></wbr>and-<wbr></wbr>extract</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-specialize%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">procedure-<wbr></wbr>specialize</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.19.2<tt>&nbsp;</tt></span><a href="procedures.html#%28part._.Reflecting_on_.Primitives%29" class="tocsubseclink" data-pltdoc="x">Reflecting on Primitives</a></td></tr><tr><td><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._primitive~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">primitive?</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._primitive-closure~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">primitive-<wbr></wbr>closure?</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._primitive-result-arity%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">primitive-<wbr></wbr>result-<wbr></wbr>arity</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.19.3<tt>&nbsp;</tt></span><a href="procedures.html#%28part._.Additional_.Higher-.Order_.Functions%29" class="tocsubseclink" data-pltdoc="x">Additional Higher-<wbr></wbr>Order Functions</a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._identity%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identity</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._const%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">const</span></span></a></td></tr><tr><td><a href="procedures.html#%28form._%28%28lib._racket%2Ffunction..rkt%29._thunk%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">thunk</span></span></a></td></tr><tr><td><a href="procedures.html#%28form._%28%28lib._racket%2Ffunction..rkt%29._thunk%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">thunk*</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._negate%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">negate</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._conjoin%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">conjoin</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._disjoin%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">disjoin</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">curry</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curryr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">curryr</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalized-arity~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">normalized-<wbr></wbr>arity?</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalize-arity%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">normalize-<wbr></wbr>arity</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">arity=?</span></span></a></td></tr><tr><td><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity-includes~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">arity-<wbr></wbr>includes?</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="sets.html" title="backward to &quot;4.18 Sets&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="void.html" title="forward to &quot;4.20 Void&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;procedures&quot;">4.19<tt>&nbsp;</tt><a name="(part._procedures)"></a>Procedures</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._procedure~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">procedure?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktVal">#t</span> if
+<span class="RktVar">v</span> is a procedure, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._apply))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValDef RktValLink" data-pltdoc="x">apply</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktPn">#:&lt;kw&gt;</span><span class="hspace">&nbsp;</span><span class="RktVar">kw-arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">kw-arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=application.html%23%2528part._apply%2529&amp;version=8.6" class="Sq" data-pltdoc="x">The <span class="RktSym"><span class="RktValLink">apply</span></span> Function</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span>.</p></blockquote></blockquote></blockquote></div></p><p>Applies <span class="RktVar">proc</span> using the content of <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%2A%29%29" class="RktValLink" data-pltdoc="x">list*</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktVar">lst</span><span class="RktPn">)</span>
+as the (by-position) arguments. The <span class="RktPn">#:&lt;kw&gt;</span><span class="stt"> </span><span class="RktVar">kw-arg</span> sequence is
+also supplied as keyword arguments to <span class="RktVar">proc</span>, where
+<span class="RktPn">#:&lt;kw&gt;</span> stands for any keyword.</p><p>The given <span class="RktVar">proc</span> must accept as many arguments as the number of
+<span class="RktVar">v</span>s plus length of <span class="RktVar">lst</span>, it must accept the supplied
+keyword arguments, and it must not require any other keyword
+arguments; otherwise, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. The given
+<span class="RktVar">proc</span> is called in tail position with respect to the
+<span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span> call.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">6</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">6</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._sort%29%29" class="RktValLink" data-pltdoc="x">sort</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:key</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((1) (2))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._compose))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._compose%29%29" class="RktValDef RktValLink" data-pltdoc="x">compose</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._compose1))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._compose1%29%29" class="RktValDef RktValLink" data-pltdoc="x">compose1</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns a procedure that composes the given functions, applying the last
+<span class="RktVar">proc</span> first and the first <span class="RktVar">proc</span> last.  The <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._compose%29%29" class="RktValLink" data-pltdoc="x">compose</a></span> function
+allows the given functions to consume and produce any number of values, as
+long as each function produces as many values as the preceding function
+consumes, while <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._compose1%29%29" class="RktValLink" data-pltdoc="x">compose1</a></span> restricts the internal value passing to
+a single value.  In both cases, the input arity of the last function and
+the output arity of the first are unrestricted, and they become the
+corresponding arity of the resulting composition (including keyword
+arguments for the input side).</div></p><p>When no <span class="RktVar">proc</span> arguments are given, the result is
+<span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span>.  When exactly one is given, it is returned.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._compose1%29%29" class="RktValLink" data-pltdoc="x">compose1</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sqrt%29%29" class="RktValLink" data-pltdoc="x">sqrt</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-3.1622776601683795</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._compose1%29%29" class="RktValLink" data-pltdoc="x">compose1</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sqrt%29%29" class="RktValLink" data-pltdoc="x">sqrt</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0.0+3.1622776601683795i</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._compose%29%29" class="RktValLink" data-pltdoc="x">compose</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._split-path%29%29" class="RktValLink" data-pltdoc="x">split-path</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"/a"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">unix</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#&lt;path:/&gt; #&lt;path:a&gt; #f)</span></p></td></tr></table></blockquote></div></p><p>Note that in many cases, <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._compose1%29%29" class="RktValLink" data-pltdoc="x">compose1</a></span> is preferred.  For example,
+using <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._compose%29%29" class="RktValLink" data-pltdoc="x">compose</a></span> with two library functions may lead to problems
+when one function is extended to return two values, and the preceding
+one has an optional input with different semantics.  In addition,
+<span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._compose1%29%29" class="RktValLink" data-pltdoc="x">compose1</a></span> may create faster compositions.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._procedure-rename))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-rename%29%29" class="RktValDef RktValLink" data-pltdoc="x">procedure-rename</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">realm</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">realm</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racket</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a procedure that is like <span class="RktVar">proc</span>, except that its name
+as returned by <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span> (and as printed for debugging) is
+<span class="RktVar">name</span> and its <a href="exns.html#%28tech._realm%29" class="techoutside" data-pltdoc="x"><span class="techinside">realm</span></a> (potentially used for adjusting
+error messages) is <span class="RktVar">realm</span>.</div></p><p>The given <span class="RktVar">name</span> and <span class="RktVar">realm</span> are used for printing and adjusting
+an error message if the
+resulting procedure is applied to the wrong number of arguments.  In
+addition, if <span class="RktVar">proc</span> is an <a href="define-struct.html#%28tech._accessor%29" class="techoutside" data-pltdoc="x"><span class="techinside">accessor</span></a> or <a href="define-struct.html#%28tech._mutator%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutator</span></a>
+produced by <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>,
+<span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-field-accessor%29%29" class="RktValLink" data-pltdoc="x">make-struct-field-accessor</a></span>, or
+<span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-field-mutator%29%29" class="RktValLink" data-pltdoc="x">make-struct-field-mutator</a></span>, the resulting procedure also uses
+<span class="RktVar">name</span> when its (first) argument has the wrong type. More
+typically, however, <span class="RktVar">name</span> is not used for reporting errors,
+since the procedure name is typically hard-wired into an internal
+check.</p><p class="SHistory">Changed in version 8.4.0.2 of package <span class="stt">base</span>: Added the <span class="RktVar">realm</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._procedure-realm))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-realm%29%29" class="RktValDef RktValLink" data-pltdoc="x">procedure-realm</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Reports the <a href="exns.html#%28tech._realm%29" class="techoutside" data-pltdoc="x"><span class="techinside">realm</span></a> of a procedure, which can depend on the
+module where the procedure was created, the
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile-realm%29%29" class="RktValLink" data-pltdoc="x">current-compile-realm</a></span> value when the procedure&rsquo;s code was
+compiled, or a realm explicitly assigned through a function like
+<span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-rename%29%29" class="RktValLink" data-pltdoc="x">procedure-rename</a></span>.</div></p><p class="SHistory">Added in version 8.4.0.2 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._procedure-~3emethod))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-~3emethod%29%29" class="RktValDef RktValLink" data-pltdoc="x">procedure-&gt;method</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a procedure that is like <span class="RktVar">proc</span> except that, when applied
+to the wrong number of arguments, the resulting error hides the first
+argument as if the procedure had been compiled with the
+<a name="(idx._(gentag._192._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">method-arity-error</span> syntax property.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._procedure-closure-contents-eq~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-closure-contents-eq~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">procedure-closure-contents-eq?</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc1</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc2</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Compares the contents of the closures of <span class="RktVar">proc1</span> and <span class="RktVar">proc2</span>
+for equality by comparing closure elements pointwise using <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Keywords_and_Arity&quot;">4.19.1<tt>&nbsp;</tt><a name="(part._.Keywords_and_.Arity)"></a>Keywords and Arity</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._keyword-apply))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._keyword-apply%29%29" class="RktValDef RktValLink" data-pltdoc="x">keyword-apply</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">kw-lst</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">kw-val-lst</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">lst</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:&lt;kw&gt;</span><span class="hspace">&nbsp;</span><span class="RktVar">kw-arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">kw-lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">kw-val-lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">kw-arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=application.html%23%2528part._apply%2529&amp;version=8.6" class="Sq" data-pltdoc="x">The <span class="RktSym"><span class="RktValLink">apply</span></span> Function</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._keyword-apply%29%29" class="RktValLink" data-pltdoc="x">keyword-apply</a></span>.</p></blockquote></blockquote></blockquote></div></p><p>Like <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span>, but <span class="RktVar">kw-lst</span> and <span class="RktVar">kw-val-lst</span>
+supply by-keyword arguments in addition to the by-position arguments
+of the <span class="RktVar">v</span>s and <span class="RktVar">lst</span>, and in addition to the directly
+supplied keyword arguments in the <span class="RktPn">#:&lt;kw&gt;</span><span class="stt"> </span><span class="RktVar">kw-arg</span> sequence,
+where <span class="RktPn">#:&lt;kw&gt;</span> stands for any keyword.</p><p>The given <span class="RktVar">kw-lst</span> must be sorted using <span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3c~3f%29%29" class="RktValLink" data-pltdoc="x">keyword&lt;?</a></span>.  No
+keyword can appear twice in <span class="RktVar">kw-lst</span> or in both
+<span class="RktSym">kw-list</span> and as a <span class="RktPn">#:&lt;kw&gt;</span>, otherwise, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. The given <span class="RktVar">kw-val-lst</span> must have
+the same length as <span class="RktVar">kw-lst</span>, otherwise, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. The given <span class="RktVar">proc</span> must accept all
+of the keywords in <span class="RktVar">kw-lst</span> plus the <span class="RktPn">#:&lt;kw&gt;</span>s, it must
+not require any other keywords, and it must accept as many by-position
+arguments as supplied via the <span class="RktVar">v</span>s and <span class="RktVar">lst</span>; otherwise,
+the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">#:y</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktPn">#:z</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">z</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._keyword-apply%29%29" class="RktValLink" data-pltdoc="x">keyword-apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">#:y</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 10)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._keyword-apply%29%29" class="RktValLink" data-pltdoc="x">keyword-apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">#:y</span><span class="hspace">&nbsp;</span><span class="RktVal">#:z</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._keyword-apply%29%29" class="RktValLink" data-pltdoc="x">keyword-apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">#:z</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">#:y</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 7)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._procedure-arity))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="RktValDef RktValLink" data-pltdoc="x">procedure-arity</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalized-arity~3f%29%29" class="RktValLink" data-pltdoc="x">normalized-arity?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns information about the number of by-position arguments accepted
+by <span class="RktVar">proc</span>. See also <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity?</a></span>,
+<span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalized-arity~3f%29%29" class="RktValLink" data-pltdoc="x">normalized-arity?</a></span>, and <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity-mask%29%29" class="RktValLink" data-pltdoc="x">procedure-arity-mask</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._procedure-arity~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">procedure-arity?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A valid arity <span class="RktVar">a</span> is one of the following:</div></p><ul><li><p>An exact non-negative integer, which means that the procedure
+accepts <span class="RktVar">a</span> arguments, only.</p></li><li><p>A <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span> instance, which means that the
+procedure accepts <span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._arity-at-least-value%29%29" class="RktValLink" data-pltdoc="x">arity-at-least-value</a></span><span class="stt"> </span><span class="RktVar">a</span><span class="RktPn">)</span> or more
+arguments.</p></li><li><p>A list containing integers and <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span>
+instances, which means that the procedure accepts any number of
+arguments that can match one of the elements of <span class="RktVar">a</span>.</p></li></ul><p>The result of <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-arity</a></span> is always normalized in the sense of
+<span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalized-arity~3f%29%29" class="RktValLink" data-pltdoc="x">normalized-arity?</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-arity</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-arity</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(arity-at-least 0)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._arity-at-least~3f%29%29" class="RktValLink" data-pltdoc="x">arity-at-least?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-arity</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._arity-at-least-value%29%29" class="RktValLink" data-pltdoc="x">arity-at-least-value</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-arity</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._arity-at-least-value%29%29" class="RktValLink" data-pltdoc="x">arity-at-least-value</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-arity</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-arity</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._procedure-arity-mask))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity-mask%29%29" class="RktValDef RktValLink" data-pltdoc="x">procedure-arity-mask</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the same information as <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-arity</a></span>, but encoded
+differently. The arity is encoded as an exact integer <span class="RktVar">mask</span>
+where <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-bit-set~3f%29%29" class="RktValLink" data-pltdoc="x">bitwise-bit-set?</a></span><span class="stt"> </span><span class="RktVar">mask</span><span class="stt"> </span><span class="RktVar">n</span><span class="RktPn">)</span> returns true if <span class="RktVar">proc</span>
+accepts <span class="RktVar">n</span> arguments.</div></p><p>The mask encoding of an arity is often easier to test and manipulate,
+and <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity-mask%29%29" class="RktValLink" data-pltdoc="x">procedure-arity-mask</a></span> is sometimes faster than
+<span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-arity</a></span> while always being at least as fast.</p><p class="SHistory">Added in version 7.0.0.11 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._procedure-arity-includes~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity-includes~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">procedure-arity-includes?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">kws-ok?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">kws-ok?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if the procedure can accept <span class="RktVar">k</span> by-position
+arguments, <span class="RktVal">#f</span> otherwise.  If <span class="RktVar">kws-ok?</span> is <span class="RktVal">#f</span>,
+the result is <span class="RktVal">#t</span> only if <span class="RktVar">proc</span> has no required
+keyword arguments.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">#:y</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">#:y</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._procedure-reduce-arity))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-reduce-arity%29%29" class="RktValDef RktValLink" data-pltdoc="x">procedure-reduce-arity</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arity</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">realm</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arity</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">realm</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racket</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a procedure that is the same as <span class="RktVar">proc</span> (including
+the same name returned by <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span>), but that accepts
+only arguments consistent with <span class="RktVar">arity</span>. In particular,
+when <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-arity</a></span> is applied to the generated
+procedure, it returns a value that is <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to
+the normalized form of <span class="RktVar">arity</span>.</div></p><p>If the <span class="RktVar">arity</span> specification allows arguments that are not in
+<span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-arity</a></span><span class="stt"> </span><span class="RktVar">proc</span><span class="RktPn">)</span>, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.  If
+<span class="RktVar">proc</span> accepts keyword argument, either the keyword arguments
+must be all optional (and they are not accepted in by the
+arity-reduced procedure) or <span class="RktVar">arity</span> must be the empty list
+(which makes a procedure that cannot be called); otherwise, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>If <span class="RktVar">name</span> is not <span class="RktVal">#f</span>, then <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span> of the
+result procedure produces <span class="RktVar">name</span>, and <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-realm%29%29" class="RktValLink" data-pltdoc="x">procedure-realm</a></span>
+of the result produced produces <span class="RktVar">realm</span>. Otherwise,
+<span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span> and <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-realm%29%29" class="RktValLink" data-pltdoc="x">procedure-realm</a></span> of the result procedure
+produce the same result as for <span class="RktVar">proc</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my+</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-reduce-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-reduce-arity</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">my+</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">my+</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">+: arity mismatch;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">the expected number of arguments does not match the given</span></p></td></tr><tr><td><p><span class="RktErr">number</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: 2</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">also-my+</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-reduce-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-reduce-arity</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">also-my+</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">also-my+</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">also-my+: arity mismatch;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">the expected number of arguments does not match the given</span></p></td></tr><tr><td><p><span class="RktErr">number</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: 2</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 3</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.11 of package <span class="stt">base</span>: Added the optional <span class="RktVar">name</span>
+argument.<br/>Changed in version 8.4.0.2: Added the <span class="RktVar">realm</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._procedure-reduce-arity-mask))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-reduce-arity-mask%29%29" class="RktValDef RktValLink" data-pltdoc="x">procedure-reduce-arity-mask</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">mask</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">realm</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mask</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">realm</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racket</span></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-reduce-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-reduce-arity</a></span>, but using the
+representation of arity described with <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity-mask%29%29" class="RktValLink" data-pltdoc="x">procedure-arity-mask</a></span>.</div></p><p>The mask encoding of an arity is often easier to test and manipulate,
+and <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-reduce-arity-mask%29%29" class="RktValLink" data-pltdoc="x">procedure-reduce-arity-mask</a></span> is sometimes faster than
+<span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-reduce-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-reduce-arity</a></span> while always being at least as fast.</p><p class="SHistory">Added in version 7.0.0.11 of package <span class="stt">base</span>.<br/>Changed in version 8.4.0.2: Added the <span class="RktVar">realm</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._procedure-keywords))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-keywords%29%29" class="RktValDef RktValLink" data-pltdoc="x">procedure-keywords</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns information about the keyword arguments required and accepted
+by a procedure. The first result is a list of distinct keywords (sorted by
+<span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3c~3f%29%29" class="RktValLink" data-pltdoc="x">keyword&lt;?</a></span>) that are required when applying <span class="RktVar">proc</span>. The
+second result is a list of distinct accepted keywords (sorted by
+<span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3c~3f%29%29" class="RktValLink" data-pltdoc="x">keyword&lt;?</a></span>), or <span class="RktVal">#f</span> to mean that any keyword is
+accepted. When the second result is a list, every element in the first
+list is also in the second list.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-keywords%29%29" class="RktValLink" data-pltdoc="x">procedure-keywords</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">'()</span></p></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-keywords%29%29" class="RktValLink" data-pltdoc="x">procedure-keywords</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">#:tag</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">'(#:mode #:tag)</span></p></td></tr><tr><td><p><span class="RktRes">'(#:mode #:tag)</span></p></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-keywords%29%29" class="RktValLink" data-pltdoc="x">procedure-keywords</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">#:tag</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">'(#:tag)</span></p></td></tr><tr><td><p><span class="RktRes">'(#:mode #:tag)</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._procedure-result-arity))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-result-arity%29%29" class="RktValDef RktValLink" data-pltdoc="x">procedure-result-arity</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the arity of the result of the procedure <span class="RktVar">proc</span> or
+<span class="RktVal">#f</span> if the number of results are not known, perhaps due to shortcomings
+in the implementation of <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-result-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-result-arity</a></span> or
+because <span class="RktVar">proc</span>&rsquo;s behavior is not sufficiently simple.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-result-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-result-arity</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-result-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-result-arity</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-result-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-result-arity</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._random%29%29" class="RktValLink" data-pltdoc="x">random</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.4.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._make-keyword-procedure))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-keyword-procedure%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-keyword-procedure</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">plain-proc</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">plain-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktSym">args</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span><span class="hspace">&nbsp;</span><span class="RktSym">args</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns a procedure that accepts all keyword arguments (without
+requiring any keyword arguments).</div></p><p>When the procedure returned by <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-keyword-procedure%29%29" class="RktValLink" data-pltdoc="x">make-keyword-procedure</a></span>
+is called with keyword arguments, then <span class="RktVar">proc</span>
+is called; the first argument is a list of distinct keywords sorted by
+<span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3c~3f%29%29" class="RktValLink" data-pltdoc="x">keyword&lt;?</a></span>, the second argument is a parallel list containing a
+value for each keyword, and the remaining arguments are the
+by-position arguments.</p><p>When the procedure returned by <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-keyword-procedure%29%29" class="RktValLink" data-pltdoc="x">make-keyword-procedure</a></span>
+is called without keyword arguments, then
+<span class="RktVar">plain-proc</span> is called&#8212;<wbr></wbr>possibly more efficiently than
+dispatching through <span class="RktVar">proc</span>. Normally, <span class="RktVar">plain-proc</span>
+should have the same behavior as calling <span class="RktVar">proc</span> with empty lists as
+the first two arguments, but that correspondence is in no way
+enforced.</p><p>The result of <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-arity</a></span> and <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span> on the
+new procedure is the same as for <span class="RktVar">plain-proc</span>. See also
+<span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-reduce-keyword-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-reduce-keyword-arity</a></span> and <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-rename%29%29" class="RktValLink" data-pltdoc="x">procedure-rename</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">show</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-keyword-procedure%29%29" class="RktValLink" data-pltdoc="x">make-keyword-procedure</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">kws</span><span class="hspace">&nbsp;</span><span class="RktSym">kw-args</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">kws</span><span class="hspace">&nbsp;</span><span class="RktSym">kw-args</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(() () (1))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktPn">#:init</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktPn">#:extra</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((#:extra #:init) (4 0) (1 2 3))</span></p></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">show2</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-keyword-procedure%29%29" class="RktValLink" data-pltdoc="x">make-keyword-procedure</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">kws</span><span class="hspace">&nbsp;</span><span class="RktSym">kw-args</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">kws</span><span class="hspace">&nbsp;</span><span class="RktSym">kw-args</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktSym">args</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._list-~3evector%29%29" class="RktValLink" data-pltdoc="x">list-&gt;vector</a></span><span class="hspace">&nbsp;</span><span class="RktSym">args</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">show2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#(1)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">show2</span><span class="hspace">&nbsp;</span><span class="RktPn">#:init</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktPn">#:extra</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((#:extra #:init) (4 0) (1 2 3))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._procedure-reduce-keyword-arity))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-reduce-keyword-arity%29%29" class="RktValDef RktValLink" data-pltdoc="x">procedure-reduce-keyword-arity</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arity</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">required-kws</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">allowed-kws</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">realm</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arity</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">required-kws</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">allowed-kws</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">realm</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racket</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-reduce-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-reduce-arity</a></span>, but constrains the keyword
+arguments according to <span class="RktVar">required-kws</span> and <span class="RktVar">allowed-kws</span>,
+which must be sorted using <span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3c~3f%29%29" class="RktValLink" data-pltdoc="x">keyword&lt;?</a></span> and contain no duplicates. If <span class="RktVar">allowed-kws</span>
+is <span class="RktVal">#f</span>, then the resulting procedure still accepts any
+keyword, otherwise the keywords in <span class="RktVar">required-kws</span> must be a
+subset of those in <span class="RktVar">allowed-kws</span>. The original <span class="RktVar">proc</span>
+must require no more keywords than the ones listed in
+<span class="RktVar">required-kws</span>, and it must allow at least the keywords in
+<span class="RktVar">allowed-kws</span> (or it must allow all keywords if
+<span class="RktVar">allowed-kws</span> is <span class="RktVal">#f</span>).</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">orig-show</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-keyword-procedure%29%29" class="RktValLink" data-pltdoc="x">make-keyword-procedure</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">kws</span><span class="hspace">&nbsp;</span><span class="RktSym">kw-args</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">kws</span><span class="hspace">&nbsp;</span><span class="RktSym">kw-args</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-reduce-keyword-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-reduce-keyword-arity</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">orig-show</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">#:init</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">#:extra</span><span class="hspace">&nbsp;</span><span class="RktVal">#:init</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktPn">#:init</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktPn">#:extra</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((#:extra #:init) (4 0) (1 2 3))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">unknown: arity mismatch;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">the expected number of arguments does not match the given</span></p></td></tr><tr><td><p><span class="RktErr">number</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: 3 plus an argument with keyword #:init plus an</span></p></td></tr><tr><td><p><span class="RktErr">optional argument with keyword #:extra</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 1</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">arguments...:</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktPn">#:init</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktPn">#:extra</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktPn">#:more</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">application: procedure does not expect an argument with</span></p></td></tr><tr><td><p><span class="RktErr">given keyword</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">procedure: unknown</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given keyword: #:more</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">arguments...:</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">1</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">2</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">3</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">#:extra 4</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">#:init 0</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">#:more 7</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 8.4.0.2 of package <span class="stt">base</span>: Added the <span class="RktVar">realm</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._procedure-reduce-keyword-arity-mask))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-reduce-keyword-arity-mask%29%29" class="RktValDef RktValLink" data-pltdoc="x">procedure-reduce-keyword-arity-mask</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">mask</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">required-kws</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">allowed-kws</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">realm</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mask</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">required-kws</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">allowed-kws</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">realm</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racket</span></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-reduce-keyword-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-reduce-keyword-arity</a></span>, but using the
+representation of arity described with <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity-mask%29%29" class="RktValLink" data-pltdoc="x">procedure-arity-mask</a></span>.</div></p><p class="SHistory">Added in version 7.0.0.11 of package <span class="stt">base</span>.<br/>Changed in version 8.4.0.2: Added the <span class="RktVar">realm</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((quote._~23~25kernel)._arity-at-least-value))"></a><a name="(def._((lib._racket/private/base..rkt)._make-arity-at-least))"></a><a name="(def._((quote._~23~25kernel)._arity-at-least~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3aarity-at-least))"></a><a name="(def._((lib._racket/private/base..rkt)._arity-at-least))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValDef RktValLink" data-pltdoc="x">arity-at-least</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">value</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-arity-at-least%29%29" class="RktValLink" data-pltdoc="x">make-arity-at-least</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">value</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A structure type used for the result of <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-arity</a></span>.
+See also <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity?</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/private/base..rkt)._prop~3aprocedure))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:procedure</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property</span></a> to identify structure types whose
+instances can be applied as procedures. In particular, when
+<span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span> is applied to the instance, the result will be
+<span class="RktVal">#t</span>, and when an instance is used in the function position of
+an application expression, a procedure is extracted from the instance
+and used to complete the procedure call.</div></p><p>If the <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="RktValLink" data-pltdoc="x">prop:procedure</a></span> property value is an exact non-negative integer, it
+designates a field within the structure that should contain a
+procedure. The integer must be between <span class="RktVal">0</span> (inclusive) and the
+number of non-automatic fields in the structure type (exclusive, not
+counting supertype fields). The designated field must also be
+specified as immutable, so that after an instance of the structure is
+created, its procedure cannot be changed. (Otherwise, the arity and
+name of the instance could change, and such mutations are generally
+not allowed for procedures.) When the instance is used as the
+procedure in an application expression, the value of the designated
+field in the instance is used to complete the procedure call. (This
+procedure can be another structure that acts as a procedure; the
+immutability of procedure fields disallows cycles in the procedure
+graph, so that the procedure call will eventually continue with a
+non-structure procedure.) That procedure receives all of the arguments
+from the application expression. The procedure&rsquo;s name (see
+<span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span>), arity (see <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-arity</a></span>), and
+keyword protocol (see <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-keywords%29%29" class="RktValLink" data-pltdoc="x">procedure-keywords</a></span>) are also used for
+the name, arity, and keyword protocol of the structure. If the value
+in the designated field is not a procedure, then the instance behaves
+like <span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span><span class="RktPn">)</span> (i.e., a procedure which does not accept
+any number of arguments). See also <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-extract-target%29%29" class="RktValLink" data-pltdoc="x">procedure-extract-target</a></span>.</p><p>Providing an integer <span class="RktSym">proc-spec</span> argument to
+<span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span> is the same as both supplying the value with
+the <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="RktValLink" data-pltdoc="x">prop:procedure</a></span> property and designating the field as
+immutable (so that a property binding or immutable designation is
+redundant and disallowed).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">annotated-proc</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">base</span><span class="hspace">&nbsp;</span><span class="RktSym">note</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:property</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="RktValLink" data-pltdoc="x">prop:procedure</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-field-index%29%29" class="RktStxLink" data-pltdoc="x">struct-field-index</a></span><span class="hspace">&nbsp;</span><span class="RktSym">base</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">plus1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">annotated-proc</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"adds 1 to its argument"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">plus1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">annotated-proc?</span><span class="hspace">&nbsp;</span><span class="RktSym">plus1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">plus1</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">11</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">annotated-proc-note</span><span class="hspace">&nbsp;</span><span class="RktSym">plus1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"adds 1 to its argument"</span></p></td></tr></table></blockquote></div></p><p>When the <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="RktValLink" data-pltdoc="x">prop:procedure</a></span> value is a procedure, it should
+accept at least one non-keyword argument. When an instance of the
+structure is used in an application expression, the property-value
+procedure is called with the instance as the first argument. The
+remaining arguments to the property-value procedure are the arguments
+from the application expression (including keyword arguments). Thus,
+if the application expression provides five non-keyword arguments, the
+property-value procedure is called with six non-keyword arguments. The
+name of the instance (see <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span>) and its keyword
+protocol (see <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-keywords%29%29" class="RktValLink" data-pltdoc="x">procedure-keywords</a></span>) are unaffected by the
+property-value procedure, but the instance&rsquo;s arity is determined by
+subtracting one from every possible non-keyword argument count of the
+property-value procedure. If the property-value procedure cannot
+accept at least one argument, then the instance behaves like
+<span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span><span class="RktPn">)</span>.</p><p>Providing a procedure <span class="RktSym">proc-spec</span> argument to
+<span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span> is the same as supplying the value with the
+<span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="RktValLink" data-pltdoc="x">prop:procedure</a></span> property (so that a specific property binding
+is disallowed).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">weight</span><span class="hspace">&nbsp;</span><span class="RktSym">color</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:mutable</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:property</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="RktValLink" data-pltdoc="x">prop:procedure</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">w</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish-weight</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">set-fish-weight!</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">w</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">wanda</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktVal">12</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">red</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">fish?</span><span class="hspace">&nbsp;</span><span class="RktSym">wanda</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">wanda</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">fish-weight</span><span class="hspace">&nbsp;</span><span class="RktSym">wanda</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">12</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._for-each%29%29" class="RktValLink" data-pltdoc="x">for-each</a></span><span class="hspace">&nbsp;</span><span class="RktSym">wanda</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">fish-weight</span><span class="hspace">&nbsp;</span><span class="RktSym">wanda</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">18</span></p></td></tr></table></blockquote></div></p><p>If the value supplied for the <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="RktValLink" data-pltdoc="x">prop:procedure</a></span> property is not
+an exact non-negative integer or a procedure, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._procedure-struct-type~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-struct-type~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">procedure-struct-type?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">type</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">type</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-type~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if instances of the structure type represented by
+<span class="RktVar">type</span> are procedures (according to <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span>),
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._procedure-extract-target))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-extract-target%29%29" class="RktValDef RktValLink" data-pltdoc="x">procedure-extract-target</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">If <span class="RktVar">proc</span> is an instance of a structure type with property
+<span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="RktValLink" data-pltdoc="x">prop:procedure</a></span>, and if the property value indicates a field
+of the structure, and if the field value is a procedure, then
+<span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-extract-target%29%29" class="RktValLink" data-pltdoc="x">procedure-extract-target</a></span> returns the field value. Otherwise,
+the result is <span class="RktVal">#f</span>.</div></p><p>When a <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="RktValLink" data-pltdoc="x">prop:procedure</a></span> property value is a procedure, the
+procedure is <span class="emph">not</span> returned by
+<span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-extract-target%29%29" class="RktValLink" data-pltdoc="x">procedure-extract-target</a></span>. Such a procedure is different from
+one accessed through a structure field, because it consumes an extra
+argument, which is always the structure that was applied as a
+procedure. Keeping the procedure private ensures that is it always
+called with a suitable first argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._prop~3aarity-string))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._prop~3aarity-string%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:arity-string</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property</span></a> that is used for reporting arity-mismatch errors when a
+structure type with the <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="RktValLink" data-pltdoc="x">prop:procedure</a></span> property is applied to
+the wrong number of arguments. The value of the
+<span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._prop~3aarity-string%29%29" class="RktValLink" data-pltdoc="x">prop:arity-string</a></span> property must be a procedure that takes a
+single argument, which is the misapplied structure, and returns a
+string. The result string is used after the word &ldquo;expects,&rdquo; and it
+is followed in the error message by the number of actual arguments.</div></p><p>Arity-mismatch reporting automatically uses
+<span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-extract-target%29%29" class="RktValLink" data-pltdoc="x">procedure-extract-target</a></span> when the <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._prop~3aarity-string%29%29" class="RktValLink" data-pltdoc="x">prop:arity-string</a></span>
+property is not associated with a procedure structure type.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">evens</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">proc</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:property</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="RktValLink" data-pltdoc="x">prop:procedure</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-field-index%29%29" class="RktStxLink" data-pltdoc="x">struct-field-index</a></span><span class="hspace">&nbsp;</span><span class="RktSym">proc</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:property</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._prop~3aarity-string%29%29" class="RktValLink" data-pltdoc="x">prop:arity-string</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"an even number of arguments"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pairs</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">evens</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">more</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pairs</span><span class="hspace">&nbsp;</span><span class="RktSym">more</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">pairs</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((1 . 2) (3 . 4))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">pairs</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">arity mismatch;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">the expected number of arguments does not match the given</span></p></td></tr><tr><td><p><span class="RktErr">number</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: an even number of arguments</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 1</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">arguments...:</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">5</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._prop~3achecked-procedure))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._prop~3achecked-procedure%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:checked-procedure</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property</span></a> that is used with
+<span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._checked-procedure-check-and-extract%29%29" class="RktValLink" data-pltdoc="x">checked-procedure-check-and-extract</a></span>, which is a hook to allow
+the compiler to improve the performance of keyword arguments. The
+property can only be attached to a <a href="structures.html#%28tech._structure._type%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type</span></a> without a
+supertype and with at least two fields.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._checked-procedure-check-and-extract))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._checked-procedure-check-and-extract%29%29" class="RktValDef RktValLink" data-pltdoc="x">checked-procedure-check-and-extract</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">type</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v1</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v2</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">type</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-type~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Extracts a value from <span class="RktVar">v</span> if it is an instance of
+<span class="RktVar">type</span>, which must have the property
+<span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._prop~3achecked-procedure%29%29" class="RktValLink" data-pltdoc="x">prop:checked-procedure</a></span>. If <span class="RktVar">v</span> is such an instance,
+then the first field of <span class="RktVar">v</span> is extracted and applied to
+<span class="RktVar">v1</span> and <span class="RktVar">v2</span>; if the result is a true value, the result
+is the value of the second field of <span class="RktVar">v</span>.</div></p><p>If <span class="RktVar">v</span> is not an instance of <span class="RktVar">type</span>, or if the first
+field of <span class="RktVar">v</span> applied to <span class="RktVar">v1</span> and <span class="RktVar">v2</span> produces
+<span class="RktVal">#f</span>, then <span class="RktVar">proc</span> is applied to <span class="RktVar">v</span>, <span class="RktVar">v1</span>,
+and <span class="RktVar">v2</span>, and its result is returned by
+<span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._checked-procedure-check-and-extract%29%29" class="RktValLink" data-pltdoc="x">checked-procedure-check-and-extract</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._procedure-specialize))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-specialize%29%29" class="RktValDef RktValLink" data-pltdoc="x">procedure-specialize</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVar">proc</span> or its equivalent, but provides a hint to the
+run-time system that it should spend extra time and memory to
+specialize the implementation of <span class="RktVar">proc</span>.</div></p><p>The hint is currently used when <span class="RktVar">proc</span> is the value of a
+<span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span> or <span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span> form that references variables
+bound outside of the <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span> or <span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span>, and when
+<span class="RktVar">proc</span> has not been previously applied.</p><p class="SHistory">Added in version 6.3.0.10 of package <span class="stt">base</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Reflecting_on_Primitives&quot;">4.19.2<tt>&nbsp;</tt><a name="(part._.Reflecting_on_.Primitives)"></a>Reflecting on Primitives</h5><p>A <a name="(tech._primitive._procedure)"></a><span style="font-style: italic">primitive procedure</span> is a built-in procedure that may be
+implemented in a lower-level language. Not all procedures of
+<a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> are primitives, but many are. The
+distinction between primitives and other procedures may be useful to
+other low-level code.</p><p>The distinction between primitives and other procedures may also be
+useful for adjusting exception messages through parameters such as
+<span class="RktSym">error-primitive-name-&gt;symbol-handler</span>, but the notion of
+&ldquo;primitive&rdquo; for those handlers and the notion for
+<span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._primitive~3f%29%29" class="RktValLink" data-pltdoc="x">primitive?</a></span> do not coincide completely.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._primitive~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._primitive~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">primitive?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a primitive procedure,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._primitive-closure~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._primitive-closure~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">primitive-closure?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym">boolean</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is internally implemented as a
+primitive closure rather than a simple primitive procedure,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._primitive-result-arity))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._primitive-result-arity%29%29" class="RktValDef RktValLink" data-pltdoc="x">primitive-result-arity</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">prim</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prim</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._primitive~3f%29%29" class="RktValLink" data-pltdoc="x">primitive?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the arity of the result of the primitive procedure
+<span class="RktVar">prim</span> (as opposed to the procedure&rsquo;s input arity as returned
+by <span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-arity</a></span>). For most primitives, this procedure
+returns <span class="RktVal">1</span>, since most primitives return a single value when
+applied.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Additional_Higher-Order_Functions&quot;">4.19.3<tt>&nbsp;</tt><a name="(part._.Additional_.Higher-.Order_.Functions)"></a><a name="(mod-path._racket/function)"></a>Additional Higher-Order Functions</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="procedures.html#%28mod-path._racket%2Ffunction%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/function</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="procedures.html#%28mod-path._racket%2Ffunction%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/function</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/function..rkt)._identity))"></a><span title="Provided from: racket/function, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._identity%29%29" class="RktValDef RktValLink" data-pltdoc="x">identity</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVar">v</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/function..rkt)._const))"></a><span title="Provided from: racket/function, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._const%29%29" class="RktValDef RktValLink" data-pltdoc="x">const</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a procedure that accepts any arguments (including keyword
+arguments) and returns <span class="RktVar">v</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._const%29%29" class="RktValLink" data-pltdoc="x">const</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">foo</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'foo</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._const%29%29" class="RktValLink" data-pltdoc="x">const</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">foo</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'foo</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/function..rkt)._thunk))"></a><span title="Provided from: racket/function, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28form._%28%28lib._racket%2Ffunction..rkt%29._thunk%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">thunk</a></span></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/function..rkt)._thunk*))"></a><span title="Provided from: racket/function, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28form._%28%28lib._racket%2Ffunction..rkt%29._thunk%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">thunk*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="procedures.html#%28form._%28%28lib._racket%2Ffunction..rkt%29._thunk%29%29" class="RktStxLink" data-pltdoc="x">thunk</a></span> form creates a nullary function that evaluates the
+given body.  The <span class="RktSym"><a href="procedures.html#%28form._%28%28lib._racket%2Ffunction..rkt%29._thunk%2A%29%29" class="RktStxLink" data-pltdoc="x">thunk*</a></span> form is similar, except that the
+resulting function accepts any arguments (including keyword arguments).</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">th1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28form._%28%28lib._racket%2Ffunction..rkt%29._thunk%29%29" class="RktStxLink" data-pltdoc="x">thunk</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">th1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">th1</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">th1: arity mismatch;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">the expected number of arguments does not match the given</span></p></td></tr><tr><td><p><span class="RktErr">number</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: 0</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">th1</span><span class="hspace">&nbsp;</span><span class="RktPn">#:y</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">z</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">application: procedure does not accept keyword arguments</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">procedure: th1</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">arguments...:</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">#:y 'z</span></p></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">th2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28form._%28%28lib._racket%2Ffunction..rkt%29._thunk%2A%29%29" class="RktStxLink" data-pltdoc="x">thunk*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">th2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">th2</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">th2</span><span class="hspace">&nbsp;</span><span class="RktPn">#:y</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">z</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">1</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/function..rkt)._negate))"></a><span title="Provided from: racket/function, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._negate%29%29" class="RktValDef RktValLink" data-pltdoc="x">negate</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a procedure that is just like <span class="RktVar">proc</span>, except that it
+returns the <span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span> of <span class="RktVar">proc</span>&rsquo;s result.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._filter%29%29" class="RktValLink" data-pltdoc="x">filter</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._negate%29%29" class="RktValLink" data-pltdoc="x">negate</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">c</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._negate%29%29" class="RktValLink" data-pltdoc="x">negate</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#f #t #t)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">((</span><a name="(def._((lib._racket/function..rkt)._conjoin))"></a><span title="Provided from: racket/function, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._conjoin%29%29" class="RktValDef RktValLink" data-pltdoc="x">conjoin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Combines calls to each function with <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span>.  Equivalent to
+<span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">f</span><span class="stt"> </span><span class="RktVar">x</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._conjoin%29%29" class="RktValLink" data-pltdoc="x">conjoin</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact~3f%29%29" class="RktValLink" data-pltdoc="x">exact?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1/2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVal">0.5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._conjoin%29%29" class="RktValLink" data-pltdoc="x">conjoin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">((</span><a name="(def._((lib._racket/function..rkt)._disjoin))"></a><span title="Provided from: racket/function, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._disjoin%29%29" class="RktValDef RktValLink" data-pltdoc="x">disjoin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Combines calls to each function with <span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span>.  Equivalent to
+<span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">f</span><span class="stt"> </span><span class="RktVar">x</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._disjoin%29%29" class="RktValLink" data-pltdoc="x">disjoin</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact~3f%29%29" class="RktValLink" data-pltdoc="x">exact?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1/2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVal">0.5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._disjoin%29%29" class="RktValLink" data-pltdoc="x">disjoin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/function..rkt)._curry))"></a><span title="Provided from: racket/function, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValDef RktValLink" data-pltdoc="x">curry</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/function, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValDef RktValLink" data-pltdoc="x">curry</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">The result of <span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValLink" data-pltdoc="x">curry</a></span><span class="stt"> </span><span class="RktVar">proc</span><span class="RktPn">)</span> is a procedure that is a curried
+version of <span class="RktVar">proc</span>. When
+the resulting procedure is first applied, unless it is given the
+maximum number of arguments that it can accept according to
+<span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-arity</a></span><span class="stt"> </span><span class="RktVar">proc</span><span class="RktPn">)</span>, the result is a
+procedure to accept additional arguments.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValLink" data-pltdoc="x">curry</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;procedure:curried:list&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValLink" data-pltdoc="x">curry</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;procedure:curried:cons&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValLink" data-pltdoc="x">curry</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 . 2)</span></p></td></tr></table></blockquote></div></p><p>After the first application of the result of <span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValLink" data-pltdoc="x">curry</a></span><span class="stt"> </span><span class="RktVar">proc</span><span class="RktPn">)</span>, each
+further application accumulates arguments until an acceptable number
+of arguments according to <span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity%29%29" class="RktValLink" data-pltdoc="x">procedure-arity</a></span><span class="stt"> </span><span class="RktVar">proc</span><span class="RktPn">)</span> have been
+accumulated, at which point the original
+<span class="RktVar">proc</span> is called.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValLink" data-pltdoc="x">curry</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValLink" data-pltdoc="x">curry</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 3)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValLink" data-pltdoc="x">curry</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._foldl%29%29" class="RktValLink" data-pltdoc="x">foldl</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">6</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">foo</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValLink" data-pltdoc="x">curry</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">foo</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">foo</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3)</span></p></td></tr></table></blockquote></div></p><p>A function call <span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValLink" data-pltdoc="x">curry</a></span><span class="stt"> </span><span class="RktVar">proc</span><span class="stt"> </span><span class="RktVar">v</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> is equivalent to
+<span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValLink" data-pltdoc="x">curry</a></span><span class="stt"> </span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">v</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>. In other words, <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValLink" data-pltdoc="x">curry</a></span> itself
+is curried.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValLink" data-pltdoc="x">curry</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(11 12 13)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValLink" data-pltdoc="x">curry</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(11 12 13)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._compose%29%29" class="RktValLink" data-pltdoc="x">compose</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValLink" data-pltdoc="x">curry</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValLink" data-pltdoc="x">curry</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(22 24 26)</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValLink" data-pltdoc="x">curry</a></span> function also supports functions with keyword arguments:
+keyword arguments will be accumulated in the same way as positional arguments
+until all required keyword arguments according to <span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-keywords%29%29" class="RktValLink" data-pltdoc="x">procedure-keywords</a></span><span class="stt"> </span><span class="RktVar">proc</span><span class="RktPn">)</span>
+have been supplied.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">#:a</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktPn">#:b</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktPn">#:c</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValLink" data-pltdoc="x">curry</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:a</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:b</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:c</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValLink" data-pltdoc="x">curry</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:b</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:c</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:a</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(3 1 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValLink" data-pltdoc="x">curry</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">#:a</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">#:c</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:b</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 3 2)</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.7 of package <span class="stt">base</span>: Added support for keyword arguments.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/function..rkt)._curryr))"></a><span title="Provided from: racket/function, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curryr%29%29" class="RktValDef RktValLink" data-pltdoc="x">curryr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/function, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curryr%29%29" class="RktValDef RktValLink" data-pltdoc="x">curryr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curry%29%29" class="RktValLink" data-pltdoc="x">curry</a></span>, except that the arguments are collected in the
+opposite direction: the first step collects the rightmost group of
+arguments, and following steps add arguments to the left of these.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._curryr%29%29" class="RktValLink" data-pltdoc="x">curryr</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">foo</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((1 foo) (2 foo) (3 foo))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/function..rkt)._normalized-arity~3f))"></a><span title="Provided from: racket/function, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalized-arity~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">normalized-arity?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">arity</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arity</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A normalized arity has one of the following forms:
+</div><div class="SIntrapara"><ul><li><p>the empty list;</p></li><li><p>an exact non-negative integer;</p></li><li><p>an <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span> instance;</p></li><li><p>a list of two or more strictly increasing, exact non-negative integers;
+or</p></li><li><p>a list of one or more strictly increasing, exact non-negative integers
+followed by a single <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span> instance whose value is greater
+than the preceding integer by at least 2.</p></li></ul></div><div class="SIntrapara">Every normalized arity is a valid procedure arity and satisfies
+<span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity?</a></span>.  Any two normalized arity values that are
+<span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity~3d~3f%29%29" class="RktValLink" data-pltdoc="x">arity=?</a></span> must also be <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalized-arity~3f%29%29" class="RktValLink" data-pltdoc="x">normalized-arity?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalized-arity~3f%29%29" class="RktValLink" data-pltdoc="x">normalized-arity?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalized-arity~3f%29%29" class="RktValLink" data-pltdoc="x">normalized-arity?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalized-arity~3f%29%29" class="RktValLink" data-pltdoc="x">normalized-arity?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalized-arity~3f%29%29" class="RktValLink" data-pltdoc="x">normalized-arity?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/function..rkt)._normalize-arity))"></a><span title="Provided from: racket/function, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalize-arity%29%29" class="RktValDef RktValLink" data-pltdoc="x">normalize-arity</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">arity</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalized-arity~3f%29%29" class="RktValLink" data-pltdoc="x">normalized-arity?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity~3d~3f%29%29" class="RktValLink" data-pltdoc="x">arity=?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVar">arity</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arity</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a normalized form of <span class="RktVar">arity</span>.  See also
+<span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalized-arity~3f%29%29" class="RktValLink" data-pltdoc="x">normalized-arity?</a></span> and <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity~3d~3f%29%29" class="RktValLink" data-pltdoc="x">arity=?</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalize-arity%29%29" class="RktValLink" data-pltdoc="x">normalize-arity</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalize-arity%29%29" class="RktValLink" data-pltdoc="x">normalize-arity</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalize-arity%29%29" class="RktValLink" data-pltdoc="x">normalize-arity</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(arity-at-least 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalize-arity%29%29" class="RktValLink" data-pltdoc="x">normalize-arity</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(arity-at-least 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalize-arity%29%29" class="RktValLink" data-pltdoc="x">normalize-arity</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(arity-at-least 1)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalize-arity%29%29" class="RktValLink" data-pltdoc="x">normalize-arity</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(arity-at-least 1)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalize-arity%29%29" class="RktValLink" data-pltdoc="x">normalize-arity</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(arity-at-least 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalize-arity%29%29" class="RktValLink" data-pltdoc="x">normalize-arity</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(arity-at-least 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalize-arity%29%29" class="RktValLink" data-pltdoc="x">normalize-arity</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(list 0 2 (arity-at-least 4))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/function..rkt)._arity~3d~3f))"></a><span title="Provided from: racket/function, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">arity=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#true</span> if procedures with arity <span class="RktVar">a</span> and <span class="RktVar">b</span>
+accept the same numbers of arguments, and <span class="RktVal">#false</span> otherwise.
+Equivalent to both <span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">arity-includes?</a></span><span class="stt"> </span><span class="RktVar">a</span><span class="stt"> </span><span class="RktVar">b</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">arity-includes?</a></span><span class="stt"> </span><span class="RktVar">b</span><span class="stt"> </span><span class="RktVar">a</span><span class="RktPn">)</span><span class="RktPn">)</span>
+and <span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalize-arity%29%29" class="RktValLink" data-pltdoc="x">normalize-arity</a></span><span class="stt"> </span><span class="RktVar">a</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._normalize-arity%29%29" class="RktValLink" data-pltdoc="x">normalize-arity</a></span><span class="stt"> </span><span class="RktVar">b</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity~3d~3f%29%29" class="RktValLink" data-pltdoc="x">arity=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity~3d~3f%29%29" class="RktValLink" data-pltdoc="x">arity=?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity~3d~3f%29%29" class="RktValLink" data-pltdoc="x">arity=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity~3d~3f%29%29" class="RktValLink" data-pltdoc="x">arity=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity~3d~3f%29%29" class="RktValLink" data-pltdoc="x">arity=?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity~3d~3f%29%29" class="RktValLink" data-pltdoc="x">arity=?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity~3d~3f%29%29" class="RktValLink" data-pltdoc="x">arity=?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity~3d~3f%29%29" class="RktValLink" data-pltdoc="x">arity=?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity~3d~3f%29%29" class="RktValLink" data-pltdoc="x">arity=?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity~3d~3f%29%29" class="RktValLink" data-pltdoc="x">arity=?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity~3d~3f%29%29" class="RktValLink" data-pltdoc="x">arity=?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity~3d~3f%29%29" class="RktValLink" data-pltdoc="x">arity=?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity~3d~3f%29%29" class="RktValLink" data-pltdoc="x">arity=?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/function..rkt)._arity-includes~3f))"></a><span title="Provided from: racket/function, racket | Package: base"><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity-includes~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">arity-includes?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure-arity~3f%29%29" class="RktValLink" data-pltdoc="x">procedure-arity?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#true</span> if procedures with arity <span class="RktVar">a</span> accept any number of
+arguments that procedures with arity <span class="RktVar">b</span> accept.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._arity-includes~3f%29%29" class="RktValLink" data-pltdoc="x">arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="sets.html" title="backward to &quot;4.18 Sets&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="void.html" title="forward to &quot;4.20 Void&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/quasiquote.html b/clones/docs.racket-lang.org/reference/quasiquote.html
new file mode 100644
index 00000000..fca81171
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/quasiquote.html
@@ -0,0 +1,36 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.20&nbsp;Quasiquoting: quasiquote, unquote, and unquote-splicing</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewselflink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">quasiquote</span></span></a></td></tr><tr><td><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unquote</span></span></a></td></tr><tr><td><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="wcm.html" title="backward to &quot;3.19 Continuation Marks: with-continuation-mark&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Syntax_Quoting__quote-syntax.html" title="forward to &quot;3.21 Syntax Quoting: quote-syntax&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;quasiquote&quot;">3.20<tt>&nbsp;</tt><a name="(part._quasiquote)"></a>Quasiquoting: <span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span>, <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote%29%29" class="RktStxLink" data-pltdoc="x">unquote</a></span>, and <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxLink" data-pltdoc="x">unquote-splicing</a></span></h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=qq.html&amp;version=8.6" class="Sq" data-pltdoc="x">Quasiquoting: <span class="RktSym"><span class="RktStxLink">quasiquote</span></span> and <span class="RktVal">&lsquo;</span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces <span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span>.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/letstx-scheme..rkt)._quasiquote))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">quasiquote</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">datum</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktVal">'</span><span class="RktVal">datum</span> if <span class="RktVar">datum</span> does not include
+<span class="RktPn">(</span><span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote%29%29" class="RktStxLink" data-pltdoc="x">unquote</a></span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span> or <span class="RktPn">(</span><span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxLink" data-pltdoc="x">unquote-splicing</a></span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span>. An
+<span class="RktPn">(</span><span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote%29%29" class="RktStxLink" data-pltdoc="x">unquote</a></span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span> form escapes from the quote, however,
+and the result of the <span class="RktVar">expr</span> takes the place of the
+<span class="RktPn">(</span><span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote%29%29" class="RktStxLink" data-pltdoc="x">unquote</a></span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span> form in the <span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span> result. An
+<span class="RktPn">(</span><span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxLink" data-pltdoc="x">unquote-splicing</a></span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span> similarly escapes, but the
+<span class="RktVar">expr</span> produces a list whose elements are spliced as
+multiple values place of the <span class="RktPn">(</span><span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxLink" data-pltdoc="x">unquote-splicing</a></span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span>.</div></p><p>An <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote%29%29" class="RktStxLink" data-pltdoc="x">unquote</a></span> or <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxLink" data-pltdoc="x">unquote-splicing</a></span> form is recognized in any
+of the following escaping positions within <span class="RktVar">datum</span>: in a pair,
+in a vector, in a box, in a <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure field after the
+name position, and in hash table value position (but not in a hash
+table key position). Such escaping positions can be nested to an
+arbitrary depth.</p><p>An <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxLink" data-pltdoc="x">unquote-splicing</a></span> form must appear as the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> of a
+quoted pair, as an element of a quoted vector, or as an element of a
+quoted <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure. In the case of a pair, if the
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> of the relevant quoted pair is empty, then <span class="RktVar">expr</span>
+need not produce a list, and its result is used directly in place of
+the quoted pair (in the same way that <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._append%29%29" class="RktValLink" data-pltdoc="x">append</a></span> accepts a
+non-list final argument).</p><p>If <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote%29%29" class="RktStxLink" data-pltdoc="x">unquote</a></span> or <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxLink" data-pltdoc="x">unquote-splicing</a></span> appears within
+<span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span> in an escaping position but in a way other than as
+<span class="RktPn">(</span><span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote%29%29" class="RktStxLink" data-pltdoc="x">unquote</a></span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span> or <span class="RktPn">(</span><span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxLink" data-pltdoc="x">unquote-splicing</a></span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span>, a syntax error is reported.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(0 1 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote%29%29" class="RktStxLink" data-pltdoc="x">unquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(0 3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxLink" data-pltdoc="x">unquote-splicing</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(0 1 2 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxLink" data-pltdoc="x">unquote-splicing</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">unquote-splicing: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: list?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxLink" data-pltdoc="x">unquote-splicing</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(0 . 1)</span></p></td></tr></table></blockquote></div></p><p>A <span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span>, <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote%29%29" class="RktStxLink" data-pltdoc="x">unquote</a></span>, or <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxLink" data-pltdoc="x">unquote-splicing</a></span>
+form is typically abbreviated with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">`</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">,</span><span class="hspace"></span></span>, or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">,@</span><span class="hspace"></span></span>, respectively. See also <a href="reader.html#%28part._parse-quote%29" data-pltdoc="x">Reading Quotes</a>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span></td></tr><tr><td><p><span class="RktRes">'(0 1 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktRdr">,</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span></td></tr><tr><td><p><span class="RktRes">'(1 3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">`</span><span class="RktVal">#s</span><span class="RktVal">(</span><span class="RktVal">stuff</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktRdr">,</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span></td></tr><tr><td><p><span class="RktRes">'#s(stuff 1 3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">`</span><span class="RktVal">#hash</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktRdr">,</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktVal">)</span><span class="RktVal">)</span></td></tr><tr><td><p><span class="RktRes">'#hash(("a" . 3))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">`</span><span class="RktVal">#hash</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">,</span><span class="RktVal">(</span><span class="RktVal">+</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">"a"</span><span class="RktVal">)</span><span class="RktVal">)</span></td></tr><tr><td><p><span class="RktRes">'#hash((,(+ 1 2) . "a"))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktRdr">,@</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span></td></tr><tr><td><p><span class="RktRes">'(1 1 2 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">`</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktRdr">,@</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span></td></tr><tr><td><p><span class="RktRes">'#(1 1 2 4)</span></p></td></tr></table></blockquote></div></p><p>A <span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span> form within the original <span class="RktVar">datum</span>
+increments the level of quasiquotation: within the <span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span>
+form, each <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote%29%29" class="RktStxLink" data-pltdoc="x">unquote</a></span> or <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxLink" data-pltdoc="x">unquote-splicing</a></span> is preserved,
+but a further nested <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote%29%29" class="RktStxLink" data-pltdoc="x">unquote</a></span> or <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxLink" data-pltdoc="x">unquote-splicing</a></span>
+escapes.  Multiple nestings of <span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span> require multiple
+nestings of <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote%29%29" class="RktStxLink" data-pltdoc="x">unquote</a></span> or <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxLink" data-pltdoc="x">unquote-splicing</a></span> to escape.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">`</span><span class="RktVal">,</span><span class="RktVal">(</span><span class="RktVal">+</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktRdr">,</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span></td></tr><tr><td><p><span class="RktRes">'(1 `,(+ 1 5) 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">`</span><span class="RktVal">`</span><span class="RktVal">`</span><span class="RktVal">,</span><span class="RktVal">,@</span><span class="RktVal">,</span><span class="RktRdr">,@</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span></td></tr><tr><td><p><span class="RktRes">'(1 ```,,@,3 4)</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span> form allocates only as many fresh cons cells,
+vectors, and boxes as are needed without analyzing <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote%29%29" class="RktStxLink" data-pltdoc="x">unquote</a></span>
+and <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxLink" data-pltdoc="x">unquote-splicing</a></span> expressions. For example, in</p><blockquote class="SCodeFlow"><p><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktRdr">,</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span></p></blockquote><p>a single tail <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="stt"> </span><span class="RktVal">3</span><span class="RktVal">)</span> is used for every evaluation of the
+<span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span> expression. When allocating fresh data,
+the <span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span> form allocates mutable vectors, mutable boxes
+and immutable hashes.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">`</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktRdr">,</span><span class="RktVal">0</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">`</span><span class="RktVal">#hash</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktRdr">,</span><span class="RktVal">0</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((quote._~23~25kernel)._unquote))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">unquote</a></span></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span>, where <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote%29%29" class="RktStxLink" data-pltdoc="x">unquote</a></span> is recognized as an
+escape. An <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote%29%29" class="RktStxLink" data-pltdoc="x">unquote</a></span> form as an expression is a syntax error.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((quote._~23~25kernel)._unquote-splicing))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">unquote-splicing</a></span></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span>, where <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxLink" data-pltdoc="x">unquote-splicing</a></span> is recognized as an
+escape. An <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxLink" data-pltdoc="x">unquote-splicing</a></span> form as an expression is a syntax error.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="wcm.html" title="backward to &quot;3.19 Continuation Marks: with-continuation-mark&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Syntax_Quoting__quote-syntax.html" title="forward to &quot;3.21 Syntax Quoting: quote-syntax&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/quote.html b/clones/docs.racket-lang.org/reference/quote.html
new file mode 100644
index 00000000..78cf1f13
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/quote.html
@@ -0,0 +1,9 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.3&nbsp;Literals: quote and #%datum</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewselflink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">quote</span></span></a></td></tr><tr><td><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._~23~25datum%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="require.html" title="backward to &quot;3.2 Importing and Exporting: require and provide&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="__expression.html" title="forward to &quot;3.4 Expression Wrapper: #%expression&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;quote&quot;">3.3<tt>&nbsp;</tt><a name="(part._quote)"></a>Literals: <span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span> and <span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._~23~25datum%29%29" class="RktStxLink" data-pltdoc="x">#%datum</a></span></h4><p>Many forms are implicitly quoted (via <span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._~23~25datum%29%29" class="RktStxLink" data-pltdoc="x">#%datum</a></span>) as literals. See
+<a href="syntax-model.html#%28part._expand-steps%29" data-pltdoc="x">Expansion Steps</a> for more information.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=quote.html&amp;version=8.6" class="Sq" data-pltdoc="x">Quoting: <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktVal">&rsquo;</span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces <span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span>.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._quote))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">quote</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">datum</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Produces a constant value corresponding to <span class="RktVar">datum</span> (i.e., the
+representation of the program fragment) without its <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical
+information</span></a>, source location, etc.  Quoted pairs, vectors, and boxes
+are immutable.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktKw">quote</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'x</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktKw">quote</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(+ 1 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._~23~25datum))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._~23~25datum%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">#%datum</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">datum</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Expands to <span class="RktPn">(</span><span class="RktKw">quote</span><span class="stt"> </span><span class="RktVar">datum</span><span class="RktPn">)</span>, as long as
+<span class="RktVar">datum</span> is not a keyword. If <span class="RktVar">datum</span> is a keyword, a
+syntax error is reported.</div></p><p>See also <a href="syntax-model.html#%28part._expand-steps%29" data-pltdoc="x">Expansion Steps</a> for information on how the expander
+introduces <span class="RktSym">#%datum</span> identifiers.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._~23~25datum%29%29" class="RktStxLink" data-pltdoc="x">#%datum</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._~23~25datum%29%29" class="RktStxLink" data-pltdoc="x">#%datum</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'x</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._~23~25datum%29%29" class="RktStxLink" data-pltdoc="x">#%datum</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktPn">#:x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">eval:6:0: #%datum: keyword misused as an expression</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: #:x</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="require.html" title="backward to &quot;3.2 Importing and Exporting: require and provide&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="__expression.html" title="forward to &quot;3.4 Expression Wrapper: #%expression&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/racket_contract_base.html b/clones/docs.racket-lang.org/reference/racket_contract_base.html
new file mode 100644
index 00000000..4af37dab
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/racket_contract_base.html
@@ -0,0 +1,10 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>8.9&nbsp;racket/contract/base</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.1&nbsp;</td><td><a href="data-structure-contracts.html" class="tocviewlink" data-pltdoc="x">Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.2&nbsp;</td><td><a href="function-contracts.html" class="tocviewlink" data-pltdoc="x">Function Contracts</a></td></tr><tr><td align="right">8.3&nbsp;</td><td><a href="parametric-contracts.html" class="tocviewlink" data-pltdoc="x">Parametric Contracts</a></td></tr><tr><td align="right">8.4&nbsp;</td><td><a href="Lazy_Data-structure_Contracts.html" class="tocviewlink" data-pltdoc="x">Lazy Data-<wbr></wbr>structure Contracts</a></td></tr><tr><td align="right">8.5&nbsp;</td><td><a href="Structure_Type_Property_Contracts.html" class="tocviewlink" data-pltdoc="x">Structure Type Property Contracts</a></td></tr><tr><td align="right">8.6&nbsp;</td><td><a href="attaching-contracts-to-values.html" class="tocviewlink" data-pltdoc="x">Attaching Contracts to Values</a></td></tr><tr><td align="right">8.7&nbsp;</td><td><a href="Building_New_Contract_Combinators.html" class="tocviewlink" data-pltdoc="x">Building New Contract Combinators</a></td></tr><tr><td align="right">8.8&nbsp;</td><td><a href="contract-utilities.html" class="tocviewlink" data-pltdoc="x">Contract Utilities</a></td></tr><tr><td align="right">8.9&nbsp;</td><td><a href="racket_contract_base.html" class="tocviewselflink" data-pltdoc="x"><span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>contract/<span class="mywbr"> &nbsp;</span>base</span></span></a></td></tr><tr><td align="right">8.10&nbsp;</td><td><a href="collapsible.html" class="tocviewlink" data-pltdoc="x">Collapsible Contracts</a></td></tr><tr><td align="right">8.11&nbsp;</td><td><a href="Legacy_Contracts.html" class="tocviewlink" data-pltdoc="x">Legacy Contracts</a></td></tr><tr><td align="right">8.12&nbsp;</td><td><a href="Random_generation.html" class="tocviewlink" data-pltdoc="x">Random generation</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contract-utilities.html" title="backward to &quot;8.8 Contract Utilities&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="collapsible.html" title="forward to &quot;8.10 Collapsible Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;racket_contract_base&quot;">8.9<tt>&nbsp;</tt><a name="(part._racket_contract_base)"></a><a name="(mod-path._racket/contract/base)"></a><a href="racket_contract_base.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/contract/base</span></a></h4><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="racket_contract_base.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/contract/base</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></p><p><div class="SIntrapara">The <a href="racket_contract_base.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/contract/base</span></a> module provides a subset
+of the exports of <a href="contracts.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/contract</span></a> module. In
+particular, it contains everything in the
+</div><div class="SIntrapara"><ul><li><p><a href="data-structure-contracts.html" data-pltdoc="x">Data-structure Contracts</a></p></li><li><p><a href="function-contracts.html" data-pltdoc="x">Function Contracts</a></p></li><li><p><a href="attaching-contracts-to-values.html" data-pltdoc="x">Attaching Contracts to Values</a> and</p></li><li><p><a href="contract-utilities.html" data-pltdoc="x">Contract Utilities</a> sections.</p></li></ul></div></p><p>Unfortunately, using <a href="racket_contract_base.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/contract/base</span></a> does not
+yield a significantly smaller memory footprint than
+<a href="contracts.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/contract</span></a>, but it can still be useful to
+add contracts to libraries that <a href="contracts.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/contract</span></a>
+uses to implement some of the more sophisticated
+parts of the contract system.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contract-utilities.html" title="backward to &quot;8.8 Contract Utilities&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;8 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="collapsible.html" title="forward to &quot;8.10 Collapsible Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/reader-procs.html b/clones/docs.racket-lang.org/reference/reader-procs.html
new file mode 100644
index 00000000..1e8783cb
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/reader-procs.html
@@ -0,0 +1,32 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.7.2&nbsp;Reader-Extension Procedures</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewselflink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.7.1&nbsp;</td><td><a href="readtables.html" class="tocviewlink" data-pltdoc="x">Readtables</a></td></tr><tr><td align="right">13.7.2&nbsp;</td><td><a href="reader-procs.html" class="tocviewselflink" data-pltdoc="x">Reader-<wbr></wbr>Extension Procedures</a></td></tr><tr><td align="right">13.7.3&nbsp;</td><td><a href="special-comments.html" class="tocviewlink" data-pltdoc="x">Special Comments</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="readtables.html" title="backward to &quot;13.7.1 Readtables&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Reader_Extension.html" title="up to &quot;13.7 Reader Extension&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="special-comments.html" title="forward to &quot;13.7.3 Special Comments&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;reader-procs&quot;">13.7.2<tt>&nbsp;</tt><a name="(part._reader-procs)"></a>Reader-Extension Procedures</h5><p>Calls to <a href="Reader_Extension.html#%28tech._reader._extension._procedure%29" data-pltdoc="x">reader extension procedures</a> can be triggered
+through <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>, <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read/recursive</a></span>, or <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>.
+In addition, a special-read procedure
+can be triggered by calls to <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char-or-special%29%29" class="RktValLink" data-pltdoc="x">read-char-or-special</a></span>, or
+by the context of <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%29%29" class="RktValLink" data-pltdoc="x">read-bytes-avail!</a></span>,
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes-avail%21%2A%29%29" class="RktValLink" data-pltdoc="x">peek-bytes-avail!*</a></span>, <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-avail%21%29%29" class="RktValLink" data-pltdoc="x">read-bytes-avail!</a></span>, and
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes-avail%21%2A%29%29" class="RktValLink" data-pltdoc="x">peek-bytes-avail!*</a></span>.</p><p>Optional arities for reader-macro and special-result procedures allow
+them to distinguish reads via <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>, etc<span class="Sendabbrev">.</span>, from reads via
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>, etc<span class="Sendabbrev">.</span> (where the source value is <span class="RktVal">#f</span> and
+no other location information is available).</p><p>When a reader-extension procedure is called in syntax-reading mode
+(via <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>, etc<span class="Sendabbrev">.</span>), it should generally return a syntax
+object that has no lexical context (e.g., a syntax object created
+using <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span> with <span class="RktVal">#f</span> as the first
+argument and with the given location information as the third
+argument). Another possible result is a special-comment value (see
+<a href="special-comments.html" data-pltdoc="x">Special Comments</a>). If the procedure&rsquo;s result is not a
+syntax object and not a special-comment value, it is converted to one
+using <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span>.</p><p>When a reader-extension procedure is called in non-syntax-reading
+modes, it should generally not return a syntax object. If a syntax
+object is returned, it is converted to a plain value using
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span>.</p><p>In either context, when the result from a reader-extension procedure
+is a special-comment value (see <a href="special-comments.html" data-pltdoc="x">Special Comments</a>), then
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>, <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>, etc<span class="Sendabbrev">.</span> treat the value as a
+delimiting comment and otherwise ignore it.</p><p>Also, in either context, the result may be copied to prevent mutation
+to vectors or boxes before the read result is completed, and to
+support the construction of graphs with cycles. Mutable boxes,
+vectors, and <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structures are copied, along with any
+pairs, boxes, vectors, prefab structures that lead to such mutable
+values, to placeholders produced by a recursive read (see
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read/recursive</a></span>), or to references of a shared value. Graph
+structure (including cycles) is preserved in the copy.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="readtables.html" title="backward to &quot;13.7.1 Readtables&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Reader_Extension.html" title="up to &quot;13.7 Reader Extension&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="special-comments.html" title="forward to &quot;13.7.3 Special Comments&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/reader.html b/clones/docs.racket-lang.org/reference/reader.html
new file mode 100644
index 00000000..0e5b5984
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/reader.html
@@ -0,0 +1,468 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>1.3&nbsp;The Reader</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewselflink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">1.1&nbsp;</td><td><a href="eval-model.html" class="tocviewlink" data-pltdoc="x">Evaluation Model</a></td></tr><tr><td align="right">1.2&nbsp;</td><td><a href="syntax-model.html" class="tocviewlink" data-pltdoc="x">Syntax Model</a></td></tr><tr><td align="right">1.3&nbsp;</td><td><a href="reader.html" class="tocviewselflink" data-pltdoc="x">The Reader</a></td></tr><tr><td align="right">1.4&nbsp;</td><td><a href="printing.html" class="tocviewlink" data-pltdoc="x">The Printer</a></td></tr><tr><td align="right">1.5&nbsp;</td><td><a href="implementations.html" class="tocviewlink" data-pltdoc="x">Implementations</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>1.3&nbsp;</td><td><a href="reader.html" class="tocviewselflink" data-pltdoc="x">The Reader</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">1.3.1&nbsp;</td><td><a href="reader.html#%28part._default-readtable-dispatch%29" class="tocviewlink" data-pltdoc="x">Delimiters and Dispatch</a></td></tr><tr><td align="right">1.3.2&nbsp;</td><td><a href="reader.html#%28part._parse-symbol%29" class="tocviewlink" data-pltdoc="x">Reading Symbols</a></td></tr><tr><td align="right">1.3.3&nbsp;</td><td><a href="reader.html#%28part._parse-number%29" class="tocviewlink" data-pltdoc="x">Reading Numbers</a></td></tr><tr><td align="right">1.3.4&nbsp;</td><td><a href="reader.html#%28part._parse-extflonum%29" class="tocviewlink" data-pltdoc="x">Reading Extflonums</a></td></tr><tr><td align="right">1.3.5&nbsp;</td><td><a href="reader.html#%28part._parse-boolean%29" class="tocviewlink" data-pltdoc="x">Reading Booleans</a></td></tr><tr><td align="right">1.3.6&nbsp;</td><td><a href="reader.html#%28part._parse-pair%29" class="tocviewlink" data-pltdoc="x">Reading Pairs and Lists</a></td></tr><tr><td align="right">1.3.7&nbsp;</td><td><a href="reader.html#%28part._parse-string%29" class="tocviewlink" data-pltdoc="x">Reading Strings</a></td></tr><tr><td align="right">1.3.8&nbsp;</td><td><a href="reader.html#%28part._parse-quote%29" class="tocviewlink" data-pltdoc="x">Reading Quotes</a></td></tr><tr><td align="right">1.3.9&nbsp;</td><td><a href="reader.html#%28part._parse-comment%29" class="tocviewlink" data-pltdoc="x">Reading Comments</a></td></tr><tr><td align="right">1.3.10&nbsp;</td><td><a href="reader.html#%28part._parse-vector%29" class="tocviewlink" data-pltdoc="x">Reading Vectors</a></td></tr><tr><td align="right">1.3.11&nbsp;</td><td><a href="reader.html#%28part._parse-structure%29" class="tocviewlink" data-pltdoc="x">Reading Structures</a></td></tr><tr><td align="right">1.3.12&nbsp;</td><td><a href="reader.html#%28part._parse-hashtable%29" class="tocviewlink" data-pltdoc="x">Reading Hash Tables</a></td></tr><tr><td align="right">1.3.13&nbsp;</td><td><a href="reader.html#%28part._parse-box%29" class="tocviewlink" data-pltdoc="x">Reading Boxes</a></td></tr><tr><td align="right">1.3.14&nbsp;</td><td><a href="reader.html#%28part._parse-character%29" class="tocviewlink" data-pltdoc="x">Reading Characters</a></td></tr><tr><td align="right">1.3.15&nbsp;</td><td><a href="reader.html#%28part._parse-keyword%29" class="tocviewlink" data-pltdoc="x">Reading Keywords</a></td></tr><tr><td align="right">1.3.16&nbsp;</td><td><a href="reader.html#%28part._parse-regexp%29" class="tocviewlink" data-pltdoc="x">Reading Regular Expressions</a></td></tr><tr><td align="right">1.3.17&nbsp;</td><td><a href="reader.html#%28part._parse-graph%29" class="tocviewlink" data-pltdoc="x">Reading Graph Structure</a></td></tr><tr><td align="right">1.3.18&nbsp;</td><td><a href="reader.html#%28part._parse-reader%29" class="tocviewlink" data-pltdoc="x">Reading via an Extension</a></td></tr><tr><td align="right">1.3.19&nbsp;</td><td><a href="reader.html#%28part._parse-cdot%29" class="tocviewlink" data-pltdoc="x">Reading with C-<wbr></wbr>style Infix-<wbr></wbr>Dot Notation</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">1.3.1<tt>&nbsp;</tt></span><a href="reader.html#%28part._default-readtable-dispatch%29" class="tocsubseclink" data-pltdoc="x">Delimiters and Dispatch</a></td></tr><tr><td><span class="tocsublinknumber">1.3.2<tt>&nbsp;</tt></span><a href="reader.html#%28part._parse-symbol%29" class="tocsubseclink" data-pltdoc="x">Reading Symbols</a></td></tr><tr><td><span class="tocsublinknumber">1.3.3<tt>&nbsp;</tt></span><a href="reader.html#%28part._parse-number%29" class="tocsubseclink" data-pltdoc="x">Reading Numbers</a></td></tr><tr><td><span class="tocsublinknumber">1.3.4<tt>&nbsp;</tt></span><a href="reader.html#%28part._parse-extflonum%29" class="tocsubseclink" data-pltdoc="x">Reading Extflonums</a></td></tr><tr><td><span class="tocsublinknumber">1.3.5<tt>&nbsp;</tt></span><a href="reader.html#%28part._parse-boolean%29" class="tocsubseclink" data-pltdoc="x">Reading Booleans</a></td></tr><tr><td><span class="tocsublinknumber">1.3.6<tt>&nbsp;</tt></span><a href="reader.html#%28part._parse-pair%29" class="tocsubseclink" data-pltdoc="x">Reading Pairs and Lists</a></td></tr><tr><td><span class="tocsublinknumber">1.3.7<tt>&nbsp;</tt></span><a href="reader.html#%28part._parse-string%29" class="tocsubseclink" data-pltdoc="x">Reading Strings</a></td></tr><tr><td><span class="tocsublinknumber">1.3.8<tt>&nbsp;</tt></span><a href="reader.html#%28part._parse-quote%29" class="tocsubseclink" data-pltdoc="x">Reading Quotes</a></td></tr><tr><td><span class="tocsublinknumber">1.3.9<tt>&nbsp;</tt></span><a href="reader.html#%28part._parse-comment%29" class="tocsubseclink" data-pltdoc="x">Reading Comments</a></td></tr><tr><td><span class="tocsublinknumber">1.3.10<tt>&nbsp;</tt></span><a href="reader.html#%28part._parse-vector%29" class="tocsubseclink" data-pltdoc="x">Reading Vectors</a></td></tr><tr><td><span class="tocsublinknumber">1.3.11<tt>&nbsp;</tt></span><a href="reader.html#%28part._parse-structure%29" class="tocsubseclink" data-pltdoc="x">Reading Structures</a></td></tr><tr><td><span class="tocsublinknumber">1.3.12<tt>&nbsp;</tt></span><a href="reader.html#%28part._parse-hashtable%29" class="tocsubseclink" data-pltdoc="x">Reading Hash Tables</a></td></tr><tr><td><span class="tocsublinknumber">1.3.13<tt>&nbsp;</tt></span><a href="reader.html#%28part._parse-box%29" class="tocsubseclink" data-pltdoc="x">Reading Boxes</a></td></tr><tr><td><span class="tocsublinknumber">1.3.14<tt>&nbsp;</tt></span><a href="reader.html#%28part._parse-character%29" class="tocsubseclink" data-pltdoc="x">Reading Characters</a></td></tr><tr><td><span class="tocsublinknumber">1.3.15<tt>&nbsp;</tt></span><a href="reader.html#%28part._parse-keyword%29" class="tocsubseclink" data-pltdoc="x">Reading Keywords</a></td></tr><tr><td><span class="tocsublinknumber">1.3.16<tt>&nbsp;</tt></span><a href="reader.html#%28part._parse-regexp%29" class="tocsubseclink" data-pltdoc="x">Reading Regular Expressions</a></td></tr><tr><td><span class="tocsublinknumber">1.3.17<tt>&nbsp;</tt></span><a href="reader.html#%28part._parse-graph%29" class="tocsubseclink" data-pltdoc="x">Reading Graph Structure</a></td></tr><tr><td><span class="tocsublinknumber">1.3.18<tt>&nbsp;</tt></span><a href="reader.html#%28part._parse-reader%29" class="tocsubseclink" data-pltdoc="x">Reading via an Extension</a></td></tr><tr><td><span class="tocsublinknumber">1.3.19<tt>&nbsp;</tt></span><a href="reader.html#%28part._parse-cdot%29" class="tocsubseclink" data-pltdoc="x">Reading with C-<wbr></wbr>style Infix-<wbr></wbr>Dot Notation</a></td></tr><tr><td><span class="tocsublinknumber">1.3.19.1<tt>&nbsp;</tt></span><a href="reader.html#%28part._.S-.Expression_.Reader_.Language%29" class="tocsubseclink" data-pltdoc="x">S-<wbr></wbr>Expression Reader Language</a></td></tr><tr><td><span class="tocsublinknumber">1.3.19.2<tt>&nbsp;</tt></span><a href="reader.html#%28part._.Chaining_.Reader_.Language%29" class="tocsubseclink" data-pltdoc="x">Chaining Reader Language</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="syntax-model.html" title="backward to &quot;1.2 Syntax Model&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="model.html" title="up to &quot;1 Language Model&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="printing.html" title="forward to &quot;1.4 The Printer&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;reader&quot;">1.3<tt>&nbsp;</tt><a name="(part._reader)"></a>The Reader</h4><p>Racket&rsquo;s reader is a recursive-descent parser that can be configured
+through a <a href="readtables.html" data-pltdoc="x">readtable</a> and various other
+<a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameters</span></a>. This section describes the reader&rsquo;s parsing when
+using the default readtable.</p><p>Reading from a stream produces one <a name="(tech._datum)"></a><span style="font-style: italic">datum</span>. If the result
+datum is a compound value, then reading the datum typically requires
+the reader to call itself recursively to read the component data.</p><p>The reader can be invoked in either of two modes: <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> mode,
+or <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode. In <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode, the result
+is always a <a href="syntax-model.html#%28tech._syntax._object%29" data-pltdoc="x">syntax object</a> that includes
+source-location and (initially empty) lexical information wrapped
+around the sort of datum that <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> mode would produce. In the
+case of <a href="pairs.html#%28tech._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">pairs</span></a>, <a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vectors</span></a>, and <a href="boxes.html#%28tech._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">box</span></a>es, the content is also
+wrapped recursively as a syntax object. Unless specified otherwise,
+this section describes the reader&rsquo;s behavior in <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> mode,
+and <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode does the same modulo wrapping of the final
+result.</p><p>Reading is defined in terms of Unicode characters; see
+<a href="ports.html" data-pltdoc="x">Ports</a> for information on how a byte stream is converted
+to a character stream.</p><p>Symbols, keywords, strings, byte strings, regexps, characters, and
+numbers produced by the reader in <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode are
+<a name="(tech._interned)"></a><span style="font-style: italic">interned</span>, which means that such values in the result of
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> are always <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> when they are
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> (whether from the same call or different calls to
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>). Symbols and keywords are interned in
+both <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> and <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode. When a quoted value
+is in compiled code that written and then read back in (see
+<a href="printing.html#%28part._print-compiled%29" data-pltdoc="x">Printing Compiled Code</a>), only strings and byte strings are
+interned when reading the code. Sending an
+interned value across a <a href="places.html#%28tech._place._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">place channel</span></a> does not
+necessarily produce an interned value at the receiving
+<a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">place</span></a>. See also <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-intern-literal%29%29" class="RktValLink" data-pltdoc="x">datum-intern-literal</a></span> and
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span>.</p><p>Note that <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> values are only weakly held by the reader&rsquo;s
+internal table, so they may be <a href="eval-model.html#%28tech._garbage._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">garbage
+collected</span></a> if they are no longer otherwise <a href="eval-model.html#%28tech._reachable%29" class="techoutside" data-pltdoc="x"><span class="techinside">reachable</span></a>. This weakness
+can never affect the result of an <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> test, but an interned value may disappear when placed into
+a weak box (see <a href="weakbox.html" data-pltdoc="x">Weak Boxes</a>), used as the key in a weak <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash
+table</span></a> (see <a href="hashtables.html" data-pltdoc="x">Hash Tables</a>), or used as an ephemeron key (see
+<a href="ephemerons.html" data-pltdoc="x">Ephemerons</a>).</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;default-readtable-dispatch&quot;">1.3.1<tt>&nbsp;</tt><a name="(part._default-readtable-dispatch)"></a>Delimiters and Dispatch</h5><p>Along with <a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-whitespace~3f%29%29" data-pltdoc="x">whitespace</a> and a BOM
+character, the following characters are <a name="(tech._delimiter)"></a><span style="font-style: italic">delimiters</span>:</p><p><span class="hspace">&nbsp;&nbsp;</span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span>
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span>
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">"</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">,</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">`</span><span class="hspace"></span></span>
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">;</span><span class="hspace"></span></span></p><p>A delimited sequence that starts with any other character is typically
+parsed as either a symbol, number, or <a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonum</span></a>, but a few non-delimiter
+characters play special roles:</p><ul><li><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> has a special meaning as an initial character in a
+delimited sequence; its meaning depends on the characters that
+follow; see below.</p></li><li><p><a name="(idx._(gentag._3._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span> starts a subsequence of characters to
+be included verbatim in the delimited sequence (i.e., they are
+never treated as delimiters, and they are not case-folded when
+case-insensitivity is enabled); the subsequence is terminated
+by another <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span>, and neither the initial nor
+terminating <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span> is part of the subsequence.</p></li><li><p><a name="(idx._(gentag._4._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> outside of a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span> pair causes
+the following character to be included verbatim in a delimited
+sequence.</p></li></ul><p>More precisely, after skipping whitespace and <span class="RktVal">#\uFEFF</span> BOM
+characters, the reader dispatches based on the next character or
+characters in the input stream as follows:</p><p><table cellspacing="0" cellpadding="0"><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="pairs.html#%28tech._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">pair</span></a> or <a href="pairs.html#%28tech._list%29" class="techoutside" data-pltdoc="x"><span class="techinside">list</span></a>; see <a href="reader.html#%28part._parse-pair%29" data-pltdoc="x">Reading Pairs and Lists</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="pairs.html#%28tech._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">pair</span></a> or <a href="pairs.html#%28tech._list%29" class="techoutside" data-pltdoc="x"><span class="techinside">list</span></a>; see <a href="reader.html#%28part._parse-pair%29" data-pltdoc="x">Reading Pairs and Lists</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="pairs.html#%28tech._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">pair</span></a> or <a href="pairs.html#%28tech._list%29" class="techoutside" data-pltdoc="x"><span class="techinside">list</span></a>; see <a href="reader.html#%28part._parse-pair%29" data-pltdoc="x">Reading Pairs and Lists</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>matches <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span> or raises <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>matches <span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span> or raises <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>matches <span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span> or raises <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">"</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="strings.html#%28tech._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">string</span></a>; see <a href="reader.html#%28part._parse-string%29" data-pltdoc="x">Reading Strings</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a quote; see <a href="reader.html#%28part._parse-quote%29" data-pltdoc="x">Reading Quotes</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">`</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a quasiquote; see <a href="reader.html#%28part._parse-quote%29" data-pltdoc="x">Reading Quotes</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">,</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a [splicing] unquote; see <a href="reader.html#%28part._parse-quote%29" data-pltdoc="x">Reading Quotes</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">;</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a line comment; see <a href="reader.html#%28part._parse-comment%29" data-pltdoc="x">Reading Comments</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#t</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#T</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>true; see <a href="reader.html#%28part._parse-boolean%29" data-pltdoc="x">Reading Booleans</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#f</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#F</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>false; see <a href="reader.html#%28part._parse-boolean%29" data-pltdoc="x">Reading Booleans</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#(</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vector</span></a>; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#[</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vector</span></a>; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#{</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vector</span></a>; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fl(</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#Fl(</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a>; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fl[</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#Fl[</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a>; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fl{</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#Fl{</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a>; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fx(</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#Fx(</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a>; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fx[</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#Fx[</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a>; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fx{</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#Fx{</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a>; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#s(</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="structures.html#%28tech._structure%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure</span></a> literal; see <a href="reader.html#%28part._parse-structure%29" data-pltdoc="x">Reading Structures</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#s[</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="structures.html#%28tech._structure%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure</span></a> literal; see <a href="reader.html#%28part._parse-structure%29" data-pltdoc="x">Reading Structures</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#s{</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="structures.html#%28tech._structure%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure</span></a> literal; see <a href="reader.html#%28part._parse-structure%29" data-pltdoc="x">Reading Structures</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="characters.html#%28tech._character%29" class="techoutside" data-pltdoc="x"><span class="techinside">character</span></a>; see <a href="reader.html#%28part._parse-character%29" data-pltdoc="x">Reading Characters</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#"</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte string</span></a>; see <a href="reader.html#%28part._parse-string%29" data-pltdoc="x">Reading Strings</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#%</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="symbols.html#%28tech._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">symbol</span></a>; see <a href="reader.html#%28part._parse-symbol%29" data-pltdoc="x">Reading Symbols</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#:</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="keywords.html#%28tech._keyword%29" class="techoutside" data-pltdoc="x"><span class="techinside">keyword</span></a>; see <a href="reader.html#%28part._parse-keyword%29" data-pltdoc="x">Reading Keywords</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&amp;</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="boxes.html#%28tech._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">box</span></a>; see <a href="reader.html#%28part._parse-box%29" data-pltdoc="x">Reading Boxes</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#|</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a block comment; see <a href="reader.html#%28part._parse-comment%29" data-pltdoc="x">Reading Comments</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#;</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts an S-expression comment; see <a href="reader.html#%28part._parse-comment%29" data-pltdoc="x">Reading Comments</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#'</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a syntax quote; see <a href="reader.html#%28part._parse-quote%29" data-pltdoc="x">Reading Quotes</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!</span><span class="hspace">&nbsp;</span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a line comment; see <a href="reader.html#%28part._parse-comment%29" data-pltdoc="x">Reading Comments</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!/</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a line comment; see <a href="reader.html#%28part._parse-comment%29" data-pltdoc="x">Reading Comments</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>may start a reader extension; see <a href="reader.html#%28part._parse-reader%29" data-pltdoc="x">Reading via an Extension</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#`</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a syntax quasiquote; see <a href="reader.html#%28part._parse-quote%29" data-pltdoc="x">Reading Quotes</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#,</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a syntax [splicing] unquote; see <a href="reader.html#%28part._parse-quote%29" data-pltdoc="x">Reading Quotes</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#~</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts compiled code; see <a href="printing.html#%28part._print-compiled%29" data-pltdoc="x">Printing Compiled Code</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#i</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#I</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="numbers.html#%28tech._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">number</span></a>; see <a href="reader.html#%28part._parse-number%29" data-pltdoc="x">Reading Numbers</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#e</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#E</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="numbers.html#%28tech._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">number</span></a>; see <a href="reader.html#%28part._parse-number%29" data-pltdoc="x">Reading Numbers</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#x</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#X</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="numbers.html#%28tech._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">number</span></a> or <a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonum</span></a>; see <a href="reader.html#%28part._parse-number%29" data-pltdoc="x">Reading Numbers</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#o</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#O</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="numbers.html#%28tech._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">number</span></a> or <a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonum</span></a>; see <a href="reader.html#%28part._parse-number%29" data-pltdoc="x">Reading Numbers</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#d</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#D</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="numbers.html#%28tech._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">number</span></a> or <a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonum</span></a>; see <a href="reader.html#%28part._parse-number%29" data-pltdoc="x">Reading Numbers</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#b</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#B</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="numbers.html#%28tech._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">number</span></a> or <a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonum</span></a>; see <a href="reader.html#%28part._parse-number%29" data-pltdoc="x">Reading Numbers</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&lt;&lt;</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="strings.html#%28tech._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">string</span></a>; see <a href="reader.html#%28part._parse-string%29" data-pltdoc="x">Reading Strings</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#rx</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="regexp.html#%28tech._regular._expression%29" class="techoutside" data-pltdoc="x"><span class="techinside">regular expression</span></a>; see <a href="reader.html#%28part._parse-regexp%29" data-pltdoc="x">Reading Regular Expressions</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#px</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="regexp.html#%28tech._regular._expression%29" class="techoutside" data-pltdoc="x"><span class="techinside">regular expression</span></a>; see <a href="reader.html#%28part._parse-regexp%29" data-pltdoc="x">Reading Regular Expressions</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#ci</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#cI</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#Ci</span><span class="hspace"></span></span>,  or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#CI</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>switches case sensitivity; see <a href="reader.html#%28part._parse-symbol%29" data-pltdoc="x">Reading Symbols</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#cs</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#cS</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#Cs</span><span class="hspace"></span></span>,  or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#CS</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>switches case sensitivity; see <a href="reader.html#%28part._parse-symbol%29" data-pltdoc="x">Reading Symbols</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hash</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash table</span></a>; see <a href="reader.html#%28part._parse-hashtable%29" data-pltdoc="x">Reading Hash Tables</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#reader</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a reader extension use; see <a href="reader.html#%28part._parse-reader%29" data-pltdoc="x">Reading via an Extension</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a reader extension use; see <a href="reader.html#%28part._parse-reader%29" data-pltdoc="x">Reading via an Extension</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a vector; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a vector; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a vector; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fl</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a flvector; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fl</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a flvector; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fl</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a flvector; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#Fl</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a flvector; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#Fl</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a flvector; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#Fl</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a flvector; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fx</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a fxvector; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fx</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a fxvector; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fx</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a fxvector; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#Fx</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a fxvector; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#Fx</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a fxvector; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#Fx</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a fxvector; see <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,8}</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">=</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>binds a graph tag; see <a href="reader.html#%28part._parse-graph%29" data-pltdoc="x">Reading Graph Structure</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,8}</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>uses a graph tag; see <a href="reader.html#%28part._parse-graph%29" data-pltdoc="x">Reading Graph Structure</a></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="right"><p><span style="font-style: italic">otherwise</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>starts a <a href="symbols.html#%28tech._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">symbol</span></a>; see <a href="reader.html#%28part._parse-symbol%29" data-pltdoc="x">Reading Symbols</a></p></td></tr></table></p><p class="SHistory">Changed in version 7.8.0.9 of package <span class="stt">base</span>: Changed treatment of the BOM
+character so that it is treated
+like whitespace in the same places
+that comments are allowed.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parse-symbol&quot;">1.3.2<tt>&nbsp;</tt><a name="(part._parse-symbol)"></a>Reading Symbols</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=symbols.html&amp;version=8.6" class="Sq" data-pltdoc="x">Symbols</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces the syntax of symbols.</p></blockquote></blockquote></blockquote><p>A sequence that does not start with a <a href="reader.html#%28tech._delimiter%29" class="techoutside" data-pltdoc="x"><span class="techinside">delimiter</span></a> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> is
+parsed as either a <a href="symbols.html#%28tech._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">symbol</span></a>, a <a href="numbers.html#%28tech._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">number</span></a> (see
+<a href="reader.html#%28part._parse-number%29" data-pltdoc="x">Reading Numbers</a>), or a <a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonum</span></a>
+(see <a href="reader.html#%28part._parse-extflonum%29" data-pltdoc="x">Reading Extflonums</a>),
+except that <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> by itself is never
+parsed as a symbol or number (unless the <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-dot%29%29" class="RktValLink" data-pltdoc="x">read-accept-dot</a></span>
+parameter is set to <span class="RktVal">#f</span>). A successful
+number or extflonum parse takes precedence over a symbol parse.
+A <a name="(idx._(gentag._5._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#%</span><span class="hspace"></span></span> also
+starts a symbol. The resulting symbol is <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a>.
+See the start of <a href="reader.html#%28part._default-readtable-dispatch%29" data-pltdoc="x">Delimiters and Dispatch</a> for information
+about <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> in parsing symbols.</p><p><a name="(idx._(gentag._6._(lib._scribblings/reference/reference..scrbl)))"></a><a name="(idx._(gentag._7._(lib._scribblings/reference/reference..scrbl)))"></a>When the
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-case-sensitive%29%29" class="RktValLink" data-pltdoc="x">read-case-sensitive</a></span> <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> is set to <span class="RktVal">#f</span>,
+characters in the sequence that are not quoted by <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span> or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> are first case-normalized. If the reader encounters
+<a name="(idx._(gentag._8._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#ci</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#CI</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#Ci</span><span class="hspace"></span></span>, or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#cI</span><span class="hspace"></span></span>, then it recursively reads the following datum in
+case-insensitive mode. If the reader encounters
+<a name="(idx._(gentag._9._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#cs</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#CS</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#Cs</span><span class="hspace"></span></span>, or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#cS</span><span class="hspace"></span></span>, then it recursively reads the following datum in
+case-sensitive mode.</p><p><table cellspacing="0" cellpadding="0"><tr><td><p>Examples:</p></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Apple</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">string-&gt;symbol</span><span class="stt"> </span><span class="RktVal">"Apple"</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Ap#ple</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">string-&gt;symbol</span><span class="stt"> </span><span class="RktVal">"Ap#ple"</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Ap ple</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">string-&gt;symbol</span><span class="stt"> </span><span class="RktVal">"Ap"</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Ap| |ple</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">string-&gt;symbol</span><span class="stt"> </span><span class="RktVal">"Ap ple"</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Ap\ ple</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">string-&gt;symbol</span><span class="stt"> </span><span class="RktVal">"Ap ple"</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#ci Apple</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">string-&gt;symbol</span><span class="stt"> </span><span class="RktVal">"apple"</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#ci |A|pple</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">string-&gt;symbol</span><span class="stt"> </span><span class="RktVal">"Apple"</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#ci \Apple</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">string-&gt;symbol</span><span class="stt"> </span><span class="RktVal">"Apple"</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#ci#cs Apple</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">string-&gt;symbol</span><span class="stt"> </span><span class="RktVal">"Apple"</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#%Apple</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">string-&gt;symbol</span><span class="stt"> </span><span class="RktVal">"#%Apple"</span><span class="RktPn">)</span></p></td></tr></table></td></tr></table></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parse-number&quot;">1.3.3<tt>&nbsp;</tt><a name="(part._parse-number)"></a><a name="(idx._(gentag._10._(lib._scribblings/reference/reference..scrbl)))"></a>Reading Numbers</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=numbers.html&amp;version=8.6" class="Sq" data-pltdoc="x">Numbers</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces the syntax of numbers.</p></blockquote></blockquote></blockquote><p>A sequence that does not start with a <a href="reader.html#%28tech._delimiter%29" class="techoutside" data-pltdoc="x"><span class="techinside">delimiter</span></a> is parsed as a <a href="numbers.html#%28tech._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">number</span></a>
+when it matches the following grammar case-insensitively for
+<span class="sroman">&#8249;<span style="font-style: italic">number<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span> (decimal), where <span style="font-style: italic">n</span> is a
+meta-meta-variable in the grammar. The resulting number is <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> in
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode.</p><p>A number is optionally prefixed by an exactness specifier,
+<a name="(idx._(gentag._11._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#e</span><span class="hspace"></span></span> (exact) or <a name="(idx._(gentag._12._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#i</span><span class="hspace"></span></span> (inexact),
+which specifies its parsing as an exact or inexact number; see
+<a href="numbers.html" data-pltdoc="x">Numbers</a> for information on number exactness. As the
+non-terminal names suggest, a number that has no exactness specifier
+and matches only <span class="sroman">&#8249;<span style="font-style: italic">inexact-number<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span> is normally parsed as an
+inexact number, otherwise it is parsed as an exact number. If the
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-decimal-as-inexact%29%29" class="RktValLink" data-pltdoc="x">read-decimal-as-inexact</a></span> <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> is set to <span class="RktVal">#f</span>, then
+all numbers without an exactness specifier are instead parsed as
+exact.</p><p>If the reader encounters <a name="(idx._(gentag._13._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#b</span><span class="hspace"></span></span> (binary),
+<a name="(idx._(gentag._14._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#o</span><span class="hspace"></span></span> (octal), <a name="(idx._(gentag._15._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#d</span><span class="hspace"></span></span> (decimal), or
+<a name="(idx._(gentag._16._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#x</span><span class="hspace"></span></span> (hexadecimal), it must be followed by a
+sequence that is terminated by a <a href="reader.html#%28tech._delimiter%29" class="techoutside" data-pltdoc="x"><span class="techinside">delimiter</span></a> or end-of-file, and that
+is either an <a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonum</span></a> (see <a href="reader.html#%28part._parse-extflonum%29" data-pltdoc="x">Reading Extflonums</a>) or
+matches the <span class="sroman">&#8249;<span style="font-style: italic">general-number<span style="vertical-align: sub; font-size: 80%">2</span></span>&#8250;</span>,
+<span class="sroman">&#8249;<span style="font-style: italic">general-number<span style="vertical-align: sub; font-size: 80%">8</span></span>&#8250;</span>, <span class="sroman">&#8249;<span style="font-style: italic">general-number<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span>, or
+<span class="sroman">&#8249;<span style="font-style: italic">general-number<span style="vertical-align: sub; font-size: 80%">16</span></span>&#8250;</span> grammar, respectively.</p><p>A <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#e</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#i</span><span class="hspace"></span></span> followed immediately by <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#b</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#o</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#d</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#x</span><span class="hspace"></span></span> is treated the same as the
+reverse order: <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#b</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#o</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#d</span><span class="hspace"></span></span>, or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#x</span><span class="hspace"></span></span> followed by <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#e</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#i</span><span class="hspace"></span></span>.</p><p>An <span class="sroman">&#8249;<span style="font-style: italic">exponent-mark<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span> in an inexact number serves both to specify
+an exponent and to specify a numerical precision. If
+<a href="numbers.html#%28tech._single._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">single-flonums</span></a> are supported (see <a href="numbers.html" data-pltdoc="x">Numbers</a>) and the
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-single-flonum%29%29" class="RktValLink" data-pltdoc="x">read-single-flonum</a></span> <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> is set to <span class="RktVal">#t</span>,
+the marks <span class="RktInBG"><span class="hspace"></span><span class="RktIn">f</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">s</span><span class="hspace"></span></span> specify single-flonums. If
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-single-flonum%29%29" class="RktValLink" data-pltdoc="x">read-single-flonum</a></span> is set to <span class="RktVal">#f</span>, or with any other
+mark, a double-precision <a href="numbers.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonum</span></a> is produced. If single-flonums
+are not supported and <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-single-flonum%29%29" class="RktValLink" data-pltdoc="x">read-single-flonum</a></span> is set to
+<span class="RktVal">#t</span>, then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aunsupported%29%29" class="RktValLink" data-pltdoc="x">exn:fail:unsupported</a></span> exception is raised when a single-flonum
+would otherwise be produced. Special infinity and not-a-number flonums
+and single-flonums are distinct; specials with the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.0</span><span class="hspace"></span></span>
+suffix, like <span class="RktVal">+nan.0</span>, are double-precision flonums, while
+specials with the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.f</span><span class="hspace"></span></span> suffix, like <span class="RktVal">+nan.0</span>,
+are single-flonums if enabled though <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-single-flonum%29%29" class="RktValLink" data-pltdoc="x">read-single-flonum</a></span>.</p><p>A <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> in an <span class="sroman">&#8249;<span style="font-style: italic">inexact<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span> number is the same as
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">0</span><span class="hspace"></span></span>, but <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> can be used to suggest
+that the digit&rsquo;s actual value is unknown.</p><p>All letters in a number representation are parsed case-insensitively,
+independent of the <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-case-sensitive%29%29" class="RktValLink" data-pltdoc="x">read-case-sensitive</a></span> parameter. For
+example, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#I#D+InF.F+3I</span><span class="hspace"></span></span> is parsed the same as
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#i#d+inf.f+3i</span><span class="hspace"></span></span>. In the grammar below, each literal lowercase
+letter stands for both itself and its uppercase form.</p><p><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">number<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">exact<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="sroman">&#8249;<span style="font-style: italic">inexact<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">exact<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">exact-rational<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="sroman">&#8249;<span style="font-style: italic">exact-complex<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">exact-rational<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">[</span><span class="sroman">&#8249;<span style="font-style: italic">sign</span>&#8250;</span><span class="sroman">]</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">unsigned-rational<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">unsigned-rational<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">unsigned-integer<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">unsigned-integer<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">unsigned-integer<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">exact-integer<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">[</span><span class="sroman">&#8249;<span style="font-style: italic">sign</span>&#8250;</span><span class="sroman">]</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">unsigned-integer<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">unsigned-integer<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">exact-complex<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">exact-rational<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">sign</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">unsigned-rational<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">i</span><span class="hspace"></span></span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">inexact<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">inexact-real<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="sroman">&#8249;<span style="font-style: italic">inexact-complex<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">inexact-real<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">[</span><span class="sroman">&#8249;<span style="font-style: italic">sign</span>&#8250;</span><span class="sroman">]</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">inexact-normal<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">sign</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">inexact-special<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">inexact-unsigned<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">inexact-normal<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="sroman">&#8249;<span style="font-style: italic">inexact-special<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">inexact-normal<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">inexact-simple<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span><span class="hspace">&nbsp;</span><span class="sroman">[</span><span class="sroman">&#8249;<span style="font-style: italic">exp-mark<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span> <span class="sroman">&#8249;<span style="font-style: italic">exact-integer<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span><span class="sroman">]</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">inexact-simple<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">digits#<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span><span class="hspace">&nbsp;</span><span class="sroman">[</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span><span class="sroman">]</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">*</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">[</span><span class="sroman">&#8249;<span style="font-style: italic">unsigned-integer<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span><span class="sroman">]</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">digits#<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">digits#<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">digits#<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">inexact-special<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">inf.0</span><span class="hspace"></span></span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">nan.0</span><span class="hspace"></span></span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">inf.f</span><span class="hspace"></span></span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">nan.f</span><span class="hspace"></span></span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">digits#<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">*</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">inexact-complex<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">[</span><span class="sroman">&#8249;<span style="font-style: italic">inexact-real<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span><span class="sroman">]</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">sign</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">inexact-unsigned<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">i</span><span class="hspace"></span></span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">inexact-real<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">@</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">inexact-real<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">sign</span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">16</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">b</span><span class="hspace"></span></span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">c</span><span class="hspace"></span></span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">d</span><span class="hspace"></span></span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">e</span><span class="hspace"></span></span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">f</span><span class="hspace"></span></span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">8</span></span>&#8250;</span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">8</span><span class="hspace"></span></span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">9</span><span class="hspace"></span></span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">8</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">2</span></span>&#8250;</span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">2</span><span class="hspace"></span></span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">3</span><span class="hspace"></span></span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">4</span><span class="hspace"></span></span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">5</span><span class="hspace"></span></span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">6</span><span class="hspace"></span></span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">7</span><span class="hspace"></span></span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">2</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">0</span><span class="hspace"></span></span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">1</span><span class="hspace"></span></span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">exp-mark<span style="vertical-align: sub; font-size: 80%">16</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">s</span><span class="hspace"></span></span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">l</span><span class="hspace"></span></span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">exp-mark<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">exp-mark<span style="vertical-align: sub; font-size: 80%">16</span></span>&#8250;</span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">d</span><span class="hspace"></span></span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">e</span><span class="hspace"></span></span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">f</span><span class="hspace"></span></span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">exp-mark<span style="vertical-align: sub; font-size: 80%">8</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">exp-mark<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">exp-mark<span style="vertical-align: sub; font-size: 80%">2</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">exp-mark<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">general-number<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">[</span><span class="sroman">&#8249;<span style="font-style: italic">exactness</span>&#8250;</span><span class="sroman">]</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">number<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">exactness</span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#e</span><span class="hspace"></span></span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#i</span><span class="hspace"></span></span></p></td></tr></table></p><p><table cellspacing="0" cellpadding="0"><tr><td><p>Examples:</p></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">-1</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktVal"><span class="nobreak">-1</span></span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">1/2</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">/</span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">1.0</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">exact-&gt;inexact</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">1+2i</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">make-rectangular</span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">1/2+3/4i</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">make-rectangular</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">/</span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">/</span><span class="stt"> </span><span class="RktVal">3</span><span class="stt"> </span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">1.0+3.0e7i</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">exact-&gt;inexact</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">make-rectangular</span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">30000000</span><span class="RktPn">)</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">2e5</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">exact-&gt;inexact</span><span class="stt"> </span><span class="RktVal">200000</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#i5</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">exact-&gt;inexact</span><span class="stt"> </span><span class="RktVal">5</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#e2e5</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktVal">200000</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#x2e5</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktVal">741</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#b101</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktVal">5</span></p></td></tr></table></td></tr></table></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parse-extflonum&quot;">1.3.4<tt>&nbsp;</tt><a name="(part._parse-extflonum)"></a>Reading Extflonums</h5><p>An <a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonum</span></a> has the same syntax as an <span class="sroman">&#8249;<span style="font-style: italic">inexact-real<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span>
+that includes an <span class="sroman">&#8249;<span style="font-style: italic">exp-mark<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span>, but with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">t</span><span class="hspace"></span></span> or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">T</span><span class="hspace"></span></span> in place of the <span class="sroman">&#8249;<span style="font-style: italic">exp-mark<span style="vertical-align: sub; font-size: 80%">n</span></span>&#8250;</span>. In addition,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">+inf.t</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-inf.t</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+nan.t</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-nan.t</span><span class="hspace"></span></span>
+are <a href="extflonums.html#%28tech._extflonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflonums</span></a>. A <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#b</span><span class="hspace"></span></span>
+(binary), <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#o</span><span class="hspace"></span></span> (octal), <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#d</span><span class="hspace"></span></span> (decimal), or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#x</span><span class="hspace"></span></span> (hexadecimal) radix specification can prefix an
+extflonum, but <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#i</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#e</span><span class="hspace"></span></span> cannot, and a
+extflonum cannot be used to form a <a href="numbers.html#%28tech._complex._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">complex number</span></a>.  The
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-decimal-as-inexact%29%29" class="RktValLink" data-pltdoc="x">read-decimal-as-inexact</a></span> <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> has no effect on
+extflonum reading.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parse-boolean&quot;">1.3.5<tt>&nbsp;</tt><a name="(part._parse-boolean)"></a>Reading Booleans</h5><p>A <a name="(idx._(gentag._17._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#true</span><span class="hspace"></span></span>, <a name="(idx._(gentag._18._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#t</span><span class="hspace"></span></span>,
+<a name="(idx._(gentag._19._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#T</span><span class="hspace"></span></span> followed by a <a href="reader.html#%28tech._delimiter%29" class="techoutside" data-pltdoc="x"><span class="techinside">delimiter</span></a> is the input syntax
+for the <a href="booleans.html#%28tech._boolean%29" class="techoutside" data-pltdoc="x"><span class="techinside">boolean</span></a> constant &ldquo;true,&rdquo; and <a name="(idx._(gentag._20._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#false</span><span class="hspace"></span></span>,
+<a name="(idx._(gentag._21._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#f</span><span class="hspace"></span></span>, or <a name="(idx._(gentag._22._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#F</span><span class="hspace"></span></span> followed by a
+<a href="reader.html#%28tech._delimiter%29" class="techoutside" data-pltdoc="x"><span class="techinside">delimiter</span></a> is the complete input syntax for the <a href="booleans.html#%28tech._boolean%29" class="techoutside" data-pltdoc="x"><span class="techinside">boolean</span></a> constant
+&ldquo;false.&rdquo;</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parse-pair&quot;">1.3.6<tt>&nbsp;</tt><a name="(part._parse-pair)"></a>Reading Pairs and Lists</h5><p>When the reader encounters a <a name="(idx._(gentag._23._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span>,
+<a name="(idx._(gentag._24._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span>, or <a name="(idx._(gentag._25._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span>, it starts
+parsing a <a href="pairs.html#%28tech._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">pair</span></a> or <a href="pairs.html#%28tech._list%29" class="techoutside" data-pltdoc="x"><span class="techinside">list</span></a>; see <a href="pairs.html" data-pltdoc="x">Pairs and Lists</a> for information on pairs
+and lists.</p><p>To parse the pair or list, the reader recursively reads data
+until a matching <a name="(idx._(gentag._26._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>, <a name="(idx._(gentag._27._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span>, or
+<a name="(idx._(gentag._28._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span> (respectively) is found, and it specially handles
+a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> surrounded by <a href="reader.html#%28tech._delimiter%29" class="techoutside" data-pltdoc="x"><span class="techinside">delimiters</span></a>.  Pairs <span class="RktInBG"><span class="hspace"></span><span class="RktIn">()</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">[]</span><span class="hspace"></span></span>, and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">{}</span><span class="hspace"></span></span> are treated the same way, so the remainder of this
+section simply uses &ldquo;parentheses&rdquo; to mean any of these pair.</p><p>If the reader finds no delimited <a name="(idx._(gentag._29._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> among the elements
+between parentheses, then it produces a list containing the results of
+the recursive reads.</p><p>If the reader finds two data between the matching parentheses
+that are separated by a delimited <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>, then it creates a
+pair. More generally, if it finds two or more data where the
+last datum is preceded by a delimited <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>, then it constructs
+nested pairs: the next-to-last element is paired with the last, then
+the third-to-last datum is paired with that pair, and so on.</p><p>If the reader finds three or more data between the matching
+parentheses, and if a pair of delimited <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>s surrounds any
+other than the first and last elements, the result is a list
+containing the element surrounded by <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>s as the first
+element, followed by the others in the read order. This convention
+supports a kind of <a name="(idx._(gentag._30._(lib._scribblings/reference/reference..scrbl)))"></a>infix notation at the reader level.</p><p>In <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode, the recursive reads for the pair/list
+elements are themselves in <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode, so that the
+result is a list or pair of syntax objects that is itself wrapped as a
+syntax object. If the reader constructs nested pairs because the input
+included a single delimited <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>, then only the innermost pair
+and outermost pair are wrapped as syntax objects.</p><p>Whether wrapping a pair or list, if the pair or list was formed with
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span>, then a <a name="(idx._(gentag._31._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">paren-shape</span>
+property is attached to the result with the value <span class="RktVal">#\[</span>. If the
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-square-bracket-with-tag%29%29" class="RktValLink" data-pltdoc="x">read-square-bracket-with-tag</a></span> <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> is set to
+<span class="RktVal">#t</span>, then the resulting pair or list is wrapped by the
+equivalent of <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="stt"> </span><a name="(idx._(gentag._32._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">#%brackets</span><span class="stt"> </span><span class="RktVar">pair-or-list</span><span class="RktPn">)</span>.</p><p>Similarly, if the list or pair was formed with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span> and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span>, then a <span class="RktVal">'</span><span class="RktVal">paren-shape</span> property is attached to
+the result with the value <span class="RktVal">#\{</span>.  If the
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-curly-brace-with-tag%29%29" class="RktValLink" data-pltdoc="x">read-curly-brace-with-tag</a></span> <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> is set to
+<span class="RktVal">#t</span>, then the resulting pair or list is wrapped by the
+equivalent of <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="stt"> </span><a name="(idx._(gentag._33._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">#%braces</span><span class="stt"> </span><span class="RktVar">pair-or-list</span><span class="RktPn">)</span>.</p><p>If a delimited <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> appears in any other configuration, then
+the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span> exception is raised. Similarly, if the reader encounters a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span> that does not end a list
+being parsed, then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span> exception is raised.</p><p><table cellspacing="0" cellpadding="0"><tr><td><p>Examples:</p></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">()</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">list</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(1 2 3)</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">list</span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="stt"> </span><span class="RktVal">3</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">{1 2 3}</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">list</span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="stt"> </span><span class="RktVal">3</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[1 2 3]</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">list</span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="stt"> </span><span class="RktVal">3</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(1 (2) 3)</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">list</span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">list</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">3</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(1 . 3)</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">cons</span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">3</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(1 . (3))</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">list</span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">3</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(1 . 2 . 3)</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">list</span><span class="stt"> </span><span class="RktVal">2</span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">3</span><span class="RktPn">)</span></p></td></tr></table></td></tr></table></p><p>If the <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-square-bracket-as-paren%29%29" class="RktValLink" data-pltdoc="x">read-square-bracket-as-paren</a></span> and
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-square-bracket-with-tag%29%29" class="RktValLink" data-pltdoc="x">read-square-bracket-with-tag</a></span> <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a>s are set to
+<span class="RktVal">#f</span>, then when the reader encounters <span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span> and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span>, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span> exception is raised. Similarly, if the
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-curly-brace-as-paren%29%29" class="RktValLink" data-pltdoc="x">read-curly-brace-as-paren</a></span> and
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-curly-brace-with-tag%29%29" class="RktValLink" data-pltdoc="x">read-curly-brace-with-tag</a></span> <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a>s are set to
+<span class="RktVal">#f</span>, then when the reader encounters <span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span> and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span>, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span> exception is raised.</p><p>If the <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-dot%29%29" class="RktValLink" data-pltdoc="x">read-accept-dot</a></span> <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> is set to
+<span class="RktVal">#f</span>, then a delimited <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> triggers an
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span> exception. If the
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-infix-dot%29%29" class="RktValLink" data-pltdoc="x">read-accept-infix-dot</a></span> <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> is set to <span class="RktVal">#f</span>,
+then multiple delimited <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>s trigger an <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span>
+exception, instead of the infix conversion.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parse-string&quot;">1.3.7<tt>&nbsp;</tt><a name="(part._parse-string)"></a><a name="(idx._(gentag._34._(lib._scribblings/reference/reference..scrbl)))"></a><a name="(idx._(gentag._35._(lib._scribblings/reference/reference..scrbl)))"></a><a name="(idx._(gentag._36._(lib._scribblings/reference/reference..scrbl)))"></a>Reading Strings</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=strings.html&amp;version=8.6" class="Sq" data-pltdoc="x">Strings (Unicode)</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces the syntax of strings.</p></blockquote></blockquote></blockquote><p>When the reader encounters <a name="(idx._(gentag._37._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">"</span><span class="hspace"></span></span>, it begins parsing
+characters to form a <a href="strings.html#%28tech._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">string</span></a>. The string continues until it is
+terminated by another <span class="RktInBG"><span class="hspace"></span><span class="RktIn">"</span><span class="hspace"></span></span> (that is not escaped by
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>). The resulting string is <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> in
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode.</p><p>Within a string sequence, the following escape sequences are
+ recognized:</p><ul><li><p><a name="(idx._(gentag._38._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\a</span><span class="hspace"></span></span>: alarm (ASCII 7)</p></li><li><p><a name="(idx._(gentag._39._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\b</span><span class="hspace"></span></span>: backspace (ASCII 8)</p></li><li><p><a name="(idx._(gentag._40._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\t</span><span class="hspace"></span></span>: tab (ASCII 9)</p></li><li><p><a name="(idx._(gentag._41._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\n</span><span class="hspace"></span></span>: linefeed (ASCII 10)</p></li><li><p><a name="(idx._(gentag._42._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\v</span><span class="hspace"></span></span>: vertical tab (ASCII 11)</p></li><li><p><a name="(idx._(gentag._43._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\f</span><span class="hspace"></span></span>: formfeed (ASCII 12)</p></li><li><p><a name="(idx._(gentag._44._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\r</span><span class="hspace"></span></span>: return (ASCII 13)</p></li><li><p><a name="(idx._(gentag._45._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\e</span><span class="hspace"></span></span>: escape (ASCII 27)</p></li><li><p><a name="(idx._(gentag._46._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\"</span><span class="hspace"></span></span>: double-quotes (without terminating the string)</p></li><li><p><a name="(idx._(gentag._47._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\'</span><span class="hspace"></span></span>: quote (i.e., the backslash has no effect)</p></li><li><p><a name="(idx._(gentag._48._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\</span><span class="hspace"></span></span>: backslash (i.e., the second is not an escaping backslash)</p></li><li><p><a name="(idx._(gentag._49._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">8</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,3}</span></span>:
+Unicode for the octal number specified by digit<span style="vertical-align: sub; font-size: 80%">8</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,3}</span></span> (i.e., 1 to 3 <span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">8</span></span>&#8250;</span>s), where
+each <span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">8</span></span>&#8250;</span> is <span class="RktInBG"><span class="hspace"></span><span class="RktIn">0</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">1</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">2</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">3</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">4</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">5</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">6</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">7</span><span class="hspace"></span></span>. A longer form takes precedence
+over a shorter form, and the resulting octal number must be
+between 0 and 255 decimal, otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span> exception is raised.</p></li><li><p><a name="(idx._(gentag._50._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\x</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">16</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,2}</span></span>: Unicode for the hexadecimal
+number specified by <span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">16</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,2}</span></span>,
+where each <span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">16</span></span>&#8250;</span> is <span class="RktInBG"><span class="hspace"></span><span class="RktIn">0</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">1</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">2</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">3</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">4</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">5</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">6</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">7</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">8</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">9</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">b</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">c</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">d</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">e</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">f</span><span class="hspace"></span></span> (case-insensitive). The longer form
+takes precedence over the shorter form.</p></li><li><p><a name="(idx._(gentag._51._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\u</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">16</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,4}</span></span>: like <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\x</span><span class="hspace"></span></span>, but with up to
+four hexadecimal digits (longer sequences take precedence).
+The resulting hexadecimal number must be a valid argument to
+<span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._integer-~3echar%29%29" class="RktValLink" data-pltdoc="x">integer-&gt;char</a></span>, otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span> exception is raised&#8212;<wbr></wbr>unless the encoding continues with
+another <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\u</span><span class="hspace"></span></span> to form a surrogate-style encoding.</p></li><li><p><a name="(idx._(gentag._52._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\u</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">16</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{4,4}</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\u</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">16</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{4,4}</span></span>: like <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\u</span><span class="hspace"></span></span>, but for two
+hexadecimal numbers, where the first is in the range
+<span class="RktVal">#xD800</span><span class="RktMeta"></span> to <span class="RktVal">#xDBFF</span><span class="RktMeta"></span> and the second is in the
+range <span class="RktVal">#xDC00</span><span class="RktMeta"></span> to <span class="RktVal">#xDFFF</span><span class="RktMeta"></span>; the resulting
+character is the one represented by the numbers as a UTF-16
+surrogate pair.</p></li><li><p><a name="(idx._(gentag._53._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\U</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">16</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,8}</span></span>: like <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\x</span><span class="hspace"></span></span>, but with up
+to eight hexadecimal digits (longer sequences take precedence).
+The resulting hexadecimal number must be a valid argument to
+<span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._integer-~3echar%29%29" class="RktValLink" data-pltdoc="x">integer-&gt;char</a></span>, otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span> exception is raised.</p></li><li><p><a name="(idx._(gentag._54._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">newline</span>&#8250;</span>: elided, where
+<span class="sroman">&#8249;<span style="font-style: italic">newline</span>&#8250;</span> is either a linefeed, carriage return, or
+carriage return&ndash;linefeed combination. This convention allows
+single-line strings to span multiple lines in the source.</p></li></ul><p>If the reader encounters any other use of a backslash in a string
+constant, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span> exception is raised.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=bytestrings.html&amp;version=8.6" class="Sq" data-pltdoc="x">Bytes and Byte Strings</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces the syntax of byte strings.</p></blockquote></blockquote></blockquote><p>A string constant preceded by <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> is parsed as a
+<a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte string</span></a>. (That is, <a name="(idx._(gentag._55._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#"</span><span class="hspace"></span></span> starts a byte-string
+literal.) See <a href="bytestrings.html" data-pltdoc="x">Byte Strings</a> for information on byte
+strings. The resulting byte string is <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> in
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode.
+Byte-string constants support the same escape sequences as
+character strings, except <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\u</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\U</span><span class="hspace"></span></span>. Otherwise, each
+character within the byte-string quotes must have a Unicode code-point number
+in the range 0 to 255, which is used as the corresponding byte&rsquo;s value; if
+a character is not in that range, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span> exception is raised.</p><p>When the reader encounters <a name="(idx._(gentag._56._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&lt;&lt;</span><span class="hspace"></span></span>, it starts parsing a
+<a name="(idx._(gentag._57._(lib._scribblings/reference/reference..scrbl)))"></a><span style="font-style: italic">here string</span>. The characters following <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&lt;&lt;</span><span class="hspace"></span></span> until
+a newline character define a terminator for the string. The content of
+the string includes all characters between the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&lt;&lt;</span><span class="hspace"></span></span> line and
+a line whose only content is the specified terminator. More precisely,
+the content of the string starts after a newline following
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&lt;&lt;</span><span class="hspace"></span></span>, and it ends before a newline that is followed by the
+terminator, where the terminator is itself followed by either a
+newline or end-of-file. No escape sequences are recognized between the
+starting and terminating lines; all characters are included in the
+string (and terminator) literally. A return character is not treated
+as a line separator in this context. If no characters appear between
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&lt;&lt;</span><span class="hspace"></span></span> and a newline or end-of-file, or if an end-of-file is
+encountered before a terminating line, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span> exception is raised.</p><p><table cellspacing="0" cellpadding="0"><tr><td><p>Examples:</p></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">"Apple"</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktVal"><span class="stt">"Apple"</span></span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">"\x41pple"</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktVal"><span class="stt">"Apple"</span></span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">"\"Apple\""</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktVal"><span class="stt">"\x22Apple\x22"</span></span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">"\\"</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktVal"><span class="stt">"\x5C"</span></span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#"Apple"</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">bytes</span><span class="stt"> </span><span class="RktVal">65</span><span class="stt"> </span><span class="RktVal">112</span><span class="stt"> </span><span class="RktVal">112</span><span class="stt"> </span><span class="RktVal">108</span><span class="stt"> </span><span class="RktVal">101</span><span class="RktPn">)</span></p></td></tr></table></td></tr></table></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parse-quote&quot;">1.3.8<tt>&nbsp;</tt><a name="(part._parse-quote)"></a>Reading Quotes</h5><p>When the reader encounters <a name="(idx._(gentag._58._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span>, it recursively
+reads one datum and forms a new list containing the <a href="symbols.html#%28tech._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">symbol</span></a>
+<span class="RktVal">'</span><span class="RktVal">quote</span> and the following datum. This convention is mainly
+useful for reading Racket code, where <span class="RktVal">'</span><span class="RktVal">s</span> can be used as a
+shorthand for <span class="RktPn">(</span><span class="RktSym">quote</span><span class="stt"> </span><span class="RktVal">s</span><span class="RktPn">)</span>.</p><p>Several other sequences are recognized and transformed in a similar
+way. Longer prefixes take precedence over short ones:</p><p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span></p></td><td><p><span class="hspace">&nbsp;</span>adds<span class="hspace">&nbsp;</span></p></td><td><p><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><a name="(idx._(gentag._59._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">`</span><span class="hspace"></span></span></p></td><td><p><span class="hspace">&nbsp;</span>adds<span class="hspace">&nbsp;</span></p></td><td><p><span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><a name="(idx._(gentag._60._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">,</span><span class="hspace"></span></span></p></td><td><p><span class="hspace">&nbsp;</span>adds<span class="hspace">&nbsp;</span></p></td><td><p><span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote%29%29" class="RktStxLink" data-pltdoc="x">unquote</a></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><a name="(idx._(gentag._61._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">,@</span><span class="hspace"></span></span></p></td><td><p><span class="hspace">&nbsp;</span>adds<span class="hspace">&nbsp;</span></p></td><td><p><span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxLink" data-pltdoc="x">unquote-splicing</a></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><a name="(idx._(gentag._62._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#'</span><span class="hspace"></span></span></p></td><td><p><span class="hspace">&nbsp;</span>adds<span class="hspace">&nbsp;</span></p></td><td><p><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%29%29" class="RktStxLink" data-pltdoc="x">syntax</a></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><a name="(idx._(gentag._63._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#`</span><span class="hspace"></span></span></p></td><td><p><span class="hspace">&nbsp;</span>adds<span class="hspace">&nbsp;</span></p></td><td><p><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._quasisyntax%29%29" class="RktStxLink" data-pltdoc="x">quasisyntax</a></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><a name="(idx._(gentag._64._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#,</span><span class="hspace"></span></span></p></td><td><p><span class="hspace">&nbsp;</span>adds<span class="hspace">&nbsp;</span></p></td><td><p><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._unsyntax%29%29" class="RktStxLink" data-pltdoc="x">unsyntax</a></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;</span></p></td><td><p><a name="(idx._(gentag._65._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#,@</span><span class="hspace"></span></span></p></td><td><p><span class="hspace">&nbsp;</span>adds<span class="hspace">&nbsp;</span></p></td><td><p><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._unsyntax-splicing%29%29" class="RktStxLink" data-pltdoc="x">unsyntax-splicing</a></span></p></td></tr></table></p><p><table cellspacing="0" cellpadding="0"><tr><td><p>Examples:</p></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">'apple</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">list</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">quote</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">apple</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">`(1 ,2)</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">list</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">quasiquote</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">list</span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">list</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">unquote</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></p></td></tr></table></td></tr></table></p><p>The <span class="RktInBG"><span class="hspace"></span><span class="RktIn">`</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">,</span><span class="hspace"></span></span>, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">,@</span><span class="hspace"></span></span> forms are disabled when
+the <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-quasiquote%29%29" class="RktValLink" data-pltdoc="x">read-accept-quasiquote</a></span> <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> is set to
+<span class="RktVal">#f</span>, in which case the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span> exception is raised instead.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parse-comment&quot;">1.3.9<tt>&nbsp;</tt><a name="(part._parse-comment)"></a>Reading Comments</h5><p>A <a name="(idx._(gentag._66._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">;</span><span class="hspace"></span></span> starts a line comment. When the reader
+encounters <span class="RktInBG"><span class="hspace"></span><span class="RktIn">;</span><span class="hspace"></span></span>, it skips past all characters until the
+next linefeed (ASCII 10), carriage return (ASCII 13), next-line
+(Unicode <span class="RktVal">133</span>), line-separator (Unicode <span class="RktVal">8232</span>),
+or paragraph-separator (Unicode <span class="RktVal">8233</span>) character.</p><p>A <a name="(idx._(gentag._67._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#|</span><span class="hspace"></span></span> starts a nestable block comment.  When the
+reader encounters <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#|</span><span class="hspace"></span></span>, it skips past all characters
+until a closing <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|#</span><span class="hspace"></span></span>. Pairs of matching <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#|</span><span class="hspace"></span></span> and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">|#</span><span class="hspace"></span></span> can be nested.</p><p>A <a name="(idx._(gentag._68._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#;</span><span class="hspace"></span></span> starts an S-expression comment. When the
+reader encounters <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#;</span><span class="hspace"></span></span>, it recursively reads one datum, and
+then discards it (continuing on to the next datum for the read
+result).</p><p>A <a name="(idx._(gentag._69._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!</span><span class="hspace">&nbsp;</span></span> (which is <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!</span><span class="hspace"></span></span> followed by a space)
+or <a name="(idx._(gentag._70._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!/</span><span class="hspace"></span></span> starts a line comment that can be
+continued to the next line by ending a line with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>. This
+form of comment normally appears at the beginning of a Unix script
+file.</p><p><table cellspacing="0" cellpadding="0"><tr><td><p>Examples:</p></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">; comment</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span style="font-style: italic">nothing</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#| a |# 1</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktVal">1</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#| #| a |# 1 |# 2</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktVal">2</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#;1 2</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktVal">2</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!/bin/sh</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span style="font-style: italic">nothing</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#! /bin/sh</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span style="font-style: italic">nothing</span></p></td></tr></table></td></tr></table></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parse-vector&quot;">1.3.10<tt>&nbsp;</tt><a name="(part._parse-vector)"></a>Reading Vectors</h5><p>When the reader encounters a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#(</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#[</span><span class="hspace"></span></span>, or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#{</span><span class="hspace"></span></span>, it starts parsing a <a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vector</span></a>; see <a href="vectors.html" data-pltdoc="x">Vectors</a> for
+information on vectors. A <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fl</span><span class="hspace"></span></span> in place of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span>
+starts an <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a>, but is not allowed in <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode;
+see <a href="flonums.html#%28part._flvectors%29" data-pltdoc="x">Flonum Vectors</a> for information on flvectors.
+A <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fx</span><span class="hspace"></span></span> in place of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span>
+starts an <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a>, but is not allowed in <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode;
+see <a href="fixnums.html#%28part._fxvectors%29" data-pltdoc="x">Fixnum Vectors</a> for information on fxvectors.
+The <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#[</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#{</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fl[</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fl{</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fx[</span><span class="hspace"></span></span>, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fx{</span><span class="hspace"></span></span> forms can be disabled through
+the <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-square-bracket-as-paren%29%29" class="RktValLink" data-pltdoc="x">read-square-bracket-as-paren</a></span> and
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-curly-brace-as-paren%29%29" class="RktValLink" data-pltdoc="x">read-curly-brace-as-paren</a></span> <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameters</span></a>.</p><p>The elements of the vector are recursively read until a matching
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span> is found, just as for
+lists (see <a href="reader.html#%28part._parse-pair%29" data-pltdoc="x">Reading Pairs and Lists</a>). A delimited <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> is not
+allowed among the vector elements. In the case of <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvectors</span></a>,
+the recursive read for element is implicitly prefixed with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#i</span><span class="hspace"></span></span>
+and must produce a <a href="numbers.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonum</span></a>. In the case of <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvectors</span></a>,
+the recursive read for element is implicitly prefixed with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#e</span><span class="hspace"></span></span>
+and must produce a <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a>.</p><p>An optional vector length can be specified between <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fl</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#fx</span><span class="hspace"></span></span>  and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span>. The size is specified
+using a sequence of decimal digits, and the number of elements
+provided for the vector must be no more than the specified size. If
+fewer elements are provided, the last provided element is used for the
+remaining vector slots; if no elements are provided, then <span class="RktVal">0</span>
+is used for all slots.</p><p>In <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode, each recursive read for vector
+elements is also in <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode, so that the wrapped
+vector&rsquo;s elements are also wrapped as syntax objects, and the vector is
+immutable.</p><p><table cellspacing="0" cellpadding="0"><tr><td><p>Examples:</p></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#(1 apple 3)</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">vector</span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">apple</span><span class="stt"> </span><span class="RktVal">3</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#3("apple" "banana")</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">vector</span><span class="stt"> </span><span class="RktVal">"apple"</span><span class="stt"> </span><span class="RktVal">"banana"</span><span class="stt"> </span><span class="RktVal">"banana"</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#3()</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">vector</span><span class="stt"> </span><span class="RktVal">0</span><span class="stt"> </span><span class="RktVal">0</span><span class="stt"> </span><span class="RktVal">0</span><span class="RktPn">)</span></p></td></tr></table></td></tr></table></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parse-structure&quot;">1.3.11<tt>&nbsp;</tt><a name="(part._parse-structure)"></a>Reading Structures</h5><p>When the reader encounters a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#s(</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#s[</span><span class="hspace"></span></span>, or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#s{</span><span class="hspace"></span></span>, it starts parsing an instance of a <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a>
+<a href="structures.html#%28tech._structure._type%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type</span></a>; see <a href="structures.html" data-pltdoc="x">Structures</a> for information on
+<a href="structures.html#%28tech._structure._type%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure types</span></a>.  The <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#s[</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#s{</span><span class="hspace"></span></span> forms
+can be disabled through the <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-square-bracket-as-paren%29%29" class="RktValLink" data-pltdoc="x">read-square-bracket-as-paren</a></span> and
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-curly-brace-as-paren%29%29" class="RktValLink" data-pltdoc="x">read-curly-brace-as-paren</a></span> <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameters</span></a>.</p><p>The elements of the structure are recursively read until a matching
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span> is found, just as for lists
+(see <a href="reader.html#%28part._parse-pair%29" data-pltdoc="x">Reading Pairs and Lists</a>). A single delimited <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> is not
+allowed among the elements, but two <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>s can be used as in a
+list for an infix conversion.</p><p>The first element is used as the structure descriptor, and it must
+have the form (when quoted) of a possible argument to
+<span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._make-prefab-struct%29%29" class="RktValLink" data-pltdoc="x">make-prefab-struct</a></span>; in the simplest case, it can be a
+symbol. The remaining elements correspond to field values within the
+structure.</p><p>In <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode, the structure type must not have any
+mutable fields. The structure&rsquo;s elements are read in
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode, so that the wrapped structure&rsquo;s elements
+are also wrapped as syntax objects.</p><p>If the first structure element is not a valid <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure
+type key, or if the number of provided fields is inconsistent with the
+indicated <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure type, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span> exception is raised.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parse-hashtable&quot;">1.3.12<tt>&nbsp;</tt><a name="(part._parse-hashtable)"></a>Reading Hash Tables</h5><p>A <a name="(idx._(gentag._71._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hash</span><span class="hspace"></span></span> starts an immutable <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash-table</span></a> constant
+with key matching based on <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>. The characters after
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">hash</span><span class="hspace"></span></span> must parse as a list of pairs (see
+<a href="reader.html#%28part._parse-pair%29" data-pltdoc="x">Reading Pairs and Lists</a>) with a specific use of delimited <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>:
+it must appear between the elements of each pair in the list and
+nowhere in the sequence of list elements. The first element of each
+pair is used as the key for a table entry, and the second element of
+each pair is the associated value.</p><p>A <a name="(idx._(gentag._72._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hashalw</span><span class="hspace"></span></span> starts a hash table like
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hash</span><span class="hspace"></span></span>, except that it constructs a hash table based on
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span> instead of <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>.</p><p>A <a name="(idx._(gentag._73._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hasheq</span><span class="hspace"></span></span> starts a hash table like
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hash</span><span class="hspace"></span></span>, except that it constructs a hash table based on
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> instead of <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>.</p><p>A <a name="(idx._(gentag._74._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hasheqv</span><span class="hspace"></span></span> starts a hash table like
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hash</span><span class="hspace"></span></span>, except that it constructs a hash table based on
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span> instead of <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>.</p><p>In all cases, the table is constructed by adding each mapping to the
+ hash table from left to right, so later mappings can hide earlier
+ mappings if the keys are equivalent.</p><p><table cellspacing="0" cellpadding="0"><tr><td><p>Examples, where <span class="RktSym">make-...</span> stands for <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-immutable-hash%29%29" class="RktValLink" data-pltdoc="x">make-immutable-hash</a></span>:</p></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hash()</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">make-...</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hasheq()</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">make-...eq</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hash(("a" . 5))</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">make-...</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">"a"</span><span class="stt"> </span><span class="RktVal">. </span><span class="RktVal">5</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hasheq((a . 5) (b . 7))</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">make-...eq</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="stt"> </span><span class="RktVal">. </span><span class="RktVal">7</span><span class="RktVal">)</span><span class="stt"> </span><span class="RktVal">(</span><span class="RktVal">a</span><span class="stt"> </span><span class="RktVal">. </span><span class="RktVal">5</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hasheq((a . 5) (a . 7))</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">make-...eq</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="stt"> </span><span class="RktVal">. </span><span class="RktVal">7</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></p></td></tr></table></td></tr></table></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parse-box&quot;">1.3.13<tt>&nbsp;</tt><a name="(part._parse-box)"></a>Reading Boxes</h5><p>When the reader encounters a <a name="(idx._(gentag._75._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&amp;</span><span class="hspace"></span></span>, it starts
+parsing a <a href="boxes.html#%28tech._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">box</span></a>; see <a href="boxes.html" data-pltdoc="x">Boxes</a> for information on boxes. The
+content of the box is determined by recursively reading the next
+datum.</p><p>In <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode, the recursive read for the box content
+is also in <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode, so that the wrapped box&rsquo;s
+content is also wrapped as a syntax object, and the box is immutable.</p><p><table cellspacing="0" cellpadding="0"><tr><td><p>Examples:</p></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&amp;17</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">box</span><span class="stt"> </span><span class="RktVal">17</span><span class="RktPn">)</span></p></td></tr></table></td></tr></table></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parse-character&quot;">1.3.14<tt>&nbsp;</tt><a name="(part._parse-character)"></a>Reading Characters</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=characters.html&amp;version=8.6" class="Sq" data-pltdoc="x">Characters</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces the syntax of characters.</p></blockquote></blockquote></blockquote><p>A <a name="(idx._(gentag._76._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\</span><span class="hspace"></span></span> starts a <a href="characters.html#%28tech._character%29" class="techoutside" data-pltdoc="x"><span class="techinside">character</span></a> constant, which has
+one of the following forms:</p><ul><li><p><a name="(idx._(gentag._77._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\nul</span><span class="hspace"></span></span> or <a name="(idx._(gentag._78._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\null</span><span class="hspace"></span></span>: NUL (ASCII 0); the next character must not be <a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-alphabetic~3f%29%29" data-pltdoc="x">alphabetic</a>.</p></li><li><p><a name="(idx._(gentag._79._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\backspace</span><span class="hspace"></span></span>: backspace  (ASCII 8); the next character must not be <a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-alphabetic~3f%29%29" data-pltdoc="x">alphabetic</a>.</p></li><li><p><a name="(idx._(gentag._80._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\tab</span><span class="hspace"></span></span>: tab (ASCII 9); the next character must not be <a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-alphabetic~3f%29%29" data-pltdoc="x">alphabetic</a>.</p></li><li><p><a name="(idx._(gentag._81._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\newline</span><span class="hspace"></span></span> or <a name="(idx._(gentag._82._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\linefeed</span><span class="hspace"></span></span>: linefeed (ASCII 10); the next character must not be <a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-alphabetic~3f%29%29" data-pltdoc="x">alphabetic</a>.</p></li><li><p><a name="(idx._(gentag._83._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\vtab</span><span class="hspace"></span></span>: vertical tab (ASCII 11); the next character must not be <a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-alphabetic~3f%29%29" data-pltdoc="x">alphabetic</a>.</p></li><li><p><a name="(idx._(gentag._84._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\page</span><span class="hspace"></span></span>: page break (ASCII 12); the next character must not be <a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-alphabetic~3f%29%29" data-pltdoc="x">alphabetic</a>.</p></li><li><p><a name="(idx._(gentag._85._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\return</span><span class="hspace"></span></span>: carriage return (ASCII 13); the next character must not be <a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-alphabetic~3f%29%29" data-pltdoc="x">alphabetic</a>.</p></li><li><p><a name="(idx._(gentag._86._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\space</span><span class="hspace"></span></span>: space (ASCII 32); the next character must not be <a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-alphabetic~3f%29%29" data-pltdoc="x">alphabetic</a>.</p></li><li><p><a name="(idx._(gentag._87._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\rubout</span><span class="hspace"></span></span>: delete (ASCII 127); the next character must not be <a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-alphabetic~3f%29%29" data-pltdoc="x">alphabetic</a>.</p></li><li><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">8</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{3,3}</span></span>:
+Unicode for the octal number specified by three octal digits&#8212;<wbr></wbr>as in string escapes (see
+<a href="reader.html#%28part._parse-string%29" data-pltdoc="x">Reading Strings</a>), but constrained to exactly three digits.</p></li><li><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\u</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">16</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,4}</span></span>:
+Unicode for the hexadecimal number specified by <span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">16</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,4}</span></span>, as in string escapes (see
+<a href="reader.html#%28part._parse-string%29" data-pltdoc="x">Reading Strings</a>).</p></li><li><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\U</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">16</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,8}</span></span>:
+like <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\u</span><span class="hspace"></span></span>, but with up to eight hexadecimal digits (although
+only six digits are actually useful).</p></li><li><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">c</span>&#8250;</span>: the character <span class="sroman">&#8249;<span style="font-style: italic">c</span>&#8250;</span>, as long
+as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">c</span>&#8250;</span> and the characters following it
+do not match any of the previous cases, as long as
+<span class="sroman">&#8249;<span style="font-style: italic">c</span>&#8250;</span> or the
+character after <span class="sroman">&#8249;<span style="font-style: italic">c</span>&#8250;</span> is not
+<a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-alphabetic~3f%29%29" data-pltdoc="x">alphabetic</a>, and as long as
+<span class="sroman">&#8249;<span style="font-style: italic">c</span>&#8250;</span> is not an octal digit or is not followed by an
+octal digit (i.e., two octal digits commit to a third).</p></li></ul><p><table cellspacing="0" cellpadding="0"><tr><td><p>Examples:</p></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\newline</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">integer-&gt;char</span><span class="stt"> </span><span class="RktVal">10</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\n</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">integer-&gt;char</span><span class="stt"> </span><span class="RktVal">110</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\u3BB</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">integer-&gt;char</span><span class="stt"> </span><span class="RktVal">955</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\&#955;</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">integer-&gt;char</span><span class="stt"> </span><span class="RktVal">955</span><span class="RktPn">)</span></p></td></tr></table></td></tr></table></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parse-keyword&quot;">1.3.15<tt>&nbsp;</tt><a name="(part._parse-keyword)"></a>Reading Keywords</h5><p>A <a name="(idx._(gentag._88._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#:</span><span class="hspace"></span></span> starts a <a href="keywords.html#%28tech._keyword%29" class="techoutside" data-pltdoc="x"><span class="techinside">keyword</span></a>. The parsing of a keyword
+after the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#:</span><span class="hspace"></span></span> is the same as for a symbol, including
+case-folding in case-insensitive mode, except that the part after
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#:</span><span class="hspace"></span></span> is never parsed as a number. The resulting keyword is
+<a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a>.</p><p><table cellspacing="0" cellpadding="0"><tr><td><p>Examples:</p></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#:Apple</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">string-&gt;keyword</span><span class="stt"> </span><span class="RktVal">"Apple"</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#:1</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">string-&gt;keyword</span><span class="stt"> </span><span class="RktVal">"1"</span><span class="RktPn">)</span></p></td></tr></table></td></tr></table></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parse-regexp&quot;">1.3.16<tt>&nbsp;</tt><a name="(part._parse-regexp)"></a>Reading Regular Expressions</h5><p>A <a name="(idx._(gentag._89._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#rx</span><span class="hspace"></span></span> or <a name="(idx._(gentag._90._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#px</span><span class="hspace"></span></span> starts a
+<a href="regexp.html#%28tech._regular._expression%29" class="techoutside" data-pltdoc="x"><span class="techinside">regular expression</span></a>. The characters immediately after <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#rx</span><span class="hspace"></span></span> or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#px</span><span class="hspace"></span></span> must parse as a string or byte string (see
+<a href="reader.html#%28part._parse-string%29" data-pltdoc="x">Reading Strings</a>). A <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#rx</span><span class="hspace"></span></span> prefix starts a regular
+expression as would be constructed by <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="RktValLink" data-pltdoc="x">regexp</a></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#px</span><span class="hspace"></span></span>
+as constructed by <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._pregexp%29%29" class="RktValLink" data-pltdoc="x">pregexp</a></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#rx#</span><span class="hspace"></span></span> as constructed by
+<span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp%29%29" class="RktValLink" data-pltdoc="x">byte-regexp</a></span>, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#px#</span><span class="hspace"></span></span> as constructed by
+<span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-pregexp%29%29" class="RktValLink" data-pltdoc="x">byte-pregexp</a></span>. The resulting regular expression is <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> in
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode.</p><p><table cellspacing="0" cellpadding="0"><tr><td><p>Examples:</p></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#rx".*"</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">regexp</span><span class="stt"> </span><span class="RktVal">".*"</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#px"[\\s]*"</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">pregexp</span><span class="stt"> </span><span class="RktVal">"[\\s]*"</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#rx#".*"</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">byte-regexp</span><span class="stt"> </span><span class="RktVal">#".*"</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#px#"[\\s]*"</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">byte-pregexp</span><span class="stt"> </span><span class="RktVal">#"[\\s]*"</span><span class="RktPn">)</span></p></td></tr></table></td></tr></table></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parse-graph&quot;">1.3.17<tt>&nbsp;</tt><a name="(part._parse-graph)"></a><a name="(idx._(gentag._91._(lib._scribblings/reference/reference..scrbl)))"></a><a name="(idx._(gentag._92._(lib._scribblings/reference/reference..scrbl)))"></a>Reading Graph Structure</h5><p>A <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,8}</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">=</span><span class="hspace"></span></span> tags the following datum for reference via
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,8}</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span>, which allows the reader to produce a datum that
+has graph structure.</p><p>In <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> mode, for a specific <span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,8}</span></span> in a single read
+result, each <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,8}</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> reference is replaced by the datum read for
+the corresponding <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,8}</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">=</span><span class="hspace"></span></span>; the definition <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,8}</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">=</span><span class="hspace"></span></span> also
+produces just the datum after it. A <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,8}</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">=</span><span class="hspace"></span></span> definition can appear
+at most once, and a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,8}</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">=</span><span class="hspace"></span></span> definition must appear before a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,8}</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> reference appears, otherwise the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span> exception is raised.
+If the <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-graph%29%29" class="RktValLink" data-pltdoc="x">read-accept-graph</a></span> parameter is set to <span class="RktVal">#f</span>, then
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,8}</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">=</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,8}</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> triggers a <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span>
+exception.</p><p>In <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode, graph structure is parsed the same way
+as in <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> mode. However, since <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax objects</span></a> made
+from plain S-expressions may not contain cycles, each <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,8}</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">=</span><span class="hspace"></span></span>
+definition and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,8}</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> reference is replaced with a
+<a href="pairs.html#%28tech._placeholder%29" class="techoutside" data-pltdoc="x"><span class="techinside">placeholder</span></a> in the result that contains the referenced value.
+Since such syntax objects are not directly useful (they cannot be
+marshaled to compiled code and are therefore rejected by the default
+<a href="eval.html#%28tech._compilation._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compilation handler</span></a>), parsing of graph structure in
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode is controlled by the separate
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax-accept-graph%29%29" class="RktValLink" data-pltdoc="x">read-syntax-accept-graph</a></span> parameter, which is initially set
+to <span class="RktVal">#f</span>.</p><p>Although a comment parsed via <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#;</span><span class="hspace"></span></span> discards the datum
+afterward, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">digit<span style="vertical-align: sub; font-size: 80%">10</span></span>&#8250;</span><span class="sroman"><span style="vertical-align: super; font-size: 80%">{1,8}</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">=</span><span class="hspace"></span></span> definitions in the discarded datum
+still can be referenced by other parts of the reader input, as long as
+both the comment and the reference are grouped together by some other
+form (i.e., some recursive read); a top-level <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#;</span><span class="hspace"></span></span> comment
+neither defines nor uses graph tags for other top-level forms.</p><p><table cellspacing="0" cellpadding="0"><tr><td><p>Examples:</p></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(#1=100 #1# #1#)</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="RktPn">(</span><span class="RktSym">list</span><span class="stt"> </span><span class="RktVal">100</span><span class="stt"> </span><span class="RktVal">100</span><span class="stt"> </span><span class="RktVal">100</span><span class="RktPn">)</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#0=(1 . #0#)</span><span class="hspace"></span></span></p></td><td valign="baseline"><p><span class="hspace">&nbsp;</span>reads equal to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A%29%29" class="RktStxLink" data-pltdoc="x">let*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ph</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-placeholder%29%29" class="RktValLink" data-pltdoc="x">make-placeholder</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">ph</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._placeholder-set%21%29%29" class="RktValLink" data-pltdoc="x">placeholder-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ph</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._make-reader-graph%29%29" class="RktValLink" data-pltdoc="x">make-reader-graph</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></p><p class="SHistory">Changed in version 8.4.0.8 of package <span class="stt">base</span>: Added support for reading graph structure
+in <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode if enabled by
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax-accept-graph%29%29" class="RktValLink" data-pltdoc="x">read-syntax-accept-graph</a></span>.</p><table cellspacing="0" cellpadding="0"><tr><td></td></tr></table><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parse-reader&quot;">1.3.18<tt>&nbsp;</tt><a name="(part._parse-reader)"></a>Reading via an Extension</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=hash-reader.html&amp;version=8.6" class="Sq" data-pltdoc="x">Reader Extensions</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces reader extension.</p></blockquote></blockquote></blockquote><p>When the reader encounters <a name="(idx._(gentag._93._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#reader</span><span class="hspace"></span></span>, it loads
+an external reader procedure and applies it to the current input
+stream.</p><p>The reader recursively reads the next datum after <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#reader</span><span class="hspace"></span></span>,
+and passes it to the procedure that is the value of the
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-reader-guard%29%29" class="RktValLink" data-pltdoc="x">current-reader-guard</a></span> <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a>; the result is used as a
+module path. The module path is passed to <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span>
+with either <span class="RktVal">'</span><span class="RktVal">read</span> or <span class="RktVal">'</span><span class="RktVal">read-syntax</span> (depending on
+whether the reader is in <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> or <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>
+mode) while holding the registry lock via
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-call-with-registry-lock%29%29" class="RktValLink" data-pltdoc="x">namespace-call-with-registry-lock</a></span>.
+The module is loaded in a <a href="Namespaces.html#%28tech._root._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">root namespace</span></a> of the
+<a href="syntax-model.html#%28tech._current._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">current namespace</span></a>.</p><p>The arity of the resulting procedure determines whether it accepts
+extra source-location information: a <span class="RktSym">read</span> procedure
+accepts either one argument (an input port) or five, and a
+<span class="RktSym">read-syntax</span> procedure accepts either two arguments (a
+name value and an input port) or six. In either case, the four
+optional arguments are the reader&rsquo;s module path (as a syntax object in
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode) followed by the line (positive exact
+integer or <span class="RktVal">#f</span>), column (non-negative exact integer or
+<span class="RktVal">#f</span>), and position (positive exact integer or <span class="RktVal">#f</span>) of
+the start of the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#reader</span><span class="hspace"></span></span> form. The input port is the one
+whose stream contained <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#reader</span><span class="hspace"></span></span>, where the stream position is
+immediately after the recursively read module path.</p><p>The procedure should produce a datum result.  If the result is a
+syntax object in <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> mode, then it is converted to a datum
+using <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span>; if the result is not a syntax object in
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode, then it is converted to one using
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span>. See also <a href="reader-procs.html" data-pltdoc="x">Reader-Extension Procedures</a> for
+information on the procedure&rsquo;s results.</p><p>If the <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-reader%29%29" class="RktValLink" data-pltdoc="x">read-accept-reader</a></span> <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> is set to
+<span class="RktVal">#f</span>, then if the reader encounters <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#reader</span><span class="hspace"></span></span>, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span> exception is raised.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="Sq" data-pltdoc="x">The <span class="RktMod">#lang</span> Shorthand</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces <span class="RktMod">#lang</span>.</p></blockquote></blockquote></blockquote><p>The <a name="(idx._(gentag._94._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span> reader form is similar to
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#reader</span><span class="hspace"></span></span>, but more constrained: the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span> must be
+followed by a single space (ASCII 32), and then a non-empty sequence
+of alphanumeric ASCII, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">_</span><span class="hspace"></span></span>, and/or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> characters terminated by
+<a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-whitespace~3f%29%29" data-pltdoc="x">whitespace</a> or an end-of-file.  The
+sequence must not start or end with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>. A sequence
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace">&nbsp;</span></span><span class="sroman">&#8249;<span style="font-style: italic">name</span>&#8250;</span> is equivalent to either
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#reader (submod</span><span class="hspace">&nbsp;</span></span><span class="sroman">&#8249;<span style="font-style: italic">name</span>&#8250;</span><span class="RktInBG"><span class="hspace">&nbsp;</span><span class="RktIn">reader)</span><span class="hspace"></span></span> or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#reader</span><span class="hspace">&nbsp;</span></span><span class="sroman">&#8249;<span style="font-style: italic">name</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">/lang/reader</span><span class="hspace"></span></span>, where the
+former is tried first guarded by a <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-declared~3f%29%29" class="RktValLink" data-pltdoc="x">module-declared?</a></span>
+check (but after filtering by
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-reader-guard%29%29" class="RktValLink" data-pltdoc="x">current-reader-guard</a></span>, so both are passed to the
+value of <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-reader-guard%29%29" class="RktValLink" data-pltdoc="x">current-reader-guard</a></span> if the latter is used). Note
+that the terminating whitespace (if any) is not consumed before the
+external reading procedure is called.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=hash-languages.html&amp;version=8.6" class="Sq" data-pltdoc="x">Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces the creation languages for <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a>.</p></blockquote></blockquote></blockquote><p>Finally, <a name="(idx._(gentag._95._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!</span><span class="hspace"></span></span> is an alias for <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span>
+followed by a space when <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!</span><span class="hspace"></span></span> is followed by alphanumeric
+ASCII, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">_</span><span class="hspace"></span></span>. Use of this alias
+is discouraged except as needed to construct programs that conform to
+certain grammars, such as that of R<span style="vertical-align: super; font-size: 80%">6</span>RS
+[<a href="doc-bibliography.html#%28cite._.Sperber07%29" data-pltdoc="x">Sperber07</a>].</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=reader-helpers.html%23%2528mod-path._syntax%252Fmodule-reader%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">syntax/module-reader</span></a> library provides a
+domain-specific language for writing language readers.</p></blockquote></blockquote></blockquote><p>By convention, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span> normally appears at the beginning of a
+file, possibly after comment forms, to specify the syntax of a module.</p><p>If the <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-reader%29%29" class="RktValLink" data-pltdoc="x">read-accept-reader</a></span> or <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-accept-lang%29%29" class="RktValLink" data-pltdoc="x">read-accept-lang</a></span>
+<a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> is set to <span class="RktVal">#f</span>, then if the reader encounters
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span> or equivalent <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!</span><span class="hspace"></span></span>, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aread%29%29" class="RktValLink" data-pltdoc="x">exn:fail:read</a></span> exception is raised.</p><p class="SHistory">Changed in version 8.2.0.2 of package <span class="stt">base</span>: Changed reader-module loading for <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#reader</span><span class="hspace"></span></span>
+and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span> to hold the current namespace
+registry&rsquo;s lock.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parse-cdot&quot;">1.3.19<tt>&nbsp;</tt><a name="(part._parse-cdot)"></a>Reading with C-style Infix-Dot Notation</h5><p>When the <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-cdot%29%29" class="RktValLink" data-pltdoc="x">read-cdot</a></span> <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> is set to <span class="RktVal">#t</span>,
+then a variety of changes occur in the reader.</p><p>First, symbols can no longer include the character <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>, unless
+the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> is quoted with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>.</p><p>Second, numbers can no longer include the character <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>,
+unless the number is prefixed with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#e</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#i</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#b</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#o</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#d</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#x</span><span class="hspace"></span></span>, or an
+equivalent prefix as discussed in <a href="reader.html#%28part._parse-number%29" data-pltdoc="x">Reading Numbers</a>. If these
+numbers are followed by a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> intended to be read as a C-style
+infix dot, then a <a href="reader.html#%28tech._delimiter%29" class="techoutside" data-pltdoc="x"><span class="techinside">delimiter</span></a> must precede the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>.</p><p>Finally, after reading any datum <span class="RktVar">x</span>, the reader will consume
+whitespace, BOM characters, and comments to look for zero or more sequences of a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> followed by another datum <span class="RktVar">y</span>. It will then group
+<span class="RktVar">x</span> and <span class="RktVar">y</span> with <a name="(idx._(gentag._96._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">#%dot</span> so that
+<span class="RktVar">x.y</span> reads equal to reading <span class="RktPn">(</span><span class="RktSym">#%dot</span><span class="stt"> </span><span class="RktVar">x</span><span class="stt"> </span><span class="RktVar">y</span><span class="RktPn">)</span>.</p><p>If <span class="RktVar">x.y</span> has another <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> after it, the reader will
+accumulate more <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>-separated datums, grouping them from
+left-to-right. For example, <span class="RktVar">x.y.z</span> reads equal to reading
+<span class="RktPn">(</span><span class="RktSym">#%dot</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">#%dot</span><span class="stt"> </span><span class="RktVar">x</span><span class="stt"> </span><span class="RktVar">y</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">z</span><span class="RktPn">)</span>.</p><p>In <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode, the <span class="RktVal">'</span><span class="RktVal">#%dot</span> symbol has the
+source location information of the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> character and the
+entire list has the source location information spanning from the
+start of <span class="RktVar">x</span> to the end of <span class="RktVar">y</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;S-Expression_Reader_Language&quot;">1.3.19.1<tt>&nbsp;</tt><a name="(part._.S-.Expression_.Reader_.Language)"></a><a name="(mod-path._s-exp)"></a>S-Expression Reader Language</h5><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="reader.html#%28mod-path._s-exp%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">s-exp</span></a></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=module-languages.html%23%2528part._s-exp%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">s-exp</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces the <a href="reader.html#%28mod-path._s-exp%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">s-exp</span></a> meta-language.</p></blockquote></blockquote></blockquote><p>The <span class="RktSym">s-exp</span> &ldquo;language&rdquo; is a kind of meta-language. It
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>s the S-expression that follows <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang s-exp</span><span class="hspace"></span></span> and
+uses it as the language of a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> form. It also reads all
+remaining S-expressions until an end-of-file, using them for the body
+of the generated <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>.</p><p>That is,</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="reader.html#%28mod-path._s-exp%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">s-exp</span></a><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span></td></tr><tr><td><span class="RktVar">form</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span></td></tr></table></blockquote><p>is equivalent to</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktVar">name-id</span><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr></table></blockquote><p>where <span class="RktVar">name-id</span> is derived from the source input port&rsquo;s name:
+if the port name is a filename path, the filename without its
+directory path and extension is used for <span class="RktVar">name-id</span>, otherwise
+<span class="RktVar">name-id</span> is <span class="RktSym">anonymous-module</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Chaining_Reader_Language&quot;">1.3.19.2<tt>&nbsp;</tt><a name="(part._.Chaining_.Reader_.Language)"></a><a name="(mod-path._reader)"></a>Chaining Reader Language</h5><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="reader.html#%28mod-path._reader%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">reader</span></a></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=hash-lang_reader.html&amp;version=8.6" class="Sq" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">reader</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces the <a href="reader.html#%28mod-path._reader%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">reader</span></a> meta-language.</p></blockquote></blockquote></blockquote><p>The <span class="RktSym">reader</span> &ldquo;language&rdquo; is a kind of meta-language. It
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>s the S-expression that follows <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang reader</span><span class="hspace"></span></span>
+and uses it as a module path (relative to the module being read) that
+effectively takes the place of <a href="reader.html#%28mod-path._reader%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">reader</span></a>. In other words,
+the <a href="reader.html#%28mod-path._reader%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">reader</span></a> meta-language generalizes the syntax of the
+module specified after <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a> to be a module path, and without
+the implicit addition of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/lang/reader</span><span class="hspace"></span></span> to the path.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="syntax-model.html" title="backward to &quot;1.2 Syntax Model&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="model.html" title="up to &quot;1 Language Model&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="printing.html" title="forward to &quot;1.4 The Printer&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/readtables.html b/clones/docs.racket-lang.org/reference/readtables.html
new file mode 100644
index 00000000..545a6114
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/readtables.html
@@ -0,0 +1,97 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.7.1&nbsp;Readtables</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewselflink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.7.1&nbsp;</td><td><a href="readtables.html" class="tocviewselflink" data-pltdoc="x">Readtables</a></td></tr><tr><td align="right">13.7.2&nbsp;</td><td><a href="reader-procs.html" class="tocviewlink" data-pltdoc="x">Reader-<wbr></wbr>Extension Procedures</a></td></tr><tr><td align="right">13.7.3&nbsp;</td><td><a href="special-comments.html" class="tocviewlink" data-pltdoc="x">Special Comments</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._readtable~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">readtable?</span></span></a></td></tr><tr><td><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._make-readtable%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>readtable</span></span></a></td></tr><tr><td><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._readtable-mapping%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">readtable-<wbr></wbr>mapping</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Reader_Extension.html" title="backward to &quot;13.7 Reader Extension&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Reader_Extension.html" title="up to &quot;13.7 Reader Extension&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="reader-procs.html" title="forward to &quot;13.7.2 Reader-Extension Procedures&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;readtables&quot;">13.7.1<tt>&nbsp;</tt><a name="(part._readtables)"></a>Readtables</h5><p>The dispatch table in <a href="reader.html#%28part._default-readtable-dispatch%29" data-pltdoc="x">Delimiters and Dispatch</a>
+corresponds to the default <a name="(tech._readtable)"></a><span style="font-style: italic">readtable</span>. By creating a new
+readtable and installing it via the <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-readtable%29%29" class="RktValLink" data-pltdoc="x">current-readtable</a></span>
+parameter, the reader&rsquo;s behavior can be extended.</p><p>A readtable is consulted at specific times by the reader:</p><ul><li><p>when looking for the start of a datum;</p></li><li><p>when determining how to parse a datum that starts with
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span>;</p></li><li><p>when looking for a delimiter to terminate a symbol or number;</p></li><li><p>when looking for an opener (such as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span>), closer (such
+as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>), or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> after the first character parsed as
+a sequence for a pair, list, vector, or hash table; or</p></li><li><p>when looking for an opener after <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span> in a
+vector of specified length <span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span>.</p></li></ul><p>The readtable is ignored at other times.  In particular, after parsing
+a character that is mapped to the default behavior of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">;</span><span class="hspace"></span></span>, the
+readtable is ignored until the comment&rsquo;s terminating newline is
+discovered. Similarly, the readtable does not affect string parsing
+until a closing double-quote is found.  Meanwhile, if a character is
+mapped to the default behavior of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span>, then it starts sequence
+that is closed by any character that is mapped to a closing parenthesis
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>. An apparent exception is that the default parsing of
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span> quotes a symbol until a matching character is found, but
+the parser is simply using the character that started the quote; it
+does not consult the readtable.</p><p>For many contexts, <span class="RktVal">#f</span> identifies the default readtable. In
+particular, <span class="RktVal">#f</span> is the initial value for the
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-readtable%29%29" class="RktValLink" data-pltdoc="x">current-readtable</a></span> parameter, which causes the reader to
+behave as described in <a href="reader.html" data-pltdoc="x">The Reader</a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._readtable~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._readtable~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">readtable?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a readtable, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-readtable))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._make-readtable%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-readtable</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">readtable</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">mode</span><span class="hspace">&nbsp;</span><span class="RktVar">action</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._readtable~3f%29%29" class="RktValLink" data-pltdoc="x">readtable?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">readtable</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._readtable~3f%29%29" class="RktValLink" data-pltdoc="x">readtable?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">terminating-macro</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">non-terminating-macro</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dispatch-macro</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">action</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._readtable~3f%29%29" class="RktValLink" data-pltdoc="x">readtable?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new readtable that is like <span class="RktVar">readtable</span> (which can be
+<span class="RktVal">#f</span> to indicate the default readtable),
+except that the reader&rsquo;s behavior is modified for each
+<span class="RktVar">key</span> according to the given <span class="RktVar">mode</span> and
+<span class="RktVar">action</span>. The <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span> for <span class="RktSym"><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._make-readtable%29%29" class="RktValLink" data-pltdoc="x">make-readtable</a></span> applies
+to all three of <span class="RktVar">key</span>, <span class="RktVar">mode</span>, and <span class="RktVar">action</span>; in
+other words, the total number of arguments to <span class="RktSym"><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._make-readtable%29%29" class="RktValLink" data-pltdoc="x">make-readtable</a></span>
+must be <span style="font-style: italic"></span>1<span style="font-style: italic"></span> modulo <span style="font-style: italic"></span>3<span style="font-style: italic"></span>.</div></p><p>The possible combinations for <span class="RktVar">key</span>, <span class="RktVar">mode</span>, and
+<span class="RktVar">action</span> are as follows:</p><ul><li><p><span class="RktVar">char</span><span class="stt"> </span><a name="(idx._(gentag._269._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">terminating-macro</span><span class="stt"> </span><span class="RktVar">proc</span> &#8212;<wbr></wbr> causes
+<span class="RktVar">char</span> to be parsed as a delimiter, and an
+unquoted/uncommented <span class="RktVar">char</span> in the input string triggers a
+call to the <a name="(tech._reader._macro)"></a><span style="font-style: italic">reader macro</span> <span class="RktVar">proc</span>; the activity of
+<span class="RktVar">proc</span> is described further below.  Conceptually, characters
+like <span class="RktInBG"><span class="hspace"></span><span class="RktIn">;</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span>, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span> are mapped to
+terminating reader macros in the default readtable.</p></li><li><p><span class="RktVar">char</span><span class="stt"> </span><a name="(idx._(gentag._270._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">non-terminating-macro</span><span class="stt"> </span><span class="RktVar">proc</span> &#8212;<wbr></wbr> like
+the <span class="RktVal">'</span><span class="RktVal">terminating-macro</span> variant, but <span class="RktVar">char</span> is not
+treated as a delimiter, so it can be used in the middle of an
+identifier or number. Conceptually, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> is mapped to a
+non-terminating macro in the default readtable.</p></li><li><p><span class="RktVar">char</span><span class="stt"> </span><a name="(idx._(gentag._271._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">dispatch-macro</span><span class="stt"> </span><span class="RktVar">proc</span> &#8212;<wbr></wbr> like the
+<span class="RktVal">'</span><span class="RktVal">non-terminating-macro</span> variant, but for <span class="RktVar">char</span> only
+when it follows a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> (or, more precisely, when the character
+follows one that has been mapped to the behavior of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span>
+in the default readtable).</p></li><li><p><span class="RktVar">char</span><span class="stt"> </span><span class="RktVar">like-char</span><span class="stt"> </span><span class="RktVar">readtable</span> &#8212;<wbr></wbr> causes
+<span class="RktVar">char</span> to be parsed in the same way that <span class="RktVar">like-char</span>
+is parsed in <span class="RktVar">readtable</span>, where <span class="RktVar">readtable</span> can be
+<span class="RktVal">#f</span> to indicate the default readtable. (The mapping of
+<span class="RktVar">char</span> does not apply after <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span>, which is configured
+separately via <span class="RktVal">'</span><span class="RktVal">dispatch-macro</span>.) Mapping a character to
+the same actions as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span> in the default reader means that the
+character starts quoting for symbols, and the same character
+terminates the quote; in contrast, mapping a character to the same
+action as a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">"</span><span class="hspace"></span></span> means that the character starts a string, but
+the string is still terminated with a closing <span class="RktInBG"><span class="hspace"></span><span class="RktIn">"</span><span class="hspace"></span></span>. Finally,
+mapping a character to an action in the default readtable means that
+the character&rsquo;s behavior is sensitive to parameters that affect the
+original character; for example, mapping a character to the same
+action as a curly brace <span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span> in the default readtable means
+that the character is disallowed when the
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-curly-brace-as-paren%29%29" class="RktValLink" data-pltdoc="x">read-curly-brace-as-paren</a></span> parameter is set to <span class="RktVal">#f</span>.</p></li><li><p><span class="RktVal">#f</span><span class="stt"> </span><a name="(idx._(gentag._272._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">non-terminating-macro</span><span class="stt"> </span><span class="RktVar">proc</span> &#8212;<wbr></wbr>
+replaces the macro used to parse characters with no specific mapping:
+i.e., the characters (other than <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span>) that can
+start a symbol or number with the default readtable.</p></li></ul><p>If multiple <span class="RktVal">'</span><span class="RktVal">dispatch-macro</span> mappings are provided for a
+single <span class="RktVar">char</span>, all but the last one are ignored. Similarly, if
+multiple non-<span class="RktVal">'</span><span class="RktVal">dispatch-macro</span> mappings are provided for a
+single <span class="RktVar">char</span>, all but the last one are ignored.</p><p>A reader macro <span class="RktVar">proc</span> must accept six arguments, and it can
+optionally accept two arguments. The first two arguments are always
+the character that triggered the reader macro and the input port for
+reading. When the reader macro is triggered by <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>
+(or <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read-syntax/recursive</a></span>), the procedure is passed four
+additional arguments that represent a source location for
+already-consumed character(s): the source name, a line number or
+<span class="RktVal">#f</span>, a column number or <span class="RktVal">#f</span>, and a position or
+<span class="RktVal">#f</span>. When the reader macro is triggered by <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> (or
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read/recursive</a></span>), the procedure is passed only two arguments
+if it accepts two arguments, otherwise it is passed six arguments
+where the third is always <span class="RktVal">#f</span>. See <a href="reader-procs.html" data-pltdoc="x">Reader-Extension Procedures</a>
+for information on the procedure&rsquo;s results.</p><p>A reader macro normally reads characters from the given input port to
+produce a value to be used as the &ldquo;reader macro-expansion&rdquo; of the
+consumed characters. The reader macro might produce a special-comment
+value (see <a href="special-comments.html" data-pltdoc="x">Special Comments</a>) to cause the consumed
+character to be treated as whitespace, and it might use
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read/recursive</a></span> or <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read-syntax/recursive</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._readtable-mapping))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._readtable-mapping%29%29" class="RktValDef RktValLink" data-pltdoc="x">readtable-mapping</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">readtable</span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">terminating-macro</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">non-terminating-macro</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">readtable</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._readtable~3f%29%29" class="RktValLink" data-pltdoc="x">readtable?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces information about the mappings in <span class="RktVar">readtable</span> for
+<span class="RktVar">char</span>. The result is three values:</div></p><ul><li><p>either a character (mapping to the same behavior as the
+character in the default readtable), <span class="RktVal">'</span><span class="RktVal">terminating-macro</span>, or
+<span class="RktVal">'</span><span class="RktVal">non-terminating-macro</span>; this result reports the main (i.e.,
+non-<span class="RktVal">'</span><span class="RktVal">dispatch-macro</span>) mapping for <span class="RktVar">char</span>. When the result
+is a character, then <span class="RktVar">char</span> is mapped to the same behavior as the
+returned character in the default readtable.</p></li><li><p>either <span class="RktVal">#f</span> or a reader-macro procedure; the result is a
+procedure when the first result is <span class="RktVal">'</span><span class="RktVal">terminating-macro</span> or
+<span class="RktVal">'</span><span class="RktVal">non-terminating-macro</span>.</p></li><li><p>either <span class="RktVal">#f</span> or a reader-macro procedure; the result is a
+procedure when the character has a <span class="RktVal">'</span><span class="RktVal">dispatch-macro</span> mapping in
+<span class="RktVar">readtable</span> to override the default dispatch behavior.</p></li></ul><p>Note that reader-macro procedures for the default readtable are not
+directly accessible. To invoke default behaviors, use
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read/recursive</a></span> or <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read-syntax/recursive</a></span> with a
+character and the <span class="RktVal">#f</span> readtable.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Provides </span><span class="RktSym">raise-read-error</span><span class="RktCmt"> and </span><span class="RktSym">raise-read-eof-error</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">syntax/readerr</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">skip-whitespace</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Skips whitespace characters, sensitive to the current</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">readtable</span><span class="RktCmt">'</span><span class="RktCmt">s definition of whitespace</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-char%29%29" class="RktValLink" data-pltdoc="x">peek-char</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._unless%29%29" class="RktStxLink" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Consult current readtable:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">like-ch/sym</span><span class="hspace">&nbsp;</span><span class="RktSym">proc</span><span class="hspace">&nbsp;</span><span class="RktSym">dispatch-proc</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._readtable-mapping%29%29" class="RktValLink" data-pltdoc="x">readtable-mapping</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-readtable%29%29" class="RktValLink" data-pltdoc="x">current-readtable</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">If like-ch/sym is whitespace, then ch is whitespace</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxLink" data-pltdoc="x">when</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">like-ch/sym</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-whitespace~3f%29%29" class="RktValLink" data-pltdoc="x">char-whitespace?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">like-ch/sym</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char%29%29" class="RktValLink" data-pltdoc="x">read-char</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">skip-whitespace</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">skip-comments</span><span class="hspace">&nbsp;</span><span class="RktSym">read-one</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Recursive read, but skip comments and detect EOF</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">read-one</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="special-comments.html#%28def._%28%28quote._~23~25kernel%29._special-comment~3f%29%29" class="RktValLink" data-pltdoc="x">special-comment?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-next-location%29%29" class="RktValLink" data-pltdoc="x">port-next-location</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">raise-read-eof-error</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"unexpected EOF in tuple"</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">parse</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktSym">read-one</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">First, check for empty tuple</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">skip-whitespace</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-char%29%29" class="RktValLink" data-pltdoc="x">peek-char</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">elem</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">read-one</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="special-comments.html#%28def._%28%28quote._~23~25kernel%29._special-comment~3f%29%29" class="RktValLink" data-pltdoc="x">special-comment?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">elem</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Found a comment, so look for &gt; again</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">parse</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktSym">read-one</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Non-empty tuple:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">elem</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">parse-nonempty</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktSym">read-one</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">parse-nonempty</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktSym">read-one</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Need a comma or closer</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">skip-whitespace</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%29" class="RktStxLink" data-pltdoc="x">case</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-char%29%29" class="RktValLink" data-pltdoc="x">peek-char</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">#\&gt;</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char%29%29" class="RktValLink" data-pltdoc="x">read-char</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Done</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">#\,</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char%29%29" class="RktValLink" data-pltdoc="x">read-char</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Read next element and recur</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">skip-comments</span><span class="hspace">&nbsp;</span><span class="RktSym">read-one</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">parse-nonempty</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktSym">read-one</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Either a comment or an error; grab location (in case</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">of error) and read recursively to detect comments</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-next-location%29%29" class="RktValLink" data-pltdoc="x">port-next-location</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">read-one</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._cond%29%29" class="RktStxLink" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="special-comments.html#%28def._%28%28quote._~23~25kernel%29._special-comment~3f%29%29" class="RktValLink" data-pltdoc="x">special-comment?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">It was a comment, so try again</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">parse-nonempty</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktSym">read-one</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Wasn</span><span class="RktCmt">'</span><span class="RktCmt">t a comment, comma, or closer; error</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof-object~3f%29%29" class="RktValLink" data-pltdoc="x">eof-object?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">raise-read-eof-error</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">raise-read-error</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"expected `,` or `&gt;`"</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-delims-table</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Table to use for recursive reads to disallow delimiters</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"> (except those in sub-expressions)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec%29%29" class="RktStxLink" data-pltdoc="x">letrec</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">misplaced-delimiter</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">misplaced-delimiter</span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">line</span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="hspace">&nbsp;</span><span class="RktSym">pos</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">raise-read-error</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"misplaced `~a` in tuple"</span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">line</span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="hspace">&nbsp;</span><span class="RktSym">pos</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._make-readtable%29%29" class="RktValLink" data-pltdoc="x">make-readtable</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-readtable%29%29" class="RktValLink" data-pltdoc="x">current-readtable</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#\,</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">terminating-macro</span><span class="hspace">&nbsp;</span><span class="RktSym">misplaced-delimiter</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#\&gt;</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">terminating-macro</span><span class="hspace">&nbsp;</span><span class="RktSym">misplaced-delimiter</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">wrap</span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">make-tuple</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">list</span><span class="hspace">&nbsp;</span><span class="RktRdr">,@</span><span class="RktSym">l</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">parse-open-tuple</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">&lsquo;</span><span class="RktCmt">read</span><span class="RktCmt">&lsquo;</span><span class="RktCmt"> mode</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">wrap</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">parse</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read/recursive</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-delims-table</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">line</span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="hspace">&nbsp;</span><span class="RktSym">pos</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">&lsquo;</span><span class="RktCmt">read-syntax</span><span class="RktCmt">&lsquo;</span><span class="RktCmt"> mode</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">wrap</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">parse</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%2Frecursive%29%29" class="RktValLink" data-pltdoc="x">read-syntax/recursive</a></span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-delims-table</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">src</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="linecol.html#%28def._%28%28quote._~23~25kernel%29._port-next-location%29%29" class="RktValLink" data-pltdoc="x">port-next-location</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">line</span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="hspace">&nbsp;</span><span class="RktSym">pos</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pos</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktSym">pos</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tuple-readtable</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._make-readtable%29%29" class="RktValLink" data-pltdoc="x">make-readtable</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#\&lt;</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">terminating-macro</span><span class="hspace">&nbsp;</span><span class="RktSym">parse-open-tuple</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-readtable%29%29" class="RktValLink" data-pltdoc="x">current-readtable</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tuple-readtable</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"&lt;1 , 2 , \"a\"&gt;"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(make-tuple (list 1 2 "a"))</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-readtable%29%29" class="RktValLink" data-pltdoc="x">current-readtable</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tuple-readtable</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"&lt; #||# 1 #||# , #||# 2 #||# , #||# \"a\" #||# &gt;"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(make-tuple (list 1 2 "a"))</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tuple-readtable+</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="readtables.html#%28def._%28%28quote._~23~25kernel%29._make-readtable%29%29" class="RktValLink" data-pltdoc="x">make-readtable</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tuple-readtable</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#\*</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">terminating-macro</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="special-comments.html#%28def._%28%28quote._~23~25kernel%29._make-special-comment%29%29" class="RktValLink" data-pltdoc="x">make-special-comment</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#\_</span><span class="hspace">&nbsp;</span><span class="RktVal">#\space</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._current-readtable%29%29" class="RktValLink" data-pltdoc="x">current-readtable</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tuple-readtable+</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"&lt; * 1 __,__</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">2 __,__ * \"a\" * &gt;"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(make-tuple (list 1 2 "a"))</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Reader_Extension.html" title="backward to &quot;13.7 Reader Extension&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Reader_Extension.html" title="up to &quot;13.7 Reader Extension&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="reader-procs.html" title="forward to &quot;13.7.2 Reader-Extension Procedures&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/regexp.html b/clones/docs.racket-lang.org/reference/regexp.html
new file mode 100644
index 00000000..34567e2e
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/regexp.html
@@ -0,0 +1,329 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.8&nbsp;Regular Expressions</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewselflink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.8&nbsp;</td><td><a href="regexp.html" class="tocviewselflink" data-pltdoc="x">Regular Expressions</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.8.1&nbsp;</td><td><a href="regexp.html#%28part._regexp-syntax%29" class="tocviewlink" data-pltdoc="x">Regexp Syntax</a></td></tr><tr><td align="right">4.8.2&nbsp;</td><td><a href="regexp.html#%28part._.Additional_.Syntactic_.Constraints%29" class="tocviewlink" data-pltdoc="x">Additional Syntactic Constraints</a></td></tr><tr><td align="right">4.8.3&nbsp;</td><td><a href="regexp.html#%28part._.Regexp_.Constructors%29" class="tocviewlink" data-pltdoc="x">Regexp Constructors</a></td></tr><tr><td align="right">4.8.4&nbsp;</td><td><a href="regexp.html#%28part._.Regexp_.Matching%29" class="tocviewlink" data-pltdoc="x">Regexp Matching</a></td></tr><tr><td align="right">4.8.5&nbsp;</td><td><a href="regexp.html#%28part._.Regexp_.Splitting%29" class="tocviewlink" data-pltdoc="x">Regexp Splitting</a></td></tr><tr><td align="right">4.8.6&nbsp;</td><td><a href="regexp.html#%28part._.Regexp_.Substitution%29" class="tocviewlink" data-pltdoc="x">Regexp Substitution</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">4.8.1<tt>&nbsp;</tt></span><a href="regexp.html#%28part._regexp-syntax%29" class="tocsubseclink" data-pltdoc="x">Regexp Syntax</a></td></tr><tr><td><span class="tocsublinknumber">4.8.2<tt>&nbsp;</tt></span><a href="regexp.html#%28part._.Additional_.Syntactic_.Constraints%29" class="tocsubseclink" data-pltdoc="x">Additional Syntactic Constraints</a></td></tr><tr><td><span class="tocsublinknumber">4.8.3<tt>&nbsp;</tt></span><a href="regexp.html#%28part._.Regexp_.Constructors%29" class="tocsubseclink" data-pltdoc="x">Regexp Constructors</a></td></tr><tr><td><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp?</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._pregexp~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pregexp?</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">byte-<wbr></wbr>regexp?</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-pregexp~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">byte-<wbr></wbr>pregexp?</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._pregexp%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pregexp</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">byte-<wbr></wbr>regexp</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-pregexp%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">byte-<wbr></wbr>pregexp</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-quote%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>quote</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-max-lookbehind%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>max-<wbr></wbr>lookbehind</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.8.4<tt>&nbsp;</tt></span><a href="regexp.html#%28part._.Regexp_.Matching%29" class="tocsubseclink" data-pltdoc="x">Regexp Matching</a></td></tr><tr><td><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>match</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>match*</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-try-match%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>try-<wbr></wbr>match</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-positions%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>match-<wbr></wbr>positions</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match-positions%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>match-<wbr></wbr>positions*</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>match?</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match-exact~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>match-<wbr></wbr>exact?</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>match-<wbr></wbr>peek</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek-positions%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>match-<wbr></wbr>peek-<wbr></wbr>positions</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek-immediate%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>match-<wbr></wbr>peek-<wbr></wbr>immediate</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek-positions-immediate%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>match-<wbr></wbr>peek-<wbr></wbr>positions-<wbr></wbr>immediate</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match-peek-positions%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>match-<wbr></wbr>peek-<wbr></wbr>positions*</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%2Fend%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>match/<span class="mywbr"> &nbsp;</span>end</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-positions%2Fend%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>match-<wbr></wbr>positions/<span class="mywbr"> &nbsp;</span>end</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek-positions%2Fend%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>match-<wbr></wbr>peek-<wbr></wbr>positions/<span class="mywbr"> &nbsp;</span>end</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek-positions-immediate%2Fend%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>match-<wbr></wbr>peek-<wbr></wbr>positions-<wbr></wbr>immediate/<span class="mywbr"> &nbsp;</span>end</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.8.5<tt>&nbsp;</tt></span><a href="regexp.html#%28part._.Regexp_.Splitting%29" class="tocsubseclink" data-pltdoc="x">Regexp Splitting</a></td></tr><tr><td><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-split%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>split</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.8.6<tt>&nbsp;</tt></span><a href="regexp.html#%28part._.Regexp_.Substitution%29" class="tocsubseclink" data-pltdoc="x">Regexp Substitution</a></td></tr><tr><td><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-replace%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>replace</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-replace%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>replace*</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-replaces%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>replaces</span></span></a></td></tr><tr><td><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-replace-quote%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">regexp-<wbr></wbr>replace-<wbr></wbr>quote</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="symbols.html" title="backward to &quot;4.7 Symbols&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="keywords.html" title="forward to &quot;4.9 Keywords&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;regexp&quot;">4.8<tt>&nbsp;</tt><a name="(part._regexp)"></a><a name="(idx._(gentag._183._(lib._scribblings/reference/reference..scrbl)))"></a><a name="(idx._(gentag._184._(lib._scribblings/reference/reference..scrbl)))"></a><a name="(idx._(gentag._185._(lib._scribblings/reference/reference..scrbl)))"></a><a name="(idx._(gentag._186._(lib._scribblings/reference/reference..scrbl)))"></a>Regular Expressions</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=regexp.html&amp;version=8.6" class="Sq" data-pltdoc="x">Regular Expressions</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces regular expressions.</p></blockquote></blockquote></blockquote><p><a name="(tech._regular._expression)"></a><span style="font-style: italic">Regular expressions</span> are specified as strings or byte
+strings, using the same pattern language as either the Unix utility
+<span class="stt">egrep</span> or Perl. A string-specified pattern produces a character
+regexp matcher, and a byte-string pattern produces a byte regexp
+matcher. If a character regexp is used with a byte string or input
+port, it matches UTF-8 encodings (see <a href="encodings.html" data-pltdoc="x">Encodings and Locales</a>) of
+matching character streams; if a byte regexp is used with a character
+string, it matches bytes in the UTF-8 encoding of the string.</p><p>A regular expression that is represented as a string or byte string
+can be compiled to a <a name="(tech._regexp._value)"></a><span style="font-style: italic">regexp value</span>, which can be used more
+efficiently by functions such as <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span> compared to the
+string or byte string form. The <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="RktValLink" data-pltdoc="x">regexp</a></span> and
+<span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp%29%29" class="RktValLink" data-pltdoc="x">byte-regexp</a></span> procedures convert a string or byte string
+(respectively) into a regexp value using a syntax of regular
+expressions that is most compatible to <span class="stt">egrep</span>. The
+<span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._pregexp%29%29" class="RktValLink" data-pltdoc="x">pregexp</a></span> and <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-pregexp%29%29" class="RktValLink" data-pltdoc="x">byte-pregexp</a></span> procedures produce a regexp
+value using a slightly different syntax of regular expressions that is
+more compatible with Perl.</p><p>Two <a href="regexp.html#%28tech._regexp._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp values</span></a> are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> if they have the same
+source, use the same pattern language, and are both character regexps
+or both byte regexps.</p><p>A literal or printed <a href="regexp.html#%28tech._regexp._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp value</span></a> starts with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#rx</span><span class="hspace"></span></span> or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#px</span><span class="hspace"></span></span>. See <a href="reader.html#%28part._parse-regexp%29" data-pltdoc="x">Reading Regular Expressions</a>
+    for information on <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>ing
+    regular expressions and <a href="printing.html#%28part._print-regexp%29" data-pltdoc="x">Printing Regular Expressions</a>
+    for information on <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>ing regular expressions. Regexp
+values produced by the default reader are <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> in
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode.</p><p>On the <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=performance.html%23%2528tech._bc%2529&amp;version=8.6" class="techoutside Sq" data-pltdoc="x"><span class="techinside">BC</span></a> variant of Racket,
+the internal size of a <a href="regexp.html#%28tech._regexp._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp value</span></a> is limited to 32 kilobytes; this
+limit roughly corresponds to a source string with 32,000 literal
+characters or 5,000 operators.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;regexp-syntax&quot;">4.8.1<tt>&nbsp;</tt><a name="(part._regexp-syntax)"></a>Regexp Syntax</h5><p>The following syntax specifications describe the content of a string
+that represents a regular expression. The syntax of the corresponding
+string may involve extra escape characters. For example, the regular
+expression <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(.*)\1</span><span class="hspace"></span></span> can be represented with the string
+<span class="RktVal">"(.*)\\1"</span> or the regexp constant <span class="RktVal">#rx"(.*)\\1"</span>; the
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> in the regular expression must be escaped to include it
+in a string or regexp constant.</p><p>The <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="RktValLink" data-pltdoc="x">regexp</a></span> and <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._pregexp%29%29" class="RktValLink" data-pltdoc="x">pregexp</a></span> syntaxes share a common core:</p><p><table cellspacing="0" cellpadding="0"><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">pces</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match <span class="sroman">&#8249;<span style="font-style: italic">pces</span>&#8250;</span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match either <span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span>, try left first</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._1%29%29" data-pltdoc="x">ex1</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">pces</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left"><p></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match empty</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">pce</span>&#8250;</span><span class="sroman">&#8249;<span style="font-style: italic">pces</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match <span class="sroman">&#8249;<span style="font-style: italic">pce</span>&#8250;</span> followed by <span class="sroman">&#8249;<span style="font-style: italic">pces</span>&#8250;</span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">pce</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">repeat</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match <span class="sroman">&#8249;<span style="font-style: italic">repeat</span>&#8250;</span>, longest possible</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._3%29%29" data-pltdoc="x">ex3</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">repeat</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">?</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match <span class="sroman">&#8249;<span style="font-style: italic">repeat</span>&#8250;</span>, shortest possible</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._6%29%29" data-pltdoc="x">ex6</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match <span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span> exactly once</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">repeat</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">*</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match <span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span> 0 or more times</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._3%29%29" data-pltdoc="x">ex3</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match <span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span> 1 or more times</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._4%29%29" data-pltdoc="x">ex4</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">?</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match <span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span> 0 or 1 times</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._5%29%29" data-pltdoc="x">ex5</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match sub-expression <span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span> and report</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._11%29%29" data-pltdoc="x">ex11</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">rng</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match any character in <span class="sroman">&#8249;<span style="font-style: italic">rng</span>&#8250;</span></span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._2%29%29" data-pltdoc="x">ex2</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[^</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">rng</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match any character not in <span class="sroman">&#8249;<span style="font-style: italic">rng</span>&#8250;</span></span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._12%29%29" data-pltdoc="x">ex12</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match any (except newline in multi mode)</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._13%29%29" data-pltdoc="x">ex13</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match start (or after newline in multi mode)</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._14%29%29" data-pltdoc="x">ex14</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">$</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match end (or before newline in multi mode)</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._15%29%29" data-pltdoc="x">ex15</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">literal</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match a single literal character</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._1%29%29" data-pltdoc="x">ex1</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">mode</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">:</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match <span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span> using <span class="sroman">&#8249;<span style="font-style: italic">mode</span>&#8250;</span></span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._35%29%29" data-pltdoc="x">ex35</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?&gt;</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match <span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span>, only first possible</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">look</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match empty if <span class="sroman">&#8249;<span style="font-style: italic">look</span>&#8250;</span> matches</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">tst</span>&#8250;</span><span class="sroman">&#8249;<span style="font-style: italic">pces</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">pces</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match 1st <span class="sroman">&#8249;<span style="font-style: italic">pces</span>&#8250;</span> if <span class="sroman">&#8249;<span style="font-style: italic">tst</span>&#8250;</span>, else 2nd <span class="sroman">&#8249;<span style="font-style: italic">pces</span>&#8250;</span></span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._36%29%29" data-pltdoc="x">ex36</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">tst</span>&#8250;</span><span class="sroman">&#8249;<span style="font-style: italic">pces</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match <span class="sroman">&#8249;<span style="font-style: italic">pces</span>&#8250;</span> if <span class="sroman">&#8249;<span style="font-style: italic">tst</span>&#8250;</span>, empty if not <span class="sroman">&#8249;<span style="font-style: italic">tst</span>&#8250;</span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> at end of pattern</p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match the nul character (ASCII 0)</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">rng</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller"><span class="sroman">&#8249;<span style="font-style: italic">rng</span>&#8250;</span> contains <span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span> only</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._27%29%29" data-pltdoc="x">ex27</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller"><span class="sroman">&#8249;<span style="font-style: italic">rng</span>&#8250;</span> contains <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span> only</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._28%29%29" data-pltdoc="x">ex28</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">mrng</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller"><span class="sroman">&#8249;<span style="font-style: italic">rng</span>&#8250;</span> contains everything in <span class="sroman">&#8249;<span style="font-style: italic">mrng</span>&#8250;</span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">mrng</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller"><span class="sroman">&#8249;<span style="font-style: italic">rng</span>&#8250;</span> contains <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span> and everything in <span class="sroman">&#8249;<span style="font-style: italic">mrng</span>&#8250;</span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">mrng</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">lrng</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller"><span class="sroman">&#8249;<span style="font-style: italic">mrng</span>&#8250;</span> contains <span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span> and everything in <span class="sroman">&#8249;<span style="font-style: italic">lrng</span>&#8250;</span></span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._29%29%29" data-pltdoc="x">ex29</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">lrng</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller"><span class="sroman">&#8249;<span style="font-style: italic">mrng</span>&#8250;</span> contains <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span> and everything in <span class="sroman">&#8249;<span style="font-style: italic">lrng</span>&#8250;</span></span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._29%29%29" data-pltdoc="x">ex29</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">lirng</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller"><span class="sroman">&#8249;<span style="font-style: italic">mrng</span>&#8250;</span> contains everything in <span class="sroman">&#8249;<span style="font-style: italic">lirng</span>&#8250;</span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">lirng</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">riliteral</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller"><span class="sroman">&#8249;<span style="font-style: italic">lirng</span>&#8250;</span> contains a literal character</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">riliteral</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">rliteral</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller"><span class="sroman">&#8249;<span style="font-style: italic">lirng</span>&#8250;</span> contains Unicode range inclusive</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._22%29%29" data-pltdoc="x">ex22</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">lirng</span>&#8250;</span><span class="sroman">&#8249;<span style="font-style: italic">lrng</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller"><span class="sroman">&#8249;<span style="font-style: italic">lirng</span>&#8250;</span> contains everything in both</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">lrng</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller"><span class="sroman">&#8249;<span style="font-style: italic">lrng</span>&#8250;</span> contains <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span></span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._30%29%29" data-pltdoc="x">ex30</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">rliteral</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">rliteral</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller"><span class="sroman">&#8249;<span style="font-style: italic">lrng</span>&#8250;</span> contains Unicode range inclusive</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">lrng</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller"><span class="sroman">&#8249;<span style="font-style: italic">lrng</span>&#8250;</span> contains <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span> and more</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">lirng</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller"><span class="sroman">&#8249;<span style="font-style: italic">lrng</span>&#8250;</span> contains everything in <span class="sroman">&#8249;<span style="font-style: italic">lirng</span>&#8250;</span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">look</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?=</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match if <span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span> matches</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._31%29%29" data-pltdoc="x">ex31</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?!</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match if <span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span> doesn't match</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._32%29%29" data-pltdoc="x">ex32</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?&lt;=</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match if <span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span> matches preceding</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._33%29%29" data-pltdoc="x">ex33</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?&lt;!</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match if <span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span> doesn't match preceding</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._34%29%29" data-pltdoc="x">ex34</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">tst</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">True if <span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span>th <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span> has a match</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">look</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">True if <span class="sroman">&#8249;<span style="font-style: italic">look</span>&#8250;</span> matches</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._36%29%29" data-pltdoc="x">ex36</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">mode</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left"><p></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Like the enclosing mode</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">mode</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">i</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Like <span class="sroman">&#8249;<span style="font-style: italic">mode</span>&#8250;</span>, but case-insensitive</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._35%29%29" data-pltdoc="x">ex35</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">mode</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">-i</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Like <span class="sroman">&#8249;<span style="font-style: italic">mode</span>&#8250;</span>, but sensitive</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">mode</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">s</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Like <span class="sroman">&#8249;<span style="font-style: italic">mode</span>&#8250;</span>, but not in multi mode</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">mode</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">-s</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Like <span class="sroman">&#8249;<span style="font-style: italic">mode</span>&#8250;</span>, but in multi mode</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">mode</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">m</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Like <span class="sroman">&#8249;<span style="font-style: italic">mode</span>&#8250;</span>, but in multi mode</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">mode</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">-m</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Like <span class="sroman">&#8249;<span style="font-style: italic">mode</span>&#8250;</span>, but not in multi mode</span></p></td><td align="left"><p></p></td></tr></table></p><p>The following completes the grammar for <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="RktValLink" data-pltdoc="x">regexp</a></span>, which treats
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span> as literals, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> as a
+literal within ranges, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> as a literal producer
+outside of ranges.</p><p><table cellspacing="0" cellpadding="0"><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">literal</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left" colspan="3"><p>Any character except <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">*</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">?</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">aliteral</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match <span class="sroman">&#8249;<span style="font-style: italic">aliteral</span>&#8250;</span></span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._21%29%29" data-pltdoc="x">ex21</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">aliteral</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left" colspan="3"><p>Any character</p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">riliteral</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left" colspan="3"><p>Any character except <span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">rliteral</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left" colspan="3"><p>Any character except <span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span></p></td><td align="left"><p></p></td></tr></table></p><p>The following completes the grammar for <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._pregexp%29%29" class="RktValLink" data-pltdoc="x">pregexp</a></span>, which uses
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span> bounded repetition and uses
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> for meta-characters both inside and outside of ranges.</p><p><table cellspacing="0" cellpadding="0"><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">repeat</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left"><p>...</p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">...</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match <span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span> exactly <span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span> times</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._7%29%29" data-pltdoc="x">ex7</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">,}</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match <span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span> <span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span> or more times</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._8%29%29" data-pltdoc="x">ex8</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">{,</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">m</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match <span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span> between 0 and <span class="sroman">&#8249;<span style="font-style: italic">m</span>&#8250;</span> times</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._9%29%29" data-pltdoc="x">ex9</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">,</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">m</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match <span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span> between <span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span> and <span class="sroman">&#8249;<span style="font-style: italic">m</span>&#8250;</span> times</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._10%29%29" data-pltdoc="x">ex10</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">{}</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match <span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span> 0 or more times</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left"><p>...</p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">...</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match latest reported match for <span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span>th <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span></span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._16%29%29" data-pltdoc="x">ex16</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">class</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match any character in <span class="sroman">&#8249;<span style="font-style: italic">class</span>&#8250;</span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\b</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\w*</span><span class="hspace"></span></span> boundary</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._17%29%29" data-pltdoc="x">ex17</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\B</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match where <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\b</span><span class="hspace"></span></span> does not</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._18%29%29" data-pltdoc="x">ex18</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\p{</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">property</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match (UTF-8 encoded) in <span class="sroman">&#8249;<span style="font-style: italic">property</span>&#8250;</span></span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._19%29%29" data-pltdoc="x">ex19</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\P{</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">property</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match (UTF-8 encoded) not in <span class="sroman">&#8249;<span style="font-style: italic">property</span>&#8250;</span></span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._20%29%29" data-pltdoc="x">ex20</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">literal</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left" colspan="3"><p>Any character except <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">*</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">?</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">aliteral</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Match <span class="sroman">&#8249;<span style="font-style: italic">aliteral</span>&#8250;</span></span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._21%29%29" data-pltdoc="x">ex21</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">aliteral</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left" colspan="3"><p>Any character except <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">z</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">A</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">Z</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">0</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">9</span><span class="hspace"></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">lirng</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left"><p>...</p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">...</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">class</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller"><span class="sroman">&#8249;<span style="font-style: italic">lirng</span>&#8250;</span> contains all characters in <span class="sroman">&#8249;<span style="font-style: italic">class</span>&#8250;</span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">posix</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller"><span class="sroman">&#8249;<span style="font-style: italic">lirng</span>&#8250;</span> contains all characters in <span class="sroman">&#8249;<span style="font-style: italic">posix</span>&#8250;</span></span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._26%29%29" data-pltdoc="x">ex26</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">eliteral</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller"><span class="sroman">&#8249;<span style="font-style: italic">lirng</span>&#8250;</span> contains <span class="sroman">&#8249;<span style="font-style: italic">eliteral</span>&#8250;</span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">riliteral</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left" colspan="3"><p>Any character except <span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">rliteral</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left" colspan="3"><p>Any character except <span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">eliteral</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left" colspan="3"><p>Any character except <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">z</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">A</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">Z</span><span class="hspace"></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">class</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\d</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Contains <span class="RktInBG"><span class="hspace"></span><span class="RktIn">0</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">9</span><span class="hspace"></span></span></span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._23%29%29" data-pltdoc="x">ex23</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\D</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Contains characters not in <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\d</span><span class="hspace"></span></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\w</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Contains <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">z</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">A</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">Z</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">0</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">9</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">_</span><span class="hspace"></span></span></span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._24%29%29" data-pltdoc="x">ex24</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\W</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Contains characters not in <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\w</span><span class="hspace"></span></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\s</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Contains space, tab, newline, formfeed, return</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._25%29%29" data-pltdoc="x">ex25</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\S</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Contains characters not in <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\s</span><span class="hspace"></span></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">posix</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:alpha:]</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Contains <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">z</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">A</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">Z</span><span class="hspace"></span></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:upper:]</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Contains <span class="RktInBG"><span class="hspace"></span><span class="RktIn">A</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">Z</span><span class="hspace"></span></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:lower:]</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Contains <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">z</span><span class="hspace"></span></span></span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._26%29%29" data-pltdoc="x">ex26</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:digit:]</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Contains <span class="RktInBG"><span class="hspace"></span><span class="RktIn">0</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">9</span><span class="hspace"></span></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:xdigit:]</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Contains <span class="RktInBG"><span class="hspace"></span><span class="RktIn">0</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">9</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">f</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">A</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">F</span><span class="hspace"></span></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:alnum:]</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Contains <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">z</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">A</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">Z</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">0</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">9</span><span class="hspace"></span></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:word:]</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Contains <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">z</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">A</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">Z</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">0</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">9</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">_</span><span class="hspace"></span></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:blank:]</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Contains space and tab</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:space:]</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Contains space, tab, newline, formfeed, return</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:graph:]</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Contains all ASCII characters that use ink</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:print:]</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Contains space, tab, and ASCII ink users</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:cntrl:]</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Contains all characters with scalar value &lt; 32</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:ascii:]</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Contains all ASCII characters</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">property</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">category</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Includes all characters in <span class="sroman">&#8249;<span style="font-style: italic">category</span>&#8250;</span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">category</span>&#8250;</span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Includes all characters not in <span class="sroman">&#8249;<span style="font-style: italic">category</span>&#8250;</span></span></p></td><td align="left"><p></p></td></tr></table></p><p>In case-insensitive mode, a backreference of the form
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span> matches case-insensitively only with respect to
+ASCII characters.</p><p>The Unicode categories follow.</p><p><table cellspacing="0" cellpadding="0"><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="sroman">&#8249;<span style="font-style: italic">category</span>&#8250;</span></p></td><td align="center"><p><span class="hspace">&nbsp;</span><span class="stt">::=</span><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Ll</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Letter, lowercase</span></p></td><td align="left"><p><span class="Smaller">&nbsp;<a href="regexp.html#%28elem._%28rxex._19%29%29" data-pltdoc="x">ex19</a></span></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Lu</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Letter, uppercase</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Lt</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Letter, titlecase</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Lm</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Letter, modifier</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">L&amp;</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Union of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Ll</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Lu</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Lt</span><span class="hspace"></span></span>, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Lm</span><span class="hspace"></span></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Lo</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Letter, other</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">L</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Union of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">L&amp;</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Lo</span><span class="hspace"></span></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Nd</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Number, decimal digit</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Nl</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Number, letter</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">No</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Number, other</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">N</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Union of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Nd</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Nl</span><span class="hspace"></span></span>, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">No</span><span class="hspace"></span></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Ps</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Punctuation, open</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Pe</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Punctuation, close</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Pi</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Punctuation, initial quote</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Pf</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Punctuation, final quote</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Pc</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Punctuation, connector</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Pd</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Punctuation, dash</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Po</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Punctuation, other</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">P</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Union of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Ps</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Pe</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Pi</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Pf</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Pc</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Pd</span><span class="hspace"></span></span>, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Po</span><span class="hspace"></span></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Mn</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Mark, non-spacing</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Mc</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Mark, spacing combining</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Me</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Mark, enclosing</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">M</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Union of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Mn</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Mc</span><span class="hspace"></span></span>, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Me</span><span class="hspace"></span></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Sc</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Symbol, currency</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Sk</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Symbol, modifier</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Sm</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Symbol, math</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">So</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Symbol, other</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">S</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Union of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Sc</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Sk</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Sm</span><span class="hspace"></span></span>, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">So</span><span class="hspace"></span></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Zl</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Separator, line</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Zp</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Separator, paragraph</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Zs</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Separator, space</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Z</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Union of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Zl</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Zp</span><span class="hspace"></span></span>, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Zs</span><span class="hspace"></span></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Cc</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Other, control</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Cf</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Other, format</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Cs</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Other, surrogate</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Cn</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Other, not assigned</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">Co</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Other, private use</span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">C</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Union of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Cc</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Cf</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Cs</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Cn</span><span class="hspace"></span></span>, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">Co</span><span class="hspace"></span></span></span></p></td><td align="left"><p></p></td></tr><tr><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p>&nbsp;</p></td><td align="center"><p><span class="stt">|</span></p></td><td align="left"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span></p></td><td align="left"><p><span class="hspace">&nbsp;</span></p></td><td align="left"><p><span class="smaller">Union of all Unicode categories</span></p></td><td align="left"><p></p></td></tr></table></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx"a|b"</span><span class="stt"> </span><span class="RktVal">"cat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._1))"></a><span class="RktCmt">1</span></td></tr><tr><td><p><span class="RktRes">'("a")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx"[at]"</span><span class="stt"> </span><span class="RktVal">"cat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._2))"></a><span class="RktCmt">2</span></td></tr><tr><td><p><span class="RktRes">'("a")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx"ca*[at]"</span><span class="stt"> </span><span class="RktVal">"caaat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._3))"></a><span class="RktCmt">3</span></td></tr><tr><td><p><span class="RktRes">'("caaat")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx"ca+[at]"</span><span class="stt"> </span><span class="RktVal">"caaat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._4))"></a><span class="RktCmt">4</span></td></tr><tr><td><p><span class="RktRes">'("caaat")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx"ca?t?"</span><span class="stt"> </span><span class="RktVal">"ct"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._5))"></a><span class="RktCmt">5</span></td></tr><tr><td><p><span class="RktRes">'("ct")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx"ca*?[at]"</span><span class="stt"> </span><span class="RktVal">"caaat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._6))"></a><span class="RktCmt">6</span></td></tr><tr><td><p><span class="RktRes">'("ca")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#px"ca{2}"</span><span class="stt"> </span><span class="RktVal">"caaat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._7))"></a><span class="RktCmt">7</span><span class="RktCmt">, uses </span><span class="RktMeta">#px</span></td></tr><tr><td><p><span class="RktRes">'("caa")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#px"ca{2,}t"</span><span class="stt"> </span><span class="RktVal">"catcaat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._8))"></a><span class="RktCmt">8</span><span class="RktCmt">, uses </span><span class="RktMeta">#px</span></td></tr><tr><td><p><span class="RktRes">'("caat")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#px"ca{,2}t"</span><span class="stt"> </span><span class="RktVal">"caaatcat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._9))"></a><span class="RktCmt">9</span><span class="RktCmt">, uses </span><span class="RktMeta">#px</span></td></tr><tr><td><p><span class="RktRes">'("cat")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#px"ca{1,2}t"</span><span class="stt"> </span><span class="RktVal">"caaatcat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._10))"></a><span class="RktCmt">10</span><span class="RktCmt">, uses </span><span class="RktMeta">#px</span></td></tr><tr><td><p><span class="RktRes">'("cat")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx"(c*)(a*)"</span><span class="stt"> </span><span class="RktVal">"caat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._11))"></a><span class="RktCmt">11</span></td></tr><tr><td><p><span class="RktRes">'("caa" "c" "aa")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx"[^ca]"</span><span class="stt"> </span><span class="RktVal">"caat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._12))"></a><span class="RktCmt">12</span></td></tr><tr><td><p><span class="RktRes">'("t")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx".(.)."</span><span class="stt"> </span><span class="RktVal">"cat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._13))"></a><span class="RktCmt">13</span></td></tr><tr><td><p><span class="RktRes">'("cat" "a")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx"^a|^c"</span><span class="stt"> </span><span class="RktVal">"cat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._14))"></a><span class="RktCmt">14</span></td></tr><tr><td><p><span class="RktRes">'("c")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx"a$|t$"</span><span class="stt"> </span><span class="RktVal">"cat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._15))"></a><span class="RktCmt">15</span></td></tr><tr><td><p><span class="RktRes">'("t")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#px"c(.)\\1t"</span><span class="stt"> </span><span class="RktVal">"caat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._16))"></a><span class="RktCmt">16</span><span class="RktCmt">, uses </span><span class="RktMeta">#px</span></td></tr><tr><td><p><span class="RktRes">'("caat" "a")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#px".\\b."</span><span class="stt"> </span><span class="RktVal">"cat in hat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._17))"></a><span class="RktCmt">17</span><span class="RktCmt">, uses </span><span class="RktMeta">#px</span></td></tr><tr><td><p><span class="RktRes">'("t ")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#px".\\B."</span><span class="stt"> </span><span class="RktVal">"cat in hat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._18))"></a><span class="RktCmt">18</span><span class="RktCmt">, uses </span><span class="RktMeta">#px</span></td></tr><tr><td><p><span class="RktRes">'("ca")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#px"\\p{Ll}"</span><span class="stt"> </span><span class="RktVal">"Cat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._19))"></a><span class="RktCmt">19</span><span class="RktCmt">, uses </span><span class="RktMeta">#px</span></td></tr><tr><td><p><span class="RktRes">'("a")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#px"\\P{Ll}"</span><span class="stt"> </span><span class="RktVal">"cat!"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._20))"></a><span class="RktCmt">20</span><span class="RktCmt">, uses </span><span class="RktMeta">#px</span></td></tr><tr><td><p><span class="RktRes">'("!")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx"\\|"</span><span class="stt"> </span><span class="RktVal">"c|t"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._21))"></a><span class="RktCmt">21</span></td></tr><tr><td><p><span class="RktRes">'("|")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx"[a-f]*"</span><span class="stt"> </span><span class="RktVal">"cat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._22))"></a><span class="RktCmt">22</span></td></tr><tr><td><p><span class="RktRes">'("ca")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#px"[a-f\\d]*"</span><span class="stt"> </span><span class="RktVal">"1cat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._23))"></a><span class="RktCmt">23</span><span class="RktCmt">, uses </span><span class="RktMeta">#px</span></td></tr><tr><td><p><span class="RktRes">'("1ca")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#px" [\\w]"</span><span class="stt"> </span><span class="RktVal">"cat hat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._24))"></a><span class="RktCmt">24</span><span class="RktCmt">, uses </span><span class="RktMeta">#px</span></td></tr><tr><td><p><span class="RktRes">'(" h")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#px"t[\\s]"</span><span class="stt"> </span><span class="RktVal">"cat\nhat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._25))"></a><span class="RktCmt">25</span><span class="RktCmt">, uses </span><span class="RktMeta">#px</span></td></tr><tr><td><p><span class="RktRes">'("t\n")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#px"[[:lower:]]+"</span><span class="stt"> </span><span class="RktVal">"Cat"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._26))"></a><span class="RktCmt">26</span><span class="RktCmt">, uses </span><span class="RktMeta">#px</span></td></tr><tr><td><p><span class="RktRes">'("at")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx"[]]"</span><span class="stt"> </span><span class="RktVal">"c]t"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._27))"></a><span class="RktCmt">27</span></td></tr><tr><td><p><span class="RktRes">'("]")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx"[-]"</span><span class="stt"> </span><span class="RktVal">"c-t"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._28))"></a><span class="RktCmt">28</span></td></tr><tr><td><p><span class="RktRes">'("-")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx"[]a[]+"</span><span class="stt"> </span><span class="RktVal">"c[a]t"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._29))"></a><span class="RktCmt">29</span></td></tr><tr><td><p><span class="RktRes">'("[a]")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx"[a^]+"</span><span class="stt"> </span><span class="RktVal">"ca^t"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._30))"></a><span class="RktCmt">30</span></td></tr><tr><td><p><span class="RktRes">'("a^")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx".a(?=p)"</span><span class="stt"> </span><span class="RktVal">"cat nap"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._31))"></a><span class="RktCmt">31</span></td></tr><tr><td><p><span class="RktRes">'("na")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx".a(?!t)"</span><span class="stt"> </span><span class="RktVal">"cat nap"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._32))"></a><span class="RktCmt">32</span></td></tr><tr><td><p><span class="RktRes">'("na")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx"(?&lt;=n)a."</span><span class="stt"> </span><span class="RktVal">"cat nap"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._33))"></a><span class="RktCmt">33</span></td></tr><tr><td><p><span class="RktRes">'("ap")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx"(?&lt;!c)a."</span><span class="stt"> </span><span class="RktVal">"cat nap"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._34))"></a><span class="RktCmt">34</span></td></tr><tr><td><p><span class="RktRes">'("ap")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx"(?i:a)[tp]"</span><span class="stt"> </span><span class="RktVal">"cAT nAp"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._35))"></a><span class="RktCmt">35</span></td></tr><tr><td><p><span class="RktRes">'("Ap")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="stt"> </span><span class="RktVal">#rx"(?(?&lt;=c)a|b)+"</span><span class="stt"> </span><span class="RktVal">"cabal"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ex</span><a name="(elem._(rxex._36))"></a><span class="RktCmt">36</span></td></tr><tr><td><p><span class="RktRes">'("ab")</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Additional_Syntactic_Constraints&quot;">4.8.2<tt>&nbsp;</tt><a name="(part._.Additional_.Syntactic_.Constraints)"></a>Additional Syntactic Constraints</h5><p>In addition to matching a grammar, regular expressions must meet two
+syntactic restrictions:</p><ul><li><p>In a <span class="sroman">&#8249;<span style="font-style: italic">repeat</span>&#8250;</span> other than <span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">?</span><span class="hspace"></span></span>,
+the <span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span> must not match an empty sequence.</p></li><li><p>In a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?&lt;=</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span> or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?&lt;!</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>,
+the <span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span> must match a bounded sequence only.</p></li></ul><p>These constraints are checked syntactically by the following type
+system. A type [<span style="font-style: italic">n</span>, <span style="font-style: italic">m</span>] corresponds to an expression that
+matches between <span style="font-style: italic">n</span> and <span style="font-style: italic">m</span> characters. In the rule for
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">Regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>, <span style="font-style: italic">N</span> means the number such
+that the opening parenthesis is the <span style="font-style: italic">N</span>th opening parenthesis for
+collecting match reports.  Non-emptiness is inferred for a
+backreference pattern, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">N</span>&#8250;</span>, so that a
+backreference can be used for repetition patterns; in the case of
+mutual dependencies among backreferences, the inference chooses the
+fixpoint that maximizes non-emptiness.  Finiteness is not inferred for
+backreferences (i.e., a backreference is assumed to match an
+arbitrarily large sequence). No syntactic constraint prohibits a
+backreference within the group that it references, although such self
+references might create a pattern with no possible matches (as in the
+case of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(.\1)</span><span class="hspace"></span></span>, although <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(^.|\1){2}</span><span class="hspace"></span></span> matches an
+input that starts with the same two characters).</p><p><table cellspacing="0" cellpadding="0"><tr><td align="center"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0"><tr><td align="center" class="inferencetop"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span></span><span style="vertical-align: sub; font-size: 80%">1</span><span class="RktInBG"><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%">1</span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%">1</span>]<span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span></span><span style="vertical-align: sub; font-size: 80%">2</span><span class="RktInBG"><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%">2</span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%">2</span>]<span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center" class="inferencebottom"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span></span><span style="vertical-align: sub; font-size: 80%">1</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span></span><span style="vertical-align: sub; font-size: 80%">2</span><span class="RktInBG"><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[min(<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%">1</span>, <span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%">2</span>), max(<span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%">1</span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%">2</span>)]<span class="hspace">&nbsp;</span></p></td></tr></table></td></tr></table></td></tr><tr><td align="center"><p><span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0"><tr><td align="center" class="inferencetop"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">pce</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%">1</span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%">1</span>]<span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">pces</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%">2</span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%">2</span>]<span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center" class="inferencebottom"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">pce</span>&#8250;</span><span class="sroman">&#8249;<span style="font-style: italic">pces</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%">1</span>+<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%">2</span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%">1</span>+<span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%">2</span>]<span class="hspace">&nbsp;</span></p></td></tr></table></td></tr></table></td></tr><tr><td align="center"><p><span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0"><tr><td align="center" class="inferencetop"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">repeat</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>]<span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center" class="inferencebottom"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">repeat</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">?</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[0, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>]<span class="hspace">&nbsp;</span></p></td></tr></table></td><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;</span></p></td><td><table cellspacing="0" cellpadding="0"><tr><td align="center" class="inferencetop"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>]<span class="hspace">&nbsp;&nbsp;&nbsp;</span><span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span> &gt; 0<span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center" class="inferencebottom"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">*</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[0, &infin;]<span class="hspace">&nbsp;</span></p></td></tr></table></td></tr></table></td></tr><tr><td align="center"><p><span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0"><tr><td align="center" class="inferencetop"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>]<span class="hspace">&nbsp;&nbsp;&nbsp;</span><span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span> &gt; 0<span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center" class="inferencebottom"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[1, &infin;]<span class="hspace">&nbsp;</span></p></td></tr></table></td><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;</span></p></td><td><table cellspacing="0" cellpadding="0"><tr><td align="center" class="inferencetop"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>]<span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center" class="inferencebottom"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">?</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[0, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>]<span class="hspace">&nbsp;</span></p></td></tr></table></td></tr></table></td></tr><tr><td align="center"><p><span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0"><tr><td align="center" class="inferencetop"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>]<span class="hspace">&nbsp;&nbsp;&nbsp;</span><span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span> &gt; 0<span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center" class="inferencebottom"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span>*<span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>*<span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span>]<span class="hspace">&nbsp;</span></p></td></tr></table></td></tr></table></td></tr><tr><td align="center"><p><span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0"><tr><td align="center" class="inferencetop"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>]<span class="hspace">&nbsp;&nbsp;&nbsp;</span><span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span> &gt; 0<span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center" class="inferencebottom"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">,}</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span>*<span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span>, &infin;]<span class="hspace">&nbsp;</span></p></td></tr></table></td></tr></table></td></tr><tr><td align="center"><p><span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0"><tr><td align="center" class="inferencetop"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>]<span class="hspace">&nbsp;&nbsp;&nbsp;</span><span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span> &gt; 0<span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center" class="inferencebottom"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">{,</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">m</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[0, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>*<span class="sroman">&#8249;<span style="font-style: italic">m</span>&#8250;</span>]<span class="hspace">&nbsp;</span></p></td></tr></table></td></tr></table></td></tr><tr><td align="center"><p><span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0"><tr><td align="center" class="inferencetop"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>]<span class="hspace">&nbsp;&nbsp;&nbsp;</span><span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span> &gt; 0<span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center" class="inferencebottom"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">atom</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">,</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">m</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span>*<span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>*<span class="sroman">&#8249;<span style="font-style: italic">m</span>&#8250;</span>]<span class="hspace">&nbsp;</span></p></td></tr></table></td></tr></table></td></tr><tr><td align="center"><p><span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0"><tr><td align="center" class="inferencetop"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>]<span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center" class="inferencebottom"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>]<span class="hspace">&nbsp;&nbsp;&nbsp;</span>&alpha;<span style="vertical-align: sub; font-size: 80%">N</span>=<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span><span class="hspace">&nbsp;</span></p></td></tr></table></td></tr></table></td></tr><tr><td align="center"><p><span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0"><tr><td align="center" class="inferencetop"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>]<span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center" class="inferencebottom"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">mode</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">:</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>]<span class="hspace">&nbsp;</span></p></td></tr></table></td></tr></table></td></tr><tr><td align="center"><p><span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0"><tr><td align="center" class="inferencetop"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>]<span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center" class="inferencebottom"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?=</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[0, 0]<span class="hspace">&nbsp;</span></p></td></tr></table></td><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;</span></p></td><td><table cellspacing="0" cellpadding="0"><tr><td align="center" class="inferencetop"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>]<span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center" class="inferencebottom"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?!</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[0, 0]<span class="hspace">&nbsp;</span></p></td></tr></table></td></tr></table></td></tr><tr><td align="center"><p><span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0"><tr><td align="center" class="inferencetop"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>]<span class="hspace">&nbsp;&nbsp;&nbsp;</span><span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span> &lt; &infin;<span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center" class="inferencebottom"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?&lt;=</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[0, 0]<span class="hspace">&nbsp;</span></p></td></tr></table></td><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;</span></p></td><td><table cellspacing="0" cellpadding="0"><tr><td align="center" class="inferencetop"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>]<span class="hspace">&nbsp;&nbsp;&nbsp;</span><span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span> &lt; &infin;<span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center" class="inferencebottom"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?&lt;!</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[0, 0]<span class="hspace">&nbsp;</span></p></td></tr></table></td></tr></table></td></tr><tr><td align="center"><p><span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0"><tr><td align="center" class="inferencetop"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>]<span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center" class="inferencebottom"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?&gt;</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">regexp</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%"></span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%"></span>]<span class="hspace">&nbsp;</span></p></td></tr></table></td></tr></table></td></tr><tr><td align="center"><p><span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0"><tr><td align="center" class="inferencetop"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">tst</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%">0</span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%">0</span>]<span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">pces</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span></span><span style="vertical-align: sub; font-size: 80%">1</span><span class="RktInBG"><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%">1</span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%">1</span>]<span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">pces</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span></span><span style="vertical-align: sub; font-size: 80%">2</span><span class="RktInBG"><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%">2</span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%">2</span>]<span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center" class="inferencebottom"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">tst</span>&#8250;</span><span class="sroman">&#8249;<span style="font-style: italic">pces</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span></span><span style="vertical-align: sub; font-size: 80%">1</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">pces</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span></span><span style="vertical-align: sub; font-size: 80%">2</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[min(<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%">1</span>, <span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%">2</span>), max(<span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%">1</span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%">2</span>)]<span class="hspace">&nbsp;</span></p></td></tr></table></td></tr></table></td></tr><tr><td align="center"><p><span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0"><tr><td align="center" class="inferencetop"><p><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">tst</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%">0</span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%">0</span>]<span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">pces</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[<span style="font-style: italic">n</span><span style="vertical-align: sub; font-size: 80%">1</span>, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%">1</span>]<span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center" class="inferencebottom"><p><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">tst</span>&#8250;</span><span class="sroman">&#8249;<span style="font-style: italic">pces</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[0, <span style="font-style: italic">m</span><span style="vertical-align: sub; font-size: 80%">1</span>]<span class="hspace">&nbsp;</span></p></td></tr></table></td></tr></table></td></tr><tr><td align="center"><p><span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center"><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[&alpha;<span style="vertical-align: sub; font-size: 80%">N</span>, &infin;]</p></td><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;</span></p></td><td><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">rng</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[1, 1]</p></td><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;</span></p></td><td><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[^</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">rng</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[1, 1]</p></td></tr></table></td></tr><tr><td align="center"><p><span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center"><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[1, 1]</p></td><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;</span></p></td><td><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[0, 0]</p></td><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;</span></p></td><td><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">$</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[0, 0]</p></td></tr></table></td></tr><tr><td align="center"><p><span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center"><table cellspacing="0" cellpadding="0"><tr><td><p><span class="sroman">&#8249;<span style="font-style: italic">literal</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[1, 1]</p></td><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;</span></p></td><td><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[&alpha;<span style="vertical-align: sub; font-size: 80%">N</span>, &infin;]</p></td><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;</span></p></td><td><p><span class="sroman">&#8249;<span style="font-style: italic">class</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[1, 1]</p></td></tr></table></td></tr><tr><td align="center"><p><span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center"><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\b</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[0, 0]</p></td><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;</span></p></td><td><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\B</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[0, 0]</p></td></tr></table></td></tr><tr><td align="center"><p><span class="hspace">&nbsp;</span></p></td></tr><tr><td align="center"><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\p{</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">property</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[1, 6]</p></td><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;</span></p></td><td><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\P{</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">property</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="stt">:</span><span class="hspace">&nbsp;</span>[1, 6]</p></td></tr></table></td></tr></table></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Regexp_Constructors&quot;">4.8.3<tt>&nbsp;</tt><a name="(part._.Regexp_.Constructors)"></a>Regexp Constructors</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._regexp~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="regexp.html#%28tech._regexp._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp value</span></a> created by
+<span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="RktValLink" data-pltdoc="x">regexp</a></span> or <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._pregexp%29%29" class="RktValLink" data-pltdoc="x">pregexp</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._pregexp~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._pregexp~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">pregexp?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="regexp.html#%28tech._regexp._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp value</span></a> created by
+<span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._pregexp%29%29" class="RktValLink" data-pltdoc="x">pregexp</a></span> (not <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="RktValLink" data-pltdoc="x">regexp</a></span>), <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._byte-regexp~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">byte-regexp?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="regexp.html#%28tech._regexp._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp value</span></a> created by
+<span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp%29%29" class="RktValLink" data-pltdoc="x">byte-regexp</a></span> or <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-pregexp%29%29" class="RktValLink" data-pltdoc="x">byte-pregexp</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._byte-pregexp~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-pregexp~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">byte-pregexp?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="regexp.html#%28tech._regexp._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp value</span></a> created by
+<span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-pregexp%29%29" class="RktValLink" data-pltdoc="x">byte-pregexp</a></span> (not <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp%29%29" class="RktValLink" data-pltdoc="x">byte-regexp</a></span>), <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._regexp))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktVar">handler</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">handler</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Takes a string representation of a regular expression (using the
+syntax in <a href="regexp.html#%28part._regexp-syntax%29" data-pltdoc="x">Regexp Syntax</a>) and compiles it into a <a href="regexp.html#%28tech._regexp._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp
+value</span></a>. Other regular expression procedures accept either a string or a
+<a href="regexp.html#%28tech._regexp._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp value</span></a> as the matching pattern. If a regular expression string
+is used multiple times, it is faster to compile the string once to a
+<a href="regexp.html#%28tech._regexp._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp value</span></a> and use it for repeated matches instead of using the
+string each time.</div></p><p>If <span class="RktVar">handler</span> is provided and not <span class="RktVal">#f</span>, it is called and
+its result is returned when <span class="RktVar">str</span> is not a valid representation
+of a regular expression; the argument to <span class="RktVar">handler</span> is a string
+that describes the problem with <span class="RktVar">str</span>. If <span class="RktVar">handler</span> is
+<span class="RktVal">#f</span> or not provided, then <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>The <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span> procedure returns
+the source string for a <a href="regexp.html#%28tech._regexp._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp value</span></a>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="RktValLink" data-pltdoc="x">regexp</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"ap*le"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#rx"ap*le"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"ap*le"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"ap*le"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="RktValLink" data-pltdoc="x">regexp</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"+"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("`+` follows nothing in pattern")</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.5.0.1 of package <span class="stt">base</span>: Added the <span class="RktVar">handler</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._pregexp))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._pregexp%29%29" class="RktValDef RktValLink" data-pltdoc="x">pregexp</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._pregexp~3f%29%29" class="RktValLink" data-pltdoc="x">pregexp?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._pregexp%29%29" class="RktValDef RktValLink" data-pltdoc="x">pregexp</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktVar">handler</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">handler</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="RktValLink" data-pltdoc="x">regexp</a></span>, except that it uses a slightly different syntax
+(see <a href="regexp.html#%28part._regexp-syntax%29" data-pltdoc="x">Regexp Syntax</a>). The result can be used with
+<span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span>, etc., just like the result from
+<span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="RktValLink" data-pltdoc="x">regexp</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._pregexp%29%29" class="RktValLink" data-pltdoc="x">pregexp</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"ap*le"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#px"ap*le"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"ap*le"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._pregexp%29%29" class="RktValLink" data-pltdoc="x">pregexp</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"+"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#("`+` follows nothing in pattern")</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.5.0.1 of package <span class="stt">base</span>: Added the <span class="RktVar">handler</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._byte-regexp))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp%29%29" class="RktValDef RktValLink" data-pltdoc="x">byte-regexp</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp%29%29" class="RktValDef RktValLink" data-pltdoc="x">byte-regexp</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktVar">handler</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">handler</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Takes a byte-string representation of a regular expression (using the
+syntax in <a href="regexp.html#%28part._regexp-syntax%29" data-pltdoc="x">Regexp Syntax</a>) and compiles it into a
+byte-<a href="regexp.html#%28tech._regexp._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp value</span></a>.</div></p><p>If <span class="RktVar">handler</span> is provided, it is called and its result is returned
+if <span class="RktSym">str</span> is not a valid representation of a regular expression.</p><p>The <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span> procedure
+returns the source byte string for a <a href="regexp.html#%28tech._regexp._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp value</span></a>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp%29%29" class="RktValLink" data-pltdoc="x">byte-regexp</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"ap*le"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#rx#"ap*le"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx#"ap*le"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"ap*le"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp%29%29" class="RktValLink" data-pltdoc="x">byte-regexp</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"ap*le"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">byte-regexp: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: bytes?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: "ap*le"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp%29%29" class="RktValLink" data-pltdoc="x">byte-regexp</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"+"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("`+` follows nothing in pattern")</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.5.0.1 of package <span class="stt">base</span>: Added the <span class="RktVar">handler</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._byte-pregexp))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-pregexp%29%29" class="RktValDef RktValLink" data-pltdoc="x">byte-pregexp</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-pregexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-pregexp?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-pregexp%29%29" class="RktValDef RktValLink" data-pltdoc="x">byte-pregexp</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktVar">handler</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">handler</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp%29%29" class="RktValLink" data-pltdoc="x">byte-regexp</a></span>, except that it uses a slightly different
+syntax (see <a href="regexp.html#%28part._regexp-syntax%29" data-pltdoc="x">Regexp Syntax</a>). The result can be used with
+<span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span>, etc., just like the result from
+<span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp%29%29" class="RktValLink" data-pltdoc="x">byte-regexp</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-pregexp%29%29" class="RktValLink" data-pltdoc="x">byte-pregexp</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"ap*le"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#px#"ap*le"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-pregexp%29%29" class="RktValLink" data-pltdoc="x">byte-pregexp</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"+"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#("`+` follows nothing in pattern")</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.5.0.1 of package <span class="stt">base</span>: Added the <span class="RktVar">handler</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._regexp-quote))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-quote%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-quote</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">case-sensitive?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">case-sensitive?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-quote%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-quote</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">case-sensitive?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">case-sensitive?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a string or byte string suitable for use with <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp%29%29" class="RktValLink" data-pltdoc="x">regexp</a></span>
+to match the literal sequence of characters in <span class="RktVar">str</span> or
+sequence of bytes in <span class="RktVar">bstr</span>. If <span class="RktVar">case-sensitive?</span> is
+true (the default), the resulting regexp matches letters in
+<span class="RktVar">str</span> or <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span> case-sensitively, otherwise it matches
+case-insensitively.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"."</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple.scm"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("a")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-quote%29%29" class="RktValLink" data-pltdoc="x">regexp-quote</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"."</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple.scm"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(".")</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._regexp-max-lookbehind))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-max-lookbehind%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-max-lookbehind</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the maximum number of bytes that <span class="RktVar">pattern</span> may consult
+before the starting position of a match to determine the match. For
+example, the pattern <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?&lt;=abc)d</span><span class="hspace"></span></span> consults three bytes
+preceding a matching <span class="RktInBG"><span class="hspace"></span><span class="RktIn">d</span><span class="hspace"></span></span>, while <span class="RktInBG"><span class="hspace"></span><span class="RktIn">e(?&lt;=a..)d</span><span class="hspace"></span></span> consults
+two bytes before a matching <span class="RktInBG"><span class="hspace"></span><span class="RktIn">ed</span><span class="hspace"></span></span>. A <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span> pattern may
+consult a preceding byte to determine whether the current position is
+the start of the input or of a line.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Regexp_Matching&quot;">4.8.4<tt>&nbsp;</tt><a name="(part._.Regexp_.Matching)"></a>Regexp Matching</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._regexp-match))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-match</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pattern</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">output-port</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input-prefix</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">input</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">input</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">output-port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input-prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#""</span></td></tr></table></blockquote></div><div class="SIntrapara">Attempts to match <span class="RktVar">pattern</span> (a string, byte string,
+<a href="regexp.html#%28tech._regexp._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp value</span></a>, or byte-<a href="regexp.html#%28tech._regexp._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp value</span></a>) once to a portion of
+<span class="RktVar">input</span>.  The matcher finds a portion of <span class="RktVar">input</span> that
+matches and is closest to the start of the input (after
+<span class="RktVar">start-pos</span>).</div></p><p>If <span class="RktVar">input</span> is a path, it is converted to a byte string with
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3ebytes%29%29" class="RktValLink" data-pltdoc="x">path-&gt;bytes</a></span> if <span class="RktVar">pattern</span> is a byte string or a
+byte-based regexp. Otherwise, <span class="RktVar">input</span> is converted to a string
+with <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3estring%29%29" class="RktValLink" data-pltdoc="x">path-&gt;string</a></span>.</p><p>The optional <span class="RktVar">start-pos</span> and <span class="RktVar">end-pos</span> arguments select
+a portion of <span class="RktVar">input</span> for matching; the default is the entire
+string or the stream up to an end-of-file. When <span class="RktVar">input</span> is a
+string, <span class="RktVar">start-pos</span> is a character position; when
+<span class="RktVar">input</span> is a byte string, then <span class="RktVar">start-pos</span> is a byte
+position; and when <span class="RktVar">input</span> is an input port, <span class="RktVar">start-pos</span>
+is the number of bytes to skip before starting to match. The
+<span class="RktVar">end-pos</span> argument can be <span class="RktVal">#f</span>, which corresponds to the
+end of the string or an end-of-file in the stream; otherwise, it is a
+character or byte position, like <span class="RktVar">start-pos</span>. If <span class="RktVar">input</span>
+is an input port, and if an end-of-file is reached before
+<span class="RktVar">start-pos</span> bytes are skipped, then the match fails.</p><p>In <span class="RktVar">pattern</span>, a start-of-string <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span> refers to the first
+position of <span class="RktVar">input</span> after <span class="RktVar">start-pos</span>, assuming that
+<span class="RktVar">input-prefix</span> is <span class="RktVal">#""</span>.  The end-of-input <span class="RktInBG"><span class="hspace"></span><span class="RktIn">$</span><span class="hspace"></span></span>
+refers to the <span class="RktVar">end-pos</span>th position or (in the case of an input
+port) an end-of-file, whichever comes first.</p><p>The <span class="RktVar">input-prefix</span> specifies bytes that effectively precede
+<span class="RktVar">input</span> for the purposes of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span> and other look-behind
+matching. For example, a <span class="RktVal">#""</span> prefix means that <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span>
+matches at the beginning of the stream, while a <span class="RktVal">#"\n"</span>
+<span class="RktVar">input-prefix</span> means that a start-of-line <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span> can match
+the beginning of the input, while a start-of-file <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span> cannot.</p><p>If the match fails, <span class="RktVal">#f</span> is returned. If the match succeeds, a
+list containing strings or byte string, and possibly <span class="RktVal">#f</span>, is
+returned. The list contains strings only if <span class="RktVar">input</span> is a string
+and <span class="RktVar">pattern</span> is not a byte regexp. Otherwise, the list
+contains byte strings (substrings of the UTF-8 encoding of
+<span class="RktVar">input</span>, if <span class="RktVar">input</span> is a string).</p><p>The first [byte] string in a result list is the portion of
+<span class="RktVar">input</span> that matched <span class="RktVar">pattern</span>. If two portions of
+<span class="RktVar">input</span> can match <span class="RktVar">pattern</span>, then the match that starts
+earliest is found.</p><p>Additional [byte] strings are returned in the list if <span class="RktVar">pattern</span>
+contains parenthesized sub-expressions (but not when the opening
+parenthesis is followed by <span class="RktInBG"><span class="hspace"></span><span class="RktIn">?</span><span class="hspace"></span></span>). Matches for the
+sub-expressions are provided in the order of the opening parentheses
+in <span class="RktVar">pattern</span>. When sub-expressions occur in branches of an
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span> &ldquo;or&rdquo; pattern, in a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">*</span><span class="hspace"></span></span> &ldquo;zero or more&rdquo;
+pattern, or other places where the overall pattern can succeed without
+a match for the sub-expression, then a <span class="RktVal">#f</span> is returned for the
+sub-expression if it did not contribute to the final match. When a
+single sub-expression occurs within a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">*</span><span class="hspace"></span></span> &ldquo;zero or more&rdquo;
+pattern or other multiple-match positions, then the rightmost match
+associated with the sub-expression is returned in the list.</p><p>If the optional <span class="RktVar">output-port</span> is provided as an output port,
+the part of <span class="RktVar">input</span> from its beginning (not <span class="RktVar">start-pos</span>)
+that precedes the match is written to the port. All of <span class="RktVar">input</span>
+up to <span class="RktVar">end-pos</span> is written to the port if no match is
+found. This functionality is most useful when <span class="RktVar">input</span> is an
+input port.</p><p>When matching an input port, a match failure reads up to
+<span class="RktVar">end-pos</span> bytes (or end-of-file), even if <span class="RktVar">pattern</span>
+begins with a start-of-string <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span>; see also
+<span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-try-match%29%29" class="RktValLink" data-pltdoc="x">regexp-try-match</a></span>. On success, all bytes up to and including
+the match are eventually read from the port, but matching proceeds by
+first peeking bytes from the port (using <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-bytes-avail%21%29%29" class="RktValLink" data-pltdoc="x">peek-bytes-avail!</a></span>),
+and then (re&#8209;)reading matching bytes to discard them after the match
+result is determined. Non-matching bytes may be read and discarded
+before the match is determined. The matcher peeks in blocking mode
+only as far as necessary to determine a match, but it may peek extra
+bytes to fill an internal buffer if immediately available (i.e.,
+without blocking). Greedy repeat operators in <span class="RktVar">pattern</span>, such
+as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">*</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span>, tend to force reading the entire
+content of the port (up to <span class="RktVar">end-pos</span>) to determine a match.</p><p>If the input port is read simultaneously by another thread, or if the
+port is a custom port with inconsistent reading and peeking procedures
+(see <a href="customport.html" data-pltdoc="x">Custom Ports</a>), then the bytes that are peeked and
+used for matching may be different than the bytes read and discarded
+after the match completes; the matcher inspects only the peeked
+bytes. To avoid such interleaving, use <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek%29%29" class="RktValLink" data-pltdoc="x">regexp-match-peek</a></span>
+(with a <span class="RktSym">progress-evt</span> argument) followed by
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-commit-peeked%29%29" class="RktValLink" data-pltdoc="x">port-commit-peeked</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"x."</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("x4")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"y."</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"x."</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("x6")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"x."</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx#"x."</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#"x4")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"x."</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">12</span></p></td></tr><tr><td><p><span class="RktRes">'("x4")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"(-[0-9]*)+"</span><span class="hspace">&nbsp;</span><span class="RktVal">"a-12--345b"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("-12--345" "-345")</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._regexp-match*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-match*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pattern</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input-prefix</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:match-select</span><span class="hspace">&nbsp;</span><span class="RktVar">match-select</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:gap-select?</span><span class="hspace">&nbsp;</span><span class="RktVar">gap-select</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">input</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">input</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input-prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#""</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">match-select</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">gap-select</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span>, but the result is a list of strings or
+byte strings corresponding to a sequence of matches of
+<span class="RktVar">pattern</span> in <span class="RktVar">input</span>.</div></p><p>The <span class="RktVar">pattern</span> is used in order to find matches, where each
+match attempt starts at the end of the last match, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span> is
+allowed to match the beginning of the input (if <span class="RktVar">input-prefix</span>
+is <span class="RktVal">#""</span>) only for the first match.  Empty matches are handled
+like other matches, returning a zero-length string or byte sequence
+(they are more useful in making this a complement of
+<span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-split%29%29" class="RktValLink" data-pltdoc="x">regexp-split</a></span>), but <span class="RktVar">pattern</span> is restricted from
+matching an empty sequence immediately after an empty match.</p><p>If <span class="RktVar">input</span> contains no matches (in the range <span class="RktVar">start-pos</span>
+to <span class="RktVar">end-pos</span>), <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span> is returned. Otherwise, each item
+in the resulting list is a distinct substring or byte sequence from
+<span class="RktVar">input</span> that matches <span class="RktVar">pattern</span>. The <span class="RktVar">end-pos</span>
+argument can be <span class="RktVal">#f</span> to match to the end of <span class="RktVar">input</span>
+(which corresponds to an end-of-file if <span class="RktVar">input</span> is an input
+port).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match%2A%29%29" class="RktValLink" data-pltdoc="x">regexp-match*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"x."</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("x4" "x6")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match%2A%29%29" class="RktValLink" data-pltdoc="x">regexp-match*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"x*"</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("" "" "x" "" "x" "" "")</span></p></td></tr></table></blockquote></div></p><p><span class="RktVar">match-select</span> specifies the collected results.  The default of
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> means that the result is the list of matches without
+returning parenthesized sub-patterns.  It can be given as a &lsquo;selector&rsquo;
+function which chooses an item from a list, or it can choose a list of
+items.  For example, you can use <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> to get a list of lists
+of parenthesized sub-patterns matches, or <span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span> (as an
+identity function) to get the full matches as well.  (Note that the
+selector must choose an element of its input list or a list of
+elements, but it must not inspect its input as they can be either a
+list of strings or a list of position pairs.  Furthermore, the
+selector must be consistent in its choice(s).)</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match%2A%29%29" class="RktValLink" data-pltdoc="x">regexp-match*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"x(.)"</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:match-select</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadr%29%29" class="RktValLink" data-pltdoc="x">cadr</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("4" "6")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match%2A%29%29" class="RktValLink" data-pltdoc="x">regexp-match*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"x(.)"</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:match-select</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(("x4" "4") ("x6" "6"))</span></p></td></tr></table></blockquote></div></p><p>In addition, specifying <span class="RktVar">gap-select</span> as a non-<span class="RktVal">#f</span> value
+will make the result an interleaved list of the matches as well as the
+separators between them matches, starting and ending with a separator.
+In this case, <span class="RktVar">match-select</span> can be given as <span class="RktVal">#f</span> to
+return <span class="emph">only</span> the separators, making such uses equivalent to
+<span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-split%29%29" class="RktValLink" data-pltdoc="x">regexp-split</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match%2A%29%29" class="RktValLink" data-pltdoc="x">regexp-match*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"x(.)"</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:match-select</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadr%29%29" class="RktValLink" data-pltdoc="x">cadr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:gap-select?</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("12" "4" "" "6" "")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match%2A%29%29" class="RktValLink" data-pltdoc="x">regexp-match*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"x(.)"</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:match-select</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">#:gap-select?</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("12" "" "")</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._regexp-try-match))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-try-match%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-try-match</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pattern</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">output-port</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input-prefix</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">output-port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input-prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#""</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span> on input ports, except that if the match
+fails, no characters are read and discarded from <span class="RktSym">in</span>.</div></p><p>This procedure is especially useful with a <span class="RktVar">pattern</span> that
+begins with a start-of-string <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span> or with a non-<span class="RktVal">#f</span>
+<span class="RktVar">end-pos</span>, since each limits the amount of peeking into the
+port. Otherwise, beware that a large portion of the stream may be
+peeked (and therefore pulled into memory) before the match succeeds or
+fails.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._regexp-match-positions))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-positions%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-match-positions</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pattern</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">output-port</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input-prefix</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">output-port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input-prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#""</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span>, but returns a list of number pairs (and
+<span class="RktVal">#f</span>) instead of a list of strings. Each pair of numbers refers
+to a range of characters or bytes in <span class="RktVar">input</span>. If the result for
+the same arguments with <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span> would be a list of byte
+strings, the resulting ranges correspond to byte ranges; in that case,
+if <span class="RktVar">input</span> is a character string, the byte ranges correspond to
+bytes in the UTF-8 encoding of the string.</div></p><p>Range results are returned in a <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._substring%29%29" class="RktValLink" data-pltdoc="x">substring</a></span>- and
+<span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._subbytes%29%29" class="RktValLink" data-pltdoc="x">subbytes</a></span>-compatible manner, independent of
+<span class="RktVar">start-pos</span>. In the case of an input port, the returned
+positions indicate the number of bytes that were read, including
+<span class="RktVar">start-pos</span>, before the first matching byte.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-positions%29%29" class="RktValLink" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"x."</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((2 . 4))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-positions%29%29" class="RktValLink" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"x."</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((4 . 6))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-positions%29%29" class="RktValLink" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"(-[0-9]*)+"</span><span class="hspace">&nbsp;</span><span class="RktVal">"a-12--345b"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((1 . 9) (5 . 9))</span></p></td></tr></table></blockquote></div></p><p>Range results after the first one can include negative numbers if
+<span class="RktVar">input-prefix</span> is non-empty and if <span class="RktVar">pattern</span> includes a
+lookbehind pattern. Such ranges start in the <span class="RktVar">input-prefix</span>
+instead of <span class="RktVar">input</span>. More generally, when <span class="RktVar">start-pos</span> is
+positive, then range results that are less than <span class="RktVar">start-pos</span>
+start in <span class="RktVar">input-prefix</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-positions%29%29" class="RktValLink" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"(?&lt;=(.))."</span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#"x"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((0 . 1) (-1 . 0))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-positions%29%29" class="RktValLink" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"(?&lt;=(..))."</span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#"x"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-positions%29%29" class="RktValLink" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"(?&lt;=(..))."</span><span class="hspace">&nbsp;</span><span class="RktVal">"_a"</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#"x"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p>Although <span class="RktVar">input-prefix</span> is always a byte string, when the
+returned positions are string indices and they refer to a portion of
+<span class="RktVar">input-prefix</span>, then they correspond to a UTF-8 decoding of
+a tail of <span class="RktVar">input-prefix</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Futf-8%29%29" class="RktValLink" data-pltdoc="x">string-&gt;bytes/utf-8</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"&#955;"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-positions%29%29" class="RktValLink" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"(?&lt;=(.))."</span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Futf-8%29%29" class="RktValLink" data-pltdoc="x">string-&gt;bytes/utf-8</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"&#955;"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((0 . 1) (-1 . 0))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._regexp-match-positions*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match-positions%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-match-positions*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pattern</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input-prefix</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:match-select</span><span class="hspace">&nbsp;</span><span class="RktVar">match-select</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input-prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#""</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">match-select</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-positions%29%29" class="RktValLink" data-pltdoc="x">regexp-match-positions</a></span>, but returns multiple matches
+like <span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match%2A%29%29" class="RktValLink" data-pltdoc="x">regexp-match*</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match-positions%2A%29%29" class="RktValLink" data-pltdoc="x">regexp-match-positions*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"x."</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((2 . 4) (4 . 6))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match-positions%2A%29%29" class="RktValLink" data-pltdoc="x">regexp-match-positions*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"x(.)"</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:match-select</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadr%29%29" class="RktValLink" data-pltdoc="x">cadr</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((3 . 4) (5 . 6))</span></p></td></tr></table></blockquote></div></p><p>Note that unlike <span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match%2A%29%29" class="RktValLink" data-pltdoc="x">regexp-match*</a></span>, there is no
+<span class="RktPn">#:gap-select?</span> input keyword, as this information can be easily
+inferred from the resulting matches.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._regexp-match~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-match?</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pattern</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">output-port</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input-prefix</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">output-port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input-prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#""</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span>, but returns merely <span class="RktVal">#t</span> when the
+match succeeds, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match~3f%29%29" class="RktValLink" data-pltdoc="x">regexp-match?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"x."</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match~3f%29%29" class="RktValLink" data-pltdoc="x">regexp-match?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"y."</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._regexp-match-exact~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match-exact~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-match-exact?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktVar">input</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match~3f%29%29" class="RktValLink" data-pltdoc="x">regexp-match?</a></span>, but <span class="RktVal">#t</span> is only returned when the
+first found match is to the entire content of <span class="RktVar">input</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match-exact~3f%29%29" class="RktValLink" data-pltdoc="x">regexp-match-exact?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"x."</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match-exact~3f%29%29" class="RktValLink" data-pltdoc="x">regexp-match-exact?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"1.*x."</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p>Beware that <span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match-exact~3f%29%29" class="RktValLink" data-pltdoc="x">regexp-match-exact?</a></span> can return <span class="RktVal">#f</span> if
+<span class="RktVar">pattern</span> generates a partial match for <span class="RktVar">input</span> first, even if
+<span class="RktVar">pattern</span> could also generate a complete match. To check if there is any
+match of <span class="RktVar">pattern</span> that covers all of <span class="RktVar">input</span>, use
+<span class="RktSym">rexexp-match?</span> with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^(?:</span><span class="hspace"></span></span><span class="RktVar">pattern</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)$</span><span class="hspace"></span></span>
+instead.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match-exact~3f%29%29" class="RktValLink" data-pltdoc="x">regexp-match-exact?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"a|ab"</span><span class="hspace">&nbsp;</span><span class="RktVal">"ab"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match~3f%29%29" class="RktValLink" data-pltdoc="x">regexp-match?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"^(?:a|ab)$"</span><span class="hspace">&nbsp;</span><span class="RktVal">"ab"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?:)</span><span class="hspace"></span></span> grouping is necessary because concatenation has
+lower precedence than alternation; the regular expression without it,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">^a|ab$</span><span class="hspace"></span></span>, matches any input that either starts with
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span> or ends with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">ab</span><span class="hspace"></span></span>.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match~3f%29%29" class="RktValLink" data-pltdoc="x">regexp-match?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"^a|ab$"</span><span class="hspace">&nbsp;</span><span class="RktVal">"123ab"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._regexp-match-peek))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-match-peek</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pattern</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">progress</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input-prefix</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">progress</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input-prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#""</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span> on input ports, but only peeks bytes from
+<span class="RktVar">input</span> instead of reading them. Furthermore, instead of
+an output port, the last optional argument is a progress event for
+<span class="RktVar">input</span> (see <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._port-progress-evt%29%29" class="RktValLink" data-pltdoc="x">port-progress-evt</a></span>). If <span class="RktVar">progress</span>
+becomes ready, then the match stops peeking from <span class="RktVar">input</span>
+and returns <span class="RktVal">#f</span>. The <span class="RktVar">progress</span> argument can be
+<span class="RktVal">#f</span>, in which case the peek may continue with inconsistent
+information if another process meanwhile reads from
+<span class="RktVar">input</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a abcd"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek%29%29" class="RktValLink" data-pltdoc="x">regexp-match-peek</a></span><span class="hspace">&nbsp;</span><span class="RktVal">".*bc"</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#"a abc")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek%29%29" class="RktValLink" data-pltdoc="x">regexp-match-peek</a></span><span class="hspace">&nbsp;</span><span class="RktVal">".*bc"</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#"abc")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">".*bc"</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#"abc")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-char%29%29" class="RktValLink" data-pltdoc="x">peek-char</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\d</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">".*bc"</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._peek-char%29%29" class="RktValLink" data-pltdoc="x">peek-char</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;eof&gt;</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._regexp-match-peek-positions))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek-positions%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-match-peek-positions</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pattern</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">progress</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input-prefix</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">progress</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input-prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#""</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-positions%29%29" class="RktValLink" data-pltdoc="x">regexp-match-positions</a></span> on input ports, but only peeks
+bytes from <span class="RktVar">input</span> instead of reading them, and with a
+<span class="RktVar">progress</span> argument like <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek%29%29" class="RktValLink" data-pltdoc="x">regexp-match-peek</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._regexp-match-peek-immediate))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek-immediate%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-match-peek-immediate</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pattern</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">progress</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input-prefix</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">progress</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input-prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#""</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek%29%29" class="RktValLink" data-pltdoc="x">regexp-match-peek</a></span>, but it attempts to match only bytes
+that are available from <span class="RktVar">input</span> without blocking.  The
+match fails if not-yet-available characters might be used to match
+<span class="RktVar">pattern</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._regexp-match-peek-positions-immediate))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek-positions-immediate%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-match-peek-positions-immediate</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pattern</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">progress</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input-prefix</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">progress</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input-prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#""</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek-positions%29%29" class="RktValLink" data-pltdoc="x">regexp-match-peek-positions</a></span>, but it attempts to match
+only bytes that are available from <span class="RktVar">input</span> without
+blocking. The match fails if not-yet-available characters might be
+used to match <span class="RktVar">pattern</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._regexp-match-peek-positions*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match-peek-positions%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-match-peek-positions*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pattern</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input-prefix</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:match-select</span><span class="hspace">&nbsp;</span><span class="RktVar">match-select</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input-prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#""</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">match-select</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek-positions%29%29" class="RktValLink" data-pltdoc="x">regexp-match-peek-positions</a></span>, but returns multiple matches like
+<span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match-positions%2A%29%29" class="RktValLink" data-pltdoc="x">regexp-match-positions*</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._regexp-match/end))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%2Fend%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-match/end</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pattern</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">output-port</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input-prefix</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">count</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">input</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">input</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">output-port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input-prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#""</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">count</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span>, but with a second result: a byte
+string of up to <span class="RktVar">count</span> bytes that correspond to the input
+(possibly including the <span class="RktVar">input-prefix</span>) leading to the end of
+the match; the second result is <span class="RktVal">#f</span> if no match is found.</div></p><p>The second result can be useful as an <span class="RktVar">input-prefix</span> for
+attempting a second match on <span class="RktVar">input</span> starting from the end of
+the first match. In that case, use <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-max-lookbehind%29%29" class="RktValLink" data-pltdoc="x">regexp-max-lookbehind</a></span>
+to determine an appropriate value for <span class="RktVar">count</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._regexp-match-positions/end))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-positions%2Fend%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-match-positions/end</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pattern</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input-prefix</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">count</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input-prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#""</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">count</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._regexp-match-peek-positions/end))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek-positions%2Fend%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-match-peek-positions/end</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pattern</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">progress</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input-prefix</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">count</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">progress</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input-prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#""</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">count</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._regexp-match-peek-positions-immediate/end))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-peek-positions-immediate%2Fend%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-match-peek-positions-immediate/end</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pattern</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">progress</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input-prefix</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">count</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">progress</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input-prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#""</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">count</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match-positions%29%29" class="RktValLink" data-pltdoc="x">regexp-match-positions</a></span>, etc., but with a second result
+like <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%2Fend%29%29" class="RktValLink" data-pltdoc="x">regexp-match/end</a></span>.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Regexp_Splitting&quot;">4.8.5<tt>&nbsp;</tt><a name="(part._.Regexp_.Splitting)"></a>Regexp Splitting</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._regexp-split))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-split%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-split</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pattern</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input-prefix</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">input</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input-prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#""</span></td></tr></table></blockquote></div><div class="SIntrapara">The complement of <span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match%2A%29%29" class="RktValLink" data-pltdoc="x">regexp-match*</a></span>: the result is a list of
+strings (if <span class="RktVar">pattern</span> is a string or character regexp and
+<span class="RktVar">input</span> is a string) or byte strings (otherwise) from
+<span class="RktVar">input</span> that are separated by matches to
+<span class="RktVar">pattern</span>. Adjacent matches are separated with <span class="RktVal">""</span> or
+<span class="RktVal">#""</span>. Zero-length matches are treated the same as for
+<span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match%2A%29%29" class="RktValLink" data-pltdoc="x">regexp-match*</a></span>.</div></p><p>If <span class="RktVar">input</span> contains no matches (in the range <span class="RktVar">start-pos</span>
+to <span class="RktVar">end-pos</span>), the result is a list containing <span class="RktVar">input</span>&rsquo;s
+content (from <span class="RktVar">start-pos</span> to <span class="RktVar">end-pos</span>) as a single
+element. If a match occurs at the beginning of <span class="RktVar">input</span> (at
+<span class="RktVar">start-pos</span>), the resulting list will start with an empty
+string or byte string, and if a match occurs at the end (at
+<span class="RktVar">end-pos</span>), the list will end with an empty string or byte
+string. The <span class="RktVar">end-pos</span> argument can be <span class="RktVal">#f</span>, in which
+case splitting goes to the end of <span class="RktVar">input</span> (which corresponds to
+an end-of-file if <span class="RktVar">input</span> is an input port).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-split%29%29" class="RktValLink" data-pltdoc="x">regexp-split</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx" +"</span><span class="hspace">&nbsp;</span><span class="RktVal">"12</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">34"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("12" "34")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-split%29%29" class="RktValLink" data-pltdoc="x">regexp-split</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"."</span><span class="hspace">&nbsp;</span><span class="RktVal">"12</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">34"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("" "" "" "" "" "" "")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-split%29%29" class="RktValLink" data-pltdoc="x">regexp-split</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx""</span><span class="hspace">&nbsp;</span><span class="RktVal">"12</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">34"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("" "1" "2" " " " " "3" "4" "")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-split%29%29" class="RktValLink" data-pltdoc="x">regexp-split</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx" *"</span><span class="hspace">&nbsp;</span><span class="RktVal">"12</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">34"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("" "1" "2" "" "3" "4" "")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-split%29%29" class="RktValLink" data-pltdoc="x">regexp-split</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"\\b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"12, 13 and 14."</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("" "12" ", " "13" " " "and" " " "14" ".")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-split%29%29" class="RktValLink" data-pltdoc="x">regexp-split</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx" +"</span><span class="hspace">&nbsp;</span><span class="RktVal">""</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("")</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Regexp_Substitution&quot;">4.8.6<tt>&nbsp;</tt><a name="(part._.Regexp_.Substitution)"></a>Regexp Substitution</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._regexp-replace))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-replace%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-replace</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pattern</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">insert</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">input-prefix</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">input</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">insert</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input-prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#""</span></td></tr></table></blockquote></div><div class="SIntrapara">Performs a match using <span class="RktVar">pattern</span> on <span class="RktVar">input</span>, and then
+returns a string or byte string in which the matching portion of
+<span class="RktVar">input</span> is replaced with <span class="RktVar">insert</span>.  If <span class="RktVar">pattern</span>
+matches no part of <span class="RktVar">input</span>, then <span class="RktVar">input</span> is returned
+unmodified.</div></p><p>The <span class="RktVar">insert</span> argument can be either a (byte) string, or a
+function that returns a (byte) string. In the latter case, the
+function is applied on the list of values that <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match%29%29" class="RktValLink" data-pltdoc="x">regexp-match</a></span>
+would return (i.e., the first argument is the complete match, and then
+one argument for each parenthesized sub-expression) to obtain a
+replacement (byte) string.</p><p>If <span class="RktVar">pattern</span> is a string or character regexp and <span class="RktVar">input</span>
+is a string, then <span class="RktVar">insert</span> must be a string or a procedure that
+accept strings, and the result is a string. If <span class="RktVar">pattern</span> is a
+byte string or byte regexp, or if <span class="RktVar">input</span> is a byte string,
+then <span class="RktVar">insert</span> as a string is converted to a byte string,
+<span class="RktVar">insert</span> as a procedure is called with a byte string, and the
+result is a byte string.</p><p>If <span class="RktVar">insert</span> contains <span class="RktInBG"><span class="hspace"></span><span class="RktIn">&amp;</span><span class="hspace"></span></span>, then <span class="RktInBG"><span class="hspace"></span><span class="RktIn">&amp;</span><span class="hspace"></span></span>
+is replaced with the matching portion of <span class="RktVar">input</span> before it is
+substituted into the match&rsquo;s place.  If <span class="RktVar">insert</span> contains
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span> for some integer <span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span>, then it is
+replaced with the <span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span>th matching sub-expression from
+<span class="RktVar">input</span>. A <span class="RktInBG"><span class="hspace"></span><span class="RktIn">&amp;</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\0</span><span class="hspace"></span></span> are aliases. If
+the <span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span>th sub-expression was not used in the match, or if
+<span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span> is greater than the number of sub-expressions in
+<span class="RktVar">pattern</span>, then <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span> is replaced with the
+empty string.</p><p>To substitute a literal <span class="RktInBG"><span class="hspace"></span><span class="RktIn">&amp;</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>, use
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\&amp;</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\</span><span class="hspace"></span></span>, respectively, in
+<span class="RktVar">insert</span>. A <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\$</span><span class="hspace"></span></span> in <span class="RktVar">insert</span> is
+equivalent to an empty sequence; this can be used to terminate a
+number <span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span> following <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>. If a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> in
+<span class="RktVar">insert</span> is followed by anything other than a digit,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">&amp;</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">$</span><span class="hspace"></span></span>, then the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>
+by itself is treated as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\0</span><span class="hspace"></span></span>.</p><p>Note that the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> described in the previous paragraphs is a
+character or byte of <span class="RktVar">insert</span>. To write such an <span class="RktVar">insert</span>
+as a Racket string literal, an escaping <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> is needed
+before the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>. For example, the Racket constant
+<span class="RktVal">"\\1"</span> is <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\1</span><span class="hspace"></span></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-replace%29%29" class="RktValLink" data-pltdoc="x">regexp-replace</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"mi"</span><span class="hspace">&nbsp;</span><span class="RktVal">"mi casa"</span><span class="hspace">&nbsp;</span><span class="RktVal">"su"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"su casa"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-replace%29%29" class="RktValLink" data-pltdoc="x">regexp-replace</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"mi"</span><span class="hspace">&nbsp;</span><span class="RktVal">"mi casa"</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-upcase%29%29" class="RktValLink" data-pltdoc="x">string-upcase</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"MI casa"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-replace%29%29" class="RktValLink" data-pltdoc="x">regexp-replace</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"([Mm])i ([a-zA-Z]*)"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Mi Casa"</span><span class="hspace">&nbsp;</span><span class="RktVal">"\\1y \\2"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"My Casa"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-replace%29%29" class="RktValLink" data-pltdoc="x">regexp-replace</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"([Mm])i ([a-zA-Z]*)"</span><span class="hspace">&nbsp;</span><span class="RktVal">"mi cerveza Mi Mi Mi"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"\\1y \\2"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"my cerveza Mi Mi Mi"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-replace%29%29" class="RktValLink" data-pltdoc="x">regexp-replace</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"x"</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="hspace">&nbsp;</span><span class="RktVal">"\\\\"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"12\\4x6"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-replace%29%29" class="RktValLink" data-pltdoc="x">regexp-replace</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"x"</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="hspace">&nbsp;</span><span class="RktVal">"\\\\"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">12\4x6</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._regexp-replace*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-replace%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-replace*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pattern</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">insert</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">input-prefix</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">insert</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input-prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#""</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-replace%29%29" class="RktValLink" data-pltdoc="x">regexp-replace</a></span>, except that every instance of
+<span class="RktVar">pattern</span> in <span class="RktVar">input</span> is replaced with <span class="RktVar">insert</span>,
+instead of just the first match. The result is <span class="RktVar">input</span> only if
+there are no matches, <span class="RktVar">start-pos</span> is <span class="RktVal">0</span>, and
+<span class="RktVar">end-pos</span> is <span class="RktVal">#f</span> or the length of <span class="RktVar">input</span>.
+Only non-overlapping instances of
+<span class="RktVar">pattern</span> in <span class="RktVar">input</span> are replaced, so instances of
+<span class="RktVar">pattern</span> within inserted strings are <span style="font-style: italic">not</span> replaced
+recursively. Zero-length matches are treated the same as in
+<span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-match%2A%29%29" class="RktValLink" data-pltdoc="x">regexp-match*</a></span>.</div></p><p>The optional <span class="RktVar">start-pos</span> and <span class="RktVar">end-pos</span> arguments select
+a portion of <span class="RktVar">input</span> for matching; the default is the entire
+string or the stream up to an end-of-file.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-replace%2A%29%29" class="RktValLink" data-pltdoc="x">regexp-replace*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"([Mm])i ([a-zA-Z]*)"</span><span class="hspace">&nbsp;</span><span class="RktVal">"mi cerveza Mi Mi Mi"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"\\1y \\2"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"my cerveza My Mi Mi"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-replace%2A%29%29" class="RktValLink" data-pltdoc="x">regexp-replace*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"([Mm])i ([a-zA-Z]*)"</span><span class="hspace">&nbsp;</span><span class="RktVal">"mi cerveza Mi Mi Mi"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">all</span><span class="hspace">&nbsp;</span><span class="RktSym">one</span><span class="hspace">&nbsp;</span><span class="RktSym">two</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append%29%29" class="RktValLink" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-downcase%29%29" class="RktValLink" data-pltdoc="x">string-downcase</a></span><span class="hspace">&nbsp;</span><span class="RktSym">one</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"y"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-upcase%29%29" class="RktValLink" data-pltdoc="x">string-upcase</a></span><span class="hspace">&nbsp;</span><span class="RktSym">two</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"myCERVEZA myMI Mi"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-replace%2A%29%29" class="RktValLink" data-pltdoc="x">regexp-replace*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"\\w"</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello world"</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-upcase%29%29" class="RktValLink" data-pltdoc="x">string-upcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"HELLO world"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-replace%2A%29%29" class="RktValLink" data-pltdoc="x">regexp-replace*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"x"</span><span class="hspace">&nbsp;</span><span class="RktVal">"12x4x6"</span><span class="hspace">&nbsp;</span><span class="RktVal">"\\\\"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">12\4\6</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 8.1.0.7 of package <span class="stt">base</span>: Changed to return <span class="RktVar">input</span> when no
+replacements are performed.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._regexp-replaces))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-replaces%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-replaces</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">input</span><span class="hspace">&nbsp;</span><span class="RktVar">replacements</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">replacements</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._byte-regexp~3f%29%29" class="RktValLink" data-pltdoc="x">byte-regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Performs a chain of <span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-replace%2A%29%29" class="RktValLink" data-pltdoc="x">regexp-replace*</a></span> operations, where each
+element in <span class="RktVar">replacements</span> specifies a replacement as a
+<span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktSym">pattern</span><span class="stt"> </span><span class="RktSym">replacement</span><span class="RktPn">)</span>.  The replacements are done in
+order, so later replacements can apply to previous insertions.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-replaces%29%29" class="RktValLink" data-pltdoc="x">regexp-replaces</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"zero-or-more?"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">[</span><span class="RktVal">#rx"-"</span><span class="hspace">&nbsp;</span><span class="RktVal">"_"</span><span class="RktVal">]</span><span class="hspace">&nbsp;</span><span class="RktVal">[</span><span class="RktVal">#rx"(.*)\\?$"</span><span class="hspace">&nbsp;</span><span class="RktVal">"is_\\1"</span><span class="RktVal">]</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"is_zero_or_more"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-replaces%29%29" class="RktValLink" data-pltdoc="x">regexp-replaces</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"zero-or-more?"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">[</span><span class="RktVal">#rx"e"</span><span class="hspace">&nbsp;</span><span class="RktVal">"o"</span><span class="RktVal">]</span><span class="hspace">&nbsp;</span><span class="RktVal">[</span><span class="RktVal">#rx"o"</span><span class="hspace">&nbsp;</span><span class="RktVal">"oo"</span><span class="RktVal">]</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"zooroo-oor-mooroo?"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._regexp-replace-quote))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-replace-quote%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-replace-quote</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-replace-quote%29%29" class="RktValDef RktValLink" data-pltdoc="x">regexp-replace-quote</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a string suitable for use as the third argument to
+<span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-replace%29%29" class="RktValLink" data-pltdoc="x">regexp-replace</a></span> to insert the literal sequence of characters
+in <span class="RktVar">str</span> or bytes in <span class="RktVar">bstr</span> as a replacement.
+Concretely, every <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">&amp;</span><span class="hspace"></span></span> in <span class="RktVar">str</span> or
+<span class="RktVar">bstr</span> is protected by a quoting <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-replace%29%29" class="RktValLink" data-pltdoc="x">regexp-replace</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"UT"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Go UT!"</span><span class="hspace">&nbsp;</span><span class="RktVal">"A&amp;M"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Go AUTM!"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-replace%29%29" class="RktValLink" data-pltdoc="x">regexp-replace</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"UT"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Go UT!"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-replace-quote%29%29" class="RktValLink" data-pltdoc="x">regexp-replace-quote</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"A&amp;M"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Go A&amp;M!"</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="symbols.html" title="backward to &quot;4.7 Symbols&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="keywords.html" title="forward to &quot;4.9 Keywords&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/repl-module.html b/clones/docs.racket-lang.org/reference/repl-module.html
new file mode 100644
index 00000000..51902178
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/repl-module.html
@@ -0,0 +1,6 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14.13&nbsp;The racket/repl Library</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewselflink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Namespaces.html" class="tocviewlink" data-pltdoc="x">Namespaces</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="eval.html" class="tocviewlink" data-pltdoc="x">Evaluation and Compilation</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="load-lang.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>load</span></span> Language</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="Module_Names_and_Loading.html" class="tocviewlink" data-pltdoc="x">Module Names and Loading</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="chaperones.html" class="tocviewlink" data-pltdoc="x">Impersonators and Chaperones</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="securityguards.html" class="tocviewlink" data-pltdoc="x">Security Guards</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="custodians.html" class="tocviewlink" data-pltdoc="x">Custodians</a></td></tr><tr><td align="right">14.8&nbsp;</td><td><a href="threadgroups.html" class="tocviewlink" data-pltdoc="x">Thread Groups</a></td></tr><tr><td align="right">14.9&nbsp;</td><td><a href="inspectors.html" class="tocviewlink" data-pltdoc="x">Structure Inspectors</a></td></tr><tr><td align="right">14.10&nbsp;</td><td><a href="modprotect.html" class="tocviewlink" data-pltdoc="x">Code Inspectors</a></td></tr><tr><td align="right">14.11&nbsp;</td><td><a href="plumbers.html" class="tocviewlink" data-pltdoc="x">Plumbers</a></td></tr><tr><td align="right">14.12&nbsp;</td><td><a href="Sandboxed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Sandboxed Evaluation</a></td></tr><tr><td align="right">14.13&nbsp;</td><td><a href="repl-module.html" class="tocviewselflink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>repl</span></span> Library</a></td></tr><tr><td align="right">14.14&nbsp;</td><td><a href="linklets.html" class="tocviewlink" data-pltdoc="x">Linklets and the Core Compiler</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Sandboxed_Evaluation.html" title="backward to &quot;14.12 Sandboxed Evaluation&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="linklets.html" title="forward to &quot;14.14 Linklets and the Core Compiler&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;repl-module&quot;">14.13<tt>&nbsp;</tt><a name="(part._repl-module)"></a><a name="(mod-path._racket/repl)"></a>The <a href="repl-module.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/repl</span></a> Library</h4><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="repl-module.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/repl</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></p><p>The <a href="repl-module.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/repl</span></a> provides the same
+<span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._read-eval-print-loop%29%29" class="RktValLink" data-pltdoc="x">read-eval-print-loop</a></span> binding as <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>, but
+with even fewer internal dependencies than <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>. It is
+loaded in some situations on startup, as described in
+<a href="running-sa.html#%28part._init-actions%29" data-pltdoc="x">Initialization</a>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Sandboxed_Evaluation.html" title="backward to &quot;14.12 Sandboxed Evaluation&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="linklets.html" title="forward to &quot;14.14 Linklets and the Core Compiler&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/require.html b/clones/docs.racket-lang.org/reference/require.html
new file mode 100644
index 00000000..e82a3b2b
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/require.html
@@ -0,0 +1,394 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.2&nbsp;Importing and Exporting: require and provide</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewselflink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>3.2&nbsp;</td><td><a href="require.html" class="tocviewselflink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.2.1&nbsp;</td><td><a href="require.html#%28part._.Additional_require_.Forms%29" class="tocviewlink" data-pltdoc="x">Additional <span class="RktSym"><span class="RktStxLink">require</span></span> Forms</a></td></tr><tr><td align="right">3.2.2&nbsp;</td><td><a href="require.html#%28part._.Additional_provide_.Forms%29" class="tocviewlink" data-pltdoc="x">Additional <span class="RktSym"><span class="RktStxLink">provide</span></span> Forms</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">require</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-in%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">only-<wbr></wbr>in</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._except-in%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">except-<wbr></wbr>in</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prefix-in%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">prefix-<wbr></wbr>in</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._rename-in%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">rename-<wbr></wbr>in</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._combine-in%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">combine-<wbr></wbr>in</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._relative-in%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">relative-<wbr></wbr>in</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-meta-in%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">only-<wbr></wbr>meta-<wbr></wbr>in</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-space-in%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">only-<wbr></wbr>space-<wbr></wbr>in</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">lib</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._file%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">file</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._planet%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">planet</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">submod</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._local-require%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">local-<wbr></wbr>require</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-defined-out%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">all-<wbr></wbr>defined-<wbr></wbr>out</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-from-out%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">all-<wbr></wbr>from-<wbr></wbr>out</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._rename-out%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">rename-<wbr></wbr>out</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._except-out%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">except-<wbr></wbr>out</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prefix-out%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">prefix-<wbr></wbr>out</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-out%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct-<wbr></wbr>out</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._combine-out%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">combine-<wbr></wbr>out</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._protect-out%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">protect-<wbr></wbr>out</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-meta%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for-<wbr></wbr>meta</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-template%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for-<wbr></wbr>template</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-label%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for-<wbr></wbr>label</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-space%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for-<wbr></wbr>space</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25require%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%require</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25provide%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%provide</span></span></a></td></tr><tr><td><span class="tocsublinknumber">3.2.1<tt>&nbsp;</tt></span><a href="require.html#%28part._.Additional_require_.Forms%29" class="tocsubseclink" data-pltdoc="x">Additional <span class="RktSym"><span class="RktStxLink">require</span></span> Forms</a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._matching-identifiers-in%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">matching-<wbr></wbr>identifiers-<wbr></wbr>in</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._subtract-in%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">subtract-<wbr></wbr>in</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._filtered-in%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">filtered-<wbr></wbr>in</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._path-up%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">path-<wbr></wbr>up</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._multi-in%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">multi-<wbr></wbr>in</span></span></a></td></tr><tr><td><span class="tocsublinknumber">3.2.2<tt>&nbsp;</tt></span><a href="require.html#%28part._.Additional_provide_.Forms%29" class="tocsubseclink" data-pltdoc="x">Additional <span class="RktSym"><span class="RktStxLink">provide</span></span> Forms</a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprovide..rkt%29._matching-identifiers-out%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">matching-<wbr></wbr>identifiers-<wbr></wbr>out</span></span></a></td></tr><tr><td><a href="require.html#%28form._%28%28lib._racket%2Fprovide..rkt%29._filtered-out%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">filtered-<wbr></wbr>out</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="module.html" title="backward to &quot;3.1 Modules: module, module*, ...&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="quote.html" title="forward to &quot;3.3 Literals: quote and #%datum&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;require&quot;">3.2<tt>&nbsp;</tt><a name="(part._require)"></a><a name="(part._provide)"></a><a name="(idx._(gentag._104._(lib._scribblings/reference/reference..scrbl)))"></a><a name="(idx._(gentag._105._(lib._scribblings/reference/reference..scrbl)))"></a>Importing and Exporting: <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> and <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span></h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=module-require.html&amp;version=8.6" class="Sq" data-pltdoc="x">Imports: <span class="RktSym"><span class="RktStxLink">require</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._require))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">require</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">require-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">module-path</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-in%29%29" class="RktStxLink" data-pltdoc="x">only-in</a></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktVar">id-maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._except-in%29%29" class="RktStxLink" data-pltdoc="x">except-in</a></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prefix-in%29%29" class="RktStxLink" data-pltdoc="x">prefix-in</a></span><span class="hspace">&nbsp;</span><span class="RktVar">prefix-id</span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._rename-in%29%29" class="RktStxLink" data-pltdoc="x">rename-in</a></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">orig-id</span><span class="hspace">&nbsp;</span><span class="RktVar">bind-id</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._combine-in%29%29" class="RktStxLink" data-pltdoc="x">combine-in</a></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._relative-in%29%29" class="RktStxLink" data-pltdoc="x">relative-in</a></span><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-meta-in%29%29" class="RktStxLink" data-pltdoc="x">only-meta-in</a></span><span class="hspace">&nbsp;</span><span class="RktVar">phase-level</span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-space-in%29%29" class="RktStxLink" data-pltdoc="x">only-space-in</a></span><span class="hspace">&nbsp;</span><span class="RktVar">space</span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-template%29%29" class="RktStxLink" data-pltdoc="x">for-template</a></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-label%29%29" class="RktStxLink" data-pltdoc="x">for-label</a></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-meta%29%29" class="RktStxLink" data-pltdoc="x">for-meta</a></span><span class="hspace">&nbsp;</span><span class="RktVar">phase-level</span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-space%29%29" class="RktStxLink" data-pltdoc="x">for-space</a></span><span class="hspace">&nbsp;</span><span class="RktVar">space</span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">derived-require-spec</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">module-path</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">root-module-path</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxLink" data-pltdoc="x">submod</a></span><span class="hspace">&nbsp;</span><span class="RktVar">root-module-path</span><span class="hspace">&nbsp;</span><span class="RktVar">submod-path-element</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxLink" data-pltdoc="x">submod</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"."</span><span class="hspace">&nbsp;</span><span class="RktVar">submod-path-element</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxLink" data-pltdoc="x">submod</a></span><span class="hspace">&nbsp;</span><span class="RktVal">".."</span><span class="hspace">&nbsp;</span><span class="RktVar">submod-path-element</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">root-module-path</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">rel-string</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span><span class="hspace">&nbsp;</span><span class="RktVar">rel-string</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._file%29%29" class="RktStxLink" data-pltdoc="x">file</a></span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._planet%29%29" class="RktStxLink" data-pltdoc="x">planet</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._planet%29%29" class="RktStxLink" data-pltdoc="x">planet</a></span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._planet%29%29" class="RktStxLink" data-pltdoc="x">planet</a></span><span class="hspace">&nbsp;</span><span class="RktVar">rel-string</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">user-string</span><span class="hspace">&nbsp;</span><span class="RktVar">pkg-string</span><span class="hspace">&nbsp;</span><span class="RktVar">vers</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">rel-string</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">submod-path-element</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVal">".."</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">id-maybe-renamed</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">orig-id</span><span class="hspace">&nbsp;</span><span class="RktVar">bind-id</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">phase-level</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">exact-integer</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVal">#f</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">space</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVal">#f</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">vers</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">nat</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">nat</span><span class="hspace">&nbsp;</span><span class="RktVar">minor-vers</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">minor-vers</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">nat</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">nat</span><span class="hspace">&nbsp;</span><span class="RktVar">nat</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">=</span><span class="hspace">&nbsp;</span><span class="RktVar">nat</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">+</span><span class="hspace">&nbsp;</span><span class="RktVar">nat</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">-</span><span class="hspace">&nbsp;</span><span class="RktVar">nat</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">In a <a href="syntax-model.html#%28tech._top._level._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level context</span></a>, <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiates</span></a>
+modules (see <a href="eval-model.html#%28part._module-eval-model%29" data-pltdoc="x">Modules and Module-Level Variables</a>). In a <a href="syntax-model.html#%28tech._top._level._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level
+context</span></a> or <a href="syntax-model.html#%28tech._module._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">module context</span></a>, expansion of <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>
+<a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visits</span></a> modules (see <a href="syntax-model.html#%28part._mod-parse%29" data-pltdoc="x">Module Expansion, Phases, and Visits</a>). In both contexts and
+both evaluation and expansion, <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> introduces bindings
+into a <a href="syntax-model.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespace</span></a> or a module (see <a href="syntax-model.html#%28part._intro-binding%29" data-pltdoc="x">Introducing Bindings</a>).  A
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> form in a <a href="syntax-model.html#%28tech._expression._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">expression context</span></a> or
+<a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a> is a syntax error.</div></p><p>A <span class="RktVar">require-spec</span> designates a particular set of identifiers to
+be bound in the importing context. Each identifier is mapped to a
+particular export of a particular module; the identifier to bind may
+be different from the symbolic name of the originally exported
+identifier. Each identifier also binds at a particular <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase
+level</span></a> and in a <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a>.</p><p>No identifier can be bound multiple times in a given combination of
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> and <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a> by an import, unless
+all of the bindings refer to the same
+original definition in the same module.  In a <a href="syntax-model.html#%28tech._module._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">module context</span></a>,
+an identifier can be either imported or defined for a given
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> and <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a>, but not both.</p><p>The syntax of <span class="RktVar">require-spec</span> can be extended via
+<span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Frequire-syntax..rkt%29._define-require-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-require-syntax</a></span>, and when multiple
+<span class="RktVar">require-spec</span>s are specified in a <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>, the
+bindings of each <span class="RktVar">require-spec</span> are visible for expanding later
+<span class="RktVar">require-spec</span>s. The pre-defined forms (as exported by
+<a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>) are as follows:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">module-path</span></td></tr></table></blockquote><p> Imports all exported bindings from the
+named module, using the export name for the local identifiers.
+(See below for information on <span class="RktVar">module-path</span>.) The lexical
+context of the <span class="RktVar">module-path</span> form determines the context of
+the introduced identifiers, adding a space scope for exports
+in a particular <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a>, and in each export&rsquo;s
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>.</p><p>If any identifier provided by <span class="RktVar">module-path</span> has a symbol form
+that is <a href="symbols.html#%28tech._uninterned%29" class="techoutside" data-pltdoc="x"><span class="techinside">uninterned</span></a>, the identifier is not imported (i.e., it
+is impossible to import a binding for an uninterned symbol). This
+restriction is intended to avoid compilation differences depending
+on whether a module has been saved to a file or not (see
+<a href="printing.html#%28part._print-compiled%29" data-pltdoc="x">Printing Compiled Code</a>).</p></blockquote><blockquote class="leftindent"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._only-in))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-in%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">only-in</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktVar">id-maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktVar">require-spec</span>, but constrained to those exports for
+which the identifiers to bind match <span class="RktVar">id-maybe-renamed</span>: as
+<span class="RktVar">id</span> or as <span class="RktVar">orig-id</span> in <span class="RktPn">[</span><span class="RktVar">orig-id</span><span class="stt"> </span><span class="RktVar">bind-id</span><span class="RktPn">]</span>. If
+the <span class="RktVar">id</span> or <span class="RktVar">orig-id</span> of any <span class="RktVar">id-maybe-renamed</span>
+is not in the set that <span class="RktVar">require-spec</span> describes, a syntax
+error is reported.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-in%29%29" class="RktStxLink" data-pltdoc="x">only-in</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/tcp</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listen%29%29" class="RktValLink" data-pltdoc="x">tcp-listen</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%29%29" class="RktValLink" data-pltdoc="x">tcp-accept</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-accept</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listen%29%29" class="RktValLink" data-pltdoc="x">tcp-listen</a></span></td></tr><tr><td><p><span class="RktRes">#&lt;procedure:tcp-listen&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">my-accept</span></td></tr><tr><td><p><span class="RktRes">#&lt;procedure:tcp-accept&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%29%29" class="RktValLink" data-pltdoc="x">tcp-accept</a></span></td></tr><tr><td><p><span class="RktErr">tcp-accept: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._except-in))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._except-in%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">except-in</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"> Like
+<span class="RktVar">require-spec</span>, but omitting those imports for which
+<span class="RktVar">id</span>s are the identifiers to bind; if any <span class="RktVar">id</span> is not
+in the set that <span class="RktVar">require-spec</span> describes, a syntax error is
+reported.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._except-in%29%29" class="RktStxLink" data-pltdoc="x">except-in</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/tcp</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listen%29%29" class="RktValLink" data-pltdoc="x">tcp-listen</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%29%29" class="RktValLink" data-pltdoc="x">tcp-accept</a></span></td></tr><tr><td><p><span class="RktRes">#&lt;procedure:tcp-accept&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listen%29%29" class="RktValLink" data-pltdoc="x">tcp-listen</a></span></td></tr><tr><td><p><span class="RktErr">tcp-listen: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._prefix-in))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prefix-in%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">prefix-in</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">prefix-id</span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"> Like
+<span class="RktVar">require-spec</span>, but adjusting each identifier to be bound by
+prefixing it with <span class="RktVar">prefix-id</span>. The lexical context of the
+<span class="RktVar">prefix-id</span> is ignored, and instead preserved from the
+identifiers before prefixing.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prefix-in%29%29" class="RktStxLink" data-pltdoc="x">prefix-in</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tcp:</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/tcp</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">tcp:tcp-accept</span></td></tr><tr><td><p><span class="RktRes">#&lt;procedure:tcp-accept&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">tcp:tcp-listen</span></td></tr><tr><td><p><span class="RktRes">#&lt;procedure:tcp-listen&gt;</span></p></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._rename-in))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._rename-in%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">rename-in</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">orig-id</span><span class="hspace">&nbsp;</span><span class="RktVar">bind-id</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktVar">require-spec</span>, but replacing the identifier to
+bind <span class="RktVar">orig-id</span> with <span class="RktVar">bind-id</span>; if any
+<span class="RktVar">orig-id</span> is not in the set that <span class="RktVar">require-spec</span>
+describes, a syntax error is reported.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._rename-in%29%29" class="RktStxLink" data-pltdoc="x">rename-in</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/tcp</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%29%29" class="RktValLink" data-pltdoc="x">tcp-accept</a></span><span class="hspace">&nbsp;</span><span class="RktSym">accept</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listen%29%29" class="RktValLink" data-pltdoc="x">tcp-listen</a></span><span class="hspace">&nbsp;</span><span class="RktSym">listen</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">accept</span></td></tr><tr><td><p><span class="RktRes">#&lt;procedure:tcp-accept&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">listen</span></td></tr><tr><td><p><span class="RktRes">#&lt;procedure:tcp-listen&gt;</span></p></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._combine-in))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._combine-in%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">combine-in</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">The union of the <span class="RktVar">require-spec</span>s. If two or more imports from the
+<span class="RktVar">require-spec</span>s have the same identifier name but they do not refer to
+the same original binding, a syntax error is reported.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._combine-in%29%29" class="RktStxLink" data-pltdoc="x">combine-in</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-in%29%29" class="RktStxLink" data-pltdoc="x">only-in</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/tcp</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%29%29" class="RktValLink" data-pltdoc="x">tcp-accept</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-in%29%29" class="RktStxLink" data-pltdoc="x">only-in</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/tcp</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listen%29%29" class="RktValLink" data-pltdoc="x">tcp-listen</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%29%29" class="RktValLink" data-pltdoc="x">tcp-accept</a></span></td></tr><tr><td><p><span class="RktRes">#&lt;procedure:tcp-accept&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listen%29%29" class="RktValLink" data-pltdoc="x">tcp-listen</a></span></td></tr><tr><td><p><span class="RktRes">#&lt;procedure:tcp-listen&gt;</span></p></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._relative-in))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._relative-in%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">relative-in</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like the union of the <span class="RktVar">require-spec</span>s, but each
+relative module path in a <span class="RktVar">require-spec</span> is treated
+as relative to <span class="RktVar">module-path</span> instead of the enclosing
+context.</div></p><p>The <a href="stxtrans.html#%28tech._require._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">require transformer</span></a> that implements <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._relative-in%29%29" class="RktStxLink" data-pltdoc="x">relative-in</a></span>
+sets <span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._current-require-module-path%29%29" class="RktValLink" data-pltdoc="x">current-require-module-path</a></span> to adjust module paths
+in the <span class="RktVar">require-spec</span>s.</p></blockquote><blockquote class="leftindent"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._only-meta-in))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-meta-in%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">only-meta-in</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">phase-level</span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like the combination of <span class="RktVar">require-spec</span>s, but removing any
+binding that is not for <span class="RktVar">phase-level</span>, where <span class="RktVal">#f</span> for
+<span class="RktVar">phase-level</span> corresponds to the <a href="syntax-model.html#%28tech._label._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">label phase level</span></a>.</div></p><p>The following example imports bindings only at <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 1,
+the transform phase:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nest</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">meta-eggs</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-meta%29%29" class="RktStxLink" data-pltdoc="x">for-meta</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">meta-chicks</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">num-eggs</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">meta-eggs</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">meta-chicks</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-eggs</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-meta-in%29%29" class="RktStxLink" data-pltdoc="x">only-meta-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">nest</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">desc</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~s ~s\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">meta-eggs</span><span class="hspace">&nbsp;</span><span class="RktSym">meta-chicks</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">desc</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">2 3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">num-eggs</span></td></tr><tr><td><p><span class="RktErr">num-eggs: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr></table></blockquote><p>The following example imports only bindings at <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 0, the
+normal phase.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-meta-in%29%29" class="RktStxLink" data-pltdoc="x">only-meta-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">nest</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">num-eggs</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></blockquote><blockquote class="leftindent"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._only-space-in))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-space-in%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">only-space-in</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">space</span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like the combination of <span class="RktVar">require-spec</span>s, but removing any
+binding that is not provided for the <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a> identifier by
+<span class="RktVar">space</span>&#8212;<wbr></wbr>which is normally an identifier, but <span class="RktVal">#f</span> for
+<span class="RktVar">space</span> corresponds to the <a href="syntax-model.html#%28tech._default._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">default binding space</span></a>.</div></p><p class="SHistory">Added in version 8.2.0.3 of package <span class="stt">base</span>.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-meta%29%29" class="RktStxLink" data-pltdoc="x">for-meta</a></span><span class="hspace">&nbsp;</span><span class="RktVar">phase-level</span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Like the combination of
+<span class="RktVar">require-spec</span>s, but the bindings specified by
+each <span class="RktVar">require-spec</span> are shifted by <span class="RktVar">phase-level</span>. The
+<a href="syntax-model.html#%28tech._label._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">label phase level</span></a> corresponds to <span class="RktVal">#f</span>, and a shifting
+combination that involves <span class="RktVal">#f</span> produces <span class="RktVal">#f</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nest</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-eggs</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-eggs</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-meta%29%29" class="RktStxLink" data-pltdoc="x">for-meta</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">nest</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">num-eggs</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-meta%29%29" class="RktStxLink" data-pltdoc="x">for-meta</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">nest</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">roost</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktSym">num-eggs</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">roost</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Same as
+<span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-meta%29%29" class="RktStxLink" data-pltdoc="x">for-meta</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVar">require-spec</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-template%29%29" class="RktStxLink" data-pltdoc="x">for-template</a></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Same as
+<span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-meta%29%29" class="RktStxLink" data-pltdoc="x">for-meta</a></span><span class="stt"> </span><span class="RktVal"><span class="nobreak">-1</span></span><span class="stt"> </span><span class="RktVar">require-spec</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-label%29%29" class="RktStxLink" data-pltdoc="x">for-label</a></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Same as
+<span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-meta%29%29" class="RktStxLink" data-pltdoc="x">for-meta</a></span><span class="stt"> </span><span class="RktVal">#f</span><span class="stt"> </span><span class="RktVar">require-spec</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>. If an identifier in any of the
+<span class="RktVar">require-spec</span>s is bound at more than one phase level, a syntax error
+is reported.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-space%29%29" class="RktStxLink" data-pltdoc="x">for-space</a></span><span class="hspace">&nbsp;</span><span class="RktVar">space</span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Like the combination of
+<span class="RktVar">require-spec</span>s, but the bindings specified by
+each <span class="RktVar">require-spec</span> are moved to the <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a>
+specified by <span class="RktVar">space</span>&#8212;<wbr></wbr>which is normally an identifier,
+but <span class="RktVal">#f</span> for <span class="RktVar">space</span> corresponds to the
+<a href="syntax-model.html#%28tech._default._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">default binding space</span></a>.</p><p>A binding is moved to the new space by removing the scope for the
+space originally implied by <span class="RktVar">require-spec</span>, if any, and
+adding the scope for <span class="RktVar">space</span>, if any.</p><p class="SHistory">Added in version 8.2.0.3 of package <span class="stt">base</span>.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">derived-require-spec</span></td></tr></table></blockquote><p>See <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Frequire-syntax..rkt%29._define-require-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-require-syntax</a></span>
+for information on expanding the set of <span class="RktVar">require-spec</span>
+forms.</p></blockquote><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=module-paths.html&amp;version=8.6" class="Sq" data-pltdoc="x">Module Paths</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces module paths.</p></blockquote></blockquote></blockquote><p>A <span class="RktVar">module-path</span> identifies a module, either a root module or
+a <a href="eval-model.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodule</span></a> that is declared lexically within another module.
+A root module is identified either through a concrete
+name in the form of an identifier, or through an indirect name that
+can trigger automatic loading of the module declaration. Except for
+the <span class="RktPn">(</span><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span> case below, the actual resolution
+of a root module path is up to the current
+<a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name resolver</span></a> (see
+<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-name-resolver%29%29" class="RktValLink" data-pltdoc="x">current-module-name-resolver</a></span>), and the description below
+corresponds to the default <a href="Module_Names_and_Loading.html#%28tech._module._name._resolver%29" class="techoutside" data-pltdoc="x"><span class="techinside">module name resolver</span></a>.</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Refers to a submodule previously declared with the name
+<span class="RktVar">id</span> or a module previously declared interactively with the name
+<span class="RktVar">id</span>. When <span class="RktVar">id</span> refers to a submodule, <span class="RktPn">(</span><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span>
+is equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxLink" data-pltdoc="x">submod</a></span><span class="stt"> </span><span class="RktVal">"."</span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">a module declared interactively as </span><span class="RktSym">test</span><span class="RktCmt">:</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktSym">test</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">rel-string</span></td></tr></table></blockquote><p>A path relative to the containing source (as
+determined by <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-load-relative-directory</a></span> or
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span>).  Regardless of the current platform,
+<span class="RktVar">rel-string</span> is always parsed as a Unix-format relative path:
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> is the path delimiter (multiple adjacent <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>s are
+not allowed), <span class="RktInBG"><span class="hspace"></span><span class="RktIn">..</span><span class="hspace"></span></span> accesses the parent
+directory, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> accesses the current directory. The path
+cannot be empty or contain a leading or trailing slash, path elements
+before than the last one cannot include a file suffix (i.e., a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> in an element other than <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">..</span><span class="hspace"></span></span>),
+and the only allowed characters are ASCII letters, ASCII digits,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">_</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>, and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">%</span><span class="hspace"></span></span>. Furthermore, a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">%</span><span class="hspace"></span></span> is allowed only when followed
+by two lowercase hexadecimal digits, and the digits must form a
+number that is not the ASCII value of a letter, digit, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">_</span><span class="hspace"></span></span>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The <span class="RktInBG"><span class="hspace"></span><span class="RktIn">%</span><span class="hspace"></span></span> provision is intended to support a
+one-to-one encoding of arbitrary strings as path elements (after
+UTF-8 encoding). Such encodings are not decoded to arrive at a
+filename, but instead preserved in the file access.</p></blockquote></blockquote></blockquote><p>If <span class="RktVar">rel-string</span> ends with a <span class="stt">".ss"</span> suffix, it is
+converted to a <span class="stt">".rkt"</span> suffix. The <a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load
+handler</span></a> may reverse that conversion if a <span class="stt">".rkt"</span> file does
+not exist and a <span class="stt">".ss"</span> exists.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">a module named </span><span class="stt">"x.rkt"</span><span class="RktCmt"> in the same</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">directory as the enclosing module</span><span class="RktCmt">'</span><span class="RktCmt">s file:</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">a module named </span><span class="stt">"x.rkt"</span><span class="RktCmt"> in the parent directory</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">of the enclosing module file</span><span class="RktCmt">'</span><span class="RktCmt">s directory:</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"../x.rkt"</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._lib))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">lib</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">rel-string</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A path to a module installed into
+a <a href="collects.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection</span></a> (see <a href="collects.html" data-pltdoc="x">Libraries and Collections</a>). The <span class="RktVar">rel-string</span>s in
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span> are constrained similar to the plain <span class="RktVar">rel-string</span>
+case, with the additional constraint that a <span class="RktVar">rel-string</span>
+cannot contain <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">..</span><span class="hspace"></span></span> directory indicators.</div></p><p>The specific interpretation of the path depends on the number and
+shape of the <span class="RktVar">rel-string</span>s:</p><ul><li><p>If a single <span class="RktVar">rel-string</span> is provided, and if it
+consists of a single element (i.e., no <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>) with no file
+suffix (i.e., no <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>), then <span class="RktVar">rel-string</span> names a
+<a href="collects.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection</span></a>, and <span class="stt">"main.rkt"</span> is the library file name.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">the main </span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?tag=%28mod-path._.%27swindle.%27%29&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">swindle</span></a><span class="RktCmt"> library:</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"swindle"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">the same:</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"swindle/main.rkt"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p></li><li><p>If a single <span class="RktVar">rel-string</span> is provided, and if it
+consists of multiple <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>-separated elements, then each
+element up to the last names a <a href="collects.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection</span></a>, subcollection,
+etc., and the last element names a file. If the last element has
+no file suffix, <span class="stt">".rkt"</span> is added, while a <span class="stt">".ss"</span>
+suffix is converted to <span class="stt">".rkt"</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="stt">"turbo.rkt"</span><span class="RktCmt"> from the </span><span class="stt">"swindle"</span><span class="RktCmt"> collection:</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"swindle/turbo"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">the same:</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"swindle/turbo.rkt"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">the same:</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"swindle/turbo.ss"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p></li><li><p>If a single <span class="RktVar">rel-string</span> is provided, and if it
+consists of a single element <span style="font-style: italic">with</span> a file suffix (i.e,
+with a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>), then <span class="RktVar">rel-string</span> names a file within
+the <span class="stt">"mzlib"</span> <a href="collects.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection</span></a>. A <span class="stt">".ss"</span>
+suffix is converted to <span class="stt">".rkt"</span>. (This convention is for
+compatibility with older version of Racket.)</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="stt">"tar.rkt"</span><span class="RktCmt"> module from the </span><span class="stt">"mzlib"</span><span class="RktCmt"> collection:</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"tar.ss"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p></li><li><p>Otherwise, when multiple <span class="RktVar">rel-string</span>s are provided,
+the first <span class="RktVar">rel-string</span> is effectively moved after the
+others, and all <span class="RktVar">rel-string</span>s are appended with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>
+separators. The resulting path names a <a href="collects.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection</span></a>, then
+subcollection, etc., ending with a file name. No suffix is added
+automatically, but a <span class="stt">".ss"</span> suffix is converted to
+<span class="stt">".rkt"</span>. (This convention is for compatibility with older
+version of Racket.)</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="stt">"tar.rkt"</span><span class="RktCmt"> module from the </span><span class="stt">"mzlib"</span><span class="RktCmt"> collection:</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"tar.ss"</span><span class="hspace">&nbsp;</span><span class="RktVal">"mzlib"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p></li></ul></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">id</span></td></tr></table></blockquote><p>A shorthand for a <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span> form with a single
+<span class="RktVar">rel-string</span> whose characters are the same as in the symbolic
+form of <span class="RktVar">id</span>. In addition to the constraints of a <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span>
+<span class="RktVar">rel-string</span>, <span class="RktVar">id</span> must not contain <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/tcp</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._file))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._file%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">file</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Similar to the plain <span class="RktVar">rel-string</span>
+case, but <span class="RktVar">string</span> is a path&#8212;<wbr></wbr>possibly absolute&#8212;<wbr></wbr>using the
+current platform&rsquo;s path conventions and <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._expand-user-path%29%29" class="RktValLink" data-pltdoc="x">expand-user-path</a></span>.
+A <span class="stt">".ss"</span> suffix is converted to <span class="stt">".rkt"</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._file%29%29" class="RktStxLink" data-pltdoc="x">file</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~/tmp/x.rkt"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._planet))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._planet%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">planet</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._planet%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">planet</a></span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._planet%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">planet</a></span><span class="hspace">&nbsp;</span><span class="RktVar">rel-string</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">user-string</span><span class="hspace">&nbsp;</span><span class="RktVar">pkg-string</span><span class="hspace">&nbsp;</span><span class="RktVar">vers</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">rel-string</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Specifies a library available via the <span class="planetName">PLaneT</span> server.</div></p><p>The first form is a shorthand for the last one, where the <span class="RktVar">id</span>&rsquo;s
+character sequence must match the following <span class="sroman">&#8249;<span style="font-style: italic">spec</span>&#8250;</span> grammar:</p><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">spec</span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">owner</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">pkg</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">lib</span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">owner</span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">elem</span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">pkg</span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">elem</span>&#8250;</span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="sroman">&#8249;<span style="font-style: italic">elem</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">:</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">version</span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">version</span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">int</span>&#8250;</span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="sroman">&#8249;<span style="font-style: italic">int</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">:</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">minor</span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">minor</span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">int</span>&#8250;</span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">&lt;=</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">int</span>&#8250;</span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">&gt;=</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">int</span>&#8250;</span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">=</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">int</span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p> </p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">int</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">int</span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">lib</span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">empty</span>&#8250;</span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">path</span>&#8250;</span></p></td></tr><tr><td valign="baseline"><p><span class="hspace">&nbsp;</span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">path</span>&#8250;</span></p></td><td valign="baseline"><p><span class="stt"><span class="hspace">&nbsp;</span>::=<span class="hspace">&nbsp;</span></span></p></td><td valign="baseline"><p><span class="sroman">&#8249;<span style="font-style: italic">elem</span>&#8250;</span><span class="stt"><span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span>|<span class="hspace">&nbsp;</span><span class="hspace">&nbsp;</span></span><span class="sroman">&#8249;<span style="font-style: italic">elem</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">path</span>&#8250;</span></p></td></tr></table><p>and where an <span class="sroman">&#8249;<span style="font-style: italic">elem</span>&#8250;</span> is a non-empty sequence of characters
+that are ASCII letters, ASCII digits, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">_</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">%</span><span class="hspace"></span></span> followed by lowercase hexadecimal digits
+(that do not encode one of the other allowed characters), and an
+<span class="sroman">&#8249;<span style="font-style: italic">int</span>&#8250;</span> is a non-empty sequence of ASCII digits. As this
+shorthand is expended, a <span class="stt">".plt"</span> extension is added to
+<span class="sroman">&#8249;<span style="font-style: italic">pkg</span>&#8250;</span>, and a <span class="stt">".rkt"</span> extension is added to
+<span class="sroman">&#8249;<span style="font-style: italic">path</span>&#8250;</span>; if no <span class="sroman">&#8249;<span style="font-style: italic">path</span>&#8250;</span> is included, <span class="stt">"main.rkt"</span>
+is used in the expansion.</p><p>A <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._planet%29%29" class="RktStxLink" data-pltdoc="x">planet</a></span><span class="stt"> </span><span class="RktVar">string</span><span class="RktPn">)</span> form is like a <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._planet%29%29" class="RktStxLink" data-pltdoc="x">planet</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span> form
+with the identifier converted to a string, except that the
+<span class="RktVar">string</span> can optionally end with a file extension (i.e., a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>) for a <span class="sroman">&#8249;<span style="font-style: italic">path</span>&#8250;</span>. A <span class="stt">".ss"</span> file extension is
+converted to <span class="stt">".rkt"</span>.</p><p>In the more general last form of a <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._planet%29%29" class="RktStxLink" data-pltdoc="x">planet</a></span> module path, the
+<span class="RktVar">rel-string</span>s are similar to the <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span> form, except
+that the <span class="RktPn">(</span><span class="RktVar">user-string</span><span class="stt"> </span><span class="RktVar">pkg-string</span><span class="stt"> </span><span class="RktVar">vers</span><span class="RktPn">)</span> names a
+<span class="planetName">PLaneT</span>-based package instead of a <a href="collects.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection</span></a>. A version
+specification can include an optional major and minor version, where
+the minor version can be a specific number or a constraint:
+<span class="RktPn">(</span><span class="RktVar">nat</span><span class="stt"> </span><span class="RktVar">nat</span><span class="RktPn">)</span> specifies an inclusive range, <span class="RktPn">(</span><span class="RktSym">=</span><span class="stt"> </span><span class="RktVar">nat</span><span class="RktPn">)</span> specifies an exact match,
+<span class="RktPn">(</span><span class="RktSym">+</span><span class="stt"> </span><span class="RktVar">nat</span><span class="RktPn">)</span> specifies a minimum
+version and is equivalent to just <span class="RktVar">nat</span>, and
+<span class="RktPn">(</span><span class="RktSym">-</span><span class="stt"> </span><span class="RktVar">nat</span><span class="RktPn">)</span> specifies a maximum
+version. The <span class="RktSym">=</span>, <span class="RktSym">+</span>, and <span class="RktSym">-</span>
+identifiers in a minor-version constraint are recognized
+symbolically.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="stt">"main.rkt"</span><span class="RktCmt"> in package </span><span class="stt">"farm"</span><span class="RktCmt"> by </span><span class="stt">"mcdonald"</span><span class="RktCmt">:</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._planet%29%29" class="RktStxLink" data-pltdoc="x">planet</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mcdonald/farm</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="stt">"main.rkt"</span><span class="RktCmt"> in version &gt;= 2.0 of </span><span class="stt">"farm"</span><span class="RktCmt"> by </span><span class="stt">"mcdonald"</span><span class="RktCmt">:</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._planet%29%29" class="RktStxLink" data-pltdoc="x">planet</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mcdonald/farm:2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="stt">"main.rkt"</span><span class="RktCmt"> in version &gt;= 2.5 of </span><span class="stt">"farm"</span><span class="RktCmt"> by </span><span class="stt">"mcdonald"</span><span class="RktCmt">:</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._planet%29%29" class="RktStxLink" data-pltdoc="x">planet</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mcdonald/farm:2:5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="stt">"duck.rkt"</span><span class="RktCmt"> in version &gt;= 2.5 of </span><span class="stt">"farm"</span><span class="RktCmt"> by </span><span class="stt">"mcdonald"</span><span class="RktCmt">:</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._planet%29%29" class="RktStxLink" data-pltdoc="x">planet</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mcdonald/farm:2:5/duck</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._submod))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">submod</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">root-module-path</span><span class="hspace">&nbsp;</span><span class="RktVar">submod-path-element</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">submod</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"."</span><span class="hspace">&nbsp;</span><span class="RktVar">submod-path-element</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">submod</a></span><span class="hspace">&nbsp;</span><span class="RktVal">".."</span><span class="hspace">&nbsp;</span><span class="RktVar">submod-path-element</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Identifies a <a href="eval-model.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodule</span></a> within the module specified by <span class="RktVar">root-module-path</span>
+or relative to the current module in the case of <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxLink" data-pltdoc="x">submod</a></span><span class="stt"> </span><span class="RktVal">"."</span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span>,
+where  <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxLink" data-pltdoc="x">submod</a></span><span class="stt"> </span><span class="RktVal">".."</span><span class="stt"> </span><span class="RktVar">submod-path-element</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> is equivalent to
+<span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxLink" data-pltdoc="x">submod</a></span><span class="stt"> </span><span class="RktVal">"."</span><span class="stt"> </span><span class="RktVal">".."</span><span class="stt"> </span><span class="RktVar">submod-path-element</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>.
+Submodules have symbolic names, and a sequence of identifiers as <span class="RktVar">submod-path-element</span>s
+determine a path of successively nested submodules with the given names.
+A <span class="RktVal">".."</span> as a <span class="RktVar">submod-path-element</span> names the enclosing module
+of a submodule, and it&rsquo;s intended for use in <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxLink" data-pltdoc="x">submod</a></span><span class="stt"> </span><span class="RktVal">"."</span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span>
+and <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxLink" data-pltdoc="x">submod</a></span><span class="stt"> </span><span class="RktVal">".."</span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span> forms.</div></p></blockquote><p>As <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> prepares to handle a sequence of
+<span class="RktVar">require-spec</span>s, it logs a &ldquo;prefetch&rdquo; message to the
+<a href="logging.html#%28tech._current._logger%29" class="techoutside" data-pltdoc="x"><span class="techinside">current logger</span></a> at the <span class="RktVal">'</span><span class="RktVal">info</span> level, using the name
+<span class="RktVal">'</span><span class="RktVal">module-prefetch</span>, and including message data that is a list
+of two elements: a list of <a href="Module_Names_and_Loading.html#%28tech._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">module paths</span></a> that appear to be
+imported, and a directory path to use for relative module paths. The
+logged list of module paths may be incomplete, but a compilation
+manager can use approximate prefetch information to start on
+compilations in parallel.</p><p class="SHistory">Changed in version 6.0.1.10 of package <span class="stt">base</span>: Added prefetch logging.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._local-require))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._local-require%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">local-require</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>, but for use in a <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a> to
+import just into the local context. Only bindings from <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase
+level</span></a> 0 are imported.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._local-require%29%29" class="RktStxLink" data-pltdoc="x">local-require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/control</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">fcontrol</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;procedure:fcontrol&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">fcontrol</span></td></tr><tr><td><p><span class="RktErr">fcontrol: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr></table></blockquote></div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=module-provide.html&amp;version=8.6" class="Sq" data-pltdoc="x">Exports: <span class="RktSym"><span class="RktStxLink">provide</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span>.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._provide))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">provide</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">provide-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-defined-out%29%29" class="RktStxLink" data-pltdoc="x">all-defined-out</a></span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-from-out%29%29" class="RktStxLink" data-pltdoc="x">all-from-out</a></span><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._rename-out%29%29" class="RktStxLink" data-pltdoc="x">rename-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">orig-id</span><span class="hspace">&nbsp;</span><span class="RktVar">export-id</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._except-out%29%29" class="RktStxLink" data-pltdoc="x">except-out</a></span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prefix-out%29%29" class="RktStxLink" data-pltdoc="x">prefix-out</a></span><span class="hspace">&nbsp;</span><span class="RktVar">prefix-id</span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-out%29%29" class="RktStxLink" data-pltdoc="x">struct-out</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._combine-out%29%29" class="RktStxLink" data-pltdoc="x">combine-out</a></span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._protect-out%29%29" class="RktStxLink" data-pltdoc="x">protect-out</a></span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-meta%29%29" class="RktStxLink" data-pltdoc="x">for-meta</a></span><span class="hspace">&nbsp;</span><span class="RktVar">phase-level</span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-template%29%29" class="RktStxLink" data-pltdoc="x">for-template</a></span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-label%29%29" class="RktStxLink" data-pltdoc="x">for-label</a></span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-space%29%29" class="RktStxLink" data-pltdoc="x">for-space</a></span><span class="hspace">&nbsp;</span><span class="RktVar">space</span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">derived-provide-spec</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">phase-level</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">exact-integer</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVal">#f</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">space</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVal">#f</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Declares exports from a module. A <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> form must appear in
+a <a href="syntax-model.html#%28tech._module._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">module context</span></a> or a <a href="syntax-model.html#%28tech._module._begin._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">module-begin context</span></a>.</div></p><p>A <span class="RktVar">provide-spec</span> indicates one or more bindings to provide.
+For each exported binding, the external name is a symbol that can be
+different from the symbolic form of the identifier that is bound
+within the module. Also, each export is drawn from a particular
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> and exported at the same <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>; by
+default, the relevant phase level is the number of
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> forms that enclose the <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span>
+form. Finally, each export is drawn from a <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a>
+and exported at the same <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a>.</p><p>The syntax of <span class="RktVar">provide-spec</span> can be extended by bindings to
+<a href="stxtrans.html#%28tech._provide._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide transformers</span></a> or <a href="stxtrans.html#%28tech._provide._pre._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide pre-transformers</span></a>, such
+as via <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprovide-syntax..rkt%29._define-provide-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-provide-syntax</a></span>, but the pre-defined forms are
+as follows.</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">id</span></td></tr></table></blockquote><p> Exports <span class="RktVar">id</span>, which must be <a href="syntax-model.html#%28tech._bound%29" class="techoutside" data-pltdoc="x"><span class="techinside">bound</span></a>
+within the module (i.e., either defined or imported) at the relevant
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> and <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a>. The symbolic form of
+<span class="RktVar">id</span> is used as the
+external name, and the symbolic form of the defined or imported
+identifier must match (otherwise, the external name could be
+ambiguous).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nest</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-eggs</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-eggs</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">nest</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">num-eggs</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p><p>If <span class="RktVar">id</span> has a transformer binding to a <a href="syntax-model.html#%28tech._rename._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">rename
+transformer</span></a>, then the transformer affects the exported binding. See
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span> for more information.</p></blockquote><blockquote class="leftindent"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._all-defined-out))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-defined-out%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">all-defined-out</a></span></span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"> Exports all identifiers that are
+defined at the relevant <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> within the
+exporting module, and that have the same lexical context as the
+<span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-defined-out%29%29" class="RktStxLink" data-pltdoc="x">all-defined-out</a></span><span class="RktPn">)</span> form, excluding bindings to <a href="syntax-model.html#%28tech._rename._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">rename
+transformers</span></a> where the target identifier has the
+<span class="RktVal">'</span><span class="RktVal">not-provide-all-defined</span> <a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax property</span></a>. The
+external name for each identifier is the symbolic form of the
+identifier. Only identifiers accessible from the lexical context of
+the <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-defined-out%29%29" class="RktStxLink" data-pltdoc="x">all-defined-out</a></span><span class="RktPn">)</span> form are included; that is,
+macro-introduced imports are not re-exported, unless the
+<span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-defined-out%29%29" class="RktStxLink" data-pltdoc="x">all-defined-out</a></span><span class="RktPn">)</span> form was introduced at the same time.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nest</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-defined-out%29%29" class="RktStxLink" data-pltdoc="x">all-defined-out</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-eggs</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">nest</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">num-eggs</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._all-from-out))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-from-out%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">all-from-out</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"> Exports all identifiers
+that are imported into the exporting module using a
+<span class="RktSym">require-spec</span> built on each <span class="RktVar">module-path</span> (see
+<a href="require.html" data-pltdoc="x">Importing and Exporting: <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a>) with no <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase-level</span></a> shift.  The symbolic
+name for export is derived from the name that is bound within the
+module, as opposed to the symbolic name of the export from each
+<span class="RktVar">module-path</span>. Only identifiers accessible from the lexical
+context of the <span class="RktVar">module-path</span> are included; that is,
+macro-introduced imports are not re-exported, unless the
+<span class="RktVar">module-path</span> was introduced at the same time.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nest</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-eggs</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-eggs</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hen-house</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">nest</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-from-out%29%29" class="RktStxLink" data-pltdoc="x">all-from-out</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">nest</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">hen-house</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">num-eggs</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._rename-out))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._rename-out%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">rename-out</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">orig-id</span><span class="hspace">&nbsp;</span><span class="RktVar">export-id</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"> Exports each
+<span class="RktVar">orig-id</span>, which must be <a href="syntax-model.html#%28tech._bound%29" class="techoutside" data-pltdoc="x"><span class="techinside">bound</span></a> within the module at
+the relevant <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> and <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a>.
+The symbolic name for each export is
+<span class="RktVar">export-id</span> instead of <span class="RktVar">orig-id</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nest</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._rename-out%29%29" class="RktStxLink" data-pltdoc="x">rename-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._count%29%29" class="RktValLink" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-eggs</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._count%29%29" class="RktValLink" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">nest</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">num-eggs</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._count%29%29" class="RktValLink" data-pltdoc="x">count</a></span></td></tr><tr><td><p><span class="RktErr">count: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._except-out))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._except-out%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">except-out</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"> Like the
+first <span class="RktVar">provide-spec</span>, but omitting the bindings listed in each
+subsequent <span class="RktVar">provide-spec</span>. If one of the latter bindings is
+not included in the initial <span class="RktVar">provide-spec</span>, a syntax error is
+reported. The symbolic export name information in the latter
+<span class="RktVar">provide-spec</span>s is ignored; only the bindings are used.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nest</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._except-out%29%29" class="RktStxLink" data-pltdoc="x">except-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-defined-out%29%29" class="RktStxLink" data-pltdoc="x">all-defined-out</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">num-chicks</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-eggs</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-chicks</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">nest</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">num-eggs</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">num-chicks</span></td></tr><tr><td><p><span class="RktErr">num-chicks: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._prefix-out))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prefix-out%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">prefix-out</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">prefix-id</span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktVar">provide-spec</span>, but with each symbolic export name from
+<span class="RktVar">provide-spec</span> prefixed with <span class="RktVar">prefix-id</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nest</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prefix-out%29%29" class="RktStxLink" data-pltdoc="x">prefix-out</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chicken:</span><span class="hspace">&nbsp;</span><span class="RktSym">num-eggs</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-eggs</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">nest</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">chicken:num-eggs</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._struct-out))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-out%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">struct-out</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Exports the bindings associated with a
+structure type <span class="RktVar">id</span>. Typically, <span class="RktVar">id</span> is bound with
+<span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span>; more generally, <span class="RktVar">id</span> must have a
+<a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding of structure-type information at the relevant
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>; see <a href="structinfo.html" data-pltdoc="x">Structure Type Transformer Binding</a>.  Furthermore, for
+each identifier mentioned in the structure-type information, the
+enclosing module must define or import one identifier that is
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span>. If the structure-type information
+includes a super-type identifier, and if the identifier has a
+<a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding of structure-type information, the
+accessor and mutator bindings of the super-type are <span style="font-style: italic">not</span>
+included by <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-out%29%29" class="RktStxLink" data-pltdoc="x">struct-out</a></span> for export.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nest</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-out%29%29" class="RktStxLink" data-pltdoc="x">struct-out</a></span><span class="hspace">&nbsp;</span><span class="RktSym">egg</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">egg</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">color</span><span class="hspace">&nbsp;</span><span class="RktSym">wt</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">nest</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">egg-color</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">egg</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">blue</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'blue</span></p></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._combine-out))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._combine-out%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">combine-out</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"> The union of the
+<span class="RktVar">provide-spec</span>s.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nest</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._combine-out%29%29" class="RktStxLink" data-pltdoc="x">combine-out</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-eggs</span><span class="hspace">&nbsp;</span><span class="RktSym">num-chicks</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-eggs</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-chicks</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">nest</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">num-eggs</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">num-chicks</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._protect-out))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._protect-out%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">protect-out</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"> Like the union of the
+<span class="RktVar">provide-spec</span>s, except that the exports are <a href="modprotect.html#%28tech._protected%29" class="techoutside" data-pltdoc="x"><span class="techinside">protected</span></a>:
+requiring modules may refer to these bindings, but may not extract
+these bindings from macro expansions or access them via <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span> without
+access privileges.
+For more details, see <a href="modprotect.html" data-pltdoc="x">Code Inspectors</a>. The <span class="RktVar">provide-spec</span> must specify only
+bindings that are defined within the exporting module.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nest</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-eggs</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._protect-out%29%29" class="RktStxLink" data-pltdoc="x">protect-out</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-chicks</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-eggs</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-chicks</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">weak-inspector</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._make-inspector%29%29" class="RktValLink" data-pltdoc="x">make-inspector</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="RktValLink" data-pltdoc="x">current-code-inspector</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">weak-eval</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="modprotect.html#%28def._%28%28quote._~23~25kernel%29._current-code-inspector%29%29" class="RktValLink" data-pltdoc="x">current-code-inspector</a></span><span class="hspace">&nbsp;</span><span class="RktSym">weak-inspector</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">weak-ns</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-base-namespace%29%29" class="RktValLink" data-pltdoc="x">make-base-namespace</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-attach-module%29%29" class="RktValLink" data-pltdoc="x">namespace-attach-module</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">nest</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">weak-ns</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="hspace">&nbsp;</span><span class="RktSym">weak-ns</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%29%29" class="RktValLink" data-pltdoc="x">namespace-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">nest</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">nest</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num-eggs</span><span class="hspace">&nbsp;</span><span class="RktSym">num-chicks</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(2 3)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">weak-eval</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">num-eggs</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">weak-eval</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">num-chicks</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">?: access disallowed by code inspector to protected variable</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">from module: 'nest</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: num-chicks</span></p></td></tr></table></blockquote></div></p><p>See also <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=code-inspectors_protect.html&amp;version=8.6" class="Sq" data-pltdoc="x">Code Inspectors for Trusted and Untrusted Code</a>.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-meta%29%29" class="RktStxLink" data-pltdoc="x">for-meta</a></span><span class="hspace">&nbsp;</span><span class="RktVar">phase-level</span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p> Like the union of the
+<span class="RktVar">provide-spec</span>s, but adjusted to apply to the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase
+level</span></a> specified by <span class="RktVar">phase-level</span> relative to the current
+phase level (where <span class="RktVal">#f</span> corresponds to the <a href="syntax-model.html#%28tech._label._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">label phase
+level</span></a>). In particular, an <span class="RktVar">id</span> or <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._rename-out%29%29" class="RktStxLink" data-pltdoc="x">rename-out</a></span> form
+as a <span class="RktVar">provide-spec</span> refers to a binding at
+<span class="RktVar">phase-level</span> relative to the current level, an
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-defined-out%29%29" class="RktStxLink" data-pltdoc="x">all-defined-out</a></span> exports only definitions at
+<span class="RktVar">phase-level</span> relative to the current phase level, and an
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-from-out%29%29" class="RktStxLink" data-pltdoc="x">all-from-out</a></span> exports bindings imported with a shift by
+<span class="RktVar">phase-level</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nest</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eggs</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chickens</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eggs</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">chickens</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">nest</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">test-eggs</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Eggs are ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">eggs</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">test-eggs</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Eggs are 2</span></p></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">chickens</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">broken-nest</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eggs</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chickens</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eggs</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">chickens</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">eval:7:0: provide: provided identifier is not defined or</span></p></td></tr><tr><td><p><span class="RktErr">required</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eggs</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (provide (for-syntax eggs) chickens)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nest2</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eggs</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eggs</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-meta%29%29" class="RktStxLink" data-pltdoc="x">for-meta</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">nest2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">test</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show-eggs</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Eggs are ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">eggs</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show-eggs</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">Eggs are 2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">test</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Same as
+<span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-meta%29%29" class="RktStxLink" data-pltdoc="x">for-meta</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVar">provide-spec</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-template%29%29" class="RktStxLink" data-pltdoc="x">for-template</a></span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Same as
+<span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-meta%29%29" class="RktStxLink" data-pltdoc="x">for-meta</a></span><span class="stt"> </span><span class="RktVal"><span class="nobreak">-1</span></span><span class="stt"> </span><span class="RktVar">provide-spec</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-label%29%29" class="RktStxLink" data-pltdoc="x">for-label</a></span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Same as
+<span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-meta%29%29" class="RktStxLink" data-pltdoc="x">for-meta</a></span><span class="stt"> </span><span class="RktVal">#f</span><span class="stt"> </span><span class="RktVar">provide-spec</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-space%29%29" class="RktStxLink" data-pltdoc="x">for-space</a></span><span class="hspace">&nbsp;</span><span class="RktVar">space</span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p> Like the union of the
+<span class="RktVar">provide-spec</span>s, but adjusted to apply to the <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a>
+specified by <span class="RktVar">space</span>&#8212;<wbr></wbr>where <span class="RktVar">space</span> is either an identifier
+or <span class="RktVal">#f</span> for the <a href="syntax-model.html#%28tech._default._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">default binding space</span></a>. In particular, an <span class="RktVar">id</span>
+or <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._rename-out%29%29" class="RktStxLink" data-pltdoc="x">rename-out</a></span> form as a <span class="RktVar">provide-spec</span> refers to a binding
+in <span class="RktVar">space</span>, an <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-defined-out%29%29" class="RktStxLink" data-pltdoc="x">all-defined-out</a></span> exports only definitions in
+<span class="RktVar">space</span>, and an <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-from-out%29%29" class="RktStxLink" data-pltdoc="x">all-from-out</a></span> exports bindings imported into <span class="RktVar">space</span>.</p><p>When providing a binding for a non-default binding space, normally a
+module should also provide a binding for the default binding space,
+where the default-space binding represents the intended meaning of
+the identifier. When a module later imports the same name in
+different spaces from modules that adhere to this convention, then if
+the two modules also (re)export the same binding for the name in the
+default space, the imports are likely consistent. If the two modules
+export different bindings for the name in the default space, then
+attempting to import both modules will trigger an error about
+conflicting imports, and a programmer can explicitly resolve the
+mismatch.</p><p class="SHistory">Added in version 8.2.0.3 of package <span class="stt">base</span>.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">derived-provide-spec</span></td></tr></table></blockquote><p>See <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprovide-syntax..rkt%29._define-provide-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-provide-syntax</a></span>
+for information on expanding the set of <span class="RktVar">provide-spec</span> forms.</p></blockquote><p>Each export specified within a module must have a distinct symbolic
+export name, though the same binding can be specified with the
+multiple symbolic names.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for-meta))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-meta%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for-meta</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">phase-level</span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> and <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span>.
+</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for-syntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> and <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span>. </div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for-template))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-template%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for-template</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> and <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span>.
+</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for-label))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-label%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for-label</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> and <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span>.
+</div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._for-space))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-space%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for-space</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">space</span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">See <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> and <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._~23~25require))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25require%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">#%require</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">raw-require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">raw-require-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">phaseless-spec</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">for-meta</span><span class="hspace">&nbsp;</span><span class="RktVar">phase-level</span><span class="hspace">&nbsp;</span><span class="RktVar">raw-require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">for-syntax</span><span class="hspace">&nbsp;</span><span class="RktVar">raw-require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">for-template</span><span class="hspace">&nbsp;</span><span class="RktVar">raw-require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">for-label</span><span class="hspace">&nbsp;</span><span class="RktVar">raw-require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">just-meta</span><span class="hspace">&nbsp;</span><span class="RktVar">phase-level</span><span class="hspace">&nbsp;</span><span class="RktVar">raw-require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">portal</span><span class="hspace">&nbsp;</span><span class="RktVar">portal-id</span><span class="hspace">&nbsp;</span><span class="RktVar">content</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">phase-level</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">exact-integer</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVal">#f</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">phaseless-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">spaceless-spec</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">for-space</span><span class="hspace">&nbsp;</span><span class="RktVar">space</span><span class="hspace">&nbsp;</span><span class="RktVar">phaseless-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">just-space</span><span class="hspace">&nbsp;</span><span class="RktVar">space</span><span class="hspace">&nbsp;</span><span class="RktVar">spaceless-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">space</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVal">#f</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">spaceless-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">raw-module-path</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">only</span><span class="hspace">&nbsp;</span><span class="RktVar">raw-module-path</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">prefix</span><span class="hspace">&nbsp;</span><span class="RktVar">prefix-id</span><span class="hspace">&nbsp;</span><span class="RktVar">raw-module-path</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">all-except</span><span class="hspace">&nbsp;</span><span class="RktVar">raw-module-path</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym">prefix-all-except</span><span class="hspace">&nbsp;</span><span class="RktVar">prefix-id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">raw-module-path</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">rename</span><span class="hspace">&nbsp;</span><span class="RktVar">raw-module-path</span><span class="hspace">&nbsp;</span><span class="RktVar">local-id</span><span class="hspace">&nbsp;</span><span class="RktVar">exported-id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">raw-module-path</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">raw-root-module-path</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">submod</span><span class="hspace">&nbsp;</span><span class="RktVar">raw-root-module-path</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">submod</span><span class="hspace">&nbsp;</span><span class="RktVal">"."</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">raw-root-module-path</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">quote</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">rel-string</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">lib</span><span class="hspace">&nbsp;</span><span class="RktVar">rel-string</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">file</span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym">planet</span><span class="hspace">&nbsp;</span><span class="RktVar">rel-string</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">user-string</span><span class="hspace">&nbsp;</span><span class="RktVar">pkg-string</span><span class="hspace">&nbsp;</span><span class="RktVar">vers</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">literal-path</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The primitive import form, to which <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> expands. A
+<span class="RktVar">raw-require-spec</span> is similar to a <span class="RktVar">require-spec</span> in a
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> form, except that the syntax is more constrained, not
+composable, and not extensible. Also, sub-form names like
+<span class="RktSym">for-syntax</span> and <span class="RktSym">lib</span> are recognized
+symbolically, instead of via bindings. Some nested constraints are not
+formalized in the grammar above:</div></p><ul><li><p>a <span class="RktSym">just-meta</span> form cannot appear within a
+<span class="RktSym">just-meta</span> form;</p></li><li><p>a <span class="RktSym">for-meta</span>, <span class="RktSym">for-syntax</span>,
+<span class="RktSym">for-template</span>, or <span class="RktSym">for-label</span> form
+cannot appear within a <span class="RktSym">for-meta</span>,
+<span class="RktSym">for-syntax</span>, <span class="RktSym">for-template</span>, or
+<span class="RktSym">for-label</span> form; and</p></li><li><p>a <span class="RktSym">for-space</span> form cannot appear within a
+<span class="RktSym">for-space</span> form.</p></li><li><p>a <span class="RktSym">portal</span> form cannot appear within a
+<span class="RktSym">just-meta</span> form.</p></li></ul><p>Except for the <span class="RktSym">portal</span> form, each
+<span class="RktVar">raw-require-spec</span> corresponds to the obvious
+<span class="RktVar">require-spec</span>, but the <span class="RktSym">rename</span> sub-form has the
+identifiers in reverse order compared to <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._rename-in%29%29" class="RktStxLink" data-pltdoc="x">rename-in</a></span>.</p><p>For most <span class="RktVar">raw-require-spec</span>s, the lexical context of the
+<span class="RktVar">raw-require-spec</span> determines the context of introduced
+identifiers. The exception is the <span class="RktSym">rename</span> sub-form,
+where the lexical context of the <span class="RktVar">local-id</span> is preserved.</p><p>A <span class="RktVar">literal-path</span> as a <span class="RktVar">raw-root-module-path</span> corresponds
+to a path in the sense of <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span>. Since path values are never
+produced by <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>, they appear only in programmatically
+constructed expressions. They also appear naturally as arguments to
+functions such as <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%29%29" class="RktValLink" data-pltdoc="x">namespace-require</a></span>, with otherwise take a
+quoted <span class="RktSym">raw-module-spec</span>.</p><p>The <span class="RktSym">portal</span> form provides a way to define <a href="stxtrans.html#%28tech._portal._syntax%29" class="techoutside" data-pltdoc="x"><span class="techinside">portal
+syntax</span></a> at any phase level. A <span class="RktPn">(</span><span class="RktSym">portal</span><span class="stt"> </span><span class="RktVar">portal-id</span><span class="stt"> </span><span class="RktVar">content</span><span class="RktPn">)</span>, defines <span class="RktVar">portal-id</span> to portal syntax with
+<span class="RktVar">content</span> effectively quoted to serve as its content.</p><p class="SHistory">Changed in version 8.2.0.3 of package <span class="stt">base</span>: Added <span class="RktSym">for-space</span>
+and <span class="RktSym">just-space</span>.<br/>Changed in version 8.3.0.8: Added <span class="RktSym">portal</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._~23~25provide))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25provide%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">#%provide</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">raw-provide-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">raw-provide-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">phaseless-spec</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">for-meta</span><span class="hspace">&nbsp;</span><span class="RktVar">phase-level</span><span class="hspace">&nbsp;</span><span class="RktVar">phaseless-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">for-syntax</span><span class="hspace">&nbsp;</span><span class="RktVar">phaseless-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">for-label</span><span class="hspace">&nbsp;</span><span class="RktVar">phaseless-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">protect</span><span class="hspace">&nbsp;</span><span class="RktVar">raw-provide-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">phase-level</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">exact-integer</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVal">#f</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">phaseless-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">spaceless-spec</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">for-space</span><span class="hspace">&nbsp;</span><span class="RktVar">space</span><span class="hspace">&nbsp;</span><span class="RktVar">spaceless-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">protect</span><span class="hspace">&nbsp;</span><span class="RktVar">phaseless-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">space</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVal">#f</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">spaceless-spec</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">rename</span><span class="hspace">&nbsp;</span><span class="RktVar">local-id</span><span class="hspace">&nbsp;</span><span class="RktVar">export-id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">struct</span><span class="hspace">&nbsp;</span><span class="RktVar">struct-id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">field-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">all-from</span><span class="hspace">&nbsp;</span><span class="RktVar">raw-module-path</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">all-from-except</span><span class="hspace">&nbsp;</span><span class="RktVar">raw-module-path</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">all-defined</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">all-defined-except</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">prefix-all-defined</span><span class="hspace">&nbsp;</span><span class="RktVar">prefix-id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">prefix-all-defined-except</span><span class="hspace">&nbsp;</span><span class="RktVar">prefix-id</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">protect</span><span class="hspace">&nbsp;</span><span class="RktVar">spaceless-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">expand</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">datum</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym">expand</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">datum</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">orig-form</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The primitive export form, to which <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> expands.  A
+<span class="RktVar">raw-module-path</span> is as for <span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25require%29%29" class="RktStxLink" data-pltdoc="x">#%require</a></span>. A
+<span class="RktSym">protect</span> sub-form cannot appear within a
+<span class="RktSym">protect</span> sub-form.</div></p><p>Like <span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25require%29%29" class="RktStxLink" data-pltdoc="x">#%require</a></span>, the sub-form keywords for <span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25provide%29%29" class="RktStxLink" data-pltdoc="x">#%provide</a></span>
+are recognized symbolically, and nearly every
+<span class="RktVar">raw-provide-spec</span> has an obvious equivalent
+<span class="RktVar">provide-spec</span> via <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span>, with the exception of the
+<span class="RktSym">struct</span> and <span class="RktSym">expand</span> sub-forms.</p><p>A <span class="RktPn">(</span><span class="RktSym">struct</span><span class="stt"> </span><span class="RktVar">struct-id</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktVar">field-id</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span>
+sub-form expands to <span class="RktVar">struct-id</span>,
+<span class="RktSym">make-</span><span class="RktVar">struct-id</span>,
+<span class="RktSym">struct:</span><span class="RktVar">struct-id</span>,
+<span class="RktVar">struct-id</span><span class="RktSym">?</span>,
+<span class="RktVar">struct-id</span><span class="RktSym">-</span><span class="RktVar">field-id</span> for each
+<span class="RktVar">field-id</span>, and
+<span class="RktSym">set-</span><span class="RktVar">struct-id</span><span class="RktSym">-</span><span class="RktVar">field-id</span><span class="RktSym">!</span>
+for each <span class="RktVar">field-id</span>. The lexical context of the
+<span class="RktVar">struct-id</span> is used for all generated identifiers.</p><p>Unlike <span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25require%29%29" class="RktStxLink" data-pltdoc="x">#%require</a></span>, the <span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25provide%29%29" class="RktStxLink" data-pltdoc="x">#%provide</a></span> form is
+macro-extensible via an explicit <span class="RktSym">expand</span> sub-form; the
+<span class="RktPn">(</span><span class="RktVar">id</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">datum</span><span class="RktPn">)</span> part is locally expanded as an expression (even
+though it is not actually an expression), stopping when a
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> form is produced; if the expansion result is
+<span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktVar">raw-provide-spec</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>, it is spliced in place of the
+<span class="RktSym">expand</span> form, otherwise a syntax error is reported.
+If an <span class="RktVar">orig-form</span> part is provided, then it is used instead of the
+<span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25provide%29%29" class="RktStxLink" data-pltdoc="x">#%provide</a></span> form when raising syntax errors, such as a
+&ldquo;provide identifier is not defined&rdquo; error. The <span class="RktSym">expand</span>
+sub-form is not normally used directly; it provides a hook for
+implementing <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> and <a href="stxtrans.html#%28tech._provide._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide transformers</span></a>.</p><p>The <span class="RktSym">all-from</span> and <span class="RktSym">all-from-except</span> forms
+re-export only identifiers that are accessible in lexical context of
+the <span class="RktSym">all-from</span> or <span class="RktSym">all-from-except</span> form
+itself. That is, macro-introduced imports are not re-exported, unless
+the <span class="RktSym">all-from</span> or <span class="RktSym">all-from-except</span> form was
+introduced at the same time. Similarly, <span class="RktSym">all-defined</span> and
+its variants export only definitions accessible from the lexical
+context of the <span class="RktVar">spaceless-spec</span> form.</p><p class="SHistory">Changed in version 8.2.0.3 of package <span class="stt">base</span>: Added <span class="RktSym">for-space</span>.<br/>Changed in version 8.2.0.5: Added <span class="RktVar">orig-form</span> support
+to <span class="RktSym">expand</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Additional_require_Forms&quot;">3.2.1<tt>&nbsp;</tt><a name="(part._.Additional_require_.Forms)"></a><a name="(mod-path._racket/require)"></a>Additional <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> Forms</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="require.html#%28mod-path._racket%2Frequire%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/require</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="require.html#%28mod-path._racket%2Frequire%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/require</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p>The following forms support more complex selection and manipulation of
+sets of imported identifiers.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/require..rkt)._matching-identifiers-in))"></a><span title="Provided from: racket/require | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._matching-identifiers-in%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">matching-identifiers-in</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">regexp</span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktVar">require-spec</span>, but including only imports whose names
+ match <span class="RktVar">regexp</span>.  The <span class="RktVar">regexp</span> must be a literal regular
+ expression (see <a href="regexp.html" data-pltdoc="x">Regular Expressions</a>).</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">zoo</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tunafish</span><span class="hspace">&nbsp;</span><span class="RktSym">swordfish</span><span class="hspace">&nbsp;</span><span class="RktSym">blowfish</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">monkey</span><span class="hspace">&nbsp;</span><span class="RktSym">lizard</span><span class="hspace">&nbsp;</span><span class="RktSym">ant</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tunafish</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">swordfish</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blowfish</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">monkey</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lizard</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ant</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/require</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._matching-identifiers-in%29%29" class="RktStxLink" data-pltdoc="x">matching-identifiers-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"\\w*fish"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">zoo</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">tunafish</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">swordfish</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">blowfish</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">monkey</span></td></tr><tr><td><p><span class="RktErr">monkey: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/require..rkt)._subtract-in))"></a><span title="Provided from: racket/require | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._subtract-in%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">subtract-in</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktVar">subtracted-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktVar">require-spec</span>, but omitting those imports that would be
+  imported by one of the <span class="RktVar">subtracted-spec</span>s.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">earth</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">land</span><span class="hspace">&nbsp;</span><span class="RktSym">sea</span><span class="hspace">&nbsp;</span><span class="RktSym">air</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">land</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sea</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">air</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mars</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">aliens</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">aliens</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">solar-system</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">earth</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">mars</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-from-out%29%29" class="RktStxLink" data-pltdoc="x">all-from-out</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">earth</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-from-out%29%29" class="RktStxLink" data-pltdoc="x">all-from-out</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">mars</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/require</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._subtract-in%29%29" class="RktStxLink" data-pltdoc="x">subtract-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">solar-system</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">earth</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">land</span></td></tr><tr><td><p><span class="RktErr">land: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">aliens</span></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/require..rkt)._filtered-in))"></a><span title="Provided from: racket/require | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._filtered-in%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">filtered-in</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Applies an arbitrary transformation on the import names (as strings)
+of <span class="RktVar">require-spec</span>. The <span class="RktVar">proc-expr</span> must evaluate at
+expansion time to a single-argument procedure, which is applied on
+each of the names from <span class="RktVar">require-spec</span>.  For each name, the
+procedure must return either a string for the import&rsquo;s new name or
+<span class="RktVal">#f</span> to exclude the import.</div></p><p><div class="SIntrapara">For example,
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._filtered-in%29%29" class="RktStxLink" data-pltdoc="x">filtered-in</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">name</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match~3f%29%29" class="RktValLink" data-pltdoc="x">regexp-match?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"^[a-z-]+$"</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-replace%29%29" class="RktValLink" data-pltdoc="x">regexp-replace</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"-"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-titlecase%29%29" class="RktValLink" data-pltdoc="x">string-titlecase</a></span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">""</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">racket/base</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">imports only bindings from <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> that match the
+pattern <span class="RktVal">#rx"^[a-z-]+$"</span>, and it converts the names to &ldquo;camel case.&rdquo;</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/require..rkt)._path-up))"></a><span title="Provided from: racket/require | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._path-up%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">path-up</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">rel-string</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Specifies paths to modules named by the <span class="RktVar">rel-string</span>s similar
+to using the <span class="RktVar">rel-string</span>s directly, except that if a required
+module file is not found relative to the enclosing source, it is
+searched for in the parent directory, and then in the grand-parent
+directory, etc., all the way to the root directory. The discovered
+path relative to the enclosing source becomes part of the expanded
+form.</div></p><p><div class="SIntrapara">This form is useful in setting up a &ldquo;project environment.&rdquo;  For
+example, using the following <span class="stt">"config.rkt"</span> file in the root
+directory of your project:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/require-syntax</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"utils/in-here.rkt"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">utils-in</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Frequire-syntax..rkt%29._define-require-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-require-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">utils-in</span><span class="hspace">&nbsp;</span><span class="RktSym">in-here-transformer</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">and using <span class="stt">"utils/in-here.rkt"</span> under the same root directory:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/runtime-path</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in-here-transformer</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28form._%28%28lib._racket%2Fruntime-path..rkt%29._define-runtime-path%29%29" class="RktStxLink" data-pltdoc="x">define-runtime-path</a></span><span class="hspace">&nbsp;</span><span class="RktSym">here</span><span class="hspace">&nbsp;</span><span class="RktVal">"."</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">in-here-transformer</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sym</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">sym</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">path</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="hspace">&nbsp;</span><span class="RktSym">here</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a.rkt"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">sym</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">file</span><span class="hspace">&nbsp;</span><span class="RktRdr">,</span><span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3estring%29%29" class="RktValLink" data-pltdoc="x">path-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">path</span><span class="RktPn">)</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">then <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._path-up%29%29" class="RktStxLink" data-pltdoc="x">path-up</a></span> works for any other module under the project
+ directory to find <span class="stt">"config.rkt"</span>:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/require</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._path-up%29%29" class="RktStxLink" data-pltdoc="x">path-up</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"config.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">utils-in</span><span class="hspace">&nbsp;</span><span class="RktSym">foo</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Note that the order of requires in the example is important, as each of
+the first two bind the identifier used in the following.</div></p><p><div class="SIntrapara">An alternative in this scenario is to use <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._path-up%29%29" class="RktStxLink" data-pltdoc="x">path-up</a></span> directly to
+find the utility module:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/require</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._path-up%29%29" class="RktStxLink" data-pltdoc="x">path-up</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"utils/foo.rkt"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">but then sub-directories that are called
+<span class="stt">"utils"</span> override the one in the project&rsquo;s root.
+In other words, the previous method requires only a single unique name.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/require..rkt)._multi-in))"></a><span title="Provided from: racket/require | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._multi-in%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">multi-in</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">subs</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">subs</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">sub-path</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">sub-path</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">sub-path</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">rel-string</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Specifies multiple files to be required from a hierarchy of
+directories or collections. The set of required module paths is computed
+as the Cartesian product of the <span class="RktVar">subs</span> groups, where each
+<span class="RktVar">sub-path</span> is combined with other <span class="RktVar">sub-path</span>s in order
+using a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> separator. A <span class="RktVar">sub-path</span> as a <span class="RktVar">subs</span>
+is equivalent to <span class="RktPn">(</span><span class="RktVar">sub-path</span><span class="RktPn">)</span>. All <span class="RktVar">sub-path</span>s in a given
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._multi-in%29%29" class="RktStxLink" data-pltdoc="x">multi-in</a></span> form must be either strings or identifiers.</div></p><p>Examples:</p><p><table cellspacing="0" cellpadding="0"><tr><td><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._multi-in%29%29" class="RktStxLink" data-pltdoc="x">multi-in</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dict</span><span class="hspace">&nbsp;</span><span class="RktSym">list</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p><span class="hspace">&nbsp;&nbsp;</span> is equivalent to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/dict</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/list</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._multi-in%29%29" class="RktStxLink" data-pltdoc="x">multi-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"math"</span><span class="hspace">&nbsp;</span><span class="RktVal">"matrix"</span><span class="hspace">&nbsp;</span><span class="RktVal">"utils.rkt"</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p><span class="hspace">&nbsp;&nbsp;</span> is equivalent to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"math/matrix/utils.rkt"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._multi-in%29%29" class="RktStxLink" data-pltdoc="x">multi-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"utils"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">"math.rkt"</span><span class="hspace">&nbsp;</span><span class="RktVal">"matrix.rkt"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p><span class="hspace">&nbsp;&nbsp;</span> is equivalent to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"utils/math.rkt"</span><span class="hspace">&nbsp;</span><span class="RktVal">"utils/matrix.rkt"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._multi-in%29%29" class="RktStxLink" data-pltdoc="x">multi-in</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">"math"</span><span class="hspace">&nbsp;</span><span class="RktVal">"matrix"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"utils.rkt"</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p><span class="hspace">&nbsp;&nbsp;</span> is equivalent to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"math/utils.rkt"</span><span class="hspace">&nbsp;</span><span class="RktVal">"matrix/utils.rkt"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._multi-in%29%29" class="RktStxLink" data-pltdoc="x">multi-in</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">"math"</span><span class="hspace">&nbsp;</span><span class="RktVal">"matrix"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">"utils.rkt"</span><span class="hspace">&nbsp;</span><span class="RktVal">"helpers.rkt"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td valign="baseline"><p><span class="hspace">&nbsp;&nbsp;</span> is equivalent to<span class="hspace">&nbsp;</span></p></td><td valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"math/utils.rkt"</span><span class="hspace">&nbsp;</span><span class="RktVal">"math/helpers.rkt"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"matrix/utils.rkt"</span><span class="hspace">&nbsp;</span><span class="RktVal">"matrix/helpers.rkt"</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Additional_provide_Forms&quot;">3.2.2<tt>&nbsp;</tt><a name="(part._.Additional_provide_.Forms)"></a><a name="(mod-path._racket/provide)"></a>Additional <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> Forms</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="require.html#%28mod-path._racket%2Fprovide%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/provide</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="require.html#%28mod-path._racket%2Fprovide%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/provide</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/provide..rkt)._matching-identifiers-out))"></a><span title="Provided from: racket/provide | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprovide..rkt%29._matching-identifiers-out%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">matching-identifiers-out</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">regexp</span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"> Like
+<span class="RktVar">provide-spec</span>, but including only exports of bindings with
+an external name that matches <span class="RktVar">regexp</span>. The <span class="RktVar">regexp</span>
+must be a literal regular expression (see <a href="regexp.html" data-pltdoc="x">Regular Expressions</a>).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/provide..rkt)._filtered-out))"></a><span title="Provided from: racket/provide | Package: base"><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprovide..rkt%29._filtered-out%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">filtered-out</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Analogous to <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Frequire..rkt%29._filtered-in%29%29" class="RktStxLink" data-pltdoc="x">filtered-in</a></span>, but for filtering and renaming
+exports.</div></p><p><div class="SIntrapara">For example,
+ </div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprovide..rkt%29._filtered-out%29%29" class="RktStxLink" data-pltdoc="x">filtered-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">name</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match~3f%29%29" class="RktValLink" data-pltdoc="x">regexp-match?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"^[a-z-]+$"</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-replace%29%29" class="RktValLink" data-pltdoc="x">regexp-replace</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#rx"-"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-titlecase%29%29" class="RktValLink" data-pltdoc="x">string-titlecase</a></span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">""</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-defined-out%29%29" class="RktStxLink" data-pltdoc="x">all-defined-out</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">exports only bindings that match the
+ pattern <span class="RktVal">#rx"^[a-z-]+$"</span>, and it converts the names to &ldquo;camel case.&rdquo;</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="module.html" title="backward to &quot;3.1 Modules: module, module*, ...&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="quote.html" title="forward to &quot;3.3 Literals: quote and #%datum&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/running-sa.html b/clones/docs.racket-lang.org/reference/running-sa.html
new file mode 100644
index 00000000..c3fa534f
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/running-sa.html
@@ -0,0 +1,336 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>18.1&nbsp;Running Racket or GRacket</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewselflink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">18.1&nbsp;</td><td><a href="running-sa.html" class="tocviewselflink" data-pltdoc="x">Running Racket or GRacket</a></td></tr><tr><td align="right">18.2&nbsp;</td><td><a href="collects.html" class="tocviewlink" data-pltdoc="x">Libraries and Collections</a></td></tr><tr><td align="right">18.3&nbsp;</td><td><a href="Interactive_Help.html" class="tocviewlink" data-pltdoc="x">Interactive Help</a></td></tr><tr><td align="right">18.4&nbsp;</td><td><a href="interaction-info.html" class="tocviewlink" data-pltdoc="x">Interaction Configuration</a></td></tr><tr><td align="right">18.5&nbsp;</td><td><a href="interactive.html" class="tocviewlink" data-pltdoc="x">Interactive Module Loading</a></td></tr><tr><td align="right">18.6&nbsp;</td><td><a href="debugging.html" class="tocviewlink" data-pltdoc="x">Debugging</a></td></tr><tr><td align="right">18.7&nbsp;</td><td><a href="compiler.html" class="tocviewlink" data-pltdoc="x">Controlling and Inspecting Compilation</a></td></tr><tr><td align="right">18.8&nbsp;</td><td><a href="Kernel_Forms_and_Functions.html" class="tocviewlink" data-pltdoc="x">Kernel Forms and Functions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>18.1&nbsp;</td><td><a href="running-sa.html" class="tocviewselflink" data-pltdoc="x">Running Racket or GRacket</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">18.1.1&nbsp;</td><td><a href="running-sa.html#%28part._init-actions%29" class="tocviewlink" data-pltdoc="x">Initialization</a></td></tr><tr><td align="right">18.1.2&nbsp;</td><td><a href="running-sa.html#%28part._exit-status%29" class="tocviewlink" data-pltdoc="x">Exit Status</a></td></tr><tr><td align="right">18.1.3&nbsp;</td><td><a href="running-sa.html#%28part._.Init_.Libraries%29" class="tocviewlink" data-pltdoc="x">Init Libraries</a></td></tr><tr><td align="right">18.1.4&nbsp;</td><td><a href="running-sa.html#%28part._mz-cmdline%29" class="tocviewlink" data-pltdoc="x">Command Line</a></td></tr><tr><td align="right">18.1.5&nbsp;</td><td><a href="running-sa.html#%28part._configure-runtime%29" class="tocviewlink" data-pltdoc="x">Language Run-<wbr></wbr>Time Configuration</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">18.1.1<tt>&nbsp;</tt></span><a href="running-sa.html#%28part._init-actions%29" class="tocsubseclink" data-pltdoc="x">Initialization</a></td></tr><tr><td><span class="tocsublinknumber">18.1.2<tt>&nbsp;</tt></span><a href="running-sa.html#%28part._exit-status%29" class="tocsubseclink" data-pltdoc="x">Exit Status</a></td></tr><tr><td><span class="tocsublinknumber">18.1.3<tt>&nbsp;</tt></span><a href="running-sa.html#%28part._.Init_.Libraries%29" class="tocsubseclink" data-pltdoc="x">Init Libraries</a></td></tr><tr><td><span class="tocsublinknumber">18.1.4<tt>&nbsp;</tt></span><a href="running-sa.html#%28part._mz-cmdline%29" class="tocsubseclink" data-pltdoc="x">Command Line</a></td></tr><tr><td><span class="tocsublinknumber">18.1.5<tt>&nbsp;</tt></span><a href="running-sa.html#%28part._configure-runtime%29" class="tocsubseclink" data-pltdoc="x">Language Run-<wbr></wbr>Time Configuration</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="running.html" title="backward to &quot;18 Running Racket&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;18 Running Racket&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="collects.html" title="forward to &quot;18.2 Libraries and Collections&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;running-sa&quot;">18.1<tt>&nbsp;</tt><a name="(part._running-sa)"></a>Running Racket or GRacket</h4><p>The core Racket run-time system is available in two main variants:</p><ul><li><p>Racket, which provides the primitives libraries on which
+<a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> is implemented. On Unix and Mac
+OS, the executable is called
+<a name="(idx._(gentag._452._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">racket</span>. On Windows, the executable is
+called <a name="(idx._(gentag._453._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">Racket.exe</span>.</p></li><li><p>GRacket, which is a GUI variant of <span class="stt">racket</span> to the degree
+that the system distinguishes them. On Unix, the executable
+is called <a name="(idx._(gentag._454._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">gracket</span>, and single-instance flags
+and X11-related flags are handled and communicated specially to
+the <span class="RktSym">racket/gui/base</span> library. On Windows, the
+executable is called <a name="(idx._(gentag._455._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">GRacket.exe</span>, and it is a
+GUI application (as opposed to a console application) that
+implements single-instance support. On Mac OS, the
+<span class="stt">gracket</span> script launches <a name="(idx._(gentag._456._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">GRacket.app</span>.</p></li></ul><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;init-actions&quot;">18.1.1<tt>&nbsp;</tt><a name="(part._init-actions)"></a>Initialization</h5><p>On start-up, the top-level environment contains no bindings&#8212;<wbr></wbr>not even
+<span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25app%29%29" class="RktStxLink" data-pltdoc="x">#%app</a></span> for function application. Primitive modules with names
+that start with <span class="RktSym">#%</span> are defined, but they are not meant
+for direct use, and the set of such modules can change.  For example,
+the <a name="(idx._(gentag._457._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">#%kernel</span> module is eventually used to bootstrap
+the implementation of <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</p><p>The first action of Racket or GRacket is to initialize
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-paths</a></span> to the result of
+<span class="RktPn">(</span><span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._find-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">find-library-collection-paths</a></span><span class="stt"> </span><span class="RktVar">pre-extras</span><span class="stt"> </span><span class="RktVar">extras</span><span class="RktPn">)</span>, where
+<span class="RktVar">pre-extras</span> is normally <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span> and <span class="RktVar">extras</span>
+are extra directory paths provided in order in the command line with
+<span class="nobreak"><span class="stt">-S</span></span>/<span class="nobreak"><span class="stt">--search</span></span>. An executable created from the Racket or
+GRacket executable can embed paths used as <span class="RktVar">pre-extras</span>.</p><p>Racket and GRacket next <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> <a href="running-sa.html#%28mod-path._racket%2Finit%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/init</span></a>
+and <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=Init_Libraries.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/gui/init</span></a>, respectively, but only if the
+command line does not specify a <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> flag
+(<span class="nobreak"><span class="stt">-t</span></span>/<span class="nobreak"><span class="stt">--require</span></span>, <span class="nobreak"><span class="stt">-l</span></span>/<span class="nobreak"><span class="stt">--lib</span></span>, or
+<span class="nobreak"><span class="stt">-u</span></span>/<span class="nobreak"><span class="stt">--require-script</span></span>) before any <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span>,
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%29%29" class="RktValLink" data-pltdoc="x">load</a></span>, or read-eval-print-loop flag (<span class="nobreak"><span class="stt">-e</span></span>/<span class="nobreak"><span class="stt">--eval</span></span>,
+<span class="nobreak"><span class="stt">-f</span></span>/<span class="nobreak"><span class="stt">--load</span></span>, <span class="nobreak"><span class="stt">-r</span></span>/<span class="nobreak"><span class="stt">--script</span></span>, <span class="nobreak"><span class="stt">-m</span></span>/<span class="nobreak"><span class="stt">--main</span></span>,
+or <span class="nobreak"><span class="stt">-i</span></span>/<span class="nobreak"><span class="stt">--repl</span></span>). The initialization library can be changed
+with the <span class="nobreak"><span class="stt">-I</span></span> <a href="running-sa.html#%28tech._configuration._option%29" class="techoutside" data-pltdoc="x"><span class="techinside">configuration option</span></a>. The
+<span class="RktSym">configure-runtime</span> submodule of the initialization library or the
+<span class="RktVal">'</span><span class="RktVal">configure-runtime</span> property of the initialization library&rsquo;s
+language is used before the library is instantiated; see
+<a href="running-sa.html#%28part._configure-runtime%29" data-pltdoc="x">Language Run-Time Configuration</a>.</p><p>After potentially loading the initialization module, expression
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span>s, files <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%29%29" class="RktValLink" data-pltdoc="x">load</a></span>s, and module <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s are
+executed in the order that they are provided on the command line. If
+any raises an uncaught exception, then the remaining <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span>s,
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%29%29" class="RktValLink" data-pltdoc="x">load</a></span>s, and <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s are skipped. If the first
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> precedes any <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span> or <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%29%29" class="RktValLink" data-pltdoc="x">load</a></span> so that
+the initialization library is skipped, then the <span class="RktSym">configure-runtime</span>
+submodule of the required module or the
+<span class="RktVal">'</span><span class="RktVal">configure-runtime</span> property of the required module&rsquo;s library
+language is used before the module is instantiated; see
+<a href="running-sa.html#%28part._configure-runtime%29" data-pltdoc="x">Language Run-Time Configuration</a>.</p><p>After running all command-line expressions, files, and modules, Racket
+or GRacket then starts a read-eval-print loop for interactive
+evaluation if no command line flags are provided other than
+<a href="running-sa.html#%28tech._configuration._option%29" class="techoutside" data-pltdoc="x"><span class="techinside">configuration options</span></a>. For Racket, the read-eval-print loop is
+run by calling <span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._read-eval-print-loop%29%29" class="RktValLink" data-pltdoc="x">read-eval-print-loop</a></span> from
+<a href="repl-module.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/repl</span></a>. For GRacket, the read-eval-print loop is
+run by calling <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=Windowing_Functions.html%23%2528def._%2528%2528lib._mred%252Fmain..rkt%2529._graphical-read-eval-print-loop%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">graphical-read-eval-print-loop</a></span> from
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/gui/base</span></a>. If any command-line argument is
+provided that is not a <a href="running-sa.html#%28tech._configuration._option%29" class="techoutside" data-pltdoc="x"><span class="techinside">configuration option</span></a>, then the
+read-eval-print-loop is not started, unless the <span class="nobreak"><span class="stt">-i</span></span>/<span class="nobreak"><span class="stt">--repl</span></span>
+flag is provided on the command line to
+specifically re-enable it.</p><p>In addition, just before the read-eval-print loop
+is started, Racket runs <a href="running-sa.html#%28mod-path._racket%2Finteractive%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/interactive</span></a>
+and GRacket runs <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=Init_Libraries.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/gui/interactive</span></a>, unless a different
+interactive file is specified in the the installation&rsquo;s <span class="stt">"config.rktd"</span>
+file found in <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=dirs.html%23%2528def._%2528%2528lib._setup%252Fdirs..rkt%2529._find-config-dir%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">find-config-dir</a></span><span class="RktPn">)</span>, or the file <span class="stt">"interactive.rkt"</span>
+is found in <span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">addon-dir</span><span class="RktPn">)</span>. If the
+<span class="nobreak"><span class="stt">-q</span></span>/<span class="nobreak"><span class="stt">--no-init-file</span></span> flag is specified on the command line,
+then no interactive file is run.</p><p>Finally, before Racket or GRacket exits, it calls the procedure that
+is the current value of <span class="RktSym"><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._executable-yield-handler%29%29" class="RktValLink" data-pltdoc="x">executable-yield-handler</a></span> in the main
+thread, unless the <span class="nobreak"><span class="stt">-V</span></span>/<span class="nobreak"><span class="stt">--no-yield</span></span> command-line flag is
+specified. Requiring <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/gui/base</span></a> sets this parameter call
+<span class="RktPn">(</span><span class="RktSym">racket</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">yield</span><span class="RktPn">)</span>.</p><p class="SHistory">Changed in version 6.7 of package <span class="stt">base</span>: Run <a href="running-sa.html#%28mod-path._racket%2Finteractive%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/interactive</span></a> file
+rather than directly running <span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">init-file</span><span class="RktPn">)</span>.<br/>Changed in version 6.90.0.30: Run a read-eval-print loop by
+using <a href="repl-module.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/repl</span></a> or <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/gui/base</span></a>
+instead of <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=Init_Libraries.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/gui/init</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;exit-status&quot;">18.1.2<tt>&nbsp;</tt><a name="(part._exit-status)"></a>Exit Status</h5><p>The default exit status for a Racket or GRacket process is non-zero if
+an error occurs during a command-line <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span> (via <span class="nobreak"><span class="stt">-e</span></span>,
+etc.), <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%29%29" class="RktValLink" data-pltdoc="x">load</a></span> (via <span class="nobreak"><span class="stt">-f</span></span>, <span class="nobreak"><span class="stt">-r</span></span>, etc.), or
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> (via <span class="nobreak"><span class="stt">-l</span></span>, <span class="nobreak"><span class="stt">-t</span></span>, etc.)&#8212;<wbr></wbr>or, more generally,
+if the abort handler of the <a href="eval-model.html#%28tech._prompt%29" class="techoutside" data-pltdoc="x"><span class="techinside">prompt</span></a> surrounding those evalutions
+is called&#8212;<wbr></wbr>but only when no
+read-eval-print loop is started. Otherwise, the default exit status is
+<span class="RktVal">0</span>.</p><p>In all cases, a call to <span class="RktSym"><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._exit%29%29" class="RktValLink" data-pltdoc="x">exit</a></span> (when the default <a href="Exiting.html#%28tech._exit._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">exit
+handler</span></a> is in place) can end the process with a specific status
+value.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Init_Libraries&quot;">18.1.3<tt>&nbsp;</tt><a name="(part._.Init_.Libraries)"></a><a name="(mod-path._racket/init)"></a><a name="(mod-path._racket/interactive)"></a><a name="(mod-path._racket/language-info)"></a><a name="(mod-path._racket/runtime-config)"></a>Init Libraries</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="running-sa.html#%28mod-path._racket%2Finit%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/init</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The
+<a href="running-sa.html#%28mod-path._racket%2Finit%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/init</span></a> library is the default start-up
+library for Racket. It re-exports the
+<a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>, <a href="interactive.html#%28mod-path._racket%2Fenter%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/enter</span></a> and
+<a href="Interactive_Help.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/help</span></a> libraries, and it sets
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-print%29%29" class="RktValLink" data-pltdoc="x">current-print</a></span> to use <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print%29%29" class="RktValLink" data-pltdoc="x">pretty-print</a></span>.</div></p><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="running-sa.html#%28mod-path._racket%2Finteractive%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/interactive</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The <a href="running-sa.html#%28mod-path._racket%2Finteractive%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/interactive</span></a> is the default start
+up library when the REPL begins. It is not run if the
+<span class="nobreak"><span class="stt">-q</span></span>/<span class="nobreak"><span class="stt">--no-init-file</span></span> is specified. The interactive
+file can be changed by modifying <span class="RktVal">'</span><span class="RktVal">interactive-file</span> in the
+<span class="stt">"config.rktd"</span> file found in
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=dirs.html%23%2528def._%2528%2528lib._setup%252Fdirs..rkt%2529._find-config-dir%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">find-config-dir</a></span><span class="RktPn">)</span>. Alternative, if the file
+<span class="stt">"interactive.rkt"</span> exists in
+<span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">addon-dir</span><span class="RktPn">)</span> it is run rather
+than the installation wide interactive module.</div><div class="SIntrapara">The default interactive module starts <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=xrepl&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">xrepl</span></a> and
+runs the <span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">init-file</span><span class="RktPn">)</span> file in the users home directory. A
+different interactive file can keep this behavior by
+requiring <a href="running-sa.html#%28mod-path._racket%2Finteractive%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/interactive</span></a>.</div><div class="SIntrapara"><p class="SHistory">Added in version 6.7 of package <span class="stt">base</span>.</p></div></p><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="running-sa.html#%28mod-path._racket%2Flanguage-info%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/language-info</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The
+<a href="running-sa.html#%28mod-path._racket%2Flanguage-info%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/language-info</span></a> library provides a
+<span class="RktSym">get-info</span> function that takes any value and returns
+another function; the returned function takes a key value and a
+default value, and it returns <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">racket/runtime-config</span><span class="stt"> </span><span class="RktVal">configure</span><span class="stt"> </span><span class="RktVal">#f</span><span class="RktVal">)</span><span class="RktVal">)</span> if the key is <span class="RktVal">'</span><span class="RktVal">configure-runtime</span> or the
+default value otherwise.</div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span>See also <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=module-runtime-config.html&amp;version=8.6" class="Sq" data-pltdoc="x">Module-Handling Configuration</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a>.</p></blockquote></blockquote></blockquote><p>The vector <span class="RktVal">'</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">racket/language-info</span><span class="stt"> </span><span class="RktVal">get-info</span><span class="stt"> </span><span class="RktVal">#f</span><span class="RktVal">)</span> is suitable
+for attaching to a module as its language info to get the same
+language information as the <span class="RktSym">racket/base</span> language.</p><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="running-sa.html#%28mod-path._racket%2Fruntime-config%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/runtime-config</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The
+<a href="running-sa.html#%28mod-path._racket%2Fruntime-config%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/runtime-config</span></a> library provides a
+<span class="RktSym">configure</span> function that takes any value
+and sets <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print-as-expression%29%29" class="RktValLink" data-pltdoc="x">print-as-expression</a></span>
+to <span class="RktVal">#t</span>.</div></p><p>The vector <span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">racket/runtime-config</span><span class="stt"> </span><span class="RktVal">configure</span><span class="stt"> </span><span class="RktVal">#f</span><span class="RktVal">)</span> is suitable
+as a member of a list of runtime-configuration specification (as
+returned by a module&rsquo;s language-information function for the key
+<span class="RktVal">'</span><span class="RktVal">configure-runtime</span>) to obtain the same runtime configuration as
+for the <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> language.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;mz-cmdline&quot;">18.1.4<tt>&nbsp;</tt><a name="(part._mz-cmdline)"></a>Command Line</h5><p>The Racket and GRacket executables recognize the following command-line
+flags:</p><ul><li><p>File and expression options:</p><ul><li><p><a name="(idx._(gentag._458._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-e</span></span> <span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span> or <a name="(idx._(gentag._459._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--eval</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span> : <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span>s <span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span>. The results of
+the evaluation are printed via <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-print%29%29" class="RktValLink" data-pltdoc="x">current-print</a></span>.</p></li><li><p><a name="(idx._(gentag._460._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-f</span></span> <span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span> or <a name="(idx._(gentag._461._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--load</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span> : <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%29%29" class="RktValLink" data-pltdoc="x">load</a></span>s <span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span>; if
+<span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span> is <span class="stt">"-"</span>, then expressions are read and
+evaluated from standard input.</p></li><li><p><a name="(idx._(gentag._462._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-t</span></span> <span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span> or <a name="(idx._(gentag._463._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--require</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span> : <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s <span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span>, and then
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxLink" data-pltdoc="x">submod</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._file%29%29" class="RktStxLink" data-pltdoc="x">file</a></span><span class="stt"> </span><span class="RktVal">"</span><span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span><span class="RktVal">"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym">main</span><span class="RktPn">)</span> if available.</p></li><li><p><a name="(idx._(gentag._464._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-l</span></span> <span class="sroman">&#8249;<span style="font-style: italic">path</span>&#8250;</span> or <a name="(idx._(gentag._465._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--lib</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">path</span>&#8250;</span> : <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span><span class="stt"> </span><span class="RktVal">"</span><span class="sroman">&#8249;<span style="font-style: italic">path</span>&#8250;</span><span class="RktVal">"</span><span class="RktPn">)</span>, and then <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s
+<span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxLink" data-pltdoc="x">submod</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span><span class="stt"> </span><span class="RktVal">"</span><span class="sroman">&#8249;<span style="font-style: italic">path</span>&#8250;</span><span class="RktVal">"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym">main</span><span class="RktPn">)</span> if available.</p></li><li><p><a name="(idx._(gentag._466._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-p</span></span> <span class="sroman">&#8249;<span style="font-style: italic">package</span>&#8250;</span> :
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._planet%29%29" class="RktStxLink" data-pltdoc="x">planet</a></span><span class="stt"> </span><span class="RktVal">"</span><span class="sroman">&#8249;<span style="font-style: italic">package</span>&#8250;</span><span class="RktVal">"</span><span class="RktPn">)</span>,
+and then
+ <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._submod%29%29" class="RktStxLink" data-pltdoc="x">submod</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._planet%29%29" class="RktStxLink" data-pltdoc="x">planet</a></span><span class="stt"> </span><span class="RktVal">"</span><span class="sroman">&#8249;<span style="font-style: italic">package</span>&#8250;</span><span class="RktVal">"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym">main</span><span class="RktPn">)</span> if available.</p></li><li><p><a name="(idx._(gentag._467._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-r</span></span> <span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span> or <a name="(idx._(gentag._468._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--script</span></span>
+ <span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span> : <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._load%29%29" class="RktValLink" data-pltdoc="x">load</a></span>s <span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span>
+<span class="refelem"><span class="refcolumn"><span class="refcontent">Despite its name, <span class="nobreak"><span class="stt">--script</span></span> is not usually
+used for Unix scripts. See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=scripts.html&amp;version=8.6" class="Sq" data-pltdoc="x">Scripts</a> for more
+information on scripts.</span></span></span>
+ as a script. This flag is like <span class="nobreak"><span class="stt">-t</span></span> <span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span> plus
+ <span class="nobreak"><span class="stt">-N</span></span> <span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span> to set the program name and <span class="nobreak"><span class="stt">--</span></span>
+ to cause all further command-line elements to be treated as
+ non-flag arguments.</p></li><li><p><a name="(idx._(gentag._469._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-u</span></span> <span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span> or <a name="(idx._(gentag._470._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--require-script</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span> : <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s <span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span> as a script;
+This flag is like <span class="nobreak"><span class="stt">-t</span></span> <span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span> plus <span class="nobreak"><span class="stt">-N</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span> to set the program name and <span class="nobreak"><span class="stt">--</span></span> to cause
+all further command-line elements to be treated as non-flag
+arguments.</p></li><li><p><a name="(idx._(gentag._471._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-k</span></span> <span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span> <span class="sroman">&#8249;<span style="font-style: italic">m</span>&#8250;</span> <span class="sroman">&#8249;<span style="font-style: italic">p</span>&#8250;</span> : Loads code
+embedded in the executable from file position <span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span> to
+<span class="sroman">&#8249;<span style="font-style: italic">m</span>&#8250;</span> and from <span class="sroman">&#8249;<span style="font-style: italic">m</span>&#8250;</span> to <span class="sroman">&#8249;<span style="font-style: italic">p</span>&#8250;</span>. (On Mac OS,
+<span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span>, <span class="sroman">&#8249;<span style="font-style: italic">m</span>&#8250;</span>, and <span class="sroman">&#8249;<span style="font-style: italic">p</span>&#8250;</span> are relative to a
+<span class="stt">__PLTSCHEME</span> segment in the executable. On Windows,
+they are relative to a resource of type 257 and ID 1. On Unix
+using ELF, they are relative to the <span class="stt">.rackprog</span> segment
+in the executable.) The first range
+is loaded in every new <a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">place</span></a>, and any modules declared
+in that range are considered predefined in the sense of
+<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-predefined~3f%29%29" class="RktValLink" data-pltdoc="x">module-predefined?</a></span>. This option is normally embedded
+in a stand-alone binary that also embeds Racket code.</p></li><li><p><a name="(idx._(gentag._472._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-Y</span></span> <span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span> <span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span> <span class="sroman">&#8249;<span style="font-style: italic">m</span>&#8250;</span> <span class="sroman">&#8249;<span style="font-style: italic">p</span>&#8250;</span> :
+Like <span class="nobreak"><span class="stt">-k</span></span> <span class="sroman">&#8249;<span style="font-style: italic">n</span>&#8250;</span> <span class="sroman">&#8249;<span style="font-style: italic">m</span>&#8250;</span> <span class="sroman">&#8249;<span style="font-style: italic">p</span>&#8250;</span>, but reading
+from <span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span> (without any adjustment
+for a segment or resource offset).</p></li><li><p><a name="(idx._(gentag._473._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-m</span></span> or <a name="(idx._(gentag._474._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--main</span></span> : Evaluates a call to
+<span class="RktSym">main</span> as bound in the top-level environment. All
+of the command-line arguments that are not processed as
+options (i.e., the arguments put into
+<span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._current-command-line-arguments%29%29" class="RktValLink" data-pltdoc="x">current-command-line-arguments</a></span>) are passed as
+arguments to <span class="RktSym">main</span>. The results of the call are
+printed via <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-print%29%29" class="RktValLink" data-pltdoc="x">current-print</a></span>.</p><p>The call to <span class="RktSym">main</span> is constructed as an
+expression <span class="RktPn">(</span><span class="RktSym">main</span><span class="stt"> </span><span class="RktVar">arg-str</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>  where the lexical context of the expression gives
+<span class="RktSym">#%app</span> and <span class="RktSym">#%datum</span> bindings as
+<span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-app%29%29" class="RktStxLink" data-pltdoc="x">#%plain-app</a></span> and <span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._~23~25datum%29%29" class="RktStxLink" data-pltdoc="x">#%datum</a></span>, but the lexical
+context of <span class="RktSym">main</span> is the top-level environment.</p></li></ul></li><li><p>Interaction options:</p><ul><li><p><a name="(idx._(gentag._475._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-i</span></span> or <a name="(idx._(gentag._476._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--repl</span></span> : Runs an interactive read-eval-print
+loop, using either <span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._read-eval-print-loop%29%29" class="RktValLink" data-pltdoc="x">read-eval-print-loop</a></span> (Racket) or
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=Windowing_Functions.html%23%2528def._%2528%2528lib._mred%252Fmain..rkt%2529._graphical-read-eval-print-loop%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">graphical-read-eval-print-loop</a></span> (GRacket) after showing
+<span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._banner%29%29" class="RktValLink" data-pltdoc="x">banner</a></span><span class="RktPn">)</span> and loading <span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">init-file</span><span class="RktPn">)</span>. In the case of Racket, <span class="RktPn">(</span><span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._read-eval-print-loop%29%29" class="RktValLink" data-pltdoc="x">read-eval-print-loop</a></span><span class="RktPn">)</span>
+is followed by <span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._newline%29%29" class="RktValLink" data-pltdoc="x">newline</a></span><span class="RktPn">)</span>. For GRacket, supply the <span class="nobreak"><span class="stt">-z</span></span>/<span class="nobreak"><span class="stt">--text-repl</span></span>
+configuration option to use <span class="RktSym"><a href="eval.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._read-eval-print-loop%29%29" class="RktValLink" data-pltdoc="x">read-eval-print-loop</a></span> (and <span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._newline%29%29" class="RktValLink" data-pltdoc="x">newline</a></span>)
+instead of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=Windowing_Functions.html%23%2528def._%2528%2528lib._mred%252Fmain..rkt%2529._graphical-read-eval-print-loop%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">graphical-read-eval-print-loop</a></span>.</p></li><li><p><a name="(idx._(gentag._477._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-n</span></span> or <a name="(idx._(gentag._478._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--no-lib</span></span> : Skips requiring the
+initialization library (i.e., <a href="running-sa.html#%28mod-path._racket%2Finit%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/init</span></a> or
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=Init_Libraries.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/gui/init</span></a>, unless it is changed with the
+<span class="nobreak"><span class="stt">-I</span></span> flag) when not otherwise disabled.</p></li><li><p><a name="(idx._(gentag._479._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-v</span></span> or <a name="(idx._(gentag._480._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--version</span></span> : Shows
+<span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._banner%29%29" class="RktValLink" data-pltdoc="x">banner</a></span><span class="RktPn">)</span>.</p></li><li><p><a name="(idx._(gentag._481._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-K</span></span> or <a name="(idx._(gentag._482._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--back</span></span> : GRacket, Mac OS only;
+leave application in the background.</p></li><li><p><a name="(idx._(gentag._483._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-V</span></span> <a name="(idx._(gentag._484._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--no-yield</span></span> : Skips final
+<span class="RktSym"><a href="Exiting.html#%28def._%28%28quote._~23~25kernel%29._executable-yield-handler%29%29" class="RktValLink" data-pltdoc="x">executable-yield-handler</a></span> action, which normally waits until all
+frames are closed, etc<span class="Sendabbrev">.</span> in the main <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=windowing-overview.html%23%2528tech._eventspace%2529&amp;version=8.6" class="techoutside Sq" data-pltdoc="x"><span class="techinside">eventspace</span></a> before
+exiting for programs that use <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/gui/base</span></a>.</p></li></ul></li><li><p><a name="(tech._configuration._option)"></a><span style="font-style: italic">Configuration options</span>:</p><ul><li><p><a name="(idx._(gentag._485._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-y</span></span> or <a name="(idx._(gentag._486._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--make</span></span> : Enables automatic
+generation and update of compiled <span class="stt">".zo"</span> files for
+modules loaded in the initial namespace. Specifically, the
+result of
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=API_for_Making_Bytecode.html%23%2528def._%2528%2528lib._compiler%252Fcm..rkt%2529._make-compilation-manager-load%252Fuse-compiled-handler%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-compilation-manager-load/use-compiled-handler</a></span><span class="RktPn">)</span>
+is installed as the <a href="eval.html#%28tech._compiled._load._handler%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled-load handler</span></a> before other
+module-loading actions. <span style="font-weight: bold">Caution:</span> This flag is intended
+for use in interactive settings; using it in a script is
+probably a bad idea, because concurrent invocations of the
+script may collide attempting to update compiled files, or
+there may be filesystem-permission issues. Using
+<a name="(idx._(gentag._487._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-c</span></span>/<a name="(idx._(gentag._488._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--no-compiled</span></span> cancels the effect of
+<a name="(idx._(gentag._489._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-y</span></span>/<a name="(idx._(gentag._490._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--make</span></span>.</p></li><li><p><a name="(idx._(gentag._491._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-c</span></span> or <a name="(idx._(gentag._492._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--no-compiled</span></span> : Disables loading
+of compiled <span class="stt">".zo"</span> files, by initializing
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._use-compiled-file-paths%29%29" class="RktValLink" data-pltdoc="x">use-compiled-file-paths</a></span> to <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span>.
+Use judiciously: this effectively ignores the content of all
+<span class="stt">"compiled"</span> subdirectories, so that any used modules are
+compiled on the fly&#8212;<wbr></wbr>even <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> and
+its dependencies&#8212;<wbr></wbr>which leads to prohibitively expensive
+run times.</p></li><li><p><a name="(idx._(gentag._493._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-q</span></span> or <a name="(idx._(gentag._494._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--no-init-file</span></span> : Skips loading
+<span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">init-file</span><span class="RktPn">)</span> for
+<span class="nobreak"><span class="stt">-i</span></span>/<span class="nobreak"><span class="stt">--repl</span></span>.</p></li><li><p><a name="(idx._(gentag._495._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-z</span></span> or <a name="(idx._(gentag._496._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--text-repl</span></span> : GRacket only; changes
+<span class="nobreak"><span class="stt">-i</span></span>/<span class="nobreak"><span class="stt">--repl</span></span> to use
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=Windowing_Functions.html%23%2528def._%2528%2528lib._mred%252Fmain..rkt%2529._textual-read-eval-print-loop%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">textual-read-eval-print-loop</a></span> instead of
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=Windowing_Functions.html%23%2528def._%2528%2528lib._mred%252Fmain..rkt%2529._graphical-read-eval-print-loop%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">graphical-read-eval-print-loop</a></span>.</p></li><li><p><a name="(idx._(gentag._497._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-I</span></span> <span class="sroman">&#8249;<span style="font-style: italic">path</span>&#8250;</span> : Sets <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lib%29%29" class="RktStxLink" data-pltdoc="x">lib</a></span><span class="stt"> </span><span class="RktVal">"</span><span class="sroman">&#8249;<span style="font-style: italic">path</span>&#8250;</span><span class="RktVal">"</span><span class="RktPn">)</span> as the path to <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> to initialize
+the namespace, unless namespace initialization is disabled. Using
+this flag can effectively set the language for the read-eval-print
+loop and other top-level evaluation.</p></li><li><p><a name="(idx._(gentag._498._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-X</span></span> <span class="sroman">&#8249;<span style="font-style: italic">dir</span>&#8250;</span> or <a name="(idx._(gentag._499._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--collects</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">dir</span>&#8250;</span> : Sets <span class="sroman">&#8249;<span style="font-style: italic">dir</span>&#8250;</span> as the path to the main
+collection of libraries by making <span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">collects-dir</span><span class="RktPn">)</span> produce <span class="sroman">&#8249;<span style="font-style: italic">dir</span>&#8250;</span>. If <span class="sroman">&#8249;<span style="font-style: italic">dir</span>&#8250;</span> is an
+empty string, then <span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">collects-dir</span><span class="RktPn">)</span>
+returns <span class="stt">"."</span>, but
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._current-library-collection-paths%29%29" class="RktValLink" data-pltdoc="x">current-library-collection-paths</a></span> is initialized to
+the empty list, and <span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._use-collection-link-paths%29%29" class="RktValLink" data-pltdoc="x">use-collection-link-paths</a></span> is
+initialized to <span class="RktVal">#f</span>.</p></li><li><p><a name="(idx._(gentag._500._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-S</span></span> <span class="sroman">&#8249;<span style="font-style: italic">dir</span>&#8250;</span> or <a name="(idx._(gentag._501._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--search</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">dir</span>&#8250;</span> : Adds <span class="sroman">&#8249;<span style="font-style: italic">dir</span>&#8250;</span> to the default library
+collection search path after the main collection directory. If
+the <span class="nobreak"><span class="stt">-S</span></span>/<span class="nobreak"><span class="stt">--dir</span></span> flag is supplied multiple times, the
+search order is as supplied.</p></li><li><p><a name="(idx._(gentag._502._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-G</span></span> <span class="sroman">&#8249;<span style="font-style: italic">dir</span>&#8250;</span> or <a name="(idx._(gentag._503._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--config</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">dir</span>&#8250;</span> : Sets the directory that is returned by
+<span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">config-dir</span><span class="RktPn">)</span>.</p></li><li><p><a name="(idx._(gentag._504._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-A</span></span> <span class="sroman">&#8249;<span style="font-style: italic">dir</span>&#8250;</span> or <a name="(idx._(gentag._505._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--addon</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">dir</span>&#8250;</span> : Sets the directory that is returned by
+<span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">addon-dir</span><span class="RktPn">)</span>.</p></li><li><p><a name="(idx._(gentag._506._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-U</span></span> or <a name="(idx._(gentag._507._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--no-user-path</span></span> : Omits
+user-specific paths in the search for collections, C
+libraries, etc. by initializing the
+<span class="RktSym"><a href="collects.html#%28def._%28%28quote._~23~25kernel%29._use-user-specific-search-paths%29%29" class="RktValLink" data-pltdoc="x">use-user-specific-search-paths</a></span> parameter to
+<span class="RktVal">#f</span>.</p></li><li><p><a name="(idx._(gentag._508._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-A</span></span> <span class="sroman">&#8249;<span style="font-style: italic">dir</span>&#8250;</span> or <a name="(idx._(gentag._509._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--addon</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">dir</span>&#8250;</span> : Sets the directory that is returned by
+<span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">addon-dir</span><span class="RktPn">)</span>.</p></li><li><p><a name="(idx._(gentag._510._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-R</span></span> <span class="sroman">&#8249;<span style="font-style: italic">paths</span>&#8250;</span> or <a name="(idx._(gentag._511._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--compiled</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">paths</span>&#8250;</span> : Sets the initial value of the
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compiled-file-roots%29%29" class="RktValLink" data-pltdoc="x">current-compiled-file-roots</a></span> parameter, overriding
+any <span class="stt">PLTCOMPILEDROOTS</span> setting. The <span class="sroman">&#8249;<span style="font-style: italic">paths</span>&#8250;</span>
+argument is parsed in the same way as <span class="stt">PLTCOMPILEDROOTS</span>
+(see <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compiled-file-roots%29%29" class="RktValLink" data-pltdoc="x">current-compiled-file-roots</a></span>).</p></li><li><p><a name="(idx._(gentag._512._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-C</span></span> or <a name="(idx._(gentag._513._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--cross</span></span> : Select cross-platform
+build mode, causing <span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">cross</span><span class="RktPn">)</span> to report
+<span class="RktVal">'</span><span class="RktVal">force</span>, and sets the current configuration of
+<span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">config-dir</span><span class="RktPn">)</span> and
+<span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">collects-dir</span><span class="RktPn">)</span> to be the results of
+<span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">host-config-dir</span><span class="RktPn">)</span> and
+<span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">host-collects-dir</span><span class="RktPn">)</span>, respectively.
+If <a name="(idx._(gentag._514._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-C</span></span> or <a name="(idx._(gentag._515._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--cross</span></span> is provided multiple
+times, only the first instance has an effect.</p></li><li><p><a name="(idx._(gentag._516._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-N</span></span> <span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span> or <a name="(idx._(gentag._517._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--name</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span> : sets the name of the executable as reported
+by <span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">run-file</span><span class="RktPn">)</span> to
+<span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span>.</p></li><li><p><a name="(idx._(gentag._518._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-E</span></span> <span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span> or <a name="(idx._(gentag._519._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--exe</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span> : sets the name of the executable as reported
+by <span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">exec-file</span><span class="RktPn">)</span> to
+<span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span>.</p></li><li><p><a name="(idx._(gentag._520._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-J</span></span> <span class="sroman">&#8249;<span style="font-style: italic">name</span>&#8250;</span> or <a name="(idx._(gentag._521._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--wm-class</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">name</span>&#8250;</span> : GRacket, Unix only; sets the <span class="stt">WM_CLASS</span>
+program class to <span class="sroman">&#8249;<span style="font-style: italic">name</span>&#8250;</span> (while the <span class="stt">WM_CLASS</span>
+program name is derived from the executable name or a
+<span class="nobreak"><span class="stt">-N</span></span>/<span class="nobreak"><span class="stt">--name</span></span> argument).</p></li><li><p><a name="(idx._(gentag._522._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-j</span></span> or <a name="(idx._(gentag._523._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--no-jit</span></span> : Disables the
+native-code just-in-time compiler by setting the
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval-jit-enabled%29%29" class="RktValLink" data-pltdoc="x">eval-jit-enabled</a></span> parameter to <span class="RktVal">#f</span>.</p></li><li><p><a name="(idx._(gentag._524._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-M</span></span> or <a name="(idx._(gentag._525._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--compile-any</span></span> : Enables
+machine-independent bytecode by setting the
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile-target-machine%29%29" class="RktValLink" data-pltdoc="x">current-compile-target-machine</a></span> parameter to
+<span class="RktVal">#f</span>.</p></li><li><p><a name="(idx._(gentag._526._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-d</span></span> or <a name="(idx._(gentag._527._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--no-delay</span></span> : Disables on-demand
+parsing of compiled code and syntax objects by setting the
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-on-demand-source%29%29" class="RktValLink" data-pltdoc="x">read-on-demand-source</a></span> parameter to <span class="RktVal">#f</span>.</p></li><li><p><a name="(idx._(gentag._528._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-b</span></span> or <a name="(idx._(gentag._529._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--binary</span></span> : Requests binary mode,
+instead of text mode, for the process&rsquo;s input, out, and error
+ports. This flag currently has no effect, because binary mode
+is always used.</p></li><li><p><a name="(idx._(gentag._530._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-W</span></span> <span class="sroman">&#8249;<span style="font-style: italic">levels</span>&#8250;</span> or <a name="(idx._(gentag._531._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--warn</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">levels</span>&#8250;</span> : Sets the logging level for writing events to
+the original error port. The possible <span class="sroman">&#8249;<span style="font-style: italic">level</span>&#8250;</span> values
+are the same as for the <span class="stt">PLTSTDERR</span> environment
+variable. See <a href="logging.html" data-pltdoc="x">Logging</a> for more information.</p></li><li><p><a name="(idx._(gentag._532._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-O</span></span> <span class="sroman">&#8249;<span style="font-style: italic">levels</span>&#8250;</span> or <a name="(idx._(gentag._533._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--stdout</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">levels</span>&#8250;</span> : Sets the logging level for writing events to
+the original output port. The possible <span class="sroman">&#8249;<span style="font-style: italic">level</span>&#8250;</span> values
+are the same as for the <span class="stt">PLTSTDOUT</span> environment
+variable. See <a href="logging.html" data-pltdoc="x">Logging</a> for more information.</p></li><li><p><a name="(idx._(gentag._534._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-L</span></span> <span class="sroman">&#8249;<span style="font-style: italic">levels</span>&#8250;</span> or <a name="(idx._(gentag._535._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--syslog</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">levels</span>&#8250;</span> : Sets the logging level for writing events to
+the system log. The possible <span class="sroman">&#8249;<span style="font-style: italic">level</span>&#8250;</span> values
+are the same as for the <span class="stt">PLTSYSLOG</span> environment
+variable. See <a href="logging.html" data-pltdoc="x">Logging</a> for more information.</p></li></ul></li><li><p>Meta options:</p><ul><li><p><a name="(idx._(gentag._536._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-Z</span></span> : The argument following this flag is ignored.
+This flag can be handy in some impoverished scripting environments
+to replace or cancel another command-line argument.</p></li><li><p><a name="(idx._(gentag._537._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--</span></span> : No argument following this flag is itself used
+as a flag.</p></li><li><p><a name="(idx._(gentag._538._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-h</span></span> or <a name="(idx._(gentag._539._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">--help</span></span> : Shows information about
+the command-line flags and start-up process and exits,
+ignoring all other flags.</p></li></ul></li></ul><p>If at least one command-line argument is provided, and if the first
+one after any <a href="running-sa.html#%28tech._configuration._option%29" class="techoutside" data-pltdoc="x"><span class="techinside">configuration option</span></a> is not a flag, then a
+<span class="nobreak"><span class="stt">-u</span></span>/<span class="nobreak"><span class="stt">--require-script</span></span> flag is implicitly added before the
+first non-flag argument.</p><p>If no command-line arguments are supplied other than
+<a href="running-sa.html#%28tech._configuration._option%29" class="techoutside" data-pltdoc="x"><span class="techinside">configuration options</span></a>, then the <span class="nobreak"><span class="stt">-i</span></span>/<span class="nobreak"><span class="stt">--repl</span></span> flag is
+effectively added.</p><p>For GRacket on Unix, the follow flags are recognized when they appear
+at the beginning of the command line, and they count as configuration
+options (i.e., they do not disable the read-eval-print loop or prevent
+the insertion of <span class="nobreak"><span class="stt">-u</span></span>/<span class="nobreak"><span class="stt">--require-script</span></span>):</p><ul><li><p><a name="(idx._(gentag._540._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-display</span></span> <span class="sroman">&#8249;<span style="font-style: italic">display</span>&#8250;</span> : Sets the X11 display
+to use.</p></li><li><p><a name="(idx._(gentag._541._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-geometry</span></span> <span class="sroman">&#8249;<span style="font-style: italic">arg</span>&#8250;</span>, <a name="(idx._(gentag._542._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-bg</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">arg</span>&#8250;</span>, <a name="(idx._(gentag._543._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-background</span></span> <span class="sroman">&#8249;<span style="font-style: italic">arg</span>&#8250;</span>,
+<a name="(idx._(gentag._544._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-fg</span></span> <span class="sroman">&#8249;<span style="font-style: italic">arg</span>&#8250;</span>, <a name="(idx._(gentag._545._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-foreground</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">arg</span>&#8250;</span>, <a name="(idx._(gentag._546._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-fn</span></span> <span class="sroman">&#8249;<span style="font-style: italic">arg</span>&#8250;</span>, <a name="(idx._(gentag._547._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-font</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">arg</span>&#8250;</span>, <a name="(idx._(gentag._548._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-iconic</span></span>, <a name="(idx._(gentag._549._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-name</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">arg</span>&#8250;</span>, <a name="(idx._(gentag._550._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-rv</span></span>, <a name="(idx._(gentag._551._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-reverse</span></span>,
+<a name="(idx._(gentag._552._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">+rv</span></span>, <a name="(idx._(gentag._553._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-selectionTimeout</span></span> <span class="sroman">&#8249;<span style="font-style: italic">arg</span>&#8250;</span>,
+<a name="(idx._(gentag._554._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-synchronous</span></span>, <a name="(idx._(gentag._555._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-title</span></span> <span class="sroman">&#8249;<span style="font-style: italic">arg</span>&#8250;</span>,
+<a name="(idx._(gentag._556._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-xnllanguage</span></span> <span class="sroman">&#8249;<span style="font-style: italic">arg</span>&#8250;</span>, or <a name="(idx._(gentag._557._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-xrm</span></span>
+<span class="sroman">&#8249;<span style="font-style: italic">arg</span>&#8250;</span> : Standard X11 arguments that are mostly ignored
+but accepted for compatibility with other X11 programs. The
+<span class="nobreak"><span class="stt">-synchronous</span></span> flag behaves in the usual
+way.</p></li><li><p><a name="(idx._(gentag._558._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-singleInstance</span></span> : If an existing GRacket is already
+running on the same X11 display, if it was started on a
+machine with the same hostname, and if it was started with the
+same name as reported by <span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">run-file</span><span class="RktPn">)</span>&#8212;<wbr></wbr>possibly set with the <span class="nobreak"><span class="stt">-N</span></span>/<span class="nobreak"><span class="stt">--name</span></span>
+command-line argument&#8212;<wbr></wbr>then all non-option command-line
+arguments are treated as filenames and sent to the existing
+GRacket instance via the application file handler (see
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=Windowing_Functions.html%23%2528def._%2528%2528lib._mred%252Fmain..rkt%2529._application-file-handler%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">application-file-handler</a></span>).</p></li></ul><p>Similarly, on Mac OS, a leading switch starting with
+<a name="(idx._(gentag._559._(lib._scribblings/reference/reference..scrbl)))"></a><span class="nobreak"><span class="stt">-psn_</span></span> is treated as a special configuration option. It
+indicates that Finder started the application, so the current input,
+output, and error output are redirected to a GUI window.</p><p>Multiple single-letter switches (the ones preceded by a single
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span>) can be collapsed into a single switch by concatenating
+the letters, as long as the first switch is not <span class="nobreak"><span class="stt">--</span></span>. The
+arguments for each switch are placed after the collapsed switches (in
+the order of the switches). For example,</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">-ifve </span><span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span><span class="stt"> </span><span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span></p><p>and</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">-i -f </span><span class="sroman">&#8249;<span style="font-style: italic">file</span>&#8250;</span><span class="stt"> -v -e </span><span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span></p><p>are equivalent. If a collapsed <span class="nobreak"><span class="stt">--</span></span> appears before other collapsed
+switches in the same collapsed set, it is implicitly moved to the end
+of the collapsed set.</p><p>Extra arguments following the last option are available from the
+<a name="(idx._(gentag._560._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._current-command-line-arguments%29%29" class="RktValLink" data-pltdoc="x">current-command-line-arguments</a></span> parameter.</p><p class="SHistory">Changed in version 6.90.0.17 of package <span class="stt">base</span>: Added <span class="nobreak"><span class="stt">-O</span></span>/<span class="nobreak"><span class="stt">--stdout</span></span>.<br/>Changed in version 7.1.0.5: Added <span class="nobreak"><span class="stt">-M</span></span>/<span class="nobreak"><span class="stt">--compile-any</span></span>.<br/>Changed in version 7.8.0.6: Added <span class="nobreak"><span class="stt">-Z</span></span>.<br/>Changed in version 8.0.0.10: Added <span class="nobreak"><span class="stt">-E</span></span>.<br/>Changed in version 8.0.0.11: Added <span class="nobreak"><span class="stt">-Y</span></span>.<br/>Changed in version 8.4.0.1: Added <span class="nobreak"><span class="stt">-y</span></span>/<span class="nobreak"><span class="stt">--make</span></span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;configure-runtime&quot;">18.1.5<tt>&nbsp;</tt><a name="(part._configure-runtime)"></a>Language Run-Time Configuration</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span>See also <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=module-runtime-config.html&amp;version=8.6" class="Sq" data-pltdoc="x">Module-Handling Configuration</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a>.</p></blockquote></blockquote></blockquote><p>A module can have a <span class="RktSym">configure-runtime</span> submodule that is
+<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span>d before the module itself when a module is
+the main module of a program. Normally, a <span class="RktSym">configure-runtime</span>
+submodule is added to a module by the module&rsquo;s language (i.e., by the
+<span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25module-begin%29%29" class="RktStxLink" data-pltdoc="x">#%module-begin</a></span> form among a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>&rsquo;s initial
+bindings). The body of a <span class="RktSym">configure-runtime</span> submodule
+typically sets parameters, possibly including
+<span class="RktSym"><a href="interaction-info.html#%28def._%28%28lib._racket%2Finteraction-info..rkt%29._current-interaction-info%29%29" class="RktValLink" data-pltdoc="x">current-interaction-info</a></span>.</p><p>Alternatively or in addition, an older protocol is in place.
+When a module is implemented using <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a>, the language after
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a> can specify configuration actions to perform when a
+module using the language is the main module of a program. The
+language specifies run-time configuration by</p><ul><li><p>attaching a <span class="RktVal">'</span><span class="RktVal">module-language</span> <a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax property</span></a> to
+the module as read from its source (see <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> and
+<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-compiled-language-info%29%29" class="RktValLink" data-pltdoc="x">module-compiled-language-info</a></span>);</p></li><li><p>having the function indicated by the <span class="RktVal">'</span><span class="RktVal">module-language</span>
+<a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax property</span></a> recognize the
+<a name="(idx._(gentag._561._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">configure-runtime</span> key, for which it returns a list of
+vectors; each vector must have the form <span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="stt"> </span><span class="RktVar">mp</span><span class="stt"> </span><span class="RktVar">name</span><span class="stt"> </span><span class="RktVar">val</span><span class="RktPn">)</span> where <span class="RktVar">mp</span> is a <a href="Module_Names_and_Loading.html#%28tech._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path</span></a>,
+<span class="RktVar">name</span> is a symbol, and <span class="RktVar">val</span> is an arbitrary
+value; and</p></li><li><p>having each function called as <span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span><span class="stt"> </span><span class="RktVar">mp</span><span class="stt"> </span><span class="RktVar">name</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">val</span><span class="RktPn">)</span> configure the run-time environment, typically by
+setting parameters such as <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-print%29%29" class="RktValLink" data-pltdoc="x">current-print</a></span>.</p></li></ul><p>A <span class="RktVal">'</span><span class="RktVal">configure-runtime</span> query returns a list of vectors, instead
+of directly configuring the environment, so that the indicated modules
+to be bundled with a program when creating a stand-alone executable;
+see <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=exe.html&amp;version=8.6" class="Sq" data-pltdoc="x"><span class="stt">raco exe</span>: Creating Stand-Alone Executables</a> in
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x"><span class="stt">raco</span>: Racket Command-Line Tools</a>.</p><p>For information on defining a new <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=Module_Syntax.html%23%2528part._hash-lang%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktMod">#lang</span></a> language, see
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=reader-helpers.html%23%2528mod-path._syntax%252Fmodule-reader%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">syntax/module-reader</span></a>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="running.html" title="backward to &quot;18 Running Racket&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;18 Running Racket&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="collects.html" title="forward to &quot;18.2 Libraries and Collections&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/running.html b/clones/docs.racket-lang.org/reference/running.html
new file mode 100644
index 00000000..60cb227c
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/running.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>18&nbsp;Running Racket</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewselflink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>18&nbsp;</td><td><a href="running.html" class="tocviewselflink" data-pltdoc="x">Running Racket</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">18.1&nbsp;</td><td><a href="running-sa.html" class="tocviewlink" data-pltdoc="x">Running Racket or GRacket</a></td></tr><tr><td align="right">18.2&nbsp;</td><td><a href="collects.html" class="tocviewlink" data-pltdoc="x">Libraries and Collections</a></td></tr><tr><td align="right">18.3&nbsp;</td><td><a href="Interactive_Help.html" class="tocviewlink" data-pltdoc="x">Interactive Help</a></td></tr><tr><td align="right">18.4&nbsp;</td><td><a href="interaction-info.html" class="tocviewlink" data-pltdoc="x">Interaction Configuration</a></td></tr><tr><td align="right">18.5&nbsp;</td><td><a href="interactive.html" class="tocviewlink" data-pltdoc="x">Interactive Module Loading</a></td></tr><tr><td align="right">18.6&nbsp;</td><td><a href="debugging.html" class="tocviewlink" data-pltdoc="x">Debugging</a></td></tr><tr><td align="right">18.7&nbsp;</td><td><a href="compiler.html" class="tocviewlink" data-pltdoc="x">Controlling and Inspecting Compilation</a></td></tr><tr><td align="right">18.8&nbsp;</td><td><a href="Kernel_Forms_and_Functions.html" class="tocviewlink" data-pltdoc="x">Kernel Forms and Functions</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="unsafe.html" title="backward to &quot;17 Unsafe Operations&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="running-sa.html" title="forward to &quot;18.1 Running Racket or GRacket&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;running&quot;">18<tt>&nbsp;</tt><a name="(part._running)"></a>Running Racket</h3><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="running-sa.html" class="toclink" data-pltdoc="x">18.1<span class="hspace">&nbsp;</span>Running Racket or GRacket</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="running-sa.html#%28part._init-actions%29" class="toclink" data-pltdoc="x">18.1.1<span class="hspace">&nbsp;</span>Initialization</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="running-sa.html#%28part._exit-status%29" class="toclink" data-pltdoc="x">18.1.2<span class="hspace">&nbsp;</span>Exit Status</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="running-sa.html#%28part._.Init_.Libraries%29" class="toclink" data-pltdoc="x">18.1.3<span class="hspace">&nbsp;</span>Init Libraries</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="running-sa.html#%28part._mz-cmdline%29" class="toclink" data-pltdoc="x">18.1.4<span class="hspace">&nbsp;</span>Command Line</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="running-sa.html#%28part._configure-runtime%29" class="toclink" data-pltdoc="x">18.1.5<span class="hspace">&nbsp;</span>Language Run-Time Configuration</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="collects.html" class="toclink" data-pltdoc="x">18.2<span class="hspace">&nbsp;</span>Libraries and Collections</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="collects.html#%28part._collects-search%29" class="toclink" data-pltdoc="x">18.2.1<span class="hspace">&nbsp;</span>Collection Search Configuration</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="collects.html#%28part._links-file%29" class="toclink" data-pltdoc="x">18.2.2<span class="hspace">&nbsp;</span>Collection Links</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="collects.html#%28part._collects-api%29" class="toclink" data-pltdoc="x">18.2.3<span class="hspace">&nbsp;</span>Collection Paths and Parameters</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Interactive_Help.html" class="toclink" data-pltdoc="x">18.3<span class="hspace">&nbsp;</span>Interactive Help</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="interaction-info.html" class="toclink" data-pltdoc="x">18.4<span class="hspace">&nbsp;</span>Interaction Configuration</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="interactive.html" class="toclink" data-pltdoc="x">18.5<span class="hspace">&nbsp;</span>Interactive Module Loading</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="interactive.html#%28part._enter%29" class="toclink" data-pltdoc="x">18.5.1<span class="hspace">&nbsp;</span>Entering Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="interactive.html#%28part._rerequire%29" class="toclink" data-pltdoc="x">18.5.2<span class="hspace">&nbsp;</span>Loading and Reloading Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="debugging.html" class="toclink" data-pltdoc="x">18.6<span class="hspace">&nbsp;</span>Debugging</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="debugging.html#%28part._.Tracing%29" class="toclink" data-pltdoc="x">18.6.1<span class="hspace">&nbsp;</span>Tracing</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="compiler.html" class="toclink" data-pltdoc="x">18.7<span class="hspace">&nbsp;</span>Controlling and Inspecting Compilation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="compiler.html#%28part._compiler-modes%29" class="toclink" data-pltdoc="x">18.7.1<span class="hspace">&nbsp;</span>Compilation Modes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="compiler.html#%28part._3m-compiler-modes%29" class="toclink" data-pltdoc="x">18.7.1.1<span class="hspace">&nbsp;</span>BC Compilation Modes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="compiler.html#%28part._cs-compiler-modes%29" class="toclink" data-pltdoc="x">18.7.1.2<span class="hspace">&nbsp;</span>CS Compilation Modes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="compiler.html#%28part._compiler-inspect%29" class="toclink" data-pltdoc="x">18.7.2<span class="hspace">&nbsp;</span>Inspecting Compiler Passes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Kernel_Forms_and_Functions.html" class="toclink" data-pltdoc="x">18.8<span class="hspace">&nbsp;</span>Kernel Forms and Functions</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="unsafe.html" title="backward to &quot;17 Unsafe Operations&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="running-sa.html" title="forward to &quot;18.1 Running Racket or GRacket&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/runtime.html b/clones/docs.racket-lang.org/reference/runtime.html
new file mode 100644
index 00000000..94a1833e
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/runtime.html
@@ -0,0 +1,113 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15.8&nbsp;Environment and Runtime Information</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewselflink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewlink" data-pltdoc="x">Paths</a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="Filesystem.html" class="tocviewlink" data-pltdoc="x">Filesystem</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="networking.html" class="tocviewlink" data-pltdoc="x">Networking</a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="subprocess.html" class="tocviewlink" data-pltdoc="x">Processes</a></td></tr><tr><td align="right">15.5&nbsp;</td><td><a href="logging.html" class="tocviewlink" data-pltdoc="x">Logging</a></td></tr><tr><td align="right">15.6&nbsp;</td><td><a href="time.html" class="tocviewlink" data-pltdoc="x">Time</a></td></tr><tr><td align="right">15.7&nbsp;</td><td><a href="envvars.html" class="tocviewlink" data-pltdoc="x">Environment Variables</a></td></tr><tr><td align="right">15.8&nbsp;</td><td><a href="runtime.html" class="tocviewselflink" data-pltdoc="x">Environment and Runtime Information</a></td></tr><tr><td align="right">15.9&nbsp;</td><td><a href="Command-Line_Parsing.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Parsing</a></td></tr><tr><td align="right">15.10&nbsp;</td><td><a href="os-lib.html" class="tocviewlink" data-pltdoc="x">Additional Operating System Functions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">system-<wbr></wbr>type</span></span></a></td></tr><tr><td><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-language%2Bcountry%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">system-<wbr></wbr>language+<span class="mywbr"> &nbsp;</span>country</span></span></a></td></tr><tr><td><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-library-subpath%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">system-<wbr></wbr>library-<wbr></wbr>subpath</span></span></a></td></tr><tr><td><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._version%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">version</span></span></a></td></tr><tr><td><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._banner%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">banner</span></span></a></td></tr><tr><td><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._current-command-line-arguments%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>command-<wbr></wbr>line-<wbr></wbr>arguments</span></span></a></td></tr><tr><td><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._current-thread-initial-stack-size%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>thread-<wbr></wbr>initial-<wbr></wbr>stack-<wbr></wbr>size</span></span></a></td></tr><tr><td><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._vector-set-performance-stats%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>set-<wbr></wbr>performance-<wbr></wbr>stats!</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="envvars.html" title="backward to &quot;15.7 Environment Variables&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="os.html" title="up to &quot;15 Operating System&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Command-Line_Parsing.html" title="forward to &quot;15.9 Command-Line Parsing&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;runtime&quot;">15.8<tt>&nbsp;</tt><a name="(part._runtime)"></a>Environment and Runtime Information</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._system-type))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValDef RktValLink" data-pltdoc="x">system-type</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">mode</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">os</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">os*</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">arch</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">word</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">vm</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">gc</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">link</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">machine</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">target-machine</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">so-suffix</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">so-mode</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">fs-change</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">cross</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">os</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns information about the operating system, build mode, or machine
+for a running Racket. (Installation tools should use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=cross-system.html%23%2528def._%2528%2528lib._setup%252Fcross-system..rkt%2529._cross-system-type%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cross-system-type</a></span>,
+instead, to support cross-installation.)</div></p><p>In <a name="(idx._(gentag._414._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">os</span> mode,
+ the possible symbol results are:</p><ul><li><p><a name="(idx._(gentag._415._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">unix</span></p></li><li><p><a name="(idx._(gentag._416._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">windows</span></p></li><li><p><a name="(idx._(gentag._417._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">macosx</span></p></li></ul><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Prior to the introduction of <span class="RktVal">'</span><span class="RktVal">os*</span> and
+<span class="RktVal">'</span><span class="RktVal">arch</span> modes, <span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-library-subpath%29%29" class="RktValLink" data-pltdoc="x">system-library-subpath</a></span><span class="stt"> </span><span class="RktVal">#f</span><span class="RktPn">)</span> could be
+used to obtain this information somewhat indirectly.</p></blockquote></blockquote></blockquote><p>In <a name="(idx._(gentag._418._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">os*</span> mode, the result is similar to <span class="RktVal">'</span><span class="RktVal">os</span>
+mode, but refined to a specific operating system, such as
+<span class="RktVal">'</span><span class="RktVal">linux</span> or <span class="RktVal">'</span><span class="RktVal">freebsd</span>, instead of a generic
+<span class="RktVal">'</span><span class="RktVal">unix</span> classification.</p><p>In <a name="(idx._(gentag._419._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">arch</span> mode, the result is a symbol representing an
+architecture. Possible results include <span class="RktVal">'</span><span class="RktVal">x86_64</span>, <span class="RktVal">'</span><span class="RktVal">i386</span>,
+<span class="RktVal">'</span><span class="RktVal">aarch64</span>, <span class="RktVal">'</span><span class="RktVal">arm</span> (32-bit), and <span class="RktVal">'</span><span class="RktVal">ppc</span> (32-bit).</p><p>In <a name="(idx._(gentag._420._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">word</span> mode, the result is either <span class="RktVal">32</span> or
+<span class="RktVal">64</span> to indicate whether Racket is running as a 32-bit program
+or 64-bit program.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=performance.html%23%2528part._virtual-machines%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Racket Virtual Machine Implementations</a> for more information
+about the <span class="RktVal">'</span><span class="RktVal">vm</span> and <span class="RktVal">'</span><span class="RktVal">gc</span> mode results.</p></blockquote></blockquote></blockquote><p>In <a name="(idx._(gentag._421._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">vm</span> mode,
+the possible symbol results are (see also <a href="implementations.html" data-pltdoc="x">Implementations</a>):</p><ul><li><p><a name="(idx._(gentag._422._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">racket</span></p></li><li><p><a name="(idx._(gentag._423._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">chez-scheme</span></p></li></ul><p>In <a name="(idx._(gentag._424._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">gc</span> mode,
+the possible symbol results are (see also <a href="implementations.html" data-pltdoc="x">Implementations</a>):</p><ul><li><p><a name="(idx._(gentag._425._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">cgc</span> &#8212;<wbr></wbr> when <span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">vm</span><span class="RktPn">)</span> is <span class="RktVal">'</span><span class="RktVal">racket</span></p></li><li><p><a name="(idx._(gentag._426._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">3m</span> &#8212;<wbr></wbr> when <span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">vm</span><span class="RktPn">)</span> is <span class="RktVal">'</span><span class="RktVal">racket</span></p></li><li><p><a name="(idx._(gentag._427._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">cs</span> &#8212;<wbr></wbr> when <span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">vm</span><span class="RktPn">)</span> is <span class="RktVal">'</span><span class="RktVal">chez-scheme</span></p></li></ul><p>In <a name="(idx._(gentag._428._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">link</span> mode, the possible symbol results are:</p><ul><li><p><a name="(idx._(gentag._429._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">static</span> (Unix)</p></li><li><p><a name="(idx._(gentag._430._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">shared</span> (Unix)</p></li><li><p><a name="(idx._(gentag._431._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">dll</span> (Windows)</p></li><li><p><a name="(idx._(gentag._432._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">framework</span> (Mac OS)</p></li></ul><p>Future ports of Racket may expand the list of <span class="RktVal">'</span><span class="RktVal">os</span>, <span class="RktVal">'</span><span class="RktVal">os*</span>,
+<span class="RktVal">'</span><span class="RktVal">arch</span>, <span class="RktVal">'</span><span class="RktVal">vm</span>, <span class="RktVal">'</span><span class="RktVal">gc</span>, and <span class="RktVal">'</span><span class="RktVal">link</span> results.</p><p>In <a name="(idx._(gentag._433._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">machine</span> mode, then the result is a string, which
+contains further details about the current machine in a
+platform-specific format.</p><p>In <a name="(idx._(gentag._434._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">target-machine</span> mode, the result is a symbol for
+the running Racket&rsquo;s native bytecode format, or it is <span class="RktVal">#f</span> if
+there is no native format other than the machine-independent format.
+If the result is a symbol, then <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-target-machine~3f%29%29" class="RktValLink" data-pltdoc="x">compile-target-machine?</a></span> returns
+<span class="RktVal">#t</span> when applied to the symbol; see also
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile-target-machine%29%29" class="RktValLink" data-pltdoc="x">current-compile-target-machine</a></span>.</p><p>In <a name="(idx._(gentag._435._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">so-suffix</span> mode, then the result is a byte string
+that represents the file extension used for shared objects on the
+current platform. The byte string starts with a period, so it is
+suitable as a second argument to <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-replace-suffix%29%29" class="RktValLink" data-pltdoc="x">path-replace-suffix</a></span>.</p><p>In <a name="(idx._(gentag._436._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">so-mode</span> mode, then the result is <span class="RktVal">'</span><span class="RktVal">local</span>
+if foreign libraries should be opened in &ldquo;local&rdquo; mode by default
+(as on most platforms) or <span class="RktVal">'</span><span class="RktVal">global</span> if foreign libraries
+should be opened in &ldquo;global&rdquo; mode.</p><p>In <a name="(idx._(gentag._437._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">fs-change</span> mode, the result is an immutable vector
+of four elements. Each element is either <span class="RktVal">#f</span> or a symbol,
+where a symbol indicates the presence of a property and <span class="RktVal">#f</span>
+indicates the absence of a property. The possible symbols, in order,
+are:</p><ul><li><p><a name="(idx._(gentag._438._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">supported</span> &#8212;<wbr></wbr> <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._filesystem-change-evt%29%29" class="RktValLink" data-pltdoc="x">filesystem-change-evt</a></span>
+can produce a <a href="Filesystem.html#%28tech._filesystem._change._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">filesystem change event</span></a> to monitor filesystem changes;
+if this symbol is not first in the vector, all other vector elements
+are <span class="RktVal">#f</span></p></li><li><p><a name="(idx._(gentag._439._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">scalable</span> &#8212;<wbr></wbr> resources consumed by a
+<a href="Filesystem.html#%28tech._filesystem._change._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">filesystem change event</span></a> are effectively limited only by
+available memory, as opposed to file-descriptor limits; this property
+is <span class="RktVal">#f</span> on Mac OS and BSD variants of Unix</p></li><li><p><a name="(idx._(gentag._440._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">low-latency</span> &#8212;<wbr></wbr> creation and checking of a
+<a href="Filesystem.html#%28tech._filesystem._change._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">filesystem change event</span></a> is practically instantaneous; this
+property is <span class="RktVal">#f</span> on Linux</p></li><li><p><a name="(idx._(gentag._441._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">file-level</span> &#8212;<wbr></wbr> a <a href="Filesystem.html#%28tech._filesystem._change._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">filesystem change
+event</span></a> can track changes at the level of a file, as opposed to the
+file&rsquo;s directory; this property is <span class="RktVal">#f</span> on Windows</p></li></ul><p>In <a name="(idx._(gentag._442._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">cross</span> mode, the result reports whether
+cross-platform build mode has been selected (through the <span class="nobreak"><span class="stt">-C</span></span> or
+<span class="nobreak"><span class="stt">--cross</span></span> argument to <span class="stt">racket</span>; see <a href="running-sa.html#%28part._mz-cmdline%29" data-pltdoc="x">Command Line</a>).
+The possible symbols are:</p><ul><li><p><a name="(idx._(gentag._443._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">infer</span> &#8212;<wbr></wbr> infer cross-platform mode based on
+whether <span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="RktPn">)</span> and <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=cross-system.html%23%2528def._%2528%2528lib._setup%252Fcross-system..rkt%2529._cross-system-type%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cross-system-type</a></span><span class="RktPn">)</span> report
+the same symbol</p></li><li><p><a name="(idx._(gentag._444._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">force</span> &#8212;<wbr></wbr> use cross-platform mode, even if the
+current and target system types are the same, because the current and target
+executables can be different</p></li></ul><p class="SHistory">Changed in version 6.8.0.2 of package <span class="stt">base</span>: Added <span class="RktVal">'</span><span class="RktVal">vm</span> mode.<br/>Changed in version 6.9.0.1: Added <span class="RktVal">'</span><span class="RktVal">cross</span> mode.<br/>Changed in version 7.1.0.6: Added <span class="RktVal">'</span><span class="RktVal">target-machine</span> mode.<br/>Changed in version 7.9.0.6: Added <span class="RktVal">'</span><span class="RktVal">os*</span> and <span class="RktVal">'</span><span class="RktVal">arch</span> modes.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._system-language+country))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-language%2Bcountry%29%29" class="RktValDef RktValLink" data-pltdoc="x">system-language+country</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns a string to identify the current user&rsquo;s language and
+country.</div></p><p>On Unix and Mac OS, the string is five characters: two lowercase
+ASCII letters for the language, an underscore, and two uppercase ASCII
+letters for the country. On Windows, the string can be arbitrarily
+long, but the language and country are in English (all ASCII letters
+or spaces) separated by an underscore.</p><p>On Unix, the result is determined by checking the
+<a name="(idx._(gentag._445._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">LC_ALL</span>, <a name="(idx._(gentag._446._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">LC_TYPE</span>, and
+<a name="(idx._(gentag._447._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">LANG</span> environment variables, in that order (and the
+result is used if the environment variable&rsquo;s value starts with two
+lowercase ASCII letters, an underscore, and two uppercase ASCII
+letters, followed by either nothing or a period). On Windows and
+Mac OS, the result is determined by system calls.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._system-library-subpath))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-library-subpath%29%29" class="RktValDef RktValLink" data-pltdoc="x">system-library-subpath</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">mode</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">cgc</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">3m</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">cs</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">gc</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a relative directory path. This string can be used to build
+paths to system-specific files. For example, when Racket is running
+on Solaris on a Sparc architecture, the subpath starts
+<span class="RktVal">"sparc-solaris"</span>, while the subpath for Windows on an i386
+architecture starts <span class="RktVal">"win32\\i386"</span>.</div></p><p>The optional <span class="RktVar">mode</span> argument specifies the relevant
+garbage-collection variant, which one of the possible results of
+<span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">gc</span><span class="RktPn">)</span>: <span class="RktVal">'</span><span class="RktVal">cgc</span>, <span class="RktVal">'</span><span class="RktVal">3m</span>, or <span class="RktVal">'</span><span class="RktVal">cs</span>. It can also
+be <span class="RktVal">#f</span>, in which case the result is independent of the
+garbage-collection variant.</p><p>Installation tools should use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=cross-system.html%23%2528def._%2528%2528lib._setup%252Fcross-system..rkt%2529._cross-system-library-subpath%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cross-system-library-subpath</a></span>,
+instead, to support cross-installation.</p><p class="SHistory">Changed in version 7.0 of package <span class="stt">base</span>: Added <span class="RktVal">'</span><span class="RktVal">cs</span> mode.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._version))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._version%29%29" class="RktValDef RktValLink" data-pltdoc="x">version</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns an immutable string indicating the currently executing version of
+Racket.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._banner))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._banner%29%29" class="RktValDef RktValLink" data-pltdoc="x">banner</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns an immutable string for Racket&rsquo;s start-up banner text (or the
+banner text for an embedding program, such as GRacket). The banner string
+ends with a newline.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-command-line-arguments))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._current-command-line-arguments%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-command-line-arguments</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vectorof%29%29" class="RktValLink" data-pltdoc="x">vectorof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._current-command-line-arguments%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-command-line-arguments</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">argv</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">argv</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vectorof%29%29" class="RktValLink" data-pltdoc="x">vectorof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that is initialized with command-line arguments when
+Racket starts (not including any command-line arguments that were
+treated as flags for the system).</div></p><p>On Unix and Mac OS, command-line arguments are provided to the
+Racket process as <a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte strings</span></a>. The arguments are converted to
+<a href="strings.html#%28tech._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">strings</span></a> using <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Flocale%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;string/locale</a></span> and
+<span class="RktVal">#\uFFFD</span> as the encoding-error character.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-thread-initial-stack-size))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._current-thread-initial-stack-size%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-thread-initial-stack-size</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._current-thread-initial-stack-size%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-thread-initial-stack-size</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">size</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">size</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that provides a hint about how much space to reserve for a
+newly created thread&rsquo;s local variables. The actual space used by a
+computation is affected by <a href="eval.html#%28tech._jit%29" class="techoutside" data-pltdoc="x"><span class="techinside">JIT</span></a> compilation, but it is
+otherwise platform-independent.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._vector-set-performance-stats!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._vector-set-performance-stats%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-set-performance-stats!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">results</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">thd</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">results</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thd</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="RktValLink" data-pltdoc="x">thread?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Sets elements in <span class="RktVar">results</span> to report current performance
+statistics. If <span class="RktVar">thd</span> is not <span class="RktVal">#f</span>, a particular set of
+thread-specific statistics are reported, otherwise a different set of
+global (within the current <a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">place</span></a>) statistics are reported.</div></p><p>For global statistics, up to <span style="font-style: italic"></span>1<span style="font-style: italic"></span>2<span style="font-style: italic"></span> elements are set in the vector,
+starting from the beginning. If <span class="RktVar">results</span> has <span style="font-style: italic">n</span> elements
+where <span style="font-style: italic">n &lt; </span>1<span style="font-style: italic"></span>2<span style="font-style: italic"></span>, then the <span style="font-style: italic">n</span> elements are set to the first
+<span style="font-style: italic">n</span> performance-statistics values. The reported statistics values
+are as follows, in the order that they are set within
+<span class="RktVar">results</span>:</p><ul><li><p><span class="RktVal">0</span>: The same value as returned by
+<span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-process-milliseconds%29%29" class="RktValLink" data-pltdoc="x">current-process-milliseconds</a></span>.</p></li><li><p><span class="RktVal">1</span>: The same value as returned
+by <span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-milliseconds%29%29" class="RktValLink" data-pltdoc="x">current-milliseconds</a></span>.</p></li><li><p><span class="RktVal">2</span>: The same value as returned
+by <span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-gc-milliseconds%29%29" class="RktValLink" data-pltdoc="x">current-gc-milliseconds</a></span>.</p></li><li><p><span class="RktVal">3</span>: The number of garbage collections performed since
+start-up within the current <a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">place</span></a>.</p></li><li><p><span class="RktVal">4</span>: The number of thread context switches performed since
+start-up.</p></li><li><p><span class="RktVal">5</span>: The number of internal stack overflows handled since
+start-up.</p></li><li><p><span class="RktVal">6</span>: The number of threads currently scheduled for
+execution (i.e., threads that are running, not suspended, and not
+unscheduled due to a synchronization).</p></li><li><p><span class="RktVal">7</span>: The number of syntax objects read from compiled code
+since start-up.</p></li><li><p><span class="RktVal">8</span>: The number of hash-table searches performed. When
+this counter reaches the maximum value of a <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a>, it
+overflows to the most negative <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a>.</p></li><li><p><span class="RktVal">9</span>: The number of additional hash slots searched to
+complete hash searches (using double hashing).  When this counter
+reaches the maximum value of a <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a>, it overflows to the
+most negative <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a>.</p></li><li><p><span class="RktVal">10</span>: The number of bytes allocated for machine code
+that is not reported by <span class="RktSym"><a href="garbagecollection.html#%28def._%28%28quote._~23~25kernel%29._current-memory-use%29%29" class="RktValLink" data-pltdoc="x">current-memory-use</a></span>.</p></li><li><p><span class="RktVal">11</span>: The peak number of allocated bytes just
+before a garbage collection.</p></li></ul><p>For thread-specific statistics, up to <span style="font-style: italic"></span>4<span style="font-style: italic"></span> elements are set in the
+vector:</p><ul><li><p><span class="RktVal">0</span>: <span class="RktVal">#t</span> if the thread is running, <span class="RktVal">#f</span>
+otherwise (same result as <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-running~3f%29%29" class="RktValLink" data-pltdoc="x">thread-running?</a></span>).</p></li><li><p><span class="RktVal">1</span>: <span class="RktVal">#t</span> if the thread has terminated,
+<span class="RktVal">#f</span> otherwise (same result as <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-dead~3f%29%29" class="RktValLink" data-pltdoc="x">thread-dead?</a></span>).</p></li><li><p><span class="RktVal">2</span>: <span class="RktVal">#t</span> if the thread is currently blocked on a
+synchronizable event (or sleeping for some number of milliseconds),
+<span class="RktVal">#f</span> otherwise.</p></li><li><p><span class="RktVal">3</span>: The number of bytes currently in use for the
+thread&rsquo;s continuation.</p></li></ul><p class="SHistory">Changed in version 6.1.1.8 of package <span class="stt">base</span>: Added vector position <span class="RktVal">11</span> for global statistics.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="envvars.html" title="backward to &quot;15.7 Environment Variables&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="os.html" title="up to &quot;15 Operating System&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Command-Line_Parsing.html" title="forward to &quot;15.9 Command-Line Parsing&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/security.html b/clones/docs.racket-lang.org/reference/security.html
new file mode 100644
index 00000000..851c8177
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/security.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14&nbsp;Reflection and Security</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewselflink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="security.html" class="tocviewselflink" data-pltdoc="x">Reflection and Security</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Namespaces.html" class="tocviewlink" data-pltdoc="x">Namespaces</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="eval.html" class="tocviewlink" data-pltdoc="x">Evaluation and Compilation</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="load-lang.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>load</span></span> Language</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="Module_Names_and_Loading.html" class="tocviewlink" data-pltdoc="x">Module Names and Loading</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="chaperones.html" class="tocviewlink" data-pltdoc="x">Impersonators and Chaperones</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="securityguards.html" class="tocviewlink" data-pltdoc="x">Security Guards</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="custodians.html" class="tocviewlink" data-pltdoc="x">Custodians</a></td></tr><tr><td align="right">14.8&nbsp;</td><td><a href="threadgroups.html" class="tocviewlink" data-pltdoc="x">Thread Groups</a></td></tr><tr><td align="right">14.9&nbsp;</td><td><a href="inspectors.html" class="tocviewlink" data-pltdoc="x">Structure Inspectors</a></td></tr><tr><td align="right">14.10&nbsp;</td><td><a href="modprotect.html" class="tocviewlink" data-pltdoc="x">Code Inspectors</a></td></tr><tr><td align="right">14.11&nbsp;</td><td><a href="plumbers.html" class="tocviewlink" data-pltdoc="x">Plumbers</a></td></tr><tr><td align="right">14.12&nbsp;</td><td><a href="Sandboxed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Sandboxed Evaluation</a></td></tr><tr><td align="right">14.13&nbsp;</td><td><a href="repl-module.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>repl</span></span> Library</a></td></tr><tr><td align="right">14.14&nbsp;</td><td><a href="linklets.html" class="tocviewlink" data-pltdoc="x">Linklets and the Core Compiler</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="sha.html" title="backward to &quot;13.11 Cryptographic Hashing&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Namespaces.html" title="forward to &quot;14.1 Namespaces&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;security&quot;">14<tt>&nbsp;</tt><a name="(part._security)"></a>Reflection and Security</h3><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Namespaces.html" class="toclink" data-pltdoc="x">14.1<span class="hspace">&nbsp;</span>Namespaces</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval.html" class="toclink" data-pltdoc="x">14.2<span class="hspace">&nbsp;</span>Evaluation and Compilation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="load-lang.html" class="toclink" data-pltdoc="x">14.3<span class="hspace">&nbsp;</span>The <span class="RktModLink"><span class="RktSym">racket/load</span></span> Language</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Module_Names_and_Loading.html" class="toclink" data-pltdoc="x">14.4<span class="hspace">&nbsp;</span>Module Names and Loading</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Module_Names_and_Loading.html#%28part._modnameresolver%29" class="toclink" data-pltdoc="x">14.4.1<span class="hspace">&nbsp;</span>Resolving Module Names</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Module_Names_and_Loading.html#%28part._modpathidx%29" class="toclink" data-pltdoc="x">14.4.2<span class="hspace">&nbsp;</span>Compiled Modules and References</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Module_Names_and_Loading.html#%28part._dynreq%29" class="toclink" data-pltdoc="x">14.4.3<span class="hspace">&nbsp;</span>Dynamic Module Access</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Module_Names_and_Loading.html#%28part._modcache%29" class="toclink" data-pltdoc="x">14.4.4<span class="hspace">&nbsp;</span>Module Cache</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="chaperones.html" class="toclink" data-pltdoc="x">14.5<span class="hspace">&nbsp;</span>Impersonators and Chaperones</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="chaperones.html#%28part._.Impersonator_.Constructors%29" class="toclink" data-pltdoc="x">14.5.1<span class="hspace">&nbsp;</span>Impersonator Constructors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="chaperones.html#%28part._.Chaperone_.Constructors%29" class="toclink" data-pltdoc="x">14.5.2<span class="hspace">&nbsp;</span>Chaperone Constructors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="chaperones.html#%28part._.Impersonator_.Properties%29" class="toclink" data-pltdoc="x">14.5.3<span class="hspace">&nbsp;</span>Impersonator Properties</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="securityguards.html" class="toclink" data-pltdoc="x">14.6<span class="hspace">&nbsp;</span>Security Guards</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="custodians.html" class="toclink" data-pltdoc="x">14.7<span class="hspace">&nbsp;</span>Custodians</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="threadgroups.html" class="toclink" data-pltdoc="x">14.8<span class="hspace">&nbsp;</span>Thread Groups</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="inspectors.html" class="toclink" data-pltdoc="x">14.9<span class="hspace">&nbsp;</span>Structure Inspectors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="modprotect.html" class="toclink" data-pltdoc="x">14.10<span class="hspace">&nbsp;</span>Code Inspectors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="plumbers.html" class="toclink" data-pltdoc="x">14.11<span class="hspace">&nbsp;</span>Plumbers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Sandboxed_Evaluation.html" class="toclink" data-pltdoc="x">14.12<span class="hspace">&nbsp;</span>Sandboxed Evaluation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Sandboxed_Evaluation.html#%28part._.Security_.Considerations%29" class="toclink" data-pltdoc="x">14.12.1<span class="hspace">&nbsp;</span>Security Considerations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Sandboxed_Evaluation.html#%28part._.Customizing_.Evaluators%29" class="toclink" data-pltdoc="x">14.12.2<span class="hspace">&nbsp;</span>Customizing Evaluators</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Sandboxed_Evaluation.html#%28part._.Interacting_with_.Evaluators%29" class="toclink" data-pltdoc="x">14.12.3<span class="hspace">&nbsp;</span>Interacting with Evaluators</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Sandboxed_Evaluation.html#%28part._.Miscellaneous%29" class="toclink" data-pltdoc="x">14.12.4<span class="hspace">&nbsp;</span>Miscellaneous</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="repl-module.html" class="toclink" data-pltdoc="x">14.13<span class="hspace">&nbsp;</span>The <span class="RktModLink"><span class="RktSym">racket/repl</span></span> Library</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="linklets.html" class="toclink" data-pltdoc="x">14.14<span class="hspace">&nbsp;</span>Linklets and the Core Compiler</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="sha.html" title="backward to &quot;13.11 Cryptographic Hashing&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Namespaces.html" title="forward to &quot;14.1 Namespaces&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/securityguards.html b/clones/docs.racket-lang.org/reference/securityguards.html
new file mode 100644
index 00000000..57f2aa0b
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/securityguards.html
@@ -0,0 +1,59 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14.6&nbsp;Security Guards</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewselflink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Namespaces.html" class="tocviewlink" data-pltdoc="x">Namespaces</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="eval.html" class="tocviewlink" data-pltdoc="x">Evaluation and Compilation</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="load-lang.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>load</span></span> Language</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="Module_Names_and_Loading.html" class="tocviewlink" data-pltdoc="x">Module Names and Loading</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="chaperones.html" class="tocviewlink" data-pltdoc="x">Impersonators and Chaperones</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="securityguards.html" class="tocviewselflink" data-pltdoc="x">Security Guards</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="custodians.html" class="tocviewlink" data-pltdoc="x">Custodians</a></td></tr><tr><td align="right">14.8&nbsp;</td><td><a href="threadgroups.html" class="tocviewlink" data-pltdoc="x">Thread Groups</a></td></tr><tr><td align="right">14.9&nbsp;</td><td><a href="inspectors.html" class="tocviewlink" data-pltdoc="x">Structure Inspectors</a></td></tr><tr><td align="right">14.10&nbsp;</td><td><a href="modprotect.html" class="tocviewlink" data-pltdoc="x">Code Inspectors</a></td></tr><tr><td align="right">14.11&nbsp;</td><td><a href="plumbers.html" class="tocviewlink" data-pltdoc="x">Plumbers</a></td></tr><tr><td align="right">14.12&nbsp;</td><td><a href="Sandboxed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Sandboxed Evaluation</a></td></tr><tr><td align="right">14.13&nbsp;</td><td><a href="repl-module.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>repl</span></span> Library</a></td></tr><tr><td align="right">14.14&nbsp;</td><td><a href="linklets.html" class="tocviewlink" data-pltdoc="x">Linklets and the Core Compiler</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._security-guard~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">security-<wbr></wbr>guard?</span></span></a></td></tr><tr><td><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._make-security-guard%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>security-<wbr></wbr>guard</span></span></a></td></tr><tr><td><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._current-security-guard%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>security-<wbr></wbr>guard</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="chaperones.html" title="backward to &quot;14.5 Impersonators and Chaperones&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="custodians.html" title="forward to &quot;14.7 Custodians&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;securityguards&quot;">14.6<tt>&nbsp;</tt><a name="(part._securityguards)"></a>Security Guards</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._security-guard~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._security-guard~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">security-guard?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a security guard value as created
+by <span class="RktSym"><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._make-security-guard%29%29" class="RktValLink" data-pltdoc="x">make-security-guard</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p>A <a name="(tech._security._guard)"></a><span style="font-style: italic">security guard</span> provides a set of access-checking
+procedures to be called when a thread initiates access of a file,
+directory, or network connection through a primitive procedure. For
+example, when a thread calls <span class="RktSym"><a href="file-ports.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._open-input-file%29%29" class="RktValLink" data-pltdoc="x">open-input-file</a></span>, the thread&rsquo;s
+current security guard is consulted to check whether the thread is
+allowed read access to the file. If access is granted, the thread
+receives a port that it may use indefinitely, regardless of changes to
+the security guard (although the port&rsquo;s custodian could shut down the
+port; see <a href="custodians.html" data-pltdoc="x">Custodians</a>).</p><p>A thread&rsquo;s current security guard is determined by the
+<span class="RktSym"><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._current-security-guard%29%29" class="RktValLink" data-pltdoc="x">current-security-guard</a></span> parameter. Every security guard has a
+parent, and a parent&rsquo;s access procedures are called whenever a child&rsquo;s
+access procedures are called. Thus, a thread cannot increase its own
+access arbitrarily by installing a new guard. The initial security
+guard enforces no access restrictions other than those enforced by the
+host platform.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-security-guard))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._make-security-guard%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-security-guard</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">parent</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">file-guard</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">network-guard</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">link-guard</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._security-guard~3f%29%29" class="RktValLink" data-pltdoc="x">security-guard?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">parent</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._security-guard~3f%29%29" class="RktValLink" data-pltdoc="x">security-guard?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">file-guard</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">network-guard</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">65535</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">server</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">client</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">link-guard</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new security guard as child of <span class="RktVar">parent</span>.</div></p><p>The <span class="RktVar">file-guard</span> procedure must accept three arguments:</p><ul><li><p>a symbol for the primitive procedure that triggered the access
+check, which is useful for raising an exception to deny access.</p></li><li><p>a path (see <a href="pathutils.html" data-pltdoc="x">Paths</a>) or <span class="RktVal">#f</span> for
+pathless queries, such as <span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span><span class="RktPn">)</span>,
+<span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._filesystem-root-list%29%29" class="RktValLink" data-pltdoc="x">filesystem-root-list</a></span><span class="RktPn">)</span>, and <span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._find-system-path%29%29" class="RktValLink" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVar">symbol</span><span class="RktPn">)</span>. A path provided to <span class="RktVar">file-guard</span> is not expanded or
+otherwise normalized before checking access; it may be a relative
+path, for example.</p></li><li><p>a list containing one or more of the following
+ symbols:</p><ul><li><p><a name="(idx._(gentag._280._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">read</span> &#8212;<wbr></wbr> read a file or directory</p></li><li><p><a name="(idx._(gentag._281._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">write</span> &#8212;<wbr></wbr> modify or create a file or
+directory</p></li><li><p><a name="(idx._(gentag._282._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">execute</span> &#8212;<wbr></wbr> execute a file</p></li><li><p><a name="(idx._(gentag._283._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">delete</span> &#8212;<wbr></wbr> delete a file or directory</p></li><li><p><a name="(idx._(gentag._284._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">exists</span> &#8212;<wbr></wbr> determine whether a file or
+directory exists, or that a path string is well-formed</p></li></ul><p>The <span class="RktVal">'</span><span class="RktVal">exists</span> symbol is never combined with other symbols in
+the last argument to <span class="RktVar">file-guard</span>, but any other combination is
+possible. When the second argument to <span class="RktVar">file-guard</span> is <span class="RktVal">#f</span>,
+the last argument always contains only <span class="RktVal">'</span><span class="RktVal">exists</span>.</p></li></ul><p>The <span class="RktVar">network-guard</span> procedure must accept four arguments:</p><ul><li><p>a symbol for the primitive operation that triggered the access
+check, which is useful for raising an exception to deny access.</p></li><li><p>an immutable string representing the target hostname for a
+client connection or the accepting hostname for a listening server;
+<span class="RktVal">#f</span> for a listening server or UDP socket that accepts
+connections at all of the host&rsquo;s address; or <span class="RktVal">#f</span> an unbound
+UDP socket.</p></li><li><p>an exact integer between <span class="RktVal">1</span> and <span class="RktVal">65535</span>
+(inclusive) representing the port number, or <span class="RktVal">#f</span> for an
+unbound UDP socket. In the case of a client connection, the port
+number is the target port on the server. For a listening server, the
+port number is the local port number.</p></li><li><p>a symbol, either <a name="(idx._(gentag._285._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">client</span> or
+<a name="(idx._(gentag._286._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">server</span>, indicating whether the check is for the
+creation of a client connection or a listening server. The opening of
+an unbound UDP socket is identified as a <span class="RktVal">'</span><span class="RktVal">client</span> connection;
+explicitly binding the socket is identified as a <span class="RktVal">'</span><span class="RktVal">server</span>
+action.</p></li></ul><p>The <span class="RktVar">link-guard</span> argument can be <span class="RktVal">#f</span> or a procedure of
+three arguments:</p><ul><li><p>a symbol for the primitive procedure that triggered the access
+check, which is useful for raising an exception to deny access.</p></li><li><p>a complete path (see <a href="pathutils.html" data-pltdoc="x">Paths</a>) representing the
+file to create as link.</p></li><li><p>a path representing the content of the link, which may be
+relative the second-argument path; this path is not expanded or
+otherwise normalized before checking access.</p></li></ul><p>If <span class="RktVar">link-guard</span> is <span class="RktVal">#f</span>, then a default
+procedure is used that always raises <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span>.</p><p>The return value of <span class="RktVar">file-guard</span>, <span class="RktVar">network-guard</span>, or
+<span class="RktVar">link-guard</span> is ignored. To deny access, the procedure must
+raise an exception or otherwise escape from the context of the
+primitive call. If the procedure returns, the parent&rsquo;s corresponding
+procedure is called on the same inputs, and so on up the chain of
+security guards.</p><p>The <span class="RktVar">file-guard</span>, <span class="RktVar">network-guard</span>, and
+<span class="RktVar">link-guard</span> procedures are invoked in the thread that called
+the access-checked primitive. Breaks may or may not be enabled (see
+<a href="breakhandler.html" data-pltdoc="x">Breaks</a>). Full continuation jumps are blocked going
+into or out of the <span class="RktVar">file-guard</span> or <span class="RktVar">network-guard</span> call
+(see <a href="eval-model.html#%28part._prompt-model%29" data-pltdoc="x">Prompts, Delimited Continuations, and Barriers</a>).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-security-guard))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._current-security-guard%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-security-guard</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._security-guard~3f%29%29" class="RktValLink" data-pltdoc="x">security-guard?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._current-security-guard%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-security-guard</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">guard</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">guard</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="securityguards.html#%28def._%28%28quote._~23~25kernel%29._security-guard~3f%29%29" class="RktValLink" data-pltdoc="x">security-guard?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the current security guard that controls
+access to the filesystem and network.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="chaperones.html" title="backward to &quot;14.5 Impersonators and Chaperones&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="custodians.html" title="forward to &quot;14.7 Custodians&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/semaphore.html b/clones/docs.racket-lang.org/reference/semaphore.html
new file mode 100644
index 00000000..150f09ab
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/semaphore.html
@@ -0,0 +1,52 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>11.2.3&nbsp;Semaphores</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewselflink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.1&nbsp;</td><td><a href="threads.html" class="tocviewlink" data-pltdoc="x">Threads</a></td></tr><tr><td align="right">11.2&nbsp;</td><td><a href="all-sync.html" class="tocviewselflink" data-pltdoc="x">Synchronization</a></td></tr><tr><td align="right">11.3&nbsp;</td><td><a href="thread-local-storage.html" class="tocviewlink" data-pltdoc="x">Thread-<wbr></wbr>Local Storage</a></td></tr><tr><td align="right">11.4&nbsp;</td><td><a href="futures.html" class="tocviewlink" data-pltdoc="x">Futures</a></td></tr><tr><td align="right">11.5&nbsp;</td><td><a href="places.html" class="tocviewlink" data-pltdoc="x">Places</a></td></tr><tr><td align="right">11.6&nbsp;</td><td><a href="engine.html" class="tocviewlink" data-pltdoc="x">Engines</a></td></tr><tr><td align="right">11.7&nbsp;</td><td><a href="memory-order.html" class="tocviewlink" data-pltdoc="x">Machine Memory Order</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>11.2&nbsp;</td><td><a href="all-sync.html" class="tocviewlink" data-pltdoc="x">Synchronization</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.2.1&nbsp;</td><td><a href="sync.html" class="tocviewlink" data-pltdoc="x">Events</a></td></tr><tr><td align="right">11.2.2&nbsp;</td><td><a href="channel.html" class="tocviewlink" data-pltdoc="x">Channels</a></td></tr><tr><td align="right">11.2.3&nbsp;</td><td><a href="semaphore.html" class="tocviewselflink" data-pltdoc="x">Semaphores</a></td></tr><tr><td align="right">11.2.4&nbsp;</td><td><a href="async-channel.html" class="tocviewlink" data-pltdoc="x">Buffered Asynchronous Channels</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">semaphore?</span></span></a></td></tr><tr><td><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._make-semaphore%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>semaphore</span></span></a></td></tr><tr><td><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-post%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">semaphore-<wbr></wbr>post</span></span></a></td></tr><tr><td><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">semaphore-<wbr></wbr>wait</span></span></a></td></tr><tr><td><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-try-wait~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">semaphore-<wbr></wbr>try-<wbr></wbr>wait?</span></span></a></td></tr><tr><td><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%2Fenable-break%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">semaphore-<wbr></wbr>wait/<span class="mywbr"> &nbsp;</span>enable-<wbr></wbr>break</span></span></a></td></tr><tr><td><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-peek-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">semaphore-<wbr></wbr>peek-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-peek-evt~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">semaphore-<wbr></wbr>peek-<wbr></wbr>evt?</span></span></a></td></tr><tr><td><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._call-with-semaphore%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>semaphore</span></span></a></td></tr><tr><td><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._call-with-semaphore%2Fenable-break%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>semaphore/<span class="mywbr"> &nbsp;</span>enable-<wbr></wbr>break</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="channel.html" title="backward to &quot;11.2.2 Channels&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="all-sync.html" title="up to &quot;11.2 Synchronization&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="async-channel.html" title="forward to &quot;11.2.4 Buffered Asynchronous Channels&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;semaphore&quot;">11.2.3<tt>&nbsp;</tt><a name="(part._semaphore)"></a>Semaphores</h5><p>A <a name="(tech._semaphore)"></a><span style="font-style: italic">semaphore</span> has an internal counter; when this counter is
+zero, the semaphore can block a thread&rsquo;s execution (through
+<span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%29%29" class="RktValLink" data-pltdoc="x">semaphore-wait</a></span>) until another thread increments the counter
+(using <span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-post%29%29" class="RktValLink" data-pltdoc="x">semaphore-post</a></span>). The maximum value for a semaphore&rsquo;s
+internal counter is platform-specific, but always at least
+<span class="RktVal">10000</span>.</p><p>A semaphore&rsquo;s counter is updated in a single-threaded manner, so that
+semaphores can be used for reliable synchronization. Semaphore waiting
+is <span style="font-style: italic">fair</span>: if a thread is blocked on a semaphore and the
+semaphore&rsquo;s internal value is non-zero infinitely often, then the
+thread is eventually unblocked.</p><p>In addition to its use with semaphore-specific procedures, a semaphore
+can be used as a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> (see <a href="sync.html" data-pltdoc="x">Events</a>).
+A semaphore is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when
+<span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%29%29" class="RktValLink" data-pltdoc="x">semaphore-wait</a></span> would not block. Upon synchronization, the
+semaphore&rsquo;s counter is decremented, and the <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> of a semaphore is the semaphore itself.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._semaphore~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">semaphore?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="semaphore.html#%28tech._semaphore%29" class="techoutside" data-pltdoc="x"><span class="techinside">semaphore</span></a>,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-semaphore))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._make-semaphore%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-semaphore</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">init</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore~3f%29%29" class="RktValLink" data-pltdoc="x">semaphore?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">init</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates and returns a new semaphore with the counter initially set to
+<span class="RktVar">init</span>. If <span class="RktVar">init</span> is larger than a semaphore&rsquo;s maximum
+internal counter value, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span> exception is raised.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._semaphore-post))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-post%29%29" class="RktValDef RktValLink" data-pltdoc="x">semaphore-post</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sema</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sema</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore~3f%29%29" class="RktValLink" data-pltdoc="x">semaphore?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Increments the
+semaphore&rsquo;s internal counter and returns <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>. If the
+semaphore&rsquo;s internal counter has already reached its maximum value,
+the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span> exception is raised.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._semaphore-wait))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%29%29" class="RktValDef RktValLink" data-pltdoc="x">semaphore-wait</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sema</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sema</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore~3f%29%29" class="RktValLink" data-pltdoc="x">semaphore?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Blocks until the
+internal counter for semaphore <span class="RktVar">sema</span> is non-zero. When the
+counter is non-zero, it is decremented and <span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%29%29" class="RktValLink" data-pltdoc="x">semaphore-wait</a></span>
+returns <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._semaphore-try-wait~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-try-wait~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">semaphore-try-wait?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sema</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sema</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore~3f%29%29" class="RktValLink" data-pltdoc="x">semaphore?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like
+<span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%29%29" class="RktValLink" data-pltdoc="x">semaphore-wait</a></span>, but <span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-try-wait~3f%29%29" class="RktValLink" data-pltdoc="x">semaphore-try-wait?</a></span> never blocks
+execution.  If <span class="RktVar">sema</span>&rsquo;s internal counter is zero,
+<span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-try-wait~3f%29%29" class="RktValLink" data-pltdoc="x">semaphore-try-wait?</a></span> returns <span class="RktVal">#f</span> immediately without
+decrementing the counter. If <span class="RktVar">sema</span>&rsquo;s counter is positive, it
+is decremented and <span class="RktVal">#t</span> is returned.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._semaphore-wait/enable-break))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%2Fenable-break%29%29" class="RktValDef RktValLink" data-pltdoc="x">semaphore-wait/enable-break</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sema</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sema</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore~3f%29%29" class="RktValLink" data-pltdoc="x">semaphore?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like
+<span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%29%29" class="RktValLink" data-pltdoc="x">semaphore-wait</a></span>, but breaking is enabled (see
+<a href="breakhandler.html" data-pltdoc="x">Breaks</a>) while waiting on <span class="RktVar">sema</span>. If
+breaking is disabled when <span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">semaphore-wait/enable-break</a></span> is
+called, then either the semaphore&rsquo;s counter is decremented or the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak%29%29" class="RktValLink" data-pltdoc="x">exn:break</a></span> exception is raised, but not both.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._semaphore-peek-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-peek-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">semaphore-peek-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sema</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-peek-evt~3f%29%29" class="RktValLink" data-pltdoc="x">semaphore-peek-evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sema</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore~3f%29%29" class="RktValLink" data-pltdoc="x">semaphore?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates and
+returns a new <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> (for use with <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span>, for
+example) that is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when <span class="RktVar">sema</span> is ready,
+but synchronizing
+the event does not decrement <span class="RktVar">sema</span>&rsquo;s internal count.
+The <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> of a semaphore-peek event is the semaphore-peek event itself.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._semaphore-peek-evt~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-peek-evt~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">semaphore-peek-evt?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a semaphore wrapper produced by
+<span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-peek-evt%29%29" class="RktValLink" data-pltdoc="x">semaphore-peek-evt</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._call-with-semaphore))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._call-with-semaphore%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-semaphore</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">sema</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">try-fail-thunk</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sema</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore~3f%29%29" class="RktValLink" data-pltdoc="x">semaphore?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">try-fail-thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Waits on <span class="RktVar">sema</span> using <span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%29%29" class="RktValLink" data-pltdoc="x">semaphore-wait</a></span>, calls
+<span class="RktVar">proc</span> with all <span class="RktVar">arg</span>s, and then posts to
+<span class="RktVar">sema</span>. A <a href="eval-model.html#%28tech._continuation._barrier%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation barrier</span></a> blocks full continuation jumps
+into or out of <span class="RktVar">proc</span> (see <a href="eval-model.html#%28part._prompt-model%29" data-pltdoc="x">Prompts, Delimited Continuations, and Barriers</a>), but
+escape jumps are allowed, and <span class="RktVar">sema</span> is posted on escape. If
+<span class="RktVar">try-fail-thunk</span> is provided and is not <span class="RktVal">#f</span>, then
+<span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-try-wait~3f%29%29" class="RktValLink" data-pltdoc="x">semaphore-try-wait?</a></span> is called on <span class="RktVar">sema</span> instead of
+<span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%29%29" class="RktValLink" data-pltdoc="x">semaphore-wait</a></span>, and <span class="RktVar">try-fail-thunk</span> is called if the
+wait fails.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._call-with-semaphore/enable-break))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._call-with-semaphore%2Fenable-break%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-semaphore/enable-break</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">sema</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">try-fail-thunk</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sema</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore~3f%29%29" class="RktValLink" data-pltdoc="x">semaphore?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">try-fail-thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._call-with-semaphore%29%29" class="RktValLink" data-pltdoc="x">call-with-semaphore</a></span>, except that
+<span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">semaphore-wait/enable-break</a></span> is used with <span class="RktVar">sema</span> in
+non-try mode. When <span class="RktVar">try-fail-thunk</span> is provided and not
+<span class="RktVal">#f</span>, then breaks are enabled around the use of
+<span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-try-wait~3f%29%29" class="RktValLink" data-pltdoc="x">semaphore-try-wait?</a></span> on <span class="RktVar">sema</span>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="channel.html" title="backward to &quot;11.2.2 Channels&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="all-sync.html" title="up to &quot;11.2 Synchronization&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="async-channel.html" title="forward to &quot;11.2.4 Buffered Asynchronous Channels&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/sequences.html b/clones/docs.racket-lang.org/reference/sequences.html
new file mode 100644
index 00000000..eeeaf41a
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/sequences.html
@@ -0,0 +1,282 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.16.1&nbsp;Sequences</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewselflink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.16.1&nbsp;</td><td><a href="sequences.html" class="tocviewselflink" data-pltdoc="x">Sequences</a></td></tr><tr><td align="right">4.16.2&nbsp;</td><td><a href="streams.html" class="tocviewlink" data-pltdoc="x">Streams</a></td></tr><tr><td align="right">4.16.3&nbsp;</td><td><a href="Generators.html" class="tocviewlink" data-pltdoc="x">Generators</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_3&quot;);">&#9658;</a></td><td>4.16.1&nbsp;</td><td><a href="sequences.html" class="tocviewselflink" data-pltdoc="x">Sequences</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_3"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.16.1.1&nbsp;</td><td><a href="sequences.html#%28part._.Sequence_.Predicate_and_.Constructors%29" class="tocviewlink" data-pltdoc="x">Sequence Predicate and Constructors</a></td></tr><tr><td align="right">4.16.1.2&nbsp;</td><td><a href="sequences.html#%28part._.Sequence_.Conversion%29" class="tocviewlink" data-pltdoc="x">Sequence Conversion</a></td></tr><tr><td align="right">4.16.1.3&nbsp;</td><td><a href="sequences.html#%28part._more-sequences%29" class="tocviewlink" data-pltdoc="x">Additional Sequence Operations</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">4.16.1.1<tt>&nbsp;</tt></span><a href="sequences.html#%28part._.Sequence_.Predicate_and_.Constructors%29" class="tocsubseclink" data-pltdoc="x">Sequence Predicate and Constructors</a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence?</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>range</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-inclusive-range%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>inclusive-<wbr></wbr>range</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-naturals%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>naturals</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>list</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mlist%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>mlist</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-vector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>vector</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-string%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>string</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-bytes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-port%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-input-port-bytes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>input-<wbr></wbr>port-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-input-port-chars%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>input-<wbr></wbr>port-<wbr></wbr>chars</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-lines%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>lines</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-bytes-lines%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>bytes-<wbr></wbr>lines</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>hash</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash-keys%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>hash-<wbr></wbr>keys</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash-values%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>hash-<wbr></wbr>values</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash-pairs%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>hash-<wbr></wbr>pairs</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mutable-hash%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>mutable-<wbr></wbr>hash</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mutable-hash-keys%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>mutable-<wbr></wbr>hash-<wbr></wbr>keys</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mutable-hash-values%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>mutable-<wbr></wbr>hash-<wbr></wbr>values</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mutable-hash-pairs%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>mutable-<wbr></wbr>hash-<wbr></wbr>pairs</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-immutable-hash%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>immutable-<wbr></wbr>hash</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-immutable-hash-keys%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>immutable-<wbr></wbr>hash-<wbr></wbr>keys</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-immutable-hash-values%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>immutable-<wbr></wbr>hash-<wbr></wbr>values</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-immutable-hash-pairs%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>immutable-<wbr></wbr>hash-<wbr></wbr>pairs</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-weak-hash%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>weak-<wbr></wbr>hash</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-weak-hash-keys%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>weak-<wbr></wbr>hash-<wbr></wbr>keys</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-weak-hash-values%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>weak-<wbr></wbr>hash-<wbr></wbr>values</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-weak-hash-pairs%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>weak-<wbr></wbr>hash-<wbr></wbr>pairs</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-ephemeron-hash%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>ephemeron-<wbr></wbr>hash</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-ephemeron-hash-keys%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>ephemeron-<wbr></wbr>hash-<wbr></wbr>keys</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-ephemeron-hash-values%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>ephemeron-<wbr></wbr>hash-<wbr></wbr>values</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-ephemeron-hash-pairs%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>ephemeron-<wbr></wbr>hash-<wbr></wbr>pairs</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-directory%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>directory</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-producer%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>producer</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-value%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>value</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-indexed%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>indexed</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-sequences%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>sequences</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-cycle%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>cycle</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-parallel%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>parallel</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-values-sequence%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>values-<wbr></wbr>sequence</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-values%2A-sequence%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>values*-<wbr></wbr>sequence</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._stop-before%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stop-<wbr></wbr>before</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._stop-after%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stop-<wbr></wbr>after</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-do-sequence%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>do-<wbr></wbr>sequence</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3asequence%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>sequence</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.16.1.2<tt>&nbsp;</tt></span><a href="sequences.html#%28part._.Sequence_.Conversion%29" class="tocsubseclink" data-pltdoc="x">Sequence Conversion</a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-~3estream%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-<wbr></wbr>&gt;stream</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-<wbr></wbr>generate</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-<wbr></wbr>generate*</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.16.1.3<tt>&nbsp;</tt></span><a href="sequences.html#%28part._more-sequences%29" class="tocsubseclink" data-pltdoc="x">Additional Sequence Operations</a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._empty-sequence%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">empty-<wbr></wbr>sequence</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-~3elist%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-<wbr></wbr>&gt;list</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-tail%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-<wbr></wbr>tail</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-append%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-<wbr></wbr>append</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-map%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-<wbr></wbr>map</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-andmap%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-<wbr></wbr>andmap</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-ormap%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-<wbr></wbr>ormap</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-for-each%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-<wbr></wbr>for-<wbr></wbr>each</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-fold%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-<wbr></wbr>fold</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-count%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-<wbr></wbr>count</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-filter%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-<wbr></wbr>filter</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-add-between%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence-<wbr></wbr>add-<wbr></wbr>between</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence%2Fc%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sequence/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.16.1.3.1<tt>&nbsp;</tt></span><a href="sequences.html#%28part._.Additional_.Sequence_.Constructors%29" class="tocsubseclink" data-pltdoc="x">Additional Sequence Constructors</a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._in-syntax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._in-slice%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>slice</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="sequences_streams.html" title="backward to &quot;4.16 Sequences and Streams&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="sequences_streams.html" title="up to &quot;4.16 Sequences and Streams&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="streams.html" title="forward to &quot;4.16.2 Streams&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;sequences&quot;">4.16.1<tt>&nbsp;</tt><a name="(part._sequences)"></a>Sequences</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=for.html%23%2528part._sequences%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Sequence Constructors</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces sequences.</p></blockquote></blockquote></blockquote><p>A <a name="(tech._sequence)"></a><span style="font-style: italic">sequence</span> encapsulates an ordered collection of values.
+The elements of a sequence can be extracted with one of the
+<span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> syntactic forms, with the procedures returned by
+<span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%29%29" class="RktValLink" data-pltdoc="x">sequence-generate</a></span>, or by converting the sequence into a
+<a href="streams.html#%28tech._stream%29" class="techoutside" data-pltdoc="x"><span class="techinside">stream</span></a>.</p><p>The sequence datatype overlaps with many other datatypes.  Among
+built-in datatypes, the sequence datatype includes the following:</p><ul><li><p>exact nonnegative integers (see below)</p></li><li><p>strings (see <a href="strings.html" data-pltdoc="x">Strings</a>)</p></li><li><p>byte strings (see <a href="bytestrings.html" data-pltdoc="x">Byte Strings</a>)</p></li><li><p>lists (see <a href="pairs.html" data-pltdoc="x">Pairs and Lists</a>)</p></li><li><p>mutable lists (see <a href="mpairs.html" data-pltdoc="x">Mutable Pairs and Lists</a>)</p></li><li><p>vectors (see <a href="vectors.html" data-pltdoc="x">Vectors</a>)</p></li><li><p>flvectors (see <a href="flonums.html#%28part._flvectors%29" data-pltdoc="x">Flonum Vectors</a>)</p></li><li><p>fxvectors (see <a href="fixnums.html#%28part._fxvectors%29" data-pltdoc="x">Fixnum Vectors</a>)</p></li><li><p>hash tables (see <a href="hashtables.html" data-pltdoc="x">Hash Tables</a>)</p></li><li><p>dictionaries (see <a href="dicts.html" data-pltdoc="x">Dictionaries</a>)</p></li><li><p>sets (see <a href="sets.html" data-pltdoc="x">Sets</a>)</p></li><li><p>input ports (see <a href="ports.html" data-pltdoc="x">Ports</a>)</p></li><li><p>streams (see <a href="streams.html" data-pltdoc="x">Streams</a>)</p></li></ul><p>An <a href="numbers.html#%28tech._exact._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">exact number</span></a> <span class="RktVar">k</span> that is a non-negative
+<a href="numbers.html#%28tech._integer%29" class="techoutside" data-pltdoc="x"><span class="techinside">integer</span></a> acts as a sequence similar to <span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="stt"> </span><span class="RktVar">k</span><span class="RktPn">)</span>,
+except that <span class="RktVar">k</span> by itself is not a <a href="streams.html#%28tech._stream%29" class="techoutside" data-pltdoc="x"><span class="techinside">stream</span></a>.</p><p>Custom sequences can be defined using structure type properties.  The
+easiest method to define a custom sequence is to use the
+<span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._gen~3astream%29%29" class="RktValLink" data-pltdoc="x">gen:stream</a></span> <a href="struct-generics.html#%28tech._generic._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">generic interface</span></a>. Streams are a suitable
+abstraction for data structures that are directly iterable.  For
+example, a list is directly iterable with <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._first%29%29" class="RktValLink" data-pltdoc="x">first</a></span> and
+<span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span>. On the other hand, vectors are not directly iterable:
+iteration has to go through an index. For data structures that are not
+directly iterable, the <a name="(tech._iterator)"></a><span style="font-style: italic">iterator</span> for the data structure can
+be defined to be a stream (e.g., a structure containing the index of a
+vector).</p><p>For example, unrolled linked lists (represented as a list of vectors)
+themselves do not fit the stream abstraction, but have index-based
+iterators that can be represented as streams:</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">unrolled-list-iterator</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">idx</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._gen~3astream%29%29" class="RktValLink" data-pltdoc="x">gen:stream</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-empty~3f%29%29" class="RktValLink" data-pltdoc="x">stream-empty?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">iter</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">unrolled-list-iterator-lst</span><span class="hspace">&nbsp;</span><span class="RktSym">iter</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null~3f%29%29" class="RktValLink" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e~3d%29%29" class="RktValLink" data-pltdoc="x">&gt;=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">unrolled-list-iterator-idx</span><span class="hspace">&nbsp;</span><span class="RktSym">iter</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="RktValLink" data-pltdoc="x">vector-length</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._first%29%29" class="RktValLink" data-pltdoc="x">first</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null~3f%29%29" class="RktValLink" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-first%29%29" class="RktValLink" data-pltdoc="x">stream-first</a></span><span class="hspace">&nbsp;</span><span class="RktSym">iter</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._first%29%29" class="RktValLink" data-pltdoc="x">first</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">unrolled-list-iterator-lst</span><span class="hspace">&nbsp;</span><span class="RktSym">iter</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">unrolled-list-iterator-idx</span><span class="hspace">&nbsp;</span><span class="RktSym">iter</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-rest%29%29" class="RktValLink" data-pltdoc="x">stream-rest</a></span><span class="hspace">&nbsp;</span><span class="RktSym">iter</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">idx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">unrolled-list-iterator-idx</span><span class="hspace">&nbsp;</span><span class="RktSym">iter</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">unrolled-list-iterator-lst</span><span class="hspace">&nbsp;</span><span class="RktSym">iter</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e~3d%29%29" class="RktValLink" data-pltdoc="x">&gt;=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">idx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="RktValLink" data-pltdoc="x">vector-length</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._first%29%29" class="RktValLink" data-pltdoc="x">first</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">unrolled-list-iterator</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">unrolled-list-iterator</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">idx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-unrolled-list-iterator</span><span class="hspace">&nbsp;</span><span class="RktSym">ul</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">unrolled-list-iterator</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">unrolled-list-lov</span><span class="hspace">&nbsp;</span><span class="RktSym">ul</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">unrolled-list</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lov</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:property</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3asequence%29%29" class="RktValLink" data-pltdoc="x">prop:sequence</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">make-unrolled-list-iterator</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ul1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">unrolled-list</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">cracker</span><span class="hspace">&nbsp;</span><span class="RktVal">biscuit</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">cookie</span><span class="hspace">&nbsp;</span><span class="RktVal">scone</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">ul1</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(cracker biscuit cookie scone)</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3asequence%29%29" class="RktValLink" data-pltdoc="x">prop:sequence</a></span> property provides more flexibility in
+specifying iteration, such as when a pre-processing step is needed to
+prepare the data for iteration.  The <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-do-sequence%29%29" class="RktValLink" data-pltdoc="x">make-do-sequence</a></span>
+function creates a sequence given a thunk that returns procedures to
+implement a sequence, and the <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3asequence%29%29" class="RktValLink" data-pltdoc="x">prop:sequence</a></span> property can be
+associated with a structure type to implement its implicit conversion
+to a sequence.</p><p>For most sequence types, extracting elements from a sequence has no
+side-effect on the original sequence value; for example, extracting
+the sequence of elements from a list does not change the list.  For
+other sequence types, each extraction implies a side effect; for
+example, extracting the sequence of bytes from a port causes the bytes
+to be read from the port. <a name="(elem._sequence-state)"></a>A sequence&rsquo;s state may either span all uses
+of the sequence, as for a port, or it may be confined to each distinct
+time that a sequence is <a name="(tech._initiate)"></a><span style="font-style: italic">initiate</span>d by a <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> form,
+<span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-~3estream%29%29" class="RktValLink" data-pltdoc="x">sequence-&gt;stream</a></span>, <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%29%29" class="RktValLink" data-pltdoc="x">sequence-generate</a></span>, or
+<span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%2A%29%29" class="RktValLink" data-pltdoc="x">sequence-generate*</a></span>. Concretely, the thunk passed to
+<span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-do-sequence%29%29" class="RktValLink" data-pltdoc="x">make-do-sequence</a></span> is called to <a href="sequences.html#%28tech._initiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">initiate</span></a> the sequence
+each time the sequence is used. Accordingly, different sequences behave
+differently when they are <a href="sequences.html#%28tech._initiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">initiate</span></a>d multiple times.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">double-initiate</span><span class="hspace">&nbsp;</span><span class="RktSym">s1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">initiate the sequence twice</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">more?.1</span><span class="hspace">&nbsp;</span><span class="RktSym">next.1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%29%29" class="RktValLink" data-pltdoc="x">sequence-generate</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">more?.2</span><span class="hspace">&nbsp;</span><span class="RktSym">next.2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%29%29" class="RktValLink" data-pltdoc="x">sequence-generate</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">alternate fetching from sequence via the two initiations</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">next.1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">next.2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">next.1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">next.2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">double-initiate</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"abcdef"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(97 98 99 100)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">double-initiate</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">97</span><span class="hspace">&nbsp;</span><span class="RktVal">98</span><span class="hspace">&nbsp;</span><span class="RktVal">99</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(97 97 98 98)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">double-initiate</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-naturals%29%29" class="RktValLink" data-pltdoc="x">in-naturals</a></span><span class="hspace">&nbsp;</span><span class="RktVal">97</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(97 97 98 98)</span></p></td></tr></table></blockquote><p>Also, subsequent elements in a sequence may be &ldquo;consumed&rdquo; just by calling the
+first result of <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%29%29" class="RktValLink" data-pltdoc="x">sequence-generate</a></span>, even if the second
+result is never called.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">double-initiate-and-use-more?</span><span class="hspace">&nbsp;</span><span class="RktSym">s1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">initiate the sequence twice</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">more?.1</span><span class="hspace">&nbsp;</span><span class="RktSym">next.1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%29%29" class="RktValLink" data-pltdoc="x">sequence-generate</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">more?.2</span><span class="hspace">&nbsp;</span><span class="RktSym">next.2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%29%29" class="RktValLink" data-pltdoc="x">sequence-generate</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">alternate fetching from sequence via the two initiations</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">but this time call `more?` in between</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">next.1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">more?.1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">next.2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">more?.2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">next.1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">more?.1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">next.2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">more?.2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">double-initiate-and-use-more?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"abcdef"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(97 #t 99 #t 98 #t 100 #t)</span></p></td></tr></table></blockquote><p>In this example, the state embedded in the first call to <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%29%29" class="RktValLink" data-pltdoc="x">sequence-generate</a></span>
+&ldquo;takes&rdquo; the <span class="RktVal">98</span> just by virtue of the invocation of <span class="RktVar">more?.1</span>.</p><p>Individual elements of a sequence typically correspond to single
+values, but an element may also correspond to multiple values.  For
+example, a hash table generates two values&#8212;<wbr></wbr>a key and its value&#8212;<wbr></wbr>for
+each element in the sequence.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Sequence_Predicate_and_Constructors&quot;">4.16.1.1<tt>&nbsp;</tt><a name="(part._.Sequence_.Predicate_and_.Constructors)"></a>Sequence Predicate and Constructors</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._sequence~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">sequence?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> can be used as a <a href="sequences.html#%28tech._sequence%29" class="techoutside" data-pltdoc="x"><span class="techinside">sequence</span></a>,
+  <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">42</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">c</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"word"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-range))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-range</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">end</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-range</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">step</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">step</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence (that is also a <a href="streams.html#%28tech._stream%29" class="techoutside" data-pltdoc="x"><span class="techinside">stream</span></a>) whose elements are
+numbers.  The single-argument case <span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="stt"> </span><span class="RktVar">end</span><span class="RktPn">)</span> is
+equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="stt"> </span><span class="RktVal">0</span><span class="stt"> </span><span class="RktVar">end</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span>.  The first number in the
+sequence is <span class="RktVar">start</span>, and each successive element is generated
+by adding <span class="RktVar">step</span> to the previous element.  The sequence stops
+before an element that would be greater or equal to <span class="RktVar">end</span> if
+<span class="RktVar">step</span> is non-negative, or less or equal to <span class="RktVar">end</span> if
+<span class="RktVar">step</span> is negative.  </div><div class="SIntrapara">An <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span> application can provide better performance for number iteration when it appears directly in a <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> clause.</div></p><p><div class="SIntrapara">Example: gaussian sum</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fsum%29%29" class="RktStxLink" data-pltdoc="x">for/sum</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">45</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara">Example: sum of even numbers</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fsum%29%29" class="RktStxLink" data-pltdoc="x">for/sum</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2450</span></p></td></tr></table></blockquote></div></p><p>When given zero as <span class="RktVar">step</span>, <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span> returns an infinite
+sequence. It may also return infinite sequences when <span class="RktVar">step</span> is a very
+small number, and either <span class="RktVar">step</span> or the sequence elements are
+floating-point numbers.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-inclusive-range))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-inclusive-range%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-inclusive-range</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">step</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">step</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span>, but the sequence stopping condition is changed so that
+the last element is allowed to be equal to <span class="RktVar">end</span>. </div><div class="SIntrapara">An <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-inclusive-range%29%29" class="RktValLink" data-pltdoc="x">in-inclusive-range</a></span> application can provide better performance for number iteration when it appears directly in a <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> clause.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-~3elist%29%29" class="RktValLink" data-pltdoc="x">sequence-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-inclusive-range%29%29" class="RktValLink" data-pltdoc="x">in-inclusive-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(7 8 9 10 11)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-~3elist%29%29" class="RktValLink" data-pltdoc="x">sequence-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-inclusive-range%29%29" class="RktValLink" data-pltdoc="x">in-inclusive-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(7 9 11)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-~3elist%29%29" class="RktValLink" data-pltdoc="x">sequence-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-inclusive-range%29%29" class="RktValLink" data-pltdoc="x">in-inclusive-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(7 9)</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 8.0.0.13 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-naturals))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-naturals%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-naturals</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">start</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an infinite sequence (that is also a <a href="streams.html#%28tech._stream%29" class="techoutside" data-pltdoc="x"><span class="techinside">stream</span></a>) of exact
+integers starting with <span class="RktVar">start</span>, where each element is one
+more than the preceding element.  </div><div class="SIntrapara">An <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-naturals%29%29" class="RktValLink" data-pltdoc="x">in-naturals</a></span> application can provide better performance for integer iteration when it appears directly in a <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> clause.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-naturals%29%29" class="RktValLink" data-pltdoc="x">in-naturals</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'((0 0) (1 1) (2 2) (3 3) (4 4) (5 5) (6 6) (7 7) (8 8) (9 9))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-list))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-list</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence (that is also a <a href="streams.html#%28tech._stream%29" class="techoutside" data-pltdoc="x"><span class="techinside">stream</span></a>) that is equivalent
+  to using <span class="RktVar">lst</span> directly as a sequence.
+  </div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See <a href="pairs.html" data-pltdoc="x">Pairs and Lists</a> for information on using lists as
+sequences.</p></blockquote></blockquote></blockquote></div><div class="SIntrapara">An <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="RktValLink" data-pltdoc="x">in-list</a></span> application can provide better performance for list iteration when it appears directly in a <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> clause.</div><div class="SIntrapara">See <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> for information on the reachability of list elements
+during an iteration.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="RktValLink" data-pltdoc="x">in-list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktRdr">,</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktRdr">,</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'((3 9) (1 1) (4 16))</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.7.0.4 of package <span class="stt">base</span>: Improved element-reachability guarantee for lists in <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-mlist))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mlist%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-mlist</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">mlst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mlst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=compatibility&amp;rel=mlists.html%23%2528def._%2528%2528lib._compatibility%252Fmlist..rkt%2529._mlist%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">mlist?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence equivalent to <span class="RktVar">mlst</span>. Although the
+expectation is that <span class="RktVar">mlst</span> is <a href="mpairs.html#%28tech._mutable._list%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutable list</span></a>, <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mlist%29%29" class="RktValLink" data-pltdoc="x">in-mlist</a></span>
+initially checks only whether <span class="RktVar">mlst</span> is a <a href="mpairs.html#%28tech._mutable._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutable pair</span></a> or <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span>,
+since it could change during iteration.
+</div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See <a href="mpairs.html" data-pltdoc="x">Mutable Pairs and Lists</a> for information on using mutable lists as
+sequences.</p></blockquote></blockquote></blockquote></div><div class="SIntrapara">An <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mlist%29%29" class="RktValLink" data-pltdoc="x">in-mlist</a></span> application can provide better performance for mutable list iteration when it appears directly in a <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> clause.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mlist%29%29" class="RktValLink" data-pltdoc="x">in-mlist</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="RktValLink" data-pltdoc="x">mcons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"RACKET"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="RktValLink" data-pltdoc="x">mcons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"LANG"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="RktValLink" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(6 4)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-vector))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-vector%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-vector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">stop</span><span class="hspace">&nbsp;</span><span class="RktVar">step</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">step</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence equivalent to <span class="RktVar">vec</span> when no optional
+arguments are supplied.</div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See <a href="vectors.html" data-pltdoc="x">Vectors</a> for information on using vectors as
+sequences.</p></blockquote></blockquote></blockquote><p>The optional arguments <span class="RktVar">start</span>, <span class="RktVar">stop</span>, and
+<span class="RktVar">step</span> are analogous to <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span>, except that a
+<span class="RktVal">#f</span> value for <span class="RktVar">stop</span> is equivalent to
+<span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="RktValLink" data-pltdoc="x">vector-length</a></span><span class="stt"> </span><span class="RktVar">vec</span><span class="RktPn">)</span>.  That is, the first element in the
+sequence is <span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span><span class="stt"> </span><span class="RktVar">vec</span><span class="stt"> </span><span class="RktVar">start</span><span class="RktPn">)</span>, and each successive
+element is generated by adding <span class="RktVar">step</span> to index of the
+previous element.  The sequence stops before an index that would be
+greater or equal to <span class="RktSym">end</span> if <span class="RktVar">step</span> is non-negative,
+or less or equal to <span class="RktSym">end</span> if <span class="RktVar">step</span> is negative.</p><p>If <span class="RktVar">start</span> is not a valid index, then the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised, except when <span class="RktVar">start</span>, <span class="RktVar">stop</span>, and
+<span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="RktValLink" data-pltdoc="x">vector-length</a></span><span class="stt"> </span><span class="RktVar">vec</span><span class="RktPn">)</span> are equal, in which case the result is an
+empty sequence.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-vector%29%29" class="RktValLink" data-pltdoc="x">in-vector</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-vector%29%29" class="RktValLink" data-pltdoc="x">in-vector</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">in-vector: starting index is out of range</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">starting index: 2</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">valid range: [0, 0]</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">vector: '#(1)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-vector%29%29" class="RktValLink" data-pltdoc="x">in-vector</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-vector%29%29" class="RktValLink" data-pltdoc="x">in-vector</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p>If <span class="RktVar">stop</span> is not in [-1, <span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="RktValLink" data-pltdoc="x">vector-length</a></span><span class="stt"> </span><span class="RktVar">vec</span><span class="RktPn">)</span>],
+then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>If <span class="RktVar">start</span> is less than
+<span class="RktVar">stop</span> and <span class="RktVar">step</span> is negative, then the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.  Similarly, if <span class="RktVar">start</span>
+is more than <span class="RktVar">stop</span> and <span class="RktVar">step</span> is positive, then the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>An <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-vector%29%29" class="RktValLink" data-pltdoc="x">in-vector</a></span> application can provide better performance for vector iteration when it appears directly in a <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> clause.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">histogram</span><span class="hspace">&nbsp;</span><span class="RktSym">vector-of-words</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a-hash</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">word</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-vector%29%29" class="RktValLink" data-pltdoc="x">in-vector</a></span><span class="hspace">&nbsp;</span><span class="RktSym">vector-of-words</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-set%21%29%29" class="RktValLink" data-pltdoc="x">hash-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a-hash</span><span class="hspace">&nbsp;</span><span class="RktSym">word</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ref%29%29" class="RktValLink" data-pltdoc="x">hash-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a-hash</span><span class="hspace">&nbsp;</span><span class="RktSym">word</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">a-hash</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">histogram</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">"hello"</span><span class="hspace">&nbsp;</span><span class="RktVal">"world"</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="hspace">&nbsp;</span><span class="RktVal">"sunshine"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#hash(("hello" . 2) ("sunshine" . 1) ("world" . 1))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-string))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-string%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">stop</span><span class="hspace">&nbsp;</span><span class="RktVar">step</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">step</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence equivalent to <span class="RktVar">str</span> when no optional
+arguments are supplied.</div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See <a href="strings.html" data-pltdoc="x">Strings</a> for information on using strings as
+sequences.</p></blockquote></blockquote></blockquote><p>The optional arguments <span class="RktVar">start</span>, <span class="RktVar">stop</span>, and
+<span class="RktVar">step</span> are as in <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-vector%29%29" class="RktValLink" data-pltdoc="x">in-vector</a></span>.</p><p>An <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-string%29%29" class="RktValLink" data-pltdoc="x">in-string</a></span> application can provide better performance for string iteration when it appears directly in a <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> clause.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">line-count</span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fsum%29%29" class="RktStxLink" data-pltdoc="x">for/sum</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-string%29%29" class="RktValLink" data-pltdoc="x">in-string</a></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3d~3f%29%29" class="RktValLink" data-pltdoc="x">char=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\newline</span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">line-count</span><span class="hspace">&nbsp;</span><span class="RktVal">"this string\nhas\nthree \nnewlines"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-bytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">stop</span><span class="hspace">&nbsp;</span><span class="RktVar">step</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">step</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence equivalent to <span class="RktVar">bstr</span> when no optional
+arguments are supplied.</div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See <a href="bytestrings.html" data-pltdoc="x">Byte Strings</a> for information on using byte strings as
+sequences.</p></blockquote></blockquote></blockquote><p>The optional arguments <span class="RktVar">start</span>, <span class="RktVar">stop</span>, and
+<span class="RktVar">step</span> are as in <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-vector%29%29" class="RktValLink" data-pltdoc="x">in-vector</a></span>.</p><p>An <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-bytes%29%29" class="RktValLink" data-pltdoc="x">in-bytes</a></span> application can provide better performance for byte string iteration when it appears directly in a <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> clause.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">has-eof?</span><span class="hspace">&nbsp;</span><span class="RktSym">bs</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2For%29%29" class="RktStxLink" data-pltdoc="x">for/or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-bytes%29%29" class="RktValLink" data-pltdoc="x">in-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bs</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">has-eof?</span><span class="hspace">&nbsp;</span><span class="RktVal">#"this byte string has an \0embedded zero byte"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">has-eof?</span><span class="hspace">&nbsp;</span><span class="RktVal">#"this byte string does not"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-port))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-port</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">r</span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">r</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence whose elements are produced by calling <span class="RktVar">r</span>
+on <span class="RktVar">in</span> until it produces <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-input-port-bytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-input-port-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-input-port-bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-port%29%29" class="RktValLink" data-pltdoc="x">in-port</a></span><span class="stt"> </span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-byte%29%29" class="RktValLink" data-pltdoc="x">read-byte</a></span><span class="stt"> </span><span class="RktVar">in</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-input-port-chars))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-input-port-chars%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-input-port-chars</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence whose elements are read as characters from
+<span class="RktVar">in</span> (equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-port%29%29" class="RktValLink" data-pltdoc="x">in-port</a></span><span class="stt"> </span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char%29%29" class="RktValLink" data-pltdoc="x">read-char</a></span><span class="stt"> </span><span class="RktVar">in</span><span class="RktPn">)</span>).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-lines))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-lines%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-lines</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktVar">mode</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">linefeed</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return-linefeed</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any-one</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">any</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence equivalent to
+<span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-port%29%29" class="RktValLink" data-pltdoc="x">in-port</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="RktValLink" data-pltdoc="x">read-line</a></span><span class="stt"> </span><span class="RktSym">p</span><span class="stt"> </span><span class="RktVar">mode</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">in</span><span class="RktPn">)</span>.  Note that
+the default mode is <span class="RktVal">'</span><span class="RktVal">any</span>, whereas the default mode of
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="RktValLink" data-pltdoc="x">read-line</a></span> is <span class="RktVal">'</span><span class="RktVal">linefeed</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-bytes-lines))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-bytes-lines%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-bytes-lines</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktVar">mode</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">mode</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">linefeed</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return-linefeed</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any-one</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">any</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence equivalent to
+<span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-port%29%29" class="RktValLink" data-pltdoc="x">in-port</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-line%29%29" class="RktValLink" data-pltdoc="x">read-bytes-line</a></span><span class="stt"> </span><span class="RktSym">p</span><span class="stt"> </span><span class="RktVar">mode</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">in</span><span class="RktPn">)</span>.  Note
+that the default mode is <span class="RktVal">'</span><span class="RktVal">any</span>, whereas the default mode of
+<span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-bytes-line%29%29" class="RktValLink" data-pltdoc="x">read-bytes-line</a></span> is <span class="RktVal">'</span><span class="RktVal">linefeed</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-hash))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-hash</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-hash</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence equivalent to <span class="RktVar">hash</span>, except when <span class="RktVar">bad-index-v</span>
+is supplied.</div></p><p>If <span class="RktVar">bad-index-v</span> is supplied, then <span class="RktVar">bad-index-v</span> is
+returned as both the key and the value in the case that the
+<span class="RktVar">hash</span> is modified concurrently so that iteration does not have a
+<a href="hashtables.html#%28tech._valid._hash._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">valid hash index</span></a>. Providing <span class="RktVar">bad-index-v</span> is particularly
+useful when iterating through a hash table with weakly held keys, since
+entries can be removed asynchronously (i.e., after <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash%29%29" class="RktValLink" data-pltdoc="x">in-hash</a></span> has
+committed to another iteration, but before it can access the entry for the
+next iteration).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">key</span><span class="hspace">&nbsp;</span><span class="RktSym">value</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash%29%29" class="RktValLink" data-pltdoc="x">in-hash</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"key: ~a value: ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">key</span><span class="hspace">&nbsp;</span><span class="RktSym">value</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">key: b value: 2</span></p></td></tr><tr><td><p><span class="RktOut">key: a value: 1</span></p></td></tr></table></td></tr></table></blockquote></div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See <a href="hashtables.html" data-pltdoc="x">Hash Tables</a> for information on using hash tables as
+sequences.</p></blockquote></blockquote></blockquote><p class="SHistory">Changed in version 7.0.0.10 of package <span class="stt">base</span>: Added the optional <span class="RktVar">bad-index-v</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-hash-keys))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash-keys%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-hash-keys</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash-keys%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-hash-keys</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence whose elements are the keys of <span class="RktVar">hash</span>, using
+<span class="RktVar">bad-index-v</span> in the same way as <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash%29%29" class="RktValLink" data-pltdoc="x">in-hash</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">key</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash-keys%29%29" class="RktValLink" data-pltdoc="x">in-hash-keys</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"key: ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">key</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">key: b</span></p></td></tr><tr><td><p><span class="RktOut">key: a</span></p></td></tr></table></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.10 of package <span class="stt">base</span>: Added the optional <span class="RktVar">bad-index-v</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-hash-values))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash-values%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-hash-values</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash-values%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-hash-values</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence whose elements are the values of <span class="RktVar">hash</span>, using
+<span class="RktVar">bad-index-v</span> in the same way as <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash%29%29" class="RktValLink" data-pltdoc="x">in-hash</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">value</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash-values%29%29" class="RktValLink" data-pltdoc="x">in-hash-values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"value: ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">value</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">value: 2</span></p></td></tr><tr><td><p><span class="RktOut">value: 1</span></p></td></tr></table></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.10 of package <span class="stt">base</span>: Added the optional <span class="RktVar">bad-index-v</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-hash-pairs))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash-pairs%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-hash-pairs</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash-pairs%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-hash-pairs</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence whose elements are pairs, each containing a key
+and its value from <span class="RktVar">hash</span> (as opposed to using <span class="RktVar">hash</span>
+directly as a sequence to get the key and value as separate values
+for each element).</div></p><p>The <span class="RktVar">bad-index-v</span> argument, if supplied, is used in the same
+way as by <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash%29%29" class="RktValLink" data-pltdoc="x">in-hash</a></span>. When an invalid index is encountered,
+the pair in the sequence with have <span class="RktVar">bad-index-v</span> as both its
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> and <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">key+value</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash-pairs%29%29" class="RktValLink" data-pltdoc="x">in-hash-pairs</a></span><span class="hspace">&nbsp;</span><span class="RktSym">table</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"key and value: ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">key+value</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">key and value: (b . 2)</span></p></td></tr><tr><td><p><span class="RktOut">key and value: (a . 1)</span></p></td></tr></table></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.10 of package <span class="stt">base</span>: Added the optional <span class="RktVar">bad-index-v</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-mutable-hash))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mutable-hash%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-mutable-hash</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mutable-hash%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-mutable-hash</a></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-mutable-hash-keys))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mutable-hash-keys%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-mutable-hash-keys</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mutable-hash-keys%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-mutable-hash-keys</a></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-mutable-hash-values))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mutable-hash-values%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-mutable-hash-values</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mutable-hash-values%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-mutable-hash-values</a></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-mutable-hash-pairs))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mutable-hash-pairs%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-mutable-hash-pairs</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-mutable-hash-pairs%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-mutable-hash-pairs</a></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-immutable-hash))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-immutable-hash%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-immutable-hash</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-immutable-hash%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-immutable-hash</a></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-immutable-hash-keys))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-immutable-hash-keys%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-immutable-hash-keys</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-immutable-hash-keys%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-immutable-hash-keys</a></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-immutable-hash-values))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-immutable-hash-values%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-immutable-hash-values</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-immutable-hash-values%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-immutable-hash-values</a></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-immutable-hash-pairs))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-immutable-hash-pairs%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-immutable-hash-pairs</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-immutable-hash-pairs%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-immutable-hash-pairs</a></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-weak-hash))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-weak-hash%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-weak-hash</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-weak-hash%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-weak-hash</a></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-weak-hash-keys))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-weak-hash-keys%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-weak-hash-keys</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-weak-hash-keys%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-weak-hash-keys</a></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-weak-hash-values))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-weak-hash-values%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-weak-hash-values</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-weak-hash-keys%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-weak-hash-keys</a></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-weak-hash-pairs))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-weak-hash-pairs%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-weak-hash-pairs</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-weak-hash-pairs%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-weak-hash-pairs</a></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-ephemeron-hash))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-ephemeron-hash%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-ephemeron-hash</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-ephemeron-hash%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-ephemeron-hash</a></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-ephemeron-hash-keys))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-ephemeron-hash-keys%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-ephemeron-hash-keys</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-ephemeron-hash-keys%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-ephemeron-hash-keys</a></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-ephemeron-hash-values))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-ephemeron-hash-values%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-ephemeron-hash-values</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-ephemeron-hash-keys%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-ephemeron-hash-keys</a></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-ephemeron-hash-pairs))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-ephemeron-hash-pairs%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-ephemeron-hash-pairs</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-ephemeron-hash-pairs%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-ephemeron-hash-pairs</a></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">bad-index-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Sequence constructors for specific kinds of hash tables.
+These may perform better than the analogous <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash%29%29" class="RktValLink" data-pltdoc="x">in-hash</a></span>
+forms.</div></p><p class="SHistory">Added in version 6.4.0.6 of package <span class="stt">base</span>.<br/>Changed in version 7.0.0.10: Added the optional <span class="RktVar">bad-index-v</span> argument.<br/>Changed in version 8.0.0.10: Added <span class="RktSym">ephemeron</span> variants.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-directory))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-directory%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-directory</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">dir</span><span class="hspace">&nbsp;</span><span class="RktVar">use-dir?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dir</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">use-dir?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dir-path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence that produces all of the paths for files,
+  directories, and links within <span class="RktVar">dir</span>, except for the
+  contents of any directory for which <span class="RktVar">use-dir?</span> returns
+  <span class="RktVal">#f</span>. If <span class="RktVar">dir</span> is not
+  <span class="RktVal">#f</span>, then every produced path starts with <span class="RktVar">dir</span> as
+  its prefix.  If <span class="RktVar">dir</span> is <span class="RktVal">#f</span>, then paths in and
+  relative to the current directory are produced.</div></p><p>An <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-directory%29%29" class="RktValLink" data-pltdoc="x">in-directory</a></span> sequence traverses nested subdirectories
+  recursively (filtered by <span class="RktVar">use-dir?</span>).
+  To generate a sequence that includes only the immediate
+  content of a directory, use the result of <span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._directory-list%29%29" class="RktValLink" data-pltdoc="x">directory-list</a></span> as
+  a sequence.</p><p>The immediate content of each directory is reported as sorted by
+  <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3c~3f%29%29" class="RktValLink" data-pltdoc="x">path&lt;?</a></span>, and the content of a subdirectory is reported
+  before subsequent paths within the directory.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="collects.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._collection-path%29%29" class="RktValLink" data-pltdoc="x">collection-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"info"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-directory%29%29" class="RktValLink" data-pltdoc="x">in-directory</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">'(#&lt;path:compiled&gt;</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">#&lt;path:compiled/main_rkt.dep&gt;</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">#&lt;path:compiled/main_rkt.zo&gt;</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">#&lt;path:main.rkt&gt;)</span></p></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-directory%29%29" class="RktValLink" data-pltdoc="x">in-directory</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"compiled"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(#&lt;path:main_rkt.dep&gt; #&lt;path:main_rkt.zo&gt;)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-directory%29%29" class="RktValLink" data-pltdoc="x">in-directory</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"compiled"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(#&lt;path:compiled/main_rkt.dep&gt; #&lt;path:compiled/main_rkt.zo&gt;)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-directory%29%29" class="RktValLink" data-pltdoc="x">in-directory</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp-match~3f%29%29" class="RktValLink" data-pltdoc="x">regexp-match?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"compiled"</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(#&lt;path:main.rkt&gt; #&lt;path:compiled&gt;)</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.0.0.1 of package <span class="stt">base</span>: Added <span class="RktVar">use-dir?</span> argument.<br/>Changed in version 6.6.0.4: Added guarantee of sorted results.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-producer))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-producer%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-producer</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">producer</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">producer</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-producer%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-producer</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">producer</span><span class="hspace">&nbsp;</span><span class="RktVar">stop</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">producer</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence that contains values from sequential calls to
+<span class="RktVar">producer</span>, which would usually use some state to do its work.</div></p><p>If a <span class="RktVar">stop</span> value is not given, the sequence goes on
+infinitely, and therefore it is common to use it with a finite sequence
+or using <span class="RktPn">#:break</span> etc.  If a <span class="RktVar">stop</span> value is given, it
+is used to identify a value that marks the end of the sequence (and
+the <span class="RktVar">stop</span> value is not included in the sequence);
+<span class="RktVar">stop</span> can be a predicate that is applied to the results of
+<span class="RktVar">producer</span>, or it can be a value that is tested against the
+result of with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>.  (The <span class="RktVar">stop</span> argument must be a
+predicate if the stop value is itself a function or if
+<span class="RktVar">producer</span> returns multiple values.)</p><p>If additional <span class="RktVar">arg</span>s are specified, they are passed to every
+call to <span class="RktVar">producer</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">counter</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-producer%29%29" class="RktValLink" data-pltdoc="x">in-producer</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">counter</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-producer%29%29" class="RktValLink" data-pltdoc="x">in-producer</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">counter</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">#:break</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-producer%29%29" class="RktValLink" data-pltdoc="x">in-producer</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">counter</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-producer%29%29" class="RktValLink" data-pltdoc="x">in-producer</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">counter</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">1/2</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1/2 1 3/2 2 5/2 3 7/2 4 9/2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-producer%29%29" class="RktValLink" data-pltdoc="x">in-producer</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._eof%29%29" class="RktValLink" data-pltdoc="x">eof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"1 2 3"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-value))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-value</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence that produces a single value: <span class="RktVar">v</span>.</div></p><p>This form is mostly useful for <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span>-like bindings in forms
+such as <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for*/list</a></span>&#8212;<wbr></wbr>but a <span class="RktPn">#:do</span> clause form, added
+more recently, covers many of the same uses.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-indexed))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-indexed%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-indexed</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">seq</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">seq</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence where each element has two values: the value
+produced by <span class="RktVar">seq</span>, and a non-negative exact integer starting
+with <span class="RktVal">0</span>.  The elements of <span class="RktVar">seq</span> must be
+single-valued.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-indexed%29%29" class="RktValLink" data-pltdoc="x">in-indexed</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"The char at position ~a is: ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">The char at position 0 is: h</span></p></td></tr><tr><td><p><span class="RktOut">The char at position 1 is: e</span></p></td></tr><tr><td><p><span class="RktOut">The char at position 2 is: l</span></p></td></tr><tr><td><p><span class="RktOut">The char at position 3 is: l</span></p></td></tr><tr><td><p><span class="RktOut">The char at position 4 is: o</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-sequences))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-sequences%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-sequences</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">seq</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">seq</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence that is made of all input sequences, one after
+the other. Each <span class="RktVar">seq</span> is <a href="sequences.html#%28tech._initiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">initiate</span></a>d only after the
+preceding <span class="RktVar">seq</span> is exhausted. If a single <span class="RktVar">seq</span> is
+provided, then <span class="RktVar">seq</span> is returned; otherwise, the elements of
+each <span class="RktVar">seq</span> must all have the same number of values.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-cycle))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-cycle%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-cycle</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">seq</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">seq</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-sequences%29%29" class="RktValLink" data-pltdoc="x">in-sequences</a></span>, but the sequences are repeated in
+an infinite cycle, where each <span class="RktVar">seq</span> is <a href="sequences.html#%28tech._initiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">initiate</span></a>d
+afresh in each iteration. Beware that if no <span class="RktVar">seq</span>s are
+provided or if all <span class="RktVar">seq</span>s become empty, then the sequence
+produced by <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-cycle%29%29" class="RktValLink" data-pltdoc="x">in-cycle</a></span> never returns when an element is
+demanded&#8212;<wbr></wbr>or even when the sequence is <a href="sequences.html#%28tech._initiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">initiate</span></a>d, if all
+<span class="RktVar">seq</span>s are initially empty.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-parallel))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-parallel%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-parallel</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">seq</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">seq</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence where each element has as many values as the
+number of supplied <span class="RktVar">seq</span>s; the values, in order, are the
+values of each <span class="RktVar">seq</span>.  The elements of each <span class="RktVar">seq</span> must
+be single-valued.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-values-sequence))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-values-sequence%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-values-sequence</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">seq</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">seq</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence that is like <span class="RktVar">seq</span>, but it combines
+multiple values for each element from <span class="RktVar">seq</span> as a list of
+elements.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._in-values*-sequence))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-values%2A-sequence%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-values*-sequence</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">seq</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">seq</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence that is like <span class="RktVar">seq</span>, but when an element of
+<span class="RktVar">seq</span> has multiple values or a single list value, then the
+values are combined in a list. In other words,
+<span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-values%2A-sequence%29%29" class="RktValLink" data-pltdoc="x">in-values*-sequence</a></span> is like <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-values-sequence%29%29" class="RktValLink" data-pltdoc="x">in-values-sequence</a></span>,
+except that non-list, single-valued elements are not wrapped in a
+list.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._stop-before))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._stop-before%29%29" class="RktValDef RktValLink" data-pltdoc="x">stop-before</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">seq</span><span class="hspace">&nbsp;</span><span class="RktVar">pred</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">seq</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence that contains the elements of <span class="RktVar">seq</span> (which
+must be single-valued), but only until the last element for which
+applying <span class="RktVar">pred</span> to the element produces <span class="RktVal">#t</span>, after
+which the sequence ends.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._stop-after))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._stop-after%29%29" class="RktValDef RktValLink" data-pltdoc="x">stop-after</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">seq</span><span class="hspace">&nbsp;</span><span class="RktVar">pred</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">seq</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence that contains the elements of <span class="RktVar">seq</span> (which
+must be single-valued), but only until the element (inclusive) for
+which applying <span class="RktVar">pred</span> to the element produces <span class="RktVal">#t</span>,
+after which the sequence ends.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._make-do-sequence))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-do-sequence%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-do-sequence</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thunk</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">thunk</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence whose elements are generated by the procedures
+  and initial value returned by the thunk, which is called to
+  <a href="sequences.html#%28tech._initiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">initiate</span></a> the sequence.  The initiated sequence is defined in
+  terms of a <span style="font-style: italic">position</span>, which is initialized to the third
+  result of the thunk, and the <span style="font-style: italic">element</span>, which may consist of
+  multiple values.</div></p><p><div class="SIntrapara">The <span class="RktVar">thunk</span> results define the generated elements as follows:
+  </div><div class="SIntrapara"><ul><li><p>The first result is a <span class="RktVar">pos-&gt;element</span> procedure that
+takes the current position and returns the value(s) for the
+current element.</p></li><li><p>The optional second result is an <span class="RktVar">early-next-pos</span>
+procedure that is described further below. Alternatively, the
+optional second result can be <span class="RktVal">#f</span>, which is equivalent
+to the identity function.</p></li><li><p>The third (or second) result is a <span class="RktVar">next-pos</span> procedure that
+takes the current position and returns the next position.</p></li><li><p>The fourth (or third) result is the initial position.</p></li><li><p>The fifth (or fourth) result is a <span class="RktVar">continue-with-pos?</span> function
+that takes the current position and returns a true result if the
+sequence includes the value(s) for the current position, and
+false if the sequence should end instead of including the
+value(s). Alternatively, the fifth (or fourth) result can be <span class="RktVal">#f</span> to
+indicate that the sequence should always include the current
+value(s). This function is checked on each position before
+<span class="RktVar">pos-&gt;element</span> is used.</p></li><li><p>The sixth (or fifth) result is a <span class="RktVar">continue-with-val?</span> function
+that is like the fifth (or fourth) result, but it takes the current element
+value(s) instead of the current position.  Alternatively, the
+sixth (or fifth) result can be <span class="RktVal">#f</span> to indicate that the sequence
+should always include the value(s) at the current position.</p></li><li><p>The seventh (or sixth) result is a <span class="RktVar">continue-after-pos+val?</span>
+procedure that takes both the current position and the current
+element value(s) and determines whether the sequence ends after
+the current element is already included in the sequence.
+Alternatively, the seventh (or sixth) result can be <span class="RktVal">#f</span> to indicate
+that the sequence can always continue after the current
+value(s).</p></li></ul></div></p><p>The <span class="RktVar">early-next-pos</span> procedure, which is the optional second
+  result, takes the current position and returns an updated position.
+  This updated position is used for <span class="RktVar">next-pos</span> and
+  <span class="RktVar">continue-after-pos+val?</span>, but not with
+  <span class="RktVar">continue-with-pos?</span> (which uses the original current
+  position). The intent of <span class="RktVar">early-next-pos</span> is to support a
+  sequence where the position must be incremented to avoid keeping a
+  value reachable while a loop processes the sequence value, so
+  <span class="RktVar">early-next-pos</span> is applied just after
+  <span class="RktVar">pos-&gt;element</span>.</p><p>Each of the procedures listed above is called only once per
+  position.  Among the last three procedures, as soon as one of the
+  procedures returns <span class="RktVal">#f</span>, the sequence ends, and none are
+  called again.  Typically, one of the functions determines the end
+  condition, and <span class="RktVal">#f</span> is used in place of the other two
+  functions.</p><p class="SHistory">Changed in version 6.7.0.4 of package <span class="stt">base</span>: Added support for the optional second result.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/private/base..rkt)._prop~3asequence))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3asequence%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:sequence</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Associates a procedure to a structure type that takes an instance of
+the structure and returns a sequence.  If <span class="RktSym">v</span> is an instance
+of a structure type with this property, then <span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span><span class="stt"> </span><span class="RktSym">v</span><span class="RktPn">)</span>
+produces <span class="RktVal">#t</span>.</div></p><p>Using a pre-existing sequence:</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-set</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">table</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:property</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3asequence%29%29" class="RktValLink" data-pltdoc="x">prop:sequence</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-hash-keys%29%29" class="RktValLink" data-pltdoc="x">in-hash-keys</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">my-set-table</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-set</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">xs</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">my-set</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Fhash%29%29" class="RktStxLink" data-pltdoc="x">for/hash</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="RktValLink" data-pltdoc="x">in-list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">xs</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-set</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">celeriac</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">carrot</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">potato</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(potato celeriac carrot)</span></p></td></tr></table></blockquote></div></p><p>Using <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-do-sequence%29%29" class="RktValLink" data-pltdoc="x">make-do-sequence</a></span>:</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">train</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">car</span><span class="hspace">&nbsp;</span><span class="RktSym">next</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:property</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3asequence%29%29" class="RktValLink" data-pltdoc="x">prop:sequence</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">t</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-do-sequence%29%29" class="RktValLink" data-pltdoc="x">make-do-sequence</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">train-car</span><span class="hspace">&nbsp;</span><span class="RktSym">train-next</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">t</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">t</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">train</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">engine</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">train</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">boxcar</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">train</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">caboose</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(engine boxcar caboose)</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Sequence_Conversion&quot;">4.16.1.2<tt>&nbsp;</tt><a name="(part._.Sequence_.Conversion)"></a>Sequence Conversion</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._sequence-~3estream))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-~3estream%29%29" class="RktValDef RktValLink" data-pltdoc="x">sequence-&gt;stream</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">seq</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">seq</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Coverts a sequence to a <a href="streams.html#%28tech._stream%29" class="techoutside" data-pltdoc="x"><span class="techinside">stream</span></a>, which supports the
+<span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-first%29%29" class="RktValLink" data-pltdoc="x">stream-first</a></span> and <span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-rest%29%29" class="RktValLink" data-pltdoc="x">stream-rest</a></span> operations. Creation
+of the stream eagerly <a href="sequences.html#%28tech._initiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">initiates</span></a> the sequence, but the stream
+lazily draws elements from the sequence, caching each element so
+that <span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-first%29%29" class="RktValLink" data-pltdoc="x">stream-first</a></span> produces the same result each time is
+applied to a stream.</div></p><p>If extracting an element from <span class="RktVar">seq</span> involves a side-effect,
+then the effect is performed each time that either
+<span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-first%29%29" class="RktValLink" data-pltdoc="x">stream-first</a></span> or <span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-rest%29%29" class="RktValLink" data-pltdoc="x">stream-rest</a></span> is first used to
+access or skip an element.</p><p>Note that a <a href="sequences.html#%28elem._sequence-state%29" data-pltdoc="x">sequence itself can have
+state</a>, so multiple calls to <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-~3estream%29%29" class="RktValLink" data-pltdoc="x">sequence-&gt;stream</a></span> on the same
+<span class="RktVar">seq</span> are not necessarily independent.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">inport</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-bytes%29%29" class="RktValLink" data-pltdoc="x">open-input-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">strm</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-~3estream%29%29" class="RktValLink" data-pltdoc="x">sequence-&gt;stream</a></span><span class="hspace">&nbsp;</span><span class="RktSym">inport</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-first%29%29" class="RktValLink" data-pltdoc="x">stream-first</a></span><span class="hspace">&nbsp;</span><span class="RktSym">strm</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-first%29%29" class="RktValLink" data-pltdoc="x">stream-first</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-rest%29%29" class="RktValLink" data-pltdoc="x">stream-rest</a></span><span class="hspace">&nbsp;</span><span class="RktSym">strm</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-first%29%29" class="RktValLink" data-pltdoc="x">stream-first</a></span><span class="hspace">&nbsp;</span><span class="RktSym">strm</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">strm2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-~3estream%29%29" class="RktValLink" data-pltdoc="x">sequence-&gt;stream</a></span><span class="hspace">&nbsp;</span><span class="RktSym">inport</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-first%29%29" class="RktValLink" data-pltdoc="x">stream-first</a></span><span class="hspace">&nbsp;</span><span class="RktSym">strm2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-first%29%29" class="RktValLink" data-pltdoc="x">stream-first</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-rest%29%29" class="RktValLink" data-pltdoc="x">stream-rest</a></span><span class="hspace">&nbsp;</span><span class="RktSym">strm2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._sequence-generate))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%29%29" class="RktValDef RktValLink" data-pltdoc="x">sequence-generate</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">seq</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">seq</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"><a href="sequences.html#%28tech._initiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">Initiates</span></a> a sequence and returns two thunks to extract
+elements from the sequence.  The first returns <span class="RktVal">#t</span> if more
+values are available for the sequence.  The second returns the next
+element (which may be multiple values) from the sequence; if no more
+elements are available, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p>Note that a <a href="sequences.html#%28elem._sequence-state%29" data-pltdoc="x">sequence itself can have
+state</a>, so multiple calls to <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%29%29" class="RktValLink" data-pltdoc="x">sequence-generate</a></span> on the same
+<span class="RktVar">seq</span> are not necessarily independent.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">inport</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-bytes%29%29" class="RktValLink" data-pltdoc="x">open-input-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">more?</span><span class="hspace">&nbsp;</span><span class="RktSym">get</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%29%29" class="RktValLink" data-pltdoc="x">sequence-generate</a></span><span class="hspace">&nbsp;</span><span class="RktSym">inport</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">more?</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">get</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">get</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">more2?</span><span class="hspace">&nbsp;</span><span class="RktSym">get2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%29%29" class="RktValLink" data-pltdoc="x">sequence-generate</a></span><span class="hspace">&nbsp;</span><span class="RktSym">inport</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(3 4 5)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">more2?</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._sequence-generate*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">sequence-generate*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">seq</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">seq</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%29%29" class="RktValLink" data-pltdoc="x">sequence-generate</a></span>, but avoids state (aside from any
+inherent in the sequence) by returning a list of values for the
+sequence&rsquo;s first element&#8212;<wbr></wbr>or <span class="RktVal">#f</span> if the sequence is
+empty&#8212;<wbr></wbr>and a thunk to continue with the sequence; the result of the
+thunk is the same as the result of <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence-generate%2A%29%29" class="RktValLink" data-pltdoc="x">sequence-generate*</a></span>, but
+for the second element of the sequence, and so on. If the thunk is
+called when the element result is <span class="RktVal">#f</span> (indicating no further
+values in the sequence), the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;more-sequences&quot;">4.16.1.3<tt>&nbsp;</tt><a name="(part._more-sequences)"></a><a name="(mod-path._racket/sequence)"></a>Additional Sequence Operations</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="sequences.html#%28mod-path._racket%2Fsequence%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/sequence</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="sequences.html#%28mod-path._racket%2Fsequence%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/sequence</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/sequence..rkt)._empty-sequence))"></a><span title="Provided from: racket/sequence, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._empty-sequence%29%29" class="RktValDef RktValLink" data-pltdoc="x">empty-sequence</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A sequence with no elements.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sequence..rkt)._sequence-~3elist))"></a><span title="Provided from: racket/sequence, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-~3elist%29%29" class="RktValDef RktValLink" data-pltdoc="x">sequence-&gt;list</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list whose elements are the elements of <span class="RktVar">s</span>, each
+of which must be a single value.  If <span class="RktVar">s</span> is infinite, this
+function does not terminate.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sequence..rkt)._sequence-length))"></a><span title="Provided from: racket/sequence, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">sequence-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the number of elements of <span class="RktVar">s</span> by extracting and
+discarding all of them.  If <span class="RktVar">s</span> is infinite, this function
+does not terminate.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sequence..rkt)._sequence-ref))"></a><span title="Provided from: racket/sequence, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">sequence-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span><span class="RktVar">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">i</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <span class="RktVar">i</span>th element of <span class="RktVar">s</span> (which may be
+multiple values).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sequence..rkt)._sequence-tail))"></a><span title="Provided from: racket/sequence, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-tail%29%29" class="RktValDef RktValLink" data-pltdoc="x">sequence-tail</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span><span class="RktVar">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">i</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence equivalent to <span class="RktVar">s</span>, except that the first
+<span class="RktVar">i</span> elements are omitted.</div></p><p>In case <a href="sequences.html#%28tech._initiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">initiating</span></a> <span class="RktVar">s</span> involves a
+side effect, the sequence <span class="RktVar">s</span> is not <a href="sequences.html#%28tech._initiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">initiate</span></a>d until
+the resulting sequence is <a href="sequences.html#%28tech._initiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">initiate</span></a>d, at which point the first
+<span class="RktVar">i</span> elements are extracted from the sequence.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sequence..rkt)._sequence-append))"></a><span title="Provided from: racket/sequence, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-append%29%29" class="RktValDef RktValLink" data-pltdoc="x">sequence-append</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence that contains all elements of each sequence in
+the order they appear in the original sequences.  The new sequence
+is constructed lazily.</div></p><p>If all given <span class="RktVar">s</span>s are <a href="streams.html#%28tech._stream%29" class="techoutside" data-pltdoc="x"><span class="techinside">streams</span></a>, the result is also a
+<a href="streams.html#%28tech._stream%29" class="techoutside" data-pltdoc="x"><span class="techinside">stream</span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sequence..rkt)._sequence-map))"></a><span title="Provided from: racket/sequence, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-map%29%29" class="RktValDef RktValLink" data-pltdoc="x">sequence-map</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence that contains <span class="RktVar">f</span> applied to each element
+of <span class="RktVar">s</span>.  The new sequence is constructed lazily.</div></p><p>If <span class="RktVar">s</span> is a <a href="streams.html#%28tech._stream%29" class="techoutside" data-pltdoc="x"><span class="techinside">stream</span></a>, then the result is also a
+<a href="streams.html#%28tech._stream%29" class="techoutside" data-pltdoc="x"><span class="techinside">stream</span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sequence..rkt)._sequence-andmap))"></a><span title="Provided from: racket/sequence, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-andmap%29%29" class="RktValDef RktValLink" data-pltdoc="x">sequence-andmap</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">f</span> returns a true result on every
+element of <span class="RktVar">s</span>.  If <span class="RktVar">s</span> is infinite and <span class="RktVar">f</span>
+never returns a false result, this function does not terminate.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sequence..rkt)._sequence-ormap))"></a><span title="Provided from: racket/sequence, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-ormap%29%29" class="RktValDef RktValLink" data-pltdoc="x">sequence-ormap</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">f</span> returns a true result on some
+element of <span class="RktVar">s</span>.  If <span class="RktVar">s</span> is infinite and <span class="RktVar">f</span>
+never returns a true result, this function does not terminate.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sequence..rkt)._sequence-for-each))"></a><span title="Provided from: racket/sequence, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-for-each%29%29" class="RktValDef RktValLink" data-pltdoc="x">sequence-for-each</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Applies <span class="RktVar">f</span> to each element of <span class="RktVar">s</span>.  If <span class="RktVar">s</span> is
+infinite, this function does not terminate.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sequence..rkt)._sequence-fold))"></a><span title="Provided from: racket/sequence, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-fold%29%29" class="RktValDef RktValLink" data-pltdoc="x">sequence-fold</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVar">i</span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">i</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Folds <span class="RktVar">f</span> over each element of <span class="RktVar">s</span> with <span class="RktVar">i</span> as
+the initial accumulator.  If <span class="RktVar">s</span> is infinite, this function
+does not terminate. The <span class="RktVar">f</span> function takes the accumulator as
+its first argument and the next sequence element as its second.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sequence..rkt)._sequence-count))"></a><span title="Provided from: racket/sequence, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-count%29%29" class="RktValDef RktValLink" data-pltdoc="x">sequence-count</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the number of elements in <span class="RktVar">s</span> for which <span class="RktVar">f</span>
+returns a true result.  If <span class="RktVar">s</span> is infinite, this function
+does not terminate.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sequence..rkt)._sequence-filter))"></a><span title="Provided from: racket/sequence, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-filter%29%29" class="RktValDef RktValLink" data-pltdoc="x">sequence-filter</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence whose elements are the elements of <span class="RktVar">s</span> for
+which <span class="RktVar">f</span> returns a true result.  Although the new sequence
+is constructed lazily, if <span class="RktVar">s</span> has an infinite number of
+elements where <span class="RktVar">f</span> returns a false result in between two
+elements where <span class="RktVar">f</span> returns a true result, then operations on
+this sequence will not terminate during the infinite sub-sequence.</div></p><p>If <span class="RktVar">s</span> is a <a href="streams.html#%28tech._stream%29" class="techoutside" data-pltdoc="x"><span class="techinside">stream</span></a>, then the result is also a
+<a href="streams.html#%28tech._stream%29" class="techoutside" data-pltdoc="x"><span class="techinside">stream</span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sequence..rkt)._sequence-add-between))"></a><span title="Provided from: racket/sequence, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-add-between%29%29" class="RktValDef RktValLink" data-pltdoc="x">sequence-add-between</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span><span class="RktVar">e</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">e</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence whose elements are the elements of <span class="RktVar">s</span>,
+but with <span class="RktVar">e</span> between each pair of elements in <span class="RktVar">s</span>.
+The new sequence is constructed lazily.</div></p><p>If <span class="RktVar">s</span> is a <a href="streams.html#%28tech._stream%29" class="techoutside" data-pltdoc="x"><span class="techinside">stream</span></a>, then the result is also a
+<a href="streams.html#%28tech._stream%29" class="techoutside" data-pltdoc="x"><span class="techinside">stream</span></a>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A%29%29" class="RktStxLink" data-pltdoc="x">let*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">all-reds</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-cycle%29%29" class="RktValLink" data-pltdoc="x">in-cycle</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"red"</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">red-and-blues</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-add-between%29%29" class="RktValLink" data-pltdoc="x">sequence-add-between</a></span><span class="hspace">&nbsp;</span><span class="RktSym">all-reds</span><span class="hspace">&nbsp;</span><span class="RktVal">"blue"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">elt</span><span class="hspace">&nbsp;</span><span class="RktSym">red-and-blues</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">elt</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("red" "blue" "red" "blue" "red" "blue" "red" "blue" "red" "blue")</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">text</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-add-between%29%29" class="RktValLink" data-pltdoc="x">sequence-add-between</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"veni"</span><span class="hspace">&nbsp;</span><span class="RktVal">"vidi"</span><span class="hspace">&nbsp;</span><span class="RktVal">"duci"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">", "</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktSym">text</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">veni, vidi, duci</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/sequence..rkt)._sequence/c))"></a><span title="Provided from: racket/sequence, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">sequence/c</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:min-count</span><span class="hspace">&nbsp;</span><span class="RktVar">min-count</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">elem/c</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">min-count</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">elem/c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Wraps a <a href="sequences.html#%28tech._sequence%29" class="techoutside" data-pltdoc="x"><span class="techinside">sequence</span></a>,
+obligating it to produce elements with as many values as there are <span class="RktVar">elem/c</span> contracts,
+and obligating each value to satisfy the corresponding <span class="RktVar">elem/c</span>.  The
+result is not guaranteed to be the same kind of sequence as the original value;
+for instance, a wrapped list is not guaranteed to satisfy <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span>.</div></p><p>If <span class="RktVar">min-count</span> is a number, the stream is required to have at least that many elements in it.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">predicates</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence%2Fc%29%29" class="RktValLink" data-pltdoc="x">sequence/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="RktValLink" data-pltdoc="x">in-list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._integer~3f%29%29" class="RktValLink" data-pltdoc="x">integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3esymbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;symbol</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">P</span><span class="hspace">&nbsp;</span><span class="RktSym">predicates</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~s\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">P</span><span class="hspace">&nbsp;</span><span class="RktVal">"cat"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">#f</span></p></td></tr><tr><td><p><span class="RktErr">predicates: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: boolean?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: 'cat</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: an element of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(sequence/c (-&gt; any/c boolean?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition predicates)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition predicates)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:55:0</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">numbers&amp;strings</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence%2Fc%29%29" class="RktValLink" data-pltdoc="x">sequence/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="dicts.html#%28def._%28%28lib._racket%2Fdict..rkt%29._in-dict%29%29" class="RktValLink" data-pltdoc="x">in-dict</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">"one"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">"two"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">three</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">N</span><span class="hspace">&nbsp;</span><span class="RktSym">S</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">numbers&amp;strings</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~s: ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">N</span><span class="hspace">&nbsp;</span><span class="RktSym">S</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">1: one</span></p></td></tr><tr><td><p><span class="RktOut">2: two</span></p></td></tr></table></td></tr><tr><td><p><span class="RktErr">numbers&amp;strings: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: string?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: 'three</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: an element of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(sequence/c number? string?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition numbers&amp;strings)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition numbers&amp;strings)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:57:0</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fregion..rkt%29._define%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a-sequence</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence%2Fc%29%29" class="RktValLink" data-pltdoc="x">sequence/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:min-count</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"x"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">a-sequence</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-naturals%29%29" class="RktValLink" data-pltdoc="x">in-naturals</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a is ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">0 is x</span></p></td></tr><tr><td><p><span class="RktErr">a-sequence: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: a sequence that contains at least 2 values</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: "x"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (sequence/c #:min-count 2 char?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition a-sequence)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition a-sequence)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:59:0</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Additional_Sequence_Constructors&quot;">4.16.1.3.1<tt>&nbsp;</tt><a name="(part._.Additional_.Sequence_.Constructors)"></a>Additional Sequence Constructors</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sequence..rkt)._in-syntax))"></a><span title="Provided from: racket/sequence, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._in-syntax%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a sequence whose elements are the successive subparts of
+  <span class="RktVar">stx</span>.
+  Equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=syntax-helpers.html%23%2528def._%2528%2528lib._syntax%252Fstx..rkt%2529._stx-%7E3elist%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">stx-&gt;list</a></span><span class="stt"> </span><span class="RktSym">lst</span><span class="RktPn">)</span>.
+  </div><div class="SIntrapara">An <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._in-syntax%29%29" class="RktValLink" data-pltdoc="x">in-syntax</a></span> application can provide better performance for syntax iteration when it appears directly in a <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> clause.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._in-syntax%29%29" class="RktValLink" data-pltdoc="x">in-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(#&lt;syntax:eval:61:0 1&gt; #&lt;syntax:eval:61:0 2&gt; #&lt;syntax:eval:61:0 3&gt;)</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/sequence..rkt)._in-slice))"></a><span title="Provided from: racket/sequence, racket | Package: base"><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._in-slice%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-slice</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">length</span><span class="hspace">&nbsp;</span><span class="RktVar">seq</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">length</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">seq</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence whose elements are lists with the first <span class="RktVar">length</span>
+elements of <span class="RktVar">seq</span>, then the next <span class="RktVar">length</span> and so on.</div></p><p><div class="SIntrapara"><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">e</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._in-slice%29%29" class="RktValLink" data-pltdoc="x">in-slice</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">e</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((0 1 2) (3 4 5) (6 7))</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="sequences_streams.html" title="backward to &quot;4.16 Sequences and Streams&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="sequences_streams.html" title="up to &quot;4.16 Sequences and Streams&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="streams.html" title="forward to &quot;4.16.2 Streams&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/sequences_streams.html b/clones/docs.racket-lang.org/reference/sequences_streams.html
new file mode 100644
index 00000000..6600a0ff
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/sequences_streams.html
@@ -0,0 +1,7 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.16&nbsp;Sequences and Streams</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewselflink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewselflink" data-pltdoc="x">Sequences and Streams</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.16.1&nbsp;</td><td><a href="sequences.html" class="tocviewlink" data-pltdoc="x">Sequences</a></td></tr><tr><td align="right">4.16.2&nbsp;</td><td><a href="streams.html" class="tocviewlink" data-pltdoc="x">Streams</a></td></tr><tr><td align="right">4.16.3&nbsp;</td><td><a href="Generators.html" class="tocviewlink" data-pltdoc="x">Generators</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="hashtables.html" title="backward to &quot;4.15 Hash Tables&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="sequences.html" title="forward to &quot;4.16.1 Sequences&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;sequences+streams&quot;">4.16<tt>&nbsp;</tt><a name="(part._sequences+streams)"></a>Sequences and Streams</h4><p><a href="sequences.html#%28tech._sequence%29" class="techoutside" data-pltdoc="x"><span class="techinside">Sequences</span></a> and <a href="streams.html#%28tech._stream%29" class="techoutside" data-pltdoc="x"><span class="techinside">streams</span></a> abstract over iteration of elements in a
+collection. Sequences allow iteration with <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> macros or with sequence
+operations such as <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fsequence..rkt%29._sequence-map%29%29" class="RktValLink" data-pltdoc="x">sequence-map</a></span>. Streams are functional sequences that
+can be used either in a generic way or a stream-specific way. <a href="Generators.html#%28tech._generator%29" class="techoutside" data-pltdoc="x"><span class="techinside">Generators</span></a>
+are closely related stateful objects that can be converted to a sequence and
+vice-versa.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sequences.html" class="toclink" data-pltdoc="x">4.16.1<span class="hspace">&nbsp;</span>Sequences</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sequences.html#%28part._.Sequence_.Predicate_and_.Constructors%29" class="toclink" data-pltdoc="x">4.16.1.1<span class="hspace">&nbsp;</span>Sequence Predicate and Constructors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sequences.html#%28part._.Sequence_.Conversion%29" class="toclink" data-pltdoc="x">4.16.1.2<span class="hspace">&nbsp;</span>Sequence Conversion</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sequences.html#%28part._more-sequences%29" class="toclink" data-pltdoc="x">4.16.1.3<span class="hspace">&nbsp;</span>Additional Sequence Operations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="sequences.html#%28part._.Additional_.Sequence_.Constructors%29" class="toclink" data-pltdoc="x">4.16.1.3.1<span class="hspace">&nbsp;</span>Additional Sequence Constructors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="streams.html" class="toclink" data-pltdoc="x">4.16.2<span class="hspace">&nbsp;</span>Streams</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Generators.html" class="toclink" data-pltdoc="x">4.16.3<span class="hspace">&nbsp;</span>Generators</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="hashtables.html" title="backward to &quot;4.15 Hash Tables&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="sequences.html" title="forward to &quot;4.16.1 Sequences&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/serialization.html b/clones/docs.racket-lang.org/reference/serialization.html
new file mode 100644
index 00000000..acdc0ce3
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/serialization.html
@@ -0,0 +1,283 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.9&nbsp;Serialization</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewselflink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serializable~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">serializable?</span></span></a></td></tr><tr><td><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">serialize</span></span></a></td></tr><tr><td><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">deserialize</span></span></a></td></tr><tr><td><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialized~3d~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">serialized=?</span></span></a></td></tr><tr><td><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize-module-guard%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">deserialize-<wbr></wbr>module-<wbr></wbr>guard</span></span></a></td></tr><tr><td><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._serializable-struct%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">serializable-<wbr></wbr>struct</span></span></a></td></tr><tr><td><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._define-serializable-struct%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>serializable-<wbr></wbr>struct</span></span></a></td></tr><tr><td><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._serializable-struct%2Fversions%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">serializable-<wbr></wbr>struct/<span class="mywbr"> &nbsp;</span>versions</span></span></a></td></tr><tr><td><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._define-serializable-struct%2Fversions%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>serializable-<wbr></wbr>struct/<span class="mywbr"> &nbsp;</span>versions</span></span></a></td></tr><tr><td><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._make-deserialize-info%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>deserialize-<wbr></wbr>info</span></span></a></td></tr><tr><td><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._prop~3aserializable%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>serializable</span></span></a></td></tr><tr><td><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._make-serialize-info%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>serialize-<wbr></wbr>info</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Printer_Extension.html" title="backward to &quot;13.8 Printer Extension&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="fasl.html" title="forward to &quot;13.10 Fast-Load Serialization&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;serialization&quot;">13.9<tt>&nbsp;</tt><a name="(part._serialization)"></a><a name="(mod-path._racket/serialize)"></a>Serialization</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="serialization.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/serialize</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="serialization.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/serialize</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/serialize..rkt)._serializable~3f))"></a><span title="Provided from: racket/serialize | Package: base"><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serializable~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">serializable?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> appears to be serializable, without
+checking the content of compound values, and <span class="RktVal">#f</span> otherwise.
+See <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span> for an enumeration of serializable values.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top" colspan="3"><span class="RktPn">(</span><a name="(def._((lib._racket/private/serialize..rkt)._serialize))"></a><span title="Provided from: racket/serialize | Package: base"><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValDef RktValLink" data-pltdoc="x">serialize</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:relative-directory</span><span class="hspace">&nbsp;</span><span class="RktVar">relative-to</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:deserialize-relative-directory</span><span class="hspace">&nbsp;</span><span class="RktVar">deserialize-relative-to</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serializable~3f%29%29" class="RktValLink" data-pltdoc="x">serializable?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">relative-to</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">deserialize-relative-to</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._complete-path~3f%29%29" class="RktValLink" data-pltdoc="x">complete-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">relative-to</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns a value that encapsulates the value <span class="RktVar">v</span>. This value
+includes only readable values, so it can be written to a stream with
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> or <span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._s-exp-~3efasl%29%29" class="RktValLink" data-pltdoc="x">s-exp-&gt;fasl</a></span>, later read from a stream using
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> or <span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._fasl-~3es-exp%29%29" class="RktValLink" data-pltdoc="x">fasl-&gt;s-exp</a></span>, and then converted to a value
+like the original using <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="RktValLink" data-pltdoc="x">deserialize</a></span>. Serialization followed
+by deserialization produces a value with the same graph structure and
+mutability as the original value, but the serialized value is a plain
+tree (i.e., no sharing).</div></p><p>The following kinds of values are serializable:</p><ul><li><p>structures created through <span class="RktSym"><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._serializable-struct%29%29" class="RktStxLink" data-pltdoc="x">serializable-struct</a></span> or
+<span class="RktSym"><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._serializable-struct%2Fversions%29%29" class="RktStxLink" data-pltdoc="x">serializable-struct/versions</a></span>, or more generally
+structures with the <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._prop~3aserializable%29%29" class="RktValLink" data-pltdoc="x">prop:serializable</a></span> property (see
+<span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._prop~3aserializable%29%29" class="RktValLink" data-pltdoc="x">prop:serializable</a></span> for more information);</p></li><li><p><a href="structures.html#%28tech._prefab%29" data-pltdoc="x">prefab</a> structures;</p></li><li><p>instances of classes defined with <span class="RktSym"><a href="objectserialize.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-serializable-class%29%29" class="RktStxLink" data-pltdoc="x">define-serializable-class</a></span>
+or <span class="RktSym"><a href="objectserialize.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-serializable-class%2A%29%29" class="RktStxLink" data-pltdoc="x">define-serializable-class*</a></span>;</p></li><li><p><a href="booleans.html#%28tech._boolean%29" class="techoutside" data-pltdoc="x"><span class="techinside">booleans</span></a>, <a href="numbers.html#%28tech._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">numbers</span></a>, <a href="characters.html#%28tech._character%29" class="techoutside" data-pltdoc="x"><span class="techinside">characters</span></a>, <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> symbols,
+<a href="symbols.html#%28tech._unreadable._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">unreadable symbols</span></a>, <a href="keywords.html#%28tech._keyword%29" class="techoutside" data-pltdoc="x"><span class="techinside">keywords</span></a>, <a href="strings.html#%28tech._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">strings</span></a>, <a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte strings</span></a>, <a href="pathutils.html#%28tech._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">paths</span></a> (for a
+specific convention), <a href="regexp.html#%28tech._regexp._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp values</span></a>, <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>, and the empty list;</p></li><li><p><a href="pairs.html#%28tech._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">pairs</span></a>, <a href="mpairs.html#%28tech._mutable._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutable pairs</span></a>, <a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vectors</span></a>, <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvectors</span></a>, <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvectors</span></a>,
+<a href="boxes.html#%28tech._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">box</span></a>es, <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash tables</span></a>, and <a href="sets.html#%28tech._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">sets</span></a>;</p></li><li><p><span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%29%29" class="RktValLink" data-pltdoc="x">date</a></span>, <span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%2A%29%29" class="RktValLink" data-pltdoc="x">date*</a></span>, <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span> and <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span>
+structures; and</p></li><li><p><a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a> values.</p></li></ul><p>Serialization succeeds for a compound value, such as a pair, only if
+all content of the value is serializable.  If a value given to
+<span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span> is not completely serializable, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>If <span class="RktVar">v</span> contains a cycle (i.e., a collection of objects that
+are all reachable from each other), then <span class="RktVar">v</span> can be serialized
+only if the cycle includes a mutable value, where a <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a>
+structure counts as mutable only if all of its fields are mutable.</p><p>If <span class="RktVar">relative-to</span> is not <span class="RktVal">#f</span>, then paths to serialize
+that extend the path in <span class="RktVar">relative-to</span> are recorded in relative
+and platform-independent form. The possible values and treatment of
+<span class="RktVar">relative-to</span> are the same as for <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._current-write-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-write-relative-directory</a></span>.</p><p>If <span class="RktVar">deserialize-relative-to</span> is not <span class="RktVal">#f</span>, then any paths
+to deserializers as extracted via <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._prop~3aserializable%29%29" class="RktValLink" data-pltdoc="x">prop:serializable</a></span> are
+recorded in relative form. Note that <span class="RktVar">relative-to</span> and
+<span class="RktVar">deserialize-relative-to</span> are independent, but
+<span class="RktVar">deserialize-relative-to</span> defaults to <span class="RktVar">relative-to</span>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span> and <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="RktValLink" data-pltdoc="x">deserialize</a></span> functions
+currently do not handle certain cyclic values that <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> and
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> can handle, such as <span class="RktVal">'</span><span class="RktVal">#0=</span><span class="RktVal">(</span><span class="RktVal">#0#</span><span class="RktVal">)</span>.</p></blockquote></blockquote></blockquote><p>See <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="RktValLink" data-pltdoc="x">deserialize</a></span> for information on the format of serialized
+data.</p><p class="SHistory">Changed in version 6.5.0.4 of package <span class="stt">base</span>: Added keywords and regexp values as serializable.<br/>Changed in version 7.0.0.6: Added the <span class="RktPn">#:relative-directory</span> and
+<span class="RktPn">#:deserialize-relative-directory</span> arguments.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/serialize..rkt)._deserialize))"></a><span title="Provided from: racket/serialize | Package: base"><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="RktValDef RktValLink" data-pltdoc="x">deserialize</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Given a value <span class="RktVar">v</span> that was produced by <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span>,
+produces a value like the one given to <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span>, including
+the same graph structure and mutability.</div></p><p>A serialized representation <span class="RktVar">v</span> is a list of six or seven
+elements:</p><ul><li><p>An optional list <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="RktVal">)</span>, <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span>, <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="RktVal">)</span>,
+or  <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">4</span><span class="RktVal">)</span> that represents
+the version of the serialization format. If the first element
+of a representation is not a list, then the version is
+<span class="RktVal">0</span>. Version 1 adds support for mutable pairs,
+version 2 adds support for <a href="symbols.html#%28tech._unreadable._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">unreadable symbols</span></a>,
+version 3 adds support for <span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%2A%29%29" class="RktValLink" data-pltdoc="x">date*</a></span> structures,
+and version 4 adds support for paths that are meant to
+be relative to the deserialization directory.</p></li><li><p>A non-negative exact integer <span class="RktVar">s-count</span> that represents the
+number of distinct structure types represented in the
+serialized data.</p></li><li><p>A list <span class="RktVar">s-types</span> of length <span class="RktVar">s-count</span>,
+where each element represents a structure type. Each
+structure type is encoded as a pair. The <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> of the
+pair is <span class="RktVal">#f</span> for a structure whose deserialization
+information is defined at the top level, otherwise it is a
+quoted <a href="Module_Names_and_Loading.html#%28tech._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path</span></a>, a byte string (to be converted
+into a platform-specific path using <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;path</a></span>)
+for a module that exports the structure&rsquo;s deserialization
+information, or a relative path element list for a module to
+be resolved with respect to
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-load-relative-directory</a></span> or (as a fallback)
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span>; the list-of-relative-elements
+form is produced by <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span> when
+the <span class="RktPn">#:deserialize-relative-directory</span> argument is
+not <span class="RktVal">#f</span>. The <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> of the pair is the
+name of a binding (at the top level or exported from a
+module) for deserialization information, either a symbol or
+a string representing an <a href="symbols.html#%28tech._unreadable._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">unreadable symbol</span></a>. These two
+are used with either <span class="RktSym">namespace-variable-binding</span> or
+<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span> to obtain deserialization
+information. See <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._make-deserialize-info%29%29" class="RktValLink" data-pltdoc="x">make-deserialize-info</a></span> for more
+information on the binding&rsquo;s value. See also
+<span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize-module-guard%29%29" class="RktValLink" data-pltdoc="x">deserialize-module-guard</a></span>.</p></li><li><p>A non-negative exact integer, <span class="RktVar">g-count</span> that represents the
+number of graph points contained in the following list.</p></li><li><p>A list <span class="RktVar">graph</span> of length <span class="RktVar">g-count</span>, where each element
+ represents a serialized value to be referenced during the
+ construction of other serialized values. Each list element is
+ either a box or not:</p><ul><li><p>A box represents a value that is part of a cycle, and for
+deserialization, it must be allocated with <span class="RktVal">#f</span> for
+each of its fields. The content of the box indicates the
+shape of the value:</p><ul><li><p>a non-negative exact integer <span class="RktVar">i</span> for an instance
+of a structure type that is represented by the
+<span class="RktVar">i</span>th element of the <span class="RktVar">s-types</span> list;</p></li><li><p><span class="RktVal">'</span><span class="RktVal">c</span> for a pair, which fails on
+deserialization (since pairs are immutable; this
+case does not appear in output generated by
+<span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span>);</p></li><li><p><span class="RktVal">'</span><span class="RktVal">m</span> for a mutable pair;</p></li><li><p><span class="RktVal">'</span><span class="RktVal">b</span> for a box;</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">v</span> and whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a non-negative exact integer <span class="RktVar">s</span>
+for a vector of length <span class="RktVar">s</span>;</p></li><li><p>a list whose first element is <span class="RktVal">'</span><span class="RktVal">h</span> and whose
+remaining elements are symbols that determine the
+hash-table type:</p><ul><li><p><span class="RktVal">'</span><span class="RktVal">equal</span> &#8212;<wbr></wbr> <span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hash%29%29" class="RktValLink" data-pltdoc="x">make-hash</a></span><span class="RktPn">)</span></p></li><li><p><span class="RktVal">'</span><span class="RktVal">equal</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">weak</span> &#8212;<wbr></wbr> <span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-weak-hash%29%29" class="RktValLink" data-pltdoc="x">make-weak-hash</a></span><span class="RktPn">)</span></p></li><li><p><span class="RktVal">'</span><span class="RktVal">weak</span> &#8212;<wbr></wbr> <span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-weak-hasheq%29%29" class="RktValLink" data-pltdoc="x">make-weak-hasheq</a></span><span class="RktPn">)</span></p></li><li><p>no symbols &#8212;<wbr></wbr> <span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._make-hasheq%29%29" class="RktValLink" data-pltdoc="x">make-hasheq</a></span><span class="RktPn">)</span></p></li></ul></li><li><p><span class="RktVal">'</span><span class="RktVal">date*</span> for a <span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%2A%29%29" class="RktValLink" data-pltdoc="x">date*</a></span> structure, which
+fails on deserialization (since dates are immutable;
+this case does not appear in output generated by
+<span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span>);</p></li><li><p><span class="RktVal">'</span><span class="RktVal">date</span> for a <span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%29%29" class="RktValLink" data-pltdoc="x">date</a></span> structure, which
+fails on deserialization (since dates are immutable;
+this case does not appear in output generated by
+<span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span>);</p></li><li><p><span class="RktVal">'</span><span class="RktVal">arity-at-least</span> for an
+<span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span> structure, which fails on
+deserialization (since arity-at-least are immutable; this
+case does not appear in output generated by
+<span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span>); or</p></li><li><p><span class="RktVal">'</span><span class="RktVal">mpi</span> for a <a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a>, which
+fails on deserialization (since a module path index is immutable;
+this case does not appear in output generated by
+<span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span>).</p></li><li><p><span class="RktVal">'</span><span class="RktVal">srcloc</span> for a <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span> structure, which
+fails on deserialization (since srclocs are immutable;
+this case does not appear in output generated by
+<span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span>).</p></li></ul><p>The <span class="RktVal">#f</span>-filled value will be updated with content specified
+by the fifth element of the serialization list <span class="RktVar">v</span>.</p></li><li><p>A non-box represents a <span style="font-style: italic">serial</span> value to be
+ constructed immediately, and it is one of the following:</p><ul><li><p>a boolean, number, character, interned symbol, or empty list,
+representing itself.</p></li><li><p>a string, representing an immutable string.</p></li><li><p>a byte string, representing an immutable byte
+string.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">?</span> and whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a non-negative exact integer
+<span class="RktVar">i</span>; it represents the value constructed for the
+<span class="RktVar">i</span>th element of <span class="RktVar">graph</span>, where <span class="RktVar">i</span> is
+less than the position of this element within
+<span class="RktVar">graph</span>.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is a number <span class="RktVar">i</span>; it
+represents an instance of a structure type that is
+described by the <span class="RktVar">i</span>th element of the
+<span class="RktVar">s-types</span> list. The <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> of the pair is
+a list of serials representing arguments to be
+provided to the structure type&rsquo;s deserializer.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">q</span> and whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is an immutable value; it represents
+the quoted value.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">f</span>; it
+represents an instance of a <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure
+type. The <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadr%29%29" class="RktValLink" data-pltdoc="x">cadr</a></span> of the pair is a <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a>
+structure type key, and the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddr%29%29" class="RktValLink" data-pltdoc="x">cddr</a></span> is a list of
+serials representing the field values.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">void</span>,
+representing <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">su</span> and whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a character string; it represents an
+<a href="symbols.html#%28tech._unreadable._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">unreadable symbol</span></a>.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">u</span> and whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is either a byte string or character
+string; it represents a mutable byte or character
+string.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">p</span> and whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a byte string; it represents a
+path using the serializer&rsquo;s path convention
+(deprecated in favor of <span class="RktVal">'</span><span class="RktVal">p+</span>).</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">p+</span>, whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadr%29%29" class="RktValLink" data-pltdoc="x">cadr</a></span> is a byte string, and whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cddr%29%29" class="RktValLink" data-pltdoc="x">cddr</a></span>
+is one of the possible symbol results of
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._system-path-convention-type%29%29" class="RktValLink" data-pltdoc="x">system-path-convention-type</a></span>; it represents a
+path using the specified convention.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">p*</span> and whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a list of byte strings represents a
+relative path; it will be converted by deserialization
+based on <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-load-relative-directory</a></span>,
+falling back to <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span>.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">c</span> and whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a pair of serials; it represents an
+immutable pair.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">c!</span> and whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a pair of serials; it represents a
+pair (but formerly represented a mutable pair), and
+does not appear in output generated by
+<span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span>.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">m</span> and whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a pair of serials; it represents a
+mutable pair.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">v</span> and whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a list of serials; it represents an
+immutable vector.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">v!</span> and whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a list of serials; it represents a
+mutable vector.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">vl</span> and whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a list of serials; it represents a
+<a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a>.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">vx</span> and whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a list of serials; it represents a
+<a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a>.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">b</span> and whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a serial; it represents an immutable
+box.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">b!</span> and whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a serial; it represents a mutable
+box.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">h</span>, whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cadr%29%29" class="RktValLink" data-pltdoc="x">cadr</a></span> is either <span class="RktVal">'</span><span class="RktVal">!</span> or <span class="RktVal">'</span><span class="RktVal"><span class="nobreak">-</span></span>
+(mutable or immutable, respectively), whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._caddr%29%29" class="RktValLink" data-pltdoc="x">caddr</a></span> is a list of symbols (containing
+<span class="RktVal">'</span><span class="RktVal">equal</span>, <span class="RktVal">'</span><span class="RktVal">weak</span>, both, or neither)
+that determines the hash table type, and whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdddr%29%29" class="RktValLink" data-pltdoc="x">cdddr</a></span> is a list of pairs, where the
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> of each pair is a serial for a
+hash-table key and the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a serial for
+the corresponding value.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">date*</span> and whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a list of serials; it represents a
+<span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%2A%29%29" class="RktValLink" data-pltdoc="x">date*</a></span> structure.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">date</span> and whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a list of serials; it represents a
+<span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%29%29" class="RktValLink" data-pltdoc="x">date</a></span> structure.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">arity-at-least</span>
+and whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a serial; it represents an
+<span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._arity-at-least%29%29" class="RktValLink" data-pltdoc="x">arity-at-least</a></span> structure.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">mpi</span> and whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a pair; it represents a
+<a href="Module_Names_and_Loading.html#%28tech._module._path._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path index</span></a> that joins the paired
+values.</p></li><li><p>a pair whose <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> is <span class="RktVal">'</span><span class="RktVal">srcloc</span> and whose
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a list of serials; it represents a
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span> structure.</p></li></ul></li></ul></li><li><p>A list of pairs, where the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> of each pair is a
+non-negative exact integer <span class="RktVar">i</span> and the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> is a
+serial (as defined in the previous bullet). Each element
+represents an update to an <span class="RktVar">i</span>th element of <span class="RktVar">graph</span>
+that was specified as a box, and the serial describes how to
+construct a new value with the same shape as specified by the
+box. The content of this new value must be transferred into the
+value created for the box in <span class="RktVar">graph</span>.</p></li><li><p>A final serial (as defined in the two bullets back)
+representing the result of <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="RktValLink" data-pltdoc="x">deserialize</a></span>.</p></li></ul><p>The result of <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="RktValLink" data-pltdoc="x">deserialize</a></span> shares no mutable values with the
+argument to <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="RktValLink" data-pltdoc="x">deserialize</a></span>.</p><p>If a value provided to <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span> is a simple tree (i.e., no
+sharing), then the fourth and fifth elements in the serialized
+representation will be empty.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/serialize..rkt)._serialized~3d~3f))"></a><span title="Provided from: racket/serialize | Package: base"><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialized~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">serialized=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v1</span><span class="hspace">&nbsp;</span><span class="RktVar">v2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v1</span> and <span class="RktVar">v2</span> represent the same
+serialization information.</div></p><p>More precisely, it returns the same value that <span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="RktValLink" data-pltdoc="x">deserialize</a></span><span class="stt"> </span><span class="RktVar">v1</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="RktValLink" data-pltdoc="x">deserialize</a></span><span class="stt"> </span><span class="RktVar">v2</span><span class="RktPn">)</span><span class="RktPn">)</span> would return if</p><ul><li><p>all structure types whose deserializers are accessed with
+distinct module paths are actually distinct types;</p></li><li><p>all structure types are transparent; and</p></li><li><p>all structure instances contain only the constituent values
+recorded in each of <span class="RktVar">v1</span> and <span class="RktVar">v2</span>.</p></li></ul><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/serialize..rkt)._deserialize-module-guard))"></a><span title="Provided from: racket/serialize | Package: base"><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize-module-guard%29%29" class="RktValDef RktValLink" data-pltdoc="x">deserialize-module-guard</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/serialize | Package: base"><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize-module-guard%29%29" class="RktValDef RktValLink" data-pltdoc="x">deserialize-module-guard</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">guard</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">guard</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A parameter whose value is called by <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="RktValLink" data-pltdoc="x">deserialize</a></span> before
+dynamically loading a module via <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span>. The two
+arguments provided to the procedure are the same as the arguments to
+be passed to <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span>. The procedure can raise an
+exception to disallow the <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span>.</div></p><p>The procedure can optionally return a pair containing a
+<a href="Module_Names_and_Loading.html#%28tech._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">module-path</span></a> and <a href="symbols.html#%28tech._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">symbol</span></a>. If returned,
+<span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="RktValLink" data-pltdoc="x">deserialize</a></span> will use them as arguments to
+<span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span> instead.</p><p class="SHistory">Changed in version 6.90.0.30 of package <span class="stt">base</span>: Adds optional return values for bindings.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/serialize..rkt)._serializable-struct))"></a><span title="Provided from: racket/serialize | Package: base"><span class="RktSym"><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._serializable-struct%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">serializable-struct</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-super</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">field</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">struct-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>, but instances of the structure type are
+serializable with <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span>.  This form is allowed only at
+the top level or in a module&rsquo;s top level (so that deserialization
+information can be found later).</div></p><p>Serialization supports cycles involving the created structure
+type only when all fields are mutable (or when the cycle can be broken
+through some other mutable value).</p><p>In addition to the bindings generated by <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>,
+<span class="RktSym"><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._serializable-struct%29%29" class="RktStxLink" data-pltdoc="x">serializable-struct</a></span> binds
+<span class="RktSym">deserialize-info:</span><span class="RktVar">id</span><span class="RktSym">-v0</span> to
+deserialization information. Furthermore, in a module context, it
+automatically <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span>s this binding in a <span class="RktSym">deserialize-info</span>
+submodule using <span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._module%2B%29%29" class="RktStxLink" data-pltdoc="x">module+</a></span>.</p><p>The <span class="RktSym"><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._serializable-struct%29%29" class="RktStxLink" data-pltdoc="x">serializable-struct</a></span> form enables the construction of
+structure instances from places where <span class="RktVar">id</span> is not accessible,
+since deserialization must construct instances. Furthermore,
+<span class="RktSym"><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._serializable-struct%29%29" class="RktStxLink" data-pltdoc="x">serializable-struct</a></span> provides limited access to field
+mutation, but only for instances generated through the deserialization
+information bound to
+<span class="RktSym">deserialize-info:</span><span class="RktVar">id</span><span class="RktSym">-v0</span>. See
+<span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._make-deserialize-info%29%29" class="RktValLink" data-pltdoc="x">make-deserialize-info</a></span> for more information.</p><p>Beware that the previous paragraph means that if a serializable struct
+is exported via <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._contract-out%29%29" class="RktStxLink" data-pltdoc="x">contract-out</a></span>, for example, the contracts are not
+checked during deserialization. Consider using <span class="RktSym"><a href="attaching-contracts-to-values.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._struct-guard%2Fc%29%29" class="RktStxLink" data-pltdoc="x">struct-guard/c</a></span>
+instead.</p><p>The <span class="RktSym"><span class="nobreak">-v</span>0</span> suffix on the deserialization enables future
+versioning on the structure type through
+<span class="RktSym"><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._serializable-struct%2Fversions%29%29" class="RktStxLink" data-pltdoc="x">serializable-struct/versions</a></span>.</p><p>When a supertype is supplied as <span class="RktVar">maybe-super</span>,
+compile-time information bound to the supertype identifier must
+include all of the supertype&rsquo;s field accessors. If any field mutator
+is missing, the structure type will be treated as immutable for the
+purposes of marshaling (so cycles involving only instances of the
+structure type cannot be handled by the deserializer).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._serializable-struct%29%29" class="RktStxLink" data-pltdoc="x">serializable-struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">point-x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="RktValLink" data-pltdoc="x">deserialize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/serialize..rkt)._define-serializable-struct))"></a><span title="Provided from: racket/serialize | Package: base"><span class="RktSym"><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._define-serializable-struct%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-serializable-struct</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id-maybe-super</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">field</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">struct-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._serializable-struct%29%29" class="RktStxLink" data-pltdoc="x">serializable-struct</a></span>, but with the supertype syntax and
+default constructor name of <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-struct%29%29" class="RktStxLink" data-pltdoc="x">define-struct</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/serialize..rkt)._serializable-struct/versions))"></a><span title="Provided from: racket/serialize | Package: base"><span class="RktSym"><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._serializable-struct%2Fversions%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">serializable-struct/versions</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-super</span><span class="hspace">&nbsp;</span><span class="RktVar">vers</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">field</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">other-version-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">struct-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">other-version-clause</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktVar">other-vers</span><span class="hspace">&nbsp;</span><span class="RktVar">make-proc-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">cycle-make-proc-expr</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._serializable-struct%29%29" class="RktStxLink" data-pltdoc="x">serializable-struct</a></span>, but the generated deserializer
+binding is
+<span class="RktSym">deserialize-info:</span><span class="RktVar">id</span><span class="RktSym">-v</span><span class="RktVar">vers</span>. In
+addition,
+<span class="RktSym">deserialize-info:</span><span class="RktVar">id</span><span class="RktSym">-v</span><span class="RktVar">other-vers</span>
+is bound for each <span class="RktVar">other-vers</span>. The <span class="RktVar">vers</span> and each
+<span class="RktVar">other-vers</span> must be a literal, exact, nonnegative integer.</div></p><p>Each <span class="RktVar">make-proc-expr</span> should produce a procedure, and the
+procedure should accept as many argument as fields in the
+corresponding version of the structure type, and it produces an
+instance of <span class="RktVar">id</span>. Each <span class="RktVar">cycle-make-proc-expr</span> should
+produce a procedure of no arguments; this procedure should return two
+values: an instance <span class="RktSym">x</span> of <span class="RktVar">id</span> (typically with
+<span class="RktVal">#f</span> for all fields) and a procedure that accepts another
+instance of <span class="RktVar">id</span> and copies its field values into <span class="RktSym">x</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._serializable-struct%29%29" class="RktStxLink" data-pltdoc="x">serializable-struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mutable</span><span class="hspace">&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ps</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="RktValLink" data-pltdoc="x">deserialize</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ps</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(point 1 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">set-point-x!</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">xs</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="RktValLink" data-pltdoc="x">deserialize</a></span><span class="hspace">&nbsp;</span><span class="RktSym">xs</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#0=(point #0# 10)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._serializable-struct%2Fversions%29%29" class="RktStxLink" data-pltdoc="x">serializable-struct/versions</a></span><span class="hspace">&nbsp;</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Constructor for simple v0 instances:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Constructor for v0 instance in a cycle:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">p0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">p0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">set-point-x!</span><span class="hspace">&nbsp;</span><span class="RktSym">p0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point-x</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">set-point-y!</span><span class="hspace">&nbsp;</span><span class="RktSym">p0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point-y</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:mutable</span><span class="hspace">&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="RktValLink" data-pltdoc="x">deserialize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(point 4 5 6)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="RktValLink" data-pltdoc="x">deserialize</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ps</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(point 1 2 0)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="RktValLink" data-pltdoc="x">deserialize</a></span><span class="hspace">&nbsp;</span><span class="RktSym">xs</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#0=(point #0# 10 0)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/serialize..rkt)._define-serializable-struct/versions))"></a><span title="Provided from: racket/serialize | Package: base"><span class="RktSym"><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._define-serializable-struct%2Fversions%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-serializable-struct/versions</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id-maybe-super</span><span class="hspace">&nbsp;</span><span class="RktVar">vers</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">field</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">other-version-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">struct-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="serialization.html#%28form._%28%28lib._racket%2Fserialize..rkt%29._serializable-struct%2Fversions%29%29" class="RktStxLink" data-pltdoc="x">serializable-struct/versions</a></span>, but with the supertype syntax and
+default constructor name of <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-struct%29%29" class="RktStxLink" data-pltdoc="x">define-struct</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/serialize..rkt)._make-deserialize-info))"></a><span title="Provided from: racket/serialize | Package: base"><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._make-deserialize-info%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-deserialize-info</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">make</span><span class="hspace">&nbsp;</span><span class="RktVar">cycle-make</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">make</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cycle-make</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a deserialization information record to be used by
+<span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="RktValLink" data-pltdoc="x">deserialize</a></span>. This information is normally tied to a
+particular structure because the structure has a
+<span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._prop~3aserializable%29%29" class="RktValLink" data-pltdoc="x">prop:serializable</a></span> property value that points to a top-level
+variable or module-exported variable that is bound to deserialization
+information.</div></p><p>The <span class="RktVar">make</span> procedure should accept as many arguments as the
+structure&rsquo;s serializer put into a vector; normally, this is the number
+of fields in the structure. It should return an instance of the
+structure.</p><p>The <span class="RktVar">cycle-make</span> procedure should accept no arguments, and it
+should return two values: a structure instance <span class="RktSym">x</span> (with dummy
+field values) and an update procedure. The update procedure takes
+another structure instance generated by the <span class="RktVar">make</span>, and it
+transfers the field values of this instance into <span class="RktSym">x</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/private/serialize..rkt)._prop~3aserializable))"></a><span title="Provided from: racket/serialize | Package: base"><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._prop~3aserializable%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:serializable</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym">property?</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">This property identifies structures and structure types that are
+serializable. The property value should be constructed with
+<span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._make-serialize-info%29%29" class="RktValLink" data-pltdoc="x">make-serialize-info</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/serialize..rkt)._make-serialize-info))"></a><span title="Provided from: racket/serialize | Package: base"><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._make-serialize-info%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-serialize-info</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">to-vector</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">deserialize-id</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">can-cycle?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">dir</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">to-vector</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">deserialize-id</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">can-cycle?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dir</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a value to be associated with a structure type through the
+<span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._prop~3aserializable%29%29" class="RktValLink" data-pltdoc="x">prop:serializable</a></span> property. This value is used by
+<span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span>.</div></p><p>The <span class="RktVar">to-vector</span> procedure should accept a structure instance
+and produce a vector for the instance&rsquo;s content.</p><p>The <span class="RktVar">deserialize-id</span> value indicates a binding for deserialize
+information, to either a module export or a top-level definition. It
+must be one of the following:</p><ul><li><p>If <span class="RktVar">deserialize-id</span> is an identifier, and if
+<span class="RktPn">(</span><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="RktValLink" data-pltdoc="x">identifier-binding</a></span><span class="stt"> </span><span class="RktVar">deserialize-id</span><span class="RktPn">)</span> produces a list, then
+the third element is used for the exporting module, otherwise the
+top-level is assumed. Before trying an exporting module directly,
+its <span class="RktSym">deserialize-info</span> submodule is tried; the module
+itself is tried if no <span class="RktSym">deserialize-info</span>
+submodule is available or if the export is not found. In either case, <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span> is used to
+obtain the name of an exported identifier or top-level definition.</p></li><li><p>If <span class="RktVar">deserialize-id</span> is a symbol, it indicates a
+top-level variable that is named by the symbol.</p></li><li><p>If <span class="RktVar">deserialize-id</span> is a pair, the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> must be
+a symbol to name an exported identifier, and the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> must be
+a module path index to specify the exporting module.</p></li><li><p>If <span class="RktVar">deserialize-id</span> is a procedure, then it is
+applied during serialization and its result is used for
+<span class="RktVar">deserialize-id</span>.</p></li></ul><p>See <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._make-deserialize-info%29%29" class="RktValLink" data-pltdoc="x">make-deserialize-info</a></span> and <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="RktValLink" data-pltdoc="x">deserialize</a></span> for more
+information.</p><p>The <span class="RktVar">can-cycle?</span> argument should be false if instances should
+not be serialized in such a way that deserialization requires creating
+a structure instance with dummy field values and then updating the
+instance later.</p><p>The <span class="RktVar">dir</span> argument should be a directory path that is used to
+resolve a module reference for the binding of <span class="RktVar">deserialize-id</span>.
+This directory path is used as a last resort when
+<span class="RktVar">deserialize-id</span> indicates a module that was loaded through a
+relative path with respect to the top level. Usually, it should be
+<span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-load-relative-directory</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span><span class="RktPn">)</span><span class="RktPn">)</span>.</p><p class="SHistory">Changed in version 7.0.0.6 of package <span class="stt">base</span>: Allow <span class="RktVar">deserialize-id</span> to be a procedure.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pie</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">type</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:mutable</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:property</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._prop~3aserializable%29%29" class="RktValLink" data-pltdoc="x">prop:serializable</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._make-serialize-info%29%29" class="RktValLink" data-pltdoc="x">make-serialize-info</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this%29%29" class="RktStxLink" data-pltdoc="x">this</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">pie-type</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._this%29%29" class="RktStxLink" data-pltdoc="x">this</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">pie-beam</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-load-relative-directory%29%29" class="RktValLink" data-pltdoc="x">current-load-relative-directory</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pie-beam</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._make-deserialize-info%29%29" class="RktValLink" data-pltdoc="x">make-deserialize-info</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">type</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">pie</span><span class="hspace">&nbsp;</span><span class="RktSym">type</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pie-pattern</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">pie</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">transporter-error</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pie-pattern</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">type</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">set-pie-type!</span><span class="hspace">&nbsp;</span><span class="RktSym">pie-pattern</span><span class="hspace">&nbsp;</span><span class="RktSym">type</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">original-pie</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">pie</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">apple</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">original-pie</span></td></tr><tr><td><p><span class="RktRes">#&lt;pie&gt;</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pie-in-transit</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span><span class="hspace">&nbsp;</span><span class="RktSym">original-pie</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">pie-in-transit</span></td></tr><tr><td><p><span class="RktRes">'((3) 1 ((#f . pie-beam)) 0 () () (0 apple))</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">beamed-up-pie</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._deserialize%29%29" class="RktValLink" data-pltdoc="x">deserialize</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pie-in-transit</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">beamed-up-pie</span></td></tr><tr><td><p><span class="RktRes">#&lt;pie&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">pie-type</span><span class="hspace">&nbsp;</span><span class="RktSym">beamed-up-pie</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'apple</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">beamed-up-pie</span><span class="hspace">&nbsp;</span><span class="RktSym">original-pie</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Printer_Extension.html" title="backward to &quot;13.8 Printer Extension&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="fasl.html" title="forward to &quot;13.10 Fast-Load Serialization&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/set_.html b/clones/docs.racket-lang.org/reference/set_.html
new file mode 100644
index 00000000..05bc4521
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/set_.html
@@ -0,0 +1,24 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.17&nbsp;Assignment: set! and set!-values</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewselflink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">set!</span></span></a></td></tr><tr><td><a href="set_.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._set%21-values%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="when_unless.html" title="backward to &quot;3.16 Guarded Evaluation: when and unless&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="for.html" title="forward to &quot;3.18 Iterations and Comprehensions: for, for/list, ...&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;set!&quot;">3.17<tt>&nbsp;</tt><a name="(part._set!)"></a>Assignment: <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span> and <span class="RktSym"><a href="set_.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._set%21-values%29%29" class="RktStxLink" data-pltdoc="x">set!-values</a></span></h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=set_.html&amp;version=8.6" class="Sq" data-pltdoc="x">Assignment: <span class="RktSym"><span class="RktStxLink">set!</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._set!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">If <span class="RktVar">id</span> has a <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding to an <a href="syntax-model.html#%28tech._assignment._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">assignment
+transformer</span></a>, as produced by <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-set%21-transformer%29%29" class="RktValLink" data-pltdoc="x">make-set!-transformer</a></span> or as an
+instance of a structure type with the <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aset%21-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:set!-transformer</a></span>
+property, then this form is expanded by calling the assignment
+transformer with the full expressions. If <span class="RktVar">id</span> has a
+<a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding to a <a href="syntax-model.html#%28tech._rename._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">rename transformer</span></a> as produced
+by <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span> or as an instance of a structure
+type with the <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3arename-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:rename-transformer</a></span> property, then this
+form is expanded by replacing <span class="RktVar">id</span> with the target identifier
+(e.g., the one provided to <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span>). If a
+transformer binding has both <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aset%21-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:set!-transformer</a></span> and
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3arename-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:rename-transformer</a></span> properties, the latter takes
+precedence.</div></p><p>Otherwise, evaluates <span class="RktVar">expr</span> and installs the result into the
+location for <span class="RktVar">id</span>, which must be bound as a local variable or
+defined as a <a href="eval-model.html#%28tech._top._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level variable</span></a> or <a href="eval-model.html#%28tech._module._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">module-level
+variable</span></a>. If <span class="RktVar">id</span> refers to an imported binding, a syntax
+error is reported.  If <span class="RktVar">id</span> refers to a <a href="eval-model.html#%28tech._top._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level
+variable</span></a> that has not been defined, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>See also <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._compile-allow-set%21-undefined%29%29" class="RktValLink" data-pltdoc="x">compile-allow-set!-undefined</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">12</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">x</span></td></tr><tr><td><p><span class="RktRes">13</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">6</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i-am-not-defined</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">set!: assignment disallowed;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot set variable before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">variable: i-am-not-defined</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/more-scheme..rkt)._set!-values))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="set_.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._set%21-values%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">set!-values</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Assuming that all <span class="RktVar">id</span>s refer to variables, this form evaluates
+<span class="RktVar">expr</span>, which must produce as many values as supplied
+<span class="RktVar">id</span>s.  The location of each <span class="RktVar">id</span> is filled with the
+corresponding value from <span class="RktVar">expr</span> in the same way as for
+<span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._set%21-values%29%29" class="RktStxLink" data-pltdoc="x">set!-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(2 1)</span></p></td></tr></table></blockquote></div></p><p>More generally, the <span class="RktSym"><a href="set_.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._set%21-values%29%29" class="RktStxLink" data-pltdoc="x">set!-values</a></span> form is expanded to</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">tmp-id</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">tmp-id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr></table></blockquote><p>which triggers further expansion if any <span class="RktVar">id</span> has a transformer
+binding to an <a href="syntax-model.html#%28tech._assignment._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">assignment transformer</span></a>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="when_unless.html" title="backward to &quot;3.16 Guarded Evaluation: when and unless&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="for.html" title="forward to &quot;3.18 Iterations and Comprehensions: for, for/list, ...&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/sets.html b/clones/docs.racket-lang.org/reference/sets.html
new file mode 100644
index 00000000..8a6c2def
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/sets.html
@@ -0,0 +1,276 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.18&nbsp;Sets</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewselflink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.18&nbsp;</td><td><a href="sets.html" class="tocviewselflink" data-pltdoc="x">Sets</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.18.1&nbsp;</td><td><a href="sets.html#%28part._.Hash_.Sets%29" class="tocviewlink" data-pltdoc="x">Hash Sets</a></td></tr><tr><td align="right">4.18.2&nbsp;</td><td><a href="sets.html#%28part._.Set_.Predicates_and_.Contracts%29" class="tocviewlink" data-pltdoc="x">Set Predicates and Contracts</a></td></tr><tr><td align="right">4.18.3&nbsp;</td><td><a href="sets.html#%28part._.Generic_.Set_.Interface%29" class="tocviewlink" data-pltdoc="x">Generic Set Interface</a></td></tr><tr><td align="right">4.18.4&nbsp;</td><td><a href="sets.html#%28part._.Custom_.Hash_.Sets%29" class="tocviewlink" data-pltdoc="x">Custom Hash Sets</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">4.18.1<tt>&nbsp;</tt></span><a href="sets.html#%28part._.Hash_.Sets%29" class="tocsubseclink" data-pltdoc="x">Hash Sets</a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-equal~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>equal?</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-equal-always~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>equal-<wbr></wbr>always?</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-eqv~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>eqv?</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-eq~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>eq?</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set?</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-mutable~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>mutable?</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-weak~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>weak?</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._setalw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">setalw</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._seteqv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">seteqv</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._seteq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">seteq</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._mutable-set%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">mutable-<wbr></wbr>set</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._mutable-setalw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">mutable-<wbr></wbr>setalw</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._mutable-seteqv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">mutable-<wbr></wbr>seteqv</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._mutable-seteq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">mutable-<wbr></wbr>seteq</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._weak-set%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">weak-<wbr></wbr>set</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._weak-setalw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">weak-<wbr></wbr>setalw</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._weak-seteqv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">weak-<wbr></wbr>seteqv</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._weak-seteq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">weak-<wbr></wbr>seteq</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eset%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-<wbr></wbr>&gt;set</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3esetalw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-<wbr></wbr>&gt;setalw</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eseteqv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-<wbr></wbr>&gt;seteqv</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eseteq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-<wbr></wbr>&gt;seteq</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3emutable-set%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-<wbr></wbr>&gt;mutable-<wbr></wbr>set</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3emutable-setalw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-<wbr></wbr>&gt;mutable-<wbr></wbr>setalw</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3emutable-seteqv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-<wbr></wbr>&gt;mutable-<wbr></wbr>seteqv</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3emutable-seteq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-<wbr></wbr>&gt;mutable-<wbr></wbr>seteq</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eweak-set%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-<wbr></wbr>&gt;weak-<wbr></wbr>set</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eweak-setalw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-<wbr></wbr>&gt;weak-<wbr></wbr>setalw</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eweak-seteqv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-<wbr></wbr>&gt;weak-<wbr></wbr>seteqv</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eweak-seteq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-<wbr></wbr>&gt;weak-<wbr></wbr>seteq</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fset%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>set</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fseteq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>seteq</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fseteqv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>seteqv</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fsetalw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>setalw</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fset%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>set</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fseteq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>seteq</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fseteqv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>seteqv</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fsetalw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>setalw</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fmutable-set%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>mutable-<wbr></wbr>set</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fmutable-seteq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>mutable-<wbr></wbr>seteq</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fmutable-seteqv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>mutable-<wbr></wbr>seteqv</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fmutable-setalw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>mutable-<wbr></wbr>setalw</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fmutable-set%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>mutable-<wbr></wbr>set</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fmutable-seteq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>mutable-<wbr></wbr>seteq</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fmutable-seteqv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>mutable-<wbr></wbr>seteqv</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fmutable-setalw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>mutable-<wbr></wbr>setalw</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fweak-set%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>weak-<wbr></wbr>set</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fweak-seteq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>weak-<wbr></wbr>seteq</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fweak-seteqv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>weak-<wbr></wbr>seteqv</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fweak-setalw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>weak-<wbr></wbr>setalw</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fweak-set%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>weak-<wbr></wbr>set</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fweak-seteq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>weak-<wbr></wbr>seteq</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fweak-seteqv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>weak-<wbr></wbr>seteqv</span></span></a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fweak-setalw%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>weak-<wbr></wbr>setalw</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._in-immutable-set%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>immutable-<wbr></wbr>set</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._in-mutable-set%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>mutable-<wbr></wbr>set</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._in-weak-set%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>weak-<wbr></wbr>set</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.18.2<tt>&nbsp;</tt></span><a href="sets.html#%28part._.Set_.Predicates_and_.Contracts%29" class="tocsubseclink" data-pltdoc="x">Set Predicates and Contracts</a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">generic-<wbr></wbr>set?</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-implements~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>implements?</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-implements%2Fc%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>implements/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%2Fc%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.18.3<tt>&nbsp;</tt></span><a href="sets.html#%28part._.Generic_.Set_.Interface%29" class="tocsubseclink" data-pltdoc="x">Generic Set Interface</a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._gen~3aset%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">gen:<span class="mywbr"> &nbsp;</span>set</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.18.3.1<tt>&nbsp;</tt></span><a href="sets.html#%28part._set-methods%29" class="tocsubseclink" data-pltdoc="x">Set Methods</a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-member~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>member?</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-add%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>add</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-add%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>add!</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>remove</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>remove!</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-empty~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>empty?</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-count%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>count</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-first%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>first</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-rest%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>rest</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>&gt;stream</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-copy%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>copy</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-copy-clear%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>copy-<wbr></wbr>clear</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-clear%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>clear</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-clear%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>clear!</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-union%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>union</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-union%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>union!</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-intersect%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>intersect</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-intersect%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>intersect!</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-subtract%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>subtract</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-subtract%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>subtract!</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-symmetric-difference%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>symmetric-<wbr></wbr>difference</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-symmetric-difference%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>symmetric-<wbr></wbr>difference!</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set=?</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._subset~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subset?</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._proper-subset~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">proper-<wbr></wbr>subset?</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3elist%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>&gt;list</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-map%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>map</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-for-each%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set-<wbr></wbr>for-<wbr></wbr>each</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._in-set%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>set</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._impersonate-hash-set%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">impersonate-<wbr></wbr>hash-<wbr></wbr>set</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._chaperone-hash-set%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-<wbr></wbr>hash-<wbr></wbr>set</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.18.4<tt>&nbsp;</tt></span><a href="sets.html#%28part._.Custom_.Hash_.Sets%29" class="tocsubseclink" data-pltdoc="x">Custom Hash Sets</a></td></tr><tr><td><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._define-custom-set-types%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>custom-<wbr></wbr>set-<wbr></wbr>types</span></span></a></td></tr><tr><td><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._make-custom-set-types%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>custom-<wbr></wbr>set-<wbr></wbr>types</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="dicts.html" title="backward to &quot;4.17 Dictionaries&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="procedures.html" title="forward to &quot;4.19 Procedures&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;sets&quot;">4.18<tt>&nbsp;</tt><a name="(part._sets)"></a><a name="(mod-path._racket/set)"></a>Sets</h4><p>A <a name="(tech._set)"></a><span style="font-style: italic">set</span> represents a collection of distinct elements.  The following
+datatypes are all sets:</p><ul><li><p><a href="sets.html#%28tech._hash._set%29" data-pltdoc="x">hash sets</a>;</p></li><li><p><a href="pairs.html#%28tech._list%29" data-pltdoc="x">lists</a> using <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to compare elements; and</p></li><li><p><a href="structures.html#%28tech._structure%29" data-pltdoc="x">structures</a> whose types implement the <span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._gen~3aset%29%29" class="RktStxLink" data-pltdoc="x">gen:set</a></span>
+<a href="struct-generics.html#%28tech._generic._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">generic interface</span></a>.</p></li></ul><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="sets.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/set</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="sets.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/set</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Hash_Sets&quot;">4.18.1<tt>&nbsp;</tt><a name="(part._.Hash_.Sets)"></a>Hash Sets</h5><p>A <a name="(tech._hash._set)"></a><span style="font-style: italic">hash set</span> is a set whose elements are compared via <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>,
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> and partitioned
+via <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-hash-code</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always-hash-code%29%29" class="RktValLink" data-pltdoc="x">equal-always-hash-code</a></span>,
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv-hash-code%29%29" class="RktValLink" data-pltdoc="x">eqv-hash-code</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq-hash-code%29%29" class="RktValLink" data-pltdoc="x">eq-hash-code</a></span>.  A hash set is either
+immutable or mutable; mutable hash sets retain their elements either strongly
+or weakly.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Like operations on immutable hash tables, &ldquo;constant time&rdquo; hash
+set operations actually require <span style="font-style: italic">O</span>(<span style="font-style: italic">log N</span>)<span style="font-style: italic"></span> time for a set of size
+<span style="font-style: italic">N</span>.</p></blockquote></blockquote></blockquote><p>A hash set can be used as a <a href="streams.html#%28tech._stream%29" class="techoutside" data-pltdoc="x"><span class="techinside">stream</span></a> (see <a href="streams.html" data-pltdoc="x">Streams</a>) and thus as
+a single-valued <a href="sequences.html#%28tech._sequence%29" class="techoutside" data-pltdoc="x"><span class="techinside">sequence</span></a> (see <a href="sequences.html" data-pltdoc="x">Sequences</a>). The elements of the
+set serve as elements of the stream or sequence. If an element is added to or
+removed from the hash set during iteration, then an iteration step may fail
+with <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span>, or the iteration may skip or duplicate
+elements. See also <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._in-set%29%29" class="RktValLink" data-pltdoc="x">in-set</a></span>.</p><p>Two hash sets are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> when they use the same element-comparison
+procedure (<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>), both hold elements strongly or weakly, have the same
+mutability, and have equivalent elements.
+Immutable hash sets support effectively constant-time access and
+update, just like mutable hash sets; the constant on immutable operations is
+usually larger, but the functional nature of immutable hash sets can pay off in
+certain algorithms.</p><p>All hash sets <a href="struct-generics.html#%28tech._implemented._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">implement</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValLink" data-pltdoc="x">set-&gt;stream</a></span>,
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-empty~3f%29%29" class="RktValLink" data-pltdoc="x">set-empty?</a></span>, <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-member~3f%29%29" class="RktValLink" data-pltdoc="x">set-member?</a></span>, <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-count%29%29" class="RktValLink" data-pltdoc="x">set-count</a></span>,
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._subset~3f%29%29" class="RktValLink" data-pltdoc="x">subset?</a></span>, <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._proper-subset~3f%29%29" class="RktValLink" data-pltdoc="x">proper-subset?</a></span>, <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-map%29%29" class="RktValLink" data-pltdoc="x">set-map</a></span>,
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-for-each%29%29" class="RktValLink" data-pltdoc="x">set-for-each</a></span>, <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-copy%29%29" class="RktValLink" data-pltdoc="x">set-copy</a></span>, <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-copy-clear%29%29" class="RktValLink" data-pltdoc="x">set-copy-clear</a></span>,
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3elist%29%29" class="RktValLink" data-pltdoc="x">set-&gt;list</a></span>, and <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-first%29%29" class="RktValLink" data-pltdoc="x">set-first</a></span>.  Immutable hash sets in
+addition <a href="struct-generics.html#%28tech._implemented._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">implement</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-add%29%29" class="RktValLink" data-pltdoc="x">set-add</a></span>, <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%29%29" class="RktValLink" data-pltdoc="x">set-remove</a></span>,
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-clear%29%29" class="RktValLink" data-pltdoc="x">set-clear</a></span>, <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-union%29%29" class="RktValLink" data-pltdoc="x">set-union</a></span>, <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-intersect%29%29" class="RktValLink" data-pltdoc="x">set-intersect</a></span>,
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-subtract%29%29" class="RktValLink" data-pltdoc="x">set-subtract</a></span>, and <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-symmetric-difference%29%29" class="RktValLink" data-pltdoc="x">set-symmetric-difference</a></span>.  Mutable
+hash sets in addition <a href="struct-generics.html#%28tech._implemented._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">implement</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-add%21%29%29" class="RktValLink" data-pltdoc="x">set-add!</a></span>,
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%21%29%29" class="RktValLink" data-pltdoc="x">set-remove!</a></span>, <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-clear%21%29%29" class="RktValLink" data-pltdoc="x">set-clear!</a></span>, <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-union%21%29%29" class="RktValLink" data-pltdoc="x">set-union!</a></span>,
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-intersect%21%29%29" class="RktValLink" data-pltdoc="x">set-intersect!</a></span>, <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-subtract%21%29%29" class="RktValLink" data-pltdoc="x">set-subtract!</a></span>, and
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-symmetric-difference%21%29%29" class="RktValLink" data-pltdoc="x">set-symmetric-difference!</a></span>.</p><p>Operations on sets that contain elements that are mutated are
+unpredictable in much the same way that <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash table</span></a> operations are
+unpredictable when keys are mutated.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-equal~3f))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-equal~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-equal?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-equal-always~3f))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-equal-always~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-equal-always?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-eqv~3f))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-eqv~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-eqv?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-eq~3f))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-eq~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-eq?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">x</span> is a <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a> that compares
+elements with <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>,
+or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>, respectively; returns <span class="RktVal">#f</span> otherwise.</div></p><p class="SHistory">Changed in version 8.5.0.3 of package <span class="stt">base</span>: Added <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">set-equal-always?</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set~3f))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">set?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-mutable~3f))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-mutable~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-mutable?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-weak~3f))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-weak~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-weak?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">x</span> is a <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a> that is respectively
+immutable, mutable with strongly-held keys, or mutable with weakly-held keys;
+returns <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValDef RktValLink" data-pltdoc="x">set</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-equal~3f%29%29" class="RktValLink" data-pltdoc="x">set-equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._setalw))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._setalw%29%29" class="RktValDef RktValLink" data-pltdoc="x">setalw</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">set-equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._seteqv))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._seteqv%29%29" class="RktValDef RktValLink" data-pltdoc="x">seteqv</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-eqv~3f%29%29" class="RktValLink" data-pltdoc="x">set-eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._seteq))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._seteq%29%29" class="RktValDef RktValLink" data-pltdoc="x">seteq</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-eq~3f%29%29" class="RktValLink" data-pltdoc="x">set-eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._mutable-set))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._mutable-set%29%29" class="RktValDef RktValLink" data-pltdoc="x">mutable-set</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-equal~3f%29%29" class="RktValLink" data-pltdoc="x">set-equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-mutable~3f%29%29" class="RktValLink" data-pltdoc="x">set-mutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._mutable-setalw))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._mutable-setalw%29%29" class="RktValDef RktValLink" data-pltdoc="x">mutable-setalw</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">set-equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-mutable~3f%29%29" class="RktValLink" data-pltdoc="x">set-mutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._mutable-seteqv))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._mutable-seteqv%29%29" class="RktValDef RktValLink" data-pltdoc="x">mutable-seteqv</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-eqv~3f%29%29" class="RktValLink" data-pltdoc="x">set-eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-mutable~3f%29%29" class="RktValLink" data-pltdoc="x">set-mutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._mutable-seteq))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._mutable-seteq%29%29" class="RktValDef RktValLink" data-pltdoc="x">mutable-seteq</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-eq~3f%29%29" class="RktValLink" data-pltdoc="x">set-eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-mutable~3f%29%29" class="RktValLink" data-pltdoc="x">set-mutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._weak-set))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._weak-set%29%29" class="RktValDef RktValLink" data-pltdoc="x">weak-set</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-equal~3f%29%29" class="RktValLink" data-pltdoc="x">set-equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-weak~3f%29%29" class="RktValLink" data-pltdoc="x">set-weak?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._weak-setalw))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._weak-setalw%29%29" class="RktValDef RktValLink" data-pltdoc="x">weak-setalw</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">set-equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-weak~3f%29%29" class="RktValLink" data-pltdoc="x">set-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._weak-seteqv))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._weak-seteqv%29%29" class="RktValDef RktValLink" data-pltdoc="x">weak-seteqv</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-eqv~3f%29%29" class="RktValLink" data-pltdoc="x">set-eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-weak~3f%29%29" class="RktValLink" data-pltdoc="x">set-weak?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._weak-seteq))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._weak-seteq%29%29" class="RktValDef RktValLink" data-pltdoc="x">weak-seteq</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-eq~3f%29%29" class="RktValLink" data-pltdoc="x">set-eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-weak~3f%29%29" class="RktValLink" data-pltdoc="x">set-weak?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Creates a <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a> with the given <span class="RktVar">v</span>s as elements.  The
+elements are added in the order that they appear as arguments, so in the case
+of sets that use <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>,
+an earlier element may be replaced by a later element that is
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, but not
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>.</div></p><p class="SHistory">Changed in version 8.5.0.3 of package <span class="stt">base</span>: Added <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._setalw%29%29" class="RktValLink" data-pltdoc="x">setalw</a></span>,
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._mutable-setalw%29%29" class="RktValLink" data-pltdoc="x">mutable-setalw</a></span>, and <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._weak-setalw%29%29" class="RktValLink" data-pltdoc="x">weak-setalw</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._list-~3eset))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eset%29%29" class="RktValDef RktValLink" data-pltdoc="x">list-&gt;set</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-equal~3f%29%29" class="RktValLink" data-pltdoc="x">set-equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._list-~3esetalw))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3esetalw%29%29" class="RktValDef RktValLink" data-pltdoc="x">list-&gt;setalw</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">set-equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._list-~3eseteqv))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eseteqv%29%29" class="RktValDef RktValLink" data-pltdoc="x">list-&gt;seteqv</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-eqv~3f%29%29" class="RktValLink" data-pltdoc="x">set-eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._list-~3eseteq))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eseteq%29%29" class="RktValDef RktValLink" data-pltdoc="x">list-&gt;seteq</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-eq~3f%29%29" class="RktValLink" data-pltdoc="x">set-eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._list-~3emutable-set))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3emutable-set%29%29" class="RktValDef RktValLink" data-pltdoc="x">list-&gt;mutable-set</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-equal~3f%29%29" class="RktValLink" data-pltdoc="x">set-equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-mutable~3f%29%29" class="RktValLink" data-pltdoc="x">set-mutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._list-~3emutable-setalw))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3emutable-setalw%29%29" class="RktValDef RktValLink" data-pltdoc="x">list-&gt;mutable-setalw</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">set-equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-mutable~3f%29%29" class="RktValLink" data-pltdoc="x">set-mutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._list-~3emutable-seteqv))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3emutable-seteqv%29%29" class="RktValDef RktValLink" data-pltdoc="x">list-&gt;mutable-seteqv</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-eqv~3f%29%29" class="RktValLink" data-pltdoc="x">set-eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-mutable~3f%29%29" class="RktValLink" data-pltdoc="x">set-mutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._list-~3emutable-seteq))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3emutable-seteq%29%29" class="RktValDef RktValLink" data-pltdoc="x">list-&gt;mutable-seteq</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-eq~3f%29%29" class="RktValLink" data-pltdoc="x">set-eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-mutable~3f%29%29" class="RktValLink" data-pltdoc="x">set-mutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._list-~3eweak-set))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eweak-set%29%29" class="RktValDef RktValLink" data-pltdoc="x">list-&gt;weak-set</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-equal~3f%29%29" class="RktValLink" data-pltdoc="x">set-equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-weak~3f%29%29" class="RktValLink" data-pltdoc="x">set-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._list-~3eweak-setalw))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eweak-setalw%29%29" class="RktValDef RktValLink" data-pltdoc="x">list-&gt;weak-setalw</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">set-equal-always?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-weak~3f%29%29" class="RktValLink" data-pltdoc="x">set-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._list-~3eweak-seteqv))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eweak-seteqv%29%29" class="RktValDef RktValLink" data-pltdoc="x">list-&gt;weak-seteqv</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-eqv~3f%29%29" class="RktValLink" data-pltdoc="x">set-eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-weak~3f%29%29" class="RktValLink" data-pltdoc="x">set-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._list-~3eweak-seteq))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eweak-seteq%29%29" class="RktValDef RktValLink" data-pltdoc="x">list-&gt;weak-seteq</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-eq~3f%29%29" class="RktValLink" data-pltdoc="x">set-eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-weak~3f%29%29" class="RktValLink" data-pltdoc="x">set-weak?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Creates a <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a> with the elements of the given <span class="RktVar">lst</span> as
+the elements of the set.  Equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span><span class="stt"> </span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="stt"> </span><span class="RktVar">lst</span><span class="RktPn">)</span>,
+<span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span><span class="stt"> </span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._setalw%29%29" class="RktValLink" data-pltdoc="x">setalw</a></span><span class="stt"> </span><span class="RktVar">lst</span><span class="RktPn">)</span>, <span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span><span class="stt"> </span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._seteqv%29%29" class="RktValLink" data-pltdoc="x">seteqv</a></span><span class="stt"> </span><span class="RktVar">lst</span><span class="RktPn">)</span>,
+<span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span><span class="stt"> </span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._seteq%29%29" class="RktValLink" data-pltdoc="x">seteq</a></span><span class="stt"> </span><span class="RktVar">lst</span><span class="RktPn">)</span>, and so on, respectively.</div></p><p class="SHistory">Changed in version 8.5.0.3 of package <span class="stt">base</span>: Added <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3esetalw%29%29" class="RktValLink" data-pltdoc="x">list-&gt;setalw</a></span>,
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3emutable-setalw%29%29" class="RktValLink" data-pltdoc="x">list-&gt;mutable-setalw</a></span>, and <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._list-~3eweak-setalw%29%29" class="RktValLink" data-pltdoc="x">list-&gt;weak-setalw</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for/set))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fset%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/set</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for/seteq))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fseteq%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/seteq</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for/seteqv))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fseteqv%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/seteqv</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for/setalw))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fsetalw%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/setalw</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for*/set))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fset%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/set</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for*/seteq))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fseteq%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/seteq</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for*/seteqv))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fseteqv%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/seteqv</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for*/setalw))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fsetalw%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/setalw</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for/mutable-set))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fmutable-set%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/mutable-set</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for/mutable-seteq))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fmutable-seteq%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/mutable-seteq</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for/mutable-seteqv))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fmutable-seteqv%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/mutable-seteqv</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for/mutable-setalw))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fmutable-setalw%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/mutable-setalw</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for*/mutable-set))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fmutable-set%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/mutable-set</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for*/mutable-seteq))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fmutable-seteq%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/mutable-seteq</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for*/mutable-seteqv))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fmutable-seteqv%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/mutable-seteqv</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for*/mutable-setalw))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fmutable-setalw%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/mutable-setalw</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for/weak-set))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fweak-set%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/weak-set</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for/weak-seteq))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fweak-seteq%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/weak-seteq</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for/weak-seteqv))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fweak-seteqv%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/weak-seteqv</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for/weak-setalw))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fweak-setalw%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/weak-setalw</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for*/weak-set))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fweak-set%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/weak-set</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for*/weak-seteq))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fweak-seteq%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/weak-seteq</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for*/weak-seteqv))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fweak-seteqv%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/weak-seteqv</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._for*/weak-setalw))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2A%2Fweak-setalw%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/weak-setalw</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Analogous to <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span> and <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for*/list</a></span>, but to
+construct a <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a> instead of a list.</div></p><p class="SHistory">Changed in version 8.5.0.3 of package <span class="stt">base</span>: Added <span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fsetalw%29%29" class="RktStxLink" data-pltdoc="x">for/setalw</a></span>,
+<span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fmutable-setalw%29%29" class="RktStxLink" data-pltdoc="x">for/mutable-setalw</a></span>, and <span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._for%2Fweak-setalw%29%29" class="RktStxLink" data-pltdoc="x">for/weak-setalw</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._in-immutable-set))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._in-immutable-set%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-immutable-set</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._in-mutable-set))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._in-mutable-set%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-mutable-set</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-mutable~3f%29%29" class="RktValLink" data-pltdoc="x">set-mutable?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._in-weak-set))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._in-weak-set%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-weak-set</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-weak~3f%29%29" class="RktValLink" data-pltdoc="x">set-weak?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Explicitly converts a specific kind of <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a> to a sequence for
+use with <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> forms.</div></p><p>As with <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-list%29%29" class="RktValLink" data-pltdoc="x">in-list</a></span> and some other sequence constructors,
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._in-immutable-set%29%29" class="RktValLink" data-pltdoc="x">in-immutable-set</a></span> performs better when it appears directly in a
+<span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> clause.</p><p>These sequence constructors are compatible with
+<a href="sets.html#%28part._.Custom_.Hash_.Sets%29" data-pltdoc="x">Custom Hash Sets</a>.</p><p class="SHistory">Added in version 6.4.0.7 of package <span class="stt">base</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Set_Predicates_and_Contracts&quot;">4.18.2<tt>&nbsp;</tt><a name="(part._.Set_.Predicates_and_.Contracts)"></a>Set Predicates and Contracts</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._generic-set~3f))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">generic-set?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="sets.html#%28tech._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">set</span></a>; returns <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._mutable-seteq%29%29" class="RktValLink" data-pltdoc="x">mutable-seteq</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-implements~3f))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-implements~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-implements?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">st</span> implements all of the methods from
+<span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._gen~3aset%29%29" class="RktStxLink" data-pltdoc="x">gen:set</a></span> named by the <span class="RktVar">sym</span>s; returns <span class="RktVal">#f</span> otherwise.
+Fallback implementations do not affect the result; <span class="RktVar">st</span> may support the
+given methods via fallback implementations yet produce <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-implements~3f%29%29" class="RktValLink" data-pltdoc="x">set-implements?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">set-add</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-implements~3f%29%29" class="RktValLink" data-pltdoc="x">set-implements?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">set-add!</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-implements~3f%29%29" class="RktValLink" data-pltdoc="x">set-implements?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">set-add</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-implements~3f%29%29" class="RktValLink" data-pltdoc="x">set-implements?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">set-add!</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-implements~3f%29%29" class="RktValLink" data-pltdoc="x">set-implements?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._mutable-seteq%29%29" class="RktValLink" data-pltdoc="x">mutable-seteq</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">set-add</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-implements~3f%29%29" class="RktValLink" data-pltdoc="x">set-implements?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._mutable-seteq%29%29" class="RktValLink" data-pltdoc="x">mutable-seteq</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">set-add!</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-implements~3f%29%29" class="RktValLink" data-pltdoc="x">set-implements?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._weak-seteqv%29%29" class="RktValLink" data-pltdoc="x">weak-seteqv</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">set-remove</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">set-remove!</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-implements/c))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-implements%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-implements/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Recognizes sets that support all of the methods from <span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._gen~3aset%29%29" class="RktStxLink" data-pltdoc="x">gen:set</a></span>
+named by the <span class="RktVar">sym</span>s.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set/c))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">set/c</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">elem/c</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:cmp</span><span class="hspace">&nbsp;</span><span class="RktVar">cmp</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:kind</span><span class="hspace">&nbsp;</span><span class="RktVar">kind</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:lazy?</span><span class="hspace">&nbsp;</span><span class="RktVar">lazy?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:equal-key/c</span><span class="hspace">&nbsp;</span><span class="RktVar">equal-key/c</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">elem/c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._chaperone-contract~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-contract?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">cmp</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dont-care</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">equal</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">equal-always</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">eqv</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">eq</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">dont-care</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">kind</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">dont-care</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">immutable</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">mutable</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">weak</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">mutable-or-weak</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">immutable</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">lazy?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">kind</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">immutable</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._flat-contract~3f%29%29" class="RktValLink" data-pltdoc="x">flat-contract?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">elem/c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">equal-key/c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Constructs a contract that recognizes sets whose elements match
+ <span class="RktVar">elem/c</span>.</div></p><p>If <span class="RktVar">kind</span> is <span class="RktVal">'</span><span class="RktVal">immutable</span>, <span class="RktVal">'</span><span class="RktVal">mutable</span>, or
+ <span class="RktVal">'</span><span class="RktVal">weak</span>, the resulting contract accepts only <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash sets</span></a> that
+ are respectively immutable, mutable with strongly-held keys, or mutable with
+ weakly-held keys.  If <span class="RktVar">kind</span> is <span class="RktVal">'</span><span class="RktVal">mutable-or-weak</span>, the
+ resulting contract accepts any mutable <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash sets</span></a>, regardless of
+ key-holding strength.</p><p>If <span class="RktVar">cmp</span> is <span class="RktVal">'</span><span class="RktVal">equal</span>, <span class="RktVal">'</span><span class="RktVal">equal-always</span>, <span class="RktVal">'</span><span class="RktVal">eqv</span>,
+ or <span class="RktVal">'</span><span class="RktVal">eq</span>, the resulting contract accepts only <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash sets</span></a> that
+ compare elements using <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>,
+ <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>, respectively.</p><p>If <span class="RktVar">cmp</span> is <span class="RktVal">'</span><span class="RktVal">eqv</span> or <span class="RktVal">'</span><span class="RktVal">eq</span>, then <span class="RktVar">elem/c</span> must
+ be a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a>.</p><p>If <span class="RktVar">cmp</span> and <span class="RktVar">kind</span> are both <span class="RktVal">'</span><span class="RktVal">dont-care</span>, then the
+ resulting contract will accept any kind of set, not just <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash
+sets</span></a>.</p><p>If <span class="RktVar">lazy?</span> is not <span class="RktVal">#f</span>, then the elements of the set are not checked
+immediately by the contract and only the set itself is checked (according to the
+<span class="RktVar">cmp</span> and <span class="RktVar">kind</span> arguments). If <span class="RktVar">lazy?</span> is
+<span class="RktVal">#f</span>, then the elements are checked immediately by the contract.
+The <span class="RktVar">lazy?</span> argument is ignored when the set contract accepts generic sets
+(i.e., when <span class="RktVar">cmp</span> and <span class="RktVar">kind</span> are both <span class="RktVal">'</span><span class="RktVal">dont-care</span>); in that
+case, the value being checked in that case is a <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span>, then the contract
+is not lazy otherwise the contract is lazy.</p><p>If <span class="RktVar">kind</span> allows mutable sets (i.e., is <span class="RktVal">'</span><span class="RktVal">dont-care</span>,
+<span class="RktVal">'</span><span class="RktVal">mutable</span>, <span class="RktVal">'</span><span class="RktVal">weak</span>, or
+<span class="RktVal">'</span><span class="RktVal">mutable-or-weak</span>) and <span class="RktVar">lazy?</span> is <span class="RktVal">#f</span>, then the elements
+are checked both immediately and when they are accessed from the set.</p><p>The <span class="RktVar">equal-key/c</span> contract is used when values are passed to the comparison
+and hashing functions used internally.</p><p>The result contract will be a <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contract</span></a> when <span class="RktVar">elem/c</span>
+and <span class="RktVar">equal-key/c</span> are both <a href="contracts.html#%28tech._flat._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">flat contracts</span></a>,
+<span class="RktVar">lazy?</span> is <span class="RktVal">#f</span>, and <span class="RktVar">kind</span> is <span class="RktVal">'</span><span class="RktVal">immutable</span>.
+The result will be a <a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contract</span></a> when <span class="RktVar">elem/c</span> is a
+<a href="contracts.html#%28tech._chaperone._contract%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone contract</span></a>.</p><p class="SHistory">Changed in version 8.3.0.9 of package <span class="stt">base</span>: Added support for random generation.<br/>Changed in version 8.5.0.3: Added <span class="RktVal">'</span><span class="RktVal">equal-always</span> support for <span class="RktVar">cmp</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Generic_Set_Interface&quot;">4.18.3<tt>&nbsp;</tt><a name="(part._.Generic_.Set_.Interface)"></a>Generic Set Interface</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/set..rkt)._gen~3aset))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._gen~3aset%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">gen:set</a></span></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="struct-generics.html#%28tech._generic._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">generic interface</span></a> (see <a href="struct-generics.html" data-pltdoc="x">Generic Interfaces</a>) that
+supplies set method implementations for a structure type via the
+<span class="RktPn">#:methods</span> option of <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> definitions.  This interface can
+be used to implement any of the methods documented as
+<a href="sets.html#%28part._set-methods%29" data-pltdoc="x">Set Methods</a>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">binary-set</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">integer</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._gen~3aset%29%29" class="RktStxLink" data-pltdoc="x">gen:set</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-member~3f%29%29" class="RktValLink" data-pltdoc="x">set-member?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">st</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-bit-set~3f%29%29" class="RktValLink" data-pltdoc="x">bitwise-bit-set?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">binary-set-integer</span><span class="hspace">&nbsp;</span><span class="RktSym">st</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-add%29%29" class="RktValLink" data-pltdoc="x">set-add</a></span><span class="hspace">&nbsp;</span><span class="RktSym">st</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">binary-set</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-ior%29%29" class="RktValLink" data-pltdoc="x">bitwise-ior</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">binary-set-integer</span><span class="hspace">&nbsp;</span><span class="RktSym">st</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._arithmetic-shift%29%29" class="RktValLink" data-pltdoc="x">arithmetic-shift</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%29%29" class="RktValLink" data-pltdoc="x">set-remove</a></span><span class="hspace">&nbsp;</span><span class="RktSym">st</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">binary-set</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-and%29%29" class="RktValLink" data-pltdoc="x">bitwise-and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">binary-set-integer</span><span class="hspace">&nbsp;</span><span class="RktSym">st</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._bitwise-not%29%29" class="RktValLink" data-pltdoc="x">bitwise-not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._arithmetic-shift%29%29" class="RktValLink" data-pltdoc="x">arithmetic-shift</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bset</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">binary-set</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">bset</span></td></tr><tr><td><p><span class="RktRes">(binary-set 5)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bset</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-member~3f%29%29" class="RktValLink" data-pltdoc="x">set-member?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bset</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-member~3f%29%29" class="RktValLink" data-pltdoc="x">set-member?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bset</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-member~3f%29%29" class="RktValLink" data-pltdoc="x">set-member?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bset</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-add%29%29" class="RktValLink" data-pltdoc="x">set-add</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bset</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(binary-set 21)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%29%29" class="RktValLink" data-pltdoc="x">set-remove</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bset</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(binary-set 1)</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;set-methods&quot;">4.18.3.1<tt>&nbsp;</tt><a name="(part._set-methods)"></a>Set Methods</h5><p>The methods of <span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._gen~3aset%29%29" class="RktStxLink" data-pltdoc="x">gen:set</a></span> can be classified into three categories, as determined by their fallback implementations:</p><ol><li><p>methods with no fallbacks,</p></li><li><p>methods whose fallbacks depend on other, non-fallback methods,</p></li><li><p>and methods whose fallbacks can depend on either fallback or non-fallback methods.</p></li></ol><p>As an example, implementing the following methods would guarantee that all the methods in <span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._gen~3aset%29%29" class="RktStxLink" data-pltdoc="x">gen:set</a></span> would at least have a fallback method:</p><ul><li><p><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-member~3f%29%29" class="RktValLink" data-pltdoc="x">set-member?</a></span></p></li><li><p><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-add%29%29" class="RktValLink" data-pltdoc="x">set-add</a></span></p></li><li><p><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-add%21%29%29" class="RktValLink" data-pltdoc="x">set-add!</a></span></p></li><li><p><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%29%29" class="RktValLink" data-pltdoc="x">set-remove</a></span></p></li><li><p><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%21%29%29" class="RktValLink" data-pltdoc="x">set-remove!</a></span></p></li><li><p><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-first%29%29" class="RktValLink" data-pltdoc="x">set-first</a></span></p></li><li><p><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-empty~3f%29%29" class="RktValLink" data-pltdoc="x">set-empty?</a></span></p></li><li><p><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-copy-clear%29%29" class="RktValLink" data-pltdoc="x">set-copy-clear</a></span></p></li></ul><p>There may be other such subsets of methods that would guarantee at least a fallback for every method.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-member~3f))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-member~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-member?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is in <span class="RktVar">st</span>, <span class="RktVal">#f</span>
+otherwise. Has no fallback.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-add))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-add%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-add</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a set that includes <span class="RktVar">v</span> plus all elements of
+<span class="RktVar">st</span>. This operation runs in constant time for <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash sets</span></a>. Has no fallback.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-add!))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-add%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-add!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Adds the element <span class="RktVar">v</span> to <span class="RktVar">st</span>.  This operation runs in constant
+time for <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash sets</span></a>. Has no fallback.</div></p><p>For <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash sets</span></a>, see also the <a href="hashtables.html#%28elem._%28caveat._concurrency%29%29" data-pltdoc="x">caveats concerning concurrent modification</a>
+for hash tables, which applies to
+hash sets.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-remove))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-remove</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a set that includes all elements of <span class="RktVar">st</span> except
+<span class="RktVar">v</span>. This operation runs in constant time for <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash sets</span></a>. Has no fallback.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-remove!))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-remove!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Removes the element <span class="RktVar">v</span> from <span class="RktVar">st</span>.  This operation runs in constant
+time for <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash sets</span></a>. Has no fallback.</div></p><p>For <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash sets</span></a>, see also the <a href="hashtables.html#%28elem._%28caveat._concurrency%29%29" data-pltdoc="x">caveats concerning concurrent modification</a>
+for hash tables, which applies to
+hash sets.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-empty~3f))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-empty~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-empty?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">st</span> has no members; returns <span class="RktVal">#f</span>
+otherwise.</div></p><p>Supported for any <span class="RktVar">st</span> that <a href="struct-generics.html#%28tech._implemented._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">implements</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValLink" data-pltdoc="x">set-&gt;stream</a></span> or
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-count%29%29" class="RktValLink" data-pltdoc="x">set-count</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-count))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-count%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-count</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the number of elements in <span class="RktVar">st</span>.</div></p><p>Supported for any <span class="RktVar">st</span> that <a href="struct-generics.html#%28tech._supported._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">supports</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValLink" data-pltdoc="x">set-&gt;stream</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-first))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-first%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-first</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-empty~3f%29%29" class="RktValLink" data-pltdoc="x">set-empty?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces an unspecified element of <span class="RktVar">st</span>. Multiple uses of
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-first%29%29" class="RktValLink" data-pltdoc="x">set-first</a></span> on <span class="RktVar">st</span> produce the same result.</div></p><p>Supported for any <span class="RktVar">st</span> that <a href="struct-generics.html#%28tech._implemented._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">implements</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValLink" data-pltdoc="x">set-&gt;stream</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-rest))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-rest%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-rest</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-empty~3f%29%29" class="RktValLink" data-pltdoc="x">set-empty?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a set that includes all elements of <span class="RktVar">st</span> except
+<span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-first%29%29" class="RktValLink" data-pltdoc="x">set-first</a></span><span class="stt"> </span><span class="RktVar">st</span><span class="RktPn">)</span>.</div></p><p>Supported for any <span class="RktVar">st</span> that <a href="struct-generics.html#%28tech._implemented._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">implements</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%29%29" class="RktValLink" data-pltdoc="x">set-remove</a></span> and either
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-first%29%29" class="RktValLink" data-pltdoc="x">set-first</a></span> or <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValLink" data-pltdoc="x">set-&gt;stream</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-~3estream))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-&gt;stream</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a stream containing the elements of <span class="RktVar">st</span>.</div></p><p><div class="SIntrapara">Supported for any <span class="RktVar">st</span> that <a href="struct-generics.html#%28tech._implemented._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">implements</span></a>:
+</div><div class="SIntrapara"><ul><li><p><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3elist%29%29" class="RktValLink" data-pltdoc="x">set-&gt;list</a></span></p></li><li><p><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._in-set%29%29" class="RktValLink" data-pltdoc="x">in-set</a></span></p></li><li><p><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-empty~3f%29%29" class="RktValLink" data-pltdoc="x">set-empty?</a></span>, <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-first%29%29" class="RktValLink" data-pltdoc="x">set-first</a></span>, <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-rest%29%29" class="RktValLink" data-pltdoc="x">set-rest</a></span></p></li><li><p><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-empty~3f%29%29" class="RktValLink" data-pltdoc="x">set-empty?</a></span>, <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-first%29%29" class="RktValLink" data-pltdoc="x">set-first</a></span>, <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%29%29" class="RktValLink" data-pltdoc="x">set-remove</a></span></p></li><li><p><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-count%29%29" class="RktValLink" data-pltdoc="x">set-count</a></span>, <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-first%29%29" class="RktValLink" data-pltdoc="x">set-first</a></span>, <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-rest%29%29" class="RktValLink" data-pltdoc="x">set-rest</a></span></p></li><li><p><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-count%29%29" class="RktValLink" data-pltdoc="x">set-count</a></span>, <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-first%29%29" class="RktValLink" data-pltdoc="x">set-first</a></span>, <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%29%29" class="RktValLink" data-pltdoc="x">set-remove</a></span></p></li></ul></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-copy))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-copy%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-copy</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a new, mutable set of the same type and with the same elements as
+<span class="RktVar">st</span>.</div></p><p>Supported for any <span class="RktVar">st</span> that <a href="struct-generics.html#%28tech._supported._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">supports</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValLink" data-pltdoc="x">set-&gt;stream</a></span> and
+<a href="struct-generics.html#%28tech._implemented._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">implements</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-copy-clear%29%29" class="RktValLink" data-pltdoc="x">set-copy-clear</a></span> and <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-add%21%29%29" class="RktValLink" data-pltdoc="x">set-add!</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-copy-clear))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-copy-clear%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-copy-clear</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-empty~3f%29%29" class="RktValLink" data-pltdoc="x">set-empty?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a new, empty set of the same type, mutability, and key strength as
+<span class="RktVar">st</span>.</div></p><p>A difference between <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-copy-clear%29%29" class="RktValLink" data-pltdoc="x">set-copy-clear</a></span> and <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-clear%29%29" class="RktValLink" data-pltdoc="x">set-clear</a></span> is
+that the latter conceptually iterates <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%29%29" class="RktValLink" data-pltdoc="x">set-remove</a></span> on the given
+set, and so it preserves any contract on the given set. The
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-copy-clear%29%29" class="RktValLink" data-pltdoc="x">set-copy-clear</a></span> function produces a new set without any
+contracts.</p><p>The <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-copy-clear%29%29" class="RktValLink" data-pltdoc="x">set-copy-clear</a></span> function must call concrete set constructors
+and thus has no generic fallback.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-clear))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-clear%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-clear</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-empty~3f%29%29" class="RktValLink" data-pltdoc="x">set-empty?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a set like <span class="RktVar">st</span> but with all elements removed.</div></p><p>Supported for any <span class="RktVar">st</span> that <a href="struct-generics.html#%28tech._implemented._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">implements</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%29%29" class="RktValLink" data-pltdoc="x">set-remove</a></span> and <a href="struct-generics.html#%28tech._supported._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">supports</span></a>
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValLink" data-pltdoc="x">set-&gt;stream</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-clear!))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-clear%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-clear!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Removes all elements from <span class="RktVar">st</span>.</div></p><p>Supported for any <span class="RktVar">st</span> that <a href="struct-generics.html#%28tech._implemented._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">implements</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%21%29%29" class="RktValLink" data-pltdoc="x">set-remove!</a></span> and either
+<a href="struct-generics.html#%28tech._supported._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">supports</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValLink" data-pltdoc="x">set-&gt;stream</a></span> or <a href="struct-generics.html#%28tech._implemented._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">implements</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-first%29%29" class="RktValLink" data-pltdoc="x">set-first</a></span> and either <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-count%29%29" class="RktValLink" data-pltdoc="x">set-count</a></span> or <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-empty~3f%29%29" class="RktValLink" data-pltdoc="x">set-empty?</a></span>.</p><p>For <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash sets</span></a>, see also the <a href="hashtables.html#%28elem._%28caveat._concurrency%29%29" data-pltdoc="x">caveats concerning concurrent modification</a>
+for hash tables, which applies to
+hash sets.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-union))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-union%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-union</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st0</span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st0</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a set of the same type as <span class="RktVar">st0</span> that includes the elements from
+<span class="RktVar">st0</span> and all of the <span class="RktVar">st</span>s.</div></p><p>If <span class="RktVar">st0</span> is a list, each <span class="RktVar">st</span> must also be a list.  This
+operation runs on lists in time proportional to the total size of the
+<span class="RktVar">st</span>s times the size of the result.</p><p>If <span class="RktVar">st0</span> is a <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a>, each <span class="RktVar">st</span> must also be a
+<a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a> that uses the same comparison function (<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>,
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>).
+The mutability and key strength of the hash
+sets may differ.  This operation runs on hash sets in time proportional to the
+total size of all of the sets except the largest immutable set.</p><p>At least one set must be provided to <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-union%29%29" class="RktValLink" data-pltdoc="x">set-union</a></span> to determine the type
+of the resulting set (list, hash set, etc.).  If there is a case where
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-union%29%29" class="RktValLink" data-pltdoc="x">set-union</a></span> may be applied to zero arguments, instead pass an empty set
+of the intended type as the first argument.</p><p>Supported for any <span class="RktVar">st</span> that <a href="struct-generics.html#%28tech._implemented._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">implements</span></a>  <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-add%29%29" class="RktValLink" data-pltdoc="x">set-add</a></span> and <a href="struct-generics.html#%28tech._supported._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">supports</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValLink" data-pltdoc="x">set-&gt;stream</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-union%29%29" class="RktValLink" data-pltdoc="x">set-union</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(set)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-union%29%29" class="RktValLink" data-pltdoc="x">set-union</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._seteq%29%29" class="RktValLink" data-pltdoc="x">seteq</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(seteq)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-union%29%29" class="RktValLink" data-pltdoc="x">set-union</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(set 1 2 3)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-union%29%29" class="RktValLink" data-pltdoc="x">set-union</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(3 1 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-union%29%29" class="RktValLink" data-pltdoc="x">set-union</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._seteq%29%29" class="RktValLink" data-pltdoc="x">seteq</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">set-union: set arguments have incompatible equivalence</span></p></td></tr><tr><td><p><span class="RktErr">predicates</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">first set: (set 1 2)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">incompatible set: (seteq 2 3)</span></p></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Sets of different types cannot be unioned</span></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-union!))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-union%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-union!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st0</span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st0</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Adds the elements from all of the <span class="RktVar">st</span>s to <span class="RktVar">st0</span>.</div></p><p>If <span class="RktVar">st0</span> is a <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a>, each <span class="RktVar">st</span> must also be a
+<a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a> that uses the same comparison function (<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>,
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>).
+The mutability and key strength of the hash
+sets may differ.  This operation runs on hash sets in time proportional to the
+total size of the <span class="RktVar">st</span>s.</p><p>Supported for any <span class="RktVar">st</span> that <a href="struct-generics.html#%28tech._implemented._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">implements</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-add%21%29%29" class="RktValLink" data-pltdoc="x">set-add!</a></span> and <a href="struct-generics.html#%28tech._supported._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">supports</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValLink" data-pltdoc="x">set-&gt;stream</a></span>.</p><p>For <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash sets</span></a>, see also the <a href="hashtables.html#%28elem._%28caveat._concurrency%29%29" data-pltdoc="x">caveats concerning concurrent modification</a>
+for hash tables, which applies to
+hash sets.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-intersect))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-intersect%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-intersect</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st0</span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st0</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a set of the same type as <span class="RktVar">st0</span> that includes the elements from
+<span class="RktVar">st0</span> that are also contained by all of the <span class="RktVar">st</span>s.</div></p><p>If <span class="RktVar">st0</span> is a list, each <span class="RktVar">st</span> must also be a list.  This
+operation runs on lists in time proportional to the total size of the
+<span class="RktVar">st</span>s times the size of <span class="RktVar">st0</span>.</p><p>If <span class="RktVar">st0</span> is a <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a>, each <span class="RktVar">st</span> must also be a
+<a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a> that uses the same comparison function (<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>,
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>).
+The mutability and key strength of the hash
+sets may differ.  This operation runs on hash sets in time proportional to the
+size of the smallest immutable set.</p><p>Supported for any <span class="RktVar">st</span> that <a href="struct-generics.html#%28tech._implemented._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">implements</span></a> either <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%29%29" class="RktValLink" data-pltdoc="x">set-remove</a></span> or
+both <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-clear%29%29" class="RktValLink" data-pltdoc="x">set-clear</a></span> and <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-add%29%29" class="RktValLink" data-pltdoc="x">set-add</a></span>, and <a href="struct-generics.html#%28tech._supported._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">supports</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValLink" data-pltdoc="x">set-&gt;stream</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-intersect!))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-intersect%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-intersect!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st0</span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st0</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Removes every element from <span class="RktVar">st0</span> that is not contained by all of the
+<span class="RktVar">st</span>s.</div></p><p>If <span class="RktVar">st0</span> is a <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a>, each <span class="RktVar">st</span> must also be a
+<a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a> that uses the same comparison function (<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>,
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>).
+The mutability and key strength of the hash
+sets may differ.  This operation runs on hash sets in time proportional to the
+size of <span class="RktVar">st0</span>.</p><p>Supported for any <span class="RktVar">st</span> that <a href="struct-generics.html#%28tech._implemented._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">implements</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%21%29%29" class="RktValLink" data-pltdoc="x">set-remove!</a></span> and <a href="struct-generics.html#%28tech._supported._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">supports</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValLink" data-pltdoc="x">set-&gt;stream</a></span>.</p><p>For <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash sets</span></a>, see also the <a href="hashtables.html#%28elem._%28caveat._concurrency%29%29" data-pltdoc="x">caveats concerning concurrent modification</a>
+for hash tables, which applies to
+hash sets.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-subtract))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-subtract%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-subtract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st0</span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st0</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a set of the same type as <span class="RktVar">st0</span> that includes the elements from
+<span class="RktVar">st0</span> that are not contained by any of the <span class="RktVar">st</span>s.</div></p><p>If <span class="RktVar">st0</span> is a list, each <span class="RktVar">st</span> must also be a list.  This
+operation runs on lists in time proportional to the total size of the
+<span class="RktVar">st</span>s times the size of <span class="RktVar">st0</span>.</p><p>If <span class="RktVar">st0</span> is a <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a>, each <span class="RktVar">st</span> must also be a
+<a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a> that uses the same comparison function (<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>,
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>).
+The mutability and key strength of the hash
+sets may differ.  This operation runs on hash sets in time proportional to the
+size of <span class="RktVar">st0</span>.</p><p>Supported for any <span class="RktVar">st</span> that <a href="struct-generics.html#%28tech._implemented._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">implements</span></a> either <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%29%29" class="RktValLink" data-pltdoc="x">set-remove</a></span> or
+both <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-clear%29%29" class="RktValLink" data-pltdoc="x">set-clear</a></span> and <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-add%29%29" class="RktValLink" data-pltdoc="x">set-add</a></span>, and <a href="struct-generics.html#%28tech._supported._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">supports</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValLink" data-pltdoc="x">set-&gt;stream</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-subtract!))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-subtract%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-subtract!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st0</span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st0</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Removes every element from <span class="RktVar">st0</span> that is contained by any of the
+<span class="RktVar">st</span>s.</div></p><p>If <span class="RktVar">st0</span> is a <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a>, each <span class="RktVar">st</span> must also be a
+<a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a> that uses the same comparison function (<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>,
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>).
+The mutability and key strength of the hash
+sets may differ.  This operation runs on hash sets in time proportional to the
+size of <span class="RktVar">st0</span>.</p><p>Supported for any <span class="RktVar">st</span> that <a href="struct-generics.html#%28tech._implemented._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">implements</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%21%29%29" class="RktValLink" data-pltdoc="x">set-remove!</a></span> and <a href="struct-generics.html#%28tech._supported._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">supports</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValLink" data-pltdoc="x">set-&gt;stream</a></span>.</p><p>For <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash sets</span></a>, see also the <a href="hashtables.html#%28elem._%28caveat._concurrency%29%29" data-pltdoc="x">caveats concerning concurrent modification</a>
+for hash tables, which applies to
+hash sets.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-symmetric-difference))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-symmetric-difference%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-symmetric-difference</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st0</span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st0</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a set of the same type as <span class="RktVar">st0</span> that includes all of the
+elements contained an odd number of times in <span class="RktVar">st0</span> and the
+<span class="RktVar">st</span>s.</div></p><p>If <span class="RktVar">st0</span> is a list, each <span class="RktVar">st</span> must also be a list.  This
+operation runs on lists in time proportional to the total size of the
+<span class="RktVar">st</span>s times the size of <span class="RktVar">st0</span>.</p><p>If <span class="RktVar">st0</span> is a <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a>, each <span class="RktVar">st</span> must also be a
+<a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a> that uses the same comparison function (<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>,
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>).
+The mutability and key strength of the hash
+sets may differ.  This operation runs on hash sets in time proportional to the
+total size of all of the sets except the largest immutable set.</p><p>Supported for any <span class="RktVar">st</span> that <a href="struct-generics.html#%28tech._implemented._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">implements</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%29%29" class="RktValLink" data-pltdoc="x">set-remove</a></span> or both <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-clear%29%29" class="RktValLink" data-pltdoc="x">set-clear</a></span> and <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-add%29%29" class="RktValLink" data-pltdoc="x">set-add</a></span>, and <a href="struct-generics.html#%28tech._supported._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">supports</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValLink" data-pltdoc="x">set-&gt;stream</a></span>.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-symmetric-difference%29%29" class="RktValLink" data-pltdoc="x">set-symmetric-difference</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(set 1 3)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-symmetric-difference!))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-symmetric-difference%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-symmetric-difference!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st0</span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st0</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Adds and removes elements of <span class="RktVar">st0</span> so that it includes all of the
+elements contained an odd number of times in the <span class="RktVar">st</span>s and the
+original contents of <span class="RktVar">st0</span>.</div></p><p>If <span class="RktVar">st0</span> is a <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a>, each <span class="RktVar">st</span> must also be a
+<a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a> that uses the same comparison function (<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>,
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>).
+The mutability and key strength of the hash
+sets may differ.  This operation runs on hash sets in time proportional to the
+total size of the <span class="RktVar">st</span>s.</p><p>Supported for any <span class="RktVar">st</span> that <a href="struct-generics.html#%28tech._implemented._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">implements</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%21%29%29" class="RktValLink" data-pltdoc="x">set-remove!</a></span> and <a href="struct-generics.html#%28tech._supported._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">supports</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValLink" data-pltdoc="x">set-&gt;stream</a></span>.</p><p>For <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash sets</span></a>, see also the <a href="hashtables.html#%28elem._%28caveat._concurrency%29%29" data-pltdoc="x">caveats concerning concurrent modification</a>
+for hash tables, which applies to
+hash sets.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set~3d~3f))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">set=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span><span class="RktVar">st2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">st</span> and <span class="RktVar">st2</span> contain the same
+members; returns <span class="RktVal">#f</span> otherwise.</div></p><p>If <span class="RktSym">st0</span> is a list, each <span class="RktVar">st</span> must also be a list.  This
+operation runs on lists in time proportional to the size of <span class="RktVar">st</span> times
+the size of <span class="RktVar">st2</span>.</p><p>If <span class="RktSym">st0</span> is a <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a>, each <span class="RktVar">st</span> must also be a
+<a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a> that uses the same comparison function (<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>,
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>).
+The mutability and key strength of the hash
+sets may differ.  This operation runs on hash sets in time proportional to the
+size of <span class="RktVar">st</span> plus the size of <span class="RktVar">st2</span>.</p><p>Supported for any <span class="RktVar">st</span> and <span class="RktVar">st2</span> that both <a href="struct-generics.html#%28tech._supported._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">support</span></a>
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._subset~3f%29%29" class="RktValLink" data-pltdoc="x">subset?</a></span>; also supported for any if <span class="RktVar">st2</span> that <a href="struct-generics.html#%28tech._implemented._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">implements</span></a>
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3d~3f%29%29" class="RktValLink" data-pltdoc="x">set=?</a></span> regardless of <span class="RktVar">st</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3d~3f%29%29" class="RktValLink" data-pltdoc="x">set=?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3d~3f%29%29" class="RktValLink" data-pltdoc="x">set=?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3d~3f%29%29" class="RktValLink" data-pltdoc="x">set=?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3d~3f%29%29" class="RktValLink" data-pltdoc="x">set=?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3d~3f%29%29" class="RktValLink" data-pltdoc="x">set=?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._seteq%29%29" class="RktValLink" data-pltdoc="x">seteq</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._mutable-seteq%29%29" class="RktValLink" data-pltdoc="x">mutable-seteq</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3d~3f%29%29" class="RktValLink" data-pltdoc="x">set=?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._seteq%29%29" class="RktValLink" data-pltdoc="x">seteq</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._seteqv%29%29" class="RktValLink" data-pltdoc="x">seteqv</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">set=?: set arguments have incompatible equivalence</span></p></td></tr><tr><td><p><span class="RktErr">predicates</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">first set: (seteq 1 2)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">incompatible set: (seteqv 1 2)</span></p></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Sets of different types cannot be compared</span></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._subset~3f))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._subset~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">subset?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span><span class="RktVar">st2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"><a name="(idx._(gentag._191._(lib._scribblings/reference/reference..scrbl)))"></a>Returns <span class="RktVal">#t</span> if <span class="RktVar">st2</span> contains every member of <span class="RktVar">st</span>;
+returns <span class="RktVal">#f</span> otherwise.</div></p><p>If <span class="RktVar">st</span> is a list, then <span class="RktVar">st2</span> must also be a list.  This
+operation runs on lists in time proportional to the size of <span class="RktVar">st</span> times
+the size of <span class="RktVar">st2</span>.</p><p>If <span class="RktVar">st</span> is a <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a>, then <span class="RktVar">st2</span> must also be a
+<a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a> that uses the same comparison function (<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>,
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>).
+The mutability and key strength of the hash
+sets may differ.  This operation runs on hash sets in time proportional to the
+size of <span class="RktVar">st</span>.</p><p>Supported for any <span class="RktVar">st</span> that <a href="struct-generics.html#%28tech._supported._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">supports</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValLink" data-pltdoc="x">set-&gt;stream</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._subset~3f%29%29" class="RktValLink" data-pltdoc="x">subset?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._subset~3f%29%29" class="RktValLink" data-pltdoc="x">subset?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._subset~3f%29%29" class="RktValLink" data-pltdoc="x">subset?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._proper-subset~3f))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._proper-subset~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">proper-subset?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span><span class="RktVar">st2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">st2</span> contains every member of <span class="RktVar">st</span> and at
+least one additional element; returns <span class="RktVal">#f</span> otherwise.</div></p><p>If <span class="RktVar">st</span> is a list, then <span class="RktVar">st2</span> must also be a list.  This
+operation runs on lists in time proportional to the size of <span class="RktVar">st</span> times
+the size of <span class="RktVar">st2</span>.</p><p>If <span class="RktVar">st</span> is a <a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a>, then <span class="RktVar">st2</span> must also be a
+<a href="sets.html#%28tech._hash._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash set</span></a> that uses the same comparison function (<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>,
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal-always~3f%29%29" class="RktValLink" data-pltdoc="x">equal-always?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>).
+The mutability and key strength of the hash
+sets may differ.  This operation runs on hash sets in time proportional to the
+size of <span class="RktVar">st</span> plus the size of <span class="RktVar">st2</span>.</p><p>Supported for any <span class="RktVar">st</span> and <span class="RktVar">st2</span> that both <a href="struct-generics.html#%28tech._supported._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">support</span></a>
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._subset~3f%29%29" class="RktValLink" data-pltdoc="x">subset?</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._proper-subset~3f%29%29" class="RktValLink" data-pltdoc="x">proper-subset?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._proper-subset~3f%29%29" class="RktValLink" data-pltdoc="x">proper-subset?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._proper-subset~3f%29%29" class="RktValLink" data-pltdoc="x">proper-subset?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set%29%29" class="RktValLink" data-pltdoc="x">set</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-~3elist))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3elist%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-&gt;list</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a list containing the elements of <span class="RktVar">st</span>.</div></p><p>Supported for any <span class="RktVar">st</span> that <a href="struct-generics.html#%28tech._supported._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">supports</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValLink" data-pltdoc="x">set-&gt;stream</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-map))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-map%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-map</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Applies the procedure <span class="RktVar">proc</span> to each element in
+<span class="RktVar">st</span> in an unspecified order, accumulating the results
+into a list.</div></p><p>Supported for any <span class="RktVar">st</span> that <a href="struct-generics.html#%28tech._supported._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">supports</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValLink" data-pltdoc="x">set-&gt;stream</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._set-for-each))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-for-each%29%29" class="RktValDef RktValLink" data-pltdoc="x">set-for-each</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Applies <span class="RktVar">proc</span> to each element in <span class="RktVar">st</span> (for the
+side-effects of <span class="RktVar">proc</span>) in an unspecified order.</div></p><p>Supported for any <span class="RktVar">st</span> that <a href="struct-generics.html#%28tech._supported._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">supports</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValLink" data-pltdoc="x">set-&gt;stream</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._in-set))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._in-set%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-set</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">st</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Explicitly converts a set to a sequence for use with <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> and
+other forms.</div></p><p>Supported for any <span class="RktVar">st</span> that <a href="struct-generics.html#%28tech._supported._generic._method%29" class="techoutside" data-pltdoc="x"><span class="techinside">supports</span></a> <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-~3estream%29%29" class="RktValLink" data-pltdoc="x">set-&gt;stream</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._impersonate-hash-set))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._impersonate-hash-set%29%29" class="RktValDef RktValLink" data-pltdoc="x">impersonate-hash-set</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">st</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">inject-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">add-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">shrink-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">extract-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">clear-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">equal-key-proc</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-mutable~3f%29%29" class="RktValLink" data-pltdoc="x">set-mutable?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-weak~3f%29%29" class="RktValLink" data-pltdoc="x">set-weak?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-mutable~3f%29%29" class="RktValLink" data-pltdoc="x">set-mutable?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-weak~3f%29%29" class="RktValLink" data-pltdoc="x">set-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">inject-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">add-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">shrink-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">extract-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">clear-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">equal-key-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Impersonates <span class="RktVar">st</span>, redirecting various set operations via the given procedures.</div></p><p>The <span class="RktVar">inject-proc</span> procedure
+is called whenever an element is temporarily put into the set for the purposes
+of comparing it with other elements that may already be in the set. For example,
+when evaluating <span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-member~3f%29%29" class="RktValLink" data-pltdoc="x">set-member?</a></span><span class="stt"> </span><span class="RktSym">s</span><span class="stt"> </span><span class="RktSym">e</span><span class="RktPn">)</span>, <span class="RktSym">e</span> will be passed to the
+<span class="RktVar">inject-proc</span> before comparing it with other elements of <span class="RktSym">s</span>.</p><p>The <span class="RktVar">add-proc</span> procedure is called when adding an element to a set, e.g.,
+via <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-add%29%29" class="RktValLink" data-pltdoc="x">set-add</a></span> or <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-add%21%29%29" class="RktValLink" data-pltdoc="x">set-add!</a></span>. The result of the <span class="RktVar">add-proc</span> is
+stored in the set.</p><p>The <span class="RktVar">shrink-proc</span> procedure is called when building a new set with
+one fewer element. For example, when evaluating <span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%29%29" class="RktValLink" data-pltdoc="x">set-remove</a></span><span class="stt"> </span><span class="RktSym">s</span><span class="stt"> </span><span class="RktSym">e</span><span class="RktPn">)</span>
+or <span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%21%29%29" class="RktValLink" data-pltdoc="x">set-remove!</a></span><span class="stt"> </span><span class="RktSym">s</span><span class="stt"> </span><span class="RktSym">e</span><span class="RktPn">)</span>,
+an element is removed from a set, e.g.,
+via <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%29%29" class="RktValLink" data-pltdoc="x">set-remove</a></span> or <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%21%29%29" class="RktValLink" data-pltdoc="x">set-remove!</a></span>. The result of the <span class="RktVar">shrink-proc</span>
+is the element actually removed from the set.</p><p>The <span class="RktVar">extract-proc</span> procedure is called when an element is pulled out of
+a set, e.g., by <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-first%29%29" class="RktValLink" data-pltdoc="x">set-first</a></span>. The result of the <span class="RktVar">extract-proc</span> is
+the element actually produced by from the set.</p><p>The <span class="RktVar">clear-proc</span> is called by <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-clear%29%29" class="RktValLink" data-pltdoc="x">set-clear</a></span> and <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-clear%21%29%29" class="RktValLink" data-pltdoc="x">set-clear!</a></span>
+and if it returns (as opposed to escaping, perhaps via raising an exception),
+the clearing operation is permitted. Its result is ignored. If <span class="RktVar">clear-proc</span>
+is <span class="RktVal">#f</span>, then clearing is done element by element (via calls into the other
+supplied procedures).</p><p>The <span class="RktVar">equal-key-proc</span> is called when an element&rsquo;s hash code is needed of when an
+element is supplied to the underlying equality in the set. The result of
+<span class="RktVar">equal-key-proc</span> is used when computing the hash or comparing for equality.</p><p>If any of the <span class="RktVar">inject-proc</span>, <span class="RktVar">add-proc</span>, <span class="RktVar">shrink-proc</span>, or
+<span class="RktVar">extract-proc</span> arguments are  <span class="RktVal">#f</span>, then they all must be <span class="RktVal">#f</span>,
+the <span class="RktVar">clear-proc</span> and <span class="RktVar">equal-key-proc</span> must also be <span class="RktVal">#f</span>,
+and there must be at least one property supplied.</p><p>Pairs of <span class="RktVar">prop</span> and <span class="RktVar">prop-val</span> (the number of arguments to
+<span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._impersonate-hash-set%29%29" class="RktValLink" data-pltdoc="x">impersonate-hash-set</a></span> must be odd) add <a href="chaperones.html#%28tech._impersonator._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator properties</span></a> or
+override impersonator property values of <span class="RktVar">st</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._chaperone-hash-set))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._chaperone-hash-set%29%29" class="RktValDef RktValLink" data-pltdoc="x">chaperone-hash-set</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">st</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">inject-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">add-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">shrink-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">extract-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">clear-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">equal-key-proc</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-mutable~3f%29%29" class="RktValLink" data-pltdoc="x">set-mutable?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-weak~3f%29%29" class="RktValLink" data-pltdoc="x">set-weak?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">st</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-mutable~3f%29%29" class="RktValLink" data-pltdoc="x">set-mutable?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-weak~3f%29%29" class="RktValLink" data-pltdoc="x">set-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">inject-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">add-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">shrink-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">extract-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">clear-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">equal-key-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Chaperones <span class="RktVar">st</span>. Like <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._impersonate-hash-set%29%29" class="RktValLink" data-pltdoc="x">impersonate-hash-set</a></span> but with
+the constraints that the results of the <span class="RktVar">inject-proc</span>,
+<span class="RktVar">add-proc</span>, <span class="RktVar">shrink-proc</span>, <span class="RktVar">extract-proc</span>, and
+<span class="RktVar">equal-key-proc</span> must be
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-of~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone-of?</a></span> their second arguments. Also, the input
+may be an <span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span> set.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Custom_Hash_Sets&quot;">4.18.4<tt>&nbsp;</tt><a name="(part._.Custom_.Hash_.Sets)"></a>Custom Hash Sets</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/set..rkt)._define-custom-set-types))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._define-custom-set-types%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-custom-set-types</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">name</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">optional-predicate</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">comparison-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">optional-hash-functions</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">optional-predicate</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:elem?</span><span class="hspace">&nbsp;</span><span class="RktVar">predicate-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">optional-hash-functions</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">hash1-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">hash1-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">hash2-expr</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new hash set type based on the given comparison <span class="RktVar">comparison-expr</span>,
+hash functions <span class="RktVar">hash1-expr</span> and <span class="RktVar">hash2-expr</span>, and element
+predicate <span class="RktVar">predicate-expr</span>; the interfaces for these functions are the
+same as in <span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._make-custom-set-types%29%29" class="RktValLink" data-pltdoc="x">make-custom-set-types</a></span>.  The new set type has three
+variants: immutable, mutable with strongly-held elements, and mutable with
+weakly-held elements.</div></p><p>Defines seven names:</p><ul><li><p><span class="RktVar">name</span><span class="RktSym">?</span> recognizes instances of the new type,</p></li><li><p><span class="RktSym">immutable-</span><span class="RktVar">name</span><span class="RktSym">?</span> recognizes
+immutable instances of the new type,</p></li><li><p><span class="RktSym">mutable-</span><span class="RktVar">name</span><span class="RktSym">?</span> recognizes
+mutable instances of the new type with strongly-held elements,</p></li><li><p><span class="RktSym">weak-</span><span class="RktVar">name</span><span class="RktSym">?</span> recognizes
+mutable instances of the new type with weakly-held elements,</p></li><li><p><span class="RktSym">make-immutable-</span><span class="RktVar">name</span> constructs
+immutable instances of the new type,</p></li><li><p><span class="RktSym">make-mutable-</span><span class="RktVar">name</span> constructs
+mutable instances of the new type with strongly-held elements, and</p></li><li><p><span class="RktSym">make-weak-</span><span class="RktVar">name</span> constructs
+mutable instances of the new type with weakly-held elements.</p></li></ul><p>The constructors all accept a stream as an optional argument, providing
+initial elements.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._define-custom-set-types%29%29" class="RktStxLink" data-pltdoc="x">define-custom-set-types</a></span><span class="hspace">&nbsp;</span><span class="RktSym">string-set</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:elem?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string=?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="RktValLink" data-pltdoc="x">string-length</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">imm</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-immutable-string-set</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mut</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-mutable-string-set</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">imm</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mut</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3f%29%29" class="RktValLink" data-pltdoc="x">set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">imm</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">imm</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">string-set?</span><span class="hspace">&nbsp;</span><span class="RktSym">imm</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">string-set?</span><span class="hspace">&nbsp;</span><span class="RktSym">mut</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">immutable-string-set?</span><span class="hspace">&nbsp;</span><span class="RktSym">imm</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">immutable-string-set?</span><span class="hspace">&nbsp;</span><span class="RktSym">mut</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-member~3f%29%29" class="RktValLink" data-pltdoc="x">set-member?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">imm</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-member~3f%29%29" class="RktValLink" data-pltdoc="x">set-member?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mut</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">imm</span><span class="hspace">&nbsp;</span><span class="RktSym">mut</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set~3d~3f%29%29" class="RktValLink" data-pltdoc="x">set=?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">imm</span><span class="hspace">&nbsp;</span><span class="RktSym">mut</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%21%29%29" class="RktValLink" data-pltdoc="x">set-remove!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mut</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-member~3f%29%29" class="RktValLink" data-pltdoc="x">set-member?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">mut</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%29%29" class="RktValLink" data-pltdoc="x">set-remove</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._set-remove%29%29" class="RktValLink" data-pltdoc="x">set-remove</a></span><span class="hspace">&nbsp;</span><span class="RktSym">imm</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-immutable-string-set</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/set..rkt)._make-custom-set-types))"></a><span title="Provided from: racket/set, racket | Package: base"><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._make-custom-set-types%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-custom-set-types</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">eql?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">hash1</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash2</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:elem?</span><span class="hspace">&nbsp;</span><span class="RktVar">elem?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:name</span><span class="hspace">&nbsp;</span><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:for</span><span class="hspace">&nbsp;</span><span class="RktVar">who</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sets.html#%28def._%28%28lib._racket%2Fset..rkt%29._generic-set~3f%29%29" class="RktValLink" data-pltdoc="x">generic-set?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">eql?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">hash1</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._const%29%29" class="RktValLink" data-pltdoc="x">const</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">hash2</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._const%29%29" class="RktValLink" data-pltdoc="x">const</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">elem?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Ffunction..rkt%29._const%29%29" class="RktValLink" data-pltdoc="x">const</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#true</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">custom-set</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">who</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">make-custom-set-types</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new set type based on the given comparison function <span class="RktVar">eql?</span>,
+hash functions <span class="RktVar">hash1</span> and <span class="RktVar">hash2</span>, and predicate <span class="RktVar">elem?</span>.
+The new set type has variants that are immutable, mutable with strongly-held
+elements, and mutable with weakly-held elements.  The given <span class="RktVar">name</span> is
+used when printing instances of the new set type, and the symbol <span class="RktVar">who</span>
+is used for reporting errors.</div></p><p>The comparison function <span class="RktVar">eql?</span> may accept 2 or 3 arguments.  If it
+accepts 2 arguments, it given two elements to compare them.  If it accepts 3
+arguments and does not accept 2 arguments, it is also given a recursive
+comparison function that handles data cycles when comparing sub-parts of the
+elements.</p><p>The hash functions <span class="RktVar">hash1</span> and <span class="RktVar">hash2</span> may accept 1 or 2
+arguments.  If either hash function accepts 1 argument, it is applied to a
+element to compute the corresponding hash value.  If either hash function
+accepts 2 arguments and does not accept 1 argument, it is also given a
+recursive hash function that handles data cycles when computing hash values of
+sub-parts of the elements.</p><p>The predicate <span class="RktVar">elem?</span> must accept 1 argument and is used to recognize
+valid elements for the new set type.</p><p>Produces seven values:</p><ul><li><p>a predicate recognizing all instances of the new set type,</p></li><li><p>a predicate recognizing weak instances,</p></li><li><p>a predicate recognizing mutable instances,</p></li><li><p>a predicate recognizing immutable instances,</p></li><li><p>a constructor for weak instances,</p></li><li><p>a constructor for mutable instances, and</p></li><li><p>a constructor for immutable instances.</p></li></ul><p>See <span class="RktSym"><a href="sets.html#%28form._%28%28lib._racket%2Fset..rkt%29._define-custom-set-types%29%29" class="RktStxLink" data-pltdoc="x">define-custom-set-types</a></span> for an example.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="dicts.html" title="backward to &quot;4.17 Dictionaries&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="procedures.html" title="forward to &quot;4.19 Procedures&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/sha.html b/clones/docs.racket-lang.org/reference/sha.html
new file mode 100644
index 00000000..a337e288
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/sha.html
@@ -0,0 +1,20 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.11&nbsp;Cryptographic Hashing</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewselflink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="sha.html#%28def._%28%28quote._~23~25kernel%29._sha1-bytes%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sha1-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><a href="sha.html#%28def._%28%28quote._~23~25kernel%29._sha224-bytes%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sha224-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><a href="sha.html#%28def._%28%28quote._~23~25kernel%29._sha256-bytes%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sha256-<wbr></wbr>bytes</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="fasl.html" title="backward to &quot;13.10 Fast-Load Serialization&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="security.html" title="forward to &quot;14 Reflection and Security&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;sha&quot;">13.11<tt>&nbsp;</tt><a name="(part._sha)"></a>Cryptographic Hashing</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._sha1-bytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sha.html#%28def._%28%28quote._~23~25kernel%29._sha1-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">sha1-bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._sha224-bytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sha.html#%28def._%28%28quote._~23~25kernel%29._sha224-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">sha224-bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._sha256-bytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sha.html#%28def._%28%28quote._~23~25kernel%29._sha256-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">sha256-bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Computes the SHA-1, SHA-224, or SHA-256 hash of a byte sequence and
+returns the hash as a byte string with 20 bytes, 28 bytes, or 32
+bytes, respectively.</div></p><p>The <span class="RktVar">start</span> and <span class="RktVar">end</span> arguments determine the range of
+bytes of the input that are used to compute the hash. An <span class="RktVar">end</span>
+value of <span class="RktVal">#f</span> corresponds to the end of the byte string or an
+end-of-file position for an input port. When <span class="RktVar">in</span> is a byte
+string, the <span class="RktVar">start</span> and <span class="RktVar">end</span> values (when non
+<span class="RktVal">#f</span>) must be no greater than the length of the byte string,
+and <span class="RktVar">start</span> must be no greater than <span class="RktVar">end</span>. When
+<span class="RktVar">in</span> is an input port, <span class="RktVar">start</span> must be no greater than
+<span class="RktVar">end</span>; if <span class="RktVar">in</span> supplies less than <span class="RktVar">start</span> or
+<span class="RktVar">end</span> bytes before an end-of-file, then <span class="RktVar">start</span> and/or
+<span class="RktVar">end</span> is effectively changed to the number of supplied bytes
+(so that an empty or truncated byte sequence is hashed). When
+<span class="RktVar">in</span> is an input port and <span class="RktVar">end</span> is a number, then at
+most <span class="RktVar">end</span> bytes are read from the input port.</p><p>For security purposes, favor <span class="RktSym"><a href="sha.html#%28def._%28%28quote._~23~25kernel%29._sha224-bytes%29%29" class="RktValLink" data-pltdoc="x">sha224-bytes</a></span> and
+<span class="RktSym"><a href="sha.html#%28def._%28%28quote._~23~25kernel%29._sha256-bytes%29%29" class="RktValLink" data-pltdoc="x">sha256-bytes</a></span> (which are part of the SHA-2 family) over
+<span class="RktSym"><a href="sha.html#%28def._%28%28quote._~23~25kernel%29._sha1-bytes%29%29" class="RktValLink" data-pltdoc="x">sha1-bytes</a></span>.</p><p>Use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=file&amp;rel=sha1b.html%23%2528def._%2528%2528lib._file%252Fsha1..rkt%2529._bytes-%7E3ehex-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">bytes-&gt;hex-string</a></span> from <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=file&amp;rel=sha1b.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">file/sha1</span></a> to
+convert a byte string hash to a human-readable string.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sha.html#%28def._%28%28quote._~23~25kernel%29._sha1-bytes%29%29" class="RktValLink" data-pltdoc="x">sha1-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"abc"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"\251\231&gt;6G\6\201j\272&gt;%qxP\302l\234\320\330\235"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">file/sha1</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=file&amp;rel=sha1b.html%23%2528def._%2528%2528lib._file%252Fsha1..rkt%2529._bytes-%7E3ehex-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">bytes-&gt;hex-string</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sha.html#%28def._%28%28quote._~23~25kernel%29._sha1-bytes%29%29" class="RktValLink" data-pltdoc="x">sha1-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"abc"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"a9993e364706816aba3e25717850c26c9cd0d89d"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=file&amp;rel=sha1b.html%23%2528def._%2528%2528lib._file%252Fsha1..rkt%2529._bytes-%7E3ehex-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">bytes-&gt;hex-string</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sha.html#%28def._%28%28quote._~23~25kernel%29._sha224-bytes%29%29" class="RktValLink" data-pltdoc="x">sha224-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"abc"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"23097d223405d8228642a477bda255b32aadbce4bda0b3f7e36c9da7"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=file&amp;rel=sha1b.html%23%2528def._%2528%2528lib._file%252Fsha1..rkt%2529._bytes-%7E3ehex-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">bytes-&gt;hex-string</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sha.html#%28def._%28%28quote._~23~25kernel%29._sha224-bytes%29%29" class="RktValLink" data-pltdoc="x">sha224-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"xabcy"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"23097d223405d8228642a477bda255b32aadbce4bda0b3f7e36c9da7"</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 7.0.0.5 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="fasl.html" title="backward to &quot;13.10 Fast-Load Serialization&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="input-and-output.html" title="up to &quot;13 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="security.html" title="forward to &quot;14 Reflection and Security&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/shared.html b/clones/docs.racket-lang.org/reference/shared.html
new file mode 100644
index 00000000..1997f500
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/shared.html
@@ -0,0 +1,46 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.11&nbsp;Constructing Graphs: shared</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewselflink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="shared.html#%28form._%28%28lib._racket%2Fshared..rkt%29._shared%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="local.html" title="backward to &quot;3.10 Local Definitions: local&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="if.html" title="forward to &quot;3.12 Conditionals: if, cond, and, and or&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;shared&quot;">3.11<tt>&nbsp;</tt><a name="(part._shared)"></a><a name="(mod-path._racket/shared)"></a>Constructing Graphs: <span class="RktSym"><a href="shared.html#%28form._%28%28lib._racket%2Fshared..rkt%29._shared%29%29" class="RktStxLink" data-pltdoc="x">shared</a></span></h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="shared.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/shared</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="shared.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/shared</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/shared..rkt)._shared))"></a><span title="Provided from: racket/shared, racket | Package: base"><span class="RktSym"><a href="shared.html#%28form._%28%28lib._racket%2Fshared..rkt%29._shared%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">shared</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Binds <span class="RktVar">id</span>s with shared structure according to <span class="RktVar">expr</span>s
+and then evaluates the <span class="RktVar">body</span>s, returning the result of
+the last expression.</div></p><p>The <span class="RktSym"><a href="shared.html#%28form._%28%28lib._racket%2Fshared..rkt%29._shared%29%29" class="RktStxLink" data-pltdoc="x">shared</a></span> form is similar to <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec%29%29" class="RktStxLink" data-pltdoc="x">letrec</a></span>, except that
+special forms of <span class="RktVar">expr</span> are recognized (after partial macro
+expansion) to construct graph-structured data, where the corresponding
+<span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec%29%29" class="RktStxLink" data-pltdoc="x">letrec</a></span> would instead produce a use-before-initialization error.</p><p>Each <span class="RktVar">expr</span> (after partial expansion) is matched against the
+following <span class="RktVar">shared-expr</span> grammar, where earlier variants in a
+production take precedence over later variants:</p><p><table cellspacing="0" cellpadding="0"><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">shared-expr</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">shell-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">plain-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">shell-expr</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVar">in-immutable-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">in-immutable-expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVar">in-immutable-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%2A%29%29" class="RktValLink" data-pltdoc="x">list*</a></span><span class="hspace">&nbsp;</span><span class="RktVar">in-immutable-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._append%29%29" class="RktValLink" data-pltdoc="x">append</a></span><span class="hspace">&nbsp;</span><span class="RktVar">early-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">in-immutable-expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-immutable%29%29" class="RktValLink" data-pltdoc="x">vector-immutable</a></span><span class="hspace">&nbsp;</span><span class="RktVar">in-immutable-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box-immutable%29%29" class="RktValLink" data-pltdoc="x">box-immutable</a></span><span class="hspace">&nbsp;</span><span class="RktVar">in-immutable-expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="RktValLink" data-pltdoc="x">mcons</a></span><span class="hspace">&nbsp;</span><span class="RktVar">patchable-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">patchable-expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVar">patchable-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValLink" data-pltdoc="x">box</a></span><span class="hspace">&nbsp;</span><span class="RktVar">patchable-expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">prefix:</span><span class="RktSym">make-</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">patchable-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in-immutable-expr</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">shell-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">shell-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">early-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">shell-id</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">patchable-expr</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">early-expr</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">plain-expr</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">expr</span></td></tr></table></p><p>The <span class="RktVar">prefix:</span><span class="RktSym">make-</span><span class="RktVar">id</span> identifier above matches three kinds of references. The
+first kind is any binding whose name has <span class="RktSym">make-</span> in the
+middle, and where <span class="RktVar">prefix:</span><span class="RktVar">id</span> has a <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding to
+structure information with a full set of mutator bindings; see
+<a href="structinfo.html" data-pltdoc="x">Structure Type Transformer Binding</a>. The second kind is an identifier that itself has a
+<a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding to structure information. The third kind is an
+identifier that has a <span class="RktVal">'</span><span class="RktVal">constructor-for</span> <a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax property</span></a>
+whose value is an identifier with a <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding to structure
+information. A <span class="RktVar">shell-id</span>, meanwhile, must be one of the
+<span class="RktVar">id</span>s bound by the <span class="RktSym"><a href="shared.html#%28form._%28%28lib._racket%2Fshared..rkt%29._shared%29%29" class="RktStxLink" data-pltdoc="x">shared</a></span> form to a
+<span class="RktVar">shell-expr</span>.</p><p>When the <span class="RktVar">expr</span>s of the <span class="RktSym"><a href="shared.html#%28form._%28%28lib._racket%2Fshared..rkt%29._shared%29%29" class="RktStxLink" data-pltdoc="x">shared</a></span> form are parsed as
+<span class="RktVar">shared-expr</span> (taking into account the order of the variants
+for parsing precedence), the sub-expressions that were parsed via
+<span class="RktVar">early-expr</span> will be evaluated first when the <span class="RktSym"><a href="shared.html#%28form._%28%28lib._racket%2Fshared..rkt%29._shared%29%29" class="RktStxLink" data-pltdoc="x">shared</a></span>
+form is evaluated. Among such expressions, they are evaluated in the
+order as they appear within the <span class="RktSym"><a href="shared.html#%28form._%28%28lib._racket%2Fshared..rkt%29._shared%29%29" class="RktStxLink" data-pltdoc="x">shared</a></span> form. However, any
+reference to an <span class="RktVar">id</span> bound by <span class="RktSym"><a href="shared.html#%28form._%28%28lib._racket%2Fshared..rkt%29._shared%29%29" class="RktStxLink" data-pltdoc="x">shared</a></span> produces
+a use-before-initialization errror, even if the binding for the <span class="RktVar">id</span> appears
+before the corresponding <span class="RktVar">early-expr</span> within the
+<span class="RktSym"><a href="shared.html#%28form._%28%28lib._racket%2Fshared..rkt%29._shared%29%29" class="RktStxLink" data-pltdoc="x">shared</a></span> form.</p><p>The <span class="RktVar">shell-id</span>s and <span class="RktVar">shell-expr</span>s (not counting
+<span class="RktVar">patchable-expr</span> and <span class="RktVar">early-expr</span> sub-expressions) are
+effectively evaluated next:</p><ul><li><p>A <span class="RktVar">shell-id</span> reference produces the same value as the
+corresponding <span class="RktVar">id</span> will produce within the
+<span class="RktVar">body</span>s, assuming that <span class="RktVar">id</span> is never mutated
+with <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>.  This special handling of a
+<span class="RktVar">shell-id</span> reference is one way in which
+<span class="RktSym"><a href="shared.html#%28form._%28%28lib._racket%2Fshared..rkt%29._shared%29%29" class="RktStxLink" data-pltdoc="x">shared</a></span> supports the creation of cyclic data, including
+immutable cyclic data.</p></li><li><p>A <span class="RktVar">shell-expr</span> of the form <span class="RktPn">(</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="RktValLink" data-pltdoc="x">mcons</a></span><span class="stt"> </span><span class="RktVar">patchable-expr</span><span class="stt"> </span><span class="RktVar">patchable-expr</span><span class="RktPn">)</span>, <span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="stt"> </span><span class="RktVar">patchable-expr</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>, <span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValLink" data-pltdoc="x">box</a></span><span class="stt"> </span><span class="RktVar">patchable-expr</span><span class="RktPn">)</span>, or <span class="RktPn">(</span><span class="RktVar">prefix:</span><span class="RktSym">make-</span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">patchable-expr</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> produces a mutable value whose content
+positions are initialized to <span class="RktSym"><a href="undefined.html#%28def._%28%28lib._racket%2Fundefined..rkt%29._undefined%29%29" class="RktValLink" data-pltdoc="x">undefined</a></span>. Each content
+position is <a name="(tech._patched)"></a><span style="font-style: italic">patched</span> (i.e., updated) after the
+corresponding <span class="RktVar">patchable-expr</span> expression is later
+evaluated.</p></li></ul><p>Next, the <span class="RktVar">plain-expr</span>s are evaluated as for <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec%29%29" class="RktStxLink" data-pltdoc="x">letrec</a></span>,
+where a reference to an <span class="RktVar">id</span> raises <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3avariable%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:variable</a></span> if it
+is evaluated before the right-hand side of the <span class="RktVar">id</span> binding.</p><p>Finally, the <span class="RktVar">patchable-expr</span>s are evaluated and their values
+replace <span class="RktSym"><a href="undefined.html#%28def._%28%28lib._racket%2Fundefined..rkt%29._undefined%29%29" class="RktValLink" data-pltdoc="x">undefined</a></span>s in the results of
+<span class="RktVar">shell-expr</span>s. At this point, all <span class="RktVar">id</span>s are bound, so
+<span class="RktVar">patchable-expr</span>s can create data cycles (but only with cycles
+that can be created via mutation).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="shared.html#%28form._%28%28lib._racket%2Fshared..rkt%29._shared%29%29" class="RktStxLink" data-pltdoc="x">shared</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#0='(1 . #0#)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="shared.html#%28form._%28%28lib._racket%2Fshared..rkt%29._shared%29%29" class="RktStxLink" data-pltdoc="x">shared</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#0='(1 2 . #0#)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="shared.html#%28form._%28%28lib._racket%2Fshared..rkt%29._shared%29%29" class="RktStxLink" data-pltdoc="x">shared</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(1 . 7)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="shared.html#%28form._%28%28lib._racket%2Fshared..rkt%29._shared%29%29" class="RktStxLink" data-pltdoc="x">shared</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">no indirection...</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">a: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot use before initialization</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="shared.html#%28form._%28%28lib._racket%2Fshared..rkt%29._shared%29%29" class="RktStxLink" data-pltdoc="x">shared</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktSym">b</span><span class="RktCmt"> is early...</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">a: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot use before initialization</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="shared.html#%28form._%28%28lib._racket%2Fshared..rkt%29._shared%29%29" class="RktStxLink" data-pltdoc="x">shared</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcons%29%29" class="RktValLink" data-pltdoc="x">mcons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktSym">b</span><span class="RktCmt"> is patchable...</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#0=(mcons 1 #0#)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="shared.html#%28form._%28%28lib._racket%2Fshared..rkt%29._shared%29%29" class="RktStxLink" data-pltdoc="x">shared</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValLink" data-pltdoc="x">box</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._set-box%21%29%29" class="RktValLink" data-pltdoc="x">set-box!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'#(#&amp;5 #&amp;5 #&amp;5)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="shared.html#%28form._%28%28lib._racket%2Fshared..rkt%29._shared%29%29" class="RktStxLink" data-pltdoc="x">shared</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValLink" data-pltdoc="x">box</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="RktValLink" data-pltdoc="x">unbox</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="RktValLink" data-pltdoc="x">unbox</a></span><span class="RktCmt"> after </span><span class="RktSym">a</span><span class="RktCmt"> is patched</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="RktValLink" data-pltdoc="x">unbox</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="RktValLink" data-pltdoc="x">unbox</a></span><span class="RktCmt"> before </span><span class="RktSym">c</span><span class="RktCmt"> is patched</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValLink" data-pltdoc="x">box</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#0='#(#0# #&lt;undefined&gt;)</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="local.html" title="backward to &quot;3.10 Local Definitions: local&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="if.html" title="forward to &quot;3.12 Conditionals: if, cond, and, and or&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/single-unit.html b/clones/docs.racket-lang.org/reference/single-unit.html
new file mode 100644
index 00000000..aaefc29b
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/single-unit.html
@@ -0,0 +1,11 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7.10&nbsp;Single-Unit Modules</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="creatingunits.html" class="tocviewlink" data-pltdoc="x">Creating Units</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="invokingunits.html" class="tocviewlink" data-pltdoc="x">Invoking Units</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="compoundunits.html" class="tocviewlink" data-pltdoc="x">Linking Units and Creating Compound Units</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="linkinference.html" class="tocviewlink" data-pltdoc="x">Inferred Linking</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="Generating_A_Unit_from_Context.html" class="tocviewlink" data-pltdoc="x">Generating A Unit from Context</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="Structural_Matching.html" class="tocviewlink" data-pltdoc="x">Structural Matching</a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="define-sig-form.html" class="tocviewlink" data-pltdoc="x">Extending the Syntax of Signatures</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Unit_Utilities.html" class="tocviewlink" data-pltdoc="x">Unit Utilities</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="unitcontracts.html" class="tocviewlink" data-pltdoc="x">Unit Contracts</a></td></tr><tr><td align="right">7.10&nbsp;</td><td><a href="single-unit.html" class="tocviewselflink" data-pltdoc="x">Single-<wbr></wbr>Unit Modules</a></td></tr><tr><td align="right">7.11&nbsp;</td><td><a href="Single-Signature_Modules.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Signature Modules</a></td></tr><tr><td align="right">7.12&nbsp;</td><td><a href="Transformer_Helpers.html" class="tocviewlink" data-pltdoc="x">Transformer Helpers</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="unitcontracts.html" title="backward to &quot;7.9 Unit Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Single-Signature_Modules.html" title="forward to &quot;7.11 Single-Signature Modules&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;single-unit&quot;">7.10<tt>&nbsp;</tt><a name="(part._single-unit)"></a>Single-Unit Modules</h4><p>When <a href="mzlib_unit.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/unit</span></a> is used as a language name with
+<span class="stt">#lang</span>, the module body is treated as a unit body.  The
+body must match the following <span class="RktVar">module-body</span> grammar:</p><p><table cellspacing="0" cellpadding="0"><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">module-body</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktVar">require-decl</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-expr</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-expr</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktVar">init-depends-decl</span></td></tr><tr><td><span class="RktVar">unit-body-expr-or-defn</span></td></tr><tr><td><span class="RktSym">...</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">require-decl</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktVar">require-decl</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">derived-require-form</span></td></tr></table></p><p>After any number of <span class="RktVar">require-decl</span>s, the content of the module
+is the same as a <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span> body.</p><p>The resulting unit is exported as <span class="RktVar">base</span><span class="RktSym">@</span>,
+where <span class="RktVar">base</span> is derived from the enclosing module&rsquo;s name
+(i.e., its symbolic name, or its path without the directory and file
+suffix). If the module name ends in <span class="RktSym">-unit</span>, then
+<span class="RktVar">base</span> corresponds to the module name before
+<span class="RktSym">-unit</span>. Otherwise, the module name serves as
+<span class="RktVar">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="unitcontracts.html" title="backward to &quot;7.9 Unit Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Single-Signature_Modules.html" title="forward to &quot;7.11 Single-Signature Modules&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/special-comments.html b/clones/docs.racket-lang.org/reference/special-comments.html
new file mode 100644
index 00000000..2f536b1f
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/special-comments.html
@@ -0,0 +1,10 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.7.3&nbsp;Special Comments</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewselflink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.7.1&nbsp;</td><td><a href="readtables.html" class="tocviewlink" data-pltdoc="x">Readtables</a></td></tr><tr><td align="right">13.7.2&nbsp;</td><td><a href="reader-procs.html" class="tocviewlink" data-pltdoc="x">Reader-<wbr></wbr>Extension Procedures</a></td></tr><tr><td align="right">13.7.3&nbsp;</td><td><a href="special-comments.html" class="tocviewselflink" data-pltdoc="x">Special Comments</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="special-comments.html#%28def._%28%28quote._~23~25kernel%29._make-special-comment%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>special-<wbr></wbr>comment</span></span></a></td></tr><tr><td><a href="special-comments.html#%28def._%28%28quote._~23~25kernel%29._special-comment~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">special-<wbr></wbr>comment?</span></span></a></td></tr><tr><td><a href="special-comments.html#%28def._%28%28quote._~23~25kernel%29._special-comment-value%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">special-<wbr></wbr>comment-<wbr></wbr>value</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="reader-procs.html" title="backward to &quot;13.7.2 Reader-Extension Procedures&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Reader_Extension.html" title="up to &quot;13.7 Reader Extension&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Printer_Extension.html" title="forward to &quot;13.8 Printer Extension&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;special-comments&quot;">13.7.3<tt>&nbsp;</tt><a name="(part._special-comments)"></a>Special Comments</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-special-comment))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="special-comments.html#%28def._%28%28quote._~23~25kernel%29._make-special-comment%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-special-comment</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="special-comments.html#%28def._%28%28quote._~23~25kernel%29._special-comment~3f%29%29" class="RktValLink" data-pltdoc="x">special-comment?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a special-comment value that encapsulates <span class="RktVar">v</span>. The
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>, <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>, etc<span class="Sendabbrev">.</span>, procedures treat values
+constructed with <span class="RktSym"><a href="special-comments.html#%28def._%28%28quote._~23~25kernel%29._make-special-comment%29%29" class="RktValLink" data-pltdoc="x">make-special-comment</a></span> as delimiting
+whitespace when returned by a reader-extension procedure (see
+<a href="reader-procs.html" data-pltdoc="x">Reader-Extension Procedures</a>).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._special-comment~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="special-comments.html#%28def._%28%28quote._~23~25kernel%29._special-comment~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">special-comment?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is the result of
+<span class="RktSym"><a href="special-comments.html#%28def._%28%28quote._~23~25kernel%29._make-special-comment%29%29" class="RktValLink" data-pltdoc="x">make-special-comment</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._special-comment-value))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="special-comments.html#%28def._%28%28quote._~23~25kernel%29._special-comment-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">special-comment-value</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="special-comments.html#%28def._%28%28quote._~23~25kernel%29._special-comment~3f%29%29" class="RktValLink" data-pltdoc="x">special-comment?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the value encapsulated by the special-comment value
+<span class="RktVar">sc</span>. This value is never used directly by a reader, but it
+might be used by the context of a <span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-char-or-special%29%29" class="RktValLink" data-pltdoc="x">read-char-or-special</a></span>, etc<span class="Sendabbrev">.</span>,
+call that detects a special comment.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="reader-procs.html" title="backward to &quot;13.7.2 Reader-Extension Procedures&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Reader_Extension.html" title="up to &quot;13.7 Reader Extension&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Printer_Extension.html" title="forward to &quot;13.8 Printer Extension&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/splicing.html b/clones/docs.racket-lang.org/reference/splicing.html
new file mode 100644
index 00000000..7c923b4a
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/splicing.html
@@ -0,0 +1,29 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>12.6&nbsp;Local Binding with Splicing Body</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">12.1&nbsp;</td><td><a href="stx-patterns.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Syntax Matching</a></td></tr><tr><td align="right">12.2&nbsp;</td><td><a href="stxops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Content</a></td></tr><tr><td align="right">12.3&nbsp;</td><td><a href="stxcmp.html" class="tocviewlink" data-pltdoc="x">Syntax Object Bindings</a></td></tr><tr><td align="right">12.4&nbsp;</td><td><a href="stxtrans.html" class="tocviewlink" data-pltdoc="x">Syntax Transformers</a></td></tr><tr><td align="right">12.5&nbsp;</td><td><a href="stxparam.html" class="tocviewlink" data-pltdoc="x">Syntax Parameters</a></td></tr><tr><td align="right">12.6&nbsp;</td><td><a href="splicing.html" class="tocviewselflink" data-pltdoc="x">Local Binding with Splicing Body</a></td></tr><tr><td align="right">12.7&nbsp;</td><td><a href="stxprops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Properties</a></td></tr><tr><td align="right">12.8&nbsp;</td><td><a href="stxcerts.html" class="tocviewlink" data-pltdoc="x">Syntax Taints</a></td></tr><tr><td align="right">12.9&nbsp;</td><td><a href="Expanding_Top-Level_Forms.html" class="tocviewlink" data-pltdoc="x">Expanding Top-<wbr></wbr>Level Forms</a></td></tr><tr><td align="right">12.10&nbsp;</td><td><a href="Serializing_Syntax.html" class="tocviewlink" data-pltdoc="x">Serializing Syntax</a></td></tr><tr><td align="right">12.11&nbsp;</td><td><a href="include.html" class="tocviewlink" data-pltdoc="x">File Inclusion</a></td></tr><tr><td align="right">12.12&nbsp;</td><td><a href="syntax-util.html" class="tocviewlink" data-pltdoc="x">Syntax Utilities</a></td></tr><tr><td align="right">12.13&nbsp;</td><td><a href="phase_space.html" class="tocviewlink" data-pltdoc="x">Phase and Space Utilities</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-let%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-<wbr></wbr>let</span></span></a></td></tr><tr><td><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-letrec%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-<wbr></wbr>letrec</span></span></a></td></tr><tr><td><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-let-values%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-<wbr></wbr>let-<wbr></wbr>values</span></span></a></td></tr><tr><td><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-letrec-values%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-<wbr></wbr>letrec-<wbr></wbr>values</span></span></a></td></tr><tr><td><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-let-syntax%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-<wbr></wbr>let-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-letrec-syntax%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-<wbr></wbr>letrec-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-let-syntaxes%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-<wbr></wbr>let-<wbr></wbr>syntaxes</span></span></a></td></tr><tr><td><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-letrec-syntaxes%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-<wbr></wbr>letrec-<wbr></wbr>syntaxes</span></span></a></td></tr><tr><td><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-letrec-syntaxes%2Bvalues%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-<wbr></wbr>letrec-<wbr></wbr>syntaxes+<span class="mywbr"> &nbsp;</span>values</span></span></a></td></tr><tr><td><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-local%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-<wbr></wbr>local</span></span></a></td></tr><tr><td><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-parameterize%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-<wbr></wbr>parameterize</span></span></a></td></tr><tr><td><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-syntax-parameterize%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">splicing-<wbr></wbr>syntax-<wbr></wbr>parameterize</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stxparam.html" title="backward to &quot;12.5 Syntax Parameters&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stxprops.html" title="forward to &quot;12.7 Syntax Object Properties&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;splicing&quot;">12.6<tt>&nbsp;</tt><a name="(part._splicing)"></a><a name="(mod-path._racket/splicing)"></a>Local Binding with Splicing Body</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="splicing.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/splicing</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="splicing.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/splicing</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/splicing..rkt)._splicing-let))"></a><span title="Provided from: racket/splicing | Package: base"><span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-let%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">splicing-let</a></span></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/splicing..rkt)._splicing-letrec))"></a><span title="Provided from: racket/splicing | Package: base"><span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-letrec%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">splicing-letrec</a></span></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/splicing..rkt)._splicing-let-values))"></a><span title="Provided from: racket/splicing | Package: base"><span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-let-values%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">splicing-let-values</a></span></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/splicing..rkt)._splicing-letrec-values))"></a><span title="Provided from: racket/splicing | Package: base"><span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-letrec-values%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">splicing-letrec-values</a></span></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/splicing..rkt)._splicing-let-syntax))"></a><span title="Provided from: racket/splicing | Package: base"><span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-let-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">splicing-let-syntax</a></span></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/splicing..rkt)._splicing-letrec-syntax))"></a><span title="Provided from: racket/splicing | Package: base"><span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-letrec-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">splicing-letrec-syntax</a></span></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/splicing..rkt)._splicing-let-syntaxes))"></a><span title="Provided from: racket/splicing | Package: base"><span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-let-syntaxes%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">splicing-let-syntaxes</a></span></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/splicing..rkt)._splicing-letrec-syntaxes))"></a><span title="Provided from: racket/splicing | Package: base"><span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-letrec-syntaxes%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">splicing-letrec-syntaxes</a></span></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/splicing..rkt)._splicing-letrec-syntaxes+values))"></a><span title="Provided from: racket/splicing | Package: base"><span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-letrec-syntaxes%2Bvalues%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">splicing-letrec-syntaxes+values</a></span></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/splicing..rkt)._splicing-local))"></a><span title="Provided from: racket/splicing | Package: base"><span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-local%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">splicing-local</a></span></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/splicing..rkt)._splicing-parameterize))"></a><span title="Provided from: racket/splicing | Package: base"><span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-parameterize%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">splicing-parameterize</a></span></span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span> (not <a href="let.html#%28tech._named._let%29" class="techoutside" data-pltdoc="x"><span class="techinside">named <span class="RktSym"><span class="RktStxLink">let</span></span></span></a>), <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec%29%29" class="RktStxLink" data-pltdoc="x">letrec</a></span>, <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span>,
+<span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-values%29%29" class="RktStxLink" data-pltdoc="x">letrec-values</a></span>, <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntax%29%29" class="RktStxLink" data-pltdoc="x">let-syntax</a></span>, <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec-syntax%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntax</a></span>,
+<span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">let-syntaxes</a></span>, <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes</a></span>,
+<span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span>, <span class="RktSym"><a href="local.html#%28form._%28%28lib._racket%2Flocal..rkt%29._local%29%29" class="RktStxLink" data-pltdoc="x">local</a></span>, and
+<span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>, except that in a definition context, the body
+forms are spliced into the enclosing definition context (in the same
+way as for <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span>).</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-let-syntax%29%29" class="RktStxLink" data-pltdoc="x">splicing-let-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">one</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="hspace">&nbsp;</span><span class="RktSym">one</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">o</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">one</span></td></tr><tr><td><p><span class="RktErr">one: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr></table></blockquote></div></p><p>When a splicing binding form occurs in a <a href="syntax-model.html#%28tech._top._level._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level context</span></a> or
+<a href="syntax-model.html#%28tech._module._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">module context</span></a>, its local bindings are treated similarly to
+definitions. In particular, syntax bindings are
+evaluated every time the module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed, instead of only
+once during compilation as in <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntax%29%29" class="RktStxLink" data-pltdoc="x">let-syntax</a></span>, etc.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-letrec%29%29" class="RktStxLink" data-pltdoc="x">splicing-letrec</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">bad</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">bad</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">bad.1: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr></table></blockquote></div></p><p>If a definition within a splicing form is intended to be local to the
+splicing body, then the identifier should have a true value for the
+<span class="RktVal">'</span><span class="RktVal">definition-intended-as-local</span> <a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax property</span></a>. For
+example, <span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-let%29%29" class="RktStxLink" data-pltdoc="x">splicing-let</a></span> itself adds the property to
+locally-bound identifiers as it expands to a sequence of definitions,
+so that nesting <span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-let%29%29" class="RktStxLink" data-pltdoc="x">splicing-let</a></span> within a splicing form works as
+expected (without any ambiguous bindings).</p><p class="SHistory">Changed in version 6.12.0.2 of package <span class="stt">base</span>: Added <span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-parameterize%29%29" class="RktStxLink" data-pltdoc="x">splicing-parameterize</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/splicing..rkt)._splicing-syntax-parameterize))"></a><span title="Provided from: racket/splicing | Package: base"><span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-syntax-parameterize%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">splicing-syntax-parameterize</a></span></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._syntax-parameterize%29%29" class="RktStxLink" data-pltdoc="x">syntax-parameterize</a></span>, except that in a definition context, the body
+forms are spliced into the enclosing definition context (in the same way as for
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span>). In a definition context, the body of
+<span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-syntax-parameterize%29%29" class="RktStxLink" data-pltdoc="x">splicing-syntax-parameterize</a></span> can be empty.</div></p><p>Note that <a href="stxtrans.html#%28tech._require._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">require transformers</span></a> and <a href="stxtrans.html#%28tech._provide._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide transformers</span></a> are not
+affected by syntax parameterization.  While all uses of <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> and
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> will be spliced into the enclosing context, derived import or
+export specifications will expand as if they had not been inside of the
+<span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-syntax-parameterize%29%29" class="RktStxLink" data-pltdoc="x">splicing-syntax-parameterize</a></span>.</p><p>Additionally, <a href="eval-model.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodules</span></a> defined with <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> that specify
+<span class="RktVal">#f</span> in place of a <a href="Module_Names_and_Loading.html#%28tech._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path</span></a> <span class="emph">are</span> affected by syntax
+parameterization, but other submodules (those defined with <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> or
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> with a <a href="Module_Names_and_Loading.html#%28tech._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path</span></a>) are <span class="emph">not</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._define-syntax-parameter%29%29" class="RktStxLink" data-pltdoc="x">define-syntax-parameter</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%29%29" class="RktStxLink" data-pltdoc="x">place</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">"Kansas"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._define-syntax-rule%29%29" class="RktStxLink" data-pltdoc="x">define-syntax-rule</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">where</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">at</span><span class="hspace">&nbsp;</span><span class="RktRdr">,</span><span class="RktPn">(</span><span class="RktSym"><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%29%29" class="RktStxLink" data-pltdoc="x">place</a></span><span class="RktPn">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">where</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(at "Kansas")</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-syntax-parameterize%29%29" class="RktStxLink" data-pltdoc="x">splicing-syntax-parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%29%29" class="RktStxLink" data-pltdoc="x">place</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">"Oz"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">here</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">where</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">here</span></td></tr><tr><td><p><span class="RktRes">'(at "Oz")</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.11.0.1 of package <span class="stt">base</span>: Modified to syntax parameterize <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> submodules that
+specify <span class="RktVal">#f</span> in place of a <a href="Module_Names_and_Loading.html#%28tech._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path</span></a>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stxparam.html" title="backward to &quot;12.5 Syntax Parameters&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stxprops.html" title="forward to &quot;12.7 Syntax Object Properties&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/stencil_vectors.html b/clones/docs.racket-lang.org/reference/stencil_vectors.html
new file mode 100644
index 00000000..5c221f34
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/stencil_vectors.html
@@ -0,0 +1,50 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.13&nbsp;Stencil Vectors</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewselflink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stencil-<wbr></wbr>vector?</span></span></a></td></tr><tr><td><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-mask-width%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stencil-<wbr></wbr>vector-<wbr></wbr>mask-<wbr></wbr>width</span></span></a></td></tr><tr><td><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stencil-<wbr></wbr>vector</span></span></a></td></tr><tr><td><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-mask%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stencil-<wbr></wbr>vector-<wbr></wbr>mask</span></span></a></td></tr><tr><td><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-length%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stencil-<wbr></wbr>vector-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-ref%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stencil-<wbr></wbr>vector-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-set%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stencil-<wbr></wbr>vector-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-update%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stencil-<wbr></wbr>vector-<wbr></wbr>update</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="vectors.html" title="backward to &quot;4.12 Vectors&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="boxes.html" title="forward to &quot;4.14 Boxes&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;stencil vectors&quot;">4.13<tt>&nbsp;</tt><a name="(part._stencil._vectors)"></a>Stencil Vectors</h4><p>A <a name="(tech._stencil._vector)"></a><span style="font-style: italic">stencil vector</span> is like a <a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vector</span></a>, but it has an
+associated mask <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a> where the number of bits set in the mask
+determines the length of the vector. A stencil vector is useful for
+implementing some data structures [<a href="doc-bibliography.html#%28cite._.Torosyan21%29" data-pltdoc="x">Torosyan21</a>], such as a hash
+array mapped trie (HAMT).</p><p>Conceptually, a stencil vector&rsquo;s mask indicates which virtual elements
+of a full-sized stencil vector are present, but mask bits have no
+effect on access or mutation via <span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-ref%29%29" class="RktValLink" data-pltdoc="x">stencil-vector-ref</a></span> and
+<span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-set%21%29%29" class="RktValLink" data-pltdoc="x">stencil-vector-set!</a></span>. For example, such a stencil vector has a
+mask <span class="RktVal">25</span>, which could also be written <span class="RktVal">#b11001</span>;
+reading from low bit to high, that mask represents values present at
+the first, fourth, and fifth virtual slots. If that stencil vector&rsquo;s
+elements are <span class="RktVal">'</span><span class="RktVal">a</span>, <span class="RktVal">'</span><span class="RktVal">b</span>, and <span class="RktVal">'</span><span class="RktVal">c</span>, then
+<span class="RktVal">'</span><span class="RktVal">a</span> is at virtual slot 0 and accessed with index <span class="RktVal">0</span>,
+<span class="RktVal">'</span><span class="RktVal">b</span> is at virtual slot 3 and accessed with index <span class="RktVal">1</span>,
+and <span class="RktVal">'</span><span class="RktVal">c</span> is at virtual slot 4 and accessed with index
+<span class="RktVal">2</span>.</p><p>The relative order of bits in a mask <span class="emph">is</span> relevant for a
+functional-update operation with <span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-update%29%29" class="RktValLink" data-pltdoc="x">stencil-vector-update</a></span>.
+Elements to remove are specified with a removal mask, and elements to
+add are ordered relative to remaining elements through an addition
+mask. For example, starting with the stencil vector whose mask is
+<span class="RktVal">#b11001</span> with elements <span class="RktVal">'</span><span class="RktVal">a</span>, <span class="RktVal">'</span><span class="RktVal">b</span>, and
+<span class="RktVal">'</span><span class="RktVal">c</span>, adding new elements <span class="RktVal">'</span><span class="RktVal">d</span> and <span class="RktVal">'</span><span class="RktVal">e</span> using the
+addition mask <span class="RktVal">#b100100</span> produces a stencil vector whose
+mask is <span class="RktVal">#b111101</span> and whose elements in order are
+<span class="RktVal">'</span><span class="RktVal">a</span>, <span class="RktVal">'</span><span class="RktVal">b</span>, <span class="RktVal">'</span><span class="RktVal">d</span>, <span class="RktVal">'</span><span class="RktVal">c</span>, and <span class="RktVal">'</span><span class="RktVal">e</span>.</p><p>The maximum size of a stencil vector is 58 elements on a 64-bit
+platform and 26 elements on a 32-bit platform. This limited size
+enables a compact internal representation and ensures that update
+operations are relatively simple. Stencil vectors are mutable,
+although they are intended primarily for use without mutation to
+implement a persistent data structure.</p><p>Two stencil vectors are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> if they have the same mask,
+and if the values in corresponding slots of the stencil vectors are
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>.</p><p>A printed vector starts with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&lt;stencil ...&gt;</span><span class="hspace"></span></span>, and this
+printed form cannot be parsed by <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>. The
+<span class="RktSym"><a href="fasl.html#%28def._%28%28lib._racket%2Ffasl..rkt%29._s-exp-~3efasl%29%29" class="RktValLink" data-pltdoc="x">s-exp-&gt;fasl</a></span> and <span class="RktSym"><a href="serialization.html#%28def._%28%28lib._racket%2Fprivate%2Fserialize..rkt%29._serialize%29%29" class="RktValLink" data-pltdoc="x">serialize</a></span> functions do not support
+stencil vectors, in part because a stencil vector on a 64-bit platform
+might not be representable on a 32-bit platform. The intent is that
+stencil vectors are used as an in-memory representation for a datatype
+implementation.</p><p class="SHistory">Added in version 8.5.0.7 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._stencil-vector~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">stencil-vector?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="stencil_vectors.html#%28tech._stencil._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">stencil vector</span></a>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktMeta">stencil-vector</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">#b10010</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">a</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">b</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><p><span class="RktRes">#&lt;stencil 18: a b&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktMeta">stencil-vector</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">#b111</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">a</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">b</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">c</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><p><span class="RktRes">#&lt;stencil 7: a b c&gt;</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 8.5.0.7 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._stencil-vector-mask-width))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-mask-width%29%29" class="RktValDef RktValLink" data-pltdoc="x">stencil-vector-mask-width</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns the maximum number of elements allowed in a stencil vector on
+the current platform. The result is <span class="RktVal">58</span> on a 64-bit platform
+or <span class="RktVal">26</span> on a 32-bit platform.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._stencil-vector))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector%29%29" class="RktValDef RktValLink" data-pltdoc="x">stencil-vector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">mask</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector~3f%29%29" class="RktValLink" data-pltdoc="x">stencil-vector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mask</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-mask-width%29%29" class="RktValLink" data-pltdoc="x">stencil-vector-mask-width</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a stencil vector combining <span class="RktVar">mask</span> with elements
+<span class="RktVar">v</span>. The number of supplied <span class="RktVar">v</span>s must match the number
+of bits set in <span class="RktVar">mask</span>&rsquo;s two&rsquo;s complement representation.</div></p><p class="SHistory">Added in version 8.5.0.7 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._stencil-vector-mask))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-mask%29%29" class="RktValDef RktValLink" data-pltdoc="x">stencil-vector-mask</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-mask-width%29%29" class="RktValLink" data-pltdoc="x">stencil-vector-mask-width</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector~3f%29%29" class="RktValLink" data-pltdoc="x">stencil-vector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the mask of <span class="RktVar">vec</span>. Note that the mask of a stencil
+vector is determined at creation time and cannot be changed later.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktMeta">stencil-vector-mask</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktMeta">stencil-vector</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">#b10010</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">a</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><p><span class="RktRes">18</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 8.5.0.7 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._stencil-vector-length))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">stencil-vector-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-mask-width%29%29" class="RktValLink" data-pltdoc="x">stencil-vector-mask-width</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector~3f%29%29" class="RktValLink" data-pltdoc="x">stencil-vector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the length of <span class="RktVar">vec</span> (i.e., the number of slots in the
+vector). The result is the same as <span class="RktPn">(</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxpopcount%29%29" class="RktValLink" data-pltdoc="x">fxpopcount</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-mask%29%29" class="RktValLink" data-pltdoc="x">stencil-vector-mask</a></span><span class="stt"> </span><span class="RktVar">vec</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktMeta">stencil-vector-length</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktMeta">stencil-vector</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">#b10010</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">a</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 8.5.0.7 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._stencil-vector-ref))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">stencil-vector-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector~3f%29%29" class="RktValLink" data-pltdoc="x">stencil-vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the element in slot <span class="RktVar">pos</span> of <span class="RktVar">vec</span>. The first
+slot is position <span class="RktVal">0</span>, and the last slot is one less than
+<span class="RktPn">(</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-length%29%29" class="RktValLink" data-pltdoc="x">stencil-vector-length</a></span><span class="stt"> </span><span class="RktVar">vec</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktMeta">stencil-vector-ref</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktMeta">stencil-vector</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">#b10010</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">a</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">b</span><span class="RktPn">)</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><p><span class="RktRes">'b</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktMeta">stencil-vector-ref</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktMeta">stencil-vector</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">#b111</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">a</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">b</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">c</span><span class="RktPn">)</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><p><span class="RktRes">'b</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 8.5.0.7 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._stencil-vector-set!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">stencil-vector-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym">avoid?</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector~3f%29%29" class="RktValLink" data-pltdoc="x">stencil-vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Updates the slot <span class="RktVar">pos</span> of <span class="RktVar">vec</span> to contain <span class="RktVar">v</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktMeta">define</span><span class="hspace">&nbsp;</span><span class="RktMeta">st-vec</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktMeta">stencil-vector</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">#b101</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">a</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktMeta">st-vec</span></td></tr><tr><td><p><span class="RktRes">#&lt;stencil 5: a b&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktMeta">stencil-vector-set!</span><span class="hspace">&nbsp;</span><span class="RktMeta">st-vec</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">1</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">c</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktMeta">st-vec</span></td></tr><tr><td><p><span class="RktRes">#&lt;stencil 5: a c&gt;</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 8.5.0.7 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._stencil-vector-update))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-update%29%29" class="RktValDef RktValLink" data-pltdoc="x">stencil-vector-update</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">vec</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">remove-mask</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">add-mask</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector~3f%29%29" class="RktValLink" data-pltdoc="x">stencil-vector?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector~3f%29%29" class="RktValLink" data-pltdoc="x">stencil-vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">remove-mask</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-mask-width%29%29" class="RktValLink" data-pltdoc="x">stencil-vector-mask-width</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">add-mask</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-mask-width%29%29" class="RktValLink" data-pltdoc="x">stencil-vector-mask-width</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a stencil vector that is like <span class="RktVar">vec</span>, but with elements
+corresponding to <span class="RktVar">remove-mask</span> removed, and with the given
+<span class="RktVar">v</span>s added at positions relative to existing (unremoved)
+elements determined by <span class="RktVar">add-mask</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktMeta">define</span><span class="hspace">&nbsp;</span><span class="RktMeta">st-vec</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktMeta">stencil-vector</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">#b101</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">a</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktMeta">stencil-vector-update</span><span class="hspace">&nbsp;</span><span class="RktMeta">st-vec</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">#b0</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">#b10</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">c</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><p><span class="RktRes">#&lt;stencil 7: a c b&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktMeta">stencil-vector-update</span><span class="hspace">&nbsp;</span><span class="RktMeta">st-vec</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">#b0</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">#b1000</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">c</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><p><span class="RktRes">#&lt;stencil 13: a b c&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktMeta">st-vec</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktCmt">;</span><span class="hspace">&nbsp;</span><span class="RktCmt">unchanged</span><span class="hspace">&nbsp;</span><span class="RktCmt">by</span><span class="hspace">&nbsp;</span><span class="RktCmt">updates</span><span class="RktMeta"></span></td></tr><tr><td><p><span class="RktRes">#&lt;stencil 5: a b&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktMeta">stencil-vector-update</span><span class="hspace">&nbsp;</span><span class="RktMeta">st-vec</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">#b1</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">#b1</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">c</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><p><span class="RktRes">#&lt;stencil 5: c b&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktMeta">stencil-vector-update</span><span class="hspace">&nbsp;</span><span class="RktMeta">st-vec</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">#b100</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">#b100</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">'</span><span class="RktMeta">c</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><p><span class="RktRes">#&lt;stencil 5: a c&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktMeta">stencil-vector-update</span><span class="hspace">&nbsp;</span><span class="RktMeta">st-vec</span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">#b100</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">#b0</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><p><span class="RktRes">#&lt;stencil 1: a&gt;</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 8.5.0.7 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="vectors.html" title="backward to &quot;4.12 Vectors&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="boxes.html" title="forward to &quot;4.14 Boxes&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/stratified-body.html b/clones/docs.racket-lang.org/reference/stratified-body.html
new file mode 100644
index 00000000..1e7a34ee
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/stratified-body.html
@@ -0,0 +1,9 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.24&nbsp;Internal-Definition Limiting: #%stratified-body</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewselflink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="stratified-body.html#%28form._%28%28quote._~23~25kernel%29._~23~25stratified-body%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="block.html" title="backward to &quot;3.23 Blocks: block&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="performance-hint.html" title="forward to &quot;3.25 Performance Hints: begin-encourage-inline&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;stratified-body&quot;">3.24<tt>&nbsp;</tt><a name="(part._stratified-body)"></a>Internal-Definition Limiting: <span class="RktSym"><a href="stratified-body.html#%28form._%28%28quote._~23~25kernel%29._~23~25stratified-body%29%29" class="RktStxLink" data-pltdoc="x">#%stratified-body</a></span></h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._~23~25stratified-body))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stratified-body.html#%28form._%28%28quote._~23~25kernel%29._~23~25stratified-body%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">#%stratified-body</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">defn-or-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">defn-or-expr</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> for an
+<a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a> sequence, except that an expression
+is not allowed to precede a definition, and all definitions are
+treated as referring to all other definitions (i.e., <a href="eval-model.html#%28tech._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">locations</span></a>
+for variables are all allocated first, like <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec%29%29" class="RktStxLink" data-pltdoc="x">letrec</a></span> and
+unlike <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span>).</div></p><p>The <span class="RktSym"><a href="stratified-body.html#%28form._%28%28quote._~23~25kernel%29._~23~25stratified-body%29%29" class="RktStxLink" data-pltdoc="x">#%stratified-body</a></span> form is useful for implementing
+syntactic forms or languages that supply a more limited kind of
+<a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="block.html" title="backward to &quot;3.23 Blocks: block&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="performance-hint.html" title="forward to &quot;3.25 Performance Hints: begin-encourage-inline&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/streams.html b/clones/docs.racket-lang.org/reference/streams.html
new file mode 100644
index 00000000..e450899c
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/streams.html
@@ -0,0 +1,104 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.16.2&nbsp;Streams</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewselflink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.16.1&nbsp;</td><td><a href="sequences.html" class="tocviewlink" data-pltdoc="x">Sequences</a></td></tr><tr><td align="right">4.16.2&nbsp;</td><td><a href="streams.html" class="tocviewselflink" data-pltdoc="x">Streams</a></td></tr><tr><td align="right">4.16.3&nbsp;</td><td><a href="Generators.html" class="tocviewlink" data-pltdoc="x">Generators</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream?</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-empty~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-<wbr></wbr>empty?</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-first%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-<wbr></wbr>first</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-rest%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-<wbr></wbr>rest</span></span></a></td></tr><tr><td><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream-cons%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">stream-<wbr></wbr>cons</span></span></a></td></tr><tr><td><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream-lazy%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">stream-<wbr></wbr>lazy</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-force%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-<wbr></wbr>force</span></span></a></td></tr><tr><td><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">stream</span></span></a></td></tr><tr><td><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream%2A%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">stream*</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._in-stream%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">in-<wbr></wbr>stream</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._empty-stream%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">empty-<wbr></wbr>stream</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-~3elist%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-<wbr></wbr>&gt;list</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-length%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-ref%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-tail%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-<wbr></wbr>tail</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-take%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-<wbr></wbr>take</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-append%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-<wbr></wbr>append</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-map%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-<wbr></wbr>map</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-andmap%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-<wbr></wbr>andmap</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-ormap%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-<wbr></wbr>ormap</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-for-each%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-<wbr></wbr>for-<wbr></wbr>each</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-fold%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-<wbr></wbr>fold</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-count%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-<wbr></wbr>count</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-filter%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-<wbr></wbr>filter</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-add-between%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream-<wbr></wbr>add-<wbr></wbr>between</span></span></a></td></tr><tr><td><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._for%2Fstream%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>stream</span></span></a></td></tr><tr><td><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._for%2A%2Fstream%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>stream</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._gen~3astream%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">gen:<span class="mywbr"> &nbsp;</span>stream</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._prop~3astream%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>stream</span></span></a></td></tr><tr><td><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">stream/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="sequences.html" title="backward to &quot;4.16.1 Sequences&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="sequences_streams.html" title="up to &quot;4.16 Sequences and Streams&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Generators.html" title="forward to &quot;4.16.3 Generators&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;streams&quot;">4.16.2<tt>&nbsp;</tt><a name="(part._streams)"></a><a name="(mod-path._racket/stream)"></a>Streams</h5><p>A <a name="(tech._stream)"></a><span style="font-style: italic">stream</span> is a kind of <a href="sequences.html#%28tech._sequence%29" class="techoutside" data-pltdoc="x"><span class="techinside">sequence</span></a> that supports
+functional iteration via <span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-first%29%29" class="RktValLink" data-pltdoc="x">stream-first</a></span> and
+<span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-rest%29%29" class="RktValLink" data-pltdoc="x">stream-rest</a></span>.  The <span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream-cons%29%29" class="RktStxLink" data-pltdoc="x">stream-cons</a></span> form constructs a lazy
+stream, but plain lists can be used as streams, and functions such as
+<span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span> and <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-naturals%29%29" class="RktValLink" data-pltdoc="x">in-naturals</a></span> also create streams.</p><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="streams.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/stream</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="streams.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/stream</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stream..rkt)._stream~3f))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">stream?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> can be used as a <a href="streams.html#%28tech._stream%29" class="techoutside" data-pltdoc="x"><span class="techinside">stream</span></a>,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stream..rkt)._stream-empty~3f))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-empty~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">stream-empty?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">s</span> has no elements, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stream..rkt)._stream-first))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-first%29%29" class="RktValDef RktValLink" data-pltdoc="x">stream-first</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-empty~3f%29%29" class="RktValLink" data-pltdoc="x">stream-empty?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the value(s) of the first element in <span class="RktVar">s</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stream..rkt)._stream-rest))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-rest%29%29" class="RktValDef RktValLink" data-pltdoc="x">stream-rest</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-empty~3f%29%29" class="RktValLink" data-pltdoc="x">stream-empty?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a stream that is equivalent to <span class="RktVar">s</span> without its first
+element.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/stream..rkt)._stream-cons))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream-cons%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">stream-cons</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">first-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">rest-expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream-cons%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">stream-cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:eager</span><span class="hspace">&nbsp;</span><span class="RktVar">first-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">rest-expr</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream-cons%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">stream-cons</a></span><span class="hspace">&nbsp;</span><span class="RktVar">first-expr</span><span class="hspace">&nbsp;</span><span class="RktPn">#:eager</span><span class="hspace">&nbsp;</span><span class="RktVar">rest-expr</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream-cons%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">stream-cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:eager</span><span class="hspace">&nbsp;</span><span class="RktVar">first-expr</span><span class="hspace">&nbsp;</span><span class="RktPn">#:eager</span><span class="hspace">&nbsp;</span><span class="RktVar">rest-expr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a stream whose first element is determined by
+<span class="RktVar">first-expr</span> and whose rest is determined by
+<span class="RktVar">rest-expr</span>.</div></p><p>If <span class="RktVar">first-expr</span> is not preceded by <span class="RktPn">#:eager</span>, then
+<span class="RktVar">first-expr</span> is not evaluated immediately. Instead,
+<span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-first%29%29" class="RktValLink" data-pltdoc="x">stream-first</a></span> on the result stream forces the evaluation of
+<span class="RktVar">first-expr</span> (once) to produce the first element of the
+stream. If evaluating <span class="RktVar">first-expr</span> raises an exception or
+tries to force itself, then an <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised, and
+future attempts to force evaluation will trigger another exception.</p><p>If <span class="RktVar">rest-expr</span> is not preceded by <span class="RktPn">#:eager</span>, then
+<span class="RktVar">rest-expr</span> is not evaluated immediately. Instead,
+<span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-rest%29%29" class="RktValLink" data-pltdoc="x">stream-rest</a></span> on the result stream produces another stream
+that is like the one produced by <span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream-lazy%29%29" class="RktStxLink" data-pltdoc="x">stream-lazy</a></span><span class="stt"> </span><span class="RktVar">rest-expr</span><span class="RktPn">)</span>.</p><p>The first element of the stream as produced by <span class="RktVar">first-expr</span>
+must be a single value. The <span class="RktVar">rest-expr</span> must produce a stream
+when it is evaluated, otherwise the <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._exn~3afail~3acontract~3f%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract?</a></span> exception is raised.</p><p class="SHistory">Changed in version 8.0.0.12 of package <span class="stt">base</span>: Added <span class="RktPn">#:eager</span> options.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/stream..rkt)._stream-lazy))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream-lazy%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">stream-lazy</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stream-expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream-lazy%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">stream-lazy</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:who</span><span class="hspace">&nbsp;</span><span class="RktVar">who-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">stream-expr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktPn">(</span><span class="RktSym"><a href="Delayed_Evaluation.html#%28form._%28%28lib._racket%2Fpromise..rkt%29._delay%29%29" class="RktStxLink" data-pltdoc="x">delay</a></span><span class="stt"> </span><span class="RktVar">stream-expr</span><span class="RktPn">)</span>, but the result is a stream
+instead of a <a href="Delayed_Evaluation.html#%28tech._promise%29" class="techoutside" data-pltdoc="x"><span class="techinside">promise</span></a>, and <span class="RktVar">stream-expr</span> must produce a
+stream when it is eventually forced. The stream produced by
+<span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream-lazy%29%29" class="RktStxLink" data-pltdoc="x">stream-lazy</a></span> has the same content as the stream produced by
+<span class="RktVar">stream-expr</span>; that is, operations like <span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-first%29%29" class="RktValLink" data-pltdoc="x">stream-first</a></span>
+on the result stream will force <span class="RktVar">stream-expr</span> and retry on its
+result.</div></p><p>If evaluating <span class="RktVar">stream-expr</span> raises an exception or tries to
+force itself, then an <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised, and future
+attempts to force evaluation will trigger another exception.</p><p>If <span class="RktVar">who-expr</span> is provided, it is evaluated when constructing
+the delayed stream. If <span class="RktVar">stream-expr</span> later produces a value
+that is not a stream, and if <span class="RktVar">who-expr</span> produced a symbol
+value, then the symbol is used for the error message.</p><p class="SHistory">Added in version 8.0.0.12 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stream..rkt)._stream-force))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-force%29%29" class="RktValDef RktValLink" data-pltdoc="x">stream-force</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Forces the evaluation of a delayed stream from <span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream-lazy%29%29" class="RktStxLink" data-pltdoc="x">stream-lazy</a></span>,
+from the <span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-rest%29%29" class="RktValLink" data-pltdoc="x">stream-rest</a></span> of a <span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream-cons%29%29" class="RktStxLink" data-pltdoc="x">stream-cons</a></span>, etc.,
+returning the forced stream. If <span class="RktVar">s</span> is not a delayed stream,
+then <span class="RktVar">s</span> is returned.</div></p><p>Normally, <span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-force%29%29" class="RktValLink" data-pltdoc="x">stream-force</a></span> is not needed, because operations
+like <span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-first%29%29" class="RktValLink" data-pltdoc="x">stream-first</a></span>, <span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-rest%29%29" class="RktValLink" data-pltdoc="x">stream-rest</a></span>, and
+<span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-empty~3f%29%29" class="RktValLink" data-pltdoc="x">stream-empty?</a></span> force a delayed stream as needed. In rare
+cases, <span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-force%29%29" class="RktValLink" data-pltdoc="x">stream-force</a></span> can be useful to reveal the underlying
+implementation of a stream (e.g., a stream that is an instance of a
+structure type that has the <span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._prop~3astream%29%29" class="RktValLink" data-pltdoc="x">prop:stream</a></span> property).</p><p class="SHistory">Added in version 8.0.0.12 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/stream..rkt)._stream))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">stream</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">e</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A shorthand for nested <span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream-cons%29%29" class="RktStxLink" data-pltdoc="x">stream-cons</a></span>es ending with
+<span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._empty-stream%29%29" class="RktValLink" data-pltdoc="x">empty-stream</a></span>. As a match pattern, <span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream%29%29" class="RktStxLink" data-pltdoc="x">stream</a></span>
+matches a stream with as many elements as <span class="RktVar">e</span>s,
+and each element must match the corresponding <span class="RktVar">e</span> pattern.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/stream..rkt)._stream*))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">stream*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">e</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">tail</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A shorthand for nested <span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream-cons%29%29" class="RktStxLink" data-pltdoc="x">stream-cons</a></span>es, but the <span class="RktVar">tail</span>
+  must produce a stream when it is forced, and that stream is used as the rest of the stream instead of
+  <span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._empty-stream%29%29" class="RktValLink" data-pltdoc="x">empty-stream</a></span>. Similar to <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%2A%29%29" class="RktValLink" data-pltdoc="x">list*</a></span> but for streams.
+  As a match pattern, <span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream%2A%29%29" class="RktStxLink" data-pltdoc="x">stream*</a></span> is similar to a <span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream%29%29" class="RktStxLink" data-pltdoc="x">stream</a></span> pattern,
+  but the <span class="RktVar">tail</span> pattern matches the &ldquo;rest&rdquo; of the stream after the last <span class="RktVar">e</span>.</div></p><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.<br/>Changed in version 8.0.0.12: Changed to delay <span class="RktSym">rest-expr</span> even
+if zero <span class="RktSym">expr</span>s are provided.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stream..rkt)._in-stream))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._in-stream%29%29" class="RktValDef RktValLink" data-pltdoc="x">in-stream</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a sequence that is equivalent to <span class="RktVar">s</span>.
+  </div><div class="SIntrapara">An <span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._in-stream%29%29" class="RktValLink" data-pltdoc="x">in-stream</a></span> application can provide better performance for streams iteration when it appears directly in a <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> clause.</div><div class="SIntrapara">See <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> for information on the reachability of stream elements
+during an iteration.</div></p><p class="SHistory">Changed in version 6.7.0.4 of package <span class="stt">base</span>: Improved element-reachability guarantee for streams in <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/stream..rkt)._empty-stream))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._empty-stream%29%29" class="RktValDef RktValLink" data-pltdoc="x">empty-stream</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A stream with no elements.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stream..rkt)._stream-~3elist))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-~3elist%29%29" class="RktValDef RktValLink" data-pltdoc="x">stream-&gt;list</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list whose elements are the elements of <span class="RktVar">s</span>, each
+of which must be a single value.  If <span class="RktVar">s</span> is infinite, this
+function does not terminate.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stream..rkt)._stream-length))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">stream-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the number of elements of <span class="RktVar">s</span>.  If <span class="RktVar">s</span> is
+infinite, this function does not terminate.</div></p><p>In the case of lazy streams, this function forces evaluation only of
+the sub-streams, and not the stream&rsquo;s elements.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stream..rkt)._stream-ref))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">stream-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span><span class="RktVar">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">i</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <span class="RktVar">i</span>th element of <span class="RktVar">s</span> (which may be
+multiple values).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stream..rkt)._stream-tail))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-tail%29%29" class="RktValDef RktValLink" data-pltdoc="x">stream-tail</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span><span class="RktVar">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">i</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a stream equivalent to <span class="RktVar">s</span>, except that the first
+<span class="RktVar">i</span> elements are omitted.</div></p><p>In case extracting elements from <span class="RktVar">s</span> involves a side effect,
+they will not be extracted until the first element is extracted from
+the resulting stream.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stream..rkt)._stream-take))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-take%29%29" class="RktValDef RktValLink" data-pltdoc="x">stream-take</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span><span class="RktVar">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">i</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a stream of the first <span class="RktVar">i</span> elements of <span class="RktVar">s</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stream..rkt)._stream-append))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-append%29%29" class="RktValDef RktValLink" data-pltdoc="x">stream-append</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a stream that contains all elements of each stream in the
+order they appear in the original streams.  The new stream is
+constructed lazily, while the last given stream is used in the tail
+of the result.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stream..rkt)._stream-map))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-map%29%29" class="RktValDef RktValLink" data-pltdoc="x">stream-map</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a stream that contains <span class="RktVar">f</span> applied to each element of
+<span class="RktVar">s</span>.  The new stream is constructed lazily.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stream..rkt)._stream-andmap))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-andmap%29%29" class="RktValDef RktValLink" data-pltdoc="x">stream-andmap</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">f</span> returns a true result on every
+element of <span class="RktVar">s</span>.  If <span class="RktVar">s</span> is infinite and <span class="RktVar">f</span>
+never returns a false result, this function does not terminate.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stream..rkt)._stream-ormap))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-ormap%29%29" class="RktValDef RktValLink" data-pltdoc="x">stream-ormap</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">f</span> returns a true result on some
+element of <span class="RktVar">s</span>.  If <span class="RktVar">s</span> is infinite and <span class="RktVar">f</span>
+never returns a true result, this function does not terminate.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stream..rkt)._stream-for-each))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-for-each%29%29" class="RktValDef RktValLink" data-pltdoc="x">stream-for-each</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Applies <span class="RktVar">f</span> to each element of <span class="RktVar">s</span>.  If <span class="RktVar">s</span> is
+infinite, this function does not terminate.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stream..rkt)._stream-fold))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-fold%29%29" class="RktValDef RktValLink" data-pltdoc="x">stream-fold</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVar">i</span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">i</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Folds <span class="RktVar">f</span> over each element of <span class="RktVar">s</span> with <span class="RktVar">i</span> as
+the initial accumulator.  If <span class="RktVar">s</span> is infinite, this function
+does not terminate. The <span class="RktVar">f</span> function takes the accumulator as
+its first argument and the next stream element as its second.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stream..rkt)._stream-count))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-count%29%29" class="RktValDef RktValLink" data-pltdoc="x">stream-count</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the number of elements in <span class="RktVar">s</span> for which <span class="RktVar">f</span>
+returns a true result.  If <span class="RktVar">s</span> is infinite, this function
+does not terminate.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stream..rkt)._stream-filter))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-filter%29%29" class="RktValDef RktValLink" data-pltdoc="x">stream-filter</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">f</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a stream whose elements are the elements of <span class="RktVar">s</span> for
+which <span class="RktVar">f</span> returns a true result.  Although the new stream is
+constructed lazily, if <span class="RktVar">s</span> has an infinite number of elements
+where <span class="RktVar">f</span> returns a false result in between two elements
+where <span class="RktVar">f</span> returns a true result, then operations on this
+stream will not terminate during the infinite sub-stream.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stream..rkt)._stream-add-between))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-add-between%29%29" class="RktValDef RktValLink" data-pltdoc="x">stream-add-between</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span><span class="RktVar">e</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">e</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a stream whose elements are the elements of <span class="RktVar">s</span>, but
+with <span class="RktVar">e</span> between each pair of elements in <span class="RktVar">s</span>.  The
+new stream is constructed lazily.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/stream..rkt)._for/stream))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._for%2Fstream%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for/stream</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/stream..rkt)._for*/stream))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._for%2A%2Fstream%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">for*/stream</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">for-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Iterates like <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span> and <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2A%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for*/list</a></span>, respectively, but the
+results are lazily collected into a <a href="streams.html#%28tech._stream%29" class="techoutside" data-pltdoc="x"><span class="techinside">stream</span></a> instead of a list.</div></p><p>Unlike most <span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span> forms, these forms are evaluated lazily, so each
+<span class="RktVar">body</span> will not be evaluated until the resulting stream is forced. This
+allows <span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._for%2Fstream%29%29" class="RktStxLink" data-pltdoc="x">for/stream</a></span> and <span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._for%2A%2Fstream%29%29" class="RktStxLink" data-pltdoc="x">for*/stream</a></span> to iterate over infinite
+sequences, unlike their finite counterparts.</p><p>Please note that these forms do not support returning <a href="eval-model.html#%28tech._multiple._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">multiple values</span></a>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._for%2Fstream%29%29" class="RktStxLink" data-pltdoc="x">for/stream</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;stream&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-~3elist%29%29" class="RktValLink" data-pltdoc="x">stream-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._for%2Fstream%29%29" class="RktStxLink" data-pltdoc="x">for/stream</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 4 9)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-ref%29%29" class="RktValLink" data-pltdoc="x">stream-ref</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._for%2Fstream%29%29" class="RktStxLink" data-pltdoc="x">for/stream</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">2</span></p></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-ref%29%29" class="RktValLink" data-pltdoc="x">stream-ref</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._for%2Fstream%29%29" class="RktStxLink" data-pltdoc="x">for/stream</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-naturals%29%29" class="RktValLink" data-pltdoc="x">in-naturals</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">25</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">625</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.3.0.9 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/stream..rkt)._gen~3astream))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._gen~3astream%29%29" class="RktValDef RktValLink" data-pltdoc="x">gen:stream</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Associates three methods to a structure type to implement the
+<a href="struct-generics.html#%28tech._generic._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">generic interface</span></a> (see <a href="struct-generics.html" data-pltdoc="x">Generic Interfaces</a>) for
+streams.</div></p><p>To supply method implementations, the <span class="RktPn">#:methods</span> keyword
+should be used in a structure type definition. The following three
+methods should be implemented:</p><ul><li><p><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-empty~3f%29%29" class="RktValLink" data-pltdoc="x">stream-empty?</a></span> : accepts one argument</p></li><li><p><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-first%29%29" class="RktValLink" data-pltdoc="x">stream-first</a></span> : accepts one argument</p></li><li><p><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-rest%29%29" class="RktValLink" data-pltdoc="x">stream-rest</a></span> : accepts one argument</p></li></ul><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">list-stream</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._gen~3astream%29%29" class="RktValLink" data-pltdoc="x">gen:stream</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-empty~3f%29%29" class="RktValLink" data-pltdoc="x">stream-empty?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream%29%29" class="RktStxLink" data-pltdoc="x">stream</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._empty~3f%29%29" class="RktValLink" data-pltdoc="x">empty?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">list-stream-v</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream%29%29" class="RktStxLink" data-pltdoc="x">stream</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-first%29%29" class="RktValLink" data-pltdoc="x">stream-first</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream%29%29" class="RktStxLink" data-pltdoc="x">stream</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._first%29%29" class="RktValLink" data-pltdoc="x">first</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">list-stream-v</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream%29%29" class="RktStxLink" data-pltdoc="x">stream</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-rest%29%29" class="RktValLink" data-pltdoc="x">stream-rest</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream%29%29" class="RktStxLink" data-pltdoc="x">stream</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">list-stream</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">list-stream-v</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream%29%29" class="RktStxLink" data-pltdoc="x">stream</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">list-stream</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream~3f%29%29" class="RktValLink" data-pltdoc="x">stream?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream-first%29%29" class="RktValLink" data-pltdoc="x">stream-first</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/stream..rkt)._prop~3astream))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._prop~3astream%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:stream</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A structure type property used to define custom
+extensions to the stream API. Using the <span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._prop~3astream%29%29" class="RktValLink" data-pltdoc="x">prop:stream</a></span> property
+is discouraged; use the <span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._gen~3astream%29%29" class="RktValLink" data-pltdoc="x">gen:stream</a></span> <a href="struct-generics.html#%28tech._generic._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">generic interface</span></a>
+instead. Accepts a vector of three procedures taking the same arguments
+as the methods in <span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._gen~3astream%29%29" class="RktValLink" data-pltdoc="x">gen:stream</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stream..rkt)._stream/c))"></a><span title="Provided from: racket/stream, racket | Package: base"><span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream%2Fc%29%29" class="RktValDef RktValLink" data-pltdoc="x">stream/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">c</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a contract that recognizes streams. All elements of the stream must match
+<span class="RktVar">c</span>.</div></p><p>If the <span class="RktVar">c</span> argument is a flat contract or a chaperone contract, then the
+result will be a chaperone contract. Otherwise, the result will be an
+impersonator contract.</p><p>When an <span class="RktSym"><a href="streams.html#%28def._%28%28lib._racket%2Fstream..rkt%29._stream%2Fc%29%29" class="RktValLink" data-pltdoc="x">stream/c</a></span> contract is applied to a stream, the result is not
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to the input. The result will be either a <a href="chaperones.html#%28tech._chaperone%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone</span></a> or
+<a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a> of the input depending on the type of contract.</p><p>Contracts on streams are evaluated lazily by necessity (since streams may be
+infinite). Contract violations will not be raised until the value in violation
+is retrieved from the stream. As an exception to this rule, streams that are
+lists are checked immediately, as if <span class="RktVar">c</span> had been used with
+<span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span>.</p><p>If a contract is applied to a stream, and that stream is subsequently used as
+the tail of another stream (as the second parameter to <span class="RktSym"><a href="streams.html#%28form._%28%28lib._racket%2Fstream..rkt%29._stream-cons%29%29" class="RktStxLink" data-pltdoc="x">stream-cons</a></span>),
+the new elements will not be checked with the contract, but the tail&rsquo;s elements
+will still be enforced.</p><p class="SHistory">Added in version 6.1.1.8 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="sequences.html" title="backward to &quot;4.16.1 Sequences&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="sequences_streams.html" title="up to &quot;4.16 Sequences and Streams&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Generators.html" title="forward to &quot;4.16.3 Generators&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/stringport.html b/clones/docs.racket-lang.org/reference/stringport.html
new file mode 100644
index 00000000..91945ec9
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/stringport.html
@@ -0,0 +1,36 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13.1.6&nbsp;String Ports</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="ports.html" class="tocviewselflink" data-pltdoc="x">Ports</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="Byte_and_String_Input.html" class="tocviewlink" data-pltdoc="x">Byte and String Input</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="Byte_and_String_Output.html" class="tocviewlink" data-pltdoc="x">Byte and String Output</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="Reading.html" class="tocviewlink" data-pltdoc="x">Reading</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="Writing.html" class="tocviewlink" data-pltdoc="x">Writing</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="pretty-print.html" class="tocviewlink" data-pltdoc="x">Pretty Printing</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="Reader_Extension.html" class="tocviewlink" data-pltdoc="x">Reader Extension</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="Printer_Extension.html" class="tocviewlink" data-pltdoc="x">Printer Extension</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Serialization</a></td></tr><tr><td align="right">13.10&nbsp;</td><td><a href="fasl.html" class="tocviewlink" data-pltdoc="x">Fast-<wbr></wbr>Load Serialization</a></td></tr><tr><td align="right">13.11&nbsp;</td><td><a href="sha.html" class="tocviewlink" data-pltdoc="x">Cryptographic Hashing</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>13.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Ports</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1.1&nbsp;</td><td><a href="encodings.html" class="tocviewlink" data-pltdoc="x">Encodings and Locales</a></td></tr><tr><td align="right">13.1.2&nbsp;</td><td><a href="port-ops.html" class="tocviewlink" data-pltdoc="x">Managing Ports</a></td></tr><tr><td align="right">13.1.3&nbsp;</td><td><a href="port-buffers.html" class="tocviewlink" data-pltdoc="x">Port Buffers and Positions</a></td></tr><tr><td align="right">13.1.4&nbsp;</td><td><a href="linecol.html" class="tocviewlink" data-pltdoc="x">Counting Positions, Lines, and Columns</a></td></tr><tr><td align="right">13.1.5&nbsp;</td><td><a href="file-ports.html" class="tocviewlink" data-pltdoc="x">File Ports</a></td></tr><tr><td align="right">13.1.6&nbsp;</td><td><a href="stringport.html" class="tocviewselflink" data-pltdoc="x">String Ports</a></td></tr><tr><td align="right">13.1.7&nbsp;</td><td><a href="pipeports.html" class="tocviewlink" data-pltdoc="x">Pipes</a></td></tr><tr><td align="right">13.1.8&nbsp;</td><td><a href="portstructs.html" class="tocviewlink" data-pltdoc="x">Structures as Ports</a></td></tr><tr><td align="right">13.1.9&nbsp;</td><td><a href="customport.html" class="tocviewlink" data-pltdoc="x">Custom Ports</a></td></tr><tr><td align="right">13.1.10&nbsp;</td><td><a href="port-lib.html" class="tocviewlink" data-pltdoc="x">More Port Constructors, Procedures, and Events</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._string-port~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>port?</span></span></a></td></tr><tr><td><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-bytes%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">open-<wbr></wbr>input-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">open-<wbr></wbr>input-<wbr></wbr>string</span></span></a></td></tr><tr><td><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-bytes%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">open-<wbr></wbr>output-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-string%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">open-<wbr></wbr>output-<wbr></wbr>string</span></span></a></td></tr><tr><td><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-bytes%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get-<wbr></wbr>output-<wbr></wbr>bytes</span></span></a></td></tr><tr><td><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-string%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">get-<wbr></wbr>output-<wbr></wbr>string</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="file-ports.html" title="backward to &quot;13.1.5 File Ports&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ports.html" title="up to &quot;13.1 Ports&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="pipeports.html" title="forward to &quot;13.1.7 Pipes&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;stringport&quot;">13.1.6<tt>&nbsp;</tt><a name="(part._stringport)"></a>String Ports</h5><p>A <a name="(tech._string._port)"></a><span style="font-style: italic">string port</span> reads or writes from a <a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte string</span></a>. An
+input <a href="stringport.html#%28tech._string._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">string port</span></a> can be created from either a <a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte string</span></a>
+or a <a href="strings.html#%28tech._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">string</span></a>; in the latter case, the <a href="strings.html#%28tech._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">string</span></a> is effectively
+converted to a <a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte string</span></a> using <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Futf-8%29%29" class="RktValLink" data-pltdoc="x">string-&gt;bytes/utf-8</a></span>. An
+output <a href="stringport.html#%28tech._string._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">string port</span></a> collects output into a <a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte string</span></a>, but
+<span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-string%29%29" class="RktValLink" data-pltdoc="x">get-output-string</a></span> conveniently converts the accumulated bytes
+to a <a href="strings.html#%28tech._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">string</span></a>.</p><p>Input and output <a href="stringport.html#%28tech._string._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">string ports</span></a> do not need to be explicitly
+closed. The <span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-position%29%29" class="RktValLink" data-pltdoc="x">file-position</a></span> procedure works for <a href="stringport.html#%28tech._string._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">string
+ports</span></a> in position-setting mode.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="bytestrings.html" data-pltdoc="x">Byte Strings</a> also provides information on bytestrings.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-port~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._string-port~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-port?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._port~3f%29%29" class="RktValLink" data-pltdoc="x">port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">p</span> is a <a href="stringport.html#%28tech._string._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">string port</span></a>, <span class="RktVal">#f</span>
+otherwise.</div></p><p class="SHistory">Added in version 6.0.1.6 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._open-input-bytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">open-input-bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">name</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._string-port~3f%29%29" class="RktValLink" data-pltdoc="x">string-port?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">string</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates an input <a href="stringport.html#%28tech._string._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">string port</span></a> that reads characters from
+<span class="RktVar">bstr</span> (see <a href="bytestrings.html" data-pltdoc="x">Byte Strings</a>). Modifying <span class="RktVar">bstr</span>
+afterward does not affect the byte stream produced by the port. The
+optional <span class="RktVar">name</span> argument is used as the name for the returned
+port.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sp</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-bytes%29%29" class="RktValLink" data-pltdoc="x">open-input-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"(apples 42 day)"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sexp1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sp</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._first%29%29" class="RktValLink" data-pltdoc="x">first</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sexp1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'apples</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._rest%29%29" class="RktValLink" data-pltdoc="x">rest</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sexp1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(42 day)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="RktValLink" data-pltdoc="x">read-line</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-bytes%29%29" class="RktValLink" data-pltdoc="x">open-input-bytes</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#"the cow jumped over the moon\nthe little dog\n"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"the cow jumped over the moon"</span></p></td></tr></table></blockquote></div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="strings.html" data-pltdoc="x">Strings</a> also provides information on strings.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._open-input-string))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValDef RktValLink" data-pltdoc="x">open-input-string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">name</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._string-port~3f%29%29" class="RktValLink" data-pltdoc="x">string-port?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">string</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates an input <a href="stringport.html#%28tech._string._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">string port</span></a> that reads bytes from the UTF-8
+encoding (see <a href="encodings.html" data-pltdoc="x">Encodings and Locales</a>) of <span class="RktVar">str</span>. The optional
+<span class="RktVar">name</span> argument is used as the name for the returned port.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sp</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"(&#955; (x) x)"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sp</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(&#955; (x) x)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">names</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"G&#252;nter Harder\nFr&#233;d&#233;ric Paulin\n"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="RktValLink" data-pltdoc="x">read-line</a></span><span class="hspace">&nbsp;</span><span class="RktSym">names</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"G&#252;nter Harder"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Input.html#%28def._%28%28quote._~23~25kernel%29._read-line%29%29" class="RktValLink" data-pltdoc="x">read-line</a></span><span class="hspace">&nbsp;</span><span class="RktSym">names</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Fr&#233;d&#233;ric Paulin"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._open-output-bytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">open-output-bytes</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">name</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._string-port~3f%29%29" class="RktValLink" data-pltdoc="x">string-port?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">string</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates an output <a href="stringport.html#%28tech._string._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">string port</span></a> that accumulates the output into a
+byte string. The optional <span class="RktVar">name</span> argument is used as the name for
+the returned port.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-bytes%29%29" class="RktValLink" data-pltdoc="x">open-output-bytes</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">"Tom"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Dick"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym">op1</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-bytes%29%29" class="RktValLink" data-pltdoc="x">get-output-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"((1 2 3) (\"Tom\" \"Dick\") ((quote a) (quote b) (quote c)))"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-bytes%29%29" class="RktValLink" data-pltdoc="x">open-output-bytes</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Hi "</span><span class="hspace">&nbsp;</span><span class="RktSym">op2</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"there"</span><span class="hspace">&nbsp;</span><span class="RktSym">op2</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-bytes%29%29" class="RktValLink" data-pltdoc="x">get-output-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"\"Hi \"\"there\""</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op3</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-bytes%29%29" class="RktValLink" data-pltdoc="x">open-output-bytes</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes%29%29" class="RktValLink" data-pltdoc="x">write-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"Hi "</span><span class="hspace">&nbsp;</span><span class="RktSym">op3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-bytes%29%29" class="RktValLink" data-pltdoc="x">write-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"there"</span><span class="hspace">&nbsp;</span><span class="RktSym">op3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-bytes%29%29" class="RktValLink" data-pltdoc="x">get-output-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"Hi there"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._open-output-string))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-string%29%29" class="RktValDef RktValLink" data-pltdoc="x">open-output-string</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">name</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._string-port~3f%29%29" class="RktValLink" data-pltdoc="x">string-port?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">string</span></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-bytes%29%29" class="RktValLink" data-pltdoc="x">open-output-bytes</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-string%29%29" class="RktValLink" data-pltdoc="x">open-output-string</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">"Tom"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Dick"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym">op1</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-string%29%29" class="RktValLink" data-pltdoc="x">get-output-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"((1 2 3) (\"Tom\" \"Dick\") ((quote a) (quote b) (quote c)))"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-string%29%29" class="RktValLink" data-pltdoc="x">open-output-string</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Hi "</span><span class="hspace">&nbsp;</span><span class="RktSym">op2</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"there"</span><span class="hspace">&nbsp;</span><span class="RktSym">op2</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-string%29%29" class="RktValLink" data-pltdoc="x">get-output-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"\"Hi \"\"there\""</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op3</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-string%29%29" class="RktValLink" data-pltdoc="x">open-output-string</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-string%29%29" class="RktValLink" data-pltdoc="x">write-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Hi "</span><span class="hspace">&nbsp;</span><span class="RktSym">op3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Byte_and_String_Output.html#%28def._%28%28quote._~23~25kernel%29._write-string%29%29" class="RktValLink" data-pltdoc="x">write-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"there"</span><span class="hspace">&nbsp;</span><span class="RktSym">op3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-string%29%29" class="RktValLink" data-pltdoc="x">get-output-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hi there"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._get-output-bytes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-bytes%29%29" class="RktValDef RktValLink" data-pltdoc="x">get-output-bytes</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">reset?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._string-port~3f%29%29" class="RktValLink" data-pltdoc="x">string-port?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">reset?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the bytes accumulated in the <a href="stringport.html#%28tech._string._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">string port</span></a> <span class="RktVar">out</span> so
+far in a freshly allocated <a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte string</span></a> (including any bytes
+written after the port&rsquo;s current position, if any). The <span class="RktVar">out</span>
+port must be an output <a href="stringport.html#%28tech._string._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">string port</span></a> produced by
+<span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-bytes%29%29" class="RktValLink" data-pltdoc="x">open-output-bytes</a></span> (or <span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-string%29%29" class="RktValLink" data-pltdoc="x">open-output-string</a></span>) or a
+structure whose <span class="RktSym"><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3aoutput-port%29%29" class="RktValLink" data-pltdoc="x">prop:output-port</a></span> property refers to such an
+output port (transitively).</div></p><p>If <span class="RktVar">reset?</span> is true, then all bytes are removed from the port,
+and the port&rsquo;s position is reset to <span class="RktVal">0</span>; if <span class="RktVar">reset?</span> is
+<span class="RktVal">#f</span>, then all bytes remain in the port for further
+accumulation (so they are returned for later calls to
+<span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-bytes%29%29" class="RktValLink" data-pltdoc="x">get-output-bytes</a></span> or <span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-string%29%29" class="RktValLink" data-pltdoc="x">get-output-string</a></span>), and the
+port&rsquo;s position is unchanged.</p><p>The <span class="RktVar">start-pos</span> and <span class="RktVar">end-pos</span> arguments specify the
+range of bytes in the port to return; supplying <span class="RktVar">start-pos</span> and
+<span class="RktVar">end-pos</span> is the same as using <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._subbytes%29%29" class="RktValLink" data-pltdoc="x">subbytes</a></span> on the result
+of <span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-bytes%29%29" class="RktValLink" data-pltdoc="x">get-output-bytes</a></span>, but supplying them to
+<span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-bytes%29%29" class="RktValLink" data-pltdoc="x">get-output-bytes</a></span> can avoid an allocation. The
+<span class="RktVar">end-pos</span> argument can be <span class="RktVal">#f</span>, which corresponds to not
+passing a second argument to <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._subbytes%29%29" class="RktValLink" data-pltdoc="x">subbytes</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-bytes%29%29" class="RktValLink" data-pltdoc="x">open-output-bytes</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">"Tom"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Dick"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym">op</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-bytes%29%29" class="RktValLink" data-pltdoc="x">get-output-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"((1 2 3) (\"Tom\" \"Dick\") ((quote a) (quote b) (quote c)))"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-bytes%29%29" class="RktValLink" data-pltdoc="x">get-output-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">16</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#" 2 3) (\"Tom\" "</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-bytes%29%29" class="RktValLink" data-pltdoc="x">get-output-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"((1 2 3) (\"Tom\" \"Dick\") ((quote a) (quote b) (quote c)))"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-bytes%29%29" class="RktValLink" data-pltdoc="x">get-output-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#""</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._get-output-string))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-string%29%29" class="RktValDef RktValLink" data-pltdoc="x">get-output-string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">out</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._string-port~3f%29%29" class="RktValLink" data-pltdoc="x">string-port?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Futf-8%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;string/utf-8</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-bytes%29%29" class="RktValLink" data-pltdoc="x">get-output-bytes</a></span><span class="stt"> </span><span class="RktVar">out</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">#\uFFFD</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-input-string%29%29" class="RktValLink" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello world"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._open-output-string%29%29" class="RktValLink" data-pltdoc="x">open-output-string</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stringport.html#%28def._%28%28quote._~23~25kernel%29._get-output-string%29%29" class="RktValLink" data-pltdoc="x">get-output-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"hello"</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="file-ports.html" title="backward to &quot;13.1.5 File Ports&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ports.html" title="up to &quot;13.1 Ports&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="pipeports.html" title="forward to &quot;13.1.7 Pipes&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/strings.html b/clones/docs.racket-lang.org/reference/strings.html
new file mode 100644
index 00000000..82dd41c0
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/strings.html
@@ -0,0 +1,223 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.4&nbsp;Strings</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewselflink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.4&nbsp;</td><td><a href="strings.html" class="tocviewselflink" data-pltdoc="x">Strings</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.4.1&nbsp;</td><td><a href="strings.html#%28part._.String_.Constructors__.Selectors__and_.Mutators%29" class="tocviewlink" data-pltdoc="x">String Constructors, Selectors, and Mutators</a></td></tr><tr><td align="right">4.4.2&nbsp;</td><td><a href="strings.html#%28part._.String_.Comparisons%29" class="tocviewlink" data-pltdoc="x">String Comparisons</a></td></tr><tr><td align="right">4.4.3&nbsp;</td><td><a href="strings.html#%28part._.String_.Conversions%29" class="tocviewlink" data-pltdoc="x">String Conversions</a></td></tr><tr><td align="right">4.4.4&nbsp;</td><td><a href="strings.html#%28part._.Locale-.Specific_.String_.Operations%29" class="tocviewlink" data-pltdoc="x">Locale-<wbr></wbr>Specific String Operations</a></td></tr><tr><td align="right">4.4.5&nbsp;</td><td><a href="strings.html#%28part._.Additional_.String_.Functions%29" class="tocviewlink" data-pltdoc="x">Additional String Functions</a></td></tr><tr><td align="right">4.4.6&nbsp;</td><td><a href="strings.html#%28part._format%29" class="tocviewlink" data-pltdoc="x">Converting Values to Strings</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">4.4.1<tt>&nbsp;</tt></span><a href="strings.html#%28part._.String_.Constructors__.Selectors__and_.Mutators%29" class="tocsubseclink" data-pltdoc="x">String Constructors, Selectors, and Mutators</a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string?</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._make-string%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>string</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-~3eimmutable-string%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>&gt;immutable-<wbr></wbr>string</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._substring%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">substring</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-copy%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>copy</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-copy%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>copy!</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-fill%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>fill!</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>append</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append-immutable%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>append-<wbr></wbr>immutable</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-~3elist%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>&gt;list</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._list-~3estring%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-<wbr></wbr>&gt;string</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._build-string%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">build-<wbr></wbr>string</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.4.2<tt>&nbsp;</tt></span><a href="strings.html#%28part._.String_.Comparisons%29" class="tocsubseclink" data-pltdoc="x">String Comparisons</a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string=?</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string&lt;?</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string&lt;=?</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3e~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string&gt;?</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3e~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string&gt;=?</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>ci=?</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3c~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>ci&lt;?</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3c~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>ci&lt;=?</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3e~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>ci&gt;?</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3e~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>ci&gt;=?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.4.3<tt>&nbsp;</tt></span><a href="strings.html#%28part._.String_.Conversions%29" class="tocsubseclink" data-pltdoc="x">String Conversions</a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-upcase%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>upcase</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-downcase%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>downcase</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-titlecase%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>titlecase</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-foldcase%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>foldcase</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-normalize-nfd%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>normalize-<wbr></wbr>nfd</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-normalize-nfkd%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>normalize-<wbr></wbr>nfkd</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-normalize-nfc%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>normalize-<wbr></wbr>nfc</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-normalize-nfkc%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>normalize-<wbr></wbr>nfkc</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.4.4<tt>&nbsp;</tt></span><a href="strings.html#%28part._.Locale-.Specific_.String_.Operations%29" class="tocsubseclink" data-pltdoc="x">Locale-<wbr></wbr>Specific String Operations</a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>locale=?</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale~3c~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>locale&lt;?</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale~3e~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>locale&gt;?</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale-ci~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>locale-<wbr></wbr>ci=?</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale-ci~3c~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>locale-<wbr></wbr>ci&lt;?</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale-ci~3e~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>locale-<wbr></wbr>ci&gt;?</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale-upcase%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>locale-<wbr></wbr>upcase</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale-downcase%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>locale-<wbr></wbr>downcase</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.4.5<tt>&nbsp;</tt></span><a href="strings.html#%28part._.Additional_.String_.Functions%29" class="tocsubseclink" data-pltdoc="x">Additional String Functions</a></td></tr><tr><td><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-append%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>append*</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-join%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>join</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-normalize-spaces%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>normalize-<wbr></wbr>spaces</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-replace%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>replace</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-split%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>split</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-trim%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>trim</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">non-<wbr></wbr>empty-<wbr></wbr>string?</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-contains~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>contains?</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-prefix~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>prefix?</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-suffix~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>suffix?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.4.6<tt>&nbsp;</tt></span><a href="strings.html#%28part._format%29" class="tocsubseclink" data-pltdoc="x">Converting Values to Strings</a></td></tr><tr><td><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">~a</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ev%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">~v</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7es%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">~s</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ee%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">~e</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">~r</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7e..a%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">~.a</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7e..v%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">~.v</span></span></a></td></tr><tr><td><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7e..s%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">~.s</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="extflonums.html" title="backward to &quot;4.3.5 Extflonums&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="bytestrings.html" title="forward to &quot;4.5 Byte Strings&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;strings&quot;">4.4<tt>&nbsp;</tt><a name="(part._strings)"></a>Strings</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=strings.html&amp;version=8.6" class="Sq" data-pltdoc="x">Strings (Unicode)</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces strings.</p></blockquote></blockquote></blockquote><p>A <a name="(tech._string)"></a><span style="font-style: italic">string</span> is a fixed-length array of
+<a href="characters.html" data-pltdoc="x">characters</a>.</p><p><a name="(idx._(gentag._137._(lib._scribblings/reference/reference..scrbl)))"></a>A string can be <span style="font-style: italic">mutable</span> or
+<span style="font-style: italic">immutable</span>. When an immutable string is provided to a
+procedure like <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-set%21%29%29" class="RktValLink" data-pltdoc="x">string-set!</a></span>, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. String constants generated by the
+default reader (see <a href="reader.html#%28part._parse-string%29" data-pltdoc="x">Reading Strings</a>) are
+immutable, and they are <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> in <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode.
+Use <span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span> to check whether a string is immutable.</p><p>Two strings are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> when they have the same length and
+contain the same sequence of characters.</p><p>A string can be used as a single-valued sequence (see
+<a href="sequences.html" data-pltdoc="x">Sequences</a>). The characters of the string serve as elements
+of the sequence. See also <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-string%29%29" class="RktValLink" data-pltdoc="x">in-string</a></span>.</p><p>See <a href="reader.html#%28part._parse-string%29" data-pltdoc="x">Reading Strings</a>
+    for information on <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>ing
+    strings and <a href="printing.html#%28part._print-string%29" data-pltdoc="x">Printing Strings</a>
+    for information on <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>ing strings.</p><p>See also: <span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span>, <span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-~3estring%29%29" class="RktValLink" data-pltdoc="x">symbol-&gt;string</a></span>,
+<span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3estring%2Futf-8%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;string/utf-8</a></span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;String_Constructors__Selectors__and_Mutators&quot;">4.4.1<tt>&nbsp;</tt><a name="(part._.String_.Constructors__.Selectors__and_.Mutators)"></a>String Constructors, Selectors, and Mutators</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span>
+ is a string, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">apple</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-string))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._make-string%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">char</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#\nul</span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns a new mutable string of length <span class="RktVar">k</span> where
+each position in the string is initialized with the character
+<span class="RktVar">char</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._make-string%29%29" class="RktValLink" data-pltdoc="x">make-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">#\z</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"zzzzz"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string%29%29" class="RktValDef RktValLink" data-pltdoc="x">string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns a new
+mutable string whose length is the number of provided <span class="RktVar">char</span>s, and
+whose positions are initialized with the given <span class="RktVar">char</span>s.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string%29%29" class="RktValLink" data-pltdoc="x">string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="hspace">&nbsp;</span><span class="RktVal">#\p</span><span class="hspace">&nbsp;</span><span class="RktVal">#\p</span><span class="hspace">&nbsp;</span><span class="RktVal">#\l</span><span class="hspace">&nbsp;</span><span class="RktVal">#\e</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Apple"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-~3eimmutable-string))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-~3eimmutable-string%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-&gt;immutable-string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an immutable string with the same content as
+ <span class="RktVar">str</span>, returning <span class="RktVar">str</span> itself if <span class="RktVar">str</span> is
+ immutable.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-length))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the length of <span class="RktVar">str</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="RktValLink" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-ref))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">  Returns the character at position <span class="RktVar">k</span> in <span class="RktVar">str</span>.
+ The first position in the string corresponds to <span class="RktVal">0</span>, so the
+ position <span class="RktVar">k</span> must be less than the length of the string,
+ otherwise the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ref%29%29" class="RktValLink" data-pltdoc="x">string-ref</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\A</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-set!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">  Changes the
+ character position <span class="RktVar">k</span> in <span class="RktVar">str</span> to <span class="RktVar">char</span>.  The first
+ position in the string corresponds to <span class="RktVal">0</span>, so the position
+ <span class="RktVar">k</span> must be less than the length of the string, otherwise the
+ <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string%29%29" class="RktValLink" data-pltdoc="x">string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="hspace">&nbsp;</span><span class="RktVal">#\p</span><span class="hspace">&nbsp;</span><span class="RktVal">#\p</span><span class="hspace">&nbsp;</span><span class="RktVal">#\l</span><span class="hspace">&nbsp;</span><span class="RktVal">#\e</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-set%21%29%29" class="RktValLink" data-pltdoc="x">string-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">#\y</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">s</span></td></tr><tr><td><p><span class="RktRes">"Apply"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._substring))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._substring%29%29" class="RktValDef RktValLink" data-pltdoc="x">substring</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="RktValLink" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a new mutable string that is <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">end</span><span class="stt"> </span><span class="RktVar">start</span><span class="RktPn">)</span>
+ characters long, and that contains the same characters as
+ <span class="RktVar">str</span> from <span class="RktVar">start</span> inclusive to <span class="RktVar">end</span> exclusive.
+ The first position in a string corresponds to <span class="RktVal">0</span>, so
+ the <span class="RktVar">start</span> and <span class="RktVar">end</span> arguments must be less than or
+ equal to the length of <span class="RktVar">str</span>, and <span class="RktVar">end</span> must be greater
+ than or equal to <span class="RktVar">start</span>, otherwise the
+ <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._substring%29%29" class="RktValLink" data-pltdoc="x">substring</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"pp"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._substring%29%29" class="RktValLink" data-pltdoc="x">substring</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"pple"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-copy))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-copy%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-copy</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns
+ <span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._substring%29%29" class="RktValLink" data-pltdoc="x">substring</a></span><span class="stt"> </span><span class="RktVar">str</span><span class="stt"> </span><span class="RktVal">0</span><span class="RktPn">)</span>.
+</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s1</span><span class="hspace">&nbsp;</span><span class="RktVal">"Yui"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pilot</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-copy%29%29" class="RktValLink" data-pltdoc="x">string-copy</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s1</span><span class="hspace">&nbsp;</span><span class="RktSym">pilot</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("Yui" "Yui")</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-naturals%29%29" class="RktValLink" data-pltdoc="x">in-naturals</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">#\R</span><span class="hspace">&nbsp;</span><span class="RktVal">#\e</span><span class="hspace">&nbsp;</span><span class="RktVal">#\i</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-set%21%29%29" class="RktValLink" data-pltdoc="x">string-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pilot</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s1</span><span class="hspace">&nbsp;</span><span class="RktSym">pilot</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("Yui" "Rei")</span></p></td></tr></table></blockquote></div></p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-copy!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-copy%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-copy!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">dest</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">dest-start</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">src</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">src-start</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">src-end</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dest</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dest-start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src-start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src-end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="RktValLink" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">src</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Changes the characters of <span class="RktVar">dest</span> starting at position
+ <span class="RktVar">dest-start</span> to match the characters in <span class="RktVar">src</span> from
+ <span class="RktVar">src-start</span> (inclusive) to <span class="RktVar">src-end</span> (exclusive),
+ where the first position in a string corresponds to <span class="RktVal">0</span>. The
+ strings <span class="RktVar">dest</span> and <span class="RktVar">src</span> can be the same string, and in
+ that case the destination region can overlap with the source region;
+ the destination characters after the copy match the source characters
+ from before the copy. If any of <span class="RktVar">dest-start</span>,
+ <span class="RktVar">src-start</span>, or <span class="RktVar">src-end</span> are out of range (taking into
+ account the sizes of the strings and the source and destination
+ regions), the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string%29%29" class="RktValLink" data-pltdoc="x">string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="hspace">&nbsp;</span><span class="RktVal">#\p</span><span class="hspace">&nbsp;</span><span class="RktVal">#\p</span><span class="hspace">&nbsp;</span><span class="RktVal">#\l</span><span class="hspace">&nbsp;</span><span class="RktVal">#\e</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-copy%21%29%29" class="RktValLink" data-pltdoc="x">string-copy!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">"y"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-copy%21%29%29" class="RktValLink" data-pltdoc="x">string-copy!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">s</span></td></tr><tr><td><p><span class="RktRes">"lpply"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-fill!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-fill%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-fill!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">dest</span><span class="hspace">&nbsp;</span><span class="RktVar">char</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dest</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">char</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Changes <span class="RktVar">dest</span> so that every position in the
+ string is filled with <span class="RktVar">char</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string%29%29" class="RktValLink" data-pltdoc="x">string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="hspace">&nbsp;</span><span class="RktVal">#\p</span><span class="hspace">&nbsp;</span><span class="RktVal">#\p</span><span class="hspace">&nbsp;</span><span class="RktVal">#\l</span><span class="hspace">&nbsp;</span><span class="RktVal">#\e</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-fill%21%29%29" class="RktValLink" data-pltdoc="x">string-fill!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">#\q</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">s</span></td></tr><tr><td><p><span class="RktRes">"qqqqq"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-append))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-append</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"><a name="(idx._(gentag._138._(lib._scribblings/reference/reference..scrbl)))"></a>Returns a new mutable string that is
+as long as the sum of the given <span class="RktVar">str</span>s&rsquo; lengths, and that
+contains the concatenated characters of the given <span class="RktVar">str</span>s. If no
+<span class="RktVar">str</span>s are provided, the result is a zero-length string.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append%29%29" class="RktValLink" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Banana"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"AppleBanana"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-append-immutable))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append-immutable%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-append-immutable</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append%29%29" class="RktValLink" data-pltdoc="x">string-append</a></span>, but the result is an immutable
+string.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append-immutable%29%29" class="RktValLink" data-pltdoc="x">string-append-immutable</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Banana"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"AppleBanana"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append-immutable%29%29" class="RktValLink" data-pltdoc="x">string-append-immutable</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"A"</span><span class="hspace">&nbsp;</span><span class="RktVal">"B"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 7.5.0.14 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-~3elist))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-~3elist%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-&gt;list</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns a new
+ list of characters corresponding to the content of <span class="RktVar">str</span>. That is,
+ the length of the list is <span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="RktValLink" data-pltdoc="x">string-length</a></span><span class="stt"> </span><span class="RktVar">str</span><span class="RktPn">)</span>, and the
+ sequence of characters in <span class="RktVar">str</span> is the same sequence in the
+ result list.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-~3elist%29%29" class="RktValLink" data-pltdoc="x">string-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#\A #\p #\p #\l #\e)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._list-~3estring))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._list-~3estring%29%29" class="RktValDef RktValLink" data-pltdoc="x">list-&gt;string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns a new
+ mutable string whose content is the list of characters in <span class="RktVar">lst</span>.
+ That is, the length of the string is <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._length%29%29" class="RktValLink" data-pltdoc="x">length</a></span><span class="stt"> </span><span class="RktVar">lst</span><span class="RktPn">)</span>, and
+ the sequence of characters in <span class="RktVar">lst</span> is the same sequence in
+ the result string.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._list-~3estring%29%29" class="RktValLink" data-pltdoc="x">list-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="hspace">&nbsp;</span><span class="RktVal">#\p</span><span class="hspace">&nbsp;</span><span class="RktVal">#\p</span><span class="hspace">&nbsp;</span><span class="RktVal">#\l</span><span class="hspace">&nbsp;</span><span class="RktVal">#\e</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Apple"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._build-string))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._build-string%29%29" class="RktValDef RktValLink" data-pltdoc="x">build-string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a string of <span class="RktVar">n</span> characters by applying <span class="RktVar">proc</span> to
+the integers from <span class="RktVal">0</span> to <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="stt"> </span><span class="RktVar">n</span><span class="RktPn">)</span> in order. If
+<span class="RktVar">str</span> is the resulting string, then <span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ref%29%29" class="RktValLink" data-pltdoc="x">string-ref</a></span><span class="stt"> </span><span class="RktVar">str</span><span class="stt"> </span><span class="RktVar">i</span><span class="RktPn">)</span> is the character produced by <span class="RktPn">(</span><span class="RktVar">proc</span><span class="stt"> </span><span class="RktVar">i</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._build-string%29%29" class="RktValLink" data-pltdoc="x">build-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._integer-~3echar%29%29" class="RktValLink" data-pltdoc="x">integer-&gt;char</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">97</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"abcde"</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;String_Comparisons&quot;">4.4.2<tt>&nbsp;</tt><a name="(part._.String_.Comparisons)"></a>String Comparisons</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string~3d~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns
+ <span class="RktVal">#t</span> if all of the arguments are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"as"</span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string~3c~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string&lt;?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if the arguments are lexicographically sorted
+ increasing, where individual characters are ordered by
+ <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3c~3f%29%29" class="RktValLink" data-pltdoc="x">char&lt;?</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3f%29%29" class="RktValLink" data-pltdoc="x">string&lt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3f%29%29" class="RktValLink" data-pltdoc="x">string&lt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3f%29%29" class="RktValLink" data-pltdoc="x">string&lt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string~3c~3d~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string&lt;=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3f%29%29" class="RktValLink" data-pltdoc="x">string&lt;?</a></span>, but checks whether the arguments are nondecreasing.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string&lt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string&lt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string&lt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string~3e~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3e~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string&gt;?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3f%29%29" class="RktValLink" data-pltdoc="x">string&lt;?</a></span>, but checks whether the arguments are decreasing.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3e~3f%29%29" class="RktValLink" data-pltdoc="x">string&gt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3e~3f%29%29" class="RktValLink" data-pltdoc="x">string&gt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3e~3f%29%29" class="RktValLink" data-pltdoc="x">string&gt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string~3e~3d~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3e~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string&gt;=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3f%29%29" class="RktValLink" data-pltdoc="x">string&lt;?</a></span>, but checks whether the arguments are nonincreasing.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3e~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string&gt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3e~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string&gt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3e~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string&gt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-ci~3d~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-ci=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if all of the arguments are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> after
+ locale-insensitive case-folding via <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-foldcase%29%29" class="RktValLink" data-pltdoc="x">string-foldcase</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string-ci=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string-ci=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-ci~3c~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3c~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-ci&lt;?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3f%29%29" class="RktValLink" data-pltdoc="x">string&lt;?</a></span>, but checks whether the arguments would be in
+ increasing order if each was first case-folded using
+ <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-foldcase%29%29" class="RktValLink" data-pltdoc="x">string-foldcase</a></span> (which is locale-insensitive).</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3c~3f%29%29" class="RktValLink" data-pltdoc="x">string-ci&lt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3c~3f%29%29" class="RktValLink" data-pltdoc="x">string-ci&lt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3c~3f%29%29" class="RktValLink" data-pltdoc="x">string-ci&lt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-ci~3c~3d~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3c~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-ci&lt;=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3c~3f%29%29" class="RktValLink" data-pltdoc="x">string-ci&lt;?</a></span>, but checks whether the arguments would be nondecreasing after case-folding.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3c~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string-ci&lt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3c~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string-ci&lt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3c~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string-ci&lt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-ci~3e~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3e~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-ci&gt;?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3c~3f%29%29" class="RktValLink" data-pltdoc="x">string-ci&lt;?</a></span>, but checks whether the arguments would be decreasing after case-folding.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3e~3f%29%29" class="RktValLink" data-pltdoc="x">string-ci&gt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3e~3f%29%29" class="RktValLink" data-pltdoc="x">string-ci&gt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3e~3f%29%29" class="RktValLink" data-pltdoc="x">string-ci&gt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-ci~3e~3d~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3e~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-ci&gt;=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3c~3f%29%29" class="RktValLink" data-pltdoc="x">string-ci&lt;?</a></span>, but checks whether the arguments would be nonincreasing after case-folding.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3e~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string-ci&gt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3e~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string-ci&gt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ci~3e~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string-ci&gt;=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;String_Conversions&quot;">4.4.3<tt>&nbsp;</tt><a name="(part._.String_.Conversions)"></a>String Conversions</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-upcase))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-upcase%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-upcase</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns a string
+ whose characters are the upcase conversion of the characters in
+ <span class="RktVar">str</span>. The conversion uses Unicode&rsquo;s locale-independent
+ conversion rules that map code-point sequences to code-point
+ sequences (instead of simply mapping a 1-to-1 function on code points
+ over the string), so the string produced by the conversion can be
+ longer than the input string.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-upcase%29%29" class="RktValLink" data-pltdoc="x">string-upcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"abc!"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"ABC!"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-upcase%29%29" class="RktValLink" data-pltdoc="x">string-upcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Stra&#223;e"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"STRASSE"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-downcase))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-downcase%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-downcase</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Like
+ <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-upcase%29%29" class="RktValLink" data-pltdoc="x">string-upcase</a></span>, but the downcase conversion.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-downcase%29%29" class="RktValLink" data-pltdoc="x">string-downcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"aBC!"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"abc!"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-downcase%29%29" class="RktValLink" data-pltdoc="x">string-downcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Stra&#223;e"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"stra&#223;e"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-downcase%29%29" class="RktValLink" data-pltdoc="x">string-downcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"&#922;&#913;&#927;&#931;"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"&#954;&#945;&#959;&#962;"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-downcase%29%29" class="RktValLink" data-pltdoc="x">string-downcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"&#931;"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"&#963;"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-titlecase))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-titlecase%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-titlecase</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Like
+ <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-upcase%29%29" class="RktValLink" data-pltdoc="x">string-upcase</a></span>, but the titlecase conversion only for the
+ first character in each sequence of cased characters in <span class="RktSym">str</span>
+ (ignoring case-ignorable characters).</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-titlecase%29%29" class="RktValLink" data-pltdoc="x">string-titlecase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"aBC</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">twO"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Abc</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">Two"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-titlecase%29%29" class="RktValLink" data-pltdoc="x">string-titlecase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"y2k"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Y2k"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-titlecase%29%29" class="RktValLink" data-pltdoc="x">string-titlecase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"main stra&#223;e"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Main Stra&#223;e"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-titlecase%29%29" class="RktValLink" data-pltdoc="x">string-titlecase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"stra &#223;e"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Stra Sse"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-foldcase))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-foldcase%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-foldcase</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Like
+ <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-upcase%29%29" class="RktValLink" data-pltdoc="x">string-upcase</a></span>, but the case-folding conversion.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-foldcase%29%29" class="RktValLink" data-pltdoc="x">string-foldcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"aBC!"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"abc!"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-foldcase%29%29" class="RktValLink" data-pltdoc="x">string-foldcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Stra&#223;e"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"strasse"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-foldcase%29%29" class="RktValLink" data-pltdoc="x">string-foldcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"&#922;&#913;&#927;&#931;"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"&#954;&#945;&#959;&#963;"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-normalize-nfd))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-normalize-nfd%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-normalize-nfd</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns a
+string that is the Unicode normalized form D of <span class="RktVar">string</span>. If
+the given string is already in the corresponding Unicode normal form,
+the string may be returned directly as the result (instead of a newly
+allocated string).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-normalize-nfkd))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-normalize-nfkd%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-normalize-nfkd</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Like
+<span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-normalize-nfd%29%29" class="RktValLink" data-pltdoc="x">string-normalize-nfd</a></span>, but for normalized form KD.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-normalize-nfc))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-normalize-nfc%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-normalize-nfc</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Like
+<span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-normalize-nfd%29%29" class="RktValLink" data-pltdoc="x">string-normalize-nfd</a></span>, but for normalized form C.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-normalize-nfkc))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-normalize-nfkc%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-normalize-nfkc</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Like
+<span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-normalize-nfd%29%29" class="RktValLink" data-pltdoc="x">string-normalize-nfd</a></span>, but for normalized form KC.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Locale-Specific_String_Operations&quot;">4.4.4<tt>&nbsp;</tt><a name="(part._.Locale-.Specific_.String_.Operations)"></a>Locale-Specific String Operations</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-locale~3d~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-locale=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">  Like <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string=?</a></span>, but the strings are compared in a
+ locale-specific way, based on the value of <span class="RktSym"><a href="encodings.html#%28def._%28%28quote._~23~25kernel%29._current-locale%29%29" class="RktValLink" data-pltdoc="x">current-locale</a></span>. See
+ <a href="encodings.html" data-pltdoc="x">Encodings and Locales</a> for more information on locales.</div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-locale~3c~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale~3c~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-locale&lt;?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3f%29%29" class="RktValLink" data-pltdoc="x">string&lt;?</a></span>, but the sort order compares strings in a
+ locale-specific way, based on the value of <span class="RktSym"><a href="encodings.html#%28def._%28%28quote._~23~25kernel%29._current-locale%29%29" class="RktValLink" data-pltdoc="x">current-locale</a></span>. In
+ particular, the sort order may not be simply a lexicographic
+ extension of character ordering.</div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-locale~3e~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale~3e~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-locale&gt;?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">  Like <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3e~3f%29%29" class="RktValLink" data-pltdoc="x">string&gt;?</a></span>, but locale-specific like
+ <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale~3c~3f%29%29" class="RktValLink" data-pltdoc="x">string-locale&lt;?</a></span>.</div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-locale-ci~3d~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale-ci~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-locale-ci=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">  Like <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string-locale=?</a></span>, but strings are compared
+ using rules that are both locale-specific and case-insensitive
+ (depending on what &ldquo;case-insensitive&rdquo; means for the current
+ locale).</div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-locale-ci~3c~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale-ci~3c~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-locale-ci&lt;?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">  Like <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3c~3f%29%29" class="RktValLink" data-pltdoc="x">string&lt;?</a></span>, but both locale-sensitive and
+ case-insensitive like <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale-ci~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string-locale-ci=?</a></span>.</div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-locale-ci~3e~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale-ci~3e~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-locale-ci&gt;?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str1</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str2</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">  Like <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3e~3f%29%29" class="RktValLink" data-pltdoc="x">string&gt;?</a></span>, but both locale-sensitive and
+ case-insensitive like <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale-ci~3d~3f%29%29" class="RktValLink" data-pltdoc="x">string-locale-ci=?</a></span>.</div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-locale-upcase))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale-upcase%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-locale-upcase</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Like
+<span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-upcase%29%29" class="RktValLink" data-pltdoc="x">string-upcase</a></span>, but using locale-specific case-conversion
+rules based on the value of <span class="RktSym"><a href="encodings.html#%28def._%28%28quote._~23~25kernel%29._current-locale%29%29" class="RktValLink" data-pltdoc="x">current-locale</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-locale-downcase))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-locale-downcase%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-locale-downcase</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Like
+<span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-downcase%29%29" class="RktValLink" data-pltdoc="x">string-downcase</a></span>, but using locale-specific case-conversion
+rules based on the value of <span class="RktSym"><a href="encodings.html#%28def._%28%28quote._~23~25kernel%29._current-locale%29%29" class="RktValLink" data-pltdoc="x">current-locale</a></span>.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Additional_String_Functions&quot;">4.4.5<tt>&nbsp;</tt><a name="(part._.Additional_.String_.Functions)"></a><a name="(mod-path._racket/string)"></a>Additional String Functions</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="strings.html#%28mod-path._racket%2Fstring%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/string</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="strings.html#%28mod-path._racket%2Fstring%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/string</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/string..rkt)._string-append*))"></a><span title="Provided from: racket/string, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-append%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-append*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">strs</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">strs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append%29%29" class="RktValLink" data-pltdoc="x">string-append</a></span>, but the last argument is used as a list
+of arguments for <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append%29%29" class="RktValLink" data-pltdoc="x">string-append</a></span>, so <span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-append%2A%29%29" class="RktValLink" data-pltdoc="x">string-append*</a></span><span class="stt"> </span><span class="RktVar">str</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktVar">strs</span><span class="RktPn">)</span> is the same as <span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span><span class="stt"> </span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append%29%29" class="RktValLink" data-pltdoc="x">string-append</a></span><span class="stt"> </span><span class="RktVar">str</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktVar">strs</span><span class="RktPn">)</span>.  In other words, the relationship between
+<span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append%29%29" class="RktValLink" data-pltdoc="x">string-append</a></span> and <span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-append%2A%29%29" class="RktValLink" data-pltdoc="x">string-append*</a></span> is similar to the
+one between <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span> and <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%2A%29%29" class="RktValLink" data-pltdoc="x">list*</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-append%2A%29%29" class="RktValLink" data-pltdoc="x">string-append*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"c"</span><span class="hspace">&nbsp;</span><span class="RktVal">"d"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"abcd"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-append%2A%29%29" class="RktValLink" data-pltdoc="x">string-append*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._append%2A%29%29" class="RktValLink" data-pltdoc="x">append*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">", "</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Alpha"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Beta"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Gamma"</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"Alpha, Beta, Gamma"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/string..rkt)._string-join))"></a><span title="Provided from: racket/string, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-join%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-join</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">strs</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">sep</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:before-first</span><span class="hspace">&nbsp;</span><span class="RktVar">before-first</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:before-last</span><span class="hspace">&nbsp;</span><span class="RktVar">before-last</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:after-last</span><span class="hspace">&nbsp;</span><span class="RktVar">after-last</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">strs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sep</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">" "</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">before-first</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">""</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">before-last</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">sep</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">after-last</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">""</span></td></tr></table></blockquote></div><div class="SIntrapara">Appends the strings in <span class="RktVar">strs</span>, inserting <span class="RktVar">sep</span> between
+each pair of strings in <span class="RktVar">strs</span>.  <span class="RktVar">before-last</span>,
+<span class="RktVar">before-first</span>, and <span class="RktVar">after-last</span> are analogous to the
+inputs of <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._add-between%29%29" class="RktValLink" data-pltdoc="x">add-between</a></span>: they specify an alternate separator
+between the last two strings, a prefix string, and a suffix string
+respectively.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-join%29%29" class="RktValLink" data-pltdoc="x">string-join</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"one"</span><span class="hspace">&nbsp;</span><span class="RktVal">"two"</span><span class="hspace">&nbsp;</span><span class="RktVal">"three"</span><span class="hspace">&nbsp;</span><span class="RktVal">"four"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"one two three four"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-join%29%29" class="RktValLink" data-pltdoc="x">string-join</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"one"</span><span class="hspace">&nbsp;</span><span class="RktVal">"two"</span><span class="hspace">&nbsp;</span><span class="RktVal">"three"</span><span class="hspace">&nbsp;</span><span class="RktVal">"four"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">", "</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"one, two, three, four"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-join%29%29" class="RktValLink" data-pltdoc="x">string-join</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"one"</span><span class="hspace">&nbsp;</span><span class="RktVal">"two"</span><span class="hspace">&nbsp;</span><span class="RktVal">"three"</span><span class="hspace">&nbsp;</span><span class="RktVal">"four"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">" potato "</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"one potato two potato three potato four"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-join%29%29" class="RktValLink" data-pltdoc="x">string-join</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"x"</span><span class="hspace">&nbsp;</span><span class="RktVal">"y"</span><span class="hspace">&nbsp;</span><span class="RktVal">"z"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">", "</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:before-first</span><span class="hspace">&nbsp;</span><span class="RktVal">"Todo: "</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:before-last</span><span class="hspace">&nbsp;</span><span class="RktVal">" and "</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:after-last</span><span class="hspace">&nbsp;</span><span class="RktVal">"."</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"Todo: x, y and z."</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/string..rkt)._string-normalize-spaces))"></a><span title="Provided from: racket/string, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-normalize-spaces%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-normalize-spaces</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">str</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">sep</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">space</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:trim?</span><span class="hspace">&nbsp;</span><span class="RktVar">trim?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:repeat?</span><span class="hspace">&nbsp;</span><span class="RktVar">repeat?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sep</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#px"\\s+"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">space</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">" "</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">trim?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">repeat?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Normalizes spaces in the input <span class="RktVar">str</span> by trimming it (using
+<span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-trim%29%29" class="RktValLink" data-pltdoc="x">string-trim</a></span> and <span class="RktVar">sep</span>) and replacing all whitespace
+sequences in the result with <span class="RktVar">space</span>, which defaults to a
+single space.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-normalize-spaces%29%29" class="RktValLink" data-pltdoc="x">string-normalize-spaces</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">foo bar</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">baz \r\n\t"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"foo bar baz"</span></p></td></tr></table></blockquote></div></p><p>The result of <span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-normalize-spaces%29%29" class="RktValLink" data-pltdoc="x">string-normalize-spaces</a></span><span class="stt"> </span><span class="RktVar">str</span><span class="stt"> </span><span class="RktVar">sep</span><span class="stt"> </span><span class="RktVar">space</span><span class="RktPn">)</span> is the same
+as <span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-join%29%29" class="RktValLink" data-pltdoc="x">string-join</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-split%29%29" class="RktValLink" data-pltdoc="x">string-split</a></span><span class="stt"> </span><span class="RktVar">str</span><span class="stt"> </span><span class="RktVar">sep</span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">space</span><span class="RktPn">)</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/string..rkt)._string-replace))"></a><span title="Provided from: racket/string, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-replace%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-replace</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktVar">from</span><span class="hspace">&nbsp;</span><span class="RktVar">to</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktPn">#:all?</span><span class="hspace">&nbsp;</span><span class="RktVar">all?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">from</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">to</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">all?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVar">str</span> with all occurrences of <span class="RktVar">from</span> replaced
+with by <span class="RktVar">to</span>. If <span class="RktVar">from</span> is a string, it is matched
+literally (as opposed to being used as a <a href="regexp.html#%28tech._regular._expression%29" class="techoutside" data-pltdoc="x"><span class="techinside">regular expression</span></a>).</div></p><p>By default, all occurrences are replaced, but only the first match is
+replaced if <span class="RktVar">all?</span> is <span class="RktVal">#f</span>.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-replace%29%29" class="RktValLink" data-pltdoc="x">string-replace</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"foo bar baz"</span><span class="hspace">&nbsp;</span><span class="RktVal">"bar"</span><span class="hspace">&nbsp;</span><span class="RktVal">"blah"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"foo blah baz"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/string..rkt)._string-split))"></a><span title="Provided from: racket/string, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-split%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-split</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">str</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">sep</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:trim?</span><span class="hspace">&nbsp;</span><span class="RktVar">trim?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:repeat?</span><span class="hspace">&nbsp;</span><span class="RktVar">repeat?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sep</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#px"\\s+"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">trim?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">repeat?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Splits the input <span class="RktVar">str</span> on <span class="RktVar">sep</span>, returning a list of
+substrings of <span class="RktVar">str</span> that are separated by <span class="RktVar">sep</span>, defaulting
+to splitting the input on whitespaces. The
+input is first trimmed using <span class="RktVar">sep</span> (see <span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-trim%29%29" class="RktValLink" data-pltdoc="x">string-trim</a></span>),
+unless <span class="RktVar">trim?</span> is <span class="RktVal">#f</span>. Empty matches are handled in the
+same way as for <span class="RktSym"><a href="regexp.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._regexp-split%29%29" class="RktValLink" data-pltdoc="x">regexp-split</a></span>. As a special case, if
+<span class="RktVar">str</span> is the empty string after trimming, the result is
+<span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span> instead of <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">""</span><span class="RktVal">)</span>.</div></p><p>Like <span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-trim%29%29" class="RktValLink" data-pltdoc="x">string-trim</a></span>, provide <span class="RktVar">sep</span> to use a different separator,
+and <span class="RktVar">repeat?</span>  controls matching repeated sequences.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-split%29%29" class="RktValLink" data-pltdoc="x">string-split</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">foo bar</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">baz \r\n\t"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("foo" "bar" "baz")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-split%29%29" class="RktValLink" data-pltdoc="x">string-split</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-split%29%29" class="RktValLink" data-pltdoc="x">string-split</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:trim?</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("" "")</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/string..rkt)._string-trim))"></a><span title="Provided from: racket/string, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-trim%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-trim</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">str</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">sep</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:left?</span><span class="hspace">&nbsp;</span><span class="RktVar">left?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:right?</span><span class="hspace">&nbsp;</span><span class="RktVar">right?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:repeat?</span><span class="hspace">&nbsp;</span><span class="RktVar">repeat?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sep</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="regexp.html#%28def._%28%28quote._~23~25kernel%29._regexp~3f%29%29" class="RktValLink" data-pltdoc="x">regexp?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#px"\\s+"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">left?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">right?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">repeat?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Trims the input <span class="RktVar">str</span> by removing prefix and suffix <span class="RktVar">sep</span>,
+which defaults to whitespace. A string <span class="RktVar">sep</span> is matched literally
+(as opposed to being used as a <a href="regexp.html#%28tech._regular._expression%29" class="techoutside" data-pltdoc="x"><span class="techinside">regular expression</span></a>).</div></p><p>Use <span class="RktPn">#:left?</span><span class="stt"> </span><span class="RktVal">#f</span> or <span class="RktPn">#:right?</span><span class="stt"> </span><span class="RktVal">#f</span> to suppress trimming
+the corresponding side.  When <span class="RktVar">repeat?</span> is <span class="RktVal">#f</span> (the
+default), only one match is removed from each side; when
+<span class="RktVar">repeat?</span> is true, all initial or trailing matches are
+trimmed (which is an alternative to using a <a href="regexp.html#%28tech._regular._expression%29" class="techoutside" data-pltdoc="x"><span class="techinside">regular expression</span></a>
+<span class="RktVar">sep</span> that contains <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span>).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-trim%29%29" class="RktValLink" data-pltdoc="x">string-trim</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">foo bar</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">baz \r\n\t"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"foo bar</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">baz"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-trim%29%29" class="RktValLink" data-pltdoc="x">string-trim</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">foo bar</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">baz \r\n\t"</span><span class="hspace">&nbsp;</span><span class="RktVal">" "</span><span class="hspace">&nbsp;</span><span class="RktPn">#:repeat?</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"foo bar</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">baz \r\n\t"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-trim%29%29" class="RktValLink" data-pltdoc="x">string-trim</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"aaaxaayaa"</span><span class="hspace">&nbsp;</span><span class="RktVal">"aa"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"axaay"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/string..rkt)._non-empty-string~3f))"></a><span title="Provided from: racket/string, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">non-empty-string?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">x</span> is a string and is not empty;
+returns <span class="RktVal">#f</span> otherwise.
+</div><div class="SIntrapara"><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/string..rkt)._string-contains~3f))"></a><span title="Provided from: racket/string, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-contains~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-contains?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span><span class="RktVar">contained</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">contained</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/string..rkt)._string-prefix~3f))"></a><span title="Provided from: racket/string, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-prefix~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-prefix?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span><span class="RktVar">prefix</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prefix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/string..rkt)._string-suffix~3f))"></a><span title="Provided from: racket/string, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-suffix~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-suffix?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span><span class="RktVar">suffix</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">s</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">suffix</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Checks whether <span class="RktVar">s</span> includes at any location, start with, or ends with
+the second argument, respectively.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-prefix~3f%29%29" class="RktValLink" data-pltdoc="x">string-prefix?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Racket"</span><span class="hspace">&nbsp;</span><span class="RktVal">"R"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-prefix~3f%29%29" class="RktValLink" data-pltdoc="x">string-prefix?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Jacket"</span><span class="hspace">&nbsp;</span><span class="RktVal">"R"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-suffix~3f%29%29" class="RktValLink" data-pltdoc="x">string-suffix?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Racket"</span><span class="hspace">&nbsp;</span><span class="RktVal">"et"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._string-contains~3f%29%29" class="RktValLink" data-pltdoc="x">string-contains?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Racket"</span><span class="hspace">&nbsp;</span><span class="RktVal">"ack"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;format&quot;">4.4.6<tt>&nbsp;</tt><a name="(part._format)"></a><a name="(mod-path._racket/format)"></a>Converting Values to Strings</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="strings.html#%28mod-path._racket%2Fformat%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/format</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="strings.html#%28mod-path._racket%2Fformat%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/format</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p>The <a href="strings.html#%28mod-path._racket%2Fformat%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/format</span></a> library provides functions for
+converting Racket values to strings. In addition to features like
+padding and numeric formatting, the functions have the virtue of being
+shorter than <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span> (with format string),
+<span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._number-~3estring%29%29" class="RktValLink" data-pltdoc="x">number-&gt;string</a></span>, or <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-append%29%29" class="RktValLink" data-pltdoc="x">string-append</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/format..rkt)._~7ea))"></a><span title="Provided from: racket/format, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValDef RktValLink" data-pltdoc="x">~a</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:separator</span><span class="hspace">&nbsp;</span><span class="RktVar">separator</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktVar">width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:max-width</span><span class="hspace">&nbsp;</span><span class="RktVar">max-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:min-width</span><span class="hspace">&nbsp;</span><span class="RktVar">min-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:limit-marker</span><span class="hspace">&nbsp;</span><span class="RktVar">limit-marker</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:limit-prefix?</span><span class="hspace">&nbsp;</span><span class="RktVar">limit-prefix?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:align</span><span class="hspace">&nbsp;</span><span class="RktVar">align</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:left-pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">left-pad-string</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:right-pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">right-pad-string</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">separator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">""</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">max-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">min-width</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit-marker</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">""</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit-prefix?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">align</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">left</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">center</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">right</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">left</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">" "</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">left-pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">right-pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td></tr></table></blockquote></div><div class="SIntrapara">Converts each <span class="RktVar">v</span> to a string in <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span> mode&#8212;<wbr></wbr>that
+is, like <span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="stt"> </span><span class="RktVal">"~a"</span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span>&#8212;<wbr></wbr>then concatentates the results
+with <span class="RktVar">separator</span> between consecutive items, and then pads or
+truncates the string to be at least <span class="RktVar">min-width</span> characters and
+at most <span class="RktVar">max-width</span> characters.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"north"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"north"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">south</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"south"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"east"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"east"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\w</span><span class="hspace">&nbsp;</span><span class="RktVal">"e"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">st</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"west"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"red"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">green</span><span class="hspace">&nbsp;</span><span class="RktVal">#"blue"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"(red green blue)"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"17"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#e1e20</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"100000000000000000000"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"3.141592653589793"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">6.1</span><span class="hspace">&nbsp;</span><span class="RktVal">87</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"2.1071509386211452e+68"</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span> function is primarily useful for strings, numbers, and other
+atomic data. The <span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ev%29%29" class="RktValLink" data-pltdoc="x">~v</a></span> and <span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7es%29%29" class="RktValLink" data-pltdoc="x">~s</a></span> functions are better suited to
+compound data.</p><p>Let <span class="RktVar">s</span> be the concatenated string forms of the <span class="RktVar">v</span>s
+plus separators. If <span class="RktVar">s</span> is longer than <span class="RktVar">max-width</span>
+characters, it is truncated to exactly <span class="RktVar">max-width</span>
+characters. If <span class="RktVar">s</span> is shorter than <span class="RktVar">min-width</span>
+characters, it is padded to exactly <span class="RktVar">min-width</span>
+characters. Otherwise <span class="RktVar">s</span> is returned unchanged. If
+<span class="RktVar">min-width</span> is greater than <span class="RktVar">max-width</span>, an exception is
+raised.</p><p>If <span class="RktVar">s</span> is longer than <span class="RktVar">max-width</span> characters, it is
+truncated and the end of the string is replaced with
+<span class="RktVar">limit-marker</span>. If <span class="RktVar">limit-marker</span> is longer than
+<span class="RktVar">max-width</span>, an exception is raised.
+If <span class="RktVar">limit-prefix?</span> is <span class="RktVal">#t</span>, the beginning of the string
+is truncated instead of the end.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"abcde"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:max-width</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"abcde"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"abcde"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:max-width</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"abcd"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"abcde"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:max-width</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktPn">#:limit-marker</span><span class="hspace">&nbsp;</span><span class="RktVal">"*"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"abc*"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"abcde"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:max-width</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktPn">#:limit-marker</span><span class="hspace">&nbsp;</span><span class="RktVal">"..."</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"a..."</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"The quick brown fox"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:max-width</span><span class="hspace">&nbsp;</span><span class="RktVal">15</span><span class="hspace">&nbsp;</span><span class="RktPn">#:limit-marker</span><span class="hspace">&nbsp;</span><span class="RktVal">""</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"The quick brown"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"The quick brown fox"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:max-width</span><span class="hspace">&nbsp;</span><span class="RktVal">15</span><span class="hspace">&nbsp;</span><span class="RktPn">#:limit-marker</span><span class="hspace">&nbsp;</span><span class="RktVal">"..."</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"The quick br..."</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"The quick brown fox"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:max-width</span><span class="hspace">&nbsp;</span><span class="RktVal">15</span><span class="hspace">&nbsp;</span><span class="RktPn">#:limit-marker</span><span class="hspace">&nbsp;</span><span class="RktVal">"..."</span><span class="hspace">&nbsp;</span><span class="RktPn">#:limit-prefix?</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"The quick br..."</span></p></td></tr></table></blockquote></div></p><p>If <span class="RktVar">s</span> is shorter than <span class="RktVar">min-width</span>, it is padded to at
+least <span class="RktVar">min-width</span> characters. If <span class="RktVar">align</span> is
+<span class="RktVal">'</span><span class="RktVal">left</span>, then only right padding is added; if <span class="RktVar">align</span>
+is <span class="RktVal">'</span><span class="RktVal">right</span>, then only left padding is added; and if
+<span class="RktVar">align</span> is <span class="RktVal">'</span><span class="RktVal">center</span>, then roughly equal amounts of
+left padding and right padding are added.</p><p>Padding is specified as a non-empty string. Left padding consists of
+<span class="RktVar">left-pad-string</span> repeated in its entirety as many times as
+possible followed by a <span class="emph">prefix</span> of <span class="RktVar">left-pad-string</span> to fill
+the remaining space. In contrast, right padding consists of a
+<span class="emph">suffix</span> of <span class="RktVar">right-pad-string</span> followed by a number of copies
+of <span class="RktVar">right-pad-string</span> in its entirety. Thus left padding starts
+with the start of <span class="RktVar">left-pad-string</span> and right padding ends with
+the end of <span class="RktVar">right-pad-string</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:min-width</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="hspace">&nbsp;</span><span class="RktPn">#:align</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">left</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"apple </span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"pear"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:min-width</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="hspace">&nbsp;</span><span class="RktPn">#:align</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">left</span><span class="hspace">&nbsp;</span><span class="RktPn">#:right-pad-string</span><span class="hspace">&nbsp;</span><span class="RktVal">" ."</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"pear . . . . . . . ."</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"plum"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:min-width</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="hspace">&nbsp;</span><span class="RktPn">#:align</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">right</span><span class="hspace">&nbsp;</span><span class="RktPn">#:left-pad-string</span><span class="hspace">&nbsp;</span><span class="RktVal">". "</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">". . . . . . . . plum"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"orange"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:min-width</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="hspace">&nbsp;</span><span class="RktPn">#:align</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">center</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:left-pad-string</span><span class="hspace">&nbsp;</span><span class="RktVal">"- "</span><span class="hspace">&nbsp;</span><span class="RktPn">#:right-pad-string</span><span class="hspace">&nbsp;</span><span class="RktVal">" -"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"- - - -orange- - - -"</span></p></td></tr></table></blockquote></div></p><p>Use <span class="RktVar">width</span> to set both <span class="RktVar">max-width</span> and <span class="RktVar">min-width</span>
+simultaneously, ensuring that the resulting string is exactly
+<span class="RktVar">width</span> characters long:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"terse"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"terse "</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"loquacious"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"loquac"</span></p></td></tr></table></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/format..rkt)._~7ev))"></a><span title="Provided from: racket/format, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ev%29%29" class="RktValDef RktValLink" data-pltdoc="x">~v</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:separator</span><span class="hspace">&nbsp;</span><span class="RktVar">separator</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktVar">width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:max-width</span><span class="hspace">&nbsp;</span><span class="RktVar">max-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:min-width</span><span class="hspace">&nbsp;</span><span class="RktVar">min-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:limit-marker</span><span class="hspace">&nbsp;</span><span class="RktVar">limit-marker</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:limit-prefix?</span><span class="hspace">&nbsp;</span><span class="RktVar">limit-prefix?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:align</span><span class="hspace">&nbsp;</span><span class="RktVar">align</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:left-pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">left-pad-string</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:right-pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">right-pad-string</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">separator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">" "</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">max-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">min-width</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit-marker</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">"..."</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit-prefix?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">align</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">left</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">center</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">right</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">left</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">" "</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">left-pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">right-pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span>, but each value is converted like <span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="stt"> </span><span class="RktVal">"~v"</span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span>, the default separator is <span class="RktVal">" "</span>, and the default limit
+marker is <span class="RktVal">"..."</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ev%29%29" class="RktValLink" data-pltdoc="x">~v</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"north"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"\"north\""</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ev%29%29" class="RktValLink" data-pltdoc="x">~v</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">south</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"'south"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ev%29%29" class="RktValLink" data-pltdoc="x">~v</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"east"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"#\"east\""</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ev%29%29" class="RktValLink" data-pltdoc="x">~v</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\w</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"#\\w"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ev%29%29" class="RktValLink" data-pltdoc="x">~v</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"red"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">green</span><span class="hspace">&nbsp;</span><span class="RktVal">#"blue"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"'(\"red\" green #\"blue\")"</span></p></td></tr></table></blockquote></div></p><p>Use <span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ev%29%29" class="RktValLink" data-pltdoc="x">~v</a></span> to produce text that talks about Racket values.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">nums</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"The even numbers in "</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ev%29%29" class="RktValLink" data-pltdoc="x">~v</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nums</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">" are "</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ev%29%29" class="RktValLink" data-pltdoc="x">~v</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._filter%29%29" class="RktValLink" data-pltdoc="x">filter</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nums</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"."</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"The even numbers in '(0 1 2 3 4 5 6 7 8 9) are '(0 2 4 6 8)."</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/format..rkt)._~7es))"></a><span title="Provided from: racket/format, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7es%29%29" class="RktValDef RktValLink" data-pltdoc="x">~s</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:separator</span><span class="hspace">&nbsp;</span><span class="RktVar">separator</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktVar">width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:max-width</span><span class="hspace">&nbsp;</span><span class="RktVar">max-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:min-width</span><span class="hspace">&nbsp;</span><span class="RktVar">min-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:limit-marker</span><span class="hspace">&nbsp;</span><span class="RktVar">limit-marker</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:limit-prefix?</span><span class="hspace">&nbsp;</span><span class="RktVar">limit-prefix?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:align</span><span class="hspace">&nbsp;</span><span class="RktVar">align</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:left-pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">left-pad-string</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:right-pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">right-pad-string</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">separator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">" "</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">max-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">min-width</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit-marker</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">"..."</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit-prefix?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">align</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">left</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">center</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">right</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">left</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">" "</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">left-pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">right-pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span>, but each value is converted like <span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="stt"> </span><span class="RktVal">"~s"</span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span>, the default separator is <span class="RktVal">" "</span>, and the default limit
+marker is <span class="RktVal">"..."</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7es%29%29" class="RktValLink" data-pltdoc="x">~s</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"north"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"\"north\""</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7es%29%29" class="RktValLink" data-pltdoc="x">~s</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">south</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"south"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7es%29%29" class="RktValLink" data-pltdoc="x">~s</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"east"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"#\"east\""</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7es%29%29" class="RktValLink" data-pltdoc="x">~s</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\w</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"#\\w"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7es%29%29" class="RktValLink" data-pltdoc="x">~s</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"red"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">green</span><span class="hspace">&nbsp;</span><span class="RktVal">#"blue"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"(\"red\" green #\"blue\")"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/format..rkt)._~7ee))"></a><span title="Provided from: racket/format, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ee%29%29" class="RktValDef RktValLink" data-pltdoc="x">~e</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:separator</span><span class="hspace">&nbsp;</span><span class="RktVar">separator</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktVar">width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:max-width</span><span class="hspace">&nbsp;</span><span class="RktVar">max-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:min-width</span><span class="hspace">&nbsp;</span><span class="RktVar">min-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:limit-marker</span><span class="hspace">&nbsp;</span><span class="RktVar">limit-marker</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:limit-prefix?</span><span class="hspace">&nbsp;</span><span class="RktVar">limit-prefix?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:align</span><span class="hspace">&nbsp;</span><span class="RktVar">align</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:left-pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">left-pad-string</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:right-pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">right-pad-string</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">separator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">" "</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">max-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">min-width</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit-marker</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">"..."</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit-prefix?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">align</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">left</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">center</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">right</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">left</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">" "</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">left-pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">right-pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span>, but each value is converted like <span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="stt"> </span><span class="RktVal">"~e"</span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span>, the default separator is <span class="RktVal">" "</span>, and the default limit
+marker is <span class="RktVal">"..."</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ee%29%29" class="RktValLink" data-pltdoc="x">~e</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"north"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"\"north\""</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ee%29%29" class="RktValLink" data-pltdoc="x">~e</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">south</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"'south"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ee%29%29" class="RktValLink" data-pltdoc="x">~e</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"east"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"#\"east\""</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ee%29%29" class="RktValLink" data-pltdoc="x">~e</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\w</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"#\\w"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ee%29%29" class="RktValLink" data-pltdoc="x">~e</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"red"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">green</span><span class="hspace">&nbsp;</span><span class="RktVal">#"blue"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"'(\"red\" green #\"blue\")"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/format..rkt)._~7er))"></a><span title="Provided from: racket/format, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValDef RktValLink" data-pltdoc="x">~r</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">x</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:sign</span><span class="hspace">&nbsp;</span><span class="RktVar">sign</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:base</span><span class="hspace">&nbsp;</span><span class="RktVar">base</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:precision</span><span class="hspace">&nbsp;</span><span class="RktVar">precision</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:notation</span><span class="hspace">&nbsp;</span><span class="RktVar">notation</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:format-exponent</span><span class="hspace">&nbsp;</span><span class="RktVar">format-exponent</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:min-width</span><span class="hspace">&nbsp;</span><span class="RktVar">min-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:groups</span><span class="hspace">&nbsp;</span><span class="RktVar">groups</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:group-sep</span><span class="hspace">&nbsp;</span><span class="RktVar">group-sep</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:decimal-sep</span><span class="hspace">&nbsp;</span><span class="RktVar">decimal-sep</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._rational~3f%29%29" class="RktValLink" data-pltdoc="x">rational?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">sign</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">+</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">++</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">parens</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ind</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ind</span><span class="hspace">&nbsp;</span><span class="RktSym">ind</span><span class="hspace">&nbsp;</span><span class="RktSym">ind</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">base</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">36</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">up</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">36</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">10</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">precision</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">=</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">6</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">notation</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">positional</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exponential</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._rational~3f%29%29" class="RktValLink" data-pltdoc="x">rational?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">positional</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exponential</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">positional</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">format-exponent</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">min-width</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">" "</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">groups</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._non-empty-listof%29%29" class="RktValLink" data-pltdoc="x">non-empty-listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">group-sep</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">""</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">decimal-sep</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">"."</span></td></tr></table></blockquote></div><div class="SIntrapara">Converts the rational number <span class="RktVar">x</span> to a string in either
+positional or exponential notation, depending on
+<span class="RktVar">notation</span>. The exactness or inexactness of <span class="RktVar">x</span> does not
+affect its formatting.</div></p><p>The optional arguments control number formatting:</p><p><div class="SIntrapara"><ul><li><p><span class="RktVar">notation</span> &#8212;<wbr></wbr> determines whether the number is printed
+in positional or exponential notation. If <span class="RktVar">notation</span> is a
+function, it is applied to <span class="RktVar">x</span> to get the notation to be used.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">12345</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"12345"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">12345</span><span class="hspace">&nbsp;</span><span class="RktPn">#:notation</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exponential</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"1.2345e+04"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">pick-notation</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._abs%29%29" class="RktValLink" data-pltdoc="x">abs</a></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0.001</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e%29%29" class="RktValLink" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._abs%29%29" class="RktValLink" data-pltdoc="x">abs</a></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1000</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exponential</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">positional</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:notation</span><span class="hspace">&nbsp;</span><span class="RktSym">pick-notation</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("17" "289" "4.913e+03" "8.3521e+04")</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktVar">precision</span> &#8212;<wbr></wbr> controls the number of digits after the
+decimal point (or more accurately, the
+<a href="https://en.wikipedia.org/wiki/Radix_point">radix point</a>).
+When <span class="RktVar">x</span> is formatted in exponential form, <span class="RktVar">precision</span>
+applies to the significand.</p><p>If <span class="RktVar">precision</span> is a natural number, then up to <span class="RktVar">precision</span> digits are
+displayed, but trailing zeroes are dropped, and if all digits after the decimal
+point are dropped the decimal point is also dropped. If <span class="RktVar">precision</span> is
+<span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">=</span><span class="stt"> </span><span class="RktVar">digits</span><span class="RktPn">)</span>, then exactly <span class="RktVar">digits</span> digits after the
+decimal point are used, and the decimal point is never dropped.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"3.141593"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:precision</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"3.1416"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:precision</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"3"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1.5</span><span class="hspace">&nbsp;</span><span class="RktPn">#:precision</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"1.5"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1.5</span><span class="hspace">&nbsp;</span><span class="RktPn">#:precision</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">=</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"1.5000"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">50</span><span class="hspace">&nbsp;</span><span class="RktPn">#:precision</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"50"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">50</span><span class="hspace">&nbsp;</span><span class="RktPn">#:precision</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">=</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"50.00"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">50</span><span class="hspace">&nbsp;</span><span class="RktPn">#:precision</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">=</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"50."</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktVar">decimal-sep</span> specifies what decimal separator is printed.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">123.456</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"123.456"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">123.456</span><span class="hspace">&nbsp;</span><span class="RktPn">#:decimal-sep</span><span class="hspace">&nbsp;</span><span class="RktVal">","</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"123,456"</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktVar">groups</span> controls how digits of the integral part of the number
+are separated into groups.
+Rightmost numbers of <span class="RktVar">groups</span> are used to group rightmost digits of the integral part.
+The leftmost number of <span class="RktVar">groups</span> is used repeatedly to group leftmost digits.
+The <span class="RktVar">group-sep</span> argument specifies which separator to use between digit groups.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1234567890</span><span class="hspace">&nbsp;</span><span class="RktPn">#:groups</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:group-sep</span><span class="hspace">&nbsp;</span><span class="RktVal">","</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"1,234,567,890"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1234567890</span><span class="hspace">&nbsp;</span><span class="RktPn">#:groups</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:group-sep</span><span class="hspace">&nbsp;</span><span class="RktVal">","</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"12,345,678,90"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1234567890</span><span class="hspace">&nbsp;</span><span class="RktPn">#:groups</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:group-sep</span><span class="hspace">&nbsp;</span><span class="RktVal">"_"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"1_2_3_4_5_678_90"</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktVar">min-width</span> &#8212;<wbr></wbr> if <span class="RktVar">x</span> would normally be printed
+with fewer than <span class="RktVar">min-width</span> digits (including the decimal
+point but not including the sign indicator), the digits are left-padded
+using <span class="RktVar">pad-string</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"17"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="hspace">&nbsp;</span><span class="RktPn">#:min-width</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">17"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-4</span>2</span><span class="hspace">&nbsp;</span><span class="RktPn">#:min-width</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"-</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">42"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1.5</span><span class="hspace">&nbsp;</span><span class="RktPn">#:min-width</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">" 1.5"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1.5</span><span class="hspace">&nbsp;</span><span class="RktPn">#:precision</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktPn">#:min-width</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">" </span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">1.5"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1.5</span><span class="hspace">&nbsp;</span><span class="RktPn">#:precision</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">=</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:min-width</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">1.5000"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#e1e10</span><span class="hspace">&nbsp;</span><span class="RktPn">#:min-width</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"10000000000"</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktVar">pad-string</span> &#8212;<wbr></wbr> specifies the string used to pad the
+number to at least <span class="RktVar">min-width</span> characters (not including the
+sign indicator). The padding is placed between the sign and the normal
+digits of <span class="RktVar">x</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="hspace">&nbsp;</span><span class="RktPn">#:min-width</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktPn">#:pad-string</span><span class="hspace">&nbsp;</span><span class="RktVal">"0"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"0017"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-4</span>2</span><span class="hspace">&nbsp;</span><span class="RktPn">#:min-width</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktPn">#:pad-string</span><span class="hspace">&nbsp;</span><span class="RktVal">"0"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"-0042"</span></p></td></tr></table></blockquote></div></p></li><li><p><div class="SIntrapara"><span class="RktVar">sign</span> &#8212;<wbr></wbr> controls how the sign of the number is
+indicated:
+  </div><div class="SIntrapara"><ul><li><p>If <span class="RktVar">sign</span> is <span class="RktVal">#f</span> (the default), no sign output is
+generated if <span class="RktVar">x</span> is either positive or zero, and a minus sign is
+prefixed if <span class="RktVar">x</span> is negative.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">17</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-4</span>2</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("17" "0" "-42")</span></p></td></tr></table></blockquote></div></p></li><li><p>If <span class="RktVar">sign</span> is <span class="RktVal">'</span><span class="RktVal">+</span>, no sign output is generated if
+<span class="RktVar">x</span> is zero, a plus sign is prefixed if <span class="RktVar">x</span> is positive, and a
+minus sign is prefixed if <span class="RktVar">x</span> is negative.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">17</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-4</span>2</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktPn">#:sign</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">+</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("+17" "0" "-42")</span></p></td></tr></table></blockquote></div></p></li><li><p>If <span class="RktVar">sign</span> is <span class="RktVal">'</span><span class="RktVal">++</span>, a plus sign is prefixed if <span class="RktVar">x</span>
+is zero or positive, and a minus sign is prefixed if <span class="RktVar">x</span> is negative.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">17</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-4</span>2</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktPn">#:sign</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">++</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("+17" "+0" "-42")</span></p></td></tr></table></blockquote></div></p></li><li><p>If <span class="RktVar">sign</span> is <span class="RktVal">'</span><span class="RktVal">parens</span>, no sign output is generated if
+<span class="RktVar">x</span> is zero or positive, and the number is enclosed in parentheses if
+<span class="RktVar">x</span> is negative.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">17</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-4</span>2</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktPn">#:sign</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">parens</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("17" "0" "(42)")</span></p></td></tr></table></blockquote></div></p></li><li><p>If <span class="RktVar">sign</span> is <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVar">pos-ind</span><span class="stt"> </span><span class="RktVar">zero-ind</span><span class="stt"> </span><span class="RktVar">neg-ind</span><span class="RktPn">)</span>, then
+<span class="RktVar">pos-ind</span>, <span class="RktVar">zero-ind</span>, and <span class="RktVar">neg-ind</span> are used to
+indicate positive, zero, and negative numbers, respectively. Each indicator is
+either a string to be used as a prefix or a list containing two strings: a
+prefix and a suffix.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">sign-table</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">""</span><span class="hspace">&nbsp;</span><span class="RktVal">" up"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"an even "</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">""</span><span class="hspace">&nbsp;</span><span class="RktVal">" down"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%2Flist%29%29" class="RktStxLink" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">17</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-4</span>2</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span><span class="RktPn">#:sign</span><span class="hspace">&nbsp;</span><span class="RktSym">sign-table</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("17 up" "an even 0" "42 down")</span></p></td></tr></table></blockquote></div></p><p>The default behavior is equivalent to <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">""</span><span class="stt"> </span><span class="RktVal">""</span><span class="stt"> </span><span class="RktVal">"-"</span><span class="RktVal">)</span>; the
+<span class="RktVal">'</span><span class="RktVal">parens</span> mode is equivalent to <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">""</span><span class="stt"> </span><span class="RktVal">""</span><span class="stt"> </span><span class="RktVal">(</span><span class="RktVal">"("</span><span class="stt"> </span><span class="RktVal">")"</span><span class="RktVal">)</span><span class="RktVal">)</span>.</p></li></ul></div></p></li><li><p><span class="RktVar">base</span> &#8212;<wbr></wbr> controls the base that <span class="RktVar">x</span> is formatted in. If
+<span class="RktVar">base</span> is a number greater than <span class="RktVal">10</span>, then lower-case letters are
+used. If <span class="RktVar">base</span> is <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">up</span><span class="stt"> </span><span class="RktVar">base*</span><span class="RktPn">)</span> and <span class="RktVar">base*</span> is
+greater than <span class="RktVal">10</span>, then upper-case letters are used.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="hspace">&nbsp;</span><span class="RktPn">#:base</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"202"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4.5</span><span class="hspace">&nbsp;</span><span class="RktPn">#:base</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"100.1"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3735928559</span><span class="hspace">&nbsp;</span><span class="RktPn">#:base</span><span class="hspace">&nbsp;</span><span class="RktVal">16</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"deadbeef"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3735928559</span><span class="hspace">&nbsp;</span><span class="RktPn">#:base</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">up</span><span class="hspace">&nbsp;</span><span class="RktVal">16</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"DEADBEEF"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3735928559</span><span class="hspace">&nbsp;</span><span class="RktPn">#:base</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">up</span><span class="hspace">&nbsp;</span><span class="RktVal">16</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:notation</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exponential</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"D.EADBEF*16^+07"</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktVar">format-exponent</span> &#8212;<wbr></wbr> determines how the exponent is displayed.</p><p>If <span class="RktVar">format-exponent</span> is a string, the exponent is displayed with an
+explicit sign (as with a <span class="RktVar">sign</span> of <span class="RktVal">'</span><span class="RktVal">++</span>) and at least two
+digits, separated from the significand by the &ldquo;exponent marker&rdquo;
+<span class="RktVar">format-exponent</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1234</span><span class="hspace">&nbsp;</span><span class="RktPn">#:notation</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exponential</span><span class="hspace">&nbsp;</span><span class="RktPn">#:format-exponent</span><span class="hspace">&nbsp;</span><span class="RktVal">"E"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"1.234E+03"</span></p></td></tr></table></blockquote><p>If <span class="RktVar">format-exponent</span> is <span class="RktVal">#f</span>, the &ldquo;exponent marker&rdquo; is
+<span class="RktVal">"e"</span> if <span class="RktVar">base</span> is <span class="RktVal">10</span> and a string involving
+<span class="RktVar">base</span> otherwise:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1234</span><span class="hspace">&nbsp;</span><span class="RktPn">#:notation</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exponential</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"1.234e+03"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1234</span><span class="hspace">&nbsp;</span><span class="RktPn">#:notation</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exponential</span><span class="hspace">&nbsp;</span><span class="RktPn">#:base</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"2.322*8^+03"</span></p></td></tr></table></blockquote><p>If <span class="RktVar">format-exponent</span> is a procedure, it is applied to the exponent and
+the resulting string is appended to the significand:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7er%29%29" class="RktValLink" data-pltdoc="x">~r</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1234</span><span class="hspace">&nbsp;</span><span class="RktPn">#:notation</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exponential</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:format-exponent</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">e</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"E~a"</span><span class="hspace">&nbsp;</span><span class="RktSym">e</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"1.234E3"</span></p></td></tr></table></blockquote></li></ul></div><div class="SIntrapara"><p class="SHistory">Changed in version 8.5.0.5 of package <span class="stt">base</span>: Added <span class="RktPn">#:groups</span>, <span class="RktPn">#:group-sep</span> and <span class="RktPn">#:decimal-sep</span>.</p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/format..rkt)._~7e..a))"></a><span title="Provided from: racket/format, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7e..a%29%29" class="RktValDef RktValLink" data-pltdoc="x">~.a</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:separator</span><span class="hspace">&nbsp;</span><span class="RktVar">separator</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktVar">width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:max-width</span><span class="hspace">&nbsp;</span><span class="RktVar">max-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:min-width</span><span class="hspace">&nbsp;</span><span class="RktVar">min-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:limit-marker</span><span class="hspace">&nbsp;</span><span class="RktVar">limit-marker</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:limit-prefix?</span><span class="hspace">&nbsp;</span><span class="RktVar">limit-prefix?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:align</span><span class="hspace">&nbsp;</span><span class="RktVar">align</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:left-pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">left-pad-string</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:right-pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">right-pad-string</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">separator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">""</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">max-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">min-width</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit-marker</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">""</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit-prefix?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">align</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">left</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">center</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">right</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">left</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">" "</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">left-pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">right-pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/format..rkt)._~7e..v))"></a><span title="Provided from: racket/format, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7e..v%29%29" class="RktValDef RktValLink" data-pltdoc="x">~.v</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:separator</span><span class="hspace">&nbsp;</span><span class="RktVar">separator</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktVar">width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:max-width</span><span class="hspace">&nbsp;</span><span class="RktVar">max-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:min-width</span><span class="hspace">&nbsp;</span><span class="RktVar">min-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:limit-marker</span><span class="hspace">&nbsp;</span><span class="RktVar">limit-marker</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:limit-prefix?</span><span class="hspace">&nbsp;</span><span class="RktVar">limit-prefix?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:align</span><span class="hspace">&nbsp;</span><span class="RktVar">align</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:left-pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">left-pad-string</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:right-pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">right-pad-string</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">separator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">" "</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">max-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">min-width</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit-marker</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">"..."</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit-prefix?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">align</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">left</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">center</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">right</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">left</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">" "</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">left-pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">right-pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/format..rkt)._~7e..s))"></a><span title="Provided from: racket/format, racket | Package: base"><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7e..s%29%29" class="RktValDef RktValLink" data-pltdoc="x">~.s</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:separator</span><span class="hspace">&nbsp;</span><span class="RktVar">separator</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktVar">width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:max-width</span><span class="hspace">&nbsp;</span><span class="RktVar">max-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:min-width</span><span class="hspace">&nbsp;</span><span class="RktVar">min-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:limit-marker</span><span class="hspace">&nbsp;</span><span class="RktVar">limit-marker</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:limit-prefix?</span><span class="hspace">&nbsp;</span><span class="RktVar">limit-prefix?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:align</span><span class="hspace">&nbsp;</span><span class="RktVar">align</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:left-pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">left-pad-string</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:right-pad-string</span><span class="hspace">&nbsp;</span><span class="RktVar">right-pad-string</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">separator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">" "</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">max-width</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">min-width</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktVar">width</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit-marker</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">"..."</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">limit-prefix?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">align</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">left</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">center</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">right</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">left</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">" "</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">left-pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">right-pad-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fstring..rkt%29._non-empty-string~3f%29%29" class="RktValLink" data-pltdoc="x">non-empty-string?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">pad-string</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ea%29%29" class="RktValLink" data-pltdoc="x">~a</a></span>, <span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7ev%29%29" class="RktValLink" data-pltdoc="x">~v</a></span>, and <span class="RktSym"><a href="strings.html#%28def._%28%28lib._racket%2Fformat..rkt%29._~7es%29%29" class="RktValLink" data-pltdoc="x">~s</a></span>, but each <span class="RktVar">v</span> is
+formatted like <span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="stt"> </span><span class="RktVal">"~.a"</span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span>, <span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="stt"> </span><span class="RktVal">"~.v"</span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span>,
+and <span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="stt"> </span><span class="RktVal">"~.s"</span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span>, respectively.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="extflonums.html" title="backward to &quot;4.3.5 Extflonums&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="bytestrings.html" title="forward to &quot;4.5 Byte Strings&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/struct-copy.html b/clones/docs.racket-lang.org/reference/struct-copy.html
new file mode 100644
index 00000000..2eb21b38
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/struct-copy.html
@@ -0,0 +1,24 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>5.5&nbsp;Copying and Updating Structures</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewselflink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">5.1&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Defining Structure Types:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">struct</span></span></a></td></tr><tr><td align="right">5.2&nbsp;</td><td><a href="creatingmorestructs.html" class="tocviewlink" data-pltdoc="x">Creating Structure Types</a></td></tr><tr><td align="right">5.3&nbsp;</td><td><a href="structprops.html" class="tocviewlink" data-pltdoc="x">Structure Type Properties</a></td></tr><tr><td align="right">5.4&nbsp;</td><td><a href="struct-generics.html" class="tocviewlink" data-pltdoc="x">Generic Interfaces</a></td></tr><tr><td align="right">5.5&nbsp;</td><td><a href="struct-copy.html" class="tocviewselflink" data-pltdoc="x">Copying and Updating Structures</a></td></tr><tr><td align="right">5.6&nbsp;</td><td><a href="structutils.html" class="tocviewlink" data-pltdoc="x">Structure Utilities</a></td></tr><tr><td align="right">5.7&nbsp;</td><td><a href="structinfo.html" class="tocviewlink" data-pltdoc="x">Structure Type Transformer Binding</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="struct-copy.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-copy%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">struct-<wbr></wbr>copy</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="struct-generics.html" title="backward to &quot;5.4 Generic Interfaces&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="structures.html" title="up to &quot;5 Structures&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="structutils.html" title="forward to &quot;5.6 Structure Utilities&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;struct-copy&quot;">5.5<tt>&nbsp;</tt><a name="(part._struct-copy)"></a>Copying and Updating Structures</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/base..rkt)._struct-copy))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="struct-copy.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-copy%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">struct-copy</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">struct-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">fld-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">fld-id</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">field-id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">field-id</span><span class="hspace">&nbsp;</span><span class="RktPn">#:parent</span><span class="hspace">&nbsp;</span><span class="RktVar">parent-id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new instance of the structure type <span class="RktVar">id</span> (which is defined via a
+<a href="define-struct.html" data-pltdoc="x">structure type defining form</a> such as <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>)
+with the same field values as the structure produced by <span class="RktVar">struct-expr</span>, except
+that the value of each supplied <span class="RktVar">field-id</span> is instead
+determined by the corresponding <span class="RktVar">expr</span>. If <span class="RktPn">#:parent</span>
+is specified, the <span class="RktVar">parent-id</span> must be bound to a parent
+structure type of <span class="RktVar">id</span>.</div></p><p>The <span class="RktVar">id</span> must have a <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding that
+encapsulates information about a structure type (i.e., like the
+initial identifier bound by <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>), and the binding
+must supply a constructor, a predicate, and all field accessors.</p><p>Each <span class="RktVar">field-id</span> must correspond to a <span class="RktVar">field-id</span> in
+the <a href="define-struct.html" data-pltdoc="x">structure type defining forms</a> of <span class="RktVar">id</span>
+(or <span class="RktVar">parent-id</span>, if present). The accessor bindings determined by different
+<span class="RktVar">field-id</span>s under the same <span class="RktVar">id</span> (or <span class="RktVar">parent-id</span>, if present)
+must be distinct. The order of the
+<span class="RktVar">field-id</span>s need not match the order of the corresponding
+fields in the structure type.</p><p>The <span class="RktVar">struct-expr</span> is evaluated first. The result must be an
+instance of the <span class="RktVar">id</span> structure type, otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. Next, the field <span class="RktVar">expr</span>s are
+evaluated in order (even if the fields that correspond to the
+<span class="RktVar">field-id</span>s are in a different order). Finally, the new
+structure instance is created.</p><p>The result of <span class="RktVar">struct-expr</span> can be an instance of a sub-type of
+<span class="RktVar">id</span>, but the resulting copy is an immediate instance of
+<span class="RktVar">id</span> (not the sub-type).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">color</span><span class="hspace">&nbsp;</span><span class="RktSym">weight</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">marlin</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">orange-and-white</span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dory</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="struct-copy.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-copy%29%29" class="RktStxLink" data-pltdoc="x">struct-copy</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktSym">marlin</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">color</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">blue</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">dory</span></td></tr><tr><td><p><span class="RktRes">(fish 'blue 11)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">shark</span><span class="hspace">&nbsp;</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">weeks-since-eating-fish</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bruce</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">shark</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">grey</span><span class="hspace">&nbsp;</span><span class="RktVal">110</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chum</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="struct-copy.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-copy%29%29" class="RktStxLink" data-pltdoc="x">struct-copy</a></span><span class="hspace">&nbsp;</span><span class="RktSym">shark</span><span class="hspace">&nbsp;</span><span class="RktSym">bruce</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">weight</span><span class="hspace">&nbsp;</span><span class="RktPn">#:parent</span><span class="hspace">&nbsp;</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktVal">90</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">weeks-since-eating-fish</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">chum</span></td></tr><tr><td><p><span class="RktRes">(shark 'grey 90 0)</span></p></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">subtypes can be copied as if they were supertypes,</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">but the result is an instance of the supertype</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">not-really-chum</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="struct-copy.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-copy%29%29" class="RktStxLink" data-pltdoc="x">struct-copy</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktSym">bruce</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">weight</span><span class="hspace">&nbsp;</span><span class="RktVal">90</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">not-really-chum</span></td></tr><tr><td><p><span class="RktRes">(fish 'grey 90)</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="struct-generics.html" title="backward to &quot;5.4 Generic Interfaces&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="structures.html" title="up to &quot;5 Structures&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="structutils.html" title="forward to &quot;5.6 Structure Utilities&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/struct-generics.html b/clones/docs.racket-lang.org/reference/struct-generics.html
new file mode 100644
index 00000000..6eebc868
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/struct-generics.html
@@ -0,0 +1,103 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>5.4&nbsp;Generic Interfaces</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewselflink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">5.1&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Defining Structure Types:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">struct</span></span></a></td></tr><tr><td align="right">5.2&nbsp;</td><td><a href="creatingmorestructs.html" class="tocviewlink" data-pltdoc="x">Creating Structure Types</a></td></tr><tr><td align="right">5.3&nbsp;</td><td><a href="structprops.html" class="tocviewlink" data-pltdoc="x">Structure Type Properties</a></td></tr><tr><td align="right">5.4&nbsp;</td><td><a href="struct-generics.html" class="tocviewselflink" data-pltdoc="x">Generic Interfaces</a></td></tr><tr><td align="right">5.5&nbsp;</td><td><a href="struct-copy.html" class="tocviewlink" data-pltdoc="x">Copying and Updating Structures</a></td></tr><tr><td align="right">5.6&nbsp;</td><td><a href="structutils.html" class="tocviewlink" data-pltdoc="x">Structure Utilities</a></td></tr><tr><td align="right">5.7&nbsp;</td><td><a href="structinfo.html" class="tocviewlink" data-pltdoc="x">Structure Type Transformer Binding</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._define-generics%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>generics</span></span></a></td></tr><tr><td><a href="struct-generics.html#%28def._%28%28lib._racket%2Fgeneric..rkt%29._raise-support-error%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">raise-<wbr></wbr>support-<wbr></wbr>error</span></span></a></td></tr><tr><td><a href="struct-generics.html#%28def._%28%28lib._racket%2Fgeneric..rkt%29._exn~3afail~3asupport%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">exn:<span class="mywbr"> &nbsp;</span>fail:<span class="mywbr"> &nbsp;</span>support</span></span></a></td></tr><tr><td><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._define%2Fgeneric%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/<span class="mywbr"> &nbsp;</span>generic</span></span></a></td></tr><tr><td><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._generic-instance%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">generic-<wbr></wbr>instance/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._impersonate-generics%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">impersonate-<wbr></wbr>generics</span></span></a></td></tr><tr><td><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._chaperone-generics%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">chaperone-<wbr></wbr>generics</span></span></a></td></tr><tr><td><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._redirect-generics%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">redirect-<wbr></wbr>generics</span></span></a></td></tr><tr><td><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._make-struct-type-property%2Fgeneric%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">make-<wbr></wbr>struct-<wbr></wbr>type-<wbr></wbr>property/<span class="mywbr"> &nbsp;</span>generic</span></span></a></td></tr><tr><td><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._make-generic-struct-type-property%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">make-<wbr></wbr>generic-<wbr></wbr>struct-<wbr></wbr>type-<wbr></wbr>property</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="versionbox"><span class="version">8.6</span></div><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="structprops.html" title="backward to &quot;5.3 Structure Type Properties&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="structures.html" title="up to &quot;5 Structures&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="struct-copy.html" title="forward to &quot;5.5 Copying and Updating Structures&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;struct-generics&quot;">5.4<tt>&nbsp;</tt><a name="(part._struct-generics)"></a><a name="(mod-path._racket/generic)"></a>Generic Interfaces</h4><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="struct-generics.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/generic</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></p><p>A <a name="(tech._generic._interface)"></a><span style="font-style: italic">generic interface</span> allows per-type methods to be
+associated with generic functions. Generic functions are defined
+using a <span class="RktSym"><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._define-generics%29%29" class="RktStxLink" data-pltdoc="x">define-generics</a></span> form. Method implementations for
+a structure type are defined using the <span class="RktPn">#:methods</span> keyword
+(see <a href="define-struct.html" data-pltdoc="x">Defining Structure Types: <span class="RktSym"><span class="RktStxLink">struct</span></span></a>).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/generic..rkt)._define-generics))"></a><span title="Provided from: racket/generic | Package: base"><span class="RktSym"><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._define-generics%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-generics</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">generics-opt</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVar">method-id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">kw-formals*</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">generics-opt</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">generics-opt</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:defaults</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">default-pred?</span><span class="hspace">&nbsp;</span><span class="RktVar">default-impl</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:fast-defaults</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">fast-pred?</span><span class="hspace">&nbsp;</span><span class="RktVar">fast-impl</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:fallbacks</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">fallback-impl</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:defined-predicate</span><span class="hspace">&nbsp;</span><span class="RktVar">defined-pred-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:defined-table</span><span class="hspace">&nbsp;</span><span class="RktVar">defined-table-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:derive-property</span><span class="hspace">&nbsp;</span><span class="RktVar">prop-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">prop-value-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">kw-formals*</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">arg*</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">arg*</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">rest-id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">rest-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">arg*</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">arg-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">arg-id</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktVar">arg-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">keyword</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">arg-id</span><span class="RktPn">]</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Defines the following names, plus any specified by keyword options.</div></p><ul><li><p><span class="RktSym">gen:</span><span class="RktVar">id</span> as a transformer binding for
+the static information about a new generic interface;</p></li><li><p><span class="RktVar">id</span><span class="RktSym">?</span> as a predicate identifying
+instances of structure types that implement this generic group; and</p></li><li><p>each <span class="RktVar">method-id</span> as a <a name="(tech._generic._method)"></a><span style="font-style: italic">generic method</span> that calls the
+corresponding method on values where
+<span class="RktVar">id</span><span class="RktSym">?</span> is true.
+Each <span class="RktVar">method-id</span>&rsquo;s <span class="RktVar">kw-formals*</span> must include a required
+by-position argument that is <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span> to
+<span class="RktVar">id</span>. That argument is used in the generic definition to
+locate the specialization.</p></li><li><p><span class="RktVar">id</span><span class="RktSym">/c</span> as a contract combinator that
+recognizes instances of structure types which implement the
+<span class="RktSym">gen:</span><span class="RktVar">id</span> generic interface. The combinator
+takes pairs of <span class="RktVar">method-id</span>s and contracts. The contracts
+will be applied to each of the corresponding method implementations.
+The <span class="RktVar">id</span><span class="RktSym">/c</span> combinator is intended to be used to
+contract the range of a constructor procedure for a struct type that
+implements the generic interface.</p></li></ul><p>The <span class="RktPn">#:defaults</span> option may be provided at most once.
+When it is provided, each generic function
+uses <span class="RktVar">default-pred?</span>s to dispatch to the given
+<a name="(tech._default._method)"></a><span style="font-style: italic">default method</span> implementations,
+<span class="RktVar">default-impl</span>s, if dispatching to the generic method table fails.
+The syntax of the <span class="RktVar">default-impl</span>s is the same as the methods
+provided for the <span class="RktPn">#:methods</span> keyword for <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>.</p><p>The <span class="RktPn">#:fast-defaults</span> option may be provided at most once.
+It works the same as <span class="RktPn">#:defaults</span>, except the <span class="RktVar">fast-pred?</span>s are
+checked before dispatching to the generic method table.  This option is
+intended to provide a fast path for dispatching to built-in datatypes, such as
+lists and vectors, that do not overlap with structures implementing
+<span class="RktSym">gen:</span><span class="RktVar">id</span>.</p><p>The <span class="RktPn">#:fallbacks</span> option may be provided at most once.
+When it is provided, the <span class="RktVar">fallback-impl</span>s define
+<a name="(tech._fallback._method)"></a><span style="font-style: italic">fallback method</span> implementations
+that are used for any instance of the generic interface that does not supply a
+specific implementation.  The syntax of the <span class="RktVar">fallback-impl</span>s is the same
+as the methods provided for the <span class="RktPn">#:methods</span> keyword for <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>.</p><p>The <span class="RktPn">#:defined-predicate</span> option may be provided at most once.
+When it is provided, <span class="RktVar">defined-pred-id</span> is defined as a
+procedure that reports whether a specific instance of the generic interface
+implements a given set of methods.
+Specifically, <span class="RktPn">(</span><span class="RktVar">defined-pred-id</span><span class="stt"> </span><span class="RktSym">v</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">name</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> produces <span class="RktVal">#t</span> if
+<span class="RktSym">v</span> has implementations for each method <span class="RktSym">name</span>, not counting
+<span class="RktPn">#:fallbacks</span> implementations, and produces <span class="RktVal">#f</span> otherwise.
+This procedure is intended for use by
+higher-level APIs to adapt their behavior depending on method
+availability.</p><p>The <span class="RktPn">#:defined-table</span> option may be provided at most once.
+When it is provided, <span class="RktVar">defined-table-id</span> is defined as a
+procedure that takes an instance of the generic interface and returns an
+immutable <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash table</span></a> that maps symbols corresponding to method
+names to booleans representing whether or not that method is
+implemented by the instance.  This option is deprecated; use
+<span class="RktPn">#:defined-predicate</span> instead.</p><p>The <span class="RktPn">#:derive-property</span> option may be provided any number of times.
+Each time it is provided, it specifies a <a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property</span></a> via
+<span class="RktVar">prop-expr</span> and a value for the property via <span class="RktVar">prop-value-expr</span>.
+All structures implementing the generic interface via <span class="RktPn">#:methods</span>
+automatically implement this structure type property using the provided values.
+When <span class="RktVar">prop-value-expr</span> is executed, each <span class="RktVar">method-id</span> is bound to
+its specific implementation for the <a href="structures.html#%28tech._structure._type%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type</span></a>.</p><p>If a value <span class="RktSym">v</span> satisfies <span class="RktVar">id</span><span class="RktSym">?</span>, then <span class="RktSym">v</span> is
+a <a name="(tech._generic._instance)"></a><span style="font-style: italic">generic instance</span> of <span class="RktSym">gen:</span><span class="RktVar">id</span>.</p><p>If a generic instance <span class="RktSym">v</span> has a corresponding implementation for some
+<span class="RktVar">method-id</span> provided via <span class="RktPn">#:methods</span> in <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> or via
+<span class="RktPn">#:defaults</span> or <span class="RktPn">#:fast-defaults</span> in <span class="RktSym"><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._define-generics%29%29" class="RktStxLink" data-pltdoc="x">define-generics</a></span>,
+then <span class="RktVar">method-id</span> is an <a name="(tech._implemented._generic._method)"></a><span style="font-style: italic">implemented generic method</span> of
+<span class="RktSym">v</span>.</p><p>If <span class="RktVar">method-id</span> is not an implemented generic method of a generic
+instance <span class="RktSym">v</span>, and <span class="RktVar">method-id</span> has a fallback implementation that
+does not raise an <span class="RktSym"><a href="struct-generics.html#%28def._%28%28lib._racket%2Fgeneric..rkt%29._exn~3afail~3asupport%29%29" class="RktValLink" data-pltdoc="x">exn:fail:support</a></span> exception when given <span class="RktSym">v</span>,
+then <span class="RktVar">method-id</span> is a <a name="(tech._supported._generic._method)"></a><span style="font-style: italic">supported generic method</span> of <span class="RktSym">v</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/generic..rkt)._raise-support-error))"></a><span title="Provided from: racket/generic | Package: base"><span class="RktSym"><a href="struct-generics.html#%28def._%28%28lib._racket%2Fgeneric..rkt%29._raise-support-error%29%29" class="RktValDef RktValLink" data-pltdoc="x">raise-support-error</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._none%2Fc%29%29" class="RktValLink" data-pltdoc="x">none/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Raises an <span class="RktSym"><a href="struct-generics.html#%28def._%28%28lib._racket%2Fgeneric..rkt%29._exn~3afail~3asupport%29%29" class="RktValLink" data-pltdoc="x">exn:fail:support</a></span> exception for a <a href="struct-generics.html#%28tech._generic._method%29" data-pltdoc="x">generic
+method</a> called <span class="RktVar">name</span> that does not support the <a href="struct-generics.html#%28tech._generic._instance%29" data-pltdoc="x">generic
+instance</a> <span class="RktVar">v</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="struct-generics.html#%28def._%28%28lib._racket%2Fgeneric..rkt%29._raise-support-error%29%29" class="RktValLink" data-pltdoc="x">raise-support-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">some-method-name</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"arbitrary"</span><span class="hspace">&nbsp;</span><span class="RktVal">"instance"</span><span class="hspace">&nbsp;</span><span class="RktVal">"value"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">some-method-name: not implemented for '("arbitrary"</span></p></td></tr><tr><td><p><span class="RktErr">"instance" "value")</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/generic..rkt)._exn~3afail~3asupport~3f))"></a><a name="(def._((lib._racket/generic..rkt)._struct~3aexn~3afail~3asupport))"></a><a name="(def._((lib._racket/generic..rkt)._exn~3afail~3asupport))"></a><span title="Provided from: racket/generic | Package: base"><span class="RktSym"><a href="struct-generics.html#%28def._%28%28lib._racket%2Fgeneric..rkt%29._exn~3afail~3asupport%29%29" class="RktValDef RktValLink" data-pltdoc="x">exn:fail:support</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Raised for <a href="struct-generics.html#%28tech._generic._method%29" data-pltdoc="x">generic methods</a> that do not support the given
+<a href="struct-generics.html#%28tech._generic._instance%29" data-pltdoc="x">generic instance</a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/generic..rkt)._define/generic))"></a><span title="Provided from: racket/generic | Package: base"><span class="RktSym"><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._define%2Fgeneric%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/generic</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">local-id</span><span class="hspace">&nbsp;</span><span class="RktVar">method-id</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">When used inside the method definitions associated with the <span class="RktPn">#:methods</span>,
+<span class="RktPn">#:fallbacks</span>, <span class="RktPn">#:defaults</span> or <span class="RktPn">#:fast-defaults</span> keywords,
+binds <span class="RktVar">local-id</span> to the generic for <span class="RktVar">method-id</span>. This form is
+useful for method specializations to use generic methods (as opposed to the
+local specialization) on other values.</div></p><p><div class="SIntrapara">The <span class="RktSym"><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._define%2Fgeneric%29%29" class="RktStxLink" data-pltdoc="x">define/generic</a></span> form is only allowed inside:
+</div><div class="SIntrapara"><ul><li><p>a <span class="RktPn">#:methods</span> specification in <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> (or <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-struct%29%29" class="RktStxLink" data-pltdoc="x">define-struct</a></span>)</p></li><li><p>the specification of <span class="RktPn">#:fallbacks</span>, <span class="RktPn">#:defaults</span> or
+<span class="RktPn">#:fast-defaults</span> in <span class="RktSym"><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._define-generics%29%29" class="RktStxLink" data-pltdoc="x">define-generics</a></span></p></li></ul></div></p><p>Using <span class="RktSym"><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._define%2Fgeneric%29%29" class="RktStxLink" data-pltdoc="x">define/generic</a></span> elsewhere is a syntax error.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._define-generics%29%29" class="RktStxLink" data-pltdoc="x">define-generics</a></span><span class="hspace">&nbsp;</span><span class="RktSym">printable</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gen-print</span><span class="hspace">&nbsp;</span><span class="RktSym">printable</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">port</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gen-port-print</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktSym">printable</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gen-print*</span><span class="hspace">&nbsp;</span><span class="RktSym">printable</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">port</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktSym">width</span><span class="hspace">&nbsp;</span><span class="RktPn">#:height</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">height</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:defaults</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._define%2Fgeneric%29%29" class="RktStxLink" data-pltdoc="x">define/generic</a></span><span class="hspace">&nbsp;</span><span class="RktSym">super-print</span><span class="hspace">&nbsp;</span><span class="RktSym">gen-print</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gen-print</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._fprintf%29%29" class="RktValLink" data-pltdoc="x">fprintf</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktVal">"String: ~a"</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gen-port-print</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">we can call gen-print alternatively</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">super-print</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gen-print*</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktSym">w</span><span class="hspace">&nbsp;</span><span class="RktPn">#:height</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._fprintf%29%29" class="RktValLink" data-pltdoc="x">fprintf</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktVal">"String (~ax~a): ~a"</span><span class="hspace">&nbsp;</span><span class="RktSym">w</span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktSym">gen:printable</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gen-print</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._fprintf%29%29" class="RktValLink" data-pltdoc="x">fprintf</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktVal">"Num: ~a"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">num-v</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gen-port-print</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gen-print</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gen-print*</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktSym">w</span><span class="hspace">&nbsp;</span><span class="RktPn">#:height</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._fprintf%29%29" class="RktValLink" data-pltdoc="x">fprintf</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktVal">"Num (~ax~a): ~a"</span><span class="hspace">&nbsp;</span><span class="RktSym">w</span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">num-v</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">string+num</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktSym">gen:printable</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._define%2Fgeneric%29%29" class="RktStxLink" data-pltdoc="x">define/generic</a></span><span class="hspace">&nbsp;</span><span class="RktSym">super-print</span><span class="hspace">&nbsp;</span><span class="RktSym">gen-print</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._define%2Fgeneric%29%29" class="RktStxLink" data-pltdoc="x">define/generic</a></span><span class="hspace">&nbsp;</span><span class="RktSym">super-print*</span><span class="hspace">&nbsp;</span><span class="RktSym">gen-print*</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gen-print</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">super-print</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">string+num-v</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._fprintf%29%29" class="RktValLink" data-pltdoc="x">fprintf</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktVal">" "</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">super-print</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">string+num-n</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gen-port-print</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gen-print</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gen-print*</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktSym">w</span><span class="hspace">&nbsp;</span><span class="RktPn">#:height</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">super-print*</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">string+num-v</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktSym">w</span><span class="hspace">&nbsp;</span><span class="RktPn">#:height</span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._fprintf%29%29" class="RktValLink" data-pltdoc="x">fprintf</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktVal">" "</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">super-print*</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">string+num-n</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktSym">w</span><span class="hspace">&nbsp;</span><span class="RktPn">#:height</span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">num</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">gen-print</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Num: 10</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">gen-port-print</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Num: 10</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">gen-print*</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="hspace">&nbsp;</span><span class="RktPn">#:height</span><span class="hspace">&nbsp;</span><span class="RktVal">90</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Num (100x90): 10</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="hspace">&nbsp;</span><span class="RktVal">"Strings are printable too!"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">gen-print</span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">String: Strings are printable too!</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">string+num</span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">gen-print</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">String: Strings are printable too! Num: 10</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">gen-port-print</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">String: Strings are printable too! Num: 10</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">gen-print*</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="hspace">&nbsp;</span><span class="RktPn">#:height</span><span class="hspace">&nbsp;</span><span class="RktVal">90</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">String (100x90): Strings are printable too! Num (100x90): 10</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">define/contract</span><span class="hspace">&nbsp;</span><span class="RktSym">make-num-contracted</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._printable%2Fc%29%29" class="RktValLink" data-pltdoc="x">printable/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">gen-print</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">printable?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">gen-port-print</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">printable?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">gen-print*</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">printable?</span><span class="hspace">&nbsp;</span><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:height</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">num</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-num-contracted</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">gen-print*</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="hspace">&nbsp;</span><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktVal">"not a number"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:height</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">make-num-contracted: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: natural?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: "not a number"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the #:width argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">method gen-print*</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">the range of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">number?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(printable/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(gen-print</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt;* (printable?) (output-port?) void?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(gen-port-print</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; output-port? printable? void?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(gen-print*</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt;*</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(printable? #:width natural?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(output-port? #:height natural?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">void?))))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: </span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(definition make-num-contracted)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:16:0</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/generic..rkt)._generic-instance/c))"></a><span title="Provided from: racket/generic | Package: base"><span class="RktSym"><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._generic-instance%2Fc%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">generic-instance/c</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">gen-id</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">method-id</span><span class="hspace">&nbsp;</span><span class="RktVar">method-ctc</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">method-ctc</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Creates a contract that recognizes structures that implement the <a href="struct-generics.html#%28tech._generic._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">generic
+interface</span></a> <span class="RktVar">gen-id</span>, and constrains their implementations of the
+specified <span class="RktVar">method-id</span>s with the corresponding <span class="RktVar">method-ctc</span>s.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/generic..rkt)._impersonate-generics))"></a><span title="Provided from: racket/generic | Package: base"><span class="RktSym"><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._impersonate-generics%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">impersonate-generics</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">gen-id</span><span class="hspace">&nbsp;</span><span class="RktVar">val-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVar">method-id</span><span class="hspace">&nbsp;</span><span class="RktVar">method-proc-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">maybe-properties</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">maybe-properties</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:properties</span><span class="hspace">&nbsp;</span><span class="RktVar">props-expr</span></td></tr></table></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><blockquote class="SubFlow"><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">method-proc-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">props-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Creates an <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a> of <span class="RktVar">val-expr</span>, which must be a structure
+that implements the <a href="struct-generics.html#%28tech._generic._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">generic interface</span></a> <span class="RktVar">gen-id</span>.  The impersonator
+applies the results of the <span class="RktVar">method-proc-expr</span>s to the structure&rsquo;s implementation
+of the corresponding <span class="RktVar">method-id</span>s, and replaces the method
+implementation with the result.</div></p><p>A <span class="RktVar">props-expr</span> can provide properties to attach to the
+impersonator. The result of <span class="RktVar">props-expr</span> must be a list with
+an even number of elements, where the first element of the list is an
+impersonator property, the second element is its value, and so on.</p><p class="SHistory">Changed in version 6.1.1.8 of package <span class="stt">base</span>: Added <span class="RktPn">#:properties</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/generic..rkt)._chaperone-generics))"></a><span title="Provided from: racket/generic | Package: base"><span class="RktSym"><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._chaperone-generics%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">chaperone-generics</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">gen-id</span><span class="hspace">&nbsp;</span><span class="RktVar">val-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVar">method-id</span><span class="hspace">&nbsp;</span><span class="RktVar">method-proc-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">maybe-properties</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._impersonate-generics%29%29" class="RktStxLink" data-pltdoc="x">impersonate-generics</a></span>, but
+creates a <a href="chaperones.html#%28tech._chaperone%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone</span></a> of <span class="RktVar">val-expr</span>, which must be a structure
+that implements the <a href="struct-generics.html#%28tech._generic._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">generic interface</span></a> <span class="RktVar">gen-id</span>.  The chaperone
+applies the specified <span class="RktSym">method-proc</span>s to the structure&rsquo;s implementation
+of the corresponding <span class="RktVar">method-id</span>s, and replaces the method
+implementation with the result, which must be a chaperone of the original.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/generic..rkt)._redirect-generics))"></a><span title="Provided from: racket/generic | Package: base"><span class="RktSym"><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._redirect-generics%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">redirect-generics</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">mode</span><span class="hspace">&nbsp;</span><span class="RktVar">gen-id</span><span class="hspace">&nbsp;</span><span class="RktVar">val-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVar">method-id</span><span class="hspace">&nbsp;</span><span class="RktVar">method-proc-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVar">maybe-properties</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._impersonate-generics%29%29" class="RktStxLink" data-pltdoc="x">impersonate-generics</a></span>, but
+creates an <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonator</span></a> of <span class="RktVar">val-expr</span>
+if <span class="RktVar">mode</span> evaluates to <span class="RktVal">#f</span>, or creates
+a <a href="chaperones.html#%28tech._chaperone%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone</span></a> of <span class="RktVar">val-expr</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/generic..rkt)._make-struct-type-property/generic))"></a><span title="Provided from: racket/generic | Package: base"><span class="RktSym"><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._make-struct-type-property%2Fgeneric%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">make-struct-type-property/generic</a></span></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">maybe-guard-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">maybe-supers-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">maybe-can-impersonate?-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">property-option</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">maybe-guard-expr</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">guard-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">maybe-supers-expr</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">supers-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">maybe-can-impersonate?-expr</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">can-impersonate?-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">property-option</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:property</span><span class="hspace">&nbsp;</span><span class="RktVar">prop-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">val-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktVar">gen:name-id</span><span class="hspace">&nbsp;</span><span class="RktVar">method-defs</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">method-defs</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">definition</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><blockquote class="SubFlow"><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">name-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">guard-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">can-impersonate</span><span class="RktPn">)</span></td></tr></table><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">supers-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">can-impersonate?-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">prop-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></td></tr></table><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">val-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new structure type property and returns three
+values, just like <span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type-property%29%29" class="RktValLink" data-pltdoc="x">make-struct-type-property</a></span> would:</div></p><ul><li><p>a <a href="structprops.html#%28tech._structure._type._property._descriptor%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property descriptor</span></a></p></li><li><p>a <a href="structprops.html#%28tech._property._predicate%29" class="techoutside" data-pltdoc="x"><span class="techinside">property predicate</span></a> procedure</p></li><li><p>a <a href="structprops.html#%28tech._property._accessor%29" class="techoutside" data-pltdoc="x"><span class="techinside">property accessor</span></a> procedure</p></li></ul><p>Any struct that implements this property will also implement
+the properties and <a href="struct-generics.html#%28tech._generic._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">generic interfaces</span></a> given in the
+<span class="RktPn">#:property</span> and <span class="RktPn">#:methods</span> declarations.
+The property <span class="RktVar">val-expr</span>s and <span class="RktSym">method-def</span>s are
+evaluated eagerly when the property is created, not when
+it is attached to a structure type.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/generic..rkt)._make-generic-struct-type-property))"></a><span title="Provided from: racket/generic | Package: base"><span class="RktSym"><a href="struct-generics.html#%28form._%28%28lib._racket%2Fgeneric..rkt%29._make-generic-struct-type-property%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">make-generic-struct-type-property</a></span></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVar">gen:name-id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVar">method-def</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new structure type property and returns the
+<a href="structprops.html#%28tech._structure._type._property._descriptor%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property descriptor</span></a>.</div></p><p>Any struct that implements this property will also implement
+the <a href="struct-generics.html#%28tech._generic._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">generic interface</span></a> given by <span class="RktVar">gen:name-id</span>
+with the given <span class="RktVar">method-def</span>s. The <span class="RktVar">method-def</span>s
+are evaluated eagerly when the property is created, not when
+it is attached to a structure type.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="structprops.html" title="backward to &quot;5.3 Structure Type Properties&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="structures.html" title="up to &quot;5 Structures&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="struct-copy.html" title="forward to &quot;5.5 Copying and Updating Structures&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/structinfo.html b/clones/docs.racket-lang.org/reference/structinfo.html
new file mode 100644
index 00000000..1da836ec
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/structinfo.html
@@ -0,0 +1,103 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>5.7&nbsp;Structure Type Transformer Binding</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewselflink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">5.1&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Defining Structure Types:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">struct</span></span></a></td></tr><tr><td align="right">5.2&nbsp;</td><td><a href="creatingmorestructs.html" class="tocviewlink" data-pltdoc="x">Creating Structure Types</a></td></tr><tr><td align="right">5.3&nbsp;</td><td><a href="structprops.html" class="tocviewlink" data-pltdoc="x">Structure Type Properties</a></td></tr><tr><td align="right">5.4&nbsp;</td><td><a href="struct-generics.html" class="tocviewlink" data-pltdoc="x">Generic Interfaces</a></td></tr><tr><td align="right">5.5&nbsp;</td><td><a href="struct-copy.html" class="tocviewlink" data-pltdoc="x">Copying and Updating Structures</a></td></tr><tr><td align="right">5.6&nbsp;</td><td><a href="structutils.html" class="tocviewlink" data-pltdoc="x">Structure Utilities</a></td></tr><tr><td align="right">5.7&nbsp;</td><td><a href="structinfo.html" class="tocviewselflink" data-pltdoc="x">Structure Type Transformer Binding</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-info~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>info?</span></span></a></td></tr><tr><td><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._checked-struct-info~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">checked-<wbr></wbr>struct-<wbr></wbr>info?</span></span></a></td></tr><tr><td><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._make-struct-info%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>struct-<wbr></wbr>info</span></span></a></td></tr><tr><td><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._extract-struct-info%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extract-<wbr></wbr>struct-<wbr></wbr>info</span></span></a></td></tr><tr><td><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct~3astruct-info%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct:<span class="mywbr"> &nbsp;</span>struct-<wbr></wbr>info</span></span></a></td></tr><tr><td><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._prop~3astruct-info%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>struct-<wbr></wbr>info</span></span></a></td></tr><tr><td><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._prop~3astruct-auto-info%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>struct-<wbr></wbr>auto-<wbr></wbr>info</span></span></a></td></tr><tr><td><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-auto-info~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>auto-<wbr></wbr>info?</span></span></a></td></tr><tr><td><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-auto-info-lists%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>auto-<wbr></wbr>info-<wbr></wbr>lists</span></span></a></td></tr><tr><td><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._prop~3astruct-field-info%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>struct-<wbr></wbr>field-<wbr></wbr>info</span></span></a></td></tr><tr><td><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-field-info~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>field-<wbr></wbr>info?</span></span></a></td></tr><tr><td><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-field-info-list%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>field-<wbr></wbr>info-<wbr></wbr>list</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="structutils.html" title="backward to &quot;5.6 Structure Utilities&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="structures.html" title="up to &quot;5 Structures&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="forward to &quot;6 Classes and Objects&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;structinfo&quot;">5.7<tt>&nbsp;</tt><a name="(part._structinfo)"></a><a name="(mod-path._racket/struct-info)"></a>Structure Type Transformer Binding</h4><p>The <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> form binds the name of a structure type as
+a <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding that records the other identifiers bound
+to the structure type, the constructor procedure, the predicate
+procedure, and the field accessor and mutator procedures. This
+information can be used during the expansion of other expressions via
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value</a></span>.</p><p>For example, the <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> variant for subtypes uses the
+base type name <span class="RktVar">t</span> to find the variable
+<span class="RktSym">struct:</span><span class="RktVar">t</span> containing the base type&rsquo;s descriptor; it
+also folds the field accessor and mutator information for the base
+type into the information for the subtype. As another example, the
+<span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span> form uses a type name to find the predicates and field
+accessors for the structure type. The <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> form in an
+imported signature for <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span> causes the <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span>
+transformer to generate information about imported structure types, so
+that <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span> and subtyping <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> forms work
+within the unit.</p><p>The expansion-time information for a structure type can be represented
+directly as a list of six elements (of the same sort that the
+encapsulated procedure must return):</p><ul><li><p>an identifier that is bound to the structure type&rsquo;s descriptor,
+or <span class="RktVal">#f</span> if none is known;</p></li><li><p>an identifier that is bound to the structure type&rsquo;s constructor,
+or <span class="RktVal">#f</span> if none is known;</p></li><li><p>an identifier that is bound to the structure type&rsquo;s predicate,
+or <span class="RktVal">#f</span> if none is known;</p></li><li><p>a list of identifiers bound to the field accessors of the
+structure type, optionally with <span class="RktVal">#f</span> as the list&rsquo;s last
+element. A <span class="RktVal">#f</span> as the last element indicates that the
+structure type may have additional fields, otherwise the list is a
+reliable indicator of the number of fields in the structure
+type. Furthermore, the accessors are listed in reverse order for the
+corresponding constructor arguments. (The reverse order enables
+sharing in the lists for a subtype and its base type.)</p></li><li><p>a list of identifiers bound to the field mutators of
+the structure type, or <span class="RktVal">#f</span> for each field that has no known
+mutator, and optionally with an extra <span class="RktVal">#f</span> as the list&rsquo;s last
+element (if the accessor list has such a <span class="RktVal">#f</span>). The list&rsquo;s
+order and the meaning of a final <span class="RktVal">#f</span> are the same as for the
+accessor identifiers, and the length of the mutator list is the same
+as the accessor list&rsquo;s length.</p></li><li><p>an identifier that determines a super-type for the structure
+type, <span class="RktVal">#f</span> if the super-type (if any) is unknown, or
+<span class="RktVal">#t</span> if there is no super-type. If a super-type is specified,
+the identifier is also bound to structure-type expansion-time
+information.</p></li></ul><p>Instead of this direct representation, the representation can be a
+structure created by <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._make-struct-info%29%29" class="RktValLink" data-pltdoc="x">make-struct-info</a></span> (or an instance of a
+subtype of <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct~3astruct-info%29%29" class="RktValLink" data-pltdoc="x">struct:struct-info</a></span>), which encapsulates a
+procedure that takes no arguments and returns a list of six
+elements. Alternately, the representation can be a structure whose
+type has the <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._prop~3astruct-info%29%29" class="RktValLink" data-pltdoc="x">prop:struct-info</a></span> <a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property</span></a>.
+Finally, the representation can be an instance of a structure type
+derived from <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct~3astruct-info%29%29" class="RktValLink" data-pltdoc="x">struct:struct-info</a></span> or with the
+<span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._prop~3astruct-info%29%29" class="RktValLink" data-pltdoc="x">prop:struct-info</a></span> property that also implements
+<span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="RktValLink" data-pltdoc="x">prop:procedure</a></span>, and where the instance is further is wrapped
+by <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-set%21-transformer%29%29" class="RktValLink" data-pltdoc="x">make-set!-transformer</a></span>. In addition, the representation may
+implement the <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._prop~3astruct-auto-info%29%29" class="RktValLink" data-pltdoc="x">prop:struct-auto-info</a></span> and
+<span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._prop~3astruct-field-info%29%29" class="RktValLink" data-pltdoc="x">prop:struct-field-info</a></span> properties.</p><p>Use <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-info~3f%29%29" class="RktValLink" data-pltdoc="x">struct-info?</a></span> to recognize all allowed forms of the
+information, and use <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._extract-struct-info%29%29" class="RktValLink" data-pltdoc="x">extract-struct-info</a></span> to obtain a list
+from any representation.</p><p>The implementor of a syntactic form can expect users of the form to
+know what kind of information is available about a structure type. For
+example, the <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span> implementation works with structure
+information containing an incomplete set of accessor bindings, because
+the user is assumed to know what information is available in the
+context of the <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span> expression. In particular, the
+<span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span> expression can appear in a <span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%29%29" class="RktStxLink" data-pltdoc="x">unit</a></span> form with an
+imported structure type, in which case the user is expected to know
+the set of fields that are listed in the signature for the structure
+type.</p><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="structinfo.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/struct-info</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="structinfo.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/struct-info</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/struct-info..rkt)._struct-info~3f))"></a><span title="Provided from: racket/struct-info | Package: base"><span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-info~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-info?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is either a six-element list with
+the correct shape for representing structure-type information, a
+procedure encapsulated by <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._make-struct-info%29%29" class="RktValLink" data-pltdoc="x">make-struct-info</a></span>, a structure with
+the <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._prop~3astruct-info%29%29" class="RktValLink" data-pltdoc="x">prop:struct-info</a></span> property, or a structure type derived
+from <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct~3astruct-info%29%29" class="RktValLink" data-pltdoc="x">struct:struct-info</a></span> or with <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._prop~3astruct-info%29%29" class="RktValLink" data-pltdoc="x">prop:struct-info</a></span> and
+wrapped with <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-set%21-transformer%29%29" class="RktValLink" data-pltdoc="x">make-set!-transformer</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/struct-info..rkt)._checked-struct-info~3f))"></a><span title="Provided from: racket/struct-info | Package: base"><span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._checked-struct-info~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">checked-struct-info?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a procedure encapsulated by
+<span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._make-struct-info%29%29" class="RktValLink" data-pltdoc="x">make-struct-info</a></span> and produced by <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>, but
+only when no parent type is specified or the parent type is also
+specified through a transformer binding to such a value.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/struct-info..rkt)._make-struct-info))"></a><span title="Provided from: racket/struct-info | Package: base"><span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._make-struct-info%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-struct-info</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thunk</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-info~3f%29%29" class="RktValLink" data-pltdoc="x">struct-info?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-info~3f%29%29" class="RktValLink" data-pltdoc="x">struct-info?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Encapsulates a thunk that returns structure-type information in list
+form. Note that accessors are listed in reverse order, as mentioned in <a href="structinfo.html" data-pltdoc="x">Structure Type Transformer Binding</a>.
+Note that the field names are not well-defined for struct-type informations
+that are created with this method, so it is likely not going to work well
+with forms like <span class="RktSym"><a href="struct-copy.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-copy%29%29" class="RktStxLink" data-pltdoc="x">struct-copy</a></span> and <span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._struct%2A%29%29" class="RktStxLink" data-pltdoc="x">struct*</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">new-pair?</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"new pair?"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">new-car</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"new car"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">new-cdr</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"new cdr"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">new-list</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._make-struct-info%29%29" class="RktValLink" data-pltdoc="x">make-struct-info</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">new-pair?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">new-cdr</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">new-car</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">new-list</span><span class="hspace">&nbsp;</span><span class="RktSym">hd</span><span class="hspace">&nbsp;</span><span class="RktSym">tl</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._append%29%29" class="RktValLink" data-pltdoc="x">append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tl</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hd</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">new pair?</span></p></td></tr><tr><td><p><span class="RktOut">new car</span></p></td></tr><tr><td><p><span class="RktOut">new cdr</span></p></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(2 3 1)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">A</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">new-A-x</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"A-x"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">A-x</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">new-A-y</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"A-y"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">A-y</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">new-A?</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"A?"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">A?</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">A-info</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._make-struct-info%29%29" class="RktValLink" data-pltdoc="x">make-struct-info</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">A</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">A</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">new-A?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">new-A-y</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">new-A-x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._define-match-expander%29%29" class="RktStxLink" data-pltdoc="x">define-match-expander</a></span><span class="hspace">&nbsp;</span><span class="RktSym">B</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="RktStxLink" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">A-info</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="match.html#%28form._%28%28lib._racket%2Fmatch..rkt%29._match%29%29" class="RktStxLink" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">A</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">B</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">A?</span></p></td></tr><tr><td><p><span class="RktOut">A-x</span></p></td></tr><tr><td><p><span class="RktOut">A-y</span></p></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(20 10)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/struct-info..rkt)._extract-struct-info))"></a><span title="Provided from: racket/struct-info | Package: base"><span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._extract-struct-info%29%29" class="RktValDef RktValLink" data-pltdoc="x">extract-struct-info</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-info~3f%29%29" class="RktValLink" data-pltdoc="x">struct-info?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-info~3f%29%29" class="RktValLink" data-pltdoc="x">struct-info?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Extracts the list form of the structure type information represented
+by <span class="RktVar">v</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/struct-info..rkt)._struct~3astruct-info))"></a><span title="Provided from: racket/struct-info | Package: base"><span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct~3astruct-info%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct:struct-info</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-type~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">The <a href="define-struct.html#%28tech._structure._type._descriptor%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type descriptor</span></a> for the structure type returned
+by <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._make-struct-info%29%29" class="RktValLink" data-pltdoc="x">make-struct-info</a></span>. This <a href="define-struct.html#%28tech._structure._type._descriptor%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type descriptor</span></a> is
+mostly useful for creating structure subtypes. The structure type
+includes a guard that checks an instance&rsquo;s first field in the same way
+as <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._make-struct-info%29%29" class="RktValLink" data-pltdoc="x">make-struct-info</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/struct-info..rkt)._prop~3astruct-info))"></a><span title="Provided from: racket/struct-info | Package: base"><span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._prop~3astruct-info%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:struct-info</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">The <a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property</span></a> for creating new structure types
+like <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct~3astruct-info%29%29" class="RktValLink" data-pltdoc="x">struct:struct-info</a></span>. The property value must be a procedure
+of one argument that takes an instance structure and returns
+structure-type information in list form.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/struct-info..rkt)._prop~3astruct-auto-info))"></a><span title="Provided from: racket/struct-info | Package: base"><span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._prop~3astruct-auto-info%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:struct-auto-info</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/struct-info..rkt)._struct-auto-info~3f))"></a><span title="Provided from: racket/struct-info | Package: base"><span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-auto-info~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-auto-info?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/struct-info..rkt)._struct-auto-info-lists))"></a><span title="Provided from: racket/struct-info | Package: base"><span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-auto-info-lists%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-auto-info-lists</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sai</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sai</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-auto-info~3f%29%29" class="RktValLink" data-pltdoc="x">struct-auto-info?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._prop~3astruct-auto-info%29%29" class="RktValLink" data-pltdoc="x">prop:struct-auto-info</a></span> property is implemented to provide
+static information about which of the accessor and mutator identifiers
+for a structure type correspond to <span class="RktPn">#:auto</span> fields (so that
+they have no corresponding argument in the constructor). The property
+value must be a procedure that accepts an instance structure to which
+the property is given, and the result must be two lists of identifiers
+suitable as a result from <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-auto-info-lists%29%29" class="RktValLink" data-pltdoc="x">struct-auto-info-lists</a></span>.</div></p><p>The <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-auto-info~3f%29%29" class="RktValLink" data-pltdoc="x">struct-auto-info?</a></span> predicate recognizes values that
+implement the <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._prop~3astruct-auto-info%29%29" class="RktValLink" data-pltdoc="x">prop:struct-auto-info</a></span> property.</p><p>The <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-auto-info-lists%29%29" class="RktValLink" data-pltdoc="x">struct-auto-info-lists</a></span> function extracts two lists of
+identifiers from a value that implements the
+<span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._prop~3astruct-auto-info%29%29" class="RktValLink" data-pltdoc="x">prop:struct-auto-info</a></span> property. The first list should be a
+subset of the accessor identifiers for the structure type described by
+<span class="RktVar">sai</span>, and the second list should be a subset of the mutator
+identifiers. The two subsets correspond to <span class="RktPn">#:auto</span> fields.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/struct-info..rkt)._prop~3astruct-field-info))"></a><span title="Provided from: racket/struct-info | Package: base"><span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._prop~3astruct-field-info%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:struct-field-info</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/struct-info..rkt)._struct-field-info~3f))"></a><span title="Provided from: racket/struct-info | Package: base"><span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-field-info~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-field-info?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/struct-info..rkt)._struct-field-info-list))"></a><span title="Provided from: racket/struct-info | Package: base"><span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-field-info-list%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-field-info-list</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sfi</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sfi</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-field-info~3f%29%29" class="RktValLink" data-pltdoc="x">struct-field-info?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._prop~3astruct-field-info%29%29" class="RktValLink" data-pltdoc="x">prop:struct-field-info</a></span> property is implemented to provide
+static information about field names in a structure type. The property
+value must be a procedure that accepts an instance structure to which
+the property is given, and the result must be a list of symbols
+suitable as a result from <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-field-info-list%29%29" class="RktValLink" data-pltdoc="x">struct-field-info-list</a></span>.</div></p><p>The <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-field-info~3f%29%29" class="RktValLink" data-pltdoc="x">struct-field-info?</a></span> predicate recognizes values that
+implement the <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._prop~3astruct-field-info%29%29" class="RktValLink" data-pltdoc="x">prop:struct-field-info</a></span> property.</p><p>The <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._struct-field-info-list%29%29" class="RktValLink" data-pltdoc="x">struct-field-info-list</a></span> function extracts a list of
+symbols from a value that implements the <span class="RktSym"><a href="structinfo.html#%28def._%28%28lib._racket%2Fstruct-info..rkt%29._prop~3astruct-field-info%29%29" class="RktValLink" data-pltdoc="x">prop:struct-field-info</a></span> property.
+The list should contain every immediate field name
+(that is, not including fields from its super struct type)
+in the reverse order.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">foo</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bar</span><span class="hspace">&nbsp;</span><span class="RktSym">foo</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-bar-field-names</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRdr">#`</span><span class="RktVal">'</span><span class="RktVal">#,</span><span class="RktVal">(</span><span class="RktVal">struct-field-info-list</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">syntax-local-value</span><span class="hspace">&nbsp;</span><span class="RktVal">#'</span><span class="RktVal">bar</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">get-bar-field-names</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(z y)</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 7.7.0.9 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="structutils.html" title="backward to &quot;5.6 Structure Utilities&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="structures.html" title="up to &quot;5 Structures&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="forward to &quot;6 Classes and Objects&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/structprops.html b/clones/docs.racket-lang.org/reference/structprops.html
new file mode 100644
index 00000000..87494cc4
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/structprops.html
@@ -0,0 +1,74 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>5.3&nbsp;Structure Type Properties</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewselflink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">5.1&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Defining Structure Types:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">struct</span></span></a></td></tr><tr><td align="right">5.2&nbsp;</td><td><a href="creatingmorestructs.html" class="tocviewlink" data-pltdoc="x">Creating Structure Types</a></td></tr><tr><td align="right">5.3&nbsp;</td><td><a href="structprops.html" class="tocviewselflink" data-pltdoc="x">Structure Type Properties</a></td></tr><tr><td align="right">5.4&nbsp;</td><td><a href="struct-generics.html" class="tocviewlink" data-pltdoc="x">Generic Interfaces</a></td></tr><tr><td align="right">5.5&nbsp;</td><td><a href="struct-copy.html" class="tocviewlink" data-pltdoc="x">Copying and Updating Structures</a></td></tr><tr><td align="right">5.6&nbsp;</td><td><a href="structutils.html" class="tocviewlink" data-pltdoc="x">Structure Utilities</a></td></tr><tr><td align="right">5.7&nbsp;</td><td><a href="structinfo.html" class="tocviewlink" data-pltdoc="x">Structure Type Transformer Binding</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type-property%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>struct-<wbr></wbr>type-<wbr></wbr>property</span></span></a></td></tr><tr><td><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>type-<wbr></wbr>property?</span></span></a></td></tr><tr><td><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property-accessor-procedure~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>type-<wbr></wbr>property-<wbr></wbr>accessor-<wbr></wbr>procedure?</span></span></a></td></tr><tr><td><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property-predicate-procedure~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>type-<wbr></wbr>property-<wbr></wbr>predicate-<wbr></wbr>procedure?</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="creatingmorestructs.html" title="backward to &quot;5.2 Creating Structure Types&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="structures.html" title="up to &quot;5 Structures&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="struct-generics.html" title="forward to &quot;5.4 Generic Interfaces&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;structprops&quot;">5.3<tt>&nbsp;</tt><a name="(part._structprops)"></a>Structure Type Properties</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><a href="struct-generics.html" data-pltdoc="x">Generic Interfaces</a> provide a high-level API on top of
+structure type properties.</p></blockquote></blockquote></blockquote><p>A <a name="(tech._structure._type._property)"></a><span style="font-style: italic">structure type property</span> allows per-type information to be
+ associated with a structure type (as opposed to per-instance
+ information associated with a structure value). A property value is
+ associated with a structure type through the
+ <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span> procedure (see
+ <a href="creatingmorestructs.html" data-pltdoc="x">Creating Structure Types</a>) or through the <span class="RktPn">#:property</span>
+ option of <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>.  Subtypes inherit the property
+ values of their parent types, and subtypes can override an inherited
+ property value with a new value.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-struct-type-property))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type-property%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-struct-type-property</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">guard</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">supers</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">can-impersonate?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">accessor-name</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">contract-str</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">realm</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></td></tr><tr><td><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">guard</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">can-impersonate</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">supers</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._null%29%29" class="RktValLink" data-pltdoc="x">null</a></span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">can-impersonate?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">accessor-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">contract-str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">realm</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racket</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new structure type property and returns three values:</div></p><ul><li><p>a <a name="(tech._structure._type._property._descriptor)"></a><span style="font-style: italic">structure type property descriptor</span>, for use with
+<span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span> and <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>;</p></li><li><p>a <a name="(tech._property._predicate)"></a><span style="font-style: italic">property predicate</span> procedure, which takes an
+arbitrary value and returns <span class="RktVal">#t</span> if the value is a
+descriptor or instance of a structure type that has a value for
+the property, <span class="RktVal">#f</span> otherwise;</p></li><li><p>a <a name="(tech._property._accessor)"></a><span style="font-style: italic">property accessor</span> procedure, which returns the
+value associated with the structure type given its descriptor or
+one of its instances; if the structure type does not have a
+value for the property, or if any other kind of value is
+provided, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised unless a second
+argument, <span class="RktVar">failure-result</span>, is supplied to the
+procedure. In that case, if <span class="RktVar">failure-result</span> is a
+procedure, it is called (through a tail call) with no arguments
+to produce the result of the property accessor procedure;
+otherwise, <span class="RktVar">failure-result</span> is itself returned as the
+result.</p></li></ul><p>If the optional <span class="RktVar">guard</span> is supplied as a procedure, it is
+called by <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span> before attaching the property to a
+new structure type. The <span class="RktVar">guard</span> must accept two arguments:
+a value for the property supplied to <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span>, and a
+list containing information about the new structure type. The list
+contains the values that <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-type-info%29%29" class="RktValLink" data-pltdoc="x">struct-type-info</a></span> would return for
+the new structure type if it skipped the current-inspector
+control checks.</p><p>The result of calling <span class="RktVar">guard</span> is associated with the property
+in the target structure type, instead of the value supplied to
+<span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span>. To reject a property association (e.g.,
+because the value supplied to <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span> is
+inappropriate for the property), the <span class="RktVar">guard</span> can raise an
+exception. Such an exception prevents <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span> from
+returning a structure type descriptor.</p><p>If <span class="RktVar">guard</span> is <span class="RktVal">'</span><span class="RktVal">can-impersonate</span>, then the property&rsquo;s
+accessor can be redirected through
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-struct%29%29" class="RktValLink" data-pltdoc="x">impersonate-struct</a></span>. This option is identical to supplying
+<span class="RktVal">#t</span> as the <span class="RktVar">can-impersonate?</span> argument and is provided
+for backwards compatibility.</p><p>The optional <span class="RktVar">supers</span> argument is a list of properties that are
+automatically associated with some structure type when the newly
+created property is associated to the structure type. Each property in
+<span class="RktVar">supers</span> is paired with a procedure that receives the value
+supplied for the new property (after it is processed by
+<span class="RktVar">guard</span>) and returns a value for the associated property (which
+is then sent to that property&rsquo;s guard, of any).</p><p>The optional <span class="RktVar">can-impersonate?</span> argument determines if the
+structure type property can be redirected through <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-struct%29%29" class="RktValLink" data-pltdoc="x">impersonate-struct</a></span>.
+If the argument is <span class="RktVal">#f</span>, then redirection is not allowed.
+Otherwise, the property accessor may be redirected by a struct
+impersonator.</p><p>The optional <span class="RktVar">accessor-name</span> argument supplies a name (in the
+sense of <span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._object-name%29%29" class="RktValLink" data-pltdoc="x">object-name</a></span>) to use for the returned accessor
+function. If <span class="RktVar">accessor-name</span> is <span class="RktVal">#f</span>, a name is created
+by adding <span class="RktSym">-accessor</span> to the end of <span class="RktVar">name</span>.</p><p>The optional <span class="RktVar">contract-str</span> argument supplies a contract that
+is included in an error message with the returned accessor is applied
+to a value that is not an instance of the property (and where a
+<span class="RktVar">failure-result</span> argument is not supplied to the accessor). If
+<span class="RktVar">contract-str</span> is <span class="RktVal">#f</span>, a contract is created by adding
+<span class="RktSym">?</span> to the end of <span class="RktVar">name</span>.</p><p>The optional <span class="RktVar">realm</span> argument supplies a <a href="exns.html#%28tech._realm%29" class="techoutside" data-pltdoc="x"><span class="techinside">realm</span></a> (in the
+sense of <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-realm%29%29" class="RktValLink" data-pltdoc="x">procedure-realm</a></span>) to associate with the returned
+accessor.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">prop:p</span><span class="hspace">&nbsp;</span><span class="RktSym">p?</span><span class="hspace">&nbsp;</span><span class="RktSym">p-ref</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type-property%29%29" class="RktValLink" data-pltdoc="x">make-struct-type-property</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">p</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">struct:a</span><span class="hspace">&nbsp;</span><span class="RktSym">make-a</span><span class="hspace">&nbsp;</span><span class="RktSym">a?</span><span class="hspace">&nbsp;</span><span class="RktSym">a-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">a-set!</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">uninitialized</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">prop:p</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">p?</span><span class="hspace">&nbsp;</span><span class="RktSym">struct:a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">p?</span><span class="hspace">&nbsp;</span><span class="RktVal">13</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">an-a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-a</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">p?</span><span class="hspace">&nbsp;</span><span class="RktSym">an-a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">p-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">an-a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">8</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">struct:b</span><span class="hspace">&nbsp;</span><span class="RktSym">make-b</span><span class="hspace">&nbsp;</span><span class="RktSym">b?</span><span class="hspace">&nbsp;</span><span class="RktSym">b-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">b-set!</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">p?</span><span class="hspace">&nbsp;</span><span class="RktSym">struct:b</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">prop:q</span><span class="hspace">&nbsp;</span><span class="RktSym">q?</span><span class="hspace">&nbsp;</span><span class="RktSym">q-ref</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type-property%29%29" class="RktValLink" data-pltdoc="x">make-struct-type-property</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">q</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktSym">si</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">prop:p</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sqrt%29%29" class="RktValLink" data-pltdoc="x">sqrt</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">struct:c</span><span class="hspace">&nbsp;</span><span class="RktSym">make-c</span><span class="hspace">&nbsp;</span><span class="RktSym">c?</span><span class="hspace">&nbsp;</span><span class="RktSym">c-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">c-set!</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">uninit</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">prop:q</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">q-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">struct:c</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">9</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">p-ref</span><span class="hspace">&nbsp;</span><span class="RktSym">struct:c</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.0 of package <span class="stt">base</span>: The <a href="implementations.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a> implementation of Racket
+skips the inspector check
+for exposing an ancestor structure
+type, if any, in information provided to a guard procedure.<br/>Changed in version 8.4.0.2: Added the <span class="RktVar">accessor-name</span>,
+ <span class="RktVar">contract-str</span>, and
+ <span class="RktVar">realm</span> arguments.<br/>Changed in version 8.5.0.2: Changed the <a href="implementations.html#%28tech._bc%29" class="techoutside" data-pltdoc="x"><span class="techinside">BC</span></a> implementation of Racket
+to skip the inspector check, the same as the <a href="implementations.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a> implementation,
+for ancestor information provided to a guard procedure.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._struct-type-property~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-type-property?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="structprops.html#%28tech._structure._type._property._descriptor%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property
+descriptor</span></a> value, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._struct-type-property-accessor-procedure~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property-accessor-procedure~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-type-property-accessor-procedure?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is an accessor procedure produced
+by <span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type-property%29%29" class="RktValLink" data-pltdoc="x">make-struct-type-property</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._struct-type-property-predicate-procedure~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property-predicate-procedure~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-type-property-predicate-procedure?</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">prop</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a predicate procedure produced by
+<span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type-property%29%29" class="RktValLink" data-pltdoc="x">make-struct-type-property</a></span> and either <span class="RktVar">prop</span> is
+<span class="RktVal">#f</span> or it was produced by the same call to
+<span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type-property%29%29" class="RktValLink" data-pltdoc="x">make-struct-type-property</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p class="SHistory">Added in version 7.5.0.11 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="creatingmorestructs.html" title="backward to &quot;5.2 Creating Structure Types&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="structures.html" title="up to &quot;5 Structures&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="struct-generics.html" title="forward to &quot;5.4 Generic Interfaces&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/structures.html b/clones/docs.racket-lang.org/reference/structures.html
new file mode 100644
index 00000000..943200d3
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/structures.html
@@ -0,0 +1,53 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>5&nbsp;Structures</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewselflink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>5&nbsp;</td><td><a href="structures.html" class="tocviewselflink" data-pltdoc="x">Structures</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">5.1&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Defining Structure Types:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">struct</span></span></a></td></tr><tr><td align="right">5.2&nbsp;</td><td><a href="creatingmorestructs.html" class="tocviewlink" data-pltdoc="x">Creating Structure Types</a></td></tr><tr><td align="right">5.3&nbsp;</td><td><a href="structprops.html" class="tocviewlink" data-pltdoc="x">Structure Type Properties</a></td></tr><tr><td align="right">5.4&nbsp;</td><td><a href="struct-generics.html" class="tocviewlink" data-pltdoc="x">Generic Interfaces</a></td></tr><tr><td align="right">5.5&nbsp;</td><td><a href="struct-copy.html" class="tocviewlink" data-pltdoc="x">Copying and Updating Structures</a></td></tr><tr><td align="right">5.6&nbsp;</td><td><a href="structutils.html" class="tocviewlink" data-pltdoc="x">Structure Utilities</a></td></tr><tr><td align="right">5.7&nbsp;</td><td><a href="structinfo.html" class="tocviewlink" data-pltdoc="x">Structure Type Transformer Binding</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="undefined.html" title="backward to &quot;4.21 Undefined&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="define-struct.html" title="forward to &quot;5.1 Defining Structure Types: struct&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;structures&quot;">5<tt>&nbsp;</tt><a name="(part._structures)"></a>Structures</h3><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=define-struct.html&amp;version=8.6" class="Sq" data-pltdoc="x">Programmer-Defined Datatypes</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces structure types via <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>.</p></blockquote></blockquote></blockquote><p>A <a name="(tech._structure._type)"></a><span style="font-style: italic">structure type</span> is a record datatype composing a number of
+<span style="font-style: italic">fields</span>. A <a name="(tech._structure)"></a><span style="font-style: italic">structure</span>, an instance of a structure
+type, is a first-class value that contains a value for each field of
+the structure type. A structure instance is created with a
+type-specific <a href="define-struct.html#%28tech._constructor%29" class="techoutside" data-pltdoc="x"><span class="techinside">constructor</span></a> procedure, and its field values are
+accessed and changed with type-specific <a href="define-struct.html#%28tech._accessor%29" class="techoutside" data-pltdoc="x"><span class="techinside">accessor</span></a> and
+<a href="define-struct.html#%28tech._mutator%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutator</span></a> procedures. In addition, each structure type has a
+<a href="define-struct.html#%28tech._predicate%29" class="techoutside" data-pltdoc="x"><span class="techinside">predicate</span></a> procedure that answers <span class="RktVal">#t</span> for instances of
+the structure type and <span class="RktVal">#f</span> for any other value.</p><p>A structure type&rsquo;s fields are essentially unnamed, though names are
+supported for error-reporting purposes. The constructor procedure
+takes one value for each field of the structure type, except that some
+of the fields of a structure type can be <a name="(tech._automatic._field)"></a><span style="font-style: italic">automatic fields</span>;
+the <a href="structures.html#%28tech._automatic._field%29" class="techoutside" data-pltdoc="x"><span class="techinside">automatic fields</span></a> are initialized to a constant that is
+associated with the structure type, and the corresponding arguments
+are omitted from the constructor procedure. All automatic fields in a
+structure type follow the non-automatic fields.</p><p>A structure type can be created as a <a name="(tech._structure._subtype)"></a><span style="font-style: italic">structure subtype</span> of
+an existing base structure type. An instance of a structure subtype
+can always be used as an instance of the base structure type, but the
+subtype gets its own predicate procedure, and it may have its own
+fields in addition to the fields of the base type.</p><p>A structure subtype &ldquo;inherits&rdquo; the fields of its base type. If the
+base type has <span style="font-style: italic">m</span> fields, and if <span style="font-style: italic">n</span> fields are specified
+for the new structure subtype, then the resulting structure type has
+<span style="font-style: italic">m+n</span> fields. The value for automatic fields can be different in
+a subtype than in its base type.</p><p>If <span style="font-style: italic">m</span>&prime;<span style="font-style: italic"></span> of the original <span style="font-style: italic">m</span> fields are non-automatic (where
+<span style="font-style: italic">m</span>&prime;<span style="font-style: italic">&lt;m</span>), and <span style="font-style: italic">n</span>&prime;<span style="font-style: italic"></span> of the new fields are non-automatic (where
+<span style="font-style: italic">n</span>&prime;<span style="font-style: italic">&lt;n</span>), then <span style="font-style: italic">m</span>&prime;<span style="font-style: italic">+n</span>&prime;<span style="font-style: italic"></span> field values must be provided to the
+subtype&rsquo;s constructor procedure. Values for the first <span style="font-style: italic">m</span> fields
+of a subtype instance are accessed with selector procedures for the
+original base type (or its supertypes), and the last <span style="font-style: italic">n</span> are
+accessed with subtype-specific selectors. Subtype-specific
+<a href="define-struct.html#%28tech._accessor%29" class="techoutside" data-pltdoc="x"><span class="techinside">accessors</span></a> and <a href="define-struct.html#%28tech._mutator%29" class="techoutside" data-pltdoc="x"><span class="techinside">mutators</span></a> for the first <span style="font-style: italic">m</span> fields do
+not exist.</p><p>The <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> form and <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span>
+procedure typically create a new structure type, but they can also
+access <a name="(tech._prefab)"></a><span style="font-style: italic">prefab</span> (i.e., previously fabricated) structure types
+that are globally shared, and whose instances can be parsed and
+written by the default reader (see <a href="reader.html" data-pltdoc="x">The Reader</a>) and printer (see
+<a href="printing.html" data-pltdoc="x">The Printer</a>). Prefab structure types can inherit only from
+other prefab structure types, and they cannot have guards (see
+<a href="creatingmorestructs.html" data-pltdoc="x">Creating Structure Types</a>) or properties (see
+<a href="structprops.html" data-pltdoc="x">Structure Type Properties</a>). Exactly one prefab structure type exists for
+each combination of name, supertype, field count, automatic field
+count, automatic field value (when there is at least one automatic
+field), and field mutability.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="serialization.html" data-pltdoc="x">Serialization</a> also provides information on reading and writing structures.</p></blockquote></blockquote></blockquote><p><a name="(idx._(gentag._193._(lib._scribblings/reference/reference..scrbl)))"></a>Two structure values are
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span> if and only if they are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>. Two structure
+values are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> if they are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>. By default, two
+structure values are also <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> if they are instances of the
+same structure type, no fields are opaque, and the results of applying
+<span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-~3evector%29%29" class="RktValLink" data-pltdoc="x">struct-&gt;vector</a></span> to the structs are
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>. (Consequently, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>  testing for
+structures may depend on the current inspector.) A structure type can
+override the default <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> definition through the
+<span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal+hash</a></span> or <span class="RktSym"><a href="Equality.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3aequal-mode%2Bhash%29%29" class="RktValLink" data-pltdoc="x">gen:equal-mode+hash</a></span> <a href="struct-generics.html#%28tech._generic._interface%29" class="techoutside" data-pltdoc="x"><span class="techinside">generic interface</span></a>.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define-struct.html" class="toclink" data-pltdoc="x">5.1<span class="hspace">&nbsp;</span>Defining Structure Types: <span class="RktSym"><span class="RktStxLink">struct</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="creatingmorestructs.html" class="toclink" data-pltdoc="x">5.2<span class="hspace">&nbsp;</span>Creating Structure Types</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="structprops.html" class="toclink" data-pltdoc="x">5.3<span class="hspace">&nbsp;</span>Structure Type Properties</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="struct-generics.html" class="toclink" data-pltdoc="x">5.4<span class="hspace">&nbsp;</span>Generic Interfaces</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="struct-copy.html" class="toclink" data-pltdoc="x">5.5<span class="hspace">&nbsp;</span>Copying and Updating Structures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="structutils.html" class="toclink" data-pltdoc="x">5.6<span class="hspace">&nbsp;</span>Structure Utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="structutils.html#%28part._.Additional_.Structure_.Utilities%29" class="toclink" data-pltdoc="x">5.6.1<span class="hspace">&nbsp;</span>Additional Structure Utilities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="structinfo.html" class="toclink" data-pltdoc="x">5.7<span class="hspace">&nbsp;</span>Structure Type Transformer Binding</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="undefined.html" title="backward to &quot;4.21 Undefined&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="define-struct.html" title="forward to &quot;5.1 Defining Structure Types: struct&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/structutils.html b/clones/docs.racket-lang.org/reference/structutils.html
new file mode 100644
index 00000000..74a143d2
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/structutils.html
@@ -0,0 +1,82 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>5.6&nbsp;Structure Utilities</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewselflink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">5.1&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Defining Structure Types:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">struct</span></span></a></td></tr><tr><td align="right">5.2&nbsp;</td><td><a href="creatingmorestructs.html" class="tocviewlink" data-pltdoc="x">Creating Structure Types</a></td></tr><tr><td align="right">5.3&nbsp;</td><td><a href="structprops.html" class="tocviewlink" data-pltdoc="x">Structure Type Properties</a></td></tr><tr><td align="right">5.4&nbsp;</td><td><a href="struct-generics.html" class="tocviewlink" data-pltdoc="x">Generic Interfaces</a></td></tr><tr><td align="right">5.5&nbsp;</td><td><a href="struct-copy.html" class="tocviewlink" data-pltdoc="x">Copying and Updating Structures</a></td></tr><tr><td align="right">5.6&nbsp;</td><td><a href="structutils.html" class="tocviewselflink" data-pltdoc="x">Structure Utilities</a></td></tr><tr><td align="right">5.7&nbsp;</td><td><a href="structinfo.html" class="tocviewlink" data-pltdoc="x">Structure Type Transformer Binding</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>5.6&nbsp;</td><td><a href="structutils.html" class="tocviewselflink" data-pltdoc="x">Structure Utilities</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">5.6.1&nbsp;</td><td><a href="structutils.html#%28part._.Additional_.Structure_.Utilities%29" class="tocviewlink" data-pltdoc="x">Additional Structure Utilities</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-~3evector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>&gt;vector</span></span></a></td></tr><tr><td><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct?</span></span></a></td></tr><tr><td><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-type~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>type?</span></span></a></td></tr><tr><td><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-constructor-procedure~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>constructor-<wbr></wbr>procedure?</span></span></a></td></tr><tr><td><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-predicate-procedure~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>predicate-<wbr></wbr>procedure?</span></span></a></td></tr><tr><td><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-accessor-procedure~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>accessor-<wbr></wbr>procedure?</span></span></a></td></tr><tr><td><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-mutator-procedure~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>mutator-<wbr></wbr>procedure?</span></span></a></td></tr><tr><td><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._prefab-struct-key%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prefab-<wbr></wbr>struct-<wbr></wbr>key</span></span></a></td></tr><tr><td><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._make-prefab-struct%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>prefab-<wbr></wbr>struct</span></span></a></td></tr><tr><td><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._prefab-struct-type-key%2Bfield-count%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prefab-<wbr></wbr>struct-<wbr></wbr>type-<wbr></wbr>key+<span class="mywbr"> &nbsp;</span>field-<wbr></wbr>count</span></span></a></td></tr><tr><td><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._prefab-key-~3estruct-type%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prefab-<wbr></wbr>key-<wbr></wbr>&gt;struct-<wbr></wbr>type</span></span></a></td></tr><tr><td><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._prefab-key~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prefab-<wbr></wbr>key?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">5.6.1<tt>&nbsp;</tt></span><a href="structutils.html#%28part._.Additional_.Structure_.Utilities%29" class="tocsubseclink" data-pltdoc="x">Additional Structure Utilities</a></td></tr><tr><td><a href="structutils.html#%28def._%28%28lib._racket%2Fstruct..rkt%29._make-constructor-style-printer%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>constructor-<wbr></wbr>style-<wbr></wbr>printer</span></span></a></td></tr><tr><td><a href="structutils.html#%28def._%28%28lib._racket%2Fstruct..rkt%29._struct-~3elist%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">struct-<wbr></wbr>&gt;list</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="struct-copy.html" title="backward to &quot;5.5 Copying and Updating Structures&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="structures.html" title="up to &quot;5 Structures&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="structinfo.html" title="forward to &quot;5.7 Structure Type Transformer Binding&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;structutils&quot;">5.6<tt>&nbsp;</tt><a name="(part._structutils)"></a>Structure Utilities</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._struct-~3evector))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-~3evector%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-&gt;vector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">opaque-v</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">opaque-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">...</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a vector representing <span class="RktVar">v</span>.  The first slot of the
+result vector contains a symbol whose printed name has the form
+<span class="RktSym">struct:</span><span class="RktVar">id</span>. Each remaining slot contains
+either the value of a field in <span class="RktVar">v</span>, if it is accessible via the
+current inspector, or <span class="RktVar">opaque-v</span> for a field that is not
+accessible. A single <span class="RktVar">opaque-v</span> value is used in the vector for
+contiguous inaccessible fields. (Consequently, the size of the vector
+does not match the size of the <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> if more than one field
+is inaccessible.)</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._struct~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara"> Returns <span class="RktVal">#t</span> if
+<span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._struct-info%29%29" class="RktValLink" data-pltdoc="x">struct-info</a></span> exposes any structure types of <span class="RktVar">v</span> with
+the current inspector, <span class="RktVal">#f</span> otherwise.</div></p><p>Typically, when <span class="RktPn">(</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct~3f%29%29" class="RktValLink" data-pltdoc="x">struct?</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span> is true, then
+<span class="RktPn">(</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-~3evector%29%29" class="RktValLink" data-pltdoc="x">struct-&gt;vector</a></span><span class="stt"> </span><span class="RktVar">v</span><span class="RktPn">)</span> exposes at least one field value. It is
+possible, however, for the only visible types of <span class="RktVar">v</span> to
+contribute zero fields.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._struct-type~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-type~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-type?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if
+<span class="RktVar">v</span> is a structure type descriptor value, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._struct-constructor-procedure~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-constructor-procedure~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-constructor-procedure?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns
+<span class="RktVal">#t</span> if <span class="RktVar">v</span> is a constructor procedure generated by
+<span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> or <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span>, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._struct-predicate-procedure~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-predicate-procedure~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-predicate-procedure?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns
+<span class="RktVal">#t</span> if <span class="RktVar">v</span> is a predicate procedure generated by
+<span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> or <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span>, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._struct-accessor-procedure~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-accessor-procedure~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-accessor-procedure?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns
+<span class="RktVal">#t</span> if <span class="RktVar">v</span> is an accessor procedure generated by
+<span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>, <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span>, or
+<span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-field-accessor%29%29" class="RktValLink" data-pltdoc="x">make-struct-field-accessor</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._struct-mutator-procedure~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-mutator-procedure~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-mutator-procedure?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns
+<span class="RktVal">#t</span> if <span class="RktVar">v</span> is a mutator procedure generated by
+<span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span>, <span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span>, or
+<span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-field-mutator%29%29" class="RktValLink" data-pltdoc="x">make-struct-field-mutator</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._prefab-struct-key))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._prefab-struct-key%29%29" class="RktValDef RktValLink" data-pltdoc="x">prefab-struct-key</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#f</span> if <span class="RktVar">v</span> is not an instance of a
+<a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure type. Otherwise, the result is the shorted key
+that could be used with <span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._make-prefab-struct%29%29" class="RktValLink" data-pltdoc="x">make-prefab-struct</a></span> to create an instance
+of the structure type.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._prefab-struct-key%29%29" class="RktValLink" data-pltdoc="x">prefab-struct-key</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#s</span><span class="RktVal">(</span><span class="RktVal">cat</span><span class="hspace">&nbsp;</span><span class="RktVal">"Garfield"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'cat</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cat</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:prefab</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cute-cat</span><span class="hspace">&nbsp;</span><span class="RktSym">cat</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">shipping-dest</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:prefab</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">cute-cat</span><span class="hspace">&nbsp;</span><span class="RktVal">"Nermel"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Abu Dhabi"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#s((cute-cat cat 1) "Nermel" "Abu Dhabi")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._prefab-struct-key%29%29" class="RktValLink" data-pltdoc="x">prefab-struct-key</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">cute-cat</span><span class="hspace">&nbsp;</span><span class="RktVal">"Nermel"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Abu Dhabi"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(cute-cat cat 1)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-prefab-struct))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._make-prefab-struct%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-prefab-struct</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct~3f%29%29" class="RktValLink" data-pltdoc="x">struct?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._prefab-key~3f%29%29" class="RktValLink" data-pltdoc="x">prefab-key?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates an instance of a <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure type, using the
+<span class="RktVar">v</span>s as field values. The <span class="RktVar">key</span> and the number of
+<span class="RktVar">v</span>s determine the <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure type.</div></p><p>A <span class="RktVar">key</span> identifies a structure type based on a list with the
+following items:</p><ul><li><p>A symbol for the structure type&rsquo;s name.</p></li><li><p>An exact, nonnegative integer representing the number of
+non-automatic fields in the structure type, not counting fields
+from the supertype (if any).</p></li><li><p>A list of two items, where the first is an exact, nonnegative
+integer for the number of automatic fields in the structure
+type that are not from the supertype (if any), and the second
+element is an arbitrary value that is the value for the
+automatic fields.</p></li><li><p>A vector of exact, nonnegative integers that indicate mutable
+non-automatic fields in the structure type, counting from
+<span class="RktVal">0</span> and not including fields from the supertype (if
+any).</p></li><li><p>Nothing else, if the structure type has no
+supertype. Otherwise, the rest of the list is the key
+for the supertype.</p></li></ul><p>An empty vector and an auto-field list that starts with <span class="RktVal">0</span> can
+be omitted. Furthermore, the first integer (which indicates the number
+of non-automatic fields) can be omitted, since it can be inferred from
+the number of supplied <span class="RktVar">v</span>s. Finally, a single symbol can be
+used instead of a list that contains only a symbol (in the case that
+the structure type has no supertype, no automatic fields, and no
+mutable fields).</p><p>The total field count must be no more than 32768. If the number of
+fields indicated by <span class="RktVar">key</span> is inconsistent with the number of
+supplied <span class="RktVar">v</span>s, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._make-prefab-struct%29%29" class="RktValLink" data-pltdoc="x">make-prefab-struct</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">clown</span><span class="hspace">&nbsp;</span><span class="RktVal">"Binky"</span><span class="hspace">&nbsp;</span><span class="RktVal">"pie"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#s(clown "Binky" "pie")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._make-prefab-struct%29%29" class="RktValLink" data-pltdoc="x">make-prefab-struct</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">clown</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"Binky"</span><span class="hspace">&nbsp;</span><span class="RktVal">"pie"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#s(clown "Binky" "pie")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._make-prefab-struct%29%29" class="RktValLink" data-pltdoc="x">make-prefab-struct</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">clown</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"Binky"</span><span class="hspace">&nbsp;</span><span class="RktVal">"pie"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#s(clown "Binky" "pie")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._make-prefab-struct%29%29" class="RktValLink" data-pltdoc="x">make-prefab-struct</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">clown</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"Binky"</span><span class="hspace">&nbsp;</span><span class="RktVal">"pie"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#s((clown (1 #f)) "Binky" "pie")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._make-prefab-struct%29%29" class="RktValLink" data-pltdoc="x">make-prefab-struct</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">clown</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">0</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"Binky"</span><span class="hspace">&nbsp;</span><span class="RktVal">"pie"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#s((clown (1 #f) #(0)) "Binky" "pie")</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._prefab-struct-type-key+field-count))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._prefab-struct-type-key%2Bfield-count%29%29" class="RktValDef RktValLink" data-pltdoc="x">prefab-struct-type-key+field-count</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">type</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._prefab-key~3f%29%29" class="RktValLink" data-pltdoc="x">prefab-key?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">32768</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">type</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-type~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a pair containing the <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> key and field count for
+the <a href="define-struct.html#%28tech._structure._type._descriptor%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type descriptor</span></a> <span class="RktVar">type</span> if it represents a
+prefab structure type, <span class="RktVal">#f</span> otherwise.</div></p><p class="SHistory">Added in version 8.5.0.8 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._prefab-key-~3estruct-type))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._prefab-key-~3estruct-type%29%29" class="RktValDef RktValLink" data-pltdoc="x">prefab-key-&gt;struct-type</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">field-count</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-type~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._prefab-key~3f%29%29" class="RktValLink" data-pltdoc="x">prefab-key?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">field-count</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">32768</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="define-struct.html#%28tech._structure._type._descriptor%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type descriptor</span></a> for the <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a>
+structure type specified by the combination of <span class="RktVar">key</span> and
+<span class="RktVar">field-count</span>.</div></p><p>If the number of fields indicated by <span class="RktVar">key</span> is inconsistent with
+<span class="RktVar">field-count</span>, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._prefab-key~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._prefab-key~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">prefab-key?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Return <span class="RktVal">#t</span> if <span class="RktVar">v</span> can be a <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure type
+key, <span class="RktVal">#f</span> otherwise.</div></p><p>See <span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._make-prefab-struct%29%29" class="RktValLink" data-pltdoc="x">make-prefab-struct</a></span> for a description of valid key shapes.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Additional_Structure_Utilities&quot;">5.6.1<tt>&nbsp;</tt><a name="(part._.Additional_.Structure_.Utilities)"></a><a name="(mod-path._racket/struct)"></a>Additional Structure Utilities</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="structutils.html#%28mod-path._racket%2Fstruct%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/struct</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="structutils.html#%28mod-path._racket%2Fstruct%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/struct</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/struct..rkt)._make-constructor-style-printer))"></a><span title="Provided from: racket/struct | Package: base"><span class="RktSym"><a href="structutils.html#%28def._%28%28lib._racket%2Fstruct..rkt%29._make-constructor-style-printer%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-constructor-style-printer</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">get-constructor</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">get-contents</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">get-constructor</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">get-contents</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._sequence~3f%29%29" class="RktValLink" data-pltdoc="x">sequence?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a function suitable as a value for
+ <span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">gen:custom-write</a></span> or <span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">prop:custom-write</a></span>.
+ The function prints values in &ldquo;constructor style.&rdquo; When
+ the value is <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>ed as an expression, it is shown
+ as an application of the constructor (as returned by
+ <span class="RktVar">get-constructor</span>) to the contents (as returned by
+ <span class="RktVar">get-contents</span>). When given to <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span>, it is
+ shown as an unreadable value with the constructor separated
+ from the contents by a colon.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">gen:custom-write</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">write-proc</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="structutils.html#%28def._%28%28lib._racket%2Fstruct..rkt%29._make-constructor-style-printer%29%29" class="RktValLink" data-pltdoc="x">make-constructor-style-printer</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">obj</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">point</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">obj</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point-x</span><span class="hspace">&nbsp;</span><span class="RktSym">obj</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point-y</span><span class="hspace">&nbsp;</span><span class="RktSym">obj</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">(point 1 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">#&lt;point: 1 2&gt;</span></p></td></tr></table></blockquote></div></p><p>The function also cooperates with <span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print%29%29" class="RktValLink" data-pltdoc="x">pretty-print</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-columns%29%29" class="RktValLink" data-pltdoc="x">pretty-print-columns</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print%29%29" class="RktValLink" data-pltdoc="x">pretty-print</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktVal">3000000</span><span class="hspace">&nbsp;</span><span class="RktVal">4000000</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">(point</span></p></td></tr><tr><td><p><span class="RktOut"></span><span class="hspace">&nbsp;</span><span class="RktOut">3000000</span></p></td></tr><tr><td><p><span class="RktOut"></span><span class="hspace">&nbsp;</span><span class="RktOut">4000000)</span></p></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-print-columns%29%29" class="RktValLink" data-pltdoc="x">pretty-print-columns</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pretty-print.html#%28def._%28%28lib._racket%2Fpretty..rkt%29._pretty-write%29%29" class="RktValLink" data-pltdoc="x">pretty-write</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktVal">3000000</span><span class="hspace">&nbsp;</span><span class="RktVal">4000000</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">#&lt;point:</span></p></td></tr><tr><td><p><span class="RktOut"></span><span class="hspace">&nbsp;</span><span class="RktOut">3000000</span></p></td></tr><tr><td><p><span class="RktOut"></span><span class="hspace">&nbsp;</span><span class="RktOut">4000000&gt;</span></p></td></tr></table></td></tr></table></blockquote><p><div class="SIntrapara">Note that the printer uses a separate property,
+<span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-print-quotable%29%29" class="RktValLink" data-pltdoc="x">prop:custom-print-quotable</a></span>, to determine whether a struct
+instance is quotable. If so, the printer may print it in
+<span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span> mode it in certain contexts, such as within a list. For
+example:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">'(#&lt;point: 1 2&gt; #&lt;point: 3 4&gt;)</span></p></td></tr></table></blockquote></div><div class="SIntrapara">Use <span class="RktPn">#:property</span><span class="stt"> </span><span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-print-quotable%29%29" class="RktValLink" data-pltdoc="x">prop:custom-print-quotable</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">never</span> to prevent a
+struct instance from being considered quotable. For example:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">point2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:property</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28quote._~23~25kernel%29._prop~3acustom-print-quotable%29%29" class="RktValLink" data-pltdoc="x">prop:custom-print-quotable</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">never</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">gen:custom-write</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">write-proc</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="structutils.html#%28def._%28%28lib._racket%2Fstruct..rkt%29._make-constructor-style-printer%29%29" class="RktValLink" data-pltdoc="x">make-constructor-style-printer</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">obj</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">point</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">obj</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point2-x</span><span class="hspace">&nbsp;</span><span class="RktSym">obj</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point2-y</span><span class="hspace">&nbsp;</span><span class="RktSym">obj</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">point2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">(list (point 1 2) (point 3 4))</span></p></td></tr></table></blockquote></div></p><p>Keyword arguments can be simulated with <span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._unquoted-printing-string%29%29" class="RktValLink" data-pltdoc="x">unquoted-printing-string</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Private implementation</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">kwpoint-impl</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Printer_Extension.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._gen~3acustom-write%29%29" class="RktValLink" data-pltdoc="x">gen:custom-write</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">write-proc</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="structutils.html#%28def._%28%28lib._racket%2Fstruct..rkt%29._make-constructor-style-printer%29%29" class="RktValLink" data-pltdoc="x">make-constructor-style-printer</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">obj</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">kwpoint</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">obj</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._unquoted-printing-string%29%29" class="RktValLink" data-pltdoc="x">unquoted-printing-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"#:x"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">kwpoint-impl-x</span><span class="hspace">&nbsp;</span><span class="RktSym">obj</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._unquoted-printing-string%29%29" class="RktValLink" data-pltdoc="x">unquoted-printing-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"#:y"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">kwpoint-impl-y</span><span class="hspace">&nbsp;</span><span class="RktSym">obj</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Public ``constructor''</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">kwpoint</span><span class="hspace">&nbsp;</span><span class="RktPn">#:x</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">#:y</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">kwpoint-impl</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Example use</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">kwpoint</span><span class="hspace">&nbsp;</span><span class="RktPn">#:x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">#:y</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">(kwpoint #:x 1 #:y 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._write%29%29" class="RktValLink" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">kwpoint</span><span class="hspace">&nbsp;</span><span class="RktPn">#:x</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktPn">#:y</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">#&lt;kwpoint: #:x 3 #:y 4&gt;</span></p></td></tr></table></blockquote><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/struct..rkt)._struct-~3elist))"></a><span title="Provided from: racket/struct | Package: base"><span class="RktSym"><a href="structutils.html#%28def._%28%28lib._racket%2Fstruct..rkt%29._struct-~3elist%29%29" class="RktValDef RktValLink" data-pltdoc="x">struct-&gt;list</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktPn">#:on-opaque</span><span class="hspace">&nbsp;</span><span class="RktVar">on-opaque</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on-opaque</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">error</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return-false</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">skip</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">error</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list containing the struct instance <span class="RktVar">v</span>&rsquo;s
+fields. Unlike <span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._struct-~3evector%29%29" class="RktValLink" data-pltdoc="x">struct-&gt;vector</a></span>, the struct name itself is not
+included.</div></p><p>If any fields of <span class="RktVar">v</span> are inaccessible via the current inspector
+the behavior of <span class="RktSym"><a href="structutils.html#%28def._%28%28lib._racket%2Fstruct..rkt%29._struct-~3elist%29%29" class="RktValLink" data-pltdoc="x">struct-&gt;list</a></span> is determined by
+<span class="RktVar">on-opaque</span>. If <span class="RktVar">on-opaque</span> is <span class="RktVal">'</span><span class="RktVal">error</span> (the
+default), an error is raised. If it is <span class="RktVal">'</span><span class="RktVal">return-false</span>,
+<span class="RktSym"><a href="structutils.html#%28def._%28%28lib._racket%2Fstruct..rkt%29._struct-~3elist%29%29" class="RktValLink" data-pltdoc="x">struct-&gt;list</a></span> returns <span class="RktVal">#f</span>. If it is <span class="RktVal">'</span><span class="RktVal">skip</span>,
+the inaccessible fields are omitted from the list.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._open%29%29" class="RktStxLink" data-pltdoc="x">open</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">u</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="structutils.html#%28def._%28%28lib._racket%2Fstruct..rkt%29._struct-~3elist%29%29" class="RktValLink" data-pltdoc="x">struct-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._open%29%29" class="RktStxLink" data-pltdoc="x">open</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(a b)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="structutils.html#%28def._%28%28lib._racket%2Fstruct..rkt%29._struct-~3elist%29%29" class="RktValLink" data-pltdoc="x">struct-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#s</span><span class="RktVal">(</span><span class="RktVal">pre</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">secret</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._open%29%29" class="RktStxLink" data-pltdoc="x">open</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="structutils.html#%28def._%28%28lib._racket%2Fstruct..rkt%29._struct-~3elist%29%29" class="RktValLink" data-pltdoc="x">struct-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">secret</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="hspace">&nbsp;</span><span class="RktVal">22</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">struct-&gt;list: expected argument of type &lt;non-opaque struct&gt;;</span></p></td></tr><tr><td><p><span class="RktErr">given: (secret 0 1 ...)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="structutils.html#%28def._%28%28lib._racket%2Fstruct..rkt%29._struct-~3elist%29%29" class="RktValLink" data-pltdoc="x">struct-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">secret</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="hspace">&nbsp;</span><span class="RktVal">22</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:on-opaque</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return-false</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="structutils.html#%28def._%28%28lib._racket%2Fstruct..rkt%29._struct-~3elist%29%29" class="RktValLink" data-pltdoc="x">struct-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">secret</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="hspace">&nbsp;</span><span class="RktVal">22</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:on-opaque</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">skip</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(0 1)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="structutils.html#%28def._%28%28lib._racket%2Fstruct..rkt%29._struct-~3elist%29%29" class="RktValLink" data-pltdoc="x">struct-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">not-a-struct</span><span class="hspace">&nbsp;</span><span class="RktPn">#:on-opaque</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">return-false</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="structutils.html#%28def._%28%28lib._racket%2Fstruct..rkt%29._struct-~3elist%29%29" class="RktValLink" data-pltdoc="x">struct-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">not-a-struct</span><span class="hspace">&nbsp;</span><span class="RktPn">#:on-opaque</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">skip</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="struct-copy.html" title="backward to &quot;5.5 Copying and Updating Structures&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="structures.html" title="up to &quot;5 Structures&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="structinfo.html" title="forward to &quot;5.7 Structure Type Transformer Binding&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/stx-patterns.html b/clones/docs.racket-lang.org/reference/stx-patterns.html
new file mode 100644
index 00000000..aedf1fa3
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/stx-patterns.html
@@ -0,0 +1,197 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>12.1&nbsp;Pattern-Based Syntax Matching</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">12.1&nbsp;</td><td><a href="stx-patterns.html" class="tocviewselflink" data-pltdoc="x">Pattern-<wbr></wbr>Based Syntax Matching</a></td></tr><tr><td align="right">12.2&nbsp;</td><td><a href="stxops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Content</a></td></tr><tr><td align="right">12.3&nbsp;</td><td><a href="stxcmp.html" class="tocviewlink" data-pltdoc="x">Syntax Object Bindings</a></td></tr><tr><td align="right">12.4&nbsp;</td><td><a href="stxtrans.html" class="tocviewlink" data-pltdoc="x">Syntax Transformers</a></td></tr><tr><td align="right">12.5&nbsp;</td><td><a href="stxparam.html" class="tocviewlink" data-pltdoc="x">Syntax Parameters</a></td></tr><tr><td align="right">12.6&nbsp;</td><td><a href="splicing.html" class="tocviewlink" data-pltdoc="x">Local Binding with Splicing Body</a></td></tr><tr><td align="right">12.7&nbsp;</td><td><a href="stxprops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Properties</a></td></tr><tr><td align="right">12.8&nbsp;</td><td><a href="stxcerts.html" class="tocviewlink" data-pltdoc="x">Syntax Taints</a></td></tr><tr><td align="right">12.9&nbsp;</td><td><a href="Expanding_Top-Level_Forms.html" class="tocviewlink" data-pltdoc="x">Expanding Top-<wbr></wbr>Level Forms</a></td></tr><tr><td align="right">12.10&nbsp;</td><td><a href="Serializing_Syntax.html" class="tocviewlink" data-pltdoc="x">Serializing Syntax</a></td></tr><tr><td align="right">12.11&nbsp;</td><td><a href="include.html" class="tocviewlink" data-pltdoc="x">File Inclusion</a></td></tr><tr><td align="right">12.12&nbsp;</td><td><a href="syntax-util.html" class="tocviewlink" data-pltdoc="x">Syntax Utilities</a></td></tr><tr><td align="right">12.13&nbsp;</td><td><a href="phase_space.html" class="tocviewlink" data-pltdoc="x">Phase and Space Utilities</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">syntax-<wbr></wbr>case</span></span></a></td></tr><tr><td><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%2A%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">syntax-<wbr></wbr>case*</span></span></a></td></tr><tr><td><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._with-syntax%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">syntax</span></span></a></td></tr><tr><td><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._quasisyntax%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">quasisyntax</span></span></a></td></tr><tr><td><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._unsyntax%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unsyntax</span></span></a></td></tr><tr><td><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._unsyntax-splicing%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unsyntax-<wbr></wbr>splicing</span></span></a></td></tr><tr><td><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%2Floc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">syntax/<span class="mywbr"> &nbsp;</span>loc</span></span></a></td></tr><tr><td><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._quasisyntax%2Floc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">quasisyntax/<span class="mywbr"> &nbsp;</span>loc</span></span></a></td></tr><tr><td><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._quote-syntax%2Fprune%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax/<span class="mywbr"> &nbsp;</span>prune</span></span></a></td></tr><tr><td><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">syntax-<wbr></wbr>rules</span></span></a></td></tr><tr><td><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-id-rules%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">syntax-<wbr></wbr>id-<wbr></wbr>rules</span></span></a></td></tr><tr><td><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._define-syntax-rule%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax-<wbr></wbr>rule</span></span></a></td></tr><tr><td><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="tocsublink" data-pltdoc="x"><span class="RktMeta"><span class="RktStxLink">...</span></span></a></td></tr><tr><td><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">_</span></span></a></td></tr><tr><td><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">~?</span></span></a></td></tr><tr><td><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~40%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">~@</span></span></a></td></tr><tr><td><a href="stx-patterns.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-pattern-variable~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>pattern-<wbr></wbr>variable?</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Macros.html" title="backward to &quot;12 Macros&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stxops.html" title="forward to &quot;12.2 Syntax Object Content&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;stx-patterns&quot;">12.1<tt>&nbsp;</tt><a name="(part._stx-patterns)"></a>Pattern-Based Syntax Matching</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/stxcase-scheme..rkt)._syntax-case))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">syntax-case</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx-expr</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">literal-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">clause</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktVar">result-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktVar">fender-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">result-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">pattern</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">np-pattern</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">np-pattern</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktVar">ellipsis</span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">np-pattern</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">np-pattern</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">#</span><span class="RktPn">(</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">#</span><span class="RktPn">(</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktVar">ellipsis</span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">#&amp;</span><span class="RktVar">pattern</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">#s</span><span class="RktPn">(</span><span class="RktVar">key-datum</span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">#s</span><span class="RktPn">(</span><span class="RktVar">key-datum</span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktVar">ellipsis</span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">ellipsis</span><span class="hspace">&nbsp;</span><span class="RktVar">stat-pattern</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">const</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">stat-pattern</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">stat-pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">stat-pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">stat-pattern</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">#</span><span class="RktPn">(</span><span class="RktVar">stat-pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">#&amp;</span><span class="RktVar">stat-pattern</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">#s</span><span class="RktPn">(</span><span class="RktVar">key-datum</span><span class="hspace">&nbsp;</span><span class="RktVar">stat-pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">const</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">ellipsis</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Finds the first <span class="RktVar">pattern</span> that matches the syntax object
+produced by <span class="RktVar">stx-expr</span>, and for which the corresponding
+<span class="RktVar">fender-expr</span> (if any) produces a true value; the result is
+from the corresponding <span class="RktVar">result-expr</span>, which is in tail position
+for the <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span> form. If no <span class="RktVar">clause</span> matches, then
+the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax</a></span> exception is raised; the exception is generated by calling
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._raise-syntax-error%29%29" class="RktValLink" data-pltdoc="x">raise-syntax-error</a></span> with <span class="RktVal">#f</span> as the &ldquo;name&rdquo; argument,
+a string with a generic error message, and the result of <span class="RktVar">stx-expr</span>.</div></p><p>A syntax object matches a <span class="RktVar">pattern</span> as follows:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">_</span></td></tr></table></blockquote><p>A <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span> pattern (i.e., an identifier with the same binding as
+<span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span> and not among the <span class="RktVar">literal-id</span>s) matches any syntax object.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">id</span></td></tr></table></blockquote><p>An <span class="RktVar">id</span> matches any syntax object when it is not bound to
+<span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span> or <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span> and does not have the same binding as
+any <span class="RktVar">literal-id</span>. The <span class="RktVar">id</span> is further bound as
+<a name="(tech._pattern._variable)"></a><span style="font-style: italic">pattern variable</span> for the corresponding <span class="RktVar">fender-expr</span>
+(if any) and <span class="RktVar">result-expr</span>. A pattern-variable binding is a
+transformer binding; the pattern variable can be referenced only
+through forms like <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%29%29" class="RktStxLink" data-pltdoc="x">syntax</a></span>. The binding&rsquo;s value is the syntax
+object that matched the pattern with a <a name="(tech._depth._marker)"></a><span style="font-style: italic">depth marker</span> of
+<span style="font-style: italic"></span>0<span style="font-style: italic"></span>.</p><p>With a <span class="RktVar">stat-pattern</span>, <span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span> is not treated specially.
+It either matches a <span class="RktVar">literal-id</span> or is bound as a
+pattern variable.</p><p>An <span class="RktVar">id</span> that has the same binding as a <span class="RktVar">literal-id</span>
+matches a syntax object that is an identifier with the same binding
+in the sense of <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span>.  The match does not
+introduce any <a href="stx-patterns.html#%28tech._pattern._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">pattern variables</span></a>.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p>A <span class="RktPn">(</span><span class="RktVar">pattern</span><span class="stt"> </span><span class="RktMeta">...</span><span class="RktPn">)</span> pattern matches a syntax object whose datum
+form (i.e., without lexical information) is a list with as many
+elements as sub-<span class="RktVar">pattern</span>s in the pattern, and where each
+syntax object that corresponds to an element of the list matches
+the corresponding sub-<span class="RktVar">pattern</span>.</p><p>Any <a href="stx-patterns.html#%28tech._pattern._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">pattern variables</span></a> bound by the sub-<span class="RktVar">pattern</span>s are
+bound by the complete pattern; the bindings must all be distinct.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">np-pattern</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Like the previous kind of pattern, but matches syntax objects that
+are not necessarily lists; for <span style="font-style: italic">n</span> sub-<span class="RktVar">pattern</span>s before
+the final <span class="RktVar">np-pattern</span>, the syntax object&rsquo;s datum must be a
+pair such that <span style="font-style: italic">n-</span>1<span style="font-style: italic"></span> <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span>s produce pairs. The final
+<span class="RktVar">np-pattern</span> is matched against the syntax object
+corresponding to the <span style="font-style: italic">n</span>th <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> (or the
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span> coercion of the datum using the nearest
+enclosing syntax object&rsquo;s lexical context and source location).</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktVar">ellipsis</span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Like the <span class="RktPn">(</span><span class="RktVar">pattern</span><span class="stt"> </span><span class="RktMeta">...</span><span class="RktPn">)</span> kind of pattern, but matching a
+syntax object with any number (zero or more) elements that match the
+sub-<span class="RktVar">pattern</span> followed by <span class="RktVar">ellipsis</span> in the
+corresponding position relative to other sub-<span class="RktVar">pattern</span>s.</p><p>For each pattern variable bound by the sub-<span class="RktVar">pattern</span> followed
+by <span class="RktVar">ellipsis</span>, the larger pattern binds the same pattern
+variable to a list of values, one for each element of the syntax
+object matched to the sub-<span class="RktVar">pattern</span>, with an incremented
+<a href="stx-patterns.html#%28tech._depth._marker%29" class="techoutside" data-pltdoc="x"><span class="techinside">depth marker</span></a>. (The sub-<span class="RktVar">pattern</span> itself may contain
+<span class="RktVar">ellipsis</span>, leading to a pattern variables bound to lists of
+lists of syntax objects with a <a href="stx-patterns.html#%28tech._depth._marker%29" class="techoutside" data-pltdoc="x"><span class="techinside">depth marker</span></a> of <span style="font-style: italic"></span>2<span style="font-style: italic"></span>, and
+so on.)</p><p>All patterns forms with <span class="RktVar">ellipsis</span> apply only when
+<span class="RktVar">ellipsis</span> is not among the <span class="RktVar">literal-id</span>s.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktVar">ellipsis</span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">np-pattern</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Like the previous kind of pattern, but with a final
+<span class="RktVar">np-pattern</span> as for <span class="RktPn">(</span><span class="RktVar">pattern</span><span class="stt"> </span><span class="RktMeta"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-patterns.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._......%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...+</a></span><span class="stt"> </span><span class="RktPn">. </span><span class="RktVar">np-pattern</span><span class="RktPn">)</span>.  The
+final <span class="RktVar">np-pattern</span> never matches a syntax object whose datum is a
+pair.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="stt">#</span><span class="RktPn">(</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Like a <span class="RktPn">(</span><span class="RktVar">pattern</span><span class="stt"> </span><span class="RktMeta">...</span><span class="RktPn">)</span> pattern, but matching a vector syntax object
+whose elements match the corresponding sub-<span class="RktVar">pattern</span>s.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="stt">#</span><span class="RktPn">(</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktVar">ellipsis</span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Like a <span class="RktPn">(</span><span class="RktVar">pattern</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="stt"> </span><span class="RktVar">pattern</span><span class="stt"> </span><span class="RktVar">ellipsis</span><span class="stt"> </span><span class="RktVar">pattern</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> pattern,
+but matching a vector syntax object whose elements match the
+corresponding sub-<span class="RktVar">pattern</span>s.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="stt">#&amp;</span><span class="RktVar">pattern</span></td></tr></table></blockquote><p>Matches a box syntax object whose content matches the
+<span class="RktVar">pattern</span>.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="stt">#s</span><span class="RktPn">(</span><span class="RktVar">key-datum</span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Like a <span class="RktPn">(</span><span class="RktVar">pattern</span><span class="stt"> </span><span class="RktMeta">...</span><span class="RktPn">)</span> pattern, but matching a <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a>
+structure syntax object whose fields match the corresponding
+sub-<span class="RktVar">pattern</span>s. The <span class="RktVar">key-datum</span> must correspond to a
+valid first argument to <span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._make-prefab-struct%29%29" class="RktValLink" data-pltdoc="x">make-prefab-struct</a></span>.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="stt">#s</span><span class="RktPn">(</span><span class="RktVar">key-datum</span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktVar">ellipsis</span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Like a <span class="RktPn">(</span><span class="RktVar">pattern</span><span class="stt"> </span><span class="RktMeta">...</span><span class="stt"> </span><span class="RktVar">pattern</span><span class="stt"> </span><span class="RktVar">ellipsis</span><span class="stt"> </span><span class="RktVar">pattern</span><span class="stt"> </span><span class="RktMeta">...</span><span class="RktPn">)</span> pattern,
+but matching a <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure syntax object whose elements
+match the corresponding sub-<span class="RktVar">pattern</span>s.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktVar">ellipsis</span><span class="hspace">&nbsp;</span><span class="RktVar">stat-pattern</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Matches the same as <span class="RktVar">stat-pattern</span>, which is like a <span class="RktVar">pattern</span>,
+but identifiers with the binding <span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span> are treated the same as
+other <span class="RktVar">id</span>s.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">const</span></td></tr></table></blockquote><p>A <span class="RktVar">const</span> is any datum that does not match one of the
+preceding forms; a syntax object matches a <span class="RktVar">const</span> pattern
+when its datum is <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to the <span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span>d
+<span class="RktVar">const</span>.</p></blockquote><p>If <span class="RktVar">stx-expr</span> produces a non-<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>, then its
+result is converted to a syntax object using <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span>
+and the lexical context and source location of the <span class="RktVar">stx-expr</span>.</p><p>If <span class="RktVar">stx-expr</span> produces a syntax object that is <a href="stxcerts.html#%28tech._tainted%29" class="techoutside" data-pltdoc="x"><span class="techinside">tainted</span></a>,
+then any syntax object bound by a <span class="RktVar">pattern</span>
+are <a href="stxcerts.html#%28tech._tainted%29" class="techoutside" data-pltdoc="x"><span class="techinside">tainted</span></a>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">t</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(10 5)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">ops</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._~3d~3e%29%29" class="RktStxLink" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">op</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;syntax:eval:657:0 (+ 1 2 3)&gt;</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">z</span><span class="hspace">&nbsp;</span><span class="RktVal">12</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">var</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Library_Syntax_Classes_and_Literal_Sets.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._expr%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">expr</a></span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">var</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Library_Syntax_Classes_and_Literal_Sets.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._expr%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">expr</a></span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(#&lt;syntax:eval:658:0 (x y z)&gt; #&lt;syntax:eval:658:0 (5 9 12)&gt;)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/stxcase-scheme..rkt)._syntax-case*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">syntax-case*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx-expr</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">literal-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">id-compare-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span>, but <span class="RktVar">id-compare-expr</span> must produce a
+procedure that accepts two arguments. A <span class="RktVar">literal-id</span> in a
+<span class="RktVar">pattern</span> matches an identifier for which the procedure
+returns true when given the identifier to match (as the first argument)
+and the identifier in the <span class="RktVar">pattern</span> (as the second argument).</div></p><p>In other words, <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span> is like <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%2A%29%29" class="RktStxLink" data-pltdoc="x">syntax-case*</a></span> with
+an <span class="RktVar">id-compare-expr</span> that produces <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/stxcase-scheme..rkt)._with-syntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._with-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">with-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktVar">stx-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span>, in that it matches a <span class="RktVar">pattern</span>
+to a syntax object. Unlike <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span>, all <span class="RktVar">pattern</span>s
+are matched, each to the result of a corresponding <span class="RktVar">stx-expr</span>,
+and the pattern variables from all matches (which must be distinct)
+are bound with a single <span class="RktVar">body</span> sequence. The result of the
+<span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._with-syntax%29%29" class="RktStxLink" data-pltdoc="x">with-syntax</a></span> form is the result of the last <span class="RktVar">body</span>,
+which is in tail position with respect to the <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._with-syntax%29%29" class="RktStxLink" data-pltdoc="x">with-syntax</a></span>
+form.</div></p><p>If any <span class="RktVar">pattern</span> fails to match the corresponding
+<span class="RktVar">stx-expr</span>, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax</a></span> exception is raised.</p><p>A <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._with-syntax%29%29" class="RktStxLink" data-pltdoc="x">with-syntax</a></span> form is roughly equivalent to the following
+<span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span> form:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVar">stx-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-patterns.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._......%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...+</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></blockquote><p>However, if any individual <span class="RktVar">stx-expr</span> produces a
+non-<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>, then it is converted to one using
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span> and the lexical context and source location of
+the individual <span class="RktVar">stx-expr</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hello</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%29%29" class="RktStxLink" data-pltdoc="x">place</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._with-syntax%29%29" class="RktStxLink" data-pltdoc="x">with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">print-name</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a\n"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">name</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">print-place</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a\n"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">place</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktSym">times</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Hello\n"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">times</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">print-name</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="places.html#%28form._%28%28lib._racket%2Fplace..rkt%29._place%29%29" class="RktStxLink" data-pltdoc="x">place</a></span><span class="hspace">&nbsp;</span><span class="RktSym">times</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"From\n"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="for.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for%29%29" class="RktStxLink" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-range%29%29" class="RktValLink" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">times</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">print-place</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">hello</span><span class="hspace">&nbsp;</span><span class="RktSym">jon</span><span class="hspace">&nbsp;</span><span class="RktSym">utah</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">jon</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">Hello</span></p></td></tr><tr><td><p><span class="RktOut">jon</span></p></td></tr><tr><td><p><span class="RktOut">jon</span></p></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">utah</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">From</span></p></td></tr><tr><td><p><span class="RktOut">utah</span></p></td></tr><tr><td><p><span class="RktOut">utah</span></p></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">math</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make+1</span><span class="hspace">&nbsp;</span><span class="RktSym">expression</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._with-syntax%29%29" class="RktStxLink" data-pltdoc="x">with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">e</span><span class="hspace">&nbsp;</span><span class="RktSym">expression</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">e</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">numbers</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._with-syntax%29%29" class="RktStxLink" data-pltdoc="x">with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">added</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym">make+1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3elist%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">numbers</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"got ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">added</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">math</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">got 4</span></p></td></tr><tr><td><p><span class="RktOut">got 2</span></p></td></tr><tr><td><p><span class="RktOut">got 5</span></p></td></tr><tr><td><p><span class="RktOut">got 2</span></p></td></tr><tr><td><p><span class="RktOut">got 6</span></p></td></tr><tr><td><p><span class="RktOut">got 10</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/stxcase-scheme..rkt)._syntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">template</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">template</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">head-template</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">head-template</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">template</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">#</span><span class="RktPn">(</span><span class="RktVar">head-template</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">#&amp;</span><span class="RktVar">template</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">#s</span><span class="RktPn">(</span><span class="RktVar">key-datum</span><span class="hspace">&nbsp;</span><span class="RktVar">head-template</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~3f%29%29" class="RktStxLink" data-pltdoc="x">~?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">template</span><span class="hspace">&nbsp;</span><span class="RktVar">template</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">ellipsis</span><span class="hspace">&nbsp;</span><span class="RktVar">stat-template</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">const</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">head-template</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">template</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">head-template</span><span class="hspace">&nbsp;</span><span class="RktVar">ellipsis</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~40%29%29" class="RktStxLink" data-pltdoc="x">~@</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">template</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~3f%29%29" class="RktStxLink" data-pltdoc="x">~?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">head-template</span><span class="hspace">&nbsp;</span><span class="RktVar">head-template</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~3f%29%29" class="RktStxLink" data-pltdoc="x">~?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">head-template</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">stat-template</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline">like <span class="RktVar">template</span>, but without <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span>,
+<span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~3f%29%29" class="RktStxLink" data-pltdoc="x">~?</a></span>, and <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~40%29%29" class="RktStxLink" data-pltdoc="x">~@</a></span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">ellipsis</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Constructs a syntax object based on a <span class="RktVar">template</span>, which can
+include <a href="stx-patterns.html#%28tech._pattern._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">pattern variables</span></a> bound by <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span> or
+<span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._with-syntax%29%29" class="RktStxLink" data-pltdoc="x">with-syntax</a></span>.</div></p><p>A <span class="RktVar">template</span> produces a single syntax object. A
+<span class="RktVar">head-template</span> produces a sequence of zero or more syntax
+objects. A <span class="RktVar">stat-template</span> is like a <span class="RktVar">template</span>, except that
+<span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span>, <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~3f%29%29" class="RktStxLink" data-pltdoc="x">~?</a></span>, and <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~40%29%29" class="RktStxLink" data-pltdoc="x">~@</a></span> are interpreted as
+constants instead of template forms.</p><p>A <span class="RktVar">template</span> produces a syntax object as follows:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">id</span></td></tr></table></blockquote><p>If <span class="RktVar">id</span> is bound as a <a href="stx-patterns.html#%28tech._pattern._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">pattern variable</span></a>, then
+<span class="RktVar">id</span> as a template produces the <a href="stx-patterns.html#%28tech._pattern._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">pattern variable</span></a>&rsquo;s
+match result. Unless the <span class="RktVar">id</span> is a sub-<span class="RktVar">template</span> that is
+replicated by <span class="RktVar">ellipsis</span> in a larger <span class="RktVar">template</span>, the
+<a href="stx-patterns.html#%28tech._pattern._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">pattern variable</span></a>&rsquo;s value must be a syntax object with a
+<a href="stx-patterns.html#%28tech._depth._marker%29" class="techoutside" data-pltdoc="x"><span class="techinside">depth marker</span></a> of <span style="font-style: italic"></span>0<span style="font-style: italic"></span> (as opposed to a list of
+matches).</p><p>More generally, if the <a href="stx-patterns.html#%28tech._pattern._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">pattern variable</span></a>&rsquo;s value has a depth
+marker <span style="font-style: italic">n</span>, then it can only appear within a template where it
+is replicated by at least <span style="font-style: italic">n</span> <span class="RktVar">ellipsis</span>es. In that case,
+the template will be replicated enough times to use each match result
+at least once.</p><p>If <span class="RktVar">id</span> is not bound as a pattern variable, then <span class="RktVar">id</span>
+as a template produces <span class="RktPn">(</span><span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span>.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktVar">head-template</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Produces a syntax object whose datum is a list, and where the
+elements of the list correspond to syntax objects produced by the
+<span class="RktVar">head-template</span>s.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktVar">head-template</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">template</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Like the previous form, but the result is not necessarily a list;
+instead, the place of the empty list in the resulting syntax object&rsquo;s
+datum is taken by the syntax object produced by <span class="RktVar">template</span>.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="stt">#</span><span class="RktPn">(</span><span class="RktVar">head-template</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Like the <span class="RktPn">(</span><span class="RktVar">head-template</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> form, but producing a syntax
+object whose datum is a vector instead of a list.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="stt">#&amp;</span><span class="RktVar">template</span></td></tr></table></blockquote><p>Produces a syntax object whose datum is a box holding the
+syntax object produced by <span class="RktVar">template</span>.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="stt">#s</span><span class="RktPn">(</span><span class="RktVar">key-datum</span><span class="hspace">&nbsp;</span><span class="RktVar">head-template</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Like the <span class="RktPn">(</span><span class="RktVar">head-template</span><span class="stt"> </span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span> form, but producing a syntax
+object whose datum is a <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure instead of a list.
+The <span class="RktVar">key-datum</span> must correspond to a valid first argument of
+<span class="RktSym"><a href="structutils.html#%28def._%28%28quote._~23~25kernel%29._make-prefab-struct%29%29" class="RktValLink" data-pltdoc="x">make-prefab-struct</a></span>.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~3f%29%29" class="RktStxLink" data-pltdoc="x">~?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">template1</span><span class="hspace">&nbsp;</span><span class="RktVar">template2</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Produces the result of <span class="RktVar">template1</span> if <span class="RktVar">template1</span> has no
+pattern variables with &ldquo;missing values&rdquo;; otherwise, produces the result of
+<span class="RktVar">template2</span>.</p><p>A pattern variable bound by <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span> never has a missing value, but
+pattern variables bound by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Parsing_Syntax.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._syntax-parse%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-parse</a></span> (for example, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-patterns.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._%7E7eor%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">~or</a></span> or
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-patterns.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._%7E7eoptional%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">~optional</a></span> patterns) can.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Parsing_Syntax.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._syntax-parse%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-parse</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-patterns.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._%7E7eoptional%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">~optional</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-patterns.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._%7E7eseq%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">~seq</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:op</span><span class="hspace">&nbsp;</span><span class="RktSym">op:expr</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">arg:expr</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~3f%29%29" class="RktStxLink" data-pltdoc="x">~?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;syntax:eval:3:0 (+ 1 2 3)&gt;</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Parsing_Syntax.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._syntax-parse%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-parse</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktPn">#:op</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._max%29%29" class="RktValLink" data-pltdoc="x">max</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-patterns.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._%7E7eoptional%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">~optional</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-patterns.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._%7E7eseq%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">~seq</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:op</span><span class="hspace">&nbsp;</span><span class="RktSym">op:expr</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">arg:expr</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~3f%29%29" class="RktStxLink" data-pltdoc="x">~?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;syntax:eval:4:0 (max 1 2 3)&gt;</span></p></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktVar">ellipsis</span><span class="hspace">&nbsp;</span><span class="RktVar">stat-template</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Produces the same result as <span class="RktVar">stat-template</span>, which is like a
+<span class="RktVar">template</span>, but <span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span>, <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~3f%29%29" class="RktStxLink" data-pltdoc="x">~?</a></span>, and <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~40%29%29" class="RktStxLink" data-pltdoc="x">~@</a></span>
+are treated like an <span class="RktVar">id</span> (with no pattern binding).</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">const</span></td></tr></table></blockquote><p>A <span class="RktVar">const</span> template is any form that does not match the
+preceding cases, and it produces the result <span class="RktPn">(</span><span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span><span class="stt"> </span><span class="RktVar">const</span><span class="RktPn">)</span>.</p></blockquote><p>A <span class="RktVar">head-template</span> produces a sequence of syntax objects; that sequence is
+&ldquo;inlined&rdquo; into the result of the enclosing <span class="RktVar">template</span>. The result of a
+<span class="RktVar">head-template</span> is defined as follows:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">template</span></td></tr></table></blockquote><p>Produces one syntax object, according to the rules for <span class="RktVar">template</span>
+above.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">head-template</span><span class="hspace">&nbsp;</span><span class="RktVar">ellipsis</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span></td></tr></table></blockquote><p>Generates a sequence of syntax objects by &ldquo;<span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span>ping&rdquo; the
+<span class="RktVar">head-template</span> over the values of its pattern variables. The number of
+iterations depends on the values of the <a href="stx-patterns.html#%28tech._pattern._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">pattern variables</span></a> referenced
+within the sub-template.</p><p>To be more precise: Let <span class="RktVar">outer</span> be <span class="RktVar">inner</span> followed by one
+ellipsis. A <a href="stx-patterns.html#%28tech._pattern._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">pattern variable</span></a> is an <a name="(tech._iteration._pattern._variable)"></a><span style="font-style: italic">iteration pattern variable</span>
+for <span class="RktVar">outer</span> if occurs at a depth equal to its <a href="stx-patterns.html#%28tech._depth._marker%29" class="techoutside" data-pltdoc="x"><span class="techinside">depth
+marker</span></a>. There must be at least one; otherwise, an error is raised. If there
+are multiple iteration variables, then all of their values must be lists of
+the same length. The result for <span class="RktVar">outer</span> is produced by
+<span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fmap..rkt%29._map%29%29" class="RktValLink" data-pltdoc="x">map</a></span>ping the <span class="RktVar">inner</span> template over the <a href="stx-patterns.html#%28tech._iteration._pattern._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">iteration pattern
+variable</span></a> values and decreasing their effective <a href="stx-patterns.html#%28tech._depth._marker%29" class="techoutside" data-pltdoc="x"><span class="techinside">depth markers</span></a> by 1
+within <span class="RktVar">inner</span>. The <span class="RktVar">outer</span> result is formed by appending the
+<span class="RktVar">inner</span> results.</p><p>Consequently, if a <a href="stx-patterns.html#%28tech._pattern._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">pattern variable</span></a> occurs at a depth greater than its
+<a href="stx-patterns.html#%28tech._depth._marker%29" class="techoutside" data-pltdoc="x"><span class="techinside">depth marker</span></a>, it is used as an <a href="stx-patterns.html#%28tech._iteration._pattern._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">iteration pattern variable</span></a> for
+the innermost ellipses but not the outermost. A <a href="stx-patterns.html#%28tech._pattern._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">pattern variable</span></a> must
+not occur at a depth less than its <a href="stx-patterns.html#%28tech._depth._marker%29" class="techoutside" data-pltdoc="x"><span class="techinside">depth marker</span></a>; otherwise, an error is
+raised.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~40%29%29" class="RktStxLink" data-pltdoc="x">~@</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">template</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Produces the sequence of elements in the syntax list produced by
+<span class="RktVar">template</span>. If <span class="RktVar">template</span> does not produce a proper syntax list,
+an exception is raised.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._with-syntax%29%29" class="RktStxLink" data-pltdoc="x">with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">key</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash%29%29" class="RktValLink" data-pltdoc="x">hash</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~40%29%29" class="RktStxLink" data-pltdoc="x">~@</a></span><span class="hspace">&nbsp;</span><span class="RktSym">key</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;syntax:eval:2:0 (hash (quote a) 1 (quote b) 2 (quote c) 3)&gt;</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._with-syntax%29%29" class="RktStxLink" data-pltdoc="x">with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">xs</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~40%29%29" class="RktStxLink" data-pltdoc="x">~@</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">xs</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;syntax:eval:3:0 (list 1 2 3 4 5)&gt;</span></p></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~3f%29%29" class="RktStxLink" data-pltdoc="x">~?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">head-template1</span><span class="hspace">&nbsp;</span><span class="RktVar">head-template2</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Produces the result of <span class="RktVar">head-template1</span> if none of its pattern
+variables have &ldquo;missing values&rdquo;; otherwise produces the result of
+<span class="RktVar">head-template2</span>. </p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~3f%29%29" class="RktStxLink" data-pltdoc="x">~?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">head-template</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Produces the result of <span class="RktVar">head-template</span> if none of its pattern
+variables have &ldquo;missing values&rdquo;; otherwise produces nothing.</p><p>Equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~3f%29%29" class="RktStxLink" data-pltdoc="x">~?</a></span><span class="stt"> </span><span class="RktVar">head-template</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~40%29%29" class="RktStxLink" data-pltdoc="x">~@</a></span><span class="RktPn">)</span><span class="RktPn">)</span>. </p></blockquote><p>A <span class="RktPn">(</span><span class="RktKw">syntax</span><span class="stt"> </span><span class="RktVar">template</span><span class="RktPn">)</span> form is normally
+abbreviated as <span class="RktRdr">#'</span><span class="RktVar">template</span>; see also
+<a href="reader.html#%28part._parse-quote%29" data-pltdoc="x">Reading Quotes</a>. If <span class="RktVar">template</span> contains no pattern
+variables, then <span class="RktRdr">#'</span><span class="RktVar">template</span> is equivalent to
+<span class="RktPn">(</span><span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span><span class="stt"> </span><span class="RktVar">template</span><span class="RktPn">)</span>.</p><p class="SHistory">Changed in version 6.90.0.25 of package <span class="stt">base</span>: Added <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~40%29%29" class="RktStxLink" data-pltdoc="x">~@</a></span> and <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~3f%29%29" class="RktStxLink" data-pltdoc="x">~?</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/qqstx..rkt)._quasisyntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._quasisyntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">quasisyntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">template</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%29%29" class="RktStxLink" data-pltdoc="x">syntax</a></span>, but <span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._unsyntax%29%29" class="RktStxLink" data-pltdoc="x">unsyntax</a></span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span> and <span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._unsyntax-splicing%29%29" class="RktStxLink" data-pltdoc="x">unsyntax-splicing</a></span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span>
+escape to an expression within the <span class="RktVar">template</span>.</div></p><p>The <span class="RktVar">expr</span> must produce a syntax object (or syntax list) to be
+substituted in place of the <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._unsyntax%29%29" class="RktStxLink" data-pltdoc="x">unsyntax</a></span> or
+<span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._unsyntax-splicing%29%29" class="RktStxLink" data-pltdoc="x">unsyntax-splicing</a></span> form within the quasiquoting template, just
+like <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote%29%29" class="RktStxLink" data-pltdoc="x">unquote</a></span> and <span class="RktSym"><a href="quasiquote.html#%28form._%28%28quote._~23~25kernel%29._unquote-splicing%29%29" class="RktStxLink" data-pltdoc="x">unquote-splicing</a></span> within
+<span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span>, except that a hash table value position is not
+an escape position for <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._quasisyntax%29%29" class="RktStxLink" data-pltdoc="x">quasisyntax</a></span>. (If the escaped expression does not generate a
+syntax object, it is converted to one in the same way as for the
+right-hand side of <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._with-syntax%29%29" class="RktStxLink" data-pltdoc="x">with-syntax</a></span>.)  Nested
+<span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._quasisyntax%29%29" class="RktStxLink" data-pltdoc="x">quasisyntax</a></span>es introduce quasiquoting layers in the same way
+as nested <span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span>s.</p><p>Also analogous to <span class="RktSym"><a href="quasiquote.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._quasiquote%29%29" class="RktStxLink" data-pltdoc="x">quasiquote</a></span>, the reader converts <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#`</span><span class="hspace"></span></span>
+to <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._quasisyntax%29%29" class="RktStxLink" data-pltdoc="x">quasisyntax</a></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#,</span><span class="hspace"></span></span> to <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._unsyntax%29%29" class="RktStxLink" data-pltdoc="x">unsyntax</a></span>, and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#,@</span><span class="hspace"></span></span> to <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._unsyntax-splicing%29%29" class="RktStxLink" data-pltdoc="x">unsyntax-splicing</a></span>. See also
+<a href="reader.html#%28part._parse-quote%29" data-pltdoc="x">Reading Quotes</a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/qqstx..rkt)._unsyntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._unsyntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">unsyntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Library_Syntax_Classes_and_Literal_Sets.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._expr%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">expr</a></span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Illegal as an expression form. The <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._unsyntax%29%29" class="RktStxLink" data-pltdoc="x">unsyntax</a></span> form is for use
+only with a <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._quasisyntax%29%29" class="RktStxLink" data-pltdoc="x">quasisyntax</a></span> template.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/qqstx..rkt)._unsyntax-splicing))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._unsyntax-splicing%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">unsyntax-splicing</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Illegal as an expression form. The <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._unsyntax-splicing%29%29" class="RktStxLink" data-pltdoc="x">unsyntax-splicing</a></span> form is
+for use only with a <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._quasisyntax%29%29" class="RktStxLink" data-pltdoc="x">quasisyntax</a></span> template.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/stxcase-scheme..rkt)._syntax/loc))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%2Floc%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">syntax/loc</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">loc-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">template</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">loc-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._srcloc~3f%29%29" class="RktValLink" data-pltdoc="x">srcloc?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector%2Fc%29%29" class="RktValLink" data-pltdoc="x">vector/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%29%29" class="RktStxLink" data-pltdoc="x">syntax</a></span>, except that the immediate resulting syntax
+object takes its source-location information from the result of
+<span class="RktVar">loc-expr</span>.</div></p><p>Only the source location of the immediate result&#8212;<wbr></wbr>the &ldquo;outermost&rdquo;
+syntax object&#8212;<wbr></wbr>is adjusted. The source location is <span class="emph">not</span>
+adjusted if both the source and position of <span class="RktVar">loc-expr</span> are
+<span class="RktVal">#f</span>. The source location is adjusted only if the resulting
+syntax object comes from the template itself rather than the value of
+a syntax pattern variable. For example, if <span class="RktVar">x</span> is a syntax
+pattern variable, then <span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%2Floc%29%29" class="RktStxLink" data-pltdoc="x">syntax/loc</a></span><span class="stt"> </span><span class="RktVar">loc-expr</span><span class="stt"> </span><span class="RktVar">x</span><span class="RktPn">)</span> does not use
+the location of <span class="RktVar">loc-expr</span>.</p><p class="SHistory">Changed in version 6.90.0.25 of package <span class="stt">base</span>: Previously, <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%2Floc%29%29" class="RktStxLink" data-pltdoc="x">syntax/loc</a></span>
+did not enforce the contract on <span class="RktVar">loc-expr</span> if <span class="RktVar">template</span>
+was just a pattern variable.<br/>Changed in version 8.2.0.6: Allows <span class="RktVar">loc-expr</span> to be any
+source location value that <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span> accepts.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/qqstx..rkt)._quasisyntax/loc))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._quasisyntax%2Floc%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">quasisyntax/loc</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">loc-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">template</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">loc-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._srcloc~3f%29%29" class="RktValLink" data-pltdoc="x">srcloc?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector%2Fc%29%29" class="RktValLink" data-pltdoc="x">vector/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fqqstx..rkt%29._quasisyntax%29%29" class="RktStxLink" data-pltdoc="x">quasisyntax</a></span>, but with source-location assignment like
+<span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%2Floc%29%29" class="RktStxLink" data-pltdoc="x">syntax/loc</a></span>.</div></p><p class="SHistory">Changed in version 8.2.0.6 of package <span class="stt">base</span>: Allows <span class="RktVar">loc-expr</span> to be any
+source location value that <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span> accepts.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/stxcase-scheme..rkt)._quote-syntax/prune))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._quote-syntax%2Fprune%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">quote-syntax/prune</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span>, but the lexical context of <span class="RktVar">id</span> is
+pruned via <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._identifier-prune-lexical-context%29%29" class="RktValLink" data-pltdoc="x">identifier-prune-lexical-context</a></span> to including
+binding only for the symbolic name of <span class="RktVar">id</span> and for
+<span class="RktVal">'</span><span class="RktVal">#%top</span>. Use this form to quote an identifier when its lexical
+information will not be transferred to other syntax objects (except
+maybe to <span class="RktVal">'</span><span class="RktVal">#%top</span> for a top-level binding).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/stxcase-scheme..rkt)._syntax-rules))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">syntax-rules</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">literal-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">pattern</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">template</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to</div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">literal-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">generated-id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">pattern</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxcerts.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-protect%29%29" class="RktValLink" data-pltdoc="x">syntax-protect</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVar">template</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>where each <span class="RktVar">generated-id</span> binds no identifier in the
+corresponding <span class="RktVar">template</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/private/stxcase-scheme..rkt)._syntax-id-rules))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-id-rules%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">syntax-id-rules</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">literal-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktVar">template</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to</div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-set%21-transformer%29%29" class="RktValLink" data-pltdoc="x">make-set!-transformer</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">literal-id</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxcerts.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-protect%29%29" class="RktValLink" data-pltdoc="x">syntax-protect</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVar">template</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/misc..rkt)._define-syntax-rule))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._define-syntax-rule%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-syntax-rule</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">pattern</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">template</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to</div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="RktStxLink" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">pattern</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">template</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>but with syntax errors potentially phrased in terms of
+<span class="RktVar">pattern</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/private/stxcase-scheme..rkt)._......))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">...</a></span></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span> transformer binding prohibits <span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span> from
+being used as an expression. This binding is useful only in syntax
+patterns and templates (or other unrelated expression forms
+that treat it specially like <span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span>), where it indicates repetitions
+of a pattern or template. See <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span> and <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%29%29" class="RktStxLink" data-pltdoc="x">syntax</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/private/stxcase-scheme..rkt).__))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">_</a></span></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span> transformer binding prohibits <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span> from being
+used as an expression. This binding is useful only in syntax patterns,
+where it indicates a pattern that matches any syntax object. See
+<span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/private/stxcase-scheme..rkt)._~7e~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~3f%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">~?</a></span></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><a name="(form._((lib._racket/private/stxcase-scheme..rkt)._~7e~40))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~40%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">~@</a></span></span></p></blockquote></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~3f%29%29" class="RktStxLink" data-pltdoc="x">~?</a></span> and <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._~7e~40%29%29" class="RktStxLink" data-pltdoc="x">~@</a></span> transformer bindings prohibit these forms from
+being used as an expression. The bindings are useful only in syntax templates.
+See <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%29%29" class="RktStxLink" data-pltdoc="x">syntax</a></span>.</div></p><p class="SHistory">Added in version 6.90.0.25 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/stxcase-scheme..rkt)._syntax-pattern-variable~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stx-patterns.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-pattern-variable~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-pattern-variable?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a value that, as a
+transformer-binding value, makes the bound variable as pattern
+variable in <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%29%29" class="RktStxLink" data-pltdoc="x">syntax</a></span> and other forms. To check whether an
+identifier is a pattern variable, use <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value</a></span> to
+get the identifier&rsquo;s transformer value, and then test the value with
+<span class="RktSym"><a href="stx-patterns.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-pattern-variable~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-pattern-variable?</a></span>.</div></p><p>The <span class="RktSym"><a href="stx-patterns.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-pattern-variable~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-pattern-variable?</a></span> procedure is provided
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span> by <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Macros.html" title="backward to &quot;12 Macros&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stxops.html" title="forward to &quot;12.2 Syntax Object Content&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/stxcerts.html b/clones/docs.racket-lang.org/reference/stxcerts.html
new file mode 100644
index 00000000..ce8c823d
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/stxcerts.html
@@ -0,0 +1,27 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>12.8&nbsp;Syntax Taints</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">12.1&nbsp;</td><td><a href="stx-patterns.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Syntax Matching</a></td></tr><tr><td align="right">12.2&nbsp;</td><td><a href="stxops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Content</a></td></tr><tr><td align="right">12.3&nbsp;</td><td><a href="stxcmp.html" class="tocviewlink" data-pltdoc="x">Syntax Object Bindings</a></td></tr><tr><td align="right">12.4&nbsp;</td><td><a href="stxtrans.html" class="tocviewlink" data-pltdoc="x">Syntax Transformers</a></td></tr><tr><td align="right">12.5&nbsp;</td><td><a href="stxparam.html" class="tocviewlink" data-pltdoc="x">Syntax Parameters</a></td></tr><tr><td align="right">12.6&nbsp;</td><td><a href="splicing.html" class="tocviewlink" data-pltdoc="x">Local Binding with Splicing Body</a></td></tr><tr><td align="right">12.7&nbsp;</td><td><a href="stxprops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Properties</a></td></tr><tr><td align="right">12.8&nbsp;</td><td><a href="stxcerts.html" class="tocviewselflink" data-pltdoc="x">Syntax Taints</a></td></tr><tr><td align="right">12.9&nbsp;</td><td><a href="Expanding_Top-Level_Forms.html" class="tocviewlink" data-pltdoc="x">Expanding Top-<wbr></wbr>Level Forms</a></td></tr><tr><td align="right">12.10&nbsp;</td><td><a href="Serializing_Syntax.html" class="tocviewlink" data-pltdoc="x">Serializing Syntax</a></td></tr><tr><td align="right">12.11&nbsp;</td><td><a href="include.html" class="tocviewlink" data-pltdoc="x">File Inclusion</a></td></tr><tr><td align="right">12.12&nbsp;</td><td><a href="syntax-util.html" class="tocviewlink" data-pltdoc="x">Syntax Utilities</a></td></tr><tr><td align="right">12.13&nbsp;</td><td><a href="phase_space.html" class="tocviewlink" data-pltdoc="x">Phase and Space Utilities</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="stxcerts.html#%28def._%28%28quote._~23~25kernel%29._syntax-tainted~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>tainted?</span></span></a></td></tr><tr><td><a href="stxcerts.html#%28def._%28%28quote._~23~25kernel%29._syntax-arm%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>arm</span></span></a></td></tr><tr><td><a href="stxcerts.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-protect%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>protect</span></span></a></td></tr><tr><td><a href="stxcerts.html#%28def._%28%28quote._~23~25kernel%29._syntax-disarm%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>disarm</span></span></a></td></tr><tr><td><a href="stxcerts.html#%28def._%28%28quote._~23~25kernel%29._syntax-rearm%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>rearm</span></span></a></td></tr><tr><td><a href="stxcerts.html#%28def._%28%28quote._~23~25kernel%29._syntax-taint%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>taint</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stxprops.html" title="backward to &quot;12.7 Syntax Object Properties&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Expanding_Top-Level_Forms.html" title="forward to &quot;12.9 Expanding Top-Level Forms&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;stxcerts&quot;">12.8<tt>&nbsp;</tt><a name="(part._stxcerts)"></a>Syntax Taints</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=stx-certs.html&amp;version=8.6" class="Sq" data-pltdoc="x">Tainted Syntax</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces syntax taints.</p></blockquote></blockquote></blockquote><p>A <a name="(tech._tainted)"></a><span style="font-style: italic">tainted</span> identifier is rejected by the macro expander for
+use as either a binding or expression. If a syntax object <span class="RktVar">stx</span> is
+<a href="stxcerts.html#%28tech._tainted%29" class="techoutside" data-pltdoc="x"><span class="techinside">tainted</span></a>, then any syntax object in the result of
+<span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span><span class="stt"> </span><span class="RktVar">stx</span><span class="RktPn">)</span> is <a href="stxcerts.html#%28tech._tainted%29" class="techoutside" data-pltdoc="x"><span class="techinside">tainted</span></a>, and <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span>
+with <span class="RktVar">stx</span> as its first argument produces a <a href="stxcerts.html#%28tech._tainted%29" class="techoutside" data-pltdoc="x"><span class="techinside">tainted</span></a>
+syntax object. Any syntax object in the result of <span class="RktPn">(</span><span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property%29%29" class="RktValLink" data-pltdoc="x">syntax-property</a></span><span class="stt"> </span><span class="RktVar">stx</span><span class="stt"> </span><span class="RktVar">key</span><span class="RktPn">)</span>
+is also tainted if it is in a position within the value that would be
+reached by <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span>&rsquo;s conversion. Taints cannot be removed.</p><p>A syntax object is tainted when it is included in an exception by the
+macro expander or when it is produced by a function like
+<span class="RktSym"><a href="Expanding_Top-Level_Forms.html#%28def._%28%28quote._~23~25kernel%29._expand%29%29" class="RktValLink" data-pltdoc="x">expand</a></span> using a <a href="modprotect.html#%28tech._code._inspector%29" class="techoutside" data-pltdoc="x"><span class="techinside">code inspector</span></a> that is not the original
+code inspector. The function <span class="RktSym"><a href="stxcerts.html#%28def._%28%28quote._~23~25kernel%29._syntax-taint%29%29" class="RktValLink" data-pltdoc="x">syntax-taint</a></span> also returns a
+tainted syntax object.</p><p>Previous versions of Racket included a notion of <span style="font-style: italic">arming</span> and
+<span style="font-style: italic">disarming</span> syntax to trigger taints or avoid taints. That
+indirection is no longer supported, and the operations
+<span class="RktSym"><a href="stxcerts.html#%28def._%28%28quote._~23~25kernel%29._syntax-arm%29%29" class="RktValLink" data-pltdoc="x">syntax-arm</a></span>, <span class="RktSym"><a href="stxcerts.html#%28def._%28%28quote._~23~25kernel%29._syntax-disarm%29%29" class="RktValLink" data-pltdoc="x">syntax-disarm</a></span>, <span class="RktSym"><a href="stxcerts.html#%28def._%28%28quote._~23~25kernel%29._syntax-rearm%29%29" class="RktValLink" data-pltdoc="x">syntax-rearm</a></span>, and
+<span class="RktSym"><a href="stxcerts.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-protect%29%29" class="RktValLink" data-pltdoc="x">syntax-protect</a></span> now have no effect on their arguments. Along
+similar lines, the syntax properties (see <a href="stxprops.html" data-pltdoc="x">Syntax Object Properties</a>)
+<a name="(idx._(gentag._239._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">taint-mode</span> and <a name="(idx._(gentag._240._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">certify-mode</span> were
+formerly used to control syntax arming and are no longer specifically
+recognized by the macro expander.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-tainted~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxcerts.html#%28def._%28%28quote._~23~25kernel%29._syntax-tainted~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-tainted?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">stx</span> is <a href="stxcerts.html#%28tech._tainted%29" class="techoutside" data-pltdoc="x"><span class="techinside">tainted</span></a>, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-arm))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxcerts.html#%28def._%28%28quote._~23~25kernel%29._syntax-arm%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-arm</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">inspector</span><span class="hspace">&nbsp;</span><span class="RktVar">use-mode?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">inspector</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">use-mode?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVar">stx</span>.</div></p><p class="SHistory">Changed in version 8.2.0.4 of package <span class="stt">base</span>: Changed to just return <span class="RktVar">stx</span> instead
+of returning &ldquo;armed&rdquo; syntax.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/stxcase-scheme..rkt)._syntax-protect))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxcerts.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-protect%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-protect</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVar">stx</span>.</div></p><p class="SHistory">Changed in version 8.2.0.4 of package <span class="stt">base</span>: Changed to just return <span class="RktVar">stx</span> instead
+of returning &ldquo;armed&rdquo; syntax.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-disarm))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxcerts.html#%28def._%28%28quote._~23~25kernel%29._syntax-disarm%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-disarm</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span><span class="RktVar">inspector</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">inspector</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVar">stx</span>.</div></p><p class="SHistory">Changed in version 8.2.0.4 of package <span class="stt">base</span>: Changed to just return <span class="RktVar">stx</span> instead
+of potentially &ldquo;disarming&rdquo; syntax.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-rearm))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxcerts.html#%28def._%28%28quote._~23~25kernel%29._syntax-rearm%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-rearm</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span><span class="RktVar">from-stx</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">use-mode?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">from-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">use-mode?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVar">stx</span>.</div></p><p class="SHistory">Changed in version 8.2.0.4 of package <span class="stt">base</span>: Changed to just return <span class="RktVar">stx</span> instead
+of potentially &ldquo;arming&rdquo; syntax.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-taint))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxcerts.html#%28def._%28%28quote._~23~25kernel%29._syntax-taint%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-taint</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <a href="stxcerts.html#%28tech._tainted%29" class="techoutside" data-pltdoc="x"><span class="techinside">tainted</span></a> version of <span class="RktVar">stx</span>, which is <span class="RktVar">stx</span>
+if it is already tainted.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stxprops.html" title="backward to &quot;12.7 Syntax Object Properties&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Expanding_Top-Level_Forms.html" title="forward to &quot;12.9 Expanding Top-Level Forms&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/stxcmp.html b/clones/docs.racket-lang.org/reference/stxcmp.html
new file mode 100644
index 00000000..b5961708
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/stxcmp.html
@@ -0,0 +1,97 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>12.3&nbsp;Syntax Object Bindings</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">12.1&nbsp;</td><td><a href="stx-patterns.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Syntax Matching</a></td></tr><tr><td align="right">12.2&nbsp;</td><td><a href="stxops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Content</a></td></tr><tr><td align="right">12.3&nbsp;</td><td><a href="stxcmp.html" class="tocviewselflink" data-pltdoc="x">Syntax Object Bindings</a></td></tr><tr><td align="right">12.4&nbsp;</td><td><a href="stxtrans.html" class="tocviewlink" data-pltdoc="x">Syntax Transformers</a></td></tr><tr><td align="right">12.5&nbsp;</td><td><a href="stxparam.html" class="tocviewlink" data-pltdoc="x">Syntax Parameters</a></td></tr><tr><td align="right">12.6&nbsp;</td><td><a href="splicing.html" class="tocviewlink" data-pltdoc="x">Local Binding with Splicing Body</a></td></tr><tr><td align="right">12.7&nbsp;</td><td><a href="stxprops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Properties</a></td></tr><tr><td align="right">12.8&nbsp;</td><td><a href="stxcerts.html" class="tocviewlink" data-pltdoc="x">Syntax Taints</a></td></tr><tr><td align="right">12.9&nbsp;</td><td><a href="Expanding_Top-Level_Forms.html" class="tocviewlink" data-pltdoc="x">Expanding Top-<wbr></wbr>Level Forms</a></td></tr><tr><td align="right">12.10&nbsp;</td><td><a href="Serializing_Syntax.html" class="tocviewlink" data-pltdoc="x">Serializing Syntax</a></td></tr><tr><td align="right">12.11&nbsp;</td><td><a href="include.html" class="tocviewlink" data-pltdoc="x">File Inclusion</a></td></tr><tr><td align="right">12.12&nbsp;</td><td><a href="syntax-util.html" class="tocviewlink" data-pltdoc="x">Syntax Utilities</a></td></tr><tr><td align="right">12.13&nbsp;</td><td><a href="phase_space.html" class="tocviewlink" data-pltdoc="x">Phase and Space Utilities</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._bound-identifier~3d~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bound-<wbr></wbr>identifier=?</span></span></a></td></tr><tr><td><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">free-<wbr></wbr>identifier=?</span></span></a></td></tr><tr><td><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-transformer-identifier~3d~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">free-<wbr></wbr>transformer-<wbr></wbr>identifier=?</span></span></a></td></tr><tr><td><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-template-identifier~3d~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">free-<wbr></wbr>template-<wbr></wbr>identifier=?</span></span></a></td></tr><tr><td><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-label-identifier~3d~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">free-<wbr></wbr>label-<wbr></wbr>identifier=?</span></span></a></td></tr><tr><td><a href="stxcmp.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._check-duplicate-identifier%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">check-<wbr></wbr>duplicate-<wbr></wbr>identifier</span></span></a></td></tr><tr><td><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier-<wbr></wbr>binding</span></span></a></td></tr><tr><td><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-transformer-binding%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier-<wbr></wbr>transformer-<wbr></wbr>binding</span></span></a></td></tr><tr><td><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-template-binding%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier-<wbr></wbr>template-<wbr></wbr>binding</span></span></a></td></tr><tr><td><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-label-binding%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier-<wbr></wbr>label-<wbr></wbr>binding</span></span></a></td></tr><tr><td><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-distinct-binding%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier-<wbr></wbr>distinct-<wbr></wbr>binding</span></span></a></td></tr><tr><td><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding-symbol%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier-<wbr></wbr>binding-<wbr></wbr>symbol</span></span></a></td></tr><tr><td><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding-portal-syntax%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier-<wbr></wbr>binding-<wbr></wbr>portal-<wbr></wbr>syntax</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stxops.html" title="backward to &quot;12.2 Syntax Object Content&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stxtrans.html" title="forward to &quot;12.4 Syntax Transformers&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;stxcmp&quot;">12.3<tt>&nbsp;</tt><a name="(part._stxcmp)"></a>Syntax Object Bindings</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._bound-identifier~3d~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._bound-identifier~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">bound-identifier=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a-id</span><span class="hspace">&nbsp;</span><span class="RktVar">b-id</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">phase-level</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a-id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b-id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">phase-level</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-phase-level%29%29" class="RktValLink" data-pltdoc="x">syntax-local-phase-level</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if the identifier <span class="RktVar">a-id</span> would bind
+<span class="RktVar">b-id</span> (or vice versa) if the identifiers were substituted in a
+suitable expression context at the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> indicated by
+<span class="RktVar">phase-level</span>, <span class="RktVal">#f</span> otherwise. A <span class="RktVal">#f</span> value for
+<span class="RktVar">phase-level</span> corresponds to the <a href="syntax-model.html#%28tech._label._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">label phase level</span></a>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._bound-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">bound-identifier=?</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">wrong</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">binds</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">no-binds</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">wrong</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">check</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'binds</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">check</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'no-binds</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._define-syntax-rule%29%29" class="RktStxLink" data-pltdoc="x">define-syntax-rule</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check-a</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">check-a</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'no-binds</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._free-identifier~3d~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">free-identifier=?</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">a-id</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">b-id</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">a-phase-level</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">b-phase-level</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a-id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b-id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">a-phase-level</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-phase-level%29%29" class="RktValLink" data-pltdoc="x">syntax-local-phase-level</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b-phase-level</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">a-phase-level</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">a-id</span> and <span class="RktVar">b-id</span> access the same
+<a href="syntax-model.html#%28tech._local._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">local binding</span></a>, <a href="syntax-model.html#%28tech._module._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">module binding</span></a>, or <a href="syntax-model.html#%28tech._top._level._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level
+binding</span></a>&#8212;<wbr></wbr>perhaps via <a href="syntax-model.html#%28tech._rename._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">rename transformers</span></a>&#8212;<wbr></wbr>at the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase
+levels</span></a> indicated by <span class="RktVar">a-phase-level</span> and
+<span class="RktVar">b-phase-level</span>, respectively. A <span class="RktVal">#f</span> value for
+<span class="RktVar">a-phase-level</span> or <span class="RktVar">b-phase-level</span> corresponds to the
+<a href="syntax-model.html#%28tech._label._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">label phase level</span></a>.</div></p><p>&ldquo;Same module binding&rdquo; means that the identifiers refer to the same
+original definition site, and not necessarily to the same
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> or <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> site. Due to renaming in
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> and <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span>, or due to a transformer binding
+to a <a href="syntax-model.html#%28tech._rename._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">rename transformer</span></a>, the identifiers may return distinct
+results with <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">same:</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">different:</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">check</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(same: #&lt;procedure:car&gt;)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">check</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcar%29%29" class="RktValLink" data-pltdoc="x">mcar</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(different: #&lt;procedure:mcar&gt;)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(different: #&lt;procedure:list&gt;)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._rename-in%29%29" class="RktStxLink" data-pltdoc="x">rename-in</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">kar</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">check</span><span class="hspace">&nbsp;</span><span class="RktSym">kar</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(same: #&lt;procedure:car&gt;)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._free-transformer-identifier~3d~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-transformer-identifier~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">free-transformer-identifier=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a-id</span><span class="hspace">&nbsp;</span><span class="RktVar">b-id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a-id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b-id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Same as <span class="RktPn">(</span><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span><span class="stt"> </span><span class="RktVar">a-id</span><span class="stt"> </span><span class="RktVar">b-id</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-phase-level%29%29" class="RktValLink" data-pltdoc="x">syntax-local-phase-level</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._free-template-identifier~3d~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-template-identifier~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">free-template-identifier=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a-id</span><span class="hspace">&nbsp;</span><span class="RktVar">b-id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a-id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b-id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Same as <span class="RktPn">(</span><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span><span class="stt"> </span><span class="RktVar">a-id</span><span class="stt"> </span><span class="RktVar">b-id</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-phase-level%29%29" class="RktValLink" data-pltdoc="x">syntax-local-phase-level</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._free-label-identifier~3d~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-label-identifier~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">free-label-identifier=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a-id</span><span class="hspace">&nbsp;</span><span class="RktVar">b-id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a-id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b-id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Same as <span class="RktPn">(</span><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span><span class="stt"> </span><span class="RktVar">a-id</span><span class="stt"> </span><span class="RktVar">b-id</span><span class="stt"> </span><span class="RktVal">#f</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/stxcase-scheme..rkt)._check-duplicate-identifier))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxcmp.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._check-duplicate-identifier%29%29" class="RktValDef RktValLink" data-pltdoc="x">check-duplicate-identifier</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">ids</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ids</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Compares each identifier in <span class="RktVar">ids</span> with every other identifier
+in the list with <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._bound-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">bound-identifier=?</a></span>. If any comparison
+returns <span class="RktVal">#t</span>, one of the duplicate identifiers is returned (the
+first one in <span class="RktVar">ids</span> that is a duplicate), otherwise the result
+is <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._identifier-binding))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="RktValDef RktValLink" data-pltdoc="x">identifier-binding</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">id-stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">phase-level</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">top-level-symbol?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">lexical</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-shift~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space-shift?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">phase-level</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-phase-level%29%29" class="RktValLink" data-pltdoc="x">syntax-local-phase-level</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">top-level-symbol?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns one of three (if <span class="RktVar">top-level-symbol?</span> is <span class="RktVal">#f</span>)
+or four (if <span class="RktVar">top-level-symbol?</span> is true) kinds of values, depending on the binding of
+<span class="RktVar">id-stx</span> at the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> indicated by
+<span class="RktVar">phase-level</span> (where a <span class="RktVal">#f</span> value for
+<span class="RktVar">phase-level</span> corresponds to the <a href="syntax-model.html#%28tech._label._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">label phase level</span></a>):</div></p><ul><li><p>The result is <a name="(idx._(gentag._231._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">lexical</span> if <span class="RktVar">id-stx</span>
+has a <a href="syntax-model.html#%28tech._local._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">local binding</span></a>.</p></li><li><p>The result is a list of seven items when <span class="RktVar">id-stx</span>
+has a <a href="syntax-model.html#%28tech._module._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">module binding</span></a>: <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVar">from-mod</span><span class="stt"> </span><span class="RktVar">from-sym</span><span class="stt"> </span><span class="RktVar">nominal-from-mod</span><span class="stt"> </span><span class="RktVar">nominal-from-sym</span><span class="stt"> </span><span class="RktVar">from-phase</span><span class="stt"> </span><span class="RktVar">import-phase+space-shift</span><span class="stt"> </span><span class="RktVar">nominal-export-phase</span><span class="RktPn">)</span>.</p><ul><li><p><span class="RktVar">from-mod</span> is a module path index (see
+<a href="Module_Names_and_Loading.html#%28part._modpathidx%29" data-pltdoc="x">Compiled Modules and References</a>) that indicates the defining module. It
+is the &ldquo;self&rdquo; module path index if the binding refers to a
+definition in the enclosing module of <span class="RktVar">id-stx</span>.</p></li><li><p><span class="RktVar">from-sym</span> is a symbol for the identifier&rsquo;s name
+at its definition site in the originating module. This can be
+different from the local name returned by
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span> for several reasons: the identifier is
+renamed on import, it is renamed on export, or it is
+implicitly renamed because the binding site was generated by a
+macro invocation. In that last case, it may be an
+<a href="symbols.html#%28tech._unreadable._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">unreadable symbol</span></a>, and it may be different from the
+result of <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span> on the identifier in the
+original source definition.</p></li><li><p><span class="RktVar">nominal-from-mod</span> is a module path index (see
+<a href="Module_Names_and_Loading.html#%28part._modpathidx%29" data-pltdoc="x">Compiled Modules and References</a>) that indicates the binding&rsquo;s module as
+it appears locally in the source around <span class="RktVar">id-stx</span>: it
+indicates a module <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>d into the context of
+<span class="RktVar">id-stx</span> to provide its binding, or it is the same
+&ldquo;self&rdquo; as <span class="RktVar">from-mod</span> for a binding that refers to a
+definition in the enclosing module of <span class="RktVar">id-stx</span>. It can
+be different from <span class="RktVar">from-mod</span> due to a re-export in
+<span class="RktVar">nominal-from-mod</span> of some imported identifier. If the
+same binding is imported in multiple ways, an arbitrary
+representative is chosen.</p></li><li><p><span class="RktVar">nominal-from-sym</span> is a symbol for the binding&rsquo;s
+identifier as it appears locally in the source around
+<span class="RktVar">id-stx</span>: it is the identifier&rsquo;s name as exported by
+<span class="RktVar">nominal-from-mod</span>, or it is the source identifier&rsquo;s
+symbol for a definition within the enclosing module of
+<span class="RktVar">id-stx</span>. It can be different from <span class="RktVar">from-sym</span>
+due to a renaming <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span>, even if <span class="RktVar">from-mod</span>
+and <span class="RktVar">nominal-from-mod</span> are the same, or due to a
+definition that was introduced by a macro expansion.</p></li><li><p><span class="RktVar">from-phase</span> is an exact non-negative integer
+representing the originating phase. For example, it is
+<span class="RktVal">1</span> if the definition is for-syntax.</p></li><li><p><span class="RktVar">import-phase+space-shift</span> is <span class="RktVal">0</span> if the binding
+import of <span class="RktVar">nominal-from-mode</span> is from a definition
+or a plain <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>, <span class="RktVal">1</span> if it is from a
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span> import, a phase combined with a space name if it
+is from a <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-space%29%29" class="RktStxLink" data-pltdoc="x">for-space</a></span> import, etc.</p></li><li><p><span class="RktVar">nominal-export-phase+space</span> is the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>
+and <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a>
+of the export from <span class="RktVar">nominal-from-mod</span> for an
+imported binding, or it is the phase level of the definition for a
+binding from the enclosing module of <span class="RktVar">id-stx</span>.</p></li></ul></li><li><p>The result is <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVar">top-sym</span><span class="RktPn">)</span> if <span class="RktVar">id-stx</span>
+has a <a href="syntax-model.html#%28tech._top._level._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level binding</span></a> and
+<span class="RktVar">top-level-symbol?</span> is true. The <span class="RktVar">top-sym</span>
+can different from the name returned by
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span> when the binding definition was
+generated by a macro invocation.</p></li><li><p>The result is <span class="RktVal">#f</span> if <span class="RktVar">id-stx</span> has a
+<a href="syntax-model.html#%28tech._top._level._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level binding</span></a> and <span class="RktVar">top-level-symbol?</span> is
+<span class="RktVal">#f</span> or if <span class="RktVar">id-stx</span> is <a href="syntax-model.html#%28tech._unbound%29" class="techoutside" data-pltdoc="x"><span class="techinside">unbound</span></a>. An
+unbound identifier is typically treated the same as an
+identifier whose top-level binding is a variable.</p></li></ul><p>If <span class="RktVar">id-stx</span> is bound to a <a href="syntax-model.html#%28tech._rename._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">rename-transformer</span></a>, the result
+from <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="RktValLink" data-pltdoc="x">identifier-binding</a></span> is for the identifier in the
+transformer, so that <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="RktValLink" data-pltdoc="x">identifier-binding</a></span> is consistent with
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span>.</p><p class="SHistory">Changed in version 6.6.0.4 of package <span class="stt">base</span>: Added the <span class="RktVar">top-level-symbol?</span> argument to report
+information on top-level bindings.<br/>Changed in version 8.2.0.3: Generalized phase results to phase&ndash;space combinations.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._identifier-transformer-binding))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-transformer-binding%29%29" class="RktValDef RktValLink" data-pltdoc="x">identifier-transformer-binding</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">id-stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">rt-phase-level</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">lexical</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-shift~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space-shift?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">rt-phase-level</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-phase-level%29%29" class="RktValLink" data-pltdoc="x">syntax-local-phase-level</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Same as <span class="RktPn">(</span><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="RktValLink" data-pltdoc="x">identifier-binding</a></span><span class="stt"> </span><span class="RktVar">id-stx</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="stt"> </span><span class="RktVar">rt-phase-level</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="stt"> </span><span class="RktVar">rt-phase-level</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p class="SHistory">Changed in version 8.2.0.3 of package <span class="stt">base</span>: Generalized phase results to phase&ndash;space combinations.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._identifier-template-binding))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-template-binding%29%29" class="RktValDef RktValLink" data-pltdoc="x">identifier-template-binding</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id-stx</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">lexical</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-shift~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space-shift?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Same as <span class="RktPn">(</span><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="RktValLink" data-pltdoc="x">identifier-binding</a></span><span class="stt"> </span><span class="RktVar">id-stx</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-phase-level%29%29" class="RktValLink" data-pltdoc="x">syntax-local-phase-level</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p class="SHistory">Changed in version 8.2.0.3 of package <span class="stt">base</span>: Generalized phase results to phase&ndash;space combinations.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._identifier-label-binding))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-label-binding%29%29" class="RktValDef RktValLink" data-pltdoc="x">identifier-label-binding</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id-stx</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">lexical</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-shift~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space-shift?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Same as <span class="RktPn">(</span><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="RktValLink" data-pltdoc="x">identifier-binding</a></span><span class="stt"> </span><span class="RktVar">id-stx</span><span class="stt"> </span><span class="RktVal">#f</span><span class="RktPn">)</span>.</div></p><p class="SHistory">Changed in version 8.2.0.3 of package <span class="stt">base</span>: Generalized phase results to phase&ndash;space combinations.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._identifier-distinct-binding))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-distinct-binding%29%29" class="RktValDef RktValLink" data-pltdoc="x">identifier-distinct-binding</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">id-stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">wrt-id-stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">phase-level</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">lexical</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-shift~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space-shift?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">wrt-id-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">phase-level</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-phase-level%29%29" class="RktValLink" data-pltdoc="x">syntax-local-phase-level</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktPn">(</span><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="RktValLink" data-pltdoc="x">identifier-binding</a></span><span class="stt"> </span><span class="RktVar">id-stx</span><span class="stt"> </span><span class="RktVar">phase-level</span><span class="RktPn">)</span>, but the result
+is <span class="RktVal">#f</span> if the binding for <span class="RktVar">id-stx</span> has scopes that are
+a subset of the scopes for <span class="RktVar">wrt-id-stx</span>. That is, if
+<span class="RktVar">id-stx</span> and <span class="RktVar">wrt-id-stx</span> have the same symbolic name, a
+binding for <span class="RktVar">id-stx</span> is returned only if the binding does not
+also apply to <span class="RktVar">wrt-id-stx</span>.</div></p><p class="SHistory">Added in version 8.3.0.8 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._identifier-binding-symbol))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding-symbol%29%29" class="RktValDef RktValLink" data-pltdoc="x">identifier-binding-symbol</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">id-stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">phase-level</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">phase-level</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-phase-level%29%29" class="RktValLink" data-pltdoc="x">syntax-local-phase-level</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="RktValLink" data-pltdoc="x">identifier-binding</a></span>, but produces a symbol that
+corresponds to the binding. The symbol result is the same for any
+identifiers that are <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span>, but the result may
+also be the same for identifiers that are not
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span> (i.e., different symbols imply different
+bindings, but the same symbol does not imply the same binding).</div></p><p>When <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="RktValLink" data-pltdoc="x">identifier-binding</a></span> would produce a list, then the second
+element of that list is the result that
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding-symbol%29%29" class="RktValLink" data-pltdoc="x">identifier-binding-symbol</a></span> produces.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._identifier-binding-portal-syntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding-portal-syntax%29%29" class="RktValDef RktValLink" data-pltdoc="x">identifier-binding-portal-syntax</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">id-stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">phase-level</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">phase-level</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-phase-level%29%29" class="RktValLink" data-pltdoc="x">syntax-local-phase-level</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">If <span class="RktVar">id-stx</span> is bound at <span class="RktVar">phase-level</span> to <a href="stxtrans.html#%28tech._portal._syntax%29" class="techoutside" data-pltdoc="x"><span class="techinside">portal
+syntax</span></a>, either via <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span> or <span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25require%29%29" class="RktStxLink" data-pltdoc="x">#%require</a></span>, then
+the portal syntax content is returned. The module that binds
+<span class="RktVar">id-stx</span> must be declared, but it need not be instantiated at
+the relevant phase, and <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding-portal-syntax%29%29" class="RktValLink" data-pltdoc="x">identifier-binding-portal-syntax</a></span> does
+not instantiate the module.</div></p><p class="SHistory">Added in version 8.3.0.8 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stxops.html" title="backward to &quot;12.2 Syntax Object Content&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stxtrans.html" title="forward to &quot;12.4 Syntax Transformers&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/stxops.html b/clones/docs.racket-lang.org/reference/stxops.html
new file mode 100644
index 00000000..c563a5cc
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/stxops.html
@@ -0,0 +1,171 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>12.2&nbsp;Syntax Object Content</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">12.1&nbsp;</td><td><a href="stx-patterns.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Syntax Matching</a></td></tr><tr><td align="right">12.2&nbsp;</td><td><a href="stxops.html" class="tocviewselflink" data-pltdoc="x">Syntax Object Content</a></td></tr><tr><td align="right">12.3&nbsp;</td><td><a href="stxcmp.html" class="tocviewlink" data-pltdoc="x">Syntax Object Bindings</a></td></tr><tr><td align="right">12.4&nbsp;</td><td><a href="stxtrans.html" class="tocviewlink" data-pltdoc="x">Syntax Transformers</a></td></tr><tr><td align="right">12.5&nbsp;</td><td><a href="stxparam.html" class="tocviewlink" data-pltdoc="x">Syntax Parameters</a></td></tr><tr><td align="right">12.6&nbsp;</td><td><a href="splicing.html" class="tocviewlink" data-pltdoc="x">Local Binding with Splicing Body</a></td></tr><tr><td align="right">12.7&nbsp;</td><td><a href="stxprops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Properties</a></td></tr><tr><td align="right">12.8&nbsp;</td><td><a href="stxcerts.html" class="tocviewlink" data-pltdoc="x">Syntax Taints</a></td></tr><tr><td align="right">12.9&nbsp;</td><td><a href="Expanding_Top-Level_Forms.html" class="tocviewlink" data-pltdoc="x">Expanding Top-<wbr></wbr>Level Forms</a></td></tr><tr><td align="right">12.10&nbsp;</td><td><a href="Serializing_Syntax.html" class="tocviewlink" data-pltdoc="x">Serializing Syntax</a></td></tr><tr><td align="right">12.11&nbsp;</td><td><a href="include.html" class="tocviewlink" data-pltdoc="x">File Inclusion</a></td></tr><tr><td align="right">12.12&nbsp;</td><td><a href="syntax-util.html" class="tocviewlink" data-pltdoc="x">Syntax Utilities</a></td></tr><tr><td align="right">12.13&nbsp;</td><td><a href="phase_space.html" class="tocviewlink" data-pltdoc="x">Phase and Space Utilities</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>12.2&nbsp;</td><td><a href="stxops.html" class="tocviewselflink" data-pltdoc="x">Syntax Object Content</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">12.2.1&nbsp;</td><td><a href="stxops.html#%28part._.Syntax_.Object_.Source_.Locations%29" class="tocviewlink" data-pltdoc="x">Syntax Object Source Locations</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax?</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier?</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-source%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>source</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-line%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>line</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-column%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>column</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-position%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>position</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-span%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>span</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-original~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>original?</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-source-module%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>source-<wbr></wbr>module</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>e</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3elist%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>&gt;list</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>&gt;datum</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">datum-<wbr></wbr>&gt;syntax</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-binding-set~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>binding-<wbr></wbr>set?</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-binding-set%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>binding-<wbr></wbr>set</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-binding-set-~3esyntax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>binding-<wbr></wbr>set-<wbr></wbr>&gt;syntax</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._syntax-binding-set-extend%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>binding-<wbr></wbr>set-<wbr></wbr>extend</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-intern-literal%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">datum-<wbr></wbr>intern-<wbr></wbr>literal</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-shift-phase-level%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>shift-<wbr></wbr>phase-<wbr></wbr>level</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._generate-temporaries%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">generate-<wbr></wbr>temporaries</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._identifier-prune-lexical-context%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier-<wbr></wbr>prune-<wbr></wbr>lexical-<wbr></wbr>context</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._identifier-prune-to-source-module%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier-<wbr></wbr>prune-<wbr></wbr>to-<wbr></wbr>source-<wbr></wbr>module</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._syntax-recertify%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>recertify</span></span></a></td></tr><tr><td><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-debug-info%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>debug-<wbr></wbr>info</span></span></a></td></tr><tr><td><span class="tocsublinknumber">12.2.1<tt>&nbsp;</tt></span><a href="stxops.html#%28part._.Syntax_.Object_.Source_.Locations%29" class="tocsubseclink" data-pltdoc="x">Syntax Object Source Locations</a></td></tr><tr><td><a href="stxops.html#%28def._%28%28lib._racket%2Fsyntax-srcloc..rkt%29._syntax-srcloc%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>srcloc</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stx-patterns.html" title="backward to &quot;12.1 Pattern-Based Syntax Matching&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stxcmp.html" title="forward to &quot;12.3 Syntax Object Bindings&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;stxops&quot;">12.2<tt>&nbsp;</tt><a name="(part._stxops)"></a>Syntax Object Content</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>, <span class="RktVal">#f</span>
+otherwise. See also <a href="syntax-model.html#%28part._stxobj-model%29" data-pltdoc="x">Syntax Objects</a>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">quinoa</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">spelt</span><span class="hspace">&nbsp;</span><span class="RktSym">triticale</span><span class="hspace">&nbsp;</span><span class="RktSym">buckwheat</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">millet</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"barley"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/stx..rkt)._identifier~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">identifier?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> and
+<span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span><span class="stt"> </span><span class="RktSym">stx</span><span class="RktPn">)</span> produces a symbol.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">linguine</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktSym">wheat?</span><span class="hspace">&nbsp;</span><span class="RktSym">udon</span><span class="hspace">&nbsp;</span><span class="RktSym">soba</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">ramen</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">15</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-source))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-source%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-source</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the source component of the <a href="exns.html#%28tech._source._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">source location</span></a>
+for the <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> <span class="RktVar">stx</span>, or <span class="RktVal">#f</span>
+if none is known. The source is represented by an arbitrary value
+(e.g., one passed to <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>), but it is typically a file
+path string.</div></p><p>See also <span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fsyntax-srcloc..rkt%29._syntax-srcloc%29%29" class="RktValLink" data-pltdoc="x">syntax-srcloc</a></span> from <a href="stxops.html#%28mod-path._racket%2Fsyntax-srcloc%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/syntax-srcloc</span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-line))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-line%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-line</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the line number (positive exact integer)
+of the <a href="exns.html#%28tech._source._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">source location</span></a> for the start of the
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> in its source, or <span class="RktVal">#f</span> if the line number or
+source is unknown. See also <a href="linecol.html" data-pltdoc="x">Counting Positions, Lines, and Columns</a>.</div></p><p class="SHistory">Changed in version 7.0 of package <span class="stt">base</span>: Dropped a guarantee that <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-line%29%29" class="RktValLink" data-pltdoc="x">syntax-line</a></span>
+and <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-column%29%29" class="RktValLink" data-pltdoc="x">syntax-column</a></span> both produce
+<span class="RktVal">#f</span> or both produce integers.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-column))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-column%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-column</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the column number (non-negative exact integer)
+of the <a href="exns.html#%28tech._source._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">source location</span></a> for the start
+of the <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> in its source, or <span class="RktVal">#f</span> if the source
+column is unknown. See also <a href="linecol.html" data-pltdoc="x">Counting Positions, Lines, and Columns</a>.</div></p><p class="SHistory">Changed in version 7.0 of package <span class="stt">base</span>: Dropped a guarantee that <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-line%29%29" class="RktValLink" data-pltdoc="x">syntax-line</a></span>
+and <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-column%29%29" class="RktValLink" data-pltdoc="x">syntax-column</a></span> both produce
+<span class="RktVal">#f</span> or both produce integers.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-position))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-position%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-position</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the character position (positive exact integer)
+of the <a href="exns.html#%28tech._source._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">source location</span></a> for the start
+of the <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> in its source, or <span class="RktVal">#f</span> if the source
+position is unknown. See also <a href="linecol.html" data-pltdoc="x">Counting Positions, Lines, and Columns</a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-span))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-span%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-span</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the span (non-negative exact integer) in characters
+of the <a href="exns.html#%28tech._source._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">source location</span></a> for
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> in its source, or <span class="RktVal">#f</span> if the span is
+unknown.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-original~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-original~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-original?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">stx</span> has the property that
+<span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> attaches to the
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>s that they generate (see <a href="stxprops.html" data-pltdoc="x">Syntax Object Properties</a>), and if
+<span class="RktVar">stx</span>&rsquo;s <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> does not include any macro-introduction scopes (which indicate that the
+object was introduced by a syntax transformer; see
+<a href="syntax-model.html#%28part._stxobj-model%29" data-pltdoc="x">Syntax Objects</a>). The result is <span class="RktVal">#f</span> otherwise.</div></p><p>This predicate can be used to distinguish <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>s in an expanded
+expression that were directly present in the original expression, as
+opposed to <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>s inserted by macros.</p><p>The (hidden) property to represent original syntax is dropped for a
+syntax object that is marshaled as part of compiled code; see also
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile%29%29" class="RktValLink" data-pltdoc="x">current-compile</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-source-module))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-source-module%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-source-module</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">source?</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._resolved-module-path~3f%29%29" class="RktValLink" data-pltdoc="x">resolved-module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">source?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an indication of the module whose source contains
+<span class="RktVar">stx</span>, or <span class="RktVal">#f</span> if no source module for <span class="RktVar">stx</span>
+can be inferred from its lexical context.  If
+<span class="RktVar">source?</span> is <span class="RktVal">#f</span>, then result is a module path index or
+symbol (see <a href="Module_Names_and_Loading.html#%28part._modpathidx%29" data-pltdoc="x">Compiled Modules and References</a>) or a <a href="Module_Names_and_Loading.html#%28tech._resolved._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">resolved module path</span></a>; if <span class="RktVar">source?</span> is true, the
+result is a path or symbol corresponding to the loaded module&rsquo;s
+source in the sense of <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._current-module-declare-source%29%29" class="RktValLink" data-pltdoc="x">current-module-declare-source</a></span>.</div></p><p>Note that <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-source-module%29%29" class="RktValLink" data-pltdoc="x">syntax-source-module</a></span> does <span class="emph">not</span> consult the
+source location of <span class="RktVar">stx</span>. The result is based on the
+<a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> of <span class="RktVar">stx</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-e))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-e</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Unwraps the immediate datum structure from a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>,
+leaving nested syntax structure (if any) in place.  The result of
+<span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span><span class="stt"> </span><span class="RktVar">stx</span><span class="RktPn">)</span> is one of the following:</div></p><ul><li><p>a symbol</p></li><li><p>a <a href="stxops.html#%28tech._syntax._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax pair</span></a> (described below)</p></li><li><p>the empty list</p></li><li><p>an immutable vector containing <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>s</p></li><li><p>an immutable box containing <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>s</p></li><li><p>an immutable <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash table</span></a> containing <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax
+object</span></a> values (but not necessarily <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> keys)</p></li><li><p>an immutable <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure containing <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>s</p></li><li><p>some other kind of datum&#8212;<wbr></wbr>usually a number, boolean, or
+string&#8212;<wbr></wbr>that is <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> when
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-intern-literal%29%29" class="RktValLink" data-pltdoc="x">datum-intern-literal</a></span> would convert the
+value</p></li></ul><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'a</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#&lt;syntax:eval:11:0 x&gt; . #&lt;syntax:eval:11:0 y&gt;)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">+</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#(#&lt;syntax:eval:12:0 1&gt; #&lt;syntax:eval:12:0 2&gt; #&lt;syntax:eval:12:0 (+ 3 4)&gt;)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">#&amp;</span><span class="RktVal">"hello world"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#&amp;#&lt;syntax:eval:13:0 "hello world"&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">imperial</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"yellow"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">festival</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"green"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">'#hash((festival . #&lt;syntax:eval:14:0 "green"&gt;)</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;</span><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">(imperial . #&lt;syntax:eval:14:0 "yellow"&gt;))</span></p></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">point</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#(#&lt;syntax:eval:15:0 point&gt; #&lt;syntax:eval:15:0 3&gt; #&lt;syntax:eval:15:0 4&gt;)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">"three"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"three"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p>A <a name="(tech._syntax._pair)"></a><span style="font-style: italic">syntax pair</span> is a pair containing a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> as its
+first element, and either the empty list, a syntax pair, or a syntax
+object as its second element.</p><p>A <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> that is the result of <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> reflects
+the use of delimited <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> in the input by creating a syntax
+object for every pair of parentheses in the source, and by creating a
+pair-valued <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> <span style="font-style: italic">only</span> for parentheses in the
+source. See <a href="reader.html#%28part._parse-pair%29" data-pltdoc="x">Reading Pairs and Lists</a> for more information.</p><p>If <span class="RktVar">stx</span> is <a href="stxcerts.html#%28tech._tainted%29" class="techoutside" data-pltdoc="x"><span class="techinside">tainted</span></a>, then any syntax object in the
+result of <span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span><span class="stt"> </span><span class="RktVar">stx</span><span class="RktPn">)</span> is <a href="stxcerts.html#%28tech._tainted%29" class="techoutside" data-pltdoc="x"><span class="techinside">tainted</span></a>. The results from
+multiple calls to <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span> of <span class="RktVar">stx</span> are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-~3elist))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3elist%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-&gt;list</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>s or <span class="RktVal">#f</span>. The result is a list
+of <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>s when <span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span><span class="stt"> </span><span class="RktVar">stx</span><span class="RktPn">)</span> would produce a
+list. In other words, <a href="stxops.html#%28tech._syntax._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax pairs</span></a> in <span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span><span class="stt"> </span><span class="RktVar">stx</span><span class="RktPn">)</span>
+are flattened.</div></p><p>If <span class="RktVar">stx</span> is <a href="stxcerts.html#%28tech._tainted%29" class="techoutside" data-pltdoc="x"><span class="techinside">tainted</span></a>, then any syntax
+object in the result of <span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3elist%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;list</a></span><span class="stt"> </span><span class="RktVar">stx</span><span class="RktPn">)</span> is <a href="stxcerts.html#%28tech._tainted%29" class="techoutside" data-pltdoc="x"><span class="techinside">tainted</span></a>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3elist%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3elist%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">'(#&lt;syntax:eval:20:0 1&gt;</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">#&lt;syntax:eval:20:0 (+ 3 4)&gt;</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">#&lt;syntax:eval:20:0 5&gt;</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">#&lt;syntax:eval:20:0 6&gt;)</span></p></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3elist%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-~3edatum))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a datum by stripping the lexical information, source-location
+information, properties, and tamper status from <span class="RktVar">stx</span>. Inside of
+pairs, (immutable) vectors, (immutable) boxes, immutable <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash
+table</span></a> values (not keys), and immutable <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structures,
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>s are recursively stripped.</div></p><p>The stripping operation does not mutate <span class="RktVar">stx</span>; it creates new
+pairs, vectors, boxes, hash tables, and <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structures as
+needed to strip lexical and source-location information recursively.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'a</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(x . y)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">+</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#(1 2 (+ 3 4))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">#&amp;</span><span class="RktVal">"hello world"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#&amp;"hello world"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">imperial</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"yellow"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">festival</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"green"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#hash((festival . "green") (imperial . "yellow"))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">point</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#(point 3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">"three"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"three"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._datum-~3esyntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValDef RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">ctxt</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">srcloc</span><span class="hspace">&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span><span class="RktVar">ignored</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ctxt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">srcloc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._srcloc~3f%29%29" class="RktValLink" data-pltdoc="x">srcloc?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._list%2Fc%29%29" class="RktValLink" data-pltdoc="x">list/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fvector..rkt%29._vector%2Fc%29%29" class="RktValLink" data-pltdoc="x">vector/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ignored</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Converts the <a href="reader.html#%28tech._datum%29" class="techoutside" data-pltdoc="x"><span class="techinside">datum</span></a> <span class="RktVar">v</span> to a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>.
+If <span class="RktVar">v</span> is already a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>, then there is no conversion,
+and <span class="RktVar">v</span> is returned unmodified.
+The contents of pairs, vectors, and boxes, the fields of <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a>
+structures, and the values of immutable hash tables are recursively converted.
+The keys of <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structures and the keys of immutable hash tables are
+not converted. Mutable vectors and boxes are replaced by immutable vectors and
+boxes. For any kind of value other than a
+pair, vector, box, immutable <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash table</span></a>, immutable
+<a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure, or <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>, conversion means
+wrapping the value with lexical information, source-location
+information, and properties after the value is <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a>
+via <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-intern-literal%29%29" class="RktValLink" data-pltdoc="x">datum-intern-literal</a></span>.</div></p><p>Converted objects in <span class="RktVar">v</span> are given the lexical context
+information of <span class="RktVar">ctxt</span> and the source-location information of
+<span class="RktVar">srcloc</span>. The resulting immediate <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> from conversion is given the
+properties (see <a href="stxprops.html" data-pltdoc="x">Syntax Object Properties</a>) of <span class="RktVar">prop</span> (even the
+hidden ones that would not be visible via <span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property-symbol-keys%29%29" class="RktValLink" data-pltdoc="x">syntax-property-symbol-keys</a></span>); if <span class="RktVar">v</span>
+is a pair, vector, box, immutable <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash table</span></a>, or immutable
+<a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure, recursively converted values are not given
+properties. If <span class="RktVar">ctxt</span> is <a href="stxcerts.html#%28tech._tainted%29" class="techoutside" data-pltdoc="x"><span class="techinside">tainted</span></a>, then the resulting syntax object from
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span> is <a href="stxcerts.html#%28tech._tainted%29" class="techoutside" data-pltdoc="x"><span class="techinside">tainted</span></a>. The <a href="modprotect.html#%28tech._code._inspector%29" class="techoutside" data-pltdoc="x"><span class="techinside">code inspector</span></a>
+of <span class="RktVar">ctxt</span>, if any, is compared to the code inspector of the
+module for the macro currently being transformed, if any; if both
+inspectors are available and if one is the same as or inferior to the
+other, then the result syntax has the same/inferior inspector,
+otherwise it has no code inspector.</p><p>Any of <span class="RktVar">ctxt</span>, <span class="RktVar">srcloc</span>, or <span class="RktVar">prop</span> can be
+<span class="RktVal">#f</span>, in which case the resulting syntax has no lexical
+context, source information, and/or new properties.</p><p>If <span class="RktVar">srcloc</span> is not <span class="RktVal">#f</span>, a <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span> instance, or a
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>, it must be a list or vector of five elements
+that correspond to <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span> fields.</p><p>Graph structure is not preserved by the conversion of <span class="RktVar">v</span> to a
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>. Instead, <span class="RktVar">v</span> is essentially unfolded into
+a tree. If <span class="RktVar">v</span> has a cycle through pairs, vectors, boxes,
+immutable <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash tables</span></a>, and immutable <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structures,
+then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>The <span class="RktVar">ignored</span> argument is allowed for backward compatibility
+and has no effect on the returned syntax object.</p><p class="SHistory">Changed in version 8.2.0.5 of package <span class="stt">base</span>: Allow a <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span> value as a
+<span class="RktVar">srcloc</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-binding-set~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-binding-set~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-binding-set?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-binding-set))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-binding-set%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-binding-set</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-binding-set~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-binding-set?</a></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-binding-set-~3esyntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-binding-set-~3esyntax%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-binding-set-&gt;syntax</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">binding-set</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">datum</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">binding-set</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-binding-set~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-binding-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">datum</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top" colspan="3"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._syntax-binding-set-extend))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._syntax-binding-set-extend%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-binding-set-extend</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">binding-set</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">symbol</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">phase</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">mpi</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:source-symbol</span><span class="hspace">&nbsp;</span><span class="RktVar">source-symbol</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:source-phase</span><span class="hspace">&nbsp;</span><span class="RktVar">source-phase</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:nominal-module</span><span class="hspace">&nbsp;</span><span class="RktVar">nominal-mpi</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:nominal-phase</span><span class="hspace">&nbsp;</span><span class="RktVar">nominal-phase</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:nominal-symbol</span><span class="hspace">&nbsp;</span><span class="RktVar">nominal-symbol</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:nominal-require-phase</span><span class="hspace">&nbsp;</span><span class="RktVar">nominal-require-phase</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:inspector</span><span class="hspace">&nbsp;</span><span class="RktVar">inspector</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-binding-set~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-binding-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">binding-set</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-binding-set~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-binding-set?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">symbol</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">phase</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mpi</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">source-symbol</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">symbol</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">source-phase</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">phase</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">nominal-mpi</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">mpi</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">nominal-phase</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">source-phase</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">nominal-symbol</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVar">source-symbol</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">nominal-require-phase</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">inspector</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <a name="(tech._syntax._binding._set)"></a><span style="font-style: italic">syntax binding set</span> supports explicit construction of
+binding information for a syntax object. Start by creating an empty
+binding set with <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-binding-set%29%29" class="RktValLink" data-pltdoc="x">syntax-binding-set</a></span>, add bindings with
+<span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._syntax-binding-set-extend%29%29" class="RktValLink" data-pltdoc="x">syntax-binding-set-extend</a></span>, and create a syntax object that has the
+bindings as its <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> using
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-binding-set-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">syntax-binding-set-&gt;syntax</a></span>.</div></p><p>The first three arguments to <span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._syntax-binding-set-extend%29%29" class="RktValLink" data-pltdoc="x">syntax-binding-set-extend</a></span>
+establish a binding of <span class="RktVar">symbol</span> at <span class="RktVar">phase</span> to an
+identifier that is defined in the module referenced by <span class="RktVar">mpi</span>.
+Supply <span class="RktVar">source-symbol</span> to make the binding of <span class="RktVar">symbol</span>
+refer to a different provided variable from <span class="RktVar">mpi</span>, and so on;
+the optional arguments correspond to the results of
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="RktValLink" data-pltdoc="x">identifier-binding</a></span>.</p><p class="SHistory">Added in version 7.0.0.12 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._datum-intern-literal))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-intern-literal%29%29" class="RktValDef RktValLink" data-pltdoc="x">datum-intern-literal</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Converts some values to be consistent with an <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> result
+produced by the default reader in <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode.</div></p><p>If <span class="RktVar">v</span> is a <a href="numbers.html#%28tech._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">number</span></a>, <a href="characters.html#%28tech._character%29" class="techoutside" data-pltdoc="x"><span class="techinside">character</span></a>, <a href="strings.html#%28tech._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">string</span></a>,
+<a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte string</span></a>, or <a href="regexp.html#%28tech._regular._expression%29" class="techoutside" data-pltdoc="x"><span class="techinside">regular expression</span></a>, then the result is a
+value that is <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to <span class="RktVar">v</span> and <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to a
+potential result of the default reader. (Note that mutable strings and
+byte strings are <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> as immutable strings and byte
+strings.)</p><p>If <span class="RktVar">v</span> is an <a href="symbols.html#%28tech._uninterned%29" class="techoutside" data-pltdoc="x"><span class="techinside">uninterned</span></a> or an <a href="symbols.html#%28tech._unreadable._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">unreadable symbol</span></a>,
+the result is still <span class="RktVar">v</span>, since an <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> symbol would
+not be <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to <span class="RktVar">v</span>.</p><p>The conversion process does not traverse compound values. For example,
+if <span class="RktVar">v</span> is a <a href="pairs.html#%28tech._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">pair</span></a> containing strings, then the strings
+within <span class="RktVar">v</span> are not <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a>.</p><p>If <span class="RktVar">v1</span> and <span class="RktVar">v2</span> are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> but not
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>, then it is possible that <span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-intern-literal%29%29" class="RktValLink" data-pltdoc="x">datum-intern-literal</a></span><span class="stt"> </span><span class="RktVar">v1</span><span class="RktPn">)</span> will return <span class="RktVar">v1</span> and&#8212;<wbr></wbr>sometime after <span class="RktVar">v1</span>
+becomes unreachable as determined by the garbage collector (see
+<a href="eval-model.html#%28part._gc-model%29" data-pltdoc="x">Garbage Collection</a>)&#8212;<wbr></wbr><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-intern-literal%29%29" class="RktValLink" data-pltdoc="x">datum-intern-literal</a></span><span class="stt"> </span><span class="RktVar">v2</span><span class="RktPn">)</span> can still
+return <span class="RktVar">v2</span>. In other words, <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-intern-literal%29%29" class="RktValLink" data-pltdoc="x">datum-intern-literal</a></span>
+may adopt a given value as an <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> representative, but
+if a former representative becomes otherwise unreachable, then
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-intern-literal%29%29" class="RktValLink" data-pltdoc="x">datum-intern-literal</a></span> may adopt a new representative.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-shift-phase-level))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-shift-phase-level%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-shift-phase-level</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span><span class="RktVar">shift</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">shift</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a syntax object that is like <span class="RktVar">stx</span>, but with all of its
+top-level and module bindings shifted by <span class="RktVar">shift</span> <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase
+levels</span></a>. If <span class="RktVar">shift</span> is <span class="RktVal">#f</span>, then only bindings
+at <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 0 are shifted to the <a href="syntax-model.html#%28tech._label._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">label phase level</span></a>.
+If <span class="RktVar">shift</span> is <span class="RktVal">0</span>, then the result is <span class="RktVar">stx</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/stxcase-scheme..rkt)._generate-temporaries))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._generate-temporaries%29%29" class="RktValDef RktValLink" data-pltdoc="x">generate-temporaries</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx-pair</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx-pair</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of identifiers that are distinct from all other
+identifiers. The list contains as many identifiers as
+<span class="RktVar">stx-pair</span> contains elements. The <span class="RktVar">stx-pair</span> argument
+must be a syntax pair that can be flattened into a list. The elements
+of <span class="RktVar">stx-pair</span> can be anything, but string, symbol, keyword
+(possibly wrapped as syntax), and identifier elements will be embedded
+in the corresponding generated name, which is useful for debugging
+purposes.</div></p><p>The generated identifiers are built with interned symbols (not
+<span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._gensym%29%29" class="RktValLink" data-pltdoc="x">gensym</a></span>s); see also <a href="printing.html#%28part._print-compiled%29" data-pltdoc="x">Printing Compiled Code</a>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._generate-temporaries%29%29" class="RktValLink" data-pltdoc="x">generate-temporaries</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">c</span><span class="hspace">&nbsp;</span><span class="RktVal">d</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#&lt;syntax a1&gt; #&lt;syntax b2&gt; #&lt;syntax c3&gt; #&lt;syntax d4&gt;)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._generate-temporaries%29%29" class="RktValLink" data-pltdoc="x">generate-temporaries</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#&lt;syntax temp5&gt; #&lt;syntax temp6&gt; #&lt;syntax temp7&gt; #&lt;syntax temp8&gt;)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._set%21-values%29%29" class="RktStxLink" data-pltdoc="x">set!-values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">expr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._with-syntax%29%29" class="RktStxLink" data-pltdoc="x">with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">temp</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._generate-temporaries%29%29" class="RktValLink" data-pltdoc="x">generate-temporaries</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">temp</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">expr</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym">temp</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._identifier-prune-lexical-context))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._identifier-prune-lexical-context%29%29" class="RktValDef RktValLink" data-pltdoc="x">identifier-prune-lexical-context</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">id-stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">syms</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">syms</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id-stx</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an identifier with the same binding as <span class="RktVar">id-stx</span>, but
+without possibly lexical information from <span class="RktVar">id-stx</span> that does not apply
+to the symbols in <span class="RktVar">syms</span>, where even further extension of the
+lexical information drops information for other symbols. In
+particular, transferring the lexical context via
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span> from the result of this function to a symbol
+other than one in <span class="RktVar">syms</span> may produce an identifier with no binding.</div></p><p>Currently, the result is always <span class="RktVar">id-stx</span> exactly. Pruning was
+intended primarily as a kind of optimization in a previous version of
+Racket, but it is less useful and difficult to implement efficiently
+in the current macro expander.</p><p>See also <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._quote-syntax%2Fprune%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax/prune</a></span>.</p><p class="SHistory">Changed in version 6.5 of package <span class="stt">base</span>: Always return <span class="RktVar">id-stx</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._identifier-prune-to-source-module))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._identifier-prune-to-source-module%29%29" class="RktValDef RktValLink" data-pltdoc="x">identifier-prune-to-source-module</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id-stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an identifier with its lexical context minimized to that
+needed for <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-source-module%29%29" class="RktValLink" data-pltdoc="x">syntax-source-module</a></span>. The minimized lexical
+context does not include any bindings.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._syntax-recertify))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._syntax-recertify%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-recertify</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">new-stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">old-stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">inspector</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">key</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">new-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">old-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">inspector</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="inspectors.html#%28def._%28%28quote._~23~25kernel%29._inspector~3f%29%29" class="RktValLink" data-pltdoc="x">inspector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">For backward compatibility only; returns <span class="RktVar">new-stx</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-debug-info))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-debug-info%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-debug-info</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">phase</span><span class="hspace">&nbsp;</span><span class="RktVar">all-bindings?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">phase</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-phase-level%29%29" class="RktValLink" data-pltdoc="x">syntax-local-phase-level</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">all-bindings?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a hash table that describes the <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> of
+<span class="RktVar">stx</span> (not counting components when <span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span><span class="stt"> </span><span class="RktVar">stx</span><span class="RktPn">)</span>
+would return a compound value). The result can include&#8212;<wbr></wbr>but is not
+limited to&#8212;<wbr></wbr>the following keys:</div></p><ul><li><p><span class="RktVal">'</span><span class="RktVal">name</span> &#8212;<wbr></wbr> the result of <span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span><span class="stt"> </span><span class="RktVar">stx</span><span class="RktPn">)</span>, if it is a symbol.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">context</span> &#8212;<wbr></wbr> a list of vectors, where each vector represents a scope
+attached to <span class="RktVar">stx</span>.</p><p>Each vector starts with a number that is distinct for every
+scope. A symbol afterward provides a hint at the scope&rsquo;s
+origin: <span class="RktVal">'</span><span class="RktVal">module</span> for a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> scope,
+<span class="RktVal">'</span><span class="RktVal">macro</span> for a macro-introduction scope,
+<span class="RktVal">'</span><span class="RktVal">use-site</span> for a macro use-site scope, or
+<span class="RktVal">'</span><span class="RktVal">local</span> for a local binding form. In the case of a
+<span class="RktVal">'</span><span class="RktVal">module</span> scope that corresponds to the inside edge, the
+module&rsquo;s name and a phase (since an inside-edge scope is
+generated for each phase) are shown.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">bindings</span> &#8212;<wbr></wbr> a list of bindings, each represented by
+a hash table. A binding table can include&#8212;<wbr></wbr>but is not limited
+to&#8212;<wbr></wbr>the following keys:</p><ul><li><p><span class="RktVal">'</span><span class="RktVal">name</span> &#8212;<wbr></wbr> the symbolic name for the binding.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">context</span> &#8212;<wbr></wbr> the scopes, as a list of vectors,
+for the binding.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">local</span> &#8212;<wbr></wbr> a symbol representing a <a href="syntax-model.html#%28tech._local._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">local binding</span></a>;
+when this key is present, <span class="RktVal">'</span><span class="RktVal">module</span> is absent.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">module</span> &#8212;<wbr></wbr> an encoding of a import from another module;
+when this key is present, <span class="RktVal">'</span><span class="RktVal">local</span> is absent.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">free-identifier=?</span> &#8212;<wbr></wbr> a hash table of debugging information
+from an identifier for which the binding is an alias.</p></li></ul></li><li><p><span class="RktVal">'</span><span class="RktVal">fallbacks</span> &#8212;<wbr></wbr> a list of hash tables like the one
+produced by <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-debug-info%29%29" class="RktValLink" data-pltdoc="x">syntax-debug-info</a></span> for cross-namespace binding fallbacks.</p></li></ul><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Syntax_Object_Source_Locations&quot;">12.2.1<tt>&nbsp;</tt><a name="(part._.Syntax_.Object_.Source_.Locations)"></a><a name="(mod-path._racket/syntax-srcloc)"></a>Syntax Object Source Locations</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="stxops.html#%28mod-path._racket%2Fsyntax-srcloc%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/syntax-srcloc</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="stxops.html#%28mod-path._racket%2Fsyntax-srcloc%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/syntax-srcloc</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/syntax-srcloc..rkt)._syntax-srcloc))"></a><span title="Provided from: racket/syntax-srcloc | Package: base"><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fsyntax-srcloc..rkt%29._syntax-srcloc%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-srcloc</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._srcloc~3f%29%29" class="RktValLink" data-pltdoc="x">srcloc?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <a href="exns.html#%28tech._source._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">source location</span></a> for the <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>
+<span class="RktVar">stx</span>, or <span class="RktVal">#f</span> if none is known.</div></p><p class="SHistory">Added in version 8.2.0.5 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stx-patterns.html" title="backward to &quot;12.1 Pattern-Based Syntax Matching&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stxcmp.html" title="forward to &quot;12.3 Syntax Object Bindings&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/stxparam.html b/clones/docs.racket-lang.org/reference/stxparam.html
new file mode 100644
index 00000000..c547d730
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/stxparam.html
@@ -0,0 +1,50 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>12.5&nbsp;Syntax Parameters</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">12.1&nbsp;</td><td><a href="stx-patterns.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Syntax Matching</a></td></tr><tr><td align="right">12.2&nbsp;</td><td><a href="stxops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Content</a></td></tr><tr><td align="right">12.3&nbsp;</td><td><a href="stxcmp.html" class="tocviewlink" data-pltdoc="x">Syntax Object Bindings</a></td></tr><tr><td align="right">12.4&nbsp;</td><td><a href="stxtrans.html" class="tocviewlink" data-pltdoc="x">Syntax Transformers</a></td></tr><tr><td align="right">12.5&nbsp;</td><td><a href="stxparam.html" class="tocviewselflink" data-pltdoc="x">Syntax Parameters</a></td></tr><tr><td align="right">12.6&nbsp;</td><td><a href="splicing.html" class="tocviewlink" data-pltdoc="x">Local Binding with Splicing Body</a></td></tr><tr><td align="right">12.7&nbsp;</td><td><a href="stxprops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Properties</a></td></tr><tr><td align="right">12.8&nbsp;</td><td><a href="stxcerts.html" class="tocviewlink" data-pltdoc="x">Syntax Taints</a></td></tr><tr><td align="right">12.9&nbsp;</td><td><a href="Expanding_Top-Level_Forms.html" class="tocviewlink" data-pltdoc="x">Expanding Top-<wbr></wbr>Level Forms</a></td></tr><tr><td align="right">12.10&nbsp;</td><td><a href="Serializing_Syntax.html" class="tocviewlink" data-pltdoc="x">Serializing Syntax</a></td></tr><tr><td align="right">12.11&nbsp;</td><td><a href="include.html" class="tocviewlink" data-pltdoc="x">File Inclusion</a></td></tr><tr><td align="right">12.12&nbsp;</td><td><a href="syntax-util.html" class="tocviewlink" data-pltdoc="x">Syntax Utilities</a></td></tr><tr><td align="right">12.13&nbsp;</td><td><a href="phase_space.html" class="tocviewlink" data-pltdoc="x">Phase and Space Utilities</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>12.5&nbsp;</td><td><a href="stxparam.html" class="tocviewselflink" data-pltdoc="x">Syntax Parameters</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">12.5.1&nbsp;</td><td><a href="stxparam.html#%28part._.Syntax_.Parameter_.Inspection%29" class="tocviewlink" data-pltdoc="x">Syntax Parameter Inspection</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._define-syntax-parameter%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax-<wbr></wbr>parameter</span></span></a></td></tr><tr><td><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._syntax-parameterize%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">syntax-<wbr></wbr>parameterize</span></span></a></td></tr><tr><td><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._define-rename-transformer-parameter%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>rename-<wbr></wbr>transformer-<wbr></wbr>parameter</span></span></a></td></tr><tr><td><span class="tocsublinknumber">12.5.1<tt>&nbsp;</tt></span><a href="stxparam.html#%28part._.Syntax_.Parameter_.Inspection%29" class="tocsubseclink" data-pltdoc="x">Syntax Parameter Inspection</a></td></tr><tr><td><a href="stxparam.html#%28def._%28%28lib._racket%2Fstxparam-exptime..rkt%29._syntax-parameter-value%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>parameter-<wbr></wbr>value</span></span></a></td></tr><tr><td><a href="stxparam.html#%28def._%28%28lib._racket%2Fstxparam-exptime..rkt%29._make-parameter-rename-transformer%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>parameter-<wbr></wbr>rename-<wbr></wbr>transformer</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stxtrans.html" title="backward to &quot;12.4 Syntax Transformers&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="splicing.html" title="forward to &quot;12.6 Local Binding with Splicing Body&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;stxparam&quot;">12.5<tt>&nbsp;</tt><a name="(part._stxparam)"></a><a name="(mod-path._racket/stxparam)"></a>Syntax Parameters</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="stxparam.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/stxparam</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="stxparam.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/stxparam</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/stxparam..rkt)._define-syntax-parameter))"></a><span title="Provided from: racket/stxparam | Package: base"><span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._define-syntax-parameter%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-syntax-parameter</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Binds <span class="RktVar">id</span> as syntax to a <a name="(tech._syntax._parameter)"></a><span style="font-style: italic">syntax
+parameter</span>. The <span class="RktVar">expr</span> is an expression in the
+<a href="syntax-model.html#%28tech._transformer._environment%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer environment</span></a> that serves as the default value for
+the <a href="stxparam.html#%28tech._syntax._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax parameter</span></a>. The value is typically obtained by a transformer
+using <span class="RktSym"><a href="stxparam.html#%28def._%28%28lib._racket%2Fstxparam-exptime..rkt%29._syntax-parameter-value%29%29" class="RktValLink" data-pltdoc="x">syntax-parameter-value</a></span>.</div></p><p>The <span class="RktVar">id</span> can be used with <span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._syntax-parameterize%29%29" class="RktStxLink" data-pltdoc="x">syntax-parameterize</a></span>
+or <span class="RktSym"><a href="stxparam.html#%28def._%28%28lib._racket%2Fstxparam-exptime..rkt%29._syntax-parameter-value%29%29" class="RktValLink" data-pltdoc="x">syntax-parameter-value</a></span> (in a transformer). If
+<span class="RktVar">expr</span> produces a procedure of one argument or a
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-set%21-transformer%29%29" class="RktValLink" data-pltdoc="x">make-set!-transformer</a></span> result, then <span class="RktVar">id</span> can be
+used as a macro. If <span class="RktVar">expr</span> produces a
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span> result, then <span class="RktVar">id</span> can be
+used as a macro that expands to a use of the target identifier, but
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value</a></span> of <span class="RktVar">id</span> does not produce
+the target&rsquo;s value.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._define-syntax-parameter%29%29" class="RktStxLink" data-pltdoc="x">define-syntax-parameter</a></span><span class="hspace">&nbsp;</span><span class="RktSym">current-class</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._define-syntax-parameter%29%29" class="RktStxLink" data-pltdoc="x">define-syntax-parameter</a></span><span class="hspace">&nbsp;</span><span class="RktSym">yield</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">abort</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._define-syntax-parameter%29%29" class="RktStxLink" data-pltdoc="x">define-syntax-parameter</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._raise-syntax-error%29%29" class="RktValLink" data-pltdoc="x">raise-syntax-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">"use of a class keyword not in a class"</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxparam.html#%28def._%28%28lib._racket%2Fstxparam-exptime..rkt%29._syntax-parameter-value%29%29" class="RktValLink" data-pltdoc="x">syntax-parameter-value</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">current-class</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">yield</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/stxparam..rkt)._syntax-parameterize))"></a><span title="Provided from: racket/stxparam | Package: base"><span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._syntax-parameterize%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">syntax-parameterize</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span>See also <span class="RktSym"><a href="splicing.html#%28form._%28%28lib._racket%2Fsplicing..rkt%29._splicing-syntax-parameterize%29%29" class="RktStxLink" data-pltdoc="x">splicing-syntax-parameterize</a></span>.</p></blockquote></blockquote></blockquote></div></p><p>Each <span class="RktVar">id</span> must be bound to a <a href="stxparam.html#%28tech._syntax._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax parameter</span></a> using
+<span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._define-syntax-parameter%29%29" class="RktStxLink" data-pltdoc="x">define-syntax-parameter</a></span>. Each <span class="RktVar">expr</span> is an expression
+in the <a href="syntax-model.html#%28tech._transformer._environment%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer environment</span></a>. During the expansion of the
+<span class="RktVar">body-expr</span>s, the value of each <span class="RktVar">expr</span> is bound to the
+corresponding <span class="RktVar">id</span>.</p><p>If an <span class="RktVar">expr</span> produces a procedure of one argument or a
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-set%21-transformer%29%29" class="RktValLink" data-pltdoc="x">make-set!-transformer</a></span> result, then its <span class="RktVar">id</span>
+can be used as a macro during the expansion of the
+<span class="RktVar">body-expr</span>s. If <span class="RktVar">expr</span> produces a
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span> result, then <span class="RktVar">id</span> can be
+used as a macro that expands to a use of the target identifier, but
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value</a></span> of <span class="RktVar">id</span> does not produce
+the target&rsquo;s value.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._define-syntax-parameter%29%29" class="RktStxLink" data-pltdoc="x">define-syntax-parameter</a></span><span class="hspace">&nbsp;</span><span class="RktSym">abort</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="RktStxLink" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">forever</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="RktStxLink" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">forever</span><span class="hspace">&nbsp;</span><span class="RktSym">body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="cont.html#%28def._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._call%2Fcc%29%29" class="RktValLink" data-pltdoc="x">call/cc</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">abort-k</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._syntax-parameterize%29%29" class="RktStxLink" data-pltdoc="x">syntax-parameterize</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">abort</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="RktStxLink" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">abort-k</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">body</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._define-syntax-parameter%29%29" class="RktStxLink" data-pltdoc="x">define-syntax-parameter</a></span><span class="hspace">&nbsp;</span><span class="RktSym">it</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="RktStxLink" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">aif</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="RktStxLink" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">aif</span><span class="hspace">&nbsp;</span><span class="RktSym">test</span><span class="hspace">&nbsp;</span><span class="RktSym">then</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">t</span><span class="hspace">&nbsp;</span><span class="RktSym">test</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._syntax-parameterize%29%29" class="RktStxLink" data-pltdoc="x">syntax-parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">it</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-id-rules%29%29" class="RktStxLink" data-pltdoc="x">syntax-id-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="hspace">&nbsp;</span><span class="RktSym">then</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._else%29%29" class="RktStxLink" data-pltdoc="x">else</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/stxparam..rkt)._define-rename-transformer-parameter))"></a><span title="Provided from: racket/stxparam | Package: base"><span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._define-rename-transformer-parameter%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-rename-transformer-parameter</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Binds <span class="RktVar">id</span> as syntax to a <a href="stxparam.html#%28tech._syntax._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax parameter</span></a> that must
+be bound to a <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span> result and, unlike
+<span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._define-syntax-parameter%29%29" class="RktStxLink" data-pltdoc="x">define-syntax-parameter</a></span>, <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value</a></span> of
+<span class="RktVar">id</span> <span class="emph">does</span> produce the target&rsquo;s value, including inside
+of <span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._syntax-parameterize%29%29" class="RktStxLink" data-pltdoc="x">syntax-parameterize</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">test</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#`</span><span class="RktRdr">#,</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">t</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">one</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">two</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._define-syntax-parameter%29%29" class="RktStxLink" data-pltdoc="x">define-syntax-parameter</a></span><span class="hspace">&nbsp;</span><span class="RktSym">not-num</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">one</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">test</span><span class="hspace">&nbsp;</span><span class="RktSym">not-num</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;procedure:syntax-parameter&gt;</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._define-rename-transformer-parameter%29%29" class="RktStxLink" data-pltdoc="x">define-rename-transformer-parameter</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">one</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">test</span><span class="hspace">&nbsp;</span><span class="RktSym">num</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._syntax-parameterize%29%29" class="RktStxLink" data-pltdoc="x">syntax-parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">num</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">two</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">test</span><span class="hspace">&nbsp;</span><span class="RktSym">num</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.3.0.14 of package <span class="stt">base</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Syntax_Parameter_Inspection&quot;">12.5.1<tt>&nbsp;</tt><a name="(part._.Syntax_.Parameter_.Inspection)"></a><a name="(mod-path._racket/stxparam-exptime)"></a>Syntax Parameter Inspection</h5><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="stxparam.html#%28mod-path._racket%2Fstxparam-exptime%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/stxparam-exptime</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stxparam-exptime..rkt)._syntax-parameter-value))"></a><span title="Provided from: racket/stxparam-exptime, racket/stxparam | Package: base"><span class="RktSym"><a href="stxparam.html#%28def._%28%28lib._racket%2Fstxparam-exptime..rkt%29._syntax-parameter-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-parameter-value</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id-stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">This procedure is intended for use in a <a href="syntax-model.html#%28tech._transformer._environment%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer
+environment</span></a>, where <span class="RktVar">id-stx</span> is an identifier bound in the
+normal environment to a <a href="stxparam.html#%28tech._syntax._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax parameter</span></a>. The result is the current
+value of the <a href="stxparam.html#%28tech._syntax._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax parameter</span></a>, as adjusted by
+<span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._syntax-parameterize%29%29" class="RktStxLink" data-pltdoc="x">syntax-parameterize</a></span> form.</div></p><p>This binding is provided <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span> by
+<a href="stxparam.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/stxparam</span></a>, since it is normally used in a
+transformer. It is provided normally by
+<a href="stxparam.html#%28mod-path._racket%2Fstxparam-exptime%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/stxparam-exptime</span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/stxparam-exptime..rkt)._make-parameter-rename-transformer))"></a><span title="Provided from: racket/stxparam-exptime, racket/stxparam | Package: base"><span class="RktSym"><a href="stxparam.html#%28def._%28%28lib._racket%2Fstxparam-exptime..rkt%29._make-parameter-rename-transformer%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-parameter-rename-transformer</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id-stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">This procedure is intended for use in a transformer, where
+<span class="RktVar">id-stx</span> is an identifier bound to a <a href="stxparam.html#%28tech._syntax._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax parameter</span></a>. The
+result is a transformer that behaves as <span class="RktVar">id-stx</span>, but that cannot
+be used with <span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._syntax-parameterize%29%29" class="RktStxLink" data-pltdoc="x">syntax-parameterize</a></span> or
+<span class="RktSym"><a href="stxparam.html#%28def._%28%28lib._racket%2Fstxparam-exptime..rkt%29._syntax-parameter-value%29%29" class="RktValLink" data-pltdoc="x">syntax-parameter-value</a></span>.</div></p><p>Using <span class="RktSym"><a href="stxparam.html#%28def._%28%28lib._racket%2Fstxparam-exptime..rkt%29._make-parameter-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-parameter-rename-transformer</a></span> is analogous to
+defining a procedure that calls a parameter. Such a procedure can be
+exported to others to allow access to the parameter value, but not to
+change the parameter value. Similarly,
+<span class="RktSym"><a href="stxparam.html#%28def._%28%28lib._racket%2Fstxparam-exptime..rkt%29._make-parameter-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-parameter-rename-transformer</a></span> allows a <a href="stxparam.html#%28tech._syntax._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax parameter</span></a>
+to be used as a macro, but not changed.</p><p>The result of <span class="RktSym"><a href="stxparam.html#%28def._%28%28lib._racket%2Fstxparam-exptime..rkt%29._make-parameter-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-parameter-rename-transformer</a></span> is not
+treated specially by <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value</a></span>, unlike the result
+of <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span>.</p><p>This binding is provided <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span> by
+<a href="stxparam.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/stxparam</span></a>, since it is normally used in a
+transformer. It is provided normally by
+<a href="stxparam.html#%28mod-path._racket%2Fstxparam-exptime%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/stxparam-exptime</span></a>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stxtrans.html" title="backward to &quot;12.4 Syntax Transformers&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="splicing.html" title="forward to &quot;12.6 Local Binding with Splicing Body&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/stxprops.html b/clones/docs.racket-lang.org/reference/stxprops.html
new file mode 100644
index 00000000..e9f15365
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/stxprops.html
@@ -0,0 +1,110 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>12.7&nbsp;Syntax Object Properties</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">12.1&nbsp;</td><td><a href="stx-patterns.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Syntax Matching</a></td></tr><tr><td align="right">12.2&nbsp;</td><td><a href="stxops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Content</a></td></tr><tr><td align="right">12.3&nbsp;</td><td><a href="stxcmp.html" class="tocviewlink" data-pltdoc="x">Syntax Object Bindings</a></td></tr><tr><td align="right">12.4&nbsp;</td><td><a href="stxtrans.html" class="tocviewlink" data-pltdoc="x">Syntax Transformers</a></td></tr><tr><td align="right">12.5&nbsp;</td><td><a href="stxparam.html" class="tocviewlink" data-pltdoc="x">Syntax Parameters</a></td></tr><tr><td align="right">12.6&nbsp;</td><td><a href="splicing.html" class="tocviewlink" data-pltdoc="x">Local Binding with Splicing Body</a></td></tr><tr><td align="right">12.7&nbsp;</td><td><a href="stxprops.html" class="tocviewselflink" data-pltdoc="x">Syntax Object Properties</a></td></tr><tr><td align="right">12.8&nbsp;</td><td><a href="stxcerts.html" class="tocviewlink" data-pltdoc="x">Syntax Taints</a></td></tr><tr><td align="right">12.9&nbsp;</td><td><a href="Expanding_Top-Level_Forms.html" class="tocviewlink" data-pltdoc="x">Expanding Top-<wbr></wbr>Level Forms</a></td></tr><tr><td align="right">12.10&nbsp;</td><td><a href="Serializing_Syntax.html" class="tocviewlink" data-pltdoc="x">Serializing Syntax</a></td></tr><tr><td align="right">12.11&nbsp;</td><td><a href="include.html" class="tocviewlink" data-pltdoc="x">File Inclusion</a></td></tr><tr><td align="right">12.12&nbsp;</td><td><a href="syntax-util.html" class="tocviewlink" data-pltdoc="x">Syntax Utilities</a></td></tr><tr><td align="right">12.13&nbsp;</td><td><a href="phase_space.html" class="tocviewlink" data-pltdoc="x">Phase and Space Utilities</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>property</span></span></a></td></tr><tr><td><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property-remove%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>property-<wbr></wbr>remove</span></span></a></td></tr><tr><td><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property-preserved~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>property-<wbr></wbr>preserved?</span></span></a></td></tr><tr><td><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property-symbol-keys%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>property-<wbr></wbr>symbol-<wbr></wbr>keys</span></span></a></td></tr><tr><td><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-track-origin%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>track-<wbr></wbr>origin</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="splicing.html" title="backward to &quot;12.6 Local Binding with Splicing Body&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stxcerts.html" title="forward to &quot;12.8 Syntax Taints&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;stxprops&quot;">12.7<tt>&nbsp;</tt><a name="(part._stxprops)"></a>Syntax Object Properties</h4><p>Every syntax object has an associated <a name="(tech._syntax._property)"></a><span style="font-style: italic">syntax property</span> list,
+which can be queried or extended with
+<span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property%29%29" class="RktValLink" data-pltdoc="x">syntax-property</a></span>. A property is set as
+<a name="(tech._stx._prop._preserved)"></a><span style="font-style: italic">preserved</span> or not; a preserved property is
+maintained for a syntax object in a compiled form that is marshaled to a byte
+string or <span class="stt">".zo"</span> file, and other properties are discarded when
+marshaling.</p><p>In <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>, the reader attaches a preserved <span class="RktVal">'</span><span class="RktVal">paren-shape</span>
+property to any pair or vector syntax object generated from parsing a
+pair <span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span> and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span>; the property value is <span class="RktVal">#\[</span> in the former case,
+and <span class="RktVal">#\{</span> in the latter case. The <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax%29%29" class="RktStxLink" data-pltdoc="x">syntax</a></span> form copies
+any <span class="RktVal">'</span><span class="RktVal">paren-shape</span> property from the source of a template to
+corresponding generated syntax.</p><p>Both the syntax input to a transformer and the syntax result of a
+transformer may have associated properties. The two sets of properties
+are merged by the syntax expander: each property in the original and
+not present in the result is copied to the result, and the values of
+properties present in both are combined with <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span> (result
+value first, original value second) and the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span>ed value is
+<a href="stxprops.html#%28tech._stx._prop._preserved%29" class="techoutside" data-pltdoc="x"><span class="techinside">preserved</span></a> if either of the values were
+preserved.</p><p>Before performing the merge, however, the syntax expander
+automatically adds a property to the original syntax object using the
+key <a name="(idx._(gentag._235._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">origin</span>. If the source syntax has no
+<span class="RktVal">'</span><span class="RktVal">origin</span> property, it is set to the empty list.  Then, still
+before the merge, the identifier that triggered the macro expansion
+(as syntax) is <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span>ed onto the <span class="RktVal">'</span><span class="RktVal">origin</span>
+property so far.  The <span class="RktVal">'</span><span class="RktVal">origin</span> property thus records (in
+reverse order) the sequence of macro expansions that produced an
+expanded expression. Usually, the <span class="RktVal">'</span><span class="RktVal">origin</span> value is a
+list of identifiers, but a transformer might return
+syntax that has already been expanded, in which case an
+<span class="RktVal">'</span><span class="RktVal">origin</span> list can contain other lists after a merge. The
+<span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-track-origin%29%29" class="RktValLink" data-pltdoc="x">syntax-track-origin</a></span> procedure implements this tracking.
+The <span class="RktVal">'</span><span class="RktVal">origin</span> property is added as
+non-<a href="stxprops.html#%28tech._stx._prop._preserved%29" class="techoutside" data-pltdoc="x"><span class="techinside">preserved</span></a>.</p><p>Besides <span class="RktVal">'</span><span class="RktVal">origin</span> tracking for general macro expansion,
+Racket adds properties to expanded syntax (often using
+<span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-track-origin%29%29" class="RktValLink" data-pltdoc="x">syntax-track-origin</a></span>) to record additional expansion details:</p><ul><li><p>When a <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> form is spliced into a sequence with
+internal definitions (see <a href="syntax-model.html#%28part._intdef-body%29" data-pltdoc="x">Internal Definitions</a>),
+<span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-track-origin%29%29" class="RktValLink" data-pltdoc="x">syntax-track-origin</a></span> is applied to every spliced element from
+the <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> body. The second argument to
+<span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-track-origin%29%29" class="RktValLink" data-pltdoc="x">syntax-track-origin</a></span> is the <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> form, and the
+third argument is the <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> keyword (extracted from the
+spliced form).</p></li><li><p>When an internal <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span> or
+<span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span> form is converted into a
+<span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span> form (see <a href="syntax-model.html#%28part._intdef-body%29" data-pltdoc="x">Internal Definitions</a>),
+<span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-track-origin%29%29" class="RktValLink" data-pltdoc="x">syntax-track-origin</a></span> is applied to each generated binding
+clause.  The second argument to <span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-track-origin%29%29" class="RktValLink" data-pltdoc="x">syntax-track-origin</a></span> is the
+converted form, and the third argument is the <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span>
+or <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span> keyword form the converted form.</p></li><li><p>When a <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span> expression is fully
+expanded, syntax bindings disappear, and the result is either a
+<span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-values%29%29" class="RktStxLink" data-pltdoc="x">letrec-values</a></span> form (if the unexpanded form contained
+non-syntax bindings), or only the body of the
+<span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span> form (wrapped with <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> if
+the body contained multiple expressions). To record the disappeared
+syntax bindings, a property is added to the expansion result: an
+immutable list of identifiers from the disappeared bindings, as a
+<a name="(idx._(gentag._236._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">disappeared-binding</span> property.</p></li><li><p>When a subtyping <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> form is expanded, the
+identifier used to reference the base type does not appear in the
+expansion. Therefore, the <span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span> transformer adds the
+identifier to the expansion result as a
+<a name="(idx._(gentag._237._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">disappeared-use</span> property.</p></li><li><p>When a <a href="syntax-model.html#%28tech._rename._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">rename transformer</span></a> is used to replace a
+<span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span> target, <span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-track-origin%29%29" class="RktValLink" data-pltdoc="x">syntax-track-origin</a></span> is used on the
+target identifier (the same as when the identifier is used as an
+expression).</p></li><li><p>When a reference to an unexported or protected identifier from
+a module is discovered, the <a name="(idx._(gentag._238._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">protected</span> property is
+added to the identifier with a <span class="RktVal">#t</span> value.</p></li><li><p>When <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span>
+generates a syntax object, it attaches a property to the object
+(using a private key) to mark the object as originating from a
+read. The <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-original~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-original?</a></span>  predicate looks for the property
+to recognize such syntax objects. (See <a href="stxops.html" data-pltdoc="x">Syntax Object Content</a> for more
+information. The property is not transferred by the expander from
+a macro transformer input to its output or by <span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-track-origin%29%29" class="RktValLink" data-pltdoc="x">syntax-track-origin</a></span>.)</p></li></ul><p>See also <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?tag=%28part._%28.%27%28lib._scribblings%2Ftools%2Ftools..scrbl%29.%27._.%27.Syntax_.Properties_that_.Check_.Syntax_.Looks_.For.%27%29%29&amp;version=8.6" class="Sq" data-pltdoc="x">Check Syntax</a>
+for one client of the <span class="RktVal">'</span><span class="RktVal">disappeared-use</span> and <span class="RktVal">'</span><span class="RktVal">disappeared-binding</span>
+properties.</p><p>See <a href="Expanding_Top-Level_Forms.html#%28part._modinfo%29" data-pltdoc="x">Information on Expanded Modules</a> for information about properties generated
+by the expansion of a module declaration. See <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span> and
+<a href="syntax-model.html#%28part._infernames%29" data-pltdoc="x">Inferred Value Names</a> for information about properties recognized
+when compiling a procedure. See <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._current-compile%29%29" class="RktValLink" data-pltdoc="x">current-compile</a></span> for
+information on properties and byte codes.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-property))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-property</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">preserved?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktVar">preserved?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-interned~3f%29%29" class="RktValLink" data-pltdoc="x">symbol-interned?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">preserved?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">paren-shape</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-property</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">The three- or four-argument form extends <span class="RktVar">stx</span> by associating
+an arbitrary property value <span class="RktVar">v</span> with the key <span class="RktVar">key</span>; the
+result is a new syntax object with the association (while <span class="RktVar">stx</span>
+itself is unchanged). The property is added as
+<a href="stxprops.html#%28tech._stx._prop._preserved%29" class="techoutside" data-pltdoc="x"><span class="techinside">preserved</span></a> if <span class="RktVar">preserved?</span> is true, in
+which case <span class="RktVar">key</span> must be an <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> symbol, and <span class="RktVar">v</span>
+should be a value as described below that can be saved in marshaled bytecode.</div></p><p>The two-argument form returns an arbitrary property value associated
+to <span class="RktVar">stx</span> with the key <span class="RktVar">key</span>, or <span class="RktVal">#f</span> if no value
+is associated to <span class="RktVar">stx</span> for <span class="RktVar">key</span>. If <span class="RktVar">stx</span> is <a href="stxcerts.html#%28tech._tainted%29" class="techoutside" data-pltdoc="x"><span class="techinside">tainted</span></a>,
+then syntax objects with the result value are tainted.</p><p>To support marshaling to bytecode, a value for a preserved syntax
+property must be a non-cyclic value that is either</p><ul><li><p>a <a href="pairs.html#%28tech._pair%29" class="techoutside" data-pltdoc="x"><span class="techinside">pair</span></a> containing allowed preserved-property values;</p></li><li><p>a <a href="vectors.html#%28tech._vector%29" class="techoutside" data-pltdoc="x"><span class="techinside">vector</span></a> (unmarshaled as immutable) containing allowed preserved-property values;</p></li><li><p>a <a href="boxes.html#%28tech._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">box</span></a> (unmarshaled as immutable) containing allowed preserved-property values;</p></li><li><p>an immutable <a href="structures.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure containing allowed preserved-property values;</p></li><li><p>an immutable <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash table</span></a> whose keys and values are allowed preserved-property values;</p></li><li><p>a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>; or</p></li><li><p>an empty list, <a href="symbols.html#%28tech._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">symbol</span></a>, <a href="numbers.html#%28tech._number%29" class="techoutside" data-pltdoc="x"><span class="techinside">number</span></a>, <a href="characters.html#%28tech._character%29" class="techoutside" data-pltdoc="x"><span class="techinside">character</span></a>,
+<a href="strings.html#%28tech._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">string</span></a>, <a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte string</span></a>, or <a href="regexp.html#%28tech._regexp._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp
+value</span></a>.</p></li></ul><p>Any other value for a preserved property triggers an exception at an
+attempt to marshal the owning syntax object to bytecode form.</p><p class="SHistory">Changed in version 6.4.0.14 of package <span class="stt">base</span>: Added the <span class="RktVar">preserved?</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-property-remove))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property-remove%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-property-remove</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a syntax object like <span class="RktVar">stx</span>, but without a property (if
+any) for <span class="RktVar">key</span>.</div></p><p class="SHistory">Added in version 6.90.0.20 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-property-preserved~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property-preserved~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-property-preserved?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-interned~3f%29%29" class="RktValLink" data-pltdoc="x">symbol-interned?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">stx</span> has a
+<a href="stxprops.html#%28tech._stx._prop._preserved%29" class="techoutside" data-pltdoc="x"><span class="techinside">preserved</span></a> property value for <span class="RktVar">key</span>,
+<span class="RktVal">#f</span> otherwise.</div></p><p class="SHistory">Added in version 6.4.0.14 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-property-symbol-keys))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property-symbol-keys%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-property-symbol-keys</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of all symbols that as keys have associated properties
+in <span class="RktVar">stx</span>. <a href="symbols.html#%28tech._uninterned%29" class="techoutside" data-pltdoc="x"><span class="techinside">Uninterned</span></a> symbols (see <a href="symbols.html" data-pltdoc="x">Symbols</a>)
+are not included in the result list.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-track-origin))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-track-origin%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-track-origin</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">new-stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">orig-stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">id-stx</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">new-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">orig-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Adds properties to <span class="RktVar">new-stx</span> in the same way that macro
+expansion adds properties to a transformer result. In particular, it
+merges the properties of <span class="RktVar">orig-stx</span> into <span class="RktVar">new-stx</span>,
+first adding <span class="RktVar">id-stx</span> as an <span class="RktVal">'</span><span class="RktVal">origin</span> property and removing
+the property recognized by <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-original~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-original?</a></span>, and it
+returns the property-extended syntax object. Use the
+<span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-track-origin%29%29" class="RktValLink" data-pltdoc="x">syntax-track-origin</a></span> procedure in a macro transformer that
+discards syntax (corresponding to <span class="RktVar">orig-stx</span> with a keyword
+<span class="RktVar">id-stx</span>) leaving some other syntax in its place (corresponding
+to <span class="RktVar">new-stx</span>).</div></p><p>For example, the expression</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></p></blockquote><p>expands to</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">or-part</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktSym">or-part</span><span class="hspace">&nbsp;</span><span class="RktSym">or-part</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>which, in turn, expands to</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">or-part</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktSym">or-part</span><span class="hspace">&nbsp;</span><span class="RktSym">or-part</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>The syntax object for the final expression will have an
+<span class="RktVal">'</span><span class="RktVal">origin</span> property whose value is <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span><span class="stt"> </span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span><span class="stt"> </span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="RktPn">)</span><span class="RktPn">)</span>.</p><p class="SHistory">Changed in version 7.0 of package <span class="stt">base</span>: Included the <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-original~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-original?</a></span>
+property among the ones transferred to
+<span class="RktVar">new-stx</span>.<br/>Changed in version 8.2.0.7: Corrected back to removing the <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-original~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-original?</a></span>
+property from the set transferred to
+<span class="RktVar">new-stx</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="splicing.html" title="backward to &quot;12.6 Local Binding with Splicing Body&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stxcerts.html" title="forward to &quot;12.8 Syntax Taints&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/stxtrans.html b/clones/docs.racket-lang.org/reference/stxtrans.html
new file mode 100644
index 00000000..94b1b0f0
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/stxtrans.html
@@ -0,0 +1,729 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>12.4&nbsp;Syntax Transformers</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">12.1&nbsp;</td><td><a href="stx-patterns.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Syntax Matching</a></td></tr><tr><td align="right">12.2&nbsp;</td><td><a href="stxops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Content</a></td></tr><tr><td align="right">12.3&nbsp;</td><td><a href="stxcmp.html" class="tocviewlink" data-pltdoc="x">Syntax Object Bindings</a></td></tr><tr><td align="right">12.4&nbsp;</td><td><a href="stxtrans.html" class="tocviewselflink" data-pltdoc="x">Syntax Transformers</a></td></tr><tr><td align="right">12.5&nbsp;</td><td><a href="stxparam.html" class="tocviewlink" data-pltdoc="x">Syntax Parameters</a></td></tr><tr><td align="right">12.6&nbsp;</td><td><a href="splicing.html" class="tocviewlink" data-pltdoc="x">Local Binding with Splicing Body</a></td></tr><tr><td align="right">12.7&nbsp;</td><td><a href="stxprops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Properties</a></td></tr><tr><td align="right">12.8&nbsp;</td><td><a href="stxcerts.html" class="tocviewlink" data-pltdoc="x">Syntax Taints</a></td></tr><tr><td align="right">12.9&nbsp;</td><td><a href="Expanding_Top-Level_Forms.html" class="tocviewlink" data-pltdoc="x">Expanding Top-<wbr></wbr>Level Forms</a></td></tr><tr><td align="right">12.10&nbsp;</td><td><a href="Serializing_Syntax.html" class="tocviewlink" data-pltdoc="x">Serializing Syntax</a></td></tr><tr><td align="right">12.11&nbsp;</td><td><a href="include.html" class="tocviewlink" data-pltdoc="x">File Inclusion</a></td></tr><tr><td align="right">12.12&nbsp;</td><td><a href="syntax-util.html" class="tocviewlink" data-pltdoc="x">Syntax Utilities</a></td></tr><tr><td align="right">12.13&nbsp;</td><td><a href="phase_space.html" class="tocviewlink" data-pltdoc="x">Phase and Space Utilities</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>12.4&nbsp;</td><td><a href="stxtrans.html" class="tocviewselflink" data-pltdoc="x">Syntax Transformers</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">12.4.1&nbsp;</td><td><a href="stxtrans.html#%28part._require-trans%29" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">require</span></span> Transformers</a></td></tr><tr><td align="right">12.4.2&nbsp;</td><td><a href="stxtrans.html#%28part._provide-trans%29" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">provide</span></span> Transformers</a></td></tr><tr><td align="right">12.4.3&nbsp;</td><td><a href="stxtrans.html#%28part._keyword-trans%29" class="tocviewlink" data-pltdoc="x">Keyword-<wbr></wbr>Argument Conversion Introspection</a></td></tr><tr><td align="right">12.4.4&nbsp;</td><td><a href="stxtrans.html#%28part._portal-syntax%29" class="tocviewlink" data-pltdoc="x">Portal Syntax Bindings</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._set%21-transformer~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set!-<wbr></wbr>transformer?</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-set%21-transformer%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>set!-<wbr></wbr>transformer</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._set%21-transformer-procedure%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">set!-<wbr></wbr>transformer-<wbr></wbr>procedure</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aset%21-transformer%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>set!-<wbr></wbr>transformer</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._rename-transformer~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">rename-<wbr></wbr>transformer?</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>rename-<wbr></wbr>transformer</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._rename-transformer-target%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">rename-<wbr></wbr>transformer-<wbr></wbr>target</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3arename-transformer%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>rename-<wbr></wbr>transformer</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">local-<wbr></wbr>expand</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-expand-expression%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>expand-<wbr></wbr>expression</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-transformer-expand%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">local-<wbr></wbr>transformer-<wbr></wbr>expand</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%2Fcapture-lifts%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">local-<wbr></wbr>expand/<span class="mywbr"> &nbsp;</span>capture-<wbr></wbr>lifts</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-transformer-expand%2Fcapture-lifts%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">local-<wbr></wbr>transformer-<wbr></wbr>expand/<span class="mywbr"> &nbsp;</span>capture-<wbr></wbr>lifts</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-apply-transformer%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>apply-<wbr></wbr>transformer</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">internal-<wbr></wbr>definition-<wbr></wbr>context?</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-make-definition-context%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>make-<wbr></wbr>definition-<wbr></wbr>context</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-add-scopes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">internal-<wbr></wbr>definition-<wbr></wbr>context-<wbr></wbr>add-<wbr></wbr>scopes</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-splice-binding-identifier%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">internal-<wbr></wbr>definition-<wbr></wbr>context-<wbr></wbr>splice-<wbr></wbr>binding-<wbr></wbr>identifier</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-bind-syntaxes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>bind-<wbr></wbr>syntaxes</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-binding-identifiers%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">internal-<wbr></wbr>definition-<wbr></wbr>context-<wbr></wbr>binding-<wbr></wbr>identifiers</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-introduce%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">internal-<wbr></wbr>definition-<wbr></wbr>context-<wbr></wbr>introduce</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-seal%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">internal-<wbr></wbr>definition-<wbr></wbr>context-<wbr></wbr>seal</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._identifier-remove-from-definition-context%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">identifier-<wbr></wbr>remove-<wbr></wbr>from-<wbr></wbr>definition-<wbr></wbr>context</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aexpansion-contexts%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>expansion-<wbr></wbr>contexts</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>value</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%2Fimmediate%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>value/<span class="mywbr"> &nbsp;</span>immediate</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-expression%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>lift-<wbr></wbr>expression</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-values-expression%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>lift-<wbr></wbr>values-<wbr></wbr>expression</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-context%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>lift-<wbr></wbr>context</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-module%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>lift-<wbr></wbr>module</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-module-end-declaration%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>lift-<wbr></wbr>module-<wbr></wbr>end-<wbr></wbr>declaration</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-require%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>lift-<wbr></wbr>require</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-provide%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>lift-<wbr></wbr>provide</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-name%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>name</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-context%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>context</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-phase-level%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>phase-<wbr></wbr>level</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-module-exports%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>module-<wbr></wbr>exports</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-submodules%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>submodules</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-module-interned-scope-symbols%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>module-<wbr></wbr>interned-<wbr></wbr>scope-<wbr></wbr>symbols</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-get-shadower%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>get-<wbr></wbr>shadower</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-make-delta-introducer%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>make-<wbr></wbr>delta-<wbr></wbr>introducer</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._syntax-local-certifier%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>certifier</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>transforming?</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming-with-lifts~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>transforming-<wbr></wbr>with-<wbr></wbr>lifts?</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming-module-expression~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>transforming-<wbr></wbr>module-<wbr></wbr>expression?</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-identifier-as-binding%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>identifier-<wbr></wbr>as-<wbr></wbr>binding</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-introduce%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>introduce</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-syntax-introducer%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>syntax-<wbr></wbr>introducer</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-interned-syntax-introducer%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>interned-<wbr></wbr>syntax-<wbr></wbr>introducer</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-syntax-delta-introducer%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>syntax-<wbr></wbr>delta-<wbr></wbr>introducer</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-transforming-module-provides~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>transforming-<wbr></wbr>module-<wbr></wbr>provides?</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-module-defined-identifiers%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>module-<wbr></wbr>defined-<wbr></wbr>identifiers</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-module-required-identifiers%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>module-<wbr></wbr>required-<wbr></wbr>identifiers</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aliberal-define-context%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>liberal-<wbr></wbr>define-<wbr></wbr>context</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._liberal-define-context~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">liberal-<wbr></wbr>define-<wbr></wbr>context?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">12.4.1<tt>&nbsp;</tt></span><a href="stxtrans.html#%28part._require-trans%29" class="tocsubseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">require</span></span> Transformers</a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._expand-import%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">expand-<wbr></wbr>import</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._make-require-transformer%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>require-<wbr></wbr>transformer</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._prop~3arequire-transformer%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>require-<wbr></wbr>transformer</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._require-transformer~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">require-<wbr></wbr>transformer?</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">import</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import-source%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">import-<wbr></wbr>source</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._current-require-module-path%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>require-<wbr></wbr>module-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._convert-relative-module-path%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">convert-<wbr></wbr>relative-<wbr></wbr>module-<wbr></wbr>path</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._syntax-local-require-certifier%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>require-<wbr></wbr>certifier</span></span></a></td></tr><tr><td><span class="tocsublinknumber">12.4.2<tt>&nbsp;</tt></span><a href="stxtrans.html#%28part._provide-trans%29" class="tocsubseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">provide</span></span> Transformers</a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._expand-export%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">expand-<wbr></wbr>export</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._pre-expand-export%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">pre-<wbr></wbr>expand-<wbr></wbr>export</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._make-provide-transformer%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>provide-<wbr></wbr>transformer</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._make-provide-pre-transformer%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>provide-<wbr></wbr>pre-<wbr></wbr>transformer</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._prop~3aprovide-transformer%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>provide-<wbr></wbr>transformer</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._prop~3aprovide-pre-transformer%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>provide-<wbr></wbr>pre-<wbr></wbr>transformer</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._provide-transformer~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">provide-<wbr></wbr>transformer?</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._provide-pre-transformer~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">provide-<wbr></wbr>pre-<wbr></wbr>transformer?</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._export%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">export</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._syntax-local-provide-certifier%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>provide-<wbr></wbr>certifier</span></span></a></td></tr><tr><td><span class="tocsublinknumber">12.4.3<tt>&nbsp;</tt></span><a href="stxtrans.html#%28part._keyword-trans%29" class="tocsubseclink" data-pltdoc="x">Keyword-<wbr></wbr>Argument Conversion Introspection</a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Fkeyword-transform..rkt%29._syntax-procedure-alias-property%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>procedure-<wbr></wbr>alias-<wbr></wbr>property</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28lib._racket%2Fkeyword-transform..rkt%29._syntax-procedure-converted-arguments-property%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>procedure-<wbr></wbr>converted-<wbr></wbr>arguments-<wbr></wbr>property</span></span></a></td></tr><tr><td><span class="tocsublinknumber">12.4.4<tt>&nbsp;</tt></span><a href="stxtrans.html#%28part._portal-syntax%29" class="tocsubseclink" data-pltdoc="x">Portal Syntax Bindings</a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._portal-syntax~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">portal-<wbr></wbr>syntax?</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-portal-syntax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>portal-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._portal-syntax-content%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">portal-<wbr></wbr>syntax-<wbr></wbr>content</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stxcmp.html" title="backward to &quot;12.3 Syntax Object Bindings&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stxparam.html" title="forward to &quot;12.5 Syntax Parameters&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;stxtrans&quot;">12.4<tt>&nbsp;</tt><a name="(part._stxtrans)"></a>Syntax Transformers</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._set!-transformer~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._set%21-transformer~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">set!-transformer?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a value created by
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-set%21-transformer%29%29" class="RktValLink" data-pltdoc="x">make-set!-transformer</a></span> or an instance of a structure type with
+the <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aset%21-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:set!-transformer</a></span> property, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-set!-transformer))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-set%21-transformer%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-set!-transformer</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._set%21-transformer~3f%29%29" class="RktValLink" data-pltdoc="x">set!-transformer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates an <a href="syntax-model.html#%28tech._assignment._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">assignment transformer</span></a> that cooperates with
+<span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>. If the result of <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-set%21-transformer%29%29" class="RktValLink" data-pltdoc="x">make-set!-transformer</a></span> is
+bound to <span class="RktVar">id</span> as a <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding, then
+<span class="RktVar">proc</span> is applied as a transformer when <span class="RktVar">id</span> is
+used in an expression position, or when it is used as the target of a
+<span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span> assignment as <span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span>. When the
+identifier appears as a <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span> target, the entire <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>
+expression is provided to the transformer.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntax%29%29" class="RktStxLink" data-pltdoc="x">let-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-set%21-transformer%29%29" class="RktValLink" data-pltdoc="x">make-set!-transformer</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Redirect mutation of x to y</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Normal use of </span><span class="RktSym">x</span><span class="RktCmt"> really gets </span><span class="RktSym">x</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">id</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">x</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(1 3)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._set!-transformer-procedure))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._set%21-transformer-procedure%29%29" class="RktValDef RktValLink" data-pltdoc="x">set!-transformer-procedure</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">transformer</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">transformer</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._set%21-transformer~3f%29%29" class="RktValLink" data-pltdoc="x">set!-transformer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the procedure that was passed to
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-set%21-transformer%29%29" class="RktValLink" data-pltdoc="x">make-set!-transformer</a></span> to create <span class="RktVar">transformer</span> or that
+is identified by the <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aset%21-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:set!-transformer</a></span> property of
+<span class="RktVar">transformer</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._prop~3aset!-transformer))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aset%21-transformer%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:set!-transformer</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property</span></a> to identify structure types that act
+as <a href="syntax-model.html#%28tech._assignment._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">assignment transformers</span></a> like the ones created by
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-set%21-transformer%29%29" class="RktValLink" data-pltdoc="x">make-set!-transformer</a></span>.</div></p><p>The property value must be an exact integer or procedure of one or two
+arguments. In the former case, the integer designates a field within
+the structure that should contain a procedure; the integer must be
+between <span class="RktVal">0</span> (inclusive) and the number of non-automatic fields
+in the structure type (exclusive, not counting supertype fields), and
+the designated field must also be specified as immutable.</p><p>If the property value is a procedure of one argument, then the
+procedure serves as a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> and for <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>
+transformations. If the property value is a procedure of two
+arguments, then the first argument is the structure whose type has
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aset%21-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:set!-transformer</a></span> property, and the second argument is a
+syntax object as for a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> and for <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>
+transformations; <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._set%21-transformer-procedure%29%29" class="RktValLink" data-pltdoc="x">set!-transformer-procedure</a></span> applied to the
+structure produces a new function that accepts just the syntax object
+and calls the procedure associated through the property. Finally, if the
+property value is an integer, the target identifier is extracted from
+the structure instance; if the field value is not a procedure of one
+argument, then a procedure that always calls
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._raise-syntax-error%29%29" class="RktValLink" data-pltdoc="x">raise-syntax-error</a></span> is used, instead.</p><p>If a value has both the <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aset%21-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:set!-transformer</a></span> and
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3arename-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:rename-transformer</a></span> properties, then the latter takes
+precedence. If a structure type has the <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aset%21-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:set!-transformer</a></span>
+and <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._prop~3aprocedure%29%29" class="RktValLink" data-pltdoc="x">prop:procedure</a></span> properties, then the former takes
+precedence for the purposes of macro expansion.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._rename-transformer~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._rename-transformer~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">rename-transformer?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a value created by
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span> or an instance of a structure type
+with the <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3arename-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:rename-transformer</a></span> property, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._rename-transformer~3f%29%29" class="RktValLink" data-pltdoc="x">rename-transformer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._rename-transformer~3f%29%29" class="RktValLink" data-pltdoc="x">rename-transformer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">not-a-rename-transformer</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-rename-transformer))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-rename-transformer</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id-stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._rename-transformer~3f%29%29" class="RktValLink" data-pltdoc="x">rename-transformer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a <a href="syntax-model.html#%28tech._rename._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">rename transformer</span></a> that, when used as a
+<a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding, acts as a transformer that inserts the
+identifier <span class="RktVar">id-stx</span> in place of whatever identifier binds the
+transformer, including in non-application positions, in <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>
+expressions.</div></p><p>Such a transformer could be written manually, but the one created by
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span> triggers special cooperation with the
+parser and other syntactic forms when <span class="RktVar">id</span> is bound to the
+rename transformer:</p><ul><li><p>The parser installs a <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span> and
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="RktValLink" data-pltdoc="x">identifier-binding</a></span> equivalence between <span class="RktVar">id</span>
+and <span class="RktVar">id-stx</span>, as long as <span class="RktVar">id-stx</span> does not have
+a true value for the <a name="(idx._(gentag._232._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">not-free-identifier=?</span>
+<a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax property</span></a>.</p></li><li><p>A <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> of <span class="RktVar">id</span> provides the binding
+indicated by <span class="RktVar">id-stx</span> instead of <span class="RktVar">id</span>, as long
+as <span class="RktVar">id-stx</span> does not have a true value for the
+<span class="RktVal">'</span><span class="RktVal">not-free-identifier=?</span> <a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax property</span></a>
+and as long as <span class="RktVar">id-stx</span> has a binding.</p></li><li><p>If <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> exports <span class="RktVar">id</span>, it uses a
+symbol-valued <a name="(idx._(gentag._233._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">nominal-id</span> property of
+<span class="RktVar">id-stx</span> to specify the &ldquo;nominal source identifier&rdquo; of
+the binding as reported by <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="RktValLink" data-pltdoc="x">identifier-binding</a></span>.</p></li><li><p>If <span class="RktVar">id-stx</span> has a true value for the
+<a name="(idx._(gentag._234._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">not-provide-all-defined</span> <a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax
+property</span></a>, then <span class="RktVar">id</span> (or its target) is not exported by
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-defined-out%29%29" class="RktStxLink" data-pltdoc="x">all-defined-out</a></span>.</p></li><li><p>The <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value</a></span> function recognizes
+rename-transformer bindings and consult their targets.</p></li></ul><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-or</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">my-or</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">my-or</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.3 of package <span class="stt">base</span>: Removed an optional second argument.<br/>Changed in version 7.4.0.10: Adjust rename-transformer expansion
+to add a macro-introduction scope, the
+same as regular macro expansion.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._rename-transformer-target))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._rename-transformer-target%29%29" class="RktValDef RktValLink" data-pltdoc="x">rename-transformer-target</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">transformer</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">transformer</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._rename-transformer~3f%29%29" class="RktValLink" data-pltdoc="x">rename-transformer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the identifier passed to <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span> to
+create <span class="RktVar">transformer</span> or as indicated by a
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3arename-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:rename-transformer</a></span> property on <span class="RktVar">transformer</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._rename-transformer-target%29%29" class="RktValLink" data-pltdoc="x">rename-transformer-target</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._or%29%29" class="RktStxLink" data-pltdoc="x">or</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;syntax:eval:8:0 or&gt;</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._prop~3arename-transformer))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3arename-transformer%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:rename-transformer</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property</span></a> to identify structure types that act
+as <a href="syntax-model.html#%28tech._rename._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">rename transformers</span></a> like the ones created by
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span>.</div></p><p>The property value must be an exact integer, an identifier
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>, or a procedure that takes one argument.
+In the former case, the integer designates a
+field within the structure that should contain an identifier; the
+integer must be between <span class="RktVal">0</span> (inclusive) and the number of
+non-automatic fields in the structure type (exclusive, not counting
+supertype fields), and the designated field must also be specified as
+immutable.</p><p>If the property value is an identifier, the identifier serves as the
+target for renaming, just like the first argument to
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span>. If the property value is an integer,
+the target identifier is extracted from the structure instance; if the
+field value is not an identifier, then an identifier <span class="RktSym">?</span>
+with an empty context is used, instead.</p><p>If the property value is a procedure that takes one argument, then the
+procedure is called to obtain the identifier that the rename
+transformer will use as a target identifier. The returned identifier
+should probably have the <span class="RktVal">'</span><span class="RktVal">not-free-identifier=?</span> syntax
+property. If the procedure returns any value that is not an
+identifier, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Example of a procedure argument for prop:rename-transformer</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">slv-1</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">first-transformer-binding</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">slv-2</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">second-transformer-binding</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">slv-cooperator</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">redirect-to-first?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:property</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3arename-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:rename-transformer</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">inst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">slv-cooperator-redirect-to-first?</span><span class="hspace">&nbsp;</span><span class="RktSym">inst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">slv-1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">slv-2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">slv-lookup</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#`</span><span class="RktVal">'</span><span class="RktVal">#,</span><span class="RktVal">(</span><span class="RktVal">syntax-local-value</span><span class="hspace">&nbsp;</span><span class="RktVal">#'</span><span class="RktVal">id</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">slv-inst-1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">slv-cooperator</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">slv-inst-2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">slv-cooperator</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">slv-lookup</span><span class="hspace">&nbsp;</span><span class="RktSym">slv-inst-1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'first-transformer-binding</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">slv-lookup</span><span class="hspace">&nbsp;</span><span class="RktSym">slv-inst-2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'second-transformer-binding</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.3 of package <span class="stt">base</span>: the property now accepts a procedure of one argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._local-expand))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValDef RktValLink" data-pltdoc="x">local-expand</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">context-v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">stop-ids</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">intdef-ctx</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">context-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">expression</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">top-level</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">module</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">module-begin</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stop-ids</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Flist..rkt%29._empty%29%29" class="RktValLink" data-pltdoc="x">empty</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">intdef-ctx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Expands <span class="RktVar">stx</span> in the lexical context of the expression
+currently being expanded. The <span class="RktVar">context-v</span> argument is used as
+the result of <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-context%29%29" class="RktValLink" data-pltdoc="x">syntax-local-context</a></span> for immediate expansions;
+a list indicates an <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a>, and more
+information on the form of the list is below. If <span class="RktVar">stx</span> is not
+already a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>, it is coerced with
+<span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span><span class="stt"> </span><span class="RktVal">#f</span><span class="stt"> </span><span class="RktVar">stx</span><span class="RktPn">)</span> before expansion.</div></p><p>The <span class="RktVar">stop-ids</span> argument controls how far <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span> expands <span class="RktVar">stx</span>:</p><ul><li><p>If <span class="RktVar">stop-ids</span> is an empty list, then <span class="RktVar">stx</span> is recursively expanded (i.e.
+expansion proceeds to sub-expressions). The result is guaranteed to be a fully-expanded form,
+which can include the bindings listed in <a href="syntax-model.html#%28part._fully-expanded%29" data-pltdoc="x">Fully Expanded Programs</a>, plus <span class="RktSym"><a href="__expression.html#%28form._%28%28quote._~23~25kernel%29._~23~25expression%29%29" class="RktStxLink" data-pltdoc="x">#%expression</a></span>
+in any expression position.</p></li><li><p>If <span class="RktVar">stop-ids</span> is a list containing just <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span>, then expansion proceeds as if
+<span class="RktVar">stop-ids</span> were an empty list, except that expansion does not recur to <a href="eval-model.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodules</span></a>
+defined with <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> (which are left unexpanded in the result).</p></li><li><p>If <span class="RktVar">stop-ids</span> is any other list, then <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span>, <span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span>, <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>,
+<span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-lambda%29%29" class="RktStxLink" data-pltdoc="x">#%plain-lambda</a></span>, <span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span>, <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span>, <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-values%29%29" class="RktStxLink" data-pltdoc="x">letrec-values</a></span>,
+<span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span>, <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin0%29%29" class="RktStxLink" data-pltdoc="x">begin0</a></span>, <span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span>, <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span>,
+<span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-app%29%29" class="RktStxLink" data-pltdoc="x">#%plain-app</a></span>, <span class="RktSym"><a href="__expression.html#%28form._%28%28quote._~23~25kernel%29._~23~25expression%29%29" class="RktStxLink" data-pltdoc="x">#%expression</a></span>, <span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span>, and <span class="RktSym"><a href="Locations____variable-reference.html#%28form._%28%28quote._~23~25kernel%29._~23~25variable-reference%29%29" class="RktStxLink" data-pltdoc="x">#%variable-reference</a></span>
+are implicitly added to <span class="RktVar">stop-ids</span>. Expansion proceeds recursively, stopping when the
+expander encounters any of the forms in <span class="RktVar">stop-ids</span>, and the result is the
+partially-expanded form.</p><p>When the expander would normally implicitly introduce a <span class="RktSym">#%app</span>, <span class="RktSym">#%datum</span>,
+or <span class="RktSym">#%top</span> identifier as described in <a href="syntax-model.html#%28part._expand-steps%29" data-pltdoc="x">Expansion Steps</a>, it checks to see if an
+identifier with the same <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a> as the one to be introduced appears in
+<span class="RktVar">stop-ids</span>. If so, the identifier is <span class="emph">not</span> introduced; the result of expansion is
+the bare application, literal data expression, or unbound identifier rather than one wrapped in
+the respective explicit form.</p><p>When <span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-module-begin%29%29" class="RktStxLink" data-pltdoc="x">#%plain-module-begin</a></span> is not in <span class="RktVar">stop-ids</span>, the
+<span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-module-begin%29%29" class="RktStxLink" data-pltdoc="x">#%plain-module-begin</a></span> transformer detects and expands sub-forms (such as
+<span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span>) regardless of the identifiers presence in <span class="RktVar">stop-ids</span>.</p><p>Expansion does not replace the scopes in a local-variable
+reference to match the binding identifier.</p></li><li><p>If <span class="RktVar">stop-ids</span> is <span class="RktVal">#f</span> instead of a list, then <span class="RktVar">stx</span> is expanded only as
+long as the outermost form of <span class="RktVar">stx</span> is a macro (i.e. expansion does <span class="emph">not</span> proceed
+to sub-expressions, and it does not replace the scopes in a local-variable reference to match the
+binding identifier). The <span class="RktSym">#%app</span>, <span class="RktSym">#%datum</span>, and <span class="RktSym">#%top</span> identifiers are
+never introduced.</p></li></ul><p>Independent of <span class="RktVar">stop-ids</span>, when <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span> encounters an identifier that has a local
+binding but no binding in the current expansion context, the variable is left as-is (as opposed to
+triggering an &ldquo;out of context&rdquo; syntax error).</p><p>When <span class="RktVar">context-v</span> is <span class="RktVal">'</span><span class="RktVal">module-begin</span>, and the result of
+expansion is a <span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-module-begin%29%29" class="RktStxLink" data-pltdoc="x">#%plain-module-begin</a></span> form, then a
+<span class="RktVal">'</span><span class="RktVal">submodule</span> <a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax property</span></a> is added to each enclosed
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> form (but not <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> forms) in the same way as by
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> expansion.</p><p>If the <span class="RktVar">intdef-ctx</span> argument is an internal-definition context, its <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">bindings</span></a> and
+<a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">bindings</span></a> from all <a href="stxtrans.html#%28tech._parent._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">parent internal-definition contexts</span></a> are added to the
+<a href="syntax-model.html#%28tech._local._binding._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">local binding context</span></a> during the dynamic extent of the call to <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span>.
+Additionally, unless <span class="RktVal">#f</span> was provided for the <span class="RktVar">add-scope?</span> argument to
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-make-definition-context%29%29" class="RktValLink" data-pltdoc="x">syntax-local-make-definition-context</a></span> when the internal-definition context was created,
+its <a href="syntax-model.html#%28tech._inside._edge._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">inside-edge scope</span></a> (but <span class="emph">not</span> the scopes of any <a href="stxtrans.html#%28tech._parent._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">parent internal-definition contexts</span></a>) is
+added to the <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> for both <span class="RktVar">stx</span> prior to its expansion and the expansion
+result (because the expansion might introduce bindings or references to internal-definition bindings).</p><p>For backwards compatibility, when <span class="RktVar">intdef-ctx</span> is a list all <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">bindings</span></a> from all of the provided internal-definition
+contexts and their parents are added to the <a href="syntax-model.html#%28tech._local._binding._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">local binding context</span></a>, and the <a href="syntax-model.html#%28tech._inside._edge._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">inside-edge scope</span></a> from
+each context for which <span class="RktVar">add-scope?</span> was not <span class="RktVal">#f</span> is added in the same way.</p><p>Expansion records <a href="syntax-model.html#%28tech._use._site._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">use-site scopes</span></a> for removal from definition bindings. When the
+<span class="RktVar">intdef-ctx</span> argument is an internal-definition context, use-site scopes are recorded
+with that context. When <span class="RktVar">intdef-ctx</span> is <span class="RktVal">#f</span> or (for backwards compatibility) a list,
+use-site scopes are recorded with the current expand context.</p><p>For a particular <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a>, generate a unique
+value and put it into a list for <span class="RktVar">context-v</span>. To allow
+<a href="stxtrans.html#%28tech._liberal._expansion%29" class="techoutside" data-pltdoc="x"><span class="techinside">liberal expansion</span></a> of <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span> forms, the generated value
+should be an instance of a structure with a true value for
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aliberal-define-context%29%29" class="RktValLink" data-pltdoc="x">prop:liberal-define-context</a></span>. If the internal-definition
+context is meant to be self-contained, the list for <span class="RktVar">context-v</span>
+should contain only the generated value; if the internal-definition
+context is meant to splice into an immediately enclosing context, then
+when <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-context%29%29" class="RktValLink" data-pltdoc="x">syntax-local-context</a></span> produces a list, <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span> the
+generated value onto that list.</p><p>When expressions are expanded via <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span> with an
+internal-definition context <span class="RktVar">intdef-ctx</span>, and when the expanded
+expressions are incorporated into an overall form <span class="RktVar">new-stx</span>,
+then typically <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=intdef.html%23%2528def._%2528%2528lib._syntax%252Fintdef..rkt%2529._internal-definition-context-track%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">internal-definition-context-track</a></span> should be
+applied to <span class="RktVar">intdef-ctx</span> and <span class="RktVar">new-stx</span> to provide
+expansion history to external tools.</p><p>This procedure must be called during the
+dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application by the
+expander or while a module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._define-syntax-rule%29%29" class="RktStxLink" data-pltdoc="x">define-syntax-rule</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">do-print</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._define-syntax-rule%29%29" class="RktStxLink" data-pltdoc="x">define-syntax-rule</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hello</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">do-print</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello ~a"</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">partly</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">hello</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">expression</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">do-print</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">fully</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">hello</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">expression</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"partly expanded: ~s\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktSym">partly</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"fully expanded: ~s\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-~3edatum%29%29" class="RktValLink" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fully</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">fully</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">partly expanded: (do-print "hello ~a" 1)</span></p></td></tr><tr><td><p><span class="RktOut">fully expanded: (printf "hello ~a" 1)</span></p></td></tr><tr><td><p><span class="RktOut">hello 1</span></p></td></tr></table></td></tr></table></blockquote></div></p><p>This procedure&rsquo;s binding is provided as
+<a href="modprotect.html#%28tech._protected%29" class="techoutside" data-pltdoc="x"><span class="techinside">protected</span></a> in the sense of <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._protect-out%29%29" class="RktStxLink" data-pltdoc="x">protect-out</a></span>.</p><p class="SHistory">Changed in version 6.0.1.3 of package <span class="stt">base</span>: Changed treatment of <span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span>
+so that it is never introduced as
+an explicit wrapper.<br/>Changed in version 6.0.90.27: Loosened the contract on the <span class="RktVar">intdef-ctx</span> argument to
+allow an empty list.<br/>Changed in version 8.2.0.4: Changined binding to protected.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-expand-expression))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-expand-expression%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-expand-expression</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">opaque-only?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktVar">opaque-only?</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">opaque-only?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span> given <span class="RktVal">'</span><span class="RktVal">expression</span> and an empty
+stop list, but with two results: a syntax object for the fully
+expanded expression, and a syntax object whose content is opaque.</div></p><p>The latter can be used in place of the former (perhaps in a larger
+expression produced by a macro transformer), and when the macro
+expander encounters the opaque object, it substitutes the fully
+expanded expression without re-expanding it; the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax</a></span> exception is raised if the expansion context includes
+<a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scopes</span></a> that were not present for the original expansion, in
+which case re-expansion might produce different results. Consistent
+use of <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-expand-expression%29%29" class="RktValLink" data-pltdoc="x">syntax-local-expand-expression</a></span> and the opaque object
+thus avoids quadratic expansion times when local expansions are
+nested.</p><p>If <span class="RktVar">opaque-only?</span> is true, then the first result is <span class="RktVal">#f</span>
+instead of the expanded expression. Obtaining only the second, opaque
+result can be more efficient in some expansion contexts.</p><p>Unlike <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span>, <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-expand-expression%29%29" class="RktValLink" data-pltdoc="x">syntax-local-expand-expression</a></span>
+normally produces an expanded expression that contains no
+<span class="RktSym"><a href="__expression.html#%28form._%28%28quote._~23~25kernel%29._~23~25expression%29%29" class="RktStxLink" data-pltdoc="x">#%expression</a></span> forms. However, if
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-expand-expression%29%29" class="RktValLink" data-pltdoc="x">syntax-local-expand-expression</a></span> is used within an expansion
+that is triggered by an enclosing <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span> call, then the
+result of <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-expand-expression%29%29" class="RktValLink" data-pltdoc="x">syntax-local-expand-expression</a></span> can include
+<span class="RktSym"><a href="__expression.html#%28form._%28%28quote._~23~25kernel%29._~23~25expression%29%29" class="RktStxLink" data-pltdoc="x">#%expression</a></span> forms.</p><p><div class="SIntrapara">This procedure must be called during the
+dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application by the
+expander or while a module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div><div class="SIntrapara">This procedure&rsquo;s binding is provided as
+<a href="modprotect.html#%28tech._protected%29" class="techoutside" data-pltdoc="x"><span class="techinside">protected</span></a> in the sense of <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._protect-out%29%29" class="RktStxLink" data-pltdoc="x">protect-out</a></span>.</div></p><p class="SHistory">Changed in version 6.90.0.13 of package <span class="stt">base</span>: Added the <span class="RktVar">opaque-only?</span> argument.<br/>Changed in version 8.2.0.4: Changined binding to protected.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._local-transformer-expand))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-transformer-expand%29%29" class="RktValDef RktValLink" data-pltdoc="x">local-transformer-expand</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">context-v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">stop-ids</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">intdef-ctx</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">context-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">expression</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">top-level</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stop-ids</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">intdef-ctx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span>, but <span class="RktVar">stx</span> is expanded as a
+transformer expression instead of a run-time expression.</div></p><p>Any lifted expressions&#8212;<wbr></wbr>from calls to
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-expression%29%29" class="RktValLink" data-pltdoc="x">syntax-local-lift-expression</a></span> during the expansion of
+<span class="RktVar">stx</span>&#8212;<wbr></wbr>are captured in the result. If <span class="RktVar">context-v</span> is
+<span class="RktVal">'</span><span class="RktVal">top-level</span>, then lifts are captured in a <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> form,
+otherwise lifts are captured in <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span> forms. If no
+expressions are lifted during expansion, then no <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span>
+or <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span> wrapper is added.</p><p>This procedure&rsquo;s binding is provided as
+<a href="modprotect.html#%28tech._protected%29" class="techoutside" data-pltdoc="x"><span class="techinside">protected</span></a> in the sense of <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._protect-out%29%29" class="RktStxLink" data-pltdoc="x">protect-out</a></span>.</p><p class="SHistory">Changed in version 6.5.0.3 of package <span class="stt">base</span>: Allow and capture lifts in a
+<span class="RktVal">'</span><span class="RktVal">top-level</span> context.<br/>Changed in version 8.2.0.4: Changined binding to protected.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._local-expand/capture-lifts))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%2Fcapture-lifts%29%29" class="RktValDef RktValLink" data-pltdoc="x">local-expand/capture-lifts</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">context-v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">stop-ids</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">intdef-ctx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">lift-ctx</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">context-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">expression</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">top-level</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">module</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">module-begin</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stop-ids</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">intdef-ctx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lift-ctx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._gensym%29%29" class="RktValLink" data-pltdoc="x">gensym</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">lifts</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span>, but the result is a syntax object that
+represents a <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> expression. Lifted expressions&#8212;<wbr></wbr>from
+calls to <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-expression%29%29" class="RktValLink" data-pltdoc="x">syntax-local-lift-expression</a></span> during the expansion of
+<span class="RktVar">stx</span>&#8212;<wbr></wbr>appear with their identifiers in <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span>
+forms, and the expansion of <span class="RktVar">stx</span> is the last expression in the
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span>. The <span class="RktVar">lift-ctx</span> value is reported by
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-context%29%29" class="RktValLink" data-pltdoc="x">syntax-local-lift-context</a></span> during local expansion. The lifted
+expressions are not expanded, but instead left as provided in the
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> form.</div></p><p>If <span class="RktVar">context-v</span> is <span class="RktVal">'</span><span class="RktVal">top-level</span> or <span class="RktVal">'</span><span class="RktVal">module</span>, then
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> forms can appear in the result as added via
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-module%29%29" class="RktValLink" data-pltdoc="x">syntax-local-lift-module</a></span>. If <span class="RktVar">context-v</span> is
+<span class="RktVal">'</span><span class="RktVal">module</span>, then <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> forms can appear, too.</p><p>This procedure&rsquo;s binding is provided as
+<a href="modprotect.html#%28tech._protected%29" class="techoutside" data-pltdoc="x"><span class="techinside">protected</span></a> in the sense of <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._protect-out%29%29" class="RktStxLink" data-pltdoc="x">protect-out</a></span>.</p><p class="SHistory">Changed in version 8.2.0.4 of package <span class="stt">base</span>: Changined binding to protected.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._local-transformer-expand/capture-lifts))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-transformer-expand%2Fcapture-lifts%29%29" class="RktValDef RktValLink" data-pltdoc="x">local-transformer-expand/capture-lifts</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">context-v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">stop-ids</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">intdef-ctx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">lift-ctx</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">context-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">expression</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">top-level</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stop-ids</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">intdef-ctx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lift-ctx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._gensym%29%29" class="RktValLink" data-pltdoc="x">gensym</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">lifts</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%2Fcapture-lifts%29%29" class="RktValLink" data-pltdoc="x">local-expand/capture-lifts</a></span>, but <span class="RktVar">stx</span> is expanded
+as a transformer expression instead of a run-time expression. Lifted
+expressions are reported as <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span> forms (in the
+transformer environment).</div></p><p>This procedure&rsquo;s binding is provided as
+<a href="modprotect.html#%28tech._protected%29" class="techoutside" data-pltdoc="x"><span class="techinside">protected</span></a> in the sense of <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._protect-out%29%29" class="RktStxLink" data-pltdoc="x">protect-out</a></span>.</p><p class="SHistory">Changed in version 8.2.0.4 of package <span class="stt">base</span>: Changined binding to protected.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-apply-transformer))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-apply-transformer%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-apply-transformer</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">transformer</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">binding-id</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">context-v</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">intdef-ctx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">transformer</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">binding-id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">context-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">expression</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">top-level</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">module</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">module-begin</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">intdef-ctx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Applies the procedure <span class="RktVar">transformer</span> to the <span class="RktVar">v</span>s in a new
+expansion <a href="syntax-model.html#%28tech._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">context</span></a> and <a href="syntax-model.html#%28tech._local._binding._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">local binding context</span></a>. Adds and flips
+<a href="syntax-model.html#%28tech._macro._introduction._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">macro-introduction scopes</span></a> and <a href="syntax-model.html#%28tech._use._site._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">use-site scopes</span></a> on the arguments
+and return values in the same manner as <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application.
+The arguments and returns may be any value; scopes are manipulated only for
+those that are syntax objects.</div></p><p>The <span class="RktVar">context-v</span> argument is as in <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span>, and the
+<span class="RktVar">intdef-ctx</span> is an <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a> value or
+<span class="RktVal">#f</span>. The <span class="RktVar">binding-id</span> specifies a <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a> associated with
+the <span class="RktVar">transformer</span>, which the expander uses to determine whether to add
+<a href="syntax-model.html#%28tech._use._site._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">use-site scopes</span></a> and which <a href="modprotect.html#%28tech._code._inspector%29" class="techoutside" data-pltdoc="x"><span class="techinside">code inspector</span></a> to use during
+expansion.</p><p>This procedure must be called during the
+dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application by the
+expander or while a module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p class="SHistory">Added in version 8.2.0.7 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._internal-definition-context~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">internal-definition-context?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is an <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition
+context</span></a>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-make-definition-context))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-make-definition-context%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-make-definition-context</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">parent-ctx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">add-scope?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">parent-ctx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">add-scope?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates an opaque <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a> value to be used with <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span> and
+other functions. A transformer should create one context for each set of internal definitions to be
+expanded.</div></p><p>Before expanding forms whose lexical context should include the definitions, the transformer
+should use <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-add-scopes%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context-add-scopes</a></span> to apply the context&rsquo;s scopes to the syntax.
+Calls to procedures such as <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span> to expand the forms should
+provide the <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a> value as an argument.</p><p>After discovering an internal <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span> or <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span> form, use
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-bind-syntaxes%29%29" class="RktValLink" data-pltdoc="x">syntax-local-bind-syntaxes</a></span> to add <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">bindings</span></a> to the context.</p><p>An <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a> internally creates an <a href="syntax-model.html#%28tech._outside._edge._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">outside-edge
+scope</span></a> and an <a href="syntax-model.html#%28tech._inside._edge._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">inside-edge scope</span></a> to represent the context. The
+<a href="syntax-model.html#%28tech._inside._edge._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">inside-edge scope</span></a> is added to any form that is expanded within the
+context or that appears as the result of a (partial) expansion within the
+context.  For backward compatibility, providing <span class="RktVal">#f</span> for
+<span class="RktVar">add-scope?</span> disables this behavior.</p><p>If <span class="RktVar">parent-ctx</span> is not <span class="RktVal">#f</span>, then <span class="RktVar">parent-ctx</span> is made the <a name="(tech._parent._internal._definition._context)"></a><span style="font-style: italic">parent
+internal-definition context</span> for the new internal-definition context. Whenever the new context&#8217;s
+<a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">bindings</span></a> are added to the <a href="syntax-model.html#%28tech._local._binding._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">local binding context</span></a> (e.g. by providing the context to
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span>, <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-bind-syntaxes%29%29" class="RktValLink" data-pltdoc="x">syntax-local-bind-syntaxes</a></span>, or <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value</a></span>), then the
+bindings from <span class="RktVar">parent-ctx</span> are also added as well. If <span class="RktVar">parent-ctx</span> was also created with a
+<a href="stxtrans.html#%28tech._parent._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">parent internal-definition context</span></a>, <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">bindings</span></a> from its parent are also added, and so on
+recursively. Note that the <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scopes</span></a> of parent contexts are <span class="emph">not</span> added implicitly, only the
+<a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">bindings</span></a>, even when the <a href="syntax-model.html#%28tech._inside._edge._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">inside-edge scope</span></a> of the child context would be implicitly added. If the
+<a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scopes</span></a> of parent definition contexts should be added, the parent contexts must be provided
+explicitly.</p><p>Additionally, if the created definition context is intended to be spliced into a surrounding
+definition context, the surrounding context should always be provided for the <span class="RktVar">parent-ctx</span>
+argument to ensure the necessary <a href="syntax-model.html#%28tech._use._site._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">use-site scopes</span></a> are added to macros expanded in the context.
+Otherwise, expansion of nested definitions can be inconsistent with the expansion of definitions in
+the surrounding context.</p><p>An <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a> also tracks <a href="syntax-model.html#%28tech._use._site._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">use-site scopes</span></a> created during expansion
+within the definition context, so that they can be removed from bindings created in the context,
+at <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-identifier-as-binding%29%29" class="RktValLink" data-pltdoc="x">syntax-local-identifier-as-binding</a></span>, and at <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-splice-binding-identifier%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context-splice-binding-identifier</a></span>.</p><p>The scopes associated with a new definition context are pruned from
+<span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span> forms only when it is created during the dynamic
+extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application or in a
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> form (potentially nested) within a module
+being expanded.</p><p>This procedure must be called during the
+dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application by the
+expander or while a module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p class="SHistory">Changed in version 6.3 of package <span class="stt">base</span>: Added the <span class="RktVar">add-scope?</span> argument,
+and made calling
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-seal%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context-seal</a></span>
+no longer necessary.<br/>Changed in version 8.2.0.7: Added the <a href="syntax-model.html#%28tech._outside._edge._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">outside-edge scope</span></a> and <a href="syntax-model.html#%28tech._use._site._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">use-site scope</span></a>
+tracking behaviors.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._internal-definition-context-add-scopes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-add-scopes%29%29" class="RktValDef RktValLink" data-pltdoc="x">internal-definition-context-add-scopes</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">intdef-ctx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">stx</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">intdef-ctx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Adds the <a href="syntax-model.html#%28tech._outside._edge._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">outside-edge scope</span></a> and <a href="syntax-model.html#%28tech._inside._edge._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">inside-edge scope</span></a> for
+<span class="RktVar">intdef-ctx</span> to <span class="RktVar">stx</span>.</div></p><p>Use this function to apply the definition context scopes to syntax that
+originates within the definition context before expansion.</p><p class="SHistory">Added in version 8.2.0.7 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top" colspan="3"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._internal-definition-context-splice-binding-identifier))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-splice-binding-identifier%29%29" class="RktValDef RktValLink" data-pltdoc="x">internal-definition-context-splice-binding-identifier</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">intdef-ctx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">id</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">intdef-ctx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Removes scopes associated with the <span class="RktVar">intdef-ctx</span> from <span class="RktVar">id</span>: the
+<a href="syntax-model.html#%28tech._outside._edge._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">outside-edge scope</span></a>, the <a href="syntax-model.html#%28tech._inside._edge._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">inside-edge scope</span></a>, and <a href="syntax-model.html#%28tech._use._site._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">use-site
+scopes</span></a> created by expansions within the definition context.</div></p><p>Use when splicing a binding originating within the <span class="RktVar">intdef-ctx</span> into a
+surrounding context.</p><p class="SHistory">Added in version 8.2.0.7 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-bind-syntaxes))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-bind-syntaxes%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-bind-syntaxes</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">id-list</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">expr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">intdef-ctx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">extra-intdef-ctxs</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id-list</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">intdef-ctx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">extra-intdef-ctxs</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Binds each identifier in <span class="RktVar">id-list</span> within the
+<a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a> represented by <span class="RktVar">intdef-ctx</span>, where
+<span class="RktVar">intdef-ctx</span> is the result of
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-make-definition-context%29%29" class="RktValLink" data-pltdoc="x">syntax-local-make-definition-context</a></span>.
+Returns identifiers with <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> matching the new bindings.</div></p><p>For backwards compatibility, the <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> of each element of <span class="RktVar">extra-intdef-ctxs</span>
+is also added to each identifier in <span class="RktVar">id-list</span> before binding.</p><p>Supply <span class="RktVal">#f</span> for
+<span class="RktVar">expr</span> when the identifiers correspond to
+<span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span> bindings, and supply a compile-time expression
+when the identifiers correspond to <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span> bindings.
+In the latter case, the number of values produced by the expression should
+match the number of identifiers, otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3aarity%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:arity</a></span> exception is raised.</p><p>When <span class="RktVar">expr</span> is not <span class="RktVal">#f</span>, it is expanded in an <a href="syntax-model.html#%28tech._expression._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">expression context</span></a> and evaluated in
+the current <a href="syntax-model.html#%28tech._transformer._environment%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer environment</span></a>. In this case, the <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">bindings</span></a> and <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical
+information</span></a> from both <span class="RktVar">intdef-ctx</span> and <span class="RktVar">extra-intdef-ctxs</span> are used to enrich
+<span class="RktVar">expr</span>&#8217;s <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> and extend the <a href="syntax-model.html#%28tech._local._binding._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">local binding context</span></a> in the same way
+as the fourth argument to <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span>. If <span class="RktVar">expr</span> is <span class="RktVal">#f</span>, the value provided
+for <span class="RktVar">extra-intdef-ctxs</span> is ignored.</p><p>This procedure must be called during the
+dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application by the
+expander or while a module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p class="SHistory">Changed in version 6.90.0.27 of package <span class="stt">base</span>: Added the <span class="RktVar">extra-intdef-ctxs</span> argument.<br/>Changed in version 8.2.0.7: Changed the return value from <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a> to the list of bound identifiers.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._internal-definition-context-binding-identifiers))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-binding-identifiers%29%29" class="RktValDef RktValLink" data-pltdoc="x">internal-definition-context-binding-identifiers</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">intdef-ctx</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">intdef-ctx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of all binding identifiers registered for
+<span class="RktVar">intdef-ctx</span> through <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-bind-syntaxes%29%29" class="RktValLink" data-pltdoc="x">syntax-local-bind-syntaxes</a></span>. Each
+identifier in the returned list includes the <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition
+context</span></a>&rsquo;s <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a>.</div></p><p class="SHistory">Added in version 6.3.0.4 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._internal-definition-context-introduce))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-introduce%29%29" class="RktValDef RktValLink" data-pltdoc="x">internal-definition-context-introduce</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">intdef-ctx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">mode</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">intdef-ctx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">flip</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">add</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">remove</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">flip</span></td></tr></table></blockquote></div><div class="SIntrapara">Flips, adds, or removes (depending on <span class="RktVar">mode</span>) the <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a>
+for <span class="RktVar">intdef-ctx</span> for all parts of <span class="RktVar">stx</span>.</div></p><p>This function is provided for backwards compatibility;
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-add-scopes%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context-add-scopes</a></span> and
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-splice-binding-identifier%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context-splice-binding-identifier</a></span> are preferred.</p><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._internal-definition-context-seal))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-seal%29%29" class="RktValDef RktValLink" data-pltdoc="x">internal-definition-context-seal</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">intdef-ctx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">intdef-ctx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">For backward compatibility only; has no effect.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._identifier-remove-from-definition-context))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._identifier-remove-from-definition-context%29%29" class="RktValDef RktValLink" data-pltdoc="x">identifier-remove-from-definition-context</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">id-stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">intdef-ctx</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">intdef-ctx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Removes all of the <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scopes</span></a> of <span class="RktVar">intdef-ctx</span> (or of each
+element in a list <span class="RktVar">intdef-ctx</span>) from <span class="RktVar">id-stx</span>.</div></p><p>The <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._identifier-remove-from-definition-context%29%29" class="RktValLink" data-pltdoc="x">identifier-remove-from-definition-context</a></span> function is
+provided for backward compatibility; the
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-splice-binding-identifier%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context-splice-binding-identifier</a></span> function is preferred.</p><p class="SHistory">Changed in version 6.3 of package <span class="stt">base</span>: Simplified the operation to <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a> removal.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._prop~3aexpansion-contexts))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aexpansion-contexts%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:expansion-contexts</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property</span></a> to constrain the use of macro
+<a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformers</span></a> and <a href="syntax-model.html#%28tech._rename._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">rename transformers</span></a>. The property&rsquo;s
+value must be a list of symbols, where the allowed symbols are
+<span class="RktVal">'</span><span class="RktVal">expression</span>, <span class="RktVal">'</span><span class="RktVal">top-level</span>, <span class="RktVal">'</span><span class="RktVal">module</span>,
+<span class="RktVal">'</span><span class="RktVal">module-begin</span>, and <span class="RktVal">'</span><span class="RktVal">definition-context</span>. Each symbol
+corresponds to an expansion context in the same way as for
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span> or as reported by <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-context%29%29" class="RktValLink" data-pltdoc="x">syntax-local-context</a></span>,
+except that <span class="RktVal">'</span><span class="RktVal">definition-context</span> is used (instead of a list)
+to represent an <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a>.</div></p><p><div class="SIntrapara">If an identifier is bound to a transformer whose list does not include
+a symbol for a particular use of the identifier, then the use is
+adjusted as follows:
+</div><div class="SIntrapara"><ul><li><p>In a <span class="RktVal">'</span><span class="RktVal">module-begin</span> context, then the use is wrapped in
+a <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> form.</p></li><li><p>In a <span class="RktVal">'</span><span class="RktVal">module</span>, <span class="RktVal">'</span><span class="RktVal">top-level</span>,
+<span class="RktVal">'</span><span class="RktVal">internal-definition</span> or context, if
+<span class="RktVal">'</span><span class="RktVal">expression</span> is present in the list, then the use is
+wrapped in an <span class="RktSym"><a href="__expression.html#%28form._%28%28quote._~23~25kernel%29._~23~25expression%29%29" class="RktStxLink" data-pltdoc="x">#%expression</a></span> form.</p></li><li><p>Otherwise, a syntax error is reported.</p></li></ul></div></p><p>The <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aexpansion-contexts%29%29" class="RktValLink" data-pltdoc="x">prop:expansion-contexts</a></span> property is most useful in
+combination with <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3arename-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:rename-transformer</a></span>, since a general
+<a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> procedure can use <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-context%29%29" class="RktValLink" data-pltdoc="x">syntax-local-context</a></span>.
+Furthermore, a <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aexpansion-contexts%29%29" class="RktValLink" data-pltdoc="x">prop:expansion-contexts</a></span> property makes the
+most sense when a <a href="syntax-model.html#%28tech._rename._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">rename transformer</span></a>&rsquo;s identifier has the
+<span class="RktVal">'</span><span class="RktVal">not-free-identifier=?</span> property, otherwise a definition of
+the binding creates a binding alias that effectively routes around the
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aexpansion-contexts%29%29" class="RktValLink" data-pltdoc="x">prop:expansion-contexts</a></span> property.</p><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-value))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-value</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">id-stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">failure-thunk</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">intdef-ctx</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">failure-thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">intdef-ctx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding value of the identifier <span class="RktVar">id-stx</span> in the context of the
+current expansion. If <span class="RktVar">intdef-ctx</span> is not <span class="RktVal">#f</span>, bindings from all provided definition
+contexts are also considered. Unlike the fourth argument to <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span>, the
+<a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scopes</span></a> associated with the provided definition contexts are <span class="emph">not</span> used to enrich
+<span class="RktVar">id-stx</span>&#8217;s <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a>.</div></p><p>If <span class="RktVar">id-stx</span> is bound to a <a href="syntax-model.html#%28tech._rename._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">rename transformer</span></a> created
+with <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span>, <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value</a></span>
+effectively calls itself with the target of the rename and returns
+that result, instead of the <a href="syntax-model.html#%28tech._rename._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">rename transformer</span></a>.</p><p>If <span class="RktVar">id-stx</span> has no <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding (via
+<span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span>, <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntax%29%29" class="RktStxLink" data-pltdoc="x">let-syntax</a></span>, etc.) in that
+environment, the result is obtained by applying <span class="RktVar">failure-thunk</span>
+if not <span class="RktVal">#f</span>. If <span class="RktVar">failure-thunk</span> is <span class="RktSym"><a href="booleans.html#%28def._%28%28lib._racket%2Fbool..rkt%29._false%29%29" class="RktValLink" data-pltdoc="x">false</a></span>, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>This procedure must be called during the
+dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application by the
+expander or while a module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">swiss-cheeses?</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">transformer</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">swiss-cheeses?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">gruy&#232;re</span><span class="hspace">&nbsp;</span><span class="RktVal">emmental</span><span class="hspace">&nbsp;</span><span class="RktVal">raclette</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">roquefort</span><span class="hspace">&nbsp;</span><span class="RktVal">camembert</span><span class="hspace">&nbsp;</span><span class="RktVal">boursin</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">transformer</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(gruy&#232;re emmental raclette)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">transformer-2</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">something-else</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"no binding"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">transformer-2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">no binding</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nachos</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"nachos~n"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chips</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">nachos</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">transformer-3</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">chips</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">transformer-3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">nachos</span></p></td></tr></table></blockquote></div></p></div></p><p>This procedure&rsquo;s binding is provided as
+<a href="modprotect.html#%28tech._protected%29" class="techoutside" data-pltdoc="x"><span class="techinside">protected</span></a> in the sense of <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._protect-out%29%29" class="RktStxLink" data-pltdoc="x">protect-out</a></span>.</p><p class="SHistory">Changed in version 6.90.0.27 of package <span class="stt">base</span>: Changed <span class="RktVar">intdef-ctx</span> to accept a list of internal-definition
+contexts in addition to a single internal-definition context or
+<span class="RktVal">#f</span>.<br/>Changed in version 8.2.0.4: Changed binding to protected.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-value/immediate))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%2Fimmediate%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-value/immediate</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">id-stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">failure-thunk</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">intdef-ctx</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">failure-thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">intdef-ctx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value</a></span>, but the result is normally two
+values. If <span class="RktVar">id-stx</span> is bound to a <a href="syntax-model.html#%28tech._rename._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">rename transformer</span></a>,
+the results are the rename transformer and the identifier in the
+transformer. <span class="refelem"><span class="refcolumn"><span class="refcontent">Beware that <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> on an
+<span class="RktVar">id</span> bound to a <a href="syntax-model.html#%28tech._rename._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">rename transformer</span></a> may export the
+target of the rename instead of <span class="RktVar">id</span>. See
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span> for more information.</span></span></span> If
+<span class="RktVar">id-stx</span> is not bound to a <a href="syntax-model.html#%28tech._rename._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">rename transformer</span></a>, then the
+results are the value that <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value</a></span> would produce
+and <span class="RktVal">#f</span>.</div></p><p>If <span class="RktVar">id-stx</span> has no transformer binding, then
+<span class="RktVar">failure-thunk</span> is called (and it can return any number of
+values), or an exception is raised if <span class="RktVar">failure-thunk</span> is
+<span class="RktVal">#f</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">agent-007</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">james-bond</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show-secret-identity</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">syntax-parse</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">name:id</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">orig-name</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%2Fimmediate%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value/immediate</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#`</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">name</span><span class="hspace">&nbsp;</span><span class="RktVal">#,</span><span class="RktVal">orig-name</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">show-secret-identity</span><span class="hspace">&nbsp;</span><span class="RktSym">agent-007</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(agent-007 james-bond)</span></p></td></tr></table></blockquote></div></p><p>This procedure&rsquo;s binding is provided as
+<a href="modprotect.html#%28tech._protected%29" class="techoutside" data-pltdoc="x"><span class="techinside">protected</span></a> in the sense of <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._protect-out%29%29" class="RktStxLink" data-pltdoc="x">protect-out</a></span>.</p><p class="SHistory">Changed in version 8.2.0.4 of package <span class="stt">base</span>: Changined binding to protected.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-lift-expression))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-expression%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-lift-expression</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a fresh identifier, and cooperates with the <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>,
+<span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span>, <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span>,
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span>, and top-level expanders to bind the
+generated identifier to the expression <span class="RktVar">stx</span>.</div></p><p>A run-time expression within a module is lifted to the module&rsquo;s top
+level, just before the expression whose expansion requests the
+lift. Similarly, a run-time expression outside of a module is lifted
+to a top-level definition. A compile-time expression in a
+<span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span> or <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span> binding is
+lifted to a <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span> wrapper around the corresponding right-hand
+side of the binding. A compile-time expression within
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> is lifted to a <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span>
+declaration just before the requesting expression within the
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span>.</p><p>Other syntactic forms can capture lifts by using
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%2Fcapture-lifts%29%29" class="RktValLink" data-pltdoc="x">local-expand/capture-lifts</a></span> or
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-transformer-expand%2Fcapture-lifts%29%29" class="RktValLink" data-pltdoc="x">local-transformer-expand/capture-lifts</a></span>.</p><p><div class="SIntrapara">This procedure must be called during the
+dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application by the
+expander or while a module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div><div class="SIntrapara"> In addition, this procedure can be called only when
+a lift target is available, as indicated by
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming-with-lifts~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming-with-lifts?</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-lift-values-expression))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-values-expression%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-lift-values-expression</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-expression%29%29" class="RktValLink" data-pltdoc="x">syntax-local-lift-expression</a></span>, but binds the result to
+<span class="RktVar">n</span> identifiers, and returns a list of the <span class="RktVar">n</span>
+identifiers.</div></p><p>This procedure must be called during the
+dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application by the
+expander or while a module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-lift-context))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-context%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-lift-context</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns a value that represents the target for expressions lifted via
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-expression%29%29" class="RktValLink" data-pltdoc="x">syntax-local-lift-expression</a></span>. That is, for different
+transformer calls for which this procedure returns the same value (as
+determined by <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>), lifted expressions for the two
+transformer are moved to the same place. Thus, the result is useful
+for caching lift information to avoid redundant lifts.</div></p><p>This procedure must be called during the
+dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application by the
+expander or while a module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-lift-module))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-module%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-lift-module</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Cooperates with the <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> form or top-level expansion to add
+<span class="RktVar">stx</span> as a module declaration in the enclosing module or top-level.
+The <span class="RktVar">stx</span> form must start with <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> or <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span>,
+where the latter is only allowed within the expansion of a module.</div></p><p>The module is not immediately declared when
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-module%29%29" class="RktValLink" data-pltdoc="x">syntax-local-lift-module</a></span> returns. Instead, the module
+declaration is recorded for processing when expansion returns to the
+enclosing module body or top-level sequence.</p><p><div class="SIntrapara">This procedure must be called during the
+dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application by the
+expander or while a module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div><div class="SIntrapara"> If the current expression being transformed is not
+within a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> form or within a top-level expansion, then
+the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. If <span class="RktVar">stx</span> form does not start with
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> or <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span>, or if it starts with <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span>
+in a top-level context, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-lift-module-end-declaration))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-module-end-declaration%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-lift-module-end-declaration</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Cooperates with the <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> form to insert <span class="RktVar">stx</span> as
+a top-level declaration at the end of the module currently being
+expanded. If the current expression being
+transformed is in <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 0 and not in the module top-level, then <span class="RktVar">stx</span> is
+eventually expanded in an expression context. If the current expression being
+transformed is in a higher <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> (i.e., nested within some
+number of <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span>es within a module top-level), then the lifted declaration
+is placed at the very end of the module (under a suitable number of
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span>es), instead of merely the end of the
+enclosing <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span>.</div></p><p><div class="SIntrapara">This procedure must be called during the
+dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application by the
+expander or while a module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div><div class="SIntrapara"> If the current expression being transformed is not
+within a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> form (see <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming-module-expression~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming-module-expression?</a></span>),
+then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-lift-require))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-require%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-lift-require</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">raw-require-spec</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">stx</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">raw-require-spec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Lifts a <span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25require%29%29" class="RktStxLink" data-pltdoc="x">#%require</a></span> form corresponding to
+<span class="RktVar">raw-require-spec</span> (either as a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> or datum)
+to the top-level or to the top of the module currently being expanded
+ or to an enclosing <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span>.</div></p><p>The resulting syntax object is the same as <span class="RktVar">stx</span>, except that a
+fresh <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a> is added. The same <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a> is
+added to the lifted <span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25require%29%29" class="RktStxLink" data-pltdoc="x">#%require</a></span> form, so that the
+<span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25require%29%29" class="RktStxLink" data-pltdoc="x">#%require</a></span> form can bind uses of imported identifiers in the
+resulting syntax object (assuming that the lexical information of
+<span class="RktVar">stx</span> includes the binding environment into which the
+<span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25require%29%29" class="RktStxLink" data-pltdoc="x">#%require</a></span> is lifted).</p><p>If <span class="RktVar">raw-require-spec</span> and <span class="RktVar">stx</span> are part of the input to
+a transformer, then typically <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-introduce%29%29" class="RktValLink" data-pltdoc="x">syntax-local-introduce</a></span> should be
+applied to each before passing them to
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-require%29%29" class="RktValLink" data-pltdoc="x">syntax-local-lift-require</a></span>, and then
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-introduce%29%29" class="RktValLink" data-pltdoc="x">syntax-local-introduce</a></span> should be applied to the result of
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-require%29%29" class="RktValLink" data-pltdoc="x">syntax-local-lift-require</a></span>. Otherwise, marks added
+by the macro expander can prevent access to the new imports.</p><p>This procedure must be called during the
+dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application by the
+expander or while a module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p class="SHistory">Changed in version 6.90.0.27 of package <span class="stt">base</span>: Changed the <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a> added to inputs from a
+macro-introduction scope to one that does not affect whether or
+not the resulting syntax is considered original as reported by
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-original~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-original?</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-lift-provide))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-provide%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-lift-provide</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">raw-provide-spec-stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">raw-provide-spec-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Lifts a <span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25provide%29%29" class="RktStxLink" data-pltdoc="x">#%provide</a></span> form corresponding to
+<span class="RktVar">raw-provide-spec-stx</span> to the top of the module currently being
+expanded or to an enclosing <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span>.</div></p><p><div class="SIntrapara">This procedure must be called during the
+dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application by the
+expander or while a module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div><div class="SIntrapara"> If the current expression being transformed is not
+within a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> form (see <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming-module-expression~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming-module-expression?</a></span>),
+then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-name))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-name%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-name</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns an inferred name for the expression position being
+transformed, or <span class="RktVal">#f</span> if no such name is available. A name is
+normally a symbol or an identifier. See also <a href="syntax-model.html#%28part._infernames%29" data-pltdoc="x">Inferred Value Names</a>.</div></p><p>This procedure must be called during the
+dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application by the
+expander or while a module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-context))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-context%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-context</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">expression</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">top-level</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">module</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">module-begin</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an indication of the context for expansion that triggered a
+<a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> call. See <a href="syntax-model.html#%28part._expand-context-model%29" data-pltdoc="x">Expansion Context</a>
+for more information on contexts.</div></p><p>The symbol results indicate that the expression is being expanded for
+an <a href="syntax-model.html#%28tech._expression._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">expression context</span></a>, a <a href="syntax-model.html#%28tech._top._level._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level context</span></a>, a
+<a href="syntax-model.html#%28tech._module._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">module context</span></a>, or a <a href="syntax-model.html#%28tech._module._begin._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">module-begin context</span></a>.</p><p>A list result indicates expansion in an <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition
+context</span></a>. The identity of the list&rsquo;s first element (i.e., its
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>ness) reflects the identity of the internal-definition
+context; in particular two transformer expansions receive the same
+first value if and only if they are invoked for the same
+<a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a>. Later values in the list similarly
+identify <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition contexts</span></a> that are still being expanded,
+and that required the expansion of nested internal-definition
+contexts.</p><p>This procedure must be called during the
+dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application by the
+expander or while a module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-phase-level))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-phase-level%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-phase-level</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">During the dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application
+by the expander, the result is the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> of the form
+being expanded. Otherwise, the result is <span class="RktVal">0</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">a macro bound at phase 0</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">print-phase-level</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"phase level: ~a~n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-phase-level%29%29" class="RktValLink" data-pltdoc="x">syntax-local-phase-level</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-meta%29%29" class="RktStxLink" data-pltdoc="x">for-meta</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">a macro bound at phase 1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">print-phase-level</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"phase level: ~a~n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-phase-level%29%29" class="RktValLink" data-pltdoc="x">syntax-local-phase-level</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">print-phase-level</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">phase level: 0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">print-phase-level</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">phase level: 1</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-module-exports))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-module-exports%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-module-exports</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">mod-path</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">mod-path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._syntax%2Fc%29%29" class="RktValLink" data-pltdoc="x">syntax/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns an association list from <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> and
+<a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a> combinations to lists of symbols,
+where the symbols are the names of <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span>d
+bindings from <span class="RktVar">mod-path</span> at the corresponding <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>.</div></p><p>This procedure must be called during the
+dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application by the
+expander or while a module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p class="SHistory">Changed in version 8.2.0.3 of package <span class="stt">base</span>: Generalized result to phase&ndash;space combinations.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-submodules))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-submodules%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-submodules</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of submodule names that are declared via
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> (as opposed to <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span>) in the current
+expansion context.</div></p><p>This procedure must be called during the
+dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application by the
+expander or while a module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-module-interned-scope-symbols))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-module-interned-scope-symbols%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-module-interned-scope-symbols</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of distinct <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> symbols corresponding to
+<a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding spaces</span></a> that have been used, so far, for binding within
+the current expansion context&rsquo;s module or top-level namespace. The
+result is conservative in the sense that it may include additional
+symbols that have not been used in the current module or namespace.</div></p><p>The current implementation returns all symbols for <a href="eval-model.html#%28tech._reachable%29" class="techoutside" data-pltdoc="x"><span class="techinside">reachable</span></a>
+interned scopes, but that behavior may change in the future to return
+a less conservative list of symbols.</p><p>This procedure must be called during the
+dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application by the
+expander or while a module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p class="SHistory">Added in version 8.2.0.7 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-get-shadower))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-get-shadower%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-get-shadower</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">id-stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">only-generated?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">only-generated?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Adds <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scopes</span></a> to <span class="RktVar">id-stx</span> so that it refers to bindings
+in the current expansion context or could bind any identifier obtained
+via <span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-get-shadower%29%29" class="RktValLink" data-pltdoc="x">syntax-local-get-shadower</a></span><span class="stt"> </span><span class="RktVar">id-stx</span><span class="RktPn">)</span> in more nested contexts.
+If <span class="RktVar">only-generated?</span> is true, the phase-spanning <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a>
+of the enclosing module or namespace is omitted from the added scopes,
+however, which limits the bindings that can be referenced (and
+therefore avoids certain ambiguous references).</div></p><p>This function is intended for the implementation of
+<span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._syntax-parameterize%29%29" class="RktStxLink" data-pltdoc="x">syntax-parameterize</a></span> and <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._local-require%29%29" class="RktStxLink" data-pltdoc="x">local-require</a></span>.</p><p>This procedure must be called during the
+dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application by the
+expander or while a module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p class="SHistory">Changed in version 6.3 of package <span class="stt">base</span>: Simplified to the minimal functionality
+needed for <span class="RktSym"><a href="stxparam.html#%28form._%28%28lib._racket%2Fstxparam..rkt%29._syntax-parameterize%29%29" class="RktStxLink" data-pltdoc="x">syntax-parameterize</a></span>
+and <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._local-require%29%29" class="RktStxLink" data-pltdoc="x">local-require</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-make-delta-introducer))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-make-delta-introducer%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-make-delta-introducer</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id-stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">For (limited) backward compatibility only; raises <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aunsupported%29%29" class="RktValLink" data-pltdoc="x">exn:fail:unsupported</a></span>.</div></p><p class="SHistory">Changed in version 6.3 of package <span class="stt">base</span>: changed to raise <span class="RktSym">exn:fail:supported</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/base..rkt)._syntax-local-certifier))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._syntax-local-certifier%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-certifier</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">active?</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">active?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">For backward compatibility only; returns a procedure that returns its
+first argument.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-transforming~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-transforming?</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> during the dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax
+transformer</span></a> application by the expander and while a module is being
+<a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-transforming-with-lifts~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming-with-lifts~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-transforming-with-lifts?</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span><span class="RktPn">)</span> produces
+<span class="RktVal">#t</span> and a target context is available for lifting expressions
+(via <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-expression%29%29" class="RktValLink" data-pltdoc="x">syntax-local-lift-expression</a></span>), <span class="RktVal">#f</span> otherwise.</div></p><p>Currently, <span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span><span class="RktPn">)</span> implies
+<span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming-with-lifts~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming-with-lifts?</a></span><span class="RktPn">)</span>.</p><p class="SHistory">Added in version 6.3.0.9 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-transforming-module-expression~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming-module-expression~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-transforming-module-expression?</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> during the dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax
+transformer</span></a> application by the expander for an expression
+within a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> form, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-identifier-as-binding))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-identifier-as-binding%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-identifier-as-binding</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">id-stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">intdef-ctx</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">intdef-ctx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an identifier like <span class="RktVar">id-stx</span>, but without <a href="syntax-model.html#%28tech._use._site._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">use-site
+scopes</span></a> that were previously added to the identifier as part of a
+macro expansion. When the <span class="RktVar">intdef-ctx</span> is an internal-definition
+context, the function removes use-site scopes created during expansion
+in that context. When it is <span class="RktVal">#f</span> (the default), it removes use-site
+scopes created during expansion in the current expansion context.</div></p><p>In a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> that runs in a non-expression context
+and forces the expansion of subforms with <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span>, use
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-identifier-as-binding%29%29" class="RktValLink" data-pltdoc="x">syntax-local-identifier-as-binding</a></span> on an identifier from the
+expansion before moving it into a binding position or comparing it
+with <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._bound-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">bound-identifier=?</a></span>. Otherwise, the results can be
+inconsistent with the way that <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span> works in the same
+definition context.</p><p>This procedure must be called during the
+dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application by the
+expander or while a module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.<br/>Changed in version 8.2.0.7: Added the optional
+<span class="RktVar">intdef-ctx</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-introduce))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-introduce%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-introduce</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a syntax object that is like <span class="RktVar">stx</span>, except that the
+presence of <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scopes</span></a> for the current expansion&#8212;<wbr></wbr>both the
+<a href="syntax-model.html#%28tech._macro._introduction._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">macro-introduction scope</span></a> and the <a href="syntax-model.html#%28tech._use._site._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">use-site scope</span></a>, if any&#8212;<wbr></wbr>is flipped
+on all parts of the syntax object. See <a href="syntax-model.html#%28part._transformer-model%29" data-pltdoc="x">Transformer Bindings</a> for information
+on macro-introduction and use-site <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scopes</span></a>.</div></p><p>This procedure must be called during the
+dynamic extent of a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> application by the
+expander or while a module is <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span>), otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">example</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">require-math</span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-introduce%29%29" class="RktValLink" data-pltdoc="x">syntax-local-introduce</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/math</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">require-math</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fmath..rkt%29._pi%29%29" class="RktValLink" data-pltdoc="x">pi</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-syntax-introducer))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-syntax-introducer%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-syntax-introducer</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">as-use-site?</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">flip</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">add</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">remove</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">as-use-site?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a procedure that encapsulates a fresh <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a> and flips,
+adds, or removes it in a given syntax object. By default, the fresh
+scope is a <a href="syntax-model.html#%28tech._macro._introduction._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">macro-introduction scope</span></a>, but providing a true value for
+<span class="RktVar">as-use-site?</span> creates a scope that is like a <a href="syntax-model.html#%28tech._use._site._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">use-site scope</span></a>;
+the difference is in how the scopes are treated by
+<span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-original~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-original?</a></span>.</div></p><p>The action of the generated procedure can be <span class="RktVal">'</span><span class="RktVal">flip</span> (the
+default) to flip the presence of a scope in each part of a given
+syntax object, <span class="RktVal">'</span><span class="RktVal">add</span> to add the scope to each regardless of
+whether it is present already, or <span class="RktVal">'</span><span class="RktVal">remove</span> to remove the scope
+when it is currently present in any part.</p><p>Multiple applications of the same
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-syntax-introducer%29%29" class="RktValLink" data-pltdoc="x">make-syntax-introducer</a></span> result procedure use the same scope,
+and different result procedures use distinct scopes.</p><p class="SHistory">Changed in version 6.3 of package <span class="stt">base</span>: Added the optional
+<span class="RktVar">as-use-site?</span> argument, and
+added the optional operation argument
+in the result procedure.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-interned-syntax-introducer))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-interned-syntax-introducer%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-interned-syntax-introducer</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">key</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">flip</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">add</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">remove</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-interned~3f%29%29" class="RktValLink" data-pltdoc="x">symbol-interned?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-syntax-introducer%29%29" class="RktValLink" data-pltdoc="x">make-syntax-introducer</a></span>, but the encapsulated <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a> is interned. Multiple calls to
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-interned-syntax-introducer%29%29" class="RktValLink" data-pltdoc="x">make-interned-syntax-introducer</a></span> with the same <span class="RktVar">key</span> will produce procedures that flip,
+add, or remove the same scope, even across <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phases</span></a> and module <a href="eval-model.html#%28tech._instantiation%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiations</span></a>.
+Furthermore, the scope remains consistent even when embedded in <a href="syntax-model.html#%28tech._compiled%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled</span></a> code, so a scope
+created with <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-interned-syntax-introducer%29%29" class="RktValLink" data-pltdoc="x">make-interned-syntax-introducer</a></span> will retain its identity in syntax objects
+loaded from compiled code. (In this sense, the relationship between <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-syntax-introducer%29%29" class="RktValLink" data-pltdoc="x">make-syntax-introducer</a></span>
+and <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-interned-syntax-introducer%29%29" class="RktValLink" data-pltdoc="x">make-interned-syntax-introducer</a></span> is analogous to the relationship between
+<span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._gensym%29%29" class="RktValLink" data-pltdoc="x">gensym</a></span> and <span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span>.)</div></p><p>This function is intended for the implementation of separate <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding spaces</span></a> within a single
+phase, for which the scope associated with each environment must be the same across modules.</p><p>Unlike <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-syntax-introducer%29%29" class="RktValLink" data-pltdoc="x">make-syntax-introducer</a></span>, the scope added by a procedure created with
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-interned-syntax-introducer%29%29" class="RktValLink" data-pltdoc="x">make-interned-syntax-introducer</a></span> is always treated like a <a href="syntax-model.html#%28tech._use._site._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">use-site scope</span></a>, not a
+<a href="syntax-model.html#%28tech._macro._introduction._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">macro-introduction scope</span></a>, so it does not affect originalness as reported by <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-original~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-original?</a></span>.</p><p class="SHistory">Added in version 6.90.0.28 of package <span class="stt">base</span>.<br/>Changed in version 8.2.0.4: Added the constraint that <span class="RktVar">key</span> is <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-syntax-delta-introducer))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-syntax-delta-introducer%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-syntax-delta-introducer</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">ext-stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">base-stx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">phase-level</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">flip</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">add</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">remove</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ext-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">base-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">phase-level</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-phase-level%29%29" class="RktValLink" data-pltdoc="x">syntax-local-phase-level</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Produces a procedure that behaves like the result of
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-syntax-introducer%29%29" class="RktValLink" data-pltdoc="x">make-syntax-introducer</a></span>, but using a set of <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scopes</span></a> from
+<span class="RktVar">ext-stx</span> and with a default action of <span class="RktVal">'</span><span class="RktVal">add</span>.</div></p><ul><li><p>If the scopes of <span class="RktVar">base-stx</span> are a subset of the scopes
+of <span class="RktVar">ext-stx</span>, then the result of
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-syntax-delta-introducer%29%29" class="RktValLink" data-pltdoc="x">make-syntax-delta-introducer</a></span> adds, removes, or flips
+scopes that are in the set for <span class="RktVar">ext-stx</span> and not in the
+set for <span class="RktVar">base-stx</span>.</p></li><li><p>If the scopes of <span class="RktVar">base-stx</span> are not a subset of the
+scopes of <span class="RktVar">ext-stx</span>, but if it has a binding, then the
+set of scopes associated with the binding id subtracted from
+the set of scopes for <span class="RktVar">ext-stx</span>, and the result of
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-syntax-delta-introducer%29%29" class="RktValLink" data-pltdoc="x">make-syntax-delta-introducer</a></span> adds, removes, or flips
+that difference.</p></li></ul><p>A <span class="RktVal">#f</span> value for <span class="RktVar">base-stx</span> is equivalent to a syntax
+object with no <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scopes</span></a>.</p><p>This procedure is potentially useful when some <span class="RktVar">m-id</span> has a
+transformer binding that records some <span class="RktVar">orig-id</span>, and a use of
+<span class="RktVar">m-id</span> introduces a binding of <span class="RktVar">orig-id</span>. In that
+case, the <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scopes</span></a> one the use of <span class="RktVar">m-id</span> added since the
+binding of <span class="RktVar">m-id</span> should be transferred to the binding
+instance of <span class="RktVar">orig-id</span>, so that it captures uses with the same
+lexical context as the use of <span class="RktVar">m-id</span>.</p><p>If <span class="RktVar">ext-stx</span> is <a href="stxcerts.html#%28tech._tainted%29" class="techoutside" data-pltdoc="x"><span class="techinside">tainted</span></a>, then an
+identifier result from the created procedure is <a href="stxcerts.html#%28tech._tainted%29" class="techoutside" data-pltdoc="x"><span class="techinside">tainted</span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-transforming-module-provides~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-transforming-module-provides~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-transforming-module-provides?</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> while a <a href="stxtrans.html#%28tech._provide._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide transformer</span></a> is running (see
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._make-provide-transformer%29%29" class="RktValLink" data-pltdoc="x">make-provide-transformer</a></span>) or while an <span class="RktSym">expand</span> sub-form of
+<span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25provide%29%29" class="RktStxLink" data-pltdoc="x">#%provide</a></span> is expanded, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-module-defined-identifiers))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-module-defined-identifiers%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-module-defined-identifiers</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Can be called only while
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-transforming-module-provides~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-local-transforming-module-provides?</a></span> returns
+<span class="RktVal">#t</span>.</div></p><p>It returns a hash table mapping a <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase-level</span></a> number (such as
+<span class="RktVal">0</span>) to a list of all definitions at that <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>
+within the module being expanded. This information is used for
+implementing <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> sub-forms like <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-defined-out%29%29" class="RktStxLink" data-pltdoc="x">all-defined-out</a></span>.</p><p>Beware that the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase-level</span></a> keys are absolute relative to the
+enclosing module, and not relative to the current transformer phase
+level as reported by <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-phase-level%29%29" class="RktValLink" data-pltdoc="x">syntax-local-phase-level</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._syntax-local-module-required-identifiers))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-module-required-identifiers%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-module-required-identifiers</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">mod-path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">shift</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mod-path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">shift</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-shift~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space-shift?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Can be called only while
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-transforming-module-provides~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-local-transforming-module-provides?</a></span> returns
+<span class="RktVal">#t</span>.</div></p><p>It returns an association list mapping <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> and
+<a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a> combinations to lists of
+identifiers.  Each list of identifiers includes all bindings imported
+(into the module being expanded) using the module path
+<span class="RktVar">mod-path</span>, or all modules if <span class="RktVar">mod-path</span> is
+<span class="RktVal">#f</span>. The association list includes all identifiers imported
+with a phase level and binding space shift as represented by <span class="RktVar">shift</span>,
+or all shifts if <span class="RktVar">shift</span> is <span class="RktVal">#t</span>. If <span class="RktVar">shift</span> is
+not <span class="RktVal">#t</span>, the result can be <span class="RktVal">#f</span> if no identifiers
+are imported at that shift.</p><p>When an identifier is renamed on import, the result association list
+includes the identifier by its internal name. Use
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="RktValLink" data-pltdoc="x">identifier-binding</a></span> to obtain more information about the
+identifier.</p><p>Beware that the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase-level</span></a> shifts are absolute relative to the
+enclosing module, and not relative to the current transformer phase
+level as reported by <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-phase-level%29%29" class="RktValLink" data-pltdoc="x">syntax-local-phase-level</a></span>.</p><p class="SHistory">Changed in version 8.2.0.3 of package <span class="stt">base</span>: Generalized <span class="RktVar">shift</span> and result
+to phase&ndash;space combinations.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._prop~3aliberal-define-context))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aliberal-define-context%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:liberal-define-context</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._liberal-define-context~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._liberal-define-context~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">liberal-define-context?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">An instance of a structure type with a true value for the
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aliberal-define-context%29%29" class="RktValLink" data-pltdoc="x">prop:liberal-define-context</a></span> property can be used as an
+element of an <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a> representation in the
+result of <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-context%29%29" class="RktValLink" data-pltdoc="x">syntax-local-context</a></span> or the second argument of
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span>. Such a value indicates that the context
+supports <a name="(tech._liberal._expansion)"></a><span style="font-style: italic">liberal expansion</span> of <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span> forms into
+potentially multiple <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span> and
+<span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span> forms. The <span class="RktVal">'</span><span class="RktVal">module</span> and
+<span class="RktVal">'</span><span class="RktVal">module-body</span> contexts implicitly allow <a href="stxtrans.html#%28tech._liberal._expansion%29" class="techoutside" data-pltdoc="x"><span class="techinside">liberal
+expansion</span></a>.</div></p><p>The <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._liberal-define-context~3f%29%29" class="RktValLink" data-pltdoc="x">liberal-define-context?</a></span> predicate returns <span class="RktVal">#t</span> if
+<span class="RktVar">v</span> is an instance of a structure with a true value for the
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aliberal-define-context%29%29" class="RktValLink" data-pltdoc="x">prop:liberal-define-context</a></span> property, <span class="RktVal">#f</span> otherwise.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;require-trans&quot;">12.4.1<tt>&nbsp;</tt><a name="(part._require-trans)"></a><a name="(mod-path._racket/require-transform)"></a><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> Transformers</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="stxtrans.html#%28mod-path._racket%2Frequire-transform%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/require-transform</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="stxtrans.html#%28mod-path._racket%2Frequire-transform%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/require-transform</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p>A <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding whose value is a structure with the
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._prop~3arequire-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:require-transformer</a></span> property implements a derived
+<span class="RktVar">require-spec</span> for <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> as a <a name="(tech._require._transformer)"></a><span style="font-style: italic">require
+transformer</span>.</p><p>A <a href="stxtrans.html#%28tech._require._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">require transformer</span></a> is called with the syntax object representing its use
+as a <span class="RktVar">require-spec</span> within a <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> form, and the
+result must be two lists: a list of <span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import%29%29" class="RktValLink" data-pltdoc="x">import</a></span>s and a list of
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import-source%29%29" class="RktValLink" data-pltdoc="x">import-source</a></span>s.</p><p>If the derived form contains a sub-form that is a
+<span class="RktVar">require-spec</span>, then it can call <span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._expand-import%29%29" class="RktValLink" data-pltdoc="x">expand-import</a></span> to
+transform the sub-<span class="RktVar">require-spec</span> to lists of imports and
+import sources.</p><p>See also <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Frequire-syntax..rkt%29._define-require-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-require-syntax</a></span>, which supports macro-style
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> transformers.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/require-transform..rkt)._expand-import))"></a><span title="Provided from: racket/require-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._expand-import%29%29" class="RktValDef RktValLink" data-pltdoc="x">expand-import</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import~3f%29%29" class="RktValLink" data-pltdoc="x">import?</a></span><span class="RktPn">)</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import-source~3f%29%29" class="RktValLink" data-pltdoc="x">import-source?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Expands the given <span class="RktVar">require-spec</span> to lists of imports and
+import sources.  The latter specifies modules to be
+<a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d or <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed, so the modules that it
+represents should be a superset of the modules represented in the
+former list (so that a module will be <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d or
+<a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed even if all of imports are eventually filtered from the
+former list).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/require-transform..rkt)._make-require-transformer))"></a><span title="Provided from: racket/require-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._make-require-transformer%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-require-transformer</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._require-transformer~3f%29%29" class="RktValLink" data-pltdoc="x">require-transformer?</a></span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import~3f%29%29" class="RktValLink" data-pltdoc="x">import?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import-source~3f%29%29" class="RktValLink" data-pltdoc="x">import-source?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Creates a <a href="stxtrans.html#%28tech._require._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">require transformer</span></a> using the given procedure as the
+transformer.
+Often used in combination with <span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._expand-import%29%29" class="RktValLink" data-pltdoc="x">expand-import</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/require-transform</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">printing</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._make-require-transformer%29%29" class="RktValLink" data-pltdoc="x">make-require-transformer</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">path</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Importing: ~a~n"</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">path</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._expand-import%29%29" class="RktValLink" data-pltdoc="x">expand-import</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">path</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">printing</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/match</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Importing: #&lt;syntax:eval:37:0 racket/match&gt;</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/require-transform..rkt)._prop~3arequire-transformer))"></a><span title="Provided from: racket/require-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._prop~3arequire-transformer%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:require-transformer</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A property to identify <a href="stxtrans.html#%28tech._require._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">require transformers</span></a>. The property
+value must be a procedure that takes the structure and returns a transformer
+procedure; the returned transformer procedure takes a syntax object and returns
+import and import-source lists.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/require-transform..rkt)._require-transformer~3f))"></a><span title="Provided from: racket/require-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._require-transformer~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">require-transformer?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> has the
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._prop~3arequire-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:require-transformer</a></span> property, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="nobreak"><a name="(def._((lib._racket/require-transform..rkt)._import-orig-stx))"></a><a name="(def._((lib._racket/require-transform..rkt)._import-orig-mode))"></a><a name="(def._((lib._racket/require-transform..rkt)._import-req-mode))"></a><a name="(def._((lib._racket/require-transform..rkt)._import-mode))"></a><a name="(def._((lib._racket/require-transform..rkt)._import-src-mod-path))"></a><a name="(def._((lib._racket/require-transform..rkt)._import-src-sym))"></a><a name="(def._((lib._racket/require-transform..rkt)._import-local-id))"></a><a name="(def._((lib._racket/require-transform..rkt)._make-import))"></a><a name="(def._((lib._racket/require-transform..rkt)._import~3f))"></a><a name="(def._((lib._racket/require-transform..rkt)._struct~3aimport))"></a><a name="(def._((lib._racket/require-transform..rkt)._import))"></a><span title="Provided from: racket/require-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import%29%29" class="RktValDef RktValLink" data-pltdoc="x">import</a></span></span></span></td><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span></td><td><span class="nobreak"><span class="RktSym">local-id</span></span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym">src-sym</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym">src-mod-path</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym">mode</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym">req-mode</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym">orig-mode</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym">orig-stx</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._make-import%29%29" class="RktValLink" data-pltdoc="x">make-import</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">local-id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">src-sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktSym">src-mod-path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._syntax%2Fc%29%29" class="RktValLink" data-pltdoc="x">syntax/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">req-mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-shift~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space-shift?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">orig-mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">orig-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A structure representing a single imported identifier:</div></p><ul><li><p><span class="RktSym">local-id</span> &#8212;<wbr></wbr> the identifier to be bound within the
+importing module, but <span class="emph">without</span> any space-specific scope
+implied by <span class="RktSym">mode</span>.</p></li><li><p><span class="RktSym">src-sym</span> &#8212;<wbr></wbr> the external name of the binding as
+exported from its source module.</p></li><li><p><span class="RktSym">src-mod-path</span> &#8212;<wbr></wbr> a <a href="Module_Names_and_Loading.html#%28tech._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path</span></a> (relative to the
+importing module) for the source of the imported binding.</p></li><li><p><span class="RktSym">mode</span> &#8212;<wbr></wbr> the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> and <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding
+space</span></a> of the binding in the importing module, which must be the
+same as <span class="RktPn">(</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace%2B%29%29" class="RktValLink" data-pltdoc="x">phase+space+</a></span><span class="stt"> </span><span class="RktSym">orig-mode</span><span class="stt"> </span><span class="RktSym">req-mode</span><span class="RktPn">)</span>.</p></li><li><p><span class="RktSym">req-mode</span> &#8212;<wbr></wbr> the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> shift and
+<a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a> shift of the import relative to the
+exporting module.</p></li><li><p><span class="RktSym">orig-mode</span> &#8212;<wbr></wbr> the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> and <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding
+space</span></a> of the binding as exported by the exporting module.</p></li><li><p><span class="RktSym">orig-stx</span> &#8212;<wbr></wbr> a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> for the source of
+the import, used for error reporting.</p></li></ul><p class="SHistory">Changed in version 8.2.0.3 of package <span class="stt">base</span>: Generalized modes to phase&ndash;space combinations.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/require-transform..rkt)._import-source-mode))"></a><a name="(def._((lib._racket/require-transform..rkt)._import-source-mod-path-stx))"></a><a name="(def._((lib._racket/require-transform..rkt)._make-import-source))"></a><a name="(def._((lib._racket/require-transform..rkt)._import-source~3f))"></a><a name="(def._((lib._racket/require-transform..rkt)._struct~3aimport-source))"></a><a name="(def._((lib._racket/require-transform..rkt)._import-source))"></a><span title="Provided from: racket/require-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._import-source%29%29" class="RktValDef RktValLink" data-pltdoc="x">import-source</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mod-path-stx</span><span class="stt"> </span><span class="RktSym">mode</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._make-import-source%29%29" class="RktValLink" data-pltdoc="x">make-import-source</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">mod-path-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._syntax%2Fc%29%29" class="RktValLink" data-pltdoc="x">syntax/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace-shift~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space-shift?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A structure representing an imported module, which must be
+<a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d or <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed even if no binding is imported
+into a module.</div></p><ul><li><p><span class="RktSym">mod-path-stx</span> &#8212;<wbr></wbr> a <a href="Module_Names_and_Loading.html#%28tech._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path</span></a> (relative
+to the importing module) for the source of the imported binding.</p></li><li><p><span class="RktSym">mode</span> &#8212;<wbr></wbr> the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> shift and
+<a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding space</span></a> shift of the import.</p></li></ul><p class="SHistory">Changed in version 8.2.0.3 of package <span class="stt">base</span>: Generalized <span class="RktSym">mode</span> to phase&ndash;space combinations.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/require-transform..rkt)._current-require-module-path))"></a><span title="Provided from: racket/require-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._current-require-module-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-require-module-path</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/require-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._current-require-module-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-require-module-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">module-path</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path-index~3f%29%29" class="RktValLink" data-pltdoc="x">module-path-index?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines how relative <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>-level module
+paths are expanded to <span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25require%29%29" class="RktStxLink" data-pltdoc="x">#%require</a></span>-level module paths by
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._convert-relative-module-path%29%29" class="RktValLink" data-pltdoc="x">convert-relative-module-path</a></span> (which is used implicitly by all
+built-in <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> sub-forms).</div></p><p>When the value of <span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._current-require-module-path%29%29" class="RktValLink" data-pltdoc="x">current-require-module-path</a></span> is <span class="RktVal">#f</span>,
+relative module paths are left as-is, which means that the
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> context determines the resolution of the module
+path.</p><p>The <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> form <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>s
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._current-require-module-path%29%29" class="RktValLink" data-pltdoc="x">current-require-module-path</a></span> as <span class="RktVal">#f</span> while invoking
+sub-form transformers, while <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._relative-in%29%29" class="RktStxLink" data-pltdoc="x">relative-in</a></span> <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>s
+to a given module path.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/require-transform..rkt)._convert-relative-module-path))"></a><span title="Provided from: racket/require-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._convert-relative-module-path%29%29" class="RktValDef RktValLink" data-pltdoc="x">convert-relative-module-path</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._syntax%2Fc%29%29" class="RktValLink" data-pltdoc="x">syntax/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">module-path</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._syntax%2Fc%29%29" class="RktValLink" data-pltdoc="x">syntax/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._module-path~3f%29%29" class="RktValLink" data-pltdoc="x">module-path?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Converts <span class="RktVar">module-path</span> according to <span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._current-require-module-path%29%29" class="RktValLink" data-pltdoc="x">current-require-module-path</a></span>.</div></p><p>If <span class="RktVar">module-path</span> is not relative or if the value of
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._current-require-module-path%29%29" class="RktValLink" data-pltdoc="x">current-require-module-path</a></span> is <span class="RktVal">#f</span>, then
+<span class="RktVar">module-path</span> is returned. Otherwise, <span class="RktVar">module-path</span> is
+converted to an absolute module path that is equivalent to
+<span class="RktVar">module-path</span> relative to the value of
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._current-require-module-path%29%29" class="RktValLink" data-pltdoc="x">current-require-module-path</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/require-transform..rkt)._syntax-local-require-certifier))"></a><span title="Provided from: racket/require-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Frequire-transform..rkt%29._syntax-local-require-certifier%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-require-certifier</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">For backward compatibility only; returns a procedure that returns its
+first argument.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;provide-trans&quot;">12.4.2<tt>&nbsp;</tt><a name="(part._provide-trans)"></a><a name="(mod-path._racket/provide-transform)"></a><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> Transformers</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="stxtrans.html#%28mod-path._racket%2Fprovide-transform%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/provide-transform</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="stxtrans.html#%28mod-path._racket%2Fprovide-transform%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/provide-transform</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p>A <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding whose value is a structure with the
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._prop~3aprovide-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:provide-transformer</a></span> property implements a derived
+<span class="RktVar">provide-spec</span> for <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> as a <a name="(tech._provide._transformer)"></a><span style="font-style: italic">provide transformer</span>.
+A <a href="stxtrans.html#%28tech._provide._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide transformer</span></a> is applied as part of the last phase of
+a module&rsquo;s expansion, after all other declarations and expressions within
+the module are expanded.</p><p>A <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding whose value is a structure with the
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._prop~3aprovide-pre-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:provide-pre-transformer</a></span> property implements a derived
+<span class="RktVar">provide-spec</span> for <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> as a <a name="(tech._provide._pre._transformer)"></a><span style="font-style: italic">provide
+pre-transformer</span>.  A <a href="stxtrans.html#%28tech._provide._pre._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide pre-transformer</span></a> is applied as part
+of the first phase of a module&rsquo;s expansion. Since it is used in the
+first phase, a <a href="stxtrans.html#%28tech._provide._pre._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide pre-transformer</span></a> can use functions such
+as <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-expression%29%29" class="RktValLink" data-pltdoc="x">syntax-local-lift-expression</a></span> to introduce expressions and
+definitions in the enclosing module.</p><p>An identifier can have a <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding to a value that
+acts both as a <a href="stxtrans.html#%28tech._provide._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide transformer</span></a> and <a href="stxtrans.html#%28tech._provide._pre._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide
+pre-transformer</span></a>. The result of a <a href="stxtrans.html#%28tech._provide._pre._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide
+pre-transformer</span></a> is <span class="emph">not</span> automatically re-expanded, so a
+<a href="stxtrans.html#%28tech._provide._pre._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide pre-transformer</span></a> can usefully expand to itself in that case.</p><p>A transformer is called with the syntax object representing its use as
+a <span class="RktVar">provide-spec</span> within a <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> form and a list of
+symbols representing the export modes specified by enclosing
+<span class="RktVar">provide-spec</span>s. The result of a <a href="stxtrans.html#%28tech._provide._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide transformer</span></a>
+must be a list of <span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._export%29%29" class="RktValLink" data-pltdoc="x">export</a></span>s, while the result of a
+<a href="stxtrans.html#%28tech._provide._pre._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide pre-transformer</span></a> is a syntax object to be used as a
+<span class="RktVar">provide-spec</span> in the last phase of module expansion.</p><p>If a derived form contains a sub-form that is a
+<span class="RktVar">provide-spec</span>, then it can call <span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._expand-export%29%29" class="RktValLink" data-pltdoc="x">expand-export</a></span> or
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._pre-expand-export%29%29" class="RktValLink" data-pltdoc="x">pre-expand-export</a></span> to transform the sub-<span class="RktVar">provide-spec</span>
+sub-form.</p><p>See also <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprovide-syntax..rkt%29._define-provide-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-provide-syntax</a></span>, which supports macro-style
+<a href="stxtrans.html#%28tech._provide._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide transformers</span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/provide-transform..rkt)._expand-export))"></a><span title="Provided from: racket/provide-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._expand-export%29%29" class="RktValDef RktValLink" data-pltdoc="x">expand-export</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktVar">modes</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._export~3f%29%29" class="RktValLink" data-pltdoc="x">export?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">modes</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Expands the given <span class="RktVar">provide-spec</span> to a list of exports. The
+<span class="RktVar">modes</span> list controls the expansion of
+sub-<span class="RktVar">provide-specs</span>; for example, an identifier refers to a
+binding in the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> of the enclosing <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span>
+form, unless the <span class="RktVar">modes</span> list specifies otherwise. Normally,
+<span class="RktVar">modes</span> is either empty or contains a single element.</div></p><p class="SHistory">Changed in version 8.2.0.3 of package <span class="stt">base</span>: Generalized <span class="RktVar">modes</span> to phase&ndash;space combinations.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/provide-transform..rkt)._pre-expand-export))"></a><span title="Provided from: racket/provide-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._pre-expand-export%29%29" class="RktValDef RktValLink" data-pltdoc="x">pre-expand-export</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktVar">modes</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">modes</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Expands the given <span class="RktVar">provide-spec</span> at the level of <a href="stxtrans.html#%28tech._provide._pre._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide
+pre-transformers</span></a>. The <span class="RktVar">modes</span> argument is the same as for
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._expand-export%29%29" class="RktValLink" data-pltdoc="x">expand-export</a></span>.</div></p><p class="SHistory">Changed in version 8.2.0.3 of package <span class="stt">base</span>: Generalized <span class="RktVar">modes</span> to phase&ndash;space combinations.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/provide-transform..rkt)._make-provide-transformer))"></a><span title="Provided from: racket/provide-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._make-provide-transformer%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-provide-transformer</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._provide-transformer~3f%29%29" class="RktValLink" data-pltdoc="x">provide-transformer?</a></span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._export~3f%29%29" class="RktValLink" data-pltdoc="x">export?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/provide-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._make-provide-transformer%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-provide-transformer</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">pre-proc</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._provide-transformer~3f%29%29" class="RktValLink" data-pltdoc="x">provide-transformer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._provide-pre-transformer~3f%29%29" class="RktValLink" data-pltdoc="x">provide-pre-transformer?</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._export~3f%29%29" class="RktValLink" data-pltdoc="x">export?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">pre-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Creates a <a href="stxtrans.html#%28tech._provide._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide transformer</span></a> (i.e., a structure with the
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._prop~3aprovide-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:provide-transformer</a></span> property) using the given procedure
+as the transformer. If a <span class="RktVar">pre-proc</span> is provided, then the result is also a
+<a href="stxtrans.html#%28tech._provide._pre._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide pre-transformer</span></a>.
+Often used in combination with <span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._expand-export%29%29" class="RktValLink" data-pltdoc="x">expand-export</a></span> and/or
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._pre-expand-export%29%29" class="RktValLink" data-pltdoc="x">pre-expand-export</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/provide-transform..rkt)._make-provide-pre-transformer))"></a><span title="Provided from: racket/provide-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._make-provide-pre-transformer%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-provide-pre-transformer</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">pre-proc</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._provide-pre-transformer~3f%29%29" class="RktValLink" data-pltdoc="x">provide-pre-transformer?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">pre-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._make-provide-transformer%29%29" class="RktValLink" data-pltdoc="x">make-provide-transformer</a></span>, but for a value that is a
+<a href="stxtrans.html#%28tech._provide._pre._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide pre-transformer</span></a>, only.
+Often used in combination with <span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._pre-expand-export%29%29" class="RktValLink" data-pltdoc="x">pre-expand-export</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/provide-transform</span><span class="hspace">&nbsp;</span><span class="RktSym">syntax/parse</span><span class="hspace">&nbsp;</span><span class="RktSym">syntax/stx</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">wrapped-out</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._make-provide-pre-transformer%29%29" class="RktValLink" data-pltdoc="x">make-provide-pre-transformer</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktSym">modes</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">syntax-parse</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:with</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">wrapped-f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx-map</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-lift-expression%29%29" class="RktValLink" data-pltdoc="x">syntax-local-lift-expression</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktSym">args</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"applying ~a, args: ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">f</span><span class="hspace">&nbsp;</span><span class="RktSym">args</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._apply%29%29" class="RktValLink" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">args</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._pre-expand-export%29%29" class="RktValLink" data-pltdoc="x">pre-expand-export</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._rename-out%29%29" class="RktStxLink" data-pltdoc="x">rename-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">wrapped-f</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">modes</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">wrapped-out</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">m</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">applying +, args: (2 3)</span></p></td></tr><tr><td><p><span class="RktOut">applying -, args: (1 5)</span></p></td></tr></table></td></tr><tr><td><p><span class="RktRes">-4</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/provide-transform..rkt)._prop~3aprovide-transformer))"></a><span title="Provided from: racket/provide-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._prop~3aprovide-transformer%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:provide-transformer</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A property to identify <a href="stxtrans.html#%28tech._provide._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide transformers</span></a>. The property
+value must be a procedure that takes the structure and returns a transformer
+procedure; the returned transformer procedure takes a syntax object and mode list and
+returns an export list.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/provide-transform..rkt)._prop~3aprovide-pre-transformer))"></a><span title="Provided from: racket/provide-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._prop~3aprovide-pre-transformer%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:provide-pre-transformer</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A property to identify <a href="stxtrans.html#%28tech._provide._pre._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">provide pre-transformers</span></a>. The property
+value must be a procedure that takes the structure and returns a transformer
+procedure; the returned transformer procedure takes a syntax object and mode list and
+returns a syntax object.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/provide-transform..rkt)._provide-transformer~3f))"></a><span title="Provided from: racket/provide-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._provide-transformer~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">provide-transformer?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> has the
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._prop~3aprovide-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:provide-transformer</a></span> property, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/provide-transform..rkt)._provide-pre-transformer~3f))"></a><span title="Provided from: racket/provide-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._provide-pre-transformer~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">provide-pre-transformer?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> has the
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._prop~3aprovide-pre-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:provide-pre-transformer</a></span> property, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((lib._racket/provide-transform..rkt)._export-orig-stx))"></a><a name="(def._((lib._racket/provide-transform..rkt)._export-protect~3f))"></a><a name="(def._((lib._racket/provide-transform..rkt)._export-mode))"></a><a name="(def._((lib._racket/provide-transform..rkt)._export-out-sym))"></a><a name="(def._((lib._racket/provide-transform..rkt)._export-local-id))"></a><a name="(def._((lib._racket/provide-transform..rkt)._make-export))"></a><a name="(def._((lib._racket/provide-transform..rkt)._export~3f))"></a><a name="(def._((lib._racket/provide-transform..rkt)._struct~3aexport))"></a><a name="(def._((lib._racket/provide-transform..rkt)._export))"></a><span title="Provided from: racket/provide-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._export%29%29" class="RktValDef RktValLink" data-pltdoc="x">export</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">local-id</span><span class="stt"> </span><span class="RktSym">out-sym</span><span class="stt"> </span><span class="RktSym">mode</span><span class="stt"> </span><span class="RktSym">protect?</span><span class="stt"> </span><span class="RktSym">orig-stx</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._make-export%29%29" class="RktValLink" data-pltdoc="x">make-export</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">local-id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">out-sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="phase_space.html#%28def._%28%28lib._racket%2Fphase%2Bspace..rkt%29._phase%2Bspace~3f%29%29" class="RktValLink" data-pltdoc="x">phase+space?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">protect?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">orig-stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A structure representing a single exported identifier:</div></p><ul><li><p><span class="RktSym">local-id</span> &#8212;<wbr></wbr> the identifier that is bound within the
+exporting module.</p></li><li><p><span class="RktSym">out-sym</span> &#8212;<wbr></wbr> the external name of the binding.</p></li><li><p><span class="RktSym">mode</span> &#8212;<wbr></wbr> the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> and <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding
+space</span></a> of the export (which affects how it is imported).</p></li><li><p><span class="RktSym">protect?</span> &#8212;<wbr></wbr> indicates whether the identifier should
+be protected (see <a href="modprotect.html" data-pltdoc="x">Code Inspectors</a>).</p></li><li><p><span class="RktSym">orig-stx</span> &#8212;<wbr></wbr> a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> for the source of
+the export, used for error reporting.</p></li></ul><p class="SHistory">Changed in version 8.2.0.3 of package <span class="stt">base</span>: Generalized <span class="RktSym">mode</span> to phase&ndash;space combinations.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/provide-transform..rkt)._syntax-local-provide-certifier))"></a><span title="Provided from: racket/provide-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fprovide-transform..rkt%29._syntax-local-provide-certifier%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-provide-certifier</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%2A%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">For backward compatibility only; returns a procedure that returns its
+first argument.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;keyword-trans&quot;">12.4.3<tt>&nbsp;</tt><a name="(part._keyword-trans)"></a><a name="(mod-path._racket/keyword-transform)"></a>Keyword-Argument Conversion Introspection</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="stxtrans.html#%28mod-path._racket%2Fkeyword-transform%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/keyword-transform</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="stxtrans.html#%28mod-path._racket%2Fkeyword-transform%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/keyword-transform</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/keyword-transform..rkt)._syntax-procedure-alias-property))"></a><span title="Provided from: racket/keyword-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fkeyword-transform..rkt%29._syntax-procedure-alias-property%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-procedure-alias-property</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec%29%29" class="RktStxLink" data-pltdoc="x">letrec</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">val?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._recursive-contract%29%29" class="RktStxLink" data-pltdoc="x">recursive-contract</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">val?</span><span class="hspace">&nbsp;</span><span class="RktSym">val?</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">val?</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/keyword-transform..rkt)._syntax-procedure-converted-arguments-property))"></a><span title="Provided from: racket/keyword-transform | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28lib._racket%2Fkeyword-transform..rkt%29._syntax-procedure-converted-arguments-property%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-procedure-converted-arguments-property</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec%29%29" class="RktStxLink" data-pltdoc="x">letrec</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">val?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="contract-utilities.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fbase..rkt%29._recursive-contract%29%29" class="RktStxLink" data-pltdoc="x">recursive-contract</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._cons%2Fc%29%29" class="RktValLink" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">val?</span><span class="hspace">&nbsp;</span><span class="RktSym">val?</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">val?</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Reports the value of a syntax property that can be
+attached to an identifier by the expansion of a keyword-application
+form. See <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span> for more
+information about the property.</div></p><p>The property value is normally a pair consisting of the original
+identifier and an identifier that appears in the
+expansion. Property-value merging via <span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-track-origin%29%29" class="RktValLink" data-pltdoc="x">syntax-track-origin</a></span> can make
+the value a pair of such values, and so on.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;portal-syntax&quot;">12.4.4<tt>&nbsp;</tt><a name="(part._portal-syntax)"></a>Portal Syntax Bindings</h5><p>An identifier bound to <a name="(tech._portal._syntax)"></a><span style="font-style: italic">portal syntax</span> value created by
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-portal-syntax%29%29" class="RktValLink" data-pltdoc="x">make-portal-syntax</a></span> does not act as a transformer, but it
+encapsulates a syntax object that can be accessed in inspected even
+without instantiating the enclosing module. Portal syntax is also bound
+using the <span class="RktSym">portal</span> form of <span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25require%29%29" class="RktStxLink" data-pltdoc="x">#%require</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._portal-syntax~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._portal-syntax~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">portal-syntax?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a value created by
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-portal-syntax%29%29" class="RktValLink" data-pltdoc="x">make-portal-syntax</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p class="SHistory">Added in version 8.3.0.8 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-portal-syntax))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-portal-syntax%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-portal-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._portal-syntax~3f%29%29" class="RktValLink" data-pltdoc="x">portal-syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates <a href="stxtrans.html#%28tech._portal._syntax%29" class="techoutside" data-pltdoc="x"><span class="techinside">portal syntax</span></a> with the content <span class="RktVar">stx</span>.</div></p><p>When <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span> or <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span> binds an
+identifier to portal syntax immediately in a module body, then in
+addition to being accessible via <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value</a></span> while
+expanding, the portal syntax content is accessible via
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding-portal-syntax%29%29" class="RktValLink" data-pltdoc="x">identifier-binding-portal-syntax</a></span>.</p><p class="SHistory">Added in version 8.3.0.8 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._portal-syntax-content))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._portal-syntax-content%29%29" class="RktValDef RktValLink" data-pltdoc="x">portal-syntax-content</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">portal</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">portal</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._portal-syntax~3f%29%29" class="RktValLink" data-pltdoc="x">portal-syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the content of <a href="stxtrans.html#%28tech._portal._syntax%29" class="techoutside" data-pltdoc="x"><span class="techinside">portal syntax</span></a> created with
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-portal-syntax%29%29" class="RktValLink" data-pltdoc="x">make-portal-syntax</a></span>.</div></p><p class="SHistory">Added in version 8.3.0.8 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stxcmp.html" title="backward to &quot;12.3 Syntax Object Bindings&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stxparam.html" title="forward to &quot;12.5 Syntax Parameters&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/subprocess.html b/clones/docs.racket-lang.org/reference/subprocess.html
new file mode 100644
index 00000000..2bfd1ad4
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/subprocess.html
@@ -0,0 +1,248 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15.4&nbsp;Processes</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewselflink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewlink" data-pltdoc="x">Paths</a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="Filesystem.html" class="tocviewlink" data-pltdoc="x">Filesystem</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="networking.html" class="tocviewlink" data-pltdoc="x">Networking</a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="subprocess.html" class="tocviewselflink" data-pltdoc="x">Processes</a></td></tr><tr><td align="right">15.5&nbsp;</td><td><a href="logging.html" class="tocviewlink" data-pltdoc="x">Logging</a></td></tr><tr><td align="right">15.6&nbsp;</td><td><a href="time.html" class="tocviewlink" data-pltdoc="x">Time</a></td></tr><tr><td align="right">15.7&nbsp;</td><td><a href="envvars.html" class="tocviewlink" data-pltdoc="x">Environment Variables</a></td></tr><tr><td align="right">15.8&nbsp;</td><td><a href="runtime.html" class="tocviewlink" data-pltdoc="x">Environment and Runtime Information</a></td></tr><tr><td align="right">15.9&nbsp;</td><td><a href="Command-Line_Parsing.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Parsing</a></td></tr><tr><td align="right">15.10&nbsp;</td><td><a href="os-lib.html" class="tocviewlink" data-pltdoc="x">Additional Operating System Functions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>15.4&nbsp;</td><td><a href="subprocess.html" class="tocviewselflink" data-pltdoc="x">Processes</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.4.1&nbsp;</td><td><a href="subprocess.html#%28part._.Simple_.Subprocesses%29" class="tocviewlink" data-pltdoc="x">Simple Subprocesses</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subprocess</span></span></a></td></tr><tr><td><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-wait%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subprocess-<wbr></wbr>wait</span></span></a></td></tr><tr><td><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-status%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subprocess-<wbr></wbr>status</span></span></a></td></tr><tr><td><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-kill%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subprocess-<wbr></wbr>kill</span></span></a></td></tr><tr><td><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-pid%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subprocess-<wbr></wbr>pid</span></span></a></td></tr><tr><td><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subprocess?</span></span></a></td></tr><tr><td><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._current-subprocess-custodian-mode%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>subprocess-<wbr></wbr>custodian-<wbr></wbr>mode</span></span></a></td></tr><tr><td><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-group-enabled%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">subprocess-<wbr></wbr>group-<wbr></wbr>enabled</span></span></a></td></tr><tr><td><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._current-subprocess-keep-file-descriptors%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>subprocess-<wbr></wbr>keep-<wbr></wbr>file-<wbr></wbr>descriptors</span></span></a></td></tr><tr><td><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._shell-execute%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">shell-<wbr></wbr>execute</span></span></a></td></tr><tr><td><span class="tocsublinknumber">15.4.1<tt>&nbsp;</tt></span><a href="subprocess.html#%28part._.Simple_.Subprocesses%29" class="tocsubseclink" data-pltdoc="x">Simple Subprocesses</a></td></tr><tr><td><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">system</span></span></a></td></tr><tr><td><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">system*</span></span></a></td></tr><tr><td><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%2Fexit-code%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">system/<span class="mywbr"> &nbsp;</span>exit-<wbr></wbr>code</span></span></a></td></tr><tr><td><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%2A%2Fexit-code%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">system*/<span class="mywbr"> &nbsp;</span>exit-<wbr></wbr>code</span></span></a></td></tr><tr><td><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">process</span></span></a></td></tr><tr><td><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">process*</span></span></a></td></tr><tr><td><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%2Fports%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">process/<span class="mywbr"> &nbsp;</span>ports</span></span></a></td></tr><tr><td><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%2A%2Fports%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">process*/<span class="mywbr"> &nbsp;</span>ports</span></span></a></td></tr><tr><td><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._string-no-nuls~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>no-<wbr></wbr>nuls?</span></span></a></td></tr><tr><td><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._bytes-no-nuls~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">bytes-<wbr></wbr>no-<wbr></wbr>nuls?</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="udp.html" title="backward to &quot;15.3.2 UDP&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="os.html" title="up to &quot;15 Operating System&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="logging.html" title="forward to &quot;15.5 Logging&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;subprocess&quot;">15.4<tt>&nbsp;</tt><a name="(part._subprocess)"></a>Processes</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._subprocess))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess%29%29" class="RktValDef RktValLink" data-pltdoc="x">subprocess</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">stdout</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">stdin</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">stderr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">group</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">command</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess~3f%29%29" class="RktValLink" data-pltdoc="x">subprocess?</a></span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._file-stream-port~3f%29%29" class="RktValLink" data-pltdoc="x">file-stream-port?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._file-stream-port~3f%29%29" class="RktValLink" data-pltdoc="x">file-stream-port?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._file-stream-port~3f%29%29" class="RktValLink" data-pltdoc="x">file-stream-port?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stdout</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._file-stream-port~3f%29%29" class="RktValLink" data-pltdoc="x">file-stream-port?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stdin</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._file-stream-port~3f%29%29" class="RktValLink" data-pltdoc="x">file-stream-port?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stderr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._file-stream-port~3f%29%29" class="RktValLink" data-pltdoc="x">file-stream-port?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">stdout</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">group</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">new</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess%29%29" class="RktValLink" data-pltdoc="x">subprocess</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-group-enabled%29%29" class="RktValLink" data-pltdoc="x">subprocess-group-enabled</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">new</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">command</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._string-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">string-no-nuls?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._bytes-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-no-nuls?</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess%29%29" class="RktValDef RktValLink" data-pltdoc="x">subprocess</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">stdout</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">stdin</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">stderr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">group</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">command</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">exact</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arg</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess~3f%29%29" class="RktValLink" data-pltdoc="x">subprocess?</a></span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._file-stream-port~3f%29%29" class="RktValLink" data-pltdoc="x">file-stream-port?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._file-stream-port~3f%29%29" class="RktValLink" data-pltdoc="x">file-stream-port?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._file-stream-port~3f%29%29" class="RktValLink" data-pltdoc="x">file-stream-port?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stdout</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._file-stream-port~3f%29%29" class="RktValLink" data-pltdoc="x">file-stream-port?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stdin</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._file-stream-port~3f%29%29" class="RktValLink" data-pltdoc="x">file-stream-port?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stderr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._file-stream-port~3f%29%29" class="RktValLink" data-pltdoc="x">file-stream-port?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">group</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">new</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess%29%29" class="RktValLink" data-pltdoc="x">subprocess</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-group-enabled%29%29" class="RktValLink" data-pltdoc="x">subprocess-group-enabled</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">new</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">command</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">exact</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exact</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new process in the underlying operating system to execute
+<span class="RktVar">command</span> asynchronously, providing the new process with
+environment variables <span class="RktSym"><a href="envvars.html#%28def._%28%28quote._~23~25kernel%29._current-environment-variables%29%29" class="RktValLink" data-pltdoc="x">current-environment-variables</a></span>. See also
+<span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%29%29" class="RktValLink" data-pltdoc="x">system</a></span> and <span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%29%29" class="RktValLink" data-pltdoc="x">process</a></span> from
+<a href="subprocess.html#%28mod-path._racket%2Fsystem%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/system</span></a>.</div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>On Unix and Mac OS, subprocess creation is separate
+from starting the program indicated by <span class="RktVar">command</span>. In
+particular, if <span class="RktVar">command</span> refers to a non-existent or
+non-executable file, an error will be reported (via standard error and
+a non-0 exit code) in the subprocess, not in the creating
+process.</p></blockquote></blockquote></blockquote><p>The <span class="RktVar">command</span> argument is a path to a program executable, and
+the <span class="RktVar">arg</span>s are command-line arguments for the program. See
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._find-executable-path%29%29" class="RktValLink" data-pltdoc="x">find-executable-path</a></span> for locating an executable based on
+the <span class="stt">PATH</span> environment variable. On
+Unix and Mac OS, command-line arguments are passed as byte strings,
+and string <span class="RktVar">arg</span>s are converted using the current locale&rsquo;s
+encoding (see <a href="encodings.html" data-pltdoc="x">Encodings and Locales</a>). On Windows, command-line
+arguments are passed as strings, and byte strings are converted using
+UTF-8.</p><p>On Windows, the first <span class="RktVar">arg</span> can be replaced with
+<a name="(idx._(gentag._384._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">exact</span>, which triggers a Windows-specific behavior:
+the sole <span class="RktVar">arg</span> is used exactly as the command-line for the
+subprocess. Otherwise, on Windows, a command-line string is
+constructed from <span class="RktVar">command</span> and <span class="RktVar">arg</span> so that a typical
+Windows console application can parse it back to an array of
+arguments. If <span class="RktVal">'</span><span class="RktVal">exact</span> is provided on a non-Windows platform,
+the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>For information on the Windows command-line conventions,
+search for &ldquo;command line parsing&rdquo; at
+<span class="stt">http://msdn.microsoft.com/</span>.</p></blockquote></blockquote></blockquote><p>When provided as a port, <span class="RktVar">stdout</span> is used for the launched
+process&rsquo;s standard output, <span class="RktVar">stdin</span> is used for the process&rsquo;s
+standard input, and <span class="RktVar">stderr</span> is used for the process&rsquo;s standard
+error.  All provided ports must be file-stream ports. Any of the ports
+can be <span class="RktVal">#f</span>, in which case a system pipe is created and
+returned by <span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess%29%29" class="RktValLink" data-pltdoc="x">subprocess</a></span>. The <span class="RktVar">stderr</span> argument can be
+<span class="RktVal">'</span><span class="RktVal">stdout</span>, in which case the same file-stream port or system pipe
+that is supplied as standard output is also used for standard error.
+For each port or <span class="RktVal">'</span><span class="RktVal">stdout</span> that is provided, no
+pipe is created and the corresponding returned value is <span class="RktVal">#f</span>.
+If <span class="RktVar">stdout</span> or <span class="RktVar">stderr</span> is a port for which
+<span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._port-waiting-peer~3f%29%29" class="RktValLink" data-pltdoc="x">port-waiting-peer?</a></span> returns true, then <span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess%29%29" class="RktValLink" data-pltdoc="x">subprocess</a></span>
+waits for the port to become ready for writing before proceeding with
+the subprocess creation.</p><p>If <span class="RktVar">group</span> is <span class="RktVal">'</span><span class="RktVal">new</span>, then the new process is created as
+a new OS-level process group. In that case, <span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-kill%29%29" class="RktValLink" data-pltdoc="x">subprocess-kill</a></span>
+attempts to terminate all processes within the group, which may
+include additional processes created by the subprocess.
+<span class="refelem"><span class="refcolumn"><span class="refcontent">Beware that creating a group may interfere with the job
+control in an interactive shell, since job control is based on process
+groups.</span></span></span> See <span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-kill%29%29" class="RktValLink" data-pltdoc="x">subprocess-kill</a></span> for details. If <span class="RktVar">group</span>
+is a subprocess, then that subprocess must have been created with
+<span class="RktVal">'</span><span class="RktVal">new</span>, and the new subprocess will be added to the group;
+adding to the group will succeed only on Unix and Mac OS, and only in
+the same cases that <span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-kill%29%29" class="RktValLink" data-pltdoc="x">subprocess-kill</a></span> would have an effect
+(i.e., the subprocess is not known to have terminated), otherwise it
+will fail silently.</p><p>The <span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess%29%29" class="RktValLink" data-pltdoc="x">subprocess</a></span> procedure returns four values:</p><ul><li><p>a <a name="(tech._subproces)"></a><span style="font-style: italic">subprocess</span> value representing the created process;</p></li><li><p>an input port piped from the process&rsquo;s standard output, or
+<span class="RktVal">#f</span> if <span class="RktVar">stdout</span> was a port;</p></li><li><p>an output port piped to the process&rsquo;s standard input, or
+<span class="RktVal">#f</span> if <span class="RktVar">stdin</span> was a port;</p></li><li><p>an input port piped from the process&rsquo;s standard error, or
+<span class="RktVal">#f</span> if <span class="RktVar">stderr</span> was a port or <span class="RktVal">'</span><span class="RktVal">stdout</span>.</p></li></ul><p><span style="font-weight: bold">Important:</span> All ports returned from <span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess%29%29" class="RktValLink" data-pltdoc="x">subprocess</a></span> must be
+explicitly closed, usually with <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-input-port%29%29" class="RktValLink" data-pltdoc="x">close-input-port</a></span> or
+<span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-output-port%29%29" class="RktValLink" data-pltdoc="x">close-output-port</a></span>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>A <a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file-stream port</span></a> for communicating with a
+subprocess is normally a pipe with a limited capacity. Beware of
+creating deadlock by serializing a write to a subprocess followed by a
+read, while the subprocess does the same, so that both processes end
+up blocking on a write because the other end must first read to make
+room in the pipe. Beware also of waiting for a subprocess to finish
+without reading its output, because the subprocess may be blocked attempting
+to write output into a full pipe.</p></blockquote></blockquote></blockquote><p>The returned ports are <a href="file-ports.html#%28tech._file._stream._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">file-stream ports</span></a> (see
+<a href="file-ports.html" data-pltdoc="x">File Ports</a>), and they are placed into the management of
+the current custodian (see <a href="custodians.html" data-pltdoc="x">Custodians</a>).  The
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span> exception is raised when a low-level error prevents the spawning of a
+process or the creation of operating system pipes for process
+communication.</p><p>The <span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._current-subprocess-custodian-mode%29%29" class="RktValLink" data-pltdoc="x">current-subprocess-custodian-mode</a></span> parameter determines
+whether the subprocess itself is registered with the current
+<a href="eval-model.html#%28tech._custodian%29" class="techoutside" data-pltdoc="x"><span class="techinside">custodian</span></a> so that a custodian shutdown calls
+<span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-kill%29%29" class="RktValLink" data-pltdoc="x">subprocess-kill</a></span> for the subprocess.</p><p>The <span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._current-subprocess-keep-file-descriptors%29%29" class="RktValLink" data-pltdoc="x">current-subprocess-keep-file-descriptors</a></span> parameter
+determines how file descriptors and handles in the current process are
+shared with the subprocess. File descriptors (on Unix and Mac OS) or
+handles (on Windows) represented by <span class="RktVar">stdin</span>, <span class="RktVar">stdout</span>,
+and <span class="RktVar">stderr</span> are always shared with the subprocess. With the
+default parameter value of <span class="RktVal">'</span><span class="RktVal">inherited</span>, handles that are
+inherited on Windows are also shared, while no other file descriptors
+are shared on Unix and Mac OS. The parameter value <span class="RktVal">'</span><span class="RktVal">all</span> is
+equivalent to <span class="RktVal">'</span><span class="RktVal">inherited</span> on Windows, but on Unix and Mac OS,
+all file descriptors from the current process are shared with the
+subprocess&#8212;<wbr></wbr>except for file descriptors 0, 1, and 2 as replaced by
+newly created pipes when the corresponding <span class="RktVar">stdin</span>,
+<span class="RktVar">stdout</span>, and <span class="RktVar">stderr</span> argument is <span class="RktVal">#f</span>. The
+parameter value <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span> is the same as <span class="RktVal">'</span><span class="RktVal">inherited</span> on
+Unix and Mac OS , but it prevents sharing of inheritable handles on
+Windows. (A future extension may support a list of specific file
+descriptors or handles to share.)</p><p>A subprocess can be used as a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> (see <a href="sync.html" data-pltdoc="x">Events</a>).
+A subprocess value is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when
+<span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-wait%29%29" class="RktValLink" data-pltdoc="x">subprocess-wait</a></span> would not block; the <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> of a subprocess value is the subprocess value itself.</p><p>Example:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">sp</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="hspace">&nbsp;</span><span class="RktSym">err</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess%29%29" class="RktValLink" data-pltdoc="x">subprocess</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">"/bin/ls"</span><span class="hspace">&nbsp;</span><span class="RktVal">"-l"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"stdout:\n~a"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3estring%29%29" class="RktValLink" data-pltdoc="x">port-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"stderr:\n~a"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._port-~3estring%29%29" class="RktValLink" data-pltdoc="x">port-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">err</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-input-port%29%29" class="RktValLink" data-pltdoc="x">close-input-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-output-port%29%29" class="RktValLink" data-pltdoc="x">close-output-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-input-port%29%29" class="RktValLink" data-pltdoc="x">close-input-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">err</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-wait%29%29" class="RktValLink" data-pltdoc="x">subprocess-wait</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sp</span><span class="RktPn">)</span></td></tr></table></blockquote><p class="SHistory">Changed in version 6.11.0.1 of package <span class="stt">base</span>: Added the <span class="RktVar">group</span> argument.<br/>Changed in version 7.4.0.5: Added waiting for a fifo without a reader
+as <span class="RktVar">stdout</span> and/or <span class="RktVar">stderr</span>.<br/>Changed in version 8.3.0.4: Added <span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._current-subprocess-custodian-mode%29%29" class="RktValLink" data-pltdoc="x">current-subprocess-custodian-mode</a></span> support.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._subprocess-wait))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-wait%29%29" class="RktValDef RktValLink" data-pltdoc="x">subprocess-wait</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">subproc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">subproc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess~3f%29%29" class="RktValLink" data-pltdoc="x">subprocess?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Blocks until the process represented by <span class="RktVar">subproc</span>
+terminates. The <span class="RktVar">subproc</span> value also can be used with
+<span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span> and <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">sync/timeout</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._subprocess-status))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-status%29%29" class="RktValDef RktValLink" data-pltdoc="x">subprocess-status</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">subproc</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">running</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">subproc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess~3f%29%29" class="RktValLink" data-pltdoc="x">subprocess?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <a name="(idx._(gentag._385._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">running</span> if the process represented by
+<span class="RktVar">subproc</span> is still running, or its exit code otherwise. The
+exit code is an exact integer, and <span class="RktVal">0</span> typically indicates
+success. If the process terminated due to a fault or signal, the exit
+code is non-zero.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._subprocess-kill))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-kill%29%29" class="RktValDef RktValLink" data-pltdoc="x">subprocess-kill</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">subproc</span><span class="hspace">&nbsp;</span><span class="RktVar">force?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">subproc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess~3f%29%29" class="RktValLink" data-pltdoc="x">subprocess?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">force?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Terminates the subprocess represented by <span class="RktVar">subproc</span>. The precise
+action depends on whether <span class="RktVar">force?</span> is true, whether the process
+was created in its own group by setting the
+<span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-group-enabled%29%29" class="RktValLink" data-pltdoc="x">subprocess-group-enabled</a></span> parameter to a true value, and the
+current platform:</div></p><ul><li><p><span class="RktVar">force?</span> is true, not a group, all platforms: Terminates
+the process if the process still running.</p></li><li><p><span class="RktVar">force?</span> is false, not a group, on Unix or Mac OS:
+Sends the process an interrupt signal instead of a kill
+signal.</p></li><li><p><span class="RktVar">force?</span> is false, not a group, on Windows: No action
+is taken.</p></li><li><p><span class="RktVar">force?</span> is true, a group, on Unix or Mac OS:
+Terminates all processes in the group, but only if
+<span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-status%29%29" class="RktValLink" data-pltdoc="x">subprocess-status</a></span> has never produced a
+non-<span class="RktVal">'</span><span class="RktVal">running</span> result for the subprocess and only if
+functions like <span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-wait%29%29" class="RktValLink" data-pltdoc="x">subprocess-wait</a></span> and <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span> have
+not detected the subprocess&rsquo;s completion. Otherwise, no action
+is taken (because the immediate process is known to have
+terminated while the continued existence of the group is
+unknown).</p></li><li><p><span class="RktVar">force?</span> is true, a group, on Windows: Terminates
+the process if the process still running.</p></li><li><p><span class="RktVar">force?</span> is false, a group, on Unix or Mac OS: The
+same as when <span class="RktVar">force?</span> is <span class="RktVal">#t</span>, but when the group
+is sent a signal, it is an interrupt signal instead of a kill
+signal.</p></li><li><p><span class="RktVar">force?</span> is false, a group, on Windows: All processes
+in the group receive a CTRL-BREAK signal (independent of
+whether the immediate subprocess has terminated).</p></li></ul><p>If an error occurs during termination, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._subprocess-pid))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-pid%29%29" class="RktValDef RktValLink" data-pltdoc="x">subprocess-pid</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">subproc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">subproc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess~3f%29%29" class="RktValLink" data-pltdoc="x">subprocess?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the operating system&rsquo;s numerical ID (if any) for the process
+represented by <span class="RktVar">subproc</span>. The result is valid only as long as
+the process is running.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._subprocess~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">subprocess?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a subprocess value, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-subprocess-custodian-mode))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._current-subprocess-custodian-mode%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-subprocess-custodian-mode</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">kill</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">interrupt</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._current-subprocess-custodian-mode%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-subprocess-custodian-mode</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">mode</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">kill</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">interrupt</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines whether a subprocess (as created by
+<span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess%29%29" class="RktValLink" data-pltdoc="x">subprocess</a></span> or wrappers like <span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%29%29" class="RktValLink" data-pltdoc="x">process</a></span>) is registered
+with the current <a href="eval-model.html#%28tech._custodian%29" class="techoutside" data-pltdoc="x"><span class="techinside">custodian</span></a>. If the parameter value is
+<span class="RktVal">#f</span>, then the subprocess is not registered with the
+custodian&#8212;<wbr></wbr>although any created ports are registered. If the
+parameter value is <span class="RktVal">'</span><span class="RktVal">kill</span> or <span class="RktVal">'</span><span class="RktVal">interrupt</span>, then the
+subprocess is shut down through <span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-kill%29%29" class="RktValLink" data-pltdoc="x">subprocess-kill</a></span>, where
+<span class="RktVal">'</span><span class="RktVal">kill</span> supplies a <span class="RktVal">#t</span> value for the <span class="RktVar">force?</span>
+argument and <span class="RktVal">'</span><span class="RktVal">interrupt</span> supplies a <span class="RktVal">#f</span> value. The
+shutdown may occur either before or after ports created for the
+subprocess are closed.</div></p><p>Custodian-triggered shutdown is limited by details of process handling
+in the host system. For example, <span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%29%29" class="RktValLink" data-pltdoc="x">process</a></span> and <span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%29%29" class="RktValLink" data-pltdoc="x">system</a></span>
+may create an intermediate shell process to run a program, in which
+case custodian-based termination shuts down the shell process and
+probably not the process started by the shell. See also
+<span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-kill%29%29" class="RktValLink" data-pltdoc="x">subprocess-kill</a></span>. Process groups (see
+<span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-group-enabled%29%29" class="RktValLink" data-pltdoc="x">subprocess-group-enabled</a></span>) can address some limitations, but
+not all of them.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._subprocess-group-enabled))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-group-enabled%29%29" class="RktValDef RktValLink" data-pltdoc="x">subprocess-group-enabled</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-group-enabled%29%29" class="RktValDef RktValLink" data-pltdoc="x">subprocess-group-enabled</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">on?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">on?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines whether a subprocess is created as
+a new process group by default. See <span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess%29%29" class="RktValLink" data-pltdoc="x">subprocess</a></span> and
+<span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-kill%29%29" class="RktValLink" data-pltdoc="x">subprocess-kill</a></span> for more information.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-subprocess-keep-file-descriptors))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._current-subprocess-keep-file-descriptors%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-subprocess-keep-file-descriptors</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">inherited</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">all</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._current-subprocess-keep-file-descriptors%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-subprocess-keep-file-descriptors</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">keeps</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">keeps</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">inherited</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">all</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines how file descriptors (on Unix and
+Mac OS) and handles (on Windows) are shared in a subprocess as created
+by <span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess%29%29" class="RktValLink" data-pltdoc="x">subprocess</a></span> or wrappers like <span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%29%29" class="RktValLink" data-pltdoc="x">process</a></span>. See
+<span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess%29%29" class="RktValLink" data-pltdoc="x">subprocess</a></span> for more information.</div></p><p class="SHistory">Added in version 8.3.0.4 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._shell-execute))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._shell-execute%29%29" class="RktValDef RktValLink" data-pltdoc="x">shell-execute</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">verb</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">target</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">parameters</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">dir</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">show-mode</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">#f</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">verb</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">target</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">parameters</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dir</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">show-mode</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"><a name="(idx._(gentag._386._(lib._scribblings/reference/reference..scrbl)))"></a>Performs the action specified by <span class="RktVar">verb</span>
+on <span class="RktVar">target</span> in Windows. For platforms other than Windows, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3aunsupported%29%29" class="RktValLink" data-pltdoc="x">exn:fail:unsupported</a></span> exception is raised.</div></p><p>For example,</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._shell-execute%29%29" class="RktValLink" data-pltdoc="x">shell-execute</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">"http://racket-lang.org"</span><span class="hspace">&nbsp;</span><span class="RktVal">""</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">sw_shownormal</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Opens the Racket home page in a browser window.</p><p>The <span class="RktVar">verb</span> can be <span class="RktVal">#f</span>, in which case the operating
+system will use a default verb. Common verbs include <span class="RktVal">"open"</span>,
+<span class="RktVal">"edit"</span>, <span class="RktVal">"find"</span>, <span class="RktVal">"explore"</span>, and
+<span class="RktVal">"print"</span>.</p><p>The <span class="RktVar">target</span> is the target for the action, usually a filename
+path. The file could be executable, or it could be a file with a
+recognized extension that can be handled by an installed application.</p><p>The <span class="RktVar">parameters</span> argument is passed on to the system to perform
+the action. For example, in the case of opening an executable, the
+<span class="RktVar">parameters</span> is used as the command line (after the executable
+name).</p><p>The <span class="RktVar">dir</span> is used as the current directory when performing the
+action.</p><p>The <span class="RktVar">show-mode</span> sets the display mode for a Window affected by
+the action. It must be one of the following symbols; the description
+of each symbol&rsquo;s meaning is taken from the Windows API documentation.</p><ul><li><p><a name="(idx._(gentag._387._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">sw_hide</span> or <a name="(idx._(gentag._388._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">SW_HIDE</span> &#8212;<wbr></wbr>
+Hides the window and activates another window.</p></li><li><p><a name="(idx._(gentag._389._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">sw_maximize</span> or <a name="(idx._(gentag._390._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">SW_MAXIMIZE</span>
+&#8212;<wbr></wbr> Maximizes the window.</p></li><li><p><a name="(idx._(gentag._391._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">sw_minimize</span> or <a name="(idx._(gentag._392._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">SW_MINIMIZE</span>
+&#8212;<wbr></wbr> Minimizes the window and activates the next top-level window in
+the z-order.</p></li><li><p><a name="(idx._(gentag._393._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">sw_restore</span> or <a name="(idx._(gentag._394._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">SW_RESTORE</span>
+&#8212;<wbr></wbr> Activates and displays the window. If the window is minimized or
+maximized, Windows restores it to its original size and position.</p></li><li><p><a name="(idx._(gentag._395._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">sw_show</span> or <a name="(idx._(gentag._396._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">SW_SHOW</span> &#8212;<wbr></wbr>
+Activates the window and displays it in its current size and
+position.</p></li><li><p><a name="(idx._(gentag._397._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">sw_showdefault</span> or
+<a name="(idx._(gentag._398._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">SW_SHOWDEFAULT</span> &#8212;<wbr></wbr> Uses a default.</p></li><li><p><a name="(idx._(gentag._399._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">sw_showmaximized</span> or
+<a name="(idx._(gentag._400._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">SW_SHOWMAXIMIZED</span> &#8212;<wbr></wbr> Activates the window and
+displays it as a maximized window.</p></li><li><p><a name="(idx._(gentag._401._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">sw_showminimized</span> or
+<a name="(idx._(gentag._402._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">SW_SHOWMINIMIZED</span> &#8212;<wbr></wbr> Activates the window and
+displays it as a minimized window.</p></li><li><p><a name="(idx._(gentag._403._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">sw_showminnoactive</span> or
+<a name="(idx._(gentag._404._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">SW_SHOWMINNOACTIVE</span> &#8212;<wbr></wbr> Displays the window as a
+minimized window. The active window remains active.</p></li><li><p><a name="(idx._(gentag._405._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">sw_showna</span> or <a name="(idx._(gentag._406._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">SW_SHOWNA</span> &#8212;<wbr></wbr>
+Displays the window in its current state. The active window remains
+active.</p></li><li><p><a name="(idx._(gentag._407._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">sw_shownoactivate</span> or
+<a name="(idx._(gentag._408._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">SW_SHOWNOACTIVATE</span> &#8212;<wbr></wbr> Displays a window in its most
+recent size and position. The active window remains active.</p></li><li><p><a name="(idx._(gentag._409._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">sw_shownormal</span> or
+<a name="(idx._(gentag._410._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">SW_SHOWNORMAL</span> &#8212;<wbr></wbr> Activates and displays a
+window. If the window is minimized or maximized, Windows restores it
+to its original size and position.</p></li></ul><p>If the action fails, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span> exception is raised. If the action succeeds,
+the result is <span class="RktVal">#f</span>.</p><p>In future versions of Racket, the result may be a subprocess value if
+the operating system did returns a process handle (but if a subprocess
+value is returned, its process ID will be <span class="RktVal">0</span> instead of the
+real process ID).</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Simple_Subprocesses&quot;">15.4.1<tt>&nbsp;</tt><a name="(part._.Simple_.Subprocesses)"></a><a name="(mod-path._racket/system)"></a>Simple Subprocesses</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="subprocess.html#%28mod-path._racket%2Fsystem%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/system</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="subprocess.html#%28mod-path._racket%2Fsystem%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/system</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/system..rkt)._system))"></a><span title="Provided from: racket/system, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%29%29" class="RktValDef RktValLink" data-pltdoc="x">system</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">command</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktPn">#:set-pwd?</span><span class="hspace">&nbsp;</span><span class="RktVar">set-pwd?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">command</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._string-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">string-no-nuls?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._bytes-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-no-nuls?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-pwd?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">unix</span><span class="hspace">&nbsp;</span><span class="RktVal">macosx</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Executes a Unix, Mac OS, or Windows shell command synchronously
+(i.e., the call to <span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%29%29" class="RktValLink" data-pltdoc="x">system</a></span> does not return until the
+subprocess has ended). The <span class="RktVar">command</span> argument is a string or
+byte string containing no nul characters. If the command succeeds, the
+return value is <span class="RktVal">#t</span>, <span class="RktVal">#f</span> otherwise.</div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See also <span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess%29%29" class="RktValLink" data-pltdoc="x">subprocess</a></span> for notes about error
+handling and the limited buffer capacity of subprocess pipes.</p></blockquote></blockquote></blockquote><p>If <span class="RktVar">set-pwd?</span> is true, then the <span class="stt">PWD</span> environment
+variable is set to the value of <span class="RktPn">(</span><span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span><span class="RktPn">)</span> when
+starting the shell process.</p><p>See also <span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._current-subprocess-custodian-mode%29%29" class="RktValLink" data-pltdoc="x">current-subprocess-custodian-mode</a></span> and
+<span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-group-enabled%29%29" class="RktValLink" data-pltdoc="x">subprocess-group-enabled</a></span>, which affect the subprocess used to
+implement <span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%29%29" class="RktValLink" data-pltdoc="x">system</a></span>.</p><p>The resulting process writes to <span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span>, reads
+from <span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-input-port%29%29" class="RktValLink" data-pltdoc="x">current-input-port</a></span><span class="RktPn">)</span>, and logs errors to
+<span class="RktPn">(</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-error-port%29%29" class="RktValLink" data-pltdoc="x">current-error-port</a></span><span class="RktPn">)</span>. To gather the process&rsquo;s non-error
+output to a string, for example, use <span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._with-output-to-string%29%29" class="RktValLink" data-pltdoc="x">with-output-to-string</a></span>,
+which sets <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._current-output-port%29%29" class="RktValLink" data-pltdoc="x">current-output-port</a></span> while calling the given
+function:</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="port-lib.html#%28def._%28%28lib._racket%2Fport..rkt%29._with-output-to-string%29%29" class="RktValLink" data-pltdoc="x">with-output-to-string</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%29%29" class="RktValLink" data-pltdoc="x">system</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"date"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/system..rkt)._system*))"></a><span title="Provided from: racket/system, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">system*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">command</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktPn">#:set-pwd?</span><span class="hspace">&nbsp;</span><span class="RktVar">set-pwd?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">command</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._string-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">string-no-nuls?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._bytes-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-no-nuls?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-pwd?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">unix</span><span class="hspace">&nbsp;</span><span class="RktVal">macosx</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="RktPn">(</span><span title="Provided from: racket/system, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">system*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">command</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">exact</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arg</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:set-pwd?</span><span class="hspace">&nbsp;</span><span class="RktVar">set-pwd?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">command</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">exact</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exact</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-pwd?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">unix</span><span class="hspace">&nbsp;</span><span class="RktVal">macosx</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%29%29" class="RktValLink" data-pltdoc="x">system</a></span>, except that <span class="RktVar">command</span> is a filename that
+is executed directly (instead of through a shell command; see
+<span class="RktSym"><a href="Filesystem.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._find-executable-path%29%29" class="RktValLink" data-pltdoc="x">find-executable-path</a></span> for locating an executable based on
+the <span class="stt">PATH</span> environment variable), and the
+<span class="RktVar">arg</span>s are the arguments. The executed file is passed the
+specified string arguments (which must contain no nul
+characters).</div></p><p>On Windows, the first argument after <span class="RktVar">command</span> can be
+<span class="RktVal">'</span><span class="RktVal">exact</span>, and the final <span class="RktVar">arg</span> is a complete command
+line. See <span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess%29%29" class="RktValLink" data-pltdoc="x">subprocess</a></span> for details.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/system..rkt)._system/exit-code))"></a><span title="Provided from: racket/system, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%2Fexit-code%29%29" class="RktValDef RktValLink" data-pltdoc="x">system/exit-code</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">command</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:set-pwd?</span><span class="hspace">&nbsp;</span><span class="RktVar">set-pwd?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">command</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._string-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">string-no-nuls?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._bytes-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-no-nuls?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-pwd?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">unix</span><span class="hspace">&nbsp;</span><span class="RktVal">macosx</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%29%29" class="RktValLink" data-pltdoc="x">system</a></span>, except that the result is the exit code returned
+by the subprocess. A <span class="RktVal">0</span> result normally indicates success.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/system..rkt)._system*/exit-code))"></a><span title="Provided from: racket/system, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%2A%2Fexit-code%29%29" class="RktValDef RktValLink" data-pltdoc="x">system*/exit-code</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">command</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:set-pwd?</span><span class="hspace">&nbsp;</span><span class="RktVar">set-pwd?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">command</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._string-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">string-no-nuls?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._bytes-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-no-nuls?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-pwd?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">unix</span><span class="hspace">&nbsp;</span><span class="RktVal">macosx</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="RktPn">(</span><span title="Provided from: racket/system, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%2A%2Fexit-code%29%29" class="RktValDef RktValLink" data-pltdoc="x">system*/exit-code</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">command</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">exact</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arg</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:set-pwd?</span><span class="hspace">&nbsp;</span><span class="RktVar">set-pwd?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">command</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">exact</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exact</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-pwd?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">unix</span><span class="hspace">&nbsp;</span><span class="RktVal">macosx</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%2A%29%29" class="RktValLink" data-pltdoc="x">system*</a></span>, but returns the exit code like
+<span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%2Fexit-code%29%29" class="RktValLink" data-pltdoc="x">system/exit-code</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/system..rkt)._process))"></a><span title="Provided from: racket/system, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%29%29" class="RktValDef RktValLink" data-pltdoc="x">process</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">command</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktPn">#:set-pwd?</span><span class="hspace">&nbsp;</span><span class="RktVar">set-pwd?</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">status</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">wait</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">interrupt</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">kill</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">command</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._string-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">string-no-nuls?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._bytes-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-no-nuls?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-pwd?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">unix</span><span class="hspace">&nbsp;</span><span class="RktVal">macosx</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Executes a shell command asynchronously (using <span class="stt">sh</span> on Unix
+and Mac OS, <span class="stt">cmd</span> on Windows). The result is a list of five
+values:</div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See also <span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess%29%29" class="RktValLink" data-pltdoc="x">subprocess</a></span> for notes about error
+handling and the limited buffer capacity of subprocess pipes.</p></blockquote></blockquote></blockquote><ul><li><p>an input port piped from the subprocess&rsquo;s standard output,</p></li><li><p>an output port piped to the subprocess&rsquo;s standard input,</p></li><li><p>the system process id of the subprocess,</p></li><li><p>an input port piped from the subprocess&rsquo;s standard
+error, and</p></li><li><p>a procedure of one argument, either <span class="RktVal">'</span><span class="RktVal">status</span>, <span class="RktVal">'</span><span class="RktVal">wait</span>,
+<span class="RktVal">'</span><span class="RktVal">interrupt</span>, <span class="RktVal">'</span><span class="RktVal">exit-code</span> or <span class="RktVal">'</span><span class="RktVal">kill</span>:</p><ul><li><p><span class="RktVal">'</span><span class="RktVal">status</span> returns the status of the subprocess as one
+of <span class="RktVal">'</span><span class="RktVal">running</span>, <span class="RktVal">'</span><span class="RktVal">done-ok</span>, or
+<span class="RktVal">'</span><span class="RktVal">done-error</span>.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">exit-code</span> returns the integer exit code of the
+subprocess or <span class="RktVal">#f</span> if it is still running.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">wait</span> blocks execution in the current thread until
+the subprocess has completed.</p></li><li><p><span class="RktVal">'</span><span class="RktVal">interrupt</span> sends the subprocess an interrupt signal
+on Unix and Mac OS, and takes no action on Windows. The result is
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>On Unix and Mac OS, if <span class="RktVar">command</span> runs a
+single program, then <span class="stt">sh</span> typically runs the program in
+such a way that it replaces <span class="stt">sh</span> in the same process. For
+reliable and precise control over process creation, however, use
+<span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%2A%29%29" class="RktValLink" data-pltdoc="x">process*</a></span>.</p></blockquote></blockquote></blockquote></li><li><p><span class="RktVal">'</span><span class="RktVal">kill</span> terminates the subprocess and returns
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.  Note that the immediate process created by
+<span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%29%29" class="RktValLink" data-pltdoc="x">process</a></span> is a shell process that may run another program;
+terminating the shell process may not terminate processes that
+the shell starts, particularly on Windows.</p></li></ul></li></ul><p><span style="font-weight: bold">Important:</span> All three ports returned from <span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%29%29" class="RktValLink" data-pltdoc="x">process</a></span> must
+be explicitly closed with <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-input-port%29%29" class="RktValLink" data-pltdoc="x">close-input-port</a></span> or
+<span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-output-port%29%29" class="RktValLink" data-pltdoc="x">close-output-port</a></span>.</p><p>If <span class="RktVar">set-pwd?</span> is true, then <span class="stt">PWD</span> is set in the same way
+as <span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%29%29" class="RktValLink" data-pltdoc="x">system</a></span>.</p><p>See also <span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._current-subprocess-custodian-mode%29%29" class="RktValLink" data-pltdoc="x">current-subprocess-custodian-mode</a></span> and
+<span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-group-enabled%29%29" class="RktValLink" data-pltdoc="x">subprocess-group-enabled</a></span>, which affect the subprocess used to
+implement <span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%29%29" class="RktValLink" data-pltdoc="x">process</a></span>. In particular, the <span class="RktVal">'</span><span class="RktVal">interrupt</span> and
+<span class="RktVal">'</span><span class="RktVal">kill</span> process-control messages are implemented via
+<span class="RktSym"><a href="subprocess.html#%28def._%28%28quote._~23~25kernel%29._subprocess-kill%29%29" class="RktValLink" data-pltdoc="x">subprocess-kill</a></span>, so they can affect a process group instead
+of a single process.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/system..rkt)._process*))"></a><span title="Provided from: racket/system, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">process*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">command</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:set-pwd?</span><span class="hspace">&nbsp;</span><span class="RktVar">set-pwd?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">command</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._string-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">string-no-nuls?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._bytes-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-no-nuls?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-pwd?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">unix</span><span class="hspace">&nbsp;</span><span class="RktVal">macosx</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="RktPn">(</span><span title="Provided from: racket/system, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">process*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">command</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">exact</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arg</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:set-pwd?</span><span class="hspace">&nbsp;</span><span class="RktVar">set-pwd?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">command</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">exact</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exact</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-pwd?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">unix</span><span class="hspace">&nbsp;</span><span class="RktVal">macosx</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%29%29" class="RktValLink" data-pltdoc="x">process</a></span>, except that <span class="RktVar">command</span> is a filename that
+is executed directly like <span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%2A%29%29" class="RktValLink" data-pltdoc="x">system*</a></span>, and the <span class="RktVar">arg</span>s are the arguments. On
+Windows, as for <span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%2A%29%29" class="RktValLink" data-pltdoc="x">system*</a></span>, the first <span class="RktVar">arg</span> can be
+replaced with <span class="RktVal">'</span><span class="RktVal">exact</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/system..rkt)._process/ports))"></a><span title="Provided from: racket/system, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%2Fports%29%29" class="RktValDef RktValLink" data-pltdoc="x">process/ports</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">error-out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">command</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:set-pwd?</span><span class="hspace">&nbsp;</span><span class="RktVar">set-pwd?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">error-out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">stdout</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">command</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._string-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">string-no-nuls?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._bytes-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-no-nuls?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-pwd?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">unix</span><span class="hspace">&nbsp;</span><span class="RktVal">macosx</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%29%29" class="RktValLink" data-pltdoc="x">process</a></span>, except that <span class="RktVar">out</span> is used for the
+process&rsquo;s standard output, <span class="RktVar">in</span> is used for the process&rsquo;s
+standard input, and <span class="RktVar">error-out</span> is used for the process&rsquo;s
+standard error.  Any of the ports can be <span class="RktVal">#f</span>, in which case a
+system pipe is created and returned, as in <span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%29%29" class="RktValLink" data-pltdoc="x">process</a></span>. If
+<span class="RktVar">error-out</span> is <span class="RktVal">'</span><span class="RktVal">stdout</span>, then standard error is
+redirected to standard output.  For each port or <span class="RktVal">'</span><span class="RktVal">stdout</span> that
+is provided, no pipe is created, and the corresponding value in the
+returned list is <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/system..rkt)._process*/ports))"></a><span title="Provided from: racket/system, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%2A%2Fports%29%29" class="RktValDef RktValLink" data-pltdoc="x">process*/ports</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">error-out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">command</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:set-pwd?</span><span class="hspace">&nbsp;</span><span class="RktVar">set-pwd?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">error-out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">stdout</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">command</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path~3f%29%29" class="RktValLink" data-pltdoc="x">path?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._string-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">string-no-nuls?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._bytes-no-nuls~3f%29%29" class="RktValLink" data-pltdoc="x">bytes-no-nuls?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-pwd?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">unix</span><span class="hspace">&nbsp;</span><span class="RktVal">macosx</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="RktPn">(</span><span title="Provided from: racket/system, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%2A%2Fports%29%29" class="RktValDef RktValLink" data-pltdoc="x">process*/ports</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">error-out</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">command</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">exact</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">arg</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:set-pwd?</span><span class="hspace">&nbsp;</span><span class="RktVar">set-pwd?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">in</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">error-out</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">stdout</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">command</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._path-string~3f%29%29" class="RktValLink" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">exact</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">exact</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">set-pwd?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._member%29%29" class="RktValLink" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="runtime.html#%28def._%28%28quote._~23~25kernel%29._system-type%29%29" class="RktValLink" data-pltdoc="x">system-type</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">unix</span><span class="hspace">&nbsp;</span><span class="RktVal">macosx</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%2A%29%29" class="RktValLink" data-pltdoc="x">process*</a></span>, but with the port handling of
+<span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._process%2Fports%29%29" class="RktValLink" data-pltdoc="x">process/ports</a></span>.</div></p><p>The contracts of <span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._system%29%29" class="RktValLink" data-pltdoc="x">system</a></span> and related functions may signal a
+contract error with references to the following functions.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/system..rkt)._string-no-nuls~3f))"></a><span title="Provided from: racket/system, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._string-no-nuls~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-no-nuls?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Ensures that <span class="RktVar">x</span> is a string and does not contain <span class="RktVal">"\u0000"</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/system..rkt)._bytes-no-nuls~3f))"></a><span title="Provided from: racket/system, racket | Package: base"><span class="RktSym"><a href="subprocess.html#%28def._%28%28lib._racket%2Fsystem..rkt%29._bytes-no-nuls~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">bytes-no-nuls?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Ensures that <span class="RktVar">x</span> is a byte-string and does not contain <span class="RktVal">#"\0"</span>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="udp.html" title="backward to &quot;15.3.2 UDP&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="os.html" title="up to &quot;15 Operating System&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="logging.html" title="forward to &quot;15.5 Logging&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/symbols.html b/clones/docs.racket-lang.org/reference/symbols.html
new file mode 100644
index 00000000..32cdb2e3
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/symbols.html
@@ -0,0 +1,46 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.7&nbsp;Symbols</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewselflink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.7&nbsp;</td><td><a href="symbols.html" class="tocviewselflink" data-pltdoc="x">Symbols</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.7.1&nbsp;</td><td><a href="symbols.html#%28part._.Additional_.Symbol_.Functions%29" class="tocviewlink" data-pltdoc="x">Additional Symbol Functions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">symbol?</span></span></a></td></tr><tr><td><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-interned~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">symbol-<wbr></wbr>interned?</span></span></a></td></tr><tr><td><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-unreadable~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">symbol-<wbr></wbr>unreadable?</span></span></a></td></tr><tr><td><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-~3estring%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">symbol-<wbr></wbr>&gt;string</span></span></a></td></tr><tr><td><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3esymbol%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>&gt;symbol</span></span></a></td></tr><tr><td><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3euninterned-symbol%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>&gt;uninterned-<wbr></wbr>symbol</span></span></a></td></tr><tr><td><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3eunreadable-symbol%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">string-<wbr></wbr>&gt;unreadable-<wbr></wbr>symbol</span></span></a></td></tr><tr><td><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._gensym%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">gensym</span></span></a></td></tr><tr><td><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3c~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">symbol&lt;?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.7.1<tt>&nbsp;</tt></span><a href="symbols.html#%28part._.Additional_.Symbol_.Functions%29" class="tocsubseclink" data-pltdoc="x">Additional Symbol Functions</a></td></tr><tr><td><a href="symbols.html#%28def._%28%28lib._racket%2Fsymbol..rkt%29._symbol-~3eimmutable-string%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">symbol-<wbr></wbr>&gt;immutable-<wbr></wbr>string</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="characters.html" title="backward to &quot;4.6 Characters&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="regexp.html" title="forward to &quot;4.8 Regular Expressions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;symbols&quot;">4.7<tt>&nbsp;</tt><a name="(part._symbols)"></a><a name="(idx._(gentag._181._(lib._scribblings/reference/reference..scrbl)))"></a><a name="(idx._(gentag._182._(lib._scribblings/reference/reference..scrbl)))"></a>Symbols</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=symbols.html&amp;version=8.6" class="Sq" data-pltdoc="x">Symbols</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces symbols.</p></blockquote></blockquote></blockquote><p>A <a name="(tech._symbol)"></a><span style="font-style: italic">symbol</span> is like an immutable string, but symbols are
+normally <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a>, so that two symbols with the same
+character content are normally <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>. All symbols produced by
+the default reader (see <a href="reader.html#%28part._parse-symbol%29" data-pltdoc="x">Reading Symbols</a>) are <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a>.</p><p>The two procedures <span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3euninterned-symbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;uninterned-symbol</a></span> and
+<span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._gensym%29%29" class="RktValLink" data-pltdoc="x">gensym</a></span> generate <a name="(tech._uninterned)"></a><span style="font-style: italic">uninterned</span> symbols, i.e., symbols
+that are not <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to any
+other symbol, although they may print the same as other symbols.</p><p>The procedure <span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3eunreadable-symbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;unreadable-symbol</a></span> returns an
+<a name="(tech._unreadable._symbol)"></a><span style="font-style: italic">unreadable symbol</span> that is partially interned.  The default
+reader (see <a href="reader.html#%28part._parse-symbol%29" data-pltdoc="x">Reading Symbols</a>) never produces a unreadable
+symbol, but two calls to <span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3eunreadable-symbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;unreadable-symbol</a></span> with
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> strings produce <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> results. An unreadable
+symbol can print the same as an interned or uninterned
+symbol. Unreadable symbols are useful in expansion and
+compilation to avoid collisions with symbols that appear in the
+source; they are usually not generated directly, but they can appear
+in the result of functions like <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="RktValLink" data-pltdoc="x">identifier-binding</a></span>.</p><p>Interned and unreadable symbols are only weakly held by the internal
+symbol table. This weakness can never affect the result of an
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>, <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>, or <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> test, but a symbol may
+disappear when placed into a weak box (see <a href="weakbox.html" data-pltdoc="x">Weak Boxes</a>), used as
+the key in a weak <a href="hashtables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash table</span></a> (see <a href="hashtables.html" data-pltdoc="x">Hash Tables</a>), or
+used as an ephemeron key (see <a href="ephemerons.html" data-pltdoc="x">Ephemerons</a>).</p><p>See <a href="reader.html#%28part._parse-symbol%29" data-pltdoc="x">Reading Symbols</a>
+    for information on <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>ing
+    symbols and <a href="printing.html#%28part._print-symbol%29" data-pltdoc="x">Printing Symbols</a>
+    for information on <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>ing symbols.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._symbol~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">symbol?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is
+ a symbol, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">Apple</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._symbol-interned~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-interned~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">symbol-interned?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sym</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">sym</span> is
+ <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-interned~3f%29%29" class="RktValLink" data-pltdoc="x">symbol-interned?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">Apple</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-interned~3f%29%29" class="RktValLink" data-pltdoc="x">symbol-interned?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._gensym%29%29" class="RktValLink" data-pltdoc="x">gensym</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-interned~3f%29%29" class="RktValLink" data-pltdoc="x">symbol-interned?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3eunreadable-symbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;unreadable-symbol</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._symbol-unreadable~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-unreadable~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">symbol-unreadable?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sym</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">sym</span> is
+ an <a href="symbols.html#%28tech._unreadable._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">unreadable symbol</span></a>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-unreadable~3f%29%29" class="RktValLink" data-pltdoc="x">symbol-unreadable?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">Apple</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-unreadable~3f%29%29" class="RktValLink" data-pltdoc="x">symbol-unreadable?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._gensym%29%29" class="RktValLink" data-pltdoc="x">gensym</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-unreadable~3f%29%29" class="RktValLink" data-pltdoc="x">symbol-unreadable?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3eunreadable-symbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;unreadable-symbol</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._symbol-~3estring))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-~3estring%29%29" class="RktValDef RktValLink" data-pltdoc="x">symbol-&gt;string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sym</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a freshly
+ allocated mutable string whose characters are the same as in
+ <span class="RktVar">sym</span>.</div></p><p>See also <span class="RktSym"><a href="symbols.html#%28def._%28%28lib._racket%2Fsymbol..rkt%29._symbol-~3eimmutable-string%29%29" class="RktValLink" data-pltdoc="x">symbol-&gt;immutable-string</a></span> from
+<a href="symbols.html#%28mod-path._racket%2Fsymbol%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/symbol</span></a>.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-~3estring%29%29" class="RktValLink" data-pltdoc="x">symbol-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">Apple</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Apple"</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-~3esymbol))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3esymbol%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-&gt;symbol</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an
+ <a href="reader.html#%28tech._interned%29" class="techoutside" data-pltdoc="x"><span class="techinside">interned</span></a> symbol whose characters are the same as in
+ <span class="RktVar">str</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3esymbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;symbol</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'Apple</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3esymbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;symbol</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"1"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'|1|</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-~3euninterned-symbol))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3euninterned-symbol%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-&gt;uninterned-symbol</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like
+ <span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3esymbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;symbol</a></span><span class="stt"> </span><span class="RktVar">str</span><span class="RktPn">)</span>, but the resulting symbol is a new
+ <a href="symbols.html#%28tech._uninterned%29" class="techoutside" data-pltdoc="x"><span class="techinside">uninterned</span></a> symbol. Calling <span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3euninterned-symbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;uninterned-symbol</a></span>
+ twice with the same <span class="RktVar">str</span> returns two distinct symbols.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3euninterned-symbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;uninterned-symbol</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'Apple</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3euninterned-symbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;uninterned-symbol</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3euninterned-symbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;uninterned-symbol</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3euninterned-symbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;uninterned-symbol</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._string-~3eunreadable-symbol))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3eunreadable-symbol%29%29" class="RktValDef RktValLink" data-pltdoc="x">string-&gt;unreadable-symbol</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like
+ <span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3esymbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;symbol</a></span><span class="stt"> </span><span class="RktVar">str</span><span class="RktPn">)</span>, but the resulting symbol is a new
+ <a href="symbols.html#%28tech._unreadable._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">unreadable symbol</span></a>. Calling <span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3eunreadable-symbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;unreadable-symbol</a></span>
+ twice with equivalent <span class="RktVar">str</span>s returns the same symbol, but
+ <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span> never produces the symbol.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3eunreadable-symbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;unreadable-symbol</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'Apple</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3eunreadable-symbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;unreadable-symbol</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3eunreadable-symbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;unreadable-symbol</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3eunreadable-symbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;unreadable-symbol</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._gensym))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._gensym%29%29" class="RktValDef RktValLink" data-pltdoc="x">gensym</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">base</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">base</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">"g"</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a
+new <a href="symbols.html#%28tech._uninterned%29" class="techoutside" data-pltdoc="x"><span class="techinside">uninterned</span></a> symbol with an automatically-generated name. The
+optional <span class="RktVar">base</span> argument is a prefix symbol or string.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._gensym%29%29" class="RktValLink" data-pltdoc="x">gensym</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'apple9289506</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._symbol~3c~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3c~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">symbol&lt;?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a-sym</span><span class="hspace">&nbsp;</span><span class="RktVar">b-sym</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a-sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b-sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if the arguments are sorted, where the comparison
+for each pair of symbols is the same as using
+<span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-~3estring%29%29" class="RktValLink" data-pltdoc="x">symbol-&gt;string</a></span> with <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._string-~3ebytes%2Futf-8%29%29" class="RktValLink" data-pltdoc="x">string-&gt;bytes/utf-8</a></span> and
+<span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3c~3f%29%29" class="RktValLink" data-pltdoc="x">bytes&lt;?</a></span>.</div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one argument, in addition to allowing two or more.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Additional_Symbol_Functions&quot;">4.7.1<tt>&nbsp;</tt><a name="(part._.Additional_.Symbol_.Functions)"></a><a name="(mod-path._racket/symbol)"></a>Additional Symbol Functions</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="symbols.html#%28mod-path._racket%2Fsymbol%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/symbol</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="symbols.html#%28mod-path._racket%2Fsymbol%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/symbol</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p class="SHistory">Added in version 7.6 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/symbol..rkt)._symbol-~3eimmutable-string))"></a><span title="Provided from: racket/symbol, racket | Package: base"><span class="RktSym"><a href="symbols.html#%28def._%28%28lib._racket%2Fsymbol..rkt%29._symbol-~3eimmutable-string%29%29" class="RktValDef RktValLink" data-pltdoc="x">symbol-&gt;immutable-string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">sym</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol-~3estring%29%29" class="RktValLink" data-pltdoc="x">symbol-&gt;string</a></span>, but the result is an immutable string,
+not necessarily freshly allocated.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28lib._racket%2Fsymbol..rkt%29._symbol-~3eimmutable-string%29%29" class="RktValLink" data-pltdoc="x">symbol-&gt;immutable-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">Apple</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Apple"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="symbols.html#%28def._%28%28lib._racket%2Fsymbol..rkt%29._symbol-~3eimmutable-string%29%29" class="RktValLink" data-pltdoc="x">symbol-&gt;immutable-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">Apple</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 7.6 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="characters.html" title="backward to &quot;4.6 Characters&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="regexp.html" title="forward to &quot;4.8 Regular Expressions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/sync.html b/clones/docs.racket-lang.org/reference/sync.html
new file mode 100644
index 00000000..032a1ce9
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/sync.html
@@ -0,0 +1,144 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>11.2.1&nbsp;Events</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewselflink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.1&nbsp;</td><td><a href="threads.html" class="tocviewlink" data-pltdoc="x">Threads</a></td></tr><tr><td align="right">11.2&nbsp;</td><td><a href="all-sync.html" class="tocviewselflink" data-pltdoc="x">Synchronization</a></td></tr><tr><td align="right">11.3&nbsp;</td><td><a href="thread-local-storage.html" class="tocviewlink" data-pltdoc="x">Thread-<wbr></wbr>Local Storage</a></td></tr><tr><td align="right">11.4&nbsp;</td><td><a href="futures.html" class="tocviewlink" data-pltdoc="x">Futures</a></td></tr><tr><td align="right">11.5&nbsp;</td><td><a href="places.html" class="tocviewlink" data-pltdoc="x">Places</a></td></tr><tr><td align="right">11.6&nbsp;</td><td><a href="engine.html" class="tocviewlink" data-pltdoc="x">Engines</a></td></tr><tr><td align="right">11.7&nbsp;</td><td><a href="memory-order.html" class="tocviewlink" data-pltdoc="x">Machine Memory Order</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>11.2&nbsp;</td><td><a href="all-sync.html" class="tocviewlink" data-pltdoc="x">Synchronization</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.2.1&nbsp;</td><td><a href="sync.html" class="tocviewselflink" data-pltdoc="x">Events</a></td></tr><tr><td align="right">11.2.2&nbsp;</td><td><a href="channel.html" class="tocviewlink" data-pltdoc="x">Channels</a></td></tr><tr><td align="right">11.2.3&nbsp;</td><td><a href="semaphore.html" class="tocviewlink" data-pltdoc="x">Semaphores</a></td></tr><tr><td align="right">11.2.4&nbsp;</td><td><a href="async-channel.html" class="tocviewlink" data-pltdoc="x">Buffered Asynchronous Channels</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">evt?</span></span></a></td></tr><tr><td><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sync</span></span></a></td></tr><tr><td><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sync/<span class="mywbr"> &nbsp;</span>timeout</span></span></a></td></tr><tr><td><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Fenable-break%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sync/<span class="mywbr"> &nbsp;</span>enable-<wbr></wbr>break</span></span></a></td></tr><tr><td><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%2Fenable-break%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sync/<span class="mywbr"> &nbsp;</span>timeout/<span class="mywbr"> &nbsp;</span>enable-<wbr></wbr>break</span></span></a></td></tr><tr><td><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._choice-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">choice-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._wrap-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">wrap-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">handle-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="sync.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._guard-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">guard-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._nack-guard-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">nack-<wbr></wbr>guard-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._poll-guard-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">poll-<wbr></wbr>guard-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._replace-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">replace-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._always-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">always-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._never-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">never-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._system-idle-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">system-<wbr></wbr>idle-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._alarm-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">alarm-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">handle-<wbr></wbr>evt?</span></span></a></td></tr><tr><td><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._prop~3aevt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>evt</span></span></a></td></tr><tr><td><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._current-evt-pseudo-random-generator%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>evt-<wbr></wbr>pseudo-<wbr></wbr>random-<wbr></wbr>generator</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="all-sync.html" title="backward to &quot;11.2 Synchronization&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="all-sync.html" title="up to &quot;11.2 Synchronization&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="channel.html" title="forward to &quot;11.2.2 Channels&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;sync&quot;">11.2.1<tt>&nbsp;</tt><a name="(part._sync)"></a><a name="(idx._(gentag._229._(lib._scribblings/reference/reference..scrbl)))"></a><a name="(idx._(gentag._230._(lib._scribblings/reference/reference..scrbl)))"></a>Events</h5><p>A <a name="(tech._synchronizable._event)"></a><span style="font-style: italic">synchronizable event</span> (or just <span style="font-style: italic">event</span> for short)
+works with the <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span> procedure to coordinate synchronization
+among threads. Certain kinds of objects double as events, including
+ports and threads. Other kinds of objects exist only for their use as
+events. Racket&rsquo;s event system is based on Concurrent ML [<a href="doc-bibliography.html#%28cite._.Reppy99%29" data-pltdoc="x">Reppy99</a>].</p><p>At any point in time, an event is either <a name="(tech._ready._for._synchronization)"></a><span style="font-style: italic">ready for
+synchronization</span>, or it is not; depending on the kind of event and how
+it is used by other threads, an event can switch from not ready to
+ready (or back), at any time.  If a thread synchronizes on an event
+when it is ready, then the event produces a particular
+<a name="(tech._synchronization._result)"></a><span style="font-style: italic">synchronization result</span>.</p><p>Synchronizing an event may affect the state of the event. For example,
+when synchronizing a semaphore, then the semaphore&rsquo;s internal count is
+decremented, just as with <span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%29%29" class="RktValLink" data-pltdoc="x">semaphore-wait</a></span>. For most kinds of
+events, however (such as a port), synchronizing does not modify the
+event&rsquo;s state.</p><p>Racket values that act as <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable events</span></a> include
+<a href="async-channel.html#%28tech._asynchronous._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">asynchronous channels</span></a>,
+<a href="channel.html#%28tech._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">channels</span></a>,
+<a href="eval-model.html#%28tech._custodian._box%29" class="techoutside" data-pltdoc="x"><span class="techinside">custodian box</span></a>es,
+<a href="logging.html#%28tech._log._receiver%29" class="techoutside" data-pltdoc="x"><span class="techinside">log receivers</span></a>,
+<a href="places.html#%28tech._place._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">place channels</span></a>,
+<a href="ports.html#%28tech._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">ports</span></a>,
+<a href="semaphore.html#%28tech._semaphore%29" class="techoutside" data-pltdoc="x"><span class="techinside">semaphores</span></a>,
+<a href="subprocess.html#%28tech._subproces%29" class="techoutside" data-pltdoc="x"><span class="techinside">subprocess</span></a>es,
+<a href="tcp.html#%28tech._tcp._listener%29" class="techoutside" data-pltdoc="x"><span class="techinside">TCP listeners</span></a>,
+<a href="eval-model.html#%28tech._thread%29" class="techoutside" data-pltdoc="x"><span class="techinside">threads</span></a>, and
+<a href="willexecutor.html#%28tech._will._executor%29" class="techoutside" data-pltdoc="x"><span class="techinside">will executors</span></a>.
+Libraries can define new synchronizable events, especially
+though <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._prop~3aevt%29%29" class="RktValLink" data-pltdoc="x">prop:evt</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._evt~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">evt?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a>,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._never-evt%29%29" class="RktValLink" data-pltdoc="x">never-evt</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._make-channel%29%29" class="RktValLink" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._sync))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValDef RktValLink" data-pltdoc="x">sync</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Blocks as long as none of the <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable events</span></a>
+<span class="RktVar">evt</span>s are ready, as defined above.</div></p><p>When at least one <span class="RktVar">evt</span> is ready, its <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization
+result</span></a> (often <span class="RktVar">evt</span> itself) is returned.  If multiple
+<span class="RktVar">evt</span>s are ready, one of the <span class="RktVar">evt</span>s is chosen
+pseudo-randomly for the result; the
+<span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._current-evt-pseudo-random-generator%29%29" class="RktValLink" data-pltdoc="x">current-evt-pseudo-random-generator</a></span> parameter sets the
+random-number generator that controls this choice.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._make-channel%29%29" class="RktValLink" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;thread&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">hellooooo</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">hellooooo</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.1.0.3 of package <span class="stt">base</span>: Allow 0 arguments instead of 1 or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._sync/timeout))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%29%29" class="RktValDef RktValLink" data-pltdoc="x">sync/timeout</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">timeout</span><span class="hspace">&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">timeout</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._negative~3f%29%29" class="RktValLink" data-pltdoc="x">negative?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span> if <span class="RktVar">timeout</span> is <span class="RktVal">#f</span>. If
+<span class="RktVar">timeout</span> is a real number, then the result is <span class="RktVal">#f</span>
+if <span class="RktVar">timeout</span> seconds pass without a
+successful synchronization. If <span class="RktVar">timeout</span> is a procedure, then
+it is called in tail position if polling the <span class="RktVar">evt</span>s discovers
+no ready events.</div></p><p>A zero value for <span class="RktVar">timeout</span> is equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">#f</span><span class="RktPn">)</span>. In either case, each <span class="RktVar">evt</span> is checked at least once
+before returning <span class="RktVal">#f</span> or calling <span class="RktVar">timeout</span>.</p><p>See also <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._alarm-evt%29%29" class="RktValLink" data-pltdoc="x">alarm-evt</a></span> for an alternative timeout mechanism.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">times out before waking up</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">sync/timeout</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktVal">0.5</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._sleep%29%29" class="RktValLink" data-pltdoc="x">sleep</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"woke up!"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">sync/timeout</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"no ready events"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._never-evt%29%29" class="RktValLink" data-pltdoc="x">never-evt</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">no ready events</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.1.0.3 of package <span class="stt">base</span>: Allow 1 argument instead of 2 or more.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._sync/enable-break))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Fenable-break%29%29" class="RktValDef RktValLink" data-pltdoc="x">sync/enable-break</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span>, but breaking is enabled (see
+<a href="breakhandler.html" data-pltdoc="x">Breaks</a>) while waiting on the <span class="RktVar">evt</span>s. If
+breaking is disabled when <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">sync/enable-break</a></span> is called, then
+either all <span class="RktVar">evt</span>s remain unchosen or the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak%29%29" class="RktValLink" data-pltdoc="x">exn:break</a></span>
+exception is raised, but not both.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._sync/timeout/enable-break))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%2Fenable-break%29%29" class="RktValDef RktValLink" data-pltdoc="x">sync/timeout/enable-break</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">timeout</span><span class="hspace">&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">timeout</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._negative~3f%29%29" class="RktValLink" data-pltdoc="x">negative?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">sync/enable-break</a></span>, but with a timeout as for <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">sync/timeout</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._choice-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._choice-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">choice-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates and returns a single event that combines the
+<span class="RktVar">evt</span>s. Supplying the result to <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span> is the same as
+supplying each <span class="RktVar">evt</span> to the same call.</div></p><p>That is, an event returned by <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._choice-evt%29%29" class="RktValLink" data-pltdoc="x">choice-evt</a></span> is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for
+synchronization</span></a> when one or more of the <span class="RktVar">evt</span>s supplied to
+<span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._choice-evt%29%29" class="RktValLink" data-pltdoc="x">choice-evt</a></span> are <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a>. If the
+choice event is chosen, one of its ready <span class="RktVar">evt</span>s is chosen
+pseudo-randomly, and the <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> is the chosen
+<span class="RktVar">evt</span>&rsquo;s <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._make-channel%29%29" class="RktValLink" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._make-channel%29%29" class="RktValLink" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">either-channel</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._choice-evt%29%29" class="RktValLink" data-pltdoc="x">choice-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch1</span><span class="hspace">&nbsp;</span><span class="RktSym">ch2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span><span class="hspace">&nbsp;</span><span class="RktSym">either-channel</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;thread&gt;</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3e%29%29" class="RktValLink" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._random%29%29" class="RktValLink" data-pltdoc="x">random</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0.5</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">ch1</span><span class="hspace">&nbsp;</span><span class="RktSym">ch2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">tuturuu</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">tuturuu</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._wrap-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._wrap-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">wrap-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span><span class="RktVar">wrap</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">wrap</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates an event that is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when
+<span class="RktVar">evt</span> is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a>, but whose
+<a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> is determined by applying <span class="RktVar">wrap</span>
+to the <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> of <span class="RktVar">evt</span>. The number
+of arguments accepted by <span class="RktVar">wrap</span> must match the number of values
+for the synchronization result of <span class="RktVar">evt</span>.</div></p><p>The call to <span class="RktVar">wrap</span> is
+<span class="RktSym"><a href="breakhandler.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize-break%29%29" class="RktStxLink" data-pltdoc="x">parameterize-break</a></span>ed to disable breaks initially.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._make-channel%29%29" class="RktValLink" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._wrap-evt%29%29" class="RktValLink" data-pltdoc="x">wrap-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"you've got mail: ~a"</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span><span class="hspace">&nbsp;</span><span class="RktVar">evt</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;thread&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktVal">"Dear Alice ..."</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">you've got mail: Dear Alice ...</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._handle-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">handle-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span><span class="RktVar">handle</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt~3f%29%29" class="RktValLink" data-pltdoc="x">handle-evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">handle</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._wrap-evt%29%29" class="RktValLink" data-pltdoc="x">wrap-evt</a></span>, except that <span class="RktVar">handle</span> is called in <a href="eval-model.html#%28tech._tail._position%29" class="techoutside" data-pltdoc="x"><span class="techinside">tail
+position</span></a> with respect to the synchronization request&#8212;<wbr></wbr>and without
+breaks explicitly disabled&#8212;<wbr></wbr>when it is not wrapped by <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._wrap-evt%29%29" class="RktValLink" data-pltdoc="x">wrap-evt</a></span>,
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone-evt%29%29" class="RktValLink" data-pltdoc="x">chaperone-evt</a></span>, or another <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt%29%29" class="RktValLink" data-pltdoc="x">handle-evt</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">msg-ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._make-channel%29%29" class="RktValLink" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">exit-ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._make-channel%29%29" class="RktValLink" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"val = ~a~n"</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt%29%29" class="RktValLink" data-pltdoc="x">handle-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">msg-ch</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt%29%29" class="RktValLink" data-pltdoc="x">handle-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">exit-ch</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._displayln%29%29" class="RktValLink" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">val = 0</span></p></td></tr><tr><td><p><span class="RktRes">#&lt;thread&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">msg-ch</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">val = 5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">msg-ch</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">val = 7</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">exit-ch</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">done</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">done</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/misc..rkt)._guard-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sync.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._guard-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">guard-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maker</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">maker</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a value that behaves as an event, but that is actually an
+event maker.</div></p><p>An event <span class="RktVar">guard</span> returned by <span class="RktSym"><a href="sync.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._guard-evt%29%29" class="RktValLink" data-pltdoc="x">guard-evt</a></span> generates an
+event when <span class="RktVar">guard</span> is used with <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span>
+(or whenever it is part of a choice event used with <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span>,
+etc.), where the generated event is the result of calling
+<span class="RktVar">maker</span>. The <span class="RktVar">maker</span> procedure may be called by
+<span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span> at most once for a given call to <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span>, but
+<span class="RktVar">maker</span> may not be called if a ready event is chosen before
+<span class="RktVar">guard</span> is even considered.</p><p>If <span class="RktVar">maker</span> returns a non-event, then <span class="RktVar">maker</span>&rsquo;s
+result is replaced with an event that is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for
+synchronization</span></a> and whose <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> is
+<span class="RktVar">guard</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._nack-guard-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._nack-guard-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">nack-guard-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maker</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">maker</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="sync.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._guard-evt%29%29" class="RktValLink" data-pltdoc="x">guard-evt</a></span>, but when <span class="RktVar">maker</span> is called, it is
+given a NACK (&ldquo;negative acknowledgment&rdquo;) event. After starting the
+call to <span class="RktVar">maker</span>, if the event from <span class="RktVar">maker</span> is not
+ultimately chosen as the ready event, then the NACK event supplied to
+<span class="RktVar">maker</span> becomes <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> with a
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a> value.</div></p><p>The NACK event becomes <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when the event
+is abandoned when either some other event is chosen, the synchronizing
+thread is dead, or control escapes from the call to <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span>
+(even if <span class="RktVar">nack-guard</span>&rsquo;s <span class="RktVar">maker</span> has not yet returned a
+value). If the event returned by <span class="RktVar">maker</span> is chosen, then the
+NACK event never becomes <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._poll-guard-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._poll-guard-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">poll-guard-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">maker</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">maker</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="sync.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._guard-evt%29%29" class="RktValLink" data-pltdoc="x">guard-evt</a></span>, but when <span class="RktVar">maker</span> is called, it is
+provided a boolean value that indicates whether the event will be used
+for a poll, <span class="RktVal">#t</span>, or for a blocking synchronization,
+<span class="RktVal">#f</span>.</div></p><p>If <span class="RktVal">#t</span> is supplied to <span class="RktVar">maker</span>, if breaks are
+disabled, if the polling thread is not terminated, and if polling the
+resulting event produces a <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a>, then the event
+will certainly be chosen for its result.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._replace-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._replace-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">replace-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span><span class="RktVar">maker</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">maker</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="sync.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._guard-evt%29%29" class="RktValLink" data-pltdoc="x">guard-evt</a></span>, but <span class="RktVar">maker</span> is called only after
+<span class="RktVar">evt</span> becomes <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a>, and the
+<a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> of <span class="RktVar">evt</span> is passed to <span class="RktVar">maker</span>.</div></p><p>The attempt to synchronize on <span class="RktVar">evt</span> proceeds concurrently as
+the attempt to synchronize on the result <span class="RktVar">guard</span> from
+<span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._replace-evt%29%29" class="RktValLink" data-pltdoc="x">replace-evt</a></span>; despite that concurrency, if <span class="RktVar">maker</span> is
+called, it is called in the thread that is synchronizing on
+<span class="RktVar">guard</span>. Synchronization can succeed for both <span class="RktVar">evt</span> and
+another synchronized with <span class="RktVar">guard</span> at the same time; the
+single-choice guarantee of synchronization applies only to the result
+of <span class="RktVar">maker</span> and other events synchronized with <span class="RktVar">guard</span>.</p><p>If <span class="RktVar">maker</span> returns a non-event, then <span class="RktVar">maker</span>&rsquo;s
+result is replaced with an event that is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for
+synchronization</span></a> and whose <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> is
+<span class="RktVar">guard</span>.</p><p class="SHistory">Added in version 6.1.0.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._always-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._always-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">always-evt</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A constant event that is always <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready
+for synchronization</span></a>, with itself as its <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._always-evt%29%29" class="RktValLink" data-pltdoc="x">always-evt</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;always-evt&gt;</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._never-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._never-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">never-evt</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A constant event that is never <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready
+for synchronization</span></a>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">sync/timeout</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0.1</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._never-evt%29%29" class="RktValLink" data-pltdoc="x">never-evt</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._system-idle-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._system-idle-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">system-idle-evt</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns an event that is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when the
+system is otherwise idle: if the result event were replaced by
+<span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._never-evt%29%29" class="RktValLink" data-pltdoc="x">never-evt</a></span>, no thread in the system would be available to run.
+In other words, all threads must be suspended or blocked on events
+with timeouts that have not yet expired. The system-idle event&rsquo;s
+<a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> is <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>. The result of the
+<span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._system-idle-evt%29%29" class="RktValLink" data-pltdoc="x">system-idle-evt</a></span> procedure is always the same event.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">th</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">sync/timeout</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0.1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._system-idle-evt%29%29" class="RktValLink" data-pltdoc="x">system-idle-evt</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._kill-thread%29%29" class="RktValLink" data-pltdoc="x">kill-thread</a></span><span class="hspace">&nbsp;</span><span class="RktSym">th</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._system-idle-evt%29%29" class="RktValLink" data-pltdoc="x">system-idle-evt</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._alarm-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._alarm-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">alarm-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">msecs</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">monotonic?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">msecs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">monotonic?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> that is not <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when
+<span class="RktPn">(</span><span class="RktVar">milliseconds</span><span class="RktPn">)</span> would return a value that is
+less than <span class="RktVar">msecs</span>, and it is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when
+<span class="RktPn">(</span><span class="RktVar">milliseconds</span><span class="RktPn">)</span> would return a value that is
+more than <span class="RktVar">msecs</span>. The value of <span class="RktVar">milliseconds</span> is
+<span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-inexact-milliseconds%29%29" class="RktValLink" data-pltdoc="x">current-inexact-milliseconds</a></span> when <span class="RktVar">monotonic?</span> is <span class="RktVal">#f</span>,
+or <span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-inexact-monotonic-milliseconds%29%29" class="RktValLink" data-pltdoc="x">current-inexact-monotonic-milliseconds</a></span> otherwise. The <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> of a alarm event is the alarm event itself.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">alarm</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._alarm-evt%29%29" class="RktValLink" data-pltdoc="x">alarm-evt</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-inexact-milliseconds%29%29" class="RktValLink" data-pltdoc="x">current-inexact-milliseconds</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span><span class="hspace">&nbsp;</span><span class="RktSym">alarm</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;alarm-evt&gt;</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 8.3.0.9 of package <span class="stt">base</span>: Added the <span class="RktVar">monotonic?</span> argument.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._handle-evt~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">handle-evt?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">evt</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">evt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">evt</span> was created by <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt%29%29" class="RktValLink" data-pltdoc="x">handle-evt</a></span>
+or by <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._choice-evt%29%29" class="RktValLink" data-pltdoc="x">choice-evt</a></span> applied to another event for which
+<span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt~3f%29%29" class="RktValLink" data-pltdoc="x">handle-evt?</a></span> produces <span class="RktVal">#t</span>. For any other event,
+<span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt~3f%29%29" class="RktValLink" data-pltdoc="x">handle-evt?</a></span>  produces <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt~3f%29%29" class="RktValLink" data-pltdoc="x">handle-evt?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._never-evt%29%29" class="RktValLink" data-pltdoc="x">never-evt</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt~3f%29%29" class="RktValLink" data-pltdoc="x">handle-evt?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._handle-evt%29%29" class="RktValLink" data-pltdoc="x">handle-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._always-evt%29%29" class="RktValLink" data-pltdoc="x">always-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((quote._~23~25kernel)._prop~3aevt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._prop~3aevt%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:evt</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property</span></a> that identifies structure types whose
+ instances can serve as <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable events</span></a>. The property value can
+ be any of the following:</div></p><ul><li><p>An event <span class="RktVar">evt</span>: In this case, using the structure as an
+event is equivalent to using <span class="RktVar">evt</span>.</p></li><li><p>A procedure <span class="RktVar">proc</span> of one argument: In this case, the
+structure is similar to an event generated
+by <span class="RktSym"><a href="sync.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._guard-evt%29%29" class="RktValLink" data-pltdoc="x">guard-evt</a></span>, except that the would-be guard
+procedure <span class="RktVar">proc</span> receives the structure as an argument, instead
+of no arguments; also, a non-event result from <span class="RktVar">proc</span>
+is replaced with an event that is already <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a>
+and whose <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> is the structure.</p></li><li><p>An exact, non-negative integer between <span class="RktVal">0</span> (inclusive)
+and the number of non-automatic fields in the structure type
+(exclusive, not counting supertype fields): The integer identifies a
+field in the structure, and the field must be designated as
+immutable. If the field contains an object or an event-generating
+procedure of one argument, the event or procedure is used as
+above. Otherwise, the structure acts as an event that is never
+ready.</p></li></ul><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>For working with foreign libraries, a <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._prop~3aevt%29%29" class="RktValLink" data-pltdoc="x">prop:evt</a></span>
+value can also be a result of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=Thread_Scheduling.html%23%2528def._%2528%2528lib._ffi%252Funsafe%252Fschedule..rkt%2529._unsafe-poller%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">unsafe-poller</a></span>,
+although that possibility is omitted from the safe
+contract of <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._prop~3aevt%29%29" class="RktValLink" data-pltdoc="x">prop:evt</a></span>.</p></blockquote></blockquote></blockquote><p>Instances of a structure type with the <span class="RktSym"><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3ainput-port%29%29" class="RktValLink" data-pltdoc="x">prop:input-port</a></span> or
+<span class="RktSym"><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3aoutput-port%29%29" class="RktValLink" data-pltdoc="x">prop:output-port</a></span> property are also <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable events</span></a> by virtue
+of being a port. If the structure type has more than one of
+<span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._prop~3aevt%29%29" class="RktValLink" data-pltdoc="x">prop:evt</a></span>, <span class="RktSym"><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3ainput-port%29%29" class="RktValLink" data-pltdoc="x">prop:input-port</a></span>, and
+<span class="RktSym"><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3aoutput-port%29%29" class="RktValLink" data-pltdoc="x">prop:output-port</a></span>, then the <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._prop~3aevt%29%29" class="RktValLink" data-pltdoc="x">prop:evt</a></span> value (if any)
+takes precedence for determining the instance&rsquo;s behavior as an event,
+and the <span class="RktSym"><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3ainput-port%29%29" class="RktValLink" data-pltdoc="x">prop:input-port</a></span> property takes precedence over
+<span class="RktSym"><a href="portstructs.html#%28def._%28%28quote._~23~25kernel%29._prop~3aoutput-port%29%29" class="RktValLink" data-pltdoc="x">prop:output-port</a></span> for synchronization.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">wt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">base</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:property</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._prop~3aevt%29%29" class="RktValLink" data-pltdoc="x">prop:evt</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct-field-index%29%29" class="RktStxLink" data-pltdoc="x">struct-field-index</a></span><span class="hspace">&nbsp;</span><span class="RktSym">base</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sema</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._make-semaphore%29%29" class="RktValLink" data-pltdoc="x">make-semaphore</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">sync/timeout</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">wt</span><span class="hspace">&nbsp;</span><span class="RktSym">sema</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-post%29%29" class="RktValLink" data-pltdoc="x">semaphore-post</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sema</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">sync/timeout</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">wt</span><span class="hspace">&nbsp;</span><span class="RktSym">sema</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;semaphore&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-post%29%29" class="RktValLink" data-pltdoc="x">semaphore-post</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sema</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">sync/timeout</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">wt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">self</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">wt-val</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">sema</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;semaphore&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-post%29%29" class="RktValLink" data-pltdoc="x">semaphore-post</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sema</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-wt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">wt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">self</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._wrap-evt%29%29" class="RktValLink" data-pltdoc="x">wrap-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">wt-val</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">sema</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">sync/timeout</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">my-wt</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;wt&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">sync/timeout</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">my-wt</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-evt-pseudo-random-generator))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._current-evt-pseudo-random-generator%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-evt-pseudo-random-generator</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator~3f%29%29" class="RktValLink" data-pltdoc="x">pseudo-random-generator?</a></span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._current-evt-pseudo-random-generator%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-evt-pseudo-random-generator</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">generator</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">generator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator~3f%29%29" class="RktValLink" data-pltdoc="x">pseudo-random-generator?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the pseudo-random number generator used by
+<span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span> for events created by <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._choice-evt%29%29" class="RktValLink" data-pltdoc="x">choice-evt</a></span>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="all-sync.html" title="backward to &quot;11.2 Synchronization&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="all-sync.html" title="up to &quot;11.2 Synchronization&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="channel.html" title="forward to &quot;11.2.2 Channels&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/syntax-model.html b/clones/docs.racket-lang.org/reference/syntax-model.html
new file mode 100644
index 00000000..6da88917
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/syntax-model.html
@@ -0,0 +1,655 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>1.2&nbsp;Syntax Model</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewselflink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">1.1&nbsp;</td><td><a href="eval-model.html" class="tocviewlink" data-pltdoc="x">Evaluation Model</a></td></tr><tr><td align="right">1.2&nbsp;</td><td><a href="syntax-model.html" class="tocviewselflink" data-pltdoc="x">Syntax Model</a></td></tr><tr><td align="right">1.3&nbsp;</td><td><a href="reader.html" class="tocviewlink" data-pltdoc="x">The Reader</a></td></tr><tr><td align="right">1.4&nbsp;</td><td><a href="printing.html" class="tocviewlink" data-pltdoc="x">The Printer</a></td></tr><tr><td align="right">1.5&nbsp;</td><td><a href="implementations.html" class="tocviewlink" data-pltdoc="x">Implementations</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>1.2&nbsp;</td><td><a href="syntax-model.html" class="tocviewselflink" data-pltdoc="x">Syntax Model</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">1.2.1&nbsp;</td><td><a href="syntax-model.html#%28part._id-model%29" class="tocviewlink" data-pltdoc="x">Identifiers, Binding, and Scopes</a></td></tr><tr><td align="right">1.2.2&nbsp;</td><td><a href="syntax-model.html#%28part._stxobj-model%29" class="tocviewlink" data-pltdoc="x">Syntax Objects</a></td></tr><tr><td align="right">1.2.3&nbsp;</td><td><a href="syntax-model.html#%28part._expansion%29" class="tocviewlink" data-pltdoc="x">Expansion</a></td></tr><tr><td align="right">1.2.4&nbsp;</td><td><a href="syntax-model.html#%28part._compilation-model%29" class="tocviewlink" data-pltdoc="x">Compilation</a></td></tr><tr><td align="right">1.2.5&nbsp;</td><td><a href="syntax-model.html#%28part._namespace-model%29" class="tocviewlink" data-pltdoc="x">Namespaces</a></td></tr><tr><td align="right">1.2.6&nbsp;</td><td><a href="syntax-model.html#%28part._infernames%29" class="tocviewlink" data-pltdoc="x">Inferred Value Names</a></td></tr><tr><td align="right">1.2.7&nbsp;</td><td><a href="syntax-model.html#%28part._cross-phase._persistent-grammar%29" class="tocviewlink" data-pltdoc="x">Cross-<wbr></wbr>Phase Persistent Module Declarations</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">1.2.1<tt>&nbsp;</tt></span><a href="syntax-model.html#%28part._id-model%29" class="tocsubseclink" data-pltdoc="x">Identifiers, Binding, and Scopes</a></td></tr><tr><td><span class="tocsublinknumber">1.2.2<tt>&nbsp;</tt></span><a href="syntax-model.html#%28part._stxobj-model%29" class="tocsubseclink" data-pltdoc="x">Syntax Objects</a></td></tr><tr><td><span class="tocsublinknumber">1.2.3<tt>&nbsp;</tt></span><a href="syntax-model.html#%28part._expansion%29" class="tocsubseclink" data-pltdoc="x">Expansion</a></td></tr><tr><td><span class="tocsublinknumber">1.2.3.1<tt>&nbsp;</tt></span><a href="syntax-model.html#%28part._fully-expanded%29" class="tocsubseclink" data-pltdoc="x">Fully Expanded Programs</a></td></tr><tr><td><span class="tocsublinknumber">1.2.3.2<tt>&nbsp;</tt></span><a href="syntax-model.html#%28part._expand-steps%29" class="tocsubseclink" data-pltdoc="x">Expansion Steps</a></td></tr><tr><td><span class="tocsublinknumber">1.2.3.3<tt>&nbsp;</tt></span><a href="syntax-model.html#%28part._expand-context-model%29" class="tocsubseclink" data-pltdoc="x">Expansion Context</a></td></tr><tr><td><span class="tocsublinknumber">1.2.3.4<tt>&nbsp;</tt></span><a href="syntax-model.html#%28part._intro-binding%29" class="tocsubseclink" data-pltdoc="x">Introducing Bindings</a></td></tr><tr><td><span class="tocsublinknumber">1.2.3.5<tt>&nbsp;</tt></span><a href="syntax-model.html#%28part._transformer-model%29" class="tocsubseclink" data-pltdoc="x">Transformer Bindings</a></td></tr><tr><td><span class="tocsublinknumber">1.2.3.6<tt>&nbsp;</tt></span><a href="syntax-model.html#%28part._local-binding-context%29" class="tocsubseclink" data-pltdoc="x">Local Binding Context</a></td></tr><tr><td><span class="tocsublinknumber">1.2.3.7<tt>&nbsp;</tt></span><a href="syntax-model.html#%28part._partial-expansion%29" class="tocsubseclink" data-pltdoc="x">Partial Expansion</a></td></tr><tr><td><span class="tocsublinknumber">1.2.3.8<tt>&nbsp;</tt></span><a href="syntax-model.html#%28part._intdef-body%29" class="tocsubseclink" data-pltdoc="x">Internal Definitions</a></td></tr><tr><td><span class="tocsublinknumber">1.2.3.9<tt>&nbsp;</tt></span><a href="syntax-model.html#%28part._mod-parse%29" class="tocsubseclink" data-pltdoc="x">Module Expansion, Phases, and Visits</a></td></tr><tr><td><span class="tocsublinknumber">1.2.3.10<tt>&nbsp;</tt></span><a href="syntax-model.html#%28part._macro-introduced-bindings%29" class="tocsubseclink" data-pltdoc="x">Macro-<wbr></wbr>Introduced Bindings</a></td></tr><tr><td><span class="tocsublinknumber">1.2.4<tt>&nbsp;</tt></span><a href="syntax-model.html#%28part._compilation-model%29" class="tocsubseclink" data-pltdoc="x">Compilation</a></td></tr><tr><td><span class="tocsublinknumber">1.2.5<tt>&nbsp;</tt></span><a href="syntax-model.html#%28part._namespace-model%29" class="tocsubseclink" data-pltdoc="x">Namespaces</a></td></tr><tr><td><span class="tocsublinknumber">1.2.6<tt>&nbsp;</tt></span><a href="syntax-model.html#%28part._infernames%29" class="tocsubseclink" data-pltdoc="x">Inferred Value Names</a></td></tr><tr><td><span class="tocsublinknumber">1.2.7<tt>&nbsp;</tt></span><a href="syntax-model.html#%28part._cross-phase._persistent-grammar%29" class="tocsubseclink" data-pltdoc="x">Cross-<wbr></wbr>Phase Persistent Module Declarations</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="eval-model.html" title="backward to &quot;1.1 Evaluation Model&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="model.html" title="up to &quot;1 Language Model&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="reader.html" title="forward to &quot;1.3 The Reader&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;syntax-model&quot;">1.2<tt>&nbsp;</tt><a name="(part._syntax-model)"></a>Syntax Model</h4><p>The syntax of a Racket program is defined by</p><ul><li><p>a <a name="(tech._read)"></a><span style="font-style: italic">read</span> pass that processes a character stream into a
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>; and</p></li><li><p>an <a name="(tech._expand)"></a><span style="font-style: italic">expand</span> pass that processes a syntax object to
+produce one that is fully parsed.</p></li></ul><p>For details on the <a href="syntax-model.html#%28tech._read%29" class="techoutside" data-pltdoc="x"><span class="techinside">read</span></a> pass, see <a href="reader.html" data-pltdoc="x">The Reader</a>. Source
+code is normally read in <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read-syntax%29%29" class="RktValLink" data-pltdoc="x">read-syntax</a></span> mode, which produces a
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>.</p><p>The <a href="syntax-model.html#%28tech._expand%29" class="techoutside" data-pltdoc="x"><span class="techinside">expand</span></a> pass recursively processes a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>
+to produce a complete <a href="syntax-model.html#%28tech._parse%29" class="techoutside" data-pltdoc="x"><span class="techinside">parse</span></a> of the program. <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">Binding</span></a>
+information in a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> drives the <a href="syntax-model.html#%28tech._expansion%29" class="techoutside" data-pltdoc="x"><span class="techinside">expansion</span></a>
+process, and when the <a href="syntax-model.html#%28tech._expansion%29" class="techoutside" data-pltdoc="x"><span class="techinside">expansion</span></a> process encounters a
+<a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a> form, it extends syntax objects for sub-expressions with
+new binding information.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;id-model&quot;">1.2.1<tt>&nbsp;</tt><a name="(part._id-model)"></a>Identifiers, Binding, and Scopes</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=binding.html&amp;version=8.6" class="Sq" data-pltdoc="x">Identifiers and Binding</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces binding.</p></blockquote></blockquote></blockquote><p>An <a name="(tech._identifier)"></a><span style="font-style: italic">identifier</span> is a source-program entity. Parsing (i.e.,
+expanding) a Racket program reveals that some <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifiers</span></a>
+correspond to <a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variables</span></a>, some refer to <a href="syntax-model.html#%28tech._syntactic._form%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntactic forms</span></a>
+(such as <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span>, which is the <a href="syntax-model.html#%28tech._syntactic._form%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntactic form</span></a> for
+functions), some refer to <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformers</span></a> for macro expansion, and
+some are quoted to produce <a href="symbols.html#%28tech._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">symbols</span></a> or <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax objects</span></a>. An
+identifier <a name="(tech._bind)"></a><span style="font-style: italic">binds</span> another (i.e., it is a <a name="(tech._binding)"></a><span style="font-style: italic">binding</span>)
+when the former is parsed as a <a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable</span></a> or syntactic form and
+the latter is parsed as a <a name="(tech._reference)"></a><span style="font-style: italic">reference</span> to the former; the
+latter is <a name="(tech._bound)"></a><span style="font-style: italic">bound</span>.</p><p>For example, as a fragment of source, the text</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></p></blockquote><p>includes two <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifiers</span></a>: <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span> and <span class="RktSym">x</span> (which
+appears twice). When this source is parsed in a context where
+<span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span> has its usual meaning, the first <span class="RktSym">x</span> <a href="syntax-model.html#%28tech._bind%29" class="techoutside" data-pltdoc="x"><span class="techinside">binds</span></a>
+the second <span class="RktSym">x</span>.</p><p>Bindings and references are determined through <a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope sets</span></a>. A
+<a name="(tech._scope)"></a><span style="font-style: italic">scope</span> corresponds to a region of the program that is either
+in part of the source or synthesized through elaboration of the
+source. Nested binding contexts (such as nested functions) create
+nested <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scopes</span></a>, while macro expansion creates scopes that
+overlap in more complex ways. Conceptually, each <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a> is
+represented by a unique token, but the token is not directly
+accessible. Instead, each <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a> is represented by a value that
+is internal to the representation of a program.</p><p>A <a name="(tech._form)"></a><span style="font-style: italic">form</span> is a fragment of a program, such as an identifier or
+a function call. A <a href="syntax-model.html#%28tech._form%29" class="techoutside" data-pltdoc="x"><span class="techinside">form</span></a> is represented as a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax
+object</span></a>, and each syntax object has an associated set of <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scopes</span></a>
+(i.e., a <a name="(tech._scope._set)"></a><span style="font-style: italic">scope set</span>). In the above example,
+the representations of the <span class="RktSym">x</span>s include the <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a> that
+corresponds to the <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span> form.</p><p>When a <a href="syntax-model.html#%28tech._form%29" class="techoutside" data-pltdoc="x"><span class="techinside">form</span></a> parses as the binding of a particular identifier,
+parsing updates a global table that maps a combination of an
+identifier&rsquo;s <a href="symbols.html#%28tech._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">symbol</span></a> and <a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope set</span></a> to its meaning: a
+<a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable</span></a>, a <a href="syntax-model.html#%28tech._syntactic._form%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntactic form</span></a>, or a <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a>. An
+identifier refers to a particular binding when the reference&rsquo;s symbol
+and the identifier&rsquo;s symbol are the same, and when the reference&rsquo;s
+<a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope set</span></a> is a superset of the binding&rsquo;s
+<a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope set</span></a>. For a given identifier, multiple bindings may have
+<a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope sets</span></a> that are subsets of the identifier&rsquo;s; in that case,
+the identifier refers to the binding whose set is a superset of all
+others; if no such binding exists, the reference is ambiguous (and triggers a syntax
+error if it is parsed as an expression). A binding <a name="(tech._shadow)"></a><span style="font-style: italic">shadows</span>
+any <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a> (i.e., it is <a name="(tech._shadowing)"></a><span style="font-style: italic">shadowing</span> any <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a>)
+with the same symbol but a subset of scopes.</p><p>For example, in</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></p></blockquote><p>in a context where <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span> corresponds to the usual
+<a href="syntax-model.html#%28tech._syntactic._form%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntactic form</span></a>, the parsing of <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span> introduces a new
+scope for the binding of <span class="RktSym">x</span>. Since the second <span class="RktSym">x</span>
+receives that scope as part of the <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span> body, the first
+<span class="RktSym">x</span> <a href="syntax-model.html#%28tech._bind%29" class="techoutside" data-pltdoc="x"><span class="techinside">binds</span></a> the second <span class="RktSym">x</span>. In the more complex
+case</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>the inner <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span> creates a second scope for the second
+<span class="RktSym">x</span>, so its <a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope set</span></a> is a superset of the first
+<span class="RktSym">x</span>&rsquo;s <a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope set</span></a>&#8212;<wbr></wbr>which means that the binding for the
+second <span class="RktSym">x</span> <a href="syntax-model.html#%28tech._shadow%29" class="techoutside" data-pltdoc="x"><span class="techinside">shadows</span></a> the one for the first <span class="RktSym">x</span>, and
+the third <span class="RktSym">x</span> refers to the binding created by the second one.</p><p>A <a name="(tech._top._level._binding)"></a><span style="font-style: italic">top-level binding</span> is a <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a> from a definition at
+the top-level; a <a name="(tech._module._binding)"></a><span style="font-style: italic">module binding</span> is a binding from a
+definition in a module; all other bindings are <a name="(tech._local._binding)"></a><span style="font-style: italic">local
+bindings</span>. Within a module, references to <a href="syntax-model.html#%28tech._top._level._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level bindings</span></a>
+are disallowed. An identifier without a binding is <a name="(tech._unbound)"></a><span style="font-style: italic">unbound</span>.</p><p>Throughout the documentation, <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifiers</span></a> are typeset to
+suggest the way that they are parsed. A hyperlinked identifier
+like <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span> indicates a reference to a syntactic form or
+variable. A plain identifier like <span class="RktSym">x</span> is a
+<a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable</span></a> or a reference to an unspecified <a href="eval-model.html#%28tech._top._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level
+variable</span></a>.</p><p>Every binding has a <a name="(tech._phase._level)"></a><span style="font-style: italic">phase level</span> in which it can be
+referenced, where a <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> normally corresponds to an
+integer (but the special <a href="syntax-model.html#%28tech._label._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">label phase level</span></a> does not
+correspond to an integer).  <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">Phase level</span></a> 0 corresponds to the
+run time of the enclosing module (or the run time of top-level
+expressions). Bindings in <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 0 constitute the
+<a name="(tech._base._environment)"></a><span style="font-style: italic">base environment</span>.  <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">Phase level</span></a> 1 corresponds to the
+time during which the enclosing module (or top-level expression) is
+expanded; bindings in <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 1 constitute the
+<a name="(tech._transformer._environment)"></a><span style="font-style: italic">transformer environment</span>.  Phase level -1 corresponds to the
+run time of a different module for which the enclosing module is
+imported for use at <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 1 (relative to the importing
+module); bindings in <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> -1 constitute the
+<a name="(tech._template._environment)"></a><span style="font-style: italic">template environment</span>. The <a name="(tech._label._phase._level)"></a><span style="font-style: italic">label phase level</span> does not
+correspond to any execution time; it is used to track bindings (e.g.,
+to identifiers within documentation) without implying an execution
+dependency.</p><p>An identifier can have different bindings in different <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase
+levels</span></a>. More precisely, the <a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope set</span></a> associated with a
+<a href="syntax-model.html#%28tech._form%29" class="techoutside" data-pltdoc="x"><span class="techinside">form</span></a> can be different at different phase levels; a top-level or
+module context implies a distinct scope at every phase level, while
+scopes from macro expansion or other syntactic forms are added to a
+form&rsquo;s <a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope sets</span></a> at all phases. The context of each binding
+and reference determines the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> whose <a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope set</span></a> is
+relevant.</p><p>A <a name="(tech._binding._space)"></a><span style="font-style: italic">binding space</span> is a convention that distinguishes bindings
+by having a specific <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a> for the space; an identifier is
+&ldquo;bound in a space&rdquo; if its binding includes the space&rsquo;s scope in its
+<a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope set</span></a>. A space&rsquo;s scope is accessed indirectly by using
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-interned-syntax-introducer%29%29" class="RktValLink" data-pltdoc="x">make-interned-syntax-introducer</a></span>; that is, a space is just the
+set of bindings with a scope that is interned with that space&rsquo;s name,
+where the <a name="(tech._default._binding._space)"></a><span style="font-style: italic">default binding space</span> corresponds to having no
+interned scopes. The <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> and <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> forms
+include support for bindings spaces through subforms like
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-space%29%29" class="RktStxLink" data-pltdoc="x">for-space</a></span> and <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-space-in%29%29" class="RktStxLink" data-pltdoc="x">only-space-in</a></span>. No other forms provided
+by the <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> module bind or reference identifier in a
+specified space; such forms are intended to be implemented by new
+macros. By convention, when an identifier is bound in a space, a
+corresponding identifier also should be bound in the default binding
+space; that convention helps avoid mismatches between imports or
+mismatches due to local bindings that shadow only in some spaces.</p><p class="SHistory">Changed in version 6.3 of package <span class="stt">base</span>: Changed local bindings to have a
+specific phase level, like top-level
+and module bindings.<br/>Changed in version 8.2.0.3: Added <a href="syntax-model.html#%28tech._binding._space%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding spaces</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;stxobj-model&quot;">1.2.2<tt>&nbsp;</tt><a name="(part._stxobj-model)"></a>Syntax Objects</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=stx-obj.html&amp;version=8.6" class="Sq" data-pltdoc="x">Syntax Objects</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces the use of syntax objects.</p></blockquote></blockquote></blockquote><p>A <a name="(tech._syntax._object)"></a><span style="font-style: italic">syntax object</span> combines a simpler Racket value, such as a symbol or pair, with
+<a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a>, <a href="exns.html#%28tech._source._location%29" class="techoutside" data-pltdoc="x"><span class="techinside">source-location</span></a> information, <a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax properties</span></a>, and
+whether the syntax object is
+<a href="stxcerts.html#%28tech._tainted%29" class="techoutside" data-pltdoc="x"><span class="techinside">tainted</span></a>. The <a name="(tech._lexical._information)"></a><span style="font-style: italic">lexical information</span> of a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> comprises a set of <a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope
+sets</span></a>, one for each <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>. In particular, an <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> is represented as a syntax
+object containing a <a href="symbols.html#%28tech._symbol%29" class="techoutside" data-pltdoc="x"><span class="techinside">symbol</span></a>, and its <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> can be combined with the global
+table of bindings to determine its <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a> (if any) at each <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>.</p><p>For example, a <span class="RktSym">car</span> <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> might have
+<a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> that designates it as the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> from
+the <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> language (i.e., the built-in
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span>). Similarly, a <span class="RktSym">lambda</span> identifier&rsquo;s
+<a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> may indicate that it represents a procedure
+form. Some other <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a>&rsquo;s <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> may
+indicate that it references a <a href="eval-model.html#%28tech._top._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level variable</span></a>.</p><p>When a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> represents a more complex expression than
+an <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> or simple constant, its internal components can
+be extracted. Even for extracted identifiers, detailed information
+about binding is available mostly indirectly; two identifiers can be
+compared to determine whether they refer to the same binding (i.e.,
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span>), or whether the identifiers have the same
+<a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope set</span></a> so that each identifier would bind the
+other if one were in a binding position and the other in an expression
+position (i.e., <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._bound-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">bound-identifier=?</a></span>).</p><p>For example, when the program written as</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>is represented as a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>, then two <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax
+objects</span></a> can be extracted for the two <span class="RktSym">x</span>s. Both the
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span> and <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._bound-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">bound-identifier=?</a></span> predicates
+will indicate that the <span class="RktSym">x</span>s are the same. In contrast, the
+<span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span> <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> is not <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span> or
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._bound-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">bound-identifier=?</a></span> to either <span class="RktSym">x</span>.</p><p>The <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> in a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> is
+independent of the rest of the <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>, and it can be copied to a new syntax
+object in combination with an arbitrary other Racket value. Thus,
+identifier-<a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a> information in a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> is
+predicated on the symbolic name of the <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> as well as
+the identifier&rsquo;s <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a>; the same question with
+the same <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> but different base value can
+produce a different answer.</p><p>For example, combining the lexical information from <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span> in
+the program above to <span class="RktVal">'</span><span class="RktVal">x</span> would not produce an identifier that
+is <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span> to either <span class="RktSym">x</span>, since it does not
+appear in the scope of the <span class="RktSym">x</span> binding. Combining the lexical
+context of the <span class="RktVal">6</span> with <span class="RktVal">'</span><span class="RktVal">x</span>, in contrast, would produce
+an identifier that is <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._bound-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">bound-identifier=?</a></span> to both <span class="RktSym">x</span>s.</p><p>The <span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span> form bridges the evaluation of a program and
+the representation of a program. Specifically, <span class="RktPn">(</span><span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span><span class="stt"> </span><span class="RktVar">datum</span><span class="stt"> </span><span class="RktPn">#:local</span><span class="RktPn">)</span> produces a syntax object that preserves all of the
+lexical information that <span class="RktVar">datum</span> had when it was parsed as
+part of the <span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span> form. Note that the
+<span class="RktPn">(</span><span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span><span class="stt"> </span><span class="RktVar">datum</span><span class="RktPn">)</span> form is similar, but it removes certain
+<a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scopes</span></a> from the <span class="RktVar">datum</span>&rsquo;s <a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope sets</span></a>;
+see <span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span> for more information.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;expansion&quot;">1.2.3<tt>&nbsp;</tt><a name="(part._expansion)"></a>Expansion (Parsing)</h5><p><a name="(tech._expansion)"></a><span style="font-style: italic">Expansion</span> recursively processes a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> in a
+particular phase level, starting with <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 0. <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">Bindings</span></a>
+from the <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>&rsquo;s <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> drive the
+expansion process, and cause new bindings to be introduced for the
+lexical information of sub-expressions. In some cases, a
+sub-expression is expanded in a phase deeper (having a
+bigger phase level number) than the enclosing expression.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;fully-expanded&quot;">1.2.3.1<tt>&nbsp;</tt><a name="(part._fully-expanded)"></a>Fully Expanded Programs</h5><p>A complete expansion produces a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> matching the
+following grammar:</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Beware that the symbolic names of identifiers in a fully
+expanded program may not match the symbolic names in the grammar. Only
+the binding (according to <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span>) matters.</p></blockquote></blockquote></blockquote><p><table cellspacing="0" cellpadding="0"><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">top-level-form</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">general-top-level-form</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="__expression.html#%28form._%28%28quote._~23~25kernel%29._~23~25expression%29%29" class="RktStxLink" data-pltdoc="x">#%expression</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-module-begin%29%29" class="RktStxLink" data-pltdoc="x">#%plain-module-begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVar">module-level-form</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktVar">top-level-form</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVar">top-level-form</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">module-level-form</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">general-top-level-form</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25provide%29%29" class="RktStxLink" data-pltdoc="x">#%provide</a></span><span class="hspace">&nbsp;</span><span class="RktVar">raw-provide-spec</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVar">module-level-form</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">submodule-form</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._~23~25declare%29%29" class="RktStxLink" data-pltdoc="x">#%declare</a></span><span class="hspace">&nbsp;</span><span class="RktVar">declaration-keyword</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">submodule-form</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-module-begin%29%29" class="RktStxLink" data-pltdoc="x">#%plain-module-begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVar">module-level-form</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-module-begin%29%29" class="RktStxLink" data-pltdoc="x">#%plain-module-begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVar">module-level-form</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-module-begin%29%29" class="RktStxLink" data-pltdoc="x">#%plain-module-begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVar">module-level-form</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">general-top-level-form</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25require%29%29" class="RktStxLink" data-pltdoc="x">#%require</a></span><span class="hspace">&nbsp;</span><span class="RktVar">raw-require-spec</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">expr</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-lambda%29%29" class="RktStxLink" data-pltdoc="x">#%plain-lambda</a></span><span class="hspace">&nbsp;</span><span class="RktVar">formals</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktSym">...+</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">formals</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktSym">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktSym">...+</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin0%29%29" class="RktStxLink" data-pltdoc="x">begin0</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktSym">...+</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-values%29%29" class="RktStxLink" data-pltdoc="x">letrec-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktSym">...+</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span><span class="hspace">&nbsp;</span><span class="RktVar">datum</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVar">datum</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVar">datum</span><span class="hspace">&nbsp;</span><span class="RktPn">#:local</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-app%29%29" class="RktStxLink" data-pltdoc="x">#%plain-app</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktSym">...+</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="Locations____variable-reference.html#%28form._%28%28quote._~23~25kernel%29._~23~25variable-reference%29%29" class="RktStxLink" data-pltdoc="x">#%variable-reference</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="Locations____variable-reference.html#%28form._%28%28quote._~23~25kernel%29._~23~25variable-reference%29%29" class="RktStxLink" data-pltdoc="x">#%variable-reference</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">id</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="Locations____variable-reference.html#%28form._%28%28quote._~23~25kernel%29._~23~25variable-reference%29%29" class="RktStxLink" data-pltdoc="x">#%variable-reference</a></span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">formals</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktSym">...+</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr></table></p><p>A <a name="(tech._fully._expanded)"></a><span style="font-style: italic">fully-expanded</span> <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> corresponds to a <a name="(tech._parse)"></a><span style="font-style: italic">parse</span>
+of a program (i.e., a <a name="(tech._parsed)"></a><span style="font-style: italic">parsed</span> program), and <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical
+information</span></a> on its <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifiers</span></a> indicates the
+<a href="syntax-model.html#%28tech._parse%29" class="techoutside" data-pltdoc="x"><span class="techinside">parse</span></a>.</p><p>More specifically, the typesetting of identifiers in the above grammar
+is significant. For example, the second case for <span class="RktVar">expr</span> is a
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax-object</span></a> list whose first element is an <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a>,
+where the <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a>&rsquo;s <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> specifies a
+binding to the <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-lambda%29%29" class="RktStxLink" data-pltdoc="x">#%plain-lambda</a></span> of the
+<a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> language (i.e., the <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> is
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span> to one whose binding is
+<span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-lambda%29%29" class="RktStxLink" data-pltdoc="x">#%plain-lambda</a></span>). In all cases, identifiers above typeset as
+syntactic-form names refer to the bindings defined in
+<a href="syntax.html" data-pltdoc="x">Syntactic Forms</a>.</p><p>In a fully expanded program for a namespace whose <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a> is
+0, the relevant <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> for a binding in the program is
+<span style="font-style: italic">N</span> if the binding has <span style="font-style: italic">N</span> surrounding
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> and/or <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span> forms&#8212;<wbr></wbr>not
+counting any <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> forms that wrap a
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> or <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> form for the body of the <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span>
+or <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span>, unless a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> form has <span class="RktVal">#f</span> in place
+of a <span class="RktVar">module-path</span> after the <span class="RktVar">id</span>. The
+<span class="RktVar">datum</span> in a <span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span> form
+preserves its information for all <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>s.</p><p>A reference to a <a href="syntax-model.html#%28tech._local._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">local binding</span></a> in a fully expanded program has
+a <a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope set</span></a> that matches its binding identifier exactly.
+Additional <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scopes</span></a>, if any, are removed. As a result,
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._bound-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">bound-identifier=?</a></span> can be used to correlate local binding
+identifiers with reference identifiers, while
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span> must be used to relate references to
+<a href="syntax-model.html#%28tech._module._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">module bindings</span></a> or <a href="syntax-model.html#%28tech._top._level._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level bindings</span></a>.</p><p>In addition to the grammar above, <span class="RktSym"><a href="__expression.html#%28form._%28%28quote._~23~25kernel%29._~23~25expression%29%29" class="RktStxLink" data-pltdoc="x">#%expression</a></span> can appear in
+a fully local-expanded expression position. For example,
+<span class="RktSym"><a href="__expression.html#%28form._%28%28quote._~23~25kernel%29._~23~25expression%29%29" class="RktStxLink" data-pltdoc="x">#%expression</a></span> can appear in the result from
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span> when the stop list is empty.
+Reference-identifier <a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope sets</span></a> are reduced in local-expanded
+expressions only when the <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span> stop list is empty.</p><p class="SHistory">Changed in version 6.3 of package <span class="stt">base</span>: Added the <span class="RktPn">#:local</span> variant of
+<span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span>; removed
+<span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span> from
+possibly appearing in a fully
+local-expanded form.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;expand-steps&quot;">1.2.3.2<tt>&nbsp;</tt><a name="(part._expand-steps)"></a>Expansion Steps</h5><p>In a recursive expansion, each single step in expanding a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax
+object</span></a> at a particular <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> depends on the immediate shape of
+the <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> being expanded:</p><ul><li><p>If it is an <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> (i.e., a syntax-object symbol),
+then a <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a> is determined by the <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a>&rsquo;s
+<a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a>. If the <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> has a
+<a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a>, that <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a> is used to continue. If the <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a>
+is <a href="syntax-model.html#%28tech._unbound%29" class="techoutside" data-pltdoc="x"><span class="techinside">unbound</span></a>, a new <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax-object</span></a> symbol
+<span class="RktVal">'</span><span class="RktVal">#%top</span> is created using the <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a>
+of the <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> with <a href="syntax-model.html#%28tech._implicit._made._explicit._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">implicit-made-explicit properties</span></a>;
+if this <span class="RktSym">#%top</span>
+<a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> has no <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a>, then parsing fails with an
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax</a></span> exception. Otherwise, the new
+<a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> is combined with the original
+<a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> in a new <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax-object</span></a> pair (also
+using the same <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> as the original
+<a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a>), and the <span class="RktSym">#%top</span> <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a>
+is used to continue.</p><p class="SHistory">Changed in version 6.3 of package <span class="stt">base</span>: Changed the introduction of
+<span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span> in a top-level context
+to <a href="syntax-model.html#%28tech._unbound%29" class="techoutside" data-pltdoc="x"><span class="techinside">unbound</span></a> identifiers only.</p></li><li><p>If it is a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax-object</span></a> pair whose first element is an
+<a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a>, and if the <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> has a
+<a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a> other than as a <a href="eval-model.html#%28tech._top._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level variable</span></a>, then
+the <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a>&rsquo;s <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a> is used to continue.</p></li><li><p>If it is a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax-object</span></a> pair of any other form, then a
+new <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax-object</span></a> symbol <span class="RktVal">'</span><span class="RktVal">#%app</span> is created
+using the <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> of the pair with
+<a href="syntax-model.html#%28tech._implicit._made._explicit._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">implicit-made-explicit properties</span></a>. If the
+resulting <span class="RktSym">#%app</span> <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> has no
+binding, parsing fails with an <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax</a></span>
+exception. Otherwise, the new <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> is combined
+with the original pair to form a new <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax-object</span></a> pair
+(also using the same <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> as the original
+pair), and the <span class="RktSym">#%app</span> <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a> is used to
+continue.</p></li><li><p>If it is any other syntax object, then a new
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax-object</span></a> symbol <span class="RktVal">'</span><span class="RktVal">#%datum</span> is created using
+the <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> of the original <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax
+object</span></a> with <a href="syntax-model.html#%28tech._implicit._made._explicit._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">implicit-made-explicit properties</span></a>. If the resulting <span class="RktSym">#%datum</span>
+<a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> has no <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a>, parsing fails with an
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax</a></span> exception. Otherwise, the new
+<a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> is combined with the original <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax
+object</span></a> in a new <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax-object</span></a> pair (using the same
+<a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> as the original pair), and the
+<span class="RktSym">#%datum</span> <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a> is used to continue.</p></li></ul><p>Thus, the possibilities that do not fail lead to an <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a>
+with a particular <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a>. This binding refers to one of three
+things:</p><ul><li><p>A <a name="(tech._transformer)"></a><span style="font-style: italic">transformer</span>, such as introduced by
+<span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span> or <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntax%29%29" class="RktStxLink" data-pltdoc="x">let-syntax</a></span>. If the
+associated value is a procedure of one argument, the procedure
+is called as a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> (described below), and
+parsing starts again with the <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax-object</span></a> result. If
+the <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding is to any other kind of value,
+parsing fails with an <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3asyntax%29%29" class="RktValLink" data-pltdoc="x">exn:fail:syntax</a></span> exception. The
+call to the <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> is <span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span>d
+to set <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span> to a <a href="syntax-model.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespace</span></a> that
+shares <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">bindings</span></a> and <a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variables</span></a> with the namespace
+being used to expand, except that its <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a> is one
+greater.</p></li><li><p>A <a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable</span></a> <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a>, such as introduced by a
+module-level <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span> or by <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span>. In this case,
+if the form being parsed is just an <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a>, then it
+is parsed as a reference to the corresponding
+<a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable</span></a>. If the form being parsed is a
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax-object</span></a> pair, then an <span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25app%29%29" class="RktStxLink" data-pltdoc="x">#%app</a></span> is added to
+the front of the <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax-object</span></a> pair in the same way as
+when the first item in the <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax-object</span></a> pair is not an
+identifier (third case in the previous enumeration), and
+parsing continues.</p></li><li><p>A core <a name="(tech._syntactic._form)"></a><span style="font-style: italic">syntactic form</span> (often abbreviated as <a name="(tech._core._form)"></a><span style="font-style: italic">core form</span>), which is parsed as described
+for each form in <a href="syntax.html" data-pltdoc="x">Syntactic Forms</a>. Parsing a core syntactic
+form typically involves recursive parsing of sub-forms, and may
+introduce <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">bindings</span></a> that determine the parsing of
+sub-forms.</p></li></ul><p>When a <span class="RktSym">#%top</span>, <span class="RktSym">#%app</span>, or
+<span class="RktSym">#%datum</span> identifier is added by the expander, it is
+given <a name="(tech._implicit._made._explicit._property)"></a><span style="font-style: italic">implicit-made-explicit properties</span>: an
+<span class="RktVal">'</span><span class="RktVal">implicit-made-explicit</span> <a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax property</span></a> whose value is
+<span class="RktVal">#t</span>, and a hidden property to indicate that the implicit
+identifier is original in the sense of <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-original~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-original?</a></span> if
+the syntax object that gives the identifier its <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a>
+has that property.</p><p class="SHistory">Changed in version 7.9.0.13 of package <span class="stt">base</span>: Added <a href="syntax-model.html#%28tech._implicit._made._explicit._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">implicit-made-explicit
+properties</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;expand-context-model&quot;">1.2.3.3<tt>&nbsp;</tt><a name="(part._expand-context-model)"></a>Expansion Context</h5><p>Each expansion step occurs in a particular <a name="(tech._context)"></a><span style="font-style: italic">context</span>, and
+transformers and core syntactic forms may expand differently for
+different <a href="syntax-model.html#%28tech._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">contexts</span></a>. For example, a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> form is
+allowed only in a <a href="syntax-model.html#%28tech._top._level._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level context</span></a> or <a href="syntax-model.html#%28tech._module._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">module context</span></a>, and it fails in other
+contexts. The possible <a href="syntax-model.html#%28tech._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">contexts</span></a> are as follows:</p><ul><li><p><a name="(tech._top._level._context)"></a><span style="font-style: italic">top-level context</span> : outside of any module, definition, or
+expression, except that sub-expressions of a top-level
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> form are also expanded as top-level forms.</p></li><li><p><a name="(tech._module._begin._context)"></a><span style="font-style: italic">module-begin context</span> : inside the body of a module, as the
+only form within the module.</p></li><li><p><a name="(tech._module._context)"></a><span style="font-style: italic">module context</span> : in the body of a module (inside the
+module-begin layer).</p></li><li><p><a name="(tech._internal._definition._context)"></a><span style="font-style: italic">internal-definition context</span> : in a nested context that allows
+both definitions and expressions.</p></li><li><p><a name="(tech._expression._context)"></a><span style="font-style: italic">expression context</span> : in a context where only
+expressions are allowed.</p></li></ul><p>Different core <a href="syntax-model.html#%28tech._syntactic._form%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntactic forms</span></a> parse sub-forms using different
+<a href="syntax-model.html#%28tech._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">contexts</span></a>. For example, a <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span> form always parses the
+right-hand expressions of a binding in an <a href="syntax-model.html#%28tech._expression._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">expression context</span></a>,
+but it starts parsing the body in an <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition
+context</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;intro-binding&quot;">1.2.3.4<tt>&nbsp;</tt><a name="(part._intro-binding)"></a>Introducing Bindings</h5><p><a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">Bindings</span></a> are introduced during <a href="syntax-model.html#%28tech._expansion%29" class="techoutside" data-pltdoc="x"><span class="techinside">expansion</span></a> when certain
+core syntactic forms are encountered:</p><ul><li><p>When a <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> form is encountered at the top level or
+module level, each symbol specified by the form is paired with the
+<a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope set</span></a> of the specification to introduce new bindings.
+If not otherwise indicated in the
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> form, bindings are introduced at the
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>s specified by the exporting modules:
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 0 for each normal <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span>,
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 1 for each <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span>
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span>, and so on. The <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-meta%29%29" class="RktStxLink" data-pltdoc="x">for-meta</a></span>
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> form allows exports at an arbitrary
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> (as long as a binding exists within the
+module at the <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>).</p><p>A <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span> sub-form within <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> imports
+similarly, but the resulting bindings have a <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>
+that is one more than the exported <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase levels</span></a>, when
+exports for the <a href="syntax-model.html#%28tech._label._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">label phase level</span></a> are still imported at
+the <a href="syntax-model.html#%28tech._label._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">label phase level</span></a>. More generally, a
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-meta%29%29" class="RktStxLink" data-pltdoc="x">for-meta</a></span> sub-form within <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> imports with
+the specified <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> shift; if the specified shift
+is <span class="RktVal">#f</span>, or if <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-label%29%29" class="RktStxLink" data-pltdoc="x">for-label</a></span> is used to import,
+then all bindings are imported into the <a href="syntax-model.html#%28tech._label._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">label phase
+level</span></a>.</p></li><li><p>When a <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span>, <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span>,
+<span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span>, or <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span> form is
+encountered at the top level or module level, a binding is
+added to <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 0 (i.e., the <a href="syntax-model.html#%28tech._base._environment%29" class="techoutside" data-pltdoc="x"><span class="techinside">base environment</span></a>
+is extended) for each defined identifier.</p></li><li><p>When a <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> form is encountered at the top
+level or module level, bindings are introduced as for
+<span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span> and <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span>, but at
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 1 (i.e., the <a href="syntax-model.html#%28tech._transformer._environment%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer environment</span></a>
+is extended). More generally, <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> forms
+can be nested, and each <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> shifts its
+body by one <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>.</p></li><li><p>When a <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span> form is encountered, the body of the
+<span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span> form is extended (by creating new
+<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax objects</span></a>) with a fresh <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a>. The <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a> is added to the identifiers
+themselves, so that the identifiers in binding position are
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._bound-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">bound-identifier=?</a></span> to uses in the fully expanded form,
+and so they are not <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._bound-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">bound-identifier=?</a></span> to other
+identifiers. The new bindings are at the
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> at which the <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span> form is
+expanded.</p></li><li><p>When a <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-values%29%29" class="RktStxLink" data-pltdoc="x">letrec-values</a></span> or
+<span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span> form is encountered, bindings
+are added as for <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span>, except that the
+right-hand-side expressions are also extended with the
+new <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a>.</p></li><li><p>Definitions in <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition contexts</span></a> introduce
+new scopes and bindings as described in <a href="syntax-model.html#%28part._intdef-body%29" data-pltdoc="x">Internal Definitions</a>.</p></li></ul><p>For example, in</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>the binding introduced for <span class="RktSym">x</span> applies to the <span class="RktSym">x</span> in the
+body, because a fresh <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a> is created and added to both the binding
+<span class="RktSym">x</span> and reference <span class="RktSym">x</span>. The same scope is added to the
+<span class="RktSym">y</span>, but since it has a different symbol than the binding
+<span class="RktSym">x</span>, it does not refer to the new binding. Any <span class="RktSym">x</span>
+outside of this <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span> form does not receive the fresh
+<a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a> and therefore does not refer to the new binding.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;transformer-model&quot;">1.2.3.5<tt>&nbsp;</tt><a name="(part._transformer-model)"></a>Transformer Bindings</h5><p>In a <a href="syntax-model.html#%28tech._top._level._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level context</span></a> or <a href="syntax-model.html#%28tech._module._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">module context</span></a>, when the
+expander encounters a <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span> form, the binding that
+it introduces for the defined identifiers is a <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a>
+binding. The <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">value</span></a> of the <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a> exists at expansion
+time, rather than run time (though the two times can overlap), though
+the binding itself is introduced with <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 0 (i.e., in
+the <a href="syntax-model.html#%28tech._base._environment%29" class="techoutside" data-pltdoc="x"><span class="techinside">base environment</span></a>).</p><p>The <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">value</span></a> for the binding is obtained by evaluating the
+expression in the <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span> form. This expression must
+be <a href="syntax-model.html#%28tech._expand%29" class="techoutside" data-pltdoc="x"><span class="techinside">expand</span></a>ed (i.e., parsed) before it can be evaluated, and it is
+expanded at <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 1 (i.e., in the <a href="syntax-model.html#%28tech._transformer._environment%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer
+environment</span></a>) instead of <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 0.</p><p>If the resulting <a href="eval-model.html#%28tech._value%29" class="techoutside" data-pltdoc="x"><span class="techinside">value</span></a> is a procedure of one argument or
+the result of <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-set%21-transformer%29%29" class="RktValLink" data-pltdoc="x">make-set!-transformer</a></span> on a procedure, then it
+is used as a <a name="(tech._syntax._transformer)"></a><span style="font-style: italic">syntax transformer</span> (a.k.a. <a name="(tech._macro)"></a><span style="font-style: italic">macro</span>).
+The procedure is expected to accept a syntax object and return a
+syntax object. A use of the binding (at <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 0) triggers
+a call of the <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a> by the expander; see
+<a href="syntax-model.html#%28part._expand-steps%29" data-pltdoc="x">Expansion Steps</a>.</p><p>Before the expander passes a <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> to a transformer,
+the <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> is extended with a fresh <a name="(tech._macro._introduction._scope)"></a><span style="font-style: italic">macro-introduction scope</span>
+(that applies to all sub-<a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax objects</span></a>) to distinguish <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax objects</span></a>
+at the macro&rsquo;s use site from <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax objects</span></a> that are introduced by the macro;
+in the result of the transformer the presence of the <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a> is
+flipped, so that introduced <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax objects</span></a> retain the <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a>,
+and use-site <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax objects</span></a> do not have it. In addition, if
+the use of a transformer is in the same definition context as its binding,
+the use-site <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> is extended with an additional fresh
+<a name="(tech._use._site._scope)"></a><span style="font-style: italic">use-site scope</span> that is not flipped in the transformer&rsquo;s result,
+so that only use-site <a href="syntax-model.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax objects</span></a> have the <a href="syntax-model.html#%28tech._use._site._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">use-site scope</span></a>.</p><p>The <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a>-introduction process for macro expansion helps keep
+binding in an expanded program consistent with the lexical structure
+of the source program. For example, the expanded form of the program</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">12</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="RktStxLink" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr></table></blockquote><p>is</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">12</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr></table></blockquote><p>However, the result of the last expression is <span class="RktVal">12</span>, not
+<span class="RktVal">10</span>. The reason is that the transformer bound to <span class="RktSym">m</span>
+introduces the binding <span class="RktSym">x</span>, but the referencing <span class="RktSym">x</span> is
+present in the argument to the transformer. The introduced <span class="RktSym">x</span>
+is left with one fresh <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a>, while the reference <span class="RktSym">x</span> has a different fresh <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a>,
+so the binding <span class="RktSym">x</span> is not <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._bound-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">bound-identifier=?</a></span> to the
+body <span class="RktSym">x</span>.</p><p>A <a href="syntax-model.html#%28tech._use._site._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">use-site scope</span></a> on a binding identifier is ignored when the
+definition is in the same context where the <a href="syntax-model.html#%28tech._use._site._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">use-site scope</span></a> was
+introduced. This special treatment of <a href="syntax-model.html#%28tech._use._site._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">use-site scopes</span></a> allows a
+macro to expand to a visible definition. For example, the expanded
+form of the program</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="RktStxLink" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktSym">x</span></td></tr></table></blockquote><p>is</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktSym">x</span></td></tr></table></blockquote><p>where the <span class="RktSym">x</span> in the <span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span> form has a <a href="syntax-model.html#%28tech._use._site._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">use-site
+scope</span></a> that is not present on the final <span class="RktSym">x</span>. The final
+<span class="RktSym">x</span> nevertheless refers to the definition, because the
+<a href="syntax-model.html#%28tech._use._site._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">use-site scope</span></a> is effectively removed before installing the
+definition&rsquo;s binding. In contrast, the expansion of</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="RktStxLink" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr></table></blockquote><p>is</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>where the second <span class="RktSym">x</span> has a <a href="syntax-model.html#%28tech._use._site._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">use-site scope</span></a> that prevents
+it from binding the final <span class="RktSym">x</span>. The <a href="syntax-model.html#%28tech._use._site._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">use-site scope</span></a> is not
+ignored in this case, because the binding is not part of the definition
+context where <span class="RktPn">(</span><span class="RktSym">m</span><span class="stt"> </span><span class="RktSym">x</span><span class="RktPn">)</span> was expanded.</p><p>The <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span> form works with the <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-set%21-transformer%29%29" class="RktValLink" data-pltdoc="x">make-set!-transformer</a></span>
+and <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3aset%21-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:set!-transformer</a></span> property to support
+<a name="(tech._assignment._transformer)"></a><span style="font-style: italic">assignment transformers</span> that transform <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>
+expressions. An <a href="syntax-model.html#%28tech._assignment._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">assignment transformer</span></a> contains a procedure
+that is applied by <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span> in the same way as a normal
+transformer by the expander.</p><p>The <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span> procedure or
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._prop~3arename-transformer%29%29" class="RktValLink" data-pltdoc="x">prop:rename-transformer</a></span> property creates a value that is also
+handled specially by the expander and by <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span> as a
+transformer binding&rsquo;s value. When <span class="RktVar">id</span> is bound to a
+<a name="(tech._rename._transformer)"></a><span style="font-style: italic">rename transformer</span> produced by
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span>, it is replaced with the target
+identifier passed to <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._make-rename-transformer%29%29" class="RktValLink" data-pltdoc="x">make-rename-transformer</a></span>. In addition, as
+long as the target identifier does not have a true value for the
+<span class="RktVal">'</span><span class="RktVal">not-free-identifier=?</span> <a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax property</span></a>, the
+binding table is extended to indicate that <span class="RktVar">id</span> is an alias
+for the identifier in the <a href="syntax-model.html#%28tech._rename._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">rename transformer</span></a>. The
+<span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._free-identifier~3d~3f%29%29" class="RktValLink" data-pltdoc="x">free-identifier=?</a></span> function follows aliasing chains to determine
+equality of bindings, the <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="RktValLink" data-pltdoc="x">identifier-binding</a></span> function
+similarly follows aliasing chains, and the <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span> form
+exports <span class="RktVar">id</span> as the target identifier. Finally, the
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value</a></span> function follows <a href="syntax-model.html#%28tech._rename._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">rename transformer</span></a>
+chains even when binding aliases are not installed.</p><p>In addition to using scopes to track introduced identifiers, the
+expander tracks the expansion history of a form through <a href="stxprops.html#%28tech._syntax._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax
+properties</span></a> such as <span class="RktVal">'</span><span class="RktVal">origin</span>. See <a href="stxprops.html" data-pltdoc="x">Syntax Object Properties</a> for
+more information.</p><p>The expander&rsquo;s handling of <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span> is similar
+to its handling of <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span>. A
+<span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span> can be expanded in an arbitrary phase
+level <span style="font-style: italic">n</span> (not just 0), in which case the expression for the
+<a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding is expanded at <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> <span style="font-style: italic">n+</span>1<span style="font-style: italic"></span>.</p><p>The expressions in a <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> form are expanded and
+evaluated in the same way as for <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span>. However,
+any introduced bindings from definition within
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span> are at <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 1 (not a
+<a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> binding at <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 0).</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;local-binding-context&quot;">1.2.3.6<tt>&nbsp;</tt><a name="(part._local-binding-context)"></a>Local Binding Context</h5><p>Although the <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a> of an <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> can be uniquely determined from the combination of
+its <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> and the global binding table, the expander also maintains a
+<a name="(tech._local._binding._context)"></a><span style="font-style: italic">local binding context</span> that records additional information about <a href="syntax-model.html#%28tech._local._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">local bindings</span></a> to
+ensure they are not used outside of the lexical region in which they are bound.</p><p>Due to the way local binding forms like <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span> add a fresh <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a> to both bound
+<a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifiers</span></a> and body forms, it isn&#8217;t ordinarily possible for an <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> to reference
+a <a href="syntax-model.html#%28tech._local._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">local binding</span></a> without appearing in the body of the <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span>. However, if macros use
+compile-time state to stash bound <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifiers</span></a>, or use <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span> to extract
+<a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifiers</span></a> from an expanded binding form, they can violate this constraint. For example, the
+following <span class="RktSym">stash-id</span> and <span class="RktSym">unstash-id</span> macros cooperate to move a reference to a
+locally-bound <span class="RktSym">x</span> <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> outside of the lexical region in which it is bound:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stashed-id</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stash-id</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stashed-id</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">id</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">unstash-id</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">stashed-id</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">42</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stash-id</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">unstash-id</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">42</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">unstash-id</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">eval:5:0: x: identifier used out of context</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: x</span></p></td></tr></table></blockquote><p>In general, an <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a>&#8217;s <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> is not sufficient to know whether or not
+its <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a> is available in the enclosing context, since the <a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope set</span></a> for the
+<a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> stored in <span class="RktSym">stashed-id</span> unambiguously refers to a binding in the global
+binding table. This can be observed by the fact that <span class="RktSym"><a href="stxcmp.html#%28def._%28%28quote._~23~25kernel%29._identifier-binding%29%29" class="RktValLink" data-pltdoc="x">identifier-binding</a></span> produces
+<span class="RktVal">'</span><span class="RktVal">lexical</span>, not <span class="RktVal">#f</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stashed-id-binding</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRdr">#`</span><span class="RktVal">'</span><span class="RktVal">#,</span><span class="RktVal">(</span><span class="RktVal">identifier-binding</span><span class="hspace">&nbsp;</span><span class="RktVal">stashed-id</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">stashed-id-binding</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'lexical</span></p></td></tr></table></blockquote><p>However, the reference produced by <span class="RktPn">(</span><span class="RktSym">unstash-id</span><span class="RktPn">)</span> in the above program is still illegal, even
+if it isn&#8217;t technically unbound. To record the fact that <span class="RktSym">x</span>&#8217;s <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a> is in scope only
+within the body of its corresponding <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span> form, the expander adds <span class="RktSym">x</span>&#8217;s <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a>
+to the <a href="syntax-model.html#%28tech._local._binding._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">local binding context</span></a> while expanding the <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span> body. More generally, the
+expander adds all <a href="eval-model.html#%28tech._local._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">local variable</span></a> <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">bindings</span></a> to the <a href="syntax-model.html#%28tech._local._binding._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">local binding context</span></a> while
+expanding expressions in which a reference to the <a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable</span></a> would be legal. When the expander
+encounters an <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> bound to a <a href="eval-model.html#%28tech._local._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">local variable</span></a>, and the associated <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a> is
+not in the current <a href="syntax-model.html#%28tech._local._binding._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">local binding context</span></a>, it raises a syntax error.</p><p>The <a href="syntax-model.html#%28tech._local._binding._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">local binding context</span></a> also tracks local <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">bindings</span></a> (i.e. bindings
+bound by forms like <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntax%29%29" class="RktStxLink" data-pltdoc="x">let-syntax</a></span>) in a similar way, except that the context also stores the
+compile-time value associated with the <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a>. When an <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> that is locally
+bound as a <a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> is used in application position as a <a href="syntax-model.html#%28tech._syntax._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax transformer</span></a>, or its
+compile-time value is looked up using <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value</a></span>, the <a href="syntax-model.html#%28tech._local._binding._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">local binding context</span></a> is
+consulted to retrieve the value. If the <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">binding</span></a> is in scope, its associated compile-time value
+is used; otherwise, the expander raises a syntax error.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stashed-id-local-value</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRdr">#`</span><span class="RktVal">'</span><span class="RktVal">#,</span><span class="RktVal">(</span><span class="RktVal">syntax-local-value</span><span class="hspace">&nbsp;</span><span class="RktVal">stashed-id</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntax%29%29" class="RktStxLink" data-pltdoc="x">let-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">42</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stash-id</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stashed-id-local-value</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">42</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">stashed-id-local-value</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">syntax-local-value: identifier is not bound to syntax:</span></p></td></tr><tr><td><p><span class="RktErr">#&lt;syntax:eval:11:0 y&gt;</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;partial-expansion&quot;">1.2.3.7<tt>&nbsp;</tt><a name="(part._partial-expansion)"></a>Partial Expansion</h5><p>In certain contexts, such as an <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a> or
+<a href="syntax-model.html#%28tech._module._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">module context</span></a>, <a name="(tech._partial._expansion)"></a><span style="font-style: italic">partial expansion</span> is used to determine
+whether forms represent definitions, expressions, or other declaration
+forms. Partial expansion works by cutting off the normal recursive
+expansion when the relevant binding is for a primitive syntactic form.</p><p>As a special case, when expansion would otherwise add an
+<span class="RktSym">#%app</span>, <span class="RktSym">#%datum</span>, or <span class="RktSym">#%top</span>
+identifier to an expression, and when the binding turns out to be the
+primitive <span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25app%29%29" class="RktStxLink" data-pltdoc="x">#%app</a></span>, <span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._~23~25datum%29%29" class="RktStxLink" data-pltdoc="x">#%datum</a></span>, or <span class="RktSym"><a href="__top.html#%28form._%28%28quote._~23~25kernel%29._~23~25top%29%29" class="RktStxLink" data-pltdoc="x">#%top</a></span> form,
+then expansion stops without adding the identifier.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;intdef-body&quot;">1.2.3.8<tt>&nbsp;</tt><a name="(part._intdef-body)"></a>Internal Definitions</h5><p>An <a href="syntax-model.html#%28tech._internal._definition._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">internal-definition context</span></a> supports local definitions mixed
+with expressions. Forms that allow internal definitions document such
+positions using the <span class="RktVar">body</span> meta-variable. Definitions in an
+internal-definition context are equivalent to local binding via
+<span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span>; macro expansion converts internal
+definitions to a <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span> form.</p><p>Expansion relies on <a href="syntax-model.html#%28tech._partial._expansion%29" class="techoutside" data-pltdoc="x"><span class="techinside">partial expansion</span></a> of each <span class="RktVar">body</span> in
+an internal-definition sequence. Partial expansion of each
+<span class="RktVar">body</span> produces a form matching one of the following cases:</p><ul><li><p>A <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span> form: The binding table is immediately enriched
+with bindings for the <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span> form.  Further
+expansion of the definition is deferred, and partial expansion
+continues with the rest of the body.</p></li><li><p>A <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span> form: The right-hand side is
+expanded and evaluated (as for a
+<span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span> form), and a transformer
+binding is installed for the body sequence before partial
+expansion continues with the rest of the body.</p></li><li><p>A primitive expression form other than <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span>: Further
+expansion of the expression is deferred, and partial expansion
+continues with the rest of the body.</p></li><li><p>A <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> form: The sub-forms of the <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> are
+spliced into the internal-definition sequence, and partial
+expansion continues with the first of the newly-spliced forms
+(or the next form, if the <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span> had no sub-forms).</p></li></ul><p>After all body forms are partially expanded, if no definitions were
+encountered, then the expressions are collected into a <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span>
+form as the internal-definition context&rsquo;s expansion.  Otherwise, at
+least one expression must appear after the last definition, and any
+<span class="RktVar">expr</span> that appears between definitions is converted to
+<span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktVar">expr</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>; the definitions
+are then converted to bindings in a <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span>
+form, and all expressions after the last definition become the body of
+the <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-syntaxes%2Bvalues%29%29" class="RktStxLink" data-pltdoc="x">letrec-syntaxes+values</a></span> form.</p><p>Before partial expansion begins, expansion of an internal-definition
+context begins with the introduction of a fresh <a name="(tech._outside._edge._scope)"></a><span style="font-style: italic">outside-edge
+scope</span> on the content of the internal-definition context. This
+outside-edge scope effectively identifies syntax objects that are
+present in the original form. An <a name="(tech._inside._edge._scope)"></a><span style="font-style: italic">inside-edge scope</span> is also
+created and added to the original content; furthermore, the
+inside-edge scope is added to the result of any partial expansion.
+This inside-edge scope ensures that all bindings introduced by the
+internal-definition context have a particular scope in common.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;mod-parse&quot;">1.2.3.9<tt>&nbsp;</tt><a name="(part._mod-parse)"></a>Module Expansion, Phases, and Visits</h5><p>Expansion of a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> form proceeds in a similar way to
+<a href="syntax-model.html#%28part._intdef-body%29" data-pltdoc="x">expansion of an internal-definition context</a>:
+an <a href="syntax-model.html#%28tech._outside._edge._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">outside-edge scope</span></a> is created for the original module
+content, and an <a href="syntax-model.html#%28tech._inside._edge._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">inside-edge scope</span></a> is added to both the original
+module and any form that appears during a partial expansion of the
+module&rsquo;s top-level forms to uncover definitions and imports.</p><p>A <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> form not only introduces <a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">bindings</span></a> at
+expansion time, but also <a name="(tech._visit)"></a><span style="font-style: italic">visits</span> the referenced module when
+it is encountered by the expander. That is, the expander instantiates
+any variables defined in the module within <span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span>,
+and it also evaluates all expressions for <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span>
+<a href="syntax-model.html#%28tech._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer</span></a> bindings.</p><p>Module <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visits</span></a> propagate through <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s in the same
+way as module <a href="eval-model.html#%28tech._instantiation%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiation</span></a>. Moreover, when a module is
+<a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed at <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> 0, any module that it <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span> is <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d at <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> 1, while
+further <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-template%29%29" class="RktStxLink" data-pltdoc="x">for-template</a></span> leading back
+to <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> 0 causes the required module to be visited at
+<a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> 0 (i.e., not <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>d).</p><p>During compilation, the top-level of module context is itself
+implicitly <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed. Thus, when the expander encounters
+<span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span>, it immediately
+<a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiate</span></a>s the required module at <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> 1, in addition
+to adding bindings at <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 1 (i.e., the
+<a href="syntax-model.html#%28tech._transformer._environment%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer environment</span></a>). Similarly, the expander immediately
+evaluates any form that it encounters within
+<span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">begin-for-syntax</a></span>.</p><p><a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">Phases</span></a> beyond 0 are <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed on demand. For example,
+when the right-hand side of a <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a>-0 <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let-syntax%29%29" class="RktStxLink" data-pltdoc="x">let-syntax</a></span> is to
+be expanded, then modules that are <a href="eval-model.html#%28tech._available%29" class="techoutside" data-pltdoc="x"><span class="techinside">available</span></a> at <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> 1
+are visited. More generally, initiating expansion at <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a>
+<span style="font-style: italic">n</span> <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>s modules at <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> <span style="font-style: italic">n</span>, which in turn
+<a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiates</span></a> modules at <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a> <span style="font-style: italic">n+</span>1<span style="font-style: italic"></span>. These
+<a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visits</span></a> and <a href="eval-model.html#%28tech._instantiation%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiations</span></a> apply to <a href="eval-model.html#%28tech._available%29" class="techoutside" data-pltdoc="x"><span class="techinside">available</span></a>
+modules in the enclosing <a href="syntax-model.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespace</span></a>&rsquo;s <a href="syntax-model.html#%28tech._module._registry%29" class="techoutside" data-pltdoc="x"><span class="techinside">module registry</span></a>;
+a per-registry lock prevents multiple threads from concurrently
+instantiating and visiting available modules. On-demand instantiation
+of available modules uses the same reentrant lock as
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-call-with-registry-lock%29%29" class="RktValLink" data-pltdoc="x">namespace-call-with-registry-lock</a></span>.</p><p>When the expander encounters <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> and <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._for-syntax%29%29" class="RktStxLink" data-pltdoc="x">for-syntax</a></span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span> within a <a href="syntax-model.html#%28tech._module._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">module context</span></a>, the resulting
+<a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visits</span></a> and <a href="eval-model.html#%28tech._instantiation%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiations</span></a> are specific to the expansion
+of the enclosing module, and are kept separate from <a href="syntax-model.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visits</span></a> and
+<a href="eval-model.html#%28tech._instantiation%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiations</span></a> triggered from a <a href="syntax-model.html#%28tech._top._level._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level context</span></a> or
+from the expansion of a different module. Along the same lines, when a
+module is attached to a namespace through
+<span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-attach-module%29%29" class="RktValLink" data-pltdoc="x">namespace-attach-module</a></span>, modules that it <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>s
+are transitively attached, but instances are attached only at
+phases at or below the namespace&rsquo;s <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;macro-introduced-bindings&quot;">1.2.3.10<tt>&nbsp;</tt><a name="(part._macro-introduced-bindings)"></a>Macro-Introduced Bindings</h5><p>When a top-level definition binds an identifier that originates from a
+ macro expansion, the definition captures only uses of the identifier
+ that are generated by the same expansion due to the fresh <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a>
+ that is generated for the expansion.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">def-and-use-of-x</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="RktStxLink" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">def-and-use-of-x</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktSym">x</span><span class="RktCmt"> below originates from this macro:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">x</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">def-and-use-of-x</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">x</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">def-and-use</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="RktStxLink" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">def-and-use</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktVal">"x"</span><span class="RktCmt"> below was provided by the macro use:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">def-and-use</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">x</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></blockquote></div></p><p>For a top-level definition (outside of a module), the order of
+ evaluation affects the binding of a generated definition for a
+ generated identifier use. If the use precedes the definition, then
+ the use is resolved with the bindings that are in place at that
+ point, which will not include the binding from the subsequently
+ macro-generated definition. (No such dependency on order occurs
+ within a module, since a module binding covers the entire module
+ body.) To support the declaration of an identifier before its use,
+ the <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span> form avoids binding an identifier if the
+ body of the <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span> declaration produces zero
+ results.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bucket-1</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bucket-2</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">def-and-set!-use-of-x</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="RktStxLink" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">def-and-set!-use-of-x</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bucket-1</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bucket-2</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">def-and-set!-use-of-x</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">x</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">bucket-1</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">bucket-2</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">defs-and-uses/fail</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="RktStxLink" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">def-and-use</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Initial reference to </span><span class="RktSym">even</span><span class="RktCmt"> precedes definition:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">odd</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">even</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">even</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">odd</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">odd</span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">defs-and-uses/fail</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">even: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">defs-and-uses</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-rules%29%29" class="RktStxLink" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">def-and-use</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Declare before definition via no-values </span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span><span class="RktCmt">:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-syntaxes%29%29" class="RktStxLink" data-pltdoc="x">define-syntaxes</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">odd</span><span class="hspace">&nbsp;</span><span class="RktSym">even</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">odd</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">even</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">even</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._zero~3f%29%29" class="RktValLink" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">odd</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">odd</span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">defs-and-uses</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p>Macro-generated <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> and <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span>
+ clauses also introduce and reference generation-specific bindings
+ (due to the added <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a>) with the same ordering effects as
+ for definitions. The bindings depend on the <a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope set</span></a> attached
+ to specific parts of the form:</p><ul><li><p>In <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span>, for a <span class="RktVar">require-spec</span> of the form
+<span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._rename-in%29%29" class="RktStxLink" data-pltdoc="x">rename-in</a></span><span class="stt"> </span><span class="RktPn">[</span><span class="RktVar">orig-id</span><span class="stt"> </span><span class="RktVar">bind-id</span><span class="RktPn">]</span><span class="RktPn">)</span> or <span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._only-in%29%29" class="RktStxLink" data-pltdoc="x">only-in</a></span><span class="stt"> </span><span class="RktSym">....</span><span class="stt"> </span><span class="RktPn">[</span><span class="RktVar">orig-id</span><span class="stt"> </span><span class="RktVar">bind-id</span><span class="RktPn">]</span><span class="RktPn">)</span>, the <span class="RktVar">bind-id</span> supplies the
+<a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope set</span></a> for the binding. In <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> for other
+<span class="RktVar">require-spec</span>s, the generator of the <span class="RktVar">require-spec</span>
+determines the <a href="syntax-model.html#%28tech._scope._set%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope set</span></a>.</p></li><li><p>In <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span>, for a <span class="RktVar">provide-spec</span> of the form
+<span class="RktVar">id</span>, the exported identifier is the one that binds
+<span class="RktVar">id</span>, but the
+external name is the plain, symbolic part of <span class="RktVar">id</span>. The exceptions for
+<span class="RktSym">all-except-out</span> are similarly determined, as is the <span class="RktVar">orig-id</span> binding of a
+<span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._rename-out%29%29" class="RktStxLink" data-pltdoc="x">rename-out</a></span> form, and plain symbols are used for the
+external names. For <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-defined-out%29%29" class="RktStxLink" data-pltdoc="x">all-defined-out</a></span>, only identifiers with
+definitions having only the scopes of
+<span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._all-defined-out%29%29" class="RktStxLink" data-pltdoc="x">all-defined-out</a></span><span class="RktPn">)</span> form are exported; the external name is
+the plain symbol from the definition.</p></li></ul><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;compilation-model&quot;">1.2.4<tt>&nbsp;</tt><a name="(part._compilation-model)"></a>Compilation</h5><p>Before expanded code is evaluated, it is first <a name="(tech._compiled)"></a><span style="font-style: italic">compiled</span>. A
+compiled form has essentially the same information as the
+corresponding expanded form, though the internal representation
+naturally dispenses with identifiers for syntactic forms and local
+bindings. One significant difference is that a compiled form is almost
+entirely opaque, so the information that it contains cannot be
+accessed directly (which is why some identifiers can be dropped). At
+the same time, a compiled form can be marshaled to and from a byte
+string, so it is suitable for saving and re-loading code.</p><p>Although individual read, expand, compile, and evaluate operations are
+available, the operations are often combined automatically. For
+example, the <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span> procedure takes a syntax object and expands
+it, compiles it, and evaluates it.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;namespace-model&quot;">1.2.5<tt>&nbsp;</tt><a name="(part._namespace-model)"></a>Namespaces</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span>See <a href="Namespaces.html" data-pltdoc="x">Namespaces</a> for functions that
+manipulate namespaces.</p></blockquote></blockquote></blockquote><p>A <a name="(tech._namespace)"></a><span style="font-style: italic">namespace</span> is both a starting point for parsing and a
+starting point for running <a href="syntax-model.html#%28tech._compiled%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled</span></a> code. A <a href="syntax-model.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespace</span></a>
+also has a <a name="(tech._module._registry)"></a><span style="font-style: italic">module registry</span> that maps module names to module
+declarations (see <a href="eval-model.html#%28part._module-eval-model%29" data-pltdoc="x">Modules and Module-Level Variables</a>). This registry is
+shared by all <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>s, and it applies both to parsing and
+to running <a href="syntax-model.html#%28tech._compiled%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled</span></a> code.</p><p>As a starting point for parsing, a <a href="syntax-model.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespace</span></a> provides scopes
+(one per <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>, plus one that spans all <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase
+levels</span></a>). Operations such as <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._namespace-require%29%29" class="RktValLink" data-pltdoc="x">namespace-require</a></span> create initial
+<a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">bindings</span></a> using the namespace&rsquo;s <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scopes</span></a>, and the further
+expansion and evaluation in the namespace can create additional
+<a href="syntax-model.html#%28tech._binding%29" class="techoutside" data-pltdoc="x"><span class="techinside">bindings</span></a>. Evaluation of a form with a namespace always adds the
+namespace&rsquo;s phase-specific <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scopes</span></a> to the form and to the result
+of expanding a top-level form; as a consequence, every binding identifier
+has at least one <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a>. The namespace&rsquo;s additional scope is added
+only on request (e.g., by using <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span> as opposed to
+<span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval-syntax%29%29" class="RktValLink" data-pltdoc="x">eval-syntax</a></span>); if requested, the additional scope is added at all
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase levels</span></a>. Except for
+namespaces generated by a module (see <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._module-~3enamespace%29%29" class="RktValLink" data-pltdoc="x">module-&gt;namespace</a></span>),
+every namespace uses the same <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a> as the one added to all
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase levels</span></a>, while the <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scopes</span></a> specific to a <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase
+level</span></a> are always distinct.</p><p>As a starting point for evaluating <a href="syntax-model.html#%28tech._compiled%29" class="techoutside" data-pltdoc="x"><span class="techinside">compiled</span></a> code, each namespace
+encapsulates a distinct set of top-level variables at various
+<a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phases</span></a>, as well as a potentially distinct set of module
+instances in each <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a>. That is, even though module
+declarations are shared for all <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase levels</span></a>, module instances
+are distinct for each <a href="eval-model.html#%28tech._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase</span></a>. Each namespace has a <a name="(tech._base._phase)"></a><span style="font-style: italic">base
+phase</span>, which corresponds to the phase used by reflective operations
+such as <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span> and <span class="RktSym"><a href="Module_Names_and_Loading.html#%28def._%28%28quote._~23~25kernel%29._dynamic-require%29%29" class="RktValLink" data-pltdoc="x">dynamic-require</a></span>. In particular,
+using <span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span> on a <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span> form <a href="eval-model.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiates</span></a> a
+module in the namespace&rsquo;s <a href="syntax-model.html#%28tech._base._phase%29" class="techoutside" data-pltdoc="x"><span class="techinside">base phase</span></a>.</p><p>After a namespace is created, module instances from existing
+namespaces can be attached to the new namespace.  In terms of the
+evaluation model, top-level variables from different namespaces
+essentially correspond to definitions with different prefixes, but
+attaching a module uses the same prefix for the module&rsquo;s definitions
+in namespaces where it is attached.  The first step in evaluating any
+compiled expression is to link its top-level variable and module-level
+variable references to specific variables in the namespace.</p><p>At all times during evaluation, some namespace is designated as the
+<a name="(tech._current._namespace)"></a><span style="font-style: italic">current namespace</span>. The current namespace has no particular
+relationship, however, with the namespace that was used to expand the
+code that is executing, or with the namespace that was used to link
+the compiled form of the currently evaluating code. In particular,
+changing the current namespace during evaluation does not change the
+variables to which executing expressions refer. The current namespace
+only determines the behavior of reflective operations to expand code
+and to start evaluating expanded/compiled code.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">orig</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">define in the original namespace</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">The following </span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="RktCmt"> expression is compiled in the original</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">namespace, so direct references to </span><span class="RktSym">x</span><span class="RktCmt"> see </span><span class="RktVal">'</span><span class="RktVal">orig</span><span class="RktCmt">.</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-base-namespace%29%29" class="RktValLink" data-pltdoc="x">make-base-namespace</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">make new namespace</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._current-namespace%29%29" class="RktValLink" data-pltdoc="x">current-namespace</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">define</span><span class="hspace">&nbsp;</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">new</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">evals in the new namespace</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">displays </span><span class="RktVal">'</span><span class="RktVal">orig</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="eval.html#%28def._%28%28quote._~23~25kernel%29._eval%29%29" class="RktValLink" data-pltdoc="x">eval</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">displays </span><span class="RktVal">'</span><span class="RktVal">new</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">orignew</span></p></td></tr></table></blockquote></div></p><p>If an <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> is bound to syntax or to an import, then
+defining the <a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> as a <a href="eval-model.html#%28tech._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">variable</span></a> shadows the syntax
+or import in future uses of the environment. Similarly, if an
+<a href="syntax-model.html#%28tech._identifier%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier</span></a> is bound to a <a href="eval-model.html#%28tech._top._level._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">top-level variable</span></a>, then
+binding the identifier to syntax or an import shadows the variable;
+the variable&rsquo;s value remains unchanged, however, and may be accessible
+through previously evaluated expressions.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">x</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-id-rules%29%29" class="RktStxLink" data-pltdoc="x">syntax-id-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29.__%29%29" class="RktStxLink" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">x</span></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">x</span></td></tr><tr><td><p><span class="RktRes">7</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">7</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._provide%29%29" class="RktStxLink" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">m</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">x</span></td></tr><tr><td><p><span class="RktRes">8</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">7</span></p></td></tr></table></blockquote></div></p><p>Like a top-level <a href="syntax-model.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespace</span></a>, each <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> form has an
+associated <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a> to span all <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase levels</span></a> of the
+module&rsquo;s content, plus a <a href="syntax-model.html#%28tech._scope%29" class="techoutside" data-pltdoc="x"><span class="techinside">scope</span></a> at each <a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a>. The
+latter is added to every form, original or appearing through partial
+macro expansion, within the module&rsquo;s immediate body. Those same scopes
+are propagated to a namespace created by <span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._module-~3enamespace%29%29" class="RktValLink" data-pltdoc="x">module-&gt;namespace</a></span>
+for the module. Meanwhile, parsing of a <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> form begins by
+removing the all scopes that correspond to the enclosing top-level or
+(in the case of <a href="eval-model.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodules</span></a>) <span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span> and
+<span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%2A%29%29" class="RktStxLink" data-pltdoc="x">module*</a></span> forms.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;infernames&quot;">1.2.6<tt>&nbsp;</tt><a name="(part._infernames)"></a>Inferred Value Names</h5><p>To improve error reporting, names are inferred at compile-time for
+certain kinds of values, such as procedures. For example, evaluating
+the following expression:</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>produces an error message because too many arguments are provided to
+the procedure. The error message is able to report <span class="RktSym">f</span> as
+the name of the procedure. In this case, Racket decides, at
+compile-time, to name as <span class="RktVal">'</span><span class="RktVal">f</span> all procedures created by the
+<span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span>-bound <span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span>.</p><p><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span>See <span class="RktSym"><a href="procedures.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._procedure-rename%29%29" class="RktValLink" data-pltdoc="x">procedure-rename</a></span> to override a procedure&rsquo;s
+inferred name at runtime.</p></blockquote></blockquote></blockquote></div><div class="SIntrapara">Names are inferred whenever possible for procedures. Names closer to
+an expression take precedence. For example, in</div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>the procedure bound to <span class="RktSym">my-f</span> will have the inferred name
+<span class="RktVal">'</span><span class="RktVal">f</span>.</p><p>When an <a name="(idx._(gentag._2._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktVal">'</span><span class="RktVal">inferred-name</span> property is attached to a
+syntax object for an expression (see <a href="stxprops.html" data-pltdoc="x">Syntax Object Properties</a>), the
+property value is used for naming the expression, and it overrides any
+name that was inferred from the expression&rsquo;s context. Normally, the
+property value should be a symbol. A <span class="RktVal">'</span><span class="RktVal">inferred-name</span>
+property value of <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a> hides a name that would otherwise be
+inferred from context (perhaps to avoid exposing an identifier from an
+automatically generated binding).</p><p>To support the propagation and merging of consistent properties during
+expansions, the value of the <span class="RktVal">'</span><span class="RktVal">inferred-name</span> property can be a
+tree formed with <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span> where all of the leaves are the same.
+For example, <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">name</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">name</span><span class="RktPn">)</span> is equivalent to
+<span class="RktVal">'</span><span class="RktVal">name</span>, and <span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span> is equivalent to
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</p><p>When an inferred name is not available, but a source location is
+available, a name is constructed using the source location
+information. Inferred and property-assigned names are also available
+to syntax transformers, via <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-name%29%29" class="RktValLink" data-pltdoc="x">syntax-local-name</a></span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;cross-phase persistent-grammar&quot;">1.2.7<tt>&nbsp;</tt><a name="(part._cross-phase._persistent-grammar)"></a>Cross-Phase Persistent Module Declarations</h5><p>A module is <a href="eval-model.html#%28tech._cross._phase._persistent%29" class="techoutside" data-pltdoc="x"><span class="techinside">cross-phase persistent</span></a> only if it fits the following grammar,
+which uses non-terminals from <a href="syntax-model.html#%28part._fully-expanded%29" data-pltdoc="x">Fully Expanded Programs</a>, only if
+it includes <span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._~23~25declare%29%29" class="RktStxLink" data-pltdoc="x">#%declare</a></span><span class="stt"> </span><span class="RktPn">#:cross-phase-persistent</span><span class="RktPn">)</span>, only
+it includes no uses of <span class="RktSym"><a href="Syntax_Quoting__quote-syntax.html#%28form._%28%28quote._~23~25kernel%29._quote-syntax%29%29" class="RktStxLink" data-pltdoc="x">quote-syntax</a></span> or <span class="RktSym"><a href="Locations____variable-reference.html#%28form._%28%28quote._~23~25kernel%29._~23~25variable-reference%29%29" class="RktStxLink" data-pltdoc="x">#%variable-reference</a></span>,
+and only if no module-level binding is <span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span>ed.</p><p><table cellspacing="0" cellpadding="0"><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cross-module</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._module%29%29" class="RktStxLink" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-module-begin%29%29" class="RktStxLink" data-pltdoc="x">#%plain-module-begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">cross-form</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cross-form</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._~23~25declare%29%29" class="RktStxLink" data-pltdoc="x">#%declare</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:cross-phase-persistent</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktVar">cross-form</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25provide%29%29" class="RktStxLink" data-pltdoc="x">#%provide</a></span><span class="hspace">&nbsp;</span><span class="RktVar">raw-provide-spec</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">submodule-form</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">cross-expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28quote._~23~25kernel%29._~23~25require%29%29" class="RktStxLink" data-pltdoc="x">#%require</a></span><span class="hspace">&nbsp;</span><span class="RktVar">raw-require-spec</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cross-expr</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._quote%29%29" class="RktStxLink" data-pltdoc="x">quote</a></span><span class="hspace">&nbsp;</span><span class="RktVar">cross-datum</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-lambda%29%29" class="RktStxLink" data-pltdoc="x">#%plain-lambda</a></span><span class="hspace">&nbsp;</span><span class="RktVar">formals</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktSym">...+</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28quote._~23~25kernel%29._case-lambda%29%29" class="RktStxLink" data-pltdoc="x">case-lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">formals</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktSym">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-app%29%29" class="RktStxLink" data-pltdoc="x">#%plain-app</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVar">cross-expr</span><span class="hspace">&nbsp;</span><span class="RktSym">...+</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-app%29%29" class="RktStxLink" data-pltdoc="x">#%plain-app</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVar">cross-expr</span><span class="hspace">&nbsp;</span><span class="RktSym">...+</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-app%29%29" class="RktStxLink" data-pltdoc="x">#%plain-app</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="creatingmorestructs.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type%29%29" class="RktValLink" data-pltdoc="x">make-struct-type</a></span><span class="hspace">&nbsp;</span><span class="RktVar">cross-expr</span><span class="hspace">&nbsp;</span><span class="RktSym">...+</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-app%29%29" class="RktStxLink" data-pltdoc="x">#%plain-app</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._make-struct-type-property%29%29" class="RktValLink" data-pltdoc="x">make-struct-type-property</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">cross-expr</span><span class="hspace">&nbsp;</span><span class="RktSym">...+</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-app%29%29" class="RktStxLink" data-pltdoc="x">#%plain-app</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._gensym%29%29" class="RktValLink" data-pltdoc="x">gensym</a></span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-app%29%29" class="RktStxLink" data-pltdoc="x">#%plain-app</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._gensym%29%29" class="RktValLink" data-pltdoc="x">gensym</a></span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-app%29%29" class="RktStxLink" data-pltdoc="x">#%plain-app</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._string-~3euninterned-symbol%29%29" class="RktValLink" data-pltdoc="x">string-&gt;uninterned-symbol</a></span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-app%29%29" class="RktStxLink" data-pltdoc="x">#%plain-app</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-from-unsafe~3f%29%29" class="RktValLink" data-pltdoc="x">variable-reference-from-unsafe?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Locations____variable-reference.html#%28form._%28%28quote._~23~25kernel%29._~23~25variable-reference%29%29" class="RktStxLink" data-pltdoc="x">#%variable-reference</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cross-datum</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">number</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">boolean</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">identifier</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">string</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">bytes</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktPn">)</span></td></tr></table></p><p><div class="SIntrapara">This grammar applies after <a href="syntax-model.html#%28tech._expansion%29" class="techoutside" data-pltdoc="x"><span class="techinside">expansion</span></a>, but because a <a href="eval-model.html#%28tech._cross._phase._persistent%29" class="techoutside" data-pltdoc="x"><span class="techinside">cross-phase persistent</span></a>
+module imports only from other cross-phase persistent modules, the only relevant
+expansion steps are the implicit introduction of
+<span class="RktSym"><a href="module.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-module-begin%29%29" class="RktStxLink" data-pltdoc="x">#%plain-module-begin</a></span>, implicit introduction of <span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-app%29%29" class="RktStxLink" data-pltdoc="x">#%plain-app</a></span>,
+and implicit introduction and/or expansion of <span class="RktSym"><a href="quote.html#%28form._%28%28quote._~23~25kernel%29._~23~25datum%29%29" class="RktStxLink" data-pltdoc="x">#%datum</a></span>.
+</div><div class="SIntrapara"><p class="SHistory">Changed in version 7.5.0.12 of package <span class="stt">base</span>: Allow <span class="RktPn">(</span><span class="RktSym"><a href="application.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~23~25plain-app%29%29" class="RktStxLink" data-pltdoc="x">#%plain-app</a></span><span class="stt"> </span><span class="RktSym"><a href="Namespaces.html#%28def._%28%28quote._~23~25kernel%29._variable-reference-from-unsafe~3f%29%29" class="RktValLink" data-pltdoc="x">variable-reference-from-unsafe?</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="Locations____variable-reference.html#%28form._%28%28quote._~23~25kernel%29._~23~25variable-reference%29%29" class="RktStxLink" data-pltdoc="x">#%variable-reference</a></span><span class="RktPn">)</span><span class="RktPn">)</span>.</p></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="eval-model.html" title="backward to &quot;1.1 Evaluation Model&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="model.html" title="up to &quot;1 Language Model&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="reader.html" title="forward to &quot;1.3 The Reader&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/syntax-util.html b/clones/docs.racket-lang.org/reference/syntax-util.html
new file mode 100644
index 00000000..7c12fbac
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/syntax-util.html
@@ -0,0 +1,60 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>12.12&nbsp;Syntax Utilities</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">12.1&nbsp;</td><td><a href="stx-patterns.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Syntax Matching</a></td></tr><tr><td align="right">12.2&nbsp;</td><td><a href="stxops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Content</a></td></tr><tr><td align="right">12.3&nbsp;</td><td><a href="stxcmp.html" class="tocviewlink" data-pltdoc="x">Syntax Object Bindings</a></td></tr><tr><td align="right">12.4&nbsp;</td><td><a href="stxtrans.html" class="tocviewlink" data-pltdoc="x">Syntax Transformers</a></td></tr><tr><td align="right">12.5&nbsp;</td><td><a href="stxparam.html" class="tocviewlink" data-pltdoc="x">Syntax Parameters</a></td></tr><tr><td align="right">12.6&nbsp;</td><td><a href="splicing.html" class="tocviewlink" data-pltdoc="x">Local Binding with Splicing Body</a></td></tr><tr><td align="right">12.7&nbsp;</td><td><a href="stxprops.html" class="tocviewlink" data-pltdoc="x">Syntax Object Properties</a></td></tr><tr><td align="right">12.8&nbsp;</td><td><a href="stxcerts.html" class="tocviewlink" data-pltdoc="x">Syntax Taints</a></td></tr><tr><td align="right">12.9&nbsp;</td><td><a href="Expanding_Top-Level_Forms.html" class="tocviewlink" data-pltdoc="x">Expanding Top-<wbr></wbr>Level Forms</a></td></tr><tr><td align="right">12.10&nbsp;</td><td><a href="Serializing_Syntax.html" class="tocviewlink" data-pltdoc="x">Serializing Syntax</a></td></tr><tr><td align="right">12.11&nbsp;</td><td><a href="include.html" class="tocviewlink" data-pltdoc="x">File Inclusion</a></td></tr><tr><td align="right">12.12&nbsp;</td><td><a href="syntax-util.html" class="tocviewselflink" data-pltdoc="x">Syntax Utilities</a></td></tr><tr><td align="right">12.13&nbsp;</td><td><a href="phase_space.html" class="tocviewlink" data-pltdoc="x">Phase and Space Utilities</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>12.12&nbsp;</td><td><a href="syntax-util.html" class="tocviewselflink" data-pltdoc="x">Syntax Utilities</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">12.12.1&nbsp;</td><td><a href="syntax-util.html#%28part._.Creating_formatted_identifiers%29" class="tocviewlink" data-pltdoc="x">Creating formatted identifiers</a></td></tr><tr><td align="right">12.12.2&nbsp;</td><td><a href="syntax-util.html#%28part._.Pattern_variables%29" class="tocviewlink" data-pltdoc="x">Pattern variables</a></td></tr><tr><td align="right">12.12.3&nbsp;</td><td><a href="syntax-util.html#%28part._.Error_reporting%29" class="tocviewlink" data-pltdoc="x">Error reporting</a></td></tr><tr><td align="right">12.12.4&nbsp;</td><td><a href="syntax-util.html#%28part._.Recording_disappeared_uses%29" class="tocviewlink" data-pltdoc="x">Recording disappeared uses</a></td></tr><tr><td align="right">12.12.5&nbsp;</td><td><a href="syntax-util.html#%28part._.Miscellaneous_utilities%29" class="tocviewlink" data-pltdoc="x">Miscellaneous utilities</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">12.12.1<tt>&nbsp;</tt></span><a href="syntax-util.html#%28part._.Creating_formatted_identifiers%29" class="tocsubseclink" data-pltdoc="x">Creating formatted identifiers</a></td></tr><tr><td><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._format-id%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">format-<wbr></wbr>id</span></span></a></td></tr><tr><td><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._format-symbol%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">format-<wbr></wbr>symbol</span></span></a></td></tr><tr><td><span class="tocsublinknumber">12.12.2<tt>&nbsp;</tt></span><a href="syntax-util.html#%28part._.Pattern_variables%29" class="tocsubseclink" data-pltdoc="x">Pattern variables</a></td></tr><tr><td><a href="syntax-util.html#%28form._%28%28lib._racket%2Fsyntax..rkt%29._define%2Fwith-syntax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define/<span class="mywbr"> &nbsp;</span>with-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><span class="tocsublinknumber">12.12.3<tt>&nbsp;</tt></span><a href="syntax-util.html#%28part._.Error_reporting%29" class="tocsubseclink" data-pltdoc="x">Error reporting</a></td></tr><tr><td><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._current-syntax-context%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>syntax-<wbr></wbr>context</span></span></a></td></tr><tr><td><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._wrong-syntax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">wrong-<wbr></wbr>syntax</span></span></a></td></tr><tr><td><span class="tocsublinknumber">12.12.4<tt>&nbsp;</tt></span><a href="syntax-util.html#%28part._.Recording_disappeared_uses%29" class="tocsubseclink" data-pltdoc="x">Recording disappeared uses</a></td></tr><tr><td><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._current-recorded-disappeared-uses%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>recorded-<wbr></wbr>disappeared-<wbr></wbr>uses</span></span></a></td></tr><tr><td><a href="syntax-util.html#%28form._%28%28lib._racket%2Fsyntax..rkt%29._with-disappeared-uses%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>disappeared-<wbr></wbr>uses</span></span></a></td></tr><tr><td><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._syntax-local-value%2Frecord%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>value/<span class="mywbr"> &nbsp;</span>record</span></span></a></td></tr><tr><td><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._record-disappeared-uses%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">record-<wbr></wbr>disappeared-<wbr></wbr>uses</span></span></a></td></tr><tr><td><span class="tocsublinknumber">12.12.5<tt>&nbsp;</tt></span><a href="syntax-util.html#%28part._.Miscellaneous_utilities%29" class="tocsubseclink" data-pltdoc="x">Miscellaneous utilities</a></td></tr><tr><td><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._generate-temporary%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">generate-<wbr></wbr>temporary</span></span></a></td></tr><tr><td><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._internal-definition-context-apply%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">internal-<wbr></wbr>definition-<wbr></wbr>context-<wbr></wbr>apply</span></span></a></td></tr><tr><td><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._syntax-local-eval%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">syntax-<wbr></wbr>local-<wbr></wbr>eval</span></span></a></td></tr><tr><td><a href="syntax-util.html#%28form._%28%28lib._racket%2Fsyntax..rkt%29._with-syntax%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>syntax*</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="include.html" title="backward to &quot;12.11 File Inclusion&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="phase_space.html" title="forward to &quot;12.13 Phase and Space Utilities&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;syntax-util&quot;">12.12<tt>&nbsp;</tt><a name="(part._syntax-util)"></a><a name="(mod-path._racket/syntax)"></a>Syntax Utilities</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="syntax-util.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/syntax</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="syntax-util.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/syntax</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Creating_formatted_identifiers&quot;">12.12.1<tt>&nbsp;</tt><a name="(part._.Creating_formatted_identifiers)"></a>Creating formatted identifiers</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/syntax..rkt)._format-id))"></a><span title="Provided from: racket/syntax | Package: base"><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._format-id%29%29" class="RktValDef RktValLink" data-pltdoc="x">format-id</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">lctx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">fmt</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktPn">#:source</span><span class="hspace">&nbsp;</span><span class="RktVar">src</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:props</span><span class="hspace">&nbsp;</span><span class="RktVar">props</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:cert</span><span class="hspace">&nbsp;</span><span class="RktVar">ignored</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:subs?</span><span class="hspace">&nbsp;</span><span class="RktVar">subs?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:subs-intro</span><span class="hspace">&nbsp;</span><span class="RktVar">subs-introducer</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lctx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fmt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">props</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ignored</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">subs?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">subs-introducer</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-introduce%29%29" class="RktValLink" data-pltdoc="x">syntax-local-introduce</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span>, but produces an identifier using <span class="RktVar">lctx</span>
+for the lexical context, <span class="RktVar">src</span> for the source location, and
+<span class="RktVar">props</span> for the properties. An argument supplied with
+<span class="RktPn">#:cert</span> is ignored. (See <span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._datum-~3esyntax%29%29" class="RktValLink" data-pltdoc="x">datum-&gt;syntax</a></span>.)</div></p><p>The format string must use only <span class="RktInBG"><span class="hspace"></span><span class="RktIn">~a</span><span class="hspace"></span></span> placeholders. Identifiers
+in the argument list are automatically converted to symbols.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-pred</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">make-pred</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._format-id%29%29" class="RktValLink" data-pltdoc="x">format-id</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktVal">"~a?"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">make-pred</span><span class="hspace">&nbsp;</span><span class="RktSym">pair</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;procedure:pair?&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">make-pred</span><span class="hspace">&nbsp;</span><span class="RktSym">none-such</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">none-such?: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">better-make-pred</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">better-make-pred</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._format-id%29%29" class="RktValLink" data-pltdoc="x">format-id</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktPn">#:source</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">name</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"~a?"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax-e%29%29" class="RktValLink" data-pltdoc="x">syntax-e</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">better-make-pred</span><span class="hspace">&nbsp;</span><span class="RktSym">none-such</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">none-such?: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr></table></blockquote></div></p><p>(Scribble doesn&rsquo;t show it, but the DrRacket pinpoints the location of
+the second error but not of the first.)</p><p>If <span class="RktVar">subs?</span> is <span class="RktVal">#t</span>, then a <span class="RktVal">'</span><span class="RktVal">sub-range-binders</span>
+syntax property is added to the result that records the position of
+each identifier in the <span class="RktVar">v</span>s. The <span class="RktSym">subs-intro</span> procedure
+is applied to each identifier, and its result is included in the
+sub-range binder record. This property value overrides a
+<span class="RktVal">'</span><span class="RktVal">sub-range-binders</span> property copied from <span class="RktVar">props</span>.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="stxprops.html#%28def._%28%28quote._~23~25kernel%29._syntax-property%29%29" class="RktValLink" data-pltdoc="x">syntax-property</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._format-id%29%29" class="RktValLink" data-pltdoc="x">format-id</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">here</span><span class="hspace">&nbsp;</span><span class="RktVal">"~a/~a-~a"</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">point</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktPn">#:subs?</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">sub-range-binders</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">'(#(#&lt;syntax point/2-y&gt; 8 1 0.5 0.5 #&lt;syntax:eval:8:0 y&gt; 0 1 0.5 0.5)</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">#(#&lt;syntax point/2-y&gt; 0 5 0.5 0.5 #&lt;syntax:eval:8:0 point&gt; 0 5 0.5 0.5))</span></p></td></tr></table></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 7.4.0.5 of package <span class="stt">base</span>: Added the <span class="RktPn">#:subs?</span> and
+<span class="RktPn">#:subs-intro</span> arguments.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/syntax..rkt)._format-symbol))"></a><span title="Provided from: racket/syntax | Package: base"><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._format-symbol%29%29" class="RktValDef RktValLink" data-pltdoc="x">format-symbol</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">fmt</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fmt</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="keywords.html#%28def._%28%28quote._~23~25kernel%29._keyword~3f%29%29" class="RktValLink" data-pltdoc="x">keyword?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._format%29%29" class="RktValLink" data-pltdoc="x">format</a></span>, but produces a symbol. The format string must
+use only <span class="RktInBG"><span class="hspace"></span><span class="RktIn">~a</span><span class="hspace"></span></span> placeholders. Identifiers in the argument list
+are automatically converted to symbols.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._format-symbol%29%29" class="RktValLink" data-pltdoc="x">format-symbol</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"make-~a"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">triple</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'make-triple</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Pattern_variables&quot;">12.12.2<tt>&nbsp;</tt><a name="(part._.Pattern_variables)"></a>Pattern variables</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/syntax..rkt)._define/with-syntax))"></a><span title="Provided from: racket/syntax | Package: base"><span class="RktSym"><a href="syntax-util.html#%28form._%28%28lib._racket%2Fsyntax..rkt%29._define%2Fwith-syntax%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define/with-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktVar">stx-expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">stx-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Definition form of <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._with-syntax%29%29" class="RktStxLink" data-pltdoc="x">with-syntax</a></span>. That is, it matches the
+syntax object result of <span class="RktVar">stx-expr</span> against <span class="RktVar">pattern</span> and
+creates pattern variable definitions for the pattern variables of
+<span class="RktVar">pattern</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="syntax-util.html#%28form._%28%28lib._racket%2Fsyntax..rkt%29._define%2Fwith-syntax%29%29" class="RktStxLink" data-pltdoc="x">define/with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">px</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="syntax-util.html#%28form._%28%28lib._racket%2Fsyntax..rkt%29._define%2Fwith-syntax%29%29" class="RktStxLink" data-pltdoc="x">define/with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">tmp</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._generate-temporaries%29%29" class="RktValLink" data-pltdoc="x">generate-temporaries</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">px</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">tmp</span><span class="hspace">&nbsp;</span><span class="RktSym">px</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;syntax:eval:12:0 ((a9 a) (b10 b) (c11 c))&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="syntax-util.html#%28form._%28%28lib._racket%2Fsyntax..rkt%29._define%2Fwith-syntax%29%29" class="RktStxLink" data-pltdoc="x">define/with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">Alice</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">hello</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;syntax:eval:14:0 (hello Alice)&gt;</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Error_reporting&quot;">12.12.3<tt>&nbsp;</tt><a name="(part._.Error_reporting)"></a>Error reporting</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/syntax..rkt)._current-syntax-context))"></a><span title="Provided from: racket/syntax | Package: base"><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._current-syntax-context%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-syntax-context</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._false%2Fc%29%29" class="RktValLink" data-pltdoc="x">false/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/syntax | Package: base"><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._current-syntax-context%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-syntax-context</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._false%2Fc%29%29" class="RktValLink" data-pltdoc="x">false/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">The current contextual syntax object, defaulting to <span class="RktVal">#f</span>.  It
+determines the special form name that prefixes syntax errors created
+by <span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._wrong-syntax%29%29" class="RktValLink" data-pltdoc="x">wrong-syntax</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/syntax..rkt)._wrong-syntax))"></a><span title="Provided from: racket/syntax | Package: base"><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._wrong-syntax%29%29" class="RktValDef RktValLink" data-pltdoc="x">wrong-syntax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span><span class="RktVar">format-string</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">format-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Raises a syntax error using the result of
+<span class="RktPn">(</span><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._current-syntax-context%29%29" class="RktValLink" data-pltdoc="x">current-syntax-context</a></span><span class="RktPn">)</span> as the &ldquo;major&rdquo; syntax object and
+the provided <span class="RktVar">stx</span> as the specific syntax object. (The latter,
+<span class="RktVar">stx</span>, is usually the one highlighted by DrRacket.) The error
+message is constructed using the format string and arguments, and it
+is prefixed with the special form name as described under
+<span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._current-syntax-context%29%29" class="RktValLink" data-pltdoc="x">current-syntax-context</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._wrong-syntax%29%29" class="RktValLink" data-pltdoc="x">wrong-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">here</span><span class="hspace">&nbsp;</span><span class="RktVal">"expected ~s"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">there</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">eval:15:0: ?: expected there</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: here</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._current-syntax-context%29%29" class="RktValLink" data-pltdoc="x">current-syntax-context</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">look</span><span class="hspace">&nbsp;</span><span class="RktSym">over</span><span class="hspace">&nbsp;</span><span class="RktSym">here</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._wrong-syntax%29%29" class="RktValLink" data-pltdoc="x">wrong-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">here</span><span class="hspace">&nbsp;</span><span class="RktVal">"expected ~s"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">there</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">eval:16:0: look: expected there</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: here</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (look over here)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara">A macro using <span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._wrong-syntax%29%29" class="RktValLink" data-pltdoc="x">wrong-syntax</a></span> might set the syntax context at the very
+beginning of its transformation as follows:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">my-macro</span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="parameters.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._parameterize%29%29" class="RktStxLink" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._current-syntax-context%29%29" class="RktValLink" data-pltdoc="x">current-syntax-context</a></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">__</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Then any calls to <span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._wrong-syntax%29%29" class="RktValLink" data-pltdoc="x">wrong-syntax</a></span> during the macro&rsquo;s
+transformation will refer to <span class="RktSym">my-macro</span> (more precisely, the name that
+referred to <span class="RktSym">my-macro</span> where the macro was used, which may be
+different due to renaming, prefixing, etc).</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Recording_disappeared_uses&quot;">12.12.4<tt>&nbsp;</tt><a name="(part._.Recording_disappeared_uses)"></a>Recording disappeared uses</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/syntax..rkt)._current-recorded-disappeared-uses))"></a><span title="Provided from: racket/syntax | Package: base"><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._current-recorded-disappeared-uses%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-recorded-disappeared-uses</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._false%2Fc%29%29" class="RktValLink" data-pltdoc="x">false/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/syntax | Package: base"><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._current-recorded-disappeared-uses%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-recorded-disappeared-uses</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">ids</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ids</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._false%2Fc%29%29" class="RktValLink" data-pltdoc="x">false/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Parameter for tracking disappeared uses. Tracking is &ldquo;enabled&rdquo; when
+the parameter has a non-false value. This is done automatically by
+forms like <span class="RktSym"><a href="syntax-util.html#%28form._%28%28lib._racket%2Fsyntax..rkt%29._with-disappeared-uses%29%29" class="RktStxLink" data-pltdoc="x">with-disappeared-uses</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/syntax..rkt)._with-disappeared-uses))"></a><span title="Provided from: racket/syntax | Package: base"><span class="RktSym"><a href="syntax-util.html#%28form._%28%28lib._racket%2Fsyntax..rkt%29._with-disappeared-uses%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">with-disappeared-uses</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">body-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">stx-expr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">stx-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Evaluates the <span class="RktVar">body-expr</span>s and <span class="RktVar">stx-expr</span>, catching identifiers
+looked up using <span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._syntax-local-value%2Frecord%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value/record</a></span>. Adds the caught identifiers
+to the <span class="RktVal">'</span><span class="RktVal">disappeared-use</span> syntax property of the syntax object produced
+by <span class="RktVar">stx-expr</span>.</div></p><p class="SHistory">Changed in version 6.5.0.7 of package <span class="stt">base</span>: Added the option to include <span class="RktVar">body-expr</span>s.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/syntax..rkt)._syntax-local-value/record))"></a><span title="Provided from: racket/syntax | Package: base"><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._syntax-local-value%2Frecord%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-value/record</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">predicate</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">predicate</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Looks up <span class="RktVar">id</span> in the syntactic environment (as
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-value%29%29" class="RktValLink" data-pltdoc="x">syntax-local-value</a></span>). If the lookup succeeds and returns a
+value satisfying the predicate, the value is returned and <span class="RktVar">id</span>
+is recorded as a disappeared use by calling <span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._record-disappeared-uses%29%29" class="RktValLink" data-pltdoc="x">record-disappeared-uses</a></span>.
+If the lookup fails or if the value
+does not satisfy the predicate, <span class="RktVal">#f</span> is returned and the
+identifier is not recorded as a disappeared use.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/syntax..rkt)._record-disappeared-uses))"></a><span title="Provided from: racket/syntax | Package: base"><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._record-disappeared-uses%29%29" class="RktValDef RktValLink" data-pltdoc="x">record-disappeared-uses</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">intro?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">intro?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-transforming~3f%29%29" class="RktValLink" data-pltdoc="x">syntax-transforming?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Add <span class="RktVar">id</span> to <span class="RktPn">(</span><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._current-recorded-disappeared-uses%29%29" class="RktValLink" data-pltdoc="x">current-recorded-disappeared-uses</a></span><span class="RktPn">)</span>. If
+<span class="RktVar">id</span> is a list, perform the same operation on all the
+identifiers. If <span class="RktVar">intro?</span> is true, then
+<span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._syntax-local-introduce%29%29" class="RktValLink" data-pltdoc="x">syntax-local-introduce</a></span> is first called on the identifiers.</div></p><p>If not used within the extent of a <span class="RktSym"><a href="syntax-util.html#%28form._%28%28lib._racket%2Fsyntax..rkt%29._with-disappeared-uses%29%29" class="RktStxLink" data-pltdoc="x">with-disappeared-uses</a></span>
+form or similar, has no effect.</p><p class="SHistory">Changed in version 6.5.0.7 of package <span class="stt">base</span>: Added the option to pass a single identifier instead of
+requiring a list.<br/>Changed in version 7.2.0.11: Added the <span class="RktVar">intro?</span> argument.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Miscellaneous_utilities&quot;">12.12.5<tt>&nbsp;</tt><a name="(part._.Miscellaneous_utilities)"></a>Miscellaneous utilities</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/syntax..rkt)._generate-temporary))"></a><span title="Provided from: racket/syntax | Package: base"><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._generate-temporary%29%29" class="RktValDef RktValLink" data-pltdoc="x">generate-temporary</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">name-base</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstx..rkt%29._identifier~3f%29%29" class="RktValLink" data-pltdoc="x">identifier?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">name-base</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">g</span></td></tr></table></blockquote></div><div class="SIntrapara">Generates one fresh identifier. Singular form of
+<span class="RktSym"><a href="stxops.html#%28def._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._generate-temporaries%29%29" class="RktValLink" data-pltdoc="x">generate-temporaries</a></span>. If <span class="RktVar">name-base</span> is supplied, it
+is used as the basis for the identifier&rsquo;s name.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/syntax..rkt)._internal-definition-context-apply))"></a><span title="Provided from: racket/syntax | Package: base"><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._internal-definition-context-apply%29%29" class="RktValDef RktValLink" data-pltdoc="x">internal-definition-context-apply</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">intdef-ctx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">stx</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">intdef-ctx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-introduce%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context-introduce</a></span><span class="stt"> </span><span class="RktVar">intdef-ctx</span><span class="stt"> </span><span class="RktVar">stx</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">add</span><span class="RktPn">)</span>. The
+<span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._internal-definition-context-apply%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context-apply</a></span> function is provided for backwards compatibility; the
+ <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context-add-scopes%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context-add-scopes</a></span> function is preferred.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/syntax..rkt)._syntax-local-eval))"></a><span title="Provided from: racket/syntax | Package: base"><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._syntax-local-eval%29%29" class="RktValDef RktValLink" data-pltdoc="x">syntax-local-eval</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">intdef-ctx</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">intdef-ctx</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._listof%29%29" class="RktValLink" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._internal-definition-context~3f%29%29" class="RktValLink" data-pltdoc="x">internal-definition-context?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Evaluates <span class="RktVar">stx</span> as an expression in the current <a href="syntax-model.html#%28tech._transformer._environment%29" class="techoutside" data-pltdoc="x"><span class="techinside">transformer environment</span></a> (that is, at
+<a href="syntax-model.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> 1). If <span class="RktVar">intdef-ctx</span> is not <span class="RktVal">#f</span>, the value provided for
+<span class="RktVar">intdef-ctx</span> is used to enrich <span class="RktVar">stx</span>&#8217;s <a href="syntax-model.html#%28tech._lexical._information%29" class="techoutside" data-pltdoc="x"><span class="techinside">lexical information</span></a> and extend the
+<a href="syntax-model.html#%28tech._local._binding._context%29" class="techoutside" data-pltdoc="x"><span class="techinside">local binding context</span></a> in the same way as the fourth argument to <span class="RktSym"><a href="stxtrans.html#%28def._%28%28quote._~23~25kernel%29._local-expand%29%29" class="RktValLink" data-pltdoc="x">local-expand</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show-me</span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._syntax-case%29%29" class="RktStxLink" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktVar">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">show-me</span><span class="hspace">&nbsp;</span><span class="RktSym">expr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="begin.html#%28form._%28%28quote._~23~25kernel%29._begin%29%29" class="RktStxLink" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"at compile time produces ~s\n"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="syntax-util.html#%28def._%28%28lib._racket%2Fsyntax..rkt%29._syntax-local-eval%29%29" class="RktValLink" data-pltdoc="x">syntax-local-eval</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">expr</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"at run time produces ~s\n"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">expr</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">show-me</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">at compile time produces 7</span></p></td></tr><tr><td><p><span class="RktOut">at run time produces 7</span></p></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define-for-syntax%29%29" class="RktStxLink" data-pltdoc="x">define-for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fruit</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">apple</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fruit</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">pear</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">show-me</span><span class="hspace">&nbsp;</span><span class="RktSym">fruit</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">at compile time produces apple</span></p></td></tr><tr><td><p><span class="RktOut">at run time produces pear</span></p></td></tr></table></td></tr></table></blockquote></div></p><p class="SHistory">Changed in version 6.90.0.27 of package <span class="stt">base</span>: Changed <span class="RktVar">intdef-ctx</span> to accept a list of internal-definition
+contexts in addition to a single internal-definition context or
+<span class="RktVal">#f</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/syntax..rkt)._with-syntax*))"></a><span title="Provided from: racket/syntax | Package: base"><span class="RktSym"><a href="syntax-util.html#%28form._%28%28lib._racket%2Fsyntax..rkt%29._with-syntax%2A%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">with-syntax*</a></span></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktVar">stx-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">stx-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="stxops.html#%28def._%28%28quote._~23~25kernel%29._syntax~3f%29%29" class="RktValLink" data-pltdoc="x">syntax?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._with-syntax%29%29" class="RktStxLink" data-pltdoc="x">with-syntax</a></span>, but the pattern variables of each
+<span class="RktVar">pattern</span> are bound in the <span class="RktVar">stx-expr</span>s of subsequent
+clauses as well as the <span class="RktVar">body</span>s, and the <span class="RktVar">pattern</span>s need
+not bind distinct pattern variables; later bindings shadow earlier
+bindings.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="syntax-util.html#%28form._%28%28lib._racket%2Fsyntax..rkt%29._with-syntax%2A%29%29" class="RktStxLink" data-pltdoc="x">with-syntax*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list%29%29" class="RktValLink" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">val1</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">val2</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">nest</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">nest</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;syntax:eval:22:0 ((val1) (val2))&gt;</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="include.html" title="backward to &quot;12.11 File Inclusion&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="Macros.html" title="up to &quot;12 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="phase_space.html" title="forward to &quot;12.13 Phase and Space Utilities&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/syntax.html b/clones/docs.racket-lang.org/reference/syntax.html
new file mode 100644
index 00000000..689d6578
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/syntax.html
@@ -0,0 +1,22 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3&nbsp;Syntactic Forms</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="notation.html" title="backward to &quot;2 Notation for Documentation&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="module.html" title="forward to &quot;3.1 Modules: module, module*, ...&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;syntax&quot;">3<tt>&nbsp;</tt><a name="(part._syntax)"></a>Syntactic Forms</h3><p>This section describes the core syntax forms that appear in a fully
+expanded expression, plus many closely related non-core forms.
+See <a href="syntax-model.html#%28part._fully-expanded%29" data-pltdoc="x">Fully Expanded Programs</a> for the core grammar.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module.html" class="toclink" data-pltdoc="x">3.1<span class="hspace">&nbsp;</span>Modules: <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="require.html" class="toclink" data-pltdoc="x">3.2<span class="hspace">&nbsp;</span>Importing and Exporting: <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="require.html#%28part._.Additional_require_.Forms%29" class="toclink" data-pltdoc="x">3.2.1<span class="hspace">&nbsp;</span>Additional <span class="RktSym"><span class="RktStxLink">require</span></span> Forms</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="require.html#%28part._.Additional_provide_.Forms%29" class="toclink" data-pltdoc="x">3.2.2<span class="hspace">&nbsp;</span>Additional <span class="RktSym"><span class="RktStxLink">provide</span></span> Forms</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="quote.html" class="toclink" data-pltdoc="x">3.3<span class="hspace">&nbsp;</span>Literals: <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="__expression.html" class="toclink" data-pltdoc="x">3.4<span class="hspace">&nbsp;</span>Expression Wrapper: <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="__top.html" class="toclink" data-pltdoc="x">3.5<span class="hspace">&nbsp;</span>Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Locations____variable-reference.html" class="toclink" data-pltdoc="x">3.6<span class="hspace">&nbsp;</span>Locations: <span class="RktSym"><span class="RktStxLink">#%variable-reference</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="application.html" class="toclink" data-pltdoc="x">3.7<span class="hspace">&nbsp;</span>Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="lambda.html" class="toclink" data-pltdoc="x">3.8<span class="hspace">&nbsp;</span>Procedure Expressions: <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-lambda</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="let.html" class="toclink" data-pltdoc="x">3.9<span class="hspace">&nbsp;</span>Local Binding: <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="local.html" class="toclink" data-pltdoc="x">3.10<span class="hspace">&nbsp;</span>Local Definitions: <span class="RktSym"><span class="RktStxLink">local</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="shared.html" class="toclink" data-pltdoc="x">3.11<span class="hspace">&nbsp;</span>Constructing Graphs: <span class="RktSym"><span class="RktStxLink">shared</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="if.html" class="toclink" data-pltdoc="x">3.12<span class="hspace">&nbsp;</span>Conditionals: <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="case.html" class="toclink" data-pltdoc="x">3.13<span class="hspace">&nbsp;</span>Dispatch: <span class="RktSym"><span class="RktStxLink">case</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define.html" class="toclink" data-pltdoc="x">3.14<span class="hspace">&nbsp;</span>Definitions: <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-syntax</span></span>, ...</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define.html#%28part._require-syntax%29" class="toclink" data-pltdoc="x">3.14.1<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">require</span></span> Macros</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define.html#%28part._provide-syntax%29" class="toclink" data-pltdoc="x">3.14.2<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">provide</span></span> Macros</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="begin.html" class="toclink" data-pltdoc="x">3.15<span class="hspace">&nbsp;</span>Sequencing: <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-for-syntax</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="when_unless.html" class="toclink" data-pltdoc="x">3.16<span class="hspace">&nbsp;</span>Guarded Evaluation: <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="set_.html" class="toclink" data-pltdoc="x">3.17<span class="hspace">&nbsp;</span>Assignment: <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-values</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="for.html" class="toclink" data-pltdoc="x">3.18<span class="hspace">&nbsp;</span>Iterations and Comprehensions: <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/list</span></span>, ...</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="for.html#%28part._.Iteration_and_.Comprehension_.Forms%29" class="toclink" data-pltdoc="x">3.18.1<span class="hspace">&nbsp;</span>Iteration and Comprehension Forms</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="for.html#%28part._.Deriving_.New_.Iteration_.Forms%29" class="toclink" data-pltdoc="x">3.18.2<span class="hspace">&nbsp;</span>Deriving New Iteration Forms</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="for.html#%28part._.Do_.Loops%29" class="toclink" data-pltdoc="x">3.18.3<span class="hspace">&nbsp;</span>Do Loops</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="wcm.html" class="toclink" data-pltdoc="x">3.19<span class="hspace">&nbsp;</span>Continuation Marks: <span class="RktSym"><span class="RktStxLink">with-continuation-mark</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="quasiquote.html" class="toclink" data-pltdoc="x">3.20<span class="hspace">&nbsp;</span>Quasiquoting: <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-splicing</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Syntax_Quoting__quote-syntax.html" class="toclink" data-pltdoc="x">3.21<span class="hspace">&nbsp;</span>Syntax Quoting: <span class="RktSym"><span class="RktStxLink">quote-syntax</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="__top-interaction.html" class="toclink" data-pltdoc="x">3.22<span class="hspace">&nbsp;</span>Interaction Wrapper: <span class="RktSym"><span class="RktStxLink">#%top-interaction</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="block.html" class="toclink" data-pltdoc="x">3.23<span class="hspace">&nbsp;</span>Blocks: <span class="RktSym"><span class="RktStxLink">block</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stratified-body.html" class="toclink" data-pltdoc="x">3.24<span class="hspace">&nbsp;</span>Internal-Definition Limiting: <span class="RktSym"><span class="RktStxLink">#%stratified-body</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="performance-hint.html" class="toclink" data-pltdoc="x">3.25<span class="hspace">&nbsp;</span>Performance Hints: <span class="RktSym"><span class="RktStxLink">begin-encourage-inline</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="lazy-require.html" class="toclink" data-pltdoc="x">3.26<span class="hspace">&nbsp;</span>Importing Modules Lazily: <span class="RktSym"><span class="RktStxLink">lazy-require</span></span></a></p></td></tr></table><p><span class="SSubSubSubSection">Notation</span></p><p>Each syntactic form is described by a BNF-like notation that describes
+a combination of (syntax-wrapped) pairs, symbols, and other data (not
+a sequence of characters). These grammatical specifications are shown
+as in the following specification of a <span class="RktKw">something</span>
+form:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktKw">something</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">thing-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td><span class="hspace">&nbsp;&nbsp;</span></td><td><span class="RktVar">thing-expr</span></td><td><span class="hspace">&nbsp;</span></td><td>:</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span></td></tr></table></td></tr></table></blockquote></blockquote><p>Within such specifications,</p><ul><li><p><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span> indicates zero or more repetitions of the
+preceding datum; more generally, <span style="font-style: italic">N</span> consecutive
+<span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span>s a row indicate a consecutive repetition of the
+preceding <span style="font-style: italic">N</span> datums.</p></li><li><p><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-patterns.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._......%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...+</a></span> indicates one or more repetitions of the
+preceding datum.</p></li><li><p>Italic meta-identifiers play the role of non-terminals. Some
+ meta-identifier names imply syntactic constraints:</p><ul><li><p>A meta-identifier that ends in <span class="RktVar">id</span> stands for an
+identifier.</p></li><li><p>A meta-identifier that ends in <span class="RktVar">keyword</span> stands
+for a keyword.</p></li><li><p>A meta-identifier that ends with <span class="RktVar">expr</span> (such as
+<span class="RktVar">thing-expr</span>) stands for a sub-form that is
+expanded as an expression.</p></li><li><p>A meta-identifier that ends with <span class="RktVar">body</span> stands
+for a sub-form that is expanded in an
+internal-definition context (see
+<a href="syntax-model.html#%28part._intdef-body%29" data-pltdoc="x">Internal Definitions</a>).</p></li></ul></li><li><p>Contracts indicate constraints on sub-expression results. For
+example, <span class="RktVar">thing-expr</span><span class="stt"> </span>:<span class="stt"> </span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span> indicates that
+the expression <span class="RktVar">thing-expr</span> must produce a number.</p></li></ul><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="notation.html" title="backward to &quot;2 Notation for Documentation&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="module.html" title="forward to &quot;3.1 Modules: module, module*, ...&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/tcp.html b/clones/docs.racket-lang.org/reference/tcp.html
new file mode 100644
index 00000000..7567349c
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/tcp.html
@@ -0,0 +1,126 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15.3.1&nbsp;TCP</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewselflink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewlink" data-pltdoc="x">Paths</a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="Filesystem.html" class="tocviewlink" data-pltdoc="x">Filesystem</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="networking.html" class="tocviewselflink" data-pltdoc="x">Networking</a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="subprocess.html" class="tocviewlink" data-pltdoc="x">Processes</a></td></tr><tr><td align="right">15.5&nbsp;</td><td><a href="logging.html" class="tocviewlink" data-pltdoc="x">Logging</a></td></tr><tr><td align="right">15.6&nbsp;</td><td><a href="time.html" class="tocviewlink" data-pltdoc="x">Time</a></td></tr><tr><td align="right">15.7&nbsp;</td><td><a href="envvars.html" class="tocviewlink" data-pltdoc="x">Environment Variables</a></td></tr><tr><td align="right">15.8&nbsp;</td><td><a href="runtime.html" class="tocviewlink" data-pltdoc="x">Environment and Runtime Information</a></td></tr><tr><td align="right">15.9&nbsp;</td><td><a href="Command-Line_Parsing.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Parsing</a></td></tr><tr><td align="right">15.10&nbsp;</td><td><a href="os-lib.html" class="tocviewlink" data-pltdoc="x">Additional Operating System Functions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>15.3&nbsp;</td><td><a href="networking.html" class="tocviewlink" data-pltdoc="x">Networking</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.3.1&nbsp;</td><td><a href="tcp.html" class="tocviewselflink" data-pltdoc="x">TCP</a></td></tr><tr><td align="right">15.3.2&nbsp;</td><td><a href="udp.html" class="tocviewlink" data-pltdoc="x">UDP</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listen%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-<wbr></wbr>listen</span></span></a></td></tr><tr><td><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-connect%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-<wbr></wbr>connect</span></span></a></td></tr><tr><td><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-connect%2Fenable-break%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-<wbr></wbr>connect/<span class="mywbr"> &nbsp;</span>enable-<wbr></wbr>break</span></span></a></td></tr><tr><td><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-<wbr></wbr>accept</span></span></a></td></tr><tr><td><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%2Fenable-break%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-<wbr></wbr>accept/<span class="mywbr"> &nbsp;</span>enable-<wbr></wbr>break</span></span></a></td></tr><tr><td><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept-ready~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-<wbr></wbr>accept-<wbr></wbr>ready?</span></span></a></td></tr><tr><td><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-close%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-<wbr></wbr>close</span></span></a></td></tr><tr><td><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listener~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-<wbr></wbr>listener?</span></span></a></td></tr><tr><td><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-<wbr></wbr>accept-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-abandon-port%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-<wbr></wbr>abandon-<wbr></wbr>port</span></span></a></td></tr><tr><td><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-addresses%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-<wbr></wbr>addresses</span></span></a></td></tr><tr><td><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-port~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">tcp-<wbr></wbr>port?</span></span></a></td></tr><tr><td><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._port-number~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">port-<wbr></wbr>number?</span></span></a></td></tr><tr><td><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._listen-port-number~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">listen-<wbr></wbr>port-<wbr></wbr>number?</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="networking.html" title="backward to &quot;15.3 Networking&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="networking.html" title="up to &quot;15.3 Networking&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="udp.html" title="forward to &quot;15.3.2 UDP&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;tcp&quot;">15.3.1<tt>&nbsp;</tt><a name="(part._tcp)"></a><a name="(mod-path._racket/tcp)"></a>TCP</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="tcp.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/tcp</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="tcp.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/tcp</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p>For information about TCP in general, see <span style="font-style: italic">TCP/IP Illustrated,
+Volume 1</span> by W. Richard Stevens.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/tcp..rkt)._tcp-listen))"></a><span title="Provided from: racket/tcp, racket | Package: base"><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listen%29%29" class="RktValDef RktValLink" data-pltdoc="x">tcp-listen</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">port-no</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">max-allow-wait</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">reuse?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hostname</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listener~3f%29%29" class="RktValLink" data-pltdoc="x">tcp-listener?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port-no</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._listen-port-number~3f%29%29" class="RktValLink" data-pltdoc="x">listen-port-number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">max-allow-wait</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">4</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">reuse?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hostname</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a &ldquo;listening&rdquo; server on the local machine at the port number
+specified by <span class="RktVar">port-no</span>. If <span class="RktVar">port-no</span> is 0 the socket binds
+to an ephemeral port, which can be determined by calling
+<span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-addresses%29%29" class="RktValLink" data-pltdoc="x">tcp-addresses</a></span>.  The <span class="RktVar">max-allow-wait</span> argument
+determines the maximum number of client connections that can be
+waiting for acceptance. (When <span class="RktVar">max-allow-wait</span> clients are
+waiting acceptance, no new client connections can be made.)</div></p><p>If the <span class="RktVar">reuse?</span> argument is true, then <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listen%29%29" class="RktValLink" data-pltdoc="x">tcp-listen</a></span> will
+create a listener even if the port is involved in a <span class="stt">TIME_WAIT</span>
+state. Such a use of <span class="RktVar">reuse?</span> defeats certain guarantees of the
+TCP protocol; see Stevens&rsquo;s book for details. Furthermore, on many
+modern platforms, a true value for <span class="RktVar">reuse?</span> overrides
+<span class="stt">TIME_WAIT</span> only if the listener was previously created with a true
+value for <span class="RktVar">reuse?</span>.</p><p>If <span class="RktVar">hostname</span> is <span class="RktVal">#f</span> (the default), then the listener
+accepts connections to all of the listening machine&rsquo;s addresses.
+Otherwise, the listener accepts connections only at the interface(s)
+associated with the given hostname. For example, providing
+<span class="RktVal">"127.0.0.1"</span> as <span class="RktVar">hostname</span> creates a listener that
+accepts only connections to <span class="RktVal">"127.0.0.1"</span> (the loopback
+interface) from the local machine.</p><p>(Racket implements a listener with multiple sockets, if necessary, to
+accommodate multiple addresses with different protocol families. On
+Linux, if <span class="RktVar">hostname</span> maps to both IPv4 and IPv6 addresses, then
+the behavior depends on whether IPv6 is supported and IPv6 sockets can
+be configured to listen to only IPv6 connections: if IPv6 is not
+supported or IPv6 sockets are not configurable, then the IPv6
+addresses are ignored; otherwise, each IPv6 listener accepts only IPv6
+connections.)</p><p>The return value of <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listen%29%29" class="RktValLink" data-pltdoc="x">tcp-listen</a></span> is a <a name="(tech._tcp._listener)"></a><span style="font-style: italic">TCP
+listener</span>. This value can be used in future calls to
+<span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%29%29" class="RktValLink" data-pltdoc="x">tcp-accept</a></span>, <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept-ready~3f%29%29" class="RktValLink" data-pltdoc="x">tcp-accept-ready?</a></span>, and
+<span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-close%29%29" class="RktValLink" data-pltdoc="x">tcp-close</a></span>.  Each new TCP listener value is placed into the
+management of the current custodian (see <a href="custodians.html" data-pltdoc="x">Custodians</a>).</p><p>If the server cannot be started by <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listen%29%29" class="RktValLink" data-pltdoc="x">tcp-listen</a></span>, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork%29%29" class="RktValLink" data-pltdoc="x">exn:fail:network</a></span> exception is raised.</p><p>A TCP listener can be used as a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> (see <a href="sync.html" data-pltdoc="x">Events</a>).
+A TCP listener is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when
+<span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%29%29" class="RktValLink" data-pltdoc="x">tcp-accept</a></span> would not block; the <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> of a TCP listener is the TCP listener itself.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/tcp..rkt)._tcp-connect))"></a><span title="Provided from: racket/tcp, racket | Package: base"><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-connect%29%29" class="RktValDef RktValLink" data-pltdoc="x">tcp-connect</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hostname</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">port-no</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">local-hostname</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">local-port-no</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hostname</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port-no</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._port-number~3f%29%29" class="RktValLink" data-pltdoc="x">port-number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">local-hostname</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">local-port-no</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._port-number~3f%29%29" class="RktValLink" data-pltdoc="x">port-number?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Attempts to connect as a client to a listening server.  The
+<span class="RktVar">hostname</span> argument is the server host&rsquo;s Internet address name,
+and <span class="RktVar">port-no</span> is the port number where the server is listening.</div></p><p>(If <span class="RktVar">hostname</span> is associated with multiple addresses, they are
+tried one at a time until a connection succeeds. The name
+<span class="RktVal">"localhost"</span> generally specifies the local machine.)</p><p>The optional <span class="RktVar">local-hostname</span> and <span class="RktVar">local-port-no</span>
+specify the client&rsquo;s address and port. If both are <span class="RktVal">#f</span> (the
+default), the client&rsquo;s address and port are selected automatically. If
+<span class="RktVar">local-hostname</span> is not <span class="RktVal">#f</span>, then
+<span class="RktVar">local-port-no</span> must be non-<span class="RktVal">#f</span>. If
+<span class="RktVar">local-port-no</span> is non-<span class="RktVal">#f</span> and <span class="RktVar">local-hostname</span>
+is <span class="RktVal">#f</span>, then the given port is used but the address is
+selected automatically.</p><p>Two values are returned by <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-connect%29%29" class="RktValLink" data-pltdoc="x">tcp-connect</a></span>: an input port and an
+output port. Data can be received from the server through the input
+port and sent to the server through the output port.  If the server is
+a Racket program, it can obtain ports to communicate to the
+client with <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%29%29" class="RktValLink" data-pltdoc="x">tcp-accept</a></span>.  These ports are placed into the
+management of the current custodian (see <a href="custodians.html" data-pltdoc="x">Custodians</a>).</p><p>Initially, the returned input port is block-buffered, and the returned
+output port is block-buffered. Change the buffer mode using
+<span class="RktSym"><a href="port-buffers.html#%28def._%28%28quote._~23~25kernel%29._file-stream-buffer-mode%29%29" class="RktValLink" data-pltdoc="x">file-stream-buffer-mode</a></span>.</p><p>Both of the returned ports must be closed to terminate the TCP
+connection. When both ports are still open, closing the output port
+with <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-output-port%29%29" class="RktValLink" data-pltdoc="x">close-output-port</a></span> sends a TCP close to the server (which
+is seen as an end-of-file if the server reads the connection through a
+port). In contrast, <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-abandon-port%29%29" class="RktValLink" data-pltdoc="x">tcp-abandon-port</a></span> (see below) closes the
+output port, but does not send a TCP close until the input port is
+also closed.</p><p>Note that the TCP protocol does not support a state where one end is
+willing to send but not read, nor does it include an automatic message
+when one end of a connection is fully closed. Instead, the other end
+of a connection discovers that one end is fully closed only as a
+response to sending data; in particular, some number of writes on the
+still-open end may appear to succeed, though writes will eventually
+produce an error.</p><p>If a connection cannot be established by <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-connect%29%29" class="RktValLink" data-pltdoc="x">tcp-connect</a></span>, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork%29%29" class="RktValLink" data-pltdoc="x">exn:fail:network</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/tcp..rkt)._tcp-connect/enable-break))"></a><span title="Provided from: racket/tcp, racket | Package: base"><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-connect%2Fenable-break%29%29" class="RktValDef RktValLink" data-pltdoc="x">tcp-connect/enable-break</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hostname</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">port-no</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">local-hostname</span><span class="RktOpt">]</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">local-port-no</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hostname</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port-no</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._port-number~3f%29%29" class="RktValLink" data-pltdoc="x">port-number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">local-hostname</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">local-port-no</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._port-number~3f%29%29" class="RktValLink" data-pltdoc="x">port-number?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-connect%29%29" class="RktValLink" data-pltdoc="x">tcp-connect</a></span>, but breaking is enabled (see
+<a href="breakhandler.html" data-pltdoc="x">Breaks</a>) while trying to connect. If breaking is
+disabled when <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-connect%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">tcp-connect/enable-break</a></span> is called, then either
+ports are returned or the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak%29%29" class="RktValLink" data-pltdoc="x">exn:break</a></span> exception is raised, but
+not both.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/tcp..rkt)._tcp-accept))"></a><span title="Provided from: racket/tcp, racket | Package: base"><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%29%29" class="RktValDef RktValLink" data-pltdoc="x">tcp-accept</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">listener</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">listener</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listener~3f%29%29" class="RktValLink" data-pltdoc="x">tcp-listener?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Accepts a client connection for the server associated with
+<span class="RktVar">listener</span>. If no client connection is waiting on the
+listening port, the call to <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%29%29" class="RktValLink" data-pltdoc="x">tcp-accept</a></span> will block. (See also
+<span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept-ready~3f%29%29" class="RktValLink" data-pltdoc="x">tcp-accept-ready?</a></span>.)</div></p><p>Two values are returned by <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%29%29" class="RktValLink" data-pltdoc="x">tcp-accept</a></span>: an input port and an
+output port. Data can be received from the client through the input
+port and sent to the client through the output port.  These ports are
+placed into the management of the current custodian (see
+<a href="custodians.html" data-pltdoc="x">Custodians</a>).</p><p>In terms of buffering and connection states, the ports act the same as
+ports from <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-connect%29%29" class="RktValLink" data-pltdoc="x">tcp-connect</a></span>.</p><p>If a connection cannot be accepted by <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%29%29" class="RktValLink" data-pltdoc="x">tcp-accept</a></span>, or if the
+listener has been closed, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork%29%29" class="RktValLink" data-pltdoc="x">exn:fail:network</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/tcp..rkt)._tcp-accept/enable-break))"></a><span title="Provided from: racket/tcp, racket | Package: base"><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%2Fenable-break%29%29" class="RktValDef RktValLink" data-pltdoc="x">tcp-accept/enable-break</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">listener</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._input-port~3f%29%29" class="RktValLink" data-pltdoc="x">input-port?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._output-port~3f%29%29" class="RktValLink" data-pltdoc="x">output-port?</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">listener</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listener~3f%29%29" class="RktValLink" data-pltdoc="x">tcp-listener?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%29%29" class="RktValLink" data-pltdoc="x">tcp-accept</a></span>, but breaking is enabled (see
+<a href="breakhandler.html" data-pltdoc="x">Breaks</a>) while trying to accept a connection. If
+breaking is disabled when <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">tcp-accept/enable-break</a></span> is called,
+then either ports are returned or the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak%29%29" class="RktValLink" data-pltdoc="x">exn:break</a></span> exception is
+raised, but not both.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/tcp..rkt)._tcp-accept-ready~3f))"></a><span title="Provided from: racket/tcp, racket | Package: base"><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept-ready~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">tcp-accept-ready?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">listener</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">listener</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listener~3f%29%29" class="RktValLink" data-pltdoc="x">tcp-listener?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Tests whether an unaccepted client has connected to the server
+associated with <span class="RktVar">listener</span>. If a client is
+waiting, the return value is <span class="RktVal">#t</span>, otherwise it is
+<span class="RktVal">#f</span>. A client is accepted with the <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%29%29" class="RktValLink" data-pltdoc="x">tcp-accept</a></span>
+procedure, which returns ports for communicating with the client and
+removes the client from the list of unaccepted clients.</div></p><p>If the listener has been closed, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork%29%29" class="RktValLink" data-pltdoc="x">exn:fail:network</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/tcp..rkt)._tcp-close))"></a><span title="Provided from: racket/tcp, racket | Package: base"><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-close%29%29" class="RktValDef RktValLink" data-pltdoc="x">tcp-close</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">listener</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">listener</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listener~3f%29%29" class="RktValLink" data-pltdoc="x">tcp-listener?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Shuts down the server associated with <span class="RktVar">listener</span>. All
+unaccepted clients receive an end-of-file from the server; connections
+to accepted clients are unaffected.</div></p><p>If the listener has already been closed, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork%29%29" class="RktValLink" data-pltdoc="x">exn:fail:network</a></span> exception is raised.</p><p>The listener&rsquo;s port number may not become immediately available for
+new listeners (with the default <span class="RktVar">reuse?</span> argument of
+<span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listen%29%29" class="RktValLink" data-pltdoc="x">tcp-listen</a></span>). For further information, see Stevens&rsquo;s
+explanation of the <span class="stt">TIME_WAIT</span> TCP state.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/tcp..rkt)._tcp-listener~3f))"></a><span title="Provided from: racket/tcp, racket | Package: base"><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listener~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">tcp-listener?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="tcp.html#%28tech._tcp._listener%29" class="techoutside" data-pltdoc="x"><span class="techinside">TCP listener</span></a> created by
+<span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listen%29%29" class="RktValLink" data-pltdoc="x">tcp-listen</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/tcp..rkt)._tcp-accept-evt))"></a><span title="Provided from: racket/tcp, racket | Package: base"><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">tcp-accept-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">listener</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">listener</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listener~3f%29%29" class="RktValLink" data-pltdoc="x">tcp-listener?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> (see <a href="sync.html" data-pltdoc="x">Events</a>) that is
+<a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%29%29" class="RktValLink" data-pltdoc="x">tcp-accept</a></span> on <span class="RktVar">listener</span> would
+not block. The <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> is a
+list of two items, which correspond to the two results of
+<span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%29%29" class="RktValLink" data-pltdoc="x">tcp-accept</a></span>. (If the event is not chosen in a <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span>, no connections are
+accepted.) The ports are placed into the management of the custodian
+that is the current custodian (see <a href="custodians.html" data-pltdoc="x">Custodians</a>) at the time that
+<span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept-evt%29%29" class="RktValLink" data-pltdoc="x">tcp-accept-evt</a></span> is called.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/tcp..rkt)._tcp-abandon-port))"></a><span title="Provided from: racket/tcp, racket | Package: base"><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-abandon-port%29%29" class="RktValDef RktValLink" data-pltdoc="x">tcp-abandon-port</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">tcp-port</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">tcp-port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-port~3f%29%29" class="RktValLink" data-pltdoc="x">tcp-port?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-output-port%29%29" class="RktValLink" data-pltdoc="x">close-output-port</a></span> or <span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-input-port%29%29" class="RktValLink" data-pltdoc="x">close-input-port</a></span>
+(depending on whether <span class="RktVar">tcp-port</span> is an input or output port),
+but if <span class="RktVar">tcp-port</span> is an output port and its associated input
+port is not yet closed, then the other end of the TCP connection does
+not receive a TCP close message until the input port is also
+closed.</div></p><p>The TCP protocol does not include a &ldquo;no longer reading&rdquo; state on
+connections, so <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-abandon-port%29%29" class="RktValLink" data-pltdoc="x">tcp-abandon-port</a></span> is equivalent to
+<span class="RktSym"><a href="port-ops.html#%28def._%28%28quote._~23~25kernel%29._close-input-port%29%29" class="RktValLink" data-pltdoc="x">close-input-port</a></span> on input <a href="tcp.html#%28tech._tcp._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">TCP ports</span></a>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/tcp..rkt)._tcp-addresses))"></a><span title="Provided from: racket/tcp, racket | Package: base"><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-addresses%29%29" class="RktValDef RktValLink" data-pltdoc="x">tcp-addresses</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">tcp-port</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">port-numbers?</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._port-number~3f%29%29" class="RktValLink" data-pltdoc="x">port-number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._listen-port-number~3f%29%29" class="RktValLink" data-pltdoc="x">listen-port-number?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">tcp-port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-port~3f%29%29" class="RktValLink" data-pltdoc="x">tcp-port?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-listener~3f%29%29" class="RktValLink" data-pltdoc="x">tcp-listener?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port-numbers?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns two strings when <span class="RktVar">port-numbers?</span> is <span class="RktVal">#f</span> (the
+default). The first string is the Internet address for the local
+machine as viewed by the given <a href="tcp.html#%28tech._tcp._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">TCP port</span></a>&rsquo;s connection, for the
+TCP listener, or the UDP socket. (When a machine serves
+multiple addresses, as it usually does if you count the loopback
+device, the result is connection-specific or
+listener-specific.) If a listener or UDP socket is given and it has no specific
+host, the first string result is <span class="RktVal">"0.0.0.0"</span>. The second string
+is the Internet address for the other end of the connection, or always
+<span class="RktVal">"0.0.0.0"</span> for a listener or unconnected UDP socket.</div></p><p>If <span class="RktVar">port-numbers?</span> is true, then four results are returned: a
+string for the local machine&rsquo;s address, an exact integer between
+<span class="RktVal">1</span> and <span class="RktVal">65535</span> for the local machine&rsquo;s port number, a
+string for the remote machine&rsquo;s address, and an exact integer between
+<span class="RktVal">1</span> and <span class="RktVal">65535</span> for the remote machine&rsquo;s port number or
+<span class="RktVal">0</span> for a listener.</p><p>If the given port, listener, or socket has been closed, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork%29%29" class="RktValLink" data-pltdoc="x">exn:fail:network</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/tcp..rkt)._tcp-port~3f))"></a><span title="Provided from: racket/tcp, racket | Package: base"><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-port~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">tcp-port?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a name="(tech._tcp._port)"></a><span style="font-style: italic">TCP port</span>&#8212;<wbr></wbr>which is a
+port returned by <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%29%29" class="RktValLink" data-pltdoc="x">tcp-accept</a></span>, <span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-connect%29%29" class="RktValLink" data-pltdoc="x">tcp-connect</a></span>,
+<span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-accept%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">tcp-accept/enable-break</a></span>, or
+<span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._tcp-connect%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">tcp-connect/enable-break</a></span>&#8212;<wbr></wbr><span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/tcp..rkt)._port-number~3f))"></a><span title="Provided from: racket/tcp, racket | Package: base"><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._port-number~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">port-number?</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">65535</span><span class="RktPn">)</span>.</div></p><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/tcp..rkt)._listen-port-number~3f))"></a><span title="Provided from: racket/tcp, racket | Package: base"><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._listen-port-number~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">listen-port-number?</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="contract-utilities.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fguts..rkt%29._contract~3f%29%29" class="RktValLink" data-pltdoc="x">contract?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="stt"> </span><span class="RktVal">0</span><span class="stt"> </span><span class="RktVal">65535</span><span class="RktPn">)</span>.</div></p><p class="SHistory">Added in version 6.3 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="networking.html" title="backward to &quot;15.3 Networking&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="networking.html" title="up to &quot;15.3 Networking&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="udp.html" title="forward to &quot;15.3.2 UDP&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/thread-local-storage.html b/clones/docs.racket-lang.org/reference/thread-local-storage.html
new file mode 100644
index 00000000..0852c1f2
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/thread-local-storage.html
@@ -0,0 +1,4 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>11.3&nbsp;Thread-Local Storage</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewselflink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.1&nbsp;</td><td><a href="threads.html" class="tocviewlink" data-pltdoc="x">Threads</a></td></tr><tr><td align="right">11.2&nbsp;</td><td><a href="all-sync.html" class="tocviewlink" data-pltdoc="x">Synchronization</a></td></tr><tr><td align="right">11.3&nbsp;</td><td><a href="thread-local-storage.html" class="tocviewselflink" data-pltdoc="x">Thread-<wbr></wbr>Local Storage</a></td></tr><tr><td align="right">11.4&nbsp;</td><td><a href="futures.html" class="tocviewlink" data-pltdoc="x">Futures</a></td></tr><tr><td align="right">11.5&nbsp;</td><td><a href="places.html" class="tocviewlink" data-pltdoc="x">Places</a></td></tr><tr><td align="right">11.6&nbsp;</td><td><a href="engine.html" class="tocviewlink" data-pltdoc="x">Engines</a></td></tr><tr><td align="right">11.7&nbsp;</td><td><a href="memory-order.html" class="tocviewlink" data-pltdoc="x">Machine Memory Order</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>11.3&nbsp;</td><td><a href="thread-local-storage.html" class="tocviewselflink" data-pltdoc="x">Thread-<wbr></wbr>Local Storage</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.3.1&nbsp;</td><td><a href="threadcells.html" class="tocviewlink" data-pltdoc="x">Thread Cells</a></td></tr><tr><td align="right">11.3.2&nbsp;</td><td><a href="parameters.html" class="tocviewlink" data-pltdoc="x">Parameters</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="async-channel.html" title="backward to &quot;11.2.4 Buffered Asynchronous Channels&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="concurrency.html" title="up to &quot;11 Concurrency and Parallelism&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="threadcells.html" title="forward to &quot;11.3.1 Thread Cells&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;thread-local-storage&quot;">11.3<tt>&nbsp;</tt><a name="(part._thread-local-storage)"></a>Thread-Local Storage</h4><p><a href="eval-model.html#%28tech._thread._cell%29" class="techoutside" data-pltdoc="x"><span class="techinside">Thread cells</span></a> provides primitive support for thread-local
+storage. <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">Parameters</span></a> combine thread cells and continuation marks
+to support thread-specific, continuation-specific binding.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="threadcells.html" class="toclink" data-pltdoc="x">11.3.1<span class="hspace">&nbsp;</span>Thread Cells</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="parameters.html" class="toclink" data-pltdoc="x">11.3.2<span class="hspace">&nbsp;</span>Parameters</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="async-channel.html" title="backward to &quot;11.2.4 Buffered Asynchronous Channels&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="concurrency.html" title="up to &quot;11 Concurrency and Parallelism&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="threadcells.html" title="forward to &quot;11.3.1 Thread Cells&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/threadcells.html b/clones/docs.racket-lang.org/reference/threadcells.html
new file mode 100644
index 00000000..a10c72aa
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/threadcells.html
@@ -0,0 +1,36 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>11.3.1&nbsp;Thread Cells</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewselflink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.1&nbsp;</td><td><a href="threads.html" class="tocviewlink" data-pltdoc="x">Threads</a></td></tr><tr><td align="right">11.2&nbsp;</td><td><a href="all-sync.html" class="tocviewlink" data-pltdoc="x">Synchronization</a></td></tr><tr><td align="right">11.3&nbsp;</td><td><a href="thread-local-storage.html" class="tocviewselflink" data-pltdoc="x">Thread-<wbr></wbr>Local Storage</a></td></tr><tr><td align="right">11.4&nbsp;</td><td><a href="futures.html" class="tocviewlink" data-pltdoc="x">Futures</a></td></tr><tr><td align="right">11.5&nbsp;</td><td><a href="places.html" class="tocviewlink" data-pltdoc="x">Places</a></td></tr><tr><td align="right">11.6&nbsp;</td><td><a href="engine.html" class="tocviewlink" data-pltdoc="x">Engines</a></td></tr><tr><td align="right">11.7&nbsp;</td><td><a href="memory-order.html" class="tocviewlink" data-pltdoc="x">Machine Memory Order</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>11.3&nbsp;</td><td><a href="thread-local-storage.html" class="tocviewlink" data-pltdoc="x">Thread-<wbr></wbr>Local Storage</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.3.1&nbsp;</td><td><a href="threadcells.html" class="tocviewselflink" data-pltdoc="x">Thread Cells</a></td></tr><tr><td align="right">11.3.2&nbsp;</td><td><a href="parameters.html" class="tocviewlink" data-pltdoc="x">Parameters</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-<wbr></wbr>cell?</span></span></a></td></tr><tr><td><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._make-thread-cell%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>thread-<wbr></wbr>cell</span></span></a></td></tr><tr><td><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-ref%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-<wbr></wbr>cell-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-set%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-<wbr></wbr>cell-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._current-preserved-thread-cell-values%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>preserved-<wbr></wbr>thread-<wbr></wbr>cell-<wbr></wbr>values</span></span></a></td></tr><tr><td><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-values~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-<wbr></wbr>cell-<wbr></wbr>values?</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="thread-local-storage.html" title="backward to &quot;11.3 Thread-Local Storage&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="thread-local-storage.html" title="up to &quot;11.3 Thread-Local Storage&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="parameters.html" title="forward to &quot;11.3.2 Parameters&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;threadcells&quot;">11.3.1<tt>&nbsp;</tt><a name="(part._threadcells)"></a>Thread Cells</h5><p>A <span style="font-style: italic"><a href="eval-model.html#%28tech._thread._cell%29" class="techoutside" data-pltdoc="x"><span class="techinside">thread cell</span></a></span> contains a thread-specific value; that
+is, it contains a specific value for each thread, but it may contain
+different values for different threads. A thread cell is created with
+a default value that is used for all existing threads. When the cell&rsquo;s
+content is changed with <span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-set%21%29%29" class="RktValLink" data-pltdoc="x">thread-cell-set!</a></span>, the cell&rsquo;s value
+changes only for the current thread. Similarly,
+<span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-ref%29%29" class="RktValLink" data-pltdoc="x">thread-cell-ref</a></span> obtains the value of the cell that is
+specific to the current thread.</p><p>A thread cell&rsquo;s value can be <span style="font-style: italic"><a href="eval-model.html#%28tech._preserved%29" class="techoutside" data-pltdoc="x"><span class="techinside">preserved</span></a></span>, which means
+that when a new thread is created, the cell&rsquo;s initial value for the
+new thread is the same as the creating thread&rsquo;s current value. If a
+thread cell is non-preserved, then the cell&rsquo;s initial value for a
+newly created thread is the default value (which was supplied when the
+cell was created).</p><p>Within the current thread, the current values of all preserved threads
+cells can be captured through
+<span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._current-preserved-thread-cell-values%29%29" class="RktValLink" data-pltdoc="x">current-preserved-thread-cell-values</a></span>. The captured set of
+values can be imperatively installed into the current thread through
+another call to <span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._current-preserved-thread-cell-values%29%29" class="RktValLink" data-pltdoc="x">current-preserved-thread-cell-values</a></span>. The
+capturing and restoring threads can be different.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._thread-cell~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">thread-cell?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a <a href="eval-model.html#%28tech._thread._cell%29" class="techoutside" data-pltdoc="x"><span class="techinside">thread cell</span></a>,
+<span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-thread-cell))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._make-thread-cell%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-thread-cell</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">preserved?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell~3f%29%29" class="RktValLink" data-pltdoc="x">thread-cell?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">preserved?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates and returns a new thread cell. Initially, <span class="RktVar">v</span> is the
+cell&rsquo;s value for all threads. If <span class="RktVar">preserved?</span> is true, then the
+cell&rsquo;s initial value for a newly created threads is the creating
+thread&rsquo;s value for the cell, otherwise the cell&rsquo;s value is initially
+<span class="RktVar">v</span> in all future threads.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._thread-cell-ref))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">thread-cell-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">cell</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cell</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell~3f%29%29" class="RktValLink" data-pltdoc="x">thread-cell?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the
+current value of <span class="RktVar">cell</span> for the current thread.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._thread-cell-set!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">thread-cell-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">cell</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cell</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell~3f%29%29" class="RktValLink" data-pltdoc="x">thread-cell?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Sets the
+value in <span class="RktVar">cell</span> to <span class="RktVar">v</span> for the current thread.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cnp</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._make-thread-cell%29%29" class="RktValLink" data-pltdoc="x">make-thread-cell</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">nerve</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cp</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._make-thread-cell%29%29" class="RktValLink" data-pltdoc="x">make-thread-cell</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">cancer</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-ref%29%29" class="RktValLink" data-pltdoc="x">thread-cell-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cnp</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(nerve)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-ref%29%29" class="RktValLink" data-pltdoc="x">thread-cell-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cp</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(cancer)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-set%21%29%29" class="RktValLink" data-pltdoc="x">thread-cell-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cnp</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">nerve</span><span class="hspace">&nbsp;</span><span class="RktVal">nerve</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-set%21%29%29" class="RktValLink" data-pltdoc="x">thread-cell-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cp</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">cancer</span><span class="hspace">&nbsp;</span><span class="RktVal">cancer</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-ref%29%29" class="RktValLink" data-pltdoc="x">thread-cell-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cnp</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(nerve nerve)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-ref%29%29" class="RktValLink" data-pltdoc="x">thread-cell-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cp</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(cancer cancer)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28quote._~23~25kernel%29._make-channel%29%29" class="RktValLink" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-ref%29%29" class="RktValLink" data-pltdoc="x">thread-cell-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cnp</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-ref%29%29" class="RktValLink" data-pltdoc="x">thread-cell-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cp</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-get%29%29" class="RktValLink" data-pltdoc="x">channel-get</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-ref%29%29" class="RktValLink" data-pltdoc="x">thread-cell-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cp</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;thread&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-get%29%29" class="RktValLink" data-pltdoc="x">channel-get</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(nerve)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-get%29%29" class="RktValLink" data-pltdoc="x">channel-get</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(cancer cancer)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-set%21%29%29" class="RktValLink" data-pltdoc="x">thread-cell-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cp</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">cancer</span><span class="hspace">&nbsp;</span><span class="RktVal">cancer</span><span class="hspace">&nbsp;</span><span class="RktVal">cancer</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-ref%29%29" class="RktValLink" data-pltdoc="x">thread-cell-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cp</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(cancer cancer cancer)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">ok</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-get%29%29" class="RktValLink" data-pltdoc="x">channel-get</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(cancer cancer)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-preserved-thread-cell-values))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._current-preserved-thread-cell-values%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-preserved-thread-cell-values</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-values~3f%29%29" class="RktValLink" data-pltdoc="x">thread-cell-values?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._current-preserved-thread-cell-values%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-preserved-thread-cell-values</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thread-cell-vals</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thread-cell-vals</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-values~3f%29%29" class="RktValLink" data-pltdoc="x">thread-cell-values?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">When called with no arguments, this procedure produces a
+<span class="RktVar">thread-cell-vals</span> that represents the current values (in the
+current thread) for all preserved thread cells.</div></p><p>When called with a <span class="RktVar">thread-cell-vals</span> generated by a previous
+call to <span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._current-preserved-thread-cell-values%29%29" class="RktValLink" data-pltdoc="x">current-preserved-thread-cell-values</a></span>, the values of
+all preserved thread cells (in the current thread) are set to the
+values captured in <span class="RktVar">thread-cell-vals</span>; if a preserved thread
+cell was created after <span class="RktVar">thread-cell-vals</span> was generated, then
+the thread cell&rsquo;s value for the current thread reverts to its initial
+value.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._thread-cell-values~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._thread-cell-values~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">thread-cell-values?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a set of thread cell values
+produced by <span class="RktSym"><a href="threadcells.html#%28def._%28%28quote._~23~25kernel%29._current-preserved-thread-cell-values%29%29" class="RktValLink" data-pltdoc="x">current-preserved-thread-cell-values</a></span>, <span class="RktVal">#f</span>
+otherwise.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="thread-local-storage.html" title="backward to &quot;11.3 Thread-Local Storage&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="thread-local-storage.html" title="up to &quot;11.3 Thread-Local Storage&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="parameters.html" title="forward to &quot;11.3.2 Parameters&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/threadgroups.html b/clones/docs.racket-lang.org/reference/threadgroups.html
new file mode 100644
index 00000000..4e657cdf
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/threadgroups.html
@@ -0,0 +1,15 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14.8&nbsp;Thread Groups</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewselflink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Namespaces.html" class="tocviewlink" data-pltdoc="x">Namespaces</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="eval.html" class="tocviewlink" data-pltdoc="x">Evaluation and Compilation</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="load-lang.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>load</span></span> Language</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="Module_Names_and_Loading.html" class="tocviewlink" data-pltdoc="x">Module Names and Loading</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="chaperones.html" class="tocviewlink" data-pltdoc="x">Impersonators and Chaperones</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="securityguards.html" class="tocviewlink" data-pltdoc="x">Security Guards</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="custodians.html" class="tocviewlink" data-pltdoc="x">Custodians</a></td></tr><tr><td align="right">14.8&nbsp;</td><td><a href="threadgroups.html" class="tocviewselflink" data-pltdoc="x">Thread Groups</a></td></tr><tr><td align="right">14.9&nbsp;</td><td><a href="inspectors.html" class="tocviewlink" data-pltdoc="x">Structure Inspectors</a></td></tr><tr><td align="right">14.10&nbsp;</td><td><a href="modprotect.html" class="tocviewlink" data-pltdoc="x">Code Inspectors</a></td></tr><tr><td align="right">14.11&nbsp;</td><td><a href="plumbers.html" class="tocviewlink" data-pltdoc="x">Plumbers</a></td></tr><tr><td align="right">14.12&nbsp;</td><td><a href="Sandboxed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Sandboxed Evaluation</a></td></tr><tr><td align="right">14.13&nbsp;</td><td><a href="repl-module.html" class="tocviewlink" data-pltdoc="x">The <span class="RktModLink"><span class="RktSym">racket/<span class="mywbr"> &nbsp;</span>repl</span></span> Library</a></td></tr><tr><td align="right">14.14&nbsp;</td><td><a href="linklets.html" class="tocviewlink" data-pltdoc="x">Linklets and the Core Compiler</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="threadgroups.html#%28def._%28%28quote._~23~25kernel%29._make-thread-group%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>thread-<wbr></wbr>group</span></span></a></td></tr><tr><td><a href="threadgroups.html#%28def._%28%28quote._~23~25kernel%29._thread-group~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-<wbr></wbr>group?</span></span></a></td></tr><tr><td><a href="threadgroups.html#%28def._%28%28quote._~23~25kernel%29._current-thread-group%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>thread-<wbr></wbr>group</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="custodians.html" title="backward to &quot;14.7 Custodians&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="inspectors.html" title="forward to &quot;14.9 Structure Inspectors&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;threadgroups&quot;">14.8<tt>&nbsp;</tt><a name="(part._threadgroups)"></a>Thread Groups</h4><p>A <a name="(tech._thread._group)"></a><span style="font-style: italic">thread group</span> is a collection of threads and other thread
+groups that have equal claim to the CPU. By nesting thread groups and
+by creating certain threads within certain groups, a programmer can
+control the amount of CPU allocated to a set of threads. Every thread
+belongs to a thread group, which is determined by the
+<span class="RktSym"><a href="threadgroups.html#%28def._%28%28quote._~23~25kernel%29._current-thread-group%29%29" class="RktValLink" data-pltdoc="x">current-thread-group</a></span> parameter when the thread is
+created. Thread groups and custodians (see <a href="custodians.html" data-pltdoc="x">Custodians</a>)
+are independent.</p><p>The root thread group receives all of the CPU that the operating
+system gives Racket. Every thread or nested group in a particular
+thread group receives equal allocation of the CPU (a portion of the
+group&rsquo;s access), although a thread may relinquish part of its
+allocation by sleeping or synchronizing with other processes.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-thread-group))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threadgroups.html#%28def._%28%28quote._~23~25kernel%29._make-thread-group%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-thread-group</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">group</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threadgroups.html#%28def._%28%28quote._~23~25kernel%29._thread-group~3f%29%29" class="RktValLink" data-pltdoc="x">thread-group?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">group</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threadgroups.html#%28def._%28%28quote._~23~25kernel%29._thread-group~3f%29%29" class="RktValLink" data-pltdoc="x">thread-group?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="threadgroups.html#%28def._%28%28quote._~23~25kernel%29._current-thread-group%29%29" class="RktValLink" data-pltdoc="x">current-thread-group</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a new thread group that belongs to <span class="RktVar">group</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._thread-group~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threadgroups.html#%28def._%28%28quote._~23~25kernel%29._thread-group~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">thread-group?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a thread group value, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-thread-group))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threadgroups.html#%28def._%28%28quote._~23~25kernel%29._current-thread-group%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-thread-group</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threadgroups.html#%28def._%28%28quote._~23~25kernel%29._thread-group~3f%29%29" class="RktValLink" data-pltdoc="x">thread-group?</a></span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threadgroups.html#%28def._%28%28quote._~23~25kernel%29._current-thread-group%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-thread-group</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">group</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">group</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threadgroups.html#%28def._%28%28quote._~23~25kernel%29._thread-group~3f%29%29" class="RktValLink" data-pltdoc="x">thread-group?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="eval-model.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> that determines the thread group for newly created
+threads.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="custodians.html" title="backward to &quot;14.7 Custodians&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="security.html" title="up to &quot;14 Reflection and Security&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="inspectors.html" title="forward to &quot;14.9 Structure Inspectors&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/threads.html b/clones/docs.racket-lang.org/reference/threads.html
new file mode 100644
index 00000000..92e261fe
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/threads.html
@@ -0,0 +1,137 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>11.1&nbsp;Threads</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewselflink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.1&nbsp;</td><td><a href="threads.html" class="tocviewselflink" data-pltdoc="x">Threads</a></td></tr><tr><td align="right">11.2&nbsp;</td><td><a href="all-sync.html" class="tocviewlink" data-pltdoc="x">Synchronization</a></td></tr><tr><td align="right">11.3&nbsp;</td><td><a href="thread-local-storage.html" class="tocviewlink" data-pltdoc="x">Thread-<wbr></wbr>Local Storage</a></td></tr><tr><td align="right">11.4&nbsp;</td><td><a href="futures.html" class="tocviewlink" data-pltdoc="x">Futures</a></td></tr><tr><td align="right">11.5&nbsp;</td><td><a href="places.html" class="tocviewlink" data-pltdoc="x">Places</a></td></tr><tr><td align="right">11.6&nbsp;</td><td><a href="engine.html" class="tocviewlink" data-pltdoc="x">Engines</a></td></tr><tr><td align="right">11.7&nbsp;</td><td><a href="memory-order.html" class="tocviewlink" data-pltdoc="x">Machine Memory Order</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>11.1&nbsp;</td><td><a href="threads.html" class="tocviewselflink" data-pltdoc="x">Threads</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.1.1&nbsp;</td><td><a href="threads.html#%28part._.Creating_.Threads%29" class="tocviewlink" data-pltdoc="x">Creating Threads</a></td></tr><tr><td align="right">11.1.2&nbsp;</td><td><a href="threads.html#%28part._threadkill%29" class="tocviewlink" data-pltdoc="x">Suspending, Resuming, and Killing Threads</a></td></tr><tr><td align="right">11.1.3&nbsp;</td><td><a href="threads.html#%28part._threadsync%29" class="tocviewlink" data-pltdoc="x">Synchronizing Thread State</a></td></tr><tr><td align="right">11.1.4&nbsp;</td><td><a href="threads.html#%28part._threadmbox%29" class="tocviewlink" data-pltdoc="x">Thread Mailboxes</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">11.1.1<tt>&nbsp;</tt></span><a href="threads.html#%28part._.Creating_.Threads%29" class="tocsubseclink" data-pltdoc="x">Creating Threads</a></td></tr><tr><td><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread</span></span></a></td></tr><tr><td><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread?</span></span></a></td></tr><tr><td><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._current-thread%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>thread</span></span></a></td></tr><tr><td><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%2Fsuspend-to-kill%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread/<span class="mywbr"> &nbsp;</span>suspend-<wbr></wbr>to-<wbr></wbr>kill</span></span></a></td></tr><tr><td><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._call-in-nested-thread%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>in-<wbr></wbr>nested-<wbr></wbr>thread</span></span></a></td></tr><tr><td><span class="tocsublinknumber">11.1.2<tt>&nbsp;</tt></span><a href="threads.html#%28part._threadkill%29" class="tocsubseclink" data-pltdoc="x">Suspending, Resuming, and Killing Threads</a></td></tr><tr><td><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-suspend%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-<wbr></wbr>suspend</span></span></a></td></tr><tr><td><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-resume%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-<wbr></wbr>resume</span></span></a></td></tr><tr><td><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._kill-thread%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">kill-<wbr></wbr>thread</span></span></a></td></tr><tr><td><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._break-thread%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">break-<wbr></wbr>thread</span></span></a></td></tr><tr><td><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._sleep%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">sleep</span></span></a></td></tr><tr><td><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-running~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-<wbr></wbr>running?</span></span></a></td></tr><tr><td><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-dead~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-<wbr></wbr>dead?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">11.1.3<tt>&nbsp;</tt></span><a href="threads.html#%28part._threadsync%29" class="tocsubseclink" data-pltdoc="x">Synchronizing Thread State</a></td></tr><tr><td><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-wait%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-<wbr></wbr>wait</span></span></a></td></tr><tr><td><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-dead-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-<wbr></wbr>dead-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-resume-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-<wbr></wbr>resume-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-suspend-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-<wbr></wbr>suspend-<wbr></wbr>evt</span></span></a></td></tr><tr><td><span class="tocsublinknumber">11.1.4<tt>&nbsp;</tt></span><a href="threads.html#%28part._threadmbox%29" class="tocsubseclink" data-pltdoc="x">Thread Mailboxes</a></td></tr><tr><td><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-send%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-<wbr></wbr>send</span></span></a></td></tr><tr><td><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-receive%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-<wbr></wbr>receive</span></span></a></td></tr><tr><td><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-try-receive%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-<wbr></wbr>try-<wbr></wbr>receive</span></span></a></td></tr><tr><td><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-receive-evt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-<wbr></wbr>receive-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-rewind-receive%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">thread-<wbr></wbr>rewind-<wbr></wbr>receive</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="concurrency.html" title="backward to &quot;11 Concurrency and Parallelism&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="concurrency.html" title="up to &quot;11 Concurrency and Parallelism&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="all-sync.html" title="forward to &quot;11.2 Synchronization&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;threads&quot;">11.1<tt>&nbsp;</tt><a name="(part._threads)"></a>Threads</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=concurrency.html&amp;version=8.6" class="Sq" data-pltdoc="x">Concurrency and Synchronization</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces threads.</p></blockquote></blockquote></blockquote><p>See <a href="eval-model.html#%28part._thread-model%29" data-pltdoc="x">Threads</a> for basic information on the Racket
+thread model. See also <a href="futures.html" data-pltdoc="x">Futures</a> and <a href="places.html" data-pltdoc="x">Places</a>.</p><p>When a thread is created, it is placed into the management of the
+<a href="eval-model.html#%28tech._current._custodian%29" class="techoutside" data-pltdoc="x"><span class="techinside">current custodian</span></a> and added to the current <a href="threadgroups.html#%28tech._thread._group%29" class="techoutside" data-pltdoc="x"><span class="techinside">thread
+group</span></a>. A thread can have any number of custodian managers added
+through <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-resume%29%29" class="RktValLink" data-pltdoc="x">thread-resume</a></span>.</p><p>A thread that has not terminated can be garbage collected (see
+<a href="eval-model.html#%28part._gc-model%29" data-pltdoc="x">Garbage Collection</a>) if it is unreachable and suspended or if it is
+unreachable and blocked on only unreachable events through functions
+such as <span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%29%29" class="RktValLink" data-pltdoc="x">semaphore-wait</a></span>, <span class="RktSym"><a href="semaphore.html#%28def._%28%28quote._~23~25kernel%29._semaphore-wait%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">semaphore-wait/enable-break</a></span>,
+<span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-put%29%29" class="RktValLink" data-pltdoc="x">channel-put</a></span>, <span class="RktSym"><a href="channel.html#%28def._%28%28lib._racket%2Fprivate%2Fmisc..rkt%29._channel-get%29%29" class="RktValLink" data-pltdoc="x">channel-get</a></span>, <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span>,
+<span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">sync/enable-break</a></span>, or <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-wait%29%29" class="RktValLink" data-pltdoc="x">thread-wait</a></span>. Beware, however,
+of a limitation on <a href="places.html#%28tech._place._channel%29" class="techoutside" data-pltdoc="x"><span class="techinside">place-channel</span></a> blocking; see the
+<a href="places.html#%28elem._%28caveat._place-channel-gc%29%29" data-pltdoc="x">caveat</a> in <a href="places.html" data-pltdoc="x">Places</a>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>In GRacket, a handler thread for an eventspace is blocked on
+an internal semaphore when its event queue is empty. Thus, the handler
+thread is collectible when the eventspace is unreachable and contains
+no visible windows or running timers.</p></blockquote></blockquote></blockquote><p>A thread can be used as a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> (see
+<a href="sync.html" data-pltdoc="x">Events</a>).  A thread is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when
+<span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-wait%29%29" class="RktValLink" data-pltdoc="x">thread-wait</a></span> would not block; the <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> of a thread is the thread itself.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Creating_Threads&quot;">11.1.1<tt>&nbsp;</tt><a name="(part._.Creating_.Threads)"></a>Creating Threads</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._thread))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValDef RktValLink" data-pltdoc="x">thread</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thunk</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="RktValLink" data-pltdoc="x">thread?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Calls <span class="RktVar">thunk</span> with no arguments in a new thread of control. The
+<span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span> procedure returns immediately with a <a name="(tech._thread._descriptor)"></a><span style="font-style: italic">thread
+descriptor</span> value. When the invocation of <span class="RktVar">thunk</span> returns, the
+thread created to invoke <span class="RktVar">thunk</span> terminates.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._thread~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">thread?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="RktValLink" data-pltdoc="x">thread?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if
+<span class="RktVar">v</span> is a <a href="threads.html#%28tech._thread._descriptor%29" class="techoutside" data-pltdoc="x"><span class="techinside">thread descriptor</span></a>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-thread))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._current-thread%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-thread</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="RktValLink" data-pltdoc="x">thread?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns the <a href="threads.html#%28tech._thread._descriptor%29" class="techoutside" data-pltdoc="x"><span class="techinside">thread
+descriptor</span></a> for the currently executing thread.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._thread/suspend-to-kill))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%2Fsuspend-to-kill%29%29" class="RktValDef RktValLink" data-pltdoc="x">thread/suspend-to-kill</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thunk</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="RktValLink" data-pltdoc="x">thread?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span>, except that &ldquo;killing&rdquo; the thread through
+<span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._kill-thread%29%29" class="RktValLink" data-pltdoc="x">kill-thread</a></span> or <span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian-shutdown-all%29%29" class="RktValLink" data-pltdoc="x">custodian-shutdown-all</a></span> merely
+suspends the thread instead of terminating it.  </div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._call-in-nested-thread))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._call-in-nested-thread%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-in-nested-thread</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">cust</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thunk</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cust</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian~3f%29%29" class="RktValLink" data-pltdoc="x">custodian?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._current-custodian%29%29" class="RktValLink" data-pltdoc="x">current-custodian</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a nested thread managed by <span class="RktVar">cust</span> to execute
+<span class="RktVar">thunk</span>. (The nested thread&rsquo;s current custodian is inherited
+from the creating thread, independent of the <span class="RktVar">cust</span> argument.)
+The current thread blocks until <span class="RktVar">thunk</span> returns, and the result
+of the <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._call-in-nested-thread%29%29" class="RktValLink" data-pltdoc="x">call-in-nested-thread</a></span> call is the result returned by
+<span class="RktVar">thunk</span>.</div></p><p>The nested thread&rsquo;s exception handler is initialized to a procedure
+that jumps to the beginning of the thread and transfers the exception
+to the original thread. The handler thus terminates the nested thread
+and re-raises the exception in the original thread.</p><p>If the thread created by <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._call-in-nested-thread%29%29" class="RktValLink" data-pltdoc="x">call-in-nested-thread</a></span> dies before
+<span class="RktVar">thunk</span> returns, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span> exception is raised in the original
+thread. If the original thread is killed before <span class="RktVar">thunk</span>
+returns, a break is queued for the nested thread.</p><p>If a break is queued for the original thread (with
+<span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._break-thread%29%29" class="RktValLink" data-pltdoc="x">break-thread</a></span>) while the nested thread is running, the break
+is redirected to the nested thread. If a break is already queued on
+the original thread when the nested thread is created, the break is
+moved to the nested thread. If a break remains queued on the nested
+thread when it completes, the break is moved to the original thread.</p><p>If the thread created by <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._call-in-nested-thread%29%29" class="RktValLink" data-pltdoc="x">call-in-nested-thread</a></span> dies while
+itself in a call to <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._call-in-nested-thread%29%29" class="RktValLink" data-pltdoc="x">call-in-nested-thread</a></span>, the outer call to
+<span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._call-in-nested-thread%29%29" class="RktValLink" data-pltdoc="x">call-in-nested-thread</a></span> waits for the innermost nested thread
+to complete, and any breaks pending on the inner threads are moved to
+the original thread.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;threadkill&quot;">11.1.2<tt>&nbsp;</tt><a name="(part._threadkill)"></a>Suspending, Resuming, and Killing Threads</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._thread-suspend))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-suspend%29%29" class="RktValDef RktValLink" data-pltdoc="x">thread-suspend</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thd</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thd</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="RktValLink" data-pltdoc="x">thread?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Immediately suspends the execution of <span class="RktVar">thd</span> if it is
+running. If the thread has terminated or is already suspended,
+<span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-suspend%29%29" class="RktValLink" data-pltdoc="x">thread-suspend</a></span> has no effect. The thread remains suspended
+(i.e., it does not execute) until it is resumed with
+<span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-resume%29%29" class="RktValLink" data-pltdoc="x">thread-resume</a></span>. If the <a href="eval-model.html#%28tech._current._custodian%29" class="techoutside" data-pltdoc="x"><span class="techinside">current custodian</span></a> does not
+solely manage <span class="RktVar">thd</span> (i.e., some custodian of <span class="RktVar">thd</span>
+is not the current custodian or a subordinate), the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised, and the thread is not suspended.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._thread-resume))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-resume%29%29" class="RktValDef RktValLink" data-pltdoc="x">thread-resume</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thd</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">benefactor</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thd</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="RktValLink" data-pltdoc="x">thread?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">benefactor</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="RktValLink" data-pltdoc="x">thread?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="custodians.html#%28def._%28%28quote._~23~25kernel%29._custodian~3f%29%29" class="RktValLink" data-pltdoc="x">custodian?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Resumes the execution of <span class="RktVar">thd</span> if it is suspended and has at
+least one custodian (possibly added through <span class="RktVar">benefactor</span>, as
+described below). If the thread has terminated, or if the thread is
+already running and <span class="RktVar">benefactor</span> is not supplied, or if the
+thread has no custodian and <span class="RktVar">benefactor</span> is not supplied, then
+<span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-resume%29%29" class="RktValLink" data-pltdoc="x">thread-resume</a></span> has no effect. Otherwise, if
+<span class="RktVar">benefactor</span> is supplied, it triggers up to three
+additional actions:</div></p><ul><li><p>If <span class="RktVar">benefactor</span> is a thread, whenever it is resumed
+from a suspended state in the future, then <span class="RktVar">thd</span> is also
+resumed. (Resuming <span class="RktVar">thd</span> may trigger the resumption of other
+threads that were previously attached to <span class="RktVar">thd</span> through
+<span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-resume%29%29" class="RktValLink" data-pltdoc="x">thread-resume</a></span>.)</p></li><li><p>New custodians may be added to <span class="RktVar">thd</span>&rsquo;s set of
+managers.  If <span class="RktVar">benefactor</span> is a thread, then all of the
+thread&rsquo;s custodians are added to <span class="RktVar">thd</span>. Otherwise,
+<span class="RktVar">benefactor</span> is a custodian, and it is added to <span class="RktVar">thd</span>
+(unless the custodian is already shut down). If <span class="RktVar">thd</span>
+becomes managed by both a custodian and one or more of its
+subordinates, the redundant subordinates are removed from
+<span class="RktVar">thd</span>.  If <span class="RktVar">thd</span> is suspended and a custodian is
+added, then <span class="RktVar">thd</span> is resumed only after the addition.</p></li><li><p>If <span class="RktVar">benefactor</span> is a thread, whenever it receives a
+new managing custodian in the future, then <span class="RktVar">thd</span> also
+receives the custodian. (Adding custodians to <span class="RktVar">thd</span> may
+trigger adding the custodians to other threads that were previously
+attached to <span class="RktVar">thd</span> through <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-resume%29%29" class="RktValLink" data-pltdoc="x">thread-resume</a></span>.)</p></li></ul><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._kill-thread))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._kill-thread%29%29" class="RktValDef RktValLink" data-pltdoc="x">kill-thread</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thd</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thd</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="RktValLink" data-pltdoc="x">thread?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Terminates the specified thread immediately, or suspends the thread if
+<span class="RktVar">thd</span> was created with
+<span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%2Fsuspend-to-kill%29%29" class="RktValLink" data-pltdoc="x">thread/suspend-to-kill</a></span>. Terminating the main thread exits the
+application.  If <span class="RktVar">thd</span> has already terminated,
+<span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._kill-thread%29%29" class="RktValLink" data-pltdoc="x">kill-thread</a></span> does nothing.  If the <a href="eval-model.html#%28tech._current._custodian%29" class="techoutside" data-pltdoc="x"><span class="techinside">current custodian</span></a>
+does not manage <span class="RktVar">thd</span> (and none of its subordinates manages
+<span class="RktVar">thd</span>), the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised, and the thread is not
+killed or suspended.</div></p><p>Unless otherwise noted, procedures provided by Racket (and GRacket) are
+kill-safe and suspend-safe; that is, killing or suspending a thread
+never interferes with the application of procedures in other
+threads. For example, if a thread is killed while extracting a
+character from an input port, the character is either completely
+consumed or not consumed, and other threads can safely use the port.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._break-thread))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._break-thread%29%29" class="RktValDef RktValLink" data-pltdoc="x">break-thread</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thd</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">kind</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thd</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="RktValLink" data-pltdoc="x">thread?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">kind</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">hang-up</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">terminate</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara"><a name="(idx._(gentag._227._(lib._scribblings/reference/reference..scrbl)))"></a>Registers a break with the specified
+thread, where <span class="RktVar">kind</span> optionally indicates the kind of break to
+register. If breaking is disabled in <span class="RktVar">thd</span>, the break will be
+ignored until breaks are re-enabled (see <a href="breakhandler.html" data-pltdoc="x">Breaks</a>).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._sleep))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._sleep%29%29" class="RktValDef RktValLink" data-pltdoc="x">sleep</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">secs</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">secs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e~3d%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr></table></blockquote></div><div class="SIntrapara">Causes the current thread to sleep until at least <span class="RktVar">secs</span>
+seconds have passed after it starts sleeping. A zero value for
+<span class="RktVar">secs</span> simply acts as a hint to allow other threads to
+execute. The value of <span class="RktVar">secs</span> can be a non-integer to request a
+sleep duration to any precision; the precision of the actual sleep
+time is unspecified.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._thread-running~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-running~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">thread-running?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thd</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thd</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="RktValLink" data-pltdoc="x">thread?</a></span></td></tr></table></blockquote></div><div class="SIntrapara"><a name="(idx._(gentag._228._(lib._scribblings/reference/reference..scrbl)))"></a>Returns <span class="RktVal">#t</span> if <span class="RktVar">thd</span>
+has not terminated and is not suspended, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._thread-dead~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-dead~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">thread-dead?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thd</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thd</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="RktValLink" data-pltdoc="x">thread?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">thd</span> has terminated, <span class="RktVal">#f</span>
+otherwise.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;threadsync&quot;">11.1.3<tt>&nbsp;</tt><a name="(part._threadsync)"></a>Synchronizing Thread State</h5><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._thread-wait))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-wait%29%29" class="RktValDef RktValLink" data-pltdoc="x">thread-wait</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thd</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thd</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="RktValLink" data-pltdoc="x">thread?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Blocks execution of the current thread until <span class="RktVar">thd</span> has
+terminated. Note that <span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-wait%29%29" class="RktValLink" data-pltdoc="x">thread-wait</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._current-thread%29%29" class="RktValLink" data-pltdoc="x">current-thread</a></span><span class="RktPn">)</span><span class="RktPn">)</span>
+deadlocks the current thread, but a break can end the deadlock (if
+breaking is enabled; see <a href="breakhandler.html" data-pltdoc="x">Breaks</a>).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._thread-dead-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-dead-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">thread-dead-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thd</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thd</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="RktValLink" data-pltdoc="x">thread?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> (see <a href="sync.html" data-pltdoc="x">Events</a>) that is
+<a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> if and only if <span class="RktVar">thd</span> has terminated.  Unlike using
+<span class="RktVar">thd</span> directly, however, a reference to the event does not
+prevent <span class="RktVar">thd</span> from being garbage collected (see
+<a href="eval-model.html#%28part._gc-model%29" data-pltdoc="x">Garbage Collection</a>). For a given <span class="RktVar">thd</span>,
+<span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-dead-evt%29%29" class="RktValLink" data-pltdoc="x">thread-dead-evt</a></span> always returns the same (i.e., <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>)
+result. The <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> of a thread-dead event is the thread-dead event itself.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._thread-resume-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-resume-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">thread-resume-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thd</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thd</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="RktValLink" data-pltdoc="x">thread?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> (see <a href="sync.html" data-pltdoc="x">Events</a>) that
+becomes <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when <span class="RktVar">thd</span> is running.  (If <span class="RktVar">thd</span> has
+terminated, the event never becomes ready.)  If <span class="RktVar">thd</span> runs and
+is then suspended after a call to <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-resume-evt%29%29" class="RktValLink" data-pltdoc="x">thread-resume-evt</a></span>, the
+result event remains ready; after each suspend of <span class="RktVar">thd</span> a fresh
+event is generated to be returned by <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-resume-evt%29%29" class="RktValLink" data-pltdoc="x">thread-resume-evt</a></span>.  The
+result of the event is <span class="RktVar">thd</span>, but if <span class="RktVar">thd</span> is never
+resumed, then reference to the event does not prevent <span class="RktVar">thd</span>
+from being garbage collected (see <a href="eval-model.html#%28part._gc-model%29" data-pltdoc="x">Garbage Collection</a>).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._thread-suspend-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-suspend-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">thread-suspend-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thd</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thd</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="RktValLink" data-pltdoc="x">thread?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> (see <a href="sync.html" data-pltdoc="x">Events</a>) that
+becomes <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when <span class="RktVar">thd</span> is suspended.  (If <span class="RktVar">thd</span> has
+terminated, the event will never unblock.)  If <span class="RktVar">thd</span> is
+suspended and then resumes after a call to
+<span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-suspend-evt%29%29" class="RktValLink" data-pltdoc="x">thread-suspend-evt</a></span>, the result event remains ready; after
+each resume of <span class="RktVar">thd</span> created a fresh event to be returned by
+<span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-suspend-evt%29%29" class="RktValLink" data-pltdoc="x">thread-suspend-evt</a></span>. The
+result of the event is <span class="RktVar">thd</span>, but if <span class="RktVar">thd</span> is never
+resumed, then reference to the event does not prevent <span class="RktVar">thd</span>
+from being garbage collected (see <a href="eval-model.html#%28part._gc-model%29" data-pltdoc="x">Garbage Collection</a>).</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;threadmbox&quot;">11.1.4<tt>&nbsp;</tt><a name="(part._threadmbox)"></a>Thread Mailboxes</h5><p>Each thread has a <span style="font-style: italic">mailbox</span> through which it can receive
+arbitrary messages.  In other words, each thread has a built-in
+asynchronous channel.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span>See also <a href="async-channel.html" data-pltdoc="x">Buffered Asynchronous Channels</a>.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._thread-send))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-send%29%29" class="RktValDef RktValLink" data-pltdoc="x">thread-send</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">thd</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">fail-thunk</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">thd</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="RktValLink" data-pltdoc="x">thread?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">fail-thunk</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">=</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._raise-mismatch-error%29%29" class="RktValLink" data-pltdoc="x">raise-mismatch-error</a></span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Queues <span class="RktVar">v</span> as a message to <span class="RktVar">thd</span> without blocking. If
+the message is queued, the result is <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>. If <span class="RktVar">thd</span>
+stops running&#8212;<wbr></wbr>as in <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-running~3f%29%29" class="RktValLink" data-pltdoc="x">thread-running?</a></span>&#8212;<wbr></wbr>before the message is
+queued, then <span class="RktVar">fail-thunk</span> is called (through a tail call) if it is
+a procedure to produce the result, or <span class="RktVal">#f</span> is returned if
+<span class="RktVar">fail-thunk</span> is <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._thread-receive))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-receive%29%29" class="RktValDef RktValLink" data-pltdoc="x">thread-receive</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Receives and dequeues a message queued for the current thread, if
+any. If no message is available, <span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-receive%29%29" class="RktValLink" data-pltdoc="x">thread-receive</a></span> blocks until
+one is available.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._thread-try-receive))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-try-receive%29%29" class="RktValDef RktValLink" data-pltdoc="x">thread-try-receive</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Receives and dequeues a message queued for the current thread, if any,
+or returns <span class="RktVal">#f</span> immediately if no message is available.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._thread-receive-evt))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-receive-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">thread-receive-evt</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns a constant <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> (see <a href="sync.html" data-pltdoc="x">Events</a>)
+that becomes <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when the synchronizing thread has a message to
+receive. The <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> of a thread-receive event is the thread-receive event itself.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._thread-rewind-receive))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread-rewind-receive%29%29" class="RktValDef RktValLink" data-pltdoc="x">thread-rewind-receive</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Pushes the elements of <span class="RktVar">lst</span> back onto the front of the current
+thread&rsquo;s queue. The elements are pushed one by one, so that the first
+available message is the last element of <span class="RktVar">lst</span>.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="concurrency.html" title="backward to &quot;11 Concurrency and Parallelism&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="concurrency.html" title="up to &quot;11 Concurrency and Parallelism&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="all-sync.html" title="forward to &quot;11.2 Synchronization&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/time.html b/clones/docs.racket-lang.org/reference/time.html
new file mode 100644
index 00000000..612adec7
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/time.html
@@ -0,0 +1,83 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15.6&nbsp;Time</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewselflink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewlink" data-pltdoc="x">Paths</a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="Filesystem.html" class="tocviewlink" data-pltdoc="x">Filesystem</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="networking.html" class="tocviewlink" data-pltdoc="x">Networking</a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="subprocess.html" class="tocviewlink" data-pltdoc="x">Processes</a></td></tr><tr><td align="right">15.5&nbsp;</td><td><a href="logging.html" class="tocviewlink" data-pltdoc="x">Logging</a></td></tr><tr><td align="right">15.6&nbsp;</td><td><a href="time.html" class="tocviewselflink" data-pltdoc="x">Time</a></td></tr><tr><td align="right">15.7&nbsp;</td><td><a href="envvars.html" class="tocviewlink" data-pltdoc="x">Environment Variables</a></td></tr><tr><td align="right">15.8&nbsp;</td><td><a href="runtime.html" class="tocviewlink" data-pltdoc="x">Environment and Runtime Information</a></td></tr><tr><td align="right">15.9&nbsp;</td><td><a href="Command-Line_Parsing.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Parsing</a></td></tr><tr><td align="right">15.10&nbsp;</td><td><a href="os-lib.html" class="tocviewlink" data-pltdoc="x">Additional Operating System Functions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>15.6&nbsp;</td><td><a href="time.html" class="tocviewselflink" data-pltdoc="x">Time</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.6.1&nbsp;</td><td><a href="time.html#%28part._date-string%29" class="tocviewlink" data-pltdoc="x">Date Utilities</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-seconds%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>seconds</span></span></a></td></tr><tr><td><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-inexact-milliseconds%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>inexact-<wbr></wbr>milliseconds</span></span></a></td></tr><tr><td><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-inexact-monotonic-milliseconds%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>inexact-<wbr></wbr>monotonic-<wbr></wbr>milliseconds</span></span></a></td></tr><tr><td><a href="time.html#%28def._%28%28quote._~23~25kernel%29._seconds-~3edate%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">seconds-<wbr></wbr>&gt;date</span></span></a></td></tr><tr><td><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date</span></span></a></td></tr><tr><td><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date*</span></span></a></td></tr><tr><td><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-milliseconds%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>milliseconds</span></span></a></td></tr><tr><td><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-process-milliseconds%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>process-<wbr></wbr>milliseconds</span></span></a></td></tr><tr><td><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-gc-milliseconds%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>gc-<wbr></wbr>milliseconds</span></span></a></td></tr><tr><td><a href="time.html#%28def._%28%28quote._~23~25kernel%29._time-apply%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">time-<wbr></wbr>apply</span></span></a></td></tr><tr><td><a href="time.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._time%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">time</span></span></a></td></tr><tr><td><span class="tocsublinknumber">15.6.1<tt>&nbsp;</tt></span><a href="time.html#%28part._date-string%29" class="tocsubseclink" data-pltdoc="x">Date Utilities</a></td></tr><tr><td><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._current-date%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">current-<wbr></wbr>date</span></span></a></td></tr><tr><td><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date-~3estring%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date-<wbr></wbr>&gt;string</span></span></a></td></tr><tr><td><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date-display-format%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date-<wbr></wbr>display-<wbr></wbr>format</span></span></a></td></tr><tr><td><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date-~3eseconds%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date-<wbr></wbr>&gt;seconds</span></span></a></td></tr><tr><td><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date%2A-~3eseconds%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date*-<wbr></wbr>&gt;seconds</span></span></a></td></tr><tr><td><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._find-seconds%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">find-<wbr></wbr>seconds</span></span></a></td></tr><tr><td><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date-~3ejulian%2Fscaliger%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date-<wbr></wbr>&gt;julian/<span class="mywbr"> &nbsp;</span>scaliger</span></span></a></td></tr><tr><td><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._julian%2Fscaliger-~3estring%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">julian/<span class="mywbr"> &nbsp;</span>scaliger-<wbr></wbr>&gt;string</span></span></a></td></tr><tr><td><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date-~3ejulian%2Fscalinger%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">date-<wbr></wbr>&gt;julian/<span class="mywbr"> &nbsp;</span>scalinger</span></span></a></td></tr><tr><td><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._julian%2Fscalinger-~3estring%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">julian/<span class="mywbr"> &nbsp;</span>scalinger-<wbr></wbr>&gt;string</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="logging.html" title="backward to &quot;15.5 Logging&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="os.html" title="up to &quot;15 Operating System&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="envvars.html" title="forward to &quot;15.7 Environment Variables&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;time&quot;">15.6<tt>&nbsp;</tt><a name="(part._time)"></a>Time</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-seconds))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-seconds%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-seconds</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns the current time in seconds since <a name="(tech._the._epoch)"></a><span style="font-style: italic">the epoch</span>:
+midnight UTC, January 1, 1970.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-inexact-milliseconds))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-inexact-milliseconds%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-inexact-milliseconds</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns the current time in milliseconds since midnight UTC, January
+1, 1970. The result may contain fractions of a millisecond.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-inexact-milliseconds%29%29" class="RktValLink" data-pltdoc="x">current-inexact-milliseconds</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1289513737015.418</span></p></td></tr></table></blockquote></div></p><p>In this example, <span class="RktVal">1289513737015</span> is in milliseconds and <span class="RktVal">418</span>
+is in microseconds.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-inexact-monotonic-milliseconds))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-inexact-monotonic-milliseconds%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-inexact-monotonic-milliseconds</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns the number of milliseconds since an unspecified starting time.
+Unlike <span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-inexact-milliseconds%29%29" class="RktValLink" data-pltdoc="x">current-inexact-milliseconds</a></span>, which is sensitive to
+the system clock and may therefore retreat or advance more quickly
+than real time if the system clock is adjusted, results from
+<span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-inexact-monotonic-milliseconds%29%29" class="RktValLink" data-pltdoc="x">current-inexact-monotonic-milliseconds</a></span> will always advance
+with real time within a Racket process, but results across processes
+are not comparable.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-inexact-monotonic-milliseconds%29%29" class="RktValLink" data-pltdoc="x">current-inexact-monotonic-milliseconds</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">12772.418</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 8.1.0.4 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._seconds-~3edate))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._seconds-~3edate%29%29" class="RktValDef RktValLink" data-pltdoc="x">seconds-&gt;date</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">secs-n</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">local-time?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date%2A~3f%29%29" class="RktValLink" data-pltdoc="x">date*?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">secs-n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">local-time?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Takes <span class="RktVar">secs-n</span>, a platform-specific time in seconds returned by
+<span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-seconds%29%29" class="RktValLink" data-pltdoc="x">current-seconds</a></span>, <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._file-or-directory-modify-seconds%29%29" class="RktValLink" data-pltdoc="x">file-or-directory-modify-seconds</a></span>,
+or 1/1000th of <span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-inexact-milliseconds%29%29" class="RktValLink" data-pltdoc="x">current-inexact-milliseconds</a></span>, and returns an
+instance of the <span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%2A%29%29" class="RktValLink" data-pltdoc="x">date*</a></span> structure type. Note that
+<span class="RktVar">secs-n</span> can include fractions of a second. If <span class="RktVar">secs-n</span>
+is too small or large, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span> exception is raised.</div></p><p>The resulting <span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%2A%29%29" class="RktValLink" data-pltdoc="x">date*</a></span> reflects the time according to the local
+time zone if <span class="RktVar">local-time?</span> is <span class="RktVal">#t</span>, otherwise it
+reflects a date in UTC.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="nobreak"><a name="(def._((quote._~23~25kernel)._date-time-zone-offset))"></a><a name="(def._((quote._~23~25kernel)._date-dst~3f))"></a><a name="(def._((quote._~23~25kernel)._date-year-day))"></a><a name="(def._((quote._~23~25kernel)._date-week-day))"></a><a name="(def._((quote._~23~25kernel)._date-year))"></a><a name="(def._((quote._~23~25kernel)._date-month))"></a><a name="(def._((quote._~23~25kernel)._date-day))"></a><a name="(def._((quote._~23~25kernel)._date-hour))"></a><a name="(def._((quote._~23~25kernel)._date-minute))"></a><a name="(def._((quote._~23~25kernel)._date-second))"></a><a name="(def._((lib._racket/private/base..rkt)._make-date))"></a><a name="(def._((quote._~23~25kernel)._date~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3adate))"></a><a name="(def._((lib._racket/private/base..rkt)._date))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%29%29" class="RktValDef RktValLink" data-pltdoc="x">date</a></span></span></span></td><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span></td><td><span class="nobreak"><span class="RktSym">second</span></span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym">minute</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym">hour</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym">day</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym">month</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym">year</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym">week-day</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym">year-day</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym">dst?</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym">time-zone-offset</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-date%29%29" class="RktValLink" data-pltdoc="x">make-date</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">second</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">60</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">minute</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">59</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">hour</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">23</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">day</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">31</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">month</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">12</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">year</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">week-day</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">year-day</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">365</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">dst?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">time-zone-offset</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Represents a date. The <span class="RktVar">second</span> field reaches <span class="RktVal">60</span> only
+for leap seconds. The <span class="RktSym">week-day</span> field is <span class="RktVal">0</span> for
+Sunday, <span class="RktVal">1</span> for Monday, etc. The <span class="RktSym">year-day</span> field is
+<span class="RktVal">0</span> for January 1, <span class="RktVal">1</span> for January 2, etc<span class="Sendabbrev">.</span>; the
+<span class="RktSym">year-day</span> field reaches <span class="RktVal">365</span> only in leap years.</div></p><p>The <span class="RktSym">dst?</span> field is <span class="RktVal">#t</span> if the date reflects a
+daylight-saving adjustment. The <span class="RktSym">time-zone-offset</span> field
+reports the number of seconds east of UTC (GMT) for the current time zone
+(e.g., Pacific Standard Time is <span class="RktVal"><span class="nobreak">-2</span>8800</span>), including any
+daylight-saving adjustment (e.g., Pacific Daylight Time is
+<span class="RktVal"><span class="nobreak">-2</span>5200</span>). When a <span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%29%29" class="RktValLink" data-pltdoc="x">date</a></span> record is generated by
+<span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._seconds-~3edate%29%29" class="RktValLink" data-pltdoc="x">seconds-&gt;date</a></span> with <span class="RktVal">#f</span> as the second argument, then
+the <span class="RktSym">dst?</span> and <span class="RktSym">time-zone-offset</span> fields are
+<span class="RktVal">#f</span> and <span class="RktVal">0</span>, respectively.</p><p>The <span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%29%29" class="RktValLink" data-pltdoc="x">date</a></span> constructor accepts any value for <span class="RktSym">dst?</span>
+and converts any non-<span class="RktVal">#f</span> value to <span class="RktVal">#t</span>.</p><p>The value produced for the <span class="RktSym">time-zone-offset</span> field tends to be
+sensitive to the value of the <span class="stt">TZ</span> environment variable,
+especially on Unix platforms; consult the system documentation
+(usually under <span class="stt">tzset</span>) for details.</p><p>See also the <a href="time.html#%28mod-path._racket%2Fdate%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/date</span></a> library.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>struct</p></div></div><table cellspacing="0" cellpadding="0" class="RForeground"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define-struct.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._struct%29%29" class="RktStxLink" data-pltdoc="x">struct</a></span></td><td><span class="hspace">&nbsp;</span></td><td><a name="(def._((quote._~23~25kernel)._date*-time-zone-name))"></a><a name="(def._((quote._~23~25kernel)._date*-nanosecond))"></a><a name="(def._((lib._racket/private/base..rkt)._make-date*))"></a><a name="(def._((quote._~23~25kernel)._date*~3f))"></a><a name="(def._((quote._~23~25kernel)._struct~3adate*))"></a><a name="(def._((lib._racket/private/base..rkt)._date*))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">date*</a></span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%29%29" class="RktValLink" data-pltdoc="x">date</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">nanosecond</span><span class="stt"> </span><span class="RktSym">time-zone-name</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:extra-constructor-name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._make-date%2A%29%29" class="RktValLink" data-pltdoc="x">make-date*</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">nanosecond</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">999999999</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">time-zone-name</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Extends <span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%29%29" class="RktValLink" data-pltdoc="x">date</a></span> with nanoseconds and a time zone name, such as
+<span class="RktVal">"MDT"</span>, <span class="RktVal">"Mountain Daylight Time"</span>, or <span class="RktVal">"UTC"</span>.</div></p><p>When a <span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%2A%29%29" class="RktValLink" data-pltdoc="x">date*</a></span> record is generated by <span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._seconds-~3edate%29%29" class="RktValLink" data-pltdoc="x">seconds-&gt;date</a></span>
+with <span class="RktVal">#f</span> as the second argument, then the
+<span class="RktSym">time-zone-name</span> field is <span class="RktVal">"UTC"</span>.</p><p>The <span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%2A%29%29" class="RktValLink" data-pltdoc="x">date*</a></span> constructor accepts a mutable string for
+<span class="RktSym">time-zone-name</span> and converts it to an immutable one.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-milliseconds))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-milliseconds%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-milliseconds</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-inexact-milliseconds%29%29" class="RktValLink" data-pltdoc="x">current-inexact-milliseconds</a></span>, but coerced to a
+<a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a> (possibly negative). Since the result is a
+<a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a>, the value increases only over a limited (though
+reasonably long) time on a 32-bit platform.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-process-milliseconds))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-process-milliseconds%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-process-milliseconds</a></span></span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">scope</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">scope</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread~3f%29%29" class="RktValLink" data-pltdoc="x">thread?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">subprocesses</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an amount of processor time in <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a> milliseconds that
+has been consumed by on the underlying operating system, including
+both user and system time.</div></p><ul><li><p>If <span class="RktVar">scope</span> is <span class="RktVal">#f</span>, the reported time is for all
+Racket threads and <a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">places</span></a>.</p></li><li><p>If <span class="RktVar">scope</span> is a thread, the result is specific to the
+time while the thread ran, but it may include time for other
+<a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">places</span></a>. The more a thread synchronizes with other
+threads, the less precisely per-thread processor time is
+recorded.</p></li><li><p>If <span class="RktVar">scope</span> is <span class="RktVal">'</span><span class="RktVal">subprocesses</span>, the result is the
+sum of process times for known-completed subprocesses (see
+<a href="subprocess.html" data-pltdoc="x">Processes</a>)&#8212;<wbr></wbr>and known-completed children of the
+subprocesses, etc., on Unix and Mac OS&#8212;<wbr></wbr>across all <a href="places.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">places</span></a>.</p></li></ul><p>The precision of the result is platform-specific, and
+since the result is a <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a>, the value increases only over a
+limited (though reasonably long) time on a 32-bit platform.</p><p class="SHistory">Changed in version 6.1.1.4 of package <span class="stt">base</span>: Added <span class="RktVal">'</span><span class="RktVal">subprocesses</span> mode.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._current-gc-milliseconds))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-gc-milliseconds%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-gc-milliseconds</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns the amount of processor time in <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a> milliseconds
+that has been consumed by Racket&rsquo;s garbage collection so far. This
+time is a portion of the time reported by
+<span class="RktPn">(</span><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-process-milliseconds%29%29" class="RktValLink" data-pltdoc="x">current-process-milliseconds</a></span><span class="RktPn">)</span>, and is similarly limited.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._time-apply))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._time-apply%29%29" class="RktValDef RktValLink" data-pltdoc="x">time-apply</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr><tr><td><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Collects timing information for a procedure application.</div></p><p>Four values are returned: a list containing the result(s) of applying
+<span class="RktVar">proc</span> to the arguments in <span class="RktVar">lst</span>, the number of milliseconds of
+CPU time required to obtain this result, the number of &ldquo;real&rdquo; milliseconds
+required for the result, and the number of milliseconds of CPU time (included
+in the first result) spent on garbage collection.</p><p>The reliability of the timing numbers depends on the platform. If
+multiple Racket threads are running, then the reported time may
+include work performed by other threads.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/more-scheme..rkt)._time))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="time.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._time%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">time</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Reports <span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._time-apply%29%29" class="RktValLink" data-pltdoc="x">time-apply</a></span>-style timing information for the
+evaluation of <span class="RktSym">expr</span> directly to the current output port.  The
+result is the result of  the last <span class="RktVar">body</span>.</div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;date-string&quot;">15.6.1<tt>&nbsp;</tt><a name="(part._date-string)"></a><a name="(mod-path._racket/date)"></a>Date Utilities</h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>For more date &amp; time operations, see
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?tag=%28part._%28.%27%28lib._gregor%2Fscribblings%2Fgregor..scrbl%29.%27._.%27top.%27%29%29&amp;version=8.6" class="Sq" data-pltdoc="x">the Gregor: Date and Time documentation</a>
+or <a href="https://docs.racket-lang.org/srfi/srfi-19.html">srfi/19</a></p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="time.html#%28mod-path._racket%2Fdate%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/date</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="time.html#%28mod-path._racket%2Fdate%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/date</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/date..rkt)._current-date))"></a><span title="Provided from: racket/date | Package: base"><span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._current-date%29%29" class="RktValDef RktValLink" data-pltdoc="x">current-date</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date%2A~3f%29%29" class="RktValLink" data-pltdoc="x">date*?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">An abbreviation for <span class="RktPn">(</span><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._seconds-~3edate%29%29" class="RktValLink" data-pltdoc="x">seconds-&gt;date</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2A%29%29" class="RktValLink" data-pltdoc="x">*</a></span><span class="stt"> </span><span class="RktVal">0.001</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._current-inexact-milliseconds%29%29" class="RktValLink" data-pltdoc="x">current-inexact-milliseconds</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/date..rkt)._date-~3estring))"></a><span title="Provided from: racket/date | Package: base"><span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date-~3estring%29%29" class="RktValDef RktValLink" data-pltdoc="x">date-&gt;string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">date</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">time?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">date</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date~3f%29%29" class="RktValLink" data-pltdoc="x">date?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">time?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Converts a date to a string. The returned string contains the time of
+day only if <span class="RktVar">time?</span>. See also <span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date-display-format%29%29" class="RktValLink" data-pltdoc="x">date-display-format</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>parameter</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/date..rkt)._date-display-format))"></a><span title="Provided from: racket/date | Package: base"><span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date-display-format%29%29" class="RktValDef RktValLink" data-pltdoc="x">date-display-format</a></span></span><span class="RktPn"></span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">american</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">chinese</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">german</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">indian</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">irish</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">iso-8601</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">rfc2822</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">julian</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: racket/date | Package: base"><span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date-display-format%29%29" class="RktValDef RktValLink" data-pltdoc="x">date-display-format</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">format</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">format</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">american</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">chinese</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">german</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">indian</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">irish</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">iso-8601</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">rfc2822</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">julian</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Parameter that determines the date string format. The initial format
+is <span class="RktVal">'</span><span class="RktVal">american</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/date..rkt)._date-~3eseconds))"></a><span title="Provided from: racket/date | Package: base"><span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date-~3eseconds%29%29" class="RktValDef RktValLink" data-pltdoc="x">date-&gt;seconds</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">date</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">local-time?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">date</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date~3f%29%29" class="RktValLink" data-pltdoc="x">date?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">local-time?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Finds the representation of a date in platform-specific seconds.
+If the platform cannot represent the specified date,
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail%29%29" class="RktValLink" data-pltdoc="x">exn:fail</a></span> exception is raised.</div></p><p>The <span class="RktSym">week-day</span>, <span class="RktSym">year-day</span> fields of <span class="RktVar">date</span> are
+ignored.  The <span class="RktSym">dst?</span> and <span class="RktSym">time-zone-offset</span> fields of
+<span class="RktVar">date</span> are also ignored; the date is assumed to be in local
+time by default or in UTC if <span class="RktVar">local-time?</span> is <span class="RktVal">#f</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/date..rkt)._date*-~3eseconds))"></a><span title="Provided from: racket/date | Package: base"><span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date%2A-~3eseconds%29%29" class="RktValDef RktValLink" data-pltdoc="x">date*-&gt;seconds</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">date</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">local-time?</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">date</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date~3f%29%29" class="RktValLink" data-pltdoc="x">date?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">local-time?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date-~3eseconds%29%29" class="RktValLink" data-pltdoc="x">date-&gt;seconds</a></span>, but returns an exact number that can
+include a fraction of a second based on <span class="RktPn">(</span><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date%2A-nanosecond%29%29" class="RktValLink" data-pltdoc="x">date*-nanosecond</a></span><span class="stt"> </span><span class="RktVar">date</span><span class="RktPn">)</span> if <span class="RktVar">date</span> is a <span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%2A%29%29" class="RktValLink" data-pltdoc="x">date*</a></span> instance.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/date..rkt)._find-seconds))"></a><span title="Provided from: racket/date | Package: base"><span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._find-seconds%29%29" class="RktValDef RktValLink" data-pltdoc="x">find-seconds</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">second</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">minute</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hour</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">day</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">month</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">year</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">local-time?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">second</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">61</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">minute</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">59</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hour</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">23</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">day</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">31</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">month</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">12</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">year</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">local-time?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Finds the representation of a date in platform-specific seconds. The
+arguments correspond to the fields of the <span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._date%29%29" class="RktValLink" data-pltdoc="x">date</a></span> structure&#8212;<wbr></wbr>in
+local time by default or UTC if <span class="RktVar">local-time?</span> is
+<span class="RktVal">#f</span>. If the platform cannot represent the specified date, an
+error is signaled, otherwise an integer is returned.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/date..rkt)._date-~3ejulian/scaliger))"></a><span title="Provided from: racket/date | Package: base"><span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date-~3ejulian%2Fscaliger%29%29" class="RktValDef RktValLink" data-pltdoc="x">date-&gt;julian/scaliger</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">date</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">date</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date~3f%29%29" class="RktValLink" data-pltdoc="x">date?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Converts a date structure (up to 2099 BCE Gregorian) into a Julian
+date number. The returned value is not a strict Julian number, but
+rather Scaliger&rsquo;s version, which is off by one for easier
+calculations.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/date..rkt)._julian/scaliger-~3estring))"></a><span title="Provided from: racket/date | Package: base"><span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._julian%2Fscaliger-~3estring%29%29" class="RktValDef RktValLink" data-pltdoc="x">julian/scaliger-&gt;string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">date-number</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">date-number</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Converts a Julian number (Scaliger&rsquo;s off-by-one version) into a
+string.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/date..rkt)._date-~3ejulian/scalinger))"></a><span title="Provided from: racket/date | Package: base"><span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date-~3ejulian%2Fscalinger%29%29" class="RktValDef RktValLink" data-pltdoc="x">date-&gt;julian/scalinger</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">date</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">date</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="time.html#%28def._%28%28quote._~23~25kernel%29._date~3f%29%29" class="RktValLink" data-pltdoc="x">date?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/date..rkt)._julian/scalinger-~3estring))"></a><span title="Provided from: racket/date | Package: base"><span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._julian%2Fscalinger-~3estring%29%29" class="RktValDef RktValLink" data-pltdoc="x">julian/scalinger-&gt;string</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">date-number</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">date-number</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-integer?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._date-~3ejulian%2Fscaliger%29%29" class="RktValLink" data-pltdoc="x">date-&gt;julian/scaliger</a></span> and
+<span class="RktSym"><a href="time.html#%28def._%28%28lib._racket%2Fdate..rkt%29._julian%2Fscaliger-~3estring%29%29" class="RktValLink" data-pltdoc="x">julian/scaliger-&gt;string</a></span>, but misspelled.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="logging.html" title="backward to &quot;15.5 Logging&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="os.html" title="up to &quot;15 Operating System&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="envvars.html" title="forward to &quot;15.7 Environment Variables&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/trait.html b/clones/docs.racket-lang.org/reference/trait.html
new file mode 100644
index 00000000..db8b0e56
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/trait.html
@@ -0,0 +1,76 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6.6&nbsp;Traits</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewselflink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="createinterface.html" class="tocviewlink" data-pltdoc="x">Creating Interfaces</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="createclass.html" class="tocviewlink" data-pltdoc="x">Creating Classes</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="objcreation.html" class="tocviewlink" data-pltdoc="x">Creating Objects</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="ivaraccess.html" class="tocviewlink" data-pltdoc="x">Field and Method Access</a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="mixins.html" class="tocviewlink" data-pltdoc="x">Mixins</a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="trait.html" class="tocviewselflink" data-pltdoc="x">Traits</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="Object_and_Class_Contracts.html" class="tocviewlink" data-pltdoc="x">Object and Class Contracts</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="objectequality.html" class="tocviewlink" data-pltdoc="x">Object Equality and Hashing</a></td></tr><tr><td align="right">6.9&nbsp;</td><td><a href="objectserialize.html" class="tocviewlink" data-pltdoc="x">Object Serialization</a></td></tr><tr><td align="right">6.10&nbsp;</td><td><a href="objectprinting.html" class="tocviewlink" data-pltdoc="x">Object Printing</a></td></tr><tr><td align="right">6.11&nbsp;</td><td><a href="objectutils.html" class="tocviewlink" data-pltdoc="x">Object, Class, and Interface Utilities</a></td></tr><tr><td align="right">6.12&nbsp;</td><td><a href="Surrogates.html" class="tocviewlink" data-pltdoc="x">Surrogates</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="trait.html#%28form._%28%28lib._racket%2Ftrait..rkt%29._trait%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym">trait</span></a></td></tr><tr><td><a href="trait.html#%28def._%28%28lib._racket%2Ftrait..rkt%29._trait~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym">trait?</span></a></td></tr><tr><td><a href="trait.html#%28def._%28%28lib._racket%2Ftrait..rkt%29._trait-~3emixin%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym">trait-<wbr></wbr>&gt;mixin</span></a></td></tr><tr><td><a href="trait.html#%28def._%28%28lib._racket%2Ftrait..rkt%29._trait-sum%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym">trait-<wbr></wbr>sum</span></a></td></tr><tr><td><a href="trait.html#%28form._%28%28lib._racket%2Ftrait..rkt%29._trait-exclude%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym">trait-<wbr></wbr>exclude</span></a></td></tr><tr><td><a href="trait.html#%28form._%28%28lib._racket%2Ftrait..rkt%29._trait-exclude-field%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym">trait-<wbr></wbr>exclude-<wbr></wbr>field</span></a></td></tr><tr><td><a href="trait.html#%28form._%28%28lib._racket%2Ftrait..rkt%29._trait-alias%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym">trait-<wbr></wbr>alias</span></a></td></tr><tr><td><a href="trait.html#%28form._%28%28lib._racket%2Ftrait..rkt%29._trait-rename%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym">trait-<wbr></wbr>rename</span></a></td></tr><tr><td><a href="trait.html#%28form._%28%28lib._racket%2Ftrait..rkt%29._trait-rename-field%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym">trait-<wbr></wbr>rename-<wbr></wbr>field</span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="mixins.html" title="backward to &quot;6.5 Mixins&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Object_and_Class_Contracts.html" title="forward to &quot;6.7 Object and Class Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;trait&quot;">6.6<tt>&nbsp;</tt><a name="(part._trait)"></a><a name="(mod-path._racket/trait)"></a>Traits</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="trait.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/trait</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="trait.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/trait</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p>A <a name="(tech._trait)"></a><span style="font-style: italic">trait</span> is a collection of methods that can be converted to
+a <a href="mixins.html#%28tech._mixin%29" class="techoutside" data-pltdoc="x"><span class="techinside">mixin</span></a> and then applied to a <a href="mzlib_class.html#%28tech._clas%29" class="techoutside" data-pltdoc="x"><span class="techinside">class</span></a>. Before a trait is
+converted to a mixin, the methods of a trait can be individually
+renamed, and multiple traits can be merged to form a new trait.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/trait..rkt)._trait))"></a><span title="Provided from: racket/trait | Package: base"><span class="RktSym"><span class="RktSymDef RktSym">trait</span></span></span><span class="hspace">&nbsp;</span><span class="RktVar">trait-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">trait-clause</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%29%29" class="RktStxLink" data-pltdoc="x">public</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._pubment%29%29" class="RktStxLink" data-pltdoc="x">pubment</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public-final%29%29" class="RktStxLink" data-pltdoc="x">public-final</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="RktStxLink" data-pltdoc="x">overment</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%29%29" class="RktStxLink" data-pltdoc="x">override-final</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%29%29" class="RktStxLink" data-pltdoc="x">augride</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment-final%29%29" class="RktStxLink" data-pltdoc="x">augment-final</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Fsuper%29%29" class="RktStxLink" data-pltdoc="x">inherit/super</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Finner%29%29" class="RktStxLink" data-pltdoc="x">inherit/inner</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">method-definition</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktVar">field-declaration</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit-field%29%29" class="RktStxLink" data-pltdoc="x">inherit-field</a></span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Creates a <a href="trait.html#%28tech._trait%29" class="techoutside" data-pltdoc="x"><span class="techinside">trait</span></a>.  The body of a <span class="RktSym">trait</span> form is similar to the
+body of a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span> form, but restricted to non-private method
+definitions.  In particular, the grammar of
+<span class="RktVar">maybe-renamed</span>, <span class="RktVar">method-definition</span>, and
+<span class="RktVar">field-declaration</span> are the same as for <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%2A%29%29" class="RktStxLink" data-pltdoc="x">class*</a></span>, and
+every <span class="RktVar">method-definition</span> must have a corresponding declaration
+(one of <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%29%29" class="RktStxLink" data-pltdoc="x">public</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span>, etc.).  As in
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span>, uses of method names in direct calls, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super%29%29" class="RktStxLink" data-pltdoc="x">super</a></span>
+calls, and <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inner%29%29" class="RktStxLink" data-pltdoc="x">inner</a></span> calls depend on bringing method names into
+scope via <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Fsuper%29%29" class="RktStxLink" data-pltdoc="x">inherit/super</a></span>,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Finner%29%29" class="RktStxLink" data-pltdoc="x">inherit/inner</a></span>, and other method declarations in the same
+trait; an exception, compared to <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span> is that
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="RktStxLink" data-pltdoc="x">overment</a></span> binds a method name only in the corresponding
+method, and not in other methods of the same trait. Finally, macros
+such as <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%2A%29%29" class="RktStxLink" data-pltdoc="x">public*</a></span> and <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span> work in
+<span class="RktSym">trait</span> as in <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span>.</div></p><p>External identifiers in <span class="RktSym">trait</span>, <span class="RktSym">trait-exclude</span>,
+<span class="RktSym">trait-exclude-field</span>, <span class="RktSym">trait-alias</span>,
+<span class="RktSym">trait-rename</span>, and <span class="RktSym">trait-rename-field</span> forms are
+subject to binding via <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-member-name%29%29" class="RktStxLink" data-pltdoc="x">define-member-name</a></span> and
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define-local-member-name%29%29" class="RktStxLink" data-pltdoc="x">define-local-member-name</a></span>. Although <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._private%29%29" class="RktStxLink" data-pltdoc="x">private</a></span> methods
+or fields are not allowed in a <span class="RktSym">trait</span> form, they can be
+simulated by using a <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%29%29" class="RktStxLink" data-pltdoc="x">public</a></span> or <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._field%29%29" class="RktStxLink" data-pltdoc="x">field</a></span> declaration and
+a name whose scope is limited to the <span class="RktSym">trait</span> form.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/trait..rkt)._trait~3f))"></a><span title="Provided from: racket/trait | Package: base"><span class="RktSym"><span class="RktSymDef RktSym">trait?</span></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a trait, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/trait..rkt)._trait-~3emixin))"></a><span title="Provided from: racket/trait | Package: base"><span class="RktSym"><span class="RktSymDef RktSym">trait-&gt;mixin</span></span></span><span class="hspace">&nbsp;</span><span class="RktVar">tr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="objectutils.html#%28def._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class~3f%29%29" class="RktValLink" data-pltdoc="x">class?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">tr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym">trait?</span></td></tr></table></blockquote></div><div class="SIntrapara">Converts a <a href="trait.html#%28tech._trait%29" class="techoutside" data-pltdoc="x"><span class="techinside">trait</span></a> to a <a href="mixins.html#%28tech._mixin%29" class="techoutside" data-pltdoc="x"><span class="techinside">mixin</span></a>, which can be applied to a
+<a href="mzlib_class.html#%28tech._clas%29" class="techoutside" data-pltdoc="x"><span class="techinside">class</span></a> to produce a new <a href="mzlib_class.html#%28tech._clas%29" class="techoutside" data-pltdoc="x"><span class="techinside">class</span></a>. An expression of the form</div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym">trait-&gt;mixin</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">trait</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVar">trait-clause</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>is equivalent to</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">%</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._class%29%29" class="RktStxLink" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">trait-clause</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="objcreation.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._super-new%29%29" class="RktStxLink" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Normally, however, a trait&rsquo;s methods are changed and combined with
+other traits before converting to a mixin.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/trait..rkt)._trait-sum))"></a><span title="Provided from: racket/trait | Package: base"><span class="RktSym"><span class="RktSymDef RktSym">trait-sum</span></span></span><span class="hspace">&nbsp;</span><span class="RktVar">tr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym">trait?</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">tr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym">trait?</span></td></tr></table></blockquote></div><div class="SIntrapara">Produces a <a href="trait.html#%28tech._trait%29" class="techoutside" data-pltdoc="x"><span class="techinside">trait</span></a> that combines all of the methods of the given
+<span class="RktVar">tr</span>s. For example,</div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">t1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">trait</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">t2</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">trait</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">t3</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">trait-sum</span><span class="hspace">&nbsp;</span><span class="RktSym">t1</span><span class="hspace">&nbsp;</span><span class="RktSym">t2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>creates a trait <span class="RktSym">t3</span> that is equivalent to</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym">trait</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._define%2Fpublic%29%29" class="RktStxLink" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>but <span class="RktSym">t1</span> and <span class="RktSym">t2</span> can still be used individually or
+combined with other traits.</p><p>When traits are combined with <span class="RktSym">trait-sum</span>, the combination
+drops <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Fsuper%29%29" class="RktStxLink" data-pltdoc="x">inherit/super</a></span>,
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Finner%29%29" class="RktStxLink" data-pltdoc="x">inherit/inner</a></span>, and <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit-field%29%29" class="RktStxLink" data-pltdoc="x">inherit-field</a></span> declarations when a
+definition is supplied for the same method or field name by another
+trait. The <span class="RktSym">trait-sum</span> operation fails (the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised) if any of the traits to combine define a
+method or field with the same name, or if an <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Fsuper%29%29" class="RktStxLink" data-pltdoc="x">inherit/super</a></span> or
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Finner%29%29" class="RktStxLink" data-pltdoc="x">inherit/inner</a></span> declaration to be dropped is inconsistent with
+the supplied definition. In other words, declaring a method with
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Fsuper%29%29" class="RktStxLink" data-pltdoc="x">inherit/super</a></span>, or <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Finner%29%29" class="RktStxLink" data-pltdoc="x">inherit/inner</a></span>,
+does not count as defining the method; at the same time, for example,
+a trait that contains an <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Fsuper%29%29" class="RktStxLink" data-pltdoc="x">inherit/super</a></span> declaration for a
+method <span class="RktSym">m</span> cannot be combined with a trait that defines
+<span class="RktSym">m</span> as <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span>, since no class could satisfy the
+requirements of both <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span> and <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Fsuper%29%29" class="RktStxLink" data-pltdoc="x">inherit/super</a></span> when
+the trait is later converted to a mixin and applied to a class.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/trait..rkt)._trait-exclude))"></a><span title="Provided from: racket/trait | Package: base"><span class="RktSym"><span class="RktSymDef RktSym">trait-exclude</span></span></span><span class="hspace">&nbsp;</span><span class="RktVar">trait-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Produces a new <a href="trait.html#%28tech._trait%29" class="techoutside" data-pltdoc="x"><span class="techinside">trait</span></a> that is like the <a href="trait.html#%28tech._trait%29" class="techoutside" data-pltdoc="x"><span class="techinside">trait</span></a> result of
+<span class="RktVar">trait-expr</span>, but with the definition of a method named by
+<span class="RktVar">id</span> removed; as the method definition is removed, either an
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Fsuper%29%29" class="RktStxLink" data-pltdoc="x">inherit/super</a></span>, or <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Finner%29%29" class="RktStxLink" data-pltdoc="x">inherit/inner</a></span>
+declaration is added:</div></p><ul><li><p>A method declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public%29%29" class="RktStxLink" data-pltdoc="x">public</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._pubment%29%29" class="RktStxLink" data-pltdoc="x">pubment</a></span>, or
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._public-final%29%29" class="RktStxLink" data-pltdoc="x">public-final</a></span> is replaced with an <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span>
+declaration.</p></li><li><p>A method declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override%29%29" class="RktStxLink" data-pltdoc="x">override</a></span> or <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._override-final%29%29" class="RktStxLink" data-pltdoc="x">override-final</a></span>
+is replaced with an <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Fsuper%29%29" class="RktStxLink" data-pltdoc="x">inherit/super</a></span> declaration.</p></li><li><p>A method declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment%29%29" class="RktStxLink" data-pltdoc="x">augment</a></span>, <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augride%29%29" class="RktStxLink" data-pltdoc="x">augride</a></span>, or
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._augment-final%29%29" class="RktStxLink" data-pltdoc="x">augment-final</a></span> is replaced with an <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%2Finner%29%29" class="RktStxLink" data-pltdoc="x">inherit/inner</a></span> declaration.</p></li><li><p>A method declared with <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._overment%29%29" class="RktStxLink" data-pltdoc="x">overment</a></span> is not replaced
+with any <span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit%29%29" class="RktStxLink" data-pltdoc="x">inherit</a></span> declaration.</p></li></ul><p>If the trait produced by <span class="RktVar">trait-expr</span> has no method definition for
+<span class="RktVar">id</span>, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/trait..rkt)._trait-exclude-field))"></a><span title="Provided from: racket/trait | Package: base"><span class="RktSym"><span class="RktSymDef RktSym">trait-exclude-field</span></span></span><span class="hspace">&nbsp;</span><span class="RktVar">trait-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Produces a new <a href="trait.html#%28tech._trait%29" class="techoutside" data-pltdoc="x"><span class="techinside">trait</span></a> that is like the <a href="trait.html#%28tech._trait%29" class="techoutside" data-pltdoc="x"><span class="techinside">trait</span></a> result of
+<span class="RktVar">trait-expr</span>, but with the definition of a field named by
+<span class="RktVar">id</span> removed; as the field definition is removed, an
+<span class="RktSym"><a href="createclass.html#%28form._%28%28lib._racket%2Fprivate%2Fclass-internal..rkt%29._inherit-field%29%29" class="RktStxLink" data-pltdoc="x">inherit-field</a></span> declaration is added.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/trait..rkt)._trait-alias))"></a><span title="Provided from: racket/trait | Package: base"><span class="RktSym"><span class="RktSymDef RktSym">trait-alias</span></span></span><span class="hspace">&nbsp;</span><span class="RktVar">trait-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">new-id</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Produces a new <a href="trait.html#%28tech._trait%29" class="techoutside" data-pltdoc="x"><span class="techinside">trait</span></a> that is like the <a href="trait.html#%28tech._trait%29" class="techoutside" data-pltdoc="x"><span class="techinside">trait</span></a> result of
+<span class="RktVar">trait-expr</span>, but the definition and declaration of the method
+named by <span class="RktVar">id</span> is duplicated with the name <span class="RktVar">new-id</span>. The
+consistency requirements for the resulting trait are the same as for
+<span class="RktSym">trait-sum</span>, otherwise the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. This
+operation does not rename any other use of <span class="RktVar">id</span>, such as in
+method calls (even method calls to <span class="RktSym">identifier</span> in the cloned
+definition for <span class="RktVar">new-id</span>).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/trait..rkt)._trait-rename))"></a><span title="Provided from: racket/trait | Package: base"><span class="RktSym"><span class="RktSymDef RktSym">trait-rename</span></span></span><span class="hspace">&nbsp;</span><span class="RktVar">trait-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">new-id</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Produces a new <a href="trait.html#%28tech._trait%29" class="techoutside" data-pltdoc="x"><span class="techinside">trait</span></a> that is like the <a href="trait.html#%28tech._trait%29" class="techoutside" data-pltdoc="x"><span class="techinside">trait</span></a> result of
+<span class="RktVar">trait-expr</span>, but all definitions and references to methods
+named <span class="RktVar">id</span> are replaced by definitions and references to
+methods named by <span class="RktVar">new-id</span>. The consistency requirements for the
+resulting trait are the same as for <span class="RktSym">trait-sum</span>, otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/trait..rkt)._trait-rename-field))"></a><span title="Provided from: racket/trait | Package: base"><span class="RktSym"><span class="RktSymDef RktSym">trait-rename-field</span></span></span><span class="hspace">&nbsp;</span><span class="RktVar">trait-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">new-id</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Produces a new <a href="trait.html#%28tech._trait%29" class="techoutside" data-pltdoc="x"><span class="techinside">trait</span></a> that is like the <a href="trait.html#%28tech._trait%29" class="techoutside" data-pltdoc="x"><span class="techinside">trait</span></a> result of
+<span class="RktVar">trait-expr</span>, but all definitions and references to fields
+named <span class="RktVar">id</span> are replaced by definitions and references to fields
+named by <span class="RktVar">new-id</span>. The consistency requirements for the
+resulting trait are the same as for <span class="RktSym">trait-sum</span>, otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="mixins.html" title="backward to &quot;6.5 Mixins&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_class.html" title="up to &quot;6 Classes and Objects&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Object_and_Class_Contracts.html" title="forward to &quot;6.7 Object and Class Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/udp.html b/clones/docs.racket-lang.org/reference/udp.html
new file mode 100644
index 00000000..73571e4a
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/udp.html
@@ -0,0 +1,147 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15.3.2&nbsp;UDP</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewselflink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewlink" data-pltdoc="x">Paths</a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="Filesystem.html" class="tocviewlink" data-pltdoc="x">Filesystem</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="networking.html" class="tocviewselflink" data-pltdoc="x">Networking</a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="subprocess.html" class="tocviewlink" data-pltdoc="x">Processes</a></td></tr><tr><td align="right">15.5&nbsp;</td><td><a href="logging.html" class="tocviewlink" data-pltdoc="x">Logging</a></td></tr><tr><td align="right">15.6&nbsp;</td><td><a href="time.html" class="tocviewlink" data-pltdoc="x">Time</a></td></tr><tr><td align="right">15.7&nbsp;</td><td><a href="envvars.html" class="tocviewlink" data-pltdoc="x">Environment Variables</a></td></tr><tr><td align="right">15.8&nbsp;</td><td><a href="runtime.html" class="tocviewlink" data-pltdoc="x">Environment and Runtime Information</a></td></tr><tr><td align="right">15.9&nbsp;</td><td><a href="Command-Line_Parsing.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Parsing</a></td></tr><tr><td align="right">15.10&nbsp;</td><td><a href="os-lib.html" class="tocviewlink" data-pltdoc="x">Additional Operating System Functions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>15.3&nbsp;</td><td><a href="networking.html" class="tocviewlink" data-pltdoc="x">Networking</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.3.1&nbsp;</td><td><a href="tcp.html" class="tocviewlink" data-pltdoc="x">TCP</a></td></tr><tr><td align="right">15.3.2&nbsp;</td><td><a href="udp.html" class="tocviewselflink" data-pltdoc="x">UDP</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-open-socket%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>open-<wbr></wbr>socket</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-bind%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>bind!</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-connect%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>connect!</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>send-<wbr></wbr>to</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>send</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%2A%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>send-<wbr></wbr>to*</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send%2A%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>send*</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%2Fenable-break%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>send-<wbr></wbr>to/<span class="mywbr"> &nbsp;</span>enable-<wbr></wbr>break</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send%2Fenable-break%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>send/<span class="mywbr"> &nbsp;</span>enable-<wbr></wbr>break</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>receive!</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive%21%2A%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>receive!*</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive%21%2Fenable-break%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>receive!/<span class="mywbr"> &nbsp;</span>enable-<wbr></wbr>break</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-set-receive-buffer-size%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>set-<wbr></wbr>receive-<wbr></wbr>buffer-<wbr></wbr>size!</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-close%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>close</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp?</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-bound~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>bound?</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-connected~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>connected?</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-ready-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>send-<wbr></wbr>ready-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive-ready-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>receive-<wbr></wbr>ready-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>send-<wbr></wbr>to-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>send-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive%21-evt%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>receive!-<wbr></wbr>evt</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-addresses%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>addresses</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-set-ttl%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>set-<wbr></wbr>ttl!</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-ttl%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>ttl</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-join-group%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>multicast-<wbr></wbr>join-<wbr></wbr>group!</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-leave-group%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>multicast-<wbr></wbr>leave-<wbr></wbr>group!</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-interface%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>multicast-<wbr></wbr>interface</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-set-interface%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>multicast-<wbr></wbr>set-<wbr></wbr>interface!</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-set-loopback%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>multicast-<wbr></wbr>set-<wbr></wbr>loopback!</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-loopback~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>multicast-<wbr></wbr>loopback?</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-set-ttl%21%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>multicast-<wbr></wbr>set-<wbr></wbr>ttl!</span></span></a></td></tr><tr><td><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-ttl%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">udp-<wbr></wbr>multicast-<wbr></wbr>ttl</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="tcp.html" title="backward to &quot;15.3.1 TCP&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="networking.html" title="up to &quot;15.3 Networking&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="subprocess.html" title="forward to &quot;15.4 Processes&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;udp&quot;">15.3.2<tt>&nbsp;</tt><a name="(part._udp)"></a><a name="(mod-path._racket/udp)"></a>UDP</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="udp.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/udp</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="udp.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/udp</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p>For information about UDP in general, see <span style="font-style: italic">TCP/IP Illustrated,
+Volume 1</span> by W. Richard Stevens.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-open-socket))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-open-socket%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-open-socket</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">family-hostname</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">family-port-no</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">family-hostname</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">family-port-no</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._port-number~3f%29%29" class="RktValLink" data-pltdoc="x">port-number?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates and returns a <a name="(tech._udp._socket)"></a><span style="font-style: italic">UDP socket</span> to send and receive
+datagrams (broadcasting is allowed). Initially, the socket is not
+bound or connected to any address or port.</div></p><p>If <span class="RktVar">family-hostname</span> or <span class="RktVar">family-port-no</span> is not
+<span class="RktVal">#f</span>, then the socket&rsquo;s protocol family is determined from
+these arguments. The socket is <span style="font-style: italic">not</span> bound to the hostname
+or port number. For example, the arguments might be the hostname
+and port to which messages will be sent through the socket, which
+ensures that the socket&rsquo;s protocol family is consistent with the
+destination. Alternately, the arguments might be the same as for
+a future call to <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-bind%21%29%29" class="RktValLink" data-pltdoc="x">udp-bind!</a></span>, which ensures that the
+socket&rsquo;s protocol family is consistent with the binding. If
+neither <span class="RktVar">family-hostname</span> nor <span class="RktVar">family-port-no</span> is
+non-<span class="RktVal">#f</span>, then the socket&rsquo;s protocol family is IPv4.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-bind!))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-bind%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-bind!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">udp-socket</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hostname-string</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">port-no</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">reuse?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hostname-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port-no</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._listen-port-number~3f%29%29" class="RktValLink" data-pltdoc="x">listen-port-number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">reuse?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Binds an unbound <span class="RktVar">udp-socket</span> to the local port number
+<span class="RktVar">port-no</span>.  If <span class="RktVar">port-no</span> is 0 the <span class="RktVar">udp-socket</span> is
+bound to an ephemeral port, which can be determined by calling
+<span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-addresses%29%29" class="RktValLink" data-pltdoc="x">udp-addresses</a></span>.</div></p><p>If <span class="RktVar">hostname-string</span> is <span class="RktVal">#f</span>, then the socket
+accepts connections to all of the listening machine&rsquo;s IP
+addresses at <span class="RktVar">port-no</span>. Otherwise, the socket accepts
+connections only at the IP address associated with the given
+name. For example, providing <span class="RktVal">"127.0.0.1"</span> as
+<span class="RktVar">hostname-string</span> typically creates a listener that
+accepts only connections to <span class="RktVal">"127.0.0.1"</span> from the local
+machine.</p><p>A socket cannot receive datagrams until it is bound to a local address
+and port. If a socket is not bound before it is used with a sending
+procedure <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send%29%29" class="RktValLink" data-pltdoc="x">udp-send</a></span>, <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%29%29" class="RktValLink" data-pltdoc="x">udp-send-to</a></span>, etc., the sending
+procedure binds the socket to a random local port. Similarly, if an
+event from <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-evt%29%29" class="RktValLink" data-pltdoc="x">udp-send-evt</a></span> or <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to-evt%29%29" class="RktValLink" data-pltdoc="x">udp-send-to-evt</a></span> is chosen
+for a synchronization (see <a href="sync.html" data-pltdoc="x">Events</a>), the socket is bound; if
+the event is not chosen, the socket may or may not become bound.</p><p>The binding of a bound socket cannot be changed, with one exception:
+on some systems, if the socket is bound automatically when sending, if
+the socket is disconnected via <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-connect%21%29%29" class="RktValLink" data-pltdoc="x">udp-connect!</a></span>, and if the
+socket is later used again in a send, then the later send may change
+the socket&rsquo;s automatic binding.</p><p>If <span class="RktVar">udp-socket</span> is already bound or closed, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork%29%29" class="RktValLink" data-pltdoc="x">exn:fail:network</a></span> exception is raised.</p><p>If the <span class="RktVar">reuse?</span> argument is true, then <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-bind%21%29%29" class="RktValLink" data-pltdoc="x">udp-bind!</a></span> will
+set the <span class="stt">SO_REUSEADDR</span> socket option before binding, permitting the
+sharing of access to a UDP port between many processes on a single
+machine when using UDP multicast.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-connect!))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-connect%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-connect!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">udp-socket</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hostname-string</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">port-no</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hostname-string</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port-no</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._port-number~3f%29%29" class="RktValLink" data-pltdoc="x">port-number?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Connects the socket to the indicated remote address and port if
+<span class="RktVar">hostname-string</span> is a string and <span class="RktVar">port-no</span> is an exact
+integer.</div></p><p>If <span class="RktVar">hostname-string</span> is <span class="RktVal">#f</span>, then <span class="RktVar">port-no</span> also
+must be <span class="RktVal">#f</span>, and the port is disconnected (if connected). If
+one of <span class="RktVar">hostname-string</span> or <span class="RktVar">port-no</span> is <span class="RktVal">#f</span> and
+the other is not, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>A connected socket can be used with <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send%29%29" class="RktValLink" data-pltdoc="x">udp-send</a></span> (not
+<span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%29%29" class="RktValLink" data-pltdoc="x">udp-send-to</a></span>), and it accepts datagrams only from the
+connected address and port. A socket need not be connected to receive
+datagrams.  A socket can be connected, re-connected, and disconnected
+any number of times.</p><p>If <span class="RktVar">udp-socket</span> is closed, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork%29%29" class="RktValLink" data-pltdoc="x">exn:fail:network</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-send-to))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-send-to</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">udp-socket</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hostname</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">port-no</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hostname</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port-no</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._port-number~3f%29%29" class="RktValLink" data-pltdoc="x">port-number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Sends <span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._subbytes%29%29" class="RktValLink" data-pltdoc="x">subbytes</a></span><span class="stt"> </span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="stt"> </span><span class="RktVar">start-pos</span><span class="stt"> </span><span class="RktVar">end-pos</span><span class="RktPn">)</span> as a datagram from
+the unconnected <span class="RktVar">udp-socket</span> to the socket at the remote
+machine <span class="RktSym">hostname-address</span> on the port <span class="RktVar">port-no</span>. The
+<span class="RktVar">udp-socket</span> need not be bound or connected; if it is not
+bound, <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%29%29" class="RktValLink" data-pltdoc="x">udp-send-to</a></span> binds it to a random local port. If the
+socket&rsquo;s outgoing datagram queue is too full to support the send,
+<span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%29%29" class="RktValLink" data-pltdoc="x">udp-send-to</a></span> blocks until the datagram can be queued.</div></p><p>If <span class="RktVar">start-pos</span> is greater than the length of <span class="RktVar">bstr</span>, or
+if <span class="RktVar">end-pos</span> is less than <span class="RktVar">start-pos</span> or greater than
+the length of <span class="RktVar">bstr</span>, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>If <span class="RktVar">udp-socket</span> is closed or connected, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork%29%29" class="RktValLink" data-pltdoc="x">exn:fail:network</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-send))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-send</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%29%29" class="RktValLink" data-pltdoc="x">udp-send-to</a></span>, except that <span class="RktVar">udp-socket</span> must be
+connected, and the datagram goes to the connection target.  If
+<span class="RktVar">udp-socket</span> is closed or unconnected, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork%29%29" class="RktValLink" data-pltdoc="x">exn:fail:network</a></span> exception is raised.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-send-to*))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-send-to*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">udp-socket</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hostname</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">port-no</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hostname</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port-no</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._port-number~3f%29%29" class="RktValLink" data-pltdoc="x">port-number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%29%29" class="RktValLink" data-pltdoc="x">udp-send-to</a></span>, but never blocks; if the socket&rsquo;s outgoing
+queue is too full to support the send, <span class="RktVal">#f</span> is returned,
+otherwise the datagram is queued and the result is <span class="RktVal">#t</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-send*))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-send*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send%29%29" class="RktValLink" data-pltdoc="x">udp-send</a></span>, except that (like <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%29%29" class="RktValLink" data-pltdoc="x">udp-send-to</a></span>) it
+never blocks and returns <span class="RktVal">#f</span> or <span class="RktVal">#t</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-send-to/enable-break))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%2Fenable-break%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-send-to/enable-break</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">udp-socket</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hostname</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">port-no</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hostname</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port-no</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._port-number~3f%29%29" class="RktValLink" data-pltdoc="x">port-number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%29%29" class="RktValLink" data-pltdoc="x">udp-send-to</a></span>, but breaking is enabled (see
+<a href="breakhandler.html" data-pltdoc="x">Breaks</a>) while trying to send the datagram. If
+breaking is disabled when <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">udp-send-to/enable-break</a></span> is called,
+then either the datagram is sent or the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak%29%29" class="RktValLink" data-pltdoc="x">exn:break</a></span> exception
+is raised, but not both.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-send/enable-break))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send%2Fenable-break%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-send/enable-break</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">udp-socket</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send%29%29" class="RktValLink" data-pltdoc="x">udp-send</a></span>, except that breaks are enabled like
+<span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">udp-send-to/enable-break</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-receive!))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-receive!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">udp-socket</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._port-number~3f%29%29" class="RktValLink" data-pltdoc="x">port-number?</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Accepts up to <span class="RktVar">end-pos</span><span style="font-style: italic">-</span><span class="RktVar">start-pos</span> bytes of
+<span class="RktVar">udp-socket</span>&rsquo;s next incoming datagram into <span class="RktVar">bstr</span>,
+writing the datagram bytes starting at position <span class="RktVar">start-pos</span>
+within <span class="RktVar">bstr</span>. The <span class="RktVar">udp-socket</span> must be bound to a local
+address and port (but need not be connected). If no incoming datagram
+is immediately available, <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive%21%29%29" class="RktValLink" data-pltdoc="x">udp-receive!</a></span> blocks until one is
+available.</div></p><p>Three values are returned: the number of received bytes (between
+<span class="RktVal">0</span> and <span class="RktVar">end-pos</span><span style="font-style: italic">-</span><span class="RktVar">start-pos</span>, a hostname
+string indicating the source address of the datagram, and an integer
+indicating the source port of the datagram. If the received datagram
+is longer than <span class="RktVar">end-pos</span><span style="font-style: italic">-</span><span class="RktVar">start-pos</span> bytes, the
+remainder is discarded.</p><p>If <span class="RktVar">start-pos</span> is greater than the length of <span class="RktVar">bstr</span>, or
+if <span class="RktVar">end-pos</span> is less than <span class="RktVar">start-pos</span> or greater than
+the length of <span class="RktVar">bstr</span>, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-receive!*))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive%21%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-receive!*</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">udp-socket</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._port-number~3f%29%29" class="RktValLink" data-pltdoc="x">port-number?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive%21%29%29" class="RktValLink" data-pltdoc="x">udp-receive!</a></span>, except that it never blocks. If no
+datagram is available, the three result values are all <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-receive!/enable-break))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive%21%2Fenable-break%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-receive!/enable-break</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">udp-socket</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._port-number~3f%29%29" class="RktValLink" data-pltdoc="x">port-number?</a></span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive%21%29%29" class="RktValLink" data-pltdoc="x">udp-receive!</a></span>, but breaking is enabled (see
+<a href="breakhandler.html" data-pltdoc="x">Breaks</a>) while trying to receive the datagram. If
+breaking is disabled when <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive%21%2Fenable-break%29%29" class="RktValLink" data-pltdoc="x">udp-receive!/enable-break</a></span> is
+called, then either a datagram is received or the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3abreak%29%29" class="RktValLink" data-pltdoc="x">exn:break</a></span>
+exception is raised, but not both.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-set-receive-buffer-size!))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-set-receive-buffer-size%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-set-receive-buffer-size!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">udp-socket</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">size</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">size</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Set the receive buffer size (<span class="stt">SO_RCVBUF</span>) for <span class="RktVar">udp-socket</span>.
+Using a larger buffer can minimize packet loss that can occur due to
+slow polling of a connection, including during a major garbage
+collection.</div></p><p>If <span class="RktVar">size</span> is greater than the maximum allowed by the system,
+the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork%29%29" class="RktValLink" data-pltdoc="x">exn:fail:network</a></span> exception is raised.</p><p class="SHistory">Added in version 7.1.0.11 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-close))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-close%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-close</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">udp-socket</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Closes <span class="RktVar">udp-socket</span>, discarding unreceived datagrams.  If the
+socket is already closed, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork%29%29" class="RktValLink" data-pltdoc="x">exn:fail:network</a></span> exception is raised.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp~3f))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a socket created by
+<span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-open-socket%29%29" class="RktValLink" data-pltdoc="x">udp-open-socket</a></span>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-bound~3f))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-bound~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-bound?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">udp-socket</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">udp-socket</span> is bound to a local address
+and port, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-connected~3f))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-connected~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-connected?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">udp-socket</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">udp-socket</span> is connected to a remote
+address and port, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-send-ready-evt))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-ready-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-send-ready-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">udp-socket</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> (see <a href="sync.html" data-pltdoc="x">Events</a>) that is
+in a blocking state when <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%29%29" class="RktValLink" data-pltdoc="x">udp-send-to</a></span> on <span class="RktVar">udp-socket</span>
+would block. The <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> is the event itself.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-receive-ready-evt))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive-ready-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-receive-ready-evt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">udp-socket</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> (see <a href="sync.html" data-pltdoc="x">Events</a>) that is
+in a blocking state when <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive%21%29%29" class="RktValLink" data-pltdoc="x">udp-receive!</a></span> on <span class="RktVar">udp-socket</span>
+would block. The <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> is the event itself.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-send-to-evt))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-send-to-evt</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">udp-socket</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hostname</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">port-no</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hostname</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port-no</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._port-number~3f%29%29" class="RktValLink" data-pltdoc="x">port-number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a>. The event is in a blocking
+state when <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%29%29" class="RktValLink" data-pltdoc="x">udp-send-to</a></span> on <span class="RktVar">udp-socket</span> would
+block. Otherwise, if the event is chosen in a synchronization, data is
+sent as for <span class="RktPn">(</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%29%29" class="RktValLink" data-pltdoc="x">udp-send-to</a></span><span class="stt"> </span><span class="RktVar">udp-socket</span><span class="stt"> </span><span class="RktSym">hostname-address</span><span class="stt"> </span><span class="RktVar">port-no</span><span class="stt"> </span><span class="RktVar">bstr</span><span class="stt"> </span><span class="RktVar">start-pos</span><span class="stt"> </span><span class="RktVar">end-pos</span><span class="RktPn">)</span>, and the synchronization result is
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>. (No bytes are sent if the event is not chosen.)</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-send-evt))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-send-evt</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">udp-socket</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a>. The event is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a>
+when <span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send%29%29" class="RktValLink" data-pltdoc="x">udp-send</a></span> on <span class="RktVar">udp-socket</span> would
+not block. Otherwise, if the event is chosen in a synchronization, data is
+sent as for <span class="RktPn">(</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-send-to%29%29" class="RktValLink" data-pltdoc="x">udp-send-to</a></span><span class="stt"> </span><span class="RktVar">udp-socket</span><span class="stt"> </span><span class="RktVar">bstr</span><span class="stt"> </span><span class="RktVar">start-pos</span><span class="stt"> </span><span class="RktVar">end-pos</span><span class="RktPn">)</span>,
+and the <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> is <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>. (No bytes are sent if
+the event is not chosen.) If <span class="RktVar">udp-socket</span> is closed or
+unconnected, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork%29%29" class="RktValLink" data-pltdoc="x">exn:fail:network</a></span> exception is raised during a synchronization
+attempt.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-receive!-evt))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive%21-evt%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-receive!-evt</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">udp-socket</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bstr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start-pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._evt~3f%29%29" class="RktValLink" data-pltdoc="x">evt?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a>. The event is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a>
+when <span class="RktSym">udp-receive</span> on <span class="RktVar">udp-socket</span> would not
+block. Otherwise, if the event is chosen in a synchronization, data is
+received into <span class="RktVar">bstr</span> as for <span class="RktPn">(</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive%21%29%29" class="RktValLink" data-pltdoc="x">udp-receive!</a></span><span class="stt"> </span><span class="RktVar">udp-socket</span><span class="stt"> </span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes%29%29" class="RktValLink" data-pltdoc="x">bytes</a></span><span class="stt"> </span><span class="RktVar">start-pos</span><span class="stt"> </span><span class="RktVar">end-pos</span><span class="RktPn">)</span>, and the <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> is a list of
+three values, corresponding to the three results from
+<span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-receive%21%29%29" class="RktValLink" data-pltdoc="x">udp-receive!</a></span>. (No bytes are received and the <span class="RktVar">bstr</span>
+content is not modified if the event is not chosen.)</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-addresses))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-addresses%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-addresses</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">udp-port</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">port-numbers?</span><span class="RktOpt">]</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._listen-port-number~3f%29%29" class="RktValLink" data-pltdoc="x">listen-port-number?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="tcp.html#%28def._%28%28lib._racket%2Ftcp..rkt%29._listen-port-number~3f%29%29" class="RktValLink" data-pltdoc="x">listen-port-number?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-port</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">port-numbers?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns two strings when <span class="RktVar">port-numbers?</span> is <span class="RktVal">#f</span> (the
+default). The first string is the Internet address for the local
+machine a viewed by the given <a href="udp.html#%28tech._udp._socket%29" class="techoutside" data-pltdoc="x"><span class="techinside">UDP socket</span></a>&rsquo;s connection. (For most
+machines, the answer corresponds to the current machine&rsquo;s only
+Internet address, but when a machine serves multiple addresses, the
+result is connection-specific.) The second string is the Internet
+address for the other end of the connection.</div></p><p>If <span class="RktVar">port-numbers?</span> is true, then four results are returned: a
+string for the local machine&rsquo;s address, an exact integer between
+<span class="RktVal">1</span> and <span class="RktVal">65535</span> for the local machine&rsquo;s port number
+or <span class="RktVal">0</span> if the socket is unbound, a
+string for the remote machine&rsquo;s address, and an exact integer between
+<span class="RktVal">1</span> and <span class="RktVal">65535</span> for the remote machine&rsquo;s port number
+or <span class="RktVal">0</span> if the socket is unconnected.</p><p>If the given port has been closed, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3anetwork%29%29" class="RktValLink" data-pltdoc="x">exn:fail:network</a></span> exception is raised.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-set-ttl!))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-set-ttl%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-set-ttl!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span><span class="RktVar">ttl</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ttl</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-ttl))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-ttl%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-ttl</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">udp-socket</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Time-to-live settings correspond to the
+<a name="(idx._(gentag._381._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">IP_TTL</span> setting of the socket.</p></blockquote></blockquote></blockquote></div></p><p>Sets or retrieves the current time-to-live setting of
+<span class="RktVar">udp-socket</span>.</p><p class="SHistory">Added in version 7.5.0.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-multicast-join-group!))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-join-group%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-multicast-join-group!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">udp-socket</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">multicast-addr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hostname</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">multicast-addr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hostname</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-multicast-leave-group!))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-leave-group%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-multicast-leave-group!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">udp-socket</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">multicast-addr</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hostname</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">multicast-addr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hostname</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Adds or removes <span class="RktVar">udp-socket</span> to a named multicast group.</div></p><p>The <span class="RktVar">multicast-addr</span> argument must be a valid IPv4 multicast
+IP address; for example, <span class="RktVal">"224.0.0.251"</span> is the appropriate
+address for the mDNS protocol. The <span class="RktVar">hostname</span> argument selects the
+interface that the socket uses to receive (not send) multicast datagrams;
+if <span class="RktVar">hostname</span> is <span class="RktVal">#f</span> or <span class="RktVal">"0.0.0.0"</span>, the kernel
+selects an interface automatically.</p><p>Leaving a group requires the same <span class="RktVar">multicast-addr</span> and
+<span class="RktVar">hostname</span> arguments that were used to join the group.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-multicast-interface))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-interface%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-multicast-interface</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">udp-socket</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-multicast-set-interface!))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-set-interface%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-multicast-set-interface!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">udp-socket</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hostname</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hostname</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Retrieves or sets the interface that <span class="RktVar">udp-socket</span> uses to
+send (not receive) multicast datagrams. If the result or <span class="RktVar">hostname</span> is either
+<span class="RktVal">#f</span> or <span class="RktVal">"0.0.0.0"</span>, the kernel automatically selects an
+interface when a multicast datagram is sent.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-multicast-set-loopback!))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-set-loopback%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-multicast-set-loopback!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">udp-socket</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">loopback?</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">loopback?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-multicast-loopback~3f))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-loopback~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-multicast-loopback?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">udp-socket</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Loopback settings correspond to the
+<a name="(idx._(gentag._382._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">IP_MULTICAST_LOOP</span> setting of the socket.</p></blockquote></blockquote></blockquote></div></p><p>Sets or checks whether <span class="RktVar">udp-socket</span> receives its own multicast
+datagrams: a <span class="RktVal">#t</span> result or a true value for <span class="RktVar">loopback?</span>
+indicates that self-receipt is enabled, and <span class="RktVal">#f</span> indicates that
+self-receipt is disabled.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-multicast-set-ttl!))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-set-ttl%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-multicast-set-ttl!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span><span class="RktVar">ttl</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ttl</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/udp..rkt)._udp-multicast-ttl))"></a><span title="Provided from: racket/udp, racket | Package: base"><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp-multicast-ttl%29%29" class="RktValDef RktValLink" data-pltdoc="x">udp-multicast-ttl</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">udp-socket</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">udp-socket</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="udp.html#%28def._%28%28lib._racket%2Fudp..rkt%29._udp~3f%29%29" class="RktValLink" data-pltdoc="x">udp?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Time-to-live settings correspond to the
+<a name="(idx._(gentag._383._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">IP_MULTICAST_TTL</span> setting of the socket.</p></blockquote></blockquote></blockquote></div></p><p>Sets or retrieves the current time-to-live setting of
+<span class="RktVar">udp-socket</span>.</p><p>The time-to-live setting should almost always be 1, and it is
+important that this number is as low as possible. In fact, these
+functions seldom should be used at all. See the documentation for your
+platform&rsquo;s IP stack.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="tcp.html" title="backward to &quot;15.3.1 TCP&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="networking.html" title="up to &quot;15.3 Networking&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="subprocess.html" title="forward to &quot;15.4 Processes&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/undefined.html b/clones/docs.racket-lang.org/reference/undefined.html
new file mode 100644
index 00000000..a9a789dc
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/undefined.html
@@ -0,0 +1,5 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.21&nbsp;Undefined</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewselflink" data-pltdoc="x">Undefined</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="undefined.html#%28def._%28%28lib._racket%2Fundefined..rkt%29._undefined%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">undefined</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="void.html" title="backward to &quot;4.20 Void&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="structures.html" title="forward to &quot;5 Structures&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;undefined&quot;">4.21<tt>&nbsp;</tt><a name="(part._undefined)"></a><a name="(mod-path._racket/undefined)"></a>Undefined</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="undefined.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/undefined</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="undefined.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/undefined</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p>The constant <span class="RktSym"><a href="undefined.html#%28def._%28%28lib._racket%2Fundefined..rkt%29._undefined%29%29" class="RktValLink" data-pltdoc="x">undefined</a></span> can be used as a placeholder value for
+a value to be installed later, especially for cases where premature
+access of the value is either difficult or impossible to detect or
+prevent.</p><p>The <span class="RktSym"><a href="undefined.html#%28def._%28%28lib._racket%2Fundefined..rkt%29._undefined%29%29" class="RktValLink" data-pltdoc="x">undefined</a></span> value is always <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to itself.</p><p class="SHistory">Added in version 6.0.0.6 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/undefined..rkt)._undefined))"></a><span title="Provided from: racket/undefined | Package: base"><span class="RktSym"><a href="undefined.html#%28def._%28%28lib._racket%2Fundefined..rkt%29._undefined%29%29" class="RktValDef RktValLink" data-pltdoc="x">undefined</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">The &ldquo;undefined&rdquo; constant.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="void.html" title="backward to &quot;4.20 Void&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="structures.html" title="forward to &quot;5 Structures&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/unitcontracts.html b/clones/docs.racket-lang.org/reference/unitcontracts.html
new file mode 100644
index 00000000..7c872b58
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/unitcontracts.html
@@ -0,0 +1,16 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7.9&nbsp;Unit Contracts</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="creatingunits.html" class="tocviewlink" data-pltdoc="x">Creating Units</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="invokingunits.html" class="tocviewlink" data-pltdoc="x">Invoking Units</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="compoundunits.html" class="tocviewlink" data-pltdoc="x">Linking Units and Creating Compound Units</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="linkinference.html" class="tocviewlink" data-pltdoc="x">Inferred Linking</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="Generating_A_Unit_from_Context.html" class="tocviewlink" data-pltdoc="x">Generating A Unit from Context</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="Structural_Matching.html" class="tocviewlink" data-pltdoc="x">Structural Matching</a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="define-sig-form.html" class="tocviewlink" data-pltdoc="x">Extending the Syntax of Signatures</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Unit_Utilities.html" class="tocviewlink" data-pltdoc="x">Unit Utilities</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="unitcontracts.html" class="tocviewselflink" data-pltdoc="x">Unit Contracts</a></td></tr><tr><td align="right">7.10&nbsp;</td><td><a href="single-unit.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Unit Modules</a></td></tr><tr><td align="right">7.11&nbsp;</td><td><a href="Single-Signature_Modules.html" class="tocviewlink" data-pltdoc="x">Single-<wbr></wbr>Signature Modules</a></td></tr><tr><td align="right">7.12&nbsp;</td><td><a href="Transformer_Helpers.html" class="tocviewlink" data-pltdoc="x">Transformer Helpers</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="unitcontracts.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%2Fc%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unit/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><a href="unitcontracts.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%2Fcontract%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>unit/<span class="mywbr"> &nbsp;</span>contract</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Unit_Utilities.html" title="backward to &quot;7.8 Unit Utilities&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="single-unit.html" title="forward to &quot;7.10 Single-Unit Modules&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;unitcontracts&quot;">7.9<tt>&nbsp;</tt><a name="(part._unitcontracts)"></a>Unit Contracts</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._unit/c))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="unitcontracts.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%2Fc%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">unit/c</a></span></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span><span class="hspace">&nbsp;</span><span class="RktVar">sig-block</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktVar">sig-block</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">init-depends-decl</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">optional-body-ctc</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">sig-block</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">tagged-sig-id</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">contract</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">tagged-sig-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">init-depends-decl</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._init-depend%29%29" class="RktStxLink" data-pltdoc="x">init-depend</a></span><span class="hspace">&nbsp;</span><span class="RktVar">tagged-sig-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">optional-body-ctc</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">contract</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVar">contract</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">A <a name="(tech._unit._contract)"></a><span style="font-style: italic">unit contract</span> wraps a unit and checks both its imported and
+exported identifiers to ensure that they match the appropriate contracts.
+This allows the programmer to add contract checks to a single unit value
+without adding contracts to the imported and exported signatures.</div></p><p>The unit value must import a subset of the import signatures and export a
+superset of the export signatures listed in the unit contract. Additionally,
+the unit value must declare initialization dependencies that are a subset of
+those specified in the unit contract. Any identifier which is not listed
+for a given signature is left alone. Variables used in a given
+<span class="RktVar">contract</span> expression first refer to other variables in the same
+signature, and then to the context of the <span class="RktSym"><a href="unitcontracts.html#%28form._%28%28lib._racket%2Funit..rkt%29._unit%2Fc%29%29" class="RktStxLink" data-pltdoc="x">unit/c</a></span> expression.
+If a body contract is specified then the result of invoking the unit value
+is wrapped with the given contract, if no body contract is supplied then
+no wrapping occurs when the unit value is invoked.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/unit..rkt)._define-unit/contract))"></a><span title="Provided from: racket/unit, racket | Package: base"><span class="RktSym"><a href="unitcontracts.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%2Fcontract%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">define-unit/contract</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">unit-id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._import%29%29" class="RktStxLink" data-pltdoc="x">import</a></span><span class="hspace">&nbsp;</span><span class="RktVar">sig-spec-block</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="creatingunits.html#%28form._%28%28lib._racket%2Funit..rkt%29._export%29%29" class="RktStxLink" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktVar">sig-spec-block</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">init-depends-decl</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">optional-body-ctc</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">unit-body-expr-or-defn</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">sig-spec-block</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">tagged-sig-spec</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">contract</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">tagged-sig-spec</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">optional-body-ctc</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:invoke/contract</span><span class="hspace">&nbsp;</span><span class="RktVar">contract</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:invoke/contract</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVar">contract</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="unitcontracts.html#%28form._%28%28lib._racket%2Funit..rkt%29._define-unit%2Fcontract%29%29" class="RktStxLink" data-pltdoc="x">define-unit/contract</a></span> form defines a unit compatible with
+link inference whose imports and exports are contracted with a unit
+contract.  The unit name is used for the positive blame of the contract.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Unit_Utilities.html" title="backward to &quot;7.8 Unit Utilities&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="mzlib_unit.html" title="up to &quot;7 Units&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="single-unit.html" title="forward to &quot;7.10 Single-Unit Modules&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/unixpaths.html b/clones/docs.racket-lang.org/reference/unixpaths.html
new file mode 100644
index 00000000..31f2a792
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/unixpaths.html
@@ -0,0 +1,27 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15.1.3&nbsp;Unix and Mac OS Paths</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewselflink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewselflink" data-pltdoc="x">Paths</a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="Filesystem.html" class="tocviewlink" data-pltdoc="x">Filesystem</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="networking.html" class="tocviewlink" data-pltdoc="x">Networking</a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="subprocess.html" class="tocviewlink" data-pltdoc="x">Processes</a></td></tr><tr><td align="right">15.5&nbsp;</td><td><a href="logging.html" class="tocviewlink" data-pltdoc="x">Logging</a></td></tr><tr><td align="right">15.6&nbsp;</td><td><a href="time.html" class="tocviewlink" data-pltdoc="x">Time</a></td></tr><tr><td align="right">15.7&nbsp;</td><td><a href="envvars.html" class="tocviewlink" data-pltdoc="x">Environment Variables</a></td></tr><tr><td align="right">15.8&nbsp;</td><td><a href="runtime.html" class="tocviewlink" data-pltdoc="x">Environment and Runtime Information</a></td></tr><tr><td align="right">15.9&nbsp;</td><td><a href="Command-Line_Parsing.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Parsing</a></td></tr><tr><td align="right">15.10&nbsp;</td><td><a href="os-lib.html" class="tocviewlink" data-pltdoc="x">Additional Operating System Functions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewlink" data-pltdoc="x">Paths</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1.1&nbsp;</td><td><a href="Manipulating_Paths.html" class="tocviewlink" data-pltdoc="x">Manipulating Paths</a></td></tr><tr><td align="right">15.1.2&nbsp;</td><td><a href="More_Path_Utilities.html" class="tocviewlink" data-pltdoc="x">More Path Utilities</a></td></tr><tr><td align="right">15.1.3&nbsp;</td><td><a href="unixpaths.html" class="tocviewselflink" data-pltdoc="x">Unix and Mac OS Paths</a></td></tr><tr><td align="right">15.1.4&nbsp;</td><td><a href="windowspaths.html" class="tocviewlink" data-pltdoc="x">Windows Paths</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_3&quot;);">&#9658;</a></td><td>15.1.3&nbsp;</td><td><a href="unixpaths.html" class="tocviewselflink" data-pltdoc="x">Unix and Mac OS Paths</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_3"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1.3.1&nbsp;</td><td><a href="unixpaths.html#%28part._unixpathrep%29" class="tocviewlink" data-pltdoc="x">Unix Path Representation</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">15.1.3.1<tt>&nbsp;</tt></span><a href="unixpaths.html#%28part._unixpathrep%29" class="tocsubseclink" data-pltdoc="x">Unix Path Representation</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="More_Path_Utilities.html" title="backward to &quot;15.1.2 More Path Utilities&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="pathutils.html" title="up to &quot;15.1 Paths&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="windowspaths.html" title="forward to &quot;15.1.4 Windows Paths&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;unixpaths&quot;">15.1.3<tt>&nbsp;</tt><a name="(part._unixpaths)"></a>Unix and Mac OS Paths</h5><p>In a path on Unix and Mac OS, a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> separates elements of the path,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> as a path element always means the directory indicated by
+preceding path, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">..</span><span class="hspace"></span></span> as a path element always means the
+parent of the directory indicated by the preceding path. A leading
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">~</span><span class="hspace"></span></span> in a path is not treated specially, but
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._expand-user-path%29%29" class="RktValLink" data-pltdoc="x">expand-user-path</a></span> can be used to convert a leading <span class="RktInBG"><span class="hspace"></span><span class="RktIn">~</span><span class="hspace"></span></span>
+element to a user-specific directory. No other character or byte has a
+special meaning within a path. Multiple adjacent <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> are
+equivalent to a single <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> (i.e., they act as a single path
+separator).</p><p>A path root is always <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>. A path starting with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> is
+an absolute, complete path, and a path starting with any other
+character is a relative path.</p><p>Any pathname that ends with a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> syntactically refers to a
+directory, as does any path whose last element is <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">..</span><span class="hspace"></span></span>.</p><p>A Unix and Mac OS path is <a href="pathutils.html#%28tech._cleanse%29" data-pltdoc="x">cleanse</a>d by replacing multiple adjacent
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>s with a single <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>.</p><p>For <span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath-element%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;path-element</a></span><span class="stt"> </span><span class="RktVar">bstr</span><span class="RktPn">)</span>, <span class="RktSym">bstr</span> must not
+contain any <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>, otherwise the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.
+The result of <span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-element-~3ebytes%29%29" class="RktValLink" data-pltdoc="x">path-element-&gt;bytes</a></span><span class="stt"> </span><span class="RktVar">path</span><span class="RktPn">)</span> or
+<span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-element-~3estring%29%29" class="RktValLink" data-pltdoc="x">path-element-&gt;string</a></span><span class="stt"> </span><span class="RktVar">path</span><span class="RktPn">)</span> is always the same as the result
+of <span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3ebytes%29%29" class="RktValLink" data-pltdoc="x">path-&gt;bytes</a></span><span class="stt"> </span><span class="RktVar">path</span><span class="RktPn">)</span> and <span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3estring%29%29" class="RktValLink" data-pltdoc="x">path-&gt;string</a></span><span class="stt"> </span><span class="RktVar">path</span><span class="RktPn">)</span>. Since that is not the case for other platforms, however,
+<span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-element-~3ebytes%29%29" class="RktValLink" data-pltdoc="x">path-element-&gt;bytes</a></span> and <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-element-~3estring%29%29" class="RktValLink" data-pltdoc="x">path-element-&gt;string</a></span> should
+be used when converting individual path elements.</p><p>On Mac OS, Finder aliases are zero-length files.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;unixpathrep&quot;">15.1.3.1<tt>&nbsp;</tt><a name="(part._unixpathrep)"></a>Unix Path Representation</h5><p>A path on Unix and Mac OS is natively a byte string. For presentation to
+users and for other string-based operations, a path is converted
+to/from a string using the current locale&rsquo;s encoding with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">?</span><span class="hspace"></span></span>
+(encoding) or <span class="RktVal">#\uFFFD</span><span class="RktMeta"></span> (decoding) in place of errors. Beware
+that the encoding may not accommodate all possible paths as
+distinct strings.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="More_Path_Utilities.html" title="backward to &quot;15.1.2 More Path Utilities&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="pathutils.html" title="up to &quot;15.1 Paths&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="windowspaths.html" title="forward to &quot;15.1.4 Windows Paths&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/unreachable.html b/clones/docs.racket-lang.org/reference/unreachable.html
new file mode 100644
index 00000000..d6c33a57
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/unreachable.html
@@ -0,0 +1,10 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>10.8&nbsp;Unreachable Expressions</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewselflink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">10.1&nbsp;</td><td><a href="values.html" class="tocviewlink" data-pltdoc="x">Multiple Values</a></td></tr><tr><td align="right">10.2&nbsp;</td><td><a href="exns.html" class="tocviewlink" data-pltdoc="x">Exceptions</a></td></tr><tr><td align="right">10.3&nbsp;</td><td><a href="Delayed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Delayed Evaluation</a></td></tr><tr><td align="right">10.4&nbsp;</td><td><a href="cont.html" class="tocviewlink" data-pltdoc="x">Continuations</a></td></tr><tr><td align="right">10.5&nbsp;</td><td><a href="contmarks.html" class="tocviewlink" data-pltdoc="x">Continuation Marks</a></td></tr><tr><td align="right">10.6&nbsp;</td><td><a href="breakhandler.html" class="tocviewlink" data-pltdoc="x">Breaks</a></td></tr><tr><td align="right">10.7&nbsp;</td><td><a href="Exiting.html" class="tocviewlink" data-pltdoc="x">Exiting</a></td></tr><tr><td align="right">10.8&nbsp;</td><td><a href="unreachable.html" class="tocviewselflink" data-pltdoc="x">Unreachable Expressions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>10.8&nbsp;</td><td><a href="unreachable.html" class="tocviewselflink" data-pltdoc="x">Unreachable Expressions</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">10.8.1&nbsp;</td><td><a href="unreachable.html#%28part._with-unreachable%29" class="tocviewlink" data-pltdoc="x">Customized Unreachable Reporting</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="unreachable.html#%28def._%28%28quote._~23~25kernel%29._assert-unreachable%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">assert-<wbr></wbr>unreachable</span></span></a></td></tr><tr><td><span class="tocsublinknumber">10.8.1<tt>&nbsp;</tt></span><a href="unreachable.html#%28part._with-unreachable%29" class="tocsubseclink" data-pltdoc="x">Customized Unreachable Reporting</a></td></tr><tr><td><a href="unreachable.html#%28form._%28%28lib._racket%2Funreachable..rkt%29._with-assert-unreachable%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>assert-<wbr></wbr>unreachable</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Exiting.html" title="backward to &quot;10.7 Exiting&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Control Flow&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="concurrency.html" title="forward to &quot;11 Concurrency and Parallelism&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;unreachable&quot;">10.8<tt>&nbsp;</tt><a name="(part._unreachable)"></a>Unreachable Expressions</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._assert-unreachable))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="unreachable.html#%28def._%28%28quote._~23~25kernel%29._assert-unreachable%29%29" class="RktValDef RktValLink" data-pltdoc="x">assert-unreachable</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._none%2Fc%29%29" class="RktValLink" data-pltdoc="x">none/c</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Reports an assertion failure by raising <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span>,
+which is useful as a safe counterpart to
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-assert-unreachable%29%29" class="RktValLink" data-pltdoc="x">unsafe-assert-unreachable</a></span>.</div></p><p class="SHistory">Added in version 8.0.0.11 of package <span class="stt">base</span>.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;with-unreachable&quot;">10.8.1<tt>&nbsp;</tt><a name="(part._with-unreachable)"></a><a name="(mod-path._racket/unreachable)"></a>Customized Unreachable Reporting</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="unreachable.html#%28mod-path._racket%2Funreachable%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/unreachable</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="unreachable.html#%28mod-path._racket%2Funreachable%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/unreachable</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p class="SHistory">Added in version 8.0.0.11 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><table cellspacing="0" cellpadding="0" class="RktBlk RForeground"><tr><td><span class="RktPn">(</span><a name="(form._((lib._racket/unreachable..rkt)._with-assert-unreachable))"></a><span title="Provided from: racket/unreachable | Package: base"><span class="RktSym"><a href="unreachable.html#%28form._%28%28lib._racket%2Funreachable..rkt%29._with-assert-unreachable%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">with-assert-unreachable</a></span></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktPn">(</span><span class="RktSym"><a href="unreachable.html#%28def._%28%28quote._~23~25kernel%29._assert-unreachable%29%29" class="RktValLink" data-pltdoc="x">assert-unreachable</a></span><span class="RktPn">)</span>, asserts that the
+<span class="RktVar">body</span> forms should not be reached.</div></p><p>Unless the expression is part of a module that includes
+<span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._~23~25declare%29%29" class="RktStxLink" data-pltdoc="x">#%declare</a></span><span class="stt"> </span><span class="RktPn">#:unsafe</span><span class="RktPn">)</span>, then it is equivalent to
+<span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta">...+</span><span class="RktPn">)</span>. The intent is that the
+<span class="RktVar">body</span> forms will raise <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span>.</p><p>When a <span class="RktSym"><a href="unreachable.html#%28form._%28%28lib._racket%2Funreachable..rkt%29._with-assert-unreachable%29%29" class="RktStxLink" data-pltdoc="x">with-assert-unreachable</a></span> expression is part of a module
+with <span class="RktPn">(</span><span class="RktSym"><a href="module.html#%28form._%28%28quote._~23~25kernel%29._~23~25declare%29%29" class="RktStxLink" data-pltdoc="x">#%declare</a></span><span class="stt"> </span><span class="RktPn">#:unsafe</span><span class="RktPn">)</span>, then it is equivalent to
+<span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-assert-unreachable%29%29" class="RktValLink" data-pltdoc="x">unsafe-assert-unreachable</a></span><span class="RktPn">)</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Exiting.html" title="backward to &quot;10.7 Exiting&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Control Flow&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="concurrency.html" title="forward to &quot;11 Concurrency and Parallelism&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/unsafe.html b/clones/docs.racket-lang.org/reference/unsafe.html
new file mode 100644
index 00000000..9145ec45
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/unsafe.html
@@ -0,0 +1,211 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>17&nbsp;Unsafe Operations</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9660;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewselflink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>17&nbsp;</td><td><a href="unsafe.html" class="tocviewselflink" data-pltdoc="x">Unsafe Operations</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">17.1&nbsp;</td><td><a href="unsafe.html#%28part._.Unsafe_.Numeric_.Operations%29" class="tocviewlink" data-pltdoc="x">Unsafe Numeric Operations</a></td></tr><tr><td align="right">17.2&nbsp;</td><td><a href="unsafe.html#%28part._.Unsafe_.Character_.Operations%29" class="tocviewlink" data-pltdoc="x">Unsafe Character Operations</a></td></tr><tr><td align="right">17.3&nbsp;</td><td><a href="unsafe.html#%28part._.Unsafe._.Data._.Extraction%29" class="tocviewlink" data-pltdoc="x">Unsafe Compound-<wbr></wbr>Data Operations</a></td></tr><tr><td align="right">17.4&nbsp;</td><td><a href="unsafe.html#%28part._unsafeextfl%29" class="tocviewlink" data-pltdoc="x">Unsafe Extflonum Operations</a></td></tr><tr><td align="right">17.5&nbsp;</td><td><a href="unsafe.html#%28part._.Unsafe_.Impersonators_and_.Chaperones%29" class="tocviewlink" data-pltdoc="x">Unsafe Impersonators and Chaperones</a></td></tr><tr><td align="right">17.6&nbsp;</td><td><a href="unsafe.html#%28part._unsafeassert%29" class="tocviewlink" data-pltdoc="x">Unsafe Assertions</a></td></tr><tr><td align="right">17.7&nbsp;</td><td><a href="unsafe.html#%28part._unsafe-undefined%29" class="tocviewlink" data-pltdoc="x">Unsafe Undefined</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">17.1<tt>&nbsp;</tt></span><a href="unsafe.html#%28part._.Unsafe_.Numeric_.Operations%29" class="tocsubseclink" data-pltdoc="x">Unsafe Numeric Operations</a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx%2B%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fx+</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx-%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fx-</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fx*</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxquotient%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fxquotient</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxremainder%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fxremainder</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxmodulo%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fxmodulo</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxabs%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fxabs</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxand%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fxand</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxior%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fxior</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxxor%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fxxor</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxnot%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fxnot</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxlshift%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fxlshift</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxrshift%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fxrshift</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxpopcount%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fxpopcount</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxpopcount32%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fxpopcount32</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxpopcount16%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fxpopcount16</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx%2B%2Fwraparound%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fx+<span class="mywbr"> &nbsp;</span>/<span class="mywbr"> &nbsp;</span>wraparound</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx-%2Fwraparound%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fx-<wbr></wbr>/<span class="mywbr"> &nbsp;</span>wraparound</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx%2A%2Fwraparound%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fx*/<span class="mywbr"> &nbsp;</span>wraparound</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxlshift%2Fwraparound%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fxlshift/<span class="mywbr"> &nbsp;</span>wraparound</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fx=</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx~3c%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fx&lt;</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx~3e%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fx&gt;</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx~3c~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fx&lt;=</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx~3e~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fx&gt;=</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxmin%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fxmin</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxmax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fxmax</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl%2B%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fl+</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl-%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fl-</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fl*</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl%2F%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fl/</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flabs%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>flabs</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fl=</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl~3c%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fl&lt;</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl~3e%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fl&gt;</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl~3c~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fl&lt;=</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl~3e~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fl&gt;=</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flmin%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>flmin</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flmax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>flmax</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flround%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>flround</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flfloor%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>flfloor</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flceiling%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>flceiling</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fltruncate%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fltruncate</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flsingle%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>flsingle</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flsin%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>flsin</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flcos%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>flcos</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fltan%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fltan</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flasin%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>flasin</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flacos%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>flacos</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flatan%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>flatan</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fllog%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fllog</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flexp%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>flexp</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flsqrt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>flsqrt</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flexpt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>flexpt</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-make-flrectangular%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>make-<wbr></wbr>flrectangular</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flreal-part%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>flreal-<wbr></wbr>part</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flimag-part%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>flimag-<wbr></wbr>part</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx-~3efl%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fx-<wbr></wbr>&gt;fl</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl-~3efx%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fl-<wbr></wbr>&gt;fx</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flrandom%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>flrandom</span></span></a></td></tr><tr><td><span class="tocsublinknumber">17.2<tt>&nbsp;</tt></span><a href="unsafe.html#%28part._.Unsafe_.Character_.Operations%29" class="tocsubseclink" data-pltdoc="x">Unsafe Character Operations</a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-char~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>char=?</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-char~3c~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>char&lt;?</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-char~3e~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>char&gt;?</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-char~3c~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>char&lt;=?</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-char~3e~3d~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>char&gt;=?</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-char-~3einteger%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>char-<wbr></wbr>&gt;integer</span></span></a></td></tr><tr><td><span class="tocsublinknumber">17.3<tt>&nbsp;</tt></span><a href="unsafe.html#%28part._.Unsafe._.Data._.Extraction%29" class="tocsubseclink" data-pltdoc="x">Unsafe Compound-<wbr></wbr>Data Operations</a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-car%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>car</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-cdr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>cdr</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mcar%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>mcar</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mcdr%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>mcdr</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-mcar%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>set-<wbr></wbr>mcar!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-mcdr%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>set-<wbr></wbr>mcdr!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-cons-list%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>cons-<wbr></wbr>list</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-list-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>list-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-list-tail%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>list-<wbr></wbr>tail</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-immutable-car%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>set-<wbr></wbr>immutable-<wbr></wbr>car!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-immutable-cdr%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>set-<wbr></wbr>immutable-<wbr></wbr>cdr!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-unbox%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>unbox</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-box%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>set-<wbr></wbr>box!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-unbox%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>unbox*</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-box%2A%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>set-<wbr></wbr>box*!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-box%2A-cas%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>box*-<wbr></wbr>cas!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector-length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>vector-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>vector-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>vector-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector%2A-length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>vector*-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector%2A-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>vector*-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector%2A-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>vector*-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector%2A-cas%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>vector*-<wbr></wbr>cas!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector%2A-~3eimmutable-vector%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>vector*-<wbr></wbr>&gt;immutable-<wbr></wbr>vector!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-string-length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>string-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-string-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>string-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-string-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>string-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-string-~3eimmutable-string%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>string-<wbr></wbr>&gt;immutable-<wbr></wbr>string!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-bytes-length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>bytes-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-bytes-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>bytes-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-bytes-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>bytes-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-bytes-copy%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>bytes-<wbr></wbr>copy!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-bytes-~3eimmutable-bytes%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>bytes-<wbr></wbr>&gt;immutable-<wbr></wbr>bytes!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxvector-length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fxvector-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxvector-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fxvector-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxvector-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fxvector-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flvector-length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>flvector-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flvector-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>flvector-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flvector-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>flvector-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-f64vector-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>f64vector-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-f64vector-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>f64vector-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-s16vector-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>s16vector-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-s16vector-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>s16vector-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-u16vector-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>u16vector-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-u16vector-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>u16vector-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-stencil-vector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>stencil-<wbr></wbr>vector</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-stencil-vector-mask%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>stencil-<wbr></wbr>vector-<wbr></wbr>mask</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-stencil-vector-length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>stencil-<wbr></wbr>vector-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-stencil-vector-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>stencil-<wbr></wbr>vector-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-stencil-vector-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>stencil-<wbr></wbr>vector-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-stencil-vector-update%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>stencil-<wbr></wbr>vector-<wbr></wbr>update</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-struct-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>struct-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-struct-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>struct-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-struct%2A-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>struct*-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-struct%2A-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>struct*-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-struct%2A-cas%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>struct*-<wbr></wbr>cas!</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-first%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>mutable-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>first</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-next%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>mutable-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>next</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-key%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>mutable-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>key</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-value%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>mutable-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>value</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-key%2Bvalue%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>mutable-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>key+<span class="mywbr"> &nbsp;</span>value</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-pair%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>mutable-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>pair</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-first%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>immutable-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>first</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-next%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>immutable-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>next</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-key%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>immutable-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>key</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-value%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>immutable-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>value</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-key%2Bvalue%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>immutable-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>key+<span class="mywbr"> &nbsp;</span>value</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-pair%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>immutable-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>pair</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-first%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>weak-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>first</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-next%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>weak-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>next</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-key%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>weak-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>key</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-value%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>weak-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>value</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-key%2Bvalue%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>weak-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>key+<span class="mywbr"> &nbsp;</span>value</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-pair%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>weak-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>pair</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-first%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>ephemeron-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>first</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-next%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>ephemeron-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>next</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-key%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>ephemeron-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>key</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-value%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>ephemeron-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>value</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-key%2Bvalue%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>ephemeron-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>key+<span class="mywbr"> &nbsp;</span>value</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-pair%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>ephemeron-<wbr></wbr>hash-<wbr></wbr>iterate-<wbr></wbr>pair</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-make-srcloc%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>make-<wbr></wbr>srcloc</span></span></a></td></tr><tr><td><span class="tocsublinknumber">17.4<tt>&nbsp;</tt></span><a href="unsafe.html#%28part._unsafeextfl%29" class="tocsubseclink" data-pltdoc="x">Unsafe Extflonum Operations</a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl%2B%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extfl+</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl-%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extfl-</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extfl*</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl%2F%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extfl/</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflabs%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extflabs</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extfl=</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl~3c%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extfl&lt;</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl~3e%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extfl&gt;</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl~3c~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extfl&lt;=</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl~3e~3d%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extfl&gt;=</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflmin%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extflmin</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflmax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extflmax</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflround%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extflround</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflfloor%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extflfloor</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflceiling%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extflceiling</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfltruncate%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extfltruncate</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflsin%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extflsin</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflcos%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extflcos</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfltan%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extfltan</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflasin%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extflasin</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflacos%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extflacos</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflatan%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extflatan</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfllog%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extfllog</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflexp%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extflexp</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflsqrt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extflsqrt</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflexpt%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extflexpt</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx-~3eextfl%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>fx-<wbr></wbr>&gt;extfl</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl-~3efx%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extfl-<wbr></wbr>&gt;fx</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflvector-length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extflvector-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflvector-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extflvector-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflvector-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>extflvector-<wbr></wbr>set!</span></span></a></td></tr><tr><td><span class="tocsublinknumber">17.5<tt>&nbsp;</tt></span><a href="unsafe.html#%28part._.Unsafe_.Impersonators_and_.Chaperones%29" class="tocsubseclink" data-pltdoc="x">Unsafe Impersonators and Chaperones</a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-impersonate-procedure%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>impersonate-<wbr></wbr>procedure</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-chaperone-procedure%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>chaperone-<wbr></wbr>procedure</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-impersonate-vector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>impersonate-<wbr></wbr>vector</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-chaperone-vector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>chaperone-<wbr></wbr>vector</span></span></a></td></tr><tr><td><span class="tocsublinknumber">17.6<tt>&nbsp;</tt></span><a href="unsafe.html#%28part._unsafeassert%29" class="tocsubseclink" data-pltdoc="x">Unsafe Assertions</a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-assert-unreachable%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>assert-<wbr></wbr>unreachable</span></span></a></td></tr><tr><td><span class="tocsublinknumber">17.7<tt>&nbsp;</tt></span><a href="unsafe.html#%28part._unsafe-undefined%29" class="tocsubseclink" data-pltdoc="x">Unsafe Undefined</a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._unsafe-undefined%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">unsafe-<wbr></wbr>undefined</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._check-not-unsafe-undefined%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">check-<wbr></wbr>not-<wbr></wbr>unsafe-<wbr></wbr>undefined</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._check-not-unsafe-undefined%2Fassign%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">check-<wbr></wbr>not-<wbr></wbr>unsafe-<wbr></wbr>undefined/<span class="mywbr"> &nbsp;</span>assign</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._chaperone-struct-unsafe-undefined%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">chaperone-<wbr></wbr>struct-<wbr></wbr>unsafe-<wbr></wbr>undefined</span></span></a></td></tr><tr><td><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._prop~3achaperone-unsafe-undefined%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">prop:<span class="mywbr"> &nbsp;</span>chaperone-<wbr></wbr>unsafe-<wbr></wbr>undefined</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="phantom-bytes.html" title="backward to &quot;16.5 Phantom Byte Strings&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="running.html" title="forward to &quot;18 Running Racket&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;unsafe&quot;">17<tt>&nbsp;</tt><a name="(part._unsafe)"></a><a name="(mod-path._racket/unsafe/ops)"></a>Unsafe Operations</h3><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="unsafe.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/unsafe/ops</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></p><p>All functions and forms provided by <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> and
+<a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> check their arguments to ensure that the
+arguments conform to contracts and other constraints. For example,
+<span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span> checks its arguments to ensure that the first
+argument is a vector, that the second argument is an exact integer,
+and that the second argument is between <span class="RktVal">0</span> and one less than
+the vector&rsquo;s length, inclusive.</p><p>Functions provided by <a href="unsafe.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/unsafe/ops</span></a> are
+<a name="(tech._unsafe)"></a><span style="font-style: italic">unsafe</span>. They have certain constraints, but the constraints
+are not checked, which allows the system to generate and execute
+faster code. If arguments violate an unsafe function&rsquo;s constraints,
+the function&rsquo;s behavior and result is unpredictable, and the entire
+system can crash or become corrupted.</p><p>All of the exported bindings of <a href="unsafe.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/unsafe/ops</span></a> are
+protected in the sense of <span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._protect-out%29%29" class="RktStxLink" data-pltdoc="x">protect-out</a></span>, so access to unsafe
+operations can be prevented by adjusting the code inspector (see
+<a href="modprotect.html" data-pltdoc="x">Code Inspectors</a>).</p><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Unsafe_Numeric_Operations&quot;">17.1<tt>&nbsp;</tt><a name="(part._.Unsafe_.Numeric_.Operations)"></a>Unsafe Numeric Operations</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fx+))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx%2B%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fx+</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fx-))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx-%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fx-</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fx*))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fx*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fxquotient))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxquotient%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fxquotient</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fxremainder))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxremainder%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fxremainder</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fxmodulo))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxmodulo%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fxmodulo</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fxabs))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxabs%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fxabs</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">For <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnums</span></a>: Unchecked versions of <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2B%29%29" class="RktValLink" data-pltdoc="x">fx+</a></span>, <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx-%29%29" class="RktValLink" data-pltdoc="x">fx-</a></span>,
+<span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2A%29%29" class="RktValLink" data-pltdoc="x">fx*</a></span>, <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxquotient%29%29" class="RktValLink" data-pltdoc="x">fxquotient</a></span>,
+<span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxremainder%29%29" class="RktValLink" data-pltdoc="x">fxremainder</a></span>, <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxmodulo%29%29" class="RktValLink" data-pltdoc="x">fxmodulo</a></span>, and
+<span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxabs%29%29" class="RktValLink" data-pltdoc="x">fxabs</a></span>.</div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow zero or more arguments for <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx%2B%29%29" class="RktValLink" data-pltdoc="x">unsafe-fx+</a></span> and <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx%2A%29%29" class="RktValLink" data-pltdoc="x">unsafe-fx*</a></span>
+and allow one or more arguments for <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx-%29%29" class="RktValLink" data-pltdoc="x">unsafe-fx-</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fxand))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxand%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fxand</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fxior))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxior%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fxior</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fxxor))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxxor%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fxxor</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fxnot))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxnot%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fxnot</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fxlshift))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxlshift%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fxlshift</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fxrshift))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxrshift%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fxrshift</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">For <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnums</span></a>: Unchecked versions of <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxand%29%29" class="RktValLink" data-pltdoc="x">fxand</a></span>, <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxior%29%29" class="RktValLink" data-pltdoc="x">fxior</a></span>, <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxxor%29%29" class="RktValLink" data-pltdoc="x">fxxor</a></span>,
+<span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxnot%29%29" class="RktValLink" data-pltdoc="x">fxnot</a></span>, <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxlshift%29%29" class="RktValLink" data-pltdoc="x">fxlshift</a></span>, and <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxrshift%29%29" class="RktValLink" data-pltdoc="x">fxrshift</a></span>.</div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow zero or more arguments for
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxand%29%29" class="RktValLink" data-pltdoc="x">unsafe-fxand</a></span>, <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxior%29%29" class="RktValLink" data-pltdoc="x">unsafe-fxior</a></span>,
+and <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxxor%29%29" class="RktValLink" data-pltdoc="x">unsafe-fxxor</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fxpopcount))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxpopcount%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fxpopcount</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._negative~3f%29%29" class="RktValLink" data-pltdoc="x">negative?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fxpopcount32))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxpopcount32%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fxpopcount32</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">#xFFFFFFFF</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fxpopcount16))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxpopcount16%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fxpopcount16</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">#xFFFF</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">For <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnums</span></a>: Unchecked versions of <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxpopcount%29%29" class="RktValLink" data-pltdoc="x">fxpopcount</a></span>,
+<span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxpopcount32%29%29" class="RktValLink" data-pltdoc="x">fxpopcount32</a></span>, and <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxpopcount16%29%29" class="RktValLink" data-pltdoc="x">fxpopcount16</a></span>.</div></p><p class="SHistory">Added in version 8.5.0.6 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fx+/wraparound))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx%2B%2Fwraparound%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fx+/wraparound</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fx-/wraparound))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx-%2Fwraparound%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fx-/wraparound</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fx*/wraparound))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx%2A%2Fwraparound%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fx*/wraparound</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fxlshift/wraparound))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxlshift%2Fwraparound%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fxlshift/wraparound</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">For <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnums</span></a>: Unchecked versions of <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2B%2Fwraparound%29%29" class="RktValLink" data-pltdoc="x">fx+/wraparound</a></span>,
+<span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx-%2Fwraparound%29%29" class="RktValLink" data-pltdoc="x">fx-/wraparound</a></span>, <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx%2A%2Fwraparound%29%29" class="RktValLink" data-pltdoc="x">fx*/wraparound</a></span>, and
+<span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxlshift%2Fwraparound%29%29" class="RktValLink" data-pltdoc="x">fxlshift/wraparound</a></span>.</div></p><p class="SHistory">Added in version 7.9.0.6 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fx~3d))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx~3d%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fx=</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fx~3c))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx~3c%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fx&lt;</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fx~3e))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx~3e%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fx&gt;</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fx~3c~3d))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx~3c~3d%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fx&lt;=</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fx~3e~3d))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx~3e~3d%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fx&gt;=</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fxmin))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxmin%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fxmin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fxmax))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxmax%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fxmax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">For <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnums</span></a>: Unchecked versions of <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx~3d%29%29" class="RktValLink" data-pltdoc="x">fx=</a></span>, <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx~3c%29%29" class="RktValLink" data-pltdoc="x">fx&lt;</a></span>,
+ <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx~3e%29%29" class="RktValLink" data-pltdoc="x">fx&gt;</a></span>, <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx~3c~3d%29%29" class="RktValLink" data-pltdoc="x">fx&lt;=</a></span>, <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx~3e~3d%29%29" class="RktValLink" data-pltdoc="x">fx&gt;=</a></span>,
+ <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxmin%29%29" class="RktValLink" data-pltdoc="x">fxmin</a></span>, and <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxmax%29%29" class="RktValLink" data-pltdoc="x">fxmax</a></span>.</div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one or more argument,
+instead of allowing just two.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fl+))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl%2B%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fl+</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fl-))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl-%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fl-</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fl*))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fl*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fl/))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl%2F%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fl/</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-flabs))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flabs%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-flabs</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">For <a href="numbers.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonums</span></a>: Unchecked versions of <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2B%29%29" class="RktValLink" data-pltdoc="x">fl+</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl-%29%29" class="RktValLink" data-pltdoc="x">fl-</a></span>,
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2A%29%29" class="RktValLink" data-pltdoc="x">fl*</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl%2F%29%29" class="RktValLink" data-pltdoc="x">fl/</a></span>, and <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flabs%29%29" class="RktValLink" data-pltdoc="x">flabs</a></span>.</div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow zero or more arguments for <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl%2B%29%29" class="RktValLink" data-pltdoc="x">unsafe-fl+</a></span> and <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl%2A%29%29" class="RktValLink" data-pltdoc="x">unsafe-fl*</a></span>
+and one or more arguments for <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl-%29%29" class="RktValLink" data-pltdoc="x">unsafe-fl-</a></span> and <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl%2F%29%29" class="RktValLink" data-pltdoc="x">unsafe-fl/</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fl~3d))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl~3d%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fl=</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fl~3c))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl~3c%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fl&lt;</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fl~3e))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl~3e%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fl&gt;</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fl~3c~3d))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl~3c~3d%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fl&lt;=</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fl~3e~3d))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl~3e~3d%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fl&gt;=</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-flmin))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flmin%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-flmin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-flmax))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flmax%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-flmax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">For <a href="numbers.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonums</span></a>: Unchecked versions of <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3d%29%29" class="RktValLink" data-pltdoc="x">fl=</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3c%29%29" class="RktValLink" data-pltdoc="x">fl&lt;</a></span>,
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3e%29%29" class="RktValLink" data-pltdoc="x">fl&gt;</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3c~3d%29%29" class="RktValLink" data-pltdoc="x">fl&lt;=</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fl~3e~3d%29%29" class="RktValLink" data-pltdoc="x">fl&gt;=</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flmin%29%29" class="RktValLink" data-pltdoc="x">flmin</a></span>, and
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flmax%29%29" class="RktValLink" data-pltdoc="x">flmax</a></span>.</div></p><p class="SHistory">Changed in version 7.0.0.13 of package <span class="stt">base</span>: Allow one or more argument,
+instead of allowing just two.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-flround))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flround%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-flround</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-flfloor))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flfloor%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-flfloor</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-flceiling))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flceiling%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-flceiling</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fltruncate))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fltruncate%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fltruncate</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">For <a href="numbers.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonums</span></a>: Unchecked (potentially) versions of
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flround%29%29" class="RktValLink" data-pltdoc="x">flround</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flfloor%29%29" class="RktValLink" data-pltdoc="x">flfloor</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flceiling%29%29" class="RktValLink" data-pltdoc="x">flceiling</a></span>, and
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fltruncate%29%29" class="RktValLink" data-pltdoc="x">fltruncate</a></span>. Currently, these bindings are simply aliases for
+the corresponding safe bindings.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-flsingle))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flsingle%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-flsingle</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">For <a href="numbers.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonums</span></a>: Unchecked (potentially) version of
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flsingle%29%29" class="RktValLink" data-pltdoc="x">flsingle</a></span>.</div></p><p class="SHistory">Added in version 7.8.0.7 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-flsin))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flsin%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-flsin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-flcos))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flcos%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-flcos</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fltan))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fltan%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fltan</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-flasin))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flasin%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-flasin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-flacos))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flacos%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-flacos</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-flatan))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flatan%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-flatan</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fllog))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fllog%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fllog</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-flexp))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flexp%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-flexp</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-flsqrt))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flsqrt%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-flsqrt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-flexpt))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flexpt%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-flexpt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">For <a href="numbers.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonums</span></a>: Unchecked (potentially) versions of
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flsin%29%29" class="RktValLink" data-pltdoc="x">flsin</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flcos%29%29" class="RktValLink" data-pltdoc="x">flcos</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fltan%29%29" class="RktValLink" data-pltdoc="x">fltan</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flasin%29%29" class="RktValLink" data-pltdoc="x">flasin</a></span>,
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flacos%29%29" class="RktValLink" data-pltdoc="x">flacos</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flatan%29%29" class="RktValLink" data-pltdoc="x">flatan</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._fllog%29%29" class="RktValLink" data-pltdoc="x">fllog</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flexp%29%29" class="RktValLink" data-pltdoc="x">flexp</a></span>,
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flsqrt%29%29" class="RktValLink" data-pltdoc="x">flsqrt</a></span>, and <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flexpt%29%29" class="RktValLink" data-pltdoc="x">flexpt</a></span>. Currently, some of these
+bindings are simply aliases for the corresponding safe bindings.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-make-flrectangular))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-make-flrectangular%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-make-flrectangular</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._complex~3f%29%29" class="RktValLink" data-pltdoc="x">complex?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._real-part%29%29" class="RktValLink" data-pltdoc="x">real-part</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._imag-part%29%29" class="RktValLink" data-pltdoc="x">imag-part</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-flreal-part))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flreal-part%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-flreal-part</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">a</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._complex~3f%29%29" class="RktValLink" data-pltdoc="x">complex?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._real-part%29%29" class="RktValLink" data-pltdoc="x">real-part</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._imag-part%29%29" class="RktValLink" data-pltdoc="x">imag-part</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-flimag-part))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flimag-part%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-flimag-part</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace">&nbsp;&nbsp;</span></td><td valign="top"><span class="RktVar">a</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">:</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._complex~3f%29%29" class="RktValLink" data-pltdoc="x">complex?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._real-part%29%29" class="RktValLink" data-pltdoc="x">real-part</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._imag-part%29%29" class="RktValLink" data-pltdoc="x">imag-part</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">For <a href="numbers.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonums</span></a>: Unchecked versions of <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._make-flrectangular%29%29" class="RktValLink" data-pltdoc="x">make-flrectangular</a></span>,
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flreal-part%29%29" class="RktValLink" data-pltdoc="x">flreal-part</a></span>, and <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flimag-part%29%29" class="RktValLink" data-pltdoc="x">flimag-part</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fx-~3efl))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx-~3efl%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fx-&gt;fl</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fl-~3efx))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl-~3efx%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fl-&gt;fx</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unchecked versions of <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fx-~3efl%29%29" class="RktValLink" data-pltdoc="x">fx-&gt;fl</a></span> and <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fl-~3efx%29%29" class="RktValLink" data-pltdoc="x">fl-&gt;fx</a></span>.</div></p><p class="SHistory">Changed in version 7.7.0.8 of package <span class="stt">base</span>: Changed <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl-~3efx%29%29" class="RktValLink" data-pltdoc="x">unsafe-fl-&gt;fx</a></span> to truncate.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-flrandom))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flrandom%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-flrandom</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">rand-gen</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._and%29%29" class="RktStxLink" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3e%2Fc%29%29" class="RktValLink" data-pltdoc="x">&gt;/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._~3c%2Fc%29%29" class="RktValLink" data-pltdoc="x">&lt;/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">rand-gen</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._pseudo-random-generator~3f%29%29" class="RktValLink" data-pltdoc="x">pseudo-random-generator?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Unchecked version of <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flrandom%29%29" class="RktValLink" data-pltdoc="x">flrandom</a></span>.</div></p><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Unsafe_Character_Operations&quot;">17.2<tt>&nbsp;</tt><a name="(part._.Unsafe_.Character_.Operations)"></a>Unsafe Character Operations</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-char~3d~3f))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-char~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-char=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-char~3c~3f))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-char~3c~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-char&lt;?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-char~3e~3f))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-char~3e~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-char&gt;?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-char~3c~3d~3f))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-char~3c~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-char&lt;=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-char~3e~3d~3f))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-char~3e~3d~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-char&gt;=?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-char-~3einteger))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-char-~3einteger%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-char-&gt;integer</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unchecked versions of <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3d~3f%29%29" class="RktValLink" data-pltdoc="x">char=?</a></span>, <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3c~3f%29%29" class="RktValLink" data-pltdoc="x">char&lt;?</a></span>, <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3e~3f%29%29" class="RktValLink" data-pltdoc="x">char&gt;?</a></span>,
+<span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3c~3d~3f%29%29" class="RktValLink" data-pltdoc="x">char&lt;=?</a></span>, <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3e~3d~3f%29%29" class="RktValLink" data-pltdoc="x">char&gt;=?</a></span>, and <span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-~3einteger%29%29" class="RktValLink" data-pltdoc="x">char-&gt;integer</a></span>.</div></p><p class="SHistory">Added in version 7.0.0.14 of package <span class="stt">base</span>.</p><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Unsafe Data Extraction&quot;">17.3<tt>&nbsp;</tt><a name="(part._.Unsafe._.Data._.Extraction)"></a>Unsafe Compound-Data Operations</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-car))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-car%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-car</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-cdr))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-cdr%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-cdr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-mcar))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mcar%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-mcar</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mpair~3f%29%29" class="RktValLink" data-pltdoc="x">mpair?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-mcdr))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mcdr%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-mcdr</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mpair~3f%29%29" class="RktValLink" data-pltdoc="x">mpair?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-set-mcar!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-mcar%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-set-mcar!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mpair~3f%29%29" class="RktValLink" data-pltdoc="x">mpair?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-set-mcdr!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-mcdr%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-set-mcdr!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mpair~3f%29%29" class="RktValLink" data-pltdoc="x">mpair?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unsafe variants of <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span>, <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span>, <span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcar%29%29" class="RktValLink" data-pltdoc="x">mcar</a></span>,
+<span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._mcdr%29%29" class="RktValLink" data-pltdoc="x">mcdr</a></span>, <span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._set-mcar%21%29%29" class="RktValLink" data-pltdoc="x">set-mcar!</a></span>, and <span class="RktSym"><a href="mpairs.html#%28def._%28%28quote._~23~25kernel%29._set-mcdr%21%29%29" class="RktValLink" data-pltdoc="x">set-mcdr!</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-cons-list))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-cons-list%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-cons-list</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">rest</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">rest</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Unsafe variant of <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span> that produces a pair that claims to be
+a list&#8212;<wbr></wbr>without checking whether <span class="RktVar">rest</span> is a list.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-list-ref))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-list-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-list-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-list-tail))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-list-tail%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-list-tail</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unsafe variants of <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list-ref%29%29" class="RktValLink" data-pltdoc="x">list-ref</a></span> and <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list-tail%29%29" class="RktValLink" data-pltdoc="x">list-tail</a></span>, where
+<span class="RktVar">pos</span> must be a <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a>, and <span class="RktVar">lst</span> must start with
+at least <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="stt"> </span><span class="RktVar">pos</span><span class="RktPn">)</span> (for <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-list-ref%29%29" class="RktValLink" data-pltdoc="x">unsafe-list-ref</a></span>) or
+<span class="RktVar">pos</span> (for <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-list-tail%29%29" class="RktValLink" data-pltdoc="x">unsafe-list-tail</a></span>) pairs.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-set-immutable-car!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-immutable-car%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-set-immutable-car!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-set-immutable-cdr!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-immutable-cdr%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-set-immutable-cdr!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">p</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">As their oxymoronic names should suggest, there is <span class="emph">no generally
+correct way</span> to use these functions. They may be useful nevertheless,
+as a last resort, in settings where pairs are used in a constrained
+way and when making correct assumptions about Racket&rsquo;s implementation
+(including limits on the compiler&rsquo;s optimizations).</div></p><p>Some pitfalls of using <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-immutable-car%21%29%29" class="RktValLink" data-pltdoc="x">unsafe-set-immutable-car!</a></span> and
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-immutable-cdr%21%29%29" class="RktValLink" data-pltdoc="x">unsafe-set-immutable-cdr!</a></span>:</p><ul><li><p>Functions that consume a pair may take advantage of
+immutability, such as computing a list&rsquo;s length once and
+expecting the list to retain that length, or checking a list
+against a contract and expecting the contract to hold
+thereafter.</p></li><li><p>The result of <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span> for a pair may be cached
+internally, so that changing the <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> of a pair from a
+list to a non-list or vice versa may cause <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span> to
+produce the wrong value&#8212;<wbr></wbr>for the mutated pair or for another
+pair that reaches the mutated pair.</p></li><li><p>The compiler may reorder or even optimize away a call to
+<span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> or <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span> on the grounds that pairs are
+immutable, in which case a <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-immutable-car%21%29%29" class="RktValLink" data-pltdoc="x">unsafe-set-immutable-car!</a></span>
+or <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-immutable-cdr%21%29%29" class="RktValLink" data-pltdoc="x">unsafe-set-immutable-cdr!</a></span> may not have an effect on
+the use of <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span> or <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cdr%29%29" class="RktValLink" data-pltdoc="x">cdr</a></span>.</p></li></ul><p class="SHistory">Added in version 7.9.0.18 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-unbox))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-unbox%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-unbox</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="RktValLink" data-pltdoc="x">box?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-set-box!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-box%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-set-box!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="RktValLink" data-pltdoc="x">box?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-unbox*))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-unbox%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-unbox*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="RktValLink" data-pltdoc="x">box?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-set-box*!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-box%2A%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-set-box*!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="RktValLink" data-pltdoc="x">box?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unsafe versions of <span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._unbox%29%29" class="RktValLink" data-pltdoc="x">unbox</a></span> and <span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._set-box%21%29%29" class="RktValLink" data-pltdoc="x">set-box!</a></span>, where the
+<span class="RktSym">box*</span> variants can be faster but do not work on
+<a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonators</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-box*-cas!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-box%2A-cas%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-box*-cas!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">loc</span><span class="hspace">&nbsp;</span><span class="RktVar">old</span><span class="hspace">&nbsp;</span><span class="RktVar">new</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">loc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box~3f%29%29" class="RktValLink" data-pltdoc="x">box?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">old</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">new</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Unsafe version of <span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box-cas%21%29%29" class="RktValLink" data-pltdoc="x">box-cas!</a></span>.  Like <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-set-box%2A%21%29%29" class="RktValLink" data-pltdoc="x">unsafe-set-box*!</a></span>, it does
+not work on <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonators</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-vector-length))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-vector-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-vector-ref))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-vector-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-vector-set!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-vector-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-vector*-length))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector%2A-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-vector*-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-vector*-ref))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector%2A-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-vector*-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-vector*-set!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector%2A-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-vector*-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-vector*-cas!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector%2A-cas%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-vector*-cas!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">old-val</span><span class="hspace">&nbsp;</span><span class="RktVar">new-val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">old-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">new-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unsafe versions of <span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="RktValLink" data-pltdoc="x">vector-length</a></span>, <span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span>,
+<span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="RktValLink" data-pltdoc="x">vector-set!</a></span>, and <span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-cas%21%29%29" class="RktValLink" data-pltdoc="x">vector-cas!</a></span>, where the <span class="RktSym">vector*</span> variants can be
+faster but do not work on <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonators</span></a>.</div></p><p>A vector&rsquo;s size can never be larger than a <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a>, so even
+<span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="RktValLink" data-pltdoc="x">vector-length</a></span> always returns a fixnum.</p><p class="SHistory">Changed in version 6.11.0.2 of package <span class="stt">base</span>: Added <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector%2A-cas%21%29%29" class="RktValLink" data-pltdoc="x">unsafe-vector*-cas!</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-vector*-~3eimmutable-vector!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector%2A-~3eimmutable-vector%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-vector*-&gt;immutable-vector!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-~3eimmutable-vector%29%29" class="RktValLink" data-pltdoc="x">vector-&gt;immutable-vector</a></span>, but potentially destroys
+<span class="RktVar">v</span> and reuses it space, so <span class="RktVar">v</span> must not be used after
+calling <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-vector%2A-~3eimmutable-vector%21%29%29" class="RktValLink" data-pltdoc="x">unsafe-vector*-&gt;immutable-vector!</a></span>.</div></p><p class="SHistory">Added in version 7.7.0.6 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-string-length))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-string-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-string-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-string-ref))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-string-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-string-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">ch</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c~3d%29%29" class="RktValLink" data-pltdoc="x">&lt;=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char-~3einteger%29%29" class="RktValLink" data-pltdoc="x">char-&gt;integer</a></span><span class="hspace">&nbsp;</span><span class="RktVar">ch</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">255</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-string-set!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-string-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-string-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">ch</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">ch</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="characters.html#%28def._%28%28quote._~23~25kernel%29._char~3f%29%29" class="RktValLink" data-pltdoc="x">char?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unsafe versions of <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="RktValLink" data-pltdoc="x">string-length</a></span>, <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-ref%29%29" class="RktValLink" data-pltdoc="x">string-ref</a></span>, and
+<span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-set%21%29%29" class="RktValLink" data-pltdoc="x">string-set!</a></span>. The <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-string-ref%29%29" class="RktValLink" data-pltdoc="x">unsafe-string-ref</a></span> procedure can be used
+only when the result will be a Latin-1 character. A string&rsquo;s size can
+never be larger than a <a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a> (so even <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-length%29%29" class="RktValLink" data-pltdoc="x">string-length</a></span>
+always returns a fixnum).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-string-~3eimmutable-string!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-string-~3eimmutable-string%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-string-&gt;immutable-string!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">str</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">str</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string~3f%29%29" class="RktValLink" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="strings.html#%28def._%28%28quote._~23~25kernel%29._string-~3eimmutable-string%29%29" class="RktValLink" data-pltdoc="x">string-&gt;immutable-string</a></span>, but potentially destroys
+<span class="RktVar">str</span> and reuses it space, so <span class="RktVar">str</span> must not be used
+after calling <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-string-~3eimmutable-string%21%29%29" class="RktValLink" data-pltdoc="x">unsafe-string-&gt;immutable-string!</a></span>.</div></p><p class="SHistory">Added in version 7.7.0.6 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-bytes-length))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-bytes-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-bytes-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-bytes-ref))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-bytes-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-bytes-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-bytes-set!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-bytes-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-bytes-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._byte~3f%29%29" class="RktValLink" data-pltdoc="x">byte?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-bytes-copy!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-bytes-copy%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-bytes-copy!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">dest</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">dest-start</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">src</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">src-start</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">src-end</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dest</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dest-start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src-start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src-end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">src</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unsafe versions of <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span>, <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-ref%29%29" class="RktValLink" data-pltdoc="x">bytes-ref</a></span>,
+<span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-set%21%29%29" class="RktValLink" data-pltdoc="x">bytes-set!</a></span>, and <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-copy%21%29%29" class="RktValLink" data-pltdoc="x">bytes-copy!</a></span>.
+A bytes&rsquo;s size can never be larger than a
+<a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a> (so even <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-length%29%29" class="RktValLink" data-pltdoc="x">bytes-length</a></span> always returns a
+fixnum).</div></p><p class="SHistory">Changed in version 7.5.0.15 of package <span class="stt">base</span>: Added <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-bytes-copy%21%29%29" class="RktValLink" data-pltdoc="x">unsafe-bytes-copy!</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-bytes-~3eimmutable-bytes!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-bytes-~3eimmutable-bytes%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-bytes-&gt;immutable-bytes!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">bstr</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bstr</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes~3f%29%29" class="RktValLink" data-pltdoc="x">bytes?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Similar to <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3eimmutable-bytes%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;immutable-bytes</a></span>, but potentially destroys
+<span class="RktVar">bstr</span> and reuses it space, so <span class="RktVar">bstr</span> must not be used
+after calling <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-bytes-~3eimmutable-bytes%21%29%29" class="RktValLink" data-pltdoc="x">unsafe-bytes-&gt;immutable-bytes!</a></span>.</div></p><p class="SHistory">Added in version 7.7.0.6 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fxvector-length))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxvector-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fxvector-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector~3f%29%29" class="RktValLink" data-pltdoc="x">fxvector?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fxvector-ref))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxvector-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fxvector-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector~3f%29%29" class="RktValLink" data-pltdoc="x">fxvector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fxvector-set!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fxvector-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fxvector-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector~3f%29%29" class="RktValLink" data-pltdoc="x">fxvector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unsafe versions of <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector-length%29%29" class="RktValLink" data-pltdoc="x">fxvector-length</a></span>, <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector-ref%29%29" class="RktValLink" data-pltdoc="x">fxvector-ref</a></span>, and
+<span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector-set%21%29%29" class="RktValLink" data-pltdoc="x">fxvector-set!</a></span>. A <a href="fixnums.html#%28tech._fxvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">fxvector</span></a>&rsquo;s size can never be larger than a
+<a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a> (so even <span class="RktSym"><a href="fixnums.html#%28def._%28%28lib._racket%2Ffixnum..rkt%29._fxvector-length%29%29" class="RktValLink" data-pltdoc="x">fxvector-length</a></span> always returns a
+fixnum).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-flvector-length))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flvector-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-flvector-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector~3f%29%29" class="RktValLink" data-pltdoc="x">flvector?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-flvector-ref))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flvector-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-flvector-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector~3f%29%29" class="RktValLink" data-pltdoc="x">flvector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-flvector-set!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-flvector-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-flvector-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector~3f%29%29" class="RktValLink" data-pltdoc="x">flvector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unsafe versions of <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector-length%29%29" class="RktValLink" data-pltdoc="x">flvector-length</a></span>, <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector-ref%29%29" class="RktValLink" data-pltdoc="x">flvector-ref</a></span>, and
+<span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector-set%21%29%29" class="RktValLink" data-pltdoc="x">flvector-set!</a></span>. A <a href="flonums.html#%28tech._flvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">flvector</span></a>&rsquo;s size can never be larger than a
+<a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a> (so even <span class="RktSym"><a href="flonums.html#%28def._%28%28lib._racket%2Fflonum..rkt%29._flvector-length%29%29" class="RktValLink" data-pltdoc="x">flvector-length</a></span> always returns a
+fixnum).</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-f64vector-ref))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-f64vector-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-f64vector-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=homogeneous-vectors.html%23%2528def._%2528%2528lib._ffi%252Fvector..rkt%2529._f64vector%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">f64vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-f64vector-set!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-f64vector-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-f64vector-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=homogeneous-vectors.html%23%2528def._%2528%2528lib._ffi%252Fvector..rkt%2529._f64vector%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">f64vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._flonum~3f%29%29" class="RktValLink" data-pltdoc="x">flonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unsafe versions of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=homogeneous-vectors.html%23%2528def._%2528%2528lib._ffi%252Fvector..rkt%2529._f64vector-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">f64vector-ref</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=homogeneous-vectors.html%23%2528def._%2528%2528lib._ffi%252Fvector..rkt%2529._f64vector-set%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">f64vector-set!</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-s16vector-ref))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-s16vector-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-s16vector-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-3</span>2768</span><span class="hspace">&nbsp;</span><span class="RktVal">32767</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=homogeneous-vectors.html%23%2528def._%2528%2528lib._ffi%252Fvector..rkt%2529._s16vector%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">s16vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-s16vector-set!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-s16vector-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-s16vector-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=homogeneous-vectors.html%23%2528def._%2528%2528lib._ffi%252Fvector..rkt%2529._s16vector%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">s16vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-3</span>2768</span><span class="hspace">&nbsp;</span><span class="RktVal">32767</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unsafe versions of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=homogeneous-vectors.html%23%2528def._%2528%2528lib._ffi%252Fvector..rkt%2529._s16vector-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">s16vector-ref</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=homogeneous-vectors.html%23%2528def._%2528%2528lib._ffi%252Fvector..rkt%2529._s16vector-set%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">s16vector-set!</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-u16vector-ref))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-u16vector-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-u16vector-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">65535</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=homogeneous-vectors.html%23%2528def._%2528%2528lib._ffi%252Fvector..rkt%2529._u16vector%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">u16vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-u16vector-set!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-u16vector-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-u16vector-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=homogeneous-vectors.html%23%2528def._%2528%2528lib._ffi%252Fvector..rkt%2529._u16vector%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">u16vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">65535</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unsafe versions of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=homogeneous-vectors.html%23%2528def._%2528%2528lib._ffi%252Fvector..rkt%2529._u16vector-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">u16vector-ref</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=homogeneous-vectors.html%23%2528def._%2528%2528lib._ffi%252Fvector..rkt%2529._u16vector-set%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">u16vector-set!</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-stencil-vector))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-stencil-vector%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-stencil-vector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">mask</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector~3f%29%29" class="RktValLink" data-pltdoc="x">stencil-vector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">mask</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-mask-width%29%29" class="RktValLink" data-pltdoc="x">stencil-vector-mask-width</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-stencil-vector-mask))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-stencil-vector-mask%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-stencil-vector-mask</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-mask-width%29%29" class="RktValLink" data-pltdoc="x">stencil-vector-mask-width</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector~3f%29%29" class="RktValLink" data-pltdoc="x">stencil-vector?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-stencil-vector-length))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-stencil-vector-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-stencil-vector-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-mask-width%29%29" class="RktValLink" data-pltdoc="x">stencil-vector-mask-width</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector~3f%29%29" class="RktValLink" data-pltdoc="x">stencil-vector?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-stencil-vector-ref))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-stencil-vector-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-stencil-vector-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector~3f%29%29" class="RktValLink" data-pltdoc="x">stencil-vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-stencil-vector-set!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-stencil-vector-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-stencil-vector-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym">avoid?</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector~3f%29%29" class="RktValLink" data-pltdoc="x">stencil-vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-stencil-vector-update))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-stencil-vector-update%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-stencil-vector-update</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">vec</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">remove-mask</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">add-mask</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector~3f%29%29" class="RktValLink" data-pltdoc="x">stencil-vector?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector~3f%29%29" class="RktValLink" data-pltdoc="x">stencil-vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">remove-mask</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-mask-width%29%29" class="RktValLink" data-pltdoc="x">stencil-vector-mask-width</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">add-mask</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._integer-in%29%29" class="RktValLink" data-pltdoc="x">integer-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._expt%29%29" class="RktValLink" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-mask-width%29%29" class="RktValLink" data-pltdoc="x">stencil-vector-mask-width</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unsafe variants of <span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector%29%29" class="RktValLink" data-pltdoc="x">stencil-vector</a></span>, <span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-mask%29%29" class="RktValLink" data-pltdoc="x">stencil-vector-mask</a></span>, <span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-length%29%29" class="RktValLink" data-pltdoc="x">stencil-vector-length</a></span>,
+<span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-ref%29%29" class="RktValLink" data-pltdoc="x">stencil-vector-ref</a></span>, <span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-set%21%29%29" class="RktValLink" data-pltdoc="x">stencil-vector-set!</a></span>,
+and <span class="RktSym"><a href="stencil_vectors.html#%28def._%28%28quote._~23~25kernel%29._stencil-vector-update%29%29" class="RktValLink" data-pltdoc="x">stencil-vector-update</a></span>.</div></p><p class="SHistory">Added in version 8.5.0.7 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-struct-ref))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-struct-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-struct-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-struct-set!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-struct-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-struct-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-struct*-ref))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-struct%2A-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-struct*-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-struct*-set!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-struct%2A-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-struct*-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-struct*-cas!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-struct%2A-cas%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-struct*-cas!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">old-val</span><span class="hspace">&nbsp;</span><span class="RktVar">new-val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">old-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">new-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unsafe field access and update for an instance of a structure
+type, where the <span class="RktSym">struct*</span> variants can be
+faster but do not work on <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonators</span></a>.
+The index <span class="RktVar">k</span> must be between <span class="RktVal">0</span> (inclusive) and
+the number of fields in the structure (exclusive). In the case of
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-struct-set%21%29%29" class="RktValLink" data-pltdoc="x">unsafe-struct-set!</a></span>, <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-struct%2A-set%21%29%29" class="RktValLink" data-pltdoc="x">unsafe-struct*-set!</a></span>, and <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-struct%2A-cas%21%29%29" class="RktValLink" data-pltdoc="x">unsafe-struct*-cas!</a></span>, the
+field must be mutable. The <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-struct%2A-cas%21%29%29" class="RktValLink" data-pltdoc="x">unsafe-struct*-cas!</a></span> operation
+is analogous to <span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box-cas%21%29%29" class="RktValLink" data-pltdoc="x">box-cas!</a></span> to perform an atomic compare-and-set.</div></p><p class="SHistory">Changed in version 6.11.0.2 of package <span class="stt">base</span>: Added <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-struct%2A-cas%21%29%29" class="RktValLink" data-pltdoc="x">unsafe-struct*-cas!</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-mutable-hash-iterate-first))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-first%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-mutable-hash-iterate-first</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-mutable-hash-iterate-next))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-next%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-mutable-hash-iterate-next</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-mutable-hash-iterate-key))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-key%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-mutable-hash-iterate-key</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-key%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-mutable-hash-iterate-key</a></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bad-index-v</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-mutable-hash-iterate-value))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-mutable-hash-iterate-value</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-mutable-hash-iterate-value</a></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bad-index-v</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-mutable-hash-iterate-key+value))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-key%2Bvalue%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-mutable-hash-iterate-key+value</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-key%2Bvalue%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-mutable-hash-iterate-key+value</a></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bad-index-v</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-mutable-hash-iterate-pair))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-pair%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-mutable-hash-iterate-pair</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-mutable-hash-iterate-pair%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-mutable-hash-iterate-pair</a></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bad-index-v</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-strong~3f%29%29" class="RktValLink" data-pltdoc="x">hash-strong?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-immutable-hash-iterate-first))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-first%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-immutable-hash-iterate-first</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-immutable-hash-iterate-next))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-next%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-immutable-hash-iterate-next</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-immutable-hash-iterate-key))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-key%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-immutable-hash-iterate-key</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-key%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-immutable-hash-iterate-key</a></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bad-index-v</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-immutable-hash-iterate-value))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-immutable-hash-iterate-value</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-immutable-hash-iterate-value</a></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bad-index-v</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-immutable-hash-iterate-key+value))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-key%2Bvalue%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-immutable-hash-iterate-key+value</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-key%2Bvalue%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-immutable-hash-iterate-key+value</a></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bad-index-v</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-immutable-hash-iterate-pair))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-pair%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-immutable-hash-iterate-pair</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-immutable-hash-iterate-pair%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-immutable-hash-iterate-pair</a></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bad-index-v</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-weak-hash-iterate-first))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-first%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-weak-hash-iterate-first</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-weak-hash-iterate-next))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-next%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-weak-hash-iterate-next</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-weak-hash-iterate-key))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-key%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-weak-hash-iterate-key</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-key%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-weak-hash-iterate-key</a></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bad-index-v</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-weak-hash-iterate-value))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-weak-hash-iterate-value</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-weak-hash-iterate-value</a></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bad-index-v</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-weak-hash-iterate-key+value))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-key%2Bvalue%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-weak-hash-iterate-key+value</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-key%2Bvalue%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-weak-hash-iterate-key+value</a></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bad-index-v</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-weak-hash-iterate-pair))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-pair%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-weak-hash-iterate-pair</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-weak-hash-iterate-pair%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-weak-hash-iterate-pair</a></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bad-index-v</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-weak~3f%29%29" class="RktValLink" data-pltdoc="x">hash-weak?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-ephemeron-hash-iterate-first))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-first%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-ephemeron-hash-iterate-first</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">hash</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-ephemeron-hash-iterate-next))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-next%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-ephemeron-hash-iterate-next</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-ephemeron-hash-iterate-key))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-key%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-ephemeron-hash-iterate-key</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-key%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-ephemeron-hash-iterate-key</a></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bad-index-v</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-ephemeron-hash-iterate-value))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-ephemeron-hash-iterate-value</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-ephemeron-hash-iterate-value</a></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bad-index-v</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-ephemeron-hash-iterate-key+value))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-key%2Bvalue%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-ephemeron-hash-iterate-key+value</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-key%2Bvalue%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-ephemeron-hash-iterate-key+value</a></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bad-index-v</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-ephemeron-hash-iterate-pair))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-pair%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-ephemeron-hash-iterate-pair</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-ephemeron-hash-iterate-pair%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-ephemeron-hash-iterate-pair</a></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">hash</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">pos</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">bad-index-v</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">hash</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash~3f%29%29" class="RktValLink" data-pltdoc="x">hash?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-ephemeron~3f%29%29" class="RktValLink" data-pltdoc="x">hash-ephemeron?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">bad-index-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unsafe versions of <span class="RktSym"><a href="hashtables.html#%28def._%28%28quote._~23~25kernel%29._hash-iterate-key%29%29" class="RktValLink" data-pltdoc="x">hash-iterate-key</a></span> and similar procedures.
+These operations support <a href="chaperones.html#%28tech._chaperone%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperones</span></a> and <a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonators</span></a>.</div></p><p>Each unsafe ...<span class="RktSym"><span class="nobreak">-f</span>irst</span><span class="RktMeta"></span> and ...<span class="RktSym"><span class="nobreak">-n</span>ext</span><span class="RktMeta"></span> procedure may return,
+instead of a number index, an internal representation of a view into
+the hash structure, enabling faster iteration. The result of these
+...<span class="RktSym"><span class="nobreak">-f</span>irst</span><span class="RktMeta"></span> and ...<span class="RktSym"><span class="nobreak">-n</span>ext</span><span class="RktMeta"></span> functions should be given as
+<span class="RktVar">pos</span> to the corresponding unsafe accessor functions.</p><p>If the <span class="RktVar">pos</span> provided to an accessor function for a mutable
+<span class="RktVar">hash</span> was formerly a <a href="hashtables.html#%28tech._valid._hash._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">valid hash index</span></a> but is no longer
+a <a href="hashtables.html#%28tech._valid._hash._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">valid hash index</span></a> for <span class="RktVar">hash</span>, and if
+<span class="RktVar">bad-index-v</span> is not provided, then the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. No behavior is specified for a
+<span class="RktVar">pos</span> that was never a <a href="hashtables.html#%28tech._valid._hash._index%29" class="techoutside" data-pltdoc="x"><span class="techinside">valid hash index</span></a> for
+<span class="RktVar">hash</span>. Note that <span class="RktVar">bad-index-v</span> argument is technically
+not useful for the <span class="RktSym">unsafe-immutable-hash-iterate-</span><span class="RktMeta"></span> functions,
+since an index cannot become invalid for an immutable <span class="RktVar">hash</span>.</p><p class="SHistory">Added in version 6.4.0.6 of package <span class="stt">base</span>.<br/>Changed in version 7.0.0.10: Added the optional <span class="RktVar">bad-index-v</span> argument.<br/>Changed in version 8.0.0.10: Added <span class="RktSym">ephemeron</span> variants.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-make-srcloc))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-make-srcloc%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-make-srcloc</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">source</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">line</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">column</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">position</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">span</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._srcloc~3f%29%29" class="RktValLink" data-pltdoc="x">srcloc?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">source</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">line</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">column</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">position</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-positive-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-positive-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">span</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Unsafe version of <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._srcloc%29%29" class="RktValLink" data-pltdoc="x">srcloc</a></span>.</div></p><p class="SHistory">Added in version 7.2.0.10 of package <span class="stt">base</span>.</p><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;unsafeextfl&quot;">17.4<tt>&nbsp;</tt><a name="(part._unsafeextfl)"></a>Unsafe Extflonum Operations</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extfl+))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl%2B%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extfl+</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extfl-))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl-%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extfl-</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extfl*))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extfl*</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extfl/))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl%2F%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extfl/</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extflabs))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflabs%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extflabs</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unchecked versions of <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl%2B%29%29" class="RktValLink" data-pltdoc="x">extfl+</a></span>, <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-%29%29" class="RktValLink" data-pltdoc="x">extfl-</a></span>,
+<span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl%2A%29%29" class="RktValLink" data-pltdoc="x">extfl*</a></span>, <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl%2F%29%29" class="RktValLink" data-pltdoc="x">extfl/</a></span>, and <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflabs%29%29" class="RktValLink" data-pltdoc="x">extflabs</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extfl~3d))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl~3d%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extfl=</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extfl~3c))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl~3c%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extfl&lt;</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extfl~3e))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl~3e%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extfl&gt;</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extfl~3c~3d))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl~3c~3d%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extfl&lt;=</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extfl~3e~3d))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl~3e~3d%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extfl&gt;=</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extflmin))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflmin%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extflmin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extflmax))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflmax%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extflmax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unchecked versions of <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl~3d%29%29" class="RktValLink" data-pltdoc="x">extfl=</a></span>, <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl~3c%29%29" class="RktValLink" data-pltdoc="x">extfl&lt;</a></span>,
+<span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl~3e%29%29" class="RktValLink" data-pltdoc="x">extfl&gt;</a></span>, <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl~3c~3d%29%29" class="RktValLink" data-pltdoc="x">extfl&lt;=</a></span>, <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl~3e~3d%29%29" class="RktValLink" data-pltdoc="x">extfl&gt;=</a></span>, <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflmin%29%29" class="RktValLink" data-pltdoc="x">extflmin</a></span>, and
+<span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflmax%29%29" class="RktValLink" data-pltdoc="x">extflmax</a></span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extflround))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflround%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extflround</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extflfloor))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflfloor%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extflfloor</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extflceiling))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflceiling%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extflceiling</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extfltruncate))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfltruncate%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extfltruncate</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unchecked (potentially) versions of <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflround%29%29" class="RktValLink" data-pltdoc="x">extflround</a></span>,
+<span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflfloor%29%29" class="RktValLink" data-pltdoc="x">extflfloor</a></span>, <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflceiling%29%29" class="RktValLink" data-pltdoc="x">extflceiling</a></span>, and
+<span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfltruncate%29%29" class="RktValLink" data-pltdoc="x">extfltruncate</a></span>. Currently, these bindings are simply aliases
+for the corresponding safe bindings.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extflsin))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflsin%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extflsin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extflcos))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflcos%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extflcos</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extfltan))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfltan%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extfltan</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extflasin))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflasin%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extflasin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extflacos))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflacos%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extflacos</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extflatan))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflatan%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extflatan</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extfllog))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfllog%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extfllog</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extflexp))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflexp%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extflexp</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extflsqrt))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflsqrt%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extflsqrt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extflexpt))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflexpt%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extflexpt</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span><span class="RktVar">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">b</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unchecked (potentially) versions of <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflsin%29%29" class="RktValLink" data-pltdoc="x">extflsin</a></span>,
+<span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflcos%29%29" class="RktValLink" data-pltdoc="x">extflcos</a></span>, <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfltan%29%29" class="RktValLink" data-pltdoc="x">extfltan</a></span>, <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflasin%29%29" class="RktValLink" data-pltdoc="x">extflasin</a></span>,
+<span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflacos%29%29" class="RktValLink" data-pltdoc="x">extflacos</a></span>, <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflatan%29%29" class="RktValLink" data-pltdoc="x">extflatan</a></span>, <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfllog%29%29" class="RktValLink" data-pltdoc="x">extfllog</a></span>,
+<span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflexp%29%29" class="RktValLink" data-pltdoc="x">extflexp</a></span>, <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflsqrt%29%29" class="RktValLink" data-pltdoc="x">extflsqrt</a></span>, and
+<span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflexpt%29%29" class="RktValLink" data-pltdoc="x">extflexpt</a></span>. Currently, some of these bindings are simply
+aliases for the corresponding safe bindings.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-fx-~3eextfl))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fx-~3eextfl%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-fx-&gt;extfl</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extfl-~3efx))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extfl-~3efx%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extfl-&gt;fx</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">a</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unchecked (potentially) versions of <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._fx-~3eextfl%29%29" class="RktValLink" data-pltdoc="x">fx-&gt;extfl</a></span> and <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extfl-~3efx%29%29" class="RktValLink" data-pltdoc="x">extfl-&gt;fx</a></span>.</div></p><p class="SHistory">Changed in version 7.7.0.8 of package <span class="stt">base</span>: Changed <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-fl-~3efx%29%29" class="RktValLink" data-pltdoc="x">unsafe-fl-&gt;fx</a></span> to truncate.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extflvector-length))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflvector-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extflvector-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector~3f%29%29" class="RktValLink" data-pltdoc="x">extflvector?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extflvector-ref))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflvector-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extflvector-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector~3f%29%29" class="RktValLink" data-pltdoc="x">extflvector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-extflvector-set!))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-extflvector-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-extflvector-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span><span class="RktVar">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector~3f%29%29" class="RktValLink" data-pltdoc="x">extflvector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">k</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._fixnum~3f%29%29" class="RktValLink" data-pltdoc="x">fixnum?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">x</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflonum~3f%29%29" class="RktValLink" data-pltdoc="x">extflonum?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Unchecked versions of <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector-length%29%29" class="RktValLink" data-pltdoc="x">extflvector-length</a></span>, <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector-ref%29%29" class="RktValLink" data-pltdoc="x">extflvector-ref</a></span>, and
+<span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector-set%21%29%29" class="RktValLink" data-pltdoc="x">extflvector-set!</a></span>. A <a href="extflonums.html#%28tech._extflvector%29" class="techoutside" data-pltdoc="x"><span class="techinside">extflvector</span></a>&rsquo;s size can never be larger than a
+<a href="numbers.html#%28tech._fixnum%29" class="techoutside" data-pltdoc="x"><span class="techinside">fixnum</span></a> (so even <span class="RktSym"><a href="extflonums.html#%28def._%28%28lib._racket%2Fextflonum..rkt%29._extflvector-length%29%29" class="RktValLink" data-pltdoc="x">extflvector-length</a></span> always returns a
+fixnum).</div></p><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Unsafe_Impersonators_and_Chaperones&quot;">17.5<tt>&nbsp;</tt><a name="(part._.Unsafe_.Impersonators_and_.Chaperones)"></a>Unsafe Impersonators and Chaperones</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-impersonate-procedure))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-impersonate-procedure%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-impersonate-procedure</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">replacement-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">replacement-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span>, but assumes that
+<span class="RktVar">replacement-proc</span> calls <span class="RktVar">proc</span> itself. When the result
+of <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">unsafe-impersonate-procedure</a></span> is applied to arguments, the
+arguments are passed on to <span class="RktVar">replacement-proc</span> directly,
+ignoring <span class="RktVar">proc</span>. At the same time, <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-of~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-of?</a></span>
+reports <span class="RktVal">#t</span> when given the result of
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">unsafe-impersonate-procedure</a></span> and <span class="RktVar">proc</span>.</div></p><p>If <span class="RktVar">proc</span> is itself an impersonator that is derived from
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%2A%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure*</a></span> or <span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._chaperone-procedure%2A%29%29" class="RktValLink" data-pltdoc="x">chaperone-procedure*</a></span>,
+beware that <span class="RktVar">replacement-proc</span> will not be able to call it
+correctly. Specifically, the impersonator produced by
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">unsafe-impersonate-procedure</a></span> will not get passed to a
+wrapper procedure that was supplied to
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%2A%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure*</a></span> or <span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._chaperone-procedure%2A%29%29" class="RktValLink" data-pltdoc="x">chaperone-procedure*</a></span> to
+generate <span class="RktVar">proc</span>.</p><p>Finally, unlike <span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span>,
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">unsafe-impersonate-procedure</a></span> does not specially handle
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-prop~3aapplication-mark%29%29" class="RktValLink" data-pltdoc="x">impersonator-prop:application-mark</a></span> as a <span class="RktVar">prop</span>.</p><p>The unsafety of <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">unsafe-impersonate-procedure</a></span> is limited to
+the above differences from <span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span>. The
+contracts on the arguments of <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">unsafe-impersonate-procedure</a></span> are
+checked when the arguments are supplied.</p><p><div class="SIntrapara">As an example, assuming that <span class="RktSym">f</span> accepts a single argument and
+is not derived from <span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%2A%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure*</a></span> or
+<span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._chaperone-procedure%2A%29%29" class="RktValLink" data-pltdoc="x">chaperone-procedure*</a></span>, then
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">unsafe-impersonate-procedure</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">no-numbers!</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">is equivalent to
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._number~3f%29%29" class="RktValLink" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="exns.html#%28def._%28%28quote._~23~25kernel%29._error%29%29" class="RktValLink" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">no-numbers!</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p><div class="SIntrapara">Similarly, with the same assumptions about <span class="RktSym">f</span>, the following
+two procedures <span class="RktVar">wrap-f1</span> and
+<span class="RktVar">wrap-f2</span> are almost equivalent; they differ only
+in the error message produced when their arguments are
+functions that return multiple values (and that they update
+different global variables). The version using <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">unsafe-impersonate-procedure</a></span>
+will signal an error in the <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span> expression about multiple
+return values, whereas the one using <span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span> signals
+an error from <span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span> about multiple return values.
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">log1-args</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">log1-results</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">wrap-f1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">impersonate-procedure</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">arg</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">log1-args</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">arg</span><span class="hspace">&nbsp;</span><span class="RktSym">log1-args</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">res</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">log1-results</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">res</span><span class="hspace">&nbsp;</span><span class="RktSym">log1-results</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">res</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">arg</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">log2-args</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">log2-results</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">wrap-f2</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">unsafe-impersonate-procedure</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">arg</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">log2-args</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">arg</span><span class="hspace">&nbsp;</span><span class="RktSym">log2-args</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">res</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">arg</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">log2-results</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._cons%29%29" class="RktValLink" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">res</span><span class="hspace">&nbsp;</span><span class="RktSym">log2-results</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">res</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.4.0.4 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-chaperone-procedure))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-chaperone-procedure%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-chaperone-procedure</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">wrapper-proc</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">wrapper-proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-impersonate-procedure%29%29" class="RktValLink" data-pltdoc="x">unsafe-impersonate-procedure</a></span>, but creates a <a href="chaperones.html#%28tech._chaperone%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone</span></a>.
+Since <span class="RktVar">wrapper-proc</span> will be called in lieu of <span class="RktVar">proc</span>,
+<span class="RktVar">wrapper-proc</span> is assumed to return a chaperone of the value that
+<span class="RktVar">proc</span> would return.</div></p><p class="SHistory">Added in version 6.4.0.4 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-impersonate-vector))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-impersonate-vector%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-impersonate-vector</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">vec</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">replacement-vec</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">replacement-vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonate-vector%29%29" class="RktValLink" data-pltdoc="x">impersonate-vector</a></span>, but instead of going through interposition procedures, all
+accesses to the impersonator are dispatched to <span class="RktVar">replacement-vec</span>.</div></p><p>The result of <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-impersonate-vector%29%29" class="RktValLink" data-pltdoc="x">unsafe-impersonate-vector</a></span> is an impersonator of <span class="RktVar">vec</span>.</p><p><div class="SIntrapara"><p class="SHistory">Added in version 6.9.0.2 of package <span class="stt">base</span>.</p></div><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-chaperone-vector))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-chaperone-vector%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-chaperone-vector</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">vec</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">replacement-vec</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._chaperone~3f%29%29" class="RktValLink" data-pltdoc="x">chaperone?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">replacement-vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator-property~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator-property?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">prop-val</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-impersonate-vector%29%29" class="RktValLink" data-pltdoc="x">unsafe-impersonate-vector</a></span>, but the result of <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-chaperone-vector%29%29" class="RktValLink" data-pltdoc="x">unsafe-chaperone-vector</a></span> is a
+chaperone of <span class="RktVar">vec</span>.</div></p><p class="SHistory">Added in version 6.9.0.2 of package <span class="stt">base</span>.</p><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;unsafeassert&quot;">17.6<tt>&nbsp;</tt><a name="(part._unsafeassert)"></a>Unsafe Assertions</h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/ops..rkt)._unsafe-assert-unreachable))"></a><span title="Provided from: racket/unsafe/ops | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-assert-unreachable%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-assert-unreachable</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._none%2Fc%29%29" class="RktValLink" data-pltdoc="x">none/c</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="unreachable.html#%28def._%28%28quote._~23~25kernel%29._assert-unreachable%29%29" class="RktValLink" data-pltdoc="x">assert-unreachable</a></span>, but the contract of
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-assert-unreachable%29%29" class="RktValLink" data-pltdoc="x">unsafe-assert-unreachable</a></span> is never satisfied, and the
+&ldquo;unsafe&rdquo; implication is that anything at all can happen if a call to
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-assert-unreachable%29%29" class="RktValLink" data-pltdoc="x">unsafe-assert-unreachable</a></span> is reached.</div></p><p>The compiler may take advantage of its liberty to pick convenient or
+efficient behavior in place of a call to
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-assert-unreachable%29%29" class="RktValLink" data-pltdoc="x">unsafe-assert-unreachable</a></span>. For example, the expression</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-assert-unreachable%29%29" class="RktValLink" data-pltdoc="x">unsafe-assert-unreachable</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>may be compiled to code equivalent to</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-car%29%29" class="RktValLink" data-pltdoc="x">unsafe-car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>because choosing to make <span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-assert-unreachable%29%29" class="RktValLink" data-pltdoc="x">unsafe-assert-unreachable</a></span><span class="RktPn">)</span> behave
+the same as <span class="RktPn">(</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fops..rkt%29._unsafe-car%29%29" class="RktValLink" data-pltdoc="x">unsafe-car</a></span><span class="stt"> </span><span class="RktSym">x</span><span class="RktPn">)</span> makes both branches of the
+<span class="RktSym"><a href="if.html#%28form._%28%28quote._~23~25kernel%29._if%29%29" class="RktStxLink" data-pltdoc="x">if</a></span> the same, and then <span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._pair~3f%29%29" class="RktValLink" data-pltdoc="x">pair?</a></span> test can be eliminated.</p><p class="SHistory">Added in version 8.0.0.11 of package <span class="stt">base</span>.</p><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;unsafe-undefined&quot;">17.7<tt>&nbsp;</tt><a name="(part._unsafe-undefined)"></a><a name="(mod-path._racket/unsafe/undefined)"></a>Unsafe Undefined</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="unsafe.html#%28mod-path._racket%2Funsafe%2Fundefined%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/unsafe/undefined</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="unsafe.html#%28mod-path._racket%2Funsafe%2Fundefined%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/unsafe/undefined</span></a> library, not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a>.</div></p><p>The constant <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">unsafe-undefined</a></span> is used internally as a
+placeholder value. For example, it is used by <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._letrec%29%29" class="RktStxLink" data-pltdoc="x">letrec</a></span> as a
+value for a variable that has not yet been assigned a value.  Unlike
+the <span class="RktSym">undefined</span> value exported by <a href="undefined.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/undefined</span></a>,
+however, the <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">unsafe-undefined</a></span> value should not leak as the
+result of a safe expression, and it should not be passed as an optional
+argument to a procedure (because it may count as &ldquo;no value provided&rdquo;).
+Expression results that potentially
+produce <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">unsafe-undefined</a></span> can be guarded by
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._check-not-unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">check-not-unsafe-undefined</a></span>, so that an exception can be
+raised instead of producing an <span class="RktSym">undefined</span> value.</p><p>The <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">unsafe-undefined</a></span> value is always <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to itself.</p><p class="SHistory">Added in version 6.0.1.2 of package <span class="stt">base</span>.<br/>Changed in version 6.90.0.29: Procedures with optional arguments
+sometimes use the <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">unsafe-undefined</a></span>
+value internally to mean &ldquo;no argument supplied.&rdquo;</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/unsafe/undefined..rkt)._unsafe-undefined))"></a><span title="Provided from: racket/unsafe/undefined | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._unsafe-undefined%29%29" class="RktValDef RktValLink" data-pltdoc="x">unsafe-undefined</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">The unsafe &ldquo;undefined&rdquo; constant.</div></p><p>See above for important constraints on the use of <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">unsafe-undefined</a></span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/undefined..rkt)._check-not-unsafe-undefined))"></a><span title="Provided from: racket/unsafe/undefined | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._check-not-unsafe-undefined%29%29" class="RktValDef RktValLink" data-pltdoc="x">check-not-unsafe-undefined</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">sym</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._one-of%2Fc%29%29" class="RktValLink" data-pltdoc="x">one-of/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">unsafe-undefined</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Checks whether <span class="RktVar">v</span> is <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">unsafe-undefined</a></span>, and raises
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3avariable%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:variable</a></span> in that case with an error message
+along the lines of &ldquo;<span class="RktVar">sym</span>: undefined; use before
+initialization.&rdquo;  If <span class="RktVar">v</span> is not <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">unsafe-undefined</a></span>,
+then <span class="RktVar">v</span> is returned.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/undefined..rkt)._check-not-unsafe-undefined/assign))"></a><span title="Provided from: racket/unsafe/undefined | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._check-not-unsafe-undefined%2Fassign%29%29" class="RktValDef RktValLink" data-pltdoc="x">check-not-unsafe-undefined/assign</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">sym</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._one-of%2Fc%29%29" class="RktValLink" data-pltdoc="x">one-of/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">unsafe-undefined</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">sym</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="symbols.html#%28def._%28%28quote._~23~25kernel%29._symbol~3f%29%29" class="RktValLink" data-pltdoc="x">symbol?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">The same as <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._check-not-unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">check-not-unsafe-undefined</a></span>, except that the error
+message (if any) is along the lines of &ldquo;<span class="RktVar">sym</span>: undefined;
+assignment before initialization.&rdquo;</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/unsafe/undefined..rkt)._chaperone-struct-unsafe-undefined))"></a><span title="Provided from: racket/unsafe/undefined | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._chaperone-struct-unsafe-undefined%29%29" class="RktValDef RktValLink" data-pltdoc="x">chaperone-struct-unsafe-undefined</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Chaperones <span class="RktVar">v</span> if it is a structure (as viewed through some
+<a href="inspectors.html#%28tech._inspector%29" class="techoutside" data-pltdoc="x"><span class="techinside">inspector</span></a>). Every access of a field in the structure is checked
+to prevent returning <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">unsafe-undefined</a></span>. Similarly, every
+assignment to a field in the structure is checked (unless the check
+disabled as described below) to prevent assignment of a field whose
+current value is <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">unsafe-undefined</a></span>.</div></p><p>When a field access would otherwise produce <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">unsafe-undefined</a></span>
+or when a field assignment would replace <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">unsafe-undefined</a></span>, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>The chaperone&rsquo;s field-assignment check is disabled whenever
+<span class="RktPn">(</span><span class="RktSym"><a href="contmarks.html#%28def._%28%28quote._~23~25kernel%29._continuation-mark-set-first%29%29" class="RktValLink" data-pltdoc="x">continuation-mark-set-first</a></span><span class="stt"> </span><span class="RktVal">#f</span><span class="stt"> </span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._prop~3achaperone-unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">prop:chaperone-unsafe-undefined</a></span><span class="RktPn">)</span> returns <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">unsafe-undefined</a></span>.
+Thus, a field-initializing assignment&#8212;<wbr></wbr>one that is intended to replace the
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">unsafe-undefined</a></span> value of a field&#8212;<wbr></wbr>should be wrapped with
+<span class="RktPn">(</span><span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span><span class="stt"> </span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._prop~3achaperone-unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">prop:chaperone-unsafe-undefined</a></span><span class="stt"> </span><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">unsafe-undefined</a></span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>value</p></div></div><p class="RForeground"><a name="(def._((lib._racket/unsafe/undefined..rkt)._prop~3achaperone-unsafe-undefined))"></a><span title="Provided from: racket/unsafe/undefined | Package: base"><span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._prop~3achaperone-unsafe-undefined%29%29" class="RktValDef RktValLink" data-pltdoc="x">prop:chaperone-unsafe-undefined</a></span></span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="structprops.html#%28def._%28%28quote._~23~25kernel%29._struct-type-property~3f%29%29" class="RktValLink" data-pltdoc="x">struct-type-property?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">A <a href="structprops.html#%28tech._structure._type._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type property</span></a> that causes a structure type&rsquo;s
+constructor to produce a <a href="chaperones.html#%28tech._chaperone%29" class="techoutside" data-pltdoc="x"><span class="techinside">chaperone</span></a> of an instance
+in the same way as <span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._chaperone-struct-unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">chaperone-struct-unsafe-undefined</a></span>.</div></p><p>The property value should be a list of symbols used as field names,
+but the list should be in reverse order of the structure&rsquo;s fields.
+When a field access or assignment would produce or replace
+<span class="RktSym"><a href="unsafe.html#%28def._%28%28lib._racket%2Funsafe%2Fundefined..rkt%29._unsafe-undefined%29%29" class="RktValLink" data-pltdoc="x">unsafe-undefined</a></span>, the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract~3avariable%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract:variable</a></span>
+exception is raised if a field name is provided by the structure
+property&rsquo;s value, otherwise the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception
+is raised.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="phantom-bytes.html" title="backward to &quot;16.5 Phantom Byte Strings&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Reference&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="running.html" title="forward to &quot;18 Running Racket&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/values.html b/clones/docs.racket-lang.org/reference/values.html
new file mode 100644
index 00000000..2751887e
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/values.html
@@ -0,0 +1,12 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>10.1&nbsp;Multiple Values</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewselflink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">10.1&nbsp;</td><td><a href="values.html" class="tocviewselflink" data-pltdoc="x">Multiple Values</a></td></tr><tr><td align="right">10.2&nbsp;</td><td><a href="exns.html" class="tocviewlink" data-pltdoc="x">Exceptions</a></td></tr><tr><td align="right">10.3&nbsp;</td><td><a href="Delayed_Evaluation.html" class="tocviewlink" data-pltdoc="x">Delayed Evaluation</a></td></tr><tr><td align="right">10.4&nbsp;</td><td><a href="cont.html" class="tocviewlink" data-pltdoc="x">Continuations</a></td></tr><tr><td align="right">10.5&nbsp;</td><td><a href="contmarks.html" class="tocviewlink" data-pltdoc="x">Continuation Marks</a></td></tr><tr><td align="right">10.6&nbsp;</td><td><a href="breakhandler.html" class="tocviewlink" data-pltdoc="x">Breaks</a></td></tr><tr><td align="right">10.7&nbsp;</td><td><a href="Exiting.html" class="tocviewlink" data-pltdoc="x">Exiting</a></td></tr><tr><td align="right">10.8&nbsp;</td><td><a href="unreachable.html" class="tocviewlink" data-pltdoc="x">Unreachable Expressions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">values</span></span></a></td></tr><tr><td><a href="values.html#%28def._%28%28quote._~23~25kernel%29._call-with-values%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">call-<wbr></wbr>with-<wbr></wbr>values</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="control.html" title="backward to &quot;10 Control Flow&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Control Flow&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="exns.html" title="forward to &quot;10.2 Exceptions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;values&quot;">10.1<tt>&nbsp;</tt><a name="(part._values)"></a>Multiple Values</h4><p>See <a href="eval-model.html#%28part._values-model%29" data-pltdoc="x">Multiple Return Values</a> for general information about multiple
+result values. In addition to <span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._call-with-values%29%29" class="RktValLink" data-pltdoc="x">call-with-values</a></span> (described in
+this section), the <span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._let-values%29%29" class="RktStxLink" data-pltdoc="x">let-values</a></span>, <span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%2A-values%29%29" class="RktStxLink" data-pltdoc="x">let*-values</a></span>,
+<span class="RktSym"><a href="let.html#%28form._%28%28quote._~23~25kernel%29._letrec-values%29%29" class="RktStxLink" data-pltdoc="x">letrec-values</a></span>, and <span class="RktSym"><a href="define.html#%28form._%28%28quote._~23~25kernel%29._define-values%29%29" class="RktStxLink" data-pltdoc="x">define-values</a></span> forms (among
+others) create continuations that receive multiple values.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._values))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValDef RktValLink" data-pltdoc="x">values</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the given <span class="RktVar">v</span>s. That is, <span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span> returns its
+provided arguments.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._call-with-values))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._call-with-values%29%29" class="RktValDef RktValLink" data-pltdoc="x">call-with-values</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">generator</span><span class="hspace">&nbsp;</span><span class="RktVar">receiver</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">generator</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">receiver</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Calls <span class="RktVar">generator</span>, and passes the values that
+<span class="RktVar">generator</span> produces as arguments to <span class="RktVar">receiver</span>. Thus,
+<span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._call-with-values%29%29" class="RktValLink" data-pltdoc="x">call-with-values</a></span> creates a continuation that accepts any
+number of values that <span class="RktVar">receiver</span> can accept. The
+<span class="RktVar">receiver</span> procedure is called in tail position with respect to
+the <span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._call-with-values%29%29" class="RktValLink" data-pltdoc="x">call-with-values</a></span> call.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._call-with-values%29%29" class="RktValLink" data-pltdoc="x">call-with-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._call-with-values%29%29" class="RktValLink" data-pltdoc="x">call-with-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._lambda%29%29" class="RktStxLink" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">arity mismatch;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">the expected number of arguments does not match the given</span></p></td></tr><tr><td><p><span class="RktErr">number</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: 2</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 1</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="control.html" title="backward to &quot;10 Control Flow&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Control Flow&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="exns.html" title="forward to &quot;10.2 Exceptions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/vectors.html b/clones/docs.racket-lang.org/reference/vectors.html
new file mode 100644
index 00000000..d27e7465
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/vectors.html
@@ -0,0 +1,84 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.12&nbsp;Vectors</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewselflink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewlink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.12&nbsp;</td><td><a href="vectors.html" class="tocviewselflink" data-pltdoc="x">Vectors</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.12.1&nbsp;</td><td><a href="vectors.html#%28part._.Additional_.Vector_.Functions%29" class="tocviewlink" data-pltdoc="x">Additional Vector Functions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector?</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._make-vector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>vector</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-immutable%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>immutable</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%2A-length%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector*-<wbr></wbr>length</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%2A-ref%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector*-<wbr></wbr>ref</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%2A-set%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector*-<wbr></wbr>set!</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-cas%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>cas!</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-~3elist%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>&gt;list</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._list-~3evector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">list-<wbr></wbr>&gt;vector</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-~3eimmutable-vector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>&gt;immutable-<wbr></wbr>vector</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-fill%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>fill!</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-copy%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>copy!</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-~3evalues%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>&gt;values</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._build-vector%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">build-<wbr></wbr>vector</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.12.1<tt>&nbsp;</tt></span><a href="vectors.html#%28part._.Additional_.Vector_.Functions%29" class="tocsubseclink" data-pltdoc="x">Additional Vector Functions</a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-empty~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>empty?</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-set%2A%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>set*!</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-map%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>map</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-map%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>map!</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-append%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>append</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-take%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>take</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-take-right%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>take-<wbr></wbr>right</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-drop%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>drop</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-drop-right%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>drop-<wbr></wbr>right</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-split-at%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>split-<wbr></wbr>at</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-split-at-right%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>split-<wbr></wbr>at-<wbr></wbr>right</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-copy%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>copy</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-filter%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>filter</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-filter-not%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>filter-<wbr></wbr>not</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-count%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>count</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-argmin%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>argmin</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-argmax%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>argmax</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-member%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>member</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-memv%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>memv</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-memq%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>memq</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-sort%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>sort</span></span></a></td></tr><tr><td><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-sort%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">vector-<wbr></wbr>sort!</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="mpairs.html" title="backward to &quot;4.11 Mutable Pairs and Lists&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stencil_vectors.html" title="forward to &quot;4.13 Stencil Vectors&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;vectors&quot;">4.12<tt>&nbsp;</tt><a name="(part._vectors)"></a>Vectors</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=vectors.html&amp;version=8.6" class="Sq" data-pltdoc="x">Vectors</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces vectors.</p></blockquote></blockquote></blockquote><p>A <a name="(tech._vector)"></a><span style="font-style: italic">vector</span> is a fixed-length array with constant-time access
+and update of the vector slots, which are numbered from <span class="RktVal">0</span> to
+one less than the number of slots in the vector.</p><p>Two vectors are <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> if they have the same length, and if
+the values in corresponding slots of the vectors are
+<span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span>.</p><p>A vector can be <span style="font-style: italic">mutable</span> or <span style="font-style: italic">immutable</span>. When an
+immutable vector is provided to a procedure like <span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="RktValLink" data-pltdoc="x">vector-set!</a></span>,
+the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised. Vectors generated by the default
+reader (see <a href="reader.html#%28part._parse-string%29" data-pltdoc="x">Reading Strings</a>) are immutable. Use
+<span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span> to check whether a vector is immutable.</p><p>A vector can be used as a single-valued sequence (see
+<a href="sequences.html" data-pltdoc="x">Sequences</a>). The elements of the vector serve as elements
+of the sequence. See also <span class="RktSym"><a href="sequences.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._in-vector%29%29" class="RktValLink" data-pltdoc="x">in-vector</a></span>.</p><p>A literal or printed vector starts with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#(</span><span class="hspace"></span></span>, optionally with
+a number between the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span>. See <a href="reader.html#%28part._parse-vector%29" data-pltdoc="x">Reading Vectors</a>
+    for information on <span class="RktSym"><a href="Reading.html#%28def._%28%28quote._~23~25kernel%29._read%29%29" class="RktValLink" data-pltdoc="x">read</a></span>ing
+    vectors and <a href="printing.html#%28part._print-vectors%29" data-pltdoc="x">Printing Vectors</a>
+    for information on <span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._print%29%29" class="RktValLink" data-pltdoc="x">print</a></span>ing vectors.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._vector~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a vector, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-vector))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._make-vector%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-vector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">size</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">v</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">size</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a mutable vector with <span class="RktVar">size</span> slots, where all slots are
+initialized to contain <span class="RktVar">v</span>.</div></p><p>This function takes time proportional to <span class="RktVar">size</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._vector))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a newly allocated mutable vector with as many slots as provided <span class="RktVar">v</span>s,
+where the slots are initialized to contain the given <span class="RktVar">v</span>s in
+order.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._vector-immutable))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-immutable%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-immutable</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a newly allocated immutable vector with as many slots as provided
+<span class="RktVar">v</span>s, where the slots contain the given <span class="RktVar">v</span>s in
+order.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._vector-length))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the length of <span class="RktVar">vec</span> (i.e., the number of slots in the
+vector).</div></p><p>This function takes constant time.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._vector-ref))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the element in slot <span class="RktVar">pos</span> of <span class="RktVar">vec</span>. The first
+slot is position <span class="RktVal">0</span>, and the last slot is one less than
+<span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="RktValLink" data-pltdoc="x">vector-length</a></span><span class="stt"> </span><span class="RktVar">vec</span><span class="RktPn">)</span>.</div></p><p>This function takes constant time.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._vector-set!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Updates the slot <span class="RktVar">pos</span> of <span class="RktVar">vec</span> to contain <span class="RktVar">v</span>.</div></p><p>This function takes constant time.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._vector*-length))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%2A-length%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector*-length</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._vector*-ref))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%2A-ref%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector*-ref</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._vector*-set!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%2A-set%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector*-set!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="RktValLink" data-pltdoc="x">vector-length</a></span>, <span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span>, and
+<span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-set%21%29%29" class="RktValLink" data-pltdoc="x">vector-set!</a></span>, but constrained to work on vectors that are not
+<a href="chaperones.html#%28tech._impersonator%29" class="techoutside" data-pltdoc="x"><span class="techinside">impersonators</span></a>.</div></p><p class="SHistory">Added in version 6.90.0.15 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._vector-cas!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-cas%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-cas!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span><span class="RktVar">old-v</span><span class="hspace">&nbsp;</span><span class="RktVar">new-v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="chaperones.html#%28def._%28%28quote._~23~25kernel%29._impersonator~3f%29%29" class="RktValLink" data-pltdoc="x">impersonator?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">old-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">new-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Compare and set operation for vectors. See <span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box-cas%21%29%29" class="RktValLink" data-pltdoc="x">box-cas!</a></span>.</div></p><p class="SHistory">Added in version 6.11.0.2 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._vector-~3elist))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-~3elist%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-&gt;list</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list with the same length and elements as <span class="RktVar">vec</span>.</div></p><p>This function takes time proportional to the size of <span class="RktVar">vec</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._list-~3evector))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._list-~3evector%29%29" class="RktValDef RktValLink" data-pltdoc="x">list-&gt;vector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">lst</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._list~3f%29%29" class="RktValLink" data-pltdoc="x">list?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a mutable vector with the same length and elements as
+<span class="RktVar">lst</span>.</div></p><p>This function takes time proportional to the length of <span class="RktVar">lst</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._vector-~3eimmutable-vector))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-~3eimmutable-vector%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-&gt;immutable-vector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an immutable vector with the same length and elements as <span class="RktVar">vec</span>.
+If <span class="RktVar">vec</span> is itself immutable, then it is returned as the result.</div></p><p>This function takes time proportional to the size of <span class="RktVar">vec</span> when
+<span class="RktVar">vec</span> is mutable.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._vector-fill!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-fill%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-fill!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Changes all slots of <span class="RktVar">vec</span> to contain <span class="RktVar">v</span>.</div></p><p>This function takes time proportional to the size of <span class="RktVar">vec</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._vector-copy!))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-copy%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-copy!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">dest</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">dest-start</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">src</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">src-start</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">src-end</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dest</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">dest-start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src-start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">src-end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="RktValLink" data-pltdoc="x">vector-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">src</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Changes the elements of <span class="RktVar">dest</span> starting at position
+ <span class="RktVar">dest-start</span> to match the elements in <span class="RktVar">src</span> from
+ <span class="RktVar">src-start</span> (inclusive) to <span class="RktVar">src-end</span> (exclusive). The
+ vectors <span class="RktVar">dest</span> and <span class="RktVar">src</span> can be the same vector, and in
+ that case the destination region can overlap with the source region;
+ the destination elements after the copy match the source elements
+ from before the copy. If any of <span class="RktVar">dest-start</span>,
+ <span class="RktVar">src-start</span>, or <span class="RktVar">src-end</span> are out of range (taking into
+ account the sizes of the vectors and the source and destination
+ regions), the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p>This function takes time proportional to <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">src-end</span><span class="stt"> </span><span class="RktVar">src-start</span><span class="RktPn">)</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">A</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">p</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">p</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">l</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">e</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-copy%21%29%29" class="RktValLink" data-pltdoc="x">vector-copy!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">y</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-copy%21%29%29" class="RktValLink" data-pltdoc="x">vector-copy!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">v</span></td></tr><tr><td><p><span class="RktRes">'#(l p p l y)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._vector-~3evalues))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-~3evalues%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-&gt;values</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span><span class="RktVar">end-pos</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end-pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="RktValLink" data-pltdoc="x">vector-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVar">end-pos</span><span style="font-style: italic"> - </span><span class="RktVar">start-pos</span> values, which are
+the elements of <span class="RktVar">vec</span> from <span class="RktVar">start-pos</span> (inclusive) to
+<span class="RktVar">end-pos</span> (exclusive). If <span class="RktVar">start-pos</span> or
+<span class="RktVar">end-pos</span> are greater than <span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="RktValLink" data-pltdoc="x">vector-length</a></span><span class="stt"> </span><span class="RktVar">vec</span><span class="RktPn">)</span>, or if
+<span class="RktVar">end-pos</span> is less than <span class="RktVar">start-pos</span>, the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p>This function takes time proportional to the size of <span class="RktVar">vec</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/private/list..rkt)._build-vector))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._build-vector%29%29" class="RktValDef RktValLink" data-pltdoc="x">build-vector</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">n</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a vector of <span class="RktVar">n</span> elements by applying <span class="RktVar">proc</span> to
+the integers from <span class="RktVal">0</span> to <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._sub1%29%29" class="RktValLink" data-pltdoc="x">sub1</a></span><span class="stt"> </span><span class="RktVar">n</span><span class="RktPn">)</span> in order. If
+<span class="RktVar">vec</span> is the resulting vector, then <span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-ref%29%29" class="RktValLink" data-pltdoc="x">vector-ref</a></span><span class="stt"> </span><span class="RktVar">vec</span><span class="stt"> </span><span class="RktVar">i</span><span class="RktPn">)</span> is the value produced by <span class="RktPn">(</span><span class="RktVar">proc</span><span class="stt"> </span><span class="RktVar">i</span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._build-vector%29%29" class="RktValLink" data-pltdoc="x">build-vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#(1 2 3 4 5)</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Additional_Vector_Functions&quot;">4.12.1<tt>&nbsp;</tt><a name="(part._.Additional_.Vector_.Functions)"></a><a name="(mod-path._racket/vector)"></a>Additional Vector Functions</h5><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="require.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._require%29%29" class="RktStxLink" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="vectors.html#%28mod-path._racket%2Fvector%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/vector</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <a href="https://pkgs.racket-lang.org/package/base" title="Install this package using `raco pkg install base`"><span class="stt">base</span></a></span></td></tr></table></div><div class="SIntrapara">The bindings documented in this section are provided by the <a href="vectors.html#%28mod-path._racket%2Fvector%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/vector</span></a> and <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket</span></a> libraries, but not <a href="index.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-empty~3f))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-empty~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-empty?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is empty (i.e. its length is 0), <span class="RktVal">#f</span> otherwise.</div></p><p class="SHistory">Added in version 7.4.0.4 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-set*!))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-set%2A%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-set*!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Updates each slot <span class="RktVar">pos</span> of <span class="RktVar">vec</span> to contain each <span class="RktVar">v</span>.
+The update takes place from the left so later updates overwrite earlier updates.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-map))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-map%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-map</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Applies <span class="RktVar">proc</span> to the elements of the <span class="RktVar">vec</span>s from the
+ first elements to the last. The <span class="RktVar">proc</span> argument must accept
+ the same number of arguments as the number of supplied <span class="RktVar">vec</span>s,
+ and all <span class="RktVar">vec</span>s must have the same number of elements.  The
+ result is a fresh vector containing each result of <span class="RktVar">proc</span> in
+ order.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-map%29%29" class="RktValLink" data-pltdoc="x">vector-map</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._%2B%29%29" class="RktValLink" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#(4 6)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-map!))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-map%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-map!</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-map%29%29" class="RktValLink" data-pltdoc="x">vector-map</a></span>, but result of <span class="RktVar">proc</span> is inserted into
+ the first <span class="RktVar">vec</span> at the index that the arguments to
+ <span class="RktVar">proc</span> were taken from. The result is the first <span class="RktVar">vec</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-map%21%29%29" class="RktValLink" data-pltdoc="x">vector-map!</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._add1%29%29" class="RktValLink" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#(2 3 4 5)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">v</span></td></tr><tr><td><p><span class="RktRes">'#(2 3 4 5)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-append))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-append%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-append</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a fresh vector that contains all
+of the elements of the given vectors in order.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-append%29%29" class="RktValLink" data-pltdoc="x">vector-append</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#(1 2 3 4)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-take))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-take%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-take</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a fresh vector whose elements are the first <span class="RktVar">pos</span> elements of
+<span class="RktVar">vec</span>.  If <span class="RktVar">vec</span> has fewer than
+<span class="RktVar">pos</span> elements, then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-take%29%29" class="RktValLink" data-pltdoc="x">vector-take</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#(1 2)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-take-right))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-take-right%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-take-right</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a fresh vector whose elements are the last <span class="RktVar">pos</span> elements of
+<span class="RktVar">vec</span>.  If <span class="RktVar">vec</span> has fewer than
+<span class="RktVar">pos</span> elements, then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-take-right%29%29" class="RktValLink" data-pltdoc="x">vector-take-right</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#(3 4)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-drop))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-drop%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-drop</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a fresh vector whose elements are the elements of <span class="RktVar">vec</span>
+ after the first <span class="RktVar">pos</span> elements.  If <span class="RktVar">vec</span> has fewer
+ than <span class="RktVar">pos</span> elements, then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-drop%29%29" class="RktValLink" data-pltdoc="x">vector-drop</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#(3 4)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-drop-right))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-drop-right%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-drop-right</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a fresh vector whose elements are the prefix of <span class="RktVar">vec</span>,
+dropping its <span class="RktVar">pos</span>-length tail.  If <span class="RktVar">vec</span> has fewer
+than <span class="RktVar">pos</span> elements, then the <span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-drop-right%29%29" class="RktValLink" data-pltdoc="x">vector-drop-right</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#(1 2 3)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-drop-right%29%29" class="RktValLink" data-pltdoc="x">vector-drop-right</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#(1)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-split-at))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-split-at%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-split-at</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the same result as</div></p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-take%29%29" class="RktValLink" data-pltdoc="x">vector-take</a></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-drop%29%29" class="RktValLink" data-pltdoc="x">vector-drop</a></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>except that it can be faster.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-split-at%29%29" class="RktValLink" data-pltdoc="x">vector-split-at</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">'#(1 2)</span></p></td></tr><tr><td><p><span class="RktRes">'#(3 4 5)</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-split-at-right))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-split-at-right%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-split-at-right</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pos</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the same result as</div></p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="values.html#%28def._%28%28quote._~23~25kernel%29._values%29%29" class="RktValLink" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-take-right%29%29" class="RktValLink" data-pltdoc="x">vector-take-right</a></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-drop-right%29%29" class="RktValLink" data-pltdoc="x">vector-drop-right</a></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktVar">pos</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>except that it can be faster.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-split-at-right%29%29" class="RktValLink" data-pltdoc="x">vector-split-at-right</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">'#(1 2 3)</span></p></td></tr><tr><td><p><span class="RktRes">'#(4 5)</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-copy))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-copy%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-copy</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span><span class="RktVar">end</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="RktValLink" data-pltdoc="x">vector-length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates a fresh vector of size <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">end</span><span class="stt"> </span><span class="RktVar">start</span><span class="RktPn">)</span>, with all of the
+elements of <span class="RktVar">vec</span> from <span class="RktVar">start</span> (inclusive) to
+<span class="RktVar">end</span> (exclusive).</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-copy%29%29" class="RktValLink" data-pltdoc="x">vector-copy</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#(1 2 3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-copy%29%29" class="RktValLink" data-pltdoc="x">vector-copy</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#(4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-copy%29%29" class="RktValLink" data-pltdoc="x">vector-copy</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#(3)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-filter))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-filter%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-filter</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a fresh vector with the elements of <span class="RktVar">vec</span> for which
+ <span class="RktVar">pred</span> produces a true value. The <span class="RktVar">pred</span> procedure is
+ applied to each element from first to last.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-filter%29%29" class="RktValLink" data-pltdoc="x">vector-filter</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#(2 4 6)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-filter-not))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-filter-not%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-filter-not</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">pred</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-filter%29%29" class="RktValLink" data-pltdoc="x">vector-filter</a></span>, but the meaning of the <span class="RktVar">pred</span> predicate
+is reversed: the result is a vector of all items for which <span class="RktVar">pred</span>
+returns <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-filter-not%29%29" class="RktValLink" data-pltdoc="x">vector-filter-not</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#(1 3 5)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-count))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-count%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-count</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="procedures.html#%28def._%28%28quote._~23~25kernel%29._procedure~3f%29%29" class="RktValLink" data-pltdoc="x">procedure?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the number of elements of the <span class="RktVar">vec</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span> (taken in
+parallel) on which <span class="RktVar">proc</span> does not evaluate to <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-count%29%29" class="RktValLink" data-pltdoc="x">vector-count</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._even~3f%29%29" class="RktValLink" data-pltdoc="x">even?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-count%29%29" class="RktValLink" data-pltdoc="x">vector-count</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3d%29%29" class="RktValLink" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-argmin))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-argmin%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-argmin</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">This returns the first element in the non-empty vector <span class="RktVar">vec</span> that minimizes
+the result of <span class="RktVar">proc</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-argmin%29%29" class="RktValLink" data-pltdoc="x">vector-argmin</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">pears</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">banana</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">apples</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 banana)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-argmin%29%29" class="RktValLink" data-pltdoc="x">vector-argmin</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">banana</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">orange</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 banana)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-argmax))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-argmax%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-argmax</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._real~3f%29%29" class="RktValLink" data-pltdoc="x">real?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">This returns the first element in the non-empty vector <span class="RktVar">vec</span> that maximizes
+the result of <span class="RktVar">proc</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-argmax%29%29" class="RktValLink" data-pltdoc="x">vector-argmax</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">pears</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">banana</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">apples</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(3 pears)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-argmax%29%29" class="RktValLink" data-pltdoc="x">vector-argmax</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">pears</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">oranges</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(3 pears)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-member))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-member%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-member</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._natural-number%2Fc%29%29" class="RktValLink" data-pltdoc="x">natural-number/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Locates the first element of <span class="RktVar">vec</span> that is <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._equal~3f%29%29" class="RktValLink" data-pltdoc="x">equal?</a></span> to
+ <span class="RktVar">v</span>. If such an element exists, the index of that element in
+ <span class="RktVar">vec</span> is returned. Otherwise, the result is <span class="RktVal">#f</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-member%29%29" class="RktValLink" data-pltdoc="x">vector-member</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-member%29%29" class="RktValLink" data-pltdoc="x">vector-member</a></span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-memv))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-memv%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-memv</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._natural-number%2Fc%29%29" class="RktValLink" data-pltdoc="x">natural-number/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-member%29%29" class="RktValLink" data-pltdoc="x">vector-member</a></span>, but finds an element using <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eqv~3f%29%29" class="RktValLink" data-pltdoc="x">eqv?</a></span>.
+</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-memv%29%29" class="RktValLink" data-pltdoc="x">vector-memv</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-memv%29%29" class="RktValLink" data-pltdoc="x">vector-memv</a></span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-memq))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-memq%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-memq</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._or%2Fc%29%29" class="RktValLink" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._natural-number%2Fc%29%29" class="RktValLink" data-pltdoc="x">natural-number/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-member%29%29" class="RktValLink" data-pltdoc="x">vector-member</a></span>, but finds an element using <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-memq%29%29" class="RktValLink" data-pltdoc="x">vector-memq</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-memq%29%29" class="RktValLink" data-pltdoc="x">vector-memq</a></span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-sort))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-sort%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-sort</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">vec</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">less-than?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:key</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:cache-keys?</span><span class="hspace">&nbsp;</span><span class="RktVar">cache-keys?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">less-than?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="RktValLink" data-pltdoc="x">vector-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cache-keys?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="pairs.html#%28def._%28%28lib._racket%2Fprivate%2Flist..rkt%29._sort%29%29" class="RktValLink" data-pltdoc="x">sort</a></span>, but operates on vectors; a
+ <span class="emph">fresh</span> vector of length <span class="RktPn">(</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._-%29%29" class="RktValLink" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">end</span><span class="stt"> </span><span class="RktVar">start</span><span class="RktPn">)</span> is
+ returned containing the elements from indices
+ <span class="RktVar">start</span> (inclusive) through <span class="RktVar">end</span> (exclusive)
+ of <span class="RktVar">vec</span>, but in sorted order (i.e., <span class="RktVar">vec</span> is
+ not modified). This sort is stable (i.e., the order of &ldquo;equal&rdquo;
+ elements is preserved).</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-sort%29%29" class="RktValLink" data-pltdoc="x">vector-sort</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v1</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#(1 2 3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">v1</span></td></tr><tr><td><p><span class="RktRes">'#(4 3 2 1)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-sort%29%29" class="RktValLink" data-pltdoc="x">vector-sort</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v2</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktPn">#:key</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#((2) (3))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">v2</span></td></tr><tr><td><p><span class="RktRes">'#((4) (3) (2) (1))</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.6.0.5 of package <span class="stt">base</span>.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._racket/vector..rkt)._vector-sort!))"></a><span title="Provided from: racket/vector, racket | Package: base"><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-sort%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">vector-sort!</a></span></span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">vec</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">less-than?</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span><span class="RktOpt">[</span></td><td valign="top"><span class="RktVar">start</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktVar">end</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:key</span><span class="hspace">&nbsp;</span><span class="RktVar">key</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td></tr><tr><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktPn">#:cache-keys?</span><span class="hspace">&nbsp;</span><span class="RktVar">cache-keys?</span><span class="RktOpt">]</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top">&rarr;</td><td valign="top"><span class="hspace">&nbsp;</span></td><td valign="top"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">vec</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._and%2Fc%29%29" class="RktValLink" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector~3f%29%29" class="RktValLink" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._not%2Fc%29%29" class="RktValLink" data-pltdoc="x">not/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._immutable~3f%29%29" class="RktValLink" data-pltdoc="x">immutable?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">less-than?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">start</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">end</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._exact-nonnegative-integer~3f%29%29" class="RktValLink" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector-length%29%29" class="RktValLink" data-pltdoc="x">vector-length</a></span><span class="hspace">&nbsp;</span><span class="RktVar">vec</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">key</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">cache-keys?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-sort%29%29" class="RktValLink" data-pltdoc="x">vector-sort</a></span>, but <span class="emph">updates</span> indices
+ <span class="RktVar">start</span> (inclusive) through <span class="RktVar">end</span> (exclusive)
+ of <span class="RktVar">vec</span> by sorting them according to the <span class="RktVar">less-than?</span>
+ procedure.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-sort%21%29%29" class="RktValLink" data-pltdoc="x">vector-sort!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v1</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">v1</span></td></tr><tr><td><p><span class="RktRes">'#(1 2 3 4)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28quote._~23~25kernel%29._vector%29%29" class="RktValLink" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="vectors.html#%28def._%28%28lib._racket%2Fvector..rkt%29._vector-sort%21%29%29" class="RktValLink" data-pltdoc="x">vector-sort!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v2</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="generic-numbers.html#%28def._%28%28quote._~23~25kernel%29._~3c%29%29" class="RktValLink" data-pltdoc="x">&lt;</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktPn">#:key</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="pairs.html#%28def._%28%28quote._~23~25kernel%29._car%29%29" class="RktValLink" data-pltdoc="x">car</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">v2</span></td></tr><tr><td><p><span class="RktRes">'#((4) (2) (3) (1))</span></p></td></tr></table></blockquote></div></p><p class="SHistory">Added in version 6.6.0.5 of package <span class="stt">base</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="mpairs.html" title="backward to &quot;4.11 Mutable Pairs and Lists&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stencil_vectors.html" title="forward to &quot;4.13 Stencil Vectors&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/void.html b/clones/docs.racket-lang.org/reference/void.html
new file mode 100644
index 00000000..b25e6aeb
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/void.html
@@ -0,0 +1,5 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.20&nbsp;Void</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewselflink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="Equality.html" class="tocviewlink" data-pltdoc="x">Equality</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings</a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Byte Strings</a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="mpairs.html" class="tocviewlink" data-pltdoc="x">Mutable Pairs and Lists</a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="stencil_vectors.html" class="tocviewlink" data-pltdoc="x">Stencil Vectors</a></td></tr><tr><td align="right">4.14&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">4.15&nbsp;</td><td><a href="hashtables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">4.16&nbsp;</td><td><a href="sequences_streams.html" class="tocviewlink" data-pltdoc="x">Sequences and Streams</a></td></tr><tr><td align="right">4.17&nbsp;</td><td><a href="dicts.html" class="tocviewlink" data-pltdoc="x">Dictionaries</a></td></tr><tr><td align="right">4.18&nbsp;</td><td><a href="sets.html" class="tocviewlink" data-pltdoc="x">Sets</a></td></tr><tr><td align="right">4.19&nbsp;</td><td><a href="procedures.html" class="tocviewlink" data-pltdoc="x">Procedures</a></td></tr><tr><td align="right">4.20&nbsp;</td><td><a href="void.html" class="tocviewselflink" data-pltdoc="x">Void</a></td></tr><tr><td align="right">4.21&nbsp;</td><td><a href="undefined.html" class="tocviewlink" data-pltdoc="x">Undefined</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">void?</span></span></a></td></tr><tr><td><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">void</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="procedures.html" title="backward to &quot;4.19 Procedures&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="undefined.html" title="forward to &quot;4.21 Undefined&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;void&quot;">4.20<tt>&nbsp;</tt><a name="(part._void)"></a>Void</h4><p>The constant <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a> is returned by most forms and procedures
+that have a side-effect and no useful result.</p><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a> value is always <span class="RktSym"><a href="Equality.html#%28def._%28%28quote._~23~25kernel%29._eq~3f%29%29" class="RktValLink" data-pltdoc="x">eq?</a></span> to itself.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._void~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">void?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is the
+constant <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>, <span class="RktVal">#f</span> otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._void))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValDef RktValLink" data-pltdoc="x">void</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the constant <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>. Each
+<span class="RktVar">v</span> argument is ignored.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="procedures.html" title="backward to &quot;4.19 Procedures&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="data.html" title="up to &quot;4 Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="undefined.html" title="forward to &quot;4.21 Undefined&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/wcm.html b/clones/docs.racket-lang.org/reference/wcm.html
new file mode 100644
index 00000000..df47390f
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/wcm.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.19&nbsp;Continuation Marks: with-continuation-mark</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewlink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewselflink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="for.html" title="backward to &quot;3.18 Iterations and Comprehensions: for, for/list, ...&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="quasiquote.html" title="forward to &quot;3.20 Quasiquoting: quasiquote, unquote, and unquote-splicing&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;wcm&quot;">3.19<tt>&nbsp;</tt><a name="(part._wcm)"></a>Continuation Marks: <span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span></h4><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((quote._~23~25kernel)._with-continuation-mark))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">with-continuation-mark</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">key-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">val-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">result-expr</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">The <span class="RktVar">key-expr</span>, <span class="RktVar">val-expr</span>, and <span class="RktVar">result-expr</span>
+expressions are evaluated in order. After <span class="RktVar">key-expr</span> is
+evaluated to obtain a key and <span class="RktVar">val-expr</span> is evaluated to
+obtain a value, the key is mapped to the value as a <a href="eval-model.html#%28tech._continuation._mark%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation mark</span></a> in the current
+continuation&rsquo;s initial <a href="eval-model.html#%28tech._continuation._frame%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation frame</span></a>. If the frame already has a mark for the
+key, the mark is replaced. Finally, the <span class="RktVar">result-expr</span> is evaluated;
+the continuation for evaluating <span class="RktVar">result-expr</span> is the
+continuation of the <span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span> expression (so the
+result of the <span class="RktVar">result-expr</span> is the result of the
+<span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span> expression, and <span class="RktVar">result-expr</span>
+is in tail position for the <span class="RktSym"><a href="wcm.html#%28form._%28%28quote._~23~25kernel%29._with-continuation-mark%29%29" class="RktStxLink" data-pltdoc="x">with-continuation-mark</a></span>
+expression).</div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="contmarks.html" data-pltdoc="x">Continuation Marks</a> provides more information on continuation marks.</p></blockquote></blockquote></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="for.html" title="backward to &quot;3.18 Iterations and Comprehensions: for, for/list, ...&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="quasiquote.html" title="forward to &quot;3.20 Quasiquoting: quasiquote, unquote, and unquote-splicing&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/weakbox.html b/clones/docs.racket-lang.org/reference/weakbox.html
new file mode 100644
index 00000000..3d6993bf
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/weakbox.html
@@ -0,0 +1,14 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>16.1&nbsp;Weak Boxes</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewselflink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.1&nbsp;</td><td><a href="weakbox.html" class="tocviewselflink" data-pltdoc="x">Weak Boxes</a></td></tr><tr><td align="right">16.2&nbsp;</td><td><a href="ephemerons.html" class="tocviewlink" data-pltdoc="x">Ephemerons</a></td></tr><tr><td align="right">16.3&nbsp;</td><td><a href="willexecutor.html" class="tocviewlink" data-pltdoc="x">Wills and Executors</a></td></tr><tr><td align="right">16.4&nbsp;</td><td><a href="garbagecollection.html" class="tocviewlink" data-pltdoc="x">Garbage Collection</a></td></tr><tr><td align="right">16.5&nbsp;</td><td><a href="phantom-bytes.html" class="tocviewlink" data-pltdoc="x">Phantom Byte Strings</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="weakbox.html#%28def._%28%28quote._~23~25kernel%29._make-weak-box%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>weak-<wbr></wbr>box</span></span></a></td></tr><tr><td><a href="weakbox.html#%28def._%28%28quote._~23~25kernel%29._weak-box-value%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">weak-<wbr></wbr>box-<wbr></wbr>value</span></span></a></td></tr><tr><td><a href="weakbox.html#%28def._%28%28quote._~23~25kernel%29._weak-box~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">weak-<wbr></wbr>box?</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="memory.html" title="backward to &quot;16 Memory Management&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="memory.html" title="up to &quot;16 Memory Management&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="ephemerons.html" title="forward to &quot;16.2 Ephemerons&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;weakbox&quot;">16.1<tt>&nbsp;</tt><a name="(part._weakbox)"></a>Weak Boxes</h4><p>A <a name="(tech._weak._box)"></a><span style="font-style: italic">weak box</span> is similar to a normal box (see
+<a href="boxes.html" data-pltdoc="x">Boxes</a>), but when the garbage collector (see
+<a href="eval-model.html#%28part._gc-model%29" data-pltdoc="x">Garbage Collection</a>) can prove that the content value of a weak box is
+only reachable via weak references, the content of the weak box is
+replaced with <span class="RktVal">#f</span>. A <span style="font-style: italic"><a href="eval-model.html#%28tech._weak._reference%29" class="techoutside" data-pltdoc="x"><span class="techinside">weak reference</span></a></span> is a
+reference through a weak box, through a key reference in a weak hash
+table (see <a href="hashtables.html" data-pltdoc="x">Hash Tables</a>), through a value in an <a href="ephemerons.html#%28tech._ephemeron%29" class="techoutside" data-pltdoc="x"><span class="techinside">ephemeron</span></a>
+where the value can be replaced by <span class="RktVal">#f</span> (see
+<a href="ephemerons.html" data-pltdoc="x">Ephemerons</a>), or through a custodian (see
+<a href="custodians.html" data-pltdoc="x">Custodians</a>).</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-weak-box))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="weakbox.html#%28def._%28%28quote._~23~25kernel%29._make-weak-box%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-weak-box</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="weakbox.html#%28def._%28%28quote._~23~25kernel%29._weak-box~3f%29%29" class="RktValLink" data-pltdoc="x">weak-box?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a new weak box that initially contains <span class="RktVar">v</span>.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._weak-box-value))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="weakbox.html#%28def._%28%28quote._~23~25kernel%29._weak-box-value%29%29" class="RktValDef RktValLink" data-pltdoc="x">weak-box-value</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">weak-box</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">gced-v</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">weak-box</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="weakbox.html#%28def._%28%28quote._~23~25kernel%29._weak-box~3f%29%29" class="RktValLink" data-pltdoc="x">weak-box?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">gced-v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the value contained in <span class="RktVar">weak-box</span>. If the garbage
+collector has proven that the previous content value of
+<span class="RktVar">weak-box</span> was reachable only through a weak reference, then
+<span class="RktVar">gced-v</span> (which defaults to <span class="RktVal">#f</span>) is returned.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._weak-box~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="weakbox.html#%28def._%28%28quote._~23~25kernel%29._weak-box~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">weak-box?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a weak box, <span class="RktVal">#f</span> otherwise.</div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="memory.html" title="backward to &quot;16 Memory Management&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="memory.html" title="up to &quot;16 Memory Management&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="ephemerons.html" title="forward to &quot;16.2 Ephemerons&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/when_unless.html b/clones/docs.racket-lang.org/reference/when_unless.html
new file mode 100644
index 00000000..9db72f93
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/when_unless.html
@@ -0,0 +1,6 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.16&nbsp;Guarded Evaluation: when and unless</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewselflink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="module.html" class="tocviewlink" data-pltdoc="x">Modules:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">module</span></span>, <span class="RktSym"><span class="RktStxLink">module*</span></span>, ...</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="require.html" class="tocviewlink" data-pltdoc="x">Importing and Exporting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span> and <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Literals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="__expression.html" class="tocviewlink" data-pltdoc="x">Expression Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%expression</span></span></a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="__top.html" class="tocviewlink" data-pltdoc="x">Variable References and <span class="RktSym"><span class="RktStxLink">#%top</span></span></a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="Locations____variable-reference.html" class="tocviewlink" data-pltdoc="x">Locations:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%variable-<wbr></wbr>reference</span></span></a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Procedure Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="local.html" class="tocviewlink" data-pltdoc="x">Local Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">local</span></span></a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="shared.html" class="tocviewlink" data-pltdoc="x">Constructing Graphs:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">shared</span></span></a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="if.html" class="tocviewlink" data-pltdoc="x">Conditionals:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">3.13&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">3.14&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span>, ...</a></td></tr><tr><td align="right">3.15&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>for-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.16&nbsp;</td><td><a href="when_unless.html" class="tocviewselflink" data-pltdoc="x">Guarded Evaluation:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr><tr><td align="right">3.17&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">3.18&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span>, ...</a></td></tr><tr><td align="right">3.19&nbsp;</td><td><a href="wcm.html" class="tocviewlink" data-pltdoc="x">Continuation Marks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>continuation-<wbr></wbr>mark</span></span></a></td></tr><tr><td align="right">3.20&nbsp;</td><td><a href="quasiquote.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-<wbr></wbr>splicing</span></span></a></td></tr><tr><td align="right">3.21&nbsp;</td><td><a href="Syntax_Quoting__quote-syntax.html" class="tocviewlink" data-pltdoc="x">Syntax Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote-<wbr></wbr>syntax</span></span></a></td></tr><tr><td align="right">3.22&nbsp;</td><td><a href="__top-interaction.html" class="tocviewlink" data-pltdoc="x">Interaction Wrapper:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%top-<wbr></wbr>interaction</span></span></a></td></tr><tr><td align="right">3.23&nbsp;</td><td><a href="block.html" class="tocviewlink" data-pltdoc="x">Blocks:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">block</span></span></a></td></tr><tr><td align="right">3.24&nbsp;</td><td><a href="stratified-body.html" class="tocviewlink" data-pltdoc="x">Internal-<wbr></wbr>Definition Limiting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">#%stratified-<wbr></wbr>body</span></span></a></td></tr><tr><td align="right">3.25&nbsp;</td><td><a href="performance-hint.html" class="tocviewlink" data-pltdoc="x">Performance Hints:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin-<wbr></wbr>encourage-<wbr></wbr>inline</span></span></a></td></tr><tr><td align="right">3.26&nbsp;</td><td><a href="lazy-require.html" class="tocviewlink" data-pltdoc="x">Importing Modules Lazily:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lazy-<wbr></wbr>require</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">when</span></span></a></td></tr><tr><td><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._unless%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="begin.html" title="backward to &quot;3.15 Sequencing: begin, begin0, and begin-for-syntax&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="set_.html" title="forward to &quot;3.17 Assignment: set! and set!-values&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;when+unless&quot;">3.16<tt>&nbsp;</tt><a name="(part._when+unless)"></a>Guarded Evaluation: <span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxLink" data-pltdoc="x">when</a></span> and <span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._unless%29%29" class="RktStxLink" data-pltdoc="x">unless</a></span></h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=begin.html%23%2528part._when%252Bunless%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Effects If...: <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Guide</a> introduces <span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxLink" data-pltdoc="x">when</a></span> and <span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._unless%29%29" class="RktStxLink" data-pltdoc="x">unless</a></span>.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/letstx-scheme..rkt)._when))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">when</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">test-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Evaluates <span class="RktVar">test-expr</span>. If the result is <span class="RktVal">#f</span>, then
+the result of the <span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxLink" data-pltdoc="x">when</a></span> expression is
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=guide&amp;rel=void_undefined.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>. Otherwise, the <span class="RktVar">body</span>s are evaluated, and the
+last <span class="RktVar">body</span> is in tail position with respect to the
+<span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxLink" data-pltdoc="x">when</a></span> form.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxLink" data-pltdoc="x">when</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-5</span></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hi"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxLink" data-pltdoc="x">when</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hi"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">" there"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">hi there</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>syntax</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(form._((lib._racket/private/letstx-scheme..rkt)._unless))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._unless%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">unless</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">test-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._when%29%29" class="RktStxLink" data-pltdoc="x">when</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._not%29%29" class="RktValLink" data-pltdoc="x">not</a></span><span class="stt"> </span><span class="RktVar">test-expr</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktMeta"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-patterns.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._......%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...+</a></span><span class="RktPn">)</span>.</div></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._unless%29%29" class="RktStxLink" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hi"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="when_unless.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._unless%29%29" class="RktStxLink" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="number-types.html#%28def._%28%28quote._~23~25kernel%29._positive~3f%29%29" class="RktValLink" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-5</span></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hi"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._display%29%29" class="RktValLink" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">" there"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">hi there</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="begin.html" title="backward to &quot;3.15 Sequencing: begin, begin0, and begin-for-syntax&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="syntax.html" title="up to &quot;3 Syntactic Forms&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="set_.html" title="forward to &quot;3.17 Assignment: set! and set!-values&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/willexecutor.html b/clones/docs.racket-lang.org/reference/willexecutor.html
new file mode 100644
index 00000000..fbe8cfe6
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/willexecutor.html
@@ -0,0 +1,45 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>16.3&nbsp;Wills and Executors</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewselflink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.1&nbsp;</td><td><a href="weakbox.html" class="tocviewlink" data-pltdoc="x">Weak Boxes</a></td></tr><tr><td align="right">16.2&nbsp;</td><td><a href="ephemerons.html" class="tocviewlink" data-pltdoc="x">Ephemerons</a></td></tr><tr><td align="right">16.3&nbsp;</td><td><a href="willexecutor.html" class="tocviewselflink" data-pltdoc="x">Wills and Executors</a></td></tr><tr><td align="right">16.4&nbsp;</td><td><a href="garbagecollection.html" class="tocviewlink" data-pltdoc="x">Garbage Collection</a></td></tr><tr><td align="right">16.5&nbsp;</td><td><a href="phantom-bytes.html" class="tocviewlink" data-pltdoc="x">Phantom Byte Strings</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._make-will-executor%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">make-<wbr></wbr>will-<wbr></wbr>executor</span></span></a></td></tr><tr><td><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-executor~3f%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">will-<wbr></wbr>executor?</span></span></a></td></tr><tr><td><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-register%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">will-<wbr></wbr>register</span></span></a></td></tr><tr><td><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-execute%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">will-<wbr></wbr>execute</span></span></a></td></tr><tr><td><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-try-execute%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">will-<wbr></wbr>try-<wbr></wbr>execute</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="ephemerons.html" title="backward to &quot;16.2 Ephemerons&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="memory.html" title="up to &quot;16 Memory Management&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="garbagecollection.html" title="forward to &quot;16.4 Garbage Collection&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;willexecutor&quot;">16.3<tt>&nbsp;</tt><a name="(part._willexecutor)"></a>Wills and Executors</h4><p>A <a name="(tech._will._executor)"></a><span style="font-style: italic">will executor</span> manages a collection of values and
+associated <a name="(tech._will)"></a><span style="font-style: italic">will</span> procedures
+(a.k.a. <a name="(tech._finalizer)"></a><span style="font-style: italic">finalizers</span>). The <a href="willexecutor.html#%28tech._will%29" class="techoutside" data-pltdoc="x"><span class="techinside">will</span></a> procedure for each
+value is ready to be executed when the value has been proven (by the
+garbage collector) to be unreachable, except through weak references
+(see <a href="weakbox.html" data-pltdoc="x">Weak Boxes</a>) or as the registrant for other will
+executors. A <a href="willexecutor.html#%28tech._will%29" class="techoutside" data-pltdoc="x"><span class="techinside">will</span></a> is useful for triggering clean-up actions on
+data associated with an unreachable value, such as closing a port
+embedded in an object when the object is no longer used.</p><p>Calling the <span class="RktSym"><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-execute%29%29" class="RktValLink" data-pltdoc="x">will-execute</a></span> or <span class="RktSym"><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-try-execute%29%29" class="RktValLink" data-pltdoc="x">will-try-execute</a></span>
+procedure executes a will that is ready in the specified will
+executor. A will executor is also a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a>, so <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%29%29" class="RktValLink" data-pltdoc="x">sync</a></span>
+or <span class="RktSym"><a href="sync.html#%28def._%28%28quote._~23~25kernel%29._sync%2Ftimeout%29%29" class="RktValLink" data-pltdoc="x">sync/timeout</a></span> can be used to detect when a will executor has
+ready wills. Wills are not executed automatically, because certain
+programs need control to avoid race conditions. However, a program can
+create a thread whose sole job is to execute wills for a particular
+executor.</p><p>If a value is registered with multiple wills (in one or multiple
+executors), the wills are readied in the reverse order of
+registration. Since readying a will procedure makes the value
+reachable again, the will must be executed and the value must be
+proven again unreachable through only weak references before another
+of the wills is readied or executed.  However, wills for distinct
+unreachable values are readied at the same time, regardless of whether
+the values are reachable from each other.</p><p>A will executor&rsquo;s registrant is held non-weakly until after the
+corresponding will procedure is executed. Thus, if the content value
+of a weak box (see <a href="weakbox.html" data-pltdoc="x">Weak Boxes</a>) is registered with a will
+executor, the weak box&rsquo;s content is not changed to <span class="RktVal">#f</span> until
+all wills have been executed for the value and the value has been
+proven again reachable through only weak references.</p><p>A will executor can be used as a <a href="sync.html#%28tech._synchronizable._event%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronizable event</span></a> (see <a href="sync.html" data-pltdoc="x">Events</a>).
+A will executor is <a href="sync.html#%28tech._ready._for._synchronization%29" class="techoutside" data-pltdoc="x"><span class="techinside">ready for synchronization</span></a> when
+<span class="RktSym"><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-execute%29%29" class="RktValLink" data-pltdoc="x">will-execute</a></span> would not block; the <a href="sync.html#%28tech._synchronization._result%29" class="techoutside" data-pltdoc="x"><span class="techinside">synchronization result</span></a> of a will executor is the will executor itself.</p><p><div class="SIntrapara">These examples show how to run cleanup actions when
+no synchronization is necessary. It simply runs the registered
+executors as they become ready in another thread.
+</div><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">an-executor</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._make-will-executor%29%29" class="RktValLink" data-pltdoc="x">make-will-executor</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void%29%29" class="RktValLink" data-pltdoc="x">void</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="threads.html#%28def._%28%28quote._~23~25kernel%29._thread%29%29" class="RktValLink" data-pltdoc="x">thread</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="lambda.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._~ce~bb%29%29" class="RktStxLink" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="let.html#%28form._%28%28lib._racket%2Fprivate%2Fletstx-scheme..rkt%29._let%29%29" class="RktStxLink" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-execute%29%29" class="RktValLink" data-pltdoc="x">will-execute</a></span><span class="hspace">&nbsp;</span><span class="RktSym">an-executor</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">executor-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="Writing.html#%28def._%28%28quote._~23~25kernel%29._printf%29%29" class="RktValLink" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a-box is now garbage\n"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="define.html#%28form._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._define%29%29" class="RktStxLink" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a-box-to-track</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="boxes.html#%28def._%28%28quote._~23~25kernel%29._box%29%29" class="RktValLink" data-pltdoc="x">box</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-register%29%29" class="RktValLink" data-pltdoc="x">will-register</a></span><span class="hspace">&nbsp;</span><span class="RktSym">an-executor</span><span class="hspace">&nbsp;</span><span class="RktSym">a-box-to-track</span><span class="hspace">&nbsp;</span><span class="RktSym">executor-proc</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="garbagecollection.html#%28def._%28%28quote._~23~25kernel%29._collect-garbage%29%29" class="RktValLink" data-pltdoc="x">collect-garbage</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="set_.html#%28form._%28%28quote._~23~25kernel%29._set%21%29%29" class="RktStxLink" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a-box-to-track</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="garbagecollection.html#%28def._%28%28quote._~23~25kernel%29._collect-garbage%29%29" class="RktValLink" data-pltdoc="x">collect-garbage</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">a-box is now garbage</span></p></td></tr></table></blockquote></div></p></div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._make-will-executor))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._make-will-executor%29%29" class="RktValDef RktValLink" data-pltdoc="x">make-will-executor</a></span></span><span class="RktPn"></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-executor~3f%29%29" class="RktValLink" data-pltdoc="x">will-executor?</a></span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Returns a new will executor with no managed values.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._will-executor~3f))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-executor~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">will-executor?</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="booleans.html#%28def._%28%28quote._~23~25kernel%29._boolean~3f%29%29" class="RktValLink" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">v</span> is a will executor, <span class="RktVal">#f</span>
+otherwise.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._will-register))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-register%29%29" class="RktValDef RktValLink" data-pltdoc="x">will-register</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">executor</span><span class="hspace">&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span><span class="RktVar">proc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="void.html#%28def._%28%28quote._~23~25kernel%29._void~3f%29%29" class="RktValLink" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">executor</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-executor~3f%29%29" class="RktValLink" data-pltdoc="x">will-executor?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">proc</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="function-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fbase..rkt%29._-~3e%29%29" class="RktStxLink" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Registers the value <span class="RktVar">v</span> with the will procedure <span class="RktVar">proc</span>
+in the will executor <span class="RktVar">executor</span>. When <span class="RktVar">v</span> is proven
+unreachable, then the procedure <span class="RktVar">proc</span> is ready to be called
+with <span class="RktVar">v</span> as its argument via <span class="RktSym"><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-execute%29%29" class="RktValLink" data-pltdoc="x">will-execute</a></span> or
+<span class="RktSym"><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-try-execute%29%29" class="RktValLink" data-pltdoc="x">will-try-execute</a></span>.  The <span class="RktVar">proc</span> argument is strongly
+referenced until the will procedure is executed.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._will-execute))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-execute%29%29" class="RktValDef RktValLink" data-pltdoc="x">will-execute</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">executor</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">executor</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-executor~3f%29%29" class="RktValLink" data-pltdoc="x">will-executor?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Invokes the will procedure for a single &ldquo;unreachable&rdquo; value
+registered with the executor <span class="RktVar">executor</span>. The values returned
+by the will procedure are the result of the <span class="RktSym"><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-execute%29%29" class="RktValLink" data-pltdoc="x">will-execute</a></span>
+call.  If no will is ready for immediate execution,
+<span class="RktSym"><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-execute%29%29" class="RktValLink" data-pltdoc="x">will-execute</a></span> blocks until one is ready.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((quote._~23~25kernel)._will-try-execute))"></a><span title="Provided from: racket/base, racket | Package: base"><span class="RktSym"><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-try-execute%29%29" class="RktValDef RktValLink" data-pltdoc="x">will-try-execute</a></span></span><span class="hspace">&nbsp;</span><span class="RktVar">executor</span><span class="hspace">&nbsp;</span><span class="RktOpt">[</span><span class="RktVar">v</span><span class="RktOpt">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span>&rarr;<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28form._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%29%29" class="RktStxLink" data-pltdoc="x">any</a></span></p></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">executor</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">v</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="data-structure-contracts.html#%28def._%28%28lib._racket%2Fcontract%2Fprivate%2Fmisc..rkt%29._any%2Fc%29%29" class="RktValLink" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="willexecutor.html#%28def._%28%28quote._~23~25kernel%29._will-execute%29%29" class="RktValLink" data-pltdoc="x">will-execute</a></span> if a will is ready for immediate
+execution. Otherwise, <span class="RktVar">v</span> is returned.</div></p><p class="SHistory">Changed in version 6.90.0.4 of package <span class="stt">base</span>: Added the <span class="RktVar">v</span> argument.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="ephemerons.html" title="backward to &quot;16.2 Ephemerons&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="memory.html" title="up to &quot;16 Memory Management&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="garbagecollection.html" title="forward to &quot;16.4 Garbage Collection&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/docs.racket-lang.org/reference/windowspaths.html b/clones/docs.racket-lang.org/reference/windowspaths.html
new file mode 100644
index 00000000..78ebbb27
--- /dev/null
+++ b/clones/docs.racket-lang.org/reference/windowspaths.html
@@ -0,0 +1,245 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15.1.4&nbsp;Windows Paths</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="extras.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Reference</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="model.html" class="tocviewlink" data-pltdoc="x">Language Model</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="notation.html" class="tocviewlink" data-pltdoc="x">Notation for Documentation</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="syntax.html" class="tocviewlink" data-pltdoc="x">Syntactic Forms</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="data.html" class="tocviewlink" data-pltdoc="x">Datatypes</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="structures.html" class="tocviewlink" data-pltdoc="x">Structures</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="mzlib_class.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="mzlib_unit.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Control Flow</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Parallelism</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="Macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="input-and-output.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="security.html" class="tocviewlink" data-pltdoc="x">Reflection and Security</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="os.html" class="tocviewselflink" data-pltdoc="x">Operating System</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="memory.html" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="unsafe.html" class="tocviewlink" data-pltdoc="x">Unsafe Operations</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running Racket</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>15&nbsp;</td><td><a href="os.html" class="tocviewlink" data-pltdoc="x">Operating System</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewselflink" data-pltdoc="x">Paths</a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="Filesystem.html" class="tocviewlink" data-pltdoc="x">Filesystem</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="networking.html" class="tocviewlink" data-pltdoc="x">Networking</a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="subprocess.html" class="tocviewlink" data-pltdoc="x">Processes</a></td></tr><tr><td align="right">15.5&nbsp;</td><td><a href="logging.html" class="tocviewlink" data-pltdoc="x">Logging</a></td></tr><tr><td align="right">15.6&nbsp;</td><td><a href="time.html" class="tocviewlink" data-pltdoc="x">Time</a></td></tr><tr><td align="right">15.7&nbsp;</td><td><a href="envvars.html" class="tocviewlink" data-pltdoc="x">Environment Variables</a></td></tr><tr><td align="right">15.8&nbsp;</td><td><a href="runtime.html" class="tocviewlink" data-pltdoc="x">Environment and Runtime Information</a></td></tr><tr><td align="right">15.9&nbsp;</td><td><a href="Command-Line_Parsing.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Parsing</a></td></tr><tr><td align="right">15.10&nbsp;</td><td><a href="os-lib.html" class="tocviewlink" data-pltdoc="x">Additional Operating System Functions</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>15.1&nbsp;</td><td><a href="pathutils.html" class="tocviewlink" data-pltdoc="x">Paths</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1.1&nbsp;</td><td><a href="Manipulating_Paths.html" class="tocviewlink" data-pltdoc="x">Manipulating Paths</a></td></tr><tr><td align="right">15.1.2&nbsp;</td><td><a href="More_Path_Utilities.html" class="tocviewlink" data-pltdoc="x">More Path Utilities</a></td></tr><tr><td align="right">15.1.3&nbsp;</td><td><a href="unixpaths.html" class="tocviewlink" data-pltdoc="x">Unix and Mac OS Paths</a></td></tr><tr><td align="right">15.1.4&nbsp;</td><td><a href="windowspaths.html" class="tocviewselflink" data-pltdoc="x">Windows Paths</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_3&quot;);">&#9658;</a></td><td>15.1.4&nbsp;</td><td><a href="windowspaths.html" class="tocviewselflink" data-pltdoc="x">Windows Paths</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_3"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1.4.1&nbsp;</td><td><a href="windowspaths.html#%28part._windowspathrep%29" class="tocviewlink" data-pltdoc="x">Windows Path Representation</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">15.1.4.1<tt>&nbsp;</tt></span><a href="windowspaths.html#%28part._windowspathrep%29" class="tocsubseclink" data-pltdoc="x">Windows Path Representation</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="unixpaths.html" title="backward to &quot;15.1.3 Unix and Mac OS Paths&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="pathutils.html" title="up to &quot;15.1 Paths&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Filesystem.html" title="forward to &quot;15.2 Filesystem&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;windowspaths&quot;">15.1.4<tt>&nbsp;</tt><a name="(part._windowspaths)"></a>Windows Paths</h5><p>In general, a Windows pathname consists of an optional drive specifier
+and a drive-specific path. A Windows path can be <span style="font-style: italic">absolute</span>
+but still relative to the current drive; such paths start with a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> separator and are not UNC paths or paths
+that start with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span>.</p><p>A path that starts with a drive specification is <span style="font-style: italic">complete</span>.
+Roughly, a drive specification is either a Latin letter followed by a
+colon, a UNC path of the form
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">machine</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">volume</span>&#8250;</span>, or a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span> form followed by something other than
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">REL\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">element</span>&#8250;</span>, or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">RED\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">element</span>&#8250;</span>. (Variants of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span>
+paths are described further below.)</p><p>Racket fails to implement the usual Windows path syntax in one
+way. Outside of Racket, a pathname <span class="stt">"C:rant.txt"</span> can be a
+drive-specific relative path. That is, it names a file <span class="stt">"rant.txt"</span>
+on drive <span class="stt">"C:"</span>, but the complete path to the file is determined by
+the current working directory for drive <span class="stt">"C:"</span>. Racket does not
+support drive-specific working directories (only a working directory
+across all drives, as reflected by the <span class="RktSym"><a href="Filesystem.html#%28def._%28%28quote._~23~25kernel%29._current-directory%29%29" class="RktValLink" data-pltdoc="x">current-directory</a></span>
+parameter). Consequently, Racket implicitly converts a path like
+<span class="stt">"C:rant.txt"</span> into <span class="stt">"C:\rant.txt"</span>.</p><ul><li><p><span style="font-style: italic">Racket-specific:</span> Whenever a path starts with a drive specifier
+<span class="sroman">&#8249;<span style="font-style: italic">letter</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">:</span><span class="hspace"></span></span> that is not followed by a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>, a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> is inserted as
+the path is <a href="pathutils.html#%28tech._cleanse%29" class="techoutside" data-pltdoc="x"><span class="techinside">cleanse</span></a>d.</p></li></ul><p>Otherwise, Racket follows standard Windows path conventions, but also
+ adds <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\RED</span><span class="hspace"></span></span> conventions to
+ deal with paths inexpressible in the standard convention, plus
+ conventions to deal with excessive <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s in <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span>
+ paths.</p><p>In the following, <span class="sroman">&#8249;<span style="font-style: italic">letter</span>&#8250;</span> stands for a Latin letter (case
+does not matter), <span class="sroman">&#8249;<span style="font-style: italic">machine</span>&#8250;</span> stands for any sequence of
+characters that does not include <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> and is
+not <span class="RktInBG"><span class="hspace"></span><span class="RktIn">?</span><span class="hspace"></span></span>, <span class="sroman">&#8249;<span style="font-style: italic">volume</span>&#8250;</span> stands for any sequence of
+characters that does not include <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> , and
+<span class="sroman">&#8249;<span style="font-style: italic">element</span>&#8250;</span> stands for any sequence of characters that does not
+include <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>.</p><ul><li><p>Trailing spaces and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> in a path element are ignored
+when the element is the last one in the path, unless the path
+starts with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span> or the element consists of only
+spaces and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>s.</p></li><li><p>The following special &ldquo;files&rdquo;, which access devices, exist in
+all directories, case-insensitively, and with all possible
+endings after a period or colon, except in pathnames that start
+with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span>: <a name="(idx._(gentag._293._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"NUL"</span>, <a name="(idx._(gentag._294._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"CON"</span>,
+<a name="(idx._(gentag._295._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"PRN"</span>, <a name="(idx._(gentag._296._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"AUX"</span>, <a name="(idx._(gentag._297._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"COM1"</span>,
+<a name="(idx._(gentag._298._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"COM2"</span>, <a name="(idx._(gentag._299._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"COM3"</span>, <a name="(idx._(gentag._300._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"COM4"</span>,
+<a name="(idx._(gentag._301._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"COM5"</span>, <a name="(idx._(gentag._302._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"COM6"</span>, <a name="(idx._(gentag._303._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"COM7"</span>,
+<a name="(idx._(gentag._304._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"COM8"</span>, <a name="(idx._(gentag._305._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"COM9"</span>, <a name="(idx._(gentag._306._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"LPT1"</span>,
+<a name="(idx._(gentag._307._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"LPT2"</span>, <a name="(idx._(gentag._308._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"LPT3"</span>, <a name="(idx._(gentag._309._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"LPT4"</span>,
+<a name="(idx._(gentag._310._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"LPT5"</span>, <a name="(idx._(gentag._311._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"LPT6"</span>, <a name="(idx._(gentag._312._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"LPT7"</span>,
+<a name="(idx._(gentag._313._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"LPT8"</span>, <a name="(idx._(gentag._314._(lib._scribblings/reference/reference..scrbl)))"></a><span class="stt">"LPT9"</span>.</p></li><li><p>Except for <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span> paths, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>s are
+equivalent to <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s. Except for <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span>
+paths and the start of UNC paths, multiple adjacent
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>s and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s count as a single
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>. In a path that starts <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span>
+paths, elements can be separated by either a single or double
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>.</p></li><li><p>A directory can be accessed with or without a trailing
+separator. In the case of a non-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span> path, the
+trailing separator can be any number of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>s and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s; in the case of a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span> path, a
+trailing separator must be a single <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>, except that
+two <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s can follow
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">letter</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">:</span><span class="hspace"></span></span>.</p></li><li><p>Except for <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span> paths, a single <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> as a
+path element means &ldquo;the current directory,&rdquo; and a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">..</span><span class="hspace"></span></span> as a path element means &ldquo;the parent directory.&rdquo;
+Up-directory path elements (i.e., <span class="RktInBG"><span class="hspace"></span><span class="RktIn">..</span><span class="hspace"></span></span>) immediately
+after a drive are ignored.</p></li><li><p>A pathname that starts
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">machine</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">volume</span>&#8250;</span>
+(where a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> can replace any <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>) is a UNC
+path, and the starting
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">machine</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">volume</span>&#8250;</span>
+counts as the drive specifier.</p></li><li><p>Normally, a path element cannot contain a character in the
+range <span class="RktVal">#\x</span><span class="stt"> </span><span class="RktVal">0</span> to <span class="RktVal">#\x</span><span class="stt"> </span><span class="RktSym">1F</span> nor any of the following
+characters:</p><blockquote class="SCentered"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">&lt;</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">&gt;</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">:</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">"</span><span class="hspace"></span></span>
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">?</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">*</span><span class="hspace"></span></span></p></blockquote><p>Except for <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>, path elements containing these
+characters can be accessed using a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span> path
+(assuming that the underlying filesystem allows the
+characters).</p></li><li><p>In a pathname that starts
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">letter</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">:\</span><span class="hspace"></span></span>, the
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">letter</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">:\</span><span class="hspace"></span></span> prefix
+counts as the path&rsquo;s drive, as long as the path does not both
+contain non-drive elements and end with two consecutive
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s, and as long as the path contains no sequence
+of three or more <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s. Two <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s can
+appear in place of the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> before
+<span class="sroman">&#8249;<span style="font-style: italic">letter</span>&#8250;</span>. A <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> cannot be used in place of a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> (but <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>s can be used in element names,
+though the result typically does not name an actual directory
+or file).</p></li><li><p>In a pathname that starts
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\UNC\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">machine</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">volume</span>&#8250;</span>,
+the
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\UNC\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">machine</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">volume</span>&#8250;</span>
+prefix counts as the path&rsquo;s drive, as long as the path does
+not end with two consecutive <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s, and as long as
+the path contains no sequence of three or more
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s. Two <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s can appear in place of
+the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> before <span class="RktInBG"><span class="hspace"></span><span class="RktIn">UNC</span><span class="hspace"></span></span>, the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s
+after <span class="RktInBG"><span class="hspace"></span><span class="RktIn">UNC</span><span class="hspace"></span></span>, and/or the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s
+after<span class="sroman">&#8249;<span style="font-style: italic">machine</span>&#8250;</span>.  The letters in the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">UNC</span><span class="hspace"></span></span> part
+can be uppercase or lowercase, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> cannot be used
+in place of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s (but <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> can be used in
+element names).</p></li><li><p><span style="font-style: italic">Racket-specific:</span> A pathname that starts
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">element</span>&#8250;</span> or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL\\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">element</span>&#8250;</span> is a relative
+path, as long as the path does not end with two consecutive
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s, and as long as the path contains no sequence of
+three or more <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s. This Racket-specific path form
+supports relative paths with elements that are not normally
+expressible in Windows paths (e.g., a final element that ends
+in a space). The <a name="(idx._(gentag._315._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">REL</span><span class="hspace"></span></span> part must be exactly the three
+uppercase letters, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>s cannot be used in place
+of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s. If the path starts
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL\..</span><span class="hspace"></span></span>  then for as long as the
+path continues with repetitions of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\..</span><span class="hspace"></span></span>,
+each element counts as an up-directory element; a single
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> must be used to separate the up-directory
+elements. As soon as a second <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> is used to separate
+the elements, or as soon as a non-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">..</span><span class="hspace"></span></span>  element is
+encountered, the remaining elements are all literals (never
+up-directory elements). When a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL</span><span class="hspace"></span></span> path
+value is converted to a string (or when the path value is
+written or displayed), the string does not contain the
+starting <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL</span><span class="hspace"></span></span> or the immediately following
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s; converting a path value to a byte string
+preserves the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL</span><span class="hspace"></span></span> prefix.</p></li><li><p><span style="font-style: italic">Racket-specific:</span> A pathname that starts
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\RED\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">element</span>&#8250;</span> or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\RED\\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">element</span>&#8250;</span> is a
+drive-relative path, as long as the path does not end with two
+consecutive <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s, and as long as the path contains
+no sequence of three or more <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s. This
+Racket-specific path form supports drive-relative paths (i.e.,
+absolute given a drive) with elements that are not normally
+expressible in Windows paths. The <a name="(idx._(gentag._316._(lib._scribblings/reference/reference..scrbl)))"></a><span class="RktInBG"><span class="hspace"></span><span class="RktIn">RED</span><span class="hspace"></span></span> part must be
+exactly the three uppercase letters, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>s cannot
+be used in place of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s. Unlike
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL</span><span class="hspace"></span></span> paths, a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">..</span><span class="hspace"></span></span> element is always
+a literal path element. When a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\RED</span><span class="hspace"></span></span> path
+value is converted to a string (or when the path value is
+written or displayed), the string does not contain the
+starting <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\RED</span><span class="hspace"></span></span> and it contains a single
+starting <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>; converting a path value to a byte
+string preserves the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\RED</span><span class="hspace"></span></span> prefix.</p></li></ul><p>Three additional Racket-specific rules provide meanings to character
+sequences that are otherwise ill-formed as Windows paths:</p><ul><li><p><span style="font-style: italic">Racket-specific:</span> In a pathname of the form
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">any</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\</span><span class="hspace"></span></span> where
+<span class="sroman">&#8249;<span style="font-style: italic">any</span>&#8250;</span> is any non-empty sequence of characters other
+than <span class="sroman">&#8249;<span style="font-style: italic">letter</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">:</span><span class="hspace"></span></span> or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">letter</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">:</span><span class="hspace"></span></span>, the entire path
+counts as the path&rsquo;s (non-existent) drive.</p></li><li><p><span style="font-style: italic">Racket-specific:</span> In a pathname of the form
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">any</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">elements</span>&#8250;</span>,
+where <span class="sroman">&#8249;<span style="font-style: italic">any</span>&#8250;</span> is any non-empty sequence of characters
+and <span class="sroman">&#8249;<span style="font-style: italic">elements</span>&#8250;</span> is any sequence that does not start
+with a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>, does not end with two <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s,
+and does not contain a sequence of three <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s, then
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span><span class="sroman">&#8249;<span style="font-style: italic">any</span>&#8250;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\</span><span class="hspace"></span></span> counts as the
+path&rsquo;s (non-existent) drive.</p></li><li><p><span style="font-style: italic">Racket-specific:</span> In a pathname that starts <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span> and
+does not match any of the patterns from the preceding bullets,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span> counts as the path&rsquo;s (non-existent)
+drive.</p></li></ul><p>Outside of Racket, except for <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span> paths, pathnames are
+ typically limited to 259 characters when used as a file path and 247 characters when
+ used as a directory path. Racket internally converts
+ pathnames longer than 247 characters to <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span> form to avoid the
+ limits; in that case, the path is first simplified syntactically (in the
+ sense of <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._simplify-path%29%29" class="RktValLink" data-pltdoc="x">simplify-path</a></span>). The operating system cannot access files through
+ <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span> paths that are longer than 32,000 characters or
+ so.</p><p>Where the above descriptions says &ldquo;character,&rdquo; substitute &ldquo;byte&rdquo;
+for interpreting byte strings as paths. The encoding of Windows paths
+into bytes preserves ASCII characters, and all special characters
+mentioned above are ASCII, so all of the rules are the same.</p><p>Beware that the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> path separator is an escape character
+in Racket strings. Thus, the path <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL\..\\..</span><span class="hspace"></span></span>  as
+a string must be written <span class="RktVal">"\\\\?\\REL\\..\\\\.."</span>.</p><p>A path that ends with a directory separator syntactically refers to a
+directory.  In addition, a path syntactically refers to a directory if
+its last element is a same-directory or up-directory indicator (not
+quoted by a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span> form), or if it refers to a root.</p><p>Even on variants of Windows that support symbolic links, up-directory
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">..</span><span class="hspace"></span></span> indicators in a path are resolved syntactically, not
+sensitive to links. For example, if a path ends with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">d\..\f</span><span class="hspace"></span></span>
+and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">d</span><span class="hspace"></span></span> refers to a symbolic link that references a directory
+with a different parent than <span class="RktInBG"><span class="hspace"></span><span class="RktIn">d</span><span class="hspace"></span></span>, the path nevertheless refers
+to <span class="RktInBG"><span class="hspace"></span><span class="RktIn">f</span><span class="hspace"></span></span> in the same directory as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">d</span><span class="hspace"></span></span>. A relative-path
+link is parsed as if prefixed with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL</span><span class="hspace"></span></span> paths, except
+that <span class="RktInBG"><span class="hspace"></span><span class="RktIn">..</span><span class="hspace"></span></span>  and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> elements are allowed throughout the
+path, and any number of redundant <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> separators are allowed.</p><p>Windows paths are <a href="pathutils.html#%28tech._cleanse%29" data-pltdoc="x">cleanse</a>d as follows: In paths that start
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span>, redundant <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s are removed, an extra
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> is added in a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL</span><span class="hspace"></span></span> if an extra one is
+not already present to separate up-directory indicators from literal
+path elements, and an extra <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> is similarly added after
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\RED</span><span class="hspace"></span></span> if an extra one is not already present.
+For other paths, multiple <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>s and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s are
+converted to single <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>s or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> (except at the beginning of a shared
+folder name), and a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> is inserted after the colon in a drive
+specification if it is missing.</p><p>For <span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath-element%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;path-element</a></span><span class="stt"> </span><span class="RktVar">bstr</span><span class="RktPn">)</span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>s, colons,
+trailing dots, trailing whitespace, and special device names (e.g.,
+&ldquo;aux&rdquo;) in <span class="RktVar">bstr</span> are encoded as a literal part of the path
+element by using a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL</span><span class="hspace"></span></span> prefix.  The <span class="RktSym">bstr</span>
+argument must not contain a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>, otherwise the
+<span class="RktSym"><a href="exns.html#%28def._%28%28lib._racket%2Fprivate%2Fbase..rkt%29._exn~3afail~3acontract%29%29" class="RktValLink" data-pltdoc="x">exn:fail:contract</a></span> exception is raised.</p><p>For <span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-element-~3ebytes%29%29" class="RktValLink" data-pltdoc="x">path-element-&gt;bytes</a></span><span class="stt"> </span><span class="RktVar">path</span><span class="RktPn">)</span> or
+<span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-element-~3estring%29%29" class="RktValLink" data-pltdoc="x">path-element-&gt;string</a></span><span class="stt"> </span><span class="RktVar">path</span><span class="RktPn">)</span>, if the byte-string form of
+<span class="RktVar">path</span> starts with a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL</span><span class="hspace"></span></span>, the prefix is not
+included in the result.</p><p>For <span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._build-path%29%29" class="RktValLink" data-pltdoc="x">build-path</a></span><span class="stt"> </span><span class="RktVar">base-path</span><span class="stt"> </span><span class="RktVar">sub-path</span><span class="stt"> </span><span class="RktSym"><a href="stx-patterns.html#%28form._%28%28lib._racket%2Fprivate%2Fstxcase-scheme..rkt%29._......%29%29" class="RktStxLink" data-pltdoc="x">...</a></span><span class="RktPn">)</span>, trailing spaces
+and periods are removed from the last element of <span class="RktVar">base-path</span>
+and all but the last <span class="RktVar">sub-path</span> (unless the element consists of
+only spaces and periods), except for those that start with
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span>. If <span class="RktVar">base-path</span> starts <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span>,
+then after each non-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL\</span><span class="hspace"></span></span> and
+non-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\RED\</span><span class="hspace"></span></span> <span class="RktVar">sub-path</span> is added, all
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>s in the addition are converted to <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s,
+multiple consecutive <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s are converted to a single
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>, added <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> elements are removed, and added
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">..</span><span class="hspace"></span></span> elements are removed along with the preceding element;
+these conversions are not performed on the original <span class="RktVar">base-path</span>
+part of the result or on any <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL\</span><span class="hspace"></span></span> or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\RED\</span><span class="hspace"></span></span> or <span class="RktVar">sub-path</span>.  If a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL\</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\RED\</span><span class="hspace"></span></span>
+<span class="RktVar">sub-path</span> is added to a non-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span>
+<span class="RktVar">base-path</span>, the <span class="RktVar">base-path</span> (with any additions up
+to the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL\</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\RED\</span><span class="hspace"></span></span>
+<span class="RktVar">sub-path</span>) is simplified and converted to a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span> path.  In other cases, a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> may be
+added or removed before combining paths to avoid changing the root
+meaning of the path (e.g., combining <span class="RktInBG"><span class="hspace"></span><span class="RktIn">//x</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">y</span><span class="hspace"></span></span>
+produces <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/x/y</span><span class="hspace"></span></span>, because <span class="RktInBG"><span class="hspace"></span><span class="RktIn">//x/y</span><span class="hspace"></span></span> would be a UNC path
+instead of a drive-relative path).</p><p>For <span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._simplify-path%29%29" class="RktValLink" data-pltdoc="x">simplify-path</a></span><span class="stt"> </span><span class="RktVar">path</span><span class="stt"> </span><span class="RktVar">use-filesystem?</span><span class="RktPn">)</span>, <span class="RktVar">path</span> is
+expanded, and if <span class="RktVar">path</span> does not start with
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span>, trailing spaces and periods are removed, a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> is inserted after the colon in a drive specification if it
+is missing, and a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> is inserted after <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span>
+as a root if there are elements and no extra <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>
+already. Otherwise, if no indicators or redundant separators are in
+<span class="RktVar">path</span>, then <span class="RktVar">path</span> is returned.</p><p>For <span class="RktPn">(</span><span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._split-path%29%29" class="RktValLink" data-pltdoc="x">split-path</a></span><span class="stt"> </span><span class="RktVar">path</span><span class="RktPn">)</span> producing <span class="RktVar">base</span>,
+<span class="RktVar">name</span>, and <span class="RktVar">must-be-dir?</span>, splitting a path that does
+not start with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span> can produce parts that start with
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span>. For example, splitting <span class="RktInBG"><span class="hspace"></span><span class="RktIn">C:/x /aux/</span><span class="hspace"></span></span> twice
+produces <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL\\x</span><span class="hspace">&nbsp;</span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\REL\\aux</span><span class="hspace"></span></span>;
+the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\?\</span><span class="hspace"></span></span> is needed in these cases to preserve a
+trailing space after <span class="RktInBG"><span class="hspace"></span><span class="RktIn">x</span><span class="hspace"></span></span> and to avoid referring to the AUX
+device instead of an <span class="stt">"aux"</span> file.</p><h5 x-source-module="(lib &quot;scribblings/reference/reference.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;windowspathrep&quot;">15.1.4.1<tt>&nbsp;</tt><a name="(part._windowspathrep)"></a>Windows Path Representation</h5><p>A path on Windows is natively a sequence of UTF-16 code units, where
+the sequence can include unpaired surrogates. This sequence is encoded
+as a byte string through an extension of UTF-8, where unpaired
+surrogates in the UTF-16 code-unit sequence are converted as if they
+were non-surrogate values. The extended encodings are implemented on
+Windows as the <span class="RktVal">"platform-UTF-16"</span> and
+<span class="RktVal">"platform-UTF-8"</span> encodings for <span class="RktSym"><a href="bytestrings.html#%28def._%28%28quote._~23~25kernel%29._bytes-open-converter%29%29" class="RktValLink" data-pltdoc="x">bytes-open-converter</a></span>.</p><p>Racket&rsquo;s internal representation of a Windows path is a byte string,
+so that <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._path-~3ebytes%29%29" class="RktValLink" data-pltdoc="x">path-&gt;bytes</a></span> and <span class="RktSym"><a href="Manipulating_Paths.html#%28def._%28%28quote._~23~25kernel%29._bytes-~3epath%29%29" class="RktValLink" data-pltdoc="x">bytes-&gt;path</a></span> are always
+inverses. When converting a path to a native UTF-16 code-unit
+sequence, <span class="RktVal">#\tab</span> is used in place of platform-UTF-8 decoding
+errors (on the grounds that tab is normally disallowed as a character
+in a Windows path, unlike <span class="RktVal">#\uFFFD</span><span class="RktMeta"></span>).</p><p>A Windows path is converted to a string by treating the platform-UTF-8
+encoding as a UTF-8 encoding with <span class="RktVal">#\uFFFD</span><span class="RktMeta"></span> in place of
+decoding errors. Similarly, a string is converted to a path by UTF-8
+encoding (in which case no errors are possible).</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://docs.racket-lang.org/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="unixpaths.html" title="backward to &quot;15.1.3 Unix and Mac OS Paths&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="pathutils.html" title="up to &quot;15.1 Paths&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Filesystem.html" title="forward to &quot;15.2 Filesystem&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/doc-site.css b/clones/download.racket-lang.org/releases/8.6/doc/doc-site.css
new file mode 100644
index 00000000..e69de29b
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/doc-site.js b/clones/download.racket-lang.org/releases/8.6/doc/doc-site.js
new file mode 100644
index 00000000..e69de29b
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/An_Extended_Example.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/An_Extended_Example.html
new file mode 100644
index 00000000..a65bfa6e
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/An_Extended_Example.html
@@ -0,0 +1,22 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>9.10&nbsp;An Extended Example</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewselflink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">9.1&nbsp;</td><td><a href="regexp-intro.html" class="tocviewlink" data-pltdoc="x">Writing Regexp Patterns</a></td></tr><tr><td align="right">9.2&nbsp;</td><td><a href="regexp-match.html" class="tocviewlink" data-pltdoc="x">Matching Regexp Patterns</a></td></tr><tr><td align="right">9.3&nbsp;</td><td><a href="regexp-assert.html" class="tocviewlink" data-pltdoc="x">Basic Assertions</a></td></tr><tr><td align="right">9.4&nbsp;</td><td><a href="regexp-chars.html" class="tocviewlink" data-pltdoc="x">Characters and Character Classes</a></td></tr><tr><td align="right">9.5&nbsp;</td><td><a href="regexp-quant.html" class="tocviewlink" data-pltdoc="x">Quantifiers</a></td></tr><tr><td align="right">9.6&nbsp;</td><td><a href="regexp-clusters.html" class="tocviewlink" data-pltdoc="x">Clusters</a></td></tr><tr><td align="right">9.7&nbsp;</td><td><a href="regexp-alternation.html" class="tocviewlink" data-pltdoc="x">Alternation</a></td></tr><tr><td align="right">9.8&nbsp;</td><td><a href="Backtracking.html" class="tocviewlink" data-pltdoc="x">Backtracking</a></td></tr><tr><td align="right">9.9&nbsp;</td><td><a href="Looking_Ahead_and_Behind.html" class="tocviewlink" data-pltdoc="x">Looking Ahead and Behind</a></td></tr><tr><td align="right">9.10&nbsp;</td><td><a href="An_Extended_Example.html" class="tocviewselflink" data-pltdoc="x">An Extended Example</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Looking_Ahead_and_Behind.html" title="backward to &quot;9.9 Looking Ahead and Behind&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="regexp.html" title="up to &quot;9 Regular Expressions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="control.html" title="forward to &quot;10 Exceptions and Control&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;An_Extended_Example&quot;">9.10<tt>&nbsp;</tt><a name="(part._.An_.Extended_.Example)"></a>An Extended Example</h4><p>Here&rsquo;s an extended example from Friedl&rsquo;s <span style="font-style: italic">Mastering Regular
+Expressions</span>, page 189, that covers many of the features described in
+this chapter.  The problem is to fashion a regexp that will match any
+and only IP addresses or <span class="emph">dotted quads</span>: four numbers separated
+by three dots, with each number between 0 and 255.</p><p>First, we define a subregexp <span class="RktSym">n0-255</span> that matches 0 through
+255:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n0-255</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"(?:"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"\\d|"</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">  0 through   9</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"\\d\\d|"</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"> 00 through  99</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"[01]\\d\\d|"</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">000 through 199</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"2[0-4]\\d|"</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">200 through 249</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"25[0-5]"</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">250 through 255</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">")"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Note that <span class="RktSym">n0-255</span> lists prefixes as preferred
+alternates, which is something we cautioned against in
+<a href="regexp-alternation.html" data-pltdoc="x">Alternation</a>.  However, since we intend to anchor
+this subregexp explicitly to force an overall match, the order of the
+alternates does not matter.</p></blockquote></blockquote></blockquote><p>The first two alternates simply get all single- and
+double-digit numbers.  Since 0-padding is allowed, we
+need to match both 1 and 01.  We need to be careful
+when getting 3-digit numbers, since numbers above 255
+must be excluded.  So we fashion alternates to get 000
+through 199, then 200 through 249, and finally 250
+through 255.</p><p>An IP-address is a string that consists of four <span class="RktSym">n0-255</span>s with
+three dots separating them.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip-re1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"^"</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">nothing before</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">n0-255</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">the first </span><span class="RktSym">n0-255</span><span class="RktCmt">,</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"(?:"</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">then the subpattern of</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"\\."</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">a dot followed by</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">n0-255</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">an </span><span class="RktSym">n0-255</span><span class="RktCmt">,</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">")"</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">which is</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"{3}"</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">repeated exactly 3 times</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"$"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">with nothing following</span></td></tr></table></blockquote><p>Let&rsquo;s try it out:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._pregexp%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">pregexp</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip-re1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"1.2.3.4"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("1.2.3.4")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._pregexp%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">pregexp</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip-re1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"55.155.255.265"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote><p>which is fine, except that we also have</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._pregexp%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">pregexp</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip-re1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"0.00.000.00"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("0.00.000.00")</span></p></td></tr></table></blockquote><p>All-zero sequences are not valid IP addresses!  Lookahead to the
+rescue.  Before starting to match <span class="RktSym">ip-re1</span>, we look ahead to
+ensure we don&rsquo;t have all zeros.  We could use positive lookahead to
+ensure there <span class="emph">is</span> a digit other than zero.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip-re</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._pregexp%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">pregexp</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"(?=.*[1-9])"</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">ensure there</span><span class="RktCmt">'</span><span class="RktCmt">s a non-0 digit</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">ip-re1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote><p>Or we could use negative lookahead to ensure that what&rsquo;s ahead isn&rsquo;t
+composed of <span class="emph">only</span> zeros and dots.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip-re</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._pregexp%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">pregexp</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"(?![0.]*$)"</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">not just zeros and dots</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">(note: </span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span><span class="RktCmt"> is not metachar inside </span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span><span class="RktCmt">...</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span><span class="RktCmt">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">ip-re1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote><p>The regexp <span class="RktSym">ip-re</span> will match all and only valid IP addresses.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip-re</span><span class="hspace">&nbsp;</span><span class="RktVal">"1.2.3.4"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("1.2.3.4")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ip-re</span><span class="hspace">&nbsp;</span><span class="RktVal">"0.0.0.0"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Looking_Ahead_and_Behind.html" title="backward to &quot;9.9 Looking Ahead and Behind&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="regexp.html" title="up to &quot;9 Regular Expressions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="control.html" title="forward to &quot;10 Exceptions and Control&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/Backtracking.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/Backtracking.html
new file mode 100644
index 00000000..0c222430
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/Backtracking.html
@@ -0,0 +1,28 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>9.8&nbsp;Backtracking</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewselflink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">9.1&nbsp;</td><td><a href="regexp-intro.html" class="tocviewlink" data-pltdoc="x">Writing Regexp Patterns</a></td></tr><tr><td align="right">9.2&nbsp;</td><td><a href="regexp-match.html" class="tocviewlink" data-pltdoc="x">Matching Regexp Patterns</a></td></tr><tr><td align="right">9.3&nbsp;</td><td><a href="regexp-assert.html" class="tocviewlink" data-pltdoc="x">Basic Assertions</a></td></tr><tr><td align="right">9.4&nbsp;</td><td><a href="regexp-chars.html" class="tocviewlink" data-pltdoc="x">Characters and Character Classes</a></td></tr><tr><td align="right">9.5&nbsp;</td><td><a href="regexp-quant.html" class="tocviewlink" data-pltdoc="x">Quantifiers</a></td></tr><tr><td align="right">9.6&nbsp;</td><td><a href="regexp-clusters.html" class="tocviewlink" data-pltdoc="x">Clusters</a></td></tr><tr><td align="right">9.7&nbsp;</td><td><a href="regexp-alternation.html" class="tocviewlink" data-pltdoc="x">Alternation</a></td></tr><tr><td align="right">9.8&nbsp;</td><td><a href="Backtracking.html" class="tocviewselflink" data-pltdoc="x">Backtracking</a></td></tr><tr><td align="right">9.9&nbsp;</td><td><a href="Looking_Ahead_and_Behind.html" class="tocviewlink" data-pltdoc="x">Looking Ahead and Behind</a></td></tr><tr><td align="right">9.10&nbsp;</td><td><a href="An_Extended_Example.html" class="tocviewlink" data-pltdoc="x">An Extended Example</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="regexp-alternation.html" title="backward to &quot;9.7 Alternation&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="regexp.html" title="up to &quot;9 Regular Expressions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Looking_Ahead_and_Behind.html" title="forward to &quot;9.9 Looking Ahead and Behind&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Backtracking&quot;">9.8<tt>&nbsp;</tt><a name="(part._.Backtracking)"></a>Backtracking</h4><p>We&rsquo;ve already seen that greedy quantifiers match the maximal number of
+times, but the overriding priority is that the overall match succeed.
+Consider</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"a*a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"aaaa"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("aaaa")</span></p></td></tr></table></blockquote><p>The regexp consists of two subregexps: <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a*</span><span class="hspace"></span></span> followed by
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>.  The subregexp <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a*</span><span class="hspace"></span></span> cannot be allowed to match
+all four <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>&rsquo;s in the text string <span class="RktSym">aaaa</span>, even though
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">*</span><span class="hspace"></span></span> is a greedy quantifier.  It may match only the first
+three, leaving the last one for the second subregexp.  This ensures
+that the full regexp matches successfully.</p><p>The regexp matcher accomplishes this via a process called
+<a name="(tech._backtracking)"></a><span style="font-style: italic">backtracking</span>.  The matcher tentatively allows the greedy
+quantifier to match all four <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>&rsquo;s, but then when it becomes
+clear that the overall match is in jeopardy, it <span class="emph">backtracks</span> to a
+less greedy match of three <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>&rsquo;s.  If even this fails, as in
+the call</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"a*aa"</span><span class="hspace">&nbsp;</span><span class="RktVal">"aaaa"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("aaaa")</span></p></td></tr></table></blockquote><p>the matcher backtracks even further.  Overall failure is conceded
+only when all possible backtracking has been tried with no success.</p><p>Backtracking is not restricted to greedy quantifiers.
+Nongreedy quantifiers match as few instances as
+possible, and progressively backtrack to more and more
+instances in order to attain an overall match.  There
+is backtracking in alternation too, as the more
+rightward alternates are tried when locally successful
+leftward ones fail to yield an overall match.</p><p>Sometimes it is efficient to disable backtracking.  For example, we
+may wish to commit to a choice, or we know that trying alternatives is
+fruitless.  A nonbacktracking regexp is enclosed in
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?&gt;</span><span class="hspace"></span></span>...<span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"(?&gt;a+)."</span><span class="hspace">&nbsp;</span><span class="RktVal">"aaaa"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote><p>In this call, the subregexp <span class="RktInBG"><span class="hspace"></span><span class="RktIn">?&gt;a+</span><span class="hspace"></span></span> greedily matches all four
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>&rsquo;s, and is denied the opportunity to backtrack.  So, the
+overall match is denied.  The effect of the regexp is therefore to
+match one or more <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>&rsquo;s followed by something that is
+definitely non-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="regexp-alternation.html" title="backward to &quot;9.7 Alternation&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="regexp.html" title="up to &quot;9 Regular Expressions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Looking_Ahead_and_Behind.html" title="forward to &quot;9.9 Looking Ahead and Behind&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/Building_New_Contracts.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/Building_New_Contracts.html
new file mode 100644
index 00000000..1203f7e1
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/Building_New_Contracts.html
@@ -0,0 +1,185 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7.8&nbsp;Building New Contracts</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="contract-boundaries.html" class="tocviewlink" data-pltdoc="x">Contracts and Boundaries</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="contract-func.html" class="tocviewlink" data-pltdoc="x">Simple Contracts on Functions</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="contracts-general-functions.html" class="tocviewlink" data-pltdoc="x">Contracts on Functions in General</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="contracts-first.html" class="tocviewlink" data-pltdoc="x">Contracts:<span class="mywbr"> &nbsp;</span> A Thorough Example</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="contracts-struct.html" class="tocviewlink" data-pltdoc="x">Contracts on Structures</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="contracts-exists.html" class="tocviewlink" data-pltdoc="x">Abstract Contracts using <span class="RktPn">#:<span class="mywbr"> &nbsp;</span>exists</span> and <span class="RktPn">#:<span class="mywbr"> &nbsp;</span>&#8707;</span></a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="contracts-examples.html" class="tocviewlink" data-pltdoc="x">Additional Examples</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Building_New_Contracts.html" class="tocviewselflink" data-pltdoc="x">Building New Contracts</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="contracts-gotchas.html" class="tocviewlink" data-pltdoc="x">Gotchas</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>7.8&nbsp;</td><td><a href="Building_New_Contracts.html" class="tocviewselflink" data-pltdoc="x">Building New Contracts</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.8.1&nbsp;</td><td><a href="Building_New_Contracts.html#%28part._.Contract_.Struct_.Properties%29" class="tocviewlink" data-pltdoc="x">Contract Struct Properties</a></td></tr><tr><td align="right">7.8.2&nbsp;</td><td><a href="Building_New_Contracts.html#%28part._.With_all_the_.Bells_and_.Whistles%29" class="tocviewlink" data-pltdoc="x">With all the Bells and Whistles</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">7.8.1<tt>&nbsp;</tt></span><a href="Building_New_Contracts.html#%28part._.Contract_.Struct_.Properties%29" class="tocsubseclink" data-pltdoc="x">Contract Struct Properties</a></td></tr><tr><td><span class="tocsublinknumber">7.8.2<tt>&nbsp;</tt></span><a href="Building_New_Contracts.html#%28part._.With_all_the_.Bells_and_.Whistles%29" class="tocsubseclink" data-pltdoc="x">With all the Bells and Whistles</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contracts-examples.html" title="backward to &quot;7.7 Additional Examples&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;7 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contracts-gotchas.html" title="forward to &quot;7.9 Gotchas&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Building_New_Contracts&quot;">7.8<tt>&nbsp;</tt><a name="(part._.Building_.New_.Contracts)"></a>Building New Contracts</h4><p>Contracts are represented internally as functions that
+accept information about the contract (who is to blame,
+source locations, etc<span class="Sendabbrev">.</span>) and produce projections (in the
+spirit of Dana Scott) that enforce the contract.</p><p>In a general sense, a
+projection is a function that accepts an arbitrary value,
+and returns a value that satisfies the corresponding
+contract. For example, a projection that accepts only
+integers corresponds to the contract <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._flat-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">flat-contract</a></span><span class="stt"> </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span>, and can be written like this:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">int-proj</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">x</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">signal-contract-violation</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>As a second example, a projection that accepts unary functions
+on integers looks like this:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">int-&gt;int-proj</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._procedure%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._procedure-arity-includes%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">procedure-arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">int-proj</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">int-proj</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">signal-contract-violation</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Although these projections have the right error behavior,
+they are not quite ready for use as contracts, because they
+do not accommodate blame and do not provide good error
+messages. In order to accommodate these, contracts do not
+just use simple projections, but use functions that accept a
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528tech._blame._object%2529&amp;version=8.6" class="techoutside Sq" data-pltdoc="x"><span class="techinside">blame object</span></a> encapsulating
+the names of two parties that are the candidates for blame,
+as well as a record of the source location where the
+contract was established and the name of the contract. They
+can then, in turn, pass that information
+to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._raise-blame-error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise-blame-error</a></span> to signal a good error
+message.</p><p><div class="SIntrapara">Here is the first of those two projections, rewritten for
+use in the contract system:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">int-proj</span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">x</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._raise-blame-error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise-blame-error</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">blame</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">x</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">expected:</span><span class="hspace">&nbsp;</span><span class="RktVal">"&lt;integer&gt;"</span><span class="hspace">&nbsp;</span><span class="RktVal">given:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~e"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">The new argument specifies who is to be blamed for
+positive and negative contract violations.</div></p><p>Contracts, in this system, are always
+established between two parties. One party, called the server, provides some
+value according to the contract, and the other, the client, consumes the
+value, also according to the contract. The server is called
+the positive position and the client the negative position. So,
+in the case of just the integer contract, the only thing
+that can go wrong is that the value provided is not an
+integer. Thus, only the positive party (the server) can ever accrue
+blame.  The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._raise-blame-error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise-blame-error</a></span> function always blames
+the positive party.</p><p>Compare that to the projection for our function contract:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">int-&gt;int-proj</span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dom</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">int-proj</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._blame-swap%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">blame-swap</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rng</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">int-proj</span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._procedure%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._procedure-arity-includes%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">procedure-arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rng</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dom</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._raise-blame-error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise-blame-error</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">blame</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">expected</span><span class="hspace">&nbsp;</span><span class="RktVal">"a procedure of one argument"</span><span class="hspace">&nbsp;</span><span class="RktVal">given:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~e"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>In this case, the only explicit blame covers the situation
+where either a non-procedure is supplied to the contract or
+the procedure does not accept one argument. As with
+the integer projection, the blame here also lies with the
+producer of the value, which is
+why <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._raise-blame-error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise-blame-error</a></span> is passed <span class="RktSym">blame</span> unchanged.</p><p>The checking for the domain and range are delegated to
+the <span class="RktSym">int-proj</span> function, which is supplied its
+arguments in the first two lines of
+the <span class="RktSym">int-&gt;int-proj</span> function. The trick here is that,
+even though the <span class="RktSym">int-&gt;int-proj</span> function always
+blames what it sees as positive, we can swap the blame parties by
+calling <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._blame-swap%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">blame-swap</a></span> on the given
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528tech._blame._object%2529&amp;version=8.6" class="techoutside Sq" data-pltdoc="x"><span class="techinside">blame object</span></a>, replacing
+the positive party with the negative party and vice versa.</p><p>This technique is not merely a cheap trick to get the example to work,
+however. The reversal of the positive and the negative is a
+natural consequence of the way functions behave. That is,
+imagine the flow of values in a program between two
+modules. First, one module (the server) defines a function, and then that
+module is required by another (the client). So far, the function itself
+has to go from the original, providing module to the
+requiring module. Now, imagine that the requiring module
+invokes the function, supplying it an argument. At this
+point, the flow of values reverses. The argument is
+traveling back from the requiring module to the providing
+module! The client is &ldquo;serving&rdquo; the argument to the server,
+and the server is receiving that value as a client.
+And finally, when the function produces a result,
+that result flows back in the original
+direction from server to client.
+Accordingly, the contract on the domain reverses
+the positive and the negative blame parties, just like the flow
+of values reverses.</p><p>We can use this insight to generalize the function contracts
+and build a function that accepts any two contracts and
+returns a contract for functions between them.</p><p>This projection also goes further and uses
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._blame-add-context%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">blame-add-context</a></span> to improve the error messages
+when a contract violation is detected.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-simple-function-contract</span><span class="hspace">&nbsp;</span><span class="RktSym">dom-proj</span><span class="hspace">&nbsp;</span><span class="RktSym">range-proj</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">blame</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dom</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dom-proj</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._blame-add-context%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">blame-add-context</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"the argument of"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:swap?</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rng</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">range-proj</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._blame-add-context%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">blame-add-context</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"the range of"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._procedure%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._procedure-arity-includes%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">procedure-arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rng</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dom</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._raise-blame-error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise-blame-error</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">blame</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">expected</span><span class="hspace">&nbsp;</span><span class="RktVal">"a procedure of one argument"</span><span class="hspace">&nbsp;</span><span class="RktVal">given:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~e"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p><div class="SIntrapara">While these projections are supported by the contract library
+and can be used to build new contracts, the contract library
+also supports a different API for projections that can be more
+efficient. Specifically, a
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528tech._late._neg._projection%2529&amp;version=8.6" class="techoutside Sq" data-pltdoc="x"><span class="techinside">late neg projection</span></a> accepts
+a blame object without the negative blame information and then
+returns a function that accepts both the value to be contracted and
+the name of the negative party, in that order.
+The returned function then in turn
+returns the value with the contract. Rewriting <span class="RktSym">int-&gt;int-proj</span>
+to use this API looks like this:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">int-&gt;int-proj</span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dom-blame</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._blame-add-context%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">blame-add-context</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"the argument of"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:swap?</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rng-blame</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._blame-add-context%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">blame-add-context</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="hspace">&nbsp;</span><span class="RktVal">"the range of"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check-int</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktSym">to-blame</span><span class="hspace">&nbsp;</span><span class="RktSym">neg-party</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._unless%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._raise-blame-error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise-blame-error</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">to-blame</span><span class="hspace">&nbsp;</span><span class="RktPn">#:missing-party</span><span class="hspace">&nbsp;</span><span class="RktSym">neg-party</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">v</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">expected</span><span class="hspace">&nbsp;</span><span class="RktVal">"an integer"</span><span class="hspace">&nbsp;</span><span class="RktVal">given:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~e"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">neg-party</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._procedure%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._procedure-arity-includes%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">procedure-arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check-int</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">dom-blame</span><span class="hspace">&nbsp;</span><span class="RktSym">neg-party</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ans</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check-int</span><span class="hspace">&nbsp;</span><span class="RktSym">ans</span><span class="hspace">&nbsp;</span><span class="RktSym">rng-blame</span><span class="hspace">&nbsp;</span><span class="RktSym">neg-party</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">ans</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._raise-blame-error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise-blame-error</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">blame</span><span class="hspace">&nbsp;</span><span class="RktPn">#:missing-party</span><span class="hspace">&nbsp;</span><span class="RktSym">neg-party</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">expected</span><span class="hspace">&nbsp;</span><span class="RktVal">"a procedure of one argument"</span><span class="hspace">&nbsp;</span><span class="RktVal">given:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~e"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">The advantage of this style of contract is that the <span class="RktVar">blame</span>
+argument can be supplied on the server side of the
+contract boundary and the result can be used for each different
+client. With the simpler situation, a new blame object has to be
+created for each client.</div></p><p>One final problem remains before this contract can be used with the
+rest of the contract system. In the function above,
+the contract is implemented by creating a wrapper function for
+<span class="RktSym">f</span>, but this wrapper function does not cooperate with
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span>, nor does it let the runtime system know that there
+is a relationship between the result function and <span class="RktSym">f</span>, the input
+function.</p><p>To remedy these two problems, we should use
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=chaperones.html%23%2528tech._chaperone%2529&amp;version=8.6" class="techoutside Sq" data-pltdoc="x"><span class="techinside">chaperones</span></a> instead
+of just using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span> to create the wrapper function. Here is the
+<span class="RktSym">int-&gt;int-proj</span> function rewritten to use a
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=chaperones.html%23%2528tech._chaperone%2529&amp;version=8.6" class="techoutside Sq" data-pltdoc="x"><span class="techinside">chaperone</span></a>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">int-&gt;int-proj</span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dom-blame</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._blame-add-context%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">blame-add-context</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"the argument of"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:swap?</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rng-blame</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._blame-add-context%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">blame-add-context</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="hspace">&nbsp;</span><span class="RktVal">"the range of"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check-int</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktSym">to-blame</span><span class="hspace">&nbsp;</span><span class="RktSym">neg-party</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._unless%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._raise-blame-error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise-blame-error</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">to-blame</span><span class="hspace">&nbsp;</span><span class="RktPn">#:missing-party</span><span class="hspace">&nbsp;</span><span class="RktSym">neg-party</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">v</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">expected</span><span class="hspace">&nbsp;</span><span class="RktVal">"an integer"</span><span class="hspace">&nbsp;</span><span class="RktVal">given:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~e"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">neg-party</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._procedure%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._procedure-arity-includes%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">procedure-arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=chaperones.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._chaperone-procedure%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">chaperone-procedure</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check-int</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">dom-blame</span><span class="hspace">&nbsp;</span><span class="RktSym">neg-party</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ans</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check-int</span><span class="hspace">&nbsp;</span><span class="RktSym">ans</span><span class="hspace">&nbsp;</span><span class="RktSym">rng-blame</span><span class="hspace">&nbsp;</span><span class="RktSym">neg-party</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">ans</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._raise-blame-error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise-blame-error</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">blame</span><span class="hspace">&nbsp;</span><span class="RktPn">#:missing-party</span><span class="hspace">&nbsp;</span><span class="RktSym">neg-party</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">expected</span><span class="hspace">&nbsp;</span><span class="RktVal">"a procedure of one argument"</span><span class="hspace">&nbsp;</span><span class="RktVal">given:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~e"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote><p><div class="SIntrapara">Projections like the ones described above, but suited to
+other, new kinds of value you might make, can be used with
+the contract library primitives. Specifically, we can use
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fcombinator..rkt%2529._make-chaperone-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-chaperone-contract</a></span> to build it:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">int-&gt;int-contract</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fprop..rkt%2529._make-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-contract</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:name</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">int-&gt;int</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:late-neg-projection</span><span class="hspace">&nbsp;</span><span class="RktSym">int-&gt;int-proj</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">and then combine it with a value and get some contract
+checking.
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">int-&gt;int-contract</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"not an int"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">f: contract violation;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">expected an integer</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: #f</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">int-&gt;int</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (function f)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:5:0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">f: broke its own contract;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">promised an integer</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: "not an int"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the range of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">int-&gt;int</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (function f)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (function f)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:5:0</span></p></td></tr></table></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Contract_Struct_Properties&quot;">7.8.1<tt>&nbsp;</tt><a name="(part._.Contract_.Struct_.Properties)"></a>Contract Struct Properties</h5><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fcombinator..rkt%2529._make-chaperone-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-chaperone-contract</a></span> function is okay for one-off contracts,
+but often you want to make many different contracts that differ only
+in some pieces. The best way to do that is to use a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span>
+with either <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fprop..rkt%2529._prop%7E3acontract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">prop:contract</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fprop..rkt%2529._prop%7E3achaperone-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">prop:chaperone-contract</a></span>, or
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fprop..rkt%2529._prop%7E3aflat-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">prop:flat-contract</a></span>.</p><p><div class="SIntrapara">For example, lets say we wanted to make a simple form of the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span>
+contract that accepts one contract for the range and one for the domain.
+We should define a struct with two fields and use
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fcombinator..rkt%2529._build-chaperone-contract-property%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">build-chaperone-contract-property</a></span> to construct the chaperone contract
+property we need.
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">simple-arrow</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dom</span><span class="hspace">&nbsp;</span><span class="RktSym">rng</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:property</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fprop..rkt%2529._prop%7E3achaperone-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">prop:chaperone-contract</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fcombinator..rkt%2529._build-chaperone-contract-property%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">build-chaperone-contract-property</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:name</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">arr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-name</span><span class="hspace">&nbsp;</span><span class="RktSym">arr</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:late-neg-projection</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">arr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-late-neg-proj</span><span class="hspace">&nbsp;</span><span class="RktSym">arr</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara">To do the automatic coercion of values like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span> and <span class="RktVal">#f</span>
+into contracts, we need to call <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fguts..rkt%2529._coerce-chaperone-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">coerce-chaperone-contract</a></span>
+(note that this rejects impersonator contracts and does not insist
+on flat contracts; to do either of those things, call <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fguts..rkt%2529._coerce-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">coerce-contract</a></span>
+or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fguts..rkt%2529._coerce-flat-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">coerce-flat-contract</a></span> instead).
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-contract</span><span class="hspace">&nbsp;</span><span class="RktSym">dom</span><span class="hspace">&nbsp;</span><span class="RktSym">rng</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fguts..rkt%2529._coerce-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">coerce-contract</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">simple-arrow-contract</span><span class="hspace">&nbsp;</span><span class="RktSym">dom</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fguts..rkt%2529._coerce-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">coerce-contract</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">simple-arrow-contract</span><span class="hspace">&nbsp;</span><span class="RktSym">rng</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara">To define <span class="RktVar">simple-arrow-name</span> is straight-forward; it needs to return
+an s-expression representing the contract:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-name</span><span class="hspace">&nbsp;</span><span class="RktSym">arr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal"><span class="nobreak">-&gt;</span></span><span class="hspace">&nbsp;</span><span class="RktRdr">,</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=contract-utilities.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fguts..rkt%2529._contract-name%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">contract-name</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-dom</span><span class="hspace">&nbsp;</span><span class="RktSym">arr</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">,</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=contract-utilities.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fguts..rkt%2529._contract-name%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">contract-name</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-rng</span><span class="hspace">&nbsp;</span><span class="RktSym">arr</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">And we can define the projection using a generalization of the
+projection we defined earlier, this time using
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=chaperones.html%23%2528tech._chaperone%2529&amp;version=8.6" class="techoutside Sq" data-pltdoc="x"><span class="techinside">chaperones</span></a>:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-late-neg-proj</span><span class="hspace">&nbsp;</span><span class="RktSym">arr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dom-ctc</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=contract-utilities.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fguts..rkt%2529._get%252Fbuild-late-neg-projection%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">get/build-late-neg-projection</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-dom</span><span class="hspace">&nbsp;</span><span class="RktSym">arr</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rng-ctc</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=contract-utilities.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fguts..rkt%2529._get%252Fbuild-late-neg-projection%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">get/build-late-neg-projection</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-rng</span><span class="hspace">&nbsp;</span><span class="RktSym">arr</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">blame</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dom+blame</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dom-ctc</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._blame-add-context%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">blame-add-context</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"the argument of"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:swap?</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rng+blame</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rng-ctc</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._blame-add-context%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">blame-add-context</a></span><span class="hspace">&nbsp;</span><span class="RktSym">blame</span><span class="hspace">&nbsp;</span><span class="RktVal">"the range of"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">neg-party</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._procedure%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._procedure-arity-includes%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">procedure-arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=chaperones.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._chaperone-procedure%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">chaperone-procedure</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">arg</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">result</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rng+blame</span><span class="hspace">&nbsp;</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktSym">neg-party</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dom+blame</span><span class="hspace">&nbsp;</span><span class="RktSym">arg</span><span class="hspace">&nbsp;</span><span class="RktSym">neg-party</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fblame..rkt%2529._raise-blame-error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise-blame-error</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">blame</span><span class="hspace">&nbsp;</span><span class="RktPn">#:missing-party</span><span class="hspace">&nbsp;</span><span class="RktSym">neg-party</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">expected</span><span class="hspace">&nbsp;</span><span class="RktVal">"a procedure of one argument"</span><span class="hspace">&nbsp;</span><span class="RktVal">given:</span><span class="hspace">&nbsp;</span><span class="RktVal">"~e"</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-contract</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"not a boolean"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">f: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: #f</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; integer? boolean?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (function f)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:12:0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">f: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: boolean?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: "not a boolean"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the range of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; integer? boolean?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (function f)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (function f)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:12:0</span></p></td></tr></table></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;With_all_the_Bells_and_Whistles&quot;">7.8.2<tt>&nbsp;</tt><a name="(part._.With_all_the_.Bells_and_.Whistles)"></a>With all the Bells and Whistles</h5><p>There are a number of optional pieces to a contract that
+<span class="RktSym">simple-arrow-contract</span> did not add. In this section,
+we walk through all of them to show examples of how they can
+be implemented.</p><p><div class="SIntrapara">The first is a first-order check. This is used by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._or%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">or/c</a></span>
+in order to determine which of the higher-order argument contracts
+to use when it sees a value. Here&rsquo;s the function for
+our simple arrow contract.
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-first-order</span><span class="hspace">&nbsp;</span><span class="RktSym">ctc</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._procedure%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._procedure-arity-includes%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">procedure-arity-includes?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">It accepts a value and returns <span class="RktVal">#f</span> if the value is guaranteed not
+to satisfy the contract, and <span class="RktVal">#t</span> if, as far as we can tell,
+the value satisfies the contract, just be inspecting first-order
+properties of the value.</div></p><p>The next is random generation. Random generation in the contract
+library consists of two pieces: the ability to randomly generate
+values satisfying the contract and the ability to exercise values
+that match the contract that are given, in the hopes of finding bugs
+in them (and also to try to get them to produce interesting values to
+be used elsewhere during generation).</p><p><div class="SIntrapara">To exercise contracts, we need to implement a function that
+is given a <span class="RktSym">arrow-contract</span> struct and some fuel. It should return
+two values: a function that accepts values of the contract
+and exercises them, plus a list of values that the exercising
+process will always produce. In the case of our simple
+contract, we know that we can always produce values of the range,
+as long as we can generate values of the domain (since we can just
+call the function). So, here&rsquo;s a function that matches the
+<span class="RktVar">exercise</span> argument of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fcombinator..rkt%2529._build-chaperone-contract-property%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">build-chaperone-contract-property</a></span>&rsquo;s
+contract:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-contract-exercise</span><span class="hspace">&nbsp;</span><span class="RktSym">arr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">env</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Random_generation.html%23%2528def._%2528%2528lib._racket%252Fcontract..rkt%2529._contract-random-generate-get-current-environment%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">contract-random-generate-get-current-environment</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fuel</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dom-generate</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Random_generation.html%23%2528def._%2528%2528lib._racket%252Fcontract..rkt%2529._contract-random-generate%252Fchoose%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">contract-random-generate/choose</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-dom</span><span class="hspace">&nbsp;</span><span class="RktSym">arr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">fuel</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">dom-generate</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Random_generation.html%23%2528def._%2528%2528lib._racket%252Fcontract..rkt%2529._contract-random-generate-stash%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">contract-random-generate-stash</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">env</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-rng</span><span class="hspace">&nbsp;</span><span class="RktSym">arr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dom-generate</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-rng</span><span class="hspace">&nbsp;</span><span class="RktSym">arr</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">If the domain contract can be generated, then we know we can do some good via exercising.
+In that case, we return a procedure that calls <span class="RktVar">f</span> (the function matching
+the contract) with something that we generated from the domain, and we stash the result
+value in the environment too. We also return <span class="RktPn">(</span><span class="RktSym">simple-arrow-rng</span><span class="stt"> </span><span class="RktSym">arr</span><span class="RktPn">)</span>
+to indicate that exercising will always produce something of that contract.</div></p><p>If we cannot, then we simply return a function that
+does no exercising (<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void</a></span>) and the empty list (indicating that we won&rsquo;t generate
+any values).</p><p><div class="SIntrapara">Then, to generate values matching the contract, we define a function
+that when given the contract and some fuel, makes up a random function.
+To help make it a more effective testing function, we can exercise
+any arguments it receives, and also stash them into the generation
+environment, but only if we can generate values of the range contract.
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-contract-generate</span><span class="hspace">&nbsp;</span><span class="RktSym">arr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fuel</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">env</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Random_generation.html%23%2528def._%2528%2528lib._racket%252Fcontract..rkt%2529._contract-random-generate-get-current-environment%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">contract-random-generate-get-current-environment</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rng-generate</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Random_generation.html%23%2528def._%2528%2528lib._racket%252Fcontract..rkt%2529._contract-random-generate%252Fchoose%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">contract-random-generate/choose</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-rng</span><span class="hspace">&nbsp;</span><span class="RktSym">arr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">fuel</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">rng-generate</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">arg</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Random_generation.html%23%2528def._%2528%2528lib._racket%252Fcontract..rkt%2529._contract-random-generate-stash%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">contract-random-generate-stash</a></span><span class="hspace">&nbsp;</span><span class="RktSym">env</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-dom</span><span class="hspace">&nbsp;</span><span class="RktSym">arr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">arg</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rng-generate</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div></p><p>When the random generation pulls something out of the environment,
+it needs to be able to tell if a value that has been passed to
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Random_generation.html%23%2528def._%2528%2528lib._racket%252Fcontract..rkt%2529._contract-random-generate-stash%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">contract-random-generate-stash</a></span> is a candidate for
+the contract it is trying to generate. Of course, it the contract
+passed to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Random_generation.html%23%2528def._%2528%2528lib._racket%252Fcontract..rkt%2529._contract-random-generate-stash%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">contract-random-generate-stash</a></span> is an exact
+match, then it can use it. But it can also use the value if the
+contract is stronger (in the sense that it accepts fewer values).</p><p><div class="SIntrapara">To provide that functionality, we implement this function:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-first-stronger?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._this%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">this</a></span><span class="hspace">&nbsp;</span><span class="RktSym">that</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow?</span><span class="hspace">&nbsp;</span><span class="RktSym">that</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fguts..rkt%2529._contract-stronger%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">contract-stronger?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-dom</span><span class="hspace">&nbsp;</span><span class="RktSym">that</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-dom</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._this%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">this</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fguts..rkt%2529._contract-stronger%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">contract-stronger?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-rng</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._this%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">this</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-rng</span><span class="hspace">&nbsp;</span><span class="RktSym">that</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">This function accepts <span class="RktVar">this</span> and <span class="RktVar">that</span>, two contracts. It is
+guaranteed that <span class="RktVar">this</span> will be one of our simple arrow contracts,
+since we&rsquo;re supplying this function together with the simple arrow implementation.
+But the <span class="RktVar">that</span> argument might be any contract. This function
+checks to see if <span class="RktVar">that</span> is also a simple arrow contract and, if so
+compares the domain and range. Of course, there are other contracts that we
+could also check for (e.g., contracts built using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span> or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span>),
+but we do not need to. The stronger function is allowed to return <span class="RktVal">#f</span>
+if it doesn&rsquo;t know the answer but if it returns <span class="RktVal">#t</span>, then the contract
+really must be stronger.</div></p><p><div class="SIntrapara">Now that we have all of the pieces implemented, we need to pass them
+to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fcombinator..rkt%2529._build-chaperone-contract-property%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">build-chaperone-contract-property</a></span> so the contract system
+starts using them:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">simple-arrow</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dom</span><span class="hspace">&nbsp;</span><span class="RktSym">rng</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:property</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Printer_Extension.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._prop%7E3acustom-write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">prop:custom-write</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=contract-utilities.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fguts..rkt%2529._contract-custom-write-property-proc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">contract-custom-write-property-proc</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:property</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fprop..rkt%2529._prop%7E3achaperone-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">prop:chaperone-contract</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fcombinator..rkt%2529._build-chaperone-contract-property%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">build-chaperone-contract-property</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:name</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">arr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-name</span><span class="hspace">&nbsp;</span><span class="RktSym">arr</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:late-neg-projection</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">arr</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-late-neg-proj</span><span class="hspace">&nbsp;</span><span class="RktSym">arr</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:first-order</span><span class="hspace">&nbsp;</span><span class="RktSym">simple-arrow-first-order</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:stronger</span><span class="hspace">&nbsp;</span><span class="RktSym">simple-arrow-first-stronger?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:generate</span><span class="hspace">&nbsp;</span><span class="RktSym">simple-arrow-contract-generate</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:exercise</span><span class="hspace">&nbsp;</span><span class="RktSym">simple-arrow-contract-exercise</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-contract</span><span class="hspace">&nbsp;</span><span class="RktSym">dom</span><span class="hspace">&nbsp;</span><span class="RktSym">rng</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fguts..rkt%2529._coerce-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">coerce-contract</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">simple-arrow-contract</span><span class="hspace">&nbsp;</span><span class="RktSym">dom</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Building_New_Contract_Combinators.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fguts..rkt%2529._coerce-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">coerce-contract</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">simple-arrow-contract</span><span class="hspace">&nbsp;</span><span class="RktSym">rng</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">We also add a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Printer_Extension.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._prop%7E3acustom-write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">prop:custom-write</a></span> property so
+that the contracts print properly, e.g.:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">simple-arrow-contract</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(-&gt; integer? integer?)</span></p></td></tr></table></blockquote></div><div class="SIntrapara">(We use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Printer_Extension.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._prop%7E3acustom-write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">prop:custom-write</a></span> because the contract library
+can not depend on </div><div class="SIntrapara"><blockquote class="SCodeFlow"><p><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=struct-generics.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/generic</span></a></p></blockquote></div><div class="SIntrapara"> but yet still wants
+to provide some help to make it easy to use the right printer.)</div></p><p><div class="SIntrapara">Now that that&rsquo;s done, we can use the new functionality. Here&rsquo;s a random function,
+generated by the contract library, using our <span class="RktSym">simple-arrow-contract-generate</span>
+function:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a-random-function</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Random_generation.html%23%2528def._%2528%2528lib._racket%252Fcontract..rkt%2529._contract-random-generate%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">contract-random-generate</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-contract</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">a-random-function</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">a-random-function</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara">Here&rsquo;s how the contract system can now automatically find bugs in functions
+that consume simple arrow contracts:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">misbehaved-f</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-contract</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">"not an integer"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Random_generation.html%23%2528def._%2528%2528lib._racket%252Fcontract..rkt%2529._contract-exercise%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">contract-exercise</a></span><span class="hspace">&nbsp;</span><span class="RktSym">misbehaved-f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">misbehaved-f: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: "not an integer"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; (-&gt; integer? boolean?) any)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (function misbehaved-f)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (function misbehaved-f)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:25:0</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara">And if we hadn&rsquo;t implemented <span class="RktSym">simple-arrow-first-order</span>, then
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._or%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">or/c</a></span> would not be able to tell which branch of the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._or%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">or/c</a></span>
+to use in this program:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">maybe-accepts-a-function</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._or%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">simple-arrow-contract</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._real%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._real%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">real?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._real%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._real%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">real?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._real%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">real?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._real%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">real?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._procedure%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">procedure-arity-includes</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1132</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">maybe-accepts-a-function</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sqrt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sqrt</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">maybe-accepts-a-function: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: real?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: #&lt;procedure:sqrt&gt;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">a part of the or/c of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(or/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; real? real?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; real? real? real?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">real?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: </span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(function maybe-accepts-a-function)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:27:0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">maybe-accepts-a-function</span><span class="hspace">&nbsp;</span><span class="RktVal">123</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">123</span></p></td></tr></table></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contracts-examples.html" title="backward to &quot;7.7 Additional Examples&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;7 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contracts-gotchas.html" title="forward to &quot;7.9 Gotchas&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/Contracts_for_Units.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/Contracts_for_Units.html
new file mode 100644
index 00000000..40c39829
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/Contracts_for_Units.html
@@ -0,0 +1,16 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14.6&nbsp;Contracts for Units</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Signatures_and_Units.html" class="tocviewlink" data-pltdoc="x">Signatures and Units</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="Invoking_Units.html" class="tocviewlink" data-pltdoc="x">Invoking Units</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="Linking_Units.html" class="tocviewlink" data-pltdoc="x">Linking Units</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="firstclassunits.html" class="tocviewlink" data-pltdoc="x">First-<wbr></wbr>Class Units</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="Whole-module_Signatures_and_Units.html" class="tocviewlink" data-pltdoc="x">Whole-<span class="RktSym"><span class="RktStxLink">module</span></span> Signatures and Units</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="Contracts_for_Units.html" class="tocviewselflink" data-pltdoc="x">Contracts for Units</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="unit_versus_module.html" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unit</span></span> versus <span class="RktSym"><span class="RktStxLink">module</span></span></a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>14.6&nbsp;</td><td><a href="Contracts_for_Units.html" class="tocviewselflink" data-pltdoc="x">Contracts for Units</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.6.1&nbsp;</td><td><a href="Contracts_for_Units.html#%28part._.Adding_.Contracts_to_.Signatures%29" class="tocviewlink" data-pltdoc="x">Adding Contracts to Signatures</a></td></tr><tr><td align="right">14.6.2&nbsp;</td><td><a href="Contracts_for_Units.html#%28part._.Adding_.Contracts_to_.Units%29" class="tocviewlink" data-pltdoc="x">Adding Contracts to Units</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">14.6.1<tt>&nbsp;</tt></span><a href="Contracts_for_Units.html#%28part._.Adding_.Contracts_to_.Signatures%29" class="tocsubseclink" data-pltdoc="x">Adding Contracts to Signatures</a></td></tr><tr><td><span class="tocsublinknumber">14.6.2<tt>&nbsp;</tt></span><a href="Contracts_for_Units.html#%28part._.Adding_.Contracts_to_.Units%29" class="tocsubseclink" data-pltdoc="x">Adding Contracts to Units</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Whole-module_Signatures_and_Units.html" title="backward to &quot;14.5 Whole-module Signatures and Units&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="units.html" title="up to &quot;14 Units (Components)&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="unit_versus_module.html" title="forward to &quot;14.7 unit versus module&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Contracts_for_Units&quot;">14.6<tt>&nbsp;</tt><a name="(part._.Contracts_for_.Units)"></a>Contracts for Units</h4><p>There are a couple of ways of protecting units with contracts.  One way
+is useful when writing new signatures, and the other handles the case
+when a unit must conform to an already existing signature.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Adding_Contracts_to_Signatures&quot;">14.6.1<tt>&nbsp;</tt><a name="(part._.Adding_.Contracts_to_.Signatures)"></a>Adding Contracts to Signatures</h5><p>When contracts are added to a signature, then all units which implement
+that signature are protected by those contracts.  The following version
+of the <span class="RktSym">toy-factory^</span> signature adds the contracts previously
+written in comments:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"contracted-toy-factory-sig.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-signature%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-signature</a></span><span class="hspace">&nbsp;</span><span class="RktSym">contracted-toy-factory^</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._contracted%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contracted</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">build-toys</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><span class="nobreak">-&gt;</span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">listof</span><span class="hspace">&nbsp;</span><span class="RktSym">toy?</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">repaint</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><span class="nobreak">-&gt;</span></span><span class="hspace">&nbsp;</span><span class="RktSym">toy?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy?</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">toy?</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><span class="nobreak">-&gt;</span></span><span class="hspace">&nbsp;</span><span class="RktSym">any/c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">toy-color</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><span class="nobreak">-&gt;</span></span><span class="hspace">&nbsp;</span><span class="RktSym">toy?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">contracted-toy-factory^</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>Now we take the previous implementation of <span class="RktSym">simple-factory@</span> and
+implement this version of <span class="RktSym">toy-factory^</span> instead:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"contracted-simple-factory-unit.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"contracted-toy-factory-sig.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linkinference.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-unit</a></span><span class="hspace">&nbsp;</span><span class="RktSym">contracted-simple-factory@</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._import%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">import</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._export%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktSym">contracted-toy-factory^</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Factory started.\n"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">build-toys</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">toy</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">blue</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">repaint</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">toy</span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">contracted-simple-factory@</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>As before, we can invoke our new unit and bind the exports so
+that we can use them.  This time, however, misusing the exports
+causes the appropriate contract errors.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"contracted-simple-factory-unit.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linkinference.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-values%252Finvoke-unit%252Finfer%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values/invoke-unit/infer</a></span><span class="hspace">&nbsp;</span><span class="RktSym">contracted-simple-factory@</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Factory started.</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">build-toys</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(list (toy 'blue) (toy 'blue) (toy 'blue))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">build-toys</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">build-toys: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: #f</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; integer? (listof toy?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: </span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(unit contracted-simple-factory@)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:34:0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">repaint</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">blue</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">repaint: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: toy?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 3</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; toy? symbol? toy?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: </span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(unit contracted-simple-factory@)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:34:0</span></p></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Adding_Contracts_to_Units&quot;">14.6.2<tt>&nbsp;</tt><a name="(part._.Adding_.Contracts_to_.Units)"></a>Adding Contracts to Units</h5><p>However, sometimes we may have a unit that must conform to an
+already existing signature that is not contracted.  In this case,
+we can create a unit contract with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=unitcontracts.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._unit%252Fc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unit/c</a></span> or use
+the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=unitcontracts.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-unit%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-unit/contract</a></span> form, which defines a unit which
+has been wrapped with a unit contract.</p><p>For example, here&rsquo;s a version of <span class="RktSym">toy-factory@</span> which still
+implements the regular <span class="RktSym">toy-factory^</span>, but whose exports
+have been protected with an appropriate unit contract.</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"wrapped-simple-factory-unit.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"toy-factory-sig.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=unitcontracts.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-unit%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-unit/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">wrapped-simple-factory@</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._import%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">import</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._export%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">toy-factory^</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">build-toys</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><span class="nobreak">-&gt;</span></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">listof</span><span class="hspace">&nbsp;</span><span class="RktSym">toy?</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">repaint</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><span class="nobreak">-&gt;</span></span><span class="hspace">&nbsp;</span><span class="RktSym">toy?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy?</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">toy?</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><span class="nobreak">-&gt;</span></span><span class="hspace">&nbsp;</span><span class="RktSym">any/c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">toy-color</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><span class="nobreak">-&gt;</span></span><span class="hspace">&nbsp;</span><span class="RktSym">toy?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Factory started.\n"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">build-toys</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">toy</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">blue</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">repaint</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">toy</span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">wrapped-simple-factory@</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"wrapped-simple-factory-unit.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linkinference.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-values%252Finvoke-unit%252Finfer%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values/invoke-unit/infer</a></span><span class="hspace">&nbsp;</span><span class="RktSym">wrapped-simple-factory@</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Factory started.</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">build-toys</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(list (toy 'blue) (toy 'blue) (toy 'blue))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">build-toys</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">wrapped-simple-factory@: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: #f</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(unit/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(import)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(export (toy-factory^</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(build-toys</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; integer? (listof toy?)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(repaint (-&gt; toy? symbol? toy?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(toy? (-&gt; any/c boolean?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(toy-color (-&gt; toy? symbol?))))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(init-depend))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: </span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(unit wrapped-simple-factory@)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: &lt;collects&gt;/racket/unit.rkt</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">repaint</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">blue</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">wrapped-simple-factory@: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: toy?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 3</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(unit/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(import)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(export (toy-factory^</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(build-toys</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; integer? (listof toy?)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(repaint (-&gt; toy? symbol? toy?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(toy? (-&gt; any/c boolean?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(toy-color (-&gt; toy? symbol?))))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(init-depend))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: </span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(unit wrapped-simple-factory@)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: &lt;collects&gt;/racket/unit.rkt</span></p></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Whole-module_Signatures_and_Units.html" title="backward to &quot;14.5 Whole-module Signatures and Units&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="units.html" title="up to &quot;14 Units (Components)&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="unit_versus_module.html" title="forward to &quot;14.7 unit versus module&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/Emacs.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/Emacs.html
new file mode 100644
index 00000000..e814ef72
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/Emacs.html
@@ -0,0 +1,56 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>24.2&nbsp;Emacs</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewselflink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">24.1&nbsp;</td><td><a href="cmdline-tools.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools</a></td></tr><tr><td align="right">24.2&nbsp;</td><td><a href="Emacs.html" class="tocviewselflink" data-pltdoc="x">Emacs</a></td></tr><tr><td align="right">24.3&nbsp;</td><td><a href="Vim.html" class="tocviewlink" data-pltdoc="x">Vim</a></td></tr><tr><td align="right">24.4&nbsp;</td><td><a href="Sublime_Text.html" class="tocviewlink" data-pltdoc="x">Sublime Text</a></td></tr><tr><td align="right">24.5&nbsp;</td><td><a href="Visual_Studio_Code.html" class="tocviewlink" data-pltdoc="x">Visual Studio Code</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>24.2&nbsp;</td><td><a href="Emacs.html" class="tocviewselflink" data-pltdoc="x">Emacs</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">24.2.1&nbsp;</td><td><a href="Emacs.html#%28part._.Major_.Modes%29" class="tocviewlink" data-pltdoc="x">Major Modes</a></td></tr><tr><td align="right">24.2.2&nbsp;</td><td><a href="Emacs.html#%28part._.Minor_.Modes%29" class="tocviewlink" data-pltdoc="x">Minor Modes</a></td></tr><tr><td align="right">24.2.3&nbsp;</td><td><a href="Emacs.html#%28part._.Packages_specific_to_.Evil_.Mode%29" class="tocviewlink" data-pltdoc="x">Packages specific to Evil Mode</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">24.2.1<tt>&nbsp;</tt></span><a href="Emacs.html#%28part._.Major_.Modes%29" class="tocsubseclink" data-pltdoc="x">Major Modes</a></td></tr><tr><td><span class="tocsublinknumber">24.2.2<tt>&nbsp;</tt></span><a href="Emacs.html#%28part._.Minor_.Modes%29" class="tocsubseclink" data-pltdoc="x">Minor Modes</a></td></tr><tr><td><span class="tocsublinknumber">24.2.3<tt>&nbsp;</tt></span><a href="Emacs.html#%28part._.Packages_specific_to_.Evil_.Mode%29" class="tocsubseclink" data-pltdoc="x">Packages specific to Evil Mode</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="cmdline-tools.html" title="backward to &quot;24.1 Command-Line Tools&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="other-editors.html" title="up to &quot;24 Command-Line Tools and Your Editor of Choice&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Vim.html" title="forward to &quot;24.3 Vim&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Emacs&quot;">24.2<tt>&nbsp;</tt><a name="(part._.Emacs)"></a>Emacs</h4><p>Emacs has long been a favorite among Lispers and Schemers, and is
+popular among Racketeers as well.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Major_Modes&quot;">24.2.1<tt>&nbsp;</tt><a name="(part._.Major_.Modes)"></a>Major Modes</h5><ul><li><p><a href="https://github.com/greghendershott/racket-mode">Racket mode</a>
+provides thorough syntax highlighting and DrRacket-style REPL
+and buffer execution support for Emacs.</p><p>Racket mode can be installed via <a href="https://melpa.org/">MELPA</a>
+or manually from the Github repository.</p></li><li><p><a href="http://www.neilvandyke.org/quack/">Quack</a> is an
+extension of Emacs&rsquo;s <span class="stt">scheme-mode</span> that provides enhanced
+support for Racket, including highlighting and indentation of
+Racket-specific forms, and documentation integration.</p><p>Quack is included in the Debian and Ubuntu repositories as part
+of the <span class="stt">emacs-goodies-el</span> package. A Gentoo port is also
+available (under the name <span class="stt">app-emacs/quack</span>).</p></li><li><p><a href="https://www.nongnu.org/geiser/">Geiser</a> provides a
+programming environment where the editor is tightly integrated
+with the Racket REPL. Programmers accustomed to environments
+such as Slime or Squeak should feel at home using
+Geiser. Geiser requires GNU Emacs 23.2 or better.</p><p>Quack and Geiser can be used together, and complement each
+other nicely. More information is available in the
+<a href="https://www.nongnu.org/geiser/">Geiser manual</a>.</p><p>Debian and Ubuntu packages for Geiser are available under the
+name <span class="stt">geiser</span>.</p></li><li><p>Emacs ships with a major mode for Scheme, <span class="stt">scheme-mode</span>,
+that while not as featureful as the above options, works
+reasonably well for editing Racket code. However, this mode
+does not provide support for Racket-specific forms.</p></li><li><p>No Racket program is complete without documentation. Scribble
+support for Emacs is available with Neil Van Dyke&rsquo;s
+<a href="http://www.neilvandyke.org/scribble-emacs/">Scribble
+Mode</a>.</p><p>In addition, <span class="stt">texinfo-mode</span> (included with GNU Emacs) and
+ plain text modes work well when editing Scribble
+ documents. The Racket major modes above are not really suited
+ to this task, given how different Scribble&rsquo;s syntax is from
+ Racket&rsquo;s.</p></li></ul><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Minor_Modes&quot;">24.2.2<tt>&nbsp;</tt><a name="(part._.Minor_.Modes)"></a>Minor Modes</h5><ul><li><p><a href="http://mumble.net/~campbell/emacs/paredit.el">Paredit</a>
+is a minor mode for pseudo-structurally editing programs in
+Lisp-like languages. In addition to providing high-level
+S-expression editing commands, it prevents you from
+accidentally unbalancing parentheses.</p><p>Debian and Ubuntu packages for Paredit are available under the
+name <span class="stt">paredit-el</span>.</p></li><li><p><a href="https://github.com/Fuco1/smartparens">Smartparens</a>
+is a minor mode for editing s-expressions, keeping parentheses
+balanced, etc.  Similar to Paredit.</p></li><li><p>Alex Shinn&rsquo;s
+<a href="http://synthcode.com/wiki/scheme-complete">scheme-complete</a>
+provides intelligent, context-sensitive code completion. It
+also integrates with Emacs&rsquo;s <span class="stt">eldoc</span> mode to provide live
+documentation in the minibuffer.</p><p>While this mode was designed for <a href="standards.html#%28part._r5rs%29" data-pltdoc="x">R<span style="vertical-align: super; font-size: 80%">5</span>RS</a>, it
+can still be useful for Racket development. The tool is
+unaware of large portions of the Racket standard library, and
+there may be some discrepancies in the live documentation in
+cases where Scheme and Racket have diverged.</p></li><li><p>The
+<a href="https://www.emacswiki.org/emacs/RainbowDelimiters">RainbowDelimiters</a>
+mode colors parentheses and other delimiters according to their
+nesting depth. Coloring by nesting depth makes it easier to
+know, at a glance, which parentheses match.</p></li><li><p><a href="https://www.emacswiki.org/emacs/ParenFace">ParenFace</a>
+lets you choose in which face (font, color, etc.) parentheses
+should be displayed. Choosing an alternate face makes it
+possible to make &ldquo;tone down&rdquo; parentheses.</p></li></ul><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Packages_specific_to_Evil_Mode&quot;">24.2.3<tt>&nbsp;</tt><a name="(part._.Packages_specific_to_.Evil_.Mode)"></a>Packages specific to Evil Mode</h5><ul><li><p><a href="https://github.com/willghatch/emacs-on-parens">on-parens</a>
+is a wrapper for smartparens motions to work better with
+evil-mode&rsquo;s normal state.</p></li><li><p><a href="https://github.com/timcharper/evil-surround">evil-surround</a>
+provides commands to add, remove, and change parentheses and
+other delimiters.</p></li><li><p><a href="https://github.com/noctuid/evil-textobj-anyblock">evil-textobj-anyblock</a>
+adds a text-object that matches the closest of any
+parenthesis or other delimiter pair.</p></li></ul><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="cmdline-tools.html" title="backward to &quot;24.1 Command-Line Tools&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="other-editors.html" title="up to &quot;24 Command-Line Tools and Your Editor of Choice&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Vim.html" title="forward to &quot;24.3 Vim&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/Invoking_Units.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/Invoking_Units.html
new file mode 100644
index 00000000..4f9564fa
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/Invoking_Units.html
@@ -0,0 +1,18 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14.2&nbsp;Invoking Units</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Signatures_and_Units.html" class="tocviewlink" data-pltdoc="x">Signatures and Units</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="Invoking_Units.html" class="tocviewselflink" data-pltdoc="x">Invoking Units</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="Linking_Units.html" class="tocviewlink" data-pltdoc="x">Linking Units</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="firstclassunits.html" class="tocviewlink" data-pltdoc="x">First-<wbr></wbr>Class Units</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="Whole-module_Signatures_and_Units.html" class="tocviewlink" data-pltdoc="x">Whole-<span class="RktSym"><span class="RktStxLink">module</span></span> Signatures and Units</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="Contracts_for_Units.html" class="tocviewlink" data-pltdoc="x">Contracts for Units</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="unit_versus_module.html" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unit</span></span> versus <span class="RktSym"><span class="RktStxLink">module</span></span></a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Signatures_and_Units.html" title="backward to &quot;14.1 Signatures and Units&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="units.html" title="up to &quot;14 Units (Components)&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Linking_Units.html" title="forward to &quot;14.3 Linking Units&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Invoking_Units&quot;">14.2<tt>&nbsp;</tt><a name="(part._.Invoking_.Units)"></a>Invoking Units</h4><p>The <span class="RktSym">simple-factory@</span> unit has no imports, so it can be
+<a href="units.html#%28tech._invoked%29" class="techoutside" data-pltdoc="x"><span class="techinside">invoked</span></a> directly using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=invokingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._invoke-unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">invoke-unit</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"simple-factory-unit.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=invokingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._invoke-unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">invoke-unit</a></span><span class="hspace">&nbsp;</span><span class="RktSym">simple-factory@</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Factory started.</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=invokingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._invoke-unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">invoke-unit</a></span> form does not make the body definitions
+available, however, so we cannot build any toys with this factory. The
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=invokingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-values%252Finvoke-unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values/invoke-unit</a></span> form binds the identifiers of a
+signature to the values supplied by a unit (to be <a href="units.html#%28tech._invoked%29" class="techoutside" data-pltdoc="x"><span class="techinside">invoked</span></a>) that
+implements the signature:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linkinference.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-values%252Finvoke-unit%252Finfer%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values/invoke-unit/infer</a></span><span class="hspace">&nbsp;</span><span class="RktSym">simple-factory@</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Factory started.</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">build-toys</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(list (toy 'blue) (toy 'blue) (toy 'blue))</span></p></td></tr></table></blockquote><p>Since <span class="RktSym">simple-factory@</span> exports the <span class="RktSym">toy-factory^</span>
+signature, each identifier in <span class="RktSym">toy-factory^</span> is defined by the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linkinference.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-values%252Finvoke-unit%252Finfer%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values/invoke-unit/infer</a></span> form. The
+<span class="RktSym">/infer</span> part of the form name indicates that the
+identifiers bound by the declaration are inferred from
+<span class="RktSym">simple-factory@</span>.</p><p>Now that the identifiers in <span class="RktSym">toy-factory^</span> are defined, we can
+also invoke <span class="RktSym">toy-store@</span>, which imports <span class="RktSym">toy-factory^</span>
+to produce <span class="RktSym">toy-store^</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"toy-store-unit.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linkinference.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-values%252Finvoke-unit%252Finfer%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values/invoke-unit/infer</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-store@</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">get-inventory</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">stock!</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">get-inventory</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(list (toy 'green) (toy 'green))</span></p></td></tr></table></blockquote><p>Again, the <span class="RktSym">/infer</span> part
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linkinference.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-values%252Finvoke-unit%252Finfer%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values/invoke-unit/infer</a></span> determines that
+<span class="RktSym">toy-store@</span> imports <span class="RktSym">toy-factory^</span>, and so it supplies
+the top-level bindings that match the names in <span class="RktSym">toy-factory^</span>
+as imports to <span class="RktSym">toy-store@</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Signatures_and_Units.html" title="backward to &quot;14.1 Signatures and Units&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="units.html" title="up to &quot;14 Units (Components)&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Linking_Units.html" title="forward to &quot;14.3 Linking Units&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/Linking_Units.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/Linking_Units.html
new file mode 100644
index 00000000..43c4f591
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/Linking_Units.html
@@ -0,0 +1,17 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14.3&nbsp;Linking Units</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Signatures_and_Units.html" class="tocviewlink" data-pltdoc="x">Signatures and Units</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="Invoking_Units.html" class="tocviewlink" data-pltdoc="x">Invoking Units</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="Linking_Units.html" class="tocviewselflink" data-pltdoc="x">Linking Units</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="firstclassunits.html" class="tocviewlink" data-pltdoc="x">First-<wbr></wbr>Class Units</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="Whole-module_Signatures_and_Units.html" class="tocviewlink" data-pltdoc="x">Whole-<span class="RktSym"><span class="RktStxLink">module</span></span> Signatures and Units</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="Contracts_for_Units.html" class="tocviewlink" data-pltdoc="x">Contracts for Units</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="unit_versus_module.html" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unit</span></span> versus <span class="RktSym"><span class="RktStxLink">module</span></span></a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Invoking_Units.html" title="backward to &quot;14.2 Invoking Units&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="units.html" title="up to &quot;14 Units (Components)&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="firstclassunits.html" title="forward to &quot;14.4 First-Class Units&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Linking_Units&quot;">14.3<tt>&nbsp;</tt><a name="(part._.Linking_.Units)"></a>Linking Units</h4><p>We can make our toy economy more efficient by having toy factories
+that cooperate with stores, creating toys that do not have to be
+repainted. Instead, the toys are always created using the store&rsquo;s
+color, which the factory gets by importing <span class="RktSym">toy-store^</span>:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"store-specific-factory-unit.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"toy-store-sig.rkt"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"toy-factory-sig.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linkinference.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-unit</a></span><span class="hspace">&nbsp;</span><span class="RktSym">store-specific-factory@</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._import%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">import</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-store^</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._export%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-factory^</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">toy-color</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">store-color</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">build-toys</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">toy</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">repaint</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"cannot repaint"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">store-specific-factory@</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>To invoke <span class="RktSym">store-specific-factory@</span>, we need
+<span class="RktSym">toy-store^</span> bindings to supply to the unit. But to get
+<span class="RktSym">toy-store^</span> bindings by invoking <span class="RktSym">toy-store@</span>, we will
+need a toy factory! The unit implementations are mutually dependent,
+and we cannot invoke either before the other.</p><p>The solution is to <a name="(tech._link)"></a><span style="font-style: italic">link</span> the units together, and then we can
+invoke the combined units. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linkinference.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-compound-unit%252Finfer%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-compound-unit/infer</a></span> form
+links any number of units to form a combined unit. It can propagate
+imports and exports from the linked units, and it can satisfy each
+unit&rsquo;s imports using the exports of other linked units.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"toy-factory-sig.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"toy-store-sig.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"store-specific-factory-unit.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linkinference.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-compound-unit%252Finfer%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-compound-unit/infer</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-store+factory@</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._import%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">import</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._export%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-factory^</span><span class="hspace">&nbsp;</span><span class="RktSym">toy-store^</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._link%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">link</a></span><span class="hspace">&nbsp;</span><span class="RktSym">store-specific-factory@</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">toy-store@</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote><p>The overall result above is a unit <span class="RktSym">toy-store+factory@</span> that
+exports both <span class="RktSym">toy-factory^</span> and <span class="RktSym">toy-store^</span>. The
+connection between <span class="RktSym">store-specific-factory@</span> and
+<span class="RktSym">toy-store@</span> is inferred from the signatures that each imports
+and exports.</p><p>This unit has no imports, so we can always invoke it:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linkinference.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-values%252Finvoke-unit%252Finfer%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values/invoke-unit/infer</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-store+factory@</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">stock!</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">get-inventory</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(list (toy) (toy))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-color</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-inventory</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(green green)</span></p></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Invoking_Units.html" title="backward to &quot;14.2 Invoking Units&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="units.html" title="up to &quot;14 Units (Components)&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="firstclassunits.html" title="forward to &quot;14.4 First-Class Units&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/Lists__Iteration__and_Recursion.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/Lists__Iteration__and_Recursion.html
new file mode 100644
index 00000000..8fa2afe4
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/Lists__Iteration__and_Recursion.html
@@ -0,0 +1,96 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>2.3&nbsp;Lists, Iteration, and Recursion</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewselflink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">2.1&nbsp;</td><td><a href="Simple_Values.html" class="tocviewlink" data-pltdoc="x">Simple Values</a></td></tr><tr><td align="right">2.2&nbsp;</td><td><a href="syntax-overview.html" class="tocviewlink" data-pltdoc="x">Simple Definitions and Expressions</a></td></tr><tr><td align="right">2.3&nbsp;</td><td><a href="Lists__Iteration__and_Recursion.html" class="tocviewselflink" data-pltdoc="x">Lists, Iteration, and Recursion</a></td></tr><tr><td align="right">2.4&nbsp;</td><td><a href="Pairs__Lists__and_Racket_Syntax.html" class="tocviewlink" data-pltdoc="x">Pairs, Lists, and Racket Syntax</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>2.3&nbsp;</td><td><a href="Lists__Iteration__and_Recursion.html" class="tocviewselflink" data-pltdoc="x">Lists, Iteration, and Recursion</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">2.3.1&nbsp;</td><td><a href="Lists__Iteration__and_Recursion.html#%28part._.Predefined_.List_.Loops%29" class="tocviewlink" data-pltdoc="x">Predefined List Loops</a></td></tr><tr><td align="right">2.3.2&nbsp;</td><td><a href="Lists__Iteration__and_Recursion.html#%28part._.List_.Iteration_from_.Scratch%29" class="tocviewlink" data-pltdoc="x">List Iteration from Scratch</a></td></tr><tr><td align="right">2.3.3&nbsp;</td><td><a href="Lists__Iteration__and_Recursion.html#%28part._tail-recursion%29" class="tocviewlink" data-pltdoc="x">Tail Recursion</a></td></tr><tr><td align="right">2.3.4&nbsp;</td><td><a href="Lists__Iteration__and_Recursion.html#%28part._.Recursion_versus_.Iteration%29" class="tocviewlink" data-pltdoc="x">Recursion versus Iteration</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">2.3.1<tt>&nbsp;</tt></span><a href="Lists__Iteration__and_Recursion.html#%28part._.Predefined_.List_.Loops%29" class="tocsubseclink" data-pltdoc="x">Predefined List Loops</a></td></tr><tr><td><span class="tocsublinknumber">2.3.2<tt>&nbsp;</tt></span><a href="Lists__Iteration__and_Recursion.html#%28part._.List_.Iteration_from_.Scratch%29" class="tocsubseclink" data-pltdoc="x">List Iteration from Scratch</a></td></tr><tr><td><span class="tocsublinknumber">2.3.3<tt>&nbsp;</tt></span><a href="Lists__Iteration__and_Recursion.html#%28part._tail-recursion%29" class="tocsubseclink" data-pltdoc="x">Tail Recursion</a></td></tr><tr><td><span class="tocsublinknumber">2.3.4<tt>&nbsp;</tt></span><a href="Lists__Iteration__and_Recursion.html#%28part._.Recursion_versus_.Iteration%29" class="tocsubseclink" data-pltdoc="x">Recursion versus Iteration</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="syntax-overview.html" title="backward to &quot;2.2 Simple Definitions and Expressions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="to-scheme.html" title="up to &quot;2 Racket Essentials&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Pairs__Lists__and_Racket_Syntax.html" title="forward to &quot;2.4 Pairs, Lists, and Racket Syntax&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Lists__Iteration__and_Recursion&quot;">2.3<tt>&nbsp;</tt><a name="(part._.Lists__.Iteration__and_.Recursion)"></a>Lists, Iteration, and Recursion</h4><p>Racket is a dialect of the language Lisp, whose name originally stood
+for &ldquo;LISt Processor.&rdquo; The built-in list datatype remains a prominent
+feature of the language.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span> function takes any number of values and returns
+a list containing the values:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"red"</span><span class="hspace">&nbsp;</span><span class="RktVal">"green"</span><span class="hspace">&nbsp;</span><span class="RktVal">"blue"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("red" "green" "blue")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3 4 5)</span></p></td></tr></table></blockquote><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>A list usually prints with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span>, but the printed
+form of a list depends on its content. See
+<a href="pairs.html" data-pltdoc="x">Pairs and Lists</a> for more information.</p></blockquote></blockquote></blockquote><p>As you can see, a list result prints in the <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> as a quote
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> and then a pair of parentheses wrapped around the printed
+form of the list elements. There&rsquo;s an opportunity for confusion here,
+because parentheses are used for both expressions, such as
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">"red"</span><span class="stt"> </span><span class="RktVal">"green"</span><span class="stt"> </span><span class="RktVal">"blue"</span><span class="RktPn">)</span>, and printed results, such as
+<span class="RktRes">'("red"<span class="stt"> </span>"green"<span class="stt"> </span>"blue")</span>. In addition to the quote,
+parentheses for results are printed in blue in the documentation and
+in DrRacket, whereas parentheses for expressions are brown.</p><p>Many predefined functions operate on lists. Here are a few examples:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hop"</span><span class="hspace">&nbsp;</span><span class="RktVal">"skip"</span><span class="hspace">&nbsp;</span><span class="RktVal">"jump"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">count the elements</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list-ref</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hop"</span><span class="hspace">&nbsp;</span><span class="RktVal">"skip"</span><span class="hspace">&nbsp;</span><span class="RktVal">"jump"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">extract by position</span></td></tr><tr><td><p><span class="RktRes">"hop"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list-ref</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hop"</span><span class="hspace">&nbsp;</span><span class="RktVal">"skip"</span><span class="hspace">&nbsp;</span><span class="RktVal">"jump"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"skip"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">append</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hop"</span><span class="hspace">&nbsp;</span><span class="RktVal">"skip"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"jump"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">combine lists</span></td></tr><tr><td><p><span class="RktRes">'("hop" "skip" "jump")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._reverse%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">reverse</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hop"</span><span class="hspace">&nbsp;</span><span class="RktVal">"skip"</span><span class="hspace">&nbsp;</span><span class="RktVal">"jump"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">reverse order</span></td></tr><tr><td><p><span class="RktRes">'("jump" "skip" "hop")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._member%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"fall"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hop"</span><span class="hspace">&nbsp;</span><span class="RktVal">"skip"</span><span class="hspace">&nbsp;</span><span class="RktVal">"jump"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">check for an element</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Predefined_List_Loops&quot;">2.3.1<tt>&nbsp;</tt><a name="(part._.Predefined_.List_.Loops)"></a>Predefined List Loops</h5><p>In addition to simple operations like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">append</a></span>, Racket includes
+functions that iterate over the elements of a list. These iteration
+functions play a role similar to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> in Java, Racket, and other
+languages. The body of a Racket iteration is packaged into a function
+to be applied to each element, so the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> form becomes
+particularly handy in combination with iteration functions.</p><p>Different list-iteration functions combine iteration results in
+different ways. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span> function uses the per-element
+results to create a new list:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sqrt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sqrt</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="hspace">&nbsp;</span><span class="RktVal">16</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3 4)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">"!"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"peanuts"</span><span class="hspace">&nbsp;</span><span class="RktVal">"popcorn"</span><span class="hspace">&nbsp;</span><span class="RktVal">"crackerjack"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("peanuts!" "popcorn!" "crackerjack!")</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._andmap%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">andmap</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._ormap%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">ormap</a></span> functions combine the results
+by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span>ing or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span>ing:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._andmap%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">andmap</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._andmap%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">andmap</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._ormap%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">ormap</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._andmap%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">andmap</a></span>, and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._ormap%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">ormap</a></span>
+functions can all handle multiple lists, instead of just a single
+list. The lists must all have the same length, and the given function
+must accept one argument for each list:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._substring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">substring</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"peanuts"</span><span class="hspace">&nbsp;</span><span class="RktVal">"popcorn"</span><span class="hspace">&nbsp;</span><span class="RktVal">"crackerjack"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("peanut" "pop" "cracker")</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._filter%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">filter</a></span> function keeps elements for which the body result
+is true, and discards elements for which it is <span class="RktVal">#f</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._filter%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">filter</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("a" "b")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._filter%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">filter</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._positive%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-2</span></span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 6 7)</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._foldl%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">foldl</a></span> function generalizes some iteration functions. It
+uses the per-element function to both process an element and combine
+it with the &ldquo;current&rdquo; value, so the per-element function takes an
+extra first argument. Also, a starting &ldquo;current&rdquo; value must be
+provided before the lists:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._foldl%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">foldl</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">elem</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">elem</span><span class="hspace">&nbsp;</span><span class="RktSym">elem</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">14</span></p></td></tr></table></blockquote><p>Despite its generality, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._foldl%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">foldl</a></span> is not as popular as the other
+functions. One reason is that <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._ormap%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">ormap</a></span>,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._andmap%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">andmap</a></span>, and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._filter%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">filter</a></span> cover the most common kinds of
+list loops.</p><p>Racket provides a general <span style="font-style: italic">list comprehension</span> form
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span>, which builds a list by iterating through
+<span style="font-style: italic">sequences</span>. List comprehensions and related iteration forms
+are described in <a href="for.html" data-pltdoc="x">Iterations and Comprehensions</a>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;List_Iteration_from_Scratch&quot;">2.3.2<tt>&nbsp;</tt><a name="(part._.List_.Iteration_from_.Scratch)"></a>List Iteration from Scratch</h5><p>Although <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span> and other iteration functions are predefined, they
+are not primitive in any interesting sense. You can write equivalent
+iterations using a handful of list primitives.</p><p>Since a Racket list is a linked list, the two core operations on a
+non-empty list are</p><ul><li><p><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._first%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">first</a></span>: get the first thing in the list; and</p></li><li><p><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._rest%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">rest</a></span>: get the rest of the list.</p></li></ul><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._first%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">first</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._rest%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">rest</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(2 3)</span></p></td></tr></table></blockquote></div></p><p>To create a new node for a linked list&#8212;<wbr></wbr>that is, to add to the front
+of the list&#8212;<wbr></wbr>use the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span> function, which is short for
+&ldquo;construct.&rdquo; To get an empty list to start with, use the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty</a></span> constant:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty</a></span></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"head"</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("head")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"dead"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"head"</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("dead" "head")</span></p></td></tr></table></blockquote><p>To process a list, you need to be able to distinguish empty lists from
+non-empty lists, because <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._first%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">first</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._rest%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">rest</a></span> work only on
+non-empty lists. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty?</a></span> function detects empty lists,
+and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._cons%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons?</a></span> detects non-empty lists:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"head"</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._cons%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._cons%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"head"</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote><p>With these pieces, you can write your own versions of the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">length</a></span> function, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span> function, and more.</p><p><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">my-length</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">my-length</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._rest%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">rest</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">my-length</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">my-length</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">my-map</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._first%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">first</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">my-map</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._rest%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">rest</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">my-map</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-upcase%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-upcase</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"ready"</span><span class="hspace">&nbsp;</span><span class="RktVal">"set"</span><span class="hspace">&nbsp;</span><span class="RktVal">"go"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("READY" "SET" "GO")</span></p></td></tr></table></td></tr></table></blockquote></div></p><p>If the derivation of the above definitions is mysterious to you,
+consider reading <span style="font-style: italic"><a href="https://htdp.org">How to Design Programs</a></span>. If you are merely suspicious of the use
+of recursive calls instead of a looping construct, then read on.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;tail-recursion&quot;">2.3.3<tt>&nbsp;</tt><a name="(part._tail-recursion)"></a>Tail Recursion</h5><p>Both the <span class="RktSym">my-length</span> and <span class="RktSym">my-map</span> functions run in
+<span style="font-style: italic">O</span>(<span style="font-style: italic">n</span>)<span style="font-style: italic"></span> space for a list of length <span style="font-style: italic">n</span>. This is easy to see by
+imagining how <span class="RktPn">(</span><span class="RktSym">my-length</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">"a"</span><span class="stt"> </span><span class="RktVal">"b"</span><span class="stt"> </span><span class="RktVal">"c"</span><span class="RktPn">)</span><span class="RktPn">)</span> must evaluate:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym">my-length</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">my-length</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">my-length</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">my-length</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td>=<span class="hspace">&nbsp;</span><span class="RktVal">3</span></td></tr></table></blockquote><p>For a list with <span style="font-style: italic">n</span> elements, evaluation will stack up <span style="font-style: italic">n</span>
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span> additions, and then finally add them up when the
+list is exhausted.</p><p>You can avoid piling up additions by adding along the way. To
+accumulate a length this way, we need a function that takes both a
+list and the length of the list seen so far; the code below uses a
+local function <span class="RktSym">iter</span> that accumulates the length in an
+argument <span class="RktSym">len</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">my-length</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">local function </span><span class="RktSym">iter</span><span class="RktCmt">:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">iter</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="hspace">&nbsp;</span><span class="RktSym">len</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">len</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">iter</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._rest%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">rest</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">len</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">body of </span><span class="RktSym">my-length</span><span class="RktCmt"> calls </span><span class="RktSym">iter</span><span class="RktCmt">:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">iter</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Now evaluation looks like this:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym">my-length</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">iter</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">iter</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">iter</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">iter</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktVal">3</span></td></tr></table></blockquote><p>The revised <span class="RktSym">my-length</span> runs in constant space, just as the
+evaluation steps above suggest. That is, when the result of a
+function call, like <span class="RktPn">(</span><span class="RktSym">iter</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">"b"</span><span class="stt"> </span><span class="RktVal">"c"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span>, is exactly the
+result of some other function call, like <span class="RktPn">(</span><span class="RktSym">iter</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">"c"</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span>, then the first one doesn&rsquo;t have to wait around for the second
+one, because that takes up space for no good reason.</p><p>This evaluation behavior is sometimes called <span style="font-style: italic">tail-call
+optimization</span>, but it&rsquo;s not merely an &ldquo;optimization&rdquo; in Racket; it&rsquo;s
+a guarantee about the way the code will run. More precisely, an
+expression in <a name="(tech._tail._position)"></a><span style="font-style: italic">tail position</span> with respect to another
+expression does not take extra computation space over the other
+expression.</p><p>In the case of <span class="RktSym">my-map</span>, <span style="font-style: italic">O</span>(<span style="font-style: italic">n</span>)<span style="font-style: italic"></span> space complexity is
+reasonable, since it has to generate a result of size
+<span style="font-style: italic">O</span>(<span style="font-style: italic">n</span>)<span style="font-style: italic"></span>. Nevertheless, you can reduce the constant factor by
+accumulating the result list. The only catch is that the accumulated
+list will be backwards, so you&rsquo;ll have to reverse it at the very end:</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Attempting to reduce a constant factor like this is
+usually not worthwhile, as discussed below.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">my-map</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">iter</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="hspace">&nbsp;</span><span class="RktSym">backward-result</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._reverse%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">reverse</a></span><span class="hspace">&nbsp;</span><span class="RktSym">backward-result</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">iter</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._rest%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">rest</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._first%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">first</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">backward-result</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">iter</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>It turns out that if you write</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">my-map</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>then the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span> form in the function is expanded to
+essentially the same code as the <span class="RktSym">iter</span> local definition and
+use. The difference is merely syntactic convenience.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Recursion_versus_Iteration&quot;">2.3.4<tt>&nbsp;</tt><a name="(part._.Recursion_versus_.Iteration)"></a>Recursion versus Iteration</h5><p>The <span class="RktSym">my-length</span> and <span class="RktSym">my-map</span> examples demonstrate that
+iteration is just a special case of recursion. In many languages, it&rsquo;s
+important to try to fit as many computations as possible into
+iteration form. Otherwise, performance will be bad, and moderately
+large inputs can lead to stack overflow.  Similarly, in Racket, it is
+sometimes important to make sure that tail recursion is used to avoid
+<span style="font-style: italic">O</span>(<span style="font-style: italic">n</span>)<span style="font-style: italic"></span> space consumption when the computation is easily performed
+in constant space.</p><p>At the same time, recursion does not lead to particularly bad
+performance in Racket, and there is no such thing as stack overflow;
+you can run out of memory if a computation involves too much context,
+but exhausting memory typically requires orders of magnitude deeper
+recursion than would trigger a stack overflow in other
+languages. These considerations, combined with the fact that
+tail-recursive programs automatically run the same as a loop, lead
+Racket programmers to embrace recursive forms rather than avoid them.</p><p>Suppose, for example, that you want to remove consecutive duplicates
+from a list. While such a function can be written as a loop that
+remembers the previous element for each iteration, a Racket programmer
+would more likely just write the following:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">remove-dups</span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._rest%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">rest</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._first%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">first</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._first%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">first</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._rest%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">rest</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">remove-dups</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._rest%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">rest</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">remove-dups</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._rest%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">rest</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">remove-dups</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("a" "b" "c")</span></p></td></tr></table></td></tr></table></blockquote><p>In general, this function consumes <span style="font-style: italic">O</span>(<span style="font-style: italic">n</span>)<span style="font-style: italic"></span> space for an input
+list of length <span style="font-style: italic">n</span>, but that&rsquo;s fine, since it produces an
+<span style="font-style: italic">O</span>(<span style="font-style: italic">n</span>)<span style="font-style: italic"></span> result. If the input list happens to be mostly consecutive
+duplicates, then the resulting list can be much smaller than
+<span style="font-style: italic">O</span>(<span style="font-style: italic">n</span>)<span style="font-style: italic"></span>&#8212;<wbr></wbr>and <span class="RktSym">remove-dups</span> will also use much less than
+<span style="font-style: italic">O</span>(<span style="font-style: italic">n</span>)<span style="font-style: italic"></span> space! The reason is that when the function discards
+duplicates, it returns the result of a <span class="RktSym">remove-dups</span> call
+directly, so the tail-call &ldquo;optimization&rdquo; kicks in:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym">remove-dups</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">remove-dups</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">remove-dups</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">remove-dups</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">remove-dups</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">remove-dups</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td>=<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="RktPn">)</span></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="syntax-overview.html" title="backward to &quot;2.2 Simple Definitions and Expressions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="to-scheme.html" title="up to &quot;2 Racket Essentials&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Pairs__Lists__and_Racket_Syntax.html" title="forward to &quot;2.4 Pairs, Lists, and Racket Syntax&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/Looking_Ahead_and_Behind.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/Looking_Ahead_and_Behind.html
new file mode 100644
index 00000000..2879ae6c
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/Looking_Ahead_and_Behind.html
@@ -0,0 +1,22 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>9.9&nbsp;Looking Ahead and Behind</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewselflink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">9.1&nbsp;</td><td><a href="regexp-intro.html" class="tocviewlink" data-pltdoc="x">Writing Regexp Patterns</a></td></tr><tr><td align="right">9.2&nbsp;</td><td><a href="regexp-match.html" class="tocviewlink" data-pltdoc="x">Matching Regexp Patterns</a></td></tr><tr><td align="right">9.3&nbsp;</td><td><a href="regexp-assert.html" class="tocviewlink" data-pltdoc="x">Basic Assertions</a></td></tr><tr><td align="right">9.4&nbsp;</td><td><a href="regexp-chars.html" class="tocviewlink" data-pltdoc="x">Characters and Character Classes</a></td></tr><tr><td align="right">9.5&nbsp;</td><td><a href="regexp-quant.html" class="tocviewlink" data-pltdoc="x">Quantifiers</a></td></tr><tr><td align="right">9.6&nbsp;</td><td><a href="regexp-clusters.html" class="tocviewlink" data-pltdoc="x">Clusters</a></td></tr><tr><td align="right">9.7&nbsp;</td><td><a href="regexp-alternation.html" class="tocviewlink" data-pltdoc="x">Alternation</a></td></tr><tr><td align="right">9.8&nbsp;</td><td><a href="Backtracking.html" class="tocviewlink" data-pltdoc="x">Backtracking</a></td></tr><tr><td align="right">9.9&nbsp;</td><td><a href="Looking_Ahead_and_Behind.html" class="tocviewselflink" data-pltdoc="x">Looking Ahead and Behind</a></td></tr><tr><td align="right">9.10&nbsp;</td><td><a href="An_Extended_Example.html" class="tocviewlink" data-pltdoc="x">An Extended Example</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>9.9&nbsp;</td><td><a href="Looking_Ahead_and_Behind.html" class="tocviewselflink" data-pltdoc="x">Looking Ahead and Behind</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">9.9.1&nbsp;</td><td><a href="Looking_Ahead_and_Behind.html#%28part._.Lookahead%29" class="tocviewlink" data-pltdoc="x">Lookahead</a></td></tr><tr><td align="right">9.9.2&nbsp;</td><td><a href="Looking_Ahead_and_Behind.html#%28part._.Lookbehind%29" class="tocviewlink" data-pltdoc="x">Lookbehind</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">9.9.1<tt>&nbsp;</tt></span><a href="Looking_Ahead_and_Behind.html#%28part._.Lookahead%29" class="tocsubseclink" data-pltdoc="x">Lookahead</a></td></tr><tr><td><span class="tocsublinknumber">9.9.2<tt>&nbsp;</tt></span><a href="Looking_Ahead_and_Behind.html#%28part._.Lookbehind%29" class="tocsubseclink" data-pltdoc="x">Lookbehind</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Backtracking.html" title="backward to &quot;9.8 Backtracking&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="regexp.html" title="up to &quot;9 Regular Expressions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="An_Extended_Example.html" title="forward to &quot;9.10 An Extended Example&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Looking_Ahead_and_Behind&quot;">9.9<tt>&nbsp;</tt><a name="(part._.Looking_.Ahead_and_.Behind)"></a>Looking Ahead and Behind</h4><p>You can have assertions in your pattern that look <span class="emph">ahead</span> or
+<span class="emph">behind</span> to ensure that a subpattern does or does not occur.
+These &ldquo;look around&rdquo; assertions are specified by putting the
+subpattern checked for in a cluster whose leading characters are:
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">?=</span><span class="hspace"></span></span> (for positive lookahead), <span class="RktInBG"><span class="hspace"></span><span class="RktIn">?!</span><span class="hspace"></span></span> (negative
+lookahead), <span class="RktInBG"><span class="hspace"></span><span class="RktIn">?&lt;=</span><span class="hspace"></span></span> (positive lookbehind), <span class="RktInBG"><span class="hspace"></span><span class="RktIn">?&lt;!</span><span class="hspace"></span></span>
+(negative lookbehind).  Note that the subpattern in the assertion does
+not generate a match in the final result; it merely allows or
+disallows the rest of the match.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Lookahead&quot;">9.9.1<tt>&nbsp;</tt><a name="(part._.Lookahead)"></a>Lookahead</h5><p>Positive lookahead with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">?=</span><span class="hspace"></span></span> peeks ahead to ensure that
+its subpattern <span class="emph">could</span> match.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"grey(?=hound)"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"i left my grey socks at the greyhound"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'((28 . 32))</span></p></td></tr></table></blockquote><p>The regexp <span class="RktVal">#rx"grey(?=hound)"</span> matches <span class="RktInBG"><span class="hspace"></span><span class="RktIn">grey</span><span class="hspace"></span></span>, but
+<span class="emph">only</span> if it is followed by <span class="RktInBG"><span class="hspace"></span><span class="RktIn">hound</span><span class="hspace"></span></span>.  Thus, the first
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">grey</span><span class="hspace"></span></span> in the text string is not matched.</p><p>Negative lookahead with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">?!</span><span class="hspace"></span></span> peeks ahead to ensure that its
+subpattern <span class="emph">could not</span> possibly match.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"grey(?!hound)"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"the gray greyhound ate the grey socks"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'((27 . 31))</span></p></td></tr></table></blockquote><p>The regexp <span class="RktVal">#rx"grey(?!hound)"</span> matches <span class="RktInBG"><span class="hspace"></span><span class="RktIn">grey</span><span class="hspace"></span></span>, but
+only if it is <span class="emph">not</span> followed by <span class="RktInBG"><span class="hspace"></span><span class="RktIn">hound</span><span class="hspace"></span></span>.  Thus the
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">grey</span><span class="hspace"></span></span> just before <span class="RktInBG"><span class="hspace"></span><span class="RktIn">socks</span><span class="hspace"></span></span> is matched.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Lookbehind&quot;">9.9.2<tt>&nbsp;</tt><a name="(part._.Lookbehind)"></a>Lookbehind</h5><p>Positive lookbehind with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">?&lt;=</span><span class="hspace"></span></span> checks that its subpattern
+<span class="emph">could</span> match immediately to the left of the current position in
+the text string.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"(?&lt;=grey)hound"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"the hound in the picture is not a greyhound"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'((38 . 43))</span></p></td></tr></table></blockquote><p>The regexp <span class="RktVal">#rx"(?&lt;=grey)hound"</span> matches <span class="RktInBG"><span class="hspace"></span><span class="RktIn">hound</span><span class="hspace"></span></span>, but
+only if it is preceded by <span class="RktInBG"><span class="hspace"></span><span class="RktIn">grey</span><span class="hspace"></span></span>.</p><p>Negative lookbehind with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">?&lt;!</span><span class="hspace"></span></span> checks that its subpattern
+could not possibly match immediately to the left.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"(?&lt;!grey)hound"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"the greyhound in the picture is not a hound"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'((38 . 43))</span></p></td></tr></table></blockquote><p>The regexp <span class="RktVal">#rx"(?&lt;!grey)hound"</span> matches <span class="RktInBG"><span class="hspace"></span><span class="RktIn">hound</span><span class="hspace"></span></span>, but
+only if it is <span class="emph">not</span> preceded by <span class="RktInBG"><span class="hspace"></span><span class="RktIn">grey</span><span class="hspace"></span></span>.</p><p>Lookaheads and lookbehinds can be convenient when they
+are not confusing.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Backtracking.html" title="backward to &quot;9.8 Backtracking&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="regexp.html" title="up to &quot;9 Regular Expressions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="An_Extended_Example.html" title="forward to &quot;9.10 An Extended Example&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/Module_Syntax.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/Module_Syntax.html
new file mode 100644
index 00000000..1ecd61b8
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/Module_Syntax.html
@@ -0,0 +1,107 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6.2&nbsp;Module Syntax</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewselflink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="module-basics.html" class="tocviewlink" data-pltdoc="x">Module Basics</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="Module_Syntax.html" class="tocviewselflink" data-pltdoc="x">Module Syntax</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="module-paths.html" class="tocviewlink" data-pltdoc="x">Module Paths</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="module-require.html" class="tocviewlink" data-pltdoc="x">Imports:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span></a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="module-provide.html" class="tocviewlink" data-pltdoc="x">Exports:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="module-set.html" class="tocviewlink" data-pltdoc="x">Assignment and Redefinition</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="module-macro.html" class="tocviewlink" data-pltdoc="x">Modules and Macros</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="protect-out.html" class="tocviewlink" data-pltdoc="x">Protected Exports</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>6.2&nbsp;</td><td><a href="Module_Syntax.html" class="tocviewselflink" data-pltdoc="x">Module Syntax</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.2.1&nbsp;</td><td><a href="Module_Syntax.html#%28part._module-syntax%29" class="tocviewlink" data-pltdoc="x">The <span class="RktSym"><span class="RktStxLink">module</span></span> Form</a></td></tr><tr><td align="right">6.2.2&nbsp;</td><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="tocviewlink" data-pltdoc="x">The <span class="RktMod">#lang</span> Shorthand</a></td></tr><tr><td align="right">6.2.3&nbsp;</td><td><a href="Module_Syntax.html#%28part._submodules%29" class="tocviewlink" data-pltdoc="x">Submodules</a></td></tr><tr><td align="right">6.2.4&nbsp;</td><td><a href="Module_Syntax.html#%28part._main-and-test%29" class="tocviewlink" data-pltdoc="x">Main and Test Submodules</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">6.2.1<tt>&nbsp;</tt></span><a href="Module_Syntax.html#%28part._module-syntax%29" class="tocsubseclink" data-pltdoc="x">The <span class="RktSym"><span class="RktStxLink">module</span></span> Form</a></td></tr><tr><td><span class="tocsublinknumber">6.2.2<tt>&nbsp;</tt></span><a href="Module_Syntax.html#%28part._hash-lang%29" class="tocsubseclink" data-pltdoc="x">The <span class="RktMod">#lang</span> Shorthand</a></td></tr><tr><td><span class="tocsublinknumber">6.2.3<tt>&nbsp;</tt></span><a href="Module_Syntax.html#%28part._submodules%29" class="tocsubseclink" data-pltdoc="x">Submodules</a></td></tr><tr><td><span class="tocsublinknumber">6.2.4<tt>&nbsp;</tt></span><a href="Module_Syntax.html#%28part._main-and-test%29" class="tocsubseclink" data-pltdoc="x">Main and Test Submodules</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="module-basics.html" title="backward to &quot;6.1 Module Basics&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="modules.html" title="up to &quot;6 Modules&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="module-paths.html" title="forward to &quot;6.3 Module Paths&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Module_Syntax&quot;">6.2<tt>&nbsp;</tt><a name="(part._.Module_.Syntax)"></a>Module Syntax</h4><p>The <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span> at the start of a module file begins a shorthand
+for a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> form, much like <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> is a shorthand for a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span> form. Unlike <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span>, the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span>
+shorthand does not work well in a <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>, in part because it must be
+terminated by an end-of-file, but also because the longhand expansion
+of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span> depends on the name of the enclosing file.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;module-syntax&quot;">6.2.1<tt>&nbsp;</tt><a name="(part._module-syntax)"></a>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> Form</h5><p>The longhand form of a module declaration, which works in a
+<a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> as well as a file, is</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktVar">name-id</span><span class="hspace">&nbsp;</span><span class="RktVar">initial-module-path</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">decl</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote><p>where the <span class="RktVar">name-id</span> is a name for the module,
+<span class="RktVar">initial-module-path</span> is an initial import, and each
+<span class="RktVar">decl</span> is an import, export, definition, or expression.  In
+the case of a file, <span class="RktVar">name-id</span> normally matches the name of the
+containing file, minus its directory path or file extension, but
+<span class="RktVar">name-id</span> is ignored when the module is <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>d
+through its file&rsquo;s path.</p><p>The <span class="RktVar">initial-module-path</span> is needed because even the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> form must be imported for further use in the module
+body. In other words, the <span class="RktVar">initial-module-path</span> import
+bootstraps the syntax that is available in the body. The most commonly used
+<span class="RktVar">initial-module-path</span> is <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a>, which supplies most
+of the bindings described in this guide, including <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span>, and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span>. Another commonly used
+<span class="RktVar">initial-module-path</span> is <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a>, which provides
+less functionality, but still much of the most commonly needed
+functions and syntax.</p><p>For example, the <span class="stt">"cake.rkt"</span> example of the
+<a href="module-basics.html" data-pltdoc="x">previous section</a> could be written as</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cake</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">print-cake</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">print-cake</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">"</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">~a</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">#\.</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">" .-~a-. "</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">#\|</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">" | ~a | "</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">#\space</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">"---~a---"</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">#\-</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktSym">fmt</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fmt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Output.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._newline%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">newline</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Furthermore, this <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> form can be evaluated in a
+<a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> to declare a <span class="RktSym">cake</span> module that is not associated
+with any file. To refer to such an unassociated module, quote the
+module name:</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">cake</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">print-cake</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut"></span><span class="hspace">&nbsp;</span><span class="RktOut"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktOut">... </span><span class="hspace">&nbsp;&nbsp;</span><span class="RktOut"></span></p></td></tr><tr><td><p><span class="RktOut"></span><span class="hspace">&nbsp;</span><span class="RktOut">.-|||-. </span></p></td></tr><tr><td><p><span class="RktOut"></span><span class="hspace">&nbsp;</span><span class="RktOut">| </span><span class="hspace">&nbsp;&nbsp;</span><span class="RktOut"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktOut">| </span></p></td></tr><tr><td><p><span class="RktOut">---------</span></p></td></tr></table></td></tr></table></blockquote></div></p><p>Declaring a module does not immediately evaluate the body definitions
+and expressions of the module. The module must be explicitly
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>d at the top level to trigger evaluation. After
+evaluation is triggered once, later <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>s do not
+re-evaluate the module body.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hi</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Hello\n"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">hi</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Hello</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">hi</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;hash-lang&quot;">6.2.2<tt>&nbsp;</tt><a name="(part._hash-lang)"></a>The <span class="RktMod">#lang</span> Shorthand</h5><p>The body of a <span class="RktMod">#lang</span> shorthand has no specific syntax,
+because the syntax is determined by the language name that follows
+<span class="RktMod">#lang</span>.</p><p>In the case of <span class="RktMod">#lang</span> <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a>, the syntax
+is</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktVar">decl</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span></td></tr></table></blockquote><p>which reads the same as</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">decl</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr></table></blockquote><p>where <span class="RktVar">name</span> is derived from the name of the file that
+contains the <span class="RktMod">#lang</span> form.</p><p>The <span class="RktMod">#lang</span> <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a> form has the same
+syntax as <span class="RktMod">#lang</span> <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a>, except that
+the longhand expansion uses <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a> instead of
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a>. The <span class="RktMod">#lang</span> <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=scribble&amp;rel=manual.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">scribble/manual</span></a> form, in
+contrast, has a completely different syntax that doesn&rsquo;t even look
+like Racket, and which we do not attempt to describe in this guide.</p><p>Unless otherwise specified, a module that is documented as a
+&ldquo;language&rdquo; using the <span class="RktMod">#lang</span> notation will expand to
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> in the same way as <span class="RktMod">#lang</span>
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a>. The documented language name can be used
+directly with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>, too.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;submodules&quot;">6.2.3<tt>&nbsp;</tt><a name="(part._submodules)"></a>Submodules</h5><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> form can be nested within a module, in which case
+the nested <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> form declares a
+<a name="(tech._submodule)"></a><span style="font-style: italic">submodule</span>. Submodules can be referenced directly by the
+enclosing module using a quoted name. The following example prints
+<span class="RktVal">"Tony"</span> by importing <span class="RktSym">tiger</span> from the <span class="RktSym">zoo</span>
+submodule:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"park.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">zoo</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tiger</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tiger</span><span class="hspace">&nbsp;</span><span class="RktVal">"Tony"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">zoo</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktSym">tiger</span></td></tr></table></blockquote></blockquote></blockquote><p>Running a module does not necessarily run its submodules. In the above
+example, running <span class="stt">"park.rkt"</span> runs its submodule <span class="RktSym">zoo</span>
+only because the <span class="stt">"park.rkt"</span> module <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>s the
+<span class="RktSym">zoo</span> submodule. Otherwise, a module and each of its submodules can be run
+independently. Furthermore, if <span class="stt">"park.rkt"</span> is compiled to a
+bytecode file (via <span class="stt">raco make</span>), then the code for
+<span class="stt">"park.rkt"</span> or the code for <span class="RktSym">zoo</span> can be loaded independently.</p><p>Submodules can be nested within submodules, and a submodule can be
+referenced directly by a module other than its enclosing module by
+using a <a href="module-paths.html#%28elem._submod%29" data-pltdoc="x">submodule path</a>.</p><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module*</a></span> form is similar to a nested <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> form:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module*</a></span><span class="hspace">&nbsp;</span><span class="RktVar">name-id</span><span class="hspace">&nbsp;</span><span class="RktVar">initial-module-path-or-#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">decl</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module*</a></span> form differs from <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> in that it
+inverts the possibilities for reference between the submodule and
+enclosing module:</p><ul><li><p>A submodule declared with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> can be
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>d by its enclosing module, but the submodule
+cannot <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> the enclosing module or lexically
+reference the enclosing module&rsquo;s bindings.</p></li><li><p>A submodule declared with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module*</a></span> can <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>
+its enclosing module, but the enclosing module cannot
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> the submodule.</p></li></ul><p>In addition, a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module*</a></span> form can specify <span class="RktVal">#f</span> in place of an
+<span class="RktVar">initial-module-path</span>, in which case the submodule sees all of
+the enclosing module&rsquo;s bindings&#8212;<wbr></wbr>including bindings that are not
+exported via <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span>.</p><p>One use of submodules declared with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module*</a></span> and <span class="RktVal">#f</span> is
+to export additional bindings through a submodule that are not
+normally exported from the module:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"cake.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">print-cake</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">print-cake</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">"</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">~a</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">#\.</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">" .-~a-. "</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">#\|</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">" | ~a | "</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">#\space</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">"---~a---"</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">#\-</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktSym">fmt</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fmt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Output.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._newline%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">newline</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">extras</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">show</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>In this revised <span class="stt">"cake.rkt"</span> module, <span class="RktSym">show</span> is not
+imported by a module that uses <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktVal">"cake.rkt"</span><span class="RktPn">)</span>, since
+most clients of <span class="stt">"cake.rkt"</span> will not want the extra function.  A
+module can require the <span class="RktSym">extra</span> <a href="Module_Syntax.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodule</span></a> using
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._submod%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">submod</a></span><span class="stt"> </span><span class="RktVal">"cake.rkt"</span><span class="stt"> </span><span class="RktSym">extras</span><span class="RktPn">)</span><span class="RktPn">)</span> to access the otherwise
+hidden <span class="RktSym">show</span> function.<span class="refelem"><span class="refcolumn"><span class="refcontent">See <a href="module-paths.html#%28elem._submod%29" data-pltdoc="x">submodule paths</a>
+for more information on <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._submod%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">submod</a></span>.</span></span></span></p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;main-and-test&quot;">6.2.4<tt>&nbsp;</tt><a name="(part._main-and-test)"></a>Main and Test Submodules</h5><p>The following variant of <span class="stt">"cake.rkt"</span> includes a <span class="RktSym">main</span>
+submodule that calls <span class="RktSym">print-cake</span>:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"cake.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">print-cake</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">"</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">~a</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">#\.</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">" .-~a-. "</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">#\|</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">" | ~a | "</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">#\space</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">"---~a---"</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">#\-</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktSym">fmt</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fmt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Output.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._newline%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">newline</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">main</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">print-cake</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>Running a module does not run its <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module*</a></span>-defined
+submodules. Nevertheless, running the above module via <span class="stt">racket</span>
+or DrRacket prints a cake with 10 candles, because the <span class="RktSym">main</span>
+<a href="Module_Syntax.html#%28tech._submodule%29" class="techoutside" data-pltdoc="x"><span class="techinside">submodule</span></a> is a special case.</p><p>When a module is provided as a program name to the <span class="stt">racket</span>
+executable or run directly within DrRacket, if the module has a
+<a name="(idx._(gentag._1._(lib._scribblings/guide/guide..scrbl)))"></a><span class="RktSym">main</span> submodule, the <span class="RktSym">main</span> submodule is run
+after its enclosing module. Declaring a <span class="RktSym">main</span> submodule
+thus specifies extra actions to be performed when a module is run directly,
+instead of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>d as a library within a larger program.</p><p>A <span class="RktSym">main</span> submodule does not have to be declared with
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module*</a></span>. If the <span class="RktSym">main</span> module does not need to use
+bindings from its enclosing module, it can be declared with
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span>. More commonly, <span class="RktSym">main</span> is declared using
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._module%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module+</a></span>:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._module%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module+</a></span><span class="hspace">&nbsp;</span><span class="RktVar">name-id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">decl</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote><p>A submodule declared with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._module%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module+</a></span> is like one declared with
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module*</a></span> using <span class="RktVal">#f</span> as its
+<span class="RktVar">initial-module-path</span>.  In addition,
+multiple <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._module%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module+</a></span> forms can specify the same submodule name,
+in which case the bodies of the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._module%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module+</a></span> forms are combined to
+create a single submodule.</p><p>The combining behavior of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._module%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module+</a></span> is particularly useful for
+defining a <span class="RktSym">test</span> submodule, which can be conveniently run
+using <span class="stt">raco test</span> in much the same way that <span class="RktSym">main</span> is
+conveniently run with <span class="stt">racket</span>. For example, the following
+<span class="stt">"physics.rkt"</span> module exports <span class="RktSym">drop</span> and
+<span class="RktSym">to-energy</span> functions, and it defines a <span class="RktSym">test</span> module to
+hold unit tests:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"physics.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._module%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">test</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rackunit</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&#949;</span><span class="hspace">&nbsp;</span><span class="RktVal">1e-10</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">drop</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">to-energy</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">drop</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1/2</span><span class="hspace">&nbsp;</span><span class="RktVal">9.8</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._module%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">test</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._check-%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">check-=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">drop</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">&#949;</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._check-%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">check-=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">drop</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">490</span><span class="hspace">&nbsp;</span><span class="RktSym">&#949;</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">to-energy</span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._expt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">299792458.0</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._module%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">test</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._check-%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">check-=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">to-energy</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">&#949;</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._check-%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">check-=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">to-energy</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">9e+16</span><span class="hspace">&nbsp;</span><span class="RktVal">1e+15</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>Importing <span class="stt">"physics.rkt"</span> into a larger program does not run
+the <span class="RktSym">drop</span> and <span class="RktSym">to-energy</span> tests&#8212;<wbr></wbr>or even trigger the
+loading of the test code, if the module is compiled&#8212;<wbr></wbr>but running
+<span class="stt">raco test physics.rkt</span> at a command line runs the tests.</p><p>The above <span class="stt">"physics.rkt"</span> module is equivalent to using
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module*</a></span>:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"physics.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">drop</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">to-energy</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">drop</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1/2</span><span class="hspace">&nbsp;</span><span class="RktVal">49/5</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">to-energy</span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._expt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">299792458</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">test</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rackunit</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&#949;</span><span class="hspace">&nbsp;</span><span class="RktVal">1e-10</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._check-%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">check-=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">drop</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">&#949;</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._check-%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">check-=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">drop</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">490</span><span class="hspace">&nbsp;</span><span class="RktSym">&#949;</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._check-%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">check-=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">to-energy</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">&#949;</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._check-%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">check-=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">to-energy</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">9e+16</span><span class="hspace">&nbsp;</span><span class="RktVal">1e+15</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>Using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._module%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module+</a></span> instead of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module*</a></span> allows tests to be
+interleaved with function definitions.</p><p>The combining behavior of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._module%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module+</a></span> is also sometimes helpful
+for a <span class="RktSym">main</span> module. Even when combining is not needed,
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._module%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module+</a></span><span class="stt"> </span><span class="RktSym">main</span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span> is preferred as it is more readable than
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module*</a></span><span class="stt"> </span><span class="RktSym">main</span><span class="stt"> </span><span class="RktVal">#f</span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="module-basics.html" title="backward to &quot;6.1 Module Basics&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="modules.html" title="up to &quot;6 Modules&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="module-paths.html" title="forward to &quot;6.3 Module Paths&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/More_Libraries.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/More_Libraries.html
new file mode 100644
index 00000000..a09b2f54
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/More_Libraries.html
@@ -0,0 +1,40 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>22&nbsp;More Libraries</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9660;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewselflink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewselflink" data-pltdoc="x">More Libraries</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">22.1&nbsp;</td><td><a href="More_Libraries.html#%28part._graphics%29" class="tocviewlink" data-pltdoc="x">Graphics and GUIs</a></td></tr><tr><td align="right">22.2&nbsp;</td><td><a href="More_Libraries.html#%28part._.The_.Web_.Server%29" class="tocviewlink" data-pltdoc="x">The Web Server</a></td></tr><tr><td align="right">22.3&nbsp;</td><td><a href="More_Libraries.html#%28part._.Using_.Foreign_.Libraries%29" class="tocviewlink" data-pltdoc="x">Using Foreign Libraries</a></td></tr><tr><td align="right">22.4&nbsp;</td><td><a href="More_Libraries.html#%28part._.And_.More%29" class="tocviewlink" data-pltdoc="x">And More</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">22.1<tt>&nbsp;</tt></span><a href="More_Libraries.html#%28part._graphics%29" class="tocsubseclink" data-pltdoc="x">Graphics and GUIs</a></td></tr><tr><td><span class="tocsublinknumber">22.2<tt>&nbsp;</tt></span><a href="More_Libraries.html#%28part._.The_.Web_.Server%29" class="tocsubseclink" data-pltdoc="x">The Web Server</a></td></tr><tr><td><span class="tocsublinknumber">22.3<tt>&nbsp;</tt></span><a href="More_Libraries.html#%28part._.Using_.Foreign_.Libraries%29" class="tocsubseclink" data-pltdoc="x">Using Foreign Libraries</a></td></tr><tr><td><span class="tocsublinknumber">22.4<tt>&nbsp;</tt></span><a href="More_Libraries.html#%28part._.And_.More%29" class="tocsubseclink" data-pltdoc="x">And More</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="exe.html" title="backward to &quot;21.3 Creating Stand-Alone Executables&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="dialects.html" title="forward to &quot;23 Dialects of Racket and Scheme&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;More_Libraries&quot;">22<tt>&nbsp;</tt><a name="(part._.More_.Libraries)"></a>More Libraries</h3><p>This guide covers only the Racket language and libraries that are
+documented in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a>. The Racket distribution includes many
+additional libraries.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;graphics&quot;">22.1<tt>&nbsp;</tt><a name="(part._graphics)"></a>Graphics and GUIs</h4><p>Racket provides many libraries for graphics and graphical user
+interfaces (GUIs):</p><ul><li><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=draw&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/draw</span></a> library provides basic drawing
+tools, including drawing contexts such as bitmaps and
+PostScript files.</p><p>See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=draw&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Drawing Toolkit</a>
+for more information.</p></li><li><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/gui</span></a> library provides GUI widgets
+such as windows, buttons, checkboxes, and text fields. The
+library also includes a sophisticated and extensible text
+editor.</p><p>See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Graphical Interface Toolkit</a>
+for more information.</p></li><li><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=pict&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">pict</span></a> library provides a more
+functional abstraction layer over <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=draw&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/draw</span></a>.
+This layer is especially useful for creating slide
+presentations with <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=slideshow&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">Slideshow</a>, but
+it is also useful for creating images for <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=scribble&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">Scribble</a>
+documents or other drawing tasks. Pictures created with the
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=pict&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">pict</span></a> library can be rendered to any
+drawing context.</p><p>See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=slideshow&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">Slideshow: Figure and Presentation Tools</a>
+for more information.</p></li><li><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?tag=%28mod-path._.%272htdp%2Fimage.%27%29&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">2htdp/image</span></a> library is similar to
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=pict&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">pict</span></a>. It is more streamlined for
+pedagogical use, but also slightly more specific to screen and
+bitmap drawing.</p><p>See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?tag=%28mod-path._.%272htdp%2Fimage.%27%29&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">2htdp/image</span></a> for more information.</p></li><li><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?tag=%28mod-path._.%27sgl.%27%29&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">sgl</span></a> library provides OpenGL for 3-D
+graphics. The context for rendering OpenGL can be a window or
+bitmap created with <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/gui</span></a>.</p><p>See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?tag=%28part._%28.%27%28lib._sgl%2Fscribblings%2Fsgl..scrbl%29.%27._.%27top.%27%29%29&amp;version=8.6" class="Sq" data-pltdoc="x">the SGL documentation</a> for more
+information.</p></li></ul><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;The_Web_Server&quot;">22.2<tt>&nbsp;</tt><a name="(part._.The_.Web_.Server)"></a>The Web Server</h4><p><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=web-server&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">Web Applications in Racket</a>
+describes the Racket web server, which supports servlets implemented
+in Racket.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Using_Foreign_Libraries&quot;">22.3<tt>&nbsp;</tt><a name="(part._.Using_.Foreign_.Libraries)"></a>Using Foreign Libraries</h4><p><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Foreign Interface</a> describes
+tools for using Racket to access libraries that are normally used by C
+programs.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;And_More&quot;">22.4<tt>&nbsp;</tt><a name="(part._.And_.More)"></a>And More</h4><p><a href="https://download.racket-lang.org/releases/8.6/doc/index.html">Racket Documentation</a> lists documentation for
+other libraries, including libraries that are installed as packages.
+Run <span class="stt">raco docs</span> to find documentation for libraries that are
+installed on your system and specific to your user account.</p><p><a href="https://pkgs.racket-lang.org/">PLT Package Catalog</a> at
+<a href="https://pkgs.racket-lang.org"><span class="url">https://pkgs.racket-lang.org</span></a> offers even more downloadable
+packages contributed by Racketeers. The
+<a href="https://docs.racket-lang.org">online Racket documentation</a>
+includes documentation for packages in that catalog, updated daily.
+For more information about packages, see see <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=pkg&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">Package Management in Racket</a>.</p><p><a href="https://planet.racket-lang.org/"><span class="planetName">PLaneT</span></a> serves packages that
+were developed using an older package system. Racket packages should
+use the newer system, instead.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="exe.html" title="backward to &quot;21.3 Creating Stand-Alone Executables&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="dialects.html" title="forward to &quot;23 Dialects of Racket and Scheme&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/Pairs__Lists__and_Racket_Syntax.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/Pairs__Lists__and_Racket_Syntax.html
new file mode 100644
index 00000000..cbd89e8d
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/Pairs__Lists__and_Racket_Syntax.html
@@ -0,0 +1,87 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>2.4&nbsp;Pairs, Lists, and Racket Syntax</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewselflink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">2.1&nbsp;</td><td><a href="Simple_Values.html" class="tocviewlink" data-pltdoc="x">Simple Values</a></td></tr><tr><td align="right">2.2&nbsp;</td><td><a href="syntax-overview.html" class="tocviewlink" data-pltdoc="x">Simple Definitions and Expressions</a></td></tr><tr><td align="right">2.3&nbsp;</td><td><a href="Lists__Iteration__and_Recursion.html" class="tocviewlink" data-pltdoc="x">Lists, Iteration, and Recursion</a></td></tr><tr><td align="right">2.4&nbsp;</td><td><a href="Pairs__Lists__and_Racket_Syntax.html" class="tocviewselflink" data-pltdoc="x">Pairs, Lists, and Racket Syntax</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>2.4&nbsp;</td><td><a href="Pairs__Lists__and_Racket_Syntax.html" class="tocviewselflink" data-pltdoc="x">Pairs, Lists, and Racket Syntax</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">2.4.1&nbsp;</td><td><a href="Pairs__Lists__and_Racket_Syntax.html#%28part._quoting-lists%29" class="tocviewlink" data-pltdoc="x">Quoting Pairs and Symbols with <span class="RktSym"><span class="RktStxLink">quote</span></span></a></td></tr><tr><td align="right">2.4.2&nbsp;</td><td><a href="Pairs__Lists__and_Racket_Syntax.html#%28part._.Abbreviating_quote_with__%29" class="tocviewlink" data-pltdoc="x">Abbreviating <span class="RktSym"><span class="RktStxLink">quote</span></span> with <span class="RktVal">'</span></a></td></tr><tr><td align="right">2.4.3&nbsp;</td><td><a href="Pairs__Lists__and_Racket_Syntax.html#%28part._lists-and-syntax%29" class="tocviewlink" data-pltdoc="x">Lists and Racket Syntax</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">2.4.1<tt>&nbsp;</tt></span><a href="Pairs__Lists__and_Racket_Syntax.html#%28part._quoting-lists%29" class="tocsubseclink" data-pltdoc="x">Quoting Pairs and Symbols with <span class="RktSym"><span class="RktStxLink">quote</span></span></a></td></tr><tr><td><span class="tocsublinknumber">2.4.2<tt>&nbsp;</tt></span><a href="Pairs__Lists__and_Racket_Syntax.html#%28part._.Abbreviating_quote_with__%29" class="tocsubseclink" data-pltdoc="x">Abbreviating <span class="RktSym"><span class="RktStxLink">quote</span></span> with <span class="RktVal">'</span></a></td></tr><tr><td><span class="tocsublinknumber">2.4.3<tt>&nbsp;</tt></span><a href="Pairs__Lists__and_Racket_Syntax.html#%28part._lists-and-syntax%29" class="tocsubseclink" data-pltdoc="x">Lists and Racket Syntax</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Lists__Iteration__and_Recursion.html" title="backward to &quot;2.3 Lists, Iteration, and Recursion&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="to-scheme.html" title="up to &quot;2 Racket Essentials&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="datatypes.html" title="forward to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Pairs__Lists__and_Racket_Syntax&quot;">2.4<tt>&nbsp;</tt><a name="(part._.Pairs__.Lists__and_.Racket_.Syntax)"></a>Pairs, Lists, and Racket Syntax</h4><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span> function actually accepts any two values, not just
+a list for the second argument. When the second argument is not
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty</a></span> and not itself produced by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span>, the result prints
+in a special way. The two values joined with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span> are printed
+between parentheses, but with a dot (i.e., a period surrounded by
+whitespace) in between:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 . 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="hspace">&nbsp;</span><span class="RktVal">"split"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("banana" . "split")</span></p></td></tr></table></blockquote><p>Thus, a value produced by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span> is not always a list. In
+general, the result of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span> is a <span style="font-style: italic">pair</span>. The more
+traditional name for the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._cons%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons?</a></span> function is <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._pair%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">pair?</a></span>,
+and we&rsquo;ll use the traditional name from now on.</p><p>The name <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._rest%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">rest</a></span> also makes less sense for non-list pairs; the
+more traditional names for <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._first%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">first</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._rest%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">rest</a></span> are
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span>, respectively. (Granted, the traditional
+names are also nonsense. Just remember that &ldquo;a&rdquo; comes before &ldquo;d,&rdquo;
+and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span> is pronounced &ldquo;could-er.&rdquo;)</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._pair%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._empty%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">empty</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._pair%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._pair%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p>Racket&rsquo;s pair datatype and its relation to lists is essentially a
+historical curiosity, along with the dot notation for printing and the
+funny names <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span>. Pairs are deeply wired into
+the culture, specification, and implementation of Racket, however,
+so they survive in the language.</p><p>You are perhaps most likely to encounter a non-list pair when making a
+mistake, such as accidentally reversing the arguments to
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((2 3) . 1)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3)</span></p></td></tr></table></blockquote><p>Non-list pairs are used intentionally, sometimes. For example, the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-hash%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-hash</a></span> function takes a list of pairs, where the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span> of each pair is a key and the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span> is an
+arbitrary value.</p><p>The only thing more confusing to new Racketeers than non-list pairs is
+the printing convention for pairs where the second element <span style="font-style: italic">is</span>
+a pair, but <span style="font-style: italic">is not</span> a list:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(0 1 . 2)</span></p></td></tr></table></blockquote><p>In general, the rule for printing a pair is as follows: use the dot
+notation unless the dot is immediately followed by an open
+parenthesis. In that case, remove the dot, the open parenthesis, and the
+matching close parenthesis. Thus, <span class="RktRes">'(0 . (1 . 2))</span>
+becomes <span class="RktRes">'(0<span class="stt"> </span>1<span class="stt"> </span>. 2)</span>, and
+<span class="RktRes">'(1 . (2 . (3 . ())))</span> becomes <span class="RktRes">'(1<span class="stt"> </span>2<span class="stt"> </span>3)</span>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;quoting-lists&quot;">2.4.1<tt>&nbsp;</tt><a name="(part._quoting-lists)"></a>Quoting Pairs and Symbols with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span></h5><p>A list prints with a quote mark before it, but if an element of a list
+is itself a list, then no quote mark is printed for the inner list:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((1) (2 3) (4))</span></p></td></tr></table></blockquote><p>For nested lists, especially, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span> form lets you write a
+list as an expression in essentially the same way that the list
+prints:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">"red"</span><span class="hspace">&nbsp;</span><span class="RktVal">"green"</span><span class="hspace">&nbsp;</span><span class="RktVal">"blue"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("red" "green" "blue")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((1) (2 3) (4))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span> form works with the dot notation, too, whether the
+quoted form is normalized by the dot-parenthesis elimination rule or
+not:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 . 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">.</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(0 1 . 2)</span></p></td></tr></table></blockquote><p>Naturally, lists of any kind can be nested:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((1 2 3) 5 ("a" "b" "c"))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((1 2 3) 5 ("a" "b" "c"))</span></p></td></tr></table></blockquote><p>If you wrap an identifier with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span>, then you get output
+that looks like an identifier, but with a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> prefix:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span><span class="hspace">&nbsp;</span><span class="RktSym">jane-doe</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'jane-doe</span></p></td></tr></table></blockquote><p>A value that prints like a quoted identifier is a <span style="font-style: italic">symbol</span>. In the
+same way that parenthesized output should not be confused with
+expressions, a printed symbol should not be confused with an
+identifier. In particular, the symbol <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span><span class="stt"> </span><span class="RktSym">map</span><span class="RktPn">)</span> has nothing to do with the <span class="RktSym">map</span>
+identifier or the predefined function that is bound to
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span>, except that the symbol and the identifier happen
+to be made up of the same letters.</p><p>Indeed, the intrinsic value of a symbol is nothing more than its
+character content. In this sense, symbols and strings are almost the
+same thing, and the main difference is how they print. The functions
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol-%7E3estring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">symbol-&gt;string</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-%7E3esymbol%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-&gt;symbol</a></span> convert between
+them.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span></td></tr><tr><td><p><span class="RktRes">#&lt;procedure:map&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span><span class="hspace">&nbsp;</span><span class="RktSym">map</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'map</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span><span class="hspace">&nbsp;</span><span class="RktSym">map</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._procedure%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">procedure?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-%7E3esymbol%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-&gt;symbol</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"map"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'map</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol-%7E3estring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">symbol-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span><span class="hspace">&nbsp;</span><span class="RktSym">map</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"map"</span></p></td></tr></table></blockquote></div></p><p>In the same way that <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span> for a list automatically applies
+itself to nested lists, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span> on a parenthesized sequence of
+identifiers automatically applies itself to the identifiers to create
+a list of symbols:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">road</span><span class="hspace">&nbsp;</span><span class="RktSym">map</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'road</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">road</span><span class="hspace">&nbsp;</span><span class="RktSym">map</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote><p>When a symbol is inside a list that is printed with
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span>, the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> on the symbol is omitted, since
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> is doing the job already:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">road</span><span class="hspace">&nbsp;</span><span class="RktSym">map</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(road map)</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span> form has no effect on a literal expression such as
+a number or string:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span><span class="hspace">&nbsp;</span><span class="RktVal">42</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">42</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"on the record"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"on the record"</span></p></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Abbreviating_quote_with__&quot;">2.4.2<tt>&nbsp;</tt><a name="(part._.Abbreviating_quote_with__)"></a>Abbreviating <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span> with <span class="RktVal">'</span></h5><p>As you may have guessed, you can abbreviate a use of
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span> by just putting <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> in front of a form to
+quote:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">'</span><span class="RktVal">road</span></td></tr><tr><td><p><span class="RktRes">'road</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">road</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="RktVal">)</span><span class="RktVal">)</span></td></tr><tr><td><p><span class="RktRes">'((1 2 3) road ("a" "b" "c"))</span></p></td></tr></table></blockquote><p>In the documentation, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> within an expression is printed in green along with the
+form after it, since the combination is an expression that is a
+constant. In DrRacket, only the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> is colored green. DrRacket
+is more precisely correct, because the meaning of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span> can
+vary depending on the context of an expression. In the documentation,
+however, we routinely assume that standard bindings are in scope, and
+so we paint quoted forms in green for extra clarity.</p><p>A <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> expands to a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span> form in quite a literal
+way. You can see this if you put a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> in front of a form that has a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">road</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'quote</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">quote</span><span class="hspace">&nbsp;</span><span class="RktVal">road</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'quote</span></p></td></tr></table></blockquote><p>The <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> abbreviation works in output as well as input. The
+<a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>&rsquo;s printer recognizes the symbol <span class="RktVal">'</span><span class="RktVal">quote</span> as the
+first element of a two-element list when printing output, in which
+case it uses <span class="RktSym">&rsquo;</span> to print the output:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">quote</span><span class="hspace">&nbsp;</span><span class="RktVal">road</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">''road</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">quote</span><span class="hspace">&nbsp;</span><span class="RktVal">road</span><span class="RktVal">)</span></td></tr><tr><td><p><span class="RktRes">''road</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">road</span></td></tr><tr><td><p><span class="RktRes">''road</span></p></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;lists-and-syntax&quot;">2.4.3<tt>&nbsp;</tt><a name="(part._lists-and-syntax)"></a>Lists and Racket Syntax</h5><p>Now that you know the truth about pairs and lists, and now that you&rsquo;ve
+seen <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span>, you&rsquo;re ready to understand the main way in which
+we have been simplifying Racket&rsquo;s true syntax.</p><p>The syntax of Racket is not defined directly in terms of character
+streams. Instead, the syntax is determined by two layers:</p><ul><li><p>a <a name="(tech._reader)"></a><span style="font-style: italic">reader</span> layer, which turns a sequence of characters
+into lists, symbols, and other constants; and</p></li><li><p>an <a name="(tech._expander)"></a><span style="font-style: italic">expander</span> layer, which processes the lists, symbols,
+and other constants to parse them as an expression.</p></li></ul><p>The rules for printing and reading go together. For example, a list is
+printed with parentheses, and reading a pair of parentheses produces a
+list. Similarly, a non-list pair is printed with the dot notation, and
+a dot on input effectively runs the dot-notation rules in reverse to
+obtain a pair.</p><p>One consequence of the read layer for expressions is that you can use
+the dot notation in expressions that are not quoted forms:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktPn">(</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></blockquote><p>This works because <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktPn">. </span><span class="RktPn">(</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span> is just another
+way of writing <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span>. It is practically never a good idea
+to write application expressions using this dot notation; it&rsquo;s just a
+consequence of the way Racket&rsquo;s syntax is defined.</p><p>Normally, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> is allowed by the reader only with a
+parenthesized sequence, and only before the last element of the
+sequence. However, a pair of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>s can also appear around a
+single element in a parenthesized sequence, as long as the element is
+not first or last. Such a pair triggers a reader conversion that moves
+the element between <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>s to the front of the list. The
+conversion enables a kind of general infix notation:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3c%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&lt;</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="RktVal">. </span>&lt;<span class="RktVal"> .</span></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span></td></tr><tr><td><p><span class="RktRes">'(&lt; 1 2)</span></p></td></tr></table></blockquote><p>This two-dot convention is non-traditional, and it has essentially
+nothing to do with the dot notation for non-list pairs. Racket
+programmers use the infix convention sparingly&#8212;<wbr></wbr>mostly for asymmetric
+binary operators such as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3c%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&lt;</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objectutils.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._is-a%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">is-a?</a></span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Lists__Iteration__and_Recursion.html" title="backward to &quot;2.3 Lists, Iteration, and Recursion&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="to-scheme.html" title="up to &quot;2 Racket Essentials&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="datatypes.html" title="forward to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/Signatures_and_Units.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/Signatures_and_Units.html
new file mode 100644
index 00000000..1d197fc6
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/Signatures_and_Units.html
@@ -0,0 +1,17 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14.1&nbsp;Signatures and Units</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Signatures_and_Units.html" class="tocviewselflink" data-pltdoc="x">Signatures and Units</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="Invoking_Units.html" class="tocviewlink" data-pltdoc="x">Invoking Units</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="Linking_Units.html" class="tocviewlink" data-pltdoc="x">Linking Units</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="firstclassunits.html" class="tocviewlink" data-pltdoc="x">First-<wbr></wbr>Class Units</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="Whole-module_Signatures_and_Units.html" class="tocviewlink" data-pltdoc="x">Whole-<span class="RktSym"><span class="RktStxLink">module</span></span> Signatures and Units</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="Contracts_for_Units.html" class="tocviewlink" data-pltdoc="x">Contracts for Units</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="unit_versus_module.html" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unit</span></span> versus <span class="RktSym"><span class="RktStxLink">module</span></span></a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="units.html" title="backward to &quot;14 Units (Components)&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="units.html" title="up to &quot;14 Units (Components)&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Invoking_Units.html" title="forward to &quot;14.2 Invoking Units&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Signatures_and_Units&quot;">14.1<tt>&nbsp;</tt><a name="(part._.Signatures_and_.Units)"></a>Signatures and Units</h4><p>The interface of a unit is described in terms of
+<a name="(tech._signature)"></a><span style="font-style: italic">signatures</span>. Each signature is defined (normally within a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span>) using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-signature%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-signature</a></span>.  For example, the
+following signature, placed in a <span class="stt">"toy-factory-sig.rkt"</span> file,
+describes the exports of a component that implements a toy factory:</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>By convention, signature names end with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span>.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"toy-factory-sig.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-signature%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-signature</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-factory^</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">build-toys</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"><span class="stt">(integer? -&gt; (listof toy?))</span></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">repaint</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"><span class="stt">(toy? symbol? -&gt; toy?)</span></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">toy?</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"><span class="stt">(any/c -&gt; boolean?)</span></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">toy-color</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"><span class="stt">(toy? -&gt; symbol?)</span></span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-factory^</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>An implementation of the <span class="RktSym">toy-factory^</span> signature is written
+using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linkinference.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-unit</a></span> with an <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._export%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">export</a></span> clause that names
+<span class="RktSym">toy-factory^</span>:</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>By convention, unit names end with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">@</span><span class="hspace"></span></span>.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"simple-factory-unit.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"toy-factory-sig.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linkinference.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-unit</a></span><span class="hspace">&nbsp;</span><span class="RktSym">simple-factory@</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._import%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">import</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._export%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-factory^</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Factory started.\n"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">build-toys</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">toy</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">blue</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">repaint</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">toy</span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">simple-factory@</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>The <span class="RktSym">toy-factory^</span> signature also could be referenced by a unit
+that needs a toy factory to implement something else. In that case,
+<span class="RktSym">toy-factory^</span> would be named in an <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._import%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">import</a></span> clause.
+For example, a toy store would get toys from a toy factory. (Suppose,
+for the sake of an example with interesting features, that the store
+is willing to sell only toys in a particular color.)</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"toy-store-sig.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-signature%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-signature</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-store^</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">store-color</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"><span class="stt">(-&gt; symbol?)</span></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">stock!</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"><span class="stt">(integer? -&gt; void?)</span></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">get-inventory</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"><span class="stt">(-&gt; (listof toy?))</span></span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-store^</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"toy-store-unit.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"toy-store-sig.rkt"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"toy-factory-sig.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linkinference.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-unit</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-store@</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._import%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">import</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-factory^</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._export%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-store^</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">inventory</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">store-color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">green</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">maybe-repaint</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">toy-color</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">store-color</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">repaint</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">store-color</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stock!</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">inventory</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">inventory</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym">maybe-repaint</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">build-toys</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-inventory</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">inventory</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-store@</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>Note that <span class="stt">"toy-store-unit.rkt"</span> imports
+<span class="stt">"toy-factory-sig.rkt"</span>, but not
+<span class="stt">"simple-factory-unit.rkt"</span>.  Consequently, the
+<span class="RktSym">toy-store@</span> unit relies only on the specification of a toy
+factory, not on a specific implementation.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="units.html" title="backward to &quot;14 Units (Components)&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="units.html" title="up to &quot;14 Units (Components)&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Invoking_Units.html" title="forward to &quot;14.2 Invoking Units&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/Simple_Values.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/Simple_Values.html
new file mode 100644
index 00000000..f781ff95
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/Simple_Values.html
@@ -0,0 +1,15 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>2.1&nbsp;Simple Values</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewselflink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">2.1&nbsp;</td><td><a href="Simple_Values.html" class="tocviewselflink" data-pltdoc="x">Simple Values</a></td></tr><tr><td align="right">2.2&nbsp;</td><td><a href="syntax-overview.html" class="tocviewlink" data-pltdoc="x">Simple Definitions and Expressions</a></td></tr><tr><td align="right">2.3&nbsp;</td><td><a href="Lists__Iteration__and_Recursion.html" class="tocviewlink" data-pltdoc="x">Lists, Iteration, and Recursion</a></td></tr><tr><td align="right">2.4&nbsp;</td><td><a href="Pairs__Lists__and_Racket_Syntax.html" class="tocviewlink" data-pltdoc="x">Pairs, Lists, and Racket Syntax</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="to-scheme.html" title="backward to &quot;2 Racket Essentials&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="to-scheme.html" title="up to &quot;2 Racket Essentials&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="syntax-overview.html" title="forward to &quot;2.2 Simple Definitions and Expressions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Simple_Values&quot;">2.1<tt>&nbsp;</tt><a name="(part._.Simple_.Values)"></a>Simple Values</h4><p>Racket values include numbers, booleans, strings, and byte strings. In
+DrRacket and documentation examples (when you read the documentation
+in color), value expressions are shown in green.</p><p><span style="font-style: italic">Numbers</span> are written in the usual way, including fractions
+and imaginary numbers:</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="numbers.html" data-pltdoc="x">Numbers</a> (later in this guide) explains more about numbers.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktVal">1</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">3.14</span></td></tr><tr><td><span class="RktVal">1/2</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">6.02e+23</span></td></tr><tr><td><span class="RktVal">1+2i</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">9999999999999999999999</span></td></tr></table></blockquote><p><span style="font-style: italic">Booleans</span> are <span class="RktVal">#t</span> for true and <span class="RktVal">#f</span> for
+false. In conditionals, however, all non-<span class="RktVal">#f</span> values are
+treated as true.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="booleans.html" data-pltdoc="x">Booleans</a> (later in this guide) explains more about booleans.</p></blockquote></blockquote></blockquote><p><span style="font-style: italic">Strings</span> are written between doublequotes. Within a string,
+backslash is an escaping character; for example, a backslash followed
+by a doublequote includes a literal doublequote in the string. Except
+for an unescaped doublequote or backslash, any Unicode character can
+appear in a string constant.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="strings.html" data-pltdoc="x">Strings (Unicode)</a> (later in this guide) explains more about strings.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktVal">"Hello, world!"</span></td></tr><tr><td><span class="RktVal">"Benjamin \"Bugsy\" Siegel"</span></td></tr><tr><td><span class="RktVal">"&#955;x:(&#956;&#945;.&#945;&#8594;&#945;).xx"</span></td></tr></table></blockquote><p>When a constant is evaluated in the <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>, it typically prints the same
+as its input syntax. In some cases, the printed form is a normalized
+version of the input syntax. In documentation and in DrRacket&rsquo;s <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>,
+results are printed in blue instead of green to highlight the
+difference between an input expression and a printed result.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktVal">1.0000</span></td></tr><tr><td><p><span class="RktRes">1.0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">"Bugs \u0022Figaro\u0022 Bunny"</span></td></tr><tr><td><p><span class="RktRes">"Bugs \"Figaro\" Bunny"</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="to-scheme.html" title="backward to &quot;2 Racket Essentials&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="to-scheme.html" title="up to &quot;2 Racket Essentials&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="syntax-overview.html" title="forward to &quot;2.2 Simple Definitions and Expressions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/Sublime_Text.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/Sublime_Text.html
new file mode 100644
index 00000000..3f36bf30
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/Sublime_Text.html
@@ -0,0 +1,3 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>24.4&nbsp;Sublime Text</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewselflink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">24.1&nbsp;</td><td><a href="cmdline-tools.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools</a></td></tr><tr><td align="right">24.2&nbsp;</td><td><a href="Emacs.html" class="tocviewlink" data-pltdoc="x">Emacs</a></td></tr><tr><td align="right">24.3&nbsp;</td><td><a href="Vim.html" class="tocviewlink" data-pltdoc="x">Vim</a></td></tr><tr><td align="right">24.4&nbsp;</td><td><a href="Sublime_Text.html" class="tocviewselflink" data-pltdoc="x">Sublime Text</a></td></tr><tr><td align="right">24.5&nbsp;</td><td><a href="Visual_Studio_Code.html" class="tocviewlink" data-pltdoc="x">Visual Studio Code</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Vim.html" title="backward to &quot;24.3 Vim&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="other-editors.html" title="up to &quot;24 Command-Line Tools and Your Editor of Choice&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Visual_Studio_Code.html" title="forward to &quot;24.5 Visual Studio Code&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Sublime_Text&quot;">24.4<tt>&nbsp;</tt><a name="(part._.Sublime_.Text)"></a>Sublime Text</h4><p>The <a href="https://sublime.wbond.net/packages/Racket">Racket package</a>
+provides support for syntax highlighting and building for Sublime Text.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Vim.html" title="backward to &quot;24.3 Vim&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="other-editors.html" title="up to &quot;24 Command-Line Tools and Your Editor of Choice&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Visual_Studio_Code.html" title="forward to &quot;24.5 Visual Studio Code&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/Vim.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/Vim.html
new file mode 100644
index 00000000..a900a8fd
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/Vim.html
@@ -0,0 +1,55 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>24.3&nbsp;Vim</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewselflink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">24.1&nbsp;</td><td><a href="cmdline-tools.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools</a></td></tr><tr><td align="right">24.2&nbsp;</td><td><a href="Emacs.html" class="tocviewlink" data-pltdoc="x">Emacs</a></td></tr><tr><td align="right">24.3&nbsp;</td><td><a href="Vim.html" class="tocviewselflink" data-pltdoc="x">Vim</a></td></tr><tr><td align="right">24.4&nbsp;</td><td><a href="Sublime_Text.html" class="tocviewlink" data-pltdoc="x">Sublime Text</a></td></tr><tr><td align="right">24.5&nbsp;</td><td><a href="Visual_Studio_Code.html" class="tocviewlink" data-pltdoc="x">Visual Studio Code</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>24.3&nbsp;</td><td><a href="Vim.html" class="tocviewselflink" data-pltdoc="x">Vim</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">24.3.1&nbsp;</td><td><a href="Vim.html#%28part._vim-plugins%29" class="tocviewlink" data-pltdoc="x">Plugins</a></td></tr><tr><td align="right">24.3.2&nbsp;</td><td><a href="Vim.html#%28part._.Indentation%29" class="tocviewlink" data-pltdoc="x">Indentation</a></td></tr><tr><td align="right">24.3.3&nbsp;</td><td><a href="Vim.html#%28part._.Highlighting%29" class="tocviewlink" data-pltdoc="x">Highlighting</a></td></tr><tr><td align="right">24.3.4&nbsp;</td><td><a href="Vim.html#%28part._.Structured_.Editing%29" class="tocviewlink" data-pltdoc="x">Structured Editing</a></td></tr><tr><td align="right">24.3.5&nbsp;</td><td><a href="Vim.html#%28part._.R.E.P.Ls%29" class="tocviewlink" data-pltdoc="x">REPLs</a></td></tr><tr><td align="right">24.3.6&nbsp;</td><td><a href="Vim.html#%28part._.Scribble%29" class="tocviewlink" data-pltdoc="x">Scribble</a></td></tr><tr><td align="right">24.3.7&nbsp;</td><td><a href="Vim.html#%28part._.Miscellaneous%29" class="tocviewlink" data-pltdoc="x">Miscellaneous</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">24.3.1<tt>&nbsp;</tt></span><a href="Vim.html#%28part._vim-plugins%29" class="tocsubseclink" data-pltdoc="x">Plugins</a></td></tr><tr><td><span class="tocsublinknumber">24.3.2<tt>&nbsp;</tt></span><a href="Vim.html#%28part._.Indentation%29" class="tocsubseclink" data-pltdoc="x">Indentation</a></td></tr><tr><td><span class="tocsublinknumber">24.3.3<tt>&nbsp;</tt></span><a href="Vim.html#%28part._.Highlighting%29" class="tocsubseclink" data-pltdoc="x">Highlighting</a></td></tr><tr><td><span class="tocsublinknumber">24.3.4<tt>&nbsp;</tt></span><a href="Vim.html#%28part._.Structured_.Editing%29" class="tocsubseclink" data-pltdoc="x">Structured Editing</a></td></tr><tr><td><span class="tocsublinknumber">24.3.5<tt>&nbsp;</tt></span><a href="Vim.html#%28part._.R.E.P.Ls%29" class="tocsubseclink" data-pltdoc="x">REPLs</a></td></tr><tr><td><span class="tocsublinknumber">24.3.6<tt>&nbsp;</tt></span><a href="Vim.html#%28part._.Scribble%29" class="tocsubseclink" data-pltdoc="x">Scribble</a></td></tr><tr><td><span class="tocsublinknumber">24.3.7<tt>&nbsp;</tt></span><a href="Vim.html#%28part._.Miscellaneous%29" class="tocsubseclink" data-pltdoc="x">Miscellaneous</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Emacs.html" title="backward to &quot;24.2 Emacs&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="other-editors.html" title="up to &quot;24 Command-Line Tools and Your Editor of Choice&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Sublime_Text.html" title="forward to &quot;24.4 Sublime Text&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Vim&quot;">24.3<tt>&nbsp;</tt><a name="(part._.Vim)"></a>Vim</h4><p>Many distributions of Vim ship with support for Scheme, which will mostly work
+for Racket. As of <a href="https://github.com/vim/vim/commit/1aeaf8c0e0421f34e51ef674f0c9a182debe77ae">version 7.3.518</a>,
+Vim detects files with the extension <span class="stt">.rkt</span> as having the
+<span class="stt">scheme</span> filetype. <a href="https://github.com/vim/vim/commit/9cd91a1e8816d727fbdbf0b3062288e15abc5f4d">Version 8.2.3368</a>
+added support for <span class="stt">.rktd</span> and <span class="stt">.rktl</span>.</p><p>In older versions, you can enable filetype detection of Racket
+files as Scheme with the following:</p><p><table cellspacing="0" cellpadding="0" class="SVerbatim"><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">if has("autocmd")</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt"></span><span class="hspace">&nbsp;&nbsp;</span><span class="stt">autocmd filetypedetect BufReadPost *.rkt,*.rktl,*.rktd set filetype=scheme</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">endif</span></p></td></tr></table></p><p>If your Vim supports the ftdetect system, in which case it&rsquo;s likely new enough
+to support Racket already, you can nevertheless put the following in
+<span class="stt">"~/.vim/ftdetect/racket.vim"</span>
+(<span class="stt">"$HOME/vimfiles/ftdetect/racket.vim"</span> on MS-Windows; see <span class="stt">:help runtimepath</span>).</p><p><table cellspacing="0" cellpadding="0" class="SVerbatim"><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">" :help ftdetect</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">" If you want to change the filetype only if one has not been set</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">autocmd BufRead,BufNewFile *.rkt,*.rktl,*.rktd setfiletype scheme</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">" If you always want to set this filetype</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">autocmd BufRead,BufNewFile *.rkt,*.rktl,*.rktd set filetype=scheme</span></p></td></tr></table></p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;vim-plugins&quot;">24.3.1<tt>&nbsp;</tt><a name="(part._vim-plugins)"></a>Plugins</h5><p><div class="SIntrapara">Alternatively, you can use a plugin such as </div><div class="SIntrapara"><ul><li><p><a href="https://github.com/wlangstroth/vim-racket">wlangstroth/vim-racket</a></p></li><li><p><a href="https://github.com/benknoble/vim-racket">benknoble/vim-racket</a></p></li></ul></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The major difference between the two is that the
+<span class="stt">benknoble/vim-racket</span> fork supports more features out of the box and is
+updated more frequently.</p></blockquote></blockquote></blockquote></div><div class="SIntrapara">to enable auto-detection, indentation, and syntax highlighting specifically for
+Racket files.</div></p><p><div class="SIntrapara">These plugins work by setting the <span class="stt">filetype</span> option based on the <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a>
+line. For example:</div><div class="SIntrapara"><ul><li><p>A file starting with <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a><span class="RktMeta"></span> or <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a><span class="RktMeta"></span>
+has <span class="stt">filetype</span> equal to <span class="stt">racket</span>.</p></li><li><p>A file starting with <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=scribble&amp;rel=base.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">scribble/base</span></a><span class="RktMeta"></span> or <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=scribble&amp;rel=manual.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">scribble/manual</span></a><span class="RktMeta"></span>
+has <span class="stt">filetype</span> equal to <span class="stt">scribble</span>.</p></li></ul></div><div class="SIntrapara">Depending on which plugin you have, modifiers like <span class="RktSym">at-exp</span><span class="RktMeta"></span> may also be
+ignored, so that <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=scribble&amp;rel=reader-internals.html%23%2528mod-path._at-exp%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">at-exp</span></a><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">racket</span><span class="RktMeta"></span> is still a <span class="stt">filetype</span> of
+<span class="stt">racket</span>.</div></p><p>This approach is more flexible but may lead to more work. Since each
+<a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> has its own <span class="stt">filetype</span>, options, syntax highlighting, and other
+features need to be configured for each filetype. This can be done via the
+standard <span class="stt">ftplugin</span> mechanism. See for example <span class="stt">:help ftplugin-overrule</span>
+and <span class="stt">:help ftplugin</span>: place your options for <span class="stt">&lt;lang&gt;</span> in
+<span class="stt">"~/.vim/after/ftplugin/&lt;lang&gt;.vim"</span>
+(<span class="stt">"$HOME/vimfiles/after/ftplugin/&lt;lang&gt;.vim"</span> on MS-Windows). Similarly,
+syntax files follow the standard mechanism documented in <span class="stt">:help syntax</span>.</p><p>Both plugins come with configuration for Racket
+(and possibly other <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a>s) as <span class="stt">ftplugin</span>s. To enable them, use the
+<span class="stt">:filetype</span> command as documented in <span class="stt">:help :filetype</span>. You likely want to
+turn on filetype plugins (<span class="stt">:help :filetype-plugin-on</span>) and filetype indent
+plugins (<span class="stt">:help :filetype-indent-on</span>).</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Indentation&quot;">24.3.2<tt>&nbsp;</tt><a name="(part._.Indentation)"></a>Indentation</h5><p>You can enable indentation for Racket by setting both the <span class="stt">lisp</span> and
+<span class="stt">autoindent</span> options in Vim. You will want to customize the buffer-local
+<span class="stt">lispwords</span> option to control how special forms are indented. See <span class="stt">:help</span><span class="stt">
+</span><span class="stt"></span><span class="stt">&rsquo;</span><span class="stt">lispwords</span><span class="stt">&rsquo;</span><span class="stt"></span>. Both plugins mentioned in <a href="Vim.html#%28part._vim-plugins%29" data-pltdoc="x">Plugins</a> set this option for
+you.</p><p>However, the indentation can be limited and may not be as complete as what you
+can get in Emacs. You can also use Dorai Sitaram&rsquo;s
+<a href="https://github.com/ds26gte/scmindent">scmindent</a> for better
+indentation of Racket code. The instructions on how to use the indenter are
+available on the website.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Highlighting&quot;">24.3.3<tt>&nbsp;</tt><a name="(part._.Highlighting)"></a>Highlighting</h5><p>The <a href="https://www.vim.org/scripts/script.php?script_id=1230">Rainbow
+Parenthesis</a> script for Vim can be useful for more visible parenthesis
+matching. Syntax highlighting for Scheme is shipped with Vim on many platforms,
+which will work for the most part with Racket. The vim-racket script
+provides good default highlighting settings for you.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Structured_Editing&quot;">24.3.4<tt>&nbsp;</tt><a name="(part._.Structured_.Editing)"></a>Structured Editing</h5><p>The <a href="https://www.vim.org/scripts/script.php?script_id=2531">Slimv</a>
+plugin has a paredit mode that works like paredit in Emacs. However, the plugin
+is not aware of Racket. You can either set Vim to treat Racket as Scheme files
+or you can modify the paredit script to load on <span class="stt">".rkt"</span> files.</p><p><div class="SIntrapara">For a more Vim-like set of key-mappings, pair either of </div><div class="SIntrapara"><ul><li><p><a href="https://github.com/guns/vim-sexp">guns/vim-sexp</a></p></li><li><p><a href="https://github.com/benknoble/vim-sexp">benknoble/vim-sexp</a></p></li></ul></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The <span class="stt">benknoble/vim-sexp</span> fork is slightly more modern vimscript.</p></blockquote></blockquote></blockquote></div><div class="SIntrapara">with <a href="https://github.com/tpope/vim-sexp-mappings-for-regular-people">tpope/vim-sexp-mappings-for-regular-people</a>.
+The experience is on par with paredit, but more comfortable for the fingers.</div></p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;REPLs&quot;">24.3.5<tt>&nbsp;</tt><a name="(part._.R.E.P.Ls)"></a>REPLs</h5><p><div class="SIntrapara">There are many general-purpose Vim + REPL plugins out there. Here are a few that
+support Racket out of the box: </div><div class="SIntrapara"><ul><li><p><a href="https://github.com/rhysd/reply.vim">rhysd/reply.vim</a></p></li><li><p><a href="https://github.com/kovisoft/slimv">kovisoft/slimv</a>, if you are using the <span class="stt">scheme</span> filetype</p></li><li><p><a href="https://github.com/benknoble/vim-simpl">benknoble/vim-simpl</a></p></li></ul></div></p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Scribble&quot;">24.3.6<tt>&nbsp;</tt><a name="(part._.Scribble)"></a>Scribble</h5><p><div class="SIntrapara">Vim support for writing scribble documents is provided by </div><div class="SIntrapara"><ul><li><p><a href="https://github.com/wilbowma/scribble.vim">wilbowma/scribble.vim</a></p></li><li><p><a href="https://github.com/benknoble/scribble.vim">benknoble/scribble.vim</a></p></li></ul></div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Again, <span class="stt">benknoble/scribble.vim</span> is updated more frequently and
+is somewhat more modern.</p></blockquote></blockquote></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Miscellaneous&quot;">24.3.7<tt>&nbsp;</tt><a name="(part._.Miscellaneous)"></a>Miscellaneous</h5><p>If you are installing many Vim plugins (not necessary specific to Racket), we
+recommend using a plugin that will make loading other plugins easier. There are
+many plugin managers.</p><p><a href="https://github.com/tpope/vim-pathogen">Pathogen</a> is one plugin that
+does this; using it, you can install new plugins by extracting them to
+subdirectories in the <span class="stt">"bundle"</span> folder of your personal Vim files
+(<span class="stt">"~/.vim"</span> on Unix, <span class="stt">"$HOME/vimfiles"</span> on MS-Windows).</p><p>With newer Vim versions, you can use the package system (<span class="stt">:help packages</span>).</p><p>One relatively up-to-date reference on the various managers is
+<a href="https://vi.stackexchange.com/q/388/10604">What are the differences between the vim plugin managers?</a>.
+The same site, <a href="https://vi.stackexchange.com">Vi &amp; Vim</a> is a great
+place to get help from Vimmers.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Emacs.html" title="backward to &quot;24.2 Emacs&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="other-editors.html" title="up to &quot;24 Command-Line Tools and Your Editor of Choice&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Sublime_Text.html" title="forward to &quot;24.4 Sublime Text&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/Visual_Studio_Code.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/Visual_Studio_Code.html
new file mode 100644
index 00000000..0a4fe84a
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/Visual_Studio_Code.html
@@ -0,0 +1,3 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>24.5&nbsp;Visual Studio Code</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewselflink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">24.1&nbsp;</td><td><a href="cmdline-tools.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools</a></td></tr><tr><td align="right">24.2&nbsp;</td><td><a href="Emacs.html" class="tocviewlink" data-pltdoc="x">Emacs</a></td></tr><tr><td align="right">24.3&nbsp;</td><td><a href="Vim.html" class="tocviewlink" data-pltdoc="x">Vim</a></td></tr><tr><td align="right">24.4&nbsp;</td><td><a href="Sublime_Text.html" class="tocviewlink" data-pltdoc="x">Sublime Text</a></td></tr><tr><td align="right">24.5&nbsp;</td><td><a href="Visual_Studio_Code.html" class="tocviewselflink" data-pltdoc="x">Visual Studio Code</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Sublime_Text.html" title="backward to &quot;24.4 Sublime Text&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="other-editors.html" title="up to &quot;24 Command-Line Tools and Your Editor of Choice&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="doc-bibliography.html" title="forward to &quot;Bibliography&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Visual_Studio_Code&quot;">24.5<tt>&nbsp;</tt><a name="(part._.Visual_.Studio_.Code)"></a>Visual Studio Code</h4><p>The <a href="https://marketplace.visualstudio.com/items?itemName=evzen-wybitul.magic-racket">Magic Racket</a>
+extension provides Racket support including REPL integration and syntax highlighting in Visual Studio Code.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Sublime_Text.html" title="backward to &quot;24.4 Sublime Text&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="other-editors.html" title="up to &quot;24 Command-Line Tools and Your Editor of Choice&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="doc-bibliography.html" title="forward to &quot;Bibliography&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/Whole-module_Signatures_and_Units.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/Whole-module_Signatures_and_Units.html
new file mode 100644
index 00000000..9618a2cd
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/Whole-module_Signatures_and_Units.html
@@ -0,0 +1,10 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14.5&nbsp;Whole-module Signatures and Units</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Signatures_and_Units.html" class="tocviewlink" data-pltdoc="x">Signatures and Units</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="Invoking_Units.html" class="tocviewlink" data-pltdoc="x">Invoking Units</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="Linking_Units.html" class="tocviewlink" data-pltdoc="x">Linking Units</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="firstclassunits.html" class="tocviewlink" data-pltdoc="x">First-<wbr></wbr>Class Units</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="Whole-module_Signatures_and_Units.html" class="tocviewselflink" data-pltdoc="x">Whole-<span class="RktSym"><span class="RktStxLink">module</span></span> Signatures and Units</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="Contracts_for_Units.html" class="tocviewlink" data-pltdoc="x">Contracts for Units</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="unit_versus_module.html" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unit</span></span> versus <span class="RktSym"><span class="RktStxLink">module</span></span></a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="firstclassunits.html" title="backward to &quot;14.4 First-Class Units&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="units.html" title="up to &quot;14 Units (Components)&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Contracts_for_Units.html" title="forward to &quot;14.6 Contracts for Units&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Whole-module_Signatures_and_Units&quot;">14.5<tt>&nbsp;</tt><a name="(part._.Whole-module_.Signatures_and_.Units)"></a>Whole-<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> Signatures and Units</h4><p>In programs that use units, modules like <span class="stt">"toy-factory-sig.rkt"</span>
+and <span class="stt">"simple-factory-unit.rkt"</span> are common. The
+<span class="RktSym">racket/signature</span> and <span class="RktSym">racket/unit</span> module names can be
+used as languages to avoid much of the boilerplate module, signature,
+and unit declaration text.</p><p>For example, <span class="stt">"toy-factory-sig.rkt"</span> can be written as</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Single-Signature_Modules.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/signature</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktSym">build-toys</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"><span class="stt">(integer? -&gt; (listof toy?))</span></span></td></tr><tr><td><span class="RktSym">repaint</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"><span class="stt">(toy? symbol? -&gt; toy?)</span></span></td></tr><tr><td><span class="RktSym">toy?</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"><span class="stt">(any/c -&gt; boolean?)</span></span></td></tr><tr><td><span class="RktSym">toy-color</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"><span class="stt">(toy? -&gt; symbol?)</span></span></td></tr></table></blockquote><p>The signature <span class="RktSym">toy-factory^</span> is automatically provided from the
+module, inferred from the filename <span class="stt">"toy-factory-sig.rkt"</span> by
+replacing the <span class="stt">"-sig.rkt"</span> suffix with <span class="RktSym">^</span>.</p><p>Similarly, <span class="stt">"simple-factory-unit.rkt"</span> module can be written</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=mzlib_unit.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/unit</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"toy-factory-sig.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._import%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">import</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._export%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-factory^</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Factory started.\n"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">build-toys</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">toy</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">blue</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">repaint</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">toy</span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The unit <span class="RktSym">simple-factory@</span> is automatically provided from the
+module, inferred from the filename <span class="stt">"simple-factory-unit.rkt"</span> by
+replacing the <span class="stt">"-unit.rkt"</span> suffix with <span class="RktSym">@</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="firstclassunits.html" title="backward to &quot;14.4 First-Class Units&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="units.html" title="up to &quot;14 Units (Components)&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Contracts_for_Units.html" title="forward to &quot;14.6 Contracts for Units&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/application.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/application.html
new file mode 100644
index 00000000..e1aa9665
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/application.html
@@ -0,0 +1,41 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.3&nbsp;Function Calls</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewselflink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="syntax-notation.html" class="tocviewlink" data-pltdoc="x">Notation</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="binding.html" class="tocviewlink" data-pltdoc="x">Identifiers and Binding</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="application.html" class="tocviewselflink" data-pltdoc="x">Function Calls</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Functions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span></a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span></a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="conditionals.html" class="tocviewlink" data-pltdoc="x">Conditionals</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span></a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktVal">&rsquo;</span></a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="qq.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span> and <span class="RktVal">&lsquo;</span></a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Simple Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="parameterize.html" class="tocviewlink" data-pltdoc="x">Dynamic Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">parameterize</span></span></a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.3&nbsp;</td><td><a href="application.html" class="tocviewselflink" data-pltdoc="x">Function Calls</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.3.1&nbsp;</td><td><a href="application.html#%28part._.Evaluation_.Order_and_.Arity%29" class="tocviewlink" data-pltdoc="x">Evaluation Order and Arity</a></td></tr><tr><td align="right">4.3.2&nbsp;</td><td><a href="application.html#%28part._keyword-args%29" class="tocviewlink" data-pltdoc="x">Keyword Arguments</a></td></tr><tr><td align="right">4.3.3&nbsp;</td><td><a href="application.html#%28part._apply%29" class="tocviewlink" data-pltdoc="x">The <span class="RktSym"><span class="RktValLink">apply</span></span> Function</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">4.3.1<tt>&nbsp;</tt></span><a href="application.html#%28part._.Evaluation_.Order_and_.Arity%29" class="tocsubseclink" data-pltdoc="x">Evaluation Order and Arity</a></td></tr><tr><td><span class="tocsublinknumber">4.3.2<tt>&nbsp;</tt></span><a href="application.html#%28part._keyword-args%29" class="tocsubseclink" data-pltdoc="x">Keyword Arguments</a></td></tr><tr><td><span class="tocsublinknumber">4.3.3<tt>&nbsp;</tt></span><a href="application.html#%28part._apply%29" class="tocsubseclink" data-pltdoc="x">The <span class="RktSym"><span class="RktValLink">apply</span></span> Function</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="binding.html" title="backward to &quot;4.2 Identifiers and Binding&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="lambda.html" title="forward to &quot;4.4 Functions (Procedures): lambda&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;application&quot;">4.3<tt>&nbsp;</tt><a name="(part._application)"></a>Function Calls (Procedure Applications)</h4><p>An expression of the form</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktVar">proc-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">arg-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>is a function call&#8212;<wbr></wbr>also known as a <span style="font-style: italic">procedure
+application</span>&#8212;<wbr></wbr>when <span class="RktVar">proc-expr</span> is not an identifier that is
+bound as a syntax transformer (such as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span> or
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span>).</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Evaluation_Order_and_Arity&quot;">4.3.1<tt>&nbsp;</tt><a name="(part._.Evaluation_.Order_and_.Arity)"></a>Evaluation Order and Arity</h5><p>A function call is evaluated by first evaluating the
+<span class="RktVar">proc-expr</span> and all <span class="RktVar">arg-expr</span>s in order (left to
+right). Then, if <span class="RktVar">proc-expr</span> produces a function that accepts
+as many arguments as supplied <span class="RktVar">arg-expr</span>s, the function is
+called. Otherwise, an exception is raised.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">6</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">cons: arity mismatch;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">the expected number of arguments does not match the given</span></p></td></tr><tr><td><p><span class="RktErr">number</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: 2</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">application: not a procedure;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">expected a procedure that can be applied to arguments</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 1</span></p></td></tr></table></blockquote></div></p><p>Some functions, such as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span>, accept a fixed number of
+arguments. Some functions, such as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span> or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span>, accept
+any number of arguments. Some functions accept a range of argument
+counts; for example <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._substring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">substring</a></span> accepts either two or three
+arguments. A function&rsquo;s <span style="font-style: italic">arity</span> is the number of arguments
+that it accepts.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;keyword-args&quot;">4.3.2<tt>&nbsp;</tt><a name="(part._keyword-args)"></a>Keyword Arguments</h5><p>Some functions accept <span style="font-style: italic">keyword arguments</span> in addition to
+by-position arguments. For that case, an <span class="RktVar">arg</span> can be an
+<span class="RktVar">arg-keyword</span><span class="stt"> </span><span class="RktVar">arg-expr</span> sequence instead of just a
+<span class="RktVar">arg-expr</span>:</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="keywords.html" data-pltdoc="x">Keywords</a> introduces keywords.</p></blockquote></blockquote></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktVar">proc-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">arg</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">arg-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">arg-keyword</span><span class="hspace">&nbsp;</span><span class="RktVar">arg-expr</span></td></tr></table></td></tr></table></blockquote></blockquote><p>For example,</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym">go</span><span class="hspace">&nbsp;</span><span class="RktVal">"super.rkt"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">fast</span><span class="RktPn">)</span></p></blockquote><p>calls the function bound to <span class="RktSym">go</span> with <span class="RktVal">"super.rkt"</span> as a
+by-position argument, and with <span class="RktVal">'</span><span class="RktVal">fast</span> as an argument
+associated with the <span class="RktPn">#:mode</span> keyword. A keyword is implicitly
+paired with the expression that follows it.</p><p>Since a keyword by itself is not an expression, then</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym">go</span><span class="hspace">&nbsp;</span><span class="RktVal">"super.rkt"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktPn">#:fast</span><span class="RktPn">)</span></p></blockquote><p>is a syntax error. The <span class="RktPn">#:mode</span> keyword must be followed by an
+expression to produce an argument value, and <span class="RktPn">#:fast</span> is not an
+expression.</p><p>The order of keyword <span class="RktVar">arg</span>s determines the order in which
+<span class="RktVar">arg-expr</span>s are evaluated, but a function accepts keyword
+arguments independent of their position in the argument list. The
+above call to <span class="RktSym">go</span> can be equivalently written</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym">go</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">fast</span><span class="hspace">&nbsp;</span><span class="RktVal">"super.rkt"</span><span class="RktPn">)</span></p></blockquote><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=application.html&amp;version=8.6" class="Sq" data-pltdoc="x">Procedure Applications and <span class="RktSym"><span class="RktStxLink">#%app</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on procedure applications.</p></blockquote></blockquote></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;apply&quot;">4.3.3<tt>&nbsp;</tt><a name="(part._apply)"></a>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span> Function</h5><p>The syntax for function calls supports any number of arguments, but a
+specific call always specifies a fixed number of arguments. As a
+result, a function that takes a list of arguments cannot directly
+apply a function like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span> to all of the items in a list:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">avg</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">doesn&rsquo;t work...</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">avg</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">+: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: number?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: '(1 2 3)</span></p></td></tr></table></td></tr></table></blockquote><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">avg</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">doesn&rsquo;t always work...</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">avg</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">avg</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">list-ref: index too large for list</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">index: 2</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: '(1 2)</span></p></td></tr></table></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span> function offers a way around this restriction. It
+takes a function and a <span style="font-style: italic">list</span> argument, and it applies the
+function to the values in the list:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">avg</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">avg</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">avg</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3/2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">avg</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5/2</span></p></td></tr></table></td></tr></table></blockquote><p>As a convenience, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span> function accepts additional
+arguments between the function and the list. The additional arguments
+are effectively <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span>ed onto the argument list:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">anti-sum</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">anti-sum</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">-6</span></p></td></tr></table></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span> function accepts keyword arguments, too, and it
+passes them along to the called function:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym">go</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">fast</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"super.rkt"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym">go</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"super.rkt"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">fast</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Keywords that are included in <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span>&rsquo;s list argument do not
+count as keyword arguments for the called function; instead, all arguments in
+this list are treated as by-position arguments. To pass a list of
+keyword arguments to a function, use
+the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._keyword-apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">keyword-apply</a></span> function, which accepts a function to apply
+and three lists. The first two lists are in parallel, where the first
+list contains keywords (sorted by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=keywords.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._keyword%7E3c%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">keyword&lt;?</a></span>), and the second
+list contains a corresponding argument for each keyword. The third
+list contains by-position function arguments, as for <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span>.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._keyword-apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">keyword-apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym">go</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">#:mode</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">fast</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"super.rkt"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="binding.html" title="backward to &quot;4.2 Identifiers and Binding&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="lambda.html" title="forward to &quot;4.4 Functions (Procedures): lambda&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/begin.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/begin.html
new file mode 100644
index 00000000..dc82b1ec
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/begin.html
@@ -0,0 +1,27 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.8&nbsp;Sequencing</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewselflink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="syntax-notation.html" class="tocviewlink" data-pltdoc="x">Notation</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="binding.html" class="tocviewlink" data-pltdoc="x">Identifiers and Binding</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Function Calls</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Functions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span></a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span></a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="conditionals.html" class="tocviewlink" data-pltdoc="x">Conditionals</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="begin.html" class="tocviewselflink" data-pltdoc="x">Sequencing</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span></a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktVal">&rsquo;</span></a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="qq.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span> and <span class="RktVal">&lsquo;</span></a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Simple Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="parameterize.html" class="tocviewlink" data-pltdoc="x">Dynamic Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">parameterize</span></span></a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.8&nbsp;</td><td><a href="begin.html" class="tocviewselflink" data-pltdoc="x">Sequencing</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.8.1&nbsp;</td><td><a href="begin.html#%28part._.Effects_.Before__begin%29" class="tocviewlink" data-pltdoc="x">Effects Before:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span></a></td></tr><tr><td align="right">4.8.2&nbsp;</td><td><a href="begin.html#%28part._.Effects_.After__begin0%29" class="tocviewlink" data-pltdoc="x">Effects After:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin0</span></span></a></td></tr><tr><td align="right">4.8.3&nbsp;</td><td><a href="begin.html#%28part._when%2Bunless%29" class="tocviewlink" data-pltdoc="x">Effects If...:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">4.8.1<tt>&nbsp;</tt></span><a href="begin.html#%28part._.Effects_.Before__begin%29" class="tocsubseclink" data-pltdoc="x">Effects Before:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.8.2<tt>&nbsp;</tt></span><a href="begin.html#%28part._.Effects_.After__begin0%29" class="tocsubseclink" data-pltdoc="x">Effects After:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">begin0</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.8.3<tt>&nbsp;</tt></span><a href="begin.html#%28part._when%2Bunless%29" class="tocsubseclink" data-pltdoc="x">Effects If...:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="conditionals.html" title="backward to &quot;4.7 Conditionals&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="set_.html" title="forward to &quot;4.9 Assignment: set!&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;begin&quot;">4.8<tt>&nbsp;</tt><a name="(part._begin)"></a>Sequencing</h4><p>Racket programmers prefer to write programs with as few side-effects
+as possible, since purely functional code is more easily tested and
+composed into larger programs. Interaction with the external
+environment, however, requires sequencing, such as when writing to a
+display, opening a graphical window, or manipulating a file on disk.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Effects_Before__begin&quot;">4.8.1<tt>&nbsp;</tt><a name="(part._.Effects_.Before__begin)"></a>Effects Before: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span></h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html&amp;version=8.6" class="Sq" data-pltdoc="x">Sequencing: <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-for-syntax</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> also documents <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span>.</p></blockquote></blockquote></blockquote><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span> expression sequences expressions:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>The <span class="RktVar">expr</span>s are evaluated in order, and the result of all but
+the last <span class="RktVar">expr</span> is ignored. The result from the last
+<span class="RktVar">expr</span> is the result of the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span> form, and it is in
+tail position with respect to the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span> form.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">print-triangle</span><span class="hspace">&nbsp;</span><span class="RktSym">height</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">height</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">height</span><span class="hspace">&nbsp;</span><span class="RktVal">#\*</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Output.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._newline%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">newline</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">print-triangle</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sub1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">height</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">print-triangle</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">****</span></p></td></tr><tr><td><p><span class="RktOut">***</span></p></td></tr><tr><td><p><span class="RktOut">**</span></p></td></tr><tr><td><p><span class="RktOut">*</span></p></td></tr></table></td></tr></table></blockquote></div></p><p>Many forms, such as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span> support a
+sequence of expressions even without a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span>. Such positions are
+sometimes said to have an <a name="(tech._implicit._begin)"></a><span style="font-style: italic">implicit begin</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">print-triangle</span><span class="hspace">&nbsp;</span><span class="RktSym">height</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._positive%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">height</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">height</span><span class="hspace">&nbsp;</span><span class="RktVal">#\*</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Output.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._newline%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">newline</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">print-triangle</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sub1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">height</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">print-triangle</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">****</span></p></td></tr><tr><td><p><span class="RktOut">***</span></p></td></tr><tr><td><p><span class="RktOut">**</span></p></td></tr><tr><td><p><span class="RktOut">*</span></p></td></tr></table></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span> form is special at the top level, at module level,
+or as a <span class="RktSym">body</span> after only internal definitions. In those
+positions, instead of forming an expression, the content of
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span> is spliced into the surrounding context.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">curly</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">moe</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">curly</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">larry</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">moe</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">larry</span><span class="hspace">&nbsp;</span><span class="RktSym">curly</span><span class="hspace">&nbsp;</span><span class="RktSym">moe</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(2 0 1)</span></p></td></tr></table></blockquote></div></p><p>This splicing behavior is mainly useful for macros, as we discuss
+later in <a href="macros.html" data-pltdoc="x">Macros</a>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Effects_After__begin0&quot;">4.8.2<tt>&nbsp;</tt><a name="(part._.Effects_.After__begin0)"></a>Effects After: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin0%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin0</a></span></h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html&amp;version=8.6" class="Sq" data-pltdoc="x">Sequencing: <span class="RktSym"><span class="RktStxLink">begin</span></span>, <span class="RktSym"><span class="RktStxLink">begin0</span></span>, and <span class="RktSym"><span class="RktStxLink">begin-for-syntax</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> also documents <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin0%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin0</a></span>.</p></blockquote></blockquote></blockquote><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin0%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin0</a></span> expression has the same syntax as a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span>
+expression:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin0%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin0</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>The difference is that <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin0%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin0</a></span> returns the result of the first
+<span class="RktSym">expr</span>, instead of the result of the last <span class="RktSym">expr</span>. The
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin0%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin0</a></span> form is useful for implementing side-effects that
+happen after a computation, especially in the case where the
+computation produces an unknown number of results.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">log-times</span><span class="hspace">&nbsp;</span><span class="RktSym">thunk</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Start: ~s\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-inexact-milliseconds%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-inexact-milliseconds</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin0%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin0</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">thunk</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"End..: ~s\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-inexact-milliseconds%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-inexact-milliseconds</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">log-times</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sleep%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sleep</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0.1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">Start: 1659635523430.117</span></p></td></tr><tr><td><p><span class="RktOut">End..: 1659635523530.1548</span></p></td></tr></table></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">log-times</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">Start: 1659635523531.675</span></p></td></tr><tr><td><p><span class="RktOut">End..: 1659635523531.6907</span></p></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;when+unless&quot;">4.8.3<tt>&nbsp;</tt><a name="(part._when+unless)"></a>Effects If...: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._when%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">when</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._unless%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unless</a></span></h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html&amp;version=8.6" class="Sq" data-pltdoc="x">Guarded Evaluation: <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> also documents <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._when%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">when</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._unless%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unless</a></span>.</p></blockquote></blockquote></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._when%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">when</a></span> form combines an <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span>-style conditional with
+sequencing for the &ldquo;then&rdquo; clause and no &ldquo;else&rdquo; clause:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._when%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">when</a></span><span class="hspace">&nbsp;</span><span class="RktVar">test-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">then-body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>If <span class="RktVar">test-expr</span> produces a true value, then all of the
+<span class="RktVar">then-body</span>s are evaluated. The result of the last
+<span class="RktVar">then-body</span> is the result of the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._when%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">when</a></span> form.
+Otherwise, no <span class="RktVar">then-body</span>s are evaluated and the
+result is <a href="void_undefined.html" class="RktModLink" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._unless%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unless</a></span> form is similar:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._unless%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktVar">test-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">then-body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>The difference is that the <span class="RktVar">test-expr</span> result is inverted: the
+<span class="RktVar">then-body</span>s are evaluated only if the <span class="RktVar">test-expr</span>
+result is <span class="RktVal">#f</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">enumerate</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a.\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a, "</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._when%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">when</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"and "</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">enumerate</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">enumerate</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Larry"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Curly"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Moe"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Larry, Curly, and Moe.</span></p></td></tr></table></blockquote></div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">print-triangle</span><span class="hspace">&nbsp;</span><span class="RktSym">height</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._unless%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">height</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">height</span><span class="hspace">&nbsp;</span><span class="RktVal">#\*</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Output.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._newline%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">newline</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">print-triangle</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sub1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">height</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">print-triangle</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">****</span></p></td></tr><tr><td><p><span class="RktOut">***</span></p></td></tr><tr><td><p><span class="RktOut">**</span></p></td></tr><tr><td><p><span class="RktOut">*</span></p></td></tr></table></td></tr></table></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="conditionals.html" title="backward to &quot;4.7 Conditionals&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="set_.html" title="forward to &quot;4.9 Assignment: set!&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/binding.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/binding.html
new file mode 100644
index 00000000..98638739
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/binding.html
@@ -0,0 +1,35 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.2&nbsp;Identifiers and Binding</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewselflink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="syntax-notation.html" class="tocviewlink" data-pltdoc="x">Notation</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="binding.html" class="tocviewselflink" data-pltdoc="x">Identifiers and Binding</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Function Calls</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Functions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span></a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span></a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="conditionals.html" class="tocviewlink" data-pltdoc="x">Conditionals</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span></a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktVal">&rsquo;</span></a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="qq.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span> and <span class="RktVal">&lsquo;</span></a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Simple Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="parameterize.html" class="tocviewlink" data-pltdoc="x">Dynamic Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">parameterize</span></span></a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="syntax-notation.html" title="backward to &quot;4.1 Notation&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="application.html" title="forward to &quot;4.3 Function Calls (Procedure Applications)&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;binding&quot;">4.2<tt>&nbsp;</tt><a name="(part._binding)"></a>Identifiers and Binding</h4><p>The context of an expression determines the meaning of identifiers
+that appear in the expression. In particular, starting a module with
+the language <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a>, as in</p><blockquote class="SCodeFlow"><p><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></p></blockquote><p>means that, within the module, the identifiers described in this guide
+start with the meaning described here: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span> refers to the
+function that creates a pair, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span> refers to the function
+that extracts the first element of a pair, and so on.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="symbols.html" data-pltdoc="x">Symbols</a> introduces the syntax of
+identifiers.</p></blockquote></blockquote></blockquote><p>Forms like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span>, and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span>
+associate a meaning with one or more identifiers; that is, they
+<span style="font-style: italic">bind</span> identifiers. The part of the program for which the
+binding applies is the <span style="font-style: italic">scope</span> of the binding. The set of
+bindings in effect for a given expression is the expression&rsquo;s
+<span style="font-style: italic">environment</span>.</p><p>For example, in</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr></table></blockquote><p>the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> is a binding of <span class="RktSym">f</span>, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span>
+has a binding for <span class="RktSym">x</span>, and the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> has a binding for
+<span class="RktSym">y</span>. The scope of the binding for <span class="RktSym">f</span> is the entire
+module; the scope of the <span class="RktSym">x</span> binding is <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="stt"> </span><span class="RktVal">5</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktSym">x</span><span class="stt"> </span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span>; and the scope of the <span class="RktSym">y</span> binding is just <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktSym">x</span><span class="stt"> </span><span class="RktSym">y</span><span class="RktPn">)</span>. The environment of <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktSym">x</span><span class="stt"> </span><span class="RktSym">y</span><span class="RktPn">)</span> includes bindings for
+<span class="RktSym">y</span>, <span class="RktSym">x</span>, and <span class="RktSym">f</span>, as well as everything in
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a>.</p><p>A module-level <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> can bind only identifiers that are not
+already defined or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>d into the module. A local
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> or other binding forms, however, can give a new local
+binding for an identifier that already has a binding; such a binding
+<a name="(tech._shadow)"></a><span style="font-style: italic">shadows</span> the existing binding.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">append</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">append</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"ugly"</span><span class="hspace">&nbsp;</span><span class="RktVal">"confusing"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">append</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">this-was</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">append</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(this-was ("ugly" "confusing"))</span></p></td></tr></table></blockquote></div></p><p>Similarly, a module-level <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> can <a href="binding.html#%28tech._shadow%29" class="techoutside" data-pltdoc="x"><span class="techinside">shadow</span></a> a binding
+from the module&rsquo;s language. For example, <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">)</span> in a
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a> module shadows the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span> that is
+provided by <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a>. Intentionally shadowing a language
+binding is rarely a good idea&#8212;<wbr></wbr>especially for widely used bindings
+like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span>&#8212;<wbr></wbr>but shadowing relieves a programmer from having
+to avoid every obscure binding that is provided by a language.</p><p>Even identifiers like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> get their
+meanings from bindings, though they have <span style="font-style: italic">transformer</span>
+bindings (which means that they indicate syntactic forms) instead of
+value bindings. Since <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> has a transformer binding, the
+identifier <span class="RktSym">define</span> cannot be used by itself to get a
+value. However, the normal binding for <span class="RktSym">define</span> can be
+shadowed.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span></td></tr><tr><td><p><span class="RktErr">eval:1:0: define: bad syntax</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: define</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">define</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr></table></blockquote></div></p><p>Again, shadowing standard bindings in this way is rarely a good idea, but the
+possibility is an inherent part of Racket&rsquo;s flexibility.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="syntax-notation.html" title="backward to &quot;4.1 Notation&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="application.html" title="forward to &quot;4.3 Function Calls (Procedure Applications)&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/booleans.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/booleans.html
new file mode 100644
index 00000000..3da3f7e7
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/booleans.html
@@ -0,0 +1,8 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.1&nbsp;Booleans</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewselflink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="booleans.html" class="tocviewselflink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings (Unicode)</a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Bytes and Byte Strings</a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="hash-tables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="void_undefined.html" class="tocviewlink" data-pltdoc="x">Void and Undefined</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="datatypes.html" title="backward to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="numbers.html" title="forward to &quot;3.2 Numbers&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;booleans&quot;">3.1<tt>&nbsp;</tt><a name="(part._booleans)"></a>Booleans</h4><p>Racket has two distinguished constants to represent boolean values:
+<span class="RktVal">#t</span> for true and <span class="RktVal">#f</span> for false. Uppercase
+<span class="RktVal">#T</span> and <span class="RktVal">#F</span> are parsed as the same
+values, but the lowercase forms are preferred.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span> procedure recognizes the two boolean
+constants. In the result of a test expression for <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span>,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span>, etc., however, any value
+other than <span class="RktVal">#f</span> counts as true.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"no"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"no"</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="datatypes.html" title="backward to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="numbers.html" title="forward to &quot;3.2 Numbers&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/boxes.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/boxes.html
new file mode 100644
index 00000000..737a31c4
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/boxes.html
@@ -0,0 +1,5 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.11&nbsp;Boxes</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewselflink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings (Unicode)</a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Bytes and Byte Strings</a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="hash-tables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="boxes.html" class="tocviewselflink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="void_undefined.html" class="tocviewlink" data-pltdoc="x">Void and Undefined</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="hash-tables.html" title="backward to &quot;3.10 Hash Tables&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="void_undefined.html" title="forward to &quot;3.12 Void and Undefined&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;boxes&quot;">3.11<tt>&nbsp;</tt><a name="(part._boxes)"></a>Boxes</h4><p>A <a name="(tech._box)"></a><span style="font-style: italic">box</span> is like a single-element vector. It can print as a
+quoted <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&amp;</span><span class="hspace"></span></span> followed by the printed form of the boxed value.
+A <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&amp;</span><span class="hspace"></span></span> form can also be used as an expression, but since the
+resulting box is constant, it has practically no use.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=boxes.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._box%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">box</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">b</span></td></tr><tr><td><p><span class="RktRes">'#&amp;"apple"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=boxes.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._unbox%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">unbox</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"apple"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=boxes.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._set-box%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">set-box!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">banana</span><span class="hspace">&nbsp;</span><span class="RktVal">boat</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">b</span></td></tr><tr><td><p><span class="RktRes">'#&amp;(banana boat)</span></p></td></tr></table></blockquote></div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=boxes.html&amp;version=8.6" class="Sq" data-pltdoc="x">Boxes</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on boxes and box procedures.</p></blockquote></blockquote></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="hash-tables.html" title="backward to &quot;3.10 Hash Tables&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="void_undefined.html" title="forward to &quot;3.12 Void and Undefined&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/bytestrings.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/bytestrings.html
new file mode 100644
index 00000000..d7f246e7
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/bytestrings.html
@@ -0,0 +1,22 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.5&nbsp;Bytes and Byte Strings</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewselflink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings (Unicode)</a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewselflink" data-pltdoc="x">Bytes and Byte Strings</a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="hash-tables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="void_undefined.html" class="tocviewlink" data-pltdoc="x">Void and Undefined</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="strings.html" title="backward to &quot;3.4 Strings (Unicode)&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="symbols.html" title="forward to &quot;3.6 Symbols&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;bytestrings&quot;">3.5<tt>&nbsp;</tt><a name="(part._bytestrings)"></a>Bytes and Byte Strings</h4><p>A <a name="(tech._byte)"></a><span style="font-style: italic">byte</span> is an exact integer between <span class="RktVal">0</span> and
+<span class="RktVal">255</span>, inclusive. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._byte%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">byte?</a></span> predicate recognizes
+numbers that represent bytes.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._byte%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">byte?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._byte%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">byte?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">256</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p>A <a name="(tech._byte._string)"></a><span style="font-style: italic">byte string</span> is similar to a string&#8212;<wbr></wbr>see
+<a href="strings.html" data-pltdoc="x">Strings (Unicode)</a>&#8212;<wbr></wbr>but its content is a sequence of bytes
+instead of characters. Byte strings can be used in applications that
+process pure ASCII instead of Unicode text. The printed form of a
+byte string supports such uses in particular, because a byte string
+prints like the ASCII decoding of the byte string, but prefixed with a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span>. Unprintable ASCII characters or non-ASCII bytes in the
+byte string are written with octal notation.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528part._parse-string%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Reading Strings</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> documents the fine points of the syntax of byte strings.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktVal">#"Apple"</span></td></tr><tr><td><p><span class="RktRes">#"Apple"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">bytes-ref</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">65</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-bytes%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#"AAA"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-bytes%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">b</span></td></tr><tr><td><p><span class="RktRes">#"\0\0"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes-set%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">bytes-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes-set%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">bytes-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">255</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">b</span></td></tr><tr><td><p><span class="RktRes">#"\1\377"</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span> form of a byte string writes its raw bytes to the
+current output port (see <a href="i_o.html" data-pltdoc="x">Input and Output</a>). Technically,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span> of a normal (i.e,. character) string prints the UTF-8
+encoding of the string to the current output port, since output is
+ultimately defined in terms of bytes; <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span> of a byte
+string, however, writes the raw bytes with no encoding. Along the same
+lines, when this documentation shows output, it technically shows the
+UTF-8-decoded form of the output.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"Apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Apple</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"\316\273"</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">same as </span><span class="RktVal">"&#206;&#187;"</span></td></tr><tr><td><p><span class="RktOut">&#206;&#187;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"\316\273"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">UTF-8 encoding of </span>&#955;</td></tr><tr><td><p><span class="RktOut">&#955;</span></p></td></tr></table></blockquote></div></p><p>For explicitly converting between strings and byte strings, Racket
+supports three kinds of encodings directly: UTF-8, Latin-1, and the
+current locale&rsquo;s encoding. General facilities for byte-to-byte
+conversions (especially to and from UTF-8) fill the gap to support
+arbitrary string encodings.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes-%7E3estring%252Futf-8%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">bytes-&gt;string/utf-8</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"\316\273"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"&#955;"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes-%7E3estring%252Flatin-1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">bytes-&gt;string/latin-1</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"\316\273"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"&#206;&#187;"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=encodings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-locale%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-locale</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"C"</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">C locale supports ASCII,</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes-%7E3estring%252Flocale%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">bytes-&gt;string/locale</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"\316\273"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">only, so...</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">bytes-&gt;string/locale: byte string is not a valid encoding</span></p></td></tr><tr><td><p><span class="RktErr">for the current locale</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">byte string: #"\316\273"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">cvt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes-open-converter%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">bytes-open-converter</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"cp1253"</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Greek code page</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"UTF-8"</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">dest</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-bytes%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes-convert%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">bytes-convert</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cvt</span><span class="hspace">&nbsp;</span><span class="RktVal">#"\353"</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">dest</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes-close-converter%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">bytes-close-converter</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cvt</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes-%7E3estring%252Futf-8%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">bytes-&gt;string/utf-8</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dest</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"&#955;"</span></p></td></tr></table></blockquote></div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=bytestrings.html&amp;version=8.6" class="Sq" data-pltdoc="x">Byte Strings</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on byte strings and byte-string procedures.</p></blockquote></blockquote></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="strings.html" title="backward to &quot;3.4 Strings (Unicode)&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="symbols.html" title="forward to &quot;3.6 Symbols&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/case.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/case.html
new file mode 100644
index 00000000..91838bfd
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/case.html
@@ -0,0 +1,11 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.12&nbsp;Simple Dispatch: case</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewselflink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="syntax-notation.html" class="tocviewlink" data-pltdoc="x">Notation</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="binding.html" class="tocviewlink" data-pltdoc="x">Identifiers and Binding</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Function Calls</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Functions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span></a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span></a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="conditionals.html" class="tocviewlink" data-pltdoc="x">Conditionals</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span></a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktVal">&rsquo;</span></a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="qq.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span> and <span class="RktVal">&lsquo;</span></a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="case.html" class="tocviewselflink" data-pltdoc="x">Simple Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="parameterize.html" class="tocviewlink" data-pltdoc="x">Dynamic Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">parameterize</span></span></a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="qq.html" title="backward to &quot;4.11 Quasiquoting: quasiquote and lsquo&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="parameterize.html" title="forward to &quot;4.13 Dynamic Binding: parameterize&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;case&quot;">4.12<tt>&nbsp;</tt><a name="(part._case)"></a>Simple Dispatch: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=case.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case</a></span></h4><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=case.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case</a></span> form dispatches to a clause by matching the result
+of an expression to the values for the clause:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=case.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">datum</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote><p>Each <span class="RktVar">datum</span> will be compared to the result of <span class="RktVar">expr</span>
+using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span>, and then the corresponding <span class="RktSym">body</span>s are
+evaluated. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=case.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case</a></span> form can dispatch to the correct clause
+in <span style="font-style: italic">O</span>(<span style="font-style: italic">log N</span>)<span style="font-style: italic"></span> time for <span style="font-style: italic">N</span> <span class="RktSym">datum</span>s.</p><p>Multiple <span class="RktVar">datum</span>s can be supplied for each clause, and the
+corresponding <span class="RktVar">body</span>s are evaluated if any of the
+<span class="RktVar">datum</span>s match.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._random%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">random</a></span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=case.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">zero</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">one</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">two</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">many</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">2</span></p></td></tr><tr><td><p><span class="RktRes">'two</span></p></td></tr></table></blockquote></div></p><p>The last clause of a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=case.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case</a></span> form can use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span>, just
+like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span>:</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=case.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._random%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">random</a></span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">zero</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">one</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">two</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">many</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'one</span></p></td></tr></table></blockquote></div></p><p>For more general pattern matching (but without the dispatch-time
+guarantee), use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span>, which is introduced in
+<a href="match.html" data-pltdoc="x">Pattern Matching</a>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="qq.html" title="backward to &quot;4.11 Quasiquoting: quasiquote and lsquo&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="parameterize.html" title="forward to &quot;4.13 Dynamic Binding: parameterize&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/characters.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/characters.html
new file mode 100644
index 00000000..c15f573a
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/characters.html
@@ -0,0 +1,27 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.3&nbsp;Characters</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewselflink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="characters.html" class="tocviewselflink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings (Unicode)</a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Bytes and Byte Strings</a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="hash-tables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="void_undefined.html" class="tocviewlink" data-pltdoc="x">Void and Undefined</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="numbers.html" title="backward to &quot;3.2 Numbers&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="strings.html" title="forward to &quot;3.4 Strings (Unicode)&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;characters&quot;">3.3<tt>&nbsp;</tt><a name="(part._characters)"></a>Characters</h4><p>A Racket <a name="(tech._character)"></a><span style="font-style: italic">character</span> corresponds to a Unicode <span style="font-style: italic">scalar
+value</span>. Roughly, a scalar value is an unsigned integer whose
+representation fits into 21 bits, and that maps to some notion of a
+natural-language character or piece of a character. Technically, a
+scalar value is a simpler notion than the concept called a
+&ldquo;character&rdquo; in the Unicode standard, but it&rsquo;s an approximation that
+works well for many purposes. For example, any accented Roman letter
+can be represented as a scalar value, as can any common Chinese character.</p><p>Although each Racket character corresponds to an integer, the
+character datatype is separate from numbers. The
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char-%7E3einteger%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char-&gt;integer</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer-%7E3echar%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer-&gt;char</a></span> procedures convert
+between scalar-value numbers and the corresponding character.</p><p>A printable character normally prints as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\</span><span class="hspace"></span></span> followed
+by the represented character. An unprintable character normally prints
+as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#\u</span><span class="hspace"></span></span> followed by the scalar value as hexadecimal
+number. A few characters are printed specially; for example, the space
+and linefeed characters print as <span class="RktVal">#\space</span> and
+<span class="RktVal">#\newline</span>, respectively.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528part._parse-character%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Reading Characters</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> documents the fine points of the syntax of characters.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer-%7E3echar%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer-&gt;char</a></span><span class="hspace">&nbsp;</span><span class="RktVal">65</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\A</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char-%7E3einteger%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char-&gt;integer</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">65</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">#\&#955;</span></td></tr><tr><td><p><span class="RktRes">#\&#955;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">#\u03BB</span></td></tr><tr><td><p><span class="RktRes">#\&#955;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer-%7E3echar%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer-&gt;char</a></span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\u0011</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char-%7E3einteger%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char-&gt;integer</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\space</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">32</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span> procedure directly writes a character to the
+current output port (see <a href="i_o.html" data-pltdoc="x">Input and Output</a>), in contrast to the
+character-constant syntax used to print a character result.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktVal">#\A</span></td></tr><tr><td><p><span class="RktRes">#\A</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">A</span></p></td></tr></table></blockquote></div></p><p>Racket provides several classification and conversion procedures on
+characters. Beware, however, that conversions on some Unicode
+characters work as a human would expect only when they are in a string
+(e.g., upcasing &ldquo;&#223;&rdquo; or downcasing &ldquo;&#931;&rdquo;).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char-alphabetic%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char-alphabetic?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char-numeric%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char-numeric?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char-whitespace%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char-whitespace?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\newline</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char-downcase%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char-downcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\a</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char-upcase%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char-upcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\&#223;</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\&#223;</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char%7E3d%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char=?</a></span> procedure compares two or more characters, and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char-ci%7E3d%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char-ci=?</a></span> compares characters ignoring case. The
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eqv%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eqv?</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span> procedures behave the same as
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char%7E3d%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char=?</a></span> on characters; use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char%7E3d%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char=?</a></span> when you want to
+more specifically declare that the values being compared are
+characters.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char%7E3d%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char-ci%7E3d%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char-ci=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eqv%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\a</span><span class="hspace">&nbsp;</span><span class="RktVal">#\A</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html&amp;version=8.6" class="Sq" data-pltdoc="x">Characters</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on characters and character procedures.</p></blockquote></blockquote></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="numbers.html" title="backward to &quot;3.2 Numbers&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="strings.html" title="forward to &quot;3.4 Strings (Unicode)&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/classes.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/classes.html
new file mode 100644
index 00000000..26af3f5e
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/classes.html
@@ -0,0 +1,365 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>13&nbsp;Classes and Objects</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9660;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewselflink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>13&nbsp;</td><td><a href="classes.html" class="tocviewselflink" data-pltdoc="x">Classes and Objects</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">13.1&nbsp;</td><td><a href="classes.html#%28part._methods%29" class="tocviewlink" data-pltdoc="x">Methods</a></td></tr><tr><td align="right">13.2&nbsp;</td><td><a href="classes.html#%28part._initargs%29" class="tocviewlink" data-pltdoc="x">Initialization Arguments</a></td></tr><tr><td align="right">13.3&nbsp;</td><td><a href="classes.html#%28part._intnames%29" class="tocviewlink" data-pltdoc="x">Internal and External Names</a></td></tr><tr><td align="right">13.4&nbsp;</td><td><a href="classes.html#%28part._.Interfaces%29" class="tocviewlink" data-pltdoc="x">Interfaces</a></td></tr><tr><td align="right">13.5&nbsp;</td><td><a href="classes.html#%28part._inner%29" class="tocviewlink" data-pltdoc="x">Final, Augment, and Inner</a></td></tr><tr><td align="right">13.6&nbsp;</td><td><a href="classes.html#%28part._extnames%29" class="tocviewlink" data-pltdoc="x">Controlling the Scope of External Names</a></td></tr><tr><td align="right">13.7&nbsp;</td><td><a href="classes.html#%28part._.Mixins%29" class="tocviewlink" data-pltdoc="x">Mixins</a></td></tr><tr><td align="right">13.8&nbsp;</td><td><a href="classes.html#%28part._.Traits%29" class="tocviewlink" data-pltdoc="x">Traits</a></td></tr><tr><td align="right">13.9&nbsp;</td><td><a href="classes.html#%28part._.Class_.Contracts%29" class="tocviewlink" data-pltdoc="x">Class Contracts</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">13.1<tt>&nbsp;</tt></span><a href="classes.html#%28part._methods%29" class="tocsubseclink" data-pltdoc="x">Methods</a></td></tr><tr><td><span class="tocsublinknumber">13.2<tt>&nbsp;</tt></span><a href="classes.html#%28part._initargs%29" class="tocsubseclink" data-pltdoc="x">Initialization Arguments</a></td></tr><tr><td><span class="tocsublinknumber">13.3<tt>&nbsp;</tt></span><a href="classes.html#%28part._intnames%29" class="tocsubseclink" data-pltdoc="x">Internal and External Names</a></td></tr><tr><td><span class="tocsublinknumber">13.4<tt>&nbsp;</tt></span><a href="classes.html#%28part._.Interfaces%29" class="tocsubseclink" data-pltdoc="x">Interfaces</a></td></tr><tr><td><span class="tocsublinknumber">13.5<tt>&nbsp;</tt></span><a href="classes.html#%28part._inner%29" class="tocsubseclink" data-pltdoc="x">Final, Augment, and Inner</a></td></tr><tr><td><span class="tocsublinknumber">13.6<tt>&nbsp;</tt></span><a href="classes.html#%28part._extnames%29" class="tocsubseclink" data-pltdoc="x">Controlling the Scope of External Names</a></td></tr><tr><td><span class="tocsublinknumber">13.7<tt>&nbsp;</tt></span><a href="classes.html#%28part._.Mixins%29" class="tocsubseclink" data-pltdoc="x">Mixins</a></td></tr><tr><td><span class="tocsublinknumber">13.7.1<tt>&nbsp;</tt></span><a href="classes.html#%28part._.Mixins_and_.Interfaces%29" class="tocsubseclink" data-pltdoc="x">Mixins and Interfaces</a></td></tr><tr><td><span class="tocsublinknumber">13.7.2<tt>&nbsp;</tt></span><a href="classes.html#%28part._.The_mixin_.Form%29" class="tocsubseclink" data-pltdoc="x">The <span class="RktSym"><span class="RktStxLink">mixin</span></span> Form</a></td></tr><tr><td><span class="tocsublinknumber">13.7.3<tt>&nbsp;</tt></span><a href="classes.html#%28part._parammixins%29" class="tocsubseclink" data-pltdoc="x">Parameterized Mixins</a></td></tr><tr><td><span class="tocsublinknumber">13.8<tt>&nbsp;</tt></span><a href="classes.html#%28part._.Traits%29" class="tocsubseclink" data-pltdoc="x">Traits</a></td></tr><tr><td><span class="tocsublinknumber">13.8.1<tt>&nbsp;</tt></span><a href="classes.html#%28part._.Traits_as_.Sets_of_.Mixins%29" class="tocsubseclink" data-pltdoc="x">Traits as Sets of Mixins</a></td></tr><tr><td><span class="tocsublinknumber">13.8.2<tt>&nbsp;</tt></span><a href="classes.html#%28part._.Inherit_and_.Super_in_.Traits%29" class="tocsubseclink" data-pltdoc="x">Inherit and Super in Traits</a></td></tr><tr><td><span class="tocsublinknumber">13.8.3<tt>&nbsp;</tt></span><a href="classes.html#%28part._.The_trait_.Form%29" class="tocsubseclink" data-pltdoc="x">The <span class="RktSym"><span class="RktStxLink">trait</span></span> Form</a></td></tr><tr><td><span class="tocsublinknumber">13.9<tt>&nbsp;</tt></span><a href="classes.html#%28part._.Class_.Contracts%29" class="tocsubseclink" data-pltdoc="x">Class Contracts</a></td></tr><tr><td><span class="tocsublinknumber">13.9.1<tt>&nbsp;</tt></span><a href="classes.html#%28part._.External_.Class_.Contracts%29" class="tocsubseclink" data-pltdoc="x">External Class Contracts</a></td></tr><tr><td><span class="tocsublinknumber">13.9.2<tt>&nbsp;</tt></span><a href="classes.html#%28part._.Internal_.Class_.Contracts%29" class="tocsubseclink" data-pltdoc="x">Internal Class Contracts</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="match.html" title="backward to &quot;12 Pattern Matching&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="units.html" title="forward to &quot;14 Units (Components)&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;classes&quot;">13<tt>&nbsp;</tt><a name="(part._classes)"></a>Classes and Objects</h3><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>This chapter is based on a paper [<a href="doc-bibliography.html#%28cite._.Flatt06%29" data-pltdoc="x">Flatt06</a>].</p></blockquote></blockquote></blockquote><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span> expression denotes a first-class value,
+just like a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> expression:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktVar">superclass-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">decl-or-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>The <span class="RktVar">superclass-expr</span> determines the superclass for the new
+class. Each <span class="RktVar">decl-or-expr</span> is either a declaration related to
+methods, fields, and initialization arguments, or it is an expression
+that is evaluated each time that the class is instantiated. In other
+words, instead of a method-like constructor, a class has
+initialization expressions interleaved with field and method
+declarations.</p><p>By convention, class names end with <span class="RktSym">%</span>. The built-in root class is
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._object%7E25%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">object%</a></span>. The following expression creates a class with
+public methods <span class="RktSym">get-size</span>, <span class="RktSym">grow</span>, and <span class="RktSym">eat</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._object%7E25%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._init%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">init</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">initialization argument</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">current-size</span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">field</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">superclass initialization</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-size</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">current-size</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">grow</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">current-size</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="hspace">&nbsp;</span><span class="RktSym">current-size</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">other-fish</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">grow</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">other-fish</span><span class="hspace">&nbsp;</span><span class="RktSym">get-size</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The <span class="RktSym">size</span> initialization argument must be supplied via a named
+ argument when instantiating the class through the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span> form:</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._object%7E25%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">object%</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._init%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">init</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">]</span><span class="RktPn">)</span></p></blockquote><p>Of course, we can also name the class and its instance:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._object%7E25%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">object%</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._init%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">init</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">charlie</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish%</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>In the definition of <span class="RktSym">fish%</span>, <span class="RktSym">current-size</span> is a
+private field that starts out with the value of the <span class="RktSym">size</span>
+initialization argument. Initialization arguments like <span class="RktSym">size</span>
+are available only during class instantiation, so they cannot be
+referenced directly from a method. The <span class="RktSym">current-size</span> field, in
+contrast, is available to methods.</p><p>The <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span> expression in <span class="RktSym">fish%</span> invokes the
+initialization of the superclass. In this case, the superclass is
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._object%7E25%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">object%</a></span>, which takes no initialization arguments and performs
+no work; <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span> must be used, anyway, because a class must
+always invoke its superclass&rsquo;s initialization.</p><p>Initialization arguments, field declarations, and expressions such as
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span> can appear in any order within a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span>,
+and they can be interleaved with method declarations. The relative
+order of expressions in the class determines the order of evaluation
+during instantiation. For example, if a field&rsquo;s initial value requires
+calling a method that works only after superclass initialization, then
+the field declaration must be placed after the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span>
+call. Ordering field and initialization declarations in this way helps
+avoid imperative assignment. The relative order of method declarations
+makes no difference for evaluation, because methods are fully defined
+before a class is instantiated.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;methods&quot;">13.1<tt>&nbsp;</tt><a name="(part._methods)"></a>Methods</h4><p>Each of the three <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span> declarations in
+<span class="RktSym">fish%</span> introduces a new method. The declaration uses the same
+syntax as a Racket function, but a method is not accessible as an
+independent function.  A call to the <span class="RktSym">grow</span> method of a
+<span class="RktSym">fish%</span> object requires the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span> form:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">charlie</span><span class="hspace">&nbsp;</span><span class="RktSym">grow</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">charlie</span><span class="hspace">&nbsp;</span><span class="RktSym">get-size</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">16</span></p></td></tr></table></blockquote><p>Within <span class="RktSym">fish%</span>, self methods can be called like functions,
+because the method names are in scope.  For example, the <span class="RktSym">eat</span>
+method within <span class="RktSym">fish%</span> directly invokes the <span class="RktSym">grow</span>
+method.  Within a class, attempting to use a method name in any way
+other than a method call results in a syntax error.</p><p>In some cases, a class must call methods that are supplied by the superclass
+but not overridden. In that case, the class can use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span>
+with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._this%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">this</a></span> to access the method:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hungry-fish%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat-more</span><span class="hspace">&nbsp;</span><span class="RktSym">fish1</span><span class="hspace">&nbsp;</span><span class="RktSym">fish2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._this%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">this</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">fish1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._this%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">this</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">fish2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr></table></blockquote><p>Alternately, the class can declare the existence of a method using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit</a></span>,
+which brings the method name into scope for a direct call:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hungry-fish%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eat</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat-more</span><span class="hspace">&nbsp;</span><span class="RktSym">fish1</span><span class="hspace">&nbsp;</span><span class="RktSym">fish2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">fish1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">fish2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr></table></blockquote><p>With the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit</a></span> declaration, if <span class="RktSym">fish%</span> had not
+provided an <span class="RktSym">eat</span> method, an error would be signaled in the
+evaluation of the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span> form for <span class="RktSym">hungry-fish%</span>. In
+contrast, with <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="stt"> </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._this%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">this</a></span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span>, an error would not be
+signaled until the <span class="RktSym">eat-more</span> method is called and the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span> form is evaluated. For this reason, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit</a></span> is
+preferred.</p><p>Another drawback of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span> is that it is less efficient than
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit</a></span>. Invocation of a method via <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span> involves
+finding a method in the target object&rsquo;s class at run time, making
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span> comparable to an interface-based method call in Java. In
+contrast, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit</a></span>-based method invocations use an offset
+within the class&rsquo;s method table that is computed when the class is
+created.</p><p>To achieve performance similar to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit</a></span>-based method calls when
+invoking a method from outside the method&rsquo;s class, the programmer must use the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._generic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">generic</a></span> form, which produces a class- and method-specific
+<span style="font-style: italic">generic method</span> to be invoked with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send-generic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send-generic</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">get-fish-size</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._generic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">generic</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish%</span><span class="hspace">&nbsp;</span><span class="RktSym">get-size</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send-generic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send-generic</a></span><span class="hspace">&nbsp;</span><span class="RktSym">charlie</span><span class="hspace">&nbsp;</span><span class="RktSym">get-fish-size</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">16</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send-generic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send-generic</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hungry-fish%</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktVal">32</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">get-fish-size</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">32</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send-generic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send-generic</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._object%7E25%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">object%</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">get-fish-size</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">generic:get-size: target is not an instance of the generic's</span></p></td></tr><tr><td><p><span class="RktErr">class</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">target: (object)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">class name: fish%</span></p></td></tr></table></td></tr></table></blockquote><p>Roughly speaking, the form translates the class and the external
+method name to a location in the class&rsquo;s method table. As illustrated
+by the last example, sending through a generic method checks that its
+argument is an instance of the generic&rsquo;s class.</p><p>Whether a method is called directly within a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span>,
+through a generic method,
+or through <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span>, method overriding works in the usual way:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">picky-fish%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Foverride%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/override</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">grow</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super</a></span><span class="hspace">&nbsp;</span><span class="RktSym">grow</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3/4</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">daisy</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">picky-fish%</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">daisy</span><span class="hspace">&nbsp;</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">charlie</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">daisy</span><span class="hspace">&nbsp;</span><span class="RktSym">get-size</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">32</span></p></td></tr></table></td></tr></table></blockquote><p>The <span class="RktSym">grow</span> method in <span class="RktSym">picky-fish%</span> is declared with
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Foverride%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/override</a></span> instead of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span>, because
+<span class="RktSym">grow</span> is meant as an overriding declaration. If <span class="RktSym">grow</span>
+had been declared with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span>, an error would have
+been signaled when evaluating the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span> expression, because
+<span class="RktSym">fish%</span> already supplies <span class="RktSym">grow</span>.</p><p>Using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Foverride%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/override</a></span> also allows the invocation of the
+overridden method via a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super</a></span> call. For example, the
+<span class="RktSym">grow</span> implementation in <span class="RktSym">picky-fish%</span> uses
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super</a></span> to delegate to the superclass implementation.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;initargs&quot;">13.2<tt>&nbsp;</tt><a name="(part._initargs)"></a>Initialization Arguments</h4><p>Since <span class="RktSym">picky-fish%</span> declares no initialization arguments, any
+initialization values supplied in <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="stt"> </span><span class="RktSym">picky-fish%</span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span>  are
+propagated to the superclass initialization, i.e., to <span class="RktSym">fish%</span>.
+A subclass can supply additional initialization arguments for its
+superclass in a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span> call, and such initialization
+arguments take precedence over arguments supplied to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span>. For
+example, the following <span class="RktSym">size-10-fish%</span> class always generates
+fish of size 10:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size-10-fish%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size-10-fish%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">get-size</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr></table></td></tr></table></blockquote><p>In the case of <span class="RktSym">size-10-fish%</span>, supplying a <span class="RktSym">size</span>
+initialization argument with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span> would result in an
+initialization error; because the <span class="RktSym">size</span> in <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span>
+takes precedence, a <span class="RktSym">size</span> supplied to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span> would have
+no target declaration.</p><p>An initialization argument is optional if the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span> form
+declares a default value. For example, the following <span class="RktSym">default-10-fish%</span>
+class accepts a <span class="RktSym">size</span> initialization argument, but its value defaults to
+10 if no value is supplied on instantiation:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">default-10-fish%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._init%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">init</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">default-10-fish%</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(object:default-10-fish% ...)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">default-10-fish%</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(object:default-10-fish% ...)</span></p></td></tr></table></td></tr></table></blockquote><p>In this example, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span> call propagates its own
+<span class="RktSym">size</span> value as the <span class="RktSym">size</span> initialization argument to
+the superclass.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;intnames&quot;">13.3<tt>&nbsp;</tt><a name="(part._intnames)"></a>Internal and External Names</h4><p>The two uses of <span class="RktSym">size</span> in <span class="RktSym">default-10-fish%</span> expose the
+double life of class-member identifiers. When <span class="RktSym">size</span> is the
+first identifier of a bracketed pair in <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span> or
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span>, <span class="RktSym">size</span> is an <span style="font-style: italic">external name</span> that
+is symbolically matched to an initialization argument in a class. When
+<span class="RktSym">size</span> appears as an expression within
+<span class="RktSym">default-10-fish%</span>, <span class="RktSym">size</span> is an <span style="font-style: italic">internal name</span>
+that is lexically scoped. Similarly, a call to an inherited
+<span class="RktSym">eat</span> method uses <span class="RktSym">eat</span> as an internal name, whereas a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span> of <span class="RktSym">eat</span> uses <span class="RktSym">eat</span> as an external name.</p><p>The full syntax of the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span> form allows a programmer to
+specify distinct internal and external names for a class member. Since
+internal names are local, they can be renamed to avoid shadowing or
+conflicts. Such renaming is not frequently necessary, but workarounds
+in the absence of renaming can be especially cumbersome.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Interfaces&quot;">13.4<tt>&nbsp;</tt><a name="(part._.Interfaces)"></a>Interfaces</h4><p>Interfaces are useful for checking that an object or a class
+implements a set of methods with a particular (implied) behavior.
+This use of interfaces is helpful even without a static type system
+(which is the main reason that Java has interfaces).</p><p>An interface in Racket is created using the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createinterface.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._interface%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">interface</a></span>
+form, which merely declares the method names required to implement the
+interface. An interface can extend other interfaces, which means that
+implementations of the interface automatically implement the extended
+interfaces.</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createinterface.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._interface%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">interface</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">superinterface-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>To declare that a class implements an interface, the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class*</a></span> form must be used instead of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span>:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class*</a></span><span class="hspace">&nbsp;</span><span class="RktVar">superclass-expr</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">interface-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">decl-or-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>For example, instead of forcing all fish classes to be derived from
+<span class="RktSym">fish%</span>, we can define <span class="RktSym">fish-interface</span> and change the
+<span class="RktSym">fish%</span> class to declare that it implements
+<span class="RktSym">fish-interface</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish-interface</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createinterface.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._interface%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">interface</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">get-size</span><span class="hspace">&nbsp;</span><span class="RktSym">grow</span><span class="hspace">&nbsp;</span><span class="RktSym">eat</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class*</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._object%7E25%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">object%</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish-interface</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>If the definition of <span class="RktSym">fish%</span> does not include
+<span class="RktSym">get-size</span>, <span class="RktSym">grow</span>, and <span class="RktSym">eat</span> methods, then an
+error is signaled in the evaluation of the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class*</a></span> form,
+because implementing the <span class="RktSym">fish-interface</span> interface requires
+those methods.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objectutils.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._is-a%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">is-a?</a></span> predicate accepts an object as its first argument
+and either a class or interface as its second argument. When given a
+class, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objectutils.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._is-a%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">is-a?</a></span> checks whether the object is an instance of that
+class or a derived class.  When given an interface, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objectutils.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._is-a%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">is-a?</a></span>
+checks whether the object&rsquo;s class implements the interface. In
+addition, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objectutils.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._implementation%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">implementation?</a></span>  predicate checks whether a
+given class implements a given interface.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;inner&quot;">13.5<tt>&nbsp;</tt><a name="(part._inner)"></a>Final, Augment, and Inner</h4><p>As in Java, a method in a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span> form can be specified as
+<span style="font-style: italic">final</span>, which means that a subclass cannot override the
+method.  A final method is declared using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._public-final%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">public-final</a></span> or
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._override-final%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">override-final</a></span>, depending on whether the declaration is for a
+new method or an overriding implementation.</p><p>Between the extremes of allowing arbitrary overriding and disallowing
+overriding entirely, the class system also supports Beta-style
+<span style="font-style: italic">augmentable</span> methods [<a href="doc-bibliography.html#%28cite._.Goldberg04%29" data-pltdoc="x">Goldberg04</a>]. A method
+declared with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._pubment%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">pubment</a></span> is like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._public%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">public</a></span>, but the method
+cannot be overridden in subclasses; it can be augmented only. A
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._pubment%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">pubment</a></span> method must explicitly invoke an augmentation (if any)
+using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inner%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inner</a></span>; a subclass augments the method using
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._augment%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">augment</a></span>, instead of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._override%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">override</a></span>.</p><p>In general, a method can switch between augment and override modes in
+a class derivation. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._augride%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">augride</a></span> method specification
+indicates an augmentation to a method where the augmentation is itself
+overrideable in subclasses (though the superclass&rsquo;s implementation
+cannot be overridden). Similarly, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._overment%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">overment</a></span> overrides a method
+and makes the overriding implementation augmentable.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;extnames&quot;">13.6<tt>&nbsp;</tt><a name="(part._extnames)"></a>Controlling the Scope of External Names</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Java&rsquo;s access modifiers (like <a name="(idx._(gentag._4._(lib._scribblings/guide/guide..scrbl)))"></a><span class="stt">protected</span>)
+play a role similar to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define-member-name%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-member-name</a></span>, but
+unlike in Java, Racket&rsquo;s mechanism for controlling access
+is based on lexical scope, not the inheritance hierarchy.</p></blockquote></blockquote></blockquote><p>As noted in <a href="classes.html#%28part._intnames%29" data-pltdoc="x">Internal and External Names</a>, class members have both
+internal and external names. A member definition binds an internal
+name locally, and this binding can be locally renamed.  External
+names, in contrast, have global scope by default, and a member
+definition does not bind an external name. Instead, a member
+definition refers to an existing binding for an external name, where
+the member name is bound to a <span style="font-style: italic">member key</span>; a class ultimately
+maps member keys to methods, fields, and initialization arguments.</p><p>Recall the <span class="RktSym">hungry-fish%</span> <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span> expression:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hungry-fish%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish%</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eat</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat-more</span><span class="hspace">&nbsp;</span><span class="RktSym">fish1</span><span class="hspace">&nbsp;</span><span class="RktSym">fish2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">fish1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">fish2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>During its evaluation, the <span class="RktSym">hungry-fish%</span> and <span class="RktSym">fish%</span>
+classes refer to the same global binding of <span class="RktSym">eat</span>.  At run
+time, calls to <span class="RktSym">eat</span> in <span class="RktSym">hungry-fish%</span> are matched with
+the <span class="RktSym">eat</span> method in <span class="RktSym">fish%</span> through the shared method
+key that is bound to <span class="RktSym">eat</span>.</p><p>The default binding for an external name is global, but a
+programmer can introduce an external-name binding with the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define-member-name%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-member-name</a></span> form.</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define-member-name%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-member-name</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">member-key-expr</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>In particular, by using <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._generate-member-key%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">generate-member-key</a></span><span class="RktPn">)</span> as the
+<span class="RktSym">member-key-expr</span>, an external name can be localized for a
+particular scope, because the generated member key is inaccessible
+outside the scope. In other words, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define-member-name%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-member-name</a></span> gives
+an external name a kind of package-private scope, but generalized from
+packages to arbitrary binding scopes in Racket.</p><p>For example, the following <span class="RktSym">fish%</span> and <span class="RktSym">pond%</span> classes cooperate
+via a <span class="RktSym">get-depth</span> method that is only accessible to the
+cooperating classes:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish%</span><span class="hspace">&nbsp;</span><span class="RktSym">pond%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">two mutually recursive classes</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define-member-name%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-member-name</a></span><span class="hspace">&nbsp;</span><span class="RktSym">get-depth</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._generate-member-key%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">generate-member-key</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">....</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-depth</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-pond</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dive</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-depth</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._min%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">min</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-depth</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">my-pond</span><span class="hspace">&nbsp;</span><span class="RktSym">get-depth</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pond%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">....</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">current-depth</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-depth</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">current-depth</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish%</span><span class="hspace">&nbsp;</span><span class="RktSym">pond%</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>External names are in a namespace that separates them from other Racket
+names. This separate namespace is implicitly used for the method name in
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span>, for initialization-argument names in <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span>, or for
+the external name in a member definition.  The special form
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._member-name-key%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">member-name-key</a></span> provides access to the binding of an external name
+in an arbitrary expression position: <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._member-name-key%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">member-name-key</a></span><span class="stt"> </span><span class="RktSym">id</span><span class="RktPn">)</span>
+produces the member-key binding of <span class="RktSym">id</span> in the current scope.</p><p>A member-key value is primarily used with a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define-member-name%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-member-name</a></span> form. Normally, then,
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._member-name-key%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">member-name-key</a></span><span class="stt"> </span><span class="RktSym">id</span><span class="RktPn">)</span> captures the method key of <span class="RktSym">id</span>
+so that it can be communicated to a use of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define-member-name%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-member-name</a></span>
+in a different scope. This capability turns out to be useful for
+generalizing mixins, as discussed next.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Mixins&quot;">13.7<tt>&nbsp;</tt><a name="(part._.Mixins)"></a>Mixins</h4><p>Since <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span> is an expression form instead of a top-level
+declaration as in Smalltalk and Java, a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span> form can be
+nested inside any lexical scope, including <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span>. The result
+is a <a name="(tech._mixin)"></a><span style="font-style: italic">mixin</span>, i.e., a class extension that is parameterized
+with respect to its superclass.</p><p>For example, we can parameterize the <span class="RktSym">picky-fish%</span> class over
+its superclass to define <span class="RktSym">picky-mixin</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">picky-mixin</span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Foverride%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/override</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">grow</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super</a></span><span class="hspace">&nbsp;</span><span class="RktSym">grow</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3/4</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">picky-fish%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">picky-mixin</span><span class="hspace">&nbsp;</span><span class="RktSym">fish%</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Many small differences between Smalltalk-style classes and Racket
+classes contribute to the effective use of mixins. In particular, the
+use of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Foverride%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/override</a></span> makes explicit that
+<span class="RktSym">picky-mixin</span> expects a class with a <span class="RktSym">grow</span> method. If
+<span class="RktSym">picky-mixin</span> is applied to a class without a <span class="RktSym">grow</span>
+method, an error is signaled as soon as <span class="RktSym">picky-mixin</span> is
+applied.</p><p>Similarly, a use of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit</a></span> enforces a &ldquo;method existence&rdquo;
+requirement when the mixin is applied:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hungry-mixin</span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eat</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat-more</span><span class="hspace">&nbsp;</span><span class="RktSym">fish1</span><span class="hspace">&nbsp;</span><span class="RktSym">fish2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">fish1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">fish2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The advantage of mixins is that we can easily combine them to create
+new classes whose implementation sharing does not fit into a
+single-inheritance hierarchy&#8212;<wbr></wbr>without the ambiguities associated with
+multiple inheritance. Equipped with <span class="RktSym">picky-mixin</span> and
+<span class="RktSym">hungry-mixin</span>, creating a class for a hungry, yet picky fish
+is straightforward:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">picky-hungry-fish%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hungry-mixin</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">picky-mixin</span><span class="hspace">&nbsp;</span><span class="RktSym">fish%</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The use of keyword initialization arguments is critical for the easy
+use of mixins. For example, <span class="RktSym">picky-mixin</span> and
+<span class="RktSym">hungry-mixin</span> can augment any class with suitable <span class="RktSym">eat</span>
+and <span class="RktSym">grow</span> methods, because they do not specify initialization
+arguments and add none in their <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span> expressions:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">person%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._object%7E25%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._init%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">init</a></span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktSym">age</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">....</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">food</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">grow</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">child%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hungry-mixin</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">picky-mixin</span><span class="hspace">&nbsp;</span><span class="RktSym">person%</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">oliver</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">child%</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktVal">"Oliver"</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">age</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Finally, the use of external names for class members (instead of
+lexically scoped identifiers) makes mixin use convenient. Applying
+<span class="RktSym">picky-mixin</span> to <span class="RktSym">person%</span> works because the names
+<span class="RktSym">eat</span> and <span class="RktSym">grow</span> match, without any a priori declaration
+that <span class="RktSym">eat</span> and <span class="RktSym">grow</span> should be the same method in
+<span class="RktSym">fish%</span> and <span class="RktSym">person%</span>. This feature is a potential
+drawback when member names collide accidentally; some accidental
+collisions can be corrected by limiting the scope external names, as
+discussed in <a href="classes.html#%28part._extnames%29" data-pltdoc="x">Controlling the Scope of External Names</a>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Mixins_and_Interfaces&quot;">13.7.1<tt>&nbsp;</tt><a name="(part._.Mixins_and_.Interfaces)"></a>Mixins and Interfaces</h5><p>Using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objectutils.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._implementation%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">implementation?</a></span>, <span class="RktSym">picky-mixin</span> could require
+that its base class implements <span class="RktSym">grower-interface</span>, which could
+be implemented by both <span class="RktSym">fish%</span> and <span class="RktSym">person%</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">grower-interface</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createinterface.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._interface%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">interface</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">grow</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">picky-mixin</span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._unless%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objectutils.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._implementation%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">implementation?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="hspace">&nbsp;</span><span class="RktSym">grower-interface</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"picky-mixin: not a grower-interface class"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Another use of interfaces with a mixin is to tag classes generated by
+the mixin, so that instances of the mixin can be recognized. In other
+words, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objectutils.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._is-a%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">is-a?</a></span> cannot work on a mixin represented as a
+function, but it can recognize an interface (somewhat like a
+<span style="font-style: italic">specialization interface</span>) that is consistently implemented
+by the mixin.  For example, classes generated by <span class="RktSym">picky-mixin</span>
+could be tagged with <span class="RktSym">picky-interface</span>, enabling the
+<span class="RktSym">is-picky?</span> predicate:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">picky-interface</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createinterface.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._interface%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">interface</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">picky-mixin</span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._unless%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objectutils.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._implementation%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">implementation?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="hspace">&nbsp;</span><span class="RktSym">grower-interface</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"picky-mixin: not a grower-interface class"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">picky-interface</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">is-picky?</span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objectutils.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._is-a%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">is-a?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="hspace">&nbsp;</span><span class="RktSym">picky-interface</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;The_mixin_Form&quot;">13.7.2<tt>&nbsp;</tt><a name="(part._.The_mixin_.Form)"></a>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=mixins.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._mixin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">mixin</a></span> Form</h5><p>To codify the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span>-plus-<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span> pattern for
+implementing mixins, including the use of interfaces for the domain
+and range of the mixin, the class system provides a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=mixins.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._mixin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">mixin</a></span>
+macro:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=mixins.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._mixin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">mixin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">interface-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">interface-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">decl-or-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote><p>The first set of <span class="RktSym">interface-expr</span>s determines the domain of the
+mixin, and the second set determines the range. That is, the expansion
+is a function that tests whether a given base class implements the
+first sequence of <span class="RktSym">interface-expr</span>s and produces a class that
+implements the second sequence of <span class="RktSym">interface-expr</span>s. Other
+requirements, such as the presence of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit</a></span>ed methods in
+the superclass, are then checked for the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span> expansion of
+the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=mixins.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._mixin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">mixin</a></span> form.  For example:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">choosy-interface</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createinterface.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._interface%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">interface</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">choose?</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hungry-interface</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createinterface.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._interface%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">interface</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">eat</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">choosy-eater-mixin</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=mixins.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._mixin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">mixin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">choosy-interface</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hungry-interface</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit</a></span><span class="hspace">&nbsp;</span><span class="RktSym">choose?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">choose?</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"chomp chomp chomp on ~a.\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"I'm not crazy about ~a.\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">herring-lover%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class*</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._object%7E25%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">object%</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">choosy-interface</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">choose?</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"^herring"</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">herring-eater%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">choosy-eater-mixin</span><span class="hspace">&nbsp;</span><span class="RktSym">herring-lover%</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eater</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">herring-eater%</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eater</span><span class="hspace">&nbsp;</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktVal">"elderberry"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">I'm not crazy about elderberry.</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eater</span><span class="hspace">&nbsp;</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktVal">"herring"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">chomp chomp chomp on herring.</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eater</span><span class="hspace">&nbsp;</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktVal">"herring ice cream"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">chomp chomp chomp on herring ice cream.</span></p></td></tr></table></blockquote><p>Mixins not only override methods and introduce public methods, they
+can also augment methods, introduce augment-only methods, add an
+overrideable augmentation, and add an augmentable override &#8212;<wbr></wbr> all of
+the things that a class can do (see <a href="classes.html#%28part._inner%29" data-pltdoc="x">Final, Augment, and Inner</a>).</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parammixins&quot;">13.7.3<tt>&nbsp;</tt><a name="(part._parammixins)"></a>Parameterized Mixins</h5><p>As noted in <a href="classes.html#%28part._extnames%29" data-pltdoc="x">Controlling the Scope of External Names</a>, external names can be bound with
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define-member-name%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-member-name</a></span>. This facility allows a mixin to be
+generalized with respect to the methods that it defines and uses.  For
+example, we can parameterize <span class="RktSym">hungry-mixin</span> with respect to the
+external member key for <span class="RktSym">eat</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-hungry-mixin</span><span class="hspace">&nbsp;</span><span class="RktSym">eat-method-key</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define-member-name%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-member-name</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">eat-method-key</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=mixins.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._mixin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">mixin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eat</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat-more</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>To obtain a particular hungry-mixin, we must apply this function to a
+member key that refers to a suitable
+<span class="RktSym">eat</span> method, which we can obtain using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._member-name-key%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">member-name-key</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">make-hungry-mixin</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._member-name-key%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">member-name-key</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eat</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._object%7E25%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">object%</a></span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yum</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Above, we apply <span class="RktSym">hungry-mixin</span> to an anonymous class that provides
+<span class="RktSym">eat</span>, but we can also combine it with a class that provides
+<span class="RktSym">chomp</span>, instead:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">make-hungry-mixin</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._member-name-key%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">member-name-key</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chomp</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._object%7E25%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">object%</a></span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">chomp</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yum</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Traits&quot;">13.8<tt>&nbsp;</tt><a name="(part._.Traits)"></a>Traits</h4><p>A <span style="font-style: italic">trait</span> is similar to a mixin, in that it encapsulates a set
+of methods to be added to a class. A trait is different from a mixin
+in that its individual methods can be manipulated with trait operators
+such as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528def._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-sum%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">trait-sum</a></span> (merge the methods of two traits), <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528form._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-exclude%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">trait-exclude</a></span>
+(remove a method from a trait), and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528form._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-alias%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">trait-alias</a></span> (add a copy of a
+method with a new name; do not redirect any calls to the old name).</p><p>The practical difference between mixins and traits is that two traits
+can be combined, even if they include a common method and even if
+neither method can sensibly override the other. In that case, the
+programmer must explicitly resolve the collision, usually by aliasing
+methods, excluding methods, and merging a new trait that uses the
+aliases.</p><p>Suppose our <span class="RktSym">fish%</span> programmer wants to define two class
+extensions, <span class="RktSym">spots</span> and <span class="RktSym">stripes</span>, each of which
+includes a <span class="RktSym">get-color</span> method. The fish&rsquo;s spot color should not
+override the stripe color nor vice versa; instead, a
+<span class="RktSym">spots+stripes-fish%</span> should combine the two colors, which is
+not possible if <span class="RktSym">spots</span> and <span class="RktSym">stripes</span> are implemented as
+plain mixins. If, however, <span class="RktSym">spots</span> and <span class="RktSym">stripes</span> are
+implemented as traits, they can be combined. First, we alias
+<span class="RktSym">get-color</span> in each trait to a non-conflicting name. Second,
+the <span class="RktSym">get-color</span> methods are removed from both and the traits
+with only aliases are merged. Finally, the new trait is used to create
+a class that introduces its own <span class="RktSym">get-color</span> method based on the
+two aliases, producing the desired <span class="RktSym">spots+stripes</span> extension.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Traits_as_Sets_of_Mixins&quot;">13.8.1<tt>&nbsp;</tt><a name="(part._.Traits_as_.Sets_of_.Mixins)"></a>Traits as Sets of Mixins</h5><p>One natural approach to implementing traits in Racket is as a set
+of mixins, with one mixin per trait method.  For example, we might
+attempt to define the spots and stripes traits as follows, using
+association lists to represent sets:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">spots-trait</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">get-color</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-color</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">black</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stripes-trait</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">get-color</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-color</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">red</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>A set representation, such as the above, allows <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528def._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-sum%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">trait-sum</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528form._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-exclude%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">trait-exclude</a></span> as simple manipulations; unfortunately, it does
+not support the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528form._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-alias%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">trait-alias</a></span> operator. Although a mixin can be
+duplicated in the association list, the mixin has a fixed method name,
+e.g., <span class="RktSym">get-color</span>, and mixins do not support a method-rename
+operation. To support <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528form._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-alias%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">trait-alias</a></span>, we must parameterize the
+mixins over the external method name in the same way that <span class="RktSym">eat</span>
+was parameterized in <a href="classes.html#%28part._parammixins%29" data-pltdoc="x">Parameterized Mixins</a>.</p><p>To support the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528form._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-alias%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">trait-alias</a></span> operation, <span class="RktSym">spots-trait</span>
+should be represented as:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">spots-trait</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._member-name-key%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">member-name-key</a></span><span class="hspace">&nbsp;</span><span class="RktSym">get-color</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-color-key</span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define-member-name%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-member-name</a></span><span class="hspace">&nbsp;</span><span class="RktSym">get-color</span><span class="hspace">&nbsp;</span><span class="RktSym">get-color-key</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">black</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>When the <span class="RktSym">get-color</span> method in <span class="RktSym">spots-trait</span> is aliased
+to <span class="RktSym">get-trait-color</span> and the <span class="RktSym">get-color</span> method is
+removed, the resulting trait is the same as</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._member-name-key%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">member-name-key</a></span><span class="hspace">&nbsp;</span><span class="RktSym">get-trait-color</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-color-key</span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define-member-name%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-member-name</a></span><span class="hspace">&nbsp;</span><span class="RktSym">get-color</span><span class="hspace">&nbsp;</span><span class="RktSym">get-color-key</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">black</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>To apply a trait <span class="RktVar">T</span> to a class <span class="RktVar">C</span> and obtain a derived
+class, we use <span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528def._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-%7E3emixin%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">trait-&gt;mixin</a></span><span class="stt"> </span><span class="RktVar">T</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVar">C</span><span class="RktPn">)</span>. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528def._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-%7E3emixin%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">trait-&gt;mixin</a></span>
+function supplies each mixin of <span class="RktVar">T</span> with the key for the mixin&rsquo;s
+method and a partial extension of <span class="RktVar">C</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528def._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-%7E3emixin%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">trait-&gt;mixin</a></span><span class="hspace">&nbsp;</span><span class="RktSym">T</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">C</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._foldr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">foldr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">C</span><span class="hspace">&nbsp;</span><span class="RktSym">T</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Thus, when the trait above is combined with other traits and then
+applied to a class, the use of <span class="RktSym">get-color</span> becomes a reference
+to the external name <span class="RktSym">get-trait-color</span>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Inherit_and_Super_in_Traits&quot;">13.8.2<tt>&nbsp;</tt><a name="(part._.Inherit_and_.Super_in_.Traits)"></a>Inherit and Super in Traits</h5><p>This first implementation of traits supports <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528form._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-alias%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">trait-alias</a></span>, and it
+ supports a trait method that calls itself, but it does not support
+ trait methods that call each other. In particular, suppose that a spot-fish&rsquo;s
+ market value depends on the color of its spots:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">spots-trait</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._member-name-key%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">member-name-key</a></span><span class="hspace">&nbsp;</span><span class="RktSym">get-color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._member-name-key%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">member-name-key</a></span><span class="hspace">&nbsp;</span><span class="RktSym">get-price</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-price</span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-price</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">....</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>In this case, the definition of <span class="RktSym">spots-trait</span> fails, because
+<span class="RktSym">get-color</span> is not in scope for the <span class="RktSym">get-price</span>
+mixin. Indeed, depending on the order of mixin application when the
+trait is applied to a class, the <span class="RktSym">get-color</span> method may not be
+available when <span class="RktSym">get-price</span> mixin is applied to the class.
+Therefore adding an <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit</a></span><span class="stt"> </span><span class="RktSym">get-color</span><span class="RktPn">)</span> declaration to the
+<span class="RktSym">get-price</span> mixin does not solve the problem.</p><p>One solution is to require the use of <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="stt"> </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._this%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">this</a></span><span class="stt"> </span><span class="RktSym">get-color</span><span class="RktPn">)</span> in
+methods such as <span class="RktSym">get-price</span>. This change works because
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span> always delays the method lookup until the method call is
+evaluated. The delayed lookup is more expensive than a direct call,
+however. Worse, it also delays checking whether a <span class="RktSym">get-color</span> method
+even exists.</p><p>A second, effective, and efficient solution is to change the encoding
+of traits. Specifically, we represent each method as a pair of mixins:
+one that introduces the method and one that implements it. When a
+trait is applied to a class, all of the method-introducing mixins are
+applied first. Then the method-implementing mixins can use
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit</a></span> to directly access any introduced method.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">spots-trait</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">local-member-name-key</span><span class="hspace">&nbsp;</span><span class="RktSym">get-color</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-color</span><span class="hspace">&nbsp;</span><span class="RktSym">get-price</span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-color</span><span class="hspace">&nbsp;</span><span class="RktSym">get-price</span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Foverride%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/override</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">black</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">local-member-name-key</span><span class="hspace">&nbsp;</span><span class="RktSym">get-price</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-price</span><span class="hspace">&nbsp;</span><span class="RktSym">get-color</span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-price</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-color</span><span class="hspace">&nbsp;</span><span class="RktSym">get-price</span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">%</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit</a></span><span class="hspace">&nbsp;</span><span class="RktSym">get-color</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Foverride%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/override</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-price</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">....</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>With this trait encoding, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528form._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-alias%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">trait-alias</a></span> adds a new method with
+a new name, but it does not change any references to the old method.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;The_trait_Form&quot;">13.8.3<tt>&nbsp;</tt><a name="(part._.The_trait_.Form)"></a>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528form._%2528%2528lib._racket%252Ftrait..rkt%2529._trait%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">trait</a></span> Form</h5><p>The general-purpose trait pattern is clearly too complex for a
+programmer to use directly, but it is easily codified in a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528form._%2528%2528lib._racket%252Ftrait..rkt%2529._trait%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">trait</a></span> macro:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528form._%2528%2528lib._racket%252Ftrait..rkt%2529._trait%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">trait</a></span><span class="hspace">&nbsp;</span><span class="RktVar">trait-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>The <span class="RktSym">id</span>s in the optional <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit</a></span> clause are available for direct
+reference in the method <span class="RktSym">expr</span>s, and they must be supplied
+either by other traits or the base class to which
+the trait is ultimately applied.</p><p>Using this form in conjunction with trait operators such as
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528def._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-sum%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">trait-sum</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528form._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-exclude%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">trait-exclude</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528form._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-alias%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">trait-alias</a></span>, and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528def._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-%7E3emixin%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">trait-&gt;mixin</a></span>, we can implement <span class="RktSym">spots-trait</span> and
+<span class="RktSym">stripes-trait</span> as desired.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">spots-trait</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528form._%2528%2528lib._racket%252Ftrait..rkt%2529._trait%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">trait</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">black</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-price</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stripes-trait</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528form._%2528%2528lib._racket%252Ftrait..rkt%2529._trait%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">trait</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">red</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">spots+stripes-trait</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528def._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-sum%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">trait-sum</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528form._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-exclude%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">trait-exclude</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528form._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-alias%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">trait-alias</a></span><span class="hspace">&nbsp;</span><span class="RktSym">spots-trait</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">get-color</span><span class="hspace">&nbsp;</span><span class="RktSym">get-spots-color</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">get-color</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528form._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-exclude%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">trait-exclude</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528form._%2528%2528lib._racket%252Ftrait..rkt%2529._trait-alias%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">trait-alias</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stripes-trait</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">get-color</span><span class="hspace">&nbsp;</span><span class="RktSym">get-stripes-color</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">get-color</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=trait.html%23%2528form._%2528%2528lib._racket%252Ftrait..rkt%2529._trait%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">trait</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit</a></span><span class="hspace">&nbsp;</span><span class="RktSym">get-spots-color</span><span class="hspace">&nbsp;</span><span class="RktSym">get-stripes-color</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-color</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">....</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-spots-color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-stripes-color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Class_Contracts&quot;">13.9<tt>&nbsp;</tt><a name="(part._.Class_.Contracts)"></a>Class Contracts</h4><p>As classes are values, they can flow across contract boundaries, and we
+may wish to protect parts of a given class with contracts.  For this,
+the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Object_and_Class_Contracts.html%23%2528form._%2528%2528lib._racket%252Fclass..rkt%2529._class%252Fc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class/c</a></span> form is used.  The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Object_and_Class_Contracts.html%23%2528form._%2528%2528lib._racket%252Fclass..rkt%2529._class%252Fc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class/c</a></span> form has many
+subforms, which describe two types of contracts on fields and methods:
+those that affect uses via instantiated objects and those that affect
+subclasses.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;External_Class_Contracts&quot;">13.9.1<tt>&nbsp;</tt><a name="(part._.External_.Class_.Contracts)"></a>External Class Contracts</h5><p>In its simplest form, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Object_and_Class_Contracts.html%23%2528form._%2528%2528lib._racket%252Fclass..rkt%2529._class%252Fc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class/c</a></span> protects the public fields and methods
+of objects instantiated from the contracted class.  There is also an
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Object_and_Class_Contracts.html%23%2528form._%2528%2528lib._racket%252Fclass..rkt%2529._object%252Fc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">object/c</a></span> form that can be used to similarly protect the public fields
+and methods of a particular object. Take the following definition of
+<span class="RktSym">animal%</span>, which uses a public field for its <span class="RktSym">size</span> attribute:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">animal%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._object%7E25%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._field%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">food</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._get-field%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">get-field</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktSym">food</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>For any instantiated <span class="RktSym">animal%</span>, accessing the <span class="RktSym">size</span> field
+should return a positive number.  Also, if the <span class="RktSym">size</span> field is set,
+it should be assigned a positive number.  Finally, the <span class="RktSym">eat</span> method
+should receive an argument which is an object with a <span class="RktSym">size</span> field
+that contains a positive number. To ensure these conditions, we will define
+the <span class="RktSym">animal%</span> class with an appropriate contract:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">positive/c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._positive%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">positive?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">edible/c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Object_and_Class_Contracts.html%23%2528form._%2528%2528lib._racket%252Fclass..rkt%2529._object%252Fc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">object/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._field%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktSym">positive/c</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">animal%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Object_and_Class_Contracts.html%23%2528form._%2528%2528lib._racket%252Fclass..rkt%2529._class%252Fc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._field%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktSym">positive/c</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Object_and_Class_Contracts.html%23%2528form._%2528%2528lib._racket%252Fclass..rkt%2529._-%7E3em%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>m</a></span><span class="hspace">&nbsp;</span><span class="RktSym">edible/c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._object%7E25%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">object%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._field%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">food</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._get-field%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">get-field</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktSym">food</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Here we use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Object_and_Class_Contracts.html%23%2528form._%2528%2528lib._racket%252Fclass..rkt%2529._-%7E3em%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>m</a></span> to describe the behavior of <span class="RktSym">eat</span> since we
+do not need to describe any requirements for the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._this%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">this</a></span> parameter.
+Now that we have our contracted class, we can see that the contracts
+on both <span class="RktSym">size</span> and <span class="RktSym">eat</span> are enforced:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bob</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">animal%</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._set-field%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set-field!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktSym">bob</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._get-field%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">get-field</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktSym">bob</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._set-field%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set-field!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktSym">bob</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">large</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">animal%: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: positive/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 'large</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the size field in</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(class/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(eat</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt;m</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(object/c (field (size positive/c)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">void?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(field (size positive/c)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition animal%)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:31:0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">richie</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">animal%</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bob</span><span class="hspace">&nbsp;</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">richie</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._get-field%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">get-field</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktSym">bob</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">13</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rock</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._object%7E25%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">object%</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bob</span><span class="hspace">&nbsp;</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">rock</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">eat: contract violation;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">no public field size</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">the eat method in</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(class/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(eat</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt;m</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(object/c (field (size positive/c)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">void?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(field (size positive/c)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition animal%)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract on: animal%</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:31:0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">giant</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._object%7E25%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">object%</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._field%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">large</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bob</span><span class="hspace">&nbsp;</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">giant</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">eat: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: positive/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 'large</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the size field in</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">the eat method in</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(class/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(eat</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt;m</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(object/c (field (size positive/c)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">void?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(field (size positive/c)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition animal%)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract on: animal%</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:31:0</span></p></td></tr></table></blockquote><p>There are two important caveats for external class contracts. First,
+external method contracts are only enforced when the target of dynamic
+dispatch is the method implementation of the contracted class, which
+lies within the contract boundary.  Overriding that implementation, and
+thus changing the target of dynamic dispatch, will mean that the contract
+is no longer enforced for clients, since accessing the method no longer
+crosses the contract boundary.  Unlike external method contracts, external
+field contracts are always enforced for clients of subclasses, since fields
+cannot be overridden or shadowed.</p><p>Second, these contracts do not restrict subclasses of <span class="RktSym">animal%</span>
+in any way.  Fields and methods that are inherited and used by subclasses
+are not checked by these contracts, and uses of the superclass&rsquo;s methods
+via <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super</a></span> are also unchecked.  The following example illustrates
+both caveats:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">large-animal%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">animal%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit-field%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit-field</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">large</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Foverride%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/override</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">food</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Nom nom nom"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Output.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._newline%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">newline</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">elephant</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">large-animal%</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">elephant</span><span class="hspace">&nbsp;</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._object%7E25%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">object%</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Nom nom nom</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._get-field%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">get-field</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktSym">elephant</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">animal%: broke its own contract</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">promised: positive/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">produced: 'large</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the size field in</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(class/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(eat</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt;m</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(object/c (field (size positive/c)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">void?))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(field (size positive/c)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition animal%)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition animal%)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:31:0</span></p></td></tr></table></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Internal_Class_Contracts&quot;">13.9.2<tt>&nbsp;</tt><a name="(part._.Internal_.Class_.Contracts)"></a>Internal Class Contracts</h5><p>Notice that retrieving the <span class="RktSym">size</span> field from the object
+<span class="RktSym">elephant</span> blames <span class="RktSym">animal%</span> for the contract violation.
+This blame is correct, but unfair to the <span class="RktSym">animal%</span> class,
+as we have not yet provided it with a method for protecting itself from
+subclasses.  To this end we add internal class contracts, which
+provide directives to subclasses for how they may access and override
+features of the superclass.  This distinction between external and internal
+class contracts allows for weaker contracts within the class hierarchy, where
+invariants may be broken internally by subclasses but should be enforced
+for external uses via instantiated objects.</p><p>As a simple example of what kinds of protection are available, we provide
+an example aimed at the <span class="RktSym">animal%</span> class that uses all the applicable
+forms:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Object_and_Class_Contracts.html%23%2528form._%2528%2528lib._racket%252Fclass..rkt%2529._class%252Fc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._field%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktSym">positive/c</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit-field%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit-field</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktSym">positive/c</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Object_and_Class_Contracts.html%23%2528form._%2528%2528lib._racket%252Fclass..rkt%2529._-%7E3em%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>m</a></span><span class="hspace">&nbsp;</span><span class="RktSym">edible/c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Object_and_Class_Contracts.html%23%2528form._%2528%2528lib._racket%252Fclass..rkt%2529._-%7E3em%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>m</a></span><span class="hspace">&nbsp;</span><span class="RktSym">edible/c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Object_and_Class_Contracts.html%23%2528form._%2528%2528lib._racket%252Fclass..rkt%2529._-%7E3em%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>m</a></span><span class="hspace">&nbsp;</span><span class="RktSym">edible/c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._override%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">override</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Object_and_Class_Contracts.html%23%2528form._%2528%2528lib._racket%252Fclass..rkt%2529._-%7E3em%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>m</a></span><span class="hspace">&nbsp;</span><span class="RktSym">edible/c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>This class contract not only ensures that objects of class <span class="RktSym">animal%</span>
+are protected as before, but also ensure that subclasses of <span class="RktSym">animal%</span>
+only store appropriate values within the <span class="RktSym">size</span> field and use
+the implementation of <span class="RktSym">size</span> from <span class="RktSym">animal%</span> appropriately.
+These contract forms only affect uses within the class hierarchy, and only
+for method calls that cross the contract boundary.</p><p>That means that <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit</a></span> will only affect subclass uses of a method
+until a subclass overrides that method, and that <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._override%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">override</a></span> only
+affects calls from the superclass into a subclass&rsquo;s overriding implementation
+of that method.  Since these only affect internal uses, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._override%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">override</a></span>
+form does not automatically enter subclasses into obligations when objects of
+those classes are used.  Also, use of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._override%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">override</a></span> only makes sense, and
+thus can only be used, for methods where no Beta-style augmentation has taken
+place. The following example shows this difference:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sloppy-eater%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Object_and_Class_Contracts.html%23%2528form._%2528%2528lib._racket%252Fclass..rkt%2529._class%252Fc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Object_and_Class_Contracts.html%23%2528form._%2528%2528lib._racket%252Fclass..rkt%2529._-%7E3em%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>m</a></span><span class="hspace">&nbsp;</span><span class="RktSym">edible/c</span><span class="hspace">&nbsp;</span><span class="RktSym">edible/c</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">glutton%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Object_and_Class_Contracts.html%23%2528form._%2528%2528lib._racket%252Fclass..rkt%2529._class%252Fc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._override%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">override</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Object_and_Class_Contracts.html%23%2528form._%2528%2528lib._racket%252Fclass..rkt%2529._-%7E3em%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>m</a></span><span class="hspace">&nbsp;</span><span class="RktSym">edible/c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">animal%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit</a></span><span class="hspace">&nbsp;</span><span class="RktSym">eat</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Fpublic%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/public</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gulp</span><span class="hspace">&nbsp;</span><span class="RktSym">food-list</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">food-list</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span><span class="hspace">&nbsp;</span><span class="RktSym">glutton%</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super-new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super-new</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inherit-field%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inherit-field</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._define%252Foverride%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/override</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">food-size</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._get-field%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">get-field</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktSym">food-size</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._set-field%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set-field!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktSym">food-size</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pig</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sloppy-eater%</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">slop1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">animal%</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">slop2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">animal%</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">slop3</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym">animal%</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pig</span><span class="hspace">&nbsp;</span><span class="RktSym">eat</span><span class="hspace">&nbsp;</span><span class="RktSym">slop1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(object:animal% ...)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._get-field%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">get-field</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktSym">slop1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pig</span><span class="hspace">&nbsp;</span><span class="RktSym">gulp</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">slop1</span><span class="hspace">&nbsp;</span><span class="RktSym">slop2</span><span class="hspace">&nbsp;</span><span class="RktSym">slop3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">eat: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: void?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: (object:animal% ...)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the range of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">the eat method in</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(class/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(override (eat</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt;m</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(object/c</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(field (size positive/c)))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">void?))))</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (definition glutton%)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract on: glutton%</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (definition sloppy-eater%)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:47:0</span></p></td></tr></table></blockquote><p>In addition to the internal class contract forms shown here, there are
+similar forms for Beta-style augmentable methods.  The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inner%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inner</a></span>
+form describes to the subclass what is expected from augmentations of
+a given method.  Both <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._augment%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">augment</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._augride%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">augride</a></span> tell the
+subclass that the given method is a method which has been augmented and
+that any calls to the method in the subclass will dynamically
+dispatch to the appropriate implementation in the superclass.  Such
+calls will be checked according to the given contract.  The two forms
+differ in that  use of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._augment%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">augment</a></span> signifies that subclasses can
+augment the given method, whereas use of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._augride%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">augride</a></span> signifies that
+subclasses must override the current augmentation instead.</p><p>This means that not all forms can be used at the same time.  Only one of the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._override%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">override</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._augment%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">augment</a></span>, and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._augride%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">augride</a></span> forms can be used
+for a given method, and none of these forms can be used if the given method
+has been finalized.  In addition, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._super%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">super</a></span> can be specified for a given
+method only if <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._augride%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">augride</a></span> or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._override%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">override</a></span> can be specified.
+Similarly, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._inner%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">inner</a></span> can be specified only if <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._augment%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">augment</a></span> or
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._augride%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">augride</a></span> can be specified.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="match.html" title="backward to &quot;12 Pattern Matching&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="units.html" title="forward to &quot;14 Units (Components)&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/cmdline-tools.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/cmdline-tools.html
new file mode 100644
index 00000000..8d030f4d
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/cmdline-tools.html
@@ -0,0 +1,27 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>24.1&nbsp;Command-Line Tools</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewselflink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">24.1&nbsp;</td><td><a href="cmdline-tools.html" class="tocviewselflink" data-pltdoc="x">Command-<wbr></wbr>Line Tools</a></td></tr><tr><td align="right">24.2&nbsp;</td><td><a href="Emacs.html" class="tocviewlink" data-pltdoc="x">Emacs</a></td></tr><tr><td align="right">24.3&nbsp;</td><td><a href="Vim.html" class="tocviewlink" data-pltdoc="x">Vim</a></td></tr><tr><td align="right">24.4&nbsp;</td><td><a href="Sublime_Text.html" class="tocviewlink" data-pltdoc="x">Sublime Text</a></td></tr><tr><td align="right">24.5&nbsp;</td><td><a href="Visual_Studio_Code.html" class="tocviewlink" data-pltdoc="x">Visual Studio Code</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>24.1&nbsp;</td><td><a href="cmdline-tools.html" class="tocviewselflink" data-pltdoc="x">Command-<wbr></wbr>Line Tools</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">24.1.1&nbsp;</td><td><a href="cmdline-tools.html#%28part._compile%29" class="tocviewlink" data-pltdoc="x">Compilation and Configuration:<span class="mywbr"> &nbsp;</span> <span class="stt">raco</span></a></td></tr><tr><td align="right">24.1.2&nbsp;</td><td><a href="cmdline-tools.html#%28part._.Interactive_evaluation%29" class="tocviewlink" data-pltdoc="x">Interactive evaluation</a></td></tr><tr><td align="right">24.1.3&nbsp;</td><td><a href="cmdline-tools.html#%28part._.Shell_completion%29" class="tocviewlink" data-pltdoc="x">Shell completion</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">24.1.1<tt>&nbsp;</tt></span><a href="cmdline-tools.html#%28part._compile%29" class="tocsubseclink" data-pltdoc="x">Compilation and Configuration:<span class="mywbr"> &nbsp;</span> <span class="stt">raco</span></a></td></tr><tr><td><span class="tocsublinknumber">24.1.2<tt>&nbsp;</tt></span><a href="cmdline-tools.html#%28part._.Interactive_evaluation%29" class="tocsubseclink" data-pltdoc="x">Interactive evaluation</a></td></tr><tr><td><span class="tocsublinknumber">24.1.3<tt>&nbsp;</tt></span><a href="cmdline-tools.html#%28part._.Shell_completion%29" class="tocsubseclink" data-pltdoc="x">Shell completion</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="versionbox"><span class="version">8.6</span></div><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="other-editors.html" title="backward to &quot;24 Command-Line Tools and Your Editor of Choice&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="other-editors.html" title="up to &quot;24 Command-Line Tools and Your Editor of Choice&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Emacs.html" title="forward to &quot;24.2 Emacs&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;cmdline-tools&quot;">24.1<tt>&nbsp;</tt><a name="(part._cmdline-tools)"></a>Command-Line Tools</h4><p>Racket provides, as part of its standard distribution, a number of
+command-line tools that can make racketeering more pleasant.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;compile&quot;">24.1.1<tt>&nbsp;</tt><a name="(part._compile)"></a>Compilation and Configuration: <span class="stt">raco</span></h5><p>The <span class="stt">raco</span> (short for &ldquo;<span style="font-weight: bold">Ra</span>cket <span style="font-weight: bold">co</span>mmand&rdquo;) program
+provides a command-line interface to many additional tools for
+compiling Racket programs and maintaining a Racket installation.</p><ul><li><p><span class="stt">raco make</span> compiles Racket source to bytecode.</p><p>For example, if you have a program <span class="stt">"take-over-world.rkt"</span> and
+you&rsquo;d like to compile it to bytecode, along with all of its
+dependencies, so that it loads more quickly, then run</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">raco make take-over-the-world.rkt</span></p><p>The bytecode file is written as <span class="stt">"take-over-the-world_rkt.zo"</span>
+in a <span class="stt">"compiled"</span> subdirectory; <a name="(idx._(gentag._10._(lib._scribblings/guide/guide..scrbl)))"></a><span class="stt">".zo"</span>
+is the file suffix for a bytecode file.</p></li><li><p><span class="stt">raco setup</span> manages a Racket installation, including
+manually installed packages.</p><p>For example, if you create your own library <a href="module-basics.html#%28tech._collection%29" data-pltdoc="x">collection</a>
+called <span class="stt">"take-over"</span>, and you&rsquo;d like to build all bytecode and
+documentation for the collection, then run</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">raco setup take-over</span></p></li><li><p><span class="stt">raco pkg</span> manages <a href="module-basics.html#%28tech._package%29" class="techoutside" data-pltdoc="x"><span class="techinside">package</span></a>s that can be installed
+through the Racket package manager.</p><p>For example, to see the list of installed packages run:</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">raco pkg show</span></p><p>To install a new package named <span class="stt">&lt;package-name&gt;</span> run:</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">raco pkg install &lt;package-name&gt;</span></p><p>See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=pkg&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">Package Management in Racket</a> for more details
+about package management.</p></li></ul><p>For more information on <span class="stt">raco</span>, see <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x"><span class="stt">raco</span>: Racket Command-Line Tools</a>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Interactive_evaluation&quot;">24.1.2<tt>&nbsp;</tt><a name="(part._.Interactive_evaluation)"></a>Interactive evaluation</h5><p>The Racket REPL provides everything you expect from a modern interactive
+environment. For example, it provides an <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=xrepl&amp;rel=index.html%23%2528xrepl._enter%2529&amp;version=8.6" class="plainlink Sq" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">,enter</span><span class="hspace"></span></span></a> command to have a
+REPL that runs in the context of a given module, and an <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=xrepl&amp;rel=index.html%23%2528xrepl._edit%2529&amp;version=8.6" class="plainlink Sq" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">,edit</span><span class="hspace"></span></span></a> command
+to invoke your editor (as specified by the <span class="stt">EDITOR</span> environment
+variable) on the file you entered. A <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=xrepl&amp;rel=index.html%23%2528xrepl._drracket%2529&amp;version=8.6" class="plainlink Sq" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">,drracket</span><span class="hspace"></span></span></a> command makes it easy
+to use your favorite editor to write code, and still have DrRacket at hand to
+try things out.</p><p>For more information, see <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=xrepl&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">XREPL: eXtended REPL</a>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Shell_completion&quot;">24.1.3<tt>&nbsp;</tt><a name="(part._.Shell_completion)"></a>Shell completion</h5><p>Shell auto-completion for <span class="stt">bash</span> and <span class="stt">zsh</span> is available in
+<span class="stt">"share/pkgs/shell-completion/racket-completion.bash"</span> and
+<span class="stt">"share/pkgs/shell-completion/racket-completion.zsh"</span>,
+respectively.
+To enable it, just run the appropriate file from your <span class="stt">.bashrc</span> or
+your <span class="stt">.zshrc</span>.</p><p>The <span class="stt">"shell-completion"</span> collection is only available in the Racket Full
+distribution. The completion scripts are also available
+<a href="https://github.com/racket/shell-completion">online</a>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="other-editors.html" title="backward to &quot;24 Command-Line Tools and Your Editor of Choice&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="other-editors.html" title="up to &quot;24 Command-Line Tools and Your Editor of Choice&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Emacs.html" title="forward to &quot;24.2 Emacs&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/code-inspectors_protect.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/code-inspectors_protect.html
new file mode 100644
index 00000000..3e3aa0c6
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/code-inspectors_protect.html
@@ -0,0 +1,34 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15.4&nbsp;Code Inspectors for Trusted and Untrusted Code</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewselflink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="eval.html" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eval</span></span></a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="mk-namespace.html" class="tocviewlink" data-pltdoc="x">Manipulating Namespaces</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="load.html" class="tocviewlink" data-pltdoc="x">Scripting Evaluation and Using <span class="RktSym"><span class="RktValLink">load</span></span></a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="code-inspectors_protect.html" class="tocviewselflink" data-pltdoc="x">Code Inspectors for Trusted and Untrusted Code</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="load.html" title="backward to &quot;15.3 Scripting Evaluation and Using load&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="reflection.html" title="up to &quot;15 Reflection and Dynamic Evaluation&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="macros.html" title="forward to &quot;16 Macros&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;code-inspectors+protect&quot;">15.4<tt>&nbsp;</tt><a name="(part._code-inspectors+protect)"></a>Code Inspectors for Trusted and Untrusted Code</h4><p><a name="(tech._code._inspector)"></a><span style="font-style: italic">Code inspectors</span> provide the mechanism for determining which
+modules are trusted to use functions like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._module-%7E3enamespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">module-&gt;namespace</a></span>
+or unsafe modules like <span class="RktSym">ffi/unsafe</span>. When a module is declared,
+the value of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=modprotect.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-code-inspector%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-code-inspector</a></span> is associated to the
+module declaration. When a module is instantiated (i.e., when the body
+of the declaration is actually executed), a sub-inspector is created
+to guard the module&rsquo;s exports. Access to the module&rsquo;s <a href="protect-out.html#%28tech._protected%29" class="techoutside" data-pltdoc="x"><span class="techinside">protected</span></a>
+exports requires a code inspector that is stronger (i.e., higher in
+the inspector hierarchy) than the module&rsquo;s instantiation inspector;
+note that a module&rsquo;s declaration inspector is always stronger than its
+instantiation inspector, so modules are declared with the same code
+inspector can access each other&rsquo;s exports.</p><p>To distinguish between trusted an untrusted code, load trusted code
+first, then set <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=modprotect.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-code-inspector%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-code-inspector</a></span> to the result of
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=inspectors.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-inspector%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-inspector</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=modprotect.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-code-inspector%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-code-inspector</a></span><span class="RktPn">)</span><span class="RktPn">)</span> to install a weaker
+inspector, and finally load untrusted code with the weaker inspector
+in place. The weaker inspector should stay in place when any untrusted
+code is run. If necessary, trusted code can restore the original
+inspector temporarily during the dynamic extent of trusted code (as
+long as it does not call back into untrusted code).</p><p>Syntax-object constants within a module, such as literal identifiers
+in a template, retain the inspector of their source module. In this
+way, a macro from a trusted module can be used within an untrusted
+module, and <a href="protect-out.html#%28tech._protected%29" class="techoutside" data-pltdoc="x"><span class="techinside">protected</span></a> identifiers in the macro expansion still
+work, even through they ultimately appear in an untrusted module. To
+prevent abuse of identifiers by extracting them from expanded code,
+functions like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxtrans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._local-expand%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">local-expand</a></span> are <a href="protect-out.html#%28tech._protected%29" class="techoutside" data-pltdoc="x"><span class="techinside">protected</span></a>, and
+functions like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Expanding_Top-Level_Forms.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._expand%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">expand</a></span> return <a href="stx-certs.html#%28tech._tainted%29" class="techoutside" data-pltdoc="x"><span class="techinside">tainted</span></a> syntax if not
+given a sufficiently powerful inspector.</p><p>Compiled code from a <span class="stt">".zo"</span> file is inherently untrustworthy,
+unfortunately, since it can be synthesized by means other than
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._compile%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">compile</a></span>. When compiled code is written to a <span class="stt">".zo"</span>
+file, syntax-object constants within the compiled code lose their
+inspectors. All syntax-object constants within compiled code acquire
+the enclosing module&rsquo;s declaration-time inspector when the code is
+loaded.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="load.html" title="backward to &quot;15.3 Scripting Evaluation and Using load&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="reflection.html" title="up to &quot;15 Reflection and Dynamic Evaluation&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="macros.html" title="forward to &quot;16 Macros&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/concurrency.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/concurrency.html
new file mode 100644
index 00000000..71496c3e
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/concurrency.html
@@ -0,0 +1,101 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>18&nbsp;Concurrency and Synchronization</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9660;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewselflink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>18&nbsp;</td><td><a href="concurrency.html" class="tocviewselflink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">18.1&nbsp;</td><td><a href="concurrency.html#%28part._.Threads%29" class="tocviewlink" data-pltdoc="x">Threads</a></td></tr><tr><td align="right">18.2&nbsp;</td><td><a href="concurrency.html#%28part._.Thread_.Mailboxes%29" class="tocviewlink" data-pltdoc="x">Thread Mailboxes</a></td></tr><tr><td align="right">18.3&nbsp;</td><td><a href="concurrency.html#%28part._.Semaphores%29" class="tocviewlink" data-pltdoc="x">Semaphores</a></td></tr><tr><td align="right">18.4&nbsp;</td><td><a href="concurrency.html#%28part._.Channels%29" class="tocviewlink" data-pltdoc="x">Channels</a></td></tr><tr><td align="right">18.5&nbsp;</td><td><a href="concurrency.html#%28part._.Buffered_.Asynchronous_.Channels%29" class="tocviewlink" data-pltdoc="x">Buffered Asynchronous Channels</a></td></tr><tr><td align="right">18.6&nbsp;</td><td><a href="concurrency.html#%28part._.Synchronizable_.Events_and_sync%29" class="tocviewlink" data-pltdoc="x">Synchronizable Events and <span class="RktSym"><span class="RktValLink">sync</span></span></a></td></tr><tr><td align="right">18.7&nbsp;</td><td><a href="concurrency.html#%28part._.Building_.Your_.Own_.Synchronization_.Patterns%29" class="tocviewlink" data-pltdoc="x">Building Your Own Synchronization Patterns</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">18.1<tt>&nbsp;</tt></span><a href="concurrency.html#%28part._.Threads%29" class="tocsubseclink" data-pltdoc="x">Threads</a></td></tr><tr><td><span class="tocsublinknumber">18.2<tt>&nbsp;</tt></span><a href="concurrency.html#%28part._.Thread_.Mailboxes%29" class="tocsubseclink" data-pltdoc="x">Thread Mailboxes</a></td></tr><tr><td><span class="tocsublinknumber">18.3<tt>&nbsp;</tt></span><a href="concurrency.html#%28part._.Semaphores%29" class="tocsubseclink" data-pltdoc="x">Semaphores</a></td></tr><tr><td><span class="tocsublinknumber">18.4<tt>&nbsp;</tt></span><a href="concurrency.html#%28part._.Channels%29" class="tocsubseclink" data-pltdoc="x">Channels</a></td></tr><tr><td><span class="tocsublinknumber">18.5<tt>&nbsp;</tt></span><a href="concurrency.html#%28part._.Buffered_.Asynchronous_.Channels%29" class="tocsubseclink" data-pltdoc="x">Buffered Asynchronous Channels</a></td></tr><tr><td><span class="tocsublinknumber">18.6<tt>&nbsp;</tt></span><a href="concurrency.html#%28part._.Synchronizable_.Events_and_sync%29" class="tocsubseclink" data-pltdoc="x">Synchronizable Events and <span class="RktSym"><span class="RktValLink">sync</span></span></a></td></tr><tr><td><span class="tocsublinknumber">18.7<tt>&nbsp;</tt></span><a href="concurrency.html#%28part._.Building_.Your_.Own_.Synchronization_.Patterns%29" class="tocsubseclink" data-pltdoc="x">Building Your Own Synchronization Patterns</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="module-runtime-config.html" title="backward to &quot;17.3.6 Module-Handling Configuration&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="performance.html" title="forward to &quot;19 Performance&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;concurrency&quot;">18<tt>&nbsp;</tt><a name="(part._concurrency)"></a>Concurrency and Synchronization</h3><p>Racket provides <a name="(tech._concurrency)"></a><span style="font-style: italic">concurrency</span> in the form of
+<a name="(tech._thread)"></a><span style="font-style: italic">threads</span>, and it provides a general <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sync%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sync</a></span> function
+that can be used to synchronize both threads and other implicit forms of
+concurrency, such as <a href="i_o.html#%28tech._port%29" class="techoutside" data-pltdoc="x"><span class="techinside">ports</span></a>.</p><p>Threads run concurrently in the sense that one thread can preempt
+another without its cooperation, but threads do not run in parallel in
+the sense of using multiple hardware processors.  See
+<a href="parallelism.html" data-pltdoc="x">Parallelism</a> for information on parallelism in Racket.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Threads&quot;">18.1<tt>&nbsp;</tt><a name="(part._.Threads)"></a>Threads</h4><p>To execute a procedure concurrently, use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span>.  The
+following example creates two new threads from the main thread:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"This is the original thread"</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"This is a new thread."</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"This is another new thread."</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The next example creates a new thread that would otherwise loop forever, but
+the main thread uses <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sleep%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sleep</a></span> to pause itself for 2.5 seconds, then
+uses <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._kill-thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">kill-thread</a></span> to terminate the worker thread:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">worker</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Working..."</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sleep%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sleep</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0.2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sleep%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sleep</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2.5</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._kill-thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">kill-thread</a></span><span class="hspace">&nbsp;</span><span class="RktSym">worker</span><span class="RktPn">)</span></td></tr></table></blockquote><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>In DrRacket, the main thread keeps going until the Stop button is
+clicked, so in DrRacket the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-wait%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-wait</a></span> is not necessary.</p></blockquote></blockquote></blockquote><p>If the main thread finishes or is killed, the application exits, even if
+other threads are still running.  A thread can use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-wait%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-wait</a></span> to
+wait for another thread to finish.  Here, the main thread uses
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-wait%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-wait</a></span> to make sure the worker thread finishes before the main
+thread exits:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">worker</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Working hard... ~a~n"</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-wait%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-wait</a></span><span class="hspace">&nbsp;</span><span class="RktSym">worker</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Worker finished"</span><span class="RktPn">)</span></td></tr></table></blockquote><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Thread_Mailboxes&quot;">18.2<tt>&nbsp;</tt><a name="(part._.Thread_.Mailboxes)"></a>Thread Mailboxes</h4><p>Each thread has a mailbox for receiving messages.  The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-send%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-send</a></span> function
+asynchronously sends a message to another thread&rsquo;s mailbox, while
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-receive%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-receive</a></span> returns the oldest message from the current
+thread&rsquo;s mailbox, blocking to wait for a message if necessary.  In the
+following example, the main thread sends data to the worker thread to be
+processed, then sends a <span class="RktVal">'</span><span class="RktVal">done</span> message when there is no more data and
+waits for the worker thread to finish.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">worker-thread</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-receive%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-receive</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Processing ~a~n"</span><span class="hspace">&nbsp;</span><span class="RktSym">num</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVal">'</span><span class="RktVal">done</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Done~n"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-send%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">worker-thread</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-send%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">worker-thread</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">done</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-wait%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-wait</a></span><span class="hspace">&nbsp;</span><span class="RktSym">worker-thread</span><span class="RktPn">)</span></td></tr></table></blockquote><p>In the next example, the main thread delegates work to multiple arithmetic
+threads, then waits to receive the results.  The arithmetic threads process work
+items then send the results to the main thread.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-arithmetic-thread</span><span class="hspace">&nbsp;</span><span class="RktSym">operation</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-receive%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-receive</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">oper1</span><span class="hspace">&nbsp;</span><span class="RktSym">oper2</span><span class="hspace">&nbsp;</span><span class="RktSym">result-thread</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-send%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">result-thread</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._format%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a ~a ~a = ~a"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">oper1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=inspectors.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._object-name%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">object-name</a></span><span class="hspace">&nbsp;</span><span class="RktSym">operation</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">oper2</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">operation</span><span class="hspace">&nbsp;</span><span class="RktSym">oper1</span><span class="hspace">&nbsp;</span><span class="RktSym">oper2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">addition-thread</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-arithmetic-thread</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">subtraction-thread</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-arithmetic-thread</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">worklist</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">+</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">+</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal"><span class="nobreak">-</span></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal"><span class="nobreak">-</span></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">item</span><span class="hspace">&nbsp;</span><span class="RktSym">worklist</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktSym">item</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">+</span><span class="hspace">&nbsp;</span><span class="RktSym">o1</span><span class="hspace">&nbsp;</span><span class="RktSym">o2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-send%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">addition-thread</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o1</span><span class="hspace">&nbsp;</span><span class="RktSym">o2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-thread</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal"><span class="nobreak">-</span></span><span class="hspace">&nbsp;</span><span class="RktSym">o1</span><span class="hspace">&nbsp;</span><span class="RktSym">o2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-send%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">subtraction-thread</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o1</span><span class="hspace">&nbsp;</span><span class="RktSym">o2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-thread</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">worklist</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-receive%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-receive</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Semaphores&quot;">18.3<tt>&nbsp;</tt><a name="(part._.Semaphores)"></a>Semaphores</h4><p>Semaphores facilitate synchronized access to an arbitrary shared resource.
+Use semaphores when multiple threads must perform non-atomic operations on a
+single resource.</p><p>In the following example, multiple threads print to standard output
+concurrently.  Without synchronization, a line printed by one thread might
+appear in the middle of a line printed by another thread.  By using a semaphore
+initialized with a count of <span class="RktVal">1</span>, only one thread will print at a time.
+The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=semaphore.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._semaphore-wait%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">semaphore-wait</a></span> function blocks until the semaphore&rsquo;s internal counter is
+non-zero, then decrements the counter and returns. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=semaphore.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._semaphore-post%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">semaphore-post</a></span> function
+increments the counter so that another thread can unblock and then print.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">output-semaphore</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=semaphore.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-semaphore%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-semaphore</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-thread</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=semaphore.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._semaphore-wait%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">semaphore-wait</a></span><span class="hspace">&nbsp;</span><span class="RktSym">output-semaphore</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"thread ~a: ~a~n"</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=semaphore.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._semaphore-post%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">semaphore-post</a></span><span class="hspace">&nbsp;</span><span class="RktSym">output-semaphore</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">threads</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym">make-thread</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">A</span><span class="hspace">&nbsp;</span><span class="RktVal">B</span><span class="hspace">&nbsp;</span><span class="RktVal">C</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._for-each%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">for-each</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-wait%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-wait</a></span><span class="hspace">&nbsp;</span><span class="RktSym">threads</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The pattern of waiting on a semaphore, working, and posting to the
+semaphore can also be expressed using
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=semaphore.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._call-with-semaphore%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">call-with-semaphore</a></span>,which has the advantage of posting to the
+semaphore if control escapes (e.g., due to an exception):</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">output-semaphore</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=semaphore.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-semaphore%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-semaphore</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-thread</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=semaphore.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._call-with-semaphore%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">call-with-semaphore</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">output-semaphore</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"thread ~a: ~a~n"</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">threads</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym">make-thread</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">A</span><span class="hspace">&nbsp;</span><span class="RktVal">B</span><span class="hspace">&nbsp;</span><span class="RktVal">C</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._for-each%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">for-each</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-wait%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-wait</a></span><span class="hspace">&nbsp;</span><span class="RktSym">threads</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Semaphores are a low-level technique.  Often, a better solution is to restrict
+resource access to a single thread.  For example, synchronizing access to
+standard output might be better accomplished by having a dedicated thread for
+printing output.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Channels&quot;">18.4<tt>&nbsp;</tt><a name="(part._.Channels)"></a>Channels</h4><p>Channels synchronize two threads while a value is passed from one thread to the
+other.  Unlike a thread mailbox, multiple threads can get items from a single
+channel, so channels should be used when multiple threads need to consume items
+from a single work queue.</p><p>In the following example, the main thread adds items to a channel using
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put</a></span>, while multiple worker threads consume those items using
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-get%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-get</a></span>.  Each call to either procedure blocks until another
+thread calls the other procedure with the same channel.  The workers process
+the items and then pass their results to the result thread via the <span class="RktSym">result-channel</span>.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">result-channel</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-channel%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">result-thread</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-get%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-get</a></span><span class="hspace">&nbsp;</span><span class="RktSym">result-channel</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">work-channel</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-channel%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-worker</span><span class="hspace">&nbsp;</span><span class="RktSym">thread-id</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">item</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-get%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-get</a></span><span class="hspace">&nbsp;</span><span class="RktSym">work-channel</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=case.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">item</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">DONE</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">result-channel</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._format%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Thread ~a done\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">thread-id</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">result-channel</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._format%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Thread ~a processed ~a\n"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">thread-id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">item</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">work-threads</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym">make-worker</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">item</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">A</span><span class="hspace">&nbsp;</span><span class="RktVal">B</span><span class="hspace">&nbsp;</span><span class="RktVal">C</span><span class="hspace">&nbsp;</span><span class="RktVal">D</span><span class="hspace">&nbsp;</span><span class="RktVal">E</span><span class="hspace">&nbsp;</span><span class="RktVal">F</span><span class="hspace">&nbsp;</span><span class="RktVal">G</span><span class="hspace">&nbsp;</span><span class="RktVal">H</span><span class="hspace">&nbsp;</span><span class="RktVal">DONE</span><span class="hspace">&nbsp;</span><span class="RktVal">DONE</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">work-channel</span><span class="hspace">&nbsp;</span><span class="RktSym">item</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._for-each%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">for-each</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-wait%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-wait</a></span><span class="hspace">&nbsp;</span><span class="RktSym">work-threads</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">result-channel</span><span class="hspace">&nbsp;</span><span class="RktVal">""</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">waits until result-thread has printed all other output</span></td></tr></table></blockquote><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Buffered_Asynchronous_Channels&quot;">18.5<tt>&nbsp;</tt><a name="(part._.Buffered_.Asynchronous_.Channels)"></a>Buffered Asynchronous Channels</h4><p>Buffered asynchronous channels are similar to the channels described above, but
+the &ldquo;put&rdquo; operation of asynchronous channels does not block&#8212;<wbr></wbr>unless the given
+channel was created with a buffer limit and the limit has been reached.  The
+asynchronous-put operation is therefore somewhat similar to
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-send%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-send</a></span>, but unlike thread mailboxes, asynchronous channels allow
+multiple threads to consume items from a single channel.</p><p>In the following
+example, the main thread adds items to the work channel, which holds a maximum
+of three items at a time.  The worker threads process items from this channel and
+then send results to the print thread.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/async-channel</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">print-thread</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-receive%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-receive</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">safer-printf</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">items</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-send%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">print-thread</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._format%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktSym">items</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">work-channel</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=async-channel.html%23%2528def._%2528%2528lib._racket%252Fasync-channel..rkt%2529._make-async-channel%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-async-channel</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-worker-thread</span><span class="hspace">&nbsp;</span><span class="RktSym">thread-id</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">item</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=async-channel.html%23%2528def._%2528%2528lib._racket%252Fasync-channel..rkt%2529._async-channel-get%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">async-channel-get</a></span><span class="hspace">&nbsp;</span><span class="RktSym">work-channel</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">safer-printf</span><span class="hspace">&nbsp;</span><span class="RktVal">"Thread ~a processing item: ~a"</span><span class="hspace">&nbsp;</span><span class="RktSym">thread-id</span><span class="hspace">&nbsp;</span><span class="RktSym">item</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._for-each%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">for-each</a></span><span class="hspace">&nbsp;</span><span class="RktSym">make-worker-thread</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">item</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">c</span><span class="hspace">&nbsp;</span><span class="RktVal">d</span><span class="hspace">&nbsp;</span><span class="RktVal">e</span><span class="hspace">&nbsp;</span><span class="RktVal">f</span><span class="hspace">&nbsp;</span><span class="RktVal">g</span><span class="hspace">&nbsp;</span><span class="RktVal">h</span><span class="hspace">&nbsp;</span><span class="RktVal">i</span><span class="hspace">&nbsp;</span><span class="RktVal">j</span><span class="hspace">&nbsp;</span><span class="RktVal">k</span><span class="hspace">&nbsp;</span><span class="RktVal">l</span><span class="hspace">&nbsp;</span><span class="RktVal">m</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=async-channel.html%23%2528def._%2528%2528lib._racket%252Fasync-channel..rkt%2529._async-channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">async-channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">work-channel</span><span class="hspace">&nbsp;</span><span class="RktSym">item</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Note the above example lacks any synchronization to verify that all items were
+processed.  If the main thread were to exit without such synchronization, it is
+possible that the worker threads will not finish processing some items or the
+print thread will not print all items.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Synchronizable_Events_and_sync&quot;">18.6<tt>&nbsp;</tt><a name="(part._.Synchronizable_.Events_and_sync)"></a>Synchronizable Events and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sync%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sync</a></span></h4><p>There are other ways to synchronize threads.  The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sync%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sync</a></span> function allows
+threads to coordinate via <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528tech._synchronizable._event%2529&amp;version=8.6" class="techoutside Sq" data-pltdoc="x"><span class="techinside">synchronizable events</span></a>.
+Many values double as events, allowing a uniform way to synchronize threads
+using different types.  Examples of events include channels, ports, threads,
+and alarms. This section builds up a number of examples that show how
+the combination of events, threads, and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sync%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sync</a></span> (along with recursive functions)
+allow you to implement arbitrarily sophisticated communication protocols
+to coordinate concurrent parts of a program.</p><p>In the next example, a channel and an alarm are used as synchronizable events.
+The workers <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sync%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sync</a></span> on both so that they can process channel items until the
+alarm is activated.  The channel items are processed, and then results are sent back
+to the main thread.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">main-thread</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-thread</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">alarm</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._alarm-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">alarm-evt</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3000</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-inexact-milliseconds%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-inexact-milliseconds</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">channel</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-channel%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-worker-thread</span><span class="hspace">&nbsp;</span><span class="RktSym">thread-id</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sync%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sync</a></span><span class="hspace">&nbsp;</span><span class="RktSym">channel</span><span class="hspace">&nbsp;</span><span class="RktSym">alarm</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span><span class="hspace">&nbsp;</span><span class="RktSym">alarm</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-send%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">main-thread</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">alarm</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-send%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">main-thread</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._format%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Thread ~a received ~a"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">thread-id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">evt</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">make-worker-thread</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">make-worker-thread</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">make-worker-thread</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">channel</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">A</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">channel</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">B</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-receive%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-receive</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVal">'</span><span class="RktVal">alarm</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Done"</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktSym">result</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The next example shows a function for use in a simple TCP echo server.  The
+function uses <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sync%252Ftimeout%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sync/timeout</a></span> to synchronize on input from the given port
+or a message in the thread&rsquo;s mailbox.  The first argument to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sync%252Ftimeout%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sync/timeout</a></span>
+specifies the maximum number of seconds it should wait on the given events. The
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-lib.html%23%2528def._%2528%2528lib._racket%252Fport..rkt%2529._read-line-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-line-evt</a></span> function returns an event that is ready when a line of input is
+available in the given input port.  The result of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-receive-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-receive-evt</a></span> is ready when
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-receive%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-receive</a></span> would not block.  In a real application, the messages
+received in the thread mailbox could be used for control messages, etc.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">serve</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">out-port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sync%252Ftimeout%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sync/timeout</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-lib.html%23%2528def._%2528%2528lib._racket%252Fport..rkt%2529._read-line-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-line-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-port</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">any</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-receive-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-receive-evt</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Timed out, exiting"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=tcp.html%23%2528def._%2528%2528lib._racket%252Ftcp..rkt%2529._tcp-abandon-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">tcp-abandon-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-port</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=tcp.html%23%2528def._%2528%2528lib._racket%252Ftcp..rkt%2529._tcp-abandon-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">tcp-abandon-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">out-port</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._fprintf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">fprintf</a></span><span class="hspace">&nbsp;</span><span class="RktSym">out-port</span><span class="hspace">&nbsp;</span><span class="RktVal">"~a~n"</span><span class="hspace">&nbsp;</span><span class="RktSym">evt</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-buffers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._flush-output%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">flush-output</a></span><span class="hspace">&nbsp;</span><span class="RktSym">out-port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Received a message in mailbox: ~a~n"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-receive%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-receive</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The <span class="RktSym">serve</span> function is used in the following example, which
+starts a server thread and a client thread that communicate over TCP.  The
+client prints three lines to the server, which echoes them back.  The client&rsquo;s
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-lib.html%23%2528def._%2528%2528lib._racket%252Fport..rkt%2529._copy-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">copy-port</a></span> call blocks until EOF is received.  The server times out after
+two seconds, closing the ports, which allows <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-lib.html%23%2528def._%2528%2528lib._racket%252Fport..rkt%2529._copy-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">copy-port</a></span> to finish and the
+client to exit.  The main thread uses <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-wait%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-wait</a></span> to wait for the
+client thread to exit (since, without <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-wait%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-wait</a></span>, the main thread might
+exit before the other threads are finished).</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port-num</span><span class="hspace">&nbsp;</span><span class="RktVal">4321</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">start-server</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">listener</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=tcp.html%23%2528def._%2528%2528lib._racket%252Ftcp..rkt%2529._tcp-listen%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">tcp-listen</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port-num</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">out-port</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=tcp.html%23%2528def._%2528%2528lib._racket%252Ftcp..rkt%2529._tcp-accept%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">tcp-accept</a></span><span class="hspace">&nbsp;</span><span class="RktSym">listener</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">serve</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">out-port</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">start-server</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">client-thread</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">out-port</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=tcp.html%23%2528def._%2528%2528lib._racket%252Ftcp..rkt%2529._tcp-connect%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">tcp-connect</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"localhost"</span><span class="hspace">&nbsp;</span><span class="RktSym">port-num</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"first\nsecond\nthird\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">out-port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-buffers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._flush-output%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">flush-output</a></span><span class="hspace">&nbsp;</span><span class="RktSym">out-port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">copy-port will block until EOF is read from in-port</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-lib.html%23%2528def._%2528%2528lib._racket%252Fport..rkt%2529._copy-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">copy-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-port</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-ops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-output-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-wait%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-wait</a></span><span class="hspace">&nbsp;</span><span class="RktSym">client-thread</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Sometimes, you want to attach result behavior directly to the event passed to
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sync%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sync</a></span>.  In the following example, the worker thread synchronizes on three
+channels, but each channel must be handled differently.  Using
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._handle-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">handle-evt</a></span> associates a callback with the given event.  When
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sync%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sync</a></span> selects the given event, it calls the callback to generate the
+synchronization result, rather than using the event&rsquo;s normal synchronization
+result.  Since the event is handled in the callback, there is no need to
+dispatch on the return value of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sync%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sync</a></span>.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">add-channel</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-channel%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">multiply-channel</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-channel%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">append-channel</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-channel%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">work</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sync%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sync</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._handle-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">handle-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">add-channel</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">list-of-numbers</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Sum of ~a is ~a~n"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">list-of-numbers</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">list-of-numbers</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._handle-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">handle-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">multiply-channel</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">list-of-numbers</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Product of ~a is ~a~n"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">list-of-numbers</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">list-of-numbers</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._handle-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">handle-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">append-channel</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">list-of-strings</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Concatenation of ~s is ~s~n"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">list-of-strings</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">list-of-strings</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">worker</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktSym">work</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">add-channel</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">multiply-channel</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">multiply-channel</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">add-channel</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">append-channel</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The result of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._handle-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">handle-evt</a></span> invokes its callback in tail position
+with respect to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sync%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sync</a></span>, so it is safe to
+use recursion as in the following example.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">control-channel</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-channel%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">add-channel</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-channel%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">subtract-channel</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-channel%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">work</span><span class="hspace">&nbsp;</span><span class="RktSym">state</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Current state: ~a~n"</span><span class="hspace">&nbsp;</span><span class="RktSym">state</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sync%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sync</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._handle-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">handle-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">add-channel</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">number</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Adding: ~a~n"</span><span class="hspace">&nbsp;</span><span class="RktSym">number</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">work</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">state</span><span class="hspace">&nbsp;</span><span class="RktSym">number</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._handle-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">handle-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">subtract-channel</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">number</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Subtracting: ~a~n"</span><span class="hspace">&nbsp;</span><span class="RktSym">number</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">work</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">state</span><span class="hspace">&nbsp;</span><span class="RktSym">number</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._handle-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">handle-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">control-channel</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">kill-message</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Done~n"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">worker</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">work</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">add-channel</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">subtract-channel</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">add-channel</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">add-channel</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">subtract-channel</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">control-channel</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">done</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-wait%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-wait</a></span><span class="hspace">&nbsp;</span><span class="RktSym">worker</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._wrap-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">wrap-evt</a></span> function is like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._handle-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">handle-evt</a></span>, except
+that its handler is not called in tail position with respect to
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sync%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sync</a></span>. At the same time, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._wrap-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">wrap-evt</a></span> disables break
+exceptions during its handler&rsquo;s invocation.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Building_Your_Own_Synchronization_Patterns&quot;">18.7<tt>&nbsp;</tt><a name="(part._.Building_.Your_.Own_.Synchronization_.Patterns)"></a>Building Your Own Synchronization Patterns</h4><p>Events also allow you to encode many different communication
+patterns between multiple concurrent parts of a program. One
+common such pattern is producer-consumer. Here is a way to
+implement a variation on it using the above ideas. Generally
+speaking, these communication patterns are implemented via
+a server loop that uses <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sync%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sync</a></span> to wait for any
+number of different possibilities to occur and then
+reacts to them, updating some local state.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">produce</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">producer-chan</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">consume</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-get%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-get</a></span><span class="hspace">&nbsp;</span><span class="RktSym">consumer-chan</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">private state and server loop</span></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">producer-chan</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-channel%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">consumer-chan</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-channel%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">the items variable holds the items that</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">have been produced but not yet consumed</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">items</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sync%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sync</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">wait for production</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._handle-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">handle-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">producer-chan</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">if that event was chosen,</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">we add an item to our list</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">and go back around the loop</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">items</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">wait for consumption, but only</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">if we have something to produce</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._handle-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">handle-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">items</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._never-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">never-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._channel-put-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">consumer-chan</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">items</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">if that event was chosen,</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">we know that the first item item</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">has been consumed; drop it and</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">and go back around the loop</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">items</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">an example (non-deterministic) interaction</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sleep%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sleep</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._random%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">random</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">produce</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sleep%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sleep</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._random%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">random</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">produce</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">consume</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">consume</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(2 1)</span></p></td></tr></table></blockquote><p>It is possible to build up more complex synchronization patterns. Here is
+a silly example where we extend the producer consumer with an operation
+to wait until at least a certain number of items have been produced.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">produce</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">producer-chan</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">consume</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-get%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-get</a></span><span class="hspace">&nbsp;</span><span class="RktSym">consumer-chan</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">wait-at-least</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528lib._racket%252Fmath..rkt%2529._natural%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">natural?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-channel%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">we send a new channel over to the</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">main loop so that we can wait here</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put</a></span><span class="hspace">&nbsp;</span><span class="RktSym">wait-at-least-chan</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._channel-get%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-get</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">producer-chan</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-channel%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">consumer-chan</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-channel%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">wait-at-least-chan</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-channel%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-channel</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">items</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">total-items-seen</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">waiters</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">instead of waiting on just production/</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">consumption now we wait to learn about</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">threads that want to wait for a certain</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">number of elements to be reached</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sync%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sync</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._handle-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">handle-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">producer-chan</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">items</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">total-items-seen</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">waiters</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._handle-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">handle-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">items</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._never-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">never-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._channel-put-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put-evt</a></span><span class="hspace">&nbsp;</span><span class="RktSym">consumer-chan</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">items</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">items</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">total-items-seen</span><span class="hspace">&nbsp;</span><span class="RktSym">waiters</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">wait for threads that are interested</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">the number of items produced</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._handle-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">handle-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">wait-at-least-chan</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">waiter</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktSym">items</span><span class="hspace">&nbsp;</span><span class="RktSym">total-items-seen</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">waiter</span><span class="hspace">&nbsp;</span><span class="RktSym">waiters</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">for each thread that wants to wait,</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">waiter</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">waiters</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">we check to see if there has been enough</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">production</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">waiter</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">total-items-seen</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">if so, we send a message back on the channel</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">and continue the loop without that item</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._handle-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">handle-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=channel.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._channel-put-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">channel-put-evt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">waiter</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktSym">items</span><span class="hspace">&nbsp;</span><span class="RktSym">total-items-seen</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._remove%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">remove</a></span><span class="hspace">&nbsp;</span><span class="RktSym">waiter</span><span class="hspace">&nbsp;</span><span class="RktSym">waiters</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">otherwise, we just ignore that one</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sync.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._never-evt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">never-evt</a></span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">an example (non-deterministic) interaction</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">thds</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">produce</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">wait-at-least</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._format%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a -&gt; ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">consume</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">thd</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">thds</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread-wait%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread-wait</a></span><span class="hspace">&nbsp;</span><span class="RktSym">thd</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">0 -&gt; 2</span></p></td></tr><tr><td><p><span class="RktOut">3 -&gt; 3</span></p></td></tr><tr><td><p><span class="RktOut">9 -&gt; 1</span></p></td></tr><tr><td><p><span class="RktOut">8 -&gt; 0</span></p></td></tr><tr><td><p><span class="RktOut">6 -&gt; 9</span></p></td></tr><tr><td><p><span class="RktOut">2 -&gt; 8</span></p></td></tr><tr><td><p><span class="RktOut">5 -&gt; 7</span></p></td></tr><tr><td><p><span class="RktOut">4 -&gt; 6</span></p></td></tr><tr><td><p><span class="RktOut">7 -&gt; 5</span></p></td></tr><tr><td><p><span class="RktOut">1 -&gt; 4</span></p></td></tr></table></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="module-runtime-config.html" title="backward to &quot;17.3.6 Module-Handling Configuration&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="performance.html" title="forward to &quot;19 Performance&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/conditionals.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/conditionals.html
new file mode 100644
index 00000000..aa76f1bc
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/conditionals.html
@@ -0,0 +1,47 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.7&nbsp;Conditionals</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewselflink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="syntax-notation.html" class="tocviewlink" data-pltdoc="x">Notation</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="binding.html" class="tocviewlink" data-pltdoc="x">Identifiers and Binding</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Function Calls</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Functions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span></a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span></a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="conditionals.html" class="tocviewselflink" data-pltdoc="x">Conditionals</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span></a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktVal">&rsquo;</span></a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="qq.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span> and <span class="RktVal">&lsquo;</span></a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Simple Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="parameterize.html" class="tocviewlink" data-pltdoc="x">Dynamic Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">parameterize</span></span></a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.7&nbsp;</td><td><a href="conditionals.html" class="tocviewselflink" data-pltdoc="x">Conditionals</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.7.1&nbsp;</td><td><a href="conditionals.html#%28part._.Simple_.Branching__if%29" class="tocviewlink" data-pltdoc="x">Simple Branching:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span></a></td></tr><tr><td align="right">4.7.2&nbsp;</td><td><a href="conditionals.html#%28part._and%2Bor%29" class="tocviewlink" data-pltdoc="x">Combining Tests:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">and</span></span> and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td align="right">4.7.3&nbsp;</td><td><a href="conditionals.html#%28part._cond%29" class="tocviewlink" data-pltdoc="x">Chaining Tests:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">cond</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">4.7.1<tt>&nbsp;</tt></span><a href="conditionals.html#%28part._.Simple_.Branching__if%29" class="tocsubseclink" data-pltdoc="x">Simple Branching:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">if</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.7.2<tt>&nbsp;</tt></span><a href="conditionals.html#%28part._and%2Bor%29" class="tocsubseclink" data-pltdoc="x">Combining Tests:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">and</span></span> and <span class="RktSym"><span class="RktStxLink">or</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.7.3<tt>&nbsp;</tt></span><a href="conditionals.html#%28part._cond%29" class="tocsubseclink" data-pltdoc="x">Chaining Tests:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">cond</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="let.html" title="backward to &quot;4.6 Local Binding&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="begin.html" title="forward to &quot;4.8 Sequencing&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;conditionals&quot;">4.7<tt>&nbsp;</tt><a name="(part._conditionals)"></a>Conditionals</h4><p>Most functions used for branching, such as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3c%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&lt;</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span>, produce either <span class="RktVal">#t</span> or <span class="RktVal">#f</span>. Racket&rsquo;s
+branching forms, however, treat any value other than <span class="RktVal">#f</span> as
+true. We say a <span style="font-style: italic">true value</span> to mean any value other than
+<span class="RktVal">#f</span>.</p><p>This convention for &ldquo;true value&rdquo; meshes well with protocols where
+<span class="RktVal">#f</span> can serve as failure or to indicate that an optional value
+is not supplied. (Beware of overusing this trick, and remember that an
+exception is usually a better mechanism to report failure.)</p><p>For example, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._member%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">member</a></span> function serves double duty; it can
+be used to find the tail of a list that starts with a particular item,
+or it can be used to simply check whether an item is present in a
+list:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._member%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Groucho"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Harpo"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Zeppo"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._member%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Groucho"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Harpo"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Groucho"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Zeppo"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("Groucho" "Zeppo")</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._member%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Groucho"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Harpo"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Zeppo"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yep</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">nope</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'nope</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._member%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Groucho"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Harpo"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Groucho"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Zeppo"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yep</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">nope</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'yep</span></p></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Simple_Branching__if&quot;">4.7.1<tt>&nbsp;</tt><a name="(part._.Simple_.Branching__if)"></a>Simple Branching: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span></h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html&amp;version=8.6" class="Sq" data-pltdoc="x">Conditionals: <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> also documents <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span>.</p></blockquote></blockquote></blockquote><p>In an <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span> form,</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktVar">test-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">then-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">else-expr</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>the <span class="RktVar">test-expr</span> is always evaluated. If it produces any value
+other than <span class="RktVal">#f</span>, then <span class="RktVar">then-expr</span> is
+evaluated. Otherwise, <span class="RktVar">else-expr</span> is evaluated.</p><p>An <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span> form must have both a <span class="RktVar">then-expr</span> and an
+<span class="RktVar">else-expr</span>; the latter is not optional. To perform (or skip)
+side-effects based on a <span class="RktVar">test-expr</span>, use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._when%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">when</a></span> or
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._unless%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unless</a></span>, which we describe later in <a href="begin.html" data-pltdoc="x">Sequencing</a>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;and+or&quot;">4.7.2<tt>&nbsp;</tt><a name="(part._and+or)"></a>Combining Tests: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span></h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html&amp;version=8.6" class="Sq" data-pltdoc="x">Conditionals: <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> also documents <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span>.</p></blockquote></blockquote></blockquote><p>Racket&rsquo;s <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span> are syntactic forms, rather than
+functions. Unlike a function, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span> forms
+can skip evaluation of later expressions if an earlier one determines
+the answer.</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>An <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span> form produces <span class="RktVal">#f</span> if any of its <span class="RktVar">expr</span>s
+produces <span class="RktVal">#f</span>. Otherwise, it produces the value of its last
+<span class="RktVar">expr</span>. As a special case, <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="RktPn">)</span> produces
+<span class="RktVal">#t</span>.</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span> form produces <span class="RktVal">#f</span> if all of its
+<span class="RktVar">expr</span>s produce <span class="RktVal">#f</span>. Otherwise, it produces the first
+non-<span class="RktVal">#f</span> value from its <span class="RktSym">expr</span>s.  As a special case,
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span><span class="RktPn">)</span> produces <span class="RktVal">#f</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">got-milk?</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">milk</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">got-milk?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">recurs only if needed</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">got-milk?</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">apple</span><span class="hspace">&nbsp;</span><span class="RktVal">banana</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">got-milk?</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">apple</span><span class="hspace">&nbsp;</span><span class="RktVal">milk</span><span class="hspace">&nbsp;</span><span class="RktVal">banana</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p>If evaluation reaches the last <span class="RktVar">expr</span> of an <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span> or
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span> form, then the <span class="RktVar">expr</span>&rsquo;s value directly determines
+the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span> or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span> result. Therefore, the last
+<span class="RktVar">expr</span> is in tail position, which means that the above
+<span class="RktSym">got-milk?</span> function runs in constant space.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="Lists__Iteration__and_Recursion.html#%28part._tail-recursion%29" data-pltdoc="x">Tail Recursion</a> introduces tail calls and tail positions.</p></blockquote></blockquote></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;cond&quot;">4.7.3<tt>&nbsp;</tt><a name="(part._cond)"></a>Chaining Tests: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></h5><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span> form chains a series of tests to select a result
+expression. To a first approximation, the syntax of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span> is
+as follows:</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html&amp;version=8.6" class="Sq" data-pltdoc="x">Conditionals: <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">cond</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, and <span class="RktSym"><span class="RktStxLink">or</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> also documents <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span>.</p></blockquote></blockquote></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">test-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote><p>Each <span class="RktVar">test-expr</span> is evaluated in order. If it produces
+<span class="RktVal">#f</span>, the corresponding <span class="RktVar">body</span>s are ignored, and
+evaluation proceeds to the next <span class="RktVar">test-expr</span>. As soon as a
+<span class="RktVar">test-expr</span> produces a true value, the associated <span class="RktVar">body</span>s
+are evaluated to produce the result for the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span> form, and no
+further <span class="RktVar">test-expr</span>s are evaluated.</p><p>The last <span class="RktVar">test-expr</span> in a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span> can be replaced by
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span>. In terms of evaluation, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span> serves as a
+synonym for <span class="RktVal">#t</span>, but it clarifies that the last clause is
+meant to catch all remaining cases. If <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span> is not used, then
+it is possible that no <span class="RktVar">test-expr</span>s produce a true value; in
+that case, the result of the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span> expression is
+<a href="void_undefined.html" class="RktModLink" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"wrong!"</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">ok</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'ok</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"wrong!"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"wrong!"</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">ok</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'ok</span></p></td></tr></table></blockquote></div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">got-milk?</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">milk</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">got-milk?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">got-milk?</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">apple</span><span class="hspace">&nbsp;</span><span class="RktVal">banana</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">got-milk?</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">apple</span><span class="hspace">&nbsp;</span><span class="RktVal">milk</span><span class="hspace">&nbsp;</span><span class="RktVal">banana</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></td></tr></table></blockquote><p>The full syntax of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span> includes two more kinds of clauses:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span><span class="hspace">&nbsp;</span><span class="RktVar">cond-clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">cond-clause</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">test-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">then-body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktVar">then-body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">test-expr</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._%7E3d%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktVar">proc-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">test-expr</span><span class="RktPn">]</span></td></tr></table></td></tr></table></blockquote></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._%7E3d%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">=&gt;</a></span> variant captures the true result of its
+<span class="RktVar">test-expr</span> and passes it to the result of the
+<span class="RktVar">proc-expr</span>, which must be a function of one argument.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">after-groucho</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._member%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Groucho"</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._%7E3d%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">=&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"not there"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">after-groucho</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Harpo"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Groucho"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Zeppo"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("Zeppo")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">after-groucho</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Harpo"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Zeppo"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">not there</span></p></td></tr></table></blockquote></div></p><p>A clause that includes only a <span class="RktVar">test-expr</span> is rarely used. It
+captures the true result of the <span class="RktVar">test-expr</span>, and simply
+returns the result for the whole <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span> expression.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="let.html" title="backward to &quot;4.6 Local Binding&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="begin.html" title="forward to &quot;4.8 Sequencing&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/contract-boundaries.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/contract-boundaries.html
new file mode 100644
index 00000000..4dfc044d
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/contract-boundaries.html
@@ -0,0 +1,44 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7.1&nbsp;Contracts and Boundaries</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="contract-boundaries.html" class="tocviewselflink" data-pltdoc="x">Contracts and Boundaries</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="contract-func.html" class="tocviewlink" data-pltdoc="x">Simple Contracts on Functions</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="contracts-general-functions.html" class="tocviewlink" data-pltdoc="x">Contracts on Functions in General</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="contracts-first.html" class="tocviewlink" data-pltdoc="x">Contracts:<span class="mywbr"> &nbsp;</span> A Thorough Example</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="contracts-struct.html" class="tocviewlink" data-pltdoc="x">Contracts on Structures</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="contracts-exists.html" class="tocviewlink" data-pltdoc="x">Abstract Contracts using <span class="RktPn">#:<span class="mywbr"> &nbsp;</span>exists</span> and <span class="RktPn">#:<span class="mywbr"> &nbsp;</span>&#8707;</span></a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="contracts-examples.html" class="tocviewlink" data-pltdoc="x">Additional Examples</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Building_New_Contracts.html" class="tocviewlink" data-pltdoc="x">Building New Contracts</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="contracts-gotchas.html" class="tocviewlink" data-pltdoc="x">Gotchas</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>7.1&nbsp;</td><td><a href="contract-boundaries.html" class="tocviewselflink" data-pltdoc="x">Contracts and Boundaries</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1.1&nbsp;</td><td><a href="contract-boundaries.html#%28part._contracts-amount0%29" class="tocviewlink" data-pltdoc="x">Contract Violations</a></td></tr><tr><td align="right">7.1.2&nbsp;</td><td><a href="contract-boundaries.html#%28part._.Experimenting_with_.Contracts_and_.Modules%29" class="tocviewlink" data-pltdoc="x">Experimenting with Contracts and Modules</a></td></tr><tr><td align="right">7.1.3&nbsp;</td><td><a href="contract-boundaries.html#%28part._contracts-intro-nested%29" class="tocviewlink" data-pltdoc="x">Experimenting with Nested Contract Boundaries</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">7.1.1<tt>&nbsp;</tt></span><a href="contract-boundaries.html#%28part._contracts-amount0%29" class="tocsubseclink" data-pltdoc="x">Contract Violations</a></td></tr><tr><td><span class="tocsublinknumber">7.1.2<tt>&nbsp;</tt></span><a href="contract-boundaries.html#%28part._.Experimenting_with_.Contracts_and_.Modules%29" class="tocsubseclink" data-pltdoc="x">Experimenting with Contracts and Modules</a></td></tr><tr><td><span class="tocsublinknumber">7.1.3<tt>&nbsp;</tt></span><a href="contract-boundaries.html#%28part._contracts-intro-nested%29" class="tocsubseclink" data-pltdoc="x">Experimenting with Nested Contract Boundaries</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contracts.html" title="backward to &quot;7 Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;7 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contract-func.html" title="forward to &quot;7.2 Simple Contracts on Functions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contract-boundaries&quot;">7.1<tt>&nbsp;</tt><a name="(part._contract-boundaries)"></a>Contracts and Boundaries</h4><p>Like a contract between two business partners, a software
+contract is an agreement between two parties. The agreement
+specifies obligations and guarantees for each &ldquo;product&rdquo;
+(or value) that is handed from one party to the other.</p><p>A contract thus establishes a boundary between the two parties. Whenever a
+value crosses this boundary, the contract monitoring system performs contract
+checks, making sure the partners abide by the established contract.</p><p><div class="SIntrapara">In this spirit, Racket encourages contracts mainly at module
+boundaries. Specifically, programmers may attach contracts to
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span> clauses and thus impose constraints and promises on the use
+of exported values. For example, the export specification
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">amount</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._positive%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">positive?</a></span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p>promises to all clients of the above module that the value of <span class="RktSym">amount</span> will
+always be a positive number. The contract system monitors
+the module&rsquo;s obligation carefully. Every time a client
+refers to <span class="RktSym">amount</span>, the monitor checks that the value
+of <span class="RktSym">amount</span> is indeed a positive number.</p><p>The contracts library is built into the Racket language, but
+if you wish to use <span class="RktSym">racket/base</span>, you can explicitly
+require the contracts library like this:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/contract</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">now we can write contracts</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">amount</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._positive%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">positive?</a></span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-amount0&quot;">7.1.1<tt>&nbsp;</tt><a name="(part._contracts-amount0)"></a>Contract Violations</h5><p>If we bind <span class="RktSym">amount</span> to a number that is not positive,</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">amount</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._positive%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">positive?</a></span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr></table></blockquote><p>then, when the module is required, the monitoring
+system signals a violation of the contract and
+blames the module for breaking its promises.</p><p>An even bigger mistake would be to bind <span class="RktSym">amount</span>
+to a non-number value:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">amount</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._positive%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">positive?</a></span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">amount</span><span class="RktPn">)</span></td></tr></table></blockquote><p>In this case, the monitoring system will apply
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._positive%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">positive?</a></span> to a symbol, but <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._positive%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">positive?</a></span>
+reports an error, because its domain is only numbers. To
+make the contract capture our intentions for all Racket
+values, we can ensure that the value is both a number and is
+positive, combining the two contracts with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span>:</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">amount</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._positive%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">positive?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Experimenting_with_Contracts_and_Modules&quot;">7.1.2<tt>&nbsp;</tt><a name="(part._.Experimenting_with_.Contracts_and_.Modules)"></a>Experimenting with Contracts and Modules</h5><p>All of the contracts and modules in this chapter (excluding those just
+following) are written using the standard <span class="stt">#lang</span> syntax for
+describing modules. Since modules serve as the boundary between
+parties in a contract, examples involve multiple modules.</p><p>To experiment with multiple modules within a single module or within
+DrRacket&rsquo;s <a href="intro.html#%28tech._definitions._area%29" class="techoutside" data-pltdoc="x"><span class="techinside">definitions area</span></a>, use
+Racket&rsquo;s submodules. For example, try the example earlier in
+this section like this:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._module%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">server</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">amount</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._positive%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">positive?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount</span><span class="hspace">&nbsp;</span><span class="RktVal">150</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._module%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">main</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._submod%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">submod</a></span><span class="hspace">&nbsp;</span><span class="RktVal">".."</span><span class="hspace">&nbsp;</span><span class="RktSym">server</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Each of the modules and their contracts are wrapped in parentheses
+with the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._module%252B%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module+</a></span> keyword at the front. The first form after
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> is the name of the module to be used in a subsequent
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> statement (where each reference through a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> prefixes the name with <span class="RktVal">".."</span>).</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-intro-nested&quot;">7.1.3<tt>&nbsp;</tt><a name="(part._contracts-intro-nested)"></a>Experimenting with Nested Contract Boundaries</h5><p>In many cases, it makes sense to attach contracts at module boundaries.
+It is often convenient, however, to be able to use contracts at
+a finer granularity than modules. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span>
+form enables this kind of use:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._positive%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">positive?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">150</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr></table></blockquote><p>In this example, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span> form establishes a contract
+boundary between the definition of <span class="RktSym">amount</span> and its surrounding
+context. In other words, the two parties here are the definition and
+the module that contains it.</p><p>Forms that create these <span class="emph">nested contract boundaries</span> can sometimes
+be subtle to use because they may have unexpected performance implications
+or blame a party that may seem unintuitive. These subtleties are explained
+in <a href="contract-func.html#%28part._simple-nested%29" data-pltdoc="x">Using <span class="RktSym"><span class="RktStxLink">define/contract</span></span> and <span class="RktSym"><span class="RktStxLink"><span class="nobreak">-&gt;</span></span></span></a> and <a href="contracts-gotchas.html#%28part._contracts-gotcha-nested%29" data-pltdoc="x">Contract boundaries and <span class="RktSym"><span class="RktStxLink">define/contract</span></span></a>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contracts.html" title="backward to &quot;7 Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;7 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contract-func.html" title="forward to &quot;7.2 Simple Contracts on Functions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/contract-func.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/contract-func.html
new file mode 100644
index 00000000..d56d9054
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/contract-func.html
@@ -0,0 +1,132 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7.2&nbsp;Simple Contracts on Functions</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="contract-boundaries.html" class="tocviewlink" data-pltdoc="x">Contracts and Boundaries</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="contract-func.html" class="tocviewselflink" data-pltdoc="x">Simple Contracts on Functions</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="contracts-general-functions.html" class="tocviewlink" data-pltdoc="x">Contracts on Functions in General</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="contracts-first.html" class="tocviewlink" data-pltdoc="x">Contracts:<span class="mywbr"> &nbsp;</span> A Thorough Example</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="contracts-struct.html" class="tocviewlink" data-pltdoc="x">Contracts on Structures</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="contracts-exists.html" class="tocviewlink" data-pltdoc="x">Abstract Contracts using <span class="RktPn">#:<span class="mywbr"> &nbsp;</span>exists</span> and <span class="RktPn">#:<span class="mywbr"> &nbsp;</span>&#8707;</span></a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="contracts-examples.html" class="tocviewlink" data-pltdoc="x">Additional Examples</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Building_New_Contracts.html" class="tocviewlink" data-pltdoc="x">Building New Contracts</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="contracts-gotchas.html" class="tocviewlink" data-pltdoc="x">Gotchas</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>7.2&nbsp;</td><td><a href="contract-func.html" class="tocviewselflink" data-pltdoc="x">Simple Contracts on Functions</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.2.1&nbsp;</td><td><a href="contract-func.html#%28part._.Styles_of_-_%29" class="tocviewlink" data-pltdoc="x">Styles of <span class="RktSym"><span class="RktStxLink"><span class="nobreak">-<wbr></wbr>&gt;</span></span></span></a></td></tr><tr><td align="right">7.2.2&nbsp;</td><td><a href="contract-func.html#%28part._simple-nested%29" class="tocviewlink" data-pltdoc="x">Using <span class="RktSym"><span class="RktStxLink">define/<span class="mywbr"> &nbsp;</span>contract</span></span> and <span class="RktSym"><span class="RktStxLink"><span class="nobreak">-<wbr></wbr>&gt;</span></span></span></a></td></tr><tr><td align="right">7.2.3&nbsp;</td><td><a href="contract-func.html#%28part._any_and_any_c%29" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">any</span></span> and <span class="RktSym"><span class="RktValLink">any/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td align="right">7.2.4&nbsp;</td><td><a href="contract-func.html#%28part._contracts-own%29" class="tocviewlink" data-pltdoc="x">Rolling Your Own Contracts</a></td></tr><tr><td align="right">7.2.5&nbsp;</td><td><a href="contract-func.html#%28part._.Contracts_on_.Higher-order_.Functions%29" class="tocviewlink" data-pltdoc="x">Contracts on Higher-<wbr></wbr>order Functions</a></td></tr><tr><td align="right">7.2.6&nbsp;</td><td><a href="contract-func.html#%28part._contracts-flat-named-contracts%29" class="tocviewlink" data-pltdoc="x">Contract Messages with &ldquo;???&rdquo;</a></td></tr><tr><td align="right">7.2.7&nbsp;</td><td><a href="contract-func.html#%28part._contracts-dissecting-contract-errors%29" class="tocviewlink" data-pltdoc="x">Dissecting a contract error message</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">7.2.1<tt>&nbsp;</tt></span><a href="contract-func.html#%28part._.Styles_of_-_%29" class="tocsubseclink" data-pltdoc="x">Styles of <span class="RktSym"><span class="RktStxLink"><span class="nobreak">-<wbr></wbr>&gt;</span></span></span></a></td></tr><tr><td><span class="tocsublinknumber">7.2.2<tt>&nbsp;</tt></span><a href="contract-func.html#%28part._simple-nested%29" class="tocsubseclink" data-pltdoc="x">Using <span class="RktSym"><span class="RktStxLink">define/<span class="mywbr"> &nbsp;</span>contract</span></span> and <span class="RktSym"><span class="RktStxLink"><span class="nobreak">-<wbr></wbr>&gt;</span></span></span></a></td></tr><tr><td><span class="tocsublinknumber">7.2.3<tt>&nbsp;</tt></span><a href="contract-func.html#%28part._any_and_any_c%29" class="tocsubseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">any</span></span> and <span class="RktSym"><span class="RktValLink">any/<span class="mywbr"> &nbsp;</span>c</span></span></a></td></tr><tr><td><span class="tocsublinknumber">7.2.4<tt>&nbsp;</tt></span><a href="contract-func.html#%28part._contracts-own%29" class="tocsubseclink" data-pltdoc="x">Rolling Your Own Contracts</a></td></tr><tr><td><span class="tocsublinknumber">7.2.5<tt>&nbsp;</tt></span><a href="contract-func.html#%28part._.Contracts_on_.Higher-order_.Functions%29" class="tocsubseclink" data-pltdoc="x">Contracts on Higher-<wbr></wbr>order Functions</a></td></tr><tr><td><span class="tocsublinknumber">7.2.6<tt>&nbsp;</tt></span><a href="contract-func.html#%28part._contracts-flat-named-contracts%29" class="tocsubseclink" data-pltdoc="x">Contract Messages with &ldquo;???&rdquo;</a></td></tr><tr><td><span class="tocsublinknumber">7.2.7<tt>&nbsp;</tt></span><a href="contract-func.html#%28part._contracts-dissecting-contract-errors%29" class="tocsubseclink" data-pltdoc="x">Dissecting a contract error message</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contract-boundaries.html" title="backward to &quot;7.1 Contracts and Boundaries&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;7 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contracts-general-functions.html" title="forward to &quot;7.3 Contracts on Functions in General&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contract-func&quot;">7.2<tt>&nbsp;</tt><a name="(part._contract-func)"></a>Simple Contracts on Functions</h4><p>A mathematical function has a <a name="(tech._domain)"></a><span style="font-style: italic">domain</span> and a
+<a name="(tech._range)"></a><span style="font-style: italic">range</span>. The domain indicates the kind of values that the
+function can accept as arguments, and the range indicates the kind of
+values that it produces. The conventional notation for describing a
+function with its domain and range is</p><blockquote class="SCodeFlow"><p><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">:</span><span class="hspace">&nbsp;</span><span class="RktSym">A</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">B</span></p></blockquote><p>where <span class="RktSym">A</span> is the domain of the function and <span class="RktSym">B</span> is the
+range.</p><p>Functions in a programming language have domains and ranges, too, and
+a contract can ensure that a function receives only values in its
+domain and produces only values in its range. A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span> creates
+such a contract for a function. The forms after a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span> specify
+contracts for the domains and finally a contract for the range.</p><p>Here is a module that might represent a bank account:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">deposit</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">balance</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">deposit</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">balance</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">amount</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The module exports two functions:</p><ul><li><p><span class="RktSym">deposit</span>, which accepts a number and returns some value
+that is not specified in the contract, and</p></li><li><p><span class="RktSym">balance</span>, which returns a number indicating the current
+balance of the account.</p></li></ul><p>When a module exports a function, it establishes two channels of
+communication between itself as a &ldquo;server&rdquo; and the &ldquo;client&rdquo; module
+that imports the function. If the client module calls the function, it
+sends a value into the server module. Conversely, if such a function
+call ends and the function returns a value, the server module sends a
+value back to the client module. This client&ndash;server distinction is
+important, because when something goes wrong, one or the other of the
+parties is to blame.</p><p>If a client module were to apply <span class="RktSym">deposit</span> to <span class="RktVal">'</span><span class="RktVal">millions</span>,
+it would violate the contract.  The contract-monitoring system would
+catch this violation and blame the client for breaking the contract with
+the above module. In contrast, if the <span class="RktSym">balance</span> function were
+to return <span class="RktVal">'</span><span class="RktVal">broke</span>, the contract-monitoring system
+would blame the server module.</p><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span> by itself is not a contract; it is a <a name="(tech._contract._combinator)"></a><span style="font-style: italic">contract
+combinator</span>, which combines other contracts to form a contract.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Styles_of_-_&quot;">7.2.1<tt>&nbsp;</tt><a name="(part._.Styles_of_-_)"></a>Styles of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span></h5><p>If you are used to mathematical functions, you may prefer a contract
+  arrow to appear between the domain and the range of a function, not
+  at the beginning. If you have read <span style="font-style: italic"><a href="https://htdp.org">How to Design Programs</a></span>, you have seen this many
+  times. Indeed, you may have seen contracts such as these in other
+  people&rsquo;s code:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">deposit</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>If a Racket S-expression contains two dots with a symbol in the middle,
+the reader re-arranges the S-expression and place the symbol at the front,
+as described in <a href="Pairs__Lists__and_Racket_Syntax.html#%28part._lists-and-syntax%29" data-pltdoc="x">Lists and Racket Syntax</a>.  Thus,</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote><p>is just another way of writing</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;simple-nested&quot;">7.2.2<tt>&nbsp;</tt><a name="(part._simple-nested)"></a>Using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span></h5><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span> form introduced in <a href="contract-boundaries.html#%28part._contracts-intro-nested%29" data-pltdoc="x">Experimenting with Nested Contract Boundaries</a> can
+also be used to define functions that come with a contract. For example,</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">deposit</span><span class="hspace">&nbsp;</span><span class="RktSym">amount</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">implementation goes here</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span></td></tr></table></blockquote><p>which defines the <span class="RktSym">deposit</span> function with the contract from earlier.
+Note that this has two potentially important impacts on the use of
+<span class="RktSym">deposit</span>:</p><ol><li><p>The contract will be checked on any call to <span class="RktSym">deposit</span>
+that is outside of the definition of <span class="RktSym">deposit</span> &ndash;
+even those inside the module in which it is defined. Because
+there may be many calls inside the module, this checking may cause
+the contract to be checked too often, which could lead to
+a performance degradation. This is especially true if the function
+is called repeatedly from a loop.</p></li><li><p>In some situations, a function may be written to accept a more
+lax set of inputs when called by other code in the same module.
+For such use cases, the contract boundary established by
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span> is too strict.</p></li></ol><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;any_and_any_c&quot;">7.2.3<tt>&nbsp;</tt><a name="(part._any_and_any_c)"></a><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span></h5><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span> contract used for <span class="RktSym">deposit</span> matches any kind
+of result, and it can only be used in the range position of a function
+contract.  Instead of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span> above, we could use the more
+specific contract <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void?</a></span>, which says that the function will
+always return the <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void</a></span><span class="RktPn">)</span> value. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void?</a></span> contract,
+however, would require the contract monitoring system to check the
+return value every time the function is called, even though the
+&ldquo;client&rdquo; module can&rsquo;t do much with the value. In contrast,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span> tells the monitoring system <span style="font-style: italic">not</span> to check the
+return value, it tells a potential client that the &ldquo;server&rdquo; module
+<span style="font-style: italic">makes no promises at all</span> about the function&rsquo;s return value,
+even whether it is a single value or multiple values.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span> contract is similar to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span>, in that it
+makes no demands on a value. Unlike <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span>
+indicates a single value, and it is suitable for use as an argument
+contract. Using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span> as a range contract imposes a check
+that the function produces a single value. That is,</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span><span class="RktPn">)</span></p></blockquote><p>describes a function that accepts an integer and returns any number of
+values, while</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></p></blockquote><p>describes a function that accepts an integer and produces a single
+result (but does not say anything more about the result). The function</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>matches <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="stt"> </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span><span class="RktPn">)</span>, but not <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="stt"> </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span>.</p><p>Use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span> as a result contract when it is particularly
+important to promise a single result from a function. Use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span>
+when you want to promise as little as possible (and incur as little
+checking as possible) for a function&rsquo;s result.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-own&quot;">7.2.4<tt>&nbsp;</tt><a name="(part._contracts-own)"></a>Rolling Your Own Contracts</h5><p>The <span class="RktSym">deposit</span> function adds the given number to the value of
+<span class="RktSym">amount</span>. While the function&rsquo;s contract prevents clients from
+applying it to non-numbers, the contract still allows them to apply
+the function to complex numbers, negative numbers, or inexact numbers,
+none of which sensibly represent amounts of money.</p><p>The contract system allows programmers to define their own contracts
+as functions:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">amount?</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exact?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">an amount is a natural number of cents</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">is the given number an amount?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">deposit</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">amount?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">balance</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount?</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">deposit</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">balance</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">amount</span><span class="RktPn">)</span></td></tr></table></blockquote><p>This module defines an <span class="RktSym">amount?</span> function and uses it as a
+contract within <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span> contracts. When a client calls the
+<span class="RktSym">deposit</span> function as exported with the contract <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym">amount?</span><span class="stt"> </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span><span class="RktPn">)</span>, it must supply an exact, nonnegative integer, otherwise
+the <span class="RktSym">amount?</span> function applied to the argument will return
+<span class="RktVal">#f</span>, which will cause the contract-monitoring system to blame
+the client. Similarly, the server module must provide an exact,
+nonnegative integer as the result of <span class="RktSym">balance</span> to remain
+blameless.</p><p>Of course, it makes no sense to restrict a channel of communication to
+values that the client doesn&rsquo;t understand. Therefore the module also
+exports the <span class="RktSym">amount?</span> predicate itself, with a contract saying
+that it accepts an arbitrary value and returns a boolean.</p><p>In this case, we could also have used <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._natural-number%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">natural-number/c</a></span> in
+place of <span class="RktSym">amount?</span>, since it implies exactly the same check:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">deposit</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._natural-number%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">natural-number/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">balance</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._natural-number%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">natural-number/c</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Every function that accepts one argument can be treated as a predicate
+and thus used as a contract. For combining existing checks into a new
+one, however, contract combinators such as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._or%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">or/c</a></span> are often useful. For example, here is yet another way
+to write the contracts above:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount/c</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exact?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._or%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._positive%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">deposit</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount/c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">balance</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount/c</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Other values also serve double duty as contracts.  For example, if a
+function accepts a number or <span class="RktVal">#f</span>, <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._or%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">or/c</a></span><span class="stt"> </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="stt"> </span><span class="RktVal">#f</span><span class="RktPn">)</span>
+suffices. Similarly, the <span class="RktSym">amount/c</span> contract could have been
+written with a <span class="RktVal">0</span> in place of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span>. If you use a
+regular expression as a contract, the contract accepts strings and
+byte strings that match the regular expression.</p><p>Naturally, you can mix your own contract-implementing functions with
+combinators like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span>. Here is a module for creating strings
+from banking records:</p><p><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">has-decimal?</span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">L</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">L</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char%7E3d%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\.</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">L</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">convert a random number to a string</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">format-number</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">convert an amount into a string with a decimal</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">point, as in an amount of US currency</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">format-nat</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._natural-number%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">natural-number/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">has-decimal?</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">The contract of the exported function <span class="RktSym">format-number</span> specifies
+that the function consumes a number and produces a string. The
+contract of the exported function <span class="RktSym">format-nat</span> is more
+interesting than the one of <span class="RktSym">format-number</span>.  It consumes only
+natural numbers. Its range contract promises a string that has a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> in the third position from the right.</div></p><p>If we want to strengthen the promise of the range contract for
+<span class="RktSym">format-nat</span> so that it admits only strings with digits and a single
+dot, we could write it like this:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">digit-char?</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._member%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">#\1</span><span class="hspace">&nbsp;</span><span class="RktVal">#\2</span><span class="hspace">&nbsp;</span><span class="RktVal">#\3</span><span class="hspace">&nbsp;</span><span class="RktVal">#\4</span><span class="hspace">&nbsp;</span><span class="RktVal">#\5</span><span class="hspace">&nbsp;</span><span class="RktVal">#\6</span><span class="hspace">&nbsp;</span><span class="RktVal">#\7</span><span class="hspace">&nbsp;</span><span class="RktVal">#\8</span><span class="hspace">&nbsp;</span><span class="RktVal">#\9</span><span class="hspace">&nbsp;</span><span class="RktVal">#\0</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">has-decimal?</span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">L</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">L</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char%7E3d%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\.</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">L</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">is-decimal-string?</span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">L</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">has-decimal?</span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._andmap%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">andmap</a></span><span class="hspace">&nbsp;</span><span class="RktSym">digit-char?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-%7E3elist%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._substring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">substring</a></span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">L</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._andmap%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">andmap</a></span><span class="hspace">&nbsp;</span><span class="RktSym">digit-char?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-%7E3elist%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._substring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">substring</a></span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">L</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">L</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktSym">....</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">....</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">convert an  amount (natural number) of cents</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">into a dollar-based string</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">format-nat</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._natural-number%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">natural-number/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">is-decimal-string?</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Alternately, in this case, we could use a regular expression as a
+contract:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">....</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">convert an  amount (natural number) of cents</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">into a dollar-based string</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">format-nat</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._natural-number%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">natural-number/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"[0-9]*\\.[0-9][0-9]"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Contracts_on_Higher-order_Functions&quot;">7.2.5<tt>&nbsp;</tt><a name="(part._.Contracts_on_.Higher-order_.Functions)"></a>Contracts on Higher-order Functions</h5><p>Function contracts are not just restricted to having simple
+predicates on their domains or ranges. Any of the contract
+combinators discussed here, including function contracts
+themselves, can be used as contracts on the arguments and
+results of a function.</p><p>For example,</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>is a contract that describes a curried function. It matches functions
+that accept one argument and then return another function accepting a
+second argument before finally returning an integer. If a server
+exports a function <span class="RktSym">make-adder</span> with this contract, and if
+<span class="RktSym">make-adder</span> returns a value other than a function, then the
+server is to blame. If <span class="RktSym">make-adder</span> does return a function, but
+the resulting function is applied to a value other than an integer,
+then the client is to blame.</p><p>Similarly, the contract</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span></p></blockquote><p>describes functions that accept other functions as its input. If a
+server exports a function <span class="RktSym">twice</span> with this contract and the
+<span class="RktSym">twice</span> is applied to a value other than a function of one
+argument, then the client is to blame. If <span class="RktSym">twice</span> is applied to
+a function of one argument and <span class="RktSym">twice</span> calls the given function
+on a value other than an integer, then the server is to blame.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-flat-named-contracts&quot;">7.2.6<tt>&nbsp;</tt><a name="(part._contracts-flat-named-contracts)"></a>Contract Messages with &ldquo;???&rdquo;</h5><p><div class="SIntrapara">You wrote your module. You added contracts. You put them into the interface
+so that client programmers have all the information from interfaces. It&rsquo;s a
+piece of art:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bank-server</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">deposit</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">total</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">deposit</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">total</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">total</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div></p><p>Several clients used your module. Others used their
+modules in turn. And all of a sudden one of them sees this error
+message:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">bank-server</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">deposit</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span>0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">deposit: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: ???</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: -10</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; ??? any)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: bank-server</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr></table></blockquote><p>What is the <span class="RktErr">???</span> doing there?  Wouldn&rsquo;t it be nice if
+we had a name for this class of data much like we have string, number,
+and so on?</p><p>For this situation, Racket provides <a name="(tech._flat._named._contract)"></a><span style="font-style: italic">flat named
+contracts</span>. The use of &ldquo;contract&rdquo; in this term shows that contracts
+are first-class values. The &ldquo;flat&rdquo; means that the collection of data
+is a subset of the built-in atomic classes of data; they are described
+by a predicate that consumes all Racket values and produces a
+boolean. The &ldquo;named&rdquo; part says what we want to do, which is to name
+the contract so that error messages become intelligible:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">improved-bank-server</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">deposit</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._flat-named-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">flat-named-contract</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">amount</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">total</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">deposit</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">total</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">total</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote><p>With this little change, the error message becomes quite readable:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">improved-bank-server</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">deposit</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span>0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">deposit: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: amount</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: -10</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; amount any)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: improved-bank-server</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:5:0</span></p></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-dissecting-contract-errors&quot;">7.2.7<tt>&nbsp;</tt><a name="(part._contracts-dissecting-contract-errors)"></a>Dissecting a contract error message</h5><p><div class="SIntrapara">In general, each contract error message consists of six sections:
+</div><div class="SIntrapara"><ul><li><p><div class="SIntrapara">a name for the function or method associated with the contract
+and either the phrase &ldquo;contract violation&rdquo; or &ldquo;broke its contract&rdquo;
+depending on whether the contract was violated by the client or the
+server; e.g. in the previous example: </div><div class="SIntrapara"><table cellspacing="0" cellpadding="0"><tr><td><p class="RktErr">deposit: contract violation</p></td></tr></table></div></p></li><li><p><div class="SIntrapara">a description of the precise aspect of the contract that was violated, </div><div class="SIntrapara"><table cellspacing="0" cellpadding="0"><tr><td><p class="RktErr">  expected: amount</p></td></tr><tr><td><p class="RktErr">  given: -10</p></td></tr></table></div></p></li><li><p><div class="SIntrapara">the complete contract plus a path into it showing which aspect was violated, </div><div class="SIntrapara"><table cellspacing="0" cellpadding="0"><tr><td><p class="RktErr">  in: the 1st argument of</p></td></tr><tr><td><p class="RktErr">      (-&gt; amount any)</p></td></tr></table></div></p></li><li><p><div class="SIntrapara">the module where the contract was put (or, more generally, the boundary that the contract mediates), </div><div class="SIntrapara"><table cellspacing="0" cellpadding="0"><tr><td><p class="RktErr">  contract from: improved-bank-server</p></td></tr></table></div></p></li><li><p><div class="SIntrapara">who was blamed, </div><div class="SIntrapara"><table cellspacing="0" cellpadding="0"><tr><td><p class="RktErr">  blaming: top-level</p></td></tr><tr><td><p class="RktErr">   (assuming the contract is correct)</p></td></tr></table></div></p></li><li><p><div class="SIntrapara">and the source location where the contract appears. </div><div class="SIntrapara"><table cellspacing="0" cellpadding="0"><tr><td><p class="RktErr">  at: eval:5:0</p></td></tr></table></div></p></li></ul></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contract-boundaries.html" title="backward to &quot;7.1 Contracts and Boundaries&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;7 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contracts-general-functions.html" title="forward to &quot;7.3 Contracts on Functions in General&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-examples.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-examples.html
new file mode 100644
index 00000000..b25c728b
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-examples.html
@@ -0,0 +1,29 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7.7&nbsp;Additional Examples</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="contract-boundaries.html" class="tocviewlink" data-pltdoc="x">Contracts and Boundaries</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="contract-func.html" class="tocviewlink" data-pltdoc="x">Simple Contracts on Functions</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="contracts-general-functions.html" class="tocviewlink" data-pltdoc="x">Contracts on Functions in General</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="contracts-first.html" class="tocviewlink" data-pltdoc="x">Contracts:<span class="mywbr"> &nbsp;</span> A Thorough Example</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="contracts-struct.html" class="tocviewlink" data-pltdoc="x">Contracts on Structures</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="contracts-exists.html" class="tocviewlink" data-pltdoc="x">Abstract Contracts using <span class="RktPn">#:<span class="mywbr"> &nbsp;</span>exists</span> and <span class="RktPn">#:<span class="mywbr"> &nbsp;</span>&#8707;</span></a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="contracts-examples.html" class="tocviewselflink" data-pltdoc="x">Additional Examples</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Building_New_Contracts.html" class="tocviewlink" data-pltdoc="x">Building New Contracts</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="contracts-gotchas.html" class="tocviewlink" data-pltdoc="x">Gotchas</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>7.7&nbsp;</td><td><a href="contracts-examples.html" class="tocviewselflink" data-pltdoc="x">Additional Examples</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.7.1&nbsp;</td><td><a href="contracts-examples.html#%28part._.A_.Customer-.Manager_.Component%29" class="tocviewlink" data-pltdoc="x">A Customer-<wbr></wbr>Manager Component</a></td></tr><tr><td align="right">7.7.2&nbsp;</td><td><a href="contracts-examples.html#%28part._.A_.Parameteric__.Simple__.Stack%29" class="tocviewlink" data-pltdoc="x">A Parameteric (Simple) Stack</a></td></tr><tr><td align="right">7.7.3&nbsp;</td><td><a href="contracts-examples.html#%28part._.A_.Dictionary%29" class="tocviewlink" data-pltdoc="x">A Dictionary</a></td></tr><tr><td align="right">7.7.4&nbsp;</td><td><a href="contracts-examples.html#%28part._.A_.Queue%29" class="tocviewlink" data-pltdoc="x">A Queue</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">7.7.1<tt>&nbsp;</tt></span><a href="contracts-examples.html#%28part._.A_.Customer-.Manager_.Component%29" class="tocsubseclink" data-pltdoc="x">A Customer-<wbr></wbr>Manager Component</a></td></tr><tr><td><span class="tocsublinknumber">7.7.2<tt>&nbsp;</tt></span><a href="contracts-examples.html#%28part._.A_.Parameteric__.Simple__.Stack%29" class="tocsubseclink" data-pltdoc="x">A Parameteric (Simple) Stack</a></td></tr><tr><td><span class="tocsublinknumber">7.7.3<tt>&nbsp;</tt></span><a href="contracts-examples.html#%28part._.A_.Dictionary%29" class="tocsubseclink" data-pltdoc="x">A Dictionary</a></td></tr><tr><td><span class="tocsublinknumber">7.7.4<tt>&nbsp;</tt></span><a href="contracts-examples.html#%28part._.A_.Queue%29" class="tocsubseclink" data-pltdoc="x">A Queue</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contracts-exists.html" title="backward to &quot;7.6 Abstract Contracts using #:exists and #:∃&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;7 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Building_New_Contracts.html" title="forward to &quot;7.8 Building New Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-examples&quot;">7.7<tt>&nbsp;</tt><a name="(part._contracts-examples)"></a>Additional Examples</h4><p>This section illustrates the current state of Racket&rsquo;s contract
+ implementation with a series of examples from <span style="font-style: italic">Design by
+Contract, by Example</span> [<a href="doc-bibliography.html#%28cite._.Mitchell02%29" data-pltdoc="x">Mitchell02</a>].</p><p>Mitchell and McKim&rsquo;s principles for design by contract DbC are derived
+  from the 1970s style algebraic specifications. The overall goal of DbC is
+  to specify the constructors of an algebra in terms of its
+  observers. While we reformulate Mitchell and McKim&rsquo;s terminology and
+  we use a mostly applicative approach, we
+  retain their terminology of &ldquo;classes&rdquo; and &ldquo;objects&rdquo;:</p><ul><li><p><span style="font-weight: bold">Separate queries from commands.</span></p><p>A <span style="font-style: italic">query</span> returns a result but does not change the observable
+properties of an object. A <span style="font-style: italic">command</span> changes the visible
+properties of an object, but does not return a result. In applicative
+implementation a command typically returns an new object of the same
+class.</p></li><li><p><span style="font-weight: bold">Separate basic queries from derived queries.</span></p><p>A <span style="font-style: italic">derived query</span> returns a result that is computable in
+terms of basic queries.</p></li><li><p><span style="font-weight: bold">For each derived query, write a post-condition contract that
+specifies the result in terms of the basic queries.</span></p></li><li><p><span style="font-weight: bold">For each command, write a post-condition contract that specifies the
+changes to the observable properties in terms of the basic queries.</span></p></li><li><p><span style="font-weight: bold">For each query and command, decide on a suitable
+pre-condition contract.</span></p></li></ul><p>Each of the following sections corresponds to a chapter in
+ Mitchell and McKim&rsquo;s book (but not all chapters show up
+ here). We recommend that you read the contracts first (near
+ the end of the first modules), then the implementation (in
+ the first modules), and then the test module (at the end of
+ each section).</p><p>Mitchell and McKim use Eiffel as the underlying programming language and
+ employ a conventional imperative programming style. Our long-term goal is
+ to transliterate their examples into applicative Racket,
+ structure-oriented imperative Racket, and Racket&rsquo;s class system.</p><p>Note: To mimic Mitchell and McKim&rsquo;s informal notion of parametericity
+ (parametric polymorphism), we use first-class contracts. At several
+ places, this use of first-class contracts improves on Mitchell and McKim&rsquo;s
+ design (see comments in interfaces).</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;A_Customer-Manager_Component&quot;">7.7.1<tt>&nbsp;</tt><a name="(part._.A_.Customer-.Manager_.Component)"></a>A Customer-Manager Component</h5><p>This first module contains some struct definitions in a
+separate module in order to better track bugs.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">data definitions </span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">id?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">id-equal?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">basic-customer</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktSym">address</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mutable</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">interface </span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">id?</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">id-equal?</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">id?</span><span class="hspace">&nbsp;</span><span class="RktSym">id?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">basic-customer</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym">id?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">address</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">end of interface</span></td></tr></table></blockquote><p>This module contains the program that uses the above.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"1.rkt"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">the module just above</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">implementation</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">[listof (list basic-customer? secret-info)]</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">all</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">find</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">has-c-as-key</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">id-equal?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">basic-customer-id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._filter%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">filter</a></span><span class="hspace">&nbsp;</span><span class="RktSym">has-c-as-key</span><span class="hspace">&nbsp;</span><span class="RktSym">all</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._pair%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">active?</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._pair%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">find</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">not-active?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._compose%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">compose</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktSym">active?</span><span class="hspace">&nbsp;</span><span class="RktSym">basic-customer-id</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-count</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">add</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">all</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">secret</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">all</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bc-with-id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">find</span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">basic-customer-name</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bc-with-id</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">set-name</span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bc-with-id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">find</span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">set-basic-customer-name!</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bc-with-id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c0</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">end of implementation</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">how many customers are in the db?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">get-count</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._natural-number%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">natural-number/c</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">is the customer with this id active?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">active?</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">id?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">what is the name of the customer with this id?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">name</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">id?</span><span class="hspace">&nbsp;</span><span class="RktSym">active?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">change the name of the customer with this id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">set-name</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym">id?</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">nn</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">result contract</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:post</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym">nn</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3d%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string=?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">nn</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">add</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">bc</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">basic-customer?</span><span class="hspace">&nbsp;</span><span class="RktSym">not-active?</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">A pre-post condition contract must use</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">a side-effect to express this contract</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">via post-conditions</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:pre</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c0</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">result contract</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:post</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The tests:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rackunit</span><span class="hspace">&nbsp;</span><span class="RktSym">rackunit/text-ui</span><span class="hspace">&nbsp;</span><span class="RktVal">"1.rkt"</span><span class="hspace">&nbsp;</span><span class="RktVal">"1b.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">add</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-basic-customer</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">mf</span><span class="hspace">&nbsp;</span><span class="RktVal">"matthias"</span><span class="hspace">&nbsp;</span><span class="RktVal">"brookstone"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">add</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-basic-customer</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">rf</span><span class="hspace">&nbsp;</span><span class="RktVal">"robby"</span><span class="hspace">&nbsp;</span><span class="RktVal">"beverly hills park"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">add</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-basic-customer</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">fl</span><span class="hspace">&nbsp;</span><span class="RktVal">"matthew"</span><span class="hspace">&nbsp;</span><span class="RktVal">"pepper clouds town"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">add</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-basic-customer</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">sk</span><span class="hspace">&nbsp;</span><span class="RktVal">"shriram"</span><span class="hspace">&nbsp;</span><span class="RktVal">"i city"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Ftext-ui..rkt%2529._run-tests%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">run-tests</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528form._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-suite%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">test-suite</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"manager"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">test-equal?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"id lookup"</span><span class="hspace">&nbsp;</span><span class="RktVal">"matthias"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">mf</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">test-equal?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"count"</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-count</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-true%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">test-true</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"active?"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">active?</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">mf</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-false%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">test-false</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"active? 2"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">active?</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">kk</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-true%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">test-true</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"set name"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">set-name</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">mf</span><span class="hspace">&nbsp;</span><span class="RktVal">"matt"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;A_Parameteric__Simple__Stack&quot;">7.7.2<tt>&nbsp;</tt><a name="(part._.A_.Parameteric__.Simple__.Stack)"></a>A Parameteric (Simple) Stack</h5><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">a contract utility </span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eq/c</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stack</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p?</span><span class="hspace">&nbsp;</span><span class="RktSym">eq</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">initialize</span><span class="hspace">&nbsp;</span><span class="RktSym">p?</span><span class="hspace">&nbsp;</span><span class="RktSym">eq</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-stack</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym">p?</span><span class="hspace">&nbsp;</span><span class="RktSym">eq</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">push</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-stack</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stack-list</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stack-p?</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stack-eq</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">item-at</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list-ref</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._reverse%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">reverse</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stack-list</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stack-list</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">is-empty?</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stack-list</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">not-empty?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._compose%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">compose</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktSym">is-empty?</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">pop</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-stack</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stack-list</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stack-p?</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stack-eq</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">top</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stack-list</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">predicate</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">stack?</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">primitive queries</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">how many items are on the stack? </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">stack?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._natural-number%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">natural-number/c</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">which item is at the given position? </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">item-at</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ed%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">stack?</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._positive%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._%7E3c%7E3d%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&lt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stack-p?</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">derived queries </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">is the stack empty? </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">is-empty?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ed%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">stack?</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eq/c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">which item is at the top of the stack </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">top</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ed%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stack?</span><span class="hspace">&nbsp;</span><span class="RktSym">not-empty?</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">t</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stack-p?</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">a stack item, t is its name</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:post-cond</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">stack-eq</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">item-at</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">creation </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">initialize</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ed%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=contract-utilities.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fguts..rkt%2529._contract%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">contract?</a></span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Mitchell and McKim use (= (count s) 0) here to express</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">the post-condition in terms of a primitive query</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stack?</span><span class="hspace">&nbsp;</span><span class="RktSym">is-empty?</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">commands</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">add an item to the top of the stack </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">push</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ed%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">stack?</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stack-p?</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">sn</span><span class="hspace">&nbsp;</span><span class="RktSym">stack?</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">result kind </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:post-cond</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sn</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">stack-eq</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">top</span><span class="hspace">&nbsp;</span><span class="RktSym">sn</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">remove the item at the top of the stack</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">pop</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ed%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stack?</span><span class="hspace">&nbsp;</span><span class="RktSym">not-empty?</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">sn</span><span class="hspace">&nbsp;</span><span class="RktSym">stack?</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">result kind </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:post-cond</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sn</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The tests:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rackunit</span><span class="hspace">&nbsp;</span><span class="RktSym">rackunit/text-ui</span><span class="hspace">&nbsp;</span><span class="RktVal">"2.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">initialize</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._flat-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">flat-contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">push</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">push</span><span class="hspace">&nbsp;</span><span class="RktSym">s0</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Ftext-ui..rkt%2529._run-tests%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">run-tests</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528form._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-suite%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">test-suite</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"stack"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-true%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">test-true</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"empty"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">is-empty?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">initialize</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._flat-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">flat-contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-true%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">test-true</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"push"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stack?</span><span class="hspace">&nbsp;</span><span class="RktSym">s2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-true%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">test-true</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"push exn"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._with-handlers%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-handlers</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exn%7E3afail%7E3acontract%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn:fail:contract?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">push</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">initialize</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._flat-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">flat-contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-true%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">test-true</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"pop"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stack?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">pop</span><span class="hspace">&nbsp;</span><span class="RktSym">s2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">test-equal?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"top"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">top</span><span class="hspace">&nbsp;</span><span class="RktSym">s2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">test-equal?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"toppop"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">top</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">pop</span><span class="hspace">&nbsp;</span><span class="RktSym">s2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;A_Dictionary&quot;">7.7.3<tt>&nbsp;</tt><a name="(part._.A_.Dictionary)"></a>A Dictionary</h5><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">a shorthand for use below</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">&#8658;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">&#8658;</span><span class="hspace">&nbsp;</span><span class="RktSym">antecedent</span><span class="hspace">&nbsp;</span><span class="RktSym">consequent</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktSym">antecedent</span><span class="hspace">&nbsp;</span><span class="RktSym">consequent</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">implementation </span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dictionary</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktSym">value?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">the keys should probably be another parameter (exercise)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">initialize</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktSym">eq</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-dictionary</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktSym">eq</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">put</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-dictionary</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dictionary-l</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dictionary-value?</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dictionary-eq?</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rem</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-dictionary</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dictionary-l</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._caar%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">caar</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dictionary-value?</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dictionary-eq?</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dictionary-l</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">value-for</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._assq%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">assq</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dictionary-l</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">has?</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._pair%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._assq%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">assq</a></span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dictionary-l</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">not-has?</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">has?</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">end of implementation </span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">interface</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">predicates</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">dictionary?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">basic queries</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">how many items are in the dictionary?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">dictionary?</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._natural-number%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">natural-number/c</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">does the dictionary define key k? </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">has?</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ed%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktSym">dictionary?</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:post-cond</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">&#8658;</span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktSym">result</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">what is the value of key k in this dictionary? </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">value-for</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ed%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktSym">dictionary?</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">has?</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dictionary-value?</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">initialization </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">post condition: for all k in symbol, (has? d k) is false. </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">initialize</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ed%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=contract-utilities.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fguts..rkt%2529._contract%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">contract?</a></span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">eq</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dictionary?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._compose%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">compose</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">commands </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Mitchell and McKim say that put shouldn</span><span class="RktCmt">'</span><span class="RktCmt">t consume Void (null ptr) </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">for v. We allow the client to specify a contract for all values</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">via initialize. We could do the same via a key? parameter</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">(exercise). add key k with value v to this dictionary </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">put</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ed%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktSym">dictionary?</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">not-has?</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dictionary-value?</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktSym">dictionary?</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:post-cond</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">has?</span><span class="hspace">&nbsp;</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">result</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">dictionary-eq?</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">value-for</span><span class="hspace">&nbsp;</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">remove key k from this dictionary </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">rem</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ed%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktSym">dictionary?</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">has?</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dictionary?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">not-has?</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:post-cond</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">result</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">end of interface</span></td></tr></table></blockquote><p>The tests:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rackunit</span><span class="hspace">&nbsp;</span><span class="RktSym">rackunit/text-ui</span><span class="hspace">&nbsp;</span><span class="RktVal">"3.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">d0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">initialize</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._flat-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">flat-contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">put</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">put</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">put</span><span class="hspace">&nbsp;</span><span class="RktSym">d0</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Ftext-ui..rkt%2529._run-tests%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">run-tests</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528form._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-suite%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">test-suite</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"dictionaries"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">test-equal?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"value for"</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">value-for</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-false%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">test-false</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"has?"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">has?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rem</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">test-equal?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"count"</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528form._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">test-case</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"contract check for put: symbol?"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">d0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">initialize</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._flat-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">flat-contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._check-exn%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">check-exn</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exn%7E3afail%7E3acontract%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn:fail:contract?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">put</span><span class="hspace">&nbsp;</span><span class="RktSym">d0</span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;A_Queue&quot;">7.7.4<tt>&nbsp;</tt><a name="(part._.A_.Queue)"></a>A Queue</h5><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Note: this queue doesn</span><span class="RktCmt">'</span><span class="RktCmt">t implement the capacity restriction</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">of Mitchell and McKim</span><span class="RktCmt">'</span><span class="RktCmt">s queue but this is easy to add.</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">a contract utility </span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">all-but-last</span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._reverse%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">reverse</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._reverse%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">reverse</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eq/c</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">implementation</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">queue</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p?</span><span class="hspace">&nbsp;</span><span class="RktSym">eq</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">initialize</span><span class="hspace">&nbsp;</span><span class="RktSym">p?</span><span class="hspace">&nbsp;</span><span class="RktSym">eq</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-queue</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym">p?</span><span class="hspace">&nbsp;</span><span class="RktSym">eq</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">items</span><span class="hspace">&nbsp;</span><span class="RktSym">queue-list</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">put</span><span class="hspace">&nbsp;</span><span class="RktSym">q</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-queue</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">append</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">queue-list</span><span class="hspace">&nbsp;</span><span class="RktSym">q</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">queue-p?</span><span class="hspace">&nbsp;</span><span class="RktSym">q</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">queue-eq</span><span class="hspace">&nbsp;</span><span class="RktSym">q</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">queue-list</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">is-empty?</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">queue-list</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">not-empty?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._compose%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">compose</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktSym">is-empty?</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rem</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-queue</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">queue-list</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">queue-p?</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">queue-eq</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">head</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">queue-list</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">interface</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">predicate </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">queue?</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">primitive queries</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Imagine providing this </span><span class="RktCmt">'</span><span class="RktCmt">query</span><span class="RktCmt">'</span><span class="RktCmt"> for the interface of the module</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">only. Then in Racket there is no reason to have count or is-empty?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">around (other than providing it to clients). After all items is </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">exactly as cheap as count.</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">items</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ed%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">q</span><span class="hspace">&nbsp;</span><span class="RktSym">queue?</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._listof%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">queue-p?</span><span class="hspace">&nbsp;</span><span class="RktSym">q</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">derived queries </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ed%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">q</span><span class="hspace">&nbsp;</span><span class="RktSym">queue?</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">We could express this second part of the post</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">condition even if count were a module "attribute"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">in the language of Eiffel; indeed it would use the </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">exact same syntax (minus the arrow and domain).</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._natural-number%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">natural-number/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._%7E3d%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">items</span><span class="hspace">&nbsp;</span><span class="RktSym">q</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">is-empty?</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ed%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">q</span><span class="hspace">&nbsp;</span><span class="RktSym">queue?</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eq/c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">items</span><span class="hspace">&nbsp;</span><span class="RktSym">q</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">head</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ed%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">q</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">queue?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._compose%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">compose</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktSym">is-empty?</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">queue-p?</span><span class="hspace">&nbsp;</span><span class="RktSym">q</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eq/c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">items</span><span class="hspace">&nbsp;</span><span class="RktSym">q</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">creation</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">initialize</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=contract-utilities.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fguts..rkt%2529._contract%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">contract?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=contract-utilities.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fguts..rkt%2529._contract%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=contract-utilities.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fguts..rkt%2529._contract%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">contract?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">queue?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._compose%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">compose</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">items</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">commands</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">put</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ed%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">oldq</span><span class="hspace">&nbsp;</span><span class="RktSym">queue?</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">queue-p?</span><span class="hspace">&nbsp;</span><span class="RktSym">oldq</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">queue?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">q</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">old-items</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">items</span><span class="hspace">&nbsp;</span><span class="RktSym">oldq</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">items</span><span class="hspace">&nbsp;</span><span class="RktSym">q</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">old-items</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">rem</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ed%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>d</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">oldq</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">queue?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._compose%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">compose</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktSym">is-empty?</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">queue?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">q</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">items</span><span class="hspace">&nbsp;</span><span class="RktSym">oldq</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">items</span><span class="hspace">&nbsp;</span><span class="RktSym">q</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">end of interface</span></td></tr></table></blockquote><p>The tests:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rackunit</span><span class="hspace">&nbsp;</span><span class="RktSym">rackunit/text-ui</span><span class="hspace">&nbsp;</span><span class="RktVal">"5.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">put</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">put</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">initialize</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._flat-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">flat-contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Ftext-ui..rkt%2529._run-tests%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">run-tests</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528form._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-suite%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">test-suite</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"queue"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-true%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">test-true</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"empty"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">is-empty?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">initialize</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._flat-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">flat-contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-true%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">test-true</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"put"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">queue?</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">test-equal?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"count"</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Flist..rkt%2529._count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-true%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">test-true</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"put exn"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._with-handlers%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-handlers</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exn%7E3afail%7E3acontract%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn:fail:contract?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">put</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">initialize</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._flat-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">flat-contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-true%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">test-true</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"remove"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">queue?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rem</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=rackunit&amp;rel=api.html%23%2528def._%2528%2528lib._rackunit%252Fmain..rkt%2529._test-equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">test-equal?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"head"</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">head</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contracts-exists.html" title="backward to &quot;7.6 Abstract Contracts using #:exists and #:∃&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;7 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Building_New_Contracts.html" title="forward to &quot;7.8 Building New Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-exists.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-exists.html
new file mode 100644
index 00000000..3394502e
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-exists.html
@@ -0,0 +1,19 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7.6&nbsp;Abstract Contracts using #:exists and #:∃</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="contract-boundaries.html" class="tocviewlink" data-pltdoc="x">Contracts and Boundaries</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="contract-func.html" class="tocviewlink" data-pltdoc="x">Simple Contracts on Functions</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="contracts-general-functions.html" class="tocviewlink" data-pltdoc="x">Contracts on Functions in General</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="contracts-first.html" class="tocviewlink" data-pltdoc="x">Contracts:<span class="mywbr"> &nbsp;</span> A Thorough Example</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="contracts-struct.html" class="tocviewlink" data-pltdoc="x">Contracts on Structures</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="contracts-exists.html" class="tocviewselflink" data-pltdoc="x">Abstract Contracts using <span class="RktPn">#:<span class="mywbr"> &nbsp;</span>exists</span> and <span class="RktPn">#:<span class="mywbr"> &nbsp;</span>&#8707;</span></a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="contracts-examples.html" class="tocviewlink" data-pltdoc="x">Additional Examples</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Building_New_Contracts.html" class="tocviewlink" data-pltdoc="x">Building New Contracts</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="contracts-gotchas.html" class="tocviewlink" data-pltdoc="x">Gotchas</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contracts-struct.html" title="backward to &quot;7.5 Contracts on Structures&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;7 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contracts-examples.html" title="forward to &quot;7.7 Additional Examples&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-exists&quot;">7.6<tt>&nbsp;</tt><a name="(part._contracts-exists)"></a>Abstract Contracts using <span class="RktPn">#:exists</span> and <span class="RktPn">#:&#8707;</span></h4><p>The contract system provides existential contracts that can
+protect abstractions, ensuring that clients of your module
+cannot depend on the precise representation choices you make
+for your data structures.</p><p><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>You can type <span class="RktPn">#:exists</span> instead of <span class="RktPn">#:&#8707;</span> if you
+cannot easily type unicode characters; in DrRacket, typing
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\exists</span><span class="hspace"></span></span> followed by either alt-\ or control-\ (depending
+on your platform) will produce <span class="RktSym">&#8707;</span>.</p></blockquote></blockquote></blockquote></div><div class="SIntrapara">The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span> form allows you to write
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><p><span class="RktPn">#:&#8707;</span><span class="hspace">&nbsp;</span><span class="RktVar">name-of-a-new-contract</span></p></blockquote></div><div class="SIntrapara"> as one of its clauses. This declaration
+introduces the variable <span class="RktVar">name-of-a-new-contract</span>, binding it to a new
+contract that hides information about the values it protects.</div></p><p><div class="SIntrapara">As an example, consider this (simple) implementation of a queue data structure:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktSym">empty</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">enq</span><span class="hspace">&nbsp;</span><span class="RktSym">top</span><span class="hspace">&nbsp;</span><span class="RktSym">queue</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">append</span><span class="hspace">&nbsp;</span><span class="RktSym">queue</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">list</span><span class="hspace">&nbsp;</span><span class="RktSym">top</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">next</span><span class="hspace">&nbsp;</span><span class="RktSym">queue</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">car</span><span class="hspace">&nbsp;</span><span class="RktSym">queue</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">deq</span><span class="hspace">&nbsp;</span><span class="RktSym">queue</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">cdr</span><span class="hspace">&nbsp;</span><span class="RktSym">queue</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">empty?</span><span class="hspace">&nbsp;</span><span class="RktSym">queue</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">null?</span><span class="hspace">&nbsp;</span><span class="RktSym">queue</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">provide</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">empty</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._listof%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym">integer?</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">enq</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">integer?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._listof%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym">integer?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._listof%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym">integer?</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">next</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._listof%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym">integer?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">integer?</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">deq</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._listof%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym">integer?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._listof%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym">integer?</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">empty?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._listof%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym">integer?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">boolean?</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">This code implements a queue purely in terms of lists, meaning that clients
+of this data structure might use <span class="RktSym">car</span> and <span class="RktSym">cdr</span> directly on the
+data structure (perhaps accidentally) and thus any change in the representation
+(say to a more efficient representation that supports amortized constant time
+enqueue and dequeue operations) might break client code.</div></p><p><div class="SIntrapara">To ensure that the queue representation is abstract, we can use <span class="RktPn">#:&#8707;</span> in the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span> expression, like this:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym">provide</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:&#8707;</span><span class="hspace">&nbsp;</span><span class="RktSym">queue</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">empty</span><span class="hspace">&nbsp;</span><span class="RktSym">queue</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">enq</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">integer?</span><span class="hspace">&nbsp;</span><span class="RktSym">queue</span><span class="hspace">&nbsp;</span><span class="RktSym">queue</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">next</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">queue</span><span class="hspace">&nbsp;</span><span class="RktSym">integer?</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">deq</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">queue</span><span class="hspace">&nbsp;</span><span class="RktSym">queue</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">empty?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">queue</span><span class="hspace">&nbsp;</span><span class="RktSym">boolean?</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p>Now, if clients of the data structure try to use <span class="RktSym">car</span> and <span class="RktSym">cdr</span>, they
+receive an error, rather than mucking about with the internals of the queues.</p><p>See also <a href="contracts-gotchas.html#%28part._contracts-exists-gotcha%29" data-pltdoc="x">Exists Contracts and Predicates</a>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contracts-struct.html" title="backward to &quot;7.5 Contracts on Structures&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;7 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contracts-examples.html" title="forward to &quot;7.7 Additional Examples&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-first.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-first.html
new file mode 100644
index 00000000..8e7f4a6a
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-first.html
@@ -0,0 +1,78 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7.4&nbsp;Contracts: A Thorough Example</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="contract-boundaries.html" class="tocviewlink" data-pltdoc="x">Contracts and Boundaries</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="contract-func.html" class="tocviewlink" data-pltdoc="x">Simple Contracts on Functions</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="contracts-general-functions.html" class="tocviewlink" data-pltdoc="x">Contracts on Functions in General</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="contracts-first.html" class="tocviewselflink" data-pltdoc="x">Contracts:<span class="mywbr"> &nbsp;</span> A Thorough Example</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="contracts-struct.html" class="tocviewlink" data-pltdoc="x">Contracts on Structures</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="contracts-exists.html" class="tocviewlink" data-pltdoc="x">Abstract Contracts using <span class="RktPn">#:<span class="mywbr"> &nbsp;</span>exists</span> and <span class="RktPn">#:<span class="mywbr"> &nbsp;</span>&#8707;</span></a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="contracts-examples.html" class="tocviewlink" data-pltdoc="x">Additional Examples</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Building_New_Contracts.html" class="tocviewlink" data-pltdoc="x">Building New Contracts</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="contracts-gotchas.html" class="tocviewlink" data-pltdoc="x">Gotchas</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contracts-general-functions.html" title="backward to &quot;7.3 Contracts on Functions in General&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;7 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contracts-struct.html" title="forward to &quot;7.5 Contracts on Structures&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-first&quot;">7.4<tt>&nbsp;</tt><a name="(part._contracts-first)"></a>Contracts: A Thorough Example</h4><p><div class="SIntrapara">This section develops several different flavors of contracts for one and
+ the same example: Racket&rsquo;s <span class="RktSym">argmax</span> function. According to
+ its Racket documentation, the function  consumes a procedure <span class="RktSym">proc</span> and
+ a non-empty list of values, <span class="RktSym">lst</span>. It
+</div><div class="SIntrapara"><blockquote><p>returns the <span class="emph">first</span> element in the list <span class="RktSym">lst</span> that maximizes
+the result of <span class="RktSym">proc</span>.</p></blockquote></div><div class="SIntrapara">The emphasis on <span class="emph">first</span> is ours.</div></p><p><div class="SIntrapara">Examples:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">argmax</span><span class="hspace">&nbsp;</span><span class="RktSym">add1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">list</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">argmax</span><span class="hspace">&nbsp;</span><span class="RktSym">sqrt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">list</span><span class="hspace">&nbsp;</span><span class="RktVal">0.4</span><span class="hspace">&nbsp;</span><span class="RktVal">0.9</span><span class="hspace">&nbsp;</span><span class="RktVal">0.16</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0.9</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">argmax</span><span class="hspace">&nbsp;</span><span class="RktSym">second</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">c</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">d</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">e</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(c 4)</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara">Here is the simplest possible contract for this function:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">version 1</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">argmax</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">provide</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">argmax</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">real?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pair?</span><span class="hspace">&nbsp;</span><span class="RktSym">list?</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote></div><div class="SIntrapara">This contract captures two essential conditions of the informal
+ description of <span class="RktSym">argmax</span>:
+</div><div class="SIntrapara"><ul><li><p>the given function must produce numbers that are comparable according
+to <span class="RktSym">&lt;</span>. In particular, the contract <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="stt"> </span><span class="RktSym">number?</span><span class="RktPn">)</span>
+would not do, because <span class="RktSym">number?</span> also recognizes complex numbers in
+Racket.</p></li><li><p>the given list must contain at least one item.</p></li></ul></div><div class="SIntrapara">When combined with the name, the contract explains the behavior of
+ <span class="RktSym">argmax</span> at the same level as an ML function type in a
+ module signature (except for the non-empty list aspect).</div></p><p><div class="SIntrapara">Contracts may communicate significantly more than a type signature,
+ however. Take a look at this second contract for <span class="RktSym">argmax</span>:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">version 2</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">argmax</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">provide</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">argmax</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">real?</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">lov</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pair?</span><span class="hspace">&nbsp;</span><span class="RktSym">list?</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lambda</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">r</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">for/and</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">&gt;=</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote></div><div class="SIntrapara">It is a <span class="emph">dependent</span> contract that names the two arguments and uses
+ the names to impose a predicate on the result. This predicate computes
+ <span class="RktPn">(</span><span class="RktSym">f</span><span class="stt"> </span><span class="RktSym">r</span><span class="RktPn">)</span> &ndash; where <span class="RktSym">r</span> is the result of <span class="RktSym">argmax</span> &ndash; and
+ then validates that this value is greater than or equal to all values
+ of <span class="RktSym">f</span> on the items of <span class="RktSym">lov</span>.</div></p><p><div class="SIntrapara">Is it possible that <span class="RktSym">argmax</span> could cheat by returning a random value
+ that accidentally maximizes <span class="RktSym">f</span> over all elements of <span class="RktSym">lov</span>?
+ With a contract, it is possible to rule out this possibility:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">version 2 rev. a</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">argmax</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">provide</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">argmax</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">real?</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">lov</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pair?</span><span class="hspace">&nbsp;</span><span class="RktSym">list?</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lambda</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">r</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">and</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">memq</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">for/and</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">&gt;=</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote></div><div class="SIntrapara">The <span class="RktSym">memq</span> function ensures that <span class="RktSym">r</span> is <span class="emph">intensionally equal</span>
+ <span class="refelem"><span class="refcolumn"><span class="refcontent">That is, "pointer equality" for those who prefer to think at
+the hardware level.</span></span></span> to one of the members of <span class="RktSym">lov</span>. Of course, a
+ moment&rsquo;s worth of reflection shows that it is impossible to make up such a
+ value. Functions are opaque values in Racket and without applying a
+ function, it is impossible to determine whether some random input value
+ produces an output value or triggers some exception. So we ignore this
+ possibility from here on.</div></p><p><div class="SIntrapara">Version 2 formulates the overall sentiment of <span class="RktSym">argmax</span>&rsquo;s
+ documentation, but it fails to bring across that the result is the
+ <span class="emph">first</span> element of the given list that maximizes the given function
+ <span class="RktSym">f</span>. Here is a version that communicates this second aspect of
+ the informal documentation:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">version 3</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">argmax</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">provide</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">argmax</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">real?</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">lov</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pair?</span><span class="hspace">&nbsp;</span><span class="RktSym">list?</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lambda</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">r</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">and</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">for/and</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">&gt;=</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eq?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">first</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">memf</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lambda</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">=</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote></div><div class="SIntrapara">That is, the <span class="RktSym">memf</span> function determines the first element of
+ <span class="RktSym">lov</span> whose value under <span class="RktSym">f</span> is equal to <span class="RktSym">r</span>&rsquo;s value
+ under <span class="RktSym">f</span>. If this element is intensionally equal to <span class="RktSym">r</span>,
+ the result of <span class="RktSym">argmax</span> is correct.</div></p><p>This second refinement step introduces two problems. First, both conditions
+ recompute the values of <span class="RktSym">f</span> for all elements of <span class="RktSym">lov</span>. Second,
+ the contract is now quite difficult to read. Contracts should have a concise
+ formulation that a client can comprehend with a simple scan. Let us
+ eliminate the readability problem with two auxiliary functions that have
+ reasonably meaningful names:</p><p><div class="SIntrapara"><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">version 3 rev. a</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">argmax</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">provide</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">argmax</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">real?</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">lov</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pair?</span><span class="hspace">&nbsp;</span><span class="RktSym">list?</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lambda</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">r</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">and</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">is-first-max?</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dominates-all</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">where</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"><span class="stt"><span class="RktSym">f@r</span> is greater or equal to all <span class="RktPn">(</span><span class="RktSym">f</span><span class="stt"> </span><span class="RktSym">v</span><span class="RktPn">)</span> for <span class="RktSym">v</span> in <span class="RktSym">lov</span></span></span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dominates-all</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">for/and</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">&gt;=</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"><span class="stt"><span class="RktSym">r</span> is <span class="RktSym">eq?</span> to the first element <span class="RktSym">v</span> of <span class="RktSym">lov</span>
+for which <span class="RktPn">(</span><span class="RktSym">pred?</span><span class="stt"> </span><span class="RktSym">v</span><span class="RktPn">)</span></span></span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">is-first-max?</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eq?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">first</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">memf</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lambda</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">=</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote></div><div class="SIntrapara">The names of the two predicates express their functionality and, in
+ principle, render it unnecessary to read their definitions.</div></p><p>This step leaves us with the problem of the newly introduced inefficiency.
+ To avoid the recomputation of <span class="RktPn">(</span><span class="RktSym">f</span><span class="stt"> </span><span class="RktSym">v</span><span class="RktPn">)</span> for all <span class="RktSym">v</span> on
+ <span class="RktSym">lov</span>, we change the contract so that it computes these values and
+ reuses them as needed:</p><p><div class="SIntrapara"><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">version 3 rev. b</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">argmax</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">provide</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">argmax</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">real?</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">lov</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pair?</span><span class="hspace">&nbsp;</span><span class="RktSym">list?</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lambda</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">r</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktSym">flov</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">map</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">and</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">is-first-max?</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">map</span><span class="hspace">&nbsp;</span><span class="RktSym">list</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="hspace">&nbsp;</span><span class="RktSym">flov</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dominates-all</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktSym">flov</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">where</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"><span class="stt"><span class="RktSym">f@r</span> is greater or equal to all <span class="RktSym">f@v</span> in <span class="RktSym">flov</span></span></span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dominates-all</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktSym">flov</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">for/and</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">f@v</span><span class="hspace">&nbsp;</span><span class="RktSym">flov</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">&gt;=</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktSym">f@v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"><span class="stt"><span class="RktSym">r</span> is <span class="RktPn">(</span><span class="RktSym">first</span><span class="stt"> </span><span class="RktSym">x</span><span class="RktPn">)</span> for the first
+<span class="RktSym">x</span> in <span class="RktSym">lov+flov</span> s.t. <span class="RktPn">(</span><span class="RktSym">=</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">second</span><span class="stt"> </span><span class="RktSym">x</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym">f@r</span><span class="RktPn">)</span></span></span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">is-first-max?</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktSym">lov+flov</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktSym">fst</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">first</span><span class="hspace">&nbsp;</span><span class="RktSym">lov+flov</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">if</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">=</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">second</span><span class="hspace">&nbsp;</span><span class="RktSym">fst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eq?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">first</span><span class="hspace">&nbsp;</span><span class="RktSym">fst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">is-first-max?</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rest</span><span class="hspace">&nbsp;</span><span class="RktSym">lov+flov</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote></div><div class="SIntrapara">Now the predicate on the result once again computes all values of <span class="RktSym">f</span>
+ for elements of <span class="RktSym">lov</span> once.</div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The word "eager" comes from the literature on the linguistics
+of contracts.</p></blockquote></blockquote></blockquote><p>Version 3 may still be too eager when it comes to calling <span class="RktSym">f</span>. While
+ Racket&rsquo;s <span class="RktSym">argmax</span> always calls <span class="RktSym">f</span> no matter how many items
+ <span class="RktSym">lov</span> contains, let us imagine for illustrative purposes that our
+ own implementation first checks whether the list is a singleton.  If so,
+ the first element would be the only element of <span class="RktSym">lov</span> and in that
+ case there would be no need to compute <span class="RktPn">(</span><span class="RktSym">f</span><span class="stt"> </span><span class="RktSym">r</span><span class="RktPn">)</span>.
+<span class="refelem"><span class="refcolumn"><span class="refcontent">The <span class="RktSym">argmax</span> of Racket implicitly argues that it not
+only promises the first value that maximizes <span class="RktSym">f</span> over <span class="RktSym">lov</span>
+but also that <span class="RktSym">f</span> produces/produced a value for the result.</span></span></span>
+ As a matter of fact, since <span class="RktSym">f</span> may diverge or raise an exception
+ for some inputs, <span class="RktSym">argmax</span> should avoid calling <span class="RktSym">f</span> when
+ possible.</p><p>The following contract demonstrates how a higher-order dependent contract
+ needs to be adjusted so as to avoid being over-eager:</p><p><div class="SIntrapara"><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">version 4</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">argmax</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">if</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">empty?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rest</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">first</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">provide</span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">argmax</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">real?</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">lov</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pair?</span><span class="hspace">&nbsp;</span><span class="RktSym">list?</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lambda</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">r</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">cond</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">empty?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rest</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eq?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">first</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">else</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktSym">flov</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">map</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">and</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">is-first-max?</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">map</span><span class="hspace">&nbsp;</span><span class="RktSym">list</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="hspace">&nbsp;</span><span class="RktSym">flov</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dominates-all</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktSym">flov</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">where</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"><span class="stt"><span class="RktSym">f@r</span> is greater or equal to all <span class="RktSym">f@v</span> in <span class="RktSym">flov</span></span></span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dominates-all</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktSym">lov</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"><span class="stt"><span class="RktSym">r</span> is <span class="RktPn">(</span><span class="RktSym">first</span><span class="stt"> </span><span class="RktSym">x</span><span class="RktPn">)</span> for the first
+<span class="RktSym">x</span> in <span class="RktSym">lov+flov</span> s.t. <span class="RktPn">(</span><span class="RktSym">=</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">second</span><span class="stt"> </span><span class="RktSym">x</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym">f@r</span><span class="RktPn">)</span></span></span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">define</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">is-first-max?</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktSym">f@r</span><span class="hspace">&nbsp;</span><span class="RktSym">lov+flov</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote></div><div class="SIntrapara">Note that such considerations don&rsquo;t apply to the world of first-order
+ contracts. Only a higher-order (or lazy) language forces the programmer to
+ express contracts with such precision.</div></p><p>The problem of diverging or exception-raising functions should alert the
+ reader to the even more general problem of functions with side-effects. If
+ the given function <span class="RktSym">f</span> has visible effects &ndash; say it logs its calls
+ to a file &ndash; then the clients of <span class="RktSym">argmax</span> will be able to observe
+ two sets of logs for each call to <span class="RktSym">argmax</span>. To be precise, if the
+ list of values contains more than one element, the log will contain two
+ calls of <span class="RktSym">f</span> per value on <span class="RktSym">lov</span>. If <span class="RktSym">f</span> is expensive
+ to compute, doubling the calls imposes a high cost.</p><p>To avoid this cost and to signal problems with overly eager contracts, a
+ contract system could record the i/o of contracted function arguments and
+ use these hashtables in the dependency specification. This is a topic of
+ on-going research in PLT. Stay tuned.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contracts-general-functions.html" title="backward to &quot;7.3 Contracts on Functions in General&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;7 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contracts-struct.html" title="forward to &quot;7.5 Contracts on Structures&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-general-functions.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-general-functions.html
new file mode 100644
index 00000000..195aedab
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-general-functions.html
@@ -0,0 +1,186 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7.3&nbsp;Contracts on Functions in General</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="contract-boundaries.html" class="tocviewlink" data-pltdoc="x">Contracts and Boundaries</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="contract-func.html" class="tocviewlink" data-pltdoc="x">Simple Contracts on Functions</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="contracts-general-functions.html" class="tocviewselflink" data-pltdoc="x">Contracts on Functions in General</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="contracts-first.html" class="tocviewlink" data-pltdoc="x">Contracts:<span class="mywbr"> &nbsp;</span> A Thorough Example</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="contracts-struct.html" class="tocviewlink" data-pltdoc="x">Contracts on Structures</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="contracts-exists.html" class="tocviewlink" data-pltdoc="x">Abstract Contracts using <span class="RktPn">#:<span class="mywbr"> &nbsp;</span>exists</span> and <span class="RktPn">#:<span class="mywbr"> &nbsp;</span>&#8707;</span></a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="contracts-examples.html" class="tocviewlink" data-pltdoc="x">Additional Examples</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Building_New_Contracts.html" class="tocviewlink" data-pltdoc="x">Building New Contracts</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="contracts-gotchas.html" class="tocviewlink" data-pltdoc="x">Gotchas</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>7.3&nbsp;</td><td><a href="contracts-general-functions.html" class="tocviewselflink" data-pltdoc="x">Contracts on Functions in General</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.3.1&nbsp;</td><td><a href="contracts-general-functions.html#%28part._contracts-optional%29" class="tocviewlink" data-pltdoc="x">Optional Arguments</a></td></tr><tr><td align="right">7.3.2&nbsp;</td><td><a href="contracts-general-functions.html#%28part._contracts-rest-args%29" class="tocviewlink" data-pltdoc="x">Rest Arguments</a></td></tr><tr><td align="right">7.3.3&nbsp;</td><td><a href="contracts-general-functions.html#%28part._contracts-keywords%29" class="tocviewlink" data-pltdoc="x">Keyword Arguments</a></td></tr><tr><td align="right">7.3.4&nbsp;</td><td><a href="contracts-general-functions.html#%28part._contracts-optional-keywords%29" class="tocviewlink" data-pltdoc="x">Optional Keyword Arguments</a></td></tr><tr><td align="right">7.3.5&nbsp;</td><td><a href="contracts-general-functions.html#%28part._contracts-case-lambda%29" class="tocviewlink" data-pltdoc="x">Contracts for <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td align="right">7.3.6&nbsp;</td><td><a href="contracts-general-functions.html#%28part._contracts-arrow-d%29" class="tocviewlink" data-pltdoc="x">Argument and Result Dependencies</a></td></tr><tr><td align="right">7.3.7&nbsp;</td><td><a href="contracts-general-functions.html#%28part._contracts-arrow-d-eval-order%29" class="tocviewlink" data-pltdoc="x">Checking State Changes</a></td></tr><tr><td align="right">7.3.8&nbsp;</td><td><a href="contracts-general-functions.html#%28part._contracts-multiple%29" class="tocviewlink" data-pltdoc="x">Multiple Result Values</a></td></tr><tr><td align="right">7.3.9&nbsp;</td><td><a href="contracts-general-functions.html#%28part._contracts-no-domain%29" class="tocviewlink" data-pltdoc="x">Fixed but Statically Unknown Arities</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">7.3.1<tt>&nbsp;</tt></span><a href="contracts-general-functions.html#%28part._contracts-optional%29" class="tocsubseclink" data-pltdoc="x">Optional Arguments</a></td></tr><tr><td><span class="tocsublinknumber">7.3.2<tt>&nbsp;</tt></span><a href="contracts-general-functions.html#%28part._contracts-rest-args%29" class="tocsubseclink" data-pltdoc="x">Rest Arguments</a></td></tr><tr><td><span class="tocsublinknumber">7.3.3<tt>&nbsp;</tt></span><a href="contracts-general-functions.html#%28part._contracts-keywords%29" class="tocsubseclink" data-pltdoc="x">Keyword Arguments</a></td></tr><tr><td><span class="tocsublinknumber">7.3.4<tt>&nbsp;</tt></span><a href="contracts-general-functions.html#%28part._contracts-optional-keywords%29" class="tocsubseclink" data-pltdoc="x">Optional Keyword Arguments</a></td></tr><tr><td><span class="tocsublinknumber">7.3.5<tt>&nbsp;</tt></span><a href="contracts-general-functions.html#%28part._contracts-case-lambda%29" class="tocsubseclink" data-pltdoc="x">Contracts for <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr><tr><td><span class="tocsublinknumber">7.3.6<tt>&nbsp;</tt></span><a href="contracts-general-functions.html#%28part._contracts-arrow-d%29" class="tocsubseclink" data-pltdoc="x">Argument and Result Dependencies</a></td></tr><tr><td><span class="tocsublinknumber">7.3.7<tt>&nbsp;</tt></span><a href="contracts-general-functions.html#%28part._contracts-arrow-d-eval-order%29" class="tocsubseclink" data-pltdoc="x">Checking State Changes</a></td></tr><tr><td><span class="tocsublinknumber">7.3.8<tt>&nbsp;</tt></span><a href="contracts-general-functions.html#%28part._contracts-multiple%29" class="tocsubseclink" data-pltdoc="x">Multiple Result Values</a></td></tr><tr><td><span class="tocsublinknumber">7.3.9<tt>&nbsp;</tt></span><a href="contracts-general-functions.html#%28part._contracts-no-domain%29" class="tocsubseclink" data-pltdoc="x">Fixed but Statically Unknown Arities</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contract-func.html" title="backward to &quot;7.2 Simple Contracts on Functions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;7 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contracts-first.html" title="forward to &quot;7.4 Contracts: A Thorough Example&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-general-functions&quot;">7.3<tt>&nbsp;</tt><a name="(part._contracts-general-functions)"></a>Contracts on Functions in General</h4><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span> contract constructor works for functions that take a
+fixed number of arguments and where the result contract is independent
+of the input arguments. To support other kinds of functions, Racket
+supplies additional contract constructors, notably <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-optional&quot;">7.3.1<tt>&nbsp;</tt><a name="(part._contracts-optional)"></a>Optional Arguments</h5><p>Take a look at this excerpt from a string-processing module:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">pad the given str left and right with</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">the (optional) char so that it is centered</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">string-pad-center</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._natural-number%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">natural-number/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">string-pad-center</span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="hspace">&nbsp;</span><span class="RktSym">width</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">pad</span><span class="hspace">&nbsp;</span><span class="RktVal">#\space</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">field-width</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._min%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">min</a></span><span class="hspace">&nbsp;</span><span class="RktSym">width</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rmargin</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._ceiling%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">ceiling</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">width</span><span class="hspace">&nbsp;</span><span class="RktSym">field-width</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lmargin</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._floor%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">floor</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">width</span><span class="hspace">&nbsp;</span><span class="RktSym">field-width</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._build-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">build-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lmargin</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">pad</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">str</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._build-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">build-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rmargin</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">pad</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The module exports <span class="RktSym">string-pad-center</span>, a function
+ that creates a string of a given <span class="RktSym">width</span> with the
+ given string in the center. The default fill character is
+ <span class="RktVal">#\space</span>; if the client module wishes to use a
+ different character, it may call <span class="RktSym">string-pad-center</span>
+ with a third argument, a <span class="RktSym">char</span>, overwriting the
+ default.</p><p>The function definition uses optional arguments, which is
+appropriate for this kind of functionality. The interesting
+point here is the formulation of the contract for the
+<span class="RktSym">string-pad-center</span>.</p><p>The contract combinator <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span>, demands several groups of contracts:</p><ul><li><p>The first one is a parenthesized group of contracts for all required
+arguments. In this example, we see two: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._natural-number%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">natural-number/c</a></span>. </p></li><li><p>The second one is a parenthesized group of contracts for all optional
+arguments: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char?</a></span>. </p></li><li><p>The last one is a single contract: the result of the function.</p></li></ul><p>Note that if a default value does not satisfy a contract, you won&rsquo;t get a
+ contract error for this interface. If you can&rsquo;t trust yourself to get
+ the initial value right, you need to communicate the initial value
+ across a boundary.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-rest-args&quot;">7.3.2<tt>&nbsp;</tt><a name="(part._contracts-rest-args)"></a>Rest Arguments</h5><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._max%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">max</a></span> operator consumes at least one real number, but it
+ accepts any number of additional arguments. You can write other such
+ functions using a <a href="lambda.html#%28tech._rest._argument%29" class="techoutside" data-pltdoc="x"><span class="techinside">rest argument</span></a>, such as in <span class="RktSym">max-abs</span>:</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See <a href="lambda.html#%28part._rest-args%29" data-pltdoc="x">Declaring a Rest Argument</a> for an introduction to rest
+arguments.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">max-abs</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">rst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._foldr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">foldr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._max%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">max</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._abs%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">abs</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._abs%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">abs</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">rst</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Describing this function through a contract requires a further
+extension of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span>: a <span class="RktPn">#:rest</span> keyword specifies a
+contract on a list of arguments after the required and optional
+arguments:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">max-abs</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._real%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">real?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._listof%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._real%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">real?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._real%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">real?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>As always for <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span>, the contracts for the required arguments
+are enclosed in the first pair of parentheses, which in this case is a
+single real number. The empty pair of parenthesis indicates that there
+are no optional arguments (not counting the rest arguments). The
+contract for the rest argument follows <span class="RktPn">#:rest</span>; since all
+additional arguments must be real numbers, the list of rest arguments
+must satisfy the contract <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._listof%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="stt"> </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._real%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">real?</a></span><span class="RktPn">)</span>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-keywords&quot;">7.3.3<tt>&nbsp;</tt><a name="(part._contracts-keywords)"></a>Keyword Arguments</h5><p>It turns out that the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span> contract constructor also contains
+support for keyword arguments. For example, consider this function,
+which creates a simple GUI and asks the user a yes-or-no question:</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See <a href="lambda.html#%28part._lambda-keywords%29" data-pltdoc="x">Declaring Keyword Arguments</a> for an introduction to
+keyword arguments.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/gui</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ask-yes-or-no-question</span><span class="hspace">&nbsp;</span><span class="RktSym">question</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:default</span><span class="hspace">&nbsp;</span><span class="RktSym">answer</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:title</span><span class="hspace">&nbsp;</span><span class="RktSym">title</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktSym">w</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:height</span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=dialog_.html&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">dialog%</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">label</span><span class="hspace">&nbsp;</span><span class="RktSym">title</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">width</span><span class="hspace">&nbsp;</span><span class="RktSym">w</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">height</span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">msg</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=message_.html&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">message%</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">label</span><span class="hspace">&nbsp;</span><span class="RktSym">question</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">parent</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">yes</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">answer</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">no</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">answer</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">yes-b</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=button_.html&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">button%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">label</span><span class="hspace">&nbsp;</span><span class="RktVal">"Yes"</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">parent</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">callback</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">yes</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">style</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktSym">answer</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">border</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">no-b</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=objcreation.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._new%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">new</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=button_.html&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">button%</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">label</span><span class="hspace">&nbsp;</span><span class="RktVal">"No"</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">parent</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">callback</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">no</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">style</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktSym">answer</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">border</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">answer</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">ask-yes-or-no-question</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:default</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:title</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:height</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>If you really want to ask a yes-or-no question
+via a GUI, you should use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=Windowing_Functions.html%23%2528def._%2528%2528lib._mred%252Fmain..rkt%2529._message-box%252Fcustom%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">message-box/custom</a></span>. For that
+matter, it&rsquo;s usually better to provide buttons with more specific
+answers than &ldquo;yes&rdquo; and &ldquo;no.&rdquo;</p></blockquote></blockquote></blockquote><p>The contract for <span class="RktSym">ask-yes-or-no-question</span> uses <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span>, and
+in the same way that <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> (or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span>-based
+functions) allows a keyword to precede a functions formal argument,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span> allows a keyword to precede a function contract&rsquo;s argument
+contract. In this case,
+the contract says that <span class="RktSym">ask-yes-or-no-question</span> must receive four keyword
+arguments, one for each of the keywords
+<span class="RktPn">#:default</span>,
+<span class="RktPn">#:title</span>,
+<span class="RktPn">#:width</span>, and
+<span class="RktPn">#:height</span>.
+As in a function definition, the order of the keywords in <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span>
+relative to each other does not matter for clients of the function;
+only the relative order of argument contracts without keywords
+matters.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-optional-keywords&quot;">7.3.4<tt>&nbsp;</tt><a name="(part._contracts-optional-keywords)"></a>Optional Keyword Arguments</h5><p>Of course, many of the parameters in
+<span class="RktSym">ask-yes-or-no-question</span> (from the previous question)
+have reasonable defaults and should be made optional:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ask-yes-or-no-question</span><span class="hspace">&nbsp;</span><span class="RktSym">question</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:default</span><span class="hspace">&nbsp;</span><span class="RktSym">answer</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:title</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">title</span><span class="hspace">&nbsp;</span><span class="RktVal">"Yes or No?"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">w</span><span class="hspace">&nbsp;</span><span class="RktVal">400</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:height</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktVal">200</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr></table></blockquote><p>To specify this function&rsquo;s contract, we need to use
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span> again. It supports keywords just as you might
+expect in both the optional and mandatory argument
+sections. In this case, we have the mandatory keyword
+<span class="RktPn">#:default</span> and optional keywords
+<span class="RktPn">#:title</span>,
+<span class="RktPn">#:width</span>, and
+<span class="RktPn">#:height</span>. So, we write the contract like this:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">ask-yes-or-no-question</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:default</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">#:title</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:width</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exact-integer?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:height</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exact-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>That is, we put the mandatory keywords in the first section, and we
+put the optional ones in the second section.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-case-lambda&quot;">7.3.5<tt>&nbsp;</tt><a name="(part._contracts-case-lambda)"></a>Contracts for <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._case-lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case-lambda</a></span></h5><p>A function defined with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._case-lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case-lambda</a></span> might impose different
+constraints on its arguments depending on how many are provided. For
+example, a <span class="RktSym">report-cost</span> function might convert either a pair
+of numbers or a string into a new string:</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See <a href="lambda.html#%28part._case-lambda%29" data-pltdoc="x">Arity-Sensitive Functions: <span class="RktSym"><span class="RktStxLink">case-lambda</span></span></a> for an introduction to
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._case-lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case-lambda</a></span>.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">report-cost</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._case-lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case-lambda</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">lo</span><span class="hspace">&nbsp;</span><span class="RktSym">hi</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._format%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"between $~a and $~a"</span><span class="hspace">&nbsp;</span><span class="RktSym">lo</span><span class="hspace">&nbsp;</span><span class="RktSym">hi</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">desc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._format%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a of dollars"</span><span class="hspace">&nbsp;</span><span class="RktSym">desc</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">report-cost</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"between $5 and $8"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">report-cost</span><span class="hspace">&nbsp;</span><span class="RktVal">"millions"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"millions of dollars"</span></p></td></tr></table></td></tr></table></blockquote><p><div class="SIntrapara">The contract for such a function is formed with the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._case-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case-&gt;</a></span>
+ combinator, which combines as many functional contracts as needed:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">report-cost</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._case-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case-&gt;</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">As you can see, the contract for <span class="RktSym">report-cost</span> combines two
+ function contracts, which is just as many clauses as the explanation
+ of its functionality required.</div></p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-arrow-d&quot;">7.3.6<tt>&nbsp;</tt><a name="(part._contracts-arrow-d)"></a>Argument and Result Dependencies</h5><p>The following is an excerpt from an imaginary numerics module:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">real-sqrt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">argument</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._%7E3e%7E3d%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">argument</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._%7E3c%7E3d%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&lt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">argument</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The word &ldquo;indy&rdquo; is meant to suggest that blame may be
+assigned to the contract itself, because the contract must be considered an
+independent component. The name was chosen in
+response to two existing labels&#8212;<wbr></wbr>&ldquo;lax&rdquo; and &ldquo;picky&rdquo;&#8212;<wbr></wbr>for different
+semantics of function contracts in the research literature.</p></blockquote></blockquote></blockquote></div><div class="SIntrapara">The contract for the exported function <span class="RktSym">real-sqrt</span> uses the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span> rather than <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span> function contract. The &ldquo;i&rdquo;
+stands for an <span style="font-style: italic">indy dependent</span> contract, meaning the contract for the
+function range depends on the value of the argument. The appearance
+of <span class="RktSym">argument</span> in the line for <span class="RktSym">result</span>&rsquo;s contract means
+that the result depends on the argument. In this
+particular case, the argument of <span class="RktSym">real-sqrt</span> is greater or
+equal to 1, so a very basic correctness check is that the result is
+smaller than the argument.</div></p><p>In general, a dependent function contract looks just like
+the more general <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span> contract, but with names added
+that can be used elsewhere in the contract.</p><p>Going back to the bank-account example, suppose that we generalize the
+module to support multiple accounts and that we also include a
+withdrawal operation. The improved bank-account module includes an
+<span class="RktSym">account</span> structure type and the following functions:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">balance</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">account?</span><span class="hspace">&nbsp;</span><span class="RktSym">amount/c</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">withdraw</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">account?</span><span class="hspace">&nbsp;</span><span class="RktSym">amount/c</span><span class="hspace">&nbsp;</span><span class="RktSym">account?</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">deposit</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">account?</span><span class="hspace">&nbsp;</span><span class="RktSym">amount/c</span><span class="hspace">&nbsp;</span><span class="RktSym">account?</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Besides requiring that a client provide a valid amount for a
+withdrawal, however, the amount should be less than or equal to the specified
+account&rsquo;s balance, and the resulting account will have less money than
+it started with. Similarly, the module might promise that a deposit
+produces an account with money added to the account. The following
+implementation enforces those constraints and guarantees through
+contracts:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">section 1: the contract definitions</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">account</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">balance</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount/c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._natural-number%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">natural-number/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">section 2: the exports</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">create</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">amount/c</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym">account?</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">balance</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">account?</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym">amount/c</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">withdraw</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">acc</span><span class="hspace">&nbsp;</span><span class="RktSym">account?</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">amt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">acc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount/c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._%7E3c%7E3d%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&lt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">balance</span><span class="hspace">&nbsp;</span><span class="RktSym">acc</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">acc</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">account?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">res</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">balance</span><span class="hspace">&nbsp;</span><span class="RktSym">res</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">balance</span><span class="hspace">&nbsp;</span><span class="RktSym">acc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">deposit</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">acc</span><span class="hspace">&nbsp;</span><span class="RktSym">account?</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">amt</span><span class="hspace">&nbsp;</span><span class="RktSym">amount/c</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">acc</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">account?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">res</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">balance</span><span class="hspace">&nbsp;</span><span class="RktSym">res</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">balance</span><span class="hspace">&nbsp;</span><span class="RktSym">acc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">section 3: the function definitions</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">balance</span><span class="hspace">&nbsp;</span><span class="RktSym">account-balance</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">create</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">account</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">withdraw</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">account</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">account-balance</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">deposit</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">account</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">account-balance</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The contracts in section 2 provide typical type-like guarantees for
+<span class="RktSym">create</span> and <span class="RktSym">balance</span>. For <span class="RktSym">withdraw</span> and
+<span class="RktSym">deposit</span>, however, the contracts check and guarantee the more
+complicated constraints on <span class="RktSym">balance</span> and <span class="RktSym">deposit</span>.  The
+contract on the second argument to <span class="RktSym">withdraw</span> uses
+<span class="RktPn">(</span><span class="RktSym">balance</span><span class="stt"> </span><span class="RktSym">acc</span><span class="RktPn">)</span> to check whether the supplied withdrawal amount
+is small enough, where <span class="RktSym">acc</span> is the name given within
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span> to the function&rsquo;s first argument. The contract on the
+result of <span class="RktSym">withdraw</span> uses both <span class="RktSym">acc</span> and <span class="RktSym">amt</span> to
+guarantee that no more than that requested amount was withdrawn. The
+contract on <span class="RktSym">deposit</span> similarly uses <span class="RktSym">acc</span> and
+<span class="RktSym">amount</span> in the result contract to guarantee that at least as
+much money as provided was deposited into the account.</p><p>As written above, when a contract check fails, the error message is
+not great. The following revision uses <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._flat-named-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">flat-named-contract</a></span>
+within a helper function <span class="RktSym">mk-account-contract</span> to provide
+better error messages.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">section 1: the contract definitions</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">account</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">balance</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount/c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._natural-number%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">natural-number/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">msg&gt;</span><span class="hspace">&nbsp;</span><span class="RktVal">"account a with balance larger than ~a expected"</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">msg&lt;</span><span class="hspace">&nbsp;</span><span class="RktVal">"account a with balance less than ~a expected"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mk-account-contract</span><span class="hspace">&nbsp;</span><span class="RktSym">acc</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="hspace">&nbsp;</span><span class="RktSym">op</span><span class="hspace">&nbsp;</span><span class="RktSym">msg</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">balance0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">balance</span><span class="hspace">&nbsp;</span><span class="RktSym">acc</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">ctr</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">account?</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">op</span><span class="hspace">&nbsp;</span><span class="RktSym">balance0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">balance</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._flat-named-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">flat-named-contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._format%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktSym">msg</span><span class="hspace">&nbsp;</span><span class="RktSym">balance0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">ctr</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">section 2: the exports</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">create</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">amount/c</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym">account?</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">balance</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">account?</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym">amount/c</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">withdraw</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">acc</span><span class="hspace">&nbsp;</span><span class="RktSym">account?</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">amt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">acc</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">amount/c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._%7E3c%7E3d%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&lt;=/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">balance</span><span class="hspace">&nbsp;</span><span class="RktSym">acc</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">acc</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mk-account-contract</span><span class="hspace">&nbsp;</span><span class="RktSym">acc</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">msg&gt;</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">deposit</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">acc</span><span class="hspace">&nbsp;</span><span class="RktSym">account?</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">amt</span><span class="hspace">&nbsp;</span><span class="RktSym">amount/c</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">acc</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mk-account-contract</span><span class="hspace">&nbsp;</span><span class="RktSym">acc</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3c%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&lt;=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">msg&lt;</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">section 3: the function definitions</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">balance</span><span class="hspace">&nbsp;</span><span class="RktSym">account-balance</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">create</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">account</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">withdraw</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">account</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">account-balance</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">deposit</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">account</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">account-balance</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">amt</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-arrow-d-eval-order&quot;">7.3.7<tt>&nbsp;</tt><a name="(part._contracts-arrow-d-eval-order)"></a>Checking State Changes</h5><p><div class="SIntrapara">The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span> contract combinator can also ensure that a
+function only modifies state according to certain
+constraints. For example, consider this contract
+(it is a slightly simplified version from the function
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=framework&amp;rel=Preferences.html%23%2528def._%2528%2528lib._framework%252Fmain..rkt%2529._preferences%7E3aadd-panel%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">preferences:add-panel</a></span> in the framework):
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">parent</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Object_and_Class_Contracts.html%23%2528def._%2528%2528lib._racket%252Fclass..rkt%2529._is-a%7E3f%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">is-a?/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=area-container-window___.html&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">area-container-window&lt;%&gt;</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">parent</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">old-children</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">parent</span><span class="hspace">&nbsp;</span><span class="RktSym">get-children</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">child</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._andmap%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">andmap</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">old-children</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">child</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ivaraccess.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._send%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">send</a></span><span class="hspace">&nbsp;</span><span class="RktSym">parent</span><span class="hspace">&nbsp;</span><span class="RktSym">get-children</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">It says that the function accepts a single argument, named
+<span class="RktSym">parent</span>, and that <span class="RktSym">parent</span> must be
+an object matching the interface <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=area-container-window___.html&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">area-container-window&lt;%&gt;</a></span>.</div></p><p>The range contract ensures that the function only modifies
+the children of <span class="RktSym">parent</span> by adding a new child to the
+front of the list. It accomplishes this by using the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span> instead of a normal identifier, which tells the
+contract library that the range contract does not depend on
+the values of any of the results, and thus the contract
+library evaluates the expression following the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span>
+when the function is called, instead of when it
+returns. Therefore the call to the <span class="RktSym">get-children</span> method
+happens before the function under the contract is called.
+When the function under contract returns, its result is
+passed in as <span class="RktSym">child</span>, and the contract ensures that
+the children after the function return are the same as the
+children before the function called, but with one more
+child, at the front of the list.</p><p><div class="SIntrapara">To see the difference in a toy example that focuses
+on this point, consider this program
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">ctc</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">get-x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._listof%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">If you were to require this module, call <span class="RktSym">f</span>, then
+the result of <span class="RktSym">get-x</span> would be <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">f</span><span class="stt"> </span><span class="RktVal">ctc</span><span class="RktVal">)</span>. In
+contrast, if the contract for <span class="RktSym">f</span> were
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">res</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">ctc</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></p></blockquote></div><div class="SIntrapara">(only changing the underscore to <span class="RktSym">res</span>), then
+the result of <span class="RktSym">get-x</span> would be <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">ctc</span><span class="stt"> </span><span class="RktVal">f</span><span class="RktVal">)</span>.</div></p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-multiple&quot;">7.3.8<tt>&nbsp;</tt><a name="(part._contracts-multiple)"></a>Multiple Result Values</h5><p><div class="SIntrapara">The function <span class="RktSym">split</span> consumes a list of <span class="RktSym">char</span>s
+  and delivers the string that occurs before the first occurrence of
+  <span class="RktVal">#\newline</span> (if any) and the rest of the list:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">split</span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">split</span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktSym">w</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list-%7E3estring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._reverse%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">reverse</a></span><span class="hspace">&nbsp;</span><span class="RktSym">w</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char%7E3d%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char=?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\newline</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list-%7E3estring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._reverse%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">reverse</a></span><span class="hspace">&nbsp;</span><span class="RktSym">w</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">split</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">w</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">split</span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">It is a typical multiple-value function, returning two values by
+  traversing a single list.</div></p><p><div class="SIntrapara">The contract for such a function can use the ordinary
+function arrow <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span>, since <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span>
+treats <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span> specially when it appears as the
+last result:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">split</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._listof%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._listof%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p><div class="SIntrapara">The contract for such a function can also be written
+using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span>:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">split</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._listof%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._listof%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">As before, the contract for the argument with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span> is wrapped in an
+ extra pair of parentheses (and must always be wrapped like
+ that) and the empty pair of parentheses indicates that
+ there are no optional arguments. The contracts for the
+ results are inside <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span>: a string and a list of
+ characters.</div></p><p><div class="SIntrapara">Now, suppose that we also want to ensure that the first result of
+ <span class="RktSym">split</span> is a prefix of the given word in list format. In that
+ case, we need to use the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span> contract combinator:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">substring-of?</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._flat-named-contract%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">flat-named-contract</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._format%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"substring of ~s"</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3c%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&lt;=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._substring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">substring</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">s2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">split</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">fl</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._listof%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fl</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">substring-of?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list-%7E3estring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fl</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._listof%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span>, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span> combinator uses a function over the
+ argument to create the range contracts. Yes, it doesn&rsquo;t just return one
+ contract but as many as the function produces values: one contract per
+ value.  In this case, the second contract is the same as before, ensuring
+ that the second result is a list of <span class="RktSym">char</span>s. In contrast, the
+ first contract strengthens the old one so that the result is a prefix of
+ the given word.</div></p><p><div class="SIntrapara">This contract is expensive to check, of course. Here is a
+  cheaper, though less stringent, version:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">split</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">fl</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._listof%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fl</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._string-len%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-len/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fl</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._listof%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Stop! Why did we add <span class="RktVal">1</span> to the length of <span class="RktSym">fl</span>?</div></p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-no-domain&quot;">7.3.9<tt>&nbsp;</tt><a name="(part._contracts-no-domain)"></a>Fixed but Statically Unknown Arities</h5><p>Imagine yourself writing a contract for a function that accepts some other
+function and a list of numbers that eventually applies the former to the
+latter. Unless the arity of the given function matches the length of the
+given list, your procedure is in trouble.</p><p><div class="SIntrapara">Consider this <span class="RktSym">n-step</span> function:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">(number ... -&gt; (union #f number?)) (listof number) -&gt; void</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n-step</span><span class="hspace">&nbsp;</span><span class="RktSym">proc</span><span class="hspace">&nbsp;</span><span class="RktSym">inits</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">inc</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym">proc</span><span class="hspace">&nbsp;</span><span class="RktSym">inits</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._when%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">when</a></span><span class="hspace">&nbsp;</span><span class="RktSym">inc</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n-step</span><span class="hspace">&nbsp;</span><span class="RktSym">proc</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">inc</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">inits</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p>The argument of <span class="RktSym">n-step</span> is <span class="RktSym">proc</span>, a function
+<span class="RktSym">proc</span> whose results are either numbers or false, and a list. It
+then applies <span class="RktSym">proc</span> to the list <span class="RktSym">inits</span>. As long as
+<span class="RktSym">proc</span> returns a number, <span class="RktSym">n-step</span> treats that number
+as an increment for each of the numbers in <span class="RktSym">inits</span> and
+recurs. When <span class="RktSym">proc</span> returns <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528lib._racket%252Fbool..rkt%2529._false%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">false</a></span>, the loop stops.</p><p><div class="SIntrapara">Here are two uses:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">nat -&gt; nat</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~s\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">n-step</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">nat nat -&gt; nat</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">g</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~s\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">n-step</span><span class="hspace">&nbsp;</span><span class="RktSym">g</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p><div class="SIntrapara">A contract for <span class="RktSym">n-step</span> must specify two aspects of
+<span class="RktSym">proc</span>&rsquo;s behavior: its arity must include the number of elements
+in <span class="RktSym">inits</span>, and it must return either a number or
+<span class="RktVal">#f</span>. The latter is easy, the former is difficult. At first
+glance, this appears to suggest a contract that assigns a
+<span style="font-style: italic">variable-arity</span> to <span class="RktSym">proc</span>:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:rest</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._listof%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._or%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._false%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">false/c</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">This contract, however, says that the function must accept <span class="emph">any</span>
+number of arguments, not a <span class="emph">specific</span> but
+<span class="emph">undetermined</span> number. Thus, applying <span class="RktSym">n-step</span> to
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym">x</span><span class="RktPn">)</span> and <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span> breaks the contract
+because the given function accepts only one argument.</div></p><p><div class="SIntrapara">The correct contract uses the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._unconstrained-domain-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unconstrained-domain-&gt;</a></span>
+ combinator, which specifies only the range of a function, not its
+ domain. It is then possible to combine this contract with an arity test to
+ specify the correct contract for <span class="RktSym">n-step</span>:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">n-step</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3ei%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>i</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">proc</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">inits</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._and%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">and/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._unconstrained-domain-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unconstrained-domain-&gt;</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._or%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._false%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">false/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._procedure-arity-includes%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">procedure-arity-includes?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">inits</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">inits</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._listof%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">listof</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">any</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contract-func.html" title="backward to &quot;7.2 Simple Contracts on Functions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;7 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contracts-first.html" title="forward to &quot;7.4 Contracts: A Thorough Example&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-gotchas.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-gotchas.html
new file mode 100644
index 00000000..db8d7a65
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-gotchas.html
@@ -0,0 +1,61 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7.9&nbsp;Gotchas</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="contract-boundaries.html" class="tocviewlink" data-pltdoc="x">Contracts and Boundaries</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="contract-func.html" class="tocviewlink" data-pltdoc="x">Simple Contracts on Functions</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="contracts-general-functions.html" class="tocviewlink" data-pltdoc="x">Contracts on Functions in General</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="contracts-first.html" class="tocviewlink" data-pltdoc="x">Contracts:<span class="mywbr"> &nbsp;</span> A Thorough Example</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="contracts-struct.html" class="tocviewlink" data-pltdoc="x">Contracts on Structures</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="contracts-exists.html" class="tocviewlink" data-pltdoc="x">Abstract Contracts using <span class="RktPn">#:<span class="mywbr"> &nbsp;</span>exists</span> and <span class="RktPn">#:<span class="mywbr"> &nbsp;</span>&#8707;</span></a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="contracts-examples.html" class="tocviewlink" data-pltdoc="x">Additional Examples</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Building_New_Contracts.html" class="tocviewlink" data-pltdoc="x">Building New Contracts</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="contracts-gotchas.html" class="tocviewselflink" data-pltdoc="x">Gotchas</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>7.9&nbsp;</td><td><a href="contracts-gotchas.html" class="tocviewselflink" data-pltdoc="x">Gotchas</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.9.1&nbsp;</td><td><a href="contracts-gotchas.html#%28part._.Contracts_and_eq_%29" class="tocviewlink" data-pltdoc="x">Contracts and <span class="RktSym"><span class="RktValLink">eq?</span></span></a></td></tr><tr><td align="right">7.9.2&nbsp;</td><td><a href="contracts-gotchas.html#%28part._contracts-gotcha-nested%29" class="tocviewlink" data-pltdoc="x">Contract boundaries and <span class="RktSym"><span class="RktStxLink">define/<span class="mywbr"> &nbsp;</span>contract</span></span></a></td></tr><tr><td align="right">7.9.3&nbsp;</td><td><a href="contracts-gotchas.html#%28part._contracts-exists-gotcha%29" class="tocviewlink" data-pltdoc="x">Exists Contracts and Predicates</a></td></tr><tr><td align="right">7.9.4&nbsp;</td><td><a href="contracts-gotchas.html#%28part._.Defining_.Recursive_.Contracts%29" class="tocviewlink" data-pltdoc="x">Defining Recursive Contracts</a></td></tr><tr><td align="right">7.9.5&nbsp;</td><td><a href="contracts-gotchas.html#%28part._.Mixing_set__and_contract-out%29" class="tocviewlink" data-pltdoc="x">Mixing <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">contract-<wbr></wbr>out</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">7.9.1<tt>&nbsp;</tt></span><a href="contracts-gotchas.html#%28part._.Contracts_and_eq_%29" class="tocsubseclink" data-pltdoc="x">Contracts and <span class="RktSym"><span class="RktValLink">eq?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">7.9.2<tt>&nbsp;</tt></span><a href="contracts-gotchas.html#%28part._contracts-gotcha-nested%29" class="tocsubseclink" data-pltdoc="x">Contract boundaries and <span class="RktSym"><span class="RktStxLink">define/<span class="mywbr"> &nbsp;</span>contract</span></span></a></td></tr><tr><td><span class="tocsublinknumber">7.9.3<tt>&nbsp;</tt></span><a href="contracts-gotchas.html#%28part._contracts-exists-gotcha%29" class="tocsubseclink" data-pltdoc="x">Exists Contracts and Predicates</a></td></tr><tr><td><span class="tocsublinknumber">7.9.4<tt>&nbsp;</tt></span><a href="contracts-gotchas.html#%28part._.Defining_.Recursive_.Contracts%29" class="tocsubseclink" data-pltdoc="x">Defining Recursive Contracts</a></td></tr><tr><td><span class="tocsublinknumber">7.9.5<tt>&nbsp;</tt></span><a href="contracts-gotchas.html#%28part._.Mixing_set__and_contract-out%29" class="tocsubseclink" data-pltdoc="x">Mixing <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">contract-<wbr></wbr>out</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Building_New_Contracts.html" title="backward to &quot;7.8 Building New Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;7 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="i_o.html" title="forward to &quot;8 Input and Output&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-gotchas&quot;">7.9<tt>&nbsp;</tt><a name="(part._contracts-gotchas)"></a>Gotchas</h4><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Contracts_and_eq_&quot;">7.9.1<tt>&nbsp;</tt><a name="(part._.Contracts_and_eq_)"></a>Contracts and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span></h5><p>As a general rule, adding a contract to a program should
+either leave the behavior of the program unchanged, or
+should signal a contract violation. And this is almost true
+for Racket contracts, with one exception: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span>.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span> procedure is designed to be fast and does
+not provide much in the way of guarantees, except that if it
+returns true, it means that the two values behave
+identically in all respects. Internally, this is implemented
+as pointer equality at a low-level so it exposes information
+about how Racket is implemented (and how contracts are
+implemented).</p><p><div class="SIntrapara">Contracts interact poorly with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span> because function
+contract checking is implemented internally as wrapper
+functions. For example, consider this module:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-adder</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._add1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">add1</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">make-adder</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p>It exports the <span class="RktSym">make-adder</span> function that is the usual curried
+addition function, except that it returns Racket&rsquo;s <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._add1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">add1</a></span> when
+its input is <span class="RktVal">1</span>.</p><p><div class="SIntrapara">You might expect that
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-adder</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-adder</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p>would return <span class="RktVal">#t</span>, but it does not. If the contract were
+changed to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span> (or even <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="stt"> </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="RktPn">)</span>), then
+the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span> call would return <span class="RktVal">#t</span>.</p><p>Moral: Do not use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span> on values that have contracts.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-gotcha-nested&quot;">7.9.2<tt>&nbsp;</tt><a name="(part._contracts-gotcha-nested)"></a>Contract boundaries and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span></h5><p>The contract boundaries established by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span>, which
+creates a nested contract boundary, are sometimes unintuitive. This is
+especially true when multiple functions or other values with contracts
+interact. For example, consider these two interacting functions:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">g</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">"not an integer"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">g</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">f: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: "not an integer"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; integer? integer?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: (function f)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:2:0</span></p></td></tr></table></blockquote><p>One might expect that the function <span class="RktSym">g</span> will be blamed
+for breaking the terms of its contract with <span class="RktSym">f</span>.
+Blaming <span class="RktSym">g</span> would be right if <span class="RktSym">f</span> and <span class="RktSym">g</span>
+were directly establishing contracts with each other.
+They aren&rsquo;t, however. Instead, the access between <span class="RktSym">f</span>
+and <span class="RktSym">g</span> is mediated through the top-level of the enclosing
+module.</p><p>More precisely, <span class="RktSym">f</span> and the top-level of the module have
+the <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="stt"> </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span> contract mediating their
+interaction; <span class="RktSym">g</span> and the top-level have <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="stt"> </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="RktPn">)</span>
+mediating their interaction, but there is no contract directly
+between <span class="RktSym">f</span> and <span class="RktSym">g</span>. This means that the reference to
+<span class="RktSym">f</span> in the body of <span class="RktSym">g</span> is really the top-level
+of the module&rsquo;s responsibility, not <span class="RktSym">g</span>&rsquo;s. In other words,
+the function <span class="RktSym">f</span> has been given to <span class="RktSym">g</span> with
+no contract between <span class="RktSym">g</span> and the top-level and thus
+the top-level is blamed.</p><p>If we wanted to add a contract between <span class="RktSym">g</span> and the
+top-level, we can use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span>&rsquo;s
+<span class="RktPn">#:freevar</span> declaration and see the expected blame:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fregion..rkt%2529._define%252Fcontract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define/contract</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">g</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:freevar</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">"not an integer"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">g</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">f: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: integer?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: "not an integer"</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: the 1st argument of</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(-&gt; integer? integer?)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">contract from: top-level</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">blaming: (function g)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">(assuming the contract is correct)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: eval:6:0</span></p></td></tr></table></blockquote><p>Moral: if two values with contracts should interact,
+       put them in separate modules with contracts at
+       the module boundary or use <span class="RktPn">#:freevar</span>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-exists-gotcha&quot;">7.9.3<tt>&nbsp;</tt><a name="(part._contracts-exists-gotcha)"></a>Exists Contracts and Predicates</h5><p>Much like the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span> example above, <span class="RktPn">#:&#8707;</span> contracts
+can change the behavior of a program.</p><p>Specifically,
+the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span> predicate (and many other predicates) return <span class="RktVal">#f</span>
+for <span class="RktPn">#:&#8707;</span> contracts, and changing one of those contracts to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span>
+means that <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span> might now return <span class="RktVal">#t</span> instead, resulting in
+arbitrarily different behavior depending on how this boolean might flow around
+in the program.</p><p>Moral: Do not use predicates on <span class="RktPn">#:&#8707;</span> contracts.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Defining_Recursive_Contracts&quot;">7.9.4<tt>&nbsp;</tt><a name="(part._.Defining_.Recursive_.Contracts)"></a>Defining Recursive Contracts</h5><p>When defining a self-referential contract, it is natural to use
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span>. For example, one might try to write a contract on
+streams like this:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stream/c</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._promise%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">promise/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._or%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._cons%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stream/c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">stream/c: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr></table></blockquote><p>Unfortunately, this does not work because the value of
+<span class="RktSym">stream/c</span> is needed before it is defined. Put another way, all
+of the combinators evaluate their arguments eagerly, even though the
+values that they accept do not.</p><p><div class="SIntrapara">Instead, use
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stream/c</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._promise%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">promise/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._or%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">or/c</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._cons%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=contract-utilities.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fbase..rkt%2529._recursive-contract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">recursive-contract</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stream/c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p>The use of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=contract-utilities.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fbase..rkt%2529._recursive-contract%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">recursive-contract</a></span> delays the evaluation of the
+identifier <span class="RktSym">stream/c</span> until after the contract is first
+checked, long enough to ensure that <span class="RktSym">stream/c</span> is defined.</p><p>See also <a href="contracts-struct.html#%28part._contracts-lazy-contracts%29" data-pltdoc="x">Checking Properties of Data Structures</a>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Mixing_set__and_contract-out&quot;">7.9.5<tt>&nbsp;</tt><a name="(part._.Mixing_set__and_contract-out)"></a>Mixing <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></h5><p>The contract library assumes that variables exported via
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span> are not assigned to, but does not enforce
+it. Accordingly, if you try to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span> those variables, you
+may be surprised. Consider the following example:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">server</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">inc-x!</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">inc-x!</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">client</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">server</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">print-latest</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x is ~s\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">print-latest</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">inc-x!</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">print-latest</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">client</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">x is 0</span></p></td></tr><tr><td><p><span class="RktOut">x is 0</span></p></td></tr></table></td></tr></table></blockquote><p>Both calls to <span class="RktSym">print-latest</span> print <span class="RktVal">0</span>, even though the
+value of <span class="RktSym">x</span> has been incremented (and the change is visible
+inside the module <span class="RktSym">x</span>).</p><p>To work around this, export accessor functions, rather than
+exporting the variable directly, like this:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">inc-x!</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">inc-x!</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">get-x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Moral: This is a bug that we will address in a future release.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Building_New_Contracts.html" title="backward to &quot;7.8 Building New Contracts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;7 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="i_o.html" title="forward to &quot;8 Input and Output&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-struct.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-struct.html
new file mode 100644
index 00000000..f8205366
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/contracts-struct.html
@@ -0,0 +1,107 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7.5&nbsp;Contracts on Structures</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="contract-boundaries.html" class="tocviewlink" data-pltdoc="x">Contracts and Boundaries</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="contract-func.html" class="tocviewlink" data-pltdoc="x">Simple Contracts on Functions</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="contracts-general-functions.html" class="tocviewlink" data-pltdoc="x">Contracts on Functions in General</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="contracts-first.html" class="tocviewlink" data-pltdoc="x">Contracts:<span class="mywbr"> &nbsp;</span> A Thorough Example</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="contracts-struct.html" class="tocviewselflink" data-pltdoc="x">Contracts on Structures</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="contracts-exists.html" class="tocviewlink" data-pltdoc="x">Abstract Contracts using <span class="RktPn">#:<span class="mywbr"> &nbsp;</span>exists</span> and <span class="RktPn">#:<span class="mywbr"> &nbsp;</span>&#8707;</span></a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="contracts-examples.html" class="tocviewlink" data-pltdoc="x">Additional Examples</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Building_New_Contracts.html" class="tocviewlink" data-pltdoc="x">Building New Contracts</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="contracts-gotchas.html" class="tocviewlink" data-pltdoc="x">Gotchas</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>7.5&nbsp;</td><td><a href="contracts-struct.html" class="tocviewselflink" data-pltdoc="x">Contracts on Structures</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.5.1&nbsp;</td><td><a href="contracts-struct.html#%28part._contracts-single-struct%29" class="tocviewlink" data-pltdoc="x">Guarantees for a Specific Value</a></td></tr><tr><td align="right">7.5.2&nbsp;</td><td><a href="contracts-struct.html#%28part._contracts-define-struct%29" class="tocviewlink" data-pltdoc="x">Guarantees for All Values</a></td></tr><tr><td align="right">7.5.3&nbsp;</td><td><a href="contracts-struct.html#%28part._contracts-lazy-contracts%29" class="tocviewlink" data-pltdoc="x">Checking Properties of Data Structures</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">7.5.1<tt>&nbsp;</tt></span><a href="contracts-struct.html#%28part._contracts-single-struct%29" class="tocsubseclink" data-pltdoc="x">Guarantees for a Specific Value</a></td></tr><tr><td><span class="tocsublinknumber">7.5.2<tt>&nbsp;</tt></span><a href="contracts-struct.html#%28part._contracts-define-struct%29" class="tocsubseclink" data-pltdoc="x">Guarantees for All Values</a></td></tr><tr><td><span class="tocsublinknumber">7.5.3<tt>&nbsp;</tt></span><a href="contracts-struct.html#%28part._contracts-lazy-contracts%29" class="tocsubseclink" data-pltdoc="x">Checking Properties of Data Structures</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contracts-first.html" title="backward to &quot;7.4 Contracts: A Thorough Example&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;7 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contracts-exists.html" title="forward to &quot;7.6 Abstract Contracts using #:exists and #:∃&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-struct&quot;">7.5<tt>&nbsp;</tt><a name="(part._contracts-struct)"></a>Contracts on Structures</h4><p>Modules deal with structures in two ways. First they export
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span> definitions, i.e., the ability to create
+structs of a certain kind, to access their fields, to modify
+them, and to distinguish structs of this kind against every
+other kind of value in the world. Second, on occasion a
+module exports a specific struct and wishes to promise that
+its fields contain values of a certain kind. This section
+explains how to protect structs with contracts for both
+uses.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-single-struct&quot;">7.5.1<tt>&nbsp;</tt><a name="(part._contracts-single-struct)"></a>Guarantees for a Specific Value</h5><p>If your module defines a variable to be a structure value, then you can
+specify the structure&rsquo;s shape using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fstruct-dc..rkt%2529._struct%252Fc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct/c</a></span>.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">origin</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">origin</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fstruct-dc..rkt%2529._struct%252Fc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>In this example, the module defines a structure shape for representing
+2-dimensional positions and then creates one specific instance:
+<span class="RktSym">origin</span>. The export of this instance guarantees that its fields
+are <span class="RktVal">0</span>, i.e., they represent <span class="stt">(0,0)</span>, on the Cartesian grid.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See also <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fvector..rkt%2529._vector%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">vector/c</a></span> and similar contract
+combinators for (flat) compound data.</p></blockquote></blockquote></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-define-struct&quot;">7.5.2<tt>&nbsp;</tt><a name="(part._contracts-define-struct)"></a>Guarantees for All Values</h5><p>The book <span style="font-style: italic"><a href="https://htdp.org">How to Design Programs</a></span> teaches that <span class="RktSym">posn</span>s should contain only
+numbers in their two fields. With contracts we would enforce this
+informal data definition as follows:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">p-okay</span><span class="hspace">&nbsp;</span><span class="RktSym">posn?</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">p-sick</span><span class="hspace">&nbsp;</span><span class="RktSym">posn?</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p-okay</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p-sick</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>This module exports the entire structure definition: <span class="RktSym">posn</span>,
+<span class="RktSym">posn?</span>, <span class="RktSym">posn-x</span>, <span class="RktSym">posn-y</span>,
+<span class="RktSym">set-posn-x!</span>, and <span class="RktSym">set-posn-y!</span>. Each function enforces
+or promises that the two fields of a <span class="RktSym">posn</span> structure are
+numbers &#8212;<wbr></wbr> when the values flow across the module boundary.  Thus, if
+a client calls <span class="RktSym">posn</span> on <span class="RktVal">10</span> and <span class="RktVal">'</span><span class="RktVal">a</span>, the
+contract system signals a contract violation.</p><p>The creation of <span class="RktSym">p-sick</span> inside of the <span class="RktSym">posn</span> module,
+however, does not violate the contracts. The function <span class="RktSym">posn</span> is
+used internally, so <span class="RktVal">'</span><span class="RktVal">a</span> and <span class="RktVal">'</span><span class="RktVal">b</span> don&rsquo;t cross the module
+boundary. Similarly, when <span class="RktSym">p-sick</span> crosses the boundary of
+<span class="RktSym">posn</span>, the contract promises a <span class="RktSym">posn?</span> and nothing
+else. In particular, this check does <span style="font-style: italic">not</span> require that the
+fields of <span class="RktSym">p-sick</span> are numbers.</p><p>The association of contract checking with module boundaries implies that
+<span class="RktSym">p-okay</span> and <span class="RktSym">p-sick</span> look alike from a client&rsquo;s
+perspective until the client extracts the pieces:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lang/posn</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn-x</span><span class="hspace">&nbsp;</span><span class="RktSym">p-sick</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span></td></tr></table></blockquote><p>Using <span class="RktSym">posn-x</span> is the only way the client can find out what
+a <span class="RktSym">posn</span> contains in the <span class="RktSym">x</span> field. The application of
+<span class="RktSym">posn-x</span> sends <span class="RktSym">p-sick</span> back into the
+<span class="RktSym">posn</span> module and the result value &ndash; <span class="RktVal">'</span><span class="RktVal">a</span> here &ndash; back to
+the client, again across the module boundary. At this very point, the contract
+system discovers that a promise is broken. Specifically, <span class="RktSym">posn-x</span>
+doesn&rsquo;t return a number but a symbol and is therefore blamed.</p><p>This specific example shows that the explanation for a contract violation
+doesn&rsquo;t always pinpoint the source of the error. The good news is that the
+error is located in the <span class="RktSym">posn</span> module. The bad news is that the
+explanation is misleading. Although it is true that <span class="RktSym">posn-x</span>
+produced a symbol instead of a number, it is the fault of the programmer who
+created a <span class="RktSym">posn</span> from symbols, i.e., the programmer who added</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p-sick</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>to the module. So, when you are looking for bugs based on contract
+ violations, keep this example in mind.</p><p>If we want to fix the contract for <span class="RktSym">p-sick</span> so that the error
+is caught when <span class="RktSym">sick</span> is exported, a single change suffices:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">p-sick</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fstruct-dc..rkt%2529._struct%252Fc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>That is, instead of exporting <span class="RktSym">p-sick</span> as a plain
+<span class="RktSym">posn?</span>, we use a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fstruct-dc..rkt%2529._struct%252Fc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct/c</a></span> contract to enforce
+constraints on its components.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts-lazy-contracts&quot;">7.5.3<tt>&nbsp;</tt><a name="(part._contracts-lazy-contracts)"></a>Checking Properties of Data Structures</h5><p>Contracts written using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fstruct-dc..rkt%2529._struct%252Fc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct/c</a></span> immediately
+check the fields of the data structure, but sometimes this
+can have disastrous effects on the performance of a program
+that does not, itself, inspect the entire data structure.</p><p>As an example, consider the binary search tree
+search algorithm. A binary search tree is like a binary
+tree, except that the numbers are organized in the tree to
+make searching the tree fast. In particular, for each
+interior node in the tree, all of the numbers in the left
+subtree are smaller than the number in the node, and all of
+the numbers in the right subtree are larger than the number
+in the node.</p><p><div class="SIntrapara">We can implement a search function <span class="RktSym">in?</span> that takes
+advantage of the structure of the binary search tree.
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">node</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktSym">left</span><span class="hspace">&nbsp;</span><span class="RktSym">right</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">determines if `n' is in the binary search tree `b',</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">exploiting the binary search tree invariant</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">in?</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">node-val</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3c%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&lt;</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">node-val</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">in?</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">node-left</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">node-val</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">in?</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">node-right</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">a predicate that identifies binary search trees</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bst-between?</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">low</span><span class="hspace">&nbsp;</span><span class="RktSym">high</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3c%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&lt;=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">low</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">node-val</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">high</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bst-between?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">node-left</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">low</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">node-val</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bst-between?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">node-right</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">node-val</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">high</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bst?</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bst-between?</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-i</span>nf.0</span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct-out</a></span><span class="hspace">&nbsp;</span><span class="RktSym">node</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">bst?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">in?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bst?</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p>In a full binary search tree, this means that
+the <span class="RktSym">in?</span> function only has to explore a
+logarithmic number of nodes.</p><p>The contract on <span class="RktSym">in?</span> guarantees that its input
+is a binary search tree. But a little careful thought
+reveals that this contract defeats the purpose of the binary
+search tree algorithm. In particular, consider the
+inner <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span> in the <span class="RktSym">in?</span>
+function. This is where the <span class="RktSym">in?</span> function gets
+its speed: it avoids searching an entire subtree at each
+recursive call. Now compare that to the <span class="RktSym">bst-between?</span>
+function. In the case that it returns <span class="RktVal">#t</span>, it
+traverses the entire tree, meaning that the speedup
+of <span class="RktSym">in?</span> is lost.</p><p>In order to fix that, we can employ a new strategy for
+checking the binary search tree contract. In particular, if
+we only checked the contract on the nodes
+that <span class="RktSym">in?</span> looks at, we can still guarantee that
+the tree is at least partially well-formed, but without
+changing the complexity.</p><p>To do that, we need to use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fstruct-dc..rkt%2529._struct%252Fdc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct/dc</a></span> to define
+<span class="RktSym">bst-between?</span>. Like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fstruct-dc..rkt%2529._struct%252Fc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct/c</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fstruct-dc..rkt%2529._struct%252Fdc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct/dc</a></span> defines a
+contract for a structure. Unlike
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fstruct-dc..rkt%2529._struct%252Fc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct/c</a></span>, it allows fields to be marked as lazy, so that
+the contracts are only checked when the matching selector is called.
+Also, it does not allow mutable fields to be marked as lazy.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fstruct-dc..rkt%2529._struct%252Fdc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct/dc</a></span> form accepts a contract for each
+field of the struct and returns a contract on the
+struct. More interestingly, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fstruct-dc..rkt%2529._struct%252Fdc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct/dc</a></span> allows us to write dependent
+contracts, i.e., contracts where some of the contracts on
+the fields depend on the values of other fields. We can use
+this to define the binary search tree contract:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">node</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktSym">left</span><span class="hspace">&nbsp;</span><span class="RktSym">right</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">determines if `n' is in the binary search tree `b'</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">in?</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym">as</span><span class="hspace">&nbsp;</span><span class="RktSym">before</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">bst-between : number number -&gt; contract</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">builds a contract for binary search trees</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">whose values are between low and high</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bst-between/c</span><span class="hspace">&nbsp;</span><span class="RktSym">low</span><span class="hspace">&nbsp;</span><span class="RktSym">high</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._or%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fstruct-dc..rkt%2529._struct%252Fdc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct/dc</a></span><span class="hspace">&nbsp;</span><span class="RktSym">node</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._between%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">between/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">low</span><span class="hspace">&nbsp;</span><span class="RktSym">high</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">left</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:lazy</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bst-between/c</span><span class="hspace">&nbsp;</span><span class="RktSym">low</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">right</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:lazy</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bst-between/c</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktSym">high</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bst/c</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bst-between/c</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-i</span>nf.0</span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct-out</a></span><span class="hspace">&nbsp;</span><span class="RktSym">node</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=attaching-contracts-to-values.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._contract-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">contract-out</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">bst/c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=contract-utilities.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fguts..rkt%2529._contract%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">contract?</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">in?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">bst/c</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=function-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._-%7E3e%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span></a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>In general, each use of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fstruct-dc..rkt%2529._struct%252Fdc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct/dc</a></span> must name the
+fields and then specify contracts for each field. In the
+above, the <span class="RktSym">val</span> field is a contract that accepts
+values between <span class="RktSym">low</span> and <span class="RktSym">high</span>.
+The <span class="RktSym">left</span> and <span class="RktSym">right</span> fields are
+dependent on the value of the <span class="RktSym">val</span> field,
+indicated by their second sub-expressions. They are
+also marked with the <span class="RktPn">#:lazy</span> keyword to indicate
+that they should be checked only when the appropriate
+accessor is called on the struct instance. Their contracts
+are built by recursive calls to
+the <span class="RktSym">bst-between/c</span> function. Taken together,
+this contract ensures the same thing that
+the <span class="RktSym">bst-between?</span> function checked in the
+original example, but here the checking only happens
+as <span class="RktSym">in?</span> explores the tree.</p><p>Although this contract improves the performance
+of <span class="RktSym">in?</span>, restoring it to the logarithmic
+behavior that the contract-less version had, it is still
+imposes a fairly large constant overhead. So, the contract
+library also provides <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=contract-utilities.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fopt..rkt%2529._define-opt%252Fc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-opt/c</a></span> that brings
+down that constant factor by optimizing its body. Its shape
+is just like the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> above. It expects its
+body to be a contract and then optimizes that contract.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=contract-utilities.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fopt..rkt%2529._define-opt%252Fc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-opt/c</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bst-between/c</span><span class="hspace">&nbsp;</span><span class="RktSym">low</span><span class="hspace">&nbsp;</span><span class="RktSym">high</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._or%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">or/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528form._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fstruct-dc..rkt%2529._struct%252Fdc%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct/dc</a></span><span class="hspace">&nbsp;</span><span class="RktSym">node</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._between%252Fc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">between/c</a></span><span class="hspace">&nbsp;</span><span class="RktSym">low</span><span class="hspace">&nbsp;</span><span class="RktSym">high</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">left</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:lazy</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bst-between/c</span><span class="hspace">&nbsp;</span><span class="RktSym">low</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">right</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:lazy</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bst-between/c</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktSym">high</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contracts-first.html" title="backward to &quot;7.4 Contracts: A Thorough Example&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="contracts.html" title="up to &quot;7 Contracts&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contracts-exists.html" title="forward to &quot;7.6 Abstract Contracts using #:exists and #:∃&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/contracts.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/contracts.html
new file mode 100644
index 00000000..35720e0a
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/contracts.html
@@ -0,0 +1,3 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>7&nbsp;Contracts</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>7&nbsp;</td><td><a href="contracts.html" class="tocviewselflink" data-pltdoc="x">Contracts</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">7.1&nbsp;</td><td><a href="contract-boundaries.html" class="tocviewlink" data-pltdoc="x">Contracts and Boundaries</a></td></tr><tr><td align="right">7.2&nbsp;</td><td><a href="contract-func.html" class="tocviewlink" data-pltdoc="x">Simple Contracts on Functions</a></td></tr><tr><td align="right">7.3&nbsp;</td><td><a href="contracts-general-functions.html" class="tocviewlink" data-pltdoc="x">Contracts on Functions in General</a></td></tr><tr><td align="right">7.4&nbsp;</td><td><a href="contracts-first.html" class="tocviewlink" data-pltdoc="x">Contracts:<span class="mywbr"> &nbsp;</span> A Thorough Example</a></td></tr><tr><td align="right">7.5&nbsp;</td><td><a href="contracts-struct.html" class="tocviewlink" data-pltdoc="x">Contracts on Structures</a></td></tr><tr><td align="right">7.6&nbsp;</td><td><a href="contracts-exists.html" class="tocviewlink" data-pltdoc="x">Abstract Contracts using <span class="RktPn">#:<span class="mywbr"> &nbsp;</span>exists</span> and <span class="RktPn">#:<span class="mywbr"> &nbsp;</span>&#8707;</span></a></td></tr><tr><td align="right">7.7&nbsp;</td><td><a href="contracts-examples.html" class="tocviewlink" data-pltdoc="x">Additional Examples</a></td></tr><tr><td align="right">7.8&nbsp;</td><td><a href="Building_New_Contracts.html" class="tocviewlink" data-pltdoc="x">Building New Contracts</a></td></tr><tr><td align="right">7.9&nbsp;</td><td><a href="contracts-gotchas.html" class="tocviewlink" data-pltdoc="x">Gotchas</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="protect-out.html" title="backward to &quot;6.8 Protected Exports&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contract-boundaries.html" title="forward to &quot;7.1 Contracts and Boundaries&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;contracts&quot;">7<tt>&nbsp;</tt><a name="(part._contracts)"></a>Contracts</h3><p>This chapter provides a gentle introduction to Racket&rsquo;s
+contract system.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=contracts.html&amp;version=8.6" class="Sq" data-pltdoc="x">Contracts</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on contracts.</p></blockquote></blockquote></blockquote><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-boundaries.html" class="toclink" data-pltdoc="x">7.1<span class="hspace">&nbsp;</span>Contracts and Boundaries</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-boundaries.html#%28part._contracts-amount0%29" class="toclink" data-pltdoc="x">7.1.1<span class="hspace">&nbsp;</span>Contract Violations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-boundaries.html#%28part._.Experimenting_with_.Contracts_and_.Modules%29" class="toclink" data-pltdoc="x">7.1.2<span class="hspace">&nbsp;</span>Experimenting with Contracts and Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-boundaries.html#%28part._contracts-intro-nested%29" class="toclink" data-pltdoc="x">7.1.3<span class="hspace">&nbsp;</span>Experimenting with Nested Contract Boundaries</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-func.html" class="toclink" data-pltdoc="x">7.2<span class="hspace">&nbsp;</span>Simple Contracts on Functions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-func.html#%28part._.Styles_of_-_%29" class="toclink" data-pltdoc="x">7.2.1<span class="hspace">&nbsp;</span>Styles of <span class="RktSym"><span class="RktStxLink"><span class="nobreak">-&gt;</span></span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-func.html#%28part._simple-nested%29" class="toclink" data-pltdoc="x">7.2.2<span class="hspace">&nbsp;</span>Using <span class="RktSym"><span class="RktStxLink">define/contract</span></span> and <span class="RktSym"><span class="RktStxLink"><span class="nobreak">-&gt;</span></span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-func.html#%28part._any_and_any_c%29" class="toclink" data-pltdoc="x">7.2.3<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">any</span></span> and <span class="RktSym"><span class="RktValLink">any/c</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-func.html#%28part._contracts-own%29" class="toclink" data-pltdoc="x">7.2.4<span class="hspace">&nbsp;</span>Rolling Your Own Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-func.html#%28part._.Contracts_on_.Higher-order_.Functions%29" class="toclink" data-pltdoc="x">7.2.5<span class="hspace">&nbsp;</span>Contracts on Higher-order Functions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-func.html#%28part._contracts-flat-named-contracts%29" class="toclink" data-pltdoc="x">7.2.6<span class="hspace">&nbsp;</span>Contract Messages with &ldquo;???&rdquo;</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-func.html#%28part._contracts-dissecting-contract-errors%29" class="toclink" data-pltdoc="x">7.2.7<span class="hspace">&nbsp;</span>Dissecting a contract error message</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-general-functions.html" class="toclink" data-pltdoc="x">7.3<span class="hspace">&nbsp;</span>Contracts on Functions in General</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-general-functions.html#%28part._contracts-optional%29" class="toclink" data-pltdoc="x">7.3.1<span class="hspace">&nbsp;</span>Optional Arguments</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-general-functions.html#%28part._contracts-rest-args%29" class="toclink" data-pltdoc="x">7.3.2<span class="hspace">&nbsp;</span>Rest Arguments</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-general-functions.html#%28part._contracts-keywords%29" class="toclink" data-pltdoc="x">7.3.3<span class="hspace">&nbsp;</span>Keyword Arguments</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-general-functions.html#%28part._contracts-optional-keywords%29" class="toclink" data-pltdoc="x">7.3.4<span class="hspace">&nbsp;</span>Optional Keyword Arguments</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-general-functions.html#%28part._contracts-case-lambda%29" class="toclink" data-pltdoc="x">7.3.5<span class="hspace">&nbsp;</span>Contracts for <span class="RktSym"><span class="RktStxLink">case-lambda</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-general-functions.html#%28part._contracts-arrow-d%29" class="toclink" data-pltdoc="x">7.3.6<span class="hspace">&nbsp;</span>Argument and Result Dependencies</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-general-functions.html#%28part._contracts-arrow-d-eval-order%29" class="toclink" data-pltdoc="x">7.3.7<span class="hspace">&nbsp;</span>Checking State Changes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-general-functions.html#%28part._contracts-multiple%29" class="toclink" data-pltdoc="x">7.3.8<span class="hspace">&nbsp;</span>Multiple Result Values</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-general-functions.html#%28part._contracts-no-domain%29" class="toclink" data-pltdoc="x">7.3.9<span class="hspace">&nbsp;</span>Fixed but Statically Unknown Arities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-first.html" class="toclink" data-pltdoc="x">7.4<span class="hspace">&nbsp;</span>Contracts: A Thorough Example</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-struct.html" class="toclink" data-pltdoc="x">7.5<span class="hspace">&nbsp;</span>Contracts on Structures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-struct.html#%28part._contracts-single-struct%29" class="toclink" data-pltdoc="x">7.5.1<span class="hspace">&nbsp;</span>Guarantees for a Specific Value</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-struct.html#%28part._contracts-define-struct%29" class="toclink" data-pltdoc="x">7.5.2<span class="hspace">&nbsp;</span>Guarantees for All Values</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-struct.html#%28part._contracts-lazy-contracts%29" class="toclink" data-pltdoc="x">7.5.3<span class="hspace">&nbsp;</span>Checking Properties of Data Structures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-exists.html" class="toclink" data-pltdoc="x">7.6<span class="hspace">&nbsp;</span>Abstract Contracts using <span class="RktPn">#:exists</span> and <span class="RktPn">#:&#8707;</span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-examples.html" class="toclink" data-pltdoc="x">7.7<span class="hspace">&nbsp;</span>Additional Examples</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-examples.html#%28part._.A_.Customer-.Manager_.Component%29" class="toclink" data-pltdoc="x">7.7.1<span class="hspace">&nbsp;</span>A Customer-Manager Component</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-examples.html#%28part._.A_.Parameteric__.Simple__.Stack%29" class="toclink" data-pltdoc="x">7.7.2<span class="hspace">&nbsp;</span>A Parameteric (Simple) Stack</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-examples.html#%28part._.A_.Dictionary%29" class="toclink" data-pltdoc="x">7.7.3<span class="hspace">&nbsp;</span>A Dictionary</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-examples.html#%28part._.A_.Queue%29" class="toclink" data-pltdoc="x">7.7.4<span class="hspace">&nbsp;</span>A Queue</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Building_New_Contracts.html" class="toclink" data-pltdoc="x">7.8<span class="hspace">&nbsp;</span>Building New Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Building_New_Contracts.html#%28part._.Contract_.Struct_.Properties%29" class="toclink" data-pltdoc="x">7.8.1<span class="hspace">&nbsp;</span>Contract Struct Properties</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Building_New_Contracts.html#%28part._.With_all_the_.Bells_and_.Whistles%29" class="toclink" data-pltdoc="x">7.8.2<span class="hspace">&nbsp;</span>With all the Bells and Whistles</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-gotchas.html" class="toclink" data-pltdoc="x">7.9<span class="hspace">&nbsp;</span>Gotchas</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-gotchas.html#%28part._.Contracts_and_eq_%29" class="toclink" data-pltdoc="x">7.9.1<span class="hspace">&nbsp;</span>Contracts and <span class="RktSym"><span class="RktValLink">eq?</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-gotchas.html#%28part._contracts-gotcha-nested%29" class="toclink" data-pltdoc="x">7.9.2<span class="hspace">&nbsp;</span>Contract boundaries and <span class="RktSym"><span class="RktStxLink">define/contract</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-gotchas.html#%28part._contracts-exists-gotcha%29" class="toclink" data-pltdoc="x">7.9.3<span class="hspace">&nbsp;</span>Exists Contracts and Predicates</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-gotchas.html#%28part._.Defining_.Recursive_.Contracts%29" class="toclink" data-pltdoc="x">7.9.4<span class="hspace">&nbsp;</span>Defining Recursive Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-gotchas.html#%28part._.Mixing_set__and_contract-out%29" class="toclink" data-pltdoc="x">7.9.5<span class="hspace">&nbsp;</span>Mixing <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">contract-out</span></span></a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="protect-out.html" title="backward to &quot;6.8 Protected Exports&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contract-boundaries.html" title="forward to &quot;7.1 Contracts and Boundaries&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/control.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/control.html
new file mode 100644
index 00000000..7553da35
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/control.html
@@ -0,0 +1,4 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>10&nbsp;Exceptions and Control</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewselflink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>10&nbsp;</td><td><a href="control.html" class="tocviewselflink" data-pltdoc="x">Exceptions and Control</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">10.1&nbsp;</td><td><a href="exns.html" class="tocviewlink" data-pltdoc="x">Exceptions</a></td></tr><tr><td align="right">10.2&nbsp;</td><td><a href="prompt.html" class="tocviewlink" data-pltdoc="x">Prompts and Aborts</a></td></tr><tr><td align="right">10.3&nbsp;</td><td><a href="conts.html" class="tocviewlink" data-pltdoc="x">Continuations</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="An_Extended_Example.html" title="backward to &quot;9.10 An Extended Example&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="exns.html" title="forward to &quot;10.1 Exceptions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;control&quot;">10<tt>&nbsp;</tt><a name="(part._control)"></a>Exceptions and Control</h3><p>Racket provides an especially rich set of control operations&#8212;<wbr></wbr>not
+only operations for raising and catching exceptions, but also
+operations for grabbing and restoring portions of a computation.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="exns.html" class="toclink" data-pltdoc="x">10.1<span class="hspace">&nbsp;</span>Exceptions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="prompt.html" class="toclink" data-pltdoc="x">10.2<span class="hspace">&nbsp;</span>Prompts and Aborts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="conts.html" class="toclink" data-pltdoc="x">10.3<span class="hspace">&nbsp;</span>Continuations</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="An_Extended_Example.html" title="backward to &quot;9.10 An Extended Example&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="exns.html" title="forward to &quot;10.1 Exceptions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/conts.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/conts.html
new file mode 100644
index 00000000..408a2561
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/conts.html
@@ -0,0 +1,32 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>10.3&nbsp;Continuations</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewselflink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">10.1&nbsp;</td><td><a href="exns.html" class="tocviewlink" data-pltdoc="x">Exceptions</a></td></tr><tr><td align="right">10.2&nbsp;</td><td><a href="prompt.html" class="tocviewlink" data-pltdoc="x">Prompts and Aborts</a></td></tr><tr><td align="right">10.3&nbsp;</td><td><a href="conts.html" class="tocviewselflink" data-pltdoc="x">Continuations</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="prompt.html" title="backward to &quot;10.2 Prompts and Aborts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Exceptions and Control&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="for.html" title="forward to &quot;11 Iterations and Comprehensions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;conts&quot;">10.3<tt>&nbsp;</tt><a name="(part._conts)"></a>Continuations</h4><p>A <a name="(tech._continuation)"></a><span style="font-style: italic">continuation</span> is a value that encapsulates a piece of an
+expression&rsquo;s evaluation context. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=cont.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._call-with-composable-continuation%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">call-with-composable-continuation</a></span>
+function captures the <a name="(tech._current._continuation)"></a><span style="font-style: italic">current continuation</span> starting outside
+the current function call and running up to the nearest enclosing
+prompt. (Keep in mind that each <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> interaction is implicitly
+wrapped in a prompt.)</p><p>For example, in</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>at the point where <span class="RktVal">0</span> is evaluated, the expression context
+includes three nested addition expressions. We can grab that context by
+changing <span class="RktVal">0</span> to grab the continuation before returning 0:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">saved-k</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">save-it!</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=cont.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._call-with-composable-continuation%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">call-with-composable-continuation</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktSym">k</span><span class="RktCmt"> is the captured continuation</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">saved-k</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">save-it!</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></blockquote><p>The <a href="conts.html#%28tech._continuation%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation</span></a> saved in <span class="RktSym">save-k</span> encapsulates the
+program context <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVar">?</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>, where <span class="RktVar">?</span>
+represents a place to plug in a result value&#8212;<wbr></wbr>because that was the
+expression context when <span class="RktSym">save-it!</span> was called. The
+<a href="conts.html#%28tech._continuation%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuation</span></a> is encapsulated so that it behaves like the
+function <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">saved-k</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">saved-k</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">13</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">saved-k</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">saved-k</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">6</span></p></td></tr></table></blockquote><p>The continuation captured by
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=cont.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._call-with-composable-continuation%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">call-with-composable-continuation</a></span> is determined dynamically,
+not syntactically. For example, with</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">sum</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">save-it!</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">sum</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sub1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">sum</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">15</span></p></td></tr></table></blockquote><p>the continuation in <span class="RktSym">saved-k</span> becomes <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">5</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">4</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">3</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">2</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">saved-k</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">15</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">saved-k</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">25</span></p></td></tr></table></blockquote><p>A more traditional continuation operator in Racket (or Scheme) is
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=cont.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._call-with-current-continuation%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">call-with-current-continuation</a></span>, which is usually abbreviated
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=cont.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._call%252Fcc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">call/cc</a></span>. It is like
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=cont.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._call-with-composable-continuation%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">call-with-composable-continuation</a></span>, but applying the captured
+continuation first <a href="prompt.html#%28tech._abort%29" class="techoutside" data-pltdoc="x"><span class="techinside">aborts</span></a> (to the current <a href="prompt.html#%28tech._prompt%29" class="techoutside" data-pltdoc="x"><span class="techinside">prompt</span></a>) before
+restoring the saved continuation. In addition, Scheme systems
+traditionally support a single prompt at the program start, instead of
+allowing new prompts via
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=cont.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._call-with-continuation-prompt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">call-with-continuation-prompt</a></span>. Continuations as in Racket
+are sometimes called <a name="(tech._delimited._continuation)"></a><span style="font-style: italic">delimited continuations</span>, since a
+program can introduce new delimiting prompts, and continuations as
+captured by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=cont.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._call-with-composable-continuation%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">call-with-composable-continuation</a></span> are sometimes
+called <a name="(tech._composable._continuation)"></a><span style="font-style: italic">composable continuations</span>, because they do not have a
+built-in <a href="prompt.html#%28tech._abort%29" class="techoutside" data-pltdoc="x"><span class="techinside">abort</span></a>.</p><p>For an example of how <a href="conts.html#%28tech._continuation%29" class="techoutside" data-pltdoc="x"><span class="techinside">continuations</span></a> are useful, see
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=more&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">More: Systems Programming with Racket</a>. For specific
+control operators that have more convenient names than the primitives
+described here, see <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=cont.html%23%2528mod-path._racket%252Fcontrol%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/control</span></a>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="prompt.html" title="backward to &quot;10.2 Prompts and Aborts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Exceptions and Control&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="for.html" title="forward to &quot;11 Iterations and Comprehensions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/datatypes.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/datatypes.html
new file mode 100644
index 00000000..e5022a9a
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/datatypes.html
@@ -0,0 +1,5 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3&nbsp;Built-In Datatypes</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewselflink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="datatypes.html" class="tocviewselflink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings (Unicode)</a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Bytes and Byte Strings</a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="hash-tables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="void_undefined.html" class="tocviewlink" data-pltdoc="x">Void and Undefined</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Pairs__Lists__and_Racket_Syntax.html" title="backward to &quot;2.4 Pairs, Lists, and Racket Syntax&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="booleans.html" title="forward to &quot;3.1 Booleans&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;datatypes&quot;">3<tt>&nbsp;</tt><a name="(part._datatypes)"></a>Built-In Datatypes</h3><p>The <a href="to-scheme.html" data-pltdoc="x">previous chapter</a> introduced some of
+Racket&rsquo;s built-in datatypes: numbers, booleans, strings, lists, and
+procedures. This section provides a more complete coverage of the
+built-in datatypes for simple forms of data.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="booleans.html" class="toclink" data-pltdoc="x">3.1<span class="hspace">&nbsp;</span>Booleans</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="numbers.html" class="toclink" data-pltdoc="x">3.2<span class="hspace">&nbsp;</span>Numbers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="characters.html" class="toclink" data-pltdoc="x">3.3<span class="hspace">&nbsp;</span>Characters</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="strings.html" class="toclink" data-pltdoc="x">3.4<span class="hspace">&nbsp;</span>Strings (Unicode)</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="bytestrings.html" class="toclink" data-pltdoc="x">3.5<span class="hspace">&nbsp;</span>Bytes and Byte Strings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="symbols.html" class="toclink" data-pltdoc="x">3.6<span class="hspace">&nbsp;</span>Symbols</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="keywords.html" class="toclink" data-pltdoc="x">3.7<span class="hspace">&nbsp;</span>Keywords</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pairs.html" class="toclink" data-pltdoc="x">3.8<span class="hspace">&nbsp;</span>Pairs and Lists</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="vectors.html" class="toclink" data-pltdoc="x">3.9<span class="hspace">&nbsp;</span>Vectors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="hash-tables.html" class="toclink" data-pltdoc="x">3.10<span class="hspace">&nbsp;</span>Hash Tables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="boxes.html" class="toclink" data-pltdoc="x">3.11<span class="hspace">&nbsp;</span>Boxes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="void_undefined.html" class="toclink" data-pltdoc="x">3.12<span class="hspace">&nbsp;</span>Void and Undefined</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Pairs__Lists__and_Racket_Syntax.html" title="backward to &quot;2.4 Pairs, Lists, and Racket Syntax&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="booleans.html" title="forward to &quot;3.1 Booleans&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/default-ports.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/default-ports.html
new file mode 100644
index 00000000..3d9ffdf9
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/default-ports.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>8.2&nbsp;Default Ports</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Varieties of Ports</a></td></tr><tr><td align="right">8.2&nbsp;</td><td><a href="default-ports.html" class="tocviewselflink" data-pltdoc="x">Default Ports</a></td></tr><tr><td align="right">8.3&nbsp;</td><td><a href="read-write.html" class="tocviewlink" data-pltdoc="x">Reading and Writing Racket Data</a></td></tr><tr><td align="right">8.4&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Datatypes and Serialization</a></td></tr><tr><td align="right">8.5&nbsp;</td><td><a href="encodings.html" class="tocviewlink" data-pltdoc="x">Bytes, Characters, and Encodings</a></td></tr><tr><td align="right">8.6&nbsp;</td><td><a href="io-patterns.html" class="tocviewlink" data-pltdoc="x">I/<span class="mywbr"> &nbsp;</span>O Patterns</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="ports.html" title="backward to &quot;8.1 Varieties of Ports&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="i_o.html" title="up to &quot;8 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="read-write.html" title="forward to &quot;8.3 Reading and Writing Racket Data&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;default-ports&quot;">8.2<tt>&nbsp;</tt><a name="(part._default-ports)"></a>Default Ports</h4><p>For most simple I/O functions, the target port is an optional
+argument, and the default is the <span style="font-style: italic">current input port</span> or
+<span style="font-style: italic">current output port</span>. Furthermore, error messages are written
+to the <span style="font-style: italic">current error port</span>, which is an output port. The
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-ops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-input-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-input-port</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-ops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-output-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-output-port</a></span>, and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-ops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-error-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-error-port</a></span> functions return the corresponding current
+ports.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Hi"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Hi</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Hi"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-ops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-output-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-output-port</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">the same</span></td></tr><tr><td><p><span class="RktOut">Hi</span></p></td></tr></table></blockquote></div></p><p>If you start the <span class="stt">racket</span> program in a terminal, then the
+current input, output, and error ports are all connected to the
+terminal. More generally, they are connected to the OS-level stdin,
+stdout, and stderr. In this guide, the examples show output written to
+stdout in purple, and output written to stderr in red italics.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swing-hammer</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Ouch!"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-ops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-error-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-error-port</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">swing-hammer</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">Ouch!</span></p></td></tr></table></blockquote></div></p><p>The current-port functions are actually <a href="parameterize.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameters</span></a>, which means
+that their values can be set with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See <a href="parameterize.html" data-pltdoc="x">Dynamic Binding: <span class="RktSym"><span class="RktStxLink">parameterize</span></span></a> for an introduction to parameters.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stringport.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._open-output-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">open-output-string</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-ops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-error-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-error-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swing-hammer</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swing-hammer</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swing-hammer</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stringport.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._get-output-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">get-output-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"Ouch!Ouch!Ouch!"</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="ports.html" title="backward to &quot;8.1 Varieties of Ports&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="i_o.html" title="up to &quot;8 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="read-write.html" title="forward to &quot;8.3 Reading and Writing Racket Data&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/define-struct.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/define-struct.html
new file mode 100644
index 00000000..3077dea0
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/define-struct.html
@@ -0,0 +1,170 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>5&nbsp;Programmer-Defined Datatypes</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9660;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewselflink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>5&nbsp;</td><td><a href="define-struct.html" class="tocviewselflink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">5.1&nbsp;</td><td><a href="define-struct.html#%28part._.Simple_.Structure_.Types__struct%29" class="tocviewlink" data-pltdoc="x">Simple Structure Types:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">struct</span></span></a></td></tr><tr><td align="right">5.2&nbsp;</td><td><a href="define-struct.html#%28part._struct-copy%29" class="tocviewlink" data-pltdoc="x">Copying and Update</a></td></tr><tr><td align="right">5.3&nbsp;</td><td><a href="define-struct.html#%28part._struct-subtypes%29" class="tocviewlink" data-pltdoc="x">Structure Subtypes</a></td></tr><tr><td align="right">5.4&nbsp;</td><td><a href="define-struct.html#%28part._trans-struct%29" class="tocviewlink" data-pltdoc="x">Opaque versus Transparent Structure Types</a></td></tr><tr><td align="right">5.5&nbsp;</td><td><a href="define-struct.html#%28part._struct-equal%29" class="tocviewlink" data-pltdoc="x">Structure Comparisons</a></td></tr><tr><td align="right">5.6&nbsp;</td><td><a href="define-struct.html#%28part._.Structure_.Type_.Generativity%29" class="tocviewlink" data-pltdoc="x">Structure Type Generativity</a></td></tr><tr><td align="right">5.7&nbsp;</td><td><a href="define-struct.html#%28part._prefab-struct%29" class="tocviewlink" data-pltdoc="x">Prefab Structure Types</a></td></tr><tr><td align="right">5.8&nbsp;</td><td><a href="define-struct.html#%28part._struct-options%29" class="tocviewlink" data-pltdoc="x">More Structure Type Options</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">5.1<tt>&nbsp;</tt></span><a href="define-struct.html#%28part._.Simple_.Structure_.Types__struct%29" class="tocsubseclink" data-pltdoc="x">Simple Structure Types:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">struct</span></span></a></td></tr><tr><td><span class="tocsublinknumber">5.2<tt>&nbsp;</tt></span><a href="define-struct.html#%28part._struct-copy%29" class="tocsubseclink" data-pltdoc="x">Copying and Update</a></td></tr><tr><td><span class="tocsublinknumber">5.3<tt>&nbsp;</tt></span><a href="define-struct.html#%28part._struct-subtypes%29" class="tocsubseclink" data-pltdoc="x">Structure Subtypes</a></td></tr><tr><td><span class="tocsublinknumber">5.4<tt>&nbsp;</tt></span><a href="define-struct.html#%28part._trans-struct%29" class="tocsubseclink" data-pltdoc="x">Opaque versus Transparent Structure Types</a></td></tr><tr><td><span class="tocsublinknumber">5.5<tt>&nbsp;</tt></span><a href="define-struct.html#%28part._struct-equal%29" class="tocsubseclink" data-pltdoc="x">Structure Comparisons</a></td></tr><tr><td><span class="tocsublinknumber">5.6<tt>&nbsp;</tt></span><a href="define-struct.html#%28part._.Structure_.Type_.Generativity%29" class="tocsubseclink" data-pltdoc="x">Structure Type Generativity</a></td></tr><tr><td><span class="tocsublinknumber">5.7<tt>&nbsp;</tt></span><a href="define-struct.html#%28part._prefab-struct%29" class="tocsubseclink" data-pltdoc="x">Prefab Structure Types</a></td></tr><tr><td><span class="tocsublinknumber">5.8<tt>&nbsp;</tt></span><a href="define-struct.html#%28part._struct-options%29" class="tocsubseclink" data-pltdoc="x">More Structure Type Options</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="parameterize.html" title="backward to &quot;4.13 Dynamic Binding: parameterize&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="modules.html" title="forward to &quot;6 Modules&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;define-struct&quot;">5<tt>&nbsp;</tt><a name="(part._define-struct)"></a>Programmer-Defined Datatypes</h3><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=structures.html&amp;version=8.6" class="Sq" data-pltdoc="x">Structures</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> also documents structure types.</p></blockquote></blockquote></blockquote><p>New datatypes are normally created with the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span>
+form, which is the topic of this chapter. The class-based object
+system, which we defer to <a href="classes.html" data-pltdoc="x">Classes and Objects</a>, offers an alternate
+mechanism for creating new datatypes, but even classes and objects are
+implemented in terms of structure types.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Simple_Structure_Types__struct&quot;">5.1<tt>&nbsp;</tt><a name="(part._.Simple_.Structure_.Types__struct)"></a>Simple Structure Types: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span></h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html&amp;version=8.6" class="Sq" data-pltdoc="x">Defining Structure Types: <span class="RktSym"><span class="RktStxLink">struct</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> also documents <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span>.</p></blockquote></blockquote></blockquote><p>To a first approximation, the syntax of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span> is</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktVar">struct-id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">field-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote></div></p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span> form binds <span class="RktVar">struct-id</span> and a number of
+identifiers that are built from <span class="RktVar">struct-id</span> and the
+<span class="RktVar">field-id</span>s:</p><ul><li><p><span class="RktVar">struct-id</span> : a <a name="(tech._constructor)"></a><span style="font-style: italic">constructor</span> function that
+takes as many arguments as the number of <span class="RktVar">field-id</span>s,
+and returns an instance of the structure type.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;posn&gt;</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktVar">struct-id</span><span class="RktSym">?</span> : a <a name="(tech._predicate)"></a><span style="font-style: italic">predicate</span>
+function that takes a single argument and returns <span class="RktVal">#t</span>
+if it is an instance of the structure type, <span class="RktVal">#f</span>
+otherwise.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">posn?</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">posn?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktVar">struct-id</span><span class="RktSym">-</span><span class="RktVar">field-id</span> : for
+each <span class="RktVar">field-id</span>, an <a name="(tech._accessor)"></a><span style="font-style: italic">accessor</span> that extracts
+the value of the corresponding field from an instance of the
+structure type.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">posn-x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">posn-y</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p></li><li><p><span class="RktSym">struct:</span><span class="RktVar">struct-id</span> : a
+<a name="(tech._structure._type._descriptor)"></a><span style="font-style: italic">structure type descriptor</span>, which is a value that
+represents the structure type as a first-class value (with
+<span class="RktPn">#:super</span>, as discussed later in
+<a href="define-struct.html#%28part._struct-options%29" data-pltdoc="x">More Structure Type Options</a>).</p></li></ul><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span> form places no constraints on the kinds of
+values that can appear for fields in an instance of the structure
+type. For example, <span class="RktPn">(</span><span class="RktSym">posn</span><span class="stt"> </span><span class="RktVal">"apple"</span><span class="stt"> </span><span class="RktVal">#f</span><span class="RktPn">)</span> produces an
+instance of <span class="RktSym">posn</span>, even though <span class="RktVal">"apple"</span> and
+<span class="RktVal">#f</span> are not valid coordinates for the obvious uses of
+<span class="RktSym">posn</span> instances. Enforcing constraints on field values, such
+as requiring them to be numbers, is normally the job of a contract, as
+discussed later in <a href="contracts.html" data-pltdoc="x">Contracts</a>.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;struct-copy&quot;">5.2<tt>&nbsp;</tt><a name="(part._struct-copy)"></a>Copying and Update</h4><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=struct-copy.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct-copy%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct-copy</a></span> form clones a structure and optionally
+updates specified fields in the clone. This process is sometimes
+called a <a name="(tech._functional._update)"></a><span style="font-style: italic">functional update</span>, because the result is a
+structure with updated field values. but the original structure is not
+modified.</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=struct-copy.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct-copy%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct-copy</a></span><span class="hspace">&nbsp;</span><span class="RktVar">struct-id</span><span class="hspace">&nbsp;</span><span class="RktVar">struct-expr</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">field-id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>The <span class="RktVar">struct-id</span> that appears after <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=struct-copy.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct-copy%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct-copy</a></span> must
+be a structure type name bound by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span> (i.e., the
+name that cannot be used directly as an expression). The
+<span class="RktVar">struct-expr</span> must produce an instance of the structure type.
+The result is a new instance of the structure type that is like the old
+one, except that the field indicated by each <span class="RktVar">field-id</span> gets
+the value of the corresponding <span class="RktVar">expr</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=struct-copy.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct-copy%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct-copy</a></span><span class="hspace">&nbsp;</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktSym">p1</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn-x</span><span class="hspace">&nbsp;</span><span class="RktSym">p2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn-y</span><span class="hspace">&nbsp;</span><span class="RktSym">p2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(3 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn-x</span><span class="hspace">&nbsp;</span><span class="RktSym">p1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn-y</span><span class="hspace">&nbsp;</span><span class="RktSym">p1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2)</span></p></td></tr></table></blockquote></div></p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;struct-subtypes&quot;">5.3<tt>&nbsp;</tt><a name="(part._struct-subtypes)"></a>Structure Subtypes</h4><p>An extended form of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span> can be used to define a
+<span style="font-style: italic">structure subtype</span>, which is a structure type that extends an
+existing structure type:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktVar">struct-id</span><span class="hspace">&nbsp;</span><span class="RktVar">super-id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">field-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>The <span class="RktVar">super-id</span> must be a structure type name bound by
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span> (i.e., the name that cannot be used directly as
+an expression).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">3d-posn</span><span class="hspace">&nbsp;</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p>A structure subtype inherits the fields of its supertype, and the
+subtype constructor accepts the values for the subtype fields after
+values for the supertype fields. An instance of a structure subtype
+can be used with the predicate and accessors of the
+supertype.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">3d-posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">p</span></td></tr><tr><td><p><span class="RktRes">#&lt;3d-posn&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">posn?</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">3d-posn-z</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">a 3d-posn has an x field, but there is no 3d-posn-x selector:</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">3d-posn-x</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">3d-posn-x: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">use the supertype's posn-x selector to access the x field:</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">posn-x</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></blockquote></div></p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;trans-struct&quot;">5.4<tt>&nbsp;</tt><a name="(part._trans-struct)"></a>Opaque versus Transparent Structure Types</h4><p>With a structure type definition like</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>an instance of the structure type prints in a way that does not show
+any information about the fields&rsquo; values. That is, structure types by
+default are <a name="(tech._opaque)"></a><span style="font-style: italic">opaque</span>. If the accessors and mutators of a
+structure type are kept private to a module, then no other module can
+rely on the representation of the type&rsquo;s instances.</p><p>To make a structure type <a name="(tech._transparent)"></a><span style="font-style: italic">transparent</span>, use the
+<span class="RktPn">#:transparent</span> keyword after the field-name sequence:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(posn 1 2)</span></p></td></tr></table></td></tr></table></blockquote><p>An instance of a transparent structure type prints like a call to the
+constructor, so that it shows the structures field values. A
+transparent structure type also allows reflective operations, such as
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=structutils.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._struct%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">struct?</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=inspectors.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._struct-info%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">struct-info</a></span>, to be used on its instances
+(see <a href="reflection.html" data-pltdoc="x">Reflection and Dynamic Evaluation</a>).</p><p>Structure types are opaque by default, because opaque structure
+instances provide more encapsulation guarantees. That is, a library
+can use an opaque structure to encapsulate data, and clients of the
+library cannot manipulate the data in the structure except as allowed
+by the library.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;struct-equal&quot;">5.5<tt>&nbsp;</tt><a name="(part._struct-equal)"></a>Structure Comparisons</h4><p>A generic <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span> comparison automatically recurs on the
+fields of a transparent structure type, but <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span> defaults
+to mere instance identity for opaque structure types:</p><p><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">glass</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">width</span><span class="hspace">&nbsp;</span><span class="RktSym">height</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">glass</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">glass</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lead</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">width</span><span class="hspace">&nbsp;</span><span class="RktSym">height</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">slab</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lead</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">slab</span><span class="hspace">&nbsp;</span><span class="RktSym">slab</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">slab</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lead</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></td></tr></table></blockquote></div></p><p>To support instances comparisons via <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span> without making
+the structure type transparent, you can use the <span class="RktPn">#:methods</span>
+keyword, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._gen%7E3aequal%252Bhash%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">gen:equal+hash</a></span>, and implement three methods:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lead</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">width</span><span class="hspace">&nbsp;</span><span class="RktSym">height</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:methods</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._gen%7E3aequal%252Bhash%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">gen:equal+hash</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">equal-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">equal?-recur</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">compare </span><span class="RktSym">a</span><span class="RktCmt"> and </span><span class="RktSym">b</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">equal?-recur</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lead-width</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lead-width</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">equal?-recur</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lead-height</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lead-height</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hash-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">hash-recur</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">compute primary hash code of </span><span class="RktSym">a</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hash-recur</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lead-width</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hash-recur</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lead-height</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hash2-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">hash2-recur</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">compute secondary hash code of </span><span class="RktSym">a</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hash2-recur</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lead-width</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hash2-recur</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lead-height</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lead</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lead</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></td></tr></table></blockquote><p>The first function in the list implements the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span> test on
+two <span class="RktSym">lead</span>s; the third argument to the function is used instead
+of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span> for recursive equality testing, so that data cycles
+can be handled correctly. The other two functions compute primary and
+secondary hash codes for use with <a href="hash-tables.html#%28tech._hash._table%29" class="techoutside" data-pltdoc="x"><span class="techinside">hash tables</span></a>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-hash%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-hash</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-set%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lead</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lead</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">lead</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">hash-ref: no value found for key</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">key: #&lt;lead&gt;</span></p></td></tr></table></blockquote><p>The first function provided with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._gen%7E3aequal%252Bhash%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">gen:equal+hash</a></span> is not
+required to recursively compare the fields of the structure. For
+example, a structure type representing a set might implement equality
+by checking that the members of the set are the same, independent of
+the order of elements in the internal representation. Just take care
+that the hash functions produce the same value for any two structure
+types that are supposed to be equivalent.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Structure_Type_Generativity&quot;">5.6<tt>&nbsp;</tt><a name="(part._.Structure_.Type_.Generativity)"></a>Structure Type Generativity</h4><p>Each time that a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span> form is evaluated, it
+generates a structure type that is distinct from all existing
+structure types, even if some other structure type has the same name
+and fields.</p><p>This generativity is useful for enforcing abstractions and
+implementing programs such as interpreters, but beware of placing a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span> form in positions that are evaluated multiple
+times.</p><p><div class="SIntrapara"><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">add-bigger-fish</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">size</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">new every time</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish-size</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">add-bigger-fish</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(list (fish 1))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">add-bigger-fish</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">add-bigger-fish</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">fish-size: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: fish?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: (fish 1)</span></p></td></tr></table></blockquote></div></p></div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">size</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">add-bigger-fish</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish-size</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">add-bigger-fish</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">add-bigger-fish</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(list (fish 2) (fish 1))</span></p></td></tr></table></td></tr></table></blockquote></div></p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;prefab-struct&quot;">5.7<tt>&nbsp;</tt><a name="(part._prefab-struct)"></a>Prefab Structure Types</h4><p>Although a <a href="define-struct.html#%28tech._transparent%29" class="techoutside" data-pltdoc="x"><span class="techinside">transparent</span></a> structure type prints in a way that
+shows its content, the printed form of the structure cannot be used in
+an expression to get the structure back, unlike the printed form of a
+number, string, symbol, or list.</p><p>A <a name="(tech._prefab)"></a><span style="font-style: italic">prefab</span> (&ldquo;previously fabricated&rdquo;) structure type is a
+built-in type that is known to the Racket printer and expression
+reader. Infinitely many such types exist, and they are indexed by
+name, field count, supertype, and other such details. The printed form
+of a prefab structure is similar to a vector, but it starts
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#s</span><span class="hspace"></span></span> instead of just <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span>, and the first element in the
+printed form is the prefab structure type&rsquo;s name.</p><p>The following examples show instances of the <span class="RktSym">sprout</span>
+prefab structure type that has one field. The first instance has a
+field value <span class="RktVal">'</span><span class="RktVal">bean</span>, and the second has field value
+<span class="RktVal">'</span><span class="RktVal">alfalfa</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktVal">'</span><span class="RktVal">#s</span><span class="RktVal">(</span><span class="RktVal">sprout</span><span class="hspace">&nbsp;</span><span class="RktVal">bean</span><span class="RktVal">)</span></td></tr><tr><td><p><span class="RktRes">'#s(sprout bean)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">'</span><span class="RktVal">#s</span><span class="RktVal">(</span><span class="RktVal">sprout</span><span class="hspace">&nbsp;</span><span class="RktVal">alfalfa</span><span class="RktVal">)</span></td></tr><tr><td><p><span class="RktRes">'#s(sprout alfalfa)</span></p></td></tr></table></blockquote><p>Like numbers and strings, prefab structures are &ldquo;self-quoting,&rdquo; so
+the quotes above are optional:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktVal">#s</span><span class="RktVal">(</span><span class="RktVal">sprout</span><span class="hspace">&nbsp;</span><span class="RktVal">bean</span><span class="RktVal">)</span></td></tr><tr><td><p><span class="RktRes">'#s(sprout bean)</span></p></td></tr></table></blockquote><p>When you use the <span class="RktPn">#:prefab</span> keyword with
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span>, instead of generating a new structure type,
+you obtain bindings that work with the existing prefab structure type:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lunch</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#s</span><span class="RktVal">(</span><span class="RktVal">sprout</span><span class="hspace">&nbsp;</span><span class="RktVal">bean</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sprout</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">kind</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:prefab</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">sprout?</span><span class="hspace">&nbsp;</span><span class="RktSym">lunch</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">sprout-kind</span><span class="hspace">&nbsp;</span><span class="RktSym">lunch</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'bean</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">sprout</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">garlic</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#s(sprout garlic)</span></p></td></tr></table></blockquote><p>The field name <span class="RktSym">kind</span> above does not matter for finding
+the prefab structure type; only the name <span class="RktSym">sprout</span> and the
+number of fields matters. At the same time, the prefab structure type
+<span class="RktSym">sprout</span> with three fields is a different structure type
+than the one with a single field:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">sprout?</span><span class="hspace">&nbsp;</span><span class="RktVal">#s</span><span class="RktVal">(</span><span class="RktVal">sprout</span><span class="hspace">&nbsp;</span><span class="RktVal">bean</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sprout</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">kind</span><span class="hspace">&nbsp;</span><span class="RktSym">yummy?</span><span class="hspace">&nbsp;</span><span class="RktSym">count</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:prefab</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">redefine</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">sprout?</span><span class="hspace">&nbsp;</span><span class="RktVal">#s</span><span class="RktVal">(</span><span class="RktVal">sprout</span><span class="hspace">&nbsp;</span><span class="RktVal">bean</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">sprout?</span><span class="hspace">&nbsp;</span><span class="RktSym">lunch</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote><p>A prefab structure type can have another prefab structure type as its
+supertype, it can have mutable fields, and it can have auto
+fields. Variations in any of these dimensions correspond to different
+prefab structure types, and the printed form of the structure type&rsquo;s
+name encodes all of the relevant details.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">building</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rooms</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">location</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mutable</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:prefab</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">house</span><span class="hspace">&nbsp;</span><span class="RktSym">building</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">occupied</span><span class="hspace">&nbsp;</span><span class="RktPn">#:auto</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:prefab</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:auto-value</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">no</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">house</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">factory</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#s((house (1 no) building 2 #(1)) 5 factory no)</span></p></td></tr></table></blockquote><p>Every <a href="define-struct.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure type is <a href="define-struct.html#%28tech._transparent%29" class="techoutside" data-pltdoc="x"><span class="techinside">transparent</span></a>&#8212;<wbr></wbr>but even
+less abstract than a <a href="define-struct.html#%28tech._transparent%29" class="techoutside" data-pltdoc="x"><span class="techinside">transparent</span></a> type, because instances can be
+created without any access to a particular structure-type declaration
+or existing examples. Overall, the different options for structure
+types offer a spectrum of possibilities from more abstract to more
+convenient:</p><ul><li><p><a href="define-struct.html#%28tech._opaque%29" class="techoutside" data-pltdoc="x"><span class="techinside">Opaque</span></a> (the default) : Instances cannot be inspected or
+forged without access to the structure-type declaration. As
+discussed in the next section, <a href="define-struct.html#%28tech._constructor._guard%29" class="techoutside" data-pltdoc="x"><span class="techinside">constructor guards</span></a> and
+<a href="define-struct.html#%28tech._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">properties</span></a> can be attached to the structure type to
+further protect or to specialize the behavior of its
+instances.</p></li><li><p><a href="define-struct.html#%28tech._transparent%29" class="techoutside" data-pltdoc="x"><span class="techinside">Transparent</span></a> : Anyone can inspect or create an instance
+without access to the structure-type declaration, which means
+that the value printer can show the content of an instance. All
+instance creation passes through a <a href="define-struct.html#%28tech._constructor._guard%29" class="techoutside" data-pltdoc="x"><span class="techinside">constructor guard</span></a>,
+however, so that the content of an instance can be controlled,
+and the behavior of instances can be specialized through
+<a href="define-struct.html#%28tech._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">properties</span></a>. Since the structure type is generated by its
+definition, instances cannot be manufactured simply through the
+name of the structure type, and therefore cannot be generated
+automatically by the expression reader. </p></li><li><p><a href="define-struct.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">Prefab</span></a> : Anyone can inspect or create an instance at any
+time, without prior access to a structure-type declaration or
+an example instance. Consequently, the expression reader can
+manufacture instances directly. The instance cannot have a
+<a href="define-struct.html#%28tech._constructor._guard%29" class="techoutside" data-pltdoc="x"><span class="techinside">constructor guard</span></a> or <a href="define-struct.html#%28tech._property%29" class="techoutside" data-pltdoc="x"><span class="techinside">properties</span></a>.</p></li></ul><p>Since the expression reader can generate <a href="define-struct.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> instances, they
+are useful when convenient <a href="serialization.html#%28tech._serialization%29" class="techoutside" data-pltdoc="x"><span class="techinside">serialization</span></a> is more important than
+abstraction. <a href="define-struct.html#%28tech._opaque%29" class="techoutside" data-pltdoc="x"><span class="techinside">Opaque</span></a> and <a href="define-struct.html#%28tech._transparent%29" class="techoutside" data-pltdoc="x"><span class="techinside">transparent</span></a> structures also can
+be serialized, however, if they are defined with
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=serialization.html%23%2528form._%2528%2528lib._racket%252Fserialize..rkt%2529._serializable-struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">serializable-struct</a></span> as described in
+<a href="serialization.html" data-pltdoc="x">Datatypes and Serialization</a>.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;struct-options&quot;">5.8<tt>&nbsp;</tt><a name="(part._struct-options)"></a>More Structure Type Options</h4><p>The full syntax of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span> supports many options, both
+at the structure-type level and at the level of individual fields:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktVar">struct-id</span><span class="hspace">&nbsp;</span><span class="RktVar">maybe-super</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">field</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">struct-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">maybe-super</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">super-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">field</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">field-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">field-id</span><span class="hspace">&nbsp;</span><span class="RktVar">field-option</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">]</span></td></tr></table></td></tr></table></blockquote></blockquote><p>A <span class="RktVar">struct-option</span> always starts with a keyword:</p><blockquote class="leftindent"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">#:mutable</span></td></tr></table></blockquote><p>Causes all fields of the structure to be mutable, and introduces
+ for each <span class="RktVar">field-id</span> a <a name="(tech._mutator)"></a><span style="font-style: italic">mutator</span>
+  <span class="RktSym">set-</span><span class="RktVar">struct-id</span><span class="RktSym">-</span><span class="RktVar">field-id</span><span class="RktSym">!</span>
+ that sets the value of the corresponding field in an instance of
+ the structure type.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dot</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mutable</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dot</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">dot-x</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">set-dot-x!</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">dot-x</span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktPn">#:mutable</span> option can also be used as a
+<span class="RktVar">field-option</span>, in which case it makes an individual field
+mutable.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">person</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">age</span><span class="hspace">&nbsp;</span><span class="RktPn">#:mutable</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">friend</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">person</span><span class="hspace">&nbsp;</span><span class="RktVal">"Barney"</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">set-person-age!</span><span class="hspace">&nbsp;</span><span class="RktSym">friend</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">set-person-name!</span><span class="hspace">&nbsp;</span><span class="RktSym">friend</span><span class="hspace">&nbsp;</span><span class="RktVal">"Mary"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">set-person-name!: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr></table></blockquote></div></p></blockquote></blockquote><blockquote class="leftindent"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">#:transparent</span></td></tr></table></blockquote><p>Controls reflective access to structure instances, as discussed
+in a previous section, <a href="define-struct.html#%28part._trans-struct%29" data-pltdoc="x">Opaque versus Transparent Structure Types</a>.</p></blockquote></blockquote><blockquote class="leftindent"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">#:inspector</span><span class="hspace">&nbsp;</span><span class="RktVar">inspector-expr</span></td></tr></table></blockquote><p>Generalizes <span class="RktPn">#:transparent</span> to support more controlled access
+to reflective operations.</p></blockquote></blockquote><blockquote class="leftindent"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">#:prefab</span></td></tr></table></blockquote><p>Accesses a built-in structure type, as discussed
+in a previous section, <a href="define-struct.html#%28part._prefab-struct%29" data-pltdoc="x">Prefab Structure Types</a>.</p></blockquote></blockquote><blockquote class="leftindent"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">#:auto-value</span><span class="hspace">&nbsp;</span><span class="RktVar">auto-expr</span></td></tr></table></blockquote><p>Specifies a value to be used for all automatic fields in the
+structure type, where an automatic field is indicated by the
+<span class="RktPn">#:auto</span> field option. The constructor procedure does not
+accept arguments for automatic fields. Automatic fields are
+implicitly mutable (via reflective operations), but mutator
+functions are bound only if <span class="RktPn">#:mutable</span> is also specified.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">z</span><span class="hspace">&nbsp;</span><span class="RktPn">#:auto</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:auto-value</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(posn 1 2 0)</span></p></td></tr></table></blockquote></div></p></blockquote></blockquote><blockquote class="leftindent"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">#:guard</span><span class="hspace">&nbsp;</span><span class="RktVar">guard-expr</span></td></tr></table></blockquote><p> Specifies a
+ <a name="(tech._constructor._guard)"></a><span style="font-style: italic">constructor guard</span> procedure to be called whenever an
+ instance of the structure type is created. The guard takes as many
+ arguments as non-automatic fields in the structure type, plus one
+ more for the name of the instantiated type (in case a sub-type is
+ instantiated, in which case it&rsquo;s best to report an error using the
+ sub-type&rsquo;s name). The guard should return the same number of values
+ as given, minus the name argument. The guard can raise an exception
+ if one of the given arguments is unacceptable, or it can convert an
+ argument.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">thing</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">name</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:guard</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktSym">type-name</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol-%7E3estring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">symbol-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktSym">type-name</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"bad name: ~e"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">thing</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(thing "apple")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">thing</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">apple</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(thing "apple")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">thing</span><span class="hspace">&nbsp;</span><span class="RktVal">1/2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">thing: bad name: 1/2</span></p></td></tr></table></blockquote></div></p><p>The guard is called even when subtype instances are created. In that
+ case, only the fields accepted by the constructor are provided to
+ the guard (but the subtype&rsquo;s guard gets both the original fields and
+ fields added by the subtype).</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">person</span><span class="hspace">&nbsp;</span><span class="RktSym">thing</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">age</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:guard</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktSym">age</span><span class="hspace">&nbsp;</span><span class="RktSym">type-name</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._negative%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">negative?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">age</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktSym">type-name</span><span class="hspace">&nbsp;</span><span class="RktVal">"bad age: ~e"</span><span class="hspace">&nbsp;</span><span class="RktSym">age</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktSym">age</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">person</span><span class="hspace">&nbsp;</span><span class="RktVal">"John"</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(person "John" 10)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">person</span><span class="hspace">&nbsp;</span><span class="RktVal">"Mary"</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">person: bad age: -1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">person</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">person: bad name: 10</span></p></td></tr></table></blockquote></div></p></blockquote></blockquote><blockquote class="leftindent"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktVar">interface-expr</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">]</span></td></tr></table></blockquote><p>Associates method definitions for the structure type that correspond
+to a <span style="font-style: italic">generic interface</span>.  For example, implementing the
+methods for <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=dicts.html%23%2528form._%2528%2528lib._racket%252Fdict..rkt%2529._gen%7E3adict%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">gen:dict</a></span> allows instances of a structure
+type to be used as dictionaries. Implementing
+the methods for <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Printer_Extension.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._gen%7E3acustom-write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">gen:custom-write</a></span> allows the customization
+of how an instance of a structure type is <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span>ed.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cake</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">candles</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:methods</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Printer_Extension.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._gen%7E3acustom-write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">gen:custom-write</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">write-proc</span><span class="hspace">&nbsp;</span><span class="RktSym">cake</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktSym">mode</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">cake-candles</span><span class="hspace">&nbsp;</span><span class="RktSym">cake</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">"</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">~a</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">~n"</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">#\.</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">" .-~a-. ~n"</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">#\|</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">" | ~a | ~n"</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">#\space</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">"---~a---~n"</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">#\-</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktSym">fmt</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._fprintf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">fprintf</a></span><span class="hspace">&nbsp;</span><span class="RktSym">port</span><span class="hspace">&nbsp;</span><span class="RktSym">fmt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">cake</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut"></span><span class="hspace">&nbsp;</span><span class="RktOut"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktOut">..... </span><span class="hspace">&nbsp;&nbsp;</span><span class="RktOut"></span></p></td></tr><tr><td><p><span class="RktOut"></span><span class="hspace">&nbsp;</span><span class="RktOut">.-|||||-. </span></p></td></tr><tr><td><p><span class="RktOut"></span><span class="hspace">&nbsp;</span><span class="RktOut">| </span><span class="hspace">&nbsp;&nbsp;</span><span class="RktOut"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktOut"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktOut">| </span></p></td></tr><tr><td><p><span class="RktOut">-----------</span></p></td></tr></table></td></tr></table></blockquote></div></p></blockquote></blockquote><blockquote class="leftindent"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">#:property</span><span class="hspace">&nbsp;</span><span class="RktVar">prop-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">val-expr</span></td></tr></table></blockquote><p>Associates a <a name="(tech._property)"></a><span style="font-style: italic">property</span> and value with the structure type.
+  For example, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._prop%7E3aprocedure%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">prop:procedure</a></span> property allows a
+  structure instance to be used as a function; the property value
+  determines how a call is implemented when using the structure as a
+  function.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">greeter</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">name</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:property</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._prop%7E3aprocedure%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">prop:procedure</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">self</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"Hi "</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">", I'm "</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">greeter-name</span><span class="hspace">&nbsp;</span><span class="RktSym">self</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">joe-greet</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">greeter</span><span class="hspace">&nbsp;</span><span class="RktVal">"Joe"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greeter-name</span><span class="hspace">&nbsp;</span><span class="RktSym">joe-greet</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Joe"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">joe-greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"Mary"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hi Mary, I'm Joe"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">joe-greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"John"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hi John, I'm Joe"</span></p></td></tr></table></blockquote></div></p></blockquote></blockquote><blockquote class="leftindent"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">#:super</span><span class="hspace">&nbsp;</span><span class="RktVar">super-expr</span></td></tr></table></blockquote><p>An alternative to supplying a <span class="RktSym">super-id</span> next to
+<span class="RktSym">struct-id</span>. Instead of the name of a structure type (which is
+not an expression), <span class="RktVar">super-expr</span> should produce a
+<a href="define-struct.html#%28tech._structure._type._descriptor%29" class="techoutside" data-pltdoc="x"><span class="techinside">structure type descriptor</span></a> value. An advantage of
+<span class="RktPn">#:super</span> is that structure type descriptors are values, so
+they can be passed to procedures.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">raven-constructor</span><span class="hspace">&nbsp;</span><span class="RktSym">super-type</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">raven</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:super</span><span class="hspace">&nbsp;</span><span class="RktSym">super-type</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:transparent</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:property</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._prop%7E3aprocedure%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">prop:procedure</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">self</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">nevermore</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">raven</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">raven-constructor</span><span class="hspace">&nbsp;</span><span class="RktSym">struct:posn</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">(list (raven 1 2) 'nevermore)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">raven-constructor</span><span class="hspace">&nbsp;</span><span class="RktSym">struct:thing</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">(list (raven "apple") 'nevermore)</span></p></td></tr></table></blockquote></div></p></blockquote></blockquote><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=structures.html&amp;version=8.6" class="Sq" data-pltdoc="x">Structures</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on structure types.</p></blockquote></blockquote></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="parameterize.html" title="backward to &quot;4.13 Dynamic Binding: parameterize&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="modules.html" title="forward to &quot;6 Modules&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/define.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/define.html
new file mode 100644
index 00000000..b1a7eb83
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/define.html
@@ -0,0 +1,38 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.5&nbsp;Definitions: define</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewselflink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="syntax-notation.html" class="tocviewlink" data-pltdoc="x">Notation</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="binding.html" class="tocviewlink" data-pltdoc="x">Identifiers and Binding</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Function Calls</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Functions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span></a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="define.html" class="tocviewselflink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span></a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="conditionals.html" class="tocviewlink" data-pltdoc="x">Conditionals</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span></a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktVal">&rsquo;</span></a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="qq.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span> and <span class="RktVal">&lsquo;</span></a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Simple Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="parameterize.html" class="tocviewlink" data-pltdoc="x">Dynamic Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">parameterize</span></span></a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.5&nbsp;</td><td><a href="define.html" class="tocviewselflink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span></a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.5.1&nbsp;</td><td><a href="define.html#%28part._.Function_.Shorthand%29" class="tocviewlink" data-pltdoc="x">Function Shorthand</a></td></tr><tr><td align="right">4.5.2&nbsp;</td><td><a href="define.html#%28part._.Curried_.Function_.Shorthand%29" class="tocviewlink" data-pltdoc="x">Curried Function Shorthand</a></td></tr><tr><td align="right">4.5.3&nbsp;</td><td><a href="define.html#%28part._multiple-values%29" class="tocviewlink" data-pltdoc="x">Multiple Values and <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>values</span></span></a></td></tr><tr><td align="right">4.5.4&nbsp;</td><td><a href="define.html#%28part._intdefs%29" class="tocviewlink" data-pltdoc="x">Internal Definitions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">4.5.1<tt>&nbsp;</tt></span><a href="define.html#%28part._.Function_.Shorthand%29" class="tocsubseclink" data-pltdoc="x">Function Shorthand</a></td></tr><tr><td><span class="tocsublinknumber">4.5.2<tt>&nbsp;</tt></span><a href="define.html#%28part._.Curried_.Function_.Shorthand%29" class="tocsubseclink" data-pltdoc="x">Curried Function Shorthand</a></td></tr><tr><td><span class="tocsublinknumber">4.5.3<tt>&nbsp;</tt></span><a href="define.html#%28part._multiple-values%29" class="tocsubseclink" data-pltdoc="x">Multiple Values and <span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>values</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.5.4<tt>&nbsp;</tt></span><a href="define.html#%28part._intdefs%29" class="tocsubseclink" data-pltdoc="x">Internal Definitions</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="lambda.html" title="backward to &quot;4.4 Functions (Procedures): lambda&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="let.html" title="forward to &quot;4.6 Local Binding&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;define&quot;">4.5<tt>&nbsp;</tt><a name="(part._define)"></a>Definitions: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span></h4><p>A basic definition has the form</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>in which case <span class="RktVar">id</span> is bound to the result of
+<span class="RktVar">expr</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">salutation</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list-ref</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Hi"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Hello"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._random%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">random</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">salutation</span></td></tr><tr><td><p><span class="RktRes">"Hi"</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Function_Shorthand&quot;">4.5.1<tt>&nbsp;</tt><a name="(part._.Function_.Shorthand)"></a>Function Shorthand</h5><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> form also supports a shorthand for function
+definitions:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>which is a shorthand for</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktSym">...+</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">salutation</span><span class="hspace">&nbsp;</span><span class="RktVal">", "</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"John"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hi, John"</span></p></td></tr></table></blockquote></div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktSym">first</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">surname</span><span class="hspace">&nbsp;</span><span class="RktVal">"Smith"</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">#:hi</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">hi</span><span class="hspace">&nbsp;</span><span class="RktSym">salutation</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hi</span><span class="hspace">&nbsp;</span><span class="RktVal">", "</span><span class="hspace">&nbsp;</span><span class="RktSym">first</span><span class="hspace">&nbsp;</span><span class="RktVal">" "</span><span class="hspace">&nbsp;</span><span class="RktSym">surname</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"John"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hi, John Smith"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"John"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:hi</span><span class="hspace">&nbsp;</span><span class="RktVal">"Hey"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hey, John Smith"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"John"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Doe"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hi, John Doe"</span></p></td></tr></table></td></tr></table></blockquote><p>The function shorthand via <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> also supports a
+<a href="lambda.html#%28tech._rest._argument%29" class="techoutside" data-pltdoc="x"><span class="techinside">rest argument</span></a> (i.e., a final argument to collect extra
+arguments in a list):</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">rest-id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>which is a shorthand</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">rest-id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktSym">...+</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">avg</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">l</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">avg</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Curried_Function_Shorthand&quot;">4.5.2<tt>&nbsp;</tt><a name="(part._.Curried_.Function_.Shorthand)"></a>Curried Function Shorthand</h5><p>Consider the following <span class="RktSym">make-add-suffix</span> function that takes a
+string and returns another function that takes a string:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">make-add-suffix</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">s2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td></td></tr></table></td></tr></table></blockquote><p>Although it&rsquo;s not common, result of <span class="RktSym">make-add-suffix</span> could be
+called directly, like this:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">make-add-suffix</span><span class="hspace">&nbsp;</span><span class="RktVal">"!"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"hello!"</span></p></td></tr></table></blockquote><p>In a sense, <span class="RktSym">make-add-suffix</span> is a function that takes two
+arguments, but it takes them one at a time. A function that takes some
+of its arguments and returns a function to consume more is sometimes
+called a <span style="font-style: italic">curried function</span>.</p><p>Using the function-shorthand form of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span>,
+<span class="RktSym">make-add-suffix</span> can be written equivalently as</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-add-suffix</span><span class="hspace">&nbsp;</span><span class="RktSym">s2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">s2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>This shorthand reflects the shape of the function call
+<span class="RktPn">(</span><span class="RktSym">make-add-suffix</span><span class="stt"> </span><span class="RktVal">"!"</span><span class="RktPn">)</span>. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> form further
+supports a shorthand for defining curried functions that reflects
+nested function calls:</p><p><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">make-add-suffix</span><span class="hspace">&nbsp;</span><span class="RktSym">s2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">s2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">make-add-suffix</span><span class="hspace">&nbsp;</span><span class="RktVal">"!"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"hello!"</span></p></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">louder</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-add-suffix</span><span class="hspace">&nbsp;</span><span class="RktVal">"!"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">less-sure</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-add-suffix</span><span class="hspace">&nbsp;</span><span class="RktVal">"?"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">less-sure</span><span class="hspace">&nbsp;</span><span class="RktVal">"really"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"really?"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">louder</span><span class="hspace">&nbsp;</span><span class="RktVal">"really"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"really!"</span></p></td></tr></table></td></tr></table></blockquote></div></p><p>The full syntax of the function shorthand for <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> is as follows:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">head</span><span class="hspace">&nbsp;</span><span class="RktVar">args</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">head</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">head</span><span class="hspace">&nbsp;</span><span class="RktVar">args</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">args</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktPn">.</span><span class="hspace">&nbsp;</span><span class="RktVar">rest-id</span></td></tr></table></td></tr></table></blockquote></blockquote><p>The expansion of this shorthand has one nested <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> form
+for each <span class="RktVar">head</span> in the definition, where the innermost
+<span class="RktVar">head</span> corresponds to the outermost <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;multiple-values&quot;">4.5.3<tt>&nbsp;</tt><a name="(part._multiple-values)"></a>Multiple Values and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span></h5><p>A Racket expression normally produces a single result, but some
+expressions can produce multiple results. For example,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._quotient%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">quotient</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._remainder%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">remainder</a></span> each produce a single value,
+but <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._quotient%252Fremainder%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">quotient/remainder</a></span> produces the same two values at once:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._quotient%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">quotient</a></span><span class="hspace">&nbsp;</span><span class="RktVal">13</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._remainder%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">remainder</a></span><span class="hspace">&nbsp;</span><span class="RktVal">13</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._quotient%252Fremainder%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">quotient/remainder</a></span><span class="hspace">&nbsp;</span><span class="RktVal">13</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></td></tr></table></blockquote><p>As shown above, the <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> prints each result value on its own
+line.</p><p>Multiple-valued functions can be implemented in terms of the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span> function, which takes any number of values and
+returns them as the results:</p><p><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">split-name</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">parts</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._regexp-split%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-split</a></span><span class="hspace">&nbsp;</span><span class="RktVal">" "</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">parts</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">parts</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">parts</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"not a &lt;first&gt; &lt;last&gt; name"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">split-name</span><span class="hspace">&nbsp;</span><span class="RktVal">"Adam Smith"</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">"Adam"</span></p></td></tr><tr><td><p><span class="RktRes">"Smith"</span></p></td></tr></table></td></tr></table></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span> form binds multiple identifiers at once to
+multiple results produced from a single expression:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>The number of results produced by the <span class="RktVar">expr</span> must match the
+number of <span class="RktVar">id</span>s.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">given</span><span class="hspace">&nbsp;</span><span class="RktSym">surname</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">split-name</span><span class="hspace">&nbsp;</span><span class="RktVal">"Adam Smith"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">given</span></td></tr><tr><td><p><span class="RktRes">"Adam"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">surname</span></td></tr><tr><td><p><span class="RktRes">"Smith"</span></p></td></tr></table></blockquote></div></p><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> form (that is not a function shorthand) is
+equivalent to a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span> form with a single <span class="RktVar">id</span>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html&amp;version=8.6" class="Sq" data-pltdoc="x">Definitions: <span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">define-syntax</span></span>, ...</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on definitions.</p></blockquote></blockquote></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;intdefs&quot;">4.5.4<tt>&nbsp;</tt><a name="(part._intdefs)"></a>Internal Definitions</h5><p>When the grammar for a syntactic form specifies <span class="RktVar">body</span>, then
+the corresponding form can be either a definition or an expression.
+A definition as a <span class="RktVar">body</span> is an <span style="font-style: italic">internal definition</span>.</p><p>Expressions and internal definitions in a <span class="RktVar">body</span> sequence can
+be mixed, as long as the last <span class="RktVar">body</span> is an expression.</p><p>For example, the syntax of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> is</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktVar">gen-formals</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote><p>so the following are valid instances of the grammar:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">no definitions</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"running\n"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">one definition</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">log-it</span><span class="hspace">&nbsp;</span><span class="RktSym">what</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">what</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">log-it</span><span class="hspace">&nbsp;</span><span class="RktVal">"running"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">log-it</span><span class="hspace">&nbsp;</span><span class="RktVal">"done"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">two definitions</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">call</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">log-it</span><span class="hspace">&nbsp;</span><span class="RktVal">"done"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">log-it</span><span class="hspace">&nbsp;</span><span class="RktVal">"running"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">call</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">log-it</span><span class="hspace">&nbsp;</span><span class="RktSym">what</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">what</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">call</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Internal definitions in a particular <span class="RktVar">body</span> sequence are
+mutually recursive; that is, any definition can refer to any other
+definition&#8212;<wbr></wbr>as long as the reference isn&rsquo;t actually evaluated before
+its definition takes place. If a definition is referenced too early,
+an error occurs.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">weird</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">weird</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">x: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot use before initialization</span></p></td></tr></table></blockquote></div></p><p>A sequence of internal definitions using just <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> is
+easily translated to an equivalent <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span> form (as introduced
+in the next section). However, other definition forms can appear as a
+<span class="RktVar">body</span>, including <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span> (see
+<a href="define-struct.html" data-pltdoc="x">Programmer-Defined Datatypes</a>) or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span> (see
+<a href="macros.html" data-pltdoc="x">Macros</a>).</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=syntax-model.html%23%2528part._intdef-body%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Internal Definitions</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> documents the fine points of internal definitions.</p></blockquote></blockquote></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="lambda.html" title="backward to &quot;4.4 Functions (Procedures): lambda&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="let.html" title="forward to &quot;4.6 Local Binding&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/dialects.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/dialects.html
new file mode 100644
index 00000000..5db265aa
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/dialects.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>23&nbsp;Dialects of Racket and Scheme</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewselflink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>23&nbsp;</td><td><a href="dialects.html" class="tocviewselflink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">23.1&nbsp;</td><td><a href="more-hash-lang.html" class="tocviewlink" data-pltdoc="x">More Rackets</a></td></tr><tr><td align="right">23.2&nbsp;</td><td><a href="standards.html" class="tocviewlink" data-pltdoc="x">Standards</a></td></tr><tr><td align="right">23.3&nbsp;</td><td><a href="teaching-langs.html" class="tocviewlink" data-pltdoc="x">Teaching</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="More_Libraries.html" title="backward to &quot;22 More Libraries&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="more-hash-lang.html" title="forward to &quot;23.1 More Rackets&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;dialects&quot;">23<tt>&nbsp;</tt><a name="(part._dialects)"></a>Dialects of Racket and Scheme</h3><p>We use &ldquo;Racket&rdquo; to refer to a specific dialect of the Lisp language,
+and one that is based on the Scheme branch of the Lisp family.
+Despite Racket&rsquo;s similarity to Scheme, the <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> prefix on
+modules is a particular feature of Racket, and programs that start
+with <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> are unlikely to run in other implementations of
+Scheme. At the same time, programs that do not start with <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a>
+do not work with the default mode of most Racket tools.</p><p>&ldquo;Racket&rdquo; is not, however, the only dialect of Lisp that is supported
+by Racket tools. On the contrary, Racket tools are designed to support
+multiple dialects of Lisp and even multiple languages, which allows
+the Racket tool suite to serve multiple communities. Racket also gives
+programmers and researchers the tools they need to explore and create
+new languages.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="more-hash-lang.html" class="toclink" data-pltdoc="x">23.1<span class="hspace">&nbsp;</span>More Rackets</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="standards.html" class="toclink" data-pltdoc="x">23.2<span class="hspace">&nbsp;</span>Standards</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="standards.html#%28part._r5rs%29" class="toclink" data-pltdoc="x">23.2.1<span class="hspace">&nbsp;</span>R<span style="vertical-align: super; font-size: 80%">5</span>RS</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="standards.html#%28part._.R6.R.S%29" class="toclink" data-pltdoc="x">23.2.2<span class="hspace">&nbsp;</span>R<span style="vertical-align: super; font-size: 80%">6</span>RS</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="teaching-langs.html" class="toclink" data-pltdoc="x">23.3<span class="hspace">&nbsp;</span>Teaching</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="More_Libraries.html" title="backward to &quot;22 More Libraries&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="more-hash-lang.html" title="forward to &quot;23.1 More Rackets&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/doc-bibliography.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/doc-bibliography.html
new file mode 100644
index 00000000..37078956
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/doc-bibliography.html
@@ -0,0 +1,2 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>Bibliography</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9660;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublistonly" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewselflink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Visual_Studio_Code.html" title="backward to &quot;24.5 Visual Studio Code&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="doc-index.html" title="forward to &quot;Index&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;doc-bibliography&quot;"><a name="(part._doc-bibliography)"></a>Bibliography</h3><p><table cellspacing="0" cellpadding="0" class="RBibliography"><tr><td><a name="(cite._.Goldberg04)"></a>[Goldberg04]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">David Goldberg, Robert Bruce Findler, and Matthew Flatt, &ldquo;Super and Inner&#8212;<wbr></wbr>Together at Last!,&rdquo; Object-Oriented Programming, Languages, Systems, and Applications, 2004. <a href="http://www.cs.utah.edu/plt/publications/oopsla04-gff.pdf"><span class="stt">http://www.cs.utah.edu/plt/publications/oopsla04-gff.pdf</span></a></span></td></tr><tr><td><a name="(cite._.Flatt02)"></a>[Flatt02]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Matthew Flatt, &ldquo;Composable and Compilable Macros: You Want it When?,&rdquo; International Conference on Functional Programming, 2002.</span></td></tr><tr><td><a name="(cite._.Flatt06)"></a>[Flatt06]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Matthew Flatt, Robert Bruce Findler, and Matthias Felleisen, &ldquo;Scheme with Classes, Mixins, and Traits (invited tutorial),&rdquo; Asian Symposium on Programming Languages and Systems, 2006. <a href="http://www.cs.utah.edu/plt/publications/aplas06-fff.pdf"><span class="stt">http://www.cs.utah.edu/plt/publications/aplas06-fff.pdf</span></a></span></td></tr><tr><td><a name="(cite._.Mitchell02)"></a>[Mitchell02]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Richard Mitchell and Jim McKim, <span style="font-style: italic">Design by Contract, by Example</span>. 2002.</span></td></tr><tr><td><a name="(cite._.Sitaram05)"></a>[Sitaram05]</td><td><span class="hspace">&nbsp;</span></td><td><span class="bibentry">Dorai Sitaram, &ldquo;pregexp: Portable Regular Expressions for Scheme and Common Lisp.&rdquo; 2002. <a href="http://www.ccs.neu.edu/home/dorai/pregexp/"><span class="stt">http://www.ccs.neu.edu/home/dorai/pregexp/</span></a></span></td></tr></table></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Visual_Studio_Code.html" title="backward to &quot;24.5 Visual Studio Code&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="doc-index.html" title="forward to &quot;Index&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/doc-index.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/doc-index.html
new file mode 100644
index 00000000..44aff935
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/doc-index.html
@@ -0,0 +1,17 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>Index</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9660;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublistonly" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewselflink" data-pltdoc="x">Index</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="doc-bibliography.html" title="backward to &quot;Bibliography&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<span class="nonavigation">next &rarr;</span></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;doc-index&quot;"><a name="(part._doc-index)"></a>Index</h3><table cellspacing="0" cellpadding="0"><tr><td><p><a href="doc-index.html#alpha:A">A</a> <a href="doc-index.html#alpha:B">B</a> <a href="doc-index.html#alpha:C">C</a> <a href="doc-index.html#alpha:D">D</a> <a href="doc-index.html#alpha:E">E</a> <a href="doc-index.html#alpha:F">F</a> <a href="doc-index.html#alpha:G">G</a> <a href="doc-index.html#alpha:H">H</a> <a href="doc-index.html#alpha:I">I</a> <a href="doc-index.html#alpha:J">J</a> <a href="doc-index.html#alpha:K">K</a> <a href="doc-index.html#alpha:L">L</a> <a href="doc-index.html#alpha:M">M</a> <a href="doc-index.html#alpha:N">N</a> <a href="doc-index.html#alpha:O">O</a> <a href="doc-index.html#alpha:P">P</a> <a href="doc-index.html#alpha:Q">Q</a> <a href="doc-index.html#alpha:R">R</a> <a href="doc-index.html#alpha:S">S</a> <a href="doc-index.html#alpha:T">T</a> <a href="doc-index.html#alpha:U">U</a> <a href="doc-index.html#alpha:V">V</a> <a href="doc-index.html#alpha:W">W</a> <span class="nonavigation">X</span> <span class="nonavigation">Y</span> <span class="nonavigation">Z</span> </p></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><p><a href="module-paths.html#%28idx._%28gentag._2._%28lib._scribblings%2Fguide%2Fguide..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">"main.rkt"</span><br/></a><a href="scripts.html#%28idx._%28gentag._8._%28lib._scribblings%2Fguide%2Fguide..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">#!</span><br/></a><a href="scripts.html#%28idx._%28gentag._9._%28lib._scribblings%2Fguide%2Fguide..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="stt">.bat</span><br/></a><a href="cmdline-tools.html#%28idx._%28gentag._10._%28lib._scribblings%2Fguide%2Fguide..scrbl%29%29%29" class="indexlink" data-pltdoc="x">.zo<br/></a><a href="performance.html#%28tech._3m%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">3m</span><br/></a><a name="alpha:A"></a><span><a href="contracts-examples.html#%28part._.A_.Customer-.Manager_.Component%29" class="indexlink" data-pltdoc="x">A Customer-Manager Component<br/></a></span><a href="contracts-examples.html#%28part._.A_.Dictionary%29" class="indexlink" data-pltdoc="x">A Dictionary<br/></a><a href="intro.html#%28part._use-module%29" class="indexlink" data-pltdoc="x">A Note to Readers with Lisp/Scheme Experience<br/></a><a href="contracts-examples.html#%28part._.A_.Parameteric__.Simple__.Stack%29" class="indexlink" data-pltdoc="x">A Parameteric (Simple) Stack<br/></a><a href="contracts-examples.html#%28part._.A_.Queue%29" class="indexlink" data-pltdoc="x">A Queue<br/></a><a href="Pairs__Lists__and_Racket_Syntax.html#%28part._.Abbreviating_quote_with__%29" class="indexlink" data-pltdoc="x">Abbreviating <span class="RktSym"><span class="RktStxLink">quote</span></span> with <span class="RktVal">'</span><br/></a><a href="prompt.html#%28tech._abort%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">aborts</span><br/></a><a href="contracts-exists.html" class="indexlink" data-pltdoc="x">Abstract Contracts using <span class="RktPn">#:exists</span> and <span class="RktPn">#:&#8707;</span><br/></a><a href="define-struct.html#%28tech._accessor%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">accessor</span><br/></a><a href="module-basics.html#%28part._link-collection%29" class="indexlink" data-pltdoc="x">Adding Collections<br/></a><a href="Contracts_for_Units.html#%28part._.Adding_.Contracts_to_.Signatures%29" class="indexlink" data-pltdoc="x">Adding Contracts to Signatures<br/></a><a href="Contracts_for_Units.html#%28part._.Adding_.Contracts_to_.Units%29" class="indexlink" data-pltdoc="x">Adding Contracts to Units<br/></a><a href="contracts-examples.html" class="indexlink" data-pltdoc="x">Additional Examples<br/></a><a href="regexp-alternation.html" class="indexlink" data-pltdoc="x">Alternation<br/></a><a href="syntax-overview.html#%28part._indentation%29" class="indexlink" data-pltdoc="x">An Aside on Indenting Code<br/></a><a href="An_Extended_Example.html" class="indexlink" data-pltdoc="x">An Extended Example<br/></a><a href="More_Libraries.html#%28part._.And_.More%29" class="indexlink" data-pltdoc="x">And More<br/></a><a href="syntax-overview.html#%28part._.Anonymous_.Functions_with_lambda%29" class="indexlink" data-pltdoc="x">Anonymous Functions with <span class="RktSym"><span class="RktStxLink">lambda</span></span><br/></a><a href="contract-func.html#%28part._any_and_any_c%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">any</span></span> and <span class="RktSym"><span class="RktValLink">any/c</span></span><br/></a><a href="contracts-general-functions.html#%28part._contracts-arrow-d%29" class="indexlink" data-pltdoc="x">Argument and Result Dependencies<br/></a><a href="lambda.html#%28part._case-lambda%29" class="indexlink" data-pltdoc="x">Arity-Sensitive Functions: <span class="RktSym"><span class="RktStxLink">case-lambda</span></span><br/></a><a href="regexp-assert.html#%28tech._assertion%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">assertions</span><br/></a><a href="module-set.html" class="indexlink" data-pltdoc="x">Assignment and Redefinition<br/></a><a href="set_.html" class="indexlink" data-pltdoc="x">Assignment: <span class="RktSym"><span class="RktStxLink">set!</span></span><br/></a><a href="mk-namespace.html#%28tech._attached%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">attached</span><br/></a><a href="macro-module.html#%28tech._available%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">available</span><br/></a><a name="alpha:B"></a><span><a href="regexp-clusters.html#%28tech._backreference%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">backreference</span><br/></a></span><a href="regexp-clusters.html#%28part._.Backreferences%29" class="indexlink" data-pltdoc="x">Backreferences<br/></a><a href="Backtracking.html" class="indexlink" data-pltdoc="x">Backtracking<br/></a><a href="Backtracking.html#%28tech._backtracking%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">backtracking</span><br/></a><a href="regexp-assert.html" class="indexlink" data-pltdoc="x">Basic Assertions<br/></a><a href="performance.html#%28tech._bc%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">BC</span><br/></a><a href="performance.html" class="indexlink" data-pltdoc="x">benchmarking<br/></a><a href="parallelism.html#%28tech._blocking%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">blocking</span><br/></a><a href="booleans.html" class="indexlink" data-pltdoc="x">Booleans<br/></a><a href="boxes.html#%28tech._box%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">box</span><br/></a><a href="boxes.html" class="indexlink" data-pltdoc="x">Boxes<br/></a><a href="regexp-chars.html#%28tech._bracketed._character._clas%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">bracketed
+character class</span><br/></a><a href="for.html#%28part._.Breaking_an_.Iteration%29" class="indexlink" data-pltdoc="x">Breaking an Iteration<br/></a><a href="concurrency.html#%28part._.Buffered_.Asynchronous_.Channels%29" class="indexlink" data-pltdoc="x">Buffered Asynchronous Channels<br/></a><a href="Building_New_Contracts.html" class="indexlink" data-pltdoc="x">Building New Contracts<br/></a><a href="concurrency.html#%28part._.Building_.Your_.Own_.Synchronization_.Patterns%29" class="indexlink" data-pltdoc="x">Building Your Own Synchronization Patterns<br/></a><a href="datatypes.html" class="indexlink" data-pltdoc="x">Built-In Datatypes<br/></a><a href="bytestrings.html#%28tech._byte%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">byte</span><br/></a><a href="bytestrings.html#%28tech._byte._string%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">byte string</span><br/></a><a href="performance.html#%28part._.J.I.T%29" class="indexlink" data-pltdoc="x">Bytecode, Machine Code, and Just-in-Time (JIT) Compilers<br/></a><a href="bytestrings.html" class="indexlink" data-pltdoc="x">Bytes and Byte Strings<br/></a><a href="encodings.html" class="indexlink" data-pltdoc="x">Bytes, Characters, and Encodings<br/></a><a name="alpha:C"></a><span><a href="pattern-macros.html#%28tech._call._by._reference%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">call-by-reference</span><br/></a></span><a href="performance.html#%28tech._cgc%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">CGC</span><br/></a><a href="conditionals.html#%28part._cond%29" class="indexlink" data-pltdoc="x">Chaining Tests: <span class="RktSym"><span class="RktStxLink">cond</span></span><br/></a><a href="concurrency.html#%28part._.Channels%29" class="indexlink" data-pltdoc="x">Channels<br/></a><a href="characters.html#%28tech._character%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">character</span><br/></a><a href="regexp-chars.html#%28tech._character._clas%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">character class</span><br/></a><a href="characters.html" class="indexlink" data-pltdoc="x">Characters<br/></a><a href="regexp-chars.html" class="indexlink" data-pltdoc="x">Characters and Character Classes<br/></a><a href="contracts-struct.html#%28part._contracts-lazy-contracts%29" class="indexlink" data-pltdoc="x">Checking Properties of Data Structures<br/></a><a href="contracts-general-functions.html#%28part._contracts-arrow-d-eval-order%29" class="indexlink" data-pltdoc="x">Checking State Changes<br/></a><a href="classes.html#%28part._.Class_.Contracts%29" class="indexlink" data-pltdoc="x">Class Contracts<br/></a><a href="classes.html" class="indexlink" data-pltdoc="x">Classes and Objects<br/></a><a href="regexp-clusters.html#%28tech._cloister%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">cloister</span><br/></a><a href="regexp-clusters.html#%28part._regexp-cloister%29" class="indexlink" data-pltdoc="x">Cloisters<br/></a><a href="performance.html#%28tech._closure%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">closures</span><br/></a><a href="regexp-clusters.html#%28tech._clustering%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">Clustering</span><br/></a><a href="regexp-clusters.html" class="indexlink" data-pltdoc="x">Clusters<br/></a><a href="code-inspectors_protect.html#%28tech._code._inspector%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">Code inspectors</span><br/></a><a href="code-inspectors_protect.html" class="indexlink" data-pltdoc="x">Code Inspectors for Trusted and Untrusted Code<br/></a><a href="module-basics.html#%28tech._collection%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">collection</span><br/></a><a href="conditionals.html#%28part._and%2Bor%29" class="indexlink" data-pltdoc="x">Combining Tests: <span class="RktSym"><span class="RktStxLink">and</span></span> and <span class="RktSym"><span class="RktStxLink">or</span></span><br/></a><a href="cmdline-tools.html" class="indexlink" data-pltdoc="x">Command-Line Tools<br/></a><a href="other-editors.html" class="indexlink" data-pltdoc="x">Command-Line Tools and Your Editor of Choice<br/></a><a href="syntax-overview.html#%28idx._%28gentag._0._%28lib._scribblings%2Fguide%2Fguide..scrbl%29%29%29" class="indexlink" data-pltdoc="x">comments<br/></a><a href="cmdline-tools.html#%28part._compile%29" class="indexlink" data-pltdoc="x">Compilation and Configuration: <span class="stt">raco</span><br/></a><a href="stx-phases.html" class="indexlink" data-pltdoc="x">Compile and Run-Time Phases<br/></a><a href="macro-module.html#%28part._compile-time-instantiation%29" class="indexlink" data-pltdoc="x">Compile-Time Instantiation<br/></a><a href="numbers.html#%28tech._complex%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">complex</span><br/></a><a href="units.html#%28tech._component%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">components</span><br/></a><a href="conts.html#%28tech._composable._continuation%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">composable continuations</span><br/></a><a href="concurrency.html#%28tech._concurrency%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">concurrency</span><br/></a><a href="concurrency.html" class="indexlink" data-pltdoc="x">Concurrency and Synchronization<br/></a><a href="conditionals.html" class="indexlink" data-pltdoc="x">Conditionals<br/></a><a href="syntax-overview.html#%28part._.Conditionals_with_if__and__or__and_cond%29" class="indexlink" data-pltdoc="x">Conditionals with <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, <span class="RktSym"><span class="RktStxLink">or</span></span>, and <span class="RktSym"><span class="RktStxLink">cond</span></span><br/></a><a href="performance.html#%28tech._conservative._garbage._collector%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">conservative garbage collector</span><br/></a><a href="define-struct.html#%28tech._constructor%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">constructor</span><br/></a><a href="define-struct.html#%28tech._constructor._guard%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">constructor guard</span><br/></a><a href="conts.html#%28tech._continuation%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">continuation</span><br/></a><a href="conts.html" class="indexlink" data-pltdoc="x">Continuations<br/></a><a href="contracts-gotchas.html#%28part._contracts-gotcha-nested%29" class="indexlink" data-pltdoc="x">Contract boundaries and <span class="RktSym"><span class="RktStxLink">define/contract</span></span><br/></a><a href="contract-func.html#%28tech._contract._combinator%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">contract
+combinator</span><br/></a><a href="contract-func.html#%28part._contracts-flat-named-contracts%29" class="indexlink" data-pltdoc="x">Contract Messages with &ldquo;???&rdquo;<br/></a><a href="Building_New_Contracts.html#%28part._.Contract_.Struct_.Properties%29" class="indexlink" data-pltdoc="x">Contract Struct Properties<br/></a><a href="contract-boundaries.html#%28part._contracts-amount0%29" class="indexlink" data-pltdoc="x">Contract Violations<br/></a><a href="contracts.html" class="indexlink" data-pltdoc="x">Contracts<br/></a><a href="contract-boundaries.html" class="indexlink" data-pltdoc="x">Contracts and Boundaries<br/></a><a href="contracts-gotchas.html#%28part._.Contracts_and_eq_%29" class="indexlink" data-pltdoc="x">Contracts and <span class="RktSym"><span class="RktValLink">eq?</span></span><br/></a><a href="contracts-general-functions.html#%28part._contracts-case-lambda%29" class="indexlink" data-pltdoc="x">Contracts for <span class="RktSym"><span class="RktStxLink">case-lambda</span></span><br/></a><a href="Contracts_for_Units.html" class="indexlink" data-pltdoc="x">Contracts for Units<br/></a><a href="contracts-general-functions.html" class="indexlink" data-pltdoc="x">Contracts on Functions in General<br/></a><a href="contract-func.html#%28part._.Contracts_on_.Higher-order_.Functions%29" class="indexlink" data-pltdoc="x">Contracts on Higher-order Functions<br/></a><a href="contracts-struct.html" class="indexlink" data-pltdoc="x">Contracts on Structures<br/></a><a href="contracts-first.html" class="indexlink" data-pltdoc="x">Contracts: A Thorough Example<br/></a><a href="classes.html#%28part._extnames%29" class="indexlink" data-pltdoc="x">Controlling the Scope of External Names<br/></a><a href="define-struct.html#%28part._struct-copy%29" class="indexlink" data-pltdoc="x">Copying and Update<br/></a><a href="mk-namespace.html#%28part._.Creating_and_.Installing_.Namespaces%29" class="indexlink" data-pltdoc="x">Creating and Installing Namespaces<br/></a><a href="intro.html#%28part._.Creating_.Executables%29" class="indexlink" data-pltdoc="x">Creating Executables<br/></a><a href="languages.html" class="indexlink" data-pltdoc="x">Creating Languages<br/></a><a href="exe.html" class="indexlink" data-pltdoc="x">Creating Stand-Alone Executables<br/></a><a href="performance.html#%28tech._c%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">CS</span><br/></a><a href="conts.html#%28tech._current._continuation%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">current continuation</span><br/></a><a href="eval.html#%28tech._current._namespace%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">current namespace</span><br/></a><a href="define.html#%28part._.Curried_.Function_.Shorthand%29" class="indexlink" data-pltdoc="x">Curried Function Shorthand<br/></a><a name="alpha:D"></a><span><a href="serialization.html" class="indexlink" data-pltdoc="x">Datatypes and Serialization<br/></a></span><a href="macro-module.html#%28part._.Declaration_versus_.Instantiation%29" class="indexlink" data-pltdoc="x">Declaration versus Instantiation<br/></a><a href="lambda.html#%28part._rest-args%29" class="indexlink" data-pltdoc="x">Declaring a Rest Argument<br/></a><a href="lambda.html#%28part._lambda-keywords%29" class="indexlink" data-pltdoc="x">Declaring Keyword Arguments<br/></a><a href="lambda.html#%28part._.Declaring_.Optional_.Arguments%29" class="indexlink" data-pltdoc="x">Declaring Optional Arguments<br/></a><a href="default-ports.html" class="indexlink" data-pltdoc="x">Default Ports<br/></a><a href="prompt.html#%28tech._default._prompt._tag%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">default
+prompt tag</span><br/></a><a href="pattern-macros.html#%28part._define-syntax_and_syntax-rules%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-syntax</span></span> and <span class="RktSym"><span class="RktStxLink">syntax-rules</span></span><br/></a><a href="pattern-macros.html#%28part._define-syntax-rule%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-syntax-rule</span></span><br/></a><a href="hash-languages.html" class="indexlink" data-pltdoc="x">Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages<br/></a><a href="contracts-gotchas.html#%28part._.Defining_.Recursive_.Contracts%29" class="indexlink" data-pltdoc="x">Defining Recursive Contracts<br/></a><a href="syntax-overview.html#%28part._.Definitions%29" class="indexlink" data-pltdoc="x">Definitions<br/></a><a href="intro.html#%28part._.Definitions_and_.Interactions%29" class="indexlink" data-pltdoc="x">Definitions and Interactions<br/></a><a href="intro.html#%28tech._definitions._area%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">definitions area</span><br/></a><a href="define.html" class="indexlink" data-pltdoc="x">Definitions: <span class="RktSym"><span class="RktStxLink">define</span></span><br/></a><a href="conts.html#%28tech._delimited._continuation%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">delimited continuations</span><br/></a><a href="hash-lang_syntax.html" class="indexlink" data-pltdoc="x">Designating a <span class="RktModLink"><span class="RktMod">#lang</span></span> Language<br/></a><a href="match.html#%28idx._%28gentag._3._%28lib._scribblings%2Fguide%2Fguide..scrbl%29%29%29" class="indexlink" data-pltdoc="x">destructing
+bind<br/></a><a href="dialects.html" class="indexlink" data-pltdoc="x">Dialects of Racket and Scheme<br/></a><a href="contract-func.html#%28part._contracts-dissecting-contract-errors%29" class="indexlink" data-pltdoc="x">Dissecting a contract error message<br/></a><a href="parallelism.html#%28part._distributed-places%29" class="indexlink" data-pltdoc="x">Distributed Places<br/></a><a href="contract-func.html#%28tech._domain%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">domain</span><br/></a><a href="parameterize.html" class="indexlink" data-pltdoc="x">Dynamic Binding: <span class="RktSym"><span class="RktStxLink">parameterize</span></span><br/></a><a name="alpha:E"></a><span><a href="begin.html#%28part._.Effects_.After__begin0%29" class="indexlink" data-pltdoc="x">Effects After: <span class="RktSym"><span class="RktStxLink">begin0</span></span><br/></a></span><a href="begin.html#%28part._.Effects_.Before__begin%29" class="indexlink" data-pltdoc="x">Effects Before: <span class="RktSym"><span class="RktStxLink">begin</span></span><br/></a><a href="begin.html#%28part._when%2Bunless%29" class="indexlink" data-pltdoc="x">Effects If...: <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span><br/></a><a href="Emacs.html" class="indexlink" data-pltdoc="x">Emacs<br/></a><a href="eval.html" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eval</span></span><br/></a><a href="application.html#%28part._.Evaluation_.Order_and_.Arity%29" class="indexlink" data-pltdoc="x">Evaluation Order and Arity<br/></a><a href="exns.html#%28tech._exception%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">exception</span><br/></a><a href="exns.html" class="indexlink" data-pltdoc="x">Exceptions<br/></a><a href="control.html" class="indexlink" data-pltdoc="x">Exceptions and Control<br/></a><a href="contracts-gotchas.html#%28part._contracts-exists-gotcha%29" class="indexlink" data-pltdoc="x">Exists Contracts and Predicates<br/></a><a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._expander%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">expander</span><br/></a><a href="macros.html#%28tech._expand%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">expands</span><br/></a><a href="contract-boundaries.html#%28part._.Experimenting_with_.Contracts_and_.Modules%29" class="indexlink" data-pltdoc="x">Experimenting with Contracts and Modules<br/></a><a href="contract-boundaries.html#%28part._contracts-intro-nested%29" class="indexlink" data-pltdoc="x">Experimenting with Nested Contract Boundaries<br/></a><a href="module-provide.html" class="indexlink" data-pltdoc="x">Exports: <span class="RktSym"><span class="RktStxLink">provide</span></span><br/></a><a href="scheme-forms.html" class="indexlink" data-pltdoc="x">Expressions and Definitions<br/></a><a href="pattern-macros.html#%28part._pattern-macro-example%29" class="indexlink" data-pltdoc="x">Extended Example: Call-by-Reference Functions<br/></a><a href="classes.html#%28part._.External_.Class_.Contracts%29" class="indexlink" data-pltdoc="x">External Class Contracts<br/></a><a name="alpha:F"></a><span><a href="classes.html#%28part._inner%29" class="indexlink" data-pltdoc="x">Final, Augment, and Inner<br/></a></span><a href="firstclassunits.html" class="indexlink" data-pltdoc="x">First-Class Units<br/></a><a href="contracts-general-functions.html#%28part._contracts-no-domain%29" class="indexlink" data-pltdoc="x">Fixed but Statically Unknown Arities<br/></a><a href="performance.html#%28tech._fixnum%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">fixnum</span><br/></a><a href="performance.html#%28part._fixnums%2Bflonums%29" class="indexlink" data-pltdoc="x">Fixnum and Flonum Optimizations<br/></a><a href="contract-func.html#%28tech._flat._named._contract%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">flat named
+contracts</span><br/></a><a href="performance.html#%28tech._flonum%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">flonum</span><br/></a><a href="for.html#%28part._for_and_for_%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for</span></span> and <span class="RktSym"><span class="RktStxLink">for*</span></span><br/></a><a href="for.html#%28part._for_and_and_for_or%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/and</span></span> and <span class="RktSym"><span class="RktStxLink">for/or</span></span><br/></a><a href="for.html#%28part._for_first_and_for_last%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/first</span></span> and <span class="RktSym"><span class="RktStxLink">for/last</span></span><br/></a><a href="for.html#%28part._for%2Ffold%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/fold</span></span> and <span class="RktSym"><span class="RktStxLink">for*/fold</span></span><br/></a><a href="for.html#%28part._for_list_and_for__list%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/list</span></span> and <span class="RktSym"><span class="RktStxLink">for*/list</span></span><br/></a><a href="for.html#%28part._for_vector_and_for__vector%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/vector</span></span> and <span class="RktSym"><span class="RktStxLink">for*/vector</span></span><br/></a><a href="performance.html#%28part._ffi-pointer-access%29" class="indexlink" data-pltdoc="x">Foreign Pointers<br/></a><a href="syntax-overview.html#%28part._.Function_.Calls__.Procedure_.Applications_%29" class="indexlink" data-pltdoc="x">Function Calls (Procedure Applications)<br/></a><a href="application.html" class="indexlink" data-pltdoc="x">Function Calls (Procedure Applications)<br/></a><a href="syntax-overview.html#%28part._.Function_.Calls__.Again%29" class="indexlink" data-pltdoc="x">Function Calls, Again<br/></a><a href="define.html#%28part._.Function_.Shorthand%29" class="indexlink" data-pltdoc="x">Function Shorthand<br/></a><a href="performance.html#%28part._func-call-performance%29" class="indexlink" data-pltdoc="x">Function-Call Optimizations<br/></a><a href="define-struct.html#%28tech._functional._update%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">functional update</span><br/></a><a href="lambda.html" class="indexlink" data-pltdoc="x">Functions (Procedures): <span class="RktSym"><span class="RktStxLink">lambda</span></span><br/></a><a href="parallelism.html#%28tech._future%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">futures</span><br/></a><a name="alpha:G"></a><span><a href="proc-macros.html" class="indexlink" data-pltdoc="x">General Macro Transformers<br/></a></span><a href="phases.html" class="indexlink" data-pltdoc="x">General Phase Levels<br/></a><a href="performance.html#%28tech._generational._garbage._collector%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">generational garbage collector</span><br/></a><a href="contracts-gotchas.html" class="indexlink" data-pltdoc="x">Gotchas<br/></a><a href="More_Libraries.html#%28part._graphics%29" class="indexlink" data-pltdoc="x">Graphics and GUIs<br/></a><a href="regexp-quant.html#%28tech._greedy%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">greedy</span><br/></a><a href="contracts-struct.html#%28part._contracts-single-struct%29" class="indexlink" data-pltdoc="x">Guarantees for a Specific Value<br/></a><a href="contracts-struct.html#%28part._contracts-define-struct%29" class="indexlink" data-pltdoc="x">Guarantees for All Values<br/></a><a href="set_.html#%28part._using-set%21%29" class="indexlink" data-pltdoc="x">Guidelines for Using Assignment<br/></a><a name="alpha:H"></a><span><a href="hash-tables.html#%28tech._hash._table%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">hash table</span><br/></a></span><a href="hash-tables.html" class="indexlink" data-pltdoc="x">Hash Tables<br/></a><a href="Vim.html#%28part._.Highlighting%29" class="indexlink" data-pltdoc="x">Highlighting<br/></a><a name="alpha:I"></a><span><a href="io-patterns.html" class="indexlink" data-pltdoc="x">I/O Patterns<br/></a></span><a href="pattern-macros.html#%28tech._identifier._macro%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">identifier macro</span><br/></a><a href="pattern-macros.html#%28part._.Identifier_.Macros%29" class="indexlink" data-pltdoc="x">Identifier Macros<br/></a><a href="stx-obj.html#%28tech._identifier._syntax._object%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">identifier
+syntax object</span><br/></a><a href="syntax-overview.html#%28part._.Identifiers%29" class="indexlink" data-pltdoc="x">Identifiers<br/></a><a href="binding.html" class="indexlink" data-pltdoc="x">Identifiers and Binding<br/></a><a href="begin.html#%28tech._implicit._begin%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">implicit begin</span><br/></a><a href="module-languages.html#%28part._implicit-forms%29" class="indexlink" data-pltdoc="x">Implicit Form Bindings<br/></a><a href="module-require.html" class="indexlink" data-pltdoc="x">Imports: <span class="RktSym"><span class="RktStxLink">require</span></span><br/></a><a href="performance.html#%28tech._incremental._garbage._collection%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">incremental
+garbage-collection</span><br/></a><a href="Vim.html#%28part._.Indentation%29" class="indexlink" data-pltdoc="x">Indentation<br/></a><a href="regexp-match.html#%28tech._index._pair%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">index pairs</span><br/></a><a href="classes.html#%28part._.Inherit_and_.Super_in_.Traits%29" class="indexlink" data-pltdoc="x">Inherit and Super in Traits<br/></a><a href="classes.html#%28part._initargs%29" class="indexlink" data-pltdoc="x">Initialization Arguments<br/></a><a href="i_o.html" class="indexlink" data-pltdoc="x">Input and Output<br/></a><a href="language-collection.html" class="indexlink" data-pltdoc="x">Installing a Language<br/></a><a href="macro-module.html#%28tech._instantiated%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">instantiated</span><br/></a><a href="module-require.html#%28tech._instantiate%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">instantiates</span><br/></a><a href="macro-module.html#%28tech._instantiation%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">instantiation</span><br/></a><a href="numbers.html#%28tech._integer%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">integer</span><br/></a><a href="intro.html#%28part._.Interacting_with_.Racket%29" class="indexlink" data-pltdoc="x">Interacting with Racket<br/></a><a href="cmdline-tools.html#%28part._.Interactive_evaluation%29" class="indexlink" data-pltdoc="x">Interactive evaluation<br/></a><a href="racket.html#%28part._start-interactive-mode%29" class="indexlink" data-pltdoc="x">Interactive Mode<br/></a><a href="classes.html#%28part._.Interfaces%29" class="indexlink" data-pltdoc="x">Interfaces<br/></a><a href="classes.html#%28part._intnames%29" class="indexlink" data-pltdoc="x">Internal and External Names<br/></a><a href="classes.html#%28part._.Internal_.Class_.Contracts%29" class="indexlink" data-pltdoc="x">Internal Class Contracts<br/></a><a href="define.html#%28part._intdefs%29" class="indexlink" data-pltdoc="x">Internal Definitions<br/></a><a href="units.html#%28tech._invoked%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">invoked</span><br/></a><a href="Invoking_Units.html" class="indexlink" data-pltdoc="x">Invoking Units<br/></a><a href="for.html#%28part._for-performance%29" class="indexlink" data-pltdoc="x">Iteration Performance<br/></a><a href="for.html" class="indexlink" data-pltdoc="x">Iterations and Comprehensions<br/></a><a name="alpha:J"></a><span><a href="performance.html#%28tech._jit%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">JIT</span><br/></a></span><a href="performance.html#%28tech._just._in._time%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">just-in-time</span><br/></a><a name="alpha:K"></a><span><a href="keywords.html#%28tech._keyword%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">keyword</span><br/></a></span><a href="contracts-general-functions.html#%28part._contracts-keywords%29" class="indexlink" data-pltdoc="x">Keyword Arguments<br/></a><a href="application.html#%28part._keyword-args%29" class="indexlink" data-pltdoc="x">Keyword Arguments<br/></a><a href="keywords.html" class="indexlink" data-pltdoc="x">Keywords<br/></a><a name="alpha:L"></a><span><a href="macro-module.html#%28part._stx-available-module%29" class="indexlink" data-pltdoc="x">Lazy Visits via Available Modules<br/></a></span><a href="performance.html#%28part._letrec-performance%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">letrec</span></span> Performance<br/></a><a href="pattern-macros.html#%28part._.Lexical_.Scope%29" class="indexlink" data-pltdoc="x">Lexical Scope<br/></a><a href="module-basics.html#%28part._.Library_.Collections%29" class="indexlink" data-pltdoc="x">Library Collections<br/></a><a href="Linking_Units.html#%28tech._link%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">link</span><br/></a><a href="Linking_Units.html" class="indexlink" data-pltdoc="x">Linking Units<br/></a><a href="pairs.html#%28tech._list%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">list</span><br/></a><a href="Lists__Iteration__and_Recursion.html#%28part._.List_.Iteration_from_.Scratch%29" class="indexlink" data-pltdoc="x">List Iteration from Scratch<br/></a><a href="Pairs__Lists__and_Racket_Syntax.html#%28part._lists-and-syntax%29" class="indexlink" data-pltdoc="x">Lists and Racket Syntax<br/></a><a href="Lists__Iteration__and_Recursion.html" class="indexlink" data-pltdoc="x">Lists, Iteration, and Recursion<br/></a><a href="racket.html#%28part._start-load-mode%29" class="indexlink" data-pltdoc="x">Load Mode<br/></a><a href="let.html" class="indexlink" data-pltdoc="x">Local Binding<br/></a><a href="syntax-overview.html#%28part._local-binding-intro%29" class="indexlink" data-pltdoc="x">Local Binding with
+<span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">let</span></span>, and <span class="RktSym"><span class="RktStxLink">let*</span></span><br/></a><a href="eval.html#%28part._.Local_.Scopes%29" class="indexlink" data-pltdoc="x">Local Scopes<br/></a><a href="Looking_Ahead_and_Behind.html#%28part._.Lookahead%29" class="indexlink" data-pltdoc="x">Lookahead<br/></a><a href="Looking_Ahead_and_Behind.html#%28part._.Lookbehind%29" class="indexlink" data-pltdoc="x">Lookbehind<br/></a><a href="Looking_Ahead_and_Behind.html" class="indexlink" data-pltdoc="x">Looking Ahead and Behind<br/></a><a name="alpha:M"></a><span><a href="macros.html#%28tech._macro%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">macro</span><br/></a></span><a href="pattern-macros.html#%28tech._macro._pattern._variable%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">macro pattern
+variables</span><br/></a><a href="proc-macros.html#%28tech._macro._transformer%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">macro transformer</span><br/></a><a href="macro-transformers.html" class="indexlink" data-pltdoc="x">Macro Transformer Procedures<br/></a><a href="pattern-macros.html#%28tech._macro._generating._macro%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">macro-generating
+macro</span><br/></a><a href="pattern-macros.html#%28part._.Macro-.Generating_.Macros%29" class="indexlink" data-pltdoc="x">Macro-Generating Macros<br/></a><a href="macros.html" class="indexlink" data-pltdoc="x">Macros<br/></a><a href="Module_Syntax.html#%28part._main-and-test%29" class="indexlink" data-pltdoc="x">Main and Test Submodules<br/></a><a href="Module_Syntax.html#%28idx._%28gentag._1._%28lib._scribblings%2Fguide%2Fguide..scrbl%29%29%29" class="indexlink" data-pltdoc="x"><span class="RktSym">main</span> submodule<br/></a><a href="performance.html#%28tech._major._collection%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">major collections</span><br/></a><a href="Emacs.html#%28part._.Major_.Modes%29" class="indexlink" data-pltdoc="x">Major Modes<br/></a><a href="mk-namespace.html" class="indexlink" data-pltdoc="x">Manipulating Namespaces<br/></a><a href="regexp-match.html" class="indexlink" data-pltdoc="x">Matching Regexp Patterns<br/></a><a href="pattern-macros.html#%28part._.Matching_.Sequences%29" class="indexlink" data-pltdoc="x">Matching Sequences<br/></a><a href="performance.html#%28part._gc-perf%29" class="indexlink" data-pltdoc="x">Memory Management<br/></a><a href="stx-phases.html#%28tech._meta._compile._phase._level%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">meta-compile phase level</span><br/></a><a href="regexp-intro.html#%28tech._metacharacter%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">metacharacters</span><br/></a><a href="regexp-intro.html#%28tech._metasequence%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">metasequences</span><br/></a><a href="classes.html#%28part._methods%29" class="indexlink" data-pltdoc="x">Methods<br/></a><a href="performance.html#%28tech._minor._collection%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">minor collections</span><br/></a><a href="Emacs.html#%28part._.Minor_.Modes%29" class="indexlink" data-pltdoc="x">Minor Modes<br/></a><a href="Vim.html#%28part._.Miscellaneous%29" class="indexlink" data-pltdoc="x">Miscellaneous<br/></a><a href="classes.html#%28tech._mixin%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">mixin</span><br/></a><a href="syntax-case.html" class="indexlink" data-pltdoc="x">Mixing Patterns and Expressions: <span class="RktSym"><span class="RktStxLink">syntax-case</span></span><br/></a><a href="contracts-gotchas.html#%28part._.Mixing_set__and_contract-out%29" class="indexlink" data-pltdoc="x">Mixing <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">contract-out</span></span><br/></a><a href="classes.html#%28part._.Mixins%29" class="indexlink" data-pltdoc="x">Mixins<br/></a><a href="classes.html#%28part._.Mixins_and_.Interfaces%29" class="indexlink" data-pltdoc="x">Mixins and Interfaces<br/></a><a href="module-basics.html" class="indexlink" data-pltdoc="x">Module Basics<br/></a><a href="macro-module.html" class="indexlink" data-pltdoc="x">Module Instantiations and Visits<br/></a><a href="module-languages.html#%28tech._module._language%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">module language</span><br/></a><a href="module-languages.html" class="indexlink" data-pltdoc="x">Module Languages<br/></a><a href="racket.html#%28part._start-module-mode%29" class="indexlink" data-pltdoc="x">Module Mode<br/></a><a href="module-paths.html#%28tech._module._path%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">module path</span><br/></a><a href="module-paths.html" class="indexlink" data-pltdoc="x">Module Paths<br/></a><a href="module-basics.html#%28part._intracollection%29" class="indexlink" data-pltdoc="x">Module References Within a Collection<br/></a><a href="Module_Syntax.html" class="indexlink" data-pltdoc="x">Module Syntax<br/></a><a href="module-runtime-config.html" class="indexlink" data-pltdoc="x">Module-Handling Configuration<br/></a><a href="modules.html" class="indexlink" data-pltdoc="x">Modules<br/></a><a href="module-macro.html" class="indexlink" data-pltdoc="x">Modules and Macros<br/></a><a href="performance.html#%28part._modules-performance%29" class="indexlink" data-pltdoc="x">Modules and Performance<br/></a><a href="More_Libraries.html" class="indexlink" data-pltdoc="x">More Libraries<br/></a><a href="more-hash-lang.html" class="indexlink" data-pltdoc="x">More Rackets<br/></a><a href="define-struct.html#%28part._struct-options%29" class="indexlink" data-pltdoc="x">More Structure Type Options<br/></a><a href="regexp-clusters.html#%28tech._multi._line._mode%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">multi-line mode</span><br/></a><a href="contracts-general-functions.html#%28part._contracts-multiple%29" class="indexlink" data-pltdoc="x">Multiple Result Values<br/></a><a href="define.html#%28part._multiple-values%29" class="indexlink" data-pltdoc="x">Multiple Values and <span class="RktSym"><span class="RktStxLink">define-values</span></span><br/></a><a href="let.html#%28part._.Multiple_.Values__let-values__let_-values__letrec-values%29" class="indexlink" data-pltdoc="x">Multiple Values: <span class="RktSym"><span class="RktStxLink">let-values</span></span>, <span class="RktSym"><span class="RktStxLink">let*-values</span></span>, <span class="RktSym"><span class="RktStxLink">letrec-values</span></span><br/></a><a href="set_.html#%28part._.Multiple_.Values__set_-values%29" class="indexlink" data-pltdoc="x">Multiple Values: <span class="RktSym"><span class="RktStxLink">set!-values</span></span><br/></a><a href="for.html#%28part._.Multiple-.Valued_.Sequences%29" class="indexlink" data-pltdoc="x">Multiple-Valued Sequences<br/></a><a href="pairs.html#%28tech._mutable._pair%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">mutable pair</span><br/></a><a href="performance.html#%28part._.Mutation_and_.Performance%29" class="indexlink" data-pltdoc="x">Mutation and Performance<br/></a><a href="define-struct.html#%28tech._mutator%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">mutator</span><br/></a><a name="alpha:N"></a><span><a href="let.html#%28part._.Named_let%29" class="indexlink" data-pltdoc="x">Named <span class="RktSym"><span class="RktStxLink">let</span></span><br/></a></span><a href="eval.html#%28tech._namespace%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">namespace</span><br/></a><a href="eval.html#%28part._namespaces%29" class="indexlink" data-pltdoc="x">Namespaces<br/></a><a href="eval.html#%28part._.Namespaces_and_.Modules%29" class="indexlink" data-pltdoc="x">Namespaces and Modules<br/></a><a href="regexp-clusters.html#%28tech._non._capturing%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">non-capturing</span><br/></a><a href="regexp-clusters.html#%28part._.Non-capturing_.Clusters%29" class="indexlink" data-pltdoc="x">Non-capturing Clusters<br/></a><a href="regexp-quant.html#%28tech._non._greedy%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">non-greedy</span><br/></a><a href="syntax-notation.html" class="indexlink" data-pltdoc="x">Notation<br/></a><a href="numbers.html#%28tech._number%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">number</span><br/></a><a href="numbers.html" class="indexlink" data-pltdoc="x">Numbers<br/></a><a name="alpha:O"></a><span><a href="define-struct.html#%28tech._opaque%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">opaque</span><br/></a></span><a href="define-struct.html#%28part._trans-struct%29" class="indexlink" data-pltdoc="x">Opaque versus Transparent Structure Types<br/></a><a href="contracts-general-functions.html#%28part._contracts-optional%29" class="indexlink" data-pltdoc="x">Optional Arguments<br/></a><a href="contracts-general-functions.html#%28part._contracts-optional-keywords%29" class="indexlink" data-pltdoc="x">Optional Keyword Arguments<br/></a><a href="module-basics.html#%28part._module-org%29" class="indexlink" data-pltdoc="x">Organizing Modules<br/></a><a name="alpha:P"></a><span><a href="module-basics.html#%28tech._package%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">package</span><br/></a></span><a href="module-basics.html#%28part._packages-and-collections%29" class="indexlink" data-pltdoc="x">Packages and Collections<br/></a><a href="Emacs.html#%28part._.Packages_specific_to_.Evil_.Mode%29" class="indexlink" data-pltdoc="x">Packages specific to Evil Mode<br/></a><a href="pairs.html#%28tech._pair%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">pair</span><br/></a><a href="pairs.html" class="indexlink" data-pltdoc="x">Pairs and Lists<br/></a><a href="Pairs__Lists__and_Racket_Syntax.html" class="indexlink" data-pltdoc="x">Pairs, Lists, and Racket Syntax<br/></a><a href="let.html#%28part._.Parallel_.Binding__let%29" class="indexlink" data-pltdoc="x">Parallel Binding: <span class="RktSym"><span class="RktStxLink">let</span></span><br/></a><a href="parallelism.html" class="indexlink" data-pltdoc="x">Parallelism<br/></a><a href="parallelism.html#%28tech._parallelism%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">parallelism</span><br/></a><a href="parallelism.html#%28part._effective-futures%29" class="indexlink" data-pltdoc="x">Parallelism with Futures<br/></a><a href="parallelism.html#%28part._effective-places%29" class="indexlink" data-pltdoc="x">Parallelism with Places<br/></a><a href="parameterize.html#%28tech._parameter%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">parameter</span><br/></a><a href="classes.html#%28part._parammixins%29" class="indexlink" data-pltdoc="x">Parameterized Mixins<br/></a><a href="match.html" class="indexlink" data-pltdoc="x">Pattern Matching<br/></a><a href="match.html#%28tech._pattern._variable%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">pattern variables</span><br/></a><a href="pattern-macros.html#%28tech._pattern._based._macro%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">pattern-based macro</span><br/></a><a href="pattern-macros.html" class="indexlink" data-pltdoc="x">Pattern-Based Macros<br/></a><a href="performance.html" class="indexlink" data-pltdoc="x">Performance<br/></a><a href="performance.html#%28part._.Dr.Racket-perf%29" class="indexlink" data-pltdoc="x">Performance in DrRacket<br/></a><a href="phases.html#%28tech._phase%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">phase</span><br/></a><a href="phases.html#%28tech._phase._level%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">phase level</span><br/></a><a href="stx-phases.html#%28tech._phase._level._1%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">phase level
+-1</span><br/></a><a href="stx-phases.html#%28tech._phase._level._2%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">phase level
+2</span><br/></a><a href="phases.html#%28part._.Phases_and_.Bindings%29" class="indexlink" data-pltdoc="x">Phases and Bindings<br/></a><a href="phases.html#%28part._.Phases_and_.Modules%29" class="indexlink" data-pltdoc="x">Phases and Modules<br/></a><a href="parallelism.html#%28tech._place%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">place</span><br/></a><a href="parallelism.html#%28tech._place._channel%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">place
+channel</span><br/></a><a href="Vim.html#%28part._vim-plugins%29" class="indexlink" data-pltdoc="x">Plugins<br/></a><a href="i_o.html#%28tech._port%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">port</span><br/></a><a href="regexp-chars.html#%28tech._posix._character._clas%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">POSIX character class</span><br/></a><a href="regexp-chars.html#%28part._.P.O.S.I.X_character_classes%29" class="indexlink" data-pltdoc="x">POSIX character classes<br/></a><a href="Lists__Iteration__and_Recursion.html#%28part._.Predefined_.List_.Loops%29" class="indexlink" data-pltdoc="x">Predefined List Loops<br/></a><a href="define-struct.html#%28tech._predicate%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">predicate</span><br/></a><a href="define-struct.html#%28tech._prefab%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">prefab</span><br/></a><a href="define-struct.html#%28part._prefab-struct%29" class="indexlink" data-pltdoc="x">Prefab Structure Types<br/></a><a href="define-struct.html" class="indexlink" data-pltdoc="x">Programmer-Defined Datatypes<br/></a><a href="prompt.html#%28tech._prompt%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">prompt</span><br/></a><a href="prompt.html#%28tech._prompt._tag%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">prompt tag</span><br/></a><a href="prompt.html" class="indexlink" data-pltdoc="x">Prompts and Aborts<br/></a><a href="define-struct.html#%28tech._property%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">property</span><br/></a><a href="protect-out.html#%28tech._protected%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">protected</span><br/></a><a href="protect-out.html" class="indexlink" data-pltdoc="x">Protected Exports<br/></a><a href="classes.html#%28idx._%28gentag._4._%28lib._scribblings%2Fguide%2Fguide..scrbl%29%29%29" class="indexlink" data-pltdoc="x">protected method<br/></a><a name="alpha:Q"></a><span><a href="regexp-quant.html" class="indexlink" data-pltdoc="x">Quantifiers<br/></a></span><a href="regexp-quant.html#%28tech._quantifier%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">quantifiers</span><br/></a><a href="qq.html" class="indexlink" data-pltdoc="x">Quasiquoting: <span class="RktSym"><span class="RktStxLink">quasiquote</span></span> and <span class="RktVal">&lsquo;</span><br/></a><a href="Pairs__Lists__and_Racket_Syntax.html#%28part._quoting-lists%29" class="indexlink" data-pltdoc="x">Quoting Pairs and Symbols with <span class="RktSym"><span class="RktStxLink">quote</span></span><br/></a><a href="quote.html" class="indexlink" data-pltdoc="x">Quoting: <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktVal">&rsquo;</span><br/></a><a name="alpha:R"></a><span><a href="standards.html#%28part._r5rs%29" class="indexlink" data-pltdoc="x">R<span style="vertical-align: super; font-size: 80%">5</span>RS<br/></a></span><a href="standards.html#%28part._.R6.R.S%29" class="indexlink" data-pltdoc="x">R<span style="vertical-align: super; font-size: 80%">6</span>RS<br/></a><a href="to-scheme.html" class="indexlink" data-pltdoc="x">Racket Essentials<br/></a><a href="performance.html#%28part._virtual-machines%29" class="indexlink" data-pltdoc="x">Racket Virtual Machine Implementations<br/></a><a href="contract-func.html#%28tech._range%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">range</span><br/></a><a href="numbers.html#%28tech._rational%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">rational</span><br/></a><a href="performance.html#%28part._.Reachability._and._.Garbage._.Collection%29" class="indexlink" data-pltdoc="x">Reachability and Garbage Collection<br/></a><a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._reader%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">reader</span><br/></a><a href="hash-reader.html" class="indexlink" data-pltdoc="x">Reader Extensions<br/></a><a href="read-write.html" class="indexlink" data-pltdoc="x">Reading and Writing Racket Data<br/></a><a href="hash-reader.html#%28tech._readtable%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">readtable</span><br/></a><a href="hash-reader.html#%28part._readtable%29" class="indexlink" data-pltdoc="x">Readtables<br/></a><a href="numbers.html#%28tech._real%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">real</span><br/></a><a href="Lists__Iteration__and_Recursion.html#%28part._.Recursion_versus_.Iteration%29" class="indexlink" data-pltdoc="x">Recursion versus Iteration<br/></a><a href="let.html#%28part._.Recursive_.Binding__letrec%29" class="indexlink" data-pltdoc="x">Recursive Binding: <span class="RktSym"><span class="RktStxLink">letrec</span></span><br/></a><a href="performance.html#%28part._.Reducing_.Garbage_.Collection_.Pauses%29" class="indexlink" data-pltdoc="x">Reducing Garbage Collection Pauses<br/></a><a href="reflection.html" class="indexlink" data-pltdoc="x">Reflection and Dynamic Evaluation<br/></a><a href="regexp.html#%28tech._regexp%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">regexp</span><br/></a><a href="performance.html#%28part._regexp-perf%29" class="indexlink" data-pltdoc="x">Regular Expression Performance<br/></a><a href="regexp.html" class="indexlink" data-pltdoc="x">Regular Expressions<br/></a><a href="intro.html#%28tech._repl%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">REPL</span><br/></a><a href="Vim.html#%28part._.R.E.P.Ls%29" class="indexlink" data-pltdoc="x">REPLs<br/></a><a href="lambda.html#%28tech._rest._argument%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">rest
+argument</span><br/></a><a href="contracts-general-functions.html#%28part._contracts-rest-args%29" class="indexlink" data-pltdoc="x">Rest Arguments<br/></a><a href="contract-func.html#%28part._contracts-own%29" class="indexlink" data-pltdoc="x">Rolling Your Own Contracts<br/></a><a href="module-runtime-config.html#%28tech._run._time._configuration%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">run-time configuration</span><br/></a><a href="running.html" class="indexlink" data-pltdoc="x">Running and Creating Executables<br/></a><a href="racket.html" class="indexlink" data-pltdoc="x">Running <span class="stt">racket</span> and <span class="stt">gracket</span><br/></a><a name="alpha:S"></a><span><a href="module-languages.html#%28idx._%28gentag._5._%28lib._scribblings%2Fguide%2Fguide..scrbl%29%29%29" class="indexlink" data-pltdoc="x">S-expression<br/></a></span><a href="Vim.html#%28part._.Scribble%29" class="indexlink" data-pltdoc="x">Scribble<br/></a><a href="load.html" class="indexlink" data-pltdoc="x">Scripting Evaluation and Using <span class="RktSym"><span class="RktValLink">load</span></span><br/></a><a href="scripts.html" class="indexlink" data-pltdoc="x">Scripts<br/></a><a href="concurrency.html#%28part._.Semaphores%29" class="indexlink" data-pltdoc="x">Semaphores<br/></a><a href="for.html#%28part._sequences%29" class="indexlink" data-pltdoc="x">Sequence Constructors<br/></a><a href="begin.html" class="indexlink" data-pltdoc="x">Sequencing<br/></a><a href="let.html#%28part._.Sequential_.Binding__let_%29" class="indexlink" data-pltdoc="x">Sequential Binding: <span class="RktSym"><span class="RktStxLink">let*</span></span><br/></a><a href="serialization.html#%28tech._serialization%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">serialization</span><br/></a><a href="pattern-macros.html#%28part._set__.Transformers%29" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">set!</span></span> Transformers<br/></a><a href="binding.html#%28tech._shadow%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">shadows</span><br/></a><a href="mk-namespace.html#%28part._.Sharing_.Data_and_.Code_.Across_.Namespaces%29" class="indexlink" data-pltdoc="x">Sharing Data and Code Across Namespaces<br/></a><a href="cmdline-tools.html#%28part._.Shell_completion%29" class="indexlink" data-pltdoc="x">Shell completion<br/></a><a href="Signatures_and_Units.html#%28tech._signature%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">signatures</span><br/></a><a href="Signatures_and_Units.html" class="indexlink" data-pltdoc="x">Signatures and Units<br/></a><a href="conditionals.html#%28part._.Simple_.Branching__if%29" class="indexlink" data-pltdoc="x">Simple Branching: <span class="RktSym"><span class="RktStxLink">if</span></span><br/></a><a href="contract-func.html" class="indexlink" data-pltdoc="x">Simple Contracts on Functions<br/></a><a href="syntax-overview.html" class="indexlink" data-pltdoc="x">Simple Definitions and Expressions<br/></a><a href="case.html" class="indexlink" data-pltdoc="x">Simple Dispatch: <span class="RktSym"><span class="RktStxLink">case</span></span><br/></a><a href="define-struct.html#%28part._.Simple_.Structure_.Types__struct%29" class="indexlink" data-pltdoc="x">Simple Structure Types: <span class="RktSym"><span class="RktStxLink">struct</span></span><br/></a><a href="Simple_Values.html" class="indexlink" data-pltdoc="x">Simple Values<br/></a><a href="regexp-chars.html#%28part._.Some_.Frequently_.Used_.Character_.Classes%29" class="indexlink" data-pltdoc="x">Some Frequently Used Character Classes<br/></a><a href="hash-reader.html#%28part._.Source_.Locations%29" class="indexlink" data-pltdoc="x">Source Locations<br/></a><a href="language-get-info.html" class="indexlink" data-pltdoc="x">Source-Handling Configuration<br/></a><a href="performance.html" class="indexlink" data-pltdoc="x">speed<br/></a><a href="standards.html" class="indexlink" data-pltdoc="x">Standards<br/></a><a href="strings.html#%28tech._string%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">string</span><br/></a><a href="strings.html" class="indexlink" data-pltdoc="x">Strings (Unicode)<br/></a><a href="define-struct.html#%28part._struct-equal%29" class="indexlink" data-pltdoc="x">Structure Comparisons<br/></a><a href="define-struct.html#%28part._struct-subtypes%29" class="indexlink" data-pltdoc="x">Structure Subtypes<br/></a><a href="define-struct.html#%28tech._structure._type._descriptor%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">structure type descriptor</span><br/></a><a href="define-struct.html#%28part._.Structure_.Type_.Generativity%29" class="indexlink" data-pltdoc="x">Structure Type Generativity<br/></a><a href="Vim.html#%28part._.Structured_.Editing%29" class="indexlink" data-pltdoc="x">Structured Editing<br/></a><a href="contract-func.html#%28part._.Styles_of_-_%29" class="indexlink" data-pltdoc="x">Styles of <span class="RktSym"><span class="RktStxLink"><span class="nobreak">-&gt;</span></span></span><br/></a><a href="regexp-clusters.html#%28tech._subcluster%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">subcluster</span><br/></a><a href="Sublime_Text.html" class="indexlink" data-pltdoc="x">Sublime Text<br/></a><a href="regexp-clusters.html#%28tech._submatch%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">submatch</span><br/></a><a href="Module_Syntax.html#%28tech._submodule%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">submodule</span><br/></a><a href="Module_Syntax.html#%28part._submodules%29" class="indexlink" data-pltdoc="x">Submodules<br/></a><a href="regexp-clusters.html#%28tech._subpattern%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">subpattern</span><br/></a><a href="symbols.html#%28tech._symbol%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">symbol</span><br/></a><a href="symbols.html" class="indexlink" data-pltdoc="x">Symbols<br/></a><a href="concurrency.html#%28part._.Synchronizable_.Events_and_sync%29" class="indexlink" data-pltdoc="x">Synchronizable Events and <span class="RktSym"><span class="RktValLink">sync</span></span><br/></a><a href="parallelism.html#%28tech._synchronized%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">synchronized</span><br/></a><a href="stx-obj.html" class="indexlink" data-pltdoc="x">Syntax Objects<br/></a><a href="stx-obj.html#%28tech._syntax._object%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">syntax objects</span><br/></a><a name="alpha:T"></a><span><a href="Lists__Iteration__and_Recursion.html#%28tech._tail._position%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">tail position</span><br/></a></span><a href="Lists__Iteration__and_Recursion.html#%28part._tail-recursion%29" class="indexlink" data-pltdoc="x">Tail Recursion<br/></a><a href="stx-certs.html#%28tech._tainted%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">tainted</span><br/></a><a href="stx-certs.html" class="indexlink" data-pltdoc="x">Tainted Syntax<br/></a><a href="teaching-langs.html" class="indexlink" data-pltdoc="x">Teaching<br/></a><a href="pattern-macros.html#%28tech._template%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">template</span><br/></a><a href="stx-phases.html#%28tech._template._phase._level%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">template phase level</span><br/></a><a href="regexp.html#%28tech._text._string%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">text string</span><br/></a><a href="Module_Syntax.html#%28part._hash-lang%29" class="indexlink" data-pltdoc="x">The <span class="RktMod">#lang</span> Shorthand<br/></a><a href="application.html#%28part._apply%29" class="indexlink" data-pltdoc="x">The <span class="RktSym"><span class="RktValLink">apply</span></span> Function<br/></a><a href="classes.html#%28part._.The_mixin_.Form%29" class="indexlink" data-pltdoc="x">The <span class="RktSym"><span class="RktStxLink">mixin</span></span> Form<br/></a><a href="Module_Syntax.html#%28part._module-syntax%29" class="indexlink" data-pltdoc="x">The <span class="RktSym"><span class="RktStxLink">module</span></span> Form<br/></a><a href="index.html" class="indexlink" data-pltdoc="x">The Racket Guide<br/></a><a href="classes.html#%28part._.The_trait_.Form%29" class="indexlink" data-pltdoc="x">The <span class="RktSym"><span class="RktStxLink">trait</span></span> Form<br/></a><a href="More_Libraries.html#%28part._.The_.Web_.Server%29" class="indexlink" data-pltdoc="x">The Web Server<br/></a><a href="concurrency.html#%28part._.Thread_.Mailboxes%29" class="indexlink" data-pltdoc="x">Thread Mailboxes<br/></a><a href="concurrency.html#%28part._.Threads%29" class="indexlink" data-pltdoc="x">Threads<br/></a><a href="concurrency.html#%28tech._thread%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">threads</span><br/></a><a href="classes.html#%28part._.Traits%29" class="indexlink" data-pltdoc="x">Traits<br/></a><a href="classes.html#%28part._.Traits_as_.Sets_of_.Mixins%29" class="indexlink" data-pltdoc="x">Traits as Sets of Mixins<br/></a><a href="macros.html#%28tech._transformer%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">transformer</span><br/></a><a href="proc-macros.html#%28tech._transformer._binding%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">transformer
+binding</span><br/></a><a href="define-struct.html#%28tech._transparent%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">transparent</span><br/></a><a name="alpha:U"></a><span><a href="performance.html#%28part._unchecked-unsafe%29" class="indexlink" data-pltdoc="x">Unchecked, Unsafe Operations<br/></a></span><a href="unit_versus_module.html" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unit</span></span> versus <span class="RktSym"><span class="RktStxLink">module</span></span><br/></a><a href="units.html#%28tech._unit%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">Units</span><br/></a><a href="units.html" class="indexlink" data-pltdoc="x">Units (Components)<br/></a><a href="scripts.html#%28part._.Unix_.Scripts%29" class="indexlink" data-pltdoc="x">Unix Scripts<br/></a><a href="hash-lang_reader.html" class="indexlink" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">reader</span></span><br/></a><a href="module-languages.html#%28part._s-exp%29" class="indexlink" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">s-exp</span></span><br/></a><a href="syntax_module-reader.html" class="indexlink" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">s-exp</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">syntax/module-reader</span></span><br/></a><a href="contract-func.html#%28part._simple-nested%29" class="indexlink" data-pltdoc="x">Using <span class="RktSym"><span class="RktStxLink">define/contract</span></span> and <span class="RktSym"><span class="RktStxLink"><span class="nobreak">-&gt;</span></span></span><br/></a><a href="More_Libraries.html#%28part._.Using_.Foreign_.Libraries%29" class="indexlink" data-pltdoc="x">Using Foreign Libraries<br/></a><a name="alpha:V"></a><span><a href="ports.html" class="indexlink" data-pltdoc="x">Varieties of Ports<br/></a></span><a href="vectors.html#%28tech._vector%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">vector</span><br/></a><a href="vectors.html" class="indexlink" data-pltdoc="x">Vectors<br/></a><a href="Vim.html" class="indexlink" data-pltdoc="x">Vim<br/></a><a href="macro-module.html#%28tech._visit%29" class="indexlink" data-pltdoc="x"><span style="font-style: italic">visit</span><br/></a><a href="macro-module.html#%28part._.Visiting_.Modules%29" class="indexlink" data-pltdoc="x">Visiting Modules<br/></a><a href="Visual_Studio_Code.html" class="indexlink" data-pltdoc="x">Visual Studio Code<br/></a><a href="void_undefined.html" class="indexlink" data-pltdoc="x">Void and Undefined<br/></a><a name="alpha:W"></a><span><a href="performance.html#%28part._.Weak_.Boxes_and_.Testing%29" class="indexlink" data-pltdoc="x">Weak Boxes and Testing<br/></a></span><a href="intro.html" class="indexlink" data-pltdoc="x">Welcome to Racket<br/></a><a href="Whole-module_Signatures_and_Units.html" class="indexlink" data-pltdoc="x">Whole-<span class="RktSym"><span class="RktStxLink">module</span></span> Signatures and Units<br/></a><a href="scripts.html#%28part._.Windows_.Batch_.Files%29" class="indexlink" data-pltdoc="x">Windows Batch Files<br/></a><a href="Building_New_Contracts.html#%28part._.With_all_the_.Bells_and_.Whistles%29" class="indexlink" data-pltdoc="x">With all the Bells and Whistles<br/></a><a href="with-syntax.html" class="indexlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-syntax</span></span> and <span class="RktSym"><span class="RktValLink">generate-temporaries</span></span><br/></a><a href="regexp-intro.html" class="indexlink" data-pltdoc="x">Writing Regexp Patterns<br/></a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="doc-bibliography.html" title="backward to &quot;Bibliography&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<span class="nonavigation">next &rarr;</span></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/encodings.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/encodings.html
new file mode 100644
index 00000000..f4f4fe66
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/encodings.html
@@ -0,0 +1,26 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>8.5&nbsp;Bytes, Characters, and Encodings</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Varieties of Ports</a></td></tr><tr><td align="right">8.2&nbsp;</td><td><a href="default-ports.html" class="tocviewlink" data-pltdoc="x">Default Ports</a></td></tr><tr><td align="right">8.3&nbsp;</td><td><a href="read-write.html" class="tocviewlink" data-pltdoc="x">Reading and Writing Racket Data</a></td></tr><tr><td align="right">8.4&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Datatypes and Serialization</a></td></tr><tr><td align="right">8.5&nbsp;</td><td><a href="encodings.html" class="tocviewselflink" data-pltdoc="x">Bytes, Characters, and Encodings</a></td></tr><tr><td align="right">8.6&nbsp;</td><td><a href="io-patterns.html" class="tocviewlink" data-pltdoc="x">I/<span class="mywbr"> &nbsp;</span>O Patterns</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="serialization.html" title="backward to &quot;8.4 Datatypes and Serialization&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="i_o.html" title="up to &quot;8 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="io-patterns.html" title="forward to &quot;8.6 I/O Patterns&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;encodings&quot;">8.5<tt>&nbsp;</tt><a name="(part._encodings)"></a>Bytes, Characters, and Encodings</h4><p>Functions like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-line%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-line</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span>,
+and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span> all work in terms of <a href="characters.html#%28tech._character%29" class="techoutside" data-pltdoc="x"><span class="techinside">characters</span></a> (which
+correspond to Unicode scalar values). Conceptually, they are
+implemented in terms of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-char%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-char</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Output.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write-char%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write-char</a></span>.</p><p>More primitively, ports read and write <a href="bytestrings.html#%28tech._byte%29" class="techoutside" data-pltdoc="x"><span class="techinside">bytes</span></a>, instead of
+<a href="characters.html#%28tech._character%29" class="techoutside" data-pltdoc="x"><span class="techinside">characters</span></a>. The functions <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-byte%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-byte</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Output.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write-byte%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write-byte</a></span> read and write raw bytes. Other functions, such as
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-bytes-line%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-bytes-line</a></span>, build on top of byte operations instead of
+character operations.</p><p>In fact, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-char%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-char</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Output.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write-char%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write-char</a></span> functions are
+conceptually implemented in terms of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-byte%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-byte</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Output.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write-byte%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write-byte</a></span>. When a single byte&rsquo;s value is less than 128, then
+it corresponds to an ASCII character. Any other byte is treated as
+part of a UTF-8 sequence, where UTF-8 is a particular standard way of
+encoding Unicode scalar values in bytes (which has the nice property
+that ASCII characters are encoded as themselves). Thus, a single
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-char%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-char</a></span> may call <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-byte%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-byte</a></span> multiple times, and a
+single <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Output.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write-char%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write-char</a></span> may generate multiple output bytes.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-char%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-char</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Output.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write-char%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write-char</a></span> operations
+<span class="emph">always</span> use a UTF-8 encoding. If you have a text stream that
+uses a different encoding, or if you want to generate a text stream in
+a different encoding, use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-lib.html%23%2528def._%2528%2528lib._racket%252Fport..rkt%2529._reencode-input-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">reencode-input-port</a></span> or
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-lib.html%23%2528def._%2528%2528lib._racket%252Fport..rkt%2529._reencode-output-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">reencode-output-port</a></span>. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-lib.html%23%2528def._%2528%2528lib._racket%252Fport..rkt%2529._reencode-input-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">reencode-input-port</a></span>
+function converts an input stream from an encoding that you specify
+into a UTF-8 stream; that way, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-char%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-char</a></span> sees UTF-8
+encodings, even though the original used a different encoding. Beware,
+however, that <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-byte%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-byte</a></span> also sees the re-encoded data,
+instead of the original byte stream.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="serialization.html" title="backward to &quot;8.4 Datatypes and Serialization&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="i_o.html" title="up to &quot;8 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="io-patterns.html" title="forward to &quot;8.6 I/O Patterns&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/eval.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/eval.html
new file mode 100644
index 00000000..8f7051f1
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/eval.html
@@ -0,0 +1,72 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15.1&nbsp;eval</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewselflink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="eval.html" class="tocviewselflink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eval</span></span></a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="mk-namespace.html" class="tocviewlink" data-pltdoc="x">Manipulating Namespaces</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="load.html" class="tocviewlink" data-pltdoc="x">Scripting Evaluation and Using <span class="RktSym"><span class="RktValLink">load</span></span></a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="code-inspectors_protect.html" class="tocviewlink" data-pltdoc="x">Code Inspectors for Trusted and Untrusted Code</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>15.1&nbsp;</td><td><a href="eval.html" class="tocviewselflink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eval</span></span></a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1.1&nbsp;</td><td><a href="eval.html#%28part._.Local_.Scopes%29" class="tocviewlink" data-pltdoc="x">Local Scopes</a></td></tr><tr><td align="right">15.1.2&nbsp;</td><td><a href="eval.html#%28part._namespaces%29" class="tocviewlink" data-pltdoc="x">Namespaces</a></td></tr><tr><td align="right">15.1.3&nbsp;</td><td><a href="eval.html#%28part._.Namespaces_and_.Modules%29" class="tocviewlink" data-pltdoc="x">Namespaces and Modules</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">15.1.1<tt>&nbsp;</tt></span><a href="eval.html#%28part._.Local_.Scopes%29" class="tocsubseclink" data-pltdoc="x">Local Scopes</a></td></tr><tr><td><span class="tocsublinknumber">15.1.2<tt>&nbsp;</tt></span><a href="eval.html#%28part._namespaces%29" class="tocsubseclink" data-pltdoc="x">Namespaces</a></td></tr><tr><td><span class="tocsublinknumber">15.1.3<tt>&nbsp;</tt></span><a href="eval.html#%28part._.Namespaces_and_.Modules%29" class="tocsubseclink" data-pltdoc="x">Namespaces and Modules</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="reflection.html" title="backward to &quot;15 Reflection and Dynamic Evaluation&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="reflection.html" title="up to &quot;15 Reflection and Dynamic Evaluation&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="mk-namespace.html" title="forward to &quot;15.2 Manipulating Namespaces&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;eval&quot;">15.1<tt>&nbsp;</tt><a name="(part._eval)"></a><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span></h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>This example will not work within a module or in DrRacket&rsquo;s definitions window,
+but it will work in the interactions window, for reasons that are
+explained by the end of <a href="eval.html#%28part._namespaces%29" data-pltdoc="x">Namespaces</a>.</p></blockquote></blockquote></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span> function takes a representation of an expression or definition
+(as a &ldquo;quoted&rdquo; form or <a href="stx-obj.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>) and evaluates it:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">+</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></blockquote><p>The power of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span> is that an expression can be
+constructed dynamically:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eval-formula</span><span class="hspace">&nbsp;</span><span class="RktSym">formula</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span><span class="hspace">&nbsp;</span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">let</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">[</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">[</span><span class="RktVal">y</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">]</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">,</span><span class="RktSym">formula</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">eval-formula</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">+</span><span class="hspace">&nbsp;</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktVal">y</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">eval-formula</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">+</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">*</span><span class="hspace">&nbsp;</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktVal">y</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">y</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">9</span></p></td></tr></table></blockquote><p>Of course, if we just wanted to evaluate expressions with given values
+for <span class="RktSym">x</span> and <span class="RktSym">y</span>, we do not need <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span>. A more
+direct approach is to use first-class functions:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">apply-formula</span><span class="hspace">&nbsp;</span><span class="RktSym">formula-proc</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">formula-proc</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">apply-formula</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">apply-formula</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">9</span></p></td></tr></table></blockquote><p>However, if expressions like <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktSym">x</span><span class="stt"> </span><span class="RktSym">y</span><span class="RktPn">)</span> and <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="stt"> </span><span class="RktSym">x</span><span class="stt"> </span><span class="RktSym">y</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym">y</span><span class="RktPn">)</span> are read from a file supplied by a user, for example, then
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span> might be appropriate. Similarly, the <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> reads
+expressions that are typed by a user and uses <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span> to
+evaluate them.</p><p>Also, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span> is often used directly or indirectly on whole
+modules. For example, a program might load a module on demand using
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Module_Names_and_Loading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._dynamic-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">dynamic-require</a></span>, which is essentially a wrapper around
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span> to dynamically load the module code.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Local_Scopes&quot;">15.1.1<tt>&nbsp;</tt><a name="(part._.Local_.Scopes)"></a>Local Scopes</h5><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span> function cannot see local bindings in the context
+where it is called. For example, calling <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span> inside an
+unquoted <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> form to evaluate a formula does not make values
+visible for <span class="RktSym">x</span> and <span class="RktSym">y</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">broken-eval-formula</span><span class="hspace">&nbsp;</span><span class="RktSym">formula</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span><span class="hspace">&nbsp;</span><span class="RktSym">formula</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">broken-eval-formula</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">+</span><span class="hspace">&nbsp;</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktVal">y</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">x: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span> function cannot see the <span class="RktSym">x</span> and <span class="RktSym">y</span>
+bindings precisely because it is a function, and Racket is a lexically
+scoped language. Imagine if <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span> were implemented as</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">eval-expanded</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">macro-expand</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>then at the point when <span class="RktSym">eval-expanded</span> is called, the most
+recent binding of <span class="RktSym">x</span> is to the expression to evaluate, not the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> binding in <span class="RktSym">broken-eval-formula</span>. Lexical scope
+prevents such confusing and fragile behavior, and consequently
+prevents <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span> from seeing local bindings in the context where
+it is called.</p><p>You might imagine that even though <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span> cannot see the local
+bindings in <span class="RktSym">broken-eval-formula</span>, there must actually be a
+data structure mapping <span class="RktSym">x</span> to <span class="RktVal">2</span> and <span class="RktSym">y</span> to
+<span class="RktVal">3</span>, and you would like a way to get that data structure. In
+fact, no such data structure exists; the compiler is free to replace
+every use of <span class="RktSym">x</span> with <span class="RktVal">2</span> at compile time, so that the
+local binding of <span class="RktSym">x</span> does not exist in any concrete sense at
+run-time. Even when variables cannot be eliminated by
+constant-folding, normally the names of the variables can be
+eliminated, and the data structures that hold local values do not
+resemble a mapping from names to values.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;namespaces&quot;">15.1.2<tt>&nbsp;</tt><a name="(part._namespaces)"></a>Namespaces</h5><p>Since <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span> cannot see the bindings from the context where it
+is called, another mechanism is needed to determine dynamically
+available bindings. A <a name="(tech._namespace)"></a><span style="font-style: italic">namespace</span> is a first-class value that
+encapsulates the bindings available for dynamic evaluation.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Informally, the term <span style="font-style: italic">namespace</span> is sometimes
+used interchangeably with <span style="font-style: italic">environment</span> or
+<span style="font-style: italic">scope</span>. In Racket, the term <span style="font-style: italic">namespace</span> has the
+more specific, dynamic meaning given above, and it should not be
+confused with static lexical concepts.</p></blockquote></blockquote></blockquote><p>Some functions, such as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span>, accept an optional namespace
+argument. More often, the namespace used by a dynamic operation is the
+<a name="(tech._current._namespace)"></a><span style="font-style: italic">current namespace</span> as determined by the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-namespace</a></span> <a href="parameterize.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a>.</p><p>When <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span> is used in a <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>, the current namespace is the one
+that the <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> uses for evaluating expressions. That&rsquo;s why the
+following interaction successfully accesses <span class="RktSym">x</span> via
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></blockquote><p>In contrast, try the following simple module and running it directly
+in DrRacket or supplying the file as a command-line argument to
+<span class="stt">racket</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">cons</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>This fails because the initial current namespace is empty. When you
+run <span class="stt">racket</span> in interactive mode (see
+<a href="racket.html#%28part._start-interactive-mode%29" data-pltdoc="x">Interactive Mode</a>), the initial namespace is
+initialized with the exports of the <span class="RktSym">racket</span> module, but when
+you run a module directly, the initial namespace starts empty.</p><p>In general, it&rsquo;s a bad idea to use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span> with whatever
+namespace happens to be installed. Instead, create a namespace
+explicitly and install it for the call to eval:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ns</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._make-base-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-base-namespace</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">cons</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym">ns</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">works</span></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._make-base-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-base-namespace</a></span> function creates a namespace that is
+initialized with the exports of <span class="RktSym">racket/base</span>. The later
+section <a href="mk-namespace.html" data-pltdoc="x">Manipulating Namespaces</a> provides more information on creating
+and configuring namespaces.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Namespaces_and_Modules&quot;">15.1.3<tt>&nbsp;</tt><a name="(part._.Namespaces_and_.Modules)"></a>Namespaces and Modules</h5><p>As with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> bindings, lexical scope means that <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span>
+cannot automatically see the definitions of a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> in which
+it is called. Unlike <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> bindings, however, Racket provides a
+way to reflect a module into a <a href="eval.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespace</span></a>.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._module-%7E3enamespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">module-&gt;namespace</a></span> function takes a quoted <a href="module-paths.html#%28tech._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">module
+path</span></a> and produces a namespace for evaluating expressions and
+definitions as if they appeared in the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> body:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">m</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ns</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._module-%7E3enamespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">module-&gt;namespace</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">m</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktSym">ns</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">11</span></p></td></tr></table></blockquote><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The double quoting in <span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">m</span> is because <span class="RktVal">'</span><span class="RktVal">m</span>
+is a module path that refers to an interactively declared module, and
+so <span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">m</span> is the quoted form of the path.</p></blockquote></blockquote></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._module-%7E3enamespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">module-&gt;namespace</a></span> function is mostly useful from outside
+a module, where the module&rsquo;s full name is known. Inside a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> form, however, the full name of a module may not be
+known, because it may depend on where the module source is located
+when it is eventually loaded.</p><p>From within a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span>, use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-namespace-anchor%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-namespace-anchor</a></span> to
+declare a reflection hook on the module, and use
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._namespace-anchor-%7E3enamespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">namespace-anchor-&gt;namespace</a></span> to reel in the module&rsquo;s
+namespace:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-namespace-anchor%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-namespace-anchor</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ns</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._namespace-anchor-%7E3enamespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">namespace-anchor-&gt;namespace</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">cons</span><span class="hspace">&nbsp;</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktVal">y</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym">ns</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">produces </span><span class="RktRes">(1<span class="stt"> </span>. 2)</span></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="reflection.html" title="backward to &quot;15 Reflection and Dynamic Evaluation&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="reflection.html" title="up to &quot;15 Reflection and Dynamic Evaluation&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="mk-namespace.html" title="forward to &quot;15.2 Manipulating Namespaces&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/exe.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/exe.html
new file mode 100644
index 00000000..21af7f3c
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/exe.html
@@ -0,0 +1,4 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>21.3&nbsp;Creating Stand-Alone Executables</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewselflink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">21.1&nbsp;</td><td><a href="racket.html" class="tocviewlink" data-pltdoc="x">Running <span class="stt">racket</span> and <span class="stt">gracket</span></a></td></tr><tr><td align="right">21.2&nbsp;</td><td><a href="scripts.html" class="tocviewlink" data-pltdoc="x">Scripts</a></td></tr><tr><td align="right">21.3&nbsp;</td><td><a href="exe.html" class="tocviewselflink" data-pltdoc="x">Creating Stand-<wbr></wbr>Alone Executables</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="scripts.html" title="backward to &quot;21.2 Scripts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;21 Running and Creating Executables&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="More_Libraries.html" title="forward to &quot;22 More Libraries&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;exe&quot;">21.3<tt>&nbsp;</tt><a name="(part._exe)"></a>Creating Stand-Alone Executables</h4><p>For information on creating and distributing executables, see
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=exe.html&amp;version=8.6" class="Sq" data-pltdoc="x"><span class="stt">raco exe</span>: Creating Stand-Alone Executables</a> and <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=exe-dist.html&amp;version=8.6" class="Sq" data-pltdoc="x"><span class="stt">raco distribute</span>: Sharing Stand-Alone Executables</a> in
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x"><span class="stt">raco</span>: Racket Command-Line Tools</a>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="scripts.html" title="backward to &quot;21.2 Scripts&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;21 Running and Creating Executables&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="More_Libraries.html" title="forward to &quot;22 More Libraries&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/exns.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/exns.html
new file mode 100644
index 00000000..63abd52b
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/exns.html
@@ -0,0 +1,30 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>10.1&nbsp;Exceptions</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewselflink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">10.1&nbsp;</td><td><a href="exns.html" class="tocviewselflink" data-pltdoc="x">Exceptions</a></td></tr><tr><td align="right">10.2&nbsp;</td><td><a href="prompt.html" class="tocviewlink" data-pltdoc="x">Prompts and Aborts</a></td></tr><tr><td align="right">10.3&nbsp;</td><td><a href="conts.html" class="tocviewlink" data-pltdoc="x">Continuations</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="control.html" title="backward to &quot;10 Exceptions and Control&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Exceptions and Control&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="prompt.html" title="forward to &quot;10.2 Prompts and Aborts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;exns&quot;">10.1<tt>&nbsp;</tt><a name="(part._exns)"></a>Exceptions</h4><p>Whenever a run-time error occurs, an <a name="(tech._exception)"></a><span style="font-style: italic">exception</span> is
+raised. Unless the exception is caught, then it is handled by printing
+a message associated with the exception, and then escaping from the
+computation.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">/: division by zero</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">car: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: pair?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 17</span></p></td></tr></table></blockquote><p>To catch an exception, use the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._with-handlers%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-handlers</a></span> form:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._with-handlers%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-handlers</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">predicate-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">handler-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote><p>Each <span class="RktVar">predicate-expr</span> in a handler determines a kind of
+exception that is caught by the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._with-handlers%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-handlers</a></span> form, and the
+value representing the exception is passed to the handler procedure
+produced by <span class="RktVar">handler-expr</span>.  The result of the
+<span class="RktVar">handler-expr</span> is the result of the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._with-handlers%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-handlers</a></span>
+expression.</p><p>For example, a divide-by-zero error raises an instance of the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._exn%7E3afail%7E3acontract%7E3adivide-by-zero%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn:fail:contract:divide-by-zero</a></span> structure type:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._with-handlers%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-handlers</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exn%7E3afail%7E3acontract%7E3adivide-by-zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn:fail:contract:divide-by-zero?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._exn%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">+inf.0</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._with-handlers%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-handlers</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exn%7E3afail%7E3acontract%7E3adivide-by-zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn:fail:contract:divide-by-zero?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._exn%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">+inf.0</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">car: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: pair?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 17</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">error</a></span> function is one way to raise your own exception. It
+packages an error message and other information into an
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._exn%7E3afail%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn:fail</a></span> structure:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"crash!"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">crash!</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._with-handlers%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-handlers</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exn%7E3afail%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn:fail?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._exn%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">air-bag</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"crash!"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'air-bag</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._exn%7E3afail%7E3acontract%7E3adivide-by-zero%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn:fail:contract:divide-by-zero</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._exn%7E3afail%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn:fail</a></span>
+structure types are sub-types of the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._exn%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn</a></span> structure
+type. Exceptions raised by core forms and functions always raise an
+instance of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._exn%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn</a></span> or one of its sub-types, but an exception
+does not have to be represented by a structure. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._raise%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise</a></span>
+function lets you raise any value as an exception:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._raise%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">uncaught exception: 2</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._with-handlers%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-handlers</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">two</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._raise%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'two</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._with-handlers%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-handlers</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">two</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">/: division by zero</span></p></td></tr></table></blockquote><p>Multiple <span class="RktVar">predicate-expr</span>s in a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._with-handlers%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-handlers</a></span> form
+let you handle different kinds of exceptions in different ways. The
+predicates are tried in order, and if none of them match, then the
+exception is propagated to enclosing contexts.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">always-fail</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._with-handlers%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-handlers</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._even%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">even?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">even</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._positive%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">positive?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">positive</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._raise%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">always-fail</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'even</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">always-fail</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'positive</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">always-fail</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-3</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">uncaught exception: -3</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._with-handlers%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-handlers</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._negative%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">negative?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">negative</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">always-fail</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-3</span></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'negative</span></p></td></tr></table></blockquote><p>Using <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">#t</span><span class="RktPn">)</span> as a predicate captures all exceptions, of course:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._with-handlers%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-handlers</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">oops</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'oops</span></p></td></tr></table></blockquote><p>Capturing all exceptions is usually a bad idea, however. If the user
+types Ctl-C in a terminal window or clicks the <span class="ssansserif">Stop</span> button
+in DrRacket to interrupt a computation, then normally the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._exn%7E3abreak%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn:break</a></span> exception should not be caught. To catch only
+exceptions that represent errors, use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exn%7E3afail%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn:fail?</a></span> as the
+predicate:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._with-handlers%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-handlers</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exn%7E3afail%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn:fail?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">oops</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'oops</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._with-handlers%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-handlers</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exn%7E3afail%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn:fail?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">oops</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._break-thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">break-thread</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-thread</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">simulate Ctl-C</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">user break</span></p></td></tr></table></blockquote><p><div class="SIntrapara">Exceptions carry information about the error that occurred. The
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exn-message%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn-message</a></span> accessor provides a descriptive message for the
+exception. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exn-continuation-marks%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn-continuation-marks</a></span> accessor provides
+information about the point where the exception was raised.
+</div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=contmarks.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._continuation-mark-set-%7E3econtext%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">continuation-mark-set-&gt;context</a></span> procedure provides best-effort structured backtrace information.</p></blockquote></blockquote></blockquote></div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._with-handlers%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-handlers</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exn%7E3afail%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn:fail?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._error-display-handler%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">error-display-handler</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exn-message%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exn-message</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktErr">car: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: pair?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 17</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">context...:</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">/home/scheme/pltbuild/racket/racket/collects/racket/private/more-scheme.rkt:148:2: call-with-break-parameterization</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">/home/scheme/pltbuild/racket/build/user/8.6/pkgs/sandbox-lib/racket/sandbox.rkt:921:7</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">/home/scheme/pltbuild/racket/build/user/8.6/pkgs/sandbox-lib/racket/sandbox.rkt:891:2: user-process</span></p></td></tr></table></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="control.html" title="backward to &quot;10 Exceptions and Control&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Exceptions and Control&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="prompt.html" title="forward to &quot;10.2 Prompts and Aborts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/figure.css b/clones/download.racket-lang.org/releases/8.6/doc/guide/figure.css
new file mode 100644
index 00000000..905d5b67
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/figure.css
@@ -0,0 +1,37 @@
+
+.Centertext {
+  text-align: center;
+  margin: 0 0 0 0;
+}
+
+.Figure, .FigureMulti, .FigureMultiWide, .Herefigure {
+  margin: 1em 0 1em 0;
+  border: 1px solid #1818FF;
+}
+
+.Figure, .FigureMulti, .Herefigure {
+  width: 100%;
+}
+
+.FigureMultiWide {
+  width: 125%;
+}
+
+.Centerfigure {
+  text-align: center;
+  margin: 0 0 0 0;
+}
+
+.Leftfigure {
+  text-align: left;
+  margin: 0 0 0 0;
+}
+
+.Rightfigure {
+  text-align: right;
+  margin: 0 0 0 0;
+}
+
+.FigureInside {
+  margin: 1em 1em 1em 1em;
+}
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/figure.js b/clones/download.racket-lang.org/releases/8.6/doc/guide/figure.js
new file mode 100644
index 00000000..b85af46c
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/figure.js
@@ -0,0 +1,27 @@
+
+AddOnLoad(function () {
+    /* Lift figure targets to the start of the figure's blockquote,
+       so that clicking on a target reference shows the figure
+       content, instead of scrolling the figure caption to the
+       top of the page. */
+    var targets = document.getElementsByTagName("a");
+    for (var i = 0; i < targets.length; i++) {
+        var a = targets[i];
+        var n = a.attributes["x-target-lift"];
+        if (n) {
+            var s = n.value;
+            var p = a.parentNode;
+            while (p && (p.className != s)) {
+                p = p.parentNode;
+            }
+            if (p) {
+                var cs = p.children;
+                a.parentNode.removeChild(a);
+                if (cs.length > 0)
+                    p.insertBefore(a, cs[0]);
+                else
+                    p.appendChild(a);
+            }
+        }
+    }
+});
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/finger.png b/clones/download.racket-lang.org/releases/8.6/doc/guide/finger.png
new file mode 100644
index 0000000000000000000000000000000000000000..af521e80ad42a9ae5407c620edc296e7c4bba598
GIT binary patch
literal 430
zcmV;f0a5;mP)<h;3K|Lk000e1NJLTq000;O000;W1^@s6;CDUv0004XNkl<Zc%1Fi
z&r6h16vpw-sHs^JZ440;{{a(MLIg!3wJ-#68?_JuS7OoDaMiD65EN4cE`*`Q6y?@U
zhz12MqNs)FriFr_WHdA_?lE2lXDV6+^M%9Zy}b86=RD_J>eTsH8vpRWL7c@7w$U2V
zgi@`8IW*&B=1?m>V;Oz8ig#GY1&kt(uaRJL+|!8fSVRHkJ&~^XDC0gRu!4Eqz@dty
zF5_O6gc~p!Nf9Mxd4uOT6++))|5)r5@Cfa=i3Q1`CbZ!=hVh`9z`<BIGnd1c5IBLm
zA@l-cxFuP$jkkC#*;i9wuiP{Egn@`6X0U+~JjI;U{C#PtA@BoRxP;SqiQBk_Rm@^Z
z#_#>8RzWV-*AXPoi+C>$z!PbFr~XFZC^~RnYUHzs60YM8UZEf3*hQz`yoc<V?&1Tc
zaX^~;hf*W2;G)#XA<5nz$)-xHf009r^muylQEFTzhtZ8AI2V=fNRyVwS~Y<>b^Zf>
Y0+i!VsAM9jdH?_b07*qoM6N<$g28abDF6Tf

literal 0
HcmV?d00001

diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/firstclassunits.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/firstclassunits.html
new file mode 100644
index 00000000..fb7c7adb
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/firstclassunits.html
@@ -0,0 +1,46 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14.4&nbsp;First-Class Units</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Signatures_and_Units.html" class="tocviewlink" data-pltdoc="x">Signatures and Units</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="Invoking_Units.html" class="tocviewlink" data-pltdoc="x">Invoking Units</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="Linking_Units.html" class="tocviewlink" data-pltdoc="x">Linking Units</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="firstclassunits.html" class="tocviewselflink" data-pltdoc="x">First-<wbr></wbr>Class Units</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="Whole-module_Signatures_and_Units.html" class="tocviewlink" data-pltdoc="x">Whole-<span class="RktSym"><span class="RktStxLink">module</span></span> Signatures and Units</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="Contracts_for_Units.html" class="tocviewlink" data-pltdoc="x">Contracts for Units</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="unit_versus_module.html" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unit</span></span> versus <span class="RktSym"><span class="RktStxLink">module</span></span></a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Linking_Units.html" title="backward to &quot;14.3 Linking Units&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="units.html" title="up to &quot;14 Units (Components)&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Whole-module_Signatures_and_Units.html" title="forward to &quot;14.5 Whole-module Signatures and Units&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;firstclassunits&quot;">14.4<tt>&nbsp;</tt><a name="(part._firstclassunits)"></a>First-Class Units</h4><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linkinference.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-unit</a></span> form combines <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> with a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unit</a></span> form, similar to the way that <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="stt"> </span><span class="RktSym">x</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span>  combines <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> followed by an identifier with an
+implicit <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span>.</p><p>Expanding the shorthand, the definition of <span class="RktSym">toy-store@</span> could
+almost be written as</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-store@</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unit</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._import%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">import</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-factory^</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._export%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-store^</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">inventory</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">store-color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">green</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>A difference between this expansion and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linkinference.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-unit</a></span> is that
+the imports and exports of <span class="RktSym">toy-store@</span> cannot be
+inferred. That is, besides combining <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unit</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linkinference.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-unit</a></span> attaches static information to the
+defined identifier so that its signature information is available
+statically to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linkinference.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-values%252Finvoke-unit%252Finfer%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values/invoke-unit/infer</a></span> and other
+forms.</p><p>Despite the drawback of losing static signature information,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unit</a></span> can be useful in combination with other forms that work
+with first-class values. For example, we could wrap a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unit</a></span>
+that creates a toy store in a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> to supply the store&rsquo;s
+color:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"toy-store-maker.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"toy-store-sig.rkt"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"toy-factory-sig.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-store@-maker</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">the-color</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unit</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._import%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">import</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-factory^</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._export%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-store^</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">inventory</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">store-color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">the-color</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">the rest is the same as before</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">maybe-repaint</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">toy-color</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">store-color</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">repaint</span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">store-color</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stock!</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">inventory</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">inventory</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym">maybe-repaint</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">build-toys</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-inventory</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">inventory</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-store@-maker</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>To invoke a unit created by <span class="RktSym">toy-store@-maker</span>, we must use
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=invokingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-values%252Finvoke-unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values/invoke-unit</a></span>, instead of the
+<span class="RktSym">/infer</span> variant:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"simple-factory-unit.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linkinference.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-values%252Finvoke-unit%252Finfer%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values/invoke-unit/infer</a></span><span class="hspace">&nbsp;</span><span class="RktSym">simple-factory@</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Factory started.</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"toy-store-maker.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=invokingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-values%252Finvoke-unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values/invoke-unit</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">toy-store@-maker</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">purple</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._import%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">import</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-factory^</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._export%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-store^</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">stock!</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">get-inventory</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(list (toy 'purple) (toy 'purple))</span></p></td></tr></table></blockquote><p>In the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=invokingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-values%252Finvoke-unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values/invoke-unit</a></span> form, the <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._import%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">import</a></span><span class="stt"> </span><span class="RktSym">toy-factory^</span><span class="RktPn">)</span> line takes bindings from the current context that match
+the names in <span class="RktSym">toy-factory^</span> (the ones that we created by
+invoking <span class="RktSym">simple-factory@</span>), and it supplies them as imports to
+<span class="RktSym">toy-store@</span>. The <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._export%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">export</a></span><span class="stt"> </span><span class="RktSym">toy-store^</span><span class="RktPn">)</span> clause indicates
+that the unit produced by <span class="RktSym">toy-store@-maker</span> will export
+<span class="RktSym">toy-store^</span>, and the names from that signature are defined
+after invoking the unit.</p><p>To link a unit from <span class="RktSym">toy-store@-maker</span>, we can use the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=compoundunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._compound-unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">compound-unit</a></span> form:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"store-specific-factory-unit.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">toy-store+factory@</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=compoundunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._compound-unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">compound-unit</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._import%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">import</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._export%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">export</a></span><span class="hspace">&nbsp;</span><span class="RktSym">TF</span><span class="hspace">&nbsp;</span><span class="RktSym">TS</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._link%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">link</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">TF</span><span class="hspace">&nbsp;</span><span class="RktSym">:</span><span class="hspace">&nbsp;</span><span class="RktSym">toy-factory^</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">store-specific-factory@</span><span class="hspace">&nbsp;</span><span class="RktSym">TS</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">TS</span><span class="hspace">&nbsp;</span><span class="RktSym">:</span><span class="hspace">&nbsp;</span><span class="RktSym">toy-store^</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">toy-store@</span><span class="hspace">&nbsp;</span><span class="RktSym">TF</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote><p>This <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=compoundunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._compound-unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">compound-unit</a></span> form packs a lot of information into one
+place. The left-hand-side <span class="RktSym">TF</span> and <span class="RktSym">TS</span> in the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._link%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">link</a></span> clause are binding identifiers. The identifier
+<span class="RktSym">TF</span> is essentially bound to the elements of
+<span class="RktSym">toy-factory^</span> as implemented by
+<span class="RktSym">store-specific-factory@</span>.  The identifier <span class="RktSym">TS</span> is
+similarly bound to the elements of <span class="RktSym">toy-store^</span> as implemented
+by <span class="RktSym">toy-store@</span>. Meanwhile, the elements bound to <span class="RktSym">TS</span>
+are supplied as imports for <span class="RktSym">store-specific-factory@</span>, since
+<span class="RktSym">TS</span> follows <span class="RktSym">store-specific-factory@</span>. The elements
+bound to <span class="RktSym">TF</span> are similarly supplied to
+<span class="RktSym">toy-store@</span>. Finally, <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._export%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">export</a></span><span class="stt"> </span><span class="RktSym">TF</span><span class="stt"> </span><span class="RktSym">TS</span><span class="RktPn">)</span> indicates that
+the elements bound to <span class="RktSym">TF</span> and <span class="RktSym">TS</span> are exported from
+the compound unit.</p><p>The above <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=compoundunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._compound-unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">compound-unit</a></span> form uses
+<span class="RktSym">store-specific-factory@</span> as a first-class unit, even though
+its information could be inferred. Every unit can be used as a
+first-class unit, in addition to its use in inference contexts. Also,
+various forms let a programmer bridge the gap between inferred and
+first-class worlds. For example, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linkinference.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._define-unit-binding%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-unit-binding</a></span> binds a
+new identifier to the unit produced by an arbitrary expression; it
+statically associates signature information to the identifier, and it
+dynamically checks the signatures against the first-class unit
+produced by the expression.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Linking_Units.html" title="backward to &quot;14.3 Linking Units&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="units.html" title="up to &quot;14 Units (Components)&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Whole-module_Signatures_and_Units.html" title="forward to &quot;14.5 Whole-module Signatures and Units&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/for.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/for.html
new file mode 100644
index 00000000..75692eca
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/for.html
@@ -0,0 +1,130 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>11&nbsp;Iterations and Comprehensions</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9660;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewselflink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>11&nbsp;</td><td><a href="for.html" class="tocviewselflink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">11.1&nbsp;</td><td><a href="for.html#%28part._sequences%29" class="tocviewlink" data-pltdoc="x">Sequence Constructors</a></td></tr><tr><td align="right">11.2&nbsp;</td><td><a href="for.html#%28part._for_and_for_%29" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for</span></span> and <span class="RktSym"><span class="RktStxLink">for*</span></span></a></td></tr><tr><td align="right">11.3&nbsp;</td><td><a href="for.html#%28part._for_list_and_for__list%29" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span> and <span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>list</span></span></a></td></tr><tr><td align="right">11.4&nbsp;</td><td><a href="for.html#%28part._for_vector_and_for__vector%29" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>vector</span></span> and <span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>vector</span></span></a></td></tr><tr><td align="right">11.5&nbsp;</td><td><a href="for.html#%28part._for_and_and_for_or%29" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>and</span></span> and <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>or</span></span></a></td></tr><tr><td align="right">11.6&nbsp;</td><td><a href="for.html#%28part._for_first_and_for_last%29" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>first</span></span> and <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>last</span></span></a></td></tr><tr><td align="right">11.7&nbsp;</td><td><a href="for.html#%28part._for%2Ffold%29" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>fold</span></span> and <span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>fold</span></span></a></td></tr><tr><td align="right">11.8&nbsp;</td><td><a href="for.html#%28part._.Multiple-.Valued_.Sequences%29" class="tocviewlink" data-pltdoc="x">Multiple-<wbr></wbr>Valued Sequences</a></td></tr><tr><td align="right">11.9&nbsp;</td><td><a href="for.html#%28part._.Breaking_an_.Iteration%29" class="tocviewlink" data-pltdoc="x">Breaking an Iteration</a></td></tr><tr><td align="right">11.10&nbsp;</td><td><a href="for.html#%28part._for-performance%29" class="tocviewlink" data-pltdoc="x">Iteration Performance</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">11.1<tt>&nbsp;</tt></span><a href="for.html#%28part._sequences%29" class="tocsubseclink" data-pltdoc="x">Sequence Constructors</a></td></tr><tr><td><span class="tocsublinknumber">11.2<tt>&nbsp;</tt></span><a href="for.html#%28part._for_and_for_%29" class="tocsubseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for</span></span> and <span class="RktSym"><span class="RktStxLink">for*</span></span></a></td></tr><tr><td><span class="tocsublinknumber">11.3<tt>&nbsp;</tt></span><a href="for.html#%28part._for_list_and_for__list%29" class="tocsubseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>list</span></span> and <span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>list</span></span></a></td></tr><tr><td><span class="tocsublinknumber">11.4<tt>&nbsp;</tt></span><a href="for.html#%28part._for_vector_and_for__vector%29" class="tocsubseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>vector</span></span> and <span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>vector</span></span></a></td></tr><tr><td><span class="tocsublinknumber">11.5<tt>&nbsp;</tt></span><a href="for.html#%28part._for_and_and_for_or%29" class="tocsubseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>and</span></span> and <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>or</span></span></a></td></tr><tr><td><span class="tocsublinknumber">11.6<tt>&nbsp;</tt></span><a href="for.html#%28part._for_first_and_for_last%29" class="tocsubseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>first</span></span> and <span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>last</span></span></a></td></tr><tr><td><span class="tocsublinknumber">11.7<tt>&nbsp;</tt></span><a href="for.html#%28part._for%2Ffold%29" class="tocsubseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">for/<span class="mywbr"> &nbsp;</span>fold</span></span> and <span class="RktSym"><span class="RktStxLink">for*/<span class="mywbr"> &nbsp;</span>fold</span></span></a></td></tr><tr><td><span class="tocsublinknumber">11.8<tt>&nbsp;</tt></span><a href="for.html#%28part._.Multiple-.Valued_.Sequences%29" class="tocsubseclink" data-pltdoc="x">Multiple-<wbr></wbr>Valued Sequences</a></td></tr><tr><td><span class="tocsublinknumber">11.9<tt>&nbsp;</tt></span><a href="for.html#%28part._.Breaking_an_.Iteration%29" class="tocsubseclink" data-pltdoc="x">Breaking an Iteration</a></td></tr><tr><td><span class="tocsublinknumber">11.10<tt>&nbsp;</tt></span><a href="for.html#%28part._for-performance%29" class="tocsubseclink" data-pltdoc="x">Iteration Performance</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="conts.html" title="backward to &quot;10.3 Continuations&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="match.html" title="forward to &quot;12 Pattern Matching&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;for&quot;">11<tt>&nbsp;</tt><a name="(part._for)"></a>Iterations and Comprehensions</h3><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> family of syntactic forms support iteration over
+<span style="font-style: italic">sequences</span>. Lists, vectors, strings, byte strings, input
+ports, and hash tables can all be used as sequences, and constructors
+like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span> offer even more kinds of sequences.</p><p>Variants of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> accumulate iteration results in different
+ways, but they all have the same syntactic shape. Simplifying for
+now, the syntax of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> is</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">sequence-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> loop iterates through the sequence produced by the
+<span class="RktVar">sequence-expr</span>. For each element of the sequence,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> binds the element to <span class="RktVar">id</span>, and then it evaluates
+the <span class="RktVar">body</span>s for side effects.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">123</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">"abc"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a..."</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">a...b...c...</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">0123</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span> variant of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> is more Racket-like. It
+accumulates <span class="RktVar">body</span> results into a list, instead of
+evaluating <span class="RktVar">body</span> only for side effects. In more
+technical terms, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span> implements a <span style="font-style: italic">list
+comprehension</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(1 4 9)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">"abc"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(#\a #\b #\c)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(0 1 2 3)</span></p></td></tr></table></blockquote></div></p><p>The full syntax of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> accommodates multiple sequences to
+iterate in parallel, and the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*</a></span> variant nests the
+iterations instead of running them in parallel. More variants of
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*</a></span> accumulate <span class="RktVar">body</span> results
+in different ways.  In all of these variants, predicates that prune
+iterations can be included along with bindings.</p><p>Before details on the variations of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span>, though, it&rsquo;s best to
+see the kinds of sequence generators that make interesting examples.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;sequences&quot;">11.1<tt>&nbsp;</tt><a name="(part._sequences)"></a>Sequence Constructors</h4><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span> function generates a sequence of numbers, given
+an optional starting number (which defaults to <span class="RktVal">0</span>), a number
+before which the sequence ends, and an optional step (which defaults
+to <span class="RktVal">1</span>). Using a non-negative integer <span class="RktVar">k</span> directly as
+a sequence is a shorthand for <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="stt"> </span><span class="RktVar">k</span><span class="RktPn">)</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">012</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">012</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">123</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">13</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">432</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">1/2</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">" ~a "</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut"></span><span class="hspace">&nbsp;</span><span class="RktOut">1</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktOut">3/2</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktOut">2</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktOut">5/2</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktOut">3</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktOut">7/2 </span></p></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-naturals%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-naturals</a></span> function is similar, except that the
+starting number must be an exact non-negative integer (which defaults
+to <span class="RktVal">0</span>), the step is always <span class="RktVal">1</span>, and there is no upper
+limit. A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> loop using just <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-naturals%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-naturals</a></span> will never
+terminate unless a body expression raises an exception or otherwise
+escapes.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-naturals%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-naturals</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"too much!"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">0123456789</span></p></td></tr><tr><td><p><span class="RktErr">too much!</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._stop-before%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">stop-before</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._stop-after%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">stop-after</a></span> functions construct
+a new sequence given a sequence and a predicate. The new sequence is
+like the given sequence, but truncated either immediately before or
+immediately after the first element for which the predicate returns
+true.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._stop-before%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">stop-before</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"abc def"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=characters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._char-whitespace%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">char-whitespace?</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">abc</span></p></td></tr></table></blockquote></div></p><p>Sequence constructors like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-list</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-vector%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-vector</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-string</a></span> simply make explicit the use of a list, vector, or
+string as a sequence. Along with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span>,
+these constructors raise an exception when given the
+wrong kind of value, and since they otherwise avoid a run-time
+dispatch to determine the sequence type, they enable more efficient
+code generation; see <a href="for.html#%28part._for-performance%29" data-pltdoc="x">Iteration Performance</a> for more information.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"abc"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">abc</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">in-string: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: string</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: '(1 2 3)</span></p></td></tr></table></blockquote></div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html&amp;version=8.6" class="Sq" data-pltdoc="x">Sequences</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on sequences.</p></blockquote></blockquote></blockquote><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;for_and_for_&quot;">11.2<tt>&nbsp;</tt><a name="(part._for_and_for_)"></a><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*</a></span></h4><p>A more complete syntax of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> is</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">clause</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">sequence-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktVar">boolean-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:unless</span><span class="hspace">&nbsp;</span><span class="RktVar">boolean-expr</span></td></tr></table></td></tr></table></blockquote></blockquote><p>When multiple <span class="RktPn">[</span><span class="RktVar">id</span><span class="stt"> </span><span class="RktVar">sequence-expr</span><span class="RktPn">]</span> clauses are provided
+in a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> form, the corresponding sequences are traversed in
+parallel:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Chapter ~a. ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">Chapter 1. Intro</span></p></td></tr><tr><td><p><span class="RktOut">Chapter 2. Details</span></p></td></tr><tr><td><p><span class="RktOut">Chapter 3. Conclusion</span></p></td></tr></table></td></tr></table></blockquote><p>With parallel sequences, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> expression stops iterating
+when any sequence ends. This behavior allows <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-naturals%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-naturals</a></span>,
+which creates an infinite sequence of numbers, to be used for
+indexing:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-naturals%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-naturals</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Chapter ~a. ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">Chapter 1. Intro</span></p></td></tr><tr><td><p><span class="RktOut">Chapter 2. Details</span></p></td></tr><tr><td><p><span class="RktOut">Chapter 3. Conclusion</span></p></td></tr></table></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*</a></span> form, which has the same syntax as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span>,
+nests multiple sequences instead of running them in parallel:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Guide"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Reference"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">Guide Intro</span></p></td></tr><tr><td><p><span class="RktOut">Guide Details</span></p></td></tr><tr><td><p><span class="RktOut">Guide Conclusion</span></p></td></tr><tr><td><p><span class="RktOut">Reference Intro</span></p></td></tr><tr><td><p><span class="RktOut">Reference Details</span></p></td></tr><tr><td><p><span class="RktOut">Reference Conclusion</span></p></td></tr></table></td></tr></table></blockquote><p>Thus, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*</a></span> is a shorthand for nested <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span>s in the
+same way that <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let*</a></span> is a shorthand for nested <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span>s.</p><p>The <span class="RktPn">#:when</span><span class="stt"> </span><span class="RktVar">boolean-expr</span> form of a <span class="RktVar">clause</span> is
+another shorthand. It allows the <span class="RktVar">body</span>s to evaluate only
+when the <span class="RktVar">boolean-expr</span> produces a true value:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Guide"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Reference"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">Guide Intro</span></p></td></tr><tr><td><p><span class="RktOut">Guide Conclusion</span></p></td></tr><tr><td><p><span class="RktOut">Reference Intro</span></p></td></tr><tr><td><p><span class="RktOut">Reference Conclusion</span></p></td></tr></table></td></tr></table></blockquote><p>A <span class="RktVar">boolean-expr</span> with <span class="RktPn">#:when</span> can refer to any of the
+preceding iteration bindings. In a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> form, this scoping
+makes sense only if the test is nested in the iteration of the
+preceding bindings; thus, bindings separated by <span class="RktPn">#:when</span> are
+mutually nested, instead of in parallel, even with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span>.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Guide"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Reference"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Notes"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktVal">"Notes"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-naturals%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-naturals</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Index"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">"Index"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a Chapter ~a. ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">Guide Chapter 1. Intro</span></p></td></tr><tr><td><p><span class="RktOut">Guide Chapter 2. Details</span></p></td></tr><tr><td><p><span class="RktOut">Guide Chapter 3. Conclusion</span></p></td></tr><tr><td><p><span class="RktOut">Reference Chapter 1. Intro</span></p></td></tr><tr><td><p><span class="RktOut">Reference Chapter 2. Details</span></p></td></tr><tr><td><p><span class="RktOut">Reference Chapter 3. Conclusion</span></p></td></tr></table></td></tr></table></blockquote><p>An <span class="RktPn">#:unless</span> clause is analogous to a <span class="RktPn">#:when</span> clause, but
+the <span class="RktVar">body</span>s evaluate only when the <span class="RktVar">boolean-expr</span>
+produces a false value.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;for_list_and_for__list&quot;">11.3<tt>&nbsp;</tt><a name="(part._for_list_and_for__list)"></a><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*/list</a></span></h4><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span> form, which has the same syntax as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span>,
+evaluates the <span class="RktVar">body</span>s to obtain values that go into a
+newly constructed list:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-naturals%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-naturals</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number-%7E3estring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">". "</span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("1. Intro" "2. Details" "3. Conclusion")</span></p></td></tr></table></blockquote><p>A <span class="RktPn">#:when</span> clause in a <span class="RktSym">for-list</span> form prunes the result
+list along with evaluations of the <span class="RktVar">body</span>s:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-naturals%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-naturals</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._odd%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">odd?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("Intro" "Conclusion")</span></p></td></tr></table></blockquote><p>This pruning behavior of <span class="RktPn">#:when</span> is more useful with
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span> than <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span>. Whereas a plain <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._when%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">when</a></span>
+form normally suffices with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span>, a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._when%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">when</a></span> expression
+form in a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span> would cause the result list to contain
+<a href="void_undefined.html" class="RktModLink" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>s instead of omitting list elements.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*/list</a></span> form is like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*</a></span>, nesting multiple
+iterations:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Guide"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Ref."</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktVal">" "</span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("Guide Intro" "Guide Details" "Ref. Intro" "Ref. Details")</span></p></td></tr></table></blockquote><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*/list</a></span> form is not quite the same thing as nested
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span> forms. Nested <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span>s would produce a
+list of lists, instead of one flattened list. Much like
+<span class="RktPn">#:when</span>, then, the nesting of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*/list</a></span> is more
+useful than the nesting of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*</a></span>.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;for_vector_and_for__vector&quot;">11.4<tt>&nbsp;</tt><a name="(part._for_vector_and_for__vector)"></a><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Fvector%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/vector</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%252Fvector%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*/vector</a></span></h4><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Fvector%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/vector</a></span> form can be used with the same syntax as the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span> form, but the evaluated <span class="RktVar">body</span>s go into a
+newly-constructed vector instead of a list:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Fvector%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/vector</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-naturals%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-naturals</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number-%7E3estring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">". "</span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'#("1. Intro" "2. Details" "3. Conclusion")</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%252Fvector%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*/vector</a></span> form behaves similarly, but the iterations are
+nested as in <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*</a></span>.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Fvector%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/vector</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%252Fvector%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*/vector</a></span> forms also allow the
+length of the vector to be constructed to be supplied in advance.  The
+resulting iteration can be performed more efficiently than plain
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Fvector%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/vector</a></span> or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%252Fvector%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*/vector</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">chapters</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Fvector%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/vector</a></span><span class="hspace">&nbsp;</span><span class="RktPn">#:length</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chapters</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-naturals%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-naturals</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktSym">chapters</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number-%7E3estring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">". "</span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'#("1. Intro" "2. Details" "3. Conclusion")</span></p></td></tr></table></blockquote><p>If a length is provided, the iteration stops when the vector is filled
+or the requested iterations are complete, whichever comes first.  If
+the provided length exceeds the requested number of iterations, then
+the remaining slots in the vector are initialized to the default
+argument of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=vectors.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-vector%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-vector</a></span>.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;for_and_and_for_or&quot;">11.5<tt>&nbsp;</tt><a name="(part._for_and_and_for_or)"></a><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Fand%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/and</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252For%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/or</a></span></h4><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Fand%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/and</a></span> form combines iteration results with
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span>, stopping as soon as it encounters <span class="RktVal">#f</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Fand%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">"Intro"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252For%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/or</a></span> form combines iteration results with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span>,
+stopping as soon as it encounters a true value:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252For%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">"Intro"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote><p>As usual, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%252Fand%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*/and</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%252For%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*/or</a></span> forms provide the
+same facility with nested iterations.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;for_first_and_for_last&quot;">11.6<tt>&nbsp;</tt><a name="(part._for_first_and_for_last)"></a><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Ffirst%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/first</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flast%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/last</a></span></h4><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Ffirst%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/first</a></span> form returns the result of the first time that
+the <span class="RktVar">body</span>s are evaluated, skipping further iterations.
+This form is most useful with a <span class="RktPn">#:when</span> clause.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Ffirst%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/first</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Index"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">"Intro"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"Details"</span></p></td></tr></table></blockquote><p>If the <span class="RktVar">body</span>s are evaluated zero times, then the result
+is <span class="RktVal">#f</span>.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flast%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/last</a></span> form runs all iterations, returning the value of
+the last iteration (or <span class="RktVal">#f</span> if no iterations are run):</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flast%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/last</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Index"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">"Index"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"Conclusion"</span></p></td></tr></table></blockquote><p>As usual, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%252Ffirst%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*/first</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%252Flast%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*/last</a></span> forms provide
+the same facility with nested iterations:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%252Ffirst%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*/first</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Guide"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Reference"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Index"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">"Intro"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("Guide" "Details")</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%252Flast%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*/last</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Guide"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Reference"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Index"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">"Index"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("Reference" "Conclusion")</span></p></td></tr></table></blockquote><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;for/fold&quot;">11.7<tt>&nbsp;</tt><a name="(part._for/fold)"></a><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Ffold%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/fold</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%252Ffold%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*/fold</a></span></h4><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Ffold%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/fold</a></span> form is a very general way to combine iteration
+results. Its syntax is slightly different than the syntax of
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span>, because accumulation variables must be declared at the
+beginning:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Ffold%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/fold</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">accum-id</span><span class="hspace">&nbsp;</span><span class="RktVar">init-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">clause</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktSym">...+</span><span class="RktPn">)</span></td></tr></table></blockquote><p>In the simple case, only one <span class="RktPn">[</span><span class="RktVar">accum-id</span><span class="stt"> </span><span class="RktVar">init-expr</span><span class="RktPn">]</span> is
+provided, and the result of the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Ffold%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/fold</a></span> is the final value
+for <span class="RktVar">accum-id</span>, which starts out with the value of
+<span class="RktVar">init-expr</span>. In the <span class="RktVar">clause</span>s and
+<span class="RktVar">body</span>s, <span class="RktVar">accum-id</span> can be referenced to get its
+current value, and the last <span class="RktVar">body</span> provides the value of
+<span class="RktVar">accum-id</span> for the next iteration.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Ffold%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/fold</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">len</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">len</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">15</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Ffold%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/fold</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">prev</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-naturals%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-naturals</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktSym">prev</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a. ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">1. Intro</span></p></td></tr><tr><td><p><span class="RktOut">2. Details</span></p></td></tr><tr><td><p><span class="RktOut">4. Conclusion</span></p></td></tr></table></td></tr><tr><td><p><span class="RktRes">"Conclusion"</span></p></td></tr></table></blockquote></div></p><p>When multiple <span class="RktVar">accum-id</span>s are specified, then the last
+<span class="RktVar">body</span> must produce multiple values, one for each
+<span class="RktVar">accum-id</span>. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Ffold%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/fold</a></span> expression itself produces
+multiple values for the results.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Ffold%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/fold</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">prev</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">counter</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktSym">prev</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a. ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">counter</span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._add1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">counter</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">1. Intro</span></p></td></tr><tr><td><p><span class="RktOut">2. Details</span></p></td></tr><tr><td><p><span class="RktOut">3. Conclusion</span></p></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">"Conclusion"</span></p></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr></table></td></tr></table></blockquote></div></p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Multiple-Valued_Sequences&quot;">11.8<tt>&nbsp;</tt><a name="(part._.Multiple-.Valued_.Sequences)"></a>Multiple-Valued Sequences</h4><p>In the same way that a function or expression can produce multiple
+values, individual iterations of a sequence can produce multiple
+elements.  For example, a hash table as a sequence generates two
+values for each iteration: a key and a value.</p><p>In the same way that <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._let-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let-values</a></span> binds multiple results to
+multiple identifiers, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> can bind multiple sequence elements
+to multiple iteration identifiers:</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>While <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> must be changed to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._let-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let-values</a></span>
+to bind multiple identifiers, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> simply allows a
+parenthesized list of identifiers instead of a single
+identifier in any clause.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">"banana"</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a count: ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">apple count: 1</span></p></td></tr><tr><td><p><span class="RktOut">banana count: 3</span></p></td></tr></table></td></tr></table></blockquote><p>This extension to multiple-value bindings works for all <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span>
+variants. For example, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*/list</a></span> nests iterations, builds a
+list, and also works with multiple-valued sequences:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">k</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">"banana"</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">k</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("apple" "banana" "banana" "banana")</span></p></td></tr></table></blockquote><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Breaking_an_Iteration&quot;">11.9<tt>&nbsp;</tt><a name="(part._.Breaking_an_.Iteration)"></a>Breaking an Iteration</h4><p>An even more complete syntax of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> is</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">clause</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body-or-break</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">clause</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">sequence-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktVar">boolean-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:unless</span><span class="hspace">&nbsp;</span><span class="RktVar">boolean-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">break</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">body-or-break</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">body</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">break</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">break</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:break</span><span class="hspace">&nbsp;</span><span class="RktVar">boolean-expr</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">#:final</span><span class="hspace">&nbsp;</span><span class="RktVar">boolean-expr</span></td></tr></table></td></tr></table></blockquote></blockquote><p>That is, a <span class="RktPn">#:break</span> or <span class="RktPn">#:final</span> clause can
+be included among the binding clauses and body of the iteration. Among
+the binding clauses, <span class="RktPn">#:break</span> is like <span class="RktPn">#:unless</span>
+but when its <span class="RktVar">boolean-expr</span> is true, all sequences within the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> are stopped. Among the <span class="RktVar">body</span>s,
+<span class="RktPn">#:break</span> has the same effect on sequences when its
+<span class="RktVar">boolean-expr</span> is true, and it also prevents later
+<span class="RktVar">body</span>s from evaluation in the current iteration.</p><p>For example, while using <span class="RktPn">#:unless</span> between clauses effectively
+skips later sequences as well as the body,</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Guide"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Story"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Reference"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:unless</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktVal">"Story"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">Guide Intro</span></p></td></tr><tr><td><p><span class="RktOut">Guide Details</span></p></td></tr><tr><td><p><span class="RktOut">Guide Conclusion</span></p></td></tr><tr><td><p><span class="RktOut">Reference Intro</span></p></td></tr><tr><td><p><span class="RktOut">Reference Details</span></p></td></tr><tr><td><p><span class="RktOut">Reference Conclusion</span></p></td></tr></table></td></tr></table></blockquote><p>using <span class="RktPn">#:break</span> causes the entire <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> iteration
+to terminate:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Guide"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Story"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Reference"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:break</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktVal">"Story"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">Guide Intro</span></p></td></tr><tr><td><p><span class="RktOut">Guide Details</span></p></td></tr><tr><td><p><span class="RktOut">Guide Conclusion</span></p></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Guide"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Story"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Reference"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:break</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktVal">"Story"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">Guide Intro</span></p></td></tr><tr><td><p><span class="RktOut">Guide Details</span></p></td></tr><tr><td><p><span class="RktOut">Guide Conclusion</span></p></td></tr><tr><td><p><span class="RktOut">Story Intro</span></p></td></tr><tr><td><p><span class="RktOut">Story Details</span></p></td></tr></table></td></tr></table></blockquote><p>A <span class="RktPn">#:final</span> clause is similar to <span class="RktPn">#:break</span>,
+but it does not immediately terminate the iteration. Instead, it
+allows at most one more element to be drawn for each sequence and at
+most one more evaluation of the <span class="RktVar">body</span>s.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Guide"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Story"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Reference"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:final</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktVal">"Story"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">Guide Intro</span></p></td></tr><tr><td><p><span class="RktOut">Guide Details</span></p></td></tr><tr><td><p><span class="RktOut">Guide Conclusion</span></p></td></tr><tr><td><p><span class="RktOut">Story Intro</span></p></td></tr><tr><td><p><span class="RktOut">Story Details</span></p></td></tr><tr><td><p><span class="RktOut">Story Conclusion</span></p></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Guide"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Story"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Reference"</span><span class="RktVal">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:final</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktVal">"Story"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">chapter</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Intro"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Details"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Conclusion"</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">book</span><span class="hspace">&nbsp;</span><span class="RktSym">chapter</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">Guide Intro</span></p></td></tr><tr><td><p><span class="RktOut">Guide Details</span></p></td></tr><tr><td><p><span class="RktOut">Guide Conclusion</span></p></td></tr><tr><td><p><span class="RktOut">Story Intro</span></p></td></tr></table></td></tr></table></blockquote><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;for-performance&quot;">11.10<tt>&nbsp;</tt><a name="(part._for-performance)"></a>Iteration Performance</h4><p>Ideally, a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> iteration should run as fast as a loop that
+you write by hand as a recursive-function invocation. A hand-written
+loop, however, is normally specific to a particular kind of data, such
+as lists. In that case, the hand-written loop uses selectors like
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span> directly, instead of handling all forms
+of sequences and dispatching to an appropriate iterator.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> forms can provide the performance of hand-written
+loops when enough information is apparent about the sequences to
+iterate. Specifically, the clause should have one of the following
+<span class="RktVar">fast-clause</span> forms:</p><p><table cellspacing="0" cellpadding="0"><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fast-clause</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">fast-seq</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">fast-seq</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">fast-indexed-seq</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">fast-parallel-seq</span><span class="RktPn">]</span></td></tr></table></p><p><table cellspacing="0" cellpadding="0"><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fast-seq</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-inclusive-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-inclusive-range</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-inclusive-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-inclusive-range</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-naturals%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-naturals</a></span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-naturals%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-naturals</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-list</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-mlist%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-mlist</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-vector%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-vector</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-string</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-bytes%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-bytes</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-value%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-value</a></span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._stop-before%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">stop-before</a></span><span class="hspace">&nbsp;</span><span class="RktVar">fast-seq</span><span class="hspace">&nbsp;</span><span class="RktVar">predicate-expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._stop-after%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">stop-after</a></span><span class="hspace">&nbsp;</span><span class="RktVar">fast-seq</span><span class="hspace">&nbsp;</span><span class="RktVar">predicate-expr</span><span class="RktPn">)</span></td></tr></table></p><p><table cellspacing="0" cellpadding="0"><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fast-indexed-seq</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-indexed%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-indexed</a></span><span class="hspace">&nbsp;</span><span class="RktVar">fast-seq</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._stop-before%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">stop-before</a></span><span class="hspace">&nbsp;</span><span class="RktVar">fast-indexed-seq</span><span class="hspace">&nbsp;</span><span class="RktVar">predicate-expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._stop-after%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">stop-after</a></span><span class="hspace">&nbsp;</span><span class="RktVar">fast-indexed-seq</span><span class="hspace">&nbsp;</span><span class="RktVar">predicate-expr</span><span class="RktPn">)</span></td></tr></table></p><p><table cellspacing="0" cellpadding="0"><tr><td align="right" valign="baseline"><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">fast-parallel-seq</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-parallel%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-parallel</a></span><span class="hspace">&nbsp;</span><span class="RktVar">fast-seq</span><span class="hspace">&nbsp;</span><span class="RktSym">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._stop-before%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">stop-before</a></span><span class="hspace">&nbsp;</span><span class="RktVar">fast-parallel-seq</span><span class="hspace">&nbsp;</span><span class="RktVar">predicate-expr</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._stop-after%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">stop-after</a></span><span class="hspace">&nbsp;</span><span class="RktVar">fast-parallel-seq</span><span class="hspace">&nbsp;</span><span class="RktVar">predicate-expr</span><span class="RktPn">)</span></td></tr></table></p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._time%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">time</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">100000</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">elem</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">c</span><span class="hspace">&nbsp;</span><span class="RktVal">d</span><span class="hspace">&nbsp;</span><span class="RktVal">e</span><span class="hspace">&nbsp;</span><span class="RktVal">f</span><span class="hspace">&nbsp;</span><span class="RktVal">g</span><span class="hspace">&nbsp;</span><span class="RktVal">h</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">fast</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">cpu time: 7 real time: 3 gc time: 0</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._time%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">time</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">100000</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">elem</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">c</span><span class="hspace">&nbsp;</span><span class="RktVal">d</span><span class="hspace">&nbsp;</span><span class="RktVal">e</span><span class="hspace">&nbsp;</span><span class="RktVal">f</span><span class="hspace">&nbsp;</span><span class="RktVal">g</span><span class="hspace">&nbsp;</span><span class="RktVal">h</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">slower</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">cpu time: 7 real time: 3 gc time: 0</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._time%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">time</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">seq</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktVal">c</span><span class="hspace">&nbsp;</span><span class="RktVal">d</span><span class="hspace">&nbsp;</span><span class="RktVal">e</span><span class="hspace">&nbsp;</span><span class="RktVal">f</span><span class="hspace">&nbsp;</span><span class="RktVal">g</span><span class="hspace">&nbsp;</span><span class="RktVal">h</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">100000</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">elem</span><span class="hspace">&nbsp;</span><span class="RktSym">seq</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">slower</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">cpu time: 45 real time: 23 gc time: 0</span></p></td></tr></table></blockquote></div></p><p>The grammars above are not complete, because the set of syntactic
+patterns that provide good performance is extensible, just like the
+set of sequence values. The documentation for a sequence constructor
+should indicate the performance benefits of using it directly in
+a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> <span class="RktVar">clause</span>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html&amp;version=8.6" class="Sq" data-pltdoc="x">Iterations and Comprehensions: <span class="RktSym"><span class="RktStxLink">for</span></span>, <span class="RktSym"><span class="RktStxLink">for/list</span></span>, ...</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on iterations and comprehensions.</p></blockquote></blockquote></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="conts.html" title="backward to &quot;10.3 Continuations&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="match.html" title="forward to &quot;12 Pattern Matching&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/hash-lang_reader.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/hash-lang_reader.html
new file mode 100644
index 00000000..75c9f0ff
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/hash-lang_reader.html
@@ -0,0 +1,23 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>17.3.2&nbsp;Using #lang reader</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewselflink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">17.1&nbsp;</td><td><a href="module-languages.html" class="tocviewlink" data-pltdoc="x">Module Languages</a></td></tr><tr><td align="right">17.2&nbsp;</td><td><a href="hash-reader.html" class="tocviewlink" data-pltdoc="x">Reader Extensions</a></td></tr><tr><td align="right">17.3&nbsp;</td><td><a href="hash-languages.html" class="tocviewselflink" data-pltdoc="x">Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>17.3&nbsp;</td><td><a href="hash-languages.html" class="tocviewlink" data-pltdoc="x">Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">17.3.1&nbsp;</td><td><a href="hash-lang_syntax.html" class="tocviewlink" data-pltdoc="x">Designating a <span class="RktModLink"><span class="RktMod">#lang</span></span> Language</a></td></tr><tr><td align="right">17.3.2&nbsp;</td><td><a href="hash-lang_reader.html" class="tocviewselflink" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">reader</span></span></a></td></tr><tr><td align="right">17.3.3&nbsp;</td><td><a href="syntax_module-reader.html" class="tocviewlink" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">s-<wbr></wbr>exp</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">syntax/<span class="mywbr"> &nbsp;</span>module-<wbr></wbr>reader</span></span></a></td></tr><tr><td align="right">17.3.4&nbsp;</td><td><a href="language-collection.html" class="tocviewlink" data-pltdoc="x">Installing a Language</a></td></tr><tr><td align="right">17.3.5&nbsp;</td><td><a href="language-get-info.html" class="tocviewlink" data-pltdoc="x">Source-<wbr></wbr>Handling Configuration</a></td></tr><tr><td align="right">17.3.6&nbsp;</td><td><a href="module-runtime-config.html" class="tocviewlink" data-pltdoc="x">Module-<wbr></wbr>Handling Configuration</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="hash-lang_syntax.html" title="backward to &quot;17.3.1 Designating a #lang Language&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="hash-languages.html" title="up to &quot;17.3 Defining new #lang Languages&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="syntax_module-reader.html" title="forward to &quot;17.3.3 Using #lang s-exp syntax/module-reader&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;hash-lang reader&quot;">17.3.2<tt>&nbsp;</tt><a name="(part._hash-lang._reader)"></a>Using <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="stt"> </span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._reader%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">reader</span></a></h5><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._reader%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">reader</span></a> language for <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> is similar to
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._s-exp%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">s-exp</span></a>, in that it acts as a kind of meta-language.
+Whereas <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._s-exp%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">s-exp</span></a> lets a programmer specify a <a href="module-languages.html#%28tech._module._language%29" class="techoutside" data-pltdoc="x"><span class="techinside">module
+language</span></a> at the <a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._expander%29" class="techoutside" data-pltdoc="x"><span class="techinside">expander</span></a> layer of parsing,
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._reader%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">reader</span></a> lets a programmer specify a language at the
+<a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._reader%29" class="techoutside" data-pltdoc="x"><span class="techinside">reader</span></a> level.</p><p>A <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="stt"> </span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._reader%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">reader</span></a> must be followed by
+a module path, and the specified module must provide two functions:
+<span class="RktSym">read</span> and <span class="RktSym">read-syntax</span>. The protocol is
+the same as for a <span class="RktMeta">#reader</span> implementation, but for
+<a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a>, the <span class="RktSym">read</span> and <span class="RktSym">read-syntax</span>
+functions must produce a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> form that is based on the
+rest of the input file for the module.</p><p>The following <span class="stt">"literal.rkt"</span> module implements a language that
+treats its entire body as literal text and exports the text as a
+<span class="RktSym">data</span> string:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"literal.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">syntax/strip-context</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._rename-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">rename-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">literal-read</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">literal-read-syntax</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-syntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-syntax</a></span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">literal-read</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-%7E3edatum%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-&gt;datum</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">literal-read-syntax</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">literal-read-syntax</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._with-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">str</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">port-&gt;string</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=syntax-helpers.html%23%2528def._%2528%2528lib._syntax%252Fstrip-context..rkt%2529._strip-context%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">strip-context</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">anything</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">data</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">data</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">str</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>The <span class="stt">"literal.rkt"</span> language uses <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=syntax-helpers.html%23%2528def._%2528%2528lib._syntax%252Fstrip-context..rkt%2529._strip-context%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">strip-context</a></span> on the
+generated <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> expression, because a
+<span class="RktSym">read-syntax</span> function should return a syntax object with
+no lexical context. Also, the <span class="stt">"literal.rkt"</span> language creates
+a module named <span class="RktSym">anything</span>, which is an arbitrary choice;
+the language is intended to be used in a file, and the longhand module
+name is ignored when it appears in a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>d file.</p><p>The <span class="stt">"literal.rkt"</span> language can be used in a module
+<span class="stt">"tuvalu.rkt"</span>:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"tuvalu.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._reader%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">reader</span></a><span class="hspace">&nbsp;</span><span class="RktVal">"literal.rkt"</span></td></tr><tr><td><span class="RktSym">Technology!</span></td></tr><tr><td><span class="RktSym">System!</span></td></tr><tr><td><span class="RktSym">Perfect!</span></td></tr></table></blockquote></blockquote></blockquote><p>Importing <span class="stt">"tuvalu.rkt"</span> binds <span class="RktSym">data</span> to a
+string version of the module content:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"tuvalu.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">data</span></td></tr><tr><td><p><span class="RktRes">"\nTechnology!\nSystem!\nPerfect!\n"</span></p></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="hash-lang_syntax.html" title="backward to &quot;17.3.1 Designating a #lang Language&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="hash-languages.html" title="up to &quot;17.3 Defining new #lang Languages&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="syntax_module-reader.html" title="forward to &quot;17.3.3 Using #lang s-exp syntax/module-reader&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/hash-lang_syntax.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/hash-lang_syntax.html
new file mode 100644
index 00000000..40033cd0
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/hash-lang_syntax.html
@@ -0,0 +1,43 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>17.3.1&nbsp;Designating a #lang Language</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewselflink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">17.1&nbsp;</td><td><a href="module-languages.html" class="tocviewlink" data-pltdoc="x">Module Languages</a></td></tr><tr><td align="right">17.2&nbsp;</td><td><a href="hash-reader.html" class="tocviewlink" data-pltdoc="x">Reader Extensions</a></td></tr><tr><td align="right">17.3&nbsp;</td><td><a href="hash-languages.html" class="tocviewselflink" data-pltdoc="x">Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>17.3&nbsp;</td><td><a href="hash-languages.html" class="tocviewlink" data-pltdoc="x">Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">17.3.1&nbsp;</td><td><a href="hash-lang_syntax.html" class="tocviewselflink" data-pltdoc="x">Designating a <span class="RktModLink"><span class="RktMod">#lang</span></span> Language</a></td></tr><tr><td align="right">17.3.2&nbsp;</td><td><a href="hash-lang_reader.html" class="tocviewlink" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">reader</span></span></a></td></tr><tr><td align="right">17.3.3&nbsp;</td><td><a href="syntax_module-reader.html" class="tocviewlink" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">s-<wbr></wbr>exp</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">syntax/<span class="mywbr"> &nbsp;</span>module-<wbr></wbr>reader</span></span></a></td></tr><tr><td align="right">17.3.4&nbsp;</td><td><a href="language-collection.html" class="tocviewlink" data-pltdoc="x">Installing a Language</a></td></tr><tr><td align="right">17.3.5&nbsp;</td><td><a href="language-get-info.html" class="tocviewlink" data-pltdoc="x">Source-<wbr></wbr>Handling Configuration</a></td></tr><tr><td align="right">17.3.6&nbsp;</td><td><a href="module-runtime-config.html" class="tocviewlink" data-pltdoc="x">Module-<wbr></wbr>Handling Configuration</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="hash-languages.html" title="backward to &quot;17.3 Defining new #lang Languages&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="hash-languages.html" title="up to &quot;17.3 Defining new #lang Languages&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="hash-lang_reader.html" title="forward to &quot;17.3.2 Using #lang reader&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;hash-lang syntax&quot;">17.3.1<tt>&nbsp;</tt><a name="(part._hash-lang._syntax)"></a>Designating a <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> Language</h5><p>The syntax of a <span class="RktVar">language</span> intentionally overlaps with the
+syntax of a module path as used in <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> or as a
+<a href="module-languages.html#%28tech._module._language%29" class="techoutside" data-pltdoc="x"><span class="techinside">module language</span></a>, so that names like <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a>,
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a>, <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=slideshow&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">slideshow</span></a>, or
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=scribble&amp;rel=manual.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">scribble/manual</span></a> can be used both as <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a>
+languages and as module paths.</p><p>At the same time, the syntax of <span class="RktVar">language</span> is far more
+restricted than a module path, because only <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">z</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">A</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">Z</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">0</span><span class="hspace"></span></span>-<span class="RktInBG"><span class="hspace"></span><span class="RktIn">9</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> (not at the start or end),
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">_</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span>, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span> are allowed in a
+<span class="RktVar">language</span> name. These restrictions keep the syntax of
+<a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> as simple as possible. Keeping the syntax of <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a>
+simple, in turn, is important because the syntax is inherently
+inflexible and non-extensible; the <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> protocol allows a
+<span class="RktVar">language</span> to refine and define syntax in a practically
+unconstrained way, but the <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> protocol itself must remain
+fixed so that various different tools can &ldquo;boot&rdquo; into the extended
+world.</p><p>Fortunately, the <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> protocol provides a natural way to refer
+to languages in ways other than the rigid <span class="RktVar">language</span> syntax:
+by defining a <span class="RktVar">language</span> that implements its own nested
+protocol. We have already seen one example (in <a href="module-languages.html#%28part._s-exp%29" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">s-exp</span></span></a>): the
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._s-exp%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">s-exp</span></a> <span class="RktVar">language</span> allows a programmer to
+specify a <a href="module-languages.html#%28tech._module._language%29" class="techoutside" data-pltdoc="x"><span class="techinside">module language</span></a> using the general <a href="module-paths.html#%28tech._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path</span></a>
+syntax. Meanwhile, <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._s-exp%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">s-exp</span></a> takes care of the
+<a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._reader%29" class="techoutside" data-pltdoc="x"><span class="techinside">reader</span></a>-level responsibilities of a <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> language.</p><p>Unlike <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a>, <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._s-exp%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">s-exp</span></a> cannot be used as a
+module path with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>. Although the syntax of
+<span class="RktVar">language</span> for <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> overlaps with the syntax of module
+paths, a <span class="RktVar">language</span> is not used directly as a module
+path. Instead, a <span class="RktVar">language</span> obtains a module path by trying two
+locations:  first, it looks for a <span class="RktSym">reader</span> submodule of the
+main module for  <span class="RktVar">language</span>. If this is not a valid module path,
+then <span class="RktVar">language</span>  is suffixed with <span class="RktSym">/lang/reader</span>.
+(If neither is a valid module path, an error is raised.) The resulting
+module supplies <span class="RktSym">read</span> and <span class="RktSym">read-syntax</span>
+functions using a protocol that is similar to the one for
+<span class="RktMeta">#reader</span>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="hash-reader.html" data-pltdoc="x">Reader Extensions</a> introduces <span class="RktMeta">#reader</span>.</p></blockquote></blockquote></blockquote><p>A consequence of the way that a <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> <span class="RktVar">language</span> is
+turned into a module path is that the language must be installed in a
+<a href="module-basics.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection</span></a>, similar to the way that <span class="stt">"racket"</span> or
+<span class="stt">"slideshow"</span> are collections that are distributed with Racket.
+Again, however, there&rsquo;s an escape from this restriction: the
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._reader%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">reader</span></a> language lets you specify a <a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._reader%29" class="techoutside" data-pltdoc="x"><span class="techinside">reader</span></a>-level
+implementation of a language using a general <a href="module-paths.html#%28tech._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path</span></a>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="hash-languages.html" title="backward to &quot;17.3 Defining new #lang Languages&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="hash-languages.html" title="up to &quot;17.3 Defining new #lang Languages&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="hash-lang_reader.html" title="forward to &quot;17.3.2 Using #lang reader&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/hash-languages.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/hash-languages.html
new file mode 100644
index 00000000..3081074d
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/hash-languages.html
@@ -0,0 +1,9 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>17.3&nbsp;Defining new #lang Languages</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewselflink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">17.1&nbsp;</td><td><a href="module-languages.html" class="tocviewlink" data-pltdoc="x">Module Languages</a></td></tr><tr><td align="right">17.2&nbsp;</td><td><a href="hash-reader.html" class="tocviewlink" data-pltdoc="x">Reader Extensions</a></td></tr><tr><td align="right">17.3&nbsp;</td><td><a href="hash-languages.html" class="tocviewselflink" data-pltdoc="x">Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>17.3&nbsp;</td><td><a href="hash-languages.html" class="tocviewselflink" data-pltdoc="x">Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">17.3.1&nbsp;</td><td><a href="hash-lang_syntax.html" class="tocviewlink" data-pltdoc="x">Designating a <span class="RktModLink"><span class="RktMod">#lang</span></span> Language</a></td></tr><tr><td align="right">17.3.2&nbsp;</td><td><a href="hash-lang_reader.html" class="tocviewlink" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">reader</span></span></a></td></tr><tr><td align="right">17.3.3&nbsp;</td><td><a href="syntax_module-reader.html" class="tocviewlink" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">s-<wbr></wbr>exp</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">syntax/<span class="mywbr"> &nbsp;</span>module-<wbr></wbr>reader</span></span></a></td></tr><tr><td align="right">17.3.4&nbsp;</td><td><a href="language-collection.html" class="tocviewlink" data-pltdoc="x">Installing a Language</a></td></tr><tr><td align="right">17.3.5&nbsp;</td><td><a href="language-get-info.html" class="tocviewlink" data-pltdoc="x">Source-<wbr></wbr>Handling Configuration</a></td></tr><tr><td align="right">17.3.6&nbsp;</td><td><a href="module-runtime-config.html" class="tocviewlink" data-pltdoc="x">Module-<wbr></wbr>Handling Configuration</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="hash-reader.html" title="backward to &quot;17.2 Reader Extensions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="languages.html" title="up to &quot;17 Creating Languages&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="hash-lang_syntax.html" title="forward to &quot;17.3.1 Designating a #lang Language&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;hash-languages&quot;">17.3<tt>&nbsp;</tt><a name="(part._hash-languages)"></a>Defining new <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> Languages</h4><p>When loading a module as a source program that starts</p><blockquote class="SCodeFlow"><p><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><span class="RktVar">language</span></p></blockquote><p>the <span class="RktVar">language</span> determines the way that the rest of the module
+is parsed at the <a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._reader%29" class="techoutside" data-pltdoc="x"><span class="techinside">reader</span></a> level. The <a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._reader%29" class="techoutside" data-pltdoc="x"><span class="techinside">reader</span></a>-level parse
+must produce a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> form as a <a href="stx-obj.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>. As
+always, the second sub-form after <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> specifies the
+<a href="module-languages.html#%28tech._module._language%29" class="techoutside" data-pltdoc="x"><span class="techinside">module language</span></a> that controls the meaning of the module&rsquo;s body
+forms. Thus, a <span class="RktVar">language</span> specified after <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a>
+controls both the <a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._reader%29" class="techoutside" data-pltdoc="x"><span class="techinside">reader</span></a>-level and <a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._expander%29" class="techoutside" data-pltdoc="x"><span class="techinside">expander</span></a>-level
+parsing of a module.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="hash-lang_syntax.html" class="toclink" data-pltdoc="x">17.3.1<span class="hspace">&nbsp;</span>Designating a <span class="RktModLink"><span class="RktMod">#lang</span></span> Language</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="hash-lang_reader.html" class="toclink" data-pltdoc="x">17.3.2<span class="hspace">&nbsp;</span>Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">reader</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax_module-reader.html" class="toclink" data-pltdoc="x">17.3.3<span class="hspace">&nbsp;</span>Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">s-exp</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">syntax/module-reader</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="language-collection.html" class="toclink" data-pltdoc="x">17.3.4<span class="hspace">&nbsp;</span>Installing a Language</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="language-get-info.html" class="toclink" data-pltdoc="x">17.3.5<span class="hspace">&nbsp;</span>Source-Handling Configuration</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-runtime-config.html" class="toclink" data-pltdoc="x">17.3.6<span class="hspace">&nbsp;</span>Module-Handling Configuration</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="hash-reader.html" title="backward to &quot;17.2 Reader Extensions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="languages.html" title="up to &quot;17 Creating Languages&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="hash-lang_syntax.html" title="forward to &quot;17.3.1 Designating a #lang Language&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/hash-reader.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/hash-reader.html
new file mode 100644
index 00000000..595dd2de
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/hash-reader.html
@@ -0,0 +1,84 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>17.2&nbsp;Reader Extensions</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewselflink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">17.1&nbsp;</td><td><a href="module-languages.html" class="tocviewlink" data-pltdoc="x">Module Languages</a></td></tr><tr><td align="right">17.2&nbsp;</td><td><a href="hash-reader.html" class="tocviewselflink" data-pltdoc="x">Reader Extensions</a></td></tr><tr><td align="right">17.3&nbsp;</td><td><a href="hash-languages.html" class="tocviewlink" data-pltdoc="x">Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>17.2&nbsp;</td><td><a href="hash-reader.html" class="tocviewselflink" data-pltdoc="x">Reader Extensions</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">17.2.1&nbsp;</td><td><a href="hash-reader.html#%28part._.Source_.Locations%29" class="tocviewlink" data-pltdoc="x">Source Locations</a></td></tr><tr><td align="right">17.2.2&nbsp;</td><td><a href="hash-reader.html#%28part._readtable%29" class="tocviewlink" data-pltdoc="x">Readtables</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">17.2.1<tt>&nbsp;</tt></span><a href="hash-reader.html#%28part._.Source_.Locations%29" class="tocsubseclink" data-pltdoc="x">Source Locations</a></td></tr><tr><td><span class="tocsublinknumber">17.2.2<tt>&nbsp;</tt></span><a href="hash-reader.html#%28part._readtable%29" class="tocsubseclink" data-pltdoc="x">Readtables</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="module-languages.html" title="backward to &quot;17.1 Module Languages&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="languages.html" title="up to &quot;17 Creating Languages&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="hash-languages.html" title="forward to &quot;17.3 Defining new #lang Languages&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;hash-reader&quot;">17.2<tt>&nbsp;</tt><a name="(part._hash-reader)"></a>Reader Extensions</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528part._parse-reader%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Reading via an Extension</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on reader extensions.</p></blockquote></blockquote></blockquote><p>The <a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._reader%29" class="techoutside" data-pltdoc="x"><span class="techinside">reader</span></a> layer of the Racket language can be extended through
+the <span class="RktMeta">#reader</span> form. A reader extension is implemented
+as a module that is named after <span class="RktMeta">#reader</span>. The module
+exports functions that parse raw characters into a form to be consumed
+by the <a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._expander%29" class="techoutside" data-pltdoc="x"><span class="techinside">expander</span></a> layer.</p><p>The syntax of <span class="RktMeta">#reader</span> is</p><blockquote class="SCodeFlow"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#reader</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">module-path</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">reader-specific</span>&#8250;</span></p></blockquote><p>where <span class="sroman">&#8249;<span style="font-style: italic">module-path</span>&#8250;</span> names a module that provides
+<span class="RktSym">read</span> and <span class="RktSym">read-syntax</span> functions. The
+<span class="sroman">&#8249;<span style="font-style: italic">reader-specific</span>&#8250;</span> part is a sequence of characters that is
+parsed as determined by the <span class="RktSym">read</span> and
+<span class="RktSym">read-syntax</span> functions from <span class="sroman">&#8249;<span style="font-style: italic">module-path</span>&#8250;</span>.</p><p>For example, suppose that file <span class="stt">"five.rkt"</span> contains</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"five.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-syntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-syntax</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-syntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>Then, the program</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktMeta">#reader</span><span class="RktVal">"five.rkt"</span><span class="stt">23456</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktVal">)</span></td></tr></table></blockquote><p>is equivalent to</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">"23456"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktVal">)</span></td></tr></table></blockquote><p>because the <span class="RktSym">read</span> and <span class="RktSym">read-syntax</span>
+functions of <span class="stt">"five.rkt"</span> both read five characters from the
+input stream and put them into a string and then a list. The reader
+functions from <span class="stt">"five.rkt"</span> are not obliged to follow Racket
+lexical conventions and treat the continuous sequence <span class="RktInBG"><span class="hspace"></span><span class="RktIn">234567</span><span class="hspace"></span></span>
+as a single number. Since only the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">23456</span><span class="hspace"></span></span> part is consumed by
+<span class="RktSym">read</span> or <span class="RktSym">read-syntax</span>, the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">7</span><span class="hspace"></span></span>
+remains to be parsed in the usual Racket way. Similarly, the reader
+functions from <span class="stt">"five.rkt"</span> are not obliged to ignore
+whitespace, and</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktMeta">#reader</span><span class="RktVal">"five.rkt"</span><span class="hspace">&nbsp;</span><span class="stt">2345</span><span class="RktVal">67</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktVal">)</span></td></tr></table></blockquote><p>is equivalent to</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">" 2345"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">67</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktVal">)</span></td></tr></table></blockquote><p>since the first character immediately after <span class="RktVal">"five.rkt"</span> is a
+space.</p><p>A <span class="RktMeta">#reader</span> form can be used in the <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>, too:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktVal">'</span><span class="RktMeta">#reader</span><span class="RktVal">"five.rkt"</span><span class="stt">abcde</span></td></tr><tr><td><p><span class="RktRes">'("abcde")</span></p></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Source_Locations&quot;">17.2.1<tt>&nbsp;</tt><a name="(part._.Source_.Locations)"></a>Source Locations</h5><p>The difference between <span class="RktSym">read</span> and
+<span class="RktSym">read-syntax</span> is that <span class="RktSym">read</span> is meant to be
+used for data while <span class="RktSym">read-syntax</span> is meant to be used to
+parse programs. More precisely, the <span class="RktSym">read</span> function will
+be used when the enclosing stream is being parsed by the Racket
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span>, and <span class="RktSym">read-syntax</span> is used when the
+enclosing stream is being parsed by the Racket <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-syntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-syntax</a></span>
+function. Nothing requires <span class="RktSym">read</span> and
+<span class="RktSym">read-syntax</span> to parse input in the same way, but making
+them different would confuse programmers and tools.</p><p>The <span class="RktSym">read-syntax</span> function can return the same kind of
+value as <span class="RktSym">read</span>, but it should normally return a
+<a href="stx-obj.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> that connects the parsed expression with source
+locations. Unlike the <span class="stt">"five.rkt"</span> example, the
+<span class="RktSym">read-syntax</span> function is typically implemented directly
+to produce <a href="stx-obj.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax objects</span></a>, and then <span class="RktSym">read</span> can use
+<span class="RktSym">read-syntax</span> and strip away <a href="stx-obj.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a>
+wrappers to produce a raw result.</p><p>The following <span class="stt">"arith.rkt"</span> module implements a reader to
+parse simple infix arithmetic expressions into Racket forms. For
+example, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">1*2+3</span><span class="hspace"></span></span> parses into the Racket form <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">3</span><span class="RktPn">)</span>. The supported operators are <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">*</span><span class="hspace"></span></span>, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>, while operands can be unsigned integers
+or single-letter variables. The implementation uses
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linecol.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._port-next-location%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">port-next-location</a></span> to obtain the current source location, and
+it uses <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._datum-%7E3esyntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">datum-&gt;syntax</a></span> to turn raw values into <a href="stx-obj.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax
+objects</span></a>.</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"arith.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">syntax/readerr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-syntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-syntax</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-%7E3edatum%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-syntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-syntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">skip-whitespace</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">read-arith</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">skip-whitespace</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"^\\s*"</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">read-arith</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">line</span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="hspace">&nbsp;</span><span class="RktSym">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linecol.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._port-next-location%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">port-next-location</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">expr-match</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Match an operand followed by any number of </span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">operator</span><span class="RktCmt">&ndash;</span><span class="RktCmt">operand sequences, and prohibit an</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">additional operator from following immediately:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#px"^([a-z]|[0-9]+)(?:[-+*/]([a-z]|[0-9]+))*(?![-+*/])"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">to-syntax</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktSym">delta</span><span class="hspace">&nbsp;</span><span class="RktSym">span-str</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._datum-%7E3esyntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">datum-&gt;syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._make-srcloc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-srcloc</a></span><span class="hspace">&nbsp;</span><span class="RktSym">delta</span><span class="hspace">&nbsp;</span><span class="RktSym">span-str</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._make-srcloc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-srcloc</a></span><span class="hspace">&nbsp;</span><span class="RktSym">delta</span><span class="hspace">&nbsp;</span><span class="RktSym">span-str</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktSym">line</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=vectors.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._vector%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">line</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="hspace">&nbsp;</span><span class="RktSym">delta</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pos</span><span class="hspace">&nbsp;</span><span class="RktSym">delta</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">span-str</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">parse-expr</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">delta</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"^(.*)([+-])(.*?)$"</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"^(.*)([*/])(.*?)$"</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a-str</span><span class="hspace">&nbsp;</span><span class="RktSym">op-str</span><span class="hspace">&nbsp;</span><span class="RktSym">b-str</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a-len</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a-str</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">parse-expr</span><span class="hspace">&nbsp;</span><span class="RktSym">a-str</span><span class="hspace">&nbsp;</span><span class="RktSym">delta</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">parse-expr</span><span class="hspace">&nbsp;</span><span class="RktSym">b-str</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">delta</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">a-len</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">to-syntax</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-%7E3esymbol%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-&gt;symbol</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op-str</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">delta</span><span class="hspace">&nbsp;</span><span class="RktSym">a-len</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">op-str</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">to-syntax</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">op</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">delta</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">to-syntax</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-%7E3enumber%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-&gt;number</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-%7E3esymbol%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-&gt;symbol</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">delta</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._unless%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktSym">expr-match</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=reader-helpers.html%23%2528def._%2528%2528lib._syntax%252Freaderr..rkt%2529._raise-read-error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise-read-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"bad arithmetic syntax"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">line</span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="hspace">&nbsp;</span><span class="RktSym">pos</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pos</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-buffers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._file-position%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">file-position</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">pos</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">parse-expr</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes-%7E3estring%252Futf-8%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">bytes-&gt;string/utf-8</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">expr-match</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>If the <span class="stt">"arith.rkt"</span> reader is used in an expression position,
+then its parse result will be treated as a Racket expression. If it is
+used in a quoted form, however, then it just produces a number or a
+list:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktMeta">#reader</span><span class="RktVal">"arith.rkt"</span><span class="hspace">&nbsp;</span><span class="stt">1*2+3</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">'</span><span class="RktMeta">#reader</span><span class="RktVal">"arith.rkt"</span><span class="hspace">&nbsp;</span><span class="stt">1*2+3</span></td></tr><tr><td><p><span class="RktRes">'(+ (* 1 2) 3)</span></p></td></tr></table></blockquote><p>The <span class="stt">"arith.rkt"</span> reader could also be used in positions that
+make no sense. Since the <span class="RktSym">read-syntax</span> implementation
+tracks source locations, syntax errors can at least refer to parts of
+the input in terms of their original locations (at the beginning of
+the error message):</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktMeta">#reader</span><span class="RktVal">"arith.rkt"</span><span class="hspace">&nbsp;</span><span class="stt">1*2+3</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">repl:1:27: let: bad syntax (not an identifier and expression</span></p></td></tr><tr><td><p><span class="RktErr">for a binding)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: +</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (let (+ (* 1 2) 3) 8)</span></p></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;readtable&quot;">17.2.2<tt>&nbsp;</tt><a name="(part._readtable)"></a>Readtables</h5><p>A reader extension&rsquo;s ability to parse input characters in an arbitrary
+way can be powerful, but many cases of lexical extension call for a
+less general but more composable approach. In much the same way that
+the <a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._expander%29" class="techoutside" data-pltdoc="x"><span class="techinside">expander</span></a> level of Racket syntax can be extended through
+<a href="macros.html#%28tech._macro%29" class="techoutside" data-pltdoc="x"><span class="techinside">macros</span></a>, the <a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._reader%29" class="techoutside" data-pltdoc="x"><span class="techinside">reader</span></a> level of Racket syntax can be
+composably extended through a <a name="(tech._readtable)"></a><span style="font-style: italic">readtable</span>.</p><p>The Racket reader is a recursive-descent parser, and the
+<a href="hash-reader.html#%28tech._readtable%29" class="techoutside" data-pltdoc="x"><span class="techinside">readtable</span></a> maps characters to parsing handlers. For example, the
+default readtable maps <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span> to a handler that recursively
+parses subforms until it finds a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>. The
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-readtable%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-readtable</a></span> <a href="parameterize.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a> determines the
+<a href="hash-reader.html#%28tech._readtable%29" class="techoutside" data-pltdoc="x"><span class="techinside">readtable</span></a> that is used by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span> or
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-syntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-syntax</a></span>. Rather than parsing raw characters directly, a
+reader extension can install an extended <a href="hash-reader.html#%28tech._readtable%29" class="techoutside" data-pltdoc="x"><span class="techinside">readtable</span></a> and then
+chain to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span> or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-syntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-syntax</a></span>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span>See <a href="parameterize.html" data-pltdoc="x">Dynamic Binding: <span class="RktSym"><span class="RktStxLink">parameterize</span></span></a> for an introduction to
+<a href="parameterize.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameters</span></a>.</p></blockquote></blockquote></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=readtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-readtable%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-readtable</a></span> function constructs a new <a href="hash-reader.html#%28tech._readtable%29" class="techoutside" data-pltdoc="x"><span class="techinside">readtable</span></a>
+as an extension of an existing one. It accepts a sequence of
+specifications in terms of a character, a type of mapping for the
+character, and (for certain types of mappings) a parsing
+procedure. For example, to extend the readtable so that <span class="RktInBG"><span class="hspace"></span><span class="RktIn">$</span><span class="hspace"></span></span>
+can be used to start and end infix expressions, implement a
+<span class="RktSym">read-dollar</span> function and use:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=readtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-readtable%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-readtable</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-readtable%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-readtable</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#\$</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">terminating-macro</span><span class="hspace">&nbsp;</span><span class="RktSym">read-dollar</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The protocol for <span class="RktSym">read-dollar</span> requires the function to accept
+different numbers of arguments depending on whether it is being used
+in <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span> or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-syntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-syntax</a></span> mode. In <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span> mode,
+the parser function is given two arguments: the character that
+triggered the parser function and the input port that is being
+read. In <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-syntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-syntax</a></span> mode, the function must accept four
+additional arguments that provide the source location of the
+character.</p><p>The following <span class="stt">"dollar.rkt"</span> module defines a
+<span class="RktSym">read-dollar</span> function in terms of the <span class="RktSym">read</span> and
+<span class="RktSym">read-syntax</span> functions provided by <span class="stt">"arith.rkt"</span>,
+and it puts <span class="RktSym">read-dollar</span> together with new <span class="RktSym">read</span> and
+<span class="RktSym">read-syntax</span> functions that install the readtable and
+chain to Racket&rsquo;s <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span> or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-syntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-syntax</a></span>:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"dollar.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">syntax/readerr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._prefix-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">prefix-in</a></span><span class="hspace">&nbsp;</span><span class="RktSym">arith:</span><span class="hspace">&nbsp;</span><span class="RktVal">"arith.rkt"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._rename-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">rename-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">$-read</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">$-read-syntax</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-syntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-syntax</a></span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">$-read</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-readtable%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-readtable</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-$-readtable</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">$-read-syntax</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-readtable%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-readtable</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-$-readtable</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-syntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-$-readtable</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=readtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-readtable%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-readtable</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-readtable%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-readtable</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#\$</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">terminating-macro</span><span class="hspace">&nbsp;</span><span class="RktSym">read-dollar</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">read-dollar</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._case-lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case-lambda</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check-$-after</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">arith:read</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=inspectors.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._object-name%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">object-name</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">line</span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="hspace">&nbsp;</span><span class="RktSym">pos</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check-$-after</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">arith:read-syntax</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check-$-after</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"^\\s*"</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">skip whitespace</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._peek-char%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">peek-char</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._unless%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktVal">#\$</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bad-ending</span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-char%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-char</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bad-ending</span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._let-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">line</span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="hspace">&nbsp;</span><span class="RktSym">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=linecol.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._port-next-location%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">port-next-location</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-ops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eof-object%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eof-object?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=reader-helpers.html%23%2528def._%2528%2528lib._syntax%252Freaderr..rkt%2529._raise-read-error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise-read-error</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=reader-helpers.html%23%2528def._%2528%2528lib._syntax%252Freaderr..rkt%2529._raise-read-eof-error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise-read-eof-error</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"expected a closing `$'"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">line</span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="hspace">&nbsp;</span><span class="RktSym">pos</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-ops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eof-object%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eof-object?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>With this reader extension, a single <span class="RktMeta">#reader</span> can be
+used at the beginning of an expression to enable multiple uses of
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">$</span><span class="hspace"></span></span> that switch to infix arithmetic:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktMeta">#reader</span><span class="RktVal">"dollar.rkt"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">a</span><span class="stt"> </span><span class="stt">$1*2+3$</span><span class="RktPn">]</span><span class="stt"> </span><span class="RktPn">[</span><span class="RktSym">b</span><span class="stt"> </span><span class="stt">$5/6$</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym">$a+b$</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">35/6</span></p></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="module-languages.html" title="backward to &quot;17.1 Module Languages&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="languages.html" title="up to &quot;17 Creating Languages&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="hash-languages.html" title="forward to &quot;17.3 Defining new #lang Languages&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/hash-tables.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/hash-tables.html
new file mode 100644
index 00000000..15a4f937
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/hash-tables.html
@@ -0,0 +1,29 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.10&nbsp;Hash Tables</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewselflink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings (Unicode)</a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Bytes and Byte Strings</a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="hash-tables.html" class="tocviewselflink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="void_undefined.html" class="tocviewlink" data-pltdoc="x">Void and Undefined</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="vectors.html" title="backward to &quot;3.9 Vectors&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="boxes.html" title="forward to &quot;3.11 Boxes&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;hash-tables&quot;">3.10<tt>&nbsp;</tt><a name="(part._hash-tables)"></a>Hash Tables</h4><p>A <a name="(tech._hash._table)"></a><span style="font-style: italic">hash table</span> implements a mapping from keys to values, where
+both keys and values can be arbitrary Racket values, and access and
+update to the table are normally constant-time operations. Keys are
+compared using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eqv%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eqv?</a></span>, or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span>, depending on whether
+the hash table is created with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-hash%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-hash</a></span>,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-hasheqv%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-hasheqv</a></span>, or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-hasheq%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-hasheq</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-hash%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-hash</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-set%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">red</span><span class="hspace">&nbsp;</span><span class="RktVal">round</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-set%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">yellow</span><span class="hspace">&nbsp;</span><span class="RktVal">long</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(red round)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht</span><span class="hspace">&nbsp;</span><span class="RktVal">"coconut"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">hash-ref: no value found for key</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">key: "coconut"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht</span><span class="hspace">&nbsp;</span><span class="RktVal">"coconut"</span><span class="hspace">&nbsp;</span><span class="RktVal">"not there"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"not there"</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hasheqv%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hasheqv</a></span>, and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hasheq%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hasheq</a></span> functions
+create immutable hash tables from an initial set of keys and values,
+in which each value is provided as an argument after its key. Immutable
+hash tables can be extended with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-set%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-set</a></span>, which produces a
+new immutable hash table in constant time.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">red</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yellow</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'red</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-set%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-set</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht</span><span class="hspace">&nbsp;</span><span class="RktVal">"coconut"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">brown</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht</span><span class="hspace">&nbsp;</span><span class="RktVal">"coconut"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">hash-ref: no value found for key</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">key: "coconut"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht2</span><span class="hspace">&nbsp;</span><span class="RktVal">"coconut"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'brown</span></p></td></tr></table></blockquote></div></p><p>A literal immutable hash table can be written as an expression by using
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hash</span><span class="hspace"></span></span> (for an <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span>-based table),
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hasheqv</span><span class="hspace"></span></span> (for an <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eqv%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eqv?</a></span>-based table), or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hasheq</span><span class="hspace"></span></span> (for an <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span>-based table). A parenthesized
+sequence must immediately follow <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hash</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hasheq</span><span class="hspace"></span></span>,
+or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hasheqv</span><span class="hspace"></span></span>, where each element is a dotted
+key&ndash;value pair. The <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hash</span><span class="hspace"></span></span>, etc. forms implicitly
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span> their key and value sub-forms.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht</span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">red</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVal">"banana"</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">yellow</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'red</span></p></td></tr></table></blockquote></div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528part._parse-hashtable%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Reading Hash Tables</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> documents the fine points of the syntax of hash table literals.</p></blockquote></blockquote></blockquote><p>Both mutable and immutable hash tables print like immutable hash
+tables, using a quoted <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hash</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hasheqv</span><span class="hspace"></span></span>, or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#hasheq</span><span class="hspace"></span></span> form if all keys and values can be expressed with
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span> or using <span class="RktRes">hash</span>, <span class="RktRes">hasheq</span>, or
+<span class="RktRes">hasheqv</span> otherwise:</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">red</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVal">"banana"</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">yellow</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'#hash(("apple" . red) ("banana" . yellow))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._srcloc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">srcloc</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"file.rkt"</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(hash 1 (srcloc "file.rkt" 1 0 1 8))</span></p></td></tr></table></blockquote></div></p><p>A mutable hash table can optionally retain its keys
+<span style="font-style: italic">weakly</span>, so each mapping is retained only so long as the key
+is retained elsewhere.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-weak-hasheq%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-weak-hasheq</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-set%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._gensym%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">gensym</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"can you see me?"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=garbagecollection.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._collect-garbage%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">collect-garbage</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr></table></blockquote></div></p><p>Beware that even a weak hash table retains its values strongly, as
+long as the corresponding key is accessible. This creates a catch-22
+dependency when a value refers back to its key, so that the mapping is
+retained permanently. To break the cycle, map the key to an <span style="font-style: italic">ephemeron</span>
+that pairs the value with its key (in addition to the implicit pairing
+of the hash table).</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ephemerons.html&amp;version=8.6" class="Sq" data-pltdoc="x">Ephemerons</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> documents the fine points of using ephemerons.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-weak-hasheq%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-weak-hasheq</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">g</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._gensym%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">gensym</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-set%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht</span><span class="hspace">&nbsp;</span><span class="RktSym">g</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">g</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=garbagecollection.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._collect-garbage%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">collect-garbage</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></blockquote></div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-weak-hasheq%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-weak-hasheq</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">g</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._gensym%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">gensym</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-set%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht</span><span class="hspace">&nbsp;</span><span class="RktSym">g</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=ephemerons.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-ephemeron%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-ephemeron</a></span><span class="hspace">&nbsp;</span><span class="RktSym">g</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">g</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=garbagecollection.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._collect-garbage%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">collect-garbage</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-count%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-count</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ht</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr></table></blockquote><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html&amp;version=8.6" class="Sq" data-pltdoc="x">Hash Tables</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on hash tables and hash-table procedures.</p></blockquote></blockquote></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="vectors.html" title="backward to &quot;3.9 Vectors&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="boxes.html" title="forward to &quot;3.11 Boxes&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/i_o.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/i_o.html
new file mode 100644
index 00000000..65af8f28
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/i_o.html
@@ -0,0 +1,9 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>8&nbsp;Input and Output</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>8&nbsp;</td><td><a href="i_o.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Varieties of Ports</a></td></tr><tr><td align="right">8.2&nbsp;</td><td><a href="default-ports.html" class="tocviewlink" data-pltdoc="x">Default Ports</a></td></tr><tr><td align="right">8.3&nbsp;</td><td><a href="read-write.html" class="tocviewlink" data-pltdoc="x">Reading and Writing Racket Data</a></td></tr><tr><td align="right">8.4&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Datatypes and Serialization</a></td></tr><tr><td align="right">8.5&nbsp;</td><td><a href="encodings.html" class="tocviewlink" data-pltdoc="x">Bytes, Characters, and Encodings</a></td></tr><tr><td align="right">8.6&nbsp;</td><td><a href="io-patterns.html" class="tocviewlink" data-pltdoc="x">I/<span class="mywbr"> &nbsp;</span>O Patterns</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contracts-gotchas.html" title="backward to &quot;7.9 Gotchas&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="ports.html" title="forward to &quot;8.1 Varieties of Ports&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;i/o&quot;">8<tt>&nbsp;</tt><a name="(part._i/o)"></a>Input and Output</h3><p><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>A Racket port corresponds to the Unix notion of a stream
+(not to be confused with <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=streams.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/stream</span></a>&rsquo;s streams).</p></blockquote></blockquote></blockquote></div><div class="SIntrapara">A Racket <a name="(tech._port)"></a><span style="font-style: italic">port</span> represents a source or sink of data, such as a
+file, a terminal, a TCP connection, or an in-memory string.  Ports
+provide sequential access in which data can be read or written a piece
+of a time, without requiring the data to be consumed or produced all
+at once.  More specifically, an <span style="font-style: italic">input port</span> represents a
+source from which a program can read data, and an <span style="font-style: italic">output
+port</span> represents a sink to which a program can write data.</div></p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="ports.html" class="toclink" data-pltdoc="x">8.1<span class="hspace">&nbsp;</span>Varieties of Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="default-ports.html" class="toclink" data-pltdoc="x">8.2<span class="hspace">&nbsp;</span>Default Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="read-write.html" class="toclink" data-pltdoc="x">8.3<span class="hspace">&nbsp;</span>Reading and Writing Racket Data</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="serialization.html" class="toclink" data-pltdoc="x">8.4<span class="hspace">&nbsp;</span>Datatypes and Serialization</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="encodings.html" class="toclink" data-pltdoc="x">8.5<span class="hspace">&nbsp;</span>Bytes, Characters, and Encodings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="io-patterns.html" class="toclink" data-pltdoc="x">8.6<span class="hspace">&nbsp;</span>I/O Patterns</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="contracts-gotchas.html" title="backward to &quot;7.9 Gotchas&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="ports.html" title="forward to &quot;8.1 Varieties of Ports&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/icons.css b/clones/download.racket-lang.org/releases/8.6/doc/guide/icons.css
new file mode 100644
index 00000000..4923ee0f
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/icons.css
@@ -0,0 +1,8 @@
+.imageleft {
+  float: left;
+  margin-right: 0.3em;
+}
+
+.imageleft img {
+  width: 1.5em;
+}
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/index.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/index.html
new file mode 100644
index 00000000..55834df4
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/index.html
@@ -0,0 +1,10 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>The Racket Guide</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9660;</a></td><td></td><td><a href="index.html" class="tocviewselflink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublistonly" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber"></span><a href="index.html#%28part._top%29" class="tocsubseclink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="versionbox"><span class="version">8.6</span></div><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<span class="nonavigation">&larr; prev</span>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">up</a>&nbsp;&nbsp;<a href="intro.html" title="forward to &quot;1 Welcome to Racket&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h2 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;top&quot;"><a name="(part._top)"></a><a name="(part._.The_.Racket_.Guide)"></a>The Racket Guide</h2><div class="SAuthorListBox"><span class="SAuthorList"><p class="author">Matthew Flatt,<br/>Robert Bruce Findler,<br/>and PLT</p></span></div><p>This guide is intended for programmers who are new to Racket or new to
+some part of Racket. It assumes programming experience, so if you are
+new to programming, consider instead reading <span style="font-style: italic"><a href="https://htdp.org">How to Design Programs</a></span>. If you want an
+especially quick introduction to Racket, start with <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=quick&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">Quick: An Introduction to Racket with Pictures</a>.</p><p><a href="to-scheme.html" data-pltdoc="x">Chapter 2</a> provides a brief introduction to
+Racket. From <a href="datatypes.html" data-pltdoc="x">Chapter 3</a> on, this guide dives
+into details&#8212;<wbr></wbr>covering much of the Racket toolbox, but leaving
+precise details to <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> and other reference manuals.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The source of this manual is available on
+<a href="https://github.com/racket/racket/tree/master/pkgs/racket-doc/scribblings/guide">GitHub</a>.</p></blockquote></blockquote></blockquote><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="intro.html" class="toptoclink" data-pltdoc="x">1<span class="hspace">&nbsp;</span>Welcome to Racket</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="intro.html#%28part._.Interacting_with_.Racket%29" class="toclink" data-pltdoc="x">1.1<span class="hspace">&nbsp;</span>Interacting with Racket</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="intro.html#%28part._.Definitions_and_.Interactions%29" class="toclink" data-pltdoc="x">1.2<span class="hspace">&nbsp;</span>Definitions and Interactions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="intro.html#%28part._.Creating_.Executables%29" class="toclink" data-pltdoc="x">1.3<span class="hspace">&nbsp;</span>Creating Executables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="intro.html#%28part._use-module%29" class="toclink" data-pltdoc="x">1.4<span class="hspace">&nbsp;</span>A Note to Readers with Lisp/Scheme Experience</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="to-scheme.html" class="toptoclink" data-pltdoc="x">2<span class="hspace">&nbsp;</span>Racket Essentials</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Simple_Values.html" class="toclink" data-pltdoc="x">2.1<span class="hspace">&nbsp;</span>Simple Values</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-overview.html" class="toclink" data-pltdoc="x">2.2<span class="hspace">&nbsp;</span>Simple Definitions and Expressions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-overview.html#%28part._.Definitions%29" class="toclink" data-pltdoc="x">2.2.1<span class="hspace">&nbsp;</span>Definitions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-overview.html#%28part._indentation%29" class="toclink" data-pltdoc="x">2.2.2<span class="hspace">&nbsp;</span>An Aside on Indenting Code</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-overview.html#%28part._.Identifiers%29" class="toclink" data-pltdoc="x">2.2.3<span class="hspace">&nbsp;</span>Identifiers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-overview.html#%28part._.Function_.Calls__.Procedure_.Applications_%29" class="toclink" data-pltdoc="x">2.2.4<span class="hspace">&nbsp;</span>Function Calls (Procedure Applications)</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-overview.html#%28part._.Conditionals_with_if__and__or__and_cond%29" class="toclink" data-pltdoc="x">2.2.5<span class="hspace">&nbsp;</span>Conditionals with <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, <span class="RktSym"><span class="RktStxLink">or</span></span>, and <span class="RktSym"><span class="RktStxLink">cond</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-overview.html#%28part._.Function_.Calls__.Again%29" class="toclink" data-pltdoc="x">2.2.6<span class="hspace">&nbsp;</span>Function Calls, Again</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-overview.html#%28part._.Anonymous_.Functions_with_lambda%29" class="toclink" data-pltdoc="x">2.2.7<span class="hspace">&nbsp;</span>Anonymous Functions with <span class="RktSym"><span class="RktStxLink">lambda</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-overview.html#%28part._local-binding-intro%29" class="toclink" data-pltdoc="x">2.2.8<span class="hspace">&nbsp;</span>Local Binding with
+<span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">let</span></span>, and <span class="RktSym"><span class="RktStxLink">let*</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Lists__Iteration__and_Recursion.html" class="toclink" data-pltdoc="x">2.3<span class="hspace">&nbsp;</span>Lists, Iteration, and Recursion</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Lists__Iteration__and_Recursion.html#%28part._.Predefined_.List_.Loops%29" class="toclink" data-pltdoc="x">2.3.1<span class="hspace">&nbsp;</span>Predefined List Loops</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Lists__Iteration__and_Recursion.html#%28part._.List_.Iteration_from_.Scratch%29" class="toclink" data-pltdoc="x">2.3.2<span class="hspace">&nbsp;</span>List Iteration from Scratch</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Lists__Iteration__and_Recursion.html#%28part._tail-recursion%29" class="toclink" data-pltdoc="x">2.3.3<span class="hspace">&nbsp;</span>Tail Recursion</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Lists__Iteration__and_Recursion.html#%28part._.Recursion_versus_.Iteration%29" class="toclink" data-pltdoc="x">2.3.4<span class="hspace">&nbsp;</span>Recursion versus Iteration</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Pairs__Lists__and_Racket_Syntax.html" class="toclink" data-pltdoc="x">2.4<span class="hspace">&nbsp;</span>Pairs, Lists, and Racket Syntax</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Pairs__Lists__and_Racket_Syntax.html#%28part._quoting-lists%29" class="toclink" data-pltdoc="x">2.4.1<span class="hspace">&nbsp;</span>Quoting Pairs and Symbols with <span class="RktSym"><span class="RktStxLink">quote</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Pairs__Lists__and_Racket_Syntax.html#%28part._.Abbreviating_quote_with__%29" class="toclink" data-pltdoc="x">2.4.2<span class="hspace">&nbsp;</span>Abbreviating <span class="RktSym"><span class="RktStxLink">quote</span></span> with <span class="RktVal">'</span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Pairs__Lists__and_Racket_Syntax.html#%28part._lists-and-syntax%29" class="toclink" data-pltdoc="x">2.4.3<span class="hspace">&nbsp;</span>Lists and Racket Syntax</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="datatypes.html" class="toptoclink" data-pltdoc="x">3<span class="hspace">&nbsp;</span>Built-In Datatypes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="booleans.html" class="toclink" data-pltdoc="x">3.1<span class="hspace">&nbsp;</span>Booleans</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="numbers.html" class="toclink" data-pltdoc="x">3.2<span class="hspace">&nbsp;</span>Numbers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="characters.html" class="toclink" data-pltdoc="x">3.3<span class="hspace">&nbsp;</span>Characters</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="strings.html" class="toclink" data-pltdoc="x">3.4<span class="hspace">&nbsp;</span>Strings (Unicode)</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="bytestrings.html" class="toclink" data-pltdoc="x">3.5<span class="hspace">&nbsp;</span>Bytes and Byte Strings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="symbols.html" class="toclink" data-pltdoc="x">3.6<span class="hspace">&nbsp;</span>Symbols</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="keywords.html" class="toclink" data-pltdoc="x">3.7<span class="hspace">&nbsp;</span>Keywords</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pairs.html" class="toclink" data-pltdoc="x">3.8<span class="hspace">&nbsp;</span>Pairs and Lists</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="vectors.html" class="toclink" data-pltdoc="x">3.9<span class="hspace">&nbsp;</span>Vectors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="hash-tables.html" class="toclink" data-pltdoc="x">3.10<span class="hspace">&nbsp;</span>Hash Tables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="boxes.html" class="toclink" data-pltdoc="x">3.11<span class="hspace">&nbsp;</span>Boxes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="void_undefined.html" class="toclink" data-pltdoc="x">3.12<span class="hspace">&nbsp;</span>Void and Undefined</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="scheme-forms.html" class="toptoclink" data-pltdoc="x">4<span class="hspace">&nbsp;</span>Expressions and Definitions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-notation.html" class="toclink" data-pltdoc="x">4.1<span class="hspace">&nbsp;</span>Notation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="binding.html" class="toclink" data-pltdoc="x">4.2<span class="hspace">&nbsp;</span>Identifiers and Binding</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="application.html" class="toclink" data-pltdoc="x">4.3<span class="hspace">&nbsp;</span>Function Calls (Procedure Applications)</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="application.html#%28part._.Evaluation_.Order_and_.Arity%29" class="toclink" data-pltdoc="x">4.3.1<span class="hspace">&nbsp;</span>Evaluation Order and Arity</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="application.html#%28part._keyword-args%29" class="toclink" data-pltdoc="x">4.3.2<span class="hspace">&nbsp;</span>Keyword Arguments</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="application.html#%28part._apply%29" class="toclink" data-pltdoc="x">4.3.3<span class="hspace">&nbsp;</span>The <span class="RktSym"><span class="RktValLink">apply</span></span> Function</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="lambda.html" class="toclink" data-pltdoc="x">4.4<span class="hspace">&nbsp;</span>Functions (Procedures): <span class="RktSym"><span class="RktStxLink">lambda</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="lambda.html#%28part._rest-args%29" class="toclink" data-pltdoc="x">4.4.1<span class="hspace">&nbsp;</span>Declaring a Rest Argument</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="lambda.html#%28part._.Declaring_.Optional_.Arguments%29" class="toclink" data-pltdoc="x">4.4.2<span class="hspace">&nbsp;</span>Declaring Optional Arguments</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="lambda.html#%28part._lambda-keywords%29" class="toclink" data-pltdoc="x">4.4.3<span class="hspace">&nbsp;</span>Declaring Keyword Arguments</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="lambda.html#%28part._case-lambda%29" class="toclink" data-pltdoc="x">4.4.4<span class="hspace">&nbsp;</span>Arity-Sensitive Functions: <span class="RktSym"><span class="RktStxLink">case-lambda</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define.html" class="toclink" data-pltdoc="x">4.5<span class="hspace">&nbsp;</span>Definitions: <span class="RktSym"><span class="RktStxLink">define</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define.html#%28part._.Function_.Shorthand%29" class="toclink" data-pltdoc="x">4.5.1<span class="hspace">&nbsp;</span>Function Shorthand</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define.html#%28part._.Curried_.Function_.Shorthand%29" class="toclink" data-pltdoc="x">4.5.2<span class="hspace">&nbsp;</span>Curried Function Shorthand</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define.html#%28part._multiple-values%29" class="toclink" data-pltdoc="x">4.5.3<span class="hspace">&nbsp;</span>Multiple Values and <span class="RktSym"><span class="RktStxLink">define-values</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define.html#%28part._intdefs%29" class="toclink" data-pltdoc="x">4.5.4<span class="hspace">&nbsp;</span>Internal Definitions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="let.html" class="toclink" data-pltdoc="x">4.6<span class="hspace">&nbsp;</span>Local Binding</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="let.html#%28part._.Parallel_.Binding__let%29" class="toclink" data-pltdoc="x">4.6.1<span class="hspace">&nbsp;</span>Parallel Binding: <span class="RktSym"><span class="RktStxLink">let</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="let.html#%28part._.Sequential_.Binding__let_%29" class="toclink" data-pltdoc="x">4.6.2<span class="hspace">&nbsp;</span>Sequential Binding: <span class="RktSym"><span class="RktStxLink">let*</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="let.html#%28part._.Recursive_.Binding__letrec%29" class="toclink" data-pltdoc="x">4.6.3<span class="hspace">&nbsp;</span>Recursive Binding: <span class="RktSym"><span class="RktStxLink">letrec</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="let.html#%28part._.Named_let%29" class="toclink" data-pltdoc="x">4.6.4<span class="hspace">&nbsp;</span>Named <span class="RktSym"><span class="RktStxLink">let</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="let.html#%28part._.Multiple_.Values__let-values__let_-values__letrec-values%29" class="toclink" data-pltdoc="x">4.6.5<span class="hspace">&nbsp;</span>Multiple Values: <span class="RktSym"><span class="RktStxLink">let-values</span></span>, <span class="RktSym"><span class="RktStxLink">let*-values</span></span>, <span class="RktSym"><span class="RktStxLink">letrec-values</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="conditionals.html" class="toclink" data-pltdoc="x">4.7<span class="hspace">&nbsp;</span>Conditionals</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="conditionals.html#%28part._.Simple_.Branching__if%29" class="toclink" data-pltdoc="x">4.7.1<span class="hspace">&nbsp;</span>Simple Branching: <span class="RktSym"><span class="RktStxLink">if</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="conditionals.html#%28part._and%2Bor%29" class="toclink" data-pltdoc="x">4.7.2<span class="hspace">&nbsp;</span>Combining Tests: <span class="RktSym"><span class="RktStxLink">and</span></span> and <span class="RktSym"><span class="RktStxLink">or</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="conditionals.html#%28part._cond%29" class="toclink" data-pltdoc="x">4.7.3<span class="hspace">&nbsp;</span>Chaining Tests: <span class="RktSym"><span class="RktStxLink">cond</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="begin.html" class="toclink" data-pltdoc="x">4.8<span class="hspace">&nbsp;</span>Sequencing</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="begin.html#%28part._.Effects_.Before__begin%29" class="toclink" data-pltdoc="x">4.8.1<span class="hspace">&nbsp;</span>Effects Before: <span class="RktSym"><span class="RktStxLink">begin</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="begin.html#%28part._.Effects_.After__begin0%29" class="toclink" data-pltdoc="x">4.8.2<span class="hspace">&nbsp;</span>Effects After: <span class="RktSym"><span class="RktStxLink">begin0</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="begin.html#%28part._when%2Bunless%29" class="toclink" data-pltdoc="x">4.8.3<span class="hspace">&nbsp;</span>Effects If...: <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="set_.html" class="toclink" data-pltdoc="x">4.9<span class="hspace">&nbsp;</span>Assignment: <span class="RktSym"><span class="RktStxLink">set!</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="set_.html#%28part._using-set%21%29" class="toclink" data-pltdoc="x">4.9.1<span class="hspace">&nbsp;</span>Guidelines for Using Assignment</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="set_.html#%28part._.Multiple_.Values__set_-values%29" class="toclink" data-pltdoc="x">4.9.2<span class="hspace">&nbsp;</span>Multiple Values: <span class="RktSym"><span class="RktStxLink">set!-values</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="quote.html" class="toclink" data-pltdoc="x">4.10<span class="hspace">&nbsp;</span>Quoting: <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktVal">&rsquo;</span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="qq.html" class="toclink" data-pltdoc="x">4.11<span class="hspace">&nbsp;</span>Quasiquoting: <span class="RktSym"><span class="RktStxLink">quasiquote</span></span> and <span class="RktVal">&lsquo;</span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="case.html" class="toclink" data-pltdoc="x">4.12<span class="hspace">&nbsp;</span>Simple Dispatch: <span class="RktSym"><span class="RktStxLink">case</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="parameterize.html" class="toclink" data-pltdoc="x">4.13<span class="hspace">&nbsp;</span>Dynamic Binding: <span class="RktSym"><span class="RktStxLink">parameterize</span></span></a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define-struct.html" class="toptoclink" data-pltdoc="x">5<span class="hspace">&nbsp;</span>Programmer-Defined Datatypes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define-struct.html#%28part._.Simple_.Structure_.Types__struct%29" class="toclink" data-pltdoc="x">5.1<span class="hspace">&nbsp;</span>Simple Structure Types: <span class="RktSym"><span class="RktStxLink">struct</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define-struct.html#%28part._struct-copy%29" class="toclink" data-pltdoc="x">5.2<span class="hspace">&nbsp;</span>Copying and Update</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define-struct.html#%28part._struct-subtypes%29" class="toclink" data-pltdoc="x">5.3<span class="hspace">&nbsp;</span>Structure Subtypes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define-struct.html#%28part._trans-struct%29" class="toclink" data-pltdoc="x">5.4<span class="hspace">&nbsp;</span>Opaque versus Transparent Structure Types</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define-struct.html#%28part._struct-equal%29" class="toclink" data-pltdoc="x">5.5<span class="hspace">&nbsp;</span>Structure Comparisons</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define-struct.html#%28part._.Structure_.Type_.Generativity%29" class="toclink" data-pltdoc="x">5.6<span class="hspace">&nbsp;</span>Structure Type Generativity</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define-struct.html#%28part._prefab-struct%29" class="toclink" data-pltdoc="x">5.7<span class="hspace">&nbsp;</span>Prefab Structure Types</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define-struct.html#%28part._struct-options%29" class="toclink" data-pltdoc="x">5.8<span class="hspace">&nbsp;</span>More Structure Type Options</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="modules.html" class="toptoclink" data-pltdoc="x">6<span class="hspace">&nbsp;</span>Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-basics.html" class="toclink" data-pltdoc="x">6.1<span class="hspace">&nbsp;</span>Module Basics</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-basics.html#%28part._module-org%29" class="toclink" data-pltdoc="x">6.1.1<span class="hspace">&nbsp;</span>Organizing Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-basics.html#%28part._.Library_.Collections%29" class="toclink" data-pltdoc="x">6.1.2<span class="hspace">&nbsp;</span>Library Collections</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-basics.html#%28part._packages-and-collections%29" class="toclink" data-pltdoc="x">6.1.3<span class="hspace">&nbsp;</span>Packages and Collections</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-basics.html#%28part._link-collection%29" class="toclink" data-pltdoc="x">6.1.4<span class="hspace">&nbsp;</span>Adding Collections</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-basics.html#%28part._intracollection%29" class="toclink" data-pltdoc="x">6.1.5<span class="hspace">&nbsp;</span>Module References Within a Collection</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Module_Syntax.html" class="toclink" data-pltdoc="x">6.2<span class="hspace">&nbsp;</span>Module Syntax</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Module_Syntax.html#%28part._module-syntax%29" class="toclink" data-pltdoc="x">6.2.1<span class="hspace">&nbsp;</span>The <span class="RktSym"><span class="RktStxLink">module</span></span> Form</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Module_Syntax.html#%28part._hash-lang%29" class="toclink" data-pltdoc="x">6.2.2<span class="hspace">&nbsp;</span>The <span class="RktMod">#lang</span> Shorthand</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Module_Syntax.html#%28part._submodules%29" class="toclink" data-pltdoc="x">6.2.3<span class="hspace">&nbsp;</span>Submodules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Module_Syntax.html#%28part._main-and-test%29" class="toclink" data-pltdoc="x">6.2.4<span class="hspace">&nbsp;</span>Main and Test Submodules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-paths.html" class="toclink" data-pltdoc="x">6.3<span class="hspace">&nbsp;</span>Module Paths</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-require.html" class="toclink" data-pltdoc="x">6.4<span class="hspace">&nbsp;</span>Imports: <span class="RktSym"><span class="RktStxLink">require</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-provide.html" class="toclink" data-pltdoc="x">6.5<span class="hspace">&nbsp;</span>Exports: <span class="RktSym"><span class="RktStxLink">provide</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-set.html" class="toclink" data-pltdoc="x">6.6<span class="hspace">&nbsp;</span>Assignment and Redefinition</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-macro.html" class="toclink" data-pltdoc="x">6.7<span class="hspace">&nbsp;</span>Modules and Macros</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="protect-out.html" class="toclink" data-pltdoc="x">6.8<span class="hspace">&nbsp;</span>Protected Exports</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts.html" class="toptoclink" data-pltdoc="x">7<span class="hspace">&nbsp;</span>Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-boundaries.html" class="toclink" data-pltdoc="x">7.1<span class="hspace">&nbsp;</span>Contracts and Boundaries</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-boundaries.html#%28part._contracts-amount0%29" class="toclink" data-pltdoc="x">7.1.1<span class="hspace">&nbsp;</span>Contract Violations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-boundaries.html#%28part._.Experimenting_with_.Contracts_and_.Modules%29" class="toclink" data-pltdoc="x">7.1.2<span class="hspace">&nbsp;</span>Experimenting with Contracts and Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-boundaries.html#%28part._contracts-intro-nested%29" class="toclink" data-pltdoc="x">7.1.3<span class="hspace">&nbsp;</span>Experimenting with Nested Contract Boundaries</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-func.html" class="toclink" data-pltdoc="x">7.2<span class="hspace">&nbsp;</span>Simple Contracts on Functions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-func.html#%28part._.Styles_of_-_%29" class="toclink" data-pltdoc="x">7.2.1<span class="hspace">&nbsp;</span>Styles of <span class="RktSym"><span class="RktStxLink"><span class="nobreak">-&gt;</span></span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-func.html#%28part._simple-nested%29" class="toclink" data-pltdoc="x">7.2.2<span class="hspace">&nbsp;</span>Using <span class="RktSym"><span class="RktStxLink">define/contract</span></span> and <span class="RktSym"><span class="RktStxLink"><span class="nobreak">-&gt;</span></span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-func.html#%28part._any_and_any_c%29" class="toclink" data-pltdoc="x">7.2.3<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">any</span></span> and <span class="RktSym"><span class="RktValLink">any/c</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-func.html#%28part._contracts-own%29" class="toclink" data-pltdoc="x">7.2.4<span class="hspace">&nbsp;</span>Rolling Your Own Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-func.html#%28part._.Contracts_on_.Higher-order_.Functions%29" class="toclink" data-pltdoc="x">7.2.5<span class="hspace">&nbsp;</span>Contracts on Higher-order Functions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-func.html#%28part._contracts-flat-named-contracts%29" class="toclink" data-pltdoc="x">7.2.6<span class="hspace">&nbsp;</span>Contract Messages with &ldquo;???&rdquo;</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contract-func.html#%28part._contracts-dissecting-contract-errors%29" class="toclink" data-pltdoc="x">7.2.7<span class="hspace">&nbsp;</span>Dissecting a contract error message</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-general-functions.html" class="toclink" data-pltdoc="x">7.3<span class="hspace">&nbsp;</span>Contracts on Functions in General</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-general-functions.html#%28part._contracts-optional%29" class="toclink" data-pltdoc="x">7.3.1<span class="hspace">&nbsp;</span>Optional Arguments</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-general-functions.html#%28part._contracts-rest-args%29" class="toclink" data-pltdoc="x">7.3.2<span class="hspace">&nbsp;</span>Rest Arguments</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-general-functions.html#%28part._contracts-keywords%29" class="toclink" data-pltdoc="x">7.3.3<span class="hspace">&nbsp;</span>Keyword Arguments</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-general-functions.html#%28part._contracts-optional-keywords%29" class="toclink" data-pltdoc="x">7.3.4<span class="hspace">&nbsp;</span>Optional Keyword Arguments</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-general-functions.html#%28part._contracts-case-lambda%29" class="toclink" data-pltdoc="x">7.3.5<span class="hspace">&nbsp;</span>Contracts for <span class="RktSym"><span class="RktStxLink">case-lambda</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-general-functions.html#%28part._contracts-arrow-d%29" class="toclink" data-pltdoc="x">7.3.6<span class="hspace">&nbsp;</span>Argument and Result Dependencies</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-general-functions.html#%28part._contracts-arrow-d-eval-order%29" class="toclink" data-pltdoc="x">7.3.7<span class="hspace">&nbsp;</span>Checking State Changes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-general-functions.html#%28part._contracts-multiple%29" class="toclink" data-pltdoc="x">7.3.8<span class="hspace">&nbsp;</span>Multiple Result Values</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-general-functions.html#%28part._contracts-no-domain%29" class="toclink" data-pltdoc="x">7.3.9<span class="hspace">&nbsp;</span>Fixed but Statically Unknown Arities</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-first.html" class="toclink" data-pltdoc="x">7.4<span class="hspace">&nbsp;</span>Contracts: A Thorough Example</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-struct.html" class="toclink" data-pltdoc="x">7.5<span class="hspace">&nbsp;</span>Contracts on Structures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-struct.html#%28part._contracts-single-struct%29" class="toclink" data-pltdoc="x">7.5.1<span class="hspace">&nbsp;</span>Guarantees for a Specific Value</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-struct.html#%28part._contracts-define-struct%29" class="toclink" data-pltdoc="x">7.5.2<span class="hspace">&nbsp;</span>Guarantees for All Values</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-struct.html#%28part._contracts-lazy-contracts%29" class="toclink" data-pltdoc="x">7.5.3<span class="hspace">&nbsp;</span>Checking Properties of Data Structures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-exists.html" class="toclink" data-pltdoc="x">7.6<span class="hspace">&nbsp;</span>Abstract Contracts using <span class="RktPn">#:exists</span> and <span class="RktPn">#:&#8707;</span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-examples.html" class="toclink" data-pltdoc="x">7.7<span class="hspace">&nbsp;</span>Additional Examples</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-examples.html#%28part._.A_.Customer-.Manager_.Component%29" class="toclink" data-pltdoc="x">7.7.1<span class="hspace">&nbsp;</span>A Customer-Manager Component</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-examples.html#%28part._.A_.Parameteric__.Simple__.Stack%29" class="toclink" data-pltdoc="x">7.7.2<span class="hspace">&nbsp;</span>A Parameteric (Simple) Stack</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-examples.html#%28part._.A_.Dictionary%29" class="toclink" data-pltdoc="x">7.7.3<span class="hspace">&nbsp;</span>A Dictionary</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-examples.html#%28part._.A_.Queue%29" class="toclink" data-pltdoc="x">7.7.4<span class="hspace">&nbsp;</span>A Queue</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Building_New_Contracts.html" class="toclink" data-pltdoc="x">7.8<span class="hspace">&nbsp;</span>Building New Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Building_New_Contracts.html#%28part._.Contract_.Struct_.Properties%29" class="toclink" data-pltdoc="x">7.8.1<span class="hspace">&nbsp;</span>Contract Struct Properties</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Building_New_Contracts.html#%28part._.With_all_the_.Bells_and_.Whistles%29" class="toclink" data-pltdoc="x">7.8.2<span class="hspace">&nbsp;</span>With all the Bells and Whistles</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-gotchas.html" class="toclink" data-pltdoc="x">7.9<span class="hspace">&nbsp;</span>Gotchas</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-gotchas.html#%28part._.Contracts_and_eq_%29" class="toclink" data-pltdoc="x">7.9.1<span class="hspace">&nbsp;</span>Contracts and <span class="RktSym"><span class="RktValLink">eq?</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-gotchas.html#%28part._contracts-gotcha-nested%29" class="toclink" data-pltdoc="x">7.9.2<span class="hspace">&nbsp;</span>Contract boundaries and <span class="RktSym"><span class="RktStxLink">define/contract</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-gotchas.html#%28part._contracts-exists-gotcha%29" class="toclink" data-pltdoc="x">7.9.3<span class="hspace">&nbsp;</span>Exists Contracts and Predicates</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-gotchas.html#%28part._.Defining_.Recursive_.Contracts%29" class="toclink" data-pltdoc="x">7.9.4<span class="hspace">&nbsp;</span>Defining Recursive Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="contracts-gotchas.html#%28part._.Mixing_set__and_contract-out%29" class="toclink" data-pltdoc="x">7.9.5<span class="hspace">&nbsp;</span>Mixing <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">contract-out</span></span></a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="i_o.html" class="toptoclink" data-pltdoc="x">8<span class="hspace">&nbsp;</span>Input and Output</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="ports.html" class="toclink" data-pltdoc="x">8.1<span class="hspace">&nbsp;</span>Varieties of Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="default-ports.html" class="toclink" data-pltdoc="x">8.2<span class="hspace">&nbsp;</span>Default Ports</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="read-write.html" class="toclink" data-pltdoc="x">8.3<span class="hspace">&nbsp;</span>Reading and Writing Racket Data</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="serialization.html" class="toclink" data-pltdoc="x">8.4<span class="hspace">&nbsp;</span>Datatypes and Serialization</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="encodings.html" class="toclink" data-pltdoc="x">8.5<span class="hspace">&nbsp;</span>Bytes, Characters, and Encodings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="io-patterns.html" class="toclink" data-pltdoc="x">8.6<span class="hspace">&nbsp;</span>I/O Patterns</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp.html" class="toptoclink" data-pltdoc="x">9<span class="hspace">&nbsp;</span>Regular Expressions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-intro.html" class="toclink" data-pltdoc="x">9.1<span class="hspace">&nbsp;</span>Writing Regexp Patterns</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-match.html" class="toclink" data-pltdoc="x">9.2<span class="hspace">&nbsp;</span>Matching Regexp Patterns</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-assert.html" class="toclink" data-pltdoc="x">9.3<span class="hspace">&nbsp;</span>Basic Assertions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-chars.html" class="toclink" data-pltdoc="x">9.4<span class="hspace">&nbsp;</span>Characters and Character Classes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-chars.html#%28part._.Some_.Frequently_.Used_.Character_.Classes%29" class="toclink" data-pltdoc="x">9.4.1<span class="hspace">&nbsp;</span>Some Frequently Used Character Classes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-chars.html#%28part._.P.O.S.I.X_character_classes%29" class="toclink" data-pltdoc="x">9.4.2<span class="hspace">&nbsp;</span>POSIX character classes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-quant.html" class="toclink" data-pltdoc="x">9.5<span class="hspace">&nbsp;</span>Quantifiers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-clusters.html" class="toclink" data-pltdoc="x">9.6<span class="hspace">&nbsp;</span>Clusters</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-clusters.html#%28part._.Backreferences%29" class="toclink" data-pltdoc="x">9.6.1<span class="hspace">&nbsp;</span>Backreferences</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-clusters.html#%28part._.Non-capturing_.Clusters%29" class="toclink" data-pltdoc="x">9.6.2<span class="hspace">&nbsp;</span>Non-capturing Clusters</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-clusters.html#%28part._regexp-cloister%29" class="toclink" data-pltdoc="x">9.6.3<span class="hspace">&nbsp;</span>Cloisters</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-alternation.html" class="toclink" data-pltdoc="x">9.7<span class="hspace">&nbsp;</span>Alternation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Backtracking.html" class="toclink" data-pltdoc="x">9.8<span class="hspace">&nbsp;</span>Backtracking</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Looking_Ahead_and_Behind.html" class="toclink" data-pltdoc="x">9.9<span class="hspace">&nbsp;</span>Looking Ahead and Behind</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Looking_Ahead_and_Behind.html#%28part._.Lookahead%29" class="toclink" data-pltdoc="x">9.9.1<span class="hspace">&nbsp;</span>Lookahead</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Looking_Ahead_and_Behind.html#%28part._.Lookbehind%29" class="toclink" data-pltdoc="x">9.9.2<span class="hspace">&nbsp;</span>Lookbehind</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="An_Extended_Example.html" class="toclink" data-pltdoc="x">9.10<span class="hspace">&nbsp;</span>An Extended Example</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="control.html" class="toptoclink" data-pltdoc="x">10<span class="hspace">&nbsp;</span>Exceptions and Control</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="exns.html" class="toclink" data-pltdoc="x">10.1<span class="hspace">&nbsp;</span>Exceptions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="prompt.html" class="toclink" data-pltdoc="x">10.2<span class="hspace">&nbsp;</span>Prompts and Aborts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="conts.html" class="toclink" data-pltdoc="x">10.3<span class="hspace">&nbsp;</span>Continuations</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="for.html" class="toptoclink" data-pltdoc="x">11<span class="hspace">&nbsp;</span>Iterations and Comprehensions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="for.html#%28part._sequences%29" class="toclink" data-pltdoc="x">11.1<span class="hspace">&nbsp;</span>Sequence Constructors</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="for.html#%28part._for_and_for_%29" class="toclink" data-pltdoc="x">11.2<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">for</span></span> and <span class="RktSym"><span class="RktStxLink">for*</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="for.html#%28part._for_list_and_for__list%29" class="toclink" data-pltdoc="x">11.3<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">for/list</span></span> and <span class="RktSym"><span class="RktStxLink">for*/list</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="for.html#%28part._for_vector_and_for__vector%29" class="toclink" data-pltdoc="x">11.4<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">for/vector</span></span> and <span class="RktSym"><span class="RktStxLink">for*/vector</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="for.html#%28part._for_and_and_for_or%29" class="toclink" data-pltdoc="x">11.5<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">for/and</span></span> and <span class="RktSym"><span class="RktStxLink">for/or</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="for.html#%28part._for_first_and_for_last%29" class="toclink" data-pltdoc="x">11.6<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">for/first</span></span> and <span class="RktSym"><span class="RktStxLink">for/last</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="for.html#%28part._for%2Ffold%29" class="toclink" data-pltdoc="x">11.7<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">for/fold</span></span> and <span class="RktSym"><span class="RktStxLink">for*/fold</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="for.html#%28part._.Multiple-.Valued_.Sequences%29" class="toclink" data-pltdoc="x">11.8<span class="hspace">&nbsp;</span>Multiple-Valued Sequences</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="for.html#%28part._.Breaking_an_.Iteration%29" class="toclink" data-pltdoc="x">11.9<span class="hspace">&nbsp;</span>Breaking an Iteration</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="for.html#%28part._for-performance%29" class="toclink" data-pltdoc="x">11.10<span class="hspace">&nbsp;</span>Iteration Performance</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="match.html" class="toptoclink" data-pltdoc="x">12<span class="hspace">&nbsp;</span>Pattern Matching</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="classes.html" class="toptoclink" data-pltdoc="x">13<span class="hspace">&nbsp;</span>Classes and Objects</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="classes.html#%28part._methods%29" class="toclink" data-pltdoc="x">13.1<span class="hspace">&nbsp;</span>Methods</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="classes.html#%28part._initargs%29" class="toclink" data-pltdoc="x">13.2<span class="hspace">&nbsp;</span>Initialization Arguments</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="classes.html#%28part._intnames%29" class="toclink" data-pltdoc="x">13.3<span class="hspace">&nbsp;</span>Internal and External Names</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="classes.html#%28part._.Interfaces%29" class="toclink" data-pltdoc="x">13.4<span class="hspace">&nbsp;</span>Interfaces</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="classes.html#%28part._inner%29" class="toclink" data-pltdoc="x">13.5<span class="hspace">&nbsp;</span>Final, Augment, and Inner</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="classes.html#%28part._extnames%29" class="toclink" data-pltdoc="x">13.6<span class="hspace">&nbsp;</span>Controlling the Scope of External Names</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="classes.html#%28part._.Mixins%29" class="toclink" data-pltdoc="x">13.7<span class="hspace">&nbsp;</span>Mixins</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="classes.html#%28part._.Mixins_and_.Interfaces%29" class="toclink" data-pltdoc="x">13.7.1<span class="hspace">&nbsp;</span>Mixins and Interfaces</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="classes.html#%28part._.The_mixin_.Form%29" class="toclink" data-pltdoc="x">13.7.2<span class="hspace">&nbsp;</span>The <span class="RktSym"><span class="RktStxLink">mixin</span></span> Form</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="classes.html#%28part._parammixins%29" class="toclink" data-pltdoc="x">13.7.3<span class="hspace">&nbsp;</span>Parameterized Mixins</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="classes.html#%28part._.Traits%29" class="toclink" data-pltdoc="x">13.8<span class="hspace">&nbsp;</span>Traits</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="classes.html#%28part._.Traits_as_.Sets_of_.Mixins%29" class="toclink" data-pltdoc="x">13.8.1<span class="hspace">&nbsp;</span>Traits as Sets of Mixins</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="classes.html#%28part._.Inherit_and_.Super_in_.Traits%29" class="toclink" data-pltdoc="x">13.8.2<span class="hspace">&nbsp;</span>Inherit and Super in Traits</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="classes.html#%28part._.The_trait_.Form%29" class="toclink" data-pltdoc="x">13.8.3<span class="hspace">&nbsp;</span>The <span class="RktSym"><span class="RktStxLink">trait</span></span> Form</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="classes.html#%28part._.Class_.Contracts%29" class="toclink" data-pltdoc="x">13.9<span class="hspace">&nbsp;</span>Class Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="classes.html#%28part._.External_.Class_.Contracts%29" class="toclink" data-pltdoc="x">13.9.1<span class="hspace">&nbsp;</span>External Class Contracts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="classes.html#%28part._.Internal_.Class_.Contracts%29" class="toclink" data-pltdoc="x">13.9.2<span class="hspace">&nbsp;</span>Internal Class Contracts</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="units.html" class="toptoclink" data-pltdoc="x">14<span class="hspace">&nbsp;</span>Units (Components)</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Signatures_and_Units.html" class="toclink" data-pltdoc="x">14.1<span class="hspace">&nbsp;</span>Signatures and Units</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Invoking_Units.html" class="toclink" data-pltdoc="x">14.2<span class="hspace">&nbsp;</span>Invoking Units</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Linking_Units.html" class="toclink" data-pltdoc="x">14.3<span class="hspace">&nbsp;</span>Linking Units</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="firstclassunits.html" class="toclink" data-pltdoc="x">14.4<span class="hspace">&nbsp;</span>First-Class Units</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Whole-module_Signatures_and_Units.html" class="toclink" data-pltdoc="x">14.5<span class="hspace">&nbsp;</span>Whole-<span class="RktSym"><span class="RktStxLink">module</span></span> Signatures and Units</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Contracts_for_Units.html" class="toclink" data-pltdoc="x">14.6<span class="hspace">&nbsp;</span>Contracts for Units</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Contracts_for_Units.html#%28part._.Adding_.Contracts_to_.Signatures%29" class="toclink" data-pltdoc="x">14.6.1<span class="hspace">&nbsp;</span>Adding Contracts to Signatures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Contracts_for_Units.html#%28part._.Adding_.Contracts_to_.Units%29" class="toclink" data-pltdoc="x">14.6.2<span class="hspace">&nbsp;</span>Adding Contracts to Units</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="unit_versus_module.html" class="toclink" data-pltdoc="x">14.7<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">unit</span></span> versus <span class="RktSym"><span class="RktStxLink">module</span></span></a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="reflection.html" class="toptoclink" data-pltdoc="x">15<span class="hspace">&nbsp;</span>Reflection and Dynamic Evaluation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval.html" class="toclink" data-pltdoc="x">15.1<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktValLink">eval</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval.html#%28part._.Local_.Scopes%29" class="toclink" data-pltdoc="x">15.1.1<span class="hspace">&nbsp;</span>Local Scopes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval.html#%28part._namespaces%29" class="toclink" data-pltdoc="x">15.1.2<span class="hspace">&nbsp;</span>Namespaces</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval.html#%28part._.Namespaces_and_.Modules%29" class="toclink" data-pltdoc="x">15.1.3<span class="hspace">&nbsp;</span>Namespaces and Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="mk-namespace.html" class="toclink" data-pltdoc="x">15.2<span class="hspace">&nbsp;</span>Manipulating Namespaces</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="mk-namespace.html#%28part._.Creating_and_.Installing_.Namespaces%29" class="toclink" data-pltdoc="x">15.2.1<span class="hspace">&nbsp;</span>Creating and Installing Namespaces</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="mk-namespace.html#%28part._.Sharing_.Data_and_.Code_.Across_.Namespaces%29" class="toclink" data-pltdoc="x">15.2.2<span class="hspace">&nbsp;</span>Sharing Data and Code Across Namespaces</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="load.html" class="toclink" data-pltdoc="x">15.3<span class="hspace">&nbsp;</span>Scripting Evaluation and Using <span class="RktSym"><span class="RktValLink">load</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="code-inspectors_protect.html" class="toclink" data-pltdoc="x">15.4<span class="hspace">&nbsp;</span>Code Inspectors for Trusted and Untrusted Code</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="macros.html" class="toptoclink" data-pltdoc="x">16<span class="hspace">&nbsp;</span>Macros</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pattern-macros.html" class="toclink" data-pltdoc="x">16.1<span class="hspace">&nbsp;</span>Pattern-Based Macros</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pattern-macros.html#%28part._define-syntax-rule%29" class="toclink" data-pltdoc="x">16.1.1<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">define-syntax-rule</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pattern-macros.html#%28part._.Lexical_.Scope%29" class="toclink" data-pltdoc="x">16.1.2<span class="hspace">&nbsp;</span>Lexical Scope</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pattern-macros.html#%28part._define-syntax_and_syntax-rules%29" class="toclink" data-pltdoc="x">16.1.3<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">define-syntax</span></span> and <span class="RktSym"><span class="RktStxLink">syntax-rules</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pattern-macros.html#%28part._.Matching_.Sequences%29" class="toclink" data-pltdoc="x">16.1.4<span class="hspace">&nbsp;</span>Matching Sequences</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pattern-macros.html#%28part._.Identifier_.Macros%29" class="toclink" data-pltdoc="x">16.1.5<span class="hspace">&nbsp;</span>Identifier Macros</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pattern-macros.html#%28part._set__.Transformers%29" class="toclink" data-pltdoc="x">16.1.6<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">set!</span></span> Transformers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pattern-macros.html#%28part._.Macro-.Generating_.Macros%29" class="toclink" data-pltdoc="x">16.1.7<span class="hspace">&nbsp;</span>Macro-Generating Macros</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pattern-macros.html#%28part._pattern-macro-example%29" class="toclink" data-pltdoc="x">16.1.8<span class="hspace">&nbsp;</span>Extended Example: Call-by-Reference Functions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="proc-macros.html" class="toclink" data-pltdoc="x">16.2<span class="hspace">&nbsp;</span>General Macro Transformers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stx-obj.html" class="toclink" data-pltdoc="x">16.2.1<span class="hspace">&nbsp;</span>Syntax Objects</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="macro-transformers.html" class="toclink" data-pltdoc="x">16.2.2<span class="hspace">&nbsp;</span>Macro Transformer Procedures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-case.html" class="toclink" data-pltdoc="x">16.2.3<span class="hspace">&nbsp;</span>Mixing Patterns and Expressions: <span class="RktSym"><span class="RktStxLink">syntax-case</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="with-syntax.html" class="toclink" data-pltdoc="x">16.2.4<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">with-syntax</span></span> and <span class="RktSym"><span class="RktValLink">generate-temporaries</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stx-phases.html" class="toclink" data-pltdoc="x">16.2.5<span class="hspace">&nbsp;</span>Compile and Run-Time Phases</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="phases.html" class="toclink" data-pltdoc="x">16.2.6<span class="hspace">&nbsp;</span>General Phase Levels</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="phases.html#%28part._.Phases_and_.Bindings%29" class="toclink" data-pltdoc="x">16.2.6.1<span class="hspace">&nbsp;</span>Phases and Bindings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="phases.html#%28part._.Phases_and_.Modules%29" class="toclink" data-pltdoc="x">16.2.6.2<span class="hspace">&nbsp;</span>Phases and Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stx-certs.html" class="toclink" data-pltdoc="x">16.2.7<span class="hspace">&nbsp;</span>Tainted Syntax</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="macro-module.html" class="toclink" data-pltdoc="x">16.3<span class="hspace">&nbsp;</span>Module Instantiations and Visits</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="macro-module.html#%28part._.Declaration_versus_.Instantiation%29" class="toclink" data-pltdoc="x">16.3.1<span class="hspace">&nbsp;</span>Declaration versus Instantiation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="macro-module.html#%28part._compile-time-instantiation%29" class="toclink" data-pltdoc="x">16.3.2<span class="hspace">&nbsp;</span>Compile-Time Instantiation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="macro-module.html#%28part._.Visiting_.Modules%29" class="toclink" data-pltdoc="x">16.3.3<span class="hspace">&nbsp;</span>Visiting Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="macro-module.html#%28part._stx-available-module%29" class="toclink" data-pltdoc="x">16.3.4<span class="hspace">&nbsp;</span>Lazy Visits via Available Modules</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="languages.html" class="toptoclink" data-pltdoc="x">17<span class="hspace">&nbsp;</span>Creating Languages</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-languages.html" class="toclink" data-pltdoc="x">17.1<span class="hspace">&nbsp;</span>Module Languages</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-languages.html#%28part._implicit-forms%29" class="toclink" data-pltdoc="x">17.1.1<span class="hspace">&nbsp;</span>Implicit Form Bindings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-languages.html#%28part._s-exp%29" class="toclink" data-pltdoc="x">17.1.2<span class="hspace">&nbsp;</span>Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">s-exp</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="hash-reader.html" class="toclink" data-pltdoc="x">17.2<span class="hspace">&nbsp;</span>Reader Extensions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="hash-reader.html#%28part._.Source_.Locations%29" class="toclink" data-pltdoc="x">17.2.1<span class="hspace">&nbsp;</span>Source Locations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="hash-reader.html#%28part._readtable%29" class="toclink" data-pltdoc="x">17.2.2<span class="hspace">&nbsp;</span>Readtables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="hash-languages.html" class="toclink" data-pltdoc="x">17.3<span class="hspace">&nbsp;</span>Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="hash-lang_syntax.html" class="toclink" data-pltdoc="x">17.3.1<span class="hspace">&nbsp;</span>Designating a <span class="RktModLink"><span class="RktMod">#lang</span></span> Language</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="hash-lang_reader.html" class="toclink" data-pltdoc="x">17.3.2<span class="hspace">&nbsp;</span>Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">reader</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax_module-reader.html" class="toclink" data-pltdoc="x">17.3.3<span class="hspace">&nbsp;</span>Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">s-exp</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">syntax/module-reader</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="language-collection.html" class="toclink" data-pltdoc="x">17.3.4<span class="hspace">&nbsp;</span>Installing a Language</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="language-get-info.html" class="toclink" data-pltdoc="x">17.3.5<span class="hspace">&nbsp;</span>Source-Handling Configuration</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-runtime-config.html" class="toclink" data-pltdoc="x">17.3.6<span class="hspace">&nbsp;</span>Module-Handling Configuration</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="concurrency.html" class="toptoclink" data-pltdoc="x">18<span class="hspace">&nbsp;</span>Concurrency and Synchronization</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="concurrency.html#%28part._.Threads%29" class="toclink" data-pltdoc="x">18.1<span class="hspace">&nbsp;</span>Threads</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="concurrency.html#%28part._.Thread_.Mailboxes%29" class="toclink" data-pltdoc="x">18.2<span class="hspace">&nbsp;</span>Thread Mailboxes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="concurrency.html#%28part._.Semaphores%29" class="toclink" data-pltdoc="x">18.3<span class="hspace">&nbsp;</span>Semaphores</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="concurrency.html#%28part._.Channels%29" class="toclink" data-pltdoc="x">18.4<span class="hspace">&nbsp;</span>Channels</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="concurrency.html#%28part._.Buffered_.Asynchronous_.Channels%29" class="toclink" data-pltdoc="x">18.5<span class="hspace">&nbsp;</span>Buffered Asynchronous Channels</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="concurrency.html#%28part._.Synchronizable_.Events_and_sync%29" class="toclink" data-pltdoc="x">18.6<span class="hspace">&nbsp;</span>Synchronizable Events and <span class="RktSym"><span class="RktValLink">sync</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="concurrency.html#%28part._.Building_.Your_.Own_.Synchronization_.Patterns%29" class="toclink" data-pltdoc="x">18.7<span class="hspace">&nbsp;</span>Building Your Own Synchronization Patterns</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="performance.html" class="toptoclink" data-pltdoc="x">19<span class="hspace">&nbsp;</span>Performance</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="performance.html#%28part._.Dr.Racket-perf%29" class="toclink" data-pltdoc="x">19.1<span class="hspace">&nbsp;</span>Performance in DrRacket</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="performance.html#%28part._virtual-machines%29" class="toclink" data-pltdoc="x">19.2<span class="hspace">&nbsp;</span>Racket Virtual Machine Implementations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="performance.html#%28part._.J.I.T%29" class="toclink" data-pltdoc="x">19.3<span class="hspace">&nbsp;</span>Bytecode, Machine Code, and Just-in-Time (JIT) Compilers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="performance.html#%28part._modules-performance%29" class="toclink" data-pltdoc="x">19.4<span class="hspace">&nbsp;</span>Modules and Performance</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="performance.html#%28part._func-call-performance%29" class="toclink" data-pltdoc="x">19.5<span class="hspace">&nbsp;</span>Function-Call Optimizations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="performance.html#%28part._.Mutation_and_.Performance%29" class="toclink" data-pltdoc="x">19.6<span class="hspace">&nbsp;</span>Mutation and Performance</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="performance.html#%28part._letrec-performance%29" class="toclink" data-pltdoc="x">19.7<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">letrec</span></span> Performance</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="performance.html#%28part._fixnums%2Bflonums%29" class="toclink" data-pltdoc="x">19.8<span class="hspace">&nbsp;</span>Fixnum and Flonum Optimizations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="performance.html#%28part._unchecked-unsafe%29" class="toclink" data-pltdoc="x">19.9<span class="hspace">&nbsp;</span>Unchecked, Unsafe Operations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="performance.html#%28part._ffi-pointer-access%29" class="toclink" data-pltdoc="x">19.10<span class="hspace">&nbsp;</span>Foreign Pointers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="performance.html#%28part._regexp-perf%29" class="toclink" data-pltdoc="x">19.11<span class="hspace">&nbsp;</span>Regular Expression Performance</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="performance.html#%28part._gc-perf%29" class="toclink" data-pltdoc="x">19.12<span class="hspace">&nbsp;</span>Memory Management</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="performance.html#%28part._.Reachability._and._.Garbage._.Collection%29" class="toclink" data-pltdoc="x">19.13<span class="hspace">&nbsp;</span>Reachability and Garbage Collection</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="performance.html#%28part._.Weak_.Boxes_and_.Testing%29" class="toclink" data-pltdoc="x">19.14<span class="hspace">&nbsp;</span>Weak Boxes and Testing</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="performance.html#%28part._.Reducing_.Garbage_.Collection_.Pauses%29" class="toclink" data-pltdoc="x">19.15<span class="hspace">&nbsp;</span>Reducing Garbage Collection Pauses</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="parallelism.html" class="toptoclink" data-pltdoc="x">20<span class="hspace">&nbsp;</span>Parallelism</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="parallelism.html#%28part._effective-futures%29" class="toclink" data-pltdoc="x">20.1<span class="hspace">&nbsp;</span>Parallelism with Futures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="parallelism.html#%28part._effective-places%29" class="toclink" data-pltdoc="x">20.2<span class="hspace">&nbsp;</span>Parallelism with Places</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="parallelism.html#%28part._distributed-places%29" class="toclink" data-pltdoc="x">20.3<span class="hspace">&nbsp;</span>Distributed Places</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="running.html" class="toptoclink" data-pltdoc="x">21<span class="hspace">&nbsp;</span>Running and Creating Executables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="racket.html" class="toclink" data-pltdoc="x">21.1<span class="hspace">&nbsp;</span>Running <span class="stt">racket</span> and <span class="stt">gracket</span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="racket.html#%28part._start-interactive-mode%29" class="toclink" data-pltdoc="x">21.1.1<span class="hspace">&nbsp;</span>Interactive Mode</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="racket.html#%28part._start-module-mode%29" class="toclink" data-pltdoc="x">21.1.2<span class="hspace">&nbsp;</span>Module Mode</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="racket.html#%28part._start-load-mode%29" class="toclink" data-pltdoc="x">21.1.3<span class="hspace">&nbsp;</span>Load Mode</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="scripts.html" class="toclink" data-pltdoc="x">21.2<span class="hspace">&nbsp;</span>Scripts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="scripts.html#%28part._.Unix_.Scripts%29" class="toclink" data-pltdoc="x">21.2.1<span class="hspace">&nbsp;</span>Unix Scripts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="scripts.html#%28part._.Windows_.Batch_.Files%29" class="toclink" data-pltdoc="x">21.2.2<span class="hspace">&nbsp;</span>Windows Batch Files</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="exe.html" class="toclink" data-pltdoc="x">21.3<span class="hspace">&nbsp;</span>Creating Stand-Alone Executables</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="More_Libraries.html" class="toptoclink" data-pltdoc="x">22<span class="hspace">&nbsp;</span>More Libraries</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="More_Libraries.html#%28part._graphics%29" class="toclink" data-pltdoc="x">22.1<span class="hspace">&nbsp;</span>Graphics and GUIs</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="More_Libraries.html#%28part._.The_.Web_.Server%29" class="toclink" data-pltdoc="x">22.2<span class="hspace">&nbsp;</span>The Web Server</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="More_Libraries.html#%28part._.Using_.Foreign_.Libraries%29" class="toclink" data-pltdoc="x">22.3<span class="hspace">&nbsp;</span>Using Foreign Libraries</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="More_Libraries.html#%28part._.And_.More%29" class="toclink" data-pltdoc="x">22.4<span class="hspace">&nbsp;</span>And More</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="dialects.html" class="toptoclink" data-pltdoc="x">23<span class="hspace">&nbsp;</span>Dialects of Racket and Scheme</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="more-hash-lang.html" class="toclink" data-pltdoc="x">23.1<span class="hspace">&nbsp;</span>More Rackets</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="standards.html" class="toclink" data-pltdoc="x">23.2<span class="hspace">&nbsp;</span>Standards</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="standards.html#%28part._r5rs%29" class="toclink" data-pltdoc="x">23.2.1<span class="hspace">&nbsp;</span>R<span style="vertical-align: super; font-size: 80%">5</span>RS</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="standards.html#%28part._.R6.R.S%29" class="toclink" data-pltdoc="x">23.2.2<span class="hspace">&nbsp;</span>R<span style="vertical-align: super; font-size: 80%">6</span>RS</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="teaching-langs.html" class="toclink" data-pltdoc="x">23.3<span class="hspace">&nbsp;</span>Teaching</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="other-editors.html" class="toptoclink" data-pltdoc="x">24<span class="hspace">&nbsp;</span>Command-Line Tools and Your Editor of Choice</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="cmdline-tools.html" class="toclink" data-pltdoc="x">24.1<span class="hspace">&nbsp;</span>Command-Line Tools</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="cmdline-tools.html#%28part._compile%29" class="toclink" data-pltdoc="x">24.1.1<span class="hspace">&nbsp;</span>Compilation and Configuration: <span class="stt">raco</span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="cmdline-tools.html#%28part._.Interactive_evaluation%29" class="toclink" data-pltdoc="x">24.1.2<span class="hspace">&nbsp;</span>Interactive evaluation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="cmdline-tools.html#%28part._.Shell_completion%29" class="toclink" data-pltdoc="x">24.1.3<span class="hspace">&nbsp;</span>Shell completion</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Emacs.html" class="toclink" data-pltdoc="x">24.2<span class="hspace">&nbsp;</span>Emacs</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Emacs.html#%28part._.Major_.Modes%29" class="toclink" data-pltdoc="x">24.2.1<span class="hspace">&nbsp;</span>Major Modes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Emacs.html#%28part._.Minor_.Modes%29" class="toclink" data-pltdoc="x">24.2.2<span class="hspace">&nbsp;</span>Minor Modes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Emacs.html#%28part._.Packages_specific_to_.Evil_.Mode%29" class="toclink" data-pltdoc="x">24.2.3<span class="hspace">&nbsp;</span>Packages specific to Evil Mode</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Vim.html" class="toclink" data-pltdoc="x">24.3<span class="hspace">&nbsp;</span>Vim</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Vim.html#%28part._vim-plugins%29" class="toclink" data-pltdoc="x">24.3.1<span class="hspace">&nbsp;</span>Plugins</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Vim.html#%28part._.Indentation%29" class="toclink" data-pltdoc="x">24.3.2<span class="hspace">&nbsp;</span>Indentation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Vim.html#%28part._.Highlighting%29" class="toclink" data-pltdoc="x">24.3.3<span class="hspace">&nbsp;</span>Highlighting</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Vim.html#%28part._.Structured_.Editing%29" class="toclink" data-pltdoc="x">24.3.4<span class="hspace">&nbsp;</span>Structured Editing</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Vim.html#%28part._.R.E.P.Ls%29" class="toclink" data-pltdoc="x">24.3.5<span class="hspace">&nbsp;</span>REPLs</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Vim.html#%28part._.Scribble%29" class="toclink" data-pltdoc="x">24.3.6<span class="hspace">&nbsp;</span>Scribble</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Vim.html#%28part._.Miscellaneous%29" class="toclink" data-pltdoc="x">24.3.7<span class="hspace">&nbsp;</span>Miscellaneous</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Sublime_Text.html" class="toclink" data-pltdoc="x">24.4<span class="hspace">&nbsp;</span>Sublime Text</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Visual_Studio_Code.html" class="toclink" data-pltdoc="x">24.5<span class="hspace">&nbsp;</span>Visual Studio Code</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="doc-bibliography.html" class="toptoclink" data-pltdoc="x">Bibliography</a></p></td></tr><tr><td><p><span class="hspace"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="doc-index.html" class="toptoclink" data-pltdoc="x">Index</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<span class="nonavigation">&larr; prev</span>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">up</a>&nbsp;&nbsp;<a href="intro.html" title="forward to &quot;1 Welcome to Racket&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/intro.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/intro.html
new file mode 100644
index 00000000..57dd0a85
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/intro.html
@@ -0,0 +1,75 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>1&nbsp;Welcome to Racket</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9660;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewselflink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>1&nbsp;</td><td><a href="intro.html" class="tocviewselflink" data-pltdoc="x">Welcome to Racket</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">1.1&nbsp;</td><td><a href="intro.html#%28part._.Interacting_with_.Racket%29" class="tocviewlink" data-pltdoc="x">Interacting with Racket</a></td></tr><tr><td align="right">1.2&nbsp;</td><td><a href="intro.html#%28part._.Definitions_and_.Interactions%29" class="tocviewlink" data-pltdoc="x">Definitions and Interactions</a></td></tr><tr><td align="right">1.3&nbsp;</td><td><a href="intro.html#%28part._.Creating_.Executables%29" class="tocviewlink" data-pltdoc="x">Creating Executables</a></td></tr><tr><td align="right">1.4&nbsp;</td><td><a href="intro.html#%28part._use-module%29" class="tocviewlink" data-pltdoc="x">A Note to Readers with Lisp/<span class="mywbr"> &nbsp;</span>Scheme Experience</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">1.1<tt>&nbsp;</tt></span><a href="intro.html#%28part._.Interacting_with_.Racket%29" class="tocsubseclink" data-pltdoc="x">Interacting with Racket</a></td></tr><tr><td><span class="tocsublinknumber">1.2<tt>&nbsp;</tt></span><a href="intro.html#%28part._.Definitions_and_.Interactions%29" class="tocsubseclink" data-pltdoc="x">Definitions and Interactions</a></td></tr><tr><td><span class="tocsublinknumber">1.3<tt>&nbsp;</tt></span><a href="intro.html#%28part._.Creating_.Executables%29" class="tocsubseclink" data-pltdoc="x">Creating Executables</a></td></tr><tr><td><span class="tocsublinknumber">1.4<tt>&nbsp;</tt></span><a href="intro.html#%28part._use-module%29" class="tocsubseclink" data-pltdoc="x">A Note to Readers with Lisp/<span class="mywbr"> &nbsp;</span>Scheme Experience</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="index.html" title="backward to &quot;The Racket Guide&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="to-scheme.html" title="forward to &quot;2 Racket Essentials&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;intro&quot;">1<tt>&nbsp;</tt><a name="(part._intro)"></a>Welcome to Racket</h3><p>Depending on how you look at it, <span style="font-weight: bold">Racket</span> is</p><ul><li><p>a <span style="font-style: italic">programming language</span>&#8212;<wbr></wbr>a dialect of Lisp and a
+descendant of Scheme;</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See <a href="dialects.html" data-pltdoc="x">Dialects of Racket and Scheme</a> for more information on
+other dialects of Lisp and how they relate to Racket.</p></blockquote></blockquote></blockquote></li><li><p>a <span style="font-style: italic">family</span> of programming languages&#8212;<wbr></wbr>variants of
+Racket, and more; or</p></li><li><p>a set of <span style="font-style: italic">tools</span>&#8212;<wbr></wbr>for using a family of programming languages.</p></li></ul><p>Where there is no room for confusion, we use simply <span style="font-style: italic">Racket</span>.</p><p>Racket&rsquo;s main tools are</p><ul><li><p><span style="font-weight: bold"><span class="stt">racket</span></span>, the core compiler, interpreter, and run-time system;</p></li><li><p><span style="font-weight: bold">DrRacket</span>, the programming environment; and</p></li><li><p><span style="font-weight: bold"><span class="stt">raco</span></span>, a command-line tool for executing <span style="font-weight: bold">Ra</span>cket
+<span style="font-weight: bold">co</span>mmands that install packages, build libraries, and more.</p></li></ul><p>Most likely, you&rsquo;ll want to explore the Racket language using
+DrRacket, especially at the beginning. If you prefer, you can also
+work with the command-line <span class="stt">racket</span> interpreter and your favorite
+text editor; see also <a href="other-editors.html" data-pltdoc="x">Command-Line Tools and Your Editor of Choice</a>. The rest of this guide
+presents the language mostly independent of your choice of editor.</p><p>If you&rsquo;re using DrRacket, you&rsquo;ll need to choose the proper language,
+because DrRacket accommodates many different variants of Racket, as
+well as other languages. Assuming that you&rsquo;ve never used DrRacket
+before, start it up, type the line</p><blockquote class="SCodeFlow"><p><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></p></blockquote><p>in DrRacket&rsquo;s top text area, and then click the <span class="ssansserif">Run</span> button
+that&rsquo;s above the text area. DrRacket then understands that you mean to
+work in the normal variant of Racket (as opposed to the smaller
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a> or many other possibilities).</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><a href="more-hash-lang.html" data-pltdoc="x">More Rackets</a> describes some of the other
+possibilities.</p></blockquote></blockquote></blockquote><p>If you&rsquo;ve used DrRacket before with something other than a program
+that starts <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a>, DrRacket will remember the last language
+that you used, instead of inferring the language from the <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a>
+line. In that case, use the <span class="ssansserif">Language|Choose Language...</span>
+menu item.  In the dialog that appears, select the first item, which
+tells DrRacket to use the language that is declared in a source
+program via <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a>. Put the <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> line above in the top
+text area, still.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Interacting_with_Racket&quot;">1.1<tt>&nbsp;</tt><a name="(part._.Interacting_with_.Racket)"></a>Interacting with Racket</h4><p>DrRacket&rsquo;s bottom text area and the <span class="stt">racket</span> command-line program
+(when started with no options) both act as a kind of calculator. You
+type a Racket expression, hit the Return key, and the answer is
+printed. In the terminology of Racket, this kind of calculator is
+called a <span style="font-style: italic">read-eval-print loop</span> or <a name="(tech._repl)"></a><span style="font-style: italic">REPL</span>.</p><p>A number by itself is an expression, and the answer is just the
+number:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktVal">5</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr></table></blockquote><p>A string is also an expression that evaluates to itself. A string is
+written with double quotes at the start and end of the string:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktVal">"Hello, world!"</span></td></tr><tr><td><p><span class="RktRes">"Hello, world!"</span></p></td></tr></table></blockquote><p>Racket uses parentheses to wrap larger expressions&#8212;<wbr></wbr>almost any kind
+of expression, other than simple constants. For example, a function
+call is written: open parenthesis, function name, argument
+expression, and closing parenthesis. The following expression calls
+the built-in function <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._substring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">substring</a></span> with the arguments
+<span class="RktVal">"the boy out of the country"</span>, <span class="RktVal">4</span>, and <span class="RktVal">7</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._substring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">substring</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"the boy out of the country"</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"boy"</span></p></td></tr></table></blockquote><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Definitions_and_Interactions&quot;">1.2<tt>&nbsp;</tt><a name="(part._.Definitions_and_.Interactions)"></a>Definitions and Interactions</h4><p>You can define your own functions that work like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._substring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">substring</a></span> by
+using the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> form, like this:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">extract</span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._substring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">substring</a></span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">extract</span><span class="hspace">&nbsp;</span><span class="RktVal">"the boy out of the country"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"boy"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">extract</span><span class="hspace">&nbsp;</span><span class="RktVal">"the country out of the boy"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"cou"</span></p></td></tr></table></td></tr></table></blockquote><p>Although you can evaluate the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> form in the <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>,
+definitions are normally a part of a program that you want to keep and
+use later. So, in DrRacket, you&rsquo;d normally put the definition in the
+top text area&#8212;<wbr></wbr>called the <a name="(tech._definitions._area)"></a><span style="font-style: italic">definitions area</span>&#8212;<wbr></wbr>along with the
+<a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> prefix:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">extract</span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._substring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">substring</a></span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>If calling <span class="RktPn">(</span><span class="RktSym">extract</span><span class="stt"> </span><span class="RktVal">"the boy"</span><span class="RktPn">)</span> is part of the main action of
+your program, that would go in the <a href="intro.html#%28tech._definitions._area%29" class="techoutside" data-pltdoc="x"><span class="techinside">definitions area</span></a>, too. But
+if it was just an example expression that you were using to explore
+<span class="RktSym">extract</span>, then you&rsquo;d more likely leave the <a href="intro.html#%28tech._definitions._area%29" class="techoutside" data-pltdoc="x"><span class="techinside">definitions
+area</span></a> as above, click <span class="ssansserif">Run</span>, and then evaluate
+<span class="RktPn">(</span><span class="RktSym">extract</span><span class="stt"> </span><span class="RktVal">"the boy"</span><span class="RktPn">)</span> in the <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>.</p><p>When using command-line <span class="stt">racket</span> instead of DrRacket, you&rsquo;d save
+the above text in a file using your favorite editor. If you save it as
+<span class="stt">"extract.rkt"</span>, then after starting <span class="stt">racket</span> in the same
+directory, you&rsquo;d evaluate the following sequence:</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>If you use <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=xrepl&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">xrepl</span></a>, you can use
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=xrepl&amp;rel=index.html%23%2528xrepl._enter%2529&amp;version=8.6" class="plainlink Sq" data-pltdoc="x"><span class="RktInBG"><span class="hspace"></span><span class="RktIn">,enter extract.rkt</span><span class="hspace"></span></span></a>.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=interactive.html%23%2528form._%2528%2528lib._racket%252Fenter..rkt%2529._enter%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">enter!</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"extract.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">extract</span><span class="hspace">&nbsp;</span><span class="RktVal">"the gal out of the city"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"gal"</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=interactive.html%23%2528form._%2528%2528lib._racket%252Fenter..rkt%2529._enter%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">enter!</a></span> form both loads the code and switches the
+evaluation context to the inside of the module, just like DrRacket&rsquo;s
+<span class="ssansserif">Run</span> button.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Creating_Executables&quot;">1.3<tt>&nbsp;</tt><a name="(part._.Creating_.Executables)"></a>Creating Executables</h4><p>If your file (or <a href="intro.html#%28tech._definitions._area%29" class="techoutside" data-pltdoc="x"><span class="techinside">definitions area</span></a> in DrRacket) contains</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">extract</span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._substring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">substring</a></span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">extract</span><span class="hspace">&nbsp;</span><span class="RktVal">"the cat out of the bag"</span><span class="RktPn">)</span></td></tr></table></blockquote><p>then it is a complete program that prints &ldquo;cat&rdquo; when run. You can
+run the program within DrRacket or using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=interactive.html%23%2528form._%2528%2528lib._racket%252Fenter..rkt%2529._enter%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">enter!</a></span> in
+<span class="stt">racket</span>, but if the program is saved in <span class="sroman">&#8249;<span style="font-style: italic">src-filename</span>&#8250;</span>,
+you can also run it from a command line with</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">racket </span><span class="sroman">&#8249;<span style="font-style: italic">src-filename</span>&#8250;</span></p><p>To package the program as an executable, you have a few options:</p><ul><li><p>In DrRacket, you can select the <span class="ssansserif">Racket|Create
+       Executable...</span> menu item.</p></li><li><p>From a command-line prompt, run <span class="stt">raco exe</span><span class="stt">
+</span><span class="sroman">&#8249;<span style="font-style: italic">src-filename</span>&#8250;</span>, where <span class="sroman">&#8249;<span style="font-style: italic">src-filename</span>&#8250;</span> contains
+the program. See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=exe.html&amp;version=8.6" class="Sq" data-pltdoc="x"><span class="stt">raco exe</span>: Creating Stand-Alone Executables</a> for more information.</p></li><li><p>With Unix or Mac OS, you can turn the program file into an
+executable script by inserting the line</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See <a href="scripts.html" data-pltdoc="x">Scripts</a> for more information on
+script files.</p></blockquote></blockquote></blockquote><p><table cellspacing="0" cellpadding="0" class="SVerbatim"><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">#! /usr/bin/env racket</span></p></td></tr></table></p><p>at the very beginning of the file. Also, change the file
+permissions to executable using <span class="stt">chmod +x</span><span class="stt">
+</span><span class="sroman">&#8249;<span style="font-style: italic">filename</span>&#8250;</span> on the command line.</p><p>The script works as long as <span class="stt">racket</span> is in the user&rsquo;s
+executable search path.  Alternately, use a full path to
+<span class="stt">racket</span> after <span class="stt">#!</span>  (with a space between <span class="stt">#!</span>
+and the path), in which case the user&rsquo;s executable search path
+does not matter.</p></li></ul><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;use-module&quot;">1.4<tt>&nbsp;</tt><a name="(part._use-module)"></a>A Note to Readers with Lisp/Scheme Experience</h4><p>If you already know something about Scheme or Lisp, you might be
+tempted to put just</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">extract</span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._substring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">substring</a></span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>into <span class="stt">"extract.rktl"</span> and run <span class="stt">racket</span> with</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._load%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">load</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"extract.rktl"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">extract</span><span class="hspace">&nbsp;</span><span class="RktVal">"the dog out"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"dog"</span></p></td></tr></table></blockquote><p>That will work, because <span class="stt">racket</span> is willing to imitate a
+traditional Lisp environment, but we strongly recommend against using
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._load%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">load</a></span> or writing programs outside of a module.</p><p>Writing definitions outside of a module leads to bad error messages,
+bad performance, and awkward scripting to combine and run
+programs. The problems are not specific to <span class="stt">racket</span>; they&rsquo;re
+fundamental limitations of the traditional top-level environment,
+which Scheme and Lisp implementations have historically fought with ad
+hoc command-line flags, compiler directives, and build tools. The
+module system is designed to avoid these problems, so start with
+<a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a>, and you&rsquo;ll be happier with Racket in the long run.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="index.html" title="backward to &quot;The Racket Guide&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="to-scheme.html" title="forward to &quot;2 Racket Essentials&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/io-patterns.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/io-patterns.html
new file mode 100644
index 00000000..30ad4e52
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/io-patterns.html
@@ -0,0 +1,19 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>8.6&nbsp;I/O Patterns</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Varieties of Ports</a></td></tr><tr><td align="right">8.2&nbsp;</td><td><a href="default-ports.html" class="tocviewlink" data-pltdoc="x">Default Ports</a></td></tr><tr><td align="right">8.3&nbsp;</td><td><a href="read-write.html" class="tocviewlink" data-pltdoc="x">Reading and Writing Racket Data</a></td></tr><tr><td align="right">8.4&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Datatypes and Serialization</a></td></tr><tr><td align="right">8.5&nbsp;</td><td><a href="encodings.html" class="tocviewlink" data-pltdoc="x">Bytes, Characters, and Encodings</a></td></tr><tr><td align="right">8.6&nbsp;</td><td><a href="io-patterns.html" class="tocviewselflink" data-pltdoc="x">I/<span class="mywbr"> &nbsp;</span>O Patterns</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="encodings.html" title="backward to &quot;8.5 Bytes, Characters, and Encodings&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="i_o.html" title="up to &quot;8 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="regexp.html" title="forward to &quot;9 Regular Expressions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;io-patterns&quot;">8.6<tt>&nbsp;</tt><a name="(part._io-patterns)"></a>I/O Patterns</h4><p>For these examples, say you have two files in the same directory as
+your program, <span class="stt">"oneline.txt"</span> and <span class="stt">"manylines.txt"</span>.</p><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"oneline.txt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="SVerbatim"><tr><td><p><span class="hspace">&nbsp;</span><span class="stt">I am one line, but there is an empty line after this one.</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;</span><span class="stt"></span></p></td></tr></table></blockquote></blockquote><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"manylines.txt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="SVerbatim"><tr><td><p><span class="hspace">&nbsp;</span><span class="stt">I am</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;</span><span class="stt">a message</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;</span><span class="stt">split over a few lines.</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;</span><span class="stt"></span></p></td></tr></table></blockquote></blockquote><p>If you have a file that is quite small, you can get
+away with reading in the file as a string:</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">file-contents</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-lib.html%23%2528def._%2528%2528lib._racket%252Fport..rkt%2529._port-%7E3estring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">port-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=file-ports.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._open-input-file%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">open-input-file</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"oneline.txt"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:close?</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-suffix%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-suffix?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">file-contents</span><span class="hspace">&nbsp;</span><span class="RktVal">"after this one."</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-suffix%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-suffix?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">file-contents</span><span class="hspace">&nbsp;</span><span class="RktVal">"after this one.\n"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-suffix%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-suffix?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-trim%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-trim</a></span><span class="hspace">&nbsp;</span><span class="RktSym">file-contents</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"after this one."</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p>We use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-lib.html%23%2528def._%2528%2528lib._racket%252Fport..rkt%2529._port-%7E3estring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">port-&gt;string</a></span> from <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-lib.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/port</span></a> to do the
+reading to a string: the <span class="RktPn">#:close?</span><span class="stt"> </span><span class="RktVal">#t</span> keyword argument ensures
+that our file is closed after the read.</p><p>We use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-trim%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-trim</a></span> from <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528mod-path._racket%252Fstring%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/string</span></a> to remove
+any extraneous whitespace at the very beginning and very end of our file.
+(Lots of formatters out there insist that text files end with a single
+blank line).</p><p>See also <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-line%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-line</a></span> if your file has one line of text.</p><p>If, instead, you want to process individual lines of a file, then you can
+use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span> with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-lines%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-lines</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">upcase-all</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-lines%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-lines</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-upcase%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-upcase</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Output.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._newline%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">newline</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">upcase-all</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stringport.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._open-input-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">open-input-string</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"Hello, World!\n"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"Can you hear me, now?"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">HELLO, WORLD!</span></p></td></tr><tr><td><p><span class="RktOut">CAN YOU HEAR ME, NOW?</span></p></td></tr></table></td></tr></table></blockquote><p>You could also combine computations over each line. So if you want to
+know how many lines contain &ldquo;m&rdquo;, you could do:</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=file-ports.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._with-input-from-file%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">with-input-from-file</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"manylines.txt"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Fsum%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/sum</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-lines%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-lines</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:when</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-contains%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-contains?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktVal">"m"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p><p>Here, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=file-ports.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._with-input-from-file%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">with-input-from-file</a></span> from <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-lib.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/port</span></a> sets
+the default input port to be the file <span class="stt">"manylines.txt"</span> inside
+the thunk. It also closes the file after the computation has been
+completed (and in a few other cases).</p><p>However, if you want to determine whether &ldquo;hello&rdquo; appears in a file,
+then you could search separate lines, but it&rsquo;s even easier to simply
+apply a regular expression (see <a href="regexp.html" data-pltdoc="x">Regular Expressions</a>) to the stream:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">has-hello?</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"hello"</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">has-hello?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stringport.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._open-input-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">has-hello?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stringport.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._open-input-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"goodbye"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote><p>If you want to copy one port into another, use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-lib.html%23%2528def._%2528%2528lib._racket%252Fport..rkt%2529._copy-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">copy-port</a></span> from
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-lib.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/port</span></a>, which efficiently transfers large blocks
+when lots of data is available, but also transfers small blocks
+immediately if that&rsquo;s all that is available:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stringport.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._open-output-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">open-output-string</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-lib.html%23%2528def._%2528%2528lib._racket%252Fport..rkt%2529._copy-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">copy-port</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stringport.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._open-input-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"broom"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stringport.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._get-output-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">get-output-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"broom"</span></p></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="encodings.html" title="backward to &quot;8.5 Bytes, Characters, and Encodings&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="i_o.html" title="up to &quot;8 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="regexp.html" title="forward to &quot;9 Regular Expressions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/keywords.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/keywords.html
new file mode 100644
index 00000000..909f0a70
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/keywords.html
@@ -0,0 +1,14 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.7&nbsp;Keywords</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewselflink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings (Unicode)</a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Bytes and Byte Strings</a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="keywords.html" class="tocviewselflink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="hash-tables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="void_undefined.html" class="tocviewlink" data-pltdoc="x">Void and Undefined</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="symbols.html" title="backward to &quot;3.6 Symbols&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="pairs.html" title="forward to &quot;3.8 Pairs and Lists&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;keywords&quot;">3.7<tt>&nbsp;</tt><a name="(part._keywords)"></a>Keywords</h4><p>A <a name="(tech._keyword)"></a><span style="font-style: italic">keyword</span> value is similar to a symbol (see
+<a href="symbols.html" data-pltdoc="x">Symbols</a>), but its printed form is prefixed with
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#:</span><span class="hspace"></span></span>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528part._parse-keyword%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Reading Keywords</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> documents the fine points of the syntax of keywords.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=keywords.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-%7E3ekeyword%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-&gt;keyword</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#:apple</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">'</span><span class="RktVal">#:apple</span></td></tr><tr><td><p><span class="RktRes">'#:apple</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">#:apple</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=keywords.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-%7E3ekeyword%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-&gt;keyword</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p>More precisely, a keyword is analogous to an identifier; in the same
+way that an identifier can be quoted to produce a symbol, a keyword
+can be quoted to produce a value. The same term &ldquo;keyword&rdquo; is used in
+both cases, but we sometimes use <span style="font-style: italic">keyword value</span> to refer more
+specifically to the result of a quote-keyword expression or of
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=keywords.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-%7E3ekeyword%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-&gt;keyword</a></span>. An unquoted keyword is not an expression,
+just as an unquoted identifier does not produce a symbol:</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktSym">not-a-symbol-expression</span></td></tr><tr><td><p><span class="RktErr">not-a-symbol-expression: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">#:not-a-keyword-expression</span></td></tr><tr><td><p><span class="RktErr">eval:2:0: #%datum: keyword misused as an expression</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: #:not-a-keyword-expression</span></p></td></tr></table></blockquote></div></p><p>Despite their similarities, keywords are used in a different way than
+identifiers or symbols. Keywords are intended for use (unquoted) as
+special markers in argument lists and in certain syntactic forms.  For
+run-time flags and enumerations, use symbols instead of keywords.  The
+example below illustrates the distinct roles of keywords and symbols.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dir</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Filesystem.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._find-system-path%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">find-system-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">temp-dir</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">not </span><span class="RktVal">'</span><span class="RktVal">#:temp-dir</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=file-ports.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._with-output-to-file%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">with-output-to-file</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Manipulating_Paths.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._build-path%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">build-path</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dir</span><span class="hspace">&nbsp;</span><span class="RktVal">"stuff.txt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"example\n"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">optional </span><span class="RktPn">#:mode</span><span class="RktCmt"> argument can be </span><span class="RktVal">'</span><span class="RktVal">text</span><span class="RktCmt"> or </span><span class="RktVal">'</span><span class="RktVal">binary</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:mode</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">text</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">optional </span><span class="RktPn">#:exists</span><span class="RktCmt"> argument can be </span><span class="RktVal">'</span><span class="RktVal">replace</span><span class="RktCmt">, </span><span class="RktVal">'</span><span class="RktVal">truncate</span><span class="RktCmt">, ...</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">#:exists</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">replace</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="symbols.html" title="backward to &quot;3.6 Symbols&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="pairs.html" title="forward to &quot;3.8 Pairs and Lists&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/lambda.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/lambda.html
new file mode 100644
index 00000000..b77bbeaf
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/lambda.html
@@ -0,0 +1,39 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.4&nbsp;Functions: lambda</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewselflink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="syntax-notation.html" class="tocviewlink" data-pltdoc="x">Notation</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="binding.html" class="tocviewlink" data-pltdoc="x">Identifiers and Binding</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Function Calls</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="lambda.html" class="tocviewselflink" data-pltdoc="x">Functions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span></a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span></a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="conditionals.html" class="tocviewlink" data-pltdoc="x">Conditionals</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span></a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktVal">&rsquo;</span></a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="qq.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span> and <span class="RktVal">&lsquo;</span></a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Simple Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="parameterize.html" class="tocviewlink" data-pltdoc="x">Dynamic Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">parameterize</span></span></a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.4&nbsp;</td><td><a href="lambda.html" class="tocviewselflink" data-pltdoc="x">Functions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span></a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.4.1&nbsp;</td><td><a href="lambda.html#%28part._rest-args%29" class="tocviewlink" data-pltdoc="x">Declaring a Rest Argument</a></td></tr><tr><td align="right">4.4.2&nbsp;</td><td><a href="lambda.html#%28part._.Declaring_.Optional_.Arguments%29" class="tocviewlink" data-pltdoc="x">Declaring Optional Arguments</a></td></tr><tr><td align="right">4.4.3&nbsp;</td><td><a href="lambda.html#%28part._lambda-keywords%29" class="tocviewlink" data-pltdoc="x">Declaring Keyword Arguments</a></td></tr><tr><td align="right">4.4.4&nbsp;</td><td><a href="lambda.html#%28part._case-lambda%29" class="tocviewlink" data-pltdoc="x">Arity-<wbr></wbr>Sensitive Functions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">4.4.1<tt>&nbsp;</tt></span><a href="lambda.html#%28part._rest-args%29" class="tocsubseclink" data-pltdoc="x">Declaring a Rest Argument</a></td></tr><tr><td><span class="tocsublinknumber">4.4.2<tt>&nbsp;</tt></span><a href="lambda.html#%28part._.Declaring_.Optional_.Arguments%29" class="tocsubseclink" data-pltdoc="x">Declaring Optional Arguments</a></td></tr><tr><td><span class="tocsublinknumber">4.4.3<tt>&nbsp;</tt></span><a href="lambda.html#%28part._lambda-keywords%29" class="tocsubseclink" data-pltdoc="x">Declaring Keyword Arguments</a></td></tr><tr><td><span class="tocsublinknumber">4.4.4<tt>&nbsp;</tt></span><a href="lambda.html#%28part._case-lambda%29" class="tocsubseclink" data-pltdoc="x">Arity-<wbr></wbr>Sensitive Functions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case-<wbr></wbr>lambda</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="application.html" title="backward to &quot;4.3 Function Calls (Procedure Applications)&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="define.html" title="forward to &quot;4.5 Definitions: define&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;lambda&quot;">4.4<tt>&nbsp;</tt><a name="(part._lambda)"></a>Functions (Procedures): <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span></h4><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> expression creates a function. In the simplest
+case, a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> expression has the form</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">arg-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> form with <span style="font-style: italic">n</span> <span class="RktVar">arg-id</span>s accepts
+<span style="font-style: italic">n</span> arguments:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">arity mismatch;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">the expected number of arguments does not match the given</span></p></td></tr><tr><td><p><span class="RktErr">number</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: 2</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 1</span></p></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;rest-args&quot;">4.4.1<tt>&nbsp;</tt><a name="(part._rest-args)"></a>Declaring a Rest Argument</h5><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> expression can also have the form</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktVar">rest-id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote><p>That is, a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> expression can have a single
+<span class="RktVar">rest-id</span> that is not surrounded by parentheses. The resulting
+function accepts any number of arguments, and the arguments are put
+into a list bound to <span class="RktVar">rest-id</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(1 2 3)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></blockquote></div></p><p>Functions with a <span class="RktVar">rest-id</span> often use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span> to call
+another function that accepts any number of arguments.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="application.html#%28part._apply%29" data-pltdoc="x">The <span class="RktSym"><span class="RktValLink">apply</span></span> Function</a> describes <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span>.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">max-mag</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nums</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._max%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">max</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._magnitude%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">magnitude</a></span><span class="hspace">&nbsp;</span><span class="RktSym">nums</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._max%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">max</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-2</span></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">max-mag</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-2</span></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> form also supports required arguments combined
+with a <span class="RktVar">rest-id</span>:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">arg-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">rest-id</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote><p>The result of this form is a function that requires at least as many
+arguments as <span class="RktVar">arg-id</span>s, and also accepts any number of
+additional arguments.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">max-mag</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">num</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">nums</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._max%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">max</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._magnitude%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">magnitude</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">num</span><span class="hspace">&nbsp;</span><span class="RktSym">nums</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">max-mag</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-2</span></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">max-mag</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">max-mag: arity mismatch;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">the expected number of arguments does not match the given</span></p></td></tr><tr><td><p><span class="RktErr">number</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: at least 1</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 0</span></p></td></tr></table></blockquote></div></p><p>A <span class="RktVar">rest-id</span> variable is sometimes called a <a name="(tech._rest._argument)"></a><span style="font-style: italic">rest
+argument</span>, because it accepts the &ldquo;rest&rdquo; of the function arguments.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Declaring_Optional_Arguments&quot;">4.4.2<tt>&nbsp;</tt><a name="(part._.Declaring_.Optional_.Arguments)"></a>Declaring Optional Arguments</h5><p>Instead of just an identifier, an argument (other than a rest
+argument) in a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> form can be specified with an
+identifier and a default value:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktVar">gen-formals</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">gen-formals</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">rest-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">rest-id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">arg</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">arg-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">arg-id</span><span class="hspace">&nbsp;</span><span class="RktVar">default-expr</span><span class="RktPn">]</span></td></tr></table></td></tr></table></blockquote></blockquote><p>An argument of the form <span class="RktPn">[</span><span class="RktSym">arg-id</span><span class="stt"> </span><span class="RktSym">default-expr</span><span class="RktPn">]</span> is
+optional. When the argument is not supplied in an application,
+<span class="RktVar">default-expr</span> produces the default value. The
+<span class="RktVar">default-expr</span> can refer to any preceding <span class="RktVar">arg-id</span>,
+and every following <span class="RktVar">arg-id</span> must have a default as well.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">greet</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">given</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">surname</span><span class="hspace">&nbsp;</span><span class="RktVal">"Smith"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Hello, "</span><span class="hspace">&nbsp;</span><span class="RktSym">given</span><span class="hspace">&nbsp;</span><span class="RktVal">" "</span><span class="hspace">&nbsp;</span><span class="RktSym">surname</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"John"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hello, John Smith"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"John"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Doe"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hello, John Doe"</span></p></td></tr></table></blockquote></div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">greet</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">given</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">surname</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">given</span><span class="hspace">&nbsp;</span><span class="RktVal">"John"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"Doe"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"Smith"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Hello, "</span><span class="hspace">&nbsp;</span><span class="RktSym">given</span><span class="hspace">&nbsp;</span><span class="RktVal">" "</span><span class="hspace">&nbsp;</span><span class="RktSym">surname</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"John"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hello, John Doe"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"Adam"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hello, Adam Smith"</span></p></td></tr></table></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;lambda-keywords&quot;">4.4.3<tt>&nbsp;</tt><a name="(part._lambda-keywords)"></a>Declaring Keyword Arguments</h5><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> form can declare an argument to be passed by
+keyword, instead of position. Keyword arguments can be mixed with
+by-position arguments, and default-value expressions can be supplied
+for either kind of argument:</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="application.html#%28part._keyword-args%29" data-pltdoc="x">Keyword Arguments</a> introduces function
+calls with keywords.</p></blockquote></blockquote></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktVar">gen-formals</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">gen-formals</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">rest-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">arg</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">rest-id</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">arg</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">arg-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">arg-id</span><span class="hspace">&nbsp;</span><span class="RktVar">default-expr</span><span class="RktPn">]</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">arg-keyword</span><span class="hspace">&nbsp;</span><span class="RktVar">arg-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">arg-keyword</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">arg-id</span><span class="hspace">&nbsp;</span><span class="RktVar">default-expr</span><span class="RktPn">]</span></td></tr></table></td></tr></table></blockquote></blockquote><p>An argument specified as <span class="RktVar">arg-keyword</span><span class="stt"> </span><span class="RktVar">arg-id</span> is
+supplied by an application using the same <span class="RktVar">arg-keyword</span>.  The
+position of the keyword&ndash;identifier pair in the argument list does not
+matter for matching with arguments in an application, because it will
+be matched to an argument value by keyword instead of by position.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">greet</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">given</span><span class="hspace">&nbsp;</span><span class="RktPn">#:last</span><span class="hspace">&nbsp;</span><span class="RktSym">surname</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Hello, "</span><span class="hspace">&nbsp;</span><span class="RktSym">given</span><span class="hspace">&nbsp;</span><span class="RktVal">" "</span><span class="hspace">&nbsp;</span><span class="RktSym">surname</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"John"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:last</span><span class="hspace">&nbsp;</span><span class="RktVal">"Smith"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hello, John Smith"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktPn">#:last</span><span class="hspace">&nbsp;</span><span class="RktVal">"Doe"</span><span class="hspace">&nbsp;</span><span class="RktVal">"John"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hello, John Doe"</span></p></td></tr></table></td></tr></table></blockquote><p>An <span class="RktVar">arg-keyword</span><span class="stt"> </span><span class="RktPn">[</span><span class="RktVar">arg-id</span><span class="stt"> </span><span class="RktVar">default-expr</span><span class="RktPn">]</span> argument
+specifies a keyword-based argument with a default value.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">greet</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">#:hi</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">hi</span><span class="hspace">&nbsp;</span><span class="RktVal">"Hello"</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktSym">given</span><span class="hspace">&nbsp;</span><span class="RktPn">#:last</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">surname</span><span class="hspace">&nbsp;</span><span class="RktVal">"Smith"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hi</span><span class="hspace">&nbsp;</span><span class="RktVal">", "</span><span class="hspace">&nbsp;</span><span class="RktSym">given</span><span class="hspace">&nbsp;</span><span class="RktVal">" "</span><span class="hspace">&nbsp;</span><span class="RktSym">surname</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"John"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hello, John Smith"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"Karl"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:last</span><span class="hspace">&nbsp;</span><span class="RktVal">"Marx"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hello, Karl Marx"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"John"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:hi</span><span class="hspace">&nbsp;</span><span class="RktVal">"Howdy"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Howdy, John Smith"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"Karl"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:last</span><span class="hspace">&nbsp;</span><span class="RktVal">"Marx"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:hi</span><span class="hspace">&nbsp;</span><span class="RktVal">"Guten Tag"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Guten Tag, Karl Marx"</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> form does not directly support the creation
+of a function that accepts &ldquo;rest&rdquo; keywords. To construct a
+function that accepts all keyword arguments, use
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._make-keyword-procedure%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-keyword-procedure</a></span>. The function supplied to
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._make-keyword-procedure%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-keyword-procedure</a></span> receives keyword arguments
+through parallel lists in the first two (by-position) arguments,
+and then all by-position arguments from an application as the
+remaining by-position arguments.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="application.html#%28part._apply%29" data-pltdoc="x">The <span class="RktSym"><span class="RktValLink">apply</span></span> Function</a> introduces <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._keyword-apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">keyword-apply</a></span>.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">trace-wrap</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._make-keyword-procedure%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-keyword-procedure</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">kws</span><span class="hspace">&nbsp;</span><span class="RktSym">kw-args</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">rest</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Called with ~s ~s ~s\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">kws</span><span class="hspace">&nbsp;</span><span class="RktSym">kw-args</span><span class="hspace">&nbsp;</span><span class="RktSym">rest</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._keyword-apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">keyword-apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">kws</span><span class="hspace">&nbsp;</span><span class="RktSym">kw-args</span><span class="hspace">&nbsp;</span><span class="RktSym">rest</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">trace-wrap</span><span class="hspace">&nbsp;</span><span class="RktSym">greet</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"John"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:hi</span><span class="hspace">&nbsp;</span><span class="RktVal">"Howdy"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Called with (#:hi) ("Howdy") ("John")</span></p></td></tr><tr><td><p><span class="RktRes">"Howdy, John Smith"</span></p></td></tr></table></blockquote></div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html&amp;version=8.6" class="Sq" data-pltdoc="x">Procedure Expressions: <span class="RktSym"><span class="RktStxLink">lambda</span></span> and <span class="RktSym"><span class="RktStxLink">case-lambda</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on function expressions.</p></blockquote></blockquote></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;case-lambda&quot;">4.4.4<tt>&nbsp;</tt><a name="(part._case-lambda)"></a>Arity-Sensitive Functions: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._case-lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case-lambda</a></span></h5><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._case-lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case-lambda</a></span> form creates a function that can have
+completely different behaviors depending on the number of arguments
+that are supplied. A case-lambda expression has the form</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._case-lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case-lambda</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVar">formals</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">formals</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">arg-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">rest-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">arg-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVar">rest-id</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote><p>where each <span class="RktPn">[</span><span class="RktVar">formals</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktSym">...+</span><span class="RktPn">]</span> is analogous to <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktVar">formals</span><span class="stt"> </span><span class="RktVar">body</span><span class="stt"> </span><span class="RktSym">...+</span><span class="RktPn">)</span>. Applying a function produced by
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._case-lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case-lambda</a></span> is like applying a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> for the first
+case that matches the number of given arguments.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">greet</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._case-lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case-lambda</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Hello, "</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">given</span><span class="hspace">&nbsp;</span><span class="RktSym">surname</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Hello, "</span><span class="hspace">&nbsp;</span><span class="RktSym">given</span><span class="hspace">&nbsp;</span><span class="RktVal">" "</span><span class="hspace">&nbsp;</span><span class="RktSym">surname</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"John"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hello, John"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"John"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Smith"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hello, John Smith"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">greet: arity mismatch;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">the expected number of arguments does not match the given</span></p></td></tr><tr><td><p><span class="RktErr">number</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 0</span></p></td></tr></table></blockquote></div></p><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._case-lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case-lambda</a></span> function cannot directly support optional or
+keyword arguments.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="application.html" title="backward to &quot;4.3 Function Calls (Procedure Applications)&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="define.html" title="forward to &quot;4.5 Definitions: define&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/language-collection.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/language-collection.html
new file mode 100644
index 00000000..b505a68f
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/language-collection.html
@@ -0,0 +1,21 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>17.3.4&nbsp;Installing a Language</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewselflink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">17.1&nbsp;</td><td><a href="module-languages.html" class="tocviewlink" data-pltdoc="x">Module Languages</a></td></tr><tr><td align="right">17.2&nbsp;</td><td><a href="hash-reader.html" class="tocviewlink" data-pltdoc="x">Reader Extensions</a></td></tr><tr><td align="right">17.3&nbsp;</td><td><a href="hash-languages.html" class="tocviewselflink" data-pltdoc="x">Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>17.3&nbsp;</td><td><a href="hash-languages.html" class="tocviewlink" data-pltdoc="x">Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">17.3.1&nbsp;</td><td><a href="hash-lang_syntax.html" class="tocviewlink" data-pltdoc="x">Designating a <span class="RktModLink"><span class="RktMod">#lang</span></span> Language</a></td></tr><tr><td align="right">17.3.2&nbsp;</td><td><a href="hash-lang_reader.html" class="tocviewlink" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">reader</span></span></a></td></tr><tr><td align="right">17.3.3&nbsp;</td><td><a href="syntax_module-reader.html" class="tocviewlink" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">s-<wbr></wbr>exp</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">syntax/<span class="mywbr"> &nbsp;</span>module-<wbr></wbr>reader</span></span></a></td></tr><tr><td align="right">17.3.4&nbsp;</td><td><a href="language-collection.html" class="tocviewselflink" data-pltdoc="x">Installing a Language</a></td></tr><tr><td align="right">17.3.5&nbsp;</td><td><a href="language-get-info.html" class="tocviewlink" data-pltdoc="x">Source-<wbr></wbr>Handling Configuration</a></td></tr><tr><td align="right">17.3.6&nbsp;</td><td><a href="module-runtime-config.html" class="tocviewlink" data-pltdoc="x">Module-<wbr></wbr>Handling Configuration</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="syntax_module-reader.html" title="backward to &quot;17.3.3 Using #lang s-exp syntax/module-reader&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="hash-languages.html" title="up to &quot;17.3 Defining new #lang Languages&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="language-get-info.html" title="forward to &quot;17.3.5 Source-Handling Configuration&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;language-collection&quot;">17.3.4<tt>&nbsp;</tt><a name="(part._language-collection)"></a>Installing a Language</h5><p>So far, we have used the <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._reader%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">reader</span></a> meta-language to
+access languages like <span class="stt">"literal.rkt"</span> and
+<span class="stt">"dollar-racket.rkt"</span>. If you want to use something like
+<a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="stt"> </span><span class="RktSym">literal</span> directly, then you must move
+<span class="stt">"literal.rkt"</span> into a Racket <a href="module-basics.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection</span></a> named
+<span class="stt">"literal"</span> (see also <a href="module-basics.html#%28part._link-collection%29" data-pltdoc="x">Adding Collections</a>).
+Specifically, move <span class="stt">"literal.rkt"</span> to a <span class="RktSym">reader</span>
+submodule of <span class="stt">"literal/main.rkt"</span> for any directory name
+<span class="stt">"literal"</span>, like so:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"literal/main.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">reader</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">syntax/strip-context</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._rename-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">rename-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">literal-read</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">literal-read-syntax</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-syntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-syntax</a></span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">literal-read</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-%7E3edatum%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-&gt;datum</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">literal-read-syntax</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">literal-read-syntax</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._with-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">str</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">port-&gt;string</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=syntax-helpers.html%23%2528def._%2528%2528lib._syntax%252Fstrip-context..rkt%2529._strip-context%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">strip-context</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">anything</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">data</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">data</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">str</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>Then, install the <span class="stt">"literal"</span>
+directory as a package:</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">cd /path/to/literal ;&#160;raco pkg install</span></p><p>After moving the file and installing the package, you can use
+<span class="RktSym">literal</span> directly after <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><span class="RktSym">literal</span></td></tr><tr><td><span class="RktSym">Technology!</span></td></tr><tr><td><span class="RktSym">System!</span></td></tr><tr><td><span class="RktSym">Perfect!</span></td></tr></table></blockquote><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x"><span class="stt">raco</span>: Racket Command-Line Tools</a>
+for more information on using <span class="stt">raco</span>.</p></blockquote></blockquote></blockquote><p>You can also make your language available for others to install by
+using the Racket package manager (see <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=pkg&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">Package Management in Racket</a>). After you create a <span class="stt">"literal"</span>
+package and register it with the Racket package catalog (see
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=pkg&amp;rel=Package_Concepts.html%23%2528part._concept%7E3acatalog%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Package Catalogs</a>),
+others can install it using <span class="stt">raco pkg</span>:</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">raco pkg install literal</span></p><p>Once installed, others can invoke the language the same way: by using
+<a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="stt"> </span><span class="RktSym">literal</span> at the top of a source file.</p><p>If you use a public source repository (e.g., GitHub), you can link
+your package to the source. As you improve the package, others can
+update their version using <span class="stt">raco pkg</span>:</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">raco pkg update literal</span></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=pkg&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">Package Management in Racket</a> for more
+information about the Racket package manager.</p></blockquote></blockquote></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="syntax_module-reader.html" title="backward to &quot;17.3.3 Using #lang s-exp syntax/module-reader&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="hash-languages.html" title="up to &quot;17.3 Defining new #lang Languages&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="language-get-info.html" title="forward to &quot;17.3.5 Source-Handling Configuration&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/language-get-info.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/language-get-info.html
new file mode 100644
index 00000000..b2bd2d31
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/language-get-info.html
@@ -0,0 +1,48 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>17.3.5&nbsp;Source-Handling Configuration</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewselflink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">17.1&nbsp;</td><td><a href="module-languages.html" class="tocviewlink" data-pltdoc="x">Module Languages</a></td></tr><tr><td align="right">17.2&nbsp;</td><td><a href="hash-reader.html" class="tocviewlink" data-pltdoc="x">Reader Extensions</a></td></tr><tr><td align="right">17.3&nbsp;</td><td><a href="hash-languages.html" class="tocviewselflink" data-pltdoc="x">Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>17.3&nbsp;</td><td><a href="hash-languages.html" class="tocviewlink" data-pltdoc="x">Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">17.3.1&nbsp;</td><td><a href="hash-lang_syntax.html" class="tocviewlink" data-pltdoc="x">Designating a <span class="RktModLink"><span class="RktMod">#lang</span></span> Language</a></td></tr><tr><td align="right">17.3.2&nbsp;</td><td><a href="hash-lang_reader.html" class="tocviewlink" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">reader</span></span></a></td></tr><tr><td align="right">17.3.3&nbsp;</td><td><a href="syntax_module-reader.html" class="tocviewlink" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">s-<wbr></wbr>exp</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">syntax/<span class="mywbr"> &nbsp;</span>module-<wbr></wbr>reader</span></span></a></td></tr><tr><td align="right">17.3.4&nbsp;</td><td><a href="language-collection.html" class="tocviewlink" data-pltdoc="x">Installing a Language</a></td></tr><tr><td align="right">17.3.5&nbsp;</td><td><a href="language-get-info.html" class="tocviewselflink" data-pltdoc="x">Source-<wbr></wbr>Handling Configuration</a></td></tr><tr><td align="right">17.3.6&nbsp;</td><td><a href="module-runtime-config.html" class="tocviewlink" data-pltdoc="x">Module-<wbr></wbr>Handling Configuration</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="language-collection.html" title="backward to &quot;17.3.4 Installing a Language&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="hash-languages.html" title="up to &quot;17.3 Defining new #lang Languages&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="module-runtime-config.html" title="forward to &quot;17.3.6 Module-Handling Configuration&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;language-get-info&quot;">17.3.5<tt>&nbsp;</tt><a name="(part._language-get-info)"></a>Source-Handling Configuration</h5><p>The Racket distribution includes a Scribble language for writing prose
+documents, where Scribble extends the normal Racket to better support
+text. Here is an example Scribble document:</p><p><table cellspacing="0" cellpadding="0" class="SVerbatim"><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">#lang scribble/base</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">@(define (get-name) "Self-Describing Document")</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">@title[(get-name)]</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">The title of this document is ``@(get-name).''</span></p></td></tr></table></p><p>If you put that program in DrRacket&rsquo;s <a href="intro.html#%28tech._definitions._area%29" class="techoutside" data-pltdoc="x"><span class="techinside">definitions area</span></a> and
+click <span class="ssansserif">Run</span>, then nothing much appears to happen. The
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=scribble&amp;rel=base.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">scribble/base</span></a> language just binds and exports
+<span class="RktSym">doc</span> as a description of a document, similar to the way
+that <span class="stt">"literal.rkt"</span> exports a string as <span class="RktSym">data</span>.</p><p>Simply opening a module with the language
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=scribble&amp;rel=base.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">scribble/base</span></a> in DrRacket, however, causes a
+<span class="ssansserif">Scribble HTML</span> button to appear. Furthermore, DrRacket knows
+how to colorize Scribble syntax by coloring green those parts of the
+document that correspond to literal text. The language name
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=scribble&amp;rel=base.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">scribble/base</span></a> is not hard-wired into
+DrRacket. Instead, the implementation of the
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=scribble&amp;rel=base.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">scribble/base</span></a> language provides button and
+syntax-coloring information in response to a query from DrRacket.</p><p>If you have installed the <span class="RktSym">literal</span> language as described in
+<a href="language-collection.html" data-pltdoc="x">Installing a Language</a>, then you can adjust
+<span class="stt">"literal/main.rkt"</span> so that DrRacket treats the content
+of a module in the <span class="RktSym">literal</span> language as plain text instead of
+(erroneously) as Racket syntax:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"literal/main.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">reader</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">syntax/strip-context</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._rename-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">rename-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">literal-read</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">literal-read-syntax</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-syntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-syntax</a></span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">get-info</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">literal-read</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-%7E3edatum%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-&gt;datum</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">literal-read-syntax</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">literal-read-syntax</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._with-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">str</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">port-&gt;string</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=syntax-helpers.html%23%2528def._%2528%2528lib._syntax%252Fstrip-context..rkt%2529._strip-context%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">strip-context</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">anything</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">data</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">data</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">str</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-info</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="hspace">&nbsp;</span><span class="RktSym">mod</span><span class="hspace">&nbsp;</span><span class="RktSym">line</span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="hspace">&nbsp;</span><span class="RktSym">pos</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">key</span><span class="hspace">&nbsp;</span><span class="RktSym">default</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=case.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">key</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">color-lexer</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Module_Names_and_Loading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._dynamic-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">dynamic-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">syntax-color/default-lexer</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">default-lexer</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktSym">default</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>This revised <span class="RktSym">literal</span> implementation provides a
+<span class="RktSym">get-info</span> function. The <span class="RktSym">get-info</span> function
+is called by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-language%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-language</a></span> (which DrRacket calls) with the
+source input stream and location information,
+in case query results should depend on the content of the module after
+the language name (which is not the case for <span class="RktSym">literal</span>). The
+result of <span class="RktSym">get-info</span> is a function of two arguments. The
+first argument is always a symbol, indicating the kind of information
+that a tool requests from the language; the second argument is the
+default result to be returned if the language does not recognize the
+query or has no information for it.</p><p>After DrRacket obtains the result of <span class="RktSym">get-info</span> for a
+language, it calls the function with a <span class="RktVal">'</span><span class="RktVal">color-lexer</span> query;
+the result should be a function that implements syntax-coloring
+parsing on an input stream. For <span class="RktSym">literal</span>, the
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax-color&amp;rel=Default_Lexer.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">syntax-color/default-lexer</span></a> module provides a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax-color&amp;rel=Default_Lexer.html%23%2528def._%2528%2528lib._syntax-color%252Fdefault-lexer..rkt%2529._default-lexer%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">default-lexer</a></span> syntax-coloring parser that is suitable for
+plain text, so <span class="RktSym">literal</span> loads and returns that parser in
+response to a <span class="RktVal">'</span><span class="RktVal">color-lexer</span> query.</p><p>The set of symbols that a programming tool uses for queries
+is entirely between the tool and the languages that choose to
+cooperate with it. For example, in addition to <span class="RktVal">'</span><span class="RktVal">color-lexer</span>,
+DrRacket uses a <span class="RktVal">'</span><span class="RktVal">drracket:toolbar-buttons</span> query to determine
+which buttons should be available in the toolbar to operate on modules
+using the language.</p><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=reader-helpers.html%23%2528mod-path._syntax%252Fmodule-reader%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">syntax/module-reader</span></a> language lets you specify
+<span class="RktSym">get-info</span> handling through a <span class="RktPn">#:info</span> optional
+specification. The protocol for an <span class="RktPn">#:info</span> function is
+slightly different from the raw <span class="RktSym">get-info</span> protocol; the
+revised protocol allows <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=reader-helpers.html%23%2528mod-path._syntax%252Fmodule-reader%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">syntax/module-reader</span></a> the
+possibility of handling future language-information queries
+automatically.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="language-collection.html" title="backward to &quot;17.3.4 Installing a Language&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="hash-languages.html" title="up to &quot;17.3 Defining new #lang Languages&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="module-runtime-config.html" title="forward to &quot;17.3.6 Module-Handling Configuration&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/languages.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/languages.html
new file mode 100644
index 00000000..a0871579
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/languages.html
@@ -0,0 +1,14 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>17&nbsp;Creating Languages</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewselflink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>17&nbsp;</td><td><a href="languages.html" class="tocviewselflink" data-pltdoc="x">Creating Languages</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">17.1&nbsp;</td><td><a href="module-languages.html" class="tocviewlink" data-pltdoc="x">Module Languages</a></td></tr><tr><td align="right">17.2&nbsp;</td><td><a href="hash-reader.html" class="tocviewlink" data-pltdoc="x">Reader Extensions</a></td></tr><tr><td align="right">17.3&nbsp;</td><td><a href="hash-languages.html" class="tocviewlink" data-pltdoc="x">Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="macro-module.html" title="backward to &quot;16.3 Module Instantiations and Visits&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="module-languages.html" title="forward to &quot;17.1 Module Languages&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;languages&quot;">17<tt>&nbsp;</tt><a name="(part._languages)"></a>Creating Languages</h3><p>The <a href="macros.html#%28tech._macro%29" class="techoutside" data-pltdoc="x"><span class="techinside">macro</span></a> facilities defined in the preceding chapter let a
+programmer define syntactic extensions to a language, but a macro is
+limited in two ways:</p><ul><li><p>a macro cannot restrict the syntax available in its context or
+change the meaning of surrounding forms; and</p></li><li><p>a macro can extend the syntax of a language only within the
+parameters of the language&rsquo;s lexical conventions, such as using
+parentheses to group the macro name with its subforms and using
+the core syntax of identifiers, keywords, and literals.</p></li></ul><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span>The distinction between the <a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._reader%29" class="techoutside" data-pltdoc="x"><span class="techinside">reader</span></a> and
+<a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._expander%29" class="techoutside" data-pltdoc="x"><span class="techinside">expander</span></a> layer is introduced in <a href="Pairs__Lists__and_Racket_Syntax.html#%28part._lists-and-syntax%29" data-pltdoc="x">Lists and Racket Syntax</a>.</p></blockquote></blockquote></blockquote><p>That is, a macro can only extend a language, and it can do so only at
+the <a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._expander%29" class="techoutside" data-pltdoc="x"><span class="techinside">expander</span></a> layer. Racket offers additional facilities for
+defining a starting point of the <a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._expander%29" class="techoutside" data-pltdoc="x"><span class="techinside">expander</span></a> layer, for extending
+the <a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._reader%29" class="techoutside" data-pltdoc="x"><span class="techinside">reader</span></a> layer, for defining the starting point of the
+<a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._reader%29" class="techoutside" data-pltdoc="x"><span class="techinside">reader</span></a> layer, and for packaging a <a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._reader%29" class="techoutside" data-pltdoc="x"><span class="techinside">reader</span></a> and
+<a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._expander%29" class="techoutside" data-pltdoc="x"><span class="techinside">expander</span></a> starting point into a conveniently named language.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-languages.html" class="toclink" data-pltdoc="x">17.1<span class="hspace">&nbsp;</span>Module Languages</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-languages.html#%28part._implicit-forms%29" class="toclink" data-pltdoc="x">17.1.1<span class="hspace">&nbsp;</span>Implicit Form Bindings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-languages.html#%28part._s-exp%29" class="toclink" data-pltdoc="x">17.1.2<span class="hspace">&nbsp;</span>Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">s-exp</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="hash-reader.html" class="toclink" data-pltdoc="x">17.2<span class="hspace">&nbsp;</span>Reader Extensions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="hash-reader.html#%28part._.Source_.Locations%29" class="toclink" data-pltdoc="x">17.2.1<span class="hspace">&nbsp;</span>Source Locations</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="hash-reader.html#%28part._readtable%29" class="toclink" data-pltdoc="x">17.2.2<span class="hspace">&nbsp;</span>Readtables</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="hash-languages.html" class="toclink" data-pltdoc="x">17.3<span class="hspace">&nbsp;</span>Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="hash-lang_syntax.html" class="toclink" data-pltdoc="x">17.3.1<span class="hspace">&nbsp;</span>Designating a <span class="RktModLink"><span class="RktMod">#lang</span></span> Language</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="hash-lang_reader.html" class="toclink" data-pltdoc="x">17.3.2<span class="hspace">&nbsp;</span>Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">reader</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax_module-reader.html" class="toclink" data-pltdoc="x">17.3.3<span class="hspace">&nbsp;</span>Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">s-exp</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">syntax/module-reader</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="language-collection.html" class="toclink" data-pltdoc="x">17.3.4<span class="hspace">&nbsp;</span>Installing a Language</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="language-get-info.html" class="toclink" data-pltdoc="x">17.3.5<span class="hspace">&nbsp;</span>Source-Handling Configuration</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-runtime-config.html" class="toclink" data-pltdoc="x">17.3.6<span class="hspace">&nbsp;</span>Module-Handling Configuration</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="macro-module.html" title="backward to &quot;16.3 Module Instantiations and Visits&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="module-languages.html" title="forward to &quot;17.1 Module Languages&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/let.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/let.html
new file mode 100644
index 00000000..52409850
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/let.html
@@ -0,0 +1,43 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.6&nbsp;Local Binding</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewselflink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="syntax-notation.html" class="tocviewlink" data-pltdoc="x">Notation</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="binding.html" class="tocviewlink" data-pltdoc="x">Identifiers and Binding</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Function Calls</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Functions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span></a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span></a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="let.html" class="tocviewselflink" data-pltdoc="x">Local Binding</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="conditionals.html" class="tocviewlink" data-pltdoc="x">Conditionals</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span></a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktVal">&rsquo;</span></a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="qq.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span> and <span class="RktVal">&lsquo;</span></a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Simple Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="parameterize.html" class="tocviewlink" data-pltdoc="x">Dynamic Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">parameterize</span></span></a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.6&nbsp;</td><td><a href="let.html" class="tocviewselflink" data-pltdoc="x">Local Binding</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.6.1&nbsp;</td><td><a href="let.html#%28part._.Parallel_.Binding__let%29" class="tocviewlink" data-pltdoc="x">Parallel Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span></a></td></tr><tr><td align="right">4.6.2&nbsp;</td><td><a href="let.html#%28part._.Sequential_.Binding__let_%29" class="tocviewlink" data-pltdoc="x">Sequential Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let*</span></span></a></td></tr><tr><td align="right">4.6.3&nbsp;</td><td><a href="let.html#%28part._.Recursive_.Binding__letrec%29" class="tocviewlink" data-pltdoc="x">Recursive Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">letrec</span></span></a></td></tr><tr><td align="right">4.6.4&nbsp;</td><td><a href="let.html#%28part._.Named_let%29" class="tocviewlink" data-pltdoc="x">Named <span class="RktSym"><span class="RktStxLink">let</span></span></a></td></tr><tr><td align="right">4.6.5&nbsp;</td><td><a href="let.html#%28part._.Multiple_.Values__let-values__let_-values__letrec-values%29" class="tocviewlink" data-pltdoc="x">Multiple Values:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let-<wbr></wbr>values</span></span>, <span class="RktSym"><span class="RktStxLink">let*-<wbr></wbr>values</span></span>, <span class="RktSym"><span class="RktStxLink">letrec-<wbr></wbr>values</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">4.6.1<tt>&nbsp;</tt></span><a href="let.html#%28part._.Parallel_.Binding__let%29" class="tocsubseclink" data-pltdoc="x">Parallel Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.6.2<tt>&nbsp;</tt></span><a href="let.html#%28part._.Sequential_.Binding__let_%29" class="tocsubseclink" data-pltdoc="x">Sequential Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let*</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.6.3<tt>&nbsp;</tt></span><a href="let.html#%28part._.Recursive_.Binding__letrec%29" class="tocsubseclink" data-pltdoc="x">Recursive Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">letrec</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.6.4<tt>&nbsp;</tt></span><a href="let.html#%28part._.Named_let%29" class="tocsubseclink" data-pltdoc="x">Named <span class="RktSym"><span class="RktStxLink">let</span></span></a></td></tr><tr><td><span class="tocsublinknumber">4.6.5<tt>&nbsp;</tt></span><a href="let.html#%28part._.Multiple_.Values__let-values__let_-values__letrec-values%29" class="tocsubseclink" data-pltdoc="x">Multiple Values:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">let-<wbr></wbr>values</span></span>, <span class="RktSym"><span class="RktStxLink">let*-<wbr></wbr>values</span></span>, <span class="RktSym"><span class="RktStxLink">letrec-<wbr></wbr>values</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="define.html" title="backward to &quot;4.5 Definitions: define&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="conditionals.html" title="forward to &quot;4.7 Conditionals&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;let&quot;">4.6<tt>&nbsp;</tt><a name="(part._let)"></a>Local Binding</h4><p>Although internal <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span>s can be used for local binding,
+Racket provides three forms that give the programmer more
+control over bindings: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let*</a></span>, and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Parallel_Binding__let&quot;">4.6.1<tt>&nbsp;</tt><a name="(part._.Parallel_.Binding__let)"></a>Parallel Binding: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span></h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html&amp;version=8.6" class="Sq" data-pltdoc="x">Local Binding: <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> also documents <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span>.</p></blockquote></blockquote></blockquote><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> form binds a set of identifiers, each to the result of
+some expression, for use in the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> body:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>The <span class="RktVar">id</span>s are bound &ldquo;in parallel.&rdquo; That is, no <span class="RktVar">id</span>
+is bound in the right-hand side <span class="RktVar">expr</span> for any <span class="RktVar">id</span>,
+but all are available in the <span class="RktVar">body</span>. The <span class="RktVar">id</span>s must be
+different from each other.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">me</span><span class="hspace">&nbsp;</span><span class="RktVal">"Bob"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">me</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"Bob"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">me</span><span class="hspace">&nbsp;</span><span class="RktVal">"Bob"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">myself</span><span class="hspace">&nbsp;</span><span class="RktVal">"Robert"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">I</span><span class="hspace">&nbsp;</span><span class="RktVal">"Bobby"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">me</span><span class="hspace">&nbsp;</span><span class="RktSym">myself</span><span class="hspace">&nbsp;</span><span class="RktSym">I</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("Bob" "Robert" "Bobby")</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">me</span><span class="hspace">&nbsp;</span><span class="RktVal">"Bob"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">me</span><span class="hspace">&nbsp;</span><span class="RktVal">"Robert"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">me</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">eval:3:0: let: duplicate identifier</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: me</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (let ((me "Bob") (me "Robert")) me)</span></p></td></tr></table></blockquote></div></p><p>The fact that an <span class="RktVar">id</span>&rsquo;s <span class="RktVar">expr</span> does not see its own
+binding is often useful for wrappers that must refer back to the old
+value:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">use original </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"see"</span><span class="hspace">&nbsp;</span><span class="RktVal">"saw"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(3 "seesaw")</span></p></td></tr></table></blockquote><p>Occasionally, the parallel nature of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> bindings is
+convenient for swapping or rearranging a set of bindings:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">me</span><span class="hspace">&nbsp;</span><span class="RktVal">"Tarzan"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">you</span><span class="hspace">&nbsp;</span><span class="RktVal">"Jane"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">me</span><span class="hspace">&nbsp;</span><span class="RktSym">you</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">you</span><span class="hspace">&nbsp;</span><span class="RktSym">me</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">me</span><span class="hspace">&nbsp;</span><span class="RktSym">you</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("Jane" "Tarzan")</span></p></td></tr></table></blockquote><p>The characterization of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> bindings as &ldquo;parallel&rdquo; is not
+meant to imply concurrent evaluation. The <span class="RktVar">expr</span>s are
+evaluated in order, even though the bindings are delayed until all
+<span class="RktVar">expr</span>s are evaluated.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Sequential_Binding__let_&quot;">4.6.2<tt>&nbsp;</tt><a name="(part._.Sequential_.Binding__let_)"></a>Sequential Binding: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let*</a></span></h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html&amp;version=8.6" class="Sq" data-pltdoc="x">Local Binding: <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> also documents <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let*</a></span>.</p></blockquote></blockquote></blockquote><p>The syntax of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let*</a></span> is the same as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span>:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>The difference is that each <span class="RktVar">id</span> is available for use in later
+<span class="RktVar">expr</span>s, as well as in the <span class="RktVar">body</span>. Furthermore, the
+<span class="RktVar">id</span>s need not be distinct, and the most recent binding is the
+visible one.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Burroughs"</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Rice"</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">z</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Edgar"</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(("Burroughs") ("Rice" "Burroughs") ("Edgar" "Rice" "Burroughs"))</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Burroughs"</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Rice"</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Edgar"</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("Edgar" "Rice" "Burroughs")</span></p></td></tr></table></blockquote></div></p><p>In other words, a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let*</a></span> form is equivalent to nested
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> forms, each with a single binding:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Burroughs"</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Rice"</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Edgar"</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("Edgar" "Rice" "Burroughs")</span></p></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Recursive_Binding__letrec&quot;">4.6.3<tt>&nbsp;</tt><a name="(part._.Recursive_.Binding__letrec)"></a>Recursive Binding: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span></h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html&amp;version=8.6" class="Sq" data-pltdoc="x">Local Binding: <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> also documents <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span>.</p></blockquote></blockquote></blockquote><p>The syntax of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span> is also the same as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span>:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>While <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> makes its bindings available only in the
+<span class="RktVar">body</span>s, and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let*</a></span> makes its bindings available to any
+later binding <span class="RktVar">expr</span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span> makes its bindings
+available to all other <span class="RktVar">expr</span>s&#8212;<wbr></wbr>even earlier ones. In other
+words, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span> bindings are recursive.</p><p>The <span class="RktVar">expr</span>s in a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span> form are most often
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> forms for recursive and mutually recursive functions:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">swing</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">t</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">tarzan</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">vine</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">tarzan</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cddr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cddr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swing</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">t</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swing</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">vine</span><span class="hspace">&nbsp;</span><span class="RktVal">tarzan</span><span class="hspace">&nbsp;</span><span class="RktVal">vine</span><span class="hspace">&nbsp;</span><span class="RktVal">vine</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(vine vine tarzan vine)</span></p></td></tr></table></blockquote><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">tarzan-near-top-of-tree?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktSym">path</span><span class="hspace">&nbsp;</span><span class="RktSym">depth</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktVal">"tarzan"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Filesystem.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._directory-exists%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">directory-exists?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">path</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">tarzan-in-directory?</span><span class="hspace">&nbsp;</span><span class="RktSym">path</span><span class="hspace">&nbsp;</span><span class="RktSym">depth</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">tarzan-in-directory?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dir</span><span class="hspace">&nbsp;</span><span class="RktSym">depth</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">depth</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._ormap%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">ormap</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">elem</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">tarzan-near-top-of-tree?</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Manipulating_Paths.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._path-element-%7E3estring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">path-element-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">elem</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Manipulating_Paths.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._build-path%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">build-path</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dir</span><span class="hspace">&nbsp;</span><span class="RktSym">elem</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">depth</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Filesystem.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._directory-list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">directory-list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dir</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">tarzan-near-top-of-tree?</span><span class="hspace">&nbsp;</span><span class="RktVal">"tmp"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Filesystem.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._find-system-path%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">find-system-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">temp-dir</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">directory-list: could not open directory</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">path: /var/tmp/systemd-private-65a36c3a15e6498f91655743df9</span></p></td></tr><tr><td><p><span class="RktErr">2abf8-chronyd.service-7kLgAJ</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">system error: Permission denied; errno=13</span></p></td></tr></table></blockquote><p>While the <span class="RktVar">expr</span>s of a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span> form are typically
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> expressions, they can be any expression. The
+expressions are evaluated in order, and after each value is obtained,
+it is immediately associated with its corresponding <span class="RktVar">id</span>. If
+an <span class="RktVar">id</span> is referenced before its value is ready, an
+error is raised, just as for internal definitions.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">quicksand</span><span class="hspace">&nbsp;</span><span class="RktSym">quicksand</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">quicksand</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">quicksand: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot use before initialization</span></p></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Named_let&quot;">4.6.4<tt>&nbsp;</tt><a name="(part._.Named_let)"></a>Named <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span></h5><p>A named <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> is an iteration and recursion form. It uses the
+same syntactic keyword <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> as for local binding, but an
+identifier after the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> (instead of an immediate open
+parenthesis) triggers a different parsing.</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktVar">proc-id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">arg-id</span><span class="hspace">&nbsp;</span><span class="RktVar">init-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote><p>A named <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> form is equivalent to</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">proc-id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">arg-id</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktSym">...+</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktVar">proc-id</span><span class="hspace">&nbsp;</span><span class="RktVar">init-expr</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>That is, a named <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> binds a function identifier that is
+visible only in the function&rsquo;s body, and it implicitly calls the
+function with the values of some initial expressions.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">duplicate</span><span class="hspace">&nbsp;</span><span class="RktSym">pos</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dup</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">lst</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">pos</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">dup</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">duplicate</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"cheese burger!"</span><span class="hspace">&nbsp;</span><span class="RktVal">"banana"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("apple" "cheese burger!" "cheese burger!" "banana")</span></p></td></tr></table></blockquote></div></p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Multiple_Values__let-values__let_-values__letrec-values&quot;">4.6.5<tt>&nbsp;</tt><a name="(part._.Multiple_.Values__let-values__let_-values__letrec-values)"></a>Multiple Values: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._let-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let-values</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%252A-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let*-values</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._letrec-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec-values</a></span></h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html&amp;version=8.6" class="Sq" data-pltdoc="x">Local Binding: <span class="RktSym"><span class="RktStxLink">let</span></span>, <span class="RktSym"><span class="RktStxLink">let*</span></span>, <span class="RktSym"><span class="RktStxLink">letrec</span></span>, ...</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> also documents multiple-value binding forms.</p></blockquote></blockquote></blockquote><p>In the same way that <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span> binds multiple
+results in a definition (see <a href="define.html#%28part._multiple-values%29" data-pltdoc="x">Multiple Values and <span class="RktSym"><span class="RktStxLink">define-values</span></span></a>),
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._let-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let-values</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%252A-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let*-values</a></span>, and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._letrec-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec-values</a></span> bind multiple results locally.</p><p><div class="SIntrapara"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._let-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote></div><div class="SIntrapara"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%252A-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let*-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote></div><div class="SIntrapara"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._letrec-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote></div></p><p>Each <span class="RktVar">expr</span> must produce as many values as corresponding
+<span class="RktVar">id</span>s. The binding rules are the same for the forms
+without <span class="RktKw">-values</span> forms: the <span class="RktVar">id</span>s of
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._let-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let-values</a></span> are bound only in the <span class="RktVar">body</span>s, the
+<span class="RktVar">id</span>s of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%252A-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let*-values</a></span>s are bound in
+<span class="RktVar">expr</span>s of later clauses, and the <span class="RktVar">id</span>s of
+<span class="RktSym">letrec-value</span>s are bound for all <span class="RktVar">expr</span>s.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._let-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">q</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._quotient%252Fremainder%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">quotient/remainder</a></span><span class="hspace">&nbsp;</span><span class="RktVal">14</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">q</span><span class="hspace">&nbsp;</span><span class="RktSym">r</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(4 2)</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="define.html" title="backward to &quot;4.5 Definitions: define&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="conditionals.html" title="forward to &quot;4.7 Conditionals&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/load.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/load.html
new file mode 100644
index 00000000..f3ccc3c3
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/load.html
@@ -0,0 +1,40 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15.3&nbsp;Scripting Evaluation and Using load</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewselflink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="eval.html" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eval</span></span></a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="mk-namespace.html" class="tocviewlink" data-pltdoc="x">Manipulating Namespaces</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="load.html" class="tocviewselflink" data-pltdoc="x">Scripting Evaluation and Using <span class="RktSym"><span class="RktValLink">load</span></span></a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="code-inspectors_protect.html" class="tocviewlink" data-pltdoc="x">Code Inspectors for Trusted and Untrusted Code</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="mk-namespace.html" title="backward to &quot;15.2 Manipulating Namespaces&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="reflection.html" title="up to &quot;15 Reflection and Dynamic Evaluation&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="code-inspectors_protect.html" title="forward to &quot;15.4 Code Inspectors for Trusted and Untrusted Code&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;load&quot;">15.3<tt>&nbsp;</tt><a name="(part._load)"></a>Scripting Evaluation and Using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._load%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">load</a></span></h4><p>Historically, Lisp implementations did not offer module
+systems. Instead, large programs were built by essentially scripting
+the <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> to evaluate program fragments in a particular order.
+While <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> scripting turns out to be a bad way to structure
+programs and libraries, it is still sometimes a useful capability.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Describing a program via <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._load%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">load</a></span> interacts
+especially badly with macro-defined language extensions
+[<a href="doc-bibliography.html#%28cite._.Flatt02%29" data-pltdoc="x">Flatt02</a>].</p></blockquote></blockquote></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._load%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">load</a></span> function runs a <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> script by
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span>ing S-expressions from a file, one by one, and passing
+them to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span>. If a file <span class="stt">"place.rkts"</span> contains</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">city</span><span class="hspace">&nbsp;</span><span class="RktVal">"Salt Lake City"</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">state</span><span class="hspace">&nbsp;</span><span class="RktVal">"Utah"</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a, ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">city</span><span class="hspace">&nbsp;</span><span class="RktSym">state</span><span class="RktPn">)</span></td></tr></table></blockquote><p>then it can be loaded in a <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._load%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">load</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"place.rkts"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Salt Lake City, Utah</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">city</span></td></tr><tr><td><p><span class="RktRes">"Salt Lake City"</span></p></td></tr></table></blockquote><p>Since <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._load%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">load</a></span> uses <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span>, however, a module like the
+following generally will not work&#8212;<wbr></wbr>for the same reasons described in
+<a href="eval.html#%28part._namespaces%29" data-pltdoc="x">Namespaces</a>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">there</span><span class="hspace">&nbsp;</span><span class="RktVal">"Utopia"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._load%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">load</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"here.rkts"</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The current namespace for evaluating the content of
+<span class="stt">"here.rkts"</span> is likely to be empty; in any case, you cannot get
+<span class="RktSym">there</span> from <span class="stt">"here.rkts"</span>. Also, any definitions in
+<span class="stt">"here.rkts"</span> will not become visible for use within the module;
+after all, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._load%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">load</a></span> happens dynamically, while references to
+identifiers within the module are resolved lexically, and therefore
+statically.</p><p>Unlike <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._load%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">load</a></span> does not accept a namespace
+argument. To supply a namespace to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._load%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">load</a></span>, set the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-namespace</a></span> <a href="parameterize.html#%28tech._parameter%29" class="techoutside" data-pltdoc="x"><span class="techinside">parameter</span></a>. The following example evaluates
+the expressions in <span class="stt">"here.rkts"</span> using the bindings of the
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a> module:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-namespace</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._make-base-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-base-namespace</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._load%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">load</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"here.rkts"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>You can even use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._namespace-anchor-%7E3enamespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">namespace-anchor-&gt;namespace</a></span> to make the
+bindings of the enclosing module accessible for dynamic evaluation. In
+the following example, when <span class="stt">"here.rkts"</span> is <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._load%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">load</a></span>ed, it
+can refer to <span class="RktSym">there</span> as well as the bindings of
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">there</span><span class="hspace">&nbsp;</span><span class="RktVal">"Utopia"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-namespace-anchor%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-namespace-anchor</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-namespace</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._namespace-anchor-%7E3enamespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">namespace-anchor-&gt;namespace</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._load%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">load</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"here.rkts"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Still, if <span class="stt">"here.rkts"</span> defines any identifiers, the definitions
+cannot be directly (i.e., statically) referenced by in the enclosing
+module.</p><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=load-lang.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/load</span></a> module language is different from
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a> or <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a>. A module using
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=load-lang.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/load</span></a> treats all of its content as dynamic,
+passing each form in the module body to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span> (using a
+namespace that is initialized with <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a>). As a
+result, uses of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._load%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">load</a></span> in the module body see
+the same dynamic namespace as immediate body forms. For example, if
+<span class="stt">"here.rkts"</span> contains</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">here</span><span class="hspace">&nbsp;</span><span class="RktVal">"Morporkia"</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">go!</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">here</span><span class="hspace">&nbsp;</span><span class="RktSym">there</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>then running</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=load-lang.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/load</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">there</span><span class="hspace">&nbsp;</span><span class="RktVal">"Utopia"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._load%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">load</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"here.rkts"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">go!</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">here</span><span class="RktPn">)</span></td></tr></table></blockquote><p>prints &ldquo;Utopia&rdquo;.</p><p>Drawbacks of using <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=load-lang.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/load</span></a> include reduced
+error checking, tool support, and performance. For example, with the
+program</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=load-lang.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/load</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">good</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"running\n"</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktSym">good</span></td></tr><tr><td><span class="RktSym">bad</span></td></tr></table></blockquote><p>DrRacket&rsquo;s <span class="ssansserif">Check Syntax</span> tool cannot tell that the second
+<span class="RktSym">good</span> is a reference to the first, and the unbound reference
+to <span class="RktSym">bad</span> is reported only at run time instead of rejected
+syntactically.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="mk-namespace.html" title="backward to &quot;15.2 Manipulating Namespaces&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="reflection.html" title="up to &quot;15 Reflection and Dynamic Evaluation&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="code-inspectors_protect.html" title="forward to &quot;15.4 Code Inspectors for Trusted and Untrusted Code&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/macro-module.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/macro-module.html
new file mode 100644
index 00000000..2317186e
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/macro-module.html
@@ -0,0 +1,136 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>16.3&nbsp;Module Instantiations and Visits</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.1&nbsp;</td><td><a href="pattern-macros.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Macros</a></td></tr><tr><td align="right">16.2&nbsp;</td><td><a href="proc-macros.html" class="tocviewlink" data-pltdoc="x">General Macro Transformers</a></td></tr><tr><td align="right">16.3&nbsp;</td><td><a href="macro-module.html" class="tocviewselflink" data-pltdoc="x">Module Instantiations and Visits</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>16.3&nbsp;</td><td><a href="macro-module.html" class="tocviewselflink" data-pltdoc="x">Module Instantiations and Visits</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.3.1&nbsp;</td><td><a href="macro-module.html#%28part._.Declaration_versus_.Instantiation%29" class="tocviewlink" data-pltdoc="x">Declaration versus Instantiation</a></td></tr><tr><td align="right">16.3.2&nbsp;</td><td><a href="macro-module.html#%28part._compile-time-instantiation%29" class="tocviewlink" data-pltdoc="x">Compile-<wbr></wbr>Time Instantiation</a></td></tr><tr><td align="right">16.3.3&nbsp;</td><td><a href="macro-module.html#%28part._.Visiting_.Modules%29" class="tocviewlink" data-pltdoc="x">Visiting Modules</a></td></tr><tr><td align="right">16.3.4&nbsp;</td><td><a href="macro-module.html#%28part._stx-available-module%29" class="tocviewlink" data-pltdoc="x">Lazy Visits via Available Modules</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">16.3.1<tt>&nbsp;</tt></span><a href="macro-module.html#%28part._.Declaration_versus_.Instantiation%29" class="tocsubseclink" data-pltdoc="x">Declaration versus Instantiation</a></td></tr><tr><td><span class="tocsublinknumber">16.3.2<tt>&nbsp;</tt></span><a href="macro-module.html#%28part._compile-time-instantiation%29" class="tocsubseclink" data-pltdoc="x">Compile-<wbr></wbr>Time Instantiation</a></td></tr><tr><td><span class="tocsublinknumber">16.3.3<tt>&nbsp;</tt></span><a href="macro-module.html#%28part._.Visiting_.Modules%29" class="tocsubseclink" data-pltdoc="x">Visiting Modules</a></td></tr><tr><td><span class="tocsublinknumber">16.3.4<tt>&nbsp;</tt></span><a href="macro-module.html#%28part._stx-available-module%29" class="tocsubseclink" data-pltdoc="x">Lazy Visits via Available Modules</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="versionbox"><span class="version">8.6</span></div><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stx-certs.html" title="backward to &quot;16.2.7 Tainted Syntax&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="macros.html" title="up to &quot;16 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="languages.html" title="forward to &quot;17 Creating Languages&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;macro-module&quot;">16.3<tt>&nbsp;</tt><a name="(part._macro-module)"></a>Module Instantiations and Visits</h4><p>Modules often contain just function and structure-type definitions, in
+which case the module itself behaves in a purely functional way, and
+the time when the functions are created is not observable. If a
+module&rsquo;s top-level expressions include side effects, however, then the
+timing of the effects can matter. The distinction between module
+declaration and <a href="macro-module.html#%28tech._instantiation%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiation</span></a> provides some control over that
+timing. The concept of module <a href="macro-module.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visits</span></a> further explains the
+interaction of effects with macro implementations.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Declaration_versus_Instantiation&quot;">16.3.1<tt>&nbsp;</tt><a name="(part._.Declaration_versus_.Instantiation)"></a>Declaration versus Instantiation</h5><p>Declaring a module does not immediately evaluate expressions in the
+module&rsquo;s body. For example, evaluating</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">number-n</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._random%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">random</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"picked ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote><p>declares the module <span class="RktSym">number-n</span>, but it doesn&rsquo;t immediately pick a
+random number for <span class="RktSym">n</span> or display the number. A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>
+of <span class="RktSym">number-n</span> causes the module to be <a name="(tech._instantiated)"></a><span style="font-style: italic">instantiated</span>
+(i.e., it triggers an <a name="(tech._instantiation)"></a><span style="font-style: italic">instantiation</span>), which implies that the
+expressions in the body of the module are evaluated:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">number-n</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">picked 5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">n</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr></table></blockquote><p>After a module is instantiated in a particular <a href="eval.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespace</span></a>,
+further <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>s of the module use the same instance, as
+opposed to instantiating the module again:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">number-n</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">n</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">use-n</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">number-n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"still ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">use-n</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">still 5</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Module_Names_and_Loading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._dynamic-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">dynamic-require</a></span> function, like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>, triggers
+instantiation of a module if it is not already instantiated, so
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Module_Names_and_Loading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._dynamic-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">dynamic-require</a></span> with <span class="RktVal">#f</span> as a second argument is
+useful to just trigger the instantiation effects of a module:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">use-n-again</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">number-n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"also still ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Module_Names_and_Loading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._dynamic-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">dynamic-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">use-n-again</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">also still 5</span></p></td></tr></table></blockquote><p>Instantiation of modules by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> is transitive. That is,
+if <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> of a module instantiates it, then any module
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>d by that one is also instantiated (if it&rsquo;s not
+instantiated already):</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">number-m</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._random%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">random</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"picked ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">use-m</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">number-m</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"still ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">use-m</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">picked 0</span></p></td></tr><tr><td><p><span class="RktOut">still 0</span></p></td></tr></table></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;compile-time-instantiation&quot;">16.3.2<tt>&nbsp;</tt><a name="(part._compile-time-instantiation)"></a>Compile-Time Instantiation</h5><p>In the same way that declaring a module does not by itself instantiate
+a module, declaring a module that <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>s another module
+does not by itself instantiate the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>d module, as
+illustrated in the preceding example. However, declaring a module
+<span class="emph">does</span> expand and compile the module. If a module imports another
+with <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span>, then module that is
+imported <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span> must be instantiated during expansion:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">number-p</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._random%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">random</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"picked ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">use-p-at-compile-time</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">number-p</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">pm</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#`</span><span class="RktRdr">#,</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"was ~a at compile time\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">pm</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">picked 1</span></p></td></tr></table></blockquote><p>Unlike run-time instantiation in a namespace, when a module is used
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span> for another module expansion in the same
+namespace, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span>ed module is instantiated separately
+for each expansion. Continuing the previous example, if
+<span class="RktSym">number-p</span> is used a second time <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span>, then a
+second random number is selected for a new <span class="RktSym">p</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">use-p-again-at-compile-time</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">number-p</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">pm</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#`</span><span class="RktRdr">#,</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"was ~a at second compile time\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">pm</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">picked 3</span></p></td></tr></table></blockquote><p>Separate compile-time instantiations of <span class="RktSym">number-p</span> helps
+prevent accidental propagation of effects from one module&rsquo;s
+compilation to another module&rsquo;s compilation. Preventing those effects
+make compilation reliably separate and more deterministic.</p><p>The expanded forms of <span class="RktSym">use-p-at-compile-time</span> and
+<span class="RktSym">use-p-again-at-compile-time</span> record the number that was
+selected each time, so those two different numbers are printed when the
+modules are instantiated:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Module_Names_and_Loading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._dynamic-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">dynamic-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">use-p-at-compile-time</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">was 1 at compile time</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Module_Names_and_Loading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._dynamic-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">dynamic-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">use-p-again-at-compile-time</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">was 3 at second compile time</span></p></td></tr></table></blockquote><p>A namespace&rsquo;s top level behaves like a separate module, where multiple
+interactions in the top level conceptually extend a single expansion
+of the module. So, when using <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span>
+twice in the top level, the second use does not trigger a new
+compile-time instance:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">number-p</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">done</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">picked 4</span></p></td></tr><tr><td><p><span class="RktRes">'done</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">number-p</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">done-again</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'done-again</span></p></td></tr></table></blockquote><p>However, a run-time instance of a module is kept separate from all
+compile-time instances, including at the top level, so a
+non-<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span> use of <span class="RktSym">number-p</span> will pick another
+random number:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">number-p</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">picked 5</span></p></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Visiting_Modules&quot;">16.3.3<tt>&nbsp;</tt><a name="(part._.Visiting_.Modules)"></a>Visiting Modules</h5><p>When a module <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span>s a macro for use by other modules, the
+other modules use the macro by directly <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>ing the macro
+provider&#8212;<wbr></wbr>i.e., without <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span>. That&rsquo;s because the macro
+is being imported for use in a run-time position (even though the
+macro&rsquo;s implementation lives at compile time), while
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span> would import a binding for use in compile-time
+position.</p><p>The module implementing a macro, meanwhile, might <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>
+another module <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span> to implement the macro. The
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span> module needs a compile-time instantiation during
+any module expansion that might use the macro. That requirement sets
+up a kind of transitivity through <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> that is similar to
+instantiation transitivity, but &ldquo;off by one&rdquo; at the point where the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span> shift occurs in the chain.</p><p>Here&rsquo;s an example to make that scenario concrete:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">number-q</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">q</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">q</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._random%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">random</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"picked ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">q</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">use-q-at-compile-time</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">number-q</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">qm</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">qm</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#`</span><span class="RktRdr">#,</span><span class="RktSym">q</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"was ~a at compile time\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">qm</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">picked 7</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">use-qm</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">use-q-at-compile-time</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"was ~a at second compile time\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">qm</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">picked 4</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Module_Names_and_Loading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._dynamic-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">dynamic-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">use-qm</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">was 7 at compile time</span></p></td></tr><tr><td><p><span class="RktOut">was 4 at second compile time</span></p></td></tr></table></td></tr></table></blockquote><p>In this example, when <span class="RktSym">use-q-at-compile-time</span> is expanded and
+compiled, <span class="RktSym">number-q</span> is instantiated once. In this case, that
+instantiation is needed to expand the <span class="RktPn">(</span><span class="RktSym">qm</span><span class="RktPn">)</span> macro, but the module
+system would proactively create a compile-time instantiation of
+<span class="RktSym">number-q</span> even if the <span class="RktSym">qm</span> macro turned out not to be
+used.</p><p>Then, as <span class="RktSym">use-qm</span> is expanded and compiled, a second
+compile-time instantiation of <span class="RktSym">number-q</span> is created. That
+compile-time instantiation is needed to expand the <span class="RktPn">(</span><span class="RktSym">qm</span><span class="RktPn">)</span> form
+within <span class="RktSym">use-qm</span>.</p><p>Instantiating <span class="RktSym">use-qm</span> correctly reports the number that was
+picked during that second module&rsquo;s compilation. First, though, the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> of <span class="RktSym">use-q-at-compile-time</span> in <span class="RktSym">use-qm</span>
+triggers a transitive instantiation of <span class="RktSym">use-q-at-compile-time</span>,
+which correctly reports the number that was picked in its compilation.</p><p>Overall, the example illustrates a transitive effect of
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> that we had already seen:</p><ul><li><p>When a module is <a href="macro-module.html#%28tech._instantiated%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiated</span></a>, the run-time expressions
+     in its body are evaluated.</p></li><li><p>When a module is <a href="macro-module.html#%28tech._instantiated%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiated</span></a>, then any module that it <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>s
+     (without <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span>) is also <a href="macro-module.html#%28tech._instantiated%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiated</span></a>.</p></li></ul><p>This rule does not explain the compile-time instantiations of
+<span class="RktSym">number-q</span>, however. To explain that, we need a new word,
+<a name="(tech._visit)"></a><span style="font-style: italic">visit</span>, for the concept that we saw in
+<a href="macro-module.html#%28part._compile-time-instantiation%29" data-pltdoc="x">Compile-Time Instantiation</a>:</p><ul><li><p>When a module is <a href="macro-module.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed, the compile-time expressions
+     (such as macro definition) in its body are evaluated.</p></li><li><p>As a module is expanded, it is <a href="macro-module.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed.</p></li><li><p>When a module is <a href="macro-module.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed, then any module that it <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>s
+      (without <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span>) is also <a href="macro-module.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed.</p></li><li><p>When a module is <a href="macro-module.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed, then any module that it <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>s
+     <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span> is <a href="macro-module.html#%28tech._instantiated%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiated</span></a> at compile time.</p></li></ul><p>Note that when visiting one module causes a compile-time instantiation of
+another module, the transitiveness of <a href="macro-module.html#%28tech._instantiation%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiation</span></a> through
+regular <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>s can trigger more compile-time instantiations.
+Instantiation itself won&rsquo;t trigger further visits, however, because
+any instantiated module has already been expanded and compiled.</p><p>The compile-time expressions of a module that are evaluated by
+<a href="macro-module.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ing include both the right-hand sides of
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span> forms and the body of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin-for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin-for-syntax</a></span>
+forms. That&rsquo;s why a randomly selected number is printed immediately in
+the following example:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">compile-time-number</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin-for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin-for-syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"picked ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._random%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">random</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"running\n"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">picked 0.25549265186825576</span></p></td></tr></table></blockquote><p>Instantiating the module evaluates only the run-time expressions,
+which prints &ldquo;running&rdquo; but not a new random number:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Module_Names_and_Loading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._dynamic-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">dynamic-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">'</span><span class="RktVal">compile-time-number</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">running</span></p></td></tr></table></blockquote><p>The description of <a href="module-require.html#%28tech._instantiate%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiates</span></a> and <a href="macro-module.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a> above is
+phrased in terms of normal <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>s and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span>
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>s, but a more precise specification is in terms of
+module phases. For example, if module <span class="RktVar">A</span> has <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="stt"> </span><span class="RktVar">B</span><span class="RktPn">)</span><span class="RktPn">)</span> and module <span class="RktVar">B</span> has <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-template%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-template</a></span><span class="stt"> </span><span class="RktVar">C</span><span class="RktPn">)</span><span class="RktPn">)</span>, then module <span class="RktVar">C</span> is <a href="macro-module.html#%28tech._instantiated%29" class="techoutside" data-pltdoc="x"><span class="techinside">instantiated</span></a>
+when module <span class="RktVar">A</span> is instantiated, because the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-template%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-template</a></span> shifts cancel. We have
+not yet specified what happens with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-meta%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-meta</a></span><span class="stt"> </span><span class="RktVal">2</span> for when
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span>es combine; we leave that to the next section,
+<a href="macro-module.html#%28part._stx-available-module%29" data-pltdoc="x">Lazy Visits via Available Modules</a>.</p><p>If you think of the top-level as a kind of module that is continuously
+expanded, the above rules imply that <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> of another
+module at the top level both instantiates and visits the other module
+(if it is not already instantiated and visited). That&rsquo;s roughly true,
+but the visit is made lazy in a way that is also explained in the next
+section, <a href="macro-module.html#%28part._stx-available-module%29" data-pltdoc="x">Lazy Visits via Available Modules</a>.</p><p>Meanwhile, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Module_Names_and_Loading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._dynamic-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">dynamic-require</a></span> only instantiates a module; it
+does not visit the module. That simplification is why some of the
+preceding examples use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Module_Names_and_Loading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._dynamic-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">dynamic-require</a></span> instead of
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>. The extra visits of a top-level <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>
+would make the earlier examples less clear.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;stx-available-module&quot;">16.3.4<tt>&nbsp;</tt><a name="(part._stx-available-module)"></a>Lazy Visits via Available Modules</h5><p>A top-level <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> of a module does not actually
+<a href="macro-module.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a> the module. Instead, it makes the module
+<a name="(tech._available)"></a><span style="font-style: italic">available</span>. An <a href="macro-module.html#%28tech._available%29" class="techoutside" data-pltdoc="x"><span class="techinside">available</span></a> module will be <a href="macro-module.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed
+when a future expression needs to be expanded in the same context. The
+next expression may or may not involve some imported macro that needs
+its compile-time helpers evaluated by <a href="macro-module.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ing, but the module
+system proactively <a href="macro-module.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>s the module, just in case.</p><p>In the following example, a random number is picked as a result of
+visiting a module&rsquo;s own body while that module is being expanded. A
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> of the module instantiates it, printing &ldquo;running&rdquo;,
+and also makes the module <a href="macro-module.html#%28tech._available%29" class="techoutside" data-pltdoc="x"><span class="techinside">available</span></a>. Evaluating any other
+expression implies expanding the expression, and that expansion
+triggers a <a href="macro-module.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a> of the <a href="macro-module.html#%28tech._available%29" class="techoutside" data-pltdoc="x"><span class="techinside">available</span></a> module&#8212;<wbr></wbr>which picks
+another random number:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">another-compile-time-number</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin-for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin-for-syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"picked ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._random%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">random</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"running\n"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">picked 0.3634379786893492</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">another-compile-time-number</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">running</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">'</span><span class="RktVal">next</span></td></tr><tr><td><p><span class="RktOut">picked 0.5057086679589476</span></p></td></tr><tr><td><p><span class="RktRes">'next</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">'</span><span class="RktVal">another</span></td></tr><tr><td><p><span class="RktRes">'another</span></p></td></tr></table></blockquote><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Beware that the expander flattens the content of a
+top-level <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span> into the top level as soon as the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span> is discovered. So, <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">another-compile-time-number</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">next</span><span class="RktPn">)</span> would still have printed
+&ldquo;picked&rdquo; before &ldquo;next&ldquo;.</p></blockquote></blockquote></blockquote><p>The final evaluation of <span class="RktVal">'</span><span class="RktVal">another</span> also visits any available
+modules, but no modules were made newly available by simply evaluating
+<span class="RktVal">'</span><span class="RktVal">next</span>.</p><p>When a module <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>s another module using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-meta%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-meta</a></span><span class="stt"> </span><span class="RktVar">n</span> for some <span class="RktVar">n</span> greater than 1, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>d module
+is made <a href="macro-module.html#%28tech._available%29" class="techoutside" data-pltdoc="x"><span class="techinside">available</span></a> at phase <span class="RktVar">n</span>. A module that is
+<a href="macro-module.html#%28tech._available%29" class="techoutside" data-pltdoc="x"><span class="techinside">available</span></a> at phase <span class="RktVar">n</span> is <a href="macro-module.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed when some
+expression at phase <span class="RktVar">n</span><span style="font-style: italic">-</span>1<span style="font-style: italic"></span> is expanded.</p><p>To help illustrate, the following examples use
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._variable-reference-%7E3emodule-base-phase%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">variable-reference-&gt;module-base-phase</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Locations____variable-reference.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._%7E23%7E25variable-reference%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%variable-reference</a></span><span class="RktPn">)</span><span class="RktPn">)</span>, which returns a number for the phase at
+which the enclosing module is instantiated:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">show-phase</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"running at ~a\n"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._variable-reference-%7E3emodule-base-phase%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">variable-reference-&gt;module-base-phase</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Locations____variable-reference.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._%7E23%7E25variable-reference%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%variable-reference</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">show-phase</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">running at 0</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">use-at-phase-1</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">show-phase</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">running at 1</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">unused-at-phase-2</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-meta%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-meta</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">show-phase</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote><p>For the last module above, <span class="RktSym">show-phase</span> is made
+<a href="macro-module.html#%28tech._available%29" class="techoutside" data-pltdoc="x"><span class="techinside">available</span></a> at phase 2, but no expressions within the module are
+ever expanded at phase 1, so there&rsquo;s no phase-2 printout. The
+following module includes a phase-1 expression after the phase-2
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>, so there&rsquo;s a printout:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">use-at-phase-2</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-meta%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-meta</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">show-phase</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">ok</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">running at 2</span></p></td></tr></table></blockquote><p>If we <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> the module <span class="RktSym">use-at-phase-1</span> at the top
+level, then <span class="RktSym">show-phase</span> is made <a href="macro-module.html#%28tech._available%29" class="techoutside" data-pltdoc="x"><span class="techinside">available</span></a> at phase 1.
+Evaluating another expression causes <span class="RktSym">use-at-phase-1</span> to be
+<a href="macro-module.html#%28tech._visit%29" class="techoutside" data-pltdoc="x"><span class="techinside">visit</span></a>ed, which in turn instantiates <span class="RktSym">show-phase</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">use-at-phase-1</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">'</span><span class="RktVal">next</span></td></tr><tr><td><p><span class="RktOut">running at 1</span></p></td></tr><tr><td><p><span class="RktRes">'next</span></p></td></tr></table></blockquote><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> of <span class="RktSym">use-at-phase-2</span> is similar, except that
+<span class="RktSym">show-phase</span> is made <a href="macro-module.html#%28tech._available%29" class="techoutside" data-pltdoc="x"><span class="techinside">available</span></a> at phase 2, so it is not
+instantiated until some expression is expanded at phase 1:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">use-at-phase-2</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">'</span><span class="RktVal">next</span></td></tr><tr><td><p><span class="RktRes">'next</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin-for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin-for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">compile-time-next</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">running at 2</span></p></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stx-certs.html" title="backward to &quot;16.2.7 Tainted Syntax&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="macros.html" title="up to &quot;16 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="languages.html" title="forward to &quot;17 Creating Languages&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/macro-transformers.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/macro-transformers.html
new file mode 100644
index 00000000..5ef46318
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/macro-transformers.html
@@ -0,0 +1,21 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>16.2.2&nbsp;Macro Transformer Procedures</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.1&nbsp;</td><td><a href="pattern-macros.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Macros</a></td></tr><tr><td align="right">16.2&nbsp;</td><td><a href="proc-macros.html" class="tocviewselflink" data-pltdoc="x">General Macro Transformers</a></td></tr><tr><td align="right">16.3&nbsp;</td><td><a href="macro-module.html" class="tocviewlink" data-pltdoc="x">Module Instantiations and Visits</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>16.2&nbsp;</td><td><a href="proc-macros.html" class="tocviewlink" data-pltdoc="x">General Macro Transformers</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.2.1&nbsp;</td><td><a href="stx-obj.html" class="tocviewlink" data-pltdoc="x">Syntax Objects</a></td></tr><tr><td align="right">16.2.2&nbsp;</td><td><a href="macro-transformers.html" class="tocviewselflink" data-pltdoc="x">Macro Transformer Procedures</a></td></tr><tr><td align="right">16.2.3&nbsp;</td><td><a href="syntax-case.html" class="tocviewlink" data-pltdoc="x">Mixing Patterns and Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">syntax-<wbr></wbr>case</span></span></a></td></tr><tr><td align="right">16.2.4&nbsp;</td><td><a href="with-syntax.html" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>syntax</span></span> and <span class="RktSym"><span class="RktValLink">generate-<wbr></wbr>temporaries</span></span></a></td></tr><tr><td align="right">16.2.5&nbsp;</td><td><a href="stx-phases.html" class="tocviewlink" data-pltdoc="x">Compile and Run-<wbr></wbr>Time Phases</a></td></tr><tr><td align="right">16.2.6&nbsp;</td><td><a href="phases.html" class="tocviewlink" data-pltdoc="x">General Phase Levels</a></td></tr><tr><td align="right">16.2.7&nbsp;</td><td><a href="stx-certs.html" class="tocviewlink" data-pltdoc="x">Tainted Syntax</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stx-obj.html" title="backward to &quot;16.2.1 Syntax Objects&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="proc-macros.html" title="up to &quot;16.2 General Macro Transformers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="syntax-case.html" title="forward to &quot;16.2.3 Mixing Patterns and Expressions: syntax-case&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;macro-transformers&quot;">16.2.2<tt>&nbsp;</tt><a name="(part._macro-transformers)"></a>Macro Transformer Procedures</h5><p>Any procedure of one argument can be a <a href="proc-macros.html#%28tech._macro._transformer%29" class="techoutside" data-pltdoc="x"><span class="techinside">macro transformer</span></a>.  As
+it turns out, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span> form is a macro that expands
+to a procedure form. For example, if you evaluate a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span> form directly (instead of placing on the
+right-hand of a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span> form), the result is a
+procedure:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">nothing</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">something</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;procedure&gt;</span></p></td></tr></table></blockquote><p>Instead of using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span>, you can write your own macro
+transformer procedure directly using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span>. The argument to
+the procedure is a <a href="stx-obj.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> that represents the source form, and the
+result of the procedure must be a <a href="stx-obj.html#%28tech._syntax._object%29" class="techoutside" data-pltdoc="x"><span class="techinside">syntax object</span></a> that represents the
+replacement form:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">self-as-string</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._datum-%7E3esyntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">datum-&gt;syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._format%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~s"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-%7E3edatum%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">self-as-string</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"(self-as-string (+ 1 2))"</span></p></td></tr></table></blockquote><p>The source form passed to a macro transformer represents an
+expression in which its identifier is used in an application position
+(i.e., after a parenthesis that starts an expression), or it
+represents the identifier by itself if it is used as an expression
+position and not in an application position.<span class="refelem"><span class="refcolumn"><span class="refcontent">The procedure produced by
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span> raises a syntax error if its argument
+corresponds to a use of the identifier by itself, which is why
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span> does not implement an <a href="pattern-macros.html#%28tech._identifier._macro%29" class="techoutside" data-pltdoc="x"><span class="techinside">identifier macro</span></a>.</span></span></span></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">self-as-string</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"(self-as-string (+ 1 2))"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">self-as-string</span></td></tr><tr><td><p><span class="RktRes">"self-as-string"</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span> form supports the same shortcut
+syntax for functions as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span>, so that the following <span class="RktSym">self-as-string</span>
+definition is equivalent to the one that uses <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span>
+explicitly:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">self-as-string</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._datum-%7E3esyntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">datum-&gt;syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._format%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"~s"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-%7E3edatum%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">self-as-string</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"(self-as-string (+ 1 2))"</span></p></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stx-obj.html" title="backward to &quot;16.2.1 Syntax Objects&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="proc-macros.html" title="up to &quot;16.2 General Macro Transformers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="syntax-case.html" title="forward to &quot;16.2.3 Mixing Patterns and Expressions: syntax-case&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/macros.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/macros.html
new file mode 100644
index 00000000..7972ab85
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/macros.html
@@ -0,0 +1,19 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>16&nbsp;Macros</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>16&nbsp;</td><td><a href="macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.1&nbsp;</td><td><a href="pattern-macros.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Macros</a></td></tr><tr><td align="right">16.2&nbsp;</td><td><a href="proc-macros.html" class="tocviewlink" data-pltdoc="x">General Macro Transformers</a></td></tr><tr><td align="right">16.3&nbsp;</td><td><a href="macro-module.html" class="tocviewlink" data-pltdoc="x">Module Instantiations and Visits</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="code-inspectors_protect.html" title="backward to &quot;15.4 Code Inspectors for Trusted and Untrusted Code&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="pattern-macros.html" title="forward to &quot;16.1 Pattern-Based Macros&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;macros&quot;">16<tt>&nbsp;</tt><a name="(part._macros)"></a>Macros</h3><p>A <a name="(tech._macro)"></a><span style="font-style: italic">macro</span> is a syntactic form with an associated
+<a name="(tech._transformer)"></a><span style="font-style: italic">transformer</span> that <a name="(tech._expand)"></a><span style="font-style: italic">expands</span> the original form
+into existing forms. To put it another way, a macro is an
+extension to the Racket compiler. Most of the syntactic forms of
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a> and <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a> are
+actually macros that expand into a small set of core constructs.</p><p>Like many languages, Racket provides pattern-based macros that
+make simple transformations easy to implement and reliable to
+use. Racket also supports arbitrary macro transformers that are
+implemented in Racket&#8212;<wbr></wbr>or in a macro-extended variant of Racket.</p><p>This chapter provides an introduction to Racket macros, but see
+<a href="https://www.greghendershott.com/fear-of-macros/"><span style="font-style: italic">Fear of
+Macros</span></a> for an introduction from a different perspective.</p><p>Racket includes additional support for macro development:
+A <a href="https://docs.racket-lang.org/macro-debugger/index.html"><span style="font-style: italic">macro
+debugger</span></a> to make it easier for experienced programmers
+to debug their macros and for novices to study their behavior,
+and of macros. And the <a href="https://docs.racket-lang.org/syntax/index.html"><span style="font-style: italic">syntax/parse
+library</span></a> for writing macros and specifying syntax that
+automatically validates macro uses and reports syntax
+errors.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pattern-macros.html" class="toclink" data-pltdoc="x">16.1<span class="hspace">&nbsp;</span>Pattern-Based Macros</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pattern-macros.html#%28part._define-syntax-rule%29" class="toclink" data-pltdoc="x">16.1.1<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">define-syntax-rule</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pattern-macros.html#%28part._.Lexical_.Scope%29" class="toclink" data-pltdoc="x">16.1.2<span class="hspace">&nbsp;</span>Lexical Scope</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pattern-macros.html#%28part._define-syntax_and_syntax-rules%29" class="toclink" data-pltdoc="x">16.1.3<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">define-syntax</span></span> and <span class="RktSym"><span class="RktStxLink">syntax-rules</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pattern-macros.html#%28part._.Matching_.Sequences%29" class="toclink" data-pltdoc="x">16.1.4<span class="hspace">&nbsp;</span>Matching Sequences</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pattern-macros.html#%28part._.Identifier_.Macros%29" class="toclink" data-pltdoc="x">16.1.5<span class="hspace">&nbsp;</span>Identifier Macros</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pattern-macros.html#%28part._set__.Transformers%29" class="toclink" data-pltdoc="x">16.1.6<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">set!</span></span> Transformers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pattern-macros.html#%28part._.Macro-.Generating_.Macros%29" class="toclink" data-pltdoc="x">16.1.7<span class="hspace">&nbsp;</span>Macro-Generating Macros</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="pattern-macros.html#%28part._pattern-macro-example%29" class="toclink" data-pltdoc="x">16.1.8<span class="hspace">&nbsp;</span>Extended Example: Call-by-Reference Functions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="proc-macros.html" class="toclink" data-pltdoc="x">16.2<span class="hspace">&nbsp;</span>General Macro Transformers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stx-obj.html" class="toclink" data-pltdoc="x">16.2.1<span class="hspace">&nbsp;</span>Syntax Objects</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="macro-transformers.html" class="toclink" data-pltdoc="x">16.2.2<span class="hspace">&nbsp;</span>Macro Transformer Procedures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-case.html" class="toclink" data-pltdoc="x">16.2.3<span class="hspace">&nbsp;</span>Mixing Patterns and Expressions: <span class="RktSym"><span class="RktStxLink">syntax-case</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="with-syntax.html" class="toclink" data-pltdoc="x">16.2.4<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">with-syntax</span></span> and <span class="RktSym"><span class="RktValLink">generate-temporaries</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stx-phases.html" class="toclink" data-pltdoc="x">16.2.5<span class="hspace">&nbsp;</span>Compile and Run-Time Phases</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="phases.html" class="toclink" data-pltdoc="x">16.2.6<span class="hspace">&nbsp;</span>General Phase Levels</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="phases.html#%28part._.Phases_and_.Bindings%29" class="toclink" data-pltdoc="x">16.2.6.1<span class="hspace">&nbsp;</span>Phases and Bindings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="phases.html#%28part._.Phases_and_.Modules%29" class="toclink" data-pltdoc="x">16.2.6.2<span class="hspace">&nbsp;</span>Phases and Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stx-certs.html" class="toclink" data-pltdoc="x">16.2.7<span class="hspace">&nbsp;</span>Tainted Syntax</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="macro-module.html" class="toclink" data-pltdoc="x">16.3<span class="hspace">&nbsp;</span>Module Instantiations and Visits</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="macro-module.html#%28part._.Declaration_versus_.Instantiation%29" class="toclink" data-pltdoc="x">16.3.1<span class="hspace">&nbsp;</span>Declaration versus Instantiation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="macro-module.html#%28part._compile-time-instantiation%29" class="toclink" data-pltdoc="x">16.3.2<span class="hspace">&nbsp;</span>Compile-Time Instantiation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="macro-module.html#%28part._.Visiting_.Modules%29" class="toclink" data-pltdoc="x">16.3.3<span class="hspace">&nbsp;</span>Visiting Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="macro-module.html#%28part._stx-available-module%29" class="toclink" data-pltdoc="x">16.3.4<span class="hspace">&nbsp;</span>Lazy Visits via Available Modules</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="code-inspectors_protect.html" title="backward to &quot;15.4 Code Inspectors for Trusted and Untrusted Code&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="pattern-macros.html" title="forward to &quot;16.1 Pattern-Based Macros&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/magnify.png b/clones/download.racket-lang.org/releases/8.6/doc/guide/magnify.png
new file mode 100644
index 0000000000000000000000000000000000000000..8556e407323719a5099dd6518622cfeb86a2bf4f
GIT binary patch
literal 323
zcmV-J0lfZ+P)<h;3K|Lk000e1NJLTq000;O000;W1^@s6;CDUv0003BNkl<Zc%1Fj
ztxf|$6vgph`KW6(rfOC3JV6Dv9>*&n3&CLE8Ne1^0)+#CL^Wwri-Lq8NEXq%q-k0@
zJAi1yKN&H1&zy6UxwEW0jm&dx^iafpgj>AK3pX>&2e`ow-qFH7F0hTe49_plQKGZp
zTL<F^&*C@?n%`)e(ZHatc?-`LcRo)iv~Ac(4CvtjlLYMq_i-jUpukh2R%nYl0okMm
zjIdk7w;N}YY2#JKC8yB96+TQyaMhTO)fm&tyo~i`I!((ST8Y!y;?@fDOB~MBuA{@p
z2&yKli#?p+ET{7__SMg^g+7jA^`n-=D)S%lZ@!d+zcil@_*L`j9Smn`!w6arJ^{}{
VNxoaDPc8re002ovPDHLkV1m?Rj)?#O

literal 0
HcmV?d00001

diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/match.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/match.html
new file mode 100644
index 00000000..74620af1
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/match.html
@@ -0,0 +1,31 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>12&nbsp;Pattern Matching</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9660;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublistonly" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewselflink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="for.html" title="backward to &quot;11 Iterations and Comprehensions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="classes.html" title="forward to &quot;13 Classes and Objects&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;match&quot;">12<tt>&nbsp;</tt><a name="(part._match)"></a>Pattern Matching</h3><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span> form supports pattern matching on arbitrary Racket
+values, as opposed to functions like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span> that
+compare regular expressions to byte and character sequences (see
+<a href="regexp.html" data-pltdoc="x">Regular Expressions</a>).</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVar">target-expr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span> form takes the result of <span class="RktSym">target-expr</span> and
+tries to match each <span class="RktVar">pattern</span> in order. As soon as it finds a
+match, it evaluates the corresponding <span class="RktVar">expr</span> sequence to
+obtain the result for the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span> form. If <span class="RktVar">pattern</span>
+includes <a name="(tech._pattern._variable)"></a><span style="font-style: italic">pattern variables</span>, they are treated like wildcards,
+and each variable is bound in the <span class="RktVar">expr</span> to the input
+fragments that it matched.</p><p>Most Racket literal expressions can be used as patterns:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">one</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">two</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">three</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'two</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVal">#t</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">yes</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">no</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'no</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVal">'</span><span class="RktVal">apple</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">symbol</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">string</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">boolean</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'string</span></p></td></tr></table></blockquote><p>Constructors like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span>, and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=vectors.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._vector%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">vector</a></span>
+can be used to create patterns that match pairs, lists, and vectors:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">one</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">two</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'two</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">. </span><span class="RktVal">2</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">list</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">pair</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'pair</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">list</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=vectors.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._vector%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">vector</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">vector</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'vector</span></p></td></tr></table></blockquote><p>A constructor bound with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span> also can be used as a pattern
+constructor:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">shoe</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktSym">color</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">hat</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktSym">style</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hat</span><span class="hspace">&nbsp;</span><span class="RktVal">23</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">bowler</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">shoe</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">white</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"bottom"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">hat</span><span class="hspace">&nbsp;</span><span class="RktVal">23</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">bowler</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"top"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"top"</span></p></td></tr></table></blockquote><p>Unquoted, non-constructor identifiers in a pattern are <a href="match.html#%28tech._pattern._variable%29" class="techoutside" data-pltdoc="x"><span class="techinside">pattern
+variables</span></a> that are bound in the result expressions, except <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span>,
+which does not bind (and thus is usually used as a catch-all):</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hat</span><span class="hspace">&nbsp;</span><span class="RktVal">23</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">bowler</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">shoe</span><span class="hspace">&nbsp;</span><span class="RktSym">sz</span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">sz</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">hat</span><span class="hspace">&nbsp;</span><span class="RktSym">sz</span><span class="hspace">&nbsp;</span><span class="RktSym">stl</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">sz</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">23</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hat</span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">cowboy</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">shoe</span><span class="hspace">&nbsp;</span><span class="RktSym">sz</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">black</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a-good-shoe</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">hat</span><span class="hspace">&nbsp;</span><span class="RktSym">sz</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">bowler</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a-good-hat</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">something-else</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'something-else</span></p></td></tr></table></blockquote><p>Note that the identifier <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span> is <span style="font-weight: bold">not</span> a reserved catch-all (like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span>).
+If <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span> appears in a pattern then its binding from
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a> may be shadowed, and this can cause problems with
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=case.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case</a></span>.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=case.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">eval:15:0: case: bad syntax (not a datum sequence)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: a datum sequence or the binding 'else' from</span></p></td></tr><tr><td><p><span class="RktErr">racket/base</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: a locally bound identifier</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: else</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (case 2 ((a 1 b) 3) (else 4))</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">not-evaluated</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">also-not-evaluated</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote><p>To match against a value bound to an identifier, use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._%7E3d%7E3d%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">==</a></span>.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktVal">42</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">42</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._%7E3d%7E3d%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">==</a></span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">matched</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'matched</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">43</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._%7E3d%7E3d%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">==</a></span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">not-matched</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">this-branch-is-evaluated</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'this-branch-is-evaluated</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">43</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">without </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._%7E3d%7E3d%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">==</a></span><span class="RktCmt">, </span><span class="RktSym">val</span><span class="RktCmt"> is a pattern variable</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._format%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"match binds val to ~a"</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"match binds val to 43"</span></p></td></tr></table></blockquote><p>An ellipsis, written <span class="RktInBG"><span class="hspace"></span><span class="RktIn">...</span><span class="hspace"></span></span>, acts like a Kleene star within a
+list or vector pattern: the preceding sub-pattern can be used to match
+any number of times for any number of consecutive elements of the list
+or vector. If a sub-pattern followed by an ellipsis includes a pattern
+variable, the variable matches multiple times, and it is bound in the
+result expression to a list of matches:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">ones</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">other</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'ones</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">ones</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">other</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'other</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(2 3)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hat</span><span class="hspace">&nbsp;</span><span class="RktVal">23</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">bowler</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hat</span><span class="hspace">&nbsp;</span><span class="RktVal">22</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">pork-pie</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">hat</span><span class="hspace">&nbsp;</span><span class="RktSym">sz</span><span class="hspace">&nbsp;</span><span class="RktSym">styl</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sz</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">45</span></p></td></tr></table></blockquote><p>Ellipses can be nested to match nested repetitions, and in that case,
+pattern variables can be bound to lists of lists of matches:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">!</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">!</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">!</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">!</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'((1) (2 2) (3 3 3))</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span> form  (see <a href="qq.html" data-pltdoc="x">Quasiquoting: <span class="RktSym"><span class="RktStxLink">quasiquote</span></span> and <span class="RktVal">&lsquo;</span></a> for more about it) can also be used to build patterns.
+While unquoted portions of a normal quasiquoted form mean regular racket evaluation, here unquoted
+portions mean go back to regular pattern matching.</p><p>So, in the example below, the with expression is the pattern and it gets rewritten into the
+application expression, using quasiquote as a pattern in the first instance and quasiquote
+to build an expression in the second.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">`</span><span class="RktVal">{</span><span class="RktVal">with</span><span class="hspace">&nbsp;</span><span class="RktVal">{</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">}</span><span class="hspace">&nbsp;</span><span class="RktVal">{</span><span class="RktVal">+</span><span class="hspace">&nbsp;</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktVal">}</span><span class="RktVal">}</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVal">`</span><span class="RktVal">{</span><span class="RktVal">with</span><span class="hspace">&nbsp;</span><span class="RktVal">{</span><span class="RktRdr">,</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktRdr">,</span><span class="RktSym">rhs</span><span class="RktVal">}</span><span class="hspace">&nbsp;</span><span class="RktRdr">,</span><span class="RktSym">body</span><span class="RktVal">}</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">`</span><span class="RktVal">{</span><span class="RktVal">{</span><span class="RktVal">lambda</span><span class="hspace">&nbsp;</span><span class="RktVal">{</span><span class="RktRdr">,</span><span class="RktSym">id</span><span class="RktVal">}</span><span class="hspace">&nbsp;</span><span class="RktRdr">,</span><span class="RktSym">body</span><span class="RktVal">}</span><span class="hspace">&nbsp;</span><span class="RktRdr">,</span><span class="RktSym">rhs</span><span class="RktVal">}</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'((lambda (x) (+ x 1)) 1)</span></p></td></tr></table></blockquote><p>For information on many more pattern forms, see <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/match</span></a>.</p><p>Forms like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match-let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match-let</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match-lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match-lambda</a></span> support
+patterns in positions that otherwise must be identifiers. For example,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match-let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match-let</a></span> generalizes <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> to a <a name="(idx._(gentag._3._(lib._scribblings/guide/guide..scrbl)))"></a>destructing
+bind:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match-let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match-let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(3 2 1)</span></p></td></tr></table></blockquote><p>For information on these additional forms, see <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/match</span></a>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html&amp;version=8.6" class="Sq" data-pltdoc="x">Pattern Matching</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on pattern matching.</p></blockquote></blockquote></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="for.html" title="backward to &quot;11 Iterations and Comprehensions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="classes.html" title="forward to &quot;13 Classes and Objects&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/mk-namespace.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/mk-namespace.html
new file mode 100644
index 00000000..e068f81b
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/mk-namespace.html
@@ -0,0 +1,77 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15.2&nbsp;Manipulating Namespaces</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewselflink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="eval.html" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eval</span></span></a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="mk-namespace.html" class="tocviewselflink" data-pltdoc="x">Manipulating Namespaces</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="load.html" class="tocviewlink" data-pltdoc="x">Scripting Evaluation and Using <span class="RktSym"><span class="RktValLink">load</span></span></a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="code-inspectors_protect.html" class="tocviewlink" data-pltdoc="x">Code Inspectors for Trusted and Untrusted Code</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>15.2&nbsp;</td><td><a href="mk-namespace.html" class="tocviewselflink" data-pltdoc="x">Manipulating Namespaces</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.2.1&nbsp;</td><td><a href="mk-namespace.html#%28part._.Creating_and_.Installing_.Namespaces%29" class="tocviewlink" data-pltdoc="x">Creating and Installing Namespaces</a></td></tr><tr><td align="right">15.2.2&nbsp;</td><td><a href="mk-namespace.html#%28part._.Sharing_.Data_and_.Code_.Across_.Namespaces%29" class="tocviewlink" data-pltdoc="x">Sharing Data and Code Across Namespaces</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">15.2.1<tt>&nbsp;</tt></span><a href="mk-namespace.html#%28part._.Creating_and_.Installing_.Namespaces%29" class="tocsubseclink" data-pltdoc="x">Creating and Installing Namespaces</a></td></tr><tr><td><span class="tocsublinknumber">15.2.2<tt>&nbsp;</tt></span><a href="mk-namespace.html#%28part._.Sharing_.Data_and_.Code_.Across_.Namespaces%29" class="tocsubseclink" data-pltdoc="x">Sharing Data and Code Across Namespaces</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="eval.html" title="backward to &quot;15.1 eval&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="reflection.html" title="up to &quot;15 Reflection and Dynamic Evaluation&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="load.html" title="forward to &quot;15.3 Scripting Evaluation and Using load&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;mk-namespace&quot;">15.2<tt>&nbsp;</tt><a name="(part._mk-namespace)"></a>Manipulating Namespaces</h4><p>A <a href="eval.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespace</span></a> encapsulates two pieces of information:</p><ul><li><p>A mapping from identifiers to bindings. For example, a
+namespace might map the identifier <span class="RktSym">lambda</span> to the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> form. An &ldquo;empty&rdquo; namespace is one that maps
+every identifier to an uninitialized top-level variable.</p></li><li><p>A mapping from module names to module declarations and
+instances. (The distinction between declaration and instance is
+discussed in <a href="macro-module.html" data-pltdoc="x">Module Instantiations and Visits</a>.)</p></li></ul><p>The first mapping is used for evaluating expressions in a top-level
+context, as in <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">lambda</span><span class="stt"> </span><span class="RktVal">(</span><span class="RktVal">x</span><span class="RktVal">)</span><span class="stt"> </span><span class="RktVal">(</span><span class="RktVal">+</span><span class="stt"> </span><span class="RktVal">x</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span>. The second
+mapping is used, for example, by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Module_Names_and_Loading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._dynamic-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">dynamic-require</a></span> to locate a
+module. The call <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">require</span><span class="stt"> </span><span class="RktVal">racket/base</span><span class="RktVal">)</span><span class="RktPn">)</span> normally uses
+both pieces: the identifier mapping determines the binding of
+<span class="RktSym">require</span>; if it turns out to mean <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>, then
+the module mapping is used to locate the <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a>
+module.</p><p>From the perspective of the core Racket run-time system, all
+evaluation is reflective. Execution starts with an initial namespace
+that contains a few primitive modules, and that is further populated
+by loading files and modules as specified on the command line or as
+supplied in the <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>. Top-level <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> forms adjusts the identifier mapping, and module
+declarations (typically loaded on demand for a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> form)
+adjust the module mapping.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Creating_and_Installing_Namespaces&quot;">15.2.1<tt>&nbsp;</tt><a name="(part._.Creating_and_.Installing_.Namespaces)"></a>Creating and Installing Namespaces</h5><p>The function <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-empty-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-empty-namespace</a></span> creates a new, empty
+<a href="eval.html#%28tech._namespace%29" class="techoutside" data-pltdoc="x"><span class="techinside">namespace</span></a>. Since the namespace is truly empty, it cannot at
+first be used to evaluate any top-level expression&#8212;<wbr></wbr>not even
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktSym">racket</span><span class="RktPn">)</span>. In particular,</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-namespace</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-empty-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-empty-namespace</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._namespace-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">namespace-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racket</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>fails, because the namespace does not include the primitive modules on
+which <span class="RktSym">racket</span> is built.</p><p>To make a namespace useful, some modules must be <a name="(tech._attached)"></a><span style="font-style: italic">attached</span>
+from an existing namespace. Attaching a module adjusts the mapping of
+module names to instances by transitively copying entries (the module
+and all its imports) from an existing namespace&rsquo;s mapping. Normally,
+instead of just attaching the primitive modules&#8212;<wbr></wbr>whose names and
+organization are subject to change&#8212;<wbr></wbr>a higher-level module is
+attached, such as <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a> or
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a>.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._make-base-empty-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-base-empty-namespace</a></span> function provides a namespace
+that is empty, except that <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a> is
+attached. The resulting namespace is still &ldquo;empty&rdquo; in the sense that
+the identifiers-to-bindings part of the namespace has no mappings;
+only the module mapping has been populated. Nevertheless, with an
+initial module mapping, further modules can be loaded.</p><p>A namespace created with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._make-base-empty-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-base-empty-namespace</a></span> is
+suitable for many basic dynamic tasks. For example, suppose that a
+<span class="RktMod">my-dsl</span> library implements a domain-specific language
+in which you want to execute commands from a user-specified file. A
+namespace created with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._make-base-empty-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-base-empty-namespace</a></span> is enough to
+get started:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">run-dsl</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._file%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">file</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-namespace</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._make-base-empty-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-base-empty-namespace</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._namespace-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">namespace-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">my-dsl</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._load%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">load</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._file%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">file</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Note that the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span> of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-namespace</a></span> does
+not affect the meaning of identifiers like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._namespace-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">namespace-require</a></span>
+within the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span> body. Those identifiers obtain their
+meaning from the enclosing context (probably a module). Only
+expressions that are dynamic with respect to this code, such as the
+content of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._load%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">load</a></span>ed files, are affected by the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span>.</p><p>Another subtle point in the above example is the use of
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._namespace-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">namespace-require</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">my-dsl</span><span class="RktPn">)</span> instead of <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">require</span><span class="stt"> </span><span class="RktVal">my-dsl</span><span class="RktVal">)</span><span class="RktPn">)</span>. The latter would not work, because <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span>
+needs to obtain a meaning for <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> in the namespace, and
+the namespace&rsquo;s identifier mapping is initially empty. The
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._namespace-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">namespace-require</a></span> function, in contrast, directly imports the
+given module into the current namespace.  Starting with
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._namespace-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">namespace-require</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">racket/base</span><span class="RktPn">)</span> would introduce a binding
+for <span class="RktSym">require</span> and make a subsequent <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">require</span><span class="stt"> </span><span class="RktVal">my-dsl</span><span class="RktVal">)</span><span class="RktPn">)</span> work. The above is better, not only because it is
+more compact, but also because it avoids introducing bindings that are
+not part of the domain-specific languages.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Sharing_Data_and_Code_Across_Namespaces&quot;">15.2.2<tt>&nbsp;</tt><a name="(part._.Sharing_.Data_and_.Code_.Across_.Namespaces)"></a>Sharing Data and Code Across Namespaces</h5><p>Modules not attached to a new namespace will be loaded and
+instantiated afresh if they are demanded by evaluation. For example,
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a> does not include
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=mzlib_class.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/class</span></a>, and loading <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=mzlib_class.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/class</span></a>
+again will create a distinct class datatype:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/class</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">class?</span><span class="hspace">&nbsp;</span><span class="RktSym">object%</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">class?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-namespace</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._make-base-empty-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-base-empty-namespace</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._namespace-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">namespace-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racket/class</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">loads again</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">object%</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote><p>For cases when dynamically loaded code needs to share more code and
+data with its context, use the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._namespace-attach-module%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">namespace-attach-module</a></span>
+function. The first argument to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._namespace-attach-module%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">namespace-attach-module</a></span> is a
+source namespace from which to draw a module instance; in some cases,
+the current namespace is known to include the module that needs to be
+shared:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/class</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">class?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ns</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._make-base-empty-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-base-empty-namespace</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._namespace-attach-module%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">namespace-attach-module</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-namespace</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racket/class</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">ns</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-namespace</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ns</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._namespace-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">namespace-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racket/class</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">uses attached</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">object%</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote><p>Within a module, however, the combination of
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-namespace-anchor%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-namespace-anchor</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._namespace-anchor-%7E3eempty-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">namespace-anchor-&gt;empty-namespace</a></span> offers a more reliable
+method for obtaining a source namespace:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/class</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-namespace-anchor%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-namespace-anchor</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">load-plug-in</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._file%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">file</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ns</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._make-base-empty-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-base-empty-namespace</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._namespace-attach-module%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">namespace-attach-module</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._namespace-anchor-%7E3eempty-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">namespace-anchor-&gt;empty-namespace</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">racket/class</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">ns</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-namespace</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ns</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Module_Names_and_Loading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._dynamic-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">dynamic-require</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._file%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">file</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">plug-in%</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The anchor bound by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._namespace-attach-module%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">namespace-attach-module</a></span> connects the
+run time of a module with the namespace in which a module is loaded
+(which might differ from the current namespace).  In the above
+example, since the enclosing module requires
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=mzlib_class.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/class</span></a>, the namespace produced by
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._namespace-anchor-%7E3eempty-namespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">namespace-anchor-&gt;empty-namespace</a></span> certainly contains an
+instance of <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=mzlib_class.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/class</span></a>. Moreover, that instance is
+the same as the one imported into the module, so the class datatype is
+shared.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="eval.html" title="backward to &quot;15.1 eval&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="reflection.html" title="up to &quot;15 Reflection and Dynamic Evaluation&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="load.html" title="forward to &quot;15.3 Scripting Evaluation and Using load&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/module-basics.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/module-basics.html
new file mode 100644
index 00000000..9f3bde4f
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/module-basics.html
@@ -0,0 +1,186 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6.1&nbsp;Module Basics</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewselflink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="module-basics.html" class="tocviewselflink" data-pltdoc="x">Module Basics</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="Module_Syntax.html" class="tocviewlink" data-pltdoc="x">Module Syntax</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="module-paths.html" class="tocviewlink" data-pltdoc="x">Module Paths</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="module-require.html" class="tocviewlink" data-pltdoc="x">Imports:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span></a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="module-provide.html" class="tocviewlink" data-pltdoc="x">Exports:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="module-set.html" class="tocviewlink" data-pltdoc="x">Assignment and Redefinition</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="module-macro.html" class="tocviewlink" data-pltdoc="x">Modules and Macros</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="protect-out.html" class="tocviewlink" data-pltdoc="x">Protected Exports</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>6.1&nbsp;</td><td><a href="module-basics.html" class="tocviewselflink" data-pltdoc="x">Module Basics</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1.1&nbsp;</td><td><a href="module-basics.html#%28part._module-org%29" class="tocviewlink" data-pltdoc="x">Organizing Modules</a></td></tr><tr><td align="right">6.1.2&nbsp;</td><td><a href="module-basics.html#%28part._.Library_.Collections%29" class="tocviewlink" data-pltdoc="x">Library Collections</a></td></tr><tr><td align="right">6.1.3&nbsp;</td><td><a href="module-basics.html#%28part._packages-and-collections%29" class="tocviewlink" data-pltdoc="x">Packages and Collections</a></td></tr><tr><td align="right">6.1.4&nbsp;</td><td><a href="module-basics.html#%28part._link-collection%29" class="tocviewlink" data-pltdoc="x">Adding Collections</a></td></tr><tr><td align="right">6.1.5&nbsp;</td><td><a href="module-basics.html#%28part._intracollection%29" class="tocviewlink" data-pltdoc="x">Module References Within a Collection</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">6.1.1<tt>&nbsp;</tt></span><a href="module-basics.html#%28part._module-org%29" class="tocsubseclink" data-pltdoc="x">Organizing Modules</a></td></tr><tr><td><span class="tocsublinknumber">6.1.2<tt>&nbsp;</tt></span><a href="module-basics.html#%28part._.Library_.Collections%29" class="tocsubseclink" data-pltdoc="x">Library Collections</a></td></tr><tr><td><span class="tocsublinknumber">6.1.3<tt>&nbsp;</tt></span><a href="module-basics.html#%28part._packages-and-collections%29" class="tocsubseclink" data-pltdoc="x">Packages and Collections</a></td></tr><tr><td><span class="tocsublinknumber">6.1.4<tt>&nbsp;</tt></span><a href="module-basics.html#%28part._link-collection%29" class="tocsubseclink" data-pltdoc="x">Adding Collections</a></td></tr><tr><td><span class="tocsublinknumber">6.1.5<tt>&nbsp;</tt></span><a href="module-basics.html#%28part._intracollection%29" class="tocsubseclink" data-pltdoc="x">Module References Within a Collection</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="modules.html" title="backward to &quot;6 Modules&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="modules.html" title="up to &quot;6 Modules&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Module_Syntax.html" title="forward to &quot;6.2 Module Syntax&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;module-basics&quot;">6.1<tt>&nbsp;</tt><a name="(part._module-basics)"></a>Module Basics</h4><p>Each Racket module typically resides in its own file. For example,
+suppose the file <span class="stt">"cake.rkt"</span> contains the following module:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"cake.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">print-cake</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">draws a cake with </span><span class="RktSym">n</span><span class="RktCmt"> candles</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">print-cake</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">"</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">~a</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">#\.</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">" .-~a-. "</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">#\|</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">" | ~a | "</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">#\space</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktVal">"---~a---"</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">#\-</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktSym">fmt</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fmt</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">ch</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Output.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._newline%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">newline</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>Then, other modules can import <span class="stt">"cake.rkt"</span> to use the
+<span class="RktSym">print-cake</span> function, since the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span> line in
+<span class="stt">"cake.rkt"</span> explicitly exports the definition
+<span class="RktSym">print-cake</span>. The <span class="RktSym">show</span> function is private to
+<span class="stt">"cake.rkt"</span> (i.e., it cannot be used from other modules),
+since <span class="RktSym">show</span> is not exported.</p><p>The following <span class="stt">"random-cake.rkt"</span> module imports
+<span class="stt">"cake.rkt"</span>:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"random-cake.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"cake.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">print-cake</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._random%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">random</a></span><span class="hspace">&nbsp;</span><span class="RktVal">30</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>The relative reference <span class="RktVal">"cake.rkt"</span> in the import
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktVal">"cake.rkt"</span><span class="RktPn">)</span> works if the <span class="stt">"cake.rkt"</span> and
+<span class="stt">"random-cake.rkt"</span> modules are in the same
+directory. Unix-style relative paths are used for relative module
+references on all platforms, much like relative URLs in HTML pages.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;module-org&quot;">6.1.1<tt>&nbsp;</tt><a name="(part._module-org)"></a>Organizing Modules</h5><p>The <span class="stt">"cake.rkt"</span> and <span class="stt">"random-cake.rkt"</span> example
+demonstrates the most common way to organize a program into modules:
+put all module files in a single directory (perhaps with
+subdirectories), and then have the modules reference each other
+through relative paths. A directory of modules can act as a
+project, since it can be moved around on the filesystem or copied to
+other machines, and relative paths preserve the connections among
+modules.</p><p>As another example, if you are building a candy-sorting program, you
+might have a main <span class="stt">"sort.rkt"</span> module that uses other modules
+to access a candy database and a control sorting machine. If the
+candy-database module itself is organized into sub-modules that handle
+barcode and manufacturer information, then the database module could
+be <span class="stt">"db/lookup.rkt"</span> that uses helper modules
+<span class="stt">"db/barcodes.rkt"</span> and <span class="stt">"db/makers.rkt"</span>.  Similarly,
+the sorting-machine driver <span class="stt">"machine/control.rkt"</span> might use
+helper modules <span class="stt">"machine/sensors.rkt"</span> and
+<span class="stt">"machine/actuators.rkt"</span>.</p><blockquote class="SCentered"><p><img style="vertical-align: -16.830078125px; margin: -3px -3px -3px -3px;" src="pict.png" alt="image" width="462.33203125" height="322.0"/></p></blockquote><p>The <span class="stt">"sort.rkt"</span> module uses the relative paths
+<span class="stt">"db/lookup.rkt"</span> and <span class="stt">"machine/control.rkt"</span> to import
+from the database and machine-control libraries:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"sort.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"db/lookup.rkt"</span><span class="hspace">&nbsp;</span><span class="RktVal">"machine/control.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktSym">....</span></td></tr></table></blockquote></blockquote></blockquote><p>The <span class="stt">"db/lookup.rkt"</span> module similarly uses paths relative to
+its own source to access the <span class="stt">"db/barcodes.rkt"</span> and
+<span class="stt">"db/makers.rkt"</span> modules:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"db/lookup.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"barcode.rkt"</span><span class="hspace">&nbsp;</span><span class="RktVal">"makers.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktSym">....</span></td></tr></table></blockquote></blockquote></blockquote><p>Ditto for <span class="stt">"machine/control.rkt"</span>:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"machine/control.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"sensors.rkt"</span><span class="hspace">&nbsp;</span><span class="RktVal">"actuators.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktSym">....</span></td></tr></table></blockquote></blockquote></blockquote><p>Racket tools all work automatically with relative paths. For example,</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">racket sort.rkt</span></p><p>on the command line runs the <span class="stt">"sort.rkt"</span> program and
+automatically loads and compiles required modules. With a large enough
+program, compilation from source can take too long, so use</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">raco make sort.rkt</span></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=make.html&amp;version=8.6" class="Sq" data-pltdoc="x"><span class="stt">raco make</span>: Compiling Source to Bytecode</a> for more information on <span class="stt">raco make</span>.</p></blockquote></blockquote></blockquote><p>to compile <span class="stt">"sort.rkt"</span> and all its dependencies to bytecode
+files. Running <span class="stt">racket sort.rkt</span> will automatically use bytecode
+files when they are present.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Library_Collections&quot;">6.1.2<tt>&nbsp;</tt><a name="(part._.Library_.Collections)"></a>Library Collections</h5><p>A <a name="(tech._collection)"></a><span style="font-style: italic">collection</span> is a hierarchical grouping of installed library modules.  A
+module in a <a href="module-basics.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection</span></a> is referenced through an unquoted,
+suffixless path. For example, the following module refers to the
+<span class="stt">"date.rkt"</span> library that is part of the <span class="stt">"racket"</span>
+<a href="module-basics.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection</span></a>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/date</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Today is ~s\n"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528def._%2528%2528lib._racket%252Fdate..rkt%2529._date-%7E3estring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">date-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._seconds-%7E3edate%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">seconds-&gt;date</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-seconds%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-seconds</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>When you search the online Racket documentation, the search results
+indicate the module that provides each binding. Alternatively, if you
+reach a binding&rsquo;s documentation by clicking on hyperlinks, you can
+hover over the binding name to find out which modules provide
+it.</p><p>A module reference like <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528mod-path._racket%252Fdate%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/date</span></a> looks like an
+identifier, but it is not treated in the same way as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span>
+or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528def._%2528%2528lib._racket%252Fdate..rkt%2529._date-%7E3estring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">date-&gt;string</a></span>. Instead, when <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> sees a module
+reference that is unquoted, it converts the reference to a
+collection-based module path:</p><ul><li><p>First, if the unquoted path contains no <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>, then
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> automatically adds a <span class="stt">"/main"</span> to the
+reference. For example, <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=slideshow&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">slideshow</span></a><span class="RktPn">)</span> is equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktSym">slideshow/main</span><span class="RktPn">)</span>.</p></li><li><p>Second, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> implicitly adds a <span class="stt">".rkt"</span>
+suffix to the path.</p></li><li><p>Finally, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> resolves the path by searching among
+installed <a href="module-basics.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collections</span></a>, instead of treating the path as relative to
+the enclosing module&rsquo;s path.</p></li></ul><p>To a first approximation, a <a href="module-basics.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection</span></a> is implemented as a
+filesystem directory. For example, the <span class="stt">"racket"</span> collection is
+mostly located in a <span class="stt">"racket"</span> directory within the Racket
+installation&rsquo;s <span class="stt">"collects"</span> directory, as reported by</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">setup/dirs</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Manipulating_Paths.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._build-path%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">build-path</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=dirs.html%23%2528def._%2528%2528lib._setup%252Fdirs..rkt%2529._find-collects-dir%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">find-collects-dir</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">main collection directory</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"racket"</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The Racket installation&rsquo;s <span class="stt">"collects"</span> directory, however, is
+only one place that <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> looks for collection directories.
+Other places include the user-specific directory reported by
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=dirs.html%23%2528def._%2528%2528lib._setup%252Fdirs..rkt%2529._find-user-collects-dir%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">find-user-collects-dir</a></span><span class="RktPn">)</span> and directories configured through
+the <span class="stt">PLTCOLLECTS</span> search path. Finally, and most typically,
+collections are found through installed <a href="module-basics.html#%28tech._package%29" class="techoutside" data-pltdoc="x"><span class="techinside">packages</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;packages-and-collections&quot;">6.1.3<tt>&nbsp;</tt><a name="(part._packages-and-collections)"></a>Packages and Collections</h5><p><div class="SIntrapara">A <a name="(tech._package)"></a><span style="font-style: italic">package</span> is a set of libraries that are installed through
+the Racket package manager (or included as pre-installed in a Racket
+distribution). For example, the <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/gui</span></a> library is
+provided by the <span class="stt">"gui"</span> package, while
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=parser-tools&amp;rel=Lexers.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">parser-tools/lex</span></a> is provided by the
+<span class="stt">"parser-tools"</span> library.</div><div class="SIntrapara"><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>More precisely,
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=gui&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/gui</span></a> is provided by <span class="stt">"gui-lib"</span>,
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=parser-tools&amp;rel=Lexers.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">parser-tools/lex</span></a> is provided by
+<span class="stt">"parser-tools-lib"</span>, and the <span class="stt">"gui"</span> and
+<span class="stt">"parser-tools"</span> packages extend <span class="stt">"gui-lib"</span> and
+<span class="stt">"parser-tools-lib"</span> with documentation.</p></blockquote></blockquote></blockquote></div></p><p>Racket programs do not refer to <a href="module-basics.html#%28tech._package%29" class="techoutside" data-pltdoc="x"><span class="techinside">packages</span></a> directly. Instead,
+programs refer to libraries via <a href="module-basics.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collections</span></a>, and adding or
+removing a <a href="module-basics.html#%28tech._package%29" class="techoutside" data-pltdoc="x"><span class="techinside">package</span></a> changes the set of collection-based
+libraries that are available. A single package can supply
+libraries in multiple collections, and two different packages can
+supply libraries in the same collection (but not the same libraries,
+and the package manager ensures that installed packages do not
+conflict at that level).</p><p>For more information about packages, see <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=pkg&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">Package Management in Racket</a>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;link-collection&quot;">6.1.4<tt>&nbsp;</tt><a name="(part._link-collection)"></a>Adding Collections</h5><p>Looking back at the candy-sorting example of <a href="module-basics.html#%28part._module-org%29" data-pltdoc="x">Organizing Modules</a>,
+suppose that modules in <span class="stt">"db/"</span> and <span class="stt">"machine/"</span> need a
+common set of helper functions. Helper functions could be put in a
+<span class="stt">"utils/"</span> directory, and modules in <span class="stt">"db/"</span> or
+<span class="stt">"machine/"</span> could access utility modules with relative paths
+that start <span class="stt">"../utils/"</span>. As long as a set of modules work
+together in a single project, it&rsquo;s best to stick with relative paths.
+A programmer can follow relative-path references without knowing about
+your Racket configuration.</p><p>Some libraries are meant to be used across multiple projects, so that
+keeping the library source in a directory with its uses does not make
+sense. In that case, the best option is add a new
+<a href="module-basics.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection</span></a>. After the library is in a collection, it can be
+referenced with an unquoted path, just like libraries that are
+included with the Racket distribution.</p><p>You could add a new collection by placing files in the Racket
+installation or one of the directories reported by
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=dirs.html%23%2528def._%2528%2528lib._setup%252Fdirs..rkt%2529._get-collects-search-dirs%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">get-collects-search-dirs</a></span><span class="RktPn">)</span>. Alternatively, you could add to
+the list of searched directories by setting the <span class="stt">PLTCOLLECTS</span>
+environment variable.<span class="refelem"><span class="refcolumn"><span class="refcontent">If you set <span class="stt">PLTCOLLECTS</span>,
+include an empty path in by starting the value with a colon (Unix and
+Mac OS) or semicolon (Windows) so that the original search paths are
+preserved.</span></span></span> The best option, however, is to add a <a href="module-basics.html#%28tech._package%29" class="techoutside" data-pltdoc="x"><span class="techinside">package</span></a>.</p><p>Creating a package <span class="emph">does not</span> mean that you have to register with
+a package server or perform a bundling step that copies your source
+code into an archive format. Creating a package can simply mean using
+the package manager to make your libraries locally accessible as a
+collection from their current source locations.</p><p>For example, suppose you have a directory <span class="stt">"/usr/molly/bakery"</span>
+that contains the <span class="stt">"cake.rkt"</span> module (from the
+<a href="module-basics.html" data-pltdoc="x">beginning</a> of this section) and other
+related modules. To make the modules available as a <span class="stt">"bakery"</span>
+collection, either</p><ul><li><p>Use the <span class="stt">raco pkg</span> command-line tool:</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">raco pkg install --link /usr/molly/bakery</span></p><p>where the <span class="nobreak"><span class="stt">--link</span></span> flag is not actually needed when the
+provided path includes a directory separator.</p></li><li><p>Use DrRacket&rsquo;s <span class="ssansserif">Package Manager</span> item from the
+<span class="ssansserif">File</span> menu. In the <span class="ssansserif">Do What I Mean</span> panel,
+click <span class="ssansserif">Browse...</span>, choose the
+<span class="stt">"/usr/molly/bakery"</span> directory, and click
+<span class="ssansserif">Install</span>.</p></li></ul><p>Afterward, <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktSym">bakery/cake</span><span class="RktPn">)</span> from any module will import
+the <span class="RktSym">print-cake</span> function from
+<span class="stt">"/usr/molly/bakery/cake.rkt"</span>.</p><p>By default, the name of the directory that you install is used both as
+the <a href="module-basics.html#%28tech._package%29" class="techoutside" data-pltdoc="x"><span class="techinside">package</span></a> name and as the <a href="module-basics.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection</span></a> that is provided
+by the package.  Also, the package manager normally defaults to
+installation only for the current user, as opposed to all users of a
+Racket installation. See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=pkg&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">Package Management in Racket</a> for more information.</p><p>If you intend to distribute your libraries to others, choose
+collection and package names carefully. The collection namespace is
+hierarchical, but top-level collection names are global, and the
+package namespace is flat. Consider putting one-off libraries under
+some top-level name like <span class="stt">"molly"</span> that identifies the
+producer.  Use a collection name like <span class="stt">"bakery"</span> when producing
+the definitive collection of baked-goods libraries.</p><p>After your libraries are put in a <a href="module-basics.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection</span></a> you can still
+use <span class="stt">raco make</span> to compile the library sources, but it&rsquo;s better
+and more convenient to use <span class="stt">raco setup</span>. The <span class="stt">raco setup</span>
+command takes a collection name (as opposed to a file name) and
+compiles all libraries within the collection. In addition, <span class="stt">raco setup</span> can
+build documentation for the collection and add it to the documentation
+index, as specified by a <span class="stt">"info.rkt"</span> module in the collection.
+See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=setup.html&amp;version=8.6" class="Sq" data-pltdoc="x"><span class="stt">raco setup</span>: Installation Management</a> for
+more information on <span class="stt">raco setup</span>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;intracollection&quot;">6.1.5<tt>&nbsp;</tt><a name="(part._intracollection)"></a>Module References Within a Collection</h5><p>When a module within a collection references another module within the
+same collection, either a relative path or a collection path could
+work. For example, a <span class="stt">"sort.rkt"</span> module that references
+<span class="stt">"db/lookup.rkt"</span> and <span class="stt">"machine/control.rkt"</span> modules within
+the same collection could be written with relative paths as in
+<a href="module-basics.html#%28part._module-org%29" data-pltdoc="x">Organizing Modules</a>:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"sort.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"db/lookup.rkt"</span><span class="hspace">&nbsp;</span><span class="RktVal">"machine/control.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktSym">....</span></td></tr></table></blockquote></blockquote></blockquote><p>Alternatively, if the collection is named <span class="stt">"candy"</span>, then
+<span class="stt">"sort.rkt"</span> could use collection paths to import the two
+modules:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"sort.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">candy/db/lookup</span><span class="hspace">&nbsp;</span><span class="RktSym">candy/machine/control</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktSym">....</span></td></tr></table></blockquote></blockquote></blockquote><p>For most purposes, these choices will work the same, but there are
+exceptions. When writing documentation with <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=scribble&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">Scribble</a>, you must use
+a collection path with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=scribble&amp;rel=doc-modules.html%23%2528form._%2528%2528lib._scribble%252Fmanual..rkt%2529._defmodule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">defmodule</a></span> and similar forms; that&rsquo;s
+partly because documentation is meant to be read by client
+programmers, and so the collection-based name should appear.
+Meanwhile, for <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>, using relative paths for references
+within a collection tends to be the most flexible approach, but with
+caveats.</p><p>Relative-path references work much like relative URL references: the
+reference is expanded based on the way the enclosing module is
+accessed. If the enclosing module is accessed through a filesystem
+path, then a relative path in <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> is combined with that
+filesystem path to form a new filesystem path. If the enclosing module
+is accessed through a collection path, then a relative path in
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> is combined with that collection path to form a new
+collection path. A collection path is, in turn, converted to a
+filesystem path, and so the difference between starting with a
+filesystem or collection path does not usually matter. Unfortunately,
+inherent complexities of path resolution can create differences in
+some situations:</p><ul><li><p>Through soft links, multiple mount points, or case-insensitive
+filesystems (on an operating system that does not implicitly
+case-normalize paths), there may be multiple filesystem paths
+that refer to the same module file.</p><p>For example, when the current directory is the <span class="stt">"candy"</span>
+collection&rsquo;s directory, the current-directory path that
+<span class="stt">racket</span> receives on startup may cause <span class="stt">racket
+sort.rkt</span> to use a different filesystem path than <span class="stt">racket
+-l candy/sort</span> finds through the library-collection search
+path. In that case, if <span class="stt">"sort.rkt"</span> leads to some
+modules through both relative-path references and
+collection-based references, it&rsquo;s possible that those resolve
+to difference instances of the same source module, creating
+confusion through multiple instantiations.</p></li><li><p>When <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=exe.html&amp;version=8.6" class="Sq" data-pltdoc="x"><span class="stt">raco exec</span></a> plus
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=exe-dist.html&amp;version=8.6" class="Sq" data-pltdoc="x"><span class="stt">raco distribute</span></a> are
+used to create an executable to run on a different machine, the
+paths of the current machine are likely unrelated to paths on
+the target machine. The <span class="stt">raco exe</span> tool treats modules
+that are referenced via filesystem paths differently than
+modules reference via collection paths, because only the latter
+make sense to access through reflective operations at run
+time.</p><p>For example, if <span class="stt">raco exe sort.rkt</span> creates an executable
+that uses <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Module_Names_and_Loading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._dynamic-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">dynamic-require</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">candy/db/lookup</span><span class="stt"> </span><span class="RktVal">#f</span><span class="RktPn">)</span> at run
+time, then that <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Module_Names_and_Loading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._dynamic-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">dynamic-require</a></span> will fail in the case
+that <span class="stt">"db/lookup.rkt"</span> is resolved relative to the
+filesystem path <span class="RktVal">"sort.rkt"</span> at executable-creation time.</p></li></ul><p>Using only collection-based paths (including using shell commands like
+<span class="stt">racket -l candy/sort</span> and not like <span class="stt">racket sort.rkt</span>) can
+avoid all problems, but then you must only develop modules within an
+installed collection, which is often inconvenient. Using relative-path
+references consistently tends to be the most convenient while still
+working in most circumstances.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="modules.html" title="backward to &quot;6 Modules&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="modules.html" title="up to &quot;6 Modules&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Module_Syntax.html" title="forward to &quot;6.2 Module Syntax&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/module-languages.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/module-languages.html
new file mode 100644
index 00000000..80240af6
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/module-languages.html
@@ -0,0 +1,49 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>17.1&nbsp;Module Languages</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewselflink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">17.1&nbsp;</td><td><a href="module-languages.html" class="tocviewselflink" data-pltdoc="x">Module Languages</a></td></tr><tr><td align="right">17.2&nbsp;</td><td><a href="hash-reader.html" class="tocviewlink" data-pltdoc="x">Reader Extensions</a></td></tr><tr><td align="right">17.3&nbsp;</td><td><a href="hash-languages.html" class="tocviewlink" data-pltdoc="x">Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>17.1&nbsp;</td><td><a href="module-languages.html" class="tocviewselflink" data-pltdoc="x">Module Languages</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">17.1.1&nbsp;</td><td><a href="module-languages.html#%28part._implicit-forms%29" class="tocviewlink" data-pltdoc="x">Implicit Form Bindings</a></td></tr><tr><td align="right">17.1.2&nbsp;</td><td><a href="module-languages.html#%28part._s-exp%29" class="tocviewlink" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">s-<wbr></wbr>exp</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">17.1.1<tt>&nbsp;</tt></span><a href="module-languages.html#%28part._implicit-forms%29" class="tocsubseclink" data-pltdoc="x">Implicit Form Bindings</a></td></tr><tr><td><span class="tocsublinknumber">17.1.2<tt>&nbsp;</tt></span><a href="module-languages.html#%28part._s-exp%29" class="tocsubseclink" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">s-<wbr></wbr>exp</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="languages.html" title="backward to &quot;17 Creating Languages&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="languages.html" title="up to &quot;17 Creating Languages&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="hash-reader.html" title="forward to &quot;17.2 Reader Extensions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;module-languages&quot;">17.1<tt>&nbsp;</tt><a name="(part._module-languages)"></a>Module Languages</h4><p>When using the longhand <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> form for writing modules, the
+module path that is specified after the new module&rsquo;s name provides the
+initial imports for the module. Since the initial-import module
+determines even the most basic bindings that are available in a
+module&rsquo;s body, such as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>, the initial import can be
+called a <a name="(tech._module._language)"></a><span style="font-style: italic">module language</span>.</p><p>The most common <a href="module-languages.html#%28tech._module._language%29" class="techoutside" data-pltdoc="x"><span class="techinside">module languages</span></a> are <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a> or
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a>, but you can define your own
+<a href="module-languages.html#%28tech._module._language%29" class="techoutside" data-pltdoc="x"><span class="techinside">module language</span></a> by defining a suitable module. For example,
+using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span> subforms like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._all-from-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">all-from-out</a></span>,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._except-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">except-out</a></span>, and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._rename-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">rename-out</a></span>, you can add, remove, or
+rename bindings from <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a> to produce a <a href="module-languages.html#%28tech._module._language%29" class="techoutside" data-pltdoc="x"><span class="techinside">module
+language</span></a> that is a variant of <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a>:</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="Module_Syntax.html#%28part._module-syntax%29" data-pltdoc="x">The <span class="RktSym"><span class="RktStxLink">module</span></span> Form</a> introduces the longhand
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> form.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">raquet</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._except-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">except-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._all-from-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">all-from-out</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._rename-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">rename-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktSym">function</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">score</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">raquet</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">function</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">points</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=case.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">points</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"love"</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"fifteen"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"thirty"</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"forty"</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">score</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">'("love" "thirty")</span></p></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;implicit-forms&quot;">17.1.1<tt>&nbsp;</tt><a name="(part._implicit-forms)"></a>Implicit Form Bindings</h5><p>If you try to remove too much from <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a> in defining
+your own <a href="module-languages.html#%28tech._module._language%29" class="techoutside" data-pltdoc="x"><span class="techinside">module language</span></a>, then the resulting module
+will no longer work right as a <a href="module-languages.html#%28tech._module._language%29" class="techoutside" data-pltdoc="x"><span class="techinside">module language</span></a>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">just-lambda</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">identity</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">just-lambda</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">eval:2:0: module: no #%module-begin binding in the module's</span></p></td></tr><tr><td><p><span class="RktErr">language</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (module identity (quote just-lambda) (lambda (x) x))</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7E23%7E25module-begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%module-begin</a></span> form is an implicit form that wraps the
+body of a module. It must be provided by a module that is to be used
+as <a href="module-languages.html#%28tech._module._language%29" class="techoutside" data-pltdoc="x"><span class="techinside">module language</span></a>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">just-lambda</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7E23%7E25module-begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%module-begin</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">identity</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">just-lambda</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">identity</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">#&lt;procedure&gt;</span></p></td></tr></table></blockquote><p>The other implicit forms provided by <span class="RktSym">racket/base</span> are
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=application.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7E23%7E25app%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%app</a></span> for function calls, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._%7E23%7E25datum%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%datum</a></span> for literals, and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=__top.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._%7E23%7E25top%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%top</a></span> for identifiers that have no binding:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">just-lambda</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7E23%7E25module-begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%module-begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktSym">ten</span><span class="RktCmt"> needs these, too:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=application.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7E23%7E25app%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%app</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._%7E23%7E25datum%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%datum</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ten</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">just-lambda</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">ten</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">10</span></p></td></tr></table></blockquote><p>Implicit forms such as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=application.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7E23%7E25app%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%app</a></span> can be used explicitly in a module,
+but they exist mainly to allow a module language to restrict or change
+the meaning of implicit uses. For example, a <span class="RktSym">lambda-calculus</span>
+<a href="module-languages.html#%28tech._module._language%29" class="techoutside" data-pltdoc="x"><span class="techinside">module language</span></a> might restrict functions to a single argument,
+restrict function calls to supply a single argument, restrict the
+module body to a single expression, disallow literals, and treat
+unbound identifiers as uninterpreted symbols:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lambda-calculus</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._rename-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">rename-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">1-arg-lambda</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">1-arg-app</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=application.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7E23%7E25app%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%app</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">1-form-module-begin</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7E23%7E25module-begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%module-begin</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">no-literals</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._%7E23%7E25datum%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%datum</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">unbound-as-quoted</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=__top.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._%7E23%7E25top%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%top</a></span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._define-syntax-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-rule</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">1-arg-lambda</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">expr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">expr</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._define-syntax-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-rule</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">1-arg-app</span><span class="hspace">&nbsp;</span><span class="RktSym">e1</span><span class="hspace">&nbsp;</span><span class="RktSym">e2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=application.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7E23%7E25app%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%app</a></span><span class="hspace">&nbsp;</span><span class="RktSym">e1</span><span class="hspace">&nbsp;</span><span class="RktSym">e2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._define-syntax-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-rule</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">1-form-module-begin</span><span class="hspace">&nbsp;</span><span class="RktSym">e</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7E23%7E25module-begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%module-begin</a></span><span class="hspace">&nbsp;</span><span class="RktSym">e</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">no-literals</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._raise-syntax-error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise-syntax-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">"no"</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._define-syntax-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-rule</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">unbound-as-quoted</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">id</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">id</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">ok</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">lambda-calculus</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">ok</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">'z</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">not-ok</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">lambda-calculus</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">eval:4:0: lambda: use does not match pattern: (lambda (x)</span></p></td></tr><tr><td><p><span class="RktErr">expr)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (lambda (x y) x)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">not-ok</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">lambda-calculus</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">eval:5:0: #%module-begin: use does not match pattern:</span></p></td></tr><tr><td><p><span class="RktErr">(#%module-begin e)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (#%module-begin (lambda (x) x) (lambda (y) (y y)))</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">not-ok</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">lambda-calculus</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">eval:6:0: #%app: use does not match pattern: (#%app e1 e2)</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (#%app x x x)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">not-ok</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">lambda-calculus</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">eval:7:0: #%datum: no</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (#%datum . 10)</span></p></td></tr></table></blockquote><p>Module languages rarely redefine <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=application.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7E23%7E25app%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%app</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._%7E23%7E25datum%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%datum</a></span>, and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=__top.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._%7E23%7E25top%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%top</a></span>, but redefining <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7E23%7E25module-begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%module-begin</a></span> is more
+frequently useful. For example, when using modules to construct
+descriptions of HTML pages where a description is exported from the
+module as <span class="RktSym">page</span>, an alternate <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7E23%7E25module-begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%module-begin</a></span>
+can help eliminate <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span> and quasiquoting
+boilerplate, as in <span class="stt">"html.rkt"</span>:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"html.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/date</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._except-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">except-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._all-from-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">all-from-out</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7E23%7E25module-begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%module-begin</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._rename-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">rename-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">module-begin</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7E23%7E25module-begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%module-begin</a></span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">now</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._define-syntax-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-rule</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">module-begin</span><span class="hspace">&nbsp;</span><span class="RktSym">expr</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7E23%7E25module-begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%module-begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">page</span><span class="hspace">&nbsp;</span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">html</span><span class="hspace">&nbsp;</span><span class="RktVal">expr</span><span class="hspace">&nbsp;</span><span class="RktVal">...</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">page</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">now</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528def._%2528%2528lib._racket%252Fdate..rkt%2529._date-display-format%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">date-display-format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">iso-8601</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528def._%2528%2528lib._racket%252Fdate..rkt%2529._date-%7E3estring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">date-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._seconds-%7E3edate%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">seconds-&gt;date</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-seconds%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-seconds</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>Using the <span class="stt">"html.rkt"</span> <a href="module-languages.html#%28tech._module._language%29" class="techoutside" data-pltdoc="x"><span class="techinside">module language</span></a>, a simple web page
+can be described without having to explicitly define or export
+<span class="RktSym">page</span> and starting in <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span>d mode instead
+of expression mode:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lady-with-the-spinning-head</span><span class="hspace">&nbsp;</span><span class="RktVal">"html.rkt"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">title</span><span class="hspace">&nbsp;</span><span class="RktVal">"Queen of Diamonds"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktVal">"Updated: "</span><span class="hspace">&nbsp;</span><span class="RktRdr">,</span><span class="RktPn">(</span><span class="RktSym">now</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">lady-with-the-spinning-head</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">page</span></td></tr><tr><td><p><span class="RktRes">'(html (title "Queen of Diamonds") (p "Updated: " "2022-08-04"))</span></p></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;s-exp&quot;">17.1.2<tt>&nbsp;</tt><a name="(part._s-exp)"></a>Using <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="stt"> </span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._s-exp%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">s-exp</span></a></h5><p>Implementing a language at the level of <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> is more complex
+than declaring a single module, because <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> lets programmers
+control several different facets of a language. The
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._s-exp%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">s-exp</span></a> language, however, acts as a kind of
+meta-language for using a <a href="module-languages.html#%28tech._module._language%29" class="techoutside" data-pltdoc="x"><span class="techinside">module language</span></a> with the
+<a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> shorthand:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._s-exp%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">s-exp</span></a><span class="hspace">&nbsp;</span><span class="RktVar">module-name</span></td></tr><tr><td><span class="RktVar">form</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span></td></tr></table></blockquote><p>is the same as</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktVar">name</span><span class="hspace">&nbsp;</span><span class="RktVar">module-name</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">form</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr></table></blockquote><p>where <span class="RktVar">name</span> is derived from the source file containing the
+<a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> program. The name <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._s-exp%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">s-exp</span></a> is short for
+&ldquo;<a name="(idx._(gentag._5._(lib._scribblings/guide/guide..scrbl)))"></a>S-expression,&rdquo; which is a traditional name for
+Racket&rsquo;s <a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._reader%29" class="techoutside" data-pltdoc="x"><span class="techinside">reader</span></a>-level lexical conventions: parentheses,
+identifiers, numbers, double-quoted strings with certain backslash
+escapes, and so on.</p><p>Using <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="stt"> </span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._s-exp%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">s-exp</span></a>, the
+<span class="RktSym">lady-with-the-spinning-head</span> example from before can be
+written more compactly as:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._s-exp%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">s-exp</span></a><span class="hspace">&nbsp;</span><span class="RktVal">"html.rkt"</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">title</span><span class="hspace">&nbsp;</span><span class="RktVal">"Queen of Diamonds"</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktVal">"Updated: "</span><span class="hspace">&nbsp;</span><span class="RktRdr">,</span><span class="RktPn">(</span><span class="RktSym">now</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Later in this guide, <a href="hash-languages.html" data-pltdoc="x">Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages</a> explains how to define
+your own <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> language, but first we explain how you can write
+<a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._reader%29" class="techoutside" data-pltdoc="x"><span class="techinside">reader</span></a>-level extensions to Racket.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="languages.html" title="backward to &quot;17 Creating Languages&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="languages.html" title="up to &quot;17 Creating Languages&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="hash-reader.html" title="forward to &quot;17.2 Reader Extensions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/module-macro.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/module-macro.html
new file mode 100644
index 00000000..c6318c61
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/module-macro.html
@@ -0,0 +1,23 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6.7&nbsp;Modules and Macros</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewselflink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="module-basics.html" class="tocviewlink" data-pltdoc="x">Module Basics</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="Module_Syntax.html" class="tocviewlink" data-pltdoc="x">Module Syntax</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="module-paths.html" class="tocviewlink" data-pltdoc="x">Module Paths</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="module-require.html" class="tocviewlink" data-pltdoc="x">Imports:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span></a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="module-provide.html" class="tocviewlink" data-pltdoc="x">Exports:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="module-set.html" class="tocviewlink" data-pltdoc="x">Assignment and Redefinition</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="module-macro.html" class="tocviewselflink" data-pltdoc="x">Modules and Macros</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="protect-out.html" class="tocviewlink" data-pltdoc="x">Protected Exports</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="module-set.html" title="backward to &quot;6.6 Assignment and Redefinition&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="modules.html" title="up to &quot;6 Modules&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="protect-out.html" title="forward to &quot;6.8 Protected Exports&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;module-macro&quot;">6.7<tt>&nbsp;</tt><a name="(part._module-macro)"></a>Modules and Macros</h4><p>Racket&rsquo;s module system cooperates closely with Racket&rsquo;s <a href="macros.html#%28tech._macro%29" class="techoutside" data-pltdoc="x"><span class="techinside">macro</span></a>
+system for adding new syntactic forms to Racket. For example, in the
+same way that importing <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a> introduces syntax
+for <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span>, importing other modules can
+introduce new syntactic forms (in addition to more traditional kinds
+of imports, such as functions or constants).</p><p>We introduce macros in more detail later, in <a href="macros.html" data-pltdoc="x">Macros</a>, but
+here&rsquo;s a simple example of a module that defines a pattern-based
+macro:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">noisy</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">define-noisy</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._define-syntax-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-rule</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-noisy</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym">arg</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">body</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym">arg</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show-arguments</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">id</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">arg</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">body</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show-arguments</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktSym">args</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"calling ~s with arguments ~e"</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktSym">args</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The <span class="RktSym">define-noisy</span> binding provided by this module is a
+<a href="macros.html#%28tech._macro%29" class="techoutside" data-pltdoc="x"><span class="techinside">macro</span></a> that acts like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> for a function, but it
+causes each call to the function to print the arguments that are
+provided to the function:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">noisy</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">define-noisy</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">calling f with arguments '(1 2)</span></p></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></blockquote><p>Roughly, the <span class="RktSym">define-noisy</span> form works by replacing</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym">define-noisy</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>with</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show-arguments</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Since <span class="RktSym">show-arguments</span> isn&rsquo;t provided by the <span class="RktSym">noisy</span>
+module, however, this literal textual replacement is not quite right.
+The actual replacement correctly tracks the origin of identifiers like
+<span class="RktSym">show-arguments</span>, so they can refer to other definitions in the
+place where the macro is defined&#8212;<wbr></wbr>even if those identifiers are not
+available at the place where the macro is used.</p><p>There&rsquo;s more to the macro and module interaction than identifier
+binding. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._define-syntax-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-rule</a></span> form is itself a macro, and
+it expands to compile-time code that implements the transformation
+from <span class="RktSym">define-noisy</span> into <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span>. The module system
+keeps track of which code needs to run at compile and which needs to
+run normally, as explained more in <a href="stx-phases.html" data-pltdoc="x">Compile and Run-Time Phases</a> and
+<a href="macro-module.html" data-pltdoc="x">Module Instantiations and Visits</a>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="module-set.html" title="backward to &quot;6.6 Assignment and Redefinition&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="modules.html" title="up to &quot;6 Modules&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="protect-out.html" title="forward to &quot;6.8 Protected Exports&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/module-paths.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/module-paths.html
new file mode 100644
index 00000000..9e64405b
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/module-paths.html
@@ -0,0 +1,83 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6.3&nbsp;Module Paths</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewselflink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="module-basics.html" class="tocviewlink" data-pltdoc="x">Module Basics</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="Module_Syntax.html" class="tocviewlink" data-pltdoc="x">Module Syntax</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="module-paths.html" class="tocviewselflink" data-pltdoc="x">Module Paths</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="module-require.html" class="tocviewlink" data-pltdoc="x">Imports:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span></a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="module-provide.html" class="tocviewlink" data-pltdoc="x">Exports:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="module-set.html" class="tocviewlink" data-pltdoc="x">Assignment and Redefinition</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="module-macro.html" class="tocviewlink" data-pltdoc="x">Modules and Macros</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="protect-out.html" class="tocviewlink" data-pltdoc="x">Protected Exports</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Module_Syntax.html" title="backward to &quot;6.2 Module Syntax&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="modules.html" title="up to &quot;6 Modules&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="module-require.html" title="forward to &quot;6.4 Imports: require&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;module-paths&quot;">6.3<tt>&nbsp;</tt><a name="(part._module-paths)"></a>Module Paths</h4><p>A <a name="(tech._module._path)"></a><span style="font-style: italic">module path</span> is a reference to a module, as used with
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> or as the <span class="RktVar">initial-module-path</span> in a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> form. It can be any of several forms:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></td></tr></table></blockquote><p>A <a href="module-paths.html#%28tech._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path</span></a> that is a quoted identifier refers to a non-file
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> declaration using the identifier. This form of module
+reference makes the most sense in a <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">color</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">color</span><span class="hspace">&nbsp;</span><span class="RktVal">"blue"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">m</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"my favorite color is ~a\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">color</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">n</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">my favorite color is blue</span></p></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">rel-string</span></td></tr></table></blockquote><p>A string <a href="module-paths.html#%28tech._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path</span></a> is a relative path using Unix-style
+conventions: <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> is the path separator, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">..</span><span class="hspace"></span></span> refers to
+the parent directory, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> refers to the same
+directory. The <span class="RktVar">rel-string</span> must not start or end with a path
+separator.</p><p>The path is relative to the enclosing file, if any, or it is relative
+to the current directory. (More precisely, the path is relative to the
+value of <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-load-relative-directory%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-load-relative-directory</a></span><span class="RktPn">)</span>, which is set
+while loading a file.)</p><p><a href="module-basics.html" data-pltdoc="x">Module Basics</a> shows examples using relative paths.</p><p>If a relative path ends with a <span class="stt">".ss"</span> suffix, it is converted
+to <span class="stt">".rkt"</span>. If the file that implements the referenced module
+actually ends in <span class="stt">".ss"</span>, the suffix will be changed back when
+attempting to load the file (but a <span class="stt">".rkt"</span> suffix takes
+precedence). This two-way conversion provides compatibility with older
+versions of Racket.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">id</span></td></tr></table></blockquote><p>A <a href="module-paths.html#%28tech._module._path%29" class="techoutside" data-pltdoc="x"><span class="techinside">module path</span></a> that is an unquoted identifier refers to an
+installed library. The <span class="RktVar">id</span> is constrained to contain only
+ASCII letters, ASCII numbers, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">_</span><span class="hspace"></span></span>,
+and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>, where <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span> separates path elements within the
+identifier. The elements refer to <a href="module-basics.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collection</span></a>s and
+sub-<a href="module-basics.html#%28tech._collection%29" class="techoutside" data-pltdoc="x"><span class="techinside">collections</span></a>, instead of directories and sub-directories.</p><p>An example of this form is <span class="RktSym">racket/date</span>. It refers to the
+module whose source is the <span class="stt">"date.rkt"</span> file in the
+<span class="stt">"racket"</span> collection, which is installed as part of
+Racket. The <span class="stt">".rkt"</span> suffix is added automatically.</p><p>Another example of this form is <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a>, which is commonly
+used at the initial import. The path <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a> is shorthand for
+<span class="RktSym">racket/main</span>; when an <span class="RktVar">id</span> has no <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>, then
+<span class="RktSym">/main</span> is automatically added to the end. Thus,
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a> or <span class="RktSym">racket/main</span> refers to the module whose
+source is the <a name="(idx._(gentag._2._(lib._scribblings/guide/guide..scrbl)))"></a><span class="stt">"main.rkt"</span> file in the <span class="stt">"racket"</span>
+collection.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/date</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Today is ~s\n"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">date-&gt;string</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._seconds-%7E3edate%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">seconds-&gt;date</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-seconds%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-seconds</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">m</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Today is "Thursday, August 4th, 2022"</span></p></td></tr></table></blockquote></div></p><p>When the full path of a module ends with <span class="stt">".rkt"</span>, if no such
+file exists but one does exist with the <span class="stt">".ss"</span> suffix, then
+the <span class="stt">".ss"</span> suffix is substituted automatically. This
+transformation provides compatibility with older versions of Racket.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lib%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lib</a></span><span class="hspace">&nbsp;</span><span class="RktVar">rel-string</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Like an unquoted-identifier path, but expressed as a string instead of
+an identifier. Also, the <span class="RktVar">rel-string</span> can end with a file
+suffix, in which case <span class="stt">".rkt"</span> is not automatically added.</p><p>Example of this form include <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lib%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lib</a></span><span class="stt"> </span><span class="RktVal">"racket/date.rkt"</span><span class="RktPn">)</span> and
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lib%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lib</a></span><span class="stt"> </span><span class="RktVal">"racket/date"</span><span class="RktPn">)</span>, which are equivalent to
+<span class="RktSym">racket/date</span>. Other examples include <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lib%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lib</a></span><span class="stt"> </span><span class="RktVal">"racket"</span><span class="RktPn">)</span>,
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lib%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lib</a></span><span class="stt"> </span><span class="RktVal">"racket/main"</span><span class="RktPn">)</span>, and <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lib%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lib</a></span><span class="stt"> </span><span class="RktVal">"racket/main.rkt"</span><span class="RktPn">)</span>,
+which are all equivalent to <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lib%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lib</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"racket"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lib%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lib</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"racket/date.rkt"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Today is ~s\n"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">date-&gt;string</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._seconds-%7E3edate%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">seconds-&gt;date</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-seconds%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-seconds</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">m</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Today is "Thursday, August 4th, 2022"</span></p></td></tr></table></blockquote></div></p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._planet%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">planet</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Accesses a third-party library that is distributed through the
+<span class="planetName">PLaneT</span> server. The library is downloaded the first time that it is
+needed, and then the local copy is used afterward.</p><p>The <span class="RktVar">id</span> encodes several pieces of information separated by a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>: the package owner, then package name with optional
+version information, and an optional path to a specific library with
+the package. Like <span class="RktVar">id</span> as shorthand for a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lib%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lib</a></span> path, a
+<span class="stt">".rkt"</span> suffix is added automatically, and <span class="RktSym">/main</span>
+is used as the path if no sub-path element is supplied.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lib%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lib</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"racket"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Use </span><span class="stt">"schematics"</span><span class="RktCmt">'</span><span class="RktCmt">s </span><span class="stt">"random.plt"</span><span class="RktCmt"> 1.0, file </span><span class="stt">"random.rkt"</span><span class="RktCmt">:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._planet%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">planet</a></span><span class="hspace">&nbsp;</span><span class="RktSym">schematics/random:1/random</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">random-gaussian</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">m</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">0.9050686838895684</span></p></td></tr></table></blockquote></div></p><p>As with other forms, an implementation file ending with <span class="stt">".ss"</span>
+can be substituted automatically if no implementation file ending with
+<span class="stt">".rkt"</span> exists.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._planet%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">planet</a></span><span class="hspace">&nbsp;</span><span class="RktVar">package-string</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Like the symbol form of a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._planet%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">planet</a></span>, but using a string instead
+of an identifier. Also, the <span class="RktVar">package-string</span> can end with a
+file suffix, in which case <span class="stt">".rkt"</span> is not added.</p><p>As with other forms, an <span class="stt">".ss"</span> extension is converted to
+<span class="stt">".rkt"</span>, while an implementation file ending with
+<span class="stt">".ss"</span> can be substituted automatically if no implementation
+file ending with <span class="stt">".rkt"</span> exists.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._planet%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">planet</a></span><span class="hspace">&nbsp;</span><span class="RktVar">rel-string</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">user-string</span><span class="hspace">&nbsp;</span><span class="RktVar">pkg-string</span><span class="hspace">&nbsp;</span><span class="RktVar">vers</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">vers</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">nat</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktVar">nat</span><span class="hspace">&nbsp;</span><span class="RktVar">nat</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktVar">nat</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVar">nat</span><span class="RktPn">)</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktVar">nat</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote><p>A more general form to access a library from the <span class="planetName">PLaneT</span> server. In
+this general form, a <span class="planetName">PLaneT</span> reference starts like a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lib%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lib</a></span>
+reference with a relative path, but the path is followed by
+information about the producer, package, and version of the
+library. The specified package is downloaded and installed on demand.</p><p>The <span class="RktVar">vers</span>es specify a constraint on the acceptable version of
+the package, where a version number is a sequence of non-negative
+integers, and the constraints determine the allowable values for each
+element in the sequence. If no constraint is provided for a particular
+element, then any version is allowed; in particular, omitting all
+<span class="RktVar">vers</span>es means that any version is acceptable. Specifying at
+least one <span class="RktVar">vers</span> is strongly recommended.</p><p>For a version constraint, a plain <span class="RktVar">nat</span> is the same as
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVar">nat</span><span class="RktPn">)</span>, which matches <span class="RktVar">nat</span> or higher for the
+corresponding element of the version number.  A <span class="RktPn">(</span><span class="RktVar">start-nat</span><span class="stt"> </span><span class="RktVar">end-nat</span><span class="RktPn">)</span> matches any number in the range <span class="RktVar">start-nat</span> to
+<span class="RktVar">end-nat</span>, inclusive. A <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="stt"> </span><span class="RktVar">nat</span><span class="RktPn">)</span> matches only exactly
+<span class="RktVar">nat</span>. A <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="stt"> </span><span class="RktVar">nat</span><span class="RktPn">)</span> matches <span class="RktVar">nat</span> or lower.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lib%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lib</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"racket"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._planet%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">planet</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"random.rkt"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">"schematics"</span><span class="hspace">&nbsp;</span><span class="RktVal">"random.plt"</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">random-gaussian</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">m</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">0.9050686838895684</span></p></td></tr></table></blockquote></div></p><p>The automatic <span class="stt">".ss"</span> and <span class="stt">".rkt"</span> conversions apply as
+with other forms.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._file%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">file</a></span><span class="hspace">&nbsp;</span><span class="RktVar">string</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Refers to a file, where <span class="RktVar">string</span> is a relative or absolute path
+using the current platform&rsquo;s conventions. This form is not portable,
+and it should <span style="font-style: italic">not</span> be used when a plain, portable
+<span class="RktSym">rel-string</span> suffices.</p><p>The automatic <span class="stt">".ss"</span> and <span class="stt">".rkt"</span> conversions apply as
+with other forms.</p></blockquote><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><a name="(elem._submod)"></a><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._submod%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">submod</a></span><span class="hspace">&nbsp;</span><span class="RktVar">base</span><span class="hspace">&nbsp;</span><span class="RktVar">element</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">base</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">module-path</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVal">"."</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVal">".."</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td></tr><tr><td align="right" valign="baseline"><span class="RktVar">element</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVal">".."</span></td></tr></table></td></tr></table></blockquote><p>Refers to a submodule of <span class="RktVar">base</span>. The sequence of
+<span class="RktVar">element</span>s within <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._submod%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">submod</a></span> specify a path of submodule
+names to reach the final submodule.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">zoo</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">monkey-house</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">monkey</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">monkey</span><span class="hspace">&nbsp;</span><span class="RktVal">"Curious George"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._submod%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">submod</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">zoo</span><span class="hspace">&nbsp;</span><span class="RktSym">monkey-house</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">monkey</span></td></tr><tr><td><p><span class="RktRes">"Curious George"</span></p></td></tr></table></blockquote></div></p><p>Using <span class="RktVal">"."</span> as <span class="RktVar">base</span> within <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._submod%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">submod</a></span> stands for
+the enclosing module. Using <span class="RktVal">".."</span> as <span class="RktVar">base</span> is
+equivalent to using <span class="RktVal">"."</span> followed by an extra
+<span class="RktVal">".."</span>. When a path of the form <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span>
+refers to a submodule, it is equivalent to <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._submod%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">submod</a></span><span class="stt"> </span><span class="RktVal">"."</span><span class="stt"> </span><span class="RktVar">id</span><span class="RktPn">)</span>.</p><p>Using <span class="RktVal">".."</span> as an <span class="RktVar">element</span> cancels one submodule step, effectively
+referring to the enclosing module. For example, <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._submod%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">submod</a></span><span class="stt"> </span><span class="RktVal">".."</span><span class="RktPn">)</span>
+refers to the enclosing module of the submodule in which the path
+appears.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">zoo</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">monkey-house</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">monkey</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">monkey</span><span class="hspace">&nbsp;</span><span class="RktVal">"Curious George"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">crocodile-house</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._submod%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">submod</a></span><span class="hspace">&nbsp;</span><span class="RktVal">".."</span><span class="hspace">&nbsp;</span><span class="RktSym">monkey-house</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dinner</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">dinner</span><span class="hspace">&nbsp;</span><span class="RktSym">monkey</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._submod%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">submod</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">zoo</span><span class="hspace">&nbsp;</span><span class="RktSym">crocodile-house</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">dinner</span></td></tr><tr><td><p><span class="RktRes">"Curious George"</span></p></td></tr></table></blockquote></div></p></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Module_Syntax.html" title="backward to &quot;6.2 Module Syntax&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="modules.html" title="up to &quot;6 Modules&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="module-require.html" title="forward to &quot;6.4 Imports: require&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/module-provide.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/module-provide.html
new file mode 100644
index 00000000..9b4650cb
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/module-provide.html
@@ -0,0 +1,31 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6.5&nbsp;Exports: provide</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewselflink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="module-basics.html" class="tocviewlink" data-pltdoc="x">Module Basics</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="Module_Syntax.html" class="tocviewlink" data-pltdoc="x">Module Syntax</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="module-paths.html" class="tocviewlink" data-pltdoc="x">Module Paths</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="module-require.html" class="tocviewlink" data-pltdoc="x">Imports:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span></a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="module-provide.html" class="tocviewselflink" data-pltdoc="x">Exports:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="module-set.html" class="tocviewlink" data-pltdoc="x">Assignment and Redefinition</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="module-macro.html" class="tocviewlink" data-pltdoc="x">Modules and Macros</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="protect-out.html" class="tocviewlink" data-pltdoc="x">Protected Exports</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="module-require.html" title="backward to &quot;6.4 Imports: require&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="modules.html" title="up to &quot;6 Modules&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="module-set.html" title="forward to &quot;6.6 Assignment and Redefinition&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;module-provide&quot;">6.5<tt>&nbsp;</tt><a name="(part._module-provide)"></a>Exports: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span></h4><p>By default, all of a module&rsquo;s definitions are private to the
+module. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span> form specifies definitions to be made
+available where the module is <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>d.</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span> form can only appear at module level (i.e., in the
+immediate body of a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span>).  Specifying multiple
+<span class="RktVar">provide-spec</span>s in a single <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span> is exactly the
+same as using multiple <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span>s each with a single
+<span class="RktVar">provide-spec</span>.</p><p>Each identifier can be exported at most once from a module across all
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span>s within the module. More precisely, the external name
+for each export must be distinct; the same internal binding can be
+exported multiple times with different external names.</p><p>The allowed shape of a <span class="RktVar">provide-spec</span> is defined recursively:</p><blockquote class="leftindent"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">identifier</span></td></tr></table></blockquote><p>In its simplest form, a <span class="RktVar">provide-spec</span> indicates a binding
+within its module to be exported. The binding can be from either a
+local definition, or from an import.</p></blockquote></blockquote><blockquote class="leftindent"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._rename-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">rename-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">orig-id</span><span class="hspace">&nbsp;</span><span class="RktVar">export-id</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._rename-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">rename-out</a></span> form is similar to just specifying an identifier,
+but the exported binding <span class="RktVar">orig-id</span> is given a different name,
+<span class="RktVar">export-id</span>, to importing modules.</p></blockquote></blockquote><blockquote class="leftindent"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct-out</a></span><span class="hspace">&nbsp;</span><span class="RktVar">struct-id</span><span class="RktPn">)</span></td></tr></table></blockquote><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct-out</a></span> form exports the bindings created by
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="stt"> </span><span class="RktVar">struct-id</span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span>See <a href="define-struct.html" data-pltdoc="x">Programmer-Defined Datatypes</a> for information on
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-struct</a></span>.</p></blockquote></blockquote></blockquote></blockquote></blockquote><blockquote class="leftindent"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._all-defined-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">all-defined-out</a></span><span class="RktPn">)</span></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._all-defined-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">all-defined-out</a></span> shorthand exports all bindings that are
+defined within the exporting module (as opposed to imported).</p><p>Use of the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._all-defined-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">all-defined-out</a></span> shorthand is generally
+discouraged, because it makes less clear the actual exports for a
+module, and because Racket programmers get into the habit of
+thinking that definitions can be added freely to a module without
+affecting its public interface (which is not the case when
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._all-defined-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">all-defined-out</a></span> is used).</p></blockquote></blockquote><blockquote class="leftindent"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._all-from-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">all-from-out</a></span><span class="hspace">&nbsp;</span><span class="RktVar">module-path</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._all-from-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">all-from-out</a></span> shorthand exports all bindings in the module
+that were imported using a <span class="RktVar">require-spec</span> that is based on
+<span class="RktVar">module-path</span>.</p><p>Although different <span class="RktVar">module-path</span>s could refer to the same
+file-based module, re-exporting with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._all-from-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">all-from-out</a></span> is based
+specifically on the <span class="RktVar">module-path</span> reference, and not the module
+that is actually referenced.</p></blockquote></blockquote><blockquote class="leftindent"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._except-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">except-out</a></span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Like <span class="RktVar">provide-spec</span>, but omitting the export of each
+<span class="RktVar">id</span>, where <span class="RktVar">id</span> is the external name of the binding to
+omit.</p></blockquote></blockquote><blockquote class="leftindent"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._prefix-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">prefix-out</a></span><span class="hspace">&nbsp;</span><span class="RktVar">prefix-id</span><span class="hspace">&nbsp;</span><span class="RktVar">provide-spec</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Like <span class="RktVar">provide-spec</span>, but adding <span class="RktVar">prefix-id</span> to the
+beginning of the external name for each exported binding.</p></blockquote></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="module-require.html" title="backward to &quot;6.4 Imports: require&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="modules.html" title="up to &quot;6 Modules&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="module-set.html" title="forward to &quot;6.6 Assignment and Redefinition&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/module-require.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/module-require.html
new file mode 100644
index 00000000..33bb74cc
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/module-require.html
@@ -0,0 +1,32 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6.4&nbsp;Imports: require</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewselflink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="module-basics.html" class="tocviewlink" data-pltdoc="x">Module Basics</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="Module_Syntax.html" class="tocviewlink" data-pltdoc="x">Module Syntax</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="module-paths.html" class="tocviewlink" data-pltdoc="x">Module Paths</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="module-require.html" class="tocviewselflink" data-pltdoc="x">Imports:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span></a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="module-provide.html" class="tocviewlink" data-pltdoc="x">Exports:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="module-set.html" class="tocviewlink" data-pltdoc="x">Assignment and Redefinition</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="module-macro.html" class="tocviewlink" data-pltdoc="x">Modules and Macros</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="protect-out.html" class="tocviewlink" data-pltdoc="x">Protected Exports</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="module-paths.html" title="backward to &quot;6.3 Module Paths&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="modules.html" title="up to &quot;6 Modules&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="module-provide.html" title="forward to &quot;6.5 Exports: provide&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;module-require&quot;">6.4<tt>&nbsp;</tt><a name="(part._module-require)"></a>Imports: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span></h4><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> form imports from another module. A
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> form can appear within a module, in which case it
+introduces bindings from the specified module into the importing module.
+A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> form can also appear at the top level, in which case
+it both imports bindings and <a name="(tech._instantiate)"></a><span style="font-style: italic">instantiates</span> the specified
+module; that is, it evaluates the body definitions and expressions of
+the specified module, if they have not been evaluated already.</p><p>A single <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> can specify multiple imports at once:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>Specifying multiple <span class="RktVar">require-spec</span>s in a single
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> is essentially the same as using multiple
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>s, each with a single <span class="RktVar">require-spec</span>. The
+difference is minor, and confined to the top-level: a single
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> can import a given identifier at most once, whereas a
+separate <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> can replace the bindings of a previous
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> (both only at the top level, outside of a module).</p><p>The allowed shape of a <span class="RktVar">require-spec</span> is defined recursively:</p><blockquote class="leftindent"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVar">module-path</span></td></tr></table></blockquote><p>In its simplest form, a <span class="RktVar">require-spec</span> is a
+<span class="RktVar">module-path</span> (as defined in the previous section,
+<a href="module-paths.html" data-pltdoc="x">Module Paths</a>). In this case, the bindings introduced
+by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> are determined by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span> declarations
+within each module referenced by each <span class="RktVar">module-path</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">color</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">color</span><span class="hspace">&nbsp;</span><span class="RktVal">"blue"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">m</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">color</span><span class="hspace">&nbsp;</span><span class="RktSym">size</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("blue" 17)</span></p></td></tr></table></blockquote></div></p></blockquote></blockquote><blockquote class="leftindent"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._only-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">only-in</a></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktVar">id-maybe-renamed</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">id-maybe-renamed</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktPn">[</span><span class="RktVar">orig-id</span><span class="hspace">&nbsp;</span><span class="RktVar">bind-id</span><span class="RktPn">]</span></td></tr></table></td></tr></table></blockquote><p>An <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._only-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">only-in</a></span> form limits the set of bindings that would be introduced
+by a base <span class="RktVar">require-spec</span>. Also, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._only-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">only-in</a></span> optionally
+renames each binding that is preserved: in a <span class="RktPn">[</span><span class="RktVar">orig-id</span><span class="stt"> </span><span class="RktVar">bind-id</span><span class="RktPn">]</span> form, the <span class="RktVar">orig-id</span> refers to a binding implied by
+<span class="RktVar">require-spec</span>, and <span class="RktVar">bind-id</span> is the name that will be
+bound in the importing context instead of <span class="RktVar">orig-id</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lib%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lib</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"racket"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tastes-great?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">less-filling?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tastes-great?</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">less-filling?</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._only-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">only-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">m</span><span class="hspace">&nbsp;</span><span class="RktSym">tastes-great?</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">tastes-great?</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">less-filling?</span></td></tr><tr><td><p><span class="RktErr">less-filling?: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._only-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">only-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">m</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">less-filling?</span><span class="hspace">&nbsp;</span><span class="RktSym">lite?</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">lite?</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p></blockquote></blockquote><blockquote class="leftindent"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._except-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">except-in</a></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p>This form is the complement of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._only-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">only-in</a></span>: it excludes specific
+bindings from the set specified by <span class="RktVar">require-spec</span>.</p></blockquote></blockquote><blockquote class="leftindent"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._rename-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">rename-in</a></span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">orig-id</span><span class="hspace">&nbsp;</span><span class="RktVar">bind-id</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote><p>This form supports renaming like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._only-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">only-in</a></span>, but leaving alone
+identifiers from <span class="RktVar">require-spec</span> that are not mentioned as an
+<span class="RktVar">orig-id</span>.  </p></blockquote></blockquote><blockquote class="leftindent"><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._prefix-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">prefix-in</a></span><span class="hspace">&nbsp;</span><span class="RktVar">prefix-id</span><span class="hspace">&nbsp;</span><span class="RktVar">require-spec</span><span class="RktPn">)</span></td></tr></table></blockquote><p>This is a shorthand for renaming, where <span class="RktVar">prefix-id</span> is added to
+the front of each identifier specified by <span class="RktVar">require-spec</span>.</p></blockquote></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._only-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">only-in</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._except-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">except-in</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._rename-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">rename-in</a></span>, and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._prefix-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">prefix-in</a></span> forms can be nested to implement more complex
+manipulations of imported bindings. For example,</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._prefix-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">prefix-in</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m:</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._except-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">except-in</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">m</span><span class="hspace">&nbsp;</span><span class="RktSym">ghost</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>imports all bindings that <span class="RktSym">m</span>
+exports, except for the <span class="RktSym">ghost</span> binding, and with local names
+that are prefixed with <span class="RktSym">m:</span>.</p><p>Equivalently, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._prefix-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">prefix-in</a></span> could be applied before
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._except-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">except-in</a></span>, as long as the omission with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._except-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">except-in</a></span> is
+specified using the <span class="RktSym">m:</span> prefix:</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._except-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">except-in</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._prefix-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">prefix-in</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m:</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">m</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">m:ghost</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="module-paths.html" title="backward to &quot;6.3 Module Paths&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="modules.html" title="up to &quot;6 Modules&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="module-provide.html" title="forward to &quot;6.5 Exports: provide&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/module-runtime-config.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/module-runtime-config.html
new file mode 100644
index 00000000..d605a8d3
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/module-runtime-config.html
@@ -0,0 +1,63 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>17.3.6&nbsp;Module-Handling Configuration</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewselflink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">17.1&nbsp;</td><td><a href="module-languages.html" class="tocviewlink" data-pltdoc="x">Module Languages</a></td></tr><tr><td align="right">17.2&nbsp;</td><td><a href="hash-reader.html" class="tocviewlink" data-pltdoc="x">Reader Extensions</a></td></tr><tr><td align="right">17.3&nbsp;</td><td><a href="hash-languages.html" class="tocviewselflink" data-pltdoc="x">Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>17.3&nbsp;</td><td><a href="hash-languages.html" class="tocviewlink" data-pltdoc="x">Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">17.3.1&nbsp;</td><td><a href="hash-lang_syntax.html" class="tocviewlink" data-pltdoc="x">Designating a <span class="RktModLink"><span class="RktMod">#lang</span></span> Language</a></td></tr><tr><td align="right">17.3.2&nbsp;</td><td><a href="hash-lang_reader.html" class="tocviewlink" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">reader</span></span></a></td></tr><tr><td align="right">17.3.3&nbsp;</td><td><a href="syntax_module-reader.html" class="tocviewlink" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">s-<wbr></wbr>exp</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">syntax/<span class="mywbr"> &nbsp;</span>module-<wbr></wbr>reader</span></span></a></td></tr><tr><td align="right">17.3.4&nbsp;</td><td><a href="language-collection.html" class="tocviewlink" data-pltdoc="x">Installing a Language</a></td></tr><tr><td align="right">17.3.5&nbsp;</td><td><a href="language-get-info.html" class="tocviewlink" data-pltdoc="x">Source-<wbr></wbr>Handling Configuration</a></td></tr><tr><td align="right">17.3.6&nbsp;</td><td><a href="module-runtime-config.html" class="tocviewselflink" data-pltdoc="x">Module-<wbr></wbr>Handling Configuration</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="language-get-info.html" title="backward to &quot;17.3.5 Source-Handling Configuration&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="hash-languages.html" title="up to &quot;17.3 Defining new #lang Languages&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="concurrency.html" title="forward to &quot;18 Concurrency and Synchronization&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;module-runtime-config&quot;">17.3.6<tt>&nbsp;</tt><a name="(part._module-runtime-config)"></a>Module-Handling Configuration</h5><p>Suppose that the file <span class="stt">"death-list-5.rkt"</span> contains</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"death-list-5.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"O-Ren Ishii"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"Vernita Green"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"Budd"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"Elle Driver"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"Bill"</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>If you <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> <span class="stt">"death-list-5.rkt"</span> directly, then it
+prints the list in the usual Racket result format:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"death-list-5.rkt"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">'("O-Ren Ishii" "Vernita Green" "Budd" "Elle Driver" "Bill")</span></p></td></tr></table></blockquote><p>However, if <span class="stt">"death-list-5.rkt"</span> is required by a
+<span class="stt">"kiddo.rkt"</span> that is implemented with <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=scheme&amp;rel=scheme.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">scheme</span></a>
+instead of <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a>:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"kiddo.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=scheme&amp;rel=scheme.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">scheme</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"death-list-5.rkt"</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>then, if you run <span class="stt">"kiddo.rkt"</span> file in DrRacket or if you run it
+directly with <span class="stt">racket</span>, <span class="stt">"kiddo.rkt"</span> causes
+<span class="stt">"death-list-5.rkt"</span> to print its list in traditional Scheme
+format, without the leading quote:</p><blockquote class="SCodeFlow"><p><span class="RktOut">("O-Ren Ishii" "Vernita Green" "Budd" "Elle Driver" "Bill")</span></p></blockquote><p>The <span class="stt">"kiddo.rkt"</span> example illustrates how the format for
+printing a result value can depend on the main module of a program
+instead of the language that is used to implement it.</p><p>More broadly, certain features of a language are only invoked when
+a module written in that language is run directly with <span class="stt">racket</span>
+(as opposed to being imported into another module). One example is
+result-printing style (as shown above). Another example is REPL
+behavior. These features are part of what&rsquo;s called the
+<a name="(tech._run._time._configuration)"></a><span style="font-style: italic">run-time configuration</span> of a language.</p><p>Unlike the syntax-coloring property of a language (as described in
+<a href="language-get-info.html" data-pltdoc="x">Source-Handling Configuration</a>), the run-time configuration is a
+property of a <span class="emph">module</span> per se as opposed to a property of
+the <span class="emph">source text</span> representing the module.
+For that reason, the run-time configuration for a
+module needs to be available even if the module is compiled
+to bytecode form and the source is unavailable. Therefore,
+run-time configuration cannot be handled by the
+<span class="RktSym">get-info</span> function we&rsquo;re exporting from the language&rsquo;s
+parser module.</p><p>Instead, it will be handled by a new
+<span class="RktSym">configure-runtime</span> submodule that we&rsquo;ll add inside
+the parsed <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> form. When a module is run directly
+with <span class="stt">racket</span>, <span class="stt">racket</span> looks for a
+<span class="RktSym">configure-runtime</span> submodule. If it exists, <span class="stt">racket</span>
+runs it. But if the module is imported into another module,
+the <span class="RktVal">'</span><span class="RktVal">configure-runtime</span> submodule is ignored. (And if the
+<span class="RktSym">configure-runtime</span> submodule doesn&rsquo;t exist, <span class="stt">racket</span>
+just evaluates the module as usual.) That means that the
+<span class="RktSym">configure-runtime</span> submodule can be used for any special
+setup tasks that need to happen when the module is run directly.</p><p>Going back to the <span class="RktSym">literal</span> language (see
+<a href="language-get-info.html" data-pltdoc="x">Source-Handling Configuration</a>), we can adjust the language so that
+directly running a <span class="RktSym">literal</span> module causes it to print out its
+string, while using a <span class="RktSym">literal</span> module in a larger program
+simply provides <span class="RktSym">data</span> without printing. To make this
+work, we will need an extra module. (For clarity here, we will implement
+this module as a separate file. But it could equally well be
+a submodule of an existing file.)</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktSym">....</span><span class="hspace">&nbsp;</span>(the main installation or the user&rsquo;s space)</td></tr><tr><td><span class="stt">|-</span><span class="hspace">&nbsp;</span><span class="stt">"literal"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="stt">|-</span><span class="hspace">&nbsp;</span><span class="stt">"main.rkt"</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>(with reader submodule)</td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="stt">|-</span><span class="hspace">&nbsp;</span><span class="stt">"show.rkt"</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>(new)</td></tr></table></blockquote><ul><li><p>The <span class="stt">"literal/show.rkt"</span> module will provide a
+<span class="RktSym">show</span> function to be applied to the string
+content of a <span class="RktSym">literal</span> module, and also provide a
+<span class="RktSym">show-enabled</span> parameter that controls whether
+<span class="RktSym">show</span> actually prints the result.</p></li><li><p>The new <span class="RktSym">configure-runtime</span> submodule in
+<span class="stt">"literal/main.rkt"</span> will set the
+<span class="RktSym">show-enabled</span> parameter to <span class="RktVal">#t</span>. The
+net effect is that <span class="RktSym">show</span> will print the strings
+that it&rsquo;s given, but only when a module using the <span class="RktSym">literal</span>
+language is run directly (because only then will the
+<span class="RktSym">configure-runtime</span> submodule be invoked).</p></li></ul><p>These changes are implemented in the following revised
+<span class="stt">"literal/main.rkt"</span>:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"literal/main.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">reader</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">syntax/strip-context</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._rename-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">rename-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">literal-read</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">literal-read-syntax</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-syntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-syntax</a></span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">get-info</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">literal-read</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-%7E3edatum%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-&gt;datum</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">literal-read-syntax</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">literal-read-syntax</span><span class="hspace">&nbsp;</span><span class="RktSym">src</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._with-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">str</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">port-&gt;string</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=syntax-helpers.html%23%2528def._%2528%2528lib._syntax%252Fstrip-context..rkt%2529._strip-context%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">strip-context</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">anything</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">configure-runtime</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">literal/show</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show-enabled</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">literal/show</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">data</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">data</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">str</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktSym">data</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-info</span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="hspace">&nbsp;</span><span class="RktSym">mod</span><span class="hspace">&nbsp;</span><span class="RktSym">line</span><span class="hspace">&nbsp;</span><span class="RktSym">col</span><span class="hspace">&nbsp;</span><span class="RktSym">pos</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">key</span><span class="hspace">&nbsp;</span><span class="RktSym">default</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=case.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">key</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">color-lexer</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Module_Names_and_Loading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._dynamic-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">dynamic-require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">syntax-color/default-lexer</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">default-lexer</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktSym">default</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>Then the <span class="stt">"literal/show.rkt"</span> module must provide
+the <span class="RktSym">show-enabled</span> parameter and <span class="RktSym">show</span>
+function:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"literal/show.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktSym">show-enabled</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">show-enabled</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-parameter%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-parameter</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._when%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">when</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">show-enabled</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>With all of the pieces for <span class="RktSym">literal</span> in place, try running the
+following variant of <span class="stt">"tuvalu.rkt"</span> directly and through a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> from another module:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"tuvalu.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><span class="RktSym">literal</span></td></tr><tr><td><span class="RktSym">Technology!</span></td></tr><tr><td><span class="RktSym">System!</span></td></tr><tr><td><span class="RktSym">Perfect!</span></td></tr></table></blockquote></blockquote></blockquote><p>When run directly, we&rsquo;ll see the result printed like so, because
+our <span class="RktSym">configure-runtime</span> submodule will have set the
+<span class="RktSym">show-enabled</span> parameter to <span class="RktVal">#t</span>:</p><blockquote class="SCodeFlow"><p><span class="RktOut">Technology!
+<br/>System!
+<br/>Perfect!</span></p></blockquote><p>But when imported into another module, printing will be suppressed,
+because the <span class="RktSym">configure-runtime</span> submodule will not be invoked,
+and therefore the <span class="RktSym">show-enabled</span> parameter will remain
+at its default value of <span class="RktVal">#f</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="language-get-info.html" title="backward to &quot;17.3.5 Source-Handling Configuration&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="hash-languages.html" title="up to &quot;17.3 Defining new #lang Languages&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="concurrency.html" title="forward to &quot;18 Concurrency and Synchronization&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/module-set.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/module-set.html
new file mode 100644
index 00000000..86a9e23f
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/module-set.html
@@ -0,0 +1,25 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6.6&nbsp;Assignment and Redefinition</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewselflink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="module-basics.html" class="tocviewlink" data-pltdoc="x">Module Basics</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="Module_Syntax.html" class="tocviewlink" data-pltdoc="x">Module Syntax</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="module-paths.html" class="tocviewlink" data-pltdoc="x">Module Paths</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="module-require.html" class="tocviewlink" data-pltdoc="x">Imports:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span></a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="module-provide.html" class="tocviewlink" data-pltdoc="x">Exports:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="module-set.html" class="tocviewselflink" data-pltdoc="x">Assignment and Redefinition</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="module-macro.html" class="tocviewlink" data-pltdoc="x">Modules and Macros</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="protect-out.html" class="tocviewlink" data-pltdoc="x">Protected Exports</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="module-provide.html" title="backward to &quot;6.5 Exports: provide&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="modules.html" title="up to &quot;6 Modules&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="module-macro.html" title="forward to &quot;6.7 Modules and Macros&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;module-set&quot;">6.6<tt>&nbsp;</tt><a name="(part._module-set)"></a>Assignment and Redefinition</h4><p>The use of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span> on variables defined within a module is
+limited to the body of the defining module. That is, a module is
+allowed to change the value of its own definitions, and such changes
+are visible to importing modules. However, an importing context is not
+allowed to change the value of an imported binding.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">counter</span><span class="hspace">&nbsp;</span><span class="RktSym">increment!</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">counter</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">increment!</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">counter</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._add1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">counter</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">m</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">counter</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">increment!</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">counter</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">counter</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">set!: cannot mutate module-required identifier</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: counter</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (set! counter -1)</span></p></td></tr></table></blockquote></div></p><p>As the above example illustrates, a module can always grant others the
+ability to change its exports by providing a mutator function, such as
+<span class="RktSym">increment!</span>.</p><p>The prohibition on assignment of imported variables helps support
+modular reasoning about programs. For example, in the module,</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rx:fish</span><span class="hspace">&nbsp;</span><span class="RktSym">fishy-string?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rx:fish</span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"fish"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fishy-string?</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rx:fish</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>the function <span class="RktSym">fishy-string?</span> will always match strings that
+contain &ldquo;fish&rdquo;, no matter how other modules use the <span class="RktSym">rx:fish</span>
+binding.  For essentially the same reason that it helps programmers,
+the prohibition on assignment to imports also allows many programs to
+be executed more efficiently.</p><p>Along the same lines, when a module contains no <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span> of a
+particular identifier that is defined within the module, then the
+identifier is considered a <span style="font-style: italic">constant</span> that cannot be
+changed&#8212;<wbr></wbr>not even by re-declaring the module.</p><p>Consequently, re-declaration of a module is not generally allowed.
+For file-based modules, simply changing the file does not lead to a
+re-declaration in any case, because file-based modules are loaded on
+demand, and the previously loaded declarations satisfy future
+requests. It is possible to use Racket&rsquo;s reflection support to
+re-declare a module, however, and non-file modules can be re-declared
+in the <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>; in such cases, the re-declaration may fail if it
+involves the re-definition of a previously constant binding.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pie</span><span class="hspace">&nbsp;</span><span class="RktVal">3.141597</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">m</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pie</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">define-values: assignment disallowed;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot re-define a constant</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">constant: pie</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module:'m</span></p></td></tr></table></blockquote><p>For exploration and debugging purposes, the Racket reflective layer
+provides a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._compile-enforce-module-constants%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">compile-enforce-module-constants</a></span> parameter
+to disable the enforcement of constants.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._compile-enforce-module-constants%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">compile-enforce-module-constants</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m2</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pie</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pie</span><span class="hspace">&nbsp;</span><span class="RktVal">3.141597</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">m2</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m2</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pie</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pie</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._compile-enforce-module-constants%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">compile-enforce-module-constants</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">pie</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="module-provide.html" title="backward to &quot;6.5 Exports: provide&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="modules.html" title="up to &quot;6 Modules&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="module-macro.html" title="forward to &quot;6.7 Modules and Macros&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/modules.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/modules.html
new file mode 100644
index 00000000..8847fd81
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/modules.html
@@ -0,0 +1,3 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6&nbsp;Modules</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewselflink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="modules.html" class="tocviewselflink" data-pltdoc="x">Modules</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="module-basics.html" class="tocviewlink" data-pltdoc="x">Module Basics</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="Module_Syntax.html" class="tocviewlink" data-pltdoc="x">Module Syntax</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="module-paths.html" class="tocviewlink" data-pltdoc="x">Module Paths</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="module-require.html" class="tocviewlink" data-pltdoc="x">Imports:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span></a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="module-provide.html" class="tocviewlink" data-pltdoc="x">Exports:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="module-set.html" class="tocviewlink" data-pltdoc="x">Assignment and Redefinition</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="module-macro.html" class="tocviewlink" data-pltdoc="x">Modules and Macros</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="protect-out.html" class="tocviewlink" data-pltdoc="x">Protected Exports</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="define-struct.html" title="backward to &quot;5 Programmer-Defined Datatypes&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="module-basics.html" title="forward to &quot;6.1 Module Basics&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;modules&quot;">6<tt>&nbsp;</tt><a name="(part._modules)"></a>Modules</h3><p>Modules let you organize Racket code into multiple files and reusable
+libraries.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-basics.html" class="toclink" data-pltdoc="x">6.1<span class="hspace">&nbsp;</span>Module Basics</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-basics.html#%28part._module-org%29" class="toclink" data-pltdoc="x">6.1.1<span class="hspace">&nbsp;</span>Organizing Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-basics.html#%28part._.Library_.Collections%29" class="toclink" data-pltdoc="x">6.1.2<span class="hspace">&nbsp;</span>Library Collections</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-basics.html#%28part._packages-and-collections%29" class="toclink" data-pltdoc="x">6.1.3<span class="hspace">&nbsp;</span>Packages and Collections</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-basics.html#%28part._link-collection%29" class="toclink" data-pltdoc="x">6.1.4<span class="hspace">&nbsp;</span>Adding Collections</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-basics.html#%28part._intracollection%29" class="toclink" data-pltdoc="x">6.1.5<span class="hspace">&nbsp;</span>Module References Within a Collection</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Module_Syntax.html" class="toclink" data-pltdoc="x">6.2<span class="hspace">&nbsp;</span>Module Syntax</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Module_Syntax.html#%28part._module-syntax%29" class="toclink" data-pltdoc="x">6.2.1<span class="hspace">&nbsp;</span>The <span class="RktSym"><span class="RktStxLink">module</span></span> Form</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Module_Syntax.html#%28part._hash-lang%29" class="toclink" data-pltdoc="x">6.2.2<span class="hspace">&nbsp;</span>The <span class="RktMod">#lang</span> Shorthand</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Module_Syntax.html#%28part._submodules%29" class="toclink" data-pltdoc="x">6.2.3<span class="hspace">&nbsp;</span>Submodules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Module_Syntax.html#%28part._main-and-test%29" class="toclink" data-pltdoc="x">6.2.4<span class="hspace">&nbsp;</span>Main and Test Submodules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-paths.html" class="toclink" data-pltdoc="x">6.3<span class="hspace">&nbsp;</span>Module Paths</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-require.html" class="toclink" data-pltdoc="x">6.4<span class="hspace">&nbsp;</span>Imports: <span class="RktSym"><span class="RktStxLink">require</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-provide.html" class="toclink" data-pltdoc="x">6.5<span class="hspace">&nbsp;</span>Exports: <span class="RktSym"><span class="RktStxLink">provide</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-set.html" class="toclink" data-pltdoc="x">6.6<span class="hspace">&nbsp;</span>Assignment and Redefinition</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="module-macro.html" class="toclink" data-pltdoc="x">6.7<span class="hspace">&nbsp;</span>Modules and Macros</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="protect-out.html" class="toclink" data-pltdoc="x">6.8<span class="hspace">&nbsp;</span>Protected Exports</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="define-struct.html" title="backward to &quot;5 Programmer-Defined Datatypes&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="module-basics.html" title="forward to &quot;6.1 Module Basics&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/more-hash-lang.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/more-hash-lang.html
new file mode 100644
index 00000000..83eaee73
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/more-hash-lang.html
@@ -0,0 +1,30 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>23.1&nbsp;More Rackets</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewselflink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">23.1&nbsp;</td><td><a href="more-hash-lang.html" class="tocviewselflink" data-pltdoc="x">More Rackets</a></td></tr><tr><td align="right">23.2&nbsp;</td><td><a href="standards.html" class="tocviewlink" data-pltdoc="x">Standards</a></td></tr><tr><td align="right">23.3&nbsp;</td><td><a href="teaching-langs.html" class="tocviewlink" data-pltdoc="x">Teaching</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="dialects.html" title="backward to &quot;23 Dialects of Racket and Scheme&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="dialects.html" title="up to &quot;23 Dialects of Racket and Scheme&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="standards.html" title="forward to &quot;23.2 Standards&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;more-hash-lang&quot;">23.1<tt>&nbsp;</tt><a name="(part._more-hash-lang)"></a>More Rackets</h4><p>&ldquo;Racket&rdquo; is more of an idea about programming languages than a
+language in the usual sense. Macros can extend a base language (as
+described in <a href="macros.html" data-pltdoc="x">Macros</a>), and alternate parsers can
+construct an entirely new language from the ground up (as described in
+<a href="languages.html" data-pltdoc="x">Creating Languages</a>).</p><p>The <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> line that starts a Racket module declares the
+base language of the module. By &ldquo;Racket,&rdquo; we usually mean
+<a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> followed by the base language <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a> or
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a> (of which <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a> is an
+extension). The Racket distribution provides additional languages,
+including the following:</p><ul><li><p><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=ts-reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">typed/racket</span></a> &#8212;<wbr></wbr> like
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a>, but statically typed; see
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=ts-guide&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Typed Racket Guide</a></p></li><li><p><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?tag=%28mod-path._.%27lazy.%27%29&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">lazy</span></a> &#8212;<wbr></wbr> like
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a>, but avoids evaluating an
+expression until its value is needed; see <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?tag=%28part._%28.%27%28lib._lazy%2Flazy..scrbl%29.%27._.%27top.%27%29%29&amp;version=8.6" class="Sq" data-pltdoc="x">the Lazy Racket
+documentation</a>.</p></li><li><p><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?tag=%28mod-path._.%27frtime.%27%29&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">frtime</span></a> &#8212;<wbr></wbr> changes evaluation in an
+even more radical way to support reactive programming; see
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?tag=%28part._%28.%27%28lib._frtime%2Fscribblings%2Ffrtime..scrbl%29.%27._.%27top.%27%29%29&amp;version=8.6" class="Sq" data-pltdoc="x">the FrTime documentation</a>.</p></li><li><p><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=scribble&amp;rel=base.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">scribble/base</span></a> &#8212;<wbr></wbr> a language, which looks more
+like Latex than Racket, for writing documentation; see
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=scribble&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">Scribble: The Racket Documentation Tool</a></p></li></ul><p>Each of these languages is used by starting module with the language
+name after <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a>. For example, this source of this
+document starts with <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="stt"> </span><span class="RktSym">scribble/base</span>.</p><p>Furthermore, Racket users can define their own languages, as discussed
+in <a href="languages.html" data-pltdoc="x">Creating Languages</a>. Typically, a language name maps to its
+implementation through a module path by adding
+<span class="RktSym">/lang/reader</span>; for example, the language name
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=scribble&amp;rel=base.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">scribble/base</span></a> is expanded to
+<span class="RktSym">scribble/base/lang/reader</span>, which is the module that
+implements the surface-syntax parser. Some language names act as
+language loaders; for example, <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="stt"> </span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=planet&amp;rel=hash-lang-planet.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">planet</span></a><span class="stt"> </span><span class="RktVar">planet-path</span> downloads, installs, and uses a
+language via <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=planet&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x"><span class="planetName">PLaneT</span></a>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="dialects.html" title="backward to &quot;23 Dialects of Racket and Scheme&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="dialects.html" title="up to &quot;23 Dialects of Racket and Scheme&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="standards.html" title="forward to &quot;23.2 Standards&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/numbers.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/numbers.html
new file mode 100644
index 00000000..13b2db6f
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/numbers.html
@@ -0,0 +1,49 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.2&nbsp;Numbers</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewselflink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="numbers.html" class="tocviewselflink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings (Unicode)</a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Bytes and Byte Strings</a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="hash-tables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="void_undefined.html" class="tocviewlink" data-pltdoc="x">Void and Undefined</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="booleans.html" title="backward to &quot;3.1 Booleans&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="characters.html" title="forward to &quot;3.3 Characters&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;numbers&quot;">3.2<tt>&nbsp;</tt><a name="(part._numbers)"></a>Numbers</h4><p>A Racket <a name="(tech._number)"></a><span style="font-style: italic">number</span> is either exact or inexact:</p><ul><li><p>An <span style="font-style: italic">exact</span> number is either</p><ul><li><p>an arbitrarily large or small integer, such as <span class="RktVal">5</span>,
+<span class="RktVal">99999999999999999</span>, or <span class="RktVal"><span class="nobreak">-1</span>7</span>;</p></li><li><p>a rational that is exactly the ratio of two arbitrarily
+small or large integers, such as <span class="RktVal">1/2</span>,
+<span class="RktVal">99999999999999999/2</span>, or <span class="RktVal"><span class="nobreak">-3</span>/4</span>; or</p></li><li><p>a complex number with exact real and imaginary parts
+(where the imaginary part is not zero), such as <span class="RktVal">1+2i</span> or
+<span class="RktVal">1/2+3/4i</span>.</p></li></ul></li><li><p>An <span style="font-style: italic">inexact</span> number is either</p><ul><li><p>an IEEE floating-point representation of a number, such
+as <span class="RktVal">2.0</span> or <span class="RktVal">3.14e+87</span>, where the IEEE
+infinities and not-a-number are written
+<span class="RktVal">+inf.0</span>, <span class="RktVal"><span class="nobreak">-i</span>nf.0</span>, and <span class="RktVal">+nan.0</span>
+(or <span class="RktVal">-nan.0</span>); or</p></li><li><p>a complex number with real and imaginary parts that are
+IEEE floating-point representations, such as
+<span class="RktVal">2.0+3.0i</span> or <span class="RktVal"><span class="nobreak">-i</span>nf.0+nan.0i</span>; as a
+special case, an inexact complex number can have an
+exact zero real part with an inexact imaginary part.</p></li></ul></li></ul><p>Inexact numbers print with a decimal point or exponent specifier, and
+exact numbers print as integers and fractions.  The same conventions
+apply for reading number constants, but <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#e</span><span class="hspace"></span></span> or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#i</span><span class="hspace"></span></span> can prefix a number to force its parsing as an exact
+or inexact number. The prefixes <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#b</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#o</span><span class="hspace"></span></span>, and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#x</span><span class="hspace"></span></span> specify binary, octal, and hexadecimal
+interpretation of digits.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528part._parse-number%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Reading Numbers</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> documents the fine points of the syntax of numbers.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktVal">0.5</span></td></tr><tr><td><p><span class="RktRes">0.5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">#e0.5</span></td></tr><tr><td><p><span class="RktRes">1/2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">#x03BB</span></td></tr><tr><td><p><span class="RktRes">955</span></p></td></tr></table></blockquote></div></p><p>Computations that involve an inexact number produce inexact results,
+so that inexactness acts as a kind of taint on numbers. Beware,
+however, that Racket offers no &ldquo;inexact booleans,&rdquo; so computations
+that branch on the comparison of inexact numbers can nevertheless
+produce exact results. The procedures <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-%7E3einexact%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exact-&gt;inexact</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._inexact-%7E3eexact%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">inexact-&gt;exact</a></span> convert between the two
+types of numbers.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1/2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0.5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">3.0</span><span class="hspace">&nbsp;</span><span class="RktVal">2.999</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._inexact-%7E3eexact%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">inexact-&gt;exact</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0.1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3602879701896397/36028797018963968</span></p></td></tr></table></blockquote></div></p><p>Inexact results are also produced by procedures such as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sqrt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sqrt</a></span>,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._log%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">log</a></span>, and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sin%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sin</a></span> when an exact result would require
+representing real numbers that are not rational. Racket can represent
+only rational numbers and complex numbers with rational parts.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sin%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sin</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">rational...</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sin%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sin</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1/2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">not rational...</span></td></tr><tr><td><p><span class="RktRes">0.479425538604203</span></p></td></tr></table></blockquote></div></p><p>In terms of performance, computations with small integers are
+typically the fastest, where &ldquo;small&rdquo; means that the number fits into
+one bit less than the machine&rsquo;s word-sized representation for signed
+numbers. Computation with very large exact integers or with
+non-integer exact numbers can be much more expensive than computation
+with inexact numbers.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">sigma</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">sigma</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._time%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">time</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._round%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">round</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">sigma</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2000</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">cpu time: 21 real time: 11 gc time: 0</span></p></td></tr><tr><td><p><span class="RktRes">8</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._time%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">time</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._round%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">round</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">sigma</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1.0</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2000</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">cpu time: 0 real time: 0 gc time: 0</span></p></td></tr><tr><td><p><span class="RktRes">8.0</span></p></td></tr></table></td></tr></table></blockquote><p>The number categories <a name="(tech._integer)"></a><span style="font-style: italic">integer</span>, <a name="(tech._rational)"></a><span style="font-style: italic">rational</span>,
+<a name="(tech._real)"></a><span style="font-style: italic">real</span> (always rational), and <a name="(tech._complex)"></a><span style="font-style: italic">complex</span> are defined in
+the usual way, and are recognized by the procedures <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span>,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._rational%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">rational?</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._real%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">real?</a></span>, and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._complex%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">complex?</a></span>, in addition
+to the generic <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span>. A few mathematical procedures accept
+only real numbers, but most implement standard extensions to complex
+numbers.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._complex%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">complex?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._integer%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">integer?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1+2i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._complex%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">complex?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1+2i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._complex%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">complex?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1.0+2.0i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._abs%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">abs</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-5</span></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">5</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._abs%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">abs</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-5</span>+2i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">abs: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: real?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: -5+2i</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sin%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sin</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-5</span>+2i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3.6076607742131563+1.0288031496599335i</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span> procedure compares numbers for numerical equality. If
+it is given both inexact and exact numbers to compare, it essentially
+converts the inexact numbers to exact before comparing. The
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eqv%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eqv?</a></span> (and therefore <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span>) procedure, in contrast,
+compares numbers considering both exactness and numerical equality.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eqv%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eqv?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">1.0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p>Beware of comparisons involving inexact numbers, which by their nature
+can have surprising behavior. Even apparently simple inexact numbers
+may not mean what you think they mean; for example, while a base-2
+IEEE floating-point number can represent <span class="RktVal">1/2</span> exactly, it
+can only approximate <span class="RktVal">1/10</span>:</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1/2</span><span class="hspace">&nbsp;</span><span class="RktVal">0.5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1/10</span><span class="hspace">&nbsp;</span><span class="RktVal">0.1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._inexact-%7E3eexact%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">inexact-&gt;exact</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0.1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3602879701896397/36028797018963968</span></p></td></tr></table></blockquote></div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=numbers.html&amp;version=8.6" class="Sq" data-pltdoc="x">Numbers</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on numbers and number procedures.</p></blockquote></blockquote></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="booleans.html" title="backward to &quot;3.1 Booleans&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="characters.html" title="forward to &quot;3.3 Characters&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/other-editors.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/other-editors.html
new file mode 100644
index 00000000..96ee6f57
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/other-editors.html
@@ -0,0 +1,6 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>24&nbsp;Command-Line Tools and Your Editor of Choice</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewselflink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>24&nbsp;</td><td><a href="other-editors.html" class="tocviewselflink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">24.1&nbsp;</td><td><a href="cmdline-tools.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools</a></td></tr><tr><td align="right">24.2&nbsp;</td><td><a href="Emacs.html" class="tocviewlink" data-pltdoc="x">Emacs</a></td></tr><tr><td align="right">24.3&nbsp;</td><td><a href="Vim.html" class="tocviewlink" data-pltdoc="x">Vim</a></td></tr><tr><td align="right">24.4&nbsp;</td><td><a href="Sublime_Text.html" class="tocviewlink" data-pltdoc="x">Sublime Text</a></td></tr><tr><td align="right">24.5&nbsp;</td><td><a href="Visual_Studio_Code.html" class="tocviewlink" data-pltdoc="x">Visual Studio Code</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="versionbox"><span class="version">8.6</span></div><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="teaching-langs.html" title="backward to &quot;23.3 Teaching&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="cmdline-tools.html" title="forward to &quot;24.1 Command-Line Tools&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;other-editors&quot;">24<tt>&nbsp;</tt><a name="(part._other-editors)"></a>Command-Line Tools and Your Editor of Choice</h3><p>Although DrRacket is the easiest way for most people to start with
+Racket, many Racketeers prefer command-line tools and other text
+editors.  The Racket distribution includes several command-line tools,
+and popular editors include or support packages to make them work well
+with Racket.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="cmdline-tools.html" class="toclink" data-pltdoc="x">24.1<span class="hspace">&nbsp;</span>Command-Line Tools</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="cmdline-tools.html#%28part._compile%29" class="toclink" data-pltdoc="x">24.1.1<span class="hspace">&nbsp;</span>Compilation and Configuration: <span class="stt">raco</span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="cmdline-tools.html#%28part._.Interactive_evaluation%29" class="toclink" data-pltdoc="x">24.1.2<span class="hspace">&nbsp;</span>Interactive evaluation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="cmdline-tools.html#%28part._.Shell_completion%29" class="toclink" data-pltdoc="x">24.1.3<span class="hspace">&nbsp;</span>Shell completion</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Emacs.html" class="toclink" data-pltdoc="x">24.2<span class="hspace">&nbsp;</span>Emacs</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Emacs.html#%28part._.Major_.Modes%29" class="toclink" data-pltdoc="x">24.2.1<span class="hspace">&nbsp;</span>Major Modes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Emacs.html#%28part._.Minor_.Modes%29" class="toclink" data-pltdoc="x">24.2.2<span class="hspace">&nbsp;</span>Minor Modes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Emacs.html#%28part._.Packages_specific_to_.Evil_.Mode%29" class="toclink" data-pltdoc="x">24.2.3<span class="hspace">&nbsp;</span>Packages specific to Evil Mode</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Vim.html" class="toclink" data-pltdoc="x">24.3<span class="hspace">&nbsp;</span>Vim</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Vim.html#%28part._vim-plugins%29" class="toclink" data-pltdoc="x">24.3.1<span class="hspace">&nbsp;</span>Plugins</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Vim.html#%28part._.Indentation%29" class="toclink" data-pltdoc="x">24.3.2<span class="hspace">&nbsp;</span>Indentation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Vim.html#%28part._.Highlighting%29" class="toclink" data-pltdoc="x">24.3.3<span class="hspace">&nbsp;</span>Highlighting</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Vim.html#%28part._.Structured_.Editing%29" class="toclink" data-pltdoc="x">24.3.4<span class="hspace">&nbsp;</span>Structured Editing</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Vim.html#%28part._.R.E.P.Ls%29" class="toclink" data-pltdoc="x">24.3.5<span class="hspace">&nbsp;</span>REPLs</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Vim.html#%28part._.Scribble%29" class="toclink" data-pltdoc="x">24.3.6<span class="hspace">&nbsp;</span>Scribble</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Vim.html#%28part._.Miscellaneous%29" class="toclink" data-pltdoc="x">24.3.7<span class="hspace">&nbsp;</span>Miscellaneous</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Sublime_Text.html" class="toclink" data-pltdoc="x">24.4<span class="hspace">&nbsp;</span>Sublime Text</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Visual_Studio_Code.html" class="toclink" data-pltdoc="x">24.5<span class="hspace">&nbsp;</span>Visual Studio Code</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="teaching-langs.html" title="backward to &quot;23.3 Teaching&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="cmdline-tools.html" title="forward to &quot;24.1 Command-Line Tools&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/pairs.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/pairs.html
new file mode 100644
index 00000000..fd7235a9
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/pairs.html
@@ -0,0 +1,28 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.8&nbsp;Pairs and Lists</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewselflink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings (Unicode)</a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Bytes and Byte Strings</a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="pairs.html" class="tocviewselflink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="hash-tables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="void_undefined.html" class="tocviewlink" data-pltdoc="x">Void and Undefined</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="keywords.html" title="backward to &quot;3.7 Keywords&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="vectors.html" title="forward to &quot;3.9 Vectors&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;pairs&quot;">3.8<tt>&nbsp;</tt><a name="(part._pairs)"></a>Pairs and Lists</h4><p>A <a name="(tech._pair)"></a><span style="font-style: italic">pair</span> joins two arbitrary values. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span>
+procedure constructs pairs, and the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span>
+procedures extract the first and second elements of the pair,
+respectively. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._pair%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">pair?</a></span> predicate recognizes pairs.</p><p>Some pairs print by wrapping parentheses around the printed forms of
+the two pair elements, putting a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> at the beginning and a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> between the elements.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 . 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((1 . 2) . 3)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._pair%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p>A <a name="(tech._list)"></a><span style="font-style: italic">list</span> is a combination of pairs that creates a linked
+list. More precisely, a list is either the empty list <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null</a></span>,
+or it is a pair whose first element is a list element and whose second
+element is a list. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list?</a></span> predicate recognizes lists. The
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span>  predicate recognizes the empty list.</p><p>A list normally prints as a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> followed by a pair of parentheses
+wrapped around the list elements.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null</a></span></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(0 1 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><p>A list or pair prints using <span class="RktRes">list</span> or <span class="RktRes">cons</span>
+when one of its elements cannot be written as a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span>d
+value. For example, a value constructed with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._srcloc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">srcloc</a></span> cannot be
+written using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span>, and it prints using <span class="RktRes">srcloc</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._srcloc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">srcloc</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"file.rkt"</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(srcloc "file.rkt" 1 0 1 8)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">here</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._srcloc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">srcloc</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"file.rkt"</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">there</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(list 'here (srcloc "file.rkt" 1 0 1 8) 'there)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._srcloc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">srcloc</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"file.rkt"</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(cons 1 (srcloc "file.rkt" 1 0 1 8))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._srcloc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">srcloc</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"file.rkt"</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(list* 1 2 (srcloc "file.rkt" 1 0 1 8))</span></p></td></tr></table></blockquote><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See also <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list*</a></span>.</p></blockquote></blockquote></blockquote><p>As shown in the last example, <span class="RktRes">list*</span> is used to
+abbreviate a series of <span class="RktRes">cons</span>es that cannot be
+abbreviated using <span class="RktRes">list</span>.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span> functions print a pair or list
+without a leading <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span>, <span class="RktRes">cons</span>,
+<span class="RktRes">list</span>, or <span class="RktRes">list*</span>. There is no difference
+between <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span> for a pair or list, except
+as they apply to elements of the list:</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">(1 . 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">(1 . 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">()</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">()</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">"3"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">(1 2 "3")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">"3"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">(1 2 3)</span></p></td></tr></table></blockquote></div></p><p>Among the most important predefined procedures on lists are those that
+iterate through the list&rsquo;s elements:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(1 1/2 1/3)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._andmap%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">andmap</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3c%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&lt;</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._ormap%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">ormap</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3c%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&lt;</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._filter%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">filter</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3c%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&lt;</a></span><span class="RktPn"> .</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(1 2)</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._foldl%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">foldl</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">10</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">16</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._for-each%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">for-each</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">123</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._member%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">member</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Keys"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"Florida"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Keys"</span><span class="hspace">&nbsp;</span><span class="RktVal">"U.S.A."</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("Keys" "U.S.A.")</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._assoc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">assoc</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">where</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">(</span><span class="RktVal">when</span><span class="hspace">&nbsp;</span><span class="RktVal">"3:30"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">where</span><span class="hspace">&nbsp;</span><span class="RktVal">"Florida"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">who</span><span class="hspace">&nbsp;</span><span class="RktVal">"Mickey"</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(where "Florida")</span></p></td></tr></table></blockquote><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html&amp;version=8.6" class="Sq" data-pltdoc="x">Pairs and Lists</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on pairs and lists.</p></blockquote></blockquote></blockquote><p>Pairs are immutable (contrary to Lisp tradition), and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._pair%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">pair?</a></span>
+and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list?</a></span> recognize immutable pairs and lists, only. The
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=mpairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._mcons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">mcons</a></span> procedure creates a <a name="(tech._mutable._pair)"></a><span style="font-style: italic">mutable pair</span>, which works
+with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=mpairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._set-mcar%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">set-mcar!</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=mpairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._set-mcdr%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">set-mcdr!</a></span>, as well as
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=mpairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._mcar%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">mcar</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=mpairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._mcdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">mcdr</a></span>. A mutable pair prints using
+<span class="RktRes">mcons</span>, while <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span> print
+mutable pairs with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span>:</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=mpairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._mcons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">mcons</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">p</span></td></tr><tr><td><p><span class="RktRes">(mcons 1 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._pair%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">pair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=mpairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._mpair%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">mpair?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=mpairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._set-mcar%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">set-mcar!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">p</span></td></tr><tr><td><p><span class="RktRes">(mcons 0 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">{0 . 2}</span></p></td></tr></table></blockquote></div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=mpairs.html&amp;version=8.6" class="Sq" data-pltdoc="x">Mutable Pairs and Lists</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on mutable pairs.</p></blockquote></blockquote></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="keywords.html" title="backward to &quot;3.7 Keywords&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="vectors.html" title="forward to &quot;3.9 Vectors&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/parallelism.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/parallelism.html
new file mode 100644
index 00000000..e3397f59
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/parallelism.html
@@ -0,0 +1,162 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>20&nbsp;Parallelism</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="figure.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="figure.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9660;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewselflink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>20&nbsp;</td><td><a href="parallelism.html" class="tocviewselflink" data-pltdoc="x">Parallelism</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">20.1&nbsp;</td><td><a href="parallelism.html#%28part._effective-futures%29" class="tocviewlink" data-pltdoc="x">Parallelism with Futures</a></td></tr><tr><td align="right">20.2&nbsp;</td><td><a href="parallelism.html#%28part._effective-places%29" class="tocviewlink" data-pltdoc="x">Parallelism with Places</a></td></tr><tr><td align="right">20.3&nbsp;</td><td><a href="parallelism.html#%28part._distributed-places%29" class="tocviewlink" data-pltdoc="x">Distributed Places</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">20.1<tt>&nbsp;</tt></span><a href="parallelism.html#%28part._effective-futures%29" class="tocsubseclink" data-pltdoc="x">Parallelism with Futures</a></td></tr><tr><td><span class="tocsublinknumber">20.2<tt>&nbsp;</tt></span><a href="parallelism.html#%28part._effective-places%29" class="tocsubseclink" data-pltdoc="x">Parallelism with Places</a></td></tr><tr><td><span class="tocsublinknumber">20.3<tt>&nbsp;</tt></span><a href="parallelism.html#%28part._distributed-places%29" class="tocsubseclink" data-pltdoc="x">Distributed Places</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="performance.html" title="backward to &quot;19 Performance&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="running.html" title="forward to &quot;21 Running and Creating Executables&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parallelism&quot;">20<tt>&nbsp;</tt><a name="(part._parallelism)"></a>Parallelism</h3><p>Racket provides two forms of <a name="(tech._parallelism)"></a><span style="font-style: italic">parallelism</span>: <a href="parallelism.html#%28tech._future%29" class="techoutside" data-pltdoc="x"><span class="techinside">futures</span></a> and
+<a href="parallelism.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">places</span></a>. On a platform that provides multiple processors,
+parallelism can improve the run-time performance of a program.</p><p>See also <a href="performance.html" data-pltdoc="x">Performance</a> for information on sequential
+performance in Racket. Racket also provides threads for
+<a href="concurrency.html#%28tech._concurrency%29" class="techoutside" data-pltdoc="x"><span class="techinside">concurrency</span></a>, but threads do not provide parallelism; see
+<a href="concurrency.html" data-pltdoc="x">Concurrency and Synchronization</a> for more information.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;effective-futures&quot;">20.1<tt>&nbsp;</tt><a name="(part._effective-futures)"></a>Parallelism with Futures</h4><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=futures.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/future</span></a> library provides support for
+performance improvement through parallelism with <a name="(tech._future)"></a><span style="font-style: italic">futures</span> and the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=futures.html%23%2528def._%2528%2528lib._racket%252Ffuture..rkt%2529._future%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">future</a></span>
+and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=futures.html%23%2528def._%2528%2528lib._racket%252Ffuture..rkt%2529._touch%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">touch</a></span> functions. The level of parallelism available from
+those constructs, however, is limited by several factors, and the
+current implementation is best suited to numerical tasks. The caveats
+in <a href="performance.html#%28part._.Dr.Racket-perf%29" data-pltdoc="x">Performance in DrRacket</a> also apply to futures; notably,
+the debugging instrumentation currently defeats futures.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Other functions, such as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._thread%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">thread</a></span>, support the
+creation of reliably concurrent tasks. However, threads never run truly
+in parallel, even if the hardware and operating system support
+parallelism.</p></blockquote></blockquote></blockquote><p>As a starting example, the <span class="RktSym">any-double?</span> function below takes a
+list of numbers and determines whether any number in the list has a
+double that is also in the list:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">any-double?</span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252For%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252For%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>This function runs in quadratic time, so it can take a long time (on
+the order of a second) on large lists like <span class="RktSym">l1</span> and
+<span class="RktSym">l2</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5000</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Flist%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-range%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-range</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5000</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">any-double?</span><span class="hspace">&nbsp;</span><span class="RktSym">l1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">any-double?</span><span class="hspace">&nbsp;</span><span class="RktSym">l2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The best way to speed up <span class="RktSym">any-double?</span>  is to use a different
+algorithm. However, on a machine that offers at least two processing
+units, the example above can run in about half the time using
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=futures.html%23%2528def._%2528%2528lib._racket%252Ffuture..rkt%2529._future%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">future</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=futures.html%23%2528def._%2528%2528lib._racket%252Ffuture..rkt%2529._touch%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">touch</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=futures.html%23%2528def._%2528%2528lib._racket%252Ffuture..rkt%2529._future%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">future</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">any-double?</span><span class="hspace">&nbsp;</span><span class="RktSym">l2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">any-double?</span><span class="hspace">&nbsp;</span><span class="RktSym">l1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=futures.html%23%2528def._%2528%2528lib._racket%252Ffuture..rkt%2529._touch%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">touch</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The future <span class="RktSym">f</span> runs <span class="RktPn">(</span><span class="RktSym">any-double?</span><span class="stt"> </span><span class="RktSym">l2</span><span class="RktPn">)</span> in parallel to
+<span class="RktPn">(</span><span class="RktSym">any-double?</span><span class="stt"> </span><span class="RktSym">l1</span><span class="RktPn">)</span>, and the result for <span class="RktPn">(</span><span class="RktSym">any-double?</span><span class="stt"> </span><span class="RktSym">l2</span><span class="RktPn">)</span> becomes available about the same time that it is demanded by
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=futures.html%23%2528def._%2528%2528lib._racket%252Ffuture..rkt%2529._touch%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">touch</a></span><span class="stt"> </span><span class="RktSym">f</span><span class="RktPn">)</span>.</p><p>Futures run in parallel as long as they can do so safely, but the
+notion of &ldquo;future safe&rdquo; is inherently tied to the
+implementation. The distinction between &ldquo;future safe&rdquo; and &ldquo;future unsafe&rdquo;
+operations may be far from apparent at the level of a Racket program.
+The remainder of this section works through an example to illustrate
+this distinction and to show how to use the future visualizer
+can help shed light on it.</p><p>Consider the following core of a Mandelbrot-set computation:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mandelbrot</span><span class="hspace">&nbsp;</span><span class="RktSym">iterations</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ci</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2.0</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1.0</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">cr</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2.0</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1.5</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">zr</span><span class="hspace">&nbsp;</span><span class="RktVal">0.0</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">zi</span><span class="hspace">&nbsp;</span><span class="RktVal">0.0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">iterations</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">i</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">zrq</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">zr</span><span class="hspace">&nbsp;</span><span class="RktSym">zr</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">ziq</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">zi</span><span class="hspace">&nbsp;</span><span class="RktSym">zi</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">zrq</span><span class="hspace">&nbsp;</span><span class="RktSym">ziq</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._add1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">zrq</span><span class="hspace">&nbsp;</span><span class="RktSym">ziq</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">cr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym">zr</span><span class="hspace">&nbsp;</span><span class="RktSym">zi</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">ci</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The expressions <span class="RktPn">(</span><span class="RktSym">mandelbrot</span><span class="stt"> </span><span class="RktVal">10000000</span><span class="stt"> </span><span class="RktVal">62</span><span class="stt"> </span><span class="RktVal">500</span><span class="stt"> </span><span class="RktVal">1000</span><span class="RktPn">)</span> and
+<span class="RktPn">(</span><span class="RktSym">mandelbrot</span><span class="stt"> </span><span class="RktVal">10000000</span><span class="stt"> </span><span class="RktVal">62</span><span class="stt"> </span><span class="RktVal">501</span><span class="stt"> </span><span class="RktVal">1000</span><span class="RktPn">)</span> each take a while to
+produce an answer. Computing them both, of course, takes twice as
+long:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mandelbrot</span><span class="hspace">&nbsp;</span><span class="RktVal">10000000</span><span class="hspace">&nbsp;</span><span class="RktVal">62</span><span class="hspace">&nbsp;</span><span class="RktVal">500</span><span class="hspace">&nbsp;</span><span class="RktVal">1000</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mandelbrot</span><span class="hspace">&nbsp;</span><span class="RktVal">10000000</span><span class="hspace">&nbsp;</span><span class="RktVal">62</span><span class="hspace">&nbsp;</span><span class="RktVal">501</span><span class="hspace">&nbsp;</span><span class="RktVal">1000</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Unfortunately, attempting to run the two computations in parallel with
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=futures.html%23%2528def._%2528%2528lib._racket%252Ffuture..rkt%2529._future%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">future</a></span> does not improve performance:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=futures.html%23%2528def._%2528%2528lib._racket%252Ffuture..rkt%2529._future%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">future</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mandelbrot</span><span class="hspace">&nbsp;</span><span class="RktVal">10000000</span><span class="hspace">&nbsp;</span><span class="RktVal">62</span><span class="hspace">&nbsp;</span><span class="RktVal">501</span><span class="hspace">&nbsp;</span><span class="RktVal">1000</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mandelbrot</span><span class="hspace">&nbsp;</span><span class="RktVal">10000000</span><span class="hspace">&nbsp;</span><span class="RktVal">62</span><span class="hspace">&nbsp;</span><span class="RktVal">500</span><span class="hspace">&nbsp;</span><span class="RktVal">1000</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=futures.html%23%2528def._%2528%2528lib._racket%252Ffuture..rkt%2529._touch%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">touch</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>To see why, use the <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=future-visualizer&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">future-visualizer</span></a>, like this:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">future-visualizer</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=future-visualizer&amp;rel=index.html%23%2528form._%2528%2528lib._future-visualizer%252Fmain..rkt%2529._visualize-futures%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">visualize-futures</a></span></td></tr><tr><td><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=futures.html%23%2528def._%2528%2528lib._racket%252Ffuture..rkt%2529._future%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">future</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mandelbrot</span><span class="hspace">&nbsp;</span><span class="RktVal">10000000</span><span class="hspace">&nbsp;</span><span class="RktVal">62</span><span class="hspace">&nbsp;</span><span class="RktVal">501</span><span class="hspace">&nbsp;</span><span class="RktVal">1000</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mandelbrot</span><span class="hspace">&nbsp;</span><span class="RktVal">10000000</span><span class="hspace">&nbsp;</span><span class="RktVal">62</span><span class="hspace">&nbsp;</span><span class="RktVal">500</span><span class="hspace">&nbsp;</span><span class="RktVal">1000</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=futures.html%23%2528def._%2528%2528lib._racket%252Ffuture..rkt%2529._touch%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">touch</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>This opens a window showing a graphical view of a trace of the computation.
+The upper-left portion of the window contains an execution timeline:</p><p><span class="RktRes"><img style="vertical-align: 0px; margin: -3px -3px -3px -3px;" src="pict_2.png" alt="image" width="606" height="306"/></span></p><p>Each horizontal row represents an OS-level thread, and the colored
+dots represent important events in the execution of the program (they are
+color-coded to distinguish one event type from another).  The upper-left blue
+dot in the timeline represents the future&rsquo;s creation.  The future
+executes for a brief period (represented by a green bar in the second line) on thread
+1, and then pauses to allow the runtime thread to perform a future-unsafe operation.</p><p>In the Racket implementation, future-unsafe operations fall into one of two categories.
+A <a name="(tech._blocking)"></a><span style="font-style: italic">blocking</span> operation halts the evaluation of the future, and will not allow
+it to continue until it is touched.  After the operation completes within <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=futures.html%23%2528def._%2528%2528lib._racket%252Ffuture..rkt%2529._touch%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">touch</a></span>,
+the remainder of the future&rsquo;s work will be evaluated sequentially by the runtime
+thread.  A <a name="(tech._synchronized)"></a><span style="font-style: italic">synchronized</span> operation also halts the future, but the runtime thread
+may perform the operation at any time and, once completed, the future may continue
+running in parallel.  Memory allocation and JIT compilation are two common examples
+of synchronized operations.</p><p>In the timeline, we see an orange dot just to the right of the green bar on thread 1 &ndash;
+this dot represents a synchronized operation (memory allocation).  The first orange
+dot on thread 0 shows that the runtime thread performed the allocation shortly after
+the future paused.  A short time later, the future halts on a blocking operation
+(the first red dot) and must wait until the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=futures.html%23%2528def._%2528%2528lib._racket%252Ffuture..rkt%2529._touch%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">touch</a></span> for it to be evaluated
+(slightly after the 1049ms mark).</p><p>When you move your mouse over an event, the visualizer shows you
+detailed information about the event and draws arrows
+connecting all of the events in the corresponding future.
+This image shows those connections for our future.</p><p><span class="RktRes"><img style="vertical-align: 0px; margin: -3px -3px -3px -3px;" src="pict_3.png" alt="image" width="606" height="306"/></span></p><p>The dotted orange line connects the first event in the future to
+the future that created it, and the purple lines connect adjacent
+events within the future.</p><p>The reason that we see no parallelism is that the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3c%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&lt;</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span> operations
+in the lower portion of the loop in <span class="RktSym">mandelbrot</span> involve a mixture of
+floating-point and fixed (integer) values.  Such mixtures typically trigger a slow
+path in execution, and the general slow path will usually be blocking.</p><p>Changing constants to be floating-points numbers in <span class="RktSym">mandelbrot</span> addresses that
+first problem:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mandelbrot</span><span class="hspace">&nbsp;</span><span class="RktSym">iterations</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ci</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2.0</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1.0</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">cr</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2.0</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1.5</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">zr</span><span class="hspace">&nbsp;</span><span class="RktVal">0.0</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">zi</span><span class="hspace">&nbsp;</span><span class="RktVal">0.0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">iterations</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">i</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">zrq</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">zr</span><span class="hspace">&nbsp;</span><span class="RktSym">zr</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">ziq</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">zi</span><span class="hspace">&nbsp;</span><span class="RktSym">zi</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">zrq</span><span class="hspace">&nbsp;</span><span class="RktSym">ziq</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">4.0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._add1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">zrq</span><span class="hspace">&nbsp;</span><span class="RktSym">ziq</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">cr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2.0</span><span class="hspace">&nbsp;</span><span class="RktSym">zr</span><span class="hspace">&nbsp;</span><span class="RktSym">zi</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">ci</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>With that change, <span class="RktSym">mandelbrot</span> computations can run in
+parallel.  Nevertheless, we still see a special type of
+slow-path operation limiting our parallelism (orange dots):</p><p><span class="RktRes"><img style="vertical-align: 0px; margin: -3px -3px -3px -3px;" src="pict_4.png" alt="image" width="606" height="206"/></span></p><p>The problem is that most every arithmetic operation in this example
+produces an inexact number whose storage must be allocated.  While some allocation
+can safely be performed exclusively without the aid of the runtime thread, especially
+frequent allocation requires synchronized operations which defeat any performance
+improvement.</p><p>By using <a href="performance.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonum</span></a>-specific operations (see
+<a href="performance.html#%28part._fixnums%2Bflonums%29" data-pltdoc="x">Fixnum and Flonum Optimizations</a>), we can re-write <span class="RktSym">mandelbrot</span> to use
+much less allocation:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">mandelbrot</span><span class="hspace">&nbsp;</span><span class="RktSym">iterations</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">ci</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._fl-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">fl-</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._fl%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">fl/</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2.0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._-%7E3efl%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>fl</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._-%7E3efl%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>fl</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1.0</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">cr</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._fl-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">fl-</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._fl%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">fl/</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2.0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._-%7E3efl%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>fl</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._-%7E3efl%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-&gt;</span>fl</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1.5</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">zr</span><span class="hspace">&nbsp;</span><span class="RktVal">0.0</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">zi</span><span class="hspace">&nbsp;</span><span class="RktVal">0.0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">iterations</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">i</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">zrq</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._fl%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">fl*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">zr</span><span class="hspace">&nbsp;</span><span class="RktSym">zr</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">ziq</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._fl%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">fl*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">zi</span><span class="hspace">&nbsp;</span><span class="RktSym">zi</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._fl%7E3e%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">fl&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._fl%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">fl+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">zrq</span><span class="hspace">&nbsp;</span><span class="RktSym">ziq</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">4.0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._add1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._fl%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">fl+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._fl-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">fl-</a></span><span class="hspace">&nbsp;</span><span class="RktSym">zrq</span><span class="hspace">&nbsp;</span><span class="RktSym">ziq</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">cr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._fl%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">fl+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._fl%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">fl*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2.0</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._fl%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">fl*</a></span><span class="hspace">&nbsp;</span><span class="RktSym">zr</span><span class="hspace">&nbsp;</span><span class="RktSym">zi</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">ci</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>This conversion can speed <span class="RktSym">mandelbrot</span> by a factor of 8, even
+in sequential mode, but avoiding allocation also allows
+<span class="RktSym">mandelbrot</span> to run usefully faster in parallel.
+Executing this program yields the following in the visualizer:</p><p><span class="RktRes"><img style="vertical-align: 0px; margin: -3px -3px -3px -3px;" src="pict_5.png" alt="image" width="606" height="206"/></span></p><p>Notice that only one green bar is shown here because one of the
+mandelbrot computations is not being evaluated by a future (on
+the runtime thread).</p><p>As a general guideline, any operation that is inlined by the
+<a href="performance.html#%28tech._jit%29" class="techoutside" data-pltdoc="x"><span class="techinside">JIT</span></a> compiler runs safely in parallel, while other operations
+that are not inlined (including all operations if the JIT compiler is
+disabled) are considered unsafe. The <span class="stt">raco decompile</span> tool
+annotates operations that can be inlined by the compiler (see
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=decompile.html&amp;version=8.6" class="Sq" data-pltdoc="x"><span class="stt">raco decompile</span>: Decompiling Bytecode</a>), so the
+decompiler can be used to help predict parallel performance.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;effective-places&quot;">20.2<tt>&nbsp;</tt><a name="(part._effective-places)"></a>Parallelism with Places</h4><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/place</span></a> library provides support for
+performance improvement through parallelism with the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528form._%2528%2528lib._racket%252Fplace..rkt%2529._place%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">place</a></span>
+form. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528form._%2528%2528lib._racket%252Fplace..rkt%2529._place%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">place</a></span> form creates a <a name="(tech._place)"></a><span style="font-style: italic">place</span>, which is
+effectively a new Racket instance that can run in parallel to other
+places, including the initial place.  The full power of the Racket
+language is available at each place, but places can communicate only
+through message passing&#8212;<wbr></wbr>using the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528def._%2528%2528lib._racket%252Fplace..rkt%2529._place-channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">place-channel-put</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528def._%2528%2528lib._racket%252Fplace..rkt%2529._place-channel-get%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">place-channel-get</a></span> functions on a limited set of
+values&#8212;<wbr></wbr>which helps ensure the safety and independence of parallel
+computations.</p><p>As a starting example, the racket program below uses a <a href="parallelism.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">place</span></a> to
+determine whether any number in the list has a double that is also in
+the list:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">main</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">any-double?</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252For%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/or</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-list</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252For%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/or</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i2</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-list</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">i2</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">*</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">2</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">main</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">p</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528form._%2528%2528lib._racket%252Fplace..rkt%2529._place%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">place</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">ch</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">l</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528def._%2528%2528lib._racket%252Fplace..rkt%2529._place-channel-get%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">place-channel-get</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">ch</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">l-double?</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">any-double?</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">l</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528def._%2528%2528lib._racket%252Fplace..rkt%2529._place-channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">place-channel-put</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">ch</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">l-double?</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528def._%2528%2528lib._racket%252Fplace..rkt%2529._place-channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">place-channel-put</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">p</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">1</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">2</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">4</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">8</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528def._%2528%2528lib._racket%252Fplace..rkt%2529._place-channel-get%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">place-channel-get</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">p</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr></table></blockquote><p>The identifier <span class="RktSym">ch</span> after <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528form._%2528%2528lib._racket%252Fplace..rkt%2529._place%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">place</a></span> is bound to a <a name="(tech._place._channel)"></a><span style="font-style: italic">place
+channel</span>. The remaining body expressions within the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528form._%2528%2528lib._racket%252Fplace..rkt%2529._place%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">place</a></span> form
+are evaluated in a new place, and the body expressions use <span class="RktSym">ch</span>
+to communicate with the place that spawned the new place.</p><p>In the body of the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528form._%2528%2528lib._racket%252Fplace..rkt%2529._place%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">place</a></span> form above, the new place receives a
+list of numbers over <span class="RktSym">ch</span> and binds the list to <span class="RktSym">l</span>.  It
+then calls <span class="RktSym">any-double?</span> on the list and binds the result to
+<span class="RktSym">l-double?</span>. The final body expression sends the
+<span class="RktSym">l-double?</span> result back to the original place over <span class="RktSym">ch</span>.</p><p>In DrRacket, after saving and running the above program, evaluate
+<span class="RktPn">(</span><span class="RktSym">main</span><span class="RktPn">)</span> in the interactions window to create the new
+place. <span class="refelem"><span class="refcolumn"><span class="refcontent">When using <a href="parallelism.html#%28tech._place%29" class="techoutside" data-pltdoc="x"><span class="techinside">places</span></a> inside DrRacket, the
+module containing place code must be saved to a file before it will
+execute.</span></span></span>  Alternatively, save the program as <span class="stt">"double.rkt"</span>
+and run from a command line with</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">racket -tm double.rkt</span></p><p>where the <span class="nobreak"><span class="stt">-t</span></span> flag tells <span class="stt">racket</span> to load the
+<span class="stt">double.rkt</span> module, the <span class="nobreak"><span class="stt">-m</span></span> flag calls the exported
+<span class="RktSym">main</span> function, and <span class="nobreak"><span class="stt">-tm</span></span> combines the two flags.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528form._%2528%2528lib._racket%252Fplace..rkt%2529._place%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">place</a></span> form has two subtle features. First, it lifts the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528form._%2528%2528lib._racket%252Fplace..rkt%2529._place%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">place</a></span> body to an anonymous, module-level function.  This
+lifting means that any binding referenced by the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528form._%2528%2528lib._racket%252Fplace..rkt%2529._place%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">place</a></span> body
+must be available in the module&rsquo;s top level. Second, the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528form._%2528%2528lib._racket%252Fplace..rkt%2529._place%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">place</a></span> form <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Module_Names_and_Loading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._dynamic-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">dynamic-require</a></span>s the enclosing module in
+a newly created place. As part of the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Module_Names_and_Loading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._dynamic-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">dynamic-require</a></span>, the
+current module body is evaluated in the new place.  The consequence of
+this second feature is that <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528form._%2528%2528lib._racket%252Fplace..rkt%2529._place%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">place</a></span> should not appear immediately
+in a module or in a function that is called in a module&rsquo;s top level;
+otherwise, invoking the module will invoke the same module in a new
+place, and so on, triggering a cascade of place creations that will
+soon exhaust memory.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">main</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktCmt">;</span><span class="hspace">&nbsp;</span><span class="RktCmt">Don't</span><span class="hspace">&nbsp;</span><span class="RktCmt">do</span><span class="hspace">&nbsp;</span><span class="RktCmt">this!</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">p</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528form._%2528%2528lib._racket%252Fplace..rkt%2529._place%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">place</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">ch</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528def._%2528%2528lib._racket%252Fplace..rkt%2529._place-channel-get%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">place-channel-get</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">ch</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">indirect-place-invocation</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">p2</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528form._%2528%2528lib._racket%252Fplace..rkt%2529._place%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">place</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">ch</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528def._%2528%2528lib._racket%252Fplace..rkt%2529._place-channel-get%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">place-channel-get</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">ch</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktCmt">;</span><span class="hspace">&nbsp;</span><span class="RktCmt">Don't</span><span class="hspace">&nbsp;</span><span class="RktCmt">do</span><span class="hspace">&nbsp;</span><span class="RktCmt">this,</span><span class="hspace">&nbsp;</span><span class="RktCmt">either!</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">indirect-place-invocation</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr></table></blockquote><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;distributed-places&quot;">20.3<tt>&nbsp;</tt><a name="(part._distributed-places)"></a>Distributed Places</h4><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/place/distributed</span></a> library provides support for
+distributed programming.</p><p>The example below demonstrates how to launch a remote racket node instance,
+launch remote places on the new remote node instance, and start an
+event loop that monitors the remote node instance.</p><p>The example code can also be found in
+<span class="stt">"racket/distributed/examples/named/master.rkt"</span>.</p><blockquote class="Figure"><blockquote class="Centerfigure"><blockquote class="FigureInside"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">racket/place/distributed</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym">racket/class</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym">racket/place</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym">racket/runtime-path</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktVal">"bank.rkt"</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktVal">"tuple.rkt"</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">define-runtime-path</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">bank-path</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">"bank.rkt"</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">define-runtime-path</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">tuple-path</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">"tuple.rkt"</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">main</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">main</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">remote-node</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528def._%2528%2528lib._racket%252Fplace%252Fdistributed..rkt%2529._spawn-remote-racket-node%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">spawn-remote-racket-node</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktVal">"localhost"</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">#:listen-port</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">6344</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">tuple-place</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528def._%2528%2528lib._racket%252Fplace%252Fdistributed..rkt%2529._supervise-place-at%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">supervise-place-at</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym">remote-node</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">#:named</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">'</a></span><span class="RktSym">tuple-server</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym">tuple-path</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">'</a></span><span class="RktSym">make-tuple-server</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">bank-place</span><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528def._%2528%2528lib._racket%252Fplace%252Fdistributed..rkt%2529._supervise-place-at%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">supervise-place-at</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym">remote-node</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">bank-path</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">'</a></span><span class="RktSym">make-bank</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528def._%2528%2528lib._racket%252Fplace%252Fdistributed..rkt%2529._message-router%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">message-router</a></span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym">remote-node</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528form._%2528%2528lib._racket%252Fplace%252Fdistributed..rkt%2529._after-seconds%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">after-seconds</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">4</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">bank-new-account</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">bank-place</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">'</a></span><span class="RktSym">user0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">bank-add</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">bank-place</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">'</a></span><span class="RktSym">user0</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">10</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">bank-removeM</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">bank-place</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">'</a></span><span class="RktSym">user0</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528form._%2528%2528lib._racket%252Fplace%252Fdistributed..rkt%2529._after-seconds%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">after-seconds</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">2</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">c</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528def._%2528%2528lib._racket%252Fplace%252Fdistributed..rkt%2529._connect-to-named-place%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">connect-to-named-place</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">remote-node</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">'</a></span><span class="RktSym">tuple-server</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">d</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528def._%2528%2528lib._racket%252Fplace%252Fdistributed..rkt%2529._connect-to-named-place%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">connect-to-named-place</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">remote-node</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">'</a></span><span class="RktSym">tuple-server</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">tuple-server-hello</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">tuple-server-hello</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">d</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">tuple-server-set</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">c</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">"user0"</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">100</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">tuple-server-set</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">d</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">"user2"</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">200</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">tuple-server-get</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">c</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">"user0"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">tuple-server-get</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">d</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">"user2"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">tuple-server-get</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">d</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">"user0"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">tuple-server-get</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">c</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">"user2"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528form._%2528%2528lib._racket%252Fplace%252Fdistributed..rkt%2529._after-seconds%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">after-seconds</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">8</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528def._%2528%2528lib._racket%252Fplace%252Fdistributed..rkt%2529._node-send-exit%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">node-send-exit</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">remote-node</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528form._%2528%2528lib._racket%252Fplace%252Fdistributed..rkt%2529._after-seconds%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">after-seconds</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">10</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Exiting.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exit%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">exit</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr></table></blockquote></blockquote><p class="Centertext"><span class="Legend"><span class="FigureTarget"><a name="(counter._(figure._named-example-master))" x-target-lift="Figure"></a>Figure&nbsp;1: </span>examples/named/master.rkt</span></p></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528def._%2528%2528lib._racket%252Fplace%252Fdistributed..rkt%2529._spawn-remote-racket-node%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">spawn-remote-racket-node</a></span> primitive connects to
+<span class="stt">"localhost"</span> and starts a racloud node there that listens on port
+6344 for further instructions.  The handle to the new racloud node is
+assigned to the <span class="RktSym">remote-node</span> variable. Localhost is used so that
+the example can be run using only a single machine.  However localhost
+can be replaced by any host with ssh publickey access and racket.  The
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528def._%2528%2528lib._racket%252Fplace%252Fdistributed..rkt%2529._supervise-place-at%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">supervise-place-at</a></span> creates a new place on the
+<span class="RktSym">remote-node</span>.  The new place will be identified in the future by
+its name symbol <span class="RktVal">'</span><span class="RktVal">tuple-server</span>.  A place descriptor is
+expected to be returned by invoking <span class="RktSym">dynamic-place</span> with the
+<span class="RktSym">tuple-path</span> module path and the <span class="RktVal">'</span><span class="RktVal">make-tuple-server</span>
+symbol.</p><p>The code for the tuple-server place exists in the file
+<span class="stt">"tuple.rkt"</span>.  The <span class="stt">"tuple.rkt"</span> file contains the use of
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528form._%2528%2528lib._racket%252Fplace%252Fdefine-remote-server..rkt%2529._define-named-remote-server%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-named-remote-server</a></span> form, which defines a RPC server
+suitable for invocation by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528def._%2528%2528lib._racket%252Fplace%252Fdistributed..rkt%2529._supervise-place-at%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">supervise-place-at</a></span>.</p><blockquote class="Figure"><blockquote class="Centerfigure"><blockquote class="FigureInside"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">racket/match</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym">racket/place/define-remote-server</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528form._%2528%2528lib._racket%252Fplace%252Fdefine-remote-server..rkt%2529._define-named-remote-server%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-named-remote-server</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">tuple-server</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">define-state</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">h</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-hash%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-hash</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">define-rpc</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">set</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">k</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-set%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-set!</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">h</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">k</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">define-rpc</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">get</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-ref</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">h</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">k</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">define-cast</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">hello</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">"Hello</span><span class="hspace">&nbsp;</span><span class="RktVal">from</span><span class="hspace">&nbsp;</span><span class="RktVal">define-cast\n"</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-buffers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._flush-output%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">flush-output</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr></table></blockquote></blockquote><p class="Centertext"><span class="Legend"><span class="FigureTarget"><a name="(counter._(figure._named-example))" x-target-lift="Figure"></a>Figure&nbsp;2: </span>examples/named/tuple.rkt</span></p></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528form._%2528%2528lib._racket%252Fplace%252Fdefine-remote-server..rkt%2529._define-named-remote-server%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-named-remote-server</a></span> form takes an identifier and a
+list of custom expressions as its arguments.  From the identifier a
+place-thunk function is created by prepending the <span class="stt">make-</span> prefix.
+In this case <span class="RktSym">make-tuple-server</span>.  The
+<span class="RktSym">make-tuple-server</span> identifier is the
+<span class="RktSym">place-function-name</span> given to the
+<span class="RktSym">supervise-named-dynamic-place-at</span> form above. The
+<span class="RktSym">define-state</span> custom form translates into a simple
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> form, which is closed over by the <span class="RktSym">define-rpc</span>
+form.</p><p>The <span class="RktSym">define-rpc</span> form is expanded into two parts. The first
+part is the client stubs that call the rpc functions. The client
+function name is formed by concatenating the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528form._%2528%2528lib._racket%252Fplace%252Fdefine-remote-server..rkt%2529._define-named-remote-server%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-named-remote-server</a></span> identifier, <span class="stt">tuple-server</span>,
+with the RPC function name <span class="stt">set</span> to form <span class="RktSym">tuple-server-set</span>.
+The RPC client functions take a destination argument which is a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528def._%2528%2528lib._racket%252Fplace%252Fdistributed..rkt%2529._remote-connection%7E25%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">remote-connection%</a></span> descriptor and then the RPC function
+arguments. The RPC client function sends the RPC function name,
+<span class="RktSym">set</span>, and the RPC arguments to the destination by calling an
+internal function <span class="RktSym">named-place-channel-put</span>. The RPC client
+then calls <span class="RktSym">named-place-channel-get</span> to wait for the RPC
+response.</p><p>The second expansion part of <span class="RktSym">define-rpc</span> is the server
+implementation of the RPC call.  The server is implemented by a match
+expression inside the <span class="RktSym">make-tuple-server</span> function.  The match
+clause for <span class="RktSym">tuple-server-set</span> matches on messages beginning
+with the <span class="RktVal">'</span><span class="RktVal">set</span> symbol. The server executes the RPC call with
+the communicated arguments and sends the result back to the RPC
+client.</p><p>The <span class="RktSym">define-cast</span> form is similar to the <span class="RktSym">define-rpc</span> form
+except there is no reply message from the server to client</p><blockquote class="Figure"><blockquote class="Centerfigure"><blockquote class="FigureInside"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">tuple</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">racket/base</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">racket/place</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym">racket/match</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">define/provide</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">tuple-server-set</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">dest</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">k</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">named-place-channel-put</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">dest</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">'</a></span><span class="RktSym">set</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">k</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">named-place-channel-get</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">dest</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">define/provide</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">tuple-server-get</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">dest</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">named-place-channel-put</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">dest</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">'</a></span><span class="RktSym">get</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">named-place-channel-get</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">dest</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">define/provide</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">tuple-server-hello</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">dest</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">named-place-channel-put</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">dest</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">'</a></span><span class="RktSym">hello</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">define/provide</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">make-tuple-server</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">ch</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">h</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-hash%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-hash</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">loop</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">msg</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528def._%2528%2528lib._racket%252Fplace..rkt%2529._place-channel-get%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">place-channel-get</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">ch</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">log-to-parent-real</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym">msg</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">#:severity</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">severity</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">'</a></span><span class="RktSym">info</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528def._%2528%2528lib._racket%252Fplace..rkt%2529._place-channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">place-channel-put</a></span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym">ch</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528def._%2528%2528lib._racket%252Fplace%252Fdistributed..rkt%2529._log-message%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">log-message</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">severity</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">msg</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">syntax-parameterize</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=distributed-places&amp;rel=index.html%23%2528def._%2528%2528lib._racket%252Fplace%252Fdefine-remote-server..rkt%2529._log-to-parent%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">log-to-parent</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxtrans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-rename-transformer%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-rename-transformer</a></span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#'</a></span><span class="RktSym">log-to-parent-real</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=match.html%23%2528form._%2528%2528lib._racket%252Fmatch..rkt%2529._match%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">match</a></span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym">msg</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">'</a></span><span class="RktSym">set</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">k</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">src</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">result</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktPn">)</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-set%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-set!</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">h</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">k</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528def._%2528%2528lib._racket%252Fplace..rkt%2529._place-channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">place-channel-put</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">src</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">result</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">'</a></span><span class="RktSym">get</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">k</span><span class="RktPn">)</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">src</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">result</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktPn">)</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=hashtables.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._hash-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">hash-ref</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">h</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">k</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=places.html%23%2528def._%2528%2528lib._racket%252Fplace..rkt%2529._place-channel-put%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">place-channel-put</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">src</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">result</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">'</a></span><span class="RktSym">hello</span><span class="RktPn">)</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">src</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">result</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">"Hello</span><span class="hspace">&nbsp;</span><span class="RktVal">from</span><span class="hspace">&nbsp;</span><span class="RktVal">define-cast\n"</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-buffers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._flush-output%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">flush-output</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr></table></blockquote></blockquote><p class="Centertext"><span class="Legend"><span class="FigureTarget"><a name="(counter._(figure._define-named-remote-server-expansion))" x-target-lift="Figure"></a>Figure&nbsp;3: </span>Expansion of define-named-remote-server</span></p></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="performance.html" title="backward to &quot;19 Performance&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="running.html" title="forward to &quot;21 Running and Creating Executables&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/parameterize.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/parameterize.html
new file mode 100644
index 00000000..fbeed1e3
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/parameterize.html
@@ -0,0 +1,44 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.13&nbsp;Dynamic Binding: parameterize</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewselflink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="syntax-notation.html" class="tocviewlink" data-pltdoc="x">Notation</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="binding.html" class="tocviewlink" data-pltdoc="x">Identifiers and Binding</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Function Calls</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Functions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span></a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span></a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="conditionals.html" class="tocviewlink" data-pltdoc="x">Conditionals</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span></a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktVal">&rsquo;</span></a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="qq.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span> and <span class="RktVal">&lsquo;</span></a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Simple Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="parameterize.html" class="tocviewselflink" data-pltdoc="x">Dynamic Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">parameterize</span></span></a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="case.html" title="backward to &quot;4.12 Simple Dispatch: case&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="define-struct.html" title="forward to &quot;5 Programmer-Defined Datatypes&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;parameterize&quot;">4.13<tt>&nbsp;</tt><a name="(part._parameterize)"></a>Dynamic Binding: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span></h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html&amp;version=8.6" class="Sq" data-pltdoc="x">Parameters</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> also documents <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span>.</p></blockquote></blockquote></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span> form associates a new value with a
+<a name="(tech._parameter)"></a><span style="font-style: italic">parameter</span> during the evaluation of <span class="RktVar">body</span>
+expressions:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktVar">parameter-expr</span><span class="hspace">&nbsp;</span><span class="RktVar">value-expr</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">body</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The term &ldquo;parameter&rdquo; is sometimes used to refer to the
+arguments of a function, but &ldquo;parameter&rdquo; in Racket
+has the more specific meaning described here.</p></blockquote></blockquote></blockquote><p>For example, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._error-print-width%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">error-print-width</a></span> parameter controls how
+many characters of a value are printed in an error message:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._error-print-width%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">error-print-width</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._expt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">1024</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">car: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: pair?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 10...</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._error-print-width%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">error-print-width</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._expt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">expt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="hspace">&nbsp;</span><span class="RktVal">1024</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">car: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: pair?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 1000000...</span></p></td></tr></table></blockquote><p>More generally, parameters implement a kind of dynamic binding. The
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-parameter%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-parameter</a></span> function takes any value and returns a new
+parameter that is initialized to the given value. Applying the
+parameter as a function returns its current value:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">location</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-parameter%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-parameter</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"here"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">location</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"here"</span></p></td></tr></table></blockquote><p>In a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span> form, each <span class="RktVar">parameter-expr</span> must
+produce a parameter. During the evaluation of the <span class="RktSym">body</span>s, each
+specified parameter is given the result of the corresponding
+<span class="RktVar">value-expr</span>. When control leaves the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span>
+form&#8212;<wbr></wbr>either through a normal return, an exception, or some other
+escape&#8212;<wbr></wbr>the parameter reverts to its earlier value:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">location</span><span class="hspace">&nbsp;</span><span class="RktVal">"there"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">location</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"there"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">location</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"here"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">location</span><span class="hspace">&nbsp;</span><span class="RktVal">"in a house"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">location</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">location</span><span class="hspace">&nbsp;</span><span class="RktVal">"with a mouse"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">location</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">location</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("in a house" "with a mouse" "in a house")</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">location</span><span class="hspace">&nbsp;</span><span class="RktVal">"in a box"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">location</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">car: contract violation</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">expected: pair?</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: "in a box"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">location</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"here"</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span> form is not a binding form like
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span>; each use of <span class="RktSym">location</span> above refers directly to
+the original definition. A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span> form adjusts the
+value of a parameter during the whole time that the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span> body is evaluated, even for uses of the
+parameter that are textually outside of the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span>
+body:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">would-you-could-you?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">location</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"here"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">location</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"there"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">would-you-could-you?</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">location</span><span class="hspace">&nbsp;</span><span class="RktVal">"on a bus"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">would-you-could-you?</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote><p>If a use of a parameter is textually inside the body of a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span> but not evaluated before the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span> form produces a value, then the use does not see
+the value installed by the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span> form:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">get</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">location</span><span class="hspace">&nbsp;</span><span class="RktVal">"with a fox"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">location</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"here"</span></p></td></tr></table></blockquote><p>The current binding of a parameter can be adjusted imperatively by
+calling the parameter as a function with a value. If a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span> has adjusted the value of the parameter, then
+directly applying the parameter procedure affects only the value
+associated with the active <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">try-again!</span><span class="hspace">&nbsp;</span><span class="RktSym">where</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">location</span><span class="hspace">&nbsp;</span><span class="RktSym">where</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">location</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"here"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">location</span><span class="hspace">&nbsp;</span><span class="RktVal">"on a train"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">location</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">try-again!</span><span class="hspace">&nbsp;</span><span class="RktVal">"in a boat"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">location</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("on a train" "in a boat")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">location</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"here"</span></p></td></tr></table></blockquote><p>Using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span> is generally preferable to updating a
+parameter value imperatively&#8212;<wbr></wbr>for much the same reasons that binding
+a fresh variable with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> is preferable to using
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span>  (see <a href="set_.html" data-pltdoc="x">Assignment: <span class="RktSym"><span class="RktStxLink">set!</span></span></a>).</p><p>It may seem that variables and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span> can solve many of the
+same problems that parameters solve. For example, <span class="RktSym">lokation</span>
+could be defined as a string, and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span> could be used
+to adjust its value:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lokation</span><span class="hspace">&nbsp;</span><span class="RktVal">"here"</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">would-ya-could-ya?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lokation</span><span class="hspace">&nbsp;</span><span class="RktVal">"here"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._not%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">not</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lokation</span><span class="hspace">&nbsp;</span><span class="RktVal">"there"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lokation</span><span class="hspace">&nbsp;</span><span class="RktVal">"on a bus"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">would-ya-could-ya?</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote><p>Parameters, however, offer several crucial advantages over
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span>:</p><ul><li><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span> form helps automatically reset the
+value of a parameter when control escapes due to an exception.
+Adding exception handlers and other forms to rewind a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span> is relatively tedious.</p></li><li><p>Parameters work nicely with tail calls (see
+<a href="Lists__Iteration__and_Recursion.html#%28part._tail-recursion%29" data-pltdoc="x">Tail Recursion</a>). The last <span class="RktVar">body</span> in a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span> form is in <a href="Lists__Iteration__and_Recursion.html#%28tech._tail._position%29" class="techoutside" data-pltdoc="x"><span class="techinside">tail position</span></a> with
+respect to the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span> form.</p></li><li><p>Parameters work properly with threads (see
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=threads.html&amp;version=8.6" class="Sq" data-pltdoc="x">Threads</a>). The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span> form adjusts
+the value of a parameter only for evaluation in the current
+thread, which avoids race conditions with other threads.</p></li></ul><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="case.html" title="backward to &quot;4.12 Simple Dispatch: case&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="define-struct.html" title="forward to &quot;5 Programmer-Defined Datatypes&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/pattern-macros.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/pattern-macros.html
new file mode 100644
index 00000000..b73066c6
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/pattern-macros.html
@@ -0,0 +1,127 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>16.1&nbsp;Pattern-Based Macros</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.1&nbsp;</td><td><a href="pattern-macros.html" class="tocviewselflink" data-pltdoc="x">Pattern-<wbr></wbr>Based Macros</a></td></tr><tr><td align="right">16.2&nbsp;</td><td><a href="proc-macros.html" class="tocviewlink" data-pltdoc="x">General Macro Transformers</a></td></tr><tr><td align="right">16.3&nbsp;</td><td><a href="macro-module.html" class="tocviewlink" data-pltdoc="x">Module Instantiations and Visits</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>16.1&nbsp;</td><td><a href="pattern-macros.html" class="tocviewselflink" data-pltdoc="x">Pattern-<wbr></wbr>Based Macros</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.1.1&nbsp;</td><td><a href="pattern-macros.html#%28part._define-syntax-rule%29" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax-<wbr></wbr>rule</span></span></a></td></tr><tr><td align="right">16.1.2&nbsp;</td><td><a href="pattern-macros.html#%28part._.Lexical_.Scope%29" class="tocviewlink" data-pltdoc="x">Lexical Scope</a></td></tr><tr><td align="right">16.1.3&nbsp;</td><td><a href="pattern-macros.html#%28part._define-syntax_and_syntax-rules%29" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span> and <span class="RktSym"><span class="RktStxLink">syntax-<wbr></wbr>rules</span></span></a></td></tr><tr><td align="right">16.1.4&nbsp;</td><td><a href="pattern-macros.html#%28part._.Matching_.Sequences%29" class="tocviewlink" data-pltdoc="x">Matching Sequences</a></td></tr><tr><td align="right">16.1.5&nbsp;</td><td><a href="pattern-macros.html#%28part._.Identifier_.Macros%29" class="tocviewlink" data-pltdoc="x">Identifier Macros</a></td></tr><tr><td align="right">16.1.6&nbsp;</td><td><a href="pattern-macros.html#%28part._set__.Transformers%29" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">set!</span></span> Transformers</a></td></tr><tr><td align="right">16.1.7&nbsp;</td><td><a href="pattern-macros.html#%28part._.Macro-.Generating_.Macros%29" class="tocviewlink" data-pltdoc="x">Macro-<wbr></wbr>Generating Macros</a></td></tr><tr><td align="right">16.1.8&nbsp;</td><td><a href="pattern-macros.html#%28part._pattern-macro-example%29" class="tocviewlink" data-pltdoc="x">Extended Example:<span class="mywbr"> &nbsp;</span> Call-<wbr></wbr>by-<wbr></wbr>Reference Functions</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">16.1.1<tt>&nbsp;</tt></span><a href="pattern-macros.html#%28part._define-syntax-rule%29" class="tocsubseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax-<wbr></wbr>rule</span></span></a></td></tr><tr><td><span class="tocsublinknumber">16.1.2<tt>&nbsp;</tt></span><a href="pattern-macros.html#%28part._.Lexical_.Scope%29" class="tocsubseclink" data-pltdoc="x">Lexical Scope</a></td></tr><tr><td><span class="tocsublinknumber">16.1.3<tt>&nbsp;</tt></span><a href="pattern-macros.html#%28part._define-syntax_and_syntax-rules%29" class="tocsubseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">define-<wbr></wbr>syntax</span></span> and <span class="RktSym"><span class="RktStxLink">syntax-<wbr></wbr>rules</span></span></a></td></tr><tr><td><span class="tocsublinknumber">16.1.4<tt>&nbsp;</tt></span><a href="pattern-macros.html#%28part._.Matching_.Sequences%29" class="tocsubseclink" data-pltdoc="x">Matching Sequences</a></td></tr><tr><td><span class="tocsublinknumber">16.1.5<tt>&nbsp;</tt></span><a href="pattern-macros.html#%28part._.Identifier_.Macros%29" class="tocsubseclink" data-pltdoc="x">Identifier Macros</a></td></tr><tr><td><span class="tocsublinknumber">16.1.6<tt>&nbsp;</tt></span><a href="pattern-macros.html#%28part._set__.Transformers%29" class="tocsubseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">set!</span></span> Transformers</a></td></tr><tr><td><span class="tocsublinknumber">16.1.7<tt>&nbsp;</tt></span><a href="pattern-macros.html#%28part._.Macro-.Generating_.Macros%29" class="tocsubseclink" data-pltdoc="x">Macro-<wbr></wbr>Generating Macros</a></td></tr><tr><td><span class="tocsublinknumber">16.1.8<tt>&nbsp;</tt></span><a href="pattern-macros.html#%28part._pattern-macro-example%29" class="tocsubseclink" data-pltdoc="x">Extended Example:<span class="mywbr"> &nbsp;</span> Call-<wbr></wbr>by-<wbr></wbr>Reference Functions</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="macros.html" title="backward to &quot;16 Macros&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="macros.html" title="up to &quot;16 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="proc-macros.html" title="forward to &quot;16.2 General Macro Transformers&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;pattern-macros&quot;">16.1<tt>&nbsp;</tt><a name="(part._pattern-macros)"></a>Pattern-Based Macros</h4><p>A <a name="(tech._pattern._based._macro)"></a><span style="font-style: italic">pattern-based macro</span> replaces any code that matches a
+pattern to an expansion that uses parts of the original syntax that
+match parts of the pattern.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;define-syntax-rule&quot;">16.1.1<tt>&nbsp;</tt><a name="(part._define-syntax-rule)"></a><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._define-syntax-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-rule</a></span></h5><p>The simplest way to create a macro is to use
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._define-syntax-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-rule</a></span>:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._define-syntax-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-rule</a></span><span class="hspace">&nbsp;</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktVar">template</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>As a running example, consider the <span class="RktSym">swap</span> macro, which swaps
+the values stored in two variables. It can be implemented using
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._define-syntax-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-rule</a></span> as follows:</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The macro is &ldquo;un-Rackety&rdquo; in the sense that it
+involves side effects on variables&#8212;<wbr></wbr>but the point of macros is to let
+you add syntactic forms that some other language designer might not
+approve.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._define-syntax-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-rule</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">tmp</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">tmp</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._define-syntax-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-rule</a></span> form binds a macro that matches a
+single pattern. The pattern must always start with an open parenthesis
+followed by an identifier, which is <span class="RktSym">swap</span> in this case. After
+the initial identifier, other identifiers are <a name="(tech._macro._pattern._variable)"></a><span style="font-style: italic">macro pattern
+variables</span> that can match anything in a use of the macro. Thus, this
+macro matches the form <span class="RktPn">(</span><span class="RktSym">swap</span><span class="stt"> </span><span class="RktVar">form1</span><span class="stt"> </span><span class="RktVar">form2</span><span class="RktPn">)</span> for any
+<span class="RktVar">form1</span> and <span class="RktVar">form2</span>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Macro pattern variables are similar to pattern variables for
+<span class="RktSym">match</span>. See <a href="match.html" data-pltdoc="x">Pattern Matching</a>.</p></blockquote></blockquote></blockquote><p>After the pattern in <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._define-syntax-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-rule</a></span> is the
+<a name="(tech._template)"></a><span style="font-style: italic">template</span>. The template is used in place of a form that
+matches the pattern, except that each instance of a pattern variable
+in the template is replaced with the part of the macro use the pattern
+variable matched. For example, in</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">first</span><span class="hspace">&nbsp;</span><span class="RktSym">last</span><span class="RktPn">)</span></p></blockquote><p>the pattern variable <span class="RktSym">x</span> matches <span class="RktSym">first</span> and <span class="RktSym">y</span>
+matches <span class="RktSym">last</span>, so that the expansion is</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">tmp</span><span class="hspace">&nbsp;</span><span class="RktSym">first</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">first</span><span class="hspace">&nbsp;</span><span class="RktSym">last</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">last</span><span class="hspace">&nbsp;</span><span class="RktSym">tmp</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Lexical_Scope&quot;">16.1.2<tt>&nbsp;</tt><a name="(part._.Lexical_.Scope)"></a>Lexical Scope</h5><p>Suppose that we use the <span class="RktSym">swap</span> macro to swap variables named
+<span class="RktSym">tmp</span> and <span class="RktSym">other</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">tmp</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">other</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">tmp</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tmp</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The result of the above expression should be <span class="RktRes">(6<span class="stt"> </span>5)</span>. The
+naive expansion of this use of <span class="RktSym">swap</span>, however, is</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">tmp</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">other</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">tmp</span><span class="hspace">&nbsp;</span><span class="RktSym">tmp</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tmp</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="hspace">&nbsp;</span><span class="RktSym">tmp</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tmp</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>whose result is <span class="RktRes">(5<span class="stt"> </span>6)</span>. The problem is that the naive
+expansion confuses the <span class="RktSym">tmp</span> in the context where <span class="RktSym">swap</span>
+is used with the <span class="RktSym">tmp</span> that is in the macro template.</p><p>Racket doesn&rsquo;t produce the naive expansion for the above use of
+<span class="RktSym">swap</span>. Instead, it produces</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">tmp</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">other</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">tmp_1</span><span class="hspace">&nbsp;</span><span class="RktSym">tmp</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tmp</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="hspace">&nbsp;</span><span class="RktSym">tmp_1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tmp</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>with the correct result in <span class="RktRes">(6<span class="stt"> </span>5)</span>. Similarly, in the
+example</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">other</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>the expansion is</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">set!_1</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">other</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">tmp</span><span class="hspace">&nbsp;</span><span class="RktSym">set!_1</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">set!_1</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="hspace">&nbsp;</span><span class="RktSym">tmp</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">set!_1</span><span class="hspace">&nbsp;</span><span class="RktSym">other</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>so that the local <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span> binding doesn&rsquo;t interfere with the
+assignments introduced by the macro template.</p><p>In other words, Racket&rsquo;s pattern-based macros automatically maintain
+lexical scope, so macro implementors can reason about variable
+reference in macros and macro uses in the same way as for functions
+and function calls.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;define-syntax_and_syntax-rules&quot;">16.1.3<tt>&nbsp;</tt><a name="(part._define-syntax_and_syntax-rules)"></a><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span></h5><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._define-syntax-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-rule</a></span> form binds a macro that matches a
+single pattern, but Racket&rsquo;s macro system supports transformers that
+match multiple patterns starting with the same identifier. To write
+such macros, the programmer must use the more general
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span> form along with the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span>
+transformer form:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">literal-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktVar">template</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._define-syntax-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-rule</a></span> form is itself a macro
+that expands into <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span> with a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span>
+form that contains only one pattern and template.</p></blockquote></blockquote></blockquote><p>For example, suppose we would like a <span class="RktSym">rotate</span> macro that
+generalizes <span class="RktSym">swap</span> to work on either two or three identifiers,
+so that</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">red</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">green</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">blue</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rotate</span><span class="hspace">&nbsp;</span><span class="RktSym">red</span><span class="hspace">&nbsp;</span><span class="RktSym">green</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">swaps</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rotate</span><span class="hspace">&nbsp;</span><span class="RktSym">red</span><span class="hspace">&nbsp;</span><span class="RktSym">green</span><span class="hspace">&nbsp;</span><span class="RktSym">blue</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">rotates left</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">red</span><span class="hspace">&nbsp;</span><span class="RktSym">green</span><span class="hspace">&nbsp;</span><span class="RktSym">blue</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>produces <span class="RktRes">(1<span class="stt"> </span>3<span class="stt"> </span>2)</span>. We can implement <span class="RktSym">rotate</span>
+using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rotate</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">rotate</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">rotate</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The expression <span class="RktPn">(</span><span class="RktSym">rotate</span><span class="stt"> </span><span class="RktSym">red</span><span class="stt"> </span><span class="RktSym">green</span><span class="RktPn">)</span> matches the first pattern
+in the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span> form, so it expands to <span class="RktPn">(</span><span class="RktSym">swap</span><span class="stt"> </span><span class="RktSym">red</span><span class="stt"> </span><span class="RktSym">green</span><span class="RktPn">)</span>. The expression <span class="RktPn">(</span><span class="RktSym">rotate</span><span class="stt"> </span><span class="RktSym">red</span><span class="stt"> </span><span class="RktSym">green</span><span class="stt"> </span><span class="RktSym">blue</span><span class="RktPn">)</span> matches the second
+pattern, so it expands to <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="stt"> </span><span class="RktSym">red</span><span class="stt"> </span><span class="RktSym">green</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="stt"> </span><span class="RktSym">green</span><span class="stt"> </span><span class="RktSym">blue</span><span class="RktPn">)</span><span class="RktPn">)</span>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Matching_Sequences&quot;">16.1.4<tt>&nbsp;</tt><a name="(part._.Matching_.Sequences)"></a>Matching Sequences</h5><p>A better <span class="RktSym">rotate</span> macro would allow any number of identifiers,
+instead of just two or three. To match a use of <span class="RktSym">rotate</span> with
+any number of identifiers, we need a pattern form that has something
+like a Kleene star. In a Racket macro pattern, a star is written as
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span>.</p><p>To implement <span class="RktSym">rotate</span> with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span>, we need a base case to
+handle a single identifier, and an inductive case to handle more than
+one identifier:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rotate</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">rotate</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">rotate</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rotate</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>When a pattern variable like <span class="RktSym">c</span> is followed by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span> in
+a pattern, then it must be followed by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span> in a template,
+too. The pattern variable effectively matches a sequence of zero or
+more forms, and it is replaced in the template by the same sequence.</p><p>Both versions of <span class="RktSym">rotate</span> so far are a bit inefficient, since
+pairwise swapping keeps moving the value from the first variable into
+every variable in the sequence until it arrives at the last one. A
+more efficient <span class="RktSym">rotate</span> would move the first value directly to
+the last variable. We can use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span> patterns to implement the
+more efficient variant using a helper macro:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">rotate</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">rotate</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">shift-to</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">shift-to</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">shift-to</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">from0</span><span class="hspace">&nbsp;</span><span class="RktSym">from</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">to0</span><span class="hspace">&nbsp;</span><span class="RktSym">to</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">tmp</span><span class="hspace">&nbsp;</span><span class="RktSym">from0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">to</span><span class="hspace">&nbsp;</span><span class="RktSym">from</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">to0</span><span class="hspace">&nbsp;</span><span class="RktSym">tmp</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>In the <span class="RktSym">shift-to</span> macro, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span> in the template follows
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="stt"> </span><span class="RktSym">to</span><span class="stt"> </span><span class="RktSym">from</span><span class="RktPn">)</span>, which causes the <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="stt"> </span><span class="RktSym">to</span><span class="stt"> </span><span class="RktSym">from</span><span class="RktPn">)</span>
+expression to be duplicated as many times as necessary to use each
+identifier matched in the <span class="RktSym">to</span> and <span class="RktSym">from</span>
+sequences. (The number of <span class="RktSym">to</span> and <span class="RktSym">from</span> matches must
+be the same, otherwise the macro expansion fails with an error.)</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Identifier_Macros&quot;">16.1.5<tt>&nbsp;</tt><a name="(part._.Identifier_.Macros)"></a>Identifier Macros</h5><p>Given our macro definitions, the <span class="RktSym">swap</span> or <span class="RktSym">rotate</span>
+identifiers must be used after an open parenthesis, otherwise a syntax
+error is reported:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">eval:2:0: swap: bad syntax</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: swap</span></p></td></tr></table></blockquote><p>An <a name="(tech._identifier._macro)"></a><span style="font-style: italic">identifier macro</span> is a pattern-matching macro that
+works when used by itself without parentheses. For example, we
+can define <span class="RktSym">val</span> as an identifier macro that expands to
+<span class="RktPn">(</span><span class="RktSym">get-val</span><span class="RktPn">)</span>, so <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktSym">val</span><span class="stt"> </span><span class="RktVal">3</span><span class="RktPn">)</span> would expand to
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">get-val</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">3</span><span class="RktPn">)</span>.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">val</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fstx..rkt%2529._identifier%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-val</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-val</span><span class="hspace">&nbsp;</span><span class="RktSym">put-val!</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">private-val</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">private-val</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">private-val</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">val</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></blockquote><p>The <span class="RktSym">val</span> macro uses <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span>, which enables defining more
+powerful macros and will be explained in the <a href="syntax-case.html" data-pltdoc="x">Mixing Patterns and Expressions: <span class="RktSym"><span class="RktStxLink">syntax-case</span></span></a> section.
+For now it is sufficient to know that to define a macro, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span>
+is used in a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span>, and its templates must be wrapped with an explicit
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax</a></span> constructor. Finally, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span> clauses
+may specify additional guard conditions after the pattern.</p><p>Our <span class="RktSym">val</span> macro uses an <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fstx..rkt%2529._identifier%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">identifier?</a></span> condition to ensure that
+<span class="RktSym">val</span> <span class="emph">must not</span> be used with parentheses. Instead, the macro raises
+a syntax error:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">val</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">eval:8:0: val: bad syntax</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (val)</span></p></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;set__Transformers&quot;">16.1.6<tt>&nbsp;</tt><a name="(part._set__.Transformers)"></a><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span> Transformers</h5><p>With the above <span class="RktSym">val</span> macro, we still must call <span class="RktSym">put-val!</span> to
+change the stored value. It would be more convenient, however, to use
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span> directly on <span class="RktSym">val</span>. To invoke the macro when <span class="RktSym">val</span> is
+used with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span>, we create an
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=syntax-model.html%23%2528tech._assignment._transformer%2529&amp;version=8.6" class="techoutside Sq" data-pltdoc="x"><span class="techinside">assignment transformer</span></a>
+with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxtrans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-set%2521-transformer%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-set!-transformer</a></span>.
+We must also declare <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span> as a literal in the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span>
+literal list.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">val2</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxtrans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-set%2521-transformer%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-set!-transformer</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">val2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fstx..rkt%2529._identifier%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">val2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get-val</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">val2</span><span class="hspace">&nbsp;</span><span class="RktSym">e</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">put-val!</span><span class="hspace">&nbsp;</span><span class="RktSym">e</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">val2</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">val2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">val2</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">val2</span></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Macro-Generating_Macros&quot;">16.1.7<tt>&nbsp;</tt><a name="(part._.Macro-.Generating_.Macros)"></a>Macro-Generating Macros</h5><p>Suppose that we have many identifiers like <span class="RktSym">val</span> and <span class="RktSym">val2</span>
+that we&rsquo;d like to redirect to accessor and mutator functions like
+<span class="RktSym">get-val</span> and <span class="RktSym">put-val!</span>. We&rsquo;d like to be able to
+just write:</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym">define-get/put-id</span><span class="hspace">&nbsp;</span><span class="RktSym">val</span><span class="hspace">&nbsp;</span><span class="RktSym">get-val</span><span class="hspace">&nbsp;</span><span class="RktSym">put-val!</span><span class="RktPn">)</span></p></blockquote><p>Naturally, we can implement <span class="RktSym">define-get/put-id</span> as a macro:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._define-syntax-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-rule</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-get/put-id</span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym">get</span><span class="hspace">&nbsp;</span><span class="RktSym">put!</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxtrans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-set%2521-transformer%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-set!-transformer</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fstx..rkt%2529._identifier%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym">e</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">put!</span><span class="hspace">&nbsp;</span><span class="RktSym">e</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">define-get/put-id</span><span class="hspace">&nbsp;</span><span class="RktSym">val3</span><span class="hspace">&nbsp;</span><span class="RktSym">get-val</span><span class="hspace">&nbsp;</span><span class="RktSym">put-val!</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">val3</span><span class="hspace">&nbsp;</span><span class="RktVal">11</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">val3</span></td></tr><tr><td><p><span class="RktRes">11</span></p></td></tr></table></blockquote><p>The <span class="RktSym">define-get/put-id</span> macro is a <a name="(tech._macro._generating._macro)"></a><span style="font-style: italic">macro-generating
+macro</span>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;pattern-macro-example&quot;">16.1.8<tt>&nbsp;</tt><a name="(part._pattern-macro-example)"></a>Extended Example: Call-by-Reference Functions</h5><p>We can use pattern-matching macros to add a form to Racket
+for defining first-order <a name="(tech._call._by._reference)"></a><span style="font-style: italic">call-by-reference</span> functions. When a
+call-by-reference function body mutates its formal argument, the
+mutation applies to variables that are supplied as actual arguments in
+a call to the function.</p><p>For example, if <span class="RktSym">define-cbr</span> is like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> except
+that it defines a call-by-reference function, then</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym">define-cbr</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>produces <span class="RktRes">(2<span class="stt"> </span>1)</span>.</p><p>We will implement call-by-reference functions by having function calls
+supply accessor and mutators for the arguments, instead of supplying
+argument values directly. In particular, for the function <span class="RktSym">f</span>
+above, we&rsquo;ll generate</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">do-f</span><span class="hspace">&nbsp;</span><span class="RktSym">get-a</span><span class="hspace">&nbsp;</span><span class="RktSym">get-b</span><span class="hspace">&nbsp;</span><span class="RktSym">put-a!</span><span class="hspace">&nbsp;</span><span class="RktSym">put-b!</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-get/put-id</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">get-a</span><span class="hspace">&nbsp;</span><span class="RktSym">put-a!</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-get/put-id</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">get-b</span><span class="hspace">&nbsp;</span><span class="RktSym">put-b!</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>and redirect a function call <span class="RktPn">(</span><span class="RktSym">f</span><span class="stt"> </span><span class="RktSym">x</span><span class="stt"> </span><span class="RktSym">y</span><span class="RktPn">)</span> to</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym">do-f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Clearly, then <span class="RktSym">define-cbr</span> is a macro-generating macro, which
+binds <span class="RktSym">f</span> to a macro that expands to a call of <span class="RktSym">do-f</span>.
+That is, <span class="RktPn">(</span><span class="RktSym">define-cbr</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">f</span><span class="stt"> </span><span class="RktSym">a</span><span class="stt"> </span><span class="RktSym">b</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="stt"> </span><span class="RktSym">a</span><span class="stt"> </span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span> needs to generate the
+definition</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym">actual</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">do-f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">actual</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">actual</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>At the same time, <span class="RktSym">define-cbr</span> needs to define <span class="RktSym">do-f</span>
+using the body of <span class="RktSym">f</span>, this second part is slightly more
+complex, so we defer most of it to a <span class="RktSym">define-for-cbr</span> helper
+module, which lets us write <span class="RktSym">define-cbr</span> easily enough:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._define-syntax-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-rule</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-cbr</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym">arg</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">body</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">id</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym">actual</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">do-f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">actual</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">actual</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-for-cbr</span><span class="hspace">&nbsp;</span><span class="RktSym">do-f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">arg</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">explained below...</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">body</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Our remaining task is to define <span class="RktSym">define-for-cbr</span> so that it
+converts</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym">define-for-cbr</span><span class="hspace">&nbsp;</span><span class="RktSym">do-f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></p></blockquote><p>to the function definition <span class="RktSym">do-f</span> above. Most of the work is
+generating a <span class="RktSym">define-get/put-id</span> declaration for each argument,
+<span class="RktSym">a</span> and <span class="RktSym">b</span>, and putting them before the body. Normally,
+that&rsquo;s an easy task for <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span> in a pattern and template, but
+this time there&rsquo;s a catch: we need to generate the names
+<span class="RktSym">get-a</span> and <span class="RktSym">put-a!</span> as well as <span class="RktSym">get-b</span> and
+<span class="RktSym">put-b!</span>, and the pattern language provides no way to
+synthesize identifiers based on existing identifiers.</p><p>As it turns out, lexical scope gives us a way around this problem. The
+trick is to iterate expansions of <span class="RktSym">define-for-cbr</span> once for
+each argument in the function, and that&rsquo;s why <span class="RktSym">define-for-cbr</span>
+starts with an apparently useless <span class="RktPn">(</span><span class="RktPn">)</span> after the argument
+list. We need to keep track of all the arguments seen so far and the
+<span class="RktSym">get</span> and <span class="RktSym">put</span> names generated for each, in addition to
+the arguments left to process. After we&rsquo;ve processed all the
+identifiers, then we have all the names we need.</p><p>Here is the definition of <span class="RktSym">define-for-cbr</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">define-for-cbr</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">define-for-cbr</span><span class="hspace">&nbsp;</span><span class="RktSym">do-f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">id0</span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gens</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">body</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-for-cbr</span><span class="hspace">&nbsp;</span><span class="RktSym">do-f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">gens</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">id0</span><span class="hspace">&nbsp;</span><span class="RktSym">get</span><span class="hspace">&nbsp;</span><span class="RktSym">put</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">body</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">define-for-cbr</span><span class="hspace">&nbsp;</span><span class="RktSym">do-f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym">get</span><span class="hspace">&nbsp;</span><span class="RktSym">put</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">body</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">do-f</span><span class="hspace">&nbsp;</span><span class="RktSym">get</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym">put</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-get/put-id</span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym">get</span><span class="hspace">&nbsp;</span><span class="RktSym">put</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">body</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Step-by-step, expansion proceeds as follows:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym">define-for-cbr</span><span class="hspace">&nbsp;</span><span class="RktSym">do-f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">=&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-for-cbr</span><span class="hspace">&nbsp;</span><span class="RktSym">do-f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">get_1</span><span class="hspace">&nbsp;</span><span class="RktSym">put_1</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">=&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-for-cbr</span><span class="hspace">&nbsp;</span><span class="RktSym">do-f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">get_1</span><span class="hspace">&nbsp;</span><span class="RktSym">put_1</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">get_2</span><span class="hspace">&nbsp;</span><span class="RktSym">put_2</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">=&gt;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">do-f</span><span class="hspace">&nbsp;</span><span class="RktSym">get_1</span><span class="hspace">&nbsp;</span><span class="RktSym">get_2</span><span class="hspace">&nbsp;</span><span class="RktSym">put_1</span><span class="hspace">&nbsp;</span><span class="RktSym">put_2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-get/put-id</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">get_1</span><span class="hspace">&nbsp;</span><span class="RktSym">put_1</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-get/put-id</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">get_2</span><span class="hspace">&nbsp;</span><span class="RktSym">put_2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The &ldquo;subscripts&rdquo; on <span class="RktSym">get_1</span>, <span class="RktSym">get_2</span>,
+<span class="RktSym">put_1</span>, and <span class="RktSym">put_2</span> are inserted by the macro
+expander to preserve lexical scope, since the <span class="RktSym">get</span>
+generated by each iteration of <span class="RktSym">define-for-cbr</span> should not
+bind the <span class="RktSym">get</span> generated by a different iteration. In
+other words, we are essentially tricking the macro expander into
+generating fresh names for us, but the technique illustrates some
+of the surprising power of pattern-based macros with automatic
+lexical scope.</p><p>The last expression eventually expands to just</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">do-f</span><span class="hspace">&nbsp;</span><span class="RktSym">get_1</span><span class="hspace">&nbsp;</span><span class="RktSym">get_2</span><span class="hspace">&nbsp;</span><span class="RktSym">put_1</span><span class="hspace">&nbsp;</span><span class="RktSym">put_2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">tmp</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get_1</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">put_1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">get_2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">put_2</span><span class="hspace">&nbsp;</span><span class="RktSym">tmp</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>which implements the call-by-name function <span class="RktSym">f</span>.</p><p>To summarize, then, we can add call-by-reference functions to
+Racket with just three small pattern-based macros:
+<span class="RktSym">define-cbr</span>, <span class="RktSym">define-for-cbr</span>, and
+<span class="RktSym">define-get/put-id</span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="macros.html" title="backward to &quot;16 Macros&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="macros.html" title="up to &quot;16 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="proc-macros.html" title="forward to &quot;16.2 General Macro Transformers&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/performance.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/performance.html
new file mode 100644
index 00000000..59382496
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/performance.html
@@ -0,0 +1,348 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>19&nbsp;Performance</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9660;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewselflink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>19&nbsp;</td><td><a href="performance.html" class="tocviewselflink" data-pltdoc="x">Performance</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">19.1&nbsp;</td><td><a href="performance.html#%28part._.Dr.Racket-perf%29" class="tocviewlink" data-pltdoc="x">Performance in Dr<span class="mywbr"> &nbsp;</span>Racket</a></td></tr><tr><td align="right">19.2&nbsp;</td><td><a href="performance.html#%28part._virtual-machines%29" class="tocviewlink" data-pltdoc="x">Racket Virtual Machine Implementations</a></td></tr><tr><td align="right">19.3&nbsp;</td><td><a href="performance.html#%28part._.J.I.T%29" class="tocviewlink" data-pltdoc="x">Bytecode, Machine Code, and Just-<wbr></wbr>in-<wbr></wbr>Time (JIT) Compilers</a></td></tr><tr><td align="right">19.4&nbsp;</td><td><a href="performance.html#%28part._modules-performance%29" class="tocviewlink" data-pltdoc="x">Modules and Performance</a></td></tr><tr><td align="right">19.5&nbsp;</td><td><a href="performance.html#%28part._func-call-performance%29" class="tocviewlink" data-pltdoc="x">Function-<wbr></wbr>Call Optimizations</a></td></tr><tr><td align="right">19.6&nbsp;</td><td><a href="performance.html#%28part._.Mutation_and_.Performance%29" class="tocviewlink" data-pltdoc="x">Mutation and Performance</a></td></tr><tr><td align="right">19.7&nbsp;</td><td><a href="performance.html#%28part._letrec-performance%29" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">letrec</span></span> Performance</a></td></tr><tr><td align="right">19.8&nbsp;</td><td><a href="performance.html#%28part._fixnums%2Bflonums%29" class="tocviewlink" data-pltdoc="x">Fixnum and Flonum Optimizations</a></td></tr><tr><td align="right">19.9&nbsp;</td><td><a href="performance.html#%28part._unchecked-unsafe%29" class="tocviewlink" data-pltdoc="x">Unchecked, Unsafe Operations</a></td></tr><tr><td align="right">19.10&nbsp;</td><td><a href="performance.html#%28part._ffi-pointer-access%29" class="tocviewlink" data-pltdoc="x">Foreign Pointers</a></td></tr><tr><td align="right">19.11&nbsp;</td><td><a href="performance.html#%28part._regexp-perf%29" class="tocviewlink" data-pltdoc="x">Regular Expression Performance</a></td></tr><tr><td align="right">19.12&nbsp;</td><td><a href="performance.html#%28part._gc-perf%29" class="tocviewlink" data-pltdoc="x">Memory Management</a></td></tr><tr><td align="right">19.13&nbsp;</td><td><a href="performance.html#%28part._.Reachability._and._.Garbage._.Collection%29" class="tocviewlink" data-pltdoc="x">Reachability and Garbage Collection</a></td></tr><tr><td align="right">19.14&nbsp;</td><td><a href="performance.html#%28part._.Weak_.Boxes_and_.Testing%29" class="tocviewlink" data-pltdoc="x">Weak Boxes and Testing</a></td></tr><tr><td align="right">19.15&nbsp;</td><td><a href="performance.html#%28part._.Reducing_.Garbage_.Collection_.Pauses%29" class="tocviewlink" data-pltdoc="x">Reducing Garbage Collection Pauses</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">19.1<tt>&nbsp;</tt></span><a href="performance.html#%28part._.Dr.Racket-perf%29" class="tocsubseclink" data-pltdoc="x">Performance in Dr<span class="mywbr"> &nbsp;</span>Racket</a></td></tr><tr><td><span class="tocsublinknumber">19.2<tt>&nbsp;</tt></span><a href="performance.html#%28part._virtual-machines%29" class="tocsubseclink" data-pltdoc="x">Racket Virtual Machine Implementations</a></td></tr><tr><td><span class="tocsublinknumber">19.3<tt>&nbsp;</tt></span><a href="performance.html#%28part._.J.I.T%29" class="tocsubseclink" data-pltdoc="x">Bytecode, Machine Code, and Just-<wbr></wbr>in-<wbr></wbr>Time (JIT) Compilers</a></td></tr><tr><td><span class="tocsublinknumber">19.4<tt>&nbsp;</tt></span><a href="performance.html#%28part._modules-performance%29" class="tocsubseclink" data-pltdoc="x">Modules and Performance</a></td></tr><tr><td><span class="tocsublinknumber">19.5<tt>&nbsp;</tt></span><a href="performance.html#%28part._func-call-performance%29" class="tocsubseclink" data-pltdoc="x">Function-<wbr></wbr>Call Optimizations</a></td></tr><tr><td><span class="tocsublinknumber">19.6<tt>&nbsp;</tt></span><a href="performance.html#%28part._.Mutation_and_.Performance%29" class="tocsubseclink" data-pltdoc="x">Mutation and Performance</a></td></tr><tr><td><span class="tocsublinknumber">19.7<tt>&nbsp;</tt></span><a href="performance.html#%28part._letrec-performance%29" class="tocsubseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">letrec</span></span> Performance</a></td></tr><tr><td><span class="tocsublinknumber">19.8<tt>&nbsp;</tt></span><a href="performance.html#%28part._fixnums%2Bflonums%29" class="tocsubseclink" data-pltdoc="x">Fixnum and Flonum Optimizations</a></td></tr><tr><td><span class="tocsublinknumber">19.9<tt>&nbsp;</tt></span><a href="performance.html#%28part._unchecked-unsafe%29" class="tocsubseclink" data-pltdoc="x">Unchecked, Unsafe Operations</a></td></tr><tr><td><span class="tocsublinknumber">19.10<tt>&nbsp;</tt></span><a href="performance.html#%28part._ffi-pointer-access%29" class="tocsubseclink" data-pltdoc="x">Foreign Pointers</a></td></tr><tr><td><span class="tocsublinknumber">19.11<tt>&nbsp;</tt></span><a href="performance.html#%28part._regexp-perf%29" class="tocsubseclink" data-pltdoc="x">Regular Expression Performance</a></td></tr><tr><td><span class="tocsublinknumber">19.12<tt>&nbsp;</tt></span><a href="performance.html#%28part._gc-perf%29" class="tocsubseclink" data-pltdoc="x">Memory Management</a></td></tr><tr><td><span class="tocsublinknumber">19.13<tt>&nbsp;</tt></span><a href="performance.html#%28part._.Reachability._and._.Garbage._.Collection%29" class="tocsubseclink" data-pltdoc="x">Reachability and Garbage Collection</a></td></tr><tr><td><span class="tocsublinknumber">19.14<tt>&nbsp;</tt></span><a href="performance.html#%28part._.Weak_.Boxes_and_.Testing%29" class="tocsubseclink" data-pltdoc="x">Weak Boxes and Testing</a></td></tr><tr><td><span class="tocsublinknumber">19.15<tt>&nbsp;</tt></span><a href="performance.html#%28part._.Reducing_.Garbage_.Collection_.Pauses%29" class="tocsubseclink" data-pltdoc="x">Reducing Garbage Collection Pauses</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="concurrency.html" title="backward to &quot;18 Concurrency and Synchronization&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="parallelism.html" title="forward to &quot;20 Parallelism&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;performance&quot;">19<tt>&nbsp;</tt><a name="(part._performance)"></a><a name="(idx._(gentag._6._(lib._scribblings/guide/guide..scrbl)))"></a><a name="(idx._(gentag._7._(lib._scribblings/guide/guide..scrbl)))"></a>Performance</h3><p>Alan Perlis famously quipped &ldquo;Lisp programmers know the value of
+everything and the cost of nothing.&rdquo; A Racket programmer knows, for
+example, that a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> anywhere in a program produces a value
+that is closed over its lexical environment&#8212;<wbr></wbr>but how much does
+allocating that value cost? While most programmers have a reasonable
+grasp of the cost of various operations and data structures at the
+machine level, the gap between the Racket language model and the
+underlying computing machinery can be quite large.</p><p>In this chapter, we narrow the gap by explaining details of the
+Racket compiler and runtime system and how they affect the runtime
+and memory performance of Racket code.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;DrRacket-perf&quot;">19.1<tt>&nbsp;</tt><a name="(part._.Dr.Racket-perf)"></a>Performance in DrRacket</h4><p>By default, DrRacket instruments programs for debugging, and
+debugging instrumentation (provided by the
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=errortrace&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">Errortrace: Debugging and Profiling</a>
+library) can significantly degrade performance for
+some programs. Even when debugging is disabled through the
+<span class="ssansserif">Choose Language...</span> dialog&rsquo;s <span class="ssansserif">Show Details</span> panel,
+the <span class="ssansserif">Preserve stacktrace</span> checkbox is clicked by default,
+which also affects performance. Disabling debugging and stacktrace
+preservation provides performance results that are more consistent
+with running in plain <span class="stt">racket</span>.</p><p>Even so, DrRacket and programs developed within DrRacket use the same
+Racket virtual machine, so garbage collection times (see
+<a href="performance.html#%28part._gc-perf%29" data-pltdoc="x">Memory Management</a>) may be longer in DrRacket than when a program is
+run by itself, and DrRacket threads may impede execution of program
+threads. <span style="font-weight: bold">For the most reliable timing results for a program, run in
+plain <span class="stt">racket</span> instead of in the DrRacket development environment.</span>
+Non-interactive mode should be used instead of the
+<a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> to benefit from the module system. See
+<a href="performance.html#%28part._modules-performance%29" data-pltdoc="x">Modules and Performance</a> for details.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;virtual-machines&quot;">19.2<tt>&nbsp;</tt><a name="(part._virtual-machines)"></a>Racket Virtual Machine Implementations</h4><p>Racket is available in two implementations, <a name="(tech._c)"></a><span style="font-style: italic">CS</span> and
+<a name="(tech._bc)"></a><span style="font-style: italic">BC</span>:</p><ul><li><p><a href="performance.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a> is the current default implementation. It is
+a newer implementation that builds on
+<a href="https://www.scheme.com/">Chez Scheme</a> as its core
+virtual machine. This implementation performs better than
+the <a href="performance.html#%28tech._bc%29" class="techoutside" data-pltdoc="x"><span class="techinside">BC</span></a> implementation for most programs.</p><p>For this implementation, <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=runtime.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._system-type%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">system-type</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">vm</span><span class="RktPn">)</span> reports
+<span class="RktVal">'</span><span class="RktVal">chez-scheme</span> and <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=runtime.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._system-type%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">system-type</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">gc</span><span class="RktPn">)</span> reports
+<span class="RktVal">'</span><span class="RktVal">cs</span>.</p></li><li><p><a href="performance.html#%28tech._bc%29" class="techoutside" data-pltdoc="x"><span class="techinside">BC</span></a> is an older implementation, and was the default until version 8.0.
+The implementation features a compiler and runtime written in C,
+with a precise garbage collector and a just-in-time compiler (JIT)
+on most platforms.</p><p>For this implementation, <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=runtime.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._system-type%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">system-type</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">vm</span><span class="RktPn">)</span> reports
+<span class="RktVal">'</span><span class="RktVal">racket</span>.</p><p>The BC implementation itself has two variants, <a name="(tech._3m)"></a><span style="font-style: italic">3m</span> and
+<a name="(tech._cgc)"></a><span style="font-style: italic">CGC</span>:</p><ul><li><p><a href="performance.html#%28tech._3m%29" class="techoutside" data-pltdoc="x"><span class="techinside">3m</span></a> is the normal BC variant with a precise
+ garbage collector.</p><p>For this variant, <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=runtime.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._system-type%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">system-type</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">gc</span><span class="RktPn">)</span> reports
+<span class="RktVal">'</span><span class="RktVal">3m</span>.</p></li><li><p><a href="performance.html#%28tech._cgc%29" class="techoutside" data-pltdoc="x"><span class="techinside">CGC</span></a> is the oldest variant. It&rsquo;s the same basic
+implementation as <a href="performance.html#%28tech._3m%29" class="techoutside" data-pltdoc="x"><span class="techinside">3m</span></a> (i.e., the same virtual
+machine), but compiled to rely on a &ldquo;conservative&rdquo;
+garbage collector, which affects the way that Racket
+interacts with C code. See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=inside&amp;rel=overview.html%23%2528part._.C.G.C._versus._3m%2529&amp;version=8.6" class="Sq" data-pltdoc="x">CGC versus 3m</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=inside&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">Inside: Racket C API</a> for more
+information.</p><p>For this variant, <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=runtime.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._system-type%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">system-type</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">gc</span><span class="RktPn">)</span> reports
+<span class="RktVal">'</span><span class="RktVal">cgc</span>.</p></li></ul></li></ul><p>In general, Racket programs should run the same in all variants.
+Furthermore, the performance characteristics of Racket program should
+be similar in the <a href="performance.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a> and <a href="performance.html#%28tech._bc%29" class="techoutside" data-pltdoc="x"><span class="techinside">BC</span></a> implementations. The cases
+where a program may depend on the implementation will typically
+involve interactions with foreign libraries; in particular, the Racket
+C API described in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=inside&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">Inside: Racket C API</a> is different for the
+<a href="performance.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a> implementation versus the <a href="performance.html#%28tech._bc%29" class="techoutside" data-pltdoc="x"><span class="techinside">BC</span></a> implementation.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;JIT&quot;">19.3<tt>&nbsp;</tt><a name="(part._.J.I.T)"></a>Bytecode, Machine Code, and Just-in-Time (JIT) Compilers</h4><p>Every definition or expression to be evaluated by Racket is compiled
+to an internal bytecode format, although &ldquo;bytecode&rdquo; may actually be
+native machine code. In interactive mode, this compilation occurs
+automatically and on-the-fly. Tools like <span class="stt">raco make</span> and
+<span class="stt">raco setup</span> marshal compiled bytecode to a file, so that you do
+not have to compile from source every time that you run a program.
+See <a href="cmdline-tools.html#%28part._compile%29" data-pltdoc="x">Compilation and Configuration: <span class="stt">raco</span></a> for more information on generating
+bytecode files.</p><p>The bytecode compiler applies all standard optimizations, such as
+constant propagation, constant folding, inlining, and dead-code
+elimination. For example, in an environment where <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span> has its
+usual binding, the expression <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="stt"> </span><span class="RktVal">1</span><span class="RktPn">]</span><span class="stt"> </span><span class="RktPn">[</span><span class="RktSym">y</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span> is compiled the same as the constant <span class="RktVal">5</span>.</p><p>For the <a href="performance.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a> implementation of Racket, the main bytecode format
+is non-portable machine code. For the <a href="performance.html#%28tech._bc%29" class="techoutside" data-pltdoc="x"><span class="techinside">BC</span></a> implementation of
+Racket, bytecode is portable in the sense that it is
+machine-independent. Setting <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-compile-target-machine%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-compile-target-machine</a></span>
+to <span class="RktVal">#f</span> selects a separate machine-independent and
+variant-independent format on all Racket implementations, but running
+code in that format requires an additional internal conversion step to
+the implementation&rsquo;s main bytecode format.</p><p>Machine-independent bytecode for the <a href="performance.html#%28tech._bc%29" class="techoutside" data-pltdoc="x"><span class="techinside">BC</span></a> implementation is further
+compiled to native code via a <a name="(tech._just._in._time)"></a><span style="font-style: italic">just-in-time</span> or <a name="(tech._jit)"></a><span style="font-style: italic">JIT</span>
+compiler. The <a href="performance.html#%28tech._jit%29" class="techoutside" data-pltdoc="x"><span class="techinside">JIT</span></a> compiler substantially speeds programs that
+execute tight loops, arithmetic on small integers, and arithmetic on
+inexact real numbers. Currently, <a href="performance.html#%28tech._jit%29" class="techoutside" data-pltdoc="x"><span class="techinside">JIT</span></a> compilation is supported
+for x86, x86_64 (a.k.a. AMD64), 32-bit ARM, and 32-bit PowerPC processors.
+The <a href="performance.html#%28tech._jit%29" class="techoutside" data-pltdoc="x"><span class="techinside">JIT</span></a> compiler can be disabled via the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval-jit-enabled%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval-jit-enabled</a></span> parameter or the <span class="nobreak"><span class="stt">--no-jit</span></span>/<span class="nobreak"><span class="stt">-j</span></span>
+command-line flag for <span class="stt">racket</span>. Setting <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval-jit-enabled%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval-jit-enabled</a></span>
+to <span class="RktVal">#f</span> has no effect on the <a href="performance.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a> implementation of Racket.</p><p>The <a href="performance.html#%28tech._jit%29" class="techoutside" data-pltdoc="x"><span class="techinside">JIT</span></a> compiler works incrementally as functions are applied,
+but the <a href="performance.html#%28tech._jit%29" class="techoutside" data-pltdoc="x"><span class="techinside">JIT</span></a> compiler makes only limited use of run-time
+information when compiling procedures, since the code for a given
+module body or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> abstraction is compiled only once. The
+<a href="performance.html#%28tech._jit%29" class="techoutside" data-pltdoc="x"><span class="techinside">JIT</span></a>&rsquo;s granularity of compilation is a single procedure body,
+not counting the bodies of any lexically nested procedures. The
+overhead for <a href="performance.html#%28tech._jit%29" class="techoutside" data-pltdoc="x"><span class="techinside">JIT</span></a> compilation is normally so small that it is
+difficult to detect.</p><p>For information about viewing intermediate Racket code
+representations, especially for the <a href="performance.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a> implementation, see
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=compiler.html%23%2528part._compiler-inspect%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Inspecting Compiler Passes</a>.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;modules-performance&quot;">19.4<tt>&nbsp;</tt><a name="(part._modules-performance)"></a>Modules and Performance</h4><p>The module system aids optimization by helping to ensure that
+identifiers have the usual bindings. That is, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span> provided
+by <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a> can be recognized by the compiler and
+inlined. In contrast, in a traditional interactive Scheme system, the top-level
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span> binding might be redefined, so the compiler cannot assume a
+fixed <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span> binding (unless special flags or declarations
+are used to compensate for the lack of a module system).</p><p>Even in the top-level environment, importing with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>
+enables some inlining optimizations. Although a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span> definition
+at the top level might shadow an imported <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span>, the shadowing
+definition applies only to expressions evaluated later.</p><p>Within a module, inlining and constant-propagation optimizations take
+additional advantage of the fact that definitions within a module
+cannot be mutated when no <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span> is visible at compile
+time. Such optimizations are unavailable in the top-level
+environment. Although this optimization within modules is important
+for performance, it hinders some forms of interactive development and
+exploration. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._compile-enforce-module-constants%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">compile-enforce-module-constants</a></span> parameter
+disables the compiler&rsquo;s assumptions about module
+definitions when interactive exploration is more important. See
+<a href="module-set.html" data-pltdoc="x">Assignment and Redefinition</a> for more information.</p><p>The compiler may inline functions or propagate constants across module
+boundaries. To avoid generating too much code in the case of function
+inlining, the compiler is conservative when choosing candidates for
+cross-module inlining; see <a href="performance.html#%28part._func-call-performance%29" data-pltdoc="x">Function-Call Optimizations</a> for
+information on providing inlining hints to the compiler.</p><p>The later section <a href="performance.html#%28part._letrec-performance%29" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">letrec</span></span> Performance</a> provides some
+additional caveats concerning inlining of module bindings.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;func-call-performance&quot;">19.5<tt>&nbsp;</tt><a name="(part._func-call-performance)"></a>Function-Call Optimizations</h4><p>When the compiler detects a function call to an immediately visible
+function, it generates more efficient code than for a generic call,
+especially for tail calls. For example, given the program</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">odd</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">even</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sub1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">even</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#t</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">odd</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sub1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">odd</span><span class="hspace">&nbsp;</span><span class="RktVal">40000000</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>the compiler can detect the <span class="RktSym">odd</span>&ndash;<span class="RktSym">even</span> loop and
+produce code that runs much faster via loop unrolling and related
+optimizations.</p><p>Within a module form, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span>d variables are lexically scoped
+like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span> bindings, and definitions within a module
+therefore permit call optimizations, so</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">odd</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">even</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">)</span></td></tr></table></blockquote><p>within a module would perform the same as the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span> version.</p><p>For direct calls to functions with keyword arguments, the compiler can
+typically check keyword arguments statically and generate a direct
+call to a non-keyword variant of the function, which reduces the
+run-time overhead of keyword checking. This optimization applies only
+for keyword-accepting procedures that are bound with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span>.</p><p>For immediate calls to functions that are small enough, the compiler
+may inline the function call by replacing the call with the body of
+the function. In addition to the size of the target function&rsquo;s body,
+the compiler&rsquo;s heuristics take into account the amount of inlining
+already performed at the call site and whether the called function
+itself calls functions other than simple primitive operations. When a
+module is compiled, some functions defined at the module level are
+determined to be candidates for inlining into other modules; normally,
+only trivial functions are considered candidates for cross-module
+inlining, but a programmer can wrap a function definition with
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=performance-hint.html%23%2528form._%2528%2528lib._racket%252Fperformance-hint..rkt%2529._begin-encourage-inline%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin-encourage-inline</a></span> to encourage inlining
+of the function.</p><p>Primitive operations like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._pair%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">pair?</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span>, and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span> are inlined at the machine-code level by the bytecode or <a href="performance.html#%28tech._jit%29" class="techoutside" data-pltdoc="x"><span class="techinside">JIT</span></a>
+compiler. See also the later section <a href="performance.html#%28part._fixnums%2Bflonums%29" data-pltdoc="x">Fixnum and Flonum Optimizations</a> for
+information about inlined arithmetic operations.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Mutation_and_Performance&quot;">19.6<tt>&nbsp;</tt><a name="(part._.Mutation_and_.Performance)"></a>Mutation and Performance</h4><p>Using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span> to mutate a variable can lead to bad
+performance. For example, the microbenchmark</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">subtract-one</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sub1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._time%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">time</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">4000000</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">done</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">subtract-one</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>runs much more slowly than the equivalent</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">subtract-one</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sub1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._time%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">time</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">4000000</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">done</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">subtract-one</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>In the first variant, a new location is allocated for <span class="RktSym">x</span> on
+every iteration, leading to poor performance. A more clever compiler
+could unravel the use of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span> in the first example, but since
+mutation is discouraged (see <a href="set_.html#%28part._using-set%21%29" data-pltdoc="x">Guidelines for Using Assignment</a>), the compiler&rsquo;s
+effort is spent elsewhere.</p><p>More significantly, mutation can obscure bindings where inlining and
+constant-propagation might otherwise apply. For example, in</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">minus1</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">minus1</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sub1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sub1</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">4000000</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">done</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">minus1</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span> obscures the fact that <span class="RktSym">minus1</span> is just
+another name for the built-in <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sub1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sub1</a></span>.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;letrec-performance&quot;">19.7<tt>&nbsp;</tt><a name="(part._letrec-performance)"></a><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span> Performance</h4><p>When <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span> is used to bind only procedures and literals,
+then the compiler can treat the bindings in an optimal manner,
+compiling uses of the bindings efficiently. When other kinds of
+bindings are mixed with procedures, the compiler may be less able to
+determine the control flow.</p><p>For example,</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">done</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">next</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">junk</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">next</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sub1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktVal">40000000</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>likely compiles to less efficient code than</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">done</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">next</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">next</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sub1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktVal">40000000</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>In the first case, the compiler likely does not know that
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span> does not call <span class="RktSym">loop</span>. If it did, then
+<span class="RktSym">loop</span> might refer to <span class="RktSym">next</span> before the binding is
+available.</p><p>This caveat about <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span> also applies to definitions of
+functions and constants as internal definitions or in modules. A
+definition sequence in a module body is analogous to a sequence of
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._letrec%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">letrec</a></span> bindings, and non-constant expressions in a module
+body can interfere with the optimization of references to later
+bindings.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;fixnums+flonums&quot;">19.8<tt>&nbsp;</tt><a name="(part._fixnums+flonums)"></a>Fixnum and Flonum Optimizations</h4><p>A <a name="(tech._fixnum)"></a><span style="font-style: italic">fixnum</span> is a small exact integer. In this case, &ldquo;small&rdquo;
+depends on the platform. For a 32-bit machine, numbers that can be
+expressed in 29-30 bits plus a sign bit are represented as fixnums. On
+a 64-bit machine, 60-62 bits plus a sign bit are available.</p><p>A <a name="(tech._flonum)"></a><span style="font-style: italic">flonum</span> is used to represent any inexact real number. They
+correspond to 64-bit IEEE floating-point numbers on all platforms.</p><p>Inlined fixnum and flonum arithmetic operations are among the most
+important advantages of the compiler. For example, when
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span> is applied to two arguments, the generated machine code
+tests whether the two arguments are fixnums, and if so, it uses the
+machine&rsquo;s instruction to add the numbers (and check for overflow). If
+the two numbers are not fixnums, then it checks whether
+both are flonums; in that case, the machine&rsquo;s floating-point
+operations are used directly. For functions that take any number of
+arguments, such as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span>, inlining works for two or more
+arguments (except for <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span>, whose one-argument case is also
+inlined) when the arguments are either all fixnums or all flonums.</p><p>Flonums are typically <span style="font-style: italic">boxed</span>, which means that memory is
+allocated to hold every result of a flonum computation. Fortunately,
+the generational garbage collector (described later in
+<a href="performance.html#%28part._gc-perf%29" data-pltdoc="x">Memory Management</a>) makes allocation for short-lived results
+reasonably cheap. Fixnums, in contrast are never boxed, so they are
+typically cheap to use.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>See <a href="parallelism.html#%28part._effective-futures%29" data-pltdoc="x">Parallelism with Futures</a> for an example use of
+<a href="performance.html#%28tech._flonum%29" class="techoutside" data-pltdoc="x"><span class="techinside">flonum</span></a>-specific operations.</p></blockquote></blockquote></blockquote><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/flonum</span></a> library provides flonum-specific
+operations, and combinations of flonum operations allow the compiler
+to generate code that avoids boxing and unboxing intermediate
+results. Besides results within immediate combinations,
+flonum-specific results that are bound with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> and consumed
+by a later flonum-specific operation are unboxed within temporary
+storage. <span class="refelem"><span class="refcolumn"><span class="refcontent">Unboxing applies most reliably to uses of a
+flonum-specific operation with two arguments.</span></span></span>
+Finally, the compiler can detect some flonum-valued loop
+accumulators and avoid boxing of the accumulator.
+<span class="refelem"><span class="refcolumn"><span class="refcontent">Unboxing of local bindings and accumulators is not
+supported by the <a href="performance.html#%28tech._bc%29" class="techoutside" data-pltdoc="x"><span class="techinside">BC</span></a> implementation&rsquo;s JIT for PowerPC.</span></span></span></p><p>For some loop patterns, the compiler may need hints to enable
+unboxing. For example:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">flvector-sum</span><span class="hspace">&nbsp;</span><span class="RktSym">vec</span><span class="hspace">&nbsp;</span><span class="RktSym">init</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">sum</span><span class="hspace">&nbsp;</span><span class="RktSym">init</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fx=</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._flvector-length%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">flvector-length</a></span><span class="hspace">&nbsp;</span><span class="RktSym">vec</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">sum</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fx+</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._fl%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">fl+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">sum</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._flvector-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">flvector-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">vec</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The compiler may not be able to unbox <span class="RktSym">sum</span> in this example for
+two reasons: it cannot determine locally that its initial value from
+<span class="RktSym">init</span> will be a flonum, and it cannot tell locally that the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span> identity of the result <span class="RktSym">sum</span> is irrelevant.
+Changing the reference <span class="RktSym">init</span> to <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._fl%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">fl+</a></span><span class="stt"> </span><span class="RktSym">init</span><span class="RktPn">)</span> and
+changing the result <span class="RktSym">sum</span> to <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=flonums.html%23%2528def._%2528%2528lib._racket%252Fflonum..rkt%2529._fl%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">fl+</a></span><span class="stt"> </span><span class="RktSym">sum</span><span class="RktPn">)</span> gives the
+compiler hints and license to unbox <span class="RktSym">sum</span>.</p><p>The bytecode decompiler (see <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=raco&amp;rel=decompile.html&amp;version=8.6" class="Sq" data-pltdoc="x"><span class="stt">raco decompile</span>: Decompiling Bytecode</a>) for the <a href="performance.html#%28tech._bc%29" class="techoutside" data-pltdoc="x"><span class="techinside">BC</span></a> implementation
+annotates combinations where the JIT can avoid boxes with
+<span class="RktSym">#%flonum</span>, <span class="RktSym">#%as-flonum</span>, and
+<span class="RktSym">#%from-flonum</span>. For the <a href="performance.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a> variant, the
+&ldquo;bytecode&rdquo; decompiler shows machine code, but install the
+<span class="stt">"disassemble"</span> package to potentially see the machine code as
+machine-specific assembly code. See also <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=compiler.html%23%2528part._compiler-inspect%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Inspecting Compiler Passes</a>.</p><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=unsafe.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/unsafe/ops</span></a> library provides unchecked
+fixnum- and flonum-specific operations. Unchecked flonum-specific
+operations allow unboxing, and sometimes they allow the compiler to
+reorder expressions to improve performance. See also
+<a href="performance.html#%28part._unchecked-unsafe%29" data-pltdoc="x">Unchecked, Unsafe Operations</a>, especially the warnings about unsafety.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;unchecked-unsafe&quot;">19.9<tt>&nbsp;</tt><a name="(part._unchecked-unsafe)"></a>Unchecked, Unsafe Operations</h4><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=unsafe.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/unsafe/ops</span></a> library provides functions that
+are like other functions in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a>, but they
+assume (instead of checking) that provided arguments are of the right
+type. For example, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=unsafe.html%23%2528def._%2528%2528lib._racket%252Funsafe%252Fops..rkt%2529._unsafe-vector-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">unsafe-vector-ref</a></span> accesses an element from
+a vector without checking that its first argument is actually a vector
+and without checking that the given index is in bounds. For tight
+loops that use these functions, avoiding checks can sometimes speed
+the computation, though the benefits vary for different unchecked
+functions and different contexts.</p><p>Beware that, as &ldquo;unsafe&rdquo; in the library and function names suggest,
+misusing the exports of <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=unsafe.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/unsafe/ops</span></a> can lead to
+crashes or memory corruption.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;ffi-pointer-access&quot;">19.10<tt>&nbsp;</tt><a name="(part._ffi-pointer-access)"></a>Foreign Pointers</h4><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">ffi/unsafe</span></a> library provides functions for unsafely
+reading and writing arbitrary pointer values. The compiler recognizes uses
+of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=foreign_pointer-funcs.html%23%2528def._%2528%2528quote._%7E23%7E25foreign%2529._ptr-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">ptr-ref</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=foreign_pointer-funcs.html%23%2528def._%2528%2528quote._%7E23%7E25foreign%2529._ptr-set%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">ptr-set!</a></span> where the second argument is
+a direct reference to one of the following built-in C types:
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=Numeric_Types.html%23%2528def._%2528%2528quote._%7E23%7E25foreign%2529.__int8%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">_int8</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=Numeric_Types.html%23%2528def._%2528%2528quote._%7E23%7E25foreign%2529.__int16%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">_int16</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=Numeric_Types.html%23%2528def._%2528%2528quote._%7E23%7E25foreign%2529.__int32%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">_int32</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=Numeric_Types.html%23%2528def._%2528%2528quote._%7E23%7E25foreign%2529.__int64%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">_int64</a></span>,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=Numeric_Types.html%23%2528def._%2528%2528quote._%7E23%7E25foreign%2529.__double%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">_double</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=Numeric_Types.html%23%2528def._%2528%2528quote._%7E23%7E25foreign%2529.__float%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">_float</a></span>, and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=Pointer_Types.html%23%2528def._%2528%2528quote._%7E23%7E25foreign%2529.__pointer%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">_pointer</a></span>. Then, if the
+first argument to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=foreign_pointer-funcs.html%23%2528def._%2528%2528quote._%7E23%7E25foreign%2529._ptr-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">ptr-ref</a></span> or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=foreign_pointer-funcs.html%23%2528def._%2528%2528quote._%7E23%7E25foreign%2529._ptr-set%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">ptr-set!</a></span> is a C pointer
+(not a byte string), then the pointer read or write is performed
+inline in the generated code.</p><p>The bytecode compiler will optimize references to integer
+abbreviations like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=Numeric_Types.html%23%2528def._%2528%2528lib._ffi%252Funsafe..rkt%2529.__int%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">_int</a></span> to C types like
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=Numeric_Types.html%23%2528def._%2528%2528quote._%7E23%7E25foreign%2529.__int32%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">_int32</a></span>&#8212;<wbr></wbr>where the representation sizes are constant across
+platforms&#8212;<wbr></wbr>so the compiler can specialize access with those C types. C
+types such as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=Numeric_Types.html%23%2528def._%2528%2528lib._ffi%252Funsafe..rkt%2529.__long%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">_long</a></span> or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=Numeric_Types.html%23%2528def._%2528%2528lib._ffi%252Funsafe..rkt%2529.__intptr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">_intptr</a></span> are not constant
+across platforms, so their uses are not as consistently specialized.</p><p>Pointer reads and writes using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=Numeric_Types.html%23%2528def._%2528%2528quote._%7E23%7E25foreign%2529.__float%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">_float</a></span> or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=Numeric_Types.html%23%2528def._%2528%2528quote._%7E23%7E25foreign%2529.__double%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">_double</a></span> are
+not currently subject to unboxing optimizations.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;regexp-perf&quot;">19.11<tt>&nbsp;</tt><a name="(part._regexp-perf)"></a>Regular Expression Performance</h4><p>When a string or byte string is provided to a function like
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span>, then the string is internally compiled into
+a <a href="regexp.html#%28tech._regexp%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp</span></a> value. Instead of supplying a string or byte string
+multiple times as a pattern for matching, compile the pattern once to
+a <a href="regexp.html#%28tech._regexp%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp</span></a> value using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._byte-regexp%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">byte-regexp</a></span>,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._pregexp%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">pregexp</a></span>, or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._byte-pregexp%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">byte-pregexp</a></span>. In place of a constant
+string or byte string, write a constant <a href="regexp.html#%28tech._regexp%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp</span></a> using an
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#rx</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#px</span><span class="hspace"></span></span> prefix.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">slow-matcher</span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"[0-9]+"</span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fast-matcher</span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"[0-9]+"</span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-slow-matcher</span><span class="hspace">&nbsp;</span><span class="RktSym">pattern-str</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">str</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pattern-str</span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-fast-matcher</span><span class="hspace">&nbsp;</span><span class="RktSym">pattern-str</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pattern-rx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pattern-str</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">str</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pattern-rx</span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;gc-perf&quot;">19.12<tt>&nbsp;</tt><a name="(part._gc-perf)"></a>Memory Management</h4><p>The <a href="performance.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a> (default) and <a href="performance.html#%28tech._bc%29" class="techoutside" data-pltdoc="x"><span class="techinside">BC</span></a> Racket
+<a href="performance.html#%28part._virtual-machines%29" data-pltdoc="x">virtual machines</a> each use a modern,
+<a name="(tech._generational._garbage._collector)"></a><span style="font-style: italic">generational garbage collector</span> that makes allocation
+relatively cheap for short-lived objects. The <a href="performance.html#%28tech._cgc%29" class="techoutside" data-pltdoc="x"><span class="techinside">CGC</span></a> variant of <a href="performance.html#%28tech._bc%29" class="techoutside" data-pltdoc="x"><span class="techinside">BC</span></a> uses
+a <a name="(tech._conservative._garbage._collector)"></a><span style="font-style: italic">conservative garbage collector</span> which facilitates
+interaction with C code at the expense of both precision and speed for
+Racket memory management.</p><p>Although memory allocation is reasonably cheap, avoiding allocation
+altogether is often faster. One particular place where allocation
+can be avoided sometimes is in <a name="(tech._closure)"></a><span style="font-style: italic">closures</span>, which are the
+run-time representation of functions that contain free variables.
+For example,</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">40000000</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">prev-thunk</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">prev-thunk</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sub1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>allocates a closure on every iteration, since <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktPn">)</span><span class="stt"> </span><span class="RktSym">n</span><span class="RktPn">)</span>
+effectively saves <span class="RktSym">n</span>.</p><p>The compiler can eliminate many closures automatically. For example,
+in</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">40000000</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">prev-val</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">prev-thunk</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">prev-val</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sub1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">prev-thunk</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>no closure is ever allocated for <span class="RktSym">prev-thunk</span>, because its only
+application is visible, and so it is inlined. Similarly, in</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n-loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">400000</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">done</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m-loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktVal">100</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n-loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sub1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m-loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sub1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sub1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>then the expansion of the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> form to implement
+<span class="RktSym">m-loop</span> involves a closure over <span class="RktSym">n</span>, but the compiler
+automatically converts the closure to pass itself <span class="RktSym">n</span> as an
+argument instead.</p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Reachability and Garbage Collection&quot;">19.13<tt>&nbsp;</tt><a name="(part._.Reachability._and._.Garbage._.Collection)"></a>Reachability and Garbage Collection</h4><p>In general, Racket re-uses the storage for a value when the garbage
+collector can prove that the object is unreachable from any other
+(reachable) value. Reachability is a low-level, abstraction-breaking
+concept, and thus it requires detailed knowledge of the runtime system
+to predict exactly when values are reachable from each other. But
+generally one value is reachable from a second one when there is some
+operation to recover the original value from the second one.</p><p>To help programmers understand when an object is no longer reachable and its
+storage can be reused,
+Racket provides <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=weakbox.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-weak-box%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-weak-box</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=weakbox.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._weak-box-value%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">weak-box-value</a></span>,
+the creator and accessor for a one-record struct that the garbage
+collector treats specially. An object inside a weak box does not count
+as reachable, and so <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=weakbox.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._weak-box-value%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">weak-box-value</a></span> might return the object
+inside the box, but it might also return <span class="RktVal">#f</span> to indicate
+that the object was otherwise unreachable and garbage collected.
+Note that unless a garbage collection actually occurs, the value will
+remain inside the weak box, even if it is unreachable.</p><p><div class="SIntrapara">For example, consider this program:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">weight</span><span class="hspace">&nbsp;</span><span class="RktSym">color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">blue</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=weakbox.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-weak-box%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-weak-box</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"b has ~s\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=weakbox.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._weak-box-value%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">weak-box-value</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=garbagecollection.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._collect-garbage%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">collect-garbage</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"b has ~s\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=weakbox.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._weak-box-value%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">weak-box-value</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">It will print <span class="RktInBG"><span class="hspace"></span><span class="RktIn">b has #(struct:fish 7 blue)</span><span class="hspace"></span></span> twice because the
+definition of <span class="RktSym">f</span> still holds onto the fish. If the program
+were this, however:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">weight</span><span class="hspace">&nbsp;</span><span class="RktSym">color</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">blue</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=weakbox.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-weak-box%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-weak-box</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"b has ~s\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=weakbox.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._weak-box-value%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">weak-box-value</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=garbagecollection.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._collect-garbage%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">collect-garbage</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"b has ~s\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=weakbox.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._weak-box-value%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">weak-box-value</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">the second printout will be <span class="RktInBG"><span class="hspace"></span><span class="RktIn">b has #f</span><span class="hspace"></span></span> because
+no reference to the fish exists (other than the one in the box).</div></p><p><div class="SIntrapara">As a first approximation, all values in Racket must be allocated and will
+demonstrate behavior similar to the fish above.
+There are a number of exceptions, however:
+</div><div class="SIntrapara"><ul><li><p>Small integers (recognizable with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._fixnum%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">fixnum?</a></span>) are
+always available without explicit
+allocation. From the perspective of the garbage collector
+and weak boxes, their storage is never reclaimed. (Due to
+clever representation techniques, however, their storage
+does not count towards the space that Racket uses.
+That is, they are effectively free.)</p></li><li><p>Procedures where
+the compiler can see all of their call sites may never be
+allocated at all (as discussed above).
+Similar optimizations may also eliminate
+the allocation for other kinds of values.</p></li><li><p>Interned symbols are allocated only once (per place). A table inside
+Racket tracks this allocation so a symbol may not become garbage
+because that table holds onto it.</p></li><li><p>Reachability is only approximate with the <a href="performance.html#%28tech._cgc%29" class="techoutside" data-pltdoc="x"><span class="techinside">CGC</span></a> collector (i.e.,
+a value may appear reachable to that collector when there is,
+in fact, no way to reach it anymore).</p></li></ul></div></p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Weak_Boxes_and_Testing&quot;">19.14<tt>&nbsp;</tt><a name="(part._.Weak_.Boxes_and_.Testing)"></a>Weak Boxes and Testing</h4><p>One important use of weak boxes is in testing that some abstraction properly
+releases storage for data it no longer needs, but there is a gotcha that
+can easily cause such test cases to pass improperly.</p><p>Imagine you&rsquo;re designing a data structure that needs to
+hold onto some value temporarily but then should clear a field or
+somehow break a link to avoid referencing that value so it can be
+collected. Weak boxes are a good way to test that your data structure
+properly clears the value. That is, you might write a test case
+that builds a value, extracts some other value from it
+(that you hope becomes unreachable), puts the extracted value into a weak-box,
+and then checks to see if the value disappears from the box.</p><p><div class="SIntrapara">This code is one attempt to follow that pattern, but it has a subtle bug:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">fishes</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">red</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">blue</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">wb</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=weakbox.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-weak-box%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-weak-box</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fishes</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=garbagecollection.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._collect-garbage%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">collect-garbage</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"still there? ~s\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=weakbox.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._weak-box-value%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">weak-box-value</a></span><span class="hspace">&nbsp;</span><span class="RktSym">wb</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Specifically, it will show that the weak box is empty, but not
+because <span class="RktVar">fishes</span> no longer holds onto the value, but
+because <span class="RktVar">fishes</span> itself is not reachable anymore!</div></p><p><div class="SIntrapara">Change the program to this one:
+</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">fishes</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">red</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fish</span><span class="hspace">&nbsp;</span><span class="RktVal">7</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">blue</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">wb</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=weakbox.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-weak-box%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-weak-box</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list-ref</a></span><span class="hspace">&nbsp;</span><span class="RktSym">fishes</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=garbagecollection.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._collect-garbage%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">collect-garbage</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"still there? ~s\n"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=weakbox.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._weak-box-value%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">weak-box-value</a></span><span class="hspace">&nbsp;</span><span class="RktSym">wb</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"fishes is ~s\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">fishes</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">and now we see the expected result. The difference is that last
+occurrence of the variable <span class="RktVar">fishes</span>. That constitutes
+a reference to the list, ensuring that the list is not itself
+garbage collected, and thus the red fish is not either.</div></p><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Reducing_Garbage_Collection_Pauses&quot;">19.15<tt>&nbsp;</tt><a name="(part._.Reducing_.Garbage_.Collection_.Pauses)"></a>Reducing Garbage Collection Pauses</h4><p>By default, Racket&rsquo;s <a href="performance.html#%28tech._generational._garbage._collector%29" class="techoutside" data-pltdoc="x"><span class="techinside">generational garbage collector</span></a> creates
+brief pauses for frequent <a name="(tech._minor._collection)"></a><span style="font-style: italic">minor collections</span>, which inspect
+only the most recently allocated objects, and long pauses for infrequent
+<a name="(tech._major._collection)"></a><span style="font-style: italic">major collections</span>, which re-inspect all memory.</p><p>For some applications, such as animations and games,
+long pauses due to a major collection can interfere
+unacceptably with a program&rsquo;s operation. To reduce major-collection
+pauses, the <a href="performance.html#%28tech._3m%29" class="techoutside" data-pltdoc="x"><span class="techinside">3m</span></a> garbage collector supports <a name="(tech._incremental._garbage._collection)"></a><span style="font-style: italic">incremental
+garbage-collection</span> mode, and the <a href="performance.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a> garbage collector supports
+a useful approximation:</p><ul><li><p>In <a href="performance.html#%28tech._3m%29" class="techoutside" data-pltdoc="x"><span class="techinside">3m</span></a>&rsquo;s incremental mode, minor collections create longer
+(but still relatively short) pauses by performing extra work
+toward the next major collection. If all goes well, most of a
+major collection&rsquo;s work has been performed by minor collections
+the time that a major collection is needed, so the major
+collection&rsquo;s pause is as short as a minor collection&rsquo;s pause.
+Incremental mode tends to run more slowly overall, but it can
+provide much more consistent real-time behavior.</p></li><li><p>In <a href="performance.html#%28tech._c%29" class="techoutside" data-pltdoc="x"><span class="techinside">CS</span></a>&rsquo;s incremental mode, objects are never promoted out
+of the category of &ldquo;recently allocated,&rdquo; although there are
+degrees of &ldquo;recently&rdquo; so that most minor collections can still
+skip recent-but-not-too-recent objects. In the common case that
+most of the memory use for animation or game is allocated on
+startup (including its code and the code of the Racket runtime
+system), a major collection may never become necessary.</p></li></ul><p>If the <span class="stt">PLT_INCREMENTAL_GC</span> environment variable is set to a
+value that starts with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">0</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">n</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">N</span><span class="hspace"></span></span> when
+Racket starts, incremental mode is permanently disabled. For
+<a href="performance.html#%28tech._3m%29" class="techoutside" data-pltdoc="x"><span class="techinside">3m</span></a>, if the <span class="stt">PLT_INCREMENTAL_GC</span> environment variable is
+set to a value that starts with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">1</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">y</span><span class="hspace"></span></span>, or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">Y</span><span class="hspace"></span></span> when Racket starts, incremental mode is permanently
+enabled. Since incremental mode is only useful for certain parts of
+some programs, however, and since the need for incremental mode is a
+property of a program rather than its environment, the preferred way
+to enable incremental mode is with <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=garbagecollection.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._collect-garbage%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">collect-garbage</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">incremental</span><span class="RktPn">)</span>.</p><p>Calling <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=garbagecollection.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._collect-garbage%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">collect-garbage</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">incremental</span><span class="RktPn">)</span> does not perform an
+immediate garbage collection, but instead requests that each minor
+collection perform incremental work up to the next major collection
+(unless incremental model is permanently disabled). The request
+expires with the next major collection. Make a call to
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=garbagecollection.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._collect-garbage%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">collect-garbage</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">incremental</span><span class="RktPn">)</span> in any repeating task within
+an application that needs to be responsive in real time. Force a full
+collection with <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=garbagecollection.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._collect-garbage%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">collect-garbage</a></span><span class="RktPn">)</span> just before an initial
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=garbagecollection.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._collect-garbage%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">collect-garbage</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">incremental</span><span class="RktPn">)</span> to initiate incremental mode
+from an optimal state.</p><p>To check whether incremental mode is in use and how it affects pause
+times, enable <span class="stt">debug</span>-level logging output for the
+<span class="RktSym">GC</span> topic. For example,</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">racket -W "debug@GC error" main.rkt</span></p><p>runs <span class="stt">"main.rkt"</span> with garbage-collection logging to stderr
+(while preserving <span class="stt">error</span>-level logging for all topics). Minor
+collections are reported by <span class="RktInBG"><span class="hspace"></span><span class="RktIn">min</span><span class="hspace"></span></span> lines, increment-mode minor
+collections on <a href="performance.html#%28tech._3m%29" class="techoutside" data-pltdoc="x"><span class="techinside">3m</span></a> are reported with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">mIn</span><span class="hspace"></span></span> lines, and major
+collections are reported with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">MAJ</span><span class="hspace"></span></span> lines.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="concurrency.html" title="backward to &quot;18 Concurrency and Synchronization&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="parallelism.html" title="forward to &quot;20 Parallelism&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/phases.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/phases.html
new file mode 100644
index 00000000..6418042a
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/phases.html
@@ -0,0 +1,133 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>16.2.6&nbsp;General Phase Levels</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.1&nbsp;</td><td><a href="pattern-macros.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Macros</a></td></tr><tr><td align="right">16.2&nbsp;</td><td><a href="proc-macros.html" class="tocviewselflink" data-pltdoc="x">General Macro Transformers</a></td></tr><tr><td align="right">16.3&nbsp;</td><td><a href="macro-module.html" class="tocviewlink" data-pltdoc="x">Module Instantiations and Visits</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>16.2&nbsp;</td><td><a href="proc-macros.html" class="tocviewlink" data-pltdoc="x">General Macro Transformers</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.2.1&nbsp;</td><td><a href="stx-obj.html" class="tocviewlink" data-pltdoc="x">Syntax Objects</a></td></tr><tr><td align="right">16.2.2&nbsp;</td><td><a href="macro-transformers.html" class="tocviewlink" data-pltdoc="x">Macro Transformer Procedures</a></td></tr><tr><td align="right">16.2.3&nbsp;</td><td><a href="syntax-case.html" class="tocviewlink" data-pltdoc="x">Mixing Patterns and Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">syntax-<wbr></wbr>case</span></span></a></td></tr><tr><td align="right">16.2.4&nbsp;</td><td><a href="with-syntax.html" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>syntax</span></span> and <span class="RktSym"><span class="RktValLink">generate-<wbr></wbr>temporaries</span></span></a></td></tr><tr><td align="right">16.2.5&nbsp;</td><td><a href="stx-phases.html" class="tocviewlink" data-pltdoc="x">Compile and Run-<wbr></wbr>Time Phases</a></td></tr><tr><td align="right">16.2.6&nbsp;</td><td><a href="phases.html" class="tocviewselflink" data-pltdoc="x">General Phase Levels</a></td></tr><tr><td align="right">16.2.7&nbsp;</td><td><a href="stx-certs.html" class="tocviewlink" data-pltdoc="x">Tainted Syntax</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_3&quot;);">&#9658;</a></td><td>16.2.6&nbsp;</td><td><a href="phases.html" class="tocviewselflink" data-pltdoc="x">General Phase Levels</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_3"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.2.6.1&nbsp;</td><td><a href="phases.html#%28part._.Phases_and_.Bindings%29" class="tocviewlink" data-pltdoc="x">Phases and Bindings</a></td></tr><tr><td align="right">16.2.6.2&nbsp;</td><td><a href="phases.html#%28part._.Phases_and_.Modules%29" class="tocviewlink" data-pltdoc="x">Phases and Modules</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">16.2.6.1<tt>&nbsp;</tt></span><a href="phases.html#%28part._.Phases_and_.Bindings%29" class="tocsubseclink" data-pltdoc="x">Phases and Bindings</a></td></tr><tr><td><span class="tocsublinknumber">16.2.6.2<tt>&nbsp;</tt></span><a href="phases.html#%28part._.Phases_and_.Modules%29" class="tocsubseclink" data-pltdoc="x">Phases and Modules</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="versionbox"><span class="version">8.6</span></div><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stx-phases.html" title="backward to &quot;16.2.5 Compile and Run-Time Phases&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="proc-macros.html" title="up to &quot;16.2 General Macro Transformers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stx-certs.html" title="forward to &quot;16.2.7 Tainted Syntax&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;phases&quot;">16.2.6<tt>&nbsp;</tt><a name="(part._phases)"></a>General Phase Levels</h5><p>A <a name="(tech._phase)"></a><span style="font-style: italic">phase</span> can be thought of as a way to separate computations in
+a pipeline of processes where one produces code that is used by the
+next.  (E.g., a pipeline that consists of a preprocessor process, a
+compiler, and an assembler.)</p><p>Imagine starting two Racket processes for this purpose.  If you ignore
+inter-process communication channels like sockets and files, the
+processes will have no way to share anything other than the text that is
+piped from the standard output of one process into the standard input of
+the other.  Similarly, Racket effectively allows multiple invocations of
+a module to exist in the same process but separated by phase.  Racket
+enforces <span class="emph">separation</span> of such phases, where different phases cannot
+communicate in any way other than via the protocol of macro expansion,
+where the output of one phase is the code used in the next.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Phases_and_Bindings&quot;">16.2.6.1<tt>&nbsp;</tt><a name="(part._.Phases_and_.Bindings)"></a>Phases and Bindings</h5><p>Every binding of an identifier exists in a particular phase.  The link
+between a binding and its phase is represented by an integer
+<a name="(tech._phase._level)"></a><span style="font-style: italic">phase level</span>.  Phase level 0 is the phase used for &ldquo;plain&rdquo;
+(or &ldquo;runtime&rdquo;) definitions, so</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">age</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></p></blockquote><p>adds a binding for <span class="RktSym">age</span> into phase level 0.  The identifier
+<span class="RktSym">age</span> can be defined at a higher phase level using
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin-for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin-for-syntax</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin-for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin-for-syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">age</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>With a single <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin-for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin-for-syntax</a></span> wrapper, <span class="RktSym">age</span> is
+defined at phase level 1.  We can easily mix these two definitions in
+the same module or in a top-level namespace, and there is no clash
+between the two <span class="RktSym">age</span>s that are defined at different phase
+levels:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">age</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin-for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin-for-syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">age</span><span class="hspace">&nbsp;</span><span class="RktVal">9</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote><p>The <span class="RktSym">age</span> binding at phase level 0 has a value of 3, and the
+<span class="RktSym">age</span> binding at phase level 1 has a value of 9.</p><p>Syntax objects capture binding information as a first-class value.
+Thus,</p><blockquote class="SCodeFlow"><p><span class="RktRdr">#'</span><span class="RktSym">age</span></p></blockquote><p>is a syntax object that represents the <span class="RktSym">age</span> binding&#8212;<wbr></wbr>but
+since there are two <span class="RktSym">age</span>s (one at phase level 0 and one at
+phase level 1), which one does it capture?  In fact, Racket imbues
+<span class="RktRdr">#'</span><span class="RktSym">age</span> with lexical information for all phase levels, so the
+answer is that <span class="RktRdr">#'</span><span class="RktSym">age</span> captures both.</p><p>The relevant binding of <span class="RktSym">age</span> captured by <span class="RktRdr">#'</span><span class="RktSym">age</span> is
+determined when <span class="RktRdr">#'</span><span class="RktSym">age</span> is eventually used.  As an example, we
+bind <span class="RktRdr">#'</span><span class="RktSym">age</span> to a pattern variable so we can use it in a
+template, and then we <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span>uate the template: <span class="refelem"><span class="refcolumn"><span class="refcontent">We
+use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span> here to demonstrate phases, but see
+<a href="reflection.html" data-pltdoc="x">Reflection and Dynamic Evaluation</a> for caveats about <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span>.</span></span></span></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._with-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">age</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">age</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktSym">age</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">3</span></p></td></tr></table></blockquote><p>The result is <span class="RktVal">3</span> because <span class="RktSym">age</span> is used at phase 0 level.
+We can try again with the use of <span class="RktSym">age</span> inside
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin-for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin-for-syntax</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._with-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">age</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">age</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin-for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin-for-syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktSym">age</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">9</span></p></td></tr></table></blockquote><p>In this case, the answer is <span class="RktVal">9</span>, because we are using
+<span class="RktSym">age</span> at phase level 1 instead of 0 (i.e.,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin-for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin-for-syntax</a></span> evaluates its expressions at phase level 1).
+So, you can see that we started with the same syntax object,
+<span class="RktRdr">#'</span><span class="RktSym">age</span>, and we were able to use it in two different ways: at
+phase level 0 and at phase level 1.</p><p>A syntax object has a lexical context from the moment it first exists.
+A syntax object that is provided from a module retains its lexical
+context, and so it references bindings in the context of its source
+module, not the context of its use.  The following example defines
+<span class="RktSym">button</span> at phase level 0 and binds it to <span class="RktVal">0</span>, while
+<span class="RktSym">see-button</span> binds the syntax object for <span class="RktSym">button</span> in
+module <span class="RktSym">a</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">button</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">see-button</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Why not </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktSym">see-button</span><span class="stt"> </span><span class="RktRdr">#'</span><span class="RktSym">button</span><span class="RktPn">)</span><span class="RktCmt">? We explain later.</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">see-button</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">button</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">button</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">see-button</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">0</span></p></td></tr></table></blockquote><p>The result of the <span class="RktSym">m</span> macro is the value of <span class="RktSym">see-button</span>,
+which is <span class="RktRdr">#'</span><span class="RktSym">button</span> with the lexical context of the <span class="RktSym">a</span>
+module.  Even though there is another <span class="RktSym">button</span> in <span class="RktSym">b</span>, the
+second <span class="RktSym">button</span> will not confuse Racket, because the lexical
+context of <span class="RktRdr">#'</span><span class="RktSym">button</span> (the value bound to <span class="RktSym">see-button</span>) is
+<span class="RktSym">a</span>.</p><p>Note that <span class="RktSym">see-button</span> is bound at phase level 1 by virtue of
+defining it with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-for-syntax</a></span>.  Phase level 1 is needed
+because <span class="RktSym">m</span> is a macro, so its body executes at one phase higher
+than the context of its definition.  Since <span class="RktSym">m</span> is defined at
+phase level 0, its body is at phase level 1, so any bindings referenced
+by the body must be at phase level 1.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Phases_and_Modules&quot;">16.2.6.2<tt>&nbsp;</tt><a name="(part._.Phases_and_.Modules)"></a>Phases and Modules</h5><p>A <a href="phases.html#%28tech._phase._level%29" class="techoutside" data-pltdoc="x"><span class="techinside">phase level</span></a> is a module-relative concept.  When importing from
+another module via <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>, Racket lets us shift imported
+bindings to a phase level that is different from the original one:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a.rkt"</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">import with no phase shift</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a.rkt"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">shift phase by +1</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-template%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-template</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a.rkt"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">shift phase by -1</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-meta%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-meta</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">"a.rkt"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">shift phase by +5</span></td></tr></table></blockquote><p>That is, using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span> in <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> means that all of
+the bindings from that module will have their phase levels increased by
+one.  A binding that is <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span>d at phase level 0 and imported
+with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span> becomes a phase-level 1 binding:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">defined at phase level 0</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">d</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">c</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">has a binding at phase level 1, not 0:</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote><p>Let&rsquo;s see what happens if we try to create a binding for the
+<span class="RktRdr">#'</span><span class="RktSym">button</span> syntax object at phase level 0:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">button</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">see-button</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">button</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Now both <span class="RktSym">button</span> and <span class="RktSym">see-button</span> are defined at phase
+0.  The lexical context of <span class="RktRdr">#'</span><span class="RktSym">button</span> will know that there is a
+binding for <span class="RktSym">button</span> at phase 0.  In fact, it seems like things
+are working just fine if we try to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span> <span class="RktSym">see-button</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span><span class="hspace">&nbsp;</span><span class="RktSym">see-button</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr></table></blockquote><p>Now, let&rsquo;s use <span class="RktSym">see-button</span> in a macro:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">see-button</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">m</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">see-button: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr></table></blockquote><p>Clearly, <span class="RktSym">see-button</span> is not defined at phase level 1, so we
+cannot refer to it inside the macro body.  Let&rsquo;s try to use
+<span class="RktSym">see-button</span> in another module by putting the button definitions
+in a module and importing it at phase level 1.  Then, we will get
+<span class="RktSym">see-button</span> at phase level 1:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">button</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">see-button</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">button</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">see-button</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">gets </span><span class="RktSym">see-button</span><span class="RktCmt"> at phase level 1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">see-button</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">eval:1:0: button: unbound identifier;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">also, no #%top syntax transformer is bound</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: button</span></p></td></tr></table></blockquote><p>Racket says that <span class="RktSym">button</span> is unbound now!  When <span class="RktSym">a</span> is
+imported at phase level 1, we have the following bindings:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktSym">button</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>at phase level 1</td></tr><tr><td><span class="RktSym">see-button</span><span class="hspace">&nbsp;</span>at phase level 1</td></tr></table></blockquote><p>So the macro <span class="RktSym">m</span> can see a binding for <span class="RktSym">see-button</span> at
+phase level 1 and will return the <span class="RktRdr">#'</span><span class="RktSym">button</span> syntax object, which
+refers to <span class="RktSym">button</span> binding at phase level 1.  But the use of
+<span class="RktSym">m</span> is at phase level 0, and there is no <span class="RktSym">button</span> at phase
+level 0 in <span class="RktSym">b</span>.  That is why <span class="RktSym">see-button</span> needs to be
+bound at phase level 1, as in the original <span class="RktSym">a</span>.  In the original
+<span class="RktSym">b</span>, then, we have the following bindings:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktSym">button</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>at phase level 0</td></tr><tr><td><span class="RktSym">see-button</span><span class="hspace">&nbsp;</span>at phase level 1</td></tr></table></blockquote><p>In this scenario, we can use <span class="RktSym">see-button</span> in the macro, since
+<span class="RktSym">see-button</span> is bound at phase level 1.  When the macro expands,
+it will refer to a <span class="RktSym">button</span> binding at phase level 0.</p><p>Defining <span class="RktSym">see-button</span> with <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="RktSym">see-button</span><span class="stt"> </span><span class="RktRdr">#'</span><span class="RktSym">button</span><span class="RktPn">)</span> isn&rsquo;t inherently wrong; it depends on how we intend to use
+<span class="RktSym">see-button</span>.  For example, we can arrange for <span class="RktSym">m</span> to
+sensibly use <span class="RktSym">see-button</span> because it puts it in a phase level 1
+context using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin-for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin-for-syntax</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">button</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">see-button</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">button</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">see-button</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._with-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">see-button</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin-for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin-for-syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktOut">0</span></p></td></tr></table></blockquote><p>In this case, module <span class="RktSym">b</span> has both <span class="RktSym">button</span> and
+<span class="RktSym">see-button</span> bound at phase level 1.  The expansion of the macro
+is</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin-for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin-for-syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._displayln%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">displayln</a></span><span class="hspace">&nbsp;</span><span class="RktSym">button</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>which works, because <span class="RktSym">button</span> is bound at phase level 1.</p><p>Now, you might try to cheat the phase system by importing <span class="RktSym">a</span> at
+both phase level 0 and phase level 1.  Then you would have the following
+bindings</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktSym">button</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>at phase level 0</td></tr><tr><td><span class="RktSym">see-button</span><span class="hspace">&nbsp;</span>at phase level 0</td></tr><tr><td><span class="RktSym">button</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>at phase level 1</td></tr><tr><td><span class="RktSym">see-button</span><span class="hspace">&nbsp;</span>at phase level 1</td></tr></table></blockquote><p>You might expect now that <span class="RktSym">see-button</span> in a macro would work, but
+it doesn&rsquo;t:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">button</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">see-button</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">button</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">see-button</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">see-button</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">eval:1:0: button: unbound identifier;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">also, no #%top syntax transformer is bound</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: button</span></p></td></tr></table></blockquote><p>In the definition of module <span class="RktSym">a</span>, the variable
+<span class="RktSym">see-button</span> is at phase 0, and its value is the syntax object
+for <span class="RktSym">button</span>, which shows the only visible <span class="RktSym">button</span>
+binding is at the same phase. (That is the key detail.)
+As discussed, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span> import shifts the phase level of <span class="emph">both</span>
+up one, so the phase 1 binding of <span class="RktSym">see-button</span> used in module
+<span class="RktSym">b</span> is the binding from the module <span class="RktSym">a</span> that is shifted
+into phase 1, which refers to <span class="RktSym">button</span> in <span class="RktSym">a</span> at phase
+1.
+The fact that in module <span class="RktSym">b</span> there is also a phase 0 variable
+<span class="RktSym">button</span> from a different instantiation of module <span class="RktSym">a</span>
+does not matter, because there is no way to reach it
+from the (shifted) <span class="RktSym">see-button</span> from  <span class="RktSym">a</span>.</p><p>This kind of phase-level mismatch between instantiations can be repaired
+with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-shift-phase-level%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-shift-phase-level</a></span>. Recall that a syntax object like
+<span class="RktRdr">#'</span><span class="RktSym">button</span> captures lexical information at <span class="emph">all</span> phase levels.
+The problem here is that <span class="RktSym">see-button</span> is
+invoked at phase 1, but needs to return a syntax object that can be
+evaluated at phase 0. By default, <span class="RktSym">see-button</span> is bound to
+<span class="RktRdr">#'</span><span class="RktSym">button</span> at the same phase level. But with
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-shift-phase-level%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-shift-phase-level</a></span>, we can make <span class="RktSym">see-button</span>
+refer to <span class="RktRdr">#'</span><span class="RktSym">button</span> at a different relative phase level.
+In this case, we use a phase shift of <span class="RktVal"><span class="nobreak">-1</span></span> to make <span class="RktSym">see-button</span>
+at phase 1 refer to <span class="RktRdr">#'</span><span class="RktSym">button</span> at phase 0. (Because the phase shift
+happens at every level, it will also make <span class="RktSym">see-button</span> at phase 0
+refer to <span class="RktRdr">#'</span><span class="RktSym">button</span> at phase -1.)</p><p>Note that <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-shift-phase-level%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-shift-phase-level</a></span> merely creates a reference
+across phases. To make that reference work, we still need to instantiate our
+module at both phases so the reference and its target have their bindings
+available. Thus, in module <span class="RktVal">'</span><span class="RktVal">b</span>,
+we still import module <span class="RktVal">'</span><span class="RktVal">a</span> at both phase 0 and phase
+1&#8212;<wbr></wbr>using <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">a</span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span><span class="RktPn">)</span>&#8212;<wbr></wbr>so we have a phase-1
+binding for <span class="RktSym">see-button</span> and a phase-0 binding for <span class="RktSym">button</span>.
+Now macro <span class="RktSym">m</span> will work.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">button</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">see-button</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-shift-phase-level%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-shift-phase-level</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">button</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">see-button</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">see-button</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">0</span></p></td></tr></table></blockquote><p>By the way, what happens to the <span class="RktSym">see-button</span> that&rsquo;s bound at phase 0?
+Its <span class="RktRdr">#'</span><span class="RktSym">button</span> binding has likewise been shifted, but to phase -1. Since
+<span class="RktSym">button</span> itself isn&rsquo;t bound at phase -1, if we try to evaluate
+<span class="RktSym">see-button</span> at phase 0, we get an error. In other words, we haven&rsquo;t permanently
+cured our mismatch problem&#8212;<wbr></wbr>we&rsquo;ve just shifted it to a less bothersome location.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">button</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">see-button</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-shift-phase-level%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-shift-phase-level</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">button</span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">see-button</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">see-button</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b2</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eval%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eval</a></span><span class="hspace">&nbsp;</span><span class="RktSym">see-button</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">button: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr></table></blockquote><p>Mismatches like the one above can also arise when a macro tries to match
+literal bindings&#8212;<wbr></wbr>using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span> or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Parsing_Syntax.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._syntax-parse%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-parse</a></span>.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">syntax/parse</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-template%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-template</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._all-defined-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">all-defined-out</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">button</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">button</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">process</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Literal_Sets_and_Conventions.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._define-literal-set%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-literal-set</a></span><span class="hspace">&nbsp;</span><span class="RktSym">locals</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">button</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Parsing_Syntax.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._syntax-parse%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-parse</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-patterns.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._%7E7eliteral%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">~literal</a></span><span class="hspace">&nbsp;</span><span class="RktSym">button</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktRdr">#'</span><span class="RktVal">'</span><span class="RktVal">ok</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-meta%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-meta</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-meta%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-meta</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">x</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin-for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin-for-syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._with-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">out</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">process</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktErr">eval:2:0: process: expected the identifier `button'</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: button</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (process (0 button))</span></p></td></tr></table></blockquote><p>In this example, <span class="RktSym">make</span> is being used in <span class="RktSym">y</span> at phase
+level 2, and it returns the <span class="RktRdr">#'</span><span class="RktSym">button</span> syntax object&#8212;<wbr></wbr>which
+refers to <span class="RktSym">button</span> bound at phase level 0 inside <span class="RktSym">x</span> and
+at phase level 2 in <span class="RktSym">y</span> from <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-meta%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-meta</a></span><span class="stt"> </span><span class="RktVal">2</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">x</span><span class="RktPn">)</span>.  The
+<span class="RktSym">process</span> macro is imported at phase level 1 from
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-meta%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-meta</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">x</span><span class="RktPn">)</span>, and it knows that <span class="RktSym">button</span> should be
+bound at phase level 1.  When the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Parsing_Syntax.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._syntax-parse%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-parse</a></span> is executed
+inside <span class="RktSym">process</span>, it is looking for <span class="RktSym">button</span> bound at
+phase level 1 but it sees only a phase level 2 binding and doesn&rsquo;t
+match.</p><p>To fix the example, we can provide <span class="RktSym">make</span> at phase level 1
+relative to <span class="RktSym">x</span>, and then we import it at phase level 1 in
+<span class="RktSym">y</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">syntax/parse</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-template%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-template</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._all-defined-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">all-defined-out</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">button</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktSym">make</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">button</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">process</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Literal_Sets_and_Conventions.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._define-literal-set%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-literal-set</a></span><span class="hspace">&nbsp;</span><span class="RktSym">locals</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">button</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=Parsing_Syntax.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._syntax-parse%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-parse</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=stxparse-patterns.html%23%2528form._%2528%2528lib._syntax%252Fparse..rkt%2529._%7E7eliteral%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">~literal</a></span><span class="hspace">&nbsp;</span><span class="RktSym">button</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktRdr">#'</span><span class="RktVal">'</span><span class="RktVal">ok</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-meta%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-meta</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-meta%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-meta</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin-for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin-for-syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._with-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">out</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">process</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">m</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">y</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">'ok</span></p></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="stx-phases.html" title="backward to &quot;16.2.5 Compile and Run-Time Phases&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="proc-macros.html" title="up to &quot;16.2 General Macro Transformers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stx-certs.html" title="forward to &quot;16.2.7 Tainted Syntax&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/pict.png b/clones/download.racket-lang.org/releases/8.6/doc/guide/pict.png
new file mode 100644
index 0000000000000000000000000000000000000000..142e906bf45519b2d76bb1b07dac96eaa50d28a0
GIT binary patch
literal 23264
zcmeFZcUY6#_a~ZARRoMEC{+W9bRp70(?ci$0V&d(AT4xhfl!Y}i6S6KG1Q|Fn$m;-
zQlnBtLO6!rBPfv$MrtVYa?bbno4GUhd1mf??%dzZ^UObpFM0P~d+${~>$BF*<J%_s
zoTvCtfj}TmqyfSl1Y*tyftda{!3I1DAbhU`fi8iNh?|z^+~p}uOL1`P(Z+};S%Mby
z`R>(IV=vE~M=spJuiQqa88(l9`)gsuyEYM(_2kL2p_F8Lt-;v2v#(^&NxjVV^m>X@
zAbq7X=9)bFHGL{<efsQ{>}DA2ky^srZo^F}YlL~H?a<b$kJ|#c$70AdF=XgP3wYe|
zZ)LT%8sf)K2yfAbz&~jy_l@-9KMZ}Il{|i4p3!M>{M=GHvE=U;tawe2pPN^7WpMpD
z%=4aySdI@i07j}H_1q&+E)QlyVMd;}6CV>*9s(~|*<CS%Kd^g_(IEU569|0H``TpC
z%XoD1e>Iv+{_!kDcK@%%`JXm`Qe_ATSaC%z_5z3RK;x|vrLZe9EW)5l5($U@Xn>MU
z#o=M4orq^39AZJ{!Fk9CNM1Ux@L5irwfj5|{z0kIN;REal>-l5tl^%HJsM8w%U0Sg
zNYQrMuZ<<WP<T@_pPe{tAA7(qVVb)$mE+&EK*#Og`f}S`0E_h|esSx1s^+^l?o&Hp
z<fQ2FfKw$`Ic9(7F}_xlPJ$&K-XC$~sBGRE->@h#Zbl80aBICJh9Qme!>fB!KdEw7
zS_GxJvhyASnL5-v6tA}SkdqNYRER>AM*|C!Vzk1RM=Pdx^S7TyEXXxqa~m+W4enEV
ze3e0KMQ^xz^yT)f`8URk#2hgqdizwgYXZN1u<py(WX!*MU&PA`u?O+_)_l)Q$%~oC
zP52(R(2QmC%H-*^zPa?OSWQ!{g`(Ye_j>Y8wRXP^;bCPlD~*SxU)(n=<pGIm>d@qD
zm8y_*GeUP|^L<7|!`r~Gzr_tG(lvpPDj_;*ON?{E=&2&RpB58DLeIH%C(8<zIrHU*
z3+u;FnN8(ws$FQF`4RK6MzmBrW5gSFha>WK3vHao1inC|M6k`p#_SqRW7gku<j3qS
z$QDE{mSK!&X078v2WEx6vt>@>8xIQY6KTK7hPqZIEsDSG@6wrfygXvce5EpYA#Nom
zd6C@;-6BW1;X;vK(z)A8SC1zbf$y)|)_V3&6F>Unzw34^^p8c+8^31Sa}_0Z{ZReN
z;Y{`9bJ}6pAFU_wWsqM*66W>_^{gk}JTtJXv1p^`U4VI<CdTS^*aN}@1<WkJ>vw#e
zXDC6OW-NaUlaKs@dR<x5^%7reP$32#W||HeyJPKVAdq1a$1ND6x;=$i3&X55uRW#M
zie(I0NsFiLZSA#g&kq#rp1uK^Ny6rx(l@{P{E9LB2bMe9Ym=h(XqFn@j@hr1w9vTc
zU^l(`y!h7cO196N8vBJy(mtOD%a-3x_}6qvy%uzWCl<Yx$v00>-7hUv{q~m*_zE+h
zen&7c;$@>unTW3@@)1b;n6|a`Sw8x=T(z7m@@2w{i#Y-HV-9~3OoyG~jg_a;KTTGK
za3S3Z-=91#YKuPngJ;xld+KHOz{)GES8uBmfBr)bzRLRHUkiA*(>=ckBOcQ&5f+BD
zXLh7IrD2EK3a%PI<<Lb-Ue8K1c*5WEuwPX17c4pYp|26UQ~|DMBBx+aK6LX=cb|V@
zCDIwD+m$TTn<j1~_~N(4yMRUc9fT`f`4DPS*1LQ8Qs|32R<;jC4!=pfX(hu!&ES%B
z<6}?b@41l<|4UCGfMiR{>rR)nIExNPL=}ZxK~kP2$qU^`d(=BC8CvRBKSB1kYPyYB
zR=)dzg+@$=-$1meLbXl{?hQAz9~9u}29!V>4LsNUb?K?g(5{M_F8=Py`f(JuX};oj
znx}JMe8Gx&P9pYs_tT5?k1OG$Uxz$%qqhi**6*_HnPf5K$1nAwMM(bKk16mc?K9yb
zC9#YNqY~RON!XfPo{^~MoUyW+|J3HN`p=H%rujR$eadc=ja!Fa1=sF=NQ<7{NDd`4
z-g67f=IKgZhB|57{qV=g;mXT|D<;|3y;CR=kCxPO0?51C2MfVhO!N19SUGrQr1DBW
z%CZPERgy{Uh6$<JgzfRiVxVHvJUBJl%04<Y|Ai(79;jR$z4G!pD&MJ^$}Eu|^|OQK
zSEIXdRdkkFWS{!N0x;@S)w!n>Gx+!m1vi`E3PPrD;}<<s-@1)1Yb`a*)?I7I(4mj`
z;FEDe&ds!Z4hiGzU(1x6dLOhHYo^4yiGb#nMv5(b>cc~hcWe0=UI)zPkekY+S0N@p
z7e>QM<fCV4_+TXHKl|6ZzQ0x=si4~VK4~F$OTVVWJq<Na@}H~C2g&O92a;5np5grH
zv9IHkM6_di4pKCESK3M}3VnLg#7Ws|&+P-=Jxr8uj5CsJ^4fT6ti0P*(J*;G#6wOp
zuPR5kqb5Np;@jPB;n;mUd~K<wtW(R2M6z~4f7IRp2aG<;INC^Q@R<Jqcdiv05m9QA
z$zQ|^X{$C7(3NlS7(LniJaH&xyY11^+V)g8`!qdYJbWg4yUJ7R=O>><C*;tR;~7Lk
z2O-^p;ggHN46S`R>RGXvk!IeRr~zZ^{-|%M)<f^i%Kjc*Fz&ZBv6_vi7jt6)GjXc!
zQ&u<5Ro%z|)Q!KbY@j%359gVjr{LCQWM%7~!JR=aT=h5(+@Pl-+W7-yRkxo-$md&+
zv00g9QSY6u6p{X(nZ4l--9%m?9taQMc(#w@ebEujZ~VFz`qvjz@S1d<F69%NJfBlL
zG;Gh@@-~DwRQ@>T+mYK>8)o((HAV}9X?o->^;Ol-pWk}yGsrJj{{{=a5yOuJ^gR4;
z1J;^aJC1r?v$yz~5nkbX9Fo1&lFA}-3-lMSxpgIncG#YG`ya&@|I-5c|1iS&KN6T%
z{O`2~<CDj(s0AIgaAEOMBCjlyjU`;4FGoFKx`lFa@a{Yb_i-m^F8^wt&J^I?k$(O|
zLss@Xqi<~SZlw=2ei4~3LI7L((z)7BTWy}oE`o%P2!&ts*;>|4|3}-4lp9u?mbC6K
z$u^`XzvTK^Yb5th8y0XiuQ1Uucy4pVbi;rxDIJ%h_1Rcux)Hs)JeHM3esydoMan9E
z<8^fTHtO#bg~7|2GPWOjB=S|+c5W`nOi95+E@;Q>JM!hl#w=W2JaZJfztQ5=EfkxB
z6aM(OAq~#^w=ERA$!i?#dmhHjMB@ufnfJGQB>H21ebGPSaxjM*spM#4w)C|&Yf}1h
zRKooiuA+jooT3!6oFf-zH$6ybqXn5oe*nFsf^oY$e{9U9X#b)<pvgNlR)+`@YNTT~
z5=*q{3#Rf;EnZ*V<8XL-NG++wb@jRF;jg>^%!I>HrIO|Gfchd~Hmme`6_KBF116a2
z5aCc2z)yt6b&JIAH)>DCFftfzhnp$nQ0~W86d)|CelL3N(dKt_K$CN53|u4a8!g=W
zJ%T<j6nPLja)3&43_qYv#cs4C9;o=t-_nZefJFT&E#zIn5W(y*bFZB>3q!6*PX1Yz
z4>gFp^(rLu{Sz$9i|_07gKVu(DG+W<`KW=v1$%)zD*9)-WI*H^V<z@!f?ErHkmNzK
z!Av#=%^7)GEZNq1nQ5)3#FCnR{LbMKL-%pcfd|i%7%=)7BTt{lSOwx&o-4O@`e|Bg
z5vBp{bIH$DauwV@zrfbuYs)q@_W#n^->9F+fA@X6U4$+_;m>$|r^G~a{b#RyY{+$|
z=KnG#$mBn8+gRp;Y?xD{iM?^0@j>o9WxBFV!Yuwp{02YHa##5|LKGlq@oKf|n6IiR
zM{e*o$ok&={+Fn)VGgl_Ki;Ctv%>bN)o8Bd<Lqnb<=>-gbpI<8+dlsDq$?pLrG%|p
z^VrFX{f#lRFd9RWm9j#AChat%L?H@Spj*jUI&`)lQscgG3&^jed%+Te5XImu%EhAW
zeStv3xh2myZ`N8ME#rKQ(GV{q9I!Q>*g11e6c%f(ngX{(XuJ-2<bMvrj_5dm)R+Pa
zBnR0j#-bIWT=IFkQ||#AV%6;^hXeum=*!3oF2cuSH4o?9LrTzBFKE(1L_yG(pwpIs
zZa&6tgSA<dK~}PY`cvLg>jdo1t%XaAQCxCGP8w<s{6dhR)9Yp~r>?<ZBa(th$E#2$
z_Wh?Qr~VZfefUFalOAI7qz2zkphpZIP`CoD>X{w6buSP9>n*hV2WAI!K~tm@jX)Hm
zS`)K+_00IxSx!(bGRbBQ+|?)#Cucae$-*Q5BBTMtVdQB>3r;DC3`)$n4u`s)cQN-M
z%K(d!hURlFpUBOtJZHcU1tR>Je!yt?5gjp*Aa8`sQ|$IuXaOmTLMfvt(gSc2nRtsd
zO9^g5MiGP;BF`2>+1c`@KK?yO?EJ85)7?H&OH~N3cQw>i-6h6j`VKr1{vctzoR2%>
z*&_*PF{l81$d;RdOW{ivD|?0=6>Q8!eH%|wq<;aH>V&ujIxJi$r^D#;<`H&gh^Nf?
zEN4|O!Q=&Z6e_jLV|h(CXW8{VvDm!$nxufWJ`%%denAXUb7kGbMV88ed)F8!ws{#^
z&t?@6#jx?1{?Zt8hstUkelSDIRT<wke2gud`bEz?2N7UWVO|1_fU7={JU<ts0sxKO
zY2SR_45PoitkHeF+?+7@61SU|`e_6So%JDpCAv~GaJx%~YioOjdo;CtbK0JGpz++#
ztq-<vJ%r#XjT2Eks$4J3lvDSDpuLA|S~DRB9NCraY@<=X3Ns*(HTL|c*zj~RMSR%H
zK@PlC9g>W7u3ZiYp8*E2^N2aK!*Y#Bzjf$DHQG?;3<RUw;hZBkVB}e@)3Bc_?af?H
zpOa_a>LInCCyR0#B78ZbGEf0uK0cfac}QyEv=N2PJj2m}Y|zTeBSs50(ob44^fY4x
z2VVB}vI6H1{E99)lnw3ef0v835kSAHYURO2_#&dTU<Gn#jQNwdnRwzY6zP2Uk0Bh~
zKK{sl(9zhhgEb@8)F!0$8-yXn1<|2pNvmBx<zS%n4kMpwLMY>j(+1DT2_dA)YRoo9
zDQZRjZX1@pSS*rg6z9o2S4NgZgLa~0rS~8ZB1e2hd{0vMJ{(5-MSnpk-I@o>kVx$O
z{d7ea4j17-3y;Hh3kpjh3;vnPsX0j%)Hi1o*&z8IJiUckW2T&#ZEW4=45zsE6x0?0
z?k-nH>C!+HRmGjh+a1x7Y)SJcv&U$qZ@VK}au?UUuLSDG7F=E_4YJu$F{J%KKooe<
z66?*R7D8a|O&=Nk%>0r=)oWlh^ZJGLT9U)$3t^NxRg3zQ<Ur}B`*Qi}DPbv=<&s5*
zER%|V?N>t-*wB!nnKda(+FwT(cRsq%GLx`;N{VuS?oF(OUX5@w%pq8<pQ}|2_Sf#$
ze&Ei`ubGK6<(gN@5f&jT6Wc)pakj)w+-?duwvqQdWP<sKORxYJE1Re92ZgnwZC9Ca
z&(xZ#df4M)%{eEg=s(Y`_ng;Q#S>SeH9WxUYA%zfgu_t-(Q8F^WBYC*{lPW^ZgRFa
z+uG!2E_|Kozx|U8qytAvj_u&UfC0Z0W_i@Zg4$oKqatYbYQqH?C$@uF<vdh%>iqV1
zK^If%lj0>guSimF<YcThH8#>=o25E-p`hPr$vF;5e3!J{hsV=TUuICY_hT*mLTvXA
z`r`^C_Z@Qw<~G(qhm?NB*#P2eM#O;%DAw`4+ZtQg!kj{4_G+-$dZBPi4*T*{_uTY|
zDS7+!I)<O(qb%Gk9bHv&&n=?)?!xx_Gc)Q1e*33WKoiy@-%G2sBfYB<A8?d4V$mvr
zioL~}KfKRYdyAxCSOF4_&Onn8)H$N<1MIcOiyvcOYx&!o6{kJQZBXF+ByUsykfGqR
zz5M%bFVwXas|tsbpJJ03O{N})VzAg}IMc1rW;=>$nbmT31ye5Puic}`gy(Tn7>5R_
z^+N3EUG&BvYa1fe=5WrEzFq%1+`{jZEy|RdsJU7ji|`%(bzoGw6;k=Bn5YYckbVK^
ztfOVgb&ZmdLaF}Zah~x4ojB%52NhP;Rt0xMA-02TNDbc*TXoy81!#+@G6lP-r{R9k
zc0=jYG@KaD;c1q$e%qe#dtr84o8Zoc_3-ku1m?gqLso>N0o6(R>GI!C4hbjAgSpN8
z;vJiyO#z4&7_5Dye@R~UE;kdO(xGD(D*mr!8ER(Nh&}jdJY?drrM*U0Q(M7^K;`>+
zM-#*?RylXuyLl&Dq%b19!&2Hb>|?C8*}?LhfOVefrm%%TA{HR$0-6?YmKQP)zk)w;
ztsW@yHQIF2%37?Q<4juWHuD>bT`~A}r@QIo&iNsTM667%yXslA__`hy+ZAe*BD`~E
z2y*$hY*r3;MGK$m^TkgOFs1WRlftSG%RiYE!Nus+cy27#xJ+49UNb6GVO@ucDjyIE
zW15CzN%Ei=lRI(Kzuo!cW%h@8CCk_Wqp8z^GdqzQ>tAka96fQOyOwhj1Kh?u|GHmw
z5%L;5<2iPp=3g$^czE+psWy@j@54;>u?*H}NFwF(K>~{GJe!+Cgb9x+%?_<~)9!WL
z87{jzzj52Wj~-s$ICw7;+xR)(xFLz%->+$<UMqiXP&lRi^o#L1Ew^}D#if3Gj7Cgr
zcC5a1UPJfVrZ#ZYatDVH>h1&dl-Yrr&;CK{)AICOBZB#PJS^g3>d{DmQmaZ9$X<CW
z%qC^qKQ>`}`s6LIrh~V|6TINpS%<a>>&+3GL*A#><nua>mYi%3Z%=3|RZg@mG#T-a
zwBi?<xRo?xI9!%b<ufddQ{Lgb{hSvzRCemMgxiJJDO!~QTFaYT_$pHZI4o$uuV9fz
z%O9TGw4T2`F%hSbv^261G*OZ*9E=#)q{m;>%%}SqH^{RM%O1pBIAlm_4h|c&^8wiC
z{JxM)<OQ+{basqrTI<~#v?YA?UP^J*Q5r5wc`E!aB9|$uHfU%VQseKTMKOKE?U8bM
z4Hm2rIAVAxQ|Rtak9pz#fTxc&te2#YBB?AwU3tng;+^Oyk9h*IR!{vos=;w!q<wWG
z|4?|{Sw`UMYweQnKP_lc&)qR<-R7Jp?)P20pInX|#V*ncSX7y6*?blx+4>%!`WAu&
zWb8Aa;llMg79kt(^7iM1vgvTJM#F-FCO0O)>CsFsPJ8j<mDleh*|Gz+UUj`qAw`Kn
zh4E5vZm$@>`Peyj!9@}#l7z)cqx-B?qN6$2Z@8UNFOAW*zCNY(2o<ohyNSrOd(df7
zL2b57==p8)WwcD7@7%}zEX!c>rr_PW-Q2V`y)*kdDQg8fgsdugZqIpVE2$t`ot|dH
zfsuhyu9XGs?3m5h-Rsq`YwFNp5=oGHck%QRFqb`@6Q`yEUA@~$vr<~xy-1-mHofH&
z%!T};P6kGPl|hLZX{+SuS2$9-LwPb|Adm#Jyd{;;INEANn>$@`zbWI>s71f)c+1WD
z%Ai|pjO@Nn#t`uXI6wTs*FVz6;{gwN9*F0GDV>^?&N+*>(|tr|-8B7uoIY(T`F(KH
zY;(q^Fl2`OnR`wvt-UI)GEKtvh(d~4_u20(<TCF!;A>xBZ%;TH>t1<~XO5>GM8;^p
zXf3Yz7E;cMURz(g`wh`C4GFr7@U?*(-E{-;)3&4YzGrotn&lns>X$3<Wnym41-X@N
zJ&_xl`C`DlphW1sdSTgTt6};}R{Uqo1QuHc+1SSJgu201PX?xx*xi`Bh7%Q?WpN28
z=h+N*+f@_O7Jz8?k?<1LDp^(e!N$LZPV3el&d*8LQ2CQzemjt^mLIxG94OlYi5Mwe
zz0s`Bf)-v+Bt?~nTu3UPKU!<E@@H%QFhGydY%kFMfsnlfTLT}~h9sMug&gTAT_D?(
z-wa-r&nXpesp{SqVKM0=Jp@5Eg37)7GM^7k{z<p3zgc2o`T(7_*kVyi)@_Z7W6anD
z<eCv)pt#p6E!DZh`bfBkurgK~jUh!vdQ3ShqbKPk-q}=1{DW9I_<<AoZR)^k(ReTG
z`UmWV=e?$=)@Zr~>?aMiB@_FF*1GrCi>J-+WRBoV1#NS6q!uNp)=i~L9K<h>AS;i<
z0PPfkpZ#iQ`Dx{?4^Wn!^6vAjnrqK-;pVL(gVBfY-+mmZ_inokwZdm7-@R5}$bT`o
z%nvi^-}A#YNm9||<=#F6;lX8jsY#dqvM9EXRJGmMI&$61c-3`GZM=E2=JXm%?A@`;
zohcsk2}X}D8spwwf;#CbW$)Kp9*wkL%`vPX>iFGpKrByQ%|4QVW!;<Cm5H6UqC1i1
zGdhyI`NLWj{64j-OdU3Bu}Sb(zSC@*i4+$GQl{I>M)I(|b_N!ngffUIRn~}Z4jLVJ
za+*dH%*4L9NuX*aqyBmrKObzd{jO|bDN7F#ysMG^otw7Q-<%~JDGa$eP{&P#{fZWT
z*M#sO<0DO%b8rRnc_k087t}U7c>BsEY_HI2vXr7*&-cpLW@&XRLuzQ%XETRd;$0iC
zqZL)^x*d-o8)IJ{UyoFzUoLmwCgZ#p&QXO;36JE#{ZFv9aXw{Ra<^V(b1ywK-uB5?
zS=J~we;bnDHX!QCR~~FQ{oyAw-@Y{`4nrOa^G7)JynVHmNZP;2S*0$6dnX3vVvo@w
zY#!<oQ;AvD>(A1(X};yDAQ60a?GS5LBs{@gTp>;xI(xlb$DP~uF)e~C&=CP(+@a5_
z#tjE=%rpi&73n$5Gq0ESlTq;VaWv&F*B#*@h^8~s@G`ANf;pjfS>sccZbwe(Fu2RS
z@BE%r`L2%q3jLzhZ-`~$+jq#9+k0!xm~$UzJmz~oMvV=W%`ZCSp!ECCLxQ;0G35iX
z`MR4CwE{ywR|h^uwPp^e9^hr?8N)xS(dBo1Perv9OdJ_1{U!>+y}JtK0#z3ApA2Ve
z?N^CkjCxMjQ}mkKTua3E#*HXd+C5y{AH;hw%UWxI73mF-4IS#AU3Ur|W9j^~hnp<{
z722MN7SJe=OD#p%duYA?sk3U-+e7k!&bm@LlU^6sF1LKwFH?4Ht*+|c3RD|<RGFVJ
zs->G)by}}u%ThlsN)Fa;4o_+NY+b7SOHSzf7DrOAIrrP&=_)Y#dn}rLXyLk%NV|G(
zz^{u)SR6CsU35v8ds&d>cl0O4U=u_O4mIU2b?2qlpFycjX+T1F-r>WOk}Vsi{nKc7
z4>_;4%dmiA_|v&^EnyW7RYlm0cG^u0nq%nhpGQW7&9`}E)7=ZbY+l(+x#RuO`unt}
z*epbctmVM813zSf^VbD$RxXyvd<Fw_=i-V_(L|ddbMDw&lYX3vQoqC`il0`KuS-a1
zaMSCs#C#&zmmZQ=SAqs$mKcq8RpOldpZv`)X(8UXWj*Bz#~UZ>73tQ*Wa7hL!tX@N
z6|VXh<%`zZSs~sCK`>hyeTI4Rg5Hjrx|YEa?#X*M6alvuRcWkb{9%shhg0)8lQQ)T
z^>YzGXtn`P@Ul8PQ$$pJ`M#E3=!KPTMLO<n*&rF}3M*GrF91~vd}c^Ol}q3=zRE){
z!(<QgeMv8OLd)s(&e=FqzU0ASsH;Ue=S$Oj^G1d=Z@#1;rg}Voz+K^?##0Zbe$@U_
z8!oYXWQvEo&##&Yuqr{VUhZicv-93Q$lb13UMtVw3_DPOw&{inADYHJ*k4{01~O>#
za&$T7I@|q-%R{FOjjAS%D#{f=BdJ6rE+XKos-G-0pJV@&O#!NCW9kW8+W23F=lb)?
z$Wx9&J9j;V2WJk3)FwM+y%D+{#en5v8>OLpg3m-@1)oVXHgNn)pa!c*ziLFoqR-!1
zX!#u_C683<A<Zx~-{y4L3H++cue%CVL02~h0}&mCeqLK@|JDm2lT-3*k~CR$PZ-H>
zfOuNM?=Zhda!~#2Kzwt4uaM0Zcq=B*OBFh+TK?W7=Cs4}m`?_2gBt*AbOWeJbaHcT
zN<hO{oK8hmJ!jK>CWh3Z0dLK!<)^WULzNS;+F+I2eKW%|xn5~{w-LT)ApjJSF!c2H
zgeVj%<P8)7Ma4~C2#@G21`_18Aj2O4@P!XHeO-*oFH=oHF*eG{gF^f?k;4;c;i2^N
z{J&#g+}M1#DL|cjIA^dpu}8c~Y=F)tLcUH9aLvA~U+mNoZ?Z=`b^Ib&3aJ6FR|gjv
z7D_<3*va5SF5jigt2#UoZMJDcrI95cMf#%;sYS_(=1VD%piAqHE=<+I9!}a!8-q-f
zbCQp-FCY*JM8^Z-3_pe~vWLVjlSe6Ka0bHHt1`)Vai{m0NBby}gi4aebJUZ<e&&XA
z$%T+_!T?hu+`q~L$pTmTMPWqO&vF!tA^ByF>7B%qNTB}9Ky(OO+Vk}Xn*#k1cD9w;
zs7wE%SG;pyv~#Rqp-SL(CqASC9S;c?D>l2aFLH6FL%aOt2{g2!kPNgK9Lo~JDahJV
z<qJiYTO*c*A^Q4%EUB6&JjU|G>qA}FD7JM!_ityyCs<tkfCO8WTIde!l_}y41k(Nl
z>t^KXtq%!05vaEA?(+Ptx7ZL>!R0)4vg=0!N_5VU{n>SmB#76@XHr7sbS5rEzax_C
zoERY~fLWe>KAnr=4|NrwUcVIQ2BQZ&6h-pi#qEw^4X7~UQap@9pJKQ!2<(7b{>o+O
zFsqialKd1ukqfuWcv~jMc?Yp<7;3Z6Lkz=3n0__z6Ne7}DU}a|&2WH0Y3lQ;)Yj{0
z2W@-IKM!rs)Jw)_;I}rx)ENQiBVqKPF1*N(;p~BO>q17f&pxD}CR3m|w3vl!$RPij
zLHlRhx6VM8nAwks%?hAwl~%O+{ofThoe$y`uNij`udYb{<9Kt^tV)0Fxw-8%9>gud
z=py2ZrLoB<X+rVqxZb#M@S2Q(ZknAw!dDQIrQ4ATl*Un#>P$3{if#uN{$nXXKM!UL
zv-vY?v9>e?@*+_uAvLV)0#pLA_f&W4pq)Qhj&&GZ`4qc(ie|<wjC$>4C?fTR6Y8p1
z&AdKAa<GA?6nz<b!M1=Q&M49?9?sPzVRz&LPYnHN$9T^30Q-vadI%i-1@>G7VLLd5
zl<O#!7+DLjuvR<NAC?dW&K)U$db>l_!R=-MTbopm-BAp@4iGw#2BVjBJLWC*<8w1{
z9EP;ix~EGi{Mb&5)}8le1z5CFV8q<S3==@%O>pR?UH=T7jj*&RkzsPm#HsKm1GV8}
zo1fLlr~GJQLW>4k0}N5f1*ERVZv^n7pizlfnSEooMQdXx$_whMQ7sX8=Gw_o6@bpl
zF-#k`K-}shMF71y{JB=nu>gMwYG%@RpLYXzeNlZvh8|fZjw3EQ-Z8ER&_{E|V{A~;
z%|GT59nyf9g9=-P<7$C^2+~!dVgXwXd}^>}Am{pJ>bvBkD@dLDazmd8^myBcwFZlV
z3Ac^ky=7fr_+a~YM9ab_7?zeul$rF7g9CMNVo5EYaSN87(hjG5ot2Y|GKR|&#+eWu
z<wW-QL`C{AC88+_*bc-x%aElAlgr6<F!gjf=XwB(oJ_WXd9wkvkjO&a`CvQV$!ysf
zTtT@hR?(t{dt(Lv!|r*f1^*4VrO`qnnu?+h;3E9SEYrqsA_T#?CngJU0vTjcq`4%o
zsrMOv`f6VvQ0n$f9TbMT!UMIhL3Tz+Eq?}zAt|R+)4~n}9Sj^R6e4HsMQ15kfU>S%
zU5dd)WZ^9+hS}Wvr&PNrWA=y^;JIv`P8!rz-z5x@d;YkNx?p*1qo)`u<=(eJytnhP
z;>eGgIC}g@Ci%+~=&T=cyY%z!qWgfs*%apB_y*7t;BJoj+2Z6mVbjp&*Kr~M5$5|0
z*Djx{p9Z%>v}B^{>NkiZfZmEJ(yJ_kt7o{EPror&HuL-`Xc}6Fwc#0MN2|i*CG+&t
znj8_!Z2Kp6e)F)?5GOpv+Hl&)!j7EaMiM{)!A-Y=7FSrtw)G+d=L68pKnqi-I5**r
z#6-rT#(ZyF!+A2a?4xc6yXb5qMNJHeI*v&8iP*=u-Cw8tb57qPle+cQGK=JRAOTEd
z=6oire$qq06w>qz5G`kHRA4}p6F%=<w}qc1bXpi<4W<K)0nt+uu!6TChUNBdKMvMF
z;HVE2+s9Z>-Hyj5IA|GjE*QWm&QGy`QaP&SJsCGaEF(6-prPCQ+<Z?(k%{pWaqVBP
zR)7#4!STKE#&HjcvbxMj%6b&r4tO0xg;0Cl=js5?{m#T=fMJ!0!^8!{f=#{xzU2xe
zNN6aX1)#F~NwI%h&RIy+E2-S>d-JS#dYx!uiJb}JjlR-_zp{xnxOb(;CvS+w>csJZ
z3P_~gWB>FSFlhXB^2k2_HC_XkTGGBfpiaQHJ^J|m;ULP2ofk}F#@NDvZn>f@z{4dq
zVbQ$TCO%e)5dbEQ8?CiIMgppEDPm>0T`nkRRv<e|G@^OC12MkzF}6XsBOsnVt`@MZ
zqKxwpbtY}5Wbp7+!IDz!1p$bJZbuTNCUQX|&GOSQF`u{#*_fu>wZnB<6hfh0W}G^$
zJlEKF+{X}Ub@%y$8xBA~u}cXiA}v_<qRVs7G>)6e9&GXXN?H++)oD-%EL#`9VJ|qV
zn)m*^ZJ(5l9Tj+S!T|_d#|9xS4UOT{Fjmt21jEzQ&qCx`{Mm#{_8j-?fi00LugPyl
zdE_fl^P1B;EkvPEWi~FRFqY)|w=W?VeIYg4fwcwOX+`g=(Wp`AEP*I)Y4Im$ISWVQ
zeR`~5We=Z93*8X<dXnlyWur3Chd{7RLm+Okb$QHBQfv)@vI_u1^0@)pTRV#kMe=Jx
zYIv{7!}!vH|Eyer9)jL*v|I*iPjFLYGU|1V?s3M>5vU$$;by6iTtovs2#6>dXct%1
z8hKDPg$^!<_=+Q?*G$T1BY<#b3BQHpHRb#!3J}h2#H<0wZ)r_85Wc4zPDg=9TLN>T
z(AhrAU^!D3e;GmjwDF;M;sVjqrTK&H6Tr4OzX@4NJ6ea*2f=Ag<nXv5K)2{*%H30A
z^&4wPy`&?lY((0)rH35T^m#}D`=K2mWB%M&CjerpE&!vPh>HjVG;#1ObT&3_GaiVe
z%ajN}#T1Be+-~54%->qmFE^z6blH@+({;z57tnZFahS6$T*n*tj-@)pFir1|&RR_0
ztL&|BH>nB4A;2#K3OFSSwJL$L|LVr=q8Btm>9;4ijtfr8<Xifp>0+Cb&|+o`n09a8
z0#IV}1}wHPuIhGD6r+jM(%}0lQmx#N{R!4lbe4-6NzKKg?*fIuqG29Lf3cla6!&Pm
zFF$e-?#a{uvIn(a&Bccaqb6`pI-6`USd{zh@GEcNOm#b~h|=*Eu;9B38ijZT^j}qR
zNpUk~#v%aT5XbF$AzB1g&!d5Kv?-$Wc(Rj3db~X>I0#VZ!E&f8XL&`R0CTg)ywXF_
zq;hQI2^&z0G>ir`rXUv`c>9$BSy-nzmW`Ae=9^FHrxn$ohs=~@SM5Z)WOYUP0L9He
zfMFTCoYz`6Hov9a6f0wXb5i4!pvywKSee%9hA#}DKwLDb`nU+4;~9ahLgtzr5Cijc
z(~3MGLHyMxRH4Tj1_LJJJqrOZpK3X`W931X5=5pA&htMw5&e6)i-^5yvKSC33Z}T3
zmYA%W13r<|+$}g$2FmKNUGH+jEt0OGHP$m<#fu^RsuV^iQ{wuW^p%wZ4b$u#JmkPm
ztdph$xAK+dcpADsnG<kbn0Q#6Ncw4DjVIV|SG*yyZJBTf1B*+=HRyLF#;Y*XjwJ$W
zE>D2Sea%Ccc2>8;jyP9&!GQ895$g#KU@=+C42FxkYEqBDGd-jU0F;RV4LP){SZrUM
zXnX@xKPV@x*Dytl0D$ll4(u&wMkQeV^1z~sDgo$SI43~#;dgd6R)S}UdH*^l$yx*&
zUjgVS?U5{WxSy0@NV_1z&c`oQz?=+rdWMtlCw1bPk>*(u%IoKbqVh~LxkQl^AU*j)
zd;r<#47;dG*6~XyQ(&JI20WB0jJ|k`+cXg!sxCvMsFsjSIKZzFC5fJj^!8&}hoqrS
z%nmHKKy5gj$W=k_8^BsmLu#bf+b!)WU@JU4-70PHH^pGcUuAgu3UR@*_g4>)M5O86
z^l%b}02<9CFO}zcO(y>%>=Ej6EZ@+%t0kF9z<&OAq({)uz5+9q5dt6+T#^0+AZe7)
z-o1cjfDs+{Tn+%&4cMF5<~c|XNB|&h9~K&<)&0gLSH}dYxrvBkM_<_SK`h^fKNs_M
zfz+T7Ewa!n8DvF%MY_{5rW&%<uwK4RowB6)Ik8XLUr!SAzLAuAK=yT*b^^2nsf*~a
z7j<o*sAWf#uAD-2j1$|4Kv|SVi4a3FCt|lPl2-RFR2zF}-BzUl1&A^to7{6T<bn6;
zxILEY3#u|Odso5i%E`Hl5FY5PF~FT6qTW_9?#+`(8bhotVuXy9IB{Y#{7ncM<j=H<
z#nO)bHp&sF#=awVXN2K_Sawo9`xhRgAvzmL?Mw;?=p*?V&ZmkcJq5BcrN2zNPoLm}
z_%OwSl#8-I_+*iCt(7x?Rq1xzBx2&iJ?1q#=^@@5`&!lF>u%HpoLVj5`P24}tHI$Q
z6%gZk{XL_!K`Z!Mv~se~G<e6@L+&a7Hj2J_-C7}BQV)75i(EV<6q@YmcH%$;#0|Cv
ziO3vl-Q8YNiA-KvQP{9qC(kHE^~4Jn2UZ6M<z%rkIf#N5bPKi233RAEI0Iqmb|^t=
zK6<tJmz?iE0&lS>_mQSx^kfQPT?92q;~!jVP2y7Q`W;3_o`BNV`Nd~}t@S!y>o4g}
z%nSAd>b}e@c;XhT6KyvqZ7>fy%SqHF4iJ-p_JgkmAJ0PO;s;8T$9Ek)R&7*)proVQ
zp-QzUUIxmK@917FtBqgKsgV1p)+@V4j##cR0U7S1N%Qr?gTUr2@*`8T46;Og3IL9f
zi!R4>)3kAD-H*J&&8C&QZu*V#hd*_Rwty!-1|7fg>%ZSO@&Ni9dJVAH5oQrKt#q79
z7I0b=10US%*o#XTQ|hDReix0uo7+>(q5@xHFYp}uH>U5WsnW-A3P>!ipI|wcE-192
zH;VYLdd0fP1YQhu7z0EH98@&aHJVyQToZMDo*K0}+X;geu+)Q;Kan(H^hXq&7_y>J
zq3;tp@0v3}Y+ZrI06p0mfb8ZXhbQ+RmlrsWTzw__Y8a4Zl92}qx`QA+!TK?poIMUT
zVIpO)M6oizXqHAU)#8w6U%gJJg)0o9*(S~<1Hf56X+bKSIp*XW&RZg7v`P#-V;k)3
z6Q#-Lm6Qqudq1GRpajk;TJ|V9zz71d3@%P$*J97TqYOBO=w6Z<WP{(Of|RRd-fthi
z(IU8`weCYLN&1KqNAkbXEd4xw61Uq+x%)^827_|3@_NpX9Ye6ef;Yul7i%adKjxYM
z=_vE`X^nK8_Qe_ihk+pqCr2U2$|wgYqZnu3vqVosE=ceuVI;)Lqf#^N{V@PR0*&qU
zFX8+PO8|=ftP!UAfTQ(<4O1@nvdUAyCzZJ&Iz|Cx1Wyn{D(#4^i&KAMZKB<URZBJV
zAsXN}P5Xp?P-1+&$dpssVC4M0w{{C>bRac!=nEy@)uQZIc4<W>8xm9{;sNoH1J;kb
zHmc7RmICnIRoQXJ?I6#!GSydHCv9vJd0$A`rxii!&kvpUtYY7CC@aLUHFv|nijQA*
z0B)yxJQ_E!x(jT^r`wsK{>d4~!vFWLT>Qs3;{lgGE+zeeZDd2+E(o$to?gb`QZl&!
zTZwXPX?cjkF&2+w!I?54T@S9Pl1spP$9a%ID+hCXs`|(ZQChZO@!U!q$$NX>Jhmw+
zf+LW5y_}S5564<kfQ{fa4gCYp@xhippOLJHa;ly1pWNuyR*XH2ic^mVJjBZnHAQ!Q
zw%tvdX<2&%Nxk-Q*6sV>_cyjCA|l^2#YxAvDhA*DYGbaTV>=v?Trybfe>k=FLOWK=
zUh`-dKsbOC*?Z^)SXEF=?0~UGs|$FkvO$=*O0<Q1mGq$)0&ORLtNTXsgeb$b>!)HO
zH#*<6b@78R%q6;i=qnpMxVMo$K4~{lVy^|99IL%Q;k;)-td>QI2`idC(Dkc<`2;Y6
z5b>uZlJW!ng-d<?L2bXshd)k&M4n<(vdCftW`L=<EK`ssmXw^;K6^fj!I<$}9<2ct
zBw|GkJ=5&+IxQA2Wdav$^tzn_qC_R~@1IH<&}csk36RZ0qTG2+%Rbs1&n?8>a<CHh
zbJXpnUCH51#Imh&>LAdOY|j4nSaNvs{(6EM(83SuV%AQ=Is&N5E)5v@_CF)XMs3v!
zhJ3mVdLExB>e>vjZka$+F8sxJi?pIWT^5Plkh1~f;m!a8F3|6wpXyGtdjh;1c>MCB
zO4zcE$u2n@{aqLXdc(Z02vwF7G(ufW#WBxF9=GRhAt+}M2qw}$H#=ah*)5UyTR6ps
zyL1}!z8oxEaN{=Rgx7y@gf_eGt99N3FVw^3h(Jw8NA_jW?~mTT0aAs*Vk_Iwp^O+(
z=8%&qi0^m6>M5V)f*VFrukp_Q+Ov0yl)nQ>^dJ6HOzP*18pb_}WBXCaf7339X|DWU
z`%uO0f9^He{oP6Te|L}RKi;VRj|Bg_^%(>1`oFyp_aAqR|5xklAO_r%m4F>!tc+0q
zGPJp$Vc*}i+>zk_{Fbblzj$sWlj|>!{b(Q;`0%~^^TxKg62K#-4VwRZSi%C`pvUo4
zw)?+#4e-CWYLvqQXb}MZJkjk1nfK;H3-dfLL26*v>Ni$eaS^dS8WmkL0BOSWt__;O
zgHv12`<>;J7|OJ${@2k&^Y)*%pZAD!Ga?BLFydP|ON*YypKNCWZro@QKa-J;FE!&S
zv?q+kxz-tCD}BzRA`)L$LTx|3Ldag{H<NSv?Gt}zC+G>&li!=sU@(}KtR^f+(_rZL
zuWJRU)5*8`HP&wRM`_=2T${-9+{5J`_5qjHGzTCX0@RzD9#hZF$72W#m;rFJY&cBM
z)L63BC;I@W<S$}uF%fJs!I1BRrC1mBc%?113|g5(AVCfYhXT%K(`M7OqWe)Z1)6PF
zvc;WHuaOa&)sD0y8dJAvjeItzI&;eBuITpEqTS&~+XuSpPTn7VUa@{9mpnF*%o{q;
zhK9Kx&U_L_n)jkxpvEZ=OFZ-tEP*Ei&r~x9imq>_Qyj%7w$N`J<EGvs1uP63^g4!#
zZDYUeEer)}!?^qBr&6obq4hwU<ory!d6Nn>88i%TXFC+f|H?6As2d<O{#bk}L5!Bf
z3#d;louGnTm;)mW7rJ${fL_}HT!Tclo9CV|p}3t7vb*iMYA89SFkYKl)X4*}2PZI@
z{u!y=esV`)y>*b*4bT48i5(RY-f0_Nk;FHP&fW%?5S~CY!-aXfoSK>K?jDQhq$6=-
zIA6GM?aaoLcQ&<>`0Igj>6h?#GeZMGCSY^V(d+keKE}TWB(GziKIyC3Q%~IUeP{7@
zft%U?)BF@za2&V2K0YVnj3Gr$_YflV2j@jjI#}j}sjSa3Rdrt+gID4W14n+1I!Pqg
zM#Jg-Ya5LRkGM@S&Y>^*UaqK>tQ>^Dr~spd1EUMJzZ8J<x4Z_fmN0G8B2MpwR2;BT
zSqaK+?Q1GM7IPZ?Zw@|nOS`os8yC1epF1C1qqFf6SxN7Hcs&%dahmEJ&x|2WbE%$J
z^`!V=G=}|&BXI}n&;8kxk&=!Iw-}ICcC?4zxCv20bQZ}vJVMaC^PAm>+jOP0lEe2E
zQ6z^v^ziHsw70!53nMlp@iHO@`MuK`EMH+f0a2BPhVj3Ow$S-rhMYf=^vX?qAN6MI
zr@6iH9oqer*n10!hd>#GHRfc?*`1H%UwnEU&PC~3T94~B_iA_>pW(&UrKz@(__Y-J
zzSX)V)s<QRKUlu9?H4x?r!7}E?VkqpvzgP@oQOfvO8j>jxy%k@yRky+C1WkzxASDz
znnDK2MwC}rtUgHO?gC|`k0=ozThdfDXAz$@IDSh;-rR8*BYY?Rmm;;4{EOY<;A%fj
zeeQY8jL3_UEBhKHFU{m0y`<Lw2V6F&U&fWFe(eKZnpjY~pO)fQ8!-Wz>7RF0dSAbb
zmkz+ggGYthSyij`okg7NXH>Jsos7dyo*BBhvf9FkbClSL%r&#$&Wa}x+=oFaLY|CY
zHfu(xr76rfqgY4%Q9UiUetYJwG8^@Pu>Duorj17cb=|im$Z1*TxiboLzWR>mUOpir
zU}1o!x5g-(FAFO0tY5B^BM3?Hg%>Afr1W)i;o0N~cLX%m8Ana&l!sHP>6B>V!r1-;
zsB6_pLSL%_=FKMYizMDh56xwqi!*Q17C2%oA63M6^Eqt$SQze(nV1{qSQu(A*6v@g
zPZ5)C(&%<fHQx(~j!&obN#c$6>MlyiGv#KPk5jxc(nAtHj?Jg(EM3>Gni~I%FzGFQ
zcY)N6QsXc+o+zw6!Z;4^wT`0?HM4@o=flW{GmjTJ82BL`-RS+74~H?qh6_!QiCb<A
z1Inx3;K>I5zsH_*5a>@VO6yMf_^k}7)$i?<cC0U%wd;d*6@7<mo59l!BVBZrsi5)U
z?*&@<5QzGl>SeM0NFusyb7rb~3KbxNw6lTKJX&P;YVyDMc0r6jn|XOe&HLZR%RU~D
zw|3p~WW-zkx|Ht$ZJQY5o13j^4l&M^fS{Endv}Nv@VOMG>0!^YeE9Z`VCO1xm&$Fu
z=gg058dAi((USN+VwW$a+WP%1DS4BDYY`~({^0bv3?#~KFehaQ#hWj6*)($ksOehS
zY>h7;>A+Qb$ln`ykv9&f5`Zblw}z_TANVP+1VCr0<M(rX=63sgQX=0O9b`&wZU|tM
zo?uH59R>G3qH;Th!We@?JU+i14ATaU@@tb<Q|BUamQKDX!t}PpriQ+nlWno??x@2X
z+}*EbXJhOHVmD6p#)vawwci#zTHC+3<LpV7H<J9GHTZO(J_{DVs##snrZxO-vg~zC
z*RN;GM|-Vgwg_VtWa!y><X8)4;UMpPT=?ySmgw-&_Wt|gr^mHImwe{f&o5+%^_9qb
z9#y$Tm@r?0=3jtxdpy6A$EQ!QTVp(r%r6wI8YGB|<RmJ=T2e|3cdp#osPpsOe~ML&
z$BRhqL>Mw#>1BXG{3*xZ3$QRqJ~}$>z^+jYi?KooB17dXd29}unbs;RJag;YMe%jw
zP!lG(mvB+^)j-Ad@Vwn{y^j9UG(jRV5A&FHJ^N;gbFE0AEh3j&&?Hp5zLLY-a1)^r
z`k>yFdsF1rUKGNCWPWzv&TwHFnwL?u#W*p9>{*rY7I}i5E4#nUPrXL9B?^?TE}h^Z
zCvv_SW*ipf)2?<)!`wQeeC39huZ9-zCUgpyPXDkd__{d$Hi0R;vO0=MYur;aY5eVe
zn@!2!d|qDP1V{s#v%RIY)L5jf^+PM4Z#yEFlh|~=eo2?`otuA_@M%pbY~@*%bK%Os
zT#%f@*U;Vdx^0VuF~RZt;PL6$gt3cpbMY9qZ;g>{7bQyOw-+^Pl-Krrrx{j1=%3aY
zoOH`Mnk^>xWr{UwMelRBalTv0)F^P;%eP(s3C{RjrrZ-z3EyX4?g&ZZrQ=GNkA~g0
z{49~1Rad6MSOZ)a5;($&40#>bKyszBN21gW(aJf?KVwYm1>$KX=`q)4-74xc>P@Fk
zT6XS*m&x79AFdKJG+!!8C$lEMg1@tEc({0fGSSD+@LQ+Zo6n3xmIB&ez&?469`DmF
zY`LpY_3dXM^Pe0&Qqs^ZR$*>m_DMwO!17+o-mMnD2QgalizDCs!EKsenvfut^(0@)
zdq7UnSr8ReE)X26jt`0LXMe_P@Hg(L8aoGJ-2UE3u*^z76vO{|4feB=1uX29hN*Yv
z^`21Pe2UZ$YqZI0ZHkN!hU|?w0y4%TAds2c|4lcU@&5B&3$JAU!Fam6LZ(Q{E$@H(
zXvf+=DU(O?!+*Y{;VK7^`T;!EfAga4KOcPZcKz?~j5zQ9_3!VDkox@LpPNeQ|Gy7F
z*sN2(CJ&tzAVLOKyU#g*1#`@sLdS*7)Gw-cCC?8qbt_wL9OR}`ga%fzyuD1_d1?e!
zDE>P7<t1<t;@p~<k!}Z-Q?0#{E#JHP^+~tx(XxNGP{RGan*eo!SZi*$R5AsTO=e9|
z4_=f)r7g*5NE8YDXz&}owo>^fn<gB6UAtwTU)g{1M4)WoEyIN@i`7iKu2F@s#lO}0
z2x;3f%7!MJ=?C=<SqJwQ8-w_myYcDD#_#Oy&Lmz4pC4QRw01wagui+AZSQDfkmwSZ
z#u+MzI*T3k{5+NBkzXU)SGDF4qqglk-r<B<;|x3<XoA=ox>9x~7=^JxqkNqk*MEE9
zh$4=r&X3T@>M4#Q`z}DG(^IeGw^$~*3=fmMXx@DO37xQ+DVHq%YhgvZn~kAMJ0!j~
z;yA$v>~u29<+Eeje70KXmMt0uJsnnd(M><wIYBt=f@kbJ%(r=^9#oZtwJ4dA@Xp6s
zc;-ATxzgp5m8}4b6gmjYf8VXOadP;LE%Q1Vi=L`ui1opO7nk3z4<aruo5Q-2ueT>-
z4(YqZg_42YY#Kv!R(xRf`SpHMS#8e;3m(sEqrMC3l>NwsUT1R7%$9O#aw|C*>sB%$
z>fHv+20-E`*GBOkPldc=^7gw_?o*bWxvM$X-(gkn|4Zz88+7>vU<bO6cfj6MJ;}Od
z@eW8GMAPkfZ?T$oeFT{5;|B}fe~D87{e3%n{ej@o2R<f^6FY_ojWA%NkJqmZ45a$6
zfd;abd{hra4&yzw7-Jv|)6rQ712{B_1FXaZKx1t3=fvXDv9p?}GOPjU-}GVXb&hMw
zy>6lKdvje$pe%fPzQ%@0S?JTeuQKM#b(*xg)}!Zdu{E59-P<PWD;;~AOJF%uNg=Bu
z3%d*dSs6Mkl2%%J<wP4I96~cs62Fx{bYC{0`wZ@AxlA>!wwq?7J&RafO#HaDH*%lp
zYJ42D+$LEX_8cI)$R~Kk!~Ugs3iSyMS8FPMK5hPbF??===WnZ~kZS&yvEKi9|M7n$
z5c^-ii~oOi3R32V5BN@<y<v#h5GGh6PES9xyMq6ADCSlYACZ#xcP<fY{&eL_AIA5!
z#+-jhmm|#heqI6Egsf6B6`vV|DeH~Cd);52@Q|_SHR+VivR(M4vDGTI00?{@hX1et
zNXn&{e@K#Swf{P@{yz?o_NL9u@35n+=--qVnkDg^1B<2rLcU3?%=<C{WE{C3vBj66
z`D||%o=!hA-|M{2D4dSU`y4c3nAkI#HST6Mr}XbD{z3*ip`t`{LIMpJKBq0^N<e}j
z>m>3IJ`2Nc(^~BTpgS*~koU#H!f-9yBX%&S%0i7^?Po1bOQ&odzRsJ!yoJ|Q;NBP)
z8;K~Zu;hVs>vn98RWkr@UctK^>#cB+@%pv#M6+?U<2k=*V~<61dvCqv(;89&DkgOX
zlSlZ@d&^ao%6@Cgo1tcPKb8LFZp_UpN|QxruLAMRny3q~1_1b1AQr}JmR07p@$7&D
z-R-_|R6sV)l-II@w(;ryPqConA8#=KkQCA50jz?Cn{x*0%qn1Qwl)=)R<IzGAj>jn
z@<dcLo;K>e{f*qD%;b!eoT{Px)EwSLP&bGsL_Z>45?{dW)u6c^LQN$qTUK=^5yQ<5
zw@)`8LiW^#eJFDqVc@XdD}J{mr^f#a5@aM|)iFHjZL8-UPy5xGi>=I~ya1J;9(dEx
zI~bwCs(N8Za(yVBlBtz4bai!4!)j)vO#euKJVoLRE%+jHV&hSNVKKw=qs=(Lk^ub5
zKP*Z4cA~N6yS;hjw$jp?K}4-_jrKz0nnrO=`|m;bN3V9r8aIR^d^wkM`kIySbqbit
z1W)?v4?d1Ujeg{cz-yr@zy5)|?%Wx)u_UM9C2<4q7w+8`OPz|+Ib%=k`}mFL5fdZp
zqQwIp{l=np+KItdHrp4+-j0~B$c+3#=kj3cqL0~-%|jN|xBYN#_R7^S9z5$NE=$6G
zVeD;A_J?v*8|o|H@psX~y9v?5xHx)zG;r+l#46yY?D{+t<Kw5Qlhs-|F^0+qcZr;1
zE$VSPwY#*c>b1cH?yTg8Ll@#!YH7c=Ed$6?8ys;XBl+8&66eE>ol8zGch7a~PIeLB
ztQ@`02%axHGT!c2a9ud`efK=xbY$Eg<aDj4Eo?kFS4Dlrj)!5)fOFThk2BASs3(W)
zkAz^DxvTor+qN2aTb@g7Xh_rqRDa$uH2V3gr9--iMKX!vF)U9wxD<HHZ(NR8B05_=
z{;R|yuXBM0A!b2mgLK}6W6Jr$9aAEj=S3kKSwueDn7q){R7=kfnLwM`?ejzITVAz7
zfl`4cDG>#Q@Y|nOPDingR+)-4Eomf|tF91C;^yLvL|xbHnyr~dUT#goCM^7B(jLVa
z1GmIfs6H~$P2uXtpzq1!t?DT!<52U$B^#<H!QJT`Wb;Cf%_JuSt~8Z`xgbtX0{6Ws
zX3$vN7VZ#@d<Mc;$WO3&SH6sxOcY1dj=;yyGLq(mpB`MkPQGiLa#VaTt^1RX?Fu?C
z-e#rpBiix(8)p=QorovW%AQovLW=`9bJ_OI{B{N6OwFR9J4bPS#OHAXWnASA%!mA{
zLBz;r`5j|o7Cd(QmEi~AhNAxMm2XqMNy^LxEQfiE(;B9%PXDQxbB#(e-Qu|El&6at
zm5q60PL|f>B}!AgF*T;6=8a6Pyj12bN68Yk4A5znRw9+8CMuH`LQ+vlo5aMlv|@lF
z$!lVo5-8qKK@d2vo-^yL^ZA^$&iD7j`#yW`|MP!;&)yFlGsE`yqV5&y1rkGAznAUi
zovcbcyVRa7yMyO;If+X*8b5I9_6dwRWqJgeFMudZ{oMe!^c^os+rQ*iy3@>MihZa3
zas357E!Xc_9O6~-Ni|gyp^0|acgtEs{oRoc=lWAU!`!OZTAvsC0QC=;X+G8Js_y$2
zNRH#MAMFbGcgJ)-Qb;aAWV#{ul?t?|6UQdd_f_kLkCwy%^JJe{pW6zP>?bE|$I+qo
z?_BMsA$8vrm;r1H#@8XgRHN7f*|u;Xf3Ev_rT{)R(}@z#KMNR|EcdDB@0ohp3x27S
zQ`k{ts)l?PqqNFhIGv~xc#E%7(91NFY5-j6z-ns&h-6ila7fMUYf)r|(XMD~#LJzh
zPB)|k>&^yT5mm=0Bs{chi=@p;d-_|dyGEyUjKc|wg2t4tXi3wWRw9f3BS8wI2~THq
zMM-?CUB;g`B3rEq&p^G5L+Yr$Wma2wU(52PjNth`G+n<JT-0KIC4%pT949-WH(ngx
zJc05|c#&Q(Bz+92TZRvSlSwXn2`T89{`GxN?Ym9O0|xC-C7pdZ!qo9Q+qGzQYHASs
zVS&oN4`#91d#SQ1c+F`fY5F8VnxCZTfB0z+BAWTse9@x2C#X|(LC=<R7MrUsN<?%r
zx>E)tzusHK#=V-bJ=Yi)kv{+I!HU|m<QAndB>WVs6ZVe#xHz7S{@WKL4FHFko$JY#
zjk4!m$hy^9GUX&BsKwY$(vOFu$20KU=wXk(ikKL6#0m*h9)>TBZdd?^ycq~9fH&_y
zt!mA7C=or^G~NbE2Sojm{KL&!D)47rh{YJE*?UJg)~5R|s_iq3%*xV9PGsw6qW;^W
zh8&yZPRzPw8;0znoAVY~sF$#)n*U^W?fBX7yg{Rr@^<Of;cxwiKHjH0VI(#R{t1G%
z_rTV|kU{L6BbEl19+-5E+7z2_2dvEwZ$Twn4_7JD-j6<te6PcMOd4I(FA}iO{o54f
zoh}B7pLdvL*}13)w>7)oTt8+O9`kn~Ey6xjW4dT)=y}vN;uH*&v~y-71?&K{yXnka
z8s?B)0VP;O<+&#M?hUhlb!ll~j&FEwDO@b#tRGHqoSl+tFTN#(J+Qe8KjnuMy1|x=
zn3ppY8R<?PE`c$@m-Lt_bwr<<u7S|1&CLdykB@_rWE&<*@Mk0PLc@27U(E?B#^3^k
z>Ph42tH%ZoA#5N0VKjy`jDgh}MG+6Ivt<@d61QS2`_s_xPr%r*hTcAsXq$xFO7kSW
zPL+S>n^oyJ*WUG}qtN|dc^>;|BS-%5mRyz#%nn`~#`r63lY0<Vt#?v%cy?o99nJ!}
zw$)}(Jej>6S(8j6Sx?7MX*K{(q&t1p?Ry#_jeW*_SX>fZ*yBCarS@I;*^dy<oIH$#
zezG?k@iB8%k=M1FqXvmejJw<9`&3Vz(M;LHiz~thM5G7X;I~7oD9UG%<Jk%43|KCF
zu+1+TXN3bn@L7>NeLL3KNK<u9GZ2LTeCMo92Gc_w-(Wo?#`ZLSFCk<vaJ8al;x?_k
zSV5!&+gFj5J0n}lJ;~713*_H>i?q42oN%b7)k^L&(a3(1$uQc#?2-Bf&mG5e-v;s_
z4j`EY#l}V8dnfw=I|Lh#*CNzTRH1i`HnC;pWOhc}0dxJ-@)lpLbky|b(BqsntcIHk
z!LG=v<cJBS$!^3Vm(+{cB0V#yS012iB#|LT%9^_bUgoGA=bRI`o*mgI_J?a1Elj7G
zZo0PHNPWG3IU-p#Ua%>Q2&ZTVR1y7DAa6e1*>Pu+2+fJgh|heCRKY4d=oV3Gi~QP+
zYA7&927_SQ*sN&q^L9sSq>!5h9PuEG%ZSVhJo@m$zC`dX(apD*BS@nHaaF4&dK=Hi
zY;haN@9dJ%`<~-oqs1nMU;o5&rDh|DDs<ucVF057+#@wOHW;H*E`S#Wu2#tlFfOv#
zps-z~$2!-hWK_Bj!UnbjX*B*+uF#0YL}T+-^m5F-Z)m}9cFy~pc33|2R;Y`p71EfN
z@TLAoOaB%&AQ;psbhk0+<=g;dkjX`kN~1m&yx3eqv_PMIq(VUz7!w}H-)1YwFDE-P
zK2LJ)D!^R_r{?W3#mokqpCd|rV9q<|MkKKMWiGCn8m$JKfIOt9_Uv55W`Df!vGmjW
zA?*r$Qw6^D)!cN^C(aq(i|Zl_DZN9bl~2U4;M%*ZxHgbPTxguVetVvxG&f1@SdCuN
zu|4ZZjp~kA$gqlkKu5}HdJX^B0<BSv=P3JZeRbonE*BU@rT4%<&bt&0wBF}t&#$5Y
zDHaGK)FJ4`+U%Z_>Q|D0)w!m?XQ!a%gw(?VZKQ^Exx6YigFhYGp-iG2+&;ZFWnVV~
zr(sc_oFLEIIg&O^2xK&;8_ZZz6hDL)HY#E$G}dQDVyQmJ10EKG(PT34%Be{;ry=l~
z_Qe3VVo&5P@soA)3&8UY;={=HFJ;*>%NY}j{nIRX!f1IWUqfvduLvK01WNK1JXiik
zd4sZM@|Q)@)Z+DfE3H6DTQ08Wr8sSKcqp2y53jAlVqAAxNAG>Z$cH=9e~B50Doe8e
zI$_I3JLev~y+*2DjBCI&S*;Xb+(N3kfnuMb#ftnfbzZzU?zO^^L*%@^yt3xtXn&=@
zf0Y1wDZ+^aqSoY|2)Uc)b7Sfw_xy0`^yt!q{<PHIUs5ne6z_}ELfWsIiGQjX3{JB|
zF%#-^gop#zO`)ZMj@$mY{1Y9w7%Q!GWex%Mp~4BBh->noEw>(4-W<3fZiTuLCNjj@
zzdpHhAwk!$Zut$>Q@m6HC#0qvLTJro>zfMN^-CwRyt~>jY_eqF1eGOmI5r8@a8QhE
zh?_2Q8^lUhtW{Tzq(1UYw-QqX*)LXN8ZWV1<{3g2G}?0P-`sfBX1QOXeQdI;hq*_b
z1}mOG_m9_`>EKqj#$hokpMJg)nX7OnOs&}MyzCRB$Zi9#^>D*V){5`qXZZ0*pN}9%
z2bWu&gEcu?iDavE8{Uq)QoQJlmoStv@!CcRN#DpDGx%N_o4S^V`k<=upbwCT98{F9
z7MK>h#)p1Sv?P^R4qPiy8>JnXIf|AlH2uY7^~>o}lq2|CD(sO}+uF8+$Gr$ar_`I$
zwt7dT@$ZRPWyG!Ip|1>Y<RU}(eWxJk<sYYKk%o~l)2_1D843*DwtuC5Bfqke3>23y
z3>tr$mr<kfVx=xcX(a`~ww4@P73#umh1^IhDG0d%&F%RX_~*V=bVZW9=4GdC;@QnJ
z)~NivghQ^(nn#W_8ko1^HzwR`-}cC@Qv%mO`|&VuB=n^paF!6!E#f8eed*#10y)ur
zaN>s_5R%y8pC~j>zUY}xP%Pshuc_apw_7;v7u+8Xs(0cQyqEso+{iR(JF&NNK;HOa
znGii_*N5v0B|_>pkV-Ch+SRCVwAI91{RBz;7HG9_HexGi_B#r-?6c;z^j;<U-Sexw
z5nf1`i_fL7eH#FHJresDyaqToVZl4$pUn#~|92k!KO-4`A@%N0<(9^Wf8>EY?~mVt
z0v%hsJJ2Inf<J@<EzY3?i7!E6?a8fkf0ugizQy^~RTz^2c>lk`_hhwR<Go*=&ZqXw
S05?}_cpmk2t37h&w|@W?^Ik*%

literal 0
HcmV?d00001

diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/pict_2.png b/clones/download.racket-lang.org/releases/8.6/doc/guide/pict_2.png
new file mode 100644
index 0000000000000000000000000000000000000000..a454c2a59a5d78053ac72f592d2c7597f88af911
GIT binary patch
literal 27932
zcmeFacU+U%);8>nqaG_`0~LW8K~ZTUO{rF-2uP7m5D*bUkzPZ_aX=9P0Ra&RBE5u2
z7f3)wK&3=V5?Y85Admo&5&{WHz8x6PIdf(_&-2&!z2Ezr`{y4axwG%R*IwmX*Ip||
zT{FD0bK9Y98#Zj%sjG9zWW$CZ&>J><fAb%k!8^i^XD)2m@Y4p}OXtmk(x-{~cWfvb
z%oWmi=Qg0fN1N``p~|McaPKd7mn<LaOQ=s|UdP#Zsd^LK>)fgfdrLye?&zta;f^DN
zg;Pa^&z8)Fl#~#G31&I(y$54UCi@Z!*)cD49_AcR_`Lt!O#83jUwyD4s_o}<hr_j^
zOO?-uW5p*0w8Mfr?>bl|gW2$}{5#h}zFU9!OGe+9@7G@blKpaI)B2lN9GbSTzlwbu
zDYX9TaC0K<?sg$rOH)(RaogWNzE;3n{n8|0gyd{+30fcVwegO&avzQ4g}XDa6%BN|
zX{biXNYa@^B34c#WO1@9`%0YX*B8Tri;vvJ+Jkk;0Yba(OJRPvQo&xy{kI#|@07BL
z(?7I6`sd@<LnAGI`mtbf&*6?)O3FWn`uYN8iz&j~CrD<7nM@shzCkqZiWYAL>p`1i
z#`)a#@*;%NF*W0@4hZ92?F#9?1xF^H!rs|4ad2>JisHH$UK{^!1ro7S?#boTsZU&=
zB|$dd*xsX<>T+iD!VXCX#E8V&;MzxnPGUAp??`q&ad?+S$iZJ^o;sh|`o}x&{8PRW
z3g~Nskq*ay{D;|J-+CszscqcH6^qaqsDh@fhBrEvJ<ZF@Tm1ZH<K-jqFP>>;8hLnl
zxOsS7zj*Opm}cgXXU&oL2MCSOJRnh5SJ%R6+CZnRYzhR<VU&vzW&(<9YppsuI_5(#
z2{~*gox(VrGGB#6BB|5UX1=}^Zcu2_)niq!UKK<|ZQUs#AeDOc7N;&bS#SnCzbQak
zuqQ(;P}#0Y8$2i^B%~LI%dM+ZwMxz%A9pq|FmQEum!_=FR@Qdp?x~QzPEv0ST6Mf7
zE7tDo`jpZ^=|8oD!DLc6E}>sO-%U<QS>Uc#J*9M?!bZU0yMFkdN~4+b=iuh{L`OnV
zOAFQ2WvmfAFA=A;G67efs10iO9a%sJ(jlAfy;;QGB9qBLx#CCXf<)o-9X$7T-?@Np
zb&IC(H-@P$SG<C7cszA+s)rVkSYKD?H~Hyj7z1bVEInQNRp@k|JcGe-hLzOU+gyn~
z+!aWI<%cq7ll<+L&xeNA18MmyDJgw8_2^Nn_LVCtVe-lIRY25YVPEc2sZ_iM9*@s!
zXwU?Up|#01wugv>f_cXtK3hJL=@A@Uo3j&DU9F5^;BAUfD0`-*mlw*~+Iq1=g;Wyy
zs1}*-mO-h?v}tc2zZYDpi93UpO@a2%JD@R-9__0dX;!z$bW5i^0Y*a|PqFW;D}}L_
zTpb-R*oUt;cL{H5_hl4L1dARx@SYVNMXV2`eHm$DjYi7>fo1ycOmjdK8|6+|4RG0;
z)LaoF^&`#)B8P)1BAdSdPDV!NgQ9_fkx_9&17zdIjbP7vKO{;rTD7>w(b3VHsuDls
z9Fvq(l9$h_tvxFvC)Wn_rLa)<{w@&{C#P(_RKS~1Kfg+M+FJo2h;F%ew-t+4R)VXl
zt36i;A?l(y9PY%S7`LDx%f!S)u;v5;?YfIg{w`7Vg2>3t81`&Ei$jN_ZYw^ks;I2Y
zxi27g3nncXJzkaUJ}@w_I9pHuI1?asco%IL6Z$M8Bgx@_+wI%eEG#VW@V?VEN!L3T
zY^T@6W(dUg;id@zWlwrZA`tSy=s>Oa`#V7<YE`e3)%Cl95p<{7IXOAi`O}gG1qH{L
zY#g}p;{9EP6&0qfabkpA{gio_YWGtL)eN~1_WAYQ#ajdpo9Ry<*0_9R_ojR2MKnUp
zfY4N7tV-^3tCk>xew#nK8zOfGWB;;eqQ6WS61p^P3^spH)Nh)+)rG~_aEU!#LiS-<
z0-DR`?w&gb#Jq_ourl73QW3s7)sufnR21J|;ezYyE4a5spj7xX(pD(^l!8Jws)41a
zprBxFYikB%9llhN>9Im+A$zCh6>bp_Em4~Z2@A8`yLT^tGQbb)I(+82u!`r+8EF|A
z4_4FlEMSnsAvBp<qGwD@%v3R|;iDzFxA#e8WMp}`jIWIqP8FNmK6DE#_Ik{MyA?i?
zl&B#Z2ML)vs{3)J?P1I*EUx$v#VTQmPLgx=uWneK*SAVO>gw-#%f$t_1jc-uTyaf}
zMV_l*rS5BW3zS>BOI&OA-MioEb^}fI8~>QJ=me%0vNWB_pL`)uF|fP%&!2BVpn5<l
zE%-{=0F=@jA;Ol8;ai)8M)+zFajF>XV~r;<K_cS9&%x?TGwfzZd0+}U3D2HA`&d^x
zFksE!x5iHL+->G8ai9_2SXW;^9#Bt!8Js%M3%0q^i=?TfqT&_ui0`QSE3RzWb@&>v
zIaM{a>mYJ{Qf+ha^fVL~7r#6s3%s3_lvEvXBAuZ-9>v8$-Q4uLsk0$xXNdI{z$ZM^
z&Sp)ddCk|+y9ZE7PY3l1@xijr6Ut5M3fPE&k8~^sgYl^+>K#kG>@j*8+wPmCmqBT1
z(bg??3CvZl$Ln!6+&Z9**M}&-<$vR(Gh%RXu!m{>aVdH%NFC9zU&pOs+Z*svK=BxG
zROv2P5F=ociJIf52s>3w#RBVzZeCtB<1OhY3Ta{X=<2{?f<LwQ1kgqf0|ieSoWVm;
zm}GhPc%4i3a84CM6LzwZgsLHh+lYvW9E<^aP3z9pr$shmFm{rL>DMk^Y^oz$C+DWA
zcnPiwCuW@V-*_&i7|re|^fCca`D5@2XXSPo<?=3dAvNEX8wdq??9%Zi_Cf=UErIOp
z{P<DtO{??TyM4D2;_(mA5U)-vd-mJ~uM6$!E{=$qcqqa&t>(kc(-e(5lay2f9)I${
z4!3{+WjgsZHub4XsF_>i4av?5aTPRv*jARHQVD!UbMs}esZu}wqpx~od|{<`a8SyX
zp^JJ~cOmOB_;>8sF~zfIPoN0J*N*3~SRt5&PBm7O8234F)D{qwMIe3ny2Kv7-GQ4y
z9IAZz@;SYcr%5bEp$NdrfOaTpXk;`PX9E8NgJA+@29g-Z5}`*EbyM@K$^t2Uh9+vC
zgo$S=^76FVOEabyFJ5d>>)ppT3;^ii&5di_)G1=5LqTz|KCpkET3cY2z01o%c&;I0
z(DrK26SLaDw0=XM4&M_BH3uhBgNIM9gu%m&fBNy7zJ7GhsI1FPL@EUdgc=tcTLfIF
zhK2@kL-;zeA5Bzj!k4D4&I?1@6&BFf!4Ph@_C#IkMA@+|fBNx#Xj63XEkw<Q+@<XS
zRCP6<Cg@D`ooul@5G}9U+uJWj<H>XUX?0UKUj}|+X_hFJiOr9XkN2nNSd{t$6N0g4
zYU)Cno-8L7ui;)JILmZ}6P}?FYF=h}wUNi6D}?VQl1M0ExguxooC6Njh)2#xp^Q9h
zY=F;ZtuA0I5UhrNYnir_)ME{Xd$&b&H%1LimZzNi>AA{qkT}^X+1WKH=+);?SDjQ+
zPQr&A&E?Pc7FEzyoccgIm5M7q2yayj_Vjf~w(w9~cRDT;!BS&v&dTLNQnEI{EnM$b
zU;;J{6~PU`3wZ;BgCJJtF-dUy8ZQ!lbo2#4GAtGgXhpG(#EVAGjMpZS6uwyAYA>V@
zJVq84#$zdMA;~iX3Q5~)FY!Opugdr;F)4pmnzNPg>{9+P?0FwFo)g{}zDgEz36oB}
zO8uB5RR`yVH{<#GAurKQjir71^qB7kft2hT!h(sspN24@7626(8yLj=`sR6Fe*RJ9
z>;?T|6?z-vqHCFp=!}HFzrSku>Z=?auZ+K$cx-el`H+|x;qBXB0sI2)xvs8m-;T|E
zzm=DF%<k14ho*xe#?;}>34WvRwt^>Vge_kK-V$imwulSV*;#zn#rtCc^$MQLABK*k
zbxhPgNgdp=(5^lxL!x8lz-?0s4#1Uf8+c{lfJk+zA6LN61=$M8L3;0Q+_Lyl3N?8}
zi)GwG26|i<!f<<&G6{TB1yMPTl5dom$KwGAF*VVVMmtp4)|vZuBJw{a=E1zh`*L+=
zb$_T_uBCJ`SLPm;VhZ%@(4j+qtIOV1H8r&P@wS5-jZ6JOcyZ<|zkPe5PD@j>VRp_^
zIuC3T-%Eo%)IzBG2LZGiGCvjtpu~1aqQilyngC)H8iF#+P(2ECwYIi)@dQThkcbHG
z)2B~$UJ`^-yB@H7KLE;r7pDQtBRe^;Ql-KwMj~+_a4N`R4jwwxUFOuv2XQl`Mtdfm
zWRzK2mq<}g$xv@I316`N*zUn!)65e(lj07-Lyy*B^`I}$3&;vU3>n)}DO_&2h-R3j
zY>NK&?c0GhKOxaA`1Uj1pZ)CFA=pBP%BIGPPTLl2RVRWMf+5z{-Q?CdTu)DSiha11
zudnZvirt-h;-LcvbV#8(tdTwM!%hL`Us&A(oOp)I70;mD$d+**fEd%^@`a6yy@ofl
z%+1aDknd&~A7%1gF$hTsA8xjg$E__&0~2+KPd$T!&r-^=y9xm8R*3YweOm{FOmpC`
z!sin+ZwCik0fPiVusc!GXntTku+~;>DZ~RrUDJHS6F>grwu8g@OgJ~VvvDwHHqo2X
zDFVa?9H0@1tunWP<521D@9!^RrXD<em>(v`7$IOmiQLUKYl2g4GvWSAa3=48;7nY0
zs>4`{oVc<J@<48OKyDWHu<QIuDIUTBNu<tgyac2+9M1Nb8OGQE-NLUdP!=E?`Kp@x
zIJm)Q{NW*C;r%-{`_GT*0<b8xC#s;V%vdx|5|&MCX=(XY`A(|KM6KDNYvYalPTyeC
zvC^yf2J-6xQzqmI3t5su7gbhPPS)h0P$)U4`(?JYkAW0_aVVU<JFeBAyBZ7tubhSs
z3<l%dUuT9|K9J2vI#a01Jbxiboez$zZEUIlw2T&#a|2L(a`?-ampM4Ql?#Z4s(hHI
z-w9{x0IRC;u7hX1$$Ryb)4l*Pr@E*;VR34!tIabqG7=uvTfw&R7nJolc!|wX1$vZ&
zQ+RK`>anuAif-VtpdjDD<IN*3WT6Rbq5SwF+ZPBZV!M#ynKK0d4+B#u0*O}FZL@p#
z?(tn}4}42RSf&d<C|oP#{F<SPja6@gdV0!ocq)pDV`$zvYF-3Xi?pi{ekMnjtPgWS
zF4pPoj=FU7S>Dwivr`AmKw1K#SZ-&hAz$(!8G&;bGNbF@QKkU$WvKe=fjrO}0>L*&
z3+XpZz-HP@V8!^364;frn9d{m8r9VuLl;hlA@oygJJvLJdYQ{lr4B}B1*w;U`0;|k
z2Q0ZK{SawsX+4eKVHw)MQno+K%(MXT1VH(Dgf|Fuve(N<ndG@wo<py)0RDV`YRAFI
zc<#unvNCy?QC2SoHqV!cP3|6m^!yPb!I6Z~QAd_s77{5#qx^91&5MS)ai<wqKWN|q
zDU57=duJzgmRQefv**6RYVmBlshRnOg@tdW1~pB1PQ>BiQs7&_Rtmyu+pM7^tGve<
zV4D$|NBy${J9IRvm(mXSMmzq~U8cM(rDF>NT@H(i%CdT4QNhViDJJ_Auu%Ae{>hs0
z!q#oIE2qHLuHBdH?A#t;WE7W!J18}l@jcMX;9@gJzFzXNigcSE>5DXDR#$GI!Ufzz
zy3x-OECdnGkjH}#CP4`1Pt(({dZG8Rm$D7X0riYdHF`mI_C-Fr44QLni47^+(ew#;
zX9?u&Gog^8+tiv0J3G6BDl%6Ki;MYrZcclTZR%hK@=364z(jR<hdSLo00y6(oYdic
z|Kds8LDQ!cu~XO;sQ?6FSo|nKKvpwTj<eAtOL$lNg1}SCst2wy6U4S%Vw%#rd_eog
z<)}PX>jq-Rl&@iDu(3m55^@G>yxPj80eS?vs*5^)co;E!<`o}_pfrG9hp)8RQ&SpO
z$LreMLH5lD`7XB5G{*yxA)%p+0Vqn>TI2d$v*{guD~sG|V!aB5<FBf!+D(`nnA6h3
zb&mT?jeSVua|b~Ef#xk}=2ieJ;&3=tE^U;BDP+yC2~gY|oN!;`?d;m5C*Cq#zy=YJ
z?BzK!h-wd8$y0%Qbsand^GqhJPI^o{rCe?IodS@$%0#6&GcBzRT9F*w`A$8h^hq!x
zHC5Lu1hX^%1v%mSAT)q(UJWaGfZYIl)kwD6wvZkbENfRt$}~+GZa98m2USvQB?_<!
z`*z*;2bqI^W)mN<>RWu^d_Qrv2V|HT!2)uw46!T{oQHt~kMG~PV+S8wfi$cLY*Aof
z4cNiHK1)2QJ+GAA*+QP11YDMC$YQ|+g;E6|=cOZAAb9ZEh?oIEAtC>jd1o8K^%Ggw
zbb!0p;WdT3y6S?61BekmdjoXnj@P2_>zk)f^eDD1%^r?)m;|zS#<y~3>0DWIBaf`b
z6(@_>=&cNZL<V3CU29AhiNxcOD7NJ8?gUNtbj2b(e^@p6#*LqxssYRZX4#$Jpc%5L
zBOt2&p5-z;iA)CJq+w-3I72<ygrB&B>>C8)ai7{sC_xsa=O4<Y*I-V+lbXM$uP#PL
zd13XQ5anOOx3{6H=lAyZ=D-!w=#NeT2v6y5tbP()Ev;`+YTH$4nr~)dk)O$3%;zH>
z0M@`f_&UKuV7$pKb&Xpl&hA~XWf78rM+H963&ThT;8h9GIRGgDEDv;1w^%C$HrFg<
zB{#B`TI9k#jxx7{z0bP#zE&6l@-auCPe4(CA5GTuP>a`@d~<J0UBHa>oBS&6Bf9}H
zRSa@?fJEHf-P?oI0pkE-CxEipmFgOsvQng?re-PNr8a$k*Pj5rl5I=`h)%_GsPCnN
z6~0=v%3JMWvm;=F%%D&xzTeu?@)Odgrra}N9O~|V6%K4-kwrs+<mBe+W=X(B)YBV!
z-o3koM-iiZ)3#TnH=5k?lp0(!!ncbI#s|Pyq+Ts$&$yg;O1a+d8w}D)+S`cjssYna
zK`_D*i5YXtKu*AA8ZQdSwlAEVs8vr+PObz|3gE;?6>g(*uOjc?_Xix?3zCwdBLZ0d
zsyh=Hu`;%0^Y#HvsgBV^Bh3$N-<?hT`~nCZ(15pY-SXLG@iRbZW;QnbBmih*ZthXQ
zf{b%g(AQ}LCqa<dxpU|IO4#Wg7xne^x7}|FZq&GKW0N)<O4qQ#o4hB%tGsJ%feiU*
z2%uds51`o!v$YQQ&;9hcVN1vAYS?i8F?vp|hnE*twSpgVjshFIR;Eys<iSsSVxNL&
zo(?AT{oP;IdAn}<r`tmOK#>9{832IWK-%u?d>Po3p2VJN(R%=;Z7(A-w+FmcS7Yr!
z?Q1LF*6_2BCLn0^LMRxdHNo7<%Id^qMlW6uGk#Jz<?6BhyYAPl*8J2g>Ll6WA=~cb
zUF}nvN*R^M4hk&Ts!!D3iPyQ=R8t_gf9<bRxm@>T0YDZ4qM?Qj(AiUpNZCllN8ego
z=X!{6pIiIsf8&4+->PTtISlxSb;7$Z_5ULxIM)sP#i!PsNgeVGjIbEJ8g=PH0t}0C
zw%Yc?_tljWY#w)pyU^{cjU|8J%5-;HB|miu8K08JE~fW7A*Rk2wyO8|n#2X?Swumk
z1uM#7LoZ88#8Pt71=iQKVepsunR~X~|5*R?FS&j|ZLfcNW}7f%{nec(MZ_<s4NUV~
z%|i~xIx`pa|Hb3~PQF`|B3dJ>%r2cdT>9VWd5y1!3-9y5O2ML%Airk!b5{A>(N`LO
z{Y6r-i)C^Wt?ciq|1EXC7XGgl#$Vta*?Z@%U2ZpTUIOG8AQcnFd};yfyMJ4R;;B<V
z#pPGR6zk(mOZ_*lY4`JzM<rtIflV~PSk(DaVwIP}bc@q;0NL6L*i-A?lQWuzwfLQD
z_x@5Y<=F(BJQcY0X9z^Hgk9af?)=Ops9&XV*;AVYGt<ORv&02fvs@|dU6iq|34nK<
z>1V}Lq#6f*!vv*Yn@?aNjc~VPJ|dq=oX9%VAzbfIT#nGTlT=pktb-iS0qLodvhv3n
zh+W{3_)j3sD79}a?dlr+`uv9{Jez2M%Si-mL{;Tjmshy2d7PMvN6?eu;g_1+W%Mfd
z6^J$d6YZ&J^Ay$CEBdNw%Q4SNT7|>IEitO}6-)1x3Q<YoLXaQeE0mNx(6e{Wlq^uN
zQlfJ1#I-eUD0o^T3=u}O_%WzBz=WgVFwdS2S=~dTyCy9fRr7V;WxHSzQvk`Ng&R=M
zh{{aat`gEb19VN!HK_{mlGGoTs2SE#<|c<~efe(}t6WwKoK06ptP*|~;*2CE(n4L7
z0FIC(bj4tP=F!o^=<Mid2yC&7de8)LKj!M9*p*snoUig+JleXQeFh>!y*irxh<tOg
z6Olwn<JDmxUaa=gj<0f=IYEgeeE$4gx($$?KgT?B50C7Pj=aCIF09rj*?Ee^pq<r{
z^XJR|SxNk_aeH4z;ymmO#UzQ_Bj!~rpmuUUUJGPS&;nF@6rG<P`+7$CPmct_G1O~C
zb%^gcJx1*4Sl(>l6+qxT)z;SbX<$20&v5Yhm&GVL^MQwaGe5n5FCcu2!)Zpb-^Ys|
z5*`d98iEtfsXv^4@<%QzPw{Png6uv)QPq0c%H%|$LX!zHCbs8hj36xiSPT%Oyh|Wv
zxk?x*yuLGorky)c05<AAY*t32IFXL>f!fe)@~eGPtTUcc)w5@0E#_ze^(yu?J>Zz<
zKTljmF-6k{L9zq;3_wJg#FQ9st|?*H7dnp{B~ggMXwb+;nVLxwumil-gxG~B3Q2*>
zZW7S9VM=DYqdnJW;J%%=0#HMSHT!OQ{`rHEKkF71p5RL7KYR8rFEdfq&_wC7n54t%
zm#QhqRu`9}d(u$<n!5fW0JHchIkBFisJKu1<ZzFIq%Jra;~&hXFnj^5RRAojYiA$w
zxsqA0_e5`^W~{SSF{bwHrhCoEP*2Z=uO>UXc61zRaeQBb1ZPx;5Un|?wc2!pFAQ6i
zaN|Yq%?yDl^Ex0re}P?|4PPg3bXEnudGluA4#4gegoJK~>%VVku)@r>>;?I+_?6hP
zRdla6u*QAnUT<1cuV*4&k#vBP2#d&2k<u<ME{w4c6Eyz0{)P>&m!9}G0Z=pf`OUqA
zoH#8_6pM9xxGOTU0GQ#g5>wzbZa&BdayHdFeE|`-|2k~A(BiGc*IIzqs6#vJKChf1
zpE-zGpzM#CXq*LX_;#Ur8<llISLde-LlPFL#V9_35DvEm?59g`#uSdAQcU75DXfHf
zgTppzk_DuH5o*#J)rP{VH(u}STfK_1VoWJ8z4oVg5xu)HLAIH&B`b(aNC(KUE3lfT
z>Ihz4M!TXxYM$<YMBJ`y3xAA(k%Ox5#G}qkEmUgiK@P2vdp<=jkQUge_98z1ShJ(2
zZZW;3uSX$2lNWYP(oj8K0!%~DuZdaJx^j<g53C9wKSuA(*<Fi#nu7~;N;i$$9Fs|l
zqP>f3{V>TH5#W=Y@#0rNVj)oz>Q4j!2e4{~05g>+*^C@4d{}$<$v@5R>kBWnMP(wu
zMYgQZ_XPZA29$`kzE>m-A5FcBD%+{W`;>KYQ|8Z%QSX)nNyQ1xvJpZrIPz^zRajxP
zv?way;?=De5WK{U!4iusAi<YGVp<o@sRQ;~iAI+Ii*og^C;$m7$k+hkdtz$XVntL^
zF#5yzz?X;Z<)wqJ-{0NvXQyy|>GyJn-|H!E2%jp4-B~crS>M86PX4Qa;;%r}K4nlR
z!oNUa12~@L6Feo0rw_ONb!me}+)ilWgF9zzr;eU^_E!ZJklGMXAMty|#$y8<Vr2h6
zemME<x(e(|X(@u!S+VswY^eTDd~i!`&hGU;|E>1p@2USSbx^w_W$}NO!bCb-S&1#%
z^J;i)4=<U!pM7s`X=(dJLaCQv5p=Zk=3nI~E-qL)a|*ta33t62Dor^E(Qj*OE=5Y)
zmg2OGy7kPz{XMU2OtFES>ky&7{uk%pt=)$9=F4PcoW+a*ZT+2J-2b;pW3HPDV6E~L
zm6WbeIiE@XhBb={<4tyV-LCA`zoS^6Y5(VN?!zcr+VOj`_ETDsMpGM&VIHzI_SRo5
z9wcZER_6FE-0>RTE#2;hVPf^+-_yXCP4`BOb-T5A)XYcjabD31=wA(D=7WZw*<1GN
zDVk4>KZ$8O)!Tjev4lq2Rw=@SQ*JK{R#eP@I(S=2sZAnW@3w5l^#)bGd{y%Pqh4-`
zsWDo)qEXrAo`If(Oh;#jg<~+^tNdc{q;dqD$TGUQ4KEr3yj`s>iW^DjdWq63UKXB*
zD{WCyS2q5bQ1p;slg)&O*(NNC!Iy2zEYY7M+s3;QpJZpKx06V8Q&4==>t`tt*{U~C
zBEREeJ}JatC!>lbCe&cf3@RwTcsDOnNYm|vsL|~c<u3}StYoef`BqH!#owd4L*vf|
z*)SuuPh!$v^v|)zs!};s!DC-E{i|xIM)tONzo61R`akd|>;61vr(E1%uK4{WK}OYH
z)1IlFa{Kb}^q#4j*b|?g*3R|fhKnw;Ll$vKbfvROre>k`UNzsxFzVP}yzw!`#QFhT
zO}!L_V3V91FPT_(I>@HW!|&FoIEdIa-<P^15<0)t=$I5HU8b4lOWQFV{=9U_91}A3
zoV$uk(v#c5pTd`46O_@TQ8}fg;HQkTd!eCY$hpa>MR&YGN^|bG$u0~TfR;c*bkRAd
zd&$Y-r?+@PLjoWS|L~oMhx0qD1vA3P`#E!Rq<yQl^+Z|zn>o%?6PT=>T7lsXx&oqc
zdFHv+jYcBKj%~_H1^M-+{{B^UU&cw*9plfc!ZQz1-L9J^hAxW5Jc7EZmQ3|iHGS_B
zDEL%FM$dAO3)Ri*dZ0^M%dxzZ7yxSkAUbr^Bk1U!t#*wIKhd0ES+c=U^=Bc<X$!vB
z&>9-`y@zj`9ZBt_z&Yj%(fSEF?>|0lSe_`-JmY@>sL#&B1Nr(SJGlblAn|A>p|~vS
z#AS2khCssTe7Pq{48oiv#2)T`gVAu?sa#lJVUSHW+HQUE=-Ki1V~|W6+6Y+^%m)WP
zcV8<-e63s|<7v%1QZtwf1c7709yXIhSneFo^SnHB`0MGdGs$hvx1EpX1s(Z0ZV<VI
zzlFoGD)+>=jzzTL!-fx4RsAr|3{KLKP*SUTOo+*+(cEyo*Ybh15-MNq>#9h7IU4mY
z&z^RAM^%kdaaO5$S&%LE)>~`ahhuENn^h{6`U#6cen&9<NeNev`O}8QF^qxT5p`;Q
z<7}H?q=GXKfeV~i<xXV0AOz0fHAMRMCV&bjFAqHKO<F<@s2Ky(aX!%PBT;nobnPq@
z(0z6@0@#IUH;yL2aVPg!8UJ*k9STwRtO;v4R68WAn^2Rd&G6?gl1)vqm9HvGzz{1i
zNG(wodCBQv>t0%HhP;<(jq0HF7&Ex)uvOQ)-bbL=AVhO;U|^rS+qIX4#(<wz7&+VV
zn@VPl5XJBIa#>!U3!q)Arw9|`#;?^&l4!LMHpLD~Tu7qO6hxy>B6N<&E4l~6Camqt
zP#uMZCpy~OCu1xiCN4J7KzFLHy|wbL#s3Gb^RQw@868rm=D#|rKVMoqChclf=S|7-
z9O8`3mrO1M?o?+?lr0)mfs&+HhS-x<a&l#el{s~b8>&Vd#Sk;0&l(=oo=`LI{Efos
z2vpgJu(zy1G+awz3Cv!1f)VRl9p_#Fdnr&8z-Nv;>FydRQHf&|m*O+$=CWFi{5YOV
zZ5_&{pmc(<qV`@RwLScnE|u(=qCbP|IIBg!yp!SYwp9^O<HXP}Ix`|7myz=EI&Npn
zU({JQqLmPfq!bCxqNG<FIe>y53A95R@fe)Mgd7qlPD^U;ZJs5SzRFYMMf}>)5!}%>
zTN(hiJ$@11I6wa#W`6$eA{^V^IR)p9@scI@pQNiG?bW<My#-3->=T5F?!%Hx3<hu~
z%F21*dExWf1YFlZdRLITa+W@c_`a?`1!_oA$D=+Jy0Dg5m=a&>mq%pfiIY_;`DJA#
z_7!%J%r0sAY3q+r1zcK?D)Lk5F2?Na$EP(HoNeq+{Gt5TE1y}7izLk2iBS7-S-?pe
zTs3GrwFCIUqN9B|cbnLiFDr9Kx~A#-2tC9?qTS5144Y5ydMm-XHOpNfvqqbq8Fn#-
z;cp$Kt+cvYQgA5liUv`{ZI>dIli140my<=Q*%Tpz8PaL3PJ6+3uPF+qkSNzfq1S-B
zQN_crMP`+xFsgn?^P_e+`PAEO!^+*heG@o)TV%&~Gh6*X(3ye^btNTyzRIRslya}|
zOHST0vX{;5DHhMmH0e80y%X)di;o=V-jb9~H#;Ag*Mf6Z>ZQvqw=6ADKQ}a>C!9SU
zjBCVp6xY<70%z8eY3SnqTpecJchog&c2`85s-nCS@`H=Qe2Ck=0bCYKwQ)Fj;kw3w
zkQ^S@zO$gA)G+YAC^)q)I{T@BFGs&XHwRZM5~(h;Yv{IN{XiP73tz-E+Faf_Wj;7v
zwG!lKR-^KYWRr!$#&=21hd}+tayM3^HCrKlk1J?ZEAGlAU>N^OrIgC`O6!+|>VYqO
z;e&dTTkfL3YhIHi1zjd)c&MULa+td#j9c7ub@jz|HM2XX2DYdDBf$^Yj9Uq+=V}ln
zlgF^R?4*T;enzt67PARk_-i1e&^gieX$S4uH-gMa#8=su969}G*z60c;fpV04-e&U
ziEF`o{D_(Rs1GE52(F6ctxl*N&CI;M0KSk-P7I;EE8e7eu^5ktFMl#Fvd=VGyjU0_
zhj>#Szl47-;p*ddi|A|npoz^M3u!o^qPbF%V=lXe$r#s=Qy2;E_>F=)<Zgl_<;P3z
z4LP;ibnJa^ui1I%4uAj2L0X_6bA-Iu>NzajZ3LgMUe!c#^MRy+&!sYj8u1^W1r|<g
zy|UPNpE>m!@t7a-ypsvqzO2lY(n<O-Cw_@O^+7d%Q|O3vQHT4|Ko}YKoyOtL@Z=P;
zWtxKjHd<fLK^sVBN(Ws5fi<yDE3`^QSZQ1=t2+BrN?Q`61QXWBVLktMXN1WZ9yAw*
zD2%N5yXb*~{Io!^qIzEjL`Ss7X6}+Bu`1nnA)3WqVx@Vh;0Y%xp^S1gh)~$&EESvz
z2(=bh(p0U}aM$dMBbvo#n=86F$+KFAy6$S!@4xMSEfji++=BDy_-<3$A!n;(Zotef
z))wj$5Y{wA)2<l>QjTFih7{_*m2MmO0=Zhq7QzM1^Prvu#YqxJlSqv6@Ju62q1L@J
z7AeC+W&qc963}lVgt3Z)gQeqk#gBvguV&HG5E*TK(+N4ZrSr1lB|}`{nN&AU-8={R
z2(Wbkhm^%09w-Ke`6e%NQSH2^ay}^Ut_u&;2@MHw$>_OIOPuY{a*gRg(5jQ4*Qu)c
zY7!zEG)>`R0T@kt)k-Z6tCC!mYE3e^$q2UxF0v}zzKibZ%B0=<nwGEe2LT~oHXcDS
z1~=i7jkOWDwx>Iq9%Cuj)!PJ;#L0=}<wGgQtLF9~?0bh+9r58ej~0D-`>XZ$25ug^
z#)fnXPz%L)dWuWOt@Dc2A?6mQ7hx@t7VHK6jhP+4RaK^Qj`cNN1~oOE=>yZUS3itV
zU0&I)WOk4jkh3}3*(-LP2i)C04Wa}}*g?{wgsL<q<3^Ao-ASnEN$`o4zO%Bs4LS_F
z%N4nPAw)6=(eX(IZk&e2qp$>wZ{2=9SZPfUt*4VPF+hkS*_bY_C(o}TgKkYyg!=5}
zQEyQB+H`6xm@6A9_mQ#7)gXqEU{2rb$3i+`wcJWp8jE>GoP{>-YD2pzg<oAiK+5O9
z>J^laLjV)JVy4`SLYz>ldCa-L+#x!sL!FmNad>~~QHk)@ZmJqp_vEC=At)kKLlC>b
zwQGytA7i9xV+Sy2Bulkwa~gsaSaexHEN<M^zECeUr8_PIHf-W@Tt@DS54SeEY<VG2
zZq>mf7x*73M(wa6%1F&V4JzjpJ{QVIV;i3PRO5_puMm01*!_ARq?uphC9n%^E9f<F
zqaxk9ck4m9MR?e1L7m#*6P;s9r!@<|483?!W*LGEy-?pfaM+UB=~Gy7b@VL$sP0@4
zSJ)Ve#0+)NkX?GQX>Zx+!ip+KD>3Xb!RR&$V}jEZ8Wes$1x0LMwzSc|mOmVJy}o|H
zzl8U^{mo#oSmTem?fQi!V=ZYx9}GlOPFt8$(><$9GHEl5tjdL|+9jWn-u|2XY5($(
zZ<RJb`{#AP@5|w`W^SCfAMD4!nC(<<CU3P{rarty!IR_)Dv(EMgcbzvwQa>4Ov1L>
z8oYI3+xr|`s3+iTicmHhQnyNf30#c6<m6V6f>u(xj5J69h{k!>Fy5v$b`tm)QBBb{
zG@<)g=y^F$(b*qz+g+84-|^KUkHBuC-E5wy8C`3M+2;i<We#YYq+OKhFxUk5pgu|j
zal;D!G&$$>f_^!q@=I9ai63vj?-x)U4|f-j)^D3i%c@b@QXX#jvhZil#ZYR-*t|S%
zb)`t|bB0Jou;OXN@R%yAoBODB4;I@nw^Hs^w12)d!O-|)x_N~jT5~4MBM%}8h_SY|
zT9W*JzErM307C>i5poL)r&V^@L)}LUrQ1v{+9B)Iw%7N-siKy;QtVtK51I2y$~Q@0
zo;|h3I0WlIKS7~PZ}s0_i2$do-7353+h;y@K|sx3clq0e?ZGvfhFBeIOpS>qmagqN
z1Us$^Fm%%3%Wh0>%-fAI{VMxI0>%Tyc`GYJ^iL`J)bLvfq0ZS4frxnkjJHuel=E%M
zH0wLsJNK<B)pCbcR)e<(!(`=Tazg{q%BD2v)>6-2gO1+_m_etXr@8Du^!5PnTRgB6
z)c+UV7ESq4Mp_mMqCY5##BtM^TS4?(1UcfPxZGi-(qiOwfHMxp;Rq`Xd>J>rHDfCl
z>UK<8H)H{qGCp_H^X2r+6uvZel;pOs!~uOyxi?Jj0XWzZRD!9p0&qYl!ILO_vOw)@
zRh?_s9`^)2bpPt)a?hd_#0x!;$z|(_kUtM2{8bLoXJ&gFhG)^Nm0?RbvR7@@-@np%
zNKum%{4vGZY7;{_t*4h&-r*X*T^cj@tEDtAv^jT-<=eQ-G^WxN;&t+VUpFi~(%CI9
z+L^if2g-lgkbagc3Q4%RYuMZgh8(c|HH6pN%J2&@?@@4Q-mANUR@$bhlq0tj?awo2
z(L}XUdtZ<6(`?$k9xv+L<ZpuFyOnxzCo79D0+?iUEYsEE3KUO<)CQRH!5F|zoM}m|
zZn9+J!{$-oUJHsbm*ccsK^pq10zDxp$lxH^A>-p451m09*@+;ZrDmAgA?*R)0964_
zdrd=@mvzq*bH^Vb46#L+qXjV7&mA&J0jc<ydIA6W7>iyZD!#NcK)0Ki)jAc3W3zj_
zrattzJk)k_+p1hxb@qAaMRC=al4jlBz6TElzW{C!hZ}yuTMEnv6zdC+dG;?p;$~_=
zh7z16pxI|N&?-6nxKpnx;oRw3)wV<t4Ij$2RL`o$C(8uG2IdA9gVgy6yR+3HQQ;b<
z?i$DPBnL1jXe{aODKTIlLXFD)%jYt8%}g1G>R+3YOFyrmrh)=_H33GXq%`0LQ9BC&
ze8WIH)j{&7O|r!lir+ttEwz?XZ!7>vNp;Sx@mGVLs*9^7#g|SO0%E`~@OIARPEZSU
zp9i99w%m+`jqgvG6OVO{F>c(xMDQF=y#6j#ohcT>mk_s!%^-Mr?ZargGNe)cwZS0P
z`_I3FvOXT}?e@83AGVM&tR8TQpO*Rl7~RTuJ&7L*(aLCZ(g^CM9cilnENrC)s#=M%
zc$25Cq}+=fmLQdHdsf(SAkz2_s_(3f&)r-V$Tib3VUZ_f##BK4X|ARo%p(K?5g8yz
z#<e0P6G5`K?*tXwQ0*f52YzU9N<*9w`Mz;=i6pH%K&T%~-smC82Ldr&;!?&kvR8Z>
zdK~ngmz@X9iJnBlGkaU<<t;<Na;P-7{n4#Tdl44W=F8(jwFe@zl5ZpexaL?!;T(}=
z>VrZN7K+ZZ49~RS(IZgZ%%So$kh^YGEW*<XdeV7Q{V(@KO*5Saq8_H2N*-s@D*6Z$
z^<Is6AQ9(`cLyGVv!v<dwcXTX0^FIfh;3x$m$>+u%^ZZ}J_TvUv@KV~Cne|0>V@+v
z@EY>dm2zo)EP|Byeit~)1qd7kQaalB#!!ATU0p@se|n1|G0u}sQ2Sus*&bj%OK_2I
zg+h0MAaNNmH|_!ar@dA-t5QL>;zJZwOH;p~mzJjWGCellz`Y*ffDtUbhLDS(brW1x
z)9)3~FVD7>FQ({|KF}8g8J-V*NrZ)Rs`u#XZ;#ebg78~CH~h3+8U46NPqApfFv)t~
zorhmm9dlFoA8hE`@UMQtqJSoTX9?&&NrFT=eWTF9qAEpEySCR;|C^tGZLr+X&zBMe
zRr6msL2xEfuK7i-k)xuYu*8_H9zVA>s|~-1i0+8fOW>|p@NV7=P5)O{<vL{oB=m3H
zk7MZjghq}SFMk~6ptWOtfWZNH`0~j8e0=y%l-T4E$BN$@L2;6RN=@+5d@1rY?}Tm$
zhe41+?{O*rt8UK0Um^HF*Tuf_XWRa9zv;i!ezf{WuRj!&o@g|I5-hWC^O_Lc@Ykvm
zH3&X5$Xi!@{kw<%hog&sEgWo98~;em>VKkRNAA4(FQWesI`+R$n@`7<w)$wU&vk?Q
zM(t_=pTDR6?}b3%NNbG*|6A(dY<7*m|65`H?=aI&X368PwE%zajsIKk|K$a~o?B_I
zj3rJB?3-#5(6VKgfnJ3-Z_b16(Bpfej;CJLO90t7s6GW<fc*N7xhK_fE==zL>-Dn7
z8)>J@!(W;RLo84b94I<^LR&ro=<a`3czMrgb{hVEi0AIq>=DEv-{)C&8}m4c@RY@-
zNQ={{z5JdI4GkIHZAaw_Ni4G%e8JE|-Gn_wUFb3!LX7?GUjGXTy+cDK3ND@R$3N1m
zooKOpw-q)v+JoX`&?j2ls=L<7P9vZ|-?U#7xrAm{m%}yEx=x-f7%HRCN(;MIXNh&(
zX#3lX?^<ZX^Nggv_4>4e?+2a!S@SjCmC$)CJo^}JF4A7i9Mu`BX>J?NF9ZSA4#6TS
zu)}dzKyemmB<*Qw-FlzjDAP=yD{0kbCMWwXsWck*kPYy}!Qurmc*!d*c3q7-OqsDB
zfQruHccRJ>c;EG^ui9ml3K5V?zeM`Wa;1X7nTHD&R9;lA#(|QTwaPB8&ezH=QEVMK
zCsbcwl}WSrs_Q?hdw0YkgN;LtMU~hylabgw(X~gMQ<56|SKXJ(Ua=3w&FDsa@#PHN
zFbUl{7`qy@@Q1ga4K;_LRCwed%#=cg2`CzYEykmxH<g5X8@p(Jv}GojVk3VaunG*g
zUiD>iJXqHNuk*%UY^|~@+1ZL;-vJslU7yv)?cFx+pVw1I2EQyYJIgQns`t}15Wid!
z8e~aKkwek@F`8*1Cu$KS$3G-&Ycy9<F{R8wCRmp!fg!OfCtE;q3n($kijUt7YUn+}
z(z)ExINz}cpruK%{MNl<Ue6vpr=H|G{Vu8<L8Mg_ri2h$K+%SuobVs;Ih!|FpVIeg
zmi>v``1AcHmHTp-qiqS~D@R++9ra_$1Fna2E_(*TUe#|P-s<vS>i=P~bi3E~A6~sS
zcz8sZ6ur5|dwNhJAbsqN_ff4e%VcMa(w?(ndSj0%vd6pf&WcC(cI}`nFMQX1%=Zjw
zfdF4=;-z=>^z=Z@QLY<ND=RAx9vsladeq79bFr|A*$gRW_P=w@$FYZ2XOZTY-hHaA
zw`BGk;W_=G?nM?}u!Btg1`b^B*$ioGYumlMYj<>-r(a%lG18|tjLr6Q=emMpsZJ&2
zg9owA;H#sOG{}rIrr}X&%u-;*;(uJva8fz0*37p?pu0`+$fy`(`F?%fn>hG9S&7Gv
z7$7pjO>Cz;2CI>?3@MA!k|9cj(Cn<H*2;%xJkDFKq47HSYAWn~2<#x^(2NwA*K0vW
zn^*Wk8aAADFAr1MaP9b|OYeOAJnG8KmRISe!xYo}B;~No+*}5x6ihC^Ary;GG3L95
z=R~EM_?F?};iqY7(S>gj2Mmq8isbjRj~sc?*r?U8(&2^Yq@_SYT*oy{P36_q(Y5TW
z2FPJagPx>egob=rNFr^R`Jv7t)Cwh+4atV_`J%pGw=p!`2ezUxp-k;d@1ow4JnFpF
zxd8^WYUWvQ#|7ru@UW_?0d_r@3MssNHnh6oQ3&|nhM7{ZHCM!7ilB*N)V8&&pamw(
z<=&i*+n!;hoptR&(|rLr7uK0E*lT2EXlU31Jd!!RVn8iKv54v6NMtixBP26zNo{<=
z@W&gl1KR~!=taZ6ym|0oIe2bM*^ivSRbs^3b7<Su^Or8EgP(6PmR1hm<J$oX=Pp=U
zTE1FfOH024zhr@)(1eC)EuWWO^twUZxN&Y?0AI>Rl*--X8{WBk=)h~KBcpSzVsW5h
ztl+W{+AK`IC<3b`uXK=2&g~S+79`3mD+|VHELmQ<B%!-UH(`jYS!Io0?A8zTn|Jl`
zISm?Za|>{8(AkPSLeE|~%<`y6#^SS~MlDFlTyuecpvo*?eL{BEkVqY$fa3o91(bN|
zN=O3(>D7z{od{2#K7Eks&-I-)gbUwK;b}yUx&zhRT{aJWWLhQ{E5tn}>vuTj!Gp50
zG9@`P9y+V@8GCiwr3`dOo(WsNvt#GZ%PuaIkFexqM>n^Vv0_@HLbA36p_z3UIG57L
z86>rgz<JCAs-eoNLSCiy#Zq}oGtp%Df{ORZZH~W+Gwk4^@<Pzq%;eM`FQsB;?M9Rs
zZ>%+SXfioAHg<Wbrcng6!I-D32cPbg6N_2MxZ=fT3TP~Ts@tn0+<;wK@aC?r7?51-
z=#yP%;C>6V1`4gdZC&PW{rYL5q0?n&{3frZpYcA@iO>*USXd}SqYv+vYI+KkxUW9Y
z>#%0ntJ(V8kK;b3vkRAJh*R9*6QJk(-!IH9#x~by%60hl-~Ms`E+RxsnUTAuGj~u2
z*Urx$OKpbmb!hD2-L-<UTF1|P-9A@ZIrCadH$f*M2iNu<S;Dk1`s0PN!Z>b*x<<KG
z4N#AcS>xHo`G33!C6GbH+Jk=y8Cd$wqSn@vvByV-#sM9vf4IOVKhAT_hORdwycWDx
zz|6X`_CrAL_itRQdGTp}%}+pov6WvN?<b2LYvpwBld466j`DS`GUQ-w5`#<q<F-sG
z6<f65kdZM)n%iK0vuz83GydeCpo4qYmVeC%O!j0-8xnG%)EUzVeqi7aR|j=}x1xt1
za{WNB?|WeQi#lt$=Rf6j;IGBmUA++{p?gF(!CX$frhM4`-}eW+23z#-U`g)LBAi=s
z%44V%9fkPg1*r(}2z|Sje^Xt-WI<aOPXB$?Uv9{SXL&KDO6#SDHs`X2?~A(fD_s65
zuWyNSAmDS7gsy~cH`RH}{4aM>{$5q(r7CNWZ|<On(c1FQX@JQV+sf92Y^_cH%MH=#
zsqCs+KYqEf{dh0?llWRA&Y#rpKg6jwxC@;i5hVfo;~out{HvXmy7e+Sxxl>mzwID0
zbi|&^Aa&CSUN?ObLmh4fC?7epnZ>q2CxrdQpyktyMZZ=p4w)oGwSxw|g?fgES3sc;
zV`G!xSf9F~(WEicKZ`5HnI2G4jD_XQeTIc9zmx_$u;EpWVaD0OL7E4<do2PKwEne5
zf8C*6k1dcSy`v|S^ompBZT?a#ns?y4_kecYZ?3m$X6u^u6y$@=Nz%(Tm;0IUmkJ1c
z1RnFHNeKQ#`_f^wm(ej5{%>UcBAu@4D|_Tf0}n$Nq}q}8NTMU}Z_c)yel(TZ|Ela|
zA9Y;O;7Zny+2Z359=uXDj?r$q!e8p_klju+_#GB<{FWszYJG+8f;VeA;=zM60b|#8
z2<&`E`!ILLm)lL0E<`@jvzuEbWIlNCAd@?dv$QSoc-7V4e^7k<&4CjF+J(hZM~-MN
zPrBPSj^uK|$ghQZz|apfM7)=?Hm0#=b3az$?g|Olc(_Y6uqK=26+a0@ydCHXrN~0o
z9Yw>-S+~#EZLDMWN@|sa&b-;ke$jjVkrd$=*~i(D$mp+Ksjp=SLF|nJpKM`^A8~YW
zkk6w`IJpNEG#B$la2r#9C<xT4H%BGrQz3(mfi6$#9vauG_J8r}Lq`=(Ei>pmwPQs+
z@@gt#_cn6oG8&hyi&OaS^OKLwXf7iY*WbTet>sE~O}?5SwCa_Q|LF-7$#OvjZ0(UF
zOEbj1A|es5yq)CT^!1IWryqGZiFXkOMN|X@$<q;S&<27X_2FFC$mEo4b9cATRl|;V
zW4()%(!xfRO5|qN3oz=DBey7}t+*(+-sEIWX1z$n1$SYwsJjirmL<4R>Ln%cDQPO8
zS4l}j*tDl25cev>hOGuVCI9HE^9kk{8I>;sHKAA3=f<zR=w*E9PVP}0)?9HwbGVXm
zMzYc+=xl1g(-m|3AbV*+^82hUd_{PW)OyToCt5GJbopb}{m}*uH9Tg)?S-m{*Xqbj
zfg!fU2Ft~$kw4wr;`p-Bi&)icEn}Fzddd)?+Vh1}0dtp#6*;>PhS7j(YH{Ww&dh~#
zTF=+~YV+q%;)#(_`Z7=f4V@mW(l`nB&t%+s-?oUpS`TUM`}aq??hCZE580-lwcuGC
zX3h-n4h`^({!p0u%B)rppxEO4vO0aBX$nRyH{kX|mX;3`D6-9q)3$#5qszRQOF-FL
z7O?8Oc`NpfF;o4uO2oPNq@EjMnT`7rO%=*sT1F#gP27crV`rSiy~jS?Gd_L^&3wbk
zB20d{rXD)2;};Nc$v@<nVJ7B4bad4L;S;T#&_Hb?qZ4cczWZJNb<kuZ3RYj;Dn<&1
zcYK+A_d$T1Dk&CCRBIuR++$m8f#h}%ICLR021kin8L>6PoEvt`C^@Y?_c$<l<BV7f
zd$@w2ppXR$!+vvRZqY(41_K7$8>g`cg-$M6nJrYHj0$*VKFZA<_a|;yqQ^)!tll{s
z{^dqGYcfn4?*=W^TImx9mbF_5WgBhZFn8b5um?9$8=XSN#%VUZ5phFcXa5v;>KChf
zUqfH0VrFy9p5@JTvc+0vMac5%ia$1Yb{5FUAVZUV-9nVPYz#xLRcx9b4JLKv(mOBi
z9mkHBG;^)9T*&l*rs!a+w&U|gm0P#8RyKWzaw9WCVPCrXm%BNkFVxTcIM@<NUd{bT
zt(uGX0nR}iJgB~A*h(aT=)*NRs;LP-u{1M0cecL!kd;R0pAg10<jS$6N9m1zxw8~g
z1*y1$g4-e{XG^uF)I#TcaxxE|ynG2vL2&nO+#q_4!-|P0=qy1uLfvzQ?!Y)O4S7w~
z!)i4#NUn>6_qZA1(>dO=MxwIvp541GB#Y!#?0K6QE}aCp`d+Y!zjO?mNTLsMd`29R
zg09c_DBaP8bCB3R6h_3}-)ynjn3!7{G+QXHq9qeX<(00caMR?H=qv5#klESdqQN)d
z>M!9~s@fas6xF&uX(I=-d$+t&&vME>uRwmU)Gr<VKuN~O8T1d<sB6rgaaDTX!w1I&
zEx1v+CKiw4c9E)WZLA-@bz#}VN88FmTZ5!!<XZcqQ?gZ+gttdW7eg^{dMVI76nnhY
z(S_1+iwrkKR{IUEfxVaBHg2E&<$66Ebhy(iZF8)&R+UAf2sxWSP_LW*+&l^{mS{>N
zQL3E6DrW<QymnR8dG2bUPMw?xXY<cgo_XqHnrM($3@)lGK5HkOiH~~OW+6%4Re$8j
z$9o)qt;|%rTCZC5PcQ97-NM#a<T`lQBG)8JFL%Bc9?0!Z(&<s$%nEU0#>QZ#8W$$m
zZ<BjiaYtk0cC~&!$GJ-Y?i}Q*G6G7gX>8`~(5H}RQ-*(nonFO^fu+>Ch=>R^R()#!
z${E;_<Key<saVbM<Kc|@nioDEK15QIo}Kp{(rgg(UYxmBJ)<~Qt+f@nAh|p*#K1$#
zmFAZG*u!o?q$sMN*|8#dO_NxsIGz=nm8L>KSI}NJ5X+#U)mp^VTs7jK@EQ^i9lT4>
zmS`nKzu^ua5EF@|G;%N5)+!$)94j&gv1Zo9;>rEZj$t{6cbDDz%$SR4o11Lfl8vg7
zY~T!)EiVt{KE;G<@C89Hohf@|8NEFP)lxd+<WFa_YlfpJnZc)9v_FDa5~QlxaObR`
z5L8~-BsODEo1E<{<itaCWXzx3w{4CI=Y$cV@Rgx5kV@xkg(`s?)9U!C?zwut;0w*_
z$c=W^)(<Tp`lBOqGjaE4NkW6#_nih^!pppU-1vhB6PXZBN7`H!O8pQBx@UmMa8Qd<
z!*{~)Fv(q7e$Pi>#XS{sAECO3VXJGw`{I@*q+d!3neV5VMw!IL*EGoB`#%A1k6g&l
z20e8`;mf0O-47nzW6pdS)3*8W<<q%E#u7-`8N%D;)!-VSJ)RR^JOBCIjzwk*Kf+-<
zTc(E?J4qEF!hwMKw7^i!n;%YJ>gIQ*M?ZK#htumLLI{IPzY&N})1O5FAHNfpud1;Z
zHx&b;c+$6mdtbLy&7jtP<@21zw^N&9lfp~6Ca#RrK2m>~k$Av!y&W8~z6rIfHP%xB
zM&-;_lu2RlH*=sr%K^-B!{Z23m(I(V-Z2}Q#0wbOH*k9Hh#ES4QHy6W(Bmx1??ro^
zywoNH2^#4)f`7X6;`-#NX+BJO&QVk!*}r?Iocku-1R!0DMix#GC6W0TU@!DjF<UC8
z`Ko!(_c*tzZ>>%PE5jf6vDE(n<_XpGwS?^RcGRpIT79k8{9NgOAosuX%D?l<|Eu%L
zKjv9&<Nqzs`Xd(;vetw5CtBlc68M$%;Jfn#iFgU!|DFr}7lX$9!Cm>(4*fTGrA;`r
zMv43)^ZXk9V%(Z5{U%HF)!04MzUU=LBuISQqdt9OZT-R;S^X_$fKV;D##}r{fXQB$
zP5CBe11RNzN$d4GfR~&0QDKwu+Q3_F_!dj_Rh;~s8u-Tq2_!_@^RGD`1xtN>vtryg
zcM$McYb053511@q-o8oML?{{v1IA#j_NDrl3m5^7|D&Dbxnj^--MH+0iO-LzGZ%Y|
zuq4*dIx|z5dm-zS$nLlfEH*BjwNMRPS6aF1+1XhyX<6A=E#{CfMUzvz&e`3z03_po
zD)#?OFby_THvFv|e@!9&&B*?>wf_H)k?s8?XtZI&jz<3f5%B*eI}7-A;&$FVikA#&
z3>QyK8``c=Q2`RrPbAW}I80Q2z8V+&a74p3x^>fDi0{Henw^cQpI^ypXmZc^H{hjo
zXib_OY*svG3w^NS?ppioYm7g&y><}dHJF0upK^Z_l>b{KDKa~0Txj;+nO<;)b^CwE
zMw^|i`c}-b0BrPZgjmCJHaMLGZ0+gVwWj!+BfY7<yLZoV=&+h=bXM}25hZoS1I>;u
zSF!CaF%iw?a`~>R+aeB#oB)IeAm0=ZY4Y*%9SWcu0p)iv4&?f#q>PNTxE>cd0LaV4
z?>h$F{t03f+nTzNGJ8wcBiD@jke@eRy0p6Jf@&Fc^teb81H@6RN4ETF#RC`(BLB3f
zVu3*JPJ((*tmaxmAPquo{2ZXKn@?&^Pd{i95b5g;l)GMv+=cFYI%{&GfivATNt>|>
z^iV&tMDIU%UsV0aMi$Y=I0NCz{hl9-tS3u1L#lGe&v?%_)e%J1U&`s(HNW!lI4x^&
z3~!g2k=B@I1JBwYEdprBz1z1(^Pl`G%>T&5MCp}6vqyk1nEQMe2GmBFv^-!jss#zw
z5EN`Y6Bor_{t)gp)YbKbVY>Qt<^bURvH{on5%(by-ZTN&NpZjj{XeapYfw{X8pn6W
znL1kqw9*zYBwH94E4Oh}f(8jKk!UHPfPx^T5({1+5fB1NNVYn~B7{u0McQTq1w=$j
z0)~r_KvW>;iXzuQkzk43l1K~?5)zW^bEw@N)^TP(?8i(dZ*tCaeSiPwyaAxh93|x<
z6e_SF2cacBeKA)(M<p0JQ(`&t9xU<~PD6X33I}JsIj84w0w^I=09eTr%F|s$N$n&B
zfH)qn9uc|h-~TQgJr@THmkteY9+3u=3L3FwH#h0<x<VO4AnJc#QPzg64p8j(o#IS)
zOc;wuS#Ps&5LU(GyPm{wsx}P($;z6gVgV+4`M$R%tED!wssl_4?@Ib!Moxjb4Sh30
z8v#+AvUlgE0SENQorW`+Vfs7u68JX)uCaBsTvHTVMT;gsuczqqGsYir@Rh3X%H1o@
zinHe0_PP|nk!Ma$<NpIkEj<!x$}NCxZHB^*BFh>Zu(Y^p+P0`Q(bS~c<GH}I^S-Ni
zvS(SJh~An*BG^{b#|CFOp6xmGjJb2<Sz7y{eV{FS>CDk4?)z^_P6*lS2KqpeE#5rI
z%?m6ze{_d^+*CuYgCpuH0qyIsJ2f?V@}!xV{0x||dbr8`uNCp*0A1ZYJq1NlrAJx^
z0MpIDCzDC1K6>&Gk$s;qwda_dv~_fZblu0H8#j+%hUb61ZX`?%UhE_s55Anmu!JH6
z`+l4|tvRqZDbc%u!*2i9-!7nJgI2y)btSf}&0njoUE!1iGe06=$IW9fF7f&{y=HXt
zfdl1gjP}O2bAEU{M4?=`^5{$ALEu{Ta1{mxRwLMq;(0Hf@|k}@La>$(<APOrw<<ge
z>-MWKHCk+{=+h30(7&jB0dXTR2*ABosiN>Rb4(&M!#;$i>lqTAr~7D!oB??}{7F*;
z`iJG!;={<OC`+OjYDj`9GR(Cl8}40BR+i0!qf|FpUXVEWgapD#af&;0Ns5l!7Zkw-
z{UINRGaBBZPCrqP)*pCht<l+Od|^13dybLL(p>v*j}g+oUYOi4Df|yD84fqFe5^W$
zX%(9)$2nTfa^pw+73PW5kPcudpNCf{tQOf;6`x~c*U@NMK6Cx-7Mz(AAroU%gVc%}
z35o=(2BRHjbp!8aOmRaXO|isA+UG$6oVFi=Lc+BCI1MSpI-g7I>{9crmtGLF6qP&d
zY}-9qrcQ5G<!$4V;n2P!*5pH=b{733Nq*CkPNSw7t2kg}&>hBKGbfcLzRXCYkB@Yt
z*pPz&f^R_Rzle;agv9NuxD7^sse=Aux!e_S;ZG+ryJ}#5gGx0Y9s`akvjLKro`eR<
zqg+TFJr%J+iH`D4WU^#KhZKcky<XRDn7*KX=G9;<{+jE5tAy)vi#+@XuT8rWvvK1J
zu1ys}Qp;EzQuM^^?C4)e1XTB^4gq6NZ5#TX*=%Oh1qh)%L1pmmwL(iCIi7E+{H5ex
z!6)I=O4lN~^1<Vfb;U-BtF_!Z88|`r-F-wgJ^c*<HH5ZPj|q*zHMHjDLGpwjivqql
zI_VhIC~7zg)xpQqAAvya-Kq0hB}JYW^>Uu|$x2eAAOV+|X{O&EtfGgyUsH)mu1=+q
zCzo8VeHH^4nlX}+boS$Si)UEo9M4X`?6q~`Z3&*S`O5x8H#ZMHUuS6%K`4l43(>he
z9)`=d2A#0EewD}5KC5-!<>h0a3Z<ez_V*u<^6mxK>L)^YGQA{y{@`3fH!)u}=F?iD
znRP(3L3JoQ9(}ctWi~-#<eM-$H~F^sw9##hfxcs6(@PBqQ3;#_D9E3?SmprnTvYF?
zji14ifAhTLuCo=;e;YJO0tne&%cIdQ_dSTbn^-lFYP&_5nGv5p(K<2b*T&4esjbH%
zibFSw?$f|#Bg9YpPu1Zz0v4%5tvg^xaI7-CG_;a2JI0e-+}^u~4XV{p3yI;cpB68*
z)=bn{NIA%F@IJzNo>rOS?&K8k$lt~~36%v?SG4!MYWf=pvJ4~vZe8cv#-HJ~wYWW-
zd6Pxf$By{+-l?g%Kwx2ZW6>4ev3YAu=^Z_tb{zty{&+Y)h;I^wR=V2GjyP(VuX>aT
zjm&}MDMRG?MLnoQE^EpytwkBi2PN5h-pydbm!(@2&J*5?hT>{^&hl4TB9d&8ZS$Nw
z13r?F@B0DheIyVPV>4eq&X)K!ouD?qF-;I%ErY25_Mv>qhnLMQhz!vUhDYi!KPbGc
zp>7*!2|GY4g$Q(tdwf@=SXZb3jVpji31OI;NLp=E;4ZqEwthh;mB);bl50Qs(1Xa1
z8R=BY^?FLnCP=@h^Vr`juq^FG2IIGs*Lf7Q4k=;ELuxs&6*sYWzmGk(vHF=1IuVIc
z8fIfnCtGOZg?VC<0R<-d)5}}1UoH=w$+xCMRgcYd&$%M0!=aj4#Kf(R`ANk<(I0{Y
zYPdg<Hb&QBC{kJL+?l-Z*DCI2i6R6sP5U=embE<Z<)>d|>#KvirLKbQ$qQP4L_mVZ
zrLi|AHlJ#}xL=OTN)KBjh#&etQ)DUg&&kkp8BH`2L_3gvxCve@%oRVry$Zep<W!M=
z7gxKoTf=xoIm!iTYigq&5%0cG{JI#iGK}&w>Mg@4|90iKPNB#eB!~k(eJgcYH7HXV
ze(tS}?Mfq$V`vFy@$L6ai>FgoW>6m72MG{TvT4jjE|I6b1=;kzD%Tb6l*yZxtlY*e
zh>7n6+Jt13AN}Fn<fq8X=fR`o^nq8eFV`{i%IbljKN@r^T6ncyhZ2Wikq;d{7>wtC
I`o*Px0f8nctN;K2

literal 0
HcmV?d00001

diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/pict_3.png b/clones/download.racket-lang.org/releases/8.6/doc/guide/pict_3.png
new file mode 100644
index 0000000000000000000000000000000000000000..96b54514c45c7470fc863478e4f177ef805abb28
GIT binary patch
literal 38288
zcmcG0XIPWj*0wW_I-{a<YzPQg0HrGslx_t>RRlt4QEAeG5^8AUIKn6b5=x{6ks3k>
z5CZ~%j3T{BOX!G{kkCuOP`@3~Ip;mE=e)l@u3TKn&QtbYdzE|LYdv{#!%&BBx8Uw=
z+qUsRuU|FZw(TeCwrxM!{k#*52;IGKdE2(*+n`r3nfNA6_WQZ^I^meh``wLWt{SKB
zYru@IK98KgDd$t%kXM%FU%cz>qNji14+>%N!N2S8{6Y1X4?=bhg5lLW$pSy|iCtu-
zxE@iwm@gn(s&+|AEwFo3is4iY$IcM!;21Bxj%!aD^1&a{uRV$Jg~ntr?-?(u6XkL>
z(ko2h2#uBnMS+kLU{2ugrP&LD#@5?yFERIgf7lw${4o3Dmv<KpQipbYdG}kw<;p!<
zM?$I+X8y|1!#*o0DBv9XI(Q>@S>Ec+edL^Q<KO3=69|c#F(242bm{ET7_nq^zd|YI
z42u;dX8q=VsuUC95*rj;cPdhSzV?6qqaSaHnP{f!37#*#amHloM8|7g8f_#>N5t>n
z{!PTzV6?X;)e&Q$R@pE-XX5`egxEGC|L=!_GY8P4Zao^*HvfBfQ27?bm1!TEWr2Fd
zhWY-crY7_hg+X6a?@**~=RC8xtdSOXqa|CsLs9uaoYIyoUj83ac^tyOH5KRGeDb+r
zb_)30XU(VXY&-mqy*u%a9eddVlt0kgvZ=V6dfAR9k0?Fc|DxYM8ge=H1|{?dlb<O6
zdROOPIM1AK|MP;1)O<O8iD-2ZqyKPhHa7&@?MiP>R-?G}Dyt+LR^2@p9v;qWP1AXL
z^`yAH>al&YGBVdO6?5V4wL|x7?-ran@Z?@VfK{ZZ7JY4Ptu)f*lwx9&s^9!bX$s?R
zK`nEk4!n@XdKeMS0P_$2R?VpOAex1x<>&%;#G@oeUjlOeeAdv=9S(;h8LvMUU~}tM
zbdg(c(OqwuBkkq>%Vxrrx-v(?RMpfv>GaIfQdNPF)cY553kuHh?b|m-93+|*b4}9X
zGMZp5dMyauro+FZ<@R%^XpKaD2`?WX{<R(v4Rreb3s$qk{Asv`D;oUE>)pe1*#v@~
zW{Qz=qQR4^mlYKi1&<#6(4J+q$9I%KQ)ZWVcA(}sR2PPvU->{|i^G*GSI}#p3qH;H
z{y+-gFtjzWNa;>;<<O1ezdj$FfdvMxhfMOj#-j6BA=rk|Htqrw>lNMG)AKrbGbr%$
zP^h4QfTZg3=egmPk!T|^sIagwyr!qO*X#4_oxr7TNA&E+x1|w#T7W1fM(U!SU0q}9
z?CMpO&z{Zy6k3qP1X3^O&@FQa1WRw3Uw`J!y}!SI<>RCM9(lIQ+yK>p&$CZSvd8ve
zJ7;(Q^rI?j>{%ajxzJY4d-4VlXP!-Y>Eux_ON~Sdj$f-NCPDfq4wdU#jaE)<A_TeH
z<kD!g^br27F+(-<V)i~^)fkjjna>P;b~a!0^T$URp&cCyW90Y=Zf(>lmEdy)fveua
z7w%t#<yo~hHtG+Y%MC#f1mu{u80R29bauurbZL+CyJn#Cx<jyac5MyvG?~bnG%nX~
z$D>OI`uep~-V@+L&Tej<-DF2j;^3M#3Wd66FTXMMZkK4l%lj8(!m3_XS8GoV(hz)n
zd_bSl-woyO+_{tPX62igmnXMy>6vy~LVSGG;0$7cX+bpW?Cg{j49_8vj82_8m5`Ex
z?MK2~TnI~3y;&<O=<@k`>6K1WP{uu_1VzW7AR9y=$F$kDz&!V5!N`H1e_E`UCh?T{
z&~Db-N4pXd5-@dk#({z5Jv}`h8<laT#Jnb}mJGVpiEL(*lOi3Z5Z}?1cpla`!)Egi
z%goBs>v@4i4<squYUs5A^HFTdd;9iMe+f#5OeTA%CbQY>wvF}G&Yqr}TUmzoL3NgU
z*?y>=Tn^P|W<Z}jF;p1}wBX^%s6VMTqzDm>oXkv#WUXKu8n?+^cg07ELsc;);4(UB
zLfYEeO6uylEEbEeQ@+cYV@2j8C9C<=GZ!SIu8;To3^sW#o{IW2&#L5A@c>#+BvMBw
z;+W)$)(9idx?wHw!NZ7%2%ebSE4Z10f`YHz2P^D%P~(Q*p`xRsS7s~sLsV4oB_%2l
zC8hD+!HuN^t@9$0(nt5Qfe&cNwBFCh=j7{a&TL7+wzE10%Kg12=)@$Ig@pye#(h)X
zwkbL`15w_)fB%MP(C0h!qczpl9lgDY3nd+HUT$=>T-KP`6%BWr!~z^&rTLtHVW)E^
zkh!?zjJ&kj<*hHoomy}j7-I_O?Jm*UvwNZV()fe~V<7a@E1|D#YxeDU^!8Q4Pe3Cn
z0u$ZN6gJQ$OnObE=)?+VBHp&LvQkh~lu=AucPr^f^3?P^vhU12eJ5~&DG?o4xVj_E
zv<#7dc%sCC)b<8gIkYYMv{9S^!ayRr6vd24@4#FoP&@)@<}#TZ8$nQGTifB%h=x&*
zx+!l*oFm180@Q!1o2)Z6HC1RX(|{Z1peZP(;nYC6rDlqICrSwdabh+n_mugNyeGR-
z>2$Mh*P>U|B_cpkItK?4#y%xUOgR~uaj<Z|<)cRh1>3s1UZk7&1Zqt6Q1p<+maX?p
zU?dyadxIHOEwS0X&fU2jE5jyY2s#rNMu{6t@tN#80c35b05?8}<qeu5HO?z3UDs`z
z);(W#L~nDOgF?KAoFDubj=lyzAqkB{BAX|PF%$fCbH3{2!`DkIo?g<p)e>vg6!g|C
zmzj_>WKZr^xV3M=?M-~e;N61kl9G~>La59P23O9yw~Ril>NA}LbW?NVvn^caNb-dT
zCkb6ZT{Tz6PlZQB)U!O<E{N3x3k!=v1)RFyD<e&=9enOQ@Mw#ycA#$vZ=1@qo~uh!
zuYzq0O*77KQ%YnM4<>C$aDZE+>Pezfkp-Aoc1Z`%J0*pq^PU;gv}S-njdQ%)_$iV*
zw+3U`DhHm_B8!<sPSrAh*)Qj|h66ZB$N`DyI;y{C1~$IT3ixds0|SG@0XA$EA&!+m
zC!6233Y}LM!uZrQIv;o?3^<R(#OU6sxSC<Sd1b@U{d+YL!Wd(BG^Dz-wKX*&VjtiB
z{VsNPSG~)ufxGr7>qm1(v78CSrUi*Q|8&y3Y<iGJx-NDyr6mg-?B(t4?Coua2;$mH
zv;gO}#$5o4k?`V0t!sy4aqp;i8HlGvNs0P$arzR6_wFQkdqsqc^*^+68rDy2%Iq)m
zAyiaoPV9zc*wi&UQ|c!;y1E84%JKTnE-tr#3vYBFkByBfDJjJ$21_&CG~eF7Va&->
zCP$4Bm>$kZNQWYaYPOrZL5-;yz6p*`Z;MkjZs}OCfa7tycJA!x>dJ0zHU#d-v3vi|
ztfsh{nwl_Y-<!N6>R>Ib1gO{nzm&4iFKUJ*-wa&?df}34vHm;Jq6N}DYq561iWQ0n
zKDoHpdOp+)9Tck#<{T2Tlc%fuLa(f^uQ%kS7uyW8$HzZpr3B@yF3&hlmj$jCRd9&z
zbwD$k&JUV^a83&15ON2v`uO<pyg$!6kOS0sZjBKPh6OPmc(%pqvYD}@m5Ls7zRELB
z2L~<MTU(>J1|7N$HtHggHUV>0xvP6CZy*qeR)44K-Gk|vy7U3`1hMfvwTinuGss}3
z1mif6fqJjR{gk9aV-4&r6d@IdXHssAFEcaRXtLn|#;gxV0Fz<7bLIrBF1dlIEB))w
z;~WNp0rmlWIvrY>3PQ|OSHYF2>sM);>oZ}h^1zHpkAe2}Kc{rNdR#cB;@B;R!<#f7
zux7`j<*=R3rk0k8>Fnh_Ma~)wyGm(|^`^7W4wtR72>WBmN4P?RpS9^z0L)D=NIYk6
zD#UpI{;FBjb$o=2yE|#0i29kVcDxHCPj+?xyY<y&9yI87RpzO&zW#Mxuhfi=u|RIn
z8CkEfRx@K5EDJ;tsP1|VIv_xuIs9qvO-M+HlA0O;Xe78!Q4#M<FE1~ALBUO|oV7(k
zNSyAB+i_@?QA!+e+b~362EbhLO%7h3p4sK))?ml5Rd?%pW}{25$q_nHDv)A9u&%t<
zmuXt^_R5Khig(cd{$b92nLuYy8HbHq=6tQN@(4OF08DnB3tXQ-w5SgB_7YmOHmT#{
zr9dIAoCuu@<Ky?nW_Unis<#+xpN>t|tLo$fvcxv9JdrPe>mf1|TzxYb-lV1dEuKtL
zQh7`p&Hny{W6t;P-2jo*Fj+NYY|O#B%v+XlobF=v=+PsUnUv(@rV$W`WYt8%st!H5
z3V<YdDJ*AY?VIT<xn-21*;!kAz13DBUO!&140#RMF!09Fl|vsE7d;(xXN<RR-_D+z
zvR(=w36rn*0OGRO+UEz{08L?4&+Kf<LfH8gREbro_ml;_EpcGLMp!Gz3P^~7)9_!M
z9ja{f>?B$hb6rO*;&%USepb-OLBY)#<>eX+m2cB@B6U@@z%pUR=Qw@+{lx9N_SL#7
zy8ssfa1MY2V09k=N&qg`lf&+OMf&gpV9H3eO*xLqWO7F84g!b5{*Zbl0f%e0@_c)@
zU>q1se0gX(Q}6g5p5GpQT6I?_6OnH^Q6eE^!+Lctu?ei!k9L+Nk1jn3e@cLn9Qu*&
z?hICY76n91@#wnT;R#4y04(~tyFUNE&;^{DV0itghy7tEp8g%XaJ;ye2=u~q=)O5X
zP=Z22?L0ipo=<EVlP$C91yQ!I1U2ugo{*f}SvFIVxa?BarYW#I-5=e;yaf!{d#cCO
zq|#;Xd>bB*Pg-s4d-LFmn$L6$z+sM#j$=Z7W_i5<Mb5H%j~RcfSIpfCEhYvBIjgFg
zz^ySa$aZ9x7(c}``E7hJ?b>(jhLT_>fP>FD+pk`^@~C2oLUIBDL^XJWDrZAApFR5R
za9~q})YMBhB$#6h&h)}DGqD3V!3nu$E)HoEz%X73zTxR(-s8uQ`P${XayZlq>=Vn=
zVWbQBzU%>G)?mHaJo^q%t$0?jwY4=|xSAsfOHF3P%4|&OsEaVF!uUBK-#*em0W6Bu
zfxorV>{F3Oc5DGbFHVVW0RVy5#+n~@J*cUrWnzA`VRvYyI1?l^P+hOlFuxXlqg5*>
zNqe;0`lrFaZWLda&crp~OFC}=OA?P+UGE<Cz*8uu#!iWySv>0!KXj|bFzXgrX>?4&
zrHaMkQIMakjHgA~9SvCv3U;9NT>f(Eq1AO2!Ekn4hF<A|;SdK02c8)$a1VuRdkt6f
zm9I{h#gi_b8)V`g*?zJnge_fh^ffRta@?>%AX0obA1-D-4iiQE!V12Sj-AV(6`1*3
zjsAJ{<nEo1z-t~|?u<mzK{D0>P%E%s5GBWxeFh|*HZd0V1?Ha9eJVSC{NZus9qWpK
zl1a!+n2W<)h6RlL`KhvW(@8y1%Or#T%Tg78FSbN#Zru-{P@t$!Ylhh~AiI|NvM+Zh
zx|s|1LECXNm-hg;3}F3DTiY~%!guFA;CWXVelTTt?hUfPG{dqOS!bsJUiLv3koWG@
zPD;iM^k)6~CI02K^7hs$T9FE3r2^uQi^rcYoU<Vnr@IF{HdhZvJ_s%78P18p<0boP
z!HAjiW!ymEvNaUXXz%JWAB}Q5#@aLofJOSilX0+#;_^Ol*ST2xr>vx!;km|`j@Z0}
zD9xhJiATM{jM*hg36@{{Seo%*N;}MPa$-W-#pNg7Y;`0#)X$+WVuLJknr4k-mAoZJ
z=mrKW?>$8*Qd3hC&v4FtA-&^Ec*bkfZWHJz17+&o%34?7xC(TeG0$jXR`|>^<fBRh
zSC<+G`5j^YRxWq!?8MrAB{}nHlxpA)MzIJpJ-x6aM~--M=SOoR(0Gv8FHQGLOLju!
zy>srZ6qDWD+~A2vGC^hpa&TxpZcMiy={DMd!b6JVx;qx=X84&FSy|b5#KjnL(z$SS
zPy|}e3eTbXM#cnay}58KqH+K0D&=F@OlCIo9kG*^l5Cj8a}-dJsa$F$W4?S*k2j;;
zmj1E?G1hc{nZn*Hzz#ur3a<eOOELTrSdNVUbVcCm;`&T5VsLX~87oVEP}Z;NIew!V
zm7p)di?gQ<lb**U<h=3RjZ_)Vi39F_v>%a`ks(fwC_b=xvu6?jpk|x~0U+sXX*YTL
z_E9of4$Dh};S+D#kL?R>PEtt&fdY!>o5Wh+k>d8mDlPQlc;SN-RWDr!G8~{@6eLQC
z?d>9!h0B<CjzBj9mrLqH+sKr|*Fjvk)MW7mD^_^0{X9Gr+80$HeENeuF+q;#byY53
zY|~Q!E_UxJR8^VM*W+kfS=a%&Q4X5JCXnhK$dVv?1hJ$+<cfwPpc=5#{39#zNaE^_
z4pb3XQRkS5jWJs^6@bKy2w}C%Q#ujZM4|!6x<F!o%iq5YY~apayHFbr%H`8){DjUN
z5JuP_fyJbwn9U%$t92mPO>i8Pof8ui+bJ##Db+k@7Jyv9#Vc;+r+}Qd+tmyh4zO4W
zNsiETY|!=>U(hCFihWEX8p@MBN@R8HJT2a96-!&QrysVg_d^1>2+~}!4CTeuM_QjB
zQEih_QW(ANwB(ZH3eWkdQ#wkDifP^5aPb4b073`?f!JqOXa=pBM~Z0Fa}!{t9Uj0<
zcM@P;OOtS3zD^_(0pAe?Xe2NZ6Bz6?!2JLz+LLRFocqV3D`b>8Ykh6#xO#%h7eQ{I
z8i-7##HKiIlWQvE@)y|!BUL!AM?>-uv^=nOd|sa6;0nDM;NNtRnSxnRUca{6(C`PT
zr#)iVx2vpgOfGOe#~KBIOKNItJaZ%r<ZBH)D7|jwJz5`|r00ugx^|$rEe6YbK#rZj
zQS3)A?#X7l0)$WLoy8dUSKU+MNnPsKpY1Z;P9OM11HE`15iobHwcX-W)b%l4Ka7It
z+G}tSKn49&KgAh)cg9^S7pHsou7lVBqGJQyMJMeh&%YES`z_8@o_)p#p*%PRqBTz@
zfGYxV31r=c5iQNlY=8h%60IK#9y`|IKU1Csa?twWIlJ|pr-34oTQu8eXYV&NkyWKl
zp%!vh0Fv>n7S(}zP+D4QS6~jfGwk{j`B(>PH;1YT!kj0oO`Hc+f@lbkn8ItAV`H8`
zLYUzDskmF&OwKtiEfSz$fIqNr%6S4j@WezrKO*4fyy>tQTO}MVr(cTr(9@H!;8^Mm
zaIA$!qS?_8)dEiYG&D4JXwd<9#p9tMG8LHX1Euu~BbWoi6F^~Iu>*i`VE`L?ix{CC
zV^{$A1~NWu<<N7${j9A~0XO*;yNmCqA9?JkltSFyijBl@psPR@NrqXj%83BKg7{Uq
z)R+BJWKDGUBk&>fBficOj|8fYqED*LP)|WSP*J+X5=vtxfb-#h@&J5vI}7AHQB4lF
zPDa&Qr4|?iK;T#2!C*9ieRrlf-??)MOcYG-u*NQ48k|;9VIzlisa)DqbXkM3xR<0<
zdG_hRuO&Cq($d7Wd}M1Vz?~j>T8inp%hJoc>jgNV)EoDjg7+A+Rf>%J$F9g?9b_jG
z&~m~Y>fDW%j5J&r|C6g`)T@Cd+03?^EmiT!$;4XIR@h}8K}biHKuYLd<il(~JtgXm
zKnJp4Kiy@!OSr{1_O|1|7MTm_m^2mK;>`0Qt$*|0-{Z{xKeEI1naM-;%2{ZyBVid*
z%*d*{7_r1Av)Ba^<?6{3c#j#<oufd(57%L&HaVol32~D0d@j9j@T4@n;Q&W}U}fZH
z%SflO2uI&WcJ%MJkomg>FQO)bqVJ4Q5tw<A-#XgcPeDuX4_%Jc+2X_V?c+WA>;C57
z4++|A(cjsUN}%q+`@3=LdliN5*L<YgXS2VM;~lyGk=b`7{$-wX^3ZP6|AWvM_<Gxm
za*5s{SilM_{pxIyF^Ks0q5`NfP&xIW^zo%6@f?jti$VG2tg`2?Z%wvH=2o5>yzS>N
zpZ>Ml@jrHM>)4KeS!`m_5a0!P)PTmb1XI>B_J5T#YEQYB&*vUKs%QGg<y7bWshOrL
z>*D{r>QQS+qJkR6*Lq5=eS7mP*tSlQ%LatSRlWaJ`xuETw(*mwJUcJk;J?k-$S6{b
z_3rT=Q;}c3O!2Qc`+Bd_dS8|E`y25+HLbFk`XNT@=w4lnAx>QqD!7?-&R_#+f*J8A
z!#CV_<tP_f<S%}A_PsKGJW=d^tPpIZ9i8xbD%&m{X|(2TQgJ@Pu1N7A(Io8qo6-~m
zJ1CsWGP)e^fEBCr^%niQA4yvUo%9V%Oy)qMxpx4&|AAjK+Fl`%?q^3iv9N*p-vyx&
zw?g&kJ4d+@qZ;{9jX}!9tYEF@3tdIQCDxo8A;t(5ctlM49)7u8sOHvf%wkcQ?U{(S
z3x0mw$-Kq_pLx;kU%t8M*3-d9nyvJ^CK8%5c*ocbA>YPt_IU`DO1^GUCmAnf6Fu|H
zvEN%1`Mj(wsH$e`nlFpodO~2HVmT$2WcV`I#sxD238n|4iX9FMTbQ?`eyy@SRd%a%
zVJFY!x^a@#tURXjqFs!VldSWYyPoyI9{lue7BPIJ_pVmAV5iB`3*`fgYcnKed*Q^2
zBgO%$6>_$O!+=tHd;9tKw61*=E`2u6>pW*5UB8Z5*513O+$rkT*q5h8KVx~@q@W;M
ztnN>t-GOH%H;WS)fw_sMXAYhGj$-!4_$4Aku>UZSTD-F~DK|sdn1tPpqcX{kevb!I
zOgv7M>^t>!x)8Tg0h?5#%$OH?c1TOMjB`L8dGY~HQN&;kt+defKHzdY?8-cDf!J$)
zUNO><>#zGg#TJ;?54kg<Ry27LByr(F=Q{=m0c8hBQ;2Q7t1@69a?;YS0Cqg8)51nn
zcF<2oB5Yq^5u%98<Qfd_9kI^2uwj&z@VUu+%)9Y$JMrLhj8eU*&o>*nM*F(=CVxmW
zl6Uy{YHqHf0E1*yB4`I92VlfYeP(bX>b@@lif29Mw>je!Bb}V}AXk&nEgm)!sIvJ?
zc19(oT0Wva=6boeWtT*Y`6G$-)Tfa`Tl+6mnZri{QCANu=XCe(Wz1sTY2lSB`BKQ)
z4=>FdPeKd35A;+7Y7eds7$j?IyaX(ZGaxM8sdFKXWABQ7u|(q{MozPpgHm_eUOZAI
z1`XW4i9PcA)I!qSUw@#rf=)C2c<dSXb0K@X95*y&hUs;jicpiA#E1c?2LROgSW}|l
z(KBv+Thr+>H?wa0TsF9Fc<|uCgp^{o`^K1ohF{x@nK?|lu-fI7IwQGy*0YA0<%#g~
z1843XXDygRNaqg*r)dvE>2tG<PMksRYSk%5IY07Vb4C&q$}F)(PSGmVTpl{qAiV1+
zS#lF|sW-0k%iEZ!+jPD8=0$IKsbH1zE`+ldTC`e}$~NZZX=G=z9%f}leI<<cIpX9$
z2-P(;oGN}q?n=_4Uv2`!=TmS=Znroz`buz|SMO9wZn0~y9N}a`b95cqf<s>(#FUk3
zs!b%%*>gdCWRTnJV@ElniQHPJtGb_%4WPGp)P~qP2SLM^sQAB4MWMXGhb)Kd{pJ2J
zkWI|k@~1GH-Xj|FO6((_XnQ*$*#Y#x3b)PB$%J;HC$wf&BeQ`-_j+V;!*YU_f54X2
zdW)3x<Knw1J#W6o`*WjizWsnI3Ar;KZKT>UNLy*l%K$4Y^(I<_F|Y-GqF7BMo%w?h
z!F3f;MaZHf{EAnpd#!10g*<2p*y;rcw#JN{Tj@YrH6)#mX0)b)lFJ)wfA+|vhsJ)T
zbo{b}2M!dqv&#cH4;ZCiqUQDQ84PQF9%-R<_Uv&ePtWxBZE{=o1OEOJXL*@fzH(<p
zy}w%CL&WHPqLRi^C~!$d>of4;{ilQTE;TrDmbKhpc=<R+_AWa|<2KeWjx8-xo+ngv
z%D4>A7k>o2ncy)izdnlGq21pp!H>ArQ>ltnP~;PHy8ZHVx3v>1{thcQwz>V@-Vt?8
z$XZIn*<<m&$~rW5IX_vXJ$pmnOoDXIzmHQRXun4t5$E)tFMNHlQl%w6Xj*re*DJAY
z+h5f&J|QrL_!zOOyVBDxv{&Yhm{>}iU*pqJbxn<x{@mUHIt{D;BzILt+qK)TaZG$z
zS#My$Kybb4##ml=OJ;^vf5l|dkp}i~o|i~u==YrCt+9BJy8FG%%Bp#uuEmYsW1sv{
zbhAJQ)6v(LwD5U+JX?%)dCkZ}WRp$yITT6J#mE%>GNry0*Elw+NJ8gszVKRo_jq*J
zP&*p^xv~ttJhjS7O=3>5BwhQs5nD0jwl#IL$Ay$^8K5)3vILnN#*Q4T*-+=8m%H*}
z(GOENsy<M-P*d2WV@HY1_F^JNUA@KiTT&A18qTRTxXQa0S)43b`KQKNw~c$0D1mGM
z6h}LICuAk5WRwMF#Jh|G?lKzC2$DY{NE8ebiyB-O<<zE^Z0NvSOXD0ZlH(VShD6mT
z;^G*VJ#VtIV4^<go#qw8Tb5&v%CzzsOP=p&Z9M^98CXWf1ypNo3=6^G(#gzBmcMuk
zGi2jJbZlK2eC3UMpLyUn&+=kknHq6S<s`W~w>@juYg?T;>>rctgtjnw%~+5^0KR-d
zQ!Wtq!-CV}*J<Mm`glDfS$PLw%|b`du#DqCg#^9g$$9WqTDJAQvxOGKo?`bDG1h6V
zk~76>7WeN32AXJb>%^gL54Z2Kql{Ur#Czew=qYEUeBLsjB(S~eR-$tk>_)Ar+4o-0
zJ^)Fab*V|$-!db<30vJGPd%Q}aym;fFJ*ml>URgUmzM#{QOn<QpAIkQ0tF;XjtXnx
z{b)xoJw?*aA~2H?Q@U6*>iD#wU{XDv>TBgrTlc=CSe}`gxwzEpE-fM-&_|Iux)%VY
z?}Ct0s%h5Q^0{iEQs22(5~ojde1ex<tjp+mDVuBgE2~0>!{A~WdDUIrD#V$f<q*S^
zASvkl>iRXe@ruvtw4$}-o^TiR32t!CTi*n~XD6aF^~*df7p*lQDK>NJa6j4x1vDX`
z<ZdP<C3S%CxVY%#G@NIeA+zgyu(J1OKY}t9@Gzj>A{#hY#m|dwhAAQ)toBEkbkX&3
zFKAn2aDe2*9H7eO(IFje3wtGuq><jN&i6(Nkpd8}iNaBLg<@+t?11lZ_`CU?yC4@X
zWFJ&b;Jg84=3@KsZ(&dGZK8>=nzue6cS`*hGFMht5AO?A43{H!%U~NaK($R+GvG~b
zIq68s=^lT}1pgozr$UhN5kN2psj0)lQ)vZMgg@TXrert|@?Xu?M`q@s*TM+4Ep|qe
z*3Z>xD?!8@_S@W5Oh(QCGsJj&gZF1#)VEapOgxD71f!^&OgpjFqVAi?54Of{0}c@Y
zEKCTt3jQx+ANfd+CwspoGWk#W24?R<Pi>v@^p;uWL|;kACcUvugZkoIgOsUxgWvq>
z49xkcUv7RV>}$)DNBFJ+$bSa>g@QINNS26ASez2*1o9GTq#OUo6r$eQw|vdxTJ>{;
z2P=~^`R%^3v7NJ}9vQ}!wYHDN!$l$;!;LB^|M8B0!(*i828z{6^AB2Wq{S|+`N5->
zgYT<NELEh4NJ(a8W$9o%hu%FdtlqNC-!LHAgVRj~8OQ!kD$>LIXD#l0lgjfweDYiJ
z>4@QdQJUV`_$@ii&CLyAl%VjNL;;6yJ!aSG9=NrQ)mTAo5osmr?{8m<u|Nxri~65L
z{C{lU0xPvZNy|9xeSCRB{RJ`Oza0q5zE7W>(E7W3>$*LJnrDUYI6H5iIy5@xOaDA#
zY59NVi4$W?*|vA%3%!HFaY?fF*9JD<PUZHl2BEXllW;f@XxrmG{PlwSw-&DJQ19gk
zhdEiHpnu=?f>7B|mB`l|^-No}o38*=QozzP6spjhqkL@ZMAv;n#Y3?uZ&<T^{MN`t
zZ8#qZ#WdcuJXi-5QO5BrzWyP1RGquNEDd>fEUtN0L9GzE^U)<}TV3>N#{FL{VgGSG
z(u5&OrdfBs=Aqrh;oC*H|Cn~efNqasr4>T@%)jNr2V%Y{*q!dZq{%Nj#%C1qA1~nu
z*w(=U>MnX!S52FH#l~9E=Cj3JqF7=7?-{7S{?>}mJOKu3Z=LbLfLIv%wUh371CW<&
zZ)HQ&>Q{69>m-m=)!wg~7IS++iQ4$Lm6if)Vm4=N6ifVb?tdGlN^W8Lxvz<BNywwF
zQmOUtW{^af4G=wqQje*=aprZzqi*znJrIk?t3B#r`^^e;Zvgq#$LjK(3N?*WLaXB-
z>MH;7d|chxX8|?yBIf)lo3Wk?2rXLR<mt93nv~ko#(tz@|G;wl74gx<#l`CwIjc7}
zmR@X0>c#=UR5X<84kzg5ssEEN7*?hp_}eLba{Cy<sE0Xism(TzZgoESzjbmOFoou1
zy>)j3v2RfQw@>hI-s}H^pm+;S+O>fVUKV|J-R=al;PvKI@J6N>i?-$-d@Jg$%#wWH
zrbRMcExva%Xgc^q^yjyYQ{5#hP~-AmYm;fwezjOYe6NzQN)^dLWny?Ab&Ixz^QFe$
zClolfC{^JV(&pr9rd7>+^K8QYP#E8a{6-=IioullJJ=T_6beDlRlZ7(YU~4zge}d<
zCMr4WYvDP@-|ri>7$J6)S$IK*r-ggNj+%|WaS)e9ySWj2M_-%VmRTmd$E~f5)in5j
zO)GWhv)yl34fAwa7JjIqH2G{dLFvF(OP3IOGZb5%e$J`T)Jbe>tV>_nwX(t0?mYFt
z-ES?QX2o}eY#QQ}+P;yBKLGE)J|3F2m?nzL=`b&R@%PRh$VJCi$M%(s5<4!$owYkx
z=;$ksZJY&#;ApWOKR$#AR?^M>TTCGyCV#>_Yn)2YRj{i^>njN!rW^h@KjM||pL6n&
zd3~X0CHmm1&sQ?zEYPW-HTOK2^D(%L-ttU+!JYDc!-KA}|1}b+>|dK|*?9Xry<e>e
zHgdHpTQ6c<jl2mTTcYCO?&sH5pW3Co>B4!fwx8drw<kf=XdTX!M_v8uF{;xlet@>o
zR>HI(qpB4rmS*Rbm1~_T_Z++p_q2A+3)nzF5OP((*D<5S!i_>=NL+JSxvVQ*a#;?{
zcNSfj{WJXp+4f{OM2+9f?oMh?B|ax3rHOc#(vmsYn|-zIL&u^%BxD!wZsynEeDa`g
z>ydw{E_%8zz`T6jNE|9JJQG)3U?aNAJ=^`hFT9dqwme(d>xNzz$`XUp);MKPt3F+G
ze9`1EHQANvCL5%ZypPwHYw*WnwtIfALpXrQT*cESGu|vMo0a?Ba}h;H`~)YkeJ*E2
zjP7X`zAShm`S?^K8Sc3@t4Z0JaEST<wjaGp&`83Vep)D5B$t@xE_JI1+%E1(SYPRn
zbxHWy0A~9qZ@#}B22Q)sqEVF^41=}^izL=6QR5VZx)q@ZLWt?84pnS>>VjiLL;Lf7
zUuTykm(6LzK;Lz}@Mi{bG3EX`W$Jv${!KQtxw>=7t%=<;5Vy<?xs$!g`ZI6v4Pks|
zg1{mtT4!WIncdL4e{qC$of1mUq_Y=(VO96*fa^^>u3TMg4s{`8Pw-~*(i3RMrzh#i
zfmJDHL13AxeK8!OdM=jCQaCT#oLIIf6;3HlFW}X><Wqt!;X=?&p{I5aydgZn3zSSG
zse0Tlw%Bf<y87wd`dB$Zx`I(+F5@7ql5YvE{4lkvTw2rH!P_Phw>Mo!9IWdI&1j$+
z?NwBqlh>S~C%P6?DZ}to5zZl@>KqynE0L?AO3MFed*3mJD<PYu7+pVjt6fk~7-mUE
zOc8(J+ZSo-|Ai9%?HbSII)i<zjHd|@Z?D&NNV2nQfbRJj4Jj#xYmcCwU_${Jl^B5A
zDUN}bug+y9#3y3Ku7SetD4U6%=yL+v<z=^t44m(7dR6H2y14F6vCDm5{iw&W%hL&a
zLcNyn3>K~$9UCA4iHt5Q=afTUK1^+WRei&NqCf_9!;$sL*ahy@dYBO|huF<K%IOPw
z`fDc-fi}y!XH-X3Iam~8W4j9`&)M4IMbE0K6*agjJKZ^v>3i}7q3V?b&B#kG^vJ7o
z98#fcQ*YOe57q6{s#w8^i4l*?>iO|z--jd#$`9VCzp_?Tv3KX*RG+?*kQjMrZOzKt
z%Qad|L*Qt$Qdt||o2J!$a}`hTBczpIW6-E+z9(<qU&1BhrBOkCt2TARtDl;;PxW`7
zh^|Wq_e>dlBMSu`%{eF)dj;swb(1<fk8Tv`(qvoVmsJ?6BOa<s5J<*#yGtS@*pV<e
z@u5UX(!Q!s55gnl2elfV3u=e*>s-(2VJ4Lm`@EVP=L!lQG&O}D{`sd7&o29d7nEPa
zB}I&6)O^g!;j+$rN_DJ!>0|H@vt8*2o?Ok;-2U)4YB-1I4M6XXf)cUr1Di9J-+SoZ
zd_6cY>UvJ`%#&(~%tJr_WEO}#ao}1<<z4Q;L>0-Wz<!1ymC~{}5mEE%>FEQyVg}-Y
zn#{3Nf+>6L*_wl&b=O@Z!o!_BJdEW<)UxRpquCQy39`0kRuyyq&W*ql_#VVoSE=?|
zdi50Rtc-I5Wr<U4WOs(;a*BM*Q_V8xk0sa$N9E2U3!>^kxse&+nz1w7Y-N{oS%2oi
z{?)_fFUkWZ5}AlLyL;L&t+I>{jgy6Qo?fr<{)2LmHxq@^!JbS#Xxm1=n&(XGyntbR
z!D=9y<y*|QYR+BtPf_n|S}nmQ60033^_!EsJ&bfbT4bPu?&lIaCznS9`;0l$st`Xx
z`=cQu>ge3DxHwGpi|b;CBV@9hM`QXOngYtjSeB$91G6yknUF!CL>t@*M{%guX5`G7
zf^^BajfBniD(U%^09CKWmy=;}XC(Np6i)}nn#%X~CU}j#A8MSk4P9b)rIyF{M&D{*
zS;cLFlmd)X6Y27K=YcOh7`p7pHo%<Rb2HF$T@O4JkkdTcK|pBXkI>|$hwDD(YjP*e
znjH|OhCZ(Dv2}}U^*O-d(rdfkXqI!2J0>3?{vn>3JVo>yoEYTWHx^)6kkXPtvNVRK
z7(t&_4VU`ONca19U`>OaMgx@F{VLNAvb*T7gnN4n*+lb_YS_O2St6nmaXj#Qd)egL
z&Zwe5%P`eq%Du7bP-k;bS{<eb>+Bt56S%#EbcoSCkTd1hl#qbyobCDpG@LsWg;pZl
zCmazbkID>}WBX^pS5YnPFBvVkwwXLDOJz%`k9tjoehL?I@htc?+XpJbEm(7rnSs;M
zP!%i(;wR)aoiSW!-nhG|F{e2AdV#rBP>PP4TF;1QT#*U6;BB(gZhZqLGU%!;umYWt
zJXC%AM>&8akj>8w^reo-Z{$QdIYdL79cMP38&2v`d>H$tdiyg#_~45)s0B<k@E#KG
z!-eR0TylHAPGC>#fD~|)sjW|Pch-;Jd!W~*+GE+#N`Ey}@JskJqk1F-Z)+LW=Ve&F
z*0u-Tv1%T?*fQ|EEYEP+KLtEDQqOd{QB!mTcvxp|&0P5z^~QQDtE@e(*(<oF0WzEj
z0svn8BV)o*LuJB~n4y&jjO+CF?WJY!g4`bmX||Kff<NLXy%YC|_F1+u$=x%iVS`w1
zz&<&rT2nSzMf0#RxH{#h01z~I(PLYzsad5oW59ZJypR5>#eERAxS^43<GC5oaU(f>
zds&$R-`+Bf)m?31Q%V<J!Voe}C$G2R({^=!%xfr#nJk9ou_jJOW`iXe3ae!|i0&Xq
zXt9MpI2KP!Mwx30ot~Pl0R05M_u-Gmt88}x_X1H;O<g7hWsU%B5V^8b>8#Q#tPw50
ztv8DCNkDQzCGX{nBN6F>HhPZvx#`_07MZFF$|aK;a@7wttQE9e>iNQ-VPj)kD*CNg
z)|S?D9fq6y5v<9unvMa%+8k`%hi4L36zBbgMm<zJHa*QFS8(SqRaaL(6|~i{4AU(4
zGg_vhF(orgk8A=bI!VB{O(51<wc0N$<shs#uI~xUGwv>T$3`6MB9^PEc`gjV;AH9%
z2CGaoIOpCZcVS?2q_l!t&!B+zy=GO}9t_-s01Z}NC}+r5+`o$8jN(Sc4{vbwY14~`
z=x<x=Fj^`8rK+Cn@gIZ-iY*zxBOJ<8MuU{wDGKM}6H>>Q{p^$zQO!NlS2MIk|Lp-R
zOAYrcvQ9~Ro5rUrHK(jSVymC9ve{yOLKF5B^Fu~ram3LiTzos$2kTzZ|1s}YO;JZ7
z)kw1puQ6{Ye17khw?aM?qWDV?u{lVr0~0q>MeYgGOO1zv&<Wg>gPWD`tlx;6>+?HD
zSJwH96}4_;fdI_{z5)1ESYwNLxmY9U)?L1<JA<$zAK9?aBcTAumvSx7Z6Ep&vFLI(
z16jN?;We>J9?BLv+E)A7u8KY{7ng^v+6$n=Dgs{)d2T9Ckn|1!C;;9h2Yp(7mpv7n
z18|-R(}TT&^(joS#&~WLP6H%`bu}Y^xDqdYNsicF)g-{<>`MJ;Fg3MeW^VgkxJ+E9
z=<8bN8LyXhgd#efI^&hfizSA^px-7yGoX)Du2$U8euMOAb=gicCHAvxX3cp~=+v_P
zxkR7}x)r7N-<L3ix-;|^Y@RIR<a_NCKD-*l(PR6{KB)v{Pl^ggMcE==c@B#!DQ2<a
zRh*!edb+YDdzzYa>e|oHTB3`iJ_2_!>RInxaBuv9bNk9Y83=(;Fp%6i>l{?1bU#2L
zoqK=UAb(XCbn`kI5{vfSQiw<Y(QWnFRiuVIn$UXhPJ=*sIA^7&?o`8cWYzG>r==?z
zY@sus`>J#q4aV(cyuG`0r(QR+nS52rS`8qw5999(hYNhIq8?{k8R|GdQ(_2)Sn1b>
zjLRi6UPCD@qq^LH%+Zwqvw3pKXVj<Hy}HOPQb@|>3WVAQ(@~W6_ttC72M>_M>r22>
ztnJ<L0kG>XuJ`qHrw)2<G(KpuYOIjzlXf(`E>XAc+CBJby+o|eRe9ngPHu|TgX?@b
z?w3^h`yJFR=U-kn#jTss%Wf%VWICcYf2H*l#HM52;|(O@^)r*gf0FdNrUAWXo!YwO
zx@1oMYrX7U)DFJz^n_rCFgOU1-16|2rDW$en9<IK2$B^yFOxs421dlrw<MPhv?<2C
z8@fKg5Du?Ou`ZwGcE!=1o;tN|x>TuJyNp&afUCQ;JGh^#nW87V@nyBX0t;<3UlOL@
z*xfg@QZtrm1xLI2Na?O&$Wa_Irjc9|$LaRa1PI__G)%D`>B~*TwR{FhL_xN0vl^e~
z?9O*4N<Sy~-qloAN$#k_aP$doAkH2Zr`MwJgp|JwQ@8Ow<y=t3Ebeu)s3l8MD{(mD
z;RZi-thtO_Xur+u{uy9g)~lbq>46U=NX_MozZVrlCVZDQcewY-eqO6O<4Q~aw3H(i
z6J=HM1Zy?=CPt$$!>bfy<yA_r4<zkb56DY@(c*}v0-!0oy0xg1`)FkWo}YfXqHIzr
z-Q-%2{3vF!;u^Q8pRw`wAAxHuzT_MJ^f|;@`zW==jZX;}-AiBfR6S7}M#tj(`tR@j
zl*1!6Rv&g3y|aN<O%f^QXo2{c9+WhqvcVdga9Gj${o(bKtuNU9n0^P#^|yW?>Ph+z
z=QSVG$^{;9u`~MZWO<w!Ylp0x2y%zsgeTz)(~Eze>&mAjTSmg97?iDZnRcn~u%Es>
z%NmoH%dyc~8It7X(^8PQXBqy!;`$lqsclWE5(wMY7K4@x0s<+G+{)KtemL1W3+E+x
zblot%C2_{7G1yfcwJ_A^F#f~fyhdGm$AAS(w5J`0k$&GuUT&~{A1jRV>(h#H@(|W|
zb9%!3Q}?7$=qaCD#1{lz`cn_Kry`-6Nyel!Ei%QTuAe#999(6>6Ww1cQiLHdW*p21
zNu=(@9~#Th6GSOdK~zvuj`JU$t=bu?1E3m!o6hdC$gIsp5p(FN&9<zNl|DYwP(eq?
zr~$5;8rj|5YS!V~#_LHvInY@kYvj$|=;r2MRwVCmj5O5O)tw@m)UK9cESG5*F$!eW
z{+vKOby0f=7t&|&xY_No+lZDTdH%2x3OeKHV69M=^#Ltqax&_SlsiS$I&99gXQacf
zwWV&kbdO&-Ay9L>!9b&<yt-CO9pSyBqDF;;d(O@C$^sVNl$yIHD--|Lv{Kx;KzGoY
zQGmzEI$3ERJR=w`W%1X6SKTG~=+#g$Xcl6;dG!KNec*cwr}Yq!JlT)1M`g%Pl&rEq
zLTi`Zb<ASho=`iA!+CRWuOb&qJr=fyx|(kka;LV}oHQL+Ru}<U4eTi++`@P=FS*|=
zIc1B_ycS)2Qwl}qg2bv(hQtr<5m4U7>?$Upy0wSZdMqjaI!lG^0lWLng9{c9Z}eFF
z2v4l$w=jCFus1E63RK@yi?I0Fqtofhb{Q?(C+4}c<)7N-%cnCCk$1IHrd6|=j|Fe|
z8Hr)ysk#7V4ligW-igm+8Jm`F{M%E_MQ9tizpwBlPRf5<iHvpI3mMz}@=#uuyR%rD
znb~zZ^4RmN0!^~gY;$EzysZ%~V!ZZYKgggsbS`$$?zTB9>QAu$r7J^+p>6F^58Pbl
znCdeedE^9#EMGsfFy2cFvIb{?_Q{5sg=}I8G;&u+2c`Tq+@_t3TA6RYBCPfrrn7I-
z%rXoC5IMMV=YSxu)9>T#iwgAo>+C-6{i|sQZ#g69oqb@Tnal>uOs|Oz7%%Vk@_OxJ
z=|UD`1<gb^nsPQit_f%e3&WHIZvpuNunK4iijSiXoY|CByoq1(bc0!<qBo-5aknl|
zU#8!=7jV~jbH-hcRHw3s^2QLcSuGiEsPA-FA>H>RetVfJ$joxeiPwz1labyfHa>&V
z%2l6!*|EmUzSN2+U`5RJ0JBeICyGU<;62QpqimsLIg^QB`q0iK)!D^$NZ}3IyrI3k
zjQ#VV73qC`9K1CB97Dv$+keO)|LVz9fcm^{yJO>~_r)S}^$l9a>)NC2Tl|-!jX0Ep
zfXPt0$9NU514~&iY18gZjaRYWIFsEj@7Vw}YrVz68f5tWejf;{<?G_-sp%d2H(Sm1
zb@or+{EJzqwBtZsx(H`!BCL16UCh~N=FspDkn?_>fwv<yHx|w6hNF$i)XYpr0AoIM
zx1V0TGaE8i`48)om3SM~Ae#j<&~dia3t&F2>NuwHXVoxIC$di2?toB@VV|Y*Ce+SB
zi2H*!A1}=eoN%{&B*>mHP8<=^z6qfSM%S5m4t!GWr;%?p8Q4JNo!Z87+7Ik952`*;
zbU@zo27AJWwV<M^i6^8C(udaZ-H}JaR3;{FPCK?EivjB+2PYoU5Efwc1*E4lDlU*P
z|E9Fg;w_qLr<m{GSRFj*Vem|Ab@fdI-`?yXXX6#p#^@DjvhmXV#ak62wSyazqI;n|
z<+lFUcG>*7u&`O)^NFEQOzK#VL^}uKPj;V{bCAdSuhozf_UO#pu+BCCAcQW~dveuS
z5rs++61py&-JntCBI#~h-sdF;r~rcyheKh9X~*P60jD70o|d$)>~4W0S6pUU4?L;9
z!XyP>F$}fd9L(6S=#Ml_0G&J0S(oIpZtW>}A(44mS8RR;Th!?*G@&T;S?9>B9i2|H
zXGXo`R|Af;{wBpC1AJ_l4f&A1tjX2Ck~X{}<x36cIW1~5De1XOfPP-xFD2F5_HqTZ
zoAkXT%3T`;m(w@LFx9d8`iH%DRDNi5y_raphd?w4cvf2q?Lg&Or43i3SGw0FqIsrP
z?n$)_U7GIT$j_L__=9$0B~6GdewJ_@DeeMS6oN~V%92_fC7F9Zs{{JN$=CIFhc7h`
znY&NqYE{mquB2wUwAD&=gt+?3_JiaHqn%5v*?y&`m~g91wV1W^XaJHpy2Di)m~#}s
z#%uI-=lx%T8~yRAL-k6;q+17b00E40HqI+(&DCO*Mp1sh39ZDei1WGChA=?g5~GsW
z_9q3zl!4U|MHS&COkT*(9fd~j1EwdP?s+3Cdam$*%5R0~j&>z&iUktYx5)X`HKR$#
zur2{sUTLQawcnWvAl@Ni>2;)h67){+#eX28-x&mP1RR>s)D@#m24D-*YZRX4W~d1j
z4%q{Hj1sUhE%-G&?~SBZzUgC!u^f#r<q7kfm%?)kZo(@&xz~a!w9UW;??)qsG9{YM
z7oVBVY2dEu1hy=hoqv{C5&<5RUuoTM1kG9N6vRTP^!xj_N<qIhy*eTYAG#QJ*Q-Pb
z9&7wJKbG-aJlxjS7L$JQc)o;f7yJ9g81ATxUHr~nBe(?P;l|fi!)b+0?z!6Z?4~@G
z6r-i&GO4!OoDPO<yPVUr!VaXt_c(1T@dd2*nGECo3s+QUw`#^q0r-YPRo`?{i|Daq
zF=CYBVwjzJ><Sw2vZ`Ggrcsw<D6fZN?Y<U{x-QN`3L}=ZqSTbcXC`y44h|PKHRXvE
z?F7TPgr<ar&nBQN;@!q?cc)i!p1Bi2B{XMoz}iU<t0bY{fK}?5QhG}_{vK`LyVvh=
zQ*DoLc<!VCoC{=Q^RDD3tpaq8dWd}PO<8|*0$S$dN~(Rb+g|z8%0OeWLNOnFQB*M4
zx?t@fKRK%_aHaaT)1`%Byw=2;eZ*FOY%WAkNosXcKj$Ij+y)g7QITW%=HN#~(7Zv@
zYHWV*VFC&EM)D=ljDOG&cTzUtiqd8H$4r>h8Z3A&3lwI~_lejzw6n=&JovM1Tlzae
zc;1t9DyJoK6f_0lodrXJHb)+<Z++Xv-i@>~Fx2%kBM~!x7lKzv)Wx6<9H4&)aq*4E
zDp5VGQ~&YhDz1iO=K2xwEWX}a-5%Gc%1R$<dqzNyN{@!OirW~|-;{VTOq+~6&8PRc
zCVxaBe$;`qu==IK{g<{~MAgWP<XDu4ab8_rV@e(#Z*t4US;}j(!-OLU=Wuqf2JH4P
z$B)G_2>C5pf3_^I8Ig+fwawnB>WM`as(p+R<18*7#SGBy54|g?s##E`f|iDyA+43x
z3D9P-`Po>-wz1GP1lzS$vir?h@^#eciv$c_FkFTJft+%Q)i!%S5&QO8uI#B9Q$cZ}
zMFvY1e^0~63LC`vw9spCI>X%>v6O%N>=`KdT?M<FbN?*Z2R+05-SNQU3R&a-cOffL
zOkOayx;j0}DC6zh#uQsbkYw+8w)(;Xel;{S!>;h8t?bi&Iqtf#f7xp{%dwUUU#o(P
z7yUt<uz!#)arms$=@h;N&T&!)wdp~uwm5&Gd!n$4=#kxz>37b4xA07tls7u%(w*Wb
z2!HrALM~K2Jl8&W%*jq8fGG@Z!`;e~Qb;mb=7^Jy1D?kwsN|$=ZQP%BgGCn@AGZo)
zu9u^u8xml<27(b0b8{wXF86N;3Pc@v!hY7mw4_r@wbTgrj=!u7{v3*5wXhTq%TOJz
zjJx@@{%RZbqmT_~hTt=d_};I_5T9eyq9~IsHIXRg!X9jvsZE47y-=&H)I+(@0VjL&
z*5f#;TRlnMZvwZxN%onUd(h8G-W+s9mb!RST;Ub(Ba+{HPu^zgPX1I=7s<yLiMhD5
zbluH~JC&AbpSoYpsbQzF?!%%OnL8}yjKu?jL9Pw?598i^*cRb&t|UtTm@V^ejfYG_
zp=`KZTA70qYALeSEnUD#Ot>jt1+5{v-z*-L&Is`8@E)pMPJ*{7Qsb(+MRi;HARKgm
za$AL{c^q@A@%^_X_`BoMr{m7n{y2X%RlU-sdLL<T%U0F!FXisNg%*|>1?T+f*rwwy
z>*%`ZVA~)5+Ra_o>i$|ezRkZA{@baM!OflT9RqYvZU5p<|1v&T`=eRR+Uj6Tyc+dQ
z#uwvy4pn}XOLojKZ^Uuz6>BYu4d>BQaM6!9^aOpUda-NHtSm@#KnTCu7t-$b=$+>~
zZvPUeG^-lWm1D0TJ*r5(JS^%`+WRUJa!rark_V6IjDw%108b-<H&9GSXmn*xTwL8-
z)0(JL^C6WvxC@TV<AgUCyzWt)qI*6)sA5le)u|0S)g6~6ZHO$6tGvdB7ArOThQLBB
z1;Il;`;L%3;DLd>pS;<+W@{RAcHn)!bDlNavHAL=N8}*S*bG9$?Xlz1{R}>#^!a(X
z7P_zmj`6G;D36oLIKEl2IDXjN9lBjUY{N&x^zPV|3BRp^Y?lNO-@+dGTK;`{!7EvH
z!$e}+U%zQg=qc8!Lez8bxe@a&+`rv?>Bu&wMcZEuZH_($wexY>v_aZl_lRH25Qu+W
z>nL14Q5f#nqPxBhrc@55bR2x1VCWq_Ob${~2-1s@DXq%+G8^J7?oNV3CQ86ahQQQ1
zNl{nltd!EQ%E9jo*XoQaaP#PfM=+V3gL`+1LmyteUFY%z5;w@)c^-QZ>^+?rEhP>1
z=(o$Z>1r>6TV_ASefhbh7qW?$%q$Z-7>+F~N9}&7J;gmgTMy>T^P%_uaNP-KHbcDw
z@58``XG%P&Y2H?QYVX#rs@N&kI=f@h{!?%S_?F_5kt5|#-?dHedGK~pe6dpLma<$F
z0lUA=4~UW!xQao@uD{my{=)I(SJwX7(XX+5mXL9c%_?vVtg15h;;dEXR%`Pv<7WrX
zs0<}qR4c*v@$^Np4CqVzzw1j8r)_UxGi|MqI+V|T)!OkePM9~K_q3DYvhKxzE7aB#
zXuEiNHTn{kU#z4(iM~C&8~jvJ#^0);(=u<PtXA05o3V#qtX-em3W>{;d*te4M}(ge
z(5{cHXzi1MTF`=N;(C&`v@gmk`xdj)#(&wOFvO(qOK(iBYg!t3q`&?n8{?P~OCsp4
z^f1Pb*^OSk8D(-STHy`a-_s<GLMffJo=HFfdDMoB^HF62y%~SV?6L{cocD(RPkq%p
zUt903L)X@WVJ{_IGAmLmEUj^W8+EOC@zBU1mS-pP*^V#bH--Kov_Uukjm*Pnt7X{?
zdfk+=v4?MroJJV=m5;uaKGONiPSDv00M7`7hv9a}_Fke_g&CiWTIFy9jNPWz9_4lt
z#Ie%L6Wh1RT<ame_WQh79{HtLWd5>})Z@y%h2X5yn>%f`oP@azZ(tu5v0YyAg!tX|
zeMd13F1;S$(!c%Q-md8H+u4Re=cZkGS_8Dg%WLceJ=35r7<un`ACkAJ_y1TE^v&q+
zugXf`DVWnPxFQXw5}ooW_X$Zz891(OBkzG^SC_<T7E4ayPg*+|ea$?ak!1^n_S@(;
z9|G`SWrJzVoaL2a(N&&atp5+a7<f9-bkr`{pC#_6rbdwxNl_i>kqQro7Y^)5JXc#f
z?k#Nw%gO}ZxT+OF<s<OEV7uC~EhTBSyjlL^n~Zbi*To7O!{FVy6~GaEbt4fhd-5r1
zVEx1lLgE#mF+kBk%U+xqWNOg8PGR@bjNTV-bF9^}?Jt)Z8$J5j$CkXuZf;`*9_4aE
z_Y<;#UQE!M8-(FRTU$XQzBMk<y~s}I$hK{Uh3T7v9}0o9ctNR@UXTqBq78mJU*q|&
z{-PJ%Jz1;jZ}zmxILMX!bq>I;srVEd5fR$xl_UL^jq`)QI+*|0-j{$wy}o}tr*rCm
zDx6cHWND$YSGEx9NVZThmN2r17}>WmN^v4&gd!wc491!)W1NJTB*Pf{kS#M9+Zcx7
zea2Mh{C@w=Iq(0v-s^hb_qu*_ab4eGmgoCC_jBK$dwD*$3}=H}+oj3VX=Vx|liBG*
zCu!Bo%2R{w77X6w>Z^gR6e(_K$qNHkZ6YWQ5k<2O3q=*bJ#X?}(i6-z2k#qgzmwQy
z6`A2J>*DcZWMr&3KU-9Nhk0XTo(4)k1*i*-hfWKw!}62^&?hjK(44#dWWRk|g#_i@
z0cVd7X|y&0`|P!9n=oUjdpiUCyBoZ^kqa1>(AV*8hfoy|{{6*HaF$4!-C7759=9C^
z-+Vm<sGTjHxLhEUa=x2EyQ+Cl6$mKDOLH)>q`EOvoLXVr*3>4Z@7-=r>DEa|ST5k^
z;26VzZN(-0(&fM?uZN!9jdi=neiloo-f27hvEj#`DcU_GEPspwmc`|_=G>Ud3LQ8+
zvB2+l$K9pM1Ma}MR4kKGQU~nE2T5UDCaELS$pU>H=KSEo5nS!#gf=pTz0#jLEPiDv
zaG)b)L+V=agto)rnZ7=fl)hlsoRT7{<4UJi+8_9Fjs8X5m=FD{aMbIb2BTT(G7=}x
zCJKf4ll_Bgy82z)8DKEL(nWW7yDSc2jGBo>3HkZc=HNusx$VHpnlDcm{j}><c8B^X
z_VC?`uVOkB394AOgf!|8AysaIoqDKQDY<W&tvY}}C(%{EiU&HxKzU<4kEnt@F|+bC
z8+L0U9-Uh|v@pyQMg9Sl6ka{_v)KaJujg*>KM+@4Gb!X)QLe43x?F&MWtLx*hImZq
zxxrdpjshoOTCCgWbnUS$U|WA0*qvi_eYb%v<fy+hMy!{3FAHo(=)F=wd#hK69ENCh
z!QhgmW}P>2df*eX;+(djr`1^~qu~0MM%~~ljf~7n=HG4({;kkLz0Fq%Ncf6NS-OHF
z^hcl&`YL5s38jXvmpt@9Rc_3qnM0J1nqqNpnT%kyyqCTk=ex-SBrai%#@dPJziJSR
zda3A)`PjxGw~l7pqX`7!mR1E&f-hQkWNxfJpLUOLY-YNPUrc6)xlOuZNwsoeZ&@?)
zyvYz#^@~aXXhnRO1v%cHmT`0_V=(Y6#DV#qrG6Z0j=BPip3-o{&z_kNutmA!W{6(m
zm9IM#D2oU>>jr9wNcl@6ESsBXZP-5c!G)HgvEbvQv$@`$7gi9%B_>qq1Sb&UHBh_4
zGj3R=c3b;ddHz=6Y_wph5jN)AU&g97+Y)`rAYf5`oSp;OC|;~m&es76Eah;Po(@s<
zI_B`u=N=eTbNP9bCZKY&fRr^?mZK|gL<OJU{1akwXgev3cztD7o$;x;CTl3u2n|y|
z0-=^JNg0GJ&>j&jge(WJ1nxgsmy@}gyGuP?ehHHVqp3gQtj@23O&gJ?BsRTc;lLCA
z{~du^Z~C%O%3CxdLYb0yF%8r)pE$?T1{@p~<3wz{RXs~y-YRV^{<-tub<HY^i5K|*
zG(E=!;K!CSoZf;TJ`@o&F^#px9087Bu*O>XMV2iyyU&t9j^ZOy&ci+{#Sq*>5u?cV
zfsurOVIKa?#|wkJ@JmWpKO5k7{Lq|-rx^kNyfPhbGUQ?A%6SyA9q2qT{b|TOnkmU$
z9t23@?$U(?>iI9|QY#jkMq8LnY`S2KRHF5b$L}_6g2e)Dfz9E0_gPz*(~fO7_nK){
z_PWR~@N_*cI<d%IsB^pd0jzt^p@byEjkj@t``~KB1~XAI;~5Kpeub~&FDkQc69F<U
zIDCIc_qI?k{e$*}fn>4O*EUo0%|<)SKV#4og}3B6|9yppkj@I?dnMKu;dqDzB33%x
zYlXi9kOr3YTCw>O+o}N6+!n)v@f#a0!oBWO<cT=&oJPrxjBF8hK1lj?(7q#a`p(AM
zmQb@GR7a-iv#)xCH>?nkb$=XaRc#PxjT(n}eOqlDqDtC6OfdQr1O<Z%wLFCve3$9u
ze+%qc$r_;V-Q2EPr>jy}W*$h-_p7pVAA#K|W(f_T{h4Oe$ATB>>+h*Vv3&I6b3&Z8
z7mciIBB#xFaE!%+|IN%?g`rg`ILC(-zJ<mRhb@i7QJ@_lH)k8c7s_*YO9nV3Q-Fn7
zp3w`b80+L`LHgtWpwz%%fW8$}JG)8uW{MP~rTgh3^I?UiGc!I@*ju+N<-(iP6+$XC
zg%7G5byMDVPpZqnS8*+fjcKQBnc&0NKv^@ECnB*jRDQlY&nYcVQJ_08_Bit#jteY)
z9R4b>HxR$^g#RW{!18#RbzAW7?YLWw=oWj@LL5}57}IX^R|OaKl4|RL+QF?1kN;Sx
zaxg3mpHv4<{Iw9R8OWs_h(iep<61JDTb@-wKh9ChB&f!F<c|HZ&DhtDdZvo8pTTX5
z;V7rPq8@UY3INQWos7=_hAns)p584}HB{A3$Nc<6fL{msZmc99PAJ1F#kxDcD|c^K
zsReXlmrYHHV|l_Ga}j_c0T9jro;7h98B<Nodw}?i@ZrO=($dpYBN4gbMpqZog+t63
zJ<Yt8=TJeRd!u7?t*r2?i}^vbN~_h?S-EKd8z&fPYF^ck?&^6Voo)yqv&%r46U&<d
zk3%Y8CECE*+`C<C-t>Y7jG<2p!Y*Mq@xdmCBG3!;fl4_>5+#!&Td=l{t(-EQLF>sT
z3Pv>^!#06h%Lflm2yn5e?2uXHR$UAQWu4&XIOl2|KU<}>AUS9FbF7~ACS!UuYR2I@
z3of*mf+b@?@1k;VpT)-tTZsJ0yi`pzuiJOhpV*$j*F9=pf3kD>=E>a^!7B~bV|8m;
zg%*5#LTB)~i<|xisbNA)LX=P7#LQ_yMye4qOI{d?T0n^#A%@>r>&WQ$XOxd;;^h$)
zuN2c8zIt<6R({Gbm>a}!=Jm_&LNG~#58cm+>iqu9n?AUUEVloV+RAxK;JLcDz7Kuo
zZOL5Cmh-DweSNDt%u%L#MVdn!yIHel_M*J<jeQ^2(kH-p6ojR#PBk5jZ`Z)iH{HYZ
z-)}w=SR7Cxq&iEyF_6tY^OSL+G;LzGcN_XgwFcL!rL#&we#E<w8QLx(e>Y|&0vEi1
zvbI_YCI7yoaOOLl6o0~Nn=S3k5&E=6ZjKQjxpVN~eQm?DhcR=%E~r!CvtD?_daM^o
zp4ck}pO>{`bRX3}tuMx}Xgqz2*5TR^Pm;we7mOHbi1%75)57lG8^pg7*lx&mW9;2r
z*LNDH^^KZVii^FUU7*BR8WSjnFLJUqd1hu7xVTzX&K8sag^X+MBK5qO)lcavv5UCW
zaCxRBzB4fVl1|f`qH61ntAPyXshpHji(w-}op$wfe7wyi&YyVuwk6*AEL4Wsf>uv*
z7@G?+*=w`$+qWY(l>@FaV4M2Ybm$az({IWTp-9vCPDLeKeNA>Mh4kp-smkYeEr;XU
z-N+hi+kILp8u`zvom^$Awprx?&$oTfbKG~B2T(YXJL1JVy55&+`(W*p7wDH}F7|s2
z6gCMnaRur0-P}0Yvjun$Gfuz|6Ny;m6RpiNoOL0UX`R-WuUlUjD|utRe$TR(>xGd2
zAsQ`+loEWg!!9;EgnOHeB*d_NdIX}UM=ptp8Iv8KzHF5mumuRx5Aust_OtCE$IXOW
z=x$ZIw)Lv6XOFy%?TXJP6EDn+TbhqO?iUPSOfeD`ICJ`lJ{FF5&`#f!t<0ym7;T4!
zp*c?k+8EanM#H2Is%M`91XX;S%ex9OJr6x=%SP^W--X8MejnewT@j<#k=(Z6lb&2j
z;YU1U-i@y$72WMmJw4~iTxsT42{cYiRhf*ztmZ6@3g-&d(1(Crh3&{DLIFK+iXYtU
zHlDN8k%dZtQ?b`t@#gg{?a%SpsOfeRQ35`C5FerbRCx)R_51H*M0Bv|stj6jwRY-B
zu)EQ1%J%a4>YX}Q=fjbC7Tep#at{~nEYPWYIdy<_@Hc{6*ktM;$oNX@;<Z~si`JqH
z^Cr5)QklaJ{N`n@>kl%92C>-?_09D=Bv&HX7!BCXHF9661KC8Y)3_N<&l|Dcgv?fL
zXsmDJ&KlzNZIj2>!CMe@8;m>)L4Da(u^7N+bB7r5ebb>W4uDV{XZ7q`PsMbo{t-)L
zREtvUuRKAQ1eq<NF9(tZ{M*)lxX@sCW0aZHYBUuGt<?&oz;Z%X`e3?A8%YmlE}sz5
z=>ts3ce>>kjrfmZm0ol!w%=I8CE*+lRGV{WTiWv(Z@J?sLksSyn-zHxjR)snC~P#i
zE$sG{{)7>A&Z@q4e6s=ZAz^dLFur*Ypr2J;e(YPfHaLZNk$F^U_x>je`_?z;+1$a`
z$?4mSYCaeni=?Wh3W!MJZ9(`gDrhvUAl^`23g(onz{}GnWMA=8*UpZ&An=!_9p+3P
zo=5^A&#^hC7r3#M$&fi~{(v?5vp)hTEEu%fZSf&j&VVtYm~G)67am>;P01RYEvlg}
zIpd@@TI|MEB*qIV#*zXFB2Vmcj$l7snVF%L!JMCh=w;m7*J@Iy;u8~j<)LP&r>7T|
z(~W2-_2g@G3-u&LPm@!d)nnCzYMQ>xaF=vu(;X7}RjyXQ5Zt&yUS534Amm7v1aJJL
z1?g)4@{Eg%OEOafP&JZ^DM-C673$MKIME6}(T2~P@0Zll%8n31)~z)Dh=$#P5R;(W
zflr;R@D{MekV_u|_~RT_kdzD@H*f&5a%^VT#=n?EfPrq#w5iNh&niz%q-3WvZ`!12
zTZVg+oJ90D=VX(NeT<@&5gs-Rm&ZI}^I>@jxEu?9t6LgAe6CkxAeg0MdxIJp?g2`C
z={IFM!gt}a{Uq!KBMEWb^ycmOb2_s(jML(}NOXMqhH*q%kO7KXYm_!sV-p^ZG-{qw
zV@`EhU<cf%_NHsA8N0pK;MM{0?yCW-Kng|o3)@3L5G)c{Q9kQ;Ai$t1D#{8lkOym|
zdgHdzf#=j($m)a*^rq-cPaG3*kzS<_zixWLf@GvbdAg~Ltrn&l2cJ~B9Le2Cpxa)6
zOgxAPZIflW5?*QTCT>pA10{JQaX})_TZtiO)|fHs`Lh)De1Dw^5i#hrDe0vOghuw`
zqty*%9Dd?n`C#5jd=;>k&c&yHik2w)z+%g)o2PC<$>iifE2E>#Wmr2`$k<UlU)`a5
z4FKB=;w!OI@M*iKYv~Xo@f7B!uYIbjL^R^^?+_4<+Xa^CTBY=Ay{b-bbLDSEFK^(S
zfB&<;!m`6@nSlq=SrjZr2J17V*^W*_n6aGlrbc#@YR(27-Y)TyIXzZVU+#3thnZzG
zsLp9v7nAVD*lRqZqVMeKfaylOdLnET?Fvo-=c%Oe+T6T(30xWhQc!7?a;5Qs8@G%#
zkJhyi<z?0@T+-KY<*7w}8)?;OjMG9zC0hSr9lYkjU3u>Bg)J*|)i)SKhZyRRr(QL4
zZ~En_)kPzcH&DOn>pF~jCSA{(fgi(Vgl}h#AvO#fqsL|n02NweV<QmX(y{6zSC&40
zsRdAe{rwJerOJA?x#Ey`_YrtiBO1cWIZkQ4C#m$+ft(>M#<VX`ZIo_2gEApz7#x@%
zORjBz@<fXw_om&_$ovTd|9F>m=GU#aRI|o+ruA}4KMGx!zxTMoiO%aVMltR;Er`!j
zIzA*_1R}V)Nhn*ZbO=P&wA&`=^A7~0S`F3eUR1OhcXwpu0F&y3#zK)@D+69)4bq*H
z@$((Aj$Fa(qq@N~lxH-;-f^li$|ZQ@UJLX{+=mYz9vYZ=SS@~bs*oVm_wi#_1|dhE
z?dNe6zpdSd=H9M$hW7EbQ?~l%1G$H*RhOkTuB}-McUxgsoptc^J0v}&bZwEY_4Rmh
zw8WK}awn&Ri&|O8JZg>dd}SbEML)GuK5(&3k;VJV;^`ds6gvn=;SJBu->q&I-c9Q2
z$^zWId5cx=!d|r!H#BE|_h?$2&2Wd*%|AY(GMjd`+l#j8)LXBIlwRwImGfAesh)Y+
zZyz$_DmH0A@{TuPl1-J1T?hq~huR`bZ#pvj%Kgv^g359M>kOx~4$je3|FcDaW|~Fa
z1!zhwx_l}I-yCxNl5SWofPKz1_`l?5VKNTf4I6qnoPp4`-n`IsoA_q7NQ*=_J+ODL
z#)}U592XfA=Y_mwM{*%@d?H}*hT1c2TMSn~-3xHeltnOKe|wv`l+Q;v;L~--&`cmE
z$I_2?=Uv(+V+28;Jq@cQkHaKNnM`DyC0)CLixZ8xCOQdib+KB^Q}WSGb4n*@AIbR0
z2Ysw;vtOAuM0c#^+KWZ6*3q4fyviPFiy)@6ld^Kt6WyzI0F5;S0;vY)*Lm(=@c#56
z<40?v!@q^@!0nvazw4ksPpmfgfCPM9CVL~&Jl87RdmO=ttLy)OTy6$b?S!$Pbv3Hn
z)=u3+ZTuRBSrgR>Kb5@fwC+L>v=b(rZ`WYatAkw(NVwlCB`K|{3B}I78s%CIu2aHV
zBU`VfJwmH6t8*7=PfdEKa^+q*Z;q9usbcN67A<J{lxSLrGHp1Bgi4`SY3<+^dg>#X
zvstIOIZM@5XXY*S*cqv>)o;V=D`t<ahhV`+$CRt;f#em4A&{w+8<?`Vt+ZI4?eb>r
zRvI{Ty?ib=aWj{yjR+(aY^~9zmlI=0T`Xv(@aFzrWR}G!9hZ9^f)4R_86J;x4Ax8E
z?sF&vE98fOu$b8abzb89ZHgGxi&ALL3C=1q#u0DHYe>?XM{B)=iRxxq8}IX5>wA~3
z4g{ft)zSek<FjUAMDT*Lb~1BqC<sQbrwpH;svu^~Q_~+7CDFpBQ%|yzZTU}`I?uPn
z=vlE;@bI{<HmO#tdi0r`v9eFk!y%tZnWaH}nOtUxU2{x}oW8s$^m2CZF&*(df1O4L
zw2Qq*((a>+K-SkCQT%Pz`BubFfWJGkIX?Ztt04O961B5SF5uv3aHNcoQA-slTFxCC
z&=XhN%)i(zBD?~nEmW3m^j@;f&R*c+6t#XAT)!bt)LvWG(Vcw<+8!7O1=Yj|t4nvv
zIf3aP6tO~Jmev=IFldAop#O8kP~Qy|6<TC3PWpUoIX=!A;iGe<W15|UsvIK)TmgV%
z8w+p{QGxvmdfUx2<`0j)+YGoS`RBaZmbQmu?s3<OI3vo=*2K6>SB>Rv>Z{gBFlVK8
zSUl$<&MB*5k46b7Y~f<A(4!Gugx;uk|K8aAL3lLaN;JN9EqOWU7|E&0J*UbTyX0q%
zppLcQtt(u_E)S1|O(%(;BIeFBe;3ZG9RPYAkSu`S6$$}2yQyn=hB~+FyC_;hacT>{
zIN!Y4%|WT|HsMTH&c>&uwM1ZGRtvE5bHHG^xFFX<bnr5)Krp})>8RuiZ4q0Yh|e+Q
zulUIc0lT$LMh82;sg_MuLtyqedioL9hL{rYPpujUun54_k2H2p(^G;%nO*@=?X3xo
z^{A_E@r9SRp<C!Jo)NLRn@?Lwt+lh4T1kwm+PJd(vm4tE*e#;rY5-Gg<Kz^_`k$h`
z5lzze8+zh-<D*~7idC*~iuY$+WYj{;%*1mlX2D_96>K8#+{=9n1EZqkuUVtRQ&r-_
zPy|$Vg==n|<4O=Kq{P7?+4Xz}lx|sjUe#i4X>@NwwQCT1gBAl5n~ii@-*~f<yS;j!
zo~q3oNCo+q0~aOR46{8`N?H;T!MTP_^jlS>tMbOQ1$AA=2_Gl>CJ0a9g>e|udqh1Y
z9HhyP4=oDKgshBo?M-Jq8Z%)2phsV!+$TYF7uTu>@yFE;!`DX>3t)+*rDKI*oSZG+
zndG1y9FSRw^HTRYdEIWkTcYQFo!T!KvhSX>NAdIR-mb61xIP@_+^)XZ+;+OXkTAFz
ze1Bs^9s8U+c-)b5E!+uCVwsx&!Tl+NdLp`yeoMlQ&H(ZmJ0H)WhAHB>&N7Q~F^xKX
zN#XlW*ksBC$hF1Wi&*c^QCJ^@t}=q~A=KbKLwiJn#}{_Tple>~&c+RCRy67AE@fg@
z4-T%5aN{1Yq`b0hadL>}j?US&JxmPUxltDu*5YKYfAB%uaj0cMN42u1tBV|%{u@3%
zedu{4@<(RK*2Ht*#^wM&DP3Q^_>&+M;Z5gTYNT$K2r<2DX0dCrom@3Jvb!~MoW&1Q
z3#_2h#Ny`-Nv)SXKkSVv(ova<Jh({mS6o%Qf1%F`Iueb^S1}URsV;tL<Qk>AAhi(o
zgH?%*rmJ+Sz~x5qZppx5`D<4)N}eCVY;4dek-{SBUXH=DUd|C#d%35RCRX9N)~t58
z0b?O4UIQ)fimX&J7|=aaw^yR0=S6xQBR|~5#TXO9eBKQbGvM)1hF5jYWoRR7*&Sip
z4H_t1eV&nVn0CMw;!vkb3BCo+C2cBo&K9W^#)~8*Bsc_{t%BAH@zhRYZhn5g`D6rI
zphLnnMqi#-aAj(xsJQV&-5Iw*jVWSk^hVP~9eha*wHy4Jz~S&FQVDE*?;c!ht9|ms
zQ!Kh}?%o)7;^(QUE7oVuPWo)YVUD*N7pud1RX??U54sE>vqqbC@D85Iq34!Q1gDQS
zcc!6VywDC9EDKnCPPEGg;f1TvcFRfc<`~f(zTgdu8+E;phqep_#|dwxgZ?ZETma!F
zEr}<d-y<myQJl)ux@+M!HvkFrBDTHC%UQj(6p*@)`v6S23ySl6<v*SvhIT6Q`W29O
zzfV_J4-lMKgHOtqZJjdaxctdefyMd<e9|b9sfUwMkuJ++d8hC5j|aY9)YQQ{Bv~Dc
zJ-(Rw7}%Fj51)73XkCS%OtNcdUwzyeomIngGU8%>{yq>$cw{F_6w?9CC|GDHE01!L
zL{&-hX196@{WYoVc9ICI2>_rJ<u@wf3KY8f<}o7I6s_>-+1lagJnf2#ioPnZToJ&G
z3x3*|YIb(Y{&Uw`-{&qYEIe|u0$Bf=dzHg|Y%jiiAQ1J=nfocasK})EK?H%myi5k1
z+u-=QUKJO901G?jMa!x}Q*A%|QJ3*~gO2AXElQ~ZzHmU89s&3zGn)skA(^XsZiZ*`
zbt_ujj;Ui#x%(4xeUu#svKNb7MMPoqDI4c#tKrIG)WwxiV0gL!%`U{;JP)wou$qa)
zlh!5x8fa5rdlJduTfG&n_jBQk4=H{Fah^9D!a0%1^rjvnF&CJ~DbVQw>1ZAClNYnj
zy)x)`Oyhu%65qd@8zGD(Z9>o=F0-PlH+16;Xc6RAIhX@(gbc8Ni=kzvFJ0a%WV5@_
z!fEE*wYjzON)#ZHpP@JD>d_chepC5~_2wTj5j-)2@Jd@zQL$z~mV`Y0Fn$8dwQCh#
zHpR+ZaB%Ds?-%MT2YpBYT-68NP)vdI5grkdpe-UI8gWWgR229JcyObgY8I_jy38s(
zCy4U0zkKA0lkp(FwA}jUch!n86Wr}>2il#y1RbxDeNrFJ(As#}(fcpj5R4jH6d3ND
z{N%mE*^wUr<Id&=b+c$>WTeGT6fpM8)U6p0be2t1)j!g~S;p1Ka1`ozEDs+aMU@)B
z%^k~@(6=#hv)2uTucaG;o+3l@F@9MB2aEDLWM(m@x6)zeB$Zhjc}{r4rnMMEn5TOi
zirHj|*YBH51MmT;!OH^{Cmz{ZB|-Bi+7Th$CtJmjLLe?1ulc%EN8vJ<rK^R2a@l-n
z@7By*7d0=blr#9Pc{GqQl}qUDed1Z0m8+$wHW%tL6o@OOlLud2i9l@9<&8~~JZk|>
ztRgA6%(93_6|q%Xx)leND_Xgo^e8yZ)XS?3G(#|osrh)z?WTKo%=OESdMjq{ZkRtA
zTA^7J@6&6wenKmbKP6F#Qk4Tos1HWB2Ep-|ZyUPmjqNEwU*z9yAfvOu#Z4(~7V6A7
zo@Vx8+l*FzewQbuFmN$OWuJuD6Q2-5{uX#X;LBcK$(XY3P(Y7|EDxf)<B~z33Q!kz
z<Qe7S(-imoM8IxT^8<&ImS>cI1C|8yxD0&hMqND~DH+qvWO?#Xt+}8nH19o5Ch5tD
zLZhAx#@N)#2QoC&bmNcoHVYcD0ft35wC}d*?;#@B?SHD=@AwfkFmY-ZV)X<{Fokx^
z&3Uv2bdFzbUY;TM)WJKbS1c_HRD+hsnA^yOf2w-;nue+(^Gw&fDgp9nXVC8;a5P%c
zdtpqc(Y8cXQB^4RrTbt$Xc1*8#GNF_UazWs(_@W5MqNpx^Q_J+)zhUoZ^n{ys*=}5
z)m{D}#Jgm&i`&4fD+d+bC0{uC{A&Ts=ezJENc1@Q_u7C?M1q2XfRtYu&L|fF6x!l|
z8Ja=^T+1(NYb|+rc=8Ji!Ca$^O-w+gC3~_3aOT{Fl@{y@hwoBM+0dofHe1ktd{XNN
z_EV0iH}!0}<cN9wjjOB0+t8O!WL-XCPd_by`y=uHb(S-eP-)F~DteCWx!;5NLF-G(
z^<OsJc)n>dyA}?lzPxw(MkJA_l|etnIDTu{aFF(s`m&u>4~`!Kowiun_u>Fiw)9CP
z#?2mL<-b{v`YZcC6Da-D)lLwO-g$4|&U@3)aJ#>l=0&q&UW*GyeyK?szVYXxlP_uz
zXg@ISFJwFhzt6G)L%uS<cYG~9_%o`lA|J?cc2rK9{~?Q2qY94yE1=oC@OtBEyx<tS
zzKnz8%uaTd;XhvK{tjxuG9H4TL7a!=zn2WMWF9Cqp<Ug!Q2=4n_Xzx{MB~pZ1qI{&
zyzY3h9zj+<bXN3C@|WcQAA2WLOUCp|rZaROyQZ#wB7waO1!e#_u<O3SAGB;(MJuew
zKU|6R+%`S2@9K$tr9lT`{#20i$G3u|xBLCt&0p?cn1<fT{EL;6z0`Rr=;J|d1WDk)
zfr>Hx#D@CeXCisE1@98+Br{692xgF{Vw{<j@~yjSZ-w5v6&FJFn^nN4;$Ahl-thM?
zamD?VB(b_C^6qXSrFe~*6!q<Q4q29=0$|Pq<smcQCsy3q?W6ONRrLWLW7qU3RZ8uA
z(;5`^)(iFipU5Ux1R#f-`6t=Tyz)Pg&DG$)m(3j2`AKe7TU~q(%~dMkX!8NGZirN2
zg&$jYaY$U!qbTX%ozxf>7poToN*Yl4rN0WrS}?bTfzF%LP=oicc5BEJKwB|W!wXNs
zW7*U2b_mq2frv>GY^eA}x}X4mcfZ@Ds16ZYp$|zI4^;EMR5-(zRGM|?<6?jhPKB<G
z3|Uz*ifnA+9q_0b%wINr(Pw=)ohYHB?31H^H1lj1oBz1r5=eUn3`o0?0$ZMkEZe>c
z@*KW*4}~u5o)t{WE3GvSkE;%%4%{=?&gK@o-Utd$T_w{#%<s+ZOzZb-QC_VT^6{nT
zA03dTtPg*fyE+uuC?O?{#6G`-+!x){r7l;{m#>>*$`<46SdbwHZ0<4XH*|vBH9B3u
zyYJNm%7$?BqI1#K?RD!Cv<nRRGjauy3#SJ+iYPPCt?VpE=*+^$44Q1!ptO7!;YHRf
zZP4J+$Cu{fZ!b3<w8aW))p@PTGW?>J9e-5w_^ld<wM8Kwc_jLxor?-7Zox}a4NZ2*
zH?|xzI-7PGMhXpFV@z5ZnLFPX$LT??T8ikn1Y}B3NX-uW^U)}i0O$L*c6Ma){Tm)P
zL@4QoxoE^?I5SMo<(<PvMmK@*$F};S0eFmMsN10w{)6R{t+??;11Tw+<iMFX&KO@$
z@^Z@!xzz{xa3WNGwLS<mIz+v6i)$WDd{pb^X*)c=7(k10v#1DhYbbDng4?Hkj3e%w
z5`J8f#;K30aKnk_pODa38d_*Vi|AM=7836#c0a(j=l8i-1rZby68Gf_Al9Y>1l6Bx
z_<jgJdFxMwHeZIhvoOhY8@j^P#Cb3oveS=FwtZy*yayk6p-aAa#b~KM|9<|fl&Yol
zkFSbK&byitQI)WBd<}zu8b7|KBr+H}=s8LNqac9J2HjqK1obl_=;lnHXq52``h%3>
zY)5<gYBpm>#MNpaLd)QFr+%4y@Btk?k0Yak<0sL5FEzstV**^3KcI5*udWqgbV0+<
zxQ*{HgTCiWdLFx=n0-Cv*BTq^%+=XWPiS@v>Nc@j9<@ZK95)KrYBqe@9c@ZAw$n(J
z?k~6T1ap?n71do-L_7$?6lTJnCKCp|#>c@3A%<DjhN_#9&r5p7suT@UJ2-3nUO2aj
z&-4aVr3FhrS}2n$ob(>6*c;ir_W%(C#~rJ9>TG)RrsVhvK}9C1e+GZ=y}Mw@{BL`5
zlzPwlWoQJUdlSYJS};#O*KmEAQdS)U`f^}^{2clIQhT46LvjvOJ>Xh2r%!&qWK#1?
zx7k@W3iN&5#(5^Wt(UtQ4aU})3_)h`#RwQ4@YP?^XddcHhWK2ASQIXl?%~{R0Ka2z
zXg@m{q{-MZhCX2mcT4D#2|pf7gsedz=7&4wX!s7|ao`_=zxuocp0B*ZyWYwu2z}^J
zB{W|=p6bccEZex{s8r`zI;RLsR&KY3rsmXfxEr6c{rmmmI{0Kr1v2Zc0C#}!foSp5
z4}(KY-73^a8Lhfe5L2UU0<9vx`FY7$QBmtc=_6_(x-e11hju|u?&-#Nw8EJwSUcO`
z)_)u)aG@`yTkZ#kz?_poZx<my#(}~54<3D^2|O+5jpN!;DMd9d>n~2tZ0c`l^sZ=(
zM>*~8vXoAeCe@x#Q7lLeKK5AT$M&ZWMF>P=9c1lLm!3J)<OpC<c)P9>>6OZshx(6W
zgnEg%x9d*}#4h$_-rwEcv)~U@O#38caK%GBzQo_M>A{8y-7>E!T)A=YPZd_5E@#0`
zj=y|cl=d4CuQIjOj#1xOMcGXQJG*%$;%6zlhXYdPx&I*IVX#F|L>gke=T6AWjG~KR
z5%~{BQSLigo4`oZlL4Hu4|15jJu4@1Drzgb&6Hc~<Db2hs@lMCqUU4(4O4xe@jD1#
zTP-s!Q^P)+B#~8#R=kk#{!4Xel66`M75y%li>=6`i~#Bb9cn$!oTbt$tfwD2CyUES
zU9oF;owh_3LO{)4zYDgo)eK<VCN_FhisUs}Kba3wP$-0c2=o-||5_aSMel%eOBm)3
zCRdt2+K~p|7S<40Gjm7Uyz(M(x-ZAN*4ubwcF3GGxfoF4Y?V25#>a7?=S{A1Q4tEF
zX`aVu_H%Q{JdQ_u7+&xpgjm&3cB;}|ONg~kSKC`<b{CW`XQ~uFn)!1*`)B-*tAqm7
z#CybhS|9Q#;YCr7Ze^`kta42dVQ_DU+1ZRE>82a4o&?C6sF=gB&vI~tujNafY|+N*
znH*Q2<pE93m<KOv%P+{NtvwK#3f4;MF38tktCJCiTU8GDSAZp}W?CtJnqCD&W_J07
z%dS4~==V=+o^iVJRpM|bcMmdME3;JTn*-i%trTIkjYqa6C7Kv^Ea+SY07FUblQ>2Y
zXbJ^3eHKo7@LAzOVqRU2E=^Xgq@)sU?bPn~j!~5h^#?3db`kkZo@#se=vWnBGdAY^
zselJd+~k(YU#lI73J^%5D@Bxo9K7%=td{oDpl<NxCm=KyZ@)DuxvXOpeR~lbACBgT
zxLw0`BNbbZ1M@5{C6*`>{otbfnX}J3I;tw)0qKB1O`ZdGf{owLbB4Ez8a~P)4JOR0
z;&k=)9Xx1cn3XPQ`dMDO@X1ec!4sKShb$Fq0QD1}1Ko;&Z`;LqqP-b<gt=?&Np{_F
z_KSIou5T5%vYu&2-2M!y1@3+0D*O5lDCp%j;?Xnfa3=9vs7%HbbBFn;>4u!k|32td
zOK<;s&|7|dV?9Ibl1^WFNTDcf?2Lw03p%@Exrn_buitZaRz0r6c&CNHY5S#Zm0^Qh
z89u>27xJ%HARkM6>$lk}xqO<N{q}QE6@mZyVOd}O;jQNmul9d-jGxWf4~&S4jouIb
zdFMS5a14?9a-10km|(?z{;!^e4cs^JeC2LTc{=`6iM_l6=y>)wfbSOR2z%}YvakF3
zgC=i(ha{H|Kz+R!tin^)W9PX(c9r7Rvv01_U#%SQ^D{2L{p*!ejs4NJL{nr>$zOYd
zXfRwhqUM;|H_au3CBgoBoxhw9ItLoRvCe#4U)0?iG>3`g(ZTcVLmj~X%slzo1^TC}
zebe<4TS32G%<ksW&$Z3}=GRV^T$g(J_mj^9#?2nbq0~ErBjfb7nZI>z-g!%p{-h0B
zSs(!^+fC@_CMJ<!XT6n*W`B^!zRysX;~%ab-4XP^_v>NsQ<F4e_7{HbS>A$1-Z<?y
zf4wO%VBDX5yeuQIy+HzTP|ri|FWk`2akcNnSQNA0-wth)U@xIr$ph~lRqPXVpiuo=
z(S~pRt=g>Al7oZixXy+1#{Y>%e6CIXPc-8Hk!XYjh@!AJ<vHaaYZ^f3kp91pf;m0T
zc`{|$wD%#4<C~?~YxiuuH<Slhl81k9Nxo%WepH#;dGA;7<15op@)v=q07<hbDbVEl
zZ#FC#_va9xcJ4pghuxiWvZ*-#@2~#1xZ;5+E>G4G6xQSaQ$vvhx^6ZgBcr0CVAUhx
z2g8rYczwB}oq%ga6Y0yv%}u<d4h1JE*>SY%4ie(x)k?fkghB64{mC3*r_a%_&^vM=
z2S<CKG=EFu{qN{8=<jL`ppWN&f~stlryBU5pz1dQt^bFDs{c`AU(+N1H`N#`^D%QD
zc6J@^WpCewR5a(>76!2FLg{IXA%tC_A#%yrv@4Nr?fxw&rz#QD*r>_CkgEE%{iH{^
z&>15mjYU$&EsMse@hA7bENYmgTTB1NJH6V9CNSBzIvEwa%({1;?h?JvI&cae4_!et
zYT~SQF?S(5pumCup9K6tC+jl;FaIgvAARxPG4Td0h~C}R1aG!kM|Ix0`+kqp$?!K3
zKlcyYj*1k;$2gr%t-D_vT6?GVF8B?#T+UI%+;HmSN|P%YJ=WtB?EB!<_6O$<dH*0-
z$@jhG!!eK3+H=9u542El--;w`FY_zq!q9md|MC}r{wz5h(||kqph4~4Q8(<r@iMTY
zYT(t9InE}7b2LR#GE&atd5|@i_n18|4q=tipvv~`L+u=GT`nS*2uapv`EKYa0GFY$
zfZ`RIS6*7RZj=80cF8r#o!f(vS&e3v6<=cKJ$0&_wV;jY`#NGJ3f}pIN8bPo{BbVs
zR;mxBdj+oFc5&HLm$UJtK=nq;Zz5AN2y8}hU2!H;<Gb`ei?E&ks-6mpdB);mn9}^W
zuaP;9N5vC#sUOSP(3{+swjJu50ufG|B@yc4KH;0{cd2yR1Gc0-hpMM-JpHecjA|7*
z|9sHg*xPX4o;+;$^VaGQ|2*S73^|dwG&~iR-)}&pw|ewc6qgsQ-YBpQQZ6e^(hzp_
zt$|28m3daxf-g<BejpZao?z2M5aJ>mBhUj<2Jqz$O{Uv)qUY-9;^PxrpIQ$_(`b8z
zJI%m&u$$O<xWUHM`&QM2U$M$PTb)sQ`VCu`mmf<StL}+vK0gHybTDhv4<AzR&5UTz
z=N4t(QOxsdv+@v$l(zh3kIU~Tj*aj7QA$$U)j_^yN(Iz<AiMfIrBH<DHx<yomYk?*
z%jv#+PTDEH6b#b39oC0#@i-x{gsN(}Tw;dzJd!<rVL`DyuW|elaRymdrGu24_rKMT
zZFVVnAusT-f84n4@&{YVB5y~Z{xw)a+r$!O%)4#IYgbfc)5o1Vf_Lr!eB@0G8fQd9
zO<($-^MG5)V`_1rkK!D8#)bHHwd}M2%%IRdIdEmEF-IlAv+AkHRNtq$raN@s8moq|
zT>Hv?kp$rsOJV;5;Tn893@I1<Y9tc@1Ji@X_-Z)ahCnM~fV1m10oN>3)YAReL21lV
z{ZFc?kMmc9`hNWm$csrqrTi+nLa4Su1%3JnL~J;o;4(<qpb-7A|Gn%)&=_5`9Xgom
zMxME8<n3%8_X#P<8>M_rV<!Wn?B{qc@6tshSpw-}Pd}k(HpWEi_|?b@Nyg#{3bRcv
zrv<7*Xvnit(hgoq`fV2;U2+;L?kDsUazfiPDW+OWvDA%Bdu7lVlIsz5dyxFW4lvJ_
zb<ZY_+1ahl4U3se;^QY1G|<mTDA&w}(%yo|<3`C((~Q)tFP|9hY)RviS3JnGHk}mO
zE~TTJgQrgK-x3`T+6ypZOsX4$n(34huEm{J_kp0t*F_NOesa4m`gW4dO(9+%zjE?C
zI=-5|5}@ffwr&n)D-z7#Ez0{G%>iL`L|!by&p<WRjlasn#7?nUaR$)JW!7+~=bK5o
zwYjg%b%h>-z8AMXag(u*zgGsvmTX~$$HGXE7CFUaS+7L~b3DTh`XqH~>SlcN;1L}#
z?tX|Jg*GVhC0+bAOn?a^6F^*;*U)5u6@M2}4az85E?$RL0y_7djkb+tPw(4b!=BBv
z6d-keylUu_A~Mxn!!15!b|X2biK>3Z$->MnBNS|-Y&>k}(19o{9FF!sEt=k3*!|GD
zEbdd&<VdJt2wE%0nVcIGs}OEQaXfkjlN|k`62&ZJrg|!+$a`))5OMZoRPfr(Tlp+g
zdM&;&$k`e9+qr)B3Z<86ix=|OA7_B=X=FsxAuSEmzLU}r)gj;9rGxy~Qog5!97`{B
z^oq=FrTE?ZzJf0Rc1vCY?4?Zk@_BP<>pB#!##f6_4fY$de1DWg*;V*$MqV#D)@e3z
zq?pq8>0$D24RFg~mruL0^Lx*J=^_Y1D~2o|%j~mH&H(~A{gNzOZS0s$o`f0({7kSv
zvow`3Qeh~yNr$bfOSwk1D#8xDFfTMog`*9rG#^;OPsel+A**25^DpTk1!CHg@Pi*8
ziHHuBhIjYBoOv|p-dQ2RH@^5Pp|#*sQ>>ryiGB1!wzmFog6uL35hp;8Q#kbqhI;bd
zJ*E9P^^TJQJJFoEE@JzlN^edfPJ2SFW^8!$MD^R-B+|5Dfs&r5cuh|Xqx=^$0S~Kd
z_lEwO{KL}zn+$Jnv%^@^Ckc?~K>=c`i?4MbTWq6qfY?%hwQ)PVI@KF6SnY+-T6-B0
zMt0#wT|Pm!R$ng|zc3yMt=O)&T49rD=Qan4Zm6T<U}e4DZr<7>&#Wa-=HMgItN+EW
zg{Z%E+0@k^vx`DO{J3pMkXjR>)w6C}KnAr&!D)&4>ACpvQAY4=GCaL<`Q=P;Z$Y(!
zau!$=RPWO!_h@2pIlHQ8_|*-Nm6zj($ni7VsBIT{!2%3O=T`Umy~JbP+%UyR^R<!-
zu{Df(i9J?Gksskh$t0!T&XUZ<UT=33R0twK8;ECV)k3jEmBK(jcR%LO=e9p5qG;W&
zJzD%;RRb^Ul628GJOd4wnAGaCaxbWe>fBFw&qn(0hK$=o(yAdFo}*>7N@d@>8VlvG
z9$kVVp6!b|&J*3p!?hx(ymY?t$O02%MZVcTh*BstK@~yko&oJ&WeK%Yq;>^w8+Ui3
zvl$4!Za>xq!2)fw1FCW=Wb^)6DT8}qAy%9A7k264u0=Ki%hqLoW^Az<e1V8_XFY{L
z2}o6uJ(N^to{mt?H<kS*+thU2SIK8Bf-0hep5!C+^5zE)q*GP#G*r^QohwVZ>cIu3
z=*fh3KJcuogTD*+M2Y4@U6*DlwwUgPQ=APM>LI?_6MnK1C<a9xOPW8$mI!`G16S?t
zhMr|V&;X#xJ%;jb4Xz9?H7z`ky;fOUa!V<$3q@SySsPrLk5Q}kH~21Hi+Q|S;pHH7
zEd`DnJC%0Hb$a5JG&d&;A$TKTRTkn?K<Nc4C}BX#=zLGhH=_Tj+_Xlyw)}&28xs~r
z$n6H+RNQUyeG(-R*9$0q+9n=B%^?bF%N7&CLX|-0@I;A<b~<Ng%8qjuk^TH2DvnXO
zyx@#yW@qyN_Q)l%Z^Xk=|5C!_X>0iEz3jeafS_Du68DM$TcOf-JnfQL+CZ;bkm@n^
zYkiAsNS~W&aTqszsW;O4S_UH^_9f2YktGM>uYeerKU!$nS-^blU-_)qSwyaUVlmA5
z-MD82e5Y1l$iI?HZAl-{zw*;xLp1W7K@mwd`~U9M=9fAPsz)fWI(bp&;S2OSflqH+
zBojBQe~kzdV&6mayEk1RBZQK{7901!Kl(W)d*<qwl8<5SF9138X!gW&8h~4w71$kq
z3Y=r3Wmdx4__ld#A;IM;_NNU;Cxde<iFY+~=!Xn*;<8LUpERhkk#^{4>m$)Ct`==y
wf(;zezkTilz~PbgC5&Ak_cdy&)w;<sZ?!+`T9Se<>(g~K4K5V@di~D-0yFwePyhe`

literal 0
HcmV?d00001

diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/pict_4.png b/clones/download.racket-lang.org/releases/8.6/doc/guide/pict_4.png
new file mode 100644
index 0000000000000000000000000000000000000000..7714a00a2846ab1b6ec2f98c1434e36ce6ee297d
GIT binary patch
literal 28080
zcmeFacUaR|_CM~dqc}Rs*g#QWMzMj&C{1Y@8%UQLX^9PxE+v#el2Jzy7+?ee0Rfdx
z2odQJ5*0BDLZpPyBOrt%KnNrR5)ytl>db!j``yp}c6au#@3TDkJb>h#d(S=PbzbM(
zL(F+Ala1>Y)~{N%YNP47Gq$T%eN9-k>Z^zA)`FjOnb%=gt@?hI>6w%E;SZ;VoP1TF
zXwDM+h{b-|M=QBFhpW@J4yJC-X0|o<th2UZqT$zraYTPgCi#{q^wPTuxG(Q4X|Y-3
z)(!gF)jJ-%xUE6>_9ES@Pra(!uh_-K8=K?}Rd+49a5(90*1M|{2Itd9x4doHw`c6(
zU5?Dtj+XCN7|JWlIlq1=zWe6f<MZEvC4rCcw%L%je*SXR;H#VRpTGRe?KK*ozxsOp
z2H5AX)@_pmn~{EecaR&jYdC7Y?d7|77JGxg`ux)pegKANf(f}K+Tc2}=F`u9{wZeL
z`rAPRE&e~6>Sd*>7>apaulB+|^x4Yd=d>D07KxrM;g>j9YJNdvryKcKSx~yz%f8Gj
zq_6qMKWMuw+*+bOsD(Y=)Nav6=gsf3V^5?hur>!G%cs=itKVEb2A*}T_uqb&d=2Y`
zdi>|buiM7P&zj}i{^=)P5^EA93jr%VoNecChZ~gTNO*<YR}44-wS>7AHP-aBdP5d^
zU78917HzWTIu}cythioWO_@x*9w-XFEBQvAM9GYuY`D%X;S93&`g?u-X?;IEdivpa
zkzRVS;q#hry!>a6>u~tzGy4Agh1tJ+dEhIt)gzlH9YwESzYh8E{HuM*rtTF^ZSUSq
zPPAn@ySQLa_y+{w*UHFHhlX&esdD4<5$YNmY>8M@AIwOYTOw#g+_pR{XBQS$Q{T{#
za!y6XRM&s7x8_b;TN{hbwgWHj9~htx4whaxTu@b|Z5Xw9z9xX))6!zrcA{gK<Y=+-
zo_lw#a*W)#6gnZo4vWP`!U~n&*>eo&ejy?D)6>&QdBw$t+S=P4v+S&`6F2QX{**(x
zTH)l@h^(3l6}Ii>qjl<ravP{!YCI?L;PKFW+e7gQ2_+2;E|!*-{ey$uqoYsu@87Sb
zt?dw&P=3K8dXr-3`}e<r%{d(0R#{(PlAgZP(#k5eEm1O?%_PS;w=)#($+O0c>C+Rh
zm+Us9JafbenvXBcdV6_wv}%w_?NzJB_>Uj|kYx~I%OQ%&3JMFcv3+2RG+3l14u^}Z
z=JWYpVDW|4IX(IuLaxRBuBU{T1tb#O8X~UL)7Re~b0*X`^TC5&!L9MZx?lxGMZ}<v
zfkCOJXZvKbwNVG3O~bat49_OUh`)<BMohd*kHw&)qM|4_<;543bSIYl8yg#uGj$BJ
z#s(r0*7c1`SeRgMq(1^tH5H>G_DFSxWD+JjhFHw)!gq>%rH1VA(QgbTi(`>64u?bQ
z$TdN%NKlRQ?fNa_LE7Uq8m*9#gMs<^`9)SM8bw_&G&Dr6hy?=QT!=zb_t;rOMlft*
zO<4CpSVJ8`a)#c=v>~TI*9bqmXLBR3(;OI#vy+pJURKZ4RB3;If5^g=)5cAkSk3bA
zZqjlq=~_fY-DoX0+!Y9?zqj{&mVTI)p&>3MW&6G@-$;M)Rm@iJfB;$;N#rJ;OCxo^
zer<euZhdA?Pfurb%j?&7<mBb40|PD{oQe4eOKWSX`Z-^?@Sepgxm^AL$P+R5(G(F9
zGRZ8==>b0kr>)xlS$w}y7zk!(J_=K?h_~IaVMC;3Ht(}`sVl^@mY3#R81u1b_QV>q
zF{960T4ISpmKxcw&$ow*5Vjdq{Z+NnBUvXx<KyE~<Qn!LIDlB1b5~baKa_6a4bJ(1
zb$0iM50A1VCU!Ooh9eyqJwTuww4foj`EtwEWA$ip{RD#n4!wJLxC|%``L>oYmusO9
z>kc+DS?SG9B@VQ;%^wi98>Q^_{0r%WwvJB0%#6REzdvibhTa48SH;WE&ypmb4&e9u
z;18vkF{k<}92DOL*FEfHR{9SU>KLIvM+#<`KrqOq@w60+{fOnoKoqxGe&bs;--(F{
z-b@3>+uz@+wY8NsIr(0B`GvAQuR%F#_Qn`nR>?qmBs>-tUy_@9`heBLBJUfwK55_i
zgWDF|W@E`?$f<I&%3JOuYsiD*;RxbDx~6A$Utci=vf^53m8I%-3Z9sfl45eCdd8TP
zUf4s~UlSQpgGAmo3br;Rmt7$zm?n96c<|cwIYs9Wp6f>{1A(Ma82rVtME2}RlUZTc
z_LZ+x{f1z3%kva9xj3(&AgOK5Bp5wRPw&9F)a=HjNv;`mCCKw1QaT_DMfsf2;Q8ek
zVug7=P(?_k<juXkNqG%noKyw;!5j*EZoD-q@7}%5&0{I}6&xPV7V_EdIjBI+up#hn
z=lY!^eC=VKJ>&O*(&y9T$YXlpvyT!K^$SKuE;U~+HzajYsrlvQM->f`_CrHMiMw+P
z3r((ExuS<&uHB?;RQlq@Np0X!QVMs;$;oLM8O;dIB6KpTi;J}?#T6A5CG?Gv0p}$A
z=os<r!Dv}!N8lrka>5LjzWBB>;GPl<7ajmHm~#r@le!I4g1(O)iF(C_(8-F|;oap}
za1@<ARJZ2lvgz0jSMQyB#dW+V-hCqI3|O($ibNa|oLVtDDXSm8WJHx}(l5~i3~OGN
z8w$z{-2WaL4i=bl<n&>|`?gUwaC~C1xXj>TMbYAS?L%pf$Sm6J4f5S!m-H2h0B9<b
zRa_WqQ3{;2cqWY0bxTI}zQun2%MBXWE?&H7@+%N63uyO1*KzP1J&YuZ`S|C7?d#W|
zfWFm-b1yg7Wt4_<s^w*Oe0w?I+>04myl`Z)BR8pfm<HUT;=rU#LrNxN0Jw}S2nLqK
z8;MrdlXUbQ<Yi{DmV8U{OtQMA9{kEQP1(oC$4q65JAGvu4;_FvLnQumq8oMk882FK
zS+c7YPnc8=z7E`w1M=ZFyqmNInf5jcMPKp`c#71tG-^*zfxYTDD>^Vx8zE2)$emNz
zxwGTVo4Ye~5}wKQ0zN1H*I$cpI7^L2UJ?u=MxX=@bca3n-dFk1DyyrdrU!mu^8Mq}
z&d$!AQpXre1J6u@qn&^h!Qtjd3&2CFs;ZdJZ>&y`C0E%52Uh^4IPAq<{nGCwd*h*A
z@rVN?&-M_X$2%89%({nu>QWa$92!f6l$Dhok%q3afNepY-Q9V)CW$4DjVQA2e2U0e
zOW0-v!kI&7u9ehvmj)_PmA7u)%9@($etbGQWNB{P5VLN(@|_i6G9_|^QEqL0eZ7jQ
zfJ29>Z0P_&4T(f<i#M(!5K4hJIDwYyP?r4254TYll8;aqhC*T45QjLT55YS@^9F3T
zUotVJ8|Vmy0*OtqGEW>kW?OF`CGazgZ}GW$^^7uRxxCD+!4WwPf?jtbX88&L2aQ4&
zw#B1DIIe-I8*54GDzs(;S0puxBX0HfdS8K1=5Sc9i^r=RMvMH&DIr@Ayvltw7PxWa
zM$>-bhiTw@?(H?{2Emfc<(3e))NDC9weiq#amO3<K}qYY{{D=y8;R(rH1s^-AaHX$
zW|uPzw(t?&Zd-gm8@14<hzBY+R2NL<Mi}ri`vxUa&1sbyjb=c1r!pM9lrI#CsKEa!
zFMp7!4;qh^Y6N(@jt(1XWCN-toNbcDwz!LwF-uV}eB**MQ#Sd@smG6eXl2YUYsip|
ziLgnzKuM$I>`HHbKXE`3`L|+Ig|VOjIMmfSEihu~-;MPcmVmg1oJjXn@yj}66t(z1
zjo{(w8D_E0%LlR4gL9GkPN^xqkWrqhi)Zy$`RD~t{F;%G0gTVVSv$brKedwo6DcSy
z-tpO<fQ+lhiaAjXeSKIfV_rC!n;0_odLxv)-WwPdGtroTT1!D)%wCeZL?2^FFVkk;
zRXAb0d`+t)(Mb4)o7uv;*E${o+#HBc(x~zFs_p61r&%mk=j3D&h?V?_%z&9mHDQ~t
z|0hio{UN+MSF3<Verkd;r0hUWlr3GdP!r}$La<Yf0A4rLM&6&6jW@zb2uW}Aq+xQ1
zgn@Tlv){XSuY!_N&)eh!+vA#f9VW^t=xpGrlN05sPcTz9=5*8H90>L1A6lns6#2nM
zz>|ZX7+O?VJhSKV2KggJK$svngD5~8*FJHAxhU-Hv^^wgj1(;RQamaERI@WTj|0|d
zhL;bB*s*I@S9kY)0K0rzTDAIot9f`3KifcDJ0BU@AdSL&fq;EW)~Hv|gta|6^GUyo
z&^wfrjwoIQ!IHVC$-9M8O=l#90NemfbaG*OAfXCJe)Z}X|DpP-LTiX<N>hsN80}e7
zWUGW(<|?inGb5$9;V1=Wks%O1Z#`-v-dQvT6jTqvx(@(!YHDgFusd*i2??73P$(`g
zHsz33&{X>S3*DWaPh^c2FOvO4HU2}Lb-@hjJ1gpkS^%(oaA@rrj8-Z@p57gh(4s1i
zN&qFt`z&1>rcF-&Nh5sw0UIp^2bC>{27YP2No_c_JCTeSdASC_TyVln01!fd?JFX*
zpqkEbANvFR>`or;?LBX9-kR`D1iME)OAlcNB8G5SKr96M2H=yAhljD9ot<%+#PKo;
z<pvfhNub?{jz&n9BcwL66osZNc&};H&HKPJ*(*FLoVdgX7~!B|QE0C6lr7UB0ARJg
z3ePGcu`CfH>E#<NME0~(u~2D_Ahoj-L08FA7^<Udl&L!1Ve*HD(S<!VA*}90e!jkw
zSz*I{+-O@9lW17@$Qnh1@bem^<!8g;WAU-UeG-$Y<z>Q{rm6;vPz0hdaJPzjAw`uR
z&i;+02u7Ha?I>C}b+@NN#o$cxv^ATK?i=uL#vU$Nl1m=~4ibi5a_28Bc)Powl`1#z
zcBnRNr^AGJ8z(-cdOu@V0O2v4hELny2FydMJK~QAARTcU#G<Rmob1X9(jPuN>~<NV
zr&sT(O;ETr`N_9?K+d_WY&m-T_`$bJm-uISw+u_t8P<mU`v8s-m*>pS=GyE_eyg|w
z?FJqmJO_yx3SzV?n!2EBQ3k-rQ=@box^fe3t?}<Y<1648m1NVb<AJ9-dmOem;MZSp
zb?pY|Q6G3Z>B_HO%^MA@p<CI_g!Z`}DYV$X*NYutaF!SCv}^>kkCS|JCkVw5EZLpl
zxs5plgNV2t25c#RWoUR9wy^VSDX2#i6+q;YKjL~G4$lE1;P<!$OgAX>7ZC_gLBI>q
z!+}o_n51?CLYl(v-Q6#4$w=KMd__njqP0t1Vh>>MojX%(Us3@1_GR}j+oz(Yc=SQN
zppSP!{uWgC@HLs-D%mZ*812o7;Ev<~%jp7Y-Xa;?YHjfNKz8`4UAuM($(Usm+T75v
z$pEP*16^UaFUOL)Fq!)~@Tag7XJ%$PNxU>s_0#<Ped<S!lvGsMfm}qSgs&cu;BrK6
zZ*2x&Gk&Y{)rUREfac%qfmEr|!q7R8l+$0#1wI0TpR0E*k!VEDVX|1NhR4fN@mlKH
zXBGqkAK(sw5;*n^BrBvt_r9Z0*uWVJ+XB$JHFUH~XOAQ#G*tL7UB4PWR~M;G*m4Q@
zj&QL}0K^x%9Qs;6Y-TFbNmG20=sd9m(hNsO#})~k`^)7kS5B*`skv)h!aHz(!5%l>
zEcPfgLFrICe?MY}GD!8x<~q8=SIvG@gR3XfT2uUO1~~(bu>;jBf#)y}nybfd7e`R{
ztP|T||F6@$ed=U#a<Wv^#wI3+@s<=rh^CItelIq>JT}b{swx-9%uj=LK7al*$U8nA
z?FB!cng+xIm^xTm%$ZXlJ~@6|J}4urbXXjK%r!bWnTQl#YPfOZM(2$v(!kDr!WSV`
z?ep~I30;x@O5zF^qI&P#<Y;r8G<9)dn)M5B2^P6yN!60ufg-787mAHCy}wv?#cNfX
z^1#Y>Q*3tEt5>hG=^$@8BEDxgy@v_VFaRi8T3UG*4p%cqy1_bFGc&1`^P$^>O}llJ
zG%VV%Fr5W!+yYx4LdjV;O<&6G9J6?YpH0eBgO-6*p$LmL2Wj+hIgUgkX+1syClVN8
z)(?+A&Jj;}3i~MN>M{7sJRIg|B*=BNj~_3JkKfn`WZ>YIeZd-rJ`wcsO#<VvukMdO
zp0D@pi%<5#OJN(AtQ;0KYzi>bNK-Vw+s@jwzh3b<vnMe~y!rL;Z&Nd}8lp=zqfIP%
zIk}eMV4|Y<VgZs7(b&Rw0dWYh71O<~AmSh;OAIQVuHnUg@wA~Mz@wN^@ity*h!c#<
zhCQYX+E`=WwY8<lHD)7OhpK97IE&(fg8hbq!QfcqT-9ys6E<8H@yQE}7Y5u{TlK4f
z(=eQWrwRTKB<1-5X@{SH<eM{gHlJY$BI!HF06H~}IPi9Yh~*vMI;lp;!$DLbE6c%#
zOCOW<A{R>U+_|Hrt6SL9<G4{)R&7hnwV<F*u36kU72AcL{OoL{PY?`wd?*pk%YAmD
zw6t_GN5af;ZEe*6A^a1dm*s<$94rG78p;B0AgQ|SLb1Rx#{0~k%|P0a;K79^Wyy6i
zW~B+Te46P~HO38RN@kjy&q|?2aIhWVTL8{bHMGAT5#a=K%aeWOS;D=)HvW*_p}c>g
zDHQyFKE@Bv6X$+P!ST>KbX@ag>Dt?~4I6UPlHcY50BcsGJ48ge=mrcA&Wm`NP9Qr7
z$~6&)T(MG=7uMaS3=BdU#k+UJwe}I%t$2|P=>bsTOZ1g0H3tK<Awg6L$M}LsBNotU
zQiq;=z}oxz_48d_T|mZq*FXIHnF8WTaaqLAn&OTfXl0EBc8)WJG5DrcqndAxV@)?8
zJHqt)2E$U6q?!3XKU|(acx23hY~V`a%;EmFHp?NvTjih@(lul+X=>wxW`-K1hmdbu
zY$)JLe_85dM&mT1TFUeQ{FL%$Qa-Jt<8eYlg5rR#j!p;&({A-4UgT(}+}@sDNkife
z09QUCX^=G1=Qa98kCo3C`|4mp`T|0N-ojjGXOh$wIHtfD6TVl*PF4u11ImJ#p{~pT
zVsS8|y||_Z+SJsfU#$V?I_d70WGmmkH5E_jk~#p&#Yssl)teUkbFGb*&VU3WY}rlN
z6nWAJI93|k7YL!QBdp*FM**KSW^py=NhaU_KDP!Vs@cBctFpxg5ODwnKI<z5)I!vW
zla>4MK^d8uR6uV`On8744_8`xF!`-L&!GsgJ`gd}T1^R?A*gW#bRJ;Qr0J55u5Q({
zXHRb5UbENeH(&O~VxlB`JO$bfXr54g@lOyf+r7dzHGnS_6&20)CwqH)+a5{l8Xdjt
zAbUNZu8`Ylw1MTh6;(|#=9?T#w^vQEwX;hG4>hO1pG>t^bwHxW!7n$LGZTgOoscj4
zvS8&nYnN~=&eH30`{!qa$m!=@M;z=AZc{~iSmmZ?Ku@sQY<H4B)!5wJ+!$7HsE@WQ
zNi04Iscl_AKXow5f$mQ(W`C6nwDP8~?@Ufz?y%&7i_3rjJH&QiGd7Dy8oyTtPR$1*
zRi42~eY=h@$w8X+4a_ye&t&b({~t#E?@_e>nDgB?6ZRK=tZ_}x6aXJ;Tp)rN#w9{H
zp*}TOB(BOD;G{vl+cdYtOf_UJ&ESmVq0HlnEE#;dWNC~la*tG|>6O97ay>@#dc<OK
ztGB4MLww15sKmV$J=NYdP5A*YJm5QDy}OI`K@eegub8aeMG5d_uk67K%leH#D!8VQ
zw)ghUF?N!D=<3gVyts;-qWiB?*0KBzFlLA|GbAJY)rK`LtPzLo0zn#+Yq3*f3N@Ab
zv|Y1{j7w!kAhUARQB!G;lw=4Vt>_;~3R`Jv-7nIMmom}lE8auPqmG87M?Q{XE%u)_
z7`=T*oj<E;-6d+}g%|uPzhD$<eu0tB9CK{t88o(2QjHeO&nK>iRk%YQz~f`s+gTsp
zbuU{&NJp#u(ScZ{9{86M#wuS=@pf3TeJohp#y_>TJ-1Ii9;|-0>$9v@tv>S*_A%A?
z^LKy0%JTPg;sWVIid7-_j4>gcf10lZ8}~wD(v>Lpxi5#w{@<_-G*N@z>Dh&}rM^xw
z`Wsf@bD!!dnR)Edz{XRG57RS9OonbjPn(86b??lnBSgSb{s&4P+rN~Eo`(XtrI_X4
zH6gtJb8E9bxUI!ct>H^)>Bpa5G0*;2vHlmO|F2^G3rhb<u?8xBNNZ&Rn5&?yOas&t
zC}*i0QixXttUlnsJSo`@2L56_h4Z7K^k{XZ^WV4#ds7WMcJNNu&Z2eY_;<DnU+(JO
zp2SCe7Z_FExdsoaJN8gKjA{hY@KRgadcbPZg)Vfobo$Hwzy?l}oNUoA>L_3H>}%f&
ze{c;a?TSM-eS;d=$Xb8sJJk7sn^2=1nlyO#^*Nb#MsngOIV+ON{rmOqx4l*|wY1FC
z3%_oIS&U8#ku3kBQVjTGJYg>OiH*|MwW6sR(Y@tJJ-5Y3#J2t0>>QISi}$M=Z(`Yg
zl-1sBs8Jk6=fvn9dji-xDXU!G+hg#hE(S=uyqFj<;~sPAtCXktiGFXl#-D`zvVjwJ
z#U|kRV-3Pdw;$G&$a=fX3aNN>K3E#A^c7zo!!4N^o*oRl-xRGWY}Ob)e=J>E>4Qa#
zr#Nq28)Y{os&(YCCg4RC*Td*Jl*y;VcUMlG*rzBWZqrbrVe!P0_I5GDW`A;rH2rpM
zk5Ed_R{r1QYx_v}Jn)6u!hFsOVNhdv8K4&_&F<(pD(r%YV>~>Zl}`YK&`pxCkBTQv
zXen(+d;l1|b?a8u{*79$<(x6+4(lLHiDR3=Tv$@e<OK;FVJO_Ij`s-Tp$@@7ZFc$N
z0dGGP&j36{FLdfb8Jtu$KJLy4zcV3Y|1#C6dY`q{TJd*B2=w@~jU&GhXV)TbZ>u$0
z#9L{kHo^`A6=G4bNqLZ!d1w{kVNrPA`1mi9WlD|XM44;d6W1e9hk~Es)dDd#6I1p}
zs+wfzmsEbsM2@+zV1IUp_3ym^oUm7se20BoQYg7+_SiU&g#PMz5&hFXPzHCIJ9Fi|
z?8r;e(1q?@R+Ae7&O^_QFmFABh66&>6M|WseLNf)a0X986IjpFEo`q`306>o*#mWY
z|NeYdv7UKh7a$uuZ>*L94!K_X8YFm$@f?R4KEf}-K#G5z*mK3X`zcU=z^T=Y#{W9G
z$Yn8Xj->;h_Mx17%|u6YoP1SvwTCadIbwz?^7s;J(0nZ1se@d=IC0{{&X$M?T5W-{
zvhN9sxBW75Y!0m(O00L|bS~MxVf(R`OSH<E^Y2r~X8j9j)YK&pB*ElpqpbG>IMr>$
zAu7C=z9MFpB&!P>NcwwCfkEO=yw1IPY^VFNouiv6+nb3Hw?$FLm4|Ovvhr|5jb?o}
zkpZAlGb1W%Yp;c%&%zo5zMusV)O8Fg04|VTYl{~@Y{%0fcA^J@hVsF(Fy_4eN4^dM
z?Vv#8MO<@1#aZC7PzwlYgaZqhfD#7p0EW!8^VKVf?9KtoVmKq=!q3du#(t*<MJJ34
zUx&R);=PIHPw&FdXGYjBCw*f#zgqPkg|RQ44us(JHhA*~rLIKT>+-;S>ZCj0!mrK%
zo9-EV%0!&K@?coTzYYIv1FU(g*tdECFVp66MgMZd4=HAw6T{06EqL?T_=~u+rN0er
zHn(+ySGX(-dlb3fQYctK8&7h~F#FKh_Lc9BHYQq9G)w2-;RF3n7}d711(a^139<iS
zmLGK4xLLbV!xtNHkBQ*Nf)Kwv#BN(wZTK)=EhTasn-9RAj=k8`KtF&V*8Pl$;yo2y
z7D(agVV_`;PKF=DDLz)YTR`s-G&xq&2CA3b%~$$DcURx`n}5LzuP(WS-mW4Z5Rg{H
z8wTKq8<yo_&Pd%;75<rywqMV3!_UgGs2r$W+fkjp^kx4;FvS(;^17uqgJXt}M_a0S
z<?0bnj!s5jACazj;{o1n-6FNTS>DM$H3HywD?v(dOGZ9~?FhAeA*<;8n~F4D7tvSH
zemnoNk!QWavj&ysj#D2W)vvGdjxB$5I;mPnJb%!)+2z7{DAaHM+NBY2G_ju7(C>on
zU-BXxr~a<_+?cv`w=2#aKMP7j_f*6q%CM5qM@cKZoFg-L*E}fe#is4STnPR(PH3Hf
zAwN9LJI6#`1Fe~8LHXZ(xB=>X=nH8vM4DV;(5Iqhp(}{ra&zaA3w?*q?zz`VGyhA0
z+Jg8Dk8n)SmCvF0*xQwRnxo*cx<_rgXeI3wiVw(g0t`+ArMhIUJdkui;TC$G{4nSB
zli};9;NiFGPp!9BzW=Els~0%>iwaYo6n@&zZ`XDizX1As4K%kvh1p$f7far?;2ZVm
z$bd)^zo=39xH=XSwzsoPcZ~EK&yvo$D|o%Dzqcq#NlL=D>4vrM?fQpr_zEqV&q*6t
zm<NSx&?cdp=F*Xf4sm1ho*qm8Nc_sggu#bm`1Ki?!Jw;!T0;{1(UK5JR)wJWn7>+P
z(|16%4=#vXoULfNkk0Er;PMvW`PsB0SmH`bkoRzxAU|A9O-eHX0y@QF29gLWqI@A6
zua-7&A`uj~*WZ5GW7xTN0{Zc<e#e(}C3*f^w!wU`t44w>4G)LvWFl|@Llb<FXOMDc
zl+lOnqzUXt|HiN=bad_TehS`fEW<$756cPNPot_8<j`ls0*2<<B)!I3&doFxKv<sv
zgm}xiBd<w$_<e8h!-4|6O2WhQMkK_I3wB)vuU{V%QdX8ui{Iu%m4qAM0keu)5z#da
zadfpb4S0`GSf8-_#3_T(x`JMTn$L-$yOQ(4_l_d2nZ>+$_M~4p5z}@q`PjXqs2yU8
zP;22piyEw&W6pJSl-70tkyH$#GN9=?CO-vcdk`0+mC;2~II*-m9ARHd2Ihv^JFhm!
zLTP?!m#XHM7f0MdWG@+(4UnTjhYUE*gK4dGoi+aRLa`=r5{AmNvGDn-H#j6`X?c@Z
zqh$^}<+V0Kso#-4WP$tQ_J->jX=68Od-2=jjB}CGRWx3oC*Vz~SfIkT42t!PXkOag
z0Gd*qye|J77%C87l@Rt{VF<)aVj<d^@YdAQs>kSW45LPLG70nofrbrp$c{IhB@I7R
zuuu(8u%)4UUviL|q<3fF;Z4|jIg(hT6j5dQo&jyvH8GO1SSVqo6p?Vbfq;!x&7q_v
z`GTGsP`Yh@c%tilWPn}qHtt=<&KePMIJ|*<$r(L97ZS%5yCV(kURP8lTDD64;{Cv(
znTn?mJ+)Pd1A*d<6={J;V>BM5uh4r;hPnSGw1a%w*i+rXGWP7OH0Xig_!mREMIsdU
zs2vYl;ttl}rlg&E;N$tK1i>qvnVergfBW;=i~nrb6<eMFw6~L~#l0)PzPh^!YhcOI
z=o(8u2J02|s$a_TEJ$=w@0#c7K>(`MIBB>kye(CH5v{$y3|e$c({5f@y!^VmeyJIU
zeC7708Jcc!=TB#zrKFc%TE=?Yg=z#_sW9ag{?yvetiOG#&d*)<vv^jmy?eaz&0l-z
z{@N(`_fpuu(i-LH7iw8n;B#wY_~VP_hJ==`FY)enW8%=3o(K<NE%lh8HGaM#KT*7;
zd+cYLZ=dW0^vWpmw%&0~Z496!EO43d!4i|f+pbY5Z?FF8%(Dpy=*yW;1G%YviqVfR
z{i(I(oj-Vg!0`{3<Yy3p20Pb%dY7Mn`ls9Z{;OF3vjg?NiUpMZ|5?QXl*Ws|rWFZB
zEO^=9U$1s6+{-J%DXDw7$Jk(WP4>S}?G+a&y}eo?safHBZZ7l#IMCV24X0gm2k@v1
zYVbF}58d$m_ieqTn2h#;CKB?wlOwkr@;-O$t_o*QWW}IrTvpyAKYNyo`u~E1lostZ
zH8lZCckoZOI&Tj9K^_jU0>EW|&YeZ`p<mjGR}DB}ZbSFn`(BBAswov2o>KTFByWgR
zZrBGRGA|J8j?9KJJk6Cw`-;e4;rpH`zr(+N#b1xO?%^!~c<h0*E~(Zb5d`1sgR^NE
zvF;jEJ>=pewbfskKmXbY&r?Y}&z14Sy;cM9wJ)*QiqqV1i#YREXZjmqmQ~Z4y_@+V
zg({}9jAN=bi<4=oS3%oIlCv|6io82>$O=)3Ek0D1Kkk6T;YC>q_y?Ko!4)-FyUeAV
z6Y_H6bF$JSnO%oa4{yGF)G*YyvViUebE4w7hfF(z8CKx!+(_2&?yR>We%{rTGfzw*
zi|v|8d6;mqpL<1J$(1v?Hu3Sh-`}_a+n3x1Sn-VXw#kXCxAk&9pgaykOF;dvY7#?O
zn#rEtdwR7QqMC!OdgSVFr{=@XNYA3NGP2^%GTI-$zX(t4l*dmBae<_+;`Ckf$#qNv
zUCKkflE)I5m{p^EO{e06Nvw3SKcl*<K5S1si<tO$F9R)*yz}*Xv7yS#REIszpd6x>
z2ak9ak)Q_>l{y=gQDw~Zx{S-ph6bhfCYfa@1TAoc_2C9OUTL?gNCe7hV|HD_$<gh8
zJ3`#w*W?&sXUeQll5xaPR>p$9qV-WoV=%YHawA{Ba`Cj9q;b$6!}LC_!HwlS+u}EY
zV6vbI16I3F<ejl|mGxjK%DbgP9oakec+%bLt*Gbg^;bQsFW@z+Wn{taU3_dktre+Y
zudt{EQ*mp+FuuO0{DM9Bp#$;!`!rg>w5TG^T&+GL?8$=^=cG1;$!SNZXTzqAvL#hj
zX9I}ykB`>)RI7l3Q~#5Kf;k)}ayi?>Lo*|*M%1D>Q5fdIkPqR!I1Lu;9sblhS>U;B
z^^J7BPc7Xxz%ny4>qGbjW7Qq^e%O~Wnh|jvzTkPjq5QN=cNXithY`L8vr;aX230Zj
zVY7wPq8wJ$21W|&8m%wcgg<;Btt1u|9)7MZ=9m2($~8aKif5QQzKqopuOA7+u-<`2
zj-YdmZdnRSQ(dnbWgNyo6h3n8d$r8#frb@ob<?q1O*WN(ZsNalbo4R5q4~1S#sz-S
zzP?i5BZV@utq@sngu4?ceEIoJxA^(1D#aC(YFu#YZ9vhzqiB9UZ87`#{E$O^58qFC
zz~(oY>nj-;YF6;0ec*6<0^P^Q&&D$n3xt-GH=d$x_^|b0O<f&_`0m}igP`M?Ye$v}
z4ZKx!@J@Anse@bE^wRbmjgYWWv{yOyQ|Byy04XWfRM@HX-XsTpB(tzfqO@y3=+Qo)
zeRz4>7%KEc$=H>>plO=LnI10xK<!VmSJ{Ir^8>Ht#B2sl&i&6E7z1Ii1s`cizK&W7
z9YUmIU0YkMa39!8U7cyi1^cA?*Su|Ae4bSr=4jkUALx5{{;(WXXzW-w*j_)aq_33d
z^%QUNcH$RDS`Px_VU^k7Jw)v*D{J2biqmcGa$0E-yj$(9e6Ko*?|n0d$5G1Zy)t1v
ztxuOu=<8!|onEbA^y3Bo;6sAor#@G!TPQ>C0KbmTmJ&9{I+xBdj%S1^Lt8-or-ia$
zv=I4E)=8Rb*Wgb#-9k>pkni_~wmJbtm4}i#<!KAU*?bPH?vZ5JUu=Z30R>NnRnB<>
zrQ}M4iz8Q-1)PO-mQit&jLi0!spZ!#b?=@GuYBC#E|*qW&K_82Vsa-$_-ZqvvTA0h
zer7APlZp@FPYkO)j9n|N=jU=7ixL*974h_X{e1IHqWOcMkH$<Tqg%w+ePd~<4|lSS
zGL(xiA=NZYQKpCK3)PPNJUwu+K}%cwv|w4qD_9dxtwK~)tAr8Kl6YgB#z*0Y9T#rU
zfkFudkZ_wM9%eabg_3<XZUZGt&G1~~_YU0}GSNc*vYn^diumIgnGgP%uQb+HK3U=5
z=%z{87?wp}bWeb?K4?5C);wS?-VZEgmvG1=hy7xTkks}~<1Ei<BQKP5H!y6DI4t_O
zf!s_q;WHsCY!~3{=<|{B=i3GkFT7Ylrt3gtkPUnpdgSAYy1H}<TXM@Oe)o>|BezZq
zNBg0XbJ(;2Pyobth#b^FvZM+b5cP8Y$!H>*D@WL*wB!Bb)vKj0R-Enx3e&(PloVp^
zr0%D)C3eQ*IL2=9@yJQV-7MPj%cL2~J89Ngws6f#iz%aFgiWY+#0B_Hw$q?zwVTKE
zv<x22*hiyhM>U1i07&oF8hj+%JGmiQpiO$37w>BYR8|<-p!I$L7hGt4aLc_hKa`<c
zmT-6jsDCFOs;JF#857)Zo9G_M>g;{<ThiMzmI&6gS&H163Hj9B7>~V~U2`oN{m#i|
zh{_bV*?wH@@nk1g<VWgJQH=2(Gql@^$&j2A)?4U)$;%1qKin}ga<WP#6Tx{=dMu9K
z?cdn4+vJXn)-kO|BF%~n^zp(o1k=4TYrA_gy3Hvlb393$O%yGk0L^r64G5@@&n}h~
z;@ZdOKLfw&?d9%}11Fa6_1K3JR;)0|!hn@o2ulN&!b;CfikPneLX*$dFT8NLB)Vc=
zfdsMZ8jL!g)A8oUR~vZ<{UdKa)qa;Rb>E}`c?)^1KKhd5jUjxs#>J^*sV@W+N2H|a
z$dTpUK-A;x8eU)7*{{9W>mLCT1C!=2a3DR#3z-2M2~lI!L^1D^8faP@72y3j%T0?D
zS>K@MnjQT7XBrh4y_0vdBS!DHKRjNNS#uzzZ9LQ$v+$O@Es-1&HkUmtTHG*BLSGlP
z>2J-b)y1W?W3VmjO##0$G~|}Q0y`9pEmQ&iN<AD{MXSVOPx-v8NHUD;m1THGUW`0C
zTzn-r7A+ng#EzJiKPdpT%&`ptR9>sAhfQ$$S$-&@1o&!hv8X=6^VtN!_|94$Hy>NS
zKppDzfx}4o${5a?eVJR4{QUV(jnXcpE@5>*u>orIZhN+#)OCXBgH?n^IP@3d(SiXa
zqlx0v-Y7?HZyQ3n_b*3DcM^9N0d^u;f|4Apt*sBiw1a~e*b$urS+-gVLlty>kUk)T
zwUH!mDXtp#j8qmG{xjF+z*RTt3AuU%Qc`w+un&ic%$jbYSS(+tf!sjgxQzj^YQu)O
zR^f8XaCAUeWtBJ34i#pj^^xhtEA=}dC~oYgZ+TviYFw`5MpsrYx9N6I3kdnUYRHJF
zsYkYo(;y`Db3d?%GxzKD^g&+*kC~=x7Uy;rgkW$qM4)I!C5QESe13`?0Wf>njI(~w
zQad}s@&G}U-Mi2uXWH4~>`pmqrlZTg9;m#h^KEXlb}ub=_3Fl?JpHW#E%9|u%__$d
zd<`^nQ;o#5iXZ0!f_>=WP}5Fh9jwck9dfF-2)H2BEK^=zu0e&_4-EqdX)~~1uuBcp
z)~nhm<n?PmP5Y_q3%h-&J;*S4x)vmi(l&Y-YNH)oaoqZHM-hmgW%OYBWaQ#5?QC_*
z{vQGNFjvu-C|0U*E?_VbXuxB`Zz6ZkW~hr^EPGqH;?K)?7EA;Pm*R^N^KmZxAH84r
z%n|2xm(&mY8QwSC5>r%n;_+b1FoZ|uSYn_0*qGXSjqIzaExq0BPF@7wv*oaQ@d0Y_
z@Qi)m?O&>U@|=@Qo3GFfD!leKAgJd&BL@=J;3fEgjZw$bI$BERM?10<<OnJ$We@us
zYV^nFT_Bs|jg`2`^lSdZ&Za}XZwyBd)Px|a*|!TRGZBU$tW;<O06-cOOD=OX6x#}V
z-TgPKFIa&f)+kdES?w8o0*4C#AjGvk-#Vzqy77Df&N3s%zrAgGUM2ln=QEkcPmEYm
zw#^3EI8jkOv$gpA!Gl|34odhnQ`6P<6S8gX2{;*B-2)lCxp@X?8GSar5+F{j#s`SZ
zbvT5OBLIAqU&+<eL0%{SrP<%ILFwJ_a5W;o`(@I+GB>fmI%jm+rQ_TgaL*<1hm-w6
zV?$F1w~=lhe|2+kU5gw6Kmqfb!^T%^0FW*Lz}=Etdq)__qYk}&wnW8dql+=V473{T
zF}Tp@7)sK8R);4|b2A57({^~Oi%;@IVP<f!$S<h@^0`Sxa+IZ^RTzL9XkGHoCp2kB
z<puahSb(@n>l$CwJX_ahc{a3prCrnd8UT=)ON7@POSOuprSZPi_u0K~zT$@#E<{zh
za#fRE(?QKR4Lj}FFkOS%x5d(3xpw&BK^QItF*u`=*;ahwUeRKr;N57F(c)CAA|4<&
z=F4Du=ZnYaEPd1|W*k&iiKM{inK!Oq63cVv5_^wKzbhR!;yX81>3E^*Pw3XrkGK*t
zzLmn)4-gR22<Hj5UQt2Lq?N_X4kUeG93wA`#)C4E^FxVRq^E+2lK}8+A{}xkNp977
z4NN;UObdK*;%xzYldH4q9Q<EkaR_$FgWKcV$<tOnI?ucVlDAk|YLD+X)vTB|gA<-G
zC|Moc^35njSP-KkRjFLAGLrk_w=5>em5xG&9%jb8(w)DWh2Qc?A+Cf6lhRJc#+^1C
z%5qro=f);8qk|JL7Us4rw#&0n7a{WAp%ib8T@b1hdH@ZQ0(05Z9JbX7i3QX%l9{;B
zr%DVA<g$@f)AMZ!DYb@ZeB~Sdt1IMCUp1p&h;@AtHh!dlly6Ir!fp@rJ8NBrM_{(E
zzrQ!4YFW47(;ZfYR^b}FiJ_18oMbiVn69d+z7{^)VJ*x7_r~76>uJKpQJ%NRKMX*z
z*i2iKhWVQS3E*T>1$lZ^=?LQ772m6q_m+;23qHKK)p`1riOHt>F^zm7K#RxX%tf!&
zX7DP84~B%s&Cc?$YO)A`lB7J4i}C$k9;g`|G@y<Uimp#S*OlFn6R~*R1kG19q8uht
zsD|jGO6xEZyr4wO8ZyC{sbk*v%nz<8^zq4l_s;#k#x_?BMnR0$^(H*xm%|DF8WR1q
z;qOph5e_x4Ii^YN7<Nb><7=RNQs<|mqf^P{<4l_a;&-vw4kj+_gq#2$OV(0wVQYeZ
znp5{XSK}mJqdY}TiC*_S=;QmRo4&PQamZ|5E*q@P1@~ae+C#I90<V%OJV7XX@!sjA
zyjEI(!#4aiq=(N7Y(=A=bvyOr0n@DlrTb-bdckv(*+)U<SIIaz79A~v;LToVk}4YJ
zuu$$U$(^;rPy?;ufRqI<kOw3eT5BDv%9xtL1}#6xX<!tDqVCvh>c(xTYtAkUA*qdr
z0vg|kho=6^*nICS1#}F9?2>iO#|CblhMvvx<XsGfRRr%G*O~XW(mF)#gVk%#w$UYJ
zyvVS^0>nbM4T%2y{#FWe<`qgEk1KAhIt#E8KxY6spO;ySR3wWhD>V3x0T2*<P{Lar
zlnZ!a%4hU;9+T*AJ=it*f`y+;swSSDnQztQ0h}y-?#7KgZ-4YjoVw{o*@Z)(4|h)T
zE3sbR!C^3ks%`in3yQH$yCWk)c#gs>m$st<r$1w)-r(jRfA0lgactmWW}3k}0Zyyo
z;gAsIQiP>pIB0GzMb_(40es}UjOiKa*wSjp2NiNU%R6o<us9u<#gR3jaH0l3crC)+
zffKcue&C8@Ns`g@wArC8_aq_+iRn}3KX(O<=JllsU&K*Z&wt91q^&GLu8m48sKJ`x
z-X%!905AyK&(1s`bvdiToJb!W-mY%f)z#(qa60u6QT7MOn~F(==HiAjm2~)p?xA9@
zeME^z(<rA=JWNK86juOPIr*kqEm6tfVV5We4RVAqm|K;bN1)RRM+1X{9x*5!o;i}W
zEG)scMZwbW^v)`mF$axsKMH3qexU!2htvaf)3Q|6*ZWS)*GKrc=Aa_P_n^=H5}_eu
z3jkx+Yv~-b=ij8wgab9ahQ4IumZhi{%qkj|h{=G;>k6Q+oS|gt=T`SzEnW+9K;UP!
zv<>Z?XT8l-whfg|4;;>V*RC;{B@5{S2!l%Pdz`S~2-1V*Z)^LpNk&;9Ux;@JL$y2&
zvO+l|D9>wxP+fyg>*?~e?lI6cxg*@3NS5kJtD27kCv4wf0vKQrKa6(<9e2>BzF{)@
zpDpg3X;HtsJPu#6JeicBWHj0G(|#s^DTX^xeyG!}SRZ#1^XWlqN7+KPoS*+hRV~3)
zxVk3e=zz1!{kCzfG$(tVhLs9(i8Sl(q848bKGiox<0^A~E5v}15{s0hq*=6NsV&T$
zG8p6{ZQLz6t^PKz2VC)Q_pGdAE*lj5Sdwpj>ruyiMNi$*kbHJ0U}ezr!w2dGA1*bI
zeWKr3Ve{>v+DwtOD(l0(aR+^nRS)17I+sr^$<*n;J$z(ZG#jSzy43#h`S(ru9Mg|?
zqKxnq4f=b)o3XiLSA>)Et!2%_W#<o0jx68IYayLIW<i+RnXHXO_Z))(JqPis9-`TL
z`P0ye9dA}dwHNaS0M-M(>fUJ?Gw8so-k^o<qrkbNgw5I{yHATczHWRwEW8r<D>^|C
z0}$UhtJZMKx+jSmZXF)PNBQI1fB!{LvU3MX+_fyc@tTD<hmVM|KE;iT%6~1sfCAKi
zieJ4XR*&CxgdSu<xJa(Z`u7>?|GW7#=FH7MT>|_}sKX_E`Zg6NAg9Z|{XAG=RqY7K
zuuMC1#A%R(<9>{P+>q*?Gs4$h5n$9*GB3z}##29cNTw4dlZi)sF^{KW9aUOBpXRDn
zQ+5mMHB8-gAE;zmnI~nVg<hkZHD-N_qoENQ!|(#KraR%Opxou99>qfWp8?nA8~N9l
zQ(xDbFD>p*e*33cY#D+2=SdjfpZ^b)`J(xh--l~lJ7Lrm=c4eL!~X8zKdx2%wE%co
zd=sjd<*1jn9}wy<{uH5JyP<AT^*<n{|C8)jP1*CGAp8HO(!RM+zAk_Br=YXypPy;c
zqY<9p<pn;0T5bFH)e7WncN>0-!yilk_D>hZFJNwenV<7C3lvGfMNP0atv|Q6FY|Lg
zOJ~)$-vuJ?{a3O6_bSqV73-hzrBbE;uVVd6<;njl)_)c2Z|mOw=}@?Wi4<&cA*044
zmcx_@QS)>AY@Qr!O?)$V?%Bu6J^C?Yl~?-KdHm)Orr)mm-1phKwH3R+UY)o3`^;6E
zaW4)N6u)l>*BjdLQ{1Ngw!5{CRqGGY?q%{$b5Ez5vM$Ab9C!KHSmSXrS+03czB!e|
zTE-HUpT{(f8m`zCw&yr3<@#@5wd%+3<rhv9e{W5){{xv6|1oLI_K$09d4CLsJGY%9
zPf$&XRZUsXy_@z8vAfA3yGPWDG*BCJZ%oWhqDFY220ff8T?jOh7iimwRJz`l23p>l
zx6-z=zH9fE^xy+Zd(;ovP;+;jJQ7plhy~3K9*efJ&<JOa2Af;@YZ~7u!OW47&JWCV
zH?*cLEp?JjP1zC8wc%hy+;(eMXwm88*d-SdvD~>P?~H>ihw}xAt(y5LR)mcQrH8+2
z{T9v|QMG1^-3_x-xX*^kHg8!56-NFQr3|JX1TH*&$jeZ+c0zi`W;BMq9<k0-8^fmQ
zI<iym7qRYbxcPlZlMlX8j(91NxFY5Rh@5baU0`wmxc)A^&S;$bgDIFO<?Z9s1-cfk
zvJHwacZd)tF4}dYINnN2Ne7<pVxxQwl}67(u5KWM0Z_XxO>U5OK!=MS!SI-j)^Q2A
zk|O4fr@>*pix!tRz|xMmb&j{DRdp@y0<DS(N`@ui7Kcgtrr+)siH4~LbNj3>>h_3w
zkp{2g&~M}t!U#pWFW<}igDV1W`8V>azF#LHgWk(Ic%JCOEOK0gA5{BLhUWL<RZw*w
zsMoYYxT9ymNC@*JV}$@__^g1nX}|sZ43*+Cxi-coufqb}j5j$cDqw&Q6U-@VVMI*r
zSgycvOpHUocqv3!7#0k3N@DS)<E^Aat72llG1V6|Vk179XFvBZ6_oRrzta%@;BtJJ
z`($|CX?QKTPSVG`1s1g^5pgh@3v2MwDI*!#*^V~m$Z|;y>l>p1{=9=>-iGEJY=O?k
zZ@--c?<;#>_P1Z!h#GQyaE-R4u+Wo6$2(%{uaDgHu5!LcZ^$qqe*9+YHB#AyBFlZE
z{OtCaq6RDeN8WAe?HruZoAIE4?dXMyoZFJo-rin{3X@~CJS670-AyCIQdOjr7o<`K
zcS>TNI|be=rivN$490*x^-BB-R(76F9i7Vndj$8Zl@1>G-YOFXKg^1xi?a3f^k$aQ
ztE+Vk7kaNqr^-~-*4E~8+}ifS=e`cT(wK;2M2C0C_PykSsa3{1gfGEWpSLh&E&JUu
z(?%p`TtRD^hItaKbj5z3`mn&$+_}3>XuZ!=I+V-1DkFLKjUqp$NFHuqY+uizq?+Zo
zZJ&uJhG{28z1`Xy&o`>hR{lTLNTmVw-M~#6(8rtKzdtvo&i{JM5<}eWO1(a7vgYKY
z^78Vw9H{Dc2i24}b1Ja<v1Y#taF#O>`koJh>PkmOM%sv^aPE_2>G^#z-8u!bRIUMl
z|9Z%)6{xY$v*UVf|FTgReaUW4xSs^|F1!(y2`^*cqs~9|aT1F>3}J(%?f70ff{v1L
zsKKJhkbJyju}Z}&YPnUh%n=I=TQ+r2@ow5oc;LX4XpAh_Jq8BACH08V;KLC1YW_`{
z0Zx#{4|jYWteqg;D19wmbetK;fp&{Ov?6+jT$^h`mro3H`<F!zxJZ!>$(6Pj%eX{)
zCKR+G3AIjH@Mc3yy(t)WmXw!$@iOHoQj54x?&6RKopUKAvgx&FT3VVeyh(xo*?x#T
zsiGzpi4gOiyj!MVTiOa6O}lrwECpqK*d-yJe5Oyj>@wSbocoa!j`#@McC$*oJdf`}
ze{zNpLXI2ophKSf1nR=*NKd+nAvm8dB*rPx)7=0%w%AGTnV)Y=OjZ)0mpbuf>`7H(
z)fk1FKzqGn(}Mggxfcc@d$EWrB@KT^(f8GB@I}%ATmyWJiDFJTGd3DQ>`qxy;snO}
z7{G-ZYEhY<J!F0s8(m8a?-?tw93<<rAHd(fs!E8Myc0mv-7UD*yznjF^~eEJ?;=o3
zW7Rcc<j%eHpwr9EhDwo*#4jSgF?4}*g}w9xjCZ>FI$`W=<K{cW>)?{XvjLg%p%Lj_
zZZL$SZG2O)Ztb(e9l?5sO{H_F!ie)(>nc_c9>++Qk#tHMxMv<_eH2^+SHTHT-+gU0
zaZe-SFAe3x<V^0b6J&$9G(I|C`APHtGy#9*SE11~;2%|_4kj|;XbEX}%Z8`^6&z0Z
zKK}|Z<U;pK-9NPHA)~u~FW4X7CIep!9F&8DthRW`NwK5qCGCFexDFip&4rpi!Pc#j
z$hIjkk`PR>s_qk%{js#3`O}2SXy1`=avXB+x2O?tpX+LkEI45>N<$CHD^g*e;xe2a
z7${7rHZ4D{ImbLnIvMVA$AIVb-YeBS@$C)HZf=bn3K-_a0@nwVh*ObJsn-4@k*bHA
zb~3vPrK71b`a_6|B_(x{`0h5=-FA7HgC$O3$By^Kc7@fxcze|nd)0g6=YVRNgHxk<
zgV_wrC|o$Dy<Ix6u!QREA|%=t7s2o*M*l<C(#Ad=r{61n9niL#onUH)BN#WJB7VA=
zf`kmVIYh;gAuUU!ec2{t{Ua_CBahl)VjKRrP$P~pa{MZnlgSS^eX2tWsvC4E*NDj0
z53>RTW8S}e_bb|NF+gFHq-bkA9BVSB`n69|Pfh`(ut}j!oKiMUF-uyzcI_$U<27jm
z<DsXet8PgpuCxVcfq|Cb4rCFSn+F)>PNB;ope0&*dL>}cmTCX6U>E-`5`@G;zT}w_
zr6s(K43y@Jt<*SysV^Dn={7jW$Vceji;c>ou>t%=6YZ7LV-Y}Cw+IDCZ}AuW(9Kkg
zlfEo@pU*t7`@9S3@H*ESTo@fCa1pqID~mp)*veH)Q84MCx8Vqeq8l;FDLK9(<M6{F
zz5vWO<G$CoT?O}Li=@{WtY(Cw2L9g$FA|s|1A@?d*`4pFmeYFZA?TUGI#C>%JA9K=
zBMoTfHqr4ld>fjt84|tb<Wsq?Utm^V$f9TA`wo?BRAqzNOXNglT5s<IDL??@p#VVe
zLKT9MsM^PlJpt005)KUn)$R6zy)q9Y<QZP0)7=t_q>B0l^2pPUJA&wrCJF*O$8>!5
zTKk9*Vd%2j*Z}b&ox^nkld+62oCCit1`)<Ci#Y<T2;;VzrR`xW?&Ai#Yrrf+;K`~g
zEAx;<r^K|%S_U+?qc(}czySG*Yaqgo#8e%lv<){e7VZuk{6a45_-%veQmHIX=JWTi
zSAM_p@L%{R6_lU8|L-i!o7>{w@LFH^Lx(?R>X!U*v*GVT=Vs9wyjlJevwU!0$o-}U
z|9Z;rCg8*wE4qrvc2cf!>X{G8%F#eQykD6u<2o;$PQZPIxUKg~MFxq_-i1Y&o7wXZ
z8vkbgq=c#p(Du$hfwr4O`oCXw(2u}GL+e}t?|7^!4O!drC5{nF1%dX@^eCl?1BclW
z_3e~2BP%m!%IdNuDFYKeT7OFMrBfSS$d9Mi@7q^`{CM;GUax_KKSmq`U4nd6`!Zqq
z-1gs_o_|yQgAo0@vg4v(V1b*nEe0fS`Ui7E*Kw~#QYpFO7_3KhT-7NHL_xn)zJVK<
zps9RdACB=AElPSR#30b^@urc|i2$+iwf9ic76-%F%^#DBysONBxbOT4anDLNeHn)R
z!D^U3;&3Dl%wBjmo3B(hS2+yt8FSjH!A9*)DQ(wekLk1`v&-h^^AnSkdgg!jA%f8h
zYT31A=cBJX&exz(SE~F?V@j0jzF!yGUp@BwU8A2}du5l*_I}o`zn@|KJ=qc9vmjuA
zPmnI{{}bs_;^nXFR7#w2TY$Jn{)D&*q^2*|jB1kwVc{vQ?tuQ(j4F=C{*LNek;*3f
zu=DSPwQbL`3)#z2%(1*YzQKnK4bV*!d!S6M`-g|rWgMJ-0q0`-q{QUNx|><m)3slE
z!T%r0P7__f`}*-N31dY_f6>x1eQs@_*QG$4q;6`TsljM|_P?#Dn*3`%K2(e(QG@Za
zdOAFs);Tu^3yyOzA`#*7k52x{XZQL|v$Ek{QM|{eEq}k*P|N31W87*Y|G3!j!RjAd
z_FoBwQSnWhbd+O30l2Yc@n>wQd0micHyA$kA9jYt_Mp)5XPx1?q1iYnX6L!iTv^4~
ztKWY%@bA|v!?S)<5q~5@-re@o4UC2cSl7fhORpm!KFDTvg1;SLC;b}%kqC8W$mL|p
zcsCuIsxp*O>|NMw^7#>iBpK&fFh~qJTD~_@I5pb&tn62KG8nJl9mrn@VYamtm01mk
z|8}2Xt6DXAJ0Kg}bZ!bjg9&KPb~(zEYChNCBq6e%I^0uYocp+WeEZO1lr!`|KvBoF
z+H;?s_w!2WJIKxHaTlfU5MRt}TLb#0s_Z+>DOnCCkptC!w~`We>pdDXQSMNdj4L`Y
z<VUSP|4o7KPs&z)aKP$ng)Sw(_cKvGQEF>$lVeR`O?1Djo(4BJWRHauY>$gTRMvPQ
z5SHMLCns<_)zxuD_Nw03p2DTC0KF*UaT=)v6D799mANx~o_yZ9^vQUdcIeU=c(U=P
zqHf#nZd{)tMkdk@t82eg{1cGv;6hb1JI9*+y8Bn6_??}%k2+ILHgR$Y60KqOIcDeG
zi;3=`<IcbF0dF_$hjYeKc}qAab^PEa@z8kwSupG#j6y4R#A7cUyhi^iN3Y)n5s9!I
zqxt(UiF<70)`}vjJ<hg`!|$gCZ+b8$bZe|FElrcabg!DIvWi?cLpMe50G|{U^&_~+
z9t(#mB#MSg&&aR^lNm_*3)>NhN*}-;;nGXw(i}6&TC<jhh>i7Q9M_fQ)B=wZg()?k
zr=%!2cV?L02q1FUpNa8<H)$gyKV(JBeUsu$w7_lt8Y!4N@Hk9W934#Y0$Up{{T2Ml
z2v+f!2^in2g2VU)U3r1E_wIm#iN(?XUn|%C)a02)o$-PrL*g!06a-wQwFQN>meS!`
zV39^{Dwl)+p_I-b*9a66KoTe|sJoC6Cpv;5&>&X>2!vZ8DKer}kXu5~grpKkLLlLq
zJNekRF#GH7%+h}#$@hNGInVQ)ocF-YK6}X555ImS?}v0DD^0HKYA%;<itxWYO)cTh
zzI&Fs%s>alKlGYdAhjxcybLCW%~>fm9EX%XpvLN!D~8oKrQBJa;`_uzKe>Ygb<F>-
zD}+dr)NK!1TwK!N()gg!_0~;xU0p&}d=eVu*P5u!8ra?b=SUt+KR@|6hH{wrPce9I
zYuC1rj!e_Oi_Y}Rv}ZXk5y_2yPVNThEL^rsEpKWG7L0Grm80+aS=$I(SsC3Jy!u}R
zLkLlD9M^_5rnQZIg1wQQ=G~m^%wRm|#8x8>Ci+dz8VKsEg?qkd$+#juP0EHW?2nr^
z0b9vyZ5Ex*{bC$BJ#^NDGaYfas{ki+z#+;3wkf5%ZS327jR#wYOf*ZAc|>759)QH$
z!@vl&w6Wwo^CzVMwV@|!X}mB$cYDYoR|<@jFFZEp&E?AF@xUw$o4BF408b}w(?V3G
z?5`T{6&bQ59CQ8r6x|dFN`IUx8~~esIu7NL4T5Z{-0RH!ZMiS0!AbN8e!DTbzUt~T
z)Of;ukQT{bY5L27%8Tb(M4axoRcY-$*BgIW@oNX4=(6%D^K*i+Q0zRE>n_smL5B@B
z#a!a*QgK&+2Bm?v?i80C;_|1Sd{@)9&>Q(;PVYD}>LeF=&OkS}ly70Brvy%j+@+9s
zz7TcdK%qU&R`xsOt+16%4f(^8<JR7|eDgL;%D7MRwB{jgJZm#>57oeOwLZ*|bPclF
zbMyK>I#B31pqY?-$1DELDpa4cUJQf7XPeJQ36|WRS}RgrH|8%QCdq5bea@lz)%ejp
zf-7EQ;{GCKeOOxKMU6t0cM@EHw_bZiq*YZOQKG}jYl{pfb_lM{Z*;VTIDlPHH#M1>
zme&@tD7NducN2Ak5XO4OrA;>`f3J^;@xXb|k^v&^76D}hy!ilcV7s1#R3iiSjAJSR
z5D?JziD`su<O%qh(w$pt`+naaio+{5CC>o}y^n$rfJW5eSXvYc4KwD1X!Jf|pxQ+Q
zNuv{?f+_amZ9nN42rB1f^L|7FA~GjgPsIDfQa#Pj2L`;EzMh@c6;Lk8&MBTw<5vJK
z*c4of4ew<Jm<GJj8>6tz5qzUr`7Q}3exEehJTU`3eyYf*@k;&4Jw8Cc?m&97LyWl6
z=w=?7=>WNmxi@~O@#b2YmBz9g<$_;;llRNaeEfX%A^mH<a0_+*80&WLhNmCnbolvW
zn~Hks<kwizg9pe>z12s6ip%W2-1)i!Y~Tfa?^VN`_qzDLi%P<$1?6W0-X8KTYU0ZK
zwA)a4M<$;tb^c<;R{xISbi4!2LTQgoUB9)uZgJ$Ghh{U;Osz@ES?IzLY3*X<r@J_8
z|CMv8KY9iaA&IdeQ`Fg>v&$0tqwyDx2zwl^7`hdgo-fGgO@66esG@Ywl6?NwDy{OQ
z=kL!)_YO4iL{FEs+~D2c_jDDwh{UiKN}y01?R~VNnHDqTt07Eo?+iH8qArwnE+?+^
z^j7knBIAHuc_elf5Yh#N+)2~G>ax_k!AYlj5<J}&kgudFdPhBjSRK-h<XJE!Y?Oc>
z(BFXC8)1GhA}xo6BlvpYIgdHXZt;iNa^6k7RFx2O{6nWY_=Hx#_cRa#ot}}gkzj?*
za{v2R)c}v9PK4fS4ye<FDp!`c=Mpz3Xf(`u206VkR>id<Ph1#V&YfRvgDJ64cx7{Q
z^B)6=digUmGj%d(>#giHbs4t0pNhY>N0<$Pz1eUL^!8bb!g6_qYbtW5jnyXrTVFU`
zcoo$6LY1SLn*1@sVtcW4bSytxQ5S5J7Y6X2yT}h&>bPTtj*h&B^k-g%DS7YFLA*5K
z<e+hXjTl;TTUpd$A5RP#i}ac?qAxXu*~nm2fckW8YmKD_NAvFaj*1qXJF#DzsOh9g
zFikOux{)$Av$Ow~4GU;|^TaM9SnGtrC1v;7;zr(5uCerPS^mOp8=|&N4K5;zVz4QX
zDV4kgUK-fdQgwnAQEpW1wj7}%GgYsAhbsA=Y-bvgwOJMH4!tT9M@TJHL}(4?su4_C
z%9gld(kTpye?w-3x5~zl!<Cp-d-9c}#5>Bi*<N<!?LGC<d;CR*LN;FYu+Yv!KVI|A
zq4wJD`T%fp<+WsfGddbGq2Mz`pCgsZ>);xuTvaTwuwe9X1eHhg^7=q&v;gJ-bwQ^q
zpyi9ZNAZ(ED+i{*b6!xKjB*w1%M1(9fh#CcH{_rf91NFM8b*rBc5Y?vE0E-D|HpCm
zzjg<p3V@iLD<H0AkLxacMKlT0iT`X>z@7{?nZ2q4J}z5x+}K0qn=;>$GbeW=BKF;W
z{t|i44&kL+gJ;I^|GQ8?wzfqR<CF9QPLLZbW%rE~m~@J*F@+hK>7VS5zxxEOv(qiv
zw*qKRj+lNFxz+-MuL%STBIW;HKEqTqYYwF>@Q<4Zcs&t&P$S?r=-uvC5Vi)vT2CK7
mlRtf8ZPI#AW3YI8fB19FuRp(k{^*Z0LHGs#qs8ajAO8&|um^<z

literal 0
HcmV?d00001

diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/pict_5.png b/clones/download.racket-lang.org/releases/8.6/doc/guide/pict_5.png
new file mode 100644
index 0000000000000000000000000000000000000000..3e3b3d2f157bb81ea2fe7674a67f8b34fb497009
GIT binary patch
literal 21361
zcmeIa2UL?;*EZ~oV;LJW7ElqGQIsY`dJQ->1OyZikVv8;y+rAu#WLt91B@UbU8Dqv
z5UCLe#0E&OA=Cs#2#`R45CViG-w90h@qORt`~S86wf^sWvQQJe?{lBC%eAk)_c?iR
z-pp|Omi=4Sty{O<=<F$rb?d$%tXub0%I1yWH(e$b*mdiESZ8$VC#%2|#!!=wct9A3
zYrg)6uPEzg!oEjVQe`j2A8k@C{<N>p%t=0v){WX}ZkBqQf2*6d>3XcQYO)oys^rO3
zo-rve=p*JxY<R4*lS<uLe~)PCt>u2ih-YUXX3543@A>BV{H61+zB_gIoA#mI8^ehC
zG5a-t(X@Lf_T7?Yz}sV{mS8sEb-ZkbFfFn6eqGADJ7Q~Z^S5k;uf5BaKN|Se>f5LJ
zFNQa)zPpwGQNj15^iE|A1{2_oSiA6+1&`Jiwou|Du6g6<KZbdDHOVPsU<>7Zl#80Y
zkq&B38X7b|-jQh-E%~=M<);rmLK#)w_;A8yWZ@1*O-E5Q;`3{SchUB~J$A=>Ks)>U
zwMSlbtdE-65`JO;{r%rY`*Zx$DyBXZH*S>uTlz?}fxpWAEgU|Vi7hKDV{la=R7mqy
z<JW|zyFdFULRIU}@xwPj)}CawM-(Vg_&R^lcINBVcgHVYeZ6({-MWka_Jy^a%77~+
z=Vh~Q-~LKnQxlt$bH?4>-Okpwy|?#CngQAil^!22>K71z>@z(QTZtBg^>IgM1J$&&
za;K-gHhlfn;aDS6b94IaNd3e5k-{M{7&Z%~yzQi6)B(9=x|BiK^SHP;!c=oaaARUZ
zBms_FUS94dk+PSUgA#M{;^Ovzo83b~E;ltb9iEEbRq~$j64Q;kISGCG9g&JFFV`q5
zFV8P3x)4T0z;QOSftMkOn(i))IX?BLv0A7<1;MD%^sJ?`^D8PYwY0S47Zk(^RhpYi
zOGe!^&u)!K)nI*;tYQ@hbG*Xeeqd1d?b@{~Xn8)*BJc53r~=3NkZ_nZR%!@*<Hn8M
zy}hzVLHv~pCnqQQYs4BPqd6iqUAerozdygV)l4X$!a}nNUpo^MlcbcC?)UG1>71C4
z=TNmEd&-9W7`@68`XO4#;Nak@1x8<HLxWN1Y^@lIx;QrGBmoWbZCYq-H1699_w)19
zLGuYGGS0Uy6c#E;Xx%uD2wTd|$;mlDgp^ymvOdlRmQQ)9>F6YJnv_@{)4XYiGYbk#
zom*2boIH7w;>qLj++1Bd;uLI*`(>(DrIv!a`4M_WLB=el{ne{mqn=PGR0jy6hPMEN
zhAg(vxjzx(^rFy3T#D6MFh8?2y}T>OWZxe1_7WEtA6U450SF>a3*tWjbj8qvfXBoO
zzAJGjD@o`Do=->fD?~*_8!32iw8k~~paV^t+Ca-LE4zp!^86Q=7!rweXDeK&=2WpN
z1BcxoIb8OK`%?KeHTukQpvLXnwvE4kbZGfw1Y~za?NRY$TJ|+j!p2RTN|0kCBO{f;
zoI+7Cu|1o=Q9E|*>H1AOa!X1qF=nZqqfH5l;=nk9<~}_b^=!Ca{G6w<?Ig2?TX-Vl
zxA=sFJ&|YBRaG<Z-P^c*`}RC=lXF`d35n*y6crV<{Sh7oJ86eg&FDP^Fj$!B7(!)?
zMq|OVgiCBSfx(g~!AvNs8eV%%8OZ3okB<)+JTfwJa&oemjmsKsKDa9T+Uej|{+$!0
zKtF2Q+IdS$sDkIu-_zOhd$&!#y1m}b&8@Q`R;H}D_*qd=Q3_WDGF`;te|$%E4DTkB
zozcA}(mR1iod=F}f#V1tw9I2&!?X}y*0-{Xk<=Onq!^%2=iB=td!p<2?6@y9qq5S{
z@s%ak@)Qyc>uIYV<$JsnUhh*A+ZItj(lOD6i8I4E?!Bj%_QvLtP#?~4#>%fnd(zu5
zz_SkT{5JB}UtQeXjDh5UOI&nz#w;+YxVpMC)f`IjG8>03ICb!m4;qWgd$Ivn9n3L~
z$-!XQwPJ|(YNkdOdXnV9!4$CI9a8$w`TVfcnHQQg$3{m-J<)x#q~YPGNy*8;FLO*1
zlpJleMrL2?3s!tW7eCww*tdWG{^FI_S%chb?!cOIT)p~OOCdVG<G)E?Qt~<mB%=xe
zjtmU>5t&X}TzpxxGS`&y)&(H9x}KhgyPz@gG%&=`)`%g_t*Oh^K_qW(gcw9kMdg`@
z{^D^{Q`3GT8cn$)2E1CA2{Bu-w|>uHJO`tgw6wMYpD+TKEKiuD?Yct~#W+@zgkD!w
z$g~^>HM<l7<`yFj4PCY(7uq*z$jHdB=SEF<^B9ARCr{qpA*q*}tci>-MfisaP5dfH
zXyT&)=C^FTTX}Qj9=PBMbWiIR*2f)HtZOvqUkkD<<bY_PVJlk9(%J_PzBM&7n*>_h
z^3B)%cx1X4wI-FNZq2e#7Aruyxy6+7abk&@tVk6Dg803wsNUx=e<nrIC}@FkiSi)?
zfJy+95+}`GSZJiNwEd}504DP?GJXs;07|v5@^@uYswXEVfY@59%(V{m05u3PW^8Qi
znItAV`}EzrcZE+~=5k4WeR)YqNihqg?QuE~*aVZAK&D^RNiARb@fPZ4bSkQ^Iv5XR
z@%XH??`UJ3XWKri9Po(2Aavg}^i|Y#mAsCQ3q}^l_BL0gu3mqW#ViI!9~l)D&xTOI
zrSg7o1|KS?4DpiXpj?s2Hl>3e{P6R3f@~F^il3WVHd}NJ#FZh_FSsdHO9YSZ!NKPz
z@9%K+@=_WY{G0rq7Zy%_czb^X)$+)ZBWh5nqAO3ftL6Dv_O+-P5KVyPDh8e%shiUE
zyIKhr#K=H}D{W5fn`Q@*D3mlFQkSDxSK&k3z2iRnzQM{*z^;%rOHQp3dXmv}EUu;#
z7|!m^-^{n_GIKLC4`F5*eX8~~A${IY`v(U6mggrJ;ooSgm|6x*56Uee?xt8hU=^oA
zgBQ-)p(!>tHa=bs@IgmsxC%1GJYBy<*JHu&DtvIXhudV${L1Y8<&#%g`e2R4s*t$F
zfPJiwg~q7~-T*zT8bjeKTOB8SD~H)hDi{)(M3OtO!`;iPaGWRqN5JvHrzdQCd(3xv
z-qom+j6i!<{8IHjuxUK?(BR{xAAW6NMuY=7h!X1R>UMA2NFtLlRRPSg?WSWVszC@m
zx|k4XY8ojt0B}Ky!cxL=gX=zV$Q$eNZ_NPO*x6YClLql+A=#Z)lRZ8)brFfg9g&ey
zS69#O@3#Y1mY<RFlMqM4Sjp6J01K9$o&}P6flmYV3PH3IUVy`yM?^#b(?4TY0xqVt
zr2{)6H8-DIc;f>|i<^tf`G5fYX!s|8i^Hu=)&P*fbEPk(Hv+7}4hkJ^%l)@8Jt9o?
zZ71#R?SXSX0@&5r83VNK(RMCR7`B=oa1vU|gGF96F*#Tw5z)CUf)H8`kg8X6l0A?n
zu(d`{;KK48RD+%jz|ai?;>fMxCr%4g+-ZM??;yAkt8QpL=W>|Hr3b(66B=|#^bOe9
z`^uKBervLv9<0b*SnvmPpLi3#wK9O279St~iNjR~F$ch0?a0kg9-F*DJmdUXWHsBm
zRijHyT}8!Wu56q1=(Z2m#P-7H&vSuG(&$rz_}$gj)yrea$ob*dcNyin0n_6$21^gV
zzI{u7ad<soMZ9G)u~qxoFo=4<*E(xLxxOF_r4WyA+PLu(J4mPqfS;ENYlzcQ>*R03
z%VU-jUIglSEuCpz6<^<CU7{IA7(|`W@0$QY7Ln9z51@wPr-)X2EGCbFDC7N+=U6gD
zS#SJ-wFJ=Ouxn^hX<nWYFqC*IlRQ4|Lcs)q%f2kjqhX}(?)OX%O!6XOHaFJ7>~<Ne
zL}-G#ZA)f)5Fi7<;efU*It<l;LT<94Z%o0G`!c&U5RzH#1gqvdHu7<uwGm=vNUFYs
zLD*%3#n&R<UQ&{hJz$zPGitwC$!7ypR8&%umyA~UZgVacYx3cS?fUiW0ir%Ubr4o~
z%`09zt3$0tk(sdcO-v;1V}Auw4sb7TcuME8F=uAx#SRIbtm8jC#oFM;La9RY1XMjA
zkkk)1w4CFHm>d&3;$Hg<#PE>Tmi*ly;DiV2r7?)Fwu^|s!psxJ0^)Qb;*e)3;AViU
zLQ!+4Vq;_H0`(?=LztUK?>M0K1CE^R^Sa(*p`iQHb>QzDAku3<q~8PJcq_#}<_yzG
z?J0973t2n?=e&vtDQW65Ae7~IqvY@)j$;RDqd*LOf@<eB$)O4#8C<G%3tWB*RrH5I
zD+bz3#;ndn*Jrwu3-|CE#(uX>lhDv=vs9hKuDog{U^?1(v805Dmu6ymY>a@mWx@5e
zwWk4-kpsd5iUkm#pO+_OeREO%d&R}OW@c_swtiS<({*kP-!e<l$`JBQ{g9Vgtm~?@
za4$}ik&}AB2rA2e8uoB@_GZ%*@aI1MyLYE3Qw`TG0GkFxG#`s?s!;R^90mae5dOlv
zyu9Lt7SA{hNcjBx{B`QQq(PX+l6rFlSIFSSu+OpBE)v$p$IMV1X!^k}8Q<YoUrh~F
z*#HtFKXHTV?feLJ6H&p0SU*IG$evb7Z02KuIoeoS#_ksv_nYjNE5qaIlO(LRYAxYq
zTPs0J+uiI6e9$J3Wnl(LJ3_myX>P7K4H}#S$Rk*dEsMqK+d3Fr4F?p@5$AV^H#?tm
zt#_&K7h!Os4NlQUg(M8nVUQOn5}DyZH9~9M4*XmvU^-<bj0jjCAd0M-oK>?Wiz5jc
zcQ=X1KRP=e0jYVv4;a*uYF4Xmf0=tiYq|l>+<>P>tAW{LhWR|Mo0nG)Ak-jM+jo9_
zW=w2jbp4^X$F|h;svuXyZLmTl2-n~Dqt90jAk(=MoqAT<%El&vGj>c*?>Tsg5M~XQ
zJEBVgJIu?I6Xr@wEE<l7sLE<gNjRZ`9f80J?`v*))vbB`OP6Dsn$D=HY`{g_ZrnHz
z7BNYuE4aSK4zAiKjaO@|%={|b*4~~348gmcJwHD_KhZVGWZLMYwpM_ModEs>^`yK4
z16t5(r>U{c5xNXL8X!HEKnZU?yl72>VnON!@D89*1C8Yfc{kMEZPod8UTS*e6W}zf
zVOvc@13>&)EEX$-Ipbv(kgGQx`o>j1-JI5%YAL(B^W(>7O7@l4mo5Xlos0iTLUi*t
zr65H#q8n;>z<;s_S)>gj^l+CN3FJ={3MFRw(4j*yJ%T+4zuUY!lo*+=Q#?B})S@Er
zCeE%xYHeX4(vkJh6W|IaJuLseh?EoJ9l#46zsbk^If%dluzSS`?s%zjs+a<>-AM-H
zaVa}IA27XMV4U}rkoq1PhvJMK4Qi!#Z_%z~hC2acjP7DWYHK$2s_W~gK|QZux$*-I
zv48azF}y%Y0Z_>_FrKcbFcVB?ojRCtR{EJx`d6?11fBu(Z+-AldrPvW-$Z9NBOU4J
zm_5!bUUlt4?{pu{^aM?6h$SE&fJcA;cj1Tc-Y*e<O-kCo;p^KBhnLmDc-C5Ds09Q)
z0ob9NrzZ*6w-TISdjqkh#pLvX4<x|0?e{49DpQ5-e)Op9-fj7S(Pd_4p5|!QC?i*L
zJEof3+MERe4h{~l-49+@`dGdyu$}KlZUP1he!|~g1#X3{s)D7arV8yCSbdm)OC6{Y
zHPr?o^f`l44ZC+$HqO|yLIj`>qq(WhT+ln|^1Rv8pXOL{LKuweCpZb$sOwXHTXKAV
zY+Lw=42H-ztJg*hpcCRE{+3Y7q_F_F58#pXg{c9MGu^v-9gPAcw-KIzd1Bt&^kP*!
zHQs4L@id3OGY8nTOU7*XN~J@6)I@KQgR%6^Wipy)L*}^4SkVcL-8eGVht`@0l3WD^
zh04I$kMV|edjJ}0y>TBA|6r|<n>b)x?b2UozDL$^G{DtWjvMLb?q0HzbVJKSdouty
zSHOfpEM6bF(C1v~I}ww`Hn2RlH$;&uOt%iR8a#mQ!6coUgn1Mp%Oa0)brBXCV?3sT
zfgH7W5e4?3#p7Erf^Y58kTfIC{#O=aW<bkv9rFcc4Cw-c`-z!F53dSYh@<nKRi}CW
z{J9GXRWU4Z6b;__;AfDb`j|nk!~NqenctheKk5&ZqyX6I$J&SixTr9SzPm%Nd#$9_
z97Z(I{Vx0R`r2dLrUvlloy++MxvhJ1T%91-5|(~0Xc4B$+|rxhF$VE5AjNSc-pA21
ztrYy=8uan;_e!=N0rI<6D;+UQ<j%sv!j!FLP9Xclg1U&shm+i<B9f3X+??ZOKjy5H
zVf2?NaEVJ?7w6tYF-?I|$=$yxS2LXjLN35A;}}T*zjNOoS<OEQ`Y<TXOCORRx{#>9
z^eOg^AfZB|8~6pgK_-3NfInj3f1L=&7_d<{lL1exV%A`zqIMJjjt^F=Z5S_V;R2Vx
z_S)UwUxS;&2ap2lI?A*K;3(C+g#i$hRZLa6-+tY>%)StHKs$!hu(@*?@wKqz0m>Cw
z?1<yAJ|dc^zdU{@biTt7g^?br3NX)cl|Qh94mg%J9*EW%{Ub<bz2M~5Py`12w-`b6
zf}x?|LQ3zojcwcG^dRDnN>)$<14Q?U%^;1_WgV2G4RV1=jt-8^2Ks{7gwm7D2DTwX
z^R#k-Gg?9Z50bs&3wg}1EIy!IU0m8hzM@D2N@8<3^cGF(<I*s<k+G9CfNB6q$~YDD
z5~GblT+0N=>jk3O{UO?6pQI5dz<Y#Iz{=7x)Anf2CJ{+neZDmlvX*LsY6_l9nBiO~
zbW0bj+R`FS@%u`gg?Su6Bap?!`{w79fUT$#&UJMIGU7Wus0~sAx{z@KGF>cHHPF%V
zsCw@ZFdZNMhC{5PL{PsGR`CEr_w@9DET|jsZfNZYs2prC*rD%JlOG2%x}ldhPu53E
zk=xsUtE{Y4)78a->H!ES!22VkqhWk{bt<>U46r_(&}H9+gwoMbM<AdLcYgu}K@&Rz
zyQ>&}8LGrMEdjt?5~D-3R-Y)0HO&#FVZX3Jbn*qct+2QSFiDt@0&oNg0|;l1NjZh^
zYB$uWD;cOF-3Z}5ttMx*SA`7HhCVvXBP9VChOlC%5BSdnpbIDtAYWIV;VDnb3i$c}
zbEHD&AAyR*f-^dvMI|niaNhd2AE0g;f}-CLDEjTFYBTZiDQQj7&IGYeh^mR_guxhS
zqH~!l1}a*p*IkG4LFm6&+7K=K2{pR$^(sX4F6}!ctdO|6x?TVQJ&V1yO|X<MK)vQ6
z;P4)q^pKd67B`_mo7f4&CP2sl_?8O_VxaD(jfa3a17t+KO*wZ&$n<-9tieBkTFKEC
z0LBl21bq18Y2|53H5O<X7$5*X#bDdn{{AFDx1Q6<I5EBEHekgGfItIHE9~Afnrf4B
zR$7Q~Lm-z>pBkz(P7`zG9Ww^V>8s<3>Nfuo$gwds;a9-)gdhm2+gZX2BeD10HRVw5
z6dqJ8kGiI(JOKq334hvYc>(n4Zy?)y^yqs(e}B7H6A<M9<MtY=yf~AY`G-NbD1uRi
z`F^?ZHz>FY`7B5b+q8AG;*4FdUq400A@F_^JO0e~Z6;Y3dEBx%=39bQehcfGhw_0a
zvzB@(^yPW-#;?B$Kk*|-J6t?H6}jI^!)62ZK=I7thwsjVWENCpL5b136^(B?wha`(
zWWU=CROaUIUp@>GHKTC+X1P2!50A%GX2R9Ic5t}$QBj4-%u7_XAQTj%;(5KKV-Wvi
zknEema1Bt1>Z7XwrT6OZ?t1`;lW|Eb>*GC800V`}1}4Yd)6*2x#*)(0A<OrnW7%rD
z>X0}s_nj<@e77e;Dgb_?3;~ruz<_>hqjgPA<~un%gU47e=)>fMNqn|iEwD2h!6H4u
zcnDVzA~lw6;ka74=$Dm@MlLDitw90pTG11%7*^G^gb`seP{E`ZS5{6gVp=OQ06gpv
z*14LS&X~1DuGYQlrwK2w-n`k-^W)5F&^0;SnglZGJaDOy7n@hKMGO&DA6}SlQwA!@
zXVZTE`-2ZE*@>(b|F!<@;{U&WVJ+TL<kRePTmh(+8U}$Jd|v*g^WJ*}lB_x2q%vgQ
zc;dhLE88gBB1XDPttE0G(o|4=;kEeMJa28eQgPzFT;$rPFZXrce5nDXTRsffJouUT
zLQ}@)l=RLApnualHl<%Lc~!i~mg3O$S${{E%h_mrxp(ttx8`qewCmJbP}r$^u1Oo1
zBjb{56JFP<@?68)_|V#?|EWRs*FqYj6a&{d+ZQ@d^9R0vaO&Elv(n|Ls<tA--ZMwz
zIlX_I$)5|3YdQAoQ<A@#>o=><KYp>V=n&{9eD|fkQ<So>?^Fd^U$41Zm7CTke5+&|
zHZrAi^XjKt`G3vtf9SLoJ8Xq_xL9?#JpOyf?2joLg0iwLP=F_8+K2Id`S%f{P>nB5
z$x(INA(ygL%l&Juyz>|R8JltEWl#O14YxLEn!~xS6nwwelblO4`cczsH>?{z`qu3b
zMs2P0_4iKT|F957?;RVp{TJ2tXaBS1xB9HM?}6k+fdZ28+ylWsd%nAdiZ=bil;C~a
z-fp(@q&+^fCQGY03EejUqW{#+-`>#ncB#<{%EfbBMG0+V+w-i9HIbC=@$uY`vo8Ta
zNH>hk0-(#q<8461o?G(wkl4O9C>3#UwC<W1p@uuHJ48eyU?J66>{=X;%b`bVQe@pB
zYm&HiFb+QqngM$roKjO&J!DiFQeh*QgBYr5^kiM{R4~fVyVO-^zjc{TtjX@e)Jq$I
zE?JO(#~Gcyk$7zFNiUxfHsGkd>42of#E!XQa{-Tte(KzI6cUzBqDpnOq4{}V-+pWd
zgRw!oa-iRR?XIWmnl|7RMTpDORm|cDd%+ZuH(DNHAETzSvy;jjLdZ*UCO}Q2GK?3L
z$o;)9`M7X+wP*wuao9*OBO>MEnpZwP-f2<5{~*;9%@CI4Kp1ElTC?hP4=ra#b|WbS
zxh^%oC2!mrL%cz;d&#3mzZJr#Koex7(vKbw=#8|IjCtBoG*a`IGns!_;@_OBroQ^D
z^v>9<tzt?)Yj{Ck4y$XFhs`dbml6&+8jM5GC@YM4w7ajb6`Rd=40sNr<=<`wP_b$$
z)RDBSd*cmV_vmHcbaXr&qo!fK++n{j@z7fp#WjJv^4t(TV~pvF$-3^{MDIt+CC)p+
zGS0gs<CM1ls}EE&1KR#TmH2?g#gS-Jqvd4cQewd-J`K&cjhQb=@1w7cye@gKwfI)a
z8ppkK1i~^_iTk~~TMxvFIr|v>c<<UJ=O5ltxB#-%m@NCMqtV+Gj1kljv)`qD1NM3Y
zjzWPObs_}pg5nW0+eXvJZtcEX16z~=L0tuyAvw}p`j5Q;prWA6<|ObRJzBrsCx~7^
z1AGgJp{y)+?Y84Z;I^d@{V6ID5i`$9N9W(WcdDbKuI}eBKI<3h2~ZQATiOz~7YrzT
z4d*K2jtJ_+k+~opxqaN2xL7N5T4Dm!T``E2kGqz5av-!$F3yg`WVxv2yQobz!@q#p
zTngvlqq9eMKKP_)>lr*w;xdWCQjJwfNy)O5U_`SrsLYVKGI}90YGd5Fpu+{|{SF8!
zflo(Q=XGJyO=5%=JR&8~8hB7^Y@q0^@Fi2BLRZ5A-hKuoB+D~zMf`ZnenR&HCPJT|
zm{lb5L9watP}SPPZlzky*Oo;|85ABej2Z`B#{Ci!q{haFz_YX1rwc19bwD9~64+2Y
znE^OS>y-MJEFttyOZYs#c%eFi)}AzMzWu-70`V8{{U^eJ(DZ+2go(}!UNe_<T1_wd
z|3j|+8NC0u$knKSmzpATMzBH@H2qp{BQbEhHv6!Vg~Q49|LVffpz?3N4wDe~h?V9o
z)*EPOP^@P*<3{8542TdO)tB&Jx~hJON2Dn>DJTdx1x=QFn!65m5t|lv{H{JTl%C3w
z)h$TxC;j#R_cs7J){7EAOJ5xd{o;cUtpVvf4J1c<Ve<e8k6!@8aqYS<kW5f@`y%iD
z)isG_J+OUMXwk$)8OxZ3d8W6o;qMF5m5lz?D2C5x@_SxXhJt-k{l;3o(&=s3@Y=%#
zM`Ccn0sg<%AM5Ts5F=fk5}DWjafEImHiNBEdRm*kr$8qp%JcA6b@lw5It=(+Yh#1p
zOcSgL8U={tf)7u7I&;Rx#NhR7?6CZ*`|Bn;d$OH!yLh^)l<@3B2Q4NGZ+_r{R&TDs
zDWu!=kj_>mo)O5oJHn;XVx)PKnhB53<rsSf>Pc>2@W)nVUc7w^0XigIs>)EwefTn4
zhrRb&(@~a@+x?a~?-NjXj=!JmZjZrIl9hZ}&gf!(j`LXQPC?h@qdGTzi8=#zyQ@*=
zBKHl!Bp<gtAj{xP>EyAFyTRQgN<K9-?4qi2Q>ODOf5Sa0*Z@f<XJ&5lPw=BQOe8Yy
zh&5V@&Cpj8cWqH0Rnqe-!%x0S(+@>W-OI^wZgOKzFfZih{Unm6S91AfKWV7&w!QrZ
zCNe4KOuG3*e@n2jRr{l#479Yf#%`R~oYw0up;-diUaqBgK{c6BYnxy!MXM4)6wLM0
zDXaVJUL7eHC0Mw-4pj=?&6V@2xK^-{u82hKrqc=8qkD8kc-0`&qd<B0PMAj8!5=6D
zvC^EzM7z&RwYR^9PI|a^^x>oE_;h=@rQj)ckecs}=+2xxU6K3vmHzNrM`)Nve4heo
z!^)(Kr!^3NO_~`fXUNUflK1#jI@!O%)h+9gx_3+RFqylO(jK@vO`CJyOTg2o6BCok
z?;;W=-H;c}os;WiFbIy)s>C#2lno0vpTIa$Fp5U|Kz9HB^c+O%o|XNNkuPwtmW(3>
z*<F?M_mQP9N{<>n#1&4m6sQw#eK336+`8LuLn~LN3S#<sQ2RM@k6Vbh-7Kj9H&j+y
z{46;7%v?DUHGgY?Ic@2#m7CV85ot=0b(Ml++_Z}yfChY;UT|UIg7p-2sD3RkwR$2^
z<-(hvUxxhb>FGHTRzRj-aE3)pejRq$Qm#5M5e>~fhr<OV=t-W$VvRr*=o1TUUFd(l
ztV6WkWfbY9<Jp3MWtPXk_?mB5P>`*zNzAQS3issTGHT3T*98Hw#bjlVzJ#~d0s1|#
z&_-9@R)$x{7S)(FSQ$f{9qjC)klaw&?%1rM>Y<n{XNTCn+QMIbbqcCP(kGjf4M_uC
z8Sa|XV^cJ1G^P43J-vCU^yl#OmTG!{lpFO5Zrj`Q!R|h-cWgrKkKg;T;N31jUr~y0
zkL^ZW5~wb%_e0^y8&<U2P|B>G$;p;K3@6mnA4!vXx^px1f2)S3YLsxkU34F12bCtB
zm5*!W)i_E9hlHE}bF;Tk1*UP~6#^T#n12KVDkl@c5<4{H4|sqgV26hXyrgJlYbuh@
z-;>mJEp9GIq3+F_W%sO-5{CgM`%H2=wwbP49dD&qlizDGO@BIQ5O7Vs@Wu-x`_!qJ
za&)NE?jX<B=4KD>laXDJ$LF%U`+A-MLsIm*X_eB|w&|Y$4HE+yU5xLCH{tDID@plq
zoa~$>e>n*BlzM+8d1;Lv^-QV^6+G}VSR9$Slt`(-n_q|IPqCJKKfVuJ3V|EZF^-O+
z1OR*UV~^HPQb}@e-}Bxz_VwQ3PZ=n=1vx1p(Hn!Re6I_<)YZFbL-FUbed+vNL+BLr
z&z4RC9lK=q!h=KkxUHWC^;Z}bUeFi%L(PqKOhjZGrpG4z2Tn-i^81)(e_Va$LeCfh
zr!XI)rqPW(y!)|hQjk6yY<P>!Dl03s{)iQhp_dRdA1hUTD4h(OxkF|9g@w+GiAfs~
zS2$F6&#q^^b+p0950esV?CqBuqT8GV+{F)}I$?o`1)`W}0-Fd4J8Y!G8tb?tR?w!m
zAmGpY020qzWDNA7VzU<AP9W^7GQ?DUwk*1{TN{4#E7hQ>rA3-g&f)PsqFfa!acXS7
z5s%*kvu)<4d0I2*1-2ley&DQ$9$pbC=fRPsB)X~wF_#+Rf5~DAJ?)K1@9e>~yhrn|
zMlkCt%Y5x(Ax_-`Lm7MkTEtB;tbfs!^WHP<V2i9`;2sB?fcwjpx@u5WOvA*!efKhe
z=av0@cfZa{!-%G){rgJzSuX*aOij9x2Unf}8+&YqDKT_da(DOrz<{~A<&xbFW<0Vn
zJWW~*nWRsg_sKPq;w7Yyqxq9mR;6bP-7r~CJiQy-yR+dj@V_$rJyJ*i^Ie7uO~<aI
z>=4eu*w*UM6L6eiQTXZY(Pp3)nOCNr^_rrz;p;NT(DXZ|+xt%6u0YXiqfe=1125e_
zxqgef`tHkn2ac9#?Sk13E{s1Z2;6q^whdJ<WfpPNMvkSTs*7<aBkAvNSLbhCRG+<e
z#Q7`7vUj0_MCapNe~!C%&>2gJ^F=!L0y5w}7%zx3r8%E$lE9`U?gG1^NOwOtKdj&7
zwnIG+Uv)ARnre3$-Vs?9?VaTJ6_G-9GJ~W*vq5}OXXfhTrv`>_yx@(EL7v7-xHeGi
zSMSD2RogVvOWM<QS<3{$Vjh6a_fol#Np|1P9bQZQgqi8YXEhKA?b_tj^m#)VD}F8G
zxRqK4iaup!1CZ%?zku;7T@mjv?P@>4gVq|q%g|I$otMr(a81}_l)^&)p-`>o^kmWR
zv)G4jCGDS77l*ZH8-!$@nu|`~AIRyj<PCrNEvQO&{&lcHyBLD{zJfXONI5i^Thr4s
zXI?#^+m5xY-!VDPhX$?qUT(0Gr?qiE1RFdi(>vZp?Bmhmka1yt9~SBlIqXk<(piO}
z_AUe$7bO(U{_=QK(M$&R00#;5)W75Cg9Og>LV9A<!&S_KI;i_H;CPx%g!it)2jr|D
zT8ue*g<VL<)KqI9$gI4D$ZV5g2VN&I>M8gtgaEZ99!Xpr$wLN6?f?yzAj7ZF1^R)U
z(wK&<u+UkB0<Xo#jfc1a?&HIfQ{oI#0oT0P5Jl?gnY_yhv+Yhv(+N8(Mtta1fvzP`
zjEm51w`x|FbtBDIZhk0j=kzy@k!f`&Z6iWM?RXWcxVDCdJP(KimP~`yi)hdFr=Zw6
zuAVzUHg22tOhH=^(*BRqWwl?9tDVvnVG&E2=G0mzIv4d0><kK!)VlzJ<eS%LmI!bV
zW#)odTTLo&LIfWNOt-UvGJlh{=Py{dLb?*e=EtCZ0i~`sHuv|7PnN!%uXmrdwMWX0
zbaY*q5+BSyZ<*N-d#f#0s9%c4_1nDx+v5-jVk|FQ#{tC3wmKOSxvQcjz;UR~06F&f
zSeF{BP^|32*ye)$2!7Y)@g<iKzwQ=q!b|sGH>`xQIllQsjHODCpsJ+c^pHeBOxB~K
zZ%wP41-p;SfOc7x)7Y4gXqB|wqjPS7^A$U$B+i3~fu#<$USh;#Z8A@r7{5J~KfAPh
zhlZ2Ex89uN#DyL6#{FStx^~H|F<(`TfKXBto>E)btbZvKSKtvA>a>7+OvaFe241?%
z5)BG1SHBPL29j+im=PqSC%@+3N%xwVXZ`fg%%I1!#^2`5>C{dweOI1Q7%PH~QQmj&
zM<UT$E&?HMD3f#DYq|EKh5v`c<u9_9!Vfovg{Wuretc$k;-@l=`&*Qx)w(xXiEVyQ
z<Bg~%?`&Xap1BjbU3)8h3TL)GL|eRT?jieQ$JuYU!o?k<QW^zaW5yUV@y&>G`BJ07
z9G7fkx9dT-2BJdgfJe8k%>B7?8A~~PBI|6lVco+phDBeZ*g&-X@a~RgMwY4NF321t
zB<)=GZiH#B(r{avw}Q4V#_I*Qx-g53iN&=<;$n|`n!a8;D)6c`KX(J}MEd0?=d!OS
z<!pQV8<T`#cv_F|>I485(}UaP%Wr;Q1B=`)K=aUQ1f40!a2vF=b!2wDo$}R`L~mTl
z@uEvDIa^CKHJ(e!sS{mzCM*7U&%-`J+4aY+@4YvA;!Y{wH6g~hQq-men^|v>_feDp
zf>ocTC=?zIY>c#jM}8g6(k3_}O-~&1673IG!;SWYA`=fiwzmGbK`{8>`XmV>#=l8r
zwB`*k!f*-`?1@kAJ|nI%$<+0$=>yLEH1D4E__Aij^Jr^h*kuQkm=K&94O>uf0cH}|
z<n88ZT9?BYF_*9eZqU=|8fkV;PJ@_rN+ofK{F>qgR5Yi5Ny+E2QU0qiBMbS9l+zzH
z(-tnmV3sp?==}cX4m+c!fdc7RIS@S}_@mJB7r9t6^OJ|W`?vJL0i=tKO_kY!KHPXq
z@M(iEIndv<cM77PCd_N#O)7$&0?dY-IKlQtICB|9vbece>j6{Y*_w5MJbAa*P1_R>
z#ht0g07B{&?@Mhh7iIgF%f;DQerj@0N^T>j*#N>g8XAiWyIR<HBZ%Z=P41CDGp45E
z%1eTUixT!vlA|9cLO$%`eSDC$Up%WnDXDnDGzKIb!W_fd>;S3eH5`i4NDEdh_3XK$
z0g()o>P_r2aKw!WrC3tF5RHqyc;CQo^$5&){eV_Z{tt<@8S!IR8aOQnZmO`od*%{c
zjkZ+l9Ck0MwTU>Fao*u|n5^w$dBIUd+;zx3N{<K1QzQItWFMm6*?93?ZMY2;w=u%p
z|7dMj#{<Sea?#0PA1_$2-+Uw$S)J>|&Wj<nwx;mqf+bcZl1Od<ZB1+IE$D0VLa|(N
zp6b0ro}Vwx!4yE|r<{->bK&Q@tQ<m9gLJl{ciy@P@!9^o)HQU{5@up+8ricI&XFuc
zAG9}-wViR_7+h68gvRnzO;v-xpS?|){(6c%715;dQ1Pf&-@tfn^RkS5eC4{Uq$=L<
z1L-_$^~C~l(J>XVEh6fdAoBBm31L49u5lnfP*tj^A!oP4)vK>NP&Iy>unRtRM==Pb
znE<8AwPDb^8ta5Of^Vn$cn9&`ep4Rgx!`Ln1<IEufjmDIsCW~%v_29}=1Tp8Y+ek8
z?0oPJB-b9S1qs*;*yUoZ71(HAR1K0=z#-1Ym=SMg4g1{z2|;}{qpdG~srzMNIp_^{
z(*}D$N|m_FaEtzQFUtsuE|X<1h~FP&jVirhOw%s}7|s%hk$e^<SnXh!+MXR6lkfRM
z+K2&=O@vl)rHullc8HOho+QB$Gg~w?K27<^ab=7gc0oXJl7PODVJd^Hrm3nu5N(cG
znCI-~z096QjP2rA>hyan?MLKW$&Zff5uc=WOmXQES+EvYPtQnz$GzpWd3wu)0ke*l
z`9vs?;1POBhSF~(Xjrwrv%}V;G<!7U=zRZyaYe6<s#_}(6O}&sRSW*s|1gY(mvKP5
zWdFTK0o`UK#9Nb?XPV5sybLo>#jEy<ALOc^Bz84>0B%*fQl`FTgE+v8hGSU*Hu4dJ
zmj+Gm1X(5^zT<CMNP1syR{Y1C>OEv3{b{&v+=hYYS7nmsZlXDTQuAnDy1_+vpR)$M
z4v~4r(&Lzh$9BmlK?2#)RrKw4hCE*u7da-D;5#yXNWy?%esU8h7n^yp#D@ij&&8CO
z-n;4oLY#RT6p~j(*hvN{a2ft*QdeK$qoN1J3y_h8yD~c5o|_;c&n?i-n&^8Xxy_&{
zET58|ZjecXz`<_9{KE&Vzyv_zUxs`^?imqP(ObS8yvZM!;b}pAdTLi=V?IcZL0TO;
z%l5O8EU_gDK0eeLfZ<cRn&qAcNI^pjxRY7e;OW-r=}26gfQ#dw;7ILgnh$&!6bi2j
zGZbsBxj0jX;(XX8(T~?<hKYlQtY3K<IJFV^>p*a-(7o2Btg<znzVeLUJZO&i&SG<S
zOpCYQeyuNDPtC;Hn2AJf=>D+y0HR3(u|pTRBTu_KYe+mwFKE`=+NP!o6eFIa<q84c
zeA8L16t;&np&2C$BGYXfLwjLv&AnkOa?daVK2yBRqJ+*{J-BXBzhmkm%ty9L_C>rI
zeRd|dkcyHmdF5&i3l&I0B`kwYZ0}avpN0hPnFJ|y`{2r*H?NOKKwlar@Mj|9Z9Xoq
zG~$D}?=Gl!Zz`tVy)K^(kTytPeQNQJjgtV71a>W%?03bS2<}o>?*ZEbP$qi)P2iY>
zPFG@&zmJY45%jAt52v+j3k+~pgY>S+w(2D|YQDXO;W<#P@37SbR-*wiM0!*WlLkmi
zpz1`kgp`#YfGoGszxijg2j8k@+O#!6JY4h?e^yLz-MBN2Zyz;%_VDIS;w55dqH#w`
zOLsyRjqdNu$T_2~(e3J~SP-6_?TLO}7Sw!iSqCKkEp?)xn$$=Uw1E8DL@W0e(YoOi
zHY|Uo2IRho%ZnKx+u*@IH8IrjDNcLu*_|-W-}+5y(m6LLrJOQ#Iz2m7Dozzcx`IKZ
zkJe~VgK4Hf#p5MSRJV_{P0yrO+x%CkfHxa;QUycQ{nmIi#LRWj1CUxD){>Yv)!5@|
z$J|Gzm%dXG*e}%7N1&I)DS}f_bwh?g%HK;+G;={!K&OWS?4~*;Il*cLb2cpfrM7CE
zhwzztaG1~8R8PgEl(efwt34$7_9**ONwi&Bl&OnG`O~4$p}tJdb<f3hUfSfiPF4+w
zz&VAhws$lH5<T-~0X)??fp`&+xyO-Rhi<#gw-f~1nIzj?whJ4oTJ71scy&i?i=C--
z>Ey6s_}8R^<uB$d16J!hFE;$Wsl5R=G2sd}&3>UBlu7#q)GZ@U9Ym#n!aHEpjvUZe
zkNVf9G=)>OnpEok)h%Z9eh<=_vM-lB|JIbNN36uk83iu~XjlH;=D#HYD4DboS`dJC
zw;gKz?>8@4%<P8?<^?=+)$?zIe(%%C_oMj?X9HdQ&6BV9D87Ar?e~+Z{Q2E_Z%iy+
zi#L8BdFHUNpPBWg26g#aX%&c(n9}9Vo`cgqS@552kDmD_lU?msra7!Ns0pW6wX*Jy
z2DPW)^p_UBr(t!`y8hdLKVJIk>OIn#ztr$=pDXPv+JIYa;2D2uQlAx_f2p05O#WAW
zNmdu{yZ3!*|KEhG>;JQj?Cxh@5{Pn+Yb(rC^IX@_Kq*7c+G^L`h`(C)=&!v6|Mme{
ze~;G+`y=J|M|S=r>spKOe^^^l%Rp!p^o_=~B0_!67p8>sxOerNf^wffcZM`ZNqpF|
zCH#*@^4}HU^Jmd~E2X{z`up@#9Bn;6{kgZ`-#+OZ2MEW*GnwG$?~nLnCE5r7ASV9l
z4$&_nZI3dGzEsCoNWQxFC+yT;J41>c3<JTgt$(8A+PV)oB#jYB{%_S<?r?7U{=WTa
zo%23x@xP8l|J!?vgdK}#9l6gsWdFgaey0*qznnT)1l)aqFhuJ;<Z(!}DcIvnQ)+Y)
z7LY#k^^Ehse8JA3^-prNk!3^2OiPAC4-Bnk8tYzN`j6>LLQ9i<8rH4b^@H$x0sblG
z|G2?F$gR+>{!ej(uDKmj=#?V&?;DVgZy5O#gyKMdawR#P*J8%_egD|-=BWQS-#hSc
z!@~cQ3#tBynKmf_>x+|B2C>2y_P0%l0Bkq^9`}S_t1u(L2gsOu4{}oP6Z=fq4+|+T
z)_?QWgQnwI-zFY(i8<(c^-Q^=;kkDQ4t$7(--6$U-)Z$}_dDpDv{}k`pLW*Fxx`Y%
zM=_(%q+?^w8h!W8HTS14tdQeS+O67C0qWw%#gfm@q7J@zXP{t^c(ESwNyvuUFKk==
zHivQ9jjP{s;k$eN>V$L}qqY+!*+G-+%Cyg4a9FonnNxwadm)19I`DmYyN8!n`R5m<
zQBEp6yp~0(gspD08<*Af54S0^BXxcLa!)Qkih&h~IbQOrG>5gV2BLnfOWAn*>J~Sh
zhqqUGibU-zAs@UIb#3*VH;x-BuiC)VOh)f3EF6b{<LDEgzsgR7N%pvvjV-g&$|bID
zZ5g}g@UK@vOP|S}u`8%r?R4LYDt535yoeR<rT*uux?HZwyOI=iA$~N6Tgu)hoaoc)
zht?5Zs~aJoX6{}6a*+QBbmISC0v!#y6t5Vtm@c3*o5I6u%Tr%51~1244|F+e{`m_D
z14rEF7$dPpF}RRXg<3<rXHYnKr6qYlf5y<yZ%Aj_t^(|Q`0RyOWN9LEjy6qL50n$K
zXL}ts;X_vwk#;3aTbg-HijH4?zgrc4bw}xcX+D3rfn)tfc;uNwk!MbRK09-qqFb3=
zi8WT8jN_C}ZHC#}*>!&IZC&ok|7z{>d;V$a;L~5$?${(z!=7S3Hu7c^-Svd7e&0-Q
zRF`v`j8V-}Bu=cLoY}hvF6Hcd-6klgQdLzqp*DNeoa^g<&gR1PkmpI#6+zXBE%%~@
z{xV4P+)k*hs$$L4qV&3Jd{~-3V}rHQ4Gp{MRdrNS@O0)FBRmf<K&d$6Y)uS2Oy6j3
zNQ#g+IvTgBAARk4Qgv0msz$NGdS2)y7_4cqCH$OyMSO`^PH}npf>DYFc*Ltip0M?}
zwCTc-4-J_jWlXD){-N7qA~`sV25=zo$Ghu!;^n4Cw7qX2q6}`T8LUh|I#UvdmUaoZ
zeJ<|ybRRA&u8imCFNQXGnje6s7$eOKFIPQkilmE|x3y3QTQdy0z%o^|+S5VfEv5Qc
zT$2sXIV|kQIAik#vnbkw%=@Z(YQK>MjEE(^IMUg5sl+E)RyeQnjc{<D5yiaQrHGf%
zE``KV($oqmz4NMiDRHE-Zfd9jrVZYEW8h=90$GLhGK~z^d&I9X))y>htjuW^+>Zf+
ztV?yNm$ak0sKrQw!^E(#@~SF@V3~T=c51?CT-@b~phKEsqOgS>QaVox3lBy_G+nx6
zZ)zS8;BWq`<Bg|~2$Lr5fY~`HmwhovRa-v^3~y~i_I3!;(9Cfz*CS@UzWwVq5vQj_
zh>?mW@i#0v8QecK$MxTH+TT3NG4RF@VAGILonWVcBKm$yP(*~u(o~{Pa@ay=9M<(R
z(#iXIQp4<Ie6@f3XNEU00S8!oq#@4|GrjK?z-)I{*NGbafW=o7JprRDZ=O%fD~NLp
zTYAl8R#;4!F-fs9)A}<t7>tZel)<C4v}tL)S296$Cf_QERXbunR&+PmayO@@XfDX-
z2$fr}+4<7n;qB4^ZC^Udw(8zSO%E9SQbVxRioR5ee$@nLNL4vLRwfD=Na;xwfs9pe
zdO0^4h9>Hc(Zphk+`tK>{?37ipT#hW8Ry}%y{=_74(oB;n>Pe$2Pj0DNOw)3o%m<6
z#YoPnIzz*`X3KgNU4!%z8jM&wJ9E2Q`z12K>s*^t{!K-2S|I>eH;J7e>sCNC7G}IY
zs-!r|SjuZ|Zo%L&GWSIo4YqzZ`~{-mBA*i=xOy_co6$qMA_afa7&*}gO5j;UT+Gm}
z%sw#rUG?c_FGw>5UL)=9%;^V&pt)1Pk$~;CB>E&269_R6irgd(N+CR6+yeiWl(Myi
zSxj?tYv{Flq1^=To&sUgqA%#BPoN-eWyOYA;T$+m*+gtpKrF`|=+#ZcL`hWW&e&0P
z!Sus;1FB24I5a+kyHaBAOm4qYsOda6HozQYeaArvrbSQ_=IIR?yx=)194!ZY2t8QB
zoG78ON)Tbckw|6izL4qn89=X=OK*17doPQK6%&fR+c>;QIs^kuHlgrx6OsSP`I16Y
zRSPRYiPi+s!;d28Iw(AyQnb1Mc9FwIttnNdQxx78?C4T_S3yt2+`@NG)yPn;u4BxB
zV8-xCi5Z-Eb;^g=w^t^?T&0-E11Cbe5rl<nXAJN8RBOkgR}#`adi9lcVg$>hVixg^
zHC&!16Xn&D8j5iqo4bqV-|RuB+n>C<)NcbfjtLR8;8md|vkx)AN%%m26Vua;1}k0B
zD!Ksz<ZmlYWW+f?@(n(l8kV-zGO~&u>p)5g8a0t?QlVmbvMfza{Stb%LFf^nWYd@s
z&L*T23g!6LS+aZhIJ#zea_a=v${S$c$|q;yp#LtQqTvhP%Zw%I22J8D`x$AWM<j6h
z@#QC#o!+5A{`y81yH77K+nImeW?xCT+8Za$<(!i?N>cSvyl-z*{Nm-~F@{IX^=r@B
zCn>SlU0xW(j%4=XgFjBEXAhjre>7lYHB=OQ?WmDAJE&yzg@REl+$A)4>}~%1!Y5K}
zTQ<PP`R2=$%o=KsKA6cXsk?@g`{2pd6*o|hhaE5F$UdC+#iw<&wBl>z-LI1iezHPj
zYvQT{KQ6e<J|ZG{&f^OwN4ezf-N29L0JMMdG2B53Jz}d+UCrS?etUAgQOra%>RwO1
zXYhF_bO^<+h2&JaYn8AxS!2=EhDKw$=2>Ax^er}Y6K=4Y)xIQNMzBzHS4=Ac->C(~
z*Idi)Om3L%h*rcsFU+weqnDPPeXcOCgNBv&bmyoVhE`lk2;p3oGAK3J<v`kw3}Z}8
z*9;A==$5(vK<XMwC7Y$ae>Z-145{=f5<gi{@uD|=HCRX`gD0|$Y%6#_Ecu8j(WU|@
zp-)3O0LWia8o+_toP|tuTjWGye7dXS(!wz;XJHr%fO|@?GBgC%@yRFgfK*FMcr9Vp
zI<yNWE36{wZ<Wk*4h-EnttW5~@%VI`Q|)uQcN9y8?Wl^$s&vmCU1kgxj96peCNE$Q
zB_pe(hKB5gBlSU*<HKvS3A6rSB;D1K6#PAgNiJ%gE^6icE6KrPIfYqAo3@GU_yi`m
zY0{4x2Jf}&TP}YGB*WP61)T{J;4!h%Bcw;B2CT)5P*|G4iAEkG#X*QOmlw|c>UeXa
z=Y{*&!VTutpn>eqSxQ&6T|v)tl3NR#uIq0y(%IRG=}b<oN>rsOjgEidp*~cMEPXIX
zKdLJe7uP3~E`CbH7^H7az)|h1Sl0ESvAg=z)t)3)2oA_@-@ZVr-Bqs%onDHttkCj1
z%;ikCHqiJ@_wK)!f`<IS<#_1df-y6xcq~={N0^c6)74G`(UdUTqnliFdoC<!>gm7E
z?wPC|rIS3{He(#KT*U;Sbo@xYq0i(f&1bYf@^TfWxpC5NS-v_iYMb-5(xhi+`TXFr
zDsE`ttaln}(stvfWfqBSHujcfnFzCeKQnxM#}qXd@QTZX5Ov^8rFzo>9u3b55RAAd
z?!}I|qxly4gh1`4CI#@(i8?*I@?j<WfOeq31~sItuM-nmg_J0<m}o)N@IU6HrxGiE
z6R-qfi?3GUcF~~>#0=x?xjeSDjSZ^~#@1sm9YW2`zU_nRCk@dly}d8}4-s`)AMWue
zE3>*wB@q4CqRGMop^R5Uo;HQ>HuEq(R>)wI)2PjZA(TLDnpm1{TF0XgdZ_uCg6V#{
zRg4DM&w<V?tDy}(BXHG*MK<xHzF79NqfPO;A@l*NT<j;nJO_dfM&ALWY}+v}V<ak?
zpc3HoV?=}$+Q=S&*}eN4!6Cu;#EOdM7K7g8?+gv^sj6xHCS(@K*6S$LXhxfq5U5HR
z^L;F%7-ZN8{WNwe{Q+!0xk?$DEZ$WjQfltwq|uVNX~4OvUdX71Ur+U}C4g6C{)_zR
zv4nV_`u<3@{o6lVgOG&g0(%5zd6`(_fONh5{}G@4BNO~Q)AU$wU(Ty5Lk#f)XsxSl
z_Hx%Q1w!L)#dL2Gu-J9!<<ZIZp3Cud{#Y<?X>GqrEAUk>pS_r|lb%5)4pn<jD?j_p
z$}t#@5l637c*<`r4~=u|>v6vGd0IO$QD!F)r~opB+Lp!@KG^8A*{Q-4SMK~T<9loB

literal 0
HcmV?d00001

diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/ports.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/ports.html
new file mode 100644
index 00000000..cc1406b1
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/ports.html
@@ -0,0 +1,24 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>8.1&nbsp;Varieties of Ports</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.1&nbsp;</td><td><a href="ports.html" class="tocviewselflink" data-pltdoc="x">Varieties of Ports</a></td></tr><tr><td align="right">8.2&nbsp;</td><td><a href="default-ports.html" class="tocviewlink" data-pltdoc="x">Default Ports</a></td></tr><tr><td align="right">8.3&nbsp;</td><td><a href="read-write.html" class="tocviewlink" data-pltdoc="x">Reading and Writing Racket Data</a></td></tr><tr><td align="right">8.4&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Datatypes and Serialization</a></td></tr><tr><td align="right">8.5&nbsp;</td><td><a href="encodings.html" class="tocviewlink" data-pltdoc="x">Bytes, Characters, and Encodings</a></td></tr><tr><td align="right">8.6&nbsp;</td><td><a href="io-patterns.html" class="tocviewlink" data-pltdoc="x">I/<span class="mywbr"> &nbsp;</span>O Patterns</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="i_o.html" title="backward to &quot;8 Input and Output&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="i_o.html" title="up to &quot;8 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="default-ports.html" title="forward to &quot;8.2 Default Ports&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;ports&quot;">8.1<tt>&nbsp;</tt><a name="(part._ports)"></a>Varieties of Ports</h4><p>Various functions create various kinds of ports. Here are a few
+examples:</p><ul><li><p><span style="font-weight: bold">Files:</span> The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=file-ports.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._open-output-file%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">open-output-file</a></span> function opens a
+  file for writing, and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=file-ports.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._open-input-file%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">open-input-file</a></span> opens a file for
+  reading.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=file-ports.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._open-output-file%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">open-output-file</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"data"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-ops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._close-output-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">close-output-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=file-ports.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._open-input-file%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">open-input-file</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"data"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-line%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-line</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"hello"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-ops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._close-input-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">close-input-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p>If a file exists already, then <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=file-ports.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._open-output-file%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">open-output-file</a></span> raises an
+exception by default. Supply an option like <span class="RktPn">#:exists</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">truncate</span> or <span class="RktPn">#:exists</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">update</span> to re-write or update the
+file:</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=file-ports.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._open-output-file%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">open-output-file</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"data"</span><span class="hspace">&nbsp;</span><span class="RktPn">#:exists</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">truncate</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"howdy"</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-ops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._close-output-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">close-output-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p><p>Instead of having to match the open calls with close calls, most Racket
+programmers will use the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=file-ports.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._call-with-input-file%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">call-with-input-file</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=file-ports.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._call-with-output-file%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">call-with-output-file</a></span> functions which take a function to call to carry
+out the desired operation. This function gets as its only argument the port,
+which is automatically opened and closed for the operation.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=file-ports.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._call-with-output-file%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">call-with-output-file</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"data"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">#:exists</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">truncate</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">out</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=file-ports.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._call-with-input-file%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">call-with-input-file</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"data"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-line%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-line</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"hello"</span></p></td></tr></table></blockquote></div></p></li><li><p><span style="font-weight: bold">Strings:</span> The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stringport.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._open-output-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">open-output-string</a></span> function creates
+a port that accumulates data into a string, and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stringport.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._get-output-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">get-output-string</a></span>
+extracts the accumulated string. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stringport.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._open-input-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">open-input-string</a></span> function
+creates a port to read from a string.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stringport.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._open-output-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">open-output-string</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stringport.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._get-output-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">get-output-string</a></span><span class="hspace">&nbsp;</span><span class="RktSym">p</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"hello"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-line%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-line</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stringport.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._open-input-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">open-input-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"goodbye\nfarewell"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"goodbye"</span></p></td></tr></table></blockquote></div></p></li><li><p><span style="font-weight: bold">TCP Connections:</span> The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=tcp.html%23%2528def._%2528%2528lib._racket%252Ftcp..rkt%2529._tcp-connect%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">tcp-connect</a></span> function
+creates both an input port and an output port for the client side of
+a TCP communication. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=tcp.html%23%2528def._%2528%2528lib._racket%252Ftcp..rkt%2529._tcp-listen%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">tcp-listen</a></span> function creates a
+server, which accepts connections via <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=tcp.html%23%2528def._%2528%2528lib._racket%252Ftcp..rkt%2529._tcp-accept%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">tcp-accept</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">server</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=tcp.html%23%2528def._%2528%2528lib._racket%252Ftcp..rkt%2529._tcp-listen%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">tcp-listen</a></span><span class="hspace">&nbsp;</span><span class="RktVal">12345</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c-in</span><span class="hspace">&nbsp;</span><span class="RktSym">c-out</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=tcp.html%23%2528def._%2528%2528lib._racket%252Ftcp..rkt%2529._tcp-connect%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">tcp-connect</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"localhost"</span><span class="hspace">&nbsp;</span><span class="RktVal">12345</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s-in</span><span class="hspace">&nbsp;</span><span class="RktSym">s-out</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=tcp.html%23%2528def._%2528%2528lib._racket%252Ftcp..rkt%2529._tcp-accept%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">tcp-accept</a></span><span class="hspace">&nbsp;</span><span class="RktSym">server</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">c-out</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-ops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._close-output-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">close-output-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">c-out</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-line%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-line</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s-in</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"hello"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-line%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-line</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s-in</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;eof&gt;</span></p></td></tr></table></blockquote></div></p></li><li><p><span style="font-weight: bold">Process Pipes:</span> The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=subprocess.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._subprocess%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">subprocess</a></span> function runs a new
+process at the OS level and returns ports that correspond to the
+subprocess&rsquo;s stdin, stdout, and stderr. (The first three arguments
+can be certain kinds of existing ports to connect directly to the
+subprocess, instead of creating new ports.)</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">p</span><span class="hspace">&nbsp;</span><span class="RktSym">stdout</span><span class="hspace">&nbsp;</span><span class="RktSym">stdin</span><span class="hspace">&nbsp;</span><span class="RktSym">stderr</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=subprocess.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._subprocess%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">subprocess</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="hspace">&nbsp;</span><span class="RktVal">"/usr/bin/wc"</span><span class="hspace">&nbsp;</span><span class="RktVal">"-w"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a b c\n"</span><span class="hspace">&nbsp;</span><span class="RktSym">stdin</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-ops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._close-output-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">close-output-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stdin</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-line%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-line</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stdout</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">" </span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktRes">3"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-ops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._close-input-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">close-input-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stdout</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-ops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._close-input-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">close-input-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stderr</span><span class="RktPn">)</span></td></tr></table></blockquote></div></p></li><li><p><span style="font-weight: bold">Internal Pipes:</span> The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pipeports.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-pipe%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-pipe</a></span> function returns
+two ports that are ends of a pipe. This kind of pipe is internal to
+Racket, and not related to OS-level pipes for communicating between
+different processes.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">in</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pipeports.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-pipe%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-pipe</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"garbage"</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-ops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._close-output-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">close-output-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Byte_and_String_Input.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read-line%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read-line</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"garbage"</span></p></td></tr></table></blockquote></div></p></li></ul><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="i_o.html" title="backward to &quot;8 Input and Output&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="i_o.html" title="up to &quot;8 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="default-ports.html" title="forward to &quot;8.2 Default Ports&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/proc-macros.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/proc-macros.html
new file mode 100644
index 00000000..db893d6a
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/proc-macros.html
@@ -0,0 +1,7 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>16.2&nbsp;General Macro Transformers</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.1&nbsp;</td><td><a href="pattern-macros.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Macros</a></td></tr><tr><td align="right">16.2&nbsp;</td><td><a href="proc-macros.html" class="tocviewselflink" data-pltdoc="x">General Macro Transformers</a></td></tr><tr><td align="right">16.3&nbsp;</td><td><a href="macro-module.html" class="tocviewlink" data-pltdoc="x">Module Instantiations and Visits</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>16.2&nbsp;</td><td><a href="proc-macros.html" class="tocviewselflink" data-pltdoc="x">General Macro Transformers</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.2.1&nbsp;</td><td><a href="stx-obj.html" class="tocviewlink" data-pltdoc="x">Syntax Objects</a></td></tr><tr><td align="right">16.2.2&nbsp;</td><td><a href="macro-transformers.html" class="tocviewlink" data-pltdoc="x">Macro Transformer Procedures</a></td></tr><tr><td align="right">16.2.3&nbsp;</td><td><a href="syntax-case.html" class="tocviewlink" data-pltdoc="x">Mixing Patterns and Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">syntax-<wbr></wbr>case</span></span></a></td></tr><tr><td align="right">16.2.4&nbsp;</td><td><a href="with-syntax.html" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>syntax</span></span> and <span class="RktSym"><span class="RktValLink">generate-<wbr></wbr>temporaries</span></span></a></td></tr><tr><td align="right">16.2.5&nbsp;</td><td><a href="stx-phases.html" class="tocviewlink" data-pltdoc="x">Compile and Run-<wbr></wbr>Time Phases</a></td></tr><tr><td align="right">16.2.6&nbsp;</td><td><a href="phases.html" class="tocviewlink" data-pltdoc="x">General Phase Levels</a></td></tr><tr><td align="right">16.2.7&nbsp;</td><td><a href="stx-certs.html" class="tocviewlink" data-pltdoc="x">Tainted Syntax</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="pattern-macros.html" title="backward to &quot;16.1 Pattern-Based Macros&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="macros.html" title="up to &quot;16 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stx-obj.html" title="forward to &quot;16.2.1 Syntax Objects&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;proc-macros&quot;">16.2<tt>&nbsp;</tt><a name="(part._proc-macros)"></a>General Macro Transformers</h4><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span> form creates a <a name="(tech._transformer._binding)"></a><span style="font-style: italic">transformer
+binding</span> for an identifier, which is a binding that can be used at
+compile time while expanding expressions to be evaluated at run time.
+The compile-time value associated with a transformer binding can be
+anything; if it is a procedure of one argument, then the binding is
+used as a macro, and the procedure is the <a name="(tech._macro._transformer)"></a><span style="font-style: italic">macro transformer</span>.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stx-obj.html" class="toclink" data-pltdoc="x">16.2.1<span class="hspace">&nbsp;</span>Syntax Objects</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="macro-transformers.html" class="toclink" data-pltdoc="x">16.2.2<span class="hspace">&nbsp;</span>Macro Transformer Procedures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-case.html" class="toclink" data-pltdoc="x">16.2.3<span class="hspace">&nbsp;</span>Mixing Patterns and Expressions: <span class="RktSym"><span class="RktStxLink">syntax-case</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="with-syntax.html" class="toclink" data-pltdoc="x">16.2.4<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">with-syntax</span></span> and <span class="RktSym"><span class="RktValLink">generate-temporaries</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stx-phases.html" class="toclink" data-pltdoc="x">16.2.5<span class="hspace">&nbsp;</span>Compile and Run-Time Phases</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="phases.html" class="toclink" data-pltdoc="x">16.2.6<span class="hspace">&nbsp;</span>General Phase Levels</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="phases.html#%28part._.Phases_and_.Bindings%29" class="toclink" data-pltdoc="x">16.2.6.1<span class="hspace">&nbsp;</span>Phases and Bindings</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="phases.html#%28part._.Phases_and_.Modules%29" class="toclink" data-pltdoc="x">16.2.6.2<span class="hspace">&nbsp;</span>Phases and Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="stx-certs.html" class="toclink" data-pltdoc="x">16.2.7<span class="hspace">&nbsp;</span>Tainted Syntax</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="pattern-macros.html" title="backward to &quot;16.1 Pattern-Based Macros&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="macros.html" title="up to &quot;16 Macros&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stx-obj.html" title="forward to &quot;16.2.1 Syntax Objects&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/prompt.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/prompt.html
new file mode 100644
index 00000000..b80c5e12
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/prompt.html
@@ -0,0 +1,26 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>10.2&nbsp;Prompts and Aborts</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewselflink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">10.1&nbsp;</td><td><a href="exns.html" class="tocviewlink" data-pltdoc="x">Exceptions</a></td></tr><tr><td align="right">10.2&nbsp;</td><td><a href="prompt.html" class="tocviewselflink" data-pltdoc="x">Prompts and Aborts</a></td></tr><tr><td align="right">10.3&nbsp;</td><td><a href="conts.html" class="tocviewlink" data-pltdoc="x">Continuations</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="exns.html" title="backward to &quot;10.1 Exceptions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Exceptions and Control&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="conts.html" title="forward to &quot;10.3 Continuations&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;prompt&quot;">10.2<tt>&nbsp;</tt><a name="(part._prompt)"></a>Prompts and Aborts</h4><p>When an exception is raised, control escapes out of an arbitrary deep
+evaluation context to the point where the exception is caught&#8212;<wbr></wbr>or all
+the way out if the exception is never caught:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252F%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">/</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">/: division by zero</span></p></td></tr></table></blockquote><p>But if control escapes &ldquo;all the way out,&rdquo; why does the <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>
+keep going after an error is printed? You might think that it&rsquo;s
+because the <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> wraps every interaction in a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._with-handlers%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-handlers</a></span> form that catches all exceptions, but that&rsquo;s
+not quite the reason.</p><p>The actual reason is that the <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> wraps the interaction with a
+<a name="(tech._prompt)"></a><span style="font-style: italic">prompt</span>, which effectively marks the evaluation context with
+an escape point. If an exception is not caught, then information about
+the exception is printed, and then evaluation <a name="(tech._abort)"></a><span style="font-style: italic">aborts</span> to the
+nearest enclosing prompt. More precisely, each prompt has a
+<a name="(tech._prompt._tag)"></a><span style="font-style: italic">prompt tag</span>, and there is a designated <a name="(tech._default._prompt._tag)"></a><span style="font-style: italic">default
+prompt tag</span> that the uncaught-exception handler uses to <a href="prompt.html#%28tech._abort%29" class="techoutside" data-pltdoc="x"><span class="techinside">abort</span></a>.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=cont.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._call-with-continuation-prompt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">call-with-continuation-prompt</a></span> function installs a prompt
+with a given <a href="prompt.html#%28tech._prompt._tag%29" class="techoutside" data-pltdoc="x"><span class="techinside">prompt tag</span></a>, and then it evaluates a given thunk
+under the prompt. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=cont.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._default-continuation-prompt-tag%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">default-continuation-prompt-tag</a></span>
+function returns the <a href="prompt.html#%28tech._default._prompt._tag%29" class="techoutside" data-pltdoc="x"><span class="techinside">default prompt tag</span></a>. The
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=cont.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._abort-current-continuation%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">abort-current-continuation</a></span> function escapes to the nearest
+enclosing prompt that has a given <a href="prompt.html#%28tech._prompt._tag%29" class="techoutside" data-pltdoc="x"><span class="techinside">prompt tag</span></a>.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">escape</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=cont.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._abort-current-continuation%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">abort-current-continuation</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=cont.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._default-continuation-prompt-tag%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">default-continuation-prompt-tag</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">escape</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=cont.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._call-with-continuation-prompt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">call-with-continuation-prompt</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">escape</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=cont.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._default-continuation-prompt-tag%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">default-continuation-prompt-tag</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></blockquote><p>In <span class="RktSym">escape</span> above, the value <span class="RktSym">v</span> is wrapped in a
+procedure that is called after escaping to the enclosing prompt.</p><p><a href="prompt.html#%28tech._prompt%29" class="techoutside" data-pltdoc="x"><span class="techinside">Prompts</span></a> and <a href="prompt.html#%28tech._abort%29" class="techoutside" data-pltdoc="x"><span class="techinside">aborts</span></a> look very much like exception
+handling and raising. Indeed, prompts and aborts are essentially a
+more primitive form of exceptions, and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._with-handlers%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-handlers</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._raise%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise</a></span> are implemented in terms of prompts and aborts. The
+power of the more primitive forms is related to the word
+&ldquo;continuation&rdquo; in the operator names, as we discuss in the next
+section.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="exns.html" title="backward to &quot;10.1 Exceptions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="control.html" title="up to &quot;10 Exceptions and Control&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="conts.html" title="forward to &quot;10.3 Continuations&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/protect-out.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/protect-out.html
new file mode 100644
index 00000000..e0ecbe4c
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/protect-out.html
@@ -0,0 +1,19 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>6.8&nbsp;Protected Exports</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewselflink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">6.1&nbsp;</td><td><a href="module-basics.html" class="tocviewlink" data-pltdoc="x">Module Basics</a></td></tr><tr><td align="right">6.2&nbsp;</td><td><a href="Module_Syntax.html" class="tocviewlink" data-pltdoc="x">Module Syntax</a></td></tr><tr><td align="right">6.3&nbsp;</td><td><a href="module-paths.html" class="tocviewlink" data-pltdoc="x">Module Paths</a></td></tr><tr><td align="right">6.4&nbsp;</td><td><a href="module-require.html" class="tocviewlink" data-pltdoc="x">Imports:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">require</span></span></a></td></tr><tr><td align="right">6.5&nbsp;</td><td><a href="module-provide.html" class="tocviewlink" data-pltdoc="x">Exports:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">provide</span></span></a></td></tr><tr><td align="right">6.6&nbsp;</td><td><a href="module-set.html" class="tocviewlink" data-pltdoc="x">Assignment and Redefinition</a></td></tr><tr><td align="right">6.7&nbsp;</td><td><a href="module-macro.html" class="tocviewlink" data-pltdoc="x">Modules and Macros</a></td></tr><tr><td align="right">6.8&nbsp;</td><td><a href="protect-out.html" class="tocviewselflink" data-pltdoc="x">Protected Exports</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="module-macro.html" title="backward to &quot;6.7 Modules and Macros&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="modules.html" title="up to &quot;6 Modules&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contracts.html" title="forward to &quot;7 Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;protect-out&quot;">6.8<tt>&nbsp;</tt><a name="(part._protect-out)"></a>Protected Exports</h4><p>Sometimes, a module needs to export bindings to other modules that are
+at the same trust level as the exporting module, while at the same
+time preventing access from untrusted modules. Such exports should use
+the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._protect-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">protect-out</a></span> form in <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span>. For example,
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=foreign&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">ffi/unsafe</span></a> exports all of its unsafe bindings as
+<a name="(tech._protected)"></a><span style="font-style: italic">protected</span> in this sense.</p><p>Levels of trust are implemented with <a href="code-inspectors_protect.html#%28tech._code._inspector%29" class="techoutside" data-pltdoc="x"><span class="techinside">code inspectors</span></a> (see
+<a href="code-inspectors_protect.html" data-pltdoc="x">Code Inspectors for Trusted and Untrusted Code</a>).
+Only modules loaded with an equally strong code inspector as an
+exporting module can use protected bindings from the exporting module.
+Operations like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Module_Names_and_Loading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._dynamic-require%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">dynamic-require</a></span> are granted access depending
+on the current code inspector as determined by
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=modprotect.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-code-inspector%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-code-inspector</a></span>.</p><p>When a module re-exports a protected binding, it does not need to use
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._protect-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">protect-out</a></span> again. Access is always determined by the code
+inspector of the module that originally defines a protected binding.
+When using a protected binding within a module, take care to either
+provide new bindings from the module with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._protect-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">protect-out</a></span> or
+ensure that no provided bindings expose functionality that was meant
+to be protected in the first place.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="module-macro.html" title="backward to &quot;6.7 Modules and Macros&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="modules.html" title="up to &quot;6 Modules&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="contracts.html" title="forward to &quot;7 Contracts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/qq.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/qq.html
new file mode 100644
index 00000000..f1312b5c
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/qq.html
@@ -0,0 +1,21 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.11&nbsp;Quasiquoting: quasiquote and lsquo</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewselflink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="syntax-notation.html" class="tocviewlink" data-pltdoc="x">Notation</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="binding.html" class="tocviewlink" data-pltdoc="x">Identifiers and Binding</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Function Calls</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Functions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span></a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span></a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="conditionals.html" class="tocviewlink" data-pltdoc="x">Conditionals</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span></a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktVal">&rsquo;</span></a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="qq.html" class="tocviewselflink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span> and <span class="RktVal">&lsquo;</span></a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Simple Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="parameterize.html" class="tocviewlink" data-pltdoc="x">Dynamic Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">parameterize</span></span></a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="quote.html" title="backward to &quot;4.10 Quoting: quote and '&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="case.html" title="forward to &quot;4.12 Simple Dispatch: case&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;qq&quot;">4.11<tt>&nbsp;</tt><a name="(part._qq)"></a>Quasiquoting: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span> and <span class="RktVal">&lsquo;</span></h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html&amp;version=8.6" class="Sq" data-pltdoc="x">Quasiquoting: <span class="RktSym"><span class="RktStxLink">quasiquote</span></span>, <span class="RktSym"><span class="RktStxLink">unquote</span></span>, and <span class="RktSym"><span class="RktStxLink">unquote-splicing</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> also documents <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span>.</p></blockquote></blockquote></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span> form is similar to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span>:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span><span class="hspace">&nbsp;</span><span class="RktVar">datum</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>However, for each <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span><span class="stt"> </span><span class="RktVar">expr</span><span class="RktPn">)</span>
+that appears within the <span class="RktVar">datum</span>, the <span class="RktVar">expr</span> is
+evaluated to produce a value that takes the place of the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span> sub-form.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3 4)</span></p></td></tr></table></blockquote></div></p><p>This form can be used to write functions that build lists according to
+certain patterns.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">deep</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">deep</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">deep</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(8 (7 (6 (5 (4 (3 (2 (1 0))))))))</span></p></td></tr></table></blockquote></div></p><p>Or even to cheaply construct expressions programmatically. (Of course, 9 times out of 10,
+you should be using a <a href="macros.html" data-pltdoc="x">macro</a> to do this
+(the 10th time being when you&rsquo;re working through
+a textbook like <a href="https://www.cs.brown.edu/~sk/Publications/Books/ProgLangs/">PLAI</a>).)</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">build-exp</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">add-lets</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-sum</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">add-lets</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">body</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._zero%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">zero?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">body</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n-&gt;var</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">add-lets</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">body</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-sum</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n-&gt;var</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n-&gt;var</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-sum</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n-&gt;var</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-%7E3esymbol%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-&gt;symbol</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._format%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x~a"</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">build-exp</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(let ((x3 3)) (let ((x2 2)) (let ((x1 1)) (+ x3 (+ x2 x1)))))</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote-splicing%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote-splicing</a></span> form is similar to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span>, but
+its <span class="RktVar">expr</span> must produce a list, and the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote-splicing%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote-splicing</a></span> form must appear in a context that produces
+either a list or a vector. As the name suggests, the resulting list
+is spliced into the context of its use.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote-splicing%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote-splicing</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3 4 5)</span></p></td></tr></table></blockquote></div></p><p>Using splicing we can revise the construction of our example expressions above
+to have just a single <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> expression and a single <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span> expression.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">build-exp</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">add-lets</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktSym">n</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote-splicing%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote-splicing</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._build-list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">build-list</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">n</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n-&gt;var</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">add-lets</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">body</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Flist..rkt%2529._build-list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">build-list</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">n</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7Ece%7Ebb%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">&#955;</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n-&gt;var</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span><span class="hspace">&nbsp;</span><span class="RktSym">body</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">n-&gt;var</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-%7E3esymbol%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-&gt;symbol</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._format%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">format</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"x~a"</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">build-exp</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(let ((x1 1) (x2 2) (x3 3)) (+ x1 x2 x3))</span></p></td></tr></table></blockquote></div></p><p>If a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span> form appears within an enclosing
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span> form, then the inner <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span>
+effectively cancels one layer of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote-splicing%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote-splicing</a></span> forms, so that a second <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span>
+or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote-splicing%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote-splicing</a></span> is needed.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 (quasiquote (unquote (+ 1 2))))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 (quasiquote (unquote 3)))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 (quasiquote ((unquote (+ 1 2)) (unquote 4))))</span></p></td></tr></table></blockquote></div></p><p>The evaluations above will not actually print as shown. Instead, the
+shorthand form of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._quasiquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quasiquote</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote</a></span> will be
+used: <span class="RktInBG"><span class="hspace"></span><span class="RktIn">`</span><span class="hspace"></span></span> (i.e., a backquote) and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">,</span><span class="hspace"></span></span> (i.e., a comma).
+The same shorthands can be used in expressions:</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">,</span><span class="RktVal">(</span><span class="RktVal">+</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">,</span><span class="RktRdr">,</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktVal">)</span><span class="RktVal">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 `(,(+ 1 2) ,4))</span></p></td></tr></table></blockquote></div></p><p>The shorthand form of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quasiquote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._unquote-splicing%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unquote-splicing</a></span> is <span class="RktInBG"><span class="hspace"></span><span class="RktIn">,@</span><span class="hspace"></span></span>:</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktVal">`</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktRdr">,@</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktVal">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3 4)</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="quote.html" title="backward to &quot;4.10 Quoting: quote and '&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="case.html" title="forward to &quot;4.12 Simple Dispatch: case&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/quote.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/quote.html
new file mode 100644
index 00000000..36f27dea
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/quote.html
@@ -0,0 +1,18 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.10&nbsp;Quoting: quote and '</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewselflink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="syntax-notation.html" class="tocviewlink" data-pltdoc="x">Notation</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="binding.html" class="tocviewlink" data-pltdoc="x">Identifiers and Binding</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Function Calls</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Functions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span></a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span></a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="conditionals.html" class="tocviewlink" data-pltdoc="x">Conditionals</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span></a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="quote.html" class="tocviewselflink" data-pltdoc="x">Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktVal">&rsquo;</span></a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="qq.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span> and <span class="RktVal">&lsquo;</span></a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Simple Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="parameterize.html" class="tocviewlink" data-pltdoc="x">Dynamic Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">parameterize</span></span></a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="set_.html" title="backward to &quot;4.9 Assignment: set!&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="qq.html" title="forward to &quot;4.11 Quasiquoting: quasiquote and lsquo&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;quote&quot;">4.10<tt>&nbsp;</tt><a name="(part._quote)"></a>Quoting: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span> and <span class="RktVal">&rsquo;</span></h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html&amp;version=8.6" class="Sq" data-pltdoc="x">Literals: <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktSym"><span class="RktStxLink">#%datum</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> also documents <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span>.</p></blockquote></blockquote></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span> form produces a constant:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktKw">quote</span><span class="hspace">&nbsp;</span><span class="RktVar">datum</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>The syntax of a <span class="RktSym">datum</span> is technically specified as anything
+that the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span> function parses as a single element. The value
+of the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span> form is the same value that <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span> would
+produce given <span class="RktVar">datum</span>.</p><p>The <span class="RktVar">datum</span> can be a symbol, a boolean, a number, a (character
+or byte) string, a character, a keyword, an empty list, a pair (or
+list) containing more such values, a vector containing more such
+values, a hash table containing more such values, or a box containing
+another such value.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktKw">quote</span><span class="hspace">&nbsp;</span><span class="RktSym">apple</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'apple</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktKw">quote</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktKw">quote</span><span class="hspace">&nbsp;</span><span class="RktVal">42</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">42</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktKw">quote</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"hello"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktKw">quote</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'()</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktKw">quote</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">"z"</span><span class="hspace">&nbsp;</span><span class="RktVal">x</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktSym">the-end</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((1 2 3) #("z" x) . the-end)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktKw">quote</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktPn">.</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3)</span></p></td></tr></table></blockquote></div></p><p>As the last example above shows, the <span class="RktVar">datum</span> does not have to
+match the normalized printed form of a value. A <span class="RktVar">datum</span> cannot
+be a printed representation that starts with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#&lt;</span><span class="hspace"></span></span>, so it
+cannot be <a href="void_undefined.html" class="RktModLink" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>, <a href="void_undefined.html" class="RktModLink" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;undefined&gt;</span></span></a>, or a procedure.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span> form is rarely used for a <span class="RktVar">datum</span> that is a
+boolean, number, or string by itself, since the printed forms of those
+values can already be used as constants. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span> form is
+more typically used for symbols and lists, which have other meanings
+(identifiers, function calls, etc.) when not quoted.</p><p>An expression</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktVal">'</span><span class="RktVar">datum</span></td></tr></table></blockquote></blockquote><p>is a shorthand for</p><blockquote class="SCodeFlow"><p><span class="RktPn">(</span><span class="RktKw">quote</span><span class="hspace">&nbsp;</span><span class="RktVar">datum</span><span class="RktPn">)</span></p></blockquote><p>and this shorthand is almost always used instead of
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span>. The shorthand applies even within the <span class="RktVar">datum</span>,
+so it can produce a list containing <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528part._parse-quote%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Reading Quotes</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on the <span class="RktVal">'</span> shorthand.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktVal">'</span><span class="RktVal">apple</span></td></tr><tr><td><p><span class="RktRes">'apple</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">'</span><span class="RktVal">"hello"</span></td></tr><tr><td><p><span class="RktRes">"hello"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span></td></tr><tr><td><p><span class="RktRes">'(1 2 3)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">you</span><span class="hspace">&nbsp;</span><span class="RktVal">can</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">me</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">(you can (quote me))</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="set_.html" title="backward to &quot;4.9 Assignment: set!&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="qq.html" title="forward to &quot;4.11 Quasiquoting: quasiquote and lsquo&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/racket.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/racket.html
new file mode 100644
index 00000000..327cfc2b
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/racket.html
@@ -0,0 +1,63 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>21.1&nbsp;Running racket and gracket</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewselflink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">21.1&nbsp;</td><td><a href="racket.html" class="tocviewselflink" data-pltdoc="x">Running <span class="stt">racket</span> and <span class="stt">gracket</span></a></td></tr><tr><td align="right">21.2&nbsp;</td><td><a href="scripts.html" class="tocviewlink" data-pltdoc="x">Scripts</a></td></tr><tr><td align="right">21.3&nbsp;</td><td><a href="exe.html" class="tocviewlink" data-pltdoc="x">Creating Stand-<wbr></wbr>Alone Executables</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>21.1&nbsp;</td><td><a href="racket.html" class="tocviewselflink" data-pltdoc="x">Running <span class="stt">racket</span> and <span class="stt">gracket</span></a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">21.1.1&nbsp;</td><td><a href="racket.html#%28part._start-interactive-mode%29" class="tocviewlink" data-pltdoc="x">Interactive Mode</a></td></tr><tr><td align="right">21.1.2&nbsp;</td><td><a href="racket.html#%28part._start-module-mode%29" class="tocviewlink" data-pltdoc="x">Module Mode</a></td></tr><tr><td align="right">21.1.3&nbsp;</td><td><a href="racket.html#%28part._start-load-mode%29" class="tocviewlink" data-pltdoc="x">Load Mode</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">21.1.1<tt>&nbsp;</tt></span><a href="racket.html#%28part._start-interactive-mode%29" class="tocsubseclink" data-pltdoc="x">Interactive Mode</a></td></tr><tr><td><span class="tocsublinknumber">21.1.2<tt>&nbsp;</tt></span><a href="racket.html#%28part._start-module-mode%29" class="tocsubseclink" data-pltdoc="x">Module Mode</a></td></tr><tr><td><span class="tocsublinknumber">21.1.3<tt>&nbsp;</tt></span><a href="racket.html#%28part._start-load-mode%29" class="tocsubseclink" data-pltdoc="x">Load Mode</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="running.html" title="backward to &quot;21 Running and Creating Executables&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;21 Running and Creating Executables&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="scripts.html" title="forward to &quot;21.2 Scripts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;racket&quot;">21.1<tt>&nbsp;</tt><a name="(part._racket)"></a>Running <span class="stt">racket</span> and <span class="stt">gracket</span></h4><p>The <span class="stt">gracket</span> executable is the same as <span class="stt">racket</span>, but with
+small adjustments to behave as a GUI application rather than a console
+application. For example, <span class="stt">gracket</span> by default runs in
+interactive mode with a GUI window instead of a console prompt. GUI
+applications can be run with plain <span class="stt">racket</span>, however.</p><p>Depending on command-line arguments, <span class="stt">racket</span> or <span class="stt">gracket</span>
+runs in <a href="racket.html#%28part._start-interactive-mode%29" data-pltdoc="x">interactive mode</a>,
+<a href="racket.html#%28part._start-module-mode%29" data-pltdoc="x">module mode</a>, or
+<a href="racket.html#%28part._start-load-mode%29" data-pltdoc="x">load mode</a>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;start-interactive-mode&quot;">21.1.1<tt>&nbsp;</tt><a name="(part._start-interactive-mode)"></a>Interactive Mode</h5><p>When <span class="stt">racket</span> is run with no command-line arguments (other than
+configuration options, like <span class="nobreak"><span class="stt">-j</span></span>), then it starts a <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>
+with a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">&gt;</span><span class="hspace">&nbsp;</span></span> prompt:</p><p><table cellspacing="0" cellpadding="0" class="SVerbatim"><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">Welcome to Racket v8.6 [cs].</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">&gt;</span></p></td></tr></table></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>For enhancing your <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> experience, see
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=xrepl&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">xrepl</span></a>; for information on GNU Readline support, see
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=readline&amp;rel=index.html%23%2528mod-path._readline%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">readline</span></a>.</p></blockquote></blockquote></blockquote><p>To initialize the <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>&rsquo;s environment, <span class="stt">racket</span> first
+requires the <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=running-sa.html%23%2528mod-path._racket%252Finit%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/init</span></a> module, which provides all of
+<span class="RktSym">racket</span>, and also installs <span class="RktSym">pretty-print</span> for display
+results. Finally, <span class="stt">racket</span> loads the file reported by
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Filesystem.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._find-system-path%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">init-file</span><span class="RktPn">)</span>, if it exists, before starting
+the <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>.</p><p>If any command-line arguments are provided (other than configuration
+options), add <span class="nobreak"><span class="stt">-i</span></span> or <span class="nobreak"><span class="stt">--repl</span></span> to re-enable the
+<a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>. For example,</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">racket -e '(display "hi\n")' -i</span></p><p>displays &ldquo;hi&rdquo; on start-up, but still presents a <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>.</p><p>If module-requiring flags appear before <span class="nobreak"><span class="stt">-i</span></span>/<span class="nobreak"><span class="stt">--repl</span></span>, they
+cancel the automatic requiring of <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=running-sa.html%23%2528mod-path._racket%252Finit%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/init</span></a>. This
+behavior can be used to initialize the <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>&rsquo;s environment with
+a different language. For example,</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">racket -l racket/base -i</span></p><p>starts a <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> using a much smaller initial language (that loads
+much faster). Beware that most modules do not provide the basic syntax
+of Racket, including function-call syntax and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span>. For
+example,</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">racket -l racket/date -i</span></p><p>produces a <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> that fails for every expression, because
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528mod-path._racket%252Fdate%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/date</span></a> provides only a few functions, and not the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=__top-interaction.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7E23%7E25top-interaction%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%top-interaction</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=application.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._%7E23%7E25app%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#%app</a></span> bindings that are needed
+to evaluate top-level function calls in the <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>.</p><p>If a module-requiring flag appears after <span class="nobreak"><span class="stt">-i</span></span>/<span class="nobreak"><span class="stt">--repl</span></span> instead
+of before it, then the module is required after
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=running-sa.html%23%2528mod-path._racket%252Finit%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/init</span></a> to augment the initial environment. For
+example,</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">racket -i -l racket/date</span></p><p>starts a useful <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> with <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=time.html%23%2528mod-path._racket%252Fdate%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/date</span></a> available
+in addition to the exports of <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;start-module-mode&quot;">21.1.2<tt>&nbsp;</tt><a name="(part._start-module-mode)"></a>Module Mode</h5><p>If a file argument is supplied to <span class="stt">racket</span> before any
+command-line switch (other than configuration options), then the file
+is required as a module, and (unless <span class="nobreak"><span class="stt">-i</span></span>/<span class="nobreak"><span class="stt">--repl</span></span> is
+specified), no <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> is started. For example,</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">racket hello.rkt</span></p><p>requires the <span class="stt">"hello.rkt"</span> module and then exits. Any argument
+after the file name, flag or otherwise, is preserved as a command-line
+argument for use by the required module via
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=runtime.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-command-line-arguments%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-command-line-arguments</a></span>.</p><p>If command-line flags are used, then the <span class="nobreak"><span class="stt">-u</span></span> or
+<span class="nobreak"><span class="stt">--require-script</span></span> flag can be used to explicitly require a file
+as a module.  The <span class="nobreak"><span class="stt">-t</span></span> or <span class="nobreak"><span class="stt">--require</span></span> flag is similar, except
+that additional command-line flags are processed by <span class="stt">racket</span>,
+instead of preserved for the required module. For example,</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">racket -t hello.rkt -t goodbye.rkt</span></p><p>requires the <span class="stt">"hello.rkt"</span> module, then requires the
+<span class="stt">"goodbye.rkt"</span> module, and then exits.</p><p>The <span class="nobreak"><span class="stt">-l</span></span> or <span class="nobreak"><span class="stt">--lib</span></span> flag is similar to
+<span class="nobreak"><span class="stt">-t</span></span>/<span class="nobreak"><span class="stt">--require</span></span>, but it requires a module using a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lib%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lib</a></span> module path instead of a file path. For example,</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">racket -l raco</span></p><p>is the same as running the <span class="stt">raco</span> executable with no arguments,
+since the <span class="RktSym">raco</span> module is the executable&rsquo;s main module.</p><p>Note that if you wanted to pass command-line flags to
+<span class="RktSym">raco</span> above, you would need to protect the flags with a
+<span class="nobreak"><span class="stt">--</span></span>, so that <span class="stt">racket</span> doesn&rsquo;t try to parse them itself:</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">racket -l raco -- --help</span></p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;start-load-mode&quot;">21.1.3<tt>&nbsp;</tt><a name="(part._start-load-mode)"></a>Load Mode</h5><p>The <span class="nobreak"><span class="stt">-f</span></span> or <span class="nobreak"><span class="stt">--load</span></span> flag supports <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._load%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">load</a></span>ing top-level
+expressions in a file directly, as opposed to expressions within a
+module file. This evaluation is like starting a <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> and typing
+the expressions directly, except that the results are not printed.
+For example,</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">racket -f hi.rkts</span></p><p><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._load%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">load</a></span>s <span class="stt">"hi.rkts"</span> and exits. Note that load mode is
+generally a bad idea, for the reasons explained in
+<a href="intro.html#%28part._use-module%29" data-pltdoc="x">A Note to Readers with Lisp/Scheme Experience</a>; using module mode is typically better.</p><p>The <span class="nobreak"><span class="stt">-e</span></span> or <span class="nobreak"><span class="stt">--eval</span></span> flag accepts an expression to evaluate
+directly. Unlike file loading, the result of the expression is
+printed, as in a <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a>. For example,</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">racket -e '(current-seconds)'</span></p><p>prints the number of seconds since January 1, 1970.</p><p>For file loading and expression evaluation, the top-level environment
+is created in the same way for
+<a href="racket.html#%28part._start-interactive-mode%29" data-pltdoc="x">interactive mode</a>:
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=running-sa.html%23%2528mod-path._racket%252Finit%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/init</span></a> is required unless another module is
+specified first. For example,</p><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">racket -l racket/base -e '(current-seconds)'</span></p><p>likely runs faster, because it initializes the environment for
+evaluation using the smaller <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a> language,
+instead of <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=running-sa.html%23%2528mod-path._racket%252Finit%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/init</span></a>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="running.html" title="backward to &quot;21 Running and Creating Executables&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;21 Running and Creating Executables&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="scripts.html" title="forward to &quot;21.2 Scripts&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/read-write.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/read-write.html
new file mode 100644
index 00000000..5d1cba6c
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/read-write.html
@@ -0,0 +1,18 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>8.3&nbsp;Reading and Writing Racket Data</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Varieties of Ports</a></td></tr><tr><td align="right">8.2&nbsp;</td><td><a href="default-ports.html" class="tocviewlink" data-pltdoc="x">Default Ports</a></td></tr><tr><td align="right">8.3&nbsp;</td><td><a href="read-write.html" class="tocviewselflink" data-pltdoc="x">Reading and Writing Racket Data</a></td></tr><tr><td align="right">8.4&nbsp;</td><td><a href="serialization.html" class="tocviewlink" data-pltdoc="x">Datatypes and Serialization</a></td></tr><tr><td align="right">8.5&nbsp;</td><td><a href="encodings.html" class="tocviewlink" data-pltdoc="x">Bytes, Characters, and Encodings</a></td></tr><tr><td align="right">8.6&nbsp;</td><td><a href="io-patterns.html" class="tocviewlink" data-pltdoc="x">I/<span class="mywbr"> &nbsp;</span>O Patterns</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="default-ports.html" title="backward to &quot;8.2 Default Ports&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="i_o.html" title="up to &quot;8 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="serialization.html" title="forward to &quot;8.4 Datatypes and Serialization&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;read-write&quot;">8.3<tt>&nbsp;</tt><a name="(part._read-write)"></a>Reading and Writing Racket Data</h4><p>As noted throughout <a href="datatypes.html" data-pltdoc="x">Built-In Datatypes</a>, Racket provides three
+ways to print an instance of a built-in value:</p><ul><li><p><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._print%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">print</a></span>, which prints a value in the same way that is it
+printed for a <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> result; and </p></li><li><p><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span>, which prints a value in such a way that
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span> on the output produces the value back; and </p></li><li><p><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span>, which tends to reduce a value to just its
+character or byte content&#8212;<wbr></wbr>at least for those datatypes that
+are primarily about characters or bytes, otherwise it falls
+back to the same output as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span>.</p></li></ul><p>Here are some examples using each:</p><p><table cellspacing="0" cellpadding="0"><tr><td><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._print%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">print</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1/2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">1/2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._print%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">print</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">#\x</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._print%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">print</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">"hello"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._print%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">print</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"goodbye"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">#"goodbye"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._print%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">print</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">|pea pod|</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">'|pea pod|</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._print%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">print</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"i"</span><span class="hspace">&nbsp;</span><span class="RktVal">pod</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">'("i" pod)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._print%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">print</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">#&lt;procedure:write&gt;</span></p></td></tr></table></blockquote></td><td><p><span class="hspace">&nbsp;</span></p></td><td><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1/2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">1/2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">#\x</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">"hello"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"goodbye"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">#"goodbye"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">|pea pod|</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">|pea pod|</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"i"</span><span class="hspace">&nbsp;</span><span class="RktVal">pod</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">("i" pod)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">#&lt;procedure:write&gt;</span></p></td></tr></table></blockquote></td><td><p><span class="hspace">&nbsp;</span></p></td><td><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1/2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">1/2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#\x</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">x</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">hello</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#"goodbye"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">goodbye</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">|pea pod|</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">pea pod</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"i"</span><span class="hspace">&nbsp;</span><span class="RktVal">pod</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">(i pod)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">#&lt;procedure:write&gt;</span></p></td></tr></table></blockquote></td></tr></table></p><p>Overall, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._print%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">print</a></span> corresponds to the expression layer of
+Racket syntax, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span> corresponds to the reader layer, and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span> roughly corresponds to the character layer.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span> function supports simple formatting of data and
+text. In the format string supplied to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">~a</span><span class="hspace"></span></span>
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span>s the next argument, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">~s</span><span class="hspace"></span></span>
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span>s the next argument, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">~v</span><span class="hspace"></span></span>
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._print%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">print</a></span>s the next argument.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">deliver</span><span class="hspace">&nbsp;</span><span class="RktSym">who</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._when%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">when</a></span><span class="hspace">&nbsp;</span><span class="RktSym">what</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Items ~a for shopper ~s: ~v"</span><span class="hspace">&nbsp;</span><span class="RktSym">who</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._when%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">when</a></span><span class="hspace">&nbsp;</span><span class="RktSym">what</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">deliver</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"list"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"John"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"milk"</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Items (list) for shopper ("John"): '("milk")</span></p></td></tr></table></blockquote></div></p><p>After using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span>, as opposed to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span> or
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._print%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">print</a></span>, many forms of data can be read back in using
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span>. The same values <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._print%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">print</a></span>ed can also be parsed by
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span>, but the result may have extra quote forms, since a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._print%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">print</a></span>ed form is meant to be read like an expression.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">in</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pipeports.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-pipe%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-pipe</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"hello"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"alphabet"</span><span class="hspace">&nbsp;</span><span class="RktVal">soup</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("alphabet" soup)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#hash</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"apple"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVal">b</span><span class="hspace">&nbsp;</span><span class="RktPn">. </span><span class="RktVal">"banana"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#hash((a . "apple") (b . "banana"))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._print%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">print</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"alphabet"</span><span class="hspace">&nbsp;</span><span class="RktVal">soup</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">''("alphabet" soup)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">"alphabet"</span><span class="hspace">&nbsp;</span><span class="RktVal">soup</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(alphabet soup)</span></p></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="default-ports.html" title="backward to &quot;8.2 Default Ports&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="i_o.html" title="up to &quot;8 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="serialization.html" title="forward to &quot;8.4 Datatypes and Serialization&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/reflection.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/reflection.html
new file mode 100644
index 00000000..542154ae
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/reflection.html
@@ -0,0 +1,4 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>15&nbsp;Reflection and Dynamic Evaluation</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewselflink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>15&nbsp;</td><td><a href="reflection.html" class="tocviewselflink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">15.1&nbsp;</td><td><a href="eval.html" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">eval</span></span></a></td></tr><tr><td align="right">15.2&nbsp;</td><td><a href="mk-namespace.html" class="tocviewlink" data-pltdoc="x">Manipulating Namespaces</a></td></tr><tr><td align="right">15.3&nbsp;</td><td><a href="load.html" class="tocviewlink" data-pltdoc="x">Scripting Evaluation and Using <span class="RktSym"><span class="RktValLink">load</span></span></a></td></tr><tr><td align="right">15.4&nbsp;</td><td><a href="code-inspectors_protect.html" class="tocviewlink" data-pltdoc="x">Code Inspectors for Trusted and Untrusted Code</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="unit_versus_module.html" title="backward to &quot;14.7 unit versus module&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="eval.html" title="forward to &quot;15.1 eval&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;reflection&quot;">15<tt>&nbsp;</tt><a name="(part._reflection)"></a>Reflection and Dynamic Evaluation</h3><p>Racket is a <span style="font-style: italic">dynamic</span> language. It offers numerous facilities
+for loading, compiling, and even constructing new code at run
+time.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval.html" class="toclink" data-pltdoc="x">15.1<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktValLink">eval</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval.html#%28part._.Local_.Scopes%29" class="toclink" data-pltdoc="x">15.1.1<span class="hspace">&nbsp;</span>Local Scopes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval.html#%28part._namespaces%29" class="toclink" data-pltdoc="x">15.1.2<span class="hspace">&nbsp;</span>Namespaces</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="eval.html#%28part._.Namespaces_and_.Modules%29" class="toclink" data-pltdoc="x">15.1.3<span class="hspace">&nbsp;</span>Namespaces and Modules</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="mk-namespace.html" class="toclink" data-pltdoc="x">15.2<span class="hspace">&nbsp;</span>Manipulating Namespaces</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="mk-namespace.html#%28part._.Creating_and_.Installing_.Namespaces%29" class="toclink" data-pltdoc="x">15.2.1<span class="hspace">&nbsp;</span>Creating and Installing Namespaces</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="mk-namespace.html#%28part._.Sharing_.Data_and_.Code_.Across_.Namespaces%29" class="toclink" data-pltdoc="x">15.2.2<span class="hspace">&nbsp;</span>Sharing Data and Code Across Namespaces</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="load.html" class="toclink" data-pltdoc="x">15.3<span class="hspace">&nbsp;</span>Scripting Evaluation and Using <span class="RktSym"><span class="RktValLink">load</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="code-inspectors_protect.html" class="toclink" data-pltdoc="x">15.4<span class="hspace">&nbsp;</span>Code Inspectors for Trusted and Untrusted Code</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="unit_versus_module.html" title="backward to &quot;14.7 unit versus module&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="eval.html" title="forward to &quot;15.1 eval&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-alternation.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-alternation.html
new file mode 100644
index 00000000..953968fd
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-alternation.html
@@ -0,0 +1,14 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>9.7&nbsp;Alternation</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewselflink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">9.1&nbsp;</td><td><a href="regexp-intro.html" class="tocviewlink" data-pltdoc="x">Writing Regexp Patterns</a></td></tr><tr><td align="right">9.2&nbsp;</td><td><a href="regexp-match.html" class="tocviewlink" data-pltdoc="x">Matching Regexp Patterns</a></td></tr><tr><td align="right">9.3&nbsp;</td><td><a href="regexp-assert.html" class="tocviewlink" data-pltdoc="x">Basic Assertions</a></td></tr><tr><td align="right">9.4&nbsp;</td><td><a href="regexp-chars.html" class="tocviewlink" data-pltdoc="x">Characters and Character Classes</a></td></tr><tr><td align="right">9.5&nbsp;</td><td><a href="regexp-quant.html" class="tocviewlink" data-pltdoc="x">Quantifiers</a></td></tr><tr><td align="right">9.6&nbsp;</td><td><a href="regexp-clusters.html" class="tocviewlink" data-pltdoc="x">Clusters</a></td></tr><tr><td align="right">9.7&nbsp;</td><td><a href="regexp-alternation.html" class="tocviewselflink" data-pltdoc="x">Alternation</a></td></tr><tr><td align="right">9.8&nbsp;</td><td><a href="Backtracking.html" class="tocviewlink" data-pltdoc="x">Backtracking</a></td></tr><tr><td align="right">9.9&nbsp;</td><td><a href="Looking_Ahead_and_Behind.html" class="tocviewlink" data-pltdoc="x">Looking Ahead and Behind</a></td></tr><tr><td align="right">9.10&nbsp;</td><td><a href="An_Extended_Example.html" class="tocviewlink" data-pltdoc="x">An Extended Example</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="regexp-clusters.html" title="backward to &quot;9.6 Clusters&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="regexp.html" title="up to &quot;9 Regular Expressions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Backtracking.html" title="forward to &quot;9.8 Backtracking&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;regexp-alternation&quot;">9.7<tt>&nbsp;</tt><a name="(part._regexp-alternation)"></a>Alternation</h4><p>You can specify a list of <span class="emph">alternate</span> <a href="regexp-clusters.html#%28tech._subpattern%29" class="techoutside" data-pltdoc="x"><span class="techinside">subpatterns</span></a> by
+separating them by <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span>.  The <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span> separates
+<a href="regexp-clusters.html#%28tech._subpattern%29" class="techoutside" data-pltdoc="x"><span class="techinside">subpatterns</span></a> in the nearest enclosing cluster (or in the entire
+pattern string if there are no enclosing parens).</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"f(ee|i|o|um)"</span><span class="hspace">&nbsp;</span><span class="RktVal">"a small, final fee"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("fi" "i")</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._regexp-replace%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-replace*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"([yi])s(e[sdr]?|ing|ation)"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"analyse an energising organisation"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">" pulsing with noisy organisms"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"\\1z\\2"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"analyze an energizing organization pulsing with noisy organisms"</span></p></td></tr></table></blockquote><p>Note again that if you wish to use clustering merely to specify a list
+of alternate subpatterns but do not want the submatch, use
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?:</span><span class="hspace"></span></span> instead of <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span>.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"f(?:ee|i|o|um)"</span><span class="hspace">&nbsp;</span><span class="RktVal">"fun for all"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("fo")</span></p></td></tr></table></blockquote><p>An important thing to note about alternation is that the leftmost
+matching alternate is picked regardless of its length.  Thus, if one
+of the alternates is a prefix of a later alternate, the latter may not
+have a chance to match.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"call|call-with-current-continuation"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"call-with-current-continuation"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("call")</span></p></td></tr></table></blockquote><p>To allow the longer alternate to have a shot at matching, place it
+before the shorter one:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"call-with-current-continuation|call"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"call-with-current-continuation"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("call-with-current-continuation")</span></p></td></tr></table></blockquote><p>In any case, an overall match for the entire regexp is always
+preferred to an overall non-match.  In the following, the longer
+alternate still wins, because its preferred shorter prefix fails to
+yield an overall match.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"(?:call|call-with-current-continuation) constrained"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktVal">"call-with-current-continuation constrained"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("call-with-current-continuation constrained")</span></p></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="regexp-clusters.html" title="backward to &quot;9.6 Clusters&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="regexp.html" title="up to &quot;9 Regular Expressions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Backtracking.html" title="forward to &quot;9.8 Backtracking&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-assert.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-assert.html
new file mode 100644
index 00000000..32f89d6c
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-assert.html
@@ -0,0 +1,10 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>9.3&nbsp;Basic Assertions</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewselflink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">9.1&nbsp;</td><td><a href="regexp-intro.html" class="tocviewlink" data-pltdoc="x">Writing Regexp Patterns</a></td></tr><tr><td align="right">9.2&nbsp;</td><td><a href="regexp-match.html" class="tocviewlink" data-pltdoc="x">Matching Regexp Patterns</a></td></tr><tr><td align="right">9.3&nbsp;</td><td><a href="regexp-assert.html" class="tocviewselflink" data-pltdoc="x">Basic Assertions</a></td></tr><tr><td align="right">9.4&nbsp;</td><td><a href="regexp-chars.html" class="tocviewlink" data-pltdoc="x">Characters and Character Classes</a></td></tr><tr><td align="right">9.5&nbsp;</td><td><a href="regexp-quant.html" class="tocviewlink" data-pltdoc="x">Quantifiers</a></td></tr><tr><td align="right">9.6&nbsp;</td><td><a href="regexp-clusters.html" class="tocviewlink" data-pltdoc="x">Clusters</a></td></tr><tr><td align="right">9.7&nbsp;</td><td><a href="regexp-alternation.html" class="tocviewlink" data-pltdoc="x">Alternation</a></td></tr><tr><td align="right">9.8&nbsp;</td><td><a href="Backtracking.html" class="tocviewlink" data-pltdoc="x">Backtracking</a></td></tr><tr><td align="right">9.9&nbsp;</td><td><a href="Looking_Ahead_and_Behind.html" class="tocviewlink" data-pltdoc="x">Looking Ahead and Behind</a></td></tr><tr><td align="right">9.10&nbsp;</td><td><a href="An_Extended_Example.html" class="tocviewlink" data-pltdoc="x">An Extended Example</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="regexp-match.html" title="backward to &quot;9.2 Matching Regexp Patterns&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="regexp.html" title="up to &quot;9 Regular Expressions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="regexp-chars.html" title="forward to &quot;9.4 Characters and Character Classes&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;regexp-assert&quot;">9.3<tt>&nbsp;</tt><a name="(part._regexp-assert)"></a>Basic Assertions</h4><p>The <a name="(tech._assertion)"></a><span style="font-style: italic">assertions</span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">$</span><span class="hspace"></span></span> identify the
+beginning and the end of the text string, respectively.  They ensure
+that their adjoining regexps match at one or other end of the text
+string:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"^contact"</span><span class="hspace">&nbsp;</span><span class="RktVal">"first contact"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote><p>The <a href="regexp.html#%28tech._regexp%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp</span></a> above fails to match because <span class="RktInBG"><span class="hspace"></span><span class="RktIn">contact</span><span class="hspace"></span></span> does
+not occur at the beginning of the text string. In</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"laugh$"</span><span class="hspace">&nbsp;</span><span class="RktVal">"laugh laugh laugh laugh"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((18 . 23))</span></p></td></tr></table></blockquote><p>the regexp matches the <span class="emph">last</span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">laugh</span><span class="hspace"></span></span>.</p><p>The metasequence <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\b</span><span class="hspace"></span></span> asserts that a word boundary exists, but
+this metasequence works only with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#px</span><span class="hspace"></span></span> syntax. In</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"yack\\b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"yackety yack"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((8 . 12))</span></p></td></tr></table></blockquote><p>the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">yack</span><span class="hspace"></span></span> in <span class="RktInBG"><span class="hspace"></span><span class="RktIn">yackety</span><span class="hspace"></span></span> doesn&rsquo;t end at a word boundary
+so it isn&rsquo;t matched.  The second <span class="RktInBG"><span class="hspace"></span><span class="RktIn">yack</span><span class="hspace"></span></span> does and is.</p><p>The metasequence <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\B</span><span class="hspace"></span></span> (also <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#px</span><span class="hspace"></span></span> only) has the
+opposite effect to <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\b</span><span class="hspace"></span></span>; it asserts that a word boundary does
+not exist. In</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"an\\B"</span><span class="hspace">&nbsp;</span><span class="RktVal">"an analysis"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((3 . 5))</span></p></td></tr></table></blockquote><p>the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">an</span><span class="hspace"></span></span> that doesn&rsquo;t end in a word boundary is matched.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="regexp-match.html" title="backward to &quot;9.2 Matching Regexp Patterns&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="regexp.html" title="up to &quot;9 Regular Expressions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="regexp-chars.html" title="forward to &quot;9.4 Characters and Character Classes&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-chars.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-chars.html
new file mode 100644
index 00000000..1e1f3450
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-chars.html
@@ -0,0 +1,60 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>9.4&nbsp;Characters and Character Classes</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewselflink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">9.1&nbsp;</td><td><a href="regexp-intro.html" class="tocviewlink" data-pltdoc="x">Writing Regexp Patterns</a></td></tr><tr><td align="right">9.2&nbsp;</td><td><a href="regexp-match.html" class="tocviewlink" data-pltdoc="x">Matching Regexp Patterns</a></td></tr><tr><td align="right">9.3&nbsp;</td><td><a href="regexp-assert.html" class="tocviewlink" data-pltdoc="x">Basic Assertions</a></td></tr><tr><td align="right">9.4&nbsp;</td><td><a href="regexp-chars.html" class="tocviewselflink" data-pltdoc="x">Characters and Character Classes</a></td></tr><tr><td align="right">9.5&nbsp;</td><td><a href="regexp-quant.html" class="tocviewlink" data-pltdoc="x">Quantifiers</a></td></tr><tr><td align="right">9.6&nbsp;</td><td><a href="regexp-clusters.html" class="tocviewlink" data-pltdoc="x">Clusters</a></td></tr><tr><td align="right">9.7&nbsp;</td><td><a href="regexp-alternation.html" class="tocviewlink" data-pltdoc="x">Alternation</a></td></tr><tr><td align="right">9.8&nbsp;</td><td><a href="Backtracking.html" class="tocviewlink" data-pltdoc="x">Backtracking</a></td></tr><tr><td align="right">9.9&nbsp;</td><td><a href="Looking_Ahead_and_Behind.html" class="tocviewlink" data-pltdoc="x">Looking Ahead and Behind</a></td></tr><tr><td align="right">9.10&nbsp;</td><td><a href="An_Extended_Example.html" class="tocviewlink" data-pltdoc="x">An Extended Example</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>9.4&nbsp;</td><td><a href="regexp-chars.html" class="tocviewselflink" data-pltdoc="x">Characters and Character Classes</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">9.4.1&nbsp;</td><td><a href="regexp-chars.html#%28part._.Some_.Frequently_.Used_.Character_.Classes%29" class="tocviewlink" data-pltdoc="x">Some Frequently Used Character Classes</a></td></tr><tr><td align="right">9.4.2&nbsp;</td><td><a href="regexp-chars.html#%28part._.P.O.S.I.X_character_classes%29" class="tocviewlink" data-pltdoc="x">POSIX character classes</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">9.4.1<tt>&nbsp;</tt></span><a href="regexp-chars.html#%28part._.Some_.Frequently_.Used_.Character_.Classes%29" class="tocsubseclink" data-pltdoc="x">Some Frequently Used Character Classes</a></td></tr><tr><td><span class="tocsublinknumber">9.4.2<tt>&nbsp;</tt></span><a href="regexp-chars.html#%28part._.P.O.S.I.X_character_classes%29" class="tocsubseclink" data-pltdoc="x">POSIX character classes</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="regexp-assert.html" title="backward to &quot;9.3 Basic Assertions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="regexp.html" title="up to &quot;9 Regular Expressions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="regexp-quant.html" title="forward to &quot;9.5 Quantifiers&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;regexp-chars&quot;">9.4<tt>&nbsp;</tt><a name="(part._regexp-chars)"></a>Characters and Character Classes</h4><p>Typically, a character in the regexp matches the same character in the
+text string.  Sometimes it is necessary or convenient to use a regexp
+<a href="regexp-intro.html#%28tech._metasequence%29" class="techoutside" data-pltdoc="x"><span class="techinside">metasequence</span></a> to refer to a single character. For example, the
+metasequence <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\.</span><span class="hspace"></span></span> matches the period character.</p><p>The <a href="regexp-intro.html#%28tech._metacharacter%29" class="techoutside" data-pltdoc="x"><span class="techinside">metacharacter</span></a> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> matches <span class="emph">any</span> character
+(other than newline in <a href="regexp-clusters.html#%28tech._multi._line._mode%29" class="techoutside" data-pltdoc="x"><span class="techinside">multi-line mode</span></a>; see
+<a href="regexp-clusters.html#%28part._regexp-cloister%29" data-pltdoc="x">Cloisters</a>):</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"p.t"</span><span class="hspace">&nbsp;</span><span class="RktVal">"pet"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("pet")</span></p></td></tr></table></blockquote><p>The above pattern also matches <span class="RktInBG"><span class="hspace"></span><span class="RktIn">pat</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">pit</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">pot</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">put</span><span class="hspace"></span></span>, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">p8t</span><span class="hspace"></span></span>, but not
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">peat</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">pfffft</span><span class="hspace"></span></span>.</p><p>A <a name="(tech._character._clas)"></a><span style="font-style: italic">character class</span> matches any one character from a set of
+characters.  A typical format for this is the <a name="(tech._bracketed._character._clas)"></a><span style="font-style: italic">bracketed
+character class</span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span>...<span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span>, which matches any one
+character from the non-empty sequence of characters enclosed within
+the brackets.  Thus, <span class="RktVal">#rx"p[aeiou]t"</span> matches <span class="RktInBG"><span class="hspace"></span><span class="RktIn">pat</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">pet</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">pit</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">pot</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">put</span><span class="hspace"></span></span>, and
+nothing else.</p><p>Inside the brackets, a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span> between two characters specifies
+the Unicode range between the characters.  For example,
+<span class="RktVal">#rx"ta[b-dgn-p]"</span> matches <span class="RktInBG"><span class="hspace"></span><span class="RktIn">tab</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">tac</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">tad</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">tag</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">tan</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">tao</span><span class="hspace"></span></span>, and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">tap</span><span class="hspace"></span></span>.</p><p>An initial <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span> after the left bracket inverts the set
+specified by the rest of the contents; i.e., it specifies the set of
+characters <span class="emph">other than</span> those identified in the brackets. For
+example, <span class="RktVal">#rx"do[^g]"</span> matches all three-character sequences
+starting with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">do</span><span class="hspace"></span></span> except <span class="RktInBG"><span class="hspace"></span><span class="RktIn">dog</span><span class="hspace"></span></span>.</p><p>Note that the <a href="regexp-intro.html#%28tech._metacharacter%29" class="techoutside" data-pltdoc="x"><span class="techinside">metacharacter</span></a> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span> inside brackets means
+something quite different from what it means outside.  Most other
+<a href="regexp-intro.html#%28tech._metacharacter%29" class="techoutside" data-pltdoc="x"><span class="techinside">metacharacters</span></a> (<span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">*</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">?</span><span class="hspace"></span></span>, etc.) cease to be <a href="regexp-intro.html#%28tech._metacharacter%29" class="techoutside" data-pltdoc="x"><span class="techinside">metacharacters</span></a> when inside
+brackets, although you may still escape them for peace of mind. A
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">-</span><span class="hspace"></span></span> is a <a href="regexp-intro.html#%28tech._metacharacter%29" class="techoutside" data-pltdoc="x"><span class="techinside">metacharacter</span></a> only when it&rsquo;s inside brackets,
+and when it is neither the first nor the last character between the
+brackets.</p><p>Bracketed character classes cannot contain other bracketed character
+classes (although they contain certain other types of character
+classes; see below).  Thus, a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span> inside a bracketed character
+class doesn&rsquo;t have to be a metacharacter; it can stand for itself.
+For example, <span class="RktVal">#rx"[a[b]"</span> matches <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span>, and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">b</span><span class="hspace"></span></span>.</p><p>Furthermore, since empty bracketed character classes are disallowed, a
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span> immediately occurring after the opening left bracket also
+doesn&rsquo;t need to be a metacharacter.  For example, <span class="RktVal">#rx"[]ab]"</span>
+matches <span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">b</span><span class="hspace"></span></span>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Some_Frequently_Used_Character_Classes&quot;">9.4.1<tt>&nbsp;</tt><a name="(part._.Some_.Frequently_.Used_.Character_.Classes)"></a>Some Frequently Used Character Classes</h5><p>In <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#px</span><span class="hspace"></span></span> syntax, some standard character classes can be
+conveniently represented as metasequences instead of as explicit
+bracketed expressions:  <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\d</span><span class="hspace"></span></span> matches a digit
+(the same as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">[0-9]</span><span class="hspace"></span></span>); <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\s</span><span class="hspace"></span></span> matches an ASCII whitespace character; and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\w</span><span class="hspace"></span></span> matches a character that could be part of a
+&ldquo;word&rdquo;.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Following regexp custom, we identify &ldquo;word&rdquo; characters
+as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">[A-Za-z0-9_]</span><span class="hspace"></span></span>, although these are too restrictive for what
+a Racketeer might consider a &ldquo;word.&rdquo;</p></blockquote></blockquote></blockquote><p>The upper-case versions of these metasequences stand for the
+inversions of the corresponding character classes: <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\D</span><span class="hspace"></span></span>
+matches a non-digit, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\S</span><span class="hspace"></span></span> a non-whitespace character, and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\W</span><span class="hspace"></span></span> a non-&ldquo;word&rdquo; character.</p><p>Remember to include a double backslash when putting these
+metasequences in a Racket string:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"\\d\\d"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktVal">"0 dear, 1 have 2 read catch 22 before 9"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("22")</span></p></td></tr></table></blockquote><p>These character classes can be used inside a bracketed expression. For
+example, <span class="RktVal">#px"[a-z\\d]"</span> matches a lower-case letter or a
+digit.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;POSIX_character_classes&quot;">9.4.2<tt>&nbsp;</tt><a name="(part._.P.O.S.I.X_character_classes)"></a>POSIX character classes</h5><p>A <a name="(tech._posix._character._clas)"></a><span style="font-style: italic">POSIX character class</span> is a special <a href="regexp-intro.html#%28tech._metasequence%29" class="techoutside" data-pltdoc="x"><span class="techinside">metasequence</span></a> of
+the form <span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:</span><span class="hspace"></span></span>...<span class="RktInBG"><span class="hspace"></span><span class="RktIn">:]</span><span class="hspace"></span></span> that can be used only inside a
+bracketed expression in <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#px</span><span class="hspace"></span></span> syntax.  The POSIX classes
+supported are</p><ul class="compact"><li class="compactItem"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:alnum:]</span><span class="hspace"></span></span> &#8212;<wbr></wbr> ASCII letters and digits</p></li><li class="compactItem"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:alpha:]</span><span class="hspace"></span></span> &#8212;<wbr></wbr> ASCII letters</p></li><li class="compactItem"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:ascii:]</span><span class="hspace"></span></span> &#8212;<wbr></wbr> ASCII characters</p></li><li class="compactItem"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:blank:]</span><span class="hspace"></span></span> &#8212;<wbr></wbr> ASCII widthful whitespace: space and tab</p></li><li class="compactItem"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:cntrl:]</span><span class="hspace"></span></span> &#8212;<wbr></wbr> &ldquo;control&rdquo; characters: ASCII 0 to 31</p></li><li class="compactItem"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:digit:]</span><span class="hspace"></span></span> &#8212;<wbr></wbr> ASCII digits, same as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\d</span><span class="hspace"></span></span></p></li><li class="compactItem"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:graph:]</span><span class="hspace"></span></span> &#8212;<wbr></wbr> ASCII characters that use ink</p></li><li class="compactItem"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:lower:]</span><span class="hspace"></span></span> &#8212;<wbr></wbr> ASCII lower-case letters</p></li><li class="compactItem"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:print:]</span><span class="hspace"></span></span> &#8212;<wbr></wbr> ASCII ink-users plus widthful whitespace</p></li><li class="compactItem"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:space:]</span><span class="hspace"></span></span> &#8212;<wbr></wbr> ASCII whitespace, same as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\s</span><span class="hspace"></span></span></p></li><li class="compactItem"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:upper:]</span><span class="hspace"></span></span> &#8212;<wbr></wbr> ASCII upper-case letters</p></li><li class="compactItem"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:word:]</span><span class="hspace"></span></span> &#8212;<wbr></wbr> ASCII letters and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">_</span><span class="hspace"></span></span>, same as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\w</span><span class="hspace"></span></span></p></li><li class="compactItem"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:xdigit:]</span><span class="hspace"></span></span> &#8212;<wbr></wbr> ASCII hex digits</p></li></ul><p>For example, the <span class="RktVal">#px"[[:alpha:]_]"</span> matches a letter or
+underscore.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"[[:alpha:]_]"</span><span class="hspace">&nbsp;</span><span class="RktVal">"--x--"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("x")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"[[:alpha:]_]"</span><span class="hspace">&nbsp;</span><span class="RktVal">"--_--"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("_")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"[[:alpha:]_]"</span><span class="hspace">&nbsp;</span><span class="RktVal">"--:--"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote><p>The POSIX class notation is valid <span class="emph">only</span> inside a bracketed
+expression.  For instance, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">[:alpha:]</span><span class="hspace"></span></span>, when not inside a
+bracketed expression, will not be read as the letter class.  Rather,
+it is (from previous principles) the character class containing the
+characters <span class="RktInBG"><span class="hspace"></span><span class="RktIn">:</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">l</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">p</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">h</span><span class="hspace"></span></span>.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"[:alpha:]"</span><span class="hspace">&nbsp;</span><span class="RktVal">"--a--"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("a")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"[:alpha:]"</span><span class="hspace">&nbsp;</span><span class="RktVal">"--x--"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="regexp-assert.html" title="backward to &quot;9.3 Basic Assertions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="regexp.html" title="up to &quot;9 Regular Expressions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="regexp-quant.html" title="forward to &quot;9.5 Quantifiers&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-clusters.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-clusters.html
new file mode 100644
index 00000000..7c4a4d9a
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-clusters.html
@@ -0,0 +1,50 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>9.6&nbsp;Clusters</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewselflink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">9.1&nbsp;</td><td><a href="regexp-intro.html" class="tocviewlink" data-pltdoc="x">Writing Regexp Patterns</a></td></tr><tr><td align="right">9.2&nbsp;</td><td><a href="regexp-match.html" class="tocviewlink" data-pltdoc="x">Matching Regexp Patterns</a></td></tr><tr><td align="right">9.3&nbsp;</td><td><a href="regexp-assert.html" class="tocviewlink" data-pltdoc="x">Basic Assertions</a></td></tr><tr><td align="right">9.4&nbsp;</td><td><a href="regexp-chars.html" class="tocviewlink" data-pltdoc="x">Characters and Character Classes</a></td></tr><tr><td align="right">9.5&nbsp;</td><td><a href="regexp-quant.html" class="tocviewlink" data-pltdoc="x">Quantifiers</a></td></tr><tr><td align="right">9.6&nbsp;</td><td><a href="regexp-clusters.html" class="tocviewselflink" data-pltdoc="x">Clusters</a></td></tr><tr><td align="right">9.7&nbsp;</td><td><a href="regexp-alternation.html" class="tocviewlink" data-pltdoc="x">Alternation</a></td></tr><tr><td align="right">9.8&nbsp;</td><td><a href="Backtracking.html" class="tocviewlink" data-pltdoc="x">Backtracking</a></td></tr><tr><td align="right">9.9&nbsp;</td><td><a href="Looking_Ahead_and_Behind.html" class="tocviewlink" data-pltdoc="x">Looking Ahead and Behind</a></td></tr><tr><td align="right">9.10&nbsp;</td><td><a href="An_Extended_Example.html" class="tocviewlink" data-pltdoc="x">An Extended Example</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>9.6&nbsp;</td><td><a href="regexp-clusters.html" class="tocviewselflink" data-pltdoc="x">Clusters</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">9.6.1&nbsp;</td><td><a href="regexp-clusters.html#%28part._.Backreferences%29" class="tocviewlink" data-pltdoc="x">Backreferences</a></td></tr><tr><td align="right">9.6.2&nbsp;</td><td><a href="regexp-clusters.html#%28part._.Non-capturing_.Clusters%29" class="tocviewlink" data-pltdoc="x">Non-<wbr></wbr>capturing Clusters</a></td></tr><tr><td align="right">9.6.3&nbsp;</td><td><a href="regexp-clusters.html#%28part._regexp-cloister%29" class="tocviewlink" data-pltdoc="x">Cloisters</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">9.6.1<tt>&nbsp;</tt></span><a href="regexp-clusters.html#%28part._.Backreferences%29" class="tocsubseclink" data-pltdoc="x">Backreferences</a></td></tr><tr><td><span class="tocsublinknumber">9.6.2<tt>&nbsp;</tt></span><a href="regexp-clusters.html#%28part._.Non-capturing_.Clusters%29" class="tocsubseclink" data-pltdoc="x">Non-<wbr></wbr>capturing Clusters</a></td></tr><tr><td><span class="tocsublinknumber">9.6.3<tt>&nbsp;</tt></span><a href="regexp-clusters.html#%28part._regexp-cloister%29" class="tocsubseclink" data-pltdoc="x">Cloisters</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="regexp-quant.html" title="backward to &quot;9.5 Quantifiers&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="regexp.html" title="up to &quot;9 Regular Expressions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="regexp-alternation.html" title="forward to &quot;9.7 Alternation&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;regexp-clusters&quot;">9.6<tt>&nbsp;</tt><a name="(part._regexp-clusters)"></a>Clusters</h4><p><a name="(tech._clustering)"></a><span style="font-style: italic">Clustering</span>&#8212;<wbr></wbr>enclosure within parens
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span>...<span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>&#8212;<wbr></wbr>identifies the enclosed
+<a name="(tech._subpattern)"></a><span style="font-style: italic">subpattern</span> as a single entity.  It causes the matcher to
+capture the <a name="(tech._submatch)"></a><span style="font-style: italic">submatch</span>, or the portion of the string matching
+the subpattern, in addition to the overall match:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"([a-z]+) ([0-9]+), ([0-9]+)"</span><span class="hspace">&nbsp;</span><span class="RktVal">"jan 1, 1970"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("jan 1, 1970" "jan" "1" "1970")</span></p></td></tr></table></blockquote><p>Clustering also causes a following quantifier to treat the entire
+enclosed subpattern as an entity:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"(pu )*"</span><span class="hspace">&nbsp;</span><span class="RktVal">"pu pu platter"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("pu pu " "pu ")</span></p></td></tr></table></blockquote><p>The number of submatches returned is always equal to the number of
+subpatterns specified in the regexp, even if a particular subpattern
+happens to match more than one substring or no substring at all.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"([a-z ]+;)*"</span><span class="hspace">&nbsp;</span><span class="RktVal">"lather; rinse; repeat;"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("lather; rinse; repeat;" " repeat;")</span></p></td></tr></table></blockquote><p>Here, the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">*</span><span class="hspace"></span></span>-quantified subpattern matches three times, but
+it is the last submatch that is returned.</p><p>It is also possible for a quantified subpattern to fail to match, even
+if the overall pattern matches.  In such cases, the failing submatch
+is represented by <span class="RktVal">#f</span></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">date-re</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">match </span><span class="RktCmt">&lsquo;</span><span class="RktCmt">month year</span><span class="RktCmt">'</span><span class="RktCmt"> or </span><span class="RktCmt">&lsquo;</span><span class="RktCmt">month day, year</span><span class="RktCmt">'</span><span class="RktCmt">;</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">subpattern matches day, if present</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">#rx"([a-z]+) +([0-9]+,)? *([0-9]+)"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktSym">date-re</span><span class="hspace">&nbsp;</span><span class="RktVal">"jan 1, 1970"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("jan 1, 1970" "jan" "1," "1970")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktSym">date-re</span><span class="hspace">&nbsp;</span><span class="RktVal">"jan 1970"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("jan 1970" "jan" #f "1970")</span></p></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Backreferences&quot;">9.6.1<tt>&nbsp;</tt><a name="(part._.Backreferences)"></a>Backreferences</h5><p><a href="regexp-clusters.html#%28tech._submatch%29" class="techoutside" data-pltdoc="x"><span class="techinside">Submatch</span></a>es can be used in the insert string argument of the
+procedures <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-replace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-replace</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._regexp-replace%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-replace*</a></span>.  The
+insert string can use <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span style="font-style: italic">n</span> as a <a name="(tech._backreference)"></a><span style="font-style: italic">backreference</span>
+to refer back to the <span style="font-style: italic">n</span>th submatch, which is the substring
+that matched the <span style="font-style: italic">n</span>th subpattern.  A <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\0</span><span class="hspace"></span></span> refers to the
+entire match, and it can also be specified as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\&amp;</span><span class="hspace"></span></span>.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-replace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-replace</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"_(.+?)_"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"the _nina_, the _pinta_, and the _santa maria_"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"*\\1*"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"the *nina*, the _pinta_, and the _santa maria_"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._regexp-replace%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-replace*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"_(.+?)_"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"the _nina_, the _pinta_, and the _santa maria_"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"*\\1*"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"the *nina*, the *pinta*, and the *santa maria*"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-replace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-replace</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"(\\S+) (\\S+) (\\S+)"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"eat to live"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"\\3 \\2 \\1"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"live to eat"</span></p></td></tr></table></blockquote><p>Use <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\\</span><span class="hspace"></span></span> in the insert string to specify a literal backslash.
+Also, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\$</span><span class="hspace"></span></span> stands for an empty string, and is useful for
+separating a backreference <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span style="font-style: italic">n</span> from an immediately
+following number.</p><p>Backreferences can also be used within a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#px</span><span class="hspace"></span></span> pattern to
+refer back to an already matched subpattern in the pattern.
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span><span style="font-style: italic">n</span> stands for an exact repeat of the <span style="font-style: italic">n</span>th
+submatch. Note that <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\0</span><span class="hspace"></span></span>, which is useful in an insert string,
+makes no sense within the regexp pattern, because the entire regexp
+has not matched yet so you cannot refer back to it.}</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"([a-z]+) and \\1"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"billions and billions"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("billions and billions" "billions")</span></p></td></tr></table></blockquote><p>Note that the <a href="regexp-clusters.html#%28tech._backreference%29" class="techoutside" data-pltdoc="x"><span class="techinside">backreference</span></a> is not simply a repeat of the
+previous subpattern.  Rather it is a repeat of the particular
+substring already matched by the subpattern.</p><p>In the above example, the <a href="regexp-clusters.html#%28tech._backreference%29" class="techoutside" data-pltdoc="x"><span class="techinside">backreference</span></a> can only match
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">billions</span><span class="hspace"></span></span>.  It will not match <span class="RktInBG"><span class="hspace"></span><span class="RktIn">millions</span><span class="hspace"></span></span>, even though
+the subpattern it harks back to&#8212;<wbr></wbr><span class="RktInBG"><span class="hspace"></span><span class="RktIn">([a-z]+)</span><span class="hspace"></span></span>&#8212;<wbr></wbr>would have had
+no problem doing so:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"([a-z]+) and \\1"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"billions and millions"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote><p>The following example marks all immediately repeating patterns in a
+number string:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._regexp-replace%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-replace*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"(\\d+)\\1"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"123340983242432420980980234"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"{\\1,\\1}"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"12{3,3}40983{24,24}3242{098,098}0234"</span></p></td></tr></table></blockquote><p>The following example corrects doubled words:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._regexp-replace%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-replace*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"\\b(\\S+) \\1\\b"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"now is the the time for all good men to "</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"to come to the aid of of the party"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktVal">"\\1"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"now is the time for all good men to come to the aid of the party"</span></p></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Non-capturing_Clusters&quot;">9.6.2<tt>&nbsp;</tt><a name="(part._.Non-capturing_.Clusters)"></a>Non-capturing Clusters</h5><p>It is often required to specify a cluster (typically for
+quantification) but without triggering the capture of <a href="regexp-clusters.html#%28tech._submatch%29" class="techoutside" data-pltdoc="x"><span class="techinside">submatch</span></a>
+information.  Such clusters are called <a name="(tech._non._capturing)"></a><span style="font-style: italic">non-capturing</span>.  To
+create a non-capturing cluster, use <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(?:</span><span class="hspace"></span></span> instead of
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span> as the cluster opener.</p><p>In the following example, a non-capturing cluster eliminates the
+&ldquo;directory&rdquo; portion of a given Unix pathname, and a capturing
+cluster identifies the basename.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>But don&rsquo;t parse paths with regexps. Use functions like
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Manipulating_Paths.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._split-path%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">split-path</a></span>, instead.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"^(?:[a-z]*/)*([a-z]+)$"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"/usr/local/bin/racket"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("/usr/local/bin/racket" "racket")</span></p></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;regexp-cloister&quot;">9.6.3<tt>&nbsp;</tt><a name="(part._regexp-cloister)"></a>Cloisters</h5><p>The location between the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">?</span><span class="hspace"></span></span> and the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">:</span><span class="hspace"></span></span> of a
+non-capturing cluster is called a <a name="(tech._cloister)"></a><span style="font-style: italic">cloister</span>. You can put
+modifiers there that will cause the enclustered <a href="regexp-clusters.html#%28tech._subpattern%29" class="techoutside" data-pltdoc="x"><span class="techinside">subpattern</span></a> to
+be treated specially.  The modifier <span class="RktInBG"><span class="hspace"></span><span class="RktIn">i</span><span class="hspace"></span></span> causes the subpattern
+to match case-insensitively:</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The term <span style="font-style: italic">cloister</span> is a useful, if terminally
+cute, coinage from the abbots of Perl.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"(?i:hearth)"</span><span class="hspace">&nbsp;</span><span class="RktVal">"HeartH"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("HeartH")</span></p></td></tr></table></blockquote><p>The modifier <span class="RktInBG"><span class="hspace"></span><span class="RktIn">m</span><span class="hspace"></span></span> causes the <a href="regexp-clusters.html#%28tech._subpattern%29" class="techoutside" data-pltdoc="x"><span class="techinside">subpattern</span></a> to match in
+<a name="(tech._multi._line._mode)"></a><span style="font-style: italic">multi-line mode</span>, where <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> does not match a newline
+character, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">^</span><span class="hspace"></span></span> can match just after a newline, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">$</span><span class="hspace"></span></span>
+can match just before a newline.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"."</span><span class="hspace">&nbsp;</span><span class="RktVal">"\na\n"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("\n")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"(?m:.)"</span><span class="hspace">&nbsp;</span><span class="RktVal">"\na\n"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("a")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"^A plan$"</span><span class="hspace">&nbsp;</span><span class="RktVal">"A man\nA plan\nA canal"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"(?m:^A plan$)"</span><span class="hspace">&nbsp;</span><span class="RktVal">"A man\nA plan\nA canal"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("A plan")</span></p></td></tr></table></blockquote><p>You can put more than one modifier in the cloister:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"(?mi:^A Plan$)"</span><span class="hspace">&nbsp;</span><span class="RktVal">"a man\na plan\na canal"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("a plan")</span></p></td></tr></table></blockquote><p>A minus sign before a modifier inverts its meaning.  Thus, you can use
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">-i</span><span class="hspace"></span></span> in a <a name="(tech._subcluster)"></a><span style="font-style: italic">subcluster</span> to overturn the
+case-insensitivities caused by an enclosing cluster.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"(?i:the (?-i:TeX)book)"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"The TeXbook"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'("The TeXbook")</span></p></td></tr></table></blockquote><p>The above regexp will allow any casing for <span class="RktInBG"><span class="hspace"></span><span class="RktIn">the</span><span class="hspace"></span></span> and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">book</span><span class="hspace"></span></span>, but it insists that <span class="RktInBG"><span class="hspace"></span><span class="RktIn">TeX</span><span class="hspace"></span></span> not be differently
+cased.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="regexp-quant.html" title="backward to &quot;9.5 Quantifiers&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="regexp.html" title="up to &quot;9 Regular Expressions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="regexp-alternation.html" title="forward to &quot;9.7 Alternation&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-intro.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-intro.html
new file mode 100644
index 00000000..3708acb6
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-intro.html
@@ -0,0 +1,41 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>9.1&nbsp;Writing Regexp Patterns</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewselflink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">9.1&nbsp;</td><td><a href="regexp-intro.html" class="tocviewselflink" data-pltdoc="x">Writing Regexp Patterns</a></td></tr><tr><td align="right">9.2&nbsp;</td><td><a href="regexp-match.html" class="tocviewlink" data-pltdoc="x">Matching Regexp Patterns</a></td></tr><tr><td align="right">9.3&nbsp;</td><td><a href="regexp-assert.html" class="tocviewlink" data-pltdoc="x">Basic Assertions</a></td></tr><tr><td align="right">9.4&nbsp;</td><td><a href="regexp-chars.html" class="tocviewlink" data-pltdoc="x">Characters and Character Classes</a></td></tr><tr><td align="right">9.5&nbsp;</td><td><a href="regexp-quant.html" class="tocviewlink" data-pltdoc="x">Quantifiers</a></td></tr><tr><td align="right">9.6&nbsp;</td><td><a href="regexp-clusters.html" class="tocviewlink" data-pltdoc="x">Clusters</a></td></tr><tr><td align="right">9.7&nbsp;</td><td><a href="regexp-alternation.html" class="tocviewlink" data-pltdoc="x">Alternation</a></td></tr><tr><td align="right">9.8&nbsp;</td><td><a href="Backtracking.html" class="tocviewlink" data-pltdoc="x">Backtracking</a></td></tr><tr><td align="right">9.9&nbsp;</td><td><a href="Looking_Ahead_and_Behind.html" class="tocviewlink" data-pltdoc="x">Looking Ahead and Behind</a></td></tr><tr><td align="right">9.10&nbsp;</td><td><a href="An_Extended_Example.html" class="tocviewlink" data-pltdoc="x">An Extended Example</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="regexp.html" title="backward to &quot;9 Regular Expressions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="regexp.html" title="up to &quot;9 Regular Expressions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="regexp-match.html" title="forward to &quot;9.2 Matching Regexp Patterns&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;regexp-intro&quot;">9.1<tt>&nbsp;</tt><a name="(part._regexp-intro)"></a>Writing Regexp Patterns</h4><p>A string or <a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte string</span></a> can be used directly as a <a href="regexp.html#%28tech._regexp%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp</span></a>
+pattern, or it can be prefixed with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#rx</span><span class="hspace"></span></span> to form a literal
+<a href="regexp.html#%28tech._regexp%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp</span></a> value. For example, <span class="RktVal">#rx"abc"</span> is a string-based
+<a href="regexp.html#%28tech._regexp%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp</span></a> value, and <span class="RktVal">#rx#"abc"</span> is a <a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte
+string</span></a>-based <a href="regexp.html#%28tech._regexp%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp</span></a> value. Alternately, a string or byte
+string can be prefixed with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#px</span><span class="hspace"></span></span>, as in <span class="RktVal">#px"abc"</span>,
+for a slightly extended syntax of patterns within the string.</p><p>Most of the characters in a <a href="regexp.html#%28tech._regexp%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp</span></a> pattern are meant to match
+occurrences of themselves in the <a href="regexp.html#%28tech._text._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">text string</span></a>.  Thus, the pattern
+<span class="RktVal">#rx"abc"</span> matches a string that contains the characters
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">b</span><span class="hspace"></span></span>, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">c</span><span class="hspace"></span></span> in succession. Other
+characters act as <a name="(tech._metacharacter)"></a><span style="font-style: italic">metacharacters</span>, and some character
+sequences act as <a name="(tech._metasequence)"></a><span style="font-style: italic">metasequences</span>.  That is, they specify
+something other than their literal selves.  For example, in the
+pattern <span class="RktVal">#rx"a.c"</span>, the characters <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">c</span><span class="hspace"></span></span>
+stand for themselves, but the <a href="regexp-intro.html#%28tech._metacharacter%29" class="techoutside" data-pltdoc="x"><span class="techinside">metacharacter</span></a> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> can
+match <span class="emph">any</span> character.  Therefore, the pattern <span class="RktVal">#rx"a.c"</span>
+matches an <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>, any character, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">c</span><span class="hspace"></span></span> in succession.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>When we want a literal <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> inside a Racket string
+or regexp literal, we must escape it so that it shows up in the string
+at all. Racket strings use <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> as the escape character, so we
+end up with two <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>s: one Racket-string <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> to escape
+the regexp <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>, which then escapes the <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>.  Another
+character that would need escaping inside a Racket string is
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">"</span><span class="hspace"></span></span>.</p></blockquote></blockquote></blockquote><p>If we needed to match the character <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> itself, we can escape
+it by preceding it with a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>.  The character sequence
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">\.</span><span class="hspace"></span></span> is thus a <a href="regexp-intro.html#%28tech._metasequence%29" class="techoutside" data-pltdoc="x"><span class="techinside">metasequence</span></a>, since it doesn&rsquo;t match
+itself but rather just <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>.  So, to match <span class="RktInBG"><span class="hspace"></span><span class="RktIn">a</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span>, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">c</span><span class="hspace"></span></span> in succession, we use the regexp pattern
+<span class="RktVal">#rx"a\\.c"</span>; the double <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> is an artifact of Racket
+strings, not the <a href="regexp.html#%28tech._regexp%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp</span></a> pattern itself.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp</a></span> function takes a string or byte string and
+produces a <a href="regexp.html#%28tech._regexp%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp</span></a> value. Use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp</a></span> when you construct
+a pattern to be matched against multiple strings, since a pattern is
+compiled to a <a href="regexp.html#%28tech._regexp%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp</span></a> value before it can be used in a match.
+The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._pregexp%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">pregexp</a></span> function is like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp</a></span>, but using the
+extended syntax. Regexp values as literals with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#rx</span><span class="hspace"></span></span> or
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#px</span><span class="hspace"></span></span> are compiled once and for all when they are read.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._regexp-quote%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-quote</a></span> function takes an arbitrary string and
+returns a string for a pattern that matches exactly the original
+string. In particular, characters in the input string that could serve
+as regexp metacharacters are escaped with a backslash, so that they
+safely match only themselves.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._regexp-quote%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-quote</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"cons"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"cons"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._regexp-quote%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-quote</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"list?"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"list\\?"</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._regexp-quote%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-quote</a></span> function is useful when building a composite
+<a href="regexp.html#%28tech._regexp%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp</span></a> from a mix of <a href="regexp.html#%28tech._regexp%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp</span></a> strings and verbatim strings.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="regexp.html" title="backward to &quot;9 Regular Expressions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="regexp.html" title="up to &quot;9 Regular Expressions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="regexp-match.html" title="forward to &quot;9.2 Matching Regexp Patterns&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-match.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-match.html
new file mode 100644
index 00000000..7e625a0b
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-match.html
@@ -0,0 +1,40 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>9.2&nbsp;Matching Regexp Patterns</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewselflink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">9.1&nbsp;</td><td><a href="regexp-intro.html" class="tocviewlink" data-pltdoc="x">Writing Regexp Patterns</a></td></tr><tr><td align="right">9.2&nbsp;</td><td><a href="regexp-match.html" class="tocviewselflink" data-pltdoc="x">Matching Regexp Patterns</a></td></tr><tr><td align="right">9.3&nbsp;</td><td><a href="regexp-assert.html" class="tocviewlink" data-pltdoc="x">Basic Assertions</a></td></tr><tr><td align="right">9.4&nbsp;</td><td><a href="regexp-chars.html" class="tocviewlink" data-pltdoc="x">Characters and Character Classes</a></td></tr><tr><td align="right">9.5&nbsp;</td><td><a href="regexp-quant.html" class="tocviewlink" data-pltdoc="x">Quantifiers</a></td></tr><tr><td align="right">9.6&nbsp;</td><td><a href="regexp-clusters.html" class="tocviewlink" data-pltdoc="x">Clusters</a></td></tr><tr><td align="right">9.7&nbsp;</td><td><a href="regexp-alternation.html" class="tocviewlink" data-pltdoc="x">Alternation</a></td></tr><tr><td align="right">9.8&nbsp;</td><td><a href="Backtracking.html" class="tocviewlink" data-pltdoc="x">Backtracking</a></td></tr><tr><td align="right">9.9&nbsp;</td><td><a href="Looking_Ahead_and_Behind.html" class="tocviewlink" data-pltdoc="x">Looking Ahead and Behind</a></td></tr><tr><td align="right">9.10&nbsp;</td><td><a href="An_Extended_Example.html" class="tocviewlink" data-pltdoc="x">An Extended Example</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="regexp-intro.html" title="backward to &quot;9.1 Writing Regexp Patterns&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="regexp.html" title="up to &quot;9 Regular Expressions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="regexp-assert.html" title="forward to &quot;9.3 Basic Assertions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;regexp-match&quot;">9.2<tt>&nbsp;</tt><a name="(part._regexp-match)"></a>Matching Regexp Patterns</h4><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span> function takes a <a href="regexp.html#%28tech._regexp%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp</span></a>
+pattern and a <a href="regexp.html#%28tech._text._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">text string</span></a>, and it returns a match if the regexp
+matches (some part of) the <a href="regexp.html#%28tech._text._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">text string</span></a>, or <span class="RktVal">#f</span> if the regexp
+did not match the string. A successful match produces a list of
+<a name="(tech._index._pair)"></a><span style="font-style: italic">index pairs</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"brain"</span><span class="hspace">&nbsp;</span><span class="RktVal">"bird"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"needle"</span><span class="hspace">&nbsp;</span><span class="RktVal">"hay needle stack"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((4 . 10))</span></p></td></tr></table></blockquote></div></p><p>In the second example, the integers <span class="RktVal">4</span> and <span class="RktVal">10</span>
+identify the substring that was matched. The <span class="RktVal">4</span> is the
+starting (inclusive) index, and <span class="RktVal">10</span> the ending (exclusive)
+index of the matching substring:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._substring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">substring</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hay needle stack"</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="hspace">&nbsp;</span><span class="RktVal">10</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"needle"</span></p></td></tr></table></blockquote><p>In this first example, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span>&rsquo;s return list
+contains only one index pair, and that pair represents the entire
+substring matched by the regexp.  When we discuss <a href="regexp-clusters.html#%28tech._subpattern%29" class="techoutside" data-pltdoc="x"><span class="techinside">subpatterns</span></a>
+later, we will see how a single match operation can yield a list of
+<a href="regexp-clusters.html#%28tech._submatch%29" class="techoutside" data-pltdoc="x"><span class="techinside">submatch</span></a>es.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span> function takes optional third and
+fourth arguments that specify the indices of the <a href="regexp.html#%28tech._text._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">text string</span></a> within
+which the matching should take place.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"needle"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktVal">"his needle stack -- my needle stack -- her needle stack"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktVal">20</span><span class="hspace">&nbsp;</span><span class="RktVal">39</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'((23 . 29))</span></p></td></tr></table></blockquote><p>Note that the returned indices are still reckoned relative to the full
+<a href="regexp.html#%28tech._text._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">text string</span></a>.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span> function is like
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span>, but instead of returning index pairs,
+it returns the matching substrings:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"brain"</span><span class="hspace">&nbsp;</span><span class="RktVal">"bird"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"needle"</span><span class="hspace">&nbsp;</span><span class="RktVal">"hay needle stack"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("needle")</span></p></td></tr></table></blockquote><p>When <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span> is used with byte-string regexp, the result
+is a matching byte substring:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx#"needle"</span><span class="hspace">&nbsp;</span><span class="RktVal">#"hay needle stack"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#"needle")</span></p></td></tr></table></blockquote><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>A byte-string regexp can be applied to a string, and a
+string regexp can be applied to a byte string. In both
+cases, the result is a byte string. Internally, all
+regexp matching is in terms of bytes, and a string regexp
+is expanded to a regexp that matches UTF-8 encodings of
+characters. For maximum efficiency, use byte-string
+matching instead of string, since matching bytes directly
+avoids UTF-8 encodings.</p></blockquote></blockquote></blockquote><p>If you have data that is in a port, there&rsquo;s no need to first read it
+into a string. Functions like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span> can match on the
+port directly:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pipeports.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-pipe%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-pipe</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"hay needle stack"</span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=port-ops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._close-output-port%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">close-output-port</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx#"needle"</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#"needle")</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match?</a></span> function is like
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span>, but simply returns a boolean
+indicating whether the match succeeded:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"brain"</span><span class="hspace">&nbsp;</span><span class="RktVal">"bird"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"needle"</span><span class="hspace">&nbsp;</span><span class="RktVal">"hay needle stack"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._regexp-split%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-split</a></span> function takes two arguments, a
+<a href="regexp.html#%28tech._regexp%29" class="techoutside" data-pltdoc="x"><span class="techinside">regexp</span></a> pattern and a text string, and it returns a list of
+substrings of the text string; the pattern identifies the delimiter
+separating the substrings.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._regexp-split%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-split</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx":"</span><span class="hspace">&nbsp;</span><span class="RktVal">"/bin:/usr/bin:/usr/bin/X11:/usr/local/bin"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("/bin" "/usr/bin" "/usr/bin/X11" "/usr/local/bin")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._regexp-split%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-split</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx" "</span><span class="hspace">&nbsp;</span><span class="RktVal">"pea soup"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("pea" "soup")</span></p></td></tr></table></blockquote><p>If the first argument matches empty strings, then the list of all the
+single-character substrings is returned.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._regexp-split%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-split</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx""</span><span class="hspace">&nbsp;</span><span class="RktVal">"smithereens"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("" "s" "m" "i" "t" "h" "e" "r" "e" "e" "n" "s" "")</span></p></td></tr></table></blockquote><p>Thus, to identify one-or-more spaces as the delimiter, take care to
+use the regexp <span class="RktVal">#rx" +"</span>, not <span class="RktVal">#rx" *"</span>.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._regexp-split%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-split</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx" +"</span><span class="hspace">&nbsp;</span><span class="RktVal">"split pea</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">soup"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("split" "pea" "soup")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._regexp-split%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-split</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx" *"</span><span class="hspace">&nbsp;</span><span class="RktVal">"split pea</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">soup"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("" "s" "p" "l" "i" "t" "" "p" "e" "a" "" "s" "o" "u" "p" "")</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-replace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-replace</a></span> function replaces the matched portion of
+the text string by another string.  The first argument is the pattern,
+the second the text string, and the third is either the string to be
+inserted or a procedure to convert matches to the insert string.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-replace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-replace</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"te"</span><span class="hspace">&nbsp;</span><span class="RktVal">"liberte"</span><span class="hspace">&nbsp;</span><span class="RktVal">"ty"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"liberty"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-replace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-replace</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"."</span><span class="hspace">&nbsp;</span><span class="RktVal">"racket"</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-upcase%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-upcase</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Racket"</span></p></td></tr></table></blockquote><p>If the pattern doesn&rsquo;t occur in the text string, the returned string
+is identical to the text string.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._regexp-replace%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-replace*</a></span> function replaces <span class="emph">all</span> matches in
+the text string by the insert string:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._regexp-replace%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-replace*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"te"</span><span class="hspace">&nbsp;</span><span class="RktVal">"liberte egalite fraternite"</span><span class="hspace">&nbsp;</span><span class="RktVal">"ty"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"liberty egality fratyrnity"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._regexp-replace%252A%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-replace*</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"[ds]"</span><span class="hspace">&nbsp;</span><span class="RktVal">"drracket"</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-upcase%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-upcase</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Drracket"</span></p></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="regexp-intro.html" title="backward to &quot;9.1 Writing Regexp Patterns&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="regexp.html" title="up to &quot;9 Regular Expressions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="regexp-assert.html" title="forward to &quot;9.3 Basic Assertions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-quant.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-quant.html
new file mode 100644
index 00000000..aa72e09d
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp-quant.html
@@ -0,0 +1,26 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>9.5&nbsp;Quantifiers</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewselflink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">9.1&nbsp;</td><td><a href="regexp-intro.html" class="tocviewlink" data-pltdoc="x">Writing Regexp Patterns</a></td></tr><tr><td align="right">9.2&nbsp;</td><td><a href="regexp-match.html" class="tocviewlink" data-pltdoc="x">Matching Regexp Patterns</a></td></tr><tr><td align="right">9.3&nbsp;</td><td><a href="regexp-assert.html" class="tocviewlink" data-pltdoc="x">Basic Assertions</a></td></tr><tr><td align="right">9.4&nbsp;</td><td><a href="regexp-chars.html" class="tocviewlink" data-pltdoc="x">Characters and Character Classes</a></td></tr><tr><td align="right">9.5&nbsp;</td><td><a href="regexp-quant.html" class="tocviewselflink" data-pltdoc="x">Quantifiers</a></td></tr><tr><td align="right">9.6&nbsp;</td><td><a href="regexp-clusters.html" class="tocviewlink" data-pltdoc="x">Clusters</a></td></tr><tr><td align="right">9.7&nbsp;</td><td><a href="regexp-alternation.html" class="tocviewlink" data-pltdoc="x">Alternation</a></td></tr><tr><td align="right">9.8&nbsp;</td><td><a href="Backtracking.html" class="tocviewlink" data-pltdoc="x">Backtracking</a></td></tr><tr><td align="right">9.9&nbsp;</td><td><a href="Looking_Ahead_and_Behind.html" class="tocviewlink" data-pltdoc="x">Looking Ahead and Behind</a></td></tr><tr><td align="right">9.10&nbsp;</td><td><a href="An_Extended_Example.html" class="tocviewlink" data-pltdoc="x">An Extended Example</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="regexp-chars.html" title="backward to &quot;9.4 Characters and Character Classes&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="regexp.html" title="up to &quot;9 Regular Expressions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="regexp-clusters.html" title="forward to &quot;9.6 Clusters&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;regexp-quant&quot;">9.5<tt>&nbsp;</tt><a name="(part._regexp-quant)"></a>Quantifiers</h4><p>The <a name="(tech._quantifier)"></a><span style="font-style: italic">quantifiers</span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">*</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span>, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">?</span><span class="hspace"></span></span>
+match respectively: zero or more, one or more, and zero or one
+instances of the preceding subpattern.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"c[ad]*r"</span><span class="hspace">&nbsp;</span><span class="RktVal">"cadaddadddr"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((0 . 11))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"c[ad]*r"</span><span class="hspace">&nbsp;</span><span class="RktVal">"cr"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((0 . 2))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"c[ad]+r"</span><span class="hspace">&nbsp;</span><span class="RktVal">"cadaddadddr"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((0 . 11))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"c[ad]+r"</span><span class="hspace">&nbsp;</span><span class="RktVal">"cr"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"c[ad]?r"</span><span class="hspace">&nbsp;</span><span class="RktVal">"cadaddadddr"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"c[ad]?r"</span><span class="hspace">&nbsp;</span><span class="RktVal">"cr"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((0 . 2))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match-positions%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match-positions</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"c[ad]?r"</span><span class="hspace">&nbsp;</span><span class="RktVal">"car"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'((0 . 3))</span></p></td></tr></table></blockquote><p>In <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#px</span><span class="hspace"></span></span> syntax, you can use braces to specify much
+finer-tuned quantification than is possible with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">*</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">?</span><span class="hspace"></span></span>:</p><ul><li><p>The quantifier <span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span><span style="font-style: italic">m</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span> matches
+<span class="emph">exactly</span> <span style="font-style: italic">m</span> instances of the preceding
+<a href="regexp-clusters.html#%28tech._subpattern%29" class="techoutside" data-pltdoc="x"><span class="techinside">subpattern</span></a>; <span style="font-style: italic">m</span> must be a nonnegative integer.</p></li><li><p>The quantifier
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span><span style="font-style: italic">m</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">,</span><span class="hspace"></span></span><span style="font-style: italic">n</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span> matches
+at least <span style="font-style: italic">m</span> and at most <span style="font-style: italic">n</span> instances.  <span class="RktInBG"><span class="hspace"></span><span class="RktIn">m</span><span class="hspace"></span></span>
+and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">n</span><span class="hspace"></span></span> are nonnegative integers with <span style="font-style: italic">m</span> less or
+equal to <span style="font-style: italic">n</span>.  You may omit either or both numbers, in
+which case <span style="font-style: italic">m</span> defaults to <span style="font-style: italic"></span>0<span style="font-style: italic"></span> and <span style="font-style: italic">n</span> to
+infinity.</p></li></ul><p>It is evident that <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">?</span><span class="hspace"></span></span> are abbreviations for
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">{1,}</span><span class="hspace"></span></span> and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">{0,1}</span><span class="hspace"></span></span> respectively, and <span class="RktInBG"><span class="hspace"></span><span class="RktIn">*</span><span class="hspace"></span></span>
+abbreviates <span class="RktInBG"><span class="hspace"></span><span class="RktIn">{,}</span><span class="hspace"></span></span>, which is the same as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">{0,}</span><span class="hspace"></span></span>.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"[aeiou]{3}"</span><span class="hspace">&nbsp;</span><span class="RktVal">"vacuous"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("uou")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"[aeiou]{3}"</span><span class="hspace">&nbsp;</span><span class="RktVal">"evolve"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"[aeiou]{2,3}"</span><span class="hspace">&nbsp;</span><span class="RktVal">"evolve"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#px"[aeiou]{2,3}"</span><span class="hspace">&nbsp;</span><span class="RktVal">"zeugma"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("eu")</span></p></td></tr></table></blockquote><p>The quantifiers described so far are all <a name="(tech._greedy)"></a><span style="font-style: italic">greedy</span>: they match
+the maximal number of instances that would still lead to an overall
+match for the full pattern.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"&lt;.*&gt;"</span><span class="hspace">&nbsp;</span><span class="RktVal">"&lt;tag1&gt; &lt;tag2&gt; &lt;tag3&gt;"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("&lt;tag1&gt; &lt;tag2&gt; &lt;tag3&gt;")</span></p></td></tr></table></blockquote><p>To make these quantifiers <a name="(tech._non._greedy)"></a><span style="font-style: italic">non-greedy</span>, append a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">?</span><span class="hspace"></span></span>
+to them.  Non-greedy quantifiers match the minimal number of instances
+needed to ensure an overall match.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#rx"&lt;.*?&gt;"</span><span class="hspace">&nbsp;</span><span class="RktVal">"&lt;tag1&gt; &lt;tag2&gt; &lt;tag3&gt;"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'("&lt;tag1&gt;")</span></p></td></tr></table></blockquote><p>The non-greedy quantifiers are <span class="RktInBG"><span class="hspace"></span><span class="RktIn">*?</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">+?</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">??</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span><span style="font-style: italic">m</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">}?</span><span class="hspace"></span></span>, and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span><span style="font-style: italic">m</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">,</span><span class="hspace"></span></span><span style="font-style: italic">n</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">}?</span><span class="hspace"></span></span>, although
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span><span style="font-style: italic">m</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">}?</span><span class="hspace"></span></span> is always the same as
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span><span style="font-style: italic">m</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span>. Note that the metacharacter
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">?</span><span class="hspace"></span></span> has two different uses, and both uses are represented in
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">??</span><span class="hspace"></span></span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="regexp-chars.html" title="backward to &quot;9.4 Characters and Character Classes&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="regexp.html" title="up to &quot;9 Regular Expressions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="regexp-clusters.html" title="forward to &quot;9.6 Clusters&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp.html
new file mode 100644
index 00000000..63a0de3f
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/regexp.html
@@ -0,0 +1,7 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>9&nbsp;Regular Expressions</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewselflink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>9&nbsp;</td><td><a href="regexp.html" class="tocviewselflink" data-pltdoc="x">Regular Expressions</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">9.1&nbsp;</td><td><a href="regexp-intro.html" class="tocviewlink" data-pltdoc="x">Writing Regexp Patterns</a></td></tr><tr><td align="right">9.2&nbsp;</td><td><a href="regexp-match.html" class="tocviewlink" data-pltdoc="x">Matching Regexp Patterns</a></td></tr><tr><td align="right">9.3&nbsp;</td><td><a href="regexp-assert.html" class="tocviewlink" data-pltdoc="x">Basic Assertions</a></td></tr><tr><td align="right">9.4&nbsp;</td><td><a href="regexp-chars.html" class="tocviewlink" data-pltdoc="x">Characters and Character Classes</a></td></tr><tr><td align="right">9.5&nbsp;</td><td><a href="regexp-quant.html" class="tocviewlink" data-pltdoc="x">Quantifiers</a></td></tr><tr><td align="right">9.6&nbsp;</td><td><a href="regexp-clusters.html" class="tocviewlink" data-pltdoc="x">Clusters</a></td></tr><tr><td align="right">9.7&nbsp;</td><td><a href="regexp-alternation.html" class="tocviewlink" data-pltdoc="x">Alternation</a></td></tr><tr><td align="right">9.8&nbsp;</td><td><a href="Backtracking.html" class="tocviewlink" data-pltdoc="x">Backtracking</a></td></tr><tr><td align="right">9.9&nbsp;</td><td><a href="Looking_Ahead_and_Behind.html" class="tocviewlink" data-pltdoc="x">Looking Ahead and Behind</a></td></tr><tr><td align="right">9.10&nbsp;</td><td><a href="An_Extended_Example.html" class="tocviewlink" data-pltdoc="x">An Extended Example</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="io-patterns.html" title="backward to &quot;8.6 I/O Patterns&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="regexp-intro.html" title="forward to &quot;9.1 Writing Regexp Patterns&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;regexp&quot;">9<tt>&nbsp;</tt><a name="(part._regexp)"></a>Regular Expressions</h3><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>This chapter is a modified version of [<a href="doc-bibliography.html#%28cite._.Sitaram05%29" data-pltdoc="x">Sitaram05</a>].</p></blockquote></blockquote></blockquote><p>A <a name="(tech._regexp)"></a><span style="font-style: italic">regexp</span> value encapsulates a pattern that is described by a
+string or <a href="bytestrings.html#%28tech._byte._string%29" class="techoutside" data-pltdoc="x"><span class="techinside">byte string</span></a>.  The regexp matcher tries to match this
+pattern against (a portion of) another string or byte string, which we
+will call the <a name="(tech._text._string)"></a><span style="font-style: italic">text string</span>, when you call functions like
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._regexp-match%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">regexp-match</a></span>.  The text string is treated as raw text, and
+not as a pattern.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-intro.html" class="toclink" data-pltdoc="x">9.1<span class="hspace">&nbsp;</span>Writing Regexp Patterns</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-match.html" class="toclink" data-pltdoc="x">9.2<span class="hspace">&nbsp;</span>Matching Regexp Patterns</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-assert.html" class="toclink" data-pltdoc="x">9.3<span class="hspace">&nbsp;</span>Basic Assertions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-chars.html" class="toclink" data-pltdoc="x">9.4<span class="hspace">&nbsp;</span>Characters and Character Classes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-chars.html#%28part._.Some_.Frequently_.Used_.Character_.Classes%29" class="toclink" data-pltdoc="x">9.4.1<span class="hspace">&nbsp;</span>Some Frequently Used Character Classes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-chars.html#%28part._.P.O.S.I.X_character_classes%29" class="toclink" data-pltdoc="x">9.4.2<span class="hspace">&nbsp;</span>POSIX character classes</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-quant.html" class="toclink" data-pltdoc="x">9.5<span class="hspace">&nbsp;</span>Quantifiers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-clusters.html" class="toclink" data-pltdoc="x">9.6<span class="hspace">&nbsp;</span>Clusters</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-clusters.html#%28part._.Backreferences%29" class="toclink" data-pltdoc="x">9.6.1<span class="hspace">&nbsp;</span>Backreferences</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-clusters.html#%28part._.Non-capturing_.Clusters%29" class="toclink" data-pltdoc="x">9.6.2<span class="hspace">&nbsp;</span>Non-capturing Clusters</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-clusters.html#%28part._regexp-cloister%29" class="toclink" data-pltdoc="x">9.6.3<span class="hspace">&nbsp;</span>Cloisters</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="regexp-alternation.html" class="toclink" data-pltdoc="x">9.7<span class="hspace">&nbsp;</span>Alternation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Backtracking.html" class="toclink" data-pltdoc="x">9.8<span class="hspace">&nbsp;</span>Backtracking</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Looking_Ahead_and_Behind.html" class="toclink" data-pltdoc="x">9.9<span class="hspace">&nbsp;</span>Looking Ahead and Behind</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Looking_Ahead_and_Behind.html#%28part._.Lookahead%29" class="toclink" data-pltdoc="x">9.9.1<span class="hspace">&nbsp;</span>Lookahead</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Looking_Ahead_and_Behind.html#%28part._.Lookbehind%29" class="toclink" data-pltdoc="x">9.9.2<span class="hspace">&nbsp;</span>Lookbehind</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="An_Extended_Example.html" class="toclink" data-pltdoc="x">9.10<span class="hspace">&nbsp;</span>An Extended Example</a></p></td></tr></table><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=regexp.html&amp;version=8.6" class="Sq" data-pltdoc="x">Regular Expressions</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on regexps.</p></blockquote></blockquote></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="io-patterns.html" title="backward to &quot;8.6 I/O Patterns&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="regexp-intro.html" title="forward to &quot;9.1 Writing Regexp Patterns&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/running.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/running.html
new file mode 100644
index 00000000..7faf3d93
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/running.html
@@ -0,0 +1,6 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>21&nbsp;Running and Creating Executables</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewselflink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>21&nbsp;</td><td><a href="running.html" class="tocviewselflink" data-pltdoc="x">Running and Creating Executables</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">21.1&nbsp;</td><td><a href="racket.html" class="tocviewlink" data-pltdoc="x">Running <span class="stt">racket</span> and <span class="stt">gracket</span></a></td></tr><tr><td align="right">21.2&nbsp;</td><td><a href="scripts.html" class="tocviewlink" data-pltdoc="x">Scripts</a></td></tr><tr><td align="right">21.3&nbsp;</td><td><a href="exe.html" class="tocviewlink" data-pltdoc="x">Creating Stand-<wbr></wbr>Alone Executables</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="parallelism.html" title="backward to &quot;20 Parallelism&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="racket.html" title="forward to &quot;21.1 Running racket and gracket&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;running&quot;">21<tt>&nbsp;</tt><a name="(part._running)"></a>Running and Creating Executables</h3><p>While developing programs, many Racket programmers use the
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?tag=%28part._%28.%27%28lib._scribblings%2Fdrracket%2Fdrracket..scrbl%29.%27._.%27top.%27%29%29&amp;version=8.6" class="Sq" data-pltdoc="x">DrRacket</a> programming environment. To run a program without the
+development environment, use <span class="stt">racket</span> (for console-based
+programs) or <span class="stt">gracket</span> (for GUI programs). This chapter mainly
+explains how to run <span class="stt">racket</span> and <span class="stt">gracket</span>.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="racket.html" class="toclink" data-pltdoc="x">21.1<span class="hspace">&nbsp;</span>Running <span class="stt">racket</span> and <span class="stt">gracket</span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="racket.html#%28part._start-interactive-mode%29" class="toclink" data-pltdoc="x">21.1.1<span class="hspace">&nbsp;</span>Interactive Mode</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="racket.html#%28part._start-module-mode%29" class="toclink" data-pltdoc="x">21.1.2<span class="hspace">&nbsp;</span>Module Mode</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="racket.html#%28part._start-load-mode%29" class="toclink" data-pltdoc="x">21.1.3<span class="hspace">&nbsp;</span>Load Mode</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="scripts.html" class="toclink" data-pltdoc="x">21.2<span class="hspace">&nbsp;</span>Scripts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="scripts.html#%28part._.Unix_.Scripts%29" class="toclink" data-pltdoc="x">21.2.1<span class="hspace">&nbsp;</span>Unix Scripts</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="scripts.html#%28part._.Windows_.Batch_.Files%29" class="toclink" data-pltdoc="x">21.2.2<span class="hspace">&nbsp;</span>Windows Batch Files</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="exe.html" class="toclink" data-pltdoc="x">21.3<span class="hspace">&nbsp;</span>Creating Stand-Alone Executables</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="parallelism.html" title="backward to &quot;20 Parallelism&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="racket.html" title="forward to &quot;21.1 Running racket and gracket&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/scheme-forms.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/scheme-forms.html
new file mode 100644
index 00000000..6f1efbd7
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/scheme-forms.html
@@ -0,0 +1,5 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4&nbsp;Expressions and Definitions</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewselflink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewselflink" data-pltdoc="x">Expressions and Definitions</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="syntax-notation.html" class="tocviewlink" data-pltdoc="x">Notation</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="binding.html" class="tocviewlink" data-pltdoc="x">Identifiers and Binding</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Function Calls</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Functions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span></a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span></a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="conditionals.html" class="tocviewlink" data-pltdoc="x">Conditionals</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span></a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktVal">&rsquo;</span></a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="qq.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span> and <span class="RktVal">&lsquo;</span></a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Simple Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="parameterize.html" class="tocviewlink" data-pltdoc="x">Dynamic Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">parameterize</span></span></a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="void_undefined.html" title="backward to &quot;3.12 Void and Undefined&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="syntax-notation.html" title="forward to &quot;4.1 Notation&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;scheme-forms&quot;">4<tt>&nbsp;</tt><a name="(part._scheme-forms)"></a>Expressions and Definitions</h3><p>The <a href="to-scheme.html" data-pltdoc="x">Racket Essentials</a> chapter introduced some of Racket&rsquo;s syntactic
+forms: definitions, procedure applications, conditionals, and so
+on. This section provides more details on those forms, plus a few
+additional basic forms.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-notation.html" class="toclink" data-pltdoc="x">4.1<span class="hspace">&nbsp;</span>Notation</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="binding.html" class="toclink" data-pltdoc="x">4.2<span class="hspace">&nbsp;</span>Identifiers and Binding</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="application.html" class="toclink" data-pltdoc="x">4.3<span class="hspace">&nbsp;</span>Function Calls (Procedure Applications)</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="application.html#%28part._.Evaluation_.Order_and_.Arity%29" class="toclink" data-pltdoc="x">4.3.1<span class="hspace">&nbsp;</span>Evaluation Order and Arity</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="application.html#%28part._keyword-args%29" class="toclink" data-pltdoc="x">4.3.2<span class="hspace">&nbsp;</span>Keyword Arguments</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="application.html#%28part._apply%29" class="toclink" data-pltdoc="x">4.3.3<span class="hspace">&nbsp;</span>The <span class="RktSym"><span class="RktValLink">apply</span></span> Function</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="lambda.html" class="toclink" data-pltdoc="x">4.4<span class="hspace">&nbsp;</span>Functions (Procedures): <span class="RktSym"><span class="RktStxLink">lambda</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="lambda.html#%28part._rest-args%29" class="toclink" data-pltdoc="x">4.4.1<span class="hspace">&nbsp;</span>Declaring a Rest Argument</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="lambda.html#%28part._.Declaring_.Optional_.Arguments%29" class="toclink" data-pltdoc="x">4.4.2<span class="hspace">&nbsp;</span>Declaring Optional Arguments</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="lambda.html#%28part._lambda-keywords%29" class="toclink" data-pltdoc="x">4.4.3<span class="hspace">&nbsp;</span>Declaring Keyword Arguments</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="lambda.html#%28part._case-lambda%29" class="toclink" data-pltdoc="x">4.4.4<span class="hspace">&nbsp;</span>Arity-Sensitive Functions: <span class="RktSym"><span class="RktStxLink">case-lambda</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define.html" class="toclink" data-pltdoc="x">4.5<span class="hspace">&nbsp;</span>Definitions: <span class="RktSym"><span class="RktStxLink">define</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define.html#%28part._.Function_.Shorthand%29" class="toclink" data-pltdoc="x">4.5.1<span class="hspace">&nbsp;</span>Function Shorthand</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define.html#%28part._.Curried_.Function_.Shorthand%29" class="toclink" data-pltdoc="x">4.5.2<span class="hspace">&nbsp;</span>Curried Function Shorthand</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define.html#%28part._multiple-values%29" class="toclink" data-pltdoc="x">4.5.3<span class="hspace">&nbsp;</span>Multiple Values and <span class="RktSym"><span class="RktStxLink">define-values</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="define.html#%28part._intdefs%29" class="toclink" data-pltdoc="x">4.5.4<span class="hspace">&nbsp;</span>Internal Definitions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="let.html" class="toclink" data-pltdoc="x">4.6<span class="hspace">&nbsp;</span>Local Binding</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="let.html#%28part._.Parallel_.Binding__let%29" class="toclink" data-pltdoc="x">4.6.1<span class="hspace">&nbsp;</span>Parallel Binding: <span class="RktSym"><span class="RktStxLink">let</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="let.html#%28part._.Sequential_.Binding__let_%29" class="toclink" data-pltdoc="x">4.6.2<span class="hspace">&nbsp;</span>Sequential Binding: <span class="RktSym"><span class="RktStxLink">let*</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="let.html#%28part._.Recursive_.Binding__letrec%29" class="toclink" data-pltdoc="x">4.6.3<span class="hspace">&nbsp;</span>Recursive Binding: <span class="RktSym"><span class="RktStxLink">letrec</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="let.html#%28part._.Named_let%29" class="toclink" data-pltdoc="x">4.6.4<span class="hspace">&nbsp;</span>Named <span class="RktSym"><span class="RktStxLink">let</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="let.html#%28part._.Multiple_.Values__let-values__let_-values__letrec-values%29" class="toclink" data-pltdoc="x">4.6.5<span class="hspace">&nbsp;</span>Multiple Values: <span class="RktSym"><span class="RktStxLink">let-values</span></span>, <span class="RktSym"><span class="RktStxLink">let*-values</span></span>, <span class="RktSym"><span class="RktStxLink">letrec-values</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="conditionals.html" class="toclink" data-pltdoc="x">4.7<span class="hspace">&nbsp;</span>Conditionals</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="conditionals.html#%28part._.Simple_.Branching__if%29" class="toclink" data-pltdoc="x">4.7.1<span class="hspace">&nbsp;</span>Simple Branching: <span class="RktSym"><span class="RktStxLink">if</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="conditionals.html#%28part._and%2Bor%29" class="toclink" data-pltdoc="x">4.7.2<span class="hspace">&nbsp;</span>Combining Tests: <span class="RktSym"><span class="RktStxLink">and</span></span> and <span class="RktSym"><span class="RktStxLink">or</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="conditionals.html#%28part._cond%29" class="toclink" data-pltdoc="x">4.7.3<span class="hspace">&nbsp;</span>Chaining Tests: <span class="RktSym"><span class="RktStxLink">cond</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="begin.html" class="toclink" data-pltdoc="x">4.8<span class="hspace">&nbsp;</span>Sequencing</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="begin.html#%28part._.Effects_.Before__begin%29" class="toclink" data-pltdoc="x">4.8.1<span class="hspace">&nbsp;</span>Effects Before: <span class="RktSym"><span class="RktStxLink">begin</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="begin.html#%28part._.Effects_.After__begin0%29" class="toclink" data-pltdoc="x">4.8.2<span class="hspace">&nbsp;</span>Effects After: <span class="RktSym"><span class="RktStxLink">begin0</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="begin.html#%28part._when%2Bunless%29" class="toclink" data-pltdoc="x">4.8.3<span class="hspace">&nbsp;</span>Effects If...: <span class="RktSym"><span class="RktStxLink">when</span></span> and <span class="RktSym"><span class="RktStxLink">unless</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="set_.html" class="toclink" data-pltdoc="x">4.9<span class="hspace">&nbsp;</span>Assignment: <span class="RktSym"><span class="RktStxLink">set!</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="set_.html#%28part._using-set%21%29" class="toclink" data-pltdoc="x">4.9.1<span class="hspace">&nbsp;</span>Guidelines for Using Assignment</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="set_.html#%28part._.Multiple_.Values__set_-values%29" class="toclink" data-pltdoc="x">4.9.2<span class="hspace">&nbsp;</span>Multiple Values: <span class="RktSym"><span class="RktStxLink">set!-values</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="quote.html" class="toclink" data-pltdoc="x">4.10<span class="hspace">&nbsp;</span>Quoting: <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktVal">&rsquo;</span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="qq.html" class="toclink" data-pltdoc="x">4.11<span class="hspace">&nbsp;</span>Quasiquoting: <span class="RktSym"><span class="RktStxLink">quasiquote</span></span> and <span class="RktVal">&lsquo;</span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="case.html" class="toclink" data-pltdoc="x">4.12<span class="hspace">&nbsp;</span>Simple Dispatch: <span class="RktSym"><span class="RktStxLink">case</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="parameterize.html" class="toclink" data-pltdoc="x">4.13<span class="hspace">&nbsp;</span>Dynamic Binding: <span class="RktSym"><span class="RktStxLink">parameterize</span></span></a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="void_undefined.html" title="backward to &quot;3.12 Void and Undefined&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="syntax-notation.html" title="forward to &quot;4.1 Notation&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/scripts.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/scripts.html
new file mode 100644
index 00000000..bb0d2e05
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/scripts.html
@@ -0,0 +1,41 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>21.2&nbsp;Scripts</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewselflink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">21.1&nbsp;</td><td><a href="racket.html" class="tocviewlink" data-pltdoc="x">Running <span class="stt">racket</span> and <span class="stt">gracket</span></a></td></tr><tr><td align="right">21.2&nbsp;</td><td><a href="scripts.html" class="tocviewselflink" data-pltdoc="x">Scripts</a></td></tr><tr><td align="right">21.3&nbsp;</td><td><a href="exe.html" class="tocviewlink" data-pltdoc="x">Creating Stand-<wbr></wbr>Alone Executables</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>21.2&nbsp;</td><td><a href="scripts.html" class="tocviewselflink" data-pltdoc="x">Scripts</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">21.2.1&nbsp;</td><td><a href="scripts.html#%28part._.Unix_.Scripts%29" class="tocviewlink" data-pltdoc="x">Unix Scripts</a></td></tr><tr><td align="right">21.2.2&nbsp;</td><td><a href="scripts.html#%28part._.Windows_.Batch_.Files%29" class="tocviewlink" data-pltdoc="x">Windows Batch Files</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">21.2.1<tt>&nbsp;</tt></span><a href="scripts.html#%28part._.Unix_.Scripts%29" class="tocsubseclink" data-pltdoc="x">Unix Scripts</a></td></tr><tr><td><span class="tocsublinknumber">21.2.2<tt>&nbsp;</tt></span><a href="scripts.html#%28part._.Windows_.Batch_.Files%29" class="tocsubseclink" data-pltdoc="x">Windows Batch Files</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="racket.html" title="backward to &quot;21.1 Running racket and gracket&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;21 Running and Creating Executables&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="exe.html" title="forward to &quot;21.3 Creating Stand-Alone Executables&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;scripts&quot;">21.2<tt>&nbsp;</tt><a name="(part._scripts)"></a>Scripts</h4><p>Racket files can be turned into executable scripts on Unix and Mac
+OS.  On Windows, a compatibility layer like Cygwin support the
+same kind of scripts, or scripts can be implemented as batch files.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Unix_Scripts&quot;">21.2.1<tt>&nbsp;</tt><a name="(part._.Unix_.Scripts)"></a>Unix Scripts</h5><p>In a Unix environment (including Linux and Mac OS), a Racket file can
+be turned into an executable script using the shell&rsquo;s <a name="(idx._(gentag._8._(lib._scribblings/guide/guide..scrbl)))"></a><span class="stt">#!</span>
+convention. The first two characters of the file must be <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!</span><span class="hspace"></span></span>;
+the next character must be either a space or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">/</span><span class="hspace"></span></span>, and the
+remainder of the first line must be a command to execute the script. For
+some platforms, the total length of the first line is restricted to 32
+characters, and sometimes the space is required.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>Use <span class="RktMod">#lang</span> <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a> instead
+of <span class="RktMod">#lang</span> <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a> to produce scripts with a
+faster startup time.</p></blockquote></blockquote></blockquote><p>The simplest script format uses an absolute path to a <span class="stt">racket</span>
+executable followed by a module declaration. For example, if
+<span class="stt">racket</span> is installed in <span class="stt">"/usr/local/bin"</span>, then a file
+containing the following text acts as a &ldquo;hello world&rdquo; script:</p><p><table cellspacing="0" cellpadding="0" class="SVerbatim"><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">#! /usr/local/bin/racket</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">#lang racket/base</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">"Hello, world!"</span></p></td></tr></table></p><p>In particular, if the above is put into a file <span class="stt">"hello"</span> and
+the file is made executable (e.g., with <span class="stt">chmod a+x hello</span>), then
+typing <span class="stt">./hello</span> at the shell prompt produces the output
+<span class="stt">"Hello, world!"</span>.</p><p>The above script works because the operating system automatically puts
+the path to the script as the argument to the program started by the
+<span class="stt">#!</span> line, and because <span class="stt">racket</span> treats a single non-flag
+argument as a file containing a module to run.</p><p>Instead of specifying a complete path to the <span class="stt">racket</span>
+executable, a popular alternative is to require that <span class="stt">racket</span>
+is in the user&rsquo;s command path, and then &ldquo;trampoline&rdquo; using
+<span class="stt">/usr/bin/env</span>:</p><p><table cellspacing="0" cellpadding="0" class="SVerbatim"><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">#! /usr/bin/env racket</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">#lang racket/base</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">"Hello, world!"</span></p></td></tr></table></p><p>In either case, command-line arguments to a script are available via
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=runtime.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-command-line-arguments%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-command-line-arguments</a></span>:</p><p><table cellspacing="0" cellpadding="0" class="SVerbatim"><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">#! /usr/bin/env racket</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">#lang racket/base</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">(printf "Given arguments: ~s\n"</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="stt">(current-command-line-arguments))</span></p></td></tr></table></p><p>If the name of the script is needed, it is available via
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Filesystem.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._find-system-path%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">find-system-path</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">run-file</span><span class="RktPn">)</span>, instead of via
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=runtime.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-command-line-arguments%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-command-line-arguments</a></span><span class="RktPn">)</span>.</p><p>Usually, the best way to handle command-line arguments is to parse
+them using the <span class="RktSym">command-line</span> form provided by
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a>. The <span class="RktSym">command-line</span> form extracts
+command-line arguments from <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=runtime.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-command-line-arguments%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-command-line-arguments</a></span><span class="RktPn">)</span>
+by default:</p><p><table cellspacing="0" cellpadding="0" class="SVerbatim"><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">#! /usr/bin/env racket</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">#lang racket</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">(define verbose? (make-parameter #f))</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">(define greeting</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt"></span><span class="hspace">&nbsp;&nbsp;</span><span class="stt">(command-line</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt"></span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="stt">#:once-each</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt"></span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="stt">[("-v") "Verbose mode" (verbose? #t)]</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt"></span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="stt">#:args</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt"></span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="stt">(str) str))</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt"></span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">(printf "~a~a\n"</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="stt">greeting</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="stt">(if (verbose?) " to you, too!" ""))</span></p></td></tr></table></p><p>Try running the above script with the <span class="nobreak"><span class="stt">--help</span></span> flag to see what
+command-line arguments are allowed by the script.</p><p>An even more general trampoline uses <span class="stt">/bin/sh</span> plus some lines
+that are comments in one language and expressions in the other. This
+trampoline is more complicated, but it provides more control over
+command-line arguments to <span class="stt">racket</span>:</p><p><table cellspacing="0" cellpadding="0" class="SVerbatim"><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">#! /bin/sh</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">#|</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">exec racket -e '(printf "Running...\n")' -u "$0" ${1+"$@"}</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">|#</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">#lang racket/base</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">(printf "The above line of output had been produced via\n")</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">(printf "a use of the `-e' flag.\n")</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">(printf "Given arguments: ~s\n"</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="stt">(current-command-line-arguments))</span></p></td></tr></table></p><p>Note that <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#!</span><span class="hspace"></span></span> starts a line comment in Racket, and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#|</span><span class="hspace"></span></span>...<span class="RktInBG"><span class="hspace"></span><span class="RktIn">|#</span><span class="hspace"></span></span> forms a block comment. Meanwhile,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> also starts a shell-script comment, while <span class="stt">exec
+racket</span> aborts the shell script to start <span class="stt">racket</span>. That way,
+the script file turns out to be valid input to both <span class="stt">/bin/sh</span> and
+<span class="stt">racket</span>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Windows_Batch_Files&quot;">21.2.2<tt>&nbsp;</tt><a name="(part._.Windows_.Batch_.Files)"></a>Windows Batch Files</h5><p>A similar trick can be used to write Racket code in Windows
+<a name="(idx._(gentag._9._(lib._scribblings/guide/guide..scrbl)))"></a><span class="stt">.bat</span> batch files:</p><p><table cellspacing="0" cellpadding="0" class="SVerbatim"><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">; @echo off</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">; Racket.exe "%~f0" %*</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">; exit /b</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">#lang racket/base</span></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;</span><span class="stt">"Hello, world!"</span></p></td></tr></table></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="racket.html" title="backward to &quot;21.1 Running racket and gracket&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="running.html" title="up to &quot;21 Running and Creating Executables&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="exe.html" title="forward to &quot;21.3 Creating Stand-Alone Executables&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/serialization.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/serialization.html
new file mode 100644
index 00000000..50b6261e
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/serialization.html
@@ -0,0 +1,18 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>8.4&nbsp;Datatypes and Serialization</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewselflink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">8.1&nbsp;</td><td><a href="ports.html" class="tocviewlink" data-pltdoc="x">Varieties of Ports</a></td></tr><tr><td align="right">8.2&nbsp;</td><td><a href="default-ports.html" class="tocviewlink" data-pltdoc="x">Default Ports</a></td></tr><tr><td align="right">8.3&nbsp;</td><td><a href="read-write.html" class="tocviewlink" data-pltdoc="x">Reading and Writing Racket Data</a></td></tr><tr><td align="right">8.4&nbsp;</td><td><a href="serialization.html" class="tocviewselflink" data-pltdoc="x">Datatypes and Serialization</a></td></tr><tr><td align="right">8.5&nbsp;</td><td><a href="encodings.html" class="tocviewlink" data-pltdoc="x">Bytes, Characters, and Encodings</a></td></tr><tr><td align="right">8.6&nbsp;</td><td><a href="io-patterns.html" class="tocviewlink" data-pltdoc="x">I/<span class="mywbr"> &nbsp;</span>O Patterns</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="read-write.html" title="backward to &quot;8.3 Reading and Writing Racket Data&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="i_o.html" title="up to &quot;8 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="encodings.html" title="forward to &quot;8.5 Bytes, Characters, and Encodings&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;serialization&quot;">8.4<tt>&nbsp;</tt><a name="(part._serialization)"></a>Datatypes and Serialization</h4><p><a href="define-struct.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">Prefab</span></a> structure types (see <a href="define-struct.html#%28part._prefab-struct%29" data-pltdoc="x">Prefab Structure Types</a>)
+automatically support <a name="(tech._serialization)"></a><span style="font-style: italic">serialization</span>: they can be written to
+an output stream, and a copy can be read back in from an input stream:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">in</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pipeports.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-pipe%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-pipe</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#s</span><span class="RktVal">(</span><span class="RktVal">sprout</span><span class="hspace">&nbsp;</span><span class="RktVal">bean</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'#s(sprout bean)</span></p></td></tr></table></blockquote><p>Other structure types created by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span>, which offer
+more abstraction than <a href="define-struct.html#%28tech._prefab%29" class="techoutside" data-pltdoc="x"><span class="techinside">prefab</span></a> structure types, normally
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span> either using <span class="RktRes">#&lt;....&gt;</span> notation (for
+opaque structure types) or using <span class="RktRes">#(....)</span> vector
+notation (for transparent structure types). In neither case can the
+result be read back in as an instance of the structure type:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">#&lt;posn&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">in</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pipeports.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-pipe%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-pipe</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">pipe::1: read: bad syntax `#&lt;`</span></p></td></tr></table></blockquote><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">#(struct:posn 1 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">in</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pipeports.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-pipe%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-pipe</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">v</span></td></tr><tr><td><p><span class="RktRes">'#(struct:posn 1 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">posn?</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=vectors.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._vector%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">vector?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=serialization.html%23%2528form._%2528%2528lib._racket%252Fserialize..rkt%2529._serializable-struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">serializable-struct</a></span> form defines a structure type
+that can be <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=serialization.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fserialize..rkt%2529._serialize%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">serialize</a></span>d to a value that can be printed using
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span> and restored via <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span>. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=serialization.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fserialize..rkt%2529._serialize%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">serialize</a></span>d
+result can be <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=serialization.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fserialize..rkt%2529._deserialize%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">deserialize</a></span>d to get back an instance of the
+original structure type. The serialization form and functions are
+provided by the <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=serialization.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/serialize</span></a> library.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/serialize</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=serialization.html%23%2528form._%2528%2528lib._racket%252Fserialize..rkt%2529._serializable-struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">serializable-struct</a></span><span class="hspace">&nbsp;</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">#:transparent</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=serialization.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fserialize..rkt%2529._deserialize%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">deserialize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=serialization.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fserialize..rkt%2529._serialize%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">serialize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(posn 1 2)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=serialization.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fserialize..rkt%2529._serialize%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">serialize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">((3) 1 ((#f . deserialize-info:posn-v0)) 0 () () (0 1 2))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._define-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">in</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pipeports.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-pipe%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-pipe</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=serialization.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fserialize..rkt%2529._serialize%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">serialize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">posn</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">out</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=serialization.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fserialize..rkt%2529._deserialize%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">deserialize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span><span class="hspace">&nbsp;</span><span class="RktSym">in</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">(posn 1 2)</span></p></td></tr></table></blockquote></div></p><p>In addition to the names bound by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define-struct.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">struct</a></span>,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=serialization.html%23%2528form._%2528%2528lib._racket%252Fserialize..rkt%2529._serializable-struct%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">serializable-struct</a></span> binds an identifier with deserialization
+information, and it automatically <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span>s the
+deserialization identifier from a module context. This deserialization
+identifier is accessed reflectively when a value is deserialized.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="read-write.html" title="backward to &quot;8.3 Reading and Writing Racket Data&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="i_o.html" title="up to &quot;8 Input and Output&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="encodings.html" title="forward to &quot;8.5 Bytes, Characters, and Encodings&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/set_.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/set_.html
new file mode 100644
index 00000000..31017928
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/set_.html
@@ -0,0 +1,24 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.9&nbsp;Assignment: set!</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewselflink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="syntax-notation.html" class="tocviewlink" data-pltdoc="x">Notation</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="binding.html" class="tocviewlink" data-pltdoc="x">Identifiers and Binding</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Function Calls</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Functions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span></a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span></a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="conditionals.html" class="tocviewlink" data-pltdoc="x">Conditionals</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="set_.html" class="tocviewselflink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span></a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktVal">&rsquo;</span></a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="qq.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span> and <span class="RktVal">&lsquo;</span></a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Simple Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="parameterize.html" class="tocviewlink" data-pltdoc="x">Dynamic Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">parameterize</span></span></a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>4.9&nbsp;</td><td><a href="set_.html" class="tocviewselflink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span></a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.9.1&nbsp;</td><td><a href="set_.html#%28part._using-set%21%29" class="tocviewlink" data-pltdoc="x">Guidelines for Using Assignment</a></td></tr><tr><td align="right">4.9.2&nbsp;</td><td><a href="set_.html#%28part._.Multiple_.Values__set_-values%29" class="tocviewlink" data-pltdoc="x">Multiple Values:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">4.9.1<tt>&nbsp;</tt></span><a href="set_.html#%28part._using-set%21%29" class="tocsubseclink" data-pltdoc="x">Guidelines for Using Assignment</a></td></tr><tr><td><span class="tocsublinknumber">4.9.2<tt>&nbsp;</tt></span><a href="set_.html#%28part._.Multiple_.Values__set_-values%29" class="tocsubseclink" data-pltdoc="x">Multiple Values:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!-<wbr></wbr>values</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="begin.html" title="backward to &quot;4.8 Sequencing&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="quote.html" title="forward to &quot;4.10 Quoting: quote and '&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;set!&quot;">4.9<tt>&nbsp;</tt><a name="(part._set!)"></a>Assignment: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span></h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html&amp;version=8.6" class="Sq" data-pltdoc="x">Assignment: <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-values</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> also documents <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span>.</p></blockquote></blockquote></blockquote><p>Assign to a variable using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span>:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span> expression evaluates <span class="RktVar">expr</span> and changes
+<span class="RktVar">id</span> (which must be bound in the enclosing environment) to the
+resulting value. The result of the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span>  expression itself is
+<a href="void_undefined.html" class="RktModLink" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">greeted</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null</a></span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">greeted</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cons</a></span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktSym">greeted</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Hello, "</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"Athos"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hello, Athos"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"Porthos"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hello, Porthos"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"Aramis"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hello, Aramis"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">greeted</span></td></tr><tr><td><p><span class="RktRes">'("Aramis" "Porthos" "Athos")</span></p></td></tr></table></blockquote></div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-running-total</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">win</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-running-total</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lose</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-running-total</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">win</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">win</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">lose</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">win</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;using-set!&quot;">4.9.1<tt>&nbsp;</tt><a name="(part._using-set!)"></a>Guidelines for Using Assignment</h5><p>Although using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span> is sometimes appropriate, Racket style
+generally discourages the use of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span>. The following
+guidelines may help explain when using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span> is appropriate.</p><ul><li><p>As in any modern language, assigning to a shared identifier is no
+ substitute for passing an argument to a procedure or getting
+ its result.</p><p><div class="SIntrapara"><span style="font-weight: bold"><span style="font-style: italic">Really awful</span></span> example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktVal">"unknown"</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktVal">"unknown"</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">result</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Hello, "</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="hspace">&nbsp;</span><span class="RktVal">"John"</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">result</span></td></tr><tr><td><p><span class="RktRes">"Hello, John"</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara">Ok example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Hello, "</span><span class="hspace">&nbsp;</span><span class="RktSym">name</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"John"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hello, John"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">greet</span><span class="hspace">&nbsp;</span><span class="RktVal">"Anna"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"Hello, Anna"</span></p></td></tr></table></td></tr></table></blockquote></div></p></li><li><p>A sequence of assignments to a local variable is far inferior
+to nested bindings.</p><p><div class="SIntrapara"><span style="font-weight: bold">Bad</span> example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">tree</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym">tree</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktSym">tree</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">tree</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(((0 1 0) 2 (0 1 0)) 3 ((0 1 0) 2 (0 1 0)))</span></p></td></tr></table></blockquote></div></p><p><div class="SIntrapara">Ok example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktSym">tree</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktSym">tree</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">tree</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktSym">tree</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">tree</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(((0 1 0) 2 (0 1 0)) 3 ((0 1 0) 2 (0 1 0)))</span></p></td></tr></table></blockquote></div></p></li><li><p>Using assignment to accumulate results from an iteration is
+bad style. Accumulating through a loop argument is better.</p><p><div class="SIntrapara">Somewhat bad example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">sum</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._for-each%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">for-each</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">sum</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">6</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara">Ok example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">sum</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">lst</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._null%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">null?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">s</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">loop</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">sum</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">6</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara">Better (use an existing function) example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">sum</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=procedures.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._apply%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">apply</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">sum</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">6</span></p></td></tr></table></td></tr></table></blockquote></div></p><p><div class="SIntrapara">Good (a general approach) example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">sum</span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Ffold%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/fold</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">i</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=sequences.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._in-list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">in-list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">lst</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">i</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">sum</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">6</span></p></td></tr></table></td></tr></table></blockquote></div></p></li><li><p>For cases where stateful objects are necessary or appropriate,
+then implementing the object&rsquo;s state with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span> is
+fine.</p><p><div class="SIntrapara">Ok example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">next-number!</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._add1%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">add1</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">n</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">next-number!</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">next-number!</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">next-number!</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></td></tr></table></blockquote></div></p></li></ul><p>All else being equal, a program that uses no assignments or mutation
+is always preferable to one that uses assignments or mutation. While
+side effects are to be avoided, however, they should be used if the
+resulting code is significantly more readable or if it implements a
+significantly better algorithm.</p><p>The use of mutable values, such as vectors and hash tables, raises
+fewer suspicions about the style of a program than using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span>
+directly. Nevertheless, simply replacing <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span>s in a program
+with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=vectors.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._vector-set%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">vector-set!</a></span>s obviously does not improve the style of
+the program.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Multiple_Values__set_-values&quot;">4.9.2<tt>&nbsp;</tt><a name="(part._.Multiple_.Values__set_-values)"></a>Multiple Values: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._set%2521-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!-values</a></span></h5><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html&amp;version=8.6" class="Sq" data-pltdoc="x">Assignment: <span class="RktSym"><span class="RktStxLink">set!</span></span> and <span class="RktSym"><span class="RktStxLink">set!-values</span></span></a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> also documents <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._set%2521-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!-values</a></span>.</p></blockquote></blockquote></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._set%2521-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!-values</a></span> form assigns to multiple variables at once,
+given an expression that produces an appropriate number of values:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._set%2521-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>This form is equivalent to using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._let-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let-values</a></span> to receive
+multiple results from <span class="RktVar">expr</span>, and then assigning the results
+individually to the <span class="RktVar">id</span>s using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">game</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">w</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">win?</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktSym">win?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">w</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">w</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin0%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin0</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">w</span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">swap sides...</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._set%2521-values%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!-values</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">w</span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=values.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._values%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">values</a></span><span class="hspace">&nbsp;</span><span class="RktSym">l</span><span class="hspace">&nbsp;</span><span class="RktSym">w</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">game</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><p><span class="RktRes">0</span></p></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">game</span><span class="hspace">&nbsp;</span><span class="RktVal">#t</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">game</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></td></tr></table></blockquote></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="begin.html" title="backward to &quot;4.8 Sequencing&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="quote.html" title="forward to &quot;4.10 Quoting: quote and '&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/standards.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/standards.html
new file mode 100644
index 00000000..f6d9ebfd
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/standards.html
@@ -0,0 +1,31 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>23.2&nbsp;Standards</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewselflink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">23.1&nbsp;</td><td><a href="more-hash-lang.html" class="tocviewlink" data-pltdoc="x">More Rackets</a></td></tr><tr><td align="right">23.2&nbsp;</td><td><a href="standards.html" class="tocviewselflink" data-pltdoc="x">Standards</a></td></tr><tr><td align="right">23.3&nbsp;</td><td><a href="teaching-langs.html" class="tocviewlink" data-pltdoc="x">Teaching</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>23.2&nbsp;</td><td><a href="standards.html" class="tocviewselflink" data-pltdoc="x">Standards</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">23.2.1&nbsp;</td><td><a href="standards.html#%28part._r5rs%29" class="tocviewlink" data-pltdoc="x">R<span style="vertical-align: super; font-size: 80%">5</span>RS</a></td></tr><tr><td align="right">23.2.2&nbsp;</td><td><a href="standards.html#%28part._.R6.R.S%29" class="tocviewlink" data-pltdoc="x">R<span style="vertical-align: super; font-size: 80%">6</span>RS</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">23.2.1<tt>&nbsp;</tt></span><a href="standards.html#%28part._r5rs%29" class="tocsubseclink" data-pltdoc="x">R<span style="vertical-align: super; font-size: 80%">5</span>RS</a></td></tr><tr><td><span class="tocsublinknumber">23.2.2<tt>&nbsp;</tt></span><a href="standards.html#%28part._.R6.R.S%29" class="tocsubseclink" data-pltdoc="x">R<span style="vertical-align: super; font-size: 80%">6</span>RS</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="more-hash-lang.html" title="backward to &quot;23.1 More Rackets&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="dialects.html" title="up to &quot;23 Dialects of Racket and Scheme&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="teaching-langs.html" title="forward to &quot;23.3 Teaching&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;standards&quot;">23.2<tt>&nbsp;</tt><a name="(part._standards)"></a>Standards</h4><p>Standard dialects of Scheme include the ones defined by R<span style="vertical-align: super; font-size: 80%">5</span>RS and
+R<span style="vertical-align: super; font-size: 80%">6</span>RS.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;r5rs&quot;">23.2.1<tt>&nbsp;</tt><a name="(part._r5rs)"></a>R<span style="vertical-align: super; font-size: 80%">5</span>RS</h5><p>&ldquo;R<span style="vertical-align: super; font-size: 80%">5</span>RS&rdquo; stands for <a href="https://download.racket-lang.org/releases/8.6/doc/r5rs/r5rs-std/index.html">The
+Revised<span style="vertical-align: super; font-size: 80%">5</span> Report on the Algorithmic Language Scheme</a>, and
+it is currently the most widely implemented Scheme standard.</p><p>Racket tools in their default modes do not conform to R<span style="vertical-align: super; font-size: 80%">5</span>RS,
+mainly because Racket tools generally expect modules, and R<span style="vertical-align: super; font-size: 80%">5</span>RS
+does not define a module system. Typical single-file R<span style="vertical-align: super; font-size: 80%">5</span>RS programs
+can be converted to Racket programs by prefixing them with
+<a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="stt"> </span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=r5rs&amp;rel=r5rs-mod.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">r5rs</span></a>, but other Scheme
+systems do not recognize <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="stt"> </span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=r5rs&amp;rel=r5rs-mod.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">r5rs</span></a>. The <span class="stt">plt-r5rs</span> executable (see
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=r5rs&amp;rel=plt-r5rs.html&amp;version=8.6" class="Sq" data-pltdoc="x"><span class="stt">plt-r5rs</span></a>) more directly
+conforms to the R<span style="vertical-align: super; font-size: 80%">5</span>RS standard.</p><p>Aside from the module system, the syntactic forms and functions of
+R<span style="vertical-align: super; font-size: 80%">5</span>RS and Racket differ. Only simple R<span style="vertical-align: super; font-size: 80%">5</span>RS become Racket
+programs when prefixed with <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="stt"> </span><span class="RktSym">racket</span>, and
+relatively few Racket programs become R<span style="vertical-align: super; font-size: 80%">5</span>RS programs when a
+<a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> line is removed. Also, when mixing &ldquo;R<span style="vertical-align: super; font-size: 80%">5</span>RS modules&rdquo;
+with Racket modules, beware that R<span style="vertical-align: super; font-size: 80%">5</span>RS pairs correspond to
+Racket mutable pairs (as constructed with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=mpairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._mcons%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">mcons</a></span>).</p><p>See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=r5rs&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">R5RS: Legacy Scheme</a> for more
+information about running R<span style="vertical-align: super; font-size: 80%">5</span>RS programs with Racket.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;R6RS&quot;">23.2.2<tt>&nbsp;</tt><a name="(part._.R6.R.S)"></a>R<span style="vertical-align: super; font-size: 80%">6</span>RS</h5><p>&ldquo;R<span style="vertical-align: super; font-size: 80%">6</span>RS&rdquo; stands for <a href="https://download.racket-lang.org/releases/8.6/doc/r6rs/r6rs-std/index.html">The
+Revised<span style="vertical-align: super; font-size: 80%">6</span> Report on the Algorithmic Language Scheme</a>,
+which extends R<span style="vertical-align: super; font-size: 80%">5</span>RS with a module system that is similar to the
+Racket module system.</p><p>When an R<span style="vertical-align: super; font-size: 80%">6</span>RS library or top-level program is prefixed with
+<span class="RktMeta">#!</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=r6rs&amp;rel=r6rs-mod.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">r6rs</span></a> (which is valid R<span style="vertical-align: super; font-size: 80%">6</span>RS
+syntax), then it can also be used as a Racket program. This works
+because <span class="RktMeta">#!</span> in Racket is treated as a shorthand
+for <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a> followed by a space, so
+<span class="RktMeta">#!</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=r6rs&amp;rel=r6rs-mod.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">r6rs</span></a> selects the
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=r6rs&amp;rel=r6rs-mod.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">r6rs</span></a> module language. As with R<span style="vertical-align: super; font-size: 80%">5</span>RS, however, beware
+that the syntactic forms and functions of R<span style="vertical-align: super; font-size: 80%">6</span>RS differ from
+Racket, and R<span style="vertical-align: super; font-size: 80%">6</span>RS pairs are mutable pairs.</p><p>See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=r6rs&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">R6RS: Scheme</a> for more
+information about running R<span style="vertical-align: super; font-size: 80%">6</span>RS programs with Racket.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="more-hash-lang.html" title="backward to &quot;23.1 More Rackets&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="dialects.html" title="up to &quot;23 Dialects of Racket and Scheme&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="teaching-langs.html" title="forward to &quot;23.3 Teaching&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/strings.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/strings.html
new file mode 100644
index 00000000..be69709f
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/strings.html
@@ -0,0 +1,28 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.4&nbsp;Strings (Unicode)</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewselflink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="strings.html" class="tocviewselflink" data-pltdoc="x">Strings (Unicode)</a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Bytes and Byte Strings</a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="hash-tables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="void_undefined.html" class="tocviewlink" data-pltdoc="x">Void and Undefined</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="characters.html" title="backward to &quot;3.3 Characters&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="bytestrings.html" title="forward to &quot;3.5 Bytes and Byte Strings&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;strings&quot;">3.4<tt>&nbsp;</tt><a name="(part._strings)"></a>Strings (Unicode)</h4><p>A <a name="(tech._string)"></a><span style="font-style: italic">string</span> is a fixed-length array of
+<a href="characters.html" data-pltdoc="x">characters</a>. It prints using double quotes,
+where double quote and backslash characters within the string are
+escaped with backslashes. Other common string escapes are supported,
+including <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\n</span><span class="hspace"></span></span> for a linefeed, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\r</span><span class="hspace"></span></span> for a
+carriage return, octal escapes using <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span> followed by up
+to three octal digits, and hexadecimal escapes with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\u</span><span class="hspace"></span></span>
+(up to four digits).  Unprintable characters in a string are normally
+shown with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\u</span><span class="hspace"></span></span> when the string is printed.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528part._parse-string%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Reading Strings</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> documents the fine points of the syntax of strings.</p></blockquote></blockquote></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span> procedure directly writes the characters of a
+string to the current output port (see <a href="i_o.html" data-pltdoc="x">Input and Output</a>), in contrast
+to the string-constant syntax used to print a string result.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktVal">"Apple"</span></td></tr><tr><td><p><span class="RktRes">"Apple"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">"\u03BB"</span></td></tr><tr><td><p><span class="RktRes">"&#955;"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Apple</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a \"quoted\" thing"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">a "quoted" thing</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"two\nlines"</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktOut">two</span></p></td></tr><tr><td><p><span class="RktOut">lines</span></p></td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"\u03BB"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">&#955;</span></p></td></tr></table></blockquote></div></p><p>A string can be mutable or immutable; strings written directly as
+expressions are immutable, but most other strings are mutable. The
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-string</a></span> procedure creates a mutable string given a length
+and optional fill character. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-ref</a></span> procedure
+accesses a character from a string (with 0-based indexing); the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-set%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-set!</a></span>  procedure changes a character in a mutable
+string.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-ref</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#\A</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._make-string%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">make-string</a></span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="hspace">&nbsp;</span><span class="RktVal">#\.</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">s</span></td></tr><tr><td><p><span class="RktRes">"....."</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-set%2521%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">#\&#955;</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">s</span></td></tr><tr><td><p><span class="RktRes">"..&#955;.."</span></p></td></tr></table></blockquote></div></p><p>String ordering and case operations are generally
+<span style="font-style: italic">locale-independent</span>; that is, they work the same for all
+users. A few <span style="font-style: italic">locale-dependent</span> operations are provided that
+allow the way that strings are case-folded and sorted to depend on the
+end-user&rsquo;s locale. If you&rsquo;re sorting strings, for example, use
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3c%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string&lt;?</a></span> or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-ci%7E3c%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-ci&lt;?</a></span> if the sort result should be
+consistent across machines and users, but use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-locale%7E3c%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-locale&lt;?</a></span>
+or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-locale-ci%7E3c%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-locale-ci&lt;?</a></span> if the sort is purely to order strings
+for an end user.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3c%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string&lt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Banana"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-ci%7E3c%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-ci&lt;?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="hspace">&nbsp;</span><span class="RktVal">"Banana"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-upcase%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-upcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Stra&#223;e"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"STRASSE"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=parameters.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmore-scheme..rkt%2529._parameterize%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">parameterize</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=encodings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-locale%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-locale</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"C"</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-locale-upcase%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-locale-upcase</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Stra&#223;e"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"STRA&#223;E"</span></p></td></tr></table></blockquote></div></p><p>For working with plain ASCII, working with raw bytes, or
+encoding/decoding Unicode strings as bytes, use
+<a href="bytestrings.html" data-pltdoc="x">byte strings</a>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html&amp;version=8.6" class="Sq" data-pltdoc="x">Strings</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on strings and string procedures.</p></blockquote></blockquote></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="characters.html" title="backward to &quot;3.3 Characters&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="bytestrings.html" title="forward to &quot;3.5 Bytes and Byte Strings&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/stx-certs.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/stx-certs.html
new file mode 100644
index 00000000..e7df3d9f
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/stx-certs.html
@@ -0,0 +1,34 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>16.2.7&nbsp;Tainted Syntax</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.1&nbsp;</td><td><a href="pattern-macros.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Macros</a></td></tr><tr><td align="right">16.2&nbsp;</td><td><a href="proc-macros.html" class="tocviewselflink" data-pltdoc="x">General Macro Transformers</a></td></tr><tr><td align="right">16.3&nbsp;</td><td><a href="macro-module.html" class="tocviewlink" data-pltdoc="x">Module Instantiations and Visits</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>16.2&nbsp;</td><td><a href="proc-macros.html" class="tocviewlink" data-pltdoc="x">General Macro Transformers</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.2.1&nbsp;</td><td><a href="stx-obj.html" class="tocviewlink" data-pltdoc="x">Syntax Objects</a></td></tr><tr><td align="right">16.2.2&nbsp;</td><td><a href="macro-transformers.html" class="tocviewlink" data-pltdoc="x">Macro Transformer Procedures</a></td></tr><tr><td align="right">16.2.3&nbsp;</td><td><a href="syntax-case.html" class="tocviewlink" data-pltdoc="x">Mixing Patterns and Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">syntax-<wbr></wbr>case</span></span></a></td></tr><tr><td align="right">16.2.4&nbsp;</td><td><a href="with-syntax.html" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>syntax</span></span> and <span class="RktSym"><span class="RktValLink">generate-<wbr></wbr>temporaries</span></span></a></td></tr><tr><td align="right">16.2.5&nbsp;</td><td><a href="stx-phases.html" class="tocviewlink" data-pltdoc="x">Compile and Run-<wbr></wbr>Time Phases</a></td></tr><tr><td align="right">16.2.6&nbsp;</td><td><a href="phases.html" class="tocviewlink" data-pltdoc="x">General Phase Levels</a></td></tr><tr><td align="right">16.2.7&nbsp;</td><td><a href="stx-certs.html" class="tocviewselflink" data-pltdoc="x">Tainted Syntax</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="phases.html" title="backward to &quot;16.2.6 General Phase Levels&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="proc-macros.html" title="up to &quot;16.2 General Macro Transformers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="macro-module.html" title="forward to &quot;16.3 Module Instantiations and Visits&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;stx-certs&quot;">16.2.7<tt>&nbsp;</tt><a name="(part._stx-certs)"></a>Tainted Syntax</h5><p>Modules often contain definitions that are meant only for use within
+the same module and not exported with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span>. Still, a use
+of a macro defined in the module can expand into a reference of an
+unexported identifier. In general, such an identifier must not be
+extracted from the expanded expression and used in a different
+context, because using the identifier in a different context may break
+invariants of the macro&rsquo;s module.</p><p>For example, the following module exports a macro <span class="RktSym">go</span> that
+expands to a use of <span class="RktSym">unchecked-go</span>:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"m.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">go</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">unchecked-go</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">to avoid disaster, </span><span class="RktSym">n</span><span class="RktCmt"> must be a number</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">go</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">unchecked-go</span><span class="hspace">&nbsp;</span><span class="RktVal">8</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>If the reference to <span class="RktSym">unchecked-go</span> is extracted from the
+expansion of <span class="RktPn">(</span><span class="RktSym">go</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span>, then it might be inserted into a new
+expression, <span class="RktPn">(</span><span class="RktSym">unchecked-go</span><span class="stt"> </span><span class="RktVal">#f</span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span>, leading to disaster. The
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._datum-%7E3esyntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">datum-&gt;syntax</a></span> procedure can be used similarly to construct
+references to an unexported identifier, even when no macro expansion
+includes a reference to the identifier.</p><p>Ultimately, protection of a module&rsquo;s private bindings depends on
+changing the current <a href="code-inspectors_protect.html#%28tech._code._inspector%29" class="techoutside" data-pltdoc="x"><span class="techinside">code inspector</span></a> by setting the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=modprotect.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-code-inspector%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-code-inspector</a></span> parameter. <span class="refelem"><span class="refcolumn"><span class="refcontent">See also
+<a href="code-inspectors_protect.html" data-pltdoc="x">Code Inspectors for Trusted and Untrusted Code</a>.</span></span></span> That&rsquo;s because a code inspector
+controls access to a module&rsquo;s internal state through functions like
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Namespaces.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._module-%7E3enamespace%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">module-&gt;namespace</a></span>. The current code inspector also gates
+access to the <a href="protect-out.html#%28tech._protected%29" class="techoutside" data-pltdoc="x"><span class="techinside">protected</span></a> exports of unsafe modules like
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=unsafe.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/unsafe/ops</span></a>.</p><p>Since the result of macro expansion can be abused to gain access to
+protected bindings, macro functions like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxtrans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._local-expand%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">local-expand</a></span> are
+also <a href="protect-out.html#%28tech._protected%29" class="techoutside" data-pltdoc="x"><span class="techinside">protected</span></a>: references to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxtrans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._local-expand%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">local-expand</a></span> and similar
+are allowed only within modules that are declared while the original
+code inspector is the current code inspector. Functions like
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Expanding_Top-Level_Forms.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._expand%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">expand</a></span>, which are not used to implement macros but are used
+to inspect the result of macro expansion, are protected in a different
+way: the expansion result is <a name="(tech._tainted)"></a><span style="font-style: italic">tainted</span> so that it cannot be
+compiled or expanded again. More precisely, functions like
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Expanding_Top-Level_Forms.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._expand%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">expand</a></span> accept an optional inspector argument that determines
+whether the result is tainted, but the default value of the argument
+is <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=modprotect.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._current-code-inspector%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">current-code-inspector</a></span><span class="RktPn">)</span>.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>In previous versions of Racket, a macro was responsible
+for protecting expansion using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxcerts.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-protect%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-protect</a></span>. The use of
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxcerts.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-protect%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-protect</a></span> is no longer required or recommended.</p></blockquote></blockquote></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="phases.html" title="backward to &quot;16.2.6 General Phase Levels&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="proc-macros.html" title="up to &quot;16.2 General Macro Transformers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="macro-module.html" title="forward to &quot;16.3 Module Instantiations and Visits&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/stx-obj.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/stx-obj.html
new file mode 100644
index 00000000..65da23ea
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/stx-obj.html
@@ -0,0 +1,40 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>16.2.1&nbsp;Syntax Objects</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.1&nbsp;</td><td><a href="pattern-macros.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Macros</a></td></tr><tr><td align="right">16.2&nbsp;</td><td><a href="proc-macros.html" class="tocviewselflink" data-pltdoc="x">General Macro Transformers</a></td></tr><tr><td align="right">16.3&nbsp;</td><td><a href="macro-module.html" class="tocviewlink" data-pltdoc="x">Module Instantiations and Visits</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>16.2&nbsp;</td><td><a href="proc-macros.html" class="tocviewlink" data-pltdoc="x">General Macro Transformers</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.2.1&nbsp;</td><td><a href="stx-obj.html" class="tocviewselflink" data-pltdoc="x">Syntax Objects</a></td></tr><tr><td align="right">16.2.2&nbsp;</td><td><a href="macro-transformers.html" class="tocviewlink" data-pltdoc="x">Macro Transformer Procedures</a></td></tr><tr><td align="right">16.2.3&nbsp;</td><td><a href="syntax-case.html" class="tocviewlink" data-pltdoc="x">Mixing Patterns and Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">syntax-<wbr></wbr>case</span></span></a></td></tr><tr><td align="right">16.2.4&nbsp;</td><td><a href="with-syntax.html" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>syntax</span></span> and <span class="RktSym"><span class="RktValLink">generate-<wbr></wbr>temporaries</span></span></a></td></tr><tr><td align="right">16.2.5&nbsp;</td><td><a href="stx-phases.html" class="tocviewlink" data-pltdoc="x">Compile and Run-<wbr></wbr>Time Phases</a></td></tr><tr><td align="right">16.2.6&nbsp;</td><td><a href="phases.html" class="tocviewlink" data-pltdoc="x">General Phase Levels</a></td></tr><tr><td align="right">16.2.7&nbsp;</td><td><a href="stx-certs.html" class="tocviewlink" data-pltdoc="x">Tainted Syntax</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="proc-macros.html" title="backward to &quot;16.2 General Macro Transformers&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="proc-macros.html" title="up to &quot;16.2 General Macro Transformers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="macro-transformers.html" title="forward to &quot;16.2.2 Macro Transformer Procedures&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;stx-obj&quot;">16.2.1<tt>&nbsp;</tt><a name="(part._stx-obj)"></a>Syntax Objects</h5><p>The input and output of a macro transformer (i.e., source and
+replacement forms) are represented as <a name="(tech._syntax._object)"></a><span style="font-style: italic">syntax objects</span>. A
+syntax object contains symbols, lists, and constant values (such as
+numbers) that essentially correspond to the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span>d form of
+the expression. For example, a representation of the expression
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span> contains the symbol <span class="RktVal">'</span><span class="RktVal">+</span> and the numbers
+<span class="RktVal">1</span> and <span class="RktVal">2</span>, all in a list. In addition to this quoted
+content, a syntax object associates source-location and
+lexical-binding information with each part of the form. The
+source-location information is used when reporting syntax errors (for
+example), and the lexical-binding information allows the macro system
+to maintain lexical scope. To accommodate this extra information, the
+representation of the expression <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span> is not merely
+<span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">+</span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktVal">)</span>, but a packaging of <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">+</span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktVal">)</span> into a syntax
+object.</p><p>To create a literal syntax object, use the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax</a></span> form:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;syntax:eval:1:0 (+ 1 2)&gt;</span></p></td></tr></table></blockquote><p>In the same way that <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> abbreviates <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#'</span><span class="hspace"></span></span> abbreviates <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;syntax:eval:1:0 (+ 1 2)&gt;</span></p></td></tr></table></blockquote><p>A syntax object that contains just a symbol is an <a name="(tech._identifier._syntax._object)"></a><span style="font-style: italic">identifier
+syntax object</span>. Racket provides some additional operations specific to
+identifier syntax objects, including the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fstx..rkt%2529._identifier%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">identifier?</a></span>
+operation to detect identifiers. Most notably,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxcmp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._free-identifier%7E3d%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">free-identifier=?</a></span>  determines whether two identifiers refer
+to the same binding:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fstx..rkt%2529._identifier%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fstx..rkt%2529._identifier%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxcmp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._free-identifier%7E3d%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">free-identifier=?</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxcmp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._free-identifier%7E3d%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">free-identifier=?</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._only-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">only-in</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket/base</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktSym">also-car</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxcmp.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._free-identifier%7E3d%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">free-identifier=?</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">also-car</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote><p>To see the lists, symbols, numbers, etc<span class="Sendabbrev">.</span> within a syntax object, use
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-%7E3edatum%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-&gt;datum</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-%7E3edatum%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-&gt;datum</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(+ 1 2)</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-e%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-e</a></span> function is similar to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-%7E3edatum%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-&gt;datum</a></span>,
+but it unwraps a single layer of source-location and lexical-context
+information, leaving sub-forms that have their own information wrapped
+as syntax objects:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-e%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-e</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#&lt;syntax:eval:1:0 +&gt; #&lt;syntax:eval:1:0 1&gt; #&lt;syntax:eval:1:0 2&gt;)</span></p></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-e%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-e</a></span> function always leaves syntax-object wrappers
+around sub-forms that are represented via symbols, numbers, and other
+literal values. The only time it unwraps extra sub-forms is when
+unwrapping a pair, in which case the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._cdr%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">cdr</a></span> of the pair may be
+recursively unwrapped, depending on how the syntax object was
+constructed.</p><p>The opposite of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-%7E3edatum%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-&gt;datum</a></span> is, of course,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._datum-%7E3esyntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">datum-&gt;syntax</a></span>.  In addition to a datum like <span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">+</span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktVal">)</span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._datum-%7E3esyntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">datum-&gt;syntax</a></span> needs an existing syntax object to donate
+its lexical context, and optionally another syntax object to donate
+its source location:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._datum-%7E3esyntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">datum-&gt;syntax</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">lex</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">+</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktVal">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._srcloc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">srcloc</a></span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">#&lt;syntax:eval:1:0 (+ 1 2)&gt;</span></p></td></tr></table></blockquote><p>In the above example, the lexical context of <span class="RktRdr">#'</span><span class="RktSym">lex</span> is used
+for the new syntax object, while the source location of
+<span class="RktRdr">#'</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._srcloc%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">srcloc</a></span> is used.</p><p>When the second (i.e., the &ldquo;datum&rdquo;) argument to
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._datum-%7E3esyntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">datum-&gt;syntax</a></span> includes syntax objects, those syntax objects
+are preserved intact in the result. That is, deconstructing the result
+with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-e%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-e</a></span> eventually produces the syntax objects that
+were given to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._datum-%7E3esyntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">datum-&gt;syntax</a></span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="proc-macros.html" title="backward to &quot;16.2 General Macro Transformers&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="proc-macros.html" title="up to &quot;16.2 General Macro Transformers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="macro-transformers.html" title="forward to &quot;16.2.2 Macro Transformer Procedures&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/stx-phases.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/stx-phases.html
new file mode 100644
index 00000000..bfbecd5a
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/stx-phases.html
@@ -0,0 +1,65 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>16.2.5&nbsp;Compile and Run-Time Phases</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.1&nbsp;</td><td><a href="pattern-macros.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Macros</a></td></tr><tr><td align="right">16.2&nbsp;</td><td><a href="proc-macros.html" class="tocviewselflink" data-pltdoc="x">General Macro Transformers</a></td></tr><tr><td align="right">16.3&nbsp;</td><td><a href="macro-module.html" class="tocviewlink" data-pltdoc="x">Module Instantiations and Visits</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>16.2&nbsp;</td><td><a href="proc-macros.html" class="tocviewlink" data-pltdoc="x">General Macro Transformers</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.2.1&nbsp;</td><td><a href="stx-obj.html" class="tocviewlink" data-pltdoc="x">Syntax Objects</a></td></tr><tr><td align="right">16.2.2&nbsp;</td><td><a href="macro-transformers.html" class="tocviewlink" data-pltdoc="x">Macro Transformer Procedures</a></td></tr><tr><td align="right">16.2.3&nbsp;</td><td><a href="syntax-case.html" class="tocviewlink" data-pltdoc="x">Mixing Patterns and Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">syntax-<wbr></wbr>case</span></span></a></td></tr><tr><td align="right">16.2.4&nbsp;</td><td><a href="with-syntax.html" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>syntax</span></span> and <span class="RktSym"><span class="RktValLink">generate-<wbr></wbr>temporaries</span></span></a></td></tr><tr><td align="right">16.2.5&nbsp;</td><td><a href="stx-phases.html" class="tocviewselflink" data-pltdoc="x">Compile and Run-<wbr></wbr>Time Phases</a></td></tr><tr><td align="right">16.2.6&nbsp;</td><td><a href="phases.html" class="tocviewlink" data-pltdoc="x">General Phase Levels</a></td></tr><tr><td align="right">16.2.7&nbsp;</td><td><a href="stx-certs.html" class="tocviewlink" data-pltdoc="x">Tainted Syntax</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="with-syntax.html" title="backward to &quot;16.2.4 with-syntax and generate-temporaries&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="proc-macros.html" title="up to &quot;16.2 General Macro Transformers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="phases.html" title="forward to &quot;16.2.6 General Phase Levels&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;stx-phases&quot;">16.2.5<tt>&nbsp;</tt><a name="(part._stx-phases)"></a>Compile and Run-Time Phases</h5><p>As sets of macros get more complicated, you might want to write
+your own helper functions, like
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._generate-temporaries%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">generate-temporaries</a></span>. For example, to provide good
+syntax error messages, <span class="RktSym">swap</span>, <span class="RktSym">rotate</span>, and
+<span class="RktSym">define-cbr</span> all should check that certain sub-forms in
+the source form are identifiers. We could use a
+<span class="RktSym">check-ids</span> function to perform this checking everywhere:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check-ids</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">tmp</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">tmp</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">rotate</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">rotate</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check-ids</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">shift-to</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">c</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The <span class="RktSym">check-ids</span> function can use the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-%7E3elist%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-&gt;list</a></span>
+function to convert a syntax-object wrapping a list into a list
+of syntax objects:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check-ids</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktSym">forms</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._for-each%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">for-each</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">form</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._unless%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fstx..rkt%2529._identifier%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">form</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._raise-syntax-error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise-syntax-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"not an identifier"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">stx</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">form</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-%7E3elist%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">forms</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>If you define <span class="RktSym">swap</span> and <span class="RktSym">check-ids</span> in this way,
+however, it doesn&rsquo;t work:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">check-ids: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr></table></blockquote><p>The problem is that <span class="RktSym">check-ids</span> is defined as a run-time
+expression, but <span class="RktSym">swap</span> is trying to use it at compile time. In
+interactive mode, compile time and run time are interleaved, but they
+are not interleaved within the body of a module, and they are not
+interleaved across modules that are compiled ahead-of-time. To help
+make all of these modes treat code consistently, Racket separates the
+binding spaces for different phases.</p><p>To define a <span class="RktSym">check-ids</span> function that can be referenced at
+compile time, use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin-for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin-for-syntax</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin-for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin-for-syntax</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check-ids</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktSym">forms</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._for-each%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">for-each</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">form</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._unless%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fstx..rkt%2529._identifier%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">form</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._raise-syntax-error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise-syntax-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"not an identifier"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">stx</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">form</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-%7E3elist%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">forms</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>With this for-syntax definition, then <span class="RktSym">swap</span> works:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(2 1)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">eval:13:0: swap: not an identifier</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">at: 1</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in: (swap a 1)</span></p></td></tr></table></blockquote><p>When organizing a program into modules, you may want to put helper
+functions in one module to be used by macros that reside on other
+modules. In that case, you can write the helper function using
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span>:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"utils.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">check-ids</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check-ids</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktSym">forms</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._for-each%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">for-each</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">form</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._unless%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unless</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fstx..rkt%2529._identifier%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">form</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._raise-syntax-error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise-syntax-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"not an identifier"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">stx</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">form</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-%7E3elist%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktSym">forms</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>Then, in the module that implements macros, import the helper function
+using <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="stt"> </span><span class="RktVal">"utils.rkt"</span><span class="RktPn">)</span><span class="RktPn">)</span> instead of
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktVal">"utils.rkt"</span><span class="RktPn">)</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"utils.rkt"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">check-ids</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">tmp</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">tmp</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Since modules are separately compiled and cannot have circular
+dependencies, the <span class="stt">"utils.rkt"</span> module&rsquo;s run-time body can be
+compiled before compiling the module that implements
+<span class="RktSym">swap</span>.  Thus, the run-time definitions in
+<span class="stt">"utils.rkt"</span> can be used to implement <span class="RktSym">swap</span>, as long
+as they are explicitly shifted into compile time by <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="stt"> </span><span class="RktSym">....</span><span class="RktPn">)</span><span class="RktPn">)</span>.</p><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a> module provides <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span>,
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._generate-temporaries%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">generate-temporaries</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span>, and more
+for use in both the run-time and compile-time phases. That is why we
+can use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span> in the <span class="stt">racket</span> <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> both
+directly and in the right-hand side of a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span>
+form.</p><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a> module, in contrast, exports those
+bindings only in the run-time phase. If you change the module above
+that defines <span class="RktSym">swap</span> so that it uses the
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a> language instead of
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a>, then it no longer works. Adding
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="stt"> </span><span class="RktSym">racket/base</span><span class="RktPn">)</span><span class="RktPn">)</span> imports
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span> and more into the compile-time phase, so that the
+module works again.</p><p>Suppose that <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span> is used to define a local macro in
+the right-hand side of a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span> form. In that case,
+the right-hand side of the inner <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span> is in the
+<a name="(tech._meta._compile._phase._level)"></a><span style="font-style: italic">meta-compile phase level</span>, also known as <a name="(tech._phase._level._2)"></a><span style="font-style: italic">phase level
+2</span>. To import <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span> into that phase level, you would
+have to use <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="stt"> </span><span class="RktSym">racket/base</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span>
+or, equivalently, <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-meta%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-meta</a></span><span class="stt"> </span><span class="RktVal">2</span><span class="stt"> </span><span class="RktSym">racket/base</span><span class="RktPn">)</span><span class="RktPn">)</span>.  For example,</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">This</span><span class="hspace">&nbsp;</span><span class="RktCmt">provides</span><span class="hspace">&nbsp;</span><span class="RktCmt">the</span><span class="hspace">&nbsp;</span><span class="RktCmt">bindings</span><span class="hspace">&nbsp;</span><span class="RktCmt">for</span><span class="hspace">&nbsp;</span><span class="RktCmt">the</span><span class="hspace">&nbsp;</span><span class="RktCmt">definition</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">of</span><span class="hspace">&nbsp;</span><span class="RktCmt">shell-game.</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">racket/base</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">And</span><span class="hspace">&nbsp;</span><span class="RktCmt">this</span><span class="hspace">&nbsp;</span><span class="RktCmt">for</span><span class="hspace">&nbsp;</span><span class="RktCmt">the</span><span class="hspace">&nbsp;</span><span class="RktCmt">definition</span><span class="hspace">&nbsp;</span><span class="RktCmt">of</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktCmt">;;</span><span class="hspace">&nbsp;</span><span class="RktCmt">swap.</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">racket/base</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">shell-game</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">stx</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">stx</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">stx</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">a</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#'</a></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">tmp</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">a</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">a</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">b</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">tmp</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">stx</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">a</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">b</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">a</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#'</a></span><span class="RktSym">a</span><span class="RktPn">]</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">[</span><span class="RktSym">b</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#'</a></span><span class="RktSym">b</span><span class="RktPn">]</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">[</span><span class="RktSym">c</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#'</a></span><span class="RktSym">c</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._when%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">when</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">0</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._random%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">random</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">a</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._when%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">when</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">0</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._random%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">random</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">b</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=when_unless.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._when%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">when</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">=</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">0</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._random%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">random</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">a</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._quasisyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#`</a></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._unsyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#,</a></span><span class="RktSym">a</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._unsyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#,</a></span><span class="RktSym">b</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._unsyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#,</a></span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">shell-game</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">3</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">4</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">shell-game</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">3</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">4</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">shell-game</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">3</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">4</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr></table></blockquote><p>Negative phase levels also exist. If a macro uses a helper function
+that is imported <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span>, and if the helper function
+returns syntax-object constants generated by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax</a></span>, then
+identifiers in the syntax will need bindings at <a name="(tech._phase._level._1)"></a><span style="font-style: italic">phase level
+-1</span>, also known as the <a name="(tech._template._phase._level)"></a><span style="font-style: italic">template phase level</span>, to have any
+binding at the run-time phase level relative to the module that
+defines the macro.</p><p>For instance, the <span class="RktSym">swap-stx</span> helper function in the example below
+is not a syntax transformer&#8212;<wbr></wbr>it&rsquo;s just an ordinary function&#8212;<wbr></wbr>but it
+produces syntax objects that get spliced into the result of
+<span class="RktSym">shell-game</span>. Therefore, its containing <span class="RktSym">helper</span> submodule
+needs to be imported at <span class="RktSym">shell-game</span>&rsquo;s phase 1 with
+<span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="stt"> </span><span class="RktVal">'</span><span class="RktVal">helper</span><span class="RktPn">)</span><span class="RktPn">)</span>.</p><p>But from the perspective of <span class="RktSym">swap-stx</span>, its results will ultimately
+be evaluated at phase level -1, when the syntax
+returned by <span class="RktSym">shell-game</span> is evaluated. In other words, a negative phase
+level is a positive phase level from the opposite direction:
+<span class="RktSym">shell-game</span>&rsquo;s phase 1 is <span class="RktSym">swap-stx</span>&rsquo;s phase 0, so
+<span class="RktSym">shell-game</span>&rsquo;s phase 0 is <span class="RktSym">swap-stx</span>&rsquo;s phase -1.
+And that&rsquo;s why this example won&rsquo;t work&#8212;<wbr></wbr>the <span class="RktVal">'</span><span class="RktVal">helper</span> submodule
+has no bindings at phase -1.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">racket/base</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">helper</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">racket/base</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">swap-stx</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">swap-stx</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">a-stx</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">b-stx</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._quasisyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#`</a></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">tmp</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._unsyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#,</a></span><span class="RktSym">a-stx</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._unsyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#,</a></span><span class="RktSym">a-stx</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._unsyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#,</a></span><span class="RktSym">b-stx</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._unsyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#,</a></span><span class="RktSym">b-stx</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">tmp</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">'</a></span><span class="RktSym">helper</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">shell-game</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">stx</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">stx</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">a</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">b</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._quasisyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#`</a></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._unsyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#,</a></span><span class="RktPn">(</span><span class="RktSym">swap-stx</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#'</a></span><span class="RktSym">a</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#'</a></span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._unsyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#,</a></span><span class="RktPn">(</span><span class="RktSym">swap-stx</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#'</a></span><span class="RktSym">b</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#'</a></span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._unsyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#,</a></span><span class="RktPn">(</span><span class="RktSym">swap-stx</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#'</a></span><span class="RktSym">a</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#'</a></span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">a</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">b</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">x</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">y</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">z</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">shell-game</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">x</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">y</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr></table></blockquote><p>To repair this example, we add <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-template%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-template</a></span><span class="stt"> </span><span class="RktSym">racket/base</span><span class="RktPn">)</span><span class="RktPn">)</span>
+to the <span class="RktVal">'</span><span class="RktVal">helper</span> submodule.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">racket/base</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">helper</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">racket/base</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-template%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-template</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">racket/base</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktCmt">;</span><span class="hspace">&nbsp;</span><span class="RktCmt">binds</span><span class="hspace">&nbsp;</span><span class="RktCmt">`let`</span><span class="hspace">&nbsp;</span><span class="RktCmt">and</span><span class="hspace">&nbsp;</span><span class="RktCmt">`set!`</span><span class="hspace">&nbsp;</span><span class="RktCmt">at</span><span class="hspace">&nbsp;</span><span class="RktCmt">phase</span><span class="hspace">&nbsp;</span><span class="RktCmt">-1</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">swap-stx</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">swap-stx</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">a-stx</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">b-stx</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._quasisyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#`</a></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">tmp</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._unsyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#,</a></span><span class="RktSym">a-stx</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._unsyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#,</a></span><span class="RktSym">a-stx</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._unsyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#,</a></span><span class="RktSym">b-stx</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._unsyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#,</a></span><span class="RktSym">b-stx</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">tmp</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for-syntax</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">'</a></span><span class="RktSym">helper</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">shell-game</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">stx</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">stx</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">a</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">b</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._quasisyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#`</a></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=begin.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._begin%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">begin</a></span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._unsyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#,</a></span><span class="RktPn">(</span><span class="RktSym">swap-stx</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#'</a></span><span class="RktSym">a</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#'</a></span><span class="RktSym">b</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._unsyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#,</a></span><span class="RktPn">(</span><span class="RktSym">swap-stx</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#'</a></span><span class="RktSym">b</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#'</a></span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fqqstx..rkt%2529._unsyntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#,</a></span><span class="RktPn">(</span><span class="RktSym">swap-stx</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#'</a></span><span class="RktSym">a</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">#'</a></span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">a</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">b</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">c</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta">&#160;</span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">x</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">3</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">y</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">z</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktVal">5</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">shell-game</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">x</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">y</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">shell-game</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">x</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">y</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr><tr><td><span class="RktMeta"></span><span class="RktPn">(</span><span class="RktSym">shell-game</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">x</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">y</span><span class="RktMeta"></span><span class="hspace">&nbsp;</span><span class="RktMeta"></span><span class="RktSym">z</span><span class="RktPn">)</span><span class="RktMeta"></span></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="with-syntax.html" title="backward to &quot;16.2.4 with-syntax and generate-temporaries&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="proc-macros.html" title="up to &quot;16.2 General Macro Transformers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="phases.html" title="forward to &quot;16.2.6 General Phase Levels&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/symbols.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/symbols.html
new file mode 100644
index 00000000..99d50e9f
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/symbols.html
@@ -0,0 +1,28 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.6&nbsp;Symbols</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewselflink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings (Unicode)</a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Bytes and Byte Strings</a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="symbols.html" class="tocviewselflink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="hash-tables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="void_undefined.html" class="tocviewlink" data-pltdoc="x">Void and Undefined</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="bytestrings.html" title="backward to &quot;3.5 Bytes and Byte Strings&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="keywords.html" title="forward to &quot;3.7 Keywords&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;symbols&quot;">3.6<tt>&nbsp;</tt><a name="(part._symbols)"></a>Symbols</h4><p>A <a name="(tech._symbol)"></a><span style="font-style: italic">symbol</span> is an atomic value that prints like an identifier
+preceded with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span>.  An expression that starts with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span>
+and continues with an identifier produces a symbol value.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktVal">'</span><span class="RktVal">a</span></td></tr><tr><td><p><span class="RktRes">'a</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote></div></p><p>For any sequence of characters, exactly one corresponding symbol is
+<span style="font-style: italic">interned</span>; calling the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-%7E3esymbol%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-&gt;symbol</a></span> procedure, or
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Reading.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._read%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">read</a></span>ing a syntactic identifier, produces an interned
+symbol. Since interned symbols can be cheaply compared with
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span> (and thus <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eqv%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eqv?</a></span> or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span>), they serve
+as a convenient values to use for tags and enumerations.</p><p>Symbols are case-sensitive. By using a <span class="stt">#ci</span> prefix or in
+other ways, the reader can be made to case-fold character sequences to
+arrive at a symbol, but the reader preserves case by default.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-%7E3esymbol%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-&gt;symbol</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">b</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">A</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="stt">#ci</span><span class="RktVal">'A</span></td></tr><tr><td><p><span class="RktRes">'a</span></p></td></tr></table></blockquote></div></p><p>Any string (i.e., any character sequence) can be supplied to
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-%7E3esymbol%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-&gt;symbol</a></span> to obtain the corresponding symbol. For reader
+input, any character can appear directly in an identifier, except for
+whitespace and the following special characters:</p><p><span class="hspace">&nbsp;&nbsp;</span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span>
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span>
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">"</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">,</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">`</span><span class="hspace"></span></span>
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">;</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span></p><p>Actually, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> is disallowed only at the beginning of a symbol,
+and then only if not followed by <span class="RktInBG"><span class="hspace"></span><span class="RktIn">%</span><span class="hspace"></span></span>; otherwise, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> is
+allowed, too. Also, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">.</span><span class="hspace"></span></span> by itself is not a symbol.</p><p>Whitespace or special characters can be included in an identifier by
+quoting them with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span> or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span>. These quoting
+mechanisms are used in the printed form of identifiers that contain
+special characters or that might otherwise look like numbers.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-%7E3esymbol%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-&gt;symbol</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"one, two"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'|one, two|</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-%7E3esymbol%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-&gt;symbol</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"6"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'|6|</span></p></td></tr></table></blockquote></div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528part._parse-symbol%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Reading Symbols</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> documents the fine points of the syntax of symbols.</p></blockquote></blockquote></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span> function prints a symbol without a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span>
+prefix. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span> form of a symbol is the same as the
+corresponding string.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">Apple</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Apple</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">Apple</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">Apple</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._write%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">write</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">|6|</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">|6|</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">|6|</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">6</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._gensym%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">gensym</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-%7E3euninterned-symbol%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-&gt;uninterned-symbol</a></span> procedures
+generate fresh <span style="font-style: italic">uninterned</span> symbols that are not equal
+(according to <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span>) to any previously interned or uninterned
+symbol. Uninterned symbols are useful as fresh tags that cannot be
+confused with any other value.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._gensym%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">gensym</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">s</span></td></tr><tr><td><p><span class="RktRes">'g42</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">g42</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._eq%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">eq?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">a</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-%7E3euninterned-symbol%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-&gt;uninterned-symbol</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"a"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr></table></blockquote></div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=symbols.html&amp;version=8.6" class="Sq" data-pltdoc="x">Symbols</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on symbols.</p></blockquote></blockquote></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="bytestrings.html" title="backward to &quot;3.5 Bytes and Byte Strings&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="keywords.html" title="forward to &quot;3.7 Keywords&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/syntax-case.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/syntax-case.html
new file mode 100644
index 00000000..c79c799a
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/syntax-case.html
@@ -0,0 +1,32 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>16.2.3&nbsp;Mixing Patterns and Expressions: syntax-case</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.1&nbsp;</td><td><a href="pattern-macros.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Macros</a></td></tr><tr><td align="right">16.2&nbsp;</td><td><a href="proc-macros.html" class="tocviewselflink" data-pltdoc="x">General Macro Transformers</a></td></tr><tr><td align="right">16.3&nbsp;</td><td><a href="macro-module.html" class="tocviewlink" data-pltdoc="x">Module Instantiations and Visits</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>16.2&nbsp;</td><td><a href="proc-macros.html" class="tocviewlink" data-pltdoc="x">General Macro Transformers</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.2.1&nbsp;</td><td><a href="stx-obj.html" class="tocviewlink" data-pltdoc="x">Syntax Objects</a></td></tr><tr><td align="right">16.2.2&nbsp;</td><td><a href="macro-transformers.html" class="tocviewlink" data-pltdoc="x">Macro Transformer Procedures</a></td></tr><tr><td align="right">16.2.3&nbsp;</td><td><a href="syntax-case.html" class="tocviewselflink" data-pltdoc="x">Mixing Patterns and Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">syntax-<wbr></wbr>case</span></span></a></td></tr><tr><td align="right">16.2.4&nbsp;</td><td><a href="with-syntax.html" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>syntax</span></span> and <span class="RktSym"><span class="RktValLink">generate-<wbr></wbr>temporaries</span></span></a></td></tr><tr><td align="right">16.2.5&nbsp;</td><td><a href="stx-phases.html" class="tocviewlink" data-pltdoc="x">Compile and Run-<wbr></wbr>Time Phases</a></td></tr><tr><td align="right">16.2.6&nbsp;</td><td><a href="phases.html" class="tocviewlink" data-pltdoc="x">General Phase Levels</a></td></tr><tr><td align="right">16.2.7&nbsp;</td><td><a href="stx-certs.html" class="tocviewlink" data-pltdoc="x">Tainted Syntax</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="macro-transformers.html" title="backward to &quot;16.2.2 Macro Transformer Procedures&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="proc-macros.html" title="up to &quot;16.2 General Macro Transformers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="with-syntax.html" title="forward to &quot;16.2.4 with-syntax and generate-temporaries&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;syntax-case&quot;">16.2.3<tt>&nbsp;</tt><a name="(part._syntax-case)"></a>Mixing Patterns and Expressions: <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span></h5><p>The procedure generated by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span> internally uses
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-e%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-e</a></span> to deconstruct the given syntax object, and it uses
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._datum-%7E3esyntax%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">datum-&gt;syntax</a></span> to construct the result. The
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span> form doesn&rsquo;t provide a way to escape from
+pattern-matching and template-construction mode into an arbitrary
+Racket expression.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span> form lets you mix pattern matching, template
+construction, and arbitrary expressions:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktVar">stx-expr</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktVar">literal-id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktVar">pattern</span><span class="hspace">&nbsp;</span><span class="RktVar">expr</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></blockquote><p>Unlike <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span>, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span> form does not
+produce a procedure. Instead, it starts with a <span class="RktVar">stx-expr</span>
+expression that determines the syntax object to match against the
+<span class="RktVar">pattern</span>s. Also, each <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span> clause has a
+<span class="RktVar">pattern</span> and <span class="RktVar">expr</span>, instead of a <span class="RktVar">pattern</span>
+and <span class="RktVar">template</span>. Within an <span class="RktVar">expr</span>, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax</a></span>
+form&#8212;<wbr></wbr>usually abbreviated with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#'</span><span class="hspace"></span></span>&#8212;<wbr></wbr>shifts into
+template-construction mode; if the <span class="RktVar">expr</span> of a clause starts
+with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#'</span><span class="hspace"></span></span>, then we have something like a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span>
+form:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._syntax-%7E3edatum%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">syntax-&gt;datum</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">op</span><span class="hspace">&nbsp;</span><span class="RktSym">n1</span><span class="hspace">&nbsp;</span><span class="RktSym">n2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">n1</span><span class="hspace">&nbsp;</span><span class="RktSym">n2</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'(- 1 2)</span></p></td></tr></table></blockquote><p>We could write the <span class="RktSym">swap</span> macro using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span>
+instead of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._define-syntax-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-rule</a></span> or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-rules%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-rules</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">tmp</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">tmp</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>One advantage of using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span> is that we can provide
+better error reporting for <span class="RktSym">swap</span>. For example, with the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._define-syntax-rule%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax-rule</a></span> definition of <span class="RktSym">swap</span>, then
+<span class="RktPn">(</span><span class="RktSym">swap</span><span class="stt"> </span><span class="RktSym">x</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span> produces a syntax error in terms of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span>,
+because <span class="RktVal">2</span> is not an identifier. We can refine our
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span> implementation of <span class="RktSym">swap</span> to explicitly
+check the sub-forms:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">swap</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fstx..rkt%2529._identifier%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fstx..rkt%2529._identifier%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">y</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">tmp</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span><span class="hspace">&nbsp;</span><span class="RktSym">y</span><span class="hspace">&nbsp;</span><span class="RktSym">tmp</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._raise-syntax-error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise-syntax-error</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"not an identifier"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">stx</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fstx..rkt%2529._identifier%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">identifier?</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">y</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>With this definition, <span class="RktPn">(</span><span class="RktSym">swap</span><span class="stt"> </span><span class="RktSym">x</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span> provides a syntax error
+originating from <span class="RktSym">swap</span> instead of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=set_.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._set%2521%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">set!</a></span>.</p><p>In the above definition of <span class="RktSym">swap</span>, <span class="RktRdr">#'</span><span class="RktSym">x</span> and
+<span class="RktRdr">#'</span><span class="RktSym">y</span> are templates, even though they are not used as the
+result of the macro transformer. This example illustrates how
+templates can be used to access pieces of the input syntax, in this
+case for checking the form of the pieces. Also, the match for
+<span class="RktRdr">#'</span><span class="RktSym">x</span> or <span class="RktRdr">#'</span><span class="RktSym">y</span> is used in the call to
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=exns.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._raise-syntax-error%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">raise-syntax-error</a></span>, so that the syntax-error message can
+point directly to the source location of the non-identifier.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="macro-transformers.html" title="backward to &quot;16.2.2 Macro Transformer Procedures&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="proc-macros.html" title="up to &quot;16.2 General Macro Transformers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="with-syntax.html" title="forward to &quot;16.2.4 with-syntax and generate-temporaries&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/syntax-notation.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/syntax-notation.html
new file mode 100644
index 00000000..f9b69833
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/syntax-notation.html
@@ -0,0 +1,26 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>4.1&nbsp;Notation</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewselflink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">4.1&nbsp;</td><td><a href="syntax-notation.html" class="tocviewselflink" data-pltdoc="x">Notation</a></td></tr><tr><td align="right">4.2&nbsp;</td><td><a href="binding.html" class="tocviewlink" data-pltdoc="x">Identifiers and Binding</a></td></tr><tr><td align="right">4.3&nbsp;</td><td><a href="application.html" class="tocviewlink" data-pltdoc="x">Function Calls</a></td></tr><tr><td align="right">4.4&nbsp;</td><td><a href="lambda.html" class="tocviewlink" data-pltdoc="x">Functions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">lambda</span></span></a></td></tr><tr><td align="right">4.5&nbsp;</td><td><a href="define.html" class="tocviewlink" data-pltdoc="x">Definitions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">define</span></span></a></td></tr><tr><td align="right">4.6&nbsp;</td><td><a href="let.html" class="tocviewlink" data-pltdoc="x">Local Binding</a></td></tr><tr><td align="right">4.7&nbsp;</td><td><a href="conditionals.html" class="tocviewlink" data-pltdoc="x">Conditionals</a></td></tr><tr><td align="right">4.8&nbsp;</td><td><a href="begin.html" class="tocviewlink" data-pltdoc="x">Sequencing</a></td></tr><tr><td align="right">4.9&nbsp;</td><td><a href="set_.html" class="tocviewlink" data-pltdoc="x">Assignment:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">set!</span></span></a></td></tr><tr><td align="right">4.10&nbsp;</td><td><a href="quote.html" class="tocviewlink" data-pltdoc="x">Quoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quote</span></span> and <span class="RktVal">&rsquo;</span></a></td></tr><tr><td align="right">4.11&nbsp;</td><td><a href="qq.html" class="tocviewlink" data-pltdoc="x">Quasiquoting:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">quasiquote</span></span> and <span class="RktVal">&lsquo;</span></a></td></tr><tr><td align="right">4.12&nbsp;</td><td><a href="case.html" class="tocviewlink" data-pltdoc="x">Simple Dispatch:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">case</span></span></a></td></tr><tr><td align="right">4.13&nbsp;</td><td><a href="parameterize.html" class="tocviewlink" data-pltdoc="x">Dynamic Binding:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">parameterize</span></span></a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="scheme-forms.html" title="backward to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="binding.html" title="forward to &quot;4.2 Identifiers and Binding&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;syntax-notation&quot;">4.1<tt>&nbsp;</tt><a name="(part._syntax-notation)"></a>Notation</h4><p>This chapter (and the rest of the documentation) uses a slightly
+different notation than the character-based grammars of the
+<a href="to-scheme.html" data-pltdoc="x">Racket Essentials</a> chapter. The grammar for a use of a syntactic
+form <span class="RktKw">something</span> is shown like this:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktKw">something</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">id</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktVar">an-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote><p>The italicized meta-variables in this specification, such as
+<span class="RktVar">id</span> and <span class="RktVar">an-expr</span>, use the syntax of Racket
+identifiers, so <span class="RktVar">an-expr</span> is one meta-variable. A naming
+convention implicitly defines the meaning of many meta-variables:</p><ul><li><p>A meta-variable that ends in <span class="RktVar">id</span> stands for an
+identifier, such as <span class="RktSym">x</span> or
+<span class="RktSym">my-favorite-martian</span>.</p></li><li><p>A meta-identifier that ends in <span class="RktVar">keyword</span> stands
+for a keyword, such as <span class="RktPn">#:tag</span>.</p></li><li><p>A meta-identifier that ends with <span class="RktVar">expr</span> stands for any
+sub-form, and it will be parsed as an expression.</p></li><li><p>A meta-identifier that ends with <span class="RktVar">body</span> stands for any
+sub-form; it will be parsed as either a local definition or an
+expression. The last <span class="RktVar">body</span> must be an expression;
+see also <a href="define.html#%28part._intdefs%29" data-pltdoc="x">Internal Definitions</a>.</p></li></ul><p>Square brackets in the grammar indicate a parenthesized sequence of
+forms, where square brackets are normally used (by convention). That
+is, square brackets <span style="font-style: italic">do not</span> mean optional parts of the
+syntactic form.</p><p>A <span class="RktMeta">...</span> indicates zero or more repetitions of the
+preceding form, and <span class="RktMeta">...+</span> indicates one or more
+repetitions of the preceding datum. Otherwise, non-italicized
+identifiers stand for themselves.</p><p>Based on the above grammar, then, here are a few conforming uses of
+<span class="RktKw">something</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktKw">something</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktKw">something</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktKw">something</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">my-favorite-martian</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Some syntactic-form specifications refer to meta-variables that are
+not implicitly defined and not previously defined. Such meta-variables
+are defined after the main form, using a BNF-like format for
+alternatives:</p><blockquote class="leftindent"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><span class="RktPn">(</span><span class="RktKw">something-else</span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktVar">thing</span><span class="hspace">&nbsp;</span><span class="RktMeta">...+</span><span class="RktPn">]</span><span class="hspace">&nbsp;</span><span class="RktVar">an-expr</span><span class="hspace">&nbsp;</span><span class="RktMeta">...</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&nbsp;</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="specgrammar"><tr><td align="right" valign="baseline"><span class="RktVar">thing</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">=</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">thing-id</span></td></tr><tr><td align="right" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="center" valign="baseline">|</td><td align="left" valign="baseline"><span class="stt">&nbsp;</span></td><td align="left" valign="baseline"><span class="RktVar">thing-keyword</span></td></tr></table></td></tr></table></blockquote></blockquote><p>The above example says that, within a <span class="RktKw">something-else</span>
+form, a <span class="RktVar">thing</span> is either an identifier or a keyword.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="scheme-forms.html" title="backward to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="up to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="binding.html" title="forward to &quot;4.2 Identifiers and Binding&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/syntax-overview.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/syntax-overview.html
new file mode 100644
index 00000000..ff1752ad
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/syntax-overview.html
@@ -0,0 +1,145 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>2.2&nbsp;Simple Definitions and Expressions</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewselflink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">2.1&nbsp;</td><td><a href="Simple_Values.html" class="tocviewlink" data-pltdoc="x">Simple Values</a></td></tr><tr><td align="right">2.2&nbsp;</td><td><a href="syntax-overview.html" class="tocviewselflink" data-pltdoc="x">Simple Definitions and Expressions</a></td></tr><tr><td align="right">2.3&nbsp;</td><td><a href="Lists__Iteration__and_Recursion.html" class="tocviewlink" data-pltdoc="x">Lists, Iteration, and Recursion</a></td></tr><tr><td align="right">2.4&nbsp;</td><td><a href="Pairs__Lists__and_Racket_Syntax.html" class="tocviewlink" data-pltdoc="x">Pairs, Lists, and Racket Syntax</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>2.2&nbsp;</td><td><a href="syntax-overview.html" class="tocviewselflink" data-pltdoc="x">Simple Definitions and Expressions</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">2.2.1&nbsp;</td><td><a href="syntax-overview.html#%28part._.Definitions%29" class="tocviewlink" data-pltdoc="x">Definitions</a></td></tr><tr><td align="right">2.2.2&nbsp;</td><td><a href="syntax-overview.html#%28part._indentation%29" class="tocviewlink" data-pltdoc="x">An Aside on Indenting Code</a></td></tr><tr><td align="right">2.2.3&nbsp;</td><td><a href="syntax-overview.html#%28part._.Identifiers%29" class="tocviewlink" data-pltdoc="x">Identifiers</a></td></tr><tr><td align="right">2.2.4&nbsp;</td><td><a href="syntax-overview.html#%28part._.Function_.Calls__.Procedure_.Applications_%29" class="tocviewlink" data-pltdoc="x">Function Calls</a></td></tr><tr><td align="right">2.2.5&nbsp;</td><td><a href="syntax-overview.html#%28part._.Conditionals_with_if__and__or__and_cond%29" class="tocviewlink" data-pltdoc="x">Conditionals with <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, <span class="RktSym"><span class="RktStxLink">or</span></span>, and <span class="RktSym"><span class="RktStxLink">cond</span></span></a></td></tr><tr><td align="right">2.2.6&nbsp;</td><td><a href="syntax-overview.html#%28part._.Function_.Calls__.Again%29" class="tocviewlink" data-pltdoc="x">Function Calls, Again</a></td></tr><tr><td align="right">2.2.7&nbsp;</td><td><a href="syntax-overview.html#%28part._.Anonymous_.Functions_with_lambda%29" class="tocviewlink" data-pltdoc="x">Anonymous Functions with <span class="RktSym"><span class="RktStxLink">lambda</span></span></a></td></tr><tr><td align="right">2.2.8&nbsp;</td><td><a href="syntax-overview.html#%28part._local-binding-intro%29" class="tocviewlink" data-pltdoc="x">Local Binding with
+<span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">let</span></span>, and <span class="RktSym"><span class="RktStxLink">let*</span></span></a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">2.2.1<tt>&nbsp;</tt></span><a href="syntax-overview.html#%28part._.Definitions%29" class="tocsubseclink" data-pltdoc="x">Definitions</a></td></tr><tr><td><span class="tocsublinknumber">2.2.2<tt>&nbsp;</tt></span><a href="syntax-overview.html#%28part._indentation%29" class="tocsubseclink" data-pltdoc="x">An Aside on Indenting Code</a></td></tr><tr><td><span class="tocsublinknumber">2.2.3<tt>&nbsp;</tt></span><a href="syntax-overview.html#%28part._.Identifiers%29" class="tocsubseclink" data-pltdoc="x">Identifiers</a></td></tr><tr><td><span class="tocsublinknumber">2.2.4<tt>&nbsp;</tt></span><a href="syntax-overview.html#%28part._.Function_.Calls__.Procedure_.Applications_%29" class="tocsubseclink" data-pltdoc="x">Function Calls</a></td></tr><tr><td><span class="tocsublinknumber">2.2.5<tt>&nbsp;</tt></span><a href="syntax-overview.html#%28part._.Conditionals_with_if__and__or__and_cond%29" class="tocsubseclink" data-pltdoc="x">Conditionals with <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, <span class="RktSym"><span class="RktStxLink">or</span></span>, and <span class="RktSym"><span class="RktStxLink">cond</span></span></a></td></tr><tr><td><span class="tocsublinknumber">2.2.6<tt>&nbsp;</tt></span><a href="syntax-overview.html#%28part._.Function_.Calls__.Again%29" class="tocsubseclink" data-pltdoc="x">Function Calls, Again</a></td></tr><tr><td><span class="tocsublinknumber">2.2.7<tt>&nbsp;</tt></span><a href="syntax-overview.html#%28part._.Anonymous_.Functions_with_lambda%29" class="tocsubseclink" data-pltdoc="x">Anonymous Functions with <span class="RktSym"><span class="RktStxLink">lambda</span></span></a></td></tr><tr><td><span class="tocsublinknumber">2.2.8<tt>&nbsp;</tt></span><a href="syntax-overview.html#%28part._local-binding-intro%29" class="tocsubseclink" data-pltdoc="x">Local Binding with
+<span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">let</span></span>, and <span class="RktSym"><span class="RktStxLink">let*</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Simple_Values.html" title="backward to &quot;2.1 Simple Values&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="to-scheme.html" title="up to &quot;2 Racket Essentials&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Lists__Iteration__and_Recursion.html" title="forward to &quot;2.3 Lists, Iteration, and Recursion&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;syntax-overview&quot;">2.2<tt>&nbsp;</tt><a name="(part._syntax-overview)"></a>Simple Definitions and Expressions</h4><p>A program module is written as</p><blockquote class="SCodeFlow"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">langname</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">topform</span>&#8250;</span><span class="sroman">*</span></p></blockquote><p>where a <span class="sroman">&#8249;<span style="font-style: italic">topform</span>&#8250;</span> is either a <span class="sroman">&#8249;<span style="font-style: italic">definition</span>&#8250;</span> or an
+<span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span>. The <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> also evaluates <span class="sroman">&#8249;<span style="font-style: italic">topform</span>&#8250;</span>s.</p><p>In syntax specifications, text with a gray background, such as
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">#lang</span><span class="hspace"></span></span>, represents literal text. Whitespace must appear
+between such literals and nonterminals like <span class="sroman">&#8249;<span style="font-style: italic">id</span>&#8250;</span>,
+except that whitespace is not required before or after <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span>,
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span>, <span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span>, or <span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span>.  A <a name="(idx._(gentag._0._(lib._scribblings/guide/guide..scrbl)))"></a>comment, which starts
+with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">;</span><span class="hspace"></span></span> and runs until the end of the line, is treated the
+same as whitespace.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528part._parse-comment%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Reading Comments</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on different forms of comments.</p></blockquote></blockquote></blockquote><p>Following the usual conventions, <span class="sroman">*</span> in a grammar means zero
+or more repetitions of the preceding element, <span style="vertical-align: super; font-size: 80%">+</span> means one
+or more repetitions of the preceding element, and <span class="sroman">{</span><span class="sroman">}</span> groups
+a sequence as an element for repetition.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Definitions&quot;">2.2.1<tt>&nbsp;</tt><a name="(part._.Definitions)"></a>Definitions</h5><p>A definition of the form</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="define.html" data-pltdoc="x">Definitions: <span class="RktSym"><span class="RktStxLink">define</span></span></a> (later in this guide) explains more about definitions.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">define</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">id</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></p></blockquote><p>binds <span class="sroman">&#8249;<span style="font-style: italic">id</span>&#8250;</span> to the result of <span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span>, while</p><blockquote class="SCodeFlow"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">define</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">id</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">id</span>&#8250;</span><span class="sroman">*</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></p></blockquote><p>binds the first <span class="sroman">&#8249;<span style="font-style: italic">id</span>&#8250;</span> to a function (also called a
+<span style="font-style: italic">procedure</span>) that takes arguments as named by the remaining
+<span class="sroman">&#8249;<span style="font-style: italic">id</span>&#8250;</span>s. In the function case, the <span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span>s are the body
+of the function. When the function is called, it returns the result of
+the last <span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span>.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">pie</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">defines </span><span class="RktSym">pie</span><span class="RktCmt"> to be </span><span class="RktVal">3</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">piece</span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">defines </span><span class="RktSym">piece</span><span class="RktCmt"> as a function</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._substring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">substring</a></span><span class="hspace">&nbsp;</span><span class="RktSym">str</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktSym">pie</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt"> of one argument</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">pie</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">piece</span><span class="hspace">&nbsp;</span><span class="RktVal">"key lime"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"key"</span></p></td></tr></table></blockquote></div></p><p>Under the hood, a function definition is really the same as a
+non-function definition, and a function name does not have to be
+used in a function call. A function is just another kind of value,
+though the printed form is necessarily less complete than the printed
+form of a number or string.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktSym">piece</span></td></tr><tr><td><p><span class="RktRes">#&lt;procedure:piece&gt;</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._substring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">substring</a></span></td></tr><tr><td><p><span class="RktRes">#&lt;procedure:substring&gt;</span></p></td></tr></table></blockquote></div></p><p>A function definition can include multiple expressions for the
+function&rsquo;s body. In that case, only the value of the last expression
+is returned when the function is called. The other expressions are
+evaluated only for some side-effect, such as printing.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">bake</span><span class="hspace">&nbsp;</span><span class="RktSym">flavor</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._printf%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">printf</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"preheating oven...\n"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">flavor</span><span class="hspace">&nbsp;</span><span class="RktVal">" pie"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">bake</span><span class="hspace">&nbsp;</span><span class="RktVal">"apple"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktOut">preheating oven...</span></p></td></tr><tr><td><p><span class="RktRes">"apple pie"</span></p></td></tr></table></blockquote></div></p><p>Racket programmers prefer to avoid side-effects, so a definition usually
+has just one expression in its body. It&rsquo;s
+important, though, to understand that multiple expressions are allowed
+in a definition body, because it explains why the following
+<span class="RktSym">nobake</span> function fails to include its argument in its result:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">nobake</span><span class="hspace">&nbsp;</span><span class="RktSym">flavor</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">flavor</span><span class="hspace">&nbsp;</span><span class="RktVal">"jello"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">nobake</span><span class="hspace">&nbsp;</span><span class="RktVal">"green"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"jello"</span></p></td></tr></table></td></tr></table></blockquote><p>Within <span class="RktSym">nobake</span>, there are no parentheses around
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="stt"> </span><span class="RktSym">flavor</span><span class="stt"> </span><span class="RktVal">"jello"</span>, so they are three separate
+expressions instead of one function-call expression. The expressions
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span> and <span class="RktSym">flavor</span> are evaluated, but the
+results are never used. Instead, the result of the function is just
+the result of the final expression, <span class="RktVal">"jello"</span>.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;indentation&quot;">2.2.2<tt>&nbsp;</tt><a name="(part._indentation)"></a>An Aside on Indenting Code</h5><p>Line breaks and indentation are not significant for parsing Racket
+programs, but most Racket programmers use a standard set of conventions
+to make code more readable. For example, the body of a definition is
+typically indented under the first line of the definition. Identifiers
+are written immediately after an open parenthesis with no extra space,
+and closing parentheses never go on their own line.</p><p>DrRacket automatically indents according to the standard style when
+you type Enter in a program or <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> expression. For example, if you
+hit Enter after typing <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(define (greet name)</span><span class="hspace"></span></span>, then DrRacket
+automatically inserts two spaces for the next line.  If you change a
+region of code, you can select it in DrRacket and hit Tab, and
+DrRacket will re-indent the code (without inserting any line breaks).
+Editors like Emacs offer a Racket or Scheme mode with similar indentation
+support.</p><p>Re-indenting not only makes the code easier to read, it gives you
+extra feedback that your parentheses match in the way that you
+intended. For example, if you leave out a closing parenthesis after
+the last argument to a function, automatic indentation starts the
+next line under the first argument, instead of under the
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> keyword:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">halfbake</span><span class="hspace">&nbsp;</span><span class="RktSym">flavor</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">flavor</span><span class="hspace">&nbsp;</span><span class="RktVal">" creme brulee"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>In this case, indentation helps highlight the mistake. In other cases,
+where the indentation may be normal while an open parenthesis has no
+matching close parenthesis, both <span class="stt">racket</span> and DrRacket use the
+source&rsquo;s indentation to suggest where a parenthesis might be missing.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Identifiers&quot;">2.2.3<tt>&nbsp;</tt><a name="(part._.Identifiers)"></a>Identifiers</h5><p>Racket&rsquo;s syntax for identifiers is especially liberal. Excluding the
+special characters</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="binding.html" data-pltdoc="x">Identifiers and Binding</a> (later in this guide) explains more about identifiers.</p></blockquote></blockquote></blockquote><p><span class="hspace">&nbsp;&nbsp;</span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span>
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">{</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">}</span><span class="hspace"></span></span>
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">"</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">,</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">`</span><span class="hspace"></span></span>
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">;</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">|</span><span class="hspace"></span></span> <span class="RktInBG"><span class="hspace"></span><span class="RktIn">\</span><span class="hspace"></span></span></p><p>and except for the sequences of characters that make number constants,
+almost any sequence of non-whitespace characters forms an
+<span class="sroman">&#8249;<span style="font-style: italic">id</span>&#8250;</span>. For example <span class="RktSym">substring</span> is an
+identifier. Also, <span class="RktSym">string-append</span> and <span class="RktSym">a+b</span> are
+identifiers, as opposed to arithmetic expressions. Here are several
+more examples:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktSym">+</span></td></tr><tr><td><span class="RktSym">integer?</span></td></tr><tr><td><span class="RktSym">pass/fail</span></td></tr><tr><td><span class="RktSym">Hfuhruhurr&amp;Uumellmahaye</span></td></tr><tr><td><span class="RktSym">john-jacob-jingleheimer-schmidt</span></td></tr><tr><td><span class="RktSym">a-b-c+1-2-3</span></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Function_Calls__Procedure_Applications_&quot;">2.2.4<tt>&nbsp;</tt><a name="(part._.Function_.Calls__.Procedure_.Applications_)"></a>Function Calls (Procedure Applications)</h5><p>We have already seen many function calls, which are called
+<span style="font-style: italic">procedure applications</span> in more traditional
+terminology. The syntax of a function call is</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="application.html" data-pltdoc="x">Function Calls</a> (later in this guide) explains more about function calls.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">id</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span><span class="sroman">*</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></p></blockquote><p>where the number of <span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span>s determines the number of
+arguments supplied to the function named by <span class="sroman">&#8249;<span style="font-style: italic">id</span>&#8250;</span>.</p><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a> language pre-defines many function
+identifiers, such as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._substring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">substring</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span>. More examples are below.</p><p>In example Racket code throughout the documentation, uses of
+pre-defined names are hyperlinked to the reference manual. So, you can
+click on an identifier to get full details about its use.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"rope"</span><span class="hspace">&nbsp;</span><span class="RktVal">"twine"</span><span class="hspace">&nbsp;</span><span class="RktVal">"yarn"</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">append strings</span></td></tr><tr><td><p><span class="RktRes">"ropetwineyarn"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._substring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">substring</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"corduroys"</span><span class="hspace">&nbsp;</span><span class="RktVal">0</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">extract a substring</span></td></tr><tr><td><p><span class="RktRes">"cord"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-prefix%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-prefix?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"shoelace"</span><span class="hspace">&nbsp;</span><span class="RktVal">"shoe"</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">recognize string prefix/suffix</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-suffix%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-suffix?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"shoelace"</span><span class="hspace">&nbsp;</span><span class="RktVal">"shoe"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"Ceci n'est pas une string."</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">recognize strings</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sqrt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sqrt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">16</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">find a square root</span></td></tr><tr><td><p><span class="RktRes">4</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sqrt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sqrt</a></span><span class="hspace">&nbsp;</span><span class="RktVal"><span class="nobreak">-1</span>6</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">0+4i</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">add numbers</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">subtract numbers</span></td></tr><tr><td><p><span class="RktRes">1</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3c%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&lt;</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">compare numbers</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%7E3d%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;=</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"c'est une number"</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">recognize numbers</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">"half dozen"</span><span class="RktPn">)</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">compare anything</span></td></tr><tr><td><p><span class="RktRes">#f</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="hspace">&nbsp;</span><span class="RktVal">6</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Equality.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._equal%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">equal?</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"half dozen"</span><span class="hspace">&nbsp;</span><span class="RktVal">"half dozen"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#t</span></p></td></tr></table></blockquote><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Conditionals_with_if__and__or__and_cond&quot;">2.2.5<tt>&nbsp;</tt><a name="(part._.Conditionals_with_if__and__or__and_cond)"></a>Conditionals with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span>, and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></h5><p>The next simplest kind of expression is an <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span> conditional:</p><blockquote class="SCodeFlow"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">if</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></p></blockquote><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="conditionals.html" data-pltdoc="x">Conditionals</a> (later in this guide) explains more about conditionals.</p></blockquote></blockquote></blockquote><p>The first <span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span> is always evaluated. If it produces a
+non-<span class="RktVal">#f</span> value, then the second <span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span> is
+evaluated for the result of the whole <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span> expression, otherwise
+the third <span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span> is evaluated for the result.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"2 is bigger than 3"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"2 is smaller than 3"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"2 is smaller than 3"</span></p></td></tr></table></blockquote></div></p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">reply</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-prefix%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-prefix?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello "</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"hi!"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"huh?"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">reply</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello racket"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"hi!"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">reply</span><span class="hspace">&nbsp;</span><span class="RktVal">"&#955;x:(&#956;&#945;.&#945;&#8594;&#945;).xx"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"huh?"</span></p></td></tr></table></td></tr></table></blockquote><p>Complex conditionals can be formed by nesting <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span>
+expressions. For example, in the previous <span class="RktSym">reply</span> example,
+the input must be a string because <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-prefix%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-prefix?</a></span>
+would error when given non-strings. You can remove this restriction
+by adding another <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span> to check first if the input is a string:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">reply-non-string</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-prefix%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-prefix?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello "</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"hi!"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"huh?"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"huh?"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Instead of duplicating the <span class="RktVal">"huh?"</span> case, this function is
+better written as</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">reply-non-string</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-prefix%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-prefix?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello "</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">#f</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"hi!"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"huh?"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>but these kinds of nested <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span>s are difficult to read.  Racket
+provides more readable shortcuts through the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span> and
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span> forms:</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="conditionals.html#%28part._and%2Bor%29" data-pltdoc="x">Combining Tests: <span class="RktSym"><span class="RktStxLink">and</span></span> and <span class="RktSym"><span class="RktStxLink">or</span></span></a> (later in this guide) explains more about <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span>.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">and</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span><span class="sroman">*</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></td></tr><tr><td><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">or</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span><span class="sroman">*</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></td></tr></table></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span> form short-circuits: it stops and returns <span class="RktVal">#f</span>
+when an expression produces <span class="RktVal">#f</span>, otherwise it keeps
+going. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span> form similarly short-circuits when it
+encounters a true result.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">reply-non-string</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-prefix%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-prefix?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello "</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"hi!"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"huh?"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">reply-non-string</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello racket"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"hi!"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">reply-non-string</span><span class="hspace">&nbsp;</span><span class="RktVal">17</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"huh?"</span></p></td></tr></table></blockquote></div></p><p>Note that in the above grammar, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._or%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">or</a></span> forms
+work with any number of expressions.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">reply-only-enthusiastic</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._and%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">and</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-prefix%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-prefix?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello "</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-suffix%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-suffix?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">"!"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"hi!"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"huh?"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">reply-only-enthusiastic</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello racket!"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"hi!"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">reply-only-enthusiastic</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello racket"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"huh?"</span></p></td></tr></table></blockquote></div></p><p>Another common pattern of nested <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span>s involves a sequence of
+tests, each with its own result:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">reply-more</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-prefix%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-prefix?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello "</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"hi!"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-prefix%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-prefix?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">"goodbye "</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"bye!"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-suffix%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-suffix?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">"?"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"I don't know"</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"huh?"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>The shorthand for a sequence of tests is the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span> form:</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="conditionals.html#%28part._cond%29" data-pltdoc="x">Chaining Tests: <span class="RktSym"><span class="RktStxLink">cond</span></span></a> (later in this guide) explains more about <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span>.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">cond</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">{</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span><span class="sroman">*</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span><span class="sroman">}</span><span class="sroman">*</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></p></blockquote><p>A <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span> form contains a sequence of clauses between square
+brackets. In each clause, the first <span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span> is a test
+expression. If it produces true, then the clause&rsquo;s remaining
+<span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span>s are evaluated, and the last one in the clause provides
+the answer for the entire <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span> expression; the rest of the
+clauses are ignored. If the test <span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span> produces <span class="RktVal">#f</span>,
+then the clause&rsquo;s remaining <span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span>s are ignored, and
+evaluation continues with the next clause. The last clause can use
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span> as a synonym for a <span class="RktVal">#t</span> test expression.</p><p>Using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span>, the <span class="RktSym">reply-more</span> function can be more
+clearly written as follows:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">reply-more</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-prefix%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-prefix?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello "</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"hi!"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-prefix%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-prefix?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">"goodbye "</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"bye!"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-suffix%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-suffix?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">"?"</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"I don't know"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"huh?"</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">reply-more</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello racket"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"hi!"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">reply-more</span><span class="hspace">&nbsp;</span><span class="RktVal">"goodbye cruel world"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"bye!"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">reply-more</span><span class="hspace">&nbsp;</span><span class="RktVal">"what is your favorite color?"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"I don't know"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">reply-more</span><span class="hspace">&nbsp;</span><span class="RktVal">"mine is lime green"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"huh?"</span></p></td></tr></table></td></tr></table></blockquote><p>The use of square brackets for <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span> clauses is a
+convention. In Racket, parentheses and square brackets are actually
+interchangeable, as long as <span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span> is matched with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span> and
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span> is matched with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span>. Using square brackets in a
+few key places makes Racket code even more readable.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Function_Calls__Again&quot;">2.2.6<tt>&nbsp;</tt><a name="(part._.Function_.Calls__.Again)"></a>Function Calls, Again</h5><p>In our earlier grammar of function calls, we oversimplified.  The
+actual syntax of a function call allows an arbitrary
+expression for the function, instead of just an <span class="sroman">&#8249;<span style="font-style: italic">id</span>&#8250;</span>:</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="application.html" data-pltdoc="x">Function Calls</a> (later in this guide) explains more about function calls.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span><span class="sroman">*</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></p></blockquote><p>The first <span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span> is often an <span class="sroman">&#8249;<span style="font-style: italic">id</span>&#8250;</span>, such
+as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span> or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span>, but it can be anything that
+evaluates to a function. For example, it can be a conditional
+expression:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">double</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._if%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">if</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">double</span><span class="hspace">&nbsp;</span><span class="RktVal">"mnah"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"mnahmnah"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">double</span><span class="hspace">&nbsp;</span><span class="RktVal">5</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">10</span></p></td></tr></table></td></tr></table></blockquote><p>Syntactically, the first expression in a function call could
+even be a number&#8212;<wbr></wbr>but that leads to an error, since a number is not a
+function.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">application: not a procedure;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">expected a procedure that can be applied to arguments</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">given: 1</span></p></td></tr></table></blockquote><p>When you accidentally omit a function name or when you use
+extra parentheses around an expression, you&rsquo;ll most often get an &ldquo;expected
+a procedure&rdquo; error like this one.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;Anonymous_Functions_with_lambda&quot;">2.2.7<tt>&nbsp;</tt><a name="(part._.Anonymous_.Functions_with_lambda)"></a>Anonymous Functions with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span></h5><p>Programming in Racket would be tedious if you had to name all of your
+numbers. Instead of writing <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="stt"> </span><span class="RktVal">1</span><span class="stt"> </span><span class="RktVal">2</span><span class="RktPn">)</span>, you&rsquo;d have to write</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="lambda.html" data-pltdoc="x">Functions: <span class="RktSym"><span class="RktStxLink">lambda</span></span></a> (later in this guide) explains more about <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span>.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%252B%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">+</a></span><span class="hspace">&nbsp;</span><span class="RktSym">a</span><span class="hspace">&nbsp;</span><span class="RktSym">b</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">3</span></p></td></tr></table></blockquote><p>It turns out that having to name all your functions can be tedious,
+too. For example, you might have a function <span class="RktSym">twice</span> that takes
+a function and an argument. Using <span class="RktSym">twice</span> is convenient if you
+already have a name for the function, such as <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sqrt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sqrt</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">twice</span><span class="hspace">&nbsp;</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">f</span><span class="hspace">&nbsp;</span><span class="RktSym">v</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">twice</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._sqrt%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">sqrt</a></span><span class="hspace">&nbsp;</span><span class="RktVal">16</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">2</span></p></td></tr></table></td></tr></table></blockquote><p>If you want to call a function that is not yet defined, you could
+define it, and then pass it to <span class="RktSym">twice</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">louder</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">"!"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">twice</span><span class="hspace">&nbsp;</span><span class="RktSym">louder</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"hello!!"</span></p></td></tr></table></td></tr></table></blockquote><p>But if the call to <span class="RktSym">twice</span> is the only place where
+<span class="RktSym">louder</span> is used, it&rsquo;s a shame to have to write a whole
+definition. In Racket, you can use a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> expression to
+produce a function directly. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> form is followed by
+identifiers for the function&rsquo;s arguments, and then the function&rsquo;s
+body expressions:</p><blockquote class="SCodeFlow"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">lambda</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">id</span>&#8250;</span><span class="sroman">*</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></p></blockquote><p>Evaluating a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> form by itself produces a function:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">"!"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">#&lt;procedure&gt;</span></p></td></tr></table></blockquote><p>Using <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span>, the above call to <span class="RktSym">twice</span> can be
+re-written as</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">twice</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">"!"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"hello!!"</span></p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">twice</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">"?!"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"hello?!?!"</span></p></td></tr></table></blockquote><p>Another use of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> is as a result for a function that
+generates functions:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-add-suffix</span><span class="hspace">&nbsp;</span><span class="RktSym">s2</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">s2</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">twice</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-add-suffix</span><span class="hspace">&nbsp;</span><span class="RktVal">"!"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"hello!!"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">twice</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-add-suffix</span><span class="hspace">&nbsp;</span><span class="RktVal">"?!"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"hello?!?!"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">twice</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-add-suffix</span><span class="hspace">&nbsp;</span><span class="RktVal">"..."</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"hello......"</span></p></td></tr></table></td></tr></table></blockquote><p>Racket is a <span style="font-style: italic">lexically scoped</span> language, which means that
+<span class="RktSym">s2</span> in the function returned by <span class="RktSym">make-add-suffix</span>
+always refers to the argument for the call that created the
+function. In other words, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span>-generated function
+&ldquo;remembers&rdquo; the right <span class="RktSym">s2</span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">louder</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-add-suffix</span><span class="hspace">&nbsp;</span><span class="RktVal">"!"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">less-sure</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">make-add-suffix</span><span class="hspace">&nbsp;</span><span class="RktVal">"?"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">twice</span><span class="hspace">&nbsp;</span><span class="RktSym">less-sure</span><span class="hspace">&nbsp;</span><span class="RktVal">"really"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"really??"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">twice</span><span class="hspace">&nbsp;</span><span class="RktSym">louder</span><span class="hspace">&nbsp;</span><span class="RktVal">"really"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"really!!"</span></p></td></tr></table></blockquote><p>We have so far referred to definitions of the form <span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="stt"> </span><span class="sroman">&#8249;<span style="font-style: italic">id</span>&#8250;</span><span class="stt"> </span><span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span><span class="RktPn">)</span> as &ldquo;non-function
+definitions.&rdquo; This characterization is misleading, because the
+<span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span> could be a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> form, in which case
+the definition is equivalent to using the &ldquo;function&rdquo; definition
+form. For example, the following two definitions of <span class="RktSym">louder</span>
+are equivalent:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">louder</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">"!"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">louder</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktVal">"!"</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktSym">louder</span></td></tr><tr><td><p><span class="RktRes">#&lt;procedure:louder&gt;</span></p></td></tr></table></td></tr></table></blockquote><p>Note that the expression for <span class="RktSym">louder</span> in the second case is an
+&ldquo;anonymous&rdquo; function written with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span>, but, if
+possible, the compiler infers a name, anyway, to make printing and
+error reporting as informative as possible.</p><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;local-binding-intro&quot;">2.2.8<tt>&nbsp;</tt><a name="(part._local-binding-intro)"></a>Local Binding with
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span>, and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let*</a></span></h5><p>It&rsquo;s time to retract another simplification in our grammar of
+Racket. In the body of a function, definitions can appear before the
+body expressions:</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="define.html#%28part._intdefs%29" data-pltdoc="x">Internal Definitions</a> (later in this guide) explains more about local (internal) definitions.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">define</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">id</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">id</span>&#8250;</span><span class="sroman">*</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">definition</span>&#8250;</span><span class="sroman">*</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></td></tr><tr><td><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">lambda</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">id</span>&#8250;</span><span class="sroman">*</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">definition</span>&#8250;</span><span class="sroman">*</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></td></tr></table></blockquote><p>Definitions at the start of a function body are local to the
+function body.</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">converse</span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">starts?</span><span class="hspace">&nbsp;</span><span class="RktSym">s2</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">local to </span><span class="RktSym">converse</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">spaced-s2</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s2</span><span class="hspace">&nbsp;</span><span class="RktVal">" "</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">local to </span><span class="RktSym">starts?</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528lib._racket%252Fstring..rkt%2529._string-prefix%7E3f%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-prefix?</a></span><span class="hspace">&nbsp;</span><span class="RktSym">s</span><span class="hspace">&nbsp;</span><span class="RktSym">spaced-s2</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">starts?</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"hi!"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">starts?</span><span class="hspace">&nbsp;</span><span class="RktVal">"goodbye"</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"bye!"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"huh?"</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td> </td></tr></table></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">converse</span><span class="hspace">&nbsp;</span><span class="RktVal">"hello world"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"hi!"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">converse</span><span class="hspace">&nbsp;</span><span class="RktVal">"hellonearth"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"huh?"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">converse</span><span class="hspace">&nbsp;</span><span class="RktVal">"goodbye friends"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"bye!"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">converse</span><span class="hspace">&nbsp;</span><span class="RktVal">"urp"</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"huh?"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktSym">starts?</span><span class="hspace">&nbsp;</span><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">outside of </span><span class="RktSym">converse</span><span class="RktCmt">, so...</span></td></tr><tr><td><p><span class="RktErr">starts?: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot reference an identifier before its definition</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;&nbsp;</span><span class="RktErr">in module: top-level</span></p></td></tr></table></blockquote></div></p><p>Another way to create local bindings is the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> form. An
+advantage of <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> is that it can be used in any expression
+position. Also, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> binds many identifiers at once, instead
+of requiring a separate <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span> for each identifier.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="finger.png" alt="+" width="24" height="24"/></span><a href="define.html#%28part._intdefs%29" data-pltdoc="x">Internal Definitions</a> (later in this guide) explains more about <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let*</a></span>.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><p><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">let</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">(</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">{</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">[</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">id</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">]</span><span class="hspace"></span></span><span class="sroman">}</span><span class="sroman">*</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span><span class="hspace">&nbsp;</span><span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span><span style="vertical-align: super; font-size: 80%">+</span><span class="hspace">&nbsp;</span><span class="RktInBG"><span class="hspace"></span><span class="RktIn">)</span><span class="hspace"></span></span></p></blockquote><p>Each binding clause is an <span class="sroman">&#8249;<span style="font-style: italic">id</span>&#8250;</span> and an
+<span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span> surrounded by square brackets, and the
+expressions after the clauses are the body of the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span>. In
+each clause, the <span class="sroman">&#8249;<span style="font-style: italic">id</span>&#8250;</span> is bound to the result of the
+<span class="sroman">&#8249;<span style="font-style: italic">expr</span>&#8250;</span> for use in the body.</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._random%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">random</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">o</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._random%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">random</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"X wins"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktVal">"O wins"</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"cat's game"</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"O wins"</span></p></td></tr></table></blockquote><p>The bindings of a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> form are available only in the body of
+the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span>, so the binding clauses cannot refer to each
+other. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let*</a></span> form, in contrast, allows later clauses to
+use earlier bindings:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%252A%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let*</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._random%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">random</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">o</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._random%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">random</a></span><span class="hspace">&nbsp;</span><span class="RktVal">4</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym">diff</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._number-%7E3estring%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">number-&gt;string</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._abs%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">abs</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._-%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x"><span class="nobreak">-</span></a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._cond%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">cond</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"X wins by "</span><span class="hspace">&nbsp;</span><span class="RktSym">diff</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=generic-numbers.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._%7E3e%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">&gt;</a></span><span class="hspace">&nbsp;</span><span class="RktSym">o</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-append%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-append</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"O wins by "</span><span class="hspace">&nbsp;</span><span class="RktSym">diff</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=if.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._else%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">else</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"cat's game"</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">"cat's game"</span></p></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Simple_Values.html" title="backward to &quot;2.1 Simple Values&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="to-scheme.html" title="up to &quot;2 Racket Essentials&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Lists__Iteration__and_Recursion.html" title="forward to &quot;2.3 Lists, Iteration, and Recursion&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/syntax_module-reader.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/syntax_module-reader.html
new file mode 100644
index 00000000..dfc8f1f0
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/syntax_module-reader.html
@@ -0,0 +1,26 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>17.3.3&nbsp;Using #lang s-exp syntax/module-reader</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewselflink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">17.1&nbsp;</td><td><a href="module-languages.html" class="tocviewlink" data-pltdoc="x">Module Languages</a></td></tr><tr><td align="right">17.2&nbsp;</td><td><a href="hash-reader.html" class="tocviewlink" data-pltdoc="x">Reader Extensions</a></td></tr><tr><td align="right">17.3&nbsp;</td><td><a href="hash-languages.html" class="tocviewselflink" data-pltdoc="x">Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>17.3&nbsp;</td><td><a href="hash-languages.html" class="tocviewlink" data-pltdoc="x">Defining new <span class="RktModLink"><span class="RktMod">#lang</span></span> Languages</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">17.3.1&nbsp;</td><td><a href="hash-lang_syntax.html" class="tocviewlink" data-pltdoc="x">Designating a <span class="RktModLink"><span class="RktMod">#lang</span></span> Language</a></td></tr><tr><td align="right">17.3.2&nbsp;</td><td><a href="hash-lang_reader.html" class="tocviewlink" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">reader</span></span></a></td></tr><tr><td align="right">17.3.3&nbsp;</td><td><a href="syntax_module-reader.html" class="tocviewselflink" data-pltdoc="x">Using <span class="RktModLink"><span class="RktMod">#lang</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">s-<wbr></wbr>exp</span></span><span class="stt"> </span><span class="RktModLink"><span class="RktSym">syntax/<span class="mywbr"> &nbsp;</span>module-<wbr></wbr>reader</span></span></a></td></tr><tr><td align="right">17.3.4&nbsp;</td><td><a href="language-collection.html" class="tocviewlink" data-pltdoc="x">Installing a Language</a></td></tr><tr><td align="right">17.3.5&nbsp;</td><td><a href="language-get-info.html" class="tocviewlink" data-pltdoc="x">Source-<wbr></wbr>Handling Configuration</a></td></tr><tr><td align="right">17.3.6&nbsp;</td><td><a href="module-runtime-config.html" class="tocviewlink" data-pltdoc="x">Module-<wbr></wbr>Handling Configuration</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="hash-lang_reader.html" title="backward to &quot;17.3.2 Using #lang reader&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="hash-languages.html" title="up to &quot;17.3 Defining new #lang Languages&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="language-collection.html" title="forward to &quot;17.3.4 Installing a Language&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;syntax/module-reader&quot;">17.3.3<tt>&nbsp;</tt><a name="(part._syntax/module-reader)"></a>Using <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="stt"> </span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._s-exp%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">s-exp</span></a><span class="stt"> </span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=reader-helpers.html%23%2528mod-path._syntax%252Fmodule-reader%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">syntax/module-reader</span></a></h5><p>Parsing a module body is usually not as trivial as in
+<span class="stt">"literal.rkt"</span>. A more typical module parser must iterate to
+parse multiple forms for a module body. A language is also more likely
+to extend Racket syntax&#8212;<wbr></wbr>perhaps through a <a href="hash-reader.html#%28tech._readtable%29" class="techoutside" data-pltdoc="x"><span class="techinside">readtable</span></a>&#8212;<wbr></wbr>instead
+of replacing Racket syntax completely.</p><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=reader-helpers.html%23%2528mod-path._syntax%252Fmodule-reader%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">syntax/module-reader</span></a> <a href="module-languages.html#%28tech._module._language%29" class="techoutside" data-pltdoc="x"><span class="techinside">module language</span></a>
+abstracts over common parts of a language implementation to simplify
+the creation of new languages. In its most basic form, a language
+implemented with <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=reader-helpers.html%23%2528mod-path._syntax%252Fmodule-reader%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">syntax/module-reader</span></a> simply specifies
+the <a href="module-languages.html#%28tech._module._language%29" class="techoutside" data-pltdoc="x"><span class="techinside">module language</span></a> to be used for the language, in which case
+the <a href="Pairs__Lists__and_Racket_Syntax.html#%28tech._reader%29" class="techoutside" data-pltdoc="x"><span class="techinside">reader</span></a> layer of the language is the same as Racket. For
+example, with</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"raquet-mlang.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._except-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">except-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._all-from-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">all-from-out</a></span><span class="hspace">&nbsp;</span><span class="RktSym">racket</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._rename-out%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">rename-out</a></span><span class="hspace">&nbsp;</span><span class="RktPn">[</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span><span class="hspace">&nbsp;</span><span class="RktSym">function</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>and</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"raquet.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._s-exp%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">s-exp</span></a><span class="hspace">&nbsp;</span><span class="RktSym">syntax/module-reader</span></td></tr><tr><td><span class="RktVal">"raquet-mlang.rkt"</span></td></tr></table></blockquote></blockquote></blockquote><p>then</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._reader%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">reader</span></a><span class="hspace">&nbsp;</span><span class="RktVal">"raquet.rkt"</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">identity</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">function</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">identity</span><span class="RktPn">)</span></td></tr></table></blockquote><p>implements and exports the <span class="RktSym">identity</span> function, since
+<span class="stt">"raquet-mlang.rkt"</span> exports <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> as
+<span class="RktSym">function</span>.</p><p>The <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=reader-helpers.html%23%2528mod-path._syntax%252Fmodule-reader%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">syntax/module-reader</span></a> language accepts many optional
+specifications to adjust other features of the language. For example,
+an alternate <span class="RktSym">read</span> and <span class="RktSym">read-syntax</span> for
+parsing the language can be specified with <span class="RktPn">#:read</span> and
+<span class="RktPn">#:read-syntax</span>, respectively. The following
+<span class="stt">"dollar-racket.rkt"</span> language uses <span class="stt">"dollar.rkt"</span> (see
+<a href="hash-reader.html#%28part._readtable%29" data-pltdoc="x">Readtables</a>) to build a language that is like
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket</span></a> but with a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">$</span><span class="hspace"></span></span> escape to simple infix
+arithmetic:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"dollar-racket.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._s-exp%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">s-exp</span></a><span class="hspace">&nbsp;</span><span class="RktSym">syntax/module-reader</span></td></tr><tr><td><span class="RktSym">racket</span></td></tr><tr><td><span class="RktPn">#:read</span><span class="hspace">&nbsp;</span><span class="RktSym">$-read</span></td></tr><tr><td><span class="RktPn">#:read-syntax</span><span class="hspace">&nbsp;</span><span class="RktSym">$-read-syntax</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._prefix-in%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">prefix-in</a></span><span class="hspace">&nbsp;</span><span class="RktSym">$-</span><span class="hspace">&nbsp;</span><span class="RktVal">"dollar.rkt"</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">require</a></span> form appears at the end of the module,
+because all of the keyword-tagged optional specifications for
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=syntax&amp;rel=reader-helpers.html%23%2528mod-path._syntax%252Fmodule-reader%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">syntax/module-reader</span></a> must appear before any helper
+imports or definitions.</p><p>The following module uses <span class="stt">"dollar-racket.rkt"</span> to implement a
+<span class="RktSym">cost</span> function using a <span class="RktInBG"><span class="hspace"></span><span class="RktIn">$</span><span class="hspace"></span></span> escape:</p><blockquote class="SCodeFlow"><blockquote class="Rfilebox"><p class="Rfiletitle"><span class="Rfilename"><span class="stt">"store.rkt"</span></span></p><blockquote class="Rfilecontent"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a><span class="hspace">&nbsp;</span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528mod-path._reader%2529&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">reader</span></a><span class="hspace">&nbsp;</span><span class="RktVal">"dollar-racket.rkt"</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._provide%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">provide</a></span><span class="hspace">&nbsp;</span><span class="RktSym">cost</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">Cost of </span><span class="RktCmt">&lsquo;</span><span class="RktCmt">n</span><span class="RktCmt">'</span><span class="RktCmt"> $1 rackets with 7% sales</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt">&nbsp;</span><span class="RktCmt">tax and shipping-and-handling fee </span><span class="RktCmt">&lsquo;</span><span class="RktCmt">h</span><span class="RktCmt">'</span><span class="RktCmt">:</span></td></tr><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">cost</span><span class="hspace">&nbsp;</span><span class="RktSym">n</span><span class="hspace">&nbsp;</span><span class="RktSym">h</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">$n*107/100+h$</span><span class="RktPn">)</span></td></tr></table></blockquote></blockquote></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="hash-lang_reader.html" title="backward to &quot;17.3.2 Using #lang reader&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="hash-languages.html" title="up to &quot;17.3 Defining new #lang Languages&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="language-collection.html" title="forward to &quot;17.3.4 Installing a Language&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/teaching-langs.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/teaching-langs.html
new file mode 100644
index 00000000..b69105f8
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/teaching-langs.html
@@ -0,0 +1,6 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>23.3&nbsp;Teaching</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewselflink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">23.1&nbsp;</td><td><a href="more-hash-lang.html" class="tocviewlink" data-pltdoc="x">More Rackets</a></td></tr><tr><td align="right">23.2&nbsp;</td><td><a href="standards.html" class="tocviewlink" data-pltdoc="x">Standards</a></td></tr><tr><td align="right">23.3&nbsp;</td><td><a href="teaching-langs.html" class="tocviewselflink" data-pltdoc="x">Teaching</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="standards.html" title="backward to &quot;23.2 Standards&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="dialects.html" title="up to &quot;23 Dialects of Racket and Scheme&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="other-editors.html" title="forward to &quot;24 Command-Line Tools and Your Editor of Choice&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;teaching-langs&quot;">23.3<tt>&nbsp;</tt><a name="(part._teaching-langs)"></a>Teaching</h4><p>The <span style="font-style: italic"><a href="https://htdp.org">How to Design Programs</a></span> textbook relies on pedagogic variants of Racket that
+smooth the introduction of programming concepts for new programmers.
+See <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?tag=%28part._%28.%27%28lib._scribblings%2Fhtdp-langs%2Fhtdp-langs..scrbl%29.%27._.%27top.%27%29%29&amp;version=8.6" class="Sq" data-pltdoc="x">the <span style="font-style: italic">How to Design Programs</span> language documentation</a>.</p><p>The <span style="font-style: italic"><a href="https://htdp.org">How to Design Programs</a></span> languages are typically not used with <a href="Module_Syntax.html#%28part._hash-lang%29" class="RktModLink" data-pltdoc="x"><span class="RktMod">#lang</span></a>
+prefixes, but are instead used within DrRacket by selecting the
+language from the <span class="ssansserif">Choose Language...</span> dialog.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="standards.html" title="backward to &quot;23.2 Standards&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="dialects.html" title="up to &quot;23 Dialects of Racket and Scheme&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="other-editors.html" title="forward to &quot;24 Command-Line Tools and Your Editor of Choice&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/to-scheme.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/to-scheme.html
new file mode 100644
index 00000000..0e5e1e6a
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/to-scheme.html
@@ -0,0 +1,5 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>2&nbsp;Racket Essentials</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewselflink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>2&nbsp;</td><td><a href="to-scheme.html" class="tocviewselflink" data-pltdoc="x">Racket Essentials</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">2.1&nbsp;</td><td><a href="Simple_Values.html" class="tocviewlink" data-pltdoc="x">Simple Values</a></td></tr><tr><td align="right">2.2&nbsp;</td><td><a href="syntax-overview.html" class="tocviewlink" data-pltdoc="x">Simple Definitions and Expressions</a></td></tr><tr><td align="right">2.3&nbsp;</td><td><a href="Lists__Iteration__and_Recursion.html" class="tocviewlink" data-pltdoc="x">Lists, Iteration, and Recursion</a></td></tr><tr><td align="right">2.4&nbsp;</td><td><a href="Pairs__Lists__and_Racket_Syntax.html" class="tocviewlink" data-pltdoc="x">Pairs, Lists, and Racket Syntax</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="intro.html" title="backward to &quot;1 Welcome to Racket&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Simple_Values.html" title="forward to &quot;2.1 Simple Values&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;to-scheme&quot;">2<tt>&nbsp;</tt><a name="(part._to-scheme)"></a>Racket Essentials</h3><p>This chapter provides a quick introduction to Racket as background for
+the rest of the guide. Readers with some Racket experience can safely
+skip to <a href="datatypes.html" data-pltdoc="x">Built-In Datatypes</a>.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Simple_Values.html" class="toclink" data-pltdoc="x">2.1<span class="hspace">&nbsp;</span>Simple Values</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-overview.html" class="toclink" data-pltdoc="x">2.2<span class="hspace">&nbsp;</span>Simple Definitions and Expressions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-overview.html#%28part._.Definitions%29" class="toclink" data-pltdoc="x">2.2.1<span class="hspace">&nbsp;</span>Definitions</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-overview.html#%28part._indentation%29" class="toclink" data-pltdoc="x">2.2.2<span class="hspace">&nbsp;</span>An Aside on Indenting Code</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-overview.html#%28part._.Identifiers%29" class="toclink" data-pltdoc="x">2.2.3<span class="hspace">&nbsp;</span>Identifiers</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-overview.html#%28part._.Function_.Calls__.Procedure_.Applications_%29" class="toclink" data-pltdoc="x">2.2.4<span class="hspace">&nbsp;</span>Function Calls (Procedure Applications)</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-overview.html#%28part._.Conditionals_with_if__and__or__and_cond%29" class="toclink" data-pltdoc="x">2.2.5<span class="hspace">&nbsp;</span>Conditionals with <span class="RktSym"><span class="RktStxLink">if</span></span>, <span class="RktSym"><span class="RktStxLink">and</span></span>, <span class="RktSym"><span class="RktStxLink">or</span></span>, and <span class="RktSym"><span class="RktStxLink">cond</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-overview.html#%28part._.Function_.Calls__.Again%29" class="toclink" data-pltdoc="x">2.2.6<span class="hspace">&nbsp;</span>Function Calls, Again</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-overview.html#%28part._.Anonymous_.Functions_with_lambda%29" class="toclink" data-pltdoc="x">2.2.7<span class="hspace">&nbsp;</span>Anonymous Functions with <span class="RktSym"><span class="RktStxLink">lambda</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="syntax-overview.html#%28part._local-binding-intro%29" class="toclink" data-pltdoc="x">2.2.8<span class="hspace">&nbsp;</span>Local Binding with
+<span class="RktSym"><span class="RktStxLink">define</span></span>, <span class="RktSym"><span class="RktStxLink">let</span></span>, and <span class="RktSym"><span class="RktStxLink">let*</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Lists__Iteration__and_Recursion.html" class="toclink" data-pltdoc="x">2.3<span class="hspace">&nbsp;</span>Lists, Iteration, and Recursion</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Lists__Iteration__and_Recursion.html#%28part._.Predefined_.List_.Loops%29" class="toclink" data-pltdoc="x">2.3.1<span class="hspace">&nbsp;</span>Predefined List Loops</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Lists__Iteration__and_Recursion.html#%28part._.List_.Iteration_from_.Scratch%29" class="toclink" data-pltdoc="x">2.3.2<span class="hspace">&nbsp;</span>List Iteration from Scratch</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Lists__Iteration__and_Recursion.html#%28part._tail-recursion%29" class="toclink" data-pltdoc="x">2.3.3<span class="hspace">&nbsp;</span>Tail Recursion</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Lists__Iteration__and_Recursion.html#%28part._.Recursion_versus_.Iteration%29" class="toclink" data-pltdoc="x">2.3.4<span class="hspace">&nbsp;</span>Recursion versus Iteration</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Pairs__Lists__and_Racket_Syntax.html" class="toclink" data-pltdoc="x">2.4<span class="hspace">&nbsp;</span>Pairs, Lists, and Racket Syntax</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Pairs__Lists__and_Racket_Syntax.html#%28part._quoting-lists%29" class="toclink" data-pltdoc="x">2.4.1<span class="hspace">&nbsp;</span>Quoting Pairs and Symbols with <span class="RktSym"><span class="RktStxLink">quote</span></span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Pairs__Lists__and_Racket_Syntax.html#%28part._.Abbreviating_quote_with__%29" class="toclink" data-pltdoc="x">2.4.2<span class="hspace">&nbsp;</span>Abbreviating <span class="RktSym"><span class="RktStxLink">quote</span></span> with <span class="RktVal">'</span></a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Pairs__Lists__and_Racket_Syntax.html#%28part._lists-and-syntax%29" class="toclink" data-pltdoc="x">2.4.3<span class="hspace">&nbsp;</span>Lists and Racket Syntax</a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="intro.html" title="backward to &quot;1 Welcome to Racket&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Simple_Values.html" title="forward to &quot;2.1 Simple Values&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/unit_versus_module.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/unit_versus_module.html
new file mode 100644
index 00000000..e63fd79f
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/unit_versus_module.html
@@ -0,0 +1,36 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14.7&nbsp;unit versus module</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Signatures_and_Units.html" class="tocviewlink" data-pltdoc="x">Signatures and Units</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="Invoking_Units.html" class="tocviewlink" data-pltdoc="x">Invoking Units</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="Linking_Units.html" class="tocviewlink" data-pltdoc="x">Linking Units</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="firstclassunits.html" class="tocviewlink" data-pltdoc="x">First-<wbr></wbr>Class Units</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="Whole-module_Signatures_and_Units.html" class="tocviewlink" data-pltdoc="x">Whole-<span class="RktSym"><span class="RktStxLink">module</span></span> Signatures and Units</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="Contracts_for_Units.html" class="tocviewlink" data-pltdoc="x">Contracts for Units</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="unit_versus_module.html" class="tocviewselflink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unit</span></span> versus <span class="RktSym"><span class="RktStxLink">module</span></span></a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Contracts_for_Units.html" title="backward to &quot;14.6 Contracts for Units&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="units.html" title="up to &quot;14 Units (Components)&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="reflection.html" title="forward to &quot;15 Reflection and Dynamic Evaluation&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;unit_versus_module&quot;">14.7<tt>&nbsp;</tt><a name="(part._unit_versus_module)"></a><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unit</a></span> versus <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span></h4><p>As a form for modularity, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unit</a></span> complements <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span>:</p><ul><li><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> form is primarily for managing a universal
+namespace. For example, it allows a code fragment to refer
+specifically to the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span> operation from
+<a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">racket/base</span></a>&#8212;<wbr></wbr>the one that extracts the first
+element of an instance of the built-in pair datatype&#8212;<wbr></wbr>as
+opposed to any number of other functions with the name
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span>. In other words, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> construct lets
+you refer to <span class="emph">the</span> binding that you want.</p></li><li><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unit</a></span> form is for parameterizing a code fragment
+with respect to most any kind of run-time value. For example,
+it allows a code fragment to work with a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._car%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">car</a></span>
+function that accepts a single argument, where the specific
+function is determined later by linking the fragment to
+another. In other words, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unit</a></span> construct lets you
+refer to <span class="emph">a</span> binding that meets some specification.</p></li></ul><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span> forms, among others, also allow
+parameterization of code with respect to values that are chosen
+later. In principle, any of those could be implemented in terms of any
+of the others. In practice, each form offers certain
+conveniences&#8212;<wbr></wbr>such as allowing overriding of methods or especially
+simple application to values&#8212;<wbr></wbr>that make them suitable for different
+purposes.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> form is more fundamental than the others, in a
+sense. After all, a program fragment cannot reliably refer to a
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=lambda.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._lambda%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">lambda</a></span>, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=createclass.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fclass-internal..rkt%2529._class%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">class</a></span>, or <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unit</a></span> form without the
+namespace management provided by <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span>. At the same time,
+because namespace management is closely related to separate expansion
+and compilation, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> boundaries end up as
+separate-compilation boundaries in a way that prohibits mutual
+dependencies among fragments. For similar reasons, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span>
+does not separate interface from implementation.</p><p>Use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unit</a></span> when <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=module.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._module%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">module</a></span> by itself almost works, but
+when separately compiled pieces must refer to each other, or when you
+want a stronger separation between <span style="font-style: italic">interface</span> (i.e., the
+parts that need to be known at expansion and compilation time) and
+<span style="font-style: italic">implementation</span> (i.e., the run-time parts). More generally,
+use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=creatingunits.html%23%2528form._%2528%2528lib._racket%252Funit..rkt%2529._unit%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">unit</a></span> when you need to parameterize code over functions,
+datatypes, and classes, and when the parameterized code itself
+provides definitions to be linked with other parameterized code.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="Contracts_for_Units.html" title="backward to &quot;14.6 Contracts for Units&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="units.html" title="up to &quot;14 Units (Components)&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="reflection.html" title="forward to &quot;15 Reflection and Dynamic Evaluation&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/units.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/units.html
new file mode 100644
index 00000000..9546b924
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/units.html
@@ -0,0 +1,15 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>14&nbsp;Units</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>14&nbsp;</td><td><a href="units.html" class="tocviewselflink" data-pltdoc="x">Units</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">14.1&nbsp;</td><td><a href="Signatures_and_Units.html" class="tocviewlink" data-pltdoc="x">Signatures and Units</a></td></tr><tr><td align="right">14.2&nbsp;</td><td><a href="Invoking_Units.html" class="tocviewlink" data-pltdoc="x">Invoking Units</a></td></tr><tr><td align="right">14.3&nbsp;</td><td><a href="Linking_Units.html" class="tocviewlink" data-pltdoc="x">Linking Units</a></td></tr><tr><td align="right">14.4&nbsp;</td><td><a href="firstclassunits.html" class="tocviewlink" data-pltdoc="x">First-<wbr></wbr>Class Units</a></td></tr><tr><td align="right">14.5&nbsp;</td><td><a href="Whole-module_Signatures_and_Units.html" class="tocviewlink" data-pltdoc="x">Whole-<span class="RktSym"><span class="RktStxLink">module</span></span> Signatures and Units</a></td></tr><tr><td align="right">14.6&nbsp;</td><td><a href="Contracts_for_Units.html" class="tocviewlink" data-pltdoc="x">Contracts for Units</a></td></tr><tr><td align="right">14.7&nbsp;</td><td><a href="unit_versus_module.html" class="tocviewlink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">unit</span></span> versus <span class="RktSym"><span class="RktStxLink">module</span></span></a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="classes.html" title="backward to &quot;13 Classes and Objects&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Signatures_and_Units.html" title="forward to &quot;14.1 Signatures and Units&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h3 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;units&quot;">14<tt>&nbsp;</tt><a name="(part._units)"></a>Units (Components)</h3><p><a name="(tech._unit)"></a><span style="font-style: italic">Units</span> organize a program into separately compilable and
+reusable <a name="(tech._component)"></a><span style="font-style: italic">components</span>. A unit resembles a procedure in that
+both are first-class values that are used for abstraction. While
+procedures abstract over values in expressions, units abstract over
+names in collections of definitions. Just as a procedure is called to
+evaluate its expressions given actual arguments for its formal
+parameters, a unit is <a name="(tech._invoked)"></a><span style="font-style: italic">invoked</span> to evaluate its definitions
+given actual references for its imported variables. Unlike a
+procedure, however, a unit&rsquo;s imported variables can be partially
+linked with the exported variables of another unit <span style="font-style: italic">prior to
+invocation</span>. Linking merges multiple units together into a single
+compound unit. The compound unit itself imports variables that will be
+propagated to unresolved imported variables in the linked units, and
+re-exports some variables from the linked units for further linking.</p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Signatures_and_Units.html" class="toclink" data-pltdoc="x">14.1<span class="hspace">&nbsp;</span>Signatures and Units</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Invoking_Units.html" class="toclink" data-pltdoc="x">14.2<span class="hspace">&nbsp;</span>Invoking Units</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Linking_Units.html" class="toclink" data-pltdoc="x">14.3<span class="hspace">&nbsp;</span>Linking Units</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="firstclassunits.html" class="toclink" data-pltdoc="x">14.4<span class="hspace">&nbsp;</span>First-Class Units</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Whole-module_Signatures_and_Units.html" class="toclink" data-pltdoc="x">14.5<span class="hspace">&nbsp;</span>Whole-<span class="RktSym"><span class="RktStxLink">module</span></span> Signatures and Units</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Contracts_for_Units.html" class="toclink" data-pltdoc="x">14.6<span class="hspace">&nbsp;</span>Contracts for Units</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Contracts_for_Units.html#%28part._.Adding_.Contracts_to_.Signatures%29" class="toclink" data-pltdoc="x">14.6.1<span class="hspace">&nbsp;</span>Adding Contracts to Signatures</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="Contracts_for_Units.html#%28part._.Adding_.Contracts_to_.Units%29" class="toclink" data-pltdoc="x">14.6.2<span class="hspace">&nbsp;</span>Adding Contracts to Units</a></p></td></tr><tr><td><p><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><a href="unit_versus_module.html" class="toclink" data-pltdoc="x">14.7<span class="hspace">&nbsp;</span><span class="RktSym"><span class="RktStxLink">unit</span></span> versus <span class="RktSym"><span class="RktStxLink">module</span></span></a></p></td></tr></table><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="classes.html" title="backward to &quot;13 Classes and Objects&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="index.html" title="up to &quot;The Racket Guide&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="Signatures_and_Units.html" title="forward to &quot;14.1 Signatures and Units&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/vectors.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/vectors.html
new file mode 100644
index 00000000..cb746fcb
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/vectors.html
@@ -0,0 +1,16 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.9&nbsp;Vectors</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="icons.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewselflink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings (Unicode)</a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Bytes and Byte Strings</a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="vectors.html" class="tocviewselflink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="hash-tables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="void_undefined.html" class="tocviewlink" data-pltdoc="x">Void and Undefined</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="pairs.html" title="backward to &quot;3.8 Pairs and Lists&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="hash-tables.html" title="forward to &quot;3.10 Hash Tables&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;vectors&quot;">3.9<tt>&nbsp;</tt><a name="(part._vectors)"></a>Vectors</h4><p>A <a name="(tech._vector)"></a><span style="font-style: italic">vector</span> is a fixed-length array of arbitrary
+values. Unlike a list, a vector supports constant-time access and
+update of its elements.</p><p>A vector prints similar to a list&#8212;<wbr></wbr>as a parenthesized sequence of its
+elements&#8212;<wbr></wbr>but a vector is prefixed with <span class="RktInBG"><span class="hspace"></span><span class="RktIn">#</span><span class="hspace"></span></span> after
+<span class="RktInBG"><span class="hspace"></span><span class="RktIn">'</span><span class="hspace"></span></span>, or it uses <span class="RktRes">vector</span> if one of its elements
+cannot be expressed with <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span>.</p><p>For a vector as an expression, an optional length can be
+supplied. Also, a vector as an expression implicitly <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=quote.html%23%2528form._%2528%2528quote._%7E23%7E25kernel%2529._quote%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">quote</a></span>s
+the forms for its content, which means that identifiers and
+parenthesized forms in a vector constant represent symbols and lists.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=reader.html%23%2528part._parse-vector%2529&amp;version=8.6" class="Sq" data-pltdoc="x">Reading Vectors</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> documents the fine points of the syntax of vectors.</p></blockquote></blockquote></blockquote><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktVal">#("a" "b" "c")</span></td></tr><tr><td><p><span class="RktRes">'#("a" "b" "c")</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">#(name (that tune))</span></td></tr><tr><td><p><span class="RktRes">'#(name (that tune))</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktVal">#4(baldwin bruce)</span></td></tr><tr><td><p><span class="RktRes">'#(baldwin bruce bruce bruce)</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=vectors.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._vector-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">vector-ref</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">"a"</span><span class="hspace">&nbsp;</span><span class="RktVal">"b"</span><span class="hspace">&nbsp;</span><span class="RktVal">"c"</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">"b"</span></p></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=vectors.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._vector-ref%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">vector-ref</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">name</span><span class="hspace">&nbsp;</span><span class="RktVal">(</span><span class="RktVal">that</span><span class="hspace">&nbsp;</span><span class="RktVal">tune</span><span class="RktVal">)</span><span class="RktVal">)</span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(that tune)</span></p></td></tr></table></blockquote></div></p><p>Like strings, a vector is either mutable or immutable, and vectors
+written directly as expressions are immutable.</p><p>Vectors can be converted to lists and vice versa via
+<span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=vectors.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._vector-%7E3elist%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">vector-&gt;list</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=vectors.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list-%7E3evector%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list-&gt;vector</a></span>; such conversions are
+particularly useful in combination with predefined procedures on
+lists. When allocating extra lists seems too expensive, consider
+using looping forms like <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=for.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._for%252Ffold%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">for/fold</a></span>, which recognize vectors as
+well as lists.</p><p><div class="SIntrapara">Example:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=vectors.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list-%7E3evector%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list-&gt;vector</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmap..rkt%2529._map%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">map</a></span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string-titlecase%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">string-titlecase</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=vectors.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._vector-%7E3elist%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">vector-&gt;list</a></span><span class="hspace">&nbsp;</span><span class="RktVal">#</span><span class="RktVal">(</span><span class="RktVal">"three"</span><span class="hspace">&nbsp;</span><span class="RktVal">"blind"</span><span class="hspace">&nbsp;</span><span class="RktVal">"mice"</span><span class="RktVal">)</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p><span class="RktRes">'#("Three" "Blind" "Mice")</span></p></td></tr></table></blockquote></div></p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="imageleft"><img src="magnify.png" alt="+" width="24" height="24"/></span><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=vectors.html&amp;version=8.6" class="Sq" data-pltdoc="x">Vectors</a> in <a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=index.html&amp;version=8.6" class="Sq" data-pltdoc="x">The Racket Reference</a> provides more on vectors and vector procedures.</p></blockquote></blockquote></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="pairs.html" title="backward to &quot;3.8 Pairs and Lists&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="hash-tables.html" title="forward to &quot;3.10 Hash Tables&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/void_undefined.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/void_undefined.html
new file mode 100644
index 00000000..73f79bfb
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/void_undefined.html
@@ -0,0 +1,15 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>3.12&nbsp;Void and Undefined</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewselflink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">3.1&nbsp;</td><td><a href="booleans.html" class="tocviewlink" data-pltdoc="x">Booleans</a></td></tr><tr><td align="right">3.2&nbsp;</td><td><a href="numbers.html" class="tocviewlink" data-pltdoc="x">Numbers</a></td></tr><tr><td align="right">3.3&nbsp;</td><td><a href="characters.html" class="tocviewlink" data-pltdoc="x">Characters</a></td></tr><tr><td align="right">3.4&nbsp;</td><td><a href="strings.html" class="tocviewlink" data-pltdoc="x">Strings (Unicode)</a></td></tr><tr><td align="right">3.5&nbsp;</td><td><a href="bytestrings.html" class="tocviewlink" data-pltdoc="x">Bytes and Byte Strings</a></td></tr><tr><td align="right">3.6&nbsp;</td><td><a href="symbols.html" class="tocviewlink" data-pltdoc="x">Symbols</a></td></tr><tr><td align="right">3.7&nbsp;</td><td><a href="keywords.html" class="tocviewlink" data-pltdoc="x">Keywords</a></td></tr><tr><td align="right">3.8&nbsp;</td><td><a href="pairs.html" class="tocviewlink" data-pltdoc="x">Pairs and Lists</a></td></tr><tr><td align="right">3.9&nbsp;</td><td><a href="vectors.html" class="tocviewlink" data-pltdoc="x">Vectors</a></td></tr><tr><td align="right">3.10&nbsp;</td><td><a href="hash-tables.html" class="tocviewlink" data-pltdoc="x">Hash Tables</a></td></tr><tr><td align="right">3.11&nbsp;</td><td><a href="boxes.html" class="tocviewlink" data-pltdoc="x">Boxes</a></td></tr><tr><td align="right">3.12&nbsp;</td><td><a href="void_undefined.html" class="tocviewselflink" data-pltdoc="x">Void and Undefined</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="boxes.html" title="backward to &quot;3.11 Boxes&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="forward to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;void+undefined&quot;">3.12<tt>&nbsp;</tt><a name="(part._void+undefined)"></a>Void and Undefined</h4><p>Some procedures or expression forms have no need for a result
+value. For example, the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=Writing.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._display%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">display</a></span> procedure is called only for
+the side-effect of writing output. In such cases the result value is
+normally a special constant that prints as <a href="void_undefined.html" class="RktModLink" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.  When the
+result of an expression is simply <a href="void_undefined.html" class="RktModLink" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>, the <a href="intro.html#%28tech._repl%29" class="techoutside" data-pltdoc="x"><span class="techinside">REPL</span></a> does not
+print anything.</p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void</a></span> procedure takes any number of arguments and returns
+<a href="void_undefined.html" class="RktModLink" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>. (That is, the identifier <span class="RktSym">void</span> is bound
+to a procedure that returns <a href="void_undefined.html" class="RktModLink" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>, instead of being bound
+directly to <a href="void_undefined.html" class="RktModLink" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;void&gt;</span></span></a>.)</p><p><div class="SIntrapara">Examples:</div><div class="SIntrapara"><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void</a></span><span class="hspace">&nbsp;</span><span class="RktVal">1</span><span class="hspace">&nbsp;</span><span class="RktVal">2</span><span class="hspace">&nbsp;</span><span class="RktVal">3</span><span class="RktPn">)</span></td></tr><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">void</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktRes">'(#&lt;void&gt;)</span></p></td></tr></table></blockquote></div></p><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=undefined.html%23%2528def._%2528%2528lib._racket%252Fundefined..rkt%2529._undefined%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">undefined</a></span> constant, which prints as <a href="void_undefined.html" class="RktModLink" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;undefined&gt;</span></span></a>, is
+sometimes used as the result of a reference whose value is not yet
+available. In previous versions of Racket (before version 6.1),
+referencing a local binding too early produced <a href="void_undefined.html" class="RktModLink" data-pltdoc="x"><span class="nobreak"><span class="RktRes">#&lt;undefined&gt;</span></span></a>;
+too-early references now raise an exception, instead.</p><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p>The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=undefined.html%23%2528def._%2528%2528lib._racket%252Fundefined..rkt%2529._undefined%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">undefined</a></span> result can still be produced
+in some cases by the <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=shared.html%23%2528form._%2528%2528lib._racket%252Fshared..rkt%2529._shared%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">shared</a></span> form.</p></blockquote></blockquote></blockquote><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0"><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">fails</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="hspace">&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktSym">x</span><span class="RktPn">)</span></td></tr></table></td></tr><tr><td><p>&nbsp;</p></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="stt">&gt; </span><span class="RktPn">(</span><span class="RktSym">fails</span><span class="RktPn">)</span></td></tr><tr><td><p><span class="RktErr">x: undefined;</span></p></td></tr><tr><td><p><span class="RktErr"></span><span class="hspace">&nbsp;</span><span class="RktErr">cannot use before initialization</span></p></td></tr></table></td></tr></table></blockquote><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="boxes.html" title="backward to &quot;3.11 Boxes&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="datatypes.html" title="up to &quot;3 Built-In Datatypes&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="scheme-forms.html" title="forward to &quot;4 Expressions and Definitions&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/guide/with-syntax.html b/clones/download.racket-lang.org/releases/8.6/doc/guide/with-syntax.html
new file mode 100644
index 00000000..94174765
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/guide/with-syntax.html
@@ -0,0 +1,20 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>16.2.4&nbsp;with-syntax and generate-temporaries</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">The Racket Guide</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="intro.html" class="tocviewlink" data-pltdoc="x">Welcome to Racket</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="to-scheme.html" class="tocviewlink" data-pltdoc="x">Racket Essentials</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="datatypes.html" class="tocviewlink" data-pltdoc="x">Built-<wbr></wbr>In Datatypes</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="scheme-forms.html" class="tocviewlink" data-pltdoc="x">Expressions and Definitions</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="define-struct.html" class="tocviewlink" data-pltdoc="x">Programmer-<wbr></wbr>Defined Datatypes</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="modules.html" class="tocviewlink" data-pltdoc="x">Modules</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="contracts.html" class="tocviewlink" data-pltdoc="x">Contracts</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="i_o.html" class="tocviewlink" data-pltdoc="x">Input and Output</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="regexp.html" class="tocviewlink" data-pltdoc="x">Regular Expressions</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="control.html" class="tocviewlink" data-pltdoc="x">Exceptions and Control</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="for.html" class="tocviewlink" data-pltdoc="x">Iterations and Comprehensions</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="match.html" class="tocviewlink" data-pltdoc="x">Pattern Matching</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="classes.html" class="tocviewlink" data-pltdoc="x">Classes and Objects</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="units.html" class="tocviewlink" data-pltdoc="x">Units</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="reflection.html" class="tocviewlink" data-pltdoc="x">Reflection and Dynamic Evaluation</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="macros.html" class="tocviewselflink" data-pltdoc="x">Macros</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="languages.html" class="tocviewlink" data-pltdoc="x">Creating Languages</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="concurrency.html" class="tocviewlink" data-pltdoc="x">Concurrency and Synchronization</a></td></tr><tr><td align="right">19&nbsp;</td><td><a href="performance.html" class="tocviewlink" data-pltdoc="x">Performance</a></td></tr><tr><td align="right">20&nbsp;</td><td><a href="parallelism.html" class="tocviewlink" data-pltdoc="x">Parallelism</a></td></tr><tr><td align="right">21&nbsp;</td><td><a href="running.html" class="tocviewlink" data-pltdoc="x">Running and Creating Executables</a></td></tr><tr><td align="right">22&nbsp;</td><td><a href="More_Libraries.html" class="tocviewlink" data-pltdoc="x">More Libraries</a></td></tr><tr><td align="right">23&nbsp;</td><td><a href="dialects.html" class="tocviewlink" data-pltdoc="x">Dialects of Racket and Scheme</a></td></tr><tr><td align="right">24&nbsp;</td><td><a href="other-editors.html" class="tocviewlink" data-pltdoc="x">Command-<wbr></wbr>Line Tools and Your Editor of Choice</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9658;</a></td><td>16&nbsp;</td><td><a href="macros.html" class="tocviewlink" data-pltdoc="x">Macros</a></td></tr></table><div class="tocviewsublist" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.1&nbsp;</td><td><a href="pattern-macros.html" class="tocviewlink" data-pltdoc="x">Pattern-<wbr></wbr>Based Macros</a></td></tr><tr><td align="right">16.2&nbsp;</td><td><a href="proc-macros.html" class="tocviewselflink" data-pltdoc="x">General Macro Transformers</a></td></tr><tr><td align="right">16.3&nbsp;</td><td><a href="macro-module.html" class="tocviewlink" data-pltdoc="x">Module Instantiations and Visits</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9660;</a></td><td>16.2&nbsp;</td><td><a href="proc-macros.html" class="tocviewlink" data-pltdoc="x">General Macro Transformers</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">16.2.1&nbsp;</td><td><a href="stx-obj.html" class="tocviewlink" data-pltdoc="x">Syntax Objects</a></td></tr><tr><td align="right">16.2.2&nbsp;</td><td><a href="macro-transformers.html" class="tocviewlink" data-pltdoc="x">Macro Transformer Procedures</a></td></tr><tr><td align="right">16.2.3&nbsp;</td><td><a href="syntax-case.html" class="tocviewlink" data-pltdoc="x">Mixing Patterns and Expressions:<span class="mywbr"> &nbsp;</span> <span class="RktSym"><span class="RktStxLink">syntax-<wbr></wbr>case</span></span></a></td></tr><tr><td align="right">16.2.4&nbsp;</td><td><a href="with-syntax.html" class="tocviewselflink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">with-<wbr></wbr>syntax</span></span> and <span class="RktSym"><span class="RktValLink">generate-<wbr></wbr>temporaries</span></span></a></td></tr><tr><td align="right">16.2.5&nbsp;</td><td><a href="stx-phases.html" class="tocviewlink" data-pltdoc="x">Compile and Run-<wbr></wbr>Time Phases</a></td></tr><tr><td align="right">16.2.6&nbsp;</td><td><a href="phases.html" class="tocviewlink" data-pltdoc="x">General Phase Levels</a></td></tr><tr><td align="right">16.2.7&nbsp;</td><td><a href="stx-certs.html" class="tocviewlink" data-pltdoc="x">Tainted Syntax</a></td></tr></table></div></div></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="syntax-case.html" title="backward to &quot;16.2.3 Mixing Patterns and Expressions: syntax-case&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="proc-macros.html" title="up to &quot;16.2 General Macro Transformers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stx-phases.html" title="forward to &quot;16.2.5 Compile and Run-Time Phases&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h5 x-source-module="(lib &quot;scribblings/guide/guide.scrbl&quot;)" x-source-pkg="racket-doc" x-part-tag="&quot;with-syntax&quot;">16.2.4<tt>&nbsp;</tt><a name="(part._with-syntax)"></a><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._with-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-syntax</a></span> and <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._generate-temporaries%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">generate-temporaries</a></span></h5><p>Since <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span> lets us compute with arbitrary Racket
+expressions, we can more simply solve a problem that we had in
+writing <span class="RktSym">define-for-cbr</span> (see
+<a href="pattern-macros.html#%28part._pattern-macro-example%29" data-pltdoc="x">Extended Example: Call-by-Reference Functions</a>), where we needed to generate a
+set of names based on a sequence <span class="RktSym">id</span><span class="stt"> </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span>:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-for-cbr</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">do-f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">body</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">....</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">do-f</span><span class="hspace">&nbsp;</span><span class="RktSym">get</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym">put</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-get/put-id</span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym">get</span><span class="hspace">&nbsp;</span><span class="RktSym">put</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">body</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>In place of the <span class="RktSym">....</span>s above, we need to bind <span class="RktSym">get</span><span class="stt"> </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span> and <span class="RktSym">put</span><span class="stt"> </span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span> to lists of generated identifiers. We
+cannot use <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=let.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fletstx-scheme..rkt%2529._let%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">let</a></span> to bind <span class="RktSym">get</span> and <span class="RktSym">put</span>,
+because we need bindings that count as pattern variables, instead
+of normal local variables. The <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._with-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-syntax</a></span> form lets us
+bind pattern variables:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-for-cbr</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">do-f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">body</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._with-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">get</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">put</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">....</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">do-f</span><span class="hspace">&nbsp;</span><span class="RktSym">get</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym">put</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-get/put-id</span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym">get</span><span class="hspace">&nbsp;</span><span class="RktSym">put</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">body</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>Now we need an expression in place of <span class="RktSym">....</span> that
+generates as many identifiers as there are <span class="RktSym">id</span> matches in
+the original pattern. Since this is a common task, Racket
+provides a helper function, <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._generate-temporaries%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">generate-temporaries</a></span>, that
+takes a sequence of identifiers and returns a sequence of
+generated identifiers:</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-for-cbr</span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span><span class="hspace">&nbsp;</span><span class="RktSym">stx</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529.__%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">_</a></span><span class="hspace">&nbsp;</span><span class="RktSym">do-f</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym">body</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._with-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-syntax</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">get</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._generate-temporaries%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">generate-temporaries</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">[</span><span class="RktPn">(</span><span class="RktSym">put</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stxops.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._generate-temporaries%2529%2529&amp;version=8.6" class="RktValLink Sq" data-pltdoc="x">generate-temporaries</a></span><span class="hspace">&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktRdr">#'</span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=define.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._define%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">define</a></span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">do-f</span><span class="hspace">&nbsp;</span><span class="RktSym">get</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="hspace">&nbsp;</span><span class="RktSym">put</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym">define-get/put-id</span><span class="hspace">&nbsp;</span><span class="RktSym">id</span><span class="hspace">&nbsp;</span><span class="RktSym">get</span><span class="hspace">&nbsp;</span><span class="RktSym">put</span><span class="RktPn">)</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._......%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">...</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktSym">body</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">]</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>This way of generating identifiers is normally easier to think
+about than tricking the macro expander into generating names with
+purely pattern-based macros.</p><p>In general, the left-hand side of a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._with-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-syntax</a></span>
+binding is a pattern, just like in <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span>. In fact,
+a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._with-syntax%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">with-syntax</a></span> form is just a <span class="RktSym"><a href="https://download.racket-lang.org/releases/8.6/doc/local-redirect/index.html?doc=reference&amp;rel=stx-patterns.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fstxcase-scheme..rkt%2529._syntax-case%2529%2529&amp;version=8.6" class="RktStxLink Sq" data-pltdoc="x">syntax-case</a></span> form
+turned partially inside-out.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" id="searchbox" type="text" tabindex="1" placeholder="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;8.6&quot;, &quot;../&quot;);"/></form>&nbsp;&nbsp;<a href="https://download.racket-lang.org/releases/8.6/doc/index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;8.6&quot;);">top</a><span class="tocsettoggle">&nbsp;&nbsp;<a href="javascript:void(0);" title="show/hide table of contents" onclick="TocsetToggle();">contents</a></span></span><span class="navright">&nbsp;&nbsp;<a href="syntax-case.html" title="backward to &quot;16.2.3 Mixing Patterns and Expressions: syntax-case&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="proc-macros.html" title="up to &quot;16.2 General Macro Transformers&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="stx-phases.html" title="forward to &quot;16.2.5 Compile and Run-Time Phases&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>
\ No newline at end of file
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/local-redirect/local-redirect.js b/clones/download.racket-lang.org/releases/8.6/doc/local-redirect/local-redirect.js
new file mode 100644
index 00000000..c2830be6
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/local-redirect/local-redirect.js
@@ -0,0 +1,210 @@
+// Autogenerated by `scribblings/main/private/local-redirect'
+//  This script is included by generated documentation to rewrite
+//  links expressed as tag queries into local-filesystem links.
+
+var link_dirs = [
+ ["2d", "../2d"],
+ ["algol60", "../algol60"],
+ ["browser", "../browser"],
+ ["bug-report", "../bug-report"],
+ ["cards", "../cards"],
+ ["compatibility", "../compatibility"],
+ ["continue", "../continue"],
+ ["contract-profile", "../contract-profile"],
+ ["cookies", "../cookies"],
+ ["data", "../data"],
+ ["datalog", "../datalog"],
+ ["db", "../db"],
+ ["deinprogramm", "../deinprogramm"],
+ ["demo-m1", "../demo-m1"],
+ ["demo-m2", "../demo-m2"],
+ ["demo-manual-m1", "../demo-manual-m1"],
+ ["demo-manual-m2", "../demo-manual-m2"],
+ ["demo-manual-s1", "../demo-manual-s1"],
+ ["demo-manual-s2", "../demo-manual-s2"],
+ ["demo-s1", "../demo-s1"],
+ ["demo-s2", "../demo-s2"],
+ ["distributed-places", "../distributed-places"],
+ ["draw", "../draw"],
+ ["drracket", "../drracket"],
+ ["drracket-tools", "../drracket-tools"],
+ ["ds-store", "../ds-store"],
+ ["dynext", "../dynext"],
+ ["embedded-gui", "../embedded-gui"],
+ ["eopl", "../eopl"],
+ ["errortrace", "../errortrace"],
+ ["expeditor", "../expeditor"],
+ ["file", "../file"],
+ ["foreign", "../foreign"],
+ ["framework", "../framework"],
+ ["frtime", "../frtime"],
+ ["future-visualizer", "../future-visualizer"],
+ ["games", "../games"],
+ ["getting-started", "../getting-started"],
+ ["gl-board-game", "../gl-board-game"],
+ ["graphics", "../graphics"],
+ ["gui", "../gui"],
+ ["guide", "../guide"],
+ ["help", "../help"],
+ ["htdp", "../htdp"],
+ ["htdp-langs", "../htdp-langs"],
+ ["htdp-ptr", "../htdp-ptr"],
+ ["html", "../html"],
+ ["images", "../images"],
+ ["inside", "../inside"],
+ ["json", "../json"],
+ ["lazy", "../lazy"],
+ ["macro-debugger", "../macro-debugger"],
+ ["make", "../make"],
+ ["math", "../math"],
+ ["more", "../more"],
+ ["mrlib", "../mrlib"],
+ ["mysterx", "../mysterx"],
+ ["mzcom", "../mzcom"],
+ ["mzlib", "../mzlib"],
+ ["mzscheme", "../mzscheme"],
+ ["net", "../net"],
+ ["openssl", "../openssl"],
+ ["optimization-coach", "../optimization-coach"],
+ ["option-contract", "../option-contract"],
+ ["osx-ssl", "../osx-ssl"],
+ ["parser-tools", "../parser-tools"],
+ ["pict", "../pict"],
+ ["pict-snip", "../pict-snip"],
+ ["picturing-programs", "../picturing-programs"],
+ ["pkg", "../pkg"],
+ ["plai", "../plai"],
+ ["planet", "../planet"],
+ ["plot", "../plot"],
+ ["plt-installer", "../plt-installer"],
+ ["preprocessor", "../preprocessor"],
+ ["profile", "../profile"],
+ ["quick", "../quick"],
+ ["quickscript", "../quickscript"],
+ ["quickscript-test", "../quickscript-test"],
+ ["r5rs", "../r5rs"],
+ ["r6rs", "../r6rs"],
+ ["racket-cheat", "../racket-cheat"],
+ ["racklog", "../racklog"],
+ ["rackunit", "../rackunit"],
+ ["raco", "../raco"],
+ ["readline", "../readline"],
+ ["redex", "../redex"],
+ ["reference", "../reference"],
+ ["sasl", "../sasl"],
+ ["scheme", "../scheme"],
+ ["scribble", "../scribble"],
+ ["scribble-pp", "../scribble-pp"],
+ ["scriblib", "../scriblib"],
+ ["sgl", "../sgl"],
+ ["simple-tree-text-markup", "../simple-tree-text-markup"],
+ ["slatex-wrap", "../slatex-wrap"],
+ ["slideshow", "../slideshow"],
+ ["source-syntax", "../source-syntax"],
+ ["srfi", "../srfi"],
+ ["stepper", "../stepper"],
+ ["string-constants", "../string-constants"],
+ ["style", "../style"],
+ ["swindle", "../swindle"],
+ ["syntax", "../syntax"],
+ ["syntax-color", "../syntax-color"],
+ ["teachpack", "../teachpack"],
+ ["test-engine", "../test-engine"],
+ ["tool", "../tool"],
+ ["tools", "../tools"],
+ ["trace", "../trace"],
+ ["ts-guide", "../ts-guide"],
+ ["ts-reference", "../ts-reference"],
+ ["turtles", "../turtles"],
+ ["unix-socket", "../unix-socket"],
+ ["version", "../version"],
+ ["web-server", "../web-server"],
+ ["web-server-internal", "../web-server-internal"],
+ ["win32-ssl", "../win32-ssl"],
+ ["xml", "../xml"],
+ ["xrepl", "../xrepl"]];
+
+function bsearch(str, a, start, end) {
+   if (start >= end)
+     return false;
+   else {
+     var mid = Math.floor((start + end) / 2);
+     if (a[mid][0] == str)
+       return mid;
+     else if (a[mid][0] < str)
+       return bsearch(str, a, mid+1, end);
+     else
+       return bsearch(str, a, start, mid);
+   }
+}
+
+var link_target_prefix = false;
+
+function hash_string(s) {
+   var v = 0;
+   for (var i = 0; i < s.length; i++) {
+     v = (((v << 5) - v) + s.charCodeAt(i)) & 0xFFFFFF;
+   }
+   return v;
+}
+
+function demand_load(p, callback) {
+   // Based on a StackOverflow answer, which cites:
+   // JavaScript Patterns, by Stoyan Stefanov (O’Reilly). Copyright 2010 Yahoo!, Inc., 9780596806750.
+   var script = document.getElementsByTagName('script')[0];
+   var newjs = document.createElement('script');
+   newjs.src = p;
+   if (callback) {
+      // IE
+      newjs.onreadystatechange = function () {
+          if (newjs.readyState === 'loaded' || newjs.readyState === 'complete') {
+            newjs.onreadystatechange = null;
+            callback();
+          }
+        };
+      // others
+      newjs.onload = callback;
+   }
+   script.parentNode.appendChild(newjs);
+}
+
+var loaded_link_targets = [];
+var link_targets = [];
+var num_link_target_bins = 7;
+
+function convert_all_links() {
+   var elements = document.getElementsByClassName("Sq");
+   for (var i = 0; i < elements.length; i++) {
+     var elem = elements[i];
+     var tag = elem.href.match(/tag=[^&]*/);
+     var doc = elem.href.match(/doc=[^&]*/);
+     var rel = elem.href.match(/rel=[^&]*/);
+     if (doc && rel) {
+         var pos = bsearch(decodeURIComponent(doc[0].substring(4)),
+                                     link_dirs,
+                                     0,
+                                     link_dirs.length);
+         if (pos) {
+           var p = link_dirs[pos][1];
+           if (link_target_prefix) {
+             p = link_target_prefix + p;
+           }
+           elem.href = p + "/" + decodeURIComponent(rel[0].substring(4));
+           tag = false;
+         }
+     }
+     if (tag) {
+       var v = hash_string(decodeURIComponent(tag[0].substring(4))) % 7;
+       if (!loaded_link_targets[v]) {
+         loaded_link_targets[v] = true;
+         var p = "../local-redirect/local-redirect_" + v + ".js";
+         if (link_target_prefix) {
+           p = link_target_prefix + p;
+         }
+         demand_load(p, false);
+       }
+     }
+  }
+}
+
+AddOnLoad(convert_all_links);
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/local-redirect/local-user-redirect.js b/clones/download.racket-lang.org/releases/8.6/doc/local-redirect/local-user-redirect.js
new file mode 100644
index 00000000..e69de29b
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/manual-fonts.css b/clones/download.racket-lang.org/releases/8.6/doc/manual-fonts.css
new file mode 100644
index 00000000..0801112b
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/manual-fonts.css
@@ -0,0 +1,251 @@
+@font-face {
+font-family: Cooper-Hewitt;
+font-style: normal;
+font-weight: bold;
+font-stretch: normal;
+src: url('data:application/font-woff;charset=utf-8;base64,d09GRgABAAAAADz8ABEAAAAAgKQAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAABGRlRNAAABgAAAABwAAAAce92mdUdERUYAAAGcAAAANgAAAEIDYQQuR1BPUwAAAdQAAAQyAAAU5m9JQYtHU1VCAAAGCAAAAiEAAAOGPYUP8k9TLzIAAAgsAAAAUwAAAGDC6LsMY21hcAAACIAAAAJUAAADZloTMqdjdnQgAAAK1AAAAAQAAAAEACECeWdhc3AAAArYAAAACAAAAAgAAAAQZ2x5ZgAACuAAACi+AABS/E3zEcZoZWFkAAAzoAAAADYAAAA2CUlVUmhoZWEAADPYAAAAIQAAACQIRARmaG10eAAAM/wAAAJSAAAESivaM/9sb2NhAAA2UAAAAigAAAIoyVre4G1heHAAADh4AAAAIAAAACABWwCYbmFtZQAAOJgAAAHOAAAFPm+7uUBwb3N0AAA6aAAAAooAAAOvrpTpIXdlYmYAADz0AAAABgAAAAYCoFoSAAAAAQAAAADV7pT1AAAAAM+3XmMAAAAA1jezHHjaHYvBCYBAAMOSKuiBL8dxNUVXtxwlEAJF4ChXCRtO9i4M7vrDW/8UjSEunu3rfPADVNUClQAAeNrFWEtoVFcY/jJJnNHaRM0k5jUaXzExim03XXVRqqKoVaMVtFXra6WoiFDEjZvSLLqQUko31W6qoC5ciGbTuAkiVoOE+ACTEhTiJIRa4ZLFiD1+57/n3rnzuJObydz0fPwn5/73nP/853+dyUUZgDnYiN2ItLCh6vjBMyfQiAryoRT0+2ZUfL53fQuav+jcxb5z21b2uzo3s3fnlB07evoEYnokVIGI/I0hUnNBS6vumv8j1mA1QmzqamiSrcKylTUt2ZZ6TVhCE9ORlSG3X93N4oykMU3ZDyj9KalHJVWvnEBgTmN5OYFlptLWCDD7dXD7GqmpINoE11jkjojkoZLqO2T7TeQns5ExU56zuf+HHULNalpXdQu0BYaNJUYNdM64dlB9rqW6C8q8rV5y5U11XfVm+ymNqeaxjgex8UhJ42FUbTGZwTVqgvTCxauM3COH/aAa9HpGjRu8mSF9J5zZ+dawvgmKqZMhxdcD1eXa43fBzx54okE/2z1rXtLM7jVrNJIzom+/x39/C/pc3M+YSQ77+4Roph5xbtKsIbLkPs3Zyee+sJ+ZicMmwuzK4swtcG5qMKgz1alexLgHOfXMzetkbpVz7jfZ3a4PF11c9mquOey7iB41QK313B6zRmMgN4KN3EcaObe1JdqmvJU4dzTpnT+lKhwsmkTuWOnlTj1HZ1Zf3mmjebku/H5vFPFbLQy/pYLpU5zfPPeFle9tEXYISd/Q5IaUF6WTqx7n4SX9at9klcbvfi1ZvlnqpV92+OVIsH3z5nFhuf8WXa0K/tILlOdjee0wlkaxdvCvPr52KKxvGcqhSH5vbZq8VWIWovKf/mzMEc4HmIsPZVSFaszDfCxADeKoRR0Woh4NGesb0aS/GyCBRexbhLeEtBTLsBwrOGrFSuG2oR2r0FGibwaVHoAnyG4x0d+BHscN6vm0mHqnob+JJAyc1iT6O4CQ3TqEKrkuynWaYmY/yPqEsSPEil4CZdoEWrVVaAGt41AN+XGStvFql9LN/gpj99q/dgx0+FiowlAQW9r76lYr/Sz3XR1poegUpTYxRkmzez6nJcS+jYyWxYwXHQWrJApWyBn12dp4tuWMCR1by2iL9hBiIJ53Tp0LPW4w0Ccod32ekOjV0W6jxQCivwPts6UGtkcruS4ukVUlmWBTtVCtsYSdDV5qNdQkOaGpntZxKEo7NXAHrWG7h9It4ul1LLTxJOWyZzUjQmsaoYyV5Ol8i2IN1tJrn+Az2n4dNnCXjdjE3TcTCXxJLMJ27KTvvsJuemcP9tFz5/E9V/9AfIQLxMf4Cb9Qyq/4DZ/iEv6gvCu4Rok3cIvyuont+JPYgTu4i07cI/biL+JrPEQfvkE/sR8DxAE8Ib7FM+IgnhOHMEQcxjDGcATjxEn8AwunkMJbfId3+A9ny9hw7j0TS3YjAAB42o2SV0yTURiGn/5tiSFN1RZKYippiOLChXtdGAUHIlrrQr1oUK+UEFouNErce68ojrj3XnHvPePee+95j+//0wsTMeFPzvd+5z3v+f5vHGxAPP1YhBHQh3tYOJpPCg7xlJbiFNgwsIvx42ifmxHA3yEYkg3mZMuGglmy/2ideeHIEAJDC8N5pOYXDS8kLVJUECE9qg0tLaXNsljWHrtrWt3GRYKi1iDNysRGg5h6cxkaxNBNnNBh+I1Mo8AoETtSsVy0ZrBuxitKMqmSO/DgxWt6NqfpUUk6TxlajKn2UE21j7ZOEk3USSKjrH2SidonKcs43BTH2OIYa9bg1f98Ot9Jb8VLUf41SaUWtalDXeqpmvqqpCGNaEw6TWhKM5rTQv1opYzb0JZ2jGEs4xjPBCYyiclMYSrTmM4MZjKL2cxhLvOYzwIWamqLWUIJS1nGclbwlROc4gznuMAlrnBNf7zJbe5yn4c85inPeclr3vKej3zmGz/4pczLsu1IBpl0ojNd6EoW3cimOzn0oCdBehGSrg999Vr6k8sABjKIlaxiNWtYyzrWs4GNbNKMtrCVbWxnhzqxi93sYS/72M8BDnKIwxzhKMc4zklOc5bzXOQyV7nODW5xh3s84BFPeMYLXvGGd3zgE1/4zk9+q7sudXoEEaJWzxM0Id9/WLt8n1YVrUDszVWV1qZJ6c3+5ZWnrFxhZfUKK5PLU/4BFQSHQgAAAHjaY2Bm4mI6yMDKwMK0h6mLgYGhB0Iz3mUwYvjFgAQWMDDoBzAm/AYyBUD8MB8fdyCl8JuJ6d1/NkYd5heMOgoMjJN9gYJMQsw8IDkGFgD/QQ9lAHjarZJZUI5RHMZ//6+NtBei1NtH2VX2IkKUnYhUUpSxhxlpmMmeJGtCmJElS8oSEpohY1y441Lm68V0685avuPM93VjXLjxzpz/Oec95/zOmed5ABecLRTRFcnSM3HMXSVR93NIxA0virnCA5R4iL+ESLjESrwkSYqkSabkSr4USLHlleWd5b0RZPQ1wgyrEWXEGPFGklEXYY2osKZYc6z5kZ0dFqU01aCaGhrFVbwkWMIkRuIkQZIlVdIlW/JkkxR10QKNYCO0ixbXRTvuoOVpmiilPqkXqkU9V82qSTWou6paVakzqlKVqzJVqkpUsSq0R9tD7SFmu/nR/GDazFbzrfnabDEz2trbimwvbfW22tYgdz+nAv/tc7d4OhTlL65g6RpZ/sFwnnTBVXvgjgfd6I4nPbQf3vjgix/+BBBIED3pRW+C6UNfQrR7/QgjXOscgZX+DCCSKAYyiMEMYSjDGM4IookhlpGMYjRjGMs4xhNHPBOYSAKTmKy9n8JUppHEdGaQTAozmcVsnYq5zGM+C1hIKotYTBpLWEo6y8ggkyyWk80KcsjV79/PAQ5yiBOc5gKXtPeXuarzVMN1bnKDWm5RTx23ucM97tOgk9bIQ57wmKc0a8IW8shnjZajkIsUsE482MZa8aaEs3p9q/iIL6v/0G49O3S9RhO7WMVGh5xeumxgpwgr2c0+KrHRxnd+8As7P+ngkd7xjM/iJu7iovPpLwH6z3Y6dfYt7KWMPRymlCMc5RjlVHBKr5/kHOep4g1f+MZmx/1fKXI+5Df1H6ywACECeQABAAH//wAPeNq1fAl4VFXS6K17k26yQqe70yFk7yQdspH0ks5Gku4k3bezkw1ICJGQsBNCCAiICKIIqCOyBEF0HFRGnZE3oqLD86kzw6AzMoi4O4zr/P4g6Mz8I28Yf/rm1Tn3dvftpEnk/76XL31vL+fUqapTVadOVZ3LsEwyw0Ame4jhGCWT+xwwM0qPK4OYb43PKYIvlB7nWHzLPMeRr4PJ18eVCrheehzI9yZVsspgUumTIeTiG2+wh9yLktk5DMMy5QzDHOTCKUxGbeL0Oq3eYmtX51V3cOHu5xZ2dGADbFcNIxAhb0de1bVh+atqIo1cuPBPiBD+yVAcWSu2m8YkYjuLyWpS0pdWT196K31J33cusdgs+y12y7zlGXPxvXm/mb63ZezPgM/sl/HPfly6HT+OeHBM+cgpdirHM+lMPlOK/FBGx4PebFAmQDxoFPoUA4LPhZlg0ujo3VxgMuqsnLEA36YblNEmThOts6ZnQYpCC88nbnY4C5b0bFyeGhM3M6nM7uQL+zo2L56qjatwtlTVlqhjn5jJF2pCgyrncPzWzEemDKZ9PrmlbtLsvqC1d0/tq1J2T/9mSmuVsmUBN+TOshUFFxSGXw2CX80ojLjIzjQzQUz6yFVuDadjYpkMppDhGSZZDwTNaIJuSrqEYLTJWGDVcuR9tEhHuoUzUyzxY3QJGAss0p3QIWJfVwmppQUzUiO793R3u/SJTQvz1ujmdvMu/MR3XyrNVeSW0gs2yxHf55Syr01WJmeGNc+d24yXsMTo0BnuP0mf5jbD26biYpOKXIRy71vC98yRq+wupEPP5DBlDBMsou5lMcE6klPqCgjnlTq9QWEwGa0Gij2nRZaXcR7EIWTJrVUllhkL5sxdED21KCH1/UyXfV2nY/bdisW2/+htMGVNT08xaorMSnNx2Oq+0OqezJIWayjf0cGHxln0uVrdfzbfwf1s6Zbadpvz3662EGczWxaS5cqKicnKmhqSWVSEYkHkldlH5ZVKa3Xj5HwipQz5zTSyA6ahDE0mEopEmCKJ8ETr9Llgaqivb5o1q6m+vgHmax55q3/g/D7NvvMD/W9hvxTsFyr2A61GodSXAZUqUwJAqKzjoOaRMyuljivPEP0JZkLhd7CRS6L6E4YQ1AQvpV5p1U0Gg1Vn1SkN+G99yhKc9bhqZ0R2VkfKsSn3RSzMbNZzSXsURmPGI4mDMZuNGRlHEzfEMJSOPGYXm8HeifAYMGlRvVB1UbUgzP7nP+M/eye52sW2GSO7mINMBzOJYaxajd5iRCU8uNoWPKOD35FZ1yG2gTJIhs2UZxaTNuPfUFZRgd9TG4F9OdIXu3V0EKsAzGTkRwnyA78HNAhQ8rXja46/XsG9LtqMMpSZWJSZMEaHEM0Fxmitigi9BcwoCPge5dlSNvT9EP7D/icUT+A/m73ijjtWCC+QK1Q9/7xw6vnnyVhWBJjGTWFCGWY6WEwq5BUKJ5smpJx5OfVq7ls2dtXt1qPufNK2ENsm4bhxiG+yNtkC4jxRrdFbzJKOKeHvkCfEwKwcfVe9or3V+f3QFoNZ+Nxmy4FFuY6sUGfrwhUx/xqcH17abhXOUrm5ijjoUAMYq8anixaTTCu98L0WCRVl47OhfN88frDf1dFVG9reTIbaUFx1b/+m23/4fQMfyddXOKqV1c09K2P+tbpr8tYs7bzqKV3rtt0aRvnosamhRPKS9RakCGnX6sMAeQAnnMJxaKreutXxr/bH3s5jI4QgG/xOuB0gzotzOIFhNWnkBkRpUCNzOLnJMTmfDXX19tWEFPVEl6rhbWFdROXilbt2rSJ4ds6NmtthNUXBCZtwuXDr2vC1d267leJnxTGmI190zHSiGQhaoZSBxQGtZcCRr+NlRkzPBrf81FKocyxbunX7mlW7+me+sqK4OxZ6axVN3fMaOF1FlcPVw2++NXT95j1bws7vndUo7C01Tk4Mnb+6u1XV2kVlthgRSEf6QlDCVMla0INSry2GK8L79ZDafwm+h5hsdxJ7Bj5k6PrhmcNoXEEKGCZIRI8aM9m0yewuRZXT+38Bhy7cu3nDlotbNpZUCf/m5/W6kG/z+JDQunmdvIbvnBc21DVlR172nZO7Vq3qmnxndnQXTigEN/KRrtpaVyTfCEubqiZV83z1pKomwsMZiFcyxSuDYXQWXA4KrN71gSIWCWryrWf6CDqmFuRgwVTneRkDp7ISA8OQf45ep5x/sLLEmDRZxj9p/YfnxXWdaLfao+EdHTCX6Dkr2g5sM4kJl1kP2pBakA7RhojNqV1aj3ZpH6PAOUnTRoA2LQ+uCQ1wXJgET1/mT5/mL9Ox85gRbBch+RSWZG0wvkjTSXAN3rLbz9jto+EBtskBC5uBbZ4TGuFpB4Un2ptY/P0XyMOpTDzCE5URuaclK5M+vYyzmNM5/O4/a0ucnYOn9CZTOjuDTcjJTbLGdbAfDPSH3/ngOWtrUVG7tXB+5Uxnem2t+y6P/5M8ksM9hrCLGQeac1zbdCjaDE4GYzJSkYlks8AgiTv1OUxKFV30clnPdKmNVku6JElwVfHK/Un7PnpXuA7M+fWv3mqo7SzLDc1f1oN/S42hBQpTdXFc6dItNYoTn38xPMtsnuV0Og8vyRoC+Dzjc4C2k3clzF5vi3W1bu+N6d3e6tqLPpjG2FOb0LGrKeOrNzLe+gxCmt5r6m6MaewWaUCusA5Og9wOJauPWm9IVuqBMwmLv2goFL4qbADNpmuc5vqVN99kfy9UUX2pwT4q1K9IJoZJIb1EYaS6nQVqvUoyfpz3Xc3pZduGdtyz7IM/793r7Oycu3Wrc+5cLry7T7N++vQdmqV9MCC8w/OTeR46ha8rqqdUkzWmCOW/EPlLZo7qGS5AGh87VVq9ZGC3dS5UHq257bYdW7fu+L81DXOUPfNg8Ojwm6G33/nimxlvvihcjduw8sCThN4aSi+xDbjaUnwRx2gteO016zi07+zZfYeEui1D69YNbYHBU8e48GOnhJ8/cCTjyANE9hAGuBEGWmJiLlXSqwaeF/ZDkfAGLBfquXCb8FWF8K5Nav+tZI887fU18LjwJEwXPuSlpnuoXBOaK5HmRK8/JSNUMjdWsqKrFNC2+76dO6+5GjsUfT0LVyiXFm4/2x524o2M0y9Rgh96IuPocOnZCuHtDnG9J7RbRLxxsdCj+48TpEqGb3leeJKwngu//j30C3vQKzqC7Rux1wHJX8KmB3jyO34msOJHrsIz+H4KhSXNiklDnFYL9PDzly7vrCqtrirFDcNfb9uy+fbIpd3diyUcpki8U4GJU+s5pVav2gPpcy5ebD61BMcQWuGXwstCKWzb+3dsKfLvAr4LJus8xfiC0M9DDcK2eOj6hMoj8Tk4HSFrGqWQ3f+V7asgvu+rr/p49gH3avaBY0IidhtgdyOlX0h9XRJPVHqgfcGgYl0NwgNBVQ0wwBGi2T0vCnrs1/8i/EXUGzJPTdSPmYYrRhKdqSSiAcGylZ8q9Rnh79u2wZS7hH8oF3aioOIljEoluQwNH8VJohcRrke3JlOpJ9gYE1hqSvToPZexkvHYw3+U2+DKzHQ15O7eE28yJyaaTfF7YKbwOy5ckzuvQlPRmauxRSTZ8ybn2ZMiPDgfpjhPYVK90kVwnkKdc6vOD28iZwao2kFxfzjTrk8JKVkmor9QGRVS4aVB+KB8ZVfQt4csVz2UwC/8aVHRfZ+PFiVOuiIQOffc07gpPCYwQUeyhRfQafOnCZhcnIcspCkbP/hWRpm+6GQ+l0m2Widduntgyzp+VofSNb9l8ebBnetu28YvaFbOuqUTBpOeCV0wcMemmFULXWWTbK5I1ZLO0MVr794YurCvyRFSXSOOjR4sXEH6lFR2VOiEaSGNPw3vs2+5LexbNqL71YhfsagnyHELSq8mGlWE3BVQvmUj33aynd8YNrSTjXVfXtHWvpzVur/eOSTp2DVqq3CNC9ZzRKShD83y6TcaJnEadwn7e2wzfeQa145tUCuDw0Bshf8c2/P4kYUP1m18bMFjG+senMSedhdjn2r2f5PX9SsUfqJkC1H2TWraE9UxDBK//LL1tdfavvqq+be/gfvhDuFl4IWtwhqYLTxN+2mxXw72w31DGq6dImbV/MWGV/9P45UrV9gkoQjeIHsHbBcmwreiC0bYQ3zvDNiy+Ro6kls2Q7gQb2QPczaju5ezUdiVuH9Q4/6BRhTQMOCr8tzOnec43n79lLRvke0xdJxJfRW3GOu5169XkN8yR3YwP4j9dcRK4uuHc7t2nVtv50rt+HsCaOh8EL+BEItblEbR/UDDI/oP16h/MbIBpoz8mo6By07e5/dUUPjr2UWQ4NlD6vTr6zrQYh0V5T0HbeJpNp5JIJQnexf+ckAnQy+6HmUslU+dAY246PrCfWG2jc7m7obHrFXVBZUqQ2PhkjmK71aZDq001bQ12UIbnOFTI52VVSUhycUFSYu6fztsbH1wqro9JN2MY5bimJdwDzmF7GzUKp+LTYIeKrUqWjJH+pQdxt7Fvb2Ll5tCixWO/DZXTY2rjUsSXuT3rItZt6eFH2Z3CSuEH5qXdcd0L6N8zkfYHyM98WRvQy273/or6hkhbH1tXbW9clHfqv7+VX2LKu3VdbXu+ctri6bwyynwVTUaW/3y+YRH6GvD5158jTpUBGJ8JKDoDak83pDQY3YoSkLzVyDW61rM5hbEmI3noda9btjZTOEKumZQeBBmKb5/Q3w1xOtLSx6NMS7zBtxwJKfD34SdwQdr6ipXLxlcs/rTVZ+56lnIU155pSYvqHrF3nXRa/ftXXd24dxXRB2BOVwWkXk12U5TPTdRH1KnJaj+ev9+R2trC58TH2Ww5LN3DZYLOfBu+W3NdWEzQ7IZEa8c+BTxiiNyEWwZ5RCKIR9x6fQSj84k7DEtXNTXt4hOWO9HCyorXDU2cwtfW8u3mKHHsXNl9Ipdzc5h4Y7uVSvnRtS7auCj5oWt0e0LZiHeqCrwLvJZ5ZEKLWJOZkuJ9x1Fq+tbHTML5psdKAHHa+fXCffD0uKSZmEIu/j2AOwl0Q/HnaWKuPYuR2gHG+X+jr2ELjA78sxIDm0TQUbRqUQ3wGAhhIitCVc0aZb8po5stsz9a5El3KwOyR9BjYdPcMAwaQSTknoDNsf12SdONA2v5JLcn0DMH4SXQLP+MLZ3Ya8HaLyEtnch8tc/x+9LEeGLVO9wJ+wl0nM3mHSE1ZQH7EUHYmMWL4riUMuqZYmmIWc9rCua0SQMem6bhvmWOXOaa0XY8C7CjvKDLcJEt/FdkYsIqmhDfavEQ+xf2z6/jpHLJI13BKX4NpVBol7S6YY7Ph0Y+HRAeP+hurqH6sL2ro1Zu5dcWpfPj5m/nFworNKRQriEsKjuBKcYfIgQledkug4JvUaClHkZKo9bUvYwp3CdrULSqO7AAZmuEzwL4TMvbNUoGeXkcrnXvFAyJCXKaqqWrhbzm6BwUbitrmH3K2yrCLqZzjPhoR5hkxiZEVdgrY+JoOGULBfZKWKLzkFlk3Ar8s8xS/SF4R3sl47ajKpsTjd4QoseyzN6eYfg8uqKWYual847XV3sLK0sae6bu+KWJb2OPHOO2aAMqS5XOGYdD5pZljcnWzHJzgc723qrgwaJnuNYPexTVM+JmlNStTQCQhXe9Ounn863GKLic/iW1lYHG1Uu/KE0O2RmWF0zVJQPUzpnIoz32CgiK2qTCMFn3iwzq2cWdBNRCSu4rb6VjRIOoLDAfcJdwzVtXfWk/1S8XMT+uDaZxOX4/K9rDz9SexIb58E593fSmn0M24SLvq5nudfDog3zBh3zbmu7bZ5jsAtOCaXYyQp/IC/s6PVXzmLfMLp2Wclqj6uEWteyY2fLz3/esnNHy1E26uOPhR+E7z/7DEQ/X4dycQH7kBih2oR7Zitn+vdDta/Wzmp5tXYBrpfshQsgiPBTyV5bhO9d703a5FTQr3sc1ggX1r0sbMiDJ6A8T5gH5WKfqdJ6nyBGiTz7yGicAyqB6XoLFeoCE6jzcgsKcvOiylsycnMzWsrRJcgpPlcfG1d7rjjHXlF7wZxqTzVfqKXrtB39gB2Sj4CTYHdIHoLkI0CqOKZOhG6VhhJVCQenmCj0maOGXE9GrI2LrR8zIoGbBhWsCX5HY8jGaCkeQCyGoeA564FMc25GUQveC7IzrPA7Z2FGHXkRWztSiHY0SrS1Or3aZMBl6wDNt7zJxpN0C4mbnmJjEeckJtOX4eBkm2Ky3ntVltPo1CnEBVbB8YTtzsbb1YncAefAan1CfFnK1s23h2nivnVtYENY7jjHb85+OuaeVPfV4CMRPUOKDT+p+jLu0SfZNULe46Xw3yCMMJ74aSr62bjfJztujQ4nKFpHIqmmXM6AnEu3eH0C4B3Vuj+8lB8EwULMk9yUyPjgniZN/6I1S53sB801xbfYXllgt6c1mxZE2drqFqwd3hr+JRkDVxHWib5VNI01ixogJYnEKLYhe/D+xjNnGn+yZk/5Oxf4C+fK4VE7ZAsOOCm8Z99u/+AD+3bklW/uiReJs89RCXA44D54RahyXydXbDcd9fVDpCmfrHaeAIY+xbuP9RgcD1+9/g41O1ol/i59wtbwYWf50q7TjmIHmp1Zi+Z2li2d94aj2FmCn/rm8vZZnM1hbwqyOeDu+frUBmqHSsvzs7JzFZOqXIqu1JSmUd8FWzKDLTPIBXG9jX0QNnjWY7K6IlMs52cLs9lLc/CPxmVKRq5yXUiPEiXQxDAFU3B3N0WRxE6JTiqYkp6kFt0h3EmmULLKQNyPiUTRPd9lqLt8WXjh9fOQcf688NF+e4lNk9lgcvYYDD1OU0OmxlZi56urPxebXWbThI/Ok7buLyumR0w15ie4FpXElCxyJRnNsap8ey8fw/eKMdZ05j24hea8UokXBKO9YxqXG+Ua65ItyZAVMmOudaZz5mD6jLaZlY9VBr/gMiyr038ovA35cJelbGa+ssQSqgrJz52ttNbXOR9clWNdooqYqYhN/UuR6MsYmcO4hhOfP4LwTqnTGixp4k3Yv/8M/Gx4+Awb7hgcdBwsOyjepBjj+2wGm0PiDmoLCZbkwTU7fFMpPAXaG+dGghg1qwQr+oxKuotPY5goQhrx88jeD9d8HU2HEaEmToTSnAVak9Gibl/f3r6+jO/l+d7BhITUaQl6fmqiPi4hIY7tIj+1nyI/8fP14ZXl5b+MncrqjDEEj7vZh2AV+4kHj7u/YR+y20n8GP4KC5Dnk0mMgrBZnju0aj25RmM0ZBdOV0wvpBdL+/Z2/Gc3KrPN5mxltsWSH1Td3FwdVN3SQuOzP0Oe7KT5Kr8ME0fMvZRl+jNcY3feW3nvvZXC41K8dipsRzsfRdc47OCNWcuSL5MB1D88mqSP5ypKbi8r10y9FU6a036ZnBSckNISdvvMXGViZtxWhBUNd4AWYWWRuGDAnIss5eLLODTbguPSU+KtlrgUfVxwORnDZKksLbexXGNigjIu0RwXFxSbhEOVZk8qnToNfVWbrVQp2vYPcN+3Sdz3gUmph7y6+dLGj6Xr3mv4WxT1QMkOQZVLorxlbAmoQJPA6lSRnBZuzXDk1FUbSMzml8L/iss3xsUZ8+NIrAC1UTujo0xTMS9Xc/17Nj7XlhwJUA+RybZc4ieDkXkIdtH5Rcoemg27UOOBOYL7ij7EQIOrhlW0WHqSA1MSqdLoU45MjstMiCuLVyfmaYOmlyye+Vr25EhVIqdrKkw3NIh0aXBetFwEif6C3ptDA+3Vrrr4jVnzYLsZlKbsFuFZHD0DdXgjyhOx0LE0eurdCmqDiWjjhxQtFYSNbU+1tbW2tQrfmZeZzxdCJVs+Z8XK2Zo5K1bM0dhrauya++4TtpK07Gj9BItOq7RY08QbKM+c2SccOHNmP5z2aSfe0JkmdHMqinskyhX1/lES1VQog/VgkhEUrLSaLOxfSn/6s2Kz2f18BVtRIVR7aLx/fkpJ13Rgvrd0ceHCRg/F+/fBCmq7yDhKjuQk4ontMiFo9Y1l2DfobjKM1V+khePSqFy4O2OsdEOzl99BZB1E+qKQvgKmmKxRMvrgJgRfjQhzfgxYeyNV2EhQzvXyA46OpxluN7JrKuESy8ShLD7LRol5Fp1v420xl3FWUzTKv4bYps9ri/nOwVt6ZYmWlo49ixeHb9zZ02pttZrr8vLbykoc6ZvYmo4OynESozpB8xORfhkKzqTT+2UpPq0p5X2ZCvbZfmaC/kr//r01ZeP3V/n311sRA4MfiNcdyyqWOapkUMr7++0+OM9TOHGj8NCIbqJWT1XJZPQDGW3MSk2ZrUqTbjLQP52RW5CFL4boggj/iERnlP8IkrvgB/fxxiuNMmAH0T1yePH8De4D1WTVEDP0GqUETJ2u40ystIq9a22wZoEE8ous+ZuuvZCcm5ycyy00WK0GSyyBzWlilyL01eR7krKmuhRP49uII6D/qJZeBj3FFSxwUdieCQnC5WyYJjwe/6/aeqh5+ENvPuXcOfY1YZaUK8mh+aE8f/vn2SSOTpsQkZwMkm38u8c2Ttt0qzdpRNNIF1R+ttKhfPF1Xwopg2SV/hGRK9lPVsoFnRDXQ3k2iEQH/TJCdxDx9FDBneifsL/Sv/+/iXiO0z9qVH9RPP1APCKJpxcKT6VTyukhnCPeOhQ5JEl8/ECdJOLjhXOESg/BR0VzRic8vjfd5esP8GWUeJI9eqaftiO5pffl7XDZwnallEhfu5FLeHXTdqESPJGuA3yShxjSulQkhBtx4/US0iHW1IiQiYOCrwP8ocaGRrH9sIgwS7jG3onyGEGlHU23ZMizQKVW0QC0FFOJGjq779ChfWf599+niUFYXQK3HDuVceoYrIYO4YsS4ZyYIGSlnNLzOH68f1bJMEbVZXmm9lGKPirtdNij7ZyUezpBc0+J42efiBQGykAF4XwEzEJxW/qpPNzUGMqAY2zGufzRY6RMMIY464GGSRHlIPBIUZJcSGM9T8fKmYie0bMUaNgz/tMVePhBn4lGGy3icETiqX4CLCStCzR2OSpf4AFXiHJNYjGbWTP7ExqLMVjFajKd0tAy4+OPPf+bZe8pjwqknKYWsZtObb8Y/pNlFNItaWYDiMWHyRodiPn3om07VpUnFBeU3rVjqCKpuNgKf0oQ3s7pQlyF22NhRs5sfAeH3nyxNH9u56uItq2ge95LGdtrhbCK4aNbnfBfxcNSDkXMl53A9UcTIGNG1nxf1uwrIsSjM2fcb/p/DBylDM5SIqgTwtEFgiOJpRfU7yVhHAOtRfIDRHhHKF4xgSB6pt0L8iky2WPgPUsnmpVycSfEOhxvNs5A6JMyct8jdd6sHFrV0XlZrTfDjNtQvUotT8vu9iaZed6XleXCHxVzzLhdeRTN07sRSZV5kXmVnpysDWlMxP1vDvHmyzzZLxKS98SqlTqpPkaK2+Lu15xuAEW93V5dVenoW9K3pNxhbOQnp/KmW+rLViwv42EwN7O1tLK+3uZ+gl0wf0X/PGXFgpwkc0dxcLLVnLDAGTy4OqtqBuExzcMhfSQPl/3jM3FUuMbJxmXUdfATZeTYT46K6+n/EAdqS8fBYTduO/9HOMy4CT5IQj0OGlz1trJt1V0TYmI+enS1DBf2KsWl+Gb4McYWj4PWa9bstJS5qlTpNiF6L5vMBVn4Qtss4ndJmq+8m8DQo7Dj4GWcLcyeEJmXpDiehAvaYYJLHom8/lhc2FFxpvFwCkLv3dqgoh77hLjdQtpa10pevDSfXBEbj7wqIjtTv2yrIRICYysmzYJJPFUppZOAZmS5ImFH8CFXXdXqpfcUJa3c03JLw0+9KG9PKdi0akCoCo042G8yroYpfunaxTnFY5BfuHDf2l2ROUUxIvrwnJjLJXlYks/OD7xfiJaHQj3UeDcMr3g3DL0LvVlumveeO2f0juHBVb6kdwxNhFcunuTZM3BiThD1kuSpE8bPVBOTFDhbLXyH5mhsyhoyj97kGHQtDDxGB1qbGw0xaozkcceQnPYbDPOtaE3GjnQXMR9BUg71kkRLyvjUSM7+DYZSzW6aHYAipaR77Mg3eN3tOdNCssxkVXA5nkRmk8y3t9aDlJd+J29HLLfLoUaOyduN/BHXwEjaLlSCJ7LC5dgiUk3z6Ys8dnLkW7xeluL8Ul7c4xK4HLUk3k/z7x58pTnIwpWcREMt0TqrVulJinpTuOmGdIPSYk2PkuWc83fNX1szLb7cPPDpQP/yJvO03GkZv7itqoCmoNnLFWFFVdZMbaLjnWVSMnrvjFpTXNxCqzPZPTovTXPkV3EvlRowSz42wjEqb77Q3277p9HhVo+VlsscyadPu3FGne57/LLq0TiDgTLr7MqjNwVXOQruWZzxHwk3YRy4koL4gS4RJSQQdHiDSowEH3kfJlba3xjvMVPgN5TbfwYCElTrmwefTor8ShxnZM/66DfeAEpywEFqqGRzuO5tZTPYe737eEuyVilVoufBtXPYCPrs9vvwdpy299RZaJHLBilDOiYtChqdmq5HySR3SktV/2YyDayaXTjNQu7thXHCqzFfp9nq6iBv6teGiro6Nqq6agjRzEurcqyhd+FyrREKMpbPr80X/mggVU1EB2jun+YAogNm/4lA+lcAOKhJ8a8CIELzY2ApR8ESqNkZH9bUwLBEwfMHt9xjmvwhikLHSXUOlyh+sQGhgmSF/cGCE63vGDRrvLaM1hrQusJwWbUBCQx5Kw7+hIR6qw5+kGyxjdTFcElinguxkRXBqfRqX1WM0uYw9pHSlT6jwykVxeRzScILYuWKS/gBGnx1K5xU+3CJ4jNFhlGaRJ0XK4hGwrxofSgSxDLxIzns7ZwG1y2yd9R4KgIsZiuNpZrUijAwwT8TYtNi1UlFK8sLaCB18Rctv910bXF0XKRZ0+Oa8Zs3SZQ2lb1Eiu9JjWEOuFHOsxjLaJjj+YgKWcHhGs+AzZMCeIctD1P3UBq/1WgJ7BumtnuLEL310IW4D40nnsD41fpEfANU7H9YQzZ5Y6v22bh+aZ37GGWDwh+/GpHAD1CReAZFJ1BVIvzrqB/+qRPjT4IigUiwOKqqHMsqAlNRWelPR+pEdHDiOAFICa/u6kIVDUzN4OBR6YwGyVuQcw6xgU86WEX4ow88TPIQ4Xfu4TJBXzor1S3VbyZNUMFJEqWBqjjhlhJ1xo1LOdkrJ0WZ+v8RmyX4WxD/GJq1RRgy3HGJsNBaL6283o21dHoIWNxjvvtuh8NT88aeKBZiPQTwPy9etkz4QF73VoP6b0L8Y/3i6XpSMeJTW/mxEWjxqGaB8HNvdD21UtTFylyplpSsc3qy2sv8YGUk+IEVNzVjS14dlcn5nkGyli4dVf1a0KUOLUwThyvOUewZ8JXCjptrECXJL0EwWxQjWcaCStDN7RtABHyjLdBZUQ8CbVGIFnjsUiXiTCOaE52oYcl5Rw0qvibg2ZrZw47C44WBT9hwvN3qdFol+nLgU6SP1Psab6LiF4e30uGjx639tT7RBEXnimD8GmD4VXfzunXNhAe1iNXDUk7EmxE5wNc1eXMhYtyO1tfSOjSpvpbsNaR5v4A8DCYnmKQTOGRWxFM4wjM0Z+O2cGv7fXujs57cjriHInujMNIu6frnfrmrC6iLMricD+7LaCQIWPazk9jWRWyYdFZatt+qIY0IzKSTcpjhfjCJ9ynCbJlDIMIGcX0mMCv8YNJd1nOzCUSpxoLYoBhqg9ACERcH91dU7KOG+I8/Rur7IaSyFO4SfjZgXy18aINqkZdJpE5ErG329dOrkrocAwMOUDgc8BPhqTZHm7AZ6hhvzkjKA/rnjNBE+7JET0gJMnlq6BmJn3Qf5vEbA+7DkLn+O689uCiO2m4dPOqPT5Q/PmnSquFDSTjpUfVRaIkKL8drauAqaknL/VEThkXtHo0e0WzUa1S0u2gMW8xSm2TmiDig3sO5RQf3sQkes+T+ct9BeKhvaO3aoT44dOqYZJuOnYK50uk+yT5xi+m5h+kkbuof25Lpsl/hC+52tGliCGKxN5h1b4F5x6qBgVU7zOTuVtWJu+vJfhGsdevoRmjdun1rdeIuCC9/ojbXc9byBI3V6yc4RUWYeKOTVA8R72qc01SXZTJkpvl59dhqbTpLfhXbZrLxkFVt/+3oKJzTJ8DZIM79jdAOlZyR8TCX1hWWnkVspbhHj8VdGsgf/SdEEfOjQJQv8VzZCTEWfFMny6iWjXO6zE793IlOmLHN/Z71C95BmtJJ3e+PrIKnQYobVcK/gjM2fjU8e+Go52xdDj1bVzE2Xiqj1zAec7zh0/e84dP+IYkRi0bxaPPK0XHUu9Z42BEZiF89Q8FSUJXWgtCzAsWBcDVNwDcvls96sexod2wfy8EFs0ejuKAiaPAG3LS3BfnqRHzyZLppeRIFdxyR+qvHZZ9Yqjw22SdXOT9arjyY3Ei04kRtmki6RNeM7Pfp+UlSWxXpO0EprS/iQUrhXpEyz4FKn67T8xq4vmrFuEagExsEjP+pDeItjD65sf4k48vLkrqnGLJ2j8nLjkmtePOzn8kSKWPztE6/zIkUO0GdikLfNyVg7GR0sbB/DGWZbLQx8Zl/ygfjpNzwEU/8wpcd9sTIpQzxcGOD79ymVBlDn/FAz28SP26yWPXKyU5xwgy0Y2/5HeVEx+76N/LjnFJt7C9o/Hs0DBPCiENj9Kj8eAgXftT9R98REQ8OR6T+hAI5DuVNb/hjcMThuL7bh4I0Po2nj+5Pxo+aMywfncTV3U7ZCRUfDxRiTR2VTTkK94sC+vYoRqCcylnh40NAOIhKlag7j/szA1VFzg60c3PYRXBYPL8qhe4ekYJ1nhwCyxxmO2GOdA5gTO35YbkA7RmV1wNmPrsNhtmrpI4LxsaMu/3DxOw3vpCwVA9/xlMPn6zNQMRJQbznN+512W/cQ77fytka5ldcLH0+gsVMDt8oTdry1cl6Lo+t4Xdk6qdLzyJiS+lzySaRqgX584q4cOmBRT/mmUYsGQ/sdDy1fES99907dOwrfhh48WAJHpBF8VDJMDH5DXdFhpc4Mn1mCmRR3FQy7AL065B1Q5qqmD+DC76gteeqZBW4hP+GL4QfQIHf3I1GZSF9DhONk5OdXbL0+qwDDpN/6Y/wWkGePRbMSc8eK2AcTDuz6CaeP5bm9wkmeBpZ8M09nQx2e9657/E9qIx9wfegMmHgxz60LGyCx5f5LshfI3OYEVhRp3zHQjwnQkQZlbcRS9ONsqJ02maE6PgT4hmBLADTYVJLTR+XQZ8TJj4PyUD0FlcnfJHzN14PQJms1GvRJngCj8jfFTU8XxO2dmV/j63CpdytgtCkb/8j6beq3cqdtnMr14LBVmp7bM+dd8dtWPoPfPuPU6H/vYfKp5qNgg9xbVTS/IF4PEOrU+oNOhIzQ9OD6+O2TMeJr60zrGxmudVakcn+cPFienrcmTOVOyHyrbeE/9qJOJegbDWL+gYmUqsLeoDfdAkPswfdi6GvS9jIhQsP24WHYTul0UHb66h+WkJAS5Z0B2yH7dgIzF1439gFfe7F7EHG277LAz8EgZPzPhvl7Ug5vrAR+sQzJA7cl0n4qC1ka49DOPBH6MM2t8nxEu1gGvMJa2KnoxVMHHsizxrghF5Btu+EXtvoE3tdnhN7Z7xH9+gZoW30PAy1JMnSUw2RVdITDfMg21nKP/hSIyiE95ylzt0nmuAt+6ZN9l30wkjPPFqNMB5G2SKnMMizkSxpKrywGUIvHCZPPhImsS27djqPOY4JEdZj1tF91DlgCdYGay1p2jx4WOiTHpdUsXMXj112kB4EVzJYlBjfQTOSTDPJUfRwKEfPlWrpOXfxSUkBz7qDFCPxP/MO4eRY+KiD7+4K70Fx0V+j62iW5K/dEPoYyGPh0kPfDPP/AL0TOaUAAAABAAAAAQAAxsl5Gl8PPPUAHwPoAAAAAM+3XmMAAAAA1jezHP8k/y0FAwPBAAAACAACAAAAAAAAeNpjYGRgYHr3n41Rh1Xzv8p/FVZmBqAIMmAUAgB58AS0AAAAeNptU09r00EQfTNLL/XQmMaWaDVpTWpS1LYJqLHGmmqkiZSAeEh78CIiBD+AoNhTRA+CIKKCpx7Fb+DJk1UQb2LvRvyDeNGjxDeb/ZUYG3h5v93Z2Z1981auYxL8yQr/NomPWJSLqGoTk8Sie4ppfYQZbKEqZRSJKWljmLE5rs1JDTmfU8cI504Tx4kTRDHsUQxzJ8P3rK23XNsjgrzGXveK669gv9ZR1xZKuk7OEkLc7Y3xGQ35yTUF1OU76u4gYw+Je4yXAy+TV3FUHcaZU7U93TryehUprWCPFll3GWdZ+wh5hucfkDOs4RduKHBEkzilw5jXCdabxrzcYl6S4xiWerV3n8tvVPhdc1mujRFc5/P2cf2Kzy/JA+bFUOaeSX2HlHQwLp+I98jw3CTeYCmcn420DxqafrstzrvnWddN9wQLcoe9GELB60XdqfkoY22eM+vnDiNJjHHuA/My7FlF17DBuYRsUG/mujQSAWPUfMLrvQNcFQnfg2zoQQA6rKuDBjrdr8QffYn4tv6DaCKjt3HM96Af1gPr1QLrM713gLtGth6k/wW2ut94r2XyW+KHn4/0H4R5qxcv98N6wF5VPNt97Uy7q50XsXnP+m/3M7b7214Rmx/pCWpxwXxgXrS6AvuxNFDTQ4izV2mvkdUZ2L1AyT3mPvSq90uPY9639M5/TC97P5l+do/Ix/TSILP/TeIZcZnIuS+9N2pvzr/ZFt9ry3NO7uMc4+2hPKZlDgUDNrsZajeluzBqviPORzCv9r9bjQN6CSmk/gJjI7OIAAAAAAAqACoAKgAqAD4AUgCCANoBPgGWAaQBwAHeAggCHgIwAjwCSAJYAn4ClALAAvwDGgNMA4oDogPuBCoEPARUBGgEfASQBL4FIAU6BW4FmAW6BdIF6AYWBi4GPAZYBnIGggagBrwG6AcWB04HgAe+B9AH7ggACB4IOghOCGgIegiICJgIrAi4CMYJAAkuCVgJhgmwCdIKDAosCj4KXgp2CoIKsArQCvYLJAtSC24LpAvGC+YL+AwWDDAMRgxgDIwMmgzGDOIM4gz0DTQNZg2KDZ4N9A4GDlQOkg6uDr4Oyg8CDw4POA9UD3oPtA/CD/IP/hAgEDYQYhB+ELIQ7hFEEXARkBGwEdQSBBIoElgSfhLAEuATABMkE0gTXBNwE4gToBPKE/oULBReFJQU1hUMFSYVaBWMFbAV2BYAFhoWShaKFswXDhdUF6QX6hg8GJYY2hkMGT4ZchmoGbwZ0BnoGgAaQhp4GqQa0BsAGzwbbBuEG8Qb6hwQHDocZhyCHK4czhz4HUQddB2kHdgeDB44Hm4emB7OHvgfNh9aH5AfyiASICYgMiBKIF4gdCCIIJ4gsCDMIOQhBiEsIVIhfCGqIfAiKCJKIoYirCLwIy4jhCPUJBwkXiR8JKQk2CUOJS4lUCVwJZAlsCXUJfgmCiYoJkYmVCZiJnYmiCaaJrom1ibyJwAnGCeiJ7QnxifUKAooLihGKF4odiiOKMAo4ij8KRYpJClUKX4AAQAAARMAZwAGAAAAAAACAAAAAQABAAAAQAAuAAAAAHjazVPLLkNRFF2356KKpAZEOroRA02oVjyCmQoGXkmlTNHSGy3Xbb3+wgf0A3yBoYGRxxeY+RTr7HsupUlJdCAn3WedvddeZ+99TwEMWBEoWHY3gDp/AbaQ4CnAEURxZ7DCIu4NtjFihfwOxKwRgzsxbKUM7sKNtWVwFBvWm8HdmImEnBjqkYLBPUirULMXjkob3IddFerEkVC3Bvcjqh4MfsSgejb4iTrhXc+I2nGDXxCzhwL8qpCwh5HFKTxcw4eLI5RQg4NRHCDJfRJpZDCFMWLN08wimQ5WuV8yoyb8HCqCS6iSc0K8R+tgiayq6OrTOs55KtJWzB2fiqUGvRS9PnOSLe5clMgxq0uxRr0WkMca1wpRWPfCF4XG/PEPhVZ9Nd/yNz2X/TucjcOTz73AaIW7zzyHWYdtn3OqzXp5estce4wVGdvmy/EE6cxCU67+Itl//cZKcvYwjwmun/gT3/gXMo0jxnVmhZ4cs4J5HBifJ5VeU+mETAeboq+rXZZOajInl2ztrUp2jfZKIocy8eIv/gs79O2TH2oGrzbHWei7Nui/EO+c2Fl2kME07bR4gu8wSx1dvyf9uqL1WWUOZ1RzGfHJKb8D4qLSVAAAeNpt0FdwzFEUx/Hvic2uLIkSJQgRLSHBJgTRU7UIIlGirs1mE1n/f/yzK0QfvTPKG6PNGIxeB8OD3hndDA96Hw8YnWTvjid35t7Pmd85d+7MJQDf+jOWWvxnSWj5DpBKVMJEIGYsVCYIK1WoSjAhVKM6NahJaPn92tShLmHUoz4NCKchjYigMZE0oSnNaE4LooimJa2IIZbWtKEtNuKIpx3tSaADHelEIp3pQle60Z0e9CSJZFJIJY10etGbPvSlHxn0J5MBDGQQWQwmmxyGMJRhDCeXEYxkFKMZw1jsYmILc5nHOl4xn+UsYT3b2SqBLOYhc1gtZrGwjIWc5rFUZgM7+MwnvrCZXVzkPLsZh4OV5HEZJxe4xHWucJVrvCafW9zgJntw8ZFV3OU2dyjgLe9ZxHgKKWICbjQ2ojORYgxK8OJhEqW8YTJlTGEq05nGUTYxkxnMYjbv+MAxCRIrv/jNH0GqSFUJFpEQqSbVpQZf+cZ37klNCZVaUlvqSF2e8FTCpJ7UlwbsZZ+ES0NpJBHSWCL5wU+e8VyaSFNpJs05Li0kSqKlJS94yX0e8YD9HOAwRzjDQQ5xlgXs5BwnOcUJacVSiZFYaS1t2MYK1rBW2opN4swu95TiAj/xFq9WaLMl2fymKpP9eXI7v4mWJN2la84ii11pTnXYDV0z5ylSHYZu91jS/ENO/1Ca6joVGXaH1+M0uxUZKnT7MGXk6R6Tu/wwZ6q2pshUU5oiS4WGIkuFhmKwCksU2Sr0+AjMMQo1V6C34jTnqoEyH9bc8iftDodT81jL/pWmNK+hB9kNQy91O/M9Fl/lLbb6NApdBR7VzNNLtYoPik9IT6kwPdkW5zf+L3vc64QAAAABWhICnwAA') format('woff');
+}
+
+
+
+/************* Start Cooper-Hewitt license *******************
+Copyright (c) 2014, Cooper Hewitt Smithsonian Design Museum (cooperhewitt.org), with Reserved Font Name Cooper Hewitt.
+
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at: http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide development of collaborative font projects, to support the font creation efforts of academic and linguistic communities, and to provide a free and open framework in which fonts may be shared and improved in partnership with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and redistributed freely as long as they are not sold by themselves. The fonts, including any derivative works, can be bundled, embedded, redistributed and/or sold with any software provided that any reserved names are not used by derivative works. The fonts and derivatives, however, cannot be released under any other type of license. The requirement for fonts to remain under this license does not apply to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright Holder(s) under this license and clearly marked as such. This may include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting, or substituting -- in part or in whole -- any of the components of the Original Version, by changing formats or by porting the Font Software to a new environment.
+
+"Author" refers to any designer, engineer, programmer, technical writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining a copy of the Font Software, to use, study, copy, merge, embed, modify, redistribute, and sell modified and unmodified copies of the Font Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components, in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled, redistributed and/or sold with any software, provided that each copy contains the above copyright notice and this license. These can be included either as stand-alone text files, human-readable headers or in the appropriate machine-readable metadata fields within text or binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font Name(s) unless explicit written permission is granted by the corresponding Copyright Holder. This restriction only applies to the primary font name as presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font Software shall not be used to promote, endorse or advertise any Modified Version, except to acknowledge the contribution(s) of the Copyright Holder(s) and the Author(s) or with their explicit written permission.
+
+5) The Font Software, modified or unmodified, in part or in whole, must be distributed entirely under this license, and must not be distributed under any other license. The requirement for fonts to remain under this license does not apply to any document created using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER DEALINGS IN THE FONT SOFTWARE.
+
+************** End Cooper-Hewitt license *********************/
+
+
+
+
+@font-face {
+font-family: Charter-Racket;
+font-style: normal;
+font-weight: normal;
+font-stretch: normal;
+src: url('data:application/font-woff;charset=utf-8;base64,d09GRgABAAAAADasAA8AAAAAYzQAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAABGRlRNAAABWAAAABwAAAAceilHzUdERUYAAAF0AAAAHQAAAB4AJwDlT1MvMgAAAZQAAABRAAAAYIwgfWpjbWFwAAAB6AAAAZwAAAHyBNy9tWN2dCAAAAOEAAAABAAAAAQAIQJ5Z2FzcAAAA4gAAAAIAAAACAAAABBnbHlmAAADkAAAKocAAFEAIspzyWhlYWQAAC4YAAAANgAAADYHdvaTaGhlYQAALlAAAAAgAAAAJAffBBtobXR4AAAucAAAAjYAAAN83cMkUGxvY2EAADCoAAABwAAAAcBVMml8bWF4cAAAMmgAAAAgAAAAIAEoAINuYW1lAAAyiAAAApYAAAa6pbPFxHBvc3QAADUgAAABggAAAh59mchAd2ViZgAANqQAAAAGAAAABgIVWhIAAAABAAAAANXulPUAAAAAzgMARAAAAADWN7KTeNpjYGRgYOABYjEgZmJgBMJ7QMwC5jEAAA0oAQ0AAAB42mNgZtJgnMDAysDCtIepi4GBoQdCM95lsGX4wMDAxMDKzAaiWIByjAxIoKCyqJjBgUHhNxPTr/9CDLeYrzC8g6lhfMg0H0gpMDACALkgD4YAAAB42mNgYGBmgGAZBkYGEHgD5DGC+SwMF4C0AYMCkCXAUMewhuE/oyGjE2MwYyJjBWMd0zGmW0x3FEQUpBTkFJQU1BQMFKwUXBSVVP/8Zvr/H6hTgWEhwzqgDkfGIMYEoI5aqA5hBQkFGagOS6gOxv///z/+f/D/gf/9/xv+F/5P/e//3/sfy9+Pfz882PVg+4NtDzY/2PBg+YP5D6bd33nrAesdqGtJAoxsDHBtjExAggldATAoWFjZ2Dk4ubh5ePn4BQSFhEVExcQlJKWkZWTl5BUUlZRVVNXUNTS1tHV09fQNDI2MTUzNzC0sraxtbO3sHRydnF1c3dw9PL28fXz9/AMCg4JDQsPCIyKjomNi4+ITEhlaWts7J06bs3DBoiWLly5fuWLV6rVr1q3fuHnTlm1bd+3cvYehIDkl42rZ/Lys2yWZDG0zGAoZGNJKwa7LrmJYtqM+KRfEzqm+xtDQPPXwkbPnLl0+f2E7w/7jtxhu3Lx7j6H84pXrTV2N3R29ff09k6cwTJo1e+aBU2fyGRhOVwA1AgCfbJLlACECeQABAAH//wAPeNqlfAlcm+X9+Ps8CQkEcrwJIQEKITcESEKSNyEQwn3flFLaQoFytbWFHrZia9Ueak/r1HXa1dbaQ51zs9Zjm6465zX1p87pDt20zm22s25udtOpvPyf53nfBAJJWz//T0t4CTzf+3ye7xMKUnqKAjZ4kBJQYsp+ClCOwKNiIfWp65Qo7o+BRwUQPVKnBPjtOPz2o2IR+CbwKMDvu2k9bXXTRj1IOPfSS/Dg5IgedlMUpNZMfUH9GT5EJVDJFKUSGAUWxuNSJwtcKepkkdFg8Xj/NM85TzDm0+r1Wo3BAHPYbeB6fWpdnYJNwe/onXoMJw+cBDr4CiWh1AiO0YrAuBEcsWb6sVehgzk2eKM8C9pyADj5gUxUUCBUfPCBLM5VkBRPURhO2dR5+AB8kUqndIhbjdjtQ19qI/my+sgX48Zf+FdgnaP1YJujZc/3C46d7nS03T3f0XHbEefhH5kKvuuGLyrf/yf9vuN2x6TiU/QfPThuv51C0iuaOgj+DT+mjFQO5UBY3Gq3S6M2OoDFqM4EiG+x2shYrIxbB1LcNCLf61PL0Ps6oA4CxgMEtvjy/ny53O5c3ruix7a5xa5McDc/2b/Q4V6W5wnAj2tTDvWq6f/M62qoW64YGRGqH1gtTQVxtr3V/XKHpCSvU7fsYnyVcyEVR+mmLgoYIn8pkpyOMlOUksjegPCa3cAoMKiT3S7GIwy/6zMo3C7F2p0d7bvbYXkJ2xmALS1toJu8cSd6hA+NLxscHx9cNjg5AG95+Ec/evgz/o0m9jjoobAMmKmL8CGEV0LlUR4kAy/jsRgNInVyig54fQ7AuNVikRhxbGSs2A4QWiwIQoQY/5nb5QPJy5j8bCZ//g/tEqXv1bp5vpYlj+QP9fdO7OhYfmhp9YmW+WVNpeDm/F5XsS/XXN30swqPKj47W9LfsDguR+vqWtt5TaCtvqa/q6y4vYhpql4UQLQBbEvUDcSWZlpSryILIPNBdiNOciG7ocjfrpxaB7bB15H0KECUlKJR25GSvGDbSG/f0I47b4ev25TPPnHqDG2Tv3/muffRGh1a4+PWqDh9M1ivFqvu5tvv3DHU1zsCX6fff+7M+3IbfebUE88qkZ68oAM8g9YIkaZklIrSorUasdGqA3JgRXJyQI0c+KwasQN8Zc2SZZ2ssd8oFAwKKx1qiaNSmLhauDUfvl6yZUuVsjBemtFelzYhFl+bWne6Jim+ENF0HTL+F2AnlYjtkdar9bSR1jN6sKMIiNn/FbFfgnjYyX7uZ/8NZH7099aphdSb1EpKTlEaxlsCjFg7bqIe61iZQp9msfU9qFePJ9LpqZkeZ8UwWuOg3gAKoETap1TInxwffgiUlej9RhQDXqE2Is4ob9jv13rM5rR080ZzeprZ5MWynvrL1DHwGjyC1wNkmWA/sb0jk0LktznIngTInsQUTSxYgUxVYTJwluJVPPjujTe+eyNw7W6or6muhw89yf7kJz8BdTvvvvOOu+4C2Zwul6KXVxGMJCIDZHt6phTQYgb45iWtYk+tT7oHPjR5hzzOliuiYdo8G16DX/6H1qBo4dP73GhJUEhMWazmzJYXyj6Qr8xnC5oXDRRk1QYdNrU2LXPT4v41h1sXHC8NNi2tbrHWtmmvkmem+bpGu7ofx7Bzpv4DLiDYTvQDsZMQQBwXXJzHiBnX9LOa+CeRISiZ37N37YK1WVqFTJedX7WoqW5eqkAmbGyrLmJstDPz2seuAgOiruquDdU5KRlxC7RLKgPlwmJQVVJcm7FUmqn1tPc0XUNiYvrUezAdnkD+ICWSQbpDbqlngMAN1hStXdvMngEVX3wBT7BLyz/+uBww7KtEnq6pL8B5pK9MpG9kUWpeFLO5QIQPgxH2937X0DW3X9s4oE9NkGfrDTXdb/r08EjLy4qVXYM3+M2aTEFX0uKaAyJCkwvpW4p8lMbQUZQwiMQ8eAJdwCueyAU8JZg4oGldsnjjnte3/XodbK4NtreVdcJXivbcVLK5b3j3oZuePc8eUGdv3DLa2rSE0F6LeFYh2hMI7QgB0IuNteA19rH5oIZ9TeGAR7InN6XACfznyCLzpj4DX8GHkYx0VG5EPNOEefZNm4OYhAqOQFDeVuHzVLdu2b91ZOWWXSvW9S5aGXjJ7VhQV9bSDdZ6ugI1Va6CWqdrU8faq7ommLyxtuGlDa6F7vRqV0V7fcBXiuSRO/UapOCDyHYzIrC7XQKr1zfTFCH4flJTdbC1ubboD5qPyzorlqzbuWrFxGuglHEuHxton7+IfcS+6n7rxoHlO3ZOHGBZIu9+5KMfgA8RfyokkWlBK/hHz5F0swW5rMeCXsGHpvQ0iyUt3cR+N+y/kCpHMeM8gZEWAUMwK4DwoKrGykkcWToNbnJjREhBetpKmeGz0EGJsBVIgdrMwGdZLTg3+QvoCL70YukFF5fXr6MegS+A46R24awR/bsO1k8+ib/Acf82PzULnipOHcfkg62wdPIX4ByrhY4LrgulL75E4PmQbR9EvpmCqyIVcgcs8lwgRpKeVvJ0EfMR8536SlG2KCnQUd63dvGE1mDQavR6kLXhdu+WyoZBwFi9gx01yz8IlzQIR9PUqGAUPkYFqFpEmkgO+LzHezv/kwZhwEnKFwQELTIto6EE8CaH39T4xJw1uF2lAD4loa3xGlV+bs091x9bdd3zR3dvkR2+/aGNa75TfF/X4Z8WmpcXNLRXeGsKTaNeh1vZI4uv6Z/vYXLAOe38HxqTVVrP/O0bDw6tf+T4i/WG7rVXnX7pJm/gx7eNdxWWNyd0dtf1NRX40jUWeEP/eMVbmI+pL9HLbng/8tVkHD9UqNZBgdVq5NK7T4XCyLyKzwIfBcV1F2ol5c8XfTX4Crx/8taknJw42TPPyOJycpJgAvsJ9jNc7NmRXyqRnVuxJnFq5oIjidYOoApFFZGRDgcYPTX11+8sGrj5BvZLP037j0tTly46LrYmmnQjS09Yi+GR+9ZZwYKGvmGEEVplIpTvKus2CSafE1Q23ixCdpGL4k0T0jfyLjMWOMnx4bKNd7VS6IZNQyODtW29zxxavKpQLvX71t60Z1NeriKlUGPMth9fdugZw8ElyrSDN916r1Qxztkm5mkX4kmBszrgdZgLOHYYDe3OopHCgfbUs1uc6zq+IAy0AsUtaM2pw6f7TGk80dn2yZ8Dw+37sR1jmCYEE9Hr5gHpMa1GtbsUuMkTrcdPegwOfFAok318XCZxOCSy4yBJRntCMG9fIJ+U1f+xTs6eUwwfIz6SSnLeEVQjz4JNT8PG2RNBLgdnfXLphyHIdG0I7KE+Ofs/Wf2f6uVTFFIwgYtl/H0kYwOpieVAHVPQPsYBwNGvfPTEwuHa9p7nTiwZLpTL/P71N+/ZaC+ka0EFwvNPIvAjT2ccQQK/++Z9R6VvyuJCsvkFot9I6hA5zvOk4JQDmlgkYkkffnIA/edBGnTTwc+xpNAz+wD/jFKASHbhAuIGfZ/8A7bTOBmQsp9zT5hPwhfCA7IQPvm0vMLIymi6bBK/hAQTAoXWJU1dBD9B61LQ+tAaHE/4zgCZNpDTlZNBevm6YHWhVkYrawJwkIPB3rNru/b+66XCFeNUiOf1CFbWLBrcKv6JeKXAqOYVhxm1vC8qfLPirY/qTzzTQAdnEMj+C8jxU8JX7M/icjKB9J+cChEeZBMoDx7BVVgkHmwZ6aU0XXrRT/95hn1hfl9VTDyB1qJMLqiYTWP6LM2gFhE/6wJKacXbT5/5bWlSUuk/KySf5v5FWZITr4I6BDOdlYB/62YoBXomb4Mjk++r4rFcUfaBP0Z4UmfimSbVSJBllCiVZU+DBcrAWwFlBbtdGQhBT2Up8FtlAmJfOXkcFrJJGCpFcvBn8BR8BPkxloJLEwrGJDp7NeFi1ALGti4Zddv2L9y+aHRkybbBiYnBZRMT8JHuoePjC+s6uoZOnhjs9h7Zs/voUZB8L4GNaCX1SDKuNMNU8wnGirUmmK4Dief95Y7teyY0Hrq226lcsLi336AMibxnzcDGuBeQZEBBXNf8tiZUOKB6vg0+Dk8hW0PSj8Muhr2Pwd7nw+5HCntMO+ECHI7bledqLjuz9XsrerZt71l+4NTQtde+fO2mxGsScxQnkp/ad3Jw4cLBk3ufyrgXcXBkz66jOM5NfQlvQzzkUG4SubF8UjSZAP0v5p1dgPwdF7LT3qehQ3yhGL7pmvsaMhSpIoWvOCFfX6WntYmKuOTqKpmJ9v+DxEWddknXoj54pLtnmynZkXaVPHeeJSFDnmsqUZQ44D+mPVPEngfl9U0VyB4CyM8+R3HHjmr4sGuhdswSLfhoMoV8RRcoTpLmVdW2lXQo4nuar18xf6FHLrd4SuuDLWK72pghzdt7zcrkR9bTmgov4zKKhNkNVV0r532/j1ZX+BxuvUCZoFRL8yoWjyMaUDsJq5FsVKQ6CYdQLAOjHBgVkPHJZAeVlezXlcqDMpkPHjnYK598leeHkffiuIzi5/2c/6i4YEE4oadjh1iUhXlC76T+J6js7FvaqQr8JqCk00vZs6XpoZDGHhjt7x8Fg5yNs3eWtmc1NenbSsF6HNDA1Pmpr+EWkq8oAQaczkUnMXJNq+Z8UeLTj0uCLwX/Vv1JGQcuHnyJHT0J+eCaJEQnLpiPcHHNLbAyHAj3NJRE8PEDpWdL47cerTl+bWLlG5VHqh48CVfIsrPjZawLJk2eB+/IkrKzZZPfg8bJP5He8AskvwEEU8fzruH3EAShaiNcbFgT/xWI335rQtFrZU8+VzVZKd53WFT5TsWvHq/A1Ca9/ooUsS1hv2b/D9UfYtlHZ5WinBwpSAXpUoTnc4QHmRfO1JG8q3l1MQKr9JxfcvcDCSWvlbypqGInqxQvlWDQieynIFGWmJ0tZU9/yCnubdAr4eJmPoKbzuUI3G9wqZkBeqT7SvAbdgewJyq9rBJsZv+jUiDt2yafll7zeA6skS4l6/dMXQcm4POkukUpGPdoez49fPhT+HzupNTG4ZCi/vm/XP+sQv2ztAT8sIS0z+h39qnNIC20njYy6Mt+4cLhw/D5b57MhZ+T9b8CTwgyUM8lIlWc0So2gpcXsvmTbB58hb3wzjv4b6ipZHBxqgXjwBU2uMgmPVqE3l8ODSAPnuVwa4zLBwdc8OwZrv6xTf0PnAOfoPhv5aorsuXFt7TTnQtJAVaG75xAS191cfWW+62M2VpNy8Z6WmuUzD7p+kW5ZntRea2/vjo7q8St6JQqHRVVTez7ijhTzyNZPo85n+CMR8R+ieiR4ciKOOZL9lzkboxqOpJut9SXLVp9x/4bW47qtMt6OhqNDDzLnjNeP7L1ZniPbnId6B/tHeb3gsyIjwcRH+nTXIQjNDNdu4AHO1tHNu9YUduqS03RaFLLO3paykptBbvG1+z25mkz5B2ysd6e5TZCp2nqCxT3z3JxHyADdnOZMAxfkzpdFoEbmjdZaOedTS3zx25bl13gNTT1dVQxiFDT5CIkAE/JtuUTdySyE2ChYm3vwmEE34z6mGcRzcnUPER1xJ6FWM/1j1wvKQbPLl42eN224Y5lgH16SXMN9LoKGoQrfYGdY2v3rehJTkzsWw2AoqSsNYhkgbvQLfBcuEZElIfhWkUZuEwkWZZRlpWtXWzIy1lSvmcvHTTFKcCqLHnipv16rTUxkHl9vYO9E1FOeuzsKQukEK0WyoF6IlwjGjmdifDeKG4CxCHjwRmXD94iIhyX1yOY0XNbwdr9Y/NWdNGJsH9Ja6B9Q1ef3y1x+itXdvs13V5vt3d3Tn5ToLwzrwi84ch1VXWnaGCKXObzlhZUVAeclQmaFItf2u6v77FW+AsrK9ew90g9+rxAaa4lIxHxj+I4NCC9ZU1bV7iEIZYV/snI7LOsZsqrlcy7Dtruc5QrHe956WZkZm8EmhvZvyHusVQSfE49e4r7AQ7psG3gulKIfDYe73krXSlcO61xzwC9zWkwOA1ei9L7IUPXwOcNTr1em/pzdj4PdaUO9WePTlmo1xAcJdaWitgYThVcA6nxMgK8pYSBr6692pJsDnRmmc0DjNpAYINjOhM71juaU56pNSmK6d3wYKoeo+F8AstBgeSQMW0Hbtrt41MSt79Lis5UxPMmi+pucf6Zsl2PlB26pUjp4Fg1sbqHZEKzOf47X8ZZ9M/9gDMHvtYUIdhJM2EjUPOKMSiln19OTJ/i60s/sh+8nzZLIzMV4onUjs+NN67Ai+uKAtU00pFycX6V0vGOk+52VtBOpCoklJGiRvBAZWv9tLZGw8qKeF6pM/kCPC3QimjJmkG7OoaZZBIcqz0V1bT3PSeyEWcZ7QxDi2YjXFzFvv1fhCMeayFsH+FNUcZz/2vbd7yyHViua2ouCTaDT/b+ce/esfH+8f6+NeiLwNAgnxMiGBrclWkiKY1WemoIra1V81ffMm7x0WXtTnNDT1uFvfhdrI0qTPC25RtvTbgfUQmSFWM9CwYNHK0WKAMXuP0UIINhMUxHOvGMEPoqgEDJ/L2Ubgp2rz6wtSTOkdGypL1WHwDvKQwq4eT/0UKTSUg/Z7ph5cSt3sTVAz3DcoqXO5hA/KRGyN3HFXlhgTNKxISzOJ7OzMxK1jmCdA0v7qUuB5R2aevZP/M2ZUMyHkXwrGQX0houEgWaUOB3a3DwCdeSoLsg3mrMzrXa403qjCTLYHe935lk63Ln+6sDPQsqwTtra9UWQ6Y1RUhLlAmZhTVt6m0LtPl1ljRdkbOigdR5k6ASBrmTLgZXCjiaJoeKdgvTXVqRa77rLr0ry1wdDOSBE7qM3pUO9stAQbw5xe7DdKdN/RdmILrTSHwia+lZ2QX9fKvF4fIGkSyUjjt7asqra8En7ONeTyaYrzOzLUgEhRUtjUCrI/449TV6+Rp8GLUujPsDk7ThxnjvqeIfFx4tAR+ahQr2p6BWgf2abQJPiNB6Fq0ToPUp4fURRSGCAhGUJTeXbBxBgAr3B6+9JXgTD+spcD27DVSH4G1mbyIwyV7+RQRzVl3Ih55wXViK8Ch/Z4/rXBLvfKxwxx2Bd2xxvSNx/p/7b7sZYxBJtt8oFZnNkh//Nt5sFsd/9ztJYoTpF79EsX5qiuSlD7EsI/nGzR8XQ30CK0C0T2yJ9z5a9LKpyamzpPXnmx7gqf8V8HGUp3V16FIztZaCYfCoiK8LwY8RbLJ3AHArwKDykHTT+SDxp7JEB1jBfvI7eSKyrK2K5j0Wdr1iwR1cfCyf2gTug8/gMz18NpUBUFTPxN9SNLisKgEksRsZ7L3oB68b3NfA+BtqSvI7Ulc2easFCmECXcksGYXPmKG7sr2tTa5oaZzfygBry4oFjQGQB4prRhY0YVzvobovFX7D1Xe08b1gEH7zjZajowzRcZSjQ4XiBiYAm6oBY8dE5QImCDABKGVjoqxl0tElTCWdIFQIqr3NK7Ud+SU1DX6mAT7TtGCkphjhDTQuWNFiBUzr/MYWhbytrb3SDQmuhdSH8BOwDusi1FLiQxLs35kitwt+smyJzS2r1ntSmsdHuzyL4zKkqYoUtaQVrCuroeO0ksSW8tosKImLFwrhjPNpCTmfxjGUC0dqtwo5uAEp90GNwaDR6vX4lFoAH9I7yUH1Y+w2m6KuLlVPzpQPgzfhIpQDTdOnvVYLqjVdWI+If2SBJDz4+CNEQNtlwep8hT5P7DAr8n0tSfb+tWsGissq/HDRMs0dy5PZYdXqu9SDw9LtgyM7FXb6qvnNKxW4BkUYvkH04nMpvubU4POaZBSZ3Xp8PIVEjMr7GRvGiCNwND0V6fPpp4egQw0K2NzKvLpaaE1f7KpZqE+TQ9XShFWb9UqH9FBQENfkV/UOGx021abi7ILiXA2pRWzUQ5CBjyO5m/DJJJa3TyPG1Z5GjA9wrWKrz+LxWYWh7ONpHi6qrC4aMg7ZbOjFV1fjGzYO5+YOg5obFy0qK10MHx/Oyxs2DflqqguHTPg3piH/Tv9Q7eLSssVLrkd+9xVC7ED9jCXS7+SAP7APt2SIXyv6cgDR256EvXcn+H7qG7vtoeK//ZmuY9lq1R9+zxzbOejnerR/AAnp0Z61Lbc9ynVpj6LHX0q4nPre1AJk50/x5wjI0tWctSN7f4q9dRt7K/qb0qmrwePwdcpPVczMCplxJCeIOZE7AEoMJG3axdYZ5So5uUJFlwccyJd4bXl+kUKWlWyX7iz3Lx/uqGmGBVKn0+4XJiVoZQZlXuL6jZ6Cwd7ydQsrmzrhk1vbMgtMScmqJKUkRVQ56FmocXRVLNBtXZzmMCWqaJlCQser47yrVrjTgrnVjey71iZnucFXSWYxVsIWsAuephL4eiF0PhN+2mnLyLBl/p68wtMZKeqMDHVKBv+dOwernHpLUA1/i+KVnipC3JNjCg1/amG1WF3ceZg4fDyhmu5keEmRnXTgBi/sHxweHt1967KR4aG9Tbd5x0r840cP/nmNd//5usaVt+wcr6rPlZtzapf2VGX6pLnwh8PL99w6PDy8Yvf+4SFbiW/NfY23Fq7+8733rPMFJh9M3bF8xXbNRGPKVcdXJ3cSXWaBejAGT3J9pypW35kBIvrOr2s9eZ6lWzKy03QeqWR+VTEjzV6Z0FWZNc8ArrG7sl0F81JyTYnFCVK93cm8mihMLbtOYzWl6Tj7sVKV4DZwD+qh8em/WqxRowaW+/bqhg3HwYoNG46BeyquWlV+U9tN3DcS166jfgRfAMeoOG5/iMFnV4WT/wTH/vM0+r0wQu61VPuVSF6MxxpEeAcOajJxHMLREvIbcHjXxEdb8XpOIOCFW4eGhrA6hoeG90SoY9Nv7gsW29MkUolAmp1nS7brZUplnDw3R5lY+gxTdFOC4sbyIJ0AHx4Z3bt/aBip6bah4ZxIBZ1cbSuSirOSMo3iLI0pPiPJ5E3Sa8EBsdkkBv2Sh8D8nHyA5DAC+8Ed8BDJMyicjYB89jfwUIA7pwaPAgd8MTwDQM4lveGAs2pde/vVrac7iopybIXwxfZ17W1XZ/tzbP6ijtAZYTJ8AZZRiTjb4v0XNZE0owd4J2PGJAT7JTk4LHvA/8ADfvZxPA8xDySBZmRLpJ7i5gDA9BxAaCOg96WkDPaN64cdObp5Mrm5vbi0YQUodi+z9C735jpkZQkVnlI3swr3NiAOVCN4+aEZkSin5gzmasa5P8Hxa19Jb0Nho1ohkSSn6vKLl6VIZS7GbjGlJ2YltwWKa8FZoSfHXWvTSpUCt8yb3QiNOXU22i9WynQFPnstl7PfhgZwF7dfA9xiI2AGb+c3bMDUH6Y8UAUewbu4PpmQEBYEyGP5E0n0xB+/+4ICMjojItUGem2TyMVJKlqp1uTSTJ1blGMeyPDWF0pSk40p4iRRvEiabGrSZ+f39C11jwe8KZpkuuve1q8/y0zNzt/+P3bSqdJmGBIzk2XKjLy2grzElRRXy54Cr6A8QGZwxLQR/yOnsOCVYEGT8qN1m+ARk2SyDL7AHvvF8l6yphEoqFfAfny+Px3p1pIDbLAfn1mb03B7ST02pQf4BAWFt2Iwo+1hwlr4xJyQaMwu9WWZMzOyjC6xrARYDLYCiSlek2yGGEYpsg0H0mUSyRih9k7MvK6Mr/1TU/woPMnuSRCkpgkSQYUilbPFeaAOXIvWRNiyjwuOSOnX3zU4eNeyHzn8RXb0BU8uO7hs4FBly80t6D9Zb0dx5nvhOKNRixmf1cd9sx87tmHDC8ePb9gA7kFBpnzVVRXcNxxHiqc+ESyCJxCt+BQjcxbFeCCMazfQOyhAiN2/VMZX/aYufhDml7ALSqDTVFfnfPXVQ4fgCfZEAtRqBRKQL9dkTg6AzX83bdtmevhhLk8Uo5dKHk9eFCzmuU4U3k6LxAmO/jxpHvvHiYG87Ix0mczY5C+pGZyDPs/ZY1w44MrOlxUnZGU6/U7XEImbaTy/DmTNQao8lrdZeHeLHO3B1MwVycueou5api5ZniBJTkvPLXTmK5QyhyvXnDVPIlcoG9dVgYpIYYFPhU6Ls8KikSoEDpnbojcL9BaDPlvBiBWyjHx3buX3IwUIqQDqO4+QutRAzoxDJKO6B/teMfBFTNv4gJQvU6HntrpKVJIlZWSRUYTe6ZKVH0WYl8rNImQjFXFn94IT5OxeG+P0XuDWGOee4P8Vb/FGOcWH1525YrjiKHC1OBJdEdz0S9BrjQZ6fdmYt3uhLwb0ffvC8HcR+PYY8FXuZF7y3G4AetvjxmNazFyU83KA02QYTFQkg9wFmX3SnKjI+wUS6CzyZKTCeCgZ8wSxDwl5WiYILZlUdgxqYJRCbi4dL8ws7aKR0Dq73Avh/yWKoWpU1+D96vDAi296k8kijjrxQQ1VVbkKqjZm5uZm6nJyvLMJEvyyqsBVVTWUYtNl2myZOts/owyEwKmXkZFWkx4gB/E/Z8TBzZ2j4B6Ax416BA1Cnw5FPpns9d1yid0uke/+t1zhYdP99PmJuLIX/aA3oWj/G2/AI5HDD2HkCbBAJhKyT5IzXz0/F+K5zGSI2B01fcQeGPn77MQSbYLk8VnZJjRPYkI+kIGfLj39gZoQY6wJEHYl8uDoYyCCE2e+HR7syrHw/Ao5dGw0EXhMV8KPNTYq9o+ch8dEh32cxzdBJowKLoeRiuJeMdHvnuFlMWiYmO1nEO+ngSzEvxz3ZbMnSDDH01Mk7GczdBYagCBi5M8LymLBwRqahlM5QyeRYBAcPMXlJHBSosEhGpgGdThS5DOgIWGTWkCJ4BUgecupVEzjbIjRAtg0+M+iiDSMYyJKjwpxdU/mrZLx7nvkvJWRceNZIBU3c5ULUF6fMXfV0xOavGo9OWP2CiQ68RAQ+wD7MR6/+sqJcJAZE5QnUnGVHHvKJHaqmDt/8pfZqeJSAymCXbNThoCbT0F6U/C3Gy4xoUJSetQplYs4rceYVAG5Z6hvi0ccA48Vp/krx2O4PD/WWKi28Wk/NjZsqSF8uwg+5tL4LlECRCVBOqcMiEWMfLZehTxdE4QuM7lREpsyO4hWDkSl6e2ZJUEMcti5DgaoO6g0eBoW47sEKrwLqBHj3T/rz86fyz6H/p+3njsHi8+fzw79zMn2NDwFL6BKIoPsYXJ7h6GNQ34IiT8B0iTwVTmsyCnZvnzRtq62oLX0mtFF25taDJ6qoc1FoJz9sKh+eBO8oB1a8eSJ4a68FekrRx49MbTQ5Lfeu3tbJ/gJa7Dfu3snN1uF52aQHWWRvcvLTc7g8YUY0zOPYN+43AQNsJ/51jhxCx4DJ9iCHeVKkM7i1XpFeInbxEJt4B3nCrCHYj2HfwLht+GK6bIURNuGjEHOmzPt9bIkgTl5lpvtQbLR4lmImNM9WBdRJnzAal4PMcZ8iAZIDoZqMnsY0rs64ijVGDHEjJtN4+dBhQ/P8qV4FMHPixSKohPZaV2LevoNKsJlxeKxvqvjWqcn29hKYWd7SyN3HqKa+h+shn8lO9ER29D80SS3Aw2tdgHuEsOT5dOH0FzNCj5SimxOoUySJjdL+nsbzC0uSbrB6pDoNBkmg0VeUSgpsjflpsZX/LUocefqtm7wFrSZklR0oiIhOY5pL1+UvGOh2mlKzkiTK5JTDJZUR6M0P9VX3e68hd2jjDMaxXKw86YjXa0ezk7ITBA8S/Zmc698KojkrUtMBt2JPPTS00Hw1Jn/D/wqnM8ugd+PjORb47d/O/6tlyaBd9rLUsHlPI6O5wkd5d9GDjHz3yVIWz07C16GyO/OzYUcvacJvQV4l+lKKY7aJl+C1qtnRJvLkLljTpLk6RRISe/soUpCu5Cze2cVR2QsHkLXiHwvc930BtIq5+buohGZs2mv7SSEtwikszprdjMhdw4X3yfk51Ncfv4C/gB8gnyBUKsKH9p4+VGx0PQBT2tQwBOrCgnY5/Zw1zJO1tDSld1Ls7yHugB7vqyrtripa3l9X0dhpcbc0lhlcZv0h8e7bKb8u86AxQ4GLJEqneWBwGifJmlPuccXqK+t9umdhqwUGpPKPsxJ+SuhQnBDMz/3oufn8FyXnsSL0ZJHH9D75ex2fO7E3tLZzbiAm68j83vzcLdxyQk7EryiTtnRKGxFnbQDPz5DfWs8JEhFxfM0Ck9Xjsd4WTxcMIqKaoALQ7GwcfWCkMd3muCz4MmtS2KMVi1ERy+f4b7RadgWrXfEZ85ASGbOFBG71kYGa++AlSaDdjlIX+BvM6bsQCZffxnJHfpo67FWQuuPIz1EXY9nZEAaWa+as55IOwSinpPvbCh8HTb1DYKTjuSaxE38R0CyRJFiCGzCDLlFwP7X3H0L/dR/wafwT6jWwRW9BVfyqJzy8YMB0+e+oUNffOjdZcq7MWWDqX1t7VjK6AM7Bodv3LVaU16Q2dTVGixtAR/4vc2W2hxxhqG+whp87vjmg/vHr7rFJ13x3NqrR9chnGSuDuWrLHz6fNnJuthpKurM3S2z89Mlh/Dg83N2bTn/+S/SH57J00SfysNFd+RkHvsXbE+zxvPAbWeuDB7usSPhtWLzigJuFry0WPCIoUWC/AFvbnOhcnUEB/d5Ajc/FtxYyohElT5bC3OQXj23LuDwnyb4yc3BaBREqwEicX8z0/xnox2cEzEE1HVUBXwBKikx6obVZIecnOShuKUXhk9twG67PsuZ9Sm5iipDz1qNHir1dr3e/gN/D/6u0RIZPoJ4cCIO0kkcCbkR3yLP7JBV/EgmuN/gGdgxXOIpyipauH3Yn5+elVvanPn2Tw0Fpa3Qqeqtv3ls77zB5JG6G8b3pDhSx/obgyCL/blxvH8RiVdkThDZQxp/FhhrUhBHnznTgmuJ2UadGARpZ74VfNx1zZ1GDBJDjo1gJnz9Zem3RkHxUciuYyEhAVXA4zlN5p/sl8TkjWJkc9B+J8LOouL+NGp+IrOIIXleahoR1wDRJxI9WKiXGEsEptA+MMKVgHBFzgbTMWeD5zF0y2Y8Gzx2y7jVpyxtd1rwbLCDzAYLgjoT+0aU4WABz1NYtpfgKppso3N5y0wBX4LZL+ZImbvPKQR/m3Web2RCOTIiL6K/l/B3IlNDHT9KgDNOppD3oo4//aKfXpo2ga9GsvpSul47QJeS/v61oKWdfVMx8QRq7z92ZZeDBHKtFMHFl1lzSS2G6cBAQzPTGKSR+a6lK22N0v/3YrpRO4gvFDzvtzayr3OkfeXOrgBuHXdv8UvBC/B+FBtxrc9fl1BYmVinaaEL53ia+adPrFnzxFoAJgplsjf3yvFhh3zvRbmCYYfq9k109PW3T9wN1x+8Zdc9h4CsdVPkYcfm7Z0Dx+4d7CSx7b+CeDKrTuYBqNCkQxxf2cVxhd50i8E1H9zmROnVdfX+ojpgdeTlBuOBmf1td3OgvrNtrLJhaOD66weuKSla3tEDnhl7dnz82SxZSUVDpU2wbDXjKxka2vv+nmXLRvuSyZn6RfC54ASyMebb3QREwcOH/OmKLgRC38Ju71jZFd0LFJzaty98R+oLMIp0TXYDrmzS3MpRdbmB8wscQZebO/8PJkXA75FNUFrk83mX2CWLVolH2TV7dtaeXazNMzA32EHuzlzoHGr2rTleJ1Euz3VyDEfcoQNHiaQhN2+N5MyfbUVOXAMO5qzBa/ZhDuDMAWx4lsAD1CpoADsRPBF37w2lmHf5TdOzfC0OqZvQ36zh9wJi7ANE9Pc225wWnsSDAVgC7kA1Fr6fH3v/ZcWco4a5dSq+o/kWuAjkeP6L5u/xAXkJF3fQ7wTnuN+VAL1acO6tkhISF8HPqB/BX5E7jG4yeBwu87fntsEyqT7dmAt/tahcHq9SpOldtm4Ong6t+wG/zoiHFac/C6QBrSvH6/LAz7or0DqlFq1byK+b6qF+QF1FPoMoyroyqSHNmHt8SRAvSyXoIKYRXENw6eZSaY5JNcgJExLBwJJIZiDmBawPw59FlSYmdys4TGmz+OyZxTPEPIP1hGfdXK5jS2FlCFOEPJbMlA2gDlAfgSehkMzEhTZMDAcWBIoXLJgAhROdnYHiLlzrjE59IdhKPq8J19IzPrPJFOVpH/c5TmA9//3qiM91Mkd8Q1Wybuqi8MEZn0eGPyGNufxnkpnCT1by6WT6S31GGXiRfDuL3zFd8vPKxmd+bhn/2WUAz/BSr5LZutAELxndvSc8rovv06K/+TX/NzPG7kITd2SOsg+91M74PCsJmQo7MjmA9LwR7IevwQMUjaMs4MZxGRKMSC7WoJ/wzWmNDwde/tdioxU9AcqyyeqJF6X/NU0krtFljVRVD2VlXZXZk9Ktgzf8VpiiFv5OlF1dnS36LEX46zhN0mOnpZq4X8ep1XFv/+MfbwtTeB+nwFlwlvN/Wg/Osln4i9gg0jnMgudQV49zEbnN6ZtRB828OxeyxJRQGgClzUWvF+kVjne9yt/R7vfJ/c+OTLM5My8zMw9uKdRfU5/ONvDl0ypy+ZM86RSKDfsztKasvIxMdQq+xkXocBI6+M/r4rDOvF8aQYcGvJlC+z9i6HxjA75tGsIeEMOPJzv4q5XL0grDt06nERdQ/w+NklgCAAABAAAAAgAAp6mxnl8PPPUAHwPoAAAAAM4DAEQAAAAA1jeyk/9f/xQEqQPDAAAACAACAAAAAAAAeNpjYGRgYL7yX4iBgeXk//j/CSwrGYAiKOA+AJpOBwF42m2SP2hTURTGv3OuhVIrBls0ybONIYZX2xhRbP2LSWhBbLSDKHWQaltRCQWdxKEogrq4CBFnHURwcBDtUEQczV4HyWKkBIugg5GKFa/fvcRaSh/8uPe9c949537fkSkkwUdOkM3kJK5KERldQF4zOGhOIaFv0Y9nyMhjlEhCGhgwBUwzP5QcdnEtSs3OM38HGSO9zX1A9jQ5SjKkj/+cJwWeccud41apY595juN60/7Us0jqdfTpK655EkNMZ/j+CUkZQkpeo10n+b0VgZlAt1YQ1yrjWeZVEepdxjI4rKcR4X8xLdkF8wjQM3ZRh+13HcZOeYJ7UsMGrlnzGRXeCeSyLLH3AK3yBmntx3b5grQU0KXr0aN70SFR1m+zL7SF+zjrF1l/PwmYH2KLdjD/BrrlPnplhLUPIC5f7ZIx9o8sol2+WStzrF9HgfWqXPO8/6jTnT07zdM65vSzv3y8gRwpmdsYlGlsk1mEXjP33sBFOcYenBdXsJUE/DanKftB5lnX+dLAS37PyQPGZ3nXSRzyXGC8To2c3mtgJuw770G+6UET6h/xHgyhk2yiRxuX9V8F+yr7/Yz37z/OgyxSOk4Nqfda6HvOCT3w+q8kSl2cB1HqGbW/NcK+/um/CqeL39ODlTgP6FWn94JncY7a6GWLqbHn3czn7Dj/lmfF+dXAFLlDxt2scGaAClIk4ZAyeyr7NaEjeMj4pXUu9gMhyeKpPWcGcE0+cg6PcJ4G0fUXvGTGUQAAAAAAKgAqACoAKgBOAHIApADqASYBdAGKAaQBvgHuAgYCIAIsAkACTgJwAooCuAL8AxgDRgN2A44DzgP+BCAESgReBHIEhgS4BRwFQgV+BawF1gYEBjAGZAacBrgG3gcSBzAHZAeQB74H7gggCGwIrgjQCQQJJAlOCYIJrgnOCeAJ7goAChIKHgosCmYKkAq6CuoLFgtAC5YLyAvsDBoMSAxgDKYM2Az6DS4NYg2KDcQN5g4QDjAOWg6MDroO2A8ODxwPUg96D5wP0hAOEEgQghCUEPAREhFoEaIRvhHOEkISUBJwEo4SthL2EwQTTBNmE3oTnBO2E9YT8hQmFGoUxhT6FSYVUhWCFcgWCBZKFooW1BcIFzwXdBe8F+AYBBgsGGQYlhjgGRQZSBmAGcwaFBouGmwaphriGyIbcBuiG9ocNhx2HLYc+h1SHaYd/h5UHpoezh8CHzofgh+iH8If5iAYIFIgoiDKIPIhHiFeIZohwCH6IioiWiKOItIjCCM8I4QjnCPII+wkLiRwJL4lAiVIJXIlmiWsJdAl9iYEJhAmLCZIJmImkibCJvAnBCcyJ4QnlieoJ7Yn9igEKEgogAABAAAA3wBSAAcAAAAAAAIAAAABAAEAAABAAC4AAAAAeNrFVLtuE1EQPcG7EJqIioICrdwQJIPsEAmSVMSKRSRCkI3Eo/NjHa9sr83uOlGo+QS+gYKCr6Dg0dFBhfgEvoAzc2dtbBwkaJC19547M3fmzMMXwBreooAV7yLg9QDDK1jjyeFzxMeGCyh6Lw17uOq9NuzT5p3h88SfDV/AC++b4VVs+88Mv8dl/5XhDyj7bwx/xKr/1fAnXPK/O/ylgCv+D6yjjesIUMUIY5wiQYQj9JBRVsEW7vC7oWgLGyhRukuLDCm/BCGaGFK2j5h+bqq+qrKWeurQV6jSA9ylPsBTxplwb+rtgJFCRS3GDmidUBPTd8i7ARmJdkhPKX8R78aUTrh2VCN+BvwtZzUmHukaUZZphFl+KU8Z9eIvNZZtq4LgIXGH1l07p7RrMVZEq5AM8juyC4eSsomVd6L8I+MT8d5Ec5KIPd03z+BcpV5qk1l+61ylP4/IYqw3K/xG6k+4xCrramVcTjmHXyNV9YarQ/JX3gQn5vVUayp+xpSmaptHO9FceubLVSDPvs3d9W5n2pVjnQ6pUsm4NvWeoEgjx7TKrNqByQbEXbWLlGFTfQc2F/ksuC5GykB0Xetem77PrpWL/3tPrtmkyGQK46H2pz/lJBz6yvZE+bmZ76gm1cg91QnDls6KnBY5y0zPJi4yD8syme/r/LTM93WW6TZPRea2T4sGvzr2+H88UA/3iOqU7XGd5eQ6eGQzHNpEL6+D4/Wnd6G4wLSuvifMXGQ1HOIBGdwnk11yPSSukc8TPCQWbot5zt/fYISyvlKyz9v+v5z//Z18rO9h3r3A8mrojASslPx73Oss621WrIJbXDdpFbAaZZX26SXkNKQ6RYnOkbx0tanfBp5TElEnDAc/AXtlHdYAAHjabc5VcA8AAMDh77+e7u5uC8O0jenu7gUzE8O003mcO5449YLTefJBN6fd4U73ecCjY+LN7+V7/Qnyux/JmvhfzwgEBYIFCxEqTLgIkXLJLY+88smvgIIKKayIoooproSSSimtjLLKKa+CiiqprIqqqqmuhppqqa2OuuqpL0q0GLEaiNNQI43F/3ppqpnmWmipldYSJGqjrSTttNdBR5101kVX3XTXQ0+99NZHX/30N8BAgww2xFDDDDfCNgstcsp6by222gob7bDdco8tsC4QEgi1ygZLnfU0EGaTnb756rutdrvsoj1GGmWN0a4a45IrbrrmuhveSXbHLbftleKLte67655UH3yyzFhpxhkvXYbNJpgo0ySTZZliqmnem26GbDPNNssxW8w1xzzzffTZcQ8898I++730ygmvvfHQE48ccNARR51zyGHnLbHLBaedcdLKQHggIhAZlpKenZka/YeY8KyMtKiohH/G/jU+x5i4pMQckxKiov8a8xPlfHWxAAAAAVoSAhQAAA==') format('woff');
+}
+@font-face {
+font-family: Charter-Racket;
+font-style: italic;
+font-weight: normal;
+font-stretch: normal;
+src: url('data:application/font-woff;charset=utf-8;base64,d09GRgABAAAAADnoAA8AAAAAaegAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAABGRlRNAAABWAAAABwAAAAceilH0EdERUYAAAF0AAAAHQAAAB4AJwDlT1MvMgAAAZQAAABSAAAAYI0gfSpjbWFwAAAB6AAAAZwAAAHyBNy9tWN2dCAAAAOEAAAABAAAAAQAIQJ5Z2FzcAAAA4gAAAAIAAAACAAAABBnbHlmAAADkAAALbcAAFes1zKlwWhlYWQAADFIAAAANgAAADYHJPanaGhlYQAAMYAAAAAiAAAAJAd4BD1obXR4AAAxpAAAAjwAAAN80tYP5WxvY2EAADPgAAABwAAAAcAFMxsObWF4cAAANaAAAAAgAAAAIAEoAINuYW1lAAA1wAAAApcAAAbCpZHHM3Bvc3QAADhYAAABhQAAAh59pMhAd2ViZgAAOeAAAAAGAAAABgIXWhIAAAABAAAAANXulPUAAAAAzgMARgAAAADWN7KUeNpjYGRgYOABYjEgZmJgBMJ7QMwC5jEAAA0oAQ0AAAB42mNgZpJmnMDAysDCtIepi4GBoQdCM95lsGX4wMDAxMDKzM7AwMnAApRjZEACBZVFxUARhd9MTL/+CzHcYr7C8A6mhvEZ03wgpcDACACuQA9HAAB42mNgYGBmgGAZBkYGEHgD5DGC+SwMF4C0AYMCkCXAUMewhuE/oyGjE2MwYyJjBWMd0zGmW0x3FEQUpBTkFJQU1BQMFKwUXBSVVP/8Zvr/H6hTgWEhwzqgDkfGIMYEoI5aqA5hBQkFGagOS6gOxv///z/+f/D/gf/9/xv+F/5P/e//3/sfy9+Pfz882PVg+4NtDzY/2PBg+YP5D6bd33nrAesdqGtJAoxsDHBtjExAggldATAoWFjZ2Dk4ubh5ePn4BQSFhEVExcQlJKWkZWTl5BUUlZRVVNXUNTS1tHV09fQNDI2MTUzNzC0sraxtbO3sHRydnF1c3dw9PL28fXz9/AMCg4JDQsPCIyKjomNi4+ITEhlaWts7J06bs3DBoiWLly5fuWLV6rVr1q3fuHnTlm1bd+3cvYehIDkl42rZ/Lys2yWZDG0zGAoZGNJKwa7LrmJYtqM+KRfEzqm+xtDQPPXwkbPnLl0+f2E7w/7jtxhu3Lx7j6H84pXrTV2N3R29ff09k6cwTJo1e+aBU2fyGRhOVwA1AgCfbJLlACECeQABAAH//wAPeNqdfAd8W9XZ9z1Hlq4sa8vSlYfmtXVlyZJsbS9JtmN5xHvEdmxn2nH2IouwAhQopAkQVlgJJUDLKCUUyteWBvjKKKNQ5tuXUVLCHoUyWlLw1XfOvZIszyTfL7F0tZ7nOc8+5/zPJSBhIQjggDcRAoIk3EcB4al+kMwivvAeFQnfrn5QANElcVSA3xbitx8kReDH6gcBft+nsqgYn4q2gOyPn3kG3jSxygIHCAISscR/gB7eS2QTWkRdQGsiwOfV5gq8Om2uiLbaAv4gIMfKXWKzrfQ2vdWqpywWWMJeBM6PV7t0LLBSeotFT1kxrVJwFzDB5wgJpqWhGfRjTIukJi9HlCZY4oB7FGboKAHgrnflovLyLOW778qF3nKpmCB4mT6Bv4RPEwWECclEkb4Q+tPS3B8T4v4CPvyHPwJbPR03dXra995cfuQ3vZ7OG3s83VcdLjt0f1H5dT74tPrvX6r+7jngmVB+gf6jC8+BAwTSoDZxE4TwI4ImSogyxMVH6iiSDjE2hjQCNHQFoEM2JuQjKR2lcQOkhhApRx+YABlBr2ygu0RW32VyCaVFtrLutt0bch25Y81mvyQ74PEubNy1LLuyrkPvji0ogR81AsOBZSol/NHQXdmzUbZqVZb9xs3SfACyrB2Bti2kMyfuabCu/0oa9zNeQkh4E98KrMgmMkJFGAgnEULaxPYgeYOEgkIfoDVWUqTN9XlDwYBfOOVTKuOT/4SivvBQKOINQ2HNxKs155RbmHC5mQGXog8qFuMPevBbZRYG3ruwbnXPUEvd2u4h6cRyeFnzotGBpr6xwa9a0PvDLfVruodo9N5gM3qPwDrMTXwHb4T3ETbCQ1QgHWpJEamrwk9IEiYpDvYgH+dNJBUMeUCAZLAedT6vAMlno61IVnhjYyxSuSSnUSor8heN7Wxdel9o90h9x+rR64q90vLu+4K+loqFrqs9Nt8CsNqRfXZ1vz0L0M6+4cYL+ttDbeubK6MrTU9blisljsSH1iZPZSvo8a9zeuvKqwmA/ZK4gPPLTK8cUZoBckXkg6TUi3wQ+x4gOhJbwfPwRUKNXqDhiLAqKRI7QCgYCoLnxT2VUVNon3jZzir7YD980SGrbVz1yNnP6Bzigzsvu3NjdxdHJ3EM0ang6WiwQ0FEClPARrExK5ftWDE4NCburlpgLmuuhy+Kb9h6iGW7e0SOnPqFOx7YumSTBNMREitBN/gc0clCESonNISeiwiaMQEFYEiK9EBKAaLoLQ8A9YVhefZNdeGLYHavJKLXZMebVPqloj1W+GLNeectUIfFMkNXU/4ukjw7r+k3cak4zI/5XBR0T8FeIgfHgcqitaholSVgAT+pBCR7spL9HohhL/tNBfs1kFegsT2T6CeuJdYieQg8JnrSxBWiXapYdonRZNl2t4XaJVMa7UXmpnMRD4p4CWQBNfIaQuMj6aLjsuNAXc/zz0/8QFxNbCVQ+Ae9Oi7t+Ku9NJ2np7fSXqvVi3henTgCZfAw/j1A3g/+WjPxRA08PJGF8kVB4luo5OLFgD6dEQupaMCqBwN9K3uH9qOHxZcOVBt1yvFF1QYK/Xjn2qP7Du5ac3T/DZ7zYxs7q287L7Klq+o2Tr5u9HAtRx/xFpiA1hKIAg1DBsC5+p3Z/ezrq5WjkqvhvRPXKIQOp0gFSYmmBMn8KdKrEP2uiCBCFpRKLKGIkHN5BUjJx6lNLhgGLqvLxJZLO1dsjISpCn+pN1ev1+Y7O3f0DtkiW3d29N0RDTf217bEi/0V+nUKnbrU3tzR6OztWD7AyQhQLBKIlx+94BJYUgWIgwmgYONjjQylL1MyJC0Hos2dYV/36vZRY55KrWBcnetilcpScbayd7zaX+aRW2WavL0rO4fGwJigodK3nA5F3PlGcpF+vNVXmRUGg7XlleZl0nytf6AlWjuG8ziReAtK4Z0o7njNIbujFGsJZSMLHq3q3CzbXNpWyh6TgvPZv3wP72SX1H70US0IsM+j8QgS30AS2duM/MVCWshUDpkxKjSou8ESOftOSbR80TKva2D3wl5LXo4832Lv2PKgrAcebn1BtWihd7S42VeSZxH0KTa3XSji6ow58S34Dr6AooqrM3KQ4sLzCAUFIi5RcVzAx3DPUVNff8eyQ1sXrxvo2XCvJhJqHNvTBl/wya7ZEV3Re9adu9et/9PCFezNlfGeod1DV2K7uJAOetE4srlxAJIGFpK+DPxFzIazesBj7PMWDzxsn9itg7uGcE5VJ75EPnMfikUr4UMEuGLDJUkdxdk1KVtGWk2mUySlW8DYQEOgusJb1RPbvKDqxm3LNvT39Fwx3jHc/r+RytZIfFih9lpLFGBL3qC/PNxZU1LlttSVD13c3xhbZ3P09e9qr40sD9KdwcqGRZFcs86g1JCcrgoTf4YS5F9STlfpzI34AiYYSmuMEwmCWzW1VQtWNVS1sn9TsxtWNrUtD3g6Vi4dPwkGOsLt3ecP1Lexv3aMPBta2VW9xV67buX97Pt87fegXPApeAflAhVBqFPZAKYurkfpAKUFms8O4B0ruvCyj/BZAv0+cRzlJv73VMbvBVPTVJLKtZPZKklp4pbMrIXtdyFRDB+HHkKE65sMaIsD8HFWDz6eeAJ6Is88Hf3cy8t9LvEAfArcwfVmyNJa7t+5sHniEfwH7qi4qGI6PY1QKwy4wIUwOvEE+JjVQ8/n3s+jTz/D0VuC+rI/In1rcdenQWGDHcEJsP+nhgEyfPVNyl84OLJDUC2S+pY09Yywb/JtmRWYtx8wbW5asxIwpdHW+iPsV5MdG+bTmhgXjMOHUIw2IvF4o/q8UZDKoLgdpEI+1A/x1g4lE0nyFYW+xqS+hxOvHCABYYlcHF/W4w+UOLtrg/Fw0XjQ41MHJSpGTGlczvit5x9Zf+6TP7/iPPmhA/fu2Hx11e2LDv0uXLy6vAX8X3jBsk11r0z0DTYtbS0PFVD6nvvoXI3e33PxjptGz3rgjqebrQNb1v3mmUuC1b++atOicKyVs/tR9NCEco2a62N9GpSlaZSlGZrkrkJA4AODdetU5W9VkaZv1olrng6BLUdehndOHFQLbTah/LHH5OhZBCn2OIrDBHJHaEJxqyYKUX+DLMrHGnqwYLoaD9Ck848AXfFa6QVg1eji/kPsK/+NqtZKYmdZ1ItX79cUbaRN77Z16ULwcHVt43Kd+Lx3bSI5dCqE7PeCkbZlgolHBL+uDAiRf5SgWrYR2R1HGUkHGEw1GeBR6CMzAg1uLHSIyyvGWqvqNqwscWlKnQVrlpx7dVfL2r198PKblmnyFwTuXL56q1x11iH6+guW31+zCOkJj2sTGpcSddeoEieTqhPwY6IEyKZ8yuk9cePh2qrNL7waU66T1N65IXRnJ+PZuAUevvjcgUNVm5LyiyeOrfFd0zq2Avc8HyPaJYi2gct1SHjUskdRZ43aalpgwVcWns0AeLmwLOd/yg+qdU5HSZb0xiCRUFvdZrYwqlqXE4OHD/QpJuTNbzfJ2U+UY0eSvLi+6kPEoxDxKEjzEKR5kEmjIw6LwNOmMslz3n1qqtTpzJLuK5fHf4iikSDity5Vst8rmt5uUiQUQjsyPSyV4/AmGKT7K1DuLeJ0H5qie4A6V59WATMNcIEhIMj2+sa6Iw2bBm31Nkntv2NKz7n9517X17b1qnG4//ASbV7cf8fyZTvlr8uFDCOU/4u+8bzlv6rmajZniw/QWGhsCUTbEuKZAEFqIBbB5JB6v61TeEDcI419W6dEvvV1rcLH/sEvjX3DWQgetgkVX36pwM6smHhdLkLOLAdy9mv+ilcgSHyCHtoQTwXPE2QwGER010lrv0XksA0yyHA/Bok3UL38H/RbXeq3ONjRHElL4VAIIRLvf1OrrC9YvanJZ/FKNcraCiqeJMXefPU5+l9eIMtatgusSdryvcSP8FpEz5ai5+O1TALUMqN5BNa1B2SatRvRDxqARhT/uoc9uV9pK82tMfhLqG1xtyxTcPZLoFAKGbuITbCfm3W2rAL3B19NGQvSPXgK8ValeWf4Zy9is/E1NVNGs3WTyp14Vrnrt+g57YsfoESxMtmj+LSaabYDdA7IsN4LQ0D/1yg23BdNknXsL0rXr1ZU4TdyovBwASsAJ02ZGi+fuA6unnhlisz/QP7yV8Qvj+NXAFLeQmdaseu+L4clsVdiyu2V7MnlObFXkwPIY4XgzaR33AxLWXmmX0Au79wK70F5wYh7aCqVy/ncrsnM+UFw3ZLoumH//vZt1y7x7f9mSceato6l7egB3uPuuPzeXfUtB3cePqe+hT05tm3LtptGt2/ZzuXoVE7VcTUN1ZVkQ8NkWJgSpDvU3tdHvaX+u/aKgzYy9gVn3DuihbJ129t70ExArWwt23Y1fHJyGCT7B7hmZEGUq2v2xDL4KBpPIZo/E0Jt5oyUK2l8j2xElyCzrMkBfHR5NNJDmwo2X78UDXEo5q3Ytqa40udkc5bhMY50rGkvdnZa3U2dWTduP3RefYuneEvdpS9XNAbB+IqdW7bfiAYdvAqP90TiB9iOxltOVE/mWiNJpZybcQPGxv/D/fikEjSTDXvrxPrx1UuVBRqVRCaUCZSucLZbHzHqKCkECpmiQOmQOTzJoG3cIdOPb2rtkBrh4Xhr20ZtllSaJ7cpy7KrHMWiPE1NSCJcoNFJxfArOVfzcOJjj4OB9uowRPkvG8V3AunMP5n/kMmNgDLCtKm4FRG+2RQz3LoI0mDCXJoldbgaBq3FPgizYGf84M6xHotfIqkMtI8IsiRCtUhPGrKG2i/fOAj3HVyp1rSHLWVaPQAQ2Jqqh3e7D58lM3TWZatlcrFMJM1SQE9jeOhsfn6ILAhXID1q+JyPq0lKV7QC0E0w3xjMytm/kU8B+1RmVGevG1FMpHyjWjHC0YmhOdLjiE5RKuaT7T3OXHwkyWGq70FvNaMs0Jjd3DA0ktsorX05qmrOzjFRzZeNrpE2pfLMtZ7C6tjS1WA9H1ns3tLSmH5hb0d+BGzHMUuYkA9cnpFnNKkURws8wPRymOwACnHlowH27shypYfPM/+B2ZicaOKncFwt5HWA5gKCRxAdKkmnAPgK0qRyOGq+NyrI4u9rw2+Jqx6vZN+qqEpEvaoyXs4SqJr4GPydJ7sPFk+8BVeocU75FdLtLkTXmqRL8TWIFKQ7qHRwIhbBb+oUg78VVfw1/ulPcAVSrnhRUnuiVnVyl4RXyEsvcYpgv2WTqevDD5OVKB+oFMmxoN4GXoR45qfHktJ/khfEukHaX/yyJHa8TsmWymq/iSodm5OJmP0AFCT1/dC7PPk3QB9f3z5CtKuT9Q3Nt/iuIwSwn+wBj2azDDDK7eVW1kGCv32vs/rhYcfEo7KdD5fAuGwJkq08cQ54DD7JdfGoq8Bz1le+EB+6+pD4C/ikc0LmRN+hE0fQbJBbi0BZHgyDn4XZs/BaBPyRqwuvIRorUjQEdMinobd/8XOOCnzyx0ec8BteD8+C3woM8DluboG+w6DJ4Z/7WdcEWwqfYz9//XX8HSKRC75NtGNeeEYBvmWlD1ai9x+GVtALj/PrKRT98MpqLzx+jO/pVWju8DF4D/VIxZgy37ujHIdzTk3G0gNFJtv9kAbc5FfqiiTBHFcvU9MRj7X4O29wuZrlA2f1hyN+8J5l41EP5ZYY6VZx70j3ykUX61QHd+6qA2LMLw/xexLJouI6P8wvPY9mNExAk5FfX7IoxM6B6ormW3Z2x7f3h+zlMV/YXexsg8c9rs8WLmm95Fgp3KHMm7jU3ta7vqI2gHWgSPwbbAUf4LqHGvrktJMbzeQaigj4KoWRgYBnYdfIkvquno5Re4AGq1v3baht7HEvX9F72VB/iYHCrkdokbzfIXmNOLMAn2BSO4jclHkPExBY0xPdKABv5a8Tlao9nc560NJdEy+37446bPRAtkCV1XSW215T74LHJ+62aB05RkOjjBxZ0jfeHm1S/VlSyJ4U3LKrsraPTfLfjewj5jqH1AyfnDau5IxKtHHxWqPO1Z4vCJc1DYyMNXYOFi+2ecL7ASFc6KVMy3Zr82oauj2Ll/ZfsoRxBl21/dgH1yTs4Br4NjePYER46VzAL574Q1QEhDRkFKQYgBXdFZZ919l1gc5WvVG32kwrHfWgVb+1iS7Lhxvqi590se/ftHCLoUxZYD33LGAiLabz9xZRuYVonvSPhA0cBydQD+shKrE2tXTS8iIDoHRTFiySixbU5NpBkEyvsDCg68px2ZYOiUx2uH3faP+qWAOwD2/pdumKzK54kam06b7hhdXRtjB4zmmxdK0HeYWipqJoxXBztae2QJTj8Rb3dm/eU+pZ2WAvXZrQtpdF/TSDXYagEv8FJ5G9i6d4Z2ZUBPxRkJzL0chj3zWpdZYdLYxLTkvQgNodzaRTEqwYivRdvgQer91871JncUH0ZleuN7vAVKMz/a6EinWzv4KHxHnYvyyJk0QCPo7m1AZu5T6lA2qaqyFOz+rMZh1lMgnymwRlhe7eipioqgs+bi41myid+e/sFcpsRmGi6zQW4FDko55iT8JOnIR/JLJxn5aizZFO1i5sX4hJ/ylJWlgUFsvMVEeb3qAb11vkMtcY/CNm4Da9xd4SqOmxbMaWzV+8sBswUgrpKy/xA/iCiw+cv5IBRjJ8u8QJ7wEonyIe/yhc9zt/UZ45VFTeWdtUpqK76bCtr8Lcc9kwPM7KHwsYdHYdU9R0zUaysKDtPv/j8HZhIZf76MR/iH8hHrmcTcgZinmtQALHckJUWZe/Wb1sEB73y9jsUL5HabK26EbAp5J8PoeaE/8VCFEsebl8jUWlTmHeZCbiDP1wnnpbs80BNrQUu6TWHGTrbluz2JldXt9Q21Odbcj3DUV7e7rBe0uXekqH3IzFd7NXgY1erSr+XXFBrIu9DxSXaQtNyPrgoHJSJgiRTEVpmWYVJ1OKXdjZrDl+rRU5GxIgv7BqMNKHOS9b5izOj94ckJVnFxqrNTRiazF2s/eDGxV5yNd0KJc8geJPxmXHaWvf6eCyAap9uCu+tm2ks2Vx3YjPXbvUD06sGdo90jXev2eoh7l+a2PbdZub27k+/Q8opv+C5NdPGQE3HWBIim8Gkmk9Arhh3J0vXVRbXd9nG/MV2y1Lv6qSrGkfdpXUufPp8pLSBeC9mprFvRcucXg0v1cZjdIcGJfksRcU1NCbt9UFCL6G2MCL4CPU3/A1ixRwjGBmOiYzJuSoZB0qy4arl/27JsfeEY8019nXB20VLaSsPmiweZ3hmjLwkU0ycZvKbJZKP1q4tGf7okBVnhrE6O2RYE01UPC2Qt4IrkRjzc0YqcgJGHnSw4/mmpd155mKjWR+Y0RWwjnD5ZcbKENRsKC3+TPOCjjffonsgMbJ9c4ZjXN2OgFi+VOrtJOr7hKHXGW0a/XGrHxSJ1JmSQSCVV2RRgOl0av1Zc4yc4uxcLTJ4TOBLZUSm0Fl1lKCXJGKVEgUMlV23UCZnSpUe2mXPZ8J57sKIoN0gRZvghCliZOgE9bz/SKf/qdEGBkI/cKtveqgX1Rjiazy94qDkWZYv9XJflckjuSaS4eMxUAhNJoxLWPiezQ9OMF5A5VsmkManyCjYE0WTqSzPyijOaaCSOfCrkaJgVLb+pzVYGW3yy+u7AEn5Ow7AW2+IQrWsL/3qpVUTqEpJiV7vKVUMSBRikO6/B49PAje5+e5KKA1wRATxHt2IpJG+vMAG+oXR6DdKMo/y6bJywvsvaxMDvPEujbwvreW/ec1o7tzK4LvHCywSfWfNspFebiPQk72AOoh8LoRIhgFKE9wVLlJGS6OdEjABM6idZf4qkXai025GnNewe7LKvWuA7XighbwAWR3TOwg9048MLKdMhYEnjoKRlb8oAM/y8ZbcomXE9+Df4IPCTfOylwaSiUinDh1VLqyM6lZNS7DeCAXQhLarPlCwcphvaXcuaCuWKFjFLYme5m9sHykvNBa7qZbjPaiHvABaFitkTxroYpyGfWNFxY4ckyGjt3jo0a9I9upWd64z5LDyXJlggHvI1nwuhIvigkEQz5KS4pgegURsycFWICerGy7JTdLYImNaDp8jgvzrthTVGbUV7n6XIKIrKAP8V24Kk929+1v5muNHvYT1w9MgdaYVSXoXwSBq4EmdYjn14nvkM0+JUrxTgrA20xp7dJWbnrLAC5+qcl4wF8C22vYXyxvKbTpQ9oCbWFf0DhOKVT6EBhYGTbbqYDaoM3v9Rn9bp1UDT41sxfkWYpqiiwFgX5nttMILtIZzDGzGb0soMTYV2sTu8Ht8DE8dqCVAwPgZvnoSYfyidVWg/KVEwRwIKLLoA/c3hIMt8RrXN15a1uDDVS2qt4/PA4fK4a++q6uDoWyfWFPRwAw7Wv6WqpLQWXjqr5WLm+8hfryPNTvc/23in4rEoE//qgnkvPM3eDnvAzYfw38CgNiL8LiIPYRgJmH3PjJxsRk48P+elU21RBsW6vvdtXEW8LBFvhYa9+qxkpQWt3St6adAYGOnoXtSkVHV1e9D/J8+ol/wM/AVjyPSq4nCJCCA1i1RpHPCz9bMeTwyRssfl3bpvFF/sVCgyxPqdNKOsDWWFwl1Ety2msbzVAiFGdlQZSDa1AO03JYEE1mb0H6uIU+5LLvUBYLpbda1TweRAXvtbqtljLLQ+xF8eoyZR2i4UgcAp/BQZRXaQ5Vwc0yQjZa4MUzMTR49CoDTqGjwAKXRtNSpg0IaVdHOaMLUDW1lMal6ey/ekd2y9IyJxxcqdvSmMuOalq2a1eOyZa37Py1xp17YElFm5Tfa/8MxTYN7+FWrvD8AKc7jDbwoQkT0jVGiiR7XfCqK6ujm/o/T+TvAOW5oIR1ttXlxtuV+7eE45Duv+R69531UNhaodxwjvvn95QYuT0lwkHcCwPwYaRnLgNi/YYovBVAUiTDrV8xIdR3MVmpgutvG6usb6gcpUcdDvQQaoqHxugxp3MMxPcMDsaii+HDY6WlY0WjoXhDeLQIf1I0WvHTitHGxdHY4qHzkW2RieFqeDC9NpqeI6eAMMmZMhobg/48IPw/NTn9z4rKHqm++vJftf39hEVen2jWWl59y3rL3ogfHrSLctivgUieY7dLHysZLzkqF9rtQvlRdPmEhJ83vpXoQz79h+QeFvJqLe/ZyLf/wO6/iN2PvpOV2Abegi8SISLGrxIla50guaKmSy8TJYudkOHSTXKpiKsZFN6IfyuvNKvMUd6QbdCE5CFfb1P3OSMNjbpygdPji4uUclOuSzrY0Vxi2zUevXuTv3YDfOTCTmOlTUGhkiE21rmDqwsdtU1rTBcuzq+0ybQamSZHR3oGKpcXUuX0whH2TfegI2COdjZzYzsC28Gf4EPTfduXvnpdZzShcRj+qjMYtbkmI3zI6DCm/3N4l/rEK4IG+Aaa51q4uQ7OrJN70qhH4ZE3VHK+y9hQyuF6AX726NOmUx94qvWq4Maaik0/v+m9zcEr2/aPjo6OX7F/xdjomMqpKC5pXDK8wBiSOZsWrr3sp5sWwDdqQptvX7g/vOG9227dGqouWTX+sytHx8ZW771qdOzSXQt16+7YkNt7Xt5PVq+5GI1VBuJgI7z19Of/aGbrZ6SqAtJO0hGjuypQFmKqt5iLQjl1i2odHgbeqms/16wyk1p9QFhZWxGvHlJI1/X0ev4Pp1sZUQ8Og1sJEd7n1ygAiopQMf/0puyK5bIrFOBi6RXLpOj51rp162sv6byEf+KwJ/fDp8ARQsjtmtIBvGcanvgSHPnuUUQ7a4rOG4mu09G6kG8VdPyypY/PjJBxoxxGanFXGVIxlDa1ZzePKdj7X709UuXOl8gkApm91JHrtsjVaqHCWaLOiT4WqLwkW7mnNiKe1zrnbXBUykiz1EiTZqpIbJAWBaUWPbieLC4iwTJJ1i9Aj8OF9HAzHAcvc9g+Du9wB3Bls6/Cm3xYvwWosnrg0ygqU3vi2GHTyWb91q6ubR2/6a6sLHGE4dNdW7s6t9krShwVld2pvelc+BSMETl4VQwpBO9NI00HLACvKGWgfNjvuQ3r2C8rfvnLCvZhjPX5F5CCPngX7pM1Ph7DAibxI5PLLzVPU0Yt+6L40Pk2q8EiVyhNhcG2UPUeUOVbYRvdEjVZ5bFsfb6+tMxRsx3jVYAQdCO6viQ+6gzhKq+WBRoDcX+tRpUjlehNwbiDySkUiiThBXaryZxNiaWq4dpAdR14DzjomNtSXKhUZ/nlEZfJCq0gwBjp3ApSKTUFXMVMDa6lE+jtD/j1NLybCC5a+Ug5v6AGEv+b8EMNeADLGpJncWJEAFfOkutC6VY4IuCgZSKu00CPnRIFKdWo1FrKqQo0+UQlxcsNweawJC+X1pFSkVgkyy1qtdhdw0uX+DZVB3VUrmrRbR0/fGXMs7suPslOlGn0BmuOMVeuNpR2lpfmrE3ipY6C5+BhHlWjJVU0/odhAUD0ZKS8VX1iKzxcJJmIwafYI0+s5te+O0Au8TTYizFWaVTEliSKYm8KPoG+V5OwAFwOtARRxeFhkvk8vdl9qEiaLY221litpMFA251CZQ0IuyKSInGhvhByNELIZ3KQbWXc+kFq+ZghAz8o20UVTy3IqSOXwbvYvdmCvHxBDgiJcNuK1y1R3uqCh/i5rGbOuezLVQ01gY7KhurQAm+csZY3MvBQS7SvLtxUszhaWbCm0xtc0+4Lcb6f+C/KTT9L5yYOK8eE+KfqvYpjKC29coXiGMpS4FaUlmrXr6vjn3Du8SU+E3TAOzkcZiFeSZs6mmKMQ0MdDodqoqOA9H2pWCgK/bFOEiWHYBuGW8Kbir1xcWNBeeHz4q+euAXeyd6ZDfV6gQTQQgllnFgOzvm06KKLin71K1xf8Br/wiQ/92zciueLwBnMwZ+OaQs17Nvi684usuRbZAqFocDbEqjcPVOM0rJhemRtlcEsr8qm9JS91B5eT3D5FyR14EMVv45o+P+L1pmaetbtrffVlUfVypwcSV6hr95eLMHx66+1mY3GbL1QquyP+ipi4K5Z1Ai+BIylpsRE58nVWWXySofBDM3AW1RoVgdFcqmhvIQuDh/JVC7GL/0HnIN6WzHuEolUBFA+rgutAqGUp2NvA063FaNkZElMDZnjG2nqWfJ+st295oBpUzMPqGmrO4KhsISAx58IbuPwJ3lzIVAEPoqeDYVyEV69nw2JAs87drq08W7FbLQX4kR2erQL55ObmZ28qrYlVLM1NBeHffvSPH7C8WDmlp+bGOP2ncZug5qkWdid7SCrGcuwRF0AnerFhkWKktk5Lw/VemnjLj/24ST/bRx/E1Ey5yhn6Qpnk2HF9E5xVgm6prWPaTleQ3VciWZHtqQf4iVb3CKiSm4TzA5c6h+NN4zGd5lKSyOlzq6ZEglei482NIzqnREn+s8mZsU0wcQ+5KibOLwF1sGcCB2YZu0BIeBDZdpg8GC0jopyOkuycjBaR0W7zawhqmT+dRjGnqsBfxZV3sJ+/tosyJ2n/yTPttlk0KMQSdj7CR5rYElinAKnRDkJfLMVofmwT9/PKFBzoKEm+qZULsjjl1AsGDh8wrwIJrzndgoU05U4qGdHMgHmGHFm/PB7p+AHhnGkz80wk1/RqflxEX8qlkQy+ufkysU/z3cb4ssQ5afiHJolCk8hxq+nB+Ts4vwwNSIhj4VC+lBwc8JpaChs4SmIqDzOntNQUZwlU7Run5sWOZXWh5yp5qO1kaOlm10uZhq5K1JmmEkRGYCrT5jmHmQDBaog9Eyqs2l9CosKXsfGl9I6nsbrh+n5bhJrmJtaCcvAGtIhX8iDz/bgPfYU5rDvxI2HYlWb//JqTBlYJFzsksTu8FyffYM/dFcn497AYw8PV2LsIVC5P1cIxd+72ffX+A60Yfwh5PFRqM7k4X3duRFSYEalmR0zBV6fWWzmg1GBnHTREfB4KmRDjKeynhpRhRuDuVBV7AT2vDmhVfD6Y2fMD8Ma5uQXxM45L7tp/IpPgx/fQMzF8kDSgefjij05xfcnHN+y0+A7o6mYSwTxTGPPLc3uyfYC9ci8TNs4mex4J/JUUs3WaMwl14npgTe3VGunhCAgriHy4W9gFT7Xo8ErlhSJVyqZ33/ysf1j9P8T5uOPYdUnn9hTr7F+HYnfwlsh3oezEA7urNHk1h8TmrkVR2WD5MILrC8OrR/272tvXRAzxwZG/Fd21HpNTt/mtmJHMRhjf+etW9fWAT+iersvvXfXgubilfqVzftu2b2gOc+TvzlwZWN3Lfgbm+3esv2GtalzgN/Bx5GPFSGtnhZiC+fG+VFb/5tK4qdAbqVy8ZnLgGva/DKAu1LZ/7SEyJTBeboycOF2CjFaMqrGqSXhCokgKcs2JIubCJ+eNLPVlvlFOzlbsTmFiDPrD48zQ3rL55EMcyHNsMVmR5uBW9OWmgNylq7ZJ7izXhibm0QXwjQEanZ0aw/iKGPO3/WLn8q9cjL2eVS5Xhr9WSxfum5ne7cUM5U3tC3adDWMJytMqVx4SQrhyuF7oAS+R9SmT23gHUfdXNvNIa5vzgFykAkCUvObIp8WKINVFkdEQa3qisT5vWePsxzvPQ82U4tuYFw5ZvMkNqjsvXg7eFjAWKgic5naWDRjF7qqT9Tu62VPsi+1ryudhA2BpnhNCPsQh0+Dx7n16ZLTRahxc+d5UWpHUGzPg1QDK44leX99hrwLuBXBeXk7kKOcFu/UuEvPZNzMqdh7+VCeXwLciydleJKTIXT6459RRucVZ2BGLZ1PsnjGXD0p30OcfPyp4tPT0mwldV4ZL56WY+aTMDhjLp+U8yR3Ts2FNZleUwryk/mAP31sahbRM5CXqsXRiNsV/WmYYcKMMHcWmQuTIsOT0cWRyGIdE7YxBYXv6GYIzKQwmQKUkb6H28B7qGr5MPq8mGddzOcBBaC5DJE+VDkJ5OAOc+HCnm7KrSJAr+32BIFRKqo32JQrdg4N5HbXe8L7L+YgicOrBn2kcPlQfegAj1Rc0BpyX1NYY9BElN01nfX1GJKYzYMUB9c7jPkWaags9gIGLxqXcnlanLAk8Z2e+RCesy8FzIb7/HDGEsAsSFD2hqkL1wIel4niE+Myi04DmYlDcy50ZidORnMiNMHJY0l+L5wBPzyNnIvfeTgBnQa/g0l+zGnx41LPXCwtyaQzH1eUc7I4vvegmMZ8HRghdWrNzhLOc4lRNj2Q55bnLzN7BIzVZJFO1PxcewYOkQNXZ4IzHVyVmQbMBMZjPC1wzry0yKm0/sNVjTlpNXK08uaUi5lG7uZUFZhJkcv9mOYgskPqTONMqrO1alNYtExbapnB6+spKubxiX+Fr6NR2HCngicRHny/AgygUGak8klIcMAPWihqr/xiuj1re80OxeahK9e3D3fXjZlshsKO5X5X3RB4u8IVLvb5cguV/W7adS/79X3j/XuWtpWSB3Y0tl21tZVInu/+L4So1hURwdNEYs4sdPNhM2+apczNB9cEglSlE/C4TWRfvNdlmA+5yfU9M9GbeMtgVgQnKOLm55j+h6dDn9s3mEkfbxucin5KfvOp5GdmZZHcOpiLCz/fx3zeQjaU8as6841jRo8yk+XM7YPZuYunzO913PmGhzgZaFTt55GCma0PmSnHiuk5azYpvp+arQTEuUQdfAqqCRLN6LWTuwekRWvJSqPMwRVui7nM/AV37FyOrvWUBaotbovFfU/FMH6m9JxeH0D2oxEdA7d+w8/zRZPT/GBylo+hFZrktAUcKgzWdDWtLmbCeYG6zpbxcmthAbNgRe5Hr1C2hhWQVveGxtE4lP2q/opRNJZcT+HBjSE3KGcfpq7bWINiksOSIr/h59OngybFmW4eROktXCCcAlXK59Qz540b//nQrGu4KDkN5lw+muTvPG3+XPDMJ4IsFUWnliK5FpyU46H0HP50JJmtMswj1qMzHPwU4k2rGzyGFemK5jqV00CxYlOdEsl6CbbXKeGsoODYJA4eyZDPV8v0yZH5kPD43ELpQHQKFv66wapJLDw8HpL8NzKUiYYX1EvyJy5MoeEFybE/xOWa0OmNfjbznEobf5tey0+pmC+n90+A75/QPEM9az8xpXeY0SsQGeew85KrJqgvSB/FhigVJU9j28eoS6vTJ7Jdce24N3kY8IVQSSP7In8y+wvGUQEgd1b6a5Szi5DtCpOWw5iPqXUfE+fPmZQv1ZxXkjprYuhQjVdz501OltO1zwcLuCMn2iXXOYsDwCbJ589KCz6H96B6gNd6pyztakJzbG5l3iIFVk0u79K5YLehTDLL7uqoYmjntmu6mpft2guOjG3bsvUWvMgLrGdN3dzqW35w5/hDNR18rYSPgxOoOji4e8dk1KVZp3oZ7Vd6qkfGhnylsWHf2b2DnhCa4VWUNQ6MjC61tYzi+jW+1r94jQF14eDR67fFW3GVCo6E+PlddRw1252dXA07wbfgSFfZiW8hFNyGuv6qMzxVzPjQBBo1Dmd0uPiFcPVZwQO1Z3LG+N/79iXX8PAZjmuRz/Cynv4pDkFS0tM+zHE/L+WZnOkAG7GYguSa5jYOi+yeb1Vztoww+yrnVzO2T+dZ8PxhWp7mztum9yqnnbjV8IqZ9eDtvqSlMs/fglvStsDnCR5BtijlPPlMThSkrHEGBwv+nLTHKc4XAAaLB4hroRUcRbJx53b57taWXEs/zhdZSLwC3eAegZC/j9HMtaHJVR+bLcwIhJHF0ehiLb+ww+XVK2ENeBP1vSrMY0Zn+8DMzaonUy0rvg/LK+AjoMBYRoGFtEjBNzmsFCgwzjHxBfGK4F3+M4DMJHhX+mM+/qwG8YyD3xP/hs/i+7qhnGkAvvRy8vPOzTGyxGig4bPjTVAmKygpQtHNnUtHvzmBfoPRdXSwBnB3WcJGWoJ/4qikwe9XNWZxvzAuR/wfSwwTm4i1+Pv4MM/kTZl0KRZ3jDfL5AV2Gn0d6RHJBB7nZDLMkKp4DiFBB8fbaLBmirt+PJ6VkhxiucF9nNyF0yWn0q98mQNpcG6u5Yhmjmh9+nIF77dofCDMja9g+gip2cebpjs58PWpqxWcjq8nTqBYwHcAJNSpnGO9vq+6qq9vFwjv6u2trlqE+7pg4gdBE3cfPRU+E5K+l17RjIuBJPJzU/J5c+bd9uiMR8SfxPejzLo+436UFUQDRmKfyT0pLVO/m/E9y5ndrRK8lLz0hdm/J+9cCWrQQ6j89G5hyV/Vre6dvJnl5E0tAcayE29yeNEUkj0FYb81hVnHmFLimeR3pkBJUxhS9B18FuWnGfcrXMjhGA9PLEe+twNcCV+A1yNtlnIZnPYAmgemB3DWLPZpqRC+B0PyPZJmklfMjg/yRaTftpvxi0UFQLBqQcOo2bzOOKwbMC02meH1DXbRG1k6XdYbInuD9KHfyCjhy/jla//852v4+WXuvjVc4/YB+ADLprKoLOADtgD/cf6L95Vo+DYhSZ5wSBU+fIrNF5rR4c19qPyL5PHjbd0VlrvOy+gDP57joHnq0HNPffGTBewVKnG6UwRzHT9P7oOZUS4uS54anSYfOc/ZdwoKJg8ZN6mWlZcjUX927Szi2akp548LBsCnwiAS081+MEMwVAaJ/wfqjLEkAAABAAAAAgAA9E3UbF8PPPUAHwPoAAAAAM4DAEYAAAAA1jeylP8e/xQElgPUAAIACAACAAAAAAAAeNpjYGRgYL7yX4iBgeXkf7n/8izTGFL+v2VABvcBsh8IuwAAeNptk0FIVFEUhv9z7iyKGKLUCVMczcC0Cckhq4U5IhiRFUgQRMzGNgOB1CIIWlS0EkpiIoIWLkSKoqBFEAbZQqpZFhGEBE2NNhYlyTPCkNN/LxWD+ODjMPede+ac/z9PTqEJfOQQSZABZOQgUjqHjKZQ446iQ5+hGneRkjEckTF7KhEGXQ/OS8JeSDc28d5mKdo15teRAU3ZF0YhII40kh1kI6nnnXbptg+scdHX8VFmkXUP0K9Ze6j9VtITaNVRxi1WlmWb1Zto0ZdWkj02J5P2Vk/bR1mwkttvM3rPijrF/AbmT2GbHrdPWou1ugvbeS+jh5F0l5DWvXZfO5Bkf59lHDuliGYZtzeujAJnAnmkcWyQ36iVYazXdaiRO2Sr5ThfUVs4axJNErcLqsypQrNrD7M1yk8kNGZPFDy/yhnP2Dw1TWkrGuS5/dIC67+3VzJtI/LYFjhvD/9vmjHD+Y9R9y7WaWNvXzXrIzS8jxAjY+4yetlTXCYQD5r53xFuyQHUBS+G7IcMQXi2rM32Tkr0JEG/InTxfLec41wTtuQGkQ6cZO4s6oPeq+BydiV4QP0rCfpXEDz6p/8K2FeesS14UIn3oJoe7bOc13tVRjn/MNYE/Svx+lcSUfe/+q8k6OJ9oQeVeA+8V8ELX4N7JFW24ObZ93fmc3e8f/93xfsV4Tp5TUYksrIr2zcU0EfSKNik5NFH0pK3Se7bDe5UZ6yADiwijkVbwm1rcJ04KzP8JvzcvZb7A8ZZBqgAAAAqACoAKgAqAFAAdACmAPQBSAGcAbIB1gH6AiwCRAJeAmwCfgKMArwC2AMOA1gDdgOoA9oD8gQ+BHIEkgS6BM4E4gT2BSoFjgW2BfIGIgZQBoIGsAboByIHQAdoB6YHyAgACC4IYAiWCNgJMAl8CaAJ2gn+CioKZAqSCrIKxArUCugK+gsGCxQLTAt8C6QL5AwWDEoMnAzUDQINNA1mDYoN1A4KDjQObg6qDs4PFg88D3QPng/OEBQQThCSEMYQ1BEIETARUhGMEbwR9hIwEkISnhLAExQTTBNqE3oT7hP8FBwUOhRmFK4UvBUEFR4VMhVUFXAVmhW4FfAWOhaeFs4W/BcqF1wXnBfgGCAYZBiwGOgZIBlcGagZzhn0Gh4aWBqQGtYbDhtGG4IbzBwYHDIceBy6HPwdQh2YHc4eBh5kHqIe4B8iH3IfxiAWIGwgsCDoISAhXCGqIdAh9iIgIloimCLmIxYjRiN6I7wkACQmJGIkoCTgJSQldiW4JfQmSiZqJpYmxCcQJ1onsCgCKEoodijEKNYo9ikUKSIpMClKKWIpeimmKdIp/CoQKjwqsirEKtYq5CskKzIriivWAAEAAADfAFIABwAAAAAAAgAAAAEAAQAAAEAALgAAAAB42sVUPW8TQRB9wXcQJOSSAlGc3CRIDrJDJEioiJUIS4SgGAko/XGOT7bP5u6cKCn5IVTUVPwASj4kenoqxC+g4s3sXBwbBwkadNrdt7OzM28+bgEU8RYFLHlXAa8HGF5CkTuHL+Gad2S4gJL3yrCHm94bwz713xu+TPkXw1dw6n03vIwtv2P4A677rw1/RMV/Z/gTlv1vhj+j6P9w+GsBN/yfWEUbtxCghhHGOEGCCIfoIaOsik3c41hTtIl1lCndpkaGlCNBiCaGlNUR085tPa+prKWWOrQVqnQPD3ge4AX9TLg29XZAT6GiFn0H1E54EtN2yLsBGcnpkJZSfhHvxpROOHf0ROwM+C1mNSYe6RxRlqmHaXwpdxnPxV5qLNuWBcFD4g61u7ZPqdeir4haIRnkd2QVDmVlEyvvRPlHxifivYnGJB57um5cwLnGc8lNZvGtcpb6PCWLsd6scozUnnCJVdbVzLiYcg7nPdX0hstD8lfWBCdm9URzKnbGlKaqm3s71lh6ZstlII++zdXV7v5ZVY60OyRLZePa1HuCIvUcUyuzbAcmGxB3VS9Shk21HVhf5L3gqhgpAznrWvXatH1xrpz/32uyYp0inSmMh1qf/hkn4dBXtsfKz/V8R09S9dzTM2HY0l6R3Txn6elpx0VmYVEks3Wd7ZbZuk4j3eKuxNjq1GhwHGCH/+OeWnhIdEDZDudpTK6Ch9bDoXX04jw4Xn96F0pzTOtaO/cv7WIfj+n/EXlsk+k+8S7ZPMcTYmE2H+X52+u0XtEXStZZzbUZzf8X/b+/mM/0ZczrGFiUDe2WgFmT/8i90zLfZfaquMN5g3kJOCoq7dNKyL4Ya0xN/RdS5ji32sBLSiL6F36DX742HyMAeNptzkdsDgAAhuHn7669995bh6K2ltp7791BVY2ittgzRMKJWBfEnjEP9ia2BIm944CjaIOb7/KcvuQVhLz8StbM//aCQFAgWLAQocKEixApT84nn/wKKKiQwoooqpjiSiiplNLKKKuc8iqoqJLKqqiqmupqqKmW2uqoq576GmgoSrQYsRqJ01gTTcXntDTXQkuttNZGWwkStdNekg466qSzLrrqprseeuqltz766qe/AQYaZLAhhhpmuBFGGmWHxZY4Y6P3llprlc122WmlpxbZEAgJhFpjk+XOex4Is8VuP3z303Z7XXXZPqONsc5Y141zxTW33XDTLR8ku+eOu/ZL8c16D933QKpPvlhhvDQTTJQuw1aTTJZpiqmyTDPdDB/NNEu22eaa44Rt5ptngYU+++qkR1565YCDXnvjlLfeeeyZJw457JjjLjjiqIuW2eOSs845bXUgPBARiAxLSc/OTI3+Q0x4VkZaVFTCP2P/Gp9rTFxSYq5JCVHRf435DfyPdbwAAAAAAVoSAhYAAA==') format('woff');
+}
+@font-face {
+font-family: Charter-Racket;
+font-style: normal;
+font-weight: bold;
+font-stretch: normal;
+src: url('data:application/font-woff;charset=utf-8;base64,d09GRgABAAAAADgMAA8AAAAAYywAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAABGRlRNAAABWAAAABwAAAAceilHz0dERUYAAAF0AAAAHQAAAB4AJwDlT1MvMgAAAZQAAABRAAAAYI5MgINjbWFwAAAB6AAAAZwAAAHyBNy9tWN2dCAAAAOEAAAABAAAAAQAIQJ5Z2FzcAAAA4gAAAAIAAAACAAAABBnbHlmAAADkAAAK+kAAFD8XUXVJGhlYWQAAC98AAAANgAAADYHt/aVaGhlYQAAL7QAAAAgAAAAJAgfBFRobXR4AAAv1AAAAjMAAAN876siXGxvY2EAADIIAAABwAAAAcBUtmkcbWF4cAAAM8gAAAAgAAAAIAEoAIhuYW1lAAAz6AAAApUAAAa2o+vF4XBvc3QAADaAAAABgwAAAh59S8had2ViZgAAOAQAAAAGAAAABgIWWhIAAAABAAAAANXulPUAAAAAzgMARgAAAADWN7KTeNpjYGRgYOABYjEgZmJgBMJ7QMwC5jEAAA0oAQ0AAAB42mNgZrJl2sPAysDCtIepi4GBoQdCM95liGb4wMDAxMDBzA6iWIByjAxIoKCyqJhBgUHhNxPTr/9CDLeYrzC8g6lhfM40H0gpMDACANXjD9AAAAB42mNgYGBmgGAZBkYGEHgD5DGC+SwMF4C0AYMCkCXAUMewhuE/oyGjE2MwYyJjBWMd0zGmW0x3FEQUpBTkFJQU1BQMFKwUXBSVVP/8Zvr/H6hTgWEhwzqgDkfGIMYEoI5aqA5hBQkFGagOS6gOxv///z/+f/D/gf/9/xv+F/5P/e//3/sfy9+Pfz882PVg+4NtDzY/2PBg+YP5D6bd33nrAesdqGtJAoxsDHBtjExAggldATAoWFjZ2Dk4ubh5ePn4BQSFhEVExcQlJKWkZWTl5BUUlZRVVNXUNTS1tHV09fQNDI2MTUzNzC0sraxtbO3sHRydnF1c3dw9PL28fXz9/AMCg4JDQsPCIyKjomNi4+ITEhlaWts7J06bs3DBoiWLly5fuWLV6rVr1q3fuHnTlm1bd+3cvYehIDkl42rZ/Lys2yWZDG0zGAoZGNJKwa7LrmJYtqM+KRfEzqm+xtDQPPXwkbPnLl0+f2E7w/7jtxhu3Lx7j6H84pXrTV2N3R29ff09k6cwTJo1e+aBU2fyGRhOVwA1AgCfbJLlACECeQABAAH//wAPeNqdfAl8U1Xa9z0nTW6bZm2SpnuSpslNszZJk7RNmu77Al0ohQKlC7RAESgIIqCyyL7OoIwIogjOuODCjOig8umIuM24fc74zegovijqjPPO6yjuvXnPOTdp0zZF/H6Q3Jvb3Od5znOe9Zz/DQUpHUUBMzxM8Siasj8GKEfgNB1H/cv1mID/XuA0D6JT6jEevszHl0/TAvBj4DTA191ynZxxy/U6kPDpiy/CwyMLdbCToiA1L/Qd9TV8iBJSyRTldSWrlAJ9ttGTr+DpeehAruwKWq2aLNsvbR4b31RrOmDTatAFLXiRvRP0mUTGXAujwLRywXFgga9wtBQMut3tUimlwM1EKElBcw6wO0DOgRyQak2FOeD4RVrk8YgFF9ExNSM9VSC5SGFaBaFP4b3wApVOadCo1bTbh14qPXkxPvLyuPEL/wn0ltTf2lhSv/Ww9ejp5tKGTdNLmnYcsR560GHdaIcXkv7ySdKfg9sCX8k+upJ0KbAtGNy2jUJaLA4dhip4GemVoWyIi1uVrFbpGSOjygJID7RK7zEyiEOy2mMHaAQ+lQRd1wBVEH0CUs+0nrKkrJKhBSv6fGvbK5TOqgXdi+abrO1uiwtergPpJ5cn8f+SMbe+ealkYCAu7dTqVPhR2tz6hn5xcbzbWJ+68y26yNyMhkvxKUPoK143fJBKoMSUitJSORSVRGYDT4bBDfS8bJXS7fLk80evepOzZa6bf9U1+/AsWFvNzqvmVVZWgwca0YXZs/fv3AkfXN7Tu2J5X2/fSA+86cTJkyc+QReWL+vrXWZlz6Dxe0JfwbfJ3FupfDR+ryffqM8WqJTJGuD1OYDHraIFNBqv3sNwVuHDbN1YAj7+mtvlA8U1dqPebu84misRed6s1hV1tb1lnr9izupdXavmdS5iv/C2lhU5wW5vjbPQYciunH7SE5An2O3i3qp+Oi8lr335jJttdTPqu2dW3NBhLqzusCB9AGxL1FZiS9GWFLaeMash3+0KDYNN8DVKhD7gKZKpVWS+wKa57Y/tOnIYvuYWP/UEe1Tp5n/w4qvcPQZ0Tx13jyILyAS0B0+qkTHsPHznjjkzOrrga/QH7PKLArfo7JnHnxLiOfKAVnAO3ROHZklCKagUdK+a1jMaIAUMraYdUC0FDmSsDvC9g5EzD9VaNvHhIl59rlKUWw95S/ibLfC14g0b/OmlQJbV1KTakCBcr2o60ygBJUim9cjwX4DtVCISUI4MXY7+edxy8MoPP7T98ANsZ0MtLAtgCwAUGYMm1EK9R22kpBSl9niLgX50dgSaZUGVUWN2DT5iVy4WJms1hkJn0zJ0Tw71LMgG2Wj2KQVikYMIZvei6+Whb6mL1CGsb58rORwEvPt1DodOa7cfcpTb7bpsO+Eb+jh0L3gHHsM0ALJMsLuBndUAj43EIb81IZvKQXZMY80iC5YhU5XlZMtlrkf/sXPnP7aDVZ9/Dh/8PXv2ySdA7S3sRfZv3FiWord/w/uR9SOacmRzOk8JkDO0B1SVJc5jT/aLEvbC+0eOyuJcLkES+FykcpP78pDOlIhfBpJb53Oj28g86rNpVXgMnEJOgZSkYjbjoTvKCzOydFk6ZtOi/jV3L+w8N23r6c7yetHGJKO2dNaSzq6HOXnMoSswET5AOdEHEg0ixDQAmT3nKbRn7HQcN9Dc1XvHTbNWMFppipbJKmxqKMnIFiqqm6p8aVnJGq1pfV/vGtBDt1fNvL7enZkTPySd7vdV8mtBWZGnXHS9hMkqaO2uvxHpMzX0IfTCk2heOM2gOUPuqPMAnhv09a5YcT37MvC99x48yXZPe/vtFqBiPyPy+0LfQDGaIxQ9FTqVThVWQ6xRzAc72JfKCgbXHb25faFZJ0rNVqYXt81tDRTDY4P3Jw91Ltxc5U4z0Cv4bcGKZglF4rMj9CXMRf6ZRLKSipEAehwLnhLHylEm4M/mvhsVTa2da/YvX7nt424AKoOuYG1xEXylPi5+3XL3+u6hnffsefZT9heJmbK469d2NtXNwONoDL0PLWgcCWQcKBQBHa1vBB+wTy8B5ewH0nJ4rGzkSAZsnYvl4qF5+wKmw1NIX1lU7riYph4VblIUw18CXfl+h9lbu+HA9jVLb922+KbF3cPs+8HGQm/ZTLDOWe+rLLTaK735N3Yuva59jSlvqGNRb+Pg3ILKkha/w1OFdWIOvQqzkS2KEO9ozm4Xj/F5fePsEdwmrCx0lTVUmj9Jt53zNlR3rtq3Ztnmd0FZvr13yayG5jb27vL4mYeZtd1Lt+1be/RHRL8b+egP4FPkW3LiWzgN5I9liT2ldnvkP/jUjjy2nP27PVuHPZfMWSWKFyy5Xz12P29C5OCopA8FVAaN2bkwTGjkkF05FB8VRzZSavgsDFICNFIxUBk8BvgsWwBeGnkOloCPzp6d9XnzvzDP9dRR+AJ4ktQsFPZqPnrBF0aegHUjT4AnW1tfaWmhJtBT8T024IHPjjwHXkI0W5o/n3X27GzO7vSh78DjSMfJFBqTArkCVrMF0NHKpaPs8FLZgapino0W65me6QvXfaG12rSZVgvI6NrmWuuvWAF0mfbSha2/fN2my7JadRor4tEQGuDNgL9DNoSmFXCT6HaVRJj4gsDtUvvcAikIJ8GwI4U/qdHXcMryhaWRAH02VInoQHutzZ7DNJR5q305/R67S14Zr8iJV0itTNmvbr59YM0zhzduSLpz369XXbd33RO3Pe7NWeScBs7CG7oWl7wYappZ11vn9KapVW0PGFMkSnfr6vW39644dfz5OlPniiWnX9k8/Oi+Fe0F5URPoSvo7Si8D1mKEscNhZoEVEbPpXOfgnYDxaLLfvY/JXTgbwFhyTuBb2c+Cu8buU3odArED9wvpp3OBHDpG+xTmYhWM/LBJBRljdgPUS6muaBIojRKeZwTIR3IR88ygfX9fTO7N65jX/XLZP4/JSQ11+8SZWRLOqffbsyAx46uMYKO+u4FTr4MqiT870BJxUo48hYsrbkZcjE4F+WSWWiukTcZsE5xUsdKRUWaA4z6Vgl0w1kLlg41NncOdh9dMFCvkOQaB9fdsjw1R5pam5Jjcxybf7RvjuHXS+TS27dsPZQgXYvmGI/pfjQmKa5VAZmn0dF41HK3Sy7Tg7JTT61rOcK+VyyTFb9ZhBLXsceOnZ5XgiVWyPjOgpE3QQpQE1kxPS+ih47uMBUdFlOvcpegwhKfyclZJiYGvq2Wil/cJBH6/ULJpk/F8sqwFpxHO8X/Lan9tFbC/ihb/FtOD2mItgzRTp+atgpNa1ZAJisFX1dJxc9t5ShvlVdH6P6mR/yduO6zOvFnSHBEE+fp0yi/aREDnUoKxvLXeO36PA4A9oKcItn1S44+/+J9/cvqFFLGunzjllUyRlYP6p18yWe5548cflr3wOIk2cHNWw/x/ijhE7nRvMG/I7n1JHZLsfcT0aUgkuDRh0iqd6A0mx6QAZ00ANKKZLIi9nJAyn4gC7Af40/wGBrJu+8i4dFx5F/c8ccfuSOeDY4fqunwnEbpiWOWVS6TlQNLhUxWEdEIEnzkn1gZRFZR6CvwBroXzSaI3IdjCKr/Ncg8sFEDSlYNjMWyZWur6uvUEiiC5fmwi6PEPrjn1pTfbRGDBcPU6NjvRvS0E2RxK0hdLQXII/UeHjdxxVJpMcjwyzL+Kij4sPrcn2tf/02RzB8lKPs9oMXojL7E/lbg1APeRU5wgG0C1T/HcEYYzwdbRnqxXFIKtMWyZ8XS+uhxfyC78TwnZypy8O6JcqaPnyU56gXxeWqpRFQOBEfuBAmViYmV7D+DwjdqX5UGnXQSTBIL8jJYD3glM0/A6RXzSx25B84e+Z8k2hnmBS8gXqljvNyq8AFx0xOGaf4kSell4Eoq/sgvX87eJwvmxSdBORI8nTWAhxTxDke8YuRBmMo6k+LzSE7IDf0P/BN8GNXkyFMUXIjgHDrbCLLHUnzuwLzdt8xZs2Te5jufAW0zFi1ubV80CNpOds9sXnjqeF/n8+CpO7ZsO3p48/YjhC6WtwDJqxzn1eHkwuCZ4yXjlgzln0x/krQcSPZs2bFBbZPWdKQJj9RW5kdU3r1kcDXvd0gnwA3vrmnCtJlQM3wDPoIkRhGVn4Uyio+4YDEgUY6kGFInjNVQAnABlldYnPOrBvs23FZk+eXMbbNuPMDevLS9dWDJjLYBGCgQuVWtM3nK3+9YOaeiqWnRqc1nQOmtR+7YcuvhXyGemtB38HdoPBbKQ6I41lGyOguqs4CfBADGzkdB1gKinFItj/DXgLxVax6q1UkUCoE03y0usJYxYqVIEicGqcEauayYvUzivFjd0tRYC4/NbN+llduUeaWy3My8eI1QLdUKTbzmwIdh20CKiWd/AGVVwXJkG35Ub/NRrEd9uA+7XJgrY+cxk8MSEjhczfkbZWKrNVCV70uwpBml1ZsWd/XUyiUZNm8pY07szZ69f21/8uM3SCUeM+PPiFNK1GJ/84zl2ccHJeiSzpVKW5IL53YNE1+QoYlpQfpRkHhFQnZEEXop0MtgWZVceoO8jP1zmfwGmawKpYMl4pGL4fFoxUsQDSWKq2dG624cRMhIRo1cGU5k6IISaIKS+lmt1dLSS8WS9btvK0uXS0pwoJOwx3s75y4ELXIBysZy9uTOm1r1HeVgNg6sIPTPEAsPIh5IXh7mkQ64Xh25KaMCiqLE++5JDLxb9v6CS+WYmhTXZVIkpHjkKOwXcX6PUizvUUQDZT83j/FwZNxjlBLBpeMlQBCMX75/wcFFovK/ldzRc+ev4HyJM4+WsD3gI1YOTkhETqdk5G5IsYQmdpotUWNX+8ZiHak+IsUHD7UL6YH44U0JvovBs89WsO+X0DfuFZR9Uvr8GaSAPL747BMSOi8v/kf2LTE6iF+6IBfk5QlBItAKuR4U1zcrEa+UsA7CvGhexHY9PCYRyAsSduyLD/zNf05Wyb5dIXu2FCtExF6RJeY5E9ln3pXwXS6+5HkwR4jktyKaRi5/4F5Dh0Mo6rTw3AfBf7HHASVMqmUFYN5/KWQ18Jhv5P9K1v7BB+2iJZxOt4fWg9vgeVzpYvtBvZpuOxAfPsx+Cc8XjDA+LPd3qHe+zPXOqIPT0w3gONc6k55zPSiI3C/XodZfbwYS9j+HD8PzPz7pg39D33kZnOFlor4L18kKPUPrFdB0xf3NN+6v4Svs53/4A1ByslAhJfgqNIj54IobfMWKftXezv2tA5pQILrMrQGo9R3reyrh5XNcfW1CfWMy+BJFPCNXdWHv84V7XH12uMTGfqFnPOEWD8zsrS+q2/iI3alKn2Nf1z3YJvacFs9tNmUbC8vrCqfXMllel2CewVYzvYcdkfCtvfeqXA69CfNLCIWgHl5CtpyOpZGHa2aBBTByvUcx1qUezWsp7Vh2l29l+rLa84mqrhmNValGeIn9L9tNCx6rSYFwNzOyCczrnTE7Ho9RH/oWvAG+wFQN4xovnNLHqhvwRs+coS0HVjTMNml1aVKht6m9uqze5tmxdPhA0JFlVCzmDbTNWmgjujEg3ZQiWZVkTRIZMlmo0HvGSqfUscIJ3Fp3m13ifqqzesbSfSstboumbFpNiQ7uNjlG5srirAVlW5fccFDIXg+apQOd7XM5+uBz8BWKP1jqqBWFTFSiYZoMlwdo8M8Fi5dv2zXUt5T9fUfDNKvNbC+A6+v9O1cM7189pOB19Pw7MVhaVxquiY7AT/D6CMlgSOrRxoQRZEK8zIQGoXFJysoW+sot7qIeZutWWYWdLwNdxqz9DWaTzqzsMC2PDwTYE1K+HVlNdoiBFqRbI+WigmTdVB/WrAAvj0Ytl+BO20fW4twuOioT88ZOGXDo4FDyyh6FMJ5XuWrg0Orepb48sS9QurKvospotxlybLYBc7nLU+4qAm8XGpm6uUAlE0kT5EXFdYMNQYc/Ll1td8qbfU3djqC3oKy8wBNkW/R5uX4fo88ShuN6PZo3TcTCOPvFQYKYVuQTUs6JvBVFO8SeKxaJ1W7wS63fuCV1yMjeKr6P/UoaZ7PFSf9dkC9nz3DnsInBdoF1nAPfRv0iqh4VkeYz36seW8jSe47rzGatxpxrzpMWsN97JeXwbbNGZzGXWj5ip3PkwCwT6d0eDZmp/yB6xM4UxM6UAtJGEp2qvR5exJqzjUtrDpmTtZmz8nJdmvRenTQ3W2O2Bs3gDiaPHW4byjVYGE2Kgd9luwMO6cwWncZsxv6RhBj5kU4yx+zCLXf7ootThhSnqfmSusPm5H209Y9lw8f8z65yil1WPh66g9X+OpFvtcbfzLJ8K/PUCUmclcQXXENjnxZF00ak1EWS2kNWaZFVIIGNTN5It0xgJeuYKBauRHaPi8SpZ2fSXPnceFULXFnt3yX2fG2RWJzZ+RLb57kSiyMnT2K+4paU7clbUtgIHq4cm71Ct4J9Usq32uLkX3pcSZGZRKp3+PEabAauAcB/sEzuaDYxhNK4JZX785YFthN7QUz9EmuEVAx7ocIx5FuoR/E1kVKF+86wqyRH3CMfmFZu37N6xc49vxkKBj0FQfDlrjXLd+xcsWq3Z7C7Z9HCP2A6ySEDzEN01HgdRB0t6Vh5SvPGwqfaK6n6ha2romVo/1qdU1oCmrTaiuk1xVrHu3Y0my6TI1CyZfCG/YK7JXF2oKYHZ03rVBB5jdCP+HAxT6Aa7dxGoxMdFU1HeFIXe6VUOgOF6pOHijKylM1tDeVaI7jspkd+L4mz2eMkLzg2DdyyN8Dvn9feRRN7QTkcnEA6T43SOe0lZTytj2g70yOp/WVenLtcEq/NFucnW1Lt0pqwuhf6HFC+MyeD/TCsZ7x2cAUcRjaF93XGVY5xqtG2jtMOqjDDEQrsCghF2dock8mj19gV0qH59V3FiULGZrIlZqR4ZEXeRV2N4N1bGxJl2oxMXZpclpmiVzXOSj3YkahidDK1UpQSnxmwlLdxMihCP4B+2EGiAjYdtwqv3hJNqcJlYHtZfX7JwYP6PEPGzHK3NkUE7jKaB9cHvvOZ6Txtssxmw/6E8k41moNUEr/I/fJx2acY4Mhldes8ZXvtkvxneqt3lIEv2Vf8HhkoQXGgCanFV/rg9wxXO32PDCgZfELqR/eE+lHA5icODse7zxU9NPvuAPjEzhez7wG9hG+302wz+K0A3R9C91nQ/cmj948rHBEV8K0zseX6/qWdtOeZgu0Llq3p34hpocrxIuhjjwKdRMDRG2DvIDTxngdUIJqZZF8C13MMiURhr2NoNTk6gOQLI3/6TPeTvltu8/xDH9c5z/0H/+5dheATsyBxzYYEq52+750EK5Mg3LpTaLUm/vbFeDLmH5G/pIDLuEMcP+ZwWEVR1cdj4li3cGhpgudZ73M5/a4cV/7MXMPpALhsEUjYj0GaVGCxJLCWmT22TGt6QDcLnEvA82xHb28i2mTdgZSLqJ4GpAO3A3hcLCwDu9lvfi8VVQbBsKTtUD67VTbnBGcj9tBacBI+h/f78N5VJkCRPgsfktWqbK4hxP2lB5kqOvO6wck6V1VjQ01ePV/JXznXXa5UVrj6r4fPuaG3qmRam1jU3lhX5wEe0DrYUldUWFjT3t2M+LyO6kEj/JHs2cj1cmCcCX/8MYX3KZYhiGR4HMmA1/ZItUHiELLVbAGWBwmh9wQBZo9yOZaHCarW9LlKedI4Zbl77kokSb2zuqGpwl0Hn2ua315TBAqL6loGW5EUnrq6pjaRuG1aSZUXIl4zqbfhP8HNeB4A8YE4vI+CXT2Lj+wa/rO/w+oUeTMthqSmZQMdRTPobGmWIk3UMggMVfI4RYKI39xVnQlFgoQ4XgMXU+eFvh3bw04aq/V4Crcisjj+MreHfdCeb+ebq01QGd7EZgvBAvaoIUlvtjJpiJY/dBh8C/uRfLqoHWG93IVnk2wJR20FJ6uB01df5ZdqDTk6aaCg07ds25bhgpIyL+zvh+n7e5PYYengIRVvYDB+1+CSXYmFskXT6welSA8WJHgG/DXZowjXo2qkcSUK1G5dZBfLo/e4oytXcFKmKvHBx3+3ANpTgYWVFtlBdRVvzZKGbrNeDL5dxe8bkpsDewrj6f5aaWenIEUQyMq4aXtFXpYRx3LqPpTzz6I4glfksM59ajoZsaTx9i5DMz5jvo/xoQkmsdLlfdxTVe3ps/czTL+9z1eBzm19DNNnA0Ptq9rbVrfBmSZTn63fs93Tb+s3mfrDp+zXRe3tRf7WVtzvoHF2oX7HOL5Pk4LwZv5ou4aGyqCXA9CA9iZs3hZf8EbBgi3HPe/8WVbN/rlS/s6fnEdumlcc3b897prvvI/r4O5zznedEaIxvh6agez8qfB+A7J0BWftM2fCp9i9YJgV4XfObuyhYXABvk55qVKSJRgy7qw4Nbf9H65jHcAdXt6285mx3SNSwqrJztGvPUJnu1co0SS7pLUVpYX5zqXzmltBkdhhs3jpJFlOcr5kzereoZ66W9prWlrq4BPbW9Nt2RK1VJmYQudM9+R3qtNLzJUztDu6Um3Z4mSVRCFKoQuXLHa7p1c0s29oqywlhrwiE7e2T7XBCnA3vEAl4LX9sf2fKPTG2nyDId/4FXpPS8+BF4wZ6UZjeoYxfMRr+sHQa7wC+FdKjuoHP6lEyKjp0b0LNdnPUIe3N1Cu4hwhsuiOvYEUuShtPt2w15tfeP2yuw6tWL5s+bGdfT29fdt3zu/rdayb45Fm6Mrb28o0Oml+eevirduXNcC/Fvs8B6YdWbNs5fDdx1attC3s37uvf8GCwV37+/Pyt6+dnjTQ1j4g7diQuvmNzaS+BpXgAPIV0pOCKXrSTDC+JwX1PouvZ3O2QSGv0s+taQ4KTVuF1UVZaZlg2O42FTgzVEZ9XHma1llQ+biQp6kalup1KRlkj4nygoPgAdRji/EeE0o9jMfAHd4YGjoFVuC3B9oXLmzfj/6RA4nl66lH4QvgJMUn1uTB+1wtbDw4eeVEC/p7XJTOdVQj1TGV1mVRSue7yV5LQtQSHY9bosP50Cdn1CpuCRIFh8nT0L1gB5qGbsd69uv37lyTqJRKEhL5QigEouwcvlmRlyVRxot5EguTWPiyy/NLWrzI6xZPnp6F7OXewQUL9+zrdXo3DM1Ww3iBWKAQqAUZMDvNIFAmpCvN8Yx2f6IhJxF0igT3gjbGQtYZ5oB74L1knQHFtA7QwD4O760hNqwCvwEe+DIVjzuRiA3nJ5P+Fs/fohvaZ9zQ9g+PwejxGozw5RkB/4y2G3vqPZ56L7evSMMXYBOqG6RY29y2OIofHhxOwogJ0DzyBGy6t+Ve9J8VoXCEZNICEeiG9+E6X+G+Cl5g+PciE/vccL/FqExKSUpO7agqm7YI1HmGHS2LPSYr3ZSoVjCesnzfIJfHMwAfzIInKQfBk0yFF5gEF8C83guULWjz16cmi8SqdIXB7TRL0pV2tz0HB4jktNZN08DFOHdufo0tK0kVV5aQp9fl8ixGvdZE18Srk7KdhdY6IsNr0AQe5NZ1gJvWA8f6wxXcwg4IvRpyQx14FHXsFPLd8Fal16dw88jmpi/Iw5YmIJaIX5I4ImAQ6DwLnMIcrcUl8i70JZiNqXFCgVCQKBOZKtqhubMvMUEWL1Er1Klp1jPff2RP1uTkF1Ah9kdLEuoM1SKhVFyQXD0wcJ17lb9AlaZOnnVHuDZ+DLyM8gJBNahoOQG7YFcG/PPFhdXyz1bBYxbhSA08xx56ZWkvuaccUNRFcIxggsa67AhGBRxDB4e93EG++1AoDVyPzlCXhRwnau2HuAuagY/y+ImMucxnsJoVQZtAVghMOVZvoiPeoMN1Si2ykxo0n2JSc0eaTob2vGOhgx+XxwvmwZPsASHMyooTAhMt1iCbzEBx6jCKU4kE/xart/Pkv9+xcNGs9sHFG6Y77CazA/66p23a/J5pLb2G2orK+trKCkTHguLPkdH4o1bRHpQ0yYH596lTQ0PnH3poaAg8MBp88AHHl6rQv3k3whPoLjmyb81EyTGKLNyDYFfx0e4/5dL+d0viBbOgo5qdUQNtxbW1defP79oFT7APJMCMDJ4QKGlRRs5ID1j3mW31avudR5B1VaEE0h/mY4vFxTDRs6IcawJPcPZRkZF9fel8c45YrTSltpaXNCyYzL7Qudja0O80mOlaoSopxxlwuntITE0jYz6JanAXVYzz+LV536jzTVbKW4XB+dMKa1KVIrEyTZ7jdJjEaUlWp0WflCQ2pTavbwBF45UF/hXnYJxluZkyZVxxvE2nMfJMOdosA10WnyzX2D3myqPR+oOUMfQteIJg/bSRNQBuuUiFzcQPfNFIGh9IRoVq0GoBZfsrx5AMN74JH0Tlq81WanlpFMngKB1o/WUlxsFw+/+8e8j+f8oUCACeW62PgQK4iNeDJyMB4Lpz10yXjkWXxuHoWuimX0VeJibpwc7rmpoam2NT37BhlP4eQt88BX3UeHLdTnYmauGIwaJgEYOdw+swGXoSDT57rrZXwsRiOyArDNo9Qnlh0OFDdhrmv5Hw55BJsSSAsYq5GAI8M66+i8G+a1LJNyrD8yTn5lB4MSBiez4u6XrzjXRMqEhib2Vlb8WqNKMxDZGrnCQP7/kql7Oqsl/OFBiNBcxnMWAkFAxdCO81G8n4Y8MjuF4gzBqDKXluIIAF1VLx02skwqIioWTNexJ55ciVYtkHi+jAXwKgNrHwzqefhsfGIyecfNkjj2LuNMyW8gXsS2SfOC2MJ8n/KUQJ7Y6VM66CM/nvCekkJu7k/LgkQ+ogghtBdp+J+82rI0dQH6KfAj3CTkc+GxtCwrvn3M/kg913Cj7vIBe+CptxfHKuZTzMlKzYlzifnpIdcuswNsmL/CoT2bPrpzhSsdxrKv4ro31sCik2TnYzpANc09QhHUjxTvJEJAoedRQahT0fNXMRSEp4zvC+Qu9UdPAsRdHpi5qZcWQQHbwe30DoJMeiQ2YhitT58YqPooZVjnSO6i8wk4dxx6njZ5mjGFPL0UP+JJZmR9nE1qk0jNdKIiuEYRBGZOHAg8sjvJNFYFsoeJ96+uwj7N8DstmzZYE39+wJQ7fueRgx+6H4XRmf/qyY/SaM3eJwHhdQbkjF1fvUyJTY6WEyXuWv47PD1eArvD3j0gTSLcGyoLnCWJasq6JZ8MTFRLT8gCwqNqoFuM/9XB50bB7ZyNyumYfuJ8fBTMFmM2eKU3LiYgDHaw/hlXdVXrGnMCZr5fhZnEIEzfj5iwvLspHIkkO6wamliZntYwrz/6I9ZgpRFDH8BlC7KRn8P7CSPFPgU+OlPprBa3wnPyy8eLHww4v4HfTjs6IPPyy6+GEh0ecp+Br8AlUqGWRdWk2HpSdLhNxOd3jXR50QLrBhjbNw39I5+1ur/fbCLWcPN1Tn2gId11mBif3RVT5jCH6R0Tv823sXdOgX6noHnrj72axa46GbhzvBbrbcfsctZJ2HYGeQzWhGEYNXQc9g5EJsBM39uH69OooGG+nP5Ic76tj8wCZc2P40Q2r8GI3XwpO4xhRsdeGi9yc5k7CN5pXjvRHxzsUV0E9xj7myGFuWP46rR39CoBiGyuGVVyK9pOCVmSkRPXgSYqF6wIrwFMSE9nDKh7jbggGCP8yOIFKjt0sjkDdFpNzTAn25rHD31p0blHmycpRP0EjfTEm860hiGoGjeuYvGljFKx7Ds7HN8K6DkPhdUuhbeB28TPARnKsQnF1k83HcirI3DCAf3WOWh5tlmJaUYHEmZMhTy4uWzCisC8anZBltfHmiVuYQVhd7hK7cdXHaSwXCg+tmD4J3oEknU6ckSpny/Kq5yn1zpWadWKUUqxLS+KY6R43Yo84P/pvdLOVb7XESsHrv8Z5WC7YLgvlBsuL1VfM1o35I9zg18udR5IVXRf/A4+f+v3krcIc5Ne9cZA0/k7ftZ42buSr7As4xf0oC3JeGZXiLyBD4GeOP2alOLVL3+Gx2ddH2ju9dwzJeIDLm4d2Ca5Qydjc7tZB7oqPI1UXcFKO/5eTkSVF9moTkLBxbW+GW4PCOVr6CE3GKAdBhyX1A6UQdb2VVg9dgzGduxiJOFHsDkdnPk1Y5XVW4/c1HnS9TwO4hgk4U/y4id1a4xvsafgC+RFHYRRVgbADHXR3uOFU61ShEYLyciohmfW4coP4wy3x91/y8wpYZPYC9WN5aVdM5b3nrgo5A9boTNqcsZevsKoM2+6F7m9rBbIO92uddtThOFrc24Kn319XXBpuQeD6ngH3g3hSHIzv3c8kG8nxNWhg357w6ci52hxwbT/f+hOZ4Mr5u1fjOmMdh4ZBvKrgngK+GhiOBKBYirhaFoBioOHD6HJcPfwYPEnBi8TiAQs218sj+KR5cYInFJo8LKbE5cfk9LszrAuFlwJXw1bjFds5YvA3RbhlLgl9MckaSz0EOGrcIo0wU0UA4PF2nIiA4C+5V/icKAAcMXK7GvW99zPvxVIze/zDuQ2LcjzEqBOMqImju8fcTNY+SaAr3GBOocL1u6D+ITgnSqQj1zroJlGKqcJRu/LiafRx1/kSFYb/7BqbDT1Ftgvc4jbjSdkAf2aCPWs5Wj/ofqhjA7CzTDSlLtS28Aw1LUvuPb1u2eve2RbmFhozS2mBhQTH40JlXYy3NidN7G4IW/zOP3HRw5/DQtqCof978hUsH+4meCd4N5R8NfibgpxBvsdNOLBzclrF8o5svZa4Ci4NvjW+hiM98C/Vo7jBGLnVKlBz2+glIOfYjbE4T4XLgwLmfQZcsXk+gW4GtLBbZ8TQzpqbJefYEsifClheDMqkNONpvEdqWqWnHLAUmsBKPn4/JLDdMyPkc7wuEt4asmMfkHjuKTGD+3ThPmMR6xeRczqPWU3b4AmTI7yGoo3dJMJqdP/oJ3JOBci5jAiUjTwADdw4ZU0Y6Yywwvd3ScjdDTpnw/J9CY/KT+KiP9LWx21pfGDoJzpgdwzuuq3F6c/P7d61BeTIzx1uedOH+dHtRGfSntFf/YuVuZXd6V93263dI/ckDc8qKRtg3df1zws+rEuweso9UDtk2FXoPB6WJCL4VxJhjoPiA/tzPoY2bpknowHpi0lMRj6at/Sm5mcnkP4tYdmwG4XVEjscFgkeyX41LzE50Is+D460sFmfepLjL4QLhZW4l7CrIQKzEKdCBfqzKq0AEgWW09zdAF7w0AbMrnxKzm+oT1x2yYszuvht1TmkpaNZqK1pqgjo7xuzyDGhsb8YA7ZK8xY3rQmQV6ioji6nc2EO9dZyKrzbkxMk+zT2LgDIh+c2N6Dw6mjLHZUlu/Soh/HxjaqRjRxkxaqcIeS7q2NOBtljeo7nlOZG0gaWL5dVp8yXkSR/JI2W2DvYN2Y3nUYf+Wp6jHAi4Z1NDLHqrJc9yIFkUmGhklQGT1HsetoJmzXXSIvarIklVRg/6KvsXn62RfVUmsFoFkktOewXIZSLPzFzhvQ3vR30Hxh6MJWjGM9UeV2TviaCn7urrb5rWB8GhKrH87BpJvN8fL139rkReydZO39BWXtV0//ZtcPD2Wzb/6rZbtgzPPdqqwFsQNXL2e9ni3/YutdiOLrzzXDi/8TBWW0jJ8bNMIIziQ8bEx8W5gObrRh80ZMZqCmJ/IM3t9w8WFoHF03NdPOBkXwVttQ2Ns/qHqhsXDW3ZunRlZdWCrgFwbrC7d3Bgfs+inaINNeWemfPz64umTds5vHLXtOnXL+H0QZ7l492Neur8n/c0H8qTPuRn1/RQX3NjU9N1ndfybB/vwQ0bznHPiV4Bh+HHnFzXjApnOKGuCRz+PSfVNWHEvyBSRfbqV/I2UikoLtiusvoV01NjLYc9NXE5Lvay2OSFOMg9A4fmjuwVTXwKTsGpYvLDcNO5cY97Jg6c5gYIOXw00nt4/2k8QhpwNCcApdk9HMVowDT8mBAE1HxoAgdRzBZwz6+h/PNaeCn0crgXgtQWmA1W8KQofqiiMZK+qOX3l/qrqvorV6czTDoqHEb7eDnShsmEtELiz0xYBO5ENZiK4JRiVVoLJoABJtaz+LnI58FXIAvjsuQ6lQ4/iweyuiJ/O8/7lPtbMerQeJ+enz0bX3eBXdTf4VnS/agJOHis/HpJNRcEFIyGcTbBs1mF0xIFKWkapsBREsai5aF73w3fy+A4FPXzHlXkXqPG5GwGu7J8rUJBSrrGWJAXXMTdqwu1Un+kNuJ71RPv9SWje5MM6N7Gh7MKpycKkjPQrZgtxPKCpwhPXQyJDZOGkDwPFCcZNYyrCRjRedRwpifyVVmYbumADn0SksEVOkoGyLyisYEnER8pqUvCEkYEVE8eLWKDSKPRHhwdeBMaOOaiDBoL7aWLNESDyiwt/jSIeeSEWsFDRAe6GFqYdKGQo6wdz4TTkBKPBDHRZhVNC3/C+gLU7dQl8ATEvyRFJY0+zHU7RjnOuAEU3NDeHvB34JjeiWL6AfK7TPhXwaJ/m0kX8/S+CBpuaeTkugm/4TT+QFE0/u2xuP8e/e0xvDvgoNxT/f5Y3OjVnNEzJlvmdsm0k3+OrAbMJRfAZ/gw+x9VVdVg71V/mYw79lSyZ0A9e4azST3lpV4neLgIGvf1oaGHIghc7jtG9J23wt/hoHLGaJQcyfnYsRqjfrdKQHBcx0Z60JwvA3tRv3E7lzkV4R/VIBhbDw5XBrdK7cPxOHyN1jPhM2bZJ1k0bc6+WW+maQ2gVhT5l2u1KzNaNdOy5mo08PZ6K/8NQWqq4A2+tV58/28kaYKXBakp9IuXL7+IL7/Cjzw7DT4GH3MxQq4DH7Pp+EVsXoPe5sDP0BjxE3KMIBO4fWOYO330I3GjvzrjG3tCEHT35Lzrs0k8Ibf0BVl+yCUtK+vxlxotKqMmw2gqYGB/i3VlIJ1tCNde89jjkTNjVtz2Roc+MzdBYzRlZplM4ef14ACRJ/q3uvQ0kUwVQx41+M6ASqlvvLIcTbdp27awEHP8NeUK+OnIbK6mgvWGVsvqQGAc91sbXU7qfwELJak2AAAAAAEAAAACAAAOquycXw889QAfA+gAAAAAzgMARgAAAADWN7KT/1r/FATuA8MAAQAIAAIAAAAAAAB42mNgZGBgvvJfiIGBlf1/1P9olncMQBEUcB8Ai7kGe3jabZJPSFRRFMa/cy4R1kTiWFNmzkzjU2eMeiNIhmQoGcWUBTOmJFrMopXVwhZRVvRnEdW2aNcq2gj92baI2QhRFK1a1KLNUDCEISNURLfv3kYR8cGP8969551z7/cdmUQSfOQoSZECJiSPtH5Bjw5in7mIQMvoxlOkZQZjJJAquk0/piWJuBxEK+OAVGyZ+R3kLAlJhmwle8hucqS2lmGPU+QAa1x3dVyUr0iZ+8jpXbugF7Bdr/IMbxkLpANNOsvaP9EiRfIBEb2DFo1jm5lij4/kB/NzPrbrI8S1B706hnotoVEv24p5AdUrgBZZ/zh2ykvc5pl/MWbMN7zmnUBOaIJ9+lEnn5Fi70AjvO8we7Vjhw6jXrLsn7bPNI0GCREz0+w1jmb+E+gxbNb9zH+MLfKKep1BVEcRU7G/TdxajWK9GvtH5rBLvpMq3jP28f4jTndq00s6dYK18jyb26/6vLyZRJ88ZO8SdXKauW+eVw5jk/fiGhKkmWvvdMC+kQqi3pcqZrh+SJ5zr4ROcxODNZqoeZvXexXMJTvrPSjUPKhB/Td4D4qIkXX0aOOS/ivgue75d+fBcpwHOST0Bhq83qtgQP2cB5H/HiwiWbvgPchaS+Z1L3MW9V+B08W/Ow+WQw/oVaP3IuvnqE5C+9fMs+848zk7zr+lWZnzHpwmt8iImxXODGDRRUKSlE/oIiFp1SE84P7omrUIuJcibXhiT5oEzkuZM3iOMzOF+D9cRMVWAAAAACoAKgAqACoAUAB2AKgA7gEoAXYBjAGmAcAB8AIIAiICLgJEAlICbgKKArYC+gMWA0YDegOSA9AEAAQgBEYEWgRuBIIEtAUWBTwFeAWmBc4F/AYmBlgGkAauBtYHCgcqB2AHjAe4B+YIIAhuCLAI0gkECSYJUAmGCbAJ0AniCfAKAgoWCiQKMgpqCpYKwArwCxoLRAucC8wL9AwmDFQMbAyyDOINBg06DWwNlg3YDfwOJA5EDm4Ong7MDuoPHg8sD2IPjA+yD+YQIBBaEJIQqBEEESYRfBG0EdAR4BJYEmYShhKiEs4TEBMeE2YTgBOWE7YT0BP0FBAURBSKFOQVFhVCFW4VnhXeFiAWYBagFuoXHhdSF4oX1Bf4GBwYRBh+GKwY8hkkGVYZjBnSGhoaNBpwGqga4hsgG24boBvWHCwcahyoHOodPB2QHeQeMh52Hqge2h8QH1Yfdh+WH7of7iAqIHQgoCDKIPghNiF2IaAh2iIIIjYiaCKqIuAjFiNgI3ojpiPMJBAkVCSgJOwlMiVcJYQlliW6Jdwl6iX2JhQmMiZOJoImtCbmJvonLCd8J44noCeuJ+4n/ChEKH4AAQAAAN8AVwAHAAAAAAACAAAAAQABAAAAQAAuAAAAAHjaxVRLbhNBEH3BM2A2XiLEauQNQXJQbCJBkhW2EhGJEBQjEZb+jOOR7bGZGScKCw7BCViyYs0JEJ8LwAZxAs7Aq+oaGwcHCTbImu7XVdVVrz5uACW8RQEr3lXA6wOGV1DiyeFLKHonhgsoey8Ne7juvTbs0/6d4cuUvzd8BS+8b4aL2PKPDH/ANf+V4Y9Y998Y/oSi/8XwZ5T87w5/LeCG/wOr6OAWAjQwxgRnSBDhGH1klFWxiXv81hRtooYKpXVaZEj5JQjRwoiyPcT0c1v1DZW11VOXvkKV7uM+9QGeMc6Ue0tvB4wUKmozdkDrhJqYvkPeDchItCN6SvmLeDemdMq1qxrxM+RvOasJ8VjXiLJMI8zzS3nKqBd/qbHsWBUEj4i7tO7ZOaVdm7EiWoVkkN+RXThUlE2svBPlHxmfiPemmpNE7Ou+cQHnBvVSm8zyW+Uq/XlCFhO9WeU3Vn/CJVZZTyvjcso5/BqpoTdcHZK/8iY4Ma9nWlPxM6E0Vds82qnm0jdfrgJ59h3urnfbs66c6HRIlSrGtaX3BEUaOaZVZtUOTDYk7qldpAxb6juwuchnwXUxUgai61n3OvR9ca1c/N97ctMmRSZTGI+0P4MZJ+EwULanys/NfFc1qUbuq04YtnVW5HSes8z0fOIi87Ask8W+Lk7LYl/nmW7xVGZue7Ro8jvEDv+P++rhAdEhZTtc5zm5Dh7bDIc20cvr4Hj96V0on2Na550hveziAI8Y+yE51MnygHiXTI7wmFhYnc8wv1mj13V9mWRftFqbWf2/jP/9lXyqr2Heu8AybOqEBKyW/Hfc2yzrXVatijtcN7TnNdqKdEAvIWdhojm1dP5T1jb32sRzSiLGF37Dn7PnHCsAAAB42m3OR2wOAACA0fd3195q7706FLW11N57b22pqlHUFnuGSDgR64LYM+bB3sSWILF3HHAUatx8l3f9BPndjyi9/K9nBIICwYKFCBUmXIRIueSWR1755FdAQYUUVkRRxRQXpYSSSimtjLLKKa+CiiqprIqqqqmuhppqqa2OuuqJFiNWnPriNdBQIwkaa6KpZpproaVWEiVprY1kbbXTXgcdddJZF111010PPX/999ZHX/30N8BAgww2xFDDDLfNQoucst5bi622wkY7bLfcYwusC4QEQq2ywVJnPQ2E2WSnb776bqvdLrtojxFGWmOUq0a75IqbrrnuhnfGuOOW2/ZK8cVa9911T6oPPllmrDTjjJcuw2YTTJRpksmyTDHVNO9NN0O2mWab5Zgt5ppjnvk++uy4B557YZ/9XnrlhNfeeOiJRw446IijzjnksPOW2OWC0844aWUgPBARiAxLSc/OTI35Q2x4VkZadHTiP+P+mpBjbHxyUo7JidExf439CXkEdX0AAAFaEgIVAAA=') format('woff');
+}
+
+
+
+/************* Start Charter license *******************
+(c) Copyright 1989-1992, Bitstream Inc., Cambridge, MA. You are hereby granted permission under all Bitstream propriety rights to use, copy, modify, sublicense, sell, and redistribute the 4 Bitstream Charter (r) Type 1 outline fonts and the 4 Courier Type 1 outline fonts for any purpose and without restriction; provided, that this notice is left intact on all copies of such fonts and that Bitstream's trademark is acknowledged as shown below on all unmodified copies of the 4 Charter Type 1 fonts. BITSTREAM CHARTER is a registered trademark of Bitstream Inc. 
+************** End Charter license *********************/
+
+
+
+
+
+
+@font-face {
+font-family: Fira;
+font-style: normal;
+font-weight: 300;
+font-stretch: normal;
+src: url('data:application/font-woff;charset=utf-8;base64,d09GRgABAAAAAGvgABMAAAAA69wAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAABGRlRNAAABqAAAABwAAAAcejWA6UdERUYAAAHEAAAAHgAAAB4AJwEvR1BPUwAAAeQAAAzJAAAufsATCxdHU1VCAAAOsAAAApcAAAeEea4ezk9TLzIAABFIAAAAWAAAAGC9HvlyY21hcAAAEaAAAAJeAAADfi1PSJpjdnQgAAAUAAAAAGoAAADcKygSI2ZwZ20AABRsAAAGcAAADW04JI58Z2FzcAAAGtwAAAAIAAAACAAAABBnbHlmAAAa5AAARakAAI98Nkbdf2hlYWQAAGCQAAAANgAAADYHFy/eaGhlYQAAYMgAAAAhAAAAJAe5AvZobXR4AABg7AAAAnEAAASkTnpJu2xvY2EAAGNgAAACSgAAAlR7Op+sbWF4cAAAZawAAAAgAAAAIAPMAjtuYW1lAABlzAAAAjQAAAWMd/vBEHBvc3QAAGgAAAADDwAABL0OjfQ0cHJlcAAAaxAAAADHAAAA5wgX+o93ZWJmAABr2AAAAAYAAAAGTJlaEgAAAAEAAAAA1e6U9QAAAADODu7cAAAAANY3/RcAAQAAAAwAAAAWAAAAAgABAAEBKAABAAQAAAACAAAAAHjaxZp5kBXFHce/82BhWY4VfMDuAgvLsaCIogiiYhSWUzQqhwcpSwOxrJQWZRGLqqRIwj8oHonGxOCxnlFykERiguIikpD1WI/VuCTZlCwxj+NVdDxeGYcUE518umfetfeFzq++0zPd/evj19/+dU+/J0dSkTbqAfWdv/CiFSpb8+11N2rK9euuu0Gzbvz6zWs1X33JoyBQjMBp922K+s1dtWCcplTNXWHuy8z94ksu4r7skou5r1i2lHuORmzNTd+6SUNuuG7dWsVtjOydFPXTEPvukGJy99FLfV4YEOO9SAVIEU+Xa5IqNZkyT9LJmqpTNE2n6jRN1+k6QzN0pmZqls7SbJ2tc3Su5ug8fUWbdItu1Wbdptt1h+7UD/RD3aW79SPdox/rJ7pXP9UW3af7scuDekgP6xE9qsf0uH6mF/Wy6vSa3tCb+osa9Ff9Xf/QO2rSP/UvHdRhJfVvva8P9JFS+kSf6qj+q2P6n0PLYwutxa7QTu3Vfn2u/U6JM96Z43zV+Yaz1tnobHV2OgecA6QiziHnPeRj4MUGOe+htT82LDYaDIudHJsemxWbRdznJj9ah3LkvayQZkOrFYn2cp9lkM5rS0Qcj+c5aH1uWkf7DnCPaSljsA/00/AgqRFBQiODlEoDT6OCRo0JfBUqTszwYBupvkpIKeN9FDlHE44JXKvrkppE10XXJ7Xe6sZ4ch3H5imxaWltF23P5umLtoe2F9WaggEjqTvMb/KafEnKGm7r8yKNUfbtGKV7GhC18SjlHEP7GNqNUW2mJpecqUhvZKhrWzUgqjtlY0tsz1PopEv3bC7HvjmOo2JzNzHc62nnU0GttoMdQYN2BbXE2nzox6I6PNg9BHaO0lnOOF1qywpL9G1O068C7D8EezrwZxB1nKChGkbcCI1UiUpVhvZojVG5xmqcKjSeuTElmgOzYf95Ol9VWqgLtVwrKOMqrdLVukartU7rtSFvVtybw/9qZoBh/hN6FrY9pxrt0vPaDUP/rFrmg5kLB3VIrj7Ux3D+KA2OOUOdYc5w2F3qlMkpmGJ5P1gTnaed150jsbjzdOxCsNF5um9l3wv6rtIaFdLjMno6GkwIdmgS75N5ngpmgJngLOJmB4/pbMJzsOi5QZPm8HxeUK0FhIvIsxgsARdiq6WEy8FKcCVWX0Xc18h3NeH1xG3i+RZwK9gMbgO3gzvAnaRvAfeB+8ED4EHwEHiY9EfAo+Ax8Dj1P0m4Ffwc/AL8EvwKbAO/Ruc34LfgKbAd7ADPgp3gOVADdoHdYC/tqwUvovsSeJm4V0AdeBW8DurBW+Bt0AD2gYPgEDgMjoD30f0AfARS2O0Twk/B0aDaiQVJ58Sg0YmDEYDZ5EwOEs4U6u2nE7DWMFAFP5lRDqx3zJw0KR4pHikeKR4pnmPmwkAVozmUPOMIK8B4sJr39YTV4HlKJ90x5Q4mt5cpaxyoAOPDctHw0PDQyK8jrRW2LV8r1Uwr2+ZvotWAVjWtS6BZrXJsMxaMI74CjAeTeJ/MfJsKZoCZoCrDKxdeufDKhVOuLqPUZWA5zysIVxJeTngFZVxFuNryy9U63tdT9neI22D5loRvSfiWhG9J+JaEb0n4loRvPnzz4ZsP33z45sM3nx41wDm/A3658MuFXy78cuGXC79cPUO9zxLuBM+BGrALPE+ZuwlfIH0P+CP4E3iRdoR88+GbC998+ObCNxe+ufDNhW8ufPPhm6u/ofMuSICDxB0i7jDhEUKXsj4EH4P/kO4xGrHAhwEJGJBghKoZoWqnFB6WYWfDrFpGpxar15JaS2otKbU2xSfFjIdPik+KTwrjhBeMh6NKWA7GgiqwCB4sBkvAUrAcrATGA1xteWlGyMP3xfF9cSzoYUEPC3pY0MOCHhb0sJ6H9Tys52E9D+t5WM7LzNBXeH4VvA7qwVvgbbAPHAJH4GK6xyfSn7jpm+LMuFpmHH3kuRSU2V1OX3Y1RXjKOH7cweM+oYGOWVEGKTZhr/GhYxdX3I0Hn8UeqiFoCrygPkgh2DZwzTqmiTwnA5+3FFZLsuLVqYC8CQN18zLlc0/mx9m7b1P9CKYtqTCNd9MuL8zXpdp8e28KGpFUfmym7lIbJoI6VvBeutpvadibvFYW97Qu+mdsFtrQPIWxydxcoUXxWE3BZvqbBMwsUorzx6OlDZmDvdj/DrXNWDRZSeKnR4b9sX0qSreUtHp2RLkjWh49JzO1F1nu+K3WscPWsQO71Zgao+jB5McjGcsQy46LXaiCWuK2Z2vLHckWlkr1Anv8Hugm7axpbNlKO6/ScyyZO0bEJDIzM4VVUq2NZVvzLz+WXVRziyTyYwxLo3mZCG62NSaaa7esKaw9v93Gu3WNaZ3zIVHrvLz56rNrDmdR6J+8KMWNemn9Vo6tU/kM6ahe2FwDkqARZprQeN5IbI46pMGwOpyR5Glkd9sQbMWOfBOQatbVeLDH5I3KrO9NLnZnVls/E1mDtnrhCBoGWD/lpz1TxkeF/WUnGWwj3fjtcMyLrYdLtpx1edxy0+21WqmWY5mJ8TOjVIxWXWjRrN/oaC6Suz7yoKbsUrte+dkeRfZvsCOWLSkesaZTPiqHG7XGEvZ5D3UYO7rWiqnQ05Nu/GEy7YPI0Yifrw+20MIao20tEg+2pz15/jzNW5vq0cnaqyDXA7TJkKJIt1Pez7bI5bssy5F0P5pC/01Mo7VnurWN4XN0T+WOQzTf3PbY2SytnO/j/Ks0b9TnROtxkU0pt0/xTI4ivoXjUTkmvahFaTl+o4NVu/m6WtSNGeb2YHZ7x2d96kmbclnRqYwLc57nRBxq2/LhWK1Ur13NW9mT1TvvmtDjlrl2RejOVdw7Y9iRrTJ1+V8ce7vb8g7ncqqFhp+X7rVrhXC8mrpndbt+NdvbtNLe0q7NUbOedc7qrezXjuXvSrtp9tKucyO79+qiXm3+CtaqfeIt6uoecxs60c7iZmxq6LhfreYo6vpMsd/8X+jVzuxKRbuqxPFcbbrmAewupFM2bf411bVvuV5rfEEb8eU2rTgvX0EmJZ5ZLxV+e7D7TOV7QuOzbC89+72cjW/sdft/lv1WMDvo1rnTXS7Qj8Zc3S+K/9R6rPOzM7gn+KhXag2/flx9WVdpL+wO63I9QvY7qz3+dHuMavLeDwc7YGCdZf6O/BXky/eXnepPsrnFwi/nzFdzU8v5G32hJdv3ap06X0nk7g5a31nZuuz4mjOinlon54whcVxHxc/uVzo6L+v6PoXd/O60jw2/lDutubWtcemMP8nuZI+T1RLZ8xB7UpHq7PiaM6Iu7ISanxF1yf+FZ2pd+R4Oz4hy+9mJHbffvfUnPCNKP3dm/c2crWxpq13tnxF1zxf1ZF2NfhGqsb01J0R7WhuDXvoqjOuMLuQubzcl3quz5doucMKcoR1Xj5fjYbaxIm7J7HrrO1qRW2NoR+wIrrU771r8hZtdbdvws81+Y8z5tSiV/UZNtzI6R3ynxe8ViexK1PlVoHtnQvaE28/apXW/m++1wt9yWtkHp5rbtbdPS4LtPSzgjB6ktryWZjifwCb1LVllvWLC+v/6tr93886WU+1y01GhU6FB0dtie1+iKs0H0oAoj7nG2vcBmocssbIoSo0R20d9o2+uIeqn/iq0uYvAQEofTGz6H1onRrXI1jCCckcShv/YCi/zry3Z/22ZOsP/bpmTxImaxL0y0p9PSW1dC8C86HlJTnw6bmGrWn3oSZ9I0teAqNehLAFDIhnG81jan5US+8+zUMw1Ckn3I5QltkfhNYHnCdYC5t+csUxdph0lFgWRRfpjj/72aYx9Dv1xua3fWG4gNjIYpIoMBtuRCGFsXplBbs/avuYjc5Gq6D7PjtaCNiw3xvJohKZmYk633+Dj4cL4ZnkLI5yGFFgxvayIYpUJR2VmUFpjKrVMs2M0GradmqnH1DAJTLQiC2mGvVciEyOcopncDSsnc58e6feLSkrr5V79bTvzTx8qc+Kyp9sVeVLYqpUKM1IApkVi/zNM+3NlYkZkZ8C4qA9pKbDvoYSsqUCrkNjCjAWyCOMqW2lRpUVWL7zM/4bTMHN/GnkMjM2nZ6C80Wrr6oeciYyP7qfZ0eqP5WKUWWi1ByHmX6LDiIvbf9WORPrDizLSR5N3AL2bivc4lfEqYWTPJ7YKOQlGLtLJzKullHaJLqVdy7QC1lyuKxntVbpGs7Vaa/QV3YRcoHXIXK1H5mkDUqWNyHxt0t2UdS9ymbZoO6X8Xn/QjXpGu7VWe/UyGnXIBr2GfFdvIN/Tm9qn79t/PG/Sfh3QZr2L3KGEDulOHVFKd+kT5EF9ilTrqD7TQ07MiekJZ6hTpied0c4YPeVMcabod/8HCOJD8wAAAHjarZXrS1RRFMV/d2acatQ0s0mGCgszK7Mye5dkqYT5YhokRCLR6kOiMRoVREH0zt7vtz0+Rn9A36MiIqIiKiIiIqIiIqMIwdZ96C0JGR8c7l733rPXOnvfe/Y+GECAo7zEV1hcGiFUtzXaQPb66NoN5DfUtjRSiU8+dHZaaODBG9ObLPwF1UXpZC0riJg2bNqyilLZcEWZbCS8QranTl1tQwuhddHaOtKbovWN5Ddv2thMoeWRJJvYvWIcfoYwlGHKIJ4EzZg+wy0LI8ggm0VilhKhhnoaaGEbu2jlJBe5wU3Lz1D2fmEcl2k3Soydxm3r2TA6bPRkOljlYKuD92z0BhwMO9jmYLuNvnIHbzn41MY4v4M5dhxxn5VXgjLbzma26J2XUQQZLTSjTBGmkaf/YT4ZjJS3z8k6ScNDKmPlM14jsdc5m+3t1jO1GTRVUydZc0FyY9Ls4tkMk0ufeAYhXam65ljfMXmAeXR9bYMcR6/3KHAYqZqZoe8ZG8flBYW5in1BH5guO03eeczTPl/SR76rEdLeN9fPZynF/VBxlcZoR9uxFLJcddc/LVdvnOq7K64SygkPQNFVTVfPcGOsVHdYNUBdV3uCutHf8VZRzepBUHdXyFC3+zf2Gtaouw3OGvY6BlOcTkoMu///FeiLmZnirJtsdfYiVlr93fSGJo0AOzTiLf9gD3/zroqJZDJJZ8lkxT1VXX+aane6qnGmKmuW6mO2IpurnTlfu2mh/v1i/aPd7GEv+9jPAQ7qTDjEYY7oLDjGcU7ohDjFac5wlnOc5wKXdDpcoY2rXOM6d7jLfR7wkEc85gnPeM4LXvGaN7zlHe/5wEc+8YWvfOM7P/jJL37TYXiUW0BXkzJysv0DynOOjgB42mNgYfzPqMPAysDC1MUUwcDA4A2hGeMYjBhtuDiYuNmYWRkYmBhYGhiY3jswLPgNVKPAAAWMBxh4fzMxC/7XZDjBIsX4BSgxGSTOxM20FqyOGwCV7A47eNqtkkdM1EEUh7+3u4JiA2lL/4MsIDawAooVAXtFURTEiBpjI6CxggexIyDGgoqa2MVeUBGRRDl41xgx8W8sJ49GEsEdx4UYEg9enGTem5L53uT3e4CV9hmM6IgU6p249jbJ1HkO4+hCH73qSRGHqEaJu3hJkIRJvCRJiqRLhmRJruRJvhRZmixvLe+sdbY3hofhYwQaoUaEEWUMNpKMHKMmPCK80vHS0dZqUep3Nc00XMyzYpMeYpdQiZNESZY0mSWZki3LZZ1s7sTE8DTsRnAHM7GDWe5iimaK+q4+qVeqSb1Qjape1ar76oKqVqdUlapUFapMlaoSVexMcDqckT9T22I/WE2n2Wr+MFvMb+ZX86PZYBa8d76vaM5qjnWLatfkPw83i4dLaf6iC5aOlfUfjPaXNu2MG+50pRsedKeH1rMXvfHESzvmjQ+++OGPnQACCdKehhBKmNY8nAj6EomDKKKJoR+x9GcAAxnEYOKIZwhDGcZwRjCSBBJJYhSjSWYMY3VHjGcCE0lhEqmkkc5kpjCVaUxnBjOZxWzdN3OZRwbzWUAmC1lEFotZQjY5LCWXZfr/+9jPQe3/UU5yjotc4BJXuMxVarjBdW5yizvc5i73eMBDanlEHY9p4CnPaNSEjaxkFWskgG2cp4B1YrCFtfrmAKd13OTSaTVbO2m3nmIdr1HPLlaQ/+d8AzslkDxK2EsVn/miu7yP+Im/eIsPT8TBc1q09GESLCESLTH6zXbxFbvOeyhjN+WUcphKjlDBcU7o82Oc4azu79c4tWWFrjqKHe0FfwFd7K3IAAB42mNgIBPYAqEBgwGTEQMDk9X/78j8/99AIv+/wcXWAtVwA8WNmXb8/8ok9v/rf2OE3P8fTM+BYj/+TwHLPgfLT0HRew9J9z2oflMg1ALCO/+tGR7/N4HxmR4w2jM9Z7RgUGSqBADByzVcAAB42q1WaXcTNxTVeEsI2UhIaJmWyginNNYYSlkCGAgzcVxwFydAOwOlnYkdui/Qje77gn/Nm6Q9h37jp/U+yTYJJPS0p/7gdyVd6a16GhJakrgS1iIpG3fF6FKDCpeuhnTUpYNRfEN2roSUKSV/DYpB0WqpFbdYJBGRCNTCmnBEEPseOZpkfMOjjJZtSfealJu5unbQ2RnUWjUq1MIiZUvR8rWwqIpuJ5TUbGJqPnIlzTGaiyKZWnbSpoOY6o4kHeb1w8y81wwlrOkkkoaaYYwZyWtDjI4zOh67cRRFLqyloaBFYjkk0WAyWIHboH2M9jWSu+OixYy7ebESRe0kIqccRYpEM1yNIo+yWkJzrpTAl3zQDCmvfCooH56DGnuU0wqeyHaaX/Elr7CPrrWZ/2kgrrUoO1vEYiA7sgMF6eF8CWFZCuOmmyxHoYqKkaT5SyHWXA5GV79HeU0DQXlNZGxsCxgqXyFHyk8os3KDnBasoPysRwNasqnD8CUnViSfQPNxxJR4wZg6qNcGhkVQ82eL/Wzt0JuzN2RPccowIYDfsax1VMKZNBEWLmeBpAsje1YinypZsCp2brOdDmCXcO+7tnHTsDYOre0cyqI8XFWMZosejeg0k6lRO1nwaFSDKCWNBBd5O4DyIxrl0TJGoxh5NIZjxk1IJCLQgl4aC2LZiSWNIWgejevG5TDNtReiAzSyqm57tEs3lsLGJTvpFjE/aeYndCrGgythOj4ekJP4NFbmKkc1+ekI/43ij5xpZCJbaoYpBw/e+h3kF2pHZ4sK23rYteu8BZeHZyJ4Uof9dcxuTtU2CUyFmFSIVkDi7JrjOCZXk1qkIlO7HNK48mWNhlF8OxUKzpcx1P85MeGIMeH7nTidKJTpTtndjzDthm+TZY+mdOqwnEacWe7RaZblYzrNsXxcp3mWe3VaYOnqdIDlEzodZPmkTnewfEarXtypECPCSlbIuc4XxKPZDYvT/cWbdrG8YXGmv3jLLu7TgkbK/8G/p+DfPtgl4R/LIvxjuR/+sVTwj+UB+MeyBP9YzsA/lk/DP5YH4R9LrWXVlKmnoXYilgFyGwcmlbh6mmu1oskrk4dbeAgXoC63yaJK5hT30EcyXPb+cC+16XChxpVGh2bTvDNVC9H/2MtnN4RnO84RLY8Zy5/DaZZTe1gnLuuWtvC8mP5D8G/hrJpLjzhT7OtRxAMObG0/Lkky59ExXdlT9ej4P1FR0C3QTyBFYrokK7LOjQChvdDp1FUdnSPEG4NGi+5w3HGmdiPCc+hY07QLtByaaMnQ0iHh046gvNqpKCmrHZx5cjNNVux5lFN+jy0p5l4yvxSuZ2RWuuuZmezeyOf+OohWrcwOtYibHTx4TWPucfYBygRxW1E2SNpYzgSJCxxzf3twTwLT0PXVInKsoGGRH6fBwGjBeVsoUbaT5tA8kIw8Ci7/0Kk4kb0qGSPw37Qd9L4uFMKpXiwkZvMz3VioKsJ0ur9Eg2Z9UdVZKWex2g8hO2MjTeJyWJFVvN1sfXdSsl3dVFChhNGFjZ8JNolbVXs3W4pL/swGS4JeumL+lnjQ5V6Kz6J/VDiKi7QrCJsuXlJZjSppxdmNe3tu0+qy29y0Or/l3kftOK9prvwohb6mk+UObOMag1PbUpHQClWwIzAuc33O2MgnNKR86zoXqML1qeDm2fMX0JjwxvS2/MuSrv9fVcw+cR+rKrSqDfVSjLp21tCA58q9qCxidLJcVN24dL3ph6COEEzZa49vENzwyQodxS1/fpv5CzjO2T1Jx4AvajoB0eAo1hBuuYgHtxetFzQXNDUAX9RraGEALwE4DF7Wa46ZaQKYmSXm1ACWmcPgEnMYXGYOgyt6Hb3wPNArQI5Br+p1x86FQHYuYp7D6CrzDLrGPINeY55B11lnAPA662TwButkELNOBglzFgFWmMOgxRwGbeYwWDV2+UA3jF2M3jR2MXrL2MXobWMXo3eMXYzeNXYxes/Yxeh9xPhUP4EfmBGdBfzQwnOAH3HQzWgeo5t4a7ucWxYy52PDcbqcT7D5dP/UT83I7PjMQt7xuYVMv41zuoQvLGTClxYy4Stwq/3zvjYjQ//GQqZ/ayHTv8POLuF7C5nwg4VM+BHcM/3zfjIjQ//ZQqb/YiHTf8XOLuE3C5nwu4VMuKPXd+QyvS9av0yDq5Q90Lzde6K9vwHKO9OzAAEAAf//AA942tW9B3xcxbU4PDP37r1b1LZLu9JKW7SrXrZoJcuSrmSrS1azJMu2bGxLlm3cCy5ggzE1YErANiUQkmAgxQkhD4fkEUgg+ZJH+PNIT14IOPknH3mkkILfywto9Z2Ze+82ScaQ/L/v99nWStbunTnnzOlz5gwiyI0QLiMPIA6JqOqLGFUvfUrkt/8h+EVB89rSpzgCP6IvcvTXGvrrp0Rhx3tLn8L09yGj2xgIGb1urPvtt79NHpjd7CarECJo7dxF9Cw5B2MaUKGUj2CKSYTxYC8ihFuPOG6c6zObjTm8Ibc86jWGSLguaLMInkcbGrocFQ5HxYv4rdlNJU5HmQPR8abwU7iWjSciu2QhmA7IYRgR9RmN8jjYGwiJ8IVrA9ald8MXfurdd99F7PkSeNHC805UiI70PhkcXCWVZIkECzzAg8l0BtbrB3tzsrUcQrrJTAPR6UZ6NZjjhrg+p+Snv2BvYh3aPP855YMTkis/P78wv9BV4HTk5dptVovZZFT+5BgNBQCiGLJ6RW+UfUVC7Csksi8NfCPa8aLhVbmR3Cfgayj559jLRU8U4R+8XXUe/lS9XfU5+FP19ttABhSZ24b/zvUjP1oqNXiwhreYAR5EerIwwd2I1/AnEPx0AxBCsx5pNLAIHEfWw0qMkz5jvtfo9AgGRzkW/V6PYLXY7C5sEUSrN+IPRG2hYF0k7A9U4Ui4LhoJWW34t972K1oH2iY3T29dW3vdgLdv14q1ves2r9k4VDNNdgeWLqmP1hcUrX50q3jnSb63pKOvo0UqKBpf3j4h3HefBmnQ1rm3OCd5DtYyE1lhPQKoV+oiWNTgHsCGEzA3gwQd5jUCP6OFhWagjvUC5OJ6JIrjYp/dpuGLfe6ifIet0F5oNmVn6bV8piZTb7CU63AAazyARigYCVdhxlX+MJ73G/LVWLACvxLbPVlZM1m5/5ahoVuGSEHyfx6d7XCQrwYP1nTAv4rx06vGT8c+n/w/wGDf3EXyffIM8JUXVaMlUjRQ6HLkZQkc1nE84MPzKvQIDTE+wetBDsZxX0F+VUW+t8Bb5rEIBns5tgui3RsQvB4/pTSjd4iCKtrrxGA0kIUtNg7WphneoOtE1tZ7ljwwsmXtsTW7pI4ltWv6+te2Dn6j4t1N/a+2Vg9ES+q7IlJ1qBHvtx5effsVV24Yal5bVdcXlEZH9o6Fn+l4dfI7Zct3d+L3ipvDlVJleUMjlVEqZ+gRJmdmKScutSBjOcRgKzeDdD0iCxZ8Njp3A+a5epSBhC8ZOFxTXpdTF7VnYcpCoj86NuLr6unp8o18G1f9eEfu9A9vveVH07k7EJunFZ7NSn4W5QhigCEHTIez4g/ji7Hv06d/dMutP2RPY1SMT+B7yAWUhbxSUWaGQa/TioKG5wjORJ0YGGYY9cEkWSiLAD+YxahdtIsBMRANRO2Bv2k/ajyzqXJsrHLjaeNHteTCQ/WR0iNF119fdKQ0Uv8QowG6A7+ML4LmWtH7pA00hY0HtsSYIDwNa6mZFLBGM0JAL+TDT4hoRhPv07fIJPyO9E9IWQCFARmY+IuGvHJsBeEHuQKhj+DwfffV33cfvvhA6AH4R+dtn9uKnkUjQBPQcAZABPgHfg3CC4voofSPMp6wWrKxN+pf47TZ83KaSyvtPovTYTV7b/xoJqNtG3bh5XgY1jBXsiKqKUdhCDRJ3+uXFxK7I268PBYDteAK098zfQ1zi+q6K1xqNtGP1ynaeS1TzTmqWobnDs2dwndxPphL+BKQoKbcbrZzh96sfXM9dyLjvaNM97bOXcR/BhkRUTazBYSw0ceoGkLr4SPjCGyB2UR1OLCBx59TFzTl+D1Cji2I/7z71d27vh/qf7i//2HCxZ44fx6vejrG47p77429dIrBMAgvbwPP6ik/ABuAlqaaBIwNNRPcJGLK2Wi0yNYmZARWCBlDVvf+c0/n/6zmdOzGMGnYWnrd7M1hmTfh5QKT6RqpMicb9DwH60vokIow81S/TlKRZpzmRE5fqVEDUlwsuiPNvCyhYkBerCxOxBfE2M7xkU0lBT1Nkf7islVHRncWVq8f6Q2HgxOr9rb1eJd0VVS5dm4YKR7s3bGqV6ZtEOj2W4DDh1qkpQY9sJcJ2K0gn/AaDjgDWI1HmpkEVKBsVNMKz/uQ11fm9bkp45mjshr3elSgRKsL5JRqG1nHw3uvi7lN6/ulsX736N6JHceaVh7f3LTTF1g+3Tc52Y8Hq7tbo53LfIMbOg6XE9147+o9tZXu/uE7uhmsdfDyJ4A1C5VLJTyAhHtAj3fxmGiA9QgIToJiIA0WYw41OW5vxB0BhgH7R0UDn2mI/fSHtd/5nRicmDhXiV+3xJa+8EKIjt/JaPE5lIeWSRKHeZyVSTgNrAnIPZDjGHyE12B+BmYQJkUsCClGDn6bh/KMXq/PY9QyU+e2ynQACsQJ4BG9Rvw9bexCpH1859Hpwx2Bxsm+1UPLWxoqyeeCbxbsWz9144h72dRjw4VgVgnqBpj+B3C2Iw9dIRPmiBkYxQHSz8sLxGsQgKTAwSyYKld5ua78XE+ex+unK5Rbbo6DQzV/Mw4F7cwc2z2iC8uLd+PynSt3Hpjs21IWvWpo5dL8oLRqy+Obeshof9eKfrxm447NO25ZfePKHU/tqS4NPLZyx76bto2PDANhVgCcvwP5EFCB5BAwlQ5Yk85k7c6k3B6gasH6bD0uiz2CHzKYyd5QNUh2LTwfAzzNyAV+VIlU7LFnEh7Eogcp5myMunWqKJeW5vmZO2YRZYyYQaMvQRsH6l1glrgOgZWQeRK/cfRjx7Zsv3qo89CBRw+4Rvd/ZF1f77rYS10b9vRLrcS8tbV179iVV442X1FQt33FqpFYvySVh/e39vfhn+5u9raMRZcxPdM49yf8B4BTDz5FRAoWAEiAqh2TTtDPGlDPZBP8gonIGO7LMGBkyjEUZhQKPNJjvQC2AgfB8CpOEANbXhQwTFzUK2DdllYy1NuxaiQyvOfY6pl9576V1bdlTVBDmnB4ZufRdQMrxmsPbJw68vDRZ14IVVmrenb2blB9Yfwzpv9gBSjdAbKZFE9Y1n4mRc+SFH0r/8OnmdqNnVK0L5HtBRvXgiqkUnD6QOpA1sAvBYHguOsRVfvjijZHeMDqTZ2GSzYn8lzOuFFR5/s0NS62ImZcqG28H/+YWIGXQN8j0PeVOFJsz8T4+dhZvMYW+y6uu/9s8GzVXXfIfvcUehVs6VPMb/dIhdQagTIFbQDIj1LJAFvJkf64C08ZkNqml2P34S30Cx8L/yos68PV6E78MjGwuTXU1mBNoBJHNfDhs3ZcF/uuDa/B4bM1d9xVdVa1O58HfsiDCKdaqsjOYvwAI1F1fixJb3Icvx6U5zjfZ3Z4qSIHjQlmOtzMpejMLE5dl/+u80XCPik82hoY3De42l8X8ffKiyQs663tLCsOeUrDPa7JocZyqbSkJfZGfM1G50Lc4wBTLWrCu3ufzADvIqcIa/mljVZOp4XlErkeZ++TBcm/16i/n//RiQl5jDDi9Vir47XgOQuqSOp0ZD3wArAsKJ74j6LIBHUU9SnzlLFnNSnP6vBiT7j/gdm88GxN4lkdcIGOSx6DPojSn5Oq5j8CXpeoIcmPJh6YgD+SORRsiAabQk3FPq/P5y/2GAz55Rq7rI2oenURxfx5FQ0FGtdoUc0kc2JDQc6jKKuo0U/+I2frru9c3PH9m9ffvyG0aTAkiXzxlt6N1492tq+MLjv/sUPnJ3/w5MzmZWuXN1QvzQgcri5++9Wjr1zdsv22FXeeqQ+s2rPp4BF37C+79l9/7zd2fnn3l35OumbWDq2sL8TIyGRFDy920NMiOI1+yYt4YFUebQaCQIQJso2HMFgyvQ4+IILA0KjBHXCLXnMIRD/E4Z81xv5349Jf9v4y9rdjs0e/8hVybnaEHIrtwyep/HBoJ4yfD+Nngr7IR03SEoIJi1EEUBg8mRZh0dUoPWGtrdbsLGu+1ZlrM+VkWbIt7hItdSBVD6IcG4FOEMFDbAX+LaWfF8euklbeftXnHvnT86evPR/77m3Lu88SzTVOoh8a2LSenIs9GvvlHXfjsv9Z1nQY5LoDYqgskAkrCkg+UMuc7PkiWVP3qoIKdhzW0sPUhBqqhoJRe3z9COdbOrB2/4HJccndvffQqfv2biVXl4bufeD0fdHStq98+omvyDqJ0iHK6OCkelOjOnMsOYEnwXuhlM4C7z3LmeUwZsMHM9yCwVoOTmPQxYEe8HLwUzOBaJLz7rypbnx8SbG/aWykZnhVaKi31FXZ2VpGzmVXdF392LHeaiO5evbLeU1XT3RvX+rTA74wP34V5jegUskP6wL+Cz/NppZpr9EkeUpG2VMqxUY3OC3gJBnd+NXYw3i1GPvtX/+KA+RccC4Y+y1Sxn0RxtWxccHrogkKGIifBM+IZ4s6xFxDHdIZGQNRSrqNdFDwfF4UY3/44x8bYcDYxWDsBRhIWZtyWJtcFJZqwXiibD1wDfhdHDU0bHiWU2DLpGpR8LJM3qScQg5dpwjEjsbEWhX6mtauu27vprG228X/tWnvNfc+dmAv2V9cdzr26hkfzP/V+vOfe/yrSMGL+Bm93JILpAJcPTxNV0128FPo5Ab6ADI0LxUi/sbYc42NuK0RD8aeBLb7ES5XxkOfTopxBynssOJKjBsyenc2NlLhgc9q5g6hpxhNjVKW4jWBw2TFwA52Gq/CVBbBmiMFGztuqc7rbydrZh9fvzbOZ254VgNPuySnBlYYGJuCPNjLyUxmNJlkuxfSYS8IsdGLv9MV+zWu7I39pIUCEfu/YifxbtwEwKi0wN9mY+ZJNhV2akTJEAEy5HCgFAAD4JWdjdiljX0B8Li1Tn62A+D5Fjxrpj5cjpancQ0ENRy1yMf4ZHqajVZrDjWDbi8HGhL43SuIHFU08Jd8q8GbI5LPL3mKaLML61uHP8s/MYLXPHRg9tckf88nYmdhyj8QcxxeEoQ5sykFMjWMAhyjAFEoYDUaGQWMFHmvzUpXD4f8+O/1A7GvEW39CrycaHEuPgXK7MqNB2LbYfh7r6L0pbw5zfw9C4srF3JGLSaLrDFURzRoQ0zHU/VBpk8duebeU/91b+yuF3bvfmEPHjv77DNPPPa1r8bK7j91+v4HTp+Kr6NR5gEUlMAj1mBKNYj1eZ6RXmUgvR4jvVGfk2kQIAxFOqwTqVNJpYs5EFRVMv2YsanxY9ffGLtvy7qpF7EhdpGc27jtx3h37IWuNQ/KOqpj7lPko4BbDnKgqBSGaAdYDyJbGPYYCFlyAA3QUEwxsttMxgy9oEE5OId6sxoFYYj27BBOVJE44niMof0IPtEdqLv2Gwx53XmK+RMXe0hLqMZXGyeAjH8Nkz8zqpcieip/PYp1YkZDIYKg2KiMDIQyzBmm7Eya/XAbIeQCS8XJZABgzJhZC78X/+c3r2n8zH+feyV2+KqnVq3D4djL5NxX7/XGvkmujr11R5ck85AX/Li/AC2KqH0w5oDaSbUPSj4Boqoyb2mSfWCZzKQQL57HDAXxz30d69uGO9Zt2XLtjttWeYd2DazvW7997b61B8iuQFPjtiUFRatWrt45Utq9or1ZKvAMd/esobBY4OXXzEY7pVwqxCoDqHqIiTNoIYhsRS/Oa3wJvyp+kxwOKz7sFPBsCTyfRZ+XVYEak0Ac4FXUAUiwpUhWLZRrpxrxisartu84APqg5umnQf9Xbj98iOXCshXeZPAIOKFgFJUmawQcAhEG0cU/aH6j7ZfSNwhzDUCOGEx5iDriVEaBvpmibH8hhOWSxBQ+mI2yjWajmVkNqgc4phfosGb8+QfI8fpTPafJ6a5TjdeS+2Dse8gOmGPj7MPyz1SXAqyE2V2QVoPIc/OUgclsMsnqEIY3s/HNXAiI/Im2b/yi46vkmWU/e64D348tTC12xZ6hqpHhQMdGTEYhwtJqCJdOCaCsQglgQ0aLb7S80fjLZf8KEMW2xH6HLfj+2MMyv8HL99hYEDWAo00S6R95sdPSP9ScmuLpHxbCYPySGLsC7wAIb43dGw7Xku5Q7ewzShwz9yCa45zxiEi200BtFhHRgTkUj4g0XmafQ2ju7Nk9e6a56yre+2la3o3QOMyJRe7Tb9a+yfneO5rBnZBt94Pod/F5ENUdHPgZgMao4m0QHJ+Hmr0IfHXQaTjne9dVcCUwRiXJxj/nJIi53F8UppbTVGg8L0kXbb9J5rAvCmg5MII3IHp/X/O8dOaMxEmxf/+f/6EfLJm7DV+Yex5gLWJjLJKTpENoaOx3IdaFnzkg5+JcZCt6h7yTyC+axUD0HcsLReQ2z3hY1pWVoB9+QmzgzbFMWQ4sWDYgmY81fC5wBt+TR+22nCCaVqPuCeZnKVbCW+Y1+5jDUhxR7EQjTUXLoV8BpgntKhyIeOVdBLwvsrt37MiVqxtv6M1ZOfT5XEemvyxr/LON0Sv68cRY59BouLmxoNL9+GypT1silGy86aq6BsX3BPnnyJsg/3a6WwBsQ7N2uIdmr7vi2wMT8naBunsAnm9OttWcbc+x+3zM74+KXmPUGM8ZmT2ile1uPMoHG5o3rlu3fd3kFePN0eHTnZ3kghj7wdqTx4+exn/a9vfVv/yFkn+/iJ8Fmi3oc09cvs+Nn3VFO3tWjfd2NuQvm9x84PDmNfhCoGL/zh27q0qidx+95gyK54B/xvDOQyGpJidbwZs6k11qhiyBtqrQ6eRm6ohgo90Y3x0JBc3GODD4kYag2LRh3aadayfrw2Ndgz3LJ/DL2CnOFg2svvPaa87ErsJoYv/OK/eocLwOeBvBowW7KgrMI6HqA2tkiz6fAmaTzWrKNeeavZ4cmqsrdtOUnEwE2b4GPILorsL4tdgjmjWdg03O9ultV+19YetLbcM8LiXdb09NRwItd//99K2HTL+amt6wRdW7+AagiRU1SHVaEEYd6ALQM4o9G+4F6HgeTVIVOULZdUhD1Y0Vgctk9npZJtMcCcmxK1udAhwSqZnN29DT2bLEXBusLfuIeKIBv1Y90dSRX2EvrRirjvnwa/KaeOdC+A+kAVWhBrRSGrJjnivKJhod6bFhrgvxnFbL74YP0mzVMdByGkGngZAbnhRAX2m13BUqpdi+3KjYV1/n80V85pKQJ0dvKCi3R+U9N385pusWldeOEk7JvNIwuxErTOzHYdlqg6n2hnvHHl0SHlzeERmcGT81aKxeMzIzVuzLto0ND4wd3Dq9G0+0tbV0dDa3tDfjcNXm0sqGilpP9Yb+KW9dTunUwBWZBk9W/Yr63v4W/NeW9q5D7cvi/vNrQHMj5XsNoKLKHoqLnuIDg0ZgjqnZGBc1+ImC+HhDg7Stu62hMjyG98dupwL2vXWDA7Fb8czyRhhyNcz0JPlRfO9b0TjDlLtHFHNkTlK7JpmNLFsbGqr9ubn+XGKYvUiO5/pyc31A/rl358JsPJFmYCVnTjYhneoWzTB1f0aAR81MDatDieA6ZBG2oXYfG7KzIaeivMzWUq2Me0dMF+kMFlgrCpcPKD4e/t9AFxqrQJSlxCrAgKiLQa0YaItqRUWz14Cj4LHf0PHzdzrfbmloIIbfxS5gF35BnM2L+zroXRiTUUFkdkMAS8pGVAXc62UxV5SmXphERaYaSk3mHKdvFdB1dk9QLM3eoMQRfwW5zad7MsZMLQ0DWf55pBdGhsiThrgTvQJ4/mzxTB4ag4KI5IPqkJdNpP6nncoKfKlrif9XQ0VVf0dDLb9s45WW5ZtupP/FV8U+gne0LNkd+wgxTExNTX0c1hb+H+cfqj+qpHK6v07AVYKpR+JBx4Qa28HPRgRAmD3UZTLbk1mIwvJxvm07cFFVaLSjgU7DOGiH1MBmVXXVuzAXXXe/5OVxfAaU2EbWabMztWad2WzSJG3UmdXEFQhf66FX9h98ZVv/6Ehf/8qRm9+75+737sV/3rtrx759u3bsZTYpBDbJBn6ZHTVK9dlZetAE4OJnGAju1MCsI1Qlz58aIbvVbITHMi2Aok1FEaYPGEWj3Uq1JEQ7no/zrdPr1m55tr6hIa+n7KO3TBDD2IaTx4+d6o/9j5b89K6/l9aCVaL4hsBG2JiNgDgLbASnmsZOWXQSdiLFRPhYyhZHQ8aAcWETIQYbEiaic6h3GZiIltkSLbYkTMSBHdREKGu8ncFRK1UJEOkZRJpaJz3U72MCrNKCRd3yVrPJ66UeoNke37thayzYu6L5VoM1b7IaFnlf21KhQbg/9iwsMPg2sL4PwTxuqotMxtS4ZiI1rilLtcGLBza3Ohq7oq0NnWMje4f39BQtH2/qqR9ZsWJqcA1+q8xf6S+rMtm6pO5+KRANVdVU26ztS5p6ZHnNA3i2kDvBwECUlwXgZAMfEEp/1CWARiBoEmNlHdRUj2yPwBiZ2Q43NUdRKzVCSX4CmKOGW4UT/tLiMnttU0srfqPiqHhDReyx2qrcEnf3MrxOnn8rzP89oEwOla1M4DtMwwOMaSEOzw8lh/XwmoNyTCDmVLbc1DFg4RKdFL7jR/i2zbc1VFav7GiYmHoYH4rd2Rzdja+avajETPhbMI8ox2CU6gpechbFrGRR5CAnu/nj5MGlzywjhlgZ/jEdQbHd5FMwRjbVlll6OZahlEroSoiVjCyJgpNDJZpA2dZw3cB+clX/9Y07yNHWw4Tqe/zvsVqYwo//IxaA8fUwyfMwfjxWouqOMGJwsn1SYyVaSmQOhOy0hsjs/Q137/JnHmk/Sq5d9oln2v/8Z2x/55VX/hJ7k+EN8vUijJlFx5Tx1mHSmYx7bgruWZhakKg3u+UT5FTTk671a7W93XYLgOnFv5j969oNWdVZ3Z2ynw4vN8HYi8RMI5cVM90gxj6Bi2N/xYOx12prK/DnaytiwzK9K+cepO4JKqCawYnZ5iOPQEGAR8JRM05m0ne7jFajhYarjvIo1QJWj78Jh72RYB18q4P/grdEy5xs5wI17R19Jb6O9ppAQWnHf71Vml9R2/LWQMhf8WZLbUV+6W/LQgbOKMNxFmKqn3BumNMuWRJREMuvc0aOZgWB/84Gp7mb3jvC/OwHca4KNyfv0NGSJoxmKNQQqM5AhMJrxsG9ozKl4QcAaqvRweAGnylShZuoYxQJ2mgcAnBTsCka93WUFlDQfSV9FPSMt0Zh/lDZbxn4b1b4QwNvUfCVmBPn4h/jQyA1LSwGC2dngc4HqYYgsIcmALlxgIfu1M+wpBKtaEEDGGUa9Fqe0IySxmBhIRq4cnRLjKo5WcTxlGubsSa/2NTsLZyBH/x+nFtZYff4Kysc7czPpPE0dxDWPAe1Ss0J7sjJzDDwPHiahD9BZwfq0LwuDYTVpDxEwghlZyn8IgjJ/GK2R+2iN5ASaldddZXjuOv6eMTNLevtdW3cyPxdmUcv/h+DI5l9RRmOOBeTb46OurZvR3JtZCPbt6X+Id0PjvOvvB8/iuOVkTSiNrFqtbrggSp925C8yWiI1ZATahEORuvmtuEfkicg/gW96bDDYHJAZ8wCFcr1sFUlG5BSCjOI+nKtC4V0tOIvqczvh65wd8/K8a72hvxwX+3klq2TNX00tNu3a/ue6tJK7cnbxTsPXnWv9p57tDDDZgDk7+QZVEhth9NBkJgJZCTgGyFeqZwSRWE9EgSWsFOLcsBwWI0+I/PTzKw6ioqkm1bRANt7U4Kb37z4otOFo2LsI4HC1tYNA5OtgfCySBsx31X98XCdhQsH7cHyz1ff1TfRXRilfngIzeBZ0oYcyIOul9zZBlhum0mr4QmXB6aEcD3GHL2Ox125dvB3UGfvk/rBVZIZEWB+gjbFIwKO7l1mLPTWCC0OXeiBiQkpG6OiwnxnVgZyYAcVnmIPrUHzh2kZGkUKmIalZsWA4Kf1JxD64DypesQ3EvAP+0aqWpfWDhcPBUqGi0dqDh9ZvvzI8vvd8GbwI7Xw6vEMe4eD7R2hQd9QUXXf9X191zNeoAGDgZwDTw7WgcaU3eDACXIJjghmBWt1SDstJ/uRTjek66NVqnT7xEwzQQaI2qIhWqAmGyuOLolStHbsmms2Prv8Se5J6dntN95449Jr3lxejUdi5+hX9fLqZ56hvJ3QjyLdZVB03TQQm2NZJ24S5iZcP8/zIi+aqIEEcwOOOQdq8ydB+IO/hqfeO4I3xR6i403OPYt/AHxVCqtZKvmDlYUuu15HtBzz/mntwCbVHxuDaKLKy0pPzGqsaU9xmETbPKcpqlShBIT1q5o2dK3vLWrqDzaFVve3jzVOdW/sK2ocCUmhDf3NS1qvb1p2rAUPddf6m1t6IoGKal9paXFRW6QvXNzU0lMXqKzyBspLipY1g9dbGq2uqy2hOoccwGXkRVb7Ucw0r4NGVmCoWAnzeo6GRQNq/QfVr2pxhurKu2w+m833GHslt3lsNvWfsqd7D3mK/ARZwML40So2Q78e1h0ZaHDSAxNrOJEZSbpnMUOVAQQSM1rMCwI/Dt94Yb0OC7wwUOiyWb0el7/Q78izFtgKfF6vR68ApWqKlNwPp3AtrZWRgcUXHUWB0tC6gD+vslEaHF7a0Lj19pOv3nHHlsOf/vRfPv0EafU5mtquzff6Vw8Pro5N3PXDuz/6/btL4C34x/DZBWD+GGLGfFQMaz4iDRpAe+iBRoW5hNdYMMfzPVZQbrTqjJa/gVpBgihsUNM123q1ag7nSq7PVVBaEvB7igqKXcXlgI4uk/KGnNtT6zri2T2Kl53uU9Iknxk0+64ta3tqow3NOV0dAx05VkORR6haK/WcXlHWebLmb7HPgqb+ktTur63MLXEub/s3d77gEVxFyzucvTOry6pinwzTfRzUhl8gACN4ctqnM/UCR2pA74LQR+Sy1EgUZ91yi/fs2Z+wV/z2d1/KfaX0lVz5mxxHoy/gl/FaiM2bZRVlY67OrvRUrlOy0o/fkP77iaeVbYBiWm7nxi9HY/+Ot3zhcPhD1YryaBDNklryGthCE9jUYrSWcd1QAea1uEcvElCwvIYcS9RyG7BOK+hmEETtGi1NwYJkjyvePEEDhYVmc2Fxoc9TZHaZXW6j1Wyx5GQYnIzzfPFNLF5mN6tFE/Bala0ke8DKYkz8+Mu33f7SbbF//czu3Z/Zj/UrC8v79i5f+9nitq7ZW6enTp6cmp7e/7mDB8dGa3btwlkDS7P3v7WqshwpOeYHsZa8BDQIMEzAN2aEoJ6dQokk/46JA+hDrH2LvFRdDQj04pfwDuBZHUhhAxuhCj5NS4JnqGEgaJxnVeysBG3AANyck623GCyChm4RCopfZVZ259TSMxZJv15SUz0cCpU2jY0fGhnB/xWprIpEVtdV9C1r7e9va+1XaqyQUq+cjdbJFctFaRXLWlqxTItkhEkwwUMCmC1X4iNaLNfTTCd9YEIyUYcnMyNewaxLq2CmIoIjZ84sOXPme6xS6+IDobvuCj0QM0RkujbiFiDim8hGcza0XjOtjnZbIijYyoICG7J5S4yaTDstS4ikVV8JIh4VYn9qifQ4y3yNtd6W4YbuNQfw1jJfU91wnb0oEM7tbA5Gdl7J5i7B9XgFzJ2onTVfonZ2W7x29kq1dtZbTmtnMxeqnRXixbOqJfF+VGv1LSkP1NflNfUv7a7w+EOj7YNLC6uaq6MzRAiU+Ap9pa665oqisJbo6kujHUsKqioDQ2jeHgfbyzGDhxC0nC8iWz1blX3DnXMR/BeIr3JRpVSWaxCBbiBmmDqv2QR3EjUuVzMGHntAKSwwWsAIUuUWEEHXiTRKpgVN+KGG/FqLuGxjt4vLiDRsKF3hgrjuUytX6ypadzXiJaGbBfLj2OlrpBplzyqk1A6BVRdBi/Gkk7qVNzBtwTbxcB9GOvCuUCbO5Om+d8hIUyCikTmVuOUXkX2RvfsOkXPvnRS5Fe99RSQZeHpwiPm9aC3OBJ/4StDmuUyLpURychG6KaUoEpcoDjDNo7jQG+DTm1A9k75KWuOaDdYuExx85v/SAGeG1RyOKzkkjgz4io1xo2unxw7A65VXtY4u62MlAW3FyqbqoJc3OYrq78g1470jumUl5WadK4vB3A/8LZALoNudUm5S3fmWXpmjLTkk00a3/2m9ORYiO+x3lcIj25q8Q7Ktm5vFvwUe1SIz+Gu1oDU0NADcIKiJvm3xFb0S9+l11FPLztKZ9WazR8xkBAklZfsYlzK7NbNqfNPmz69u7Vh+XUf7NmaonnjpwL6XDuJbV42PTaweH1012xqW6wxS7JNBC74B8F/UbhUDLYS+RjvAKnlvrmSv+G1mm176rvyNRkVzT3FrAAcB6VEe6mH0b4HghSMatgY8YTkGugYa6gcC02pGBczTjBrPTaP4aQlWFG615NBIgKlYmWzFOIDNVN8kVYkrlHwstr0Cn/pU7Qsfqbn2Zk1FNIozGG2L37tg5Ypm8zZ7sScn9l/795crcO5mcBYgNxpkcLbTNeNBkiFiApcJFEMRBZWnJVncjAoyqArCYI6DKopigVjgLTFZcmjOKwnaBdWWGVBQYCbbqAar607WYGaGhgL77NF56ow8wfCh1glwGGc6rQRF0V6Gw0xct1VXFeTzvKYSi1q+J4CFzng8jzIUbQeY6Shm1BqPQihgwKKgFachDqBaXyeAOYkCE4WCtTUV5WWlcTWYqWB5WapQN3/F7r6UduQY/meSlvEHi+vLuflrC/ZvLoS/B/G0AwAG7UgVIkukgr2hG1fx9cTkCtD1o4Ru95axlHExRLqWLD5lU7OZM1nknb1QEDvrHCWVJQ5W6Tuwf3C1P1Ln73FabQ6Hzfrzmnp/o89XUF2g1vq2lgaWYJ2ilzi5npPbz+o5s2mlIZhTjnR90LrOKHBWWm3nOsvXipLrOz/u6Q3LNZ7ynMf+0TmrcdSeNmev5Yspc97smUyZ8yCb04TqpJDJmJUJck73VYnmRMrcQnxu8IHU2cW02SNUluxiGgBXOa93HXckg/ASTe24kmDYyGBwogGpz5FHtBBfEo3AgiBBIwrggOpBmLVMEhIg6RSQwNVBuTarOScrw5npjANnSF8OT5z/5fRXKpRhR2eGK89b2FS43FCQ50sh2Z2VFcbuynIj3QADEGSY2xnMZoAaInYRa7RgUzTCwiAi5HTYbey8owqePg08f1r4mAbezUnRZDJop1ICSxW2jymwFaBmqRF0pxb0xQwNKYmoWRTCPKvFmJOZsSiEdWq0qOgSwZIGY9lYXd1Y3ZFgQb4jryAZyJ2hwVBo0FjocLoKldoP+vJLVrtkpmc+aE5Yy0NUqAUfT0vPGXBqgZYg4ElRKTNSj+TqDAXlxbROyy267aCozCGr24BDHH4k9quOpdiAHxNjX1n2t991/yb2x0/eF5uiwLBy2yA5HNuL71DqKudcrH7Zjz4vOXLtmRlgV5wY8WCpkAdrBL6Hxzzu7n0yCzxzP1BX4NHulFNw8m4KhZEV045qaMYpFz4dkD8tHHu/j0u++CcFpBE0mxZ4gKdpKb232Ozz+k0ixFca6vUoG0f2tFxgUqoEHy0JCFeeuG/v1p5EgXX7DPONbIprNJHx5Yee+EqTWm3dzNczVymQpewtvwp6kGokdg4jk6P77R+47pmjijC59nkFqEFlQchvqAr8582FwQVPmSs2B/pPnexFRfep8x1kmg/kl2k+LIDmE7Bw4pLzWuSJ6TqkI0l1X/Lc52XVp8zO5ahqT67ph/nbExoE1IcOi1gQZy45u9NhNptlCGilRjIEKF2DpJDhm8npKIUcP09WHizfj96BNaA5wDzJJgoaec9/fp01Leba2dh4E1vH2RHOrtixDzIGBysFY0TZ8oCmuKiuzdy7QJt8WBtqHTxSoV4ngBvEjkghciJpLEu8bJoBBNSH8VwqzQGstoSdoYVCRqA3xyjuplE0oVsFdB8nMaKZEpfxFB2UpBEURt+aQkWYIjNF/xKIB+QzCkagBK1TwpidYQONJgiqRtNoOAjslaJ+r8ddaLOYTfBEjpsG6/ZyuaJPPbJAk6zKmQVabL1zfDzp4MLU+cTJhZHzuLsGh+PHF3B37D/jxxdiscQZiiDY22xUiNqlNlcBEQWbFaJrVuMNQRdoIV4AIyFqwUaI/Exq0XcOqHa7xZRTaCykBeC6BQrAuXQ7m1IQvjvNzM4rECeDScaWk2vFgZ9orXguKpY8uXYbl6j6ufyacQwcMq9uvAYYeH7xOBmn7PxPnJvmBdLnvhn4foGpI0wK1LkPsrnZ/hB1IKg56kHwemJBGOwUCLZxvSAQsoikw/F9WV4WAOV6WXpUWDYyWHyoS2r3eoBrnA6aLUxlGCyyY7PzQbNZ3YWu/Dy71WfzUSh1iy5TGvfMWzIhnYHmA94Z5yBegb2dwZ4vxxksitVgtgO9AKigAmwURFaCtBCI6Yn+dBB7k3TEAtD1p24FgB+yD53Ez+H/AM0kfElHeyrgRN+DKH7uuuuKj19XDK/XHcf/cvw6//Hj/uuOw6siHzcDfmXICr5eMV0bcw6YDZ833wnOjFYDETLXA9407qIlYZ20FEnBmG2QKigXuuw2V3Fhsa3AXlDKSoIY4hQE1cuI2kUXLqbo281+jtIiwNko5qUeb6Skc8Wpqz1+X6S0czD25w17tp51uTbs3vpoLkVffyjrqP/Rw499TX9N1nH/Y+cfOP1qK2nQzn7q/lOvLpv9tlY5b0rr60HWssAeg3am1cmo63Lr7Klsx2vtscSsUnLBPWmK26d/aB4qx/F5zjDDlTKNkwqvOsdBmMOKyqQAdat55egFf2LeXDY6GTu6mjaZLK/x+X6lGraUKbck+RTyvO0wrw256K6bzOngTczMmxW43EonZhu4qROn83ccgrUpxi8FjFAqUxO5rh/orEOZtLuDWtmfmWFIpvdC9f3UL4jX+PfLRI7X+ePPMP2YONujh3UEfzG+q8QjejZyWpA3SpU6L1NOpgE+qTd63DRkNVtDRVaLm25GmFnuoxx/egMWY+9uamykJ3tmyLlD3/v5rTBvVu/kI2oe9yLxkzdRNfXV8jDhcjHPjtPJQjScKHVKVNnBh6sry/MddqtXPoUYVs8jWy0uLiX7UsVFwtTGg/KzGndOj3WvzvV4csuamso2r+iqsAXC0eVljUvLfBW+xtC1pHDTdHeDs6qowGPKK/dVdFauuKKg1LZ8qb/BX1zvK6hx1RZ4a0/Pvg48IdfYv8Nq7EuoxZ9fZV8S8HNc1z+71p6y7yXq7SssLxQtXnNPpuVDAv8fws/YcHH4T1vOXwr+ZfIGgAr/RQZ/ObpaKigvC/h5TkhHQ8MOO8ibQJ44HoIw3LsgMk74kMBBpHIpjCFotMhY02Dl8rBWopjFEW+R1dAlcH+AFsy44rhfYLiH0a+lolCQ6LTlZUQQ09EXFPTpLmkwjpQoatcjrXa4V48FQbce6XRji5BDrvO41JODixHyQ0wH4bjVX1xbXVVRGigO+8MykQ2XzVrpHvLi1NaneTuXIPv6JL+ZV2j/IqN9BVD/Bsm28Pma3icrgHKlKhEgBhWF9RCMCouRWgrIoSpHQ9VLs19WOAR2RqYOjVYvizrpUdclqPOtJIN0SWWSmiNjtOEcCm3q6BmKRc4eiUinFdkGuMBphUujGw5C7PhBcZ2fUlscW0tyeu0S6DanZtuYHHI8saEACqJ6tEoaBSyFIie472UYaTNEAUwzT70TLaK9Ggxg7wxoOkNPNBphPe3JM9GroycmWW+IcdIXDkXrQvXh+mBNrtfr8fm8HrCvBSnHawJZOIG9wuyswhrMn8bfhFUjQc/f+DkSe0yzunOgydk+1bKhIDDZ1Dt2ePvqo22UArfYrZPRDVOxg9njn22KTMfahnjs5d6enooEWpYEG2vHOwdHw4eBCNtqG2662rS3tlW7r24pfn5q+t/k81Iudl7Kj85JeUqODwIoLjnPp+lZOMU38cFSfBMfNMU38U9I8bWUBITRKw5vXtOaOM/VvDolxbc68+Sea87UqYe7wlw8xQe8IZ+reoedq2K9JZSTVflOBxjVf9L5KrYTstgZqxLwBOads3pMtf//r8DHdk0Wg+8BsPTz4LtBte8yfBcZfIXogJRV6HI6wL4zMEmPbNC9KpzMoIsLAuuETzGLrnx04U9NSEazqSA/gZf2UngFFGu+GGrLZFs+D7ufyxac6koZvxcZfkXggV17XlkA2W6UqeAm2w39IgiWJBkO5TH9IljazaaSgM9LCzETuBouges8q7EYzv+WZDMWYLvU2Jwg2mfi/2Y1Hqn5zJEFc6JbGxqO0jOu9BxY4pwryD/6+2WNQZ1OGKOW1pDQMdQ6EjJHD0DYgM9oTrRZ0sVzojKD5QDdUo6pOemv5Gyp+quJp+fnS2GuAiWspNN9XV13bm6OGgFYdzlfukxebTtNGpD1NIswljqbNSWdGp9S0l06owrzb0sOKmW6pa9BK+sh998oDyhZI1U67ISW4+fR9pG0lkaHu5TD2DNJjQm9fl8VC+EDUdoqj1XtGi2JnkH+gDkQP7b4etlAQ4d4RVO7b9kDezZP7ts7NCWZdt6EW9dLA0PL+gaJxzxSlF1j9XW7lu+P/eWGB45vnb5p4OMrY1/O2jzz6MyNiT2F18DfNSI3+rZkLCokWjHXTjQCO2/G9cjubQUoAXbukvqZGg1zOWnjpgXPoimO7ULPDC76zAebAgxPntmEkCvfmWezmNxmt3r8zbDg8bf0fdTk43D/meauzjsedyThpHLKObl32Dk5O93zttusIBkf9rwctTKpZ+YsIIvp5+bOUrH8p89NLUjq3NRspM99goqzOvdFNrcDrZN0jjyblWWIZGl2gkdAEwoLgeKk7yL+xMLvTkjZOm2uXYVWWARaxS6kAtwvK4J0mP8jrhMUuC8wuL3oeSnD4yai4MhjeWCZucsR9RmZmaPsxphwrFe7MCoyby/0yOBij3ygCShnWy06bZGrwJlrs3itXpUw+sUIk8bbqRTKTePudFJ9PCnvLNPqRUYr2mN4WtagHtp2hV9P/ZVFySIVJfJ2iyAmWXVar4e6GnabipNuYZyqcJrOTcXpB0nqd76oJGtiDk2hQfwyCSs2AWSGHcMmcskVT/e4eEBuHLiX+r68ZiCh/Gktsj+tSaLcK/DXya0SS8L3ljlo80L5G+O5m4GO1yrZ+2WSpNUARYoKqZNFTNkEDJJ82hmMKO5cWHxtVq/bmm/LL/FQ8TWHE4c44klus5LZttO0NtCt9dCMo9Bb699/cAZWutbf0PxG/2jfCetNXdcbc/tXYs2xe8Td2ftavnzsXmF/9lUFx/HSvbvur8VnhTfuCcXW8vuoPZDPRb4DPoSFduFSTkZazCYOd32485FsJz3pjGQnKLjUc5Ky2/F/ZG6aEEuaew4UXNrczF1R574Io9nRtJRFC194rGEgqB5xPojxcK8MiJAOiJO+jTUnFnkblBxCVosKrLgYoajnmwTvF2X9lgZy3OUBXpPhfhEGpr7urvMK0WTJ9VLfVrOeyu+YArhuPuBuuRAIgsqZRT4zQctkqV+ba7eYVRz0C+Ewbz8/CZnYd5Lkdh4HpOXi5fOj77A9j2LJI58glXc+Lu8cKV36tLOklcxFTTlPqnir6rl0uVdKg1RnMhroeWTcQ2tKujIzFpXTeK8UWU4TbVLYsXS1Vcrjcp+UtXUNr7BOKeRNpU0KPZXOnXtX7ZXCKXi/qOyHDEv6xNlZeU1z5biRerVjvclkcEo2+CW8izh+JvkNCNKpUgMy0SA9jUzp3m0aydaleLqppJu3Zvo5F+kk55AVvN4rpBwNO5NBI0oLrcfvllMQBbSfJqchm5HaJrBXbdEwSg2JI/4+TYXgTSjRTRBcc4vRaJW7/WmS6yijSsmXwAqqXix0FdmMvrK6hgG11mvlvxybPXq1w53hN0XKV4TlQq9KclZpWEn7+rjw34kNosVadFxyZoOJyILgrhSLQsBOkFgIdC3CGl7oUTMpGAkiFpLzakpb0PFexZqomRT1kzw1MJsWeIBKmMEbYIk4N93dKl4sD5faEweihEu0CVoZJ8NGXzbLxq2Yl3+rXKbQZFWlZafcOUjudZfF7WfrWCmVqR178nLtNH3xwXtlUkdzgX6Z36D7ZKk9M5vitU5yz6B3Lg3DxAeDYYH+Qf8KKiGth9CIGr8qdDgIMORTe6TCkA9AsBO8HH9iQWpYKSispmFBUALyEd4FKPJ7+SBvGlGel08VqzS5eDnwTHxweBagzs9keNII9IZ8ulju8RoF+tDeph7aYQq8uwIGCTj7QlqnU02i06m7KKnXqbhYr1MFrEVantYrpFqk8+l7Ms2Y/08OcwHW58NPK0uLwf0SNEpPKNrTHdES2OnF20JZvawxFNWdizeGMid3t16oS9TX8swWu6nEm29buF8U+bEp1262+oamM9D/H2qyWpW9ZdpRpFvqANh1vFZkPbbAQoNzC+vNyyexWbZYbmDSSzs5xa8NcBc68+g5LJPPYzSa9dTljthZXWASke20uj+lA1d/f4K6zzyj0JfcPSYO1Mx+XCZrz6ma2XfjnbjkvXAXgHYOYtcDUrYIRknLLBM9s9itanRgBZGyAjAGO7xOFbTc7jTVRPnin4ybqPQHqNWVT7JZvD6q0d1pmtud3GJ3JK6ph2M/jZc/hjsV3dxXpzbeJWxvgPYU86IysFNmiGY1PBgrDbAGO3rNK/apBKI4XiPy09QFTGz8yCohFZ1i9aMKOgs9wbK4xb6SgK+suMxjsQS8Hl26EQZ3Il55ZLWIatKTU/qV9cSRzC9wlBRvOLD3ha1ESXg6rqtTUp2qjS6sK7AZ77n6KE1zWqamI8UbiVFuZpZaB0tPAGRnZfJC1/tXwVoXroLFiv5LKT39oapf5DLY9iR9kpQ7b5falNQyOMcOBsT7psPNJlfBZebCOQWyxfLCX5GBnJcSxjlKAwjZhpVzWwFaL+qTupO6KruLCvJ5sYvWwMkHFi7VZdmRV+jK8zq8crdl3aW6LQfYNR9BejnPgo2Xj4ZbRX/ekTy/2DK/B3N7Y0Df1KQvWUJ9Ybln3JusZ9xy9Ixks2FOH+8cx/W0tTY38Yau3icDwPAt79NDjl6eZViPDIbB3gXbyTmlpvQRDPAMZ9DPXFY7ugnJ1rhEalmyvHF5Ume6zH+oMx2XIOUHaVJ3TbhN8NuP2f1C6+X2q8M9LZX6zk59VTOgSNt3PM2NxXuGEDS/5jjRUY4kKo0z7X673c9qjJ0+u91nV3otwesniSHeA3v+HsJW2tJt9iLMRO/X+Tb4nrQ3XKGUr9OKSbXYC/aelmuyWf9pvVyXfWudWphNkJP2heNuYTX6HqlQ7gwHCkMAp/x9msPRgeMN4iJ06HiTOPIldXy5R/YXAF4T6xhMjV4P62DG4TSoQdcY1aI5gDvFZVAQ+GTcS5DRuDHJKWA1ergJfBnlZK4dU6eFdrmjWHE9yjpNJyEFnp+XrVMSWinzxvG7PjFzAsvHU32SRD9wVh9HD7thPsEXKp6suUcCT6TUCygoYo3cdpDih1vVvoMMt1rWv49l6QArIjILTXdJupLb1sQvi5qPmnraJ47V0/JccYx+p8wn91b+Njtj7Je89F4veqeXVmlMmspsVpXZQBlThIzsIMF5x6sMH8mxmpyLfXd3yXWxd8LYGSiJMp4vAnxcgI+ZcoV8v5bZZMxh02DAMoX1Agrr0QlUZJpogejOhnV5B1UOzFtBuz8+uSTQE/sbw+bNokBNoj5+PzuX5JPcSudzmA5E57L6n7M0WUrJ+0Va6T2vzL1ZrhWV94zo/raVxiFKZ0KrxQzzfcj+hLRsOHlTZpKlatI2YtapuRqG70HA10ZvgFLwtQHCavCRgnUuRVvu65rW9l0xrymYxy4oQc887L+uxmEy/rIPsFRqUPDPBQLwGrq9rzkhLEYFu02lg7gwHWSQkknRongi6dR4S7Hxar34Y0rNfz49NQ/eSK7dJnzIwv9CvEDx/4O+znCZZzC4QHl4i+mU407LqQJ1D4HzKHtUTlrn6nTk2W1W4R/aqGIQpe4C3OTrjRR7VobSdwBOmh5ynLE8VBCP4bkW8gxwigd9S624ky9FomeRVU9H6UUxmOgX1avH4Awo7o9TLraJqk/SygHlUVZEID+r15LE0/Tn+OMfZk56sUyu3ZVv9+RCeORzG020ZVJ+OQanFbxDqzsRIoFSsnFqORaQjfR8/XluHR6NbfD5YQmvDvjwaTH27NjvJ6amJjbu3oOvCX59VdBAV9EQXDH73n2nzpy5//SpM7J/y41BfOFAxaic3pWpwTrBbjZxtMEW2GTC6ci0QavnBAGtp1nGiV4R04ogKvgAdcCf7ywr9ZcHyj1FzuL8Yo/XY/F4MsBhrAsr7VCTgwPwflhLaWWxw/5iVl3Vemjm5rrItRumSOxxzeoOVmV1ezR684y6+NjfNshjDweLf/z4TVebLNObIiUtN92E3969a8eePa/vxKyWSs5R1LAzepQfIf6XbxSgO6fxk8r/0L0CLLGUerfAUqo8590vcCSe27qS9fyUc9sQ2yd3/ZQz3B+89yfTn8n9P41MgSb1AF0n7+PK9DjI6OFAHdIymR4OIAgLX4ignqGmnVpUqohJVMnLTaGLbhG6qFmlVNJMKsp1HnXeU1vnsT4RlD4X2VmEFmlpMn2sQCBVyWsWoZLFrNBJmE8nBaoUUmWqCjaJWopyJfJ9EMA/RfI5HPVGCJ/Xk5oL/RD3QjDOWfxuiK9Tj3PR+yGalDMFcl/Xd5Ab5BXgUzu7Fvu8qXnSD9PflQG4eI/Xr9Lc6eJ9Xkfi/WS8cy52p0YN+oxky7WLAk/4Yh+AWYkFVMEOLceLGTF4frvVBjlJdF24mJF+Wjj2fh+nxYzKJ5VixvkPYLmYscpb5jUmihn982hiT6yqJa2scWlJQDg+kLyEY/HF3bUxpbxxldCXvJjd6io/sV1sUAsdWa8Z1rM3iL4g5dG4N5c1wwn4gXTVQLqq1DrQFNJNfDDSTXxQ0k2kkS4jWFNZrhAv79LEi7NcKvkygHzTEmOwhmFgsKHVrYz1lnSODW/oTSNfA+W06hrKaUt7KygPllaZ7B2ty/uEOAGVvvNUfg/S+1yor6rKbwAEeIEcfgIlKxXjRM78ElKiKrrFJfmXioJZVJifT+obyuT5IshzCYVXlecSEOgFcvwp8Jal5vjfF+DFJVvN+y8u3G+o+pHdUcP6cWRRvzPLoNep3U3n3VhjVQND9coaFRLl5ppTCp0Oh8Mx1ddmfaIh5rWC/9Yutbl5jhMFtV80O/pLe/JNaxdtGV1U6MiNt43WLdo2OiUqTushfXMidz+vmzR2JcfI6nm2j7H92yJ2ykuDREEj0uQRjwR+/qk2Hz1usPCpNjSv1D5xYjAzubI+7WRbRnrvCqVOgHOwOgEPtftKoUByow0saharAAA6umjFl8l4ye3/Bc4GJBUA3JwMcloBwFQKyCodH2M+ko1GtbA2YPuFD3TwkUUNcZJ9Qglg0ohVrAYvSXTysBoUdmuHQieIpixmk/APFKIwYJLJcVEJYNIosS8pfuGUM4nt7D6wPBrtqqcSE3v9yScT6RFJIAfbrIqfTpxXZ6yeVLwl9XBk4sTiC/PqWeW+yvLZyIgUTPQzpqcjwZP+IPcV0SOpKY2UB8DViXdRJt9Qc2tyD+V33m/OkcueM7lpcjF4L4mOyfWys6LiOcbo3SjVJ3UX55GG8HIbPyVUSJmVtqFRZhZTZlaPpqZgfIRlShM4vymnS1Wcf8Tmb5KWJM8v1xQM9ybwToUgG5TvwhAoUpmC/50sNZagwKCSGkvroZ0CQ0rv6jgdNGlQqH2rDf+s/tnvC8PIB4Ph8npn016JV+IWgEFADtb/LFvQEBA52oR+vxkr7TmVqvQvKCXpz42otVm0H+8UugA6V4S1LGMj0Bu4II7hZtLbkoIRyIk35Z2nRD+ToutTVSWD80bcRi6gbLXfOu1/eRn91jP0OpEnKBtnq/3WzWm1pL9Jr42+MVELLd/h8APyJmhou2QRMeoyZkKoRsmzDPWZsJ7eWmkOVYHec2HwRtgpMu/Ikq9abR2D2pmNtsr+uiWRbj8xZBBHX2tOtWXNzjdebzd3/vz7Mv2Wgg3oZ3eBs3sJdVrlTmXl2LSypRbtjZ+kqef6rJZcu8VhdYB/ZxJ1rDuzm16zHW8iB6ZBE6yLul14KcHf46c3XtHvHr36xA23H736JNau3c7HtpDtuMdkueeG5kDX554+9/QXjt129123p/SvRWl9aj/8eyXw3oXL6InL7ilLPENeff9nyKuzq8gTyjMdxIr+hfwRgvbKp/XsWvbeJwshEjDIXXwxHqZbwTq6AUwdzP0T/2JljTDNtCN8JNyCQ6Ltk46y3Kwlfp+JtJrz8sw5hcc+wh4fhLGfi48tH7SRx4afb6AnzREbm95gADMlxpY3O5nLtTE+9gupY8/tQc+hHhgbeEyfuA+OjiOPEl1oFFdiEELhwxMMPjsKn7fpSQL9TJo6RjdQo84IYGA9slnDg/0T561WK+vamUwEe9LPn1One3AByuQm4bEADAkyZbI5b6BzMkIZGEzMfU6GIQnNBVF+cAEKpsEwtwdPyLRE+VKeAkTSbOpc0cuey7XgVIimZP6Ia/HXlB6rlEfHlUwNRgNmxqPqbs07q5qaVjX9cemqxqWrmM+zFuT+92iE9TG3s36n9KYlvJ71EhyXOx7RgwKOcp9iW9O/4/2sNjv2CvtGbOxbDmuW6Ex6ZffUtuEs1pNU+JIQ72MSb5SttshW7rRNfJZn9wNGk7qWqv1K5ZxHFbt7j94jOioN6yBeAd7l8rBWdGCdljZpwxqIqjGazjAQQY9FLQQxag3SGN2hZme5x3XUnymCIMZV4GSd5Lweo5FuKpsj3mgokdqCYIqGNC4cjFpBxXHe6NGBjE7LDRv6mpzhuk+5MMn4+28NrxnGHpYaJ/6tYCgDV66rPXJ9oKzwpdp1tTtnIksB8Vqae8M1HCafo+tGK7ps2Rmchipdeg2tBh0TwF6g67UiYW2/6XeCJ2lnZ9xvMloscqM7oYB22ZcvJfUG/BHOy1H+MYecOPRO9bW4RnuEZFbpyUz5NqKrNDds37oE1+CR0tLYuefLxmO/x9ah2ufxNbHfYCej5e2olPyNbIVYgN33QqVXr1PbwyzYPzsLZRo5wVqOrW7RVohFHRgfQbSTv83+AReWnCyNzWKu9GRJIcYbg5y9/GEfLsJFvofL7VRFo0dAWH5NrqP5R8mUSY9sCbDqNJu2PwfDqBC+BoRsHNBhMeAPiPgXdZyl8uFi7MGe4ocDDo4EsLPspB/zsff8J90+nIpDlVSuxfELzyginawH8Si7k4Oig5NRMEfcUboDogMzWhcN3E7MDAPMxWZlDGpkDGIXYhcUDBgOc78HHLan4dAZxwGHjPa6FmzX4ajdZo/ix+u4/OKHi2Ovx14vfrjSwpHtsz8Ds3nSH3sP8/6TZU4s2+Q2GPyPbA/YgBySXa8VOfl2NNVwmIxEAPsDa06vVaXf8B+fq3nuuRrbmTP8mTN4PPZpkOGx2VuwGxcB0G/I8NLBM0kmSL9RyopreDBmMJjRbXSTzNm/0i/1LsNXwO+wyx76/LsMgS9p1Y98lyGrxWeXR9mR3SjfZqijhdBptxnSq7zl+wwHV3R2Wdvq6quxs+FX7ELD5vbiisKysrHZi/g19U5D5v+QEoCjCK2QesE74SF6QnwWJsAcIqGn03kFIHhTENCkRk5PiOJQvE8BK4SjEs4A83mNepoGUEFL2ts2pt65ODQYbVF3uRsbltSoVy82t1v0s1fXimXZG0ivBUBW72D8fwDe14j4AAAAAAEAAAACAEKQ3q1VXw889QAfA+gAAAAAzg7u3AAAAADWN/0X//X/HgOnA6YAAAAIAAIAAAAAAAB42mNgZGBgkfrHw8DA/Of/1/9HmJczAEWQAaMmAJy9BrUAAAB42m2UzUtUURjGn3NuUjrkhAiTFtPIWLlIsaQkGiilGZUYmaBARPuAKRiqCbFFi1wE0crF0MeqjZsi6R+I6B+oZbWLcNEqWkYQZNrvPd4rw+DAj+fOOfd8vO/zzLjb6hMfV4b928y556r6YQ3AyeiRalG7Ft0uVV1RozDm3uowc1XeLbrHGrc1fo/uMzYGlVhPwCmYgCmYhuNwJpzBWtsjZtZ3aSxa12Xfpw4/r7o/ppJfQr3q7ie6wPdnPGcgpzbeq7uvqkcpxleYf4OejnUKPaS8+6Vuv8z+OaWjg+rxu1nXpja3wVyRM7kzWkIHYcB1KevbeT7P3mvUMAG91DupHreuvC8yntKsS23+dd95TqsazXEW477Au6yzNW6BuY/KujuceVY190Vp/549PqjDfVLarTJX1KB7oJfWT6s/3MnGYw8YuwI3YQT67V10nrtkoxznzOgudy4FH/DAP1TFHeH+w7oQxhr0uRHXZPd6zRnsq3+c0VA5WY+/5ZijeFAN/d8BMqDgid/yJAE/8lvQkwz9XVJm249WhrUY1DxpBk+Cd9Ng/d+B6Bz9Wtvyoxn82Af9ePIbNv0Q44kfrVjWTPGkGfMkeG5q9dqZ1BrOS9SyeCNoxl9Erf7eJiWflhF6cJ371MhmhXwcsIxaTpq02+WVCz2yeyZqfeFuEftET9iPDJOjW7GWQp7JVKtaxkPOrI9WT6JJzi1TrTqvrDbQa/CNtU9VcJ+l6BXZS3SUP4Yf8CLmHryDEebsNx9jvxv/h5x1Un8nNRurTTR0NZokd6x1l3gHbF+8GCJzlr9lWEmU8XG/l/lR7lVQz38X8r0TAAAAeNpjYGDQgsMghiKGB4wWjPOY2JhkmKyYIpg6mI4wvWBmYpZjNmBOYO5gPsOixBLEMoflA6sAawrrBtY7bGJsemwhbDls29iPsH/hcOCo4NjB8YSTjzOAs4Kzj3MN5zXOL1x6XDFcE7hOcQtwB3BP497GfY+HgceEJ4mng2cHzy2eN7x8vAa8frwJvNt4f/EZ8ZXx7eH7w1/Gv4L/ggCTgI5AkMA0gTOCDIIugh2Ce4RYhFyEKoRmCZ0S+iKsJBwkPE14nfAnEQOREpEdQPhAVEk0R/SZmJqYn9g6sXvibuLrxC+I/5OQkGiQWCDxQFJHMkvygOQlKSEpJ6kEqTlSe6T+SctJF0lfkUmQWSPzTFZBNkl2jxyXXJzcAnkD+TT5efL3FDQUvBRyFKYpnFKUUixS3KD4TslEaZLSE2Um5TTlWcpnVDhU/FTqVLapCqkWqV5SC1DnU5+jIaIxSVNJs0jzkJaR1iatK1rftPW0S7RP6CTozNO5o2uhe07PQq9I74I+n76P/goDEQMfgwkG7wx9DC8ZiRiFGc0zemZsYTzF+ImJjckCUyXTBNMdZmJml8x+mQuYW5hnmM8zv2fBY+FiUWKxyuKRpZJlkuUqyw9WFlYXrC2sm6wP2AjZRNissPllO83Owm6C3Qt7CfsC+z0OIg4BDjMc7jiKOQY4TnC85CTiFOZU5rTK6ZmzmHMcDpjjXOXc4bzIeY/zKxcJFyuXGpd9Ll9chVw9gDDOtQQIL7hJuQW51bhtcXvgzuOu5J7mvg8ABka2YAAAAAEAAAEpAEUABQAAAAAAAgByAIQAiwAAAaABcAAAAAB42pVTu24TQRQ9+yAkPKJQBCEXaAqEQAqLY6MgLJoI7AhkQMJWaCjYJBuzSuw1aztRUlBRUfAViA+hgvAD0PIZVJy5e73Blq0YrWb2zJ17z5k9ewfAsuPCg+MvAPjCkWEHN7jKsItFnCj28B4/Ffu452wqPoeC81HxHK47nxWfR8f5qngeTbeoeAE194Pii3joDvkvYcWbU3wZr72S4kU0vU+Kl3DN+634Ci54fxR/w1XfV/wdRb+g+ITxp4p/YMl/k+FfHgp+F48Ro8XR5zhGhB0YjpDrkGgbCbo4QipZbxk1uMXobb5LKGKV8x1FZaww2mRWxPczVh6zap+PZXrEdUouO4eilqDDeMh5R+oiZkbYlXhMDVvVQIB1jhojqUZsRY/oBWsM6vnJXrK6hYHopdSzc0q2mNnj6hE2sMWKm6hSPRLGLjMj7HGkaItKh9obqFBlFv1K7kl5pnwzduJNUe7lzpT43UXhG7INuSzTKc90rViw3elLhv3StmjtMZbQ6//9X8GYr2aCs0a9NXTXnOGvEYdn4Tyby3rR504Fd/kcyhNIR0+vCaTD21Nqt0fONcytS3dmnNl9GUgPW17rdObnOtlC5mWr0Rp7Tyb/7cnnCP/hCsSVFnf3Rzh7jNTxhN5V8ZydUJV7aTmn9cdpB71i/ZbePNuXq1LXkO8yZEtwINEHcs4ST1fmys5rec/fl5PvUmHAd0LeWNh64loq7g+4quUqDbxjJBaHeff/AkA032d42m3QV2xbVRzH8e+vdezGrbv33m06bSdO4m4ntjsIKaQNI8xb27FNnetw40to2AJatkBI8ARivQBibxDwAIi9xEaCB/Yq4gEQs+D4XBCVONI9n3P////533MPI6iNQweJ8j9DDdVnhEbKx0h81OEnwCjqCTKaMYQYyzjGM4GJTGIyU5jKNKYzg5nMYjZzmMs85rOAhSxiMUtYyjKW08AKVrKK1axhLWEi1a830kSMZlpoJc461rOBjWxiM1tI0EY7SVKk2co2trODI+jgSDrZyVEcTRe72E03x3Asx3E8PZzAiZzEyZzCqViqk18BbuUiLuZJruMr9nMVl3MDt3ObRnEZH3Ih16peQa7kei7hGT7WaG7kDn7iR37mFu7iRZ7nbvaQ4WqyvEyOF3iJ13mFV3mNr+nlLd7gTe4hzw9cw7u8zTsU+JaDXMppFNlLHyVsbqLM6fTjMIBLhTMY5BvOZIh9nMU5nM2j3Mx5nMv5XMB3fM/jGqMQf3KIv4TGapzGS5qgiZqkyfzCr/zGe5qiqZqm6ZqhmXzCp5ql2ZqjuZqn+dzLfVqghVqkxVqipfzOH3zG51qm5WrQCq3UKp7Qaq3RWoX5gi95n4/4QBFF1agmxdSsFrUqrnVarw3aqE3arC3czwM8zCM8y4M8xHMc4E4leIqn1aZ2rlBSKaW1lce0Tdu1w58v7esvRAzRgGsXw+Fw0tiaMsY9E2FPL9/m1bc1esYDiXK+bOf2BiyjP5mxnLLtzxqSGadsVQIpryjnFaVMNmfosDJuJecvGTpMsFTD15EtV3yl6uTvNGnb0Gmq7BqhnQXXzluO21ey3Eqo/N83f5fZ4Bi6zD7HsMsEBwy7TbBSo67bKdr5Ond4DnUf1t89rH+P2TxUI9hTPaqVyeTsSnDo32X11/r2ZK3anTUlW4eNVi/dM+IZ9Wz0bPKMeTZ7tnj+0yfumTBGvL6RSLC3mHedXNYaKJhQNG2MpX0p1ynXW45THizleiuB2srtD9Z0ivlCxSSz5UG7tieWbh823WaOWzX6N88BNdMAeNpj8N7BcCIoYiMjY1/kBsadHAwcDMkFGxnYnRw4GRgiPS21GdgZtMB8gTSWOBY/DjsOA3Y1VjkWdg6ocBZTElMYmxubOas2sxITWJjPyZFT8oD4AeED/Ad4HDgPsB8AmsIJlBAFSjA4oECwBDODy0YVxo7AiA0OHREbmVNcNmqAeDs4GEBcBpdI6Y3qIIFdHA0MjCwOHckhEGEQcBDIYEpgCmBzYDNi1WBWYGLn0drB+L91A0vvRiYGl82sKWwMLi4ABPo1hQAAAVoSTJgAAA==') format('woff');
+}
+@font-face {
+font-family: Fira;
+font-style: normal;
+font-weight: 400;
+font-stretch: normal;
+src: url('data:application/font-woff;charset=utf-8;base64,d09GRgABAAAAAG8AABMAAAAA8HAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAABGRlRNAAABqAAAABwAAAAcejWA/kdERUYAAAHEAAAAHgAAAB4AJwEvR1BPUwAAAeQAAAzJAAAufsATCxdHU1VCAAAOsAAAApcAAAeEea4ezk9TLzIAABFIAAAAWAAAAGC9hvmDY21hcAAAEaAAAAJeAAADfi1PSJpjdnQgAAAUAAAAAGkAAADcLSUTu2ZwZ20AABRsAAAGcAAADW04JI58Z2FzcAAAGtwAAAAIAAAACAAAABBnbHlmAAAa5AAASNAAAJR4KrBKd2hlYWQAAGO0AAAANgAAADYHFjABaGhlYQAAY+wAAAAhAAAAJAe4AuBobXR4AABkEAAAAoIAAASkXQg/nWxvY2EAAGaUAAACSgAAAlTxpRe+bWF4cAAAaOAAAAAgAAAAIAPMAc5uYW1lAABpAAAAAiAAAAUiaK+t3HBvc3QAAGsgAAADDwAABL0OjfQ0cHJlcAAAbjAAAADHAAAA5wgX+o93ZWJmAABu+AAAAAYAAAAGTKNaEgAAAAEAAAAA1e6U9QAAAADODu7mAAAAANY3/SIAAQAAAAwAAAAWAAAAAgABAAEBKAABAAQAAAACAAAAAHjaxZp5kBXFHce/82BhWY4VfMDuAgvLsaCIogiiYhSWUzQqhwcpSwOxrJQWZRGLqqRIwj8oHonGxOCxnlFykERiguIikpD1WI/VuCTZlCwxj+NVdDxeGYcUE518umfetfeFzq++0zPd/evj19/+dU+/J0dSkTbqAfWdv/CiFSpb8+11N2rK9euuu0Gzbvz6zWs1X33JoyBQjMBp922K+s1dtWCcplTNXWHuy8z94ksu4r7skou5r1i2lHuORmzNTd+6SUNuuG7dWsVtjOydFPXTEPvukGJy99FLfV4YEOO9SAVIEU+Xa5IqNZkyT9LJmqpTNE2n6jRN1+k6QzN0pmZqls7SbJ2tc3Su5ug8fUWbdItu1Wbdptt1h+7UD/RD3aW79SPdox/rJ7pXP9UW3af7scuDekgP6xE9qsf0uH6mF/Wy6vSa3tCb+osa9Ff9Xf/QO2rSP/UvHdRhJfVvva8P9JFS+kSf6qj+q2P6n0PLYwutxa7QTu3Vfn2u/U6JM96Z43zV+Yaz1tnobHV2OgecA6QiziHnPeRj4MUGOe+htT82LDYaDIudHJsemxWbRdznJj9ah3LkvayQZkOrFYn2cp9lkM5rS0Qcj+c5aH1uWkf7DnCPaSljsA/00/AgqRFBQiODlEoDT6OCRo0JfBUqTszwYBupvkpIKeN9FDlHE44JXKvrkppE10XXJ7Xe6sZ4ch3H5imxaWltF23P5umLtoe2F9WaggEjqTvMb/KafEnKGm7r8yKNUfbtGKV7GhC18SjlHEP7GNqNUW2mJpecqUhvZKhrWzUgqjtlY0tsz1PopEv3bC7HvjmOo2JzNzHc62nnU0GttoMdQYN2BbXE2nzox6I6PNg9BHaO0lnOOF1qywpL9G1O068C7D8EezrwZxB1nKChGkbcCI1UiUpVhvZojVG5xmqcKjSeuTElmgOzYf95Ol9VWqgLtVwrKOMqrdLVukartU7rtSFvVtybw/9qZoBh/hN6FrY9pxrt0vPaDUP/rFrmg5kLB3VIrj7Ux3D+KA2OOUOdYc5w2F3qlMkpmGJ5P1gTnaed150jsbjzdOxCsNF5um9l3wv6rtIaFdLjMno6GkwIdmgS75N5ngpmgJngLOJmB4/pbMJzsOi5QZPm8HxeUK0FhIvIsxgsARdiq6WEy8FKcCVWX0Xc18h3NeH1xG3i+RZwK9gMbgO3gzvAnaRvAfeB+8ED4EHwEHiY9EfAo+Ax8Dj1P0m4Ffwc/AL8EvwKbAO/Ruc34LfgKbAd7ADPgp3gOVADdoHdYC/tqwUvovsSeJm4V0AdeBW8DurBW+Bt0AD2gYPgEDgMjoD30f0AfARS2O0Twk/B0aDaiQVJ58Sg0YmDEYDZ5EwOEs4U6u2nE7DWMFAFP5lRDqx3zJw0KR4pHikeKR4pnmPmwkAVozmUPOMIK8B4sJr39YTV4HlKJ90x5Q4mt5cpaxyoAOPDctHw0PDQyK8jrRW2LV8r1Uwr2+ZvotWAVjWtS6BZrXJsMxaMI74CjAeTeJ/MfJsKZoCZoCrDKxdeufDKhVOuLqPUZWA5zysIVxJeTngFZVxFuNryy9U63tdT9neI22D5loRvSfiWhG9J+JaEb0n4loRvPnzz4ZsP33z45sM3nx41wDm/A3658MuFXy78cuGXC79cPUO9zxLuBM+BGrALPE+ZuwlfIH0P+CP4E3iRdoR88+GbC998+ObCNxe+ufDNhW8ufPPhm6u/ofMuSICDxB0i7jDhEUKXsj4EH4P/kO4xGrHAhwEJGJBghKoZoWqnFB6WYWfDrFpGpxar15JaS2otKbU2xSfFjIdPik+KTwrjhBeMh6NKWA7GgiqwCB4sBkvAUrAcrATGA1xteWlGyMP3xfF9cSzoYUEPC3pY0MOCHhb0sJ6H9Tys52E9D+t5WM7LzNBXeH4VvA7qwVvgbbAPHAJH4GK6xyfSn7jpm+LMuFpmHH3kuRSU2V1OX3Y1RXjKOH7cweM+oYGOWVEGKTZhr/GhYxdX3I0Hn8UeqiFoCrygPkgh2DZwzTqmiTwnA5+3FFZLsuLVqYC8CQN18zLlc0/mx9m7b1P9CKYtqTCNd9MuL8zXpdp8e28KGpFUfmym7lIbJoI6VvBeutpvadibvFYW97Qu+mdsFtrQPIWxydxcoUXxWE3BZvqbBMwsUorzx6OlDZmDvdj/DrXNWDRZSeKnR4b9sX0qSreUtHp2RLkjWh49JzO1F1nu+K3WscPWsQO71Zgao+jB5McjGcsQy46LXaiCWuK2Z2vLHckWlkr1Anv8Hugm7axpbNlKO6/ScyyZO0bEJDIzM4VVUq2NZVvzLz+WXVRziyTyYwxLo3mZCG62NSaaa7esKaw9v93Gu3WNaZ3zIVHrvLz56rNrDmdR6J+8KMWNemn9Vo6tU/kM6ahe2FwDkqARZprQeN5IbI46pMGwOpyR5Glkd9sQbMWOfBOQatbVeLDH5I3KrO9NLnZnVls/E1mDtnrhCBoGWD/lpz1TxkeF/WUnGWwj3fjtcMyLrYdLtpx1edxy0+21WqmWY5mJ8TOjVIxWXWjRrN/oaC6Suz7yoKbsUrte+dkeRfZvsCOWLSkesaZTPiqHG7XGEvZ5D3UYO7rWiqnQ05Nu/GEy7YPI0Yifrw+20MIao20tEg+2pz15/jzNW5vq0cnaqyDXA7TJkKJIt1Pez7bI5bssy5F0P5pC/01Mo7VnurWN4XN0T+WOQzTf3PbY2SytnO/j/Ks0b9TnROtxkU0pt0/xTI4ivoXjUTkmvahFaTl+o4NVu/m6WtSNGeb2YHZ7x2d96kmbclnRqYwLc57nRBxq2/LhWK1Ur13NW9mT1TvvmtDjlrl2RejOVdw7Y9iRrTJ1+V8ce7vb8g7ncqqFhp+X7rVrhXC8mrpndbt+NdvbtNLe0q7NUbOedc7qrezXjuXvSrtp9tKucyO79+qiXm3+CtaqfeIt6uoecxs60c7iZmxq6LhfreYo6vpMsd/8X+jVzuxKRbuqxPFcbbrmAewupFM2bf411bVvuV5rfEEb8eU2rTgvX0EmJZ5ZLxV+e7D7TOV7QuOzbC89+72cjW/sdft/lv1WMDvo1rnTXS7Qj8Zc3S+K/9R6rPOzM7gn+KhXag2/flx9WVdpL+wO63I9QvY7qz3+dHuMavLeDwc7YGCdZf6O/BXky/eXnepPsrnFwi/nzFdzU8v5G32hJdv3ap06X0nk7g5a31nZuuz4mjOinlon54whcVxHxc/uVzo6L+v6PoXd/O60jw2/lDutubWtcemMP8nuZI+T1RLZ8xB7UpHq7PiaM6Iu7ISanxF1yf+FZ2pd+R4Oz4hy+9mJHbffvfUnPCNKP3dm/c2crWxpq13tnxF1zxf1ZF2NfhGqsb01J0R7WhuDXvoqjOuMLuQubzcl3quz5doucMKcoR1Xj5fjYbaxIm7J7HrrO1qRW2NoR+wIrrU771r8hZtdbdvws81+Y8z5tSiV/UZNtzI6R3ynxe8ViexK1PlVoHtnQvaE28/apXW/m++1wt9yWtkHp5rbtbdPS4LtPSzgjB6ktryWZjifwCb1LVllvWLC+v/6tr93886WU+1y01GhU6FB0dtie1+iKs0H0oAoj7nG2vcBmocssbIoSo0R20d9o2+uIeqn/iq0uYvAQEofTGz6H1onRrXI1jCCckcShv/YCi/zry3Z/22ZOsP/bpmTxImaxL0y0p9PSW1dC8C86HlJTnw6bmGrWn3oSZ9I0teAqNehLAFDIhnG81jan5US+8+zUMw1Ckn3I5QltkfhNYHnCdYC5t+csUxdph0lFgWRRfpjj/72aYx9Dv1xua3fWG4gNjIYpIoMBtuRCGFsXplBbs/avuYjc5Gq6D7PjtaCNiw3xvJohKZmYk633+Dj4cL4ZnkLI5yGFFgxvayIYpUJR2VmUFpjKrVMs2M0GradmqnH1DAJTLQiC2mGvVciEyOcopncDSsnc58e6feLSkrr5V79bTvzTx8qc+Kyp9sVeVLYqpUKM1IApkVi/zNM+3NlYkZkZ8C4qA9pKbDvoYSsqUCrkNjCjAWyCOMqW2lRpUVWL7zM/4bTMHN/GnkMjM2nZ6C80Wrr6oeciYyP7qfZ0eqP5WKUWWi1ByHmX6LDiIvbf9WORPrDizLSR5N3AL2bivc4lfEqYWTPJ7YKOQlGLtLJzKullHaJLqVdy7QC1lyuKxntVbpGs7Vaa/QV3YRcoHXIXK1H5mkDUqWNyHxt0t2UdS9ymbZoO6X8Xn/QjXpGu7VWe/UyGnXIBr2GfFdvIN/Tm9qn79t/PG/Sfh3QZr2L3KGEDulOHVFKd+kT5EF9ilTrqD7TQ07MiekJZ6hTpied0c4YPeVMcabod/8HCOJD8wAAAHjarZXrS1RRFMV/d2acatQ0s0mGCgszK7Mye5dkqYT5YhokRCLR6kOiMRoVREH0zt7vtz0+Rn9A36MiIqIiKiIiIqIiIqMIwdZ96C0JGR8c7l733rPXOnvfe/Y+GECAo7zEV1hcGiFUtzXaQPb66NoN5DfUtjRSiU8+dHZaaODBG9ObLPwF1UXpZC0riJg2bNqyilLZcEWZbCS8QranTl1tQwuhddHaOtKbovWN5Ddv2thMoeWRJJvYvWIcfoYwlGHKIJ4EzZg+wy0LI8ggm0VilhKhhnoaaGEbu2jlJBe5wU3Lz1D2fmEcl2k3Soydxm3r2TA6bPRkOljlYKuD92z0BhwMO9jmYLuNvnIHbzn41MY4v4M5dhxxn5VXgjLbzma26J2XUQQZLTSjTBGmkaf/YT4ZjJS3z8k6ScNDKmPlM14jsdc5m+3t1jO1GTRVUydZc0FyY9Ls4tkMk0ufeAYhXam65ljfMXmAeXR9bYMcR6/3KHAYqZqZoe8ZG8flBYW5in1BH5guO03eeczTPl/SR76rEdLeN9fPZynF/VBxlcZoR9uxFLJcddc/LVdvnOq7K64SygkPQNFVTVfPcGOsVHdYNUBdV3uCutHf8VZRzepBUHdXyFC3+zf2Gtaouw3OGvY6BlOcTkoMu///FeiLmZnirJtsdfYiVlr93fSGJo0AOzTiLf9gD3/zroqJZDJJZ8lkxT1VXX+aane6qnGmKmuW6mO2IpurnTlfu2mh/v1i/aPd7GEv+9jPAQ7qTDjEYY7oLDjGcU7ohDjFac5wlnOc5wKXdDpcoY2rXOM6d7jLfR7wkEc85gnPeM4LXvGaN7zlHe/5wEc+8YWvfOM7P/jJL37TYXiUW0BXkzJysv0DynOOjgB42mNgYeJhnMDAysDC1MUUwcDA4A2hGeMYjBhtuDiYuNmYWRkYmBhYGhiY3jswLPgNVKPAAAWMBxh4fzMxC/7XZDjBIsX4BSgxGSTOxM+0EayOGwBhzw21eNqtkkdM1EEUh7+3u4JiA2lL/4MsIDawAooVAXtFURTEiBpjI6CxggexIyDGgoqa2MVeUBGRRDl41xgx8W8sJ49GEsEdx4UYEg9enGTem5L53uT3e4CV9hmM6IgU6p249jbJ1HkO4+hCH73qSRGHqEaJu3hJkIRJvCRJiqRLhmRJruRJvhRZmixvLe+sdbY3hofhYwQaoUaEEWUMNpKMHKMmPCK80vHS0dZqUep3Nc00XMyzYpMeYpdQiZNESZY0mSWZki3LZZ1s7sTE8DTsRnAHM7GDWe5iimaK+q4+qVeqSb1Qjape1ar76oKqVqdUlapUFapMlaoSVexMcDqckT9T22I/WE2n2Wr+MFvMb+ZX86PZYBa8d76vaM5qjnWLatfkPw83i4dLaf6iC5aOlfUfjPaXNu2MG+50pRsedKeH1rMXvfHESzvmjQ+++OGPnQACCdKehhBKmNY8nAj6EomDKKKJoR+x9GcAAxnEYOKIZwhDGcZwRjCSBBJJYhSjSWYMY3VHjGcCE0lhEqmkkc5kpjCVaUxnBjOZxWzdN3OZRwbzWUAmC1lEFotZQjY5LCWXZfr/+9jPQe3/UU5yjotc4BJXuMxVarjBdW5yizvc5i73eMBDanlEHY9p4CnPaNSEjaxkFWskgG2cp4B1YrCFtfrmAKd13OTSaTVbO2m3nmIdr1HPLlaQ/+d8AzslkDxK2EsVn/miu7yP+Im/eIsPT8TBc1q09GESLCESLTH6zXbxFbvOeyhjN+WUcphKjlDBcU7o82Oc4azu79c4tWWFrjqKHe0FfwFd7K3IAAB42mNgIBMkA6E3gzeTCQMDk93/b8j8/19AIv+/gMW8GLyYNgLV8APFtZn2AuWk/3/5r42QA4q8Z5IFik0Ay0LZKHrfIXQzs0D1BwChLRDe/2/F8PS/CYzP9JjRjuklowWDIlMlAOdVN/IAAAB42q1WaXcTNxTVeEsI2UhIaJmWyginNNYYSlkCGAgzcVxwFydAOwOlnYkdui/Qje77gn/Nm6Q9h37jp/U+yTYJJPS0p/7gdyVd6a16GhJakrgS1iIpG3fF6FKDCpeuhnTUpYNRfEN2roSUKSV/DYpB0WqpFbdYJBGRCNTCmnBEEPseOZpkfMOjjJZtSfealJu5unbQ2RnUWjUq1MIiZUvR8rWwqIpuJ5TUbGJqPnIlzTGaiyKZWnbSpoOY6o4kHeb1w8y81wwlrOkkkoaaYYwZyWtDjI4zOh67cRRFLqyloaBFYjkk0WAyWIHboH2M9jWSu+OixYy7ebESRe0kIqccRYpEM1yNIo+yWkJzrpTAl3zQDCmvfCooH56DGnuU0wqeyHaaX/Elr7CPrrWZ/2kgrrUoO1vEYiA7sgMF6eF8CWFZCuOmmyxHoYqKkaT5SyHWXA5GV79HeU0DQXlNZGxsCxgqXyFHyk8os3KDnBasoPysRwNasqnD8CUnViSfQPNxxJR4wZg6qNcGhkVQ82eL/Wzt0JuzN2RPccowIYDfsax1VMKZNBEWLmeBpAsje1YinypZsCp2brOdDmCXcO+7tnHTsDYOre0cyqI8XFWMZosejeg0k6lRO1nwaFSDKCWNBBd5O4DyIxrl0TJGoxh5NIZjxk1IJCLQgl4aC2LZiSWNIWgejevG5TDNtReiAzSyqm57tEs3lsLGJTvpFjE/aeYndCrGgythOj4ekJP4NFbmKkc1+ekI/43ij5xpZCJbaoYpBw/e+h3kF2pHZ4sK23rYteu8BZeHZyJ4Uof9dcxuTtU2CUyFmFSIVkDi7JrjOCZXk1qkIlO7HNK48mWNhlF8OxUKzpcx1P85MeGIMeH7nTidKJTpTtndjzDthm+TZY+mdOqwnEacWe7RaZblYzrNsXxcp3mWe3VaYOnqdIDlEzodZPmkTnewfEarXtypECPCSlbIuc4XxKPZDYvT/cWbdrG8YXGmv3jLLu7TgkbK/8G/p+DfPtgl4R/LIvxjuR/+sVTwj+UB+MeyBP9YzsA/lk/DP5YH4R9LrWXVlKmnoXYilgFyGwcmlbh6mmu1oskrk4dbeAgXoC63yaJK5hT30EcyXPb+cC+16XChxpVGh2bTvDNVC9H/2MtnN4RnO84RLY8Zy5/DaZZTe1gnLuuWtvC8mP5D8G/hrJpLjzhT7OtRxAMObG0/Lkky59ExXdlT9ej4P1FR0C3QTyBFYrokK7LOjQChvdDp1FUdnSPEG4NGi+5w3HGmdiPCc+hY07QLtByaaMnQ0iHh046gvNqpKCmrHZx5cjNNVux5lFN+jy0p5l4yvxSuZ2RWuuuZmezeyOf+OohWrcwOtYibHTx4TWPucfYBygRxW1E2SNpYzgSJCxxzf3twTwLT0PXVInKsoGGRH6fBwGjBeVsoUbaT5tA8kIw8Ci7/0Kk4kb0qGSPw37Qd9L4uFMKpXiwkZvMz3VioKsJ0ur9Eg2Z9UdVZKWex2g8hO2MjTeJyWJFVvN1sfXdSsl3dVFChhNGFjZ8JNolbVXs3W4pL/swGS4JeumL+lnjQ5V6Kz6J/VDiKi7QrCJsuXlJZjSppxdmNe3tu0+qy29y0Or/l3kftOK9prvwohb6mk+UObOMag1PbUpHQClWwIzAuc33O2MgnNKR86zoXqML1qeDm2fMX0JjwxvS2/MuSrv9fVcw+cR+rKrSqDfVSjLp21tCA58q9qCxidLJcVN24dL3ph6COEEzZa49vENzwyQodxS1/fpv5CzjO2T1Jx4AvajoB0eAo1hBuuYgHtxetFzQXNDUAX9RraGEALwE4DF7Wa46ZaQKYmSXm1ACWmcPgEnMYXGYOgyt6Hb3wPNArQI5Br+p1x86FQHYuYp7D6CrzDLrGPINeY55B11lnAPA662TwButkELNOBglzFgFWmMOgxRwGbeYwWDV2+UA3jF2M3jR2MXrL2MXobWMXo3eMXYzeNXYxes/Yxeh9xPhUP4EfmBGdBfzQwnOAH3HQzWgeo5t4a7ucWxYy52PDcbqcT7D5dP/UT83I7PjMQt7xuYVMv41zuoQvLGTClxYy4Stwq/3zvjYjQ//GQqZ/ayHTv8POLuF7C5nwg4VM+BHcM/3zfjIjQ//ZQqb/YiHTf8XOLuE3C5nwu4VMuKPXd+QyvS9av0yDq5Q90Lzde6K9vwHKO9OzAAEAAf//AA942s29B2Ac1bUwPPfO7MwWSavtK63adjWrraSVZJWxLUuyitUsS7Ily002btg0Y1yxDYGAMTEdQhK+vFQgCU6CgSSQAiSUvPDII+WFhFDy8uAlwEsgIX9A6++cOzPbtDJOef//29ZqvTsz99xzT7/nnMtRzstxpJzexfGcxFWdJlx161clYeebdadF3S9bv8pTeMud5vFjHX78VUnc9UHrVwl+HrF4LeGIxe8lhtd/8AN619wWL53gOMp1nH2Xe4ae5gxcNlcsF3CU8tMczw/1cTDYDEfIOOm3WPw+weSuaKxvjNQ57aLfF/XzkY7SwqLS0qLC5cOmLYUtpaUtZX8kz3L4zAlyH9kNz0Q4XbKdEnjUNE8IGeLgWZZcfJYNnoA/3+ws3vR1+IFbxNhfiYj3F8OLBe73wLsVcleORIkoAGCEzmYRo3GoL9es5znOMJ1togbDaJ+O8Pww319QUFBcUFxU6MnPc7ucDrvNalH/5FpMhRXEL0UcfskfZT8NEfYTkdiPDn5Ry3jh4KRjpfOEc6VzYHXR4IRzpesG+FkZe67wRBH5wYvLPw9/lr/Y9Rn40/Xii4ghruLsFgqjc2GuQa7Ld1GeFhYY9ALhRZ5yhO+F6QDc/FYOkTAO+OSm8baBYEHQjngI2kXJ4W8IhaPOSF1jQ30oXEUa6hujDRGH0yWF/D7RYXe6iuARW6aH9vc19FzQMdoxMjs7PTC4pbdxyWTjsraJ6e3fHtlmvOVmQ+/iLnlxZEle8Ux355TpjtsNy5ra6moqGjyFmzhOx60++xu+ij4B62LinFwBF+CWyO2IW9LLE76HELEb10/i6FZYOZ0g6QBsws8APazu4wRBnOFEcVzst9ms1oDfF9SbCioMJEx09khdQ73fx0gj1IBUYrPDJ/iBL1TfWEefjNXI5LmYf2RoaOTdtd09a9f2dL//6U+/s+Zja9d+jH5irjtMHzm9fcf2wrumpvoHpude3qG8v2uKA2inzr5L36CPAsRBrpZbJ+eUlRR78nNEnhh4gL3vAfvQhOwCAOkM0O9qRg/cDKCaG+b6PbIn8Q1Mb5h9rZH2pJxTVFhTVRgsCpb77KLJVUFcouTyh9WZRNlqANU7YJ1cjVJdNJxDYEV4WJR2+AoXiA6tDjR96oo1aw/s3Ccvjdatnxi9oHfp6fL31i57uq6sq7ZsUaQhUllVSy7K27vq5ODazeMd68rreqq6J8aWLh4L39/1w+WPlyytapLJyyXRcHFroLy2jtEW8BH3TcZHNjkXP5nmFB7KpSZnhcY9yDkcu7707MWkGEjOzIlfyxZITYU1F2ioiq9vp1GXeG3PYEttXYfH01FX2zJI3on99LsXli7rO3z9vdcf7ltWult5RgieUZj8jMZcoM0i3p5DpXDjoynPeJqUf2d30iMuhPvdZDu5h77K5XAROTc7y2Q06CVRJ/CUZHPdfQ/4hybO4MKMwMJ8Hd9cOikbYOAcLoea7BVEiroklxSWwtFw1BUmhtwTnpu3rRjq65u9xXO9mb56Z+tYya7osasil5SMtd4J401xB8m/k3eAokOyH/4vkDGQN7DEAsfPArqEafhIGFDEgGjKr7DBYjhAEADT+adOrbrpplWnyPRtt/Xfeiubf+TsGu4Z7giXxRXJHhNASHo55NpxFf8cGXD4EP1RlSzMxB8NMVloXba0tKClsLS0sLj0zs85FHy2ESuZIOthDd2ygwmBsYQQUBaSeBu8ZCL2n8RDrCvxcyaTAQaDtu4qsfrZwAkprElgRfoq4207ewf5FF8O44lfA5FbU0H4sI186r8GX+fdH1xp44+AQKo/+y6ZA37SwSqjzE/wOHA/Mso47bdbrUxON5ZYckssVsYMON2biTH25z+9fOmlL1/WRgqIJ/afsY8//KX7H374/i+x8TvhJQY0a+TK5BCsOq9gkBvqQxogdB08fpj2wydGzmix2HXAckELrHfEEnF4G4jjs5W/HL4hdmEvpZvlj87d2durzCsKL78BmB1cuRwGvIGYAjTSXlRYceAZgwyT/kDIYkPgCTCtV/I2aJwKFAyoIz+5/tOk1RTbcuaoXF+xpFge2z99MTm7+nt3Dax48PRAY7uvdNH27YwX3iVvw5gBrlluzHNTXvCCHBZ1FF57AcMwO5CUgqCb4XQ6AAAAmgEoxrl+f8Drh/GA3IK4UJpwryBRRcj7fQooKFUcRYS8fc2O6wZaW9Z1DZ5oMAUae3uiK5fVjV2yfi9As/b7a/ZN13Wu6Liyu7W5obUjOrx5RduEURAmES+18PI+wJjDVcplIgFl06uXqNADHAB8QHhuFgDU8AL4VrkgiPTvbbC5eNB/jgh5f3wy9ttnBs48Yhga/+xnP7uE/KwkNvz1ryu4bwY8vANrmse1yS0OQkVEAQ+45xET5DAncoAWQIVOh+wmDCWjwgeMB7iQTJ5UXMBHfgssjoMtyTtXbzva1x5dvXTgcE1ND9lhiv2lZvH4zl9uvmqyfunqno+5yNoVz7r3csy+aAR43me0UMItlpvAsODyRKoTACIiEkFHhK1wnUYWOp1G0y5nocdZ4ioJBBAeIA+mXyV1ITTVxcNHRYTBSJ4trYr2rhOWbRm58NDU5ZfdcHB4tmKokPYsb+2gt7QXnTw2fdGunce/fsNXfxr7Zn3V1ovH++8AfPWe/TN5HfAlcoVyPooM0gtr0Z0swW3Iyag7kfdfj721mphi3yafpDvnrstX9BTQVwXoPR3M0wbzLOdK5WAg30QFwDhgXtFgcCWlGqbLCsqcCtVLOB+cThR+2mEuTr6+ig+jKVHXyIHqUmiQvLHvlmO/OHz97s61dWMHO23upnDZ1u5r+2IfdPdNdTQ1U+v6dvnA6t0Xju1d3LSnZcQ7HhvJL/cUmHNqt7YsWU6+vXlxXsNQdQuuSeTsf5MPAFYrV8iF5YCNB0uI9Fpx2jzOZRMAqoBM+wOlgSACGm0n0XAc74wZSBVRTJ5I3YUfudtA67etvugjMzuuePAJkkfk5a29yxunqv23bSWjBzZuOXTLvu8910i+sWN2qL+nV6ENJjvJuyg7GfYp8im/NVmK+tOtWTpPopamSFbySU3AUkU/wPOzwIKCFVE1RHyUVE3hDzrYUCm6Ijd1NKY11OESyoMcSpLpo9wl5Jc0DPQEMp0Dmb6INARd2YQ8HPs4mQ3EvkPkS+5bd9+KUycVHExxD5AXyGPM/vbJxaqkmp2nfVRTPAg0iH/JC7FryT78eWDlxSszjWvTOXThReRyMhv7eIDIse/QMIzb+zF13HLgy28ADeRxfq5arjTnUCR9GAuUAH8Y3mtWGM8LMyAnxoV+f7m/zKIz5VUQkEf17XyKbMzhEytDdGsD9fWBaO3AYnns4JrZYENjcI+KNiJ5Q4uWlwdrisoW9dRsnpIr5dJgS+xtBYWU6zpbwZ8BuKpAi5yQc4uJXmhssPE6PaBC4sF+rAL7sZwTjESvE/RbwchVmctAUHiA/U6H+zhJYow2hiZldeJinur48fRbuLQ7JmVbTXV9XXW0Jhrw+wPBYMBnAuNZ51Ko3xqpKyKKCAr7c4jGES4LM6xDGkfwPgd8EG0I0R/l7dn+7Afv/+Sq70xt3tDUoRdyu6Ija/dtHOnr3H7vnae/9537ZqaOr+vz+rZ2h9/70dNE2P3AjmNfaAuXNV62+fA1pbHfTLxy85d+cv+9z9HI47et/qNFWT90vtpAbkmqNSXA0gncFpjMUJ8OtTeoENDbBrhAAuJBa9kb9kp+W8RG+AhP/qMh9l7D+pf3/Tr2ys4Xd3zpS/T03CBdG/sU2aDIs23w/CYmF7PBlwUKKWL6CgUEU1SU6qZBXDP1wRTJsNDvDXp9Xi9TWaA+HYAE5ZcLDNIKYgHEUU2JvvCxg/tu8Vy167KDRyoHJuqf+Wbt6Iqy7tqO8ceP/oWc3vYfTzUOVdjpaUuoq7atzyRkMVurHWRsKdCGk4vK9TnAJmYQqCBdATKUsirFCiQhPwhnzc0yigLnJE4d2KzBuqgrIcTiPhvZMLqsdnj/lZ/6zP6OiYr6tr6x7Rd0Lm4f+Oa9n3/U62+LXH3q5DWAc8TJCOAkG7wbtMUAT6r/DewyrRhL3jIvk5cEhDibM9jzwBzK9Hnypqd0caN3aLh8uRycLW2fGKv97F2Na9a2hcnUss1Rr3Hut+7mPUMjh/urwak2L+o9yOxEePktjGtCOw3+z7xrGF1bAWBRdQUSpjPxMsPZ6/BavOTfY396/XVSFDtOLqOzr/T/vh8epj73Zyye4JdLkp6rGQbMU2dPZFzPnmgBQ4D8MPbBK6/MkAvp7O/6Ys/DE5S1kZk86ZKXGQglRqKjQGqCG1ZH6AX7VeB1wmxcs+DTuRkwglAbEg5jANbcbJOk4/JIngRLpUtdpVwncpM/HLGIZOL47acPdK6rbGqbGLtkZnqg8ZjpdxdknfnKF74VLG1pvjr20kdKfjgQO9OmzpF2MNx55SLgEvQ6ZtGrHOqjitOZwJkX5gbzw/hLhHbMxF6fmSHuGbIs9ig9HXuZlKjP456O+3lgIDA/VfPzInD30+vXI3rhWt3Zy7h/Y/i1yDlEsSrAoHAQk6PCFQZDF4ayi4XuJRUzk9f35nd204G5r2zexvhbozUe7q6QS/U6Jp/BosAhgcHZoAJwvWAQDJII1/HA5I4KG0zAQCMG8tQMuTT2P0TcGXufuBl3ww/ZQ5bEnoxdp/of8PIajAE4l53KXICh1qkTsuTyIDTKCOKD/Dx2aoZ44BGfxrUG2F6C+2yoVXP1Ak9QMoBYAN1xWEjGrc3icDDi8fr5UIOfh792iUchBH/pS1NFJuGutfcIBs+a5itvF246SjZcvT7Gk7lLLo59CnBuIO9pa9gD45nRzzMCiBSDICjp1LiBw+Jg2tHrJ36nA5eQREKAXdpzNPZHIXvyMLHAK+2+4MbYAzCHMxfcBIYdZTS7H2jWyOWq8bRk2lQMNastYFXdkxKVIKVc9LPo/rtjH9z9iaPH7p6NnSQXk4kvfvPh+7746DfuI67Y67HfaWtYzmS09Vwc5rUEvF7GYfVMTDRG7SLqWAsa209+cmamf2T2xoPjM1+/8gby4onYK/KqS3bO0dM7GJ20n72TPsD8Qxe3SC7PMlG+G00IMPYP40Cou5m7w0zscb4fDGqrosXZNGx2yVXnkqriisxJHTif2RvItsn2lv0zV7M5gl/MpkWcr/YJ7UP1ZWdwruocV8Acszg70ikIYx1Bbke/Ht0ZVUKq9OD1e8GvYfIJFIENyAEXq0SqDzFFQQNre5+56OGJmQeJONu7cmb97eSt3g222L+RQOyX9PTjcvNfkR48qk/hR/pzOUWdQBQ7W7NZkpy7csWATHFn1LgdKKZE0I4n7x+/6NTaaN9WeVXH6u0b9204srqxc7yxq3VtTUd78XfWXjTZ1tPRWtvsKVkzMLR5qLW9rmZRpMBcUNPFeAl8f/DTca09shtnm1ANzJlTzDeC8wVnjrzz2Mz3yZt0/dw9dP0w3j8DtLiE0TjIKeZ+DyX7C/Bq5sw+mx99cGJRPCAUH2B0WOiSKy++5NDMqZuAZap3HL1yJ3k+FrnnHvKv8FwzrE8Lg8shWxGuBEhW5O8gMCKwZYQEhdPrX93y2pZdtBNlBcKUB7MIMpjAS8g28Gib9uoEwHOC9RTAbBYbSB+YH894nI8oHG7jgycOHhaOXH5iepdw9ey1wkVMEFXN/Rh+30fH5r5MR5BSAMYQ06vAhUaJx2hsL2GwMnuO9tusNguLRCtP5m1smP/43s6Twi1bnvzlzs8Ln9lCdpOlZ+FpscdjJ0hV7MeKjMNnezUdJwGhoBiFCSQkN7waOIMVuNwJ8MP6sDGo96X1L237nPA5wOlE7D2iJ1+MfYUMs2cWw8tL7JlMH1NeFw9vJOLxmhtvtTDIDQSDG8yFfCl2HxkzxfrJROyH5ON089ybw/3UMaTAu+zsCWLla1RvQJMY6JaNoVSaRtss7g3ogHlQThDrc8/t23cp/5mBD/6UFlei6Avo+KiNDP3Xytcv4K+0fnBUiZ2dAMBrzs/r0PkbIkC2EUJhmOcu7edNA/h9ETWT/+Z7wEYMnxY3d8oFOi0Gxx1nKL4UpgQOCWLAWXFa5Do9JGLzh6WiR0ce3Xj1VXB7c+wHb7yBN1jOXkzeO/tdgKSEPWuB+Bs+RIdIfC+WT357cpBT4DhMTHxJUhxNCkeJqeD5avqV2lUrmZxcBDLj99TD5XM+rlvudMHknWC1FUpUAPEBgqpXhwoaCEYguq1apGqyTySgZFUmLPCUFHl8BT7wCkpZTAIlhxTS3OLFJOER8WisgAtAnrQ6nH3O6JbBqSv3dUYXtw24p1Z954Wemo47yO6/FBXqZaPcO9k7MlEWrfZ0+mJFK45t24jwbgR54KJvAU84uQNK1NwCjwNTz0gwnpMN1/R4Ep9R7bPJRIidwT2pxtBhOdAiVkLs6jfM9UkLsZtzbJYcp9lpxZiYC+wJmA2TN2HJb7GxvQPJ4nysdfKJXZvWRsTh545f3hOtoG/FXhqMvXnwjqWN9LW5Nc8+MxI7u1SLRz0BeLejzZ4NkOfMt9kn02x2i5nZ7HZin2ezaxKbBJtbKrsnL9l34KK1nYuii5f0LK3oaLnpyMG7mlvLZmcfZ2uOY/8RcGjg3Nx22ZIF3GTRSzzyak42pT0Kptyw8BwFUxQBYYpSUPaoPEjQSV/Bh8zbUd3hSdlhMhIOzFaz0W1yA8AGYkDLlSCAYK1aQmFwC12W+AYF8crLD/Q2VG6YaJga1jfNbNqyh/x4y+wzw4RfsqKN5JrmCjuHbr5y/10q7G8C3qyg11vkKHIWgEEo6laO6LhZJEyVRjVvHUPBNqfD5rK7An5vrsTiBWg3u5IDN2GfFAmR38UeyDrW01o+uOGSA/u2btn9k0uM7/Gvf7G2rePWw/vvum6/68ef+xyunwNeTgAOHdxW2Uhx2RgUbHdALmSaVsI9AkZGdBpRNdqnOCNAavgVARG0df63gD7wziy55hy28wDocxCHHtGnLnIhiUiKuowg7nI6OgoXVZcHrjTunVq1apy+5VlmD4ZXdMeayFPdPZ2juBd5tgLIq5fFDl6Qc4JE1BUSSU97A0QHi50DEDdwos5gEPdwFNXYHk4PAlAvbeUMBt16cKYm+zSbaRjXm6yHCY4B0/Q9UAw3NybdLKB9dZ53y/UL3QiXU05IfkDitklgxmiDLWgrjfi8gYjRVFgRBcJaTNQIaBuJYKChAW0nLX7YqCy2Q42RYggRGfa7zuYV6y+4dueroyu6bq+Ru+T++tE9667e5qnbuGrHlH9w8fbmCxsethdU9PcMDt4t1IaHg+Gm6kiodsPQturRXCG8duXm17cvkaN7mbwFAUXepr8HmwfsglwBd02ZSu3RQp2Tmr3ntwaYAgG/KIqCBG1zJiMfm5pauv7GqeCiFS30VWPs5cG7Y0fJFTXlY8i3iMYf8gJgKYtrVSjNoQUFJxBFo32Ks+2RbagmgKO3Jn06ecZitTGj3abuaTrBzoz8MNgUCDQFbVNT9PueQKDRH5groWgenX3vbCUbzwRSqvFr6Kgpg+ZqjDWBEI1iMCkHwAP5QbYqH0w+aHM50YwCd44yeyyHxAfN84XD7qlwxxXKwC8ss5YsjZI/xSy96+r4KxUQmJxCgc8Dj6GvBxhVfT0Fo4SM9sE71d1DZw9dHeZpRm18NCLZAJU/e/7JrU/+nL5mmrOSkrffiP1CsSUmQIaY4blsf4yw2LZeUh6qqbSQsj+mCAhYI5Bb77lDwbqWKa+tS7a2LaEXmeYOlnPaugMoHq6IG5ENRQ496BGdtqXrkIhOR2aY2h/tEwWqbujmsRlI8eDcZPy7Sdnkt/mtPp8lFzen0XV2oYRPIhNRir95bGpQWrL2gvzla09MeUv9y1xTvjC8UnPPqlWrkHguqa+sDcSOkf3V5bUBLolOPUCny8/oAM/x/Wcr7rMwjQjI1baenQxSbf95Uvti8iGA0cI8JvStI8nwIVDLZhkZk8OxYwiMSsea/qFmGF/kLGq8SH10sjtms3qVeBGaCyVBZecOl4Pcf81HSW7shkMvHTh04e6DRP/0M08/fej2W44cvOMWJQa4EeSdC56PNsIGNAVApgnZzBQAGqXdyZYAmtNK9oWmKtASwM8YLhjTJn+bZAn4fVa0BFySMnnFGIjGLQHAQdvM4zs3TdRdegxMgfJnTPQ3PavQFmg1P412gKzgogJ0sYfp4qtUe8YF2iRbVcjguNJuD/tMSPlsMklL8zNAPGkaD7Q0qkKcm7qPlPI1qBkjaGmj2+h22nNzMmnpqCVsSRgYUaal+yMV10w1TW3ZdNH6qUYJtfRTg6Cl2+YKTMTYf+rY/rs6m+I0dgDmlcNNK4Bm5RgEnm3tEQIGWhb8ospHtFedi4XTDLJR1QfxoL2L/4tbRMrnk2f8PosmQRX2kFR2GDJVTRW4LW5n1RIzNc9eJK4Rh1oVus8Hvj8NMHmVOCklJWbK0WIM0PRqQQ7F5tKoEGzoAgy/cV7iRZsrupCbrES+wZH+dV1bZGX/0J6x9b1lbT0V0fqukbErxvcNRuT2imC41Gbrbls60tBeHir2+myu5V2DI8tbGtCeANh20VNgT1TJFQSjBGyZewSCMVReMRB0urj/Do6lTdmcVWUUmgNRB5oGqP1Ir7+mq7t71aqpq037C33e8Y7ASDdp7brcdKwr9mRZkOFjGsb8DYh6lANZEm61anKAMq5AdlwfN/qc6oeaubdeNfce8lmsfhbMskXY2FGQ98y2a5ie8lcM1AMjdGw4Rc2xE5HKYXJs7g9dI3ez8U0szmYGnQ++vY7EPdDRhAfKovSKB6p4z+S1h3ac2Xid8FFqnvsDPLOLfINT7TH6BDwrg08+en4+OX1i36H1wob9B6amhR1btwjrcATy1dhKGKWFfD/WSp5AFQeD/QrGYT65SRJ4ZWc0SWKCjmVKFnO0bOGIC5OzbP63haMXPPTpnTuFXRf8nzO7X3yROP+fRx/9U+y3DA8gA16GZ+bgjkUWw4MOlEF3OjJyuByLW0FGDrhy7SSq4uTlB4p3b84e6LIXf3njtcK1APhbUzuNPdmyDLAvJk8i7cNAd8AYC/jmo+fwzTEuc2vsTeI0xW4g1vfJZvJ07KqB5eTgSsZT+4iH7wTfv0luyAUDHCOeaAxQMAVEouM58Bp5MMnH1R0zXkDntJgrthRaHBYJyaahrrGNAEM50LhVNkLgtxP+H4LPQ/nlBVMzjVWhYDC0KDozVUCae71lr44u7S4Ovl1XDZq/uu7tUFH30tFXynyMFu45exf3Dh8Gu8El25nXjQt0Kdu/4S08RpmBRO8Z3cLf8MEl8HU5zKEiMQfkPU7geKCerTADICwd2FGY+DGuSglK0udAVNj96lyiDVUEYYf/O3EupAInEV2Ek6hqxEkc7/WVvQKTKArFJxEshkm8WoYpkuBy/5W8QQ6Ahuxgfn99rhn0lyQiZnvRsgOEaiYXRmVBavHcIOFysox6QLqFWFBeYVgg6MMgJvO+MSUAbBqyyddalRsqbKse1978taAwUjxVUFBXslbRoSyWw58EesnFzJEExWBClCD04EIex/gIh/ERtJzGkrKLkIJ0Yl5SdCfoirokfzgtyBP76pHD4Wvaro0He341MrJo9254KqNX3v3PGR8pWB0/hZBj/3roUCkMHydoYli7tvKKK9gefAvbI8d9xI6+B7wgFZlNTdGmVplmDMWiO/EpCJsx9TvKD4C5bVHMbatq+UoRm/+ZMtzR7VyZs408qyScxprY/vjZLSBX7od5Aw2CfQHPsmNEABYTF7uXRQI4sgE1IW6pDaFycjlyzZLI5ZP8eEAAEzHnZ1+S9pbmykj34LpNm9et7GzEwED30kq5wnjzLdknLt59c87tt+kr1QAB4ZqZ3f0oV4iwiDqgeSfBzBSJUJGgozarWcospZJttw3r+i1o/ln9PrRabXH9CO6qw++wSw4liakNFiNy/QVr9spt1V3bf/jDJtJnivU2FgwPUzqybaKqZe/etss3FgkDKyyLm/e3MVrM4VZQH93Iebggt14ukVhuZL4zSw+g2MzZGNPv9QBn9OB2O+lWVsvKhBDZpO1ZTCqLhaY6x89j58kz9vxKFhG3MWsCiAXMTUzjYxGeMDqR0bCVqX9EaNdEQ1d33UTT6kBwvGmyrqu7fqJpwu8b/9H+jo79Mt046fVONI03di1vXt00XlICXzZ2dzVMxu5ZsWxpb+/SZVpsnJbQ05wLKVxQ9B+YZETQccIWA9HpiSjpxFkUXkO4Ez8s9eN+oJIPbLPkmsD1tUXU0C9iWU0JBEvAP33xt7d+Wvj0hu9cdsMNN6y//vrryRoyHvsBaY59sW1V24kTbasUPk/ISgl3s8HxJhiYmE2iZkzD4gfYnpokSKIuaU8tYuGZJB0dJY8DO9099zN8xeeOnn2E/BJoqJyL4HONQDCRqhK3iRd5UgwLpiSf8XRTnJRIv7/KH2ZLANQbymBhSU5H+nZFo5oIFB6t8NbvGJpZWbG4p6K+pnd0RV/DzvHZFeVtvRXN1X1jPZNtl4bbLyXLwp2OsrbOocaWsqA3UJ5X0Lm4q660o3Mk2loRLAmG8wqWXLw6VBosKy9VfJUiepJswkRtzsZFmCTGvRzMg8ZkcG5GR9EE4AYx5JWbY7SZbIopLarS14acz/I/IvF3E3leb57b630Eftzwnp701njj/5Q8g3HuCvo0/T3YNV6uglvPRh5LjxNKnI5igrOauqMnLNmBbDUQQRSFcfjF8p0FcdDlJFwpcqPH6XV51UCigziMKpgkUzDR6VIT/eB9ESkJ5SqBMnJLddDX0Nm7Zt3yJfXBQGlZXW14x6lTO3aeOvVW7IOHHzp+7Ayp99VVb14zOVtaWygv7ZA/cvuuC++448Jdtzc8RAS8gs0Rc43eBD88D+YY5EblIScQhgPorwBYAHPPBQHlHlkRDz9LnCiJG7Qo9PY+vRaF3gG+Qn4w4PcVF+Z7PV6/PxA2ZLNI9IcFojFo/oTXvsQRWdk5eOGWhkXVNZ3uoZ7PPNhcWneQVMSOkKN0w/fCphZ9ZPGK1mXdBWV+d3tR7Krour7eGAbaKRflIuR/qIvlhOgfzDKAxKwBOSKFG6LFFF9dd1wd/cpXoiuvjj7wQJQEn/M/v+TH/ueUXyz/9zh5AQSRjgvKPhQMV2EwkdAxNPtRpVEygGkNnE61hVneI3lhNPYimfnljQN/X46uwC3jfk+XAo3pwcoo5ALcEKOy5XaiM5BeTELEfMTD8ABeIjwiX2+Q9FuBFXSCQTeLpjATobgAlBsM+Hxei8Xpt9lzMSaHVBVQU27tQl0joyN70I6J6X62iSspWTDkyz+99bYXbo3dd//Fl4ytvoQ0Lh3r7C1oGTvY2l5Y3Pr7W7fvuO22n266/MtXXPHlm1tte3fuJPljpauU/Y17STV9G+as7rNQxpljKDDVmSfZfIzMMT23OvY2fXv5ckX+NZGvkiuBBo3Aac3sKVUcMjRPtgoYLODGBRbr1oFUpINZJsycMTmyHMA+RmKMc7k6P+QZLaJsF38ZrKsLBiKRwNKNG5cu27CB/KF2qrZ2UVVdx+oVPWOrP7aa5blxsPbvgpVhxn3i5JRXjkgCCGJJEqc5URwW+7VKEFSwRJP0EUfEwhLfTq0+Bf8w9Y1YDx7sv+222Kf7Fb+3jrSTcfoGZ8e841zzvLzj7XHjfxsIYcw7zlbyjiOJvGM17Xhg1bpvGWL/fcmwv6A63NA2IvfTPfW7hzqi27aUF5RUl3Z1wnhB0kQmYLwA1yo35wEduUlS2rEwL+14e3xnekc87TibbYWfR9rxxJqeyabaUFN40WBQn1dcGiqKVJTJvUsHygLBRvKt5r6OispQydLWwkJPYWlVtL26qNbA61oS+2PFif1AWzjqail4rJoert0zoMbKzlZQAfymAswisBphcVxm3HvsLfDk8nx3wlFWIwal1pBSGwS+cBGvOMNMBmFKXFgCZ0DaOEX1liJXX8NU/mqL6OwNthcJprXgqf08WFbtyh0gR2IfH1ybVdQYqionEd9N6CZzawCODWwvuEQuZDtzBHflyFVIxcwg5DBmhjFXHUYHJYsSpPDSDaO7Ri87cvUVxPCMiW/94DkTeYfsGZ+8WJlfB8kCO/d2jD9hMFnL/ZzBZw8qyfrWeamlpEHN7AQcnjWDi5TLWbkmxj2LRLjRDAScoyj5eBgaaG1cDePwdBCojJnGyDwuWNRoxJGIoUTqHq6oNLRVV/c0dFQUFAUX35BnuaRHqPFWN+RFchW4lwJN59LXQOaCVSeAgcLSNAm5AGl5G9dvz6XZTswrwLR8ktu3LniqDW4ZitSv4pRcXo68C3wvgV53Yb4EZmLphA1aMHJ7fFF38OAQg2bxMppk4chIXbA+kXHN5OpdF+7efWHs6Z3T67bvmF63g1zHFIflzjvvumvT/n2zm/dfEVs1OE9XZBtBzdVUdBAgPIek/opejdri41ejtlgNWuLHS573K78A7qVnT/OzIPNEkFh5XC/DeQe4GTw4qcRCqI72GgiPpAHeN0gRUceLYxKY7+hAgackiuieiPwAy6N32JkwYaJRQVWQhIlNkS2gwZTEehV7n43tbCe3vtnY/7WPLLloWlreCG4B4tP5wctFfMncRevX15HC/L9s28apcG5W4SzmVjA423GddMSTD5rdikalAiogHjTKVtWPmk33o4BU3HaWh5YOZkYJlQLsq/PEVQrMsWVpsovngip+A1wprNVOBveGZBlWW4N5NbSaiAZdb5hI3WoK39a4VIN5GJHkjQbJOGYiBjTjDeIsZzRK05xklAaiIMcidRZLoSLrslRteV7yzpBhfc4tAqfnLdstCwlF4pq/lECzS85WkOdBR6GdBlLQnEOVdAYes0YOY6gEMIBldnQ9LNsY7bflqxnR6ISCT8YyfzUDs53X/OE/K+nQNSsXy6sPqOnQzD1+JSkXunaTmgtNLIrQ4ZUcX/4G5pubsWbEnJPN056/Ndc3itkQqfm+F3uer0nO+X2idmRAsceVMU/+o2NWk6grbcw1BY9WJ495a+2uDGNauUY5YrXkZAuUJZJR3fGUscX42Lnm+OhS2ujoyEZcUhoA5HDptW3XhJNheH140e7dixIw7GUwFHKDcn+Bh+olm5XqRIoOiKiTxK2cHrNa9WCgJ4NkUEHKzuK4PBfuMmQVZhfGgTOlL4cvUd6EyX4uMQ3O+pKlWbnO7OZQn09mb1JA/myN3Z03WWN35U2gbavAvYvB7eJ83FK5A/jQJBlBCooLAJrnRlCLC92+PJ/NkuXKdsWBzUrHZFLBRyRh8aVBvF118B5hDp/Plwzv/ynJc5eUuPNK2G9w+zSYldx1B0jNPcp2axgMdFGnFxNASxKzmyb6UsD3gBLTrtRxEtVJmac5KTs5rqgwz+2wgceqzdCYNkOKPMusWpdShwN2fNr0ovCMwkJ33vXyZhn+Jc+OSPXFxfVFTYva2hZVtrUxW/vsu/DyV5Y3Z0PLEMW+XgBHQg+6Sg+CXwtt9WEpwrRB0ijaasG4vWr9Gk0eBU4M7bm8Dr8r4mCZ+8+Uxf60ZAO4Qc+aYs82cWd/1/JarOOal0YQrL7X+t7so9OxT5BNLCfbzPLlS7mDsicbvCt3DtgkIOT5ArCrgkTkAkQnir1KaoQfyAms/T2wPDpRtyklG1bLefHIAeUq8fC5LpuUjf6QLRAIWbGUTId2j1abG/e5I0oUL9kaInsrKqXth5OS8FePLqtdeZlmIAVawUCasj10WyIrf3F7L1+ZsJiokisPMhOlF6tryeZ1PX9HzjyKkOS8+eUgMbXc+QuZtNTGOvEPjxUEcyh5rNifQVRqg7WhmNTGOskkZJPcwCSkTgQJKerE4+ccU4mj5eJKpE8QZWTSuI8pAlIb+SZFOPLq2LtUCbNcXmogkklv5BWZeK6xUdIkyxkFlKz0+S8gZJJR8h9pIkYDsi9dvACugJKJGWgAY315slMC25AlPczP1UfV+PT69V24uOqyxu8/cR73o5qD+6/D9VJWCvn/Hbi/A9aKB5vQJxcbDcySwtIzQo8nPceupNjjg9TVgGfVqIugoZ/jz2ISfCvgnwc6y0dKA+9ZElATMjMsCS6d4HLk5lvyTQbBrDOjB63AuYAYh+HuTMdrBowiTlxqPYIVLEawjXQYIicguZJyvLGGalqBxGuxlMMP6zpAlPIXTCHFEhiJFcawxcfiGDqiVMGMjCh1MLNKgcz997MSGTLFSmFIexdZhNUwo6xI5pWud9zNe7h4nUQP6G0z2GxAmSXFVBJdTiroWJ0AOGYgpgRUhJKeCFQStqYUDlhyCz35brs1F6gQiwgMGYoIwvP0dWpZwWPz1HVqocFgksLmlZoDoE2sObBjHMwOzixQ199Ue8ADtaTVHyAJp9cg0F8hRWtjnvjHxkSfLW3M2NtA9/MGvT9u1ynjnmTjunC/3+UED44IuO1IhOMZx7cjAKw8IdOkgUXSYHhEYZd0KHiick8Cjr0MDh/XIy/3lgCVuF1AJTSVQAgQSGa0WIoKPHkOm8Vn9SGEhozLMp9SUoG9ah6pzMPeY8nmHVgOCuy7GOwFXBhrqMHLNYh6XiC6BYAtKrRaAr7CcFHY7bQUWAsQYGPGNc0sFtKX+aU0GTEP6G+kiwzCbecOkO+Tn4POEL9m4Inq+6sdI7bv3duk/fva3r3Nl1/ezN6ztToE842wuIEfZ+stAjFnNGDgw2nDPYFe4HG+x2GntDtjN4QyfzCgZFSFeTQq7C4b1k/b1Q0uLacFQCki1DF8u6XokdjJ4ds99kfIz+4+5i8IDpZ1rfzE0QI/e0MmHmuZe09HHN9aTI262Btf/KZ02HFV+F8u/+Kj0iF481mQQax2A3ga7T2sp7ZagLv+xhoOBC1exxFi+ii1loNpJ22sE//QWKi14mO9ynRX6liqzaGMdRKe5ORq5Sqnw2pJcK8uw5h2mzqquMAMkX+1gU9pii51bE3tAS0o4++CZ3q4EPYzAMo3igaF8vXzxi8ssIAJ6PcWhApDoAY9Fo8KjSkTNAuQvgbd+/P0YiqYmewOVmsCa4P9mcrkkFZtkp1lgjU6j5oTti5a3cn7yrok1Z5o9gXTebWspseONKBlhMctseTSMqwtY/Zmem2ZA4NI//qJC7b1DW8+eWD9zMy6o9eRDTfFftY5dumeI/T0pTvVuPC7tJG+xdVwNyo5U0Y3obyLgBbt9Wj/EWg8t82lyaGRPiabdFixOM5SqNHH8yS+1hGWJ60KMFaakKdtW8/7DpOh4csarmZRhb+a0VfEoq5fDnXYi/iULdMqPl6gLjosG3dsGNzoL/OXtbSU7RzqawyEF9U2ljY1l7q8XldFdVOUOrbtGZa9DUWldleZv2JF9aoZX4crUudvCAabAvkVhR6/vaR26Yq5/2R0yWpJeDerJQlxA3JvhmqSUDDA8z3/KzUlNnRNFq4r+X3hj6oXri2hW+umB+JzcP1/Ngd0eRaeQ3HRt841h4a6ywfS1qGMG5NHykpB9PPivKnolOIekWeuUtpMpJSZhEOJuejPfz3Qk1p4OpcfKgdRV3qOGd2K6TiV8TlxbE513Ouyt7aGGvRlpVSU5k1LZNPqeyAPGCuS2DuW9DOcXj/RZyKiaJjhDAbWeUSdrTFptipP1nIGuJQ3MF8u7RkL3ChXYwmDyGof0u/NeAfwryfgL/BUL6osDwf9dYG6BJqzzhPNvniMWMnuWhjf94OdlZ/XHOwHMwt+h86B+OGayvyJmsq8SbC1lBqxvzDcV3Et3N2ya4E6MQVxldqcs/QmXhSlGfCLpZEFcVYOX7MreelD0SUX11Qjvhrrq1tqWspL/VWBqgTGss8bY/N1HLw/B+asaSkb58Dcyrj2U38ze1Wh31aGw0qu8Zw4dAIOa0ARSqJBSiBEr2e964YWxGNV/BaR0/Oi/kNx6SrwNNTXVCPlJXBoOj8cWjOFBxfG39JCd15BQZ77OiVUeA70fa2+qKi+qKmyra1yEQscMt7nbdSDHjbw/rf6HggBguxeInIlRCeGLVnYmQ18fgE07/yP9QLqYLylAiwCAzgJW8H6JtREZrONVBSVQq3Jviw9RTxhvvM45oo1nPNqLn5tXxbR6+P3AT9XV4WCtTVVddV1FWXBRaFFgFWf32v35qDTr5CaFC8/WwDHISU5hZWk/Uvj7JbdNF6Xtq9tyRWrpq/ct7xJQfCBG0frc+Q7yZewUo08ufq6/S431qutWTPRB7htrGG4nV605IJN5M7PfY7VHppZ7WEI459ZhBJnNuUpmCt8PlChHxDo+/D45+T5xT8n58c//f758U8t/Jkp+tlZUSlNzcQLGj/a3FLZMZKyObzWfMNFWoVjRUe9blHyXjGv1AyCPsSaQQ8ny22JqkFPfh6o8n9O7SALjWasHyRgeqTVEP4IzY04bK7/bdjYvlNG2H4EJkUabHejGZGGtyKMDxQV5ueBHaGBiFEkNB1UCKUFICzwJGDUfwj+0F7ICOZliqmQBukHinkA8lWpC/0Lg9XPVXM3ysYEJjW1pAKaqpaMGcFOV0vqrZkvBrUUDOS57baKskB1sLq40O3P8ycmnX2uSS+kizJi4ddpaigNHQ9mUD3gF9ngNQbrmB63Hc0Y931kamo50Cs1n2IkqsQ40Z05j/uRzOD+q4CmqHmGkRFHz4J3QGphfFGJ+2IWkEDZDjLlMNo1qrVesNkw7qvajVibeEJZ9aGpKfojttRzN2BpIsefxeL4KlhvE+ObMWWF8yQqYiOmGczNHMF6mUTNrYvHuCx8rcO9+cQ3oAazswiHDXeVWLyk40zEhBW3C9kJCJk/bSVWAYjXpKN/7gqAVqlZ/oDXA5ylGKV2Y3Jfrwe7iqIXaCDa3sjWpFhVoDRQzfKIwlHsq6uEZZI6/LngY1t9OL5p1PiCvLJyiX0y2tXYtnrlka3rD+0dXRPh8yaP8JHJ+uWdLR191FYy4sjpshf0Vne0PnHq0B1XXbLzujZy+fLYF30lA6tXrZ7azml1l+RtwGMuV8K9IVuKi6hecjkpiHUsFuTVIqEwhzwEJvEEaxjGDOPVfRkqCBVDvCLz5RlrC1UDvIzTG9R95fi9C9wA0MT3orV7MpctgsVtt1owvO2wWUqsJayK0ZipijGaZlgnVTVuTzekU6scH4obz5r+oWZG/xbOgXFmMEExd+BvrHtE9ZJW+7gOfdrkAkjqTugVGNP1D47J3NHUMW9FFzR5SPJbhc9T5+nGuLbbZbcJlEXGqHA849gOHFxp8jNvcFUfpI7/O9VnTJl1l6oHNBg4Fpvzcl+Xs3LQthF1rG5GocTyRPmyniR6bKq9oSdRbDBiG5c0QizleLhSxIzlROVzxuvlUKIqR7sl04VAhS7ClRTl54GasGQZDRJIRDMxG1gFZird2eaTwmQa/elTUESv0+gvdji1OFZQa28VuVnElXG7lBn6DVSfLDkzT84L37ILRbLQvGQPStPSkM9bVOjJS5aoxnNI1PlT/FaafBVTZzhP1MaOJs+U56a4ReQF2sn6hNswXwezDYigS00zG1ddI8oP2uCPtgXd4OVY2rKIbTXZb7WvZKyspUz7R6wDsfeU3poP4q9SlQcOAX5vBJ4rADukRY7qCeVKivMwR9EGZM/3Yg1Xj9VCSbcWo1XaG6gRvWBFmU8tgtCi8Y5EjD6qRO11Sgy/+dBuZ16oryzaeujCAhu8aWrd1HCpPQtQVX+JOfdaIh26XXeF81DJkbGDd+gOOg+XHBk/Vkkuo09dWRm7gUdZz2pAgWdxB6xfzlbLQHEjjOv55xaDovxKLggldczKSK4KpbmKyRGHy/X/Alwo45LhOsyMl2SwyEso4ZJx5eIm5Ry2a8fpGGg03sFdx+mOZ4LMk/xNOniywcEAVJp7pwOoyMFkGJ9UhGAa9tpVKYh0qNT2/oXtjpVyn0it7y0xSgZepxNn9EQUR/oygKtIhUDG69KA98g++JpdCRp46wIznJTd6vZbaVGpsv3GZmzKuCQLiIlkFEylF9GkLtl780xhqtTZAk3lgJcAEkGptLVacsGa/ZvqbZkzlVZz+zyjmrS62xmFbpR+BErPola5GQYE0ZPF2hWBd8L1ZINA6hZIJmlgzrFbWa+BgA7gcCndQpROAw4bthnARicbp1jXofG6Iz3R8hXHf8I/bFK7DrX+ld6NnQaefgZpQqkz/gvMKx98/+2yKanWWN2GMOj0PPrr6G2O9EnJCPHIefApu4AI/NaU70DsF3hywTL3lXhCBSGn3Zyfm6/gzzgffwv6PGk4/eO8JU7D777M/o541kz309OA7XyuXV6cTXiSAyBjASMhKzDNjojcFpa1KmxiCWeSTss1y3PDbYBui8Wix/6MakacFppQT1QwkeRWsWvkQH5eZUP78tqKF+JNYxtXNJgbna2RwPK8RP9Y7Ldlpl7q4cq5OozMh0ElhQgvLHJRUXIIlIrYjSkbPVcsk5DA+WR9nzmySauWmOxDbtRcz8qKmqqKuso6DN35ywyovljwDk94SIb4w7txlfrloDuvsr59eWO1L6tpFoN4WozpOy+sqJHvVKN2jqUFytRC3W5bqRLBU6NMSpcuTu0hWcqfYGvQJrekdaUFZwuN0X+kNy2PpmmG/rSWgker03vU0nvV3AvFF3sCZIAdLFSAK62izu1yJsH1d/TfYgbzvB5cARAOqX24aCUzmjU8nQQ8FWKeThqeCgFRrNgZzec4tnQpUBV4EvgSz4EvtQA6A8qiShF2Otb4XqUYOwlvbsCbB+FMw5sHEJcO52QanPl5CfyJC+FPg3IeColSqZ2GxZ8q5dpqX+YRwGM2s7tAuvtLiovideKZOhLnYUtixfPI2JJYhWTBzsSxdQraFupQTH6toE/xSb7E17IeLwHuiGz152Tzoi7Rd01zqUvARhDBz56VWM2ZPkPrtUDGS+a1YMvDelSft8CT2obNcK42bKr1zRq8Z2rJdspX47XUNRS4Mjdn+7WrpMTl9m2/zPr/57y4ZtZPFHvflXCPKL3v8tS2OmCTC6ptGRCxe+A0brcP9RkYpo3aYkiAdFaLDUaSC53DBa+Fq/AGFuoY16NzCBeJuFHBz57rQjCWCnH9CvKVM6CwF5yxxFSirKEpfQ1ZGaBLaUKdoaXe5z43NTiIa7h1Y3Jbvcu7Rk09XXP3dQ5h1x713BUz9cGa5eOZSqAxRTMr+wd1w0pw1SQKTifoNmFrlmmAmyVUxOsTHUxvKvWJWh5rmuZMaru9RtM3tRWxHykduN/sS1abp9l6mVm/vxIuCH7ACozp2kUqkCxCBWXPh5MAdgkdOvTjNqFyVPVkEkf4vAG/N+gLBoL+oDcX1aQWkE0GL7pgP8CyG0HHuytAx28sL9mwL7kzYOvMKgXk/mbzHQcwFOv4N+wRmJqbjNUbsIyC2PPhmcmOzJnJWguN5PTfJ9T+GWrWr9o+I1PsPhENL/Lk5zE4ziN2X1hwfrF7TW5njFr/UZHdacFq0qX12mA90vnjXB6s8Tp57fwu6X5fUaEg9XCSAUhRicZn6pquV7qme/IJ5y3OD3qCqd3Tjefsns77lPPLoq4ckrmT+tElK6U2+/Jue5s0mKGrOj07FMnu7c2ODCH+Wc9FPpv1XFxGBNkRIDqj1nmR710ity4WTGrzRTlz80U8J840w5lMML3z6sO4ZIF2in/Dg+SOD2nJmPlZKd0Znc1NHW1Ny5qXJXVpzP4HujRGk1bmvDo2RuRBqc29pNPdJg2fV/fGj49Fs1etym5cregIzDD9OUwdY0d4/kq8sC+ep4ahIq37WKNazfb0+vXmAHY0pKfvbcQmhkqPLXh9hJrjffHn75k8MjXF9jQoO3fqNbCZdaCdiuUCA+qlnnP3n0dzU+lBHzvEEuPmPk0/ruXDWbHPIX8Pl8XlYoctpdMhKBO9pPuwZodoXccbHn4DnpzU9JB+jw1A1T75Xwd4LazjJRGwBhc3AHiSBrXDpp6WoMDNJ5saCvxf0awLNofyhDFBWb/GWbCfssB+KpNDLj22wsbZUO1owtmk2ThsIeXAmuT52JIGjM/LqA2ZPLlvJJkx8TmeZueMYa96gUP1vTV9Vfz+lPlRRsBI0OrsSgKFBYFAQSFOjtRq5KHObRvrRcnO4ol3o+R7ksgu3vXNn2Fq1vhY8YkdVUdLmhdZmqBJB+u7gbXkIdmPp9vh2XZ6qhRQpy6bQyM2KYzhGRDyDi95NXaqKbRu5p7wD4iHSL7WFrI69p+bFh98m/Uye5eUw3zs+GyJqEE71s5WJEauJ+UQI9aVQkpo4DaMEcKsoqR8p9dmZtOpDY1PdZHPL/truYiz+UZRSwPZYoo9VZFc56Dk/QZkr3oKAqb/wsfncxYCFhmlFi7EnkVOSqlVaIv7j8remBKX3KgYi9lqD02lesCT8n+q9Z3+Z7XWxNhT0kZUPu7GpG4+fVzZjonjRslTrpBLVdw4ATmar5aKIUSRcihFGooU5Z6GpZOq6ZGCqHj/LgVP8VipihIX4ETQ9cRjpQSrWOfjxaPUt2ZGjmxwMPSwWGk6elQ7JAlDXWqLr1QkkeWq55ioJXhcrQNxIx+C4Q2gin9zAUo4WpyhIOT1lqGV7U2TA/MKBM54Hgh+ofCBUi6xN8N3sX32HLCGAA7ca6dEXHjjrkzdJGbD8vO2Ub6njhxK3T45oI4799+p+0Ogg86+y2+ij4Lm83GvK+vkxUgZ2GKzGNrVzxgIbtyCOUnEGYkwwx/sDw9rIp1yIdvgxbeGaTAVhpRbmKvA3ibtsRWyRE24WbfgzWBnqPdySbfKtdpdXPwmQNK57sEN4BwwSbwWq8VqDfiwVw1JnE8FnpPTBSa3KIHNnQhPeKlxfGx046aRNSOkK/Z8h/7JJ3WdpDPWH6w8+MlPHVgUJl8kEzcfv+ZjN37kKPmXvjv6PjnYl/XIvZ//dpZii/Njao/9MHbZtxODaNTReBaNAZjFwM0a9VQUhRn0JDH9Fu1wZFAwxAP+UNAfDoR9QR/mkuXiwVvBeTlkSpNgWPmg2qXCxkzz0bhNfryh+eCFBw7uOhKNXLZld2zs2o985Nqfxhuc79iBZLBrF5jn+qeeforcjF6MFltZATI2i3FHrVylnGaCwTKWn/R3nWmCFsb8c01+gZVT6WebkKNK3QXrKavG77cotGnWusqCitELKH2tyY1lMbgfF8H/hPayCHRqi9kaFvdX28ySZlX2ajg7yXDmwcpUBWcsUJbwvTJjzqGgjvl/mVCnhqbmYy/2RzUklY5B6tXkcgRweATkcg5YAXsVvNgAY4KGMQegDLSDh31K0z5VEelUytTmYzNfCQBmROlDLsQpqpd0nGoiOxmtGxSpncDsa3F5TZVzboAe/cBNrHpOPekmHAqmRJX/vvNu0KQ+55k3se8CkZ7r4BsSU+iV9RsGesXuZiwGntJxOBjwJxUb/qN9hzHwvHDvYQpUeo7+w7RGpVs8Q8jMzhBq4PbKDrdLEgGzZYQT6ojI1RKdKCyQFZqM9HNkhWa6jGWFFvjLg4ms0NA5l0hthZKUIhqtqJQODLMFa1+9fVN8wdrXVsttRbu3pFTKTxgG2cpFPSVT2spV1rOVq1l9oZScPIr9bc2sZ3QdxsScYI+7JBDZoaDIc6Sa6LgqIuh0rM2RkleGTYTi05zk++uwMKcsaMWOw6lTq6KZFjNtYjaY2GxnRB6Bpb1raPeq9d1lLT0VDfXdw2Ob+lNyYCf0rS0NFcFQqLQHVjjSXhoqLoEV7urqGZKqkvNhNf45CfxTjie+x/mnHBho/m5DEhcVIRshC58HG6kBoXNz0icUeXUuZqKfVGNaGj+5gZ9Klb2SFH4qBYZi0CeV0E4mup8zrgqHEnwlnhdfqdJpYdYqUiTVubjrF0myi52HxXq65KB9lwPul7ZLMe90LEf8iEH1eCwtAqickhW7RrXAldOyfhXHE/YSPwr+MvaObJYbS7JMvCRiT3FW1StRUZpdoK24w6Y0FscIbubG4imee1qTcZfmT6d3G09xqrX6RewDgqesXqDmGmA3S0FiuX5MMkz0zS9l9Mi++GUgVoggZqh3nMSmzz5vYUGey25VSx0NGUodQxlKGOJ1jj9I7W2SXuZ4OrW9iZpvwbfC+uZzgfR8i0C8L4vauWUoc86Fk+WaLXTtvLyLUHK7F04nLZx7kWW3+QMs38LAesam5VtkKuZIzrW4MbV6Iy3tZCq1YkNb38eZT+7CnoMupwOcTvHvKchV3CltVX6sujPpy9Gd5Ecpa/F78KMUb25QzlUXQ3Xq/hcSiBiUyRg7ogGampXyuxQ4lbrYXWD+4yngHXKrVhk7L89Cizu6nCYjxykngFvMRofJodTLGlPqZRfoGxIvoY39fn4Rb1I9bYZGF1o/cKWGF/sEx/txYxUv33OeZ7yxji5pLcBfwmiL1v87Xsur9P92fdh4H9K3no2X2vL7Dxgx0fp9z8RjJcr8DuOZpFxErknqkK+1d8s0Q5sNx0QfJzHHkBoPTpvnKSU2rE303qQYoDJXA+sxPCMbE2MrkrFYy/xQyg7nTdsjF6YDmfL9pGzw+9Pg9DM4tRhlCob2qsHDOJJ+poCa2hO+ESsrM/Zkz4QnpSG76e9vCJ+EJ/f5jT96rvH/5obw6nl6x8h2vgR0aD7rC2hmlQzs+NpLbURtMatm6z15RKni/+mqRRddtIhTe0nvAZA7QWrncuXsCcVar1mOtZpVgzwcxWxUn9YfU5POPqdKWWtBFBcW1Cmqib7LxK9pTVvbmjYNzpvIBTyOop4dYM45r7MDsk1GvQAmCsnVJbpXJ3XuiLrE90qWsAYdwX6vnJ2f1xSkN9XY3ZhsnD+hjH32HZpL/wclr+zAtOseqzmHZzhaxvVbiNFREbVFqkBeFhEwE/GE1bCfLzoTcK7ozbl4T35hQU1N0fr6FV7hdona5aVZ3ZYdO6/Ycdd4kXfJf52OhbQ9/A3go9jAfojK9Qa9ekY7GAacblbbv4z2xUummvh+hx2Ef54jL+D3WSUDptdGvfFzEdRgma4u6i0izTz5njA9uWkwsvGa62689cqjNxH7v+TE7tRNkH6358qLl7eOfeVL933v9Ow7R9Ueqoney1xaj+W//7sS+O718+jn/Dqe85a4h/75w++hf54rpz9V74mSd7nH6fuciat/0Mg2HxShY9K4ZwStrtzE02bwrsHJrzus+DybYi90kIjkfDjUGMxd1uxz0Uh+MJjv9p28U/GhmmGM78MYWTCGiShmkTKG6lpMEDZGvPuscooDjME2pmyqLmM2Z2c43xOysFG+haM4gjgK1jRu5r7P7VDO9DJp522mPE95WjTz0yoTD2O8CnghVzC8uLnWMy4jTaAmG00EMs0y5RE5NqUh/JjSEB4tDcDPGUfQkThrTcWQS63fSUXXGQBiHuKKk1GINA/wHGQ4zAN43CaaQGN2fGAFkTb8DmYeBxNxifAk8sq1+S+AjDOZkFychCHkwc1kP8N3Hu67qABlGFkbN3oe4z4Yx0Rl6rB5Xo2W+rlfkE7yPNi7Go2PJ6jSxmi8UTlmzj63vbt7e/cvurd3dW9n9lYHyI0XuSNwr4XzsL7BeIAcmWEtW9iGlN8P9iFoyYCa9h+Itz5OvCPdrEdp7DmtGfIb6ptCVgxQlvSK/MVFSCHr9yt+DbSF1hde7Qiv9YJX5EjytWK8N5DWEFhtBaycY0XdIP98mEFqIDzFo0/ziV7yEIMeW+YTHWHdf7NMVDQSSQ8OX5I/r9ez7gfjBjS+feAplRQV+DDjxA+vuFFva/BHI+1EdYglcP3Q/WOHxziQgMP+6MUT5iHnteunllfWt12b/wfzGz81P5410D3c2jGy7UrrtJlUr2nbe7Rqie/etjXtU6vq1gaOHWhnPeRIOV/DerQUY3VEgVUPigp4FV44PTksYVuUY6A32Mm++BvMeYr6acAFnik2yss1iIVxj9jlV6hIPcPJH8ZUAj/vJxdcMXCEDO+Cx+l7crdNCsM7zX0GQoXVy+hFsUdIt9xfYgtY/p1cA3avIXbFv1sCtpLYW8o6XMZZeDM9qnjoEhOKoGNID6qz7nS5WpFLRZSrkrOYSAbikkTJ5eXNc38hztITy2KvE/eyE6VOQvXEy1sq7mgmTaSp+Y4KC6+M9VFAyvv0UxiPla0YDdBLvMS2SS+1ENGBiXCWsGgmYQORwqEweXsNb635WJQ0k+bo7WE7tcy9TS0kr/LqNpIf+23biZA7fQ5gPRsSZxyajKlzYOJqgGB7mRySw4t2piKiWDBsAOprjNJDc38B4F1VVy8j7tjrbDLeId4S+Vhz7KnYUzgVNo+zv4J5HIDxgK+yYBaijkhcN0rGS5VUeorPtrgaO4jLQKIupytqIW/z1rLbo7EfxH4Qvb3MytMDc/9D8gPXt8X+i+S1XR/IJzQXaKYScCSwPXgTPt2k17Fu1+ykKYLJnZdanbgIwYiN9+MZ2NjC1Clcd51w3Xe3P/TQ9oe6iYVYY2/FvgDqdjL2BYQXhWo2zQbCsmAHHcJh2PpSC1tMi9fipdlz7+CPtl/+O/oW+LLTstFMRF0uEcTEWa9qvtlIH8phYVpip+7RpL1MThR04tYM307KJhtmDqg5c15G1OrBrpH4ca9e8ru1z06tWrVmamB5SX1LYykJkafY8a7Lu1YF5LxQaZey5g6QC8sBTi/3sLo7UlhAiSQRdiCCnu/1pHwiwCdqRN+nbZClnVer1zPrMKkpSmiBK1kiEV6uBWownkOoNP+I2+TLMDQRYAiwBXwYmtCCTvMPusViKIwK0CpXIFzdWtPSWH6F6UJAy9rpxsUTPnP3EmtLCy23ADa6NeTYLHOH8RiX/wvVxXIyAAEAAAACAEK32OrzXw889QAfA+gAAAAAzg7u5gAAAADWN/0i/+X/DwO2A8MAAAAIAAIAAAAAAAB42mNgZGBgkfrHw8DA/Of/0//rmLcxAEWQAaMmAJqcBp4AAAB42m2UzUvUURiFz70XI5HMEpmaZBxHtNIEc0wbIsWP/EpDUmoozbBFGEEQBK2iIKRaCRHUKpdtIwKXQYv+hiKKFi0iCKFgFgXT815nxMyBh/Ob9/7u13vOjLuuRvFxk1C5QZ97p7zvUAO0hfs6Fyo162qVd6d0CFrcqvYxNsu7WfdEJ22O36lFal0wBD3QAkchB90wbutBNu7BXJ6nbR1T91ut4Y+G/aB2+JusdUK9fhmt16JbQ+/w/QXPndClCn8WLWgx1FN/yfgqOl7SebRRB3yFavyK5v2Ydode7fdtzGuBSjVwj0E7M5pFU7DHHUYzavdTWnAfOfcMZJRzU6rz1fRjknpCp12iWPCB54zy4bIWrO5HeZd5NsfdZeyDku4G84Y1536oyr9Xnfss776riv4l2TfpHmsFbeX+I/FMVi95UOqN9a4aauzd2Kd7SoW0zvu8rvqDsc+z5oFf0iA+pvh+PNaW1QnN8U4TnOuTLsS+NylFfYD5V2x+eKqBEs140B/7vw0hWfwVPalf96QMfjStU/wJBTxLbPixlQ5di2qebMY8OcOcac5p/d+GMKr26EnmX/CjFhJ48hW++W7qZT+2YlkzxZPNmCfRc1O7r+3JXeN+ZbUsXoya8JdQu39mk1o+yQi9yHOeObI5RD72WkbdCLVCzFreO3LQyT7WIztnWa0vnC0801B4xHpk2HJU0qzl2TL1n5LxmDPro92nrOWck6mt6h6QgTQskY0aeE4fv0jhLdkraz9/DGuwUuI2vIFjjNlvvgS/m3RIKK2ieiBnuNfqgZx7BcuaCEn12Vw3Qz3Pe6yLF0n+W5rgFjwsK/UjfhfjY9xpRnV/ARjXu4kAAHjaY2Bg0ILDEIYShlOMCow1jD+YBJiMmIKYupg2Md1i+sIsxKzCHMRcx7yDhYvFhqWF5QrLD1Y/1kmsh1j/sImwWbAFsM1hN2BPYF/F/opDjSOIo4LjCMcbTiZOBc4gzjzOZZyXuJi4TLhKuNZx/eCW4HbhTuKexn2E+x2PDI8dTwBPEc8Mnm08J3gVeFt4D/Ep8KXw7eLP45/Hf01ATMBJIEvgkCCToJFgh+AXITuhHqFjwmzCOsIJwl3Ce4RfiBiJeIlMEbkiKiIaAoQ9opfEpMTaxE6IfRGPEJ8iwSaRJdElsUbimKSapIdkh+QuyU9SblIRUnOkTki9kFaRdpFukF4g/UUmQOaWrJJsjOw02RtyJnJ9cv/kneT3yH9S0FBIU9incE/hn6KaYobiFiUeJTelJqVjyirKDcpzlL+p6KgkqSxS+aWqp5qi+k4tQG2Tuoz6LY0aTSnNQ1pWWh1a17R1tHdp39L+paOiU6VzSbdKd4vuOz0DvQP6JvoF+icMRAziDLYY2hlWGe4zMjJqMPpi7GDcYXzHRMekyuSLqYPpOTMJszKzLeZc5iUWQRYVFn0W2yyeWUpZRlh2WB6y/GClYZVgtc3qi7WXdZ/1BZsqm1u2crYltgfslOzK7C7YR9gfcpBzaHDY5MjkmOP4ycnIqc3pjrOIs49zl/M9FzmXOJc6l00uH1yVXLNwwArXNtcprutcT7j+ctNxC3Gb4/bEXcHdzr0CCPvcF7kv8mDwCPLo8Nji8cZTytPFM8pznZcNAOtBuscAAAABAAABKQBEAAUAAAAAAAIAcgCEAIsAAAGgAQQAAAAAeNqVU01PE1EUPfOhQNTGREIIC/NWBhMcS2skNMSEYEtMUBPb4MaFA0zrBNop0xYCK3+ES9f8AteuFf0B+hf8Ca48785tY5tO0Ezee+edd++59925D8Ad/IIHx58DcMGRYQeL3GXYRQGfFXtI8V2xj2XnieJrWHKaiq9j3nmveAYd54PiWTRcV/Ecau6u4hvYcD8qvokV94fiW3jj+YoLaHhvFX/BgvdJ8VcUvUvFl+R/K/6Ggn87wz89LPl38RQxWhx9jnNEOIDhCLkPifaRoIsz3s5avSNrsEz2PtcSiljl/EBRGStkG7SKuD6n5zm9jvhZpS3uU2rZOZRoCTrkQ84H4hfRMkJT+JgxrFcdATY5amRSZaxHj+glfV7Ro4WBxEgZw84pFWJaTEaMsI09etxDlREjUenSMsIhR4q2KHcYbxsV6ufFrIzuXs61MROZ7UqE3ujWJd6pKBpDhaG/9c5XjQXbk75Y2Hu0JcIhuYTV+98/EExUzUypm9HKGdbOXFE9I/X7F82rtWy/9XlSwUN+p/IF0qP5PoH0bDvHd38sr6HtjvRbppm9gIF0pdW1lc7quUm1kHbZbtzHdv70fzw9j/AvrUCq0uLp0Zhmj8wOnrF2VbxgJ1TlpVnN1zzd05diX+SqsHXJ2tA2wYmw65JFibHL3FXwCI9HvbsmeTWZxYBrwkxiUetK34aMPuCojWLUcUwmlurxpf4BkmfP1HjabdBXbFtVHMfx76917Matu/febTptJ07ibie2OwgppA0jzFvbsU2d63DjS2jYAlq2QEjwBGK9AGJvEPAAiL3ERoIH9iriARCz4PhcEJU40j2fc/////nfcw8jqI1DB4nyP0MN1WeERsrHSHzU4SfAKOoJMpoxhBjLOMYzgYlMYjJTmMo0pjODmcxiNnOYyzzms4CFLGIxS1jKMpbTwApWsorVrGEtYSLVrzfSRIxmWmglzjrWs4GNbGIzW0jQRjtJUqTZyja2s4Mj6OBIOtnJURxNF7vYTTfHcCzHcTw9nMCJnMTJnMKpWKqTXwFu5SIu5kmu4yv2cxWXcwO3c5tGcRkfciHXql5BruR6LuEZPtZobuQOfuJHfuYW7uJFnudu9pDharK8TI4XeInXeYVXeY2v6eUt3uBN7iHPD1zDu7zNOxT4loNcymkU2UsfJWxuoszp9OMwgEuFMxjkG85kiH2cxTmczaPczHmcy/lcwHd8z+MaoxB/coi/hMZqnMZLmqCJmqTJ/MKv/MZ7mqKpmqbpmqGZfMKnmqXZmqO5mqf53Mt9WqCFWqTFWqKl/M4ffMbnWqblatAKrdQqntBqrdFahfmCL3mfj/hAEUXVqCbF1KwWtSqudVqvDdqoTdqsLdzPAzzMIzzLgzzEcxzgTiV4iqfVpnauUFIppbWVx7RN27XDny/t6y9EDNGAaxfD4XDS2Joyxj0TYU8v3+bVtzV6xgOJcr5s5/YGLKM/mbGcsu3PGpIZp2xVAimvKOcVpUw2Z+iwMm4l5y8ZOkywVMPXkS1XfKXq5O80advQaarsGqGdBdfOW47bV7LcSqj83zd/l9ngGLrMPsewywQHDLtNsFKjrtsp2vk6d3gOdR/W3z2sf4/ZPFQj2FM9qpXJ5OxKcOjfZfXX+vZkrdqdNSVbh41WL90z4hn1bPRs8ox5Nnu2eP7TJ+6ZMEa8vpFIsLeYd51c1hoomFA0bYylfSnXKddbjlMeLOV6K4Hayu0P1nSK+ULFJLPlQbu2J5ZuHzbdZo5bNfo3zwE10wB42mPw3sFwIihiIyNjX+QGxp0cDBwMyQUbGdidHDgZGCI9LbUZ2Bm0wHyBNJY4Fj8OOw4DdjVWORZ2DqhwFlMSUxibG5s5qzazEhNYmM/JkVPygPgB4QP8B3gcOA+wHwCawgmUEAVKMDigQLAEM4PLRhXGjsCIDQ4dERuZU1w2aoB4OzgYQFwGl0jpjeoggV0cDQyMLA4dySEQYRBwEMhgSmAKYHNgM2LVYFZgYufR2sH4v3UDS+9GJgaXzawpbAwuLgAE+jWFAAABWhJMogAA') format('woff');
+}
+@font-face {
+font-family: Fira;
+font-style: normal;
+font-weight: 600;
+font-stretch: normal;
+src: url('data:application/font-woff;charset=utf-8;base64,d09GRgABAAAAAHAAABMAAAAA8dwAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAABGRlRNAAABqAAAABwAAAAcejWA8EdERUYAAAHEAAAAHgAAAB4AJwEvR1BPUwAAAeQAAAzJAAAufsATCxdHU1VCAAAOsAAAApcAAAeEea4ezk9TLzIAABFIAAAAXQAAAGARTEjhY21hcAAAEagAAAJeAAADfi1PSJpjdnQgAAAUCAAAAGUAAADcLqwVBGZwZ20AABRwAAAGcAAADW04JI58Z2FzcAAAGuAAAAAIAAAACAAAABBnbHlmAAAa6AAASaEAAJVwJvOfpWhlYWQAAGSMAAAANgAAADYHEy/+aGhlYQAAZMQAAAAhAAAAJAe1AsZobXR4AABk6AAAApQAAASkYRswlWxvY2EAAGd8AAACTAAAAlQv41YUbWF4cAAAacgAAAAgAAAAIAPMAktuYW1lAABp6AAAAjYAAAWWeXHCQHBvc3QAAGwgAAADDwAABL0OjfQ0cHJlcAAAbzAAAADHAAAA5wgX+o93ZWJmAABv+AAAAAYAAAAGTJpaEgAAAAEAAAAA1e6U9QAAAADODu7hAAAAANY3/RkAAQAAAAwAAAAWAAAAAgABAAEBKAABAAQAAAACAAAAAHjaxZp5kBXFHce/82BhWY4VfMDuAgvLsaCIogiiYhSWUzQqhwcpSwOxrJQWZRGLqqRIwj8oHonGxOCxnlFykERiguIikpD1WI/VuCTZlCwxj+NVdDxeGYcUE518umfetfeFzq++0zPd/evj19/+dU+/J0dSkTbqAfWdv/CiFSpb8+11N2rK9euuu0Gzbvz6zWs1X33JoyBQjMBp922K+s1dtWCcplTNXWHuy8z94ksu4r7skou5r1i2lHuORmzNTd+6SUNuuG7dWsVtjOydFPXTEPvukGJy99FLfV4YEOO9SAVIEU+Xa5IqNZkyT9LJmqpTNE2n6jRN1+k6QzN0pmZqls7SbJ2tc3Su5ug8fUWbdItu1Wbdptt1h+7UD/RD3aW79SPdox/rJ7pXP9UW3af7scuDekgP6xE9qsf0uH6mF/Wy6vSa3tCb+osa9Ff9Xf/QO2rSP/UvHdRhJfVvva8P9JFS+kSf6qj+q2P6n0PLYwutxa7QTu3Vfn2u/U6JM96Z43zV+Yaz1tnobHV2OgecA6QiziHnPeRj4MUGOe+htT82LDYaDIudHJsemxWbRdznJj9ah3LkvayQZkOrFYn2cp9lkM5rS0Qcj+c5aH1uWkf7DnCPaSljsA/00/AgqRFBQiODlEoDT6OCRo0JfBUqTszwYBupvkpIKeN9FDlHE44JXKvrkppE10XXJ7Xe6sZ4ch3H5imxaWltF23P5umLtoe2F9WaggEjqTvMb/KafEnKGm7r8yKNUfbtGKV7GhC18SjlHEP7GNqNUW2mJpecqUhvZKhrWzUgqjtlY0tsz1PopEv3bC7HvjmOo2JzNzHc62nnU0GttoMdQYN2BbXE2nzox6I6PNg9BHaO0lnOOF1qywpL9G1O068C7D8EezrwZxB1nKChGkbcCI1UiUpVhvZojVG5xmqcKjSeuTElmgOzYf95Ol9VWqgLtVwrKOMqrdLVukartU7rtSFvVtybw/9qZoBh/hN6FrY9pxrt0vPaDUP/rFrmg5kLB3VIrj7Ux3D+KA2OOUOdYc5w2F3qlMkpmGJ5P1gTnaed150jsbjzdOxCsNF5um9l3wv6rtIaFdLjMno6GkwIdmgS75N5ngpmgJngLOJmB4/pbMJzsOi5QZPm8HxeUK0FhIvIsxgsARdiq6WEy8FKcCVWX0Xc18h3NeH1xG3i+RZwK9gMbgO3gzvAnaRvAfeB+8ED4EHwEHiY9EfAo+Ax8Dj1P0m4Ffwc/AL8EvwKbAO/Ruc34LfgKbAd7ADPgp3gOVADdoHdYC/tqwUvovsSeJm4V0AdeBW8DurBW+Bt0AD2gYPgEDgMjoD30f0AfARS2O0Twk/B0aDaiQVJ58Sg0YmDEYDZ5EwOEs4U6u2nE7DWMFAFP5lRDqx3zJw0KR4pHikeKR4pnmPmwkAVozmUPOMIK8B4sJr39YTV4HlKJ90x5Q4mt5cpaxyoAOPDctHw0PDQyK8jrRW2LV8r1Uwr2+ZvotWAVjWtS6BZrXJsMxaMI74CjAeTeJ/MfJsKZoCZoCrDKxdeufDKhVOuLqPUZWA5zysIVxJeTngFZVxFuNryy9U63tdT9neI22D5loRvSfiWhG9J+JaEb0n4loRvPnzz4ZsP33z45sM3nx41wDm/A3658MuFXy78cuGXC79cPUO9zxLuBM+BGrALPE+ZuwlfIH0P+CP4E3iRdoR88+GbC998+ObCNxe+ufDNhW8ufPPhm6u/ofMuSICDxB0i7jDhEUKXsj4EH4P/kO4xGrHAhwEJGJBghKoZoWqnFB6WYWfDrFpGpxar15JaS2otKbU2xSfFjIdPik+KTwrjhBeMh6NKWA7GgiqwCB4sBkvAUrAcrATGA1xteWlGyMP3xfF9cSzoYUEPC3pY0MOCHhb0sJ6H9Tys52E9D+t5WM7LzNBXeH4VvA7qwVvgbbAPHAJH4GK6xyfSn7jpm+LMuFpmHH3kuRSU2V1OX3Y1RXjKOH7cweM+oYGOWVEGKTZhr/GhYxdX3I0Hn8UeqiFoCrygPkgh2DZwzTqmiTwnA5+3FFZLsuLVqYC8CQN18zLlc0/mx9m7b1P9CKYtqTCNd9MuL8zXpdp8e28KGpFUfmym7lIbJoI6VvBeutpvadibvFYW97Qu+mdsFtrQPIWxydxcoUXxWE3BZvqbBMwsUorzx6OlDZmDvdj/DrXNWDRZSeKnR4b9sX0qSreUtHp2RLkjWh49JzO1F1nu+K3WscPWsQO71Zgao+jB5McjGcsQy46LXaiCWuK2Z2vLHckWlkr1Anv8Hugm7axpbNlKO6/ScyyZO0bEJDIzM4VVUq2NZVvzLz+WXVRziyTyYwxLo3mZCG62NSaaa7esKaw9v93Gu3WNaZ3zIVHrvLz56rNrDmdR6J+8KMWNemn9Vo6tU/kM6ahe2FwDkqARZprQeN5IbI46pMGwOpyR5Glkd9sQbMWOfBOQatbVeLDH5I3KrO9NLnZnVls/E1mDtnrhCBoGWD/lpz1TxkeF/WUnGWwj3fjtcMyLrYdLtpx1edxy0+21WqmWY5mJ8TOjVIxWXWjRrN/oaC6Suz7yoKbsUrte+dkeRfZvsCOWLSkesaZTPiqHG7XGEvZ5D3UYO7rWiqnQ05Nu/GEy7YPI0Yifrw+20MIao20tEg+2pz15/jzNW5vq0cnaqyDXA7TJkKJIt1Pez7bI5bssy5F0P5pC/01Mo7VnurWN4XN0T+WOQzTf3PbY2SytnO/j/Ks0b9TnROtxkU0pt0/xTI4ivoXjUTkmvahFaTl+o4NVu/m6WtSNGeb2YHZ7x2d96kmbclnRqYwLc57nRBxq2/LhWK1Ur13NW9mT1TvvmtDjlrl2RejOVdw7Y9iRrTJ1+V8ce7vb8g7ncqqFhp+X7rVrhXC8mrpndbt+NdvbtNLe0q7NUbOedc7qrezXjuXvSrtp9tKucyO79+qiXm3+CtaqfeIt6uoecxs60c7iZmxq6LhfreYo6vpMsd/8X+jVzuxKRbuqxPFcbbrmAewupFM2bf411bVvuV5rfEEb8eU2rTgvX0EmJZ5ZLxV+e7D7TOV7QuOzbC89+72cjW/sdft/lv1WMDvo1rnTXS7Qj8Zc3S+K/9R6rPOzM7gn+KhXag2/flx9WVdpL+wO63I9QvY7qz3+dHuMavLeDwc7YGCdZf6O/BXky/eXnepPsrnFwi/nzFdzU8v5G32hJdv3ap06X0nk7g5a31nZuuz4mjOinlon54whcVxHxc/uVzo6L+v6PoXd/O60jw2/lDutubWtcemMP8nuZI+T1RLZ8xB7UpHq7PiaM6Iu7ISanxF1yf+FZ2pd+R4Oz4hy+9mJHbffvfUnPCNKP3dm/c2crWxpq13tnxF1zxf1ZF2NfhGqsb01J0R7WhuDXvoqjOuMLuQubzcl3quz5doucMKcoR1Xj5fjYbaxIm7J7HrrO1qRW2NoR+wIrrU771r8hZtdbdvws81+Y8z5tSiV/UZNtzI6R3ynxe8ViexK1PlVoHtnQvaE28/apXW/m++1wt9yWtkHp5rbtbdPS4LtPSzgjB6ktryWZjifwCb1LVllvWLC+v/6tr93886WU+1y01GhU6FB0dtie1+iKs0H0oAoj7nG2vcBmocssbIoSo0R20d9o2+uIeqn/iq0uYvAQEofTGz6H1onRrXI1jCCckcShv/YCi/zry3Z/22ZOsP/bpmTxImaxL0y0p9PSW1dC8C86HlJTnw6bmGrWn3oSZ9I0teAqNehLAFDIhnG81jan5US+8+zUMw1Ckn3I5QltkfhNYHnCdYC5t+csUxdph0lFgWRRfpjj/72aYx9Dv1xua3fWG4gNjIYpIoMBtuRCGFsXplBbs/avuYjc5Gq6D7PjtaCNiw3xvJohKZmYk633+Dj4cL4ZnkLI5yGFFgxvayIYpUJR2VmUFpjKrVMs2M0GradmqnH1DAJTLQiC2mGvVciEyOcopncDSsnc58e6feLSkrr5V79bTvzTx8qc+Kyp9sVeVLYqpUKM1IApkVi/zNM+3NlYkZkZ8C4qA9pKbDvoYSsqUCrkNjCjAWyCOMqW2lRpUVWL7zM/4bTMHN/GnkMjM2nZ6C80Wrr6oeciYyP7qfZ0eqP5WKUWWi1ByHmX6LDiIvbf9WORPrDizLSR5N3AL2bivc4lfEqYWTPJ7YKOQlGLtLJzKullHaJLqVdy7QC1lyuKxntVbpGs7Vaa/QV3YRcoHXIXK1H5mkDUqWNyHxt0t2UdS9ymbZoO6X8Xn/QjXpGu7VWe/UyGnXIBr2GfFdvIN/Tm9qn79t/PG/Sfh3QZr2L3KGEDulOHVFKd+kT5EF9ilTrqD7TQ07MiekJZ6hTpied0c4YPeVMcabod/8HCOJD8wAAAHjarZXrS1RRFMV/d2acatQ0s0mGCgszK7Mye5dkqYT5YhokRCLR6kOiMRoVREH0zt7vtz0+Rn9A36MiIqIiKiIiIqIiIqMIwdZ96C0JGR8c7l733rPXOnvfe/Y+GECAo7zEV1hcGiFUtzXaQPb66NoN5DfUtjRSiU8+dHZaaODBG9ObLPwF1UXpZC0riJg2bNqyilLZcEWZbCS8QranTl1tQwuhddHaOtKbovWN5Ddv2thMoeWRJJvYvWIcfoYwlGHKIJ4EzZg+wy0LI8ggm0VilhKhhnoaaGEbu2jlJBe5wU3Lz1D2fmEcl2k3Soydxm3r2TA6bPRkOljlYKuD92z0BhwMO9jmYLuNvnIHbzn41MY4v4M5dhxxn5VXgjLbzma26J2XUQQZLTSjTBGmkaf/YT4ZjJS3z8k6ScNDKmPlM14jsdc5m+3t1jO1GTRVUydZc0FyY9Ls4tkMk0ufeAYhXam65ljfMXmAeXR9bYMcR6/3KHAYqZqZoe8ZG8flBYW5in1BH5guO03eeczTPl/SR76rEdLeN9fPZynF/VBxlcZoR9uxFLJcddc/LVdvnOq7K64SygkPQNFVTVfPcGOsVHdYNUBdV3uCutHf8VZRzepBUHdXyFC3+zf2Gtaouw3OGvY6BlOcTkoMu///FeiLmZnirJtsdfYiVlr93fSGJo0AOzTiLf9gD3/zroqJZDJJZ8lkxT1VXX+aane6qnGmKmuW6mO2IpurnTlfu2mh/v1i/aPd7GEv+9jPAQ7qTDjEYY7oLDjGcU7ohDjFac5wlnOc5wKXdDpcoY2rXOM6d7jLfR7wkEc85gnPeM4LXvGaN7zlHe/5wEc+8YWvfOM7P/jJL37TYXiUW0BXkzJysv0DynOOjgB42mNgYeJn/MLAysDC1MUUwcDA4A2hGeMYjBhtuDiYuFmZWRkYmBhYGhiY3jswLPgNVKMAxAwBkUHBjAcYeH8zMQv+12Q4wSLF+EWBgXE+SI5JkGkzWB03ALa2D3oAAAB42q2SR0zUQRSHv7e7gmIDaUv/gywgNrACihUBe0VRFMSIGmMjoLGCB7EjIMaCiprYxV5QEZFEOXjXGDHxbywnj0YSwR3HhRgSD16cZN6bkvne5Pd7gJX2GYzoiBTqnbj2NsnUeQ7j6EIfvepJEYeoRom7eEmQhEm8JEmKpEuGZEmu5Em+FFmaLG8t76x1tjeGh+FjBBqhRoQRZQw2kowcoyY8IrzS8dLR1mpR6nc1zTRczLNikx5il1CJk0RJljSZJZmSLctlnWzuxMTwNOxGcAczsYNZ7mKKZor6rj6pV6pJvVCNql7VqvvqgqpWp1SVqlQVqkyVqhJV7ExwOpyRP1PbYj9YTafZav4wW8xv5lfzo9lgFrx3vq9ozmqOdYtq1+Q/DzeLh0tp/qILlo6V9R+M9pc27Ywb7nSlGx50p4fWsxe98cRLO+aND7744Y+dAAIJ0p6GEEqY1jycCPoSiYMooomhH7H0ZwADGcRg4ohnCEMZxnBGMJIEEkliFKNJZgxjdUeMZwITSWESqaSRzmSmMJVpTGcGM5nFbN03c5lHBvNZQCYLWUQWi1lCNjksJZdl+v/72M9B7f9RTnKOi1zgEle4zFVquMF1bnKLO9zmLvd4wENqeUQdj2ngKc9o1ISNrGQVaySAbZyngHVisIW1+uYAp3Xc5NJpNVs7abeeYh2vUc8uVpD/53wDOyWQPErYSxWf+aK7vI/4ib94iw9PxMFzWrT0YRIsIRItMfrNdvEVu857KGM35ZRymEqOUMFxTujzY5zhrO7v1zi1ZYWuOood7QV/AV3srcgAAHjaY2AgE7QBYSJDIpMZAwOT0//PyPz/H0Ei/z/CxTYD1QgCxdWYDgHlFP5//K+GkAOKfGZSBIr1gGWhbBS9nxG6maWh+lOB0BMI7/43YXj8XxfGZ3rKaMv0htGMQZGpEgABeTrCAAAAeNqtVml3EzcU1XhLCNlISGiZlsoIpzTWGEpZAhgIM3FccBcnQDsDpZ2JHbov0I3u+4J/zZukPYd+46f1Psk2CST0tKf+4HclXemtehoSWpK4EtYiKRt3xehSgwqXroZ01KWDUXxDdq6ElCklfw2KQdFqqRW3WCQRkQjUwppwRBD7HjmaZHzDo4yWbUn3mpSbubp20NkZ1Fo1KtTCImVL0fK1sKiKbieU1Gxiaj5yJc0xmosimVp20qaDmOqOJB3m9cPMvNcMJazpJJKGmmGMGclrQ4yOMzoeu3EURS6spaGgRWI5JNFgMliB26B9jPY1krvjosWMu3mxEkXtJCKnHEWKRDNcjSKPslpCc66UwJd80Awpr3wqKB+egxp7lNMKnsh2ml/xJa+wj661mf9pIK61KDtbxGIgO7IDBenhfAlhWQrjppssR6GKipGk+Ush1lwORle/R3lNA0F5TWRsbAsYKl8hR8pPKLNyg5wWrKD8rEcDWrKpw/AlJ1Ykn0DzccSUeMGYOqjXBoZFUPNni/1s7dCbszdkT3HKMCGA37GsdVTCmTQRFi5ngaQLI3tWIp8qWbAqdm6znQ5gl3Dvu7Zx07A2Dq3tHMqiPFxVjGaLHo3oNJOpUTtZ8GhUgygljQQXeTuA8iMa5dEyRqMYeTSGY8ZNSCQi0IJeGgti2YkljSFoHo3rxuUwzbUXogM0sqpue7RLN5bCxiU76RYxP2nmJ3QqxoMrYTo+HpCT+DRW5ipHNfnpCP+N4o+caWQiW2qGKQcP3vod5BdqR2eLCtt62LXrvAWXh2cieFKH/XXMbk7VNglMhZhUiFZA4uya4zgmV5NapCJTuxzSuPJljYZRfDsVCs6XMdT/OTHhiDHh+504nSiU6U7Z3Y8w7YZvk2WPpnTqsJxGnFnu0WmW5WM6zbF8XKd5lnt1WmDp6nSA5RM6HWT5pE53sHxGq17cqRAjwkpWyLnOF8Sj2Q2L0/3Fm3axvGFxpr94yy7u04JGyv/Bv6fg3z7YJeEfyyL8Y7kf/rFU8I/lAfjHsgT/WM7AP5ZPwz+WB+EfS61l1ZSpp6F2IpYBchsHJpW4epprtaLJK5OHW3gIF6Aut8miSuYU99BHMlz2/nAvtelwocaVRodm07wzVQvR/9jLZzeEZzvOES2PGcufw2mWU3tYJy7rlrbwvJj+Q/Bv4ayaS484U+zrUcQDDmxtPy5JMufRMV3ZU/Xo+D9RUdAt0E8gRWK6JCuyzo0Aob3Q6dRVHZ0jxBuDRovucNxxpnYjwnPoWNO0C7QcmmjJ0NIh4dOOoLzaqSgpqx2ceXIzTVbseZRTfo8tKeZeMr8UrmdkVrrrmZns3sjn/jqIVq3MDrWImx08eE1j7nH2AcoEcVtRNkjaWM4EiQscc397cE8C09D11SJyrKBhkR+nwcBowXlbKFG2k+bQPJCMPAou/9CpOJG9Khkj8N+0HfS+LhTCqV4sJGbzM91YqCrCdLq/RINmfVHVWSlnsdoPITtjI03icliRVbzdbH13UrJd3VRQoYTRhY2fCTaJW1V7N1uKS/7MBkuCXrpi/pZ40OVeis+if1Q4iou0KwibLl5SWY0qacXZjXt7btPqstvctDq/5d5H7Tivaa78KIW+ppPlDmzjGoNT21KR0ApVsCMwLnN9ztjIJzSkfOs6F6jC9ang5tnzF9CY8Mb0tvzLkq7/X1XMPnEfqyq0qg31Uoy6dtbQgOfKvagsYnSyXFTduHS96YegjhBM2WuPbxDc8MkKHcUtf36b+Qs4ztk9SceAL2o6AdHgKNYQbrmIB7cXrRc0FzQ1AF/Ua2hhAC8BOAxe1muOmWkCmJkl5tQAlpnD4BJzGFxmDoMreh298DzQK0COQa/qdcfOhUB2LmKew+gq8wy6xjyDXmOeQddZZwDwOutk8AbrZBCzTgYJcxYBVpjDoMUcBm3mMFg1dvlAN4xdjN40djF6y9jF6G1jF6N3jF2M3jV2MXrP2MXofcT4VD+BH5gRnQX80MJzgB9x0M1oHqObeGu7nFsWMudjw3G6nE+w+XT/1E/NyOz4zELe8bmFTL+Nc7qELyxkwpcWMuErcKv98742I0P/xkKmf2sh07/Dzi7hewuZ8IOFTPgR3DP9834yI0P/2UKm/2Ih03/Fzi7hNwuZ8LuFTLij13fkMr0vWr9Mg6uUPdC83Xuivb8ByjvTswABAAH//wAPeNrNvQlgHNWRMPze657pGY000tySRiNpbt3XSBrJkq227tOWLMuSbMuyLNuysY0PjDmMjcAX2GASbpxkQ/KR5EuWJA7mSoCFJCTZDUn42FyQzR3ItyFZEpZkD4JHf9Xr7rkkG0iy//8D0oiZ6X5V9ep+VdWEES8htIydIwKRSNUXKKlufUQSd/9b3Rf0uh+3PiIw+JN8QcC3dfj2I5J+zzutj1B8P2LxWsIRi99Ljf/6jW+wcxe3e9kEIYxUL7xJXmIXiJFkkSK5gDAmTBFBGB4gsNg0oXScDlqsdqtoyi2P1jfWOR12vS8U9QuR6upO/O/krpzT7b7qap+3pua79Fm8Zy99iB6DeyKcLtnOKNxqSqCUDpNBi8WSg/eywR3w56vrvYefgx+4JDv2Js3G6/Phlweud5Micv3A+drhCbnELDGqFwE6yrZl0oyM4YGcbINAiHEqy8SMxtEBHRWEEWHQLYfwDf4hNZLti69TvzgpFxYUFBQVFBV63Pl5uS5AzGa1qP/kWEyecuqXIg6/5I/yn4YI/4lI/EcHL8wz7O5eY9/lOGjfZe9YXdA9An9fDT+dsX92X1VAv/LixIfgn4kXJ++HfyZffBHIQIoXtrBsYYyESYNcV5DvEgTmMTIqGPQCACz0A/oAqjBHkGjjQH8yhZcNBQuCdqRb0K6XHP6GUDjqjNQ1NtSHwlW0ob4x2hBxOF1SyO/TO+xOVyFl2dunth4e6uzb3NjVOLhzdnr17PahDnl1bUvT6OatXx+9MuveuzP7V3VEayqiLu/Wvt7N5gfuzejobSwPB6vyi7YToiPywk+FTvZN2EcTccBuBMlKeQWSk/YLVOilVN8DXMIkwuZgp3WipAOwqTAN/LNugIiifpro9eP6QSCszW/zBQ2mgnIjDVOdPVLXUO/3uZCV6hsjdU6bHd5Q/r8BmYx9J1azhr4YC/f19PS9NX3v5s0D/Zuf+cAH/h3/vHea3XexJ8K++MXNM5s3D8/M/N2WmdjKGeXv4dUzMwQg7lx4k/2RfYUUkACpITOypaS4yJ1vFqhBEPWUCKx/4HwOMJYL4GTTwPbrOGOQaaA4GSHAR+7EJ4DlCP9Yk4hJ2Vzoqa70BAoDZT673uQqpy695PKH9X6OQZRvSoRLi+RqlOqiYdwXAbZmBXyC28TkfcGmjz04MHX9vqNtHdHqHTMb93a3f8j/28HmR3uWl3lD5WVlgVAJPeTdv+bOjjU7Jls3ltf3VfZsnOhqWVt2z8p/jHyurquuiX6noMbvbvD6S0tRYlH2yFe57NnkHHxniihyl8NMznJN4lDaCP9+wcJOWiasIdlEfyFLpDXl1hzgoyqhfgWLuvQfbe8bqW5c7nYvb6we6aP/FvvlP25valt79OzDZ4+OtkXnlHu44R6lyfdozAH+LBTsZiaFGz+Zco8XaeE35qJto/wWa9uatsP1OXQD/Qx7jZhJRM7JyjRlGA2SXicKjGaRnoHz9uGJx3FX1sCuPIp/HJyUjbCwmZiZyV5OpahLcklhKRwNR11h6rSd8J2dm+rr2rT1rO+4jb121/Jd7h1d8ze173bvar0T1hske+mvgG1NpFvRLg5QUbC9IhG2waZzko2KwAL58GWRjiV9Sqk4BW+JQwCCoin0pvxyWwTED3QFCKZ/8J4998B/dM+5c9seeIDTp2RhLXmJ3AXrFcruDMCA9hOU7HF1fwgdclhxe1QFm0390RDq1rz2VaW+Dl9Vta+o5e6Hc/Fe9VRPZ+lu2N9c2cGVxFhCSSibTL0NXjobe4lWU/12fJ/reFjfqPGEysX25EVB9FSNrmlzDvvEwt30vFAF6+kvgAqvKadC2EbP/2bv64LjnRvzhXlQWCUga0aQNSOxkBI5mNABIsDHRWicDVKSbTZl6EVipEYdbFuwDrgE5CCnkPpCOQBCDs1tbmxsbmps/Nzvrr/+d4fXHKb51x+O/esNM0/RjV96KvZJDk8E7pgB/J1BSuUQcIigUJMMDyC/ULYJVhthg/BOBsmwWOw6kM2gBXgjYok4vA1Ud1/Lz/afio3O0m9vWHfLxfOzswoPg/TQ/wIc7KRMDudkM1BrQFbWjwZRVWiqMI3QQX/IYkNlTEG6vZK3QZVpYHYQefqbYx+lteZY/6NHmqv6lq2ZPLXjWrow8sSd2zZ94aHO6mjv8n1XKms6Ft6k78CaAdImt+ZRUZcLXOYF7a8HRHSAmK4f6A44gn4VRd000ekADABrGi4fJ4P+gNcPFAQGBKvg92kmoZxGFdOgQYRKyFFI6Ttnr7pz7cCy9ct75peZS+tWttUOreyYmp87PNDcPvH8+utmOzvaogc2NtRV1q/oHd/Wv2JdliiNK7AGgO64x2ZSIZeiAqX9BomJvSAYIB5UIHHJAfoA3VXJCKJMeBtsLgHMpiPCjENHYq99bffD95r3Dp07d26cvlQam/3sZ5U1QsBHFPY2j8jycgdleqCDgHQAswirgA0/SvQEyAP00OlQEMXhZHr4QB6BIJLJnUoQeMtvgX1yIDEYvePA6eFVDcOtPXuryjfS27JjsZqm8b0/n7tlpqt9cMXNLrpz+rPOa4GvSwGeDMDZRYrJCrkFHBiipyLNp6Cb+gkIoqijIupAjUN0Oo3b83I97tzivOJQAOEBTuGmWVJ3w++rYtw+CD5JAZH+MFJev3KNTt64ds+x7fLMMs+9x9ft6WsUDkTq2X0jnmv3Dl29Z9eZ+g1XdT7ySuzvB/55uP0Mp1nrwlv0T0AzPeoWVCW0HyhFepJVvw3FHA0vKoY/xf79OqqP/SP9Ilt/8YEga0IBEMAveZPlAK424gHfBKTY68pkIpAcSK+YPcCPMY3UeXklIUUCJAUhsHrRkGLzBHBK0NrVNaK9Q0b06emf9t928uqDNx3feWzD9JG5zrHR5QeWv9zS1h/ZFGG2TSs6rlt3cP+6gy0tu9du3hgba2worJqsa2mlN1U0Omt7Sutq0C8MLPya86CNFKKU2oH1GDflNgoIC4jGLMCoQMsGAyUBDmM0EA37/KplVsWB1quuUqRuI9UVwdY2bBrbf2buqvkvv0SzIq2R5SC77R1for03bJu7+Z5rv/5yLX16dlN3R+dK5FXVb6Zvo04lrQPnHWhFgFJ8/0eTnWe3bEOfjqBPl3h38nG7Pd2ptqQr4lR1TG/1Vld7fVwvM8WmwPromXU9phgVBQwr5ws6E4cGneLcBAyphgcAcTiSAeHGJxUUboYUYBLGiN6ZAAfu1El20t+yJuBDsBME7EQlbQi6sih9NnaCHq6IPU9bdz58zcNTZ04o9BskH6ev0u/yGMEnF6l6btsii6aGC0FgXfyXvhrbQe/Hn4/Pzc4tta5N59CFK+k+ejh2ooK2xp5nTbDu5lO3Kut6QOd+E3goHzRatVyBmp5ycwyGRDgKf2sunyCI06BgxsVBe76/zKIz5ZVT0GX1K8QUzWoWpDitqPPavGB5MK+ytKt57fpjW3cHGxqCZxTCUXN+Ubgt6M8POr3BdnnHps6K9nCw4fcJW8vIsoWQ8BWArZo0kdvknGJqEKONdkFnAHJIAmxvJWxvGREzqEEnGubAuVYF00hR80DcwEYGiCRxIR1DH7Y68WWB6YTx9EtI2hWTsq22piFS01TbFPD7A8FQwGcCp13nAukJNNSTSF0hU8Q97DdTTaJcFu7QxyVK8DngjWhDiL1UvOfQ9xbAkH1/2yevaN67paldEi09DeMbrtu5brhp6qP3f/rJxz+1ecsVg8s8nrGNpW+/9ALVr9xzdtXJh1vDpQ3Xbjtye3nsX0d/dNtHX/jEJ7/KHI/d0v5GFt/HhT/DrzWg99CLC8l+IsIWimQ7IAQRHnoCYIbABzDCFyRgInTRvWEI5GwRGxUiAn2+4v9WnP6X//VK7KXJxyYefJBduDjEumLP0pXAiWvh3l1cp5qJD7mkiNs71DDc0DGmmwJdz20Pt0Ij4qA35PV5vdzkgQF2ABGUl0YXeMHl1KJSjtvhp+a3bDyZf2jNRHP0ocrhqaaffbdhor+st2bF+Av7Xqb3rH+qOtY0UmFjFyzhntqWQZOYOcRlrAZ0dAT4w0Gicn0WiIsZFDJoZ4CuX5N2xenS1AwlluxMdLoc1KE4XVFXXBHGw0U6M9TdNjF/6qHP3HzNeGdLz+DU+g3Lhtf+w8P/+9m+1XVHjt98VJEdpMtmnivI5bkCULhqrgDEZkpxvIAOAW4Y6qsUtKMgIgr+Av1BYXNLSUfHl06H29avb3jmC81Tm9pK6NTAthpbzPb2miODNVZ2Iaey/wZFp8B69Dewngl9Pfh/HsTDJxr1QURV6idccernjrjX4bV46Q9jP/kJzYntoh9kI1/e8sIs3Eu77485Hn65OOm+mkfB8wP8jlzq+R0t4EHQb//xe987QW9hIy9uif0cb6bsySrYkzzSLXcYKKMgWAxYTMyFXRH7IYoWBZ24LW6W8O5kGhwotKKUYNrBmpOZIelIHs2TYIt06buDkuQPRyx6uv7sh584eXyid8XImu0jo3L1lVnv7M7+4vnP/MOa/qajJ09f735kS+x8Z5x2bJDTzisXgnRgILMNQ9jhAaZEuAmaeRE7vyWC/7LBE2+cgP9oQ+wFdiH2W+qI34+8Eo8rwa/gQbEWV0bg6ldOnFDou/Cnha3kl3xti2ymlDsj4Ic4qMlR7gqDswwLgVTk+uWSE4Ut7R/ektfdxfouPrJsYllQ47O9fC0jKZdLDDquo8EbwWVBuPnCIki8aBSNkh6+J4CAO8ptgAQVbCDdr5ygR//4+zt+DxoRBRt+6H7aHvtG7KS2//8G9weay04FFxCkTSpClhwBlEUpsCzs+E9jh05QO9zgi3BdFcD1O7jOhv5RjkEUKGoFUAlgO46KybS1WRwOzjxev4DJMvjXKQmofOBf9rubnEZRnL/xpGgw2uejnzkqXvcw3XBXR8xFf7Pq7tgXgO4e+qvEPg7Dmtk8dgQwGSZfUMupiQqHxcEtpBfXcOA22iIhoDAb/uyvRft1n/6NaLuOlW39aAx27+L3Nn6KlnJZRr49CXxrAmyUvF8yf6r+tC3gU8OcuPMk5RRbckCtsZMfO33mQfw5E3vuwdUjdP1nnn36YfyhQuyd2MXD6j42cR1tvZykeS0Br5dLmqoyo3Y92loLBlOfu61vqL379AePDp/4p1vuoj88HGvtuXr/m+zClUTF4yb2FOAhgQRWymXmLCb0oCsB0QJqLW7DedDEffRxYTAQCPgUa65iErVLLpC2qrg5c9I/c5TO3EWvnFyz7Mj6Mx9BPOl6FbNbfzwsrti1rPnJzwK6Gr9OAZ6ZED0Cv4JC1lGUfEwbYFikakmVN7x+L8RHXFeBPbDBtuGmFUv1IY49axjtfPb+T/Sc+A61nV7ZOTRyE/3X3s3O2A+oI/ZbduGFpsjPkC/MsH8WwNtLquRyJ9gCl54lgiXNFiQHi2V+n5pATERGavYwSdtg6tBy23UfmekZ2tbc07xq38zJuVs3dHSM1bZGx+a2f3360PSqnsba8to83+ZV63aODbaWh0Plbu8mgCkT6GDm+w0OJ2KbMA88KFRcOcq1TYOXkQsnnmaM9V98nPXvRJz6AScQVpKDOouH88PJMQf8ziE5fpsfY3pqUZgSVQng0mBhQ6cOHzl+olU+AuJTu+fk8b30xVhjX+8H6Tfx3nqAbYDD5pCtCFsCLCvKexDEBsQ0QkvF+0599+++d/YIa0TNgdfmACZRLoNhOZBlFNBX7YcYUEgSQwAum2TbLDbQRICjwGVeiCgSbxOiRz+7Q9z1qaPH14n7brtSnOZqyXnxdXj9Cltx8XnWip4vwNgK6/BMfIYE9wennnJYuW/HBm1Wm4Vnz4WICwJqwcaXeeGpu64Rj9z+7HfvPCueuZ3upZ2//W3sq7HT1Bl7HfVxDO4ra/ZOAkWF6hRjp7gWh99GYrRCHOAE2GF/OORM/tmJn975AfEDQNHR2NvA1Z+LfZUu53oJk1F/5PfktpkB62npksT5gZYOsFo41EaKyRIehb4Ze452mGN1tDP2E/okG4oV7d5GX9tJVD/nFloo1KuRgaY1ML4bQ+00hYFePDLQgfCgrqCFb7xx9dXXCg9vvehOy1sxjAt0QtRGV/7mytd3CzflvTOP64RhHUd8nXeJQHT+hgiwbYQ6YJk3rp1lv57lORyWzQQQOT0Jf0G/tVMu0Gn5PXKMk/ggoATBCVLAWf4FPel004jNH5Yczxx8Zv7agyybtsS+9oMf4AVZC1vonxf+CaNxfq9L5PfwJjok4p9jVvrG380pOVh2lPoEOSlPJ4Wj1Bf+eQt7rn3TVq4ri3i+qZi4IfbplFe6YNec4LkVUlEnATuDpupHnSVS3ZyW9poc0FOwtKoEegq8RQUBD4YGJTyrgQpDCmlZ75bkNJiAbguqFPpDi71gXUH0iuFNN1+3srZp+VDR7OSebb9cUVLZu4Lu/pWnwDBmaOvbMLB2Q2FdiXsiuCF268orqiqHOcyrQScE2VsgEy5yk5Kyt4PXTZwOJkBsA0a3PwuPnNwpbzPt7clElp8jMamm8WFjlODcnfiEB0NpWf5ss91qdmW7rJhnc4GHAahxzROW/BabEvRIDueLTRNf37dtXb1+/8/3RSKtVQH2VuyXA7HXj3y4o569dnH3kzPren7fjPtUDnvwEuyB7TI+/OTSPryN2pb24YHG5fXRlsGp646fODTbuyzSdN1k6drl99545CMrVoUf+yzSsRLoqAc6ou++R7ZnglQZJNCD4DCBxQCzyXoVUuXqeNJWTxEObjdF7WStIOUjeJMHQGqUPCk7TBmUgDebnZFrylUSvejQUp/qxIbCECm6LPFDEho8AOF0RXjD6sj8fkN089ZtB+lzT2wZ636rYXMjNZovuttW3XPshg9xPkC6LQDdrMAHy+SojufiGGVoZyG+JNuQT1WW1aL4cTZotzkdNpfdFfB7cySeR0BQXMnJoLBPioToO7FHzQc7lkfX7rrh2I1791z32kzGS+wXd9QOdd1/4+GPnD2S8aUPfhD3zwS/PgF0dJA5OYPhtnEo+CmF7OH2VsKzCs5IbAppNTqgBCnAbPgRBXU0t/hToB8lVktOtpmfgCgxmwHppxpnD41IiumMIPFye7sClZWlxUfN++ZHR2fYW0Xr7L5w08bYAH1s47IBCMeIdSHEitkGUkOWkU/L2S4qCt5spjOwfnAYYLurAeQoxCdGo7gPtg7zhvQoMRCd3gAawGgUNivk1OuV6A4JK00TSRqTAJkmvFIQjUff76WTspuS5mh9pKqiJFhcmJfrsJkMOoHU0BoT4OuKcIOO7lBSVhH3zKGkGnlysYXWaYlHG6YaMcurt161vONkaf1A33DTuhs33rLXV7dt8qoZrz/HW12/Zfcd18/vP1c3UbOxoq6+3NtV5G2qaQ7V7RifbdluFcNTq7YacsCBHukZWTc6Qh+ojjbWbo1y3boafl1kb4IfUCaHQRpoDs86onrv1bKjk5p757cGuL2AkCiK2gJdcq4lXpyf79jwgfkiX7SRvZoVe3XgI7Ej9FDY38/5uwV+/0Rw83P4VoWbHFq+cAKFbXRACbAxn4iuFSVzSe9OPm6xKP6dlRMFSWYDq/iTKj9wScDvmZ9nv2+vrGyveOc1ZiFs4ZcLYXU9G2m8gEGasmiOJjwTaMFHMYlkBvBwi+eUNyYf84cc6DLFQzl9Ys2cqmU185NXqKu+MpUv99HXY4UH9ggf5asrOp2f77/F4zvwqNT4TiEnpaMD8Jca4mGAh+ENjzCj4EZFJBvQ8anHL5x65MvsNfPFLOr9w29iLyt+Qw/oiEK4bybGSpTnwlHH9SZ5wSEfWtCgogBgg+yROsoKKitaOuY9lqn11p4ett188Wyptu9CJuicAjImZxpEpqMFdkZ02tGxQ6I6HZ3mVn50QC8y9eA4jyMhxXNyk/HPJmWT3+q3+nyWHDwLx6jZhUo8mU0S7LLX2DGxpbB74rb5/KJo1by7sKmKWdpHRkaQcQ6UBfpit9KDpf6+JB4tBh4dkTNMsF167o8pkNqQ7ByW0QGdqCTH3GAU1VS1qja1TyblLMXV9lmsfvRmvXHIIgqo9AhyMQDYNfMBzsKx0wgZwKXpatjfYnB7LGqeSDVrSWGY3W/1KnkitF91QS0z7wvR+w4c/HXs7pMHrz52/PXj1Pj44088cfSB++Zvuu8e7g+EwB8o5v7AVtkuajY/i9t8QJn1JJt89J6V2hDNIqDJx/fwuEoR3ORPk0y+32dFk++SFKwVqx9NmPz5fdLyjV/fu2Vt7cxebvO/ZWa/XTmMRn9ZyeNbxnp+H+V2NwR2txhUo4ucVv0XJ6gPCcI1kgm2Q+g3QVjf4+Zvi+lvTyYZZWEa+CjNvoFRRsOHKMb3MeljMCpGIyVGl9HlsGVngZI1UINmlLlNjlrCloQ3EQWbvLOtPPyp+YYN22cPzk7US2CSH+96q2HkosNMWdfdx2/4kFyLvijw2ylWBPswO3DeCiBmo2LMMjLUjAZKwSHLhhcWf1fon1S+aCGaAzaqRh9u9HTx/+L+j/L+5ON+n0VTpoqkoCWUvj2/P7N8ypPrzHWtK2KWrQekG/THAKZskP+vAa2LFd+K0SIzI+DeCuhbqQkOxbfSuJASjxu9K1JMi9G3iipBcWhRTOxQo+afl0eqh84d3LxrVWNrV7iyumfN6M3T82PtncN+j9drD1/TOdE0XOrJdXscrt7u4cmBvgZFNxkBtqPsHmLHeJ1iZoBvcK9IMXeqiCbR6eLROgSSVuVoF3QVqCq0+lEHegBoHelIZcPqB0dG5m8yX+X2FO4eLaGfp44NV2cf3xD7bdinxNL030HT55A+OQOPsjMxJ6LqAx4Aj3Jx3Bz37pzqm5pft1n1655ANcCTWTYl1o6CzudOXEP/fK6vrXp+r9S69U5miX0wWNpOD1/8ffvIxzjOoPTofwIMEsbzOhqPOkcTUSfPzitRpxIt0//8/L3nT+8Xr2KWi7+He26gn+D3wtzCj+BeS8Tgo+8tBmc/uurBNeLohw/d1CNuOrZOHMQV6F2xPbDKOP10bJJ+CmLlP8Nif4J1eAxukkRBOVHlZklZxWqzKudleJoQ5nG4ZPP/h3jF7ef/7s4JcfzM/efv/va3qevt8+f/I/Yap8NCiNPBjCcVmZwOoGtJTzoxzMRsyVWIYYbwbQWNajT5++Kb9+YM9drLP3XLPvFqAPzftlxpmMqMLgPYB+mjsAaoePoZWOMS8fjoZeJxP4SSn1wgVMyKHaLkdXqEPhb7/NaNdGQr3NeycIgGhG5SRJrkhhxwtDHjiQ4BA3dAT0GjgL8ngOs9rp6YCSKYIvh6kcVjcVgkZJuGusbltL4x6kAnVjkDgVdnxFFF4f2QpcS9eV9tKNTQEArV7tvspmU7/OXPznTRjQWB8/2dmWJmZ//5QMFG2jXzbLkfVj+1cD+5KJSC/4Bn3mjdxzh26I7TIX6cLVgETDYDp546tEP44Dt7cR+8gEt9AheUQSISAbhoDjABBtOBT4VFJOOqtmA0HReq4aDh1KDg4G9QcKL16cjceVlkOG83kj/Qt+kZ2MM2HvfXWy1MwPCMYHyDB5PjcRcMs7OgwQSyGvRdlskIG6DGhZgWCPowjannEXghxeSmS0+3B1ZUW10e80B0Svur8Q8eT35++EpPQV5+yR602TyfIzwE/JNDmuXGBAdhQZYo9uLGHsMcCcEcSYLmSvUScpROn5eU4Qm6oi7JH05L9MQeOnZzzemRM/GEz5ujo03XXQd35fwrBP826yNHq+unMHbsuZtvqj0zfCbO4NQ+NRU9fpyf50fV8/wsMqWd56v+N3eyuRiNgaIcOO/hLhXGwuiEJ30k5ybeBc00pn7GhKFJcNDVKlpbvMpRitj8LynHwyd2WG+jn/bW1Hh91dXfjbUpZ+oLW+hv2HmSh/xqs5jhlnbMFkCwhEzRz7ME6kk/RlnDaNBcjpxsSY+nSfFkARaMplWJOuy0oz7aEu3ZMr19x6aZnqiaNKg03X1vzh1799xjue8eUxVPHlBSBjjZ2VdIIWmRm7TI28WrYCQKjqYAbsk2zcnmlZ/8hG5EN2hBt9bm96G3a0vYVAhlHX6HXXIoxVPLYcMiN+zferRrpHRlfdmXv9xMu7JjdU35Q0P0nfG9061NK7qG+zZvLBK3Ttuahwb6YL8ySS8LsFl+jn+FXJwv6SC6JXkOE/jpAjhwmSJwUL+ekl5bFqPgE4Zw00SMUxmd1Q45JgVe5QcaA8g6B5+i8MOLJv3gChe4vUXuQEGg3KfDAkruhQBrOe1Yc8gTQWEMUaNhWtfIj8DtzsGx2p6uurXyGp9/VF4b6eyOrJXXeovX0MyGpqaGxuZmNjtWVLRWHm24JbpGHi0shI/ruzsb1sYebz+0cuWhdtxVoHk1uwBeI0iDqNhOSjKoqCPidiPVGahe0um3oWUaxhP8EWkQzxKV8mWbJcdk8oC9VoyfgNRWyxPBjfAP73zy9Fnx9hNP7j59+vTNp06dolN0XeyHtDT2md7B3ptu6h1UzlYSelbCU3BCwFkB+m1LYm4s/xKG+FmcBM6rLuksLmIRuPo9dIg+R3fG7rv4Mv7G+3YtPEJfB34qJXV4XyNwTl1lkSuD6QVayP14XqsCu6vxFB30V/l5MY9NSwikemdqFVLyuUajWnwU7lrVsH9y+5q6Zb2hyqq+4f7BxoObdg/VtnWX1FYOjPQfbJorWjZHW1ZFyuTuddHBcFF+YTA3v2t5f235yu7xpuHyovwif25+x1X9AX/AFwj5EQc3u5WeFOxAGQup4Frbi0k8Qsex0B10NEONvdpoMGcaLEaLLUenZm6tGCjXOe0utfTZrp9vLS1tLbnPU1bmKSopYbeWLispWVaq/ObGbIDsYS+z/wDfsRBkcRtfbX167lCCwBQLsNU6HwPlBRF0zkhFvV4chxdRP51B9aJ+dXGR00FJKFBUVlzmznMUOgvVDKOd2k2qJaFLVQq44izuSiqmoucqQiXNPaunZvq7G8v9oWBl/xVnz16x6447dt367LO33vLMM7TV21K3feP6HVVN7mXLD525++V773357s5nTsFnt5x6BnGcAHD/HWL3POIjIbJaHnQCIziA3wqA5fXg56VkpyWil/QzWpL6igGDlqTeBdFEfigY8Bd58n1un98fCBuzeKL6EnnqRJoaM+ovFuUP5EWGO0f2ztWXVFV3esYGH/lqxB9eVkt9sQP0LNv8SDijX4q0DLR2DtiDHtdQUexsZMjrWx67cZrLTCXxMj/zQ+ybRQyPZRp1jNWA1pDCDdEihr9dnz+26oknVl15bNWTT66ivhfrfrD25ch3lBdem3yQvkr3Eh0Jyj5U78cFrpXGMERAc8e4h6MjOtVv5vWV9NU9se/TvX++Z/tfViMsgg/yUzbA3gT75yBeUkK2ci6bzKU6I+3HSkcGLutRgpErFXADDEbJMAdf14lG3TYT6AXCxuGFkWnMB5LVmAwuCQX93qJCT4E7P8+SneEwOZS0cGbcXdFkIKwWrKJA2+xYSe/nB8CSciRM2/d/6EP79z3wwL6x/fvH1h048LUVI4OdeSvX3dSxLM/d9NMHfn7u3M8faLlmfOLaayfGr6GmZsehnTupe11gkJ+NPESXswWgh3pGw7ikjqHyVKmS5DRy7sdS4eWxn7KFDRsUXRiln6F3AH9mgBTW87ugXsT0L5gNPKQc14qdCQPXzJKTaQJcM2iG5prZVNlx2Aupav8d9l/5Kip83oqK7afn5k7P0f+uGq6sDJdWrd4w0D+5vn+A18kR+iozExOENpVyWVK5rVp7NIraXz9F9PoR/aDWvoL2lmr6PuKIWHjp3N1777ln791YPEdz9u7deu5c7DZ+hlUGFniG/Q4wgxVyQO6yqVL+LPQnREyLH3aq5c9ZSvlzZFH589rVm75kiv34ylVFuWWBthXrO1az/ZG5VYMdszPBPE9FTV8P7zugjeCw/+791D5fET/O3hWvfc7KV6oT3rX2eWrD0KaW5pI6f7gvbHK7/cXu6rK6lWu6V5eESurpl5oHVtaX+wpau/LzcvNCjc1tNUW1GYK+OelsrS1xlmgLR10rQ99qYUfbb1Trx1cvhFkOxF8FSEMs2HPkZAkYcRe4wW/rSQTcauahxKqUbWBM7XJGGzGo5joKy+rCPr3f6aHS6nmfxRUNz+cdypGcK32NHvS7DkPM99wWi0EUWuh1sb8bn8guaAyWl9D2nqksBZZBgOUUP0culj2gMMFu96BLcRw5mTuKZDBg48feOszqSRalCsDLTh2YOXBo/uRhuuw7JqHqnZ+Y6G/pVRunDir3rSbvgI/8ETxDQudYKySdxnuvVpoJbOk1rHSIl4lWV/M+EYE6wL+3kiYuQZXgntFsYGazYvTjaW1gunE1GSSw1cBu3HFGKXLBzkYjjkRCJlL3aHmVabC2bmh5W6230B+9w5FzfaeuNlTXUtCWo8AdBf4uYq+BTgYPXQSHhZd8UroDmXonGbTnsCwn1iVgmwAt2ryh8v5huKSjTh7nemESD9FB9nVg6x28wwGcMJ04oyU2r4hv7C4BguuA32rhjFmfktkE28O17umnn469eGBmy/79W2b30XPcrNjOnLn99tkjN2zdfvj62NrpRXYkK0MvgB0JYoeLQ1JfqOfmm8GIxL4CL088MfridyIvr/1BnfLC4Y4uPCycYH+CvzLArq7mNO+0WbG5hlALiBkDn5L2YmU98ge49aBW9DpBPyaBc48RGIRaej2GMHphiBf1W+x21C24FUYaNmo0U1QNmDmlyv+F2K4Rem/sIU5Jtr1u+vHDa7YPm0br2Lff+VmJ4I15OXEvfnj9epnmFv5h69Y4vCdVeIvICIe3G6CFSNANGiIfGNkKCkFMgho2AizQnBp2bUsPu4B17HZea5MO8VKqKw3u9YsVWQr4sUPpag0gd8dpbiVRcpDjsLOCZpjKqTGjnhqMeZkmQTLkgvsOBlLQAy4mxAUk1EQyjKYMtKkGyWjgTg641KD+BCqOLeqzEOlQdWVZSQB8HD/fGnsmuPwJNFN25D31h6jo04zEfl384VJqUx5V1KZKjovb4tv4+8voUZ4Lp69AjJ1PgmTs8Zxsliha96DoC3iGqNZdc2XJNsNWjqk5e/VzEUgrYn9k/NPJJ+xlaoU2Brh2s6gcOKv+6wohqtWv1Tl/Ea/Qblo7cVyp0D5d7fNWV3VW/4vHH24LYIW2L9C+csemzkqs0H5TDcqJoNQcC+d5zXE29sFkm7ME1vt+a4+jWJmRUn98NPSL1uQa5DfaN87G1/vCX7teNY26UtfbFHqhJXm9z7Yf2Rpf7+N8PStplCNWizkLj736IbbQHUtZVx9fNyc7vrKUurIJa1AiLil1cXozpmBqU2quFzAL1ETiMNzBYfBgHFDgZgbJZmU6PcMgR69DkTBkUB3Dk+ZkkIwqSFmZhOS5nPYcc6YnyxMHzpS+Db6QlipzqpmyFDgbfe2ZOc6s7tI1/nYT/lGeDPJzlXZX8Q7+C8sMVbhPcLid4EE3yQ0YogOY+kuASUhhQa7LZsnKjIOYkQZiKBFlORN/poI50lpa5iksfay1rKzQU5YM4mMlhZ6SEk9hifqaBOc/czixj2afcuwbJgYgrUGfAFWSuNM1MZACtBuMn/ZNHZGYTloauUnZSYinINdps2abL4kfw5P7+hA2/moCmopcnbvC7a64t6e5qadnX28ycrS6zuOpc9dHursjtd3dvCfgDWAgJ6/Ts5FWuRlNg0HUbQOAid4AilNLk2FZAp0ySto+WPFYIVv1nTNMbgVGTCW6Ig4//PCOga/63mi+DczmH7JjP6/871erfh2LXP3USoRpy1e2vLCFdcf+gbar9WsCr9MPkxtkNx7mubLAj8mlouAGExageuKnOr0eVJ8ZSO+HbYFQYR+Yep1eN5tSiasV17jlgPIt/dHLfW1SzvCHbAF/yIo9cDr0ldLrOyNKQjDZgaJ7yquNe25MFP8PDnW3DV/LXao6X6GvCVyqGceT98W7AZYNr9KF4i4WU+r0QS+ilqqWK1BL6Xr/gnp9TKUl1ex3g1bU6vbnUSOSv+FaQXChktaK/QpUorbYClSH8bU+zrUhyDPXhjo9aEO9jp83XnpNJQ+Xg7uQjiDqw8S631SUobbyBzU9qK59IqFNjFQChcK13+VWLiywB9QgMIPPMEisHlhamyQR4dUUXaIB1bNYjzDwhAnNhX3A3GCe7ASXUuCFFov7AtDcvXLiRBvuZmIfMd+f956uR/MF1z+IG6RuDcj6q3B9P+wN+oo+uSjDqEePFfYGfKljSfexK+X8eCOV+nCvdpXqCXov/ALuNwT0hmAEfGV+XingDTH+TNwtgMTlvIQ3XFo9w/3vSqXjYgoygoMusB/FCrvL43os2ACNlFQvjn1ZU8q6XoulFH74BAWqNNRgOSo21Ui80YbvMpblz4bb1m9oeKan5xHeXHOGd9ycO9cxto1O8QYb2riOhrHHZhTbbp5f99298d6eYbC72QBPl9xeXMQkvcvJRB3vOeAFrjoRTRlwocgkcS6lCcGS43Hn59qtOcBm2JBgXKIhIbzI3ia3KPzTImub2rSwJsXeCkr/AtcDNuLCXJnL6UAOer99DAIwRXovgxdYdVE/A9uisO7fcm3QQelr/zew+eK1ixW2j6/9cb52PtYS5Oc5HSJEA/04luDYkjA4EAje8nAJAoBUpMPxoCIii0G5ShWZOCx3cFiCpFfuCviBa9z5wDUslWEoMMzSoNm9ReAGOe1BRxChNF6KVIuZJw3gnXEGCsj8j/LFsNcnM5Gown9C9YRKUQ7BYcMWb90lwAX5tyKYihwu0RWzpEZIB/XNFPWwGMzSRQqXkg1kL/0+fR1g1V8wCrSmvI0C96iTLzZcfXXfwYN9/PeTBw/2HzrUz/+X79H1gGMTzyN48SypmFLBiIcTThueHvQXFTKhF2BkPUmzWxJjG0r8QbWfLyygr2B32WAnlJybcvKlHYjRiy23ZTs/Hnu69Qy80G9/7LQ7P7ij9M6Pnc4rwFe6/hONsaBIhYea6U+F2MXPPKs/UnDz2n/7zLO6wwU3rQMdxPs/QK5yiB2rPOw2K0jV++0DQagSvSACtzpp/SCKEfobrYfmKbHe97mVSltP8yeU9T4Od3ORWrnKBc5xQnJ1iXU3a+s67OrK+kthipIbX/wGzaylra9ZOZRZBYYTcF83CZGIXJPgeMMSmPu96MRbLSocxqXgWNoMJsD6Tpo1TINuCfcC7DvvWYG9wfP4Ujmkda1kZZpgj95D7wrfFq1/5XfKriT1sGh+BLd7y3lfEOcBrZo87mMlt6lhnxr3I+t5Q2uiT82Bee9Hbh1eu7LzzB3zYydO9N1yF525MfbO8r5DV13HLhzYq+aI32Rd7C1SRc4qdVgZuZQJLgqWtN+t/Y8I/xPvWlA1z5oBro14gSZ2LSgxmzvxsY6C8zegqSze2JCnnWov+mxSKfCsIlXV/mpe4BmxqJtmZg57oZBylFolNNSvYDxb5LCsvmrXxE5vibekqblk37r+aIXfHy4L1NcHioJFgeBGZt91cKy9uL4wbHeGA5X9NWMz3nW20nBxxBdoCvjqC8rzCkoPX/w18CHvRRGqeC9KCemXe5bqRikJhwSh93+gJ8XGI43L9KX8Ovyzlsv1prAN7VtnSRyPyv+v8OBRzGXwMJW8cHk88tqPJ+ER5HiUkzXy6vKycEgU9IvR0YFpF3j8k4aNlIJNaUkCH8P72RceIF0GpW031YGWq7ssVtdNNR071pTAK5Pj1UD+Xi6sjzCjobyM6aXFqOnVPo5I4qBZMkwTg2FiwET1euM0MRq5LKoYZyRhjMMWDETSG6Q5YoRvC0YeqaXRKPmKSdkdCnoKaqurKkrDwYZQQ4Jgme+ZYL74e2oO63Kk+4hvZaY7r6tsxL8SXaSusssSsa66wrujCpylneArJdOxgjSSu2T7Upyu0K9cQ9xkYHq9NA2xqzRxSbqVwsf4RUF6DxSrqvQURGorG6say0pDwb+AYovrLy5LMhcWZ5Te6yktxeKMy9KrvgRLNtT/SJxmw5xmVaSJPHApmhUDzWrAikl6o5QggcHAB+gNX5JwVfFL9MQg6A3vSj2XpyDaWFeL/JagnOk9U07ty/EnDeq7LO0a8521+S7nvb37eroP9FyWdv+rzl2fV9BQ191dF+nqUuRW8LJiTrl6enTgvA8r571UT4rBYQlngjmzYFZNBMu5+G2DiDY0Ay4JmrCCAY+U57IygBmV9qzJgUwDQyJh9fM4L+rL5LNVjPDtcROWucIV2y5/hfn93N76vm/v44Kk49fMgd9Pmenyl8gNl/02iX93IJMaDPHrJvEf2V1THQrW1VbX19SXlwarQlXAGj6/1+41Y6ijeAdSvHnuEpU0IbWUxidFqij9RHR21zVC7FHTNe1t0XU7b2xbcXjdzE3Xa1xy7anu0ozcdd30ns0ZL7Fa+t2h24+6HR+oWd01MQEcMllcWwocEqsaLGkorRmmB2/r7ub9kwLvnwxquVUHcoGTikIeJaIPGMH77rnVyfeWW51cnFv1XSq3ytspFmVWl5VXGTfOak2Z19ZHWzrW1UZWJY6qt1jPXql2aZaubdSHdHVB7eBaUHoewUfCnkc3zkRLdD268/PQo/ib9D7y86gl+x894AWl9UC+qvo9CmyV/9Ow8bOrJWH7B/Bs0mD7uOrLKLAFOWyFmJco9OTngS+jgSioHowKoXQJCAvcCRgNl4FRzaAsDeas4q2kQUqZ4qCIKqyZHNYiUkpulTMSlNSsqQpoijXNWBLqNGuqXrj0d0HovcV2WyhQXOot9RTk5SbQzbw0ulV0sQFdEvNHUyxnGgGeSbWVDCwZodm8Xz81Hzy6ZD75W/PzHcCbzHI/Z0e4PgOuzwF+fPfrkaXg+nPAP8yyjrMMxJuvwPVtwDN6JZ+s1zGIxHgjPyPHlEY5pXfCZsN8suqoCnC/25QdXjk/z77Bd/XivcyC8ruATf0rYW8lXjcypOxmrh67G+k0lolOYMtPoj3YCe/hpzosgkl8MClbjAacTqyVkkqAyWI3BmFpSaH5EIB0czKhLx7F3k/en2cW7CC3JXiGkosFhv1unLqKEaaRaucpc8mZr5JANa9XCkdx9jBmfFRNp6WAQmFbfTh+ytT4/dH22pr8dct6upo3jJ7YN3fqurUj9ULBqmuE8r7q5ua6plaWE+6xGSdy8gZaly1//uyNHz151W7w63csi10IeJcN9q9ardbe8d5GoGMO8ZKvyPbiImaQXE6m02t9jqLa11RCUD6IIh46HXfd1wwkNT8ateZHZS8qlv5+altk/Bq4ffL5s2DgjtZSXwV7mmcFHsCkuMNm8Vq9Wjulaal2SmGRE5/UX/nhRT57SsMlm0946aruYx6QIz3nuaAMhsmGNQPvswcTTUJqH+Z1GBEnN2MyvyJ72pqVf+WaPJZNWfNBDF6Tl6S/UMQ1vmaQr5mLefBcl90mMp5NY+KxJdd24OLKoKFFi6s6PGX9/1YjzRSsV6qhZRyGTA6Dj9woZ3qLmaTPdfH8t8JhZSDH3Iuf4DXKnNnWDCwJnVsOLTpkWfKLk7LNZi0scOc5IZix+RAp49K7uIivUre0ZhFrpRD77eT4LxnXPOInMwp+PoOeYXkmdjtPXAqvYvgUv8d0l8TI4s4vLsz3u/02q4JP/hL4LBG6pSD06dRYLQWZd1IMjkAGSQF9lW2Av7CTuEIuxWoBCMpSS8nG1UiKCavtdrtNPUbGKr4lpnaqsyl/lTy8kxq3x2JqBRF9TiuF5LxzPfOwu/gpjlotwojHCb6slQ81kfSM9ILRoj1aPpZ7o1oOL1hW4lPaIbT0uyOeko8qOXqXkrEvP3nQnBuaKbnq+NXOHHg9eDy4w2A5+Hpge2bmAWo8ck68puBwz8Pz94uHC27oemR3Ce2lj20vjT3NiJqzpv8O+gRz5KvlnEQnKWbLSe/ftp8U1U5yTykd5kY+ubGUuVDraHBV/r8DF6qmZLhOcN8hGSz6fa6ZNLiCPMe/UbbwHD/RaeAJ8anzOqI7thR07uRP0kGUjQ4OpDJzPB1IRYUlw/k9RYGlUbBB0WCCCiva1VzQX/cv7hMuMkoM9ZeBogJbAlxFCfiX+loa7G7ZCx/jF8GEzl0Cv0nZmp9X5Mnz5ftsVo4pVuMswnSxHkhG+niKFkjbpj+k+528Nxf4yAweOGgBpTvXaskB7/F99ejyQCWtT/d5ziZpvbrc49TmGChzjdrkVqA5AWkXWCaXfpyn0psFeqhHpEuJf3xGQQDbilzKpBFlQoHDhtMJeKJm9XzTBB9QcEVrVaB1X+RHwrNmdSzRsv9kt/X8Pvr4zDqssuc0yATcnKSYbJVNST3Kyg7nG3QMQ2EM5iYGpGSauMGjpSJ+DjH4XMpHk7Ir14VekKs4FwKNnGyFesbF1Ast1uxptPxa2q6mUXV/2r4u/HlBz27n/XNunN1tBq7OBgBZP/A47cNxcFRPtvNaUnGWF4VJOq0eLD8PLnP5gxaLxYAzHNWKNX1KWWlj1EST5shu9HgCBZ7aZnmgvvrl+EjZhm5XQXZ7XltjqDtPLXXkc7j0rJIVkzISIWPymhCYnSAVxEqql5x2gJH7tZkYBWIPhAShnDLji85qrRCTAyhrWiBXUV5TVR6piGA2z1/CbSfP5+nVpIQK73uZ09W3zA9YNK3sj9YFs5t3pGX15FBlb5uaxyvtinDMSrrzbMGlpncpMyYjwnnwCfPIcnlZWsdaXq4LncS/Ym4t1k8sMbu2OPRCS9r8Wnavdt7H52+BvGPlxmKYsJAjAdP7n8PFfdj0WVwCqIGUeVzMrOgAhT4PAX0KsOYmDRYIyF288Rnd2TiVdCkQufMTdNJfmk5qL/RiUnUr7dhp1BL6lK7sBL2C3E9ZDGM+ECwdxsk0GPNyE3TTX4JuGoTppPMo/dqp1PuW0rOtzGnezHvWc0kRau+iAnd+vFd8qenEeTieWIkAlhhPrAKx5JTiWJ9CqqWmFdM/avQS+Jy1rwvNHKYycrPsKDVnCXpdyrw1LVwtBluvhzB2m8RbxwxLjFwLLPmVRaPX8ni3XdjjTh2/Zrzc+DXFsXY5JbMo+aOhpaaxfajUkx/CRIXBmpkvdrgLlpzP9oOCsBcAMHnCebWGgy4lZv//W30b7stqsLcSKSRPy3bsUcQcD3FRCbyynGwmqj5jQE+xmhJPzYcHjJzqGdrGSLABvNUaHJ8A5hsu+V34Fl7AMwrjBozt4Et6bF4Rtl3ui+ACeYwGSvJzledR4TA4Q6GxEEyxRCUT388cbTd5d59LmU6dNFRvp7KL99wz39eHO7l99iB9LnYn37ada1aZ5TUXP9u2Cif54HxhsEV+2Kd8fLaTGWDMpmD3+8G8gJWMF0FAWKrDwFuaAoB5QUS849DhDyR1HCrFpmmGJzGKewOYl4Lq5pX99VWxryhTub+1pb4nEreRFxSdY+Cz/nwkTAblPsyHOiF8pGbKxGzeAATbSKiEQRrGZrNoDFW7mCQWAX8o6A8HwgH47c1Bs6ilNFMtY/TS0wBXuIYQ4orW5jWb8jy7DqdMBiw3t7YC5K7mpqEG/YevwdSm9AROCUzUDj8U76TINmeJ+t53rxx2LF05rI3TSCrWfVQdpaFW6b6Z0EGL8t+JjHKhOz+Pw/Ee8t+egveY/1ZhWzIL/KqiwdPz35u1uRt8frpwH3gIQbJJ3rB4grrfV+gRpV4iGYEllZz2UhPVDcpEdXc+Jd6i/KA7mDpZPeOyk9UFn/I8tajLTJecsn6qZ1QasLd32gcNo4snrgtsYoW5t9e8YkLJTfG5i0Iun7vYTb4jO51UyIhPXxT6OzvaVogmdQBjuzqAMTN9imIWzcgwTROTCTB8t1mMHdosxr/iLpOyv7WFkna5pbu1e+nxjOa/bjxjNInM73lU4xSS3il3OAeksfc8tvFHm1aa16wxy0pPPnaH/Bp4DJ9j55Hz433FiRoymy0xZ6xReSpd3SsnTmRVdldWdrMLT2qzCymPAb/FLPE5+IvPF741P8/z/6DHcM48+L868AaK5AKjQYrXuF9q3jz6j8rM+dhWXrR28YvshOa76nG+ofAtkqlMyFYmHOZkmw2S7t2GHHJXOT7o8J/g1knDDtljuAJT5+I/DfC6yOBjTipSbM9zA5M6+bQ8gabBzp+Qhm+pCmRd8oeTT+T71UcoKMgJaQ6Hgufj3McAYdZ8DI5zFvoUGaZUnwLnO94iLMP5jlgT6DHgiGykAtMem7gtiQr5/pAy8DyZDrY0GOIkMaa7Osn0+Wg6NCzpGQLZfLa9SNC2z6Xvrj+VBCw+KFPF3l4Z8FdW+gOINA1rbKbieo7PsnRix3F8mqXQm8S+8WlxS6GaGMqZwPIT6nJJyNEGdVXK7cFF3jcekv34FD58Bp+BKc3SKWg5HCrTNkhhzMuAAXB46RuxQzXV0yfO1vwDtb/l6W+hE7G3J/quwaO1hQXApx/wseO945yrPuwvI4V9q5LYdzmmBAEfXABndTo4JuU1G+blmn3qxM573QNRutMceznc3/XL0ngvw3neBxaQvepTE8CbgtjuPT07AZuDkpsTYo+hLKb0I2g1vcrZlJKH3Kd4kDmJ8ZuYjGS97vS3BG0u9d98MCeKedLhUewVPEJJPTCaU89QNDo9BHRy4nMLVDo5gVBaTJdKLSSX+lCLVHIpDkAKxY6o3kkK0d5MxJUK3ZQ86VbZkqCPCwgk6rRh1ErjaYJI+jiRCohO0B1Lo5Q+TimIP5wOjVbSkrRS3ZZkcj2szgdLoZgQVJwVkugZ+JHa++FG2QSXCpwN/V/WAFJEl2gCealnclNT18zU4taA6qKnyh/xf6maw6KcyYyq5255CEtergviBv1fcvjGIUk9UPlk77pNrd2bplKPUt4seqb8gu/pamVu8cKbwkH2FXA3isi/Kpvmxawa+G/bMMtrmDZSgwHzFpTqpyXKgwY1b9yQ+kWC38M/jVPgqgwrl/Awg//J/ZRxHns5eI0m1qJe8mI8d1OuJUmXyrXaVSR+ERDpctdgcZS5qDDgtVgtVqvXx7vqkJVwA6nXiS2iegmc9EROw0v/q2/oQx9a3UOviP1LxPiP/6hvos2x/rK6Uw9+/ER9Of08XX/62otvX0uPdR7dcqx3S/bTD3/6uez4uaYwDbFPPo9+7lfKwLLtVC+iE5+hZ1i+4ubvGJLemVS+6ON1FEayLQNLRcRpjEyxMBfdehQgXiFSEf8S7Iz2HXKJr0/KNi2O8gV9WBKWg08ECy4qBVPGGAM36eqVaigbjw02xoOCG5tbrj547MSBw01Ne3dfE4tetX//Va/Gp6xv2nTPsaMPzMzcfjSDPfbY4/QAD6SUHM8U6HJ8tkoudk0oT1fJdTmVGqO/6BkrvPFq0XNWXsLWq/RnrdAjim/E592Cns8CWdutlPNZkybeWnKyDSIOvXWkDb2FD8AC/M1G3yLkKeNvB/gZgzICl/aiatdo9hCnmRvPFhWauYFoSbHf0pRzKKTj8edSpFO15mLqLRA1QZZOQVajzXjEeVa3gM7PArhuUCjiBHKJSeSyA73A+Lj5B2zxByohnUqz22Jq5iupyCVJ+oQTaYoGLI2mCkopZL1OMQQaZZlei1f5c3eAH70Qr9bLtWlP3gkG/Ck57b/o+TvcIlzmGTyxh4FRL/0gHvqSFi/wecjAs1hFy3PdKRORA35fUtPiXzkX2QIwX3I2MrDopccjM5fqj+AzjQT+TKMI5qJcQNlcCSgbDunxwY5UR6qpqNPxMUFKhRQO4ZmNE1sYjNRWVfjLglZ0jXiBZuiydFbHniSVazaXVxlPjnGqN63euyVO9aax7dsP7KirW9Uqa4WbUxmjnPzVef6ZFPKvn9iXUaKrDdW2xucPZS8IfC51HeLFOQbxCgURr2rAq+pyeE0Kg3U1leX+0qXxCr0HtKzY39/V3jlQHqlade7A5l2DDS1doYrq3pHR7auVNn9vsU/Bqq2vwe8pLnKUwlZFV4dxq+yuvu6eMY6UVpuqycFDfFZci9yUJgclIAiLzy6SpKEAxQFF8T2Ig6pxLicRZxTdc2mhYMc11zMuF0GQi7ByppEiF2EQDA57UjvtZGK+OpeOUDAhH/r3Ih+qjrmkiAQVfXMZMfm+5oQy5TlbQHuJmNHnM0MMpZ16LHrqliPxGEPlsVuas648fSt2reqnK0/h0hx0xueVf1joxHgNu0aDpgxBQgdd6eyVmF7adonR5fl+ZXg5ZoSXHF6engdInWVelJ4PSB9uzj69ODeg9TX+M69l8JMdioMZwKmYIk7FRO+G4Nn14iZHN3hN2tdEfMCzfolOyEnZTojP63FjmdllmyEXjzRJdEJ+LmWcyaJOyC+njzSJ12gMw5I46fZji2s0AvF5LOrEluGlCzWKeX3kpb67qFojlDzmheikS5dsZNpt/gAv1jDymbPpxRpLdI0kl2s8lNIkklaqMp3aFhLf5x/xeDsXn8cCTg1EjPq/qHFXCb7i2/OMGnYt2pghLepS9uOPEHMp66+RbYn9UCH5Hyg+4nAmE+12NTBLq255TYvMBLV/9gS4+naIzBrkOq2Dlj+1PFGrkeiiLciHmD7blKF00xpSumkv0eKr9de+lt7hm9Rpu8TsC2XWuNLbi3OF47O+sbtX6H2Pz5DjE1zSxot/D/M02mzxeI+vMlu88t3We5cZ+Xy91HHiv8bsijZLfF08r6Lgdx+sZ8EO66Rp/MrZxdySGNpsuCbGLAkcQ2ouOg3PM0peWkP0yaS8oYKr8lyfaTkjsbaiEYu0CpKJgSXRdsuedCBTPp+UjaDeU+H0czi1XGMKha5U841xIv1UATV13nwjNlwuOe99KTopw95Nf/mw+SQ6Bd/b+qOXW/99D5tXZ4reSOeFWrCl+XxGYDbvOOCPyj1oo+oYWrWk7zvY13+6hn13bfTw4agCv5vtp/nCDGhpKynjdyjS5tESPo6WxKfRgn6Oz8+0KuYpWRlfkV/hTihggdW53XVJKpfDejc9IhQCN6vPJ8jJZgLDCtXLP58gy5RhEBmxUIs2BJcunrnGfErxcalWhVzK7k6Z9UJJDuj8AvYWYJonO4FOpNcKu6QQq4MMWmiGozxqi1SBliyk4HThw1zDfiHnc5WurgHL0RsK6voab6prKxBvMDNTS1PmBsvua//5e8vLur7797HlAHkp3H8W4g4rcOUyOYr9fAblVAE8cpHotmnHotGBeDdTk6D0MOXacwM2n1Uy8tHkXnz8AqBXrB5+6eqi3kJaKtLPiaOrNvS3z9KCex44eeudtOC2jNiL4iBd7Qjt3SYPjV/4/Oe+/Pia7+/fmjq/maTNaf7LP8uHz954DzOh34hV0O8lrmEL734NW7joZq+p15TRX5BvsAWSQeofM/I0v6J4TJoErUGPKydxt2k+GWHyUXV+LFd4bTQiOZ8rl8tdK7sCHlZaVFq6ovqWD+MzFyroa+SbAp7k1T+WQZUBksr91eBiDeX3j0+nVZ4QMfmoI3k+bTYFxzNSIZfn8gWeggWKPLW4AkJTsbCZfJMchTXwmcva8zxT7qfcLbrU3RqTbsaQHvQMp4eTtD7uMLIESbLQF6BTeOjEiWJTBsiPKQPkcTgm0OVxhyPpsREKZVTZTaXS8xVymXNld7AwQa4wQlJYc8uH7YrOANrR2zntXACLM4MlyJcVX1QhoA0/A4zjICINARaHVa06j+O9JA2+WoFQITAJ0nJoCuo4NAxpTG/jNM7FMxqXAswSqzqCyprR1DUjSy1aVKzQIrEF4cKy0qLiKoV3Wsj/oT30X0Bnavw8nuBAO+fnRlUp2v98cHDw4OD/GWpeNjB4ECSgGnTES+Qublc9fI6w0sbFx7aM00E7/mPlD2yKNwQs9RdVGwMWiPLK1Nd2X3W1T20USH5F2CqJl9bxWcD6C2AltHny6iR5bYa8YleSv6uPzwlySJXJQ4LxubWATxh0ng8rUI0QveOzVPOpQXJTo0HsFzFjyAcCZ5qYPoNKBgj4kiJ5g4EPQxg3opPtg8iouLDAh5UrfvidhXFAgz8aWUG1HBvEfhj/4TNpog7UjGF/9Iox20Du2R1TffX1Tde4f2r9/vO2v8/sautv7x268qR9o5XWD/defVPtqO/u3uG+1b01Vwbnr+/j9bO0VOhSnjON+jo3xyAYUEbhFzHQoxIeAt0MdoI/MRhfBTLF0CYNOSAy5RGxUe+JR8QuvxMYycaf5GTzh/nz2unuA7PX0g2HwFeWNuTMD4odJ82bcCry4DDbGvsabVm9fnn18/T022/HDn01siz230j7LeA0+NhZJSqXuPIzGhjtRZPVk64/y3OYHvWn5CyikhFsll5yeQXfxXdoacfa8diPaWB8bUcp5kDtgqd/Yz/tol3w4hGUfb4ecMtgz8JaDtlq5qeogkTw2OegheodWEBnCeuzcRSwFA6F6cL1grt/YoD20t6BG/yFjF2Mgftf0jU8QktiL48cKC5X7pvAgT+ZI/4MRVNGKg5cPQ3hczCJmZoFvZ2bgig27BqB4xqjbPvFdwB4/+DIOA3Efjx+VXUhtV8h5I5O9Meeij3VfyRi43gs/BLweBDWA5nKNOJsaiqRHtSEB5Vye4b3trga26jLSKMupytqoQtCXt+GgdiTsScHbihzCezBiwu0VB4dib1CwyP7S/yU4TMIioBZLPyM3oR3xyoWplNmfxOKp4oHrU7chGAkGvZjqhvHkjrFa64Rr3nuzGOPnXlky3/+13/FPkUn6frYp9Tnc1uZFRjJIpv5E57hZgctfCMtXouXWS++gT/qc2KZCD6Li0zJGdlUr8uhoj7xnFi1Xm3NAOpdcUriz/BTU/BKE4he1Onnlvh0UjbZsKpArbnzciZWHwqbeL6Ol4k3fmp+dHTr3Ngq2I36EA2BH4qPhm0amgqN5flKGpX9NnHf5y3iJU8qYWu2p4BRSaL84QgGftaU9I5oELTpRD7tkCztWbcGA/cAeWpFQTd0iW/yuUT4dS0Rg/kayqTFj8dN/hqmHAKcAHxenCde9bD4IbnYGoWlEKzXXV61rDMUqQ1cad4MZNk2W9+1pzBz0wZrZwfLyvKXNCrPzW0a3GSzXPwAPnbl/wGOnsOvAAAAAAEAAAACAEJusQvBXw889QAfA+gAAAAAzg7u4QAAAADWN/0Z/9b/AwPCA9oAAAAIAAIAAAAAAAB42mNgZGBgkfrHw8DA/Of/tf9TmA8xAEWQAaMmAJgFBoEAAAB42m2UzUtUYRTGn3NeEs0pUxmYZgwza1KnaSYShRQpUGc0B/uYaCQiCgQXbVq0qHamtQoGFxa0MfAPaFXYNvoXglr1hauKNhapdHvO671i5sBvnnvfz3Pe57xXbqIN/EmJf6sbCJCTZRQ1jyQ56GZw2tVhUNIoyhBaSEpeYR/7xji2Qx6j2+ZoLSps6yAnSSeJk8MkHb7323rW5veAHzto65jKLxxw6zilpWBNb6GsA8hrlRpHWb5S7/N9gc9ZciJY0SnqOsouieO6yP4X7L8Q6iQ1h73ahJjOY1TPo8YVGXM/oAPBH66ZYB55i5l6VPcz1lrskX6ktB2tXGdcPiCjl5DVNDJyFfXagiYtsD2BPkkEnzTB5yMouMsYt3Yd4XjOszkyi5J8RoPcQZ2ewaj8huoyYvIjWJNVqLxGM/dtlBk8pLYx/x4fE9sjD8Kz6SIxIjaWOiTPkHLtOKsVnvc44zMf6IFOo0cqjD+PXt9WRRdp8TkNM64171dO8vSvyjEVTNh89xy9ISl6kPXnvwMuH3z3nsQ3PImgH42kWbLBF/JR59Cw6cd28rji1TzZinlykXMmGKed/w64EbR6T9L/Qj/qyG568o68pceZTT+2Y7VmSk+2Yp54z00tX9uTufr9Iq36+LI+v2tUy99iiNTqkzXCsxhmPGOszQzro8ZqVG6j4HUWBY1hlxSDwJ+RxRmpnQtjcwvocw+43qQfXwr1kNWz1dR/yhqXR6yz+TCfSKM6Z01tV3lKr7vJE9ZGnPdiDp3yDXDvWXuRFvk9+EkWQ+6RN6SHfXbnQ3hvkryDSaygixwzZIm1t0R9SaaZjyBnc4XnJteRtXXt++Cm6esMbpC7kbK9lTlBz/HOTaH+L6hoz3V42mNgYNCCwxCGEoZHjBaM05iEmLSYfJhymJYw3WFmYpZhtmL2YW5iXsf8gsWOpYBlBysXqx5rA+sxNjY2P7Y0ti62RWwf2NvYt3AwcDhwVHAs4TjFKcZpxxnCWcK5hPMA5y8uNa4Iri6uM9xs3AHcBdzzuPdwf+CR4XHjKeGZxrOC5xTPB14+XgXeKt5HfHJ8dXyH+CX49/C/E1ATSBGYILBDkE8wRLBJ8JaQm9AEoXvCYsIRwnXCm4TviPCJWIm0iCwQeSOqJ5onug4If4jZiLWJfRO3EE8RPyb+RyJP4pLEJ0kRST3JOZL7JH9J6UilSe2ROictIu0gnSA9R3qP9DcZCZkCmUuyCbIHZH/IGcgVyZ2TV5KfIH9FwUehSWGHwjdFN8U0xTbFdYrPlPSU2pSOKDMpeyivUP6nIqVSoLJC5YGqkmqZ6irVB2ppaqfU9dRnadhp3NAs02rS+qHtpj1F+5VOnk6fzjqdG7oqujV6Qno+em16J/Tt9JfpPzOwMmgzuGSoYbjK8JmRjtE0oyfGEcaLjF+YWJl0mFwyDTOdZ6ZlVmJ2zVzEPMv8isUci0MWNywZLA0sGyyPWX6zMrCKs5pidcpawzrN+pANh42XzSfbKtt9diJ2CXaH7CXsC+zvOLg5LHFkcTRz7HP85dTkdMhZzDnFeY7zFRchlzSXZS7PXNlcbVxrXNe4fsEO3ZjcBNzk3Czcgtya3La43XJXcE9zX+C+z/2P+x8PIQ81IGzxuODJ5mnkmeU5w/OA5zUvLa8dAEIzwdEAAQAAASkARwAFAAAAAAACAHIAhACLAAABoAF+AAAAAHjalVTLbtNQED1+8KgoUVmAUFdeoAqkYtJEohCxqSCpkApIJAIJsXFbN5g2cXESEFnxASxY8Qks+BIorNjBJ/AVnBmPoyRK1KCre33ueObM3OO5BnDZceHB8ZcAfOHMsYM17nLsooSfhj18wB/DPm47LwyfwarzyfBZBM5Xw+fQdU4Mn0fLvWN4CQ33o+ELuOf+MryMda9k+CJeejXDJbS8z4ZXcNX7a/gSlv2i/m+44hex31H2rxk+ob1l+AdW/Nc5/u1h1R/iARK0OfucQ8TYR8AZcR8R7SHFMd4jU69XtAa4TusNPisoY4PrTUNVrNPaolfM5yNGDhl1xCFM97nPyCVrpNlSdGmPuO5rXEzPGAdqT5hDopoIscXZoCUzi0T0iJ4wRvJIzQkG6OApcZtIMmbMKGtGvoT+0/ljbGOXEWuoMz5WzmN6xjjkzMgmebrMvo0a8yxWQW2kS3XBiGCq6meavTfSp8LTl5Wx4CvYhGucaX6+RLG86auHnLej2Q5pS6n5/363cErdYIa+gSkcUOPgFJUD1XkRztO5pEv7fFPDLY53OkLVaX5MqJ3emRO7N1FX4bujXZpz5vdmoL0svKJ0rucW2SL65bvJGLkvs7/37DqiMa5QVWnz7dEEZ4+WHTykdnU8ZifU9X4K57z+GO+h58S7dgflrm9oZFNPFpAvxVu13tVKK6yvyp2sm6PO39TaD5hjwGfKahNl66lumeo/4K4xytLEG1oS1Zh/gX/xR+EOAAB42m3QV2xbVRzH8e+vdezGrbv33m06bSdO4m4ntjsIKaQNI8xb27FNnetw40to2AJatkBI8ARivQBibxDwAIi9xEaCB/Yq4gEQs+D4XBCVONI9n3P////533MPI6iNQweJ8j9DDdVnhEbKx0h81OEnwCjqCTKaMYQYyzjGM4GJTGIyU5jKNKYzg5nMYjZzmMs85rOAhSxiMUtYyjKW08AKVrKK1axhLWEi1a830kSMZlpoJc461rOBjWxiM1tI0EY7SVKk2co2trODI+jgSDrZyVEcTRe72E03x3Asx3E8PZzAiZzEyZzCqViqk18BbuUiLuZJruMr9nMVl3MDt3ObRnEZH3Ih16peQa7kei7hGT7WaG7kDn7iR37mFu7iRZ7nbvaQ4WqyvEyOF3iJ13mFV3mNr+nlLd7gTe4hzw9cw7u8zTsU+JaDXMppFNlLHyVsbqLM6fTjMIBLhTMY5BvOZIh9nMU5nM2j3Mx5nMv5XMB3fM/jGqMQf3KIv4TGapzGS5qgiZqkyfzCr/zGe5qiqZqm6ZqhmXzCp5ql2ZqjuZqn+dzLfVqghVqkxVqipfzOH3zG51qm5WrQCq3UKp7Qaq3RWoX5gi95n4/4QBFF1agmxdSsFrUqrnVarw3aqE3arC3czwM8zCM8y4M8xHMc4E4leIqn1aZ2rlBSKaW1lce0Tdu1w58v7esvRAzRgGsXw+Fw0tiaMsY9E2FPL9/m1bc1esYDiXK+bOf2BiyjP5mxnLLtzxqSGadsVQIpryjnFaVMNmfosDJuJecvGTpMsFTD15EtV3yl6uTvNGnb0Gmq7BqhnQXXzluO21ey3Eqo/N83f5fZ4Bi6zD7HsMsEBwy7TbBSo67bKdr5Ond4DnUf1t89rH+P2TxUI9hTPaqVyeTsSnDo32X11/r2ZK3anTUlW4eNVi/dM+IZ9Wz0bPKMeTZ7tnj+0yfumTBGvL6RSLC3mHedXNYaKJhQNG2MpX0p1ynXW45THizleiuB2srtD9Z0ivlCxSSz5UG7tieWbh823WaOWzX6N88BNdMAeNpj8N7BcCIoYiMjY1/kBsadHAwcDMkFGxnYnRw4GRgiPS21GdgZtMB8gTSWOBY/DjsOA3Y1VjkWdg6ocBZTElMYmxubOas2sxITWJjPyZFT8oD4AeED/Ad4HDgPsB8AmsIJlBAFSjA4oECwBDODy0YVxo7AiA0OHREbmVNcNmqAeDs4GEBcBpdI6Y3qIIFdHA0MjCwOHckhEGEQcBDIYEpgCmBzYDNi1WBWYGLn0drB+L91A0vvRiYGl82sKWwMLi4ABPo1hQAAAVoSTJkAAA==') format('woff');
+}
+
+
+
+@font-face {
+font-family: Fira;
+font-style: italic;
+font-weight: 300;
+font-stretch: normal;
+src: url('data:application/font-woff;charset=utf-8;base64,d09GRgABAAAAAG00ABMAAAAA8BAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAABGRlRNAAABqAAAABwAAAAcejWA00dERUYAAAHEAAAAHgAAAB4AJwEvR1BPUwAAAeQAAAyQAAAuNi8bnAhHU1VCAAAOdAAAApcAAAeEea4ezk9TLzIAABEMAAAAWgAAAGA6fflYY21hcAAAEWgAAAJeAAADfi1PSJpjdnQgAAATyAAAAG0AAADcKyMSHmZwZ20AABQ4AAAGcAAADW04JI58Z2FzcAAAGqgAAAAIAAAACAAAABBnbHlmAAAasAAARwoAAJPMRagL2WhlYWQAAGG8AAAANgAAADYG4y+0aGhlYQAAYfQAAAAjAAAAJAeRAyJobXR4AABiGAAAApAAAASkTX46ZmxvY2EAAGSoAAACSQAAAlQO7TQibWF4cAAAZvQAAAAgAAAAIAPMAcxuYW1lAABnFAAAAkIAAAW2gJDANnBvc3QAAGlYAAADDAAABL0OhfQ0cHJlcAAAbGQAAADHAAAA5wgX+o93ZWJmAABtLAAAAAYAAAAGTJtaEgAAAAEAAAAA1e6U9QAAAADODu7EAAAAANY3/RkAAQAAAAwAAAAWAAAAAgABAAEBKAABAAQAAAACAAAAAHjaxZoLcBXVGcf/e0kghEcEA4RAQkIAo4IvFF+oQOQh6GARX3SsLYzjtDoOQxlnamnH6Yxvbe1D8RGfVUTxkbHFB2pp6fURxWgNbW9t09qIZDqu6B3L0nF1tr9zdu8ruTfkcWn3m//Z3XPOd853vu9/ztnde+VIKte1ukclZy46e6Wq13xv3ZVqvHzdZVdozpXfWn+VzlQJdRQEinFyer1r1ND5qxbWqbFp/kqTrjDpOcvPJl2x/BzSlSuWkWZpxNas/e5ajb7isnVXqdLmyKaUaKhG23uHElN7iF4bsrnM5b5cpUg5VxdoumboMNo8XEfoSM3ULB2lo3WMjtVxmq3jdYLm6ESdpJN1ik7VXJ2m03WdrtcNulE36Wbdolt1m36sn+h2/VQ/08/1C92hO7VRd+lu/HKv7tP9ekAP6iE9rF/qVb2uVr2lt/WO/qB2/VF/1l/0V3XoH/qnPtRH6tK/9LE+0adK6nPt0379R1/oSycmJzbHemylntVO7dVOp8wZ68x0TndWOt9w1jp3OpudNqeNUsTZ5byPfAD2OF/GYtoZK4uNBWWxutiMGIf2mrpo7MqS9zNC2fuxGCjLiJ4ljRmk6tr2EGcP+TPR2mssw7Y20qEaF3RpfNCpCUFSEwNPk4KEagJfZaqkZFywhVJfVZRUU2MSNSdzrglcq+tS2oWui65PaZvVjXHlOg4lQ9H8zJaF2km0PVunBG0PbS/qNUnETTtVti1T16VeF20ZC2vIMRqdUf4XtO5rODYmNQ7N8UYbVAXttr1qak22NVM9TbD2Ja1Vw6O+k+R66CRtj9WRHTWBZ2s59s5xHFWY1OSQxunlGdIW/LSV3l4K4uTaeuib1E2P34fTo3WuJulSpw7OOdZ6kxoflapWo2nJgS8VOkRjNJaZMJ5xVGmiqtGarBrqTFGd6jWVmdAYMf4kuH6amrRIS3Ue2hfqYq3SJVqtdbpaG3L4f0cW05vhuuH4I3peL+hFbdNLelmvaId+rzjMN6z/ULvlwpDPYPd+hhNzxsDhcU6VM9GpllPaaBk+StOcZ52dcKrS2RlbCq51dpbMKJlXskprVGa96RMBXw34aTpxO4zrI8FscAI4kTonBS06metTuD6V81zqnRa0aiGeXEzeEnAWWMpasIzzeeB8cBH+WkXe1/HhJZwvJ+86dK8HN4AbwU3gZnALuJW2N4K7wN3gHnAvuA/cDx4AD4KHwMP0/yj9bwKPgc3gcfAE2AKepK+nwNPgGdACtoLnwQvgRbANvAReATuwLw5exY7X0H+dPt4gv5Xzm5x3gjbwLngPtJO/i/OHnHdz/ojzHs4fg0/ApyCJ3z4nfx/YH7Q6scB3DlW5UwnGgwngMNBIv0N1CL2OBU3wGt47zGXHcN2U+JT4lPiU+JT4jonbCFXA9jH0VMe5HkwFq7m/mnMzeDnocih3xpI3itp+uq06UA+mhu2i4aPho5HbR0ortC1Xy+umlbH522h1oNWMdZ1oNqsWC6ZYSztooYMWOuBbogffmqi7EMsXMwOXgLPAMvA1dFdYbrlaafnl6gLOF4KLwWr6uZy8dXb0HbqG8wbLtwR8S8C3BHxLwLcEfEvAt0RBvjWjbzj3KHZsAo+BzeBx8ATYAp6kr6fA0+AZ0AK2gucsx1w45sIxF465cMzFQx3wzNVvKN8Ofgt+B17FjtdoL+SbG/HNhW8ufHPhmwvf3Ihvrv6EzgegM809N+KeK5e8veAz8G/gEXnDOWIAAzqJUDMRanZYRYlSs2VWnOjE8Xqc0jilcUripoS5OxY0qcIZB6pANfezKakNo8q51q57tdSqJWIeEfOImEfEPCLlESVPq6h7CQgj5LH21bL21eJBDw96eNDDgx4e9PCgh/c8vOfhPQ/veXjPw3OedqAfB29w/SbYCdrAu+A9sAvsBnvgYGrEhwYtTiUYp1pnPOcJoIrriaAaG2KskuWIWNFrWOEfQUY4Zi8ZqVjD7WYNnaL6JVrCs4uC9qAj8IJ4kEQ8JGl2RVbOjqCLK8P4cnbWCnvfgaWDOgIXVog2s/M84NOzT9++tQBJ57vWKm+A/fk27QgSSLJHKeOz586gDcb20BvUSAtaHPq5W18Vg+zNjo1Yhl60cbQ5XTleDv1qnjgSAfuUiYaFZ9fcA3qS2dhPzw9yVJ1BK7GDdVhXoVkhR+FjZKvlbns3Cyuju660j8stj/xC1gdbg+20swWfbMvy2ERaTxgd89TFk6iCbdTaxlzIM8bc0VpL/J58i+wyMUh0j56x0EbItzMk07JnZks6nslQvzvPUrqFZl3OXa7HuvGe9jN9J4L1tu8MizpyGded89Zfnd38UdtX/qZmR7/mdjLbs+SVBvuiGeBG7bnptSQZ+ik91mRu733pmZUCDtAXKwa86bIrlGvmki1tNWJW3pCNlCe4byB3E3Va0N0emB2wMthua7tRm22DnCl+39aeA863rtTahG1eNG+8iJtp39kSM+oksa5knrDDMc52y1yzlph1KJp/+WdB5H83ZXfuOtUtwn6K/6ACndbUPpKa3bl1C+48bXYHC+1qsBzxM/3ZVaYjZ2Z44Vpi55zbbS3xD8iSOB7piNYXu4NZ/ll2U9ZhrEnP23bLklryNmLFNiRhfcIub9nr5s69PDtKW9CZd38rzJXySDPZ150Lq+J4sSVnvplRWZ/SfyLcv9Nrh11xU+tutsciFtm9vV+7aK3mZt1NzESfY260h5ZHZY32ujKdU05OtDfYsgZy5hbut7cI92cfPNDzUPGfLwa3MxdzbIXnfvqYn3N3bsjyXufXIpsuG5BJDUUamVd4r/1/HAW4UDmYp7CB82uAHvV72eO78qx4fjZfc3YNr5deugYyLrtX+33wZUN/fJhZKwcWje72HOgJvsAxcaAs6cPszrMv5nqyQBuNxXmfiNYSr59RS+Z7V+zDyCsH6BN3IFrFeF/My0k/fII/ABPLD7qFB2ZJwagP1J9FjENpwZLwbagip2ZpVlmlfZZJWdRq3tZ4Z0jmvhfZt2IvnE89382KvI9/lXr6zm6z5/PcIJ4TEv2ztlhx4pnV7wsTbdocfFocXhf+NvA/OhqK5r3W/n0PHAwnw68zOW8jtvdga3ZeX1lSjKebwbfBmLqyv8eknmzCHcG8UeV57klmdvp8b2/93SEzb+B5nzG8zG4Q/LAYfur5ZfLg7yEFv8V5g32aMV9z8q2+vc+AYEtvz6h9WwEP9vtH+C0odd33VRmPeP1/8wy/MvV/lRgY/8NvQf1hUXoODIwlramZnDvXC40o7C1oLmxjLyXJge6mxfjNw34bNczZli/qRX2nrNRxRdnxGqIvScWbOd/sJzuSGX4d9BVxE2tPe3BbevWP98bInvtP3+ZAsD5a5+L296V44fjn8hj+tOXnZcrKFLPtm53bY8Xy+rpWFdoV+j4HmGXm22ei8Irc7VcXP3usve08qd8+ixr3liI0ctwASgof59v0RDsDeA7P/QXE+iDMd3v+NpL9xpztvXye7HY4KnPqNSK6C78lLtZ8LbBfIsuiOuaosfdlmocstrIwKo2RO0Ql0VvbKA3VMHtVpuGgnNZHkjs6/b+qRVFvpodxtDues/mfVeow/7aS/b9VjX0HNP+5kv3XVQPptEh/AS0VOprAvOh6cVZ+Ku/MvFpDGMmQSFJHWTTqUBaDUZGM4boG+zMywf5fLJTwS9LE9DhCWWxHFB71XNdbD5j/W8bSfRk7Jlik3oKH4Y/Qo5PstWnToMy2NgEP11qMwFMpjLSRCGF8Pi2N7JEVPhYgZyDzo3SejVZTAc9Ninh0RDrnWPsWXw8X6rvVTY3yaKTUiol8XZZFZanvcNFMSmkcQS+zbIyqYdtR6X5MD9PszmVkTrS7zbbpdKQhwpE6gXQ4vppBekykPzRqKd+uOMzamfsFY3pW3tR0zbocye/bDI9KwaxISqyt03KkIS3mmIKEY0hJqb0PZTg1htPnNNpssFA3hHnT81g03SKjFx7mv70pmLk/izoGxufHpNE3Hg1Fjkfqo/RoG61hWZ7LHHOQGD2V2TZHIo79f1KMZ5tK2jHzahixr6Z8MvYOtzEdY62pwodnwMMmpJGVabEO11laqplarnOpsUIrqXWBLqLeKl1KT6u1RnO1Fjld65AzdDUyTxuQ+boWWaDrdDvt3YEs10a10NKv9Gt9R8/pFV2pHXpd69WKXKO3kO/rbWSD3lG7fmD/qfwj/U1/p5UPkBvVqd26SXuU1K36HLlL+5C7tV9f6R4n5sT0kDPGqdbDzmSnRk86jU6jnv4v2S7vrnjarZXrS1RRFMV/d2acatQ0s0mGCgszK7Mye5dkqYT5YhokRCLR6kOiMRoVREH0zt7vtz0+Rn9A36MiIqIiKiIiIqIiIqMIwdZ96C0JGR8c7l733rPXOnvfe/Y+GECAo7zEV1hcGiFUtzXaQPb66NoN5DfUtjRSiU8+dHZaaODBG9ObLPwF1UXpZC0riJg2bNqyilLZcEWZbCS8QranTl1tQwuhddHaOtKbovWN5Ddv2thMoeWRJJvYvWIcfoYwlGHKIJ4EzZg+wy0LI8ggm0VilhKhhnoaaGEbu2jlJBe5wU3Lz1D2fmEcl2k3Soydxm3r2TA6bPRkOljlYKuD92z0BhwMO9jmYLuNvnIHbzn41MY4v4M5dhxxn5VXgjLbzma26J2XUQQZLTSjTBGmkaf/YT4ZjJS3z8k6ScNDKmPlM14jsdc5m+3t1jO1GTRVUydZc0FyY9Ls4tkMk0ufeAYhXam65ljfMXmAeXR9bYMcR6/3KHAYqZqZoe8ZG8flBYW5in1BH5guO03eeczTPl/SR76rEdLeN9fPZynF/VBxlcZoR9uxFLJcddc/LVdvnOq7K64SygkPQNFVTVfPcGOsVHdYNUBdV3uCutHf8VZRzepBUHdXyFC3+zf2Gtaouw3OGvY6BlOcTkoMu///FeiLmZnirJtsdfYiVlr93fSGJo0AOzTiLf9gD3/zroqJZDJJZ8lkxT1VXX+aane6qnGmKmuW6mO2IpurnTlfu2mh/v1i/aPd7GEv+9jPAQ7qTDjEYY7oLDjGcU7ohDjFac5wlnOc5wKXdDpcoY2rXOM6d7jLfR7wkEc85gnPeM4LXvGaN7zlHe/5wEc+8YWvfOM7P/jJL37TYXiUW0BXkzJysv0DynOOjgB42mNgYfzHqMPAysDC1MUU8f8rgzeIZjBkjGMwYrTi4mDiZmNmZWBgYmBpYGB478CgUM2ABBgbGXh/MzEL/tdkOMEixfhFgYFhMkiciZtpLZBSYOAGAATdDvwAAHjarZJHTNRBFIe/t7uCYgNpS/+DLCA2sAKKFQF7RVEUxIgaYyOgsYIHsSMgxoKKmtjFXlARkUQ5eNcYMfFvLCePRhLBHceFGBIPXpxk3puS+d7k93uAlfYZjOiIFOqduPY2ydR5DuPoQh+96kkRh6hGibt4SZCESbwkSYqkS4ZkSa7kSb4UWZosby3vrHW2N4aH4WMEGqFGhBFlDDaSjByjJjwivNLx0tHWalHqdzXNNFzMs2KTHmKXUImTREmWNJklmZIty2WdbO7ExPA07EZwBzOxg1nuYopmivquPqlXqkm9UI2qXtWq++qCqlanVJWqVBWqTJWqElXsTHA6nJE/U9tiP1hNp9lq/jBbzG/mV/Oj2WAWvHe+r2jOao51i2rX5D8PN4uHS2n+oguWjpX1H4z2lzbtjBvudKUbHnSnh9azF73xxEs75o0Pvvjhj50AAgnSnoYQSpjWPJwI+hKJgyiiiaEfsfRnAAMZxGDiiGcIQxnGcEYwkgQSSWIUo0lmDGN1R4xnAhNJYRKppJHOZKYwlWlMZwYzmcVs3TdzmUcG81lAJgtZRBaLWUI2OSwll2X6//vYz0Ht/1FOco6LXOASV7jMVWq4wXVucos73OYu93jAQ2p5RB2PaeApz2jUhI2sZBVrJIBtnKeAdWKwhbX65gCnddzk0mk1Wztpt55iHa9Rzy5WkP/nfAM7JZA8SthLFZ/5oru8j/iJv3iLD0/EwXNatPRhEiwhEi0x+s128RW7znsoYzfllHKYSo5QwXFO6PNjnOGs7u/XOLVlha46ih3tBX8BXeytyAAAeNpjYCAT2AKhAYMBkxEDA5PV/+/I/P/fQCL/vzHYACFIbC1QDTdQ3Jhpx/+vTGL/v/43Rsj9/8H0HCj24/8UsOxzsPwUFL33kHTfg+o3AUItILzz35rh8X8TGJ/pAaM903NGCwZFpkoAvx81UgAAAHjarVZpdxM3FNV4SwjZSEhomZbKCKc01hhKWQIYCDNxXHAXJ0A7A6WdiR26L9CN7vuCf82bpD2HfuOn9T7JNgkk9LSn/uB3JV3prXoaElqSuBLWIikbd8XoUoMKl66GdNSlg1F8Q3auhJQpJX8NikHRaqkVt1gkEZEI1MKacEQQ+x45mmR8w6OMlm1J95qUm7m6dtDZGdRaNSrUwiJlS9HytbCoim4nlNRsYmo+ciXNMZqLIpladtKmg5jqjiQd5vXDzLzXDCWs6SSShpphjBnJa0OMjjM6HrtxFEUurKWhoEViOSTRYDJYgdugfYz2NZK746LFjLt5sRJF7SQipxxFikQzXI0ij7JaQnOulMCXfNAMKa98KigfnoMae5TTCp7Idppf8SWvsI+utZn/aSCutSg7W8RiIDuyAwXp4XwJYVkK46abLEehioqRpPlLIdZcDkZXv0d5TQNBeU1kbGwLGCpfIUfKTyizcoOcFqyg/KxHA1qyqcPwJSdWJJ9A83HElHjBmDqo1waGRVDzZ4v9bO3Qm7M3ZE9xyjAhgN+xrHVUwpk0ERYuZ4GkCyN7ViKfKlmwKnZus50OYJdw77u2cdOwNg6t7RzKojxcVYxmix6N6DSTqVE7WfBoVIMoJY0EF3k7gPIjGuXRMkajGHk0hmPGTUgkItCCXhoLYtmJJY0haB6N68blMM21F6IDNLKqbnu0SzeWwsYlO+kWMT9p5id0KsaDK2E6Ph6Qk/g0VuYqRzX56Qj/jeKPnGlkIltqhikHD976HeQXakdniwrbeti167wFl4dnInhSh/11zG5O1TYJTIWYVIhWQOLsmuM4JleTWqQiU7sc0rjyZY2GUXw7FQrOlzHU/zkx4Ygx4fudOJ0olOlO2d2PMO2Gb5Nlj6Z06rCcRpxZ7tFpluVjOs2xfFyneZZ7dVpg6ep0gOUTOh1k+aROd7B8Rqte3KkQI8JKVsi5zhfEo9kNi9P9xZt2sbxhcaa/eMsu7tOCRsr/wb+n4N8+2CXhH8si/GO5H/6xVPCP5QH4x7IE/1jOwD+WT8M/lgfhH0utZdWUqaehdiKWAXIbByaVuHqaa7WiySuTh1t4CBegLrfJokrmFPfQRzJc9v5wL7XpcKHGlUaHZtO8M1UL0f/Yy2c3hGc7zhEtjxnLn8NpllN7WCcu65a28LyY/kPwb+GsmkuPOFPs61HEAw5sbT8uSTLn0TFd2VP16Pg/UVHQLdBPIEViuiQrss6NAKG90OnUVR2dI8Qbg0aL7nDccaZ2I8Jz6FjTtAu0HJpoydDSIeHTjqC82qkoKasdnHlyM01W7HmUU36PLSnmXjK/FK5nZFa665mZ7N7I5/46iFatzA61iJsdPHhNY+5x9gHKBHFbUTZI2ljOBIkLHHN/e3BPAtPQ9dUicqygYZEfp8HAaMF5WyhRtpPm0DyQjDwKLv/QqTiRvSoZI/DftB30vi4UwqleLCRm8zPdWKgqwnS6v0SDZn1R1VkpZ7HaDyE7YyNN4nJYkVW83Wx9d1KyXd1UUKGE0YWNnwk2iVtVezdbikv+zAZLgl66Yv6WeNDlXorPon9UOIqLtCsImy5eUlmNKmnF2Y17e27T6rLb3LQ6v+XeR+04r2mu/CiFvqaT5Q5s4xqDU9tSkdAKVbAjMC5zfc7YyCc0pHzrOheowvWp4ObZ8xfQmPDG9Lb8y5Ku/19VzD5xH6sqtKoN9VKMunbW0IDnyr2oLGJ0slxU3bh0vemHoI4QTNlrj28Q3PDJCh3FLX9+m/kLOM7ZPUnHgC9qOgHR4CjWEG65iAe3F60XNBc0NQBf1GtoYQAvATgMXtZrjplpApiZJebUAJaZw+AScxhcZg6DK3odvfA80CtAjkGv6nXHzoVAdi5insPoKvMMusY8g15jnkHXWWcA8DrrZPAG62QQs04GCXMWAVaYw6DFHAZt5jBYNXb5QDeMXYzeNHYxesvYxehtYxejd4xdjN41djF6z9jF6H3E+FQ/gR+YEZ0F/NDCc4AfcdDNaB6jm3hru5xbFjLnY8NxupxPsPl0/9RPzcjs+MxC3vG5hUy/jXO6hC8sZMKXFjLhK3Cr/fO+NiND/8ZCpn9rIdO/w84u4XsLmfCDhUz4Edwz/fN+MiND/9lCpv9iIdN/xc4u4TcLmfC7hUy4o9d35DK9L1q/TIOrlD3QvN17or2/Aco707MAAQAB//8AD3jazX0HeFzFtfDM3Lv3btHuavtqV9rVdvWyK2klq13LltUtS7Ysy90GWe4dDISYYoiBYHoNwUleQkISHNofMAmkQArJSwgJeaSRxCkEUkkCTnmg1X9m7r3btDKQvPd/v8GSvLp35pwzZ06bc84gggII4SryAcQhEdU9jFF9xyMiv/uP8YcFzUsdj3AEfkQPc/RjDf34EVHY81bHI5h+nrAELLGEJRTAule//nXygdltAbIGIYI6586i/yKnYEwj8kulGGOEBxFCK4YQxmQTImSSDIdCVs7gqk6KtgRpaknEnXYhFLx7UWfbXV6H0+NxOr6tx7+bPa/C66nywJjvx4/grWxMEbkkO8EA9wYOhl6Bhi0WSzFvcFfjUDIhwl+8JKbveAj+4kfefPNNmBje98KXELzvRX50ydBD8RVrpAqTSLDAE8JhMl2E9foVQ8VmLYeQboPRQHS6lUMazHFj3LBXitIP2C+xDm2b/57y4JTkKy0t9Zf6fWVeT4nb5XTYbVaL8qfYYigDEEUAEYBkf5MJ9jchsr8a+EZ8k13jmjV1zXX3w98xTc6/Ul/vur8Lv/Ba3WPwp+61ugfgT91rrwF+GJXP7SQCN4JiqENqi2LEO+wAEyKDVqDRANLwmmOIYHIVPMxvQjy/eghxHN4ECzKJhy2eiMUTFAyeaixGQ0HBYXe6fNhhF8xA0mgs6UzEW5qborE63NzU0o0TopMIoa7t/ePtUzPjF89YGi3vWVoxuntsY9eG80YPbbY2WLeSA5WdPc11LaGKNd3rD/HvP2EaqBydXNbYGYqs6u7bim+/ywigaNDVc7/lisgXYV3NsDYxlEAT0jjBogY4BiNOwNyMAQt6zGsEfkYLq0426TAhAL5GI25CojgpDldWlJVaijV8fW1FojIRCpTGymIuR7HX4jXoeLPGXGSwV+twDGsYZgoucVgc4LgoYIQX+Jz8fvalahJO7WrorI7A32DH4MaB7oGN+MN5H5CPzi4rJZ9L9C+pTwz0NDbWDPRMTI8sXnVeavW8j4AXe+fOctNkB+AbQpLUiTg9FhEnzgDnCQRrEZ5GWsRrtPwMIKnul7JShMr9paGyELznDdrDQYvFQFcsGRBDJixDnGDQixSZLpKMBAWxC5aMLBewRTi/67fXXXnsYweWjp1+fHp7y7bzJ/2pW0cuNdzxAXxrPP78c8eOfvT53q51x7SHZqJjt5x/3wcuFPYNjFPegr2Hvsv2nk0qpty2Acn7rpgYnNU2YOFH5M0GzybnrsJLuFakR8KjWoIbqpPFSZdgsbvEOpz8feC7W2NtnW/i7pT79dRzj9/vXvsZeKcY3inNfgcXi7EWS1Ms6cO4VHkJfzn1ZXgLx+W3KFzL8TH8JDmDTCgklRuLDHqdVhQ0PEewEfWB0EHjaBgeNCETAQ7AYtIlusSYGEvGkq4YDmhvsdx5Xu3q1bVb77DcoiVn7m1trryk/Moryy+pbG69F8afRjfgF/BZZADJ9ZATJIaTbSEe+BLkGMLbBKzRrNSAfPDBT0jZYfBrmHuCpxJqI0dl3/IpyQRwGJCBCQLRUALAKGIAtj9ebrtLuMvWyr7isx9IfAD+p/iJczvQnWglKkIWOgBGx2Dkw44wpborvdywR4ccpU6HxzlWqSkqtZe6bc7w1fTxHuzDQ3gc1s0tORCFZ4KCtoH+bkRePBxIBvDSVErEBPua4PM2kN13w5w6da0VEREK0sdb0pK6TZHSxbKAZutRM3c/fokLw3zCo4B4Q7ULu3ANvrIudWkft6v4rduA9xfPncUpchoWpYzqBuBtNgMTR2gTDDOJhqPRWIDJc8K4uotLxB12EXZnKGjiHHbYqPgfFS9ObS4KtWzpeqJHe0XjYKVHe9noBjyZOnns0qbdV2zpmYs3tCS+1rnmwo31X78NYBsDAL8HPKynvAIsApKcShi8YoiqEm4DYgLcYrEzTZJM2IBNElxCDEyeWvblkt81LL9DSF3dRFp31lw2e7xJxjcCX94AXJyoRqosMoA+YEOyHbt6iKfyF2gNU1MudCJnKGrRgMqLiIEk3ZYgaYHN2RqaiIi/YkrtE179aFdyw/roniMrNlbvfO/upqb4C09PxFtXBc8fXxbfevTiLXTeKNDwzzBvFHVLHQY9cKIN2M9XRngNB3oWeJFHmpkMJCDuuU2A4CRHAYmiSLg6FA5QNrQlZamXgQREPpP8QPm03A+9XOTuP6+zafXa0vP2DW5Y0YM7l1w003MwXCPt7VszPoBX1K9fEk/2REdGly7a7uSsq1o3H2msCg6tHepaBvBWANCvsjWPSEGQ6P0I6H+Mx0QD3EjwNplGsDPslmKqhAKhZCCJXRzTimIIH25zpH6owebGuVf9cfeUMHWqFv/Mkep8+ukEW4fKubOw8R5AJWiJJHGYxyYj4TRkELQeByQ5Co/wGgzSFGizQcSCsIJymypY4dMSVGKxh0CiapkKDIgKLULBNA2CYshGsCl1pmxx99CWy/ZcMVyzZOvohr6LFtdWkgfir/q2rT54Yjy4ZM+mvgE/KFxqc/QxuE4jBwqiPmmpDeSGHVPhAXABo4iYQSVQ/qPLw3SaCpXLiZG/zBl0Ba3FRXqBRw7s0FIpBjI9DR1sDmsi7hKjInya1mH4wrHjjnV7+9deOb1m78NHxxaV1++r315JxjoGNpPjn7rt8MaJS+65eP+LmK+qDP73shZ71eTqi2aukXn6YoC5FPaJQK0sALYvW95bmeSJUaEhnm7FE6mPCfhewWAhhxP1sOvDwJezgK8N+VAlapIaI54iwsO2GKT2kbLPYdmJutHL/Q67v7K80u5z+CqiApVHdjGNWlIRcZysmCl+Ntk2of/Gs7ddc3zPtkMPnLd/68SO2dHpgZ0fWnlt34qutVf1kdgFQ+0711wwM3CDlNw8vHVs9kuTPQ29FW3vbe0nW3vbGnrKF++obaNrNDr3Z4IAZjusUa1UBSYdgGsHvAFO+vvzVDNpNTfsdPhKHUFnMBzVAKiwh5OxHMVrwqIt3pKUNxQFdOyezzlIcEfT8Kbj01O7d332mkcbN4f5gZ7B6V5/9V3vwfXx6dV7br1o1zVfORzBXS2N5cGp1Qc2Lu2Feakc/g7+EZXDqEyiApZqnBlgDnUrh0KhIJVV1rRMztjR+xTpPKZ8x3cwMZ26XZHWhOkWeXwnikoh2IYU9aMw9JWIKolJRfYjPOqI5E/EZSsfda5uVQmpk12eUUYYbUd349eIA/gKdAMC3VCLkxGXEeMHU08IeL8l9TiO3H1f/L6Gm29ge2cteh7/DOwOau8HJT/VXhzVyBwQYILu3g2IcGQkbfpTlqS67Aepu0S8vTR1l4C346NNv6Q6bTm6Ef8XMWTmtmlETawW34D7hNRNFjyQ+gkxZM29Hfj4eeAJL0j4CiliKeYIz8kuTEZZpf2YqlAthcAGJg5TVrmCnbMybqbkekXTqK3r6alrblwzGJq4oHeqoXdpg6CukMXq1JX440sjwbaqaOVg+bq+lsZlFdH21Gx6zQbnEtwDAFcdWoR1Qw/FwCIx+7CWb7MSjRbWTOQGvelPdMonU0MP+eHBKsTrsVbDa2eQIChY6DCVN7DuZGwILGm2KyfQsFceuiL9BjwHD4kakvVu7vN18Hwte15HZ9BpiG4SnfslqS7reVhWHQfWLlr4hampKcnWUN/SVL+oYVE4FA5HwuGgwVBarXHJ4gKlpWI9zmxLFydQqVgMa0KYgORUY78bR8mH9HtmPvsiNr70wLcvmapfwvHOscbFK6+YGRkIihXR7nWnbnn6d0/cuyXav7WtsX5Jsb/h4vrI1x/6Ky598vaTTzRV4sqGDWPvu60i9beW5D3YdG9q7rsfeJQMvudAt9Tqf8sNazb3MvDMX0GeimD+0X3Gw795tA14B7xGsFTxGAYNpNfBAyIwswD2QSAGFj1O2Aw4weHHw6lfjnXj5qETpx9MjTzxBDk1u5JclDqET1B5zVH5TFwwvgm5UDnqlBYB0XlgVV6A7cyTaRHWWJbfzMJS7BG3u9jsLnf7vSU2i9lV7ApUapnwVbV/NbYBpUKcrPs4UbEDiKt/Ke7uve66R1fd+/MX7wi9b9N5g4/73je6avkqYu1YY+GMyxdN7yenUh9L/WJieftiXPXPkSWwMrAHwechlUwXxqRwkQGkjbyhVM2XCQzA2jJxk3ZFE/GkssSwnqQy1tU3c+v06Jq+0vHdu6567PId5KJo4sunLrqwrXLprTc/85Ls71O6dANdtMhCrTONaowBGcDk3MBjRnmdDnwuiw40LDwoBgSDozphU/gIyC9j3bfqihtuf/Ihvm/FDfccOUJOHT/+1R+T98w+/tSDB3cxnQlz4bMwlwFVSlFYE7A5+Gk2jUx3jUaluxwIoDZOJbaBwKLmDRfAn0ydXIXXmlKv+l8XXg/iGDkVn4unXlXH/jOMrWNjg7lEgw7Uid8AtgPPFnWMmXU6QIQxEKVcgKMDh2z4z6bUH8v/JPwp1r4KBk2djaeehsGU9VgC61GC6qUajJl446gWYKNrNgHQbFVYsGCSHwbjyBrODREk4t04FEtwmbVZEu2c3HXP9pWrJd/1+NsV07v2Hn/quj3kcKTlaw8eOBJ5I576fNvN1z77CxkvspLRLCD5YFeAiYa30VWSDfIcWgVCtgAgk+ACtgSea69MfaGyfVV7BPdE2vGK1EPAb/+Fq+Ux0YtZfiqLN8EqK35qggvdA+/RHcRsnbkX5y5Cv2C0NUp6+jwadmBgATEGqh0eN+GAbkm7drB9sGjsmvqSkV6ybvYTm9an+asT3tXA2z7Jq4HVBhJS0FcMcTJzWaxWWTcldDiEOZge/60v9STGy1JzbgZI6unUzfgQXsQAktf642zMEnA11XgZKDoyRoAcxTReRqkgBu5pX459ptSDgMu1LXL8B+ABSoC1ABqrWMtzsMPAxuSo1jzKZ9PVZnE4ijVg/ANZW5LAJVxI4MC6TdD/yIdaNLxA/rJoH/G01LffPrqD//0qrPn2PbO/JqXXpVJArtk/EhtS4SWbYE4zCksBAwd2FB4E14qKNoxVv8eMzBYH83swm0rk2FQgfsmmVYNvEb403Lpq4C2i9fuYbNu75nep78NPN7/3rb/JsRKyF/jUAPKNys+CdqSxyGYpchld4aBGFmNpowzHM9YY2fvAiQOXPXLN7mOpZ3fduGVs942b8Eee/PONx599+eYU/srpQ3u/enr/fmVtY4wvilFcAstWgyklpwXYcWw5VMbS6zHSF+vNRoMAeCMd1onURKc7j7qsAhUh4LVi857y9lUf/PNNz8YOfudRbEiBsPjMwSvx/tTTXzrKcPwow9GG/NRqFgWC+6i5A5vyKOw+xYtL29DgjTvs3hK73+EPN4WoxgCMRVechlhiC2C+ezO+Sqqtv3Bt0e6jeRS49VtVXHeiLoJP5BEizeeUFkawkBulOmBtpl3Yfp2m8Q/mOqeZy2Qy2U22UAB8ORbmAMBsjMWoVI1wjBwkNr3l/iUnr4i0r/rUvkOp+4MXfu1+ol+5x5T6Cm5KfYucWhVM/e6jh2Qec4It9hbQJkj1hs0K8ilXbyjxA6BJVbgqV2+45jmycgAzEcdvpaOXl+3uvSSajl1eeN6l2YHLTYcbKzJRyyFqDncAPWxMn3slN93oKkOoMott+UTIFqJxuTfaR74p4udNXyEXNzUxfCaAn1fD+1b6viwuAHzVpg9aw+x92OUCDXRQKaQ4Q7e0t5Fb7ne2tS8q/emWPRwIjwZjyY2fxc+nal/eus5G4ztdAJukwibgjEBSxKAsQXACGJRuddyd+nbPie7DhO27U7O3Ufj6gbRxtqeB3kZR1tPgr3J0HIIVe4XtapvFxrQN3c4cW2Q6rA3/eJQ81/bbgRHy84HFi+LkVzD0rWQPTLF19qT8M8jeMwCrg/GVXyo1iDybh8NZs1htVqssPmF4mYlAiGIDeab31YeW3ELOLMPCnUvw3die+lrqBO5Pncb7cSfFAShN6tn+LZVKtBqSTwiQywohgC8pzPiPPanXgu2Bz0g3AjFS21O/x3Z8d+okwJmim4CNFZGCKL3cecEdqnyt6eAOc0Yw/rQxtVnAj6aeEPG1QmqkqamRDCQaZ08zPqidexC3c0Vp70bW60Bl5t3QoTmU9m5csH1Anye+d9+O+zQHNh0Y4zbUvPUmG0ea+zR+Som5EebbYBHvwStqUg9y4bfuMHO75H1UAvPF0vPB6ARxYKMAQhOKpUJwej66nsmELXSlMh9X9NZHazgNHWeUmPEsJ4EvFXhYOH+p5OSV0x2MjtGFO2yVuexhAS2FlQvFwJRNNtzRdfhzPZyU+s4//wk0fW3u/fgzczTmX87GWCA2SYfQUJ/uE6l+EZ++gNmRPrIDvUneyMQYaaDuTfNzbvL+4GSTLLNaQGb8jjhBYpWjZiluAiYuocc1dkrmQVWFTOWoEKej1OMod5aHI1SFaOiOE7J8CCpOYuDb2xTZgr85wo1uXTpx8tCq0SZitb9ZtTYcrV80cWmnwdhnth/ZufWez9WkrjHYStyCfqgfW0s+dPXIiKLPCHkFFYE+A3laDFY6MYAAIINpaKayj2ZMRpvF6DIpqs3GZSJTNlfQjBXB9qv4pt2dA3cfWbHh/Gc37wpI8YmLG8grqbvvmFz7ya8HyTf++3N/cn3q9sXdMi9Q+jwH9Cloi0+9c1scP+drWjJ+eLijV3IPr1qz867dK/CvKqtvvWzVVF1lywU7bnk4vR7ECTibkIeed9hEwnGgRXgqbXgebQL1iti0Y0MCznjWxWYQ/3azp9ij1woaZMImpl3jLpsL2FOBwsYcOWVRImvaKlpn4trlM70TN5RWb4746saH93UQZx92i7Pluy7ctu3k4ynL6PD3xu66fvmwyitngBY2VIqSUpNOy6QForyuQTNU48+nisPudtlLHaXhUNAqUuqAlvPhHNI4Y8rZSxSfefgLeFgaWeoenVq/5yMHlkx8cOSiog/e1ojvHd+tXbe6KdZ1cNvNp5faLpsRVvcEwcaf+9ZcE34M6OWh1ocOeEPPGMTtoupYoc/4kIYdgVJHZiUoHlsoSI1/T3WSnsckW1hYEMhixlRymDC1aVd1bRG3FNmPLZJczYmKatFwnelYl2nZektfSyn+Uv2qa0JVpdX1Y/WpxdNrq+oCjD6xuQR+Q9lLPVJ3iYHwGlAthAxq5INFjUIfZhxRyMYoqVSvPb2tQiEbIxWAIgdVu3GaWFz2Gr7RY97/mY3OscFr3abl00vWfuzgmi9XbY6GGjpWX9GFX01V7D7QWFPzwPaLt2++83TKOz7y396Tlw8NsfMO+PIK0M1GfQqqmmEh03tKMcqtYTvjaLaTHHZqjbKDBfrDrxIb9+7imtoSXNfmXZVtM7CD7rzrQqsrdS3e47YtfzL1IqFqi+pZ9GvyXyCDDMoZBqPBODUCVio6xpYlSq00/hN32o+3DbTdEHW7o25imD1LrnCH3e4wInOfm2tCL8N4OvBVyySPhlrWCrfJY4LRXqJa//JSJtUxr2lbJq+g/npl5JSVrV5/H9knT4BU2rwBtHEyva6n6gYPYroD8ylkCztDDPKkKmxEVyjGiESN908uapq4LN69buWBniNPLF101BtpI2fE1C33LmpcvM3727/HL1lyxZrU64idBZ5FP2ayDjwkLdMTIibUxMgcK7HDLJhKUEVL8sOL1vPFTrOjqDSyxgxDzx4odYqV5pk0HmQO+DHMLGVMD+EHtVgU5cN6tAkzWUJP56nTBK+EUdgasUbs4aDO4AVtIS979uJH5dXP/PRk8Yb9m8iG3Zt54AW+pGTTzkr2ffPOirYBYrjl3gNu0537jUHKF2Ul0TJgDPmHL6Z+RAwZer/C5EqtVCXzInXYVw7Nozf8bEM2ypfUmrKJ8/nyyeKNBxW+3LJLAeECm8qW6qSyLPs7zGkErx58pcIKxWxy2Ewl5pJwmAWxm7pIOm6WfQ7e4uuY6Vl7/g2H106DiXCgt3tif+83uw5uad93/h2nD+DLb792dNWd1y0fp/NG5hJAbifI9xLUJbVbQaOAPTdoxLhPAzCsZFJdhYTnVUiKzQg5bOaS4hJ6RBsOipQTso5eODFbxT1p3ryvY/D9G6c6Iou2/WbLbnfdqqHdDZQUq9d+8tnh1H9ryQ+jn39o1f13gpqjtEjg1wGmIuSmepYqOQvlFrKA/jcZ7Vaj2+SW9azGlqX8c/T+VM3y6WWr/+PwmtHND1dtikaoWOr8Nm47suO8u56qm135hxXDWPR+5Bgo+zQf3ABwmFGDVAt0QJRnMdX2HLcyLSmnhpDKr2BZ20IhakraQIGoYpyxgbVmbdxtt1pNtWubopQN7ts4rmnl1+1L/RE4AFxRWP/bYS7mK1ktub7SVI6vFKnM0us5rpIP5/lKt5d3D8QX1faOL9myrmWPP+KbrOpY3Nw/sHjdiin8i6r6uv46j38gsWy8xhfzRlvrIgmvd1ljx6CMfxxgWkduBGsHtKsZQCrGPDN2UL+gAa5BG+iOXUk5VA01wXsu5AqFwcFQzii72XG54hJRIQHWmS0ubCmvsV1bdKyRSOF6R3PbIa4B/7zmMs1VNamPG6w9nqrAYasDj8pwjAAcfwAqOeT9CKbqIN1/VGzw/Fh6V04yc96BHNawI0T3YyCpxJKT2T4ZPlhUOV3X2sk2Zc+OlXVtAxcvWSx1wXwHUne4reMfwn2zZ+m8dfDl1zCvKPt7dEUUhOWojk2R6/Q/HKrr2EB+2pWaWwJivAq/SIeAMVphkz0NY5ipXjPpZV+JBhxgGMVZAl/MwoI6ONsVo17etW3fGE2Qx4cXLarGX1qc5Kjqwd9JNcIMUfzjVEz2xfDXYfy0L0bPxgmjDie79aovRtOWbLGEi57M2kI/5x4d+PnRni3knmXP3Nzzl79g9+vPPffX1Cs0tvYX2H+/hDFNqFwqk/HW6wjpy0benY28qthCdZ0byQ+7/1m9ZyPpWxdwAJwh/NPZ19dtNdUbR5bSsd+AL/fB2Dk+2cp35JNtNqY+IuDNqTdEvEJIfbixsQZ/prEmNc7o3Ag+kgQ+UoTyagAscyPADZYO4pGG4zUzNEAKjtNM/gGZxWFxWxzM+JJPYUXKMN2YCvAktW1gH4vUFDNhEGcO+/1eHKnWdEvYi5eKFZUaj7ZvQNNQrfFoQlW4/W8vCgafs6YibtK+KOi7E9GaF6SGmrKK71clDJx5sUnm5yNzn8IOzgUguSR7xvtiZwKchTM4ql1A0yO747tXc3veupW9Ywf8QoBfGLVKzQ6dQH1A2JGEZlqBK4hmKHoaQg9ieF4zCbYd3ZIaftRit5RYyiiCgBSYagpyUcCOnQEqSFMEKcIXeQ19uIN4cJhh6cHlIXFI79X292saqspfnLBwlk6t9ftpNF8QjYGyxOiL3Y01pRTO9diNf4ovQsWom/mHTWYTCG4QF+CkDtKAJjcJkNLUgRmWNUITctAoRkaDXssTVIxhJ9hlDzTIzuKoHJXtC3yeb8ZSFwg6e0L+8+GHUD1219a4gtHaGk8vNS2Yv88dYbE/4IJic5GB58FNIfwxOidH8DQYGtRNV48UwE9HyGRU+E0QsvnNlnSJoVgyPxQwe3nJCd+RsnREgPxjyL9lq4/OT3n7U+Ts//D8eWz/vWPOG3wX+NPcT/ZN+HftpvOjxFw7ehb/kNm2YItSo41a0Qq1mU1vs7HMTTDaQla7wOzQ3YsWtd3uqfF4akALgWw5VuVhZ5awTeZ24tfI/chLT2E8sFCyvwm6GNMcCJoxtQUpCTgr0LDbUcjhpGmImdxD/FrG7ewZKG60jKw9fr61wbo043zWC9ef0B7acu1n9LfdqmW8vwSQKyOPozJqN5a4CehhMMgQzxK5ppEoCpuQILCAopoMFA4C34csFq2hVMnXAkDoKTOAofhYTlk7Y876jPCMtagT46QxdZ0wpLcvFhZb7XfWbSirbhpoShLrjfW3b41yTfHKiY/V33hfVdjf0cJstnY0QzSkB3y9ILpSCphpFpHTqtXwhCsBnUS4QUuxXsfjfreL53jUN/SQfsUayYYIMH1WdsIUR49hiwr9aiVNYC30wtSUBB52ub/UaypCHuyhmyYSpPlx0SaaIkeNH+Af2OE0bU6IxluaomAs4IBUvzK8MhYdD6+sW9zROB4Zi1WMR1Y2XHzJ0qWXLL07AL+MX9cIX4PB8dB4vHdZYkV4rLx++Mrh4SvlGCgg3kFOgZYHOaQFThgAM1GQc4FEYCCs1SHttHxogXS6Md0wzaSlx0E2GqEyGMqq5cxZWcnRsy41ne7IpdpLhenbF7+P+/GSV/cKV2uvFq52djgvfWVpPV6ZOkX/1i+tP32a0T4jQ0V6aqJIwWkgOseiYhx41xzhRnieF3nRShUssD09iIL/fxevjp+silfhp/Dat27Fa1MfV3J+ngK7/3FUjdroiV1zXaC8xKDntPJxDMX+PNWFX80Nh+pDMV6JIOQlHMn2l5ID48qKacfkVBiXkgbzYmc8uW5080h5z0hTa82S0Z7OROvE8g0j5d0jDc3034/ZPauae4NFq1pwvLLPVdHVOZSsaqyPhKo9/mWNVf3OisWdg81gx0VCtR5/f6dorOkLJkpMQk1vsJnh5CMX4CryDFDJjCJMInsIS3KcZGnYm1iS46gN5ALFhcpdK/NNhWCL8t3nDDud4Y+zr+T9QadT/Z/pq73oVvII+QGyw+6MojVshhE98AUyYGorw8QaTmT6l57DzFCxAbb7jBbzgsBPwjde2KTDAi+M+n1ORyjoi/qjnhJHmbMsHAoF9QpQqkzJCdRwClc7XYpDLeCznvJYZWJjLFpS2y6tGO9oa99x/Ynnb7hh+8Wf/ORfP3k/WRz2dPZcVhqKrh1fsTY1ddP3b77lezdXwK/gf4bPKpbv9grDpgqNS6MGkDJ6oFEJ5jUOcI74QSfwA00SkzP1RCSIwhbV5985pFXDTru4Yb+vqrIiFgpQnGoAG50RnMSmlnacbEnnmTANzI5/KF4uei4bpNlSoAOu3HdgiUasTrb26Id7+5fqyrgSTbiMtK5v7r1+pMUk/Uf1l1OfFvEEvr9neTRe467wLpO+Ab43H+bLy5dKjqGZ7eFo6j9oSB0tRT3450SLBLAUtZ816sGAaADJCMKhG7vkb7j6vt3RazTPvCB/w68993X3c5XfKZG/sZzaB/ELeD3SoC5ZlDmZNbUvPxTtlRx0s1yV//nUZ5VjjAhNEgzgLyTNqe8IePuDF8vnK+8+55VHK9AsaSQvgQa1Ih9Yf+sZB46VYV4LVqtIQBjzGnJUzUdHggHrtIJuRsnSBoEB1JlUXAiCRv1+m80f8YeD5TafzRewOGx2e3GRwcu4MMwYj9pNvMx6DrsmFnKELMztd8Uc8pHhJ771/uu/+f7U5z+1f/+nDmP9Kn/18MGl6z8d6emfvXb6/BMnzp+ePvzAkSOrJxr27cOm0Q7z4d+tqa2WbUMfuQebyTeBBjGGSSnBjBDUQlQokWUnylsjlMRm8Xci+WZ9PdvzB/F/gi/5Kjt3bWOj1MEbNHlxhioSgiZ5loyvoSbyqLEII/kIVtTApjUIiv1lyzqEdGVlqP+ztrU6WNteG+wYnOpLDk/hv3c1x6o7m2M1Nb1tS9cta102RXOFAVQ5/9qMtskZ2DRRDdZNPJpJwtbSJGyaKSRsAA0+JoC2C2nVdOy8Z7OempKs4GybjEXpvGxdXl423T4g1u4U7rQussJX221yVtnZDyRuuinxgZShmZ4H4m58CPa6vUAO8M6MS7KDuSR2ZKc5wEYXTdHIzwEWRDxpSP2Zv/u8YFl3srx3TWPXzsvxjqrwlRfUuH3N3t6m6kXv2UlXrwG34u0wZ5jm/4JXhbAV8C0rLZz/uzOd/7uLkwNioXB1KBQQjen833Om/4Y+o3c0NA02dpUsGWldHK/AwZqVfdXL3aGqnsaWdUSI1cbaq8tbEtWhDh2nTYQ6hsu9ZfXxmj6Uf14jn0+BZVFr/qqb7AjuUPOo55rx6+DPBVC1VGEBGiJ6BE4j3hj3ETU8oMYuwp4aJa2CY1KP+ubMR49RFWomaT8df66tRq+LG3BwJh6uNnHEqGvZBv76wLq14FR+baCxqlZX2eot7lrhKcdWS/M6SSAvpu5wWCfuleE6OKcjI+ysFvxiMMPkbCsqk5TUHjJsC1uoMNLYmLZuxxw97qaebAv2VG7fce1lL+xp2X5o1LhywHLIiIfx5uVT2946IXLLZ4/uPOCti7N5NmMj+hLeBWrAzaRejnNpY0m3qkLdLBvZFUpOINB3zod+Db6CBfWwXZrUwrIXw4tmmvuRttzpFuDkPUtZAXHgLpmKaLUEmOIW1V1y0fWOgW+ftkWOuL2DpVWm4Y7GRNRT9pjbGcEHV+raKxKuqIXBfgj4P0nOgE7wSu6svPrtQzLX24uJEURuiOXTY6659rD9nkp4Z0dXdAWVQVNAUSPwMpUzXhqpA80ALucWQY3N7Uyv/S48bCyidVVqsocII9uaMtnQtqz4Jd28N1y4dWj9JRuXT/1gYHJRsnddh11Wdb+44OZ1YxfesgHXHNnetfjQzu6e2aVNQKkqtBh/lYi5+q0bA8OaMSsaMeOf5ai3tbnajeJzaO5hbhDkpoD0qAQ9wtbEZCkGymgoZXSYKCZ8JV3dY7QE6hhzt/cys3OfgHmO4yfYwdNGkQZSlyuGfUXOC1S6LfS8FJv/KLmqwJPgARhY2r3DXky9HKYK5KWK4Bi2UTloy+Thq6v36ZShGv9toNH4NH+q4UNX22pMSU0Su9ialrx1xsWVz7q3hXDQkvr74cPVKE2XvYwutAJvjNFlGeUXHgOHI9jsPiANwjyFm9NwSHMUNDOHeG4G5BkhmgmabEIjPRoyIoqiV/SGolZ7MY0QZoFdUK7aABcVeOKdJ2M3MnQU+GcP5glc8gmGEcWhHnBYBjiEUQVKoln5/Dstf+vrykp5KoFjWFDWuA2BRNTq9oN5Jwr7Ml50kSKhAUEdIAgOjyhqJ+CbVtxowKJWVNd8ER2A02mP/gsjyLMrLwtXvZt3gS9AuNBE9kS8saGmuqoyrTWMCr3fkeYowESnVGWydLiAMilnS9GZx1k/W1DFvF6A2whqnUvgD+Mfsfq6qBRi+duIY2EMDtHwlnL+NIGHbR45ezsCYo+la+eccXdxik8QxIF5ydtLexsMTBr/eIHM7d/IQpqTc4C5wywH2EztBDA7ONL/bnOBk8DgefnAR8xf92TnBH8oOMR0qjrn0X93znqcdOXN2W1+MmfO48ENOXMeYXNaUYuUsFpMRp7QUk4NASmUPbeQnrvYnJ5dLIBxwiXmAeCSo2fZMHxTiZ+pMGxlMHjRqDTsKSFa8N2JRmCOpKARBTDc9SBTtGwPZEDSKSCBSYjcToet2FTkNXrTwBnygQumhYwcWsyFcomnp8jnC1R0+rsMZf5ARTa4N9bWWAZqqy30JBTxCsy9DGYbQN0qNYtYo8UCAF0YRIS8HpfTZjWb0uDp88CL5rngeeBdmOWRZ4N2e45zrsL2QQabC/ZTv9QLMlwrCtoZkBWUjOICZCxxU0L6y9yhkpCssdOwFs0nZdo1iGW5DHkwW2ribfWVidY6r9/r9AZKs+HeWxOpS9aGa1uDYb/LHSp3sJpEMvcT+HKG5bPZaGU0DeVreQ0tsEWCltaTcGoCnyDgDTpRpa/VwnLc5D968N1keANiwJWgybKgQAMcPuVO/WJ9N96EP25KPRH+h/D72MtC6oPfQHNNFDaWxB0nl6b24ZvlnGsfy4GPoiclj6fEbAJNXIaxJgLaOowFxA+CjsMDQw+ZQPTHaAKKBu9PR4uoGc/ysieHRDDjWLxyQqBhP7dsHdDH0dG3fZ4GuuRH2cdIOK/AKxoaHXRgFAqUet1Oa7HRADojiqO0BE0jW4nK+aArL1KbNh2xDWxH58Z9j12+ozeTsz+8Q5dtTE4Zbrn6mZckNYFf4lvTxiWR8+pBblIJVi/VUAmG+/+F/HpqGczLsXeA6FSWiLxMxeb/3HwcmIrz5vs0iE11vmeoyFTnO8KkJex5Ji2xANJSwMKxc85rlycWgS9zJlbkZf7cE7LEVKbnihVpqdSPAAy9GckDYkcHbrMgzpwTAq/HZrPJUOgNZTlQkHzJkw/OL7KjgQpJfpIjd2TatMBa0NhsieQET4VjiSPzc/rp6tK8/tfYgs6u5FyyEpTHSLyzMWDF6BgRtkggU87KSo2gBA2cwBpxYM8HJb9eR10mlliEyLGssezp9HzZEHWJdLyrVcIDWD2qjkLdMOYQ0JxjVA9IPlYKq5om6og2SmDGW3TQfKLS0bU5dIQpjNlEJIgWjS0G2VcEngjIPh5EDQbeQtOwwGJG7HEbtHL7CqMRIWOJ0W23WorNJnjNEJD1SoLmlGXVxYhqZVBooGJSmIzK9TH+x4THgqxGBg804Ca5TCaVakj9llXKyLnkm0A3m8EDGJL6fWVEFJwOwmtY7QA4qwJ4KwKNh+owT0R+RptTTGApRqjUU+KyW4v9Fr9SWKAvUFgQy9PM8woNpvN087zCg7VZCpqTaxCYXHDJ51jghDLJ8K/XImDgkUL1CE5g4gJFCeQ1maf/V2ChzF8Als2wFwqB8m3V3lNgOcJg8VF7z1fmKeHlAgHMH8vApMmBqdSrQiWcCyp5FxUA7DF5UxWAjfOk95gM21YGW4zagdEIcBurkSe5jIaB0TKgarNApRZMOBjwl3rcsZKYCrT+XEDnc9586H+Zx3uFSPzzHPtQwaWX4eIHbEBKgxcPJiJmSQmFQDcWxQASvw/EtAK27hxg5x/XFAC7MkvWFAL55Rz5jdH56Hr8PP4JwCw8atBg5ZxA7r2RxM/ftL9y/83Bm/ZV7rsZP3rFZdHLr6hgXxW+Og74VjGNFKJZp1Yz4bDfV8IRTqtRDkUJ7hcFOSG2AOc77MFyu9fhrchwPjvYlE0WeqrJ8I9xzpjdxZK7KM5Vscam1oOPXBONNiXaLqC4L/+t+4bh33nLd99IkTZcbDoqnX72ZcN7TceWzH7vK6dvaJl9VnvmRAtJ6r4q5zqz+g7Yn1bkpJIdJCbonHdT50ElQ16tB76Rqba8gg/Sqeq5f3tOKgHy5vwR04T5U3qVva/OeQTmLEFVUqzE7bDzSC4N4o/Nm9tNJ6fpSQsgDBs9H+d6VXXmw7A9vcdlGHoBBnp6XilF5V0BVsvMPAhAmbooEDTMVQCI/B2QB81HczRtPkSJPNuF1Z/AeuiQkdoMSgWKsciQvSyF6lCY4ZhVi+KUFyFdj4I/laa/WvdLbcek1IQ42k2C47chDSh4oMF0VpkaPZ0BZ9ZqtGpZexx6QkMN+UiIeTKsVI0V+zY3obndFrAszJv/fNOW6YoD37n1VnLqokytGp57aq6J2MgrgCNYyC5MOCdLBo830po1JctzPDvVsKYqVB/kaacvm1oS77D7SM5hdx2XKZxX8sCWDpY+vGy1r6rK1yK1rBscl8raWxvbQo2NIfpZc/3l9n4579lKjM/2NAeagmVhh6e9cax2eGNdZbSzxd9aXd3iCyZ8pZWl5VV3zL4pZ0VTvpHrQ95gOe1h1C615lWIhEPBLJX679WJUNdjwVoRbDQ/5z5XwQg5Xy5q+X8KM5UGC8O82PzVc4Pco5zrqDCfZTDH0C7JSXUSWAY5oPOD8smeF3zP8aEMAtk2g5f+NsuiyP3tlGR2OiJhFUfhHeGoeEoLonmfnCJ1TkzvVrKmMrieYbg2oG9JJfV1YG/EomBv5KCrGZRDw9XgSzGXfHwIbBCetTJbnYV+tjJXgsGFXlmx0CvvagLw9UuCAaejtrqqIhIKNAQbVGLq3xEx8yNhC1L1u2D8lPnLK7r83YZSf6DynOTdmLGCeIW+zzD6VgCFL5TMeTtg6KEaIFKQNjzgN9FTjgXJKZXPN5/yCCI5nI6G+prqilg4pNJC905oka9IFqZFSZZOeRsZkJMvo9CC8zBa1KBWNCmtyq9x0yDwdsUZPXXmeSzwC+BZV0uXvSle21rXWhEN1ARrVGQN73DhC8ftFkT6I3khvHMi3lkwpschx9xZTk+crFtgB5qRzo9iEUU4IohO8MI52ZPUGQTdNKhHwhnIjElPaCcRXERorr1RSwvQNtHM70l+uLmpsgKj1mRTR3NHQx3tIBgOlvs84AWbjQbaeSmGY2ZWeOZ0ZTfYkw8J0h2AaEIO2wVcnJqZSZaBg9NVYO7uYc3Ie5dMPPyFEbkWTFpvi6+V+seuumSt1nZZz6h+jfn8QY1m4qkm/IpcIEaci+p3LG0e362dWtMU62pv6UoMS6vOa7q4rDaQKt7lgw10vCaOv6gWjim1fT5W2xdFn5dKlBgjTQjIjjNSGVQoxDj1LkOMU+8+xDj1zkKMrncWYnyRRhgHJ+7avWJpJiV0YDQnwrjWcHDjLQ8n1MzQBJeJMKpy+wzoVVr/x/qnKBWA5X4fx/X/D9YBstObhWoBe8EOWKAe8OPUAvh/CCc78VkIzuOg/BeA8yqq9lU4zzI4Q+gCyUS9UGBBBi4ZVLN4FHiZehILAu2FpwROOKY+WvipKcnisAfKM/hp3w6/mKL5F0IxJCv+BbD8iazyeQXPZxieYZDClz2mLIishqpUsGmoTdikxTS3WL8AohVyzJWjMVflNf0C2LocdlkplfszOBveBuc6nK+UFkL+wWwvfyF+zIkx0oJ7D8vvyY2xriwYp6UVkC/RYm1a/6gUbLN6StzwzsYA05SOEaYJRHQMJYmIwBog3At8R+O0XZIuHaeVGa44XUqpDOmlH8kRXPWjqc/Oj+HSuS6TGYJN9yXF4uNQI8zXCesvx3CXyKvu0rDyZV5uUJs9myMnxJueUtKdO8pL5zdm+54y3XLsAZqzT2ub/o7KUCWrXHGzqsgy2g5VwxOsA78AI45gbibbK/D7IiFfpb8yXMdCJDHW6FdJ+M7wkCvJwiSg9OuwLITRXGwiLtlHW1eXjx+85oJV2y+faFzr4cjmTcvOM7rH6pdsHiJB2/KS4npb+ahvYNWn//O7ezdffENdDDvFW5fNPnH82obmfTsGVsl+LK2P+z3YzTaQFl+TioMBohU9JYTWGGNm1FFjuQbkBDNgx2EPaTTaTUirXc3M2gL1lIq1XOidFQu+8+6moPayw45Qua8MVJc95AipJZyGBUo48w+L80s6/5lnGBco8bwkJyYt13q+wWo9y2gcuKzUC7vm36r5pCqqUN1nB+zYQrWf97EN/L8DC1VDhWC5FHZ+IViOMUGgwnKWwVKONko6Wt/AIlPZbqamIGjMzUT8scK/BTfTbPKVqdAL54JeUTKFEAjK4qQQDj/O8yf/DvuC4lGJvigVVcTAnyz3s/j1uVxIbWHUzuVCLvDKu5qAbgmvx2yKhkMBX6mn0lupEkp/TpbL2xeFKKbP2xuFSPehfF/x7yCbKe0CQL3pAq7hQjiXZ2KICyAqOcymyopIOFBeVqriqDsHjvO0byEcP5Ml5AtvtbyaiWm0Ar9AmhT9A3uOJjdhql7A4uZpnj0PyE4q1javGc0oGpr/rmaHqAoHf5vlNn+HJTQNKkmmTbexMq7UbUo1l8yXx4G2lyEH7PQI7berF4FKgXLYZByxW0DJcINgCaF+m5XgvsIiwOUMB51lrrKKLBGQUTwsTs/o57JFXTRED2RkNCv3JeqTEzcc9vqb65JTlHbNX7DvbPii0z6xnxFNe8B8QeLqO06LF5gvasYfvf3arZX4P8QPb6hIbdLcKesbuQ74DYC/BCWkBrkSuMTt4nD/v1EPzDIM5tcEu0FwFqgLli2f/yVYDDRftQAsnwLBWQgWZkGpsJyF4UvR+ZIRXDIXjzWY1d/IkrMUpMH4kAyYkA+Yl/4aa44t8GuQnQh5SlTgxYWBV6zz+fCPynKzEApfypKbMh7PKPy597MyUWUBEKJmuGYTFQOrFUR08xEJyLlXWCPMLPDMFM3SlgVAiVvFSb8gc8zLh5iP3EtZ278ww+Rsf0SU+uo3kAlZaY6jXGFNey+h/ndYZ01t6bxa6wpmVufUW6v8Ifd4eIX1eIhL9bTHA1iUrMdD4U1ebJZ7O8xvXJTb1+FXiU171L4OVz2b7utAW6+ojR24U2+qjR1YnqGM+zMAixP50ErJkFVfLq+0W3aEqTm+eiibFF7JCR/CbxHHz2T/YkrSUwkJpKJJNXmkyl/B/BL1HAs9l3y5K0fmXp7zEZHVPnrRLok1tNNhegMEfBnEtCpMDrb4aDNcTkO2Cek2n0NZeavUVFEeYGEffJ6Q1Q5U3W4u5LI4Q1Hm89tMOLd/U5IltLm4BIenTzS0lHr9JUU14cZEslZJuit/MDVCMyN87dUurz5aXBOpHPWcfoKcambtZwmLNf2F9WJpQIcltw9ruEo7GCjhYkJAiSJCe77QYBNFqLxAq6DJXJTKFFQKPUlXyByN1FRFGqIN4apQmCKlyWtJlXz7tl2r0ni21kb5BVp4JZYpCFct99jjBs9C7byUfl6V3GEmw2ulKrWbFpXiXP+/0N+W2r0Fetw+Rk8Cc/vcdqbPAuV+Xm+cG4apdwdDgd5eH6bBn9z+XiuVsx6VDkeY/miSGlUYmB6h9escf6wgNewUFNa4oiAoMbmAvQBFZpTz4VyiHJYPh2Wa/FLRZ28Dz9S7h6cAdRYrcaNcAl0nqya5cqgb6EP7EbvRIinpdtltDBJwOIS87sSaTHdipyOrP7FYsD8xLb4EmHLbFG9Wj8+zuxU/rCb+Mf+CfI6LsZ5sMbRKGivliaCRW7PRmxMEzTEdFpBwjHVoEzMd2rRZHdq8XtqjzRvzxoLluZ3a9G/TqS2Z1UF+obZt+GSV3Wu3Ot3xhRq4keHpohKr22mzVoz9f5jvRmm8hvXcYvc/eO16TtTiQQ7UZT+mkBEQ4dNIq2UB8SlZyFNY1U44bpev1BWkyRNBi8VWTNOQcQI4kDV3zhJ0yVBOCzXP6aJWw4g4MqGQdMuaNsfpRKYd3s2rxdGG2Q/J1Oy7ZfZr6YZ4GPWBTKe9rEvRfkmvBRmuw3Lc1s0ODDRIEDXCNK0olPu+IoWyedopnH5SEenzX6ASXS68dIQiNC0jME9DBbJ7ZGepqOba1E9yMkrLOtIqasSb7p6NFB11hvVEqkbvlcwsSGvFhLfRyv5B9WBDBChFNCPbh/JaqK2vh9T2bhMcO9hQHmWdYLjzCr3B06h0OBSLhqrD1WF7qCJo1VG3KxOhFbPlSlOLes5RqGlgXf1MGu2ayNpdhRoIhsztgzL6g30ecmA6u5sgysszVqsyhP5/PctYkYH5ab3rc7KMyX+n83RUWSyfCfRKPUqonB0NUEDeNsz/bmP8CoQLhbkrzxnj/7wss2WdtoTbAdIkQvev3CU9FPSV8WI/gp0s15Kcq2u61xPweyLeiNw9XXfO7ukxpXAq6TLhBTqpb2/uJBWWzo5g2LBsflf13vaYvrNTH2unNJf7Nr7Czoir0fWSK79zY1VlJAx4yHc9VKnRT7b+Cv21BTs6etl2ETiK+ts8OiXZnI6KaDCQ6QGpeyc9IK3wWVJJJThnO8ifbG+PFUldwYhx4caQROqu1ff16evSeVPoL9xqtb9NVklYJu86q3NjVrb1alfU5YqyPGtv2OUKu5hoo70gv0QM6Z7z888saAyfxu3l+cEew58Ae5H2jfdLpTqtmJWTXrDXO/XTPqj0ex+X89OvbVES1AntsYhruGtAeRXT3D+5yyJoMxrDeptGi3TgnGaLfjp6puEiOaXMIfelfxBgttIudrBFEetmyJqAH+VwHvSCIFgFa5QVRrhVJLIVvtq9/q9p/U5Rwm9mKXOk4rYXbBSqz8GGM9FeuWCJcFrmLNGi1mM8rXI+loWn0QgavSQWCmvkFkVZ6GaDkIP359NwZCHvyoZGpsFTrDe/kd4gRosnMZ/hGxV31qBGSXQEtJHSVETFGG+Um3QyfBcr/T8Znq2sT6adVsCrnhOh/mB/pulYGkebNRRWOnRm0GtRpsrB7MfydBm0XpbnxGCFInw/678dlgJFBj3PESHnmk6VFR0qK4JMZSspxpL3tkefcZ4JMJSCvY4t5FTqP/dXXJ56owl7YxVJui9CgFM9kz90fMaVNqvFQC/n0+YyZoXCmHT8NDrdNBD06UX122xXRGR0ysLAoG32Cdps9KFFscHUP2SMflEea0jXFhxmdV5VUky5jQCm5Ej/u7iTgLlf+eUCf1SrQrJLBPrlGh65zyc9l3fJMTza6dPldMCu/pf7fdIc6fwDoh0sNDPvUGijev4p438EUHPS+IyCv9NhtajtwzR5VLDbFDoIhUooFL8rnxQnMwUtOdS4TPW7KD3+wHS9h2YpyvTwlDgdvIZmKWiOCQtRxe1S6SIuQBfF0cknzbPqAe086tyuBgbVHPpPKHUTfpq9Kt/SKvzbxRN+XLiA4sLwVMId2NpYKF3+B7bbvTc6bvep+VxEz4WU87MAhS1Q7i8r9Qr//iEaA67QicO28JYmc2BnY6HThhO2e713Ou6l67mU3VV6GnzWMKv9lO8hm0Y6nWrtKC1VVmRapw3RWnLVBPKUlPtKwp6wxRIOWKwWK72yCdupJSmAQRnIODHwj9xLK1bhLwpPuXbQjnUbw5G9lz54VTiEP2FKPTqY+sn08bVDO96/Hp90GeJPro8bKH0N8cHZvz/z2KEDXz2974Bid3Kbwfb3gwXURCuORKwTvLA3Wc9DHSgQHZkxaPWcIKiNg0WclRlWC8vQUF/TVNsUi5RXB6pDoaA9FC6ifR7lMwvWVzAvHyx/DTSqUcoW4fpI4KIlS1c/qmaBLd3i6DuetSp4WLZQ2aoc7xpg6V9rJ8FE7e2+KmuFcMa+l2MLMZB99I4ON80AkG/pcLucNP7zb93VweRhgfs6aqlInH9nxyXpmJTc9/YNJo/B58jqfEtlMuXrd93/lonFvB64ZUwsZvfB3SjnIck0OcJo4qV9cmSa0LLptMuhUEYsQJkSd5o22oVoo4ijQuSpUcTkfAqlQzAKjT4MspLK7C6pPYtGabnNTqMLU0qW30AroQCtVFGZR65LVVGZTbHbVX+H3bUCfBREURpHVG9biUbCubHMf+nOFRZUPMe9K/+HctQ57l7plPWt3OP4DRVGtctxLoz/aq9jBuO5+h3fSEOg5+h5vDLd08g552P31sTlPEydFlQwbWRSibGmEayhhkJ5mIrry0j8TvIw3+75AnmY819R8zDraytiNJ2lSK/hURzHs/Iw56+mK/+e8HRO5vdoTuaFvdlLO5xZ9V25uZlFg9lL3JdZ/Y2HcXaeJu1t7WO9rRPotOQs9ep1QM8qgWBNHIjZyIrnCxNz6l0Sc+rdE3NqPjEb6ior/GUet6kIiJnAiZyk1vmM58rhzSxqPgzUdDSs8+Rw4UiaQ6dW5VbTayo9OfzYnGbVJSv4tgxB1b1+hNZNUd9K3es0saFAvD6zm+x0y+fExxfe8moY5hy7fp0iKM+x8Q+rvXHZ3n8I5KUCs7r3C8E8lQsziIAMzOcUASrM55ICjUr46ByC4DpVprL7olhPFBPtMWoyAucqBvm826PsqvOoXh+lAJO+RapIodbFTU2PZukR2mP9bvCTXWCjgZVTwhPaqVZutU5z4UXhmA6LSDymXaDjutsN5nfYHfaXpTuv68/ReZ11gFY96UJt2O9WHepC/dhvy3Ks1Rq+D7LOi1U0r1ktXdBhQYt5JPDza/nK/XZbNOyvKq/yuG0+u4/W9ekXqKZcoEIhv9qwKq8uYX6RX1GhYgQl34DzIAfY7bW0zlhOOMjtkYJFzUK5BKGgy4lQZSxYG6ot8zoDroCaUFC0cJLEQmUX8xMLVuXhVSi54Pz5mKnr8glWU+qhPrynxE3ne9eFpcwBySP3y4pnNJ/KkYxfJNN2DvwiB/OLwIqUaQuOUYnbJfy7STL+BRJlTiqOUSFSHVIdIwafXOfZy+5tYVWwSqVnJsMgu9rTZrM5rFYWTc9UfM7LDcmq/hzOLTrNVIE+nZdTIPcsl+tNq6UKWmhK+t/VXWWs5C+vSfnHwCDLdCj/shwLVHrvv1F4rpXveK68huSHwK7KdCNvZVaUitdqRl/aGZBHGsLLjS1lzISc2SzFxiJlRjFnRjWKm4/hiyyim8HxFTWsm8ZTvpMnITWoVSvjQxlcc2c3mwz6wrMrgbl8nH/DYnMZrFcot/Xk9qCHuXN6wKdx1+TMnun/bvif6z+/wNwr393c77T3PO0Vugt3w9wC8rDeemYB9hPPQvaHbVhpVatk5j+ueDKZ3C/ap/p89EuQxdk9a5XEdw27zX1SzuxlndAX7lm7gHS9NF9FFJCbFIer8QA5A66ZcneByfiO7i4o0utEniAzNmsycOSkxv4yP0X86kzOK557HWTlx8irIK+FR00ibqh2xbBLNjXB2qG9oetxdSvGTkPXkHHLpGiJVSVqq0RO5yBmYbynuN6+dfsfnun3Df7gBdrXl94/TybZfc0+GlEw6Alr7Cl3rJ5Wj+aSQ+mKo1Zu2OX0lDh9Ll84FLaKOnd1sikZaMntxcjaU7ckA5SgbUX4e9zEyk3ry3Ye2nXBqev2XvzbtcfsqW38+tRApT+8b7qjovfyq37w6vsmTtxYHty7O6+/M8rr4/yv/64CfvfKO+gZfYbdQ5h+h/zg7d8hz8+uEcn98jv7iQOdJX8C/mz+rHyxgnw3exHrdE27M4/Ts3M9bddM22Ciw1PsXmIDMjhop2Yby5CV7xY521bsqXLbhsmfrjO4bSUuq913lA5zGOb4Z3oOuSCJzcEGvYpW59MzPH3mypC8OZJqe2ozPqzO4cidwzZ3AN2FBuEdi2RiAwEuhx12irQr83poWH49qsl6m/IW0AHfxGB0oaWP0UtW0qQwUwWKrtLQC6RkahjZz0APqksBWGsRkKvIVeSyWhjQ9M5unEWYUNbP+CYFgwsKUCsbJ4IOAky3ZMOUIZ1ZgeAqCgGjnpFBeUyGcgGYsgmZyPr5YD5IjsIgAUxAZ5xgdHYhh2SVJ6VGz2GHw2FnF4NmUTtZgPLfn7cCOVMgeufLn3AbfkrpPUz5eFIJNWE0amN8rJ4svbWms3NN55861rR3rGH2D5UR30ArQfrbwD6j/X9BuiK8ifWVpEc79A+7MzzMBCrd/oV+wmNeh9PjcTpS31Z+IA7lh2LWQ9Ob9RXgon3oq1kfeuFRgcPpHvRq83m16zzFoQqetWQ/q/TzrZIfXZdu3QvPVgI+jSDzWKTbhgWNHfMCGRRpH3iO8Ny0jrbxxwaCp5GS9gG+scGgGp7hYKDc77NYQ0Ea6A4WGcpAHTI3M5RMtNCe4llBugANgINvBcId/0LXv2T1QWG1dSnWjlh7y2/fNNoRaGgbOuzFGmtKi39r+aHuhsHVHZHLjzc21jYeubqiunxma2NNvPEFyifLcAOHyQN0DWlmmdNcxGmosNawTiBHBdAr6EqtSFgrffqd4A20IToesVrsLMmjWCeUVdtCllAzzQkNxaLNXIijjGRLeHHijfrLcIP2EmKs05OZ6p1EV2tr271jEW7AKysrU6e+WDWZ+gN2jDV+EV+aehl7GS2vR5XkH2QHeL31Uo2WCTu9Tu3ZU7AfvQkZLWCgV2NHQHT6sagDrSWILvKP2T9if8WJytQs5ipPVPgx3hrnXNUnw7gcl4dPVruoSEcfBkL8mlwOo8BOMdLSN4GI7KDxcDGGUQMhSwyc4hg4wrFoTMQ/beHstScjOIiDkZMxD0di2Ft1Ior51FvRE4EwzsWhTqpW7i8E8GmCNb2gG7ObTBDewERrNgq25kCSHr7ogNdakrHriY1hgLnUrIxBg4xB6kzqjIIBw2HuD4DD7jwc+tI44ITF1dKNXTqcdDldSfyJFq40cjKS+lnqZ5GTtXaO7J79Efg6J6KptzAfPVHlxbK8HaD5P+zs2oA8kkuvFTlebtOtqBmrhQhOdgZIaxnoN3z2Nw13/KZh6+cP8587hCdTn4T9vHr2GhzA5QD0z2V4EevdbQRJkK0HQPnBYJaAJUCMs6/Tv0i50/SP7E6MVqlZj9VLb70eosm601TI3GlKE1HGNMMWiy0Uop1hvcrNppktZMYB8KJyLjc1GEaGB/tdbX31jeB3ewfaen6ZdcHp4PCyUI2vNgmeHH4pfckpg42IAFuMZvmApaMhLow1FswhK+Y5fjASJnwfgKMAKTIgBRnITBCFAhpRrgvKAjUnBaHgjawGw/IV3VL7usyx/VjH4kRc1Odezzo40luin71cSU+QPIBH1k2t6P8CNiFPaAAAAAEAAAACAEJjhABvXw889QAfA+gAAAAAzg7uxAAAAADWN/0Z/7r/CQOsA6cAAgAIAAIAAAAAAAB42mNgZGBgkfrHw8DA/Of/rv+9zGsYUhj4GJAAoyYAmrEGuQB42m2Uy0tUYRjGn/c9TYlQll3wUmaoOUnW2JSjOGPenYTRBO1GQUGhoUSodIE2QblRSIIgaNOmi/+BFC1rJRFERrVx46KVRC0ipNPzfp0z6ODAj+eb73K+9/KcI6PYB/4kQ4qypOQRpjSGUlLu3cN9rx+dsgFT0okE2Spz6OXaFe7dJJNoozZqHg5yrpX0kyqyn0TJAdJNbpNK0mf77SzHw+Qc6dVCDHsr6NE9/pKe4v5qdOoNdMsKWeL/Ef6f5riAlPgLWkr9hG4vgnJ9zPXnXI8H2k4txS5ZRlInMai70ewVIa2ev6iCo/LH/8s8ahlzC7WY2qd5/rIUo0ybUK8tzPcrtZUUol7a/XltQ7UmmWsEzbLRf6XgOB8JbwBtmiLH3LkqOyMjXHuHfLmKI5zPyAcc0jk0yFt/Ud77P+SZ/4v31skd3KTuYP7nXUw2/78Hcc6dJu2kiQzaXqujpFHmleOansEA4+5wfWAP9C5OSi3jj2HM+iAzSJKYyynFuF5ijM+9KIoyzo/z/Fmer2F/xwMOM9cGV/918CL+N+uJ68dqCrLEyXG9hZJsP3KJ4bJT68lq2BOt4Jke/42r/zp4Sex0PSlcC/uRcj2JoJLUaZS1C/uRC2sVjDOrsZ5Y75xavnZndeCBUOlFvUS1/DK8l7m7+wN1/qRHXC0sngWkzR/m0TX6GdtkLypcjSzOUK0ujM0bRYf3kM+jh81HWTU/01O5ah53PrM6Wj6hhj43T+XqBXoAZIh88X/qA76PHwHvBb0XaoIfhu/kScAEeU3iXLN3PoAeiupvRGULrpMJsl1mOZ6l32Y5nsGQl0ajnZUBdJAae659F+i5LjJNnobK+RO6mev1fOcS/vw/I0HmiHjaY2Bg0ILDEIYShieMDoy7mISYNJicmOKY+pjOMb1j5mBWY7ZgLmGex3yLxYgliWUdKwerGmsD6xnWP2wmbD5sRWxdbNfYN7A/4DDhyOFYxHGB4w+nDWcaZx3nHM5jnE+45LgCuLq4DnELcAdwz+Dewf2Mh4PHhieLZwLPHp4HPF94JXiteCN4s3h38P7iM+Jr4DvFL8Cfxj+L/xD/FwE9gQiBNQLPBJUEcwQ3CD4TMhAqEdogdEmYSVhHOEq4TfiO8DcRL5EOkROiHEBoIFoiekDMSqxObIW4kLiT+CoJMQkLiQyJJolXkjySfpILJG9JGUg5SfVJHZJ6IK0g7SDdJr1CxkRmmmyW7CbZN3Jqchlyh+QF5Avktyn4KbQp7FNkUPRRzFOcoLhL8Z2SmdIkpRvKcso5ypdUdFS8VFaoPFKVUY1TXaV6R01CrUrtirqe+hKNEI1bmlGaL7QatK5oa2jP0VHQcdJJ0Zmj80jXQfeOnpJeht4Z/Sz9OwYSBhUG+wxZDDMM7xiJGEUZ7TCWM15g/MhExSTHZIvJH9M003VmHGYFZp/Mjcz7zN9YVFgssNhh8cBSyNLPcorlIcs/VjpWKVYLrJ5Ya1iXWB+yEbDJs3lkq2ObY7vPjs0uwm6NfYj9H4cwhw0OjxwdHBc48Tj5Oc1zeuQs4ezn3ON8yoXDxc0lzWWFyxNXHtcIHDDNtcS1yXWO6zbXF25SblZuLW7n3Bnc5dyjgLDAvQ0IH3noeKR49Hkc8/jkKedp4tnk+QwAzSa3sAAAAAABAAABKQA9AAUAAAAAAAIAcgCEAIsAAAGgAQkAAAAAeNqVVD1vE0EQffcBIRBQKEAootgCoSA5R+JEAiKacMThw4AUW9DQXOJLsGL7wtkG4V9BRUFBSU3JT4DQI9FT8iN4Oze+cOBTgla793Z25s3u250DcMFx4cHxpwF8ZM+wgyucZdjFDA4Ue3iH74p9VJ2O4hOYcz4oPomK81nxFHrOT8Wn0HQ3FU+j5o75z+C2+0vxDCrevOKzeO41FZ9D0/ukeBaXfF/xeeLLir/gor+i+CsW/QeKD2gfKf6G0/7bDP/wMOe/x120scs+YB8hRguGPeI8ItpGgn28QSpeL2g1mKf1Gr9VLGKJ44KiZVRobdIr5vcRI0eM6rBZppDzlFx2jCRbgh7tEceWxMX0jLEj9jZz2KgGAqyx12hJ1WIj+kRPGGNQz3d2X/bckdiQKGVLOOv/kzvGBrawiatYZ+5Y+PbpGWOPPUVXcvSYeQOrzFGePcQ9coR4KH53MJQTt0SdgKpYXUyuz3FOYQrneCr76edqHbKOucZMlueQZaHAUp63LdiuDMTDqtEV7fZoS3gb/3ujwV/amwnqG9Xf8AbMEXdg5BaOw3k0l1VmwJVVXGd7LS2QN18eE0gNdEtitwv7GvvWRfWMM6uoobxyy2uVzvRcI1tEv2xWjLGVNPnuJ+8j+oMrEFV2udopcPZpqfNdhFTpMV/CulSu5Sx7H2Wv8hnZtrRS7dqSsDTklIbcCV6J9Zbsusq9LnNmx5t5NdyQc+yQc8hvwixtYUvkX2OZazl/Ay+lsqzS/Ev8BtZA5SQAAHjabdBnbBtlHMfx76917Matu/febTptZ7rbju0OQgppwwjzaju2qXMOFx+hYYs9BUKCVyDWG0DsDQJeAGIvsZHgBXsV8QJQWS2OnwNRiZPuPs/91z33MAIOHYCD+4nyP5caqvcIjZSPkfiow0+AUdQTZDRjCDGWcYxnAhOZxGSmMJVpTGcGM5nFbOYwl3nMZwELWcRilrCUZSyngRWsZBWrWcNawkSqX2+kiWZaaKWNGOtYzwY2sonNbCFOgnaSpEizlW1sZwdH0MGRdLKToziaLnaxm26O4ViO43h6OIETOYmTOYVTsVQnvwLczkVczNPcwDdcwjVcyU3cyR0axRV8zIVcr3oFuZobuYzn+FSjuZm7+IWf+ZXbuIeXeZF72UOGa8nyKjle4hXe5DVe5w2+pZd3eIu3uY88P3Ed7/Mu71Hge/ZzOadRZC99lLC5hTKn04/DAC4VzmCQ7ziTIfZxFudwNo9zK+dxLudzAT/wI09qjEL8xUEOCY3VOI2XNEETNUmTOcBv/M4HmqKpmqbpmqGZfMbnmqXZmqO5mqf53M8DWqCFWqTFWqKl/MGffMGXWqblatAKrdQqntJqrdFahfmKr/mQT/hIEUXVqCY1q0WtalNM67ReG7RRm7RZW3iQh3iUx3ieh3mEF7iUuxXnGZ5VQu1cpaRSSmsrT2ibtmuHP1/a11+IGKIB1y6Gw+GksS1ljHnGw55ePuHVJxo9Y4F4OV+2c3sDltGfzFhO2fZnDcmMU7YqgZRXlPOKUiabM3RYGbeS85cMHSZYquHryJYrvlL14e80advQaarsGqGdBdfOW47bV7LcSqj83zd/l2lwDF2mzzHsMsEBw24TrNSo63aKdr7OHX6Gug+b7x42v8c0D9UI9lS3amUyObsSHPp3Wf21vj1Zq3ZmTcm2YaPVQ/eMeEY9Gz2bPJs9WzxbPf+ZE/OMGyPe3Egk2FvMu04uaw0UTCiaNjanfSnXKddbjlMeLOV6K4Hayu0P1nSK+ULFJLPlQbvW05xuHzadMNutGv0bFh43ynjaY/DewXAiKGIjI2Nf5AbGnRwMHAzJBRsZ2J0cOBkYIj0ttRnYGbTAfIE0ljgWPw47DgN2NVY5FnYOqHAWUxJTGJsbmzmrNrMSE1iYz8mRU/KA+AHhA/wHeBw4D7AfAJrCCZQQBUowOKBAsAQzg8tGFcaOwIgNDh0RG5lTXDZqgHg7OBhAXAaXSOmN6iCBXRwNDIwsDh3JIRBhEHAQyGBKYApgc2AzYtVgVmBi59Hawfi/dQNL70YmBpfNrClsDC4uAAT6NYUAAAFaEkyaAAA=') format('woff');
+}
+@font-face {
+font-family: Fira;
+font-style: italic;
+font-weight: 400;
+font-stretch: normal;
+src: url('data:application/font-woff;charset=utf-8;base64,d09GRgABAAAAAG9wABMAAAAA8/gAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAABGRlRNAAABqAAAABwAAAAcejWA3kdERUYAAAHEAAAAHgAAAB4AJwEvR1BPUwAAAeQAAAyQAAAuNi8bnAhHU1VCAAAOdAAAApcAAAeEea4ezk9TLzIAABEMAAAAWgAAAGA65/lkY21hcAAAEWgAAAJeAAADfi1PSJpjdnQgAAATyAAAAG4AAADcLSQTsGZwZ20AABQ4AAAGcAAADW04JI58Z2FzcAAAGqgAAAAIAAAACAAAABBnbHlmAAAasAAASU4AAJgYGuFZomhlYWQAAGQAAAAANgAAADYG6y/XaGhlYQAAZDgAAAAjAAAAJAeZAxNobXR4AABkXAAAApoAAASkVmQuQ2xvY2EAAGb4AAACSQAAAlR76aKMbWF4cAAAaUQAAAAgAAAAIAPMAahuYW1lAABpZAAAAjAAAAVSayG0z3Bvc3QAAGuUAAADDAAABL0OhfQ0cHJlcAAAbqAAAADHAAAA5wgX+o93ZWJmAABvaAAAAAYAAAAGTJtaEgAAAAEAAAAA1e6U9QAAAADODu7OAAAAANY3/RoAAQAAAAwAAAAWAAAAAgABAAEBKAABAAQAAAACAAAAAHjaxZoLcBXVGcf/e0kghEcEA4RAQkIAo4IvFF+oQOQh6GARX3SsLYzjtDoOQxlnamnH6Yxvbe1D8RGfVUTxkbHFB2pp6fURxWgNbW9t09qIZDqu6B3L0nF1tr9zdu8ruTfkcWn3m//Z3XPOd853vu9/ztnde+VIKte1ukclZy46e6Wq13xv3ZVqvHzdZVdozpXfWn+VzlQJdRQEinFyer1r1ND5qxbWqbFp/kqTrjDpOcvPJl2x/BzSlSuWkWZpxNas/e5ajb7isnVXqdLmyKaUaKhG23uHElN7iF4bsrnM5b5cpUg5VxdoumboMNo8XEfoSM3ULB2lo3WMjtVxmq3jdYLm6ESdpJN1ik7VXJ2m03WdrtcNulE36Wbdolt1m36sn+h2/VQ/08/1C92hO7VRd+lu/HKv7tP9ekAP6iE9rF/qVb2uVr2lt/WO/qB2/VF/1l/0V3XoH/qnPtRH6tK/9LE+0adK6nPt0379R1/oSycmJzbHemylntVO7dVOp8wZ68x0TndWOt9w1jp3OpudNqeNUsTZ5byPfAD2OF/GYtoZK4uNBWWxutiMGIf2mrpo7MqS9zNC2fuxGCjLiJ4ljRmk6tr2EGcP+TPR2mssw7Y20qEaF3RpfNCpCUFSEwNPk4KEagJfZaqkZFywhVJfVZRUU2MSNSdzrglcq+tS2oWui65PaZvVjXHlOg4lQ9H8zJaF2km0PVunBG0PbS/qNUnETTtVti1T16VeF20ZC2vIMRqdUf4XtO5rODYmNQ7N8UYbVAXttr1qak22NVM9TbD2Ja1Vw6O+k+R66CRtj9WRHTWBZ2s59s5xHFWY1OSQxunlGdIW/LSV3l4K4uTaeuib1E2P34fTo3WuJulSpw7OOdZ6kxoflapWo2nJgS8VOkRjNJaZMJ5xVGmiqtGarBrqTFGd6jWVmdAYMf4kuH6amrRIS3Ue2hfqYq3SJVqtdbpaG3L4f0cW05vhuuH4I3peL+hFbdNLelmvaId+rzjMN6z/ULvlwpDPYPd+hhNzxsDhcU6VM9GpllPaaBk+StOcZ52dcKrS2RlbCq51dpbMKJlXskprVGa96RMBXw34aTpxO4zrI8FscAI4kTonBS06metTuD6V81zqnRa0aiGeXEzeEnAWWMpasIzzeeB8cBH+WkXe1/HhJZwvJ+86dK8HN4AbwU3gZnALuJW2N4K7wN3gHnAvuA/cDx4AD4KHwMP0/yj9bwKPgc3gcfAE2AKepK+nwNPgGdACtoLnwQvgRbANvAReATuwLw5exY7X0H+dPt4gv5Xzm5x3gjbwLngPtJO/i/OHnHdz/ojzHs4fg0/ApyCJ3z4nfx/YH7Q6scB3DlW5UwnGgwngMNBIv0N1CL2OBU3wGt47zGXHcN2U+JT4lPiU+JT4jonbCFXA9jH0VMe5HkwFq7m/mnMzeDnocih3xpI3itp+uq06UA+mhu2i4aPho5HbR0ortC1Xy+umlbH522h1oNWMdZ1oNqsWC6ZYSztooYMWOuBbogffmqi7EMsXMwOXgLPAMvA1dFdYbrlaafnl6gLOF4KLwWr6uZy8dXb0HbqG8wbLtwR8S8C3BHxLwLcEfEvAt0RBvjWjbzj3KHZsAo+BzeBx8ATYAp6kr6fA0+AZ0AK2gucsx1w45sIxF465cMzFQx3wzNVvKN8Ofgt+B17FjtdoL+SbG/HNhW8ufHPhmwvf3Ihvrv6EzgegM809N+KeK5e8veAz8G/gEXnDOWIAAzqJUDMRanZYRYlSs2VWnOjE8Xqc0jilcUripoS5OxY0qcIZB6pANfezKakNo8q51q57tdSqJWIeEfOImEfEPCLlESVPq6h7CQgj5LH21bL21eJBDw96eNDDgx4e9PCgh/c8vOfhPQ/veXjPw3OedqAfB29w/SbYCdrAu+A9sAvsBnvgYGrEhwYtTiUYp1pnPOcJoIrriaAaG2KskuWIWNFrWOEfQUY4Zi8ZqVjD7WYNnaL6JVrCs4uC9qAj8IJ4kEQ8JGl2RVbOjqCLK8P4cnbWCnvfgaWDOgIXVog2s/M84NOzT9++tQBJ57vWKm+A/fk27QgSSLJHKeOz586gDcb20BvUSAtaHPq5W18Vg+zNjo1Yhl60cbQ5XTleDv1qnjgSAfuUiYaFZ9fcA3qS2dhPzw9yVJ1BK7GDdVhXoVkhR+FjZKvlbns3Cyuju660j8stj/xC1gdbg+20swWfbMvy2ERaTxgd89TFk6iCbdTaxlzIM8bc0VpL/J58i+wyMUh0j56x0EbItzMk07JnZks6nslQvzvPUrqFZl3OXa7HuvGe9jN9J4L1tu8MizpyGded89Zfnd38UdtX/qZmR7/mdjLbs+SVBvuiGeBG7bnptSQZ+ik91mRu733pmZUCDtAXKwa86bIrlGvmki1tNWJW3pCNlCe4byB3E3Va0N0emB2wMthua7tRm22DnCl+39aeA863rtTahG1eNG+8iJtp39kSM+oksa5knrDDMc52y1yzlph1KJp/+WdB5H83ZXfuOtUtwn6K/6ACndbUPpKa3bl1C+48bXYHC+1qsBzxM/3ZVaYjZ2Z44Vpi55zbbS3xD8iSOB7piNYXu4NZ/ll2U9ZhrEnP23bLklryNmLFNiRhfcIub9nr5s69PDtKW9CZd38rzJXySDPZ150Lq+J4sSVnvplRWZ/SfyLcv9Nrh11xU+tutsciFtm9vV+7aK3mZt1NzESfY260h5ZHZY32ujKdU05OtDfYsgZy5hbut7cI92cfPNDzUPGfLwa3MxdzbIXnfvqYn3N3bsjyXufXIpsuG5BJDUUamVd4r/1/HAW4UDmYp7CB82uAHvV72eO78qx4fjZfc3YNr5deugYyLrtX+33wZUN/fJhZKwcWje72HOgJvsAxcaAs6cPszrMv5nqyQBuNxXmfiNYSr59RS+Z7V+zDyCsH6BN3IFrFeF/My0k/fII/ABPLD7qFB2ZJwagP1J9FjENpwZLwbagip2ZpVlmlfZZJWdRq3tZ4Z0jmvhfZt2IvnE89382KvI9/lXr6zm6z5/PcIJ4TEv2ztlhx4pnV7wsTbdocfFocXhf+NvA/OhqK5r3W/n0PHAwnw68zOW8jtvdga3ZeX1lSjKebwbfBmLqyv8eknmzCHcG8UeV57klmdvp8b2/93SEzb+B5nzG8zG4Q/LAYfur5ZfLg7yEFv8V5g32aMV9z8q2+vc+AYEtvz6h9WwEP9vtH+C0odd33VRmPeP1/8wy/MvV/lRgY/8NvQf1hUXoODIwlramZnDvXC40o7C1oLmxjLyXJge6mxfjNw34bNczZli/qRX2nrNRxRdnxGqIvScWbOd/sJzuSGX4d9BVxE2tPe3BbevWP98bInvtP3+ZAsD5a5+L296V44fjn8hj+tOXnZcrKFLPtm53bY8Xy+rpWFdoV+j4HmGXm22ei8Irc7VcXP3usve08qd8+ixr3liI0ctwASgof59v0RDsDeA7P/QXE+iDMd3v+NpL9xpztvXye7HY4KnPqNSK6C78lLtZ8LbBfIsuiOuaosfdlmocstrIwKo2RO0Ql0VvbKA3VMHtVpuGgnNZHkjs6/b+qRVFvpodxtDues/mfVeow/7aS/b9VjX0HNP+5kv3XVQPptEh/AS0VOprAvOh6cVZ+Ku/MvFpDGMmQSFJHWTTqUBaDUZGM4boG+zMywf5fLJTwS9LE9DhCWWxHFB71XNdbD5j/W8bSfRk7Jlik3oKH4Y/Qo5PstWnToMy2NgEP11qMwFMpjLSRCGF8Pi2N7JEVPhYgZyDzo3SejVZTAc9Ninh0RDrnWPsWXw8X6rvVTY3yaKTUiol8XZZFZanvcNFMSmkcQS+zbIyqYdtR6X5MD9PszmVkTrS7zbbpdKQhwpE6gXQ4vppBekykPzRqKd+uOMzamfsFY3pW3tR0zbocye/bDI9KwaxISqyt03KkIS3mmIKEY0hJqb0PZTg1htPnNNpssFA3hHnT81g03SKjFx7mv70pmLk/izoGxufHpNE3Hg1Fjkfqo/RoG61hWZ7LHHOQGD2V2TZHIo79f1KMZ5tK2jHzahixr6Z8MvYOtzEdY62pwodnwMMmpJGVabEO11laqplarnOpsUIrqXWBLqLeKl1KT6u1RnO1Fjld65AzdDUyTxuQ+boWWaDrdDvt3YEs10a10NKv9Gt9R8/pFV2pHXpd69WKXKO3kO/rbWSD3lG7fmD/qfwj/U1/p5UPkBvVqd26SXuU1K36HLlL+5C7tV9f6R4n5sT0kDPGqdbDzmSnRk86jU6jnv4v2S7vrnjarZXrS1RRFMV/d2acatQ0s0mGCgszK7Mye5dkqYT5YhokRCLR6kOiMRoVREH0zt7vtz0+Rn9A36MiIqIiKiIiIqIiIqMIwdZ96C0JGR8c7l733rPXOnvfe/Y+GECAo7zEV1hcGiFUtzXaQPb66NoN5DfUtjRSiU8+dHZaaODBG9ObLPwF1UXpZC0riJg2bNqyilLZcEWZbCS8QranTl1tQwuhddHaOtKbovWN5Ddv2thMoeWRJJvYvWIcfoYwlGHKIJ4EzZg+wy0LI8ggm0VilhKhhnoaaGEbu2jlJBe5wU3Lz1D2fmEcl2k3Soydxm3r2TA6bPRkOljlYKuD92z0BhwMO9jmYLuNvnIHbzn41MY4v4M5dhxxn5VXgjLbzma26J2XUQQZLTSjTBGmkaf/YT4ZjJS3z8k6ScNDKmPlM14jsdc5m+3t1jO1GTRVUydZc0FyY9Ls4tkMk0ufeAYhXam65ljfMXmAeXR9bYMcR6/3KHAYqZqZoe8ZG8flBYW5in1BH5guO03eeczTPl/SR76rEdLeN9fPZynF/VBxlcZoR9uxFLJcddc/LVdvnOq7K64SygkPQNFVTVfPcGOsVHdYNUBdV3uCutHf8VZRzepBUHdXyFC3+zf2Gtaouw3OGvY6BlOcTkoMu///FeiLmZnirJtsdfYiVlr93fSGJo0AOzTiLf9gD3/zroqJZDJJZ8lkxT1VXX+aane6qnGmKmuW6mO2IpurnTlfu2mh/v1i/aPd7GEv+9jPAQ7qTDjEYY7oLDjGcU7ohDjFac5wlnOc5wKXdDpcoY2rXOM6d7jLfR7wkEc85gnPeM4LXvGaN7zlHe/5wEc+8YWvfOM7P/jJL37TYXiUW0BXkzJysv0DynOOjgB42mNgYWJjnMDAysDC1MUU8f8rgzeIZjBkjGMwYrTh4mDiZmNmZWBgYmBpYGB478CgUM2ABBgbGXh/MzEL/tdkOMEixfhFgYFhMkiciZ9pI5BSYOAGAM9mDnMAAHjarZJHTNRBFIe/t7uCYgNpS/+DLCA2sAKKFQF7RVEUxIgaYyOgsYIHsSMgxoKKmtjFXlARkUQ5eNcYMfFvLCePRhLBHceFGBIPXpxk3puS+d7k93uAlfYZjOiIFOqduPY2ydR5DuPoQh+96kkRh6hGibt4SZCESbwkSYqkS4ZkSa7kSb4UWZosby3vrHW2N4aH4WMEGqFGhBFlDDaSjByjJjwivNLx0tHWalHqdzXNNFzMs2KTHmKXUImTREmWNJklmZIty2WdbO7ExPA07EZwBzOxg1nuYopmivquPqlXqkm9UI2qXtWq++qCqlanVJWqVBWqTJWqElXsTHA6nJE/U9tiP1hNp9lq/jBbzG/mV/Oj2WAWvHe+r2jOao51i2rX5D8PN4uHS2n+oguWjpX1H4z2lzbtjBvudKUbHnSnh9azF73xxEs75o0Pvvjhj50AAgnSnoYQSpjWPJwI+hKJgyiiiaEfsfRnAAMZxGDiiGcIQxnGcEYwkgQSSWIUo0lmDGN1R4xnAhNJYRKppJHOZKYwlWlMZwYzmcVs3TdzmUcG81lAJgtZRBaLWUI2OSwll2X6//vYz0Ht/1FOco6LXOASV7jMVWq4wXVucos73OYu93jAQ2p5RB2PaeApz2jUhI2sZBVrJIBtnKeAdWKwhbX65gCnddzk0mk1Wztpt55iHa9Rzy5WkP/nfAM7JZA8SthLFZ/5oru8j/iJv3iLD0/EwXNatPRhEiwhEi0x+s128RW7znsoYzfllHKYSo5QwXFO6PNjnOGs7u/XOLVlha46ih3tBX8BXeytyAAAeNpjYCATJAKhN4M3kwkDA5Pd/28I/v9v/7+BRIBiSUDoxeDFtBGohp+B4b82097/X5ik/3/5r42QA4q8Z1IAik0Ay0LZKHrfIXQzc0L1+wOhLRDe/2/F8PS/CYzP9JjRjuklowWDIlMlAPHFOeQAAHjarVZpdxM3FNV4SwjZSEhomZbKCKc01hhKWQIYCDNxXHAXJ0A7A6WdiR26L9CN7vuCf82bpD2HfuOn9T7JNgkk9LSn/uB3JV3prXoaElqSuBLWIikbd8XoUoMKl66GdNSlg1F8Q3auhJQpJX8NikHRaqkVt1gkEZEI1MKacEQQ+x45mmR8w6OMlm1J95qUm7m6dtDZGdRaNSrUwiJlS9HytbCoim4nlNRsYmo+ciXNMZqLIpladtKmg5jqjiQd5vXDzLzXDCWs6SSShpphjBnJa0OMjjM6HrtxFEUurKWhoEViOSTRYDJYgdugfYz2NZK746LFjLt5sRJF7SQipxxFikQzXI0ij7JaQnOulMCXfNAMKa98KigfnoMae5TTCp7Idppf8SWvsI+utZn/aSCutSg7W8RiIDuyAwXp4XwJYVkK46abLEehioqRpPlLIdZcDkZXv0d5TQNBeU1kbGwLGCpfIUfKTyizcoOcFqyg/KxHA1qyqcPwJSdWJJ9A83HElHjBmDqo1waGRVDzZ4v9bO3Qm7M3ZE9xyjAhgN+xrHVUwpk0ERYuZ4GkCyN7ViKfKlmwKnZus50OYJdw77u2cdOwNg6t7RzKojxcVYxmix6N6DSTqVE7WfBoVIMoJY0EF3k7gPIjGuXRMkajGHk0hmPGTUgkItCCXhoLYtmJJY0haB6N68blMM21F6IDNLKqbnu0SzeWwsYlO+kWMT9p5id0KsaDK2E6Ph6Qk/g0VuYqRzX56Qj/jeKPnGlkIltqhikHD976HeQXakdniwrbeti167wFl4dnInhSh/11zG5O1TYJTIWYVIhWQOLsmuM4JleTWqQiU7sc0rjyZY2GUXw7FQrOlzHU/zkx4Ygx4fudOJ0olOlO2d2PMO2Gb5Nlj6Z06rCcRpxZ7tFpluVjOs2xfFyneZZ7dVpg6ep0gOUTOh1k+aROd7B8Rqte3KkQI8JKVsi5zhfEo9kNi9P9xZt2sbxhcaa/eMsu7tOCRsr/wb+n4N8+2CXhH8si/GO5H/6xVPCP5QH4x7IE/1jOwD+WT8M/lgfhH0utZdWUqaehdiKWAXIbByaVuHqaa7WiySuTh1t4CBegLrfJokrmFPfQRzJc9v5wL7XpcKHGlUaHZtO8M1UL0f/Yy2c3hGc7zhEtjxnLn8NpllN7WCcu65a28LyY/kPwb+GsmkuPOFPs61HEAw5sbT8uSTLn0TFd2VP16Pg/UVHQLdBPIEViuiQrss6NAKG90OnUVR2dI8Qbg0aL7nDccaZ2I8Jz6FjTtAu0HJpoydDSIeHTjqC82qkoKasdnHlyM01W7HmUU36PLSnmXjK/FK5nZFa665mZ7N7I5/46iFatzA61iJsdPHhNY+5x9gHKBHFbUTZI2ljOBIkLHHN/e3BPAtPQ9dUicqygYZEfp8HAaMF5WyhRtpPm0DyQjDwKLv/QqTiRvSoZI/DftB30vi4UwqleLCRm8zPdWKgqwnS6v0SDZn1R1VkpZ7HaDyE7YyNN4nJYkVW83Wx9d1KyXd1UUKGE0YWNnwk2iVtVezdbikv+zAZLgl66Yv6WeNDlXorPon9UOIqLtCsImy5eUlmNKmnF2Y17e27T6rLb3LQ6v+XeR+04r2mu/CiFvqaT5Q5s4xqDU9tSkdAKVbAjMC5zfc7YyCc0pHzrOheowvWp4ObZ8xfQmPDG9Lb8y5Ku/19VzD5xH6sqtKoN9VKMunbW0IDnyr2oLGJ0slxU3bh0vemHoI4QTNlrj28Q3PDJCh3FLX9+m/kLOM7ZPUnHgC9qOgHR4CjWEG65iAe3F60XNBc0NQBf1GtoYQAvATgMXtZrjplpApiZJebUAJaZw+AScxhcZg6DK3odvfA80CtAjkGv6nXHzoVAdi5insPoKvMMusY8g15jnkHXWWcA8DrrZPAG62QQs04GCXMWAVaYw6DFHAZt5jBYNXb5QDeMXYzeNHYxesvYxehtYxejd4xdjN41djF6z9jF6H3E+FQ/gR+YEZ0F/NDCc4AfcdDNaB6jm3hru5xbFjLnY8NxupxPsPl0/9RPzcjs+MxC3vG5hUy/jXO6hC8sZMKXFjLhK3Cr/fO+NiND/8ZCpn9rIdO/w84u4XsLmfCDhUz4Edwz/fN+MiND/9lCpv9iIdN/xc4u4TcLmfC7hUy4o9d35DK9L1q/TIOrlD3QvN17or2/Aco707MAAQAB//8AD3jazb0HfFxXlTD+7n1v5k2RZjRd06SpGo1GfSSNusayLckqtiRLlmRbkrviGscldhLHSewkDnGaUwkEyEfbZVM2JoUNJLC0FGApgV1YAt8uCx8JS0goYQkhHv3Pue+9aRo5WWD397d/mpFm3nv33HNPv+ecy1HOz3Gkin6A4zmRqz1PuLrOT4vCvl81nlerftT5aZ7Cr9x5Hj9W4cefFtX73+n8NMHP4ya/KRI3Bf1E++rzz9MPXNjlp9McR7nQ4pvcL+l5eGYxV570EEI4Mshx3OgQRwjdwlE6RYeDQTOvd8QSoiVOm1rijXarOhj4xHjVgecrvWWVlWXe1w3kOxf2tVdWtkfhmbeSh8jH2TNFzpG0UgJwz/Lw6FFu2GQylQj60pglaIrjz3dWbb9n1Xa4QZ16m6hhYLi/BF5q4X43V86tSfYZRErUAqU8oTuLiE43OlRi1PAcp50t1lOtdv2QivD8GD/s8XjKPeVlXrfLWeqw26wWs0n+V2LSe2MkKMbFoBhMsJ9EnP3ERfajgjcanmpdp5mJrq26pWpt1YhmQ9s67XTV2tit8LM29VzrLW3k+ZdX/w38W/1y38fhX9/LLyO8hLMv7qImfoyr5OLJeq+b8rRMq+EJrwZc8oMwIYCcX+AQDVOAVW4WbxoJeyqsiImwVW0kwURFJFFG4o0tzU0VkVrS3NTSQ+Ki3SFWBANqm9XuKCPkwjU7SkZL9vd31q1rSE63rNs+sX/Gss4y3d+yarZtRWJiy/g3Jq7S3H5n8WBHZdlQa02T0zc70H+JeM/79V1dHa0N0QaPbyOn4o4s/pQvp1+B9TFwLi7MNXDrk6OAYxUZBKgHCFH3A4BUJHSBE7VEUInCggag5+c5nt8wxKlU6nlOrZ5SD3vcKqG+tqoy4HOHPWGnw2LSawWDyqDTW2NaEiEqBnu8ESblQJqpaGbkYyn8MX3nwre6aH1qR1W80j8bvWrjRP/E3Njqyefz/qYPXOivpE+v7u2uqr42WjMztmd81cz2Dan/k/cB0lLN4pv8NXQv0FKAG0z2lxM1AfrGlVFzJzmVlohUJS5wQFxETclOnKYwzwnClDDs9RDOE/AGnKVWs6FII6pVAs+5iRsnF25sAfrxi0EDnwbfZlWLZQTmJoaam0j7TS8GD2hJi/ZAyejRT8xd+b6njgxufu5TdP3BlZcZiLb3yQ8MD4/feXTV6Ws/+c113Tuu1W8aJz++er/tzpWMpoCHuF8zHrIkS/CTWU7inxKqt8dkzkG2gWsrFw+RjfwQV8SpHy9Sk/oYUZuAYkQkI3OCbPxuU9OKoY4bD/OBt1P/77JHJiuv+fv9DxPHVfDUxbfg3ir5XpGDex2RFlMTI0abldYl4N6Vg+1nbou+Tdx468nz+x5O/adE90myh7xA/wOoKJ4sKS7S67QSkigp5vqHHvOOTj8F1M6Nc8PuJ/CXIzNJLdxo4AwUUEjEhEN0iBExkogkHBHSUHKL+67da0aHhnbe7T5rpP9xf+ekb3/i1PXxw77JzvthvI3cCfIy+R2n56LJCvibnOYEXrge5AvPc5MoZvg5kAUcv1bierXeFbMw/pb4fsc584T5Tt2d8HqOzN577/A99+A8Fn+3uJH7FHcN4ACklV6WgIQ7DRg/YgsgvhPyAjNGLYuWeyvcM729jnZvZdhTVnP/Q1aGjw5iJlvJFliz0qSNsftkht2lhSP+hJ9sSP0/PXET81r43Afy9yEYW6us8zzcMkWGg2zclrS09cmS1isJWTZe+eL95Nd8FYynfhzot56xHPl16qphciNvfOdmD3+UydOWxTepjj7L6bhSrjIZFrJYGWT8vCTjCeewmYxqgdMRnQqXB3k03tgNNOSwGmiaysmKgR17W0Yr5pxth9fNbfvQ8Zld9MiLTz956SO7nnxi8Nw9m0+d+Nkr1zL41sDLz4GGdbheQBV8WrcgjRA6ByOP0WH4RMfpTCarCnWMBeghzsdFf+JPPZ8Ovz46dIc2tU87SOmO3jMX7h8chOd64Lm/hfk4uYpkEKiUo/BY0A/ynGRmGQMkVphKUcQSq0El+uGROBsQqGKEzeS3bl9/1RZfA2m2pnZpfnBvon5woHPriZl5agkMd07UTLmjI2s+/5nRmuah2j2bJZw7F98kb8PYYa4t2eJyUl4IgHAXQXZQEPU8gMKD1BQE1TyISYZgbh5unOKGgyF/MBRAmgwzmRdJ2Jm4j5GEJPYVuGyoEEDc/+yGS1Yf9/e2b18xdFOlrXT1huamgdGqrZdObRtZTdpXfnfb1c11DYMjaw71D6+oqu3uGJkY6JyzCUXjCGcAXn4PcBoQRxqRCgPIK6eBPShqJW6XhCHAuswoYWQRf4I4eMYx5LUp64w19XMN4Yd/8WRgxD71iU98YgX5vj81/sQT8Hw/0JQW1tbFdSXb7YSqEQU8BRQgJshJTg0yVQ2oUKmEWcDHaDYqAsCdgAtR787DBaAgaIGFEtn6vHLDpV2Hgitbp/pH9le2DMTIHnvqj87WpuHNbx+/raYm3js3e6SUbBr4J+d2RudNsDZ/gDnbuSA3kFxtBblgg0FdPAWhBIQjgiojwoI6R5Up9F/qAGYscwRLgxZTsV5UcXZi10h8IHYTaVkYE5jjjaCVRfhYUmIANtm54pCjYktkdO6OXfP7//7MdHNt5Z7IlnLa1bR6gh6580RN7fbNJ+48dukPibaq0/tOS1WlfXRk38zlEk1dBrh0AS7VsrXUny3vLSgHkLFBctCS1NPrSXvqi3ryYbrvwk1eOjkENOdla/EsZwV7Kco1JRvC7iIqwCoMomXEJMqGIYFQquDf77PbfFF/1FZuL49WqFEuWcX0BBPM/MAFkKwRnKYlgDYI/km177vi5mO7jn6iqv7yhel9qd/1T67cdHXvqZPdvXvbqWt3suHY5it2jt3Y4ZioWb+w8cIPRztrkp7EZY0dtONQxSpry+ZYHNZqYPE/mUwyA8w1ySq0kMigGeYOcOJabucUyPlhq8XttJRby0NhFcribpIwkBytawFtzKgHQV175jFr+Y6qVVtu3bVzz4/++e+im8vVx7omWuLhW7YHKvfNHLj1yv3ffK2RbKqqrPLdtXWsdTWOh3L438ibKIc5b9KFRhuHRluWRA4GAyhMMjLZvEQ6F+VIafJhRVhTpmPw+UVAndXJqKJlwN7igFkIOQWj8XRKFmOUXxcM29hwOaonM2JGCbXIY2aUEblCGZeA8j1M3qQRoC3QEajfa0gi7Cgm5KOpx4rIlZ7UI6Tm8ENzDw2du43x0FruMfIK+Tyz3QPJclmi7VyizWQzPgxUif/Jc6mbtOS4kb0+tvbQWryqH8b+RfbYFpWoitSQ+8loUepGD1mf+i6NZI09Avz7A6AJLVeBesrlLC4Slsp2ZTlq8pfDYgW+bG7q5rNFqUF1WMbPAD+ua+jra4jXDq3qmD0yscsda2qOueWlspiKDE5nY39lsKkvPNAyt76tKllR5nTHAK6OxRj/OYCrlmvjziaNZUQjtJqpSgPYEPnBocdqR6eTVZygIxqVoFkAy1hmOS1B8QKkTceGOFFk3DcJxlCyLnMxyCZ+Kv8WLu+OmaSlvq6lqa6tvi0UCobCoVBAr/fEVA6JYbm0dKojGc5w8GpFr0iCipffe0gF/XDJ0T1Pv0xKf/r4S9fsrltBBef6+pUTZ/eNDwd1K9vXfeiWZ/79k3fuLusbrwmuqS7zLfRHvn3+VRJ99t47v9XSQOrj89O33V+Z+tn0vddddfsfnz/3KRo/dKijfcNvTUjr/xdebCDPRLDUQPtwAqyaABqH0tEhFWp+UDyg87VwgQiEpAa174+ALU3iFj2J8+SJ8tR/DW4nTcfPvnTfy8lHHqHnL6yjm1IfIVtRXvLcCnh+I5OXBq6M60l2usGYIIPgr6DbQnYCqahmQbSPDqGoZ+pnTBjWiOCpWZlwN2gMKjCaiFrDTHnUwShD2LvKqo4RS5YaDn70uhPlD/SuuWaXm2w8d+NLE5+79PBwD+nqH7n5wFtkRV/3xA8+s+MwPT852DJnEPRjkkzvApncCzRj4xLJJgOwkJEHkSIAyaCZwLM1RqGcIWjCmUuY4rERm0p2MRxp50hxBMmq2Kpo7dSJQzd9/szRobaOtZtP9bn9K0buuf3zrwy2xs9/4iXJh0YczbM1KEFegiH4WRh3lA1JZyXLi3DG4iId2HwizFsaEnHAEwUH3OJlZ7/W10ue+sInn5742Ps+PPTwx7924edk4isv0/O3sXniODoYR7HJmZcO38gLAEMq+M/Y5MTPLHLQ8xY/+a/U7z2val/1kjJt6vQEOUp3/mT4tWF4ovRsHn7TcsGkL+vZikHBvH72VJXeKT+VB/uBvJF6x/sT7U/C8xPkAN35y6HUd9jzcE2mYE0cXHeyA6iFaIiKgsmiAtNIJewEnMhciP7EPNIO6ErCYSShxKDXAp4cxCECnlQ+U/aaIEsFI3Hw91ek3vnS2avGu3qm5m7425VdzlP8Lyu3FZHoV3403N766Y/+a/DFkdRnVyh428vw5k+WAYcQTiC7UF2PDqEjM8Zl4csPc4J5xXm/JU4d85HUq5H5ifkgKQ3Ok5WpZ+n51L8Tn/RM7s20zwjmA8rLMcVnjMMTHoT74ALweb69eJT7E8NtcVKHNjk3bCN6W0yMgHqFoQzEa+lLaPrn1xTNn11bOjBA+y48sm1vmrb2snG0XCxZqVEB35FBsDhwSGBwNqgAXC9oBa2ohut4YHJbzAKTAOKKE8ubE7A04VdJ7EDqpV8x9oYfchDw90zqLoWuyFdgDBXnTNqluYD9MidPyFSC8SiQ2oAT8ljq3MT8EHHDMz4qxWMAPlxxC1J+iUYAJQtKBB1Dwp0UsnFsMdlsjHgAxeDQ8/BfLSKq8T99anOxUCT8YNNWwWTt23jr1TPCt68nW++YTPHkwqntqY8A4rXkD1yaD47AmEauLOnWUeaToOQfHSLSUDaTjWlMP4xhlcdoAkxT38kXBVN048RV3xDM0Rnav+fW1GMwlad23gP2H8M30u0poFsj52XytKBNZyoptZd4Td6KkIrZc7LL1k2ZIddN0TwyUPCWTlUMnVp/9GZ8PXI29bnk5jrbB3tm6+zkwXV3nRy+831r77p25O6Uc+XBoz3Prbr0SPcL6TXvZvLEjPaaCqUI2AZgGJAcdiScyWhICxU1GtCyUAmjUAHzHuGpG9304bEgufyua/aXz088fOVpMjC9/kjqJ48cvuECPb+dzfl+eiPM2cL5uYZkLUXBPqgGSusvPH2b1eOy+m3+iko2/RIjYQGQINqyBXDwBLlsYKDp8OzRmwrgIfXLrby6ZbwpSm4vgA0JF+2AiyKwuBuTdeB6CwAbkZh4J8g9WdTKRGYoBqVjNVj94GyJQAEcWqyM1gAXvKx2aPv29R/ad+vOIKLjzPDEfePldMPHLzOlvk1CqR8BpT0zMrDzbYnWCNhJfwLcBJH7SkG3OEU1LzlfimLJ9jurwgE5zsg8rdwoY0aKsRDjK7cdGLiysrNuXX1yOrF2+8SJbddMtayabe1NrN86/o2NJxurOqPlQ621zU7f5v7hvcPdHQk5rAhwNQJeooxG3MlSFo6R8KC4mpLJSHDi4GpS2+cH5wef05Ff0S0XHqRbxtjcxoDW98MzbCgXWZhA4vwt0mTg1cbZwrYgxgoIL1s7KLBkZyxhofvbDDfv3n+UT8y38it6V01oYa1S8UMn9+xwlJJ/TK1wWVd2jQ2R70gxG4B5F4PZljQjzBlwWcw7DGwKEMeJmn97e+pru27fvpsOoLyCe/tghuOM5yPJULGWR1t5EFxNPovtYRAjZ7SYLCABYe48W3c+LkkYCz/+7yfahS8fa90YEr65swesTJSFtRdegveH6OSFR+k4rPaPZHpjEXqdCM8H34EwWJlxSYctZouJRdWlJ/MSef34gwsHhU/vfe3vF04JL+4ll5LeRYA69eXULaQ29ZJESw3w7BGmB8DaFwUmyQH+jPKAVy2nNZsF5obC0rEh6Ejqdd8W399tv1r4FmB3KvUWKNNPpf6ejCF1wjNF9kyAF413mQwygRmT2cTg1RKMyrCgWCq1l6y3poa15L7UN3Xkg3THhV+NDVPbqASnafEWsp6vl70SxRbgYQUmUVvPol2Y9kocwFlgCsT//VuHv6U7Pn/8CP/xkXd+z55Tufgh8nU5ZkbRJ1GRBCFXpR5ZRya285c73jmr8NgtZGV6vHfxghzBRBxIOv5tNpruW0eGef2IHCOlRlrED4CtGjmv3rEq6VFl4osMz0fgMnCQEB/22Hk1t8oNZnAwIiZ/MX5ufufHqZG0pZ7/xS9QZ//L4iHy3OIXARofe9YyMUZ8iApR+rmUW0d+fts6/K6MXkZMfCATKyRiJEFMzh9G6SebN23g5Fg5JdQNUs3HNScbnVpYOhD0YCKpSUbuzuTIXbvN47L57L5QjMldZEOUu5EsD51HrpRlDCUJ3uutbOD94xUj0x892jryb2Vr/NWR2nW7G8nrqTvNen9Rr6q+Ila/75L7nrGkmlsaicd087UDK+U4ZjF9HfigFOEza8A6BPhA8ImEDCBUMoDMfpPgMxpsFkOpsbQiIKlFkIERS4JnEZ1IACx8KYJDix88vm12x1xdcGv16nUPhzdG/XWNay4hmx98oYK+qE8909w5ZxsZftX6/jOXs3UFXJGXGK7Avi8G4jAATgBD2fb9TJ59bzIyvWglVsnYLmDec4utvcF10xsPfHD/zKqapo5V23qre1uP7b3nsdbu6PVH7k6vUx3gwcA5ufmksYgI1AJLJdBBA6EDQ49ZwR91gE6WgUCrkpuX5ZE76c58gxw+lI4RAYwzSUOJ0W41OkucoUAJc8yCiQyQFgcoc3AfJU/kuTEysGF4/vb5yc7I5tSX/CMBf2Nfz6ax2cv23POZHmLWX9jY3vxKz41X3ynBTH4G+LJwHq4z2eYAVYn+sxascEAY6E3QnidVRBCYpz+THZm2Wa0emycUDJiZCGW7LPFs5NlFFqMDnUZ+9rePko6agVWRiU1b9z9waO2mh7rmim7cXUHuXr+7aPXq+mT3sYV7Hx8gezfqV7SV+xmPLn5psZp8DvDp5iaSRh2spZ6gNnWWUnkbA7ApL+n4kIrtZoIjR9YjNm3K9l7O5zNJrckSDKJv64olUDQkkOKkVTYSFE4GgqZ2T+eEbkJTtH6otzfY0BgMqjXXWi/vNK6fc3a2+Mjf9ndMjVT2eCvinf2p6Ut2B1e6cDvRsRijasBlKRfiVid7i4mKeAkVVFYwcS0AiwAujUpmBTBLBMYLY0PKHCbpsMvpK3OGXKFgOBREkyScHVFzMLUqhWQjWbxLduj8Y+Gh+U8eTYw3ry45tX1uKji8snv8QHDYXxmtG9nfWLI6Wnto4banLK5U4NLL46uqhm8A/i0xXX9scBXwTBww9AfAs40LJwPAGjyayGQgI1hkgylsCzGxCh5LgpfCOGgwyzHy2zcvzNWOb2tdwcc31wmesrFx+lN96rOHe1dYbKk7yOZSR8R7L+OTWnhd5LUg84q4TmkhbUosaRopbL2s49xJSzp0n/l05imLxaQAEk9Y1YGKppZG+82bBzfHwq2hUGuYGp9xh0ItwRCz0xcfX6xm42nBRm6QxitR6HgaH8ooxsBJYYoF6YOZJy12G1oaGc/LogwVd3W26vs29xmnvi8N+L3Vrr514N6a9u3ir5aHZngFSfg6+LVghxj0Ar8sZisKYNYR5OVtETXDbc3Q/sSajx1buHp2vNxdu8WH2P3Cgd7Gm5t+QYirP+EuG18r6bY60PSvM3nsTbpQrZFBDY6asT0j0u4ZY9UEDKkGmvqmLRqKN2mn5zYJxWZT/wpzbxc9qL9wtcPCSXPhi4C2K7h1T+nA3FeRQUmg2USCRM105vohtUDllXOyFRPTobaZ9HczSX3YAqZiwGTS6D3M+4yzjQVHPk2ps379bGzz4Drd5K7adn5sV2MH37y5QXA4ghOx6k3sl0nSmnqBGg+eaG092N0FJHcT2eIuDbj616aek34b4NK07gZaX/WkCv0CeRpmkL5knqKYAONNnoNdorq0XJa/mPlM2AbAo3+aAT4bbhnWhTQvjCrAZTNDWmdoAB4tQCTFg7JUFOOIKXTecKcbVJSWaFFFJRqVqHpEibXDQqbWTx4Ymtt263Vb9919xdb93R/cf/bMdWfvOvPly3fd+fTlMJYN5JMBxjKCRN2VNFpBNvFF4CShfiL9Eh5K1UwrqUBrcjNDDCmSCnKjiUQpLDGRtXjO1zNJ4EmOc9hK3CYcwYgCzB6zZO3RRIzE4sio9opvaAM761aP3rJtrC00e8nPwtNRd+2qjrkY4Km9d272Yy+uWNTTn3UNDX2x5yOn29s5GV+SjEUdC/4naHhiBrAkJ6uAHVRitFmY2gyinaGyZMtTPWnMCNHVURCiw3NMiG7/h8G+yqq64QON/0zKK2sP773jaYvrwgDRXkJcphuvHOmT+Axp6V4GyyYJeXqdgFpnUAvc5k7q4Y2yT+jgjHSBiQEpUZki4mwSkaVtE0XIgZpKCzlR0VIoCgbXFfs31Hjt5Q7rph5qPDsyqN6mpp+TdOYF0OcfA5h8uN9UDFq8vMzAo6nIpa2wXMryuND84XzEl6asikhFngcqUxjonhfqO+pWnl3YtH2gtqMvVl/Vd+ulu9r2+hIrumvCgaijdsfq8fbuugqfN+Bs2DM8U+1r72S4igBcu+g5zo5RChBEID8AugHUy3SWZ4QFyjHtG4NfZpX2ZFFGoScJurqHsEgiCisS9rWuOMlXTegmQ2vMN9iurFY7y8tmVoROmh2ktu9Kzam+1FejQTkGBDzGUSOMvepJVCZpnhekcYGet6TNMLv8oayZyRaZvj9jCVuDckyKaeU89zZOnlrHB6erruebNjfxPn9g0hPfPF3fdI3FTg6nzlkNobLuerIT4amAlxTAI6IvrSJp1259xrVjEXjJtZO8UvDDUnv3zg8JIEYu/IYaU33ks/isemCKf4NnFfB11783X5f+25evDggfubJ+xis8tFAhfBgHIJ9OrYVB2slzqU7yFaAr8MrJT2CctK+rBNLSoyi+LgEvKSgGLZG4I56IE8/te7YID+778cmFMeGm/cSZeuXll4njrWeflej1jcUYeQeey/bDixguVMAy/fkIMXAGzBmws+ACU8kyXt55q/bEJfzweFlg2/wAw84bWy/RDRYnuwH+DvJVGOOXMNBjMEaO37v+In5vEJy0T6a+RPS21K1asuJNPdlBXkxdP7KanMDcEO/icTLHr+LKuNZkcwlRod9I0HoAM4VTExXPqRY4HkzmKQyzz+MGP/h6cHmZyWOymUTUGwk02IGrRRSIBgJC0UiAsMVARQ9pqfBqq3wqj25+h7alUfCqa8JkQOcVognt7KTWoyolbYP+6H9MrOgvD7/R2CAK5uk3Ksr6+9f+JIrpBdzBxQ+QOB8B08mRtDKPFiXOEbZHw5t4vS3mAMo9eHD9wV38re8cZuvwe5hTS2ZOyJ+cwPFASQswIyAyFbfAYXLIlCxIKMmfE5HnEpTnBg4JzgX+ZHMjLe8yqdPLT4pwK7m3yS/JVZyJ62E+dlOJEYS+qEasD2IAGZCt2G+on9CM5dYRzlCk08CCmIgJxRu64OFALZH3IWV/hWwJdNaUVATb2sfZL4G2xNseb7x8s8fT6Nsk2ZAsdsLfBTRUwtUlq0uMRXpBzt1AE5XDKAQaWJMyVXFkxIpUpVI7s6IpkYRDDIJ/nx9U+cfrI3d1nahOx1bOjdXtv7QGx0XafZovTY9b/O7j2vLGRWp2sIHziTr1q4M3B97fdSxN3ES7aVP1FVfAc02LLdwPyJss/7TrScmIlHZUs+3kSUmBwd/X5xPHzJNydmoPCBwzUx+oU6ZHo+ns1D8ZUjX0nsye+NjiLvJf9GHOxbUk4xYTrK8VnXcNpsbwg8xn58hW1JS4TzbKs9yoEqOo5lzElXbdcUN+aaImCYID373KtM40sOG6rea15p4WxY2v1p67s+jI3JmHSu6+WxdT3HkYCwxf6qLPcl7UpSCVYIa4mQkGkED5nYo5vQHNILatNqYaBlYA3RX0M8O2JcezFOFNynXqAQjjnyr95JGeVbUraurEkq9rvm4s7iRkrS3Vr0tUiCVjmjGqeXK6tiPecn3n8S0+YWSNqTNxolOygdzcGlpHt8F7mNuS9IkskOCyF2kALIuxGN3eQTdwxoDNauDRsPMzAxdZhWxXYjAzPCxdKcoEQPES1p55yuqqZuFpC1rlSD7MJxEjaMiJkQRGdyNmZi0getdPN/f1N063bgiFp1pnGvv6m6Zbp4OBqW9e2dNzZZJum/H7p1unWvpWt21onfL54MuW/r7mmdSDa1b2Dg72rkzv1YzR8+AvtSVbBEkvEk5HBBUn7NISlYaoRZV6JwqzUdyGHxOH0TKRconB/NTrvTEQbFKoFTEu5xdiTvGOQ/dsPyG8sPM/j2pu1d0q3mraYjorntWdJRvJVOp50pb6VNdE1y23dE0AmjLyU0SewygIbmHvZKkgk0yBYL4WP8L20kRBVKvSe2luEtfj9tcT1eur74Mf8mVgswcufB9fce2aF58mfwSaquJa8NkYdWyui3osajVP3LBwUrIaT7enyYsMh2qllApL/raALZ0dpCRqSbsHiQpHU0UdwavKScvNCxv3rmxs74s11PcMdexq2DFfs9vb2DpcX1+9sj+5o+5tV3BzW3lNfw8NrdzQ0hauCrsj1tJVDWvbK3v61peXdkZjIVfY7uhvmKyNfcrmMQSrWx0eszeK8ymjZ8h2+hanh1WLM8lcicE2jkxhYjk6EuD2Em5dMeh2i6nIUewQVZye6NWyNLZk5QvFs36fdvr9zlK//2n4KYXf6RlfqdPnc5b6lHcp52CKu4K+SF/DfQkuxm1hEEzmx/1ETkVF0Mly8hAmE2Nca0FLBLVamII3ATOnBfU6h51wlYBgr9vud/jlwKCN2HQyuKRQcNDuyORzlBFfRYk0B3J3XTjQvGpw49zqFU3hUGW0sSGy99y5vfvOnXs99c4/fOb0qadIU6CxbsfGmZ2VDd5kb0/yxvv2H3j/+w/sv6/5M0TAK9gc17C8yje4cq6Sq+bWJYedIIFKgVg0RKUGPlEJGH1Sq6h6gdNwokbcKtsdwh6WuCIFGfdifll1rCoaDvoq/ZXBYChk0xWj2lbbc0LDHSTRkpWpI+IuOk7NgrHrX7sEnUETiwqeEV+y/9DBLkEM1scHjVND/au+31ZnaB9I/DZ1jZZcRzc97bLSHlrm9wZXJfrWeipDrp7yRIf9zcRcVSyZunUdk2VxroEWUwenBj2jebJIC45nPcgcMdJDyim+Ou6/pPVe7T811ktvJPyt8HdXvBR7XnpjcmMTd5r8GASXCuNXTBmBCASWnUT7FJUiJRj1V3EqyaYmUkbljz3rzamXdWT+R7ePpPOEt7y3PGGdlCcsgF3yGu0F+tOAZeLlQtwoo8DVVqLSsr1HFQXFcRIewIsExKzIabSiZgHUuUrQqkCiAA5Q7CKrU25dKBDwm0z2oMVaogNhhhQXYmvSaLcKjS2MxqxhjA1FgragKd4oNsWIDdyhR//lnnu/d0/qoYcPHZ7ccJi09E6uGvS0T57o7PaWd752z5699977L9uPPXrFFY/e1Wm5fN8+4pqsnJD2Hz5KWukrMGd5H4Qy7p1EISvPPMtuZCyANkWrNvWGlr6ymuXozZHHyaeAPlEGtLGn1HLI9DxZEHCbgptiyS3zKpCidHlJkJUU5ciSBBdi8bpALF4T6JmbX9czt5n8JlEfaWhqjNZ3T3St2zzZvW4jwNAGoP4I7BU9uDqbhx7TgcbzS1YSAaSTg1kJtqKonuXU6jE1KMBA1jXiyYIXzST1SrkKanWiqJS4GOeRGl46Z9xgPKc7Z95gPhdjeXbEfOLE8L33pj4qx+MSYAwfor8A7ICPYzHn5EXvSbshu1letF0oZnnRvBhfkhd9yFu2xh17siT1n+rbNnhL49UNqyfbVtIr3J3RlfZgT+LIQtThqqvs64AxY6SVXAZjhjCq7wQ6LAWZ4QeZAWKCUGFJSvSe9Nb0XiklGhai2CVvzLxbRvTCfP+u+uZIW7R2IFziDEe9rpZ4qH+4a1V9JQnUkC+3j/VUxaLh9s6Q1+GqrE0kqso7tbw6wejvADHx5Zl9PwvYyAnn16L0QPOJDRL+bIvVVAX+mx/31R0ApseC24yDVphOP0ZQ1yPw/BYppBGzhM1s80/Mcc+VHTDmu0eYNXPZ5kskV33C07Q5rhI3qHUkOFVR6+YF1dd09Key115HdqU+GIg21BYV99rqm/zUbHeFmZ+VWqR3snwW8CtNJToeM4QpmsJUShOmw5aQCW1glUXa1PfzmGEgObCkKrTr+B03kqL9k7v2DxVPrne1tRWTGN0/tWX/Ozfo+c4L799/pHy1cy3DQT8p4l4i94HgKGUGNwHNJ+1hcWSdVJSQSULtlw1s0iwb14DnRSPBnDMT18s4NCGCgAQ/DzxPnmPFUMymF1jNxpQSIuJ45kKxCpssF8rR2NwELCCiBSLRxw1N42VtRZU1/W3dsYDvyZrw4QEh5q/ucsfN0hruBh5YRX8Kch6sTgGMJ7Tu4OcSpP/d3LC1hBaDeA2yMgNiGonu8D2ATuRovGUc5U8D04GvczrODv5BPFmP2WEqYasSMN0zlE4f34uOAdaa2cAYBhmjIzqxWM53AdIFisiOmjKJ7u1Ymag80XjL5dtHtx/eObadDDMdRq7YsrWl7QttrZedvHHL5LFb51L71wGmXFwDeTNfZxGgWyOpo/gaIbflKq1gntLiucOLj/FW+mt4ho5zctexNTFYzIAZFWJGS3iw24tAilXCJSqV+iDY6ZS/FLUSTHSniBlyqkkWXp8TCLDHWrd0KdgBJzFR+fqLXMpEGtjNNisTaUyqS5gPA+wWScKBEpYqDtzyYpy+8E4XFY636If1j4uf6rljs31lcQuxsyWyvfPvPt534eCWLY3E63pr925ljnF5jgFuNZtjO669ipR5KSdQNk1cSNCGrA4PmDnbysZ5jIBQdFtZvl0+nIWlZC64HykoM3OgTg0tFaBM5/nlNQqB3ZXgHmfwO7NlaUM9cAZK0wgR5eVqhblqtbqDnKhWi5fKKYwLmV0sDsiRW9ATrVqtnYQ3rXoO3BqtGpaP3crptCfhXvH6/8atM0kzptnHG00mryS6i2Tj4T2Jb22BNZ+9uEQ/UpAUPricnCfWpeQBfKRdjJG7WW5/GDWj21VchIkugzIlLCg6cpIfDsouEJcOJPBNMC90cJmEV6zybp7slIVfj5xX3lzN8srXLzQOrGkkX2cSMfUrOa28IlAfCFUPtMxtbG9ZUxFownWX8qT5D7A8aSNWBRgNxTwd+O/mSycwkyM3Z/o+5w+j2XnT/9Q8xnScMuYDf+mYdSThyBtzEJRp9pgfaD6UM+ZdbEwzxlzMJkOxQDH0B2br6Zyx1emxS4zp0cUCM447xDwAnFJwKxuGX8nxLQWGqxgMHvRt3C6qEcFIUqkpOm5qlYhejQ6EmAY8uGyQtDJIxUUc53TYrSWGIk+xJw2cPh+4ANtRZJQvhf1ywRzyrSgqKS1paVgdSBa5vS3xbID/rt7mcM7Ux5zTnCDDfIjB7ADJ1pvsAUbUizoeXLBlgHSWIpjl3tKAMyBZv2lAi/IAjRRyia354I7KjvHTzFEOBLKh/WS2n+yr96dhfkqGOchdLu2DVzLUqrNRC5YvVhFPD+XA705WZC5VcyJVi4UnOpN04UwDPo8rb575C6JUG7fklRvnTdTr8nvsTr97pj/e1LqqubEje6akKui1uwNeu6extre1qn5FO0dxrwKUJeb/WdD6RfWiEcDZ0oBC1HA70wHEIazvmNWKCmWbTbhPIhv7Or1bhtYv+h3w7oiDBxfnySetqT9u2EEuIS9aU18HTaB9w/1TberOx3/IlmCYZcnPpj5Etsv1BkZWb1DB3Zz0YFyi1EAF3oluoYcQVRgssBBRc+rBoccMsB4hjoCbSg6KhGWfbc/KHJUN9SkVrEVYuow7edHrZpI2wgX9bpfdipEMsOEqSAWWVqiY/ZaXZxpndQ2oEBSjjhQ3jZfO7k8XNHwUSxzGjotZZt4m453XKAUObv+KNUJ12uyT8nF1IEdRotUlq1GiqQb+jFoEjDcuqUeIYIqcXJNwDMXoX2+8MJhyS8ZLLaJTIg/YK8tQZcy7mARtTTYzCapSYym7Sn36omNLccsSLLbMnyzK0PzxH5K3CGQI7pMlqFJ3owN5JEmj1cleLRH1Gh0vyc6LwYBSKVsmSSAV5eNjGYG0BEWv5ckkBdjRfHnE8EamealnhjNpF9UqnmWoLK2NQKWC9RE7cMGlpZbvH3lP96NKxPuvw/WTV45y1XD/cVg3Hm3TZLlOyyw59MsJPZ31HKtU0oAPklcGn+WVF0NZBp5rhuddCWvAA+25pMguLwqoNaXkpQxcKsFhK3GZXHqtYFQZMaggwbmM2MfhbszH61KM4pzscm1REVeK2lxNqIjZHdmp7xpMO5vl5Px31o3DVFxqKPWbTAGtlMWHG7iJuEWpM42xTXeRzn/hk09HxjXj4Y+978OpB7H8yPOw5uEy8pGvvEy6+0jNbanKhz/+tZ/0/S7DF0dArxs5H1JkeRkV1Q47FVSsBgMcTnBVBFSWIoBERWEhpyjDVOJ1u0qt5hKfyYcFGtoCBRqRfH2eV7HxaL4+zy3hmMhodOQhVssB9IS1HH60v/y+cj6TqfXn1XRgLu/ydR1XAEEvW9xBf46E/j8EF8ZYloXrfuCT5cE6z/hHgesuBlcIqS0U9JULWHCBOaOnM/CpcuAL+BUI1ReHUOK1ZYH8k8SAy8LJq7PkowTrVQzWWrQxa6qBGsMhoEaaRYhagF5Eh0sBXZMFenmZqSQWrawI+Mpqy2uVSeguvvxLKHRZWqjJJ9blV+DLWYQryHM7xOYW5ZrQFgVPX6fW8gJRLTeZWBVOp6GuqinWFA6WRcujyoT0F1+VwiJq2WndmSe3lp/UF5bKM+wrcpx8j/wA9Jr6cQ2LDToyrUk+s3A6fnqhZ+GG+A0L5AeXX9559EjrkWMdx44qa3414CUOGhH3hQArdowZhkPlPOV1IhNBNislA1rNsqVLztLKilK/01+VxU3y1idihu2JStiJ8PaI1YGpZAYqISMQbB7tOIi/+YNNo+2XSUhJfN9yXcv37fZMWZfmGtuZvscQH5qTtjP9F36LODlWd+EPwgvH6qmoAuxI8pTV34AcsHFOzPRxljpACvxZdTg4hQK1OBqmXgvV40gq968KA+rkAjD8K1PRhWCQDS4FhrtgBA/m/3ncpY6M1FEVgMXllKFRXxQjKGyWAnRS0fOFYErrfgmmQ2wPshr7bmRzoGYJTMGAAzR1NBKoDlZL+4wyhPrlIVyG8ZZC/OoSU6EQ6AXMB8AtqzmC9dVyxZiLKlcdFRfpYZnfQ+0RW9Ss+qPXpNXMqkFiqyjZBnVynV5tMgYYVAm8ahdW6qE/uVPyzZhTllWjFxAV+wSLFcWMfcLTuruuOWAEO6lk7ZWnU7+RahiPHbn+Gnr+5PbU26yCEXOcPrtYTcvp62CrjSWNTkL5UgLsPhhvpKRfSUOXsyPGh5R8SZb6asnkSdBMxquuusrjctiCgt4WS1jkRFcMSJXxtuzAWy2PEkNOaJaz1/pK9l4yNO+NRr3+unr/9smJFdX1TZFmf12dv7qpuirS0qUfKNmw0dmR8JHfH9k51Opv9nsDVnNlVX1f5chcU2dFQ215cyTS4qvsKKvvDPUMp1T7dwZWuvol+cdqhvgAqxkKcR3J1qyqoVAwACv6V6sdYlbOxeqHsJrp4kVEdLdU66TAXf6/ATezgi4CdxgNoYuD3SDvUSlwlzK4I9zKZDICo4BMSoPPS8Va2cbRTI5xZLeFQwr86vcEvyy2LjKF+28O3d91ee27zOIc5nxVZ8+DY/Oo555LOutqwVaKVICtlJ6KwKYy9JgTOCamdJ2bHsI0CnGeE0VWqC/PMNvscEtMFs2YWul7l7khGVnWPMu9cmYm6Qz47baaWFVlOOivD9QrqNS9J1QG0kFxyVC7CE6/6OspcpW3xPsDXez9XZA7Ul/tmq6vds4gfgW5lu8tht9qrpU7BZIot55PQlKIKRBBNY/7NuPL4idQyNjLQ03SW1uDuGlqrGmtba2s8FcHqhXs6N8jdgrm6FwMS5V5+TvvgqXBpdk9Mq74zjSubiqAK3uaoLAbItASC36NXoSg0teqMFdXvSzWGD0lmhvqcjH2HumpcGjzYhj7YH6c811Q9s0lkU/kX+vim7yeurkgVwcY+9rQY24s6ggQkfNTqhbjRKu2YuZsCQGVO+he5iuNCisW3Iy/qZbXUh4bh2mpWrtQpKPYAIfoWYGIhmCmEdYHTgmA3eaLX82lLx7iNJr0fTNJf0M94epbG1qrq8IhXzlqVYvJUKTTqnguSILFrF2BI9PMUd7wibDaAClhCdmXwhJUNCWkhM907aH3jKXnsuHppx4kbXUDqyLjs8fi/Vc/ePOZfrW67sox47b66WkbpatnRsmrXXNF1x2ooO5NmwZ6Nu7QreyvT3Zv23Z2cqarucG9KpAqS9a47K621jA5vnejvqejLCDVnBpZzWlYifE6MMZbijFeNyGqEOFI8D3EeGfeY4x3ZkmMN+BzOdMx3jAJY4zXUTjGmxfifbFp3Nk3li5qvbS1Nzi8PjvAO2s8tEkpcq3ubeYz8V1eqh0FGwNrR33oY+VWj/rKy3h+4K9WQ8q205arI70UTYzCtaTfk0yLNLzl/0vwsq245eA9jLZFYXgfyLYpyGtgUyC8QeySGgyUlwHbZoONNaW86rQCtXoZqP0+BW7x3eBWAtDLgV4s2xSFoX8nbUsw+U3eAF2H8FdyTdy5pCEX45Kqq1aAZztoYBFoiFo9zsyJpVNxJ6uUy5U9Nx7Mg8IXg+qripZ5bdb62mhTVVMo4K0sq1QQUfSuiFhG7S2LmWP5Oq8wip5cqutYTSzpZn0AcuPZ6wvGw7HWdQ867Mb7GHVL97ezPKp3ux/pEu8/gu6ZcZ5RG4sdk21Aa8vFw9cvGw/HZ5VINEGNX5CWn+fK4HmYF8yzasP10ko7WUSc8vOYsT6eW+nryAuYp6t9kzY5Zu42ud9TzBx+R5hO5GcQG48vQbxUfynyGoA3ilnnAdbvkHXK0WLPXB0iEXtn8gvZnoavPBwsj/qiXreD9QQjoOhZaAhEqpIrn93xDfWS7Cw9RbZv6ZiLtpdtqBuq6z6is9+yZ2r/+2YONX5uxay+ZmPbeDu5Vmd9X+8G3waToc9mX13XOv5Qbe+HP3p021Uf3Jb6/KkbJw9s6Vsj5c5iTQpGW8Lcq8mSUJBqRI+bqtRY2MrLRW5gQauZVT7NcoE186B5NwwVqHZV7PmClxesg03b8xqtvD2fvneZG9D8Urb0lXsKl9iCQW912AO+cq+r1B52hFnFrW7ZittEngG/tAL3mnyzvUBF7ueybXXJF9IAT2pZxKs2GcOIFx34S2p00VfOq9MlnwBGzivWpZ3Z/rAG+PqvCAP6vXkwPA+yIB8EIce31bAaJIy6tSabWdSNsqgbxexZku5okQ2Ly5mBRn1RjIAUyUdKlSRR8oHaocgXCSaOwRTmPpcsAuoX1UD9GNO/qGuahlaTBW2Oa0pzXdPCN+S5puyeglcCJbuxrCBDyxm06JZHSx5B5+NnJo+c8xHlS5OyINeYv8Vw5edquMOFXcxl5pl2Malq2SkmyzGoSTCoWROskYKamVnqlyfFZeR33my/kCfK8yfrLVwbsoGrIT+gq+A3Pdgg1bC6AhjUgio31TCrt6vFgp0lpHSAhJ9jafdqbCfL3sk3UzfpyPHUf0Tbo9F2kb0S80jqD1Kn0ifxrVLil6sB37fDmOgT9CQ7NVhOH7SDb2UmoPkGsWxxADQy6ZdT/znk40y7F6/HE/aGqyoDrPN2U6YASym+Ski7DWqLsv1Qc+t13tLWNZ3r777C6U4Mdk5u832q2DI0d2nt6pCp7G8M3znzZfWV9mvbr73zadUJ+6nWEyNBckQ4k3qzcXyqZjCQuo1iXBbrpEHeYYbtULJIKpV2OUt5pXnNX7dgmqV1FCiabgV5uLRwmhk6Cozl/1swslSQAjCybJClQM7LMlOBsxTg9HLTyWKvx1kKDITg0kGlExAm2RWC1p39TT7ISa2VAS01oFwWsWjBF4D7EUmsLoX8C1kxQKle/i2APQB25QM5NfM+najNMtILgK8Il0LX5U0GhAt8za7ExLllZjyTLA0FSx1VlcHaUG2ZxxEoDTAM6C+ybMuZ7oWW8pU86bIUOccLyRcq1a4DLRo4M0oXqXrdDAYyGfhv1bAzTzGvjv2rzDrPq2Vn5KX08XidWdbNyUYriC5qYK2RQKgNpO3UmXQQDLBoKpEsaKlXt0NptSWLFEtWWw7bDXO1wS3Vq0fPbh9rC70ht+WYrfpn/h/0qWebO+Zm/8/XVyzSB4YGv5Tuy8HLdfxvsZNLKrg9SX1WLb9EEW6tSsNjAAh91PEhMRs57qQTPmUXEIFfyPkO1KfHXWLElEJ3hafCbjW6SlwSLnVLcbms05aH3x8t8Q7ycL3Mmv/fRSNtpeeZ/OlOdmD/EQOAzFqdkTVgEuABJruAiQRe2M42skSVkl/oRHFgD4ZM2PjGmc6FVOIykruQyGu1vKcj7LLUNbd1tcdvSndd7hyuNrbY49XREU+6ATP6MkbWJw65FncgHGAM2UD1CLAWtBj4UxiUeuhtx4QgyVvGxVDc5VBQ4rFQNBhlYQIpzJkHX8XFe8hNKfB2t0RUF+sm17ZSmkPVmLs0XrCvHOvVLO83dyXb87o1y4bwX9CzGQ3hAn2bbwfWy+vdTB9R9p9Zfzm2P1WKMOVVmpY67Fkw/Rl95hCkpb3mJgGi3H5ztFr22yUcSfvhq5O9eThihjq2C6Bs10nGlCoHKpczgyv18riSOxcsRdfr0h55PsbeURJwJJz9ju2NuaW+aDk4AxDt+TDOLIExgzv1sriTmhwsRV+/1OUgD4P/IrU6kPMn51kefAnnwFwmh91iTndZSHfoVuV06LZZjTntdJf06OYljOW36v69hK6cjt2kXMmHZ7b69/gG1t8ozB1PlngN4NCnWwkqXr1fyi+V0vQV31nMbSgYLnQN065iTmtBc4kx4Pe40+0FNRdvLygGE1JF6vKtBmm8pznmDNT7C/QcpKf3HDF7Uax6/v+Ws4i4PwJ61Q5e0qeTJcVEQ908FTV00GKmgmxfhrRqigm0GB8exW0MGbE6wjY60kaQA7Prl7mWLQLekMkwqIBr8Goq8DsvciEYQ45SB8eBGeQv9aM6sZjMoYBJjz4Ln71orEbVAXjIWjvqnswsmOnjuo8Xbdat06XOpNdt8sJD8pJd0bdeP9B34VWlU6TUR8nIesq7MKsetB7YDKDfB9MZxljGpcK0d3EWXG22B6cU0ZpsTO1JFbRKanGeYsnrOp+l+FL/lG5An635zks6j/WvDHAxbiQ5WEE4tRRfFoiJUMEMskY1iIVwajzPA/ul8NtFIm8TsmCxcqxYKBiMhWIhWzASMGv0ruzYcD6kykEsBfpb1jfsVuBuiM3tKNTqMmRQJhEacAtHd+T1vczNKVeqctQDf35GuSy689O1H83NKD+XLYPIH7L3HXKj9kFfeZmgGnhP+w4B/3ved+DlHjXLRdevlXvVFA6qkz5ZnMs6cYq/idW5bEiuz5wo4Pd53II4gAEbNcEgZOETBjREzv8jWLATdAZzTxrQXeSkAR6mlWARGzDIC546UNk71K1f3e/tNIwvOYCAF8YaiwcHi5vXMj+M9RPli1k/0TpuY3KqQEfR2ppoJU5Jjryyo5PS29mFW4xWV1WEM21Gte+1zagZW1PJlVPv2nH02VMrSU/RitXBDsPFmo/S2IaW4omJ4haF7omdP83iNXjWT6b1p5J4lt34s0XuxokJ8oEQtuGk5/++BXtvoqzCHqPfo8b0mQtL90FwjwAukMf9CtiZKqlDmFYjpmsJljvbAC1H5XyD1HdYotuFj9IHpfy2CuCfRv5Rrpgzcb6kV2qeZCoxaoR3bcLJw4O/aqsMZxpxzsHDs5tx0ueya0/IT+gTALeJq0pGtGB8EOyFhVg7KZC8CdjM8oEc0hQs2XpcmUqRrLdxNuTXGUXNejyTB8AuKQa7BMYyafDcTyI136KwZvI2UbrtvzkinZKUM7vsMf85Z5ZflQfOmek1WZZCep3Y2RNGdvKIwKG6XMhfKezvmzVRmi4ZzZxIEfJ6QiGPl02zQaYZin1TyQ7WN5V1bFU6p/IDWZSY7lAYLDTBTJ+r3G6qn5AHzJ4eWSENTPBcVfJN1kc+lPTrtBpwJ9VUKo/PXUGbQoJiBOMdWGruJ59NnfN1lu+smg/eX/6lMuImmmBnO9mQ+tlMx2W/ZXpbB/NqYf19AWvSrHCHC+hczCHIuiyC7MG4PMwKx8CZ/UCaj6vZOxufqx4uuzyY7hL7dFl7M9mlT70Qa1/5R+wWm6n/+ACrwcNZSSdvWMwm8I/e0/kbGHnLq+hIfQ8ZLaeKI50XzPq6gl+GvuIWyVIrkvq7SmnK7uw/6cDM/0DXVwzjLN13KsKd/gJ7TR+RYjkSnrCOwo7dLWQ82YFZFZ8oB1tWRJcUr8yrhpGUfB7Gfiar+BycyYpe2j/Ugp5H33E6WSzhxwMIAu2ejlES5j0sQZIUo1wGU0mtjeGKHfRZEFeysl+KLr+s5QtgjKxRVLxc93A9/6JcFxPGiitQZn5fufqvUBxTTi5WIPOFtl3D0cSlg8tXM3zO81jF35Y9FpX3Xor4fnn/zos5616PG3Cs/os38RiUeTsl/9C6e6ii5dCa/B0SkwIR8kr34pv8afos2PFR7klpoQMoKLDHmRacDdW8muAhmToQ8pSfF6RjnN1SQlgi90p2mib+yiz9UfkedNzGpN8V89qdbFTu5LRa5RjO9H1c5i6CqWHSTeDuWDzuoN8d9URNpgq/yWwy4wlrxIrmrRrtW3V6FR3wV85K2ule8pz2q07webSpkYrY4VMVa64erQyRZ62pf+xMvdg5XWs91zFTa1tDHrRqh+6eGSo6d/Pau68ZKRoaTlXK63m0a8+cZBPzA+BnYJVNI/eg1AqxpEakVHRawW2zEYHnB915H6l5zKPDS4O4VS9S/iQgRXEUZ4Yk/zCTP1dT8KqstDkwXNVZeXMOrOSpaow1VoSwiicQDFgDIfQFExJGCmbMVThkHGVnydX4V+zuPRZfA/Y2S5Rbs7JyYvPBltVXbt33bdxDOjA4Rw1Setx3kkfmWnfvljLk+upWdF1yyeXVuI+EFEfuVhLjpLhKO+iAIhYta002SyfyYJCMH/gLz+VhydtLz+ZZixpi6fk85MZsPXGvHLPfIdG+Qe7abDaVaAXUFKasxs0Yzk+ri79C+2YTwJ3XwplF+pUuzuQQ6gUFd3cx3Lm5ZLJLwp3b5bAzX5BXnxYvgkFnaQaHmmVxKOuMpWj8iKw3CmDynzNxPcTlE6A/DCDbjsgKFVAnyKgDHVYCSszNPqS5H8oItWfy4XOx6lIyCwqg9jN2xC0qwTzcykolD70uSaNkUEw9aT1CpTObgEaDXARlc/apTZGKcE6A+c88uwlN+ouf3/QnoICLneFEfsz8Cqm3N9AuVka0JxPZ3b2l0oi/Uo9v5K1l+3wjuS7f65vWs7g0ntNjZGdhxbkzrGcO7wKvigpRFSWqRvi6gag51XIJsXIsYQNqhYslxBa6jiXE1tdWRrzuUjtLiI2TeCYh9l0WS26Jo6THfqNp3HHVmmWW7bpd2YmyM8Ujyyzf4ORVYk2mGxb2aDeyHu0NGFspBdw4tRrATQQ7s9UDbupwnumWXNjXCv5Oz3ZGgBWtrcYcaTa9BtIgZuX7ZjqBFlrg7Mk9CpNr3OxJrFi/ZK1np7KnNq2q8rR3FljzvqmsiSm8dBfwUhVK+2xeqopWhJduRGRxlBtZCnn6PbGUHNG6KFd9QJJhF2MsWp3us4y89TzIMqze6U32ZPNWBJiLwY6iKs1hublOFeEMj6nfE49JsmpZNmuRpNZFOO2HshSj0vlubP/CgHV7hmKdVtm9WHLamzV9LKd83JviOKRPffulLPulw9/OpeuoKevh/1m+geUFgPxxFVO1iK38sVGPWjzNqan69DIN/W1mqaU/xn+XaemfE5Ao2N7/UTlIsKTNPz2ZFSlQ6jGfkrOdDkjbz+ElRSLTQ0trM91gqOUXiCy9aiZZiiWc1VUVoZwCTt1FCjiXKQhZWsF5ZX4dSOESzu8VKP9Qcjf4Tjl3429ycjfCLOmSdfCRm/yMFk7gsKezOgtevCSLI5K5Vm4NtGwqh7XUUROLhLPSOHQXyRBarkNQgTSOh/PRtjSN450lKFNo5UXZO6tKRmTv7M8vbJacx6Xr+g3ZbSy8nMNpB01awxD4jJhjUMatTRqlRSzzelzOUvX/WKITA7xghswF2atcitJ9Gb+Sl+uHDzFf18fO8pUqiJekdijhXIddr+M4YCGfw2cy6mx6m1RXrMupK16u+Dmr1PhPS6ues8qOl1Y7K/38pVrncDKARc78wHs8E5ElheW38E+9gna80sBfiUtJZ0+w/N0C47zLGRRsnPyW/W9jPEnp15/ON5PncxrGMbETn5XugYVmZLHgWBicycypQo6mL5nXSSm0rkxMibBn5obnalmUDP9ypTRpeqjgJN1Jbz5oOd/PJLVg3OdCF2TQKTHcPHxskyOraZR8XwEw98yG6mQ058yGQniRDmzQ/wUHNuSe14BjFi8dM2fCtrwx/4zDGjipj/NhsgfGVXMu1qfSiH1+BWxIyx2xELl1s1wx/A25WuOb6Zw/7OO+G9izM7uPOyaRYDPkBQ7baE/J0SpC1+F57SUGqXuzKt3HvbCovidfLPP6AooL4b+ZHOLxoBr5fA9DMeUpHix88fM9sE4DpIyRGDOQ5GZOv5WXKU1vzmT5k8VfgU3zLfpr4Br140VqUh+LWBzMiAYzk1V4BnnLHyv1yWHb18yWmshErFonvOSggn5Nsniw7Gs/+kFtY/dLL6SqEIetILcPsrPly9BjhxmwChps0E6w17fUzTIxJLKNObTrW1EGYnqLvcxRZjLqtWqWhqPRWmMqplv8Uuwv3a8TN+T8rI6k8fgpLfka+WDdJZXV+04fvumJ9w1fZkk9IIwV3XFbY0ex54Wwt2f0jtPf/vnIlce9vulZub/5VtbfnFP6mOulPuZ//ndl8N1v3kPP9J+nWvXkhfQ9dPHd76FvXqjS03+R7tlF3iQi/RNXxNU8qZdPI0GBo5cOHyFkHIWLFj3P00jzM0/Y2G6GRaZFdhjIKxGXO+weaQP9HHeFgy5f9cn7SyT+mSJvcm+ln49HwSrPh9+vx44QHHs+nqYDo2WeL2smPHWk4ljm+c/kPn/xT4s7uAe4vfB8R9Kqz5w1i8+SnpTIfpI7/aTq7AdRhodnGJxOrumpUj3NoKIYe5dj73sZGXq2QcdcgCMzT2FEXpD24DMIEbP/IA+kB32yEKLKM5BQxBd5JBuODMqK2bjX47gMaew77jTClQVHDuIShbH4ZCF8ZoEB8hbwSsYYXp2cJ+mUAckaURkvsex47gLjVRccDh46wf2QDJPvgK+l0O6U7MUSbp2F0W5IOiTSSlR7+vv39P+wf09f/x60j3wgH57hroF7TZyb9cHGU/bIPGtbA1ZaEP5ZzKj5QnLJQSjd0jvzG6mMYqVB6ltKk+9fyL94WR1CNOuVnVHXQDpYr2r146ARlLMVlFMVlOMU2Nywr3Ug51rW0zryTG4Xa3atFebSD7IuxA0kV+NZAWaWC6QjREtYhoqG8CDnVLyAuSr6eU6vZ7kJzJOYUg+HAr7yMq/JHGQxfdawmDA3WQrswwtKb5F5y+AntmA6E0b6aH9LXWf7Ls+b9l9pyb86vlh07ciK4lWDc1doZx2rqThuHwx+aNtWeq7XNzXe1RDtfqR6s++6E931VV2XX4f8EyRVfD07V7wcfViP2cCz87tUKKbJSbUAS3FKI1J2gjW+89wsHj/EjVhMDtYfsUSrBliDJvjf7CdB9PETLLIq0ZN0qhq55IqRa0C/PzOkJYTfsHIeaFEzULJ7RhjbRy9LPU36k6krvmsKBUtSrxOzwRO1fo+cSf2BMAFzlDPxRnqddKabhgk7nZaSAREbiOSJy+oSqkZxKdoddgd4rg7wxB1+3njhLWKvvElYmXqVlK68pdJOqIb4eVPsbqGNtJLWtvfHTCjOufcBUv5EP4Ix3KTZoNdh8oPIDaAINRG1LUZgnhE1EIGWiJGKCHljI2+uvyNB2khb4r6IlZouvEFNxFl9QxdxpX7edUtFqSRPlTkYcGdOK+2kizAHvY7mTIJx6giWWHIGYuDVVphLsz+B1dNaUMMtCXr1hbcAdkftDStJaepVNhf/KG+K39GWeiH1Ak6EzWPxxzCPq2A84Cvc2lariMj1o2N0REq9p/hsk6MFiF9LEoCthIm8wZuj9yVSz6eeT9wXNfP0qgu/Jq7Q2a7UK8TZdTbkIrRE3ifVs7wDPT5dr1Gx862zJLjZzlYBbIU4+ixADeA/nt8lPHrP3pv/Y+9Zuif1m9RrxAqa86HUx8lGnD88s5gWA2GZkob0c0xsNU1+k58WX/gd/sjnIFORvg7+6Xz2OchuF1XJufWezDnI6sx5x0PSmVQYTZcPQ1765UxSZ5KORMa0saVHIvsxSpR7KPLs+PqBYGd3rFqtIRWDm5Jf71QaFf1tf8eGteFeb6Sx88JvyAupaaUjkTSHEMwhyh1IWkJBSuBmdsaIyA/a0l1P/IAEJiHGWT0UnZWOHOVwL0wJ0JSDfMJDuBaWuQKPlw2anCZLODfalH/Ec9ZcpeQNqjVGKjfyg61sasetB+R56ZVpd/dunhaKzNa+pHnObKNWB8yzX5nkqDR7m+HCzW47QPL/ATGjwUEAAAABAAAAAgBC8zSKg18PPPUAHwPoAAAAAM4O7s4AAAAA1jf9Gv+z/v8DuwPJAAIACAACAAAAAAAAeNpjYGRgYJH6x8PAwPzn/+b/dcy7GVIY+BiQAKMmAJnyBrIAeNptlE1IlFEUht9z7iInCPwdaXImtfyBMsfGsXT6cTDtBww0UymoTUhBi6KMWgYRRQlCuGzRpkWrQIJol5uIILJFq5AW7UKKMgpMb++5zmfD0MDD+82999zvnnPe+8lFNIA/GSSxdbbLK0xpGuUk7m7hqjuLNqnClPSjVfr9b3mOXs6dkpj/ITPIMaZey7CVY13kKKkjm0kjaSCd5DJJkiO23mL5PEyOk8OyjEH3Bznt9gt6HnnNYr/ep1YiL9+o1/j/IZ+bSat/p33UReRdJeL6mPNPOd9f0BMhTrjnbp3BkOaQc1kMaIv/qHXokBW/xFwqeGbmA6H2apn/IO1I6UG0cZ8ueU89xrxXSbef00Oo1V5kePZdPPusJvlcjnZ3EhkbL8TVcF2bXOfcW78iE2jRHp7zE5r1DdIy7+dlwX+VJ/4L35uUB7jEev5k/n3hTDa+1oMKjg2RKrKF5G0tNSs3kXL1GNNx1rmF703jtPVAb3OPUZ4/jTOkW6axh+wo5FSjC3xXjHVuQorjFxjfwfiEG8aVAg2sVyzU/z+4hJ8PPalc60lE6McaO0mWPfvXj1LomaDWk2LYE+1iTN6/CHX8D64J1daT0I9iQj8CcZLSTq6P+lFKGqNB2ZNirCc6gJqglq+tYa7BA5GaFyeDxnWEarmvFqn5kx4JtbDz0JuyAc1BM/STaQ/a5RfKJYmNoUZ2zkitLpbnPRxw57gfPWw+WlfzMz1Vqubx4DOro+UTaeRz81Sp3qEHGoMPUrLkF3mv9spnwL2m9yLt44fhO3lU4AZ5SbKcsztfgHcn5Wq5DzABjzF4vyzPMEHGZJbP0xhxCdRbrIzwXowjYfuyF9X8tmwjk+RupBzP6CbO7+OdG/BzfwE46vo0AAB42mNgYNCCwxCGEoYzjCqMsxi/MfEwaTF5MDUwrWG6wPSKmYNZhjmCuYX5EIsYixvLBJY3rDysaazrWO+xSbEZsUWwFbDtYQ9hb2G/xiHG4cVRwbGA4xmnAKcapwtnGecUznOcf7jsuMq4jnCzcAdwF3Gv4j7B/YdHiyeEp45nEc82nlu8DLxyvAa8DbzH+Fj44vjW8LPwJ/DP4L8gwCPgIVAkcE1QTjBEcJvgHyE3oUlCF4QlhO2Ei4TnCV8Q/iHiIZIksknkk6ieaBYQLhF9I2YhtkTshbiYeJ34PgkDiXkSBySeSPyTjJNskDwkJSDlJTVPaoPUH2kj6SDpSdKbpH/ISMn0yLyRnSP7Qk5JLkZuntwP+SD5Ewp8Cj0KRxT+KToozlLcpXhLiUnJRalL6ZGynnKV8gUVO5U1KqdUjVRLVLepMailqM1Qu6Lupb5Mg0kjTVNMc42WmzaDdo32FR0dnR5dJV0n3STdLt17ejZ6b/T19Av0dxkEGJwx5DBMMdxmxGWUYfTH2MK4yfibiYvJGpNvpnamE0wfmKmZzTN7Yl5ivs9CwyLD4oSljuUSy1OWD6w4rGysiqy2WD2xVrAOsO6yPmQjZxNjs8uWzzbC9pNdj901ey37Gvt7DiYOXY4Sji2Oj5wcnEqcTji7Od9z0XBpcbnlyufq5FrjesaNzc3JLcltkds9dxb3EBwwyb3Avc59hvsm90ceQh5mHlUe+zy+eYp4+gFhimcVEF7z0vCK8+ryOuT1wVvK28B7kg8PAB5xt/IAAAAAAQAAASkAOgAFAAAAAAACAHIAhACLAAABoADoAAAAAHjalVOxbhNBEH3nOxIiAkJCilCqFUUUpORwnAKIEFIwcUCEIGELGgou8SWxYvuSOxtEakRJSU3FZ1BQQfgCWkq+gJI3c2MTg08BrXb37ezMm7l3OwAu4Qd8eMEUgA+cOfZwmacclzCNj4Z9vMOx4QBz3nPDZzDrvTE8gSvee8OT6HqfDJ9Fo1Q2PIVa6bXhc7hVGnBOY8GfMHwez/yK4Qto+G8Nf8aM/93wF5T9n4aPMRPMG/6Ki8HtHH/zMRts4i5a2OXscR4hRhOOM+I5ItpGggO8Qqpee7Q6zNN6lXsFZSxxXTS0jAVaG/SKuT9k5BGj2hzCVOU5JZeskWZL0KU94trUuJieMXbU3mIOiaojxCpnjZbULBKRET1izH2ts63+VaKUI+Ep+ytfjHVs4THmsMZ8sXIc0DPGPmeKjvJ2mW0dK2Qvyihfco8cVTxQvzvo61c2VZGQSogWbqhJMc/J2p9oDdlQld9Mg/hBtMQujsQWZ2gplpueesh3d1SlfdoSav2//yv8Q2U3RmdnSjtq7U5R26ne/8J5Ope8zh5vVnCN46WOUF90cUyoL7xTELs9UtfAd0NVzznzfunrGxZeUTrXc5VsEf3y02iM9Mn4Pz6+jugEV6iq7PK2PcKZ0bLBd1GlSpt8CWval8L5lLdb1lfSv0tqrWvVjr4JXqj1plZRYe5lnmS9MXzH17WuHVbR556wkpayZapJqtr2eaoNs9RxqJ0h+rGzfwERfNc7eNpt0GdsG2Ucx/Hvr3Xsxq27995tOm1nutuO7Q5CCmnDCPNqO7apcw4XH6Fhiz0FQoJXINYbQOwNAl4AYi+xkeAFexXxAlBZLY6fA1GJk+4+z/3XPfcwAg4dgIP7ifI/lxqq9wiNlI+R+KjDT4BR1BNkNGMIMZZxjGcCE5nEZKYwlWlMZwYzmcVs5jCXecxnAQtZxGKWsJRlLKeBFaxkFatZw1rCRKpfb6SJZlpopY0Y61jPBjayic1sIU6CdpKkSLOVbWxnB0fQwZF0spOjOJoudrGbbo7hWI7jeHo4gRM5iZM5hVOxVCe/AtzORVzM09zAN1zCNVzJTdzJHRrFFXzMhVyvegW5mhu5jOf4VKO5mbv4hZ/5ldu4h5d5kXvZQ4ZryfIqOV7iFd7kNV7nDb6ll3d4i7e5jzw/cR3v8y7vUeB79nM5p1FkL32UsLmFMqfTj8MALhXOYJDvOJMh9nEW53A2j3Mr53Eu53MBP/AjT2qMQvzFQQ4JjdU4jZc0QRM1SZM5wG/8zgeaoqmapumaoZl8xueapdmao7map/nczwNaoIVapMVaoqX8wZ98wZdapuVq0Aqt1Cqe0mqt0VqF+Yqv+ZBP+EgRRdWoJjWrRa1qU0zrtF4btFGbtFlbeJCHeJTHeJ6HeYQXuJS7FecZnlVC7VylpFJKaytPaJu2a4c/X9rXX4gYogHXLobD4aSxLWWMecbDnl4+4dUnGj1jgXg5X7ZzewOW0Z/MWE7Z9mcNyYxTtiqBlFeU84pSJpszdFgZt5LzlwwdJliq4evIliu+UvXh7zRp29BpquwaoZ0F185bjttXstxKqPzfN3+XaXAMXabPMewywQHDbhOs1Kjrdop2vs4dfoa6D5vvHja/xzQP1Qj2VLdqZTI5uxIc+ndZ/bW+PVmrdmZNybZho9VD94x4Rj0bPZs8mz1bPFs9/5kT84wbI97cSCTYW8y7Ti5rDRRMKJo2Nqd9Kdcp11uOUx4s5XorgdrK7Q/WdIr5QsUks+VBu9bTnG4fNp0w260a/RsWHjfKeNpj8N7BcCIoYiMjY1/kBsadHAwcDMkFGxnYnRw4GRgiPS21GdgZtMB8gTSWOBY/DjsOA3Y1VjkWdg6ocBZTElMYmxubOas2sxITWJjPyZFT8oD4AeED/Ad4HDgPsB8AmsIJlBAFSjA4oECwBDODy0YVxo7AiA0OHREbmVNcNmqAeDs4GEBcBpdI6Y3qIIFdHA0MjCwOHckhEGEQcBDIYEpgCmBzYDNi1WBWYGLn0drB+L91A0vvRiYGl82sKWwMLi4ABPo1hQAAAVoSTJoAAA==') format('woff');
+}
+
+
+@font-face {
+font-family: Fira-Mono;
+font-style: normal;
+font-weight: normal;
+font-stretch: normal;
+src: url('data:application/font-woff;charset=utf-8;base64,d09GRgABAAAAAVIsABIAAAACqigAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABEU0lHAAFSJAAAAAgAAAAIAAAAAUdERUYAAAGUAAAAagAAAIBPClFWR1BPUwAAAgAAAApMAAAaoDSsscpHU1VCAAAMTAAACXwAABV6fb9phk9TLzIAABXIAAAAWAAAAGCXMPdxY21hcAAAFiAAAB5vAAA75Hd9EZhjdnQgAAFLqAAAAD4AAACSCU8td2ZwZ20AAUvoAAAFqAAAC5feFNvwZ2FzcAABS6AAAAAIAAAACAAAABBnbHlmAAA0kAAA6McAAdAuEmVGNWhlYWQAAR1YAAAANgAAADYFexiFaGhlYQABHZAAAAAhAAAAJAXhAnVobXR4AAEdtAAABekAABc0Who6xWxvY2EAASOgAAALcwAAC5y+WDRBbWF4cAABLxQAAAAgAAAAIAeaDgpuYW1lAAEvNAAAAukAAAZF9R93pHBvc3QAATIgAAAZfwAANXtOj+fkcHJlcAABUZAAAACSAAAAoG3pAKF42hWLQQ6CUBBD2366MHGBcACPoBs9grfC+AV2JnAUuKFlFs1Lpw8EcMZxLwgnNGxBXthB7HUDddcD0rNUsLl6AP32D8WL1+TmHeUw037yq66Qvx7Dk6fwnDWzXpJrHMXZwntM/QEJDxDxAAB42r2ZD2xV1R3Hf+f2nvceCLQwqOJqKQ1gV9rSIOtIx6BgV2qp2NRn7TrWoWkMYmmaWrsGCeuQMdIQfGGEMGSu2wgzzBFEZAjoXNc0DXPoWCXIDGHo1Ghj5t+AM337nu89fe++P50zSwz5fM/v/s7v/L33vt89VJSITJRhp0GcyqrasExpvaezTXLEhV+iUXFQTJIKmbi8alWe1Cxv+naehG9dHs6T5lvroetWLW/Kk47b76jNk011tYjZVn/H7XkSCZuYfeF6eA7YnpRMtpYjU6yVIZnWciXLWlqmWisg06wVlK9YKyTTrTVBZlhromRb6zq5Xm7YcE/HA7KLup96kHqEepI6QD1LvUC9Qh2hfmJUyYYHNjygJlKnU3OpBdSF1CXUKmodtYnaQm2jdmMPM4Dibn7ZVgZ2Vn/JVgD3N1tyZZ6USBmfJSWlXhlY7ZWZpRLAw6dmFEjAMeUhe31eVPbe7MOY/SRpwl1XbkUMcRdZu8rataA+IUa5jWnbiFsu19wsN5vkgHxbGgrckhimfpFbbqlgfZVbG4uNU2/JTkuj2+y2uOtht1vG6rrcHD0Yv/bblk3ulngsy+1gZ6w+a5wxAXrbnTiWu8/tcw/G2nhrqU/pKythzk9axvroSjtelm+cfO7pdu5bjnsUnOC8q9znfWvY7rMH7L6cseUA99/Uveyed19zr/yX8bLdt933xt17b50fJdxvj0+x36IDetIYbpaeBt8NllwwTc/Rhab0UWqZlowu00tYDnqgP7F1K9wqc29jsYMp7Tfpamub8QbxbzUImznGYkx/LbSb0o4/qNeaNaC8z/padYfups9bB+etN+utXGtWfM5j16zv1RHO2ezPHr1f/0o/kRjDvTts9smu9RjsYxjjpB3Xu8Y8zDpgnxyL477k6Be43ybON65dq8TGSrPGtH5/H1lxRI0Om1+Y0Z9Sh51M6HPUc0ajmvZvjaqi6GKjzlNGTbwq5K/VMdrfo7+K9nLayzPwa6LmeZH0VFCb6dlAez7t+bTLqLOpX6N/oTcW+2mm/VWj8nHGFeg5xjxM/wLqXOeIUcYXUmdTy4zK3xn/CCNzaOfQrqFdQ7ucOsdbr/M6Wg2xNmw9mZynp6ehxaydR08F9U56Gp0AdBY9t1CLGd9ubDnl7IB9k/UbTzQDv8DyJts+SP9c2nNp59OeQftm2jebuan7aU+gPYf9F1HnUWcZNd8morI6phbEs4TujiG61dqbrb0V9CbEKB1J20Z0h1qpq/EWhnUTyia9Fk+zKc07Va27aY+BN8ravQn+MSL070nw7QfhWH/++D2sq8Z7V62fSKg7rJtCvSiP4Y2K+UK98O2xPJF2/DHCePPC5ndFvwjOgQvgEngDvMP5+PkXeQEMghfBOXABXAJvgHcw/0/AZ7o14IAQmAKmc11cW+BGkAfmgSKwECwGS0Hl2NwCNYbAjSAPzANFYCFYDJYCxAbqQANYA+4F60Ab6AQbU9cc6AHbwA6wC+wFj/vqD4BD4Ag4Dk7b+xRnP/rYH+gHQ6AInAXD4CK4zHsFAm8aAj2gHwyBInAWDIOL4HJgJPCBPhy4CkYx1tWgG5xoroNZwWxzrauDOShZZ2NGGV89ZgfzY/6Yz0fE+EwfwYJ4X8GSWCzqzRzMuHbM0YT+/H15c4jNNSEGZag3uCg2P/iC5cGKwEiwCtSCetAImkELWA/azdjJBLsMwU1gC6gCtaAeNIJm0ALWg3awHXPfCXaDfaAPHARPck3euo6CE+B5MADOgHrwMjhv1h3jNXIFvA2OghPgeTAAzoB68DI4D97DXn4EPtXVIQEBMAlMAzeAXLv34xCaAwpBKSgDS+AfQLkivreharB6/LhQGDQl3P8UQmt1BO0jaB9B+wjaR9A+gvYRtI+gfcQ+KyB0nyHUCjpAISgFZWBJ6L7gAMoVIAyaQHdoM35lqkNbv1h25W+5l+WYV71MO252XUZdQc9KL5f6MqqXD73s5OXPBVTmcDlE/53sv8s5CW0xGj3jHIO9yDlhzp9Go6ecZ2Avdp6FFpoY9VC0EvYctprKVj80MdERxp+k3k/PNda+Rb2Lnn7WRqjL6Dlqeo7+mj3/gD1PZs+ZbLXXzCcaZfwBaj1bDbLVcUbOZOSH1DsZ/0dG7qeu4opCrH2V+iz9k9lPOz0fUcNs+xhra2if4yj9nFu3mZv9KpkR/zoY+yKgfwkzea/9osnk90U8/+f48jO/AlQtv6fqaX8jIxdt36eeNqqyM2ZDpxuVg/QszPgu9PqMNdBOzmdmxk3Q66jZzgXo9xk5k/28QXsp+1nCfv5Cz2pqkDF/o13EmPnU2zhKsRlFXuEoC9j/bGoRR1nGtteoA+whl21zOMrv6ClnP7M42zznF9A76J/AVsO0Sxj/HO27qJnUGrYtYdtStu3iTEo5h3xqMWdSRj+/v7wvneD2UKvvPNwZQ9x11t5o7R6wLSFGuTvSthG3TQXcSrcmibo0vhq3wV1jqXHvddelpcFtczvdjbGyx92Whh0pPtPnLndvCg0cNx114/gfJwfcQ+SIezyFXe5pG9s/Dv/rWKkMJXHWHU7LEMZJ5v8ZNzH2oo/LtnwzAe9eeWOa+Xj+kSQ+SOMb0X3uVQPsUe3qielgXZbO1jk6323QBWkoSfbpRbpc9+mKZExfceDp01VJ1KbxGepjNGI+jWzfrFv0+nSwrt0Dz+7VMZvXDSl0+a8xBoldb7JjbdHb/bhn9c506N16Xwp98X4tXWl8CeOmm1+6PlL23ty3sXWaOcH3hbK8L7PbvOzl/ftTTsbe2bTMngLTn639J9fmlO+BWp7On2aWP5ryheA/YXtfC94XwjLfCdg7U37dl+/8p9tM2pn0l9Auoe0/H2v6O+ifGz/v+k/DaqHdk8ykE639evHyJr9bvPPxKl9WfZBr/MCcp73ff6fP6Yc9SWrM/5ZLdRKrQRg0JfnXpsS6UiAlskjKP++ejr5qzu6Iief3+WYnnUqnjjPJ5f/iZvvIgT8r6bm5xEx2xcn3zb4xCfN8tID1Sf72lNhJsliWSiX6qZMGWSP3yjppk07Z+LmreYV5dQHzcDFz9UXaK5nhA8zYh+n5JrN0oS9Lx/OzIxk48e8Q0Y/qiGTqI/opmQrvjSpbXY/lzlTfEkctUyvlZnWbWiWl6nZ1t9yivoN3YKm6R7VKpWpTHVKnOlWn3KW6VJc0qG61We5WPWqPNKu96oA8pA6qp2SLelodl53qhBqUXWpIXZZfqivqdTmp/qnektPqXfWJ/EFdU/+WP6uoispZRzlBecmZ4Nwk551Zzix515ntFMuI+duJU+ZUiDgrnPflOudD50M55XzsfCqnnc+cz6TfGc3okT/ph/XDeBvN31dcMW9TMZ6UAimVx6RQfi7Pyh45JS/J0/JXeU2G5JK8I8MyorLkH+YvNtiXHuzLFv0I9ujH2CONPXpUJmOPjsgU7K6rt+mf6J/p39D+kd6qI9q8wwrqwGPiRD+j8QWrf6+fE0e/oPtlwn8ANujNGHja3Zh7dFfFEce/uzP7C4khSIiKFGJAREFERAR5BpBETEKIIQYEjIRHQAgJkvCQoqW8BeQRQogPkGIIEJHGgBCQ+ojhISLlYA/HUqWVUzFSRLQUKz7o3PldKVA89Y/YP3r27Gcfd3Lv7szs7PwCAyDMnA5rB9s7PikNEdmZ+TloB5Z5nD+PutKEoyGaoy26IhUZGINJmIFFeAY9ENYzPjEGQ3sOiovBjHt6psWg5J5U4e7EnoNiUNO3X1KMCUtJSowxrVP79Y0xyWkiY8anpcpMgf9+I/V63IQ70A398TDGYjJmYjGe1ecRsFIboYWsqTv6IA1DkY0pmIUleM6XINTDL3Az7kQs7sMDyMQ4PIbZWIqVvgTjajTGLWgva05AOoYhB1MxBwVY5Us41EcTtMRd6IlEDMBw5OKXmItleN6XCCAS0WiFDuiFJAzECIzHNMxDIVb7EiFogBtwKzriHvTFgxiJR/E4nsRy/MaXqIMoxKA17kZvJGMQsjABT2A+irDGlwjFNWiK29AJceiHwRiFPPwKC7ACL/gSYbgWzdAGnRGPFAzBaORjOhaiGCW+xFW4DjfidnTBvbgfD+ERTMSv8RSexlqUZmZm59Nx5SnlWeX3HjmgjFBeq4xWtlC2UXZQdh/uMV6ZrExXZiizlDnKSconlHOUi5RFylXDM/NGcqlyo7JCWal8TVmt3Kc8qDys/EB5TFkzIvuRUXxKeUZ5zqODMqAMV0YqGyqjlc2VrZRtR+TkjnMdlF2VvZR9lMnKNOUg5VBlljJbOUE5JWtC5nD3hHKeskD5nLJUWa7coaxWHlC+rzymPJmdOzzbnVV+6zFglXWUEcooZSNljLKFsnXOxHETAu2Udyu7K3srE5QpynTlEOUw5WhljjI/V5rAVOV05RzlQmWBsli5SlmiLFOWK7cqd+aKbgJVyn3KQ8ojymPKE8ovlec8hlhlmDJS2Shv4rC8kGbKW5RtlO2VnZU9lPHKJGWqcqAyQzkib+L4vJAxyvHKScppyhnKecpFykLlM8rVylLlxnzZXUiFslL5mrJauU95UHlY+YHymLJGeUp5ZurICbkh5zzWgTKgDFdGKhsqo5XNla2UbZUdlF0lZlup5mdtG0nM/flaIzGsdtiwllivVkhyE9WXm+R/3TNyK3isowxVhikDSlaGKJ0yaGlSRtQSr60VWrlno37G1kjGUzusW0u8ppZ4fS0wWvKweMle0iUXzJI8apJkMHMkGyuWPGg9ylGJN7AXB3EEf8VJnMG3hk24iTLRprVpr7HD0NGgX7mc4Bin/Pak357w29N+e9ZvzwRbU0e91pqAaeTPNA96sGnmj+/221S/9b9k5vttqd+W+G9aY7b4vZ3mgP+uw77MMb/9S7C1vYLP7Sx/XBT8S1tsy7THtsJW28P2RFDOTQnKuUUwgakiYQL5QitkyURHyW5PyyjropEJpKpEhpzamZLrzhYNzxUt1jURpp652m0SibYi4WnRBtIDQ2Scrl9p7M8lB/rIXLI/ZwJWv9tZfDxMfNw77+9K/52LejbQHBH0O3qNXqc36E2qoreomnbRbqqhT/k+vl8kolGP9tBeepv20Tu0n96lA/R7Okin6QvuwgncH9adE5nNtIVeoa20jSppO+2gV2knnaNveAg/xBkic1hkNlAZvUgb6SXaRL+lcnqZKuif9DU/yIN4sGjrD+e3eZTfBSTt+1KP+ndPE50R67j9l8yUST1wyUyx1OoLM8bt0Agoe3Zj5fkh+pPMbZR4Z4XtaCE9RYtoMS2hpVRAy6iQltMnHOAm3Ipv5dZ8G7fh27kt38Ht+E5+mIdyJg/j4TyCR3IWj+LR/AiP4bGczeM4h3N5PD/KEziP812qm+ymuMfcVPlSGZrRx3ScvqS/0xn6B52lr9gyMbPj+hzJDTiKB7olbo17wZW4ta7UrXPr3QZX5l50G91LbrOrdrvcXln5et2NZ9lwU1/aChMprJZvFMJSEa1QHRRI3XKJVtZfopXgSayUuvcima1SSy+Tkbe6La7kwpx1q90SmZ9+Qc7K1942DTyfNVHqtZ5HzzUNTDgqxXujPP/1PNxcbdPtANvRdrHdbKyNswk2WUY/tXS5rHT7SSX2R0rcZeVeWc2lJfmnFFpxRZ/+mD4Raxf/YG+1deASa/+4d3m+9YNn/duv/sOrxFv+m6+0kiyglf7uvPw3Yzl2ogr7cQhHxTIBiQB75PxukNNQBCfRYK+c5TJ6Svqvy7l/Rfa3SPpvSATYKjtdLP03JRZskz0vkX6VRIVK2f1S6b8l8WG76KFA+tUSKXaIRpZJf5fEjFdFN4XS3y3RY6doabn0aySOnJMYcFb6n9IX9A19TV/BcmNuApb4MkRiwzAZj+SBcBKREiSaDOIx0r+f+3MGD+bx4oGb3BoYT+5CpOspp+E97e3VnuUkTBafjPLq/6EfXsELZfcGFaqDoXJr1+BzzQgjEYdEuceno0g84D0cN6Fyyj3Zao+qNYNuXjZIf+Z6olOmGbRAEstT9DnCuA/3QTincIrkKVasdvGzTtxJnnkSdVUiQt/4kciZoJyOi3W8mXZq/mVk7RV+9smYp22CeKa3it4e+TphO/n7mTSLZtMcmkvz6EmaTwvoCJ3n6/gGjuGm3Ixv5Ju4Bd/Mt3BLbs93cUdZTzfuzrHcg3tzHMfLyhI5iftyMveT9aVyGj/AA7jKZbnRbpxmJs3oj/QhnaC/0Un6zNsVfUffM9hwCNfhUA7jWDfLFbrlrsitcMXuafeMe9Y951a65yUyVrg3XZXbo2vfoBqcQQs9Ldl+NkU229+mSc4w1s6VfGGd3YSmttxuQ0tP3sZ6+78g19+XI5WLUYkEkbAi8YBIjLX7JHP3xh3tAH/cVL8rMVr/l+flIZFSjNg7TnWaKM8ypDjxh6Fyg2RJCRE/mC43yjwpoeIRRXKCKqRcJb6xXzLaQ+IhdXFcSj3xoBr5bfG5lPom1IQi0vNgNPC8FFG6rmt0HY0ljizENLXw46LPI5grOv0QT9JH4gvzRbufYQF9xwaLRathKBQL3ohisV5LrPQshzViu44o8ayHtWK9HlgnFozHerFfP7wolktFuWc9vCz2G4DNXMVV2CJ2zMIrYsvR2Kr23Ca2moXtYq2V2OFZCG+JjSqwy7MTdrs9YivvBoy8oneJ9cW7Oon/9OEUPSNWzoXctaKpoH4TpBjVnRVNHRJreRph1YhTjQRUI3VVF+P+BXQa48x42mNgZopgnMDAysDA1MUUwcDA4A2hGeMYjBhtgKLcrJwgSQYWBwamdiYGC0YGKHAOcXFiOMDA+/8/8/J/3xkYmJczciYwMMwHyTHxM20EUgoMzABZ6Q4keNrN2nm4z1X3N/C99l7rkHkec/bne077IIUGKqWkFBISzYVEKhUJIdI8qWii7sa7u+Fu0tydZrkrDRoUZTo4mqiIohJ+a33fn/rdv+e6nud6ruv553FdL5/jOOfr+93fz17rvfbhnBPnXHDO76ZXdq5uPUfOfu2hn6Xi54OrUfx8Cf2qn9/FbbWvL/768/p//hXCF2FlWMoF7iunh8rwY9gQPuH+YTG7sCysDpeFy8MV4cpwVbg6XBOuDdeF68PnYRUfzgdw17Bchurzqufqu6aupUuuwrVz7d0B7kDX1R3mDne93XHuBHeiO9UNcyPdWHehm+gmuUvC9+HT8IOMClXyN3eNu9Xd5v7m7nX/dI+6Oe4Z95p7081377n33adupVvlVruv3PfuJ/eH206eAlUP62RwWM+d9PlXd7VcI7er6+X6ulHuWneDu95NdzPdDDfb3ececg+4f7jn3EvuBfei+8Qtckvc526xW+42uS3uZ/eLnCsjOXIbGRE+k2FuvQyXM+RMuVXu4D6ujhvAh/AA7sEHc1s+ko/m43mgX8rdqCE18n3dzW5pWBG+5CN4EO/G++pbVI2rhyXcXN+H2m6gG+RWhB1hO9fi2lyH6/J+PI9K3JQwm8t5F65B9amBnBcWcT2uyf1cNRf1/c5cmevo9nb7uE7uKHe0vsJ+7ix3jjvXPSuz5T65W26TO+VemSV3yT1yu+Na3ztHo/VmqOZG67/aQVd/Kk2lm2mnb+n383P9K/4dv8CvCByqh1qhbmgUWofOoXvoESaESWFKuETf0+lhRrg//DM8Fp4MT4UF+r5v1ufbkBtzc26hz7YD78Od9B3vwofxROlQemXp5lgt1o2NY6vYOnaI+8VDYo94dDw+nhhPjqfGwfHMeH4cE8fGcXFCnBgnxynx6nhTnBXvjQ/HOfG5OD9+FBfFZbEyVsUN8ee4I6ue1cwaZ02zFllpVpZVZB2zLtnhWe9sdDYxuyS7Nrsxezybk83NXi00LDQplBXaFwYWTisMLtxR+LrwXWFdmS+rW9agrHFZi7LSsrZl7cp6lg0tG17uy+uVF8rblLcrX5hCGpWmpWvSrene9EB6LM1Jz6S56ZU0P72T3k8fpUVpSVqWKtPqtDZ9ldanDWlz2lqRVRxU0a2ie8WQimEVIyrOaX1/u2qrwja/Y+fOnfru1NZ3rKPr4u7TFf/DN9MVf0lX/G1d8S+CCyWhhq54w1AROhVXfLSu+OQwVXfU9HBjmBkeCI+Gx8Oc8HR4L2wMP+ud0Iib6Iq31PupI+/LnXXFD9S9dl3ptNJN0cXqsV5sFrPYJnaM+8dusWfs/9eKD4kj4+h4Qbwwjo8XxUnx4jgtXhNnxNnxvvhIfCq+EN+OH8fFcUVcFdfGTXFLVk1XvIGueLNs1ywrrvgB+YpfmE3KpmXXFVf8pf9Y8WMLg3TFZ+iKf5OveH1d8eZ/rfiQsjOKK56VVxRX3KVaaUy6NF2bbkv3pUfT43+t+NtpQVqYPk6fpy/T8rQqrdEV/0ZXfGP6WVe8y18rPrzibF1xWeW2ka34zl+0ZA2wwuVvtt93XKN/1groF/xZ0PyE/HqeH6WXajuLf97xjnpox4M7Ht/ZzbmdLVRd57bX2F5re53t9bbX14/Hbh+3fcL2idsn/flIa6tVDVtbr2rk2upVQ9bW1Y/rVg1eu0vV8VXHVQ2qGqgf9a+6t+q5qleqPqlaUfVN1S9Vs9ZsrHpozbaqJVUt8QhVxcequiJ/vHpr9d+s+rBqS/GzT6+NVR9XDayarY94vP65q5pQNVZ/P2vt8WsHre2x9sA1Pdf0XtPFuTV3rZlddfWao9b00I/LVWFNizWNV39vj7PmvNVHFK89Vz+Cf6eyRHFlv8peeu1TeUTlYZVdV/5uf7NyqVq5ctXKpZWFylaVdVbOrayx8tXKfSpbVDatbLLyt5VbV25ZuXn5V86lBSX1JFqPofPUdb6BrvMH4VP9ffGfwqrwbdDnoD1jY9hUbCYbi7//Hv7QWljy5zqyz7X/77bDJ/3HxyP445IWJbu5/4dfsk42ldRxrqS0pI3+vntJt5LD7fMl/Yu/Dyg57n9+fUkfNbD40Qn/62OV9P6PjwfAn99V0vd/XPuWDKzWSG+yjvj7at3++zurHWR/+s/P/O9/Vcv+r/vx/ze9l5tr59POyRm3lSEyQu6QM6ihdsAjmLSL3q19dYB2kvfkVj5ShoVFMiu8S420P94d7gz3hBXaI0V7Vu1iB6+jPbxMu3jUatop73/NtKf3K/bAga4vH+UGaA+0TjjKTXbHu/Xa6a/VXj9Tu/0M7cSztdffV+z2L2m/t25/l/b7JdrxP9duv5j3c0u142+ynk/sKrUP13A3uhJ3navpbnIN3O2usbvDNXF3uoZulmvu7nYt3D2u3D3sWrn7XcE96HZzj7hS93fXxj3uWrvH3O7uSdfWPeH2dE9rHnvK7e9edZ3dy24v97zbz73i9nXPajeeq73hDXeQm+fecge7f7tu7h13iHvbHeredd3dAtfDfeCOdB+5I9xC96Hr6T52x7gvXR/3mevvvrAE4U5ya9wpbq072VW509zXbqj7zg1x37rB7hs3wm1ww92P7gz3g7vAbXPnu1/d2W6zG+N+d+dpFhztfnPj3U53MYmb4qbRLu4yqukupRqurrvFHeuWudPdOnem2yi3yEzNF7fn6eIeTRp3ybUyVS6Tm+R6uUSukatlulwn0+RyuVKukEvlRrnBn+A3+BP9RrlYpviT/E/cxHeWZ+Q5348b+/7+GD/AD/SD/Nd+rf/Of+W/9ev8N369H+K3+T/8UH+6H+a3+x3+d3+y/8Wf4rf4U/1Wf5r/1Q/2v/kzQpDJfnhgP8KfGSSU+JH+LH82lVE5HUWldBh1px50BB1J3ehQ6kntqA11ooOoM+1HB9D+1IUOpIPpEOpKh1Mv6k2v0xs0j96kt2g+vUPv0tv0IX1Ki+gxepw+o4fpA3qfFtJH9DEtoPfoE3qOnqbX6N/Uhz6no2kx9aUl1I++oP70JR1DS2kALaNjaTkNpBU0iFbScVRJx9MqOoFWU1t6hu73u9PffTuK9AidSGvoJKqik2ktnUJf0an0NZ1G39Bg+paG0Hc0lNb5jn4vOp2+pzPoBxpOP9II2kBn0kYaST/RWbTJ7+33obNpM51DP9Mo+oXOo610Pv2q2W8M/U4X0DYaS3/QhbSdxtEOGk87aYJ39Btd5Ikmeu/39Z1okg802TNd7IWm+BKa6qvRJb46TfO70KW+Bl3ma9LlvhZd4WvTlb4OXeXr0tW+Hl3j69O1voH2gYZ0vW9E031jusE3oRt9U7rJN6MZvjnN9C3oZt+SbvG70q2+Fd3mS+l2H2mWz2i2L9Advozu9OX0N78b3eUT3e0r6B7fmu71beg+35aG0Xo6l7ZQc9+Bmvo9qYnfg5r59u4iIjfO7XATtBlNpWqhgeapxppim4T6Ifpxfrwf6y/0E+SFME2el7fkjbBv2Efz1t7hYH+Vv9rP8DP9zfIvmSuvhF6hr3/QP+Qf8P+Ql+RleTUcH04Iw8JI/4J/0T/nn/dz5DV5Xd4M48KFYXwYGy7xT/gn/Rv+TT9P5smLYacl+vBHMdPX1OnhvPAZH8u9+UDtgT9RYz6Ge3EX7YvfcWtOPJnH8QSeyFN4Kl/M4/kinqQzRE/NdYO4Dx9UnCy686FyoVwg4/hjacafSIHfkbqyizTlBVJbqkkTfleOkh6S8XvSSw6TUl4ox8jhUkP6Sj3pLbvxR9Jfukt1OVrqSE8p5w+kQg6QWlIiB0lbacwfSmvpIkfKodJVdpdW/L60kQOln3STmtJH9pBDJMn+Ul+OkIOlnZRJR2kge0lDruIlvJ6/50r+nD/jL3gdf8creRkv5S95Oa/gNfwpL+LF/A1/y6v5K/6aV/GP/AOvlQ7SXvaUfaSzdJK9pbnsKi2lkewr+0kLiXwTz+Lb+Ta+lW/hm3kmz+Z/8IP8EM/g+fxvfovf5ud5Hj/CL/DD/BQ/yXP4Sr6cr9A+YaPvZ3mjfLmYvkHThctyNvcWIHyh1zIIK/VaDkFzkNsN2L42AVtXrwA5Xa+tIVTqVXOF1ntNO3rdHcInem0H3L84lxdZPtK+UMT2ZNtDWKbXDhBW69VywwH68WV67QLhc70eCGGVXg8CtjzTFVi/R7tJEdvnDoGwXK/dQNOB0y4D9iS6q8NUPXV4rqnqkbPMaknyyHw9eubs9fXK2evonbPncFTOnm+fnD0fm1v75v9ev5x9T/+cpbFjlCUry1/H5k5VA3PD1KDcyPx7NCdrksH3nKgmqpNyl6iTwVKp9swiy6zFx1XhB72eBmLTwWAIVXodApqKnBua0+nCnZ4/l1vVGTn7muG5e9UIdab6Z/5czRx1Vu4ZdXbuNXVO7k01Kjdfnas0b2v+ctrLwZ7/6Jzdw2PUBWpVvhZGE7vmO7DXPi73kxqvbAbSTO4uwpqR7ZdJQNX1OhnCOr1eDGJrMwXCer1OheKpy33AzfV6P4Qv9fp34KjXB4Bt3/wD2Pbng8C6lzSzFYmt/cMgtpaPgNyRr6kSW/dHgRrq9THganp9HNju3yeA7aTsSZDh+fuh5G69PgVi79PTwAPy9+lZfS02TT4HYu/788C2N14AsXviRQiL9PovkFl6fQnCu3qdC6RzgnsZ2Nb8FQj2fF6FcGd+f6hwj15fB03LTlMk7JLfN8bOB+flbB3eytXO76f5xRMyp7kTrIK+ndNpSbMo2HN7N2f1ckFu1/xefF/Ze/pBzu6BD3NWwxaqj9Te6uNcM/VJrld+H3+a14JFOasdn+WsZnyes/2/OGd1ZAmwff0XOXu/vszZvlmas/1mdXZ5vsdW5Cbn+2dlXkcqc+vzvWRuUKtz19pQnbveBvbcTBvlc9PzvWdmqK9zdjbxTW62+jZn9/t3OdtD6/J//4F8336f3zs/5OwetH6zIb/vNubuyvf2T/n6bsrZOm3O2fr+nLM1/SVn67IlZ+u7FXRCcu7XnK3jbzn7ut9z9m9sy2uJPe52IOsvO3K2pjtBp6zigXXx0LqGXgl08irWoGIdsq8JoNNY8bGKj1dTrwI6oeGx7EyhgV6rgU5txfpVrGGN9boL6CTnqAboTOeoJuh056gW6JznqDboxOeoDujs56gu6BToqB7oPOioPuhk6KgBWJ6welSsSQ9jnxf3eiu9Ngarj9QELJdQU7A6SM3Asgg1B6t91AJ05nTUEqy20q5geYRagdU+KgXLKxTB6iNlYHmFCmA1kcrAMg2Vg9VN2g0su1ACq49UAZZvqDVYDaU2oPOvo7ZgtYx2B52JHbUDq320B+ic7GhPsNpK7UFnZ0cdwOojdQSdpx3tBVajaW+wLEX7QLHO7guWpagTWN2kzmBZiuzf2B91kw4Ay1LUBaxW0oFgWYoOAquV1BUsb9HBYPWUDgHLW9QNrJ7SoWD5i3JWW+kwsOxFh4PVVuoBlsPoCLDaSkeCZTTqCVZ3qRdYLabeYLmNjgKrxdQHLHPR0WB1k/qC5TbqB1aLqT9YVqNjwGouDQDLZHQsWG2lgWA5jAaB1U06DiyH0fFgdZNOAMtqdCJYbaWTwPIZnQxWT+kUsExGp4LVUDoNLLfRYLA6S0PAsh0NBavFdDpYXqNhYLWVzgDLc5SzuksjwDIfnQlWl2kkWA6js8DqIp0NltvoHLB6SqPA8h+dC1aji2er5yHT0flgdZZGg2VBGgNWo+kCsCxIY8FqNF0IlvVoHBTr73iwPEcTclZTLwLLdjQR3DS9TspZHZ0MTmcTujhndXQKuEv1OjVntfZmYKsff4CzOrod3C163QGW9WknWK/2zcCytm8O1ht9C7Bs7VuC9T+/H1g28i+B6OP7uSDao/0rILo3fU60F/t3QG7HTw2M6PP2X4DcptcvQbRf+KUgmvP9MhCt/345iPZxvwLkLoyfRjQ/BALRNQoe5DI75AXRvhYYRDNGKAHRWSZUA7GfcFQHuRo/7TCi2SPUBNG+GWqB6PsY6oJcpdeGIJfrtRHIlXqtALlCr61B9D0NnUC0R4fOIJqLQncQrfmhB4j2hTAavO7nMAa87qlwAXjd22EseH3vgt6nQe9P0fspjAevez5MAK+ZJkzK2fOxuUTvN6/ZI0wF1j4aLgFvz/EKEM3v4UoQzU7hKvBa18LVwNqPg62prpnX+hamg9d7Mthr1vfEay0LM8Br/Ql6P4X7cc8FzWpB5xGvNTboLBK0x3qtcUF7cNC+6u0nInPAa60LT4HXehWexmzhNU+H98Brdgzvg//WfsoCXu//8CF4rV1hIXjNi+Ej8Frjwsc4h/DbMOsGrd9+KM4R7BzC694LS8D/jjMR40/GzGb8LzgTMf4UnFMYvwVnCsafijnE+K04TzH+NJyPGP8rziyMH4wzDuN/w8+GgtY8r3s+/Axe62r4JWd7YguIvedbwWstDr/mbK/YY+nr8FqXg71mrTNBa1qw16mP7UfiuMPmP8s3f/70yXohB7CcxAzWg1nAerP93MrmM+vBrHWQa6CXc02wvsu1wDIN1wbLQFwHLHNwXbDcwJofuSHyHDfCPWiZzO5jm6Etb3ELsMzEWue4HDnJ6iknZBeuAMsr3Bosx9iMbfO0ZRe272+HXMJ7gOUV3hMsZ9hP4rgDcgNrtmLLTzar74v5nvT+5s44ZyKbpbsAae5izURs2eV5nEmx5ZXXMXsbmoc52ZDOqGzrZRlF51LujRmOtP5yHyCty3w00Ic4g2PLIp/iTI0tfzyG+dyQ3t98LJDmbR4IpHuGBwHpXmLdk2w5Q/cMn4ifOJLuPT4ZSPcMnwKktYJPBbKzgNOAdA7nwUCaCXkIWJbioUC6z/h0sFzFw4B07/EZYBmLhwPZHDsCLG/xmUC6J3kkWPbis4B0f/LZYDmMzwHSvcqjwDIZnwuk+5bPA8tnfD6Q7mEeDZbVeAyQ7me+ACy38Vgg3dt8IViG43FAus95PFie4wlAuuf5IrBsxxOBdP/zdWCzAV8PpLWapwNpbeUbwNv9eyOQnSXdBN722gyw2YZnAumsxDeD5Ui+BUjzJ98Klin5NiDNmXw7WL7kWUBaq3k2WNbkO4C0PvOdYLmT/wakfYHvAsugfDeQ1mq+ByyP8r1AWtv5PrBsyvcDaV/gv4PlVH4ASOs/25mZzoje9uhDYPmVHwbSXsOPgOVX/ieQZlR+FCzL8mNAmmn5cbBcy08Aab/mJ8EyLs8B0prNT4HlXX4aSHs0PwOWfflZIO3RbHtJa4PX2YxfAMvE/CKQ9gD+F1g+5peAtB/wXLCszC8DaW/gV8CyMr8KZGcWr4HlZn4d7P/Bsc57/CYyNM8D0p7Bb4FlaJ4PpD2E/w2Wp/ltsPzK74Bla34XLMvyArCcze+B5Vp+Hyxz8wdgGZc/BMvfvBDs6IM/AtKexh+D5XL+BLz2MP4ULKPzIvDW06wOau3xVrMXg2V3XgLeet0XYDmevwRvfW8pWKbnZeCtBy4Hy/e8Arz1w5VgWZ8rwWs25VVAmsN4NXjtnbwGSLMoV4G3XroWSHMdfwVe+yt/DaTZmL8Bb/32WyDNrvwdeOu964A08/F68NaHvwfS/Mc/gLee/COQZkHeAN7680Ygy4U/gbdevQlIcyJvBl9frz8DabbnX8D+ZwxvAbI6txW89nv+Fchq3m/grf//DmT1bxt4zQT8B5DVwu3gLSPsALK6uBN8Uxz/GtL6KAQ2R4kH0lopAWymEgbSuikCNl9JCdj8JtXAZi2pDqT1VHYBv6teawBpbZWa4FvptRaQ1lmpDV6zltQB0pordcFrDZd6QFp/pT54zUXSAEhrsTQEX9BrIyCty9IYvGY8aQKkNVqagtf8JM2AtF5Lc7D/SystgLR2S0vwmrFkVyCt49IKvM1IpUBa0yWCt3kpA9L6LgXwmsWkDEhrvZSD194nu4GdO0gC0ntXKsDOBaQ1kOXgNmBngtIWvOY22R3sDFHagddsJ3uAnTPKnuDtc+3BzhmlA3j9c+k0sJ8LlV4Kdj5behnYz5BKLwc72y29AuznSaVXgh3nlm4C+/lQ6Waw81k7goz5HBv1Por2vmvNj/qeR5vDdO2iPqdo66zPI9qfbRbV1xyNPU/dg1H7X7TZ6xC9at6NevX6nkbN5dFmUc1RUXNm1PzltS9GzU9Rs0nQPBBzXntYPBm89rB4KnjtYXEweO1hUXtz1B4YtK9F7XlRe4vXXhW1l8QxmKuj9o84FvNz1N4QdZ2CPUet+9HmWM2+Udc0as0Omqmi1uVoM43296g1N07BnBztNdtcqu9jtNdpOce+T/dtnIXZO+oeiHb2oHsw6v0UH8acHLXnR5sxtZ9Fe202W+qeic9A0PWNz4LN/PE5CHpvxBcg6H6LL0LQNyva67TzFH09Uftw1P7r9XXGV8D+b2V8FcQe4zUI9jpeB9HeH98Asef2Joh9bh4E7VnxLQg6e8T5YOcO8W0Imh/iOxB0lonae6PNzlrDo/bbaDOyrdOHIPbcF4LYc/8IxJ679tWofTPo/BEXQ9CZJC6BoPk8ap+M1h81b0XtjdF6ouawuAJE1yWuBNF1iZUgth7aA6P2uKAZLGp/izbT6/0Xv4ag+z1+A8HuKe1p0XqZraH2sWj9y96f78Hr+xq1d0XtWWJrvAHE1nIT2BlK3Ax2phJ/BjtPiVvAzlziVrCzkqi9KFoP0swXtf9E7TXe3pftIPb+7ADReyLTfZtZP9f7M6sJNqNmDcDm7awhBP2erBHYLJ41BpvPs6YQdG0y3e9ZC8zJmdbarBVm6awUbMbOtA5kVk+1HmZlYOcaWQXYWUbWEWxWzHROzbpgXs8Oh6D7JusNQbNINhqC3k+Zrlc2EWcu2SSweTKbDDanZheDzbuZ7tdsKs4wskvAfq6T6X2f2Tmf3gPZdWDzanY92NybTQebnzPt65mdMen7nz0ONudnc4Dttb4ENttnc8Hm/+xVsPm/0BBEc3WhCYjW1UIZiNavQnsQrWMFfW0FO9PSmlnQelSwMxutKYXBELSfFmYA6+svzASb9wo3g814hVvA5rqC9v6CzVS6NoXbgXW9CrPA5sPCbLCZsHAHsK514Wtg7TEF3RMFy3a6poV1IFobyzzYuUBZXbA5v6w+sO6vsgZgZwxljYG1P5Q1BzvDKGsBdi5QVgqs/aOsLdhZRlk7YO0nZT3BzkLKhoCdU5QNBT5Ir2eAnX2UDQfWGlXuQfQ+K68Hdg5RngF312sB+FC9VoDo/VjeGkR7S3kbEF3/8nYgupfLF4KM/+u/LBVnhkRgWSd5sPkhBbBckmqBzTOpNlgOS3XAsl2qC5afUj2wOSfVB8tzqQFYRkwNwbJXagQ2I6XGIEfptQmIrlVqCpaZUjOw2Sk1B9H9klqA6PuSWoJlr7Qr2OyUWoHoXkulILrnUwTLpikD0dqeCmBZM5WB6B5P5WCZLOVsHksJRHNEqgDR9y61BsvEqQ2I3p+pLVjGTbuD6D2U2oHlv7QH2EyY9gTLfKk9iNaw1AEsQ6eOYLk87QWi917aGywLpn3AcnDaF2zOTJ3AcmTqDKL1J+0Hovkk7Q+i92E6AKSrXruA5ct0IFgOTgeBzbepK1g2TQeD2NceAqI1OXUDseuhYHNC6g6ieyodBpZZ0+Eg9hg9wPJxOgLEnu+RYHNC6glif98LxJ5Lb7BMnI4Cy+KpD4it69FgM0bqC2Jr3A9s3kj9wWbXdAzYXJ0GqGMxc6aBYPNwGgQ2k6fjwGb0dDzYHJ5OAJtd04lgM206CWzGTieDzeTpFLBZPZ0KNsMnrd9pMGb1NARs3k5an9LpOC9Iw8DOBZLWqjQcc3UaATarJ+0TaSTm8HQW2DyfzgabmdM5YLN0GgU2w6cxYLNEugBsxkhjwWaPdCGI3afjQOx+HA9i9+kEELuvLwKb09JEsHksTQKb09JksDkwXQxi9/4UELvHp4LNeOkSsJktTQM7T0w66ySb7zV/p2vBzgHTdWDng+l6sHPDNB3sPDHdAHbOmG4EO39MN4GdS6YZYOeJyf58C87z0q1g55jJHvdenDMmzfbpAZxNpEfVYzh3SJoR0hM4q0pPgp1hpTlgZ1XpGbAzgjQX7FwgvQJ2XpDmg50RJPued3BOlhaAndml98DOy9L7YGeLaSHYWV76COz8MVnvWYRzxvQ52FlhsntuCc4Tk92vy3D2l+x+rcRZXrL7bDXO+5Ldu2txTpG+Aju/SHa/rsc5S9oAdr6ZNIelzThDSZp501acS1ZkILo/K7SGVWi9Et2fFd1AdB9WdAfRfVgxBET3YcUwEN2HFbpXKnSPiO7DCt0HFXr/i+691vcD6wzSToB1Bm6nNbqdnYddnv9XMuu5uqbbdK23efyfoR07gUsdba5X5OT8/wLFhlQYAHjatL0JYGRVlTB8731V79WSpFJ7UpWt9uzppJJU9lT2pbKvXZ2kt/Te9A500wuNNDs0Ig3YLLLJIAhCN4io4OiIzufuOC6jI+Ao6ijKjCCL4uT1f+69772qahrU+f4PTCSnbr137rnnnv2ei3RojfwglnUeJCAJhVAtyo6bqiKFRlGHkW5VBbb6rHqf1UfEgD/c0NDY2FAfDvgl9ld9Y7TO5XSIklNU/otCsSwv4t3y13HsdovJZGkIewKFbkk0Z7f626JVdW0Oi8VBf3Sed6/TH6p/9w/4W9nZ5hnBV+YLmoVsk90Rjza0SFVDMCrX6cxFiCAH/OohZwFDE6qNVxuxDuNhEev0WEA6YSPCuDlBMEItaMRgQMhgMphgrGS1WiWDuyImBexReyASEYQHYnM/3/0fa2LuffvPnCFnV8bPDOI98kfQuXP8HcINyI90CP5T/6AA/6fBj2jwj59Lh9+swR9G6fCdGvwTOB1+UoM/mgFf0OCPUTid8zkvm7MbedC2eE4+FnUWLBAJI0EYTpwpnFgdL5awiIggko1Ip2tOADWElgR8GS8ARTrwiDdekBoBYITXpQYKI8m4JS8vz5PnATo5A0GDwVOhE50OV7QupixwLOJTaCcI+Pv1niKv31Duaur+SK3834ySpVfs21/cWJiXJ/WKsYq1jfcxov4pk6ZPanN7HF+Ypp/icz73JvxaB3O2IBsaiPdaMYF1Bs7UGQTdBhM2GLGkN0gbECE4yRYd6fUoKfKVzwVWybXl2uDbFiv/x2zwstWHWbijTvZDueDy2uQ38CHT76Of/1T9Y68Hc4eWnnySnB347cAfB54cwhfLNwGOHBfGDzmcH+IURwGthz8KAMds5ERFqCZeacY6gWOpF3TLFLcFDbcFxFDzBYC7fSIQOCgGAlZl27icJBwIOKN1DS7+/40NpOD2XZ//5PYbh2P3Hezv2rrnuHe875L9nasXF8nZyaWORLb3Znwg+vL+N1v+p74PsTXtPPcWaSLPo3y6M2ATCJYcWCxEhim2CzpY6q4E4EMWALNuMgLQfJQXDAb1sDOQyy3BduaL3hhz01Wn+7oxih9erKxtn1m6ZP+6+mF/1eiHZq8bG792kjzv8zdHrz1163VF3qbE9P379j4wBevJcGC0snJa9fJ15vDrNfhDXSrONoZzJToWLygA+pWVFgp6nRWL+kpMRCOgawBuFYHPc4DPA4iIWCTb4JvwP8rDsF/YvPR6cQGJYrcIvB7ko/DeDxqWjJscwWCpPRiUgDd0itCKxGD+VLLFqgmbft35hJGc+P6agWhRzOEtCrWVV4qDezuBHvEMKg0fba8pqYlmm1fllnlsa7KSd2wG+qRRbFCoTqPLzRpdHu5Kp9cxDf5IN5cF0/CrDHjOAPuiOF6QxmOCoPFYyOfTGfJSHFZN2H8AU5V9+qp7T33kqaX2NS2TU8mDp0+Ts7e+sPdgZOXFI3cjVb7WwfOzgDfa4s16WAOMJYI3MBoagIeaE7D3JPVd2dkIZedn57mBfnYrfM1stQZNjKEoQQPWQEPUGrUxZQGM7YQffMVTT19179DQqT0HL12YvPfeKYrDV07jeDeuWbn9yN0P7PpN97uUBmyujGfcnGf+kJIZFEeC8hgPXQ5/58DfZlQWD1MIQYCvXq9LMhkHNBKSiMk5Jgpy6e6z+5zsX6tP8v0Ao3MIt8h78bUm+Sf4QwNv9pOzg/xd7NmMn72cn/PS4Uc0+Mcd6fDrNfhDznT4zRr84Qz4Tg3+CVc6/JgGfyQDflKDP5oBX9Dgj7n4/rocdAelTQG65BkThp2kKIwyJCLJIEppdDJi0JhJgYpQTUx0ENhOYW0sCBNM1l3wKwg2FGXVAlRAiewIhKwmQ0FFyBkQz9MkAUpzRn2S0zKYUiXb3+b0h8Xo70+pkokoLMZvBt7k87kBJlcC8zGiQLxEW2vgTbrCbK1bCFvmXL0hn62ylb3v5zhHfmMe32GSv4kP9cvf4QuMURXsMy/In0LUEW81GYkOOzERPFhPhGFQSQLRCTBtzNi9iz5evyBivb5bT8VnIczVFgyFJHiVK5wSF5q8iDUEIlGrKAae//DEVaNdqyvqS/oqZvYuLA61XGv6Tf32XvMzT+6/fzJY2lhYcM1tp67zfW9I/mxhMawnw4vxV5jzVyFfZw6/WYM/XKTA5V+weXC4oL+KXJo2/pg2/pFiTke6t/Rsz/jiRaCxENhPG3SYEGoTYNyC0/YKpjSMgvkXtQbwE/L/zM9jHfwMyJ8jZ+WXcGBlnMsmAr/m4Jl22K+N8ahRInqTjiCzHm2A9xBsJhsMWBSbEwJ/A5MZNkVBW3OzDIUVOECXy8rERkPU6YOfKGUWMjc5J787Nzk5h8W5yU/I72IRr8gC7pc/j1e698M/3XuQKjP0jD4VKVsM5rsVfr3O5gt8AwYt0ieBjTkqJJliG2XGMF/6ckDDh1+/80750jvvxDeQnSv/3tdHwv3wPPO5Q8QBz3Og0njIYSdk4IMe6qAP1YHJbE17MEClCA7tLn9zQn5j0yZivOWzpvaenRP4kZWfDQ4S36BsvvZxq6IPGP5MDlVn2KQcfkSDqzYph9+swVWblMN3anDVJuXwYxr8kQz4SQ3+aAZ8QYNzWxXofM7L6FyAtj+TxYw2Lm8CRgMRRSmJJIlyGAxN6igXMOlMdXOHAJKmBHhIIMK69xmMM2QMFTFMxmCg6XulDCeyE6++8850IfMRbSXTRQxd1f4L0fNTyryGzr3J5pVLdYyEqVoE2TOs6pbmhCokutGI1R70U/0bSlkUdOUpK+05Ft1QGk4MD459Cwd+tfmmkuLmmoVJUDn03fAOgtmaNfM1q+P7ajv8SsC7BZB6YaAkWDYgx6mXA6ymI4ww4OpIepBXSLDqDc4K0LlWHMU4gLfPY/tm+Y+4ZJf8n9Qihy37FflGvBfetx1kBn2uH7UymXEL2c3meh28Lx/gepQfp2qETY6sUfk5VwD1bo9SqXrdHG41y4fhufeMcr6I0+8yPm3nfHoDh/Nnfl6DP6DIs+sAh3yGQ7uCw6G08QocC/q70KfkM8h4FuPPymfORCsonqUwxs3s78p4WZbZZBT1OsHAHAVqEQkgzdAabqbA72yU7bTqDK6KkOSzSpEYUCjmlpzEbZIvaw6tnfuH0DdGR3FWsLkZz8svb2069iZ9B4hXmPVZsLZgn+dKYN9TCx+EJSi9vTpmDinups3qcjCl4wsI4QYhIIB0kwTqM9mjpGXGKV48f5TobFORy/buPIy3rbtL9uJfBdsW22UwwuRS/OMMuWxBRXEvbAOYCaw0nw57jdVpdVDmsjtcTipN7JFwAxXMp7MmL32HmCYPkyXp/iX5E7Am9wePbMNJkM6aXKTr0svXhaA0eXm9Bn9IkR/TsC56Rv9eZV1Wc/zOVTK4F0Xjq1zObFCQoC9AbQJNhvWYGgWU7i3afuhAI06r0xZkPo8ONgTsB2piNwSEzBkQ/WhvvNZvL8nrCPxRmcy1o6HmbHOi5z1zsqZwP6Lh/qlzfL/UgM4rA12YBfZhmo3cpdnIsEeDwZBqI/tVze1MKW5qKp84fOTKlv2Th0+sGZudHRufmR179sv/+ND2B9f808dP3vzhkzedPHmS04q9j9F2OEM2c/gRDa7KZg6/WYOrspnDd2pwVTZz+EkN/mgG/DkN/snqdPiCBueyWQD4rQAPIBcqhr3THe90gd7C4ZAnXycQk0RoOMHpIHiQ8t1AimyUzVW6lZSUlJZEysoVp5E5TRHYTYqzWOeGPQW+pJ1Rkpn9EcEVxa+1nTgc9PoS4dZ2IKmvpCQRln9cWPxRt2d29J1R9h9k+8d3P/BlaYf9YPmDe4DKhj2Oo/Lmg8XELH74pPyfJ09uOFi88pbI5nerQu+pD6S3Gks4B/DtwA9O5EOvJ844uB+JQHQKG8xGQhmVzh7knAEYmBt4LfoRb+KMC4ZWXXgo0kYmkMGQ/iU3fKkx40vSgglcpq4Ef0ISqd+n1gL7esp1jWpfxEaj+j30wd9KJpPxPBdIapfPVVLggXk6fFYb/GvNAs/W5vZJARcNeIjUkoL1stY3RkWVz8EveyuM+0xvtkh33aXrwmb5yYDvhzt3dDa3tsVbmrvI8+aBvocGHh0eMOONTzw7eM1H77jm6tOnrwI8LwbiVoEsMIHFR61xHQgIHVoGNmK+A1MboJp8QfCyqGBEzB+0KjtN8Uirbj6anHvy+I1L84lNG8bm8Y4d5xA5u2PHcJ/8k95ptp93wq9K5pM6UVW8HCGgtQ7pl+GFVPIsp1n+2dnZzmyHH3zQEmqU25VgZMBJ7S6rMt8vbzx+/c2HN87P7xqbnh0hbRftunjPFeTs5+Xv9s2NDnEZUnVumkwCzzhQCSqPR2g0BQ+L+ox9kSFOwqVcnEguxQMIX1islPeMDE/nL/oXZ8d2N7ccmDp81QKIl/EJEC+/vK/cMpwIzo7N37czU8wQtAWQ6mC6zoUq4qXAR3rQQ3qQyHrFN0dpuoiS3GqnEheJkj0gvJfs+Ysj3972haW5M1ecWByZ3LR5dBz/wwa7/F0ckX9Czm5c391yDnX28X3F3s32WzJjv3H49Rr8IUWObQHd0cF0R1LRHfNMd1TAPswHmpZSXVrglUQdU6YKu3Slm1DBypCf01MxoRReDUfC4fPDMi63y+Uk+W37xxJHKuvDS229i56u1r27m7Z09e6sqh9Y2zZWMtyzYfuJhWhVeWsw3N0RqA5afcnR6FRVaaSpo76uqDxoL1iTpLgzHNlcl/hcDXxOHH69Bn9IRMqcbGxOzeiyuLOqMs+t00tgI6Bs8CKzqGJUAldBkL+ws7fBL7CK14Fly3ZvF48NUt8BZu2Nh/gwsvcDxyXj5mBlEMzMsNUA9i8wndP1nvjV30a1i7dVZwSzTkx/AAV37JJqdGlxrTnj2N9Gz5s1uj0sKvRkdt/zCpzyyCxSbboaFt/3xvM0P6o5wc046p9RtvBRBxHEGp6b/zciGf+FbEkkUMb3LTQeq6O7lkUIDOCL6sUkot4nlxQwOhUdNoKcxDQ6pXie9OF47sSJ+SuvpM8nW77aIz+I1/Z8NZEA3Nk7GC8sp2wm+m7ghRpmG/XE4/BewQy/TMwyQgSYIhWQFLEix0HlSISFpuAJXuSlyMCyUnx8F1hTZdpWPFhTnbZqUg6jQnP62mygNFm5i9K6FGhdw/bjcsZ+HIS1yWX+ukJrRht1C9oDjoDixfBgMNhoXIZZoyS3eWtf/5bY/GBv79Dqn/XtbGnd0Yf/Va4Yg3/wD+Gd7NlsH23LkBkcfkSDqzYRh9+swVWbiMN3anDVJuLwkxr80Qz4cxpctYk4fEGDq/7q4Dkvo4EPzXzGkUWolOcOqwd2Iawa2qvXEYUB8aKaTHGrH/Jcyno+hsDGzAaID/kCeYEyEYiHqZN/vmuaQUuSOz3UF9X80/nkZkZUcAmqZw86i+tVH3V4lfnY+hSJU3N6UpvT4/jCNFZ92Hz4oxPmKtL1FnHKiURKwId5djgKvkvUjn8z/+s1v176LPcZV56imga+P830MMhvMIOoEzSsUoLHjrDiC4H1ofpC7GnMC8K/2z8+ccn6+aHpHeNTE8Sw8id48BOErMhkiuLNns945uIMnuHwmzW4yhscvlODq7zB4Sc1+KPK/Ivhj2YWAwIv2iTpMPVahsH2pTQgWPGj4WOzzWaj9q2XRAU7nYFduP2jp5de+Ommx55Y+vE/w9q8g43yC/JNOCZ/He/B3fz5bnh+F4vNF8Y9Bj1QRXPekEIWRmGQXowkAl69+rfrn/3cmt9iI35EfhivkZnMZM9hdDjM6aDITA6/WYM/LKTDd2rwT+jS4Sc1+KM6hefhj1wWQwUZaaCCCuQkoU6zImyZwZ/UPGcjMoIxSQkCrnMD9tGoCrGY5B68U/4cfkj+aCLRT0oSgyu/UPiPPp/hf5zj70yHX6/BH7Knw49p8Efs6TmQU1oO5MlN6T7rKc3ve9KXbv+f0uz/JwPpuvuUpoOeLE1/7yntvU82cNuv79ybxEg8qACFUX+8xwUEcgJtivUE9jlsA90wEGwACAmuL0vzMeOrN0FdAFV6FhYWhgtDkUAgGKGGaJAq3oioJsujPHceYeahU2yMNTClHMUvO9zOUXvBbP34wvGDY/H2tlH30sT6zU8PuEdmhjfPFEptpq5gePXw5OqKplpv3LdmYqWzNHBtU+MmmA/DWyiE+VzH5nPbn/g8OdyswW/PgDs1+Ol0OHlTg9+ZMd6uwe/OGP9LDf6xP6l0tDA6VqEYGo4PBLBO78eCLmYjkliZS4gkYRhN86WiJIjLqby0fgFUY28CjB81VxkoBUqW0cx0wfmZ6cbY+xLWAVQXOGXrGmP48VQYcHCkxPweKgPtd1IyRwbcFVpssGa4wB4+j+TFsA7YBkQvDaTo0qTN/74Meuk0+P2MLsK5d4Ef1wFdKlAd6kBfTZwJg75xBrBeLPUTnb7NZgb+osFT3bD3QnCzbjjJv1SJdDnYhHSmZRA6CBvQhmwjNXQWsiQiir0JMzWgFmhAppsmchr/ynCkjU4gs1n7YjJeUh+trARx0BTtqO+orKusrakG7MuD/mAw5HdYwFqhoQDJ51JypMxqSV8UWAS+KO5G6ntKUfBEJC2pGm4gplki/1FqaPBWeSO+7rLoYH6gr7Z/atf26gVPZcA1EG/qsuZ01dRWil8g5bUv9rWU+otrC3OI59qjrryFabuzxeOpqlxVtnp4eq5ie5al019VUVbTP7I0N/2dGFhP1dGqHprLZ7Rne+RWvkeMnFc3AdxBXkM5YIUd5o6/Nc+dI+gEI8Y6MpwNtsGgNwUjKizJB7tVZ7A3QaNgeIHK/W5qK3hTn1DLU/kYsU/BXrBYLF6Lp9QWLKH2gk2tnomAlRez8rwp0M4KlH1rzeb1u5cX6sXhmc8PdHaU9uQ7O0LEc8uVRz/aHSOvmOSX5D3btm7Ztioo/6UkCHtpAeakAz5zo/p4bQ7wkwUkGSGsbET1Ynszojvw241cgRCL7gSVhVQCO1oWHJ/uLfVtrL7kROve0S3DZX09A7Ozg+3VsUL/qWPjlw92xKq3b968DPzP3i84gNa300Sd/rbKd3gE99w7LIKLtDFZ2pg7zh/D5mFj8yhH8Xi7B+uEkBckcXlZ2KojerVCQE+9YYL1ZPm8pH+vbiQYiNiDQRaAfK+b9J751dF5S058e4ZjtLwrfbp9vaWFsxXpOf7V2R/en5p9dczj01VfYH6n348G5H+0MXe9hwYE9Z57C78J/JkLWml93GoBnszPEwQB2DAX1nJQ4ULKXExm9vLohGKPARemf8IyvIKQxoXgdhRYvZFQwMqt1kAkfemtRCGMFbYtfnPYUDhSuWlz3VLnfOzzA10diZirI0heWSnsKy299YrxYwOd2Cb/Flhx+wwWfQGGfw/dX4IeFaFKanXkU29ouKiwwCCJeoEY8SDNLYO8WU4PqpSHq1momy4XDSwyhyhVmVLnBs9WiqBIeoDl3dpe+2Jzf7QjOd26cyC+ra1lY/OGtuye2vFW7NLlT9S2jo3GB6bJte7sbnvRUGW8/Su3zBztadkzOri3o69zS2CiSH6jtLQ8OTe/btdmtj4RwH0z0N6P7n6F5iIeAJeyDhnOEnymji8QQf0wpg/GuFEAHaDrA4onTyeAd0dDqnplffw8SUgNhWaq3hTDARkMXGC0UIERpOEt2KQ0bZoawnJlBoOqEJPxrGDAbrWF/NZco5I4jaQtWQN1Y93OqJCWjCZ948OG5kW6cvH5xscemxn/OCxcd38cVpDMrjzWN8FX73DvjGlY/rMvwJaQ8984zM8Me9CFClFzvFEP+FEPgrAkOdIJG+icUvylspbb7S50F9gdoZCPmkGNafpBjY6B2mgUJR/g+cnZrkhXKBJat2r/8aZtfZsOEPneyRE9tuH+9lOr3XlNhSW3HwMEbzzkdv1ufmZ6NawNw4vJ8/u4PDfxPcXhZg1+ewbcqcHveB/46XQ4s4U4/M6M8XoNflcG3K7B7854zi81+MdMKl29jK5hsJKOxHPAGke0ptEOCkat7Ss1YAkoKgE7iKJqGoFSWgAJ152ZPw2lhvJE6gW+oQPeyY1EIlWRqlDIGSj3s+gHSinv8/3VxlgqlMm3mgQoy/cKfLnK2wdS7mt93faL2dJNwZq1w9oh1zxdOZ+tuEG1qMIdDunUIbaO9unV8zNMxq8FYpTD/nGgpTitUxEJ467EmWKgAAgvoAkVDxtgsLggYVFsTfCSHm88n1Y2IvhZThumljXCeAey07CKLUDLGhGT805nVFJjPWCg4F/3eus6dz9lfHT22LFd0+S1gk7X/M4eeQl/vGf7wDxdp+5zlYBfP2pEXeiHcXOliWADHm7E0iBPKNQinagXdfq9YFlRhbRsMoJbKS3ADmZ6n0XxWmgUT1utxBkvfLEJRhklZNz7ngewBMAHfB/Muff5KuAr6oiY8YjUF5PJuC0Wi3XF4pGK+oAt1BC0makEgV2p2B6UAaKw3Gohb9ShRhID53FEY0ynJRICpLyov3Fxx2JNSZalf139bO2JQ4c3jeR3tsxOdtev7eotKqiqaFjXsWZtk/yvHZ0dTa2X4HdM+vKFiWWzsSCnKtRdOjo9Mu2L2CsrgpHmivxam3sg2jBd48jb0dXU1NPVeojvJbYWbG9/ku/tP6fDnRr89J953ovDq1AW6kFjWBe3SMBbPeBzN7uJYKLbjK5gCxINtMppLwIbGxsRkNGEBJ1JWM42E0KMC8ho7KUJGMMCyOEWKr7Z1urQq0vZhYjRbCTmve//JGw2f+CD4p1/9RkgcA2izpDxrNQTYHH9veAW9471jg4PdnXW11ZVlIJeL/K6HLkWWp/nzDE4KxCNQ8WiElth/f/1ymNziSVaV+gqdmPD38sDZK7Y5fTvvMRa4C5a9/exg7bmem3N7/oztxk3wa+3yO+QDUXiwRxatoaHbVaw19UIZ69ahWQP2FiqwU5nRRPSisUN9vdni9esum0GvIqRvJkZ/M+llffIV+JjNbBr5CvIL4z0PXblPR60JZ7lNrF8PbxHpyj8IhGsa12SJ8YRzQSChIbtSFS7rAA+gjESLzM772MQ1ICpB+VbQYIBnkxQZ6BIBViMlVXSSt23FFwnJ2cefRRwJ550hGd7h4xTvR8uraR7hdFH+BLQ7Ulmcz7MLBqsWDQEXQbEFICuZuREG7kU9jG9DnsH97A6WhpNb0vQuJ9aXumldeiY5ufQ8oVHJOMOhFjVV64lJxu4EZnAp3eqmWTmLtrVCqkoHvT7C7w+n7fnNvnSBz/2uqD3eTw++rPS0dODr+/ha81wJRZk5LVsAitObGNEZMXhSjEbC0iGUg/fwx/aw58ENOFzprbE09yWUOKJHG7W4LdnwJ0a/HQ6nNkMHH5nxni9Br8rA27X4Hcr+fpV5yqxzNbADd724U8XeIk4wNcixCa3YAbxRZeD5q2NSZAFbQkJK4RvoenkABtBqFGBlt9nVDJelJWFUEV5WWkkHAoG/L6SLHeWy5bLVicLVseWtjol6StFK9jOq2r7fiDgpUuGA8p/1F9/af7CzhfWy6+vTeIvppZQW8q6zccj3YG5BL5HvgTW4sauFA1/qdHkY8pZiMvAXuJ8GUbPPeNibgQ3k6rAbOD5wx4qEA1JEK5tNOUuigQ2IKtJAd6gNlCHjopsSsdyZrzq1v3V79LwSSlCMM5AZTH/1vsNTSokzQpnKQQtLvLkOe052RpJUerQTMD+ftVrUSu2AgW9fr/3325LL2K7A/iWfFij4Kd70mvZKDvL9Rpf6TQa3q/QcD3w1RcUvhr5dK6FEIWrXGyH6/gOVzZtG525Q0e3tUC3dQqcjOcgRGs42aT05+9ijTcafPgGmAGdxdijD+ccv+GnuCZtJ48fP1nQ5dy+CR/rgb3McIO9bEZ5cScNzQ8gZRe3oRFrHqH1W+lP/oL6xJm0x8Dc4TnEzvbmF/ne7OVz38FyAK+xWrqSeCGNQOJhAfQ7VQxtWv7CwQL1UdABdhzAseg/zswcwIY98sqrF9FIS738M1zy3/Q9O+RfsOf50T8pdbdreTwJfkVhHvQ9hXEPvAcUA9U4bVq9mI3nMuElUTd7yWdnZvZh02555be7iOW/5f/A3jeZfGsD3/8d8grKQYNxk47GTNNsY6e6Iq3pfpc3blcyyRvSoMnPgBbx8aQeC3PQtWKysG6+rMZVlxiYffDtKwds7d6xHuJhdGTvFl6H+X2F1eHddu4l9AOuKX7AfF91DPm9MoboH9iapkvo5/IvGP7sc0aj29XvkV0qnNb4Yb38tFLj97RS46fO3YVG4jkuqjWMBkk0CqywlM9fSVu0ptdj0PmDLhbowYUUNPmZsNXN588PsdEyQLrNaCEgpQh+h9KgN7jtwbeTwWNAk1ygxONljR040CN/p6lx7JUBG9c5UVjfEPhtxSgZNxa4bSYdYihRpe+i66xfADwFvR70H1gcXNl7EP2bfirCpyzkqn7IVX0xKgqAo2IL2I08pqroeint/6Nu5uBTff/75tEcb7RsjP4a7RLzGkLDzrzGMPF0TsuH8OFYpFPeqvwfsXQEwv3+YMo28oDt0vcZK7C+oCJu02JGXGszqUeFQpsWLupVP0g+aw/aArzKnqPEkVUsk02DUvE6MJ6yw5EKsEiIZbi0ihoj8daOovqg/KGUDUL17Te5vkV8j1LVJpM/oGzkQ49yzMw0xFecS3R6MuylfwnqX0r8tVAzTlqpccJj120Jmmhv0aS9L30Q/Vj1inq1gYoFA3t0w4VHJJkJ4ysp9LpdDpslB7DMchlUJSlJgRgTf+4L0GSuxGwpqytyl7irB8WSdTW3z2RHIhUJoM4fit1ZJb75g458d/HPz6cUStHKqdHqDiUHugn2Fl1LDqd7K8nt33NVDO4FmZHlzCVKphMPKLFt+hCFRkiJOzn5hOlZMS3kRGVGwGqvpHtGJ4Lc7SANqQlZ1Unit3xdzcWRcmd2pJQaoHzxK1c3eNrtgc4mXEbnQm1Qzgb3pc9Jp83pfmX9h0AuWAB3qp8q42X0jCLXSr3p9QlMwabsFPE8/ZNe4IbvuuTgRbsuPbirr7enr6+np5d4Th0/+tFTx4/d0bdl27bNm7dv28zqr+G9jB//NcWPGtyswW/PgDs1+Ol0OLP/OPzOjPF2DX53BrxXg98TSX/OLzX4xxC3C4fOXQ7wm8EyL0ABmqF0goXnK+FlnCy677CrVZx0tyobV58W6C8sdLkKA4V+V4HLWwa0c72nlpOXcgIRaS2nraGelXH+qPngRYXOUH95Y8vBXS5vuL9spf5Si+3aKPzCLx6fPfpR3RHHFSXH547dob/MeSzynauq8TFB3vydq6rkqwQ+p8sVGv/7BWis0+bKeUE4JwN8K/BCCapC9WgmPlmEDZLNTHiCTBhWE1lZRrMgSboFk57odHSzpiW+qqt9sPOr66ujtat8Vb7KSAgeV8xSV9m0LPEDUlc0YRVVHV3GSy6evCKuSSL/WYrWeyq8kZKu0saEw9ETm52ZnmvtspVvlL9UXl7rC1vLan5WJT5LQjXEc80xLVFVX1tb/5EPXXGqoW5r76adu9aXJkd3LpORpfkpJRdVyfif5qK2xa02qxmsOJHl6EFrIGUL54kskaSH9cVtmbqvgJpLTGCRBWqS9qZ/nIzbLRaEaNbJ5YB3ZDsCEl1/K1t+p8Q3tchzTnz/EMu25blG2NWFkzVtPfnOzlB3V0sH8cj/deyOtr+YyCvDZZW9NO1UHNi8bduW1Bx4Pq013mSz0nAkWM+EDOdkgxueBUs4oKWe2MZWrRSeEasI+GkSinnlGmoxWzpany0cr/wiw2xmUcMKfztUquAlPGuSf5uOFpMtlfhNoG02ykebwaJwApUEHR6mmf10wiJK2HTFx4yqAqYLzyNsKo1izwGLOCc/J89upWohaGOEdcei1ohVrbtVUp4sk7I7Jg3ONC19ece63W3tZd15MAXi6WtZKTThrFFsO3xn73e3bq4KYrGE6W16DsRGaH3vcxzTHBuIdQkTMAbBpBj0xi0ZADwEytEE40qoWYbRNn3K8jjPcefP8/FxZO/7D4xXpI9R4xVs/AW8fW7VOJGDBWB9PIDhlgINYMo4NU+c2TK/Kc/q1R+O7pT/a3r61tySJMho89P7nni5qwuf7DrW20vPq9D5M9nxcy47irns4HCnBr9DhYNtbmO68eeKbrQx3TgMNiXVjUF6TjoH1L2vxALLyCpgFHaknJl2TjqIAuXBCpYUTaunZElDGk1Wqikd6ukGPNNva4wtrt69ZvdU2DdYsz+/uXlu9oqlo1M1JVNVLdVhj8+b4+6Kd4+1tLjz+/KK3Lnugd7xsYGYh579Y/ixef6Kz1Pi8+Fwpwa/Q0LKfGxsPjF0OJ5fjkV9RZ4bBAb1aoRs2HJZLD2qHaCmlYjaAepUfkBJl3YL/AB1Rr3iBYcl46ZgBa1CLaUHqP/WItTziYbf2jaRWYK6e4hSqe1CJEyMnVeAKsWBZO9DzwvS7LRKS81u+pXCG7z+dD3om2qQWw3oVr4nTC6goJMd9vKqf1Be0fL+hOgWaHyvldcvC0opr5K5SP+Y9WRI1Th74/nwAZiaOpb1zPgsyQ+6NaD62lVVFZ48h000OLiO5ukZdxHhudAUgSPsxHpMacwhMtMTNtalG/wl+e5gWaQ2WDcbHWkM2Gpc0ebaWl+p11fk9VTVtrTM7FhHXpuIB6u9Tq89P+DJL+uqapos87eYsxsaKuqLnSXVxb7KPKfP7avvTaz8iji37wFa0ZyWRG4B36wuXuPEeuzCCCxyswm8aR0r3VUMzFRZFNiSVrva/kBxPmkAUwpYeeYd/340PL32sstmnjU/vqqhscZndMwP4Jbug6YPdcv/p6oyv5nzvPruItQebynCRnC+ci1ENyjRBAg2gt+XirwCBkajZvnQGluaELL7TYZCcAS5J8irfhVcWECVp0wlL8Vn926O0ac+RXHy2gCnk/FdDKld8ZsAKy3HJ5F3gad+z/3g2Tj3g+PUmaU42xjOZehEvCCIJSFkJQapDDBOFTF48lnsmG7VEAKYQduqGfORJJY86Daw49lsXFpx8QUHJuNZDkp+pz0YpBnjC5ZCvGc9WCXEMxn7s6MvbXny+gIZnQ7M020Zq5XrINWMNiCL6dwZbdh+u0/xU2hdg4X5omaRpJxom44FS+imXRQ0X1QBsmAePGZRkUTP2mFmfuqLxhT1GtVKGKzRz1ZUl4+5qVOyUJMYnbkzWrMqiK9aeX0gUjGRwMe5L0LxYDL39Qy7lMPNGvz2DLhTg59OhzPb//UM25+Pt2vwu9PgbzPb//UM258/55ca/GPKOeZN57yMXn60ELcUZBOdUIzB4qXFE0oc1Evt/DYqqMkiYqVc6W1g8pQqu/MG0Wie0R6wRwL8nF5G5xeVjlaNtiCC8CEtHHmFyAmrkLn+Bh6JTNa3cwLLN6gUL24s1GjRpM3tvgwa6TT4/cqc21ifFQuvW9Zhtaq2Ta2qtSpVtayoFi9u+OKa03esJha5Hb/Avg9an/QTmvyqjlcYYXvQmB918cFQ2stjcmD+qdWuWSiLli/TOhhfWvGygC/uG7543WzvzPJ47+QCvlIGR0YO4dPyNvzTldcp/uw9jIdWMniIw50a/HQ6nPHKSgav8PF2DX63Qocm1vvAkla/DPtlWAnXUG3PjzWk6pej9kgUrE/JHohITV9+bNPhIxse+/KWj3wEu/78la+8Jf/6F79gz+0AW90Dz82hEdEsRl8Wec0kch4lsp7HAGIKrTcWX7Qhq6EzaCl4NvnR2+eFhYtMPcZQDEx/uRZ/l86FPZvSBAsZNOFwpwY/nQ6nNFHgd2aMt2twlSZg1eM3WO7ngrXMbX9LLTN+wyRfjoPyH/F++eXBwTi+erhbPqKdccJvMPwNGfUlHO7U4HdkwPUaXK0L4TVe72o1Xk+Mv7cOjMdDBC0e8kQg3TcWNN9YhXPbRtBsmyfK03EQNByeqOK0on1ThsG28aL9cRPtsGPDOlGNIwdVG6+VBSh1SYkpEAMNhiVNRqJIYD/SI1GnF5fff1AyblMOs9gCQaX5UmEFs/W1kgu14M7p9FmjTtyy9IPZNWuiyViCFmLsw2Vre/D1cj3+Vk+8ZjBCqzG65foeOoccoEWSxdu/xPWE3eshWBJpBAQbBD9GBlo1ez5UZ9CpFpuf5VlBMbayiAhJitxIMRhS57A4ScLvM1Kna+HDVTsuiCRYUwkvf9AwMOmyQgHmCAV9VAGXcLH63nKUOndM0b6kt7SgqTdUs/9y08WzCwt7ZmqiCU8+2LfmeJyUmue7eziRBuZtuSsn/V5zG40P8T3xGqtfL0c3xfM8sC3yYUeEsF5nAiWr1w3ThMQQn2YEgfnES9n1CEl6nuRhvX5aqQGRyiaGDEx2CrTG8vyvpMYl43lFhQjRdGLAVxguCgMiXn+wUukKxKqyw+eXB9PqYLdfcY4b7LAv8cUzuTZ7SZkpbyDSO7N/a+tyrMc9MVJ0dWU52CKH5EP4OvLaUM9XXXn6Rl2Bt6B4qK17oHA8v7XoVyPhSJFnw8qfElqfLvwO0IP6/IVoPZ91MW1XoidoWWLhRVGNHLPkMYsEF9LOR9QLEpbVsWmfJ+Mu6u0XFng91ON32KjHH9Jy2VqFW3ockk3rhl11i+1Le6KL7U3xzuamzs6mr8oH8fXktYObuzY3Xba5a7kpPjY2zv63Mg1OAXoEH8ZnyfdBLxyJmywYCybmjvB5eIBJhQXQX7S9FU0tqX8wNvaxolAdPYqCBOBP+glK0hJgNErzEVRazlIvBCN+kFb9MMmPMtkQKzygyhA5nQGlGtmpRH7x2QFboaM8ZyBO7A0e8v2tb3xrVbDA/jqeKnXncdo3nNvFejXlgaUeQhPxUQeWDGZslEBGS8goSMYN7IVTsFO40WpPZJnMog4WZQ1MzYFHisGdLw4Vh3wlRUBteFKey023Ubbooe2FaGO6hmgjq0xpiFLuisV8VkGUwKC3WwMB0FikrtciP5rTFyxucQ30Jov8xnzs/jdRd8O+fbeIzlho6MVTp14sufoi69bFE8ebey3dX185je+Oer678gqWdh2IIOHcH2Eem1hfkwCKoOn4RAGmBWAmbAC3A4sGvAH2vihMoqwsKWk2EkmyJ3KyiSiiJEvxOOgZ4WAkGAmHAv6iQi/sYrfL6lRa31jFQmq/gASA+QTofEDHxmgTD/iX2h4BiRbN22mbhE3To57WeO5Llrjf6nBKuV+LDnm7B0fkX8TMBn/xjUNR3CN/4dSpU9+vGbppjyz/Ow6zn89h3Rc/dm89FuQVpkIpQ8CcAuz8H/hvWSDOzYyvKDsgHVpSE4v2BF8H+I4d2an7JIp5jPKAr5RDmEFg91lJoNfS9XC+vbyxPlzoD+ZG8BAQlmz51j33DgbiefVXHcM1K6cRPveI0kPCSSODZsDGROvStdPMkkgoF9DKvYR6ONjNLBsncoLwBBlqgKXHrFOQI9VRgrUoIvp5+X+0RhLzYCKdXRnHA/KRId5KgrxJOxal9R5kfcRY70G0GX4VKefMwZpAmBXi6tmhSYUQSg21I3XSPOjLlcT8CuxzqmfNrT6snjTHL8kvz3/oxpuPPYGvkH+0PDGXHCHbXti8fd8WclZ+Uv51x9RgN8dF7SVIUK7Wg6UkrQcLs2bUlaAn9UQ378vkI275a/P4NNm0cg+MV3unlNDzV7iQn7+qR6lnCj3IQE+0gzrAQ2AcEWH/+Y+Hvw3IAHpKT1/ilNhrGkiJkb6oV+i5dZS+ip2fgPftIg2sD1IB7QjC9vIk6AEmJu0JyaAXYCcn1QcXeF1OGOvIs1prrUagG2Mjn8rysIvp3mVc5SMNfRan/DFXTl+Fp8BhpxXveM3qZyx2V0kRrmB7Nn/o0CmzJ/efV06ToisfuGnG+9f7wdm1ygaH1g9O/Hv7wZ0E2vou0H/tvD5ugEsW/DHCeL0xHs0RwAcG4xoTsJUkRKQNelAv2J4wiFxEKDxuZU2xbFYziAU7PX0IMkCRBMph/q9tmzly0fRC21jb4tRFR+a2to3Rdlz4ItxH2Zv9PCffxmCsgAIFwG4qJM+jMtQZbwuHCE0oEMGaSzBtdKZqdbWnhUeLRXkZUmWoNOgLBisppyMXb1mpajmlvxGtEIwp/8EO+4B62LCzeaKjf3380PjQsarGqZ0TydVDl5m2d85OdzfOla+q39dDnq+aamhPGMVkomNjU11N7dBwd3fXUHNTQ7PPF62oyOiJk0N74mTRuDz3euys1QzsRYfVmasDmQRUAszs1NCsjwmB6TlJenfvXM6f9sNu+/jcgQ7YI+N46eqjKw+mnSO8EtaS90b7Gko/X3hSgz+q1M1MA6+vg/HZqAQNxfsLnUTSgwowCkRHzxKC9wESbNmI6cqSJUpHO3M/gNFYYqAkp6S4iMp9Wv3GzAWT6KywqTFSlnzCEj3lTbG3qpP5rymxxVwRDFabm8WZNtww1hvogjmxyQn61obskoKCkuyG1pX4j0/x2aWmexsP3/L+UVm0e4YR65n3C+jB1DZQM55iqbIf9X4p89GVtrO2bwrXPTM3N/mDtb/5y/aXaNM1eMPL2M94rJ/RjL2DyZxyLnMU/rcA3/F+RoF4iZH5lgZ2eBKrIoe92cslmi9Do4As/1y6OlnM1CXsvWp/JoJ6UmvH/q74oF5AHi0j5lV6AYn/P/QCSuNV1r8gJVgpmZngtjJG5ZJb6aaHn5onm1fupoqK85/aV4WgudQ5WJgDoedg1f4D7HN+ZtIDn/cyGoP/ns1oTOMZA/SzA9SJt2Pw3/MpgUMKcRX/fV9+6+JAdltf2BL65cJXPj3/6fZEtbHPWFJbjv8o9+HnOD7s+fQ8Oa7nZ/aN3LbLPvcK8NV3ACugLT1jZkFEJ+S7QZ+CNhd0wn49qHKk209DLWg/4LXdZisusuXZ8lxWq1OihODCBCxLlhyINXB72W21szB2BM8dO3T5wZlDxw4dm/mHkeGZqZnhkSlyynj3bafvFdva9PfeedvdxtbL9584fokBvylnGS45fmK/ADirZ71ZJatSr6NnfbxAs1up2gOzmWKpGcYpZmR2ry1gDzBDh9oZGRGwGDUyqica1uye6+9e384MDI+/cM8SNskrvT3teJT1ydpFulM6CAxcmhizJ0Q9SVm2PFhjVfcbM2aVRoukuy9H3kQbLVIb6uzKR8l2ajvRrnSknD0XuFnRHjq10ZkDpWk0n88aVf8l5bJu6uqxq6fgSafJNvpDnwU4bmV8w7rqAI4iJ4NBYlo7hWVapwzRq+Gp/ku2Aq4e9nyOrPKKldPKnoD3aDKARh8PUD+ZWVNoDeGixzqp4c1sYPpg2vwRcNc/2ZdzZn5oefX8KUYJEB3b2d6mZ0YiSv8hRmWwXAXETmTbWWJ2kU/AbDbbzTYw1UpEpiRUOy1qVe20Z7ZdccPNR740f2Bsdj6Bz27dtX8nSLjn5J92zYz0cjsHfvWl2YZaD6KUkawc64QXpnchEtO6ELFaM/Wd39tB3/nCZd87PDLDX3pgB9k0qr1V0HjYBJrPxddIwqIeicucl8CkwYuKZLFYLC6LE14J76TWcdosaTNLxSINHOw8duT4wTtX4y+vXi13DA8OncJnL9q2e4/SGfAf5R8NTJxivTxhz69mdh0775VDT9YMZ2NqTXzQzJ1OZ6GzwO+1BrhVTJGg8xZSboJmGy8fvey1tWvdRk/IX2lz2Q1FoC0Ge/v6KSleItvl7xw8HPM0O2q3rcWH5C/IP47PjfewtSiDXxQ3Kwjv2ni1HiOjgVB7allk/iOSJI0uNpvNa/P4Ge8Gc01iAceJd6IKKAxsVYs78MZjlx0+sPbmubmbZ62rWot7+/G9G7ft3YSX5I8DeV7Ddvlx+T/dHS2JTrWvAJPLS4zPW+DvOvi7gPaSpY0CAAcEJpZATSx+vJFWY2omllKN7NWNsJ6W3qAfvBtuYvHTqLRfl0tJw6T6cd+/tryqd3JunwnXyt8W969Z6q4Obu2bvyYxfs0ked7va6g9cHTwyuNtzb7yqQdoW26KW7nS55ZVY+Tngf0HNKPVGIrtt+F9bT8vAvLZQgpiWs6IWSy+Bl9YMfei+KYP33Zl9/5IfWh01cJ6Uf4erpEWZxtGQ6s2XkaeP/PY2edqymp9JcdODF++N1AUnU3rI8rkdPUH9idV+28S1hsTn/sLfNjI7GrW61zgZ5spmVnAhjYNZfEoLh0dtG8lPegBXOmtwAEnrVrTwhks8ubDt93fMfXUXLStvDVv/kH8INn2i7Zvvf2HwY4it/xFsm0o1VsQrFZQEH60W62a0IGrqMMbaF9sYYE2/qCbAlz/BSrcvDRCWKaOYRuGDtQvGDixATs+mFM8GXfZ7WDb+u0+bz6Lv9CAoSmd+ArjAi/kECc/oMMS7AH82tzCpi1zpHd6uk9cvS5c4XBUhIOVLldlkDz/xGfOPP34/TCVs/KP77pzoPHIzouONDYe3bH9WAzm5VP0I+1lXxevETP6i9FtxbL+9oQiri05DluO0+IMg9CmepwabuCo8Ax/lJ3sj9KWjvN33rrxwdb2a44/86WJ0RuPYKf8O1zm3dC5cWd/V98NOJev5bnL2FoWUBuCMp8DfFMyTDf1gOK+schqyn9j62m1V/mY68YW08GLEzOWVAq82TX+1OxqV2WNTVtX4/34mrZv3bG8pajPVtpc/RFtgYfoPrHC+g4BLqU0VyRhWhoE1gxtA71XZEKXVdEtYr6wzoA96A4GKFPB6uRqpWNsp8aYLUOlHQtLKUn6KCkpe7CmNTe3eVXFcLXb65wJBBYLgrOlRWVVQf8MWfvMcfmb9fBP+w27k7cttS9++sAb9c2/+mVT46Yb9z+1kfKgCX41MVvGSyUNMLge03b3wIC8UfcyWyoTbc69yM0CxlJeuyffrbAUSEMz0C6tSzvVtrQ9u9KrHXTGmetuOXrrLbfM33nnwOjc9NhQH358+5a9u4ita+3ari3y3d1TiW75Z2rvq7fINOvn9VA8x45FwYF1oh8bsXq8zidhHc3M0z0gisKCYgLQxLy6S/h2CqUNVDYSy0t4MgfHy95/HNtSSsrfyyLvOSVFVmuIqgGb3ySqaf+0naT27ZaABly2kemivro9V+n7V68eMF27s6q9uDyvtPBW+6/+U5oZ9JcXhtz5j90rf5mckX9y230OZ3NO1mvDJ47mWhFKv6fEDLob7IVsuvmHJcxa94poI2NkZr6BjsrKysrJyuGWG4tsMd3EWscGhIiET7ZMtSTX/Hz3fyztHRkBr4t6Xi8zs/OiP/0J3hWCd80zWZhHe/a7sSTmYiSxSgyJRh/BI91IO2+D5AHDjr3T5XLlufJoz361+7ZYmHqxQhd3jKJgJvifgkPBrsn+7XNzOwles+cfZieaW5QwA/sBmfJsLcGHAKVtWC//hdMgrPTptwI1QKZYsohBpERgepG2LTQYVBmthEhBW3NsjFpAlBMi0uBzSlFwjUndxFTzbPP0xN7BD+GHrp2858gfWRMm+nPkf1pa/ucd/m6aQ71YuTOlL97ttBGzhIfzsQEPwb6glAd/fUMWNpulJBXHYJnTKDlFgt+E4nZptLHmZmeio5CHIxVxx8jFU6PVc9VjU8mL5+a+fgBfcXDoLzt2anjBDxDoGxS7t99+m+M3da6ciML1SARJMxTv9zH7Kkxjcnpapq1Hg7SGd4Ces0f7RRqg1+F1mslFRiQJjMFSKUKPF5UUwWNESXRU4EiMVu3yUnSmHChXs6ogtqkbqMYGnNG5a8PHLg9dk7zk4GK0wRkKlnTGp2YfSozu+L78I3zri17yxkUVk5MVF8nXbF+7sMsoZtty7QF7U0F3eW3MkHt8oDP++tDQH0AvZyuxBUJGUz2YqE2ETzC5UACfT8HfuWggbraAEZRrJPzwSmYZuhp75GXodq0M3aPAk58JWu0l1HdGVL7zvDxPIxJftt1tuGv9t5buPWZpqvGHC8hlnoKVL8AOeRr/rrne1gR4MTyEX4MPO8fOmlxDCtCDtDqHnHmQJ2AFZDxXyXA1A8+U0hypHwbi4VKsVoYWqeXnHtbryZkw8NJ0CfaxF7Ps6HkDYJ87lFH02IGXVonm0cr1YIAeCsvyZOU7bKx+3Sg6+R0CiuEOuozX2bMghBvUCffZBVGUJgcHp6eHhqaLSrKzS4oKS7J9ZU9URk2BmZH2ptHpnMke81Nnnnj2mSfPPN3dCgr+aFvbse13X/3N7L5unphf+a/Vmx1cbncrPeGyqX+R6pdIT9izBoWquuUNtPl2YP5Fqlui1Set3Hvv3ObN+LSRbHq6R74V7+7BaJQ9f/ZcFQmx/nqD8T56XM8IfreB9UQsotyu3kq0nBafFQSHZoO6mQ3qQyVWnz0UDBm4zkoL+zc2pE7DRunFEtREfm7HaG9nrc/uyysq6exoGAvOzeFys/zzYLIZf/nAJvnHPBsQCuPK3sHSUvnfydmhN0IRGq8FX3Uj4OtBXfGO/BxwK/AwyAfQsWaJUHlBXfYlE+1PnxLg7JCuh96BwkO3NpqcKuSx7ZgmNdKjuGTjgCUPb2kba08P5G4E91mHe2jQ9j3B3JeQEse1sThuGxqLJ2qqiV5sxjq9Jx8MepdOAE8DPDWSzW7MAetNJ+h1y1p0V6vlZEltjzgSCvqCYXuwzCDSJqIXLuD8gPhunRYJJoWxrX2ZVZxd+8ouGPEd5DHh25ZaxcxSTn1txfnRXy02zOe+DtYmwXrwN8ajFmr1sJ4/kp7eK0HlIVriDqDi+8GXclHueYELpRmusgyJvhzXSxM8tPk1oH5GbPOltNipg8XvWRdgPWNgo4DAZ6LNOowbuGUo8beC2lDutMilloaqLKh5pcTvnYFfrpqdXdXoeXThS9/f8BlPo/LWlx5/XInb95+h86V6fVB9t4PlG2F+YJQa6GlxA2IqzMjCzIpZnnabhilNZaWMO8CADG7/+sRcIjF34MDUF9f+gL3b3L9+ff9ROmn6XrNiT+TQjI4ZbDna5ZFuVEHcwAK3OsUSVqNlOSjHlpIMilRQZvvi6su+N/DC2n97dfu3gZ+foxEONXLclxYns6BV8aq/tprvDUPxy0JSIbMu5XYSupSp+0mUOJQXZNEkvKuIatwCTCR7mjzSDdO3EkFiaRDFLqFG6vmyqAgVsm4iwZCRm/0ZOch6fkiPX2PSGCXC2ERXvNbvLHZ39FeXz5+ax10VLfiF2UH5/uHxUHOWOYG3jQflJ8jyyscA21dLM2KH5fEIjdMDXWg2VpGPKXqcHzzk1PBplMBP0Xgcjy2f5nZH4Nz1pB/kRwXtZBLvcIEMdmMdqQZNZyS09bjS5FqH9IJOv3zBeHlZOBgKl1PXKyhKbtbZMJLWlSn9BpxoqnWMSHu/xWgnOCfp7+vwhnKacyPBUNHM5X3DRwdbp8ur/F2h0S2bVmf7Q2XDNSOzrxUXVlTiwVDkCx8K+qsdFc5V1dLU/fv3PjBVEmj25F976iPXRhdq6iZq1o1Gp8pdya7NTXXKnWJWFi8vRy3xmBfWuDRSIOiEclDT9BgNLDWi9zjo1IrZ9WqW2SOMBIOVwYAe6KlzOi5QXX2h+8DwD3pamktd9kJXQWE4nDjQ/Z7bwLp2tfTXtedHjcYij6/NbUqe3pp5G1iXkftQu1hcn607r9NcYvHiDMf3vHVnl59EuLuL59ph4XnH4pVXaO6d9StW+5IS1gc01ac0h0ZNs6gpPpzS/DxtxV+lGOMsZkLFR4CWSPPMwSXLV6y+YuM3afdS3Nn7l7/04v20gSnvswrz6FB7MOeYDXqdnjZPVxhZh3kcIW1TM7NfY2KB60omnztAPrOeq5to/9UzdFsrLVeVFqw/pLF9Zb+4UFO8wY5B6bH2fMDDBIz6ZdYeSERLisepvteFXCzGz4QW3z3nhfkVkZIK9TOxkhnqV2WLml9wo53xXBeoZLANKBLgBtM6q2pWcaQU+0siUTBhJpZTzYHFC9URaaUQbCT7nHczciO31Wb3ObQaCJY9UfF2g6BvZAmK1oYWI6B9pKWrhmcoKrN2buKIXyG+8d9ZVXhUzVcFWQ0IyF8zyx3lwtIMpdcEaeqFVYDYrOAJ0EA6reVKC6FFrdTy+vyO+Q5qcM3PB1e3UFvrd6+qFpb81XBYywckmb8K60X1uAn8Ylb/QYDdtfU6T9g5kdNvtfvT1ou3leSvZv0+SbLP0nH1qqHi+fmuHWt3wGq9elMpa2gvf2Ng/+YH6dli8E9iIBt8/AYMcLJ0Im+6RU8TGiQCkoHfYpAKJyh3oXnJiN/vL/WXhoL5tqCf6aC0tlnUbKLSjgZrafSrg6Q3zIoJ8iPCVFdZvb9seGnHcX1nX6TZZI6KYtty57o9U/p4c9ughMe9V1zmdtfHP34P7lpV3+Bx+ax1yx8ZPfMJ14lDR4+zs9HnvAz/WtSEjsetwQDRSxR/r91IA59qyzAabkaY7DUaCO0lh5UKPdpEisVHWOW8m7UMu9BQ1jxsvfYNid67VFdX11TXBHN3055hNJL+AT3DYuG/kRiVNWl9LVav2an7QMKELalGF8Orch64+cJkukBcmdVhsFx/MJXrZ7xYRVzMJmiLNxfZCbtyUscdFASWD7AH5UgmE6kvl2YLsMisg/okBbyuMe1yG9gVDVLK0MSfXzPa21UDDom7I96jv3F+fvnxpWfxpbvW/kapS/r9YL/RKH8NOPVf8Cr5uww3O+yTvv91fRYrJMioz+ob6w10352eUe/o+/H5BVq3pejCa7Qa4nV6TLUlu+8K9qgAFpqSaDnPOlKKW6m+SLvpJ91ES93xoxhq1/Dp4+s1Y82m9GXfxXTU/8Yu5DPXsjuki8779fn51+dhumlm4W2K7tCrusOJ9dS81rN5CkTPCj9BMCyllaQhRXcw1aEKYVq+1PCeJHFnTl9rZp741Ivfy0wUa+u8yHAAHrSbDQKhUWfgPB0R94I0pFbLbpbM1583carDrE6nIhPpvIVwA717KnX1lJ0sjg4Eqlz6LfMXCfbJyGUbFg8HKB22LV1aIvvwz1quaFZvoKKLr93Je6V2J+/X/sp9xrz26UqtJuprTvUOlbdIhN2746UeDD27TO/mAuYFz3SDKlZ5qIQFe7wCjUt6XR5HKORnCUS7ll9S4iKMxihGBU8Nvk+3eqJ6MFJVsanj8qvaD4wdvBrfli0/LU5N4mMnLi0qiIZKn3x830PzTzwiv/7nqy9W70OM0DngI3wO76I0+bBTkw/q3FjdFIOHOFy564H2+7Sxux46420OqsOMLJ2WjwU8xGprWCvalO12fk4NPIhQSMupZdxykorT4Qf2te9NDKyvqiobahyZOHnoZfl7+LafWfEt2xbiGxtDoVihd6TvaPyloaEfp9cuLWi1S4/hdPhODZ55txSF16Tg7K4otW7Gjjx09WiVpJ7o2LE6xSWQ1H7nMCmHIzvb4XHku13Z9mybM+QziO7MghrEm3zaGtnipZXUyM+MirhLPzo2OSrIXxDGJ7TSGuy97PDhy1a+eQX8k4HriYw5sNwmg/N+8J94O71uZUGrW3nMnA7fqcE/kQF/ToN/sonDoxrtmlLPp/WUsG/5XaSl8ZBir9Mdqkpl1VynZ04UqWxXrHWf9LPWvpxOFjFb+RUtmlDuz2M5f/auzrT1oD5NFRlg/DYSH8oG+zIL096/lM2A+UBKIJHb77TnI2tKxeoDHNqBXXfaFSOshpZVF/JLT6IZuksN6mH9vfe2UXntc4C8bk3F9356jaK0utVAH63zqiJxFjdrj7fkOW0WkF4UI72iSXVUke5V5RdL0KT0Btj/NnvQT/WGPt3rakj3BaIkzoJ6gExRSSjNKehuV6N53e9xDjLufbDyO7rplYmwNsO07R6mls5GjhZWKlF4CC+XqnV2fYVddXoEoBVppndAfPWeu5+iLz97/z3slWPd2Mfe+bNu2Ce18NJ3Wd2GjWkv2E86BLqE1uqw3gGLep6TNtNoos1szcmCsUZrUBJdFXU8hUoPMMasvHf9P5686dDu+W9evHdi7uMXbdmyH0sr4wO4eChxI5ezxnNvsJxlIdi0QP0SMGJFGhojItGLe9VmoIwnqYGr4y1+gJOKiopKiyJBR8AaCgSYOauE/1RvnuGhpC4jUaTeUwDbd2hhuCJuXTVT3l+xb3f1fEGBv0I/L99S5VzVOVAdxk0dV58oD09UL3bvOwLovroqmtza2i9/sbzyJzOz/XHlPhLYbzT2HKS610MLkqnJRaPB7PojPW/exGok7NohYiprSn1Bn51nXRWEwRlQg5QNyp3qbpeKN+lcP9U54xufHhwdn1i9ZuH4VcMjA3mVvopa/Rxubbvuyu7BR/o6+rpb+pfXDa5x3V9fvuaiWL967+cuUsHOLwCObnq8jFVMAJob0vwU5imk2WF5KI9dwZXyVYQLIEgq+nJCz3/k9Oh4YvKZx+hFXHdTBzPS20lx2bh+eIP9NxQHPawvjUEWU/615LBLahC9O0sn7E0rpEwFaBwBr50FMRTyNGTYgdp6ksTicMf4OpupIBysc+Y5zHlYX8gWkq3f6hn8jbev+3B3sM0Vu+pKXKWuIqNLLeA0xuQRzdnTs4gS3qsWOSietlrZsKhixW43CjB7WUGsIWWmpdAaWxzqGL99bu72OYbNnILNo8xwexn7NUTU+41ZDU5YqzdtYn44jaHAxgaTbq92jxSvOVOp5Kd3LdEwFlINC+V6JYeKSVPH+vqBpafxj4wvTDT0AiYtLWsONa+bx58fGZFnrljc2UDvAm6FdzaotdWswb4feDnPnV74s/y+hT+0tjroC4a0wh8tdialN6RXdqTafxWf2BddVT7X2D09E7/EtG9odXJix2x95RXD45d2ru9vn2y7qI88X1ER9fmaG5uahrp6uoaHamvqGte3jywYjImWxulqpMptav/m01vlbFa9wO/yTN1sa08X1F6w7mkOLt26z3AxUvZ9ZuWuYuaTRzJ8DaWXmg7ot17FId+VrSfUfBrOwuyyPSHJI0aKeLYV2my5lLe5bI6kXu+OMCFN1q8+eunM3TtbgK9DwSjja1H/pR1bp2/AUfnbeO+bb6QxtSjKf8aS/EUqR2Pwa5TpCQ9dydxsIupZK+phg9phWmstZk9IOqJUmCFk89jy81zwRasDnB0jLYgRxNRth84Y6C+k1VX894OFUzWh6UObDuydO3NW/thwX0fEj7uK/fTmw0vW5f5SPiPfh/v7JwYG5Z8CXgblXm0neKl98W6JtnahHgpwk7gBrAssGfEGQ6pGh14ayc5xcW+lqABQY8cKrGGm9mno3JdWr+NTOh4IKuOROflf+i9Zvrq948r9eMD0lXvuSZZ3D3U1tfX38woez7qudXsG/3PwTRLq62a9WdT7EglanbqDifnfF7M1Tir1k6wSgLZ/zc4ymww6wcFu10A82KQIDgVzZ6qUVUvaxGiCOyq5pYhE+ra/ODE/P7nmUPjw5NrdF4V3TavZm6NjsfG9d/U3DbB3n/uzYjuFadw/iIlYaIetWQAGuxL5TyUhlWvZLpiEDKMQO9J6gSRkKu6fthlgk54bnOiG/eAozutoK4/MZYra8gb8wlRcvn14PNSSZR7G28YD8qfItnSRy/MBHiVvEUDj8REfrLYDaJbKW4DFB86iEbCXkE6QdBt4qceFchcBxCsh7TALav5dYBaimr7gUvm8FEZeuXuOSeaK1vOTGFa7/ITiXNMEz6ulzDYpUmyv/9e1Smevu+XomXXr5k+c2DIyNz22dVmpVbJ3rlvXuTW9Vil1byntTTUQ77XnElEHiAFawIh6Ua8Do0lpckQ5g5rWm9Q+gKpZz5tU0X3ktzF+kNz0/gV1x4uxSNStIkeqZqfH44097J7THxYnx3uK5xPL6/HO1ut22Oie37nzDtMtuwP9o33yT7T7lDyAKbs3CCVAPmaR/wJsI9QTC+QRgXezxrTNClcvWnM3UGwFBQgVRArCvmLqaIZF0akc2lHdMXrOyk0LRCTQJJSG7FAnvdrl6vlVzZt7Nh31T4/EuwPB7qWapoDkmW8sHNhXPe7t78C/b9k1NH2w/Y47Dpxa73EX5XWVBayV0wNVDfLY7I4n6hrja7cy/xEoCGTyIAtIdT/qjXdJYK9YwX6iN5fQ62eYN7mseZMFKW8SWMDjyc31+D2+kqLc/Ny8Un+QepPq+iuRACksORWTSmEDZxT/a/eH1r+wNLvpwKrWu2suirW2d/VNJVr2r8PueOvYGJHsg90VzZbPiadDlWVBeXdJrD58lsmnewHfLGIBuVXM2qexlgFO9YARVd5Ib7XqwEBnF59b78W7TfIfiGVAbmLyjn2f9Ql4mPcJKEVpzz0FMnz00+zIHe/I5aYn74iwRT0h4tTKX1yZZ/LUD5LxrPc5lpcFeMzgfHLqKsCFWK7iPO4Bu9UN87GALdoSj9myQL6x6/7Sjuc533M8L89lzaXRNCePpeWnztfS86jqybyoj7j7c+THLf3B/CKnZMYzs09JksNfbMRZfT8+derHrvbd6z4pN+Kr123a3eH6O+8PKdAalngz7w8R/9/dH0L7SnzyAvd1nHfvh9JDoRfoyuqOLTqSKgjAAtrAzk84E0aJmwZOh3qSj6XjQwEpQDtyMPHF23IEnAEsNW+bOrxvbrFpuGnd9L7Ds9sah995B3vf/Df45035V++8Q9/byM5ReVAIvRi3qO2CCrzg4NGYfzlrFySANyJsk2jpMz0koAbYCtixdsXg9CbOVLDWBmwwDS/+ldGVf/uj/9an0vuqnRgF/cWFnjy7Ldss6lAIg1p1VOC6RvWyMHWbs0ZXTEUpwbEYLmpoP1o2Fywt3d20cGlLbUln2VU7r02WTu4YGL5mhx43VAYn81x1Rf5EX3lzDi5qCk3ODzW21FfN9Wp3A7zJ9oY77qA73Kkal07lIKEvANzVIPDIiNMexW/OGF/eOmP46fa3h7fo5Vlieadzlx4/kurbwfrW4CcZr/yfc+lwuwa/W+lvugR7sxbG03OEl8ZzMs8R8sUsUU8RGtTG5GpFmXKg0BsvuuCJQ21AMu75+w4dNvBDh05+6PCVKbHFxA4dtogz7dje3edvMf1ky5RBfHEruTbt0OFzPzz19sXzcieQpGVfIf6iHGU05n22ac+dCL3QSEcDv5im3XX0vD9IVj1WTuDa1BO46Ztix8z20+ue+vaWJ7bOEMuPfgTb4K23GE3Zc5mcVXr0K3Vs5efewjJb0wueM3S+/znDmA/LM1/NMhXW1QULffmGXLwZf+3GSw91FDTaqnZsUWJI5fCyarbvy+JhuxF0F7u7GtM7UOnlp4LgVO1Wm9XtUj2UcEMMbFeBXq+hBuRJ9aQDCLJ9+mJwmi0T4d37tu3FeE20Sv4YXs4NNEzIK8Qin8bbMnjVzO82QEzM6BjP6rUzhQoFQ/ya8yjttILv/83MDPzv1VeJ5T/+Y+X1D+yrW6D11fW+t6+u+H/XVzdtDhlnIp3vORMZUM5EAub4lhn8DbmRWFZeZ32heD9Ugl5O66VD/76d0agLHlmoPp+1wKCOq1M7LJ/2fPDvie35mX/CL+KvyzH89f6/1v9IZRza/0j8X/c/0ml9i5hsgHUsBHgr68VTihrQZHzMA5YxqqwIBcEFsWQRrBOGvTDDwZxsggeMkkGg1hFtLliQELULBkFDlpUVFJQ1lNWvqi4oLYhEgpGgnx4WwU61kNQfpp1TUx1ttdvceBPSuvSOqniqrHm4PdGXV20fsa/K6xvqSjRG9gQCIUex21ns+k7QYS9xhkPFIfILufHk1ZffXlDwthnQKLzt+FU314Mf/eqG3Xs2ugtwh8fp8sgvePM27dq7jtJB7V1FMOF1ofDrt6zvG+wneh6TpJ/H3MQ5XPEHAvaAsp+UHJt6niLWEMW/nSmeWzUyPlO5KjLlnvmZt2Ry+F/+uaHa532N3ysFsraT7Z/0c5jOv+kcJksedoKlcwB2Es2UWijLyI0s/sXOHlrSzmE6/5ZzmBHZNH712DVjyqPgh8XSdpE9THZlnMN0/t3nMPcAri72/BS2Csa8d9wuRZakn8N0Zp7DtL73HCa4V2/e259zL1DhlPJYpsdo3s/Fnuc4//ylM/38ZVZWliPL7reG0s9fsqOJTtWC/9etl25tWmz8zsy+5s6WIbx9ab5tCsj7m1eiHa00LMPOJ/ngXfSs54XOXzrTTyGqBz6tfvX8JT+F2JB64Rudf/jDqWPfG+wZHuzF289+Fn+n6zev1HW1NgD5O+BdHvauHJCU55+7dJ5/7tJtcb3vuUu9+r6bgxddfOmOiyfwTZOT8sWRnp54P940u3ppDZVxxPLqL+u7Wutp3QXItgl4twsVUzs5l50LsFzo3GXGjMFOLnYX+b3KiVOcOnGaUnPa3PHO7G17929et0PUFzWsKs4ryhPN2OjoaG3pojgtLOJv3bj3WHdhk6Nm5/ofvPpKtLuVpsDYfcnTgNuFz1063/fcZaCEnbuMqodBraqWcmrnLndnb9/zww1XTk9fOWkvjxa2dOPB0bl/wKb/j7r3gI+ruBaH79xt0q7aavfuarW9r/pKK2nVtZJWvVnSqqxly71XbAzG2EAwGFNCs2kBEvJeCHkJEAjFBTsJoZNQ8k/yEkpCAuElQEgggZAH8d1vztyyd4sMed/7fb//Z3420plzp5yZOXPmzCns3+nCZ55hP3uuoKKiuVKIeUZ4/9t8blDuLLCANSO4lUDeOOAnxRDXOdPt0pLpdukV3S555WvSB0hy00AnhwKubl/nTO4HHypmov5ul9+1sur8g63njNKlLeESZmaie+mcwdhodRw5sOTAgKRvxJbciOQKA5LJBdldnul5aUl7JS6lTNC1dM9L6Bheyj4u0TE4Xu69aE/tKk9ZZKRvUvGPT1Rj3WOdAffqWrr0+ksuvtlhawrOznfHpmpw11LyENHU986ar0jIE0NT3ye/C7muaOoBsv+biK69lCqmbGfzhWTO4gvJSHwhLYv6Qtp0VlEZlO4LyYk8aYG20OvL5pfNzil6Jid7lPHphkCgoTFQXk+XXnfwkiOX78Qy0Rs79/Wu2rZh/fqNW4hPXQMe238ReZVYpamI/6MK8XZ45BFVKRXy8vMpCpy8iwogpxp56TGCJUiDW8gAoRPeytB/xa7dueLA8m1rtu1obWlohx3/k5+8Ubl2bDJBnaoMhqqIDUgVoa2LWhXRlsrBDG3I5cR7rrCAlvPuJxaQ+Ki4koQ+EWxWLcQuCW5fpUroKxfsJq0wHlFrtbpqN2fLqePzhdWB8k/M6SDNKHb8P/7DPl9z1NXVBEkdxKRi9G3Rq70Vd7B39M81mNp17kgTWl1bKSYXE97QO+Ccp98ia6SFxDW6jiqiTEDXokKSgi0HqZS0ao2cjEdB7gPEKVCMymPSlngw+3aCJxh0GDTUIhNvCGsFVvb25Zp9fR/+9bbZ2dgSzMp76ZLozgceRj+PblOzR34TjLTUY9qO4D4N4HXqpm7nY8sakFJmhOCH4KCI2RiEDEwD0rnJiIFZXBeZYXhol6zq8hR3REZ0R+RXNYctLOtiXhdbzLkkEl2sR8w+kFzToi01z5LQy9Wmavuod/k5ykgs1qXevlDW56ooDdqaO3OffkYWbWpjmHqb/eAuWOGbL7FY6/X66Ynu+ByZCw/+p4Gc14v5JDKL+iR6ifWvKumT2DnQPj7zyqpfxjcNDPwE/4FVjYpOnsTt1BOfL5DteKsqlRJl+CIySV9EvV5v0Bskvgt5RFnCNRjmqRHmG37GH/W0jHVsmJraP7L+zonR+oYXyB/c/hncg2LcAxirAf/TTc6qs/seMov5HvrFASd9D7tHp4enBmPj2+YvQFfuW/XtjS//Ef9BFY9WVz/677x9Pf5nLW4X/A5bI02836HE5ZASPA6ZpMdhqSnF2zAvpQMCAZLdWLtk0DvmGR5fsmdy8vEtaM2Wtovjj7xN/tCFbx+rrj5GdJDUEuJjyBAfQyxLmMjrNTFIVirw4UgNBPw0CBYyaheV6mDI0CN4cdZoQepGKjc8ulC+ZHBx0T6JqN94P0P0w0PNVwT272f/GYktWzpcVX7vT9lfott+OxRb8fNws8Hnd9J/Ov/8sqVL/1kXLa8L5+YGair9kfsGuh8aHL66BDwM9R59E/CQMnw3aiY85E1JHhR85tN55MxvxoObpjswTwlASEoK5dKQ11z61ErkT8xKdG4PHxlK8Bb0ce6Dzcuu26+rqbYGLIVFWl3OreuxXNuBDrUGdU1KvYmth3ZJOxCbGb1BYlYfon3k7kbh/i3H/ckl2Z63c7FU0ZBR9BOEPE9UHO6QFPgIKpX4tpb0EeSUBYI9A88fOKykj2AJviiXuEtcNouuGFIl4sZy3OAjqIeg7iQjRqpPIC2EfccnzvD4bcPjm5aMFvkW4t1dM8t0528as1n9fvxXg4ovOcL++ZIjVxVFenlvwH+s26JBeat27Fi1aueOlZSYj7eCLlzUL5BZxC+QGBRxjgLgkFB04EBsYQHtUKNnv9Lz3ns9v+uHmL34rMMyL+WAFyGTFs+dYGAKlkKp7oBMxkucW6vVezKMTAW3NAZsq7jTzcAw6MPxnkit02gzdlcFKrvtKIa61b+3TtR1Tx8a9TbmaYbP1AUrA+hZurDnMXdZbICFsZcQ+3R4ucByW0n+2XwAGakPoIkyQTo8reD/JfoAirxEovw10vH2AvfaxqHmNVPnbZ2eaxpqmp/cGscXt08+Sap//5PT/RYT3W8TikcceD/mlCOlqsRIg1tFMsODcgjCYAxysePrqFylQpm7Ucj2oKQUcqVCdAHko8JbROswM8kBAprHUMqXaOcX/BSUyvXcp4qd/+K3lf/TZv9nLcZB/1zQUO91O7E8ofMEQDe/ePoKQescyqqaphVb4qmOjxfMCIroFRlq6unp3GCK06O8l9NLZ2isiQ6V+DsWfp6/I3N2f0e/eIDiNTfcV+C5f0OMaFdvx2vt44+JevU/U3S2xN9QjZRcxkLMmfCuh4TiuGHVKjmR1sDrUK8YIYdWcdLXkVzrJGrcBlDlTldVW66f+8YPlt1jqa6apgt/vnv3z//G/v6j/fs/4niNH7dbS3J/Y2lBD0F3QVqQD3CpcYmzowqjqcipLUrgfBoH6XktSYcLfaBr198/FRsfj9100/StKx7EYw1HN6p3Rdn/5PIq5pDYjKD3wzyuICXiCTHc5YgrVYxw8nOyMa6ZkfXfXYgd+OmKryx87+OP0Ytd/8nXP4Pnr5HodRaxYWfO7tvYkNTn0o29hRN/iMX+AHooTqfL6aEWiK9VYXZfQeasvoKcvpXuIDWj68AmnOhcccWIsiSq6Bjh0YORPhuiVczZfSWZrPYGDsoO0+RZxFdSCCZMesI0hmjN4BKwH9I7jD1Oh7mcmbl9Fg1UdqPlIx3sh4Nj3rBGM4wKvQGd/m+g2qILXy+HiECJK2kfeRurBY6tQzQCC4kAkilyOJ9GLhxemk+jRWoyV+51u71lgk+jUeXnjCAlocqJH4tP8NAn3oz8iUv7OsKBiua6crm1YtuBxvW9vQ0uX3XXwA1Gi2082j32ssnk8zmsDuddm+zB+or2OkXOdRfHLuq1tes3rv9xxYivc3ZJt7/Lqx+q8VZU+3m9hpboDgLwemvCtPeU4jthwJsjA0u7s/gwWmQjHne5x0N8GA2pTox+X9qAhBQf6OuBpA/j0MbdrTtH1w+V9fb0T08P9EYDpQM+e7tH8GDsrs29Yc/4RQMd4epN69atqQ4bHEpOD4/XolVYixn+i8wX8V+c6CuYeBy9rsGzux+vx+f6+khcrUrahuvNgfc6yKqJ13g/vNgxoJenlYYKLycGMSokey5++22zz00WoQQ7ie5n0atqPjYXV0cB9C0PjI24lF8KfhtCklneJ7EYGAv3oAKcRJV0etwytWly09RD0MJA9EX1r6LoGWiE04Vs43MzaKlwpJ5kZ1BSJHiQfDcSbrh0XKHC88SRQUyBDekaQH0gTddghNABIWnShu9j1i3bk0zdcOQI+E8P43aD5L5BeGea7+Naqe8jk7RPNVJGXarvY6ZmXUsHMWeQKtcxh5Dq1wmfEPT4JrjtlDC06PjIuzKuTXFlZJIuNCbIai7xY2wQ/Ri5IN7gyIi7gd6JBdoaNbgPgfJGW4MWrplveAsmBqEbdTX0125TWnXvc+fIOvLO9B6+d1ZEAkUa4m1SWEDLBrDEzYV5TPFjxBRQcGYlKUnfiRvj16Zj1RXVPdZYzLKkDv16Zoh9AtU019VUsT+i38xl7/JXkFxR2+gIbs8INrC4PQisCuqaARg7Xl1rBH6c5MKY8F6ge5ILpzZMvBgjmO5i66EBoDs0Hqxin4DGv+avnBmCuD8afC+qIHqNMvBlNDCf58tokfoyejyeMvyfqwKUEGm+jKIzYyPnwGcIcdoIxs858FXQ7El6SYc75AjYp6rW7lV19eh1DWp1qUmdsyu+YtOEbHdTVIEow0xcxzSU2i8/B7XVWaotZoNDazJvPnTVBbp7Z6cpMgYzGUMd58/o9fzL/oyWf9mf0UL8GUOhUFOoCY//X/Fn/Hx6+KulDo1Ta5RnJY2jQOrQmH/puqx0EnMsv4VH8qToixUl74r3Sd4VEbUF363ew/uRWNlYscyYjLfC++4JyvosvntesEI2pzkzNjZwxlWCEInuGBnv6ax1Mg6j3VXbtjEWi355/ibknRx+apDcqby+x9uCmCe8+eZbwtv8NrqK6IPO6sfIfBE/xjCWWKq6e93t9+SpraE6t4W82A90/+JI8tF+y7pfsCE+B+5H5M1+UR9G5ov6MCZFMfQR3CldBnynJE/s/EUSVXMv7Q/zeWl4vvw/kf2INYZE9gvi8Xb8PBb7eQwPkxf+QiS2zjbCewnvN6T7Lq6V+i5KGC9mQYv5Lia5P3qnr7C3zzYrMn/gu0d+9XVg/8/9oB6z/7e5cdbjcWKZniqBU4/Jy033XeRPn9TxllAlxVqDIdVtEcxPZAap4+J0d9RVq1egeGwdkhVO+LYvzOxwwUyjvi4/wx5FW401vY2CuQQmiWA7SXJIHeb2xSfcWwZnU/mRCL/tHxI7L7KPOPuvZ3KTOYjzMV+CuPaRSHsxBEsn2UvBigWPZxXJkQJPApYUPziGwUe9hTGXGPGnOpdeYrlI+EgyXiY4wpHngdt3Xbh1w3k02qDo6y3vcgTGNvT1ytl3Brvo0usv/dKNV17gKJifMphbOlj7+LKcsWlRJ5YP46HlKXmSOPu0j0S+IMA5+zGA38/BP6XE3E8KPH8kZmkp3iKM4MsoG8pwY2TSxHsL5PjxcG6Mngw3RlFPKAuhwwfat/YObfSHPMONfWPjE7Ovsi+jG36neWH9qq41jVXVVW772GBfR+dnA92JpO0U5D/jbafupCQ2VWQc383MrUzgx5NwkitZsHkpxiJHe6QFHh/w2axYlcz7YpF6heh0YACjM+lMRiavOE9bWCCG50o1gyEmhyruwBANYTp75ahA0dNxhbK7o6NHKbGHiU1NTr83Pz2zNK2/RKeZfHPj3gxhHC8k50nMi/V70Y7kzox8Waez5MuKinAhrxwnrwH+4xz+33g7VbyP80gerSy+jMzn+DL+FcR2tF2NnmUPgOFBP98H8o4ObT0rmRNELcd3S9AtfnFfRuYL+zIyab6MEkXkElEXuERUSX7zUu7MGo7yuslq3Dcf7tvn+zEyWf0YdcUZfozQCz+n/AMdTIj2jfEd6XJff8NKXsQ/0tkudAX97k1OzP9Fat63s/ovMtn9F/3kMAlxbYP/omP9tUdXfnff+TetvWD/qlsu2PunP33W+sqLL77Sys1ZlOQdfB9zwNtF38Ix/Dvk3+6L9OgxO/DgGXOraJlcNoRFThpLuwqZAlzRRANeIuuLXoZOJyTd9ukhVmEO720lTbJNnrm0xhQ/Q63oBUWPLR2timrNbe6xWNlwyBXUx5xWf5lihj1UbWL85orach9qaj18sCZYV35k/5KL+y0mlKM+8/268NyWpj728UA1Utodm9at30BiW+HxRDAt3Z/vc8hIfQ51X9znkHiORTZMRWL+4OY1TW2R7gv3b9rZ2lpXUudcA95srVdc1tk711UVqq3qnhwL9+vnyx1PNHF+dSO83TZ/pp/N3zD1Ppfmb5jROZURjLZrLv3azU1tXd33P7Bp5551+GLxQjffjS3+WwVfw1GSXxLuc/g+Cf6GsDnxDRIp8CRjIUom3y6xq5Q41Hm0Zp1bmZzihhTzE7eRSfr4ja4YaZ9aq8k1V5Z7DCY9luFy6uttVl81IdChy2NLUN3B8w5ErE26yq0bX/qn/KC3ZummJmKvV4X7OEn4B/E9lIHTS4rvIZNhSZDd91AUsZL9mlwx0jF1ZGbmyLTd5q0GT0jSmRgndR3gOwF+oX9HH+JzxQoaJy7Wt4wqxFSB9zWJbYfE7gQLvkm7EytlgeffVK8//s7R4PaHmKThyfkTZbWOVn95X8VgX1vNutzHZzdu39ezs5sutTsaSwwVS3u2rzEe6TlT/+XDE/u7SV6nv9JuIpNl84FMnTL3oj6QIkncrQsNQyu/hb6l/reaQCgqn0EVjTN7mhYmka+/n30j3BRfXz3GxQz5mHZhmvioFyKFFtyoFSkVEGacEmzUPZRMibcbvEcI7nSEJikXU/41wcvhUjs/D7nyC1f8BeuE9wG12+tlPG4HbHiv2yV1wyQeNIIiUExmHcKC3IZDQ/2bJwKB3f1bLi3rdNS2nDcf3ukPeGbK9rc3bPhwpqq+pdEZmF3ia7KhgubynlGXrc5QMuGpFO5JVcSGmfhB6ooh+owixReTSfPFdMHTpvSkSbVqFu8pqdbNwjlD56VYOXOxr2cI78HtG/VZ/TDFY6bYLPphksMt2TI5auiZ+IaNU9cundaozZVlHsbE5BS9MjM3sf9NfLY9cuj8/cLOxsccnDOVWF6JEf8Qt5B5W++wM8X58OCYQ5wwsVRK9ZtTwHIBHE8+vKI4MSblHl6peRVkdiUWGi4ZZ8+bPKYQF51VanDEGI2Yum6jy2rmIoQxHuLO6S+geUtakvmuzggunR4hGiZY0KJPNssre8u8dfq5YZWxuexq9dqZvYfY74W8FdZao6HS9M7Q9jaL9RMN/VbE43/3jQTFfti6ZvOOFX4f+4nLDa4TJIY28BQ3Pm2fiqjx3V2B9xASwuUGqBy8nXMUxOlTmQsCElhZ8Q/KUiMrLuJYYzZ8fr1zn1LZmCW8q6V9SInfUWr1Ip/hXVNUWe73FrtdeqdXW+zUkEDbxKJFMIoKCS47fIxtYtriwZunvjGMtxE9NRofX5dXu3Zy87Lt8essjtgszX4gaw9569yV8apGxZPs2nCjwVzatyvUsWf1T14vXzM8r7lyn9GwdE5nQrumZ7Q1bWs9GwUZuxLLMmAr+FtJvt1C/PsZst+wQECHyXsX+KRyLqkquUxfTKf7pDLZfFLFhzWJT2p4/f0bY7HNoTlPPLKwYsYzV0le2PpbGlqWHmxqbGkHf9RP+LcVEvnZh2ilnaFltO0s/qhMNn/UAOU3k7eVrP6o4tuK5AROf2GxlOtntufBGexmyBmsk7615KnFt5ZnJUfx6+WU5H3IAz6pLqTKZT7fJzX7G5GHcnM+qZ5FfFL5kSSP62wvRdN3zszcOZ39qYhTmUC/aQoLELQO97sYS/iL+qMymf6opTpw8D6bP6qK90clfoh3b9+/68qZmdiXNOeN1Q0eGImg8emR6Ti6JtrZGW1nP65uXcnZUG/AfE9L9Aw+6mCkxFVAY+HaZJAp5bkKLPwpZfAUSvF2JR6Jeyq1W/RFZ4bBLINYWxMLk0AqGm+yTHatJQU1HilkGMbHeH2MW+/S5fCvX+DI6kqyOsGbVcrsaG15+fB42GqfrY/1q2xLatYtfa54xfiwtqi1PdBTou/0nLjAfUE8p+0zNf3WUFnldQdfkN15oWEysmFD0MN+ZnfD3TxEcoPCeQMcbyIyVqKnPyc5KJOeHNRmoyib2+Z22K0WswkEYeZzkoM6tTI9yQ3awKUG7QdPxn6fqz6/LxKzWAuQ/RV06d69VxcELX2vHDnyin5qLm9mbOlsVUj9OBtGBbnyL7EXnRyfh9wVssTf8RhWEf2JB29IaV7QApQ1LSgzXFSYL5PmBfV6vQFvwO/zuBfJCwqMJiUvqPjK7uX8MfFoGHrV1NKS5p78Fwq6jUXFWlXBc8Ex09jIUva1kEqVZyzZf1Hwo4+OHDnyaqFv/bpnf4H/fPSdXeuXNzD33QfLxMO/Vf/PdLSpuUBBR9vYVzDxPQ2oaHmxYxJeMaR+VeT9OvEo4dH8+1E+lqHzMnOBMtlygcL7kd7jFdWYDRlXf8Is0EexPyJREEKxP4Ii8913O3gZqBc4A4w/ijfjMhIH3Y+3Gaf3AumdswKQJnATI6K6pY7ydOzQ7K9nZn79Nr3pzC3JGHNi7IOlxJYqW93MInUn+R09eTj2XCz23O/hfZ5jZqReyL1ZT2Lk1Uaq4aGJ+LbI4krEh/rBwtDZfUc4UZ/4jtT3F7L/dglamrv35ThEDd40MHDmDZJ0TGyrguizM9ti/tW2KvCeu+cAmlKf9/QMLIuf9PSw+3g/lUQi8RGm1woSO6KA/P4plotWkHP8xiy5gJK5NlSUGnqXS7wNlZCfGjyLV+Neecn57aNGMFenctQ5aoyrggdolbEizBm1+v0y2dfDM7/b/tulYeM5ux54AOL1PTCAdrA3ZORnFXKswu9cjlWxD+AAa49YIPM4uAfilineKchHkbytuEWnUxeSOWV0z5mf/m77m2jiW7ipm2nb5+cu9Yq5S31i7lLVF89dCv4bRWQMF6fkKszwLfQS30IfkrSBkkEcuayFELxxVhJMcTw9blwJ5ongqSPH11+ZXLFKMLuoEs0uqqkRk8lkMVn0kIFRpTItnoFRgRmeJGTc/Oj09Oj41PQo+8kLGYkYLQMDlCDfkXVC/J3AbonIUt5h8Srso6UjhN1GstQ3ONGHt93GnnfbbegqesuZV3t7aV8fpt8mIdcF1UrqL8G/Q5xjJe93SPJqYuIhbq1pi7nZJnFqQnTH0pOPzf56O73yzF18nt7Fc1dGCS1H8e8asqZU/HqQQSA6wjuIz75XTFjuk6fMVYNThv+SdOMfs3Po4Vr2u2iile1G36dXLWEvW8JeOLF4bsyUCSK5MVX/C7kxpeNDwZQ4HODTBR5p+Kghr9U8n/fCWYMXIWi2nAq8OqhkfA0fCawBzVddu5/E1Vg+O7x21dgs2rwZImps3jzUy74SneJieOF2CoX8p3kaLBqB1z48Bg5CW3GuLZ6msOr12iIYM5aYnQ0INeD/GZnvopVsCx4FQk+zX/3D4OAgKkQFw0N/7qCy5uQUYmznUNZIKbjBgDECGJiQlnygK+ZXh5azXUFzc+9ANO13UC76FoTSZuOwBjRiTCLIsRmO1ONu56ppFRZW1+RAaH58fUBryLLmFjRk2Cw1QY5NLEZrtfoijcr8BdJsXnTBRRfE9l6870DsntGR6cnpkdEYvVp18MAlh+QTE/JDl+y/TDV+Y3zLhgUFup7dqVixfmscUVnybAr5YIzgS8vk5WIGTMHAsajjHeYYFxY59UBerw+ipZJuQOzohgaS8JZxI2rfBfG+6dmp/vi+vfEf5l6yDsnY8SkVuoddqpoaY9kzay9WP47bqsFtlZFYzsFIlVlB7D3EMBJVZJtjKYvbjHwSEYNPawBGU0yGzxA3Kn5VEwqFMIgTdF+d6Iq8fH5XV8eu0dFdHd1de1/q7JqcoHdfduO5V9q7+lyHt23/2uTk17ZvPezu67Jfee6Nl0lyij/Ox0iVKR5KjJAz7E3C1x/n80NjOPspgR8newLgFTz8ZQL/CeFdj/N58AD+ewL/FdmzAB/i4R8Q+CGy3gC+j4d/lcB/SWiE4fQYD//LWfPskXVL4Ps4uJzjpbuIfxScsbBTwfsd31BXUcn1TFH8marAq5rLHOxknsNHhFU4JEg+Ws4HBXhyZaSMvMdDmB2YKkUc5k5YxlIrMZWJE/BA2sIyEd0wcsPsDSO4yk9On7mdXvcDpEnnLz4+V1+YrA/QFA8/Cnmj8bbnNCOGJLMD7QmJ9lIOmg8djAzvu+UiAg2xV4qKisxFpX6/DkbnSe4kwg6lpvd02db10xu2En74rTGOIT59Wvv440UnbyIskf0vzA8JWyR0HUqU4+FC/GljRG8DP0/+cuzFjK+KVhkqFFxyP8F2T4gKZzByKxZFa+uM4Zad67qPnHsk/+rde1yjPfPjgxN3MEGPwWY1Vl+/b+kN8aFDu/qXdZZ6+poaRz2CnGEgsmMoEiRRzkjOvWS6Pf7pTzIfRKjzOpV46+oYQfVJTDdVv7jJXVVi1PttX54lQUJ/r9Z0q1SQ9gpy4eKJJ7Fyc4EX8h7eqwWmSw5Kjt863TqnH0QjIwqueYv9lvZ3a95Ec1rUOIyC7MvDXMxIPl+RhvJF3DkKOZKLxy7YQwpLEYzqdMUwWU6ZzK/zQ6S4EEJvb1waO1x+cumffTGkRlb2LRpdupPNo2PLOfmFBpsRcqbL8E7g/HeUlBrJMFOmZcQ7ASi1E1zWcIMgJInXknLgvfAaWaRSgcua1p36BohIENO1eEe8KsQC73Sxn/73hk9f6QRZs10MqroTdbFPsj8j44UcajGSb3IlpwPIL4aECnjjDGkRPWCOFEh/R4Px9MRawinKJdbyiom1qnh4/FFPsd4B5OcSa2nJgRTmU2sFC/TWwutnf7HyG5utLbV2k57eY7KzL7B/J6fU3R91BzURwmeuI/0EPrOK8Jmn2HvIniT9B35C4Dw/keYJozvI71twYSU5R2b5eLdczmsTl9+TkhUW4Es/RVYop/GsElX21fyFsMTj8cCUU+kpOpK5U7+Zkpdj9EvTh8fGr5igT0lycQxP3QVJU9PlM9wnB5/vtQT6xOAFoc/NkRGbELAFEfskiE7E0MWIBSiuT9z7isQ6gvfe/dKtY4envzRa5RyuX7Frw+rZofLalV30qePfOeeuqeFms/3wjbccDDW7nNz6TNLFC7EAgTIypKAKC0jECHBYhdeeNYRKynQqlZZSVKm31OOw8dTKOSu1iiX2DotQzuFyWcxOpzkbBdlXnCaz01VqcuJ+J2nnIfn4gHr4GgyvQyn9FqxqUihpwrve5DG57Vaeojlno2hKt7NSVyP2OoPKkk6nnud0mOSNeyTRn7iDyn2QRscTd0DiuCw4xxLhdJzE9QTnYRHnOPtB4hbAoY8nbuFxriU4j4g4J9g/ZeDck1bPyYQqA+c+gvOoiPNYIj8D5xDBOSHinGLPJBZ4nAUe5wqCc1LEOZ2g0nGIvCeVd55MeLLKQU8lmiQx5C/k6oRc8glpbPl5ES7ELdcnouRezcFligfpWyRwnuaUm5sXxJenz08aLpmf7LiJ6wnuwyIumScprnS+CO4jIi6Zr0Vw70mrl8zbIrj3EdxHRVwyf4vgHiK4J0RcMo9puOJ8EtyTIi6Zz0Vw/yDIq3Qrt+7Zj8maRhJa/WcazjH29xk4vQTnYRHnOHs3WYtIMoZ+gvOIiHMiC04srZ6T7MMZOPME51ER5zH2sQycX6XJ4U9y8nCGfP4UL5+fEuRzup2nw/MZY7w3DecYezIDx0xwHhZxjrMXZvTNSnAeEXFOZMEpT6vnJHtVBk4twXlUxHmMvSEDh2wysm7a+f1/PtnbSLIGOJyTIs5p9oIMnPvT7i9Psk9lvdc8xd1rqCm8BhVkP7fz+/k2js4EztMQ9jPQGfHl6fROwyX0XgTXTHAfFnEJ3aW4UvoT3EdE3BNnwS1Pq5fMwyK4tQT3URGXzMciuBTBPSHiknlJw11IwT0p4pL5WQT3ZeE+SXfy6/g3GWv052k4x9g3M3AWCM7DIs5x9vsZa2spwXlExDnBHs/A6Uir5yT71QycKMF5VMR5jP1GBo6e4JwQcU6xV2esUR3BOSninGavycD5Zdp9+0n2z1nv4U9x93D+/nwhV6fkHOPg8yKcP8cSrwv3drqXp/+7GTLC8TScY+zTGTgmXm4WcI7jOU8/281pOCey4DSm4Zxkb87AaU/DeYy9M1MeSdNHPMmSWDGJJ9PgT7GvE/gLROcHY+znx/haxhi/KugyQNonOPdmrEM9wXlExDnB7kpfG2yC4Dwq4jzGrsjAeYHgnBRxTrN9GWvjtjTdypPsA1l1Lk9xOhdeh3IhVyesDVqqW5kX4d+R82tDqqORrA3peE+k4Rxjn8nAKeX1YQLOcXZfxn6xpOGcyILTkIZzkr0pA6ctDecx9o4MHEcazin2lgza2tNwTrO3ZuDck6bDEtbYE2nwp9jX+LtlNFknOWO+wu/BqATfzdEZ8eXp9E7DJfReBLc0pT03R3cprpT+abgnzoLbkIZL5mER3LY0XDIfi+A60nDJvKThivOThkvmJxsuvIok/kY7eBuudZECe0GuglbI5PAaLkTGKIEXT2oedHFUgMSIAx1bNagnLGDSwuVHmYf8KEFpcTyiSzHMYip0KpUB7q7hkMxoILoovz89RmW4mnaj3iVF5tGQSa4z2Fz1yty6c5atWbci2NLYWDVkLPCF3HTp8NKvsH84rDfm9ivrAk03Hz500W3Rbes3ro5fMD7nweOaT1TSbvpPEOWO5AzEd1cfvruqwOpzCN9gqX7+YWaNEJHNT4K1CtdXhmHKmIDHWeHzgC6Tt7QEA4t6UfFcnJZhmSFWFu729a1TPbEtC+FljdPd3sllc43qhqbenvB55t5qdPEjnasa6v+qoT9YtaN8onE4lsN+cyQ6MdXV1dPadh07aS7hdLcVuP9VJE6X8qFiJQpWIBkmECYZ+LXRcH826uiqV4x50VLGvbdlun7B9i1axarDLb4eTX1Xa9NNyBy2tb19Dec7AjbitJl+H/O9GrAWAA1ujUUmk3HaGXoenhD90tmjqDI/xnZWeRXcpIlJLgxGEt43NbtFiE6G8vL50TljnnJHm6cyZKyu65+tbN4yMLC5ea6/vmrT1Or2kWjviLW7g37fZqsz6b1Oo7WEsfauG4ru6Yue2ze731LaUdY1yJ5YPzazemW8bShUKuS3E2xV+yNRM5LLwF61GM8osVeVD1EKJe87yPscBKWKFER53XaryZivUSkoH/KpVPoKb2qyjuRopBljQypU1dM20r1xoqps3+Dai3u6GpsvmG/c6ivvWtrR3dG4oP6wrKqqvqXZ7p8ZbenMzWur6Bkym+t9gTJvRRT3e0fCSRfTb1Feqi2isXP5OguJgRCotTXCK5YfdNlFxDV8mlekIGo8/qjX43bQuLOIBO3hqQ9aE0JqLsVtGGIzhnEze68YsHe1d0S8o0tcdXX6irrhuar+I3uLZ8tuVqO19Lc3Ht7fWdvi0zPWGl/TjKfdFHTrjMXa0sZYV/SyL8dVil4hhw5nh1cCumYtXi2MBtbMUDGiB8BWs19UVgZ5pSSnOtP55bBcGC3eKD7BTbaeOBiBYRL6KJbnD5SPGGOFeeOqQtqxMkiX3nHmuJrWt3bYICoZWl0zVaHJD+vLq5O+QO/zOc2y+wL5Revoai6pGUXpS/WlJSStWRHEh9N4c1VMMmubxBlIxjsD3X5uw/qB7XvO294blSGDrLv3GnlPNNotp99/+qE99y78+KEHnu87eO11l7L3Hjl0+VFK1HeqiX1FTaRSRezoQB8vPk4E0rSdGNPj4t5awiFIWCMsO21n7j9ny2sMun73wDR6ZoDd3V/crila0o9aYe/O4nZqiT8UeXNVg40EXkMahAaUXLzkAK+V19ng9QGpRO6K5MRR2h+iC397xFljtwXanE8jxH4WM02id35yh8um6lV63b9E1OxF7GMotnwBjyuIz4Qa+i+Y99gjFoiINKAtzNPIOf/9AFGSFlPFZElCqnkbLTQn8+uQ3jA8lj+2pl1fHWuebZxxf2viR3Th0EBet6Z53dQTbzY7ou/cy3qLaT5m+xxeZwmw75T3c/paPGDM3ik1pY9oc5QkvDY3NhPCU9jIsz6jzP3U1uZYOO761vTL6+9BjpC986M70Mv6M7yP3Bq85wJ43YTAjxT3GyL+UJXEydpqoWlwG8JztULUTPvJsEJUnZPXR2dJ6rPI1hP01L+YKnNO+Lt6O5v2ac7vHveNjER6nXgbhmqLvIG57V11g+5wd+u6dvr9VnyA1NfVNo6MNte3e0v0brwXp73tJSFPMVOcb25a1h8eLVMyHQ2h0bKzxYAOijGgqzNjQKv+X8eABtvmahLXFJ8YmAfIiogX05ACiwYKEgeNcNlAkgEYKINXqzXBcxPS6smiaCD2VkouBI+TQa8aLLbmmh9Mu6wmfUlLEH0TPcv+0O9U9hZ0tqNBtgk9i+TKiEbVz+nOF/A5mIfHDnk/WiNN4NOZQzypiAn5IqQoLMSbzVxYatDj7/K9Ssne509wTA0mGUH53zdVL++ZbYht3dTfwkS8XdHOLrr06itGDgy1faZGbx083LNly2UO16a1m9ZzfsLlZD48lDfiogk/NzB4z5MVTGI8BwUrWa+MtC3xFUlfRMLqOTpRXu5qKa8crCjt6mnp9gxOempDumDz2mWdO/vpUpO9yaCrmusMNZeZGHedr3HU06arcjElBsazZeXUBZ38Oqmh9VQRZYF1ApHVuHc2cqYHuFdTnkRardaiNTP1fljsyC9NNRKqM8LrqJ/3baFrLiyraVjfu2XvZXsu3v7Dnv7ITG00ip7NNW0ZH9/bffSi/Tco2Ip1m65rd8UnybrxJz5G/yQ2orgXeZgFGjU0li+GiA0PsMOAlGG7tF63C0xFvIIvi0tYLCSrVxj9E/PF/liVrz5Q4BoKoqYnZspqigh7bFOpu/PU/ezJ/mKwHSL+tWAbbo6UQGMB6aLQu3Ue8mQmOs1IfYjye7Z0Tq2PNdZ1zJbOoENXxPc2z8XQdvYr4aaFHZeT3JWUC6/FRnImuqnBSK5VrwKLXZoXkwtIKGk4EjGTBMeVYnIEABTNQ2+C8CpdRN5F3CYXHJZWBbcyi1SMirfyEIw88DTg457hQ+3+Yfy98R1bbKaY1dw60jvhtKumetxYPDx0mE0wP9A8rz6wa+rq7pmLwitXq5Fy686eyp6WT3LXbdi+nItFVo3vAya8LpwRW1E+SPiwZrGEPyCcHeXUSKmOvFyr4O21WmSzdNncV/9t5qnyzqayydqxyqviD/5YhUbZR5ToSwu7BsvtdZfvRn4F+x1oR4gBaKZKI0YTiYCnhIjsNDk1GKsBjGe8HTQQnDduIcMmE2HUhtB0S4exdDo/f+e5S7Zvj7UPL+lUBZdEdt/cf8nQuYfUT6pfzNk+gcbYk11dOehljs8LsUs9YKdpKoFILZDcA9YYWe7L4MwCed7n1XncYGkldWXEwrTAGBsawiKDxOuhY2y4vlOl6QzeUjdcWuQqH17iLKtw6UpH0aFbzj/Y2tzU9unXLx6/ZGJ24b6LNFdNxRdmRy6F90ciE8gC+O71M6Iv+J6WO+c4WeEjEX7bBxK47EYR/jAPJ2uZ1PMGV49TAif1vJHiO8zh3yjCH5b6WEM91P9JqYfQjdT/Vgqc3AcJ/MccPJe30wDZm8Bf4uC1En8NAv8pB3dw87KN2MGVUvmUJWLKUYHLKU3sFFZxh4WJM6v0wibnxEOGcdIa9qexgvzRQh2qee89tLpxiV/jXDZsJ7F2K+kmYo+L13AusdvLkeEjiMgkHFOhRrxuUilSYelT5CJ005uxKx3W0sLSMh86hZ5DZ7ar6Tvkqp5cMAxYQe5FwDMcEWsuTeyRZIjLIyBIVYy2FKr1cOcZ3qTJJCNa9Cem1NocLJD/bkMs543Va9x5nYWDPf7H69gZIeEIewEXVxqxJK50faQWfA4LZCTUg4yCdIMcWwwOi+JItYwPJu11k6dogyTTsBjOjuPZP5vw+z2N/uHpmys6HGWVE/XD21radw5pzNZGRrt6/YvFTKPdFL1oOrYvQu7FXHxriII5EOktwF0oBA9azkNZJueedWXcsy45N4LDSsm5kYxxiaswuL3kOdqTkt4neXNKedW9NRpwrq7ec1Aap8rrclosTpe5vTpsdR05kAxQhdQuk9nlMmM+SUto54M+E+oh8G2l5EBAvs8U9DmVkkqOkmYzRZl9Zq/TzlM05+wUlXZ7EeoW8B3PRmU0Ken7IJ8HowB6H3ErsDgtp/tlcFHYLbyWB0lI+tJCk78cLk8epXgcEEcOqaVS4aq5WHzl+du27fkqFttAfLvtxsIfqX9ScP05B24+cvGLILmBBEf2YG+iHP2V7qL8lCGi0+tobrNswmV+yk/EdwglnfVWycm2Ycyr0V8rh1tauz32gcGmHv/QhDsULAmUG7vmmtYt6wlb6dbGLld+vrWptq7Zbyh21AXqR90thkqHwVyUp9LXLe2fXc8U6XwQ4ueiRAWmBey16kgFvi9RaKggP0eGOMkfrYCFz21lsvr1lM7jdcPqL1YyEuMlLMBhkVz1aeA+V5WR0fttd8e++V7ea+i5QPU1ak27SsUezaO7/r2XxFiDuxOiP6AYSvlQgQwFQcqAUYbDCj+XUk2pUnmN6Ha/QzGkcLhn2eeNK31O5SD+eQmqK/3R6GxZQf18z9fm+h4fmcM/Lus+Osffke2JKlz3X3DdmMcx+uLCfLWSIlcy3ppYb4YjlSrmKIuPPZVbh29JboTXHgo/X6IdtWvWj96is782SyUmD9voy9kfvz/67U711V8f7P0QLQ/Xsq107sJImxD3Ax/5JGYePusURO70Oh12U4leV5yn1JDTnCwofJp7XOQ0l1ozwYoKh2V+gd/qVSodePAb6dKxaEetS2c3RkoNRfJfrdWXWltquB9ah8a8jRrNcLy4pabsdBM7ZEU7fa68SNFgT/XpEHrUxl7vc+dxduQQlyUX37kYEnmgPxI16fBiL4fr+pAS8dnjVEL2OP9wjkTf5nQaDBQFQQf8XoPDYMeV6L341m5IubULQTwbQz48b3xk42LByUmlNITQ94fr10XP2zC8t2ewb3q0qLApWqeyb1iKD4C+YLe13u2gWwfRoxcstG3tfviBS44tH6lvW2OR/71x36r8qrmI3XHm2vjAVKxQW3QVmHZQo3hMJXhMNrxn2iLNEJUKi9UQqEopx6eQksS0Iq79Kdozu93ut/tcxd46t95VpFZZKpCbKSIaMyFgT0ODJJRCSOCZYdrofrdqtGa6sry395yNO4PT9ZvOy/NfVrS/OtzXho7S7JrAWOOp7zU1f+0EvWIkuKT6hkvRSy1VDQ2IzEEV5jcV9Hv4gg62x+URv91mYIi9XUE+PoRJjhwZEY/4NapjdFrOWFzkOo1hLAvhBSLHQpmSkROJSEtX7Fm9ZMPOxlUR/C8b7+q6FBV2dXfeeJXiBfUvVVfvGj+3Q/bL3N+qrjpnfq0CHco7/tiapbNrFex+Id/1x/Q4kQ2DcALqMe8uC+hy5Uq4T0LQZeKqGuBc3cgdClMRy2wxvcdTlEPoZ0iNQRHm9nFDKORU+vyKDDGOHu+sHB2o7VBpOqoHBsts1gKmsqJWgb6xQVPIPl2Q6/D3Ttj9AQd6cf3e8y8Die6SC89fh3I7cvD99s0NLahpfQRLd5s154F0x+2/j8n+M2FeUgS8RJAIMncV+pNkD/E/rHbldRYNRLPtIit7HbnrlpG7roUqoyYieQ4jDaEkiLZt+AEjWMCKNzhy3SWLjZgJ6ri4USuS5ZBMLM9qtZZZA5XeKmCieDZVWK4Hebu+Ucjngu/DwPzplOvwpd2asRx9VW18yZZNm3cGl3cvqzE0t0+06jp9XX2R9nN8DkdBYV5Oweg0Ulx2xaHdffuG+8Yryg25dMeWrXPewOZlcwvSPB8k1h4nadAk1TJYZYrShfRWShxMQapQnEWqyCpJZEgQWXJhiDmo0E+4uETkbIa4KW9weQLx7zUkdi/Em8yFeChoqAjR5KmAktE7if6LN67Va4uJASwX9wqCYcncMr1Kppo6Z/W2cyqm9KpzJ7YqvRN0IbsfXXbmQ6RcvsDuRZfvGGCDGm5PwF6t5N9eeiIRIwTtRQolPaRS4ikHy0k4I5cLftxBLj8BcM1qBSaV0242wbOKW6vTFufiC7Tcz4jBLyVz7E/a2ikZpGq4667YxMTWjTs3Vy/vuUYf8XZHO7ujLZq2XdFe9XgULTl4mKg+DtvdoPDYskVyL/CK94JHcqis8GNPSuFWEX78TSncJsJPvJQd/2SBFG4X4Y/9QwqfF+GnPpHCl4nw0+9L4ToRfvs72ds9mgKXi/AnUuAaEX6TFA6xnnj4nSI8St7XODi8wd2chIvtuhSPvyOWZi3/UdZyr1gO83G2cpiXs9UP85NZbhPLYZ7O9j3MV2a5XSyHecssnxfLYf4yy5eJ5TCPmeXC/LgVD2A5V0pf7r7qFe+rjwSprPBjf5LCrSL8uFoKt4nwE59kxz/ZKIXbRfhjdilcJ8JvL8pez9Ei6b3aK96rH7Fnhx97VQq3ivDj/y2F20T4ibez45/0SuF2Ef5YgRQ+L8JPpcCXifDTMilcJ8JvT2Rv92gKXC7Cn0ikxoPg4Hh+0SdZ6sH7JyGWZi3/UdZyr1gO9D1bOdD5bPUDvTPLbWI50P1s3wP9M8vtYvljBdnK58XyU1nLl4nlMC+Z5QK9Yf/MptCX00t5Rb3UI0VUVvixn0jhVhF+/F0p3CbCT/wyO/5JgxRuF+GPJaTweRF+KgW+TISf/lgK14nw2z/I3u7RFLhchD+RAteI8JukcMLvOfidAKfkPP55WGIAWbeCuiKig0PcjRQqD1IqZEScGxh+wAmhIcDBGc3nyvAdGF+HSKCXOJGC8XWCRL2tVkIMHIIAL9yIWpMdKR6xWSxFRXK5pcJSEfC5HDYr+D4Z9PJCeUFAo2IqkIqTTkUdv1Q1k/YaiSLuQw3IbjeW2O0lv3c4jEb8M3tK8kZJ/9F5oO4Wu9HgsJNC7i/7x9SXy//b6aH8ovT4xiH3uf8OQ8S0AHrAsNnTEnrIogec194ipYXDcDZ6XEB8QWqpLurhiB4C8iF8oZRRzShX04LUuXI+dlADGANgOXANRZNwi7I1Bap8GYS/ApMb/3Ah0mhIrEU8+Nxc9TylVlerMYVCGd9hfPJpjlyxJvtX8Uigrs7nA3eTuq66ro62psb6kK/WF6wsl7ifeD1F8DgKz1ZJrZkxGYJaKSFmneRnRTpJ++y6QkZTVJLfoGtwMTYswWoKSwoadWHncX7BHecJzh6XEjqnIF+jNpSU+qsL8/NymRJzWdmddgMsVKPNRhaswf4NKdlFHTjwrFc4XuaQ6saT8GOvS+FWEX78UyncJsJP/CE7/kmfFG4X4Y8VSuE6EX47lb2eozycvIGSfr7G9d+XHX7sTelbgFd8CxDGmw4XxsvBrSJcGC8Ht4lwYbzp+MJ4ObhdhAvj5eDzIvxUCnyZCD8tl8J1Ivx2Knu7R1PgchH+RApcI8JvksIJ734jGZcV700OX+BVQeqciAYRLZuER9lTeRSEEQ7AvYzc0KohpZ9VYE8KvAEzyuORUuBLwZqKMp/X5ZBwJfXncOnibO+WaDwLq75Q+pa5CKu+J+OF8/+W8Sv/pfE/nIU1p4x/Eda8+PgF3txHfTWSl+TNQjy34OfwZA3KzQ1AxDWSxKg6B1OkelF2nIvZccYH8YiH48N9vV2dba1NjVm4cOH/iAsbspJw5guz4vNSCPtFWPHbGWQW3x694tujwJ/S4QJ/4uBWES7wJw5uE+ECf0rHF/gTB7eLcIE/cfB5EX4qBb5MhAv8iYPrRLjAn9LbPZoCl4vwJ0R4lLxdc3C4u96ahIv14LtNsjRr+Y+ylnvFcqDv2cqBzmerH+idWW4Ty4HuZ/se6J9ZbhfLYR4yy+fF8lNZy5eJ5TAvmeUCveFuM5dC36cSUXQ08QqBzPHfZMAwFxwm58QpYndnB9vDHHhnpBXCIwbYHnaJJibdYHsIRlh6u95WWpKnyysu4uOQ56SZYmmLQnXaIreU06Ov7N69fTv+eyX+Y/H5LBav10KfOnbvfceO3XfvsSj7O/a3yIHsv/GZodTsI6nSuNgJaogzo1JCZjli7tM8LCfmbhDBqIUoVdWUWq/VKnKMFV4SLgez2ZCWVrC7/+NO7wtD0WiU1q5oveTMEe6dCTzx3if+ysFIFeaAFA3ngMRlukuMvNLCJ9Er8WuNUD3FPaGqnCpnAxh6iPwJjayoa730fBRVs+uvOFjX3VLb5WopWxelT9XNhiN7r9s2EP3SjRtbWrqdgapQUMhT8DH6O+5HgOqMtPm8tEyuhJD+RSTQPR+td42YiblL9D7uFkItepxub6Uqx8R3S2XIiHcvsd4mAf7RyMr6saau+bZtfe3neJssE5UDE9c1q8saRwabK3o81bGd9Kma8Zq2uEYxN9K6srG6qtrpHu462NPeGm63OUNLoN9czKZTVAHYPykhcgJJ7DKggHR3JGAT2Jzz5NNCxJciZQ6frtXZoDPKQhAuji6KT7BvPt937GnVYPyee+7pQL+0saNPPMHRZpS8iT9IWWFd0kiOIGkOSSQhl8kh5jOX8gCcykmur2Yx5kE3PQIB2L3uIlWOuQI5mUbJa0A4qSpWubVO9Br7gbXZMbOheXPf7un6zunekWizudITRdvoba9o83etj25sngxFYuNjvep8NMfptcf5fWPi/MaL8LKE7N5OA946kKFABtHHkwYGXclkDHjmiL+7pxT8xvGycnt9OclllfYYoALHcf79HoK5XhKvb1ndvndb++4lwx3O2qbxOO2YrC/v2RccNdPRQfTD4Kr+oR0t9//brv9YVtZkPXpJsJK9YH7iloaqPVuBpqsSn6D/JrGhTBED974qrPNmsJijcwwVYQjUxKBbUR57Gt3Kvl9AL+/rOnMF4RddeNxGPO5Syk+FICZ/ha2Qlktt8LrEME14pOWVFQF5TkkFJVmYXNoaMbqN3CBJWUb5fH7BiBN92tbaN9aytX9gc/jq5oaOFbUNC63so+6W1lBVV2trFyqo7O/bMtTXN4ZeH3JaF9qbltaF5sK7u8yDza2Tft94S2WVWWdrrqxvbwuzr4cdprrNrT19TWT+uhPv0TT9GMVQTrCeLVETO0KVkjO4hJGuIAMCu8suegQebg1Og8NSCo+2lUqB23Hvc0pJbILGcKP4iHPjzuHbr9QfuRmVTjU2x+ta13W6h6x091BPtLOVfuyai264d40v4j98vjfYuKZnYH0De3mwcu+aySUjg4TWmDfQHrqdSKp+sAxVQg5CGe7fGpFLSzgzaAMoyuK3+ASZE39Z4OM4s4T4aTnJUzj0eTs7OnYODZF/+5Yt64O/pR6PxezxmOn26GXzyy7r7b1s2fxl0ehWjplvvctjNnu95lIuO8OmRALzhRDmC2DFTeJQwNJA9C4S9ohn15gfLIFl4eRTsnLMGrOD62Lf/vbXvC8OXYdQLzqyqu0StpjjBZjboc8wLUxgVyHh1yTgDyUjyXX/RW69sKLed8llqF7Dbrr+UFm0sXrQEy5f3023V03U1U9unxiIrtkxUFXb6qmoqq/nbOGvQR/iPgTA28br4Xl1UaGYlISzKRKYNlwiZpNODiK79mRj14txa9zPqfnqwabeCcyeLhmst/dX9o/eUK/2tgxFWsq73ZUVC810e/VwVfNEXs70aMuyhrlat2MoclFPZ7im0eKo9/t4O/6bafDHLYAYIRJ+Ddn65NMZXFuORlOZdljCtF1rxxH7Eubav1L1ry07cqQN/crKDh8/TpHcP9fg8zqEZYlIpB14NiZPCs/mApyvEnk3vnfJZnm+LaPHSd6WbGxbmr+FZ9xvsn8pbXTGN7ds6u1cWVbv6K2Jjg60WiptUbQdffDjgryda7rWN5eX1TntkyNDUU0eGv3/Ne9elrgafYRpq6RcEbAXJJHbwDdC8KaJk1NTqwMmjmR+Emfvo/8e/St7CjPzv5251UQP9v1/zcNb20Qe3tSIeXj9ikV4+KtDdgkPtww2tU4E/OPNZ+XhhzEPb6cMlAvsVkyaJA+XIz7nNsfMZxX8A7yMGif+ei6jk/PXq0pj5Q2pvLxeysu/ekh/7e3IEGtqXlrXur7DN2juHujq62ql26+5+OKvr/VFvFevzPVXhdd0RNY0sEcqg+csm+ztG0mTsyHfT0skbDQUFcoFQ17+nElaIXZLEv6UQLofImSrMoRsvVHncxdr6/0yg0S8Lv4/9rYri3/qaEkRrs+Jom9VnnkcOXZ1s7MVKeeLEe/XpkiD1cLoSZ/kkHSW0E/ao5ISOGBK7CW2ImORgRwuqkUOF9ItuHpDv/acIz1Uyk7bfH3Lan/grKLb+y6L4wOl//I4f6A0o4vz2Mj23ZfUsxfCYwxi/4s6jkrRnyF+6UP4BAlWeJERQ2mj9cy7fwazb/5uU0Qdp/uxXOOWPZwgp6fsVlTFlSU+42PoQlk93JZwmYfgfIf6Go/zUeJTeg2PU8XjWAjOvSLOLzHOl+hjuOyRRDuP08rjnOZxWNxWnK8nzOMECM59FH9XTpwBa15Sz6OJzTxOHY/Dv/0m/ozb2srX4+dxNATnfuq7PM5PMc4VfH+Etsp4nOd5nN9jnN18WxM8DsPjPEoJMQA+pfdjWcgtO5YY4nHcPM4PePqqMc4o35+eFBp+l7qSx1FinEmCczyxhcfx8zjXSui8No3OJQTnQeorPM5fMc4Gvs8reBwbj3OnMKcYZznf1pqUcT1IHUnDcclO3piJQVM3JD5FT6N+vLUM1MzwA+olcxEdxfMNCf8zDz+Ql62ohcTly/JBPP6ox+NxAs/0SLR8yeikDejpicHByYmhwYmRgM9XVuYbW7pyZf/AwsJAE6SMb9pKzuxn8D83oC4xjitkzRySyDkco/cS2cmNhla6b2ju/0t97TT7A05mwvREp/H4jMDj8ZWSolXcHTdTZPL4tTquv0pVKCkpCTnF0UOO/u6Hctn3Fgaddks4ELKNlHf0nw7WONsbmoM+g9EU9Ls8Lfyd9gim65O4XTd1bUTnRHKFA+GzH/MTiAZGw8MPkNqSRWJCaTRfHIcQ/6xVQDJ1WBiUy+X0eMo5mUsUuYR06qJ7MxzT5Ha8s8/hryybHKgYt1ZXRnw+j6da5Y50NNYFItOoP1hmcahULnd12GLzB0oMJkNFWaWvjMiHeJGhp9AwdyeWkxxOkGZ4gAvmT3EpnIjXZAtxTtJz4pUTROCwUUWEK8aNrh186HD77lXKnnC4KfiW6QczM60cXW/HdD2N14OJui1SoEe0UsgdKeNJ6gIXQIVsIxiKKyG0sZCuIYOwbsDE63bnYqiEvp+LxZFZ7dJqi11uJwhtHuGGzYk9WLZXuRluDZ2e6Jprqg4093cUeAvDf1Pd7XY3dDW0hgPe5vpc1QOtnYXhOrIvj/LrB871L0eKGbzyDQieQhXIhFeTuID40NC4N3gd4FLQkwjXf2EBLYrTQhPf/rNUAQvIaARRwY+3s4MsIF6qk+rssbCnVKqSloUbqqqraVO9u64v1j4yNbuks9a9tsqk8XlcPqcF5QXrGKa+tiGyMNS/YAnO6QwOr90E1vuIuivxD3Sc7Hcs33F3c2U2+Y67pIfdkMLwxTueRyXfMPylrZb9I8gZ12LaPc/TrppaFcn1mvIROdP/dxlceXm5jzAMleT+GM6ahtwA5qyCPHiir7JiZnBoqsxvt4+3R0Z/6qmxmtwup/vW+iarrTzgrz6myvfbqsKNlRZ/bq7L7g0G3TpdTm5xYYGuuOAivTrHXKQzlBTjdXIk8Rl6Bo+1mLJwWaY5w0t6qFhLE7KRfnOBU2flSQlQp9NZdGbIRY5Fdw9/fRdfEDATCPOsOoS081pHtb1hYC4yNLnvoO7OMlQecJf3d5ZVaIvqa0Ptg5H5pQVN5xm9fktJDZyBN6Ct6Gn6BG7sP/Bk7aJyH6To42gXiURBeDraiW6QxObmeDo3t1SzwNNRCk+nVzTUcUwd83T8/Wl8NhqplRGNhKdzs1vMZ0gkWkw8YV3iRkgvaRa899LQ4ezizwLqi58FnX10JT4M2uqba8lh4HN7WoPcWYA2oydxfz3UIxGdC+9eZ7azwMoli18hVXTyfYqKQ8hAak5Dsn9+TRFzyvVciicn+bUKOJ9WfGR4sx8Zn3tmGJus4qHRFMSHBn1Memj49HoTPjXK8alRXs+tiRvxnD6F5S9yN5ecG3gpU7LpjNNDBixAODzQ4ocH2omPj9Lvw/GBzw48D6fxuiultkQKmCxnh1M4O0QWz9GHD+TerACrFPE8WBSJPw3c3GlASfStWY6DeLi6POz2COeBy9PQhe5uDfu9Nkt9bs6DrZGicB3eU0e5NYRAjqRw49ye2inuqbvQRnSc7ClrpFTCN9P1mjopy0SXf9BWx74De/ZaXP/zpP4HhfplYv24/Ajagp4h5d/LbB/2fKIZPU0d4vZ8opMrT3SK5e8kOtFD1CW4/NuUiytH0vKv4PLT5PvvCN+nlB/B9T9Jyu/NWn4j/v4p6ioE94ds5bfj70+T9u/PWn5UrP+7Wft/VyKMjpPvH8j6/bX4++fJ9w8K5bLU/regZ0j597LWfwPCAjF9Kc8zW3n6tibph1rRQ/R+jn5cOZKWfwWXnybff0f4PqX8CK7/SVJ+b9byG/H3T9GHOPplKb8df3+atH9/1vKjYv3fzdr/u1AIr8/9HP2yfH8t/v558v2DQrkstf+NeP1dyq+/tPrx+l+JafsPGl/HwUcrT6POzQGnbbxV88gmaKNGrAjf0xFmE5AMzA+Jwfwh1H+r6avbo7MT/Zu/ZrqlIIY2dy7x7K2/5rrgxZ4lnXfjehsSt9FuWRm5e9MUvnvrkAqdj+6NsjOysn9ea5Pt5Nr/GXUGHUT34XtUSQTfsDCzIrGS5+FsGfc4YesVS2Smn4W8vro6nzeELqyr8/pCIXjn+x71OvomegnXYYuYJXUQ94BxEjlb7ZHhUTRK3vr/0dfb0NDb2/B6X309/l99L/c281riY7QfJUgsiTbuWGAEibVNPA66ZUS64QOLS6DJ25u010WSn1+rxry82u2qFv6PXq6pcbqCQRd7PFhDYECXFxKj6AB1N5UPMRRUvL6OaIVpJEpzuAP5VB4DQ/MQzxo3L0WhsRrdxEhNQXG16+4ap7f8xFMaj85Vg2cDYhY3UfvJ+NwgR5CMTWheAS+i3fgyB3+ccDpIRdXFfnb4LVa/32rxPxuwWPx+iyXwnACZ9gs/wf+5Yvgd0/iPmMbbSTzyQhidyGuHRQdHLEHL5WD1gq+e5FXWLQvR0reGJcPqBa3PR2p/C7145nlcuQ+376dI/a1oO/obHmMhNciZ5ehBqcfZmPDZMTrgRDdJwHgSp/lCGT1KTvPCgvw8sngUacoznVuH9wAMGP+tXZU3gP6GR+jz4RGeGUDP4T40kDgtD1Jmyg4Z8YoKlTIKaAypb8CipXm4IJ9WqXLieWo6J6eNhEHA1wqLxWK32IWcWYxeV8znHNIWaXOsFV58TEPyYy4BMvkbUoW4LMgqDEb3Tcwz/YYbjP2G8Vn7RNzYb7wR/10SX2c/Yn038m38J/Kb7nvwn+7f/OY3ZP/huTiI15mG0kWK+J1H1gHZeo3Ztt6uEPwU8pL9shR//yF9irJR5aBHtZhp7lkQYflAvpP4G4OSsosEQRN2id1OUfZye5nXjb+zlltUOQbxrQWiOriJk12j5N05xVN6/dJak9duc5XELAFHwNtd7x22tcYOqPj1QJ+q7A/4Gt0GxhF0ufxlbT6TvcpVHvR6q9ac+YG4UGhqU6IS9xbWSRnVGAmVmmhajiBHImQH3gmCEzGhhe29DHe8A7xuywJWs5HhIsikLwrovjIz5niY5AFBK/nlUm0pc/h93fW+YWtb7KLWpUE8lorK6eQKYt8ra/eXWKv5LsNgGtwGR1MN+Et/A72BHqbfIvlz6jn+lM8lBQHDs1bi7EZCrlDTxBItLgMmOBp/FJYQ8CVdCDL3yNzf2FQ0dOumwiH6LfafSM7+E6+FT3Ddq0jdVVzNGuFyQeotIqx1mt+uUOnD+BIBshGu7pPNRaQqWBM/TozwPNREzTyiIwmfuQr1CpJjg15OVhrordvgnmgWtyE8JtGcyl3ciMUkco8pr6RYm5XuxWmsj+eurhrd5EiwUFvtQgmOwTpr2HtqXJ6Kk09rPHrMDam0c4roiI3IiI/U7/SwM4OyXY5/Xo9xFhI16AN8RmZ5924T5EMjPJgwsm/+jX0K3cgeoy8a6DkDIm5dYoj2JY7i+oXzTUJAjnxGJ+OsQx+xeVuHuDOoLlFG+4jmX0WyS3C0WSXhXMJkKqBR/Jf2sXlQA/pofPyX41DHuyBtkjeDQpKhTaA3eZ0h1bRAzK2zc7hBP7cmgcPRp/xWs99vxhwuip4n/dxEfMdPkf0DmcdT9w9pUiGYAJEd1P2/uoNC/hFr23RyB9GnAhauh+y7ZW2wg9zlNR5v1eoKwg6M9nCNm8hEAm+mZa+S33/N/gLtxpKiTPaPrDLq73H5PlL+35nleHb2JPaiJ2RRTIWWSNiD5FQOvh6V4DuSDHL+UXIScQ9PoVyGVwRNk4ddOOYQPW7SmrR27jLmMhrF+yJx1WaIF2+YcMEGYovo51b4E5fn6FF1sLYK6eXR9qW7EIO6Z2e78f92LZWhJS/kaoOh3NzaWq36hUpPT8dQvur7qvzK8mhZZZ7qh6r8oQ7c55twn98ifY5E2vGaljvw0tQiGeJfoyku4QJEUst4Z8XwMqrMjrtugmsut//IrDGg+eDGAV3mOhzmXIAb3Q1/ga72T071ka62R+V6uq4JD0ifc7ksCv38oUJdVRmtrFYrvw/97PFUvqBX1QVz1KHaotwXlvRw9D6e+DJ6SFaDdwe8ZQr55Gjcv2k+lxwtG03yO5Jy0H38s+985zNZzcA/3yc5e+7Gddwl1iFkNs/QlvHbzE1SqIXQXVDJ7n6ZbgDKDyTORd/GV20t5h15csw7Gg3Eh5gsWSM+yH5RPT9SMbejtXXHXMXofNU/brkwWt1/1bd37Pj2Vf3V0X23bODGcz+u5zVpPRQXNo57WIQYEwer5keFikbmq9FTt+yT1nThLevJOqV+ivbRb5N1rMpyV/gNLj+XlP934tMs5XsS2/E6bsH8+l3q7/wq/zufb+AmXPYWKXsvo+x44iCeDy8u+1NG2d247C5S9n5G2YHEZky/Dlz254yy+3HZa6TsL6llmF6/TtyMdqNvY86mfEgj+JkLZMfsA3lcVTWecpOp3FNT5Yqt7DEH++PNLUv7g+boyhGO5r/HdexLqUNCcsxuUEhax3sro7iOpS3NcVxHz8phni+gHLRPZuHpvYun564kvXH5uaQc6J1Z7kTtdBhdjsfIUgEqB5c+EOAKYR0y9BxafrZzQ4tZPz135ltoOZ8b0Im/CZ/9G0ir6KQNZ97lPkKUG+nx+vrcb9x08Zk/o+WD5JsDePu+9vnfHEAL7L8J7VyPv3n287+5HjWxz5JvIFQ/ps8coc+ZVPqcjXawrlA77h8uk1MZZdfjsmdJGcooE2hBy0iaAGqSCtMKWo/P/Xwq5xG1CnOJYIXXDyozo5H7H6IfeCB0+PCdDz6I/w2/3P6y48WXHNz/qCx1aHKwnI/vwmEjo/J30vBveDKEq7hiIISruAJ9RD5+6UXuf5g4p6gwuoN8j+UTuEfz7aPN999fd+gQNGl/6SVu/qW4cpBluHbCp+oAF31s5yol/dqWGELvUpfCvZ/yRJwmiF5KTELg9iyVHBmfgdxnxdginKTF/8r/dmG1zVGVo5nsLssr/FWV3V5ZDD8WzFRW2AvMJfcdz7EV2Ssq7KV+/KNVS9pHv0bvyRhMFTO0X6LmI0sRDkwEWsj7jqhxxsc4OY0yF9UCX3bwCWlI+Q3JKx24zYke3OYr1TZ7pZb0hM7BbZp9pE0b7orVQ3pCxr8VvY7bh/iHVqrt0VJu+FJ5mqSd75HI07Op8rSBp0txVroIv+7DhKnM0Ux0B3DPMGF4IhXQ71SU2wsshDRaW0WFTfgZ5vFVTJuLCW1sEbOakzfTot4y5HqWShN0DlBeMvTkeBH1K77OAqr+EeK1MiQR8UG50ZMU8WelIr4hRQfDD+u/JPNNvysMJRemFtrCa+sisrZw/7nG0us1pFwvJbVWqrhaydKxGLkB4L05Sa3F+6gL71sVVQX7ln6gSti3ybKcjLJT1Fq8J6AslytD2crUGWU/p86gy9B9mBf8jOSE/Dm+01yO7zS07Le5MMbNiQ3oz/R38OqpiVSaIeqNrBDs4JjiIhkEUeXip8I9h6Sca6ZGSgweLywYJAkVzYm50hyWaE+0odzRYO8ZGOixh+1l9b3DC6vXLAzRTE5Fk7F44/r1q/WmtsqcI0fyrtm940j+LRB3kRqkG+nVxNJzI2SFlVEmRqOS07LiAmJfaC6F/KADel0+Fi/6OY1IRkiUKOi0THDlhaeDNRBcg57ljbpoNB6P5FksYCBaU+kElYwOXi8xJwImYFSR7OqY1cBq9IcNEhPRB8O9g8F4eNbjnQsvrevrr4+H427XXPjm7u6Ojq6uDjrH6Yw3zjX2R1tnG+ccjnhjvKmvr2G+cf9INDo8HI1yNlC9iQ10qWwJ5cBjrIKcp1UBv89mNOAxqZRyGVUo2opyCeKJEgNvLRnuKiLhd/2MJGEo7qNRKwTz4WNKNui4vKFLwwuuUOvg3Ma1y6Jdm311/XNLl5dNtUZ3hMoaouuqw/RJZYW9oTH3Levq6eFteTdeJ2vwNvWrkN62PFo2VKu8+e3aMm+Q+fGZl/QbKtqMnO/cRYkm9AqfS1mPRzEU6YfshDakVBRANnWIeC3rhxiAcpparULcozmkQ6Vw6QpQj6ERhlGpGAdjN5tUepXOh6XTXFhQkHo5JONVJHwAVyHoE8MYQugV9u6rey85Nj8Q7e6osXb2drocLpffUhJAlehy9j5kZa+dnRpcVXq9ClVMTLNvNHdEWlp74nDzdOM7nhXf8bzUdGQSr28N8D8GKeQG3HM5xMjMJcZeq/CdB/daIZNDTjzNfB7SaLpEl+NuJcyil/K4nA67ttjjwpJ1sSc/xypmalPB4w7+yzlpMeTBzB0OhfFfsGP97rC7PNwajRV8XPDnVwuezRsfrBg0dU5svLh4eeEAmitcYrhigT5lMLa7YvOty9oWZi2GWfelF7Yta91zKeFJWxJV6E8kTtV8pBCc72Tk6bNYS0N8UuCEYEnEPee1DkMEKBQn+glQExrgSkQip6cUcC9+NsqqNWt1Hu7Fjw/DA0PRCuI7XB3Ixe2msMNaWVPh/ZL6fHuk1e4vZ6anYyP0+3mFHXpfYLiHnR+dD5vbdO5IE3qkZ7Bnko+jzefhNRNew2kFiwoFZb2Wz8pNXjSpZdzbe5nJBSsfQsa6G/C+hL/4FoT3K/kLNKZr7BdvO9JSMtlUOjnzDdPpfzedigwvczwcn3+5tME3XBr2oeJ3RxrnRkYbZ+9rgfCUEdyPEO6Hgcvam4uUYEquVKyRw1s0dwtTq1XzlEpFOtNCj0BAeY+T12Bq8HyHIQIPsdsmttu8ehH/yL+MvvnAA7PD+M9XL7rm2gN9Y+Ozs8OTD7acf37LSDfatXnzni3dfbPDUY4ukD9LT+iifKhUDTkA3AYjrh+TXeeWkTrDzgaIYg6h3/V3tRfGxmXjY09temjHjuGR/6e9LwFsqzoWPXPula4kS7K1XlmSbcmSLO+bLMtbbDl2vGZxghPHCVsISyCQsKcEKARogLYkLdBAyxqWAqWlUAiQAqULfbSUlsKjKW3h9UF5aV8pNND20VIi/znn3KvFdkJ4//X/95fEku5yljlzZubMnGWGZv4K1LpkaFMR7KHn+xd2j6/xZH4FvqGeRd31tf0sjimWb+OxeHvT3ZQd2XSz7RBoIGs7HBmpK2tNoCh8WoWvY3bJ2bi8DjeShZktZeoSn/sfcmc3lCcFYSBlvNDbUdoVS6Z+8hN/FFZYMhOxiHnFisZVXfTJqbqK4IKeC7oualroHhm0xhqrLu26NDmp7ZdiE94tPDZxZ7rdDcQMYyZAa4T1xglGtvzLDlSus/ApZwGe6s2bVWZ9Agyqgn6REi78D5u37NixY/VnP/vZc79z/Jfle6ZhumtV944d3au6YHXme7AAx0V9HKRyBR839bGIyiF+r8ttKof5vS4HqVwpdG5NvlBZzM3otE7lGL/XaY7KVfxe73Mqx/m93kdUrub3Oj6oXMP1vOPIbfA32Ed8pBU5fzWLbCF53NiZlWFUJZoaKYpZxJi+sI8oVdiMh4zCbcqM10aDYhRnqIhBNizj3olbS1vqa6uieuTGqIXv4s6eL2WiK3fw1Jt/8LTgDUCD3+0pUsvtXY0rK7LXrnQz3jhVcdPXUt4QyL2Bfa6SIovfVz7Ff0vLo21P4lURu0o4xatoG4uPQd6kDfB5hLAt3cL8y/JWFx56KFxs00N78p0tTgH1XKDfawupFc5kY0/5aHdlS1itdJc3edkNfL4i6HGvDHUMlQW9nobq8q4h1h/6+h7qUXwcP5e0wJu0j89LBtiKgTG3AiMCwSs4uMiGKbZvnh2KNsjL2M5hcSglO11pmj1ziHyefzAaRqrjZWzZ6fHM5+DMm6urg0H80L44n88MxjM/G7lbTCYGOR1l9wpT6UZON6eRR+Ad+CafgxU75rU52MJlIn2GiJ16crAt8+8wb2bsA2ePZD4QduyjM1fDbpIGJiDmW8N+FDXL3bRHvJ+zRishLKuQx/wcFmz8YxaTEZUEqTlba2HNvPYXR7F2DgCQ1SSMBL+C24VGyuSkxxCPxVIUMlc0wLrMbTVw4qq3e3/5izTR2s7ON0YwvYXNP4v1YJQpI/pyANuCqPK9RqIgBge8nbmtEvozT1diiTvhLLhszZcGL7t66OBryKLSzN/IFnoMZe7rKlF/25Q2x8rdJuxnZocwdbTUCGwRQCbHWRSzxOKdmxDVtIdtHQmxS/5YpgZ2NhyVpCkRdIdnQd00GIkwz7uRhkh9bbWv0hcOMrd6XqTmIpOapZR43m4tFm1D9ri1iDqyUSmnfFMOdY2NLk6OlQWH25eNjy1OjpSXDyczV49UNQWcvtogKE0BGm4JjoygDTk9vbFvoHdQ/x289NJFg9V1URgaNAzXXnqpOIdYT4uko4hfiyojoXlACXPRK3FWRCoi2dMivaB7NY5FxfkjTZ1wFOwgYvod7GkPBRsaqkOjA9HmUNAX81RULh2SjrLa+9zx+If/MTiEV0WmaFiyjI4KOGCJ9Ds+32VnNGAoLDIBS/JKWj6WzS+38HHmw4yVt8OO+c1sHiIHW6QAnuU5KP6+WN4zOirGqTFSS+20l/uZlUV+L8+qOf7npWAxp52yYKR2uKZmuHZkwSm9tLdnQ2/mJ9CK9/iUXfVu6JlD02z+DsWFEkvGkKZvg3UNmSvgUur8xa8WvD319hyaDiK1cZo2zkfSohyXIOmnoT+SuR2Od3CS/vVnPjnypTW7OUkjDOeS7fAmHE0M2r4DNDuY0cQmoZmZS9k5qBKuhrFzq2F4c0nmNThz+44RBr8W1yPIbBm/EXNYkS4oRTuARUpgUxA9+UenXVGVH6SJuXkkESGWvWgQcFcFfIDBPnwzwILGqEurq+vd5slJa7yqfqh08t6la6y2NndVkxrsV79oob/JvNKzKF4fgW2ib84FF7bjWG1ubvYcOJ+b4xz+JpOl4BpnMuuxmWdQpuGgKa+Zd83kMfg27IaMeD97rpnNIZIr4FfwG5RnSE+8/3L7S1LwqwsvbNP/4AH9KnnRRTzvaSSI8nAFcbFzjWg3GUaMBgpoTxnYsTQcp9dJYgVU4jM2fBsI2yvhIi4XCmz8MKUM+KJ5PLuQruI9nDH07HvTzeOTlwx9/8CaxvEpOPv8kRsDF4/gd+klTAeeRn0FpTP3SYnaeMjJfZB6PZSREjOdQco/V6mqLLxXXVWVoeCkV9avLbNEnfpMANqlEQjfMNK2Lt15fGdiqq1xzGf43DbXeP9AqncQwukauuu0e7ctvXBR8sSB9EmpusiGnZG+zDeWLhpdecIJvoZqpETXzB/oMP0e9qWDlKEWkCJP7KEgG/U9vCxeCjFQ5hjKUARoPijrzfywvkms1GmeSBbK+s7JI8zQxVybHHnh09Ppyvr68nKnU5brU/Xtrc3ldeW1sYizzBn0eWWHXFJjZduOIA5yPtIKTp+SQ76hjZl4Es3ed5dFBhoaBiITAxXxeEUoFgvBiuyjUJV4RG8/uDhCH1GOGawbq28YrRs8pqetpSmVSLS1ZJ48ZqBurKFhrG7gmJ7W1uZUoq2NKd4Kcc78mS7ia59e7ne9lSwgw2Rz+nQ/SvZSHzVwfwACG8WKXTI4ikoks8lgXm/jGLFyjFjAZBKOURAnvb2JRDweCLDl7t7h3qGB/sSCRE9He7w13tJQJxy0W71Wj6OYq0BOxI9zVgAbrfkGHJXztaNQ3rWcS9aqX0Z+Nzra0Tk21hkN9EUDgSjsPPi2n3oy3xkd7ezED44Nox1do2OdmWcDfbHS0ti7wTQmpU+OLegdG+tdMJZorFrdXF3V+NCLnS9m3sWno6P4VP/Ft1ONNVWN+NMcn9RkDrkEZc4fsSVV6QjSLTWszLMicfyfZr4blggjha+P5gyUBKy49tqln/vcUlgz9IUvDH1B6FhnwB3kWJQ3a+dZo6VYH0G908/1zpUisFhFXoWUGqaxVhS5isL9AXQxT2pl+SARqhjQ4su9n04X6VaUyRQsAJCPHpOf+9wE++NS81PDN900/IWD+0e5vncq3EHXCFjnkY0B1BkWoA3D97MpPMaTiBKiTyU6XC6hdTJn7/yTDNMFU0c9P7maVtLTPnzeIvXyL+E5nsVgfkw6gZhYvCo28vEZ2Vy4iS5Y7BYDFaDZLKVcrgR97LHXjrtn9NM/e0/yf7gffujLXCCZCsc8HMe5LhlmXhlwbHhtCTbTvWOfaMNJ+PUetsHKxjczKnBsv/AYm8wezc6J8vBf2lYENJU1RVr1KGxPg0vCUt/L7Pv+96E2c87rr8M19JR3et8bHQM7FI/xM1p/I7ehTlkNVO4TazmSvn5GyaNkDMcfOFL9HUdo7D6krN1v4b/v9j3WhzkeI6iXk+8dblyM8Ty///2n2Jr6o6QR7oCKI6fpWD5NL1m5sn/Vqv7v905P967R7IJvol1wlmYXzN07/Bj8Bd8ntDH2TI2OzsyzK25FOtup0dnc97ptTOU2fq/bjFRO8nvdVqNyit/rNhGVO0VsMk0Ho/IC7b3Qsajcq/WP0PlZ/7D3ui5M5fSs/IOz8i/S6he0RuUhca/pKezoOV/n03QIKo9r+YVeQNkUDN7rYzWVl/B7fWyk8lJ+r8twKi/T6hMyicoT2r2QGVRewe91vqTyJL/X+YrKK/m9TvNU5mb1zJ/w/Un0Zq4z23mMSgUt6bgI96XEgZ6U2O0OFk0WBTy7E9AJn+q8zhH2HPwlrfJWOK/rBJXP7yylLXQ1KWE+1RUsIwVskjeeMrgUtrsihSPkxTUhl/VbBrjRO2EDc+by7bDNBEVLvJnj5OdNjupY5hLBkyrx0X66ldiwLBtbH8ThNaVNkWGJtD/zbt/OSFlmJdzvdpXu7IPRzAvtN8ddY1ZX4OZ2fb6pDuFJCnhMbD2SL0CpEgsXkWhVIQWvmsE24c1sMHzL6grVZC7veCRW7TD92JA5zrukCEywrYPhZuZVxM0WDouV4SbGYk6oACmVhzpaxZGSeTbzbGJ3tWtyhafCeX1n5t9B7bw+HKOxubAovD0MBFWJSSm2B0UB2pK5XCAns4EjBy6Gg5lLOHZgt+HHDDtMC56FmyLeV8zxgyfsxfJwrD5pZ6nLDfdnVpZFdvZl3oViOnhzwGUdc8VvbocWaCGz+4rhxsVXSOOumKqwTgPlIo4auFGgBi7ugBcYbp6XYTfHTeYShptHSRu9gx6LMBkfLhJrvqybGCSSi58YEx3mggf6zq0IZ5xlkS197/+1d4vX64Z30Bo4r/c/2pLbol5XfFsSPOBJbit122zu0m3JzFsc98P0JGkd99Nfas3RZa4HWGCDLIl6AkVFQbfeGexO0Csd67jOWeH58EVP2HFdB+sbdu+VmrCvrusAlcthgjy2Wkrz+JSmPa5iq0zZPC0zaEUwM1TD0YRJxOnq+wLqHd7gfVD/9MZ7Nz5NvZkSbzDohQNQe/DgazTCTknTmVeIjV5KT9LLc1jZejpAMoyFMfUmnGTb6TypOL00sy/ziBoIqLC4IbMNLnnqKejMvPxg0Hu9Gnjw1ds3P/20gO8Oupq+o5VXYjOwNX7UnZAEgTuJT+DoqqYiDrg+cF/m5czL9wW9d9y98emnN9J3AmqmJLMPauGAGqg/+NpTT9HIfDDarRYGY7gVzTVsdtgDIKnMIEyiibiYQZh5hBXz+6fgEgR0T0C93ht8EOqhPvPy05tv3yz2g2TxqO0RKsBhHvLy8cbz6e0zPmwQdnde2/IbVdgeJr9y7cA6+fx6fhsKgc8He05eIWvy+ii/c/J6hcGbsdLVmR/kzg0wy5PtcsGn1ieFDOJpZi7PT+PIpoEtuTSkd/40tDUvzQeHSPNOLg3smT8NO3Oip6FnzZ9GPimXRqqfP40hlJfmd4dI86pIQz4oTBPLpvmAg8w1nfrZ5eg4lOpzOCTj+WlcEUdifHxcVCTe75r9fteuXfnvX5/9/vXXX897D/Wz28IoGj/ZtrDempNmS+Zq/OSn+e6cNN/N9OInLw21zcGb7eCfqE1Pw2qdD7f58LDUs9Jgm+hqDSlam2bTi94mQS+inrk0lZ+G9WEhbmLZcnJ9qMGS1bNZGpYK6g/ei+kOOrN45ukUfW5XpBMpGWtD/d8POug7H1EugzDzMtLQ7HIN+nwdFKRjbcEigeFjPnrMawvNo2sF5SGbu6Zam3O4EZDStz+IslyHqZ+1XuASE/aQVp7uFm1uvBglrsrPXESYdkCaSIKkSDfpIwNonY+TZeQoMkXWoua7npxCNpLN5ByyhVxILiGXkyvJZ8hOch25gdxEbiN3knvI/eTr5GG0Ap4gT6MV8Cz5EXmB/DP5OfkV+TX5DfkteYv8kVyc3vrOH37/u/1vvvGv//LqL1/Z9/JLP/3J88/94J+e+e63v/XkNx9/9JFvPPjAV79y75fvuuP2W2/+0o27rr/2czs+++mrtl9x2aWfvGjrJ84/9+wzN51+2oaTTzzh+GOPXrN61eSKiaWLx0aGBheme3u6OtrbWpsb62urq6KVofKg3+d1O0twPOELAD2M6ZIJdZ6P4f/S5ye2ts76y1j/j3kkrRjP/Xv9f+E1YbORGj/9z1H7n8j75O9kBiRQoAiK0R5TIQAVEEErpA6aIIHqfzf0wQAMwzgsg6NgCtbCcbAeToGNsBnOgS1wIVwCl8OV8BnYCdfBDXAT3AZ3wj1wP3wdHobH4Al4Gr4Hz8KP4AX4Z/g5Wni/hnP6H4fX4FX4BbwCP4OX8fmL+PbH8EP4AXwfnoHvwLfhKXgS9qJ9uwcegYfgQfgafBXLvA9Lvht2w+1wC9wMX4Qb4QtwPdb7ebgGPgtXw1XwKbgCtsGlaBlcBBfAJ+A8OBfOgjPhDDgdToUNcBKcCOvgeDgGjoZpWA0rYRKWwwQsQdVlFEZgEQxCP6RhAfSgDdcBSWhDg6AZGlBO1UA1xCAKYQhBGQShFHyoj7vBASVgAyvaIyYwsIUvFHgHyYfkb+Sv5C/kz+RdcoC8Tf5A/p38jvwbeZO8Tv4Ve+E18gvyCvkZeZm8SH5KfkyeJz8kPyDfJ8+Q75Bvk6fIk9h3e7EH95CHyIPka+Sr5D5yL7mb3IX9u5vcQm4mXyQ3ki+Q68nnyeew968hV5OryKfIFWQbuRSt6YvIBeQT5ARShfTSnNsV8BGfZGS+j9hH8FEfT2LuxzDPQ/ZMmfVMmecZS6dqn/xnR1LeodL9d3mmzPNcb6/hCMqbnY5Wtc79l2jJ/Z/7rzX3NtPLvlvZk8zPWv6GPzfg59mWv+EjdpWx5d6flc2Gl1/grwuf2vIT/Geftgro1rdk7uQXN7AEN7C7G8R1HjzZx9Kti8fm/M8TnXPfjo9l/xVcjsMhr/XbQ6Yf+wddHiEc+nMWYk4fJxaQfrKIjJIlZDlZSabJMWQdOYmcSs4gZ5HzUE5cjDLjUyg/rkFZ8gWUK7eghLkb5c3XUPbsQSn0FMqk76N8+jHKqp+h3HoNZdi/oTx7G2XbuvSxf3znrd//dv9v3vj1v/zqlz/f988vvfCTHz337D9977tPf+uJbz726MPf+PoD93/lni/fecdtt970pRt2XXftzh2f+fSV2y+/7JJPXrh1y/nnnL1508bTTjl5/QnHHbt2zdSqo1YsWzo+Njw0sLCvt6eqkSnuRyK55pddjvB/d0kw3zO6uvWw/1Bx/mX2JtP7j7mUbhk/3D/Dq3k3u/5Bl2g7lKPR0UWDfK+DUd9rkL/wCuddNDp60ejYRSMjF43RYPYSL5i9kstfgfaKt8Qo5oQKyxBhgROtIiBwpKDItqlEYqotsTqBF4XFT4iH7O1U2/++unxYlzp/XY55a5mv/EybXnRe2SWklJXtUPLKVmY3xMHKXrRluCi/Cbzwka2jUgH0oMVHLYTddUg8hedDEFw0L3Jmw37YsiW9BwoK/5bA/SzEvCdaRAQtQj2WbUJaVBgthrNEWC8y6HTHbGkBh2k23Tq0OvVqaHAW3J7D4iSRnI2Qb81FxrfEXrNcmWyXuuWxkM/tNLK9ZnM9dSqoU0SyZBkvqOO4ZdZrJ96wbxjEklelC2s7fqL92jf6VyKCBjbYC+sM8Dorgu6SQ9bp0chT8XrVwnYNnGrHYrF137QuS81q4Mr+N+ynDmCV+1MTRdfOU2dZ0Dt/nZxk1WQCq1Sx7tRsVK7sf92+YaC6fZl1Lk4HN9jfSK/af23RRGq+doaCAc8h2qnxeyqSVLHmQtyeqqHu9YlrrRPthbWu3zAgYPo8AlRYZwWpwzqjocO1MydjCjx7H0reNPT3NzSm042HkTsTIkVDP5FnwZIitrSluV4AJH8sgPK3enwkcDaHw2Z1Oq1HAuSE0yqSF/CCRFwkgrjzuy1i32U47AjL2U4S8Imzo1noadfBN2kw88hpvb36X/WimppF1fiHFzRY3Zv3aiL7Av8Eb4Od123lvF1iKyJ83UTfLodaihExEhZVaWVV0+D+RTWZl7EMsItHYP+EKDcrL8Culeku5vNw2JaE3g7EOW9AmEGvF/oJARtas1qZWoGQhdGhn01kXZgDUR9pJxDP+Dehj7Wih4TMy8LEylDYfGRUQ2IOKNolOm5CZJx4Jq+r+ZwmwsFlrBnLMPG1kVz99VrN8Hy2TtYSDrd5DtxJHV4d0ImsDEcYs+W3e/npfARyE6ZhoP1S1EJIVo7r6fU2JXNt0RoxkYU/S2eaDwqzRLsy72Xew3bZxXeBvBfzqAqLZ8LSSmoqrqe/5Zabb9bzZN7DO5ZvAL889CFiIEVs76PFpEgyyR4a4XsfnQ7h9zsiuRIKflwS9Ty+/rHH1id27JB37IDpzD2wGqb7M79j63zc6y4wv7xwvwY3n/tlfAH3Z34DZfg017cF7wVj4FOa9561xyDr9IgKeDipMVAbXAT2iU2bWDty9c1KzzZBinp/fDENTmSuYFoDgIy2zDGwPX+vigMZhx6TeX8CpqH9w33SVp4O2ukx+XPiEPYgV8AkmDP3TMD2CfoNvp7/94wVn23Pm5OO8J3XkxOZ9xFDVql2QqSDdpgsnLtO8vIQieYJaJ+gJ+jl8XrZHkiLrNfLy9Rqf5+VbGYgIKy1BfkQjuycP2i5eMsy79MTeNsQGg4LryMvrSdb/sFbReG8YA1feto8eHRYBBx8fUDgQk+bwwVLK2Dm6ODlChgQ3sL1qGMO3soAnRA8I2vlFay9YFkTYu0lWx/HVa6+ZH6dWr30lxPYIh77gfJ8d3E4i9gZbpNRyFEHP3zE1qxAnti7d+L2CR3gD6LZ+u5CmDkPa/Xx/9jfd2H5e+E+lkGgOUsb+wrSa/DloJvWgCNSFi4D5ijGscXO5vS1Pf0aZJKoTc68z+G7Hes0M2J0MhA/iGJJyBOPaOUUrK0w3GltEy1j6Vm/afhAOA0CH1gn1WGV9NYhmd7Ha8MWbp34sJ3VxPOS/RrMeXljvAckDjXclZmC6YnbGcT7kWsO3qr1g+AJltecxxN84V/k2otY4YzBiIKnx7omtfQmsa6U623GR7yz92s9naNdTh8mjXY9BfSr0fA+zHOwii/5CfzxfJJGHzn8Mb8hOg6RQjgWsUGcATAf2a/JDJFPplSXG5iTQSljd09hViZs2ickevAdwb9anbk+0PMyHuZ1Mj5GuXPf3gnW4R9ul547cLBKqmU6CcNLtl5ON1bMn0c3vG6+/VDQDat+L+c0Rjkchg8znOckTY7sw7ZrNGg15c6VcB4JGzR4WAkIE6PAaQGWoIsJAZiUh8dsWUZRViQLFS9L4JNBxcrhSBVAaU0UdKbBlU/TuqsjDovWogPYEjkrRxlOHERleqXXXcIRIxciRsprVB6Cbi9omIYmzmFa+2gW71k5ovc3p0jO5bo8NXPg9jHKZKjOyeCirAxOePKoH7uHkz+Xw4L+aV7fCF7Lw4Eu63mfaPIeUXGwSvBpbnzgvEDzZBffJ3oMq2yvPkZo4wR5RIPRnB0DOcI0CJGQJ8RAqPEnyBo+OH8a8/ktx233CGaTaHYs3jc7vT4ec97EMXk7x/hzYq36Ea0dWT0q2w6tFXBfthFb88ZTF9tvJ4s25FqewzdHgIbyLA501M8qxzlLluRJoaxMyY49mmzJDUCFut0sHQifztbp8nUgR9iR04GyWs1/es7ozs3V1Zu3fGJTdfWmT0wuDQaXTopvtET0x1s2V09kn+N3oQ2knz0z5GwgBiM7Z5uDc+LVVzVQMy+/mtURZ+uAQlfjOmDu/Wydjk1baDqdpgGSw+MroePrvW/p6Dqy9G3zpjfmZE9Y7FXI7w72TeakLygf5nbfXHyaC/EpiFTPuGtil45N0fn5+c3EhvmLLEouv+KJIJGG2XQwL2H/fpaTlbF/F1y0a9dH5Td4Ep6Ew5DNn2nbv0vk34Ul7d+1ixwChsI2JMViVbYVmJE3Yz+7+uj8YW1lMIe+/RoeeP4cT9EcTXFco1kXJLPeA38PbHvNe5zlZucXe9McIj9LQwiZtw4A3XTh5tgh6smy9mHgPMx7resPUX7CES7nmeezAXLy/cDenAVA8nTZfLuFa3oHNC12guTS6TJdjAGiTK5hY2JmLKA6oun1Wfmcs5t02XxAk8xbc3JcL1ezK7huJaTo3gO6JN6q6X7z2EWRHCQsx95Cqwiy42X+PqhCm2g/E8wH8nX1Q9lxPNl8+Ijx9glNFxXC9/ceEIUKWZ8d4/L3VuXszf3awDYfPhJ8bImIsRaV1AOwj4/nEp0fHwltLEroORgsWh4GzSF0qJS2teaRvdjxe/fuP3DgADmcDSEgwlRYNjM76C91+Dk9FdpqmI7ZC/P2RSFt6j2Ro819h6JNPV2ezqzjNo/W9md1hrx2Z/ej6brS/gO6XTH7PbcopvX3Odjl7Ngv9LvM+ywdU1IOZHWguXXpZTGdSsPrLDyhrvUNva4C21zTC4VOyDr0QNZ+ytpeGp5iWYsLqZAlg2w/zpIJglqRprhIEHMZefZLgb7HdT1WMaM8klfmPH2t28lzaDOrbzFd68DeAsrM56v8uQMtPUvNe11rd5ZXcv2h22WsbFGysOVysGTPFACPa5Anw/ZqkgP1tA/3abXk6DVfPmnSIzcLM83FTY5u8/XffDrRNUMx18NIhfXNx5zrKcBVDrY8Xkpo3LRXUH/txMQ8cGVpSu8NJBbeG2LGh3ys/ps1/zQLzxFPnmzk5jKTSNuFOizwTDrIaTREV8x/5peGnniiU/+jpXk3JD9vLpabApinM7O8885O+HrnvGnY8VEawiTwdVrKf4R9mZ2PmmVfGjS7mRmD/Lt9QuCV5s1PzScjJye4NcGMRm7E8jnF+eezdN5n72fPiQk5pM+JFcqi/DkQJmMElPsFgNoc5tw5tvzyRBvmyG0+x8bk9jzyI6GP0hN8jMaxf+t8NFAwRieS2XGd0YFOOxPz8Fr+OJ0dqXmzNJKej545l2W55h7N8BIk/XH4bB6aLpABWckhuAA1mpwAmI//GQ9k6Z9JZZ35PwafzcP7BTjW9IQcP7/PLFldvk5MHEp/ml9fKNCf5swTzxqLthfIjFl64hy9SFM/s/O/hWMX5I1d+nT4EepFAmY2iOXmLOYfw7Rp+4+hT+ZGqfnG5jnz5trofGR68z42Xaan1+Y288fy3PrA/jlj3+H0Zk7Fz2lzoHPG9IJ1DG1Q/zi0WMAfhx+z9aRHMGbrqwjkY/NroQ7xEesPOr6PYF1D0yJmZrJrZVT+LtZjwo9KV9MAcZI46SEjZJIcS84hVxFP2nnVZeecsHrlktH+Ba3VqstETNokjOJRlEg8ntTW8r2q6sk6nkmlsgfyFTUbGUpJptrFyXxv3tF8/dpoZE7bmHMIRdHKScWzbmxShmyQBkUvL56CNWO1QX/dtrrSstqxxn91GIIJh6eoqMRZbDNZLfCW1WSzO0ssRR5nImhwODOPqmqJQ1Udl+GnxOcrWc488BndpjOGpJJiq91gs3uKbWa1eARWFvvM1mK33W4sthaXSIv8NFA9VNfZ0OYcH3e21XfVDVV/NeQvSXmKTEVFVgcNmO3m4mL8ClCH1WI1FTkSJf6QQXU4fD4Hq9LhK8WqV5SVlCkKfu2qK68ssSo2n8NaZDcr8bhitmM5PqvJWlJZXlfLvK1wuziQ3UcwQIrT1gWd+l4Cw0dOhuV7isoPx8e9ysYTzPFV4aaH7uM7Oo7v7lrX0bGua0Eg4PHgZ4/227W0q2upUu9dssRbTwMjuT0GI23dJ3Z1n9iNf10ndh/vd7kDAbfLr//+dMmSzulpkt0XEdBitSfZ/HVLdYhvgpGbDxt/PZ9MNFddmgfFAvBP10D9gvbrsSRrapKWOmVFV9cKpRDonbPh3F3T3FzTsWRJR978WzGP/mzaU19d5WR6kJd7AuW+97gzUO5kk/sDjaOQaGcKXtbPpr5vYzAaWh5dXmrcvNmoLosuC1U1V5fjr8+AD3wT0YlwtHlkwYLm5t7eZrhLVldEJypqmqrLlkYnPMZNm4yeiejSykhTdWgiukKVN96Qbm7u62tuTiOMn0Gmfx7x6SNRhLGstCg3P6rk+bmbB58wNVa3pPv445uPP757ad1ofbMGAA3UjtT3rDQdVX3qqdUrTKt66kdqG7M1Mrz04FcQfkvKSA3WWVleZmV4QVxUpeLKLLcvKj5CHi1wWOIoqjeATK+P1Y3V14/WYd0NtTeC6jtR3qkj4dV9dL3PBzc0dNYPV1cP1yMMpTdQFG+1r+aBgvJ3CGFxYvv9zC+iNbuPjFGHmlDDqUQ2aiHSyZWrksmGqpSn5ObqTFv1zSWeVFVDMrlqLTw7taquuTNUeWV//5WVoc7mulVTk4Xl12L5bu1MqbsgtuXseoSrG76X6MR00O8u9Ta1djdE29zZWtsiDd2tTd5Stz+Y7qCB5qZog8dsWNDR2K1D0N3YscBg9jREm5pZXA2EoQphcOX2yvGthtwNvObeC37b13fC9PQJfX3JlgU+34IWpPS21Ce3nXrapRd3tI20trWJc6AbZv4MB2ggz26QJBcceOaZZ8CS+T14wSHafQamewlpn52b9tlZOi7u420ocR3uXFvZ+fVtDVFnma9SDXVGWjpG20K+ZjhQ3h6vrrJ2d3qLM5e5a4PRyqo2G1wlyvbN/Jn6aD/Sj/HhMifTCQoKVArLj1FftuC3slcwfmm22FR35ovZmxNXcf3fOPMlWC7FmW+gtJ35/DsbH58qHFkY2HC4fHz8ZOkabu/k0h6Z/zvdElrO9uDCM7D+w3NYYCxinrmbjtEnWYQdsjQ9XhWjVPaCQtsSFsmoSGOEmkExUmU9wV4kRhZsgk0xi9iKJhFbsRZNqtr22mRzIxZTXRWLxmIWPbwiZ6tUJI/OHO6coNecFlKN09pTDuTxH13iS3fH2/0gV69bOnLScbF0dSxcFjBWHDvdeWZXS/9nhy5oi9aFalxFZRH65L99c/vu5c0DwRMuPG3bthJP5pWxztFzTjn7i2ur2zo7kpmnjz152VRZGAsTe3TaZ/5Ce1k8bNJERtKLeFTRAFBodFAjZW6hTQZKjcBdTcprFZBl7hdJj4wUixJSXxttijWx4MMRRyzGPPySPJfR3gRTArPiJKWLMVdlNnBKEkaWxVsDqWhbe7izErxryk9cMnZS8/Lxvs7GVZ1yy8LQyHDtQjd9IlTXWB7saCxPVgxkDsRSXce2L1lfIhUvTdQvbsh8uXG4qmd5oPTPnD7rZuppPepFxSSULjOw4E7AoqTCOazVLGRXJ1lc5XIyJzIG4ZNGF3dhWr/kzCXLzuzoOmc5SD8skvo+fL4I/tK2pqNrbZKvJ5SRi2k3fYuP5ylyTbq4EmSlIUINciMYDZLmqTxmAYXIBkVezxRcajAy8mIePnMuprqZC+s6E/NJLCkgrZ8/x5Tmn4syx4HloRBzLxlKhdpbmphXz5KKknKfCFBfNE+A+jm7EjUveG7hLVMTq8j/W9PprZOTF/b3Xzg5tK6lZd3Q0Lrm5nVDNW3BaDxe29Za31wVTi4aXVM/Vk/fOmrH1NQ1K1bsWDW146jWRVvGxs4bHDxvbGzLohGnp6m8fzDdH2luOnG6Z2U90xcayR9pjYavehyHf7EnCgYT8/ClIp5ajCAbEHf0TCsoNjCbFLOOqSKOKQvDFHPNbFpLTCbmYVEguGm+jCZikE2GdXMLYKhOZnPgoyKB80PkzUf6dLqqoUHgvSHR0NrcGKoP1dXWVMerYnnYtx8B9tmwo0bibPIpwbwaJ9sicNa5g4PnLlrEMLio4+hk8uiOjqPb2o7uOD1asWrheFnHyrLQgj761qLzFi3SUi5q6ji+o/PYVOrYzs7jOtIry6vN559xBvjrVzXwfZOnzTwBb6MMayb9LE4Y8+LYXxdwSQZK/NyRo+ZKnRHzWuZPvZ8wP47NpIm5P46J0Ep5HCwUf01bz4WFZW5WebgcJsionlLEQq6Kw1nLotWhnpq6Nndb21FD9dHujatOGK2uSNfUdbInww3R7jMmTi4t7RiWzUbVH+iZpE8G/Z1ed1XIVx5wBgY74/3e+vTA0vZOryceUiv8juBAV1W/tyG9cCLzUqMnGCpFMUZdDd5gyM8kvg1q6QB9kPtXVoWNFUd9hvmIiojYDy7NjGYeowYWmBEJtKm/E8dQc5f9tN71cGpb3XFQ+ztvojTzKkSLw+GSf4elmW/A0o7Mb6GU4bYfHoHt9G2u+y7VgoRpxGbgxCbrxOaXmdtlzcHebDZ25nzEcuIxzkM8BYqefbyhYby2bqyxcbw21tYWYx/6dmy4pXk4Fhtpxu+elqamRGtTk4gr7sHxeZg+RTworUx7fF6b0ClVNCS5zE0I7ZvFf0AlM8xd+X3takdmonPd4Hp/S2jL0Rde43Jcfcm6dqjzLW2gT23bsD3z96ZEY+/ohadkNmyL177/Hy6fWOOemvkLvIk4KcUxAPVXf7GEdUU16ZJUmDvvbMBpj5uRitgUH4Frm7yt40OTxoXhUycXLxg+adNUsnJRV2mg27kgsGTwFKmt7qjfbNg00jl181F3DdPzxiZu7t88WBlCmRLEiln7zNybXS25LG2xAhYPZh4g2s3jvhsJMRvJ+iJQFJg2yBaJbyA1m+k0d9bKw6LH9VSozsqd4zwtlxj9hSlR9LLI5YzthWs7fynza15kQRBMEavm3zdSyZrKCY67C024ElVJRyI/wAA7A08tCy67om/RDadvkqm5b9PpclHfVlUtK/N6yy78y1/oU2dv/Jd/2XDewQEE8NrBzN30oYMPXnARrG1cunLV0iVTK5cevHiI+SilxdQujYg4b8xZMveSRs9mp3NPdTg1D2lxJPsEta+96so1T2GOt9+GTszLPHBlKIujuGj8wVrElkpYkGkRmg+HSxE8lGNILXgo3IIJjJgL3d3p06kw+ZWvTOAfNQ1n+uA7w7fk1eciV4w/GGExmHPOvgnz9a3wSkyiEuGfUQBWkfUPvm5WFt2N46FS6P7NWajrPBfilnldiAuwOeAMdBh+aXj3bvy6i9G4Y+ahmXfpPXwM8yJHRZHiWkgH6SWDZJwsJ1PkWHIiOY2cRT7Botd94pyzNp920onrj169csXSxcOLBvt7uzqS3Al3ZVD1oJ3smMdOVlDEqkk0PFGwskkUFKUpL7+VlYT4QZOV36Gx6sXxoypuEAkSXm6vethPQuRkibG0FHvNgrSpLGM7u4PrHjj55AdOOYV/l0nDsb6O6nRHdNhg+uJ0Zbilsvv1irbyoQ2ZY+TLJG+ymhqTKlwud2f6pC/2DbzZ9SXwZNxyV32LV4pJ7r6B6t4hD8RAbanrljPH9EZGi6ptI5HerncjlWsS3ZXQuyAxXRlqpW+d8vVTsn/VsHh1ifT441LJ1BLwtld5ncvTg0tcnmX+n68fGnT5fK5Fi05cfm7/qZLLA6em++5cf1TAsXBkoMcpnXYauHv7hwad/hUnXuNcuQwefxwmJp3QqMbbrb0rli60tse9PGZPNX6hKYzSAll0j9nIYxmBI+yISSjx4rT54F9BegouehraMs9D228zH7z88v2YWvddxGIgMe8ctrSl1OctsZmNVBYTdzk3UC7NqVGSbwCiq+/LfKB7hLqcuzgC48/vpV6+C732YGY/+J86WMX8HZ1Xu3w5oTMPkiC9l+7m44lpj8eR9efEvBYxZ0nM/5AhrqiKmkI7PBWn1wQC6sHTmS8ien3m0e0D2/U/uhtf/JqVTcNq4O9XLvqUePOpRVjPuVo9FqRf054Sa0E9AGFldhWZFZmvwiQ88ME8NTAPArPKZ+14M698k/BzlW1CQflvZr6aWcG9KT3wSF7xcHzmyXmAx3/mmT2kin6HXsB1yCbSR1aRk8n5ZDvZRdS0+5orL95yxinHTC1JtzdXhbwlBmKeB4ksngFKYSaGmRxOHOE9dyGVe/xxi9HTh7V7+mXWf6t5/9178HyT1WoaY18nzHO1kX2xTzv7OvjUYRNnrmff8Aj7phdgBzq4W60/qoFxLcXhvy5jX382Wb9y+IR35y7Z2uQbpJieT98hDhyHTXtUpymfrjwAnqxTsqSiJsMOupbR1g+YC65Tgt7b7vrOU0/BqdyVV8IbfABqoe4BMKqB+syzm59+ejP8gvtJ1PRZajiZ+y3UdTBq2MDvmbfIGRxbqOEMKLzfJO7RxpWZX0T4MU//EnwN8z+E76/jtuJLMxfCdnLJ3HkGhc0zuBLQfOw5/Z9ibtwhs55eOrNUKsvNvUio3nzjRf/36c9WNogY4ZleOjZzGv2JiIVtMTN/qCPzhfm2EWuMxcImultzHr4gc8NRxq6ihspIc1GXcVUPHetvt1VEoxW29n4su4UumtlCf4WyyZkuZr5RedkILYt6LikRtjR99fbOK6su/iR96PTTxTr7zExm/YwyM0RwbDTccPC+mb9o/mb/ovtwxXJXYbl/wHLDjzJX4zIRYWb2sGi6ZHHgYVbJ9MMeUQ2bKk1cHfvkxVVXdtJtdcuX123EOu6jkZky+gHWcQUpRqOC1yH1Z+v4UuaNGfvMXmL9iBjhVlLEY4TLesA2plNl3gkVJ1rLvBXqcIXXU7nxPEdQLRfl3kSbZoolBfEZTYeVXPyulXPQ7RHozoYgQyLNfLOiuDVRZimqUGlTheoNbzxf8dnUCkIRJ1tntkiDs9bQEcMqfjK3nD42dca68aV0653xB/x3RR/geE7Sq2bOpn8mkuGLB+8lAr4b6fSMg7J47+3jD5aiSmPVAYN+Fk7YmY8FES9tOm3JiwOf7xs588fKykAgHA7QF8Kl/spKf2mY1XEM0uXIbLp83P9inH6tYeWIoIEWOojtsWP/3Hzw3pnntLgOz+n+VTNL6aaZtfQBfH8L0shzGo3k3p9EkzMDzKAx3DY3P4GDO8GLBuY02zGpxbUXMROzDs0lIjlYeyAZ9hzcST8D3oEBhL0avDOXHGk+TD3F8vH2XDezFRlAMtx+8D7yD6QxlBmfRpnxE5QZlYbrHidMcmgxLO+m98M3UC+USFJYg1a9HhGE2jGnPaJr9Sa5sEl3g43en04LWaTJJonHN9cmrJgLZeHWHk0LqEZpRB9ioavx/RP0Uvhyfr8D9jt8OU8gAdlFz4dvS0XEzubCLGYuM3RaI508hoOd2DRRxGQRF0V2GiEz6ZjcVdofabR2ylX9dfT8mt6wbWVDtS3cWyPafzU9D16QPPPLIxDyCF5AgVR90UX0D1u21KxZw/N9c8YJt5AStAea0w0sRnUxSMQOVOKh6HIh7vPC+EarHA42dytXRVIJT3aJgIGbhMnaelNXY9NwojzlDpTHes5xnjUqN4WaErai5pJDwzqchdWVSrDNPVdf2bm9CkG9FUFdu1bYt9fQq+A55Oki1AYHRS8XGyRZ0qMu8o725EddXMtfExaFTkQDV61eZ0k2hrQzbyWvNe/6a6GQqlZUqI/jR8VrelWF11dR4VPLy1X26+XRg8kf6U7YIBmEPKkokCcDH1uewJAmTyRD2O8Psw+PWUw3wa2SK0dXrpSqPN74eID+aGRLo8DL1XQr4nOWfHQhFjFp/Ofj6zo+HDs9KQ1G7/I/EL8zqPPLXcgvb/5P88tdGr/8cCYA16JO6CCJRxwmSkbGHyzjYSJFnCAWoqQgTKSIHTT9SCTG+CmszbGkFH29G64dafOXBypNtd6OhWuPr2gv8/mUQWOqLjnB3CeTp+hGuEnq4LTQlK4/9BzPPN1ODnUk/Gi2GIaf0rKyUn+wrFTq6Kmr6+6uq+tpKvcHyssDfnakl1xFr4MXkWhLyTlpq9dDKZhNVOLzHV5ss1dv88A4m9Tjs9z9kj5b6iKUhXuQjsumIjx+IoutNJVlOeS4tTwZm/VkZFVKfFEtuEt+WKXW/ChRcFSFq9hTVOKzJV3JSk+5y+EsKvbZ212pML3ObiuyeH3+eGOxzWr2+AI1NbzfMpCB9fSbs+TW+mRzKX3wG8oenuZR+ifYLX16VprdP/P+k7RwWeOpPM2N9H34rnShkPfcb/v8uhbKe076zqx8Q8DfnTR0lvZXckWrm76PitaApmchbb+HtH31R8s1VLSkY08/HXWg/41y7a8I6w4Bq6a8MVg9AlaurMELQluTIlxbE3JNIvBDaSOn5dp0fF4B9jGk11eZpELJ9ZgmvXA459KMSS/xi7C+IxlRdl2MhVWkg3Pl1KGE1KJIRAipiyuF0lPJZdSf4Dbpmln0cZv/x41SuHHFiCaj3oWfSE8cQkaNrUt9OIoy6onIXf6vZWXUXVIAHmIrXB+ljzBhdBfYpAATRpQ8Sd+AL0lf5/hcJrjOkycgtIUnzneHnxz+WLKjt6+pOZ1uLi0vLy0NBkulr3fXM9lR391Y4fdXsA9r05WSBX6KfKKy+Goed052HFIAsK1EPCLVLObP533B+l7O+jUL3RXOEjfj/GTVoGQRjB+YZL8eNaDFhvw57YdtkjSrz7Ztq9lAX7mh9D4tzStwmXTdrDSXXVZzqnTKztI7uJ7XjLrfBf8NZWHm7x9bFmbOmBmc6Zn5BRoop6QtFiSyIrYwgS2xI6x8Rxg5mYWeOJpF8+ylrBWsjTz28tkFL1i7+TPEx5T+BugENqBIWECVLhnHPbkqmUyIYGLYiZl7usZrnb7icEPbk6mmpoZak7mB8dc7dBI2StWz+mFjf09UUr9nEWdDfgdvw5n0O7PSnDncH6MPPcPTSGQnPQd+IDEvNmyW66g0D7EMY2yteUREUyvOEzoQZ52hCgGE0iFP0wJt6USWxdKJXCzbq40KF3KpQ22Sgsu7u8uWaDLpDU3Dki65x/zQwxVCLmU/WMF7dCmcLMWOzH5QBF9m7QcY0u0HKVbhdUd0AwLtB61cZhvT1dLpmm18ejaGSkG98hHWq0biot50hbesNVGMMjdWrgYd522MuLmuSMnttBceRPvAimNSXbq6pFiRWNl2YCFaDlO+M79dTFz+WW/aP3cOLpHKcs17oeRZl9AH7+B1lSOZOVhdjhIDr6v4UHUhOXr1uozZxrDK/lhhtZQnWosr1FdYbeUVqs1nOm9j2KtW/JRVJ9p1339pu54f7GzOb5fv2ZLnSBaH90kVaCQ5WV1Oh2hXyaHqQmNqVruytb0jGmZWQupLrL4K1jLl/I0un1Wt8PMa2ZjVDy/h+KOSGIsYViCts8LJyJc51hMRdVKOG9CMi0XLg5rQVpRDC20lxyOIClipS6x2FOEhZ4lLE+ErKkI4nlsdrgT9vS7Mi20WLsw3OivYsG4Ll0cEjq6kC3F8OZr4STUZTPerXh3mOKDyNBduPVwmA5ytqwWqA9WRsBZL0KTMFbEs3KEQsYqGz1bOArAiK3Cd7UzgSq4SkyZxB9wOK+okoQo3fUtrQRXKXmo1Yhtqau6LVIRsrBkhRy+TUztQTv1QOv8fLKe8h5JTyyLbk4AEwSy9NzU5RX8Xvrj1hgrVGyqQU0KmPvcPh/WQMnXP9si5d2oylcHK4JMGLw7vuCEfzpCXw/oZtJleli7A8TNGWsgn5xuvQzkCMQkCEWE1RbAxRiPpqjlJ2G4Og4isaVgr4m0aWGzNqiq/n5Cqlqrm+lp/zB8NlWtDd5FyuKHbeAi9FlYdckh/fJbBLpnmDvG3zGvD76GXwu1z5m1uz5uwO7K5nSO1CeM5PaiB60HqfHpQ/OPoQcp/tU3476hLnDVHlzirf3g9vG95puQI9Q0g+6kTjqZv4/iyYI+Js8XsaZLuOdMkQniLuQY+Luk6d25w7wlZSmpbK9SQSt+uUK3lldMXOAO8O7kdeiXaoTKr81Ftyl8sX1uzM23+3PxGvnGarTMmGTX7NIvFAyuMnUV10WgjWqgre+iV3UlbKBgM2ZLdfF5PMsC3pcuOeJ2hsOx3Vhi7RNmdxskeyZBftoHUzuyU76Xvk03QDyvhbLiQBPqtcAGcCxthHSyBhYjD28kAkTFtc50z1YviWfUmGBVwrJVTle8Gwv9uVXOryXYPsQXvOFvgrsQHdsqCA2EqbvA20ngqjoSU4uSUwi/+aVPEM6N4wPaVoP2jKpg8wmL+KMwaYvWwavUthSoWzfd4e9m+adZsla19CwS0J1NxFuqe7UbEWpNi11IuDfsfEfuZFAZWsi2VUMW+pnicRxvStzlFKhGSCJ84wnsW5KiKrXPyIw8psX1KjSCg8RTfR53QeCUluAZ1A8417JgEL6cqycDyMrBYBvxGNGLDPdpmLCUeE1MDqnrRsu61mztCaxqMTdGqFg8q+Z7qQFmqq0ORWExXRQ2ajDaH0d1dUhIrcXX5istUQzRSbJHsLIhxMNJ2RTreF5XbKqlSVlxZLxtU67jsTp0nBQcvkDyjvkpzsl6qv/Q6AJcfysKKbLEZgcqSwUKpo4g6o1awUzC1WGVTR5PRuEpKd9yUNJeaZEdMoSaDu94gF3dZFQdYaqzGWDBuCPktvsWNjq1m3wkOa7nB6vK0J1aoEjhdEqhl7mDIbjC4ZLvVmJRax7+ajC6zUsVkNFFjhWIymJVEa+lkWq6nA4vrKbV7qtxWu8sMS2jXSaFSm8ERDA/1GSU3qAvL21Z3WOi2tcVeyZCQLJLR4bH5JXlZs68CTI22AMilkWIwRAKS0uQONhiNcBKqOFGvM1lNQ72NvQ3lxfZok8NspZLLb7W5PGVuc0yxGp2VBqU7KUtSSaUiGYutNuqKNTQ76hWL1yiXVampGmOQKmaPpchrctbY2pSeRI8pvYB2maILbVbZ5VA6j42Z1kgGz6LqoFc2qS7JXgolYDf6E07Z1+REmeMtZpHPZWuFRzK4DFVNbdRSXSJbfbJUbClud0jWMrfqp+CyQGm0xFAiVbW4pWCLEcpkW1SCEsliMtidZXFJtqsOKlPF4myKRBpSIWO5VfEYeyRP72ab2QqSv7ikzCW5ow7FYjJajRavw1zWDklD1B8okqnH71VNAa9kM6iVpjKPF1ikw+K2Prc0JYPiV8Ieq93qL5U9srzMK0sOGUwUTZYib4kMRrlFoooBJJfB4QS3xHYNk7/PPCpfiDL7JbIfJLAStd8CCsjkP8gfyBvkFXIrDjgyShEiBhGV8QVjlwineQVVP+QcsZNcMHgK2VhlTMg4nrEOe60ptHxbYjyunVZS4jone9WU4GSvEExGo4hLzL7jLIHqwaKYBFAVt8IOOWUTsSsPY7u4Eu+lKf1wFGP5trjYBZlKsZ02CYSUDxaYhvOx2ysg76OMfxEmcQQqnmxPITQIpIc30MNEQUzhEexTcejtWN1WvlBF9Bn7hsJBh8FWGjqpiy4Bs8tudVd57JTWLx6g9XJ6srQ1oZgNJqXCSJFZFGpdFk1+dbxVShqtdtllMNhDQXeZCpLPBpK6ItHucVkN5VbHCT7zVkfjYp/FHzLEgzGjtcYCDsXaVSwb6t0GE1ViDtlUak7e1JGWVhmN3Y1G2dpiAmoHa9RJixyUWlCFRP63mWQlXAb+CnqW3+ZxGJHhEgak47Wl8mhD0N2kSIGIAYojpTIEbI0mqPA1242gOL1Rl8NqqKZL+9qKTXKJC7yeMlOlarBJ3oBJ9fo9VC4K+KOGJLSXmR1eC1KpyaI4om7JVVZS7EcqMts293qkHqNHsZYbQ6mGSKTJaVGQ6j3eIlmKlzntBpNFKgEpapPLwNgSlNwtVRJyTbQULC6gftVdZpUc7chZkuyzyiXVFtrWVIV8JwUCFpmi9EER4rU6m3yyM+E32pFXS+0S9pXsDVYv8hgksyR55FI/MoMnjGwB8pQ8bVCo1CKjRlriLQK5EjVV2SHJXquUBDQbTYwfzPRP5JfyKXSUmNBO9pEKEif1JEnSOHirafdwf2+qtaG+riocLFVdxWajzPayMCKviuMIi6NnezKJFJxiA0e8Hb+Q3LwpTqtx9pXS6TYpqI3xRDIlmCMuFZlpMXUVRWSjBZWwcqNSLJVDwg4+gIhchGOGBP3UYYK6YgvYzZTWyCiPZKdB6pSwJRIdtCqSbHVJtdRgN1qKX1NMsteObK/KPhTfFMd0yWeRPTRkQXXEpVg8sg1NDdlFrRaQqUGVq5i+ZM+8PbNT2pivX8AVcA1cDzfBnXAvPARPwjOkr7+cx0p5HB6GB+F+fH4X7Iab4UtwA3wedsBnYDtsg4vhfDhnjlZiR3lC/79W8r9GK4lGvCqvzhtHkzx7siCeqqApdnzR4zV62AVvSVxI2bjesAiHWmw293LwI+p3/r9281+g3QQaUbuJu5DhzcZ4kc1ilO1U13V85VKxYqxDvrcrUclmNBXJVSYH9VdTarYDysQayeBEzqdyk0OWSqT/Ot2o2v7/um50hssqS4qVllqMdgOlTUJVehEbrthkH4pSY5NkV4xUlmPUIxvsHouColXyW6kL7XBZCqsGinL0fwAIX/mzAAABAAAAAzS8G5tH818PPPUAAwPoAAAAANIUYeoAAAAA0hY+1f2P/gwEqAQaAAAABwACAAAAAAAAeNpjYGRgYF7+7zsDA1PE3/7fESwrGIAiyID1LACmdgdZAAAAeNq9mFtsVUUUhncLNGrFS0GFAoVasVDkWkAEbOVi5bQixkO1tAI1FCpFojHHBx/gUUAj4I0gJIQYiJgoUSP1hk9qjFESFSLE24MxeEnEBI1GkDP+c/Y3Zbqzd3uaiif5MrP3rLmsmbXWrH0Km4LmQL/Cpi6G5of5IyRoFbUJpJF35cY8eVxMjMGOU0jZLoopeyMFa2GzuIXSMU6UMXYck/PHGJUZsY51r4kwIYFxMSzqA8PFoBhGi2tiiPav9XSdwLtb88OcCQnaREsCC8UCUSnqxJI8WSHmx2DnGkL5aC9MiTy3enSAHWduAtW0Wwq8uiOVPyYb6bc2Qn0CrQn709YHrC4lMcwSNTFEbbfFW3c976xvX0bdrvGAmCE9f1c5QOUBZFbT7vtdEPH9S0VFjP+thMs9P51MmcF2rb+UwmDsvhqZSZDGngLabTwZj73PFlXd44Y5yzzl1K8UlzCX1WmsuJ49vIt5rfxIuBhbbfR0c7qMJYbZNY2grPB0cX7q9Kj29qMA2hk3jS+k8dtqnod6sdfFUbeOuoT4VuXtYyljbWYdtZyBrU9Fv+HYwyDeTURmDuVAcaO4iDYrt0z7+Tfjl3GGNpY0iIfEHo/SiL1bfWZG7Hq558dV4Oy0zYtL8zzbHoXdN2ITU6GN/SpHbgB7Wu/FMj+ODGGcGdRLsaXbxXViuriaPb8Te7PrugkC5rf+MwzdnC6V7NvdyIykj9NlNsxi7xo9PyuGuezZOm9f1iA73YvjS7w45fa4JiHGtUTiRCNnVcNZTGJNC7GRYvZjEDaQYl/TrMn61Q2iiLaS0LbNX+hch63LFs2f4b6aTsZfdj5/yeUlZzwdXLxxPrDIs/d24u0wL6YsjsSVlOeLxdi983GbB30v3hKfihPiMXGcsW2fh7EBN2c967gNv2kL44fZRhyZzDnVsqYx1Md4udd2sVW8KF5hzk2sKylfS+hjfhRfCnuHa01mqWhBF6vbYfGyUHwy8hejszLyERPAwVB/q1+vsp+JY0J2bJqFbMXo/Ixd35Bw3+w+uvhrvmFvhzOm7NHcjA4fiCNiT9g/q5wra5+fD3VzsTM3xttCPmlkR8beS/IHo/00oxnrffK2XmRz8ayFu2IhZ/qg5xP2nO4h12jizFbRVuT5eAq/tnpei5+NJ274+XM0hy1lDWme1xNvVkbyrBT+vJH1jMYvl2DfE/HJGtbUgp+4u30oMnP+B9K9kLqA1PaT3sZfAe39pPQC8iE0YEdzuBMWYSvWZu7jrplP21piuduHRuTu9eQaQtnsSZVXhLlTLjYfD/Nfc06cEp+LH0Lfy+VVRcidpo/NuZ4SH4ld4hnxtNgtnhV7xVbe90Xu5/9QrpW7/6h4XXwtjuD/P4Frb2b/9gl7t31Cm7WTafALMvb9t0L7EzwinhM21u4XG8RB2r7rod31d3Ll3JXl5CNWbrv3zj1XkM9aDsN6eEB8JU5AVO4YdP2vEPmPwT13EP9crKrw7j77fb6U+7IyQTZObiXx+Wh4f+fsz/bthA5icwf552L4hzFoy939TZRvwgbalhF3S2jv9MoR5JWZMA/LzdFJ/85I3a01k7Aufy2ZHubPePOu5rurkjuwMua5k3dBeM/7pav7z/2hQDld4eDz9SSZrudpXr2sZ3L9yvqO69et/wL82T2rXjAwxMUhH/99kkzwRnw/+97Rk6zf5tbSrU9Ut60RHfpBdP6edEmSi/ZJks93H7pkZp3HjRs9j+hc+ZKkqzuDuHXm5loQY7NP8O1VB9a27yeG6pujoCgkl4vNJBaM4tupg3ze3qdXkceNJEY1h5jX+DaxPvuqyFAeCnP33BjzIrnhF5YgyK4SNWIqdVu+JHaJ3TzPEDvFcp7vEKuD4Nw2leN4t4v/a/cz9rtih9gi3qF8UvzG3bQF2Y/Fe3ybZYmHO2P6nfL67eN+sd869hvruOafItYjZ+9Z+x112sPe0y9Q7mWcTfjJNs7oEOvezH1vxznJenboqqoSZ7XLipnZX/8F2agMvAAAAHjaZcJ/UNKHAgBwUkRmiMw5Y4TOKTojIueYOaZkRmZEzpk5JeacI2WE+NWZU3L8Gioxpsz0GxkSQyMHhNyuV4aoiIjMMccYGhlzbM/ndZ7neZ7neV7nvX/ef+8+HwgEUvI/UogSooYMQx5C7BDPAeIB8oGCA4oDqgOhsOQwYhg5zBrmCvOFh4UXhpeGM8Pl4WC4Ltwcbg13hfvCl8PXoCVQPtQF9UGXoWvQnYikiOoIXgQYMR+xFLEasRWxD4uCxcOSYRJYF8wO88B2I6GRyZHESHJkQWR5pDzSEbkRuQeHwWPh5XAWXA0fhj+E2+EeeAC+At98pfSVqle4UegoelRH1PxBxEH0QdzBjIOSg10H+xF4RBYiH1GN6EVoEeuI3ei06MxoSjQtuiy6OpoXzY8ORK9EbyJRyDwkHVmOZCEBpBbpRHqRQeQL5HYMLiYjJiemMKY0piqGG9MSI40JxazH7KKgKBQKi0pHqVHDqIevNr4qePVFbHosOZYea4i1xc6/RnxN8ZomDhnHiKuJa4wTxMnjwDhdnDnO+jrl9a740viqeO4hxqGaQ/2HdtAwNBMtQivQKvQQ2oK2od1vFLxR8saLN7Yx+ZgaTCOmH6PHeA5HHcYeJhzOPkw7DB7exmZjqdh57BJ2NSE7gZogSlAkqBKGEiwJtgR3gj8xM5GSSEt0vpn2ZuOb3qTiJGYSO6kpyZnkTQq+xXmr+S1JMjq5LFmbbEkhppBTBCnyFDBFl2JOsaa4Unw4Ei4PR8dxcVqcCTeKc+K8uJep+NSs1PzUolRGqjwVTNWlmlPtqZ7UQOpK6mZaSdrK29y3Pen49K703SOkIy1HREcmjriOrBzZxGPwLHwPXoM34DeO0o+2HJUeVR5dJyQS8AQGoZrAIegIToKH4CcEjyGOoY/VHOMd0x/zHdslEojlxC6i+zjseOlx1XHt8Y0MckZ+RlFGWUZPxv47Oe9I3vFnJmbqM4Pvpr9b8+4jEoaUTMKTeCQRae89/HuS93xZxVnyLPcJ6AnyCeCE88RWNivbnr2evf0+7n3m+5r398gkciPZ90HNB7wP+B+4c2A5BTn8HFsuNBeVi81Nz23MFeTKc8Hcf3I3cvcoMEoxhUlhU5ooIoqCoqI4KPMnE09yTw6dDOZl58nzPKfiTzFOVZ9Sn9rLz8kX5XtOJ55OO008zT3toeKpTVQn1XMm7YzgjOaM4cxqAbGAX9BR0FMwf7bprPrs8NmHhWmFJYWVhV2Fc4Wb5wjn6OdKzzHPtZ0znHtEI9KyaBwaSLPRNs+jzxedl5530FH0EjqDPkzfpr+8AL+AuoC+ILgwUZRchC/iFm1+iPuw5kPdhy+KqcX04tJiWXHvR7CPSB9JP/KUuC9CLuZcbLk4fHGpFFbKLHVdSrpEv8S7pLm0VIYpqypTlQU+Jn88//Hix/+UE8rZ5fryQAWmorqCV8Gv6KhYrPinYqNij1HAKGFUMjiMRwwHY56xxFhlbDH2L6dfJl2WXPYww5hRzEam45OwT0o/AT9ZqUyqtH8K+ZTyqb2KXQVUtVQ9/Cz+s8bPrNXZ1f3V+5+TPxd8bvo8wEKyqCw6q5TFZHWxQJaG5WBtsnavJF9hX1FeUV0ZvWK/4r6yW5NRk13DrdHU6GvmajG1ybXltbpac6211lXrq12uXavdYYexkexMdhWbzbayd74gfFHyheSLOU4iB8/J4lA4BRwZR8nxXSVelV9VXzVftV/1XV25usOFczHcNG4ml8Klccu4XK6Eq+KauU7uEnezDlaHrsPX5dQV1VXVNdYJ6uR16jpznb3OV7dSt8OD8zC8NF4mj8Ir5XF4Ih7IM/EcvABvox5SH1uPq8+qL6xn1HPrBfXyerBeV2+ut9f76lfqdwA4gAHSgEyACpQBbIAPKAAVMARYABswD4SArQZoQ3xDegO5gd5Q3sBqABo6GtQNPzW4G5YbthujGpMaFY3rX8Z92fylr4nQBDRNNG1dw1+rusa+pri21UxsBpqtX8G+on3V8dWjltiWghZRi7vF3xJqWW/ZbYW2olqxremtpNa8VnprU6u21c9H8xv53uvI62XXldcnru+0FbRZvoZ/Xfr1o69XBUWCLgEo0Aj0gmUhSZgnpAvLhSwhIGwTyoS9Qq3QJBwVOoVeYVC4LnwpQoiwIoIoR0QXMUVcUZtIIVKJhkQWkU3kFvlFIdG6aFcMFaPEWHG6mCTOE9PF5WKWGBC3iRVitdgktok94qB4XfxSgpBgJQRJtoQqKZYwJWxJk0QkUUhUkiGJRWKTuL8p/iYg7ZFqpAbpI6lDOi9dkq5Kt6T77VHt8e3J7cR2cntBe0l7ZTunvbld0t7V3t+u70jr0HcyOms6GzsFnfJOsFPXae60dro6fZ3LnWude7IoGUaGl5FlNBlDxpHxZXJZv2xIZpbt38Df4N2Yu/FSTpPr5a5v8d+2fbuoCFNQFTrF4nfp30m/G+5CdFV3mbr2u2O7k7ozu6ndZd3sbn63olvTbel2dPu7V7t3lVFKrJKgbFOqlYHvS7+Xfr/b09QD3kTcLLtZc7Pj5nIv0Kvrg/Sh+jL68vqK+6r6gD5Rn7JP22fps/d5+0J9myAERIFJYAaYBxaDVSAAikAlaAO94NYt9C3mLdmtuVt7qhyVUmW5jbzNvg3etvaj+pP78/oZ/W395jtRd2LvJN/JvKO4s6ZGqInqEnWzukMNqofUP6nt6nl1UL02gBggDlAGigaYA80DygHDgHNgeWB9YE8D18RrEjV5mipNs0ah8dxF3GXcld613l25u6WFaJFarBanJfyfRu3KD9QftDqorlqn120MJg4Cg5bB0UH7oHvQOxgYDA2+GNwc3B2CDLUN2Yfc9+LuYe/l3yu5V31Pcq//nlOfp5fqh/RO/fp96H3iffr9nvum+7b7nvtrw+nDLT8SfvT8uG2AGmgGhkFiGDbYDBuGl8ZEY5ax0sgzCoxdRtCoMeqNZuMj44TRZZw3LhqXjavGDeOOcd8EMyFN8aZEU5qJaMoyUUxVpg7TsMlj2ngQ9yDrAeOB/IH9wQszykw2s8wis8ZsMwfMa+aXI8iRpJHMEepI2Qh7hD+iGFGPmEZsI/MjoZEtC9QSb0mzZFtoFqYFsMgsaovF4rAELZs/Sf+lerT3GPO4+HHH44ePV0ZjR/NGy0Z5o6pR3xPEk4Inoicua6KVae2wmq1e69ZY1FjyGHmsZKxmTDJmHpsYmx9bHdu3xdrSbGRbkY1jE9lAm8nmsPltK+OQcew4aZw+DozLxvXjzvHg+PYEaoIwQZtgT3RNPJxYmtiaxE3mTzIn+ZO9k6ZJ5+Ty5I4dY8+zF9s5dq3dbvfaX0xBptBTGVOFU+wp2ZRham5qbWrPEeXAOogOiqPIUengOiQO0GF2OBxLju3pqOnE6axp2nT1dNt0z7Rh2jrtnV6Z3nXCnWgn0UlxFjlZzmanwql1WpxzzpBzZyZ2hjBDnamaaZlRzhhmXDMrMzuuKBfOleOiuypdTa4OF+gyudyukGt3Nm6WMEudrZzlz/bOGmYds4uzG+4wN9ad6aa5K93Nbrl7yG11e93rP4f9jP456ee1uZK54bm9X0i/8H8x/LLuifWkeUo9HR61x/5r9q9Dv/rmOb8l/6b5zevFeRne3t/jfyf9zv3d49P7HL7dPwh/MP9Q+Mv9cn+Pv9+v8xv8P/mtfq//nwXUAmEhZ6FygbfQv+BaCC2sLWIXiYuUxaLFykX+IrioXfQsBp5CnqKf4p+WP216an46F4gNUANlASCgCnifIZ81Pet4pnrmfBZawixlLQFL4NLwkmNp+TnhOfBc8rz3+V6wIFge5ATtwfXgyz/T/6z8s/fPueWwZebyxF9xf3H+2g7BQuiQIKQM6ULBv+P/pv6bs7L1n6YXh/4LlkV+owAAAQAABc0B4ABbAFwABwACACQANAB3AAAAzAuXAAMAAXjalVS9bhpBEJ478A/yj6IUKewU28RFBIfBP4WpMBgaLBIbOUqXM6xh5eP2tHc2MmnTpUqdJlGUwkWeIA+QJ8gzpMwjJN/uLbaMbcnmtMe3M998Mzs7QETPnSNyKP28wkqxQznsUuzSHL21OEOr9M7iLDjvLZ6hJfpg8Sw9oU8Wz9EmfbV4nl7Sb4tztEb/LF6gZ84LixeBKxYv0Y7z2uJlWnE+IruTzWH3xflusUNP3T2LXVp231icoW2XW5wF57PFM7Ti/rB4lpj7y+I5Grh/LJ6nTqZtcY5amW8WL1A+89fiRcpnVy1eoiTbtHiZNrM/66IvEjHmPdbzE591ZXShRH+QsEtWXi+VC3ht5VlnwNm+HIsg8FlDnoXgChkyP+yxDg/4iQxF12eHXtVrCOWDGsoD3j8LfLXhlde3K7VOfbeiXdpTsK4r6hFXsZYz3HtZTMTMZ4nye3zoq1MmT26UVZMqksrU5dV8pSToExtnzeMDtsb2ejyMI8FPuRr6YciqzdvMu1iDJIl2isXRaOR10wCvK4d3W1uii3D0E13iiiUosR3xEG0LE2adeXZuj1zySkwqFiCzsnpxV4koib1YBJ5U/WK70aI6CepjJVhj4tQjhuVj7wN1SVJEF6QMawAro0usMq1TCe+CRVuUh7UDBsf3PqLGiAjwaJUG9mcUWl2BXQirbyw6ioPH6cTYBXLqmEPyqIrVgEUZy77xSzoAtw89ra1oAxxdwzZVqAatOu0CTaImMYWpqNuqR/Ariq+qu9Z9vBaDJTYnZDiv9vUQMTTsU9gkznp/t2rYK3RdmshJvzzYdbzCLlWf5mmtJh2jOoa/FUZ7JmsIboQIjsz6hEPTd33CKtgP0Xyolp6OBP4dKuIZmcczt3mdwTMTNXwUt2VmIs2ezmc6S7oC3d+0i22ocVNLw/RLT+rNSD2h51O3XEKWkrkRrRXYM6up+mKo6F9ABJuuKza35ZmoPvxt5Gz9BwIiPnQAAAB42m1aBXgbR9PenZm1awiVmRlSSaeTrLIwTZMmaaBpU5Tts61GllxBqMzMzMzMzMzMzAzf97X9yv1Pd+/Zyvf8eZ54bnbnfWd2dm5373SKlPfvn9tUxBVa/c8/85zbSIoUq7XVU5rVE6pbXadFG9Wjrlcn6ha1jlpX/aX+Ub26VS+h1lNf6TbdrtZXju7QnepJ9bQepZ7Ro/UYtYHaUP2qx+pxekm1kV5KL6021suoZ/Wy6jn1vPpdvaCX08vrFdQmekU1Xq+kNtUr61X0qno19bEKqbBeXa+h19RrqT431hf12uol1a9e0evoddVJej11g7pRWeo7FVW2Xl9voDdUMb2R+lT9oTfWm6i4Hq831SEdVl3qVR1Rr6kB9bq2dFTbOqbjKqE20106oTfTm6vN1RbqG72FukdvqbbUW6nP9dZ6G53UKZ3WGZVRBZ1Vc1VR7aVzeoIqqUF1od5WZVVO/e0msKwn6u3UBPW1nqS12lYN6cl6e1VRVT1F7a2n6mlqotpO/aZ30NP1DDVJz9Sz1GT1hqrpHdU8NV/PVnW9k95Zz9G7qO31rno3NUXvrvdQU/WeOq+7dY/6RE1TO+he7eg+3a8H1AI1XS3UBbWP2lct0nvpueoiXVT7qZvUDPW9mqlm6UFd0mW1ox5Sn6k/9d66oo5Ss3VV13Rdz1M7qf31fHWgOkgdoBfohXqR3kfvq3ZWc/R+en99gD5Q7aJ2Vd/qg9Td+mC1mz5EfaEP1Yfpw/UR+kh9lHpQPaTOU+fro/Ux+lh9nD5en6BP1Cfpk/Up+lR9mj5dn6HP1Gfps/U5+lx9nj5fX6Av1Bfpi/Ul+lJ9mb5cX6Gv1Ffpq/U1+lp9nb5e36Bv1Dfpm/Ut+lZ9m75d36Hv1Hfpu/U9+l59n75fP6Af1A/ph/Uj+lH9mH5cP6Gf1E/pp/Uz+ln9nH5ev6Bf1C/pl/Ur+lX9mn5dv6Hf1G/pt/U7+l39nn5ff6A/1B/pj/Un+lP9mf5cf6G/1F/pr/U3+lv9nf5e/6B/1P/S/9b/0T/pn/Uv+r/6V/2b/l3/of/Uf+m/9T/uLaGJiEnIUAu10hLURu3UQZ00ikbTGBpL42hJWoqWpmVoWVqOlqcVaEVaiVamVWhVWo1WpzVoTVqL1qZ1aF1aj9anDWhD2og2pk1oPG1KIQpThCyKkk0xilMXJWgz2py2oC1pK9qatqEkpShNGcpSjibQtjSRtqNJNJm2pyk0labRDjSdZtBMmkU70mzaiXamObQL7Uq70e60B+1JeeqmHuolh/qonwaoQHvRXCrSIJWoTEO0N1WoSjWq0zyaTwtoIS2ifWhf2o/2pwPoQDqIDqZD6FA6jA6nI+hIOoqOpmPoWDqOjqcT6EQ6iU6mU+hUOo1OpzPoTDqLzqZz6Fw6j86nC+hCuogupkvoUrqMLqcr6Eq6iq6ma+hauo6upxvoRrqJbqZb6Fa6jW6nO+hOuovupnvoXrqP7qcH6EF6iB6mR+hReowepyfoSXqKnqZn6Fl6jp6nF+hFeoleplfoVXqNXqc36E16i96md+hdeo/epw/oQ/qIPqZP6FP6jD6nL+hL+oq+pm/oW/qOvqcf6Ef6F/2b/kM/0c/0C/2XfqXf6Hf6g/6kv+hv+ocVayZmFjbcwq28BLdxO3dwJ4/i0TyGx/I4XpKX4qV5GV6Wl+PleQVekVfilXkVXpVX49V5DV6T1+K1eR1el9fj9XkD3pA34o15Ex7Pm3KIwxxhi6Nsc4zj3MUJ3ow35y14S96Kt+ZtOMkpTnOGs5zjCbwtT+TteBJP5u15ijqHp/I03oGn8wyeybN4R57NO/HOPId34V15N96d9+A9Oc/d3MO97HAf9/MAF3gvnstFHuQSl3mI9+YKV7nGdZ7H83kBL+RFvA/vy/vx/nwAH8gH8cF8CB/Kh/HhfAQfyUfx0XwMH8vH8fF8Ap/IJ/HJfAqfyqfx6XwGn8ln8dl8Dp/L5/H5fAFfyBfxxXwJX8qX8eV8BV/JV/HVfA1fy9fx9XwD38g38c18C9/Kt/HtfAffyXfx3XwP38v38f38AD/ID/HD/Ag/yo/x4/wEP8lP8dP8DD/Lz/Hz/AK/yC/xy/wKv8qv8ev8Br/Jb/Hb/A6/y+/x+/wBf8gf8cf8CX/Kn/Hn/AV/yV/x1/wNf8vf8ff8A//I/+J/83/4J/5ZLaWWVsuoZdVyanm1glpRraRW5l/4v/wr/8a/8x/8J//Ff/M/okSre4XUT8Ii6mf1ixhpkVZZQtqkXTqkU0bJaBkjY2WcLClLydKyjCwry8nysoKsKCvJyrKKrCqryeqyhqwpa8naso6sK+vJ+rKBbCgbycayiYyXTSUkYYmIJVGxJaZGqa3VI+oItYoao65Roi5RLWqcWlNdrIxqV6uqJSWuUtIlCdlMNpctZEu1u9pTbaW2UR2qU7aSrWUbSUpK0pKRrORkgmwrE2U7dYu6WSapsTJZtpcpMlWmyQ7qKnW1ul89oB5Tt6rb1O3qDvWoTJcZMlNmyY4yW3aSnWWO7CK7ym6yu+yhDlX3qVbZU/LqcumWHulVh6nTxZE+6ZcBKcheMleKMigldYXKS1ndKUNqddlbKlJVa6jT1MnqXKlJXeap1dSp6lKZr36QBbJQ/ahOUGeqJdTjarQsUqfIPupsdZnsq86S/WR/OUAOlIPkYDlEDpXD5HA5Qo6Uo+RoOUaOlePkeDlBTpST5GQ5RU6V0+R0OUPOlLPkbDlHzpXz5Hy5QC6Ui+RiuUQulcvkcrlCrpSr5Gq5Rq6V6+R6uUFulJvkZrlFbpXb5Ha5Q+6Uu+RuuUfulfvkfnlAHpSH5GF5RB6Vx+RxeUKelKfkaXlGnpXn5Hl5QV6Ul+RleUVeldfkdXlD3pS35G15R96V9+R9+UA+lI/kY/lEPpXP5HN1l3whX8pX8rV8I9/Kd/K9/CA/yr/k3/If+Ul+ll/kv/Kr/Ca/yx/yp/wlf8s/RhltyLARY0yLaTVLmDbTbjpMpxllRpsxZqwZZ5Y0S5mlzTJmWbOcWd6sYFY0K5mVzSpmVbOaWd2sYdY0a5m1zTpmXbOeWd9sYDY0G5mNzSZmvNnUhEzYRIxlosY2MRM3XSZhNjObmy3MlmYrs7XZxiRNyqRNxmRNzkww25qJZjszyUw225spZqqZZnYw080MM9PMMjua2WYns7OZY3Yxu5rdzO5mD7OnyZtu02N6jWP6TL8ZMAWzl5lrimbQlEzZDJm9TcVUTc3UzTwz3ywwC80is4/Z1+xn9jcHmAPNQeZgtYf6Uq2l2tSR6hh1tDpcHasOMYeYQ81hKqkOVg+bw80R5khzlDnaHGOONceZ480J5kRzkjnZnGJONaeZ080Z5kxzljnbnGPONeeZ880F5kJzkbnYXGIuNZeZy80V5kpzlblaHafeUR+p99Wb6nj1rkqrD9Tb6kP1nnrLXGOuNdeZ680N5kZzk7nZ3GJuNbeZ280d5k5zl7nb3GPuNfeZ+80D5kHzkHnYPGIeNY+Zx80T5knzlHnaPGOeNc+Z580L5kXzknnZvGJeNa+Z16VULxZbkt0VZ57TmhzM91TKpdZkub9ccua2JrP5nnrN6Uj3FCo99cG+orOgPd1bruV7epxSrSXTk3etXVEp52stWY+jJes1tmeHzVqzYM36rB0TRtg6J/SUBwfzvmH7hGGMbNudr3RsO2JIE7drmegHORF0E326lom1QrHX6diuiXVSE2vLZG8MLZO9uDonN3XJZNdhyxS/f4rfP6Wpn7Ol/papntdRUwfqpf58pT5YzNdrrVP9GDqmVov56oBPMB3C55neHMIMP40zmkKc0RzHTHe0LTM9YGu9VAiFYxFPRsLJllm+/1mL+Z+FHMzyc2BmVQpuqLO8TLTM9r3NHvHWNru34FScaqHaMru/kp/ndOw80tmys9fUMseDtc8ZnoTRaa9lfLHcU5w2edLoKYurUxdXZyyuzllMbcn7c5dH3HkUWN7xY+1pKrCekQLr9QvM8SvL8SvLGaksB3QOKqu/KcH9zZXVP1JZA43KGmgafsFjbyt4sc6cPokKe7UWQFxAjRW8zPpzYsU79mryM7fJT+fc/orjlIr5Um+hp6XoF0TRL4hi84QXG4VX8sdeyg+Vq7VKeWjAaSn5tqXmInTcmS37RVBerAjKKMJyUxFWIHyeSnMRVn131abYq80x1RpFWGsuQgtFmGqp+/7ri/mvI0l1FGHdK8K6X4TzfW/zm4pw/nARzveLcGHTLCz0i3CRX4SLRoqwZ/G6Ki2ulhdXq4urixZTG6OJhOI5b1R2JA2ZhMxCdnkyGg5BhiEjkH5WoiHIRGAXhbTRj/ZQgI9BxiEDPwnYZXzZlUQ7ZCgNPQUZ6LAPZyH9cUUj8BuB3wjijgRxwz6CeCOIN4K4IogzyEMkiC/gh3/kLRpBXKHALog7yEPgB/GGwB+CvxD8hMATCeKDvxDij2FcsUAHbwx8MfDE4D+GOGPgiwMfBz4OfBz4OPAJ9CfQn0B/IugHfwL8CfAnwZ8EPhlDPYEnCXwS+CTwSeBTwKeAT8FvCrhUUKdBO/Ap4NPApzHvacx3GvOQRr7TmKc08p3GvGSAz8B/Bn4y8J9B3Bn4zcBvFrgscFmMNwt8Fvgs8Fngs8DngM8BnwM+B3wO+BzwOeBzuF9xn9moExv1ZqPObNSXjbq0cT/ZuA9s3Oc27m8b97GN+9XGfWrjfrRx/9nhYL0APrjPuhBfF8ZnYXwW5sWCnYX5sYN1JOjH+C3Mmw28HfQjLxbm00J+LMyrHawjmF8LebMRlxW0BzrsrSBe3HdR+I3CbxRxR4O4YR9FvFHEG0VcUcQZRXzRIL6AH/6jiC+KuOzALog7yEPgB/Ha4Lfhz4YfGzzRID74s4N1A+PB7haNgT8Gnhj8x8ATg78YeOLAx4GPAx8HPg58IphX9CfQnwj6wZ8AfwL8SfAnLdQV8Engk8AngU8CnwQ+BXwK/lPApYBLpcAbtAOfAj4dSOQrjbynke808pzG/KQxj2nkOwP/GfjPwE8G/jOIOxOsO/CXBS4LXBbjzgKfBT4LfBb4LPA54HPA54DPAZ8DPgd8DvgczgPYp23s6zb2Lxv7lI39zcY+ZWO/trEv2jgn2Dgf2DgH2NjvbezzNvZxG/u3HQ7OI8AH+3RXcB8H/bCPBPMXtAf1EOwzGHcKegp6BnrG1614ziSLQwN5STm1vJmQdw+Cfoe78WWHqoViuSRz3C7Out0zB9wrmegeysyk/NBQ3n2oGuzuzdP2dZpSp50K7gNRoXEWpGkFnj5QNjMK/YN5npmvt87yqXjaQIHT7v9p1YLvJplo9/zXyqVytRMePWUJ16N30dZw6PeD31dmNRm3Tx10+mHUMA/OmGNgFOgYdAgyAukXtYVNzsImZ2GTs7DJWdjkLNwcFjZJC0VuIblWLpBxyAQkeFF0FjYvyy++cM7fpFyZgExCpiDTkBnILCTwKdinYJ8CXwp8KeC70N6F9i7guoDrCuzgpwt+uuAnDHwY+DDwYeDDwIeBT8M+DfsI9EigAx8BPgJ8BPgI/EfgPw37NOzTsE+ANwHeBOwSsEsEduBNgDcBXgt4C3gLeAt4C3gLeAt4C/gM7DOwz4AvA74o9Gigwz4K+yj4o+DPwT4H+yz6beg2cDbsbcSRBW8W/VnwZIGLQY8FOuxjsI/BTwy8MYwzBv4c7HOwz8E+Cd4keJOwS8IuGdiBNwneZM7kvUWou7EI9TcWIdPrFGv5VgdL0KLGEtTorHlLUKGxBM31lqCitwT591EqTaU6LSi4z8TeOsGVgTLu2IipeotRzV2M6liMhtyFqMf976qm3Fg/2grDK02haREZ16z43fWmtWdMffE1Zun/0X1EuWnpai8Pr1bt+ZHVz2le/RxEghUqDImVBscMK56CxEoVx8qCbdbCNmtlgnasXNhmLWzLFo79ViZox/aA47+F47mF7dXCMd3CNmthm7VwTLewvVpBZfjHc1eGISOQFmQU0oaMQcZ9GQc+DnwK/Sm0p4J28KXAnwJvF+y6YNeF/i7YdwV28N8F/i74T0GGwRMGTxg8YfCEwRMGTxz9cfRHgI8AH0F/JOgHPgJ8BHFEgjygP47+NPrTwKfBl4ZdAv4S8JdAfwL2icAOfAnwJeAvDWmBxwKPBR4LPBZ4LPBY4LGCuKHHoWegZ8CbAW8GvBnwZmAfhV0UdlHYRWEXhf9okHesRPFg5UR/Fv02+Gzw2eCzwWfD3g7sEa8djAcrWzxYYdGfBW8WvFnwZsGbBT4GuxjsYrCLwS4G/zH4j4E/FvjHfRUPdgr054DPgS8HniT8JeEvif4k7JOBHfwlwZeEv1xwH+DEEk+2LXIq5fG1crVviXLJ8S9q8/2W9tpAxfHb2vrK9QquCvNgVy0s8O2qzjyn5F86hf6Bmm9YKoDQ99H4M3rYm6d67/DC/nbnSgsyCmlDxiDjkF2QCchkmxu653ig0wvZv652NELFdacXIxQ/oN5SedAbtHfRGHTjAoNuXPqD9q8ag/bsGoP27PxBe5f+oD1Db9DeleejVB+seD68i4aPxgV8NC59H/5Vw4dn1/Dh2fk+vEvfh2fo+Whc+e9A/UXRlWHICKQFGYW0IWOQccguyATeqfqbRAjPmCG8wwqlwBcHXxx8cfDFwRcHXxx80eSoeqnXqVR7yhWnt7s4xlnQ4273veX5pfE9+aozbu+6U60V3J02aBnjDq7bBRT6/apCfBnILPihx7Ojuyv5Hqfo9NV8uKdWvIQ19LENfa5TGzYYh4YRk9FD+YpTGmHw1P+3uzG3zd0Nvam7MS3N3SPTFLbb+wr9dTcF+eqAn9FkpsMZbKiekw6nNHI9sHBowPGz0QlbP7IRDi81S/bXC8WiM1geGd1Sw00jA/DMqoVSf3FxM69pxKwtXyrX3EQWcBKLI9UhTC1ev4WSKLlQqr065OZ6fJ+b0HaYjq/1dQ5fYvZyWf/hKBJK5iRbx60f8p90XImpTCXaGj8TeLBRPfWKm8aehZ7W0VsuFvP+EtQJIn9xabA1NaeSzUqmWUn4vNWaUym64/YXsYVOU41F/EchVwb3Sho1lu5w9q4X5uWLbkROe6FUc/or+WJ3bfiyNtTZuKxUnZ5GLeOWCWhSoIHswrjjyVEVZ16x3F/oyRfd1I8qlPoKpUJtoTcb7a7LfNFfYgYLpXrVX1iGirhCv7c8+P3e8uD1N67GuifrSnmBb9UY45h8tafg//qFpBbmFXDdPmLW2V9x8u5QPGUclJHukSCh+QnwZ6PoVKve1ejGVZPrkUH67vyAPYbBerFWGCqCr1GBw7Cx7q1UK+SLvYW+Pj+2IacyXCJjXaU2UK5X86Ve3703ds9942rER6ebiN56jw/rrLiPAT3wMLpad59TGlPml0G+UinPrw/5W0si3u7p3h2Cpq42r6mxWKEl4bc07iy0xPyW7nJtoA2EvbDOYhfLYhfLYhfzjx6RVCiQcUi/hOL+lh+xuwIZgbRae0vdxXLPXOg2ZAwybtA71GTlHxjd3hxkFjLTWuxrZktBJiETrZVaMw+8JeDNP3C6sgsyAQl8Anz+I7wrM5Dw7z7CF2vVgXyvY7y/rb1zfen1pnMtjR8Zi1CzCN4/fboSqckgNf7p05UILoPgMgg6hyTkAh12OdilEXw621YozWv2nMFwMhhOFhFkgwgwvAyGl8HwMog4DU9peEpm3b3BXZp7K+7qgSZAk4CEQBlG0GG4DCPTFvojkFZgF7RDDwEXQpJiCDkGHactG6cvO4Yk2rDDKcy2EZ8NfhupsDFUnOpsG6nCqc6OIakx+IkhHhsyBr4Y/MQwvliAR1w4/dk4Ddp2ED/ijSGeWLLNT213eQEyipEkgUgCkUSkyWBSEQHuVBt3qp2FXRZ2OUSeA28OvO4h3t2B8/3uYuJJdwXwZKXmy2IfeDCiLHBZxJPFiK1gptEfQVwhZDqMTEfhPwI9HOiIO4QZi6A9Cp4o2qPAYZOyLcQRhgwFlQg8znk2Dgl2HHnBuc+2wBOGjAdxBfGDN4r+SCCDduQlgvgs6FagIx8W/EYDCXw8kLCLB+NGhUWDuBEPzrV2HP0419o459rxIE9ojwBvQbcCHX4s5CEaSPBHMZ8W8hcBPoz4w8G8oj0a3OGIMxLYgTeC8eHMYkeDOgn4A3/IfwR24UxnsbzIKfU7IwegWCTU5m6b7lbmnurcA828YYWr9VJLnzPonoCk8ce4B79eR3qK9W4z4Li7dGtvIT/oHuI7ButV7PTO6KZr9+Tf1jjnu5ut0+vveaiscDjWUm+8lAiZxmbuYEP0h2mh3C2Uh4V0WRielc524syFM43THzy1dvTm+/txjhntX7tRDI82ZOFnaQufD1hxu837yKSnPNjtt+CHZws/NCMaV8ebM/xAhKhcHUz4IcnCidkKxdu8b2KamPFuLRQg8KsCfhK2LLvNO6k1EJ3w4R0L/e948AVBBF8ARBpH58bXPuPdo2i7/6WMd4b0vvXxL/1+75Gix+l1F8W8/0gx8uGOp48K3nj6jz7DH+/4JN4o/Keo5u+H/KcW/xsi/1Gi8f2QD/EPnB71Yp/wLDkSZvNXPSELv05bUdv4b1e9v4sHN/xWNZxLBb+bBG9R8D46DT0T/H6B9kzQH7zvD963wy4b9Advf4L35QFPqBPtw89njc7myUm3ennvWdgJOdyZDfk7sCvDkBFI6/8A0IeqMAAAAQAB//8AD3jaY2DAC6KB0JXBlWkjAwMTPwPDfx3m5f++M+35/5VJ6v9XCA9FzTsmfpg4WNU7HOreoprGzIpQBwAU9S/aAAB42q1WaXPTVhSVvCROQpaShRZ1eeLFaWo/mZRCMGBCkCy74C7O1kpQWil20n2Blhl+g3/NlWln6Dd+Ws99sk0gSTvDlGF8z7s6ene/ChlKkLEX+KEQrWfGzFaLxnbuBXTZotUwOhS9vYAyxfjvglEwOh25b9k2GSEZnqz3DdPwItchU5GIDh3KKNEV9LxNuZV7/VVz0vM7/vb9wJa21QsEtduBTZuhJajKqBqGIklJcZdWoRqcBK3x8zVmPm8HAk70YkGT7SCCRvCzSUbrjNYjKwrD0CKzHIaSjHZwEIYOZZXAPbliDIfyXjugvHRpTLpwPyQzciinJPwS3SS/7wp+khrnX8pGfoeyJRt6T/RED3cna/kiwtoKorYVb4eBDPF0cyfAI4uDGlh2KK9o3Cv3jUyamjEcpSuRYunGlNk/JLMD+5QvOTSuBDs55XWe5Yx9wTfQZhQyJaprJwuqPz5leL5bskfJnlAvJ38yvcUswwUPEUfC78mYC6EzZVicTRIWnBx6SdmijOupialTXqdlvGVYL0I7+tIZpQPqT01m/cC2pB2WbIemVZLJ+NSN6w7NKBCFoDPeXX4dQLohTfNpG6dpnByaxTVzOiUCGejALs14kehFgmaQNIfmVGs3SHLderhM0wfyiUNvqNZW0NpJlZYN/bzWn1WJMevtBcnsrEdm7NJsmZsUresmZ/hnGj9kLqES2WI7SDh5iNbtobxstmRLvDbEVvqcX0HvsyZEJE3434T25VKdUsDEMOYlsuWRsdE3TVPXal4ZiZHxdwOala7waQpNOSnRb66IYP6vuTnTmDFctxclZ8fK9LhsXUCaFhDbfNmhRZWYLJeQZ5bnVJJl+aZKcizfUkme5XmVjLG0VDLO8m2VFFi+o5IJlh8oUSHzgUMlDR46VNbgkUPvKoOmy6/h43vw8V3cLeAjSxs+srwAH1lK+MhyGT6yLMJHlivwkeX78JHlKnxkqZSo6VZzFMzORcJDfSJPlwPjo7jfKoqcMjmYpIto4qY4pRIyrkpeY//KQCs5tDYqj7lEF0tJ3lz0A6whDvDDo5k5/viSEle0vx+BZ/rHjWDCTjTOemPpT4P/1TdkNblkLiKiy4gfDp/sLxo7rjp0RVXO1Rxa/y8qmrAD+lWUxFgqiopo8vAilXd6vaZsYtoDrHWsRUz0umkuLsB+FVtmCQOC/5pCE175oFeRQtR6uOvai8eikt5BOdwJlqCI531zK3iaEVlhPc2sZM+HLu/AArap1GzZwPR5r45SxHsoXfYZL+qi6by4i8cZL7aAI95Br74TwyUsZtlADSUsNBAXhLaC+04wItNtl8OAI/d5NFT+2K24kSMqaifw20633AtbKPl1zoGAJr8yyIGsITU3tJoKGB4hGrLJxrhaNZ0yDmCQUWM3qIgavo3s8UAp2JdhyseKON05+vVNC3VSBw8qI7mNbw488Ialifjz/GqIw1JuKCkqnLUGFnMtrCQVcwEDeGukbh9Vb77MPpFzW1G1fOKlrqJr5R4Mc7PA2+MclKVCFVC9UYcNs8vNJdHqFQxJel0dSwM7/DVasfl/dR+7z/ulJrFCjtTbDgc++pyMYfwNjt+WgwQM4hiF3ETIi+lw4uuOOZyv0GXM4sen6O9g55oL83QF+K6iqxAtzpqPvIoGPmXDPH2iuB2pBfip6mPPAHwGYDL4XPVNrWkDaM0Wc3yAbeYw2GEOg13mMNhjzm2AL5jD4EvmMAiYwyBkjgdwjzkM7jOHwVfMYfCAOQ2Ar5nD4BvmMIiYwyBmjguwzxwGHeYw6DKHwYGi66M0H/KBNoC+1egW0He6n3DYxOF7RTdG7B/4oNk/asTsnzRi6s+KaiPqL3zQ1F81YupvGjH1oaKbI+ojPmjq7xox9Q+NmPpYPZ3IZYZ/PLllKhxQdrn9ZPhNcf4BX3tNaXjaY/DewXAiKGIjI2Nf5AbGnRwMHAzJBRsZ2Jy2uBjIMDNogZjbzTmUOQTZmTkgPEc2XTYpVjCP02kPHwMnA0sDAzMDJ5DP47SHwQEMwXxmBpeNKowdgREbHDoiNjKnuGxUA/F2cTQwMLI4dCSHRICURALBdksOVQ5hdmYerR2M/1s3sPRuZALqZU1xAQDsnSffAAAAAAABAAAAAA==') format('woff');
+}
+@font-face {
+font-family: Fira-Mono;
+font-style: normal;
+font-weight: 500;
+font-stretch: normal;
+src: url('data:application/font-woff;charset=utf-8;base64,d09GRgABAAAAAVCQABIAAAACpcwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABEU0lHAAFQiAAAAAgAAAAIAAAAAUdERUYAAAGUAAAAagAAAIBPClFWR1BPUwAAAgAAAApGAAAaoPqgzaZHU1VCAAAMSAAACXwAABV6fb9phk9TLzIAABXEAAAAWAAAAGCXlfhyY21hcAAAFhwAAB5vAAA75Hd9EZhjdnQgAAFKDAAAAD0AAACSCc0uEWZwZ20AAUpMAAAFqAAAC5feFNvwZ2FzcAABSgQAAAAIAAAACAAAABBnbHlmAAA0jAAA5xgAAcuCyTpWamhlYWQAARukAAAANgAAADYFeBiFaGhlYQABG9wAAAAhAAAAJAXeAnVobXR4AAEcAAAABfwAABc0WiUEFGxvY2EAASH8AAALbAAAC5z1Q2lfbWF4cAABLWgAAAAgAAAAIAeaDgpuYW1lAAEtiAAAAvwAAAaXchG8DHBvc3QAATCEAAAZfwAANXtOj+fkcHJlcAABT/QAAACSAAAAoG3pAKF42hWLQQ6CUBBD2366MHGBcACPoBs9grfC+AV2JnAUuKFlFs1Lpw8EcMZxLwgnNGxBXthB7HUDddcD0rNUsLl6AP32D8WL1+TmHeUw037yq66Qvx7Dk6fwnDWzXpJrHMXZwntM/QEJDxDxAAB42r2ZD2xV1R3Hf+f2nvcepcLzX0UtpXZYO7SlYlexYle0q6WW2tW30jWkgqmMYO1YV7sOCWFdx7AjSBgjjDHCDGGOGAaoyBCZAWIadRVJh84RZIhOBQ1DxtC5dt/zvafv3fenU7PENJ/v/d3f+Z3f+Z1z73vn3ldRIpIuA06DOBWVNREZ0zq3o02yxIVfhobEwSFDyiV9euVdOVI9vekbORK5Y3okR5rvqIfOv2t6U460z7y7JkcW19UgZln93TNzZFXExKyP1MOz2WZScpG1HBljrTQZay1XwtbScrG1AnKJtYJyqbVCcpm1Rsnl1kqXTGuNlitk3INz2x+Q1dQN1C3U7dQ91IPUfurr1BPU09TzRpU8+MCDD6h06mXUbGo+dQp1GrWSWkdtorZQ26hdWMM0oLiaX7aVhpXVX7IVwPXNlGzJk0Ip4b2kpMg7Bpq849gSCeDmU5fnS8Axx632/IiozHWZ21B9hjThqiu3PIq4xdautHYNqI+LUW5jyj7ilsrHbtjNJFkg1x4N+W5hFNNe7JZaytle6dZEY2OUWjJTUu82us1uC+wFluG2hW6WPhw799vR2jqtvdgeu8HyaHt4hDEBsq30na8B691N7pZoH28upUm5wnE1P2Gx9ZLk8cK+OeWy7m6uW5a7E+xm3ZXuPt8cun32QbsuL9rjIa6/aTviHnVPpBjTP+933Q9HXHvDOfeTuOvtrbWAgM7QlwzjhvU4+LItE8E4t1lP4jFGkWVcIrpET+PxsAfyBWzb7W6lubbR2MNJ/XM5prGrTDv+akHE1BiNMfmaaTelHP+wnmPmgOM8m6dVt+suzsubB+vWSzD3MPNFax4+Z3uP7mXNZn1W6bV6g34sIcas3eNmnTDWNvAU7FqMscfWUmswdYDnYb9g16SW65KlX+Z6mzjfuHaugehYKeaY0u/PEY4hanDAfMMM/pw64ISha6ivGh0K0v69UXXDUJFRZ6dRE68m8dtqB+1Z9FfQnk67PG0a9Cv0XEfPvbRbaV9P+3raJdQc6k3U8c4OMwoz3EvP1dSJRuVU2inon5jh+/QXUq/1Ytgrjzo+7VaTn3aOUXmLvR7xRqQ9g1pNTz7tMjsWZ+2cRK8++u+xHqNfs3rAzNEZa+ZLzz2MbHQC0An0fNX2MpHfM7bsdlZwvsZfQM+ZtBnQt9l3If0TaedSL6cnj3aeqUd9h3aA9kRmLmJMka1nPzMf4OgHWAnUPKeICs+7OCu2Y+iuKKJbrb3E2j2gNy5G6VUp+4huV3fqKty9Ed2EY5OegzvbHM3nq0p30R5mSfS8J84/TC8+U1X4VPl9G0Akms8fv5ZtVfox8Hhc2zbdFOrB8Sm9J+YL9cA3zPMpxx8mgk9lBJ/EiPme0a+DY+AkeB+cYT1+zpMXwMvgMHgdHAMnwfvgDOr/VLcGHBACY8Bl4CrOi3ML5IA8cAOYAqaCMlABqodrC9QZAjkgD9wApoCpoAxUAMQGGsBscB+YD9pAB1gElibPObAMrACr7djrwEZf+2awFWwHu8Bee51ibAjsB32gHwyANrARvAGO81qBwDuGwH7QB/rBAGgDG8EbALGB03pb4Cy4gLHOBgaDrjkPpgfD5lxXBTNxZJuNucD4qmE7mBX1R30+eo3P5AjmxnIF86Oxph01mHHtmBfi8vlzeTVEa42LwTHUEyyM1gdfsDhYqjcEy0ElqAH1oBE0gxawgPNPAOsCggtBJygHlaAG1ING0AxawAKwGLV3g+VgJVgD1oNNZk52XlvAE2An2A32gYPgRXDIzDvKEXIUnABbwBNgJ9gN9oGD4EVwCLyLtfwQbALnwCe6KiQgADLAJXbtRyA0DmSDiWASKAIlYFpsbUO3g6qR40K1IBJ3/ZMI4fsG/XvRvxf9e9G/F/170b8X/XvRv9feCyA0xxCaB1pBNpgIJoEiUAKmgVoQAe2hLnzLVIWWfLGdlt/u3r7HPdbbdUfcaW+jltIzOWl39fbGAi8Pd8JCKvdz+R39dzNmMnfIFmcfdJbRocedXbDHOrthn6f2O8/AM8F5DpppYlTnUBnsDMYPUe83MUOHGL+R2knPCbb+mXorPVvY2kGdSc8vTOahnxlVXSbz0L8YP0h9yNQzdIzxj1DnstdW9trEqkYx8j07iolfbiON/QH9fdQN9F/NDLM563T636HewvjNjNnH/E+yqh+aqlRm7OnAPhHcwpWcxv18ub0Wxp9NLbb2gfhnATWDT1XfpD01rQB9z1EPGFXj0gpNL6PyGj0FaUvoN3pl2vXQDOqVznFoM2OuYob3aJcxQwUz/IeeeupFjDlK+0bG3MyYM/RUMv+NRmWA853CUa6lTuFY05nhJcZfwwx5zPAmPSXMkEO9xnnM3GP0j2avv9AuZK9i9vqAnlnUS6l3sG8hdTIz/ICVTGYNudTJrORm+vmc5T3jBLtD83xvxR1RxJ1v7UXWXgqWxcUod0XKPuK2qYBb4VYnUJfCV+02uLMt1e597vyUNLhtboe7KHpc6i5LwYokn8m52l2XRAPHTUXdCP6NZLO7lWx3dyWx191vY/tG4POOlUx/AhXuQErecI8n8f+MGx/7jo/T9rg1Du9aeXM19Xj+swlcSOE7q9e7gwa3Qbs6XYdTwbZMnaVzdT7swhQUJ/p0qS7X63VlIiaXj/X4q0mgPoXP0BilGfU0s3+NbtELUsG2hR7uZt05bPO8IYl6//nwmNHzxXasbr3cj1uBuaZAr9Rrkvj88/yf9aXKkbT25roNz7PC832h/d23p9sd2dvx7096Sx5PvZme/BHesP3vr/f6ngS8p4JKvqPvpH0X7V3eXu8pI28a4ZnBe07w3oO9t8wpvl3P/6Y7mvZo+v3vqf635CD97fTn+96k/bthEWP8b7fec8stsV8g5KT31k7Pdzmjc+Z92vvmdzaZd19881ebX8ulKoFaEAFNCf45SbGu5EuhFEvpZ13NwX7z7o6Y2M5eYNbNqXDqWEk2f8XN9JEFfzjhjnmTe9gJJ9dXfWMCzaAFLEjwL0yKzZCpUiYVyFMnDTJb7pP50iYdsugzZ/Mad9RC+1xg9uq/2icCs1enc68+Rk8Rd+ZJvv05tjM7koa3/BUi+lG9Ssbq7XqHXAzvVSpTXYHpXqluE0d9Xd0p16kZuC+L1Ew1S25S31bNUqbmqlapUG2qXepUh+qQb6lO1SkNqkstkVlqqVorzWqd2iwPqS1qh3SrJ9UuWal2qxdktepTx+U36oR6S/aot9XfZa86pc7LH9XH6t/ykhpSQ9LvKCcorzijnPFyxJngTJBTzjVOgZw2/ztxSpxyEed25x8y2vnI+Uiedf7pfCJ7nU+dT2W/M5i2VA7oh/XD+FyZ/6+4Yj41BbhT8qVIfiWT5NfyB1krz8or8qS8KkelT47J+zIgp1VY/mb+Y4N1WYp16dY/xhr9BGuksUaPykVYo+0yBqvr6mX6p/qX+re0f6R79CqsnhIFdeAxcaKf1k/D84x+Thz9vN4vo/4L5YbE1wAAeNrdmHt0V8URx7+7M/sLiSFIiIoUYkBEQUREBHkGkERMQoghBgSMhEdACAmS8JCipbwF5BFCiA+QYggQkcaAEJD6iOEhIuVgD8dSpZVTMVJEtBQrPujc+V0pUDz1j9g/evbsZx93cu/uzOzs/AIDIMycDmsH2zs+KQ0R2Zn5OWgHlnmcP4+60oSjIZqjLboiFRkYg0mYgUV4Bj0Q1jM+MQZDew6Ki8GMe3qmxaDknlTh7sSeg2JQ07dfUowJS0lKjDGtU/v1jTHJaSJjxqelykyB/34j9XrchDvQDf3xMMZiMmZiMZ7V5xGwUhuhhaypO/ogDUORjSmYhSV4zpcg1MMvcDPuRCzuwwPIxDg8htlYipW+BONqNMYtaC9rTkA6hiEHUzEHBVjlSzjURxO0xF3oiUQMwHDk4peYi2V43pcIIBLRaIUO6IUkDMQIjMc0zEMhVvsSIWiAG3ArOuIe9MWDGIlH8TiexHL8xpeogyjEoDXuRm8kYxCyMAFPYD6KsMaXCMU1aIrb0Alx6IfBGIU8/AoLsAIv+BJhuBbN0AadEY8UDMFo5GM6FqIYJb7EVbgON+J2dMG9uB8P4RFMxK/xFJ7GWpRmZmbn03HlKeVZ5fceOaCMUF6rjFa2ULZRdlB2H+4xXpmsTFdmKLOUOcpJyieUc5SLlEXKVcMz80ZyqXKjskJZqXxNWa3cpzyoPKz8QHlMWTMi+5FRfEp5RnnOo4MyoAxXRiobKqOVzZWtlG1H5OSOcx2UXZW9lH2Uyco05SDlUGWWMls5QTkla0LmcPeEcp6yQPmcslRZrtyhrFYeUL6vPKY8mZ07PNudVX7rMWCVdZQRyihlI2WMsoWydc7EcRMC7ZR3K7sreysTlCnKdOUQ5TDlaGWOMj9XmsBU5XTlHOVCZYGyWLlKWaIsU5Yrtyp35opuAlXKfcpDyiPKY8oTyi+V5zyGWGWYMlLZKG/isLyQZspblG2U7ZWdlT2U8cokZapyoDJDOSJv4vi8kDHK8cpJymnKGcp5ykXKQuUzytXKUuXGfNldSIWyUvmaslq5T3lQeVj5gfKYskZ5Snlm6sgJuSHnPNaBMqAMV0YqGyqjlc2VrZRtlR2UXSVmW6nmZ20bScz9+VojMax22LCWWK9WSHIT1Zeb5H/dM3IreKyjDFWGKQNKVoYonTJoaVJG1BKvrRVauWejfsbWSMZTO6xbS7ymlnh9LTBa8rB4yV7SJRfMkjxqkmQwcyQbK5Y8aD3KUYk3sBcHcQR/xUmcwbeGTbiJMtGmtWmvscPQ0aBfuZzgGKf89qTfnvDb03571m/PBFtTR73WmoBp5M80D3qwaeaP7/bbVL/1v2Tm+22p35b4b1pjtvi9neaA/67Dvswxv/1LsLW9gs/tLH9cFPxLW2zLtMe2wlbbw/ZEUM5NCcq5RTCBqSJhAvlCK2TJREfJbk/LKOuikQmkqkSGnNqZkuvOFg3PFS3WNRGmnrnabRKJtiLhadEG0gNDZJyuX2nszyUH+shcsj9nAla/21l8PEx83Dvv70r/nYt6NtAcEfQ7eo1epzfoTaqit6iadtFuqqFP+T6+XySiUY/20F56m/bRO7Sf3qUD9Hs6SKfpC+7CCdwf1p0Tmc20hV6hrbSNKmk77aBXaSedo294CD/EGSJzWGQ2UBm9SBvpJdpEv6Vyepkq6J/0NT/Ig3iwaOsP57d5lN8FJO37Uo/6d08TnRHruP2XzJRJPXDJTLHU6gszxu3QCCh7dmPl+SH6k8xtlHhnhe1oIT1Fi2gxLaGlVEDLqJCW0ycc4Cbcim/l1nwbt+HbuS3fwe34Tn6Yh3ImD+PhPIJHchaP4tH8CI/hsZzN4ziHc3k8P8oTOI/zXaqb7Ka4x9xU+VIZmtHHdJy+pL/TGfoHnaWv2DIxs+P6HMkNOIoHuiVujXvBlbi1rtStc+vdBlfmXnQb3Utus6t2u9xeWfl63Y1n2XBTX9oKEymslm8UwlIRrVAdFEjdcolW1l+ileBJrJS69yKZrVJLL5ORt7otruTCnHWr3RKZn35BzsrX3jYNPJ81Ueq1nkfPNQ1MOCrFe6M8//U83Fxt0+0A29F2sd1srI2zCTZZRj+1dLmsdPtJJfZHStxl5V5ZzaUl+acUWnFFn/6YPhFrF/9gb7V14BJr/7h3eb71g2f926/+w6vEW/6br7SSLKCV/u68/DdjOXaiCvtxCEfFMgGJAHvk/G6Q01AEJ9Fgr5zlMnpK+q/LuX9F9rdI+m9IBNgqO10s/TclFmyTPS+RfpVEhUrZ/VLpvyXxYbvooUD61RIpdohGlkl/l8SMV0U3hdLfLdFjp2hpufRrJI6ckxhwVvqf0hf0DX1NX8FyY24ClvgyRGLDMBmP5IFwEpESJJoM4jHSv5/7cwYP5vHigZvcGhhP7kKk6ymn4T3t7dWe5SRMFp+M8ur/oR9ewQtl9wYVqoOhcmvX4HPNCCMRh0S5x6ejSDzgPRw3oXLKPdlqj6o1g25eNkh/5nqiU6YZtEASy1P0OcK4D/dBOKdwiuQpVqx28bNO3EmeeRJ1VSJC3/iRyJmgnI6LdbyZdmr+ZWTtFX72yZinbYJ4preK3h75OmE7+fuZNItm0xyaS/PoSZpPC+gInefr+AaO4abcjG/km7gF38y3cEtuz3dxR1lPN+7OsdyDe3Mcx8vKEjmJ+3Iy95P1pXIaP8ADuMpludFunGYmzeiP9CGdoL/RSfrM2xV9R98z2HAI1+FQDuNYN8sVuuWuyK1wxe5p94x71j3nVrrnJTJWuDddlduja9+gGpxBCz0t2X42RTbb36ZJzjDWzpV8YZ3dhKa23G5DS0/exnr7vyDX35cjlYtRiQSRsCLxgEiMtfskc/fGHe0Af9xUvysxWv+X5+UhkVKM2DtOdZoozzKkOPGHoXKDZEkJET+YLjfKPCmh4hFFcoIqpFwlvrFfMtpD4iF1cVxKPfGgGvlt8bmU+ibUhCLS82A08LwUUbqua3QdjSWOLMQ0tfDjos8jmCs6/RBP0kfiC/NFu59hAX3HBotFq2EoFAveiGKxXkus9CyHNWK7jijxrIe1Yr0eWCcWjMd6sV8/vCiWS0W5Zz28LPYbgM1cxVXYInbMwitiy9HYqvbcJraahe1irZXY4VkIb4mNKrDLsxN2uz1iK+8GjLyid4n1xbs6if/04RQ9I1bOhdy1oqmgfhOkGNWdFU0dEmt5GmHViFONBFQjdVUX4/4FdBrjzHjaY2BmimD8wsDKwMDUxRTBwMDgDaEZ4xiMGG2AotxsnCBJBhYHBqZ2JgYLRgYocA5xcWI4wMD7/z/z8n/fGRiYlzNyJjAwzAfJMQkwbQJSCgzMAH3DDot42s3aebjPVfc38L32XuuQeR5z9ud7TvsghQYqpaQUEhLNhUQqFQkh0jypaKLuxru74W7S3J1muSsNGhRlOjiaqIiiEn5rfd+f+t2/57qe53qu6/nncV0vn+M45+v73d/PXuu99uGcE+dccM7vpld2rm49R85+7aGfpeLng6tR/HwJ/aqf38Vtta8v/vrz+n/+FcIXYWVYygXuK6eHyvBj2BA+4f5hMbuwLKwOl4XLwxXhynBVuDpcE64N14Xrw+dhFR/OB3DXsFyG6vOq5+q7pq6lS67CtXPt3QHuQNfVHeYOd73dce4Ed6I71Q1zI91Yd6Gb6Ca5S8L34dPwg4wKVfI3d4271d3m/ubudf90j7o57hn3mnvTzXfvuffdp26lW+VWu6/c9+4n94fbTp4CVQ/rZHBYz530+Vd3tVwjt6vr5fq6Ue5ad4O73k13M90MN9vd5x5yD7h/uOfcS+4F96L7xC1yS9znbrFb7ja5Le5n94ucKyM5chsZET6TYW69DJcz5Ey5Ve7gPq6OG8CH8ADuwQdzWz6Sj+bjeaBfyt2oITXyfd3NbmlYEb7kI3gQ78b76ltUjauHJdxc34fabqAb5FaEHWE71+LaXIfr8n48j0rclDCby3kXrkH1qYGcFxZxPa7J/Vw1F/X9zlyZ6+j2dvu4Tu4od7S+wn7uLHeOO9c9K7PlPrlbbpM75V6ZJXfJPXK741rfO0ej9Wao5kbrv9pBV38qTaWbaadv6ffzc/0r/h2/wK8IHKqHWqFuaBRah86he+gRJoRJYUq4RN/T6WFGuD/8MzwWngxPhQX6vm/W59uQG3NzbqHPtgPvw530He/Ch/FE6VB6ZenmWC3WjY1jq9g6doj7xUNij3h0PD6eGE+Op8bB8cx4fhwTx8ZxcUKcGCfHKfHqeFOcFe+ND8c58bk4P34UF8VlsTJWxQ3x57gjq57VzBpnTbMWWWlWllVkHbMu2eFZ72x0NjG7JLs2uzF7PJuTzc1eLTQsNCmUFdoXBhZOKwwu3FH4uvBdYV2ZL6tb1qCscVmLstKytmXtynqWDS0bXu7L65UXytuUtytfmEIalaala9Kt6d70QHoszUnPpLnplTQ/vZPeTx+lRWlJWpYq0+q0Nn2V1qcNaXPaWpFVHFTRraJ7xZCKYRUjKs5pfX+7aqvCNr9j586d+u7U1neso+vi7tMV/8M30xV/SVf8bV3xL4ILJaGGrnjDUBE6FVd8tK745DBVd9T0cGOYGR4Ij4bHw5zwdHgvbAw/653QiJvoirfU+6kj78uddcUP1L12Xem00k3RxeqxXmwWs9gmdoz7x26xZ+z/14oPiSPj6HhBvDCOjxfFSfHiOC1eE2fE2fG++Eh8Kr4Q344fx8VxRVwV18ZNcUtWTVe8ga54s2zXLCuu+AH5il+YTcqmZdcVV/yl/1jxYwuDdMVn6Ip/k694fV3x5n+t+JCyM4ornpVXFFfcpVppTLo0XZtuS/elR9Pjf63422lBWpg+Tp+nL9PytCqt0RX/Rld8Y/pZV7zLXys+vOJsXXFZ5baRrfjOX7RkDbDC5W+233dco3/WCugX/FnQ/IT8ep4fpZdqO4t/3vGOemjHgzse39nNuZ0tVF3nttfYXmt7ne31ttfXj8duH7d9wvaJ2yf9+Uhrq1UNW1uvauTa6lVD1tbVj+tWDV67S9XxVcdVDaoaqB/1r7q36rmqV6o+qVpR9U3VL1Wz1mysemjNtqolVS3xCFXFx6q6In+8emv136z6sGpL8bNPr41VH1cNrJqtj3i8/rmrmlA1Vn8/a+3xawet7bH2wDU91/Re08W5NXetmV119Zqj1vTQj8tVYU2LNY1Xf2+Ps+a81UcUrz1XP4J/p7JEcWW/yl567VN5ROVhlV1X/m5/s3KpWrly1cqllYXKVpV1Vs6trLHy1cp9KltUNq1ssvK3lVtXblm5eflXzqUFJfUkWo+h89R1voGu8wfhU/198Z/CqvBt0OegPWNj2FRsJhuLv/8e/tBaWPLnOrLPtf/vtsMn/cfHI/jjkhYlu7n/h1+yTjaV1HGupLSkjf6+e0m3ksPt8yX9i78PKDnuf359SR81sPjRCf/rY5X0/o+PB8Cf31XS939c+5YMrNZIb7KO+Ptq3f77O6sdZH/6z8/8739Vy/6v+/H/N72Xm2vn087JGbeVITJC7pAzqKF2wCOYtIverX11gHaS9+RWPlKGhUUyK7xLjbQ/3h3uDPeEFdojRXtW7WIHr6M9vEy7eNRq2invf820p/cr9sCBri8f5QZoD7ROOMpNdse79drpr9VeP1O7/QztxLO1199X7PYvab+3bn+X9vsl2vE/126/mPdzS7Xjb7KeT+wqtQ/XcDe6Enedq+lucg3c7a6xu8M1cXe6hm6Wa+7udi3cPa7cPexauftdwT3odnOPuFL3d9fGPe5au8fc7u5J19Y94fZ0T2see8rt7151nd3Lbi/3vNvPveL2dc9qN56rveENd5Cb595yB7t/u27uHXeIe9sd6t513d0C18N94I50H7kj3EL3oevpPnbHuC9dH/eZ6+++sAThTnJr3ClurTvZVbnT3NduqPvODXHfusHuGzfCbXDD3Y/uDPeDu8Btc+e7X93ZbrMb435352kWHO1+c+PdTncxiZviptEu7jKq6S6lGq6uu8Ud65a50906d6bbKLfITM0Xt+fp4h5NGnfJtTJVLpOb5Hq5RK6Rq2W6XCfT5HK5Uq6QS+VGucGf4Df4E/1GuVim+JP8T9zEd5Zn5Dnfjxv7/v4YP8AP9IP8136t/85/5b/16/w3fr0f4rf5P/xQf7of5rf7Hf53f7L/xZ/it/hT/VZ/mv/VD/a/+TNCkMl+eGA/wp8ZJJT4kf4sfzaVUTkdRaV0GHWnHnQEHUnd6FDqSe2oDXWig6gz7UcH0P7UhQ6kg+kQ6kqHUy/qTa/TGzSP3qS3aD69Q+/S2/QhfUqL6DF6nD6jh+kDep8W0kf0MS2g9+gTeo6eptfo39SHPqejaTH1pSXUj76g/vQlHUNLaQAto2NpOQ2kFTSIVtJxVEnH0yo6gVZTW3qG7ve70999O4r0CJ1Ia+gkqqKTaS2dQl/RqfQ1nUbf0GD6lobQdzSU1vmOfi86nb6nM+gHGk4/0gjaQGfSRhpJP9FZtMnv7fehs2kznUM/0yj6hc6jrXQ+/arZbwz9ThfQNhpLf9CFtJ3G0Q4aTztpgnf0G13kiSZ67/f1nWiSDzTZM13shab4Eprqq9ElvjpN87vQpb4GXeZr0uW+Fl3ha9OVvg5d5evS1b4eXePr07W+gfaBhnS9b0TTfWO6wTehG31Tusk3oxm+Oc30Lehm35Ju8bvSrb4V3eZL6XYfaZbPaLYv0B2+jO705fQ3vxvd5RPd7SvoHt+a7vVt6D7flobRejqXtlBz34Ga+j2pid+Dmvn27iIiN87tcBO0GU2laqGB5qnGmmKbhPoh+nF+vB/rL/QT5IUwTZ6Xt+SNsG/YR/PW3uFgf5W/2s/wM/3N8i+ZK6+EXqGvf9A/5B/w/5CX5GV5NRwfTgjDwkj/gn/RP+ef93PkNXld3gzjwoVhfBgbLvFP+Cf9G/5NP0/myYthpyX68Ecx09fU6eG88Bkfy735QO2BP1FjPoZ7cRfti99xa048mcfxBJ7IU3gqX8zj+SKepDNET811g7gPH1ScLLrzoXKhXCDj+GNpxp9Igd+RurKLNOUFUluqSRN+V46SHpLxe9JLDpNSXijHyOFSQ/pKPektu/FH0l+6S3U5WupITynnD6RCDpBaUiIHSVtpzB9Ka+kiR8qh0lV2l1b8vrSRA6WfdJOa0kf2kEMkyf5SX46Qg6WdlElHaSB7SUOu4iW8nr/nSv6cP+MveB1/xyt5GS/lL3k5r+A1/Ckv4sX8DX/Lq/kr/ppX8Y/8A6+VDtJe9pR9pLN0kr2luewqLaWR7Cv7SQuJfBPP4tv5Nr6Vb+GbeSbP5n/wg/wQz+D5/G9+i9/m53keP8Iv8MP8FD/Jc/hKvpyv0D5ho+9neaN8uZi+QdOFy3I29xYgfKHXMggr9VoOQXOQ2w3YvjYBW1evADldr60hVOpVc4XWe007et0dwid6bQfcvziXF1k+0r5QxPZk20NYptcOEFbr1XLDAfrxZXrtAuFzvR4IYZVeDwK2PNMVWL9Hu0kR2+cOgbBcr91A04HTLgP2JLqrw1Q9dXiuqeqRs8xqSfLIfD165uz19crZ6+ids+dwVM6eb5+cPR+bW/vm/16/nH1P/5ylsWOUJSvLX8fmTlUDc8PUoNzI/Hs0J2uSwfecqCaqk3KXqJPBUqn2zCLLrMXHVeEHvZ4GYtPBYAhVeh0CmoqcG5rT6cKdnj+XW9UZOfua4bl71Qh1pvpn/lzNHHVW7hl1du41dU7uTTUqN1+dqzRva/5y2svBnv/onN3DY9QFalW+FkYTu+Y7sNc+LveTGq9sBtJM7i7CmpHtl0lA1fU6GcI6vV4MYmszBcJ6vU6F4qnLfcDN9Xo/hC/1+nfgqNcHgG3f/APY9ueDwLqXNLMVia39wyC2lo+A3JGvqRJb90eBGur1MeBqen0c2O7fJ4DtpOxJkOH5+6Hkbr0+BWLv09PAA/L36Vl9LTZNPgdi7/vzwLY3XgCxe+JFCIv0+i+QWXp9CcK7ep0LpHOCexnY1vwVCPZ8XoVwZ35/qHCPXl8HTctOUyTskt83xs4H5+VsHd7K1c7vp/nFEzKnuROsgr6d02lJsyjYc3s3Z/VyQW7X/F58X9l7+kHO7oEPc1bDFqqP1N7q41wz9UmuV34ff5rXgkU5qx2f5axmfJ6z/b84Z3VkCbB9/Rc5e7++zNm+WZqz/WZ1dnm+x1bkJuf7Z2VeRypz6/O9ZG5Qq3PX2lCdu94G9txMG+Vz0/O9Z2aor3N2NvFNbrb6Nmf3+3c520Pr8n//gXzffp/fOz/k7B60frMhv+825u7K9/ZP+fpuytk6bc7Z+v6cszX9JWfrsiVn67sVdEJy7tecreNvOfu633P2b2zLa4k97nYg6y87cramO0GnrOKBdfHQuoZeCXTyKtagYh2yrwmg01jxsYqPV1OvAjqh4bHsTKGBXquBTm3F+lWsYY31ugvoJOeoBuhM56gm6HTnqBbonOeoNujE56gO6OznqC7oFOioHug86Kg+6GToqAFYnrB6VKxJD2OfF/d6K702BquP1AQsl1BTsDpIzcCyCDUHq33UAnTmdNQSrLbSrmB5hFqB1T4qBcsrFMHqI2VgeYUKYDWRysAyDZWD1U3aDSy7UAKrj1QBlm+oNVgNpTag86+jtmC1jHYHnYkdtQOrfbQH6JzsaE+w2krtQWdnRx3A6iN1BJ2nHe0FVqNpb7AsRftAsc7uC5alqBNY3aTOYFmK7N/YH3WTDgDLUtQFrFbSgWBZig4Cq5XUFSxv0cFg9ZQOActb1A2sntKhYPmLclZb6TCw7EWHg9VW6gGWw+gIsNpKR4JlNOoJVnepF1gtpt5guY2OAqvF1Acsc9HRYHWT+oLlNuoHVoupP1hWo2PAai4NAMtkdCxYbaWBYDmMBoHVTToOLIfR8WB1k04Ay2p0IlhtpZPA8hmdDFZP6RSwTEangtVQOg0st9FgsDpLQ8CyHQ0Fq8V0Olheo2FgtZXOAMtzlLO6SyPAMh+dCVaXaSRYDqOzwOoinQ2W2+gcsHpKo8DyH50LVqOLZ6vnIdPR+WB1lkaDZUEaA1aj6QKwLEhjwWo0XQiW9WgcFOvveLA8RxNyVlMvAst2NBHcNL1OylkdnQxOZxO6OGd1dAq4S/U6NWe19mZgqx9/gLM6uh3cLXrdAZb1aSdYr/bNwLK2bw7WG30LsGztW4L1P78fWDbyL4Ho4/u5INqj/Ssgujd9TrQX+3dAbsdPDYzo8/ZfgNym1y9BtF/4pSCa8/0yEK3/fjmI9nG/AuQujJ9GND8EAtE1Ch7kMjvkBdG+FhhEM0YoAdFZJlQDsZ9wVAe5Gj/tMKLZI9QE0b4ZaoHo+xjqglyl14Ygl+u1EciVeq0AuUKvrUH0PQ2dQLRHh84gmotCdxCt+aEHiPaFMBq87ucwBrzuqXABeN3bYSx4fe+C3qdB70/R+ymMB697PkwAr5kmTMrZ87G5RO83r9kjTAXWPhouAW/P8QoQze/hShDNTuEq8FrXwtXA2o+Dramumdf6FqaD13sy2GvW98RrLQszwGv9CXo/hftxzwXNakHnEa81NugsErTHeq1xQXtw0L7q7Scic8BrrQtPgdd6FZ7GbOE1T4f3wGt2DO+D/9Z+ygJe7//wIXitXWEheM2L4SPwWuPCxziH8Nsw6wat334ozhHsHMLr3gtLwP+OMxHjT8bMZvwvOBMx/hScUxi/BWcKxp+KOcT4rThPMf40nI8Y/yvOLIwfjDMO43/Dz4aC1jyvez78DF7ravglZ3tiC4i951vBay0Ov+Zsr9hj6evwWpeDvWatM0FrWrDXqY/tR+K4w+Y/yzd//vTJeiEHsJzEDNaDWcB6s/3cyuYz68GsdZBroJdzTbC+y7XAMg3XBstAXAcsc3BdsNzAmh+5IfIcN8I9aJnM7mOboS1vcQuwzMRa57gcOcnqKSdkF64AyyvcGizH2Ixt87RlF7bvb4dcwnuA5RXeEyxn2E/iuANyA2u2YstPNqvvi/me9P7mzjhnIpuluwBp7mLNRGzZ5XmcSbHlldcxexuahznZkM6obOtlGUXnUu6NGY60/nIfIK3LfDTQhziDY8sin+JMjS1/PIb53JDe33wskOZtHgike4YHAeleYt2TbDlD9wyfiJ84ku49PhlI9wyfAqS1gk8FsrOA04B0DufBQJoJeQhYluKhQLrP+HSwXMXDgHTv8RlgGYuHA9kcOwIsb/GZQLoneSRY9uKzgHR/8tlgOYzPAdK9yqPAMhmfC6T7ls8Dy2d8PpDuYR4NltV4DJDuZ74ALLfxWCDd23whWIbjcUC6z3k8WJ7jCUC65/kisGzHE4F0//N1YLMBXw+ktZqnA2lt5RvA2/17I5CdJd0E3vbaDLDZhmcC6azEN4PlSL4FSPMn3wqWKfk2IM2ZfDtYvuRZQFqreTZY1uQ7gLQ+851guZP/BqR9ge8Cy6B8N5DWar4HLI/yvUBa2/k+sGzK9wNpX+C/g+VUfgBI6z/bmZnOiN726ENg+ZUfBtJew4+A5Vf+J5BmVH4ULMvyY0CaaflxsFzLTwBpv+YnwTIuzwHSms1PgeVdfhpIezQ/A5Z9+Vkg7dFse0lrg9fZjF8Ay8T8IpD2AP4XWD7ml4C0H/BcsKzMLwNpb+BXwLIyvwpkZxavgeVmfh3s/8Gxznv8JjI0zwPSnsFvgWVong+kPYT/DZan+W2w/MrvgGVrfhcsy/ICsJzN74HlWn4fLHPzB2AZlz8Ey9+8EOzogz8C0p7GH4Plcv4EvPYw/hQso/Mi8NbTrA5q7fFWsxeDZXdeAt563RdgOZ6/BG99bylYpudl4K0HLgfL97wCvPXDlWBZnyvBazblVUCaw3g1eO2dvAZIsyhXgbdeuhZIcx1/BV77K38NpNmYvwFv/fZbIM2u/B14673rgDTz8Xrw1oe/B9L8xz+At578I5BmQd4A3vrzRiDLhT+Bt169CUhzIm8GX1+vPwNptudfwP5nDG8Bsjq3Fbz2e/4VyGreb+Ct//8OZPVvG3jNBPwHkNXC7eAtI+wAsrq4E3xTHP8a0vooBDZHiQfSWikBbKYSBtK6KQI2X0kJ2Pwm1cBmLakOpPVUdgG/q15rAGltlZrgW+m1FpDWWakNXrOW1AHSmit1wWsNl3pAWn+lPnjNRdIASGuxNARf0GsjIK3L0hi8ZjxpAqQ1WpqC1/wkzYC0XktzsP9LKy2AtHZLS/CasWRXIK3j0gq8zUilQFrTJYK3eSkD0vouBfCaxaQMSGu9lIPX3ie7gZ07SALSe1cqwM4FpDWQ5eA2YGeC0ha85jbZHewMUdqB12wne4CdM8qe4O1z7cHOGaUDeP1z6TSwnwuVXgp2Plt6GdjPkEovBzvbLb0C7OdJpVeCHeeWbgL7+VDpZrDzWTuCjPkcG/U+iva+a82P+p5Hm8N07aI+p2jrrM8j2p9tFtXXHI09T92DUftftNnrEL1q3o169fqeRs3l0WZRzVFRc2bU/OW1L0bNT1GzSdA8EHNee1g8Gbz2sHgqeO1hcTB47WFRe3PUHhi0r0XteVF7i9deFbWXxDGYq6P2jzgW83PU3hB1nYI9R6370eZYzb5R1zRqzQ6aqaLW5Wgzjfb3qDU3TsGcHO0121yq72O012k5x75P922chdk76h6IdvagezDq/RQfxpwctedHmzG1n0V7bTZb6p6Jz0DQ9Y3Pgs388TkIem/EFyDofosvQtA3K9rrtPMUfT1R+3DU/uv1dcZXwP5vZXwVxB7jNQj2Ol4H0d4f3wCx5/YmiH1uHgTtWfEtCDp7xPlg5w7xbQiaH+I7EHSWidp7o83OWsOj9ttoM7Kt04cg9twXgthz/wjEnrv21ah9M+j8ERdD0JkkLoGg+Txqn4zWHzVvRe2N0Xqi5rC4AkTXJa4E0XWJlSC2HtoDo/a4oBksan+LNtPr/Re/hqD7PX4Dwe4p7WnRepmtofaxaP3L3p/vwev7GrV3Re1ZYmu8AcTWchPYGUrcDHamEn8GO0+JW8DOXOJWsLOSqL0oWg/SzBe1/0TtNd7el+0g9v7sANF7ItN9m1k/1/szqwk2o2YNwObtrCEE/Z6sEdgsnjUGm8+zphB0bTLd71kLzMmZ1tqsFWbprBRsxs60DmRWT7UeZmVg5xpZBdhZRtYRbFbMdE7NumBezw6HoPsm6w1Bs0g2GoLeT5muVzYRZy7ZJLB5MpsMNqdmF4PNu5nu12wqzjCyS8B+rpPpfZ/ZOZ/eA9l1YPNqdj3Y3JtNB5ufM+3rmZ0x6fufPQ4252dzgO21vgQ222dzweb/7FWw+b/QEERzdaEJiNbVQhmI1q9CexCtYwV9bQU709KaWdB6VLAzG60phcEQtJ8WZgDr6y/MBJv3CjeDzXiFW8DmuoL2/oLNVLo2hduBdb0Ks8Dmw8JssJmwcAewrnXha2DtMQXdEwXLdrqmhXUgWhvLPNi5QFldsDm/rD6w7q+yBmBnDGWNgbU/lDUHO8MoawF2LlBWCqz9o6wt2FlGWTtg7SdlPcHOQsqGgJ1TlA0FPkivZ4CdfZQNB9YaVe5B9D4rrwd2DlGeAXfXawH4UL1WgOj9WN4aRHtLeRsQXf/ydiC6l8sXgoz/678sFWeGRGBZJ3mw+SEFsFySaoHNM6k2WA5LdcCyXaoLlp9SPbA5J9UHy3OpAVhGTA3BsldqBDYjpcYgR+m1CYiuVWoKlplSM7DZKTUH0f2SWoDo+5JagmWvtCvY7JRageheS6UguudTBMumKQPR2p4KYFkzlYHoHk/lYJks5WweSwlEc0SqANH3LrUGy8SpDYjen6ktWMZNu4PoPZTageW/tAfYTJj2BMt8qT2I1rDUASxDp45guTztBaL3XtobLAumfcBycNoXbM5MncByZOoMovUn7Qei+STtD6L3YToApKteu4Dly3QgWA5OB4HNt6krWDZNB4PY1x4CojU5dQOx66Fgc0LqDqJ7Kh0GllnT4SD2GD3A8nE6AsSe75Fgc0LqCWJ/3wvEnktvsEycjgLL4qkPiK3r0WAzRuoLYmvcD2zeSP3BZtd0DNhcnQaoYzFzpoFg83AaBDaTp+PAZvR0PNgcnk4Am13TiWAzbToJbMZOJ4PN5OkUsFk9nQo2wyet32kwZvU0BGzeTlqf0uk4L0jDwM4FktaqNBxzdRoBNqsn7RNpJObwdBbYPJ/OBpuZ0zlgs3QaBTbDpzFgs0S6AGzGSGPBZo90IYjdp+NA7H4cD2L36QQQu68vApvT0kSweSxNApvT0mSwOTBdDGL3/hQQu8engs146RKwmS1NAztPTDrrJJvvNX+na8HOAdN1YOeD6Xqwc8M0Hew8Md0Ads6YbgQ7f0w3gZ1Lphlg54nJ/nwLzvPSrWDnmMke916cMybN9ukBnE2kR9VjOHdImhHSEzirSk+CnWGlOWBnVekZsDOCNBfsXCC9AnZekOaDnREk+553cE6WFoCd2aX3wM7L0vtgZ4tpIdhZXvoI7PwxWe9ZhHPG9DnYWWGye24JzhOT3a/LcPaX7H6txFlesvtsNc77kt27a3FOkb4CO79Idr+uxzlL2gB2vpk0h6XNOENJmnnTVpxLVmQguj8rtIZVaL0S3Z8V3UB0H1Z0B9F9WDEERPdhxTAQ3YcVulcqdI+I7sMK3QcVev+L7r3W9wPrDNJOgHUGbqc1up2dh12e/1cy67m6ptt0rbd5/J+hHTuBSx1trlfk5Pz/AsWGVBgAeNq0vQlgHMWVMNxVPTM9I42kuUfSaEYa9Ry6JWskjW617vuw7pHkQ5YP2fiQbdkGG9uAMWAwAQIYO8YQjpgjB+DcmwtykmyyISGbe5MsgSSbkysJH8Gt/1VVd8+Msdnsfv8HkYLe9HS9evXq3fWK03Ez8sNI1mVzPCdwQW4VlyallIa9JoMOcbqKYmT1W/V+qx8bxPxQdXVNTXVVSMwX6F9VNZFKl9NhEJwG5b8IFMnyHNopfxNF781IScmoDmWLXrdgSE1ryG+MlFY2OjIyHORHl/32Lfqrq95+FX07LS11nPcX+gOpfFqK3SFFquuF0l54yuJ0WjgOc0b4NYIvAIYp3CqpzIR0CPUZkE6PeE7Hb+AQquvHiOPquQEjPGtMMabAs4LVahWM7uKoINojdjEc5vmnKg78/M6fH6rIXFg4fx5fuDh0fgZNy49zKytsDP5+Lp/TcfCf+ofhdxx+kwZ/ZCURflaDn096/rAGfyzp+Qc0+BNJ8EUN/mECJ3NesdE5u7lsblFKz0IGXQbisQFxPN/X/7R7ZFrKFZCBw7wBb+B0urp+oAZf3w9fRrNAkWY04JFy4k8AmEPr4g/yAzEpIzMzMzszG+jkEkWjMbtYZ3A6IpVRdX2jYZHRLhWjFyO1Obkpfm9DX2dH0d8oHWtvW1jIqc6rEAaFhopIj+duSlIYhpA0PrfntLl9JGnOxzX4R9mcV96EX2thzhmcjeuWOqwIwzoDZ+qMvG4+BRlNSNAbhXkOYxSji87p9VzMwFbeAqxisVls8O0MK/sn1eihq+8XRHfESX8IF9xZuPdZdEPaj0uf+mDZI//ItbYOPfYYvjD54uR/TD42hdbLHwQcGS6UH9IZP9QRHHluNfxRADimw8rkcuVSSSrS8QxLPa9bILjNarjNchQ1f8Bf5PcbgMABgyhalW3jcjlxSBSdkcqaahf7j2pccHrft76w83290Y6Ze1qaxmYa6j090oa1J+fm8IXVaxsHzebBIbS57Burql+v/vUOWNOqlTewhJ/lsrgqaRVsAj6dh98ZQDq+jyA8q4PVbu0HlPAsINeGBwCaxWUGAgE9bA7O5RZgR8O6uwCPqJusPFn6mgh6cn1JY8vI+LbFqcpusXb8xtjJ4dUnJ/Cz+YGeyPW33nJ9bk736NjDe5YeHidrSvGg9LIyeklsrRn8tAZ/lMAp3iaKdzF3reTxAA3DOVivK0AGfTHCBhOgawROMgCrpwOrixxwvgEvwhfhf4SN+VmOzkuvN8xyBkObAdg9wJ5CS+/1WExKcQQCYXsgIAB76BS5FY7C/IlwiyrTr7yUMIITPbZqoC633uHLz6srLjXuOQHk6Egi0tCh+lWBitp0c7015LastX/mNFAngV5DusI4Tc5qNDmfRKuTGvzxZiYLuuHXKuA5I2fhcqWcBB7j+QQe8+uMmXEOC4Xof1jxqk/d9sQDpz51cMuE1Pq5M2fwhbu+es/ixRWkp+8mArYR3m3mMrlGqU4PxEdIwGieEs8IzFPXD/tOUMdJS+O4tMw0N9DNbrPA11Kt1kAK5SRCSdEqVkesEZu1inK0E37Q8U8DBm1tD3wfMLjzzlZ84f1f+eoZVD+Eii6eR/p7Fr839BKbP50n5RU345XXGFzFEQOOZGF3w98u+DuVK5RCBII5wFev18WofAP68DGOyjgqBixk59kJLn4n6DLB/8rbb6NV8ix6ME1+Cd069bNpfGGajEPfS3nYw3jYycZn8Js0+COORPhpDf5o0vNnNfj5JPhhDf6YPRF+UoM/ngR/QIM/kQRf1OAftrM9tRt0BqFLDrfvk7CDOKQoikLOwAlGg5BAIxMCTRnjiejUZEMzhj0U0p5FHEZ43WW/wsEuIiyaw+UQAjvFgDXFmFMcdIqGSzSISOhN+QC72js1HVJe8RdK/bffnp7WVEhxSxYsxAtTPyNzOQoTC8NcTJwo5WlrDDxJVpaucT2my2vRG7OK7WRl6VhvIJ38zjJ63Cz/GB2Zln9Klpa8Lwh7KwTyxsu1Ss2EOClgRTgR5rORHuv6QBPxWMfDrBHl9FYygn7WgPT6Nj0RmV6Yqi0QDAowmitBRGgyIlothiNWg0H8zN2rT4y1rytuzWstGNmyelyq3Gd+vXpXR9qnn97z8Gi4sN3ruf7W9x31fjEmP+Pzk/WkuFH+CjH+8rJ1ZvCzGvy8T4HLP6BzYXBefyPel/D8Se35x72ML8i+stL94pd8oKk4sJvmdQhjYgsgVI8S9gmCHWyN0H9FdO6l5WX4H6qXv44vyL9FWReHiMzA8GsS3meHfVojRUwC1qfoMJeq5+ZhDIxS8bwRGQx1/Tx7OxMWilK2WsxGLxuG/lsdqY446Y8AwgJPdi//Yrmb/vrcL36B3pYNqEH+Gnq7fwf8079BkxNWSpfiuO0F85yDX+/QeQLPgAHL6WPAvgwNHIuzjDbTiNMP0kqs9qN3Tp2S1586hT6IZy6uxGIYTcP7UlY2Yy+8z8EVSEGHHePu93qpg7xUByayNeHFABXCKGcx/MNO+dWZGWw//S/pDS2bBtETF98cG8PmMZm/7WOuMbauFH8qf8qSbFAGv0mDqzYog5/V4OeTnj+swR9Lev6kBn88Cf6ABn8iCb6owZltCnResVE653BbP5lKjTQmZ0STERsMQowTBMJZ8GhMRziASmSiiJt5kDB5wD885tdd4WGUJFuIaKGyBQFN3y1dGJGdaPOpU4nC5T5tJROFC1nV6fi8jmvz+qgyr8aVN+i8LESvgBrEgBbCfao+qetXpUMbN2C1B/KJvg0S8wGsB2IlVDNWOnx0x1R5uCvQ2v9d1P6nHbdLvVnO8UG0LUbGhjGwma5ZHVuzCNPxIKXwGIzNg8QLASXBjAH5TbwaYDUdpoQB10bQg6DieKve6Cwme9Qe4ZHITy+/ed1rSHfb34kBDjv16/ItaDdbw2mQFeS9+VwDlRV34s10rlfDeH6A67ksycWRUYgamFH52cKDSrdHiES9ei+qSZM3wqufmmfvrCHfpXzaxPj0JgZn73yWwYF6D0UQZ3wGoafR05Fi8jng4qe4NCm47En4ngJHvP4D3JPy05wJvvkZ+Wn4KsE3B54JwjNpXIlUaE5NMRn0Ot5IHQRiCfEgzbgZZqLA7zQuzWnVGV3FQcFfLYSjQKmoW3DiIEykunj98r0lz83PX/R31qMp+bU17Ve/TGmSBWO0qPvdZjLwiFj2ICxB6S3pqCmkuJk2q8tFFY9f5IETo7zIg4wTeOIt2SO45SoLz2/etEOH0hfDty2sPYlG2pqGy+Qy9P3INilPfgbWqBL9W6JsTue8UrYAa04Wnc2IjmR1Wu2Ez+wuJ5ErdjBPiWh+wLLlvp8Lpi334f5Hd8rfgMX5ZN+BEVR/cUiTj2R9Otj68FyC3DytwR9V4bAuVkr/DmVdmM7sXglReDZXKZU70jAGjxthkIHgW+gRsQkI2eu1bdHMDTitDluAujo6bV9UVxPqJGCPrVPDHdXFDq+zXvy5MpEbJwu6UlN66i6dj1fD+7iG90cR2zMh2EuVwG+pxBeL28Wtml0M+xT8HNUu1mIWcaVdU40rbz569Gbyc6Cjv7+js6+/45Nf/tL5R7/63PlbbrzxxM033ngLpREdi9K0L0k2M/hNGlyVzQx+VoOfT3r+sAZ/LOn5BzT4E0nwr2nwJ4sT4YsanMlmHuDvB7jIOcFiCXE9UqfTBmQJiJ5sHY9TBEzCB6DKUA+IX66bGAEKzUhUQCWaz+dy+UK+oMvryikMGGAfMes+Pwx7KcTI6IYNReSx2x4SbSQuFOZdEfRm881H8zy5sWA9/Iffkzsd/GlH6e0O10CH0/0+lwNvfWTHo182bMlaLn5ox6NfFbZl7S+78dZHGtHv9Bd/c+OJ8Z25sluvzO/9Cr1HL0Pv49q8ldgBxwN8HnjBxYncF/qftjGnkQPRyc+nmjDhUDJ7kHNG4Fxm2dXrBzz9Tzvg0dqkR4XZFPB4WvvZ92JMOmpf6ueMxvj3pYj2VWQyqd/kkr5HDAb6Nc0HjUmZbvBx3KI73+sBnMF6tcG/VjO4pJzbL4guEqwwCGBHqHxrUDm2CtiXWylCkbSfVwi3366rfUP+WmFgx9Zt26MVldW1q5xlYBumT7bdNXlP72TaJ5556rNTR+6+6+jR92/cX8NotR5+VcG+TuFs1LrWwWbXcQvAGtQPoKoA1I1fBG+JCDkO/Dqn4lVSpxK2TdWdh8f3fun4ndfcMz7RNYg27fobvrBj+w3yG1I/HSOmjGEGTiyVijgOCKbj9AswGBEhCwlWfFpamjPNkQ9+ZB6xru1KMJEO6bSyKYvfGT1+5x1HZpaX13T2D3Thlp079+25Fl/4lvxHabCrlc2rYGUMrwcesHO5XJEUJtEQ1GfQEwf6CqKhkIkGwQWmfBm+koRoHxycyr7KXTVUf831Nx85etM1rf39re29/a2/e7Awo3ewoK4z8IXzH/rKs4+dOHbjiVuOHTsBuEwAQr3K/IulAmAkPegSPUhVveJbcwn6hJDaaidikzMIdpGnRnge9eFpfAjnT3Z/9eaP9S8/i9Ku6ewZm+zoQg+vd8k/QDnyy/jC8401f6hvofuDjkv3TSxp3zD4aQ3+qAoH2d9LZX9Mkf2zVPbnwn4KAi2DBPtMxOMsgx70IVhDCpe0JlpDYomYz0jJpL7Cp2E1mKLFUlxuEvYKthwY/eBaaWipeXVWY+3e7U3bO26ba+qeq+30drZs3Hp8bdVcd099dW6R35q/djA6UT7W2VRW7Anl2n1rZxjeFD86zzVsnkIi/LQGf1TglPmY6HyiXIvUWAS8WJzp5nk9j8G4SwOtZgatpidhPAyTXFADSOD8zsJitephhkF7oIDF8ASn691ho39i1ldfVZEUQbp5/Iok2LFkKtIlxJJmU1a/B0W0eZ/V5n1epQesb5DaZGuU9Z2k9PDDQ7U0pu6RMjVfpq6fmVDERyLr6ScOGogjtGn5Bew2fwOPr13LJX0/g8RAdWSnUQ/dCL6g3hDjiPfHdjc8HY/ImkC+IRIOUDw/8nK06ciR5cOHyfvx+KcH5afRyOCn164F3OkYdC0X2Foqdrof1pKM7eHaJQnG5VPhVwo1SzhMmFSLABqQIn5B7AuYhoTgDR7OQ5CxB0IEH/9lVlOZthUNV6zqr8ttcOTm5dcVl6VkUirUJK7MFkKTix8htPYDrWvpXlpQaD1F8W2CtfEA3KbSmtJG3Tt20S4qngSV9WAgMcFjjWBP3fb+3YeXG1qkhn0vdW1vumEHekHumhwbm0T/wtaXvpvug8Wk/c7gN2lw1S5h8LMa/HzS84c1+GNJzz+gwZ9Ign9Ng6t2CYMvanDVZ2xasVEa+LnxTzlSMZHMzGnMBmcQVo1b0uuwwoBoTk1guNUPWf5iPXsGg4uYBhA/5xezRNiUmeAegqN9qXsYSiQm9oz1t1WoPmI4NLeJkhUs8YqJgy5PVS7zE0MNmWlH5hOorM3pOW1OH0miwXENrvqRGYrsN5D1NqC4I8cpwRbqXaEIeA0RO3px/89u/Nm1jzDX7eLnSdxNia+YiR8CVgtxQPpUSrC4DVL8ELAaVD+Evo36H+jvt3R03zq9VNN3oFNaRCsyghd/Eb0up+M2gjd9P+WZ5SSeYfCzGvx8EvywBld5g8Ef0OBPKPN3wh8dNA4DnmyKoEPEZegD+5PQACPFl4WPU202G8lC2N3RCG8nU7Dzjx2/+dCX/v36Mx849MKX8IW33pK/It+GgvLP0C7UDu9OhXcP0lg4+EtGPVBE85g4hSSUuiC5KDl4tHn5t9c98qGDv0UC+rD8WdQtTxLc6XsoDQ4yGmA2JwY/q8HPJ8EPa/DHUCL8AQ3+BGI0AG8b59D4JchHIxFSICMxcVYVQUv8Sapzmcdq4kxgABJiEJcV+UlUA+eY5WK0Tv4a+px8fv36GfT22lnZxMal76f4H2X4WxLhpzX4o9ZE+EkN/nhGYs7hCS3n8NTGRF/xCc3neiqcaH8/odnfTwUS9e4Tmv55qjhx3Ce0cZ+qYrZaLTzvxD7wUgq4LqndDQRyAW3yQDPrQTbqdX08cY4RBz4nTatRg6mjn9jdcTfFV+ALhwNiIEwMxwCJx4YNqsEcoblqgxCmFp3TUBOtVow69CebK3ss2ztVNbL22NX9jXU5faGcdTNbt32l1d480FVasuAVBlJaAsGZvrGZ/Mqy9LThwNzEHxsDefsiFUUldF4Uf74Y5nULndc9b3EJcLsGvzcJnqvBTyfBeQ1+Jgke1OBnE+H4zxr83FsqPfWUnmVcHdcndQeRTh9AvK4OCYYyu5XHghHkCjVwDAJvWIjng/WzoB47+jlBUBOEAULRQjFoNOYU61e9S6hekcIOlzscz5ihf8Qjct09nox3U9vmuo9SW2y1p2lxuqpejy3/Usr7vMKXCOUDeQm06dZo8GASzcwa/IOUNvzK2wCfA9oUchVcI7dRmvcjvSGUh3X6eksKsBmJYZIUQDpK4XQpCyQ/jYzcfJqJ2DKzZgEbDB39qcRGmiUBDyBR5aoicGlqa1Y1VjYWVRSVl5bAywsC+QExmG/PIE6c1SH4XUrqkNjEiUTTaOauIX6dEAE7X9AIF6oGZGVZqFyVXZJVntdVsjnib1vVObptsWQWLDJPf0u01WZpLS0p0D2KxJIfNVXl+zzFmSnYJ7/lyBkbtNnbsnOmygtm+sanxUVzRo9YFA4Vr+6eXD3w3VUVJeUFxWUNlF6MLpSH38942MB4KQbwXPwa6DEPdx1zkB0ZiOeyMrGOT0FIx/elp2Gux5MExio4xr7iVl2tjn4SLEKzREq3Ea3uiX9CbETlY45+CprdYrF4LNkFNI6UWWzTikvCYJBFrbYaheucrsjL/cWb1u/aOF1pWFh6uClak9/gLJDQ3wref+zaD7RW4ZfT5F/JB9bNb5wryv97E5PLYzC3NOAFN8mXp8PCZ4DkwZiWVaheYgcTzoqUgd9uziUGab48wJbzUgM/gu5rj4gbqq65pXnfyNahKqm1bWCgbbi0xyfee3j10V6pq2Td+rXTwKN0fN4PNL+XxkjvKfkbi3Su/I1GOjntGaf2zKlLn6HzMNF5FBF/JhuWJOjBel1RYYjHejV7ricOJ0b6uD+j+J0duoGASFLgNFB3xRR4QgacTFtworNJ/svCjsTZtrRHcifKEhPgazLuXIpPvrTHk8/y35fO7/QVaWDSnvnAu2iAubqVN9AK8KmFy+YWCC/qcKYb8zqerqYFlrNHYUXCYVS8dbAAgGI+ASsmfkKToTyfwIrgJWRbs0JB0cqMTDGcuPpWzGRjdUhEKwvG7IGyhY2RtdLqqoebdraVF7bgly/mtIYK7rl+9ZHuepQm/2jd/LMD/6dBxR17+XTOx5VwEakiGzgxDzwX3Ofz5hgF8LWxCfUQWxAkzkJi0KIoVEbjwWS9SAyOOi/xsg0QKqGwEObCiSGM/yxpcU+0dLc0zE42LPW3b2+p31BX3uv1znX1Izt2dxZVd7TXSZ34ert5JMPbV9PY9LXbx67rblga7Flqzs1dbusJyL8vyRNXD6+emF9L1ycT8L8Rvw7rc/aXJGb/EMrgIpzxGYyejrAFwtS26IX1cYOl/iGyPgLvz8RGMAiRke9zOrBeWZ98llcjur2OaCJF13NGI5MaYC96+p/2wpOhKzxJs0xGo6rCPFKAxJuAD0hO8oqPxWKSWcy3W23BfKvFpKQlwwkrXE2cVLczwjNiwlrj3uEFY+2aDRsr10qjVWfOLA1/qbipvnln6yo8fvEjrUNssZcGR9La5T82kAVnvNoGtHDDfnWBxVMn1egBNeIZYJp55nT8PJlSnBFVHnS73V53jt0RDPqJiVMT1yjqcjtB0dQwHfK54cZgu1gR3Bi95qb6nb1bD/Hywz0d+r/ixtr7Bt3ujtz8+44MH+25/ZDP8duhwf4Rso4UL6oDHmQ6QLEvGdyuwe9Ngudq8FNXgJ9OgvMa/MwV3v+BJHhQg59NhFO7h8HPmVS62ihdA1wxtyyZwdLmsm0mHiOs+Jch6lAhvERq4Tj4mVejOlT78HNqXlJ894M0Ublee15PauaCwWAx/FskFuZbSc1cIK7nL3FA46VETrYbBZiZ/LCerVJJQ0elah9NbdtH12sHrFRNh/4txyBZLtGWU614pf0lKffuo0uX3T8yNAiYTtH4y2vAT2skUMmcAVNuYnMGqQY+FxEdJGNnmIUZGRr6WUmMR8pSJ7iQ8JhaEgjPuzgnDY/QkkBOUQIkPa8EbWh12Ks9+ZHmqspn0h5duvrqyFwjfi13yFVQtHZM3oruG1tXOVDE1qd6pQBH8BhYpR3cWSm13IyREfWBWQpbfxWNvHOCSeBMS5zOoDfo9EtgfRHttZBCw+mwd+ky0ch5PanjiieSa670VRjWoMOGpFfEvxiTbPX19R317eHiKtEerA7ZUsnOhz2litIwXUdYN0UzhqojDpcS3RPjsQVCB1dNVKcF5kUc8fZGKipAB5R6Us2tc7XTq265LraleKO7PjrSFS2f7e715ZQX126UJjfVyT8Gj6Syagv6W4rgaiuvGikzGd1pBaH2ouGpYHetT7SGQ3lifYmn0pbVXRWdKEfZOccaKiMN9TVXsT1BaUv30JNsj76TCM/V4KffYbkhBm/kzFwXt5p7TsoQgGe6kAk1ZmE+hZSVkhVp5bAp1YRTlziDkVQCLXGcGSETB3RN4XhdCr+QhlJTTbOcydRB0hvGWZCo9UQYU1eimSRFWv7bd4DYMxp0xqR3xd8Qk/K7wQPtXt09Mtjf0RatqigrLgoH87yZLksGKTpzphudxRzZZNGIQJdJ///HAqLUoK2y2Zsd8KC0/8VS4gnRkxNc3Gf3ZwfW/S9W9TJr+oF3mL0Xo4U3f+HsJLNBqqEywMjDfXYbGNxqMLFDLbixi3Yajrcz6QP7lpnM8B/Rb+ZNlPf2LQUKxFb30hL6brhg9YB8FC2VF5b65Zvwr83xGBYZz8NtlTIyERJSaS0EjKfrYarYZwAjWRdjiWCOZM2MiGw1rNpWOfARPCOwsqpLPo5JFhqJzbbaiaixk0gsl4wqkTVRWjtGBM6nVJz7+pYeeAAmgX1JiI8PtpmHBo+HC9geoPTivwN0fIraj+e5SlaLUEmsE8xth89NQOdUzsltYFLTT/Uu7AnUTgtGSRS7sZ/E29RyQg+puUYkl8UtXP6JmOTgOFrtZMlITwNG5VICRsKqan08eID2eNnRQGFhnr+gMG/wTnnh3GmwiuyFPl9BgS+34GLL6CjaPkrXguKKLZyJ1W/xtCCvkVKSFkIrBVw0EBiMv/wa5aWj9E1AEzZnous/znS9Et9TaaHC702C52rw00lwXoOfucJ7PpAED2rwsxyTR8XA62l0DdxgBR/8RI4HG7rZWgTp5GZTQSyR5SA5W1MMpERjv4AUwteTkl+RPgEPm2BJrvBUTPKZgatLiosKC8KhYEDM95vdZpfNQlfHDKtjS1idvMSVItVbzTipouvHRUX+vIKCPFRSVJSXB+vXdttxsWUs8uSw/JeJEfTv6hL6CtX/v9h04OaiCVfFYC26Wn4/LMbOkQS6UJuG0eUcx3TmdrBpGG+GuFs+6SQJDUWxl4KqZ0m3diIujTEQvY0kT20wYNiJtBgD+INYK806IA9sBviGkchdYmTq1l3+S1ilkTlkZgTKy/VluR229DSNRlz8xIdov2IplhWlEpYuLPT/4s7EiqwPEEbEN6lkufjt0cTKLMKfclsCr5g1mnxQocnkSgH6hsIrA5+wZGCscIqL7lod27XKRmwkHoBDR7YqT7ZqHByT0sGdh0nQeekv3ZlkvWuUOq67Cgr8ZH2nPvaM7brrX0ASby/IVVZ07o7TeZOZ2xbR5CjsT4obJuyUKTlJmLubU3ZmIzdgBY/HRZI78Td/Q33jroTXwNzhPdhH99uX2H7rZHOfg18S2HqkNixP8gqkMrePZC6J5G/UcgEOGviOgIy320U+Gvn20tKJP5z49Q9uIIGQiPxz5P+LUtcn/4C+L597TqkfndVy9k0wDzKOVo1EVEqjVvdkY3lBGCTipoN8c2nppj+f+PWLN2DLq/KvUOZbQI9KsNURfplL53qkFB2JOybYpk51NRoS/RyPZCe5V7C35xOgsU+BavCz5BiNQdD8GCFh60hBSU509XDsQZRxZ7ttyBcbQm8RGUfH5ldgbl+ltWT3rPyU+wGT/D+gfqn6DPVdv8rq1A5F2BMRVqdWCfQh+NPPKX3er33vsAondWrIKF9Q6tQuKHVq6txd3ICU7iJawATuvInXiiSdagqgIbEWgcwfnA+eFN7HobFPhaxuNn92AIuUspFdRorZqDeKCA0aijcDGUZKrgWiWIESNwXam5FzVP5FZcfAD9ptVIeAOY7LwE/K5eYkc44bI70thXg7faxWxkWWWT8LqPJ6Pag0sCiYEs/myN/kUwN8SiOh6odMhedyYNPYRNulKlxI+P+Im3rTRI3/rXYhzVUUmCW/No4bs6oCXY7M2gD2dYzKV6NrSvKr5Z3K/2FLnRhozxMT7B8f5+B6pRRYYc5G4nYK9jYtqMO0cT3Z/0QwNGrxnA71g9in7QG7yKrGGV4KyorZEZs3+mOrwEJKzcsLgLmBLZ0FxaP9YGn0rqrOKvHLxxPsC6JL/zWuSzm8IsOvNPwml0YsD4ZdOonFWZAe5yGdnu/zEACfAIixx7ya+dFAzA8Wa27sJynseh2JfyTbKA39dPOrjk2H9qBio8COnb/8EzFqpOT7fTmZIOIz0gFXs8uoqkFBEKNUGLovR53pYEpGYZPHE/QUEDpV9PYvpfrzAhLQ6U0xOyPXN7HD5csWX34PmuVqNDul2Acx2G9kbRmc7LcYW/OVQgrP4fqlDCeIEAuVIyBhUTejGc1ZKYRihpCHCpjGfnr2SQv6EFEiWu0lZCvpDIpS1yZl1WaKuYLelsJwsTs1z09szXlj3mxFb19gbb1n1JbfXIUKKquyqLlJuALsz8fj8zJr81J1Fsv7+5h9IxWSCjumqToS8/9U78btEcMlOimh7ktED157ZPeew0d3NzU1wv8aG7Hv3uuuO3X3DUdOT62d37Bm7Yb5NVpemvDm95PsPAa3a/B7k+C5Gvx0EpzX4GeS4EENfjYJPqDB7y9MgFM75/sJdg4P8EMAv4vWKgZJFtAJlpyYz0oV0RUqFTveXakY9AX+J5WKtFDxP+uP7HY5g1OFNQ1HdzudoanCzzeFd1pSmhpD8Bv97PDEdaf4Q9lH/Ecmj5zm92cdql67YX8JWo/l69Yu7C+SH8Lq3A4ptP7pZWht1ubMeIJfeQfgG6kcDnER7vH+p0uBjTO8CPgwFbasmR7c81CIKQESYw8GOCU0ZTal8oKgm03RYxLIMiYmpzxSufpYKkp4yIxMpst/A6y/cDgvj+PCkXBlaXFeKC8o5hPJTvJZjjRSAkjijOJlE1okjaVmsVRXmnIrdozw7wirKrIKs8rzOoq2ldql6unJyelayVa4viSsfxDnFcovBMRirz9DLMK+m6/3OMcHbPY2j2dNacVdN95wz6ry9au7J0f79bObtkwHx3o2zSj5qQK6r9K5bO4qyZGKdMhmxbyOHY4FLcUp4iHTQDNLemAd1JisbnOIdUYlIp4lNnBH4scxyZ4BDnBGdkaW0w7DpDlEgbCWlXKWU2ACw0BzUGxnYs+2DWORpXnBN1zaVu8Kt9bXV1Vjn/yHw2fq30rDv+soKJosyv97w9yGTbMJc3iNzqFZaiBV5jAHTNJrWMmjmWH5u7VMFJUZqmGUkUFwKxLzafUEEV4aalFbAlrf9AwUP0sxWxpRsUIvBsIKXvzn0+QfJaBFZVYBWqG0zSK0RUgH5jKlLSDSp9dpopfSliO0TVSz1JTLoZr3EtrGsyqMtlkZmQ4boW3ARmnrjkasYasm9ZRkKEmtLFQJ80s1MxvX7pifrq4O1DkLJOxrq7qYmYb03XfdeO0HJp9dmC3IJ4kVxK2FSeRiL8iUP7HcQroNtK+AQJH0gQ3TA1srCYB6YWuZ4bk8YgoiblEfN3Uucf7Z+/zsObz0Xg+S+Ehx4oNq9IN+6XKBhUL16XhcISFokhRiiDHDy8k5aJjWaqOGl1sQqwlHqo4qZVH0Vtg+El2duU3+8dDQI47cWBv2pn1lO5oc+urICFoaOdjRDrKK0ozKsP9kMkw5f8bguRr8lAoHfU1ozOBEX2dQfS2BbMPAOyLLrSIuLwPzKBcYmu9Ti0VZbjXhLLLI5ReJxTS3mlA9qSQf1dpJ7ZANGmqy1dRMTe2Z3zde0T280V0bnZy4aeHYZIN/dUlPyO/2ZqW7Ols7x5q6y+sd2e6MzK6u1WN9Hdm5gDfFj87zlaRcB4PnanCa06DzMdH51HCHpZwicjQ5E+sMbsTrkspGEw4pk+JD7ZCywaDWVihp1zaeHVJOKlG87GMxKUUsDljtgQJySPnKFafJJaeXEA3j7ePJBae7ewmZqi9DwuHRS+pNja1As8vT87I0U/M9EvAGprbcKwpvsHrTUXi+GuRdFfd+to9SSLmPkwYVPeofoI76tOoBjHWzJLjYwAqNyXkYIrmVDEfix7TvQbwY2SNlwQdgAOto5jTpsxg7XFbFRSrKS4pIiMNgdDCbgdoILrcPKzFktZ43XIZJgEPpfWGg5jDsrEMbc31uZ34gVCFGpmp6owXBcHFZSbEvmJWT7XaHCipXLe3ajF8bbxVLPU6P3Z2fmV3UXl47WuQfcJaWhCt9ztzyXH9ptkt0+4qaOy6+gh1X7VHOawKtbPhu8CErpXIn0iMX4vS4LzUFPH4dLdVVLN54KRQYt1a72mKAOck0eCqIVpa+R2+OlMxs2Ldv6eNp50sqqksLTK41I8g3uj/t2Kj86+LCrL7ksX1ck1TvQybwWy0ZWNcjkMwKMoF/Gg/7AgYmk4qB10OFEfzkpxi94LAyj5VV+Sq40GAuxQfbfASfbdsYRucpTjl2wGn/4CxFanZwH2DFatEITrRe4I/MX98yyfz1SeJ0E5xNFOdC7gbJE0ACH0RGoRAQjhdCZGfRuDXZpkEOYEZtmyZNRxBoNqPNSE9C0+cSaokv+2BMMjsI9Z32QICkkC9bTvGu5aDVFJ9O2pxSe8LqeHrDiZUU69JjrUmLZXOhQu3sFpk7pQ3db2cV34nURlg4O/GXwTBCqVTjsc1l09GgDtm4c7zmLytAGkSEV80poujTdphePvGXo0wnk/NnYbVW+ZvBUKDdAYZPzkzFwMDSg2WFRXnoyMVXO8JFowPoKPPvCC5U7r6WZCMzuF2D35sEz9Xgp5PgvAY/kwQPavCzcTj4ZQMaXPVHGG3+rMHPKeeHYys2SrN8boOU4Uc63ga00ZHCObXlSo5BD8qskYhqPEdUWHK/lSylrO7Sp5S4I7w4X7QXiPQQObJeGkINJ9d/R61oJR5Cra01MApTemPLxVe1AGpZR3YDo7Z8ByO/RpNubY4PJtHKrME/qMy9gvY1sbCaZZ12DrFRraq1KlW1tKgW7bjhc9ccv3kvtsiD6OP0++DE4gFMGkKUScUm2CskRkmCEMB2SyyGCMajWu1q5sykdJkU1fgTCpd5tK1ROhHbHu1b6oguTqID8gkYogbdLF+DvnXxVYI/HYfy0sUkXmLwXA1+OgnOa/AzSfCgBj+r0AGsNlxKY7lq7TLmUJ8SWiJqnx1piNcuR+zhCNiugl0MC8VffOL67dsPfeiLx264Hrne/pd/+av8yo9/TN+7Cuz9MLw3nURwzZS+NFKcTORMQmQ9C1BEFVrvzrtmW3qVFMoIXThAaL5+h2nc6K8sBMo0oy+TudB3E5ogPokmDJ6rwU8nwXkNfiYJHtTgKk1m6bl6y5VqmRv/mVpm9I5ZvgplyRdhMf9rZmYUbZwZle9n49L3U/yNSXYZg+dq8FNJcLsGV2tHWM1YmlYz9rGRd9eVsViNW4vVfCyQ6K+7NX9dhTM7x63ZOR8rTcTBreFA4UArC90Hr3Eebo+UYgGb0Yp0BjX2HVCNvQYaUdXFBKpNjCRcF0sxYUUS53N6zqDTGxau/FBMsikHWeyiqDQ78hZTy1+r0tAK+Jx+a8SJ6ld/eufk5K7Z6S5/pKW6EoVGR9FVcjv6wlhd/xpavFErt42SOaTCnGdhDiL3LNMX9hwPRgK4cgimy4uIM+rAaLsUqgOoYr3lU98FtGQDjdbgmIEZLEYjN6tLMuRCV3hSp6tnj6s2XYATYE0FtPBej5GCrmCAHe7Jo9qYStTLVbBUuqOKLsZlq5p7/cFIxc60+V1jY5G5hsrIlNvt8GSndXVhu6mwqHaM0WnVYJHNcvG+3OyUERK/WgfEegvoRCqLS7lbJEcObA0P7IoCpNelCAaelLGzaYY5MKVYKbue4wQ9S0rR/joNxJqIZzSDRqQdQrv0K/HnYlJmXi7HlZYUF4UCuYV5hYCEVwyUKJ14iCErhC5fqu3WKo2r7bA10aGpDKs7UJqW1RXuGN+zpa6s3CXleyYGcpvrgqKn0nazvITuxK/1d33W6da36zyenNy+pvY+d8hvNnfl/lkU/fk5WeMXL07TmB7sLyQDTdK4LM7LrVc6lZGjInrMLQg0BGpQY9w0kU1j1l7SdYi4RfyC+mzC5zHJlQ7605vjyU7PSidxgzTOHNTy6lo1XGKslM7t9t2R9S3ze6rWt1TW1lZWRqOV35R3obvwawc3tW2qO7i5dVPdYE9fXw/5uThHen48jA6iT+MXwW6aJfsX8azugbn02cCs/CzoMdJTiqTE1D9YpoSIxQnieiCOnXDlYqSwmBtkx5XsnI1UOhClR5ZIVOuYlfgzOl45ne625qdPDfH2SDZ+sbry9RcKvG77H9DqUKYL3lO6soAbaE84L+zNEWnQjgRjCjIJIIsFzsQLpnk63ijsCGap2vvNKakGHRB9BlB3oAGfj+N8ok/MyyXEhDeBo0i2S5ohm7TvCfsF2B+0OKY6QpgoGvVbeYMANry9WgS9hBtmLPJ3LbMFnXmDPYs5+SYHEv9Nr981M3PYuio4+9a5c2+Nf8C2fd3JE9GWjJ6vX3wCnaz0fUVGL49vDdP45+swh0307B7pUjMmjcB+MaK+FGQENwMZjGge9reBX82ZzUIs1YQFwd6fnoYNBi5G804O8HVEMSSGgoF8vzcnOyvT7XJaHUprGavBS2wU2OUwF5HOpSYaZe1sImBfBEWBRCrBEq/Gm2a6s1s6M76X0Znn8qZkfKd8JFta3Sd/t9wk5OUdXV2O2uQvnjt37vfV5x55Vf45CtCfL7714Q+erf7rX/8KbL6yAnMpoX1wwE8zg6hmvEI4gNNxa9REp72f0Z6ygJ24SQZDJqU24CmkY6rs7X4rLpmxtB13WEukhoq8YH5GHloHBMUTTzx0fkQcyaq/9UaUcfEJGPd+pS+Dk2uQalNBXKTQXJh6ulgwYLLyMJyjXz2t66ZWi5NzWm0B0BdGWG5EVUW8fUk1pRK2Lr+kdWdYfol29KuX7x1j7RnwH0gXIK2HH+3JRXv4ceNKXzwzrBBYCRyi9bd6ehBSIYJSaO2gJ74dafZ8a8BvEQxgCvud6plvqx85lVKs/5D/MHLs9juvfR7dI/9qoqf/Hjz5xJZtS9vxBfnRd+p6DjE9rPbjo53MYP4H4O9QQl8TaqGoK0BO3hncMB7pFYWz5e8to6fw6MWPwfPkXfS75EwV8rIzVUqtPYP3wJyLpDCId9QLBg/m91z6evjbyBmtVpueDOIU6DDVOGQmA7XyPafWk6FO0TzhO8A7dfT8rJvUf9N9uxpkOxV59n7BqOdh18bUF7tdVgs5R0srM01AM22zAu+QPUoZyY/rZqzyGctsYbbPbXOjrUv3mjMyA7kole7M7KGTp74DW1Lee9ud4zncf99Lza5VVDi0XmqG/0kvtQeAlv7L9C67pAca4KHyk5N0lErnsQDugw5hsHcEDgvzelANyN5vNDARoPCylTaVsllTYdvbyeFB2OPKTlcO0b+wbuu+xS0TFZMVk5sX9121tmISdcifR3uQJP8HEunPs/L7KKyD4pGpnHsv4NqklhDo3yAiwW/MWy0YkUZhqnJW+0Fka+ElD8WrgAsH/IFACWFszqV2emRKSospiWJU+Q+mk9HGnY0jHf3r264dH7yurG14a+/o6q4D6ZsaBvubIhOhxs0n8bNlY9XNA6lCrL9lPlpZ0dzV3tDUGKuKlFfl5kpTXHIvGZ/kMZPIPPNc7LRPC+w7h9Vp0YHsASoBWnZiLJLeNd27UlJeuXWX/T9vh7313Zkj7XgAdn3FXTdf/EzCWcCbYC1ZX7HnucQzgg9o8CeUXhzdwNvb4PlUMEp6pS6PHYOV2GcUeKzjemCPIASSasGEyMriNYSIdupCAJPRZKjP7PPmkCIdUkNHk6IpBmexjZGPpp8QT85oE9yt6lT+a8LQae3utncYJttQy+SaYD3Mh04Mv9Vdl97UlF7XfXG7vHKOTSw+0wuUdsNK/yUz6VZhQnrqvQJqMK15YoYTDFXWI94rYTyyxHbWLo1x3Jf37u37woEXf3P8y6hJ/goM8QryUP5qovSiY1D5UhTvL0hk9srrdN0ySDcOE/UNjfTwI1LFCx3Zw6SXP0lrgLw+Z7cVaypjf7K+oOOqfY0w1x5fN/p38Xv10cnWUmIepY+O4f+yj04Cj9K+A3EBSkhMBbSVMihtD+dnHejQt5bJ0QqiiQB3tXcJ5ibj51cBd0zOr6o9A+jn7IxjOnw+RGkLfncapS2JQ3STz/YS59uOwO/OIoQNKkRV/O4T3rbNI5a6joKM4l9e88xD+77ZO1FhnBBySgLo7/IIeprtAfp+ujeq2Dl7E8ttp6z8Esb9PmCVyeWSWGoGh3V8lhv0JSanwXXETFwCdHZzvE7HT9CyPT1obl43bLPl+myZtkywzJwCoQYTI2Ax0jB/tJoZum6rnQalw2ju0IFDB9ZfffDAofWPtDT3TvY2t/Tg95vO3HPvg4b2dsMDp+45Y5Let/3ag7sEUKuisOvgtdv1DH/1rDbmrqH0KlTWx0a0uJWoOcS6fnCkx8NGegBfZUj4beNsol2kBg2xJ5IiWFFiTBQMrlq3a7mxaXUNNSVSvZ69m5Agr7Q3V6EhGrtdoGflFf0DxivJddn7aQhNtVpZwMWq7jmq+5Qmhbh31iJvXX5pmZhKFy5+GE+AiaTVO5H3Akcr2kOnNglzcAnazK++Cv7FZRff2bg0t0S6nZ3HM+SHvAtw3EJ5iHayARwNjAxGgWrpOJYJnS4MniQ8Ka5bANcy+n6GrTIEwZhTaGFV+xeSQOJe4utSy4mbwehSvKmNq+BtfWrW8jRQ4ZxCBLqvh5W+saTPD6UuWKY8R09T22lKdo4hnpqaaku1gjmWZ6DKQbXFIlbWfUf8yuyNd9x15MXlDd3996DPbdu5dwlk2wX5r839NxBbBsQ+7k6w/bReP3EDWDngCYOpth/p9mNI6PZDG8cq4/1yAsY7/K+7fjXdN3wvGXB5F55YI39cfqNp8BjbXx5aq0jmls652LoIyKDnDAuMf8CEQXOKVMnIyHBlOGFIGNNI7RdthqQJJFJGPV507dEbDpzahj6zbZvcE2lruwF9fudVe3YrTfU+Lf+ptf9mZru9jqeprUKzJHawEjLA+sd96Qh1v/fsXS6Xz+XN91gDzPLVJs/H/QC15RHafM01h3ZvG3EYPQWhVVanzeBB1oymhoZmhSRr5R/uO1jr6bZWbJ5D++XPyL9vHexWeiEF4BfB0cplk57pesSZjJjYUgsG6hdygqDRx2azZduy8ilrBSwphhxF4oisRSdjXmdEETaLB645uLx49ebNV282S/UNLeg82rhl91Y0Jn8UqPQmMssPr6Da/vYo0voCUPm8RomDvoEb4e8c0ocVeFoPOHBEztiAN8G8YiceSRGoZl4pBc0e3QBtC+kJ5IMTw8wrFuASwBZ1vat/9aMbSuu6+oa3mpBP/pVh62ikN6928saZWwdX3zqJnw2IbRVbd84t78n1dI6MPbxn90PjWt8jUcUvC1Y2E+w/NY+kmX/zVzT/AD9AL6jgp6WCKHb+an9IsfgAvzvuOXdL+56i5kB/2diMXv418homhlf1BRsqdnThZz/+0QufKyuScn1LB2b2bM7zSgVl8Z6cVF6XvWevT7WXJaZ9JtHK20oPZRfhBkzrD6nPSCK5iF8gDThpbIlJSQfpAUlOkQCXekAbO9kJfzVkQcNofnT2dMNALLZUHBErXUtn0Edx7Gs12xbferu5JsshfwnHQLVzhUDPLtqTS+TuZ5UjftIDzKBD86SvND9LmniQTQIu/iwRch5OLbUIqg/SXUSe1s8aGc0TH5YKr/wcTIU9zBYoFpNcDgcIUtGRn5NNIzLgPwRTNFudrJbC87BG6djJzg2xrmvoOxOBmc2bpviGhYVGQ2xdXtBiCeblhqzWUC5+duT+Q5+4cP4h2ir3l/ednqjct23b/srKA4tbD1SyPelUdCvpCVYplRuSeoKRbUnT//Z+RdSnpzlsac50ZxAEPjEDiOEHTg6L5yn9AiLVoGOvu+W6Bw+cuPEb3+7pbm/bgFLlvyKx5ubN2yebpNamf3Bs/Ve20/X3ktoMwrKk1g73kXhyt+L20chq3O+jPGC1l/mJskFKiwdWOpnEBgJY4y09sdi6OW9xiVVjBvNpdA9ww31bd+RO2Arqyk5rXBGj54tAhvYBPoUkX2SEPQaU0GHSg3nJQAU4rfKbQ2yNnaI96AoECDNqm0o79ByNx/1o0EpJ20dwfsHMYEVthiVaWj5QFvZvzvOHgy7vgi8rP+TP24Tnnjn60JlK+Ee6fceRj8xt/PDyNVuLy373u9KSDUf3Pr6VrVmKYjvbwIpulhp0pCks6TEPzMsaZS/QJUshzbHnmGlhB5fWnmXPdDvhW8waCKQCDRM6pJN2x6Q3ug3UDtFAHz9559WPHz++/L73RU/eXlODLly1ZWkJpw9MTw/MyY/ddK0ss75Xb4BMfxZ20n4p3Y4MvAPpwBcyIV7J6/oFpCNZerIVDAZ+VjEfSJI+vlkSnlH2HU1JqJtFyeiTzSKl+3Pp2WjYI/kpBjWpn7BBtBbYAkyHCTk87eso23290LR7d3PqTbuKGr2lznBmS5/wrX/V9bTlFLt9TteH7pe/jT8u/+Lu+22ObnPK4p6Za3anp3GJd32kgl4HWyKN7Os+AdF2uORILmFOas6B3jKbzenmdGYR0YgW1Ve0CavIhwV0ctX6yuE9P7/z5/u29vQgq/wX8kPN0K1vvQVjuVdW8DyN37m4WqnaiQQDIlUWAok0gne6gXSxBoECRh4dz+FwuByuxE7WBm98UFH1BOl9Gc95x3z18y2zmzbt6L/z3Kb+aA3KIrEz+vMbmPwnUT8gsgXp5X+Qeas+mhU4CGRDhhkbDWTiVD+SloFGoyqflTAoaG2GhUkLerLJh6v9TiECDjJuWRgp21g2srDUfRh9/OjAh5ZeQlFyNQv8HPt9Z+fvX2E8ngZ02KncNcI6hqYKqC8LGVEvITU47BNmlJoqxIhoVXg9BiYwT/Fgl4i4XQ67Rpe0ZIwUyjC8wu4o3jlfF14Xrl/fNb9p0ye2ouuv6nln/ToNtaj8PNDnewTB3/72t4Bf30oIp/OnOQMXJvgFQXPlUXtLT0rB9VyP3YZRNzlSz+0xEL9Kh9Zp1hceEASwDcNCiJxryvXCWwyCwVFsD0dJYbAtofRHCMULfcRqoq4B37+fKL3u+pITa3cfWNtRJoYL7x6cGh5q69j9Tfkl9NB3bfi15cjoaGRZvnXT2tlNFrPLYct1djXNROoz0hvrGqJ9v5yN/Yeabyb6GA/G+ygRuwgd03pmjeHnOAs31/+0BfZyqsVEW0BnINzjkczxv2jFoiWp+F0NQLLid7tW/J6twGOfCljtecSx5sheZQl31uEDF5gsDuHULc9de2JnhhQV87PwNmfmxa+QVmTop1JdxlDcTxzj/wx+7iQ9+3IT9nIPkyoc/PTDLLkKltFKAR6FOaWAzxsk+c88eBD1BRGpGSXyyaeWvWfTPk7OfiMriRdgP3sQzXxe8gDsd4fyFDn04CH1o5mpqeT4Qq7Pm5Oameq2WWBAk2gyOItdVu2IGmgpqqSoZnDX1ChePW8Q8ODqsb6+sSyv2RuEX77AR8oiKQXDE9VV4yOe29LQpo98/jNPPfXp4bqrN993ff01m09d9yNLRyvLtl/8M+2DBesVBXq00X7U4HvE+x+Sk/a04aCqQlkzarYvqIyKdz+0grgWTp9enptDT6Xi0YeG5QfQhmGE1pP3d66EcTG8P5fchONF2ECOAYIdyjM7VL3YZyEhVMvzDs0YdVNjNJfzWf32QCBoZOonKdqv6fAIuaIBDNLntpHAf4nd62yorS9r9+5NRbely3/o3Ii+tX+b/BslBYD8ba15efIP8IW577YrsVvwWzcArlnEZs5MAzcD9YGoAF2ZKuB5EB3EfV+TQvq9x4U3vYYmi0T5lDAuSUJ5WVpEkxyJAV28YdyaubZiclViSHcaHGkWvX1XVPe/lHgu6/tZz90t5ZUhwViKDEIU6Q2ka1Fy+09BqeMsVus4DZxeZ9BrzXOUmq9srVDTQ+o5S7R6zn/i8ZhkDpDoMKnsJGL7CpWdVw4UV2oRZRw8vCO5urN9V+HlIsd9LLS8d19KcoWnrrL4kiCyFmEm8VBY0zHaC79GimQQq4c2ExL05G4HIlC5NcyRVHxIILaFs1wS/FAa2SrrNzZryf5yHwuRfpSsW2KM9L+UGOxq2n+d5ABo9149ZXgTTzQ/Z0I60zyzDgU2KugchXcsxD5RNQ0xr5QcgFP8bfGOHcU17lPLF752+MHMGuCRZ2HUlx57DPxCEpuVPkzWi8QThtWxHTQnCfMTYHhyfN1IuJzYfGRjK+Z5gh2QkqDv4sYdYICHj3+sd7mjY3nLlt4n93+JzjhjZGxs5GoyaTKuQEKgNGYfkSpSwaYjnR7J7uYN8zQArFOsYTXils6l2zRpYlckiTLb3yzt+mXrk/ufe/HYU3SoiTXyyyhHiUDHY20ZXIVU+t+t5rtDWYnRABJ2a6W3g5CFjN8PQmNv2SC7SI9GGv3PQViwJ8kuMiLmBZpDUWwaYqheKrx8nJcYnmIgaGJmf7L0YicLWZy4JoJ1vZOdHdVFtjxnfX0gf+vVW1FfYS36xniX/MDQZEFbamoP2tzplZ/CsYuPAa5/CSXFHoukMIn1A01I1lYRqHFaXBp8VMdVqIC+RcJ5LEb9BNgrvpUj4PM+B75NhEhE4mm5wFwpAW1oxKRbOCv9Ao7W8zr9wmXj7QXBQDBUSFwvkBFuIUyKORKbPMVvnomE1Hi8weWuod3lnLhLahhp86cGzd6C8aNdfYf7m6dL6/IlsXNqoj/Vlzvd3Tv1y+ysrgZf3pevC+1YVZK+ymokUZBHxgPBzuys60/edkNlrGxgbWywZLio9OB4WRG9syuFxtoLuHopmgVrGswGf60gJPCk0QMNj+h44sopJbPr1exzNj8QCBSLIkjdYp1azE/lGiuuvtx1W+invS3R0ux8f05O79D+tnfdtdW9rb63qiWryZKT1VqREjuzmHzVVqdZ7RW8QPMBdI1ZeeYaGltOcnQvWWN62UiYebdoUy0sMutOLAtknWlvYrUPKaZ9P+N9SdNJpNVMTPY+zSrYwFJcbCjFaKdxFSImRFIezTIORxeuXb524d9It1JUPfi73w2iw6RhKbMPYR7dVB6DV5RhNhlAeRERxZhWh1jcIEEU22z2BIatpr1VI7TPKu4GQXya9Fe9nvRafYjsYBRgHVZpv9XfkDyAsjeoZ2RHOjDksI52q8Jg+W+kLYQM3BrFw1THdXEumg+gwontlEtSAoroiKcFqABJTguo8XA1F5HJrZVS3E6bntdjHTlHnUtKcamFb1CCR6RODtbTqabKpGyOleHMJz1GP2S1uJlcptPudyjrDXiS/IqGqhuEeA1NYKwqbkoDVCNVTdVhlsIQzQszDNumZv1f/pgaREPxe5bK1NyJJakeRK0I0rQHzZ3QGBuJuXPJwbUISDT01W3L0frSDu/ycvcGYoH9/r/A8MqVXwTp9cM2LV8wo66RBXQ06A9M60AwTHhBXaNLhBmsUb41aY2SByZxHjwzY5VqGwqbs5eX2+bWb4M1IqP75O/D6D9p2b/tDhr3Bx+mHuRBHvhlbVKLw451BtKAy0SPLBoFTDrx0ZsF4jEG5a4xDx7w+/1hfzgoZtkC+VTHcEJiFJceaSHJXtLJJ7mLVj0vfwF1NwSqcisG1m4/aGjtEdtTjJW88eoNm67awldXVjXqUbdn/063q6X9wbOoO1pd6c3Mtkbue+Ljj3uObl86xM5qr6zYKP7lXA13VLKK+VgvxBuIqTXfBWpfMJMRk5ZySKnEIx2psrUWYm5iCwYv96jSREz9hkDuN6qoqKipqIG5u0kbMRJx596rjdg/R4vS8nhHsZGJ9fr3IkvI6lHLxwfKrOduuTyNLhNv1u5DRYF4LQDlReaveEh3uyzgRXJgUM96sgM/ws5VEw+qpp9jmp6GxwL5RB7qExQ8tX014xHM3fzpoa5Isd3naKipP7a8PPno/qfOVyg+yZ9aGuUXCGeisPzDzM+qPsnI/7o2i5YXJNVmjUyuCbQcSSzOmt4or1xanXVBowWrz6qWKvWIaER6jxSjw/yV6WAL+AkdEq7OSTS54rfmUMPrmOKP7dGMLx/ts/6/t/HYrBNsvMk1Qelby8vfWiZTRXXkXh75dyiTTlPREVZV/jiRnpjLejpPHuv5jXQroDUJ5WicIn+oilCL0EgRU/W7Esfdltnm5NzxubeeTk4eUxwcgMNmqiMapTqnGTYuiSSDINJhA+nkRyyTnTTZr79k8qAAyDVOihwkc7/MVU52vHlyKlBu5fmJTXM8St8Svm108KSf0mOku7m3VC5H36vZ0O5X73SitLnMvcHP/zf3A2t3TCr1Us87WWxOBBm7it5rQ/tGqpkoTI5r6fScbl6VqCxiojqarG+kMxjMpwrOFk3IPFVqNbNcTZRIHVGH7tWt7ittD9eVLbYdO9FyYPTILai3zyD/UNffg+YD+3d4c6Rw0YWP7X108sLjsrxr38FtgDPFjcwFHWJz+fslc1RkhDpHWltF4UEG/z9Kr/SV1+k9ezTnlg3bBSxmPTkIbaJGJa3CoV1s41bbpTk3djejmnNLSLolxfLQR3a37Bse2FRWV9gTae/tat/1gvxL9PB309Bdm+akTXUFBe0+T4fUWNPzndnY8wk1TotajdOHVxJrnw5r8OR7nAi8PA6n9zKpNTYkk1BDrw3SgTlDj9Mp5r+g9jb3kCSC2UySCC6n2Wa2OgN+o8GdVHzDGQSypja2hPHyG/mTnXrk1Xd09nTw8n/yXd1qGQ4y79i9tPPi75YP7N93Ka7HkuZAc6D8tQDvoOcoHnt1hZyjwJ9ZWdHOUbC6l0Wt7uXDpkT4YQ3+WBL8axr8yWoGL9ToWMuef0OpuYR9HaL98wukoGK3kx2sSm3VbCdnTRSpbVesdr/wh+ZZSzd6yoxHZRMptFjPxqI1A3SsloS1QVwzyOtpqrsGpN40pNObgQfJvX8IjF49SBHOwKJ7pKEkbZ9F6wscWmTHnXCtCK2vpRWJLNQXcSZqNS3w5z19unV6qJOF21rjIcD/c5ui02rjsUCT4k9nkWoDl92SBtItfhMb6XWpM5Bj5ky+0SxO3JO2kX/epVeqxQSHIOLEg9NDim7JP3Pm2u89C57BtV/6YO8xFZdgontwW8IdD1Z2Bza5ohDWpI/0+0PE4tnA0EFq1QpNtFqMYOnQqyrs1OkhowONcAe57uFf7njf48QhefKeO+hwPcPIA+O9MkzlYJj2SmO1LESzwZ7ScfwCR+p6aKeBOT3LW5PgMClnSTeTsLA1IBhcxZXKGYiIVYxa6QHpyKfuuOvIuuWfbVl7aqBr5/bFff+4OBRDwk2djTCWaeU13EPlUZiTpKZc0CHAA4Qj9NgAls2S2mCUsiKxc3VaptLr9Ya9oQAouKAoUqtWTVcq3nskomg5cH4jXPxSAtwzM1LUYi8fLOop3rupeFOmu12/Sb4raC+KNhbkozrp+LFQoLdiXceuaxG++Otw4YWmLvlf/cF/Hxhqb2Z87II9RmLSIrfhk1mkTllJC/oMhHv1rLcUraWg/EstD5oTDHIGnkSTycSu/By5OTvsD/jtopAwL3AfNDHL2hG7FcEbjuC2hemO6byB4d7Orp7B2MzxW+7osQU8gQL9LtTQeOJYW9dD4/Ugbic3LZwoP1foH90Q7YJ5tMPeL6f5KLArXOS4Ga27ABznE3wa6lEk2G9uzg3IWRP8Gj4RtTwSN3Xj8hlr0cdOnurs6ux55kmUNtl9gvifORP1LYDG8z3rXd9jtETAA8M0hkX87XR6YQ34cDx4wksJhZkkR60IbNFjpwEOhTDVSfajuuB4eHZEGh1ON/lKi6vdHmeKA1mz3G36zXSBp8bQl39yx6k+sdfVeOtNyKksM61nU/DxcPMs+5PPkcOJAlpSix8UV9xg4Oa0ZG/oCg+pZRHayqY6RKXnL/FFlBlUx21Bh7akw3OrW8cPLS4eWsxy+wL6LUjqJog/QI3DX6E8gvP42qYu9T5iWvsT0moxG+m6klgMCAgwGZe0u6dYnZui/sh1cPYACX9xqrGiXMnkUBFpbFhfP7DwJPqF+RMtJdX6JVTfHDtQtzCHHlmzRp5aGF/X0AFjRpT60ELioar1RvmwN0ineKwVHC1cseCI3OsQ8AeCWsGRFncTEpvjq7UIavXRLctVjeGxSHP/QOPetG1dq0d7to5K5ceGRg+2ru/vGGlZ6sHPFpdIublVFZVVsaam+vau5orKmvnm/pgppa8xOlGu1gYzXyKL3MNmswL6WJd0K609Udh7bKxKN8mDSHRj4j5EctWwIujx7UnujI/VjpB6t3UqDlmuND0mBlmfGdGL9fgYiz4pot7WYLNZyD5gcj4cH95ND8ryeN3i4saNJ2ajGSavugkw+klseuN1KCT/FC39/od33NuvbgGM//EP+TlmC5OaznEaA8sitx5kmLFBT1tf9xnVjtZa4zR7v6DDSk0xx1mzrKQcw8JZgAgglsmxY4N2qyFVghwTFNYI+uX7cobKAlfdtrCE1m958BH5nqb6qnwfqs8L/A1f2LPpR/In5TNosK2vrU1+leKlV+5rIvWAnVKbQNrKEC8I2MkwDxYKEkxo3hiv7yF3RNKjYcwj8uVkuthxBmuImg4k3O7Xan1qIn6lcwKvch6elJ+PLh48urdxZy8aMH/m1Kmd/rqW+lVlU1Os+qfuBml91dT3pn6ODVJLSwvsRfVuRHrTsHp3E/Xrlymf9Wv5D/CXSfvaNHNqilHHO2iiXQ2m6VFCCMuZUIqqJnqiJKseIQFrAQ8f/3Lv8nLv8M7Q3o79C4vh7Z1qxmd/S3vbpvsa2pu3Uv76K/B4F4wdIvmCAMIGrx32Zo4JvzvbqVzndtlsZ4gLemi+4LLZTiVfkLAZaiKYb59ob68uJFmDSH7epuEElkTWgmr0jdVt8n2DUwWtqandaJHmD9b85H2nNO6UXyUhnyzFPsvnhqWBPFhtO9Asnu8AqxEcUhNgL3A6XtDNs7KSy+U88jk/dcfJLIgJ+R5ZDyaXL8l8iOKWaxcXr91SFL1M6kNx4EFGE7RJnkKpCfx/W9v09Mk7r/76yMjy0aOTt90+Pq7UNmX0xWJ9a9TapvidpOTOmW6pw2HFBnIRFKADzKc36HVgdSkdkgg3EJN8o9rZUHUH2MUxAdg7+XbKA6DwyXUO6uWlhihIoBqGFq6qLO0frq+pp7eYvpI5Pizl3DM1je5fk3NorYVcZrrjVuHWrfktN8pvxO9d8gGm9G4hrgX+zsSvgY1YSLy5YBYmXXptVoxIixamU7RGddQu5DhvobdA9BN3NWQwOJWKQ/XwarSGdlYj/AlbPn7LDblc5vZYZeNVXTuPiFPDTT2FJfmDtWU1uYac1VUWqaaqoDOzuQ79pWHXwPj+xvvO7rlnXbYjN3vIJTosBb3NRWVybHDD1EBZYevMerCiQNFhH+3vlcnlcR1Sq0GpBU0HniVX4FCvdEHzSnPiXiksf1ZWRkZWXlauLycjM8NdkC8Sr5RjS68EFoSQ4FSsLhultTOCfcc2vbg1tvmaqtoHwmtWRWrqpM69G6eQdXl4CKc4ettK6tI/ZjgphkP58o3+8tGHYXnvBDxt2AJSNJf2aqPtBZzqQSairTm91aoD455eUm69E92QJv8DW2bkPirf6PdpT4HzrKeAUrfB3ns/Z+QGPkGP8ildhJkOUw+kOLWCGlfyUT/1g5hkvsJpPxugsYRc+P6TgAq2nCR1n2DPBjE5v5dJMmc2M8gyeiVgwpE/57uO/GX+U0f+QBkEpy3yc5ZYyJ1jF8xo84579YLD77P+eurNc+fedNYtxp6Uu9GmkTWL9a7/6V0kOVp/E0/yXSSG/3d3kZD+E0++++6PS+8QgbUktZlDQFcnqWnO0OF4wQDiuXl6RsPZbxKYGeB0qKcFabo+KAoi6dxBxRVr3wFiAqHS+a0H926bLpssm9u89+DWDSWTr72Gct78d/jnTfnl116jPUIAHzPQL0jOYKsRuWxSU4J0elojTtL3JG7A0RMJaoguh555n2OmJeIC+UTz26xpqQYdF0SgthzFqLJGvR9MIWhi9zO1JAS5KqK7CsbEyqKlxvlDe5tGb106ORspnKyR2psadgqoIezvdjlbcv0DnRO5Oqlu9XRPhyenrCAUWq300qV9bjLIOUGw5mg7aUSIhVTNzs4J+kVi0vIsiCHYI2hle4r+24e3mwzfOvqTll1ueQO2/LR+jwvdr/bWQCu8EdbvKbpO31jhEuBBDX5W6Y86CvuiDZ4n5wT3S+nJ5wRZw8s89ZSgUW18rlaGKQcGPZLvsicKtQdiUvY/e6hQEKNidVXCfK0/Vw4Vdhqm2lBgaC7YmP7s4e2pxq8exge1Q4Uv/+PcT5Zn5WmgReNuET0pk3NNa2jPbtIPJ0zuIgKdQFwNHfiP5Iw+SDI9Uk7V2uKnauOMuGZpza37zn/h6JnZJWz53veA9f70J0pL+l4q15Qe/g71fuPXsZ6u6WXPEDqvfIYw6sf6pfNGU25dtMLrdxsz0EH02V1XH+3wdtvKFxf+lb0/Hwargfe7SDzOkWLgEXGIEbmalNxJyvNO1Sy0Wd1uxQEIk4A62Ia8SDhZYCF1XLPFAmSYW7cZFE7q5uDxhdgtLze2lGXJz6DhrKqmul9ji/whNKvde0F5NZXdfcDRra2jzKrXzgwqFAyyK8NpnAfd8fWlJfjfSy9hy49+dPHV9+zHm6P14/W8ux+v4f+uH2/CHJLOPDqveObxzud3ofO70GflbtLmifZsYv1OMfeLeJ8b+ve9lEZ18Mqg+n7aloI4hk7t0HvC+8GHxpmfWPoc+iN5P/rs1H/Xm0hlHNKbyPC/7k1k1HoKfUOJh7sB3gr2UzYX5qq41dIQyRlyxUUBEUz89FRMLhnMhhn2pJkx6jYJRp5YIaQJYE6/QbtOELRSQYHHU1BVECkv9YQ9oYJAMJBPjnMgZ/zeQKdQndCslt7axhpsgZ6qNAhWTbKiWLhhoL63OxKcCVZ39UgDnlLHeq8335rlsGbbn8+1Wj02vy8rD7/yj6qTt95wd9Ub5pWqu2+4+Y5MkP7yz2a2bZtxZKKIy253yd9xO2e3bqdn4dWeUhhhtU4A/Z32ZiuUQuTsE046Y8m4W7G3RdKrnG4mJUemHnGIVkfQ35d8Y+VDo0uFRfldzqV/z/aO97/49bLCHPfv2ZlmkK/tdO8knq10/vNnK9tjFnnf0jeWwJKAFe1Bn5HpudkCmE8Ffa96ttL5z5ytrLj41sY9c3s2Kq+CH/IuwHGJyq2ks5XO//HZyiXA1U/fH8dWwZj1dltQ5Eji2UrnP3G2Eq08GLM8sOv5XeeU11LdtUTtaFJ6bL/0bKXzkrOV9lTbZc5WOlUr+VcTB3cdmv/+0pqqaFUL2jEXWzuDLW98q6y2qgLGyYZxiinelz9b6Uw8XWg2mx1mcrZSpGcrUaRS88q04biVmr8d2f3Rfa801zc3NaIdn1gfQ18Ye/ObpfVVZUB+tQ+ciUu7zLlKZ9K5yvT0dFc6PVcpqucqE45V6tUR781+ed/W45vQ3Zs3yzv8tXXRRrT1mTWzRLhhy+svVDTUlKv1GK/jcWrP+YhdSs5UosufqXRe9kzlpbOOazht9miP+Ye7NixP6/XeaFXI7XXqU5DHUl1ZUYsWn5lZg750ZM/hdm+PrWxx3XffeKG8MVrGTtDhKcDr8mcpnVc8Synm0bOUGj5WVTtp2Owz/3Bp867lTZuWF9JqI6uiaOj81GqEZRlbvvxl+c1PBWtWFSX0IaMy/5Wke0w9JGdKjoiQ+98sIEaslz9HmXNJWNPDZQfzrTaRhjWVY5TaGZ4Eox49N1DZ0tE4aHrlFcP/R917wMdVXPvjd+42dWm7Vtv7SruqK2lXfdV778WWbblXuWFsbMsY23RwKKaFFl6AhB5wwdTQSUIq6TxIgPfCS8ILNSHFV/85c8veLRa89/t/Pv/fn0S2NXPuvTNnZs6cOXO+5/TVuxtspa5VZfsuq9/dT1vqWvxdHf0DvVpdi8V2w8HBhc7YHKu50DYd1om1S2MoTXH3ubmU3q5UJsNQQpoZyCkBITOuWTi2r2KFu9wS8VyS+R/vZe7vqgn2b4MdeOEmu7VZr729/zp/c70oLxFNfWfJ/EV8jhmaepb8zufAoqlHyZovxv1qwP1S4fm5BJZR+2VYRq0Io2haAssYR5cEy0jMMRa12aDnzDEqV5qYaZxCFBcaC70/PTU7MSGvXbOmVjE5Vmi3FxbZHAHacvzokesWtmP969db9w5NbVy7bNm6dTOsro5lPvocr4FM1ttDQbCLCsSBF8lFqFysBUK8LpAOymyI1UVuZfTg7VHhVHAJZoN6IR/35/N7Nl20UFi8e8vEVGVFMASi4eWX39a2l/SPn3u4wF/kZ3OSkXwQf6Gc1GrI7iOhjXiu011OB1YTIEhtOxulywSKITUpJ5FPeBdUE4GSQKixPDk0mY1zE1c5GUlTKtXFTtY9U82lHisjRjghaYQ4O9nrd9xhHSvu7PJ2kawRbi+XoIy+u/cSNyRWe7h/FUkdURdEE36PkKiMnW/sfR3kqX2P8LgM/+GiTxA5s+oJZQ4Np6ACEpscLx2FnFbMSUnXZOQEQSB+FH8KkoGBlu0VTywimIzksJLJhcWSHTBj0D+wK0e3iIqQIJg+Opqxt/6vB+ZP9/XNt8E+QZt61z6+fAL9qHdrBnP45UA4WMSudbCDtZJ4z9/jYstqkVyig6CHAEzEohJCBcYV0qlSPuuJIwlkUdsNF+3xK8gTA1zUCsBFUxx1pOC8hGQJsdTCGlJxZlfwQgQsMJhdXbwIFC2gslikI/pxgbbc0u1Zvk1RvW5dTfq2mf6GoK4gr6wy5TuPS2pK2tSqaovt0Dwspg0Hq2qUyu7u/uE+Ms5mYnfNWQLjqD0vxtFNPIYVAsbxsrLxstZNP7js+1tWNza+hP+DtYM0p0+zt270MqJnLoFv1H4JvpH/YIhjRYj78OuOPlv5sqrJVavmuw7dtrw7WPYi+Q/rSAxugersWdJXiIfZSfbOpXGN2vPhGr1Ch6O4xs5VHZE1kfa5TSO70R27px9f8cK/4/9Q4MFw+MFbo1jrzfi7eja/Aodp5OGMFI9m1MajGfMMMUjGjJg28DyItmTzbLVz2lWzvGXNqlVPrEO719YfH77vbfIfnfPeA+HwA19n29O76KYzJVZKThWAp1oeoiVacrUil+H9muooyKdBz5FQO6hYAKOW7jEbIcqdRqWU4bMoUjjhjoWkYwuxKDfBv4k1wBLUul6B3ri84/KiQwvMJ62DMzVNFo/n/peYP6K7f1g7PLNxTWWlxmp10x8uLJTNzPzL2VYYrMlO1diMTmvXPeND93R1dPXmpGYrs5SWnHaQVS58XqsjsupdUU4XAPRlCHFz++kGPN4+CGFJoVQa8qqL71eJXoxlkdrp4qJQ8SBED4tK9O89sE5ZVW7LN2bk5KgUVx3Dc6kPbWyszOmTq/VMM3+W6oeYzugdEu/6GO0gcQUZ3L4V5GxvoNzUjZE0NdZaAcTK56uARFbUJJxrKcAdyuX4BMnjDjk3CdaMwUdVN8VTQZrqWAIiT1gqHp04GcnNwzp7njvPZbNoNZAHkpgRCDxRlEJPDEmUK2g+uDzeDXv7B/oGe/sGjrS0ZBWMLauqnhpXbp3aZrG43fgn82tHDp247pJLrr9M2djMgRI/W7MpA6lXbN06Cz+sXB7DfCom+3VyfKJ2KXwiC0oA8IN537758XF0OBOdOtL/3nv9b0M8nOWLXrwP51BWNkYGLVfhvZj398X6XRw0UZtwWeeEy/3kPr9sQEy48WR3Xpoa722p8OuM2lq301VtmkdT2b819xe3DpUMjfua01M7Pgz4PM5n6ZzR++zekV7ouxKfKWfpnK+CR9R+JTyiIINEBmM9PdutdE8HxgqnNuzcvGGoaKxodO3mAXz4/PjjqMn4ZdZenErsxWHq/oizEClSAkiuyMV6MUklgcQIRIjM0cnCEINUqlwmT5XNLw1HNMXCEctjnzovLNEUC0vMqqxwOzlgYtr5gYkxVuhgMls1nbFlJhaWuH8kapmejbNbj46n+sWgxClZM2+ojjNhQ+OX4XHtx+P6JZhE7dKYRK+wkeEx7J/Mcd8yPU+srZfgsfvwQ2JufZmsId6GSzCBaUjOZkPE6x2vIkgOjj+sWCkluhggAzWyHrJzqKJ4RHLcE5l1K8C0uzW/JPfA/A0PXHhVbkn+VjrnzZ073/yMef+jvXs/Ytcu6Ac19Mf4u3jX1kBgXNi1pR1sPl0CSFQAdJDsnoLGzaVfEO+bohS60Aa6ZuGW9vn+/vkrr+y8Yvc3cV8re1dmbu39208+Y31NSOwFsANimZEVE52EuN6yzBUbS1hFOfox9jMDB28anN/9HyOX7r7nww/RM8M/4d7fgcevlth6zuObrl0af1gRte/StRPKkVfnWdsUa+NlbVOD+BstRLdKgunTfhVMX8tEDn4zuhe/mLXB4hcDjthLbABW8FEwI1qhWRrTqE16vw+AbDikCZhGbTwiW6HlGqKtDNLZHaOdzRUFaouu1mTMt208vBGNFdShmf4mZmDM15ie1ooUNof5z+gpphXrmW48J8sXD9IlWNZ4qFLwXdQgGmmxmuEDz3wE0EN8MkiEHprE0MN8t8bpLuCghzo9+Dx5o5d8UZxeUMAd6oXkKHRJTUWKT6WqbXJavbuO1mzragvnu/11rW1NKUX9zY0Dr7jt9rzcPONd62zpQW1uSV+R4rqF4UPt1n7N7IoVE311DUN9zZWNqoYCm8Nt5+0JacSe4IHbUywzaUcuLZV4nF+KOzRJelzOgqS4Q09Cd9isHOiHAuywY/2u+t0DG/rKI41NPT1NDc1BY5dPAB1GStKv2zm4gGdDYHbF8onCDr0d3BKquLve5HhD7VfAG67uncwZeQr9ORPPvjtgDo6P47cUYv0G7IAplD6iSSGxxal2uK7Tgm2eluv8IVab0Co+f+3Cy6/Y+drWDFrKrEB3nfvXLzNZPvLvyIK2ZcB5kU3oJeOWHqaZ4jCEKhAm7KUKSA9FFKS4r2/N1jV9j8EnOnpezXyzB70GX2H3uTli51aBlSwnM01CSdk8W+C4sZP9Crn+kAPuHrCQrK4PMsStICzwspssEZjI13sUi2eZZ7+QVuFXF392e0MDn1qB4vAu1UTPJ7JyKZyiNsZXVB2LU0y0rivpaixjxAZ2LBHENnYiF3hbvgGwPrk6NYdRTEQfaqMIGKxnaNWlAvSwgkAPo59nsYcV6G/zjtKwIgt/3uEMV1jgYPdzc/ZQB4IWFORLbjyeafsj8GCK3C9BbviiiD8aszw7i5Z0YJWV3CrMRXGHakqFOw9eC3EJ10NKMPg9ODzvcXuq8+bnTX0l6P2xXuY5VFGS73Uzz9LvZTDfcoEpiBrBfG/D39RToUh5DuZ5OpLR5JvSDmA+nlhzvPiNCl3MdzewPSp0Yz9OsIdtmO24BTUG3IL+4o5hEMS4AT438xzXgLHeP1LET/tTOkjyjRHvTqx8fAn+0CTGH7pcrnz8P6cRIhyBOHZFIXgCALGSRd3porA7groLSpgf0K1hZ5m51DZasv6ClOZ2lbIxLcVgkKdtn1q5cb1kRUlY+oWmr0+tbjDaL55HjWFTYR4A7PR5G49ctT/v9j7Wrz11UUX6UIa1w4WI0u3iMIjGr4xBNP2PMYgmgkEMBoPhYBj3P5fHILrOi0Gs5EGIX84Pb1GrgEL0eQdnFEuxxpYtZLHx1uRmH1iZnE9Czub3cU9eIr8T3w9yr/iQ6F4RdEQvXv85lAluEExYR+T36FgcovY8OES3InFfJtquoDOiM63kRKIxa2vzS9bNzzcd2X41cg+1Pw3nkbS0jhdKvO/QOe+88x6ry3HySU3WCZ6SNA9GlCSAEbXJwYiKGDBiCKso1f3T7sZLU1OsVeFikz1XkYOml//zdv7WXl20fu77TB9/7+Ul914Ei8if0WKxiNrzYBETzmdKQf9Ci8KpjFyz82cxZCKqGP7uBO533f9S1yN+GCJdr65vxh15dH7+0XncS07Z42LHEtnL4QSWwh+KpC+WQefDH0alP/rbQM5Eh3lEEP4gfW//7BqDZbj7pVMg/n/D8hfuL2dIG/D4atJTJHIpGzlajs9e0d0ntr+4CSollr3s9gPd9eKPc8hDBY88nOkfdpVny7pmh7FEX+M+2tN8uRUz4P3RgXzwj8gra63nXCVgsHkfRVgTrI+i7NUvKFG5RCi/5QuxX1WK4G/1ako0b3EeybVtAh0SMm0rsdwkxhxISEJ2NWLuN8Vg1rRarI6YtMZcPX5U7dC4Utg9hvOdiGIQg6rKkFMLVtS79l28Y/NBCVonbW7Ib7aVDc43NkgY1FhLW64/vHDTlftNusFuXV5rI5PfMaho6xFsT3nQH5rFUN4ipUQyQSLIBP5eh/hrSWhc/jDBs93ytzg8G4lt4aOzidyoj9QIGMRUGrKxJgAQtXFqvRiA6FoSgHjdgYYdXb0bCmpdncFIZ3fH8h8x/47u/kXaT9aubFpXVRios1namyLVPf81MfjfUd8pyFXG+U7dTol9qiRC+S3xOZvZe2q2nORa5n1fYK7WRarhlgBv0rKV0ZwsJjECQ6kERxilXqnXqjNyMninqdR4dxhFECvi7LYhuMPsSP0sfetF8tpwuFYedYkZO3Hi3aHu7qHYdhL7IW4nEudwgva/wZafE+WmInyQxPAhmsvqmSS5rHqEcj73G9HXCP13WXoOb3gcr2MVufdOgjfUJsUbIgFviKi+yZxRYiVj7gbvgynyLXKXTr71mmgsENWN9yiwzX11vKH2K+MNtXF4Q5Ehr5vIbLxAa7sFk95Vl3KSu5qz7dlx24JEn8VzRK9RZknlkPuXliVgDbXnwxom2vVEar0+SAeFvcN5+GJetz/Sxe8h1b/6FavgvyTOx7YkzlCbHGfoJRtJkP0w4AwLL1k4sv9bu7ddc2jT1ouu3rHz3Xe/aPvpyy//tI2dG1UkL+DHWALeRuSgfPFjepj+CJ/a/ZCdXI1FgBOPlkNBS6SSLq2GprGqixV+gIQJDrN4uxEFLrXZbH5bgUfjcbucKRyaSQheyp1A8RoT4FUU65UEJ9IgPTw7FGjV5IadfWMFPSVVrvWmXLtTtoE57NEobTp3fiuKNF1+xO8P+G44NLDQUYSojHOnCvwjc+E25gd2D8rMNayYe4GP0fYx8QVywV6ZR8CB5wP9acWgP43vyxF/cjHkr3nDVNO0N39uorw8HL7wwvldlRUBbcDo88u24uZedrShrXs4v9CfPzQ6UNmuHXCbR1aG2/h1MUfn4jbmQhv1S+L+RKpSLpUbh/tL1kA6dzKncM9NlwZxq+67f9uusvIxfK54fiS/MODDTSlv1x8mWJRzmE9gA1sK96f9iri/kAj3N7ByoGlsOC3FUlRQrDGoFUpkNOjbZBswTy49Nj6EbIfn9zWYm1XFa6d/zey1eE4TpiDKTeZgDpUnwv1JAEUSA+nTJuL+khIl4v7USXF/gu4ltH94FW7/RRs2XLTekNsuNLsDK2O/xu21uvn2NuI1dA7vM6L43hIqCzNOjaRi3w+RXwrWh2Pie0N470S4XVkIi5GgMuqYsne0oMpW7ajva6gL+oczvj+7ecdC6+4W2mK3t+TqVixfPa0+NMicC1192ejBZtI2GvPSS+ZXMvyhNgZ/6Dwv/lCY6d6aVTUDc7eiRzJvdtsD1bJtqKRpeEd4xShSj48z/xkIDEzUNcN3e/CeVkjsVy2RRhP+qBnJIb4BlY6XIfBEjpciBZZ6HsNGGMKeVmfY06rT7da4IGQ+1o/FcbL441lMXDByQEPfWF9T1xypGM8PLrtq2+XDtTurVzfUbisocw755kMl6/7o8fiKjMbmjvHBqiaJaSzQ7LJbG7S6druX+BN7iT+xGTB/el2KBHLviXGHMTqQEbeNdRiP2X2CsV7GSNiAUKy/MS/6a9CZWMdjRKUtfkJPEf0a2qFJij0UxL/KKGAPyY4T/TrZAuipTTNTa4/1d6almvll+KfuntW7YMe572h0AeLNB+S/HesQ43jcIPvjc1xa6ky8R9usOrwXyGX4WCmXQAhtqt0YXyPlayaj149okrh6steP1LQC8qFG/RssEtbdVthJ4qgijngCSAyp4cgEfwZtbi6WiY5cu8XEmrm0LoJ39GbRILy1CjbbHId6dLGGW4US6+IfrJT5m332Is36SYUh7Glul09tvOBi5u4Cq6sw3+19q31j2GD8NIP+oNrlunD+N8wi83HHzOpNY3XMJ5VEx5TieT6C+WXFM70EudhuZamxAEjBB0/WKmMUF+DB4/1A8tMhkSY+jABgUoJSJSvTiO8TFwYWzDbggIhXAseuYNIHOIsI+yyV5FEHfjT0VR8F9oosRsZIRcKTIitMWtp5npuEYbHZigIFPpvH5nHbPSSqdkasyYX1NwHvKLKWg+IwTx4wuISIgX1EskjR5QFboa3EOlzavybTO7l+7UzpTMPlVtfI1Cra7fb4ZW+VFmvogurSii80g70qfa3JtWPFy7/JX1Pa48+6ar9hoL93KCuwrb2kmNPFfVjvAd/C30Vz48JdP8mNS6wCdAO5BwNsKAsNVUglGhUdjw3VJsOGChduImxowwK5dSsado1V7B4fco15yc1ba0l92cBCcX0p3PctfkzicuRQXrhzcSNabtHQEtq8BC5UmwwX6qU8RnLnwuFCk9+5iJxF4ealc6yjpaJAY9bVmY1ex8aZtBQsMko0Bo0iB7m5O5j+cfEdzFnRDv5rNyW6MyK5GjUiTKiky44UqDMpMDT5xZGTYl1KoRscMDRZN6I7d5Lro/VHN2w4uj7Z/dG7ZBsn90fg62omNvy882NCtYmY0Dy1IVe3JCYUnM14RCD61q6Ld97T2zt/bfqR1qL6za01aGx8YHIMfa2zsrKzhjlXEBz9DtHBh7EMBtwl5I84FjFmYU3VhnVwe65WIpemyrCOKJfC7SjFuXm4RGhRaqcAB9d2g+cDccomrhy+WDLOs5kcrkwxpJORbI0G0kW44Q8CK3VxsFJHVJgqeWgp68CgC9LaokB7f3muZTg4v1Jh7St8/i3NRH+TqSLkrNZ5W84ccO4aU1R/kUl/0OIrYP70HH3t5vz5NdMFjr/VsOd1iK1VQc5hVspNdUc6NEiRkr5Urk88KOnyGJd5t8tugyjZxLFBD+OSEZPmU5Tns7ICEIUaSPSphzyfQbpiLIf5Wc5Ygcmb0d66ymBEWSjwC3rHhg0HMvKNb4x8fPvtH+vb2jJmutat9RelSlOeZlpQWrrq4h9HOrWUZPEz3P7VxJ7ionyQ59P0ZXk+tfF5Pt1ut8/t83pcTovZSBJ9KrUxeT5BsPB5PskmL9y2u1lsJMnzuXqqP7ehI/OVzA5DtjJbnvmz4iFDx/AY88NiuSxTr9s1XPzRR7fffvt/q4pXL3/6TfzfZ99at2xVSH/nnXfiuWH6P7ffxib6JPbbiZzRr4nNt2vIZbPYfNuO5d+Dix7Odnv+PJ/aaJ7PmfPm+ayIy/OJ2YIW518RzuHzr4B5813mQ04Po7uJDRdinK8iMc69eF2xNjDQ3FlPAHHSNiGiqVOETrfTo4d2nd658zTeCUfPPRCNH0d8AfC7Z4h/UrJ3a8/z7qh8o/sOzt8/P3//v+COnrUJk72KIusGcOSlkSK4fSKYF8mkHHGxerAatjSmhFXzCaakYjSH+cYONJy+/uRWCPG7fGTk3CKbYYz/VjGxcSd+S/s//VbxmJK5dyvqzZ57YAvMhucHBpibOfzK4uLiZ5hfy0m8hizy+z+wrjVD9uzrkuT7iebRUFBp0LpUgkCUQz5pQPiuwq1yk73aQ/VgSU6lpKWkYVoF3MYq9P4Q62Dq9Uokj5Tseev4WxeV5M7N3XsvxOG7dwpNMPcn5F7l86fC72z+VKENgIe1RkxyrAACZhB/meLAQh6K5GTFX7Tb1UGJXUIPnDvz1vHfIvtx/KmH0BdfnqPULeQo9Qg5ShVfLUcpFrW0ibR/ISY3YQLW0E2whh4kej+KxmAgWQp34f+L4mD3xcZ802PlHNA7UqzOSqSylbzfRaHgd1FEEmkYc+Ek5bIrFIbzZlpUYBkXDfd2QWt3d2tbV3frh0/G51u09fdTvP5G5gbBPoG/EtGV3N3C0ddDx/YsqCWZ5Cvs6F8nTjArTpxAd9FT5xYnJ2k0gfk2weXKpIGD+P2gL3bj3+Uc/pDkzsRMQ+z8UqrYESbxYIJ090X33nvhr46L8u6ePz9lC9kL8Z+0hswjBTcHJBQtY60IBC/vFpKJe6Tintgr7BL8Q1KBLzKt6HuVzN1otpYpQT+mB1Yx+1cwO9acP/9lzOCQ/JeK/8P8l+K+oRJKHPcC4poBMg3vKOTGmvNgccOWgiee3YlnsgzPCioazoJEq4FPlx8/QKJY7L1hZLStF63ZBuErNh9mPo0Q+D7VxK2fDEC9ZqRjvYeSSFnAP/7MJPsZjpUwyTXKHOgq1oTtFSFJBf5Lr30ZDTKBv/wFvck88ovp6alzWDmdeqeBSppzk4+FnUKZI3kAiQFEKTiWkM94wE7MzQgl67OC1u76A0S9/gPWih+AkNfMGIw7Lz/YHJp4/8VzNzWNVmBFdHUKhMrHRwI0R6YyO4khcWaeAVJnkpTgmpx0hfGrZM/cu//CFXsvunD/im82RrrHuiNNnfSc7PChi49JBwelRw8fOizrv3V8zSp8jFxgLpZOr1ozgZLlzuRzvOgBR6vNSMWCloKOY3XG3c0KKC1W2wlvPXygaQjiUlnBprHVOj/fvWtzVeea9urNu3dtfSbjAIQ7/WdHVyq6i1mZ2tWOZMzfVx/IeJZd1+DfX0biL5dECvNkNEVEPGceKCTLG2tT7CLED9goq1LnVupAuKgIC7QAp+IsR4RJWGhWsL5c77eHqt664OKGCwYHL2hobNzz23CovYNes/fIziPmkYmmH274+vDw1zesO+acGDEf2XnJvmhO8Ne42KYS2eOLVWSveo7Mv9e4nM+4nPk9KT9B1gKU+7lykm948QEir17jctpB+Ruk/BmyTqG8iyt/h5SvJvMNyvdx5cdI+bOEP7ic7uPKf7dkzjwyb0n5PrYcsXzehP/4kOylsEJpcKmhJSup6HymKG7vlOFZzWYEtmvfwRtCFr8lzPJ+nbVEDuN1SKJ4QTgbGCbZJIwbP43F3mEKA6fAkZz2Srp22d5dFy7Dr/zw5LkH6ZFTSEPFyRUPl9O3nMyNLHyO6z4FuaAlEA4Q0ES6qIAD6xmJrFIABiY19Ayvu2UCAQ2BTrKzs/OyDV6PGnrniq4k4p4tclynyzaunl+9EWTgUy2sEHztKe1LL2nOXgdikPnsyGWsKORjbgZJfD19RGMBjCd33nVjYVdIK3R+GZt1j/fU48Ot6fTsVEWRokJ9KLx1Q+ctO+/Kvmr7vLWzZWawd+w6nd+iNhr1hdccWH5icvbglubRGqO7rTo8SM7k2whuF/TDYKSERA8jefCiKfC4Kz/RWBDFzW2X42Wr1vI2VuKjqXjvGndprlnjsxzdRcKN/jA9czBFwfwCQo4iqo7TL9IoR8QKcXY6OYj3Kl7kkt1RqQKJgCDel90LWhBtQm8vvMM8ofn3hX9H3SjAvIkCKyA2Gvi2c7lW0ylPxJkigzTC/HYLPpD8dMTzR6VWwYDZJRKv2guR2III/XpmaOqw6+H5jx1zWCHMYD6j0SXrGTW9auBcH3v3P4jHpZHstXo4dWhVtBwfOyQoFR894P6PRF6aBwAa/iAoRQLCroD487kAPKcAcJnSGXsHKIEcJcFBvCo+EoLQWd//7cJbJ1tArSwR4p5uR43MK8z77Noz4UaN4nmsombZA36mKj2F+DV1KUlmrEz8l4Qro3lrYjQ1Fr+Bsqmx3EJqrEKufPKUS6WxwQCwqbGUZE8KccmxStJVeZmX7/7poWtnjfUhh0FLr9ObmZ8zX5CN6sy7jcH0IVY/307aCbJmJZE1LzPXk3VJ2g8yhZRjmUJTsfm/6Hr+Pp/Laz3O+SOwcQsNkK8RTvpZAF3KJjZU0gdYuoWClbGIZh0Lc7GeAqNOxefTiOZF/XZMGo2RI5NX9Q9ehVksSp4xNPyNHfPfGEnQzYhN61PahduVC+3SYtZrwEeCc7ACtxChXbzmxAJ6XS432y72OkXkHOFg06Eeu6P/qskjI2FXW9n4+pmpkZ5g2dom+vmzD+74xvBQm9F68WVXHwx2uBzEx5nnjRvywQF3JEgGt0zSbHKjArhUuNyZI5ySx3MqCtDhOJayJMdUIneH83DP6/PZrT6fNRkXmd97LRYv/MD6ivLPRXLtAQfx0TcVAWaRimk772QTw00DHhCDy+C0mjmupizF1ZimJ+VwltDyBE5HGy7s7S/ieRwi+d9OLlYufo1KfYxGZxa/Bl40SWhOL3riaRZXEJpTAs0Z5o3FK4CGPrN4BUczTWhOCzRPMq8n0CzEvecs8+cEmovj3vMU81ECzQZC84xA8zTzl8UGjqaBo1lPaJ4VaJ5h/pRA8+c43eelRTYfvSSu/OVFd2x8eHgn5I1fFMdOXy+U8/HGUxbriS7Mlktkj9E3ico5nlNOdlwQVx8/PnG0ZHyS0y6uILSnBFoyTmJa8XgR2tMCLRmv89AuxL2XjNt5aC+Oey8Zv/PQbiC0zwi0ZBzjaIXxJLTPCrRkPM9D+z2iuwLPath5z7xN5jQS8epMHM1p5ocJNGZCc0qgOcNcQeYiEvXBRGhOCzRPJqHxxr3nLHNDAk1+3HueYm5OoDkZp5O/hLWLZLr6y5yufhfRL6GPdRwfnkjo4zVxNKeZf4unYT4lNKcEmjPMivi2MZ8QmtMCzZNJaM7FvecsszGhj1Tce55itiW85x1C84xA8zSzhqxtFJ0DzNuE5lmB5hlmZTzN4lVxZ5mXmMeSnnFeZs84VDueg0qynuu49XwLy2dSzvEQ1jPwGXH18fyOoyX8Tk7LfEpoTwm0hO9iWjH/Ce1pgfbJJWjPxb2XjENy2kUq7r1kPM7z3ncI7TMCLRmXOFphfAjtswItGZ/ktDDv8dkSeNbAzePXE+bx6Tia01j2xdMUEppTAs0Z5taE+ecnNKcFmieZWxJoVHHvOcssJNBo4t7zFHNJwjz+jNA8I9A8zexLmMefEppnBZpnmAsS5vF34s7eLzG/THomf5k9k3Nn6WPsO0X7GFu+Xijn9rHFV4neC7xt5fj/2wQd4RtxNKeZM/E0eD6z+jNPw8sROmYex9I8mUizqIyjOcscTKBRx9E8xRxOoLkszjbxEvMQ6e+34spfZr5Pyu8l+j70sZ3r49MJfLiY2DWApoujuSlBnn5AaE4LNE8yYwlz44dxNE8xdQk0jxCaZwWaZ5iyhLmxL87O8hJzZ1L7y8us/YWzpxxj3wlzA4ntLOuF8gfY8sXXiL3mRdZeQ+bGWwnr7s44mtPMyQSefMzZxXiaM8zyhP5+FEfzZCINrM0YmvOszRiaJGtzMSWO5mnmmgTeyuNonmEuT6C5LM6exc+xb8eVv8z8gDtj1kffSfaYW1k+k3KOh2SPeYvbN25N2GPujKMl/E5Oy3wc8z0ny3cxrZj/cbRPnp92URVHS8bhPLSaOFoyHuehTYmjJeMSRyuMTxwtGZ9ktBDHZ/ETuoC2UFrKRq2JZJkzU2W0TCKF228+GkUu3HJS02CXo3wkXhzY24rAToG1QFxEcppMQ06TEnH1ZESt01GUzqazGg34A5oCtUKhg8NrKCjR6whW1ysOVQlnWY/HiZoGMvPWNOTJdDrPcHZa4MKZtZtmncHl3iaNqqqItnQPXct8dshgUExmDYZuvOrowa+PrV7x9Mi2DSMkdokH9+cTSkP5SJ4/fGb14DOrArw7u1JTAE/MXsjM8VHZvCRIK39m1Wq1Pq3XZfd7XGDP5DwqwXuiXLA8q+KyHWuVuiBdULOmvq9xfufK2pWh3pa0zsHuorT8oqrK4jWlHWjhO42rK0v+pKT/PjdfNFLZPpTBPNHW1NE9XFsbCl3E9LHoW9tiPh2mzZSKkj+eJUclfiTBXCGp3kMeGg7MejUd/mVu+qRR695ZN186lnszLWGU4caC2ozKxqrwzSityRd5+1L0TWIfq4bcSPTHlB13rCxSDLcoRUbw+GZlGfE084pHDA+mB1PbCl0yGKioR6tOb6E539Jo5oggHY3T5fGie7oqrVUOX0AdKOqcCNRu6+reWjPaWRnYPDNV3lRb12ioCdMf10X0ahvAblSWtjVdHRe0NO/qHL7QYqwPNPcy355tH5oaH61qLcmlxL6obqor0g7xs8AfVYVHkgdOyroomZyDDXJwgxKx8QTiFlvNBn1mukIGUYsVCo3fHZsII9obLq0rmy4DlddWttSvGggFLuradLS5pap6/4rqbfnltZM7KsvmMv7o9vqKylut7rG+mobUzLpAc7fRFHG2272DuN0bFm20lX6fclK1kXQLiVGak028fjx4OaXz11desGPnEBj4KGc1QVT/5Cmnw26lcUsRCY7DsR5MJITPJAltSI6nn522br+81VRXHWlyDo75i4qUnvz+6eKvP2K+5GgmuoC+ffrKfXWFlS6Nzl7irp70dOUGrNkaZZY5PNq89sULMsfIfduij8Tqy4V7Ga1KiSdHBrluk0pIkB/ONFnCmSBZA5naJyULWavEy8LDo2LLyQwF+9iZrvl0uw3iixnWK7Ikjuli2jLYc+6JTNpeWmGAyGJoS8dkdmapLj8g4H0+5vKNJcf7eAWP5yI24RiJ7W/Qk5Rj2Vks3kcRH/6WhPeWcIifuy46sGPn/gM7G+ok/5LU1i9I6+rqaqX0x6+cPvmD10+ffH18z+WX72Eev3Lv3itZe24FbpeS+EwURwIK4g8H9nfhIsIXZ9LMprJdDvZeBdzpo3NMWZGOlAP5fpOuy9c7jc5MMIeaVX2ZyrFu5MLrtAvL4Cq87iFupjNiSwO/Bzxn0hHqkLNxkX2cAV5thdsGpGClJxafajkLi/YGadPrR40FJm9hg/Oh//pn1nzuZvRf37/eYpRPyQv8P0DSig2VzGk0PjvFYwE/oWuwnFTD/R/mNdVB8mhwQH0fB75Wk3lYhGWPhea/KfGqUUa2t7Eye3xjoy4wGN5e2Wu9fstTdE5R2JEylFGzeebMz+s87W/dz5QbaBne2wewXEsFH00pmx84j+SetVBplDaigvgAtAx8bKCDBoTHsJKTdXqJ8+mN4U3BEdNN27535D5kKvfUfngLetFw7p/kPVN4nZXgeVMKeFHcbIiOQxUQs7PZRNMAecfjNSuYoL2kV6VUiZ0zPCfJkBO73LjVxpujfztabu1yVzfVVW3P3NTc5+zsq2myD436/SW20tmNdXOR6ub6DQ30x7UNGk1JoKRkrC1cUunO0zjLvLD+tKV2fW6OPTzR3j+ZoW2sDPbmU0vGei4RYj0XJcZ6Vvwfx3qW4e9WkDjZeHdQYv7lEMRSlwxv/TISZIyIVF907esonVupNMD1EoILYQVcDcP1kpyNrGPXoj9o81wNNXduNTi0OkNVPjqJnmTecTlTxrLaWlARxHFGMsVgeso4e4czguWPAfc9E8+KmkgYLkgUBDVF9urzsIIEbMzLMmjVELCRZYVSvFFjZmgF8zJtKF7WNBKc376tvkxdaauuDVfRFuZPfQe7qr/IRB8cuWJ0bv1es2XF8jUzPC7bQ9rkotwRB03kt1aD1zyZvSSWcwmZSS7K6ZaQYUjYKWPFNZ46N48XlFurPZHhvPqGcKOrf7ywqEgVKGseCTTt7qYtJlubVj09XhL25WpcQW/VsKdLnW9V67UqQ82y1sG9Tfw8qaT1JO9IP+serodIGEQE+bpliNNoiGpmpiB8GD65gPNaQv1kJJPNQKItd+eQ4fTqRJOpTA+XpV4HO6noyh2+woPbth88tnf8nh/WNNT0FNTWoWdSjKvbLrruhkMHrlcwVctWXVlhG+0h88qG2ykn8wp8OLCI1KXTWNfoIj48bFtFwtyhdDkd4C7i5rErLO7WriUJtEK0HKTmVKG90q4KTaDx5/rz/UoiO93y1CHNOPPLZhWPH4dcEeD/aIzkwsd8ZNLMsN/RONQucncmgGSC0QRd+tbtzZOb56fDXXnz6PAlk3url02g9czd66fWHIKjDGXC87SW4CucVGck1aRWgEsuzanIWSSkNOyUWHaC872KbA9QiqahJSVwO51D4A7OXAd+i84kYxdwjkKrIHfUIc7XA/iPd34tO4Gc6I9DH8xu21i5xphX1tg5bMpTtFVlmPNoy6VXMIv672a8kbaw/drrhg+FZ2bSzm2d7/fUVX6WNruyY8TLyXkXXuNmPGfkj6fidvhlCrhk9Xh4EUtX7Lj+xu2vlk/Wbinuch3a9p1XtaiVeVqFDlx0dbW3/OgGZMthHiDv4uPq5VF5EX1udlZmBiWHyOs02TC0Jh04yrghzp83yPqxkJ7xviNoWVm52rDGuHnXivkNayvqV3Qp/N3187ddesWeI5kvZP4obdso6mbO1tYp0CuiHIGAA/RGXIZcuQTS1sAxw8c6AxDgIujsXrfG4QQvKhYVxh0qQlGZWBEShCNk+uvr3qgxruzpDS7TK01ul3GZ0eU2qvWzaM+l+y7Ztu3QgRNX9B7pGR0d7NuTfXS4d2Ss82g/3seIPiAJ4XPVz4gt4Du5rI2ALZcI5bd8Ii6/Wyh/gisn85S85x32PW5xuUQo5/HBbPndQvkTMfhp/B7qpzHvIXwj738vppyc9Uj599nybLac6Nmk/EdseQWPuce6ISn/CVvuY9fZGvxLNp5TGZQpYlDIAVpKE5+ElexGkcu6SbphBROlUKu109nMO/OGdTkqZP/979GWic5s+3SPgX1fDv5OmPjX2iOWVOKTlyLB2w9RRViBQfW4neSlyIl1Tj6Qm50O/3x+l8WbqzIUe/HGcubcgUz6uFQxnKpg475ATj/AguD3KlNZ3y4sMEmyAF6l0irz4L0udjOLSSGiRH/XGJz11Sr5Tw9sSZP/aO8uZ8ZQdnez5wUvs5LO+U3VDj36OnMZF78eZJ4Fr43ySGkOlnPZEhLSQUJJungtsaRbUEWKCCo6jzK42btmnRiCH5v7+IcT3qCz0tXS09zsq7OXF42H91zSsKsv02pp16rHZ+dm1JpWm+mmS0YuaiIYBDaeNcipjkhrFm5CNiBmWTSyhLuzlbB3tmQ3KOmWI7FjJyuiCCJL53ST+2ZXTOqc6N1zpfjK9qbmoHNV+d7LxHGo/D6fFW5s+ws7LM4bD0RDUC16zHBdawa3MBHvPNBmwj0kg4C8UmAg12YK2hzLSTnLSaORooweo9tu5TiasjRHxTfN5+FuBtfwZFxG00LjYU9m812A75In4pThY5OUbpfAQWEnfxVegno4v6QCODe5eMHIRSQTuyUZV0xsnZxd2L5j/3ew2gbq263HVS9m/lh57fzBm2889DxobqDBcfhViG3ZQnmxbMdKeYkfaeRcSNXkp0aIwUpTBR31VQ12c0tzuNndPxYoDuQFQpHRspXLjJUlBro23OTIyTJXFBVWerRqB16/g+52Xb5ZY1CqtMHJ1pk1BkWW2gF5Cbbj72vI+iqK+PH5iEJdmRkpEsRq+WgWJjq7fMls11Bqt8tJFG+5lnNOcsJyhkSzCgVSeO5wleYaC0pOzC+b/DDrF+iMz78nPbMni7kzh64Znh5HnE0gg/6U0oKNRIL77GZVz1BI5uXTkincevRtt00xJ/UFGplfWGbZf/vrkc/63e4Jv7Z8Xd+usZHvdk0UaivW92wbHWblkB6fU7LJu82RPK1GlZ2ZJqc65DKalURYWGiMcP6iVCxr8T6ncKo94LCEJxuq/nmuatKavnr8VrXx52v+OXS5m76aeeXT7gcjmdfd3N36EVpXXMBE6KzRjg72eyHMPzvB2uL9TUb0TI/DbsszaDXqTHk66uAnUAHV43IQPzNxeiXOR1TixWdwImVBaAE+X0/bx3vbK/K1dr3FYcjVpbyzUp2H5Zg+5Z1V6rzg4Ki3NSPN4ZpUhgryT3uYOSta5XZkDGf3NOY/4UO325g7vM4MfC5vxbxW4/OVlrJSAch0l6vGkzsfjuZdkKaXZF9T8NnXvN0pIjuazQa2P1vA5ve4dFYdGBg1bncqazbQxCbikisqgx65IlQpZGIjK1Yh1wXRS/3hDe17t3Rf1N7XPT5s0IwPppkm+o0GXV1h2FBoMaHyBvT4rmWRrY2nHzn05Gx/qGG1SfGnPZeku0drzaZzDwy0dvdlZGceO4TXajvujwX3x0rlQ1xjiDRF0RIIPiUHhyw5iVNFcJExVjGbzZZv8zlV7jKnxpmTpjDhTYgVINEoPBUV0Q7pg9FjJW127N5fMliy1W2vrZ7bMF82HtqwJ9t3R2pt0FtcE0TXox//KH+w5tTjpaU3Pk4v7y0dKrnqIFo+XuYrIndXlBPLlwoSLw3QVb6I22rR66SsSQnP/w4IyRxjIjCoaCJjokKmMoTVHzw9pFgJk2uloAMp6YrQirqNK3bBnyt3MhNVoXlUV1V5dmeD9EeZb6VcumsA/+sXGe8pLts5sUyGdqQ/+sDDYzMy5lqQ1xTmYzfBpgdgt9NgOe12qVOlcjg7wqmDQMJ9LDaNnJcwF70ulUvjcuWkEP7pYmNLhNg1bJd7ZQkqG93dUNjXUVybllnr7+zxGx3q3GAQvXGhjnlXY3TYDNMGh92Inl+7Zc8loXAofGjfljUorTtVgR6fQ7NbRsaGeuey5of6RkfJmoP4QrDmDFh+5ID8EG38XnXMQkKfaQyu+ipYNQjrAXXVupS3V+10gArQmH/SJ143vscCZN3wZ1r2/Aj5Fkci2TZ8ptWTmEQAqW4XJfFjd4duficmrn9qNhTUbLQeYt5mmM2QkTHgLgT5iUdSUUSDt6kQpJmcfUHu0+KjL7q2NWONQhsonRrZvnXbntLlkdFSXahqqFxdYQ/VhyvWBny27Jz0lMzRqX8dvfzSC9r3dTV3e7zaFNq9au2Awzk7OjIamydDDyPOahUQMxvc2bqimoRUpEkQPChoELIlNIikWkOitpCY70LIK4V+wOnIPmJDpKl3SHsz8e+V5CxYEPFmpYPVG3WpEU3M//hoPE/MXJzjrE6pIigCNpgVmwpM4pTgaSBR9F82MHNpYEO2FK1eM0FL7WvpHOZatP3cR79u6Cm3MsfQnuqtQWYqHfK+k2+CqHNQzZGIDoLvIpmchjimCOsEFNin0DIsZMgCKWGj/YPULJJhdtksebkgJp1KtVKVig/EUq9WCGhJrh+IjcMr0mq0SBO86ab5rq7t2/6jZFnjpepKW1VtqKq2LLN6Q19jZl8f6jlyBTF1XMcaOObWC+eAMuEccDJNfD6Ilp9+UVweEMrPfCAuLxTKn/xpcvqzmuT0T/1dXH5QKH/6nLh8QSh/5r/F5W6h/LY/isv9QvkNMeUZQvmLMeVqofxGcTnEb+LKbxfK68ldGVsu3FGy5cJ3HbLv/lGoTVr/QtL6MqEexmOpehiXxPqAUA/jk1hfKNTDOC31PIzXUs/DuCXWHxTqYfwS6xeEehjHxHp+fJyyR+mmGP6y59My4Xx6soRKWn76v8TlAaH8TJa4vFAof/KL5PRnq5PTP2UVl7uF8ttyxOV+ofyGHPE5ukw4R590JS8//Za4PCCUn0Hi8kKh/Mk/Jac/W5ic/imVuPygUP60Tly+IJQ/oxCXu4Xy2yTicr9QfkNMeYZQ/qK4nKyfn7Djiz5P8h68fiRCbdL6F5LWlwn1wN+l6oHPifUBoR74nVhfKNQD35d6Hvi/1PMwDon1B4V6GI/E+gWhHsYlsZ7nN6yf6Rj+snaoMsEOdVJNJS0//QNxeUAoP/ORuLxQKH/yt8npz5qS0z+FxOUHhfKn5eLyBaH8mb+Ky91C+W0x9jW/UH5DTHmGUP5iTLlaKL9RXE7kPVt+O5RTUo7+GqwxgMXdT01ERmEDdyKZwoXkMgnR5zoAmYymUyX44IvPQBCShaA7fYDzJOFWiuQ9JlNOjlRq8pv8Po/DZjGD5V2nkWZLs3zpCsiT4g3JxeZ3sV0l7ioR9RRe26Rwu40mt9v0N/yT53EbmW+LLxjpz32HG+51GY2Yyuji/2Z+HHPt+H9t/x6+tnDf3aL+Qetj+yfpP+y75X/QP8BelFKN1BMRjU6Lu4QPfBKqCqWmV6O0VGlX96N2rJBXwEU81tHm4AJcIqUlc1mKTAmEtwL3Fm93NkpPJ/ENccdTU9OmqbS0ojSsrwcTnsP05NEUqWwu+VOTEV9ZmccD2I6yxrLG+tpwZXnQU+opCRSIsB5uVw7YSjxej8iApY+G4JGLeFkm+rcsnqNtVnW2Ol2pz2zQVLu1dlWWOj07N6tBU+P+rsdD+PuMx0P4zdwfw+eMrMz0VF2uNVCZnZmWptVbi0q/5TKaXC4Ty3b4+4FYrkft0iBXfs3KG3vy8tO/EZcHhPIzjLi8UCh/8oPk9GcLktM/lS0udwvlt8XYz/1C+Q1cObmTJO38Ldv+/OTlp98V2+fLBPs839/4cr6/bHlAKOf7y5YXCuV8f+Pp+f7G0/P9ZcsPCuVPq8XlC0L5M1JxuVsovy3m3sEvlN8QU54hlL8YU64Wym8UlxP5+k40Hipenyw9L3+KwcKEiBUsidyB2L0+ODCRnORF0h4QOMVFBT6P22ETiZu0LxE3qiS3f2gqiUg9KLoRPI9AvTXhnvD/oj49nUSMivt0HiG6VJ9YOdpK3RHJiMpRmpOfJV8iP9NRaqoPAo+lzGBxWJSCRWfReUVnKhadCQ9MRlyszGxtidTX1oQrk0jM7P+VxNQlY+DIV5aa+8Vs/Soy8/dxTBbu7MqEOztehsSX8zKELQ8I5bwMYcsLhXJehsTT8zIknp6XIWz5QaGclyFs+YJQzssQttwtlPMyhC33C+U3xJRnCOUvCuX15M6XLYcz4M3RcuE9+IwQrU1a/0LS+jKhHvi7VD3wObE+INQDvxPrC4X6Jz9Y+nng/1LPwzgk1h8U6mE8EusXhHoYl8R6nt9wRpiI4e+zi/XotsVfkZIJ7pmEMizVGoksZ+OPOMFXLwXu5mgZfxEAvnqNgq9OE1woguMSe6Uocl9KTTm/+5LYEwXdeeGFO3fin9r6+lr4MeHFB4uOfv7Jhx46e/ahh54cO3zN8cOHj1978Y/xcoSl6YHcSnhSqQiePT/iUWBlFrHQ86puKXETAze4amKkTKPSNEqlLEXvd5NQMljQBpW0ipm9/+aSN+cmJibQH5b1HT53Lxd7Hf/xT4LnLYkUQso3Op2NTsLjiRuF8CTVXKK2XK9SD6+nSL/kCrvCXsEmQ+RkFBqZKw8f3ImqMpjhw4fKa8sLG2wd+Rs76efLJ0J1O69cPzV64OrVwfJauzdcUcG2w0tyTDzPejl7kFTmxhJUDtHvc3C5ELx2Tkhc3Cggc5tIt32U12V3ugOKFAPXMoUuIRy8yMmZ+OSgwdWVvbVtk/U7upov8Laa+vyN3cdqMgvKW5sqClrsNRMX0c8XD5TUj2UpxnprVoRKi2sdjpbqvUPhitKQxRZhbfD1eGzySLyHQCRfDkEGSAKUDhkkgSOBjMA3m2OhEqKj5MhTuHSi9gq1XhKE8Gl03tBm5t1Xlj/y7fQVQ3feeWcf+pmbmT5zJprrNQ2PvxnmKI2kCDLMkIQLUolUBvGRSXoAQF2THFhVQmyAJroHApJ5HDmKFKMfQYjFMl0UtBzlh1NpR+8xf6uoDY2X1s93LYw01QxGOurKcwvNw+gSevnzxvK5ltZNNVMNjb1tHY3pGWgVez/QgtuWS3DVTva+m0ZK3HUdkkpsSCaVQsRwCNYdvaNvjOYuaOJw1U4D3NHnUnqn25MSnV1xNnZFJRvH0AGjG0RXTZTXrGvav6tx/0h/g7+oom1EWrcyt3qDr9VAVzeiV8pWt3fO1z1+286HZgs6zJfsHGQOj3Rc6/ds30DyNC5+RktI7CRzJI+9ryT+qdx8r4IAWXSKzh+CYEZadAVKYV5CDzEfaei2iYFz1xH5UYX7bsV9z6O8VBDus/yWbBqWZFe0r3woI9zVgoDfJ03J9VOi2Unc4aOhYKTE6Zizh6s8Hq8Q5kgSrm7trNnW3bMlfCxcVjcXqllZwzxrqSwJeMLBYPhPnsb66cb6+mb07x126/K68HR5+WToglpzZ1XNcEH+QJWvwKg0VnqLQ5WlzG+CNl3xisq6hjKK863/gM6hn6M0lI2NAC6h08ADlc1ZJmODk8ySPoH7YiPNZpywaQELoaHUfjkvANmrL7lCgPBXhiqF65GbLxy472rDldelRabDU8G6jc2WehMdaqmuq66gnzt+8KrHNjgH3Ret70SVq5s7N4aZq12O3XM9Xe1N8PkizOsCOkJlEs2tJhKWQ34+CW7cnCC1RZI6Lw/8Kll1KsuQlatRgXelW5DUvPf/+WX1PZfW7ezr21l36Z7IwEAEfvI4vYeO3HbF9LH29mPTV9w2snrLlnXrtmxZfT2rdea52bxQtI6ujJfXiN7x1eS1jll9703FP5kbHx9Hm6b6DjFcPrZG/F4J5oEBfBRE8poExqEkJNnr/1Baz85Vei68CLkymekrDuXXlAZa7a0Fm9vpSPFgMDiwtmtqdHZ9c76/wpUfrgQQPlW2eDk6h9vgpVojTW4sq12crIbwkrSU5OxgXXJ4oQ3HhPEoJoANDIvFtSuZuD6/tB5bUdpR2zZSs7X7sv5Ga7u/oe1oVaavsqmmwtdkr564kI4U9hZVD2aljPZUL69YXuuwNVXvHgyVBcrMloYhwr+qxRtoH257FkTmE8lqyGInHU2Q2FLUe36B7ZvaxPzileWPnk6fnXIdP96DfuxhZh99lHynZfFyOosOURbI4pJMXrMBx1cKchufpyTjnMyW0P0QbfZ8IjtOZn/A/LWspmqirH6+89Bwk7nF39DZUGkI5A2jI+jdk4bylY3NG2qm62zWnqaWCJbaU/9/ltlDi0cRg9eVnMSDQmx0M0BBCbATyM5C9SrVILmRxEsC0DH/XPcR8wp6EP3nuTsddGiC+v9UdoeCWHZXr0ouu9/qsIlkt6UzXD1SkD8YXlp2H8GyO0Jkd0OkNk52k2hzkAaaFeLjMu5OW0L1f4kId55HhA/ef6Xh6puk1atDk8G6TU2WSB4KN1XVVwfpyLX7F+5b7xxy75/pCq2qa1oXZm63u7bMdDU1NMfr22rKCDklDbnKHCnvCMttLlEPPsx2jQYUbo1Rk5ehzlARZVuRRNnWq1lXG69EF1Wy6xoyXzJV1delYd0lRsHeVIOu8Z17+/DxFWFmj120t2RROrxm8Q5oMmrUpF1SSMZKGChulV6fjU80eovenK3L1uLHMj1sqxJ2lpiG7d1Zj7eU3p31l+5pHLQ9luduHHQ9bsqnI+1HJ/F+0nFsCu8nazavq0Cr0pnpdVu2ljG34k0MMe9TJ5EJfQrxPB+XgN+zG+lxKa23n/vjpxDSi+LxvSdJHDyn5IlF2AAkkptJtEPAUX7OxZSFOoga78R1HkLzAHU3R/OXxX/QGziaEo7GSmgepL7B0byJaY7QZ3DdycU6jqaGo3mGo/kCf2uWe08VR1NAaB6iTnA0fyc08J5Tixs5mrI4mj/gb+3g3uPjaDIIzcPUoxzNG5jmSq49fL98HM3rHM3vMM2F3LcGORotR3OKo/kVprmYfhrXnV7s4micHM1zHH9lmGaEa08bR+MlNI9QV3E0NKYZJzRnFjfHtOcR6loRnzfG8ZlE/ZA8Rt0uotnEtXlFzFg8Rt3B0fwD06zkvrWao9FxNDfwfMY0KyDeheTsdeKeP0ZdT+TH8cV/oFdRO547xFNQSBvPzXaspjggAmdKYgROgnGtQK8OdXYOD3d2Dk1b7Y2NNtvYzLKurpmZroqiudXFFWQ/xPxDt6BGIU4pZIfsEukqrLx2E+XHiZomC67rGH+/uGqYeY7Ve27Cf3wXt5FgMHJwCxVE7VHifauTSlR9nF6lmm2wXBGMajygReCmo1PmlvpvpzMfDPeYTbmlrura6UjHc8WFlta6kjKXRqP3+1trish3r+V44wIPGAdEP8e6DsiDbIToLMBqJlN3EM84FlXjsLtcBaymIyg6fHJvAXvL5/MOoh3tdnfAN9IVGDJV+GvsdqutNNVdWWEsNhQ1TqD2Up/JrlA4nIUhk7nQrVNr1UGHJ0ddDEd56hr8x+uomz2LSkmuIUiB2sEGk6fYVEME7VdNcg1qWNXGDsmqQnoFUWy0TnRi5InDXVtG07rw3hR6y3RqeLiRHYcTmB8v4HHMow5yUBEtouX41bSUxCEzCgUStoCLCmcCh2c5hN+Vgyosj+GSMeIEsBuedfNRMi67QJRqMpIGgfhdTjtoRa7Y4yvEIYfE9WR4Xxhuna4q91VYbaY8o63+Hyl3Om3ljZW1lUUOg16nzzrVFMoKBYW5/xoeXw2W+njvVOOZqQHoHZb5WBeSEcMDKIS4IXicpUgGFghyrq6GI5DWojV7XC6HjYwubkasJRtrQHIFr82iDfkD8sKqYOtoY9/IzEhdsXe7L8VqNVuDSDbmKS+taJzq7FphrJh2mO1GXTHL7zsW/4aeIuvGEbGKzqjx6g57UA1h/VQrefXEc8h8d957LWEGPFOoK3Ef3yBrx0EFwKvbbcjk9JzEpe4ryPeyK0cRPQuFot7dIgVHR/QbIgGedtn9/vGenuF+q6U/0tT3msWTqzWbTKYFf2lZm8PzC5s802MtDFUUVmnSHGZ3SYlTlZOSkpOZkZOTvqBOzba4NNnseHyBvofbqsLaAckqzDrl0V0qJavlkfaywTLHpVFVRq1WG9V5+S4XnHVcWHmJuVjAyyrEZfbCWr7WUmgsb5lq6h5eOKK9xYVazM6aZrcvJztYWl7f2TC1PLtxt7olV5ePZflxtAW9Sp/FH/oWZvROKvUxij6Ddgq5C59D29EtovjLrFxjx4Wq4uUaipFr9GhJNSvYsFzDz38Xy3gd5NiJl2tsKjxiisMjVEULYo1aWqyNdLNirW4q0kEXFxWZW2vLSp1aVq4Vs3INbcL9OoOl0+aILrlc637UiBeumc3rPSsY3qq6+Qa1ADLMGHPIE9NJ8YrN+n9fANJnxAIw4GIFoDtHhQUgln+Yn6/jPZyc70TyD9CDktEEKSiBpcMLQXR+IYi2C2IQy0DMuxfwmOdR+9m8YF9BBgKZUST7WF5xkbOrZJBiSBCBguiLJ4qVgNSXSsD8cpCAZgtIQLujvBHdV1tZaAcRmH26KZxNRCCZ45vQa3hWg35Coe3cHN8uzPE70Ab01Fewk6nF4gddCfLnL/D+K/H73yDvf4x/v0R4P/n+BvQ9Uv+dxO9D/WIVepU6xq5BEpmFEiJ+QP2biw3oYeoQrv82pWXrkbj+Jlz/XfL8A/zzMfXXCu9/MGk9RCZ5nboCgV6arP4Efv4F8v2Hk9ZD+18j738kafvvWKxET5HnH036/JX4+TfI84/x9ZLY94fQ90j9d5K+/zjCKhp9mJNhNRx/a6L8QzXoYXo/yz+2Honrb8L13yXPP8A/H1N/rfD+B5PWX4Off50+xvIvSf0J/PwL5PsPJ62H9r9G3v9I0vbfgcrw/NzP8i/J81fi598gzz/G10ti3x/E8+8wN//i3g84XGofyQWSBfjAjPS01BQAy+LVmkEWQS3VY0b47Iew6IAES15ItuQNor7rrLduHh7qGdt4m/VryvVoe8NK266GK66q3Wtb2QD5TQKLJ+iAJEDOdDSFz3RqpEBH0P2TzKQk8K/rfJIt7Pe/T32OrkKnsH6eG8GaOxZgJE7tNOwO/S47LD2VSO/4ftiXHw7n+8LoYJj9Jyb8Nh7lh9Ev8TssWA5F30FcuPtJ1OI0lwT3olJ0j/x5d1c43NUVfrM7FMJ/hbpYe8NPFz9FR+k0IWY/p6LVChtDk4SN2Y93KnHDckT//mm521Ne7nGXl7u9waDXXY5+XlHhduMf5oVyto70/dXFFnQZ9QTmvTviSOHsPcScSCNB+8GU+ACug+aTFMAKyOTFmnCHKzJzesdLlNoKzxPlHl3A+dj3M3x6TzmIfsPiJ3QDdYy7+8P7N8l+g6ZlYKFtQtAH3AvYGSpFLT/fvw1+qzUQsFr9r8Ef8MvrfMk0/JrkB7J+YV7uITGfs6GHgkztFsBmTXSPVAp+E25lDrESOyVBWmylnp7N2mfy++02f8D63+ilc78KWG2BgM0aoMj7w2gP+gL3MZta3/2olsQgh06CoaW2m09CUE8StFlxrQbsRawXg6guYhAV41Ee5SoldO8k2eUJehrmkCzONqN2qoOom7QnYG3Yn70MfVFI/m0rPBdBL0Eb8UmLLsA8MFJWyDaWky2XUDAGkGoEvCaqIDuRQpEymZFGp6TUEhg61r6xdmk1Wfn8RFqNWsXleFHmKFPMfjfewiEJLZuIlvwEFUE2G60CF6Onuka1y7QL2uXajiEz/vdyHf63rnN4n/mQ6aOBu/B/A28O3o7/G3zzzTfJOsRjdRWei+mUOpLDrUAyT8gSrEy2BPfzK5AisZwgT8zz+KRRAHgtk5FkDYCkE4iSkgynJOhUIwlAxS8kKz7xWwus+W4nfs5cYFKk6ARbPsDqnQQRVSkyk8cEHt40W2b02MwO/SZzvs3tqC5ytZu6J46m4AGB+UI/H+gq8Iaceq0lYDE7/HXeXJPX4sp3OKvXnvueMJFoamLRh1VTmEf51IpTeQYa6zpd7Hyy4DMbTUnpecISGTuv8ByZwR2ol5CoWhwB6F6UlDjICNWTwMp8n9mo17JxQOLnD3RUnhgaGrpcEUQrCgvJIqsSdW/s0kbSa79/U3SyMb8Tda5qHddta3mAzZdzE/o13uPeJ3lOyllIUyabxAF8nGoIkomEzqBGidPTpAQEZ+/kKZhuIOjUQciwInHetE85ede+nEn6feZzlM58jufNX/C7N5B3F7JvTucPCOS9OUQcj3JLH176hDKH6FP4dX/Zp5yAV0EbX11s5eRuHkTw0ZAsvTKSEYFeFl3UXGiVvAyDWpWUpao4GTkoCOKM7N6xEqUm6KHTWGHsrmDuL/doC+2Pvp7h04HYjNu3iC1Sj/QogO6fYCabJFvz/3U9phlYdKF/4D3zPDpjLa8z6tXkbvW6z5nX0bcXqbP09smhc2vZfa9ssZP2LH4Tf4ff90RMYlmkt2vtZegzJmN6ht2byhbzaWLTxOPI2rJAaK0UyTJ+wGTwYfxDe5gMeAP6rL//l/3wjt/jj1xIbNTZJEMWz9lGQVxWQ3ykpUVeDy/yDuTM0M+LRN6LpJ0Ti5/SKeQb+SQrNLugElZSo7CSmgBz/L9fJysDMeuk0N1h6h6PrpNoC5l3hXXidFSvCXTideLSsesE60q8rKYlJGYx9WPm12gP9RHerL5Iqrv+DtdfSur/nlhPMNd70OuSViwRayLhVHxgMuBTE8mzRklJGDQK0j/jsxBNkxtE2BIR3V+QD9n1QOTnACOQQ67XC0dLgrTVErtFiMjFCuIC52Vn++tVtVIVqqmurUIqaW3Vhu1IjVr6+1vwX9s30J/YfWdSc0JVaWmVYVXqmXzbcGNfdspDsvSi/Kn8ojTZQynZfU3ELrgH/QG32we5lvHMllrw9MxEEnzakwvofmI5Qgl3e8Rbxef1KHOVuQrQkXCbs2kNtFmuZfsBTWYbTBZpCO5fKr6Aprb39LSTppJu1EYa6nA36sKSVmjnw1lFBVP+oqwHoZXDtvwzqcpwKDU9HM5JPeOzD+N2P7R4BXpWUoZXhyNiFfJ50bhto1wuL1rSK8g0O0n5Zn8IKe+7j/mLpGzyXOoEO2634vc8ILyHzyydYJUSlhqb0uoB5i/33YeUF0zSf51k37NrcQt6XNJP4rmkSbEsqdQJAFY93t/+UDDeXXf40KHDdV3j/sXjBztqN//HXXf9x+ba9gPXzeLnv4mff1/8POURMK/eeroCbfePd7Ev6B4vQM9cd6Cdf0PHweOz7PmH+jm6iP4zmcPSJOeHt3D9JaT+74v/SlK/HbfhdUkNFsd/pP7KzfC/cnHfr8V1fyB1f0qoe2jxEB4LH677c0LdrbjuAVL3YULdrsU5zLNWXPffCXXfxHXvk7q/xNZhXv148VasCz6GdWXMqxisMHEn1SKvs7C8Jmwq9pUXOpfPNLvbdg5VTXUVu1tmIFAu1iVvRZfGPO+BQGp8XAZUgh/3FZvCNfjxP8+0uIu7pqqGdra5m+Fxcs7MRBdJXByfd3J83BnlM66/hNQDnxPrrShIV6Frcd8YvIBScO2jPrYS5l06PYHWLbVXKLG4pyfO3Y/WcXGxrPiZqqWfwSvAbqXzzv0n+xCiHCiTrkQbvuwZB60592e0gX1mD0pHv//y7+xBG5kT/Heuxs98/8ufuRrVMy+QZyDkOubPBOHPuVj+LMU7yB2Iz7+/hzoplVB3Na77PqlDCXU8L2gJCfeOd/d8Wkmb8Z6fSaWcTFNgqVDiD3nBpKbXs3999tBDTYcO3fLII/jP/Dd73sz/yU+4vxKeT0/Bej4+E4f0WoW3gYY/Q+1N+PmFqSZ4Hn0W8wLMmEepfHQ/eR7rJXCedrMfRaufeKLlyBGg8//oh+zYi2mloMOw3wk92gK06BM/Jg78kNUp1ix2oU+oa3CrjJQrYjekgyLYxWqD42JtUOfWkUOvEAeCZJSO/W1bqcNZkpbZ111ge7vU4YB/dhXYZouL7SqH6d9O5nrt8E9XHvwTvo1+gj6VaEXfZoP+EElLFNRpaAjVz3+b4qOA4pOOTquL+Q2l4Y8Xp2X2dudb34F/ppJ20BT+ZI7b+G8n9T74utJlJF+Hvq9Gb+Lv68n3a09xXRfrx/B5qlmkH4/H6sd8u1RfwpPitCzcLMvbhD1ZwBP6v4oKHUqH5R5oFv6nymG+h20W7u+bmC9HCF8sEWM60S/jI4/qyLEslh9oL8fz7gKruNvknT/j3plFlZ9MR9GOpvMWjuaouj4uVtd1MTYYTrN+u8RJetJdkJ1D/6GoyJHjNP/bqTSbhv0WnlNHyJwi7WdvQ2Pfq4s5VrKcgilTSl5qhSmjdJih9SQH2RheO114nSqoQlin9KOF/DqN1qUk1D1KjeF1AHWpbB1KVpeWUPcD6nN0NTqF1/7PSD6+N/DZ5Ep8NqElvwPPJmrF4mr0Bf0wZYKTSh5EJmGzKGmU2RKSR4nEsoRTC0n5VUX15OqcbpgoKBp9kNVkxekD0f62ynJL0FzXtGAOWsor2idnV69dPkEbUovadKrlK0+p9d2FqTfcmHX19m03ZN/Erl871UGH6Dk8g73U+ogtTy6VSCiDNl0hpSUaVVYGljOSLqOMpjrUmSSghQsPekLcihY4yhrg/ApXCXMQ/IAe5xyFaNQ/GckwmUxek6c4YAczjRpu/7D0AX1UryApq7F4AV0Oqycih8PHy9vaykbrRpyu0bqxYEtrBf7LYR+tO1FbW1VVU1NFZ9hsY3Uj5e1tlSO1I1brGKbqaCsfq7uitb6hpaWhvpWcdmoWV9MOyTBlpTxUAOKHBrwet1mvUStwb6lMWpJJInaAereDz7vN2y9yNUoLy3kSw1orStqI26qPy91YoWZTN05XrXDWVrXPrl8/29m8xVvbMbxy2ZrJzm1+R3HnmKeEflbutzaUpvzIOjfSvz3j+uPSck9Lq+wftuVtbatTT3wacNr8mpPnPlBNeSp0LH5qz2IJ+j2XsxZ8mboi7ZAhzoLksixIWA1RhyXtELBFSlOrFIi9Kp5LQXIK186C2Qz1aLUKBevTpNAo1B6sgaZC1yDFbVDCmUa4qJp8ZB6tVoc3QObEZZOH7hns7myuKzH3tLdYrDarM0/vRIXoKHMWZTDHJ4e758zXp6CSoTHm/VC4tiIU6TOCToDPcn58lvNQo5EhPMfTQfbpkEyqxy2XQuTxVOJAtDIFSXCrZRIp5CNLn85A6emNAuy0Sd5DIt64nQ67TalywU2Pyp2ZYo7G41SQRO4KJ4sA0pIrNGcoGMI/4Mj5dLerxFRuqe/N+k/l2z9QnkzvbM7vMDYPbL5EvUzZgsaUfforV9PP5+Z2q3K6h1pGWkd6jdo1rkP7Wkdadl/M5atdzEf/pD+mLNR0JJuGKOPkPlKlpGku0gsECWRv+Gq6IZQymiRWBzAS6uDoQ8JXx1Sw14AWyqw0KtUu9hqQC5kCvVEShzOsq5Ns9XBEu63e4QgUFTgOZe70dtX7vH7dyMjMCP1xdnavxuVtGGZ2DqyqyRtUOevL0deHI+1TApaBLiN2RCxzjKxFMCebN9gruQzIVUIQzWqqJ9/gkIBNVS53Oivw+oQffOLB6xZ+FMBmusy1f8XD5aaBoHlg1y2mkzebT6LGyKDl6319382tdXfo6zxI80573WhHe93IjaVVrMwJcjnlwJssFClPhbTrMkoum5PCHTF76kpLU0xTCgVpUDXdYzEZ9C47Z8FMx+MegmgpcCcZJBFTOPMi/ifrHPvhN76xqw3/d++Rr31tf3VNW+8N1aebd+1qbh1Aa7dsmt860Nh7mPBljMtBi7Wdx01pEFfNqdPjd2O2q50S8r4QPqFBZkUvPqXRuttq1L3tko72p47ds3d7U5eMYc6ld9X30wb0PL3VGGluGsll3kbZ/RV1zX6frF2MgbBR9ZEaGrJrqvG5HeJqcd5zMOUV0ylIoSBmFHKlWS0VcqMqNXjKp8KtJjvXtSRUjEbwV65g5waeHL9q6tBXOOdeftnoQn1ZTJ3bldrXV7qsgX5+ptJi3LatZWNhRDM1muEq8m1s2R2eKCM8MOL21ZH8sFWRSg2EW+9KQZSCjMQqOVwLA2BvZRoxN7NN0+tEFmUYDwRNihkTSVCN/4cunr/yyit3Xn755Vuevugm6U270UzzQPOxY/gPNMb8GJXg/ZHfD2mplcvby+5JtNRGfuflNy21szo5JwtpqYPVtTkZQ0ud5Hd+rtNSNqcZP99oqYf8zo85LfWS3/nxoaU+8jvPD1rK2qb/n/beBLCt6lgYPnPula4kS7IlWYsl2Zas1ba8yrK8JLZsx45jJ44SkjhOwpaFJEAWCCEhBJIATQulpSwNtCylBQopFGhY2rRNUyjdeOXRr48CpbQU2qavG4SWfqyW/znn3qvFVkL4Xvu97///L7Gku5xlzpyZOTNnmVlEbqASvIL4aULOX868FQv2cuxIvw9VioYYRVGLGFPX+hGlEpvZEFHAjevxWquRtPLhHKIRNQu528UmV2NdNKi4XgwGgwa+RTh7fpFJL/VgY9xxgudkqqHS6jQ5q8yDbSt82ev4Sl+Tp8jzthXwitVSUuJ2h9bJv8FzjtgKHoTOYfQQIL+iCbhNjvGIraWCw06nbaQvXGhTYjyG+A4Ta/4xzJr8A5pvtvkrqqzeRvtc34JZgTafy2+rjDnYDdxWVemw1UVr+kaqvHY7XrAY0dgX6voe6lJ8LF9PgvAmXcTnHz1spUCbW3uRg29LbIu2ZpxtyGaulzTiwjJUS+UjttlpSd30GUJ/wp9/5JZPUbIJ/u9nLoZr7lFu6CJ53tIXy3x75VdzS0lTU9k9qFS4hdPM6eReeB9+xOda2SxQdq61cIFInQVip2gsbDf2+5nVcAf7wPmrMq+s5Dh4cOoqOEiGgAmGYmvYD8JeOEj75fcz1mhZ3NxBHLdiSpxyw9cNOi0qCUJzttbCmnntP2W1Z15h4ZKQ/t1UhwAze1BLmYy0ayKhUJLqMnuTyMVfaYNzz34j/ewzp8nynQUVfofOw/QGNs8srwejPBlWp/bZ9jon3/sjF8TggHcy10WZxR6FrZkdcDXcc/4dyy6/atnk19kmpql3yHZ6Jo5NTpQO9WRzSh+sKtdhPzM7hKmkFVpgq3AiOdMg6QUWa1qHqKaz2O4RH7vkj0WqYeeOUUkalwOd8Cyon3prahhb1tTX1EXDLr/L53UrjFmic2YpJZK3c4oFPxCzcUwc8lY2HHqofWRkUds8r2duYtEoXg1XeocSmVv6A3UOR23w/XqHoy7Q30/pphUrzu/qTvbw31kdPYu2b+/rbe2A/p7Wju3b5bNzU1HqFsaRtVpTTWz/VBm2g7BNSAJnRaQgkj2C0KOeaQnJXJhVIyzluWN+Cabawbd6/DWxWLByfCTc6a9xhe09p6WFcXPpWHkoPGkZS+NViW6Qvp5eQlQ44EzhP/nclon1v6agyDicmStpc5eanwljIG9mjLwNLK+ezTvk4AoUALM5B8P74+K9at2dxEOr6ULuA1SU88tRELhUUUrBYjZv7VtZO1SLfyv7tvbThfiVOQp9tYO1+Meu+rf2zaBlNk+HYkIKJUJIywdhPJnZC1dS3bP/vuiNs9+YQctepDJOy9pipCyXY5NJ+UnoiTLXcW4mPuAf+3cvv+P8uzkpIwzryaXwJmwgGmW/ATM4sFPZJDMzbyk7V1PGVS92pMYPb67OvAjXXHrDSr52JMdXqCQNqToPpjVq2cF8OoI5BDJXUFcY1b34tqCLH8wIlfOADrJEZl6aJe6qm8tp7MG/O9ZrjdQ1FArW2g2GTVsNvprQLMfWhxefYTI32UMNDm+g1b3PSP+Qeb6jpybsg92sHWDAdqjzcNPnt/k8HOfsNzkSDKczWfXQ1BMoy7Qoq1YUXRN5CI6gLKPy++nzyRxVu+D38FeUY0hPvP9y+0qS8PudO/vUP7hfveq/5BLZ1z8pRzk4QWxsPQXtJQ3z9wpoR2nYMSccm88W5FVMgc/S8O0fC+TYGDYU1PhhShjwRfJIduHcifdwYe+PMstmDSz6eO8PJse7+hfD+eeuvDGwdeW5q673XbAK6WiU+7L9MfNPLUdgENB2wxFgpNxGGTUxyxmE/CN6drvdb/fVhsOagtND6vEhZD+ruqKVYL7jfV8cTa4f6lnX1TrePp50TVZMdHW1dnRBZUeQHtz68L6Flw/j+771nSM/7k9nPjd3YGDsjHFvhG3iR0o0Tf2Rzqc/4HstmG/mJrIktYiCqGUHfjABJWsMoCkBNBakNXp+/Fsnr8FptdzDISqFkYjHw9xaRJoijbE62UtzmbusQnFtYWSLURABbdGj4IGCQyv8KZOm3szyFNz77tjYwMDChQOVVdVeb1UXnKncd1d7u7roXZNDAfpN7YrBwZUrB+esHGhqiLU2Na3KfDv7ZFVDyxnMqpGIZeofdJ5ypt3Dzzb1klGyJXU+8pLgrqAafr5bbnCpZBY0lpIyQa/T6NeYeKONvNEG0OlkZxf94vxUqq0tGvV62cpyajQ1MjSnrbetp6sjGo+2NsbYtEeNL+80vBXRYD3BaXgNDof5ePDlXYt56Vrzrv84PNzVPTLSXeVwVFXZ7VVwYPJ3LsTbt+YNd3fPm9cNi5WLzNOYorq8vPo9lhI/9Lvze1IjI6me+bOjoVB9XThYe+iHPT/IvDfKH8+er/7Oqg0GY3XhULQ2GKqvRxlBFDm2Dfn/A2zV0OjDFTgI2/MMOEo1E2i+c9vXjQRGNUvz3uIAjQqQhi6YSOllI4JvMs0ZEHFY9dnPrr7xxtWwduKWWyZuYbLh0NQm+DI5A2XDyiLrpRThIagb1nDdcKm8Q7e6CESjaFfyc+BdWhY7Ix8qQiUNWmO59xOpEtXK0em8BQBySX/GjTeuZX9cwl2z4uqrV9wy+euVDFbYCF+mK2RYi8gxD4+vcEjec8bC4ohKdAV1ys9is8maIXeCzz5ofc6ef/7DmxbQGjrxwcsmoYV/TfDyWCy/J4V1+Fud8rJRis+a5lz1d8H8cnlQATRrhaTN5qdPfvMXe+5bd/kzYBBKPvgHPO3LXEnfKRifcMzl+p6fHe5EOf7iamym6Ya/ym1gLctgG4xsToGdqtMLaM0SXTYYPG8KD5ykbAwotyiN8jvtEtthYBPYCcTMy4cPQzBz+gsvwF10+a97X10xATzGBzsrdTvqfXVAxV55jUVQ17UoeRD12oNoX52ijo2jKXYfUtbB9/HfE0NPDmGOh8gVOB798GRjWIjnee+9Kwbx2SHSCF+Gauy3cCpwYrLO0XQon6aXLF688LTTFv54aOnSoWWK7v44jnc7Fd195v7eh+Dv+L5DGQ8vUOgo9/4QfAHp7DMKnc18r9quVGzj96ptR8UEv1ftKSom+b1qt1CxU8kv60tUnM3vVX2Iij3KWTZZL2f9w21pRWelYmpa/jnT8g8q9cu0RsUh+V7RKdixY3avjvdUHFXgk8dwyqZH8F4dV6m4gN+r4xgVx/i9Ku+puFCpT5ZZVEwr97LMoOJi2fZX+JKKS7JxzxlfUXEpv1dpnorc/J1iMaHPoXdz/VaO4yehwRuRwyRJEaDn9F9eUWU631jt2tOPXLh/+GJn0DX5LpWcIefFw1CFNOUlKTqLruTr9KWsjCRoA5FIUmOTuHtiNCwvbKr2fk0LX3VsMLDZ1qthqx70ZzsyY9qv6S21jZnrGb2aiZGO0P3ExPR0tm6Ho22STV/5WfiwJB3J/H5sW31dZh3c5gp4to3BvMz3Bi5vrjyjrLrq8gGZp73Ej7DMkmHRsXVCvsXCKWgiyWSrE5LwcyMYNjgyp2m/5vU1Zj497ydNUYv+kDYz5jjLAHrYOk/Gy9RvEC9XyTYDa1OI+e13AiRZbDHUOFebqiou78/8IPOD/j2uauP5l7mCiI/Ma1A1vMMRdFGpCDwcv9AedzqlkJBkm0EkoLMyn+bIyZzGkQNb4e+Zz+jBcJYDDmkP6S3RJtgql1WAnxLeV+zQv93vwAJxXN+xzRNwwW2ZdXX128YyvwcPHbi8qrrsjMrmywdgNswm0/uK4cfGN9VEbCGnJNVEQLqSowe+iuipboIL58FDjbUWPfbdIcfZ2GeZz8j4+RIJ0sfpJtRCtI+UyOuxrKtkSJwcLt5pAIcWnl4byzRGG84cy7wL2rEzvH4X/Mzl964aAzHYv76pytO6vh9CEBxYV11dWlpdvW4g87LcB0l6jnAe939eYczRZkFPFJBpXp9UVBkVmqULZJrVuIKu7XNZD83Feyd9T6Vg2U/8W3S5kMKxwEZ0j9lKjSJlc6nM+JQDPaHajBZHPEKXH/Q4v+TwHoTY0fPuO+8odWTKHF6vA45D3eTkr2iAnZKlUy8SE91L16nlWYxsvRsg4a+RHaH7E2x7mz0ZoXszz2cedXo8TpjfkNkHe44cgc7Mcw97HTc5PQ+/fOeWo0dl+L5El9PXlfLKTBq2/s6iGsYB4nJUCkvAmQxY4CbPwcxzmecOeh1fuue8o0fPo697nJmyzPNQB8edntjkr44coYFiMJqNBgajvxWtK2y23w4gOJkBl8ABcT6DMPMoK+ZPR2APAvqYx3mTw/swxCCWee7olju3yHs1snjUPmIUYRoO85CXjzeeT22f9hGNbCfntS2/UYXtYXSSawfWyefA89tQCHw+2DPyyjInr4/yOyevVxi8GSNdnvlRbn8/sxTZDhR8avy2zK88zdSV+Wks2TSwI5eG9BRPQ1vz0rx3gjSv59LAY8XTsLMhahp6QfE04rpcmvxzC/lpNL68NP95gjQvy2nIe4VpQtk073GQubYTm16OikMhlsMhGc1PYwtY4qOjo3JF8vsD098fOHAg//2r09+/+uqree8hNr0tjKLxk20L660ZaXZkrsZPfponZ6R5MtODn7w01DQDb6bJv1OTmobVWgy3+fCw1NPSYJvocgUpSpum04vaJple5Hpm0lR+GtaHhbgJZcvJ9aECS1bXZmlYKohN3ofpJq1ZPPN0kjoHK6eTUzLWhtj7kxb6+oeUyyDMPIc0NL1cjTq/BgXpWFuwSGD4KEaPeW2heXQtoTxkc8xUaXMONzKk9K/vBVmuk9TPWi/jEhPOIq083e3KHHYpSlwnPxMRQBu+njShHZ8k3WjLD5C5aM8vJKeRcdTVziRrUMM7j2xBPXIHuZTsIVeSj5NPkuvIjeRmciv5ArmL3EvuRyvgEfJ18i1ylHwPbYF/I8+S/yAvkF+SV8hvyR/In8kb5LLUrtf/8qf/PPa7137z65dfevH5537203//ydM/+sFTT373O9/+5jcef/TQww8+8JX7vnz3l+6847bP33Lgphs+8+lrr/nE/quu2Hv57l07L77owq2bzz93wzlrV591xqoVy5ctWZwemz8yPDSnP9Uzq6ujva21uTFWFw0Ha3xVXrfLUW4tw/GET9TPYkyXiDuLfDT/H32+trV12l/G+P+aR8Li0dy/V/83XhNmnSj89F+j9r+Tt8n7ZAoEkKAESsEGTvBANQQgAvXQBHG0A7qhFwZgLozCQjgNxmElnAlrYD2cB1tgG+yAS2EPXAkfh0/CdXAj3Ay3oqV6F9wL98ND8Ah8Hb4FR+F78EP4N3gW/gNegF/CK7Ct7xvwK3gZfgEvws/hOWC7zp6FZ+DH8CP4PjwFT8B34Qh8m4X/g8fgUfgaPAxfhQewzINY8j3wRbgTbofb4HNwC3wWbsJ6r4dPwbVwNXwCPgZXwT7YC5fBbrgEdsJ2uAguQGthE5wPG2EDrIO1cDacBafDKpiA5bAUlsAiSMMCVF3mwTAMwhzogxQaArOgEzogAW3QAs3QgHKqFqJMAQc/+KASzbUKcIEdysECZWBCm0QPOtCwBSoUeJPkA/IueYf8g7xF3iTHyV/JX8gfyX+S35PfkVfJb7AXfkV+QV4kPyfPkf9BfkqeIT8hPyY/It8nT5EnyHfJEfJt7LvD2IOPka+Rh8lXyQPkILmP3EPuxv79Irmd3EY+R24hnyU3kevJZ7D3P0WuJp8gHyNXkX1kL7mM7CaXkJ1kNQkjvTTnVu4/5JMIFPvIa/0f9rHHZ340RR6yZ9K0Z1KRZyydU/nkPzuV8k6U7v+UZ1KR52p7NadQ3vR0NNw681+8Jfd/5r/W3NtMD/tuZU8yP295F39uxs8PW97FR+wqY8q9vyCbDS8/y18XPjXlJ/hffdoqQ7emJXMXv7iZJbiZ3d0sX+fBk30s3DF/ZMb/PNE58+3oSPZfweUonPBavT1h+pF/0eUpwqE+ZyG71HFiNukjg2QeWUAWkaVkgpxOzibryEayiVxAtqOcuAxlxsdQfnwKZclnUa7cjhLmHpQ3X0XZ8xhKoSMok76P8ukZlFU/R7n1K5Rhv0d59leUbWenznjj9T//6Q/HfvvaK7/+5UsvPP8fP3v23//t6R/+4HtPHv3Ot7759ccfOfTQg/d/5d4v3/WlL9xx6+dvPnDjDdd9+pPXfHz/lVfsufzSXTsu3nbhls3nnbv+nDWrzzxj5YrxZactXjg2OjJ3aKC/t2dWuJEp7qciuYrLLov//3RJUOwZXd560n+oOL+Uvcn0/GsuhdtHT/ZP83LezYF/0SXaDlVodHRRL5+L06p7A/JXSWH77nnzds8b2T08vHuEerOXeMHslVz+arRXHGVaeU6osAw5xGq8VQ3RnV9k23g8Pt4WXx7Hi8Li0/JD9na87b+vLhfW5Sxel6VoLcXKz7SpReeVXUYqWNkWKa9saXpDLKzswR1zS/KbwAsf3jVPKIAedhMyE3bbCfHkL4Yg2F0UOdNhP2nZgtoDBYV/R8b9NMT8TW4RkWkRYli2DmlRYrTozxJhTM6g0h2zpWU4dNPp1qLUqVZDvdPgtp8UJ/HEdIR8ZyYyviPvCcuVyXaTG77uc5VbtWxP2PRymTelhDOQJctIQR1nLjTekH7NvGEOlrwsVVjbWen2G17rW4oIGthgLqzTw+us9paXnbBOu0KeksPhLGzXwEYzFout+6ZxYXJaA5f2vWbeOIBVHkumS24oUmel11G8Tk6yTr7T14l1J6ejcmnfq+YNA9H2hcaZOJ2zwfxaatmxG0rSyWLt9Hk99hO0U+H3ZCDhxJoLcbtRQd2r6RuM6fbCWtdsGJBhuh4BKqyzmtRjnUHfydqZkzEFPp1PJG8a+voaGlOpxpPInbScoqGPiNNgSRJTytAckwESPxJA+VsjPhQ4k8ViMlqtxlMBMm01yskLeEEgNhJA3LnLDfL+SL/f4heznSTDx8905qCnXZO/o97Mo+f29Kh/UbbnLIp/eEG90Z68V+nsC/yTeRvMvG4j5+0yUwnh6ybq9jbUUrSIEb9clVJWlHqPDdZmnsMywCw/AvNOudysvACzUmZ5KZ+Hw7bE1XYgznkD/Ax6tdCdMmxozSplKgVCFkaLenaQdWEORHWkTSOe8S+tjrVyD8kyLwsTK0Ni85FBBYk5oGiX3HFpOWP6qbyu5nOaCAeXsXosQ8fXRnL1x5Sa4SfZOllLONz6GXAnVHhVQNNZGY4wZstvd/Cz8gjkZkzDQHtJroWQrBxX06ttSuTaojQinYU/S2eKbwi9QLsyf8v8Ddtllr8L5L08jyox/+gsreBMRtT0t99+221qnszf8I7l68SvanqIaEgJ26to0EmCSLIHO/heRatFdv0cEGxxCT82gVY/uvvxx3f37d0r7t0LE5l7YQImlmUmM5PswD5R/Wber8DN534ZX8D9md9CJT7N9W3Be5kx8CnNe8/aoxFVekQF3J9QGKgNdoM5vXkza0euvmnp2Z5Fud5nLqPedOYqpjUAiGjLnA778/erWJBx6OmZt9PYmvYPnhd28XTQTk/PnxMHvx25ApaAPnNvGvanEXdsTev9jBGf7c+bkw7wHdJL0pm3EUNGoS4tp4N2WFI4d53g5SES9WloT9PVanm83hL1HD6vl5ep1P42K1nPQEBY6wryIRzZOX9QcvGWZd6mq3nbEBoOC68jL609W/7kHXLhvGAFX2raPHhUWGQ4+PqAjAs1bQ4XLK0MM0cHL1eGAeEtXI86ffIOBmha5hlRKa9g7QXLSstrL9n6OK5y9SXy61TqpS+lsUVWrjfyfHdzOEvY+WqdVpajFn44iK1ZgZg+fDh9Z1oF+L1gtr67EWbOw0p9/D/2991Y/mE4yDLIaM7SxvMF6RX4ctBNKMARIQuXBnOU4thiZnP6yt57BTJBrk3MvM3huxPr1DNitDIQ3wtiScgTjyrlFKytMNwpbZNbxtKzflPwgXBqZHxgnVSFVVBbh2R6kNeGLdyV/qCd1cTzkmMKzHl5Q7wHBA413J0Zh4n0nQziY8g1k3co/SDzBMurz+MJvvAv5zqMWOGMwYiCp8e6lijpdfK6Uq63GR/xzj6m9HSOdjl96BTatRfQr0LDz2OeyTBf8pPxx/MJCn3k8Be3BywqDpFCOBaxQZwBMB85psgMOZ9IqSo3MCeDUsTuHsesTNi0pwU6+brMv0qduT5Q8zIe5nUyPka5c/BwmnX4B/uFp49PhgXuCZzhJVsvpxsj5s+jG14334Io0w2r/jDnNEY5HIYPMpznBEWOPI9tV2jQqMud/+A84tco8LASECZGgRMyWDJdpGXAhDw8ZsvSymUFslDxsmR8MqhYORypMlBKE2U6U+DKp2nV9RCHRWnRcWyJmJWjDCcW4mR6paO8jCNGLESMkNeoPATdWdAwBU2cw5T20Szes3JE7W9OkZzLVXmq58A9zyiToTong0uyMjhuz6N+7B5O/lwOy/RP8/pG5rU8HKiynveJIu8RFZNhmU9z4wPnBZonu/he0dNZZYfVMUIZJ8ijCoz67BjIEaZAiISclgdChT9BVPDB+VObz285brtXZjaBZsfi56enV8djzps4Ju/nGH9aXqt+VGlHVo/KtkNpBRzMNmJX3nhqY3vuRLkNuZbn8M0RoKA8iwMV9dPKsU6TJXlSKCtTsmOPIltyA1ChbjdNB8Kn03W6fB3I4rfkdKCsVvO/PGd015ZodMuOnZuj0c07l4x5vWNL5G+0RNTHO7ZE09nn+F1oA6lnxDQ5G4jByM7C5uBMv/yyAmrmuZezOuJ0HVDW1bgOmHs/Xadj0xaKTqdogOTk+Iqr+Prbd1R0nVr6tqLptTnZ45f3KuR3B/smM9IXlA8zu28mPvWF+JSJVM14IH1Axabc+fn59cSE+UsMUi6/ZA8gkfrZdDAv4dgxlpOVcewA7D5w4MPya+xxe9yiyebPtB07IOc/gCUdO3CAnACGwjYk5MWqbCswI2/GMXb14fn9yspgDn3HFDzw/Dmeojma4rhGs85Lpr0H/h7Y9pq/cZabnl/em2aR87M0hJCidQCopgs3x05QT5a1TwLnSd4rXX+C8uMWfxXPXMwGyMn344dzFgDJ02Xz7Rau6R1XtNg0yaVTZbo8Bshlcg0bEzNjAdURRa/Pyuec3aTK5uOKZN6Vk+NquYpdwXUrWYoePq5K4l2K7lfELgrkIGE5DhdaRZAdL/P3QRXaRMeYYD6er6ufyI7jyYrhI8TbJ2u6qBC+ffi4XKgs67NjXP7eqpy9eUwZ2IrhI87HloA81qKSehye5+O5QIvjI66MRXE1B4NFycOgOYEOlVS21jx6GDv+8OFjx48fJyezIWSIMBWWzcwO+pIKP6enQlsN0zF7oWhfFNKm2hM52nz+RLSppsvTmVXc5tHasazOkNfu7H40VVc6dly1K6a/5xbFhPo+B7uYHftl/S7zNp8GQSXleFYHmlmXWhbTqRS8TsMT6lqH1LoKbHNFL5R1Qtahx7P2U9b2UvAUylpcSIUsGWT7cZpMkKkVaYqLBHkuI89+KdD3uK7HKmaUR/LKLNLXqp08gzaz+hbTtY4fLqDMfL7KnztQ0rPUvNeVdmd5Jdcfql3GypZLlm25HCxsH79RK6eN50uO9GFFcqCe9sHzSi05es2XT4r0yM3CTHBxk6PbfP03n05UzVCe62GkwvrmI871FOAqB1seL8UVbjosU39dOl0ErixNqb2BxMJ7Q57xIR+p/6bNP03Dc8CeJxu5ucwk0n5ZHZbxTDrIudRHFxc/o0t93/pWp/pHK/JuSH7eXCwvCTBPZ2ZR512d8FBn0TTsVCn1YRJ4iFbwH9m+zM5HTbMvNYrdzIxB/t2elvFK8+anisnIJWluTTCjkRuxfE6x+HyWyvvs/fQ5MVkOqXNihbIofw6EyRgZymMygMoc5sw5tvzy5DbMkNt8jo3J7SLyI66O0mk+RuPYv6sYDRSM0fFEdlxndKDSTroIr+WP09mRmjdLIeli9My5LMs19yqGl0zSH4XPitB0gQzISg6ZC1CjyQmAYvzPeCBL/0wqq8z/EfisCO8X4FjRE3L8/DazZFX5mk6fSH8qri8U6E8z5omnjUX7C2TGND1xhl6kqJ/Z+d/CsQvyxi51OvwU9SIZZjaI5eYsio9hyrT9R9Anc6NUsbF5xry5Mjqfmt78PJsuU9Mrc5v5Y3lufeDYjLHvZHozp+KnlTnQGWN6wTqGMqh/FFos4I+Tj9lq0lMYs9VVBPKR+bVQh/iQ9QcV36ewrqFoEVNT2bUyKj6J9ejw46TLqYdYSYTMIsNkCTmDbCOfIPaU9RNXbFu9fOmCeX2zW6NOm47olEkYyS5JgUgkoazlO5xOe9ZBTDKZPb8vObMhnaREsv3EB/m1WuZYjflykCSlnGQk624mqckGUZDU8iJJWDFS53XX76uvqKwbafyNReONW+wlJWXWUpPOaIA/G3Ums7XMUGK3xr0aizXzuNNZZnE6LVfgp8zlKlvEHOVpy3WbhoSyUqNZYzLbS016Z+kwLC116Y2l5WazttRYWiYMuqknOlTf2dBmHR21tsW66oeiD/jcZUl7ia6kxGihHr1ZX1qKXx5qMRqMuhJLvMzt0zgtFpfLwqq0uCqw6sWVZZWShF8H6qtqyoySyWUxlpj1UiQi6c1YjsuoM5bVVNXXMe8o3C72ZPcRDJDSlHF2p7qXQPOhk2H5nibyQ89xz6+ROCZMFm566D6ro+Os7q6zOzrO7prt8djt+HlM+e0a6+oak2KOBQscMeoZzu0xGG7rXtvVvbYb/7rWdp/ltpV7POU2t/r70wULOicmSHZfhIfvC4mQBJu/bon6+CYY8QSbQ4qQieJVS3F0WAD++Qqon1V+7YZEbW3CUC8t7upaLBUCfd10OL9Y29xc27FgQUfe/Fsp95CheywWDVuZHuTgXju5fzzuuJM7wuS+OyMoJNqZgpd1hqnu25gT9C0KLqrQbtmidS4MLvSFm6NV+OvS4ANXOpj2B5uHZ89ubu7paYa7RefiYLq6tilaORZM27WbN2vt6eBYTaAp6ksHFzvF825ONTf39jY3pxDGTyLT/wTx6SJBhLGyoiQ3Pyrl+aIrgk8YH6lf0H3WWc1nndU9Vj8v1qwAQD11w7FZS3WnRTdujC7WLZsVG65rzNbI8DILv7zwB1JJarHOmqpKI8ML4iKcjEjTfbTgI+TR/IqppSSmAZHeFKoficXm1WPdDXW3gNO1VrxORcLLz9M1Lhfc3NAZmxuNzo0hDBU3UxRvdS/ngYLydwhhsWL73Sjv3MbsPjJGHc6405+MZyP9IZ18fFki0RBO2stui2baoreV2ZPhhkRi2Ur44fiy+uZOX83H+/o+XuPrbK5fNr6ksPw6LL9cOVOKqM0L5jK9HiaolMAZa1Ned3mFo6m1uyHYVp6ttS3Q0N3a5Kgod3tTHdTT3BRssOs1szsau1UIuhs7Zmv09oZgUzOLc4EwhBEGW26vHN9q2EhzbrjgD729qycmVvf2Jlpmu1yzW5DS25KX79t47t7LOtqGW9va5HOgG6beguPUk2c3CIINjj/11FNgyPwJHGCR270J0/0MaZ+dm3aZWTou7iNtKHEt5bm2smPs+xqC1kpXjdPXGWjpmNfmczXD8ar2SDRs7O50lGauKK/zBmvCbSb4hFy2a+ot6qJ93N9kpZXpBAUFSoXlh6grW/Cfs1cwujdbbLI787nszdplvI53pj4HZwpRbKclZWb++S7ExxtlZxYaNhyeuX79euE6Ts+5tKfmp061hFgR6+FJOOeDC+AcLEczdTddSL9LoqSNjKVGwyFKRQdItLXFIGglYYRQPUhaKq0h2ItEywI/sClmOSSiDjSaPnF+bS0htW218aYGLCYSDgbDIYMaF5GzVSSQj5zynKCX/SHSnD+kADz9sYr+WeGEm4qWOYn06IY180erKiucWv+q0zo2d7XvveWCWHUoEixxe+l3f3N0/92nxfp8de27N+7dH828MJCYs/2CTdcvro33bs08vGzt/PlNNW+ZGL6ap/5Oe+lR4icNZDQ1TIGIzAtsBVCIlVEtFUcI6DSUaoF7ghRXSiCK3EuSGrQoUENIXbSmIdCAhfhqLMEQc8JLcp6dHXGm/qlyJKnKL1tNNoJJAhYsifS6W/wNzalmKE0vvGZ0Q3zh6OyulokuU8OsqlRPoNNCj9bUdXorWutjs9OZt1Z0ntk5drZFKF3Q3jjakPl8XV+wY8RZfoz77Z+qpcxaNRNfqlLDAi4BiyYK2xiFsDBbnWR+yGZlzmM0si8aBSQ/bV+9bvWFl3RduAicPykREh88XwJviFsmus9IYOfayVY6QN/g412cfCpVWgWiVFtNNWIdaDWC4kE8ZACJiBpJXMMUWqrRrmFHSSk5M+dlqpu5l67XMV/BggTCmuI5xhXnWZQ59KvyepnbR2/c29pQHw3X+GQHkAiLOVwyIxh54ejgUF3UsSey0015J++Vl/f3X75sfE//wJ5lGzZt2rB+06b1de3uaE0w3NgQqQ+E2gZHV9SPNtI3ltywYuKGJUuuX7Hi+qWdN2278MYbL9x201C5I+GZleqZ5WtvXrdy1ngD6gRh8nvawnFUTWKIpV88FgSNTvWu3qIFUYP4oluNIJlAr5P0KnZKOHYMDDvMTbJuJdHpmLdD2RNTUzYjpiiRsTajiPxsqcTJc+iIRtRpzp6B6IlUuKHB52O4bog3tDY3+mK++rraaCQcKqsuq3I5OMbNRTA+fd8nG1qcgQibYIrj8M28f8FFOwcHdw4P7xwa2jncsaqtbWVnx0r87thcU7l4eMjTs8xV2dlN38C3wzsGB3ewlO3Jszo7z2xvP7Oz86zk7GVVUf3F550HnuZ0XZg3euoxeAflVDPpYb6HWTjjnmSd24qsi0zMPCsqvs3ZCthK5uC8j0eqbiZNVV6XQ45nlGNVh6zcKxq57BGRtyciM6+ySVROKrc0AneONVb3hKNNtnh80XAs2LV11YbRBl9fqDZui7ctGm4MdmNDV5dXzBq12Stmj9DvJofs5TVeu6fC4h7sjvY56gcGT0sO2x3yM8+c7kifo6G/YTCc+WGtzVPl9lhrbRVVHuZ/W4BaOo8+wscyu2w/RSJtSeYDKuBA+8WmGMg2W5zOG0VhJTTObRNRUM8znb5wFVzYUr8Rar8XrQtm3gWpre8pmJs5DHMHWPwuPn4MwINwE32T8/iYTLTlCnlpOIWKKv+6RebuWPFyN51drTkfrZxgtB/CouAca2oaq68fa24eqw80NQXYh74ZGWlpmReRv4eb6uqbm+rrmzicdhx359IjLIo76m0uh0nWFZ1oIHKRGpe1ahZ8AZVHP/eo99WrLZl059lz1rhbfDtWXfopm+XqPWe3Q71rrIEe2bdhf+b9pnhjz7xL12c27IvUvf0/bS557Xpk6u/wBuLERWqwLm+FWcC6goog4Z60s7GX7eWMONhed1bh5+u9yUULx4f9G5cvHZi/fn26taq7DZXDBdaxqomxRS2to69uuGC0Z9kNo/cM0Inu1K3t62b5q7h/eDSA6QJsn4F4cfCMkStSBhMgXYKeUCUWXQCHXqLXkjUlIEkwoRENAt8YqtfTCe4stYv5aouoqVBNFTtHeVouZvoKU6KIrawkJIbMXhmtjAT8Xg9zKm4sQRD0QWOBf904pzbutxNJHLvTEs93889Ot1Nb16zBud1X3LR9k6gxn7Zzo6g1nrbbanVVWK0Vl/7jH/TIReedt/2i81+ZHKBd3i/NyzxDD00+5bslDW09Q+lFQ0OL0kOT1y7h+s9sWko9AvPZWZFyMMfF3BMavZCdvt1osSpe0CJI/HHq2XbZpduOrKWlr7wCXSwyBuJRT79MSsjg6MN1iDUnYWGd5XB3ODTKkTw5ppwFD2XXXzJmprm0U6dL4ez77jsX/6h5VWYMDq26Ja8+GzlDrs+fc7hNmL9tiVeikyvhbhY9+WkKXuv1quvwiZQ5z0G3oaiDbhkgDhIDSr/q8VW33opftxNimfra1Jv0XvpnZEYHckwQbYAW0oEycw4ZJYvIODmDrCXnkgvIThYFbue2C7acu27tmlXLly4emz93cE5fT1dHoiVWFw7WeJ12tG8tRexbFv7dmUCDEYUlm/xAAZl08FtRiss/aGryOzQyHTgmhCMaOUHcwe1MO/uJyzlZYiwtyV4zZ7xOlrGd3cGND55zzoPr1/PvSmFuqLcjmuoIztXoPjdR42+p6X61uq1qaEPmdPEKwZGIUm3CCVeK3Zle4XO9A7/r+jzYM+ViV6zFIYSE8t6BaM+QHULgbKnvFjOn9wTmlURNw4GerjcDNSvi3TXQMzs+UeNrpX9e/9D67F8U5i8vE77xDaFsfAE42sMO66LUnAU2+0L3C2uG5thcLtvg4NpFF/VtFGx22JjqvWvNaR5L//DALKtw7rlQ3tM3NMfqXrz2U9alC+Eb34D0Eis0OiPtxp7FY/3G9ojDwuROFL/QhEVpoEe5o9fyGEFg8VtCAkq0CG2efAeEI7D7KLRlfgJtf8i899xz92Nq1ecQiy3EvGqYUoYKl6PMpEd1Vp5wy7lvsinOiBJ84w5dfjDznurJ6Urumgi0L9xHHZk/ghPqJjPHwH1kMsz8FG2vW7SI0KmHiZfeR7/IxwvdY3ZL1g8T8zbEnBwxv0GaiOSUnEm0n5MR+imPxzl5PvMhRG/KPL6f+Y6X/+gX8cUrrGzqd3re//jgx+Q3HxvEei5S6jEg/eoeKzMW1APgl6ZXkVmceQCWwIPvFamBnfyfVj5rx+/yytfJ/qmyTSgo/3eZBzKLuRekBx/NKx7Oyny7CPD4Tz/1GAnTJ+glXC9sIr1kGTmHXEz2kwPEmSr/1Mcv27Fp/enjC1LtzWGfo0xD9EWQyEJIoIxlQpZJ2fgp3nPXT7nHH7UYNb1fuadfZv23nPfffZMX64xG3Qj7Wl3k6jz2xT7t7GvyyEkTZ25i3/Ao+6aXYAdauDusN5yeUSXFyb+uYF9v6YxfOXnCe3KXbE3xNVJKL6avEwtxs/OPVl0+XdkB7FlnYgnJmfBb6EpGWz9irrPWex1fuPuJI0dgI3fBFXd4H4Q6qH8QtE5PLPPDLUePboFfcB+Jio5KNedwn4OqjkU1G/j9AgREwjGDajZlCu838/vT0EY10Soc957h6Z+Ge+HTbK5bcyMfH5+euhQ+TfbPnB+Q2PyALQ5dWy9Kf4wpeJBZTi+ZWiLU5+ZMBNRfHvil/xn6s4nuHXxOI9NOR6cupL8iRjL7cb2OuTIdljVBI49DzfwZd7LoUJYZsbUnUga8M5ISHl6bMJfiauCAzPVLtYP2gUCDYVC7bICOzus2p/zV5u55cp0ROjy1D+0mLbGmSpm/U6yUt4JFGxekAFtq3vOJ4Wsa9u6j377oovjixdwfZmbVFJ0aI2hHam6ePDj1ruJD9l3VLyuWuxjLfRfL9T/OXH2LRA7t8hiLSEvmex5hlUw8YperYVOf8T2xfXsbrhmmH8NK4hdhHVtpVeZvAg7QmqumXkaDgtchjGTruCnz3JRj6lvY7lCqRjpx3G7Ei53hReQuBgPykkLmzZC1tafSHfQMBjze0IbtNr87KJd7PW2dsgkVKMWDKb+Ui5u1tDCauYkY7TK6mWfHuCRPGmYeD9laerxGU9BDW4MeT3j9RXpvqSdIaKaWXjy1R5g/bU0cMezET+a2bctWrTl/fBm9+Cuxx6vur32c4zlMr5raJwhE0Hxu8j4iw/dJumyqiv4Wdat2hT5UwIChNmXNx4Icp0wmEDX+er5r5Mw/amv9vtpaH/1ttKo6Gq2uirI6liG9Lp5Orw/6f9lEH+1ms/AMtlo6hO3xYv/cNnnf1E+VeAo/VX2mZubSTVOr6Xfw/e1IIz9VaCT3fgVtm1ogOPH9F2bmJzB5LThJJaxlOyCVePJyfMKsQ3FEi4W1BxJ+++S19HpwLliAsFeBc+rqU82Hqc9j+RCeCL1m6grBiLi+c/Ig+RfSGMqSnShLXkFZUqO58UHCJMoieV7zDnovHKbvIIiJfN7PBnK2zGiP3LVqk2zYpDvAQ+9dtEiWUYrMEng8cWUyirlFlt3Ko0UBVSil6CEW/pnFLKSXwAP5/Q7Y75AvqIB8mm6BHws2eZ7LoOeCKiuh+nj8BDMxhRg4ViW6AQ+0Gji2SBo0xGpqGkrmiJHBRrplxWxTJBaLmMKDMSx3D90MvxCqi8sikGUR/OLq4asb9+6hf92zp3WVHMfykSk93EPKUPdvTjWwONClIBAzUIGHgMsFlM8LjxsMWyxsHlYMB5Jxe3a6n4nNBMyvbzAMNbfM76zuKq+q8XXuKNsxJLYEmzvMxi5LWO6nIrDOzcJqS8bZRp09CGrDnr30ThVU1C0vp1dhPoH7TZ8j93CpRuBzn7koh/b8KIcr+Wsu5K086HbOBbqWYzi3Ktead313OOz1hEKeI+Ewkl7IS68KerzBoNcTRKEUYr+8Ha/R/bAd+7KILBn4yLIE5iuyRLDVVlVFo1VVtTJNbYaDQihHU7akU3q47fs19N9W7O6W8bKPXgwvTJeNNsRiCD8vjJ/fB2TZtl5hfu39VY/HvuJTeOV25JXX/8u8crvCK0emrHAdiSAlxR8tk6g6+pYo8XlYaJCC0IxyzJ6JRwNBxkt+LY8mmJTUpWu4bjDe4a02+Cu7R85e7U34mqUFUnfz7IWoUZBDdC3cI8zldLBQ9rFuz5vYyU0Yf9iETxGSICc6+r16YKC9fc6cdpfH42KKpDC3r7m5v7+5uW+Wt8JdWemu4PusL6fXII0aSQUZTxkddkpBr2PBMZTJVIeKj4FRNq/HAe2WAxeyoEbjWZ5DlmMzf1RggQsLQhuR/GhGrflxjmBRta3UVmJxmnrLu0J2v9VsKyl1mXvLu0P0GrOpRO9wVcfaS00Gg91Z3djC++3v8BfYTo9Ok1nbeweq6KEfGH6syLW/wf3CbdPS3P+K9xmhP93Fg6GT6+hb8LSwX5b1igI2Q9XK07Os+XrWH5do5zj6VTXrrZyaxWTFm4jPWz5crqGSJaxTlaz/Lrn2FsJ6qwyrorgxWO0yrFxRg18wTe3qYSHCNTXOv3tpBl4SLuP0XJeKFBVgH0F63YMSi0mtrPTKMKkV8sjSi/0irL+jU3CxcC0WVp3yzpRTJxJSC1BA+WqjfuFaJqCYoGL+6JE+Dgp3TKOPg1W/iAuxrsUreBuvoMfhReH7xWXUi+Pn9QMsvTAlfD96f+Xj9YqMulNwwDeFDR+uizBhdCe4BQfrfEoepb+Ge4UnVPngLC4fBv658mENyobEnDkJJhtcHq9TeILJhv6m5v5ZlRVur9ddUclpRBCwrz8mxzXLlw8n5P9TZf7TfDaTvaTMxZg/bK8qN5cj8+NNd1AQzMjzDmd1LGHmzO9jzA/kGdoPnxSc0/rtk59oX09fub3mESKneRmuFQ5OS3Pt1e0bhK031dzP9bww6n77/ptkXubdjyzzMudM9UwNMK/RZH3KYEBiKgEKDNoyhJbv4iLnsIARq1iUzB7K1rNYO9iQSC4seMHaxp9hm8fVN0DTExN85EMrp8Ym4vgmhhOJuBovN5C5u2ei1uIyBxu6npwdr4vWSvr2AJbzKl0EO4XkNFzvHFkQEnzPGuXzEL+G38Iu+qNpaXYtWBiih541vciZYhfdCL8Svsjj6PBYmyyohxyVejhPqkCEzGehcuQlDx4eRytxQZU80aYluDY1WDmGMoTJlUn8MHkiXPtwyTcPF5Exf6GjsFloPTX9X5J5K6v/wzxV/xdag25PZP1Fdh8zAFD//wsdwXJbmG1LlwsXK7btxdm4Jn/Ces9X6xVPsV5nICLXOxh0V/a0WkO8Xp/9ovURDzc8KLmR9sFRIYb5ykh9KlpWKgmsbDOwsCknKd+a3y4Ud8njatP+NGd0tRDLNe8ly7MVsk53A6+rIVeX+BHqUtvC6vpLyO2d3WoNel5ndTWE3NX27Rsibk/wl9m6WLu+9U9t17HRwcb8dnmftbwg13U9r+uf0K4/h3g3BT1/ZnU1YFeVb8eu8gQqs3XtQvn2c+FylCNRFm2rQNpmZY6Wr2GsIXKkRjGiQRMsGvFXK9JHkk4mfaRwjkUQEzBW6UBhJMtgJoxKrYowCi6zWZBbgkaLfRb9wGRmcskXS6Bc0pczubS7xG1zB4Pu0poqOa77ZXQAx8s9CEWEzEn15WAPAypBM+FXQ02yBrjdhLgj7kiNT2mE7uSNiORaITlh0QnbMGK3GAOoWgQsdHJmE74ZrvaXMv4P2nrks5uXoRx6Sfh0Tg4B50VUu/7LcmhFw3X9kiKH3saPOxzy0H9Er+j98gw5JKBOvhF++a+B48h1Dbu+mAcHl4cLr4h+rhgc++gaeBnhqCAh0kIunz5W+nGM8eU6Vid3rBxKUg70FWGbJMIzkrBdExo5mqRmpRxjUsPiSYbDjBLCLeHmWJ075A76qhR6KDkpPWhPoFfCkhMOtU9MM5gF48yh92BRG/pBegl8ZcacyVfyJstObV4lZ3ctLaaDlKtIy2ogkY+ggUj/TKsLyC9xDN8xYwzfsXDBDjhuetZxiuM80+HtsJYeRzVj9mM6TtIfPqUpC1bZlkf1xJHV8HMDb2/IWBqZ7fYgRx0PuM3+6vTGcp8yv4t23i6083SoD89+XCcp8+wNBfPs7pPNs3OrQpu1/7Lmn21wnoVbf7vmdppnzzZ3ziXKfNk78GOB+ZfAsVypsJhdqVorBeUu1Q5a5s61zdEu66fv5JerIXVT14n30bfJZuiDpXAhXEo8fUa4BC6C8+BsWAD9iLs7yQARMW1zvTXZQ+OtTkec9T3HVhV1MiJgX+VOxfUk233DFpcjbDG5Bh+YKQuig6m4IdlII8kIkk+SE1ESv/inTZKfaeUHbI8G2hVOCZMHWFwciVkZrB5Wrbr7zolF833QDra3mM0TOtk6szxj2J5IRljIdrZxD2tNOOW32TTsf0DeDiQxsBJtybhT3hkUifCIPOpGoUANQhLgMzJ8e0gEc0pOiR8LSMrbj5wBBDSS5HuN4wqHJGVe0UpOzivsKAEvJ5xgYDkYWCwDfiMaseF2ZTMTWoOyye107l7YvXJLh29Fg7YpGG6xowZrj3oqk10dSAKoZ0tOr05rsmjLu8vKQmW2LldppVMTDJQaBDMLyOsNtF2VivQGxbYaKlWW1sREjdM4KpYntwveOZcI9nmuGn0iJsT23ghgc0OlXxINJi1QUdAYKLWUUGvQCGYKuhajqOto0mqXCamOWxP6Cp1oCUlUpymPacTSLqNkAUOtURvyRjQ+t8E1v9GyS+9abTFWaYw2e3t8sVMAq00AZ2W512fWaGyi2ahNCK2jDySCC41U0ml1VFst6TR6Kd5asSQlxujA/BilZnu43Gi26WEB7VrnqzBpLF7/UK9WKAdnf1Xb8g4D3bey1CFo4oJB0FrsJrcgLmx2VYOu0eQBsSJQCpqAR5Cayr0NWi2sM1psQYc1EaW+nsaehqpSc7DJojdSweY2mmz2ynJ9SDJqrTUaqTshCkJZjSRoS40mags1NFtiksGhFSvDzmSt1kslvd1Q4tBZa01t0qz4LF1qNu3SBftNRtFmkTrPCOlWCBr7YNTrEHVOm2CugDIwa91xq+hqsqKscZTqJEpFY7Vd0Ng04aY2aoiWiUaXKJQaStstgrGy3OmmYDNARbBMUyaEW8oFb4sWKkVTUIAywaDTmK2VEUE0Oy1UpJLB2hQINCR92iqjZNfOEuw9W0x6Iwju0rJKm1AetEgGndaoNTgs+sp2SGhQIS0Rqd3tcOo8DsGkcdboKu0OYPEAS9t6y4VxESS35LcbzUZ3hWgXxYUOUbCIoKNoRpQ4ykTQii0ClTQg2DQWK5QLfN/T+1OPi5fSJ8jPyDEQwEicfQaQQCT/k/yFvEZeJHfgKCOiFCHy0OFkfMHYJcBpXnIiE8SVDcUygyeRjZ2MCRnHM9ZhrxUtk2/ri0SUEz1SROVkhzMpc7JDFkxarRxrl31HWAKnHYtiEsAplUvsIFA2EbuyM7aLSJEemlQPEDGWb4vIuwiTSbarJY6Q8kEC03A+LnfIkPdSxr8Ik3xMKJJoTyI0CKSdN9DOREGIR6dOJiPQ07G8rarfiejT9g75vRaNqcK3rosuAL3NbCwP282UxuYP0JiYWlLRGpf0Gp1UraXILBI1LgwmHhhtFRJao1m0aTRmn7e80gmCywSCc3G83W4zaqqMltUu/S5L43yXwe3TRLwhrbHWABbJ2FUqamLlGh2VQhZRV6FP3NqREpZptd2NWtHYogNqBmPQSksslBpQJUT+N+lEyV8J7mp6gdtkt2iR4eIapOOVFeK8Bm95kyR4AhooDVSI4DE16qDa1WzWgmR1BG0WoyZKx3rbSnVimQ0c9kpdjVNjEhwendPhtlOxBM1KTQLaK/UWhwGpVGeQLMFywVZZVupGKtKbtvTYhVlau2Ss0vqSDYFAk9UgIdXbHSWiEKm0mjU6g1AGQtAkVoK2xSuUt4QF5JpgBRhsQN3O8kqjYGlHzhJEl1EsixpoW1MY+U7weAwiRemDIsRhtDa5RGvcrTUjr1aYBewr0eGNDto1gl4Q7GKFG5nB7ke2AHFcnNBIVGgRUdMsc5SAWIMaqGgRRIdRSIDVotExftDTv5OXxPV0HtERC3GRarRgYiRBUjhwO1Plc/t6kq0Nsfqw31vhtJXqtSLbN8KIPBzBERZHz/ZEAik4yQaOSDt+Ibk5kpxWI+wrqdJtQqY2xhOJpMwcEaFET0uprSQgag2mEkOVVioVqiBuBhdAQCzBMUOAPmrRQX2pAcx6SmtFlEeiVSN0CtgSgc4xSoJotAl1VGPWGkp/JelEhxnZ3im6UHxTHNMFl0G0U58BVRGbZLCLJjQdRBs1GkCkGqfI54LNmb9OXSecl69fwFXwKbgJboW74D74GnwbniK9fVU8nsg34BF4GO7H53fDF+E2+DzcDNfDp+GTsB/2wWVwMWyboZWYUZ7Q/6uV/O/RSoIBh5NX54igiZzdkB9JVtMkO+Jnd2jt7IK3JCJL2YjasACHWt6s7eDgB5xP/F/t5p+g3XgaUbuJ2JDh9dpIicmgFc1U1XVcVUKppK1HvjdLQcGk1ZWIYZ2FuqOU6s2AMrFW0FiR86nYZBGFMuGfpxtFzf9/14022YyiIBlphUFr1lDaJKtK/wMbLplEF4pSbZNglrRUFEPULmrMdoOEolVwG6kNjW9R8Ds1FOXo/wNM4JvsAAEAAAADNLy4fqF7Xw889QADA+gAAAAA0hRh6gAAAADSFj7V/Yz+DASoBBoAAAAHAAIAAAAAAAB42mNgZGBgXv7vOwMDU8Tfnt8RLCsYgCLIgPUsAKYxB1YAAAB42r2Ya2wVRRTHt+VhqTwKWkCBFiqUPgChFvRaK7SgJVKi2FrbAkIiWIkaaSTBmAjiJxMQBAkmxiAh0cQXIGr0C/gRg2KM8sFEo0iaaAwGEUx4yF3/s/ub3mHZbW9T8Sa/zM7OmZkzZ845M3tzW712T7/c1m7yssM/F+ItEdUJNIgCp+zMko1iSgxmnFzKZSKfsjfuglZ4VsyhtIwXNzF2HKV9YIBYKdpEmXgoQnECk2Ko7QMjsE+UQnF9DDURqp21FvPujuzwL4YEa25KIAVjmas+Sx4Ws2NoY82mfLIXKiP1FgfrJ2acqgQqaBd+OvPcTR/2yf8n0u+RCPMSeDDBN9v6wEwxNAZjn1kxLI3Q5Og9j3cF+NMK2vaK6VrnX8IXb5A3mskX6zMEtnBjPw//iK7xfhjkxGkp5Ur8ycTLcMjH78uRqQDGMnp545h/Mv4+i9LJG4FPl4djBc8jGHsSuo5Bn2HiPmxZytyFxN/t4h5nbXYtmt+7Dp1upixy1mLj1K6jPGOPwK4+eubx3pa1yN7o5Gxj21vA6lGTkN+KHTsOZ6z16Hu3GIJOU3keLeaLHGw8hX63hfsV2LiCvSvDJov0/m9sV8QemlwyVzwqXnEojOSDfPzV9WsTG8vB6F/i+Gmbk5dSjm+PYRzrX2VgZNeyJzOxcwp/t7nMzSPGJ26l7wjsUcVaJmDTAtaxGH+rZe5K8kkLsT+S93YtE7DbQmLH5k67lulQyZhmLe3E2hCowmZ2vDbOwQZ0tnm83slT1sbVCTmuKZInGtirmeHeBv5biY6D8Tmz55fxjzr8oJH9sjE1kPGHhr7tn2HNKeYs596h89p/n9hamLm/BPeSi5z3eU6+sTFQ4/j7Muww1MkpCyJ5pd6JxTz20Ma4uQd9LnaJ98QhsUocZmzT5wlsbuc08fM0axyJfmYtndxBSrF1NTrZ/R7r3L2kl6+86+ue5G8Sa8Tj4hR3j7j7WlKfo+IzIR19o4di2jc2/oS17RFbc1vTZ4XyeVr758vO6Z/FT3reEq4/yEm9yZoxPxXmbDB+P0ooR6XPhX38g6Edbf71j4i9mfF82cu/Qbwk3hFvh2tJ/ya+FvtVfy7cA5s7/S/Em2qTH6X/zMzpG5sMZqx3Q7v3JhvEkYnfieJOfHeNEzezOQNMTD1A/minbRAxuZz6RPZ5PPKTyRvR+40bezavNDLnavJKM/mribKW+OpEdoxzBjVwBnjEfDP9WpyzfRi5vep/oLEX6q8hs/tJb3e9ZmjrJ6OvIYehzvmWm0qemks+bCH/Gp+fgU/XsX8pZBZwBlu5ulA23UUc6qz3T4vj4ry4IH4Vx8QJ8T0xkovcab4pLnCuKBd5r4ltQjnG28X73WKzc1fIVu74fyhn9mia+FKYXPKtOEL+PgEzaF/MmWPGPI3cNPKFjYlfkDF9vqF/Jzp8IF4X68Rb6PdjD+22v5UrJvbtHcmcjS8772y9xLkbHoDVsIrxvoOo3FfimPOfghf5j8HWV3K21jBvCbm/mrtjC344LkE2Tm4J+c3YugP/Mzl3HyxHZkXoh0E/wxl8lzbTN9gTU+6HZ+i/iBw5kvaDTjmOM7cj/DYK5thH/4ORZ6trR4Jeri4dPczf4cy7NPzuCs6V4dwtovW9vPOIO6e0z269P+TIt3OHZZ6TZLrrVc5zUc8E/Yr6ju13Rf8U8W3res4ZGOJfuhr3fZKM93F8P/Pe0pOs22Z1uaJPdG1bI2voB9H5e1pLkly0T5J8tnbolnH/d7p09T7F2SpbktZq9yBOz2CuVIzPbuY75F4wvq07t/cU9/nzMIjvphK+L0qJ+wF8VxdyrxzFvYL/D/wPuTuamFXe9ddRmnv2ScaYz5mzmPvdUYPnpdUrPUdMFcso14qdYrsoF6Vis2ih3iDaPe/yFpVF9NnJ/6e7GfsAPmj+w/2IcoM4SdsmZA+RA03bWdq2Rfq9ILqQe1HsYX82cr4cQ8fHODP1jeHp/u+dgt/Fq2IH5Xban4cN6LOP+U39B8bpsme+jqoKcUlWNt8hf/wLWUQA63jaZcJvUBKGAgBwQlRmiOaYEUNniMyIzBnPsULmzMyIOUbMkJjPGSolIjkyMuOPMSRzZEiOkBghOSDkeT0zRFREJHOuHJIRMc/n83Vex3md53le53nvy/v27vcDAAC0/5EBOgA6gBkwAHADZnZk7Ti8o2hH+w7NjkUgGpgNJAKdQB/QHwWIKoqiRTGj5FGqKH2UNWowyhP1LCoU9QZEAQlAHtAzUAj0BrQWjYhmRldHK6N90f7ohei30RsxwBhoDCKmKUYe44jxxryL2YpFxGJic2MLYumx8lh37NvYDTAQDAXTwOVgNdgAtoEdYC94FhwGr3xA+YDxAfuD93G4uOo4W9xK3PpOwE7ITtZOzk7BzuWd73ZuQZCQEggT0gt5CFmERCCb8aD4xHhkfGY8Pl4Vr4+3xk/Hv4fGQJOgqVAslAFthiqgaqgBaoOGoSvQ9QRAAiQBnoBOyE4gJugSzAkDCe6EmYRgwnIiM7E6sSFxe1fcLuEux67pXeGkw0mUpPIk14fID7M+HIABYBAYHIaGZcOIsGIYHVYBC3+U/dHCR28/2kieSg7shuzm7m7e7d+9AQfCoXAEHAPPgZPgo/DpPcV76HuMe3x7/HveI2IQWAQH0YRoQ3QhzIj1j+kf6z42I3ORBcgSpBFpR75FbqQAU6ApiBRMSk4KKcWQYktxpDJTXZ+AP+GkAdOgaYg0TFpjWkuaci9yb+Ze/N5pFBhFQ1WiFlGR9Jx0Ujo5vTS9Mp2X3pQuT4+kb6JBaDSagWaj+ehmtAI9gF5Cr6LfZ8RkJGUUZJRkMDOqM4QZsoyODF2GGROH0X+a+ani0/lMQqY+M7QPuQ+9r2IfZ598n2qfCwvA4rAEbCFWgX2zP2l/6n7sftn+wf2e/Wv73+OAOAKOgavAcXB8nAFnOwA4AD6Qf4B7QHXAd2A1C5XFytJmRQ5mHyQcVBwMHlw8GDm4np2dPZi9/hnxs47P5nOKc0Q53kPAQ7RDA4dch7x4GB6D1+Fn/ob6Gz8XkluUK8t15258jv1c9LmVkEzgE3QEEyHwBeSLki96v1g4nHpYdCTxCPwI+gj3iPXICjGVWEG0ER1EL3E2LzUPm5ebV5DXkafLM+cN5G2T4khIUiYJT8onUUiNpBaS/0vkl/Qv2758k0/Ob88PfJX1Ve5X/K9mC5IKSguMBesFW0dBRwuOGo9uFxYWqgt1hZvHKMe4x4THHh57X1RURCsqL9IWvT+OOZ5znHTcdjx4fLkYVkwtbix+WOwvDhUvnQCeyD5BPPHwhPPEKhlBzicLyDry7EnwyaKTqpOBk2EKltJAaaLIKUpK19ewr0u/Hv3aV5JW4ixZ/Sb7G+43A1QYFUlFUxlUNjXyLeLb898+pJXSlLTpUzGnck9xTqlPrdBpdDM9QN/4DvNdxXeG75ZKkaXlpe7T9NOs05zT/affMXCMcoaB8YaxxtguiytjllWXNZTJymbLwmUrZetMIrOYSWdWMLlMIVPGtDOdZ8BnqGfkZ5Rn1llFLAVr9vvM7xu/f1gOKaeWK/+OqQBWxFUkVZRU2H8A/0D9YaYSV9lR+ews9CzxLOes/mzgbPjs8tkIO5WNYWexaWwRW862s9eqEFWoqoIqchWtqqXKUeWuWqtGVWOrS6r11b3VCzWYmpwaUg25prSmsoZX01Qjr1HVDNYs10Q4RI6QY+cEz4HPUc+ZzvWfc53znps5n3gefp553lELq8XUEmrJtaxaXq2kVlVrqu2vddVO1QZqF2s3uBAuikvglnDZ3CZuB9fIHeD6uEHuW+5WHbgOVoepI9SR61h1vDpJnarOVNdf56qbqluoW+fF8dJ4uTwKr5In5LXxdDw7z83z85Z5G/Xgelh9Wj2unlBPrmfV8+ol9ap6U31/vav+Wf1i/RofxE/mo/hZ/MP8Ij6Df57fzFfyDfyHfC9/nr/EX+W/v5B4AXOBeIF2gXNBdEF9wdqQ1MBv0DRs/kj/0fpjREAQcAW9grBg+SL4Ivei+eLbRnyjpDFwKfES6ZL2kvvSpjBfSBEyhGwhX9gsVAjVQoPQJnQIvcLIZfjlksuqy5EmcpOiaeoK8Er2Fc4VR3Nac1Oz9yrqKv3q6NVtUYwIKkoWUUUmUb/IJZoSBUSLoohoUwwSJ4qR4kwxXpwvpohZYq64Wdwu1oltYpd4RhwWR8RbErAEJkmT4CQESaGEKmFJOBKBRCJpl2gkJkm/xCWZkgQki5KIZEsKkSKlOClRSpGypFxps7RdqpOapQNSt3RGGpQuS99Jt1rALbCWtBZcC6HFfA1+LXBt8Vrk2qYMJEuUIWWZMrwsX0aRMWRsGV/WLFPI1DKDzCZzyLyyWVlYtvIT7SeXnCdvksvlKrlebpUPyj3yZ/KQ/I18Tb7dCm1Nbc1qJbWWtJa38lpFrcpWfau91dHqUSQrChRyxfL15Ovs6+7rS21FbZq21RuIG6wbzhur7aR2bbv7Z/TPTT/7lMlKrJKgJCtZSp5SolQpTcpB5ZQypIwot28m3kTdxN8svNl4s+umvwPbwezw3Eq6hb/Vdst/a0kFVJFUVlW4s7CT3inolHWqO02dA53ezkDncue6GqSGqdFqvLpQTVez1QK1TK1Wm9QDaq86cBtwG3Y79zbrtuq2uwvYldMl6wp2bf5S+ovvl3UNXMPS8DQdGqtmRrN9h3mn8k7DnZY7C9rD2nJti9ao9WoD2mXtWjegG9qN7MZ2E7oZ3cJuRbemu7fb3R3qXtdBdZm6XF2hjqar0HF0Cp1ZN6oL3E26S7urvzt1d1uP0eP1BXqqvlxfref9n4FfMb8qfl02kA1mw+o9/L3qe4P3Nu5tG2OMUGOyMdWIMWYZc40kY5FxtAfUA+lh9FT0yHu6enp7fD0LJrCpxeQzLd8H3cfdL7zPu99+338/cn+rF9KL7eX0On7D/eY3x5kR5goz36wxj5r9FpAlyYK3UCwCi8yitpgsNsuAxWXxWmYsAUvYsmyJWNYtW1aQFWKFWZFWtBVnxVuJ1kIrxUq3Nlq1Vpd18QHoAfYB5QH/gfFB0AawZdpotmabxjZoC9je9QH7YH2YPkIfuY/Vx+uT9Kn6TH0Dfd6+QN+bvk17nB1pz7KT7FR7pV1gV9gN9gH7lD1kX/8HuF/3z/5HSY9yHnEe6R/NPNoaxA4yBnmD8sH+wbeP0Y/LH2seLzhyHQKH3uFzrAzFDaGGDg/Rhs4PiYa0Q76h+aE3Q9vOZCfWSXLSnNXOFqfGaXd6nSFnxLk1DB/GD1OG2cOKYcPw6HB4eN0FcWW6Cl2VLomr1zXjWhuJGyGOMEcEI6oR24h3JDyyMQodzRlljHJGW0Ydo8HRlTHAGHwse6x4rGJMMmYY84wtuYHuJDfKjXcXuUvd1e5Gt8ytddvdPnfIvTYOGUeN546XjFeON42rx63jnnH/+Mr4lifRk+bJ9hR5Sj3VnmaP0mPyODxTniXP5gR0AjtROMGaEE50TJgnPBMLE1teqBflJXrpXra30dvu1XvtXq930bs5mTiJmyycZE02TqombZOeydDkqi/Gh/DhfWRfpa/Rp/QZfS6f37fyBPQE8ST7CWEKOHV+yv006SnlqeqpZxo0jZ0mTXOn9dMD08HfKb8P/r40I/gD94fpj8CzzGflzzTPU58Tnwueu2e1s4OzkT/T/qT+KfFT/CK/3K/0d/n1/l6/3e/1z88lzuHmiHPlc7w57ZxvbnHubQAZyAqQAiWB8kBToCtgCMwEgi8AL+AvsC9KXzS8sL2Ymk+cL5inz/Pmu+ZnXiJeNryUvex66Xm5EIQH8UFeUB3sDbqD4VfYV/xXLa/UryIhQogcYoUMoZlQ+DX4Nem14LX19WKYFDaEl//K/OvhX96/5hdwC6QF6kLbgmdh9V+wJd2/U/8z/l/842gsAAEAAAXNAeAAWwBcAAcAAgAkADQAdwAAAMwLlwADAAF42pWTS04bQRCGa/wALB4hWWSBFNQrpET2GJtHJFhExsYoki1H4CBlFU1mGrtle3rUM2DhG2SVXdbZZIFyiBwgB4hygNwjf/e0IRBQwKO2v66u+qumukxEq05IDqWfN1gpO1TALuUMzdA7y1laofeWc7RM55bztEgfLc/QI/pseZY26avlOXpBvywXaM3JWp6np85zywvgV5YXacd5a3mJVpxPyO7kCth9cS4sO8Qyry1naCkjLGdpMzO2nIPPN8t5Wsn8sDxDq5nflmepn81anqNudmC5QK3sd8vzVMzNW14Av7S8SEnOt7xEm7mflpfpSX7q/5gW8s8aoicSMeEBC7zEY76MzpXo9RN2warrlWoJX1tF1u1z1pYTMRx6rClPQ/gKGTIvDFiXD/mJDIXvsSO35jaF8uAayjYPxOlow62ub+/Wu429XX2iD0rpyaUjS/fHXMVa00Tc6Sti5rFEeQEfeWrA5Mm10upSRVKZ2ty6p5SE+9TG2cGHQ7bG9gMexpHgA65GXhiy2sG/nrd59ZMk2imXx+Ox66cBri9Ht1tbwkc4eopOccUSlNiJeIjWhQmzh0V2Zt+44laYVGyIzMrqxb4SURK7sRi6UvXKnWaLGiSoh5VgTYhTQAzLw94D+SQpwugr49WHldEFVpXWqYLvkqUtKsLahQfHbxtRE0QM8WiVJvanFFpdgV0Iq2csOorDj9OJsQvk1DFH5FINqwmLMpa2OZeGdJ0CmiM6BPdAOpOiDUToirZpl+pQbtAeaKoxVShdU/hfhmOwoviy7qscD9cV0GHGlpizAP4jU/kANoke3N3FOvYKtyFN5LSPLuw6XmGXqt/001oH9AGdYrSGtW+yhvCNEMGRWb/fyNyHfr8avO+jeV8tPTUJzneojGdsHtfc8lUG10za6EG+LTMrafZ0btMZ0xXo/qZd7ECNm1qapl96gq9H6sk9u3HHFWSpmBvRWkP7zupGfTFU9D8jgk3XFZvbck1UD+cd5GzdMgd/TckfOhhIiXjabVoFeBtH096dmbVrCJWZGVJJp5OssjBNkyZpoGlTlO2zrUaWXEGozMzMzMzMzMzMDN/3tf3K/U9379nK9/x5nnhudud9Z3Z2bnfvdIqU9++f21TEFVr9zz/znNtIihSrtdVTmtUTqltdp0Ub1aOuVyfqFrWOWlf9pf5RvbpVL6HWU1/pNt2u1leO7tCd6kn1tB6lntGj9Ri1gdpQ/arH6nF6SbWRXkovrTbWy6hn9bLqOfW8+l29oJfTy+sV1CZ6RTVer6Q21SvrVfSqejX1sQqpsF5dr6HX1GupPjfWF/Xa6iXVr17R6+h11Ul6PXWDulFZ6jsVVbZeX2+gN1QxvZH6VP2hN9abqLgerzfVIR1WXepVHVGvqQH1urZ0VNs6puMqoTbTXTqhN9Obq83VFuobvYW6R2+pttRbqc/11nobndQpndYZlVEFnVVzVVHtpXN6giqpQXWh3lZlVU797SawrCfq7dQE9bWepLXaVg3pyXp7VVFVPUXtrafqaWqi2k79pnfQ0/UMNUnP1LPUZPWGqukd1Tw1X89Wdb2T3lnP0buo7fWuejc1Re+u91BT9Z46r7t1j/pETVM76F7t6D7drwfUAjVdLdQFtY/aVy3Se+m56iJdVPupm9QM9b2aqWbpQV3SZbWjHlKfqT/13rqijlKzdVXXdF3PUzup/fV8daA6SB2gF+iFepHeR++rdlZz9H56f32APlDtonZV3+qD1N36YLWbPkR9oQ/Vh+nD9RH6SH2UelA9pM5T5+uj9TH6WH2cPl6foE/UJ+mT9Sn6VH2aPl2foc/UZ+mz9Tn6XH2ePl9foC/UF+mL9SX6Un2Zvlxfoa/UV+mr9TX6Wn2dvl7foG/UN+mb9S36Vn2bvl3foe/Ud+m79T36Xn2fvl8/oB/UD+mH9SP6Uf2Yflw/oZ/UT+mn9TP6Wf2cfl6/oF/UL+mX9Sv6Vf2afl2/od/Ub+m39Tv6Xf2efl9/oD/UH+mP9Sf6U/2Z/lx/ob/UX+mv9Tf6W/2d/l7/oH/U/9L/1v/RP+mf9S/6v/pX/Zv+Xf+h/9R/6b/1P+4toYmISchQC7XSEtRG7dRBnTSKRtMYGkvjaElaipamZWhZWo6WpxVoRVqJVqZVaFVajVanNWhNWovWpnVoXVqP1qcNaEPaiDamTWg8bUohClOELIqSTTGKUxclaDPanLagLWkr2pq2oSSlKE0ZylKOJtC2NJG2o0k0mbanKTSVptEONJ1m0EyaRTvSbNqJdqY5tAvtSrvR7rQH7Ul56qYe6iWH+qifBqhAe9FcKtIglahMQ7Q3VahKNarTPJpPC2ghLaJ9aF/aj/anA+hAOogOpkPoUDqMDqcj6Eg6io6mY+hYOo6OpxPoRDqJTqZT6FQ6jU6nM+hMOovOpnPoXDqPzqcL6EK6iC6mS+hSuowupyvoSrqKrqZr6Fq6jq6nG+hGuoluplvoVrqNbqc76E66i+6me+heuo/upwfoQXqIHqZH6FF6jB6nJ+hJeoqepmfoWXqOnqcX6EV6iV6mV+hVeo1epzfoTXqL3qZ36F16j96nD+hD+og+pk/oU/qMPqcv6Ev6ir6mb+hb+o6+px/oR/oX/Zv+Qz/Rz/QL/Zd+pd/od/qD/qS/6G/6hxVrJmYWNtzCrbwEt3E7d3Anj+LRPIbH8jhekpfipXkZXpaX4+V5BV6RV+KVeRVelVfj1XkNXpPX4rV5HV6X1+P1eQPekDfijXkTHs+bcojDHGGLo2xzjOPcxQnejDfnLXhL3oq35m04ySlOc4aznOMJvC1P5O14Ek/m7XmKOoen8jTegafzDJ7Js3hHns078c48h3fhXXk33p334D05z93cw73scB/38wAXeC+ey0Ue5BKXeYj35gpXucZ1nsfzeQEv5EW8D+/L+/H+fAAfyAfxwXwIH8qH8eF8BB/JR/HRfAwfy8fx8XwCn8gn8cl8Cp/Kp/HpfAafyWfx2XwOn8vn8fl8AV/IF/HFfAlfypfx5XwFX8lX8dV8DV/L1/H1fAPfyDfxzXwL38q38e18B9/Jd/HdfA/fy/fx/fwAP8gP8cP8CD/Kj/Hj/AQ/yU/x0/wMP8vP8fP8Ar/IL/HL/Aq/yq/x6/wGv8lv8dv8Dr/L7/H7/AF/yB/xx/wJf8qf8ef8BX/JX/HX/A1/y9/x9/wD/8j/4n/zf/gn/lktpZZWy6hl1XJqebWCWlGtpFbmX/i//Cv/xr/zH/wn/8V/8z+iRKt7hdRPwiLqZ/WLGGmRVllC2qRdOqRTRsloGSNjZZwsKUvJ0rKMLCvLyfKygqwoK8nKsoqsKqvJ6rKGrClrydqyjqwr68n6soFsKBvJxrKJjJdNJSRhiYglUbElpkaprdUj6gi1ihqjrlGiLlEtapxaU12sjGpXq6olJa5S0iUJ2Uw2ly1kS7W72lNtpbZRHapTtpKtZRtJSkrSkpGs5GSCbCsTZTt1i7pZJqmxMlm2lykyVabJDuoqdbW6Xz2gHlO3qtvU7eoO9ahMlxkyU2bJjjJbdpKdZY7sIrvKbrK77KEOVfepVtlT8upy6ZYe6VWHqdPFkT7plwEpyF4yV4oyKCV1hcpLWd0pQ2p12VsqUlVrqNPUyepcqUld5qnV1KnqUpmvfpAFslD9qE5QZ6ol1ONqtCxSp8g+6mx1meyrzpL9ZH85QA6Ug+RgOUQOlcPkcDlCjpSj5Gg5Ro6V4+R4OUFOlJPkZDlFTpXT5HQ5Q86Us+RsOUfOlfPkfLlALpSL5GK5RC6Vy+RyuUKulKvkarlGrpXr5Hq5QW6Um+RmuUVuldvkdrlD7pS75G65R+6V++R+eUAelIfkYXlEHpXH5HF5Qp6Up+RpeUaelefkeXlBXpSX5GV5RV6V1+R1eUPelLfkbXlH3pX35H35QD6Uj+Rj+UQ+lc/kc3WXfCFfylfytXwj38p38r38ID/Kv+Tf8h/5SX6WX+S/8qv8Jr/LH/Kn/CV/yz9GGW3IsBFjTItpNUuYNtNuOkynGWVGmzFmrBlnljRLmaXNMmZZs5xZ3qxgVjQrmZXNKmZVs5pZ3axh1jRrmbXNOmZds55Z32xgNjQbmY3NJma82dSETNhEjGWixjYxEzddJmE2M5ubLcyWZiuztdnGJE3KpE3GZE3OTDDbmolmOzPJTDbbmylmqplmdjDTzQwz08wyO5rZZiezs5ljdjG7mt3M7mYPs6fJm27TY3qNY/pMvxkwBbOXmWuKZtCUTNkMmb1NxVRNzdTNPDPfLDALzSKzj9nX7Gf2NweYA81B5mC1h/pSraXa1JHqGHW0Olwdqw4xh5hDzWEqqQ5WD5vDzRHmSHOUOdocY441x5njzQnmRHOSOdmcYk41p5nTzRnmTHOWOducY84155nzzQXmQnORudhcYi41l5nLzRXmSnOVuVodp95RH6n31ZvqePWuSqsP1NvqQ/WeestcY64115nrzQ3mRnOTudncYm41t5nbzR3mTnOXudvcY+4195n7zQPmQfOQedg8Yh41j5nHzRPmSfOUedo8Y541z5nnzQvmRfOSedm8Yl41r5nXpVQvFluS3RVnntOaHMz3VMql1mS5v1xy5rYms/mees3pSPcUKj31wb6is6A93Vuu5Xt6nFKtJdOTd61dUSnnay1Zj6Ml6zW2Z4fNWrNgzfqsHRNG2Don9JQHB/O+YfuEYYxs252vdGw7YkgTt2uZ6Ac5EXQTfbqWibVCsdfp2K6JdVITa8tkbwwtk724Oic3dclk12HLFL9/it8/pamfs6X+lqme11FTB+ql/nylPljM12utU/0YOqZWi/nqgE8wHcLnmd4cwgw/jTOaQpzRHMdMd7QtMz1ga71UCIVjEU9GwsmWWb7/WYv5n4UczPJzYGZVCm6os7xMtMz2vc0e8dY2u7fgVJxqodoyu7+Sn+d07DzS2bKz19Qyx4O1zxmehNFpr2V8sdxTnDZ50ugpi6tTF1dnLK7OWUxtyftzl0fceRRY3vFj7WkqsJ6RAuv1C8zxK8vxK8sZqSwHdA4qq78pwf3NldU/UlkDjcoaaBp+wWNvK3ixzpw+iQp7tRZAXECNFbzM+nNixTv2avIzt8lP59z+iuOUivlSb6GnpegXRNEviGLzhBcbhVfyx17KD5WrtUp5aMBpKfm2peYidNyZLftFUF6sCMoownJTEVYgfJ5KcxFWfXfVptirzTHVGkVYay5CC0WYaqn7/uuL+a8jSXUUYd0rwrpfhPN9b/ObinD+cBHO94twYdMsLPSLcJFfhItGirBn8boqLa6WF1eri6uLFlMbo4mE4jlvVHYkDZmEzEJ2eTIaDkGGISOQflaiIchEYBeFtNGP9lCAj0HGIQM/CdhlfNmVRDtkKA09BRnosA9nIf1xRSPwG4HfCOKOBHHDPoJ4I4g3grgiiDPIQySIL+CHf+QtGkFcocAuiDvIQ+AH8YbAH4K/EPyEwBMJ4oO/EOKPYVyxQAdvDHwx8MTgP4Y4Y+CLAx8HPg58HPg48An0J9CfQH8i6Ad/AvwJ8CfBnwQ+GUM9gScJfBL4JPBJ4FPAp4BPwW8KuFRQp0E78Cng08CnMe9pzHca85BGvtOYpzTynca8ZIDPwH8GfjLwn0HcGfjNwG8WuCxwWYw3C3wW+CzwWeCzwOeAzwGfAz4HfA74HPA54HO4X3Gf2agTG/Vmo85s1JeNurRxP9m4D2zc5zbubxv3sY371cZ9auN+tHH/2eFgvQA+uM+6EF8XxmdhfBbmxYKdhfmxg3Uk6Mf4LcybDbwd9CMvFubTQn4szKsdrCOYXwt5sxGXFbQHOuytIF7cd1H4jcJvFHFHg7hhH0W8UcQbRVxRxBlFfNEgvoAf/qOIL4q47MAuiDvIQ+AH8drgt+HPhh8bPNEgPvizg3UD48HuFo2BPwaeGPzHwBODvxh44sDHgY8DHwc+DnwimFf0J9CfCPrBnwB/AvxJ8Cct1BXwSeCTwCeBTwKfBD4FfAr+U8ClgEulwBu0A58CPh1I5CuNvKeR7zTynMb8pDGPaeQ7A/8Z+M/ATwb+M4g7E6w78JcFLgtcFuPOAp8FPgt8Fvgs8Dngc8DngM8BnwM+B3wO+BzOA9inbezrNvYvG/uUjf3Nxj5lY7+2sS/aOCfYOB/YOAfY2O9t7PM29nEb+7cdDs4jwAf7dFdwHwf9sI8E8xe0B/UQ7DMYdwp6CnoGesbXrXjOJItDA3lJObW8mZB3D4J+h7vxZYeqhWK5JHPcLs663TMH3CuZ6B7KzKT80FDefaga7O7N0/Z1mlKnnQruA1GhcRakaQWePlA2Mwr9g3mema+3zvKpeNpAgdPu/2nVgu8mmWj3/NfKpXK1Ex49ZQnXo3fR1nDo94PfV2Y1GbdPHXT6YdQwD86YY2AU6Bh0CDIC6Re1hU3OwiZnYZOzsMlZ2OQs3BwWNkkLRW4huVYukHHIBCR4UXQWNi/LL75wzt+kXJmATEKmINOQGcgsJPAp2KdgnwJfCnwp4LvQ3oX2LuC6gOsK7OCnC3664CcMfBj4MPBh4MPAh4FPwz4N+wj0SKADHwE+AnwE+Aj8R+A/Dfs07NOwT4A3Ad4E7BKwSwR24E2ANwFeC3gLeAt4C3gLeAt4C3gL+AzsM7DPgC8Dvij0aKDDPgr7KPij4M/BPgf7LPpt6DZwNuxtxJEFbxb9WfBkgYtBjwU67GOwj8FPDLwxjDMG/hzsc7DPwT4J3iR4k7BLwi4Z2IE3Cd5kzuS9Rai7sQj1NxYh0+sUa/lWB0vQosYS1OiseUtQobEEzfWWoKK3BPn3USpNpTotKLjPxN46wZWBMu7YiKl6i1HNXYzqWIyG3IWox/3vqqbcWD/aCsMrTaFpERnXrPjd9aa1Z0x98TVm6f/RfUS5aelqLw+vVu35kdXPaV79HESCFSoMiZUGxwwrnoLEShXHyoJt1sI2a2WCdqxc2GYtbMsWjv1WJmjH9oDjv4XjuYXt1cIx3cI2a2GbtXBMt7C9WkFl+MdzV4YhI5AWZBTShoxBxn0ZBz4OfAr9KbSngnbwpcCfAm8X7Lpg14X+Lth3BXbw3wX+LvhPQYbBEwZPGDxh8ITBEwZPHP1x9EeAjwAfQX8k6Ac+AnwEcUSCPKA/jv40+tPAp8GXhl0C/hLwl0B/AvaJwA58CfAl4C8NaYHHAo8FHgs8Fngs8FjgsYK4ocehZ6BnwJsBbwa8GfBmYB+FXRR2UdhFYReF/2iQd6xE8WDlRH8W/Tb4bPDZ4LPBZ8PeDuwRrx2MBytbPFhh0Z8Fbxa8WfBmwZsFPga7GOxisIvBLgb/MfiPgT8W+Md9FQ92CvTngM+BLweeJPwl4S+J/iTsk4Ed/CXBl4S/XHAf4MQST7Ytcirl8bVytW+JcsnxL2rz/Zb22kDF8dva+sr1Cq4K82BXLSzw7arOPKfkXzqF/oGab1gqgND30fgzetibp3rv8ML+dudKCzIKaUPGIOOQXZAJyGSbG7rneKDTC9m/rnY0QsV1pxcjFD+g3lJ50Bu0d9EYdOMCg25c+oP2rxqD9uwag/bs/EF7l/6gPUNv0N6V56NUH6x4PryLho/GBXw0Ln0f/lXDh2fX8OHZ+T68S9+HZ+j5aFz570D9RdGVYcgIpAUZhbQhY5BxyC7IBN6p+ptECM+YIbzDCqXAFwdfHHxx8MXBFwdfHHzR5Kh6qdepVHvKFae3uzjGWdDjbve95fml8T35qjNu77pTrRXcnTZoGeMOrtsFFPr9qkJ8Gcgs+KHHs6O7K/kep+j01Xy4p1a8hDX0sQ19rlMbNhiHhhGT0UP5ilMaYfDU/7e7MbfN3Q29qbsxLc3dI9MUttv7Cv11NwX56oCf0WSmwxlsqJ6TDqc0cj2wcGjA8bPRCVs/shEOLzVL9tcLxaIzWB4Z3VLDTSMD8MyqhVJ/cXEzr2nErC1fKtfcRBZwEosj1SFMLV6/hZIouVCqvTrk5np8n5vQdpiOr/V1Dl9i9nJZ/+EoEkrmJFvHrR/yn3RcialMJdoaPxN4sFE99Yqbxp6FntbRWy4W8/4S1Akif3FpsDU1p5LNSqZZSfi81ZpTKbrj9hexhU5TjUX8RyFXBvdKGjWW7nD2rhfm5YtuRE57oVRz+iv5Yndt+LI21Nm4rFSdnkYt45YJaFKggezCuOPJURVnXrHcX+jJF93UjyqU+gqlQm2hNxvtrst80V9iBguletVfWIaKuEK/tzz4/d7y4PU3rsa6J+tKeYFv1RjjmHy1p+D/+oWkFuYVcN0+YtbZX3Hy7lA8ZRyUke6RIKH5CfBno+hUq97V6MZVk+uRQfru/IA9hsF6sVYYKoKvUYHDsLHurVQr5Iu9hb4+P7YhpzJcImNdpTZQrlfzpV7fvTd2z33jasRHp5uI3nqPD+usuI8BPfAwulp3n1MaU+aXQb5SKc+vD/lbSyLe7uneHYKmrjavqbFYoSXhtzTuLLTE/Jbucm2gDYS9sM5iF8tiF8tiF/OPHpFUKJBxSL+E4v6WH7G7AhmBtFp7S93Fcs9c6DZkDDJu0DvUZOUfGN3eHGQWMtNa7GtmS0EmIROtlVozD7wl4M0/cLqyCzIBCXwCfP4jvCszkPDvPsIXa9WBfK9jvL+tvXN96fWmcy2NHxmLULMI3j99uhKpySA1/unTlQgug+AyCDqHJOQCHXY52KURfDrbVijNa/acwXAyGE4WEWSDCDC8DIaXwfAyiDgNT2l4SmbdvcFdmnsr7uqBJkCTgIRAGUbQYbgMI9MW+iOQVmAXtEMPARdCkmIIOQYdpy0bpy87hiTasMMpzLYRnw1+G6mwMVSc6mwbqcKpzo4hqTH4iSEeGzIGvhj8xDC+WIBHXDj92TgN2nYQP+KNIZ5Yss1PbXd5ATKKkSSBSAKRRKTJYFIRAe5UG3eqnYVdFnY5RJ4Dbw687iHe3YHz/e5i4kl3BfBkpebLYh94MKIscFnEk8WIrWCm0R9BXCFkOoxMR+E/Aj0c6Ig7hBmLoD0Knijao8Bhk7ItxBGGDAWVCDzOeTYOCXYcecG5z7bAE4aMB3EF8YM3iv5IIIN25CWC+CzoVqAjHxb8RgMJfDyQsIsH40aFRYO4EQ/OtXYc/TjX2jjn2vEgT2iPAG9BtwIdfizkIRpI8EcxnxbyFwE+jPjDwbyiPRrc4YgzEtiBN4Lx4cxiR4M6CfgDf8h/BHbhTGexvMgp9TsjB6BYJNTmbpvuVuae6twDzbxhhav1UkufM+iegKTxx7gHv15Heor1bjPguLt0a28hP+ge4jsG61Xs9M7opmv35N/WOOe7m63T6+95qKxwONZSb7yUCJnGZu5gQ/SHaaHcLZSHhXRZGJ6VznbizIUzjdMfPLV29Ob7+3GOGe1fu1EMjzZk4WdpC58PWHG7zfvIpKc82O234IdnCz80IxpXx5sz/ECEqFwdTPghycKJ2QrF27xvYpqY8W4tFCDwqwJ+ErYsu807qTUQnfDhHQv973jwBUEEXwBEGkfnxtc+492jaLv/pYx3hvS+9fEv/X7vkaLH6XUXxbz/SDHy4Y6njwreePqPPsMf7/gk3ij8p6jm74f8pxb/GyL/UaLx/ZAP8Q+cHvVin/AsORJm81c9IQu/TltR2/hvV72/iwc3/FY1nEsFv5sEb1HwPjoNPRP8foH2TNAfvO8P3rfDLhv0B29/gvflAU+oE+3Dz2eNzubJSbd6ee9Z2Ak53JkN+TuwK8OQEUjr/wDQh6owAAABAAH//wAPeNpjYMALyoAwjCGMaRMDA5MAA8N/Debl/74zHfj/mUnu/2cID0XNRyYBmDhY1Ufc6pBNYxZGqAMAY30w8gAAAHjarVZpc9NWFJW8JE5ClpKFFnV54sVpaj+ZlEIwYEKQLLvgLs7WSlBaKXbSfYGWGX6Df82VaWfoN35az32yTSBJO8OUYXzPuzp6d78KGUqQsRf4oRCtZ8bMVovGdu4FdNmi1TA6FL29gDLF+O+CUTA6Hblv2TYZIRmerPcN0/Ai1yFTkYgOHcoo0RX0vE25lXv9VXPS8zv+9v3AlrbVCwS124FNm6ElqMqoGoYiSUlxl1ahGpwErfHzNWY+bwcCTvRiQZPtIIJG8LNJRuuM1iMrCsPQIrMchpKMdnAQhg5llcA9uWIMh/JeO6C8dGlMunA/JDNyKKck/BLdJL/vCn6SGudfykZ+h7IlG3pP9EQPdydr+SLC2gqithVvh4EM8XRzJ8Aji4MaWHYor2jcK/eNTJqaMRylK5Fi6caU2T8kswP7lC85NK4EOznldZ7ljH3BN9BmFDIlqmsnC6o/PmV4vluyR8meUC8nfzK9xSzDBQ8RR8LvyZgLoTNlWJxNEhacHHpJ2aKM66mJqVNep2W8ZVgvQjv60hmlA+pPTWb9wLakHZZsh6ZVksn41I3rDs0oEIWgM95dfh1AuiFN82kbp2mcHJrFNXM6JQIZ6MAuzXiR6EWCZpA0h+ZUazdIct16uEzTB/KJQ2+o1lbQ2kmVlg39vNafVYkx6+0FyeysR2bs0myZmxSt6yZn+GcaP2QuoRLZYjtIOHmI1u2hvGy2ZEu8NsRW+pxfQe+zJkQkTfjfhPblUp1SwMQw5iWy5ZGx0TdNU9dqXhmJkfF3A5qVrvBpCk05KdFvrohg/q+5OdOYMVy3FyVnx8r0uGxdQJoWENt82aFFlZgsl5BnludUkmX5pkpyLN9SSZ7leZWMsbRUMs7ybZUUWL6jkgmWHyhRIfOBQyUNHjpU1uCRQ+8qg6bLr+Hje/DxXdwt4CNLGz6yvAAfWUr4yHIZPrIswkeWK/CR5fvwkeUqfGSplKjpVnMUzM5FwkN9Ik+XA+OjuN8qipwyOZiki2jipjilEjKuSl5j/8pAKzm0NiqPuUQXS0neXPQDrCEO8MOjmTn++JISV7S/H4Fn+seNYMJONM56Y+lPg//VN2Q1uWQuIqLLiB8On+wvGjuuOnRFVc7VHFr/LyqasAP6VZTEWCqKimjy8CKVd3q9pmxi2gOsdaxFTPS6aS4uwH4VW2YJA4L/mkITXvmgV5FC1Hq469qLx6KS3kE53AmWoIjnfXMreJoRWWE9zaxkz4cu78ACtqnUbNnA9HmvjlLEeyhd9hkv6qLpvLiLxxkvtoAj3kGvvhPDJSxm2UANJSw0EBeEtoL7TjAi022Xw4Aj93k0VP7YrbiRIypqJ/DbTrfcC1so+XXOgYAmvzLIgawhNTe0mgoYHiEassnGuFo1nTIOYJBRYzeoiBq+jezxQCnYl2HKx4o43Tn69U0LdVIHDyojuY1vDjzwhqWJ+PP8aojDUm4oKSqctQYWcy2sJBVzAQN4a6RuH1Vvvsw+kXNbUbV84qWuomvlHgxzs8Db4xyUpUIVUL1Rhw2zy80l0eoVDEl6XR1LAzv8NVqx+X91H7vP+6UmsUKO1NsOBz76nIxh/A2O35aDBAziGIXcRMiL6XDi6445nK/QZczix6fo72DnmgvzdAX4rqKrEC3Omo+8igY+ZcM8faK4HakF+KnqY88AfAZgMvhc9U2taQNozRZzfIBt5jDYYQ6DXeYw2GPObYAvmMPgS+YwCJjDIGSOB3CPOQzuM4fBV8xh8IA5DYCvmcPgG+YwiJjDIGaOC7DPHAYd5jDoMofBgaLrozQf8oE2gL7V6BbQd7qfcNjE4XtFN0bsH/ig2T9qxOyfNGLqz4pqI+ovfNDUXzVi6m8aMfWhopsj6iM+aOrvGjH1D42Y+lg9nchlhn88uWUqHFB2uf1k+E1x/gFfe01peNpj8N7BcCIoYiMjY1/kBsadHAwcDMkFGxnYnLa4GMgwM2iBmNvNOZQ5BNmZOSA8RzZdNilWMI/TaQ8fAycDSwMDMwMnkM/jtIfBAQzBfGYGl40qjB2BERscOiI2Mqe4bFQD8XZxNDAwsjh0JIdEgJREAsF2Sw5VDmF2Zh6tHYz/Wzew9G5kAuplTXEBAOydJ98AAAAAAAEAAAAA') format('woff');
+}
+
+
+
+/************* Start Fira license *******************
+Digitized data copyright (c) 2012-2015, The Mozilla Foundation and Telefonica S.A.
+with Reserved Font Name < Fira >, 
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
+
+************** End Fira license *********************/
+
+
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/manual-racket.css b/clones/download.racket-lang.org/releases/8.6/doc/manual-racket.css
new file mode 100644
index 00000000..19768b1a
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/manual-racket.css
@@ -0,0 +1,326 @@
+/* See the beginning of "manual.css". */
+
+/* Monospace: */
+
+.RktIn, .RktRdr, .RktPn, .RktMeta,
+.RktMod, .RktKw, .RktVar, .RktSym,
+.RktRes, .RktOut, .RktCmt, .RktVal,
+.RktBlk, .RktErr {
+  font-family: 'Fira-Mono', monospace;
+  white-space: inherit;
+  font-size: 1rem;
+  line-height: 1.5;
+
+}
+
+/* this selctor grabs the first linked Racket symbol
+in a definition box (i.e., the symbol being defined) */
+a.RktValDef, a.RktStxDef, a.RktSymDef,
+span.RktValDef, span.RktStxDef, span.RktSymDef
+{
+    font-size: 1.1rem;
+    color: black;
+    font-weight: 500;
+}
+
+
+.inheritedlbl {
+  font-family: 'Fira', sans-serif;
+}
+
+.RBackgroundLabelInner {
+  font-family: inherit;
+}
+
+/* ---------------------------------------- */
+/* Inherited methods, left margin */
+
+.inherited {
+  width: 95%;
+  margin-top: 0.5em;
+  text-align: left;
+  background-color: inherit;
+}
+
+.inherited td {
+  font-size: 82%;
+  padding-left: 0.5rem;
+  line-height: 1.3;
+  text-indent: 0;
+  padding-right: 0;
+}
+
+.inheritedlbl {
+  font-style: normal;
+}
+
+/* ---------------------------------------- */
+/* Racket text styles */
+
+.RktIn {
+  color: #cc6633;
+  background-color: #eee;
+  white-space: pre;
+}
+
+.RktInBG {
+  background-color: #eee;
+}
+
+
+.refcolumn .RktInBG {
+  background-color: white;
+}
+
+.RktRdr {
+}
+
+.RktPn {
+  color: #843c24;
+}
+
+.RktMeta {
+  color: black;
+}
+
+.RktMod {
+  color: inherit;
+}
+
+.RktOpt {
+  color: black;
+  font-style: italic;
+}
+
+.RktKw {
+  color: black;
+}
+
+.RktErr {
+  color: red;
+  font-style: italic;
+  font-weight: 400;
+}
+
+.RktVar {
+    position: relative;
+    left: -1px; font-style: italic;
+    color: #444;
+}
+
+.SVInsetFlow .RktVar {
+    font-weight: 400;
+    color: #444;
+}
+
+
+.RktSym {
+   color: inherit;
+}
+
+
+
+.RktValLink, .RktStxLink, .RktModLink {
+  text-decoration: none;
+    color: #07A;
+    font-size: 1rem;
+}
+
+/* for syntax links within headings */
+h2 a.RktStxLink, h3 a.RktStxLink, h4 a.RktStxLink, h5 a.RktStxLink,
+h2 a.RktValLink, h3 a.RktValLink, h4 a.RktValLink, h5 a.RktValLink,
+h2 .RktSym, h3 .RktSym, h4 .RktSym, h5 .RktSym,
+h2 .RktMod, h3 .RktMod, h4 .RktMod, h5 .RktMod,
+h2 .RktVal, h3 .RktVal, h4 .RktVal, h5 .RktVal,
+h2 .RktPn, h3 .RktPn, h4 .RktPn, h5 .RktPn {
+    color: #333;
+    font-size: 1.50rem;
+    font-weight: 400;
+}
+
+.toptoclink .RktStxLink, .toclink .RktStxLink,
+.toptoclink .RktValLink, .toclink .RktValLink,
+.toptoclink .RktModLink, .toclink .RktModLink {
+    color: inherit;
+}
+
+.tocset .RktValLink, .tocset .RktStxLink, .tocset .RktModLink, .tocset .RktSym {
+    color: black;
+    font-weight: 400;
+    font-size: 0.9rem;
+}
+
+.tocset td a.tocviewselflink .RktValLink,
+.tocset td a.tocviewselflink .RktStxLink,
+.tocset td a.tocviewselflink .RktMod,
+.tocset td a.tocviewselflink .RktSym {
+    font-weight: lighter;
+    color: white;
+}
+
+
+.RktRes {
+  color: #0000af;
+}
+
+.RktOut {
+  color: #960096;
+}
+
+.RktCmt {
+  color: #c2741f;
+}
+
+.RktVal {
+  color: #228b22;
+}
+
+/* ---------------------------------------- */
+/* Some inline styles */
+
+.together { /* for definitions grouped together in one box */
+  width: 100%;
+  border-top: 2px solid white;
+}
+
+tbody > tr:first-child > td > .together {
+  border-top: 0px; /* erase border on first instance of together */
+}
+
+.RktBlk {
+  white-space: pre;
+  text-align: left;
+}
+
+.highlighted {
+    font-size: 1rem;
+    background-color: #fee;
+}
+
+.defmodule {
+    font-family: 'Fira-Mono', monospace;
+    padding: 0.25rem 0.75rem 0.25rem 0.5rem;
+    margin-bottom: 1rem;
+    width: 100%;
+    background-color: #ebf0f4;
+}
+
+.defmodule a {
+    color: #444;
+}
+
+
+.defmodule td span.hspace:first-child {
+  position: absolute;
+  width: 0;
+  display: inline-block;
+}
+
+.defmodule .RpackageSpec .Smaller,
+.defmodule .RpackageSpec .stt {
+    font-size: 1rem;
+}
+
+/* make parens ordinary color in defmodule */
+.defmodule .RktPn {
+    color: inherit;
+}
+
+.specgrammar {
+    float: none;
+    padding-left: 1em;
+}
+
+
+.RBibliography td {
+  vertical-align: text-top;
+  padding-top: 1em;
+}
+
+.leftindent {
+ margin-left: 2rem;
+ margin-right: 0em;
+}
+
+.insetpara {
+ margin-left: 1em;
+ margin-right: 1em;
+}
+
+.SCodeFlow .Rfilebox {
+    margin-left: -1em; /* see 17.2 of guide, module languages */
+}
+
+.Rfiletitle {
+  text-align: right;
+  background-color: #eee;
+}
+
+.SCodeFlow .Rfiletitle {
+  border-top: 1px dotted gray;
+  border-right: 1px dotted gray;
+}
+
+
+.Rfilename {
+  border-top: 0;
+  border-right: 0;
+  padding-left: 0.5em;
+  padding-right: 0.5em;
+  background-color: inherit;
+}
+
+.Rfilecontent {
+  margin: 0.5em;
+}
+
+.RpackageSpec {
+  padding-right: 0;
+}
+
+/* ---------------------------------------- */
+/* For background labels */
+
+.RBackgroundLabel {
+   float: right;
+   width: 0px;
+   height: 0px;
+}
+
+.RBackgroundLabelInner {
+   position: relative;
+   width: 25em;
+   left: -25.5em;
+   top: 0.20rem; /* sensitive to monospaced font choice */
+   text-align: right;
+   z-index: 0;
+   font-weight: 300;
+   font-family: 'Fira-Mono', monospace;
+   font-size: 0.9rem;
+    color: gray;
+}
+
+
+.RpackageSpec .Smaller {
+   font-weight: 300;
+   font-family: 'Fira-Mono', monospace;
+   font-size: 0.9rem;
+}
+
+.RForeground {
+   position: relative;
+   left: 0px;
+   top: 0px;
+   z-index: 1;
+}
+
+/* ---------------------------------------- */
+/* For section source modules & tags */
+
+.RPartExplain {
+    background: #eee;
+    font-size: 0.9rem;
+    margin-top: 0.2rem;
+    padding: 0.2rem;
+    text-align: left;
+}
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/manual-racket.js b/clones/download.racket-lang.org/releases/8.6/doc/manual-racket.js
new file mode 100644
index 00000000..1ca41162
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/manual-racket.js
@@ -0,0 +1,247 @@
+/* For the Racket manual style */
+
+AddOnLoad(function() {
+    /* Look for header elements that have x-source-module and x-part tag.
+       For those elements, add a hidden element that explains how to
+       link to the section, and set the element's onclick() to display
+       the explanation. */
+    var tag_names = ["h1", "h2", "h3", "h4", "h5"];
+    for (var j = 0; j < tag_names.length; j++) {
+        elems = document.getElementsByTagName(tag_names[j]);
+        for (var i = 0; i < elems.length; i++) {
+            var elem = elems.item(i);
+            AddPartTitleOnClick(elem);
+        }
+    }
+})
+
+// cache of source urls
+var cache = {};
+
+function ParseSource(source, mod_path, single_collection) {
+
+    var source_url = new URL(source);
+
+    if (source_url.protocol == "github:") {
+        // browser URL parser only works with http(s) URLs
+        source_url = new URL("https" + source.substring(6));
+        var host = source_url.host;
+        var url_path = source_url.pathname.substring(1).split("/");
+        if (!(url_path.length >= 2)) return null;
+        var user = url_path.shift();
+        var repo = url_path.shift();
+        var branch = url_path.shift();
+        var source_path = url_path.join("/");
+    }
+    else if (("https:" == source_url.protocol) || ("git:" == source_url.protocol)) {
+        // browser URL parser only works with http(s) URLs
+        if ("git:" == source_url.protocol)
+            source_url = new URL("https" + source.substring(3));
+
+        var host = source_url.host;
+        var source_path = source_url.searchParams.get("path");
+        var branch = (source_url.hash || "#master").substring(1);
+        var url_path = source_url.pathname.substring(1).split("/");
+        if (url_path.length < 2) throw [source_url.pathname, url_path];
+        var user = url_path.shift();
+        var repo = url_path.shift();
+        var mtch = repo.match(/(.*)\.git$/);
+        if (mtch) repo = mtch[1];
+
+    }
+    else return null;
+
+    var mod_path_re = /^\(lib "(.+)"\)$/;
+
+    var mod_path_elems = mod_path && mod_path.match(mod_path_re)[1].split("/");
+
+    if (!user || !repo || !mod_path_elems)
+        return null;
+    if (single_collection)
+        mod_path_elems.shift();
+
+    var file_path = mod_path_elems.join("/");
+
+
+    if (source_path) {
+        file_path = source_path + "/" + file_path;
+    }
+
+    return { user: user,
+             repo: repo,
+             file_path: file_path,
+             branch: branch,
+             host: host };
+}
+
+function AddSourceElement(pkg_url, info) {
+    info.appendChild(document.createTextNode("Document source "));
+    var url_line = document.createElement("div");
+    var a = document.createElement("a");
+    a.href = pkg_url;
+    a.style.whiteSpace = "nowrap";
+    a.appendChild(document.createTextNode(pkg_url));
+    addSpan(url_line, "\xA0", "RktRdr");
+    url_line.appendChild(a);
+    info.appendChild(url_line);
+}
+
+var prefixes = { "github.com": "tree",
+                 "gitlab.com": "-/blob" };
+
+
+function AddSourceUrl(source, mod_path, collection, info) {
+    // multi is encoded as an array, empty as false
+    single_collection = (typeof collection === "string");
+
+    var parsed = source && mod_path && ParseSource(source, mod_path, single_collection);
+
+    if (!parsed) return;
+
+    prefix = prefixes.hasOwnProperty(parsed.host) && prefixes[parsed.host];
+    if (!prefix) return;
+
+    var correct_url = "https://" + [parsed.host, parsed.user, parsed.repo, prefix, parsed.branch, parsed.file_path].join("/");
+
+    if (info) AddSourceElement(correct_url, info);
+}
+
+function addSpan(dest, str, cn) {
+    var s = document.createElement("span");
+    s.className = cn;
+    s.style.whiteSpace = "nowrap";
+    s.appendChild(document.createTextNode(str));
+    dest.appendChild(s);
+}
+
+
+// test cases
+if (false) {
+    console.log(ParseSource("git://gitlab.com/benn/foo?path=xxx",
+                            '(lib "asn1/scribblings/asn1.scrbl")',
+                            false))
+    console.log(ParseSource("github://github.com/carl-eastlund/mischief/master",
+                            '(lib "asn1/scribblings/asn1.scrbl")',
+                            false))
+    console.log(ParseSource("github://github.com/carl-eastlund/mischief/stable/dir",
+                            '(lib "asn1/scribblings/asn1.scrbl")',
+                            false))
+
+    console.log(ParseSource("git://github.com/racket/racket/?path=pkgs/racket-doc",
+                            '(lib "asn1/scribblings/asn1.scrbl")',
+                            false));
+
+    console.log(ParseSource("git://github.com/rmculpepper/asn1.git?path=asn1-doc",
+                            '(lib "asn1/scribblings/asn1.scrbl")',
+                            true));
+    console.log(ParseSource("git://github.com/rmculpepper/asn1",
+                            '(lib "asn1/scribblings/asn1.scrbl")',
+                            true));
+    console.log(ParseSource("git://github.com/rmculpepper/asn1",
+                            '(lib "asn1/scribblings/asn1.scrbl")',
+                            false));
+}
+
+function AddPartTitleOnClick(elem) {
+    var mod_path = elem.getAttribute("x-source-module");
+    var tag = elem.getAttribute("x-part-tag");
+    var source_pkg = elem.getAttribute("x-source-pkg");
+
+    // create here to share
+    var info = document.createElement("div");
+
+
+    // tag is not needed, but this way we can add the element in only one place
+    // avoid failing on browser that don't have `fetch`
+    if (mod_path && source_pkg && tag && window.fetch) {
+
+        var cached = cache[mod_path]
+        if (cached) {
+            AddSourceElement(cached[0], mod_path, cached[1], info);
+        }
+        else {
+            fetch("https://pkgs.racket-lang.org/pkg/" + source_pkg + ".json")
+                .then(function (response) { return response.json(); })
+                .then(function (data) {
+                    var vers = data["versions"] || {};
+                    var def = vers["default"] || {};
+                    var source = def["source"] || undefined;
+                    var collection = data["collection"];
+                    if (source) {
+                        cache[mod_path] = [source, collection];
+                        AddSourceUrl(source, mod_path, collection, info);
+                    }
+                });
+        }
+    }
+
+    if (mod_path && tag) {
+        // Might not be present:
+        var prefixes = elem.getAttribute("x-part-prefixes");
+
+        info.className = "RPartExplain";
+
+        /* The "top" tag refers to a whole document: */
+        var is_top = (tag == "\"top\"");
+        info.appendChild(document.createTextNode("Link to this "
+                                                 + (is_top ? "document" : "section")
+                                                 + " with "));
+
+        /* Break `secref` into two lines if the module path and tag
+           are long enough: */
+        var is_long = (is_top ? false : ((mod_path.length
+                                          + tag.length
+                                          + (prefixes ? (16 + prefixes.length) : 0))
+                                         > 60));
+
+        var line1 = document.createElement("div");
+        var line1x = ((is_long && prefixes) ? document.createElement("div") : line1);
+        var line2 = (is_long ? document.createElement("div") : line1);
+
+        /* Construct a `secref` call with suitable syntax coloring: */
+        addSpan(line1, "\xA0@", "RktRdr");
+        addSpan(line1, (is_top ? "other-doc" : "secref"), "RktSym");
+        addSpan(line1, "[", "RktPn");
+        if (!is_top)
+            addSpan(line1, tag, "RktVal");
+        if (is_long) {
+            /* indent additional lines: */
+            if (prefixes)
+                addSpan(line1x, "\xA0\xA0\xA0\xA0\xA0\xA0\xA0\xA0", "RktPn");
+            addSpan(line2, "\xA0\xA0\xA0\xA0\xA0\xA0\xA0\xA0", "RktPn");
+        }
+        if (prefixes) {
+            addSpan(line1x, " #:tag-prefixes ", "RktPn");
+            addSpan(line1x, "'", "RktVal");
+            addSpan(line1x, prefixes, "RktVal");
+        }
+        if (!is_top)
+            addSpan(line2, " #:doc ", "RktPn");
+        addSpan(line2, "'", "RktVal");
+        addSpan(line2, mod_path, "RktVal");
+        addSpan(line2, "]", "RktPn");
+
+        info.appendChild(line1);
+        if (is_long)
+            info.appendChild(line1x);
+        if (is_long)
+            info.appendChild(line2);
+
+        info.style.display = "none";
+
+        /* Add the new element afterthe header: */
+        var n = elem.nextSibling;
+        if (n)
+            elem.parentNode.insertBefore(info, n);
+        else
+            elem.parentNode.appendChild(info);
+
+        /* Clicking the header shows the explanation element: */
+        elem.onclick = function () {
+            if (info.style.display == "none")
+                info.style.display = "block";
+            else
+                info.style.display = "none";
+        }
+    }
+}
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/manual-style.css b/clones/download.racket-lang.org/releases/8.6/doc/manual-style.css
new file mode 100644
index 00000000..340290bb
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/manual-style.css
@@ -0,0 +1,784 @@
+
+/* See the beginning of "scribble.css".
+   This file is used by the `scribble/manual` language, along with
+   "manual-racket.css". */
+
+@import url("manual-fonts.css");
+
+* {
+    margin: 0;
+    padding: 0;
+}
+
+@media all {html {font-size: 15px;}}
+@media all and (max-width:940px){html {font-size: 14px;}}
+@media all and (max-width:850px){html {font-size: 13px;}}
+@media all and (max-width:830px){html {font-size: 12px;}}
+@media all and (max-width:740px){html {font-size: 11px;}}
+
+/* CSS seems backward: List all the classes for which we want a
+   particular font, so that the font can be changed in one place.  (It
+   would be nicer to reference a font definition from all the places
+   that we want it.)
+
+   As you read the rest of the file, remember to double-check here to
+   see if any font is set. */
+
+/* Monospace: */
+.maincolumn, .refpara, .refelem, .tocset, .stt, .hspace, .refparaleft, .refelemleft {
+    font-family: 'Fira-Mono', monospace;
+    white-space: inherit;
+    font-size: 1rem;
+}
+
+/* embolden the "Racket Guide" and "Racket Reference" links on the TOC */
+/* there isn't an obvious tag in the markup that designates the top TOC page, which is called "start.scrbl" */
+/* nor a tag that designates these two links as special */
+/* so we'll use this slightly tortured sibling selector that hooks onto the h2 tag */
+h2[x-source-module='(lib "scribblings/main/start.scrbl")'] ~ table a[href="guide/index.html"], 
+h2[x-source-module='(lib "scribblings/main/start.scrbl")'] ~ table a[href="reference/index.html"] {
+  font-weight: bold;
+}
+
+
+h2 .stt {
+    font-size: 2.3rem;
+    /* prevent automatic bolding from h2 */
+    font-weight: 400;
+}
+
+.toptoclink .stt {
+    font-size: inherit;
+}
+.toclink .stt {
+    font-size: 90%;
+}
+
+.RpackageSpec .stt {
+    font-weight: 300;
+    font-family: 'Fira-Mono', monospace;
+    font-size: 0.9rem;
+}
+
+h3 .stt, h4 .stt, h5 .stt {
+    color: #333;
+    font-size: 1.65rem;
+    font-weight: 400;
+}
+
+
+/* Serif: */
+.main, .refcontent, .tocview, .tocsub, .sroman, i {
+    font-family: 'Charter-Racket', serif;
+    font-size: 1.18rem;
+/* Don't use font-feature-settings with Charter, 
+it fouls up loading for reasons mysterious */
+/*    font-feature-settings: 'tnum' 1, 'liga' 0; */
+}
+
+
+/* Sans-serif: */
+.version, .versionNoNav, .ssansserif {
+    font-family: 'Fira', sans-serif;
+}
+
+/* used mostly for DrRacket menu commands */
+.ssansserif {
+    font-family: 'Fira', sans-serif;
+    font-size: 0.9em;
+}
+
+.tocset .ssansserif {
+    font-size: 100%;
+}
+
+/* ---------------------------------------- */
+
+p, .SIntrapara {
+    display: block;
+    margin: 0 0 1em 0;
+    line-height: 1.4;
+}
+
+.compact {
+  padding: 0 0 1em 0;
+}
+
+li {
+    list-style-position: outside;
+    margin-left: 1.2em;
+}
+
+h1, h2, h3, h4, h5, h6, h7, h8 {
+    font-family: 'Fira', sans-serif;
+    font-weight: 300;
+    font-size: 1.6rem;
+    color: #333;
+    margin-top: inherit;
+    margin-bottom: 1rem;
+    line-height: 1.25;
+
+}
+
+h3, h4, h5, h6, h7, h8 {
+    border-top: 1px solid black;
+}
+
+
+
+h2 { /* per-page main title */
+    font-family: 'Cooper-Hewitt';
+    margin-top: 4rem;
+    font-size: 2.3rem;
+    font-weight: bold;
+    line-height: 1.2;
+    width: 90%;
+    /* a little nudge to make text visually lower than 4rem rule in left margin */
+    position: relative;
+    top: 6px;
+}
+
+h3, h4, h5, h6, h7, h8 {
+    margin-top: 2em;
+    padding-top: 0.1em;
+    margin-bottom: 0.75em;
+}
+
+/* ---------------------------------------- */
+/* Main */
+
+body {
+    color: black;
+    background-color: white;
+}
+
+.maincolumn {
+    width: auto;
+    margin-top: 4rem;
+    margin-left: 17rem;
+    margin-right: 2rem;
+    margin-bottom: 10rem; /* to avoid fixed bottom nav bar */
+    max-width: 700px;
+    min-width: 370px; /* below this size, code samples don't fit */
+}
+
+a {
+    text-decoration: inherit;
+}
+
+a, .toclink, .toptoclink, .tocviewlink, .tocviewselflink, .tocviewtoggle, .plainlink, 
+.techinside, .techoutside:hover, .techinside:hover {
+    color: #07A;
+}
+
+a:hover {
+    text-decoration: underline;
+}
+
+
+/* ---------------------------------------- */
+/* Navigation */
+
+.navsettop, .navsetbottom {
+    left: 0;
+    width: 15rem;
+    height: 6rem;
+    font-family: 'Fira', sans-serif;
+    font-size: 0.9rem;
+    border-bottom: 0px solid hsl(216, 15%, 70%);
+    background-color: inherit;
+    padding: 0;
+}
+
+.navsettop {
+    position: fixed;
+    z-index: 2;
+    background: #a7b0be;
+    top: 0;
+    left: 0;
+    margin-bottom: 0;
+    border-bottom: 0;
+}
+
+.navsettop a, .navsetbottom a {
+    color: black;
+}
+
+.navsettop a:hover, .navsetbottom a:hover {
+    background: hsl(216, 78%, 95%);
+    text-decoration: none;
+}
+
+.navleft, .navright {
+    position: static;
+    float: none;
+    margin: 0;
+    white-space: normal;
+}
+
+
+.navleft a {
+    display: inline-block;
+}
+
+.navright a {
+    display: inline-block;
+    text-align: center;
+}
+
+.navleft a, .navright a, .navright span {
+    display: inline-block;
+    padding: 0.5rem;
+    min-width: 1rem;
+}
+
+
+.navright {
+    white-space: nowrap;
+}
+
+
+.navsetbottom {
+    display: none;
+}
+
+.nonavigation {
+    color: #889;
+}
+
+.searchform {
+    display: block;
+    margin: 0;
+    padding: 0;
+    border-bottom: 1px solid #eee;
+    height: 4rem;
+}
+
+.nosearchform {
+    margin: 0;
+    padding: 0;
+    height: 4rem;
+}
+
+.searchbox {
+    font-size: 0.9rem;
+    width: 12rem;
+    margin: 1rem;
+    padding: 0.25rem 0.4rem ;
+    vertical-align: middle;
+    background-color: white;
+    font-family: 'Fira-Mono', monospace;
+}
+
+
+#search_box {
+    font-family: 'Fira-Mono', monospace;
+    font-size: 1rem;
+    padding: 0.25rem 0.3rem ;
+}
+
+/* Default to local view. Global will specialize */
+.plt_global_only { display: none; }
+.plt_local_only { display: block; }
+
+/* ---------------------------------------- */
+/* Version */
+
+.versionbox {
+    position: absolute;
+    float: none;
+    top: 0.25rem;
+    left: 17rem;
+    z-index: 11000;
+    height: 2em;
+    font-size: 70%;
+    font-weight: lighter;
+    width: inherit;
+    margin: 0;
+}
+.version, .versionNoNav {
+    font-size: inherit;
+}
+.version:before, .versionNoNav:before {
+    content: "v.";
+}
+
+
+/* ---------------------------------------- */
+/* Margin notes */
+
+/* cancel scribble.css styles: */
+.refpara, .refelem {
+  position: static;
+  float: none;
+  height: auto;
+  width: auto;
+  margin: 0;
+}
+
+.refcolumn {
+    position: static;
+    display: block;
+    width: auto;
+    font-size: inherit;
+    margin: 2rem;
+    margin-left: 2rem;
+    padding: 0.5em;
+    padding-left: 0.75em;
+    padding-right: 1em;
+    background: hsl(60, 29%, 94%);
+    border: 1px solid #ccb;
+    border-left: 0.4rem solid #ccb;
+}
+
+
+/* slightly different handling for margin-note* on narrow screens */
+@media all and (max-width:1340px) {
+     span.refcolumn {
+         float: right;
+         width: 50%;
+         margin-left: 1rem;
+         margin-bottom: 0.8rem;   
+         margin-top: 1.2rem; 
+     }
+
+}
+
+.refcontent, .refcontent p {
+    line-height: 1.5;
+    margin: 0;
+}
+
+.refcontent p + p {
+    margin-top: 1em;
+}
+
+.refcontent a {
+    font-weight: 400;
+}
+
+.refpara, .refparaleft {
+    top: -1em;
+}
+
+
+@media all and (max-width:600px) {
+    .refcolumn {
+        margin-left: 0;
+        margin-right: 0;
+    }
+}
+
+
+@media all and (min-width:1340px) {
+    .refcolumn {
+        margin: 0 -22.5rem 1rem 0;
+        float: right;
+        clear: right;
+        width: 18rem;
+    }
+}
+
+.refcontent {
+    font-family: 'Fira', sans-serif;
+    font-size: 1rem;
+    line-height: 1.6;
+    margin: 0 0 0 0;
+}
+
+
+.refparaleft, .refelemleft {
+    position: relative;
+    float: left;
+    right: 2em;
+    height: 0em;
+    width: 13em;
+    margin: 0em 0em 0em 0em;
+    display: contents;
+}
+
+.refcolumnleft {
+    background-color: hsl(60, 29%, 94%);
+    display: block;
+    position: relative;
+    width: 13em;
+    font-size: 85%;
+    border: 0.5em solid hsl(60, 29%, 94%);
+    margin: 0 0 0 0;
+}
+
+
+/* ---------------------------------------- */
+/* Table of contents, left margin */
+
+.tocset {
+    position: fixed;
+    z-index: 2;
+    overflow-y: scroll;
+    float: none;
+    left: 0;
+    top: 0rem;
+    bottom: 0;
+    width: 14rem;
+    padding: 0rem 0.5rem 0.5rem 0.5rem;
+    background-color: hsl(216, 15%, 70%);
+    border-top: 6rem solid hsl(216, 15%, 70%);
+}
+
+.tocset td {
+    vertical-align: text-top;
+    padding-bottom: 0.4rem;
+    padding-left: 0.2rem;
+    line-height: 1.1;
+    font-family: 'Fira', sans-serif;
+}
+
+.tocset td a {
+    color: black;
+    font-weight: 400;
+}
+
+
+.tocview {
+    text-align: left;
+    background-color: inherit;
+    margin-top: 1em;
+}
+
+
+.tocview td, .tocsub td {
+    line-height: 1.3;
+}
+
+
+.tocview table, .tocsub table {
+    width: 90%;
+}
+
+.tocset td a.tocviewselflink {
+    font-weight: lighter;
+    font-size: 110%; /* monospaced styles below don't need to enlarge */
+    color: white;
+}
+
+.tocviewselflink {
+    text-decoration: none;
+}
+
+.tocsub {
+    text-align: left;
+    margin-top: 0.5em;
+    background-color: inherit;
+}
+
+.tocviewlist, .tocsublist {
+    margin-left: 0.2em;
+    margin-right: 0.2em;
+    padding-top: 0.2em;
+    padding-bottom: 0.2em;
+}
+.tocviewlist table {
+    font-size: 82%;
+}
+
+.tocviewlisttopspace {
+    margin-bottom: 1em;
+}
+
+.tocviewsublist, .tocviewsublistonly, .tocviewsublisttop, .tocviewsublistbottom {
+    margin-left: 0.4em;
+    border-left: 1px solid #99a;
+    padding-left: 0.8em;
+}
+.tocviewsublist {
+    margin-bottom: 1em;
+}
+.tocviewsublist table,
+.tocviewsublistonly table,
+.tocviewsublisttop table,
+.tocviewsublistbottom table,
+table.tocsublist {
+    font-size: 1rem;
+}
+
+.tocviewsublist td, 
+.tocviewsublistbottom td, 
+.tocviewsublisttop td, 
+.tocsub td,
+.tocviewsublistonly td {
+    font-size: 90%;
+}
+
+/* shrink the monospaced text (`stt`) within nav */
+.tocviewsublist td .stt, 
+.tocviewsublistbottom td .stt, 
+.tocviewsublisttop td .stt, 
+.tocsub td .stt,
+.tocviewsublistonly td .stt {
+    font-size: 95%;
+}
+
+
+.tocviewtoggle {
+    font-size: 75%; /* looks better, and avoids bounce when toggling sub-sections due to font alignments */
+}
+
+.tocsublist td {
+    padding-left: 0.5rem;
+    padding-top: 0.25rem;
+    text-indent: 0;
+}
+
+.tocsublinknumber {
+    font-size: 100%;
+}
+
+.tocsublink {
+    font-size: 82%;
+    text-decoration: none;
+}
+
+.tocsubseclink {
+    font-size: 100%;
+    text-decoration: none;
+}
+
+.tocsubnonseclink {
+    font-size: 82%;
+    text-decoration: none;
+    margin-left: 1rem;
+    padding-left: 0;
+    display: inline-block;
+}
+
+/* the label "on this page" */
+.tocsubtitle {
+    display: block;
+    font-size: 62%;
+    font-family: 'Fira', sans-serif;
+    font-weight: bolder;
+    font-style: normal;
+    letter-spacing: 2px;
+    text-transform: uppercase;
+    margin: 0.5em;
+}
+
+.toptoclink {
+    font-weight: bold;
+    font-size: 110%;
+    margin-bottom: 0.5rem;
+    margin-top: 1.5rem;
+    display: inline-block;
+}
+
+.toclink {
+    font-size: inherit;
+}
+
+/* ---------------------------------------- */
+/* Some inline styles */
+
+.indexlink {
+    text-decoration: none;
+}
+
+pre {
+  margin-left: 2em;
+}
+
+blockquote {
+  margin-left: 2em;
+  margin-right: 2em;
+  margin-bottom: 1em;
+}
+
+.SCodeFlow {
+    border-left: 1px dotted black;
+    padding-left: 1em;
+    padding-right: 1em;
+    margin-top: 1em;
+    margin-bottom: 1em;
+    margin-left: 0em;
+    margin-right: 2em;
+    white-space: nowrap;
+    line-height: 1.5;
+}
+
+.SCodeFlow img {
+    margin-top: 0.5em;
+    margin-bottom: 0.5em;
+}
+
+/* put a little air between lines of code sample */
+/* Fira Mono appears taller than Source Code Pro */
+.SCodeFlow td {
+    padding-bottom: 1px;
+}
+
+.boxed {
+    margin: 0;
+    margin-top: 2em;
+    padding: 0.25em;
+    padding-top: 0.3em;
+    padding-bottom: 0.4em;
+    background: #f3f3f3;
+    box-sizing:border-box;
+    border-top: 1px solid #99b;
+    background: hsl(216, 78%, 95%);
+    background: -moz-linear-gradient(to bottom left, hsl(0, 0%, 99%) 0%, hsl(216, 62%, 95%) 100%);
+    background: -webkit-linear-gradient(to bottom left, hsl(0, 0%, 99%) 0%, hsl(216, 62%, 95%) 100%);
+    background: -o-linear-gradient(to bottom left, hsl(0, 0%, 99%) 0%, hsl(216, 62%, 95%) 100%);
+    background: -ms-linear-gradient(to bottom left, hsl(0, 0%, 99%) 0%, hsl(216, 62%, 95%) 100%);
+    background: linear-gradient(to bottom left, hsl(0, 0%, 99%) 0%, hsl(216, 62%, 95%) 100%);
+}
+
+blockquote > blockquote.SVInsetFlow {
+/* resolves issue in e.g. /reference/notation.html */
+    margin-top: 0em;
+}
+
+.leftindent .SVInsetFlow { /* see e.g. section 4.5 of Racket Guide */
+    margin-top: 1em;
+    margin-bottom: 1em;
+}
+
+.SVInsetFlow a, .SCodeFlow a {
+    color: #07A;
+}
+
+.SubFlow {
+    display: block;
+    margin: 0em;
+}
+
+.boxed {
+    width: 100%;
+    background-color: inherit;
+}
+
+.techoutside       { text-decoration: none; }
+
+.SAuthorListBox {
+    position: static;
+    float: none;
+    font-family: 'Fira', sans-serif;
+    font-weight: 300;
+    font-size: 110%;
+    margin-top: 1rem;
+    margin-bottom: 2rem;
+    width: 30rem;
+    height: auto;
+}
+
+.author > a { /* email links within author block */
+    font-weight: inherit;
+    color: inherit;
+}
+
+.SAuthorList {
+    font-size: 82%;
+}
+.SAuthorList:before {
+    content: "by ";
+}
+.author {
+    display: inline;
+    white-space: nowrap;
+}
+
+/* phone + tablet styles */
+
+@media all and (max-width:720px){
+
+
+    @media all and (max-width:720px){
+
+        @media all {html {font-size: 15px;}}
+        @media all and (max-width:700px){html {font-size: 14px;}}
+        @media all and (max-width:630px){html {font-size: 13px;}}
+        @media all and (max-width:610px){html {font-size: 12px;}}
+        @media all and (max-width:550px){html {font-size: 11px;}}
+        @media all and (max-width:520px){html {font-size: 10px;}}
+
+        .navsettop, .navsetbottom {
+            display: flex;
+            position: absolute;
+            width: 100%;
+            height: 4rem;
+            border: 0;
+            background-color: hsl(216, 15%, 70%);
+            align-items: center;
+        }
+
+        .tocsetoverlay .navsettop {
+            position: fixed;
+        }
+
+        .navleft {
+            flex: 1;
+        }
+
+        .searchform {
+            display: inline;
+            border: 0;
+        }
+
+        .searchbox {
+            margin-top: 0;
+            margin-bottom: 0;
+        }
+
+        .navleft .tocsettoggle {
+            display: initial;
+        }
+
+        .navright {
+            margin-right: 1.3rem;
+            border: 0px solid red;
+        }
+
+        .navsetbottom {
+            display: block;
+            margin-top: 8rem;
+        }
+
+        .tocset {
+            display: none;
+            border-top-width: 4rem;
+        }
+
+        .tocsetoverlay .tocset {
+            display: block;
+        }
+
+        .versionbox {
+            top: 4.5rem;
+            left: 1rem; /* same distance as main-column */
+            z-index: 1;
+            height: 2em;
+            font-size: 70%;
+            font-weight: lighter;
+        }
+
+
+        .maincolumn {
+            margin-left: 1em;
+            margin-top: 7rem;
+            margin-bottom: 0rem;
+        }
+
+    }
+
+}
+
+/* print styles : hide the navigation elements */
+@media print {
+    .tocset,
+    .navsettop,
+    .navsetbottom { display: none; }
+    .maincolumn {
+        width: auto;
+        margin-right: 13em;
+        margin-left: 0;
+    }
+}
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/racket.css b/clones/download.racket-lang.org/releases/8.6/doc/racket.css
new file mode 100644
index 00000000..85dec2f6
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/racket.css
@@ -0,0 +1,251 @@
+
+/* See the beginning of "scribble.css". */
+
+/* Monospace: */
+.RktIn, .RktRdr, .RktPn, .RktMeta,
+.RktMod, .RktKw, .RktVar, .RktSym,
+.RktRes, .RktOut, .RktCmt, .RktVal,
+.RktBlk {
+  font-family: monospace;
+  white-space: inherit;
+}
+
+/* Serif: */
+.inheritedlbl {
+  font-family: serif;
+}
+
+/* Sans-serif: */
+.RBackgroundLabelInner {
+  font-family: sans-serif;
+}
+
+/* ---------------------------------------- */
+/* Inherited methods, left margin */
+
+.inherited {
+  width: 100%;
+  margin-top: 0.5em;
+  text-align: left;
+  background-color: #ECF5F5;
+}
+
+.inherited td {
+  font-size: 82%;
+  padding-left: 1em;
+  text-indent: -0.8em;
+  padding-right: 0.2em;
+}
+
+.inheritedlbl {
+  font-style: italic;
+}
+
+/* ---------------------------------------- */
+/* Racket text styles */
+
+.RktIn {
+  color: #cc6633;
+  background-color: #eeeeee;
+  white-space: pre;
+}
+
+.RktInBG {
+  background-color: #eeeeee;
+}
+
+.RktRdr {
+}
+
+.RktPn {
+  color: #843c24;
+}
+
+.RktMeta {
+  color: black;
+}
+
+.RktMod {
+  color: black;
+}
+
+.RktOpt {
+  color: black;
+  font-style: italic;
+}
+
+.RktKw {
+  color: black;
+}
+
+.RktErr {
+  color: red;
+  font-style: italic;
+}
+
+.RktVar {
+  color: #262680;
+  font-style: italic;
+}
+
+.RktSym {
+  color: #262680;
+}
+
+.RktSymDef { /* used with RktSym at def site */
+}
+
+.RktValLink {
+  text-decoration: none;
+  color: blue;
+}
+
+.RktValDef { /* used with RktValLink at def site */
+}
+
+.RktModLink {
+  text-decoration: none;
+  color: blue;
+}
+
+.RktStxLink {
+  text-decoration: none;
+  color: black;
+}
+
+.RktStxDef { /* used with RktStxLink at def site */
+}
+
+.RktRes {
+  color: #0000af;
+}
+
+.RktOut {
+  color: #960096;
+}
+
+.RktCmt {
+  color: #c2741f;
+}
+
+.RktVal {
+  color: #228b22;
+}
+
+/* ---------------------------------------- */
+/* Some inline styles */
+
+.together {
+  width: 100%;
+}
+
+.prototype, .argcontract, .RBoxed {
+  white-space: nowrap;
+}
+
+.prototype td {
+  vertical-align: text-top;
+}
+
+.RktBlk {
+  white-space: inherit;
+  text-align: left;
+}
+
+.RktBlk tr {
+  white-space: inherit;
+}
+
+.RktBlk td {
+  vertical-align: baseline;
+  white-space: inherit;
+}
+
+.argcontract td {
+  vertical-align: text-top;
+}
+
+.highlighted {
+  background-color: #ddddff;
+}
+
+.defmodule {
+  width: 100%;
+  background-color: #F5F5DC;
+}
+
+.specgrammar {
+  float: right;
+}
+
+.RBibliography td {
+  vertical-align: text-top;
+}
+
+.leftindent {
+ margin-left: 1em;
+ margin-right: 0em;
+}
+
+.insetpara {
+ margin-left: 1em;
+ margin-right: 1em;
+}
+
+.Rfilebox {
+}
+
+.Rfiletitle {
+  text-align: right;
+  margin: 0em 0em 0em 0em;
+}
+
+.Rfilename {
+  border-top: 1px solid #6C8585;
+  border-right: 1px solid #6C8585;
+  padding-left: 0.5em;
+  padding-right: 0.5em;
+  background-color: #ECF5F5;
+}
+
+.Rfilecontent {
+  margin: 0em 0em 0em 0em;
+}
+
+.RpackageSpec {
+  padding-right: 0.5em;
+}
+
+/* ---------------------------------------- */
+/* For background labels */
+
+.RBackgroundLabel {
+   float: right;
+   width: 0px;
+   height: 0px;
+}
+
+.RBackgroundLabelInner {
+   position: relative;
+   width: 25em;
+   left: -25.5em;
+   top: 0px;
+   text-align: right;
+   color: white;
+   z-index: 0;
+   font-weight: bold;
+}
+
+.RForeground {
+   position: relative;
+   left: 0px;
+   top: 0px;
+   z-index: 1;
+}
+
+/* ---------------------------------------- */
+/* History */
+
+.SHistory {
+  font-size: 82%;
+}
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/scribble-common.js b/clones/download.racket-lang.org/releases/8.6/doc/scribble-common.js
new file mode 100644
index 00000000..ceab368a
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/scribble-common.js
@@ -0,0 +1,196 @@
+// Common functionality for PLT documentation pages
+
+// Page Parameters ------------------------------------------------------------
+
+var page_query_string = location.search.substring(1);
+
+var page_args =
+  ((function(){
+      if (!page_query_string) return [];
+      var args = page_query_string.split(/[&;]/);
+      for (var i=0; i<args.length; i++) {
+        var a = args[i];
+        var p = a.indexOf('=');
+        if (p >= 0) args[i] = [a.substring(0,p), a.substring(p+1)];
+        else args[i] = [a, false];
+      }
+      return args;
+    })());
+
+function GetPageArg(key, def) {
+  for (var i=0; i<page_args.length; i++)
+    if (page_args[i][0] === key) {
+      try {
+        return decodeURIComponent(page_args[i][1]);
+      } catch (e) {
+        if (e instanceof URIError) {
+          return page_args[i][1];
+        } else {
+          throw e;
+        }
+      }
+    }
+  return def;
+}
+
+function MergePageArgsIntoLink(a) {
+  if (page_args.length == 0 ||
+      (!a.attributes["data-pltdoc"]) || (a.attributes["data-pltdoc"].value == ""))
+    return;
+  a.href = MergePageArgsIntoUrl(a.href);
+}
+
+function MergePageArgsIntoUrl(href) {
+    var mtch = href.match(/^([^?#]*)(?:\?([^#]*))?(#.*)?$/);
+    if (mtch == undefined) { // I think this never happens
+        return "?" + page_query_string;
+    }
+    if (!mtch[2]) {
+        return mtch[1] + "?" + page_query_string + (mtch[3] || "");
+    }
+    // need to merge here, precedence to arguments that exist in `a'
+    var i, j;
+    var prefix = mtch[1], str = mtch[2] || "", suffix = mtch[3] || "";
+    var args = str.split(/[&;]/);
+    for (i=0; i<args.length; i++) {
+      j = args[i].indexOf('=');
+      if (j) args[i] = args[i].substring(0,j);
+    }
+    var additions = "";
+    for (i=0; i<page_args.length; i++) {
+      var exists = false;
+      for (j=0; j<args.length; j++)
+        if (args[j] == page_args[i][0]) { exists = true; break; }
+      if (!exists) str += "&" + page_args[i][0] + "=" + page_args[i][1];
+    }
+    return prefix + "?" + str + suffix;
+}
+
+// Cookies --------------------------------------------------------------------
+
+// Actually, try localStorage (a la HTML 5), first.
+
+function GetCookie(key, def) {
+  try {
+    var v = localStorage[key];
+    if (!v) v = def;
+    return v;
+  } catch (e) {
+    var i, cookiestrs;
+    try {
+      if (document.cookie.length <= 0) return def;
+      cookiestrs = document.cookie.split(/; */);
+    } catch (e) { return def; }
+    for (i = 0; i < cookiestrs.length; i++) {
+      var cur = cookiestrs[i];
+      var eql = cur.indexOf('=');
+      if (eql >= 0 && cur.substring(0,eql) == key)
+        return unescape(cur.substring(eql+1));
+    }
+    return def;
+  }
+}
+
+function SetCookie(key, val) {
+  try {
+    localStorage[key] = val;
+  } catch(e) {
+    var d = new Date();
+    d.setTime(d.getTime()+(365*24*60*60*1000));
+    try {
+      document.cookie =
+        key + "=" + escape(val) + "; expires="+ d.toGMTString() + "; path=/";
+    } catch (e) {}
+  }
+}
+
+// note that this always stores a directory name, ending with a "/"
+function SetPLTRoot(ver, relative) {
+  var root = location.protocol + "//" + location.host
+           + NormalizePath(location.pathname.replace(/[^\/]*$/, relative));
+  SetCookie("PLT_Root."+ver, root);
+}
+
+// adding index.html works because of the above
+function GotoPLTRoot(ver, relative) {
+  var u = GetCookie("PLT_Root."+ver, null);
+  if (u == null) return true; // no cookie: use plain up link
+  // the relative path is optional, default goes to the toplevel start page
+  if (!relative) relative = "index.html";
+  location = u + relative;
+  return false;
+}
+
+// Utilities ------------------------------------------------------------------
+
+var normalize_rxs = [/\/\/+/g, /\/\.(\/|$)/, /\/[^\/]*\/\.\.(\/|$)/];
+function NormalizePath(path) {
+  var tmp, i;
+  for (i = 0; i < normalize_rxs.length; i++)
+    while ((tmp = path.replace(normalize_rxs[i], "/")) != path) path = tmp;
+  return path;
+}
+
+// `noscript' is problematic in some browsers (always renders as a
+// block), use this hack instead (does not always work!)
+// document.write("<style>mynoscript { display:none; }</style>");
+
+// Interactions ---------------------------------------------------------------
+
+function DoSearchKey(event, field, ver, top_path) {
+  var val = field.value;
+  if (event && event.key === 'Enter') {
+    var u = GetCookie("PLT_Root."+ver, null);
+    if (u == null) u = top_path; // default: go to the top path
+    u += "search/index.html?q=" + encodeURIComponent(val);
+    u = MergePageArgsIntoUrl(u);
+    location = u;
+    return false;
+  }
+  return true;
+}
+
+function TocviewToggle(glyph, id) {
+  var s = document.getElementById(id).style;
+  var expand = s.display == "none";
+  s.display = expand ? "block" : "none";
+  glyph.innerHTML = expand ? "&#9660;" : "&#9658;";
+}
+
+function TocsetToggle() {
+  document.body.classList.toggle("tocsetoverlay");
+}
+
+// Page Init ------------------------------------------------------------------
+
+// Note: could make a function that inspects and uses window.onload to chain to
+// a previous one, but this file needs to be required first anyway, since it
+// contains utilities for all other files.
+var on_load_funcs = [];
+function AddOnLoad(fun) { on_load_funcs.push(fun); }
+window.onload = function() {
+  for (var i=0; i<on_load_funcs.length; i++) on_load_funcs[i]();
+};
+
+AddOnLoad(function(){
+    var links = document.getElementsByTagName("a");
+    for (var i=0; i<links.length; i++) MergePageArgsIntoLink(links[i]);
+    var label = GetPageArg("ctxtname",false);
+    if (!label) return;
+    var indicator = document.getElementById("contextindicator");
+    if (!indicator) return;
+    indicator.innerHTML = label;
+    indicator.style.display = "block";
+  });
+
+// Pressing "S" or "s" focuses on the "...search manuals..." text field
+AddOnLoad(function(){
+  window.addEventListener("keyup", function(e) {
+    if ((e.key === 's' || e.key === 'S') && e.target === document.body) {
+      var searchBox = document.getElementById('searchbox');
+      if (searchBox) {
+        searchBox.focus();
+      }
+    }
+  }, false);
+});
diff --git a/clones/download.racket-lang.org/releases/8.6/doc/scribble.css b/clones/download.racket-lang.org/releases/8.6/doc/scribble.css
new file mode 100644
index 00000000..c84cf840
--- /dev/null
+++ b/clones/download.racket-lang.org/releases/8.6/doc/scribble.css
@@ -0,0 +1,516 @@
+
+/* This file is used by default by all Scribble documents.
+   See also "manual.css", which is added by default by the
+   `scribble/manual` language. */
+
+/* CSS seems backward: List all the classes for which we want a
+   particular font, so that the font can be changed in one place.  (It
+   would be nicer to reference a font definition from all the places
+   that we want it.)
+
+   As you read the rest of the file, remember to double-check here to
+   see if any font is set. */
+
+/* Monospace: */
+.maincolumn, .refpara, .refelem, .tocset, .stt, .hspace, .refparaleft, .refelemleft {
+  font-family: monospace;
+}
+
+/* Serif: */
+.main, .refcontent, .tocview, .tocsub, .sroman, i {
+  font-family: serif;
+}
+
+/* Sans-serif: */
+.version, .versionNoNav, .ssansserif {
+  font-family: sans-serif;
+}
+.ssansserif {
+  font-size: 80%;
+  font-weight: bold;
+}
+
+/* Emphasis: alternate italics and normal as we nest */
+.emph {
+  font-style: italic;
+}
+.emph .emph {
+  font-style: normal;
+}
+.emph .emph .emph {
+  font-style: italic;
+}
+.emph .emph .emph .emph {
+  font-style: normal;
+}
+.emph .emph .emph .emph .emph {
+  font-style: italic;
+}
+.emph .emph .emph .emph .emph .emph {
+  font-style: normal;
+}
+
+/* ---------------------------------------- */
+
+p, .SIntrapara {
+  display: block;
+  margin: 1em 0;
+}
+
+h2 { /* per-page main title */
+  margin-top: 0;
+}
+
+h3, h4, h5, h6, h7, h8 {
+  margin-top: 1.75em;
+  margin-bottom: 0.5em;
+}
+
+.SSubSubSubSection {
+  font-weight: bold;
+  font-size: 0.83em; /* should match h5; from HTML 4 reference */
+}
+
+/* Needed for browsers like Opera, and eventually for HTML 4 conformance.
+   This means that multiple paragraphs in a table element do not have a space
+   between them. */
+table p {
+  margin-top: 0;
+  margin-bottom: 0;
+}
+
+/* ---------------------------------------- */
+/* Main */
+
+body {
+  color: black;
+  background-color: #ffffff;
+}
+
+table td {
+  padding-left: 0;
+  padding-right: 0;
+}
+
+.maincolumn {
+  width: 43em;
+  margin-right: -40em;
+  margin-left: 15em;
+}
+
+.main {
+  text-align: left;
+}
+
+/* ---------------------------------------- */
+/* Navigation */
+
+.navsettop, .navsetbottom {
+  background-color: #f0f0e0;
+  padding: 0.25em 0 0.25em 0;
+}
+
+.navsettop {
+  margin-bottom: 1.5em;
+  border-bottom: 2px solid #e0e0c0;
+}
+
+.navsetbottom {
+  margin-top: 2em;
+  border-top: 2px solid #e0e0c0;
+}
+
+.navleft {
+  margin-left: 1ex;
+  position: relative;
+  float: left;
+  white-space: nowrap;
+}
+.navright {
+  margin-right: 1ex;
+  position: relative;
+  float: right;
+  white-space: nowrap;
+}
+.nonavigation {
+  color: #e0e0e0;
+}
+
+.navleft .tocsettoggle {
+  display: none;
+}
+
+.searchform {
+  display: inline;
+  margin: 0;
+  padding: 0;
+}
+
+.nosearchform {
+  display: none;
+}
+
+.searchbox {
+  width: 16em;
+  margin: 0px;
+  padding: 0px;
+  background-color: #eee;
+  border: 1px solid #ddd;
+  vertical-align: middle;
+}
+
+.searchbox::placeholder {
+  text-align: center;
+}
+
+#contextindicator {
+  position: fixed;
+  background-color: #c6f;
+  color: #000;
+  font-family: monospace;
+  font-weight: bold;
+  padding: 2px 10px;
+  display: none;
+  right: 0;
+  bottom: 0;
+}
+
+/* ---------------------------------------- */
+/* Version */
+
+.versionbox {
+  position: relative;
+  float: right;
+  left: 2em;
+  height: 0em;
+  width: 13em;
+  margin: 0em -13em 0em 0em;
+}
+.version {
+  font-size: small;
+}
+.versionNoNav {
+  font-size: xx-small; /* avoid overlap with author */
+}
+
+.version:before, .versionNoNav:before {
+  content: "Version ";
+}
+
+/* ---------------------------------------- */
+/* Margin notes */
+
+.refpara, .refelem {
+  position: relative;
+  float: right;
+  left: 2em;
+  height: 0em;
+  width: 13em;
+  margin: 0em -13em 0em 0em;
+}
+
+.refpara, .refparaleft {
+  top: -1em;
+}
+
+.refcolumn {
+  background-color: #F5F5DC;
+  display: block;
+  position: relative;
+  width: 13em;
+  font-size: 85%;
+  border: 0.5em solid #F5F5DC;
+  margin: 0 0 0 0;
+  white-space: normal; /* in case margin note is inside code sample */
+}
+
+.refcontent {
+  margin: 0 0 0 0;
+}
+
+.refcontent p {
+  margin-top: 0;
+  margin-bottom: 0;
+}
+
+.refparaleft, .refelemleft {
+  position: relative;
+  float: left;
+  right: 2em;
+  height: 0em;
+  width: 13em;
+  margin: 0em 0em 0em -13em;
+}
+
+.refcolumnleft {
+  background-color: #F5F5DC;
+  display: block;
+  position: relative;
+  width: 13em;
+  font-size: 85%;
+  border: 0.5em solid #F5F5DC;
+  margin: 0 0 0 0;
+}
+
+
+/* ---------------------------------------- */
+/* Table of contents, inline */
+
+.toclink {
+  text-decoration: none;
+  color: blue;
+  font-size: 85%;
+}
+
+.toptoclink {
+  text-decoration: none;
+  color: blue;
+  font-weight: bold;
+}
+
+/* ---------------------------------------- */
+/* Table of contents, left margin */
+
+.tocset {
+  position: relative;
+  float: left;
+  width: 12.5em;
+  margin-right: 2em;
+}
+.tocset td {
+  vertical-align: text-top;
+}
+
+.tocview {
+  text-align: left;
+  background-color: #f0f0e0;
+}
+
+.tocsub {
+  text-align: left;
+  margin-top: 0.5em;
+  background-color: #f0f0e0;
+}
+
+.tocviewlist, .tocsublist {
+  margin-left: 0.2em;
+  margin-right: 0.2em;
+  padding-top: 0.2em;
+  padding-bottom: 0.2em;
+}
+.tocviewlist table {
+  font-size: 82%;
+}
+
+.tocviewlisttopspace {
+  margin-bottom: 1em;
+}
+
+.tocviewsublist, .tocviewsublistonly, .tocviewsublisttop, .tocviewsublistbottom {
+  margin-left: 0.4em;
+  border-left: 1px solid #bbf;
+  padding-left: 0.8em;
+}
+.tocviewsublist {
+  margin-bottom: 1em;
+}
+.tocviewsublist table,
+.tocviewsublistonly table,
+.tocviewsublisttop table,
+.tocviewsublistbottom table {
+  font-size: 75%;
+}
+
+.tocviewtitle * {
+  font-weight: bold;
+}
+
+.tocviewlink {
+  text-decoration: none;
+  color: blue;
+}
+
+.tocviewselflink {
+  text-decoration: underline;
+  color: blue;
+}
+
+.tocviewtoggle {
+  text-decoration: none;
+  color: blue;
+  font-size: 75%; /* looks better, and avoids bounce when toggling sub-sections due to font alignments */
+}
+
+.tocsublist td {
+  padding-left: 1em;
+  text-indent: -1em;
+}
+
+.tocsublinknumber {
+  font-size: 82%;
+}
+
+.tocsublink {
+  font-size: 82%;
+  text-decoration: none;
+}
+
+.tocsubseclink {
+  font-size: 82%;
+  text-decoration: none;
+}
+
+.tocsubnonseclink {
+  font-size: 82%;
+  text-decoration: none;
+  padding-left: 0.5em;
+}
+
+.tocsubtitle {
+  font-size: 82%;
+  font-style: italic;
+  margin: 0.2em;
+}
+
+/* ---------------------------------------- */
+/* Some inline styles */
+
+.indexlink {
+  text-decoration: none;
+}
+
+.nobreak {
+  white-space: nowrap;
+}
+
+pre { margin-left: 2em; }
+blockquote { margin-left: 2em; }
+
+ol          { list-style-type: decimal; }
+ol ol       { list-style-type: lower-alpha; }
+ol ol ol    { list-style-type: lower-roman; }
+ol ol ol ol { list-style-type: upper-alpha; }
+
+.SCodeFlow {
+  display: block;
+  margin-left: 1em;
+  margin-bottom: 0em;
+  margin-right: 1em;
+  margin-top: 0em;
+  white-space: nowrap;  
+}
+
+.SVInsetFlow {
+  display: block;
+  margin-left: 0em;
+  margin-bottom: 0em;
+  margin-right: 0em;
+  margin-top: 0em;
+}
+
+.SubFlow {
+  display: block;
+  margin: 0em;
+}
+
+.boxed {
+  width: 100%;
+  background-color: #E8E8FF;
+}
+
+.hspace {
+}
+
+.slant {
+  font-style: oblique;
+}
+
+.badlink {
+  text-decoration: underline;
+  color: red;
+}
+
+.plainlink {
+  text-decoration: none;
+  color: blue;
+}
+
+.techoutside       { text-decoration: underline; color: #b0b0b0; }
+.techoutside:hover { text-decoration: underline; color: blue; }
+
+/* .techinside:hover doesn't work with FF, .techinside:hover>
+   .techinside doesn't work with IE, so use both (and IE doesn't
+   work with inherit in the second one, so use blue directly) */
+.techinside                    { color: black; }
+.techinside:hover              { color: blue; }
+.techoutside:hover>.techinside { color: inherit; }
+
+.SCentered {
+  text-align: center;
+}
+
+.imageleft {
+  float: left;
+  margin-right: 0.3em;
+}
+
+.Smaller {
+  font-size: 82%;
+}
+
+.Larger {
+  font-size: 122%;
+}
+
+/* A hack, inserted to break some Scheme ids: */
+.mywbr {
+  display: inline-block;
+  height: 0;
+  width: 0;
+  font-size: 1px;
+}
+
+.compact li p {
+  margin: 0em;
+  padding: 0em;
+}
+
+.noborder img {
+  border: 0;
+}
+
+.SVerbatim {
+  white-space: nowrap;
+}
+
+.SAuthorListBox {
+  position: relative;
+  float: right;
+  left: 2em;
+  top: -2.5em;
+  height: 0em;
+  width: 13em;
+  margin: 0em -13em 0em 0em;
+}
+.SAuthorList {
+  font-size: 82%;
+}
+.SAuthorList:before {
+  content: "by ";
+}
+.author {
+  display: inline;
+  white-space: nowrap;
+}
+
+/* print styles : hide the navigation elements */
+@media print {
+  .tocset,
+  .navsettop,
+  .navsetbottom { display: none; }
+  .maincolumn {
+    width: auto;
+    margin-right: 13em;
+    margin-left: 0;
+  }
+}
diff --git a/clones/download.racket-lang.org/robots.txt b/clones/download.racket-lang.org/robots.txt
new file mode 100644
index 00000000..eb053628
--- /dev/null
+++ b/clones/download.racket-lang.org/robots.txt
@@ -0,0 +1,2 @@
+User-agent: *
+Disallow:
diff --git a/clones/llthw.common-lisp.dev/1-0-0-overview.html b/clones/llthw.common-lisp.dev/1-0-0-overview.html
new file mode 100644
index 00000000..ecdeb471
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-0-0-overview.html
@@ -0,0 +1,1863 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Grokking Lisp · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-01-00-lisp-bootcamp.html" />
+    
+    
+    <link rel="prev" href="acknowledgements.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter active" data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Grokking Lisp</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h2 id="part-one">PART ONE</h2>
+<h1 id="grokking-lisp">Grokking Lisp</h1>
+<blockquote>
+<p>&quot;&apos;Grok&apos; means to understand so thoroughly that the observer becomes a part of the process being observed&#x2014;to merge, to blend, to intermarry, to lose personal identity in group experience. It means almost everything that we mean by religion, philosophy, and science&#x2014;and it means as little to us as color means to a blind man.&quot;</p>
+<footer>Robert A. Heinlein, <em>Stranger in a Strange Land</em></footer>
+
+</blockquote>
+<p>Lisp isn&apos;t a language you just <em>learn</em>.  It changes you, as a programmer and a person.</p>
+<p>In Part One, we focus on the core of the Common Lisp language, features that you will use every day, and techniques that will change the way you see programming.</p>
+<p>We&apos;ll start with a high-level overview of the whole language, working through the details of syntax, semantics, style, and configuration of your development environment.</p>
+<p>From there we&apos;ll move on to strings, characters, writing, and printing; prompting for user input; lists, trees, and special lists like alists and plists; math, vectors and arrays; lexical scope and variables; and functions.</p>
+<p>Then we&apos;ll build our first application, a straight-forward text-adventure, using everything you&apos;ve learned up to that point; extend this knowlege to a simple web application and command-line utilities, explore more advanced features of the language, and writing domain-specific languages for even more control over syntax.</p>
+<h2 id="chapters">Chapters</h2>
+<ol>
+<li><a href="1-01-00-lisp-bootcamp.html">Common Lisp Bootcamp</a></li>
+<li><a href="1-02-00-input-output.html">Printing, Strings and Streams</a></li>
+<li><a href="1-03-0-getting-input-from-users.html">Getting Input From Users</a></li>
+<li><a href="1-04-0-lists.html">Lists and List-Operations</a></li>
+<li><a href="1-05-0-lookups-trees.html">Look-up Lists and Trees</a></li>
+<li><a href="1-06-0-math.html">Numbers and Math</a></li>
+<li><a href="1-07-0-arrays.html">Arrays and Vectors</a></li>
+<li><a href="1-08-0-variables.html">Variables, Parameters, and Constants</a></li>
+<li><a href="1-09-0-closures.html">Closures</a></li>
+<li><a href="1-10-0-functions.html">Functions and Macros</a></li>
+<li><a href="1-11-0-text-adventure.html">A Simple Text Adventure</a></li>
+<li><a href="1-12-0-namespaces.html">Namespaces, Symbols, Packages, and Systems</a></li>
+<li><a href="1-13-0-simple-web-app.html">A Simple Web Application</a></li>
+<li><a href="1-14-0-conditionals.html">Conditionals</a></li>
+<li><a href="1-15-0-command-line-utility.html">Command-Line Utilities</a></li>
+<li><a href="1-16-0-map-loop.html">Mapping and Looping</a></li>
+<li><a href="1-17-0-iterate.html">Revisiting Loops with Iterate</a></li>
+<li><a href="1-18-0-format.html">Format Strings</a></li>
+<li><a href="1-19-0-dsl.html">Domain Specific Languages</a></li>
+<li><a href="1-20-0-review.html">Part One in Review</a></li>
+</ol>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="acknowledgements.html" class="navigation navigation-prev " aria-label="Previous page: Acknowledgements">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-01-00-lisp-bootcamp.html" class="navigation navigation-next " aria-label="Next page: Common Lisp Bootcamp">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Grokking Lisp","level":"3.1","depth":1,"next":{"title":"Common Lisp Bootcamp","level":"3.1.1","depth":2,"path":"1-01-00-lisp-bootcamp.md","ref":"1-01-00-lisp-bootcamp.md","articles":[{"title":"Syntax Overview in 5 Minutes","level":"3.1.1.1","depth":3,"path":"1-01-01-syntax-overview.md","ref":"1-01-01-syntax-overview.md","articles":[]},{"title":"The REPL","level":"3.1.1.2","depth":3,"path":"1-01-02-repl.md","ref":"./1-01-02-repl.md","articles":[]},{"title":"Expressions, Parentheses, and Return Values","level":"3.1.1.3","depth":3,"path":"1-01-03-expressions.md","ref":"./1-01-03-expressions.md","articles":[]},{"title":"Lists, Cons-Cells, and Memory","level":"3.1.1.4","depth":3,"path":"1-01-04-lists-cons-cells.md","ref":"./1-01-04-lists-cons-cells.md","articles":[]},{"title":"Symbols and Namespaces","level":"3.1.1.5","depth":3,"path":"1-01-05-symbols.md","ref":"./1-01-05-symbols.md","articles":[]},{"title":"Prefix Notation","level":"3.1.1.6","depth":3,"path":"1-01-06-prefix-notation.md","ref":"./1-01-06-prefix-notation.md","articles":[]},{"title":"Common Lisp Style Guide","level":"3.1.1.7","depth":3,"path":"1-01-07-style-guide.md","ref":"./1-01-07-style-guide.md","articles":[]},{"title":"Configuring Your Development Environment","level":"3.1.1.8","depth":3,"path":"1-01-08-configuration.md","ref":"./1-01-08-configuration.md","articles":[]}]},"previous":{"title":"Acknowledgements","level":"2.5","depth":1,"path":"acknowledgements.md","ref":"acknowledgements.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-0-0-overview.md","mtime":"2022-08-22T22:13:05.967Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-01-00-lisp-bootcamp.html b/clones/llthw.common-lisp.dev/1-01-00-lisp-bootcamp.html
new file mode 100644
index 00000000..a540ae65
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-01-00-lisp-bootcamp.html
@@ -0,0 +1,1847 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Common Lisp Bootcamp · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-01-01-syntax-overview.html" />
+    
+    
+    <link rel="prev" href="1-0-0-overview.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter active" data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Common Lisp Bootcamp</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h2 id="chapter-1">Chapter 1</h2>
+<h1 id="common-lisp-bootcamp">Common Lisp Bootcamp</h1>
+<blockquote>
+<p>&quot;I made a very important discovery at Camp Currie.  Happiness consists in getting enough sleep.  Just that, nothing more.  All the wealthy, unhappy people you&apos;ve ever met take sleeping pills; Mobile Infantrymen don&apos;t need them.&quot;</p>
+<footer>Robert A. Heinlein, <em>Starship Troopers</em></footer>
+
+</blockquote>
+<p>It&apos;s time to dive head-first into Lisp, no mercy.  You&apos;ll need discipline to apply the five steps of learning the hard way, and this is where you&apos;ll get a feel for it.  But one thing you need to remember, which many programmers often forget before working themselves to burn-out, the most important thing you need to learn is to get a good night&apos;s sleep, every night, on time, so you can wake up fully refreshed to tackle Lisp again the next day.  Make yourself a schedule, a strict one, and follow it like you have a Sergeant throwing you out of your cot every morning, screaming at you all day to push yourself harder.  Eat right, take regular breaks from the computer, work hard, and sleep, and you&apos;ll find the learning process far more successful and rewarding.</p>
+<p>There is a reason, after all, the military uses this methodology for training---it&apos;s an application of the metaphor of alchemy, realized in nuclear physics: given enough heat and pressure, you can in fact turn lead into gold. But now, on to Lisp.  Here is everything you need to know to get hacking in Lisp right this second.</p>
+<ul>
+<li><a href="1-01-01-syntax-overview.html">Syntax Overview in 5 Minutes</a></li>
+<li><a href="1-01-02-repl.html">The REPL</a></li>
+<li><a href="1-01-03-expressions.html">Expressions, Parentheses, and Return Values</a></li>
+<li><a href="1-01-04-lists-cons-cells.html">Lists, Cons-Cells, and Memory</a></li>
+<li><a href="1-01-05-symbols.html">Symbols and Namespaces</a></li>
+<li><a href="1-01-06-prefix-notation.html">Prefix Notation</a></li>
+<li><a href="1-01-07-style-guide.html">Common Lisp Style Guide</a></li>
+<li><a href="1-01-08-configuration.html">Configuring Your Development Environment</a></li>
+</ul>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-0-0-overview.html" class="navigation navigation-prev " aria-label="Previous page: Grokking Lisp">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-01-01-syntax-overview.html" class="navigation navigation-next " aria-label="Next page: Syntax Overview in 5 Minutes">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Common Lisp Bootcamp","level":"3.1.1","depth":2,"next":{"title":"Syntax Overview in 5 Minutes","level":"3.1.1.1","depth":3,"path":"1-01-01-syntax-overview.md","ref":"1-01-01-syntax-overview.md","articles":[]},"previous":{"title":"Grokking Lisp","level":"3.1","depth":1,"path":"1-0-0-overview.md","ref":"1-0-0-overview.md","articles":[{"title":"Common Lisp Bootcamp","level":"3.1.1","depth":2,"path":"1-01-00-lisp-bootcamp.md","ref":"1-01-00-lisp-bootcamp.md","articles":[{"title":"Syntax Overview in 5 Minutes","level":"3.1.1.1","depth":3,"path":"1-01-01-syntax-overview.md","ref":"1-01-01-syntax-overview.md","articles":[]},{"title":"The REPL","level":"3.1.1.2","depth":3,"path":"1-01-02-repl.md","ref":"./1-01-02-repl.md","articles":[]},{"title":"Expressions, Parentheses, and Return Values","level":"3.1.1.3","depth":3,"path":"1-01-03-expressions.md","ref":"./1-01-03-expressions.md","articles":[]},{"title":"Lists, Cons-Cells, and Memory","level":"3.1.1.4","depth":3,"path":"1-01-04-lists-cons-cells.md","ref":"./1-01-04-lists-cons-cells.md","articles":[]},{"title":"Symbols and Namespaces","level":"3.1.1.5","depth":3,"path":"1-01-05-symbols.md","ref":"./1-01-05-symbols.md","articles":[]},{"title":"Prefix Notation","level":"3.1.1.6","depth":3,"path":"1-01-06-prefix-notation.md","ref":"./1-01-06-prefix-notation.md","articles":[]},{"title":"Common Lisp Style Guide","level":"3.1.1.7","depth":3,"path":"1-01-07-style-guide.md","ref":"./1-01-07-style-guide.md","articles":[]},{"title":"Configuring Your Development Environment","level":"3.1.1.8","depth":3,"path":"1-01-08-configuration.md","ref":"./1-01-08-configuration.md","articles":[]}]},{"title":"Printing, Streams, and Strings","level":"3.1.2","depth":2,"path":"1-02-00-input-output.md","ref":"1-02-00-input-output.md","articles":[{"title":"Strings","level":"3.1.2.1","depth":3,"path":"1-02-01-strings.md","ref":"./1-02-01-strings.md","articles":[]},{"title":"More Strings","level":"3.1.2.2","depth":3,"path":"1-02-02-more-strings.md","ref":"./1-02-02-more-strings.md","articles":[]},{"title":"Unicode and Strings","level":"3.1.2.3","depth":3,"path":"1-02-03-unicode.md","ref":"./1-02-03-unicode.md","articles":[]},{"title":"Characters","level":"3.1.2.4","depth":3,"path":"1-02-04-chars.md","ref":"./1-02-04-chars.md","articles":[]},{"title":"More Characters","level":"3.1.2.5","depth":3,"path":"1-02-05-more-chars.md","ref":"./1-02-05-more-chars.md","articles":[]},{"title":"Character Codes","level":"3.1.2.6","depth":3,"path":"1-02-06-char-codes.md","ref":"./1-02-06-char-codes.md","articles":[]},{"title":"Strings from Chars","level":"3.1.2.7","depth":3,"path":"1-02-07-strings-from-chars.md","ref":"./1-02-07-strings-from-chars.md","articles":[]},{"title":"Printing","level":"3.1.2.8","depth":3,"path":"1-02-08-printing.md","ref":"./1-02-08-printing.md","articles":[]},{"title":"More Printing","level":"3.1.2.9","depth":3,"path":"1-02-09-more-printing.md","ref":"./1-02-09-more-printing.md","articles":[]},{"title":"Printing With prin1","level":"3.1.2.10","depth":3,"path":"1-02-10-prin1.md","ref":"./1-02-10-prin1.md","articles":[]},{"title":"Printing With princ","level":"3.1.2.11","depth":3,"path":"1-02-11-princ.md","ref":"./1-02-11-princ.md","articles":[]},{"title":"A Brief Introduction to Format","level":"3.1.2.12","depth":3,"path":"1-02-12-format.md","ref":"./1-02-12-format.md","articles":[]},{"title":"A Little Bit More on Format","level":"3.1.2.13","depth":3,"path":"1-02-13-more-format.md","ref":"./1-02-13-more-format.md","articles":[]},{"title":"Pathnames","level":"3.1.2.14","depth":3,"path":"1-02-14-pathnames.md","ref":"./1-02-14-pathnames.md","articles":[]},{"title":"Streams","level":"3.1.2.15","depth":3,"path":"1-02-15-streams.md","ref":"./1-02-15-streams.md","articles":[]},{"title":"File Streams","level":"3.1.2.16","depth":3,"path":"1-02-16-file-streams.md","ref":"./1-02-16-file-streams.md","articles":[]},{"title":"Binary Streams","level":"3.1.2.17","depth":3,"path":"1-02-17-binary-streams.md","ref":"./1-02-17-binary-streams.md","articles":[]},{"title":"Prompting Users","level":"3.1.2.18","depth":3,"path":"1-02-18-prompting-users.md","ref":"./1-02-18-prompting-users.md","articles":[]},{"title":"Pretty-Printing","level":"3.1.2.19","depth":3,"path":"1-02-19-pretty-printing.md","ref":"./1-02-19-pretty-printing.md","articles":[]}]},{"title":"Extra Credit: Getting Input from Users","level":"3.1.3","depth":2,"path":"1-03-0-getting-input-from-users.md","ref":"./1-03-0-getting-input-from-users.md","articles":[]},{"title":"Lists and List-Operations","level":"3.1.4","depth":2,"path":"1-04-0-lists.md","ref":"./1-04-0-lists.md","articles":[]},{"title":"Extra Credit: Look-up Lists and Trees","level":"3.1.5","depth":2,"path":"1-05-0-lookups-trees.md","ref":"./1-05-0-lookups-trees.md","articles":[]},{"title":"Numbers and Math","level":"3.1.6","depth":2,"path":"1-06-0-math.md","ref":"./1-06-0-math.md","articles":[{"title":"Integers","level":"3.1.6.1","depth":3,"path":"1-06-01-integers.md","ref":"./1-06-01-integers.md","articles":[]},{"title":"More Integers","level":"3.1.6.2","depth":3,"path":"1-06-02-more-integers.md","ref":"./1-06-02-more-integers.md","articles":[]},{"title":"Hexadecimal Integer Notation","level":"3.1.6.3","depth":3,"path":"1-06-03-hexadecimal-notation.md","ref":"./1-06-03-hexadecimal-notation.md","articles":[]},{"title":"Octal Integer Notation","level":"3.1.6.4","depth":3,"path":"1-06-04-octal-notation.md","ref":"./1-06-04-octal-notation.md","articles":[]},{"title":"Binary Integer Notation","level":"3.1.6.5","depth":3,"path":"1-06-05-binary-notation.md","ref":"./1-06-05-binary-notation.md","articles":[]},{"title":"Ratios and Rational Numbers","level":"3.1.6.6","depth":3,"path":"1-06-06-ratios.md","ref":"./1-06-06-ratios.md","articles":[]},{"title":"Floating-point Numbers","level":"3.1.6.7","depth":3,"path":"1-06-07-floating-point.md","ref":"./1-06-07-floating-point.md","articles":[]},{"title":"Numeric Constants","level":"3.1.6.8","depth":3,"path":"1-06-08-constants.md","ref":"./1-06-08-constants.md","articles":[]},{"title":"Complex Numbers","level":"3.1.6.9","depth":3,"path":"1-06-09-complex-numbers.md","ref":"./1-06-09-complex-numbers.md","articles":[]},{"title":"Arithmetic","level":"3.1.6.10","depth":3,"path":"1-06-10-arithmetic.md","ref":"./1-06-10-arithmetic.md","articles":[]},{"title":"More Arithmetic","level":"3.1.6.11","depth":3,"path":"1-06-11-more-arithmetic.md","ref":"./1-06-11-more-arithmetic.md","articles":[]},{"title":"Even More Arithmetic","level":"3.1.6.12","depth":3,"path":"1-06-12-even-more-arithmetic.md","ref":"./1-06-12-even-more-arithmetic.md","articles":[]},{"title":"Exponents","level":"3.1.6.13","depth":3,"path":"1-06-13-exponents.md","ref":"./1-06-13-exponents.md","articles":[]},{"title":"Logarithms","level":"3.1.6.14","depth":3,"path":"1-06-14-logarithms.md","ref":"./1-06-14-logarithms.md","articles":[]},{"title":"Trigonometry","level":"3.1.6.15","depth":3,"path":"1-06-15-trigonometry.md","ref":"./1-06-15-trigonometry.md","articles":[]},{"title":"Pseudo-Random Numbers","level":"3.1.6.16","depth":3,"path":"1-06-16-psuedorandom-numbers.md","ref":"./1-06-16-psuedorandom-numbers.md","articles":[]}]},{"title":"Extra Credit: Arrays and Vectors","level":"3.1.7","depth":2,"path":"1-07-0-arrays.md","ref":"./1-07-0-arrays.md","articles":[]},{"title":"Variables, Parameters, and Constants","level":"3.1.8","depth":2,"path":"1-08-0-variables.md","ref":"./1-08-0-variables.md","articles":[]},{"title":"Extra Credit: Closures","level":"3.1.9","depth":2,"path":"1-09-0-closures.md","ref":"./1-09-0-closures.md","articles":[]},{"title":"Functions and Macros","level":"3.1.10","depth":2,"path":"1-10-0-functions.md","ref":"./1-10-0-functions.md","articles":[]},{"title":"Extra Credit: A Simple Text Adventure","level":"3.1.11","depth":2,"path":"1-11-0-text-adventure.md","ref":"./1-11-0-text-adventure.md","articles":[]},{"title":"Namespaces, Symbols, Packages, and Systems","level":"3.1.12","depth":2,"path":"1-12-0-namespaces.md","ref":"./1-12-0-namespaces.md","articles":[]},{"title":"Extra Credit: A Simple Web Application","level":"3.1.13","depth":2,"path":"1-13-0-simple-web-app.md","ref":"./1-13-0-simple-web-app.md","articles":[]},{"title":"Conditionals","level":"3.1.14","depth":2,"path":"1-14-0-conditionals.md","ref":"./1-14-0-conditionals.md","articles":[]},{"title":"Extra Credit: Command-Line Utilities","level":"3.1.15","depth":2,"path":"1-15-0-command-line-utility.md","ref":"./1-15-0-command-line-utility.md","articles":[]},{"title":"Mapping and Looping","level":"3.1.16","depth":2,"path":"1-16-0-map-loop.md","ref":"./1-16-0-map-loop.md","articles":[]},{"title":"Extra Credit: Revisiting Loops with Iterate","level":"3.1.17","depth":2,"path":"1-17-0-iterate.md","ref":"./1-17-0-iterate.md","articles":[]},{"title":"Format Strings","level":"3.1.18","depth":2,"path":"1-18-0-format.md","ref":"./1-18-0-format.md","articles":[]},{"title":"Extra Credit: Domain Specific Languages","level":"3.1.19","depth":2,"path":"1-19-0-dsl.md","ref":"./1-19-0-dsl.md","articles":[]},{"title":"Part One in Review","level":"3.1.20","depth":2,"path":"1-20-0-review.md","ref":"./1-20-0-review.md","articles":[]}]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-01-00-lisp-bootcamp.md","mtime":"2022-08-22T22:13:05.967Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-01-01-syntax-overview.html b/clones/llthw.common-lisp.dev/1-01-01-syntax-overview.html
new file mode 100644
index 00000000..8a82828b
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-01-01-syntax-overview.html
@@ -0,0 +1,1891 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Syntax Overview in 5 Minutes · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-01-02-repl.html" />
+    
+    
+    <link rel="prev" href="1-01-00-lisp-bootcamp.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter active" data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Syntax Overview in 5 Minutes</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-111">Exercise 1.1.1</h1>
+<h2 id="syntax-overview-in-5-minutes">Syntax Overview in 5 Minutes</h2>
+<p>What makes the Lisp family of languages so simple, expressive, and concise, is the syntax.  First of all, everything in Lisp is an <em>object</em>---and all objects are represented by <em>S-Expressions</em>.</p>
+<p>While other programming languages generally have unique syntactic forms for <em>statements</em>, which change a value in memory and return nothing, and for <em>expressions</em> which return a value, Lisp uses the S-Expression to represent all objects---all code and data, a property known as &apos;homoiconicity&apos;.  As a result, all objects in Lisp have a return value when evaluated.</p>
+<p>S-Expressions come from the Lambda Calculus, where they are formally defined to be either an <em>Atom</em> or a <em>List</em>.  In Lisp, lists of one or more elements are implemented as Cons-Cells, and atoms are thus any object which is not a cons.  Cons-Cells will be discussed more in <a href="https://llthw.common-lisp.dev/book/1-01-02-more-detail">Exercise 1.1.2</a>.</p>
+<p>Below are some examples of atoms---try them out at the REPL yourself!  And remember, type <em>exactly</em> what I&apos;ve typed (even if you think it&apos;s wrong), pressing <kbd>Enter</kbd> at the end of each line.  This tells the Lisp REPL to evaluate the expression you&apos;ve entered.</p>
+<pre><code class="lang-lisp">94
+
+&apos;a-quoted-symbol
+
+#\greek_small_letter_lamda
+
+&quot;This is a string&quot;
+
+nil
+
+&apos;()
+
+()
+
+t
+</code></pre>
+<p>As you can see, an <em>Atom</em> can be a lot of things in Lisp---numbers, symbols, character literals, strings, and even the empty list.  As you may have noticed, <code>nil</code>, <code>&apos;()</code>, and <code>()</code> all return the same thing: <code>NIL</code>.  That is because <code>nil</code> is defined as the empty list, which itself is treated atomically as it doesn&apos;t require any consing.  But there&apos;s other trickery going on behind the scenes here too---strings, for example, while treated as Atoms, are actually <em>sequences</em> of character literals; lists are also a sub-type of sequences.</p>
+<p>To really understand what&apos;s going on here, you have to remember that there&apos;s an object hierarchy---every object in Lisp descends from <code>t</code>---and again, <em>everything</em> is an object. The symbol <code>nil</code> is a special case, because it&apos;s the only member of the system class <code>null</code>. Only <code>nil</code> and its alternate representation, the empty list, represents logical falsity.  Every other object is truthy.  You don&apos;t <em>have</em> to return <code>t</code> to say that a function returns true, because any value other than <code>nil</code> is logically truthy, but it is useful when you need to return true and don&apos;t have any specific value to return.</p>
+<p>A few of the examples above have a single quote prepended to them; this is just called <em>quoting</em>, and tells Lisp not to evaluate the quoted form.  You can think of this as switching an expression from code to data.  The prepended single quote is just a short form for a full <code>quote</code> expression. Let&apos;s look at some more specific examples of quoting expressions:</p>
+<pre><code class="lang-lisp">&apos;()
+
+&apos;(this is a list of symbols)
+
+(<span class="hljs-name">quote</span> (this is another list of symbols))
+
+&apos;another-quoted-symbol
+</code></pre>
+<p>Lists in Lisp are enclosed in a pair of parentheses.  If you&apos;ve ever looked at Lisp source code before, and wondered, &quot;What&apos;s up with all these parentheses?&quot;, you now have your answer.  Each nested object inside a list is a full S-Expression too, so in a given block of code, you can easily get a lot of parentheses at the end closing off all the nested objects represented as lists.</p>
+<p>By default, as in &quot;not-quoted&quot;, lists are automatically treated as code by Lisp when evaluated. We call these lists <em>forms</em>. Let&apos;s try it out:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">+</span> <span class="hljs-number">10</span> <span class="hljs-number">20</span> (<span class="hljs-name">*</span> <span class="hljs-number">30</span> <span class="hljs-number">2</span>))
+
+(<span class="hljs-name">princ</span> <span class="hljs-string">&quot;Hello, from Lisp!&quot;</span>)
+
+(<span class="hljs-name">loop</span> for item in &apos;(this list will get printed in titlecase) do (<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;~@(~A~) &quot;</span> item))
+</code></pre>
+<p>Don&apos;t worry too much about what you&apos;re typing at the moment---just make sure you type it exactly as I&apos;ve typed it, and that it evaluates correctly.  What you should see is this:</p>
+<pre><code class="lang-lisp">* (+ 10 20 (* 30 2))
+
+90
+* (princ &quot;Hello, from Lisp!&quot;)
+Hello, from Lisp!
+&quot;Hello, from Lisp!&quot;
+* (loop for item in &apos;(this list will get printed in titlecase) do (format t &quot;~@(~A~) &quot; item))
+This List Will Get Printed In Titlecase
+NIL
+*
+</code></pre>
+<p>Take a look at what you&apos;ve typed and ponder it for a moment.  You should notice a few things right away:</p>
+<ul>
+<li>A form starts off with a function, macro, or special operator, typically represented by a symbol.</li>
+<li>The rest of the form is made up of parameters passed to that function, macro, or special operator.</li>
+<li>You can have other forms as parameters, and the innermost seem to get evaluated first; their <em>results</em> are then used as parameters to the form the next level up the hierarchy.</li>
+</ul>
+<p>This syntax is called &quot;Polish prefix-notation&quot;---the operator comes first.  In the first example, <code>(+ 10 20 (* 30 2))</code>, it&apos;s pretty clear what&apos;s happening: you pass an arbitrary set of numbers to the addition function, and you get back the sum.  In this case, you also passed the <em>return result</em> of <code>(* 30 2)</code>, which is 30 multiplied by 2.  So instead of having to write something like <code>10 + 20 + 30 * 2</code> as you would in the algebraic notation of other programming languages, you just have to type the addition symbol once, and order of operation is clear.  For a simple example like this, it may not seem like a big deal yet, but for real-world applications, it greatly simplifies your code.</p>
+<p>Typically the expression in the operator position of a form is a symbol that represents a named function; but it can also be an anonymous function, a macro, or special form.  Special forms have their own rules, and there&apos;s no means provided to define new special forms.  Macros, among other things, allow you to create custom syntax, allowing you to arbitrarily extend and change the Lisp language.  Typically, however, you will write functions, classes, and methods in your day-to-day code, which simply extend the semantics of the language.</p>
+<p>There are also <em>reader macros</em>, which let you define convenient forms for expressing, among other things, new data types.  You&apos;ve seen some reader macros already---like the short form of <code>quote</code>, represented by the single quotation mark prepending an expression to prevent it from being evaluated.</p>
+<p>From this amazingly simple syntax, you can express any program you can imagine, using any programming paradigm you choose.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-01-00-lisp-bootcamp.html" class="navigation navigation-prev " aria-label="Previous page: Common Lisp Bootcamp">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-01-02-repl.html" class="navigation navigation-next " aria-label="Next page: The REPL">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Syntax Overview in 5 Minutes","level":"3.1.1.1","depth":3,"next":{"title":"The REPL","level":"3.1.1.2","depth":3,"path":"1-01-02-repl.md","ref":"./1-01-02-repl.md","articles":[]},"previous":{"title":"Common Lisp Bootcamp","level":"3.1.1","depth":2,"path":"1-01-00-lisp-bootcamp.md","ref":"1-01-00-lisp-bootcamp.md","articles":[{"title":"Syntax Overview in 5 Minutes","level":"3.1.1.1","depth":3,"path":"1-01-01-syntax-overview.md","ref":"1-01-01-syntax-overview.md","articles":[]},{"title":"The REPL","level":"3.1.1.2","depth":3,"path":"1-01-02-repl.md","ref":"./1-01-02-repl.md","articles":[]},{"title":"Expressions, Parentheses, and Return Values","level":"3.1.1.3","depth":3,"path":"1-01-03-expressions.md","ref":"./1-01-03-expressions.md","articles":[]},{"title":"Lists, Cons-Cells, and Memory","level":"3.1.1.4","depth":3,"path":"1-01-04-lists-cons-cells.md","ref":"./1-01-04-lists-cons-cells.md","articles":[]},{"title":"Symbols and Namespaces","level":"3.1.1.5","depth":3,"path":"1-01-05-symbols.md","ref":"./1-01-05-symbols.md","articles":[]},{"title":"Prefix Notation","level":"3.1.1.6","depth":3,"path":"1-01-06-prefix-notation.md","ref":"./1-01-06-prefix-notation.md","articles":[]},{"title":"Common Lisp Style Guide","level":"3.1.1.7","depth":3,"path":"1-01-07-style-guide.md","ref":"./1-01-07-style-guide.md","articles":[]},{"title":"Configuring Your Development Environment","level":"3.1.1.8","depth":3,"path":"1-01-08-configuration.md","ref":"./1-01-08-configuration.md","articles":[]}]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-01-01-syntax-overview.md","mtime":"2022-08-22T22:13:05.971Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-01-02-repl.html b/clones/llthw.common-lisp.dev/1-01-02-repl.html
new file mode 100644
index 00000000..29eab79c
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-01-02-repl.html
@@ -0,0 +1,1854 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>The REPL · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-01-03-expressions.html" />
+    
+    
+    <link rel="prev" href="1-01-01-syntax-overview.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >The REPL</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-112">Exercise 1.1.2</h1>
+<h2 id="the-repl">The REPL</h2>
+<p>The Lisp REPL---a READ-EVAL-PRINT Loop---is the core of the interactive approach to Lisp development.  You type in an expression, the expression is <em>read</em>, <em>evaluated</em>, the return result is <em>printed</em>, and then it waits for more input.  The REPL is marked by a prompt, like the command line for your operating system, and it is the main interface to your current running Lisp image. Depending on the implementation of Lisp you are using, you may see different prompts.  You can also customize your prompt, but the means of doing so are implementation-dependent.</p>
+<p>Typically, imagining that the underscore character below is your blinking cursor, you&apos;ll see something to the effect of:</p>
+<pre><code class="lang-lisp">CL-USER&gt; _
+</code></pre>
+<p>But in SBCL, the default prompt is much less informative:</p>
+<pre><code class="lang-lisp">* _
+</code></pre>
+<p>For convenience sake, when you should enter a piece of code in the REPL for immediate evaluation, each line of code will be marked by the SBCL prompt character.  When you should enter all the code given in a file, there will be no prompt character preceding each line, and you will be provided with a file name to enter it in.</p>
+<p>Remember, you don&apos;t type in the prompt character <code>*</code> at the REPL; even if your prompt looks different, the <code>*</code> <em>represents</em> all Common Lisp REPL prompts.  For example, you&apos;ll often see code examples like this:</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">+</span> <span class="hljs-number">1</span> <span class="hljs-number">1</span>)
+
+<span class="hljs-number">2</span>
+* (<span class="hljs-name">apply</span> #&apos;+ <span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> &apos;(<span class="hljs-number">5</span> <span class="hljs-number">6</span>))
+
+<span class="hljs-number">21</span>
+</code></pre>
+<p>The example above means, you first enter the expression <code>(+ 1 1)</code> in the REPL; evaluating it returns the result <code>2</code>, exactly what you would expect to get back for 1 + 1.  Then, you get back to the prompt, and can enter the expression, <code>(apply #&apos;+ 1 2 3 4 &apos;(5 6))</code>, which returns <code>21</code>.  If you&apos;re using SBCL from the command-line, this shows a direct transcript of the session---extra line-break between the evaluated expression and return result and all.  If you are using Emacs+SLIME, you won&apos;t see that extra line-break.</p>
+<p>A lot of Lisp literature and reference works explicitly mark the return value with an ASCII-formatted fat arrow: <code>=&gt;</code>.  This can make spotting the return value of a form much easier in examples.  We will adopt this convention herein as well, when it is necessary for visual clarity.  In such a case, the examples above would then look like this:</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">+</span> <span class="hljs-number">1</span> <span class="hljs-number">1</span>)
+=&gt; <span class="hljs-number">2</span>
+* (<span class="hljs-name">apply</span> #&apos;+ <span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> &apos;(<span class="hljs-number">5</span> <span class="hljs-number">6</span>))
+=&gt; <span class="hljs-number">21</span>
+</code></pre>
+<p>In most exercises, we will separate the code examples into two copies: first, just the code you are meant to type, and then again with the correct return results for you to compare your work.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-01-01-syntax-overview.html" class="navigation navigation-prev " aria-label="Previous page: Syntax Overview in 5 Minutes">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-01-03-expressions.html" class="navigation navigation-next " aria-label="Next page: Expressions, Parentheses, and Return Values">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"The REPL","level":"3.1.1.2","depth":3,"next":{"title":"Expressions, Parentheses, and Return Values","level":"3.1.1.3","depth":3,"path":"1-01-03-expressions.md","ref":"./1-01-03-expressions.md","articles":[]},"previous":{"title":"Syntax Overview in 5 Minutes","level":"3.1.1.1","depth":3,"path":"1-01-01-syntax-overview.md","ref":"1-01-01-syntax-overview.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-01-02-repl.md","mtime":"2022-08-22T22:13:05.971Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-01-03-expressions.html b/clones/llthw.common-lisp.dev/1-01-03-expressions.html
new file mode 100644
index 00000000..2fef81b0
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-01-03-expressions.html
@@ -0,0 +1,1901 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Expressions, Parentheses, and Return Values · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-01-04-lists-cons-cells.html" />
+    
+    
+    <link rel="prev" href="1-01-02-repl.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Expressions, Parentheses, and Return Values</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-113">Exercise 1.1.3</h1>
+<h2 id="expressions-parentheses-and-return-values">Expressions, Parentheses, and Return Values</h2>
+<p>In the pedantic spirit of programming, it is worth reminding you that <em>everything</em> you type at the REPL or in your Lisp source code files will be <em>read as</em> or <em>expanded into</em> an S-Expression and evaluated if possible.  Quoting is one way you can disable evaluation for a nested S-Expression, but some S-Expressions are never evaluated.  If your Lisp implementation can&apos;t read what you&apos;ve entered as a valid S-Expression, you will normally be dropped into the debugger, the same way that it would if it tried and failed to evaluate.</p>
+<pre><code class="lang-lisp">* (+ 1 1)
+=&gt; 2 ;; as expected, because it&apos;s a valid S-Expression
+* {+ 1 1}
+;; this won&apos;t evaluate, because the Lisp reader doesn&apos;t recognize braces
+</code></pre>
+<p>Common Lisp only has S-Expressions; imperative programming languages, for example, differentiate between &apos;statements&apos; and &apos;expressions&apos;, by ruling that statements cause changes to the environment and return nothing, while expressions are used for their return values.  In the tradition of the Lisp-family of programming languages, the syntax is minimalist by design---so in Lisp, even a destructive, in-place operation is represented as an S-Expression. Destructive, in-place operations are by convention named with a prepended &quot;N&quot;, to make it obvious that they have side-effects:</p>
+<pre><code class="lang-lisp"><span class="hljs-comment">;; first lets define a couple variables</span>
+* (<span class="hljs-name">defvar</span> *test-list-a* (<span class="hljs-name">list</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>))
+* (<span class="hljs-name">defvar</span> *test-list-b* (<span class="hljs-name">list</span> &apos;d &apos;e &apos;f))
+<span class="hljs-comment">;; append returns a new list from its arguments</span>
+* (<span class="hljs-name">append</span> *test-list-a* *test-list-b*)
+=&gt; (<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> D E F)
+<span class="hljs-comment">;; you can see that the original lists haven&apos;t changed</span>
+* *test-list-a*
+=&gt; (<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>)
+* *test-list-b*
+=&gt; (<span class="hljs-name">D</span> E F)
+<span class="hljs-comment">;; but now lets do a destructive operation, NCONC (ie, in-place list concatenation)</span>
+* (<span class="hljs-name">nconc</span> *test-list-a* *test-list-b*)
+=&gt; (<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> D E F)
+<span class="hljs-comment">;; the variable&apos;s binding and assignment haven&apos;t changed, but the last cons-cell</span>
+<span class="hljs-comment">;; now points to *test-list-b* instead of terminating at NIL</span>
+* *test-list-a*
+=&gt; (<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> D E F)
+</code></pre>
+<p>Expressions, in an abstract sense, are <em>expected to</em> return a value; S-Expressions in Common Lisp almost always do, as well, but there are some exceptions. A function call, for example, is expected to return the value of the last form in its body as the value of the entire function:</p>
+<pre><code class="lang-lisp"><span class="hljs-comment">;; this is a typical anonymous function call; the last form in its body is (+ x x)</span>
+<span class="hljs-comment">;; so the function call returns (+ 2 2) =&gt; 4</span>
+* ((<span class="hljs-name">lambda</span> (<span class="hljs-name">x</span>) (<span class="hljs-name">+</span> x x)) <span class="hljs-number">2</span>)
+=&gt; <span class="hljs-number">4</span>
+<span class="hljs-comment">;; in this function, the return result of (+ x x) is not assigned so it is essentially</span>
+<span class="hljs-comment">;; lost; the function body moves on to the next form, (* x x), which is the last form</span>
+<span class="hljs-comment">;; of this function body. So the function call only returns (* 10 10) =&gt; 100</span>
+* ((<span class="hljs-name">lambda</span> (<span class="hljs-name">x</span>) (<span class="hljs-name">+</span> x x) (<span class="hljs-name">*</span> x x)) <span class="hljs-number">10</span>)
+=&gt; <span class="hljs-number">100</span>
+<span class="hljs-comment">;; in this function, we capture the return values of both (+ x x) and (* x x), as the</span>
+<span class="hljs-comment">;; lexical variables SUM and PRODUCT; using VALUES, we can return multiple values from</span>
+<span class="hljs-comment">;; a form instead of just one</span>
+* ((<span class="hljs-name">lambda</span> (<span class="hljs-name">x</span>) (<span class="hljs-name">let</span> ((<span class="hljs-name">sum</span> (<span class="hljs-name">+</span> x x)) (<span class="hljs-name">product</span> (<span class="hljs-name">*</span> x x))) (<span class="hljs-name">values</span> sum product))) <span class="hljs-number">10</span>)
+=&gt; <span class="hljs-number">20</span> <span class="hljs-number">100</span>
+<span class="hljs-comment">;; but calling VALUES without anything gives us... an expression with no return result!</span>
+* (<span class="hljs-name">values</span>)
+=&gt; <span class="hljs-comment">; No value</span>
+</code></pre>
+<p>As was introduced in the previous exercise, an S-Expression can either be an <em>Atom</em> or a <em>Cons-Cell</em>.  Cons-Cells are represented by Lists to the Reader and by the Printer---but the empty list is treated as an Atom because it requires no consing.</p>
+<p>A subset of Atoms are called <em>self-evaluating objects</em>.  Since expressions are expected to return a value, these particular objects simply return themselves.  By quoting an expression, you are effectively turning the quoted expression into a self-evaluating object.</p>
+<pre><code class="lang-lisp">;; these are some self-evaluating objects:
+;; strings---
+* &quot;a string&quot;
+;; characters---
+* #\greek_small_letter_lamda
+;; numbers
+* 42
+* #x2A
+;; bit-vectors---
+* #*1001
+</code></pre>
+<p>Note: <code>#x2A</code> looks like it returns something different, but it doesn&apos;t---the underlying integer of both the decimal representation <code>42</code> and the hexadecimal representation <code>#x2A</code> are the same number.  This can be proved with <code>(eq 42 #x2A)</code>.</p>
+<p>Lists are ordered collections of S-Expressions surrounded in a pair of parentheses, with the items separated by whitespace---the <em>amount</em> of whitespace does not matter to the Lisp reader, but there are fairly strict style conventions on how to format your code which will be detailed in the next exercise.  Again, non-empty lists are read as cons-cells, and cons-cells are printed as lists.  But lists are also a proper data type in Lisp, so it&apos;s important to remember the distinction between <em>representation</em> and the actual <em>implementation</em>.</p>
+<pre><code class="lang-lisp"><span class="hljs-comment">;; this:</span>
+&apos;(a b c)
+<span class="hljs-comment">;; is the same as this:</span>
+&apos;(a
+  b
+  c)
+<span class="hljs-comment">;; and this:</span>
+(<span class="hljs-name">list</span> &apos;a &apos;b &apos;c)
+</code></pre>
+<p>When a list is <em>evaluated</em>, it is treated as code unless it is quoted. The positions of items in the list are both syntactically and semantically meaningful when the list is evaluated as code.  These positions will be discussed below, in the section &quot;Prefix Notation.&quot;</p>
+<p>Lisp code is meant to be simple and elegant; if you find yourself staring into an impenetrable confusion of parenthesis-chaos, your code is too complex for you to manage.  Using techniques for decomposition and refactoring also presented in this book, you will learn how to write beautiful and elegant programs as well as the Common Lisp language itself.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-01-02-repl.html" class="navigation navigation-prev " aria-label="Previous page: The REPL">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-01-04-lists-cons-cells.html" class="navigation navigation-next " aria-label="Next page: Lists, Cons-Cells, and Memory">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Expressions, Parentheses, and Return Values","level":"3.1.1.3","depth":3,"next":{"title":"Lists, Cons-Cells, and Memory","level":"3.1.1.4","depth":3,"path":"1-01-04-lists-cons-cells.md","ref":"./1-01-04-lists-cons-cells.md","articles":[]},"previous":{"title":"The REPL","level":"3.1.1.2","depth":3,"path":"1-01-02-repl.md","ref":"./1-01-02-repl.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-01-03-expressions.md","mtime":"2022-08-22T22:13:05.971Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-01-04-lists-cons-cells.html b/clones/llthw.common-lisp.dev/1-01-04-lists-cons-cells.html
new file mode 100644
index 00000000..6f074ccb
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-01-04-lists-cons-cells.html
@@ -0,0 +1,1877 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Lists, Cons-Cells, and Memory · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-01-05-symbols.html" />
+    
+    
+    <link rel="prev" href="1-01-03-expressions.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Lists, Cons-Cells, and Memory</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-114">Exercise 1.1.4</h1>
+<h2 id="lists-cons-cells-and-memory">Lists, Cons-Cells, and Memory</h2>
+<p>It is significant to separate the representation and implementation of S-Expressions in your mind as you learn Lisp---since McCarthy&apos;s first paper on LISP, S-Expressions have been defined by their <em>representation</em>, but in Common Lisp, S-Expressions are defined by their <em>implementation</em> and their representation is only treated as an interface to the underlying objects.</p>
+<p>Lists are a proper type, descending from Sequences in Lisp&apos;s type hierarchy.  A list only <em>conses</em> as long as there are values to be consed. For example, consider the following:</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">list</span>)
+=&gt; NIL
+* (<span class="hljs-name">list</span> &apos;a)
+=&gt; (<span class="hljs-name">A</span>)
+* (<span class="hljs-name">list</span> &apos;a <span class="hljs-literal">nil</span>)
+=&gt; (<span class="hljs-name">A</span> NIL)
+* (<span class="hljs-name">cons</span> &apos;a <span class="hljs-literal">nil</span>)
+=&gt; (<span class="hljs-name">A</span>)
+</code></pre>
+<p>To understand what&apos;s happening in the example above, you have to understand consing, and how lists are built on top of Cons-Cells.</p>
+<pre><code class="lang-lisp"><span class="hljs-comment">;; this:</span>
+(<span class="hljs-name">list</span> &apos;a &apos;b &apos;c)
+<span class="hljs-comment">;; is the same as this:</span>
+(<span class="hljs-name">cons</span> &apos;a (<span class="hljs-name">cons</span> &apos;b (<span class="hljs-name">cons</span> &apos;c <span class="hljs-literal">nil</span>)))
+<span class="hljs-comment">;; while this:</span>
+(<span class="hljs-name">list</span> &apos;a &apos;nil)
+<span class="hljs-comment">;; is the same as this:</span>
+(<span class="hljs-name">cons</span> &apos;a (<span class="hljs-name">cons</span> <span class="hljs-literal">nil</span> <span class="hljs-literal">nil</span>))
+</code></pre>
+<p>The end of a chain of cons-cells normally terminates in <code>nil</code>, but you can have the <code>cdr</code> of a cons-cell point to a value too, and eliminate the need for an extra consing by using dot-notation:</p>
+<pre><code class="lang-lisp"><span class="hljs-comment">;; this:</span>
+&apos;(a . b)
+<span class="hljs-comment">;; is the same as this:</span>
+(<span class="hljs-name">cons</span> &apos;a &apos;b)
+</code></pre>
+<p>A list of dot-notation pairs like this is called an association list, or <code>alist</code> for short.  They are one of many structures available in Lisp for storing key/value pairs, and have a good API.</p>
+<pre><code class="lang-lisp">&apos;((a . b)
+  (c . d)
+  (e . f))
+</code></pre>
+<p>So then, just what is this &quot;Cons-Cell&quot; I keep talking about, you ask?</p>
+<p>A Cons-Cell is a pair of pointers, the <code>car</code> and the <code>cdr</code>---acronyms for &quot;Contents of Address Register&quot; and &quot;Contents of Decrement Register&quot;, respectively.  The <code>car</code> is usually a pointer to a value, while the <code>cdr</code> can be a pointer to the <code>car</code> of another cons-cell, a pointer to <code>NIL</code>, or in the case of a dotted-pair, another pointer to a value.</p>
+<p>Consider again the examples above. Now you can more clearly see how lists are built on top of Cons-Cell chains, and what is happening when you work with Cons-Cells directly:</p>
+<pre><code class="lang-lisp"><span class="hljs-comment">;; this creates three cons-cells, the quoted symbols &apos;A, &apos;B, and &apos;C each in the CAR of their own Cons-Cell</span>
+(<span class="hljs-name">list</span> &apos;a &apos;b &apos;c)
+<span class="hljs-comment">;; it would be the same as typing this:</span>
+(<span class="hljs-name">cons</span> &apos;a (<span class="hljs-name">cons</span> &apos;b (<span class="hljs-name">cons</span> &apos;c <span class="hljs-literal">nil</span>)))
+<span class="hljs-comment">;; or this:</span>
+&apos;(a . (b . (c . <span class="hljs-literal">nil</span>)))
+<span class="hljs-comment">;; or this:</span>
+&apos;(a b c . nil)
+<span class="hljs-comment">;; or simply this:</span>
+&apos;(a b c)
+</code></pre>
+<p>A common focal-point of Lisp source code optimization centers on minimizing the number of conses performed by your application.  Note how a dotted-pair only conses once, while a two item list that contains the same information conses twice; so by using an <code>alist</code> instead of other list-based data structures such as <code>plists</code>, you are already eliminating half the memory and processing requirements.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-01-03-expressions.html" class="navigation navigation-prev " aria-label="Previous page: Expressions, Parentheses, and Return Values">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-01-05-symbols.html" class="navigation navigation-next " aria-label="Next page: Symbols and Namespaces">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Lists, Cons-Cells, and Memory","level":"3.1.1.4","depth":3,"next":{"title":"Symbols and Namespaces","level":"3.1.1.5","depth":3,"path":"1-01-05-symbols.md","ref":"./1-01-05-symbols.md","articles":[]},"previous":{"title":"Expressions, Parentheses, and Return Values","level":"3.1.1.3","depth":3,"path":"1-01-03-expressions.md","ref":"./1-01-03-expressions.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-01-04-lists-cons-cells.md","mtime":"2022-08-22T22:13:05.971Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-01-05-symbols.html b/clones/llthw.common-lisp.dev/1-01-05-symbols.html
new file mode 100644
index 00000000..193634b7
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-01-05-symbols.html
@@ -0,0 +1,1896 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Symbols and Namespaces · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-01-06-prefix-notation.html" />
+    
+    
+    <link rel="prev" href="1-01-04-lists-cons-cells.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Symbols and Namespaces</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-115">Exercise 1.1.5</h1>
+<h2 id="symbols-and-namespaces">Symbols and Namespaces</h2>
+<p>Common Lisp is often referred to as a LISP<sub>2</sub>---that is, it has separate namespaces for Functions and Variables in any given environment.  In principle, this means that you can bind and assign both a function and a variable to the symbol <code>foo</code>, evaluate <code>(foo foo)</code>, and Lisp can distinguish between them automatically by their position in a form. You can also explicitly refer to the function definition in an argument position with the reader macro <code>#&apos;</code>, such as in <code>(apply #&apos;foo foo)</code>.  In practice, however, this is considered bad form.  Consider the example:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">defvar</span> foo <span class="hljs-number">1</span>)
+
+(<span class="hljs-name">defun</span> foo (<span class="hljs-name">foo</span>)
+  (<span class="hljs-name">+</span> foo foo))
+
+(<span class="hljs-name">foo</span> foo)
+=&gt; <span class="hljs-number">2</span>
+</code></pre>
+<p>There are actually three separate bindings of the symbol <code>foo</code> in the above example.  First, there is the global variable <code>foo</code> bound and assigned with <code>defvar</code> to the value of <code>1</code>.  There is the function definition of <code>foo</code>, and it has a parameter named <code>foo</code> as well.  In the body of <code>foo</code> the function, it is its parameter being added to itself; so when the function <code>foo</code> is applied to the global variable <code>foo</code>, you get <code>(+ 1 1) =&gt; 2</code>.</p>
+<p>This is because in addition to having separate namespaces for Functions and Variables, Common Lisp is also both <em>dynamically</em> and <em>lexically</em> scoped. Dynamic scoping is special and explicit in Common Lisp; lexical scoping is more intuitive and implicit---in other words, you have to specifically declare a symbol to be special to use its dynamic binding from within a lexical scope where the symbol could be lexically bound and assigned as a different variable, while many forms introduce an implicit lexical scope.  For this reason there is a naming convention for top-level, dynamic variables, called &quot;earmuffs&quot;:</p>
+<pre><code class="lang-lisp"><span class="hljs-comment">;; top-level, dynamic variables can be declared with DEFVAR or DEFPARAMETER</span>
+(<span class="hljs-name">defvar</span> *my-dynamic-var* <span class="hljs-string">&quot;I&apos;m special!&quot;</span>)
+=&gt; *MY-DYNAMIC-VAR*
+<span class="hljs-comment">;; notice that the variable names are qualified with a pair of asterisks? These are called earmuffs.</span>
+(<span class="hljs-name">defparameter</span> *my-extra-special-dynamic-var* <span class="hljs-string">&quot;I&apos;m special, too!&quot;</span>)
+=&gt; *MY-EXTRA-SPECIAL-DYNAMIC-VAR*
+<span class="hljs-comment">;; one obvious way to introduce a lexical scope is with a LET form for binding and assigning lexical variables:</span>
+(<span class="hljs-name">let</span> ((<span class="hljs-name">one</span> <span class="hljs-number">1</span>)
+      (<span class="hljs-name">two</span> <span class="hljs-number">2</span>)
+      (<span class="hljs-name">three</span> <span class="hljs-number">3</span>))
+  (<span class="hljs-name">+</span> one two three))
+=&gt; <span class="hljs-number">6</span>
+<span class="hljs-comment">;; now let&apos;s put them both together</span>
+(<span class="hljs-name">defvar</span> *one* <span class="hljs-number">1</span>)
+=&gt; *ONE*
+(<span class="hljs-name">let</span> ((<span class="hljs-name">one</span> <span class="hljs-number">1.0</span>))
+  (<span class="hljs-name">+</span> one *one*))
+=&gt; <span class="hljs-number">2.0</span>
+</code></pre>
+<p>The &quot;earmuffs&quot; distinguish <em>special</em> variables from lexical.  Even though this is &quot;just a convention&quot;, it&apos;s one you should be certain to follow.  The combination of separate namespaces for functions and variables, with both dynamic and lexical scoping of symbols, is extremely powerful---but it can easily get out of hand.  Distinguishing your special dynamic variables with the earmuffs will make a big difference.</p>
+<p>Another excellent feature for taming the raw power of Common Lisp is its <em>package</em> system, which allow you to specify custom read-tables for your environment.  When you define a package, you have to explicitly import symbols you want available in the package namespace---even the symbols of the Common Lisp language itself; you can import all of a package&apos;s exported symbols into your new package at once with the <code>:use</code> keyword expression in the body of your package definition.</p>
+<p>To fully explore the package system, go ahead and create a file called <code>ex1-1-5.lisp</code>, and enter the following code:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">in-package</span> <span class="hljs-symbol">:cl-user</span>)
+
+(<span class="hljs-name">defpackage</span> #<span class="hljs-symbol">:my-new-package</span>
+  (<span class="hljs-symbol">:nicknames</span> #<span class="hljs-symbol">:newpack</span>)
+  (<span class="hljs-symbol">:use</span> <span class="hljs-symbol">:cl</span> <span class="hljs-symbol">:cl-user</span>)
+  (<span class="hljs-symbol">:export</span> #<span class="hljs-symbol">:mad-adder</span>))
+
+(<span class="hljs-name">in-package</span> <span class="hljs-symbol">:my-new-package</span>)
+
+(<span class="hljs-name">defvar</span> *my-private-var* <span class="hljs-string">&quot;I&apos;m not exported from the package&quot;</span>)
+
+(<span class="hljs-name">defun</span> mad-adder (<span class="hljs-name">n</span> <span class="hljs-symbol">&amp;rest</span> rest)
+  <span class="hljs-string">&quot;An addition function for MY-NEW-PACKAGE.&quot;</span>
+  (<span class="hljs-name">apply</span> #&apos;+ n rest))
+</code></pre>
+<p>You could then continue defining your functions, variables, classes, methods, and other code in your new package, and specifically list the symbols you want to export as the package&apos;s public interface in the package definition&apos;s <code>:export</code> keyword expression. Notice that in this package definition, we&apos;ve also given the package a nickname, <code>newpack</code>, and told it to <code>use</code> all the exported symbols from the COMMON-LISP and COMMON-LISP-USER packages in the MY-NEW-PACKAGE local read-table.</p>
+<p>Now back at the command line, navigate to the folder where you saved this file and, on Linux and OS X, run:</p>
+<pre><code class="lang-sh">$ rlwrap sbcl --load <span class="hljs-string">&quot;ex1-1-5.lisp&quot;</span>
+</code></pre>
+<p>While on Windows, run:</p>
+<pre><code class="lang-sh">$ sbcl --load <span class="hljs-string">&quot;ex1-1-5.lisp&quot;</span>
+</code></pre>
+<p>This will load and compile your source code file into the Lisp image, and as normal you will be dropped at the Lisp prompt in the <code>COMMON-LISP-USER</code> package.  If you ever need to check what package you&apos;re in, you can evaluate <code>*package*</code>.</p>
+<p>You can refer to any bound symbol in the current Lisp image by using its full name---normally, when you type in a symbol name, you don&apos;t have to type the package namespace it&apos;s in as well.  Lisp assumes that a symbol you enter exists in the current package, unless you specifically tell it otherwise.  You <em>can</em> access any symbol in a package, even if it&apos;s not exported, but generally speaking you should obey the implicit agreement you make with the developers of a library to use their package&apos;s exported interface instead of meddling with the internals.</p>
+<p>Given that you have now defined the <code>mad-adder</code> function in <code>my-new-package</code> and loaded the file, but you&apos;re working in the <code>cl-user</code> package when the REPL starts, you might think you can just call <code>mad-adder</code> directly---you&apos;d get an error in this case, however, because the <em>full name</em> of <code>mad-adder</code> is actually <code>my-new-package:mad-adder</code> not <code>common-lisp-user:mad-adder</code>.  You can use the package nickname instead, which is a convenient way to save typing and still be explicit:</p>
+<pre><code class="lang-lisp">;; this:
+(newpack:mad-adder 1)
+;; is the same as:
+(my-new-package:mad-adder 1)
+;; if a symbol isn&apos;t exported, however, you have to use two colons between the package and symbol
+newpack::*my-private-var*
+</code></pre>
+<p>There are some symbol names you can&apos;t use, however---at least not without trickery.  As a general rule, you cannot use any of the 978 external symbols in the COMMON-LISP package for either a function or a variable, even if that binding does not exist in the Common Lisp standard.  All the names of symbols exported by the COMMON-LISP package are <em>reserved</em>.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-01-04-lists-cons-cells.html" class="navigation navigation-prev " aria-label="Previous page: Lists, Cons-Cells, and Memory">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-01-06-prefix-notation.html" class="navigation navigation-next " aria-label="Next page: Prefix Notation">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Symbols and Namespaces","level":"3.1.1.5","depth":3,"next":{"title":"Prefix Notation","level":"3.1.1.6","depth":3,"path":"1-01-06-prefix-notation.md","ref":"./1-01-06-prefix-notation.md","articles":[]},"previous":{"title":"Lists, Cons-Cells, and Memory","level":"3.1.1.4","depth":3,"path":"1-01-04-lists-cons-cells.md","ref":"./1-01-04-lists-cons-cells.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-01-05-symbols.md","mtime":"2022-08-22T22:13:05.971Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-01-06-prefix-notation.html b/clones/llthw.common-lisp.dev/1-01-06-prefix-notation.html
new file mode 100644
index 00000000..967ed2d2
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-01-06-prefix-notation.html
@@ -0,0 +1,1841 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Prefix Notation · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-01-07-style-guide.html" />
+    
+    
+    <link rel="prev" href="1-01-05-symbols.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Prefix Notation</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-116">Exercise 1.1.6</h1>
+<h2 id="prefix-notation">Prefix Notation</h2>
+<p>An evaluated list expression has syntactically and semantically meaningful positions.  Remember, lists are implemented as Cons-Cells.  So the <em>car</em> of an evaluated list has to be a valid <em>operator</em>; the <em>cdr</em> of the evaluated list is itself a list of arguments to the operator called <em>parameters</em>.  In other words, the operator always comes first, and is not infixed between arguments, as would be the case in algebraic notation.  This is called &quot;Polish Prefix Notation&quot;.</p>
+<pre><code class="lang-lisp"><span class="hljs-comment">;; Polish Prefix notation, the operator comes first:</span>
+(<span class="hljs-name">operator</span> . (<span class="hljs-name">list</span> of parameters))
+</code></pre>
+<p>For example, say you want to add together a list of numbers.  Normally, you would think to write this: <code>1 + 2 + 3 + 4 + 5 = 15</code>, infixing the operators between the arguments; but in Lisp you would write:</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">+</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">5</span>)
+=&gt; <span class="hljs-number">15</span>
+</code></pre>
+<p>In Lisp, you don&apos;t have to write the addition operator, <code>+</code>, over and over between each number you wish to add together.  You are passing parameters to a function, and the function knows to collect the parameters as a set and Sum them.  That&apos;s the big conceptual difference between Lisp and other languages---when the operator comes first, you are telling the computer <em>what you want</em> instead of <em>what to do</em> and <em>how to do it</em>.  So in the example above, you are telling Lisp you want the Sum of the set of integers from 1 to 5 inclusive, <em>not</em> telling it to add 1 to 2, then add the result to 3, then add the result to 4, and then add that result to 5, to get the integer 15.  Do you see the difference?</p>
+<p>Valid operators can be a symbol representing a function, macro, or special operator; or a lambda expression representing an anonymous function. If it is a symbol, the Lisp evaluator will first check if the symbol is a special operator, and if it&apos;s not, it will look for a matching definition in the read-table for a function.  Macros are tricky---they can be expanded into normal Lisp code at various times; reader macros are expanded at read-time, while <code>defmacro</code> forms are expanded at compile time.  There are also various techniques for controlling when and where macros are to be expanded.</p>
+<p>The handling of arguments is particular to the type of operator.  While functions, for example, can only receive a single return value from any parameter expressions, special operators have their own rules.  Macros allow you to arbitrarily change the syntax and semantics of Lisp---so, obviously, the rules are defined by the macro definition form itself.  Exactly how one should apply the raw power of macros is a subject of much debate in the Lisp community.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-01-05-symbols.html" class="navigation navigation-prev " aria-label="Previous page: Symbols and Namespaces">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-01-07-style-guide.html" class="navigation navigation-next " aria-label="Next page: Common Lisp Style Guide">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Prefix Notation","level":"3.1.1.6","depth":3,"next":{"title":"Common Lisp Style Guide","level":"3.1.1.7","depth":3,"path":"1-01-07-style-guide.md","ref":"./1-01-07-style-guide.md","articles":[]},"previous":{"title":"Symbols and Namespaces","level":"3.1.1.5","depth":3,"path":"1-01-05-symbols.md","ref":"./1-01-05-symbols.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-01-06-prefix-notation.md","mtime":"2022-08-22T22:13:05.971Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-01-07-style-guide.html b/clones/llthw.common-lisp.dev/1-01-07-style-guide.html
new file mode 100644
index 00000000..86bc9d0f
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-01-07-style-guide.html
@@ -0,0 +1,2005 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Common Lisp Style Guide · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-01-08-configuration.html" />
+    
+    
+    <link rel="prev" href="1-01-06-prefix-notation.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Common Lisp Style Guide</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-117">Exercise 1.1.7</h1>
+<h2 id="common-lisp-style-guide">Common Lisp Style Guide</h2>
+<p>Style is fundamental to programming&#x2014;particularly in Lisp, where the unlimited power and flexibility of paradigm can easily go to your head.  A little carelessness can make for sloppy, illegible code; but if you make a point to consider your code as an art-form as well as a tool to get a job done, you, and anyone else who has to read your code later, will thank you for it.</p>
+<p>But don&apos;t make the mistake of thinking these rules are prescriptive; and not everyone in the Lisp community agrees with them.  Consider them more like practical suggestions which will get you thinking about style, and then you and your team can decide together which style rules you want to follow for your coding aesthetic.</p>
+<p>At this stage of learning Lisp, you may not fully appreciate all the style rules given here, or understand everything being discussed.  And that&apos;s okay.  Take a deep breath, and familiarize yourself with these points to the best of your ability, and then treat this chapter like a reference; it will mean more and more after each chapter of this book you work through, and will be something you can keep referring to with each Lisp project.</p>
+<h3 id="symbols-and-naming">Symbols and Naming</h3>
+<p>Clear and meaningful symbol-names in your Lisp programs are one of the most important aspects of code readability.</p>
+<p>While there are no hard-fast rules for naming symbols in the Common Lisp standard, beyond a list of which characters are allowed, certain conventions have arisen in the Lisp community which you should know, and usually follow religiously.  There are times when you can, and may have to, break convention, but those are special cases which require experience and finesse.</p>
+<p>Symbol names should be descriptive, short, typed in all lowercase, with words separated by a single hyphen:</p>
+<pre><code class="lang-lisp">(defun my-addition-function (&amp;rest rest)
+  (apply #&apos;+ rest))
+=&gt; MY-ADDITION-FUNCTION
+
+(deftype my-integer-type ()
+  &apos;(and integer
+        (satisfies plusp)))
+=&gt; MY-INTEGER-TYPE
+
+(defvar my-hash-table (make-hash-table :test &apos;equal))
+=&gt; MY-HASH-TABLE
+
+(defvar my-alist &apos;((&quot;one&quot; . 1)
+                   (&quot;two&quot; . 2)
+                   (&quot;three&quot; . 3)))
+=&gt; MY-ALIST
+
+;; Note that symbol names created from strings should be in all-caps:
+(intern &quot;MY-NEW-INTERNED-SYMBOL&quot;)
+=&gt; MY-NEW-INTERNED-SYMBOL
+   NIL
+;; or you&apos;ll have to reference it in surrounding hbars as a literal, case-sensitive symbol:
+(intern &quot;my-funky-interned-symbol&quot;)
+=&gt; |my-funky-interned-symbol|
+   NIL
+</code></pre>
+<p>Note that a pair of hbars is <em>syntactic</em>, not stylistic.  It allows you, among other things, to define case-sensitive symbols; but it is generally only used for foreign-function interfaces.</p>
+<p>Global variables, <em>i.e.</em>, variables declared as top-level forms with <code>defvar</code> or <code>defparameter</code>, are named using &quot;earmuffs&quot; because they are dynamic and special, such as the following built into Common Lisp:</p>
+<pre><code class="lang-lisp">*package*
+=&gt; #&lt;PACKAGE <span class="hljs-string">&quot;COMMON-LISP-USER&quot;</span>&gt;
+*print-base*
+=&gt; <span class="hljs-number">10</span>
+</code></pre>
+<p>In the case of earmuffs, these <em>are</em> stylistic.  They are not parsed as syntactic tokens by the Lisp reader, they are simply read as part of the symbol name.</p>
+<p>Another stylistic convention for symbol names uses a pair of plus-signs to wrap symbol-names of <em>constants</em>:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">defconstant</span> +my-new-constant+ <span class="hljs-number">1.0</span>)
+</code></pre>
+<p>Package internal symbols are sometimes named with a prepended percent-sign, and not exported with the package API.  These are similar in purpose to private functions, methods, and variables in other programming languages---only they can always be accessed by using the full symbol name:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">defpackage</span> #<span class="hljs-symbol">:my-new-package</span>
+  (<span class="hljs-symbol">:use</span> <span class="hljs-symbol">:cl</span>)
+  (<span class="hljs-symbol">:export</span> #<span class="hljs-symbol">:mad-adder</span>))
+
+(<span class="hljs-name">in-package</span> <span class="hljs-symbol">:my-new-package</span>)
+
+<span class="hljs-comment">;; Do some wonky stuff with a package-internal function</span>
+(<span class="hljs-name">defun</span> %madder (<span class="hljs-name">x</span>)
+  (<span class="hljs-name">declare</span> (<span class="hljs-name">integer</span> x))
+  (<span class="hljs-name">apply</span> #&apos;+ (<span class="hljs-name">loop</span> for i from <span class="hljs-number">1</span> upto x
+                   collect (<span class="hljs-name">*</span> x i))))
+
+<span class="hljs-comment">;; Write an exported interface to your package internal function</span>
+(<span class="hljs-name">defun</span> mad-adder (<span class="hljs-name">x</span>)
+  <span class="hljs-string">&quot;Call %MADDER with integer argument X.&quot;</span>
+  (%madder x))
+
+(<span class="hljs-name">in-package</span> <span class="hljs-symbol">:cl-user</span>)
+
+(<span class="hljs-name">my-new-package</span><span class="hljs-symbol">:mad-adder</span> <span class="hljs-number">10</span>)
+
+(<span class="hljs-name">my-new-package</span>::%madder <span class="hljs-number">10</span>)
+</code></pre>
+<p>Predicate functions, <em>i.e.</em>, boolean tests, typically end with a suffixed &quot;p&quot;.  If it is a multi-word symbol already separated by dashes, you append the suffix as &quot;-p&quot; (dash-p); while if it is a single word or mnemonic symbol name, the &quot;p&quot; can be appended without a dash.</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">bit-vector-p</span> #*01010001)
+=&gt; T
+(<span class="hljs-name">integerp</span> <span class="hljs-number">10</span>)
+=&gt; T
+</code></pre>
+<h3 id="parentheses-indentation-and-whitespace">Parentheses, Indentation, and Whitespace</h3>
+<p>Parentheses should all close on the same line, when ending multiple forms; while balancing parentheses on separate lines from your code, to demarcate a code block, is common practice in other languages, it is not the case in Common Lisp.  If you are having trouble matching the parentheses in your head, use a source-code editor which highlights matching opening or closing parens.  And since in Lisp, all non-atomic forms are lists, and wrapped in a pair of parentheses, it is also worthwhile to use tools to find unmatched parens.</p>
+<pre><code class="lang-lisp"><span class="hljs-comment">;; bad style</span>
+(<span class="hljs-name">defun</span> a-badly-formatted-function (<span class="hljs-name">x</span> y z)
+  (<span class="hljs-name">progn</span>
+    (<span class="hljs-name">setq</span> x (<span class="hljs-name">+</span> x x))
+    (<span class="hljs-name">setq</span> y (<span class="hljs-name">*</span> y y))
+    (<span class="hljs-name">mod</span>
+      (<span class="hljs-name">+</span> z z)
+      (<span class="hljs-name">+</span> x y)
+      )
+    )
+  )
+
+<span class="hljs-comment">;; the right way</span>
+(<span class="hljs-name">defun</span> a-pretty-function (<span class="hljs-name">x</span> y z)
+  <span class="hljs-string">&quot;Function definitions need docstrings.&quot;</span>
+  (<span class="hljs-name">declare</span> (<span class="hljs-name">integer</span> x y z))
+  (<span class="hljs-name">let</span> ((<span class="hljs-name">x2</span> (<span class="hljs-name">+</span> x x))
+        (<span class="hljs-name">y2</span> (<span class="hljs-name">*</span> y y)))
+    (<span class="hljs-name">mod</span> (<span class="hljs-name">*</span> z z) (<span class="hljs-name">+</span> x2 y2))))
+</code></pre>
+<p>If you have trouble getting Lisp style right, you can always run your code through the Pretty Printer to see how Lisp thinks it should be formatted.</p>
+<p>If you use Emacs+SLIME (and many Lisp Hackers will tell you that you must), proper indentation is handled quite well; other editors, such as Sublime Text, need a plugin installed to indent Lisp code, but don&apos;t always do it right---so it&apos;s important to know how to manually indent your code.</p>
+<p>Indentation in Lisp uses the space character, not Tabs.  <em>Bodies</em> of expressions are indented by two spaces from their parent form, while paramaters and list members can be lined up into columns when they take up too many characters to fit on an ideal line of code.  For example:</p>
+<pre><code class="lang-lisp"><span class="hljs-comment">;; IF is a special operator, and doesn&apos;t have a body expression</span>
+(<span class="hljs-name">if</span> <span class="hljs-literal">t</span> <span class="hljs-literal">t</span> <span class="hljs-literal">nil</span>)
+
+<span class="hljs-comment">;; but you&apos;ll normally need to split the form for clarity; see how the three parameters line up?</span>
+(<span class="hljs-name">if</span> <span class="hljs-literal">t</span>
+    (<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;Then: True~%&quot;</span>)
+    (<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;Else: False~%&quot;</span>))
+
+<span class="hljs-comment">;; WHEN does have a body expression though, so its body isn&apos;t lined up with the test-form parameter</span>
+(<span class="hljs-name">when</span> <span class="hljs-literal">t</span>
+  (<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;This is true, too!&quot;</span>))
+</code></pre>
+<p>You only need a single space character or line-break between forms in a list.  Likewise, you only need one extra line between top-level forms.  Extraneous whitespace makes your code more difficult for others to read.</p>
+<p>You should also avoid the temptation to use the Tab character inside a form or list to force a table-like structure onto your code.  This isn&apos;t FORTRAN, it&apos;s Lisp---and Lisp should <em>flow</em>.</p>
+<pre><code class="lang-lisp"><span class="hljs-comment">;; a badly formatted class definition</span>
+(<span class="hljs-name">defclass</span> march-hare ()
+  ((<span class="hljs-name">name</span>        <span class="hljs-symbol">:type</span> string  <span class="hljs-symbol">:initarg</span> <span class="hljs-symbol">:name</span>        <span class="hljs-symbol">:initform</span> <span class="hljs-string">&quot;Haigha&quot;</span>  <span class="hljs-symbol">:accessor</span> name)
+   (<span class="hljs-name">tea-time-p</span>  <span class="hljs-symbol">:type</span> boolean <span class="hljs-symbol">:initarg</span> <span class="hljs-symbol">:tea-time-p</span>  <span class="hljs-symbol">:initform</span> <span class="hljs-literal">t</span>         <span class="hljs-symbol">:accessor</span> tea-time-p)
+   (<span class="hljs-name">tie</span>         <span class="hljs-symbol">:type</span> string  <span class="hljs-symbol">:initarg</span> <span class="hljs-symbol">:tie</span>         <span class="hljs-symbol">:initform</span> <span class="hljs-string">&quot;bow-tie&quot;</span> <span class="hljs-symbol">:accessor</span> tie)))
+
+<span class="hljs-comment">;; the right way</span>
+(<span class="hljs-name">defclass</span> march-hare ()
+  ((<span class="hljs-name">name</span> <span class="hljs-symbol">:type</span> string <span class="hljs-symbol">:initarg</span> <span class="hljs-symbol">:name</span> <span class="hljs-symbol">:initform</span> <span class="hljs-string">&quot;Haigha&quot;</span> <span class="hljs-symbol">:accessor</span> name
+         <span class="hljs-symbol">:documentation</span> <span class="hljs-string">&quot;The name of the March Hare.&quot;</span>)
+   (<span class="hljs-name">tea-time-p</span> <span class="hljs-symbol">:type</span> boolean <span class="hljs-symbol">:initarg</span> <span class="hljs-symbol">:tea-time-p</span> <span class="hljs-symbol">:initform</span> <span class="hljs-literal">t</span> <span class="hljs-symbol">:accessor</span> tea-time-p
+               <span class="hljs-symbol">:documentation</span> <span class="hljs-string">&quot;Whether or not it&apos;s tea-time.&quot;</span>)
+   (<span class="hljs-name">tie</span> <span class="hljs-symbol">:type</span> string <span class="hljs-symbol">:initarg</span> <span class="hljs-symbol">:tie</span> <span class="hljs-symbol">:initform</span> <span class="hljs-string">&quot;bow-tie&quot;</span> <span class="hljs-symbol">:accessor</span> tie
+        <span class="hljs-symbol">:documentation</span> <span class="hljs-string">&quot;The style of tie the March Hare is wearing.&quot;</span>))
+  (<span class="hljs-symbol">:documentation</span> <span class="hljs-string">&quot;&apos;The March Hare will be much the most interesting, and perhaps as this is May it won&apos;t be raving mad---at least not so mad as it was in March.&apos; -- Lewis Carroll&quot;</span>))
+</code></pre>
+<h3 id="comments-and-documentation">Comments and Documentation</h3>
+<p>You should always comment and document your code; that being said, Lisp, when written correctly, can be effectively self-documenting and self-explanatory (see &quot;Decomposition, Refactoring, and Abstraction&quot; below for more information).  Your code should be clean and readable enough that comments and documentation are technically unnecessary, but then write clean, short, and to-the-point comments and documentation strings to expand on what the code itself already says.</p>
+<p>Conventions for comments in Lisp are pretty loose, but if you read enough Lisp source-code, you&apos;ll find the following general pattern:</p>
+<pre><code class="lang-lisp"><span class="hljs-comment">;;;; four preceding semi-colons for file headers, copyright and license information</span>
+
+<span class="hljs-comment">;;; three preceding semi-colons for descriptive text</span>
+
+<span class="hljs-comment">;; two preceding semi-colons for commentary on the immediately following text</span>
+
+<span class="hljs-comment">; one preceding semi-colon for in-line comments, inside code blocks</span>
+</code></pre>
+<p>You should always include meaningful docstrings in your object definition forms---even in your global variables.  In class definition forms, you can add docstrings to each slot of the class, the class itself, and each of the generic functions and methods.  Lack of documentation, or documentation that has fallen out of sync with the codebase, is considered a bug just as much as code that does not work as expected.</p>
+<h3 id="decomposition-refactoring-and-abstraction">Decomposition, Refactoring, and Abstraction</h3>
+<p>Your Lisp code should be so clear and focused that, whenever possible, even a non-programmer can read and understand it.  This is more difficult than you might expect, as it requires careful thought and planning to achieve successfully.</p>
+<p>The general idea is to divide your code up into the smallest reusable pieces; if, for example, you were to write a new summation function, and it contained logic for sorting a list of numbers, instead of writing the logic for sorting a list in-line, inside the summation function, you could write a separate list-sorting function, and call it inside the summation function.  This offers three immediate benefits: you get a new, generally useful function almost for free; the logic of your summation function is more tightly focused on the task it was designed for; and the code becomes easier to read and maintain.  You can then improve the implementation of either function without worrying about the other.</p>
+<p>Oftentimes, as you work on software, you&apos;ll find repetitive code-patterns that become cumbersome to write, and may all need to be changed separately during maintenance, refactoring, or major upgrades.  Common Lisp, through the most-favoured Emacs+SLIME development environment, is highly interactive, so it supports incremental, functional development.  Whenever you come across redundant patterns, it is in your interest to abstract away those code patterns into a macro, which at compile-time will be transformed into the code you need at run-time.  This technique also allows you to do some pretty awesome stuff, like intelligently creating interfaces derived from a dynamic data-set; but you should get into the habit of this style of programming, because it will make your code cleaner and easier to manage over time.</p>
+<h3 id="functions-macros-and-methods">Functions, Macros, and Methods</h3>
+<p>Sometimes it can be difficult to decide when, in your software, to use a function, macro, or method and CLOS class for a specific problem.  Again, since Lisp offers so many options for choice of paradigm, you can program in any number of styles, and even mix-and-match paradigms in the same source-code file without trouble; but this rampant mix-and-matching can create unnecessary frustration for maintenance, debugging, and upgrading; so it&apos;s useful to pick a dominant paradigm and stick to it.</p>
+<p>That being said, if you want to take full advantage of Common Lisp&apos;s multi-paradigm toolset, you can do so sanely.  It is simply a matter of deciding up-front how you&apos;re going to organize your code and express your logic.</p>
+<p>A multi-paradigm approach to programming that I have found useful is straightforward, logically consistent, and in keeping with the design goals of the Common Lisp language:</p>
+<ul>
+<li>Separate application tasks into computation, transformation, and statefulness.</li>
+<li>Decompose all application logic into pure, clearly-defined functions.</li>
+<li>Use macros for monadic-style I/O in pure functional programs; object-oriented programs are designed with I/O in mind.</li>
+<li>When writing functions, program functionally.  Avoid writing functions that cause side-effects or are destructive, in-place operations; but if you have to, name them appropriately so that it is obvious.</li>
+<li>Use macros when abstracting.  The point of macros is compile-time code-transformation.  Your macros will be more generally useful when you decompose logic from them into pure functions, and use them for their intended purpose.</li>
+<li>When you need to track state, and thus cause side-effects, you should use CLOS classes and methods&#x2014;they were designed with that purpose in mind.</li>
+</ul>
+<h3 id="cross-platform-development">Cross-Platform Development</h3>
+<p>Lisp is, by nature, a cross-platform development language; but each implementation of Common Lisp contains implementation-dependent extensions, and platform-specific functionality that is unavoidable.  Generally speaking, you should make every effort to write cross-platform, cross-implementation software, so that it &quot;just works&quot; everywhere.  When a problem requires implementation or platform specific code to solve, take the extra five minutes to find out how to make it work on other platforms.  If you need to, refer to the source code of other popular cross-platform libraries, to see how they approach the problem.</p>
+<p>As an example, you can and should write software that takes advantage of 64-bit architectures; but even today, you cannot always count on it being there for your users.  Your software should scale gracefully to 32-bit architectures.  And when certain features require it, document them as such and provide an alternative.</p>
+<p>The same is true for web applications.  You can&apos;t predict which browser your users will prefer; and users resent getting a page that tells them to upgrade or change their browser.  You have no choice but to support every browser and platform&#x2014;so, think about Lisp software the same way, and you will be doing yourself and your users a favor from the beginning.</p>
+<p>Be certain to test your code on every platform you have access to, and in multiple implementations of Lisp for each platform. It may seem like a lot of extra work for nothing at first, but it will save you a lot of time down the road.</p>
+<h3 id="libraries">Libraries</h3>
+<p>As well as learning the Common Lisp language, it is important to familiarize yourself and keep up to date with the wide variety of Lisp libraries available on-line, particularly those in the Quicklisp package repository.  There are two important reasons for this:</p>
+<ul>
+<li>Instead of reinventing the wheel, you can use a feature-complete, dedicated library to implement your functionality.</li>
+<li>When you know what libraries are freely available, you can dedicate more of your time to writing and testing new code.</li>
+</ul>
+<p>Also, whenever it is both possible and reasonable, the code you write should be packaged into logical units, and distributed as open-source libraries that are loadable through Quicklisp.  Depending on the type of company you work for, however, this may be more difficult than you might expect; most software development shops like to control all IP produced by their employees, even code produced in their off-hours&#x2014;if you have a contract, be sure to check with your manager first before you release any software you write into the wild; and in the future, keep an eye out for such clauses and be certain to fight for your right to contribute to open-source software.</p>
+<p>Knowing what code to push up from a software project into a general purpose library can be tricky, but there are a few rules you can keep in mind:</p>
+<ul>
+<li>If you find yourself copy and pasting code between projects.</li>
+<li>If you abstract a common problem into a cleaner syntax.</li>
+<li>If your code solves a known problem or lack in the Lisp community, that is too general for a specific commercial software project.</li>
+</ul>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-01-06-prefix-notation.html" class="navigation navigation-prev " aria-label="Previous page: Prefix Notation">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-01-08-configuration.html" class="navigation navigation-next " aria-label="Next page: Configuring Your Development Environment">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Common Lisp Style Guide","level":"3.1.1.7","depth":3,"next":{"title":"Configuring Your Development Environment","level":"3.1.1.8","depth":3,"path":"1-01-08-configuration.md","ref":"./1-01-08-configuration.md","articles":[]},"previous":{"title":"Prefix Notation","level":"3.1.1.6","depth":3,"path":"1-01-06-prefix-notation.md","ref":"./1-01-06-prefix-notation.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-01-07-style-guide.md","mtime":"2022-08-22T22:13:05.971Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-01-08-configuration.html b/clones/llthw.common-lisp.dev/1-01-08-configuration.html
new file mode 100644
index 00000000..b97bcfe7
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-01-08-configuration.html
@@ -0,0 +1,1904 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Configuring Your Development Environment · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-02-00-input-output.html" />
+    
+    
+    <link rel="prev" href="1-01-07-style-guide.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Configuring Your Development Environment</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-118">Exercise 1.1.8</h1>
+<h2 id="configuring-your-development-environment">Configuring Your Development Environment</h2>
+<p>Now that you&apos;ve gotten yourself a feel for Common Lisp, you&apos;ll want to spend a little time configuring your development environment so that you can dive right into the code.  A lot of configuration choices are a matter of personal taste, but as long as you feel comfortable, and nothing interferes with your ability to learn and hack in Lisp, you can&apos;t really go wrong.</p>
+<h3 id="the-in-browser-repl">The In-Browser REPL</h3>
+<p>(Deprecated)</p>
+<p>You can start hacking in Lisp right away with the in-browser, javascript-powered REPL under the &quot;Try Lisp&quot; section of this site, listed in the navigation bar at the top of each page.  It takes you through a quick tour of Common Lisp so you can get your feet wet without installing anything.</p>
+<p>To continue with this book, however, you will need to install Common Lisp on your computer.  Not all the exercises in this book will run in the in-browser REPL, so make sure you get SBCL installed and working correctly before moving on to the next exercise.</p>
+<h3 id="installing-sbcl">Installing SBCL</h3>
+<p>Steel Bank Common Lisp is one of the easiest Lisp implementations to get up and running&#x2014;it has out of the box support for a wide selection of platforms, and is considered to be the most robust implementation available.  Since it automatically compiles everything you enter at the REPL, your running Lisp processes also benefit from a major speed-boost over other Lisps.</p>
+<div class="alert alert-info">
+  <p>
+    <strong>Note:</strong> the SBCL REPL is minimal by design, since it is primarily used from within Emacs+SLIME which provides its own custom prompt, history, completion, multi-line editing capabilities, and more.  In order to use it effectively straight from the command-line, you will need to install a separate tool on OS X and Linux called `rlwrap`, a readline wrapper. It provides evaluation history, multi-line editing, and can be configured for completions and filters.  You can read more about `rlwrap` here: <a href="http://utopia.knoware.nl/~hlub/uck/rlwrap/" target="_blank">utopia.knoware.nl/~hlub/uck/rlwrap/</a>.
+  </p>
+</div>
+
+<h4 id="windows">Windows</h4>
+<p>The latest SBCL installer packages for Windows, in separate versions for 32 and 64-bit systems, are available on the official downloads page.</p>
+<p>Once installed, you can run SBCL from the Start menu, or call it from a command-line window.  If you have PowerShell installed, it offers better features than the default command line.</p>
+<h4 id="os-x">OS X</h4>
+<p>On Mac OS X, you will want to install SBCL through the Homebrew package manager.</p>
+<p>You will also want to install the <code>rlwrap</code> package, and run SBCL from the terminal as follows:</p>
+<pre><code class="lang-sh">$ rlwrap sbcl
+</code></pre>
+<h4 id="linux">Linux</h4>
+<p>Most Linux distros have the latest, or a very recent, version of SBCL in their official repositories.  You can simply install it from there.</p>
+<p>You will also want to install the <code>rlwrap</code> package, and run SBCL from the shell as follows:</p>
+<pre><code class="lang-sh">$ rlwrap sbcl
+</code></pre>
+<h4 id="debianubuntu">Debian/Ubuntu</h4>
+<p>The packages for SBCL in Apt tend to be severely out-of-date, so if you&apos;re using Debian or Ubuntu, you will have a little extra work to do.</p>
+<p>First, install the version of SBCL available for your distro in Apt.</p>
+<p>Using the old version of SBCL, you may now compile the latest version of SBCL from source.</p>
+<h3 id="installing-quicklisp">Installing Quicklisp</h3>
+<p>Once you have SBCL up and running, the first thing you should do is install Quicklisp.  It&apos;s a package manager for Lisp, and will allow you to dynamically load community-supported libraries (which typically include ASDF systems and their associated Lisp packages) into your running Lisp image.  It also automatically resolves dependencies for your own Lisp projects.</p>
+<p>From the command-line:</p>
+<pre><code class="lang-sh">$ curl -O http://beta.quicklisp.org/quicklisp.lisp
+$ rlwrap sbcl --load quicklisp.lisp
+</code></pre>
+<p>You will then find yourself at the Lisp REPL, with some instructions:</p>
+<pre><code class="lang-lisp">  ==== quicklisp quickstart loaded ====
+
+    To continue, evaluate: (quicklisp-quickstart:install)
+</code></pre>
+<p>Like the instructions tell you, type that at the REPL prompt:</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">quicklisp-quickstart</span><span class="hljs-symbol">:install</span>)
+</code></pre>
+<p>Once it finishes downloading its dependencies and setting up the working folders, it will prompt you with another message confirming it was installed.  Now you will want to set it up to load automatically every time you start SBCL:</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">ql</span><span class="hljs-symbol">:add-to-init-file</span>)
+</code></pre>
+<p>This function will tell you exactly what it&apos;s doing before it changes your lisp <code>.*rc</code> file.  If you&apos;re ready, press Enter to continue when it prompts you to do so.</p>
+<p>That&apos;s it!  You can now use <code>ql:system-apropos</code> to search for libraries, and <code>ql:quickload</code> to download and install them.</p>
+<p>You can put your Lisp projects under <code>~/quicklisp/local-projects/</code> so that Quicklisp can find them automatically; then you will be able to quickload your own projects just like the libraries distributed with Quicklisp.</p>
+<h3 id="choosing-a-text-editor">Choosing a Text Editor</h3>
+<p>If you ask any Lisp developer what editor you should be using, or what IDE is available for Common Lisp, the first thing they&apos;ll tell you is, Emacs.  Emacs and SLIME (the Superior Lisp Interaction Mode for Emacs), makes a powerful combination. You can control the entire environment with your keyboard, never having to waste time reaching for the mouse; run, test, and debug code in the REPL as you write it in another buffer; experiment and explore alternate approaches to solving the same problem, profiling your code to get the best performance; and have the full Common Lisp HyperSpec at your fingertips.  The only problem is, some users really dislike Emacs, or simply don&apos;t know it.  The steep learning curve can be a real damper to your progress when coming to both Lisp and Emacs as a newbie; so the policy of this book is, use what you know, and make it work until you know Lisp well enough to get comfortable learning Emacs.  If you wait until the right time, learning Emacs will be a boost to your productivity, not a hindrance.</p>
+<div class="alert alert-info">
+    <strong>Note:</strong>
+    <p>If you want to move ahead with Emacs, detailed instructions for setting up the Emacs Live environment with support for Common Lisp are available in the next chapter, your first Extra Credit exercise.</p>
+</div>
+
+<p>If you know Emacs and have a great disdain for it, far preferring Vim, you can take advantage of most of the features of SLIME through the Vim package, Slimv.</p>
+<p>For users who have no experience with Emacs or Vim, all you really need at the moment is a simple text editor.  Anything more will probably just confuse you, and keep you from focusing on Lisp itself.  A few worth checking out are:</p>
+<ul>
+<li>Sublime Text: very well supported, extensible, and actively maintained; syntax highlighting for Lisp is built-in; a REPL plugin is available so you can get a similar experience to Emacs without as steep a learning curve.  Free to try, but requires a paid license for continued use.  It is available to download for Windows, OS X, and Linux.</li>
+<li>Atom: currently in beta, built entirely on Web technologies, GitHub&apos;s Atom Editor is like a stripped-down Sublime Text with a few unique features. A plugin for Lisp syntax highlighting is available for download within the editor settings.  Binaries are available to download for OS X and Windows 7 and 8; the source code is available to compile for other systems, although in Linux it may be available in your package manager.</li>
+<li>Cloud9: the Cloud9 service is like Sublime Text or Atom in the browser.  You can access your code from anywhere, sync it up with your repo, collaborate on code, and more.  Syntax highlighting for Lisp is built-in.  Cloud9 has both free and premium plans.  Best viewed in Chrome, Safari, and Firefox.</li>
+<li>Notepad++: A clean and simple text editor with syntax highlighting for Lisp.  Available for Windows.</li>
+</ul>
+<p>Other popular text and code editors, such as BBedit, TextWrangler, and Gedit, do not have syntax highlighting for Lisp.</p>
+<h3 id="working-from-the-command-line">Working From the Command-Line</h3>
+<p>(writing notes)</p>
+<ul>
+<li>Importance of being comfortable with the Command-Line</li>
+<li>Running and Compiling Lisp from the Command-Line</li>
+<li>Lisp shell scripts</li>
+<li>Launching the REPL</li>
+</ul>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-01-07-style-guide.html" class="navigation navigation-prev " aria-label="Previous page: Common Lisp Style Guide">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-02-00-input-output.html" class="navigation navigation-next " aria-label="Next page: Printing, Streams, and Strings">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Configuring Your Development Environment","level":"3.1.1.8","depth":3,"next":{"title":"Printing, Streams, and Strings","level":"3.1.2","depth":2,"path":"1-02-00-input-output.md","ref":"1-02-00-input-output.md","articles":[{"title":"Strings","level":"3.1.2.1","depth":3,"path":"1-02-01-strings.md","ref":"./1-02-01-strings.md","articles":[]},{"title":"More Strings","level":"3.1.2.2","depth":3,"path":"1-02-02-more-strings.md","ref":"./1-02-02-more-strings.md","articles":[]},{"title":"Unicode and Strings","level":"3.1.2.3","depth":3,"path":"1-02-03-unicode.md","ref":"./1-02-03-unicode.md","articles":[]},{"title":"Characters","level":"3.1.2.4","depth":3,"path":"1-02-04-chars.md","ref":"./1-02-04-chars.md","articles":[]},{"title":"More Characters","level":"3.1.2.5","depth":3,"path":"1-02-05-more-chars.md","ref":"./1-02-05-more-chars.md","articles":[]},{"title":"Character Codes","level":"3.1.2.6","depth":3,"path":"1-02-06-char-codes.md","ref":"./1-02-06-char-codes.md","articles":[]},{"title":"Strings from Chars","level":"3.1.2.7","depth":3,"path":"1-02-07-strings-from-chars.md","ref":"./1-02-07-strings-from-chars.md","articles":[]},{"title":"Printing","level":"3.1.2.8","depth":3,"path":"1-02-08-printing.md","ref":"./1-02-08-printing.md","articles":[]},{"title":"More Printing","level":"3.1.2.9","depth":3,"path":"1-02-09-more-printing.md","ref":"./1-02-09-more-printing.md","articles":[]},{"title":"Printing With prin1","level":"3.1.2.10","depth":3,"path":"1-02-10-prin1.md","ref":"./1-02-10-prin1.md","articles":[]},{"title":"Printing With princ","level":"3.1.2.11","depth":3,"path":"1-02-11-princ.md","ref":"./1-02-11-princ.md","articles":[]},{"title":"A Brief Introduction to Format","level":"3.1.2.12","depth":3,"path":"1-02-12-format.md","ref":"./1-02-12-format.md","articles":[]},{"title":"A Little Bit More on Format","level":"3.1.2.13","depth":3,"path":"1-02-13-more-format.md","ref":"./1-02-13-more-format.md","articles":[]},{"title":"Pathnames","level":"3.1.2.14","depth":3,"path":"1-02-14-pathnames.md","ref":"./1-02-14-pathnames.md","articles":[]},{"title":"Streams","level":"3.1.2.15","depth":3,"path":"1-02-15-streams.md","ref":"./1-02-15-streams.md","articles":[]},{"title":"File Streams","level":"3.1.2.16","depth":3,"path":"1-02-16-file-streams.md","ref":"./1-02-16-file-streams.md","articles":[]},{"title":"Binary Streams","level":"3.1.2.17","depth":3,"path":"1-02-17-binary-streams.md","ref":"./1-02-17-binary-streams.md","articles":[]},{"title":"Prompting Users","level":"3.1.2.18","depth":3,"path":"1-02-18-prompting-users.md","ref":"./1-02-18-prompting-users.md","articles":[]},{"title":"Pretty-Printing","level":"3.1.2.19","depth":3,"path":"1-02-19-pretty-printing.md","ref":"./1-02-19-pretty-printing.md","articles":[]}]},"previous":{"title":"Common Lisp Style Guide","level":"3.1.1.7","depth":3,"path":"1-01-07-style-guide.md","ref":"./1-01-07-style-guide.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-01-08-configuration.md","mtime":"2022-08-22T22:13:05.971Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-02-00-input-output.html b/clones/llthw.common-lisp.dev/1-02-00-input-output.html
new file mode 100644
index 00000000..5197244b
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-02-00-input-output.html
@@ -0,0 +1,1860 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Printing, Streams, and Strings · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-02-01-strings.html" />
+    
+    
+    <link rel="prev" href="1-01-08-configuration.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Printing, Streams, and Strings</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-12">Chapter 1.2</h1>
+<h2 id="printing-strings-and-streams">Printing, Strings, and Streams</h2>
+<blockquote>
+<p>&quot;There is no such thing as luck; there is only adequate or inadequate preparation to cope with a statistical universe.&quot;</p>
+<footer>Robert A. Heinlein, <em>Have Space Suit---Will Travel</em></footer>
+
+</blockquote>
+<p>Now that you&apos;ve got an idea of what Lisp is all about and you have your development environment configured to your liking, we can get moving on some real, practical code.</p>
+<p>At the end of the day, no matter what the program you&apos;re working on does, at some point you will have to give something back to the user.  The more interactive the program, the more data will be going back and forth between the user and your program.  And users love interactivity---they like to know just how long a set of tasks will take, they want to see updates to data in real-time, they want feedback.</p>
+<p>Since development in Lisp is so inherently interactive, it makes sense to think about your programs this way too.  So we will be starting our exploration of Common Lisp with the core language features that underlie input and output: printing, strings, and streams.</p>
+<h3 id="exercises">Exercises:</h3>
+<ul>
+<li><a href="1-02-01-strings.html">Strings</a></li>
+<li><a href="1-02-02-more-strings.html">More Strings</a></li>
+<li><a href="1-02-03-unicode.html">Unicode and Strings</a></li>
+<li><a href="1-02-04-chars.html">Characters</a></li>
+<li><a href="1-02-05-more-chars.html">More Characters</a></li>
+<li><a href="1-02-06-char-codes.html">Character Codes</a></li>
+<li><a href="1-02-07-strings-from-chars.html">Strings from Chars</a></li>
+<li><a href="1-02-08-printing.html">Printing</a></li>
+<li><a href="1-02-09-more-printing.html">More Printing</a></li>
+<li><a href="1-02-10-prin1.html">Printing With prin1</a></li>
+<li><a href="1-02-11-princ.html">Printing With princ</a></li>
+<li><a href="1-02-12-format.html">A Brief Introduction to Format</a></li>
+<li><a href="1-02-13-more-format.html">A Little Bit More on Format</a></li>
+<li><a href="1-02-14-pathnames.html">Pathnames</a></li>
+<li><a href="1-02-15-streams.html">Streams</a></li>
+<li><a href="1-02-16-file-streams.html">File Streams</a></li>
+<li><a href="1-02-17-binary-streams.html">Binary Streams</a></li>
+<li><a href="1-02-18-prompting-users.html">Prompting Users</a></li>
+<li><a href="1-02-19-pretty-printing.html">Pretty-Printing</a></li>
+</ul>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-01-08-configuration.html" class="navigation navigation-prev " aria-label="Previous page: Configuring Your Development Environment">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-02-01-strings.html" class="navigation navigation-next " aria-label="Next page: Strings">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Printing, Streams, and Strings","level":"3.1.2","depth":2,"next":{"title":"Strings","level":"3.1.2.1","depth":3,"path":"1-02-01-strings.md","ref":"./1-02-01-strings.md","articles":[]},"previous":{"title":"Configuring Your Development Environment","level":"3.1.1.8","depth":3,"path":"1-01-08-configuration.md","ref":"./1-01-08-configuration.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-02-00-input-output.md","mtime":"2022-08-22T22:23:37.778Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-02-01-strings.html b/clones/llthw.common-lisp.dev/1-02-01-strings.html
new file mode 100644
index 00000000..d10ab840
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-02-01-strings.html
@@ -0,0 +1,1846 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Strings · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-02-02-more-strings.html" />
+    
+    
+    <link rel="prev" href="1-02-00-input-output.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter active" data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Strings</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-121">Exercise 1.2.1</h1>
+<h2 id="strings">Strings</h2>
+<p>Strings are pretty important in programming; no matter what your program does, eventually you&apos;re going to need a string to send some information to the user of your program.</p>
+<p>Some programming languages have a lot of different types of strings, but Lisp only has four: the standard <code>string</code> type, as well as <code>simple-string</code>, <code>base-string</code>, and <code>simple-base-string</code> types.  The usage of these other string types is fairly specialized, so normally you will be using the <code>string</code> type itself.</p>
+<h3 id="creating-strings">Creating Strings</h3>
+<p>The simplest way to create an object of type <code>string</code> in Lisp is to simply type it at the REPL or in a <code>*.lisp</code> file, using the double-quote syntax.</p>
+<p>Try this at the REPL:</p>
+<pre><code class="lang-lisp">* <span class="hljs-string">&quot;this is a string&quot;</span>
+
+* <span class="hljs-string">&quot;this is another string&quot;</span>
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<p>When you type a string at the REPL and hit <kbd>Return</kbd> to evaluate it, Lisp treats the entire string as a single atom, even though underneath it is really a <code>specialized vector</code> of <code>character</code> objects.  If you remember, an atom is anything that is not a Cons.  String objects are also self-evaluating objects.  Thus:</p>
+<pre><code class="lang-lisp">* <span class="hljs-string">&quot;this is a string&quot;</span>
+=&gt; <span class="hljs-string">&quot;this is a string&quot;</span>
+* <span class="hljs-string">&quot;this is another string&quot;</span>
+=&gt; <span class="hljs-string">&quot;this is another string&quot;</span>
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-02-00-input-output.html" class="navigation navigation-prev " aria-label="Previous page: Printing, Streams, and Strings">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-02-02-more-strings.html" class="navigation navigation-next " aria-label="Next page: More Strings">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Strings","level":"3.1.2.1","depth":3,"next":{"title":"More Strings","level":"3.1.2.2","depth":3,"path":"1-02-02-more-strings.md","ref":"./1-02-02-more-strings.md","articles":[]},"previous":{"title":"Printing, Streams, and Strings","level":"3.1.2","depth":2,"path":"1-02-00-input-output.md","ref":"1-02-00-input-output.md","articles":[{"title":"Strings","level":"3.1.2.1","depth":3,"path":"1-02-01-strings.md","ref":"./1-02-01-strings.md","articles":[]},{"title":"More Strings","level":"3.1.2.2","depth":3,"path":"1-02-02-more-strings.md","ref":"./1-02-02-more-strings.md","articles":[]},{"title":"Unicode and Strings","level":"3.1.2.3","depth":3,"path":"1-02-03-unicode.md","ref":"./1-02-03-unicode.md","articles":[]},{"title":"Characters","level":"3.1.2.4","depth":3,"path":"1-02-04-chars.md","ref":"./1-02-04-chars.md","articles":[]},{"title":"More Characters","level":"3.1.2.5","depth":3,"path":"1-02-05-more-chars.md","ref":"./1-02-05-more-chars.md","articles":[]},{"title":"Character Codes","level":"3.1.2.6","depth":3,"path":"1-02-06-char-codes.md","ref":"./1-02-06-char-codes.md","articles":[]},{"title":"Strings from Chars","level":"3.1.2.7","depth":3,"path":"1-02-07-strings-from-chars.md","ref":"./1-02-07-strings-from-chars.md","articles":[]},{"title":"Printing","level":"3.1.2.8","depth":3,"path":"1-02-08-printing.md","ref":"./1-02-08-printing.md","articles":[]},{"title":"More Printing","level":"3.1.2.9","depth":3,"path":"1-02-09-more-printing.md","ref":"./1-02-09-more-printing.md","articles":[]},{"title":"Printing With prin1","level":"3.1.2.10","depth":3,"path":"1-02-10-prin1.md","ref":"./1-02-10-prin1.md","articles":[]},{"title":"Printing With princ","level":"3.1.2.11","depth":3,"path":"1-02-11-princ.md","ref":"./1-02-11-princ.md","articles":[]},{"title":"A Brief Introduction to Format","level":"3.1.2.12","depth":3,"path":"1-02-12-format.md","ref":"./1-02-12-format.md","articles":[]},{"title":"A Little Bit More on Format","level":"3.1.2.13","depth":3,"path":"1-02-13-more-format.md","ref":"./1-02-13-more-format.md","articles":[]},{"title":"Pathnames","level":"3.1.2.14","depth":3,"path":"1-02-14-pathnames.md","ref":"./1-02-14-pathnames.md","articles":[]},{"title":"Streams","level":"3.1.2.15","depth":3,"path":"1-02-15-streams.md","ref":"./1-02-15-streams.md","articles":[]},{"title":"File Streams","level":"3.1.2.16","depth":3,"path":"1-02-16-file-streams.md","ref":"./1-02-16-file-streams.md","articles":[]},{"title":"Binary Streams","level":"3.1.2.17","depth":3,"path":"1-02-17-binary-streams.md","ref":"./1-02-17-binary-streams.md","articles":[]},{"title":"Prompting Users","level":"3.1.2.18","depth":3,"path":"1-02-18-prompting-users.md","ref":"./1-02-18-prompting-users.md","articles":[]},{"title":"Pretty-Printing","level":"3.1.2.19","depth":3,"path":"1-02-19-pretty-printing.md","ref":"./1-02-19-pretty-printing.md","articles":[]}]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-02-01-strings.md","mtime":"2022-08-22T22:23:37.778Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-02-02-more-strings.html b/clones/llthw.common-lisp.dev/1-02-02-more-strings.html
new file mode 100644
index 00000000..adcc8df1
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-02-02-more-strings.html
@@ -0,0 +1,1845 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>More Strings · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-02-03-unicode.html" />
+    
+    
+    <link rel="prev" href="1-02-01-strings.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >More Strings</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-122">Exercise 1.2.2</h1>
+<h2 id="more-strings">More Strings</h2>
+<p>In Lisp, strings can contain any character without special markup, except for two particular characters which must be escaped; normally, what you type inside the double-quotes is exactly what you get.  Line-breaks and all.</p>
+<p>Sometimes though, you want to include double-quote characters inside your string.  Lisp has a way of doing that, using the escape-character, <code>\</code>, the Backslash.</p>
+<p>As it turns out, the backslash will escape <em>any</em> character.  So if you want to print a literal backslash, it too has to be escaped.</p>
+<pre><code class="lang-lisp">* <span class="hljs-string">&quot;this string contains \&quot;double-quotes\&quot;.&quot;</span>
+* <span class="hljs-string">&quot;and this string has an escaped backslash: \\.&quot;</span>
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* <span class="hljs-string">&quot;this string contains \&quot;double-quotes\&quot;.&quot;</span>
+
+<span class="hljs-string">&quot;this string contains \&quot;double-quotes\&quot;.&quot;</span>
+* <span class="hljs-string">&quot;and this string has an escaped backslash: \\.&quot;</span>
+
+<span class="hljs-string">&quot;and this string has an escaped backslash: \\.&quot;</span>
+</code></pre>
+<p>Once again, you get back exactly what you typed.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-02-01-strings.html" class="navigation navigation-prev " aria-label="Previous page: Strings">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-02-03-unicode.html" class="navigation navigation-next " aria-label="Next page: Unicode and Strings">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"More Strings","level":"3.1.2.2","depth":3,"next":{"title":"Unicode and Strings","level":"3.1.2.3","depth":3,"path":"1-02-03-unicode.md","ref":"./1-02-03-unicode.md","articles":[]},"previous":{"title":"Strings","level":"3.1.2.1","depth":3,"path":"1-02-01-strings.md","ref":"./1-02-01-strings.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-02-02-more-strings.md","mtime":"2022-08-22T22:23:37.778Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-02-03-unicode.html b/clones/llthw.common-lisp.dev/1-02-03-unicode.html
new file mode 100644
index 00000000..985c80ca
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-02-03-unicode.html
@@ -0,0 +1,1843 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Unicode and Strings · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-02-04-chars.html" />
+    
+    
+    <link rel="prev" href="1-02-02-more-strings.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Unicode and Strings</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-123">Exercise 1.2.3</h1>
+<h2 id="unicode-and-strings">Unicode and Strings</h2>
+<p>Generally speaking, <code>string</code> objects in Common Lisp are Unicode by default, encoded as UTF-8.  This is not a guarantee, however; it&apos;s typically just a default on most implementations of Lisp on platforms that support it.</p>
+<p>You can do a quick check to see if your implementation of Lisp supports Unicode or not.</p>
+<pre><code class="lang-lisp">* char-code-limit
+</code></pre>
+<p>If that <em>constant variable</em> returns <code>1114112</code>, then you&apos;re in luck! You have full Unicode support.  If it&apos;s less than that, you may be more limited in what you can do with strings.</p>
+<p>In SBCL, you can test specifically for Unicode support using Lisp&apos;s read-time conditionals (but this feature test is not portable):</p>
+<pre><code class="lang-lisp">* #+sb-unicode (<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~C&quot;</span> #\cuneiform_sign_an_plus_naga_opposing_an_plus_naga)
+</code></pre>
+<p>This code will only return a string of the cuneiform sign if you are using SBCL and you have Unicode support enabled; if you also want to see the cuneiform sign, and not a numbered Unicode box character, you have to install cuneiform fonts as well.</p>
+<p>On Arch Linux, the <code>ttf-akkadian</code> package is available in AUR.  For other platforms, you can find up-to-date links for Sumerian, Akkadian, Old Babylonian, and Neo-Assyrian fonts from the Wikipedia article for the <a href="http://en.wikipedia.org/wiki/Cuneiform_%28Unicode_block%29#Font_packages" target="_blank">Cuneiform (Unicode block)</a>.</p>
+<div class="alert alert-info" role="alert">
+  <strong>Note:</strong> Unless you plan on working with a lot of different character sets, you&apos;ll probably never notice the full Unicode support, when present.
+</div>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-02-02-more-strings.html" class="navigation navigation-prev " aria-label="Previous page: More Strings">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-02-04-chars.html" class="navigation navigation-next " aria-label="Next page: Characters">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Unicode and Strings","level":"3.1.2.3","depth":3,"next":{"title":"Characters","level":"3.1.2.4","depth":3,"path":"1-02-04-chars.md","ref":"./1-02-04-chars.md","articles":[]},"previous":{"title":"More Strings","level":"3.1.2.2","depth":3,"path":"1-02-02-more-strings.md","ref":"./1-02-02-more-strings.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-02-03-unicode.md","mtime":"2022-08-22T22:23:37.778Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-02-04-chars.html b/clones/llthw.common-lisp.dev/1-02-04-chars.html
new file mode 100644
index 00000000..4abd5b7a
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-02-04-chars.html
@@ -0,0 +1,1858 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Characters · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-02-05-more-chars.html" />
+    
+    
+    <link rel="prev" href="1-02-03-unicode.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Characters</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-124">Exercise 1.2.4</h1>
+<h2 id="characters">Characters</h2>
+<p>Strings are <em>specialized vectors</em> of element-type <em>character</em>, which is a fancy way to say that the type of strings in Lisp descends from sequences, and can only contain character objects in a flat, one-dimensional array.  In Lisp, these character elements are atomic, self-evaluating objects in their own right, and have a distinct syntax that is not always the same as the glyph that may be used to represent them in a string.</p>
+<p>Characters are referred to as &quot;unitary tokens&quot; in the Standard, and there are actually two kinds of character objects in Common Lisp---<em>graphic</em> characters and <em>non-graphic</em> characters.  Only the graphic character objects are associated with a glyph---all other characters are required by the ANSI Standard to have a name.  Now the <em>space</em> character has two representations that are equal, one named, and one that uses the space character---so even though it could be lumped with the other non-graphic characters, it is specifically defined as a graphic character object because it does have a glyph associated with it: the empty glyph.</p>
+<p>At the REPL, you can use the Sharpsign-Backquote syntax to refer to a literal character object. Most of the characters that you can type with your keymap set to US-English can be entered using the sharpsign-backslash followed by the character itself. Some characters also have names so that they are easier to type:</p>
+<pre><code class="lang-lisp">#\a
+#\A
+#\Space
+#\Newline
+#\Tab
+</code></pre>
+<p>In the code above, you can see both kinds of characters objects being used, graphic and non-graphic. Notice that some character names are case-sensitive. Typing <code>#\a</code> gives you the lower-case letter <em>a</em> character object, while typing <code>#\A</code> gives you the upper-case letter <em>A</em> character object, just as you would expect---but this behaviour does differ from other symbols, and even from other implementation-specific unicode character representations which we&apos;ll see in the next exercise.</p>
+<p>As it turns out, you can easily get a list of characters from a string.  Try this out:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">coerce</span> <span class="hljs-string">&quot;hello, multiverse!&quot;</span> &apos;list)
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* #\a
+#\a
+* #\A
+#\A
+* #\Space
+#\
+* #\Newline
+#\Newline
+* #\Tab
+#\Tab
+* (coerce &quot;hello, multiverse!&quot; &apos;list)
+(#\h #\e #\l #\l #\o #\, #\  #\m #\u #\l #\t #\i #\v #\e #\r #\s #\e #\!)
+</code></pre>
+<p>Did you notice that when you enter the <code>#\Space</code> character at the REPL, it returns the graphic representation of it and not the named?  That is the expected behaviour---but it&apos;s generally considered easier to identify in source code when you use the named representation.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-02-03-unicode.html" class="navigation navigation-prev " aria-label="Previous page: Unicode and Strings">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-02-05-more-chars.html" class="navigation navigation-next " aria-label="Next page: More Characters">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Characters","level":"3.1.2.4","depth":3,"next":{"title":"More Characters","level":"3.1.2.5","depth":3,"path":"1-02-05-more-chars.md","ref":"./1-02-05-more-chars.md","articles":[]},"previous":{"title":"Unicode and Strings","level":"3.1.2.3","depth":3,"path":"1-02-03-unicode.md","ref":"./1-02-03-unicode.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-02-04-chars.md","mtime":"2022-08-22T22:23:37.778Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-02-05-more-chars.html b/clones/llthw.common-lisp.dev/1-02-05-more-chars.html
new file mode 100644
index 00000000..78d890c2
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-02-05-more-chars.html
@@ -0,0 +1,1854 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>More Characters · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-02-06-char-codes.html" />
+    
+    
+    <link rel="prev" href="1-02-04-chars.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >More Characters</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-125">Exercise 1.2.5</h1>
+<h2 id="more-characters">More Characters</h2>
+<p>While not portable, and not part of the Common Lisp standard, in SBCL and a few other Lisp implementations, you can refer to any character beyond the ASCII-range using a character object with its Unicode name, simply replacing the space word-separators with underscores (<code>_</code>).  This is a little unusual for the Lisp world, since symbol names normally use the <code>-</code> (hyphen/dash) character as the word-separator; but as I said in Section 1.1.3, the Common Lisp Style Guide, that is a naming convention, which in this case isn&apos;t followed.</p>
+<p>Some of these characters you&apos;ve seen before, but lets go through a few so you get used to typing them out:</p>
+<pre><code class="lang-lisp">#\subscript_three
+#\greek_small_letter_lamda
+#\greek_capital_letter_sigma
+#\cuneiform_sign_an_plus_naga_opposing_an_plus_naga
+</code></pre>
+<p>These names are not case-sensitive: you could type <code>#\Greek_Small_Letter_Lamda</code>, <code>#\GREEK_SMALL_LETTER_LAMDA</code>, or even <code>#\gReEK_sMaLl_LeTtER_lAmDA</code>, and the Lisp reader will see it the same---for style and legibility of your code, however, you should stick with the lower-case names. You can use this syntax to enter any Unicode character into the SBCL REPL.</p>
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* #\subscript_three
+#\SUBSCRIPT_THREE
+* #\greek_small_letter_lamda
+#\GREEK_SMALL_LETTER_LAMDA
+* #\greek_capital_letter_sigma
+#\GREEK_CAPITAL_LETTER_SIGMA
+* #\cuneiform_sign_an_plus_naga_opposing_an_plus_naga
+#\CUNEIFORM_SIGN_AN_PLUS_NAGA_OPPOSING_AN_PLUS_NAGA
+</code></pre>
+<p>When you enter a character object at the REPL, it returns itself.  When you want the character&apos;s glyph, <em>i.e.</em>, what it will look like in a string, you need to put the character into a string.  This will be covered in a later exercise.</p>
+<div class="alert alert-warning">
+  <strong>Note:</strong>
+  <p>You&apos;ve probably noticed that the Greek letter lambda&apos;s name is &quot;misspelled&quot; in the example above. It&apos;s not a mistake, this is the actual character name in the Unicode standard, because the name of the letter is no longer spelled with the letter <em>beta</em> following the <em>mu</em> in modern Greek.</p>
+  <p>This is a good opportunity to remind you to type in exactly, character for character, what I have in the example code into the REPL. Did you get an error when typing the above example? Check what you typed, and make sure you typed exactly what you&apos;re supposed to.</p>
+</div>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-02-04-chars.html" class="navigation navigation-prev " aria-label="Previous page: Characters">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-02-06-char-codes.html" class="navigation navigation-next " aria-label="Next page: Character Codes">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"More Characters","level":"3.1.2.5","depth":3,"next":{"title":"Character Codes","level":"3.1.2.6","depth":3,"path":"1-02-06-char-codes.md","ref":"./1-02-06-char-codes.md","articles":[]},"previous":{"title":"Characters","level":"3.1.2.4","depth":3,"path":"1-02-04-chars.md","ref":"./1-02-04-chars.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-02-05-more-chars.md","mtime":"2022-08-22T22:23:37.778Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-02-06-char-codes.html b/clones/llthw.common-lisp.dev/1-02-06-char-codes.html
new file mode 100644
index 00000000..d7ef1fe3
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-02-06-char-codes.html
@@ -0,0 +1,1845 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Character Codes · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-02-07-strings-from-chars.html" />
+    
+    
+    <link rel="prev" href="1-02-05-more-chars.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Character Codes</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-126">Exercise 1.2.6</h1>
+<h2 id="character-codes">Character Codes</h2>
+<p>Character objects all have numeric values, called <code>codes</code>, corresponding to either the code-points in the Unicode table, or the current encoding of your running Lisp image.  Lisp comes with a lot of useful tools for working with characters and strings as numbers and vectors/arrays, and where the standard falls short, there are several popular libraries you can always rely on.</p>
+<p>You can get the code for a character object with the function <code>char-code</code>, and the character object for a code with <code>code-char</code>, as follows:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">code-char</span> <span class="hljs-number">#x61</span>)
+(<span class="hljs-name">char-code</span> #\a)
+</code></pre>
+<div class="alert alert-info">
+  See the symbol `#x61` in the example above? That&apos;s the hex-number `0x61`, which is `97` in decimal. Sometimes it&apos;s more convenient to reference integers using a different notation than decimal.  The Unicode tables are listed using hexadecimal (base-16), for instance---so you can just type the hex-number using the Sharpsign-X syntax.  There will be more discussion on numbers and notation in Chapter 1.6.
+</div>
+
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* (code-char #x61)
+#\a
+* (char-code #\a)
+97
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-02-05-more-chars.html" class="navigation navigation-prev " aria-label="Previous page: More Characters">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-02-07-strings-from-chars.html" class="navigation navigation-next " aria-label="Next page: Strings from Chars">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Character Codes","level":"3.1.2.6","depth":3,"next":{"title":"Strings from Chars","level":"3.1.2.7","depth":3,"path":"1-02-07-strings-from-chars.md","ref":"./1-02-07-strings-from-chars.md","articles":[]},"previous":{"title":"More Characters","level":"3.1.2.5","depth":3,"path":"1-02-05-more-chars.md","ref":"./1-02-05-more-chars.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-02-06-char-codes.md","mtime":"2022-08-22T22:23:37.778Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-02-07-strings-from-chars.html b/clones/llthw.common-lisp.dev/1-02-07-strings-from-chars.html
new file mode 100644
index 00000000..1463ea29
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-02-07-strings-from-chars.html
@@ -0,0 +1,1843 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Strings from Chars · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-02-08-printing.html" />
+    
+    
+    <link rel="prev" href="1-02-06-char-codes.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Strings from Chars</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-127">Exercise 1.2.7</h1>
+<h2 id="strings-from-characters">Strings From Characters</h2>
+<p>Most of the time, you&apos;ll want to work with strings instead of characters.  You can get a one-character string object directly from a character object by calling the <code>string</code> function on it:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">string</span> #\greek_small_letter_lamda)
+</code></pre>
+<p>But the <code>string</code> function only takes one argument, a character or a string, and isn&apos;t very smart.  It doesn&apos;t know how to do much in terms of type conversion.</p>
+<p>It&apos;s also easy to get a string from a list of characters.  Remember the <code>coerce</code> function introduced in exercise 1.2.4? You can change the type argument from <code>&apos;list</code> to <code>&apos;string</code>, and then the <code>coerce</code> function knows you want convert the list into a sequence of type string:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">coerce</span> &apos;(#\( #\greek_small_letter_lamda #\)) &apos;string)
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* (<span class="hljs-name">string</span> #\greek_small_letter_lamda)
+<span class="hljs-string">&quot;&#x3BB;&quot;</span>
+* (<span class="hljs-name">coerce</span> &apos;(#\( #\greek_small_letter_lamda #\)) &apos;string)
+<span class="hljs-string">&quot;(&#x3BB;)&quot;</span>
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-02-06-char-codes.html" class="navigation navigation-prev " aria-label="Previous page: Character Codes">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-02-08-printing.html" class="navigation navigation-next " aria-label="Next page: Printing">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Strings from Chars","level":"3.1.2.7","depth":3,"next":{"title":"Printing","level":"3.1.2.8","depth":3,"path":"1-02-08-printing.md","ref":"./1-02-08-printing.md","articles":[]},"previous":{"title":"Character Codes","level":"3.1.2.6","depth":3,"path":"1-02-06-char-codes.md","ref":"./1-02-06-char-codes.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-02-07-strings-from-chars.md","mtime":"2022-08-22T22:23:37.782Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-02-08-printing.html b/clones/llthw.common-lisp.dev/1-02-08-printing.html
new file mode 100644
index 00000000..d3edd759
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-02-08-printing.html
@@ -0,0 +1,1869 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Printing · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-02-09-more-printing.html" />
+    
+    
+    <link rel="prev" href="1-02-07-strings-from-chars.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Printing</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-128">Exercise 1.2.8</h1>
+<h2 id="printing">Printing</h2>
+<p>There are a lot of ways for a programmer to handle printing with Lisp, and all of them are built on top of the <code>write</code> function.  You will rarely need to use <code>write</code> directly, but it is useful to know about in order to understand all the different ways you can print objects in Lisp, and where to print them to.</p>
+<p>Since the <code>write</code> function is extremely powerful and general, it takes a <em>lot</em> of parameters.  Most of them are <em>keyword parameters</em>, however, so you can call the function without knowing or using all of them, and trust that the standard has implemented sensible defaults for your use-case.</p>
+<p>The simplest use of <code>write</code> is to call it with only one argument, what you want printed, according to the system defaults for printing that type of object:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">write</span> <span class="hljs-string">&quot;hello&quot;</span>)
+(<span class="hljs-name">write</span> <span class="hljs-number">10</span>)
+(<span class="hljs-name">write</span> &apos;hello)
+</code></pre>
+<p>But lets say you want to know how an integer is printed in hexadecimal, octets, or binary.  You can set the <code>:base</code> and <code>:radix</code> parameters to change the default behavior:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">write</span> <span class="hljs-number">10000</span> <span class="hljs-symbol">:base</span> <span class="hljs-number">16</span> <span class="hljs-symbol">:radix</span> <span class="hljs-literal">t</span>)
+(<span class="hljs-name">write</span> <span class="hljs-number">10000</span> <span class="hljs-symbol">:base</span> <span class="hljs-number">8</span> <span class="hljs-symbol">:radix</span> <span class="hljs-literal">t</span>)
+(<span class="hljs-name">write</span> <span class="hljs-number">10000</span> <span class="hljs-symbol">:base</span> <span class="hljs-number">2</span> <span class="hljs-symbol">:radix</span> <span class="hljs-literal">t</span>)
+</code></pre>
+<div class="alert alert-info">
+  The `:radix` keyword parameter is a generalized boolean.  This means that any &quot;non-NIL&quot; value you pass to it will be read the same as &quot;True&quot;, even if you don&apos;t supply `t` itself.  The only time it will be treated as &quot;False&quot; is when you specifically pass it `NIL`.
+</div>
+
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* (<span class="hljs-name">write</span> <span class="hljs-string">&quot;hello&quot;</span>)
+<span class="hljs-string">&quot;hello&quot;</span>
+<span class="hljs-string">&quot;hello&quot;</span>
+* (<span class="hljs-name">write</span> <span class="hljs-number">10</span>)
+<span class="hljs-number">10</span>
+<span class="hljs-number">10</span>
+* (<span class="hljs-name">write</span> &apos;hello)
+HELLO
+HELLO
+* (<span class="hljs-name">write</span> <span class="hljs-number">10000</span> <span class="hljs-symbol">:base</span> <span class="hljs-number">16</span> <span class="hljs-symbol">:radix</span> <span class="hljs-literal">t</span>)
+<span class="hljs-number">#x2710</span>
+<span class="hljs-number">10000</span>
+* (<span class="hljs-name">write</span> <span class="hljs-number">10000</span> <span class="hljs-symbol">:base</span> <span class="hljs-number">8</span> <span class="hljs-symbol">:radix</span> <span class="hljs-literal">t</span>)
+<span class="hljs-number">#o23420</span>
+<span class="hljs-number">10000</span>
+* (<span class="hljs-name">write</span> <span class="hljs-number">10000</span> <span class="hljs-symbol">:base</span> <span class="hljs-number">2</span> <span class="hljs-symbol">:radix</span> <span class="hljs-literal">t</span>)
+<span class="hljs-number">#b10011100010000</span>
+<span class="hljs-number">10000</span>
+</code></pre>
+<p>Do you understand everything that&apos;s happening here?  Take a moment to review what you&apos;ve typed, and what you&apos;ve gotten back at the REPL.</p>
+<p>With the first three examples, you probably noticed that you&apos;re getting back the same value twice.  This is because the default <code>:stream</code> is <code>*standard-output*</code>, which is the same place function return values are being sent while you&apos;re working in the REPL.  You&apos;re also printing the objects with all their default settings, as Lisp would normally print them for you.  You won&apos;t normally see this exact behavior outside the REPL though---in upcoming exercises, you&apos;ll learn more about streams and what you can do with them, and what happens to values when they&apos;re not sent to a stream or bound to a variable.</p>
+<p>But notice how changing the defaults in the last three examples changed the way <code>write</code> <em>printed</em> the arguments, but didn&apos;t change the actual return value in any way (<em>i.e.,</em> the integer 10,000)?  This is how <code>write</code> works.  First it prints the <em>object</em> parameter you pass it, according to any changes you&apos;ve made to the instructions for the Lisp Printer using <code>write</code>&apos;s keyword parameters, and then when it&apos;s done it <em>returns</em> the original object as well.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-02-07-strings-from-chars.html" class="navigation navigation-prev " aria-label="Previous page: Strings from Chars">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-02-09-more-printing.html" class="navigation navigation-next " aria-label="Next page: More Printing">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Printing","level":"3.1.2.8","depth":3,"next":{"title":"More Printing","level":"3.1.2.9","depth":3,"path":"1-02-09-more-printing.md","ref":"./1-02-09-more-printing.md","articles":[]},"previous":{"title":"Strings from Chars","level":"3.1.2.7","depth":3,"path":"1-02-07-strings-from-chars.md","ref":"./1-02-07-strings-from-chars.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-02-08-printing.md","mtime":"2022-08-22T22:23:37.782Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-02-09-more-printing.html b/clones/llthw.common-lisp.dev/1-02-09-more-printing.html
new file mode 100644
index 00000000..7a155bac
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-02-09-more-printing.html
@@ -0,0 +1,1869 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>More Printing · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-02-10-prin1.html" />
+    
+    
+    <link rel="prev" href="1-02-08-printing.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >More Printing</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-129">Exercise 1.2.9</h1>
+<h2 id="more-printing">More Printing</h2>
+<p>As I said in the previous exercise, Common Lisp has a lot of functions for printing, including one named <code>print</code>, which you&apos;ll see here in this exercise.  I&apos;ll also show you how the same functionality can be implemented with <code>write</code>, so you can get a feel for specializing a very general interface---a common development pattern in Common Lisp.</p>
+<p><code>print</code> works exactly as you would expect a print function to work.  You pass it an object to print and a stream to print it to. It prints the object between a new-line character and a space---note: <code>print</code> prints the object <em>readably</em>, in other words, in a format suitable to be read by the Lisp reader, escaping special characters.</p>
+<p>Let&apos;s see it in action, along with an equivalent version using <code>write</code>:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">print</span> <span class="hljs-string">&quot;hello, multiverse!&quot;</span>)
+(<span class="hljs-name">print</span> <span class="hljs-string">&quot;hello again, multiverse!&quot;</span> <span class="hljs-literal">t</span>)
+(<span class="hljs-name">print</span> <span class="hljs-string">&quot;hello, multiverse, are you there?&quot;</span> <span class="hljs-literal">nil</span>)
+(<span class="hljs-name">progn</span> (<span class="hljs-name">terpri</span> <span class="hljs-literal">t</span>)
+       (<span class="hljs-name">write</span> <span class="hljs-string">&quot;hello, multiverse!&quot;</span> <span class="hljs-symbol">:stream</span> <span class="hljs-literal">t</span> <span class="hljs-symbol">:escape</span> <span class="hljs-literal">t</span>)
+       (<span class="hljs-name">write-char</span> #\Space <span class="hljs-literal">t</span>))
+</code></pre>
+<p>There are a few new things here, which we can go over quickly for now.  They will be explained in more detail later.</p>
+<p>First, notice that the <code>print</code> function takes two arguments: the <em>object</em> you want to print, and then the <em>stream</em> you want to print the object to.  You can use the boolean truth symbol <code>t</code> as shorthand for <code>*standard-output*</code>.  You don&apos;t have to pass the second argument---the default is <code>nil</code>, so the first line of code is the same in principle as the third.</p>
+<p><code>progn</code>, one of the special operators, tells Lisp to evaluate each expression in its body sequentially, in the order they appear.</p>
+<p><code>terpri</code> stands for &quot;terminate printing&quot;.  It&apos;s used to send a new-line character to a stream.  It seems slightly illogical to use it at the <em>beginning</em> of a printing sequence, but that is how the <code>print</code> function is implemented.</p>
+<p>For the <code>write</code> function, I&apos;ve introduced two new keyword parameters, <code>:stream</code> and <code>:escape</code>, which tell <code>write</code> where to print the <em>object</em> parameter, and whether or not what&apos;s printed should be escaped, respectively.</p>
+<p>Lastly, there is <code>write-char</code>, which is like <code>write</code>, but only prints a single character object to a stream.</p>
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* (print &quot;hello, multiverse!&quot;)
+
+&quot;hello, multiverse!&quot;
+&quot;hello, multiverse!&quot;
+* (print &quot;hello again, multiverse!&quot; t)
+
+&quot;hello again, multiverse!&quot;
+&quot;hello again, multiverse!&quot;
+* (print &quot;hello, multiverse, are you there?&quot; nil)
+
+&quot;hello, multiverse, are you there?&quot;
+&quot;hello, multiverse, are you there?&quot;
+* (progn (terpri t)
+         (write &quot;hello, multiverse!&quot; :stream t :escape t)
+         (write-char #\Space t))
+
+&quot;hello, multiverse!&quot;
+#\
+</code></pre>
+<p>Everything make sense?</p>
+<p>A little word on the last example---notice how the return value of the whole <code>progn</code> form is different from <code>print</code>?  In Lisp, if you don&apos;t specify a return value (and in so doing, leave the expression early, before evaluation reaches the end), the return value of the last evaluated form in the expression is returned from the top-most expression.  In this case, <code>write-char</code> is the last expression in the <code>progn</code>, so <em>its</em> return value, <code>#\Space</code>, is returned by the <code>progn</code>.</p>
+<p>Obviously, you&apos;ll notice, the <code>print</code> function is doing something different---but we&apos;ll get to that soon.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-02-08-printing.html" class="navigation navigation-prev " aria-label="Previous page: Printing">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-02-10-prin1.html" class="navigation navigation-next " aria-label="Next page: Printing With prin1">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"More Printing","level":"3.1.2.9","depth":3,"next":{"title":"Printing With prin1","level":"3.1.2.10","depth":3,"path":"1-02-10-prin1.md","ref":"./1-02-10-prin1.md","articles":[]},"previous":{"title":"Printing","level":"3.1.2.8","depth":3,"path":"1-02-08-printing.md","ref":"./1-02-08-printing.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-02-09-more-printing.md","mtime":"2022-08-22T22:23:37.782Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-02-10-prin1.html b/clones/llthw.common-lisp.dev/1-02-10-prin1.html
new file mode 100644
index 00000000..cdcfd3be
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-02-10-prin1.html
@@ -0,0 +1,1849 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Printing With prin1 · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-02-11-princ.html" />
+    
+    
+    <link rel="prev" href="1-02-09-more-printing.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Printing With prin1</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-1210">Exercise 1.2.10</h1>
+<h2 id="printing-with-prin1">Printing With <code>prin1</code></h2>
+<p>The <code>prin1</code> function is very similar to <code>print</code>, except it doesn&apos;t output a preceding newline or a trailing space. Its emphasis is on printing readably for the Lisp Reader, <em>i.e.,</em> what you print with <code>prin1</code> is meant to be read again as source code.  Like <code>print</code>, <code>prin1</code> sets the Lisp printer paramater <code>:escape</code> to <code>t</code>, so special characters are printed escaped in strings, the same way you have to type them at the REPL and in your Lisp source files.</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">prin1</span> <span class="hljs-string">&quot;Although largely uninteresting, this \&quot;string\&quot; has escaped characters in it.&quot;</span>)
+
+(<span class="hljs-name">prin1</span> <span class="hljs-string">&quot;Remember, since the backslash (\\) is the escape character, it needs to be escaped too.&quot;</span>)
+
+(<span class="hljs-name">prin1</span> <span class="hljs-string">&quot;\Y\o\u\ \c\a\n\ \a\l\s\o\ \e\s\c\a\p\e\ \e\v\e\r\y\ \c\h\a\r\a\c\t\e\r\ \i\n\ \a\ \s\t\r\i\n\g\.&quot;</span>)
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* (<span class="hljs-name">prin1</span> <span class="hljs-string">&quot;Although largely uninteresting, this \&quot;string\&quot; has escaped characters in it.&quot;</span>)
+<span class="hljs-string">&quot;Although largely uninteresting, this \&quot;string\&quot; has escaped characters in it.&quot;</span>
+<span class="hljs-string">&quot;Although largely uninteresting, this \&quot;string\&quot; has escaped characters in it.&quot;</span>
+* (<span class="hljs-name">prin1</span> <span class="hljs-string">&quot;Remember, since the backslash (\\) is the escape character, it needs to be escaped too.&quot;</span>)
+<span class="hljs-string">&quot;Remember, since the backslash (\\) is the escape character, it needs to be escaped too.&quot;</span>
+<span class="hljs-string">&quot;Remember, since the backslash (\\) is the escape character, it needs to be escaped too.&quot;</span>
+* (<span class="hljs-name">prin1</span> <span class="hljs-string">&quot;\Y\o\u\ \c\a\n\ \a\l\s\o\ \e\s\c\a\p\e\ \e\v\e\r\y\ \c\h\a\r\a\c\t\e\r\ \i\n\ \a\ \s\t\r\i\n\g\.&quot;</span>)
+<span class="hljs-string">&quot;You can also escape every character in a string.&quot;</span>
+<span class="hljs-string">&quot;You can also escape every character in a string.&quot;</span>
+</code></pre>
+<p>Notice how only the characters that need to be escaped in a string are printed and returned escaped? As far as the Lisp Reader is concerned, a string can contain any character---but since the double-quote character terminates a string, it needs to be escaped if you want it printed, and since the escape character used would normally escape the following character, you also have to escape the backslash to print it.  But that&apos;s it.  Every other character supported by your implementation&apos;s current encoding can be included in a string.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-02-09-more-printing.html" class="navigation navigation-prev " aria-label="Previous page: More Printing">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-02-11-princ.html" class="navigation navigation-next " aria-label="Next page: Printing With princ">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Printing With prin1","level":"3.1.2.10","depth":3,"next":{"title":"Printing With princ","level":"3.1.2.11","depth":3,"path":"1-02-11-princ.md","ref":"./1-02-11-princ.md","articles":[]},"previous":{"title":"More Printing","level":"3.1.2.9","depth":3,"path":"1-02-09-more-printing.md","ref":"./1-02-09-more-printing.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-02-10-prin1.md","mtime":"2022-08-22T22:23:37.782Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-02-11-princ.html b/clones/llthw.common-lisp.dev/1-02-11-princ.html
new file mode 100644
index 00000000..a150ae67
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-02-11-princ.html
@@ -0,0 +1,1850 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Printing With princ · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-02-12-format.html" />
+    
+    
+    <link rel="prev" href="1-02-10-prin1.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Printing With princ</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-1211">Exercise 1.2.11</h1>
+<h2 id="printing-with-princ">Printing With <code>princ</code></h2>
+<p>When you want to send a string to a stream that&apos;s meant for your users and not the Lisp Reader, you&apos;ll want to use the <code>princ</code> function.  It sets the Lisp Printer parameters <code>:escape</code> and <code>:readably</code> to <code>nil</code>, so that your users can see the string you intended, and not the string you had to type in Lisp to not break anything.</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">princ</span> <span class="hljs-string">&quot;Hello, multiverse!&quot;</span>)
+
+(<span class="hljs-name">princ</span> <span class="hljs-string">&quot;My name is \&quot;Colin\&quot;.&quot;</span>)
+</code></pre>
+<div class="alert alert-success">
+    <strong>Tip:</strong>
+    <p>As an exception to the usual rule of &quot;Type exactly what I type&quot;, you <em>can</em> change my name to yours whenever it comes up in a source-code example.  Just make sure it runs!</p>
+</div>
+
+<h4 id="what-you-should-see">What You Should See</h4>
+<pre><code class="lang-lisp">* (princ &quot;Hello, multiverse!&quot;)
+Hello, multiverse!
+&quot;Hello, multiverse!&quot;
+* (princ &quot;My name is \&quot;Colin\&quot;.&quot;)
+My name is &quot;Colin&quot;.
+&quot;My name is \&quot;Colin\&quot;.&quot;
+</code></pre>
+<p>Now the difference between the <em>printed</em> string and the <em>return result</em> for a function should be more clear.  You can see above what setting the Lisp Printer parameters <code>:escape</code> and <code>:readably</code> to <code>nil</code> do: it prints the characters in a string un-escaped, not printing the outer quotation marks---so your users get exactly the string you intended.</p>
+<p>The <code>princ</code> function, like the other Lisp Printer functions we&apos;ve covered so far, still returns the original string object after it has been printed to a stream.  This is not the case with <code>format</code>, which we&apos;ll go over briefly in the next two exercises.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-02-10-prin1.html" class="navigation navigation-prev " aria-label="Previous page: Printing With prin1">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-02-12-format.html" class="navigation navigation-next " aria-label="Next page: A Brief Introduction to Format">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Printing With princ","level":"3.1.2.11","depth":3,"next":{"title":"A Brief Introduction to Format","level":"3.1.2.12","depth":3,"path":"1-02-12-format.md","ref":"./1-02-12-format.md","articles":[]},"previous":{"title":"Printing With prin1","level":"3.1.2.10","depth":3,"path":"1-02-10-prin1.md","ref":"./1-02-10-prin1.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-02-11-princ.md","mtime":"2022-08-22T22:23:37.782Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-02-12-format.html b/clones/llthw.common-lisp.dev/1-02-12-format.html
new file mode 100644
index 00000000..76c820ad
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-02-12-format.html
@@ -0,0 +1,1868 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>A Brief Introduction to Format · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-02-13-more-format.html" />
+    
+    
+    <link rel="prev" href="1-02-11-princ.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >A Brief Introduction to Format</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-1212">Exercise 1.2.12</h1>
+<h2 id="a-brief-introduction-to-format">A Brief Introduction to Format</h2>
+<p>Pretty much every programming language has some way to insert arbitrary data into a string.  Lisp is no exception.  One difference, perhaps, is that in Lisp, the <code>format</code> function is a part of the language standard, and must be fully supported for the implementation to call itself Common Lisp.  In other languages, formatting strings is usually outside the scope of the core language, and only available through the standard library.</p>
+<p>The <code>format</code> function in Lisp is so powerful, however, that I can only introduce you to a little bit of it right now.  The full treatise on this surprising core ANSI Common Lisp functionality will appear in Chapter 1.18, once you have a better grasp on key features of the language.</p>
+<h3 id="the-basics-of-format">The Basics of Format</h3>
+<p>The <code>format</code> function uses a special type of string with its own internal syntax, called <em>control sequences</em>.  These control sequences are made up of the <em>tilde</em> (<code>~</code>) character and the <em>control character</em> itself, and may also include certain infix parameters which customize the behavior of the control sequence.</p>
+<p>For example, a <code>format</code> control sequence you&apos;ll use often is <code>~A</code>, the <em>aesthetic</em> control sequence. It consumes an argument, and inserts that argument into the string, printed the same way that the <code>princ</code> function would print it. <code>~S</code>, the <em>standard</em> control sequence, consumes an argument and prints it the way <code>prin1</code> would print it. And <code>~W</code>, the <em>write</em> control sequence, consumes an argument and prints it the way that <code>write</code> would print it without any of its keyword parameters changed.</p>
+<p>What do I mean by &quot;consumes an argument&quot; though?  Well, let me show you:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;Hello, my name is ~A.&quot;</span> <span class="hljs-string">&quot;Colin&quot;</span>)
+</code></pre>
+<p>This expression calls the <code>format</code> function, tells it to <em>return</em> the formatted string by setting the output stream to <code>nil</code>, and creates a format string that consumes one argument which will be printed aesthetically.  Following that is the one argument, a string with my name in it.</p>
+<p>Now consider this example:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;My name is ~A ~A.&quot;</span> <span class="hljs-string">&quot;Colin&quot;</span> <span class="hljs-string">&quot;Lupton&quot;</span>)
+</code></pre>
+<p>Now this example expects to consume <em>two</em> arguments.  And those two arguments follow, which are now my first and last names as separate string objects.</p>
+<p>Now try these out:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;Hello, ~A!&quot;</span> <span class="hljs-string">&quot;multiverse&quot;</span>)
+
+(<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;Hello, ~S!&quot;</span> <span class="hljs-string">&quot;multiverse&quot;</span>)
+
+(<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;Hello, ~W!&quot;</span> <span class="hljs-string">&quot;multiverse&quot;</span>)
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<p>You should notice right away a few differences between <code>format</code> and the standard Lisp printer functions. You should see something like this:</p>
+<pre><code class="lang-lisp">* (format nil &quot;My name is ~A.&quot; &quot;Colin&quot;)
+&quot;My name is Colin.&quot;
+* (format nil &quot;My name is ~A ~A.&quot; &quot;Colin&quot; &quot;Lupton&quot;)
+&quot;My name is Colin Lupton.&quot;
+* (format t &quot;Hello, ~A!&quot; &quot;multiverse&quot;)
+Hello, multiverse!
+NIL
+* (format t &quot;Hello, ~S!&quot; &quot;multiverse&quot;)
+Hello, &quot;multiverse&quot;!
+NIL
+* (format t &quot;Hello, ~W!&quot; &quot;multiverse&quot;)
+Hello, &quot;multiverse&quot;!
+NIL
+</code></pre>
+<p>First up, notice that when you tell <code>format</code> to <em>return</em> the formatted string, you only get back one value now?  The return value alone.  But when you send the formatted string to <code>t</code>, which in the context of the <code>format</code> function&apos;s stream parameter is a shorthand for <code>*standard-output*</code>, you see that the formatted string is printed, and you get back a return value of <code>nil</code> instead of another string object.</p>
+<p>Now notice that with the standard and write control sequences, the argument gets printed literally?  That is, it includes the double-quote syntax that would tell the Lisp Reader that this is a string object, if you were to have Lisp try and read such a string---but since there&apos;s other junk in the string that Lisp wouldn&apos;t understand, it&apos;s not a good idea to try.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-02-11-princ.html" class="navigation navigation-prev " aria-label="Previous page: Printing With princ">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-02-13-more-format.html" class="navigation navigation-next " aria-label="Next page: A Little Bit More on Format">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"A Brief Introduction to Format","level":"3.1.2.12","depth":3,"next":{"title":"A Little Bit More on Format","level":"3.1.2.13","depth":3,"path":"1-02-13-more-format.md","ref":"./1-02-13-more-format.md","articles":[]},"previous":{"title":"Printing With princ","level":"3.1.2.11","depth":3,"path":"1-02-11-princ.md","ref":"./1-02-11-princ.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-02-12-format.md","mtime":"2022-08-22T22:23:37.782Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-02-13-more-format.html b/clones/llthw.common-lisp.dev/1-02-13-more-format.html
new file mode 100644
index 00000000..e68a1c72
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-02-13-more-format.html
@@ -0,0 +1,1872 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>A Little Bit More on Format · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-02-14-pathnames.html" />
+    
+    
+    <link rel="prev" href="1-02-12-format.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >A Little Bit More on Format</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-1213">Exercise 1.2.13</h1>
+<h2 id="a-little-bit-more-on-format">A Little Bit More on Format</h2>
+<p>Now that you&apos;ve seen how the <code>format</code> function works, we&apos;ll go through a few more control sequences that you might find useful.  Again, the full tour of format string syntax won&apos;t be coming until chapter 1.18, but this should give you enough to work with for now.</p>
+<p>Try these examples out, and see if you can guess what these format control sequences do.  They will be explained afterwards, but don&apos;t cheat---try them out, and see if you can guess what they do before you read on past the example.</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~~&quot;</span>)
+
+(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;H~CO&quot;</span> #\subscript_two)
+
+(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~R&quot;</span> <span class="hljs-number">10000</span>)
+
+(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~X&quot;</span> <span class="hljs-number">10000</span>)
+
+(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~D&quot;</span> <span class="hljs-number">10000</span>)
+
+(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~O&quot;</span> <span class="hljs-number">10000</span>)
+
+(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~B&quot;</span> <span class="hljs-number">10000</span>)
+
+(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~%Hello, ~A!&quot;</span> <span class="hljs-string">&quot;Colin&quot;</span>)
+
+(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~&amp;I said, hello!&quot;</span>)
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~~&quot;</span>)
+<span class="hljs-string">&quot;~&quot;</span>
+CL-USER&gt; (<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;H~CO&quot;</span> #\subscript_two)
+<span class="hljs-string">&quot;H&#x2082;O&quot;</span>
+CL-USER&gt; (<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~R&quot;</span> <span class="hljs-number">10000</span>)
+<span class="hljs-string">&quot;ten thousand&quot;</span>
+CL-USER&gt; (<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~X&quot;</span> <span class="hljs-number">10000</span>)
+<span class="hljs-string">&quot;2710&quot;</span>
+CL-USER&gt; (<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~D&quot;</span> <span class="hljs-number">10000</span>)
+<span class="hljs-string">&quot;10000&quot;</span>
+CL-USER&gt; (<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~O&quot;</span> <span class="hljs-number">10000</span>)
+<span class="hljs-string">&quot;23420&quot;</span>
+CL-USER&gt; (<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~B&quot;</span> <span class="hljs-number">10000</span>)
+<span class="hljs-string">&quot;10011100010000&quot;</span>
+</code></pre>
+<p>Did you guess everything correctly?  If not, don&apos;t panic.  Look over what you typed and the return results, and see now if you can infer what was printed to the string.</p>
+<p>Much like with the backslash character in a regular string, you can include a tilde character in a format string with the <em>tilde-tilde</em> control sequence, <code>~~</code>.  It doesn&apos;t consume any arguments.</p>
+<p>You can consume a character object argument using <code>~C</code>.</p>
+<p>You can insert an integer into a format string with <code>~R</code>, but since it can be a bit overkill with its flexibility, there are also simplified control sequences for printing the integer to hexadecimal, decimal, octet, and binary, like we did with <code>write</code> earlier: <code>~X</code>, <code>~D</code>, <code>~O</code>, and <code>~B</code>, respectively.  They all consume an argument, which must be an integer.</p>
+<p>You can force the insertion of a <code>#\Newline</code> character with <code>~%</code>.  It doesn&apos;t consume any arguments.</p>
+<p>And you can insert a <code>#\Newline</code> only if the output stream is not already at the beginning of a line with <code>~&amp;</code>.  It doesn&apos;t consume any arguments either.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-02-12-format.html" class="navigation navigation-prev " aria-label="Previous page: A Brief Introduction to Format">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-02-14-pathnames.html" class="navigation navigation-next " aria-label="Next page: Pathnames">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"A Little Bit More on Format","level":"3.1.2.13","depth":3,"next":{"title":"Pathnames","level":"3.1.2.14","depth":3,"path":"1-02-14-pathnames.md","ref":"./1-02-14-pathnames.md","articles":[]},"previous":{"title":"A Brief Introduction to Format","level":"3.1.2.12","depth":3,"path":"1-02-12-format.md","ref":"./1-02-12-format.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-02-13-more-format.md","mtime":"2022-08-22T22:23:37.782Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-02-14-pathnames.html b/clones/llthw.common-lisp.dev/1-02-14-pathnames.html
new file mode 100644
index 00000000..9cb1a120
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-02-14-pathnames.html
@@ -0,0 +1,1884 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Pathnames · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-02-15-streams.html" />
+    
+    
+    <link rel="prev" href="1-02-13-more-format.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Pathnames</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-1214">Exercise 1.2.14</h1>
+<h2 id="pathnames">Pathnames</h2>
+<p>Lisp has a special way of handling files from your computer: <em>pathname</em> objects. They allow Lisp to handle file-names, for the most part, in a platform-agnostic manner.  If they seem like overkill, just keep in mind how many different platforms and file-systems Lisp supports.</p>
+<p>Pathname objects are represented using the reader macro syntax <code>#P&quot;...&quot;</code>; they look like strings preceded by a Sharpsign-P, but they have a lot of internal structure you have to know about.  Let&apos;s take a look at what you can get out of a seemingly simple pathname:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">truename</span> <span class="hljs-string">&quot;.&quot;</span>)
+
+(<span class="hljs-name">pathname-directory</span> (<span class="hljs-name">truename</span> <span class="hljs-string">&quot;.&quot;</span>))
+
+(<span class="hljs-name">pathname-host</span> (<span class="hljs-name">truename</span> <span class="hljs-string">&quot;.&quot;</span>))
+
+(<span class="hljs-name">pathname-name</span> (<span class="hljs-name">truename</span> <span class="hljs-string">&quot;.&quot;</span>))
+
+(<span class="hljs-name">pathname-type</span> (<span class="hljs-name">truename</span> <span class="hljs-string">&quot;.&quot;</span>))
+</code></pre>
+<p>You&apos;ll get <code>nil</code> back for <code>pathname-name</code> and <code>pathname-type</code>.  But now let&apos;s create a new file with your text editor named &quot;llthw-ex-1-2-14.lisp&quot; and save it in the folder on your computer you got back from <code>(truename &quot;.&quot;)</code>. If you changed the default folder to open SBCL in, like you were instructed to, this should be your home folder, or a folder dedicated to your Lisp code.</p>
+<p>In &quot;llthw-ex-1-2-14.lisp&quot; enter the following code and save it again:</p>
+<pre><code class="lang-lisp"><span class="hljs-comment">;; an empty Common Lisp file</span>
+</code></pre>
+<p>Back at the REPL, try this now:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">truename</span> <span class="hljs-string">&quot;llthw-ex-1-2-14.lisp&quot;</span>)
+
+(<span class="hljs-name">pathname-name</span> (<span class="hljs-name">truename</span> <span class="hljs-string">&quot;llthw-ex-1-2-14.lisp&quot;</span>))
+
+(<span class="hljs-name">pathname-type</span> (<span class="hljs-name">truename</span> <span class="hljs-string">&quot;llthw-ex-1-2-14.lisp&quot;</span>))
+
+(<span class="hljs-name">file-namestring</span> (<span class="hljs-name">truename</span> <span class="hljs-string">&quot;llthw-ex-1-2-14.lisp&quot;</span>))
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<p>Obviously, the exact pathnames you see will be personalized for your system.  Mine below are just for sake of example, so don&apos;t panic if you don&apos;t see <em>exactly</em> the same pathname objects that I have.</p>
+<pre><code class="lang-lisp">* (truename &quot;.&quot;)
+#P&quot;/home/colin/&quot;
+* (pathname-directory (truename &quot;.&quot;))
+(:ABSOLUTE &quot;home&quot; &quot;colin&quot;)
+* (pathname-host (truename &quot;.&quot;))
+#&lt;SB-IMPL::UNIX-HOST {1000020BE3}&gt;
+* (pathname-name (truename &quot;.&quot;))
+NIL
+* (pathname-type (truename &quot;.&quot;))
+NIL
+</code></pre>
+<p>After creating the file &quot;llthw-ex-1-2-14.lisp&quot; in the directory you got from <code>(truename &quot;.&quot;)</code>:</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">truename</span> <span class="hljs-string">&quot;llthw-ex-1-2-14.lisp&quot;</span>)
+#P<span class="hljs-string">&quot;/home/colin/llthw-ex-1-2-14.lisp&quot;</span>
+* (<span class="hljs-name">pathname-name</span> (<span class="hljs-name">truename</span> <span class="hljs-string">&quot;llthw-ex-1-2-14.lisp&quot;</span>))
+<span class="hljs-string">&quot;llthw-ex-1-2-14&quot;</span>
+* (<span class="hljs-name">pathname-type</span> (<span class="hljs-name">truename</span> <span class="hljs-string">&quot;llthw-ex-1-2-14.lisp&quot;</span>))
+<span class="hljs-string">&quot;lisp&quot;</span>
+* (<span class="hljs-name">file-namestring</span> (<span class="hljs-name">truename</span> <span class="hljs-string">&quot;llthw-ex-1-2-14.lisp&quot;</span>))
+<span class="hljs-string">&quot;llthw-ex-1-2-14.lisp&quot;</span>
+</code></pre>
+<p>Do you understand what&apos;s going on here?  Take a moment to review to see if you can guess what everything is doing, and that all the code is returning what you think should be returned.</p>
+<p>Let&apos;s start with the function <code>truename</code>.  You can see that it takes a regular string that represents, but isn&apos;t, a pathname object.  In fact, <code>truename</code> accepts any <em>pathname designator</em>, which can be a relative or full pathname namestring, a file stream, or an actual pathname object.</p>
+<p>The rest of the new functions you&apos;ve seen this exercise will only accept a pathname object, proper.  That is why you need to first call <code>truename</code> on the pathname designator strings above, to get a pathname object to pass to the pathname functions.</p>
+<p>Notice the last function in the examples above, <code>file-namestring</code>? It gives you back just the file&apos;s namestring for a pathname object to a file.  If you give it a pathname object to a directory, it just returns an empty string, <code>&quot;&quot;</code>. There are some other, similar functions related to it: <code>namestring</code>, <code>directory-namestring</code>, <code>host-namestring</code>, and <code>enough-namestring</code>.  Can you guess what they do?</p>
+<h3 id="extra-credit">Extra Credit</h3>
+<p>Try out the extra namestring functions, <code>namestring</code>, <code>directory-namestring</code>, <code>host-namestring</code>, and <code>enough-namestring</code>.  Can you get them to run?  Can you predict the results you get from them?</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-02-13-more-format.html" class="navigation navigation-prev " aria-label="Previous page: A Little Bit More on Format">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-02-15-streams.html" class="navigation navigation-next " aria-label="Next page: Streams">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Pathnames","level":"3.1.2.14","depth":3,"next":{"title":"Streams","level":"3.1.2.15","depth":3,"path":"1-02-15-streams.md","ref":"./1-02-15-streams.md","articles":[]},"previous":{"title":"A Little Bit More on Format","level":"3.1.2.13","depth":3,"path":"1-02-13-more-format.md","ref":"./1-02-13-more-format.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-02-14-pathnames.md","mtime":"2022-08-22T22:23:37.782Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-02-15-streams.html b/clones/llthw.common-lisp.dev/1-02-15-streams.html
new file mode 100644
index 00000000..8f1cbefe
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-02-15-streams.html
@@ -0,0 +1,1867 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Streams · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-02-16-file-streams.html" />
+    
+    
+    <link rel="prev" href="1-02-14-pathnames.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Streams</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-1215">Exercise 1.2.15</h1>
+<h2 id="streams">Streams</h2>
+<p>You&apos;ve seen a little bit about streams already---just enough to print to <code>*standard-output*</code>.  But streams can do a lot more than that.  Streams are, simply put, the crux of I/O in Lisp.</p>
+<p>Streams are objects, too, just like the character, string, integer, and pathname objects you&apos;ve seen so far.  A stream can be designated just for input, just for output, or both.  Typically, streams accept only characters or bytes---so when you&apos;re printing a string to a stream, you are in fact <em>streaming</em> the sequence of characters that make up a string.</p>
+<p>The idea of a stream is pretty simple to understand---if you&apos;ve ever used YouTube or Netflix, you know that those services stream video to their users, so that you can start watching a video before the whole file has downloaded to your computer.  Streams in Lisp are no different---you send data to a stream, and a user listening on that stream gets the data as it becomes available.</p>
+<p>Between bytes and characters, you can send any data you want over a stream.  Lisp makes it a cinch to read and write data for I/O.</p>
+<h3 id="making-streams">Making Streams</h3>
+<p>There are a few ways to make string streams manually for input and output; but bi-directional streams can only be made from existing input and output streams.  Try out the following code to get a feel for what streams do:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">make-string-input-stream</span> <span class="hljs-string">&quot;hello?&quot;</span>)
+
+(<span class="hljs-name">read</span> (<span class="hljs-name">make-string-input-stream</span> <span class="hljs-string">&quot;hello!&quot;</span>))
+
+(<span class="hljs-name">with-input-from-string</span> (<span class="hljs-name">s</span> <span class="hljs-string">&quot;It&apos;s the multiverse!&quot;</span>)
+  (<span class="hljs-name">read</span> s))
+
+(<span class="hljs-name">with-output-to-string</span> (<span class="hljs-name">out</span>)
+  (<span class="hljs-name">with-input-from-string</span> (<span class="hljs-name">in</span> <span class="hljs-string">&quot;\&quot;Can I ask who&apos;s calling?\&quot;&quot;</span>)
+    (<span class="hljs-name">let</span> ((<span class="hljs-name">io</span> (<span class="hljs-name">make-two-way-stream</span> in out)))
+      (<span class="hljs-name">format</span> io <span class="hljs-string">&quot;~A It&apos;s the Jovian moon, Io!&quot;</span> (<span class="hljs-name">read</span> io)))))
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* (make-string-input-stream &quot;hello?&quot;)
+#&lt;SB-IMPL::STRING-INPUT-STREAM {1004CDF9B3}&gt;
+* (read (make-string-input-stream &quot;hello!&quot;))
+HELLO!
+* (with-input-from-string (s &quot;It&apos;s the multiverse!&quot;)
+    (read s))
+IT
+* (with-output-to-string (out)
+    (with-input-from-string (in &quot;\&quot;Can I ask who&apos;s calling?\&quot;&quot;)
+      (let ((io (make-two-way-stream in out)))
+        (format io &quot;~A It&apos;s the Jovian moon, Io!&quot; (read io)))))
+&quot;Can I ask who&apos;s calling? It&apos;s the Jovian moon, Io!&quot;
+</code></pre>
+<p>Here you can see that it&apos;s pretty easy to create an input stream object from a string, but on its own all you get is the object itself returned.  What do you do with that?</p>
+<p>The next example wraps the <code>make-string-input-stream</code> in a <code>read</code> form.  You haven&apos;t seen this before, but basically it&apos;s the entry point to the <em>Lisp Reader</em>, which I have mentioned in the context of printing.  Remember what I said about Lisp printing things <em>readably</em>?  Since the input you gave it doesn&apos;t have any extra escaped quotation marks, <code>read</code> thinks it&apos;s seeing a <em>symbol</em>.  So that&apos;s what you get back, the uninterned symbol <code>&apos;HELLO!</code>.</p>
+<p>You can see another side of this same point in the third example.  The <code>with-input-from-string</code> macro does a little bit more work for you than just creating an input stream---it also binds that stream to the local variable <code>s</code> for the body of the macro.  In this case, we just <code>read</code> from the stream bound to <code>s</code>.  And since <code>read</code> means have Lisp read it, it treats it as Lisp data, and parses the <code>IT</code> as a symbol, which ends at the single quote.  If you <code>read</code> from that stream three more times, you&apos;d get the symbols <code>&apos;S</code>, <code>THE</code>, and <code>MULTIVERSE!</code>.</p>
+<p>Lastly, we create a bi-directional stream, writing to it and reading from it in a really silly way just because we can.  First, we create the output stream and bind it to a local variable <code>out</code>.  Second, we create an input stream from the string <code>&quot;\&quot;Can I ask who&apos;s calling?\&quot;&quot;</code> and bind it to a local variable <code>in</code>.  Third, we make a bi-directional stream from those bound to <code>in</code> and <code>out</code>, and bind it to the local variable <code>io</code>.  Fourth, we use the <code>format</code> function to print to the bi-directional stream, feeding the data from the input stream back into the output stream.  All this is then returned by the outermost macro, <code>with-output-to-string</code>.  Notice how this time you got the whole string? That&apos;s because you entered the string object <em>readably</em> for the input stream.</p>
+<p>In the next exercise, we&apos;ll look at creating, and reading and writing to binary streams from files on your computer.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-02-14-pathnames.html" class="navigation navigation-prev " aria-label="Previous page: Pathnames">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-02-16-file-streams.html" class="navigation navigation-next " aria-label="Next page: File Streams">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Streams","level":"3.1.2.15","depth":3,"next":{"title":"File Streams","level":"3.1.2.16","depth":3,"path":"1-02-16-file-streams.md","ref":"./1-02-16-file-streams.md","articles":[]},"previous":{"title":"Pathnames","level":"3.1.2.14","depth":3,"path":"1-02-14-pathnames.md","ref":"./1-02-14-pathnames.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-02-15-streams.md","mtime":"2022-08-22T22:23:37.782Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-02-16-file-streams.html b/clones/llthw.common-lisp.dev/1-02-16-file-streams.html
new file mode 100644
index 00000000..3432b9df
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-02-16-file-streams.html
@@ -0,0 +1,1869 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>File Streams · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-02-17-binary-streams.html" />
+    
+    
+    <link rel="prev" href="1-02-15-streams.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >File Streams</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-1216">Exercise 1.2.16</h1>
+<h2 id="file-streams">File Streams</h2>
+<p>To read from and write to files on your computer with Lisp, you create a <em>file-stream</em> object.  While similar in principle to string streams, there&apos;s stuff you can do with file streams that you can&apos;t do with string streams.</p>
+<p>Like with string streams, you can create file streams manually with <code>open</code>. But for now let&apos;s look at the simplest use-case, creating a file using the <code>with-open-file</code> macro and putting some text in it; then we&apos;ll read that text back using the same macro and print it in the REPL.</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">with-open-file</span> (<span class="hljs-name">s</span> <span class="hljs-string">&quot;~/monkey.txt&quot;</span> <span class="hljs-symbol">:direction</span> <span class="hljs-symbol">:output</span> <span class="hljs-symbol">:if-does-not-exist</span> <span class="hljs-symbol">:create</span> <span class="hljs-symbol">:if-exists</span> <span class="hljs-symbol">:supersede</span>)
+  (<span class="hljs-name">format</span> s <span class="hljs-string">&quot;I had a little monkey,~%Brought him to the country,~%Fed him on ginger-bread...~%&quot;</span>))
+
+(<span class="hljs-name">with-open-file</span> (<span class="hljs-name">s</span> <span class="hljs-string">&quot;~/monkey.txt&quot;</span> <span class="hljs-symbol">:direction</span> <span class="hljs-symbol">:input</span>)
+  (<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;~&amp;;;; ~A&quot;</span> (<span class="hljs-name">read-line</span> s)))
+
+(<span class="hljs-name">with-open-file</span> (<span class="hljs-name">s</span> <span class="hljs-string">&quot;~/monkey.txt&quot;</span> <span class="hljs-symbol">:direction</span> <span class="hljs-symbol">:input</span>)
+  (<span class="hljs-name">do</span> ((<span class="hljs-name">line</span> (<span class="hljs-name">read-line</span> s) (<span class="hljs-name">read-line</span> s <span class="hljs-literal">nil</span> &apos;eof)))
+      ((<span class="hljs-name">eq</span> line &apos;eof) <span class="hljs-string">&quot;-- Marilyn Manson&quot;</span>)
+    (<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;~&amp;;;; ~A~%&quot;</span> line)))
+</code></pre>
+<div class="alert alert-info">
+  <strong>Note:</strong>
+  <p>No animals were harmed in the making of this exercise.</p>
+</div>
+
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* (<span class="hljs-name">with-open-file</span> (<span class="hljs-name">s</span> <span class="hljs-string">&quot;~/monkey.txt&quot;</span> <span class="hljs-symbol">:direction</span> <span class="hljs-symbol">:output</span> <span class="hljs-symbol">:if-does-not-exist</span> <span class="hljs-symbol">:create</span> <span class="hljs-symbol">:if-exists</span> <span class="hljs-symbol">:supersede</span>)
+    (<span class="hljs-name">format</span> s <span class="hljs-string">&quot;I had a little monkey,~%Brought him to the country,~%Fed him on ginger-bread...~%&quot;</span>))
+NIL
+* (<span class="hljs-name">with-open-file</span> (<span class="hljs-name">s</span> <span class="hljs-string">&quot;~/monkey.txt&quot;</span> <span class="hljs-symbol">:direction</span> <span class="hljs-symbol">:input</span>)
+    (<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;~&amp;;;; ~A&quot;</span> (<span class="hljs-name">read-line</span> s)))
+<span class="hljs-comment">;;; I had a little monkey,</span>
+NIL
+* (<span class="hljs-name">with-open-file</span> (<span class="hljs-name">s</span> <span class="hljs-string">&quot;~/monkey.txt&quot;</span> <span class="hljs-symbol">:direction</span> <span class="hljs-symbol">:input</span>)
+    (<span class="hljs-name">do</span> ((<span class="hljs-name">line</span> (<span class="hljs-name">read-line</span> s) (<span class="hljs-name">read-line</span> s <span class="hljs-literal">nil</span> &apos;eof)))
+        ((<span class="hljs-name">eq</span> line &apos;eof) <span class="hljs-string">&quot;-- Marilyn Manson&quot;</span>)
+      (<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;~&amp;;;; ~A~%&quot;</span> line)))
+<span class="hljs-comment">;;; I had a little monkey,</span>
+<span class="hljs-comment">;;; Brought him to the country,</span>
+<span class="hljs-comment">;;; Fed him on ginger-bread...</span>
+<span class="hljs-string">&quot;-- Marilyn Manson&quot;</span>
+</code></pre>
+<p>First up, you might want to take this opportunity to browse your file system and verify that the file <code>monkey.txt</code> was actually created in your Home directory.  You should be able to open it with any text editor you want and see what you wrote to it.  Cool, eh?  Any time you&apos;re at the REPL, and want to make a note of something, you can use this code to leave yourself a reminder.</p>
+<p>As I said above, you can create either an input or output file stream using the function <code>open</code>; but if you do it manually, you have to remember to close it as soon as you&apos;ve finished writing to it or reading from it.  The <code>with-open-file</code> macro opens and closes the file for you, and gives you a stream to work with in its body.  It&apos;s much more convenient and better reflects the Lisp Way.</p>
+<p>Don&apos;t worry too much about the <code>do</code> loop constructor I&apos;ve introduced; all you need to know for now is that it iterates over the lines in the file you opened until it reaches the end-of-file.  Once it does, you can set something to be returned---which in this case is just a string.</p>
+<p>In the next exercise, we&apos;ll be dipping our toes into <em>binary streams</em>.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-02-15-streams.html" class="navigation navigation-prev " aria-label="Previous page: Streams">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-02-17-binary-streams.html" class="navigation navigation-next " aria-label="Next page: Binary Streams">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"File Streams","level":"3.1.2.16","depth":3,"next":{"title":"Binary Streams","level":"3.1.2.17","depth":3,"path":"1-02-17-binary-streams.md","ref":"./1-02-17-binary-streams.md","articles":[]},"previous":{"title":"Streams","level":"3.1.2.15","depth":3,"path":"1-02-15-streams.md","ref":"./1-02-15-streams.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-02-16-file-streams.md","mtime":"2022-08-22T22:23:37.782Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-02-17-binary-streams.html b/clones/llthw.common-lisp.dev/1-02-17-binary-streams.html
new file mode 100644
index 00000000..86182880
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-02-17-binary-streams.html
@@ -0,0 +1,1857 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Binary Streams · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-02-18-prompting-users.html" />
+    
+    
+    <link rel="prev" href="1-02-16-file-streams.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Binary Streams</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-1217">Exercise 1.2.17</h1>
+<h2 id="binary-streams">Binary Streams</h2>
+<p>You might find the subject of Binary Streams a little esoteric at such an early stage in your Lisp experience, but we&apos;ll only be touching on them lightly, just to show you that they&apos;re there.</p>
+<p>Working with Binary Streams in general is very similar to working with file streams. You open an input, output, or bi-directional file stream, and you simply specify that you&apos;re working with bytes.  In the last exercise, we didn&apos;t specify a type for input and output, and thus used the default character stream for files.</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">with-open-file</span> (<span class="hljs-name">b</span> <span class="hljs-string">&quot;~/binary-monkey.txt&quot;</span> <span class="hljs-symbol">:direction</span> <span class="hljs-symbol">:output</span> <span class="hljs-symbol">:element-type</span> &apos;unsigned-byte <span class="hljs-symbol">:if-exists</span> <span class="hljs-symbol">:supersede</span>)
+  (<span class="hljs-name">write-byte</span> <span class="hljs-number">109</span> b)
+  (<span class="hljs-name">write-byte</span> <span class="hljs-number">111</span> b)
+  (<span class="hljs-name">write-byte</span> <span class="hljs-number">110</span> b)
+  (<span class="hljs-name">write-byte</span> <span class="hljs-number">107</span> b)
+  (<span class="hljs-name">write-byte</span> <span class="hljs-number">101</span> b)
+  (<span class="hljs-name">write-byte</span> <span class="hljs-number">121</span> b))
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* (<span class="hljs-name">with-open-file</span> (<span class="hljs-name">b</span> <span class="hljs-string">&quot;~/binary-monkey.txt&quot;</span> <span class="hljs-symbol">:direction</span> <span class="hljs-symbol">:output</span> <span class="hljs-symbol">:element-type</span> &apos;unsigned-byte <span class="hljs-symbol">:if-exists</span> <span class="hljs-symbol">:supersede</span>)
+    (<span class="hljs-name">write-byte</span> <span class="hljs-number">109</span> b)
+    (<span class="hljs-name">write-byte</span> <span class="hljs-number">111</span> b)
+    (<span class="hljs-name">write-byte</span> <span class="hljs-number">110</span> b)
+    (<span class="hljs-name">write-byte</span> <span class="hljs-number">107</span> b)
+    (<span class="hljs-name">write-byte</span> <span class="hljs-number">101</span> b)
+    (<span class="hljs-name">write-byte</span> <span class="hljs-number">121</span> b))
+<span class="hljs-number">121</span>
+</code></pre>
+<p>Now go to the file <code>~/binary-monkey.txt</code> on your computer, and open it in a text editor.  What do you see? Is it what you expected or a complete surprise?</p>
+<p>If all went well, you should have a file that just contains the word &quot;monkey&quot;.  Remember, everything in a computer is really stored and run in binary---everything else is just a representation for our benefit, to make working with computers easier and friendlier.  But it helps to remember this point.  You won&apos;t normally want to read and write to text files in binary, but for many other file formats and network protocols, this is the best way to work with them.</p>
+<p>When you set the element-type of the file stream to unsigned-byte, that allowed you to use <code>write-byte</code> on the stream.  Lisp also lets you represent bytes as integers.  So when you wrote those numbers to the text file, you were really writing the character bytes to that text file that spelled out the word &quot;monkey&quot;.  You could also have used the hexadecimal, octal, or binary representation of the integers, as I showed you in exercise 1.2.8.</p>
+<h3 id="extra-credit">Extra Credit</h3>
+<p>Rewrite the above example three times to use a <code>do</code> loop I showed you before, and a list of the numbers 109, 111, 110, 107, 101, and 121; represent these integers in hexadecimal, octal, and binary notation, respectively.</p>
+<p>If you do it right, you should only have to call the <code>write-byte</code> function once in your <code>do</code> loop.</p>
+<p>Also write the code to read the file back into Lisp as a string, and transform it into ALL-CAPS.  Hint: you can do this either with <code>format</code> or the function <code>string-upcase</code>.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-02-16-file-streams.html" class="navigation navigation-prev " aria-label="Previous page: File Streams">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-02-18-prompting-users.html" class="navigation navigation-next " aria-label="Next page: Prompting Users">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Binary Streams","level":"3.1.2.17","depth":3,"next":{"title":"Prompting Users","level":"3.1.2.18","depth":3,"path":"1-02-18-prompting-users.md","ref":"./1-02-18-prompting-users.md","articles":[]},"previous":{"title":"File Streams","level":"3.1.2.16","depth":3,"path":"1-02-16-file-streams.md","ref":"./1-02-16-file-streams.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-02-17-binary-streams.md","mtime":"2022-08-22T22:23:37.782Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-02-18-prompting-users.html b/clones/llthw.common-lisp.dev/1-02-18-prompting-users.html
new file mode 100644
index 00000000..0f4a6fa9
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-02-18-prompting-users.html
@@ -0,0 +1,1856 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Prompting Users · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-02-19-pretty-printing.html" />
+    
+    
+    <link rel="prev" href="1-02-17-binary-streams.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Prompting Users</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-1218">Exercise 1.2.18</h1>
+<h2 id="prompting-users">Prompting Users</h2>
+<p>Lisp has two built-in functions for prompting users, <code>y-or-n-p</code> and <code>yes-or-no-p</code>---they are <em>predicate</em> functions, in the sense that all they do is return <code>T</code> or <code>NIL</code>.  Unlike most other predicate functions you&apos;ll see, though, the argument you pass to them in code isn&apos;t what they&apos;re testing---it&apos;s a format string that goes to the user over <code>*query-io*</code>, and the test is applied to the user&apos;s input.</p>
+<p>If you&apos;ve used the command line at all before starting this book, you may have noticed a lot of command line applications will tell you what they&apos;re going to do, and ask you to confirm before it continues.  Something like, &quot;Going to write your changes to a file.  Are you sure you want to continue? (Y or N).&quot;  And then it waits for you to type the letter <kbd>Y</kbd> or <kbd>N</kbd> on the keyboard.</p>
+<p>Both of these functions are similar in purpose, but <code>y-or-n-p</code> only expects the user to type one character on the keyboard.  <code>yes-or-no-p</code> expects the user to type the whole word &quot;yes&quot; or &quot;no&quot;. In both cases, hit Return/Enter after to submit your response.</p>
+<p>Naturally, feel free to substitute your own name in the the example below:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">y-or-n-p</span> <span class="hljs-string">&quot;Is your name Colin?&quot;</span>)
+
+(<span class="hljs-name">yes-or-no-p</span> <span class="hljs-string">&quot;Are you sure?&quot;</span>)
+
+(<span class="hljs-name">y-or-n-p</span> <span class="hljs-string">&quot;Are you a ~S?&quot;</span> &apos;monkey)
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* (y-or-n-p &quot;Is your name Colin?&quot;)
+Is your name Colin? (y or n) y
+
+T
+* (yes-or-no-p &quot;Are you sure?&quot;)
+Are you sure? (yes or no) yes
+
+T
+* (y-or-n-p &quot;Are you a ~S?&quot; &apos;monkey)
+Are you a MONKEY? (y or n) n
+
+NIL
+</code></pre>
+<p>Try each of these functions out a few times.  Ask any question you want in the string you pass to <code>y-or-n-p</code> and <code>yes-or-no-p</code>.</p>
+<p>We will be looking at more involved prompts in Chapter 1.3, where your user can type more than just &quot;y&quot; or &quot;n&quot;, or &quot;yes&quot; or &quot;no&quot;.  But first, in the next exercise we&apos;ll take a look at Lisp&apos;s pretty-printer.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-02-17-binary-streams.html" class="navigation navigation-prev " aria-label="Previous page: Binary Streams">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-02-19-pretty-printing.html" class="navigation navigation-next " aria-label="Next page: Pretty-Printing">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Prompting Users","level":"3.1.2.18","depth":3,"next":{"title":"Pretty-Printing","level":"3.1.2.19","depth":3,"path":"1-02-19-pretty-printing.md","ref":"./1-02-19-pretty-printing.md","articles":[]},"previous":{"title":"Binary Streams","level":"3.1.2.17","depth":3,"path":"1-02-17-binary-streams.md","ref":"./1-02-17-binary-streams.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-02-18-prompting-users.md","mtime":"2022-08-22T22:23:37.782Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-02-19-pretty-printing.html b/clones/llthw.common-lisp.dev/1-02-19-pretty-printing.html
new file mode 100644
index 00000000..16533aa1
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-02-19-pretty-printing.html
@@ -0,0 +1,1846 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Pretty-Printing · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-03-0-getting-input-from-users.html" />
+    
+    
+    <link rel="prev" href="1-02-18-prompting-users.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Pretty-Printing</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-1219">Exercise 1.2.19</h1>
+<h2 id="pretty-printing">Pretty Printing</h2>
+<p>You may or may not have noticed already that Lisp has a way to print Lisp code, formatted in such a way that it&apos;s more straightforward to read.  By default, whenever possible the pretty-printer outputs the code all on one line; if there&apos;s no room left in the default margins, then it breaks the code up into multiple lines.</p>
+<p>To see the pretty-printer in action, I&apos;ll be showing you some pretty ugly code.  Normally you would never write Lisp this way---but it shows you how Lisp can take badly formatted code and give you something better.</p>
+<p>In this case, type out this example all on one line in the REPL before you hit Return/Enter.</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">pprint</span> &apos;(defun monkey (a b c) <span class="hljs-string">&quot;a monkey function&quot;</span> (let ((d <span class="hljs-number">4</span>) (e <span class="hljs-number">5</span>) (f <span class="hljs-number">6</span>)) (values (list a b c) (list d e f)))))
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* (<span class="hljs-name">pprint</span> &apos;(defun monkey (a b c) <span class="hljs-string">&quot;a monkey function&quot;</span> (let ((d <span class="hljs-number">4</span>) (e <span class="hljs-number">5</span>) (f <span class="hljs-number">6</span>)) (values (list a b c) (list d e f)))))
+(<span class="hljs-name">DEFUN</span> MONKEY (<span class="hljs-name">A</span> B C)
+  <span class="hljs-string">&quot;a monkey function&quot;</span>
+  (<span class="hljs-name">LET</span> ((<span class="hljs-name">D</span> <span class="hljs-number">4</span>) (<span class="hljs-name">E</span> <span class="hljs-number">5</span>) (<span class="hljs-name">F</span> <span class="hljs-number">6</span>))
+    (<span class="hljs-name">VALUES</span> (<span class="hljs-name">LIST</span> A B C) (<span class="hljs-name">LIST</span> D E F))))
+NIL
+</code></pre>
+<p>Remember how I introduced &quot;quoting&quot; in the Common Lisp Bootcamp chapter? It turns Lisp code into data, so the function definition above is never evaluated by Lisp.  It&apos;s <em>read</em>, but not <em>eval</em>&apos;d. Otherwise, don&apos;t worry too much about the function definition for now.  It&apos;s just illustrative, to show how the pretty printer splits up a long line into multiple lines.</p>
+<p>Now, if you <em>didn&apos;t</em> quote the above function definition, it <em>would</em> be evaluated, and then you&apos;d actually be pretty-printing the return value of the function instead of the code. Not very useful in this case---but say you wanted to pretty-print the <em>result</em> of a loop that collects a whole lot of data? It would be useful then.</p>
+<p>Lisp&apos;s Pretty Printing facilities are pretty complex, and that&apos;s to say nothing of pretty-printing with <code>format</code>. Throughout this book, you&apos;ll see more ways to take advantage of the Pretty Printer along the way.  But that&apos;s all for Chapter 1.2!</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-02-18-prompting-users.html" class="navigation navigation-prev " aria-label="Previous page: Prompting Users">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-03-0-getting-input-from-users.html" class="navigation navigation-next " aria-label="Next page: Extra Credit: Getting Input from Users">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Pretty-Printing","level":"3.1.2.19","depth":3,"next":{"title":"Extra Credit: Getting Input from Users","level":"3.1.3","depth":2,"path":"1-03-0-getting-input-from-users.md","ref":"./1-03-0-getting-input-from-users.md","articles":[]},"previous":{"title":"Prompting Users","level":"3.1.2.18","depth":3,"path":"1-02-18-prompting-users.md","ref":"./1-02-18-prompting-users.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-02-19-pretty-printing.md","mtime":"2022-08-22T22:23:37.782Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-03-0-getting-input-from-users.html b/clones/llthw.common-lisp.dev/1-03-0-getting-input-from-users.html
new file mode 100644
index 00000000..bf006692
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-03-0-getting-input-from-users.html
@@ -0,0 +1,2028 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Extra Credit: Getting Input from Users · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-04-0-lists.html" />
+    
+    
+    <link rel="prev" href="1-02-19-pretty-printing.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Extra Credit: Getting Input from Users</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-13-----extra-credit">Chapter 1.3 --- Extra Credit</h1>
+<h2 id="getting-input-from-users">Getting Input From Users</h2>
+<blockquote>
+<p>&quot;Never worry about theory as long as the machinery does what it&apos;s supposed to do.&quot;</p>
+<footer>Robert A. Heinlein, <em>Waldo &amp; Magic, Inc.</em></footer>
+
+</blockquote>
+<p>Often, as a programmer you&apos;ll need to handle unpredictable user input. You have no way of knowing what a user might try to enter when you give them a prompt or a form, whether because of unfamiliarity with the system, ignorance of some arbitrary convention, or in the worst case, malicious intent.  Not all programs <em>need</em> a way to handle data entry or text commands---but when your program does, it&apos;s important to consider in advance how you will validate all user input before it is parsed, read, evaluated, or stored by Lisp---because as a programmer you have made certain assumptions about how your program will be used, and both your users and future-you will thank you for validating input and handling issues in a sensible and interactive way that can be easily understood.</p>
+<p>Lisp has some particularly powerful tools for handling all these possibilities.  You can even give your users a complete Lisp REPL that allow them to live-hack your application for customizability---but it could also allow them to easily break everything.  Given a few best practices, however, you can implement a validated, sandboxed shell; prevent SQL injection attacks; and more.</p>
+<p>We won&apos;t be going over every aspect of this task here, but this Extra Credit chapter should be enough to get you thinking about validating every possible interaction a user might have with your program, to keep it secure and stable.</p>
+<p>This Chapter will contain exercises on:</p>
+<ul>
+<li>READ</li>
+<li>EVAL</li>
+<li>Sequences</li>
+<li>Concatenation</li>
+<li>Splitting</li>
+<li>Replacing</li>
+<li>Parsing Numbers</li>
+<li>Custom Prompts</li>
+</ul>
+<h3 id="exercise-131">Exercise 1.3.1</h3>
+<p><strong>READ: an introduction to the Lisp Reader</strong></p>
+<p>The <code>read</code> procedure can read from a stream</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">read</span>)
+</code></pre>
+<p>...</p>
+<p>Nothing actually happens until you type something else.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">read</span>)
+test <span class="hljs-comment">;; this is the thing I type when read blocks</span>
+TEST
+
+* (<span class="hljs-name">read</span>)
+<span class="hljs-number">12345</span>
+<span class="hljs-number">12345</span>
+
+* (<span class="hljs-name">read</span>)
+<span class="hljs-string">&quot;A string&quot;</span>
+<span class="hljs-string">&quot;A string&quot;</span>
+</code></pre>
+<p>Since <code>read</code> invokes the Lisp reader, any comments you type in its input are ignored. It reads an <code>s-expression</code>, not a line. So you can do things like</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">read</span>)
+<span class="hljs-string">&quot;This is a
+multiline string&quot;</span>
+<span class="hljs-string">&quot;This is a
+multiline string&quot;</span>
+
+* (<span class="hljs-name">read</span>)
+(<span class="hljs-name">list</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span>
+      <span class="hljs-number">3</span> <span class="hljs-number">4</span>
+      <span class="hljs-number">5</span> <span class="hljs-number">6</span>)
+(<span class="hljs-name">LIST</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">5</span> <span class="hljs-number">6</span>)
+</code></pre>
+<p>As you can see by that call to list, an expression read this way is <em>not</em> evaluated. Which is why you can still see the symbol <code>list</code> at the front of the List <code>read</code> returns.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">read</span>)
+(<span class="hljs-name">+</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>)
+(<span class="hljs-name">+</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>)
+
+* (<span class="hljs-name">read</span>)
+(<span class="hljs-name">defun</span> foo ()
+  (<span class="hljs-name">+</span> a b))
+(<span class="hljs-name">DEFUN</span> FOO () (<span class="hljs-name">+</span> A B))
+
+* (<span class="hljs-name">read</span>)
+(<span class="hljs-name">loop</span> (<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;Fun!~%&quot;</span>))
+(<span class="hljs-name">LOOP</span> (<span class="hljs-name">FORMAT</span> T <span class="hljs-string">&quot;Fun!~%&quot;</span>))
+</code></pre>
+<h3 id="exercise-132">Exercise 1.3.2</h3>
+<p><strong>EVAL: an introduction to the Lisp Evaluator</strong></p>
+<p>In order to evaluate something you <code>read</code>, you need to use <code>eval</code>. Some forms are self-evaluating (that is, they return themselves when evaluated).</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">eval</span> (<span class="hljs-name">read</span>)) <span class="hljs-comment">;; NEVER DO THIS IN A REAL PROGRAM</span>
+<span class="hljs-number">12345</span>
+<span class="hljs-number">12345</span>
+
+* (<span class="hljs-name">eval</span> (<span class="hljs-name">read</span>))
+<span class="hljs-string">&quot;A string&quot;</span>
+<span class="hljs-string">&quot;A string&quot;</span>
+</code></pre>
+<p>Some don&apos;t.</p>
+<pre><code class="lang-lisp">* (eval (read))
+test
+  The variable TEST is unbound.
+     [Condition of type UNBOUND-VARIABLE]
+
+* (eval (read))
+(+ 2 3)
+5
+
+* (eval (read))
+(defun foo ()
+  (+ a b))
+
+; in: DEFUN FOO
+;     (+ A B)
+;
+; caught WARNING:
+;   undefined variable: A
+;
+; caught WARNING:
+;   undefined variable: B
+;
+; compilation unit finished
+;   Undefined variables:
+;     A B
+;   caught 2 WARNING conditions
+FOO
+</code></pre>
+<p>We&apos;re not going to try to <em>call</em> that <code>foo</code> we just defined because, as you can see by the compilation warnings, we don&apos;t have values for <code>a</code> and <code>b</code> anywhere (and we&apos;re not covering dynamic scope until later).</p>
+<p>Hopefully you noticed the <code>NEVER DO THIS...</code> comment up top. It&apos;s because of things like</p>
+<pre><code class="lang-lisp">* (eval (read))
+(loop (format t &quot;Fun!~%&quot;))
+Fun!
+Fun!
+Fun!
+Fun!
+Fun!
+Fun!
+Fun!
+Fun!
+Fun!
+Fun!
+Fun!
+... ;; FOREVER (until you kill the process with an interrupt)
+</code></pre>
+<h3 id="exercise-133">Exercise 1.3.3</h3>
+<p><strong>Sequences</strong></p>
+<p>If you have an existing buffer you want to <em>destructively</em> read into, you can use <code>read-sequence</code>.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">let</span> ((<span class="hljs-name">dest</span> (<span class="hljs-name">make-list</span> <span class="hljs-number">5</span>)))
+    (<span class="hljs-name">read-sequence</span> dest *standard-input*)
+    dest)
+abcde
+(<span class="hljs-name">#</span>\a #\b #\c #\d #\e)
+</code></pre>
+<p>This procedure won&apos;t read more input than can fit into the buffer you specify.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">let</span> ((<span class="hljs-name">dest</span> (<span class="hljs-name">make-list</span> <span class="hljs-number">3</span>)))
+    (<span class="hljs-name">read-sequence</span> dest *standard-input*)
+    dest)
+abcdefghi
+(<span class="hljs-name">#</span>\a #\b #\c)
+
+* (<span class="hljs-name">let</span> ((<span class="hljs-name">dest</span> (<span class="hljs-name">list</span>)))
+    (<span class="hljs-name">read-sequence</span> dest *standard-input*)
+    dest)
+NIL
+</code></pre>
+<p>Note that it doesn&apos;t even wait for input when given a zero-length buffer. It will also keep reading until the buffer is filled...</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defparameter</span> *buf* (<span class="hljs-name">make-list</span> <span class="hljs-number">7</span>))
+*BUF*
+
+* (<span class="hljs-name">read-sequence</span> *buf* *standard-input*)
+one
+two
+<span class="hljs-number">7</span>
+
+* *buf*
+(<span class="hljs-name">#</span>\o #\n #\e #\Newline #\<span class="hljs-literal">t</span> #\w #\o)
+</code></pre>
+<p>or until some sort of break occurs.</p>
+<pre><code class="lang-lisp">* (read-sequence *buf* *standard-input*)
+abc
+User Interrupt
+   [Condition of type SIMPLE-ERROR]
+
+* *buf*
+(#\a #\b #\c #\Newline #\t #\w #\o)
+</code></pre>
+<p>As you can see from the above examples, the return value of <code>read-sequence</code> is the number of stream elements it consumed, and it really is a destructive update on the specified buffer.</p>
+<p>The buffer can be of any sequence type, rather than just a list.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">let</span> ((<span class="hljs-name">dest</span> (<span class="hljs-name">make-string</span> <span class="hljs-number">5</span>)))
+    (<span class="hljs-name">read-sequence</span> dest *standard-input*)
+    dest)
+abcdef
+<span class="hljs-string">&quot;abcde&quot;</span>
+
+* (<span class="hljs-name">let</span> ((<span class="hljs-name">dest</span> (<span class="hljs-name">make-array</span> &apos;(<span class="hljs-number">5</span>))))
+    (<span class="hljs-name">read-sequence</span> dest *standard-input*)
+    dest)
+abcdef
+#(<span class="hljs-name">#</span>\a #\b #\c #\d #\e)
+</code></pre>
+<h3 id="exercise-134">Exercise 1.3.4</h3>
+<p><strong>More Sequences</strong></p>
+<h3 id="exercise-135">Exercise 1.3.5</h3>
+<p><strong>Sequence Operations</strong></p>
+<h3 id="exercise-136">Exercise 1.3.6</h3>
+<p><strong>Concatenation</strong></p>
+<h3 id="exercise-137">Exercise 1.3.7</h3>
+<p><strong>Splitting</strong></p>
+<h3 id="exercise-138">Exercise 1.3.8</h3>
+<p><strong>Replacing</strong></p>
+<h3 id="exercise-139">Exercise 1.3.9</h3>
+<p><strong>Numbers</strong></p>
+<h3 id="exercise-1310">Exercise 1.3.10</h3>
+<p><strong>Input and Output Streams</strong></p>
+<h3 id="exercise-1311">Exercise 1.3.11</h3>
+<p><strong>Simple Prompts</strong></p>
+<h3 id="exercise-1312">Exercise 1.3.12</h3>
+<p><strong>Custom Prompts</strong></p>
+<h3 id="exercise-1313">Exercise 1.3.13</h3>
+<p><strong>Handling Input from Custom Prompts</strong></p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-02-19-pretty-printing.html" class="navigation navigation-prev " aria-label="Previous page: Pretty-Printing">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-04-0-lists.html" class="navigation navigation-next " aria-label="Next page: Lists and List-Operations">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Extra Credit: Getting Input from Users","level":"3.1.3","depth":2,"next":{"title":"Lists and List-Operations","level":"3.1.4","depth":2,"path":"1-04-0-lists.md","ref":"./1-04-0-lists.md","articles":[]},"previous":{"title":"Pretty-Printing","level":"3.1.2.19","depth":3,"path":"1-02-19-pretty-printing.md","ref":"./1-02-19-pretty-printing.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-03-0-getting-input-from-users.md","mtime":"2022-08-22T22:47:49.767Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-04-0-lists.html b/clones/llthw.common-lisp.dev/1-04-0-lists.html
new file mode 100644
index 00000000..a0f778f6
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-04-0-lists.html
@@ -0,0 +1,2363 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Lists and List-Operations · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-05-0-lookups-trees.html" />
+    
+    
+    <link rel="prev" href="1-03-0-getting-input-from-users.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Lists and List-Operations</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-14">Chapter 1.4</h1>
+<h2 id="lists-and-list-operations">Lists and List Operations</h2>
+<blockquote>
+<p>&quot;While the laws of statistics tell you how unlikely a particular coincidence is, they state just as firmly that coincidences <em>do happen</em>.&quot;</p>
+<footer>Robert A. Heinlein, <em>The Door Into Summer</em></footer>
+
+</blockquote>
+<p>In the spirit of Lambda Calculus and a pure functional heritage, the Lisp-family of programming languages gets its name from its purpose---<em>LISt Processing</em>.  Even though Common Lisp is not a purely-functional programming language, its fundamental syntax has not deviated from this heritage; as you should remember from Chapter 1.1, Cons-Cells are one of two essential forms of Expressions in Lisp, and they are represented using List syntax; and since the other---Atoms---are, by definition, self-evaluating, everything interesting that you can do in Lisp is <em>effectively</em> a List operation.  And these are divided into <em>consing</em> and <em>non-consing</em> operations.</p>
+<p>This is important to remember---it&apos;s the reason there are <em>so many</em> parentheses in Lisp source-code.  Every form surrounded by parentheses is a list. The only difference between code and data, syntactically speaking, is that <em>code is read and evaluated</em> whereas <em>data is only read</em>; you can switch to &quot;data mode&quot; by quoting an expression, but quoting isn&apos;t a free pass.  Lisp still expects to be able to <em>Read</em> the forms you&apos;ve quoted as valid forms, so the syntax is just as important to data as it is to code.</p>
+<p>This is also the key to Lisp&apos;s homoiconicity---the same syntax is used to represent both Code and Data, and as a result you can treat Code as Data, and Data as Code.  As far as Lisp is concerned, there is no difference between the two.</p>
+<p>But Lists are also a proper type in Common Lisp, that descends from sequences.  We have already seen some sequence operations on other data types, like Strings, and will explore them further.  However, in this chapter, we will focus on Lists as a proper data type and Consing operations on these Lists.</p>
+<ul>
+<li>Consing and Cons-Cells</li>
+<li>The LIST Function</li>
+<li>CAR and CDR</li>
+<li>FIRST, REST, and LAST</li>
+<li>PUSH and POP</li>
+<li>List Position</li>
+<li>APPEND</li>
+<li>Quoting</li>
+<li>Circular Lists</li>
+<li>Circular Trees</li>
+</ul>
+<h3 id="exercise-141">Exercise 1.4.1</h3>
+<p><strong>Cons-Cells</strong></p>
+<p>Cons-Cells are the smallest compound data structure in Lisp. A Cons-Cell is effectively a pair of pointers. You can tell if what you&apos;re looking at is a Cons-Cell by using the predicate <code>consp</code>.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">consp</span> <span class="hljs-number">5</span>)
+NIL
+
+* (<span class="hljs-name">consp</span> <span class="hljs-string">&quot;a&quot;</span>)
+NIL
+
+* (<span class="hljs-name">consp</span> &apos;a)
+NIL
+
+* (<span class="hljs-name">consp</span> (<span class="hljs-name">cons</span> &apos;a &apos;b))
+T
+</code></pre>
+<h3 id="exercise-142">Exercise 1.4.2</h3>
+<p><strong>Consing</strong></p>
+<p>One way to create a Cons-Cell is using the <code>cons</code> function.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">cons</span> &apos;a &apos;b)
+(<span class="hljs-name">A</span> . B)
+</code></pre>
+<p>They can hold any <code>type</code> of data, not just symbols.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">cons</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span>)
+(<span class="hljs-number">1</span> . <span class="hljs-number">2</span>)
+
+* (<span class="hljs-name">cons</span> <span class="hljs-string">&quot;one&quot;</span> <span class="hljs-string">&quot;two&quot;</span>)
+(<span class="hljs-string">&quot;one&quot;</span> . <span class="hljs-string">&quot;two&quot;</span>)
+</code></pre>
+<h3 id="exercise-143">Exercise 1.4.3</h3>
+<p><strong>Dot-Notation</strong></p>
+<p>You can see that when we cons two atoms together, we get back a Dotted Pair. This is a <code>read</code>able representation of Cons-Cells. That is, you can use it directly, rather than calling <code>cons</code>.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">cons</span> &apos;a &apos;b)
+(<span class="hljs-name">A</span> . B)
+
+* &apos;(a . b)
+(<span class="hljs-name">A</span> . B)
+</code></pre>
+<p>These two representations are equivalent.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">equal</span> (<span class="hljs-name">cons</span> &apos;a &apos;b) &apos;(a . b))
+T
+</code></pre>
+<h3 id="exercise-144">Exercise 1.4.4</h3>
+<p><strong>More Consing</strong></p>
+<p>Cons-Cells need not contain homogenous data.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">cons</span> &apos;a <span class="hljs-number">2</span>)
+(<span class="hljs-name">A</span> . <span class="hljs-number">2</span>)
+
+* (<span class="hljs-name">cons</span> <span class="hljs-number">1</span> <span class="hljs-string">&quot;two&quot;</span>)
+(<span class="hljs-number">1</span> . <span class="hljs-string">&quot;two&quot;</span>)
+
+* (<span class="hljs-name">cons</span> <span class="hljs-string">&quot;a&quot;</span> &apos;b)
+(<span class="hljs-string">&quot;a&quot;</span> . B)
+</code></pre>
+<h3 id="exercise-145">Exercise 1.4.5</h3>
+<p><strong>CAR and CDR</strong></p>
+<p>Using Cons-Cells as building blocks would be kind of pointless if we couldn&apos;t get their components back out. To get the value of the first slot in a Cons-Cell, we use the <code>car</code> function.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">cons</span> &apos;a &apos;b)
+(<span class="hljs-name">A</span> . B)
+
+* (<span class="hljs-name">car</span> (<span class="hljs-name">cons</span> &apos;a &apos;b))
+A
+</code></pre>
+<p>Similarly, we can get the value from the second slot in a Cons-Cell using <code>cdr</code>.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">cons</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span>)
+(<span class="hljs-number">1</span> . <span class="hljs-number">2</span>)
+
+* (<span class="hljs-name">cdr</span> (<span class="hljs-name">cons</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span>))
+<span class="hljs-number">2</span>
+</code></pre>
+<h3 id="exercise-146">Exercise 1.4.6</h3>
+<p><strong>More CAR and CDR</strong></p>
+<p><code>cons</code>, <code>car</code> and <code>cdr</code> are purely functional. Which means they never mutate their arguments.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defvar</span> *a* (<span class="hljs-name">cons</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span>))
+*A*
+
+* *a*
+(<span class="hljs-number">1</span> . <span class="hljs-number">2</span>)
+
+* (<span class="hljs-name">cdr</span> *a*)
+<span class="hljs-number">2</span>
+
+* *a*
+(<span class="hljs-number">1</span> . <span class="hljs-number">2</span>)
+
+* (<span class="hljs-name">cons</span> <span class="hljs-number">3</span> (<span class="hljs-name">cdr</span> *a*))
+(<span class="hljs-number">3</span> . <span class="hljs-number">2</span>)
+
+* *a*
+(<span class="hljs-number">1</span> . <span class="hljs-number">2</span>)
+</code></pre>
+<p>It is an error to use <code>car</code> and <code>cdr</code> on something other than a Cons-Cell.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">car</span> <span class="hljs-number">1</span>)
+<span class="hljs-comment">; Evaluation aborted on #&lt;TYPE-ERROR expected-type: LIST datum: 1&gt;</span>
+
+* (<span class="hljs-name">cdr</span> &apos;a)
+<span class="hljs-comment">; Evaluation aborted on #&lt;TYPE-ERROR expected-type: LIST datum: A&gt;.</span>
+</code></pre>
+<p>This includes other compound values such as strings and vectors</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">car</span> <span class="hljs-string">&quot;a&quot;</span>)
+<span class="hljs-comment">; Evaluation aborted on #&lt;TYPE-ERROR expected-type: LIST datum: &quot;a&quot;&gt;.</span>
+
+* (<span class="hljs-name">cdr</span> #(<span class="hljs-number">1</span> <span class="hljs-number">2</span>))
+<span class="hljs-comment">; Evaluation aborted on #&lt;TYPE-ERROR expected-type: LIST datum: #&lt;(SIMPLE-VECTOR 2) {1007D4C76F}&gt;&gt;.</span>
+</code></pre>
+<p>but not the empty list, also represented as <code>NIL</code></p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">car</span> <span class="hljs-literal">nil</span>)
+NIL
+
+* (<span class="hljs-name">cdr</span> <span class="hljs-literal">nil</span>)
+NIL
+
+* (<span class="hljs-name">car</span> ())
+NIL
+
+* (<span class="hljs-name">cdr</span> ())
+NIL
+</code></pre>
+<h3 id="exercise-147">Exercise 1.4.7</h3>
+<p><strong>Lists</strong></p>
+<p>A list is either the empty list, or a chain of Cons-Cells ending with the empty list.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">listp</span> <span class="hljs-literal">nil</span>)
+T
+
+* (<span class="hljs-name">listp</span> (<span class="hljs-name">cons</span> <span class="hljs-number">5</span> <span class="hljs-literal">nil</span>))
+T
+</code></pre>
+<p>If you cons something onto the empty list, you get the list of that thing.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">cons</span> <span class="hljs-number">5</span> <span class="hljs-literal">nil</span>)
+(<span class="hljs-number">5</span>)
+</code></pre>
+<p>We can exploit the Cons-Cells&apos; ability to contain heterogenous data in order to represent linked lists or trees.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">cons</span> <span class="hljs-number">3</span> (<span class="hljs-name">cons</span> <span class="hljs-number">2</span> (<span class="hljs-name">cons</span> <span class="hljs-number">1</span> <span class="hljs-literal">nil</span>)))
+(<span class="hljs-number">3</span> <span class="hljs-number">2</span> <span class="hljs-number">1</span>)
+</code></pre>
+<h3 id="exercise-148">Exercise 1.4.8</h3>
+<p><strong>More Lists</strong></p>
+<p>Another way to create lists is using the <code>list</code> function.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">list</span> <span class="hljs-number">3</span> <span class="hljs-number">2</span> <span class="hljs-number">1</span>)
+(<span class="hljs-number">3</span> <span class="hljs-number">2</span> <span class="hljs-number">1</span>)
+</code></pre>
+<p>The expression <code>(list a b ...)</code> is effectively shorthand for the expression <code>(cons a (cons b ...))</code>, with the final value being <code>cons</code>ed onto <code>NIL</code>.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">list</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>)
+(<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>)
+
+* (<span class="hljs-name">cons</span> <span class="hljs-number">1</span> (<span class="hljs-name">cons</span> <span class="hljs-number">2</span> (<span class="hljs-name">cons</span> <span class="hljs-number">3</span> <span class="hljs-literal">nil</span>)))
+(<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>)
+
+* (<span class="hljs-name">equal</span> (<span class="hljs-name">list</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>) (<span class="hljs-name">cons</span> <span class="hljs-number">1</span> (<span class="hljs-name">cons</span> <span class="hljs-number">2</span> (<span class="hljs-name">cons</span> <span class="hljs-number">3</span> <span class="hljs-literal">nil</span>))))
+T
+</code></pre>
+<p>As with <code>cons</code>, it&apos;s possible to build up trees, rather than merely lists, using <code>list</code>.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">list</span> <span class="hljs-number">1</span> (<span class="hljs-name">list</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>) (<span class="hljs-name">list</span> <span class="hljs-number">4</span> (<span class="hljs-name">list</span> (<span class="hljs-name">list</span> <span class="hljs-number">5</span>) <span class="hljs-number">6</span> <span class="hljs-number">7</span> <span class="hljs-number">8</span>)))
+(<span class="hljs-number">1</span> (<span class="hljs-number">2</span> <span class="hljs-number">3</span>) (<span class="hljs-number">4</span> ((<span class="hljs-number">5</span>) <span class="hljs-number">6</span> <span class="hljs-number">7</span> <span class="hljs-number">8</span>)))
+</code></pre>
+<h3 id="exercise-149">Exercise 1.4.9</h3>
+<p><strong>Even More CAR and CDR</strong></p>
+<p>Because <code>car</code> and <code>cdr</code> are purely functional, and return their target value, it&apos;s possible to chain them in order to look into nested structures.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">cons</span> (<span class="hljs-name">cons</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span>) <span class="hljs-number">3</span>)
+((<span class="hljs-number">1</span> . <span class="hljs-number">2</span>) . <span class="hljs-number">3</span>)
+
+* (<span class="hljs-name">car</span> (<span class="hljs-name">car</span> (<span class="hljs-name">cons</span> (<span class="hljs-name">cons</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span>) <span class="hljs-number">3</span>)))
+<span class="hljs-number">1</span>
+</code></pre>
+<p>This also applies to deeply nested lists.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defparameter</span> *tree* (<span class="hljs-name">list</span> <span class="hljs-number">1</span> (<span class="hljs-name">list</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>) (<span class="hljs-name">list</span> <span class="hljs-number">4</span> (<span class="hljs-name">list</span> (<span class="hljs-name">list</span> <span class="hljs-number">5</span>) <span class="hljs-number">6</span> <span class="hljs-number">7</span> <span class="hljs-number">8</span>))))
+*tree*
+
+* *tree*
+(<span class="hljs-number">1</span> (<span class="hljs-number">2</span> <span class="hljs-number">3</span>) (<span class="hljs-number">4</span> ((<span class="hljs-number">5</span>) <span class="hljs-number">6</span> <span class="hljs-number">7</span> <span class="hljs-number">8</span>)))
+
+* (<span class="hljs-name">car</span> (<span class="hljs-name">cdr</span> (<span class="hljs-name">car</span> (<span class="hljs-name">cdr</span> *tree*))))
+<span class="hljs-number">3</span>
+</code></pre>
+<p>This is common enough that Lisp supports shorthand for such tree selections.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">car</span> *tree*)
+<span class="hljs-number">1</span>
+
+* (<span class="hljs-name">cadr</span> *tree*)
+
+(<span class="hljs-number">2</span> <span class="hljs-number">3</span>)
+
+* (<span class="hljs-name">cadadr</span> *tree*)
+<span class="hljs-number">3</span>
+
+* (<span class="hljs-name">cddr</span> *tree*)
+((<span class="hljs-number">4</span> ((<span class="hljs-number">5</span>) <span class="hljs-number">6</span> <span class="hljs-number">7</span> <span class="hljs-number">8</span>)))
+
+* (<span class="hljs-name">cdddr</span> *tree*)
+NIL
+</code></pre>
+<p>They&apos;re actual functions though. Not a reader syntax based on the number of <code>a</code>s and <code>d</code> s between the <code>c</code> and <code>r</code>. So, for instance:</p>
+<pre><code class="lang-lisp">* (caddadddaaar *tree*)
+   The function COMMON-LISP-USER::CADDADDDAAAR is undefined.
+      [Condition of type UNDEFINED-FUNCTION]
+</code></pre>
+<h3 id="exercise-1410">Exercise 1.4.10</h3>
+<p><strong>Push and Pop</strong></p>
+<p>We mentioned before that <code>cons</code>, <code>car</code>, <code>cdr</code> and friends are purely functional. But, sometimes, you want to destructively modify a list you&apos;ve defined. For instance, in order to implement a mutable stack. In order to destructively <code>cons</code> elements onto a list, use <code>push</code>.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defvar</span> *stack* <span class="hljs-literal">nil</span>)
+*stack*
+
+* (<span class="hljs-name">push</span> <span class="hljs-number">1</span> *stack*)
+(<span class="hljs-number">1</span>)
+
+* *stack*
+(<span class="hljs-number">1</span>)
+
+* (<span class="hljs-name">push</span> <span class="hljs-number">2</span> *stack*)
+(<span class="hljs-number">2</span> <span class="hljs-number">1</span>)
+
+* (<span class="hljs-name">push</span> <span class="hljs-number">3</span> *stack*)
+(<span class="hljs-number">3</span> <span class="hljs-number">2</span> <span class="hljs-number">1</span>)
+
+* *stack*
+(<span class="hljs-number">3</span> <span class="hljs-number">2</span> <span class="hljs-number">1</span>)
+</code></pre>
+<h3 id="exercise-1411">Exercise 1.4.11</h3>
+<p><strong>Pop</strong></p>
+<p>The other half of the a stack involves destructively removing the first element from it. This can be done with <code>pop</code>.</p>
+<pre><code class="lang-lisp">* *stack*
+(<span class="hljs-number">3</span> <span class="hljs-number">2</span> <span class="hljs-number">1</span>)
+
+* (<span class="hljs-name">pop</span> *stack*)
+<span class="hljs-number">3</span>
+
+* *stack*
+(<span class="hljs-number">2</span> <span class="hljs-number">1</span>)
+
+* (<span class="hljs-name">pop</span> *stack*)
+<span class="hljs-number">2</span>
+
+* (<span class="hljs-name">pop</span> *stack*)
+<span class="hljs-number">1</span>
+
+* *stack*
+NIL
+</code></pre>
+<p>Calling <code>pop</code> on an empty list has no effect.</p>
+<pre><code class="lang-lisp">* *stack*
+NIL
+
+* (<span class="hljs-name">pop</span> *stack*)
+NIL
+
+* *stack*
+NIL
+</code></pre>
+<h3 id="exercise-1412">Exercise 1.4.12</h3>
+<p><strong>More Push and Pop</strong></p>
+<p>Like <code>cons</code>, <code>push</code> isn&apos;t limited to the existing type of its target.</p>
+<pre><code class="lang-lisp">* *stack*
+NIL
+
+* (<span class="hljs-name">push</span> <span class="hljs-number">1</span> *stack*)
+(<span class="hljs-number">1</span>)
+
+* (<span class="hljs-name">push</span> <span class="hljs-string">&quot;b&quot;</span> *stack*)
+(<span class="hljs-string">&quot;b&quot;</span> <span class="hljs-number">1</span>)
+
+* (<span class="hljs-name">push</span> &apos;c *stack*)
+(<span class="hljs-name">c</span> <span class="hljs-string">&quot;b&quot;</span> <span class="hljs-number">1</span>)
+
+* (<span class="hljs-name">push</span> (<span class="hljs-name">list</span> <span class="hljs-number">4</span> <span class="hljs-number">5</span>) *stack*)
+((<span class="hljs-number">4</span> <span class="hljs-number">5</span>) C <span class="hljs-string">&quot;a&quot;</span> <span class="hljs-number">1</span>)
+
+* *stack*
+((<span class="hljs-number">4</span> <span class="hljs-number">5</span>) C <span class="hljs-string">&quot;a&quot;</span> <span class="hljs-number">1</span>)
+</code></pre>
+<h3 id="exercise-1413">Exercise 1.4.13</h3>
+<p><strong>First, Rest, and Last</strong></p>
+<p>In addition to <code>car</code> and <code>cdr</code>, it&apos;s also possible to manipulate Cons-Cells using the <code>first</code> and <code>rest</code> functions. They&apos;re just different names for the same functions. <code>first</code> is the same as <code>car</code></p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">cons</span> &apos;a &apos;b)
+(<span class="hljs-name">A</span> . B)
+
+* (<span class="hljs-name">car</span> (<span class="hljs-name">cons</span> &apos;a &apos;b))
+A
+
+* (<span class="hljs-name">first</span> (<span class="hljs-name">cons</span> &apos;a &apos;b))
+A
+</code></pre>
+<p>and <code>rest</code> is the same as <code>cdr</code></p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">cons</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span>)
+(<span class="hljs-number">1</span> . <span class="hljs-number">2</span>)
+
+* (<span class="hljs-name">cdr</span> (<span class="hljs-name">cons</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span>))
+<span class="hljs-number">2</span>
+
+* (<span class="hljs-name">rest</span> (<span class="hljs-name">cons</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span>))
+<span class="hljs-number">2</span>
+</code></pre>
+<p>A third function, <code>last</code>, lets you get at the last Cons-Cell in a particular series.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">last</span> (<span class="hljs-name">cons</span> <span class="hljs-number">1</span> (<span class="hljs-name">cons</span> <span class="hljs-number">2</span> (<span class="hljs-name">cons</span> <span class="hljs-number">3</span> <span class="hljs-literal">nil</span>))))
+(<span class="hljs-number">3</span>)
+
+* (<span class="hljs-name">last</span> (<span class="hljs-name">cons</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span>))
+(<span class="hljs-number">1</span> . <span class="hljs-number">2</span>)
+
+* (<span class="hljs-name">last</span> (<span class="hljs-name">list</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">5</span>))
+(<span class="hljs-number">5</span>)
+</code></pre>
+<h3 id="exercise-1414">Exercise 1.4.14</h3>
+<p><strong>List Position</strong></p>
+<p>When dealing with linked lists, if you want to get at a particular element somewhere in the middle, you could either chain some <code>car</code>s and <code>cdr</code>s.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">car</span> (<span class="hljs-name">cdr</span> (<span class="hljs-name">cdr</span> (<span class="hljs-name">cdr</span> (<span class="hljs-name">list</span> <span class="hljs-number">0</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">5</span>)))))
+<span class="hljs-number">3</span>
+
+* (<span class="hljs-name">cadddr</span> (<span class="hljs-name">list</span> <span class="hljs-number">0</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">5</span>))
+<span class="hljs-number">3</span>
+</code></pre>
+<p>or you could use the <code>nth</code> function.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">nth</span> <span class="hljs-number">3</span> (<span class="hljs-name">list</span> <span class="hljs-number">0</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">5</span>))
+<span class="hljs-number">3</span>
+
+* (<span class="hljs-name">nth</span> <span class="hljs-number">4</span> (<span class="hljs-name">list</span> <span class="hljs-number">0</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">5</span>))
+<span class="hljs-number">4</span>
+
+* (<span class="hljs-name">nth</span> <span class="hljs-number">5</span> (<span class="hljs-name">list</span> <span class="hljs-number">5</span> <span class="hljs-number">4</span> <span class="hljs-number">3</span> <span class="hljs-number">2</span> <span class="hljs-number">1</span> <span class="hljs-number">0</span>))
+<span class="hljs-number">0</span>
+</code></pre>
+<p>This isn&apos;t any more efficient (in the run-time sense) than <code>cdr</code> traversal, but is shorter to write if you need to access some deeper list element in a flat list.</p>
+<h3 id="exercise-1415">Exercise 1.4.15</h3>
+<p><strong>Appending</strong></p>
+<p>Putting lists together is the job of the <code>append</code> function.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">append</span> (<span class="hljs-name">list</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>) (<span class="hljs-name">list</span> <span class="hljs-number">4</span> <span class="hljs-number">5</span> <span class="hljs-number">6</span>))
+(<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">5</span> <span class="hljs-number">6</span>)
+
+* (<span class="hljs-name">append</span> (<span class="hljs-name">list</span> <span class="hljs-number">6</span> <span class="hljs-number">5</span> <span class="hljs-number">4</span> <span class="hljs-number">3</span>) (<span class="hljs-name">list</span> <span class="hljs-number">2</span> <span class="hljs-number">1</span>))
+(<span class="hljs-number">6</span> <span class="hljs-number">5</span> <span class="hljs-number">4</span> <span class="hljs-number">3</span> <span class="hljs-number">2</span> <span class="hljs-number">1</span>)
+</code></pre>
+<p><code>append</code> is an example of a function that takes a <code>&amp;rest</code> argument. Meaning you can pass it any number of lists...</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">append</span> (<span class="hljs-name">list</span> &apos;a &apos;b &apos;c &apos;d) (<span class="hljs-name">list</span> &apos;e &apos;f) (<span class="hljs-name">list</span> &apos;g))
+(<span class="hljs-name">A</span> B C D E F G)
+
+* (<span class="hljs-name">append</span> (<span class="hljs-name">list</span> <span class="hljs-number">1</span>) (<span class="hljs-name">list</span> <span class="hljs-number">2</span>) (<span class="hljs-name">list</span> <span class="hljs-number">3</span>) (<span class="hljs-name">list</span> <span class="hljs-number">4</span>))
+(<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span>)
+</code></pre>
+<p>...though passing it one list is pointless.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">append</span> (<span class="hljs-name">list</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>))
+(<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>)
+
+* (<span class="hljs-name">list</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>)
+(<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>)
+</code></pre>
+<h3 id="exercise-1416">Exercise 1.4.16</h3>
+<p><strong>More Appending</strong></p>
+<p>Like <code>car</code>, <code>cdr</code>, <code>first</code>, <code>rest</code>, <code>last</code> and <code>nth</code>, <code>append</code> is functional. It will return a new list rather than mutating any of its arguments.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defvar</span> *lst* (<span class="hljs-name">list</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">5</span>))
+*lst*
+
+* *lst*
+(<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">5</span>)
+
+* (<span class="hljs-name">append</span> *lst* (<span class="hljs-name">list</span> <span class="hljs-number">6</span> <span class="hljs-number">7</span> <span class="hljs-number">8</span>))
+(<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">5</span> <span class="hljs-number">6</span> <span class="hljs-number">7</span> <span class="hljs-number">8</span>)
+
+* *lst*
+(<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">5</span>)
+
+* (<span class="hljs-name">append</span> (<span class="hljs-name">list</span> <span class="hljs-number">-3</span> <span class="hljs-number">-2</span> <span class="hljs-number">-1</span> <span class="hljs-number">0</span>) *lst*)
+(<span class="hljs-name">-3</span> <span class="hljs-number">-2</span> <span class="hljs-number">-1</span> <span class="hljs-number">0</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">5</span>)
+
+* *lst*
+(<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">5</span>)
+
+* (<span class="hljs-name">append</span> (<span class="hljs-name">list</span> <span class="hljs-number">0</span>) *lst* (<span class="hljs-name">list</span> <span class="hljs-number">6</span>))
+(<span class="hljs-number">0</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">5</span> <span class="hljs-number">6</span>)
+
+* *lst*
+(<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">5</span>)
+</code></pre>
+<p>This means both that you may safely pass it any data you want appended without worrying about losing the original lists, and that if you want such behavior, you need to explicitly assign the result of <code>append</code> yourself.</p>
+<h3 id="exercise-1417">Exercise 1.4.17</h3>
+<p><strong>Circular Lists</strong></p>
+<p>The destructive equivalent of <code>append</code> is <code>nconc</code>. Using such side-effects, it&apos;s possible to create circular lists.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defparameter</span> *cycle* (<span class="hljs-name">list</span> &apos;a &apos;b))
+*CYCLE*
+
+* (<span class="hljs-name">first</span> *cycle*)
+A
+
+* (<span class="hljs-name">second</span> *cycle*)
+B
+
+* (<span class="hljs-name">third</span> *cycle*)
+NIL
+
+* (<span class="hljs-name">fourth</span> *cycle*)
+NIL
+</code></pre>
+<p>Before we create an actual cycle, we need to tell the interpreter to print them (otherwise the request to print a circular list would never return; unlike Haskell, Common Lisp is not a lazy language by default).</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">setf</span> *print-circle* <span class="hljs-literal">t</span>)
+T
+
+* (<span class="hljs-name">nconc</span> *cycle* *cycle*)
+#1=(<span class="hljs-name">A</span> B . #1#)
+
+* (<span class="hljs-name">third</span> *cycle*)
+A
+
+* (<span class="hljs-name">fourth</span> *cycle*)
+B
+
+* (<span class="hljs-name">loop</span> repeat <span class="hljs-number">15</span> for elem in *cycle* collect elem)
+(<span class="hljs-name">A</span> B A B A B A B A B A B A B A)
+</code></pre>
+<h3 id="exercise-1418">Exercise 1.4.18</h3>
+<p><strong>Circular Trees</strong></p>
+<p>The <code>nconc</code> procedure is fine when all you want is a simple cycle, but it&apos;s also possible to use direct mutation to create more elaborate structures.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defparameter</span> *knot* (<span class="hljs-name">list</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> (<span class="hljs-name">cons</span> <span class="hljs-literal">nil</span> <span class="hljs-literal">nil</span>)))
+*KNOT*
+
+* (<span class="hljs-name">setf</span> (<span class="hljs-name">car</span> (<span class="hljs-name">nth</span> <span class="hljs-number">4</span> *knot*)) (<span class="hljs-name">cdr</span> *knot*))
+#1=(<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> (<span class="hljs-name">#1#</span>))
+
+* (<span class="hljs-name">setf</span> (<span class="hljs-name">cdr</span> (<span class="hljs-name">nth</span> <span class="hljs-number">4</span> *knot*)) (<span class="hljs-name">cddr</span> *knot*))
+#1=(<span class="hljs-number">3</span> <span class="hljs-number">4</span> ((<span class="hljs-number">1</span> <span class="hljs-number">2</span> . #1#) . #1#))
+</code></pre>
+<p>Now we&apos;ve got a structure that branches back on itself twice.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defun</span> cycle-walk (<span class="hljs-name">count</span> cycle <span class="hljs-symbol">&amp;key</span> (<span class="hljs-name">turn</span> #&apos;car))
+    (<span class="hljs-name">loop</span> with place = cycle
+          repeat count for elem = (<span class="hljs-name">car</span> place)
+          unless (<span class="hljs-name">consp</span> elem) do (<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;~a &quot;</span> elem)
+          do (<span class="hljs-name">setf</span> place (<span class="hljs-name">if</span> (<span class="hljs-name">consp</span> elem)
+                             (<span class="hljs-name">funcall</span> turn elem)
+                             (<span class="hljs-name">cdr</span> place)))))
+CYCLE-WALK
+
+* (<span class="hljs-name">cycle-walk</span> <span class="hljs-number">25</span> *knot* <span class="hljs-symbol">:turn</span> #&apos;car)
+<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span>
+NIL
+
+* (<span class="hljs-name">cycle-walk</span> <span class="hljs-number">25</span> *knot* <span class="hljs-symbol">:turn</span> #&apos;cdr)
+<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span>
+NIL
+
+* (<span class="hljs-name">let</span> ((<span class="hljs-name">dir</span>))
+    (<span class="hljs-name">defun</span> switch (<span class="hljs-name">pair</span>)
+      (<span class="hljs-name">setf</span> dir (<span class="hljs-name">not</span> dir))
+      (<span class="hljs-name">if</span> dir
+          (<span class="hljs-name">car</span> pair)
+          (<span class="hljs-name">cdr</span> pair))))
+SWITCH
+
+* (<span class="hljs-name">cycle-walk</span> <span class="hljs-number">25</span> *knot* <span class="hljs-symbol">:turn</span> #&apos;switch)
+<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span>
+NIL
+</code></pre>
+<p>Of course, it&apos;s possible to go further. Large, divergent &quot;trees&quot; that eventually cycle backwards from any number of branches at arbitrary depths. You&apos;d build them the same way though; using some combination of <code>nconc</code>, <code>setf</code> along with <code>car</code>/<code>cdr</code> and friends.</p>
+<h3 id="exercise-1419">Exercise 1.4.19</h3>
+<p><strong>Quoting</strong></p>
+<p>Another way to construct tree structure is using the <code>quote</code> or <code>&apos;</code>.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">quote</span> (<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>))
+(<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>)
+
+* &apos;(<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>)
+(<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>)
+
+* (<span class="hljs-name">list</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>)
+(<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>)
+</code></pre>
+<p>The structures you create this way are equivalent.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">equal</span> (<span class="hljs-name">quote</span> (<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>)) &apos;(<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>))
+T
+
+* (<span class="hljs-name">equal</span> &apos;(<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>) (<span class="hljs-name">list</span> <span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>))
+T
+</code></pre>
+<p>The difference is that, while <code>list</code> essentially means &quot;Return the list of these arguments&quot;, <code>quote</code>/<code>&apos;</code> means &quot;Return this argument without evaluating it&quot;.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defparameter</span> *test* <span class="hljs-number">2</span>)
+*test*
+
+* (<span class="hljs-name">list</span> <span class="hljs-number">1</span> *test* <span class="hljs-number">3</span>)
+(<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>)
+
+* &apos;(<span class="hljs-number">1</span> *test* <span class="hljs-number">3</span>)
+(<span class="hljs-number">1</span> *test* <span class="hljs-number">3</span>)
+
+* (<span class="hljs-name">list</span> (<span class="hljs-name">+</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span>) (<span class="hljs-name">+</span> <span class="hljs-number">5</span> <span class="hljs-number">6</span>) (<span class="hljs-name">+</span> <span class="hljs-number">7</span> <span class="hljs-number">8</span>))
+(<span class="hljs-number">7</span> <span class="hljs-number">11</span> <span class="hljs-number">15</span>)
+
+* &apos;((+ <span class="hljs-number">3</span> <span class="hljs-number">4</span>) (+ <span class="hljs-number">5</span> <span class="hljs-number">6</span>) (+ <span class="hljs-number">7</span> <span class="hljs-number">8</span>))
+((<span class="hljs-name">+</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span>) (<span class="hljs-name">+</span> <span class="hljs-number">5</span> <span class="hljs-number">6</span>) (<span class="hljs-name">+</span> <span class="hljs-number">7</span> <span class="hljs-number">8</span>))
+</code></pre>
+<h3 id="exercise-1420">Exercise 1.4.20</h3>
+<p><strong>More Quoting</strong></p>
+<p>Because <code>quote</code> supresses evaluation, you can use it to more easily build deeply nested structures.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">list</span> <span class="hljs-number">1</span> (<span class="hljs-name">list</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span>) (<span class="hljs-name">list</span> <span class="hljs-number">4</span> (<span class="hljs-name">list</span> (<span class="hljs-name">list</span> <span class="hljs-number">5</span>) <span class="hljs-number">6</span> <span class="hljs-number">7</span> <span class="hljs-number">8</span>)))
+(<span class="hljs-number">1</span> (<span class="hljs-number">2</span> <span class="hljs-number">3</span>) (<span class="hljs-number">4</span> ((<span class="hljs-number">5</span>) <span class="hljs-number">6</span> <span class="hljs-number">7</span> <span class="hljs-number">8</span>)))
+
+* &apos;(<span class="hljs-number">1</span> (<span class="hljs-number">2</span> <span class="hljs-number">3</span>) (<span class="hljs-number">4</span> ((<span class="hljs-number">5</span>) <span class="hljs-number">6</span> <span class="hljs-number">7</span> <span class="hljs-number">8</span>)))
+(<span class="hljs-number">1</span> (<span class="hljs-number">2</span> <span class="hljs-number">3</span>) (<span class="hljs-number">4</span> ((<span class="hljs-number">5</span>) <span class="hljs-number">6</span> <span class="hljs-number">7</span> <span class="hljs-number">8</span>)))
+</code></pre>
+<p>Take care not to use quoted data for mutation though. While the structures produced may be the same, mutating a quoted structure is undefined by the Common Lisp language spec, and is thus entirely implementation dependant.</p>
+<pre><code class="lang-lisp">* (defvar *listed* (list 3 2 1))
+*listed*
+
+* (defvar *quoted* &apos;(3 2 1))
+*quoted*
+
+* (push 4 *listed*)
+(4 3 2 1)
+
+* *listed*
+(4 3 2 1)
+
+* (push 4 *quoted*)
+???
+
+* *quoted*
+???
+</code></pre>
+<p>The question marks aren&apos;t there so you can figure out what the results are supposed to be. They signify that what you get back in these situations depends on which implementation of Common Lisp you&apos;re using. They may do incompatible things, but because the spec leaves this situation undefined, none of them are actually wrong. So, you know ... careful.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-03-0-getting-input-from-users.html" class="navigation navigation-prev " aria-label="Previous page: Extra Credit: Getting Input from Users">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-05-0-lookups-trees.html" class="navigation navigation-next " aria-label="Next page: Extra Credit: Look-up Lists and Trees">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Lists and List-Operations","level":"3.1.4","depth":2,"next":{"title":"Extra Credit: Look-up Lists and Trees","level":"3.1.5","depth":2,"path":"1-05-0-lookups-trees.md","ref":"./1-05-0-lookups-trees.md","articles":[]},"previous":{"title":"Extra Credit: Getting Input from Users","level":"3.1.3","depth":2,"path":"1-03-0-getting-input-from-users.md","ref":"./1-03-0-getting-input-from-users.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-04-0-lists.md","mtime":"2022-08-22T22:47:49.767Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-05-0-lookups-trees.html b/clones/llthw.common-lisp.dev/1-05-0-lookups-trees.html
new file mode 100644
index 00000000..afa38096
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-05-0-lookups-trees.html
@@ -0,0 +1,2814 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Extra Credit: Look-up Lists and Trees · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-06-0-math.html" />
+    
+    
+    <link rel="prev" href="1-04-0-lists.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Extra Credit: Look-up Lists and Trees</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-15-----extra-credit">Chapter 1.5 --- Extra Credit</h1>
+<h2 id="look-up-lists-and-trees">Look-up Lists and Trees</h2>
+<blockquote>
+<p>&quot;Take sides! Always take sides! You will sometimes be wrong&#x2014;but the man who refuses to take sides must <em>always</em> be wrong.&quot;</p>
+<footer>Robert A. Heinlein, <em>Double Star</em></footer>
+
+</blockquote>
+<p>In addition to the typical lists you saw throughout the exercises of the previous chapter, Lisp also has a couple special types of look-up lists that have more structure than just position.  They are called Association Lists and Property Lists, or <code>alists</code> and <code>plists</code> for short.  They are typically used for data and not code, because they both consist of key--value pairs; but this is Lisp, after all, so there are packages where these special data lists are repurposed as code, and later on you&apos;ll see how to do similar things yourself if you ever need or want to.</p>
+<p>If you have never come across the concept of key--value pair data structures before, they are straightforward to use and understand---all they do is assign a value you specify to a keyword, so that you can add them to a list and get the value back later by name instead of having to remember where in the list you put the value.  They are the basis for all structured data, including types such as Hash Tables, Structs, Classes, Database Tables, and more, all of which we&apos;ll be covering in this book.</p>
+<p>This chapter will contain exercises on:</p>
+<ul>
+<li>Examples of ALISTS and PLISTS</li>
+<li>Creating PLISTS</li>
+<li>Adding items to PLISTS</li>
+<li>Changing values in PLISTS</li>
+<li>Removing items from PLISTS</li>
+<li>Creating ALISTS</li>
+<li>Adding items to ALISTS</li>
+<li>Removing items from ALISTS</li>
+<li>Practical size-constraints for ALISTS and PLISTS, alternate data types to look out for.</li>
+<li>Trees</li>
+<li>More Trees</li>
+<li>Tries</li>
+<li>More Tries</li>
+<li>Why Can&apos;t I Hold All These Tries?</li>
+<li>Object Reference</li>
+<li>Acyclic Graphs</li>
+</ul>
+<h3 id="exercise-151">Exercise 1.5.1</h3>
+<p><strong>Lookups: ALISTs and PLISTs</strong></p>
+<p><code>alist</code>s and <code>plist</code>s are two basic ways of representing linear-lookup key--value structures. An <code>alist</code> is a list of cons cells</p>
+<pre><code class="lang-lisp">* &apos;((a . <span class="hljs-number">1</span>) (b . <span class="hljs-number">2</span>) (c . <span class="hljs-number">3</span>))
+((<span class="hljs-name">A</span> . <span class="hljs-number">1</span>) (<span class="hljs-name">B</span> . <span class="hljs-number">2</span>) (<span class="hljs-name">C</span> . <span class="hljs-number">3</span>))
+</code></pre>
+<p>while a <code>plist</code> is a flat list of expressions, whose every odd element is a key and every even element is a value.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">list</span> &apos;a <span class="hljs-number">1</span> &apos;b <span class="hljs-number">2</span> &apos;c <span class="hljs-number">3</span>)
+(<span class="hljs-name">A</span> <span class="hljs-number">1</span> B <span class="hljs-number">2</span> C <span class="hljs-number">3</span>)
+</code></pre>
+<p>Both constructs are of type <code>list</code>.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">listp</span> &apos;((a . <span class="hljs-number">1</span>) (b . <span class="hljs-number">2</span>) (c . <span class="hljs-number">3</span>)))
+T
+
+* (<span class="hljs-name">listp</span> (<span class="hljs-name">list</span> &apos;a <span class="hljs-number">1</span> &apos;b <span class="hljs-number">2</span> &apos;c <span class="hljs-number">3</span>))
+T
+</code></pre>
+<p>Which is a double-edged blessing; any general list-processing function can transparently take <code>alist</code>s or <code>plist</code>s as arguments, but it&apos;s not easy to tell whether a particular construct is a plain <code>list</code> or a <code>plist</code>/<code>alist</code> (and there are cases where you <em>want</em> to treat them differently).</p>
+<h3 id="exercise-152">Exercise 1.5.2</h3>
+<p><strong>PLISTs</strong></p>
+<p>A <code>plist</code> is just a flat list with an even number of elements. Each odd element is taken to be the key of the immediately following element.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">list</span> &apos;a <span class="hljs-number">1</span> &apos;b <span class="hljs-number">2</span>)
+(<span class="hljs-name">A</span> <span class="hljs-number">1</span> B <span class="hljs-number">2</span>)
+
+* (<span class="hljs-name">list</span> <span class="hljs-symbol">:foo</span> <span class="hljs-string">&quot;a&quot;</span> <span class="hljs-symbol">:bar</span> <span class="hljs-string">&quot;b&quot;</span>)
+(<span class="hljs-symbol">:FOO</span> <span class="hljs-string">&quot;a&quot;</span> <span class="hljs-symbol">:BAR</span> <span class="hljs-string">&quot;b&quot;</span>)
+</code></pre>
+<p>Calling the function <code>getf</code> on a <code>plist</code> and a key will try to find that key in the <code>plist</code>. If it is found, the return value will be that keys&apos; value.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">getf</span> (<span class="hljs-name">list</span> <span class="hljs-symbol">:foo</span> <span class="hljs-string">&quot;a&quot;</span> <span class="hljs-symbol">:bar</span> <span class="hljs-string">&quot;b&quot;</span>) <span class="hljs-symbol">:bar</span>)
+<span class="hljs-string">&quot;b&quot;</span>
+
+* (<span class="hljs-name">getf</span> (<span class="hljs-name">list</span> <span class="hljs-symbol">:foo</span> <span class="hljs-string">&quot;a&quot;</span> <span class="hljs-symbol">:bar</span> <span class="hljs-string">&quot;b&quot;</span>) <span class="hljs-symbol">:foo</span>)
+<span class="hljs-string">&quot;a&quot;</span>
+</code></pre>
+<p>The <code>getf</code> function also takes an optional argument, <code>default</code>, which it will return if the given key is not found in the given <code>plist</code>. The default <code>default</code> is <code>NIL</code>.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">getf</span> (<span class="hljs-name">list</span> <span class="hljs-symbol">:foo</span> <span class="hljs-string">&quot;a&quot;</span> <span class="hljs-symbol">:bar</span> <span class="hljs-string">&quot;b&quot;</span>) <span class="hljs-symbol">:mumble</span>)
+NIL
+
+* (<span class="hljs-name">getf</span> (<span class="hljs-name">list</span> <span class="hljs-symbol">:foo</span> <span class="hljs-string">&quot;a&quot;</span> <span class="hljs-symbol">:bar</span> <span class="hljs-string">&quot;b&quot;</span>) <span class="hljs-symbol">:mumble</span> &apos;great-googly-moogly)
+GREAT-GOOGLY-MOOGLY
+</code></pre>
+<p>Trying this on an odd-length list might give you an error, even if you specify a default value.</p>
+<pre><code class="lang-lisp">* (getf (list :foo &quot;a&quot; :bar &quot;b&quot; :baz) :foo)
+&quot;a&quot;
+
+* (getf (list :foo &quot;a&quot; :bar &quot;b&quot; :baz) :mumble)
+
+  malformed property list: (:FOO &quot;a&quot; :BAR &quot;b&quot; :BAZ).
+     [Condition of type SIMPLE-TYPE-ERROR]
+
+* (getf (list :foo &quot;a&quot; :bar &quot;b&quot; :baz) :mumble &apos;tralala)
+
+  malformed property list: (:FOO &quot;a&quot; :BAR &quot;b&quot; :BAZ).
+     [Condition of type SIMPLE-TYPE-ERROR]
+</code></pre>
+<h3 id="exercise-153">Exercise 1.5.3</h3>
+<p><strong>More PLISTs</strong></p>
+<p>Like all Cons-Cells, a <code>plist</code> can be heterogenously typed. That is, you can put many different types of things in it.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">list</span> <span class="hljs-symbol">:a</span> <span class="hljs-number">1</span> <span class="hljs-symbol">:b</span> &apos;two <span class="hljs-symbol">:c</span> <span class="hljs-string">&quot;three&quot;</span>)
+(<span class="hljs-symbol">:A</span> <span class="hljs-number">1</span> <span class="hljs-symbol">:B</span> TWO <span class="hljs-symbol">:C</span> <span class="hljs-string">&quot;three&quot;</span>)
+
+* (<span class="hljs-name">getf</span> (<span class="hljs-name">list</span> <span class="hljs-symbol">:a</span> <span class="hljs-number">1</span> <span class="hljs-symbol">:b</span> &apos;two <span class="hljs-symbol">:c</span> <span class="hljs-string">&quot;three&quot;</span>) <span class="hljs-symbol">:b</span>)
+TWO
+
+* (<span class="hljs-name">getf</span> (<span class="hljs-name">list</span> <span class="hljs-symbol">:a</span> <span class="hljs-number">1</span> <span class="hljs-symbol">:b</span> &apos;two <span class="hljs-symbol">:c</span> <span class="hljs-string">&quot;three&quot;</span>) <span class="hljs-symbol">:c</span>)
+<span class="hljs-string">&quot;three&quot;</span>
+</code></pre>
+<p>This goes for the keys, as well as the values.</p>
+<pre><code class="lang-lisp">* (list 1 :a &apos;two :b &quot;three&quot; :c)
+(1 :A TWO :B &quot;three&quot; :C)
+
+* (getf (list 1 :a &apos;two :b &quot;three&quot; :c) 1)
+:A
+
+* (getf (list 1 :a &apos;two :b &quot;three&quot; :c) &apos;two)
+:B
+</code></pre>
+<p>However, be careful. <code>getf</code> tests its keys by pointer equality, and there&apos;s no way to specify otherwise. Which means that you can&apos;t <em>really</em> use compound structures as keys in a <code>plist</code>.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">getf</span> (<span class="hljs-name">list</span> <span class="hljs-number">1</span> <span class="hljs-symbol">:a</span> &apos;two <span class="hljs-symbol">:b</span> <span class="hljs-string">&quot;three&quot;</span> <span class="hljs-symbol">:c</span>) <span class="hljs-string">&quot;three&quot;</span>)
+NIL
+</code></pre>
+<p>Because it&apos;s a flat list, you can add keys to an existing <code>plist</code> using <code>cons</code> or <code>append</code>.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">list</span> <span class="hljs-symbol">:a</span> <span class="hljs-number">1</span> <span class="hljs-symbol">:b</span> <span class="hljs-number">2</span> <span class="hljs-symbol">:c</span> <span class="hljs-number">3</span>)
+(<span class="hljs-symbol">:A</span> <span class="hljs-number">1</span> <span class="hljs-symbol">:B</span> <span class="hljs-number">2</span> <span class="hljs-symbol">:C</span> <span class="hljs-number">3</span>)
+
+* (<span class="hljs-name">let</span> ((<span class="hljs-name">plist</span> (<span class="hljs-name">list</span> <span class="hljs-symbol">:a</span> <span class="hljs-number">1</span> <span class="hljs-symbol">:b</span> <span class="hljs-number">2</span> <span class="hljs-symbol">:c</span> <span class="hljs-number">3</span>)))
+    (<span class="hljs-name">cons</span> <span class="hljs-symbol">:d</span> (<span class="hljs-name">cons</span> <span class="hljs-number">4</span> plist)))
+(<span class="hljs-symbol">:D</span> <span class="hljs-number">4</span> <span class="hljs-symbol">:A</span> <span class="hljs-number">1</span> <span class="hljs-symbol">:B</span> <span class="hljs-number">2</span> <span class="hljs-symbol">:C</span> <span class="hljs-number">3</span>)
+
+* (<span class="hljs-name">let</span> ((<span class="hljs-name">plist</span> (<span class="hljs-name">list</span> <span class="hljs-symbol">:a</span> <span class="hljs-number">1</span> <span class="hljs-symbol">:b</span> <span class="hljs-number">2</span> <span class="hljs-symbol">:c</span> <span class="hljs-number">3</span>)))
+    (<span class="hljs-name">cons</span> <span class="hljs-symbol">:d</span> (<span class="hljs-name">cons</span> <span class="hljs-number">4</span> plist))
+    plist)
+(<span class="hljs-symbol">:A</span> <span class="hljs-number">1</span> <span class="hljs-symbol">:B</span> <span class="hljs-number">2</span> <span class="hljs-symbol">:C</span> <span class="hljs-number">3</span>)
+
+* (<span class="hljs-name">let</span> ((<span class="hljs-name">plist</span> (<span class="hljs-name">list</span> <span class="hljs-symbol">:a</span> <span class="hljs-number">1</span> <span class="hljs-symbol">:b</span> <span class="hljs-number">2</span> <span class="hljs-symbol">:c</span> <span class="hljs-number">3</span>)))
+    (<span class="hljs-name">append</span> (<span class="hljs-name">list</span> <span class="hljs-symbol">:d</span> <span class="hljs-number">4</span> <span class="hljs-symbol">:e</span> <span class="hljs-number">5</span>) plist))
+(<span class="hljs-symbol">:D</span> <span class="hljs-number">4</span> <span class="hljs-symbol">:E</span> <span class="hljs-number">5</span> <span class="hljs-symbol">:A</span> <span class="hljs-number">1</span> <span class="hljs-symbol">:B</span> <span class="hljs-number">2</span> <span class="hljs-symbol">:C</span> <span class="hljs-number">3</span>)
+
+* (<span class="hljs-name">let</span> ((<span class="hljs-name">plist</span> (<span class="hljs-name">list</span> <span class="hljs-symbol">:a</span> <span class="hljs-number">1</span> <span class="hljs-symbol">:b</span> <span class="hljs-number">2</span> <span class="hljs-symbol">:c</span> <span class="hljs-number">3</span>)))
+    (<span class="hljs-name">append</span> (<span class="hljs-name">list</span> <span class="hljs-symbol">:d</span> <span class="hljs-number">4</span> <span class="hljs-symbol">:e</span> <span class="hljs-number">5</span>) plist)
+    plist)
+(<span class="hljs-symbol">:A</span> <span class="hljs-number">1</span> <span class="hljs-symbol">:B</span> <span class="hljs-number">2</span> <span class="hljs-symbol">:C</span> <span class="hljs-number">3</span>)
+</code></pre>
+<h3 id="exercise-154">Exercise 1.5.4</h3>
+<p><strong>Even More PLISTs</strong></p>
+<p>Its possible to mutate <code>plists</code>, as most other values, by using <code>setf</code>.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defparameter</span> *plist* (<span class="hljs-name">list</span> <span class="hljs-symbol">:a</span> <span class="hljs-number">1</span> <span class="hljs-symbol">:b</span> &apos;two <span class="hljs-symbol">:c</span> <span class="hljs-string">&quot;three&quot;</span>))
+*PLIST*
+
+* (<span class="hljs-name">getf</span> *plist* <span class="hljs-symbol">:b</span>)
+TWO
+
+* (<span class="hljs-name">setf</span> (<span class="hljs-name">getf</span> *plist* <span class="hljs-symbol">:b</span>) &apos;three)
+THREE
+
+* (<span class="hljs-name">getf</span> *plist* <span class="hljs-symbol">:b</span>)
+THREE
+
+* *plist*
+(<span class="hljs-symbol">:A</span> <span class="hljs-number">1</span> <span class="hljs-symbol">:B</span> THREE <span class="hljs-symbol">:C</span> <span class="hljs-string">&quot;three&quot;</span>)
+</code></pre>
+<p>The key you set this way doesn&apos;t need to exist already.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">setf</span> (<span class="hljs-name">getf</span> *plist* <span class="hljs-symbol">:d</span>) <span class="hljs-number">71</span>)
+<span class="hljs-number">71</span>
+
+* (<span class="hljs-name">getf</span> *plist* <span class="hljs-symbol">:d</span>)
+<span class="hljs-number">71</span>
+</code></pre>
+<p>but the order of new keys may surprise you.</p>
+<pre><code class="lang-lisp">* *plist*
+(<span class="hljs-symbol">:D</span> <span class="hljs-number">71</span> <span class="hljs-symbol">:A</span> <span class="hljs-number">1</span> <span class="hljs-symbol">:B</span> THREE <span class="hljs-symbol">:C</span> <span class="hljs-string">&quot;three&quot;</span>)
+</code></pre>
+<p>In order to <em>remove</em> keys from a <code>plist</code>, you&apos;d have to remove the desired key and its related value. The destructive procedure <code>remf</code> does exactly that.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">remf</span> *plist* <span class="hljs-symbol">:b</span>)
+T
+
+* *plist*
+(<span class="hljs-symbol">:D</span> <span class="hljs-number">71</span> <span class="hljs-symbol">:A</span> <span class="hljs-number">1</span> <span class="hljs-symbol">:C</span> <span class="hljs-string">&quot;three&quot;</span>)
+</code></pre>
+<h3 id="exercise-155">Exercise 1.5.5</h3>
+<p><strong>ALISTs</strong></p>
+<p>An <code>alist</code> is a list of Cons-Cells. The first element of each Cons-Cell is taken to be the key, while the rest is taken to be the value.</p>
+<pre><code class="lang-lisp">* &apos;((a . <span class="hljs-number">1</span>) (b . <span class="hljs-number">2</span>) (c . <span class="hljs-number">3</span>))
+((<span class="hljs-name">A</span> . <span class="hljs-number">1</span>) (<span class="hljs-name">B</span> . <span class="hljs-number">2</span>) (<span class="hljs-name">C</span> . <span class="hljs-number">3</span>))
+
+* (<span class="hljs-name">list</span> (<span class="hljs-name">cons</span> <span class="hljs-symbol">:foo</span> <span class="hljs-string">&quot;a&quot;</span>) (<span class="hljs-name">cons</span> <span class="hljs-symbol">:bar</span> <span class="hljs-string">&quot;b&quot;</span>))
+((<span class="hljs-symbol">:FOO</span> . <span class="hljs-string">&quot;a&quot;</span>) (<span class="hljs-symbol">:BAR</span> . <span class="hljs-string">&quot;b&quot;</span>))
+</code></pre>
+<p>Calling the function <code>assoc</code> on a key and an <code>alist</code> will try to find that key in the <code>alist</code>. If it is found, the return value will be the whole Cons-Cell in question.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">assoc</span> &apos;b &apos;((a . <span class="hljs-number">1</span>) (b . <span class="hljs-number">2</span>) (c . <span class="hljs-number">3</span>)))
+(<span class="hljs-name">B</span> . <span class="hljs-number">2</span>)
+
+* (<span class="hljs-name">assoc</span> &apos;a &apos;((a . <span class="hljs-number">1</span>) (b . <span class="hljs-number">2</span>) (c . <span class="hljs-number">3</span>)))
+(<span class="hljs-name">A</span> . <span class="hljs-number">1</span>)
+</code></pre>
+<p>Trying this on a malformed <code>alist</code>s may yield errors, though they won&apos;t be quite as specific as the ones thrown for malformed <code>plist</code>s.</p>
+<pre><code class="lang-lisp">* (assoc &apos;a &apos;((a . 1) (b . 2) c))
+(A . 1)
+
+* (assoc &apos;c &apos;((a . 1) (b . 2) c))
+
+  The value C is not of type LIST.
+     [Condition of type TYPE-ERROR]
+</code></pre>
+<p>Specifically, that <code>error</code> refers to that trailing <code>c</code> in our <code>alist</code>. This is because <code>assoc</code> compares the given key with the <code>car</code> of each element in the given list. If a particular element is not a <code>list</code> (or <code>cons</code>), you can&apos;t take its <code>car</code>, which means the selector will error.</p>
+<h3 id="exercise-156">Exercise 1.5.6</h3>
+<p><strong>More ALISTs</strong></p>
+<p>As with <code>plist</code>s, <code>alist</code>s may be heterogenously typed.</p>
+<pre><code class="lang-lisp">* &apos;((a . <span class="hljs-number">1</span>) (b . <span class="hljs-string">&quot;two&quot;</span>) (c . three) (d . #(#\f #\o #\u #\r)))
+((<span class="hljs-name">A</span> . <span class="hljs-number">1</span>) (<span class="hljs-name">B</span> . <span class="hljs-string">&quot;two&quot;</span>) (<span class="hljs-name">C</span> . THREE) (<span class="hljs-name">D</span> . #(<span class="hljs-name">#</span>\f #\o #\u #\r)))
+
+* (<span class="hljs-name">assoc</span> &apos;b &apos;((a . <span class="hljs-number">1</span>) (b . <span class="hljs-string">&quot;two&quot;</span>) (c . three) (d . #(#\f #\o #\u #\r))))
+(<span class="hljs-name">B</span> . <span class="hljs-string">&quot;two&quot;</span>)
+
+* (<span class="hljs-name">assoc</span> &apos;d &apos;((a . <span class="hljs-number">1</span>) (b . <span class="hljs-string">&quot;two&quot;</span>) (c . three) (d . #(#\f #\o #\u #\r))))
+(<span class="hljs-name">D</span> . #(<span class="hljs-name">#</span>\f #\o #\u #\r))
+</code></pre>
+<p>and this again applies to both keys and values.</p>
+<pre><code class="lang-lisp">* &apos;((<span class="hljs-number">1</span> . a) (<span class="hljs-string">&quot;two&quot;</span> . b) (three . c) (#(#\f #\o #\u #\r) . d))
+((<span class="hljs-number">1</span> . A) (<span class="hljs-string">&quot;two&quot;</span> . B) (<span class="hljs-name">THREE</span> . C) (<span class="hljs-name">#</span>(<span class="hljs-name">#</span>\f #\o #\u #\r) . D))
+
+* (<span class="hljs-name">assoc</span> &apos;three &apos;((<span class="hljs-number">1</span> . a) (<span class="hljs-string">&quot;two&quot;</span> . b) (three . c) (#(#\f #\o #\u #\r) . d)))
+(<span class="hljs-name">THREE</span> . C)
+
+* (<span class="hljs-name">assoc</span> <span class="hljs-number">1</span> &apos;((<span class="hljs-number">1</span> . a) (<span class="hljs-string">&quot;two&quot;</span> . b) (three . c) (#(#\f #\o #\u #\r) . d)))
+(<span class="hljs-number">1</span> . A)
+</code></pre>
+<p><em>Un</em>like with <code>plist</code>s, compound keys might be useful. Because <code>assoc</code> accepts a <code>test</code> (or <code>test-not</code>) argument, which lets you specify the test to run when determining key equality.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">assoc</span> <span class="hljs-string">&quot;two&quot;</span> &apos;((<span class="hljs-number">1</span> . a) (<span class="hljs-string">&quot;two&quot;</span> . b) (three . c) (#(#\f #\o #\u #\r) . d)) <span class="hljs-symbol">:test</span> #&apos;equal)
+(<span class="hljs-string">&quot;two&quot;</span> . B)
+
+* (<span class="hljs-name">assoc</span> #(<span class="hljs-name">#</span>\f #\o #\u #\r) &apos;((<span class="hljs-number">1</span> . a) (<span class="hljs-string">&quot;two&quot;</span> . b) (three . c) (#(#\f #\o #\u #\r) . d)) <span class="hljs-symbol">:test</span> #&apos;equalp)
+(<span class="hljs-name">#</span>(<span class="hljs-name">#</span>\f #\o #\u #\r) . D)
+</code></pre>
+<p>Because <code>alist</code>s are lists of <code>cons</code> cells, you can use <code>cons</code> to functionally insert items</p>
+<pre><code class="lang-lisp">* &apos;((a . <span class="hljs-number">1</span>) (b . <span class="hljs-string">&quot;two&quot;</span>) (c . three))
+((<span class="hljs-name">A</span> . <span class="hljs-number">1</span>) (<span class="hljs-name">B</span> . <span class="hljs-string">&quot;two&quot;</span>) (<span class="hljs-name">C</span> . THREE))
+
+* (<span class="hljs-name">let</span> ((<span class="hljs-name">alist</span> &apos;((a . <span class="hljs-number">1</span>) (b . <span class="hljs-string">&quot;two&quot;</span>) (c . three))))
+    (<span class="hljs-name">cons</span> (<span class="hljs-name">cons</span> &apos;d &apos;four) alist))
+((<span class="hljs-name">D</span> . FOUR) (<span class="hljs-name">A</span> . <span class="hljs-number">1</span>) (<span class="hljs-name">B</span> . <span class="hljs-string">&quot;two&quot;</span>) (<span class="hljs-name">C</span> . THREE))
+
+* (<span class="hljs-name">let</span> ((<span class="hljs-name">alist</span> &apos;((a . <span class="hljs-number">1</span>) (b . <span class="hljs-string">&quot;two&quot;</span>) (c . three))))
+    (<span class="hljs-name">cons</span> (<span class="hljs-name">cons</span> &apos;d &apos;four) alist)
+    alist)
+((<span class="hljs-name">A</span> . <span class="hljs-number">1</span>) (<span class="hljs-name">B</span> . <span class="hljs-string">&quot;two&quot;</span>) (<span class="hljs-name">C</span> . THREE))
+</code></pre>
+<p>Similarly, you can use the standard <code>remove</code>/<code>remove-if</code> functions on <code>alist</code>s transparently.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">remove</span> &apos;b &apos;((a . <span class="hljs-number">1</span>) (b . <span class="hljs-string">&quot;two&quot;</span>) (c . three)) <span class="hljs-symbol">:key</span> #&apos;car)
+((<span class="hljs-name">A</span> . <span class="hljs-number">1</span>) (<span class="hljs-name">C</span> . THREE))
+
+* (<span class="hljs-name">remove-if</span> (<span class="hljs-name">lambda</span> (<span class="hljs-name">p</span>) (<span class="hljs-name">eq</span> &apos;c (<span class="hljs-name">car</span> p))) &apos;((a . <span class="hljs-number">1</span>) (b . <span class="hljs-string">&quot;two&quot;</span>) (c . three)))
+((<span class="hljs-name">A</span> . <span class="hljs-number">1</span>) (<span class="hljs-name">B</span> . <span class="hljs-string">&quot;two&quot;</span>))
+
+* (<span class="hljs-name">remove-if</span>
+    (<span class="hljs-name">lambda</span> (<span class="hljs-name">pair</span>)
+      (<span class="hljs-name">numberp</span> (<span class="hljs-name">car</span> pair)))
+    &apos;((a . <span class="hljs-number">1</span>) (<span class="hljs-number">1</span> . a) (b . <span class="hljs-string">&quot;two&quot;</span>) (<span class="hljs-number">2</span> . b) (c . three)))
+((<span class="hljs-name">A</span> . <span class="hljs-number">1</span>) (<span class="hljs-name">B</span> . <span class="hljs-string">&quot;two&quot;</span>) (<span class="hljs-name">C</span> . THREE))
+</code></pre>
+<h3 id="exercise-157">Exercise 1.5.7</h3>
+<p><strong>Even More ALISTs</strong></p>
+<p>You can mutate <code>alist</code>s, just as you can mutate almost everything else.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defparameter</span> *alist* &apos;((a . <span class="hljs-number">1</span>) (b . <span class="hljs-number">2</span>) (c . <span class="hljs-number">3</span>)))
+*ALIST*
+
+* (<span class="hljs-name">setf</span> (<span class="hljs-name">cdr</span> (<span class="hljs-name">assoc</span> &apos;b *alist*)) <span class="hljs-number">42</span>)
+<span class="hljs-number">42</span>
+
+* *alist*
+((<span class="hljs-name">A</span> . <span class="hljs-number">1</span>) (<span class="hljs-name">B</span> . <span class="hljs-number">42</span>) (<span class="hljs-name">C</span> . <span class="hljs-number">3</span>))
+</code></pre>
+<p>Though, unlike with <code>plist</code>s, the key you&apos;re mutating must already exist.</p>
+<pre><code class="lang-lisp">* (setf (cdr (assoc &apos;foo *alist*)) 43)
+
+  The value NIL is not of type CONS.
+     [Condition of type TYPE-ERROR]
+</code></pre>
+<p>It is possible to add keys to an <code>alist</code>, but you need to be more explicit about it.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">push</span> &apos;(foo . <span class="hljs-number">43</span>) *alist*)
+((<span class="hljs-name">FOO</span> . <span class="hljs-number">43</span>) (<span class="hljs-name">A</span> . <span class="hljs-number">1</span>) (<span class="hljs-name">B</span> . <span class="hljs-number">42</span>) (<span class="hljs-name">C</span> . <span class="hljs-number">3</span>))
+
+* *alist*
+((<span class="hljs-name">FOO</span> . <span class="hljs-number">43</span>) (<span class="hljs-name">A</span> . <span class="hljs-number">1</span>) (<span class="hljs-name">B</span> . <span class="hljs-number">42</span>) (<span class="hljs-name">C</span> . <span class="hljs-number">3</span>))
+</code></pre>
+<p>You can also remove keys using <code>setf</code> and the functional approaches we discussed in the previous section.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">setf</span> *alist* (<span class="hljs-name">remove</span> &apos;b *alist* <span class="hljs-symbol">:key</span> #&apos;car))
+((<span class="hljs-name">FOO</span> . <span class="hljs-number">43</span>) (<span class="hljs-name">A</span> . <span class="hljs-number">1</span>) (<span class="hljs-name">C</span> . <span class="hljs-number">3</span>))
+
+* *alist*
+((<span class="hljs-name">FOO</span> . <span class="hljs-number">43</span>) (<span class="hljs-name">A</span> . <span class="hljs-number">1</span>) (<span class="hljs-name">C</span> . <span class="hljs-number">3</span>))
+</code></pre>
+<h3 id="exercise-158">Exercise 1.5.8</h3>
+<p><strong>Efficiency, and Alternatives to ALISTs and PLISTs</strong></p>
+<p>We mentioned earlier that the <code>alist</code> and <code>plist</code> were both representation of linear-lookup key--value structures. This is because they both work naively. That is, doing a lookup entails traversing the entire structure and comparing each key in turn until one matches the key we&apos;re looking for...</p>
+<pre><code class="lang-lisp">* (trace eq)
+(EQ)
+
+* (assoc &apos;b &apos;((a . 1) (b . 2) (c . 3) (d . 4)) :test #&apos;eq)
+  0: (EQ B A)
+  0: EQ returned NIL
+  0: (EQ B B)
+  0: EQ returned T
+(B . 2)
+
+* (assoc &apos;d &apos;((a . 1) (b . 2) (c . 3) (d . 4)) :test #&apos;eq)
+  0: (EQ D A)
+  0: EQ returned NIL
+  0: (EQ D B)
+  0: EQ returned NIL
+  0: (EQ D C)
+  0: EQ returned NIL
+  0: (EQ D D)
+  0: EQ returned T
+(D . 4)
+</code></pre>
+<p>... or until we reach the end of the list.</p>
+<pre><code class="lang-lisp">* (assoc &apos;foo &apos;((a . 1) (b . 2) (c . 3) (d . 4)) :test #&apos;eq)
+  0: (EQ FOO A)
+  0: EQ returned NIL
+  0: (EQ FOO B)
+  0: EQ returned NIL
+  0: (EQ FOO C)
+  0: EQ returned NIL
+  0: (EQ FOO D)
+  0: EQ returned NIL
+NIL
+
+* (untrace eq)
+T
+</code></pre>
+<p>This is often Good Enough, but there are times when you care about lookup performance, and might be willing to sacrifice simplicity of implementation. No, we&apos;re not implementing <code>hash-table</code>s. They&apos;re already provided as part of the language (though that won&apos;t stop us later). Lets take a look at some tree structures.</p>
+<h3 id="exercise-159">Exercise 1.5.9</h3>
+<p><strong>Trees</strong></p>
+<p>If we pick keys so that we can <em>sort</em> them instead of merely comparing them for equality, we could use a tree structure rather than a plain list. Though we do need to do a bit more work. A tree is typically recursively defined as either</p>
+<ol>
+<li>A value followed by two trees (a left branch and a right branch)</li>
+<li>The terminal value (which marks the end of our tree)</li>
+</ol>
+<p>Which we can represent as things like</p>
+<pre><code class="lang-lisp">* &apos;((<span class="hljs-number">1</span> . a) nil nil)
+((<span class="hljs-number">1</span> . A) NIL NIL)
+
+* &apos;((<span class="hljs-number">2</span> . b) ((<span class="hljs-number">1</span> . a) <span class="hljs-literal">nil</span> <span class="hljs-literal">nil</span>) ((<span class="hljs-number">3</span> . c) <span class="hljs-literal">nil</span> ((<span class="hljs-number">4</span> . d) <span class="hljs-literal">nil</span> <span class="hljs-literal">nil</span>)))
+((<span class="hljs-number">2</span> . B) ((<span class="hljs-number">1</span> . A) NIL NIL) ((<span class="hljs-number">3</span> . C) NIL ((<span class="hljs-number">4</span> . D) NIL NIL)))
+</code></pre>
+<p>This is not the only possible tree representation, nor necessarily the best. We&apos;ll reserve others for later on. You can see that our &quot;value&quot; is a key--value pair in the style of an <code>alist</code> and our terminal value is <code>NIL</code>. Also, note that our keys are sorted. That is, everything in the left branch of a particular tree has a <em>lesser</em> key than the &quot;value&quot; of that tree, while everything in the right branch has a <em>greater</em> key. This is the property that will let us do faster lookups. Ideally, it will let us cut half of the remaining search space out with each comparison.</p>
+<p>Here&apos;s <code>lookup</code>:</p>
+<pre><code class="lang-lisp">* (defun lookup (key sorted-tree)
+    (let ((k (caar sorted-tree)))
+      (cond ((null sorted-tree) nil)
+        ((&gt; k key)
+         (lookup key (second sorted-tree)))
+        ((&lt; k key)
+         (lookup key (third sorted-tree)))
+        (t
+         (first sorted-tree)))))
+LOOKUP
+
+* (trace lookup)
+(LOOKUP)
+
+* (lookup 4 &apos;((2 . b) ((1 . a) nil nil) ((3 . c) nil ((4 . d) nil nil))))
+  0: (LOOKUP 4 ((2 . B) ((1 . A) NIL NIL) ((3 . C) NIL ((4 . D) NIL NIL))))
+    1: (LOOKUP 4 ((3 . C) NIL ((4 . D) NIL NIL)))
+      2: (LOOKUP 4 ((4 . D) NIL NIL))
+      2: LOOKUP returned (4 . D)
+    1: LOOKUP returned (4 . D)
+  0: LOOKUP returned (4 . D)
+(4 . D)
+</code></pre>
+<p>Notice that we don&apos;t compare against all of the preceding elements in order to get to ours. We only compare against 3. A tree of four key--value pairs isn&apos;t the best demonstration of this, of course.</p>
+<h3 id="exercise-1510">Exercise 1.5.10</h3>
+<p><strong>More Trees</strong></p>
+<p>Since we&apos;re doing more work on trees, we may as well go <a href="https://llthw.common-lisp.dev/TODO%20link">SICP</a>-style and define the functional interface.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defun</span> tree (<span class="hljs-name">val</span> left right)
+    (<span class="hljs-name">list</span> val left right))
+TREE
+
+* (<span class="hljs-name">defun</span> tree-value (<span class="hljs-name">tree</span>) (<span class="hljs-name">first</span> tree))
+TREE-VALUE
+
+* (<span class="hljs-name">defun</span> tree-left (<span class="hljs-name">tree</span>) (<span class="hljs-name">second</span> tree))
+TREE-LEFT
+
+* (<span class="hljs-name">defun</span> tree-right (<span class="hljs-name">tree</span>) (<span class="hljs-name">third</span> tree))
+TREE-RIGHT
+
+* (<span class="hljs-name">defun</span> lookup (<span class="hljs-name">key</span> tree)
+    (<span class="hljs-name">if</span> (<span class="hljs-name">null</span> tree)
+        <span class="hljs-literal">nil</span>
+        (<span class="hljs-name">let</span> ((<span class="hljs-name">k</span> (<span class="hljs-name">car</span> (<span class="hljs-name">tree-value</span> tree))))
+          (<span class="hljs-name">cond</span> ((<span class="hljs-name">&gt;</span> k key) (<span class="hljs-name">lookup</span> key (<span class="hljs-name">tree-left</span> tree)))
+                ((<span class="hljs-name">&lt;</span> k key) (<span class="hljs-name">lookup</span> key (<span class="hljs-name">tree-right</span> tree)))
+                (<span class="hljs-name">t</span> (<span class="hljs-name">tree-value</span> tree))))))
+<span class="hljs-comment">; STYLE-WARNING: redefining COMMON-LISP-USER::LOOKUP in DEFUN</span>
+LOOKUP
+</code></pre>
+<p>Now that we have that, a naive <code>insert</code> looks like</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defun</span> insert (<span class="hljs-name">key</span> value tree)
+    (<span class="hljs-name">if</span> (<span class="hljs-name">null</span> tree)
+        (<span class="hljs-name">tree</span> (<span class="hljs-name">cons</span> key value) <span class="hljs-literal">nil</span> <span class="hljs-literal">nil</span>)
+        (<span class="hljs-name">let</span> ((<span class="hljs-name">k</span> (<span class="hljs-name">car</span> (<span class="hljs-name">tree-value</span> tree))))
+          (<span class="hljs-name">cond</span> ((<span class="hljs-name">&gt;</span> k key)
+                 (<span class="hljs-name">tree</span> (<span class="hljs-name">tree-value</span> tree)
+                       (<span class="hljs-name">insert</span> key value (<span class="hljs-name">tree-left</span> tree))
+                       (<span class="hljs-name">tree-right</span> tree)))
+                ((<span class="hljs-name">&lt;</span> k key)
+                 (<span class="hljs-name">tree</span> (<span class="hljs-name">tree-value</span> tree)
+                       (<span class="hljs-name">tree-left</span> tree)
+                       (<span class="hljs-name">insert</span> key value (<span class="hljs-name">tree-right</span> tree))))
+                (<span class="hljs-name">t</span> tree)))))
+INSERT
+</code></pre>
+<p>We can use that insert on this specially-ordered <code>alist</code> to give us a reasonably balanced tree.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defparameter</span> *lst* &apos;((<span class="hljs-number">5</span> . e) (<span class="hljs-number">3</span> . c) (<span class="hljs-number">4</span> . d) (<span class="hljs-number">2</span> . b) (<span class="hljs-number">1</span> . a) (<span class="hljs-number">7</span> . g) (<span class="hljs-number">6</span> . f) (<span class="hljs-number">8</span> . h) (<span class="hljs-number">9</span> . i) (<span class="hljs-number">10</span> . j)))
+*LST*
+
+* (<span class="hljs-name">reduce</span>
+    (<span class="hljs-name">lambda</span> (<span class="hljs-name">memo</span> pair)
+      (<span class="hljs-name">insert</span> (<span class="hljs-name">car</span> pair) (<span class="hljs-name">cdr</span> pair) memo))
+    *lst* <span class="hljs-symbol">:initial-value</span> <span class="hljs-literal">nil</span>)
+((<span class="hljs-number">5</span> . E) ((<span class="hljs-number">3</span> . C) ((<span class="hljs-number">2</span> . B) ((<span class="hljs-number">1</span> . A) NIL NIL) NIL) ((<span class="hljs-number">4</span> . D) NIL NIL))
+ ((<span class="hljs-number">7</span> . G) ((<span class="hljs-number">6</span> . F) NIL NIL) ((<span class="hljs-number">8</span> . H) NIL ((<span class="hljs-number">9</span> . I) NIL ((<span class="hljs-number">10</span> . J) NIL NIL)))))
+
+* (<span class="hljs-name">defparameter</span> *tree*
+    (<span class="hljs-name">reduce</span>
+     (<span class="hljs-name">lambda</span> (<span class="hljs-name">memo</span> pair)
+       (<span class="hljs-name">insert</span> (<span class="hljs-name">car</span> pair) (<span class="hljs-name">cdr</span> pair) memo))
+     *lst* <span class="hljs-symbol">:initial-value</span> <span class="hljs-literal">nil</span>))
+</code></pre>
+<p>And, just so that we&apos;re comparing like-for-like, here&apos;s a recursive definition of <code>assoc</code></p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defun</span> rec-assoc (<span class="hljs-name">key</span> alist)
+    (<span class="hljs-name">cond</span> ((<span class="hljs-name">null</span> alist) <span class="hljs-literal">nil</span>)
+          ((<span class="hljs-name">eq</span> key (<span class="hljs-name">caar</span> alist)) (<span class="hljs-name">car</span> alist))
+          (<span class="hljs-name">t</span> (<span class="hljs-name">rec-assoc</span> key (<span class="hljs-name">cdr</span> alist)))))
+REC-ASSOC
+</code></pre>
+<p>Now, lets compare lookup steps involved.</p>
+<pre><code class="lang-lisp">* (trace lookup rec-assoc)
+(LOOKUP REC-ASSOC)
+
+* (rec-assoc 9 *lst*)
+  0: (REC-ASSOC 9
+                ((5 . E) (3 . C) (4 . D) (2 . B) (1 . A) (7 . G) (6 . F)
+                 (8 . H) (9 . I) (10 . J)))
+    1: (REC-ASSOC 9
+                  ((3 . C) (4 . D) (2 . B) (1 . A) (7 . G) (6 . F) (8 . H)
+                   (9 . I) (10 . J)))
+      2: (REC-ASSOC 9
+                    ((4 . D) (2 . B) (1 . A) (7 . G) (6 . F) (8 . H) (9 . I)
+                     (10 . J)))
+        3: (REC-ASSOC 9
+                      ((2 . B) (1 . A) (7 . G) (6 . F) (8 . H) (9 . I) (10 . J)))
+          4: (REC-ASSOC 9 ((1 . A) (7 . G) (6 . F) (8 . H) (9 . I) (10 . J)))
+            5: (REC-ASSOC 9 ((7 . G) (6 . F) (8 . H) (9 . I) (10 . J)))
+              6: (REC-ASSOC 9 ((6 . F) (8 . H) (9 . I) (10 . J)))
+                7: (REC-ASSOC 9 ((8 . H) (9 . I) (10 . J)))
+                  8: (REC-ASSOC 9 ((9 . I) (10 . J)))
+                  8: REC-ASSOC returned (9 . I)
+                7: REC-ASSOC returned (9 . I)
+              6: REC-ASSOC returned (9 . I)
+            5: REC-ASSOC returned (9 . I)
+          4: REC-ASSOC returned (9 . I)
+        3: REC-ASSOC returned (9 . I)
+      2: REC-ASSOC returned (9 . I)
+    1: REC-ASSOC returned (9 . I)
+  0: REC-ASSOC returned (9 . I)
+(9 . I)
+
+* (lookup 9 *tree*)
+  0: (LOOKUP 9
+             ((5 . E)
+              ((3 . C) ((2 . B) ((1 . A) NIL NIL) NIL) ((4 . D) NIL NIL))
+              ((7 . G) ((6 . F) NIL NIL)
+               ((8 . H) NIL ((9 . I) NIL ((10 . J) NIL NIL))))))
+    1: (LOOKUP 9
+               ((7 . G) ((6 . F) NIL NIL)
+                ((8 . H) NIL ((9 . I) NIL ((10 . J) NIL NIL)))))
+      2: (LOOKUP 9 ((8 . H) NIL ((9 . I) NIL ((10 . J) NIL NIL))))
+        3: (LOOKUP 9 ((9 . I) NIL ((10 . J) NIL NIL)))
+        3: LOOKUP returned (9 . I)
+      2: LOOKUP returned (9 . I)
+    1: LOOKUP returned (9 . I)
+  0: LOOKUP returned (9 . I)
+(9 . I)
+
+* (untrace lookup rec-assoc)
+T
+</code></pre>
+<p>The tree structure saves us a bit of work in a situation like this. And, if we can arrange for our lookup tree to be balanced or almost balanced, we&apos;ll save <em>more</em> work the bigger our data-set becomes.</p>
+<h3 id="exercise-1511">Exercise 1.5.11</h3>
+<p><strong>Tries</strong></p>
+<p>If we can pick keys so that they&apos;re not merely sortable, but also <em>decomposable</em>, we can save a bit more time and space by using Tries <em>(As an aside, &quot;Tree&quot; and &quot;Trie&quot; are pronounced the same way. This is doubly annoying because, as you&apos;ll see in a moment, a Trie is a kind of Tree. So you can&apos;t even disambiguate by saying things like &quot;Trie, the data structure&quot;. You&apos;ll sometimes hear Tries referred to as &quot;Prefix trees&quot;, which may or may not help the situation)</em>.</p>
+<p>A Trie is a value and a (possibly empty) dictionary of key parts to Tries. Which can be represented as:</p>
+<pre><code class="lang-lisp">* &apos;(nil nil)
+(<span class="hljs-name">NIL</span> NIL)
+
+* &apos;(nil ((#\o <span class="hljs-literal">nil</span> ((#\n <span class="hljs-string">&quot;activated; not off&quot;</span> ((#\e <span class="hljs-string">&quot;the english name for the numeral 1&quot;</span> NIL)))))))
+(<span class="hljs-name">NIL</span>
+ ((<span class="hljs-name">#</span>\o NIL
+   ((<span class="hljs-name">#</span>\n <span class="hljs-string">&quot;activated; not off&quot;</span>
+     ((<span class="hljs-name">#</span>\e <span class="hljs-string">&quot;the english name for the numeral 1&quot;</span>)))))))
+
+* &apos;(nil ((<span class="hljs-number">1</span> <span class="hljs-literal">nil</span> ((<span class="hljs-number">2</span> <span class="hljs-literal">nil</span> ((<span class="hljs-number">3</span> <span class="hljs-string">&quot;ah ah ah.&quot;</span> <span class="hljs-literal">nil</span>)))))))
+(<span class="hljs-name">NIL</span> ((<span class="hljs-number">1</span> NIL ((<span class="hljs-number">2</span> NIL ((<span class="hljs-number">3</span> <span class="hljs-string">&quot;ah ah ah.&quot;</span> NIL)))))))
+
+* &apos;(nil
+    ((this <span class="hljs-literal">nil</span>
+      ((sentence <span class="hljs-literal">nil</span>
+        ((is <span class="hljs-literal">nil</span>
+          ((a <span class="hljs-literal">nil</span> ((key <span class="hljs-string">&quot;This sentence is a key&quot;</span> <span class="hljs-literal">nil</span>)))
+           (not <span class="hljs-literal">nil</span> ((a <span class="hljs-literal">nil</span> ((key <span class="hljs-string">&quot;This sentence is NOT a key&quot;</span> <span class="hljs-literal">nil</span>)))))
+           (meaningless <span class="hljs-literal">t</span> <span class="hljs-literal">nil</span>)))))))))
+(<span class="hljs-name">NIL</span>
+ ((<span class="hljs-name">THIS</span> NIL
+   ((<span class="hljs-name">SENTENCE</span> NIL
+     ((<span class="hljs-name">IS</span> NIL
+       ((<span class="hljs-name">A</span> NIL ((<span class="hljs-name">KEY</span> <span class="hljs-string">&quot;This sentence is a key&quot;</span> NIL)))
+        (<span class="hljs-name">NOT</span> NIL ((<span class="hljs-name">A</span> NIL ((<span class="hljs-name">KEY</span> <span class="hljs-string">&quot;This sentence is NOT a key&quot;</span> NIL)))))
+        (<span class="hljs-name">MEANINGLESS</span> T NIL)))))))))
+</code></pre>
+<p>Looking up a key in a Trie means taking the decomposed key, and looking up each key part level-wise.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defun</span> trie-lookup (<span class="hljs-name">key-parts</span> trie)
+    (<span class="hljs-name">if</span> (<span class="hljs-name">null</span> key-parts)
+        (<span class="hljs-name">first</span> trie)
+        (<span class="hljs-name">let</span> ((<span class="hljs-name">next</span> (<span class="hljs-name">cdr</span> (<span class="hljs-name">assoc</span> (<span class="hljs-name">car</span> key-parts) (<span class="hljs-name">second</span> trie)))))
+          (<span class="hljs-name">when</span> next
+            (<span class="hljs-name">trie-lookup</span> (<span class="hljs-name">cdr</span> key-parts) next)))))
+TRIE-LOOKUP
+
+* (<span class="hljs-name">defparameter</span> *trie*
+    &apos;(nil ((#\o <span class="hljs-literal">nil</span> ((#\n <span class="hljs-string">&quot;activated; not off&quot;</span> ((#\e <span class="hljs-string">&quot;the english name for the numeral 1&quot;</span> NIL))))))))
+*TRIE*
+
+* (<span class="hljs-name">trie-lookup</span> &apos;(#\o #\n) *trie*)
+<span class="hljs-string">&quot;activated; not off&quot;</span>
+
+* (<span class="hljs-name">trie-lookup</span> &apos;(#\o #\n #\e) *trie*)
+<span class="hljs-string">&quot;the english name for the numeral 1&quot;</span>
+
+* (<span class="hljs-name">trie-lookup</span> &apos;(#\o #\n #\e #\i #\r #\o #\s) *trie*)
+NIL
+
+* (<span class="hljs-name">trie-lookup</span> &apos;(#\t #\w #\o) *trie*)
+NIL
+</code></pre>
+<p>The idea here is that any common prefixes among keys are collapsed, and that some extra data about a particular sequence is held as the <code>value</code>. The best casefor a lookup is a key that shares no prefix with anything in the Trie. The worst case is a key that shares a long prefix, since we need to traverse the entire prefix before discovering the absence.</p>
+<h3 id="exercise-1512">Exercise 1.5.12</h3>
+<p><strong>More Tries</strong></p>
+<p>So lets go explicit-interface-style on this problem.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defun</span> trie (<span class="hljs-name">val</span> map)
+    (<span class="hljs-name">list</span> val map))
+TRIE
+
+* (<span class="hljs-name">defun</span> empty-trie ()
+    (<span class="hljs-name">trie</span> <span class="hljs-literal">nil</span> <span class="hljs-literal">nil</span>))
+EMPTY-TRIE
+
+* (<span class="hljs-name">empty-trie</span>)
+(<span class="hljs-name">NIL</span> NIL)
+
+* (<span class="hljs-name">defun</span> trie-value (<span class="hljs-name">trie</span>)
+    (<span class="hljs-name">first</span> trie))
+TRIE-VALUE
+
+* (<span class="hljs-name">defun</span> trie-table (<span class="hljs-name">trie</span>)
+    (<span class="hljs-name">second</span> trie))
+TRIE-TABLE
+
+* (<span class="hljs-name">defun</span> trie-assoc (<span class="hljs-name">key-part</span> trie)
+    (<span class="hljs-name">cdr</span> (<span class="hljs-name">assoc</span> key-part (<span class="hljs-name">trie-table</span> trie))))
+TRIE-ASSOC
+
+* (<span class="hljs-name">defun</span> trie-lookup (<span class="hljs-name">key-parts</span> trie)
+    (<span class="hljs-name">if</span> (<span class="hljs-name">null</span> key-parts)
+        (<span class="hljs-name">trie-value</span> trie)
+        (<span class="hljs-name">let</span> ((<span class="hljs-name">next</span> (<span class="hljs-name">trie-assoc</span> (<span class="hljs-name">first</span> key-parts) trie)))
+          (<span class="hljs-name">when</span> next
+            (<span class="hljs-name">trie-lookup</span> (<span class="hljs-name">rest</span> key-parts) next)))))
+</code></pre>
+<p>Those are the basic getters. And nothing really fancy has been said yet. You can see why I&apos;d leave them out for the initial pass based on their trivial nature. Insertion is less trivial to implement, but still conceptually simple.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defun</span> trie-alist-insert (<span class="hljs-name">k</span> trie alist)
+    (<span class="hljs-name">cons</span> (<span class="hljs-name">cons</span> k trie)
+          (<span class="hljs-name">remove</span> k alist <span class="hljs-symbol">:key</span> #&apos;car)))
+TRIE-ALIST-INSERT
+
+* (<span class="hljs-name">defun</span> trie-insert (<span class="hljs-name">key</span> value trie)
+    (<span class="hljs-name">if</span> key
+        (<span class="hljs-name">let*</span> ((<span class="hljs-name">k</span> (<span class="hljs-name">first</span> key))
+               (<span class="hljs-name">next</span> (<span class="hljs-name">trie-assoc</span> k trie)))
+          (<span class="hljs-name">trie</span> (<span class="hljs-name">trie-value</span> trie)
+                (<span class="hljs-name">trie-alist-insert</span>
+                 k
+                 (<span class="hljs-name">trie-insert</span>
+                  (<span class="hljs-name">rest</span> key) value
+                  (<span class="hljs-name">or</span> next (<span class="hljs-name">trie</span> <span class="hljs-literal">nil</span> <span class="hljs-literal">nil</span>)))
+                 (<span class="hljs-name">trie-table</span> trie))))
+        (<span class="hljs-name">trie</span> value (<span class="hljs-name">trie-table</span> trie))))
+TRIE-INSERT
+
+* (<span class="hljs-name">trie-insert</span> (<span class="hljs-name">coerce</span> <span class="hljs-string">&quot;once&quot;</span> &apos;list) <span class="hljs-string">&quot;one time, and one time only&quot;</span> *trie*)
+(<span class="hljs-name">NIL</span>
+ ((<span class="hljs-name">#</span>\o NIL
+   ((<span class="hljs-name">#</span>\n <span class="hljs-string">&quot;activated; not off&quot;</span>
+     ((<span class="hljs-name">#</span>\c NIL ((<span class="hljs-name">#</span>\e <span class="hljs-string">&quot;one time, and one time only&quot;</span> NIL)))
+      (<span class="hljs-name">#</span>\e <span class="hljs-string">&quot;the english name for the numeral 1&quot;</span> NIL)))))))
+</code></pre>
+<p>In order to insert a new value, associated with a particular key, we traverse that keys&apos; parts and either recur to the next level of the <code>trie</code> by looking up the current part, or freshly insert that part into the current <code>trie</code> table. If we run out of key to traverse, we insert the new value, replacing an existing one if necessary.</p>
+<pre><code class="lang-lisp">* *trie*
+(<span class="hljs-name">NIL</span>
+ ((<span class="hljs-name">#</span>\o NIL
+   ((<span class="hljs-name">#</span>\n <span class="hljs-string">&quot;activated; not off&quot;</span>
+     ((<span class="hljs-name">#</span>\e <span class="hljs-string">&quot;the english name for the numeral 1&quot;</span> NIL)))))))
+
+* (<span class="hljs-name">trie-insert</span> (<span class="hljs-name">coerce</span> <span class="hljs-string">&quot;on&quot;</span> &apos;list) <span class="hljs-string">&quot;switched on&quot;</span> *trie*)
+(<span class="hljs-name">NIL</span>
+ ((<span class="hljs-name">#</span>\o NIL
+   ((<span class="hljs-name">#</span>\n <span class="hljs-string">&quot;switched on&quot;</span>
+     ((<span class="hljs-name">#</span>\e <span class="hljs-string">&quot;the english name for the numeral 1&quot;</span> NIL)))))))
+</code></pre>
+<p>Though of course, as always, we&apos;re not doing this replacement destructively.</p>
+<pre><code class="lang-lisp">* *trie*
+(<span class="hljs-name">NIL</span>
+ ((<span class="hljs-name">#</span>\o NIL
+   ((<span class="hljs-name">#</span>\n <span class="hljs-string">&quot;activated; not off&quot;</span>
+     ((<span class="hljs-name">#</span>\e <span class="hljs-string">&quot;the english name for the numeral 1&quot;</span> NIL)))))))
+</code></pre>
+<p>Now, lets do the same comparison we did earlier in the Trees section.</p>
+<pre><code>* (defun rec-string-assoc (key alist)
+    (cond ((null alist) nil)
+          ((string= key (caar alist)) (car alist))
+          (t (rec-string-assoc key (cdr alist)))))
+
+* (defparameter *alist*
+    &apos;((&quot;p&quot; . &quot;the 16th letter of the English alphabet&quot;)
+      (&quot;pea&quot; . &quot;the small spherical seed or the seed-pod of the pod fruit Pisum sativum&quot;)
+      (&quot;peanut&quot; . &quot;a plant species in the legume family&quot;)
+      (&quot;peanuts&quot; . &quot;plural of peanut; syndicated comic strip started in 1950&quot;)
+      (&quot;peanut butter&quot; . &quot;a creamy delight commonly used in sandwiches&quot;)
+      (&quot;on&quot; . &quot;activated; not off&quot;)
+      (&quot;one&quot; . &quot;the English name for the numeral 1&quot;)
+      (&quot;ones&quot; . &quot;plural of &apos;one&apos;&quot;)
+      (&quot;once&quot; . &quot;one time, and one time only&quot;)))
+
+* (defparameter *trie*
+    (reduce
+     (lambda (memo pair)
+       (trie-insert
+        (coerce (car pair) &apos;list)
+        (cdr pair)
+        memo))
+     *alist* :initial-value (empty-trie)))
+*TRIE*
+
+* (trace rec-string-assoc trie-lookup)
+(REC-STRING-ASSOC TRIE-LOOKUP)
+
+* (trie-lookup (coerce &quot;once&quot; &apos;list) *trie*)
+  0: (TRIE-LOOKUP (#\o #\n #\c #\e)
+                  (NIL
+                   ((#\o NIL
+                     ((#\n &quot;activated; not off&quot;
+                       ((#\c NIL ((#\e &quot;one time, and one time only&quot; NIL)))
+                        (#\e &quot;the English name for the numeral 1&quot;
+                         ((#\s &quot;plural of &apos;one&apos;&quot; NIL)))))))
+                    (#\p &quot;the 16th letter of the English alphabet&quot;
+                     ((#\e NIL
+                       ((#\a
+                         &quot;the small spherical seed or the seed-pod of the pod fruit Pisum sativum&quot;
+                         ((#\n NIL
+                           ((#\u NIL
+                             ((#\t &quot;a plant species in the legume family&quot;
+                               ((#\  NIL
+                                 ((#\b NIL
+                                   ((#\u NIL
+                                     ((#\t NIL
+                                       ((#\t NIL
+                                         ((#\e NIL
+                                           ((#\r
+                                             &quot;a creamy delight commonly used in sandwiches&quot;
+                                             NIL)))))))))))))
+                                (#\s
+                                 &quot;plural of peanut; syndicated comic strip started in 1950&quot;
+                                 NIL))))))))))))))))
+    1: (TRIE-LOOKUP (#\n #\c #\e)
+                    (NIL
+                     ((#\n &quot;activated; not off&quot;
+                       ((#\c NIL ((#\e &quot;one time, and one time only&quot; NIL)))
+                        (#\e &quot;the English name for the numeral 1&quot;
+                         ((#\s &quot;plural of &apos;one&apos;&quot; NIL))))))))
+      2: (TRIE-LOOKUP (#\c #\e)
+                      (&quot;activated; not off&quot;
+                       ((#\c NIL ((#\e &quot;one time, and one time only&quot; NIL)))
+                        (#\e &quot;the English name for the numeral 1&quot;
+                         ((#\s &quot;plural of &apos;one&apos;&quot; NIL))))))
+        3: (TRIE-LOOKUP (#\e) (NIL ((#\e &quot;one time, and one time only&quot; NIL))))
+          4: (TRIE-LOOKUP NIL (&quot;one time, and one time only&quot; NIL))
+          4: TRIE-LOOKUP returned &quot;one time, and one time only&quot;
+        3: TRIE-LOOKUP returned &quot;one time, and one time only&quot;
+      2: TRIE-LOOKUP returned &quot;one time, and one time only&quot;
+    1: TRIE-LOOKUP returned &quot;one time, and one time only&quot;
+  0: TRIE-LOOKUP returned &quot;one time, and one time only&quot;
+&quot;one time, and one time only&quot;
+
+* (rec-string-assoc &quot;once&quot; *alist*)
+  0: (REC-STRING-ASSOC &quot;once&quot;
+                       ((&quot;p&quot; . &quot;the 16th letter of the English alphabet&quot;)
+                        (&quot;pea&quot;
+                         . &quot;the small spherical seed or the seed-pod of the pod fruit Pisum sativum&quot;)
+                        (&quot;peanut&quot; . &quot;a plant species in the legume family&quot;)
+                        (&quot;peanuts&quot;
+                         . &quot;plural of peanut; syndicated comic strip started in 1950&quot;)
+                        (&quot;peanut butter&quot;
+                         . &quot;a creamy delight commonly used in sandwiches&quot;)
+                        (&quot;on&quot; . &quot;activated; not off&quot;)
+                        (&quot;one&quot; . &quot;the English name for the numeral 1&quot;)
+                        (&quot;ones&quot; . &quot;plural of &apos;one&apos;&quot;)
+                        (&quot;once&quot; . &quot;one time, and one time only&quot;)))
+    1: (REC-STRING-ASSOC &quot;once&quot;
+                         ((&quot;pea&quot;
+                           . &quot;the small spherical seed or the seed-pod of the pod fruit Pisum sativum&quot;)
+                          (&quot;peanut&quot; . &quot;a plant species in the legume family&quot;)
+                          (&quot;peanuts&quot;
+                           . &quot;plural of peanut; syndicated comic strip started in 1950&quot;)
+                          (&quot;peanut butter&quot;
+                           . &quot;a creamy delight commonly used in sandwiches&quot;)
+                          (&quot;on&quot; . &quot;activated; not off&quot;)
+                          (&quot;one&quot; . &quot;the English name for the numeral 1&quot;)
+                          (&quot;ones&quot; . &quot;plural of &apos;one&apos;&quot;)
+                          (&quot;once&quot; . &quot;one time, and one time only&quot;)))
+      2: (REC-STRING-ASSOC &quot;once&quot;
+                           ((&quot;peanut&quot; . &quot;a plant species in the legume family&quot;)
+                            (&quot;peanuts&quot;
+                             . &quot;plural of peanut; syndicated comic strip started in 1950&quot;)
+                            (&quot;peanut butter&quot;
+                             . &quot;a creamy delight commonly used in sandwiches&quot;)
+                            (&quot;on&quot; . &quot;activated; not off&quot;)
+                            (&quot;one&quot; . &quot;the English name for the numeral 1&quot;)
+                            (&quot;ones&quot; . &quot;plural of &apos;one&apos;&quot;)
+                            (&quot;once&quot; . &quot;one time, and one time only&quot;)))
+        3: (REC-STRING-ASSOC &quot;once&quot;
+                             ((&quot;peanuts&quot;
+                               . &quot;plural of peanut; syndicated comic strip started in 1950&quot;)
+                              (&quot;peanut butter&quot;
+                               . &quot;a creamy delight commonly used in sandwiches&quot;)
+                              (&quot;on&quot; . &quot;activated; not off&quot;)
+                              (&quot;one&quot; . &quot;the English name for the numeral 1&quot;)
+                              (&quot;ones&quot; . &quot;plural of &apos;one&apos;&quot;)
+                              (&quot;once&quot; . &quot;one time, and one time only&quot;)))
+          4: (REC-STRING-ASSOC &quot;once&quot;
+                               ((&quot;peanut butter&quot;
+                                 . &quot;a creamy delight commonly used in sandwiches&quot;)
+                                (&quot;on&quot; . &quot;activated; not off&quot;)
+                                (&quot;one&quot; . &quot;the English name for the numeral 1&quot;)
+                                (&quot;ones&quot; . &quot;plural of &apos;one&apos;&quot;)
+                                (&quot;once&quot; . &quot;one time, and one time only&quot;)))
+            5: (REC-STRING-ASSOC &quot;once&quot;
+                                 ((&quot;on&quot; . &quot;activated; not off&quot;)
+                                  (&quot;one&quot;
+                                   . &quot;the English name for the numeral 1&quot;)
+                                  (&quot;ones&quot; . &quot;plural of &apos;one&apos;&quot;)
+                                  (&quot;once&quot; . &quot;one time, and one time only&quot;)))
+              6: (REC-STRING-ASSOC &quot;once&quot;
+                                   ((&quot;one&quot;
+                                     . &quot;the English name for the numeral 1&quot;)
+                                    (&quot;ones&quot; . &quot;plural of &apos;one&apos;&quot;)
+                                    (&quot;once&quot; . &quot;one time, and one time only&quot;)))
+                7: (REC-STRING-ASSOC &quot;once&quot;
+                                     ((&quot;ones&quot; . &quot;plural of &apos;one&apos;&quot;)
+                                      (&quot;once&quot; . &quot;one time, and one time only&quot;)))
+                  8: (REC-STRING-ASSOC &quot;once&quot;
+                                       ((&quot;once&quot;
+                                         . &quot;one time, and one time only&quot;)))
+                  8: REC-STRING-ASSOC returned
+                       (&quot;once&quot; . &quot;one time, and one time only&quot;)
+                7: REC-STRING-ASSOC returned
+                     (&quot;once&quot; . &quot;one time, and one time only&quot;)
+              6: REC-STRING-ASSOC returned
+                   (&quot;once&quot; . &quot;one time, and one time only&quot;)
+            5: REC-STRING-ASSOC returned
+                 (&quot;once&quot; . &quot;one time, and one time only&quot;)
+          4: REC-STRING-ASSOC returned (&quot;once&quot; . &quot;one time, and one time only&quot;)
+        3: REC-STRING-ASSOC returned (&quot;once&quot; . &quot;one time, and one time only&quot;)
+      2: REC-STRING-ASSOC returned (&quot;once&quot; . &quot;one time, and one time only&quot;)
+    1: REC-STRING-ASSOC returned (&quot;once&quot; . &quot;one time, and one time only&quot;)
+  0: REC-STRING-ASSOC returned (&quot;once&quot; . &quot;one time, and one time only&quot;)
+(&quot;once&quot; . &quot;one time, and one time only&quot;)
+
+* (untrace rec-string-assoc trie-lookup)
+T
+</code></pre><p>As you can see, we&apos;ve got a similar situation here. When using a Trie to store our keys, we can essentially ignore groups of values for the purposes of doing a lookup. Which lets us do lookups in much better than linear time.</p>
+<h3 id="exercise-1513">Exercise 1.5.13</h3>
+<p><strong>Even More Tries</strong></p>
+<p>Completely apart from basic lookup performance, which is good but not all-important, Tries let us compute completions fairly cheaply. In the definition of <code>trie-lookup</code> we&apos;ve already seen, walking the trie is conflated with getting a particular value out...</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">defun</span> trie-lookup (<span class="hljs-name">key-parts</span> trie)
+  (<span class="hljs-name">if</span> (<span class="hljs-name">null</span> key-parts)
+      (<span class="hljs-name">trie-value</span> trie)
+      (<span class="hljs-name">let</span> ((<span class="hljs-name">next</span> (<span class="hljs-name">trie-assoc</span> (<span class="hljs-name">first</span> key-parts) trie)))
+    (<span class="hljs-name">when</span> next
+      (<span class="hljs-name">trie-lookup</span> (<span class="hljs-name">rest</span> key-parts) next)))))
+</code></pre>
+<p>...but it doesn&apos;t have to be.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defun</span> trie-walk (<span class="hljs-name">key-parts</span> trie)
+    (<span class="hljs-name">if</span> (<span class="hljs-name">null</span> key-parts)
+        trie
+        (<span class="hljs-name">let</span> ((<span class="hljs-name">next</span> (<span class="hljs-name">trie-assoc</span> (<span class="hljs-name">first</span> key-parts) trie)))
+          (<span class="hljs-name">when</span> next
+            (<span class="hljs-name">trie-walk</span> (<span class="hljs-name">rest</span> key-parts) next)))))
+TRIE-WALK
+
+* (<span class="hljs-name">trie-walk</span> (<span class="hljs-name">coerce</span> <span class="hljs-string">&quot;on&quot;</span> &apos;list) *trie*)
+(<span class="hljs-string">&quot;activated; not off&quot;</span>
+ ((<span class="hljs-name">#</span>\c NIL ((<span class="hljs-name">#</span>\e <span class="hljs-string">&quot;one time, and one time only&quot;</span> NIL)))
+  (<span class="hljs-name">#</span>\e <span class="hljs-string">&quot;the English name for the numeral 1&quot;</span> ((<span class="hljs-name">#</span>\s <span class="hljs-string">&quot;plural of &apos;one&apos;&quot;</span> NIL)))))
+
+* (<span class="hljs-name">defun</span> trie-lookup (<span class="hljs-name">key-parts</span> trie)
+    (<span class="hljs-name">trie-value</span> (<span class="hljs-name">trie-walk</span> key-parts trie)))
+TRIE-LOOKUP
+</code></pre>
+<p>With a definition of <code>trie-walk</code> so decoupled, we can now do the pre-order traversal and come out with a list of contained keys that start with the components we pass in.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defun</span> trie-completions (<span class="hljs-name">key-parts</span> trie)
+    (<span class="hljs-name">labels</span> ((<span class="hljs-name">recur</span> (<span class="hljs-name">path</span> trie)
+               (<span class="hljs-name">let</span> ((<span class="hljs-name">rest</span> (<span class="hljs-name">loop</span> for (<span class="hljs-name">k</span> . sub-trie) in (<span class="hljs-name">trie-table</span> trie)
+                              append (<span class="hljs-name">recur</span> (<span class="hljs-name">append</span> path (<span class="hljs-name">list</span> k)) sub-trie)) ))
+                 (<span class="hljs-name">if</span> (<span class="hljs-name">trie-value</span> trie)
+                     (<span class="hljs-name">cons</span> path rest)
+                     rest))))
+      (<span class="hljs-name">recur</span> key-parts (<span class="hljs-name">trie-walk</span> key-parts trie))))
+TRIE-COMPLETIONS
+
+* (<span class="hljs-name">trie-completions</span> (<span class="hljs-name">coerce</span> <span class="hljs-string">&quot;on&quot;</span> &apos;list) *trie*)
+((<span class="hljs-name">#</span>\o #\n) (<span class="hljs-name">#</span>\o #\n #\c #\e) (<span class="hljs-name">#</span>\o #\n #\e) (<span class="hljs-name">#</span>\o #\n #\e #\s))
+</code></pre>
+<p>There are a couple of other ways we can vary Trie implementations. Firstly, we can change the representation of our <code>trie-map</code>. In all of the above examples, they&apos;re <code>alist</code>s, but that&apos;s not a requirement. It might be reasonable to make them <code>hash-table</code>s, or objects, or Trees, or even sub-Tries depending on our situation. Secondly, except for a few brief examples back in exercise 1.5.11, we&apos;ve been dealing with Tries whose keys are strings and decompose into characters. Other options are possible; for example the top level might be a phrase that decomposes into words, or numbers that decompose into bits.</p>
+<p>We won&apos;t be investigating any of the variations at the moment though; that might happen in later chapters.</p>
+<h3 id="exercise-1514">Exercise 1.5.14</h3>
+<p><strong>Hash Tables</strong></p>
+<p>Hash Tables are the standard constant-time lookup structure you&apos;re familiar with from other languages.</p>
+<pre><code class="lang-lisp">* (make-hash-table)
+#&lt;HASH-TABLE :TEST EQL :COUNT 0 {1003F59933}&gt;
+</code></pre>
+<p>Unlike the other table structures we&apos;ve taken a look at, there isn&apos;t really a non-destructive way to interact with a Hash Table. If you want to insert keys, you mutate the argument. You <em>could</em> copy the table out manually and add your new key to the copy, but that makes insertion take linear time. And you still have to do it manually; you don&apos;t get it for free the way you might with a Trie or <code>alist</code>.</p>
+<pre><code class="lang-lisp">* (let ((hash (make-hash-table)))
+    (setf (gethash &apos;a hash) 1
+          (gethash &apos;b hash) 2
+          (gethash &apos;c hash) 3)
+    hash)
+#&lt;HASH-TABLE :TEST EQL :COUNT 3 {1004099983}&gt;
+
+* (let ((hash (make-hash-table)))
+    (setf (gethash &apos;a hash) 1
+          (gethash &apos;b hash) 2
+          (gethash &apos;c hash) 3)
+    (gethash &apos;b hash))
+2
+T
+</code></pre>
+<p>There&apos;s no functional way to remove keys from hash tables either, other than the mentioned table-copying approach. Removing a key mutates the argument.</p>
+<pre><code class="lang-lisp">* (let ((hash (make-hash-table)))
+    (setf (gethash &apos;a hash) 1
+          (gethash &apos;b hash) 2
+          (gethash &apos;c hash) 3)
+    (remhash &apos;b hash)
+    hash)
+#&lt;HASH-TABLE :TEST EQL :COUNT 2 {100758CFB3}&gt;
+</code></pre>
+<p>There&apos;s a few different ways of iterating over a Hash Table, depending on specifically what you&apos;re up to. If you&apos;re looking to make some destructive changes, or maybe just print pairs, there&apos;s <code>maphash</code>.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">let</span> ((<span class="hljs-name">hash</span> (<span class="hljs-name">make-hash-table</span>)))
+    (<span class="hljs-name">setf</span> (<span class="hljs-name">gethash</span> &apos;a hash) <span class="hljs-number">1</span>
+          (<span class="hljs-name">gethash</span> &apos;b hash) <span class="hljs-number">2</span>
+          (<span class="hljs-name">gethash</span> &apos;c hash) <span class="hljs-number">3</span>)
+    (<span class="hljs-name">maphash</span> (<span class="hljs-name">lambda</span> (<span class="hljs-name">k</span> v) (<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;~a -&gt; ~a~%&quot;</span> k v)) hash))
+A -&gt; <span class="hljs-number">1</span>
+B -&gt; <span class="hljs-number">2</span>
+C -&gt; <span class="hljs-number">3</span>
+NIL
+</code></pre>
+<p>Note that <code>maphash</code> doesn&apos;t collect results, so you couldn&apos;t convert a Hash Table to an <code>alist</code> by calling it with <code>cons</code>.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">let</span> ((<span class="hljs-name">hash</span> (<span class="hljs-name">make-hash-table</span>)))
+    (<span class="hljs-name">setf</span> (<span class="hljs-name">gethash</span> &apos;a hash) <span class="hljs-number">1</span>
+          (<span class="hljs-name">gethash</span> &apos;b hash) <span class="hljs-number">2</span>
+          (<span class="hljs-name">gethash</span> &apos;c hash) <span class="hljs-number">3</span>)
+    (<span class="hljs-name">maphash</span> #&apos;cons hash))
+NIL
+</code></pre>
+<p>If you wanted that, you&apos;d either need to use some functions from <a href="https://llthw.common-lisp.dev/TODO%20link%20to%20alexandria%20chapter"><code>alexandria</code></a>, or a specific piece of <a href="https://llthw.common-lisp.dev/TODO%20link%20to%20the%20loop%20section%20(assuming%20there%20is%20one"><code>loop</code></a>)...</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">let</span> ((<span class="hljs-name">hash</span> (<span class="hljs-name">make-hash-table</span>)))
+    (<span class="hljs-name">setf</span> (<span class="hljs-name">gethash</span> &apos;a hash) <span class="hljs-number">1</span>
+          (<span class="hljs-name">gethash</span> &apos;b hash) <span class="hljs-number">2</span>
+          (<span class="hljs-name">gethash</span> &apos;c hash) <span class="hljs-number">3</span>)
+    (<span class="hljs-name">loop</span> for k being the hash-keys of hash
+       for v being the hash-values of hash
+       collect (<span class="hljs-name">cons</span> k v)))
+((<span class="hljs-name">A</span> . <span class="hljs-number">1</span>) (<span class="hljs-name">B</span> . <span class="hljs-number">2</span>) (<span class="hljs-name">C</span> . <span class="hljs-number">3</span>))
+</code></pre>
+<p>... or you&apos;d set up your own accumulator explicitly.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">let</span> ((<span class="hljs-name">hash</span> (<span class="hljs-name">make-hash-table</span>))
+        (<span class="hljs-name">acc</span> <span class="hljs-literal">nil</span>))
+    (<span class="hljs-name">setf</span> (<span class="hljs-name">gethash</span> &apos;a hash) <span class="hljs-number">1</span>
+          (<span class="hljs-name">gethash</span> &apos;b hash) <span class="hljs-number">2</span>
+          (<span class="hljs-name">gethash</span> &apos;c hash) <span class="hljs-number">3</span>)
+    (<span class="hljs-name">maphash</span> (<span class="hljs-name">lambda</span> (<span class="hljs-name">k</span> v) (<span class="hljs-name">push</span> (<span class="hljs-name">cons</span> k v) acc)) hash)
+    acc)
+((<span class="hljs-name">C</span> . <span class="hljs-number">3</span>) (<span class="hljs-name">B</span> . <span class="hljs-number">2</span>) (<span class="hljs-name">A</span> . <span class="hljs-number">1</span>))
+</code></pre>
+<h3 id="exercise-1515">Exercise 1.5.15</h3>
+<p><strong>Object Reference</strong></p>
+<p>Speaking of Objects, there are two constructs in Common Lisp that give you some behaviors you might expect from them; <code>class</code>es and <code>struct</code>s. This exercise won&apos;t be a complete treatment, but will show you the basics.</p>
+<pre><code class="lang-lisp">* (defclass foo ()
+    ((a :initform 1)
+     (b :initform 2)
+     (c :initform 3)))
+#&lt;STANDARD-CLASS FOO&gt;
+
+* (make-instance &apos;foo)
+#&lt;FOO {10058567E3}&gt;
+
+* (slot-value (make-instance &apos;foo) &apos;a)
+1
+
+* (slot-value (make-instance &apos;foo) &apos;c)
+3
+</code></pre>
+<p>Instead of using <code>slot-value</code>, it&apos;s possible to define reader and accessor functions for individual slots.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defclass</span> bar ()
+       ((<span class="hljs-name">a</span> <span class="hljs-symbol">:initform</span> <span class="hljs-number">1</span> <span class="hljs-symbol">:reader</span> a)
+        (<span class="hljs-name">b</span> <span class="hljs-symbol">:initform</span> <span class="hljs-number">2</span> <span class="hljs-symbol">:accessor</span> b)
+        (<span class="hljs-name">c</span> <span class="hljs-symbol">:initform</span> <span class="hljs-number">3</span>)))
+#&lt;STANDARD-CLASS BAR&gt;
+
+* (<span class="hljs-name">a</span> (<span class="hljs-name">make-instance</span> &apos;bar))
+<span class="hljs-number">1</span>
+
+* (<span class="hljs-name">b</span> (<span class="hljs-name">make-instance</span> &apos;bar))
+<span class="hljs-number">2</span>
+</code></pre>
+<p>A <code>reader</code> is basically just a getter function. You can&apos;t set its value directly.</p>
+<pre><code class="lang-lisp">* (defparameter *instance* (make-instance &apos;bar))
+*INSTANCE*
+
+* *instance*
+#&lt;BAR {1005F806E3}&gt;
+
+* (a *instance*)
+1
+
+* (setf (a *instance*) 32)
+ Evaluation aborted on #&lt;UNDEFINED-FUNCTION (SETF A) {1005DCB833}&gt;.
+</code></pre>
+<p>An <code>accessor</code> on the other hand, is both a getter and a setter. So you can both read and assign through the interface it sets up.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">b</span> *instance*)
+<span class="hljs-number">2</span>
+
+* (<span class="hljs-name">setf</span> (<span class="hljs-name">b</span> *instance*) <span class="hljs-number">32</span>)
+<span class="hljs-number">32</span>
+
+* (<span class="hljs-name">b</span> *instance*)
+<span class="hljs-number">32</span>
+</code></pre>
+<p>This isn&apos;t the same as setting public or private methods though. Even if you don&apos;t expose an accessor, it&apos;s possible to set a slots&apos; value using the <code>slot-value</code> function.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">setf</span> (<span class="hljs-name">slot-value</span> *instance* &apos;a) <span class="hljs-number">16</span>)
+<span class="hljs-number">16</span>
+
+* (<span class="hljs-name">a</span> *instance*)
+<span class="hljs-number">16</span>
+</code></pre>
+<p>Unlike the key--value constructs we&apos;ve seen so far, there isn&apos;t an easy and portable (across Common Lisp implementations) way to iterate over keys and values. If you want that, you&apos;re stuck doing something a touch hacky. In real life, it would be <em>a bit</em> less hacky (see <a href="https://github.com/Inaimathi/cl-mop/blob/master/package.lisp" target="_blank">here</a> for what you&apos;d really do), but we haven&apos;t covered packages yet.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defun</span> class-slots (<span class="hljs-name">class</span>)
+    #+openmcl-native-threads (<span class="hljs-name">ccl</span><span class="hljs-symbol">:class-slots</span> class)
+    #+cmu (<span class="hljs-name">pcl</span><span class="hljs-symbol">:class-slots</span> class)
+    #+sbcl (<span class="hljs-name">sb-pcl</span><span class="hljs-symbol">:class-slots</span> class)
+    #+lispworks (<span class="hljs-name">hcl</span><span class="hljs-symbol">:class-slots</span> class)
+    #+allegro (<span class="hljs-name">mop</span><span class="hljs-symbol">:class-slots</span> class)
+    #+clisp (<span class="hljs-name">clos</span><span class="hljs-symbol">:class-slots</span> class))
+CLASS-SLOTS
+
+* (<span class="hljs-name">defun</span> slot-definition-name (<span class="hljs-name">slot</span>)
+    #+openmcl-native-threads (<span class="hljs-name">ccl</span><span class="hljs-symbol">:slot-definition-name</span> slot)
+    #+cmu (<span class="hljs-name">pcl</span><span class="hljs-symbol">:slot-definition-name</span> slot)
+    #+sbcl (<span class="hljs-name">sb-pcl</span><span class="hljs-symbol">:slot-definition-name</span> slot)
+    #+lispworks (<span class="hljs-name">hcl</span><span class="hljs-symbol">:slot-definition-name</span> slot)
+    #+allegro (<span class="hljs-name">mop</span><span class="hljs-symbol">:slot-definition-name</span> slot)
+    #+clisp (<span class="hljs-name">clos</span><span class="hljs-symbol">:slot-definition-name</span> slot))
+
+* (<span class="hljs-name">defun</span> map-slots (<span class="hljs-name">fn</span> instance)
+    (<span class="hljs-name">loop</span> for slot in (<span class="hljs-name">class-slots</span> (<span class="hljs-name">class-of</span> instance))
+       for slot-name = (<span class="hljs-name">slot-definition-name</span> slot)
+       collect (<span class="hljs-name">when</span> (<span class="hljs-name">slot-boundp</span> instance slot-name)
+                 (<span class="hljs-name">funcall</span> fn slot-name (<span class="hljs-name">slot-value</span> instance slot-name)))))
+MAP-SLOTS
+
+* (<span class="hljs-name">map-slots</span> (<span class="hljs-name">lambda</span> (<span class="hljs-name">k</span> v) (<span class="hljs-name">list</span> k v)) *instance*)
+((<span class="hljs-name">A</span> <span class="hljs-number">16</span>) (<span class="hljs-name">B</span> <span class="hljs-number">32</span>) (<span class="hljs-name">C</span> <span class="hljs-number">3</span>))
+</code></pre>
+<h3 id="exercise-1516">Exercise 1.5.16</h3>
+<p><strong>Acyclic Graphs</strong></p>
+<p>(TODO)</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-04-0-lists.html" class="navigation navigation-prev " aria-label="Previous page: Lists and List-Operations">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-06-0-math.html" class="navigation navigation-next " aria-label="Next page: Numbers and Math">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Extra Credit: Look-up Lists and Trees","level":"3.1.5","depth":2,"next":{"title":"Numbers and Math","level":"3.1.6","depth":2,"path":"1-06-0-math.md","ref":"./1-06-0-math.md","articles":[{"title":"Integers","level":"3.1.6.1","depth":3,"path":"1-06-01-integers.md","ref":"./1-06-01-integers.md","articles":[]},{"title":"More Integers","level":"3.1.6.2","depth":3,"path":"1-06-02-more-integers.md","ref":"./1-06-02-more-integers.md","articles":[]},{"title":"Hexadecimal Integer Notation","level":"3.1.6.3","depth":3,"path":"1-06-03-hexadecimal-notation.md","ref":"./1-06-03-hexadecimal-notation.md","articles":[]},{"title":"Octal Integer Notation","level":"3.1.6.4","depth":3,"path":"1-06-04-octal-notation.md","ref":"./1-06-04-octal-notation.md","articles":[]},{"title":"Binary Integer Notation","level":"3.1.6.5","depth":3,"path":"1-06-05-binary-notation.md","ref":"./1-06-05-binary-notation.md","articles":[]},{"title":"Ratios and Rational Numbers","level":"3.1.6.6","depth":3,"path":"1-06-06-ratios.md","ref":"./1-06-06-ratios.md","articles":[]},{"title":"Floating-point Numbers","level":"3.1.6.7","depth":3,"path":"1-06-07-floating-point.md","ref":"./1-06-07-floating-point.md","articles":[]},{"title":"Numeric Constants","level":"3.1.6.8","depth":3,"path":"1-06-08-constants.md","ref":"./1-06-08-constants.md","articles":[]},{"title":"Complex Numbers","level":"3.1.6.9","depth":3,"path":"1-06-09-complex-numbers.md","ref":"./1-06-09-complex-numbers.md","articles":[]},{"title":"Arithmetic","level":"3.1.6.10","depth":3,"path":"1-06-10-arithmetic.md","ref":"./1-06-10-arithmetic.md","articles":[]},{"title":"More Arithmetic","level":"3.1.6.11","depth":3,"path":"1-06-11-more-arithmetic.md","ref":"./1-06-11-more-arithmetic.md","articles":[]},{"title":"Even More Arithmetic","level":"3.1.6.12","depth":3,"path":"1-06-12-even-more-arithmetic.md","ref":"./1-06-12-even-more-arithmetic.md","articles":[]},{"title":"Exponents","level":"3.1.6.13","depth":3,"path":"1-06-13-exponents.md","ref":"./1-06-13-exponents.md","articles":[]},{"title":"Logarithms","level":"3.1.6.14","depth":3,"path":"1-06-14-logarithms.md","ref":"./1-06-14-logarithms.md","articles":[]},{"title":"Trigonometry","level":"3.1.6.15","depth":3,"path":"1-06-15-trigonometry.md","ref":"./1-06-15-trigonometry.md","articles":[]},{"title":"Pseudo-Random Numbers","level":"3.1.6.16","depth":3,"path":"1-06-16-psuedorandom-numbers.md","ref":"./1-06-16-psuedorandom-numbers.md","articles":[]}]},"previous":{"title":"Lists and List-Operations","level":"3.1.4","depth":2,"path":"1-04-0-lists.md","ref":"./1-04-0-lists.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-05-0-lookups-trees.md","mtime":"2022-08-22T22:47:49.767Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-06-0-math.html b/clones/llthw.common-lisp.dev/1-06-0-math.html
new file mode 100644
index 00000000..8def64a9
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-06-0-math.html
@@ -0,0 +1,1856 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Numbers and Math · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-06-01-integers.html" />
+    
+    
+    <link rel="prev" href="1-05-0-lookups-trees.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Numbers and Math</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h2 id="chapter-16">Chapter 1.6</h2>
+<h1 id="numbers-and-math">Numbers and Math</h1>
+<blockquote>
+<p>&quot;The 3-legged stool of understanding is held up by history, languages, and mathematics. Equipped with these three you can learn anything you want to learn.&quot;</p>
+<footer>Robert A. Heinlein, <em>The Happy Days Ahead, Expanded Universe</em></footer>
+
+</blockquote>
+<p>Common Lisp comes complete with a rigorous collection of mathematical tools, and excellent handling of Big Integers and Long-Floats---enabling Lisp software to leverage powerful number crunching facilities, perform statistical analysis, scientific computing, efficient cryptography, and more. All the functions, macros, and types presented in this chapter are a part of the language itself, and do not have to be specially imported from a separate standard library to be used.</p>
+<p>In this chapter, we will review the numeric types available in Common Lisp, their built in notations, and cover the core mathematical functionality in the Common Lisp standard.</p>
+<h3 id="exercises">Exercises</h3>
+<ul>
+<li><a href="1-06-01-integers.html">Integers</a></li>
+<li><a href="1-06-02-more-integers.html">More Integers</a></li>
+<li><a href="1-06-03-hexadecimal-notation.html">Hexadecimal Integer Notation</a></li>
+<li><a href="1-06-04-octal-notation.html">Octal Integer Notation</a></li>
+<li><a href="1-06-05-binary-notation.html">Binary Integer Notation</a></li>
+<li><a href="1-06-06-ratios.html">Ratios and Rational Numbers</a></li>
+<li><a href="1-06-07-floating-point.html">Floating-point Numbers</a></li>
+<li><a href="1-06-08-constants.html">Numeric Constants</a></li>
+<li><a href="1-06-09-complex-numbers.html">Complex Numbers</a></li>
+<li><a href="1-06-10-arithmetic.html">Arithmetic</a></li>
+<li><a href="1-06-11-more-arithmetic.html">More Arithmetic</a></li>
+<li><a href="1-06-12-even-more-arithmetic.html">Even More Arithmetic</a></li>
+<li><a href="1-06-13-exponents.html">Exponents</a></li>
+<li><a href="1-06-14-logarithms.html">Logarithms</a></li>
+<li><a href="1-06-15-trigonometry.html">Trigonometry</a></li>
+<li><a href="1-06-16-psuedorandom-numbers.html">Pseudo-Random Numbers</a></li>
+</ul>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-05-0-lookups-trees.html" class="navigation navigation-prev " aria-label="Previous page: Extra Credit: Look-up Lists and Trees">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-06-01-integers.html" class="navigation navigation-next " aria-label="Next page: Integers">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Numbers and Math","level":"3.1.6","depth":2,"next":{"title":"Integers","level":"3.1.6.1","depth":3,"path":"1-06-01-integers.md","ref":"./1-06-01-integers.md","articles":[]},"previous":{"title":"Extra Credit: Look-up Lists and Trees","level":"3.1.5","depth":2,"path":"1-05-0-lookups-trees.md","ref":"./1-05-0-lookups-trees.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-06-0-math.md","mtime":"2022-08-22T20:30:41.987Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-06-01-integers.html b/clones/llthw.common-lisp.dev/1-06-01-integers.html
new file mode 100644
index 00000000..0f2996c6
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-06-01-integers.html
@@ -0,0 +1,1865 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Integers · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-06-02-more-integers.html" />
+    
+    
+    <link rel="prev" href="1-06-0-math.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter active" data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Integers</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-161">Exercise 1.6.1</h1>
+<h2 id="integers">Integers</h2>
+<h3 id="in-the-repl">In the REPL</h3>
+<pre><code class="lang-lisp"><span class="hljs-number">5</span>
+
+<span class="hljs-number">-5</span>
+
+<span class="hljs-number">1</span>
+
+<span class="hljs-number">1234567890123456789012345678901234567890</span>
+
+(<span class="hljs-name">expt</span> <span class="hljs-number">1234567890123456789012345678901234567890</span> <span class="hljs-number">2</span>)
+
+(<span class="hljs-name">expt</span> <span class="hljs-number">1234567890123456789012345678901234567890</span> <span class="hljs-number">147</span>)
+
+(<span class="hljs-name">expt</span> <span class="hljs-number">-1234567890123456789012345678901234567890</span> <span class="hljs-number">147</span>)
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<p>An integer can be positive or negative.</p>
+<pre><code class="lang-lisp">* <span class="hljs-number">5</span>
+<span class="hljs-number">5</span>
+
+* <span class="hljs-number">-5</span>
+<span class="hljs-number">-5</span>
+</code></pre>
+<p>It can also be any size.</p>
+<pre><code class="lang-lisp">* <span class="hljs-number">1</span>
+<span class="hljs-number">1</span>
+
+* <span class="hljs-number">1234567890123456789012345678901234567890</span>
+<span class="hljs-number">1234567890123456789012345678901234567890</span>
+
+* (<span class="hljs-name">expt</span> <span class="hljs-number">1234567890123456789012345678901234567890</span> <span class="hljs-number">2</span>)
+<span class="hljs-number">1524157875323883675049535156256668194500533455762536198787501905199875019052100</span>
+</code></pre>
+<p>Give the last two examples a try as well, but sadly I can&apos;t show them because
+GitBook can&apos;t parse numbers that big to typeset them. But Lisp sure can.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-06-0-math.html" class="navigation navigation-prev " aria-label="Previous page: Numbers and Math">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-06-02-more-integers.html" class="navigation navigation-next " aria-label="Next page: More Integers">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Integers","level":"3.1.6.1","depth":3,"next":{"title":"More Integers","level":"3.1.6.2","depth":3,"path":"1-06-02-more-integers.md","ref":"./1-06-02-more-integers.md","articles":[]},"previous":{"title":"Numbers and Math","level":"3.1.6","depth":2,"path":"1-06-0-math.md","ref":"./1-06-0-math.md","articles":[{"title":"Integers","level":"3.1.6.1","depth":3,"path":"1-06-01-integers.md","ref":"./1-06-01-integers.md","articles":[]},{"title":"More Integers","level":"3.1.6.2","depth":3,"path":"1-06-02-more-integers.md","ref":"./1-06-02-more-integers.md","articles":[]},{"title":"Hexadecimal Integer Notation","level":"3.1.6.3","depth":3,"path":"1-06-03-hexadecimal-notation.md","ref":"./1-06-03-hexadecimal-notation.md","articles":[]},{"title":"Octal Integer Notation","level":"3.1.6.4","depth":3,"path":"1-06-04-octal-notation.md","ref":"./1-06-04-octal-notation.md","articles":[]},{"title":"Binary Integer Notation","level":"3.1.6.5","depth":3,"path":"1-06-05-binary-notation.md","ref":"./1-06-05-binary-notation.md","articles":[]},{"title":"Ratios and Rational Numbers","level":"3.1.6.6","depth":3,"path":"1-06-06-ratios.md","ref":"./1-06-06-ratios.md","articles":[]},{"title":"Floating-point Numbers","level":"3.1.6.7","depth":3,"path":"1-06-07-floating-point.md","ref":"./1-06-07-floating-point.md","articles":[]},{"title":"Numeric Constants","level":"3.1.6.8","depth":3,"path":"1-06-08-constants.md","ref":"./1-06-08-constants.md","articles":[]},{"title":"Complex Numbers","level":"3.1.6.9","depth":3,"path":"1-06-09-complex-numbers.md","ref":"./1-06-09-complex-numbers.md","articles":[]},{"title":"Arithmetic","level":"3.1.6.10","depth":3,"path":"1-06-10-arithmetic.md","ref":"./1-06-10-arithmetic.md","articles":[]},{"title":"More Arithmetic","level":"3.1.6.11","depth":3,"path":"1-06-11-more-arithmetic.md","ref":"./1-06-11-more-arithmetic.md","articles":[]},{"title":"Even More Arithmetic","level":"3.1.6.12","depth":3,"path":"1-06-12-even-more-arithmetic.md","ref":"./1-06-12-even-more-arithmetic.md","articles":[]},{"title":"Exponents","level":"3.1.6.13","depth":3,"path":"1-06-13-exponents.md","ref":"./1-06-13-exponents.md","articles":[]},{"title":"Logarithms","level":"3.1.6.14","depth":3,"path":"1-06-14-logarithms.md","ref":"./1-06-14-logarithms.md","articles":[]},{"title":"Trigonometry","level":"3.1.6.15","depth":3,"path":"1-06-15-trigonometry.md","ref":"./1-06-15-trigonometry.md","articles":[]},{"title":"Pseudo-Random Numbers","level":"3.1.6.16","depth":3,"path":"1-06-16-psuedorandom-numbers.md","ref":"./1-06-16-psuedorandom-numbers.md","articles":[]}]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-06-01-integers.md","mtime":"2022-08-22T21:08:51.281Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-06-02-more-integers.html b/clones/llthw.common-lisp.dev/1-06-02-more-integers.html
new file mode 100644
index 00000000..f9df4c5a
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-06-02-more-integers.html
@@ -0,0 +1,1863 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>More Integers · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-06-03-hexadecimal-notation.html" />
+    
+    
+    <link rel="prev" href="1-06-01-integers.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >More Integers</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-162">Exercise 1.6.2</h1>
+<h2 id="more-integers">More Integers</h2>
+<p>Of course, this doesn&apos;t mean they&apos;re always the same type internally. Various integers have different types based on their size to conserve space, though they are all usable interchangeably.</p>
+<h3 id="in-the-repl">In the REPL</h3>
+<pre><code class="lang-lisp">(<span class="hljs-name">type-of</span> <span class="hljs-number">1</span>)
+
+(<span class="hljs-name">type-of</span> <span class="hljs-number">1234567890123456789012345678901234567890</span>)
+
+(<span class="hljs-name">type-of</span> (<span class="hljs-name">expt</span> <span class="hljs-number">-1234567890123456789012345678901234567890</span> <span class="hljs-number">147</span>))
+
+(<span class="hljs-name">typep</span> <span class="hljs-number">1</span> &apos;integer)
+
+(<span class="hljs-name">typep</span> <span class="hljs-number">1234567890123456789012345678901234567890</span> &apos;integer)
+
+(<span class="hljs-name">typep</span> (<span class="hljs-name">expt</span> <span class="hljs-number">-1234567890123456789012345678901234567890</span> <span class="hljs-number">147</span>) &apos;integer)
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* (<span class="hljs-name">type-of</span> <span class="hljs-number">1</span>)
+BIT
+
+* (<span class="hljs-name">type-of</span> <span class="hljs-number">1234567890123456789012345678901234567890</span>)
+(<span class="hljs-name">INTEGER</span> <span class="hljs-number">4611686018427387904</span>)
+
+* (<span class="hljs-name">type-of</span> (<span class="hljs-name">expt</span> <span class="hljs-number">-1234567890123456789012345678901234567890</span> <span class="hljs-number">147</span>))
+BIGNUM
+
+* (<span class="hljs-name">typep</span> <span class="hljs-number">1</span> &apos;integer)
+T
+
+* (<span class="hljs-name">typep</span> <span class="hljs-number">1234567890123456789012345678901234567890</span> &apos;integer)
+T
+
+* (<span class="hljs-name">typep</span> (<span class="hljs-name">expt</span> <span class="hljs-number">-1234567890123456789012345678901234567890</span> <span class="hljs-number">147</span>) &apos;integer)
+T
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-06-01-integers.html" class="navigation navigation-prev " aria-label="Previous page: Integers">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-06-03-hexadecimal-notation.html" class="navigation navigation-next " aria-label="Next page: Hexadecimal Integer Notation">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"More Integers","level":"3.1.6.2","depth":3,"next":{"title":"Hexadecimal Integer Notation","level":"3.1.6.3","depth":3,"path":"1-06-03-hexadecimal-notation.md","ref":"./1-06-03-hexadecimal-notation.md","articles":[]},"previous":{"title":"Integers","level":"3.1.6.1","depth":3,"path":"1-06-01-integers.md","ref":"./1-06-01-integers.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-06-02-more-integers.md","mtime":"2022-08-22T20:30:41.987Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-06-03-hexadecimal-notation.html b/clones/llthw.common-lisp.dev/1-06-03-hexadecimal-notation.html
new file mode 100644
index 00000000..c779f2d3
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-06-03-hexadecimal-notation.html
@@ -0,0 +1,1888 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Hexadecimal Integer Notation · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-06-04-octal-notation.html" />
+    
+    
+    <link rel="prev" href="1-06-02-more-integers.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Hexadecimal Integer Notation</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-163">Exercise 1.6.3</h1>
+<h2 id="hexadecimal-integer-notation">Hexadecimal Integer Notation</h2>
+<h3 id="in-the-repl">In the REPL</h3>
+<pre><code class="lang-lisp"><span class="hljs-number">#xFF</span>
+
+<span class="hljs-number">#x00</span>
+
+<span class="hljs-number">#x0123456789ABCDEF</span>
+
+(<span class="hljs-name">parse-integer</span> <span class="hljs-string">&quot;FF&quot;</span> <span class="hljs-symbol">:radix</span> <span class="hljs-number">16</span>)
+
+(<span class="hljs-name">parse-integer</span> <span class="hljs-string">&quot;0123456789ABCDEF&quot;</span> <span class="hljs-symbol">:radix</span> <span class="hljs-number">16</span>)
+
+(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~x&quot;</span> <span class="hljs-number">255</span>)
+
+(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~x&quot;</span> <span class="hljs-number">81985529216486895</span>)
+
+(<span class="hljs-name">type-of</span> <span class="hljs-number">#xFF</span>)
+
+(<span class="hljs-name">+</span> <span class="hljs-number">#xDEADBEEF</span> <span class="hljs-number">#xFF</span>)
+
+(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~x&quot;</span> <span class="hljs-number">#x0123456789ABCDEF</span>)
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<p>There exists a built-in reader macro to allow for hexadecimal literals.</p>
+<pre><code class="lang-lisp">* <span class="hljs-number">#xFF</span>
+<span class="hljs-number">255</span>
+
+* <span class="hljs-number">#x00</span>
+<span class="hljs-number">0</span>
+
+* <span class="hljs-number">#x0123456789ABCDEF</span>
+<span class="hljs-number">81985529216486895</span>
+</code></pre>
+<p>You also have access to appropriate options in <code>parse-integer</code> and <code>format</code> to read or write hexadecimal numbers.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">parse-integer</span> <span class="hljs-string">&quot;FF&quot;</span> <span class="hljs-symbol">:radix</span> <span class="hljs-number">16</span>)
+<span class="hljs-number">255</span>
+<span class="hljs-number">2</span>
+
+* (<span class="hljs-name">parse-integer</span> <span class="hljs-string">&quot;0123456789ABCDEF&quot;</span> <span class="hljs-symbol">:radix</span> <span class="hljs-number">16</span>)
+<span class="hljs-number">81985529216486895</span>
+<span class="hljs-number">16</span>
+
+* (<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~x&quot;</span> <span class="hljs-number">255</span>)
+<span class="hljs-string">&quot;FF&quot;</span>
+
+* (<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~x&quot;</span> <span class="hljs-number">81985529216486895</span>)
+<span class="hljs-string">&quot;123456789ABCDEF&quot;</span>
+</code></pre>
+<p>Of course, the reader macro expands into a number...</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">type-of</span> <span class="hljs-number">#xFF</span>)
+(<span class="hljs-name">INTEGER</span> <span class="hljs-number">0</span> <span class="hljs-number">4611686018427387903</span>)
+</code></pre>
+<p>...which means you can use it anywhere you can use numbers.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">+</span> <span class="hljs-number">#xDEADBEEF</span> <span class="hljs-number">#xFF</span>)
+<span class="hljs-number">3735928814</span>
+
+* (<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~x&quot;</span> <span class="hljs-number">#x0123456789ABCDEF</span>)
+<span class="hljs-string">&quot;123456789ABCDEF&quot;</span>
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-06-02-more-integers.html" class="navigation navigation-prev " aria-label="Previous page: More Integers">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-06-04-octal-notation.html" class="navigation navigation-next " aria-label="Next page: Octal Integer Notation">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Hexadecimal Integer Notation","level":"3.1.6.3","depth":3,"next":{"title":"Octal Integer Notation","level":"3.1.6.4","depth":3,"path":"1-06-04-octal-notation.md","ref":"./1-06-04-octal-notation.md","articles":[]},"previous":{"title":"More Integers","level":"3.1.6.2","depth":3,"path":"1-06-02-more-integers.md","ref":"./1-06-02-more-integers.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-06-03-hexadecimal-notation.md","mtime":"2022-08-22T21:08:51.281Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-06-04-octal-notation.html b/clones/llthw.common-lisp.dev/1-06-04-octal-notation.html
new file mode 100644
index 00000000..0ce1809d
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-06-04-octal-notation.html
@@ -0,0 +1,1888 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Octal Integer Notation · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-06-05-binary-notation.html" />
+    
+    
+    <link rel="prev" href="1-06-03-hexadecimal-notation.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Octal Integer Notation</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-164">Exercise 1.6.4</h1>
+<h2 id="octal-integer-notation">Octal Integer Notation</h2>
+<h3 id="in-the-repl">In the REPL</h3>
+<pre><code class="lang-lisp"><span class="hljs-number">#o77</span>
+
+<span class="hljs-number">#o00</span>
+
+<span class="hljs-number">#o01234567</span>
+
+(<span class="hljs-name">parse-integer</span> <span class="hljs-string">&quot;77&quot;</span> <span class="hljs-symbol">:radix</span> <span class="hljs-number">8</span>)
+
+(<span class="hljs-name">parse-integer</span> <span class="hljs-string">&quot;01234567&quot;</span> <span class="hljs-symbol">:radix</span> <span class="hljs-number">8</span>)
+
+(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~o&quot;</span> <span class="hljs-number">63</span>)
+
+(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~o&quot;</span> <span class="hljs-number">342391</span>)
+
+(<span class="hljs-name">type-of</span> <span class="hljs-number">#o77</span>)
+
+(<span class="hljs-name">+</span> <span class="hljs-number">#o123</span> <span class="hljs-number">#o456</span>)
+
+(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~o&quot;</span> <span class="hljs-number">#o01234567</span>)
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<p>There is also a built-in syntax for octal literals.</p>
+<pre><code class="lang-lisp">* <span class="hljs-number">#o77</span>
+<span class="hljs-number">63</span>
+
+* <span class="hljs-number">#o0</span>
+<span class="hljs-number">0</span>
+
+* <span class="hljs-number">#o01234567</span>
+<span class="hljs-number">342391</span>
+</code></pre>
+<p>There also exist appropriate supporting options in <code>parse-integer</code> and <code>format</code> to read or write octal numbers.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">parse-integer</span> <span class="hljs-string">&quot;77&quot;</span> <span class="hljs-symbol">:radix</span> <span class="hljs-number">8</span>)
+<span class="hljs-number">63</span>
+<span class="hljs-number">2</span>
+
+* (<span class="hljs-name">parse-integer</span> <span class="hljs-string">&quot;01234567&quot;</span> <span class="hljs-symbol">:radix</span> <span class="hljs-number">8</span>)
+<span class="hljs-number">342391</span>
+<span class="hljs-number">8</span>
+
+* (<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~o&quot;</span> <span class="hljs-number">63</span>)
+<span class="hljs-string">&quot;77&quot;</span>
+
+* (<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~o&quot;</span> <span class="hljs-number">342391</span>)
+<span class="hljs-string">&quot;1234567&quot;</span>
+</code></pre>
+<p>And again, the <code>#o</code> reader form expands into a number...</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">type-of</span> <span class="hljs-number">#o77</span>)
+(<span class="hljs-name">INTEGER</span> <span class="hljs-number">0</span> <span class="hljs-number">4611686018427387903</span>)
+</code></pre>
+<p>... which means you can use anywhere you could use numbers.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">+</span> <span class="hljs-number">#o123</span> <span class="hljs-number">#o456</span>)
+<span class="hljs-number">385</span>
+
+* (<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~o&quot;</span> <span class="hljs-number">#o01234567</span>)
+<span class="hljs-string">&quot;1234567&quot;</span>
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-06-03-hexadecimal-notation.html" class="navigation navigation-prev " aria-label="Previous page: Hexadecimal Integer Notation">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-06-05-binary-notation.html" class="navigation navigation-next " aria-label="Next page: Binary Integer Notation">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Octal Integer Notation","level":"3.1.6.4","depth":3,"next":{"title":"Binary Integer Notation","level":"3.1.6.5","depth":3,"path":"1-06-05-binary-notation.md","ref":"./1-06-05-binary-notation.md","articles":[]},"previous":{"title":"Hexadecimal Integer Notation","level":"3.1.6.3","depth":3,"path":"1-06-03-hexadecimal-notation.md","ref":"./1-06-03-hexadecimal-notation.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-06-04-octal-notation.md","mtime":"2022-08-22T21:08:51.281Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-06-05-binary-notation.html b/clones/llthw.common-lisp.dev/1-06-05-binary-notation.html
new file mode 100644
index 00000000..04299d05
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-06-05-binary-notation.html
@@ -0,0 +1,1893 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Binary Integer Notation · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-06-06-ratios.html" />
+    
+    
+    <link rel="prev" href="1-06-04-octal-notation.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Binary Integer Notation</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-165">Exercise 1.6.5</h1>
+<h2 id="binary-integer-notation">Binary Integer Notation</h2>
+<h3 id="in-the-repl">In the REPL</h3>
+<pre><code class="lang-lisp"><span class="hljs-number">#b1</span>
+
+<span class="hljs-number">#b1011</span>
+
+<span class="hljs-number">#b101010101</span>
+
+(<span class="hljs-name">parse-integer</span> <span class="hljs-string">&quot;1011&quot;</span> <span class="hljs-symbol">:radix</span> <span class="hljs-number">2</span>)
+
+(<span class="hljs-name">parse-integer</span> <span class="hljs-string">&quot;101010101&quot;</span> <span class="hljs-symbol">:radix</span> <span class="hljs-number">2</span>)
+
+(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~b&quot;</span> <span class="hljs-number">11</span>)
+
+(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~b&quot;</span> <span class="hljs-number">341</span>)
+
+(<span class="hljs-name">type-of</span> <span class="hljs-number">#b1</span>)
+
+(<span class="hljs-name">type-of</span> <span class="hljs-number">#b101</span>)
+
+(<span class="hljs-name">+</span> <span class="hljs-number">#b10101</span> <span class="hljs-number">#b101</span>)
+
+(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~b&quot;</span> <span class="hljs-number">#b101010101</span>)
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<p>Similarly, there is a binary literal notation.</p>
+<pre><code class="lang-lisp">* <span class="hljs-number">#b1</span>
+<span class="hljs-number">1</span>
+
+* <span class="hljs-number">#b1011</span>
+<span class="hljs-number">11</span>
+
+* <span class="hljs-number">#b101010101</span>
+<span class="hljs-number">341</span>
+</code></pre>
+<p><code>format</code> and <code>parse-integer</code> work nicely to encode and decode binary numbers.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">parse-integer</span> <span class="hljs-string">&quot;1011&quot;</span> <span class="hljs-symbol">:radix</span> <span class="hljs-number">2</span>)
+<span class="hljs-number">11</span>
+<span class="hljs-number">4</span>
+
+* (<span class="hljs-name">parse-integer</span> <span class="hljs-string">&quot;101010101&quot;</span> <span class="hljs-symbol">:radix</span> <span class="hljs-number">2</span>)
+<span class="hljs-number">341</span>
+<span class="hljs-number">9</span>
+
+* (<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~b&quot;</span> <span class="hljs-number">11</span>)
+<span class="hljs-string">&quot;1011&quot;</span>
+
+* (<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~b&quot;</span> <span class="hljs-number">341</span>)
+<span class="hljs-string">&quot;101010101&quot;</span>
+</code></pre>
+<p>And once again, the reader macro expands into a number.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">type-of</span> <span class="hljs-number">#b1</span>)
+BIT
+
+* (<span class="hljs-name">type-of</span> <span class="hljs-number">#b101</span>)
+(<span class="hljs-name">INTEGER</span> <span class="hljs-number">0</span> <span class="hljs-number">4611686018427387903</span>)
+</code></pre>
+<p>So all the usual number-related tricks are available.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">+</span> <span class="hljs-number">#b10101</span> <span class="hljs-number">#b101</span>)
+<span class="hljs-number">26</span>
+
+* (<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~b&quot;</span> <span class="hljs-number">#b101010101</span>)
+<span class="hljs-string">&quot;101010101&quot;</span>
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-06-04-octal-notation.html" class="navigation navigation-prev " aria-label="Previous page: Octal Integer Notation">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-06-06-ratios.html" class="navigation navigation-next " aria-label="Next page: Ratios and Rational Numbers">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Binary Integer Notation","level":"3.1.6.5","depth":3,"next":{"title":"Ratios and Rational Numbers","level":"3.1.6.6","depth":3,"path":"1-06-06-ratios.md","ref":"./1-06-06-ratios.md","articles":[]},"previous":{"title":"Octal Integer Notation","level":"3.1.6.4","depth":3,"path":"1-06-04-octal-notation.md","ref":"./1-06-04-octal-notation.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-06-05-binary-notation.md","mtime":"2022-08-22T20:42:47.765Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-06-06-ratios.html b/clones/llthw.common-lisp.dev/1-06-06-ratios.html
new file mode 100644
index 00000000..b7fa8c15
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-06-06-ratios.html
@@ -0,0 +1,1886 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Ratios and Rational Numbers · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-06-07-floating-point.html" />
+    
+    
+    <link rel="prev" href="1-06-05-binary-notation.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Ratios and Rational Numbers</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-166">Exercise 1.6.6</h1>
+<h2 id="ratios">Ratios</h2>
+<h3 id="in-the-repl">In the REPL</h3>
+<pre><code class="lang-lisp">3/17
+
+1/2
+
+(typep 1/2 &apos;integer)
+
+(typep 1/2 &apos;number)
+
+(type-of 1/2)
+
+.5
+
+(type-of .5)
+
+1/2
+
+4/8
+
+32/64
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<p>Ratios are a primitive numeric type in Common Lisp.</p>
+<pre><code class="lang-lisp">* <span class="hljs-number">3/17</span>
+<span class="hljs-number">3/17</span>
+
+* <span class="hljs-number">1/2</span>
+<span class="hljs-number">1/2</span>
+</code></pre>
+<p>Ratios are not integers, but they are still numbers.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">typep</span> <span class="hljs-number">1/2</span> &apos;integer)
+NIL
+
+* (<span class="hljs-name">typep</span> <span class="hljs-number">1/2</span> &apos;number)
+T
+</code></pre>
+<p>These are not the same things as their float equivalents.</p>
+<pre><code class="lang-lisp">* (type-of 1/2)
+RATIO
+
+* .5
+0.5
+
+* (type-of .5)
+SINGLE-FLOAT
+</code></pre>
+<p>They are always reduced to lowest terms.</p>
+<pre><code class="lang-lisp">* <span class="hljs-number">1/2</span>
+<span class="hljs-number">1/2</span>
+
+* <span class="hljs-number">4/8</span>
+<span class="hljs-number">1/2</span>
+
+* <span class="hljs-number">32/64</span>
+<span class="hljs-number">1/2</span>
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-06-05-binary-notation.html" class="navigation navigation-prev " aria-label="Previous page: Binary Integer Notation">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-06-07-floating-point.html" class="navigation navigation-next " aria-label="Next page: Floating-point Numbers">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Ratios and Rational Numbers","level":"3.1.6.6","depth":3,"next":{"title":"Floating-point Numbers","level":"3.1.6.7","depth":3,"path":"1-06-07-floating-point.md","ref":"./1-06-07-floating-point.md","articles":[]},"previous":{"title":"Binary Integer Notation","level":"3.1.6.5","depth":3,"path":"1-06-05-binary-notation.md","ref":"./1-06-05-binary-notation.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-06-06-ratios.md","mtime":"2022-08-22T20:30:41.987Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-06-07-floating-point.html b/clones/llthw.common-lisp.dev/1-06-07-floating-point.html
new file mode 100644
index 00000000..9210612c
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-06-07-floating-point.html
@@ -0,0 +1,1875 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Floating-point Numbers · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-06-08-constants.html" />
+    
+    
+    <link rel="prev" href="1-06-06-ratios.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Floating-point Numbers</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-167">Exercise 1.6.7</h1>
+<h2 id="floating-point-numbers">Floating-Point Numbers</h2>
+<h3 id="in-the-repl">In the REPL</h3>
+<pre><code class="lang-lisp">.1
+
+1.5
+
+1.1234
+
+(typep 1.1234 &apos;number)
+
+(typep 1.1234 &apos;integer)
+
+(type-of 1.1234)
+
+(/ 6.44444444444 2)
+
+(+ .5000001 .4000009)
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<p>Floating point numbers are also among the Common Lisp numeric types.</p>
+<pre><code class="lang-lisp">* .1
+0.1
+
+* 1.5
+1.5
+
+* 1.1234
+1.1234
+
+* (typep 1.1234 &apos;number)
+T
+
+* (typep 1.1234 &apos;integer)
+NIL
+
+* (type-of 1.1234)
+SINGLE-FLOAT
+</code></pre>
+<p>They suffer all the same precision issues here as in every other language you&apos;ve seen them at work.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">/</span> <span class="hljs-number">6.44444444444</span> <span class="hljs-number">2</span>)
+<span class="hljs-number">3.2222223</span>
+
+* (<span class="hljs-name">+</span> .<span class="hljs-number">5000001</span> .<span class="hljs-number">4000009</span>)
+<span class="hljs-number">0.90000105</span>
+</code></pre>
+<p>So, as always, careful.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-06-06-ratios.html" class="navigation navigation-prev " aria-label="Previous page: Ratios and Rational Numbers">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-06-08-constants.html" class="navigation navigation-next " aria-label="Next page: Numeric Constants">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Floating-point Numbers","level":"3.1.6.7","depth":3,"next":{"title":"Numeric Constants","level":"3.1.6.8","depth":3,"path":"1-06-08-constants.md","ref":"./1-06-08-constants.md","articles":[]},"previous":{"title":"Ratios and Rational Numbers","level":"3.1.6.6","depth":3,"path":"1-06-06-ratios.md","ref":"./1-06-06-ratios.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-06-07-floating-point.md","mtime":"2022-08-22T20:30:41.987Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-06-08-constants.html b/clones/llthw.common-lisp.dev/1-06-08-constants.html
new file mode 100644
index 00000000..b4bbb39a
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-06-08-constants.html
@@ -0,0 +1,1864 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Numeric Constants · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-06-09-complex-numbers.html" />
+    
+    
+    <link rel="prev" href="1-06-07-floating-point.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Numeric Constants</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-168">Exercise 1.6.8</h1>
+<h2 id="numeric-constants">Numeric Constants</h2>
+<h3 id="in-the-repl">In the REPL</h3>
+<pre><code class="lang-lisp">pi
+
+(<span class="hljs-name">=</span> pi pi)
+
+(<span class="hljs-name">eq</span> pi pi)
+
+(<span class="hljs-name">eql</span> pi pi)
+
+(<span class="hljs-name">equal</span> pi pi)
+
+(<span class="hljs-name">equalp</span> pi pi)
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<p>The constant <code>pi</code> is defined for you.</p>
+<pre><code class="lang-lisp">* pi
+<span class="hljs-number">3.141592653589793d0</span>
+</code></pre>
+<p>It&apos;s always equal to itself, obviously, but its exact representation depends on the float precision of a particular Lisp implementation.</p>
+<pre><code class="lang-lisp">* (<span class="hljs-name">=</span> pi pi)
+T
+
+* (<span class="hljs-name">eq</span> pi pi)
+T
+
+* (<span class="hljs-name">eql</span> pi pi)
+T
+
+* (<span class="hljs-name">equal</span> pi pi)
+T
+
+* (<span class="hljs-name">equalp</span> pi pi)
+T
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-06-07-floating-point.html" class="navigation navigation-prev " aria-label="Previous page: Floating-point Numbers">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-06-09-complex-numbers.html" class="navigation navigation-next " aria-label="Next page: Complex Numbers">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Numeric Constants","level":"3.1.6.8","depth":3,"next":{"title":"Complex Numbers","level":"3.1.6.9","depth":3,"path":"1-06-09-complex-numbers.md","ref":"./1-06-09-complex-numbers.md","articles":[]},"previous":{"title":"Floating-point Numbers","level":"3.1.6.7","depth":3,"path":"1-06-07-floating-point.md","ref":"./1-06-07-floating-point.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-06-08-constants.md","mtime":"2022-08-22T20:30:41.987Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-06-09-complex-numbers.html b/clones/llthw.common-lisp.dev/1-06-09-complex-numbers.html
new file mode 100644
index 00000000..c74418c0
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-06-09-complex-numbers.html
@@ -0,0 +1,1848 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Complex Numbers · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-06-10-arithmetic.html" />
+    
+    
+    <link rel="prev" href="1-06-08-constants.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Complex Numbers</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-169">Exercise 1.6.9</h1>
+<h2 id="complex-numbers">Complex Numbers</h2>
+<p>Common Lisp has built-in support for Complex Numbers. You can perform arithmetic on them just like any other number type.</p>
+<h3 id="in-the-repl">In the REPL</h3>
+<pre><code class="lang-lisp">(<span class="hljs-name">sqrt</span> <span class="hljs-number">-1</span>)
+
+(<span class="hljs-name">+</span> <span class="hljs-number">#C(0.0 1.0)</span> <span class="hljs-number">#C(0.0 1.0)</span>)
+
+(<span class="hljs-name">*</span> <span class="hljs-number">#C(0.0 1.0)</span> <span class="hljs-number">#C(0.0 1.0)</span>)
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* (<span class="hljs-name">sqrt</span> <span class="hljs-number">-1</span>)
+<span class="hljs-number">#C(0.0 1.0)</span>
+
+* (<span class="hljs-name">+</span> <span class="hljs-number">#C(0.0 1.0)</span> <span class="hljs-number">#C(0.0 1.0)</span>)
+<span class="hljs-number">#C(0.0 2.0)</span>
+
+* (<span class="hljs-name">*</span> <span class="hljs-number">#C(0.0 1.0)</span> <span class="hljs-number">#C(0.0 1.0)</span>)
+<span class="hljs-number">#C(-1.0 0.0)</span>
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-06-08-constants.html" class="navigation navigation-prev " aria-label="Previous page: Numeric Constants">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-06-10-arithmetic.html" class="navigation navigation-next " aria-label="Next page: Arithmetic">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Complex Numbers","level":"3.1.6.9","depth":3,"next":{"title":"Arithmetic","level":"3.1.6.10","depth":3,"path":"1-06-10-arithmetic.md","ref":"./1-06-10-arithmetic.md","articles":[]},"previous":{"title":"Numeric Constants","level":"3.1.6.8","depth":3,"path":"1-06-08-constants.md","ref":"./1-06-08-constants.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-06-09-complex-numbers.md","mtime":"2022-08-22T20:30:41.987Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-06-10-arithmetic.html b/clones/llthw.common-lisp.dev/1-06-10-arithmetic.html
new file mode 100644
index 00000000..fc399c71
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-06-10-arithmetic.html
@@ -0,0 +1,1879 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Arithmetic · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-06-11-more-arithmetic.html" />
+    
+    
+    <link rel="prev" href="1-06-09-complex-numbers.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Arithmetic</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-1610">Exercise 1.6.10</h1>
+<h2 id="arithmetic">Arithmetic</h2>
+<p>Now that you&apos;ve had a chance to explore some more number types built in to Common Lisp, let&apos;s take another look at what you can do with them.</p>
+<h3 id="in-the-repl">In the REPL</h3>
+<pre><code class="lang-lisp">(<span class="hljs-name">+</span> <span class="hljs-number">1</span> <span class="hljs-number">1</span>)
+
+(<span class="hljs-number">1</span>+ <span class="hljs-number">1</span>)
+
+(<span class="hljs-name">-</span> <span class="hljs-number">1</span> <span class="hljs-number">1</span>)
+
+(<span class="hljs-name">-</span> <span class="hljs-number">1</span>)
+
+(<span class="hljs-name">*</span> <span class="hljs-number">2</span> <span class="hljs-number">2</span>)
+
+(<span class="hljs-name">/</span> <span class="hljs-number">2</span> <span class="hljs-number">2</span>)
+
+(<span class="hljs-name">/</span> <span class="hljs-number">10</span> <span class="hljs-number">2</span>)
+
+(<span class="hljs-name">/</span> <span class="hljs-number">9</span> <span class="hljs-number">2</span>)
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* (<span class="hljs-name">+</span> <span class="hljs-number">1</span> <span class="hljs-number">1</span>)
+<span class="hljs-number">2</span>
+
+* (<span class="hljs-number">1</span>+ <span class="hljs-number">1</span>)
+<span class="hljs-number">2</span>
+
+* (<span class="hljs-name">-</span> <span class="hljs-number">1</span> <span class="hljs-number">1</span>)
+<span class="hljs-number">0</span>
+
+* (<span class="hljs-number">1</span>- <span class="hljs-number">1</span>)
+<span class="hljs-number">0</span>
+
+* (<span class="hljs-name">-</span> <span class="hljs-number">1</span>)
+<span class="hljs-number">-1</span>
+
+* (<span class="hljs-name">*</span> <span class="hljs-number">2</span> <span class="hljs-number">2</span>)
+<span class="hljs-number">4</span>
+
+* (<span class="hljs-name">/</span> <span class="hljs-number">2</span> <span class="hljs-number">2</span>)
+<span class="hljs-number">1</span>
+
+* (<span class="hljs-name">/</span> <span class="hljs-number">10</span> <span class="hljs-number">2</span>)
+<span class="hljs-number">5</span>
+
+* (<span class="hljs-name">/</span> <span class="hljs-number">9</span> <span class="hljs-number">2</span>)
+<span class="hljs-number">9/2</span>
+</code></pre>
+<p>You can non-destructively increment or decrement a value with the built-in functions <code>1+</code> and <code>1-</code>, respectively.</p>
+<p>You can negate a number by passing it as the only argument to the subtraction function.  This may seem verbose compared to the much simpler <code>-n</code> syntax for negative integers, however, this allows <em>any</em> number that can be negated to be, and also allows for user-supplied values to be negated.</p>
+<p>Division normally returns a <em>rational</em> number, the canonical representation of which could be either an integer <em>or</em> a ratio.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-06-09-complex-numbers.html" class="navigation navigation-prev " aria-label="Previous page: Complex Numbers">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-06-11-more-arithmetic.html" class="navigation navigation-next " aria-label="Next page: More Arithmetic">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Arithmetic","level":"3.1.6.10","depth":3,"next":{"title":"More Arithmetic","level":"3.1.6.11","depth":3,"path":"1-06-11-more-arithmetic.md","ref":"./1-06-11-more-arithmetic.md","articles":[]},"previous":{"title":"Complex Numbers","level":"3.1.6.9","depth":3,"path":"1-06-09-complex-numbers.md","ref":"./1-06-09-complex-numbers.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-06-10-arithmetic.md","mtime":"2022-08-22T20:30:41.987Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-06-11-more-arithmetic.html b/clones/llthw.common-lisp.dev/1-06-11-more-arithmetic.html
new file mode 100644
index 00000000..be3b4c0d
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-06-11-more-arithmetic.html
@@ -0,0 +1,1873 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>More Arithmetic · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-06-12-even-more-arithmetic.html" />
+    
+    
+    <link rel="prev" href="1-06-10-arithmetic.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >More Arithmetic</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-1611">Exercise 1.6.11</h1>
+<h2 id="more-arithmetic">More Arithmetic</h2>
+<h3 id="in-the-repl">In the REPL</h3>
+<pre><code class="lang-lisp">(<span class="hljs-name">+</span> <span class="hljs-number">1</span> <span class="hljs-number">1.0</span>)
+
+(<span class="hljs-name">+</span> <span class="hljs-number">1</span> <span class="hljs-number">#C(0.0 1.0)</span>)
+
+(<span class="hljs-name">/</span> <span class="hljs-number">9</span> <span class="hljs-number">2.0</span>)
+
+(<span class="hljs-name">floor</span> <span class="hljs-number">9/2</span>)
+
+(<span class="hljs-name">floor</span> <span class="hljs-number">9</span> <span class="hljs-number">2</span>)
+
+(<span class="hljs-name">ceiling</span> <span class="hljs-number">9/2</span>)
+
+(<span class="hljs-name">ceiling</span> <span class="hljs-number">9</span> <span class="hljs-number">2</span>)
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* (<span class="hljs-name">+</span> <span class="hljs-number">1</span> <span class="hljs-number">1.0</span>)
+<span class="hljs-number">2.0</span>
+
+* (<span class="hljs-name">+</span> <span class="hljs-number">1</span> <span class="hljs-number">#C(0.0 1.0)</span>)
+<span class="hljs-number">#C(1.0 1.0)</span>
+
+* (<span class="hljs-name">/</span> <span class="hljs-number">9</span> <span class="hljs-number">2.0</span>)
+<span class="hljs-number">4.5</span>
+
+* (<span class="hljs-name">floor</span> <span class="hljs-number">9/2</span>)
+<span class="hljs-number">4</span>
+<span class="hljs-number">1/2</span>
+
+* (<span class="hljs-name">floor</span> <span class="hljs-number">9</span> <span class="hljs-number">2</span>)
+<span class="hljs-number">4</span>
+<span class="hljs-number">1</span>
+
+* (<span class="hljs-name">ceiling</span> <span class="hljs-number">9/2</span>)
+<span class="hljs-number">5</span>
+<span class="hljs-number">-1/2</span>
+
+* (<span class="hljs-name">ceiling</span> <span class="hljs-number">9</span> <span class="hljs-number">2</span>)
+<span class="hljs-number">5</span>
+<span class="hljs-number">-1</span>
+</code></pre>
+<p>You can perform arithmetic across multiple number types, as Common Lisp takes into consideration the law of propagation of floats; while normally division returns a rational number, as stated in the previous exercise, if you supply a Real number represented as a Float, you will get a float back instead of a rational.</p>
+<p>Common Lisp also supports Floor and Ceiling division, which return the quotient and remainder as multiple values---although sometimes that remainder can be deceptive.  These functions also can take a single rational number, rounding down or up to the nearest integer and returning the remainder as a ratio.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-06-10-arithmetic.html" class="navigation navigation-prev " aria-label="Previous page: Arithmetic">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-06-12-even-more-arithmetic.html" class="navigation navigation-next " aria-label="Next page: Even More Arithmetic">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"More Arithmetic","level":"3.1.6.11","depth":3,"next":{"title":"Even More Arithmetic","level":"3.1.6.12","depth":3,"path":"1-06-12-even-more-arithmetic.md","ref":"./1-06-12-even-more-arithmetic.md","articles":[]},"previous":{"title":"Arithmetic","level":"3.1.6.10","depth":3,"path":"1-06-10-arithmetic.md","ref":"./1-06-10-arithmetic.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-06-11-more-arithmetic.md","mtime":"2022-08-22T20:30:41.987Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-06-12-even-more-arithmetic.html b/clones/llthw.common-lisp.dev/1-06-12-even-more-arithmetic.html
new file mode 100644
index 00000000..545fb752
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-06-12-even-more-arithmetic.html
@@ -0,0 +1,1842 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Even More Arithmetic · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-06-13-exponents.html" />
+    
+    
+    <link rel="prev" href="1-06-11-more-arithmetic.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Even More Arithmetic</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-1612">Exercise 1.6.12</h1>
+<h2 id="even-more-arithmetic">Even More Arithmetic</h2>
+<h3 id="in-the-repl">In the REPL</h3>
+<pre><code class="lang-lisp">(<span class="hljs-name">mod</span> (<span class="hljs-name">+</span> <span class="hljs-number">10</span> <span class="hljs-number">2</span>) <span class="hljs-number">2</span>)
+
+(<span class="hljs-name">mod</span> (<span class="hljs-name">+</span> <span class="hljs-number">55</span> <span class="hljs-number">20</span>) <span class="hljs-number">60</span>)
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* (<span class="hljs-name">mod</span> (<span class="hljs-name">+</span> <span class="hljs-number">10</span> <span class="hljs-number">2</span>) <span class="hljs-number">2</span>)
+<span class="hljs-number">0</span>
+
+* (<span class="hljs-name">mod</span> (<span class="hljs-name">+</span> <span class="hljs-number">55</span> <span class="hljs-number">20</span>) <span class="hljs-number">60</span>)
+<span class="hljs-number">15</span>
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-06-11-more-arithmetic.html" class="navigation navigation-prev " aria-label="Previous page: More Arithmetic">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-06-13-exponents.html" class="navigation navigation-next " aria-label="Next page: Exponents">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Even More Arithmetic","level":"3.1.6.12","depth":3,"next":{"title":"Exponents","level":"3.1.6.13","depth":3,"path":"1-06-13-exponents.md","ref":"./1-06-13-exponents.md","articles":[]},"previous":{"title":"More Arithmetic","level":"3.1.6.11","depth":3,"path":"1-06-11-more-arithmetic.md","ref":"./1-06-11-more-arithmetic.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-06-12-even-more-arithmetic.md","mtime":"2022-08-22T20:30:41.987Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-06-13-exponents.html b/clones/llthw.common-lisp.dev/1-06-13-exponents.html
new file mode 100644
index 00000000..ff3df119
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-06-13-exponents.html
@@ -0,0 +1,1847 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Exponents · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-06-14-logarithms.html" />
+    
+    
+    <link rel="prev" href="1-06-12-even-more-arithmetic.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Exponents</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-1613">Exercise 1.6.13</h1>
+<h2 id="exponents">Exponents</h2>
+<h3 id="in-the-repl">In the REPL</h3>
+<pre><code class="lang-lisp">(<span class="hljs-name">expt</span> <span class="hljs-number">2</span> <span class="hljs-number">2</span>)
+
+(<span class="hljs-name">expt</span> <span class="hljs-number">10</span> <span class="hljs-number">28</span>)
+
+(<span class="hljs-name">exp</span> <span class="hljs-number">28</span>)
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* (<span class="hljs-name">expt</span> <span class="hljs-number">2</span> <span class="hljs-number">2</span>)
+<span class="hljs-number">4</span>
+
+* (<span class="hljs-name">expt</span> <span class="hljs-number">10</span> <span class="hljs-number">28</span>)
+<span class="hljs-number">10000000000000000000000000000</span>
+
+* (<span class="hljs-name">exp</span> <span class="hljs-number">28</span>)
+<span class="hljs-number">1.4462571e12</span>
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-06-12-even-more-arithmetic.html" class="navigation navigation-prev " aria-label="Previous page: Even More Arithmetic">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-06-14-logarithms.html" class="navigation navigation-next " aria-label="Next page: Logarithms">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Exponents","level":"3.1.6.13","depth":3,"next":{"title":"Logarithms","level":"3.1.6.14","depth":3,"path":"1-06-14-logarithms.md","ref":"./1-06-14-logarithms.md","articles":[]},"previous":{"title":"Even More Arithmetic","level":"3.1.6.12","depth":3,"path":"1-06-12-even-more-arithmetic.md","ref":"./1-06-12-even-more-arithmetic.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-06-13-exponents.md","mtime":"2022-08-22T20:30:41.987Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-06-14-logarithms.html b/clones/llthw.common-lisp.dev/1-06-14-logarithms.html
new file mode 100644
index 00000000..0dc48827
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-06-14-logarithms.html
@@ -0,0 +1,1847 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Logarithms · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-06-15-trigonometry.html" />
+    
+    
+    <link rel="prev" href="1-06-13-exponents.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Logarithms</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-1614">Exercise 1.6.14</h1>
+<h2 id="logarithms">Logarithms</h2>
+<h3 id="in-the-repl">In the REPL</h3>
+<pre><code class="lang-lisp">(<span class="hljs-name">log</span> <span class="hljs-number">2</span>)
+
+(<span class="hljs-name">log</span> <span class="hljs-number">2</span> <span class="hljs-number">10</span>)
+
+(<span class="hljs-name">log</span> <span class="hljs-number">2</span> <span class="hljs-number">2</span>)
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* (<span class="hljs-name">log</span> <span class="hljs-number">2</span>)
+<span class="hljs-number">0.6931472</span>
+
+* (<span class="hljs-name">log</span> <span class="hljs-number">2</span> <span class="hljs-number">10</span>)
+<span class="hljs-number">0.30103</span>
+
+* (<span class="hljs-name">log</span> <span class="hljs-number">2</span> <span class="hljs-number">2</span>)
+<span class="hljs-number">1.0</span>
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-06-13-exponents.html" class="navigation navigation-prev " aria-label="Previous page: Exponents">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-06-15-trigonometry.html" class="navigation navigation-next " aria-label="Next page: Trigonometry">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Logarithms","level":"3.1.6.14","depth":3,"next":{"title":"Trigonometry","level":"3.1.6.15","depth":3,"path":"1-06-15-trigonometry.md","ref":"./1-06-15-trigonometry.md","articles":[]},"previous":{"title":"Exponents","level":"3.1.6.13","depth":3,"path":"1-06-13-exponents.md","ref":"./1-06-13-exponents.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-06-14-logarithms.md","mtime":"2022-08-22T20:30:41.987Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-06-15-trigonometry.html b/clones/llthw.common-lisp.dev/1-06-15-trigonometry.html
new file mode 100644
index 00000000..619f35ad
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-06-15-trigonometry.html
@@ -0,0 +1,1852 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Trigonometry · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-06-16-psuedorandom-numbers.html" />
+    
+    
+    <link rel="prev" href="1-06-14-logarithms.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Trigonometry</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-1615">Exercise 1.6.15</h1>
+<h2 id="trigonometry">Trigonometry</h2>
+<h3 id="in-the-repl">In the REPL</h3>
+<pre><code class="lang-lisp">pi
+
+(<span class="hljs-name">sin</span> pi)
+
+(<span class="hljs-name">cos</span> pi)
+
+(<span class="hljs-name">tan</span> pi)
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* pi
+<span class="hljs-number">3.141592653589793d0</span>
+
+* (<span class="hljs-name">sin</span> pi)
+<span class="hljs-number">1.2246467991473532d-16</span>
+
+* (<span class="hljs-name">cos</span> pi)
+<span class="hljs-number">-1.0d0</span>
+
+* (<span class="hljs-name">tan</span> pi)
+<span class="hljs-number">-1.2246467991473532d-16</span>
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-06-14-logarithms.html" class="navigation navigation-prev " aria-label="Previous page: Logarithms">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-06-16-psuedorandom-numbers.html" class="navigation navigation-next " aria-label="Next page: Pseudo-Random Numbers">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Trigonometry","level":"3.1.6.15","depth":3,"next":{"title":"Pseudo-Random Numbers","level":"3.1.6.16","depth":3,"path":"1-06-16-psuedorandom-numbers.md","ref":"./1-06-16-psuedorandom-numbers.md","articles":[]},"previous":{"title":"Logarithms","level":"3.1.6.14","depth":3,"path":"1-06-14-logarithms.md","ref":"./1-06-14-logarithms.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-06-15-trigonometry.md","mtime":"2022-08-22T20:30:41.987Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-06-16-psuedorandom-numbers.html b/clones/llthw.common-lisp.dev/1-06-16-psuedorandom-numbers.html
new file mode 100644
index 00000000..6ebf4bff
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-06-16-psuedorandom-numbers.html
@@ -0,0 +1,1865 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Pseudo-Random Numbers · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-07-0-arrays.html" />
+    
+    
+    <link rel="prev" href="1-06-15-trigonometry.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Pseudo-Random Numbers</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="exercise-1616">Exercise 1.6.16</h1>
+<h2 id="pseudo-random-numbers">Pseudo-Random Numbers</h2>
+<p>Pseudo-Random number generation is available with the <code>random</code> function; you
+pass it a limit, which can either be a positive integer or float, and it returns
+to you a number of the same type as the limit.</p>
+<h3 id="in-the-repl">In the REPL</h3>
+<pre><code class="lang-lisp">(<span class="hljs-name">random</span> <span class="hljs-number">10</span>)
+
+(<span class="hljs-name">random</span> <span class="hljs-number">10</span>)
+
+(<span class="hljs-name">random</span> <span class="hljs-number">10</span>)
+
+(<span class="hljs-name">random</span> <span class="hljs-number">10</span>)
+
+(<span class="hljs-name">random</span> <span class="hljs-number">10</span>)
+
+(<span class="hljs-name">random</span> <span class="hljs-number">10</span>)
+</code></pre>
+<h3 id="what-you-should-see">What You Should See</h3>
+<pre><code class="lang-lisp">* (<span class="hljs-name">random</span> <span class="hljs-number">10</span>)
+<span class="hljs-number">3</span>
+
+* (<span class="hljs-name">random</span> <span class="hljs-number">10</span>)
+<span class="hljs-number">1</span>
+
+* (<span class="hljs-name">random</span> <span class="hljs-number">10</span>)
+<span class="hljs-number">5</span>
+
+* (<span class="hljs-name">random</span> <span class="hljs-number">10</span>)
+<span class="hljs-number">9</span>
+
+* (<span class="hljs-name">random</span> <span class="hljs-number">10</span>)
+<span class="hljs-number">6</span>
+
+* (<span class="hljs-name">random</span> <span class="hljs-number">10</span>)
+<span class="hljs-number">2</span>
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-06-15-trigonometry.html" class="navigation navigation-prev " aria-label="Previous page: Trigonometry">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-07-0-arrays.html" class="navigation navigation-next " aria-label="Next page: Extra Credit: Arrays and Vectors">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Pseudo-Random Numbers","level":"3.1.6.16","depth":3,"next":{"title":"Extra Credit: Arrays and Vectors","level":"3.1.7","depth":2,"path":"1-07-0-arrays.md","ref":"./1-07-0-arrays.md","articles":[]},"previous":{"title":"Trigonometry","level":"3.1.6.15","depth":3,"path":"1-06-15-trigonometry.md","ref":"./1-06-15-trigonometry.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-06-16-psuedorandom-numbers.md","mtime":"2022-08-22T21:08:51.281Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-07-0-arrays.html b/clones/llthw.common-lisp.dev/1-07-0-arrays.html
new file mode 100644
index 00000000..e013b570
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-07-0-arrays.html
@@ -0,0 +1,1923 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Extra Credit: Arrays and Vectors · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-08-0-variables.html" />
+    
+    
+    <link rel="prev" href="1-06-16-psuedorandom-numbers.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Extra Credit: Arrays and Vectors</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-17-----extra-credit">Chapter 1.7 --- Extra Credit</h1>
+<h2 id="arrays-and-vectors">Arrays and Vectors</h2>
+<blockquote>
+<p>&quot;As with any tool, merit <em>or</em> demerit lies in how it is used.&quot;</p>
+<footer>Robert A. Heinlein, <em>Friday</em></footer>
+
+</blockquote>
+<p>When you need to squeeze extra efficiency out of your Lisp program, usually the first place to turn after minimizing consing-operations is to migrate your list data structures to arrays and vectors.  You will lose the flexibility of lists, but you do gain in performance and reduce memory usage.</p>
+<p>Just like Lists, Arrays descend from the Sequence type, and vectors are a special type of array with only one dimension, so all sequence operations will also work on arrays and vectors.  List operations, however, will not.  Luckily, Common Lisp includes a number of utilities for working with arrays and vectors---and you should get to know them immediately so that you can start improving your codebase right away.</p>
+<p>This chapter will contain exercises on:</p>
+<ul>
+<li>Sequences, Arrays, and Vectors</li>
+<li>Making Arrays</li>
+<li>Element-Types of Arrays</li>
+<li>Fixed-Size Arrays</li>
+<li>Extensible Arrays</li>
+<li>Fill-Pointers</li>
+<li>Splicing Arrays</li>
+<li>Splitting Arrays</li>
+<li>Concatenating Arrays</li>
+<li>Matrices</li>
+<li>Matrix Multiplication</li>
+<li>Octet Vectors</li>
+<li>Octet Vectors and Streams</li>
+</ul>
+<h3 id="exercise-171">Exercise 1.7.1</h3>
+<p><strong>Sequences Revisited: Arrays and Vectors</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-172">Exercise 1.7.2</h3>
+<p><strong>Arrays</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-173">Exercise 1.7.3</h3>
+<p><strong>More Arrays: Element-Type</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-174">Exercise 1.7.4</h3>
+<p><strong>More Arrays: Dimension</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-175">Exercise 1.7.5</h3>
+<p><strong>More Arrays: Extensible</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-176">Exercise 1.7.6</h3>
+<p><strong>More Arrays: Fill-Pointers</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-177">Exercise 1.7.7</h3>
+<p><strong>Splicing Arrays</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-178">Exercise 1.7.8</h3>
+<p><strong>Splitting Arrays</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-179">Exercise 1.7.9</h3>
+<p><strong>Concatenating Arrays</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1710">Exercise 1.7.10</h3>
+<p><strong>Matrices</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1711">Exercise 1.7.11</h3>
+<p><strong>Matrix Multiplication</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1712">Exercise 1.7.12</h3>
+<p><strong>Octet-Vectors</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1713">Exercise 1.7.13</h3>
+<p><strong>More Octet-Vectors</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1714">Exercise 1.7.14</h3>
+<p><strong>Vectors and Binary Streams</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-06-16-psuedorandom-numbers.html" class="navigation navigation-prev " aria-label="Previous page: Pseudo-Random Numbers">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-08-0-variables.html" class="navigation navigation-next " aria-label="Next page: Variables, Parameters, and Constants">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Extra Credit: Arrays and Vectors","level":"3.1.7","depth":2,"next":{"title":"Variables, Parameters, and Constants","level":"3.1.8","depth":2,"path":"1-08-0-variables.md","ref":"./1-08-0-variables.md","articles":[]},"previous":{"title":"Pseudo-Random Numbers","level":"3.1.6.16","depth":3,"path":"1-06-16-psuedorandom-numbers.md","ref":"./1-06-16-psuedorandom-numbers.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-07-0-arrays.md","mtime":"2022-08-22T22:47:49.767Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-08-0-variables.html b/clones/llthw.common-lisp.dev/1-08-0-variables.html
new file mode 100644
index 00000000..8294c360
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-08-0-variables.html
@@ -0,0 +1,1900 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Variables, Parameters, and Constants · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-09-0-closures.html" />
+    
+    
+    <link rel="prev" href="1-07-0-arrays.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Variables, Parameters, and Constants</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-18">Chapter 1.8</h1>
+<h2 id="variables-parameters-and-constants">Variables, Parameters, and Constants</h2>
+<blockquote>
+<p>&quot;In a dilemma, it is helpful to change any variable, then reexamine the problem.&quot;</p>
+<footer>Robert A. Heinlein, <em>Have Space Suit---Will Travel</em></footer>
+
+</blockquote>
+<p>By this point, you may be pretty tired of having to manually re-type all your data every time you want to use them---but don&apos;t worry, you won&apos;t have to do that anymore.  Whenever you want to use or re-use data---say, a string, number, list, or whatever else your program might need to pass around---you can <em>bind</em> a symbol and <em>assign</em> a value to it.</p>
+<p>In keeping with the idea that &quot;Lisp is different,&quot; variables are very different in Lisp from other programming languages.  Some Lisp Hackers like to compare them to pointers in C and C++, but I have found that such a comparison overcomplicates a much simpler system.  Once you know that the variable&apos;s <em>symbol</em> is not the variable itself, it is easy to see that the variable&apos;s <em>assignment</em> is a literal pointer to a memory address, without worrying about the extra complications that come with pointers in C or C++.</p>
+<p>You may have also heard that Common Lisp is a &quot;Lisp-2&quot;; while all Lisp-family languages have lexical scope---a neat feature that we will cover in this chapter&apos;s exercises as well as extend upon in the following chapter---other Lisps such as Clojure, Scheme, Racket, and Emacs Lisp don&apos;t have separate namespaces for variables and functions within the same lexical scope.  So, for example, in Common Lisp you can have both a function and a variable with the same name in the same scope; context tells the Lisp reader which definition to use.</p>
+<p>This chapter will contain exercises on:</p>
+<ul>
+<li>Symbols</li>
+<li>Binding and Assignment</li>
+<li>(Global) Dynamic Variables</li>
+<li>(Local) Lexical Variables</li>
+<li>Re-assigning Values to Variables</li>
+<li>Parameters</li>
+<li>Constants</li>
+</ul>
+<h3 id="exercise-181">Exercise 1.8.1</h3>
+<p><strong>Symbols</strong></p>
+<pre><code class="lang-lisp">
+(<span class="hljs-name">intern</span> <span class="hljs-string">&quot;FOO&quot;</span>)
+FOO
+NIL
+</code></pre>
+<h3 id="exercise-182">Exercise 1.8.2</h3>
+<p><strong>Symbol Tables and Inspecting Objects</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-183">Exercise 1.8.3</h3>
+<p><strong>More Symbols: Binding and Assignment</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-184">Exercise 1.8.4</h3>
+<p><strong>Even More Symbols: Namespaces</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-185">Exercise 1.8.5</h3>
+<p><strong>DEFVAR: Dynamic Binding of Variables</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-186">Exercise 1.8.6</h3>
+<p><strong>LET: Lexical Binding of Variables</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-187">Exercise 1.8.7</h3>
+<p><strong>SETQ vs SETF</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-188">Exercise 1.8.8</h3>
+<p><strong>DEFPARAMETER: Dynamic Binding Revisited</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-189">Exercise 1.8.9</h3>
+<p><strong>DEFCONSTANT</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1810">Exercise 1.8.10</h3>
+<p><strong>Function Parameters</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-07-0-arrays.html" class="navigation navigation-prev " aria-label="Previous page: Extra Credit: Arrays and Vectors">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-09-0-closures.html" class="navigation navigation-next " aria-label="Next page: Extra Credit: Closures">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Variables, Parameters, and Constants","level":"3.1.8","depth":2,"next":{"title":"Extra Credit: Closures","level":"3.1.9","depth":2,"path":"1-09-0-closures.md","ref":"./1-09-0-closures.md","articles":[]},"previous":{"title":"Extra Credit: Arrays and Vectors","level":"3.1.7","depth":2,"path":"1-07-0-arrays.md","ref":"./1-07-0-arrays.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-08-0-variables.md","mtime":"2022-08-22T22:47:49.767Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-09-0-closures.html b/clones/llthw.common-lisp.dev/1-09-0-closures.html
new file mode 100644
index 00000000..9187d6f8
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-09-0-closures.html
@@ -0,0 +1,1917 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Extra Credit: Closures · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-10-0-functions.html" />
+    
+    
+    <link rel="prev" href="1-08-0-variables.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Extra Credit: Closures</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-19-----extra-credit">Chapter 1.9 --- Extra Credit</h1>
+<h2 id="closures">Closures</h2>
+<blockquote>
+<p>&quot;Everything is theoretically impossible, until it is done.&quot;</p>
+<footer>Robert A. Heinlein, <em>The Rolling Stones</em></footer>
+
+</blockquote>
+<p>One of the neater features of Lisp that result from lexical scope are <em>Closures</em>---you may have even heard of them before, since &quot;closure&quot; has been a big buzz-word in the tech world lately---particularly in the Node.js community.  In the jargon of Computer Science, a Closure is a lambda expression (or, anonymous function), which has its open bindings bound in the lexical environment where it was defined.  For now, you can think of them as a means to preserve state in functional programming.</p>
+<p>Closures were first developed to manually evaluate expressions in Lambda Calculus, and included as a language feature in the first version of Scheme. The feature was added to Common Lisp during the ANSI standardization process, and nowadays can be found in all Lisp-family languages.  Naturally, they are also fully supported in Erlang and Haskell.  This feature has become so popular in recent years that it has been adopted and shimmied into many other programming and scripting languages, including C++11, Java 8, JavaScript, EcmaScript, Smalltalk, ML, Ruby, Perl, Objective-C (and the Apple extensions to C and C++), C#, D, Swift, and to a limited extent, Python---although the S-Expression syntax of Lisp-family languages makes Closures far more natural to express than with the syntaxes of other languages.</p>
+<p>In this chapter we will further explore the concepts of dynamic and lexical scope, introduce the concept of first-class functions, and walk through a number of interesting examples of Closures to make sure you have a good understanding of their use and potential.  You&apos;ll also get a sneak peak at functions, giving you more confidence in the material before you tackle the next chapter!</p>
+<h3 id="exercise-191">Exercise 1.9.1</h3>
+<p><strong>Lexical Environments and Scope</strong></p>
+<pre><code class="lang-lisp"><span class="hljs-comment">;; let&apos;s look at lexical scoping</span>
+(<span class="hljs-name">let</span> ((<span class="hljs-name">one</span> <span class="hljs-number">1</span>))
+  (<span class="hljs-name">let</span> ((<span class="hljs-name">two</span> (<span class="hljs-name">+</span> one one)))
+    (<span class="hljs-name">let</span> ((<span class="hljs-name">three</span> (<span class="hljs-name">+</span> one two)))
+      (<span class="hljs-name">let</span> ((<span class="hljs-name">one</span> <span class="hljs-number">1.0</span>))
+        (<span class="hljs-name">+</span> one two three)))))
+<span class="hljs-number">6.0</span>
+</code></pre>
+<h3 id="exercise-192">Exercise 1.9.2</h3>
+<p><strong>LET Revisited</strong></p>
+<pre><code class="lang-lisp">(<span class="hljs-name">let</span> ((<span class="hljs-name">one</span> <span class="hljs-number">1</span>)
+      (<span class="hljs-name">two</span> <span class="hljs-number">2</span>)
+      (<span class="hljs-name">three</span> <span class="hljs-number">3</span>))
+  (<span class="hljs-name">-</span> three two one))
+</code></pre>
+<h3 id="exercise-193">Exercise 1.9.3</h3>
+<p><strong>LET*: Nested Lexical Scope</strong></p>
+<pre><code class="lang-lisp">(<span class="hljs-name">let*</span> ((<span class="hljs-name">one</span> <span class="hljs-number">1</span>)
+       (<span class="hljs-name">two</span> (<span class="hljs-name">+</span> one one))
+       (<span class="hljs-name">three</span> (<span class="hljs-name">+</span> two one)))
+  (<span class="hljs-name">*</span> three three))
+</code></pre>
+<h3 id="exercise-194">Exercise 1.9.4</h3>
+<p><strong>Pure Functions</strong></p>
+<ul>
+<li>No side-effects</li>
+<li>No reliance on external state</li>
+<li>Same input =&gt; same output, every time</li>
+</ul>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-195">Exercise 1.9.5</h3>
+<p><strong>First-Class Functions</strong></p>
+<p>Functions can be passed as an argument to another function.</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">map</span> &apos;vector #&apos;+ &apos;(<span class="hljs-number">1</span> <span class="hljs-number">2</span> <span class="hljs-number">3</span> <span class="hljs-number">4</span>) &apos;(<span class="hljs-number">10</span> <span class="hljs-number">20</span> <span class="hljs-number">30</span> <span class="hljs-number">40</span>))
+</code></pre>
+<h3 id="exercise-196">Exercise 1.9.6</h3>
+<p><strong>Functors: Function Objects</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-197">Exercise 1.9.7</h3>
+<p><strong>LABEL and BLOCK</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-198">Exercise 1.9.8</h3>
+<p><strong>Functions as Arguments</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-199">Exercise 1.9.9</h3>
+<p><strong>Your First Closure</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1910">Exercise 1.9.10</h3>
+<p><strong>Dancing Closures</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1911">Exercise 1.9.11</h3>
+<p><strong>The Macroexpansion of DEFUN</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1912">Exercise 1.9.12</h3>
+<p><strong>Extending Closures: Continuations</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1913">Exercise 1.9.13</h3>
+<p><strong>Extending Closures: Partials</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-08-0-variables.html" class="navigation navigation-prev " aria-label="Previous page: Variables, Parameters, and Constants">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-10-0-functions.html" class="navigation navigation-next " aria-label="Next page: Functions and Macros">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Extra Credit: Closures","level":"3.1.9","depth":2,"next":{"title":"Functions and Macros","level":"3.1.10","depth":2,"path":"1-10-0-functions.md","ref":"./1-10-0-functions.md","articles":[]},"previous":{"title":"Variables, Parameters, and Constants","level":"3.1.8","depth":2,"path":"1-08-0-variables.md","ref":"./1-08-0-variables.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-09-0-closures.md","mtime":"2022-08-22T22:47:49.767Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-10-0-functions.html b/clones/llthw.common-lisp.dev/1-10-0-functions.html
new file mode 100644
index 00000000..f6789d1f
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-10-0-functions.html
@@ -0,0 +1,1936 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Functions and Macros · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-11-0-text-adventure.html" />
+    
+    
+    <link rel="prev" href="1-09-0-closures.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Functions and Macros</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-110">Chapter 1.10</h1>
+<h2 id="functions-and-macros">Functions and Macros</h2>
+<blockquote>
+<p>&quot;The greatest productive force is human selfishness.&quot;</p>
+<footer>Robert A. Heinlein, <em>Time Enough For Love</em></footer>
+
+</blockquote>
+<p>At the end of the day, most of the Lisp code you write will probably be Function or Macro definitions; after all, not only will they finally enable you to start doing some interesting programming, they are---arguably---the core of Lambda Calculus, Functional Programming, and the Lisp-family of programming languages.  Even if you choose to favor Object-Oriented Programming as your go-to paradigm, you&apos;ll be using what you&apos;ve learned here in this chapter.</p>
+<p>You&apos;ve already seen some functions and macros in action; other than the low-level <em>special forms</em>, most of the Lisp language as defined in the ANSI Standard is actually implemented in Common Lisp as functions in the <code>COMMON-LISP</code> package---in other words, Common Lisp is primarily a self-defined language, built on top of a small set of primitives.  When working at the REPL, these functions are all imported for you into your own personal namespace, <code>CL-USER</code>.  But some of the Common Lisp language is also implemented as Macros---remember <code>with-open-file</code>?  That is a common use of Macros as used in the Common Lisp language itself, <code>with-...</code> forms.  But also, every definition form, even <code>defun</code> and <code>defmacro</code>, are <em>also</em> macros themselves.</p>
+<p>You can think of Functions as lexically closed blocks of code.  You write functions to extend the vocabulary of Lisp.</p>
+<p>Macros are, at least on the surface, very similar to functions; however, they also allow the programmer to use <em>backtick syntax</em>, a highly expressive notation for marking-up code transformation.  Due to the expressive power of macros in Common Lisp, you can say that Lisp macros not only allow you to extend the vocabulary, but also modify the syntax of Lisp to your heart&apos;s desire.  Macros are often used to reduce repetitive, predictable code to a single line; combine related functionality into a simple call that expands into Lisp procedurally based on input; and for writing Domain-Specific Languages, a topic we will cover exclusively in Chapter 1.19.</p>
+<p>For now, we will focus on the core of writing anonymous and named functions with dynamic and lexical scope, writing recursive functions, tail-call optimization, and writing your first macros to keep your code tidy and expressive.</p>
+<p>This chapter will contain exercises on:</p>
+<ul>
+<li>LAMBDA: Anonymous Functions</li>
+<li>Global Functions/top-level forms</li>
+<li>Local Functions/lexical forms</li>
+<li>Recursive Functions</li>
+<li>Tail-Call Optimization</li>
+<li>Defining Macros</li>
+<li>Backtick syntax</li>
+</ul>
+<h3 id="exercise-1101">Exercise 1.10.1</h3>
+<p><strong>LAMBDA: Anonymous Functions</strong></p>
+<pre><code class="lang-lisp">(<span class="hljs-name">lambda</span> (<span class="hljs-name">x</span>) (<span class="hljs-name">+</span> x x))
+
+((<span class="hljs-name">lambda</span> (<span class="hljs-name">x</span>) (<span class="hljs-name">+</span> x x)) <span class="hljs-number">2</span>)
+</code></pre>
+<h3 id="exercise-1102">Exercise 1.10.2</h3>
+<p><strong>More LAMBDA</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1103">Exercise 1.10.3</h3>
+<p><strong>Even More Lambda</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1104">Exercise 1.10.4</h3>
+<p><strong>DEFUN: Function Definitions</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1105">Exercise 1.10.5</h3>
+<p><strong>More DEFUN</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1106">Exercise 1.10.6</h3>
+<p><strong>Even More DEFUN</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1107">Exercise 1.10.7</h3>
+<p><strong>FLET: Lexical Function Definitions</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1108">Exercise 1.10.8</h3>
+<p><strong>Recursive Functions</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1109">Exercise 1.10.9</h3>
+<p><strong>More Recursive Functions</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-11010">Exercise 1.10.10</h3>
+<p><strong>The Y-Combinator: Recursive Anonymous Functions</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-11011">Exercise 1.10.11</h3>
+<p><strong>Tail-Call Optimization</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-11012">Exercise 1.10.12</h3>
+<p><strong>Defining Macros</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-11013">Exercise 1.10.13</h3>
+<p><strong>Macro Expansion</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-11014">Exercise 1.10.14</h3>
+<p><strong>Backtick Syntax</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-11015">Exercise 1.10.15</h3>
+<p><strong>Unquoting</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-11016">Exercise 1.10.16</h3>
+<p><strong>Splicing</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-11017">Exercise 1.10.17</h3>
+<p><strong>Nested Expansions</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-09-0-closures.html" class="navigation navigation-prev " aria-label="Previous page: Extra Credit: Closures">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-11-0-text-adventure.html" class="navigation navigation-next " aria-label="Next page: Extra Credit: A Simple Text Adventure">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Functions and Macros","level":"3.1.10","depth":2,"next":{"title":"Extra Credit: A Simple Text Adventure","level":"3.1.11","depth":2,"path":"1-11-0-text-adventure.md","ref":"./1-11-0-text-adventure.md","articles":[]},"previous":{"title":"Extra Credit: Closures","level":"3.1.9","depth":2,"path":"1-09-0-closures.md","ref":"./1-09-0-closures.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-10-0-functions.md","mtime":"2022-08-22T22:47:49.767Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-11-0-text-adventure.html b/clones/llthw.common-lisp.dev/1-11-0-text-adventure.html
new file mode 100644
index 00000000..64eaf234
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-11-0-text-adventure.html
@@ -0,0 +1,1906 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Extra Credit: A Simple Text Adventure · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-12-0-namespaces.html" />
+    
+    
+    <link rel="prev" href="1-10-0-functions.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Extra Credit: A Simple Text Adventure</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-111-----extra-credit">Chapter 1.11 --- Extra Credit</h1>
+<h2 id="a-simple-text-adventure">A Simple Text Adventure</h2>
+<blockquote>
+<p>&quot;Morals&#x2014;all correct moral laws&#x2014;derive from the instinct to survive. Moral behavior is survival behavior above the individual level.&quot;</p>
+<footer>Robert A. Heinlein, <em>Starship Troopers</em></footer>
+
+</blockquote>
+<p>Now that you&apos;re about half-way through Part One, it&apos;s time to have a little fun and write a game.  You now know how to write your own functions to extend the Lisp language, write macros that expand into the code you need at compile-time, store your data in variables, prompt your users for input, and do some fun stuff with math and strings---so now it&apos;s time to put it all together to write a classic console text-based Adventure game that you can share with your friends, family, and other L(&#x3BB;)THW students.</p>
+<p>A really important aspect of this chapter is to write a game of your very own---but first you need to understand the steps required to write a game of any kind.  As such, you&apos;ll have to go through this chapter at least twice---the first time, follow along with me and implement the game exactly as I have, and stick to the five steps of the Hard Way methodology as normal; the second time, replace my game&apos;s theme, story, characters, and world with your own, and get creative with the code---experiment, innovate, and don&apos;t be afraid to break the program, take this as an opportunity to practice your debugging skills too.</p>
+<p>Once you&apos;re done working through this chapter for the second time and you get your own unique game to run, and you can play through it from beginning to end, feel free to create a repo or gist and share it in the comments below.  But remember, no cheating!  Make sure you&apos;ve gone through this chapter at least twice, and successfully played through your own game, before you poke around through other people&apos;s code for ideas.</p>
+<div class="alert alert-info">
+  <strong>Note:</strong>
+  <p>This chapter will guide you through writing a straightforward, hard-coded game; in other words, it will have to be recompiled every time you make a change to the source.  This doesn&apos;t necessarily represent best practices for game development.  In Parts Two and Three, alternate implementations of game engines will be presented that will load game resources on the fly from your computer&apos;s file system, so that you only have to re-compile the game when you change the program logic, and not the game content.
+</p></div>
+
+<p>This chapter will contain exercises on:</p>
+<ul>
+<li>ASCII-art and Text Adventure Aesthetics</li>
+<li>Building your game interface</li>
+<li>Your game&apos;s theme, story, and characters</li>
+<li>Your game&apos;s world</li>
+<li>Movement through the game world</li>
+<li>Interacting with the game world</li>
+<li>Collecting and using items in the game world</li>
+<li>Non-player Characters</li>
+<li>Quick and Dirty AI enemies</li>
+<li>Packaging and Running your game</li>
+</ul>
+<h3 id="exercise-1111">Exercise 1.11.1</h3>
+<p><strong>ASCII-Art and ANSI Escape Codes</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1112">Exercise 1.11.2</h3>
+<p><strong>The Game Interface</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1113">Exercise 1.11.3</h3>
+<p><strong>Theme, Story, and Characters</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1114">Exercise 1.11.4</h3>
+<p><strong>The Game World</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1115">Exercise 1.11.5</h3>
+<p><strong>Movement in the Game World</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1116">Exercise 1.11.6</h3>
+<p><strong>Interacting with the Game World</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1117">Exercise 1.11.7</h3>
+<p><strong>Collecting and Using Items in the Game World</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1118">Exercise 1.11.8</h3>
+<p><strong>Non-Player Characters</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-1119">Exercise 1.11.9</h3>
+<p><strong>Quick and Dirty AI Enemies</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-11110">Exercise 1.11.10</h3>
+<p><strong>Packaging and Running Your Game</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-10-0-functions.html" class="navigation navigation-prev " aria-label="Previous page: Functions and Macros">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-12-0-namespaces.html" class="navigation navigation-next " aria-label="Next page: Namespaces, Symbols, Packages, and Systems">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Extra Credit: A Simple Text Adventure","level":"3.1.11","depth":2,"next":{"title":"Namespaces, Symbols, Packages, and Systems","level":"3.1.12","depth":2,"path":"1-12-0-namespaces.md","ref":"./1-12-0-namespaces.md","articles":[]},"previous":{"title":"Functions and Macros","level":"3.1.10","depth":2,"path":"1-10-0-functions.md","ref":"./1-10-0-functions.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-11-0-text-adventure.md","mtime":"2022-08-22T22:47:49.767Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-12-0-namespaces.html b/clones/llthw.common-lisp.dev/1-12-0-namespaces.html
new file mode 100644
index 00000000..7916706e
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-12-0-namespaces.html
@@ -0,0 +1,2351 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Namespaces, Symbols, Packages, and Systems · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-13-0-simple-web-app.html" />
+    
+    
+    <link rel="prev" href="1-11-0-text-adventure.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Namespaces, Symbols, Packages, and Systems</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-112">Chapter 1.12</h1>
+<h2 id="namespaces-symbols-packages-and-systems">Namespaces, Symbols, Packages, and Systems</h2>
+<blockquote>
+<p>&quot;Every law that was ever written opened up a new way to graft.&quot;</p>
+<footer>Robert A. Heinlein, <em>Red Planet</em></footer>
+
+</blockquote>
+<p>As briefly introduced in previous chapters, Common Lisp is a Lisp-2: that is to say, within any given package, you can use the same symbol to refer to both a function and a variable, if you like, because functions and variables have separate namespaces.  The namespaces for functions and variables are managed by the symbol object itself, which exist within a package.</p>
+<p>Obviously, scope is important too.  A symbol inside a function body may not have the same definition as in the top-level.  This is by design---and whenever you use a symbol, it is important to remember dynamic and lexical scope.  Not all enclosing forms introduce a new lexical scope like <code>defun</code> does.</p>
+<p>So, as you can see, what a symbol happens to mean is highly contextual---and for the most part, the Lisp reader is very good at figuring out which definition of a symbol you happen to mean in any given context.  When you want to stray from the norm, Lisp has tools to help you be more specific.</p>
+<p>We will also cover some basic aspects of packaging your Lisp code for the wild, and working with ASDF and the Quicklisp package manager built on top of it.</p>
+<h3 id="exercise-1121">Exercise 1.12.1</h3>
+<p><strong>Dynamic and Lexical Scope, Revisited</strong></p>
+<p>All symbols in Common Lisp are namespaced in packages, and within a namespace, symbols are also scoped.  <em>Scope</em> refers to how the Lisp reader looks up symbol definitions in the current environment.</p>
+<h4 id="in-the-repl">In the REPL</h4>
+<pre><code class="lang-lisp">(<span class="hljs-name">defparameter</span> one <span class="hljs-number">#x01</span>)
+
+(<span class="hljs-name">let</span> ((<span class="hljs-name">one</span> <span class="hljs-number">1</span>))
+  (<span class="hljs-name">let</span> ((<span class="hljs-name">one</span> <span class="hljs-number">1.0</span>))
+    (<span class="hljs-name">let</span> ((<span class="hljs-name">one</span> <span class="hljs-string">&quot;one&quot;</span>))
+      (<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;~a~%&quot;</span> one))
+    (<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;~a~%&quot;</span> one))
+  (<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;~a~%&quot;</span> one))
+
+(<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;#x~X~%&quot;</span> one)
+</code></pre>
+<h4 id="what-you-should-see">What You Should See</h4>
+<pre><code class="lang-lisp">* (<span class="hljs-name">defparameter</span> one <span class="hljs-number">#x01</span>)
+ONE
+
+* (<span class="hljs-name">let</span> ((<span class="hljs-name">one</span> <span class="hljs-number">1</span>))
+    (<span class="hljs-name">let</span> ((<span class="hljs-name">one</span> <span class="hljs-number">1.0</span>))
+      (<span class="hljs-name">let</span> ((<span class="hljs-name">one</span> <span class="hljs-string">&quot;one&quot;</span>))
+        (<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;~a~%&quot;</span> one))
+      (<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;~a~%&quot;</span> one))
+    (<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;~a~%&quot;</span> one))
+one
+<span class="hljs-number">1.0</span>
+<span class="hljs-number">1</span>
+NIL
+
+* (<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;#x~2,&apos;0,,X~%&quot;</span> one)
+<span class="hljs-number">#x01</span>
+NIL
+</code></pre>
+<p>There are two flavours of scope---dynamic and lexical.  Lexical scope is tightly integrated with the structure of Lisp code and the lambda calculus from which it descends; it is <em>spatial</em> to the establishing form.  Dynamic scope is special, because it has indefinite scope and dynamic extent, which is to say that dynamically scoped symbols are not lexically contained to their establishing form and they live in the dynamic environment.</p>
+<p>Remember that Lexical Scope <em>shadows</em> Dynamic scope, as well as surrounding lexical scopes.  Unless you specify otherwise, the innermost binding of a symbol is the one that is found by the Lisp reader.</p>
+<h3 id="exercise-1122">Exercise 1.12.2</h3>
+<p><strong>Implicit Lexical Scope</strong></p>
+<p>Many forms in Common Lisp introduce an <em>implicit</em> lexical scope.  That is, you do not have explicitly call a <code>let</code> or <code>flet</code> to introduce a new nested scope; they provide a means for binding and assignment that is more intuitive for their particular use-case.  You have already seen a few of these forms, like the <code>DEFUN</code> macro.  You will also find implicit lexical scoping in <code>BLOCK</code> forms, and destructuring macros such as <code>DESTRUCTURING-BIND</code>, to name a few.</p>
+<h4 id="in-the-repl">In the REPL</h4>
+<pre><code class="lang-lisp">(<span class="hljs-name">block</span> ta-da!
+  (<span class="hljs-name">cond</span> ((<span class="hljs-name">=</span> (<span class="hljs-name">+</span> <span class="hljs-number">1</span> <span class="hljs-number">1</span>) <span class="hljs-number">2</span>)
+         (<span class="hljs-name">return-from</span> ta-da! <span class="hljs-literal">t</span>))
+        ((<span class="hljs-name">=</span> (<span class="hljs-name">+</span> <span class="hljs-number">1</span> <span class="hljs-number">1</span>) <span class="hljs-number">3</span>)
+         (<span class="hljs-name">return-from</span> ta-da! <span class="hljs-literal">nil</span>))
+        (<span class="hljs-name">t</span>
+         (<span class="hljs-name">return-from</span> ta-da! <span class="hljs-string">&quot;Wait, what?&quot;</span>))))
+</code></pre>
+<h4 id="what-you-should-see">What You Should See</h4>
+<pre><code class="lang-lisp">(<span class="hljs-name">block</span> ta-da!
+  (<span class="hljs-name">cond</span> ((<span class="hljs-name">=</span> (<span class="hljs-name">+</span> <span class="hljs-number">1</span> <span class="hljs-number">1</span>) <span class="hljs-number">2</span>)
+         (<span class="hljs-name">return-from</span> ta-da! <span class="hljs-literal">t</span>))
+        ((<span class="hljs-name">=</span> (<span class="hljs-name">+</span> <span class="hljs-number">1</span> <span class="hljs-number">1</span>) <span class="hljs-number">3</span>)
+         (<span class="hljs-name">return-from</span> ta-da! <span class="hljs-literal">nil</span>))
+        (<span class="hljs-name">t</span>
+         (<span class="hljs-name">return-from</span> ta-da! <span class="hljs-string">&quot;Wait, what?&quot;</span>))))
+T
+</code></pre>
+<h3 id="exercise-1123">Exercise 1.12.3</h3>
+<p><strong>Function and Variable Namespaces, Revisited</strong></p>
+<p>Common Lisp has seprate namespaces for Functions and Variables.  This means that you can define a function and variable within the same dynamic or lexical scope that share the same symbol name, and Lisp will generally figure out on its own which you mean by its context---<em>i.e.</em>, where in an S-Expression the symbol appears.</p>
+<h4 id="in-the-repl">In the REPL</h4>
+<pre><code class="lang-lisp">(<span class="hljs-name">defparameter</span> nonce <span class="hljs-number">1.4</span>)
+
+(<span class="hljs-name">defun</span> nonce (<span class="hljs-name">n</span>)
+  (<span class="hljs-name">*</span> (<span class="hljs-name">random</span> <span class="hljs-number">128</span>) n))
+
+(<span class="hljs-name">inspect</span> &apos;nonce)
+&gt; <span class="hljs-number">2</span>
+&gt; u
+&gt; <span class="hljs-number">3</span>
+&gt; <span class="hljs-number">0</span>
+&gt; u
+&gt; <span class="hljs-number">1</span>
+&gt; q
+</code></pre>
+<h4 id="what-you-should-see">What You Should See</h4>
+<p>You can inspect any object in Lisp.  When you inspect a symbol, you get its symbol table in the form of a menu with a new prompt, <code>&gt;</code>.  This allows you to choose an entry in the table by number, and see more information about it.  You can return to the Common Lisp REPL by entering <code>q</code>, or navigate back up a level with <code>u</code>.  When you&apos;ve defined both a variable and a function with the same name, you can then see them both in the symbol table and inspect every object that they consist of.</p>
+<pre><code class="lang-lisp">(defparameter nonce 1.4)
+NONCE
+
+(defun nonce (n)
+  (* (random 128) n))
+NONCE
+
+(inspect &apos;nonce)
+The object is a SYMBOL.
+0. Name: &quot;NONCE&quot;
+1. Package: #&lt;PACKAGE &quot;COMMON-LISP-USER&quot;&gt;
+2. Value: 1.4
+3. Function: #&lt;FUNCTION NONCE&gt;
+4. Plist: NIL
+&gt; 2
+
+The object is an ATOM:
+  1.4
+&gt; u
+...
+
+&gt; 3
+
+The object is a FUNCTION named NONCE.
+0. Lambda-list: (N)
+1. Ftype: (FUNCTION (T) (VALUES NUMBER &amp;OPTIONAL))
+&gt; 0
+
+The object is a CONS.
+0. CAR: N
+1. CDR: NIL
+&gt; u
+...
+
+&gt; 1
+
+The object is a proper list of length 3.
+0. 0: FUNCTION
+1. 1: (T)
+2. 2: (VALUES NUMBER &amp;OPTIONAL)
+&gt; q
+</code></pre>
+<h3 id="exercise-1124">Exercise 1.12.4</h3>
+<p><strong>First-Class Functions</strong></p>
+<p>As mentioned in the previous exercise, Lisp will assume that when a symbol appears in the operator position of a list, it refers to a function, and when it appears in the lambda list, it refers to the variable value.  But Common Lisp supports first-class functions, so naturally there must be a way, in parameter position, for the Lisp reader to recognize when you mean the function namespace in parameter position.</p>
+<p>This is the reader macro <code>#&apos;</code>.  Prepend it to a symbol, and the Lisp reader will know to treat that parameter as a first-class function instead of as a variable.</p>
+<h4 id="in-the-repl">In the REPL</h4>
+<pre><code class="lang-lisp">(<span class="hljs-name">mapcar</span> #&apos;nonce &apos;(<span class="hljs-number">128</span> <span class="hljs-number">123</span> <span class="hljs-number">118</span> <span class="hljs-number">113</span> <span class="hljs-number">108</span> <span class="hljs-number">103</span> <span class="hljs-number">98</span> <span class="hljs-number">93</span>))
+</code></pre>
+<h4 id="what-you-should-see">What You Should See</h4>
+<pre><code class="lang-lisp">* (<span class="hljs-name">mapcar</span> #&apos;nonce &apos;(<span class="hljs-number">128</span> <span class="hljs-number">123</span> <span class="hljs-number">118</span> <span class="hljs-number">113</span> <span class="hljs-number">108</span> <span class="hljs-number">103</span> <span class="hljs-number">98</span> <span class="hljs-number">93</span>))
+(<span class="hljs-number">13184</span> <span class="hljs-number">12300</span> <span class="hljs-number">10502</span> <span class="hljs-number">13786</span> <span class="hljs-number">3564</span> <span class="hljs-number">1751</span> <span class="hljs-number">4998</span> <span class="hljs-number">5115</span>)
+</code></pre>
+<p>First-class functions are very different than a function application that happens to be in parameter position.  Lisp code is evaluated innermost-form first, so a form in source-code can almost always be replaced by its return value---and as far as Lisp is concerned, it is.  This is known in Comp-Sci parlance as &quot;pass-by-value&quot; or &quot;call-by-value&quot;, which is to say that a form is actually evaluated to a result, and the result itself is passed to the parent form and copied---anything done to that value has no effect on the original.  For a function application, this doesn&apos;t mean much because the evaluation usually <em>computes</em> this original value in the first place---but for first-class function objects and variables, this is quite important.</p>
+<h3 id="exercise-1125">Exercise 1.12.5</h3>
+<p><strong>Symbol Names</strong></p>
+<p>Symbol names are stored as case-sensitive strings in the symbol table.  Typically, the Lisp reader upcases symbol-names when a symbol is created unless forced to do otherwise, such as with the <code>INTERN</code> function.</p>
+<h4 id="in-the-repl">In the REPL</h4>
+<pre><code class="lang-lisp">(<span class="hljs-name">symbol-name</span> &apos;pi)
+
+(<span class="hljs-name">intern</span> <span class="hljs-string">&quot;myCamelCaseSymbol&quot;</span>)
+
+(<span class="hljs-name">symbol-name</span> &apos;|myCamelCaseSymbol|)
+
+(<span class="hljs-name">symbol-name</span> &apos;cl-user::|myCamelCaseSymbol|)
+
+(<span class="hljs-name">export</span> &apos;|myCamelCaseSymbol|)
+
+(<span class="hljs-name">symbol-name</span> &apos;cl-user:|myCamelCaseSymbol|)
+</code></pre>
+<h4 id="what-you-should-see">What You Should See</h4>
+<pre><code class="lang-lisp">(symbol-name &apos;pi)
+&quot;PI&quot;
+
+(intern &quot;myCamelCaseSymbol&quot;)
+|myCamelCaseSymbol|
+NIL
+
+(symbol-name &apos;|myCamelCaseSymbol|)
+&quot;myCamelCaseSymbol&quot;
+
+;; this symbol hasn&apos;t been exported yet, so we have to refer to it using package-internal namespacing
+(symbol-name &apos;cl-user::|myCamelCaseSymbol|)
+&quot;myCamelCaseSymbol&quot;
+
+(export &apos;|myCamelCaseSymbol|)
+T
+
+;; now that we&apos;ve exported |myCamelCaseSymbol|, we can call it with package-external namespacing and import it into other packages
+(symbol-name &apos;cl-user:|myCamelCaseSymbol|)
+&quot;myCamelCaseSymbol&quot;
+</code></pre>
+<p>Symbols exist within packages, so their full name is prefixed with their package.  When your working package is the same namespace as where the symbol was interned, you can omit the package prefix---but it is still there.</p>
+<h3 id="exercise-1126">Exercise 1.12.6</h3>
+<p><strong>Packages</strong></p>
+<p>In addition to the separate Function and Variable namespaces offered by Common Lisp, your code can be organized into <em>packages</em>.  Packages allow you to design an interface to your code-base under a common name, separating the functions, variables, and other units of code from the Common Lisp language and from other libraries; as a result, they can help eliminate symbol collision as well.</p>
+<h4 id="in-the-repl">In the REPL</h4>
+<pre><code class="lang-lisp">(defpackage my-new-package)
+
+(in-package :my-new-package)
+
+(cl:defparameter *hello-world*
+  (cl:format cl:nil &quot;Hello ~A!&quot; &apos;multiverse))
+
+(cl:export &apos;*hello-world*)
+
+(cl:in-package :cl-user)
+
+my-new-package:*hello-world*
+</code></pre>
+<h4 id="what-you-should-see">What You Should See</h4>
+<pre><code class="lang-lisp">
+(defpackage my-new-package)
+#&lt;PACKAGE &quot;MY-NEW-PACKAGE&quot;&gt;
+
+(in-package :my-new-package)
+#&lt;COMMON-LISP:PACKAGE &quot;MY-NEW-PACKAGE&quot;&gt;
+
+(cl:defparameter *hello-world*
+  (cl:format cl:nil &quot;Hello ~A!&quot; &apos;multiverse))
+*HELLO-WORLD*
+
+(cl:export &apos;*hello-world*)
+T
+
+(cl:in-package :cl-user)
+#&lt;PACKAGE &quot;COMMON-LISP-USER&quot;&gt;
+
+my-new-package:*hello-world*
+&quot;Hello MULTIVERSE!&quot;
+</code></pre>
+<p>Note how in your new package, you have to explicitly namespace-resolve symbols from the Common Lisp package now in order to use them.  This can be both useful and irritating, so we will introduce how to use another package&apos;s exported symbols as if they were local symbols in a few exercises.</p>
+<h3 id="exercise-1127">Exercise 1.12.7</h3>
+<p><strong>More Packages: Nicknames</strong></p>
+<p>You can give your packages shorter, alternative nicknames which can be used for namespace-resolution on symbols, instead of having to type the full package name every single time.  You have already seen this in the previous exercise, where you had to refer to Common Lisp functions and variables prefixed with <code>cl</code>.  This is a package nickname for the <code>COMMON-LISP</code> package.</p>
+<h4 id="in-the-repl">In the REPL</h4>
+<pre><code class="lang-lisp">(defpackage my-new-package
+  (:nicknames :mnp :newpack))
+
+(in-package :my-new-package)
+
+(cl:defparameter *hello-world*
+  (cl:format cl:nil &quot;Hello ~A!&quot; &apos;multiverse))
+
+(cl:in-package :cl-user)
+
+my-new-package::*hello-world*
+
+mnp::*hello-world*
+
+newpack::*hello-world*
+</code></pre>
+<h4 id="what-you-should-see">What You Should See</h4>
+<p>You define a package&apos;s nicknames inside the <code>defpackage</code> macro.  You can have as many nicknames as you want; but like package names themselves, they have to be unique.</p>
+<pre><code class="lang-lisp">(defpackage my-new-package
+  (:nicknames :mnp :newpack))
+#&lt;PACKAGE &quot;MY-NEW-PACKAGE&quot;&gt;
+
+(in-package :my-new-package)
+#&lt;COMMON-LISP:PACKAGE &quot;MY-NEW-PACKAGE&quot;&gt;
+
+(cl:defparameter *hello-world*
+  (cl:format cl:nil &quot;Hello ~A!&quot; &apos;multiverse))
+*HELLO-WORLD*
+
+(cl:in-package :cl-user)
+#&lt;PACKAGE &quot;COMMON-LISP-USER&quot;&gt;
+
+my-new-package::*hello-world*
+&quot;Hello MULTIVERSE!&quot;
+
+mnp::*hello-world*
+&quot;Hello MULTIVERSE!&quot;
+
+newpack::*hello-world*
+&quot;Hello MULTIVERSE!&quot;
+</code></pre>
+<h3 id="exercise-1128">Exercise 1.12.8</h3>
+<p><strong>More Packages: Exporting Symbols</strong></p>
+<p>Technically, once a package and all its source code has been loaded into your Lisp image, you can call any unit of code within it by using the full symbol, <code>&lt;package-name&gt;::&lt;symbol-name&gt;</code>; but it is more convenient to export an interface to your users, which they can then <em>import</em> into their packages individually, or <em>use</em> your entire library&apos;s API.</p>
+<h4 id="in-the-repl">In the REPL</h4>
+<pre><code class="lang-lisp">(defpackage my-new-package
+  (:nicknames :mnp :newpack)
+  (:export #:*hello-world*))
+
+(in-package :my-new-package)
+
+(cl:defparameter *hello-world*
+  (cl:format cl:nil &quot;Hello ~A!&quot; &apos;multiverse))
+
+(cl:in-package :cl-user)
+
+my-new-package:*hello-world*
+
+mnp:*hello-world*
+
+newpack:*hello-world*
+</code></pre>
+<h4 id="what-you-should-see">What You Should See</h4>
+<pre><code class="lang-lisp">(defpackage my-new-package
+  (:nicknames :mnp :newpack)
+  (:export #:*hello-world*))
+#&lt;PACKAGE &quot;MY-NEW-PACKAGE&quot;&gt;
+
+(in-package :my-new-package)
+#&lt;COMMON-LISP:PACKAGE &quot;MY-NEW-PACKAGE&quot;&gt;
+
+(cl:defparameter *hello-world*
+  (cl:format cl:nil &quot;Hello ~A!&quot; &apos;multiverse))
+*HELLO-WORLD*
+
+(cl:in-package :cl-user)
+#&lt;PACKAGE &quot;COMMON-LISP-USER&quot;&gt;
+
+my-new-package:*hello-world*
+&quot;Hello MULTIVERSE!&quot;
+
+mnp:*hello-world*
+&quot;Hello MULTIVERSE!&quot;
+
+newpack:*hello-world*
+&quot;Hello MULTIVERSE!&quot;
+</code></pre>
+<p>You can export your defined units of code either with the <code>export</code> form, or specifying symbols to export in your package definition; if you try to export the same symbol twice, once from the package definition and again with <code>export</code> form, you&apos;ll trigger a condition.  Generally speaking it&apos;s considered best practice to export all your symbols from the package definition form, so that your library&apos;s API is clear and together in one place.</p>
+<h3 id="exercise-1129">Exercise 1.12.9</h3>
+<p><strong>More Packages: Using Other Packages</strong></p>
+<p>When you <em>use</em> a package in your package, you are telling Lisp to add all the exported symbols of that package to your current package-internal namespace, so that you can call any unit of code locally as if you defined it yourself in your current package.</p>
+<h4 id="in-the-repl">In the REPL</h4>
+<pre><code class="lang-lisp">(defpackage my-new-package
+  (:nicknames :mnp :newpack)
+  (:use :cl :cl-user)
+  (:export #:*hello-world*))
+
+(in-package :my-new-package)
+
+(defparameter *hello-world*
+  (format nil &quot;Hello ~A!&quot; &apos;multiverse))
+
+(in-package :cl-user)
+
+my-new-package:*hello-world*
+
+mnp:*hello-world*
+
+newpack:*hello-world*
+</code></pre>
+<h4 id="what-you-should-see">What You Should See</h4>
+<pre><code class="lang-lisp">(defpackage my-new-package
+  (:nicknames :mnp :newpack)
+  (:use :cl :cl-user)
+  (:export #:*hello-world*))
+
+(in-package :my-new-package)
+
+(defparameter *hello-world*
+  (format nil &quot;Hello ~A!&quot; &apos;multiverse))
+
+(in-package :cl-user)
+
+my-new-package:*hello-world*
+
+mnp:*hello-world*
+
+newpack:*hello-world*
+</code></pre>
+<p>The first thing you should notice is that now you no longer have to refer to symbols from the Common Lisp language proper using their package namespace from within your new package.  You will (almost) always want to, at minimum, <em>use</em> the <code>COMMON-LISP</code> package in your packages; and since you will be working a lot in the REPL from your new package, you will also want to <em>use</em> the <code>COMMON-LISP-USER</code> package as well, since in addition to the full Common Lisp language, it includes all the utilities that your Lisp implementation includes for a more complete experience.</p>
+<p>While you develop your library, it can be useful to call out units of code from other packages and libraries explicitly, using their full package-namespaced symbol, so that there is no confusion on your dev team as to what code is being called---if you find that you&apos;re relying heavily enough on a library that typing out its package nickname before each symbol becomes tedious, annoying, and a source of existential woe, that is a good indicator the library should be <em>used</em>, and your full dev team made deeply familiar with its interface.</p>
+<p>Once development is complete, you will want to remove the <code>COMMON-LISP-USER</code> package from your packages before release unless you explicitly need it.</p>
+<h3 id="exercise-11210">Exercise 1.12.10</h3>
+<p><strong>More Packages: Importing Specific Symbols</strong></p>
+<p>You won&apos;t always need to <em>use</em> a full library; more often than not, you will only need to import a handful of specific symbols.  This is another advantage of typing out the full symbol, package namespace included, while developing your library---you can search through your source code for references to a given package, and make a judgment call as to whether you need to use it or only import the symbols you need.  This helps to avoid cluttering your namespace, among other things.</p>
+<h4 id="in-the-repl">In the REPL</h4>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h4 id="what-you-should-see">What You Should See</h4>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-11211">Exercise 1.12.11</h3>
+<p><strong>More Packages: Shadowing-Imports</strong></p>
+<p>Sometimes, you will come across naming collisions between libraries you need to use, which at first glance may seem to force you to manually import, symbol by symbol, everything from a library except the offender.  That&apos;s not very efficient, however, so Lisp has you covered---you can <em>shadow-import</em>, which lets you tell Lisp exactly which symbol from which package you want to favour in the case of a naming collision.</p>
+<h4 id="in-the-repl">In the REPL</h4>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h4 id="what-you-should-see">What You Should See</h4>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="extra-credit-exercise-11212">Extra Credit Exercise 1.12.12</h3>
+<p><strong>ASDF and Systems</strong></p>
+<p>ASDF is, essentially, a build-system for Common Lisp---but that doesn&apos;t really do it justice.  For our purposes, it is a necessary tool for defining libraries for the Quicklisp package manager.</p>
+<p>ASDF focuses on the concept of a <em>System</em>.  A System is a collection of Lisp source-code files, which may or may not include a number of packages, wrapped up with some meta-data.</p>
+<p>ASDF Systems are typically defined in their own <code>*.asd</code> files, instead of <code>*.lisp</code>.  However, they are still written using Common Lisp syntax.</p>
+<h4 id="in-a-new-file">In a New File</h4>
+<p>In your <code>~/quicklisp/local-projects/</code> directory, create a subdirectory called <code>my-new-project/</code>, and in it, create a new file called <code>my-new-project.asd</code>.  The contents of this file should look like the following, with the appropriate personalizations completed:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">in-package</span> <span class="hljs-symbol">:cl-user</span>)
+
+(<span class="hljs-name">defpackage</span> my-new-project-asd
+  (<span class="hljs-symbol">:use</span> <span class="hljs-symbol">:cl</span> <span class="hljs-symbol">:cl-user</span> <span class="hljs-symbol">:asdf</span>))
+
+(<span class="hljs-name">in-package</span> <span class="hljs-symbol">:my-new-project-asd</span>)
+
+(<span class="hljs-name">defsystem</span> my-new-project
+  <span class="hljs-symbol">:version</span> <span class="hljs-string">&quot;1.0.0&quot;</span>
+  <span class="hljs-symbol">:license</span> <span class="hljs-string">&quot;MIT&quot;</span>
+  <span class="hljs-symbol">:author</span> <span class="hljs-string">&quot;A.B. &lt;a.b@example.org&gt;&quot;</span>)
+</code></pre>
+<h4 id="what-you-should-see">What You Should See</h4>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="extra-credit-exercise-11213">Extra Credit Exercise 1.12.13</h3>
+<p><strong>ASDF Systems: Dependencies</strong></p>
+<p>ASDF allows you to specify library dependencies in your system definition; the project will then not compile unless these dependencies are available.  The Quicklisp package manager uses this information to automatically resolve all dependencies when quickloading a library.</p>
+<p>If you <em>use</em> a library in any package within your project, you must include it in the system&apos;s <code>:depends-on</code> form, to ensure that it is available to your project wherever it is run or installed.</p>
+<h4 id="in-the-file">In the File</h4>
+<p>Revise <code>my-new-project.asd</code> to look like the following:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">in-package</span> <span class="hljs-symbol">:cl-user</span>)
+
+(<span class="hljs-name">defpackage</span> my-new-project-asd
+  (<span class="hljs-symbol">:use</span> <span class="hljs-symbol">:cl</span> <span class="hljs-symbol">:cl-user</span> <span class="hljs-symbol">:asdf</span>))
+
+(<span class="hljs-name">in-package</span> <span class="hljs-symbol">:my-new-project-asd</span>)
+
+(<span class="hljs-name">defsystem</span> my-new-project
+  <span class="hljs-symbol">:version</span> <span class="hljs-string">&quot;1.0.0&quot;</span>
+  <span class="hljs-symbol">:license</span> <span class="hljs-string">&quot;MIT&quot;</span>
+  <span class="hljs-symbol">:author</span> <span class="hljs-string">&quot;A.B. &lt;a.b@example.org&gt;&quot;</span>
+  <span class="hljs-symbol">:depends-on</span> (<span class="hljs-symbol">:ironclad</span>))
+</code></pre>
+<h4 id="what-you-should-see">What You Should See</h4>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="extra-credit-exercise-11214">Extra Credit Exercise 1.12.14</h3>
+<p><strong>ASDF Systems: Files</strong></p>
+<p>In the same directory as <code>my-new-project.asd</code>, create empty files for <code>packages.lisp</code> and <code>my-new-project.lisp</code>.</p>
+<p>You don&apos;t have to specify that the files you&apos;re including in components are <code>*.lisp</code> files, you only have to specify their names, without the file extension.</p>
+<h4 id="in-the-file">In the File</h4>
+<p>Revise <code>my-new-project.asd</code> to look like the following:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">in-package</span> <span class="hljs-symbol">:cl-user</span>)
+
+(<span class="hljs-name">defpackage</span> my-new-project-asd
+  (<span class="hljs-symbol">:use</span> <span class="hljs-symbol">:cl</span> <span class="hljs-symbol">:cl-user</span> <span class="hljs-symbol">:asdf</span>))
+
+(<span class="hljs-name">in-package</span> <span class="hljs-symbol">:my-new-project-asd</span>)
+
+(<span class="hljs-name">defsystem</span> my-new-project
+  <span class="hljs-symbol">:version</span> <span class="hljs-string">&quot;1.0.0&quot;</span>
+  <span class="hljs-symbol">:license</span> <span class="hljs-string">&quot;MIT&quot;</span>
+  <span class="hljs-symbol">:author</span> <span class="hljs-string">&quot;A.B. &lt;a.b@example.org&gt;&quot;</span>
+  <span class="hljs-symbol">:depends-on</span> (<span class="hljs-symbol">:ironclad</span>)
+  <span class="hljs-symbol">:serial</span> <span class="hljs-literal">t</span>
+  <span class="hljs-symbol">:components</span> ((<span class="hljs-symbol">:file</span> <span class="hljs-string">&quot;packages&quot;</span>)
+               (<span class="hljs-symbol">:file</span> <span class="hljs-string">&quot;my-new-project&quot;</span>)))
+</code></pre>
+<h4 id="what-you-should-see">What You Should See</h4>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="extra-credit-exercise-11215">Extra Credit Exercise 1.12.15</h3>
+<p><strong>ASDF Systems: Modules</strong></p>
+<p><em>Modules</em> in ASDF system definitions correspond to subdirectories of your project folder.  Your modules may correspond to their own packages---and this is a common design pattern---but they don&apos;t have to.  This is fairly different from other programming languages, where project directory structure corresponds rigidly to namespacing.  Lisp is more flexible---you can span your entire project with a single package namespace, you can give each and every file its own package, or anywhere in-between.</p>
+<h4 id="in-the-file">In the File</h4>
+<p>Revise <code>my-new-project.asd</code> to look like the following:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">in-package</span> <span class="hljs-symbol">:cl-user</span>)
+
+(<span class="hljs-name">defpackage</span> my-new-project-asd
+  (<span class="hljs-symbol">:use</span> <span class="hljs-symbol">:cl</span> <span class="hljs-symbol">:cl-user</span> <span class="hljs-symbol">:asdf</span>))
+
+(<span class="hljs-name">in-package</span> <span class="hljs-symbol">:my-new-project-asd</span>)
+
+(<span class="hljs-name">defsystem</span> my-new-project
+  <span class="hljs-symbol">:version</span> <span class="hljs-string">&quot;1.0.0&quot;</span>
+  <span class="hljs-symbol">:license</span> <span class="hljs-string">&quot;MIT&quot;</span>
+  <span class="hljs-symbol">:author</span> <span class="hljs-string">&quot;A.B. &lt;a.b@example.org&gt;&quot;</span>
+  <span class="hljs-symbol">:depends-on</span> (<span class="hljs-symbol">:ironclad</span>)
+  <span class="hljs-symbol">:serial</span> <span class="hljs-literal">t</span>
+  <span class="hljs-symbol">:components</span> ((<span class="hljs-symbol">:file</span> <span class="hljs-string">&quot;packages&quot;</span>)
+               (<span class="hljs-symbol">:module</span> <span class="hljs-string">&quot;src&quot;</span>
+                <span class="hljs-symbol">:serial</span> <span class="hljs-literal">t</span>
+                <span class="hljs-symbol">:components</span> ((<span class="hljs-symbol">:file</span> <span class="hljs-string">&quot;utils&quot;</span>)
+                             (<span class="hljs-symbol">:file</span> <span class="hljs-string">&quot;api&quot;</span>)))
+               (<span class="hljs-symbol">:file</span> <span class="hljs-string">&quot;my-new-project&quot;</span>)))
+</code></pre>
+<h4 id="what-you-should-see">What You Should See</h4>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<p>The important thing to remember about ASDF is that it has no bearing on your project&apos;s namespace and organization.  It exists to collect metadata and compilation instructions---and it doesn&apos;t care about what packages you use, or how many.  It only needs to know where to find your source-code to compile it, in the right order.</p>
+<h3 id="extra-credit-exercise-11216">Extra Credit Exercise 1.12.16</h3>
+<p><strong>ASDF Systems: Serial mode vs. Dependency Tree</strong></p>
+<p>You may have noticed in the preceding exercises a casual inclusion of the keyword <code>:serial</code> in the <code>defsystem</code> forms, set to <code>t</code>.  This is actually quite significant, as it forces each sequential file and module in the system definition to be compiled <em>in the order that they appear</em>.</p>
+<p>You do not <em>have</em> to serialize the compilation, however; and in some cases, you will not want to.  For such cases, you can explicitly define a dependency tree for each file and module, so that ASDF can work its magic in optimizing the compilation process.</p>
+<h4 id="in-the-file">In the File</h4>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h4 id="what-you-should-see">What You Should See</h4>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="extra-credit-exercise-11217">Extra Credit Exercise 1.12.17</h3>
+<p><strong>The Quicklisp Package Manager</strong></p>
+<p>Now that you have your new project configured for ASDF, you can automatically load it and all its dependencies into your current Lisp image through the Quicklisp package manager.</p>
+<p>Quicklisp runs <em>inside</em> your Lisp image, not from the command-line.</p>
+<h4 id="from-the-repl">From the REPL</h4>
+<pre><code class="lang-lisp">(<span class="hljs-name">ql</span><span class="hljs-symbol">:quickload</span> <span class="hljs-symbol">:my-new-project</span>)
+
+(<span class="hljs-name">in-package</span> <span class="hljs-symbol">:my-new-project</span>)
+</code></pre>
+<h4 id="what-you-should-see">What You Should See</h4>
+<pre><code class="lang-lisp">(ql:quickload :my-new-project)
+To load &quot;my-new-project&quot;:
+  Load 1 ASDF system:
+    my-new-project
+; Loading &quot;my-new-project&quot;
+..................................................
+[package base58]..................................
+[package cl-base64]...............................
+[package nibbles].................................
+[package ironclad]................................
+..................................................
+..................................................
+..................................................
+[package my-new-project]..
+(:MY-NEW-PROJECT)
+
+(in-package :my-new-project)
+#&lt;PACKAGE &quot;MY-NEW-PROJECT&quot;&gt;
+</code></pre>
+<p>It is considered best practice to not call Quicklisp inside your Lisp source-code, but to rely on ASDF and portable Common Lisp; for deploying executables, tools such as <code>BUILDAPP</code> will use Quicklisp automatically to retrieve dependencies and include them in your binary, without adding the overhead of the Quicklisp system to your binary.  The Lisp API to Quicklisp, however, is very useful for testing, exploring, and interactively programming with Lisp libraries from the REPL.  For example, you can now automatically load the library you&apos;ve created in this chapter into a new Lisp image, and start playing with it right away.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-11-0-text-adventure.html" class="navigation navigation-prev " aria-label="Previous page: Extra Credit: A Simple Text Adventure">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-13-0-simple-web-app.html" class="navigation navigation-next " aria-label="Next page: Extra Credit: A Simple Web Application">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Namespaces, Symbols, Packages, and Systems","level":"3.1.12","depth":2,"next":{"title":"Extra Credit: A Simple Web Application","level":"3.1.13","depth":2,"path":"1-13-0-simple-web-app.md","ref":"./1-13-0-simple-web-app.md","articles":[]},"previous":{"title":"Extra Credit: A Simple Text Adventure","level":"3.1.11","depth":2,"path":"1-11-0-text-adventure.md","ref":"./1-11-0-text-adventure.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-12-0-namespaces.md","mtime":"2022-08-22T22:47:49.767Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-13-0-simple-web-app.html b/clones/llthw.common-lisp.dev/1-13-0-simple-web-app.html
new file mode 100644
index 00000000..9bf2e904
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-13-0-simple-web-app.html
@@ -0,0 +1,1882 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Extra Credit: A Simple Web Application · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-14-0-conditionals.html" />
+    
+    
+    <link rel="prev" href="1-12-0-namespaces.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Extra Credit: A Simple Web Application</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-113-----extra-credit">Chapter 1.13 --- Extra Credit</h1>
+<h2 id="a-simple-web-application">A Simple Web Application</h2>
+<blockquote>
+<p>&quot;Life is short, but the years are long.&quot;</p>
+<footer>Robert A. Heinlein, <em>Methuselah&apos;s Children</em></footer>
+
+</blockquote>
+<p>Now that you&apos;ve gotten a taste for Lisp, how would you like to write a web-app just like the <em>Learn Lisp The Hard Way</em> site?  If you already know HTML5, CSS3, JavaScript, and one of the many options available for server-side Web Application programming available these days, such as Ruby on Rails, Python and Django, or PHP, you may be surprised, horrified, and maybe a little pleased to know that you can replace every disparate language of the Web with Common Lisp.  And if you&apos;ve never done any web development before, you can take a moment to celebrate that learning Lisp lets you program seamlessly everywhere.</p>
+<p>I know, that might be a lot to take in all at once, so let&apos;s step back and say that again.</p>
+<p>You can write a straightforward web application entirely in Common Lisp.  You don&apos;t have to write any HTML, CSS, or JavaScript. Lisp can write the markup, styling, and scripting code for you.</p>
+<p>You can take what you&apos;ve learned so far about Macros in Lisp to bundle your template code into convenient Web UI widgets.  Pair this with front-end JavaScript libraries such as Twitter Bootstrap, jQuery UI, or D3, and you have some pretty powerful UI tools with very little code.</p>
+<p>And, if you were so inclined, you could even re-write popular front-end JavaScript libraries in Lisp, so that the end-user only has to download the rendered JavaScript code that they need for their browser and the widgets you&apos;ve included in the current view, instead of the whole library.  Mobile users with limited bandwidth will certainly thank you for the greatly improved browsing experience.</p>
+<p>This chapter will contain exercises on:</p>
+<ul>
+<li>Sockets</li>
+<li>Introducing Hunchentoot</li>
+<li>Hunchentoot&apos;s Easy-Handler framework</li>
+<li>Serving Static Files</li>
+<li>REGEX Dispatchers</li>
+<li>Intro to Domain-Specific Languages (more in Ch. 1.19)</li>
+<li>Coding HTML5, CSS3, and JavaScript in Lisp</li>
+<li>Parsing Markdown</li>
+<li>Writing a simple web-app with Hunchentoot, CL-WHO, CL-CSS, Parenscript, and 3bmd</li>
+</ul>
+<h3 id="exercise-1131">Exercise 1.13.1</h3>
+<p><strong>Sockets and Streams</strong></p>
+<h3 id="exercise-1132">Exercise 1.13.2</h3>
+<p><strong>More Sockets</strong></p>
+<h3 id="exercise-1133">Exercise 1.13.3</h3>
+<p><strong>More Sockets: A Simple Echo Server</strong></p>
+<h3 id="exercise-1134">Exercise 1.13.4</h3>
+<p><strong>Introducing Hunchentoot</strong></p>
+<h3 id="exercise-1135">Exercise 1.13.5</h3>
+<p><strong>Hunchentoot&apos;s Easy-Handler Framework</strong></p>
+<h3 id="exercise-1136">Exercise 1.13.6</h3>
+<p><strong>Serving Static Files</strong></p>
+<h3 id="exercise-1137">Exercise 1.13.7</h3>
+<p><strong>REGEX Dispatchers</strong></p>
+<h3 id="exercise-1138">Exercise 1.13.8</h3>
+<p><strong>A Brief Introduction to Domain-Specific Languages</strong></p>
+<h3 id="exercise-1139">Exercise 1.13.9</h3>
+<p><strong>CL-WHO: HTML5 in Lisp</strong></p>
+<h3 id="exercise-11310">Exercise 1.13.10</h3>
+<p><strong>CL-CSS: CSS3 in Lisp</strong></p>
+<h3 id="exercise-11311">Exercise 1.13.11</h3>
+<p><strong>Parenscript: JavaScript in Lisp</strong></p>
+<h3 id="exercise-11312">Exercise 1.13.12</h3>
+<p><strong>3bmd: Parsing Markdown in Lisp</strong></p>
+<h3 id="exercise-11313">Exercise 1.13.13</h3>
+<p><strong>Your First Web Application</strong></p>
+<h3 id="extra-credit-exercise-11314">Extra Credit Exercise 1.13.14</h3>
+<p><strong>Configuring NGINX for Your Lisp Web App</strong></p>
+<h3 id="extra-credit-exercise-11315">Extra Credit Exercise 1.13.15</h3>
+<p><strong>A Distributed Lisp Web Application</strong></p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-12-0-namespaces.html" class="navigation navigation-prev " aria-label="Previous page: Namespaces, Symbols, Packages, and Systems">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-14-0-conditionals.html" class="navigation navigation-next " aria-label="Next page: Conditionals">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Extra Credit: A Simple Web Application","level":"3.1.13","depth":2,"next":{"title":"Conditionals","level":"3.1.14","depth":2,"path":"1-14-0-conditionals.md","ref":"./1-14-0-conditionals.md","articles":[]},"previous":{"title":"Namespaces, Symbols, Packages, and Systems","level":"3.1.12","depth":2,"path":"1-12-0-namespaces.md","ref":"./1-12-0-namespaces.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-13-0-simple-web-app.md","mtime":"2022-08-22T22:47:49.767Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-14-0-conditionals.html b/clones/llthw.common-lisp.dev/1-14-0-conditionals.html
new file mode 100644
index 00000000..4b59c355
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-14-0-conditionals.html
@@ -0,0 +1,1890 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Conditionals · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-15-0-command-line-utility.html" />
+    
+    
+    <link rel="prev" href="1-13-0-simple-web-app.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Conditionals</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-114">Chapter 1.14</h1>
+<h2 id="conditionals">Conditionals</h2>
+<blockquote>
+<p>&quot;Man is not a rational animal, he is a rationalizing animal.&quot;</p>
+<footer>Robert A. Heinlein, <em>Assignment in Eternity</em></footer>
+
+</blockquote>
+<p>There are a lot of times when you need to control if, when, or how a particular piece of code will be evaluated. Your code, after all, could depend on some file existing on your computer before it can run; or it expects a very specific type of data to work right; or maybe you need a very specific value, like the command parser of the Text Adventure we wrote a few chapters earlier.  If you carefully consider your expectations ahead of time, and conditionalize your code accordingly, you can eliminate many common bugs before they become compiled into your application.</p>
+<p>Conditionals are a loose, unofficial name for a subset of Control Flow functions in Common Lisp.  Their purpose is to force Lisp to pass a test before they hand over the code inside for evaluation---if the test fails, then the code within is ignored.  It&apos;s a simple idea, but an awfully important one.</p>
+<p>These tests are called <em>Predicate Functions</em>.  All they ever do is return <code>t</code> or <code>nil</code>, which in this context you can read as the boolean values <em>True</em> or <em>False</em>.  Predicate Functions take one or more parameters that you want to test, and respond with the result of that test.  Of course, in Lisp, everything that isn&apos;t <code>nil</code> (or its equivalent, the empty list <code>&apos;()</code>), is descended from <code>t</code> in the type/class hierarchy---so a test can also be any function that returns an object if successful, or <code>nil</code> if it fails.  This is useful, because it allows you to write a bare-bones simple test such as <code>(if monkey ...)</code>; if you&apos;ve bound the symbol <code>monkey</code> as a variable, and assigned it a value, <code>monkey</code> is seen as <code>t</code>---but if you&apos;ve bound it and assigned nothing to it, then it will return <code>nil</code>, the test will fail, and the <code>if</code> form will skip past the implicit &apos;then&apos; expression and look for an &apos;else&apos; expression.  The special operator <code>if</code> will be examined in detail later this chapter, after a deeper exploration of predicate functions.</p>
+<p>All high-level programming languages have Conditionals by necessity for Turing Completeness---but Lisp really goes the extra mile, providing some unique conditional forms that you won&apos;t find elsewhere.  And where Lisp doesn&apos;t provide an out-of-the-box solution, it is surprisingly easy to write the predicate functions and conditional forms you desire.</p>
+<p>This chapter will contain exercises on:</p>
+<ul>
+<li>Predicate Functions</li>
+<li>IF, WHEN, UNLESS</li>
+<li>COND</li>
+<li>CASE</li>
+</ul>
+<p>Extra Credit exercises (mostly from Alexandria):</p>
+<ul>
+<li>Exclusive-Or predicate function</li>
+<li>An implementation of WHILE</li>
+<li>SWITCH</li>
+<li>Conditional lexical variable binding</li>
+<li>DESTRUCTURING-CASE</li>
+</ul>
+<h3 id="exercise-1141">Exercise 1.14.1</h3>
+<p><strong>Predicate Functions</strong></p>
+<h3 id="exercise-1142">Exercise 1.14.2</h3>
+<p><strong>Equality Predicates</strong></p>
+<h3 id="exercise-1143">Exercise 1.14.3</h3>
+<p><strong>Equality Predicates: EQ</strong></p>
+<h3 id="exercise-1144">Exercise 1.14.4</h3>
+<p><strong>Equality Predicates: EQL</strong></p>
+<h3 id="exercise-1145">Exercise 1.14.5</h3>
+<p><strong>Equality Predicates: EQUAL</strong></p>
+<h3 id="exercise-1146">Exercise 1.14.6</h3>
+<p><strong>Equality Predicates: EQUALP</strong></p>
+<h3 id="exercise-1147">Exercise 1.14.7</h3>
+<p><strong>Numerical Equality</strong></p>
+<h3 id="exercise-1148">Exercise 1.14.8</h3>
+<p><strong>IF Special Forms</strong></p>
+<h3 id="exercise-1149">Exercise 1.14.9</h3>
+<p><strong>WHEN Macro</strong></p>
+<h3 id="exercise-11410">Exercise 1.14.10</h3>
+<p><strong>UNLESS Macro</strong></p>
+<h3 id="exercise-11411">Exercise 1.14.11</h3>
+<p><strong>COND</strong></p>
+<h3 id="exercise-11412">Exercise 1.14.12</h3>
+<p><strong>CASE</strong></p>
+<h3 id="extra-credit-exercise-11413">Extra Credit Exercise 1.14.13</h3>
+<p><strong>Additional Conditional Forms in Alexandria</strong></p>
+<h3 id="extra-credit-exercise-11414">Extra Credit Exercise 1.14.14</h3>
+<p><strong>XOR Predicate</strong></p>
+<h3 id="extra-credit-exercise-11415">Extra Credit Exercise 1.14.15</h3>
+<p><strong>WHILE</strong></p>
+<h3 id="extra-credit-exercise-11416">Extra Credit Exercise 1.14.16</h3>
+<p><strong>Switches</strong></p>
+<h3 id="extra-credit-exercise-11417">Extra Credit Exercise 1.14.17</h3>
+<p><strong>Conditional Bindings</strong></p>
+<h3 id="extra-credit-exercise-11418">Extra Credit Exercise 1.14.18</h3>
+<p><strong>DESTRUCTURING-CASE</strong></p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-13-0-simple-web-app.html" class="navigation navigation-prev " aria-label="Previous page: Extra Credit: A Simple Web Application">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-15-0-command-line-utility.html" class="navigation navigation-next " aria-label="Next page: Extra Credit: Command-Line Utilities">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Conditionals","level":"3.1.14","depth":2,"next":{"title":"Extra Credit: Command-Line Utilities","level":"3.1.15","depth":2,"path":"1-15-0-command-line-utility.md","ref":"./1-15-0-command-line-utility.md","articles":[]},"previous":{"title":"Extra Credit: A Simple Web Application","level":"3.1.13","depth":2,"path":"1-13-0-simple-web-app.md","ref":"./1-13-0-simple-web-app.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-14-0-conditionals.md","mtime":"2022-08-22T22:47:49.767Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-15-0-command-line-utility.html b/clones/llthw.common-lisp.dev/1-15-0-command-line-utility.html
new file mode 100644
index 00000000..3eb1b249
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-15-0-command-line-utility.html
@@ -0,0 +1,1865 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Extra Credit: Command-Line Utilities · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-16-0-map-loop.html" />
+    
+    
+    <link rel="prev" href="1-14-0-conditionals.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Extra Credit: Command-Line Utilities</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-115-----extra-credit">Chapter 1.15 --- Extra Credit</h1>
+<h2 id="command-line-utilities">Command-Line Utilities</h2>
+<blockquote>
+<p>&quot;The trouble with lessons from history is that we usually read them best after falling flat on our chins.&quot;</p>
+<footer>Robert A. Heinlein, <em>Starship Troopers</em></footer>
+
+</blockquote>
+<p>Underlying every modern operating system is some sort of command-line.  You may never have seen it before you began your journey with Lisp, but it&apos;s always been there---the real interface to your computer, on top of which all others are built.  Compared to what you can do from the command-line, graphical user interfaces (no matter how sleek and intuitive), are clunky and slow, and hold you back.</p>
+<p>As a programmer, all you need is this command-line---and it&apos;s worth your time to make it your best friend.  You may have even noticed how power-users seem to go out of their way to strip out the GUI from their workspace, retrofitting their OS into a souped-up 80s-style text-only terminal.  This is no mere affectation---it&apos;s all about productivity.</p>
+<p>So now we&apos;re going to begin our journey of creating distributable Lisp binaries by creating a useful utility application that you can run from the command-line yourself, without having to open up Lisp first.  It will run like any other program on your computer---and, if you have access to Windows, OS X, and Linux, you can create binary distributions of your software and provide them to your users instead of a source code release.</p>
+<p>Command-Line Interfaces may not seem like a big deal to you, at first glance.  You enter a few words in the terminal, and you get your output.  Where&apos;s the challenge in that, right?</p>
+<p>I suppose it is a matter of opinion, but in my experience, crafting a useful, productive command-line interface to an application is a much greater challenge than designing a point-and-click or touch-based GUI.  After all, when the only thing your users have to guide them is what&apos;s output by the <code>--help</code> flag, the terminal can be a scary, lonely place if you didn&apos;t put enough thought into the arguments and documentation for your application.</p>
+<p>This chapter will contain exercises on:</p>
+<ul>
+<li>Manually parsing arguments from the command-line</li>
+<li>Introducing CLON: The Command-Line Options Nuker</li>
+<li>Loading Quicklisp in Lisp Scripts, but mention that it is considered &apos;bad practice&apos;</li>
+<li>Defining Your Application&apos;s Synopsis</li>
+<li>Defining Your Application&apos;s Event Loop</li>
+<li>Dumping Binaries</li>
+<li>Distributing your Text-Adventure as a Binary</li>
+<li>Deploying your Web App as a Daemon</li>
+</ul>
+<h3 id="exercise-1151">Exercise 1.15.1</h3>
+<p><strong>Manually parsing arguments from the command-line</strong></p>
+<h3 id="exercise-1152">Exercise 1.15.2</h3>
+<p><strong>Introducing CLON: The Command-Line Options Nuker</strong></p>
+<h3 id="exercise-1153">Exercise 1.15.3</h3>
+<p><strong>CLON: Synopsis</strong></p>
+<h3 id="exercise-1154">Exercise 1.15.4</h3>
+<p><strong>CLON: Event Loop</strong></p>
+<h3 id="exercise-1155">Exercise 1.15.5</h3>
+<p><strong>Introducing Buildapp</strong></p>
+<h3 id="exercise-1156">Exercise 1.15.6</h3>
+<p><strong>Rewrite Your Text-Adventure to Use CLON and Buildapp</strong></p>
+<h3 id="exercise-1157">Exercise 1.15.7</h3>
+<p><strong>Rewrite Your Web App as a Daemon</strong></p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-14-0-conditionals.html" class="navigation navigation-prev " aria-label="Previous page: Conditionals">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-16-0-map-loop.html" class="navigation navigation-next " aria-label="Next page: Mapping and Looping">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Extra Credit: Command-Line Utilities","level":"3.1.15","depth":2,"next":{"title":"Mapping and Looping","level":"3.1.16","depth":2,"path":"1-16-0-map-loop.md","ref":"./1-16-0-map-loop.md","articles":[]},"previous":{"title":"Conditionals","level":"3.1.14","depth":2,"path":"1-14-0-conditionals.md","ref":"./1-14-0-conditionals.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-15-0-command-line-utility.md","mtime":"2022-08-22T22:47:49.767Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-16-0-map-loop.html b/clones/llthw.common-lisp.dev/1-16-0-map-loop.html
new file mode 100644
index 00000000..3a0b8b54
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-16-0-map-loop.html
@@ -0,0 +1,1892 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Mapping and Looping · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-17-0-iterate.html" />
+    
+    
+    <link rel="prev" href="1-15-0-command-line-utility.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Mapping and Looping</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-116">Chapter 1.16</h1>
+<h2 id="mapping-and-looping">Mapping and Looping</h2>
+<blockquote>
+<p>&quot;Excuse me, Doctor; I did not mean to criticize your planet.&quot;</p>
+<footer>Robert A. Heinlein, <em>The Moon Is a Harsh Mistress</em></footer>
+
+</blockquote>
+<p>As a contrast to Conditionals, sometimes you&apos;ll want to do exactly the same thing to each item in a whole list or sequence; or maybe not <em>exactly</em> the same thing, but very similar things. Once again, Lisp has you covered---there are quite a few built-in options for iteration over lists, sets, sequences, hash tables, and other such objects.  Basic iteration is covered by the &quot;DO&quot; series of functions.</p>
+<p>Mapping is a different beast than iteration, but you may find a certain synchronicity between the two topics that help you understand both better. For example, if you have two lists, and you want to pair the values of one list with the values of the other, you can map them together using the <code>cons</code> function to get an alist as key-value pairs---and you can see here the similarity between mapping and looping.</p>
+<p>Lisp also has the functions <code>apply</code> and <code>reduce</code>, of course---<code>apply</code> takes a function as its first argument, and then applies that function to the rest of the arguments you pass it, the last of which must be a list; <code>reduce</code> is somewhat similar, but it works with sequences and allows you to specify a number of extra parameters for finer control.</p>
+<p>And then there&apos;s the infamous and oft-criticized <code>LOOP</code> macro---it gets a lot of flak for not being &quot;Lispy&quot; enough, but it&apos;s so powerful that it has stuck around.  It has its own internal syntax that looks more like imperative languages than like Lisp, however, it includes the functionality for every possible iterative construct you could ever hope or dream for.</p>
+<p>This chapter will contain exercises on:</p>
+<ul>
+<li><code>DO</code> and <code>DO*</code></li>
+<li><code>DOTIMES</code></li>
+<li><code>DOLIST</code></li>
+<li><code>MAP</code></li>
+<li><code>MAPC</code> and <code>MAPL</code></li>
+<li>Other Mapping Functions</li>
+<li><code>APPLY</code> and <code>REDUCE</code></li>
+<li>The <code>LOOP</code> Macro</li>
+</ul>
+<h3 id="exercise-1161">Exercise 1.16.1</h3>
+<p><strong>Iteration</strong></p>
+<h3 id="exercise-1162">Exercise 1.16.2</h3>
+<p><strong>DO</strong></p>
+<h3 id="exercise-1163">Exercise 1.16.3</h3>
+<p><strong>DO*</strong></p>
+<h3 id="exercise-1164">Exercise 1.16.4</h3>
+<p><strong>DOTIMES</strong></p>
+<h3 id="exercise-1165">Exercise 1.16.5</h3>
+<p><strong>DOLIST</strong></p>
+<h3 id="exercise-1166">Exercise 1.16.6</h3>
+<p><strong>Mapping</strong></p>
+<h3 id="exercise-1167">Exercise 1.16.7</h3>
+<p><strong>MAP</strong></p>
+<h3 id="exercise-1168">Exercise 1.16.8</h3>
+<p><strong>MAPC</strong></p>
+<h3 id="exercise-1169">Exercise 1.16.9</h3>
+<p><strong>MAPL</strong></p>
+<h3 id="exercise-11610">Exercise 1.16.10</h3>
+<p><strong>MAPCAR</strong></p>
+<h3 id="exercise-11611">Exercise 1.16.11</h3>
+<p><strong>MAPCAN</strong></p>
+<h3 id="exercise-11612">Exercise 1.16.12</h3>
+<p><strong>MAPHASH</strong></p>
+<h3 id="exercise-11613">Exercise 1.16.13</h3>
+<p><strong>MAPCON</strong></p>
+<h3 id="exercise-11614">Exercise 1.16.14</h3>
+<p><strong>MAP-INTO</strong></p>
+<h3 id="exercise-11615">Exercise 1.16.15</h3>
+<p><strong>APPLY</strong></p>
+<h3 id="exercise-11616">Exercise 1.16.16</h3>
+<p><strong>More APPLY</strong></p>
+<h3 id="exercise-11617">Exercise 1.16.17</h3>
+<p><strong>REDUCE</strong></p>
+<h3 id="exercise-11618">Exercise 1.16.18</h3>
+<p><strong>More REDUCE</strong></p>
+<h3 id="exercise-11619">Exercise 1.16.19</h3>
+<p><strong>The LOOP Macro</strong></p>
+<h3 id="exercise-11620">Exercise 1.16.20</h3>
+<p><strong>More LOOP</strong></p>
+<h3 id="exercise-11621">Exercise 1.16.21</h3>
+<p><strong>Even More LOOP</strong></p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-15-0-command-line-utility.html" class="navigation navigation-prev " aria-label="Previous page: Extra Credit: Command-Line Utilities">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-17-0-iterate.html" class="navigation navigation-next " aria-label="Next page: Extra Credit: Revisiting Loops with Iterate">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Mapping and Looping","level":"3.1.16","depth":2,"next":{"title":"Extra Credit: Revisiting Loops with Iterate","level":"3.1.17","depth":2,"path":"1-17-0-iterate.md","ref":"./1-17-0-iterate.md","articles":[]},"previous":{"title":"Extra Credit: Command-Line Utilities","level":"3.1.15","depth":2,"path":"1-15-0-command-line-utility.md","ref":"./1-15-0-command-line-utility.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-16-0-map-loop.md","mtime":"2022-08-22T22:47:49.767Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-17-0-iterate.html b/clones/llthw.common-lisp.dev/1-17-0-iterate.html
new file mode 100644
index 00000000..2ab53095
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-17-0-iterate.html
@@ -0,0 +1,1876 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Extra Credit: Revisiting Loops with Iterate · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-18-0-format.html" />
+    
+    
+    <link rel="prev" href="1-16-0-map-loop.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Extra Credit: Revisiting Loops with Iterate</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-117-----extra-credit">Chapter 1.17 --- Extra Credit</h1>
+<h2 id="revisiting-loops-with-iterate">Revisiting Loops with Iterate</h2>
+<blockquote>
+<p>&quot;People do what they want to, every time.  If it pains them to make a choice---if the choice looks like a &apos;sacrifice&apos;---you can be sure that it is no nobler than the discomfort caused by greediness... the necessity of deciding between two things you want when you can&apos;t have both.&quot;</p>
+<footer>Robert A. Heinlein, <em>Stranger In a Strange Land</em></footer>
+
+</blockquote>
+<p>Despite the power and expressiveness of the Loop Macro, a lot of Lisp Hackers simply hate it---naturally, in the roll-your-own-solution spirit of the Lisp community, many alternatives to the Loop Macro exist.  The most popular and Lispy of these is the ITERATE package.  It&apos;s aim is to provide all the power and expressiveness of the Loop Macro, without changing the fundamental syntax of the language for its own internal use---this implies, among other things of course, that you can build macros on top of Iterate and expand S-Expression code the way you normally would, instead of having to use strange hacks and bad style to achieve your desired effect with Loop.</p>
+<p>Iterate is also extensible by design, so if it&apos;s missing some construct you happen to need, you can roll-your-own driver and use it like any other Iterate driver; or go the extra mile and package a number of Iterate extensions together in a contrib-library.  That&apos;s a feature that the built-in Loop macro can&apos;t provide.</p>
+<p>After learning how to use the Iterate library and trying it out in a few projects, some Lisp Hackers still end up going back to Loop; but this is not an exercise in vain---learning Iterate and its strategy to iteration compared to the built-in Loop macro is an extremely useful exercise.  And at the end of this chapter, you will have a much better understanding of both Iterate and Loop, and which solution fits your needs the best.</p>
+<p>This chapter will contain exercises on:</p>
+<ul>
+<li>Setting up your package to use Iterate</li>
+<li>A few side-by-side examples with Loop</li>
+<li>Iterate Clauses</li>
+<li>Iterate Drivers</li>
+<li>Variable Binding and Setting in Iterate</li>
+<li>Gathering Clauses</li>
+<li>Multiple Accumulations</li>
+<li>Parallel Binding and Stepping</li>
+<li>Types and Declarations</li>
+</ul>
+<h3 id="exercise-1171">Exercise 1.17.1</h3>
+<p><strong>Configuring Packages for Iterate</strong></p>
+<h3 id="exercise-1172">Exercise 1.17.2</h3>
+<p><strong>Iterate vs. Loop</strong></p>
+<h3 id="exercise-1173">Exercise 1.17.3</h3>
+<p><strong>Clauses</strong></p>
+<h3 id="exercise-1174">Exercise 1.17.4</h3>
+<p><strong>More Clauses</strong></p>
+<h3 id="exercise-1175">Exercise 1.17.5</h3>
+<p><strong>Even More Clauses</strong></p>
+<h3 id="exercise-1176">Exercise 1.17.6</h3>
+<p><strong>Drivers</strong></p>
+<h3 id="exercise-1177">Exercise 1.17.7</h3>
+<p><strong>More Drivers</strong></p>
+<h3 id="exercise-1178">Exercise 1.17.8</h3>
+<p><strong>Binding and Assignment</strong></p>
+<h3 id="exercise-1179">Exercise 1.17.9</h3>
+<p><strong>Accumulation</strong></p>
+<h3 id="exercise-11710">Exercise 1.17.10</h3>
+<p><strong>Multiple Accumulation</strong></p>
+<h3 id="exercise-11711">Exercise 1.17.11</h3>
+<p><strong>Parallel Binding</strong></p>
+<h3 id="exercise-11712">Exercise 1.17.12</h3>
+<p><strong>Stepping</strong></p>
+<h3 id="exercise-11713">Exercise 1.17.13</h3>
+<p><strong>Types and Declarations</strong></p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-16-0-map-loop.html" class="navigation navigation-prev " aria-label="Previous page: Mapping and Looping">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-18-0-format.html" class="navigation navigation-next " aria-label="Next page: Format Strings">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Extra Credit: Revisiting Loops with Iterate","level":"3.1.17","depth":2,"next":{"title":"Format Strings","level":"3.1.18","depth":2,"path":"1-18-0-format.md","ref":"./1-18-0-format.md","articles":[]},"previous":{"title":"Mapping and Looping","level":"3.1.16","depth":2,"path":"1-16-0-map-loop.md","ref":"./1-16-0-map-loop.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-17-0-iterate.md","mtime":"2022-08-22T22:47:49.767Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-18-0-format.html b/clones/llthw.common-lisp.dev/1-18-0-format.html
new file mode 100644
index 00000000..75175b1f
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-18-0-format.html
@@ -0,0 +1,1881 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Format Strings · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-19-0-dsl.html" />
+    
+    
+    <link rel="prev" href="1-17-0-iterate.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Format Strings</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-118">Chapter 1.18</h1>
+<h2 id="format-strings">Format Strings</h2>
+<blockquote>
+<p>&quot;Logic is a feeble reed, friend. &apos;Logic&apos; proved that airplanes can&apos;t fly and that H-bombs won&apos;t work and that stones don&apos;t fall out of the sky. Logic is a way of saying that anything which didn&apos;t happen yesterday won&apos;t happen tomorrow.&quot;</p>
+<footer>Robert A. Heinlein, <em>Glory Road</em></footer>
+
+</blockquote>
+<p>You already got a small taste of <code>format</code> in Chapter 1.2, but we barely scratched the surface of what it can do.  Like the Loop macro, <code>format</code> has many detractors in the Lisp community---but it&apos;s one of those tools that is so ridiculously powerful and concise, it&apos;s worth getting to know and using, no matter how scary it might look at first.</p>
+<p>Almost everything you can do in Common Lisp, you can also do inside a format string.  It gives you so much programmatic control over your application&apos;s textual output, that it could rightly be considered its own programming language for manipulating strings---but you get it for free as part of Lisp.  The syntax of format strings is, in-fact, a full Domain-Specific Language.</p>
+<p>But don&apos;t let that scare you---you already know the basics of writing format strings, and now you know enough about Lisp to make use of format&apos;s most powerful features.</p>
+<p>This chapter will contain exercises on:</p>
+<ul>
+<li>The FORMAT Function</li>
+<li>Conditionals</li>
+<li>Iteration</li>
+<li>Numbers</li>
+<li>Unprintable Objects</li>
+<li>Etc.</li>
+</ul>
+<h3 id="exercise-1181">Exercise 1.18.1</h3>
+<p><strong>The FORMAT Function</strong></p>
+<h3 id="exercise-1182">Exercise 1.18.2</h3>
+<p><strong>The Stream Parameter</strong></p>
+<h3 id="exercise-1183">Exercise 1.18.3</h3>
+<p><strong>Format Strings</strong></p>
+<h3 id="exercise-1184">Exercise 1.18.4</h3>
+<p><strong>Format Directives</strong></p>
+<h3 id="exercise-1185">Exercise 1.18.5</h3>
+<p><strong>Consuming and Non-Consuming Directives</strong></p>
+<h3 id="exercise-1186">Exercise 1.18.6</h3>
+<p><strong>Arguments to Format Strings</strong></p>
+<h3 id="exercise-1187">Exercise 1.18.7</h3>
+<p><strong>Numbers</strong></p>
+<h3 id="exercise-1188">Exercise 1.18.8</h3>
+<p><strong>Printing</strong></p>
+<h3 id="exercise-1189">Exercise 1.18.9</h3>
+<p><strong>Case Conversion</strong></p>
+<h3 id="exercise-11810">Exercise 1.18.10</h3>
+<p><strong>Layout</strong></p>
+<h3 id="exercise-11811">Exercise 1.18.11</h3>
+<p><strong>Conditionals</strong></p>
+<h3 id="exercise-11812">Exercise 1.18.12</h3>
+<p><strong>Iteration</strong></p>
+<h3 id="exercise-11813">Exercise 1.18.13</h3>
+<p><strong>Control Flow</strong></p>
+<h3 id="exercise-11814">Exercise 1.18.14</h3>
+<p><strong>Pretty-Printing</strong></p>
+<h3 id="exercise-11815">Exercise 1.18.15</h3>
+<p><strong>Unprintable Objects</strong></p>
+<h3 id="exercise-11816">Exercise 1.18.16</h3>
+<p><strong>Recursive Processing</strong></p>
+<h3 id="exercise-11817">Exercise 1.18.17</h3>
+<p><strong>Function Calls</strong></p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-17-0-iterate.html" class="navigation navigation-prev " aria-label="Previous page: Extra Credit: Revisiting Loops with Iterate">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-19-0-dsl.html" class="navigation navigation-next " aria-label="Next page: Extra Credit: Domain Specific Languages">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Format Strings","level":"3.1.18","depth":2,"next":{"title":"Extra Credit: Domain Specific Languages","level":"3.1.19","depth":2,"path":"1-19-0-dsl.md","ref":"./1-19-0-dsl.md","articles":[]},"previous":{"title":"Extra Credit: Revisiting Loops with Iterate","level":"3.1.17","depth":2,"path":"1-17-0-iterate.md","ref":"./1-17-0-iterate.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-18-0-format.md","mtime":"2022-08-22T22:47:49.767Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-19-0-dsl.html b/clones/llthw.common-lisp.dev/1-19-0-dsl.html
new file mode 100644
index 00000000..9c77c3cf
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-19-0-dsl.html
@@ -0,0 +1,1897 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Extra Credit: Domain Specific Languages · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-20-0-review.html" />
+    
+    
+    <link rel="prev" href="1-18-0-format.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Extra Credit: Domain Specific Languages</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-119-----extra-credit">Chapter 1.19 --- Extra Credit</h1>
+<h2 id="domain-specific-languages">Domain-Specific Languages</h2>
+<blockquote>
+<p>&quot;Most of us know the code is wrong; almost everybody breaks it. But we pay Danegeld by feeling guilty and giving lip service. Willy-nilly, the code rides us, dead and stinking, an albatross around the neck.&quot;</p>
+<footer>Robert A. Heinlein, <em>Stranger In a Strange Land</em></footer>
+
+</blockquote>
+<p>You&apos;ve already seen a number of Domain-Specific Languages in Lisp---to recap, a DSL is a convenient, embedded syntax, purpose-designed to achieve natural expression of a problem domain that falls outside the realm of the host programming language and its native syntax.  Common Lisp even comes with two notable DSLs baked into the core language specification---the Loop macro and Format strings.  Love &apos;em or hate &apos;em, Loop and Format were purpose-designed, provide essential functionality, and fulfill their purposes with internally consistent syntaxes.</p>
+<p>But you&apos;ve also had a chance to play with DSLs for HTML/XML, CSS, and JavaScript.  Lisp makes it surprisingly easy, compared to other programming languages, to roll-your-own DSL for whatever problem domain you have to deal with.  This goes above and beyond writing a library of functions, macros, classes and methods.  You write a Domain-Specific Language when even a full, native Lisp library won&apos;t solve your problem---because the problem requires a different way of thinking to express.  The DSLs for HTML/XML, CSS, and JavaScript are good examples to illustrate this point---after all, if they weren&apos;t absolutely necessary to make the world-wide-web of today a reality, they wouldn&apos;t exist.</p>
+<p>Structured Data is fundamental to the web; search engines rely on it to correctly parse and catalogue every website on the internet, so that you can get to the information you need when you need it.  But XML can be a tedious language to work with, if you find yourself having to hand-edit it; this is why so many full-time XML developers avoid doing so---they prefer using expensive software to manage their XML code in a sensible way, visually.  HTML is much the same---even though it is not as tedious to work with as the full XML spec, many professional web developers prefer using WYSIWYG editors to develop their web templates, never even looking at a single line of HTML if they can help it.</p>
+<p>CSS is just as important---it is purpose-designed for dictating the rendering rules for structured data in HTML and XML, for multiple output formats.  And then there&apos;s JavaScript---the little web scripting language that has taken the world by storm, despite its obvious limitations and logical problems.</p>
+<p>The problem domains that these web languages handle are real---and obviously, they meet their need or people wouldn&apos;t use them.  Now, I&apos;ve said before that you can replace them all with Lisp, and as you&apos;ve seen, it&apos;s much easier to manage a single Lisp code-base than having to constantly shift gears to switch between the distinct paradigms required for writing Markup, Styling, Scripting, and Logic code.  But that being said, it&apos;s important to remember the distinct problem domains; when you approach a DSL, you have to make sure it solves the problem on its own terms and not the terms of the host language.</p>
+<p>Now it&apos;s time to learn how to write your own DSL.  It&apos;s a much bigger challenge than anything else we&apos;ve covered so far---but the rewards are equal to the effort.  Being able to write a clean, native Lisp interface to any imaginable problem-domain is one of the language&apos;s greatest strengths.</p>
+<p>This chapter will contain exercises on:</p>
+<ul>
+<li>Lisp Macros and DSLs</li>
+<li>A brief tour of popular problem-domains</li>
+<li>Overview of S-SQL, a DSL for writing SQL queries with S-Expressions</li>
+<li>Write your own DSL!<ul>
+<li>Choosing a problem domain</li>
+<li>Identify a domain&apos;s most natural expression</li>
+<li>Write out how you would <em>like</em> the DSL to work</li>
+<li>Implementing the syntax of your DSL</li>
+</ul>
+</li>
+</ul>
+<h3 id="exercise-1191">Exercise 1.19.1</h3>
+<p><strong>Lisp Macros and DSLs</strong>:</p>
+<p>When standard functions fail to meet your needs, using the macro definition syntax you learned in Chapter 1.10 you can manipulate Lisp syntax in order to create a DSL that&apos;s perfectly suited to your needs and a specialized problem domain.  You have already seen several DSLs in action, two of which are built right into the Common Lisp standard: LOOP and FORMAT strings.  They also represent two different approaches to DSLs---inline syntax and string-parsing.</p>
+<p>One advantage to string-parsing is that you can write functions to parse your strings instead of writing macros.  This is how FORMAT is implemented in Common Lisp.</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">format</span> <span class="hljs-literal">nil</span> <span class="hljs-string">&quot;~A&quot;</span> &apos;format)
+</code></pre>
+<p>Of course with inline syntax, your DSLs expand to native Common Lisp code, instead of having to be parsed before you can build an abstract syntax tree; and while the LOOP macro doesn&apos;t use S-Expressions in its internal syntax, you can certainly take advantage of them in your DSL to get all the other benefits of Lisp you&apos;ve learned so far.</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">loop</span> for x below <span class="hljs-number">10</span> collect x)
+</code></pre>
+<p>Compare this again to an S-Expression syntax using Iterate:</p>
+<pre><code class="lang-lisp">(<span class="hljs-name">ql</span><span class="hljs-symbol">:quickload</span> <span class="hljs-string">&quot;iterate&quot;</span>)
+(<span class="hljs-name">use-package</span> &apos;iterate)
+(<span class="hljs-name">iterate</span> (<span class="hljs-name">for</span> x below <span class="hljs-number">10</span>)
+         (<span class="hljs-name">collect</span> x))
+</code></pre>
+<p><strong>Note:</strong> <em>If you get errors &apos;using&apos; the iterate package, follow the debugger instructions to shadow the cl-user package functions with iterate.</em></p>
+<p>These LOOP and Iterate examples are equivalent, and are both equally fast.  The main advantage to Iterate over the built-in LOOP macro is that it uses S-Expressions, so you can more easily embed Iterate in other macros, and reason about Iterate code through code-walking.  These are important points to consider when designing your own DSL.</p>
+<h3 id="exercise-1192">Exercise 1.19.2</h3>
+<p><strong>A brief tour of popular problem-domains</strong>:</p>
+<ul>
+<li>Logic Programming</li>
+<li>Graphics Programming</li>
+<li>Mark-up</li>
+<li>Assembly and Byte-Code</li>
+</ul>
+<h3 id="exercise-1193">Exercise 1.19.3</h3>
+<p><strong>Overview of S-SQL, a DSL for writing SQL queries in S-Expression syntax</strong>:</p>
+<ul>
+<li>Keyword Expressions</li>
+<li>SQL Queries</li>
+<li>Re-ordering of Expressions</li>
+<li>Handling results</li>
+</ul>
+<h3 id="exercise-1194">Exercise 1.19.4</h3>
+<p><strong>Write your own DSL! Overview of Methodology</strong>:</p>
+<h3 id="exercise-1195">Exercise 1.19.5</h3>
+<p><strong>Write your own DSL! Choosing a problem domain</strong>:</p>
+<h3 id="exercise-1196">Exercise 1.19.6</h3>
+<p><strong>Write your own DSL! Identify a domain&apos;s most natural expression</strong>:</p>
+<h3 id="exercise-1197">Exercise 1.19.7</h3>
+<p><strong>Write your own DSL! Write out how you would like the DSL to work</strong>:</p>
+<h3 id="exercise-1198">Exercise 1.19.8</h3>
+<p><strong>Write your own DSL! Implementing the syntax of your DSL</strong>:</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-18-0-format.html" class="navigation navigation-prev " aria-label="Previous page: Format Strings">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-20-0-review.html" class="navigation navigation-next " aria-label="Next page: Part One in Review">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Extra Credit: Domain Specific Languages","level":"3.1.19","depth":2,"next":{"title":"Part One in Review","level":"3.1.20","depth":2,"path":"1-20-0-review.md","ref":"./1-20-0-review.md","articles":[]},"previous":{"title":"Format Strings","level":"3.1.18","depth":2,"path":"1-18-0-format.md","ref":"./1-18-0-format.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-19-0-dsl.md","mtime":"2022-08-22T22:47:49.767Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/1-20-0-review.html b/clones/llthw.common-lisp.dev/1-20-0-review.html
new file mode 100644
index 00000000..86458a58
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/1-20-0-review.html
@@ -0,0 +1,1845 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Part One in Review · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-0-0-overview.html" />
+    
+    
+    <link rel="prev" href="1-19-0-dsl.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Part One in Review</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-120">Chapter 1.20</h1>
+<h2 id="part-one-in-review">Part One in Review</h2>
+<blockquote>
+<p>&quot;To the scientific mind, experimental proof is all important and theory is merely a convenience in description, to be junked when it no longer fits.&quot;</p>
+<footer>Robert A. Heinlein, <em>Life-Line</em></footer>
+
+</blockquote>
+<p>You&apos;ve finally reached the end of Part One.  By this point, you should have a solid grounding in the fundamentals of Lisp, be able to write and distribute your own text-based Lisp applications as both source code libraries and self-contained binaries, and run your own Lisp-powered web sites.  You&apos;ve even got a few games to play!</p>
+<p>But you&apos;re not done yet.  To make sure you&apos;re ready for Part Two, and the rest of the Lisp language, you need to assess how deeply you&apos;ve internalized Lisp so far.  I present to you three challenges that will push you and your new-found skills to their limits:</p>
+<ul>
+<li>First Challenge: review, categorize, and memorize all Symbols used in Part One</li>
+<li>Second Challenge: describe Lisp Syntax from memory, and categorize by theme</li>
+<li>Third Challenge: code review of random CL library---compare its style with the style guide, profile improvements, get it to run</li>
+</ul>
+<p>If any of these challenges stump you, you may need to go back and re-do the related exercises before moving on to Part Two.  But once you can complete these three challenges, it&apos;s time to give yourself a pat on the back and celebrate!  You&apos;re now a novice Lisp Hacker!</p>
+<p>Also be sure to save your notes from these three challenges, and take a week off to let this material sink in.  Once you&apos;re ready to start Part Two, you can refer to your notes to trigger your memory.</p>
+<p>See you in Part Two!</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-19-0-dsl.html" class="navigation navigation-prev " aria-label="Previous page: Extra Credit: Domain Specific Languages">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-0-0-overview.html" class="navigation navigation-next " aria-label="Next page: The Suffusion of Blue">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Part One in Review","level":"3.1.20","depth":2,"next":{"title":"The Suffusion of Blue","level":"4.1","depth":1,"path":"2-0-0-overview.md","ref":"2-0-0-overview.md","articles":[{"title":"Programming Paradigms","level":"4.1.1","depth":2,"path":"2-01-0-programming-paradigms.md","ref":"./2-01-0-programming-paradigms.md","articles":[]},{"title":"Extra Credit: Regular Expressions","level":"4.1.2","depth":2,"path":"2-02-0-regex.md","ref":"./2-02-0-regex.md","articles":[]},{"title":"Objects and Control Structures","level":"4.1.3","depth":2,"path":"2-03-0-objects-control.md","ref":"./2-03-0-objects-control.md","articles":[]},{"title":"Extra Credit: Persistence and Databases","level":"4.1.4","depth":2,"path":"2-04-0-data-persistence.md","ref":"./2-04-0-data-persistence.md","articles":[]},{"title":"Extended Types","level":"4.1.5","depth":2,"path":"2-05-0-extended-types.md","ref":"./2-05-0-extended-types.md","articles":[]},{"title":"Extra Credit: Concurrency and Memoization","level":"4.1.6","depth":2,"path":"2-06-0-threads-memos-parallel.md","ref":"./2-06-0-threads-memos-parallel.md","articles":[]},{"title":"Logic and Advanced Math","level":"4.1.7","depth":2,"path":"2-07-0-logic-and-more-math.md","ref":"./2-07-0-logic-and-more-math.md","articles":[]},{"title":"Extra Credit: Number Theory","level":"4.1.8","depth":2,"path":"2-08-0-number-theory.md","ref":"./2-08-0-number-theory.md","articles":[]},{"title":"Binary Streams, Octet-Vectors, and Bit-Vectors","level":"4.1.9","depth":2,"path":"2-09-0-binary-octets-bits.md","ref":"./2-09-0-binary-octets-bits.md","articles":[]},{"title":"Extra Credit: An Improved Text Adventure Engine","level":"4.1.10","depth":2,"path":"2-10-0-improved-text-adventure-engine.md","ref":"./2-10-0-improved-text-adventure-engine.md","articles":[]},{"title":"Conditions and Error Handling","level":"4.1.11","depth":2,"path":"2-11-0-conditions.md","ref":"./2-11-0-conditions.md","articles":[]},{"title":"Extra Credit: Write a 2D Game","level":"4.1.12","depth":2,"path":"2-12-0-2d-game.md","ref":"./2-12-0-2d-game.md","articles":[]},{"title":"The Compiler","level":"4.1.13","depth":2,"path":"2-13-0-compiler.md","ref":"./2-13-0-compiler.md","articles":[]},{"title":"Extra Credit: Write a Tree-Shaker","level":"4.1.14","depth":2,"path":"2-14-0-tree-shaker.md","ref":"./2-14-0-tree-shaker.md","articles":[]},{"title":"Documentation and Inspection","level":"4.1.15","depth":2,"path":"2-15-0-docs-and-inspection.md","ref":"./2-15-0-docs-and-inspection.md","articles":[]},{"title":"Extra Credit: Foreign Libraries in Lisp","level":"4.1.16","depth":2,"path":"2-16-0-foreign-libs.md","ref":"./2-16-0-foreign-libs.md","articles":[]},{"title":"Debugging and Unit Testing","level":"4.1.17","depth":2,"path":"2-17-0-debugging-testing.md","ref":"./2-17-0-debugging-testing.md","articles":[]},{"title":"Extra Credit: Write a Foreign Function Interface","level":"4.1.18","depth":2,"path":"2-18-0-ffi.md","ref":"./2-18-0-ffi.md","articles":[]},{"title":"Essential Lisp Libraries","level":"4.1.19","depth":2,"path":"2-19-0-essential-libs.md","ref":"./2-19-0-essential-libs.md","articles":[]},{"title":"Extra Credit: Packaging Lisp Libraries","level":"4.1.20","depth":2,"path":"2-20-0-packaging-libs.md","ref":"./2-20-0-packaging-libs.md","articles":[]},{"title":"Detailed Syntax Review","level":"4.1.21","depth":2,"path":"2-21-0-review.md","ref":"./2-21-0-review.md","articles":[]}]},"previous":{"title":"Extra Credit: Domain Specific Languages","level":"3.1.19","depth":2,"path":"1-19-0-dsl.md","ref":"./1-19-0-dsl.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"1-20-0-review.md","mtime":"2022-08-22T22:47:49.767Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-0-0-overview.html b/clones/llthw.common-lisp.dev/2-0-0-overview.html
new file mode 100644
index 00000000..58d7b6ba
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-0-0-overview.html
@@ -0,0 +1,1862 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>The Suffusion of Blue · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-01-0-programming-paradigms.html" />
+    
+    
+    <link rel="prev" href="1-20-0-review.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter active" data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >The Suffusion of Blue</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="part-two">PART TWO</h1>
+<h2 id="the-suffusion-of-blue">The Suffusion of Blue</h2>
+<blockquote>
+<p>&quot;The door dilated.&quot;</p>
+<footer>Robert A. Heinlein, <em>Beyond This Horizon</em></footer>
+
+</blockquote>
+<p>It&apos;s time to take your Lisp skills up a notch.  Hopefully, you took some time off after Part One as suggested, to let the material sink in deep into your unconscious.  By this point, you may be thinking and dreaming in Lisp---literally.  And when faced with any problem, you may find yourself automatically plotting in your mind how this problem could be represented in S-Expressions.  Ideally, you even may have begun to notice the drastic and startling phenomenon of &quot;Grokking&quot;---each new chapter in Part One adding a new degree of seeming mystic revelation to the already magickal experience that is Lisp.</p>
+<p>As Zen Buddhism teaches, however, it is important to not get sucked in to the particular <em>tokens</em> of these revelatory experiences---they are, after all, a product of your imagination fuelled by the power and expressiveness of Lisp syntax.  To really harness and master Lisp, however, you need to push past these tokens to the phenomenon known as <em>the Clear Light</em> or <em>the Suffusion of Blue</em>---it doesn&apos;t really have a colour, of course, and it&apos;s not really <em>light</em> or even true <em>enlightenment</em>.  It&apos;s just the threshold, as you take your first step on your journey as a Lisp Hacker.  And on this journey, you will learn to see not the black and white extremes encapsulated in the symbol of the Yin-Yang---but every colour in the space between.</p>
+<p>But enough with the metaphors for now.  From a practical standpoint, in Part Two you&apos;ll be learning all the advanced features of the Common Lisp language---the secrets of multi-paradigm programming; CLOS, the Common Lisp Object System; Regular Expressions and Pattern Matching; Persistent storage and serialization; writing custom types; parellel processing; advanced mathematics and logic; working with binary, assembly language, and the compiler; the foreign-function interface; and a whole lot more.</p>
+<h3 id="chapters">Chapters</h3>
+<ol>
+<li><a href="2-01-0-programming-paradigms.html">Programming Paradigms</a></li>
+<li><a href="2-02-0-regex.html">Regular Expressions</a></li>
+<li><a href="2-03-0-objects-control.html">Objects and Control Structures</a></li>
+<li><a href="2-04-0-data-persistence.html">Persistence and Databases</a></li>
+<li><a href="2-05-0-extended-types.html">Extended Types</a></li>
+<li><a href="2-06-0-threads-memos-parallel.html">Concurrency and Memoization</a></li>
+<li><a href="2-07-0-logic-and-more-math.html">Logic and Advanced Math</a></li>
+<li><a href="2-08-0-number-theory.html">Number Theory</a></li>
+<li><a href="2-09-0-binary-octets-bits.html">Binary Streams, Octet-Vectors, and Bit-Vectors</a></li>
+<li><a href="2-10-0-improved-text-adventure-engine.html">An Improved Text Adventure Engine</a></li>
+<li><a href="2-11-0-conditions.html">Conditions and Error Handling</a></li>
+<li><a href="2-12-0-2d-game.html">Write a 2D Game</a></li>
+<li><a href="2-13-0-compiler.html">The Compiler</a></li>
+<li><a href="2-14-0-tree-shaker.html">Write a Tree-Shaker</a></li>
+<li><a href="2-15-0-docs-and-inspection.html">Documentation and Inspection</a></li>
+<li><a href="2-16-0-foreign-libs.html">Foreign Libraries in Lisp</a></li>
+<li><a href="2-17-0-debugging-testing.html">Debugging and Unit Testing</a></li>
+<li><a href="2-18-0-ffi.html">Write a Foreign Function Interface</a></li>
+<li><a href="2-19-0-essential-libs.html">Essential Lisp Libraries</a></li>
+<li><a href="2-20-0-packaging-libs.html">Packaging Lisp Libraries</a></li>
+<li><a href="2-21-0-review.html">Detailed Syntax Review</a></li>
+</ol>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="1-20-0-review.html" class="navigation navigation-prev " aria-label="Previous page: Part One in Review">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-01-0-programming-paradigms.html" class="navigation navigation-next " aria-label="Next page: Programming Paradigms">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"The Suffusion of Blue","level":"4.1","depth":1,"next":{"title":"Programming Paradigms","level":"4.1.1","depth":2,"path":"2-01-0-programming-paradigms.md","ref":"./2-01-0-programming-paradigms.md","articles":[]},"previous":{"title":"Part One in Review","level":"3.1.20","depth":2,"path":"1-20-0-review.md","ref":"./1-20-0-review.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-0-0-overview.md","mtime":"2022-08-22T22:55:10.399Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-01-0-programming-paradigms.html b/clones/llthw.common-lisp.dev/2-01-0-programming-paradigms.html
new file mode 100644
index 00000000..782b13af
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-01-0-programming-paradigms.html
@@ -0,0 +1,1923 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Programming Paradigms · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-02-0-regex.html" />
+    
+    
+    <link rel="prev" href="2-0-0-overview.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter active" data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Programming Paradigms</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-21">Chapter 2.1</h1>
+<h2 id="programming-paradigms">Programming Paradigms</h2>
+<blockquote>
+<p>&quot;A human being should be able to change a diaper, plan an invasion, butcher a hog, conn a ship, design a building, write a sonnet, balance accounts, build a wall, set a bone, comfort the dying, take orders, give orders, cooperate, act alone, solve equations, analyze a new problem, pitch manure, program a computer, cook a tasty meal, fight efficiently, die gallantly. Specialization is for insects.&quot;</p>
+<footer>Robert A. Heinlein, <em>Time Enough for Love</em></footer>
+
+</blockquote>
+<p>The way that you structure a problem dictates and limits its possible solutions.  Most programming lanugages have a single, or a very small set of built-in approaches to programming---their syntax restricts the lanuage to a single <em>paradigm</em>---and as a result, they limit you as a programmer, and artificially stunt your productivity and ingenuity, because they impose a single methodology for approaching all problems.  Human language is much the same in this regard---it is a well-known and established fact in developmental psychology, that the more languages a child learns to speak early on, the broader their thinking ends up becoming.  This is because all languages, human or computer, include certain underlying assumptions about the world that are not directly expressed, but are always there &quot;between the lines&quot; in the untranslatable elements of language.  When you learn to look at the world through different lenses, as the saying goes, you can see it much more clearly.  This also happens to be the scientific perspective.</p>
+<p>Lisp is different from other programming lanugages---it is <em>multi-paradigm</em> by nature, which means in practice that you are free to approach any given problem by every potential angle; the simplicity of its syntax, the homoiconicity of S-Expressions for representing both code and data also allow for the natural and intuitive representation of all programming paradigms; and in the Lisp REPL, you can try out each potential paradigm side-by-side until you find the right combination of clarity, expressiveness, and simplicity.  As you work more with Lisp and various paradigms through it, you will begin to develop an intuition for problem-solving; then, as you look at a problem and consider its implementation, you will get a feel for &quot;just knowing&quot; which paradigm best suits the job in front of you---just like an artist intuitively knows what colour palette to use as well as which brush.</p>
+<p>The ability to switch paradigms in Lisp may strike you, at first, as a source of great confusion.  You might ask yourself, &quot;how am I supposed to look over a piece of code and know what&apos;s going on?  What if I mistake one paradigm for another, and mess up a library?&quot;  Obviously, experience will help---the more you work with Lisp and the multi-paradigm approach, the more quickly you will be able to spot the paradigms being used.  But that&apos;s not as difficult as it sounds---every paradigm comes with its unique hallmarks, and once you learn them, they&apos;re easy to spot.</p>
+<p>In Part One, we primarily used the functional programming paradigm for convenience; but as I&apos;ve said before, Lisp is not a functional language---the functional paradigm is just one of many at your disposal.  In this chapter we will go through exercises that illustrate the use of various paradigms in software design and system architecture, and show how in Lisp you can freely mix-and-match paradigms without confusing either the compiler or another programmer reviewing your code.</p>
+<p>This chapter will contain exercises on:</p>
+<ul>
+<li>The Multi-Paradigm Approach</li>
+<li>Imperative vs. Declarative</li>
+<li>Procedural Programming</li>
+<li>Object-Oriented Programming</li>
+<li>Functional Programming</li>
+<li>Alternate Paradigms of Interest</li>
+</ul>
+<h3 id="exercise-211">Exercise 2.1.1</h3>
+<p><strong>The Multi-Paradigm Approach</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-212">Exercise 2.1.2</h3>
+<p><strong>Imperative Programming</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-213">Exercise 2.1.3</h3>
+<p><strong>Declarative Programming</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-214">Exercise 2.1.4</h3>
+<p><strong>Procedural Programming</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-215">Exercise 2.1.5</h3>
+<p><strong>Object-Oriented Programming</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-216">Exercise 2.1.6</h3>
+<p><strong>Pure Functional Programming</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-217">Exercise 2.1.7</h3>
+<p><strong>Functional Programming in Practice</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-218">Exercise 2.1.8</h3>
+<p><strong>Metaprogramming</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-219">Exercise 2.1.9</h3>
+<p><strong>Combining Paradigms: the wrong way</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2110">Exercise 2.1.10</h3>
+<p><strong>Combining Paradigms: the right way</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2111">Exercise 2.1.11</h3>
+<p><strong>The Style Guide, revisited</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2112">Exercise 2.1.12</h3>
+<p><strong>Alternate Paradigms: Aspect-Oriented</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2113">Exercise 2.1.13</h3>
+<p><strong>Alternate Paradigms: Agent-Oriented</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2114">Exercise 2.1.14</h3>
+<p><strong>Alternate Paradigms: Flow-Based Programming</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2115">Exercise 2.1.15</h3>
+<p><strong>Alternate Paradigms: Functional--Reactive Programming</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-0-0-overview.html" class="navigation navigation-prev " aria-label="Previous page: The Suffusion of Blue">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-02-0-regex.html" class="navigation navigation-next " aria-label="Next page: Extra Credit: Regular Expressions">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Programming Paradigms","level":"4.1.1","depth":2,"next":{"title":"Extra Credit: Regular Expressions","level":"4.1.2","depth":2,"path":"2-02-0-regex.md","ref":"./2-02-0-regex.md","articles":[]},"previous":{"title":"The Suffusion of Blue","level":"4.1","depth":1,"path":"2-0-0-overview.md","ref":"2-0-0-overview.md","articles":[{"title":"Programming Paradigms","level":"4.1.1","depth":2,"path":"2-01-0-programming-paradigms.md","ref":"./2-01-0-programming-paradigms.md","articles":[]},{"title":"Extra Credit: Regular Expressions","level":"4.1.2","depth":2,"path":"2-02-0-regex.md","ref":"./2-02-0-regex.md","articles":[]},{"title":"Objects and Control Structures","level":"4.1.3","depth":2,"path":"2-03-0-objects-control.md","ref":"./2-03-0-objects-control.md","articles":[]},{"title":"Extra Credit: Persistence and Databases","level":"4.1.4","depth":2,"path":"2-04-0-data-persistence.md","ref":"./2-04-0-data-persistence.md","articles":[]},{"title":"Extended Types","level":"4.1.5","depth":2,"path":"2-05-0-extended-types.md","ref":"./2-05-0-extended-types.md","articles":[]},{"title":"Extra Credit: Concurrency and Memoization","level":"4.1.6","depth":2,"path":"2-06-0-threads-memos-parallel.md","ref":"./2-06-0-threads-memos-parallel.md","articles":[]},{"title":"Logic and Advanced Math","level":"4.1.7","depth":2,"path":"2-07-0-logic-and-more-math.md","ref":"./2-07-0-logic-and-more-math.md","articles":[]},{"title":"Extra Credit: Number Theory","level":"4.1.8","depth":2,"path":"2-08-0-number-theory.md","ref":"./2-08-0-number-theory.md","articles":[]},{"title":"Binary Streams, Octet-Vectors, and Bit-Vectors","level":"4.1.9","depth":2,"path":"2-09-0-binary-octets-bits.md","ref":"./2-09-0-binary-octets-bits.md","articles":[]},{"title":"Extra Credit: An Improved Text Adventure Engine","level":"4.1.10","depth":2,"path":"2-10-0-improved-text-adventure-engine.md","ref":"./2-10-0-improved-text-adventure-engine.md","articles":[]},{"title":"Conditions and Error Handling","level":"4.1.11","depth":2,"path":"2-11-0-conditions.md","ref":"./2-11-0-conditions.md","articles":[]},{"title":"Extra Credit: Write a 2D Game","level":"4.1.12","depth":2,"path":"2-12-0-2d-game.md","ref":"./2-12-0-2d-game.md","articles":[]},{"title":"The Compiler","level":"4.1.13","depth":2,"path":"2-13-0-compiler.md","ref":"./2-13-0-compiler.md","articles":[]},{"title":"Extra Credit: Write a Tree-Shaker","level":"4.1.14","depth":2,"path":"2-14-0-tree-shaker.md","ref":"./2-14-0-tree-shaker.md","articles":[]},{"title":"Documentation and Inspection","level":"4.1.15","depth":2,"path":"2-15-0-docs-and-inspection.md","ref":"./2-15-0-docs-and-inspection.md","articles":[]},{"title":"Extra Credit: Foreign Libraries in Lisp","level":"4.1.16","depth":2,"path":"2-16-0-foreign-libs.md","ref":"./2-16-0-foreign-libs.md","articles":[]},{"title":"Debugging and Unit Testing","level":"4.1.17","depth":2,"path":"2-17-0-debugging-testing.md","ref":"./2-17-0-debugging-testing.md","articles":[]},{"title":"Extra Credit: Write a Foreign Function Interface","level":"4.1.18","depth":2,"path":"2-18-0-ffi.md","ref":"./2-18-0-ffi.md","articles":[]},{"title":"Essential Lisp Libraries","level":"4.1.19","depth":2,"path":"2-19-0-essential-libs.md","ref":"./2-19-0-essential-libs.md","articles":[]},{"title":"Extra Credit: Packaging Lisp Libraries","level":"4.1.20","depth":2,"path":"2-20-0-packaging-libs.md","ref":"./2-20-0-packaging-libs.md","articles":[]},{"title":"Detailed Syntax Review","level":"4.1.21","depth":2,"path":"2-21-0-review.md","ref":"./2-21-0-review.md","articles":[]}]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-01-0-programming-paradigms.md","mtime":"2022-08-22T23:18:17.300Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-02-0-regex.html b/clones/llthw.common-lisp.dev/2-02-0-regex.html
new file mode 100644
index 00000000..6b11b554
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-02-0-regex.html
@@ -0,0 +1,1901 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Extra Credit: Regular Expressions · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-03-0-objects-control.html" />
+    
+    
+    <link rel="prev" href="2-01-0-programming-paradigms.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Extra Credit: Regular Expressions</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-22-----extra-credit">Chapter 2.2 --- Extra Credit</h1>
+<h2 id="regular-expressions-and-pattern-matching">Regular Expressions and Pattern Matching</h2>
+<blockquote>
+<p>&quot;Paymasters come in only two sizes: one sort shows you where the book says that you can&apos;t have what you&apos;ve got coming to you; the second sort digs through the book until he finds a paragraph that lets you have what you need even if you don&apos;t rate it.&quot;</p>
+<footer>Robert A. Heinlein, <em>The Door Into Summer</em></footer>
+
+</blockquote>
+<p>Regular Expressions and Pattern Matching are important features in any programming language; but surprisingly few come with robust support for high-level pattern matching out of the box.  Lisp comes with all the low-level building blocks necessary for high-level pattern matching, but high-level pattern matching was not included in the ANSI Standard.</p>
+<p>Obviously, the gold-standard of pattern matching is Perl&apos;s Regular Expressions---and they are fully integrated with the Perl language so they can be used in-line everywhere.  The main complaint about regular expressions is that they quickly become dense and unreadable.  So many other strategies for pattern matching exist, which aim to increase legibility.</p>
+<p>Perhaps one of the less well-known, but most important, facts about Lisp, is that Lisp is better at regular expressions than Perl---consider that!  Perl is <em>fast</em>, concise, and highly optimized; and regular expressions originate from Perl.  But the de-facto implementation of Perl-compatible regular expressions for Common Lisp, CL-PPCRE, is on average twice as fast as Perl itself.  This is just one of the many examples that illustrate, with hard benchmark results for proof, that Lisp is better than C for squeezing out maximum performance of your code.</p>
+<p>In this Extra Credit chapter, we will take a tour of writing Perl-compatible regular expressions with the CL-PPCRE library, introduce alternative, more Lispy approaches to pattern matching with the Optima and ESRAP libraries, and then take a look at the CL21 project---which includes in-line regular expressions, amongst its many other cool features.</p>
+<p>This chapter will contain exercises on using:</p>
+<ul>
+<li>CL-PPCRE</li>
+<li>Optima</li>
+<li>ESRAP</li>
+<li>CL21</li>
+</ul>
+<h3 id="exercise-221">Exercise 2.2.1</h3>
+<p><strong>Pattern Matching</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-222">Exercise 2.2.2</h3>
+<p><strong>Pattern Matching with Regular Expressions</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-223">Exercise 2.2.3</h3>
+<p><strong>Regular Expression Syntax</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-224">Exercise 2.2.4</h3>
+<p><strong>String Escapes</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-225">Exercise 2.2.5</h3>
+<p><strong>In-line Regular Expressions with CL21</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-226">Exercise 2.2.6</h3>
+<p><strong>Optimized Pattern Matching with Optima</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-227">Exercise 2.2.7</h3>
+<p><strong>More Optima</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-228">Exercise 2.2.8</h3>
+<p><strong>Even More Optima</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-229">Exercise 2.2.9</h3>
+<p><strong>Pattern Matching with ESRAP</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2210">Exercise 2.2.10</h3>
+<p><strong>More ESRAP</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2211">Exercise 2.2.11</h3>
+<p><strong>Even More ESRAP</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-01-0-programming-paradigms.html" class="navigation navigation-prev " aria-label="Previous page: Programming Paradigms">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-03-0-objects-control.html" class="navigation navigation-next " aria-label="Next page: Objects and Control Structures">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Extra Credit: Regular Expressions","level":"4.1.2","depth":2,"next":{"title":"Objects and Control Structures","level":"4.1.3","depth":2,"path":"2-03-0-objects-control.md","ref":"./2-03-0-objects-control.md","articles":[]},"previous":{"title":"Programming Paradigms","level":"4.1.1","depth":2,"path":"2-01-0-programming-paradigms.md","ref":"./2-01-0-programming-paradigms.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-02-0-regex.md","mtime":"2022-08-22T23:18:17.300Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-03-0-objects-control.html b/clones/llthw.common-lisp.dev/2-03-0-objects-control.html
new file mode 100644
index 00000000..4e35cb0c
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-03-0-objects-control.html
@@ -0,0 +1,1978 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Objects and Control Structures · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-04-0-data-persistence.html" />
+    
+    
+    <link rel="prev" href="2-02-0-regex.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Objects and Control Structures</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-23">Chapter 2.3</h1>
+<h2 id="objects-and-control-structures">Objects and Control Structures</h2>
+<blockquote>
+<p>&quot;Wisdom includes not getting angry unnecessarily. The Law ignores trifles and the wise man does, too.&quot;</p>
+<footer>Robert A. Heinlein, <em>Job: A Comedy of Justice</em></footer>
+
+</blockquote>
+<p>Despite the common misconception that Lisp is a functional programming lanugage, Lisp has rich support for the Imperative and Object-Oriented paradigms---and these days, you&apos;ll find more fully Object-Oriented Lisp applications and libraries than purely-functional ones. While the tools for Imperative and Procedural programming are included alongside all the other standard features of Common Lisp, Object-oriented programming is encapsulated by CLOS: The Common Lisp Object System. As it turns out, you can also define CLOS classes and use them as types---but, fair warning, the inverse doesn&apos;t hold.</p>
+<p>To differentiate from the purely-functional style, it will be helpful to introduce some new terminology as well.  Some of these terms are baked right into the language specification, while others are adopted simply for convenience.  Where official Lisp terminology differs from the mainstream, I will endeavour to make note of it.</p>
+<p>First of all, when a function you write causes or relies upon side-effects in the dynamic scope, we will call that function a <em>procedure</em>.  Some of these are also called <em>destructive</em> or <em>in-place</em> operations, if they modify an object in memory instead of returning a new object.</p>
+<p>In CLOS, Functions that are specialized for a particular class and its descendents are called <em>methods</em>.  Lisp also allows you to define unspecified <em>generic functions</em>, which act as a template for all methods of the same name in the current package.  Typically, one writes generic functions to establish the public and private API of a class for its package---while there is no special distinction in CLOS for public and private methods, you establish the public methods on a class by exporting those symbols from your package, as normal.</p>
+<p>Structs in Lisp are essentially the same in principle and use as Structs in C, or Prototype Functions in JavaScript.  They&apos;re a quick and lightweight option when you just need a structured type to track state in your program; they are also useful for building full-blown state machines.  Defining a Struct comes with a lot of automatically generated code that is representative of the sane defaults that in other languages you would have to define manually, such as type predicates, constructors, copiers, readers and writers.  But the limitations of Structs can often be frustrating. Unless you&apos;re certain ahead of time that your application only needs the purposely limited feature-set of Structs, you should always start with CLOS.</p>
+<p>Structs and Classes in Lisp have <em>slots</em> for data, which are similar to <em>data members</em> or <em>class variables</em> in other object-oriented programming languages.  When defining a Struct or Class in Lisp, you are defining their slots. Generic functions and methods on classes are defined separately.  One might say that the main difference between Structs and Classes in Lisp is that Classes allow for this specialization of generic functions; but of course, that is an over-simplification.  As you will come to see, there are many fundamental differences between structs and classes that will inform your choices while developing software in Lisp.</p>
+<p>You can always access the slots in a struct or class manually, but this is considered bad style---and sometimes it can even be dangerous.  As mentioned above, the Struct definition macro automatically creates accessors for all the slots you define; CLOS offers you a choice, and in so doing, allows you to create separate reader and writer methods, or a bi-directional accessor method.  CLOS classes also offer special initialization methods, and method wrapping, for fine-tuning control flow in the life-time of your objects.</p>
+<p>CLOS, along with the Meta-Object Protocol, are considered <em>the be-all and end-all</em> of Object-Oriented Programming systems, far improving on the object-oriented programming experience you&apos;d get from SmallTalk, Java, C#, C++, or Objective-C.  While they can be daunting at first, the design of CLOS is actually quite elegant and fits perfectly into the Lisp ecosystem---typically you will never need to worry about the MOP, but on those rare cases you do, you&apos;ll be glad it&apos;s there.</p>
+<h3 id="exercise-231">Exercise 2.3.1</h3>
+<p><strong>Blocks</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-232">Exercise 2.3.2</h3>
+<p><strong>More Blocks</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-233">Exercise 2.3.3</h3>
+<p><strong>Macroexpand: Hidden Blocks</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-234">Exercise 2.3.4</h3>
+<p><strong>Tagbodys</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-235">Exercise 2.3.5</h3>
+<p><strong>GO</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-236">Exercise 2.3.6</h3>
+<p><strong>More Tagbodys and GO</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-237">Exercise 2.3.7</h3>
+<p><strong>PROGN</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-238">Exercise 2.3.8</h3>
+<p><strong>More PROGN</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-239">Exercise 2.3.9</h3>
+<p><strong>PROG, PROG*, PROG1, and PROG2</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2310">Exercise 2.3.10</h3>
+<p><strong>PROGV</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2311">Exercise 2.3.11</h3>
+<p><strong>Structs</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2312">Exercise 2.3.12</h3>
+<p><strong>More Structs</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2313">Exercise 2.3.13</h3>
+<p><strong>Even More Structs</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2314">Exercise 2.3.14</h3>
+<p><strong>CLOS: Classes</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2315">Exercise 2.3.15</h3>
+<p><strong>CLOS: Slots</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2316">Exercise 2.3.16</h3>
+<p><strong>CLOS: More Slots</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2317">Exercise 2.3.17</h3>
+<p><strong>CLOS: Even More Slots</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2318">Exercise 2.3.18</h3>
+<p><strong>CLOS: Readers</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2319">Exercise 2.3.19</h3>
+<p><strong>CLOS: Writers</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2320">Exercise 2.3.20</h3>
+<p><strong>CLOS: Accessors</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2321">Exercise 2.3.21</h3>
+<p><strong>CLOS: Inheritance</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2322">Exercise 2.3.22</h3>
+<p><strong>CLOS: Multiple-Inheritance</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2323">Exercise 2.3.23</h3>
+<p><strong>CLOS: Generic Functions</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2324">Exercise 2.3.24</h3>
+<p><strong>CLOS: Methods</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2325">Exercise 2.3.25</h3>
+<p><strong>CLOS: More Methods</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2326">Exercise 2.3.26</h3>
+<p><strong>:BEFORE and :AFTER Methods</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2327">Exercise 2.3.27</h3>
+<p><strong>The Meta-Object Protocol</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-02-0-regex.html" class="navigation navigation-prev " aria-label="Previous page: Extra Credit: Regular Expressions">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-04-0-data-persistence.html" class="navigation navigation-next " aria-label="Next page: Extra Credit: Persistence and Databases">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Objects and Control Structures","level":"4.1.3","depth":2,"next":{"title":"Extra Credit: Persistence and Databases","level":"4.1.4","depth":2,"path":"2-04-0-data-persistence.md","ref":"./2-04-0-data-persistence.md","articles":[]},"previous":{"title":"Extra Credit: Regular Expressions","level":"4.1.2","depth":2,"path":"2-02-0-regex.md","ref":"./2-02-0-regex.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-03-0-objects-control.md","mtime":"2022-08-22T23:18:17.300Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-04-0-data-persistence.html b/clones/llthw.common-lisp.dev/2-04-0-data-persistence.html
new file mode 100644
index 00000000..59cdec17
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-04-0-data-persistence.html
@@ -0,0 +1,1925 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Extra Credit: Persistence and Databases · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-05-0-extended-types.html" />
+    
+    
+    <link rel="prev" href="2-03-0-objects-control.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Extra Credit: Persistence and Databases</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-24-----extra-credit">Chapter 2.4 --- Extra Credit</h1>
+<h2 id="persistence-and-databases">Persistence and Databases</h2>
+<blockquote>
+<p>&quot;You have attributed conditions to villainy that simply result from stupidity.&quot;</p>
+<footer>Robert A. Heinlein, <em>Logic of Empire</em></footer>
+
+</blockquote>
+<p>All applications that allow a user to create or modify data must also allow that user to store their data somewhere, either on their own filesystem, on a server in the cloud, or in a database, and load it back into memory again.  After all, once an application quits, everything in its memory space is effectively lost.  To have that data persist across sessions, it has to be stored <em>somewhere</em>, and loaded back into an application&apos;s memory when it is needed.  Many strategies exist to achieve this---and we&apos;ve looked at a couple simple ones already.</p>
+<p>Another advantage of storing data outside of an application&apos;s memory space, is that it encourages you to validate all data before running it through your program.  In any real-world application, this should be done anyway; but when you know the data is coming from an untrusted source (<em>i.e.</em>, anyone who isn&apos;t you, the application developer), you&apos;re more likely to do things the right way.  While validation of all program input is a non-trivial task, it is essential for building robust user experiences that can handle bad user input as well as malicious attacks against your software.</p>
+<p>Whether you store your application&apos;s data in a file on a user&apos;s computer or in a database where a number of authorized users can access it, you need to spend some time thinking about every piece of data that your application might need to store.  Imagine that the program is loading from scratch, and only has a saved file to restore everything from the last session to memory---if you&apos;ve stored everything you need to, a user will be able to pick up right where they left off; if you missed anything, you might just annoy a user if it was nothing more than a trivial customization to the UI that you forgot to save, but you could just as easily crash the entire application and corrupt the user&apos;s data. Conversely, if data needs to be converted before being used, it&apos;s equally important to remember to convert both ways, on the way in, and on the way out.</p>
+<p>Sometimes you may also want to serialize and store not just your data, but your code too---saving you the time and effort of rebuilding objects in memory from where they are stored.  This is possible in Lisp because of its homoiconicity.  Being able to treat code as data, and data as code can be just as much of a time-saver as it is a powerful tool for expressing code patterns in macros.  Again, careful thought has to be put into your complete application&apos;s life-cycle---if you store executable code, expecting it to run in your application, you&apos;ll have to validate it before allowing it to be evaluated. This brings up the principle of <em>secure programming</em>---writing software with certain best practices up front, instead of merely adding security features on at the end.</p>
+<p>Lastly, you can also dump an entire Lisp session to your file system, and run it instead of having to load everything into memory again.  Everything you had in memory will be there again when you launch this dumped executable.  This can be useful if you have a lot of customizations, or default packages that you use all the time---but naturally, this too comes with its caveats.</p>
+<h3 id="exercise-241">Exercise 2.4.1</h3>
+<p><strong>Validating Input</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-242">Exercise 2.4.2</h3>
+<p><strong>More Validation</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-243">Exercise 2.4.3</h3>
+<p><strong>Even More Validation</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-244">Exercise 2.4.4</h3>
+<p><strong>Binary File Formats</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-245">Exercise 2.4.5</h3>
+<p><strong>Outputting Binary Files</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-246">Exercise 2.4.6</h3>
+<p><strong>Reading Binary Files</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-247">Exercise 2.4.7</h3>
+<p><strong>Binary Files as Programs</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-248">Exercise 2.4.8</h3>
+<p><strong>Hand Compilation</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-249">Exercise 2.4.9</h3>
+<p><strong>Custom Lisp Images</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2410">Exercise 2.4.10</h3>
+<p><strong>Dumping Custom Lisp Images</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2411">Exercise 2.4.11</h3>
+<p><strong>Loading Custom Lisp Images</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2412">Exercise 2.4.12</h3>
+<p><strong>Serializing Lisp Objects</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2413">Exercise 2.4.13</h3>
+<p><strong>More Serialization</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2414">Exercise 2.4.14</h3>
+<p><strong>Even More Serialization</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2415">Exercise 2.4.15</h3>
+<p><strong>Relational Databases</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2416">Exercise 2.4.16</h3>
+<p><strong>Document-based Databases</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2417">Exercise 2.4.17</h3>
+<p><strong>Graph Databases</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-03-0-objects-control.html" class="navigation navigation-prev " aria-label="Previous page: Objects and Control Structures">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-05-0-extended-types.html" class="navigation navigation-next " aria-label="Next page: Extended Types">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Extra Credit: Persistence and Databases","level":"4.1.4","depth":2,"next":{"title":"Extended Types","level":"4.1.5","depth":2,"path":"2-05-0-extended-types.md","ref":"./2-05-0-extended-types.md","articles":[]},"previous":{"title":"Objects and Control Structures","level":"4.1.3","depth":2,"path":"2-03-0-objects-control.md","ref":"./2-03-0-objects-control.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-04-0-data-persistence.md","mtime":"2022-08-22T23:18:17.300Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-05-0-extended-types.html b/clones/llthw.common-lisp.dev/2-05-0-extended-types.html
new file mode 100644
index 00000000..613204bf
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-05-0-extended-types.html
@@ -0,0 +1,1928 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Extended Types · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-06-0-threads-memos-parallel.html" />
+    
+    
+    <link rel="prev" href="2-04-0-data-persistence.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Extended Types</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-25">Chapter 2.5</h1>
+<h2 id="extended-types">Extended Types</h2>
+<blockquote>
+<p>&quot;Always listen to experts. They&apos;ll tell you what can&apos;t be done, and why. Then do it.&quot;</p>
+<footer>Robert A. Heinlein, <em>Time Enough for Love</em></footer>
+
+</blockquote>
+<p>Besides the data types we&apos;ve already seen---strings, integers, floats, complex numbers, vectors, arrays, lists, first-class functions, structs and CLOS classes---Common Lisp has a diverse set of specialized types to serve almost every need.</p>
+<p>Many of these specialized data types have their own set of functions for working with them.  While introducing each type, I will also be covering that type&apos;s specialized function interface, and various methods of type conversion.</p>
+<p>Where the ANSI standard falls short of your needs, it provides a mature and rich type definition system.  You can also, if needs must, mercilessly abuse CLOS to define your more complicated, structured types with classes---which also allows you to use generic functions and methods to provide operator overloading for them.</p>
+<h3 id="exercise-251">Exercise 2.5.1</h3>
+<p><strong>Hash Tables</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-252">Exercise 2.5.2</h3>
+<p><strong>More Hash Tables</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-253">Exercise 2.5.3</h3>
+<p><strong>Even More Hash Tables</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-254">Exercise 2.5.4</h3>
+<p><strong>Sets</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-255">Exercise 2.5.5</h3>
+<p><strong>More Sets</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-256">Exercise 2.5.6</h3>
+<p><strong>Even More Sets</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-257">Exercise 2.5.7</h3>
+<p><strong>Simple Strings</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-258">Exercise 2.5.8</h3>
+<p><strong>More Simple Strings</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-259">Exercise 2.5.9</h3>
+<p><strong>Simple Arrays</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2510">Exercise 2.5.10</h3>
+<p><strong>More Simple Arrays</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2511">Exercise 2.5.11</h3>
+<p><strong>Byte Vectors</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2512">Exercise 2.5.12</h3>
+<p><strong>More Byte Vectors</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2513">Exercise 2.5.13</h3>
+<p><strong>Unsigned Bytes</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2514">Exercise 2.5.14</h3>
+<p><strong>Signed Bytes</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2515">Exercise 2.5.15</h3>
+<p><strong>Bit Vectors</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2516">Exercise 2.5.16</h3>
+<p><strong>More Bit Vectors</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2517">Exercise 2.5.17</h3>
+<p><strong>Defining Types</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2518">Exercise 2.5.18</h3>
+<p><strong>Defining Types with CLOS</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-04-0-data-persistence.html" class="navigation navigation-prev " aria-label="Previous page: Extra Credit: Persistence and Databases">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-06-0-threads-memos-parallel.html" class="navigation navigation-next " aria-label="Next page: Extra Credit: Concurrency and Memoization">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Extended Types","level":"4.1.5","depth":2,"next":{"title":"Extra Credit: Concurrency and Memoization","level":"4.1.6","depth":2,"path":"2-06-0-threads-memos-parallel.md","ref":"./2-06-0-threads-memos-parallel.md","articles":[]},"previous":{"title":"Extra Credit: Persistence and Databases","level":"4.1.4","depth":2,"path":"2-04-0-data-persistence.md","ref":"./2-04-0-data-persistence.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-05-0-extended-types.md","mtime":"2022-08-22T23:18:17.300Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-06-0-threads-memos-parallel.html b/clones/llthw.common-lisp.dev/2-06-0-threads-memos-parallel.html
new file mode 100644
index 00000000..641ac0ef
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-06-0-threads-memos-parallel.html
@@ -0,0 +1,1908 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Extra Credit: Concurrency and Memoization · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-07-0-logic-and-more-math.html" />
+    
+    
+    <link rel="prev" href="2-05-0-extended-types.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Extra Credit: Concurrency and Memoization</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-26-----extra-credit">Chapter 2.6 --- Extra Credit</h1>
+<h2 id="concurrency-and-memoization">Concurrency and Memoization</h2>
+<blockquote>
+<p>&quot;I think the major problem in growing up is to become sophisticated without becoming cynical.&quot;</p>
+<footer>Robert A. Heinlein, <em>I Will Fear No Evil</em></footer>
+
+</blockquote>
+<p>While John McCarthy had intended that the successor to the many different dialects of Lisp in the 70s and 80s would be a fully parallelized Lisp, his proposal for QLISP did not make it into the ANSI Common Lisp standard.  Nevertheless, many libraries for threading and full concurrency exist for Common Lisp, and achieve the same ends.</p>
+<p>Now, Memoization is a really useful tool to have that ties in well with the subject of concurrency.  Memoization is a technique for caching the results of expensive computations, so that when a function is called again with the same arguments as one that has been memoized, it can pull the result from a cache instead of computing the function all over again.  The usefulness of this scales exponentially against the computational difficulty of your program on one axis and the number of times you have to call the same function with the same arguments in a given session of your application on another.</p>
+<p>Lastly, we will wrap up our first tour of concurrency in this chapter with a look at general asynchronous operations and event-oriented programming techniques. Using this, we will then create a very simple asynchronous web application!</p>
+<h3 id="exercise-261">Exercise 2.6.1</h3>
+<p><strong>Threads</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-262">Exercise 2.6.2</h3>
+<p><strong>More Threads</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-263">Exercise 2.6.3</h3>
+<p><strong>Even More Threads</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-264">Exercise 2.6.4</h3>
+<p><strong>Memoization</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-265">Exercise 2.6.5</h3>
+<p><strong>More Memoization</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-266">Exercise 2.6.6</h3>
+<p><strong>Even More Memoization</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-267">Exercise 2.6.7</h3>
+<p><strong>Concurrency</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-268">Exercise 2.6.8</h3>
+<p><strong>More Concurrency</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-269">Exercise 2.6.9</h3>
+<p><strong>Even More Concurrency</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2610">Exercise 2.6.10</h3>
+<p><strong>Asynchronous Web Applications</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2611">Exercise 2.6.11</h3>
+<p><strong>Event Loops</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2612">Exercise 2.6.12</h3>
+<p><strong>Routes</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2613">Exercise 2.6.13</h3>
+<p><strong>Promises</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2614">Exercise 2.6.14</h3>
+<p><strong>Futures</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-05-0-extended-types.html" class="navigation navigation-prev " aria-label="Previous page: Extended Types">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-07-0-logic-and-more-math.html" class="navigation navigation-next " aria-label="Next page: Logic and Advanced Math">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Extra Credit: Concurrency and Memoization","level":"4.1.6","depth":2,"next":{"title":"Logic and Advanced Math","level":"4.1.7","depth":2,"path":"2-07-0-logic-and-more-math.md","ref":"./2-07-0-logic-and-more-math.md","articles":[]},"previous":{"title":"Extended Types","level":"4.1.5","depth":2,"path":"2-05-0-extended-types.md","ref":"./2-05-0-extended-types.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-06-0-threads-memos-parallel.md","mtime":"2022-08-22T23:18:17.300Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-07-0-logic-and-more-math.html b/clones/llthw.common-lisp.dev/2-07-0-logic-and-more-math.html
new file mode 100644
index 00000000..5c09b7c7
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-07-0-logic-and-more-math.html
@@ -0,0 +1,1945 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Logic and Advanced Math · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-08-0-number-theory.html" />
+    
+    
+    <link rel="prev" href="2-06-0-threads-memos-parallel.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Logic and Advanced Math</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-27">Chapter 2.7</h1>
+<h2 id="logic-and-advanced-math">Logic and Advanced Math</h2>
+<blockquote>
+<p>&quot;...Mathematics need not have use; it was a game, like chess but more fun.&quot;</p>
+<footer>Robert A. Heinlein, <em>Citizen of the Galaxy</em></footer>
+
+</blockquote>
+<p><strong>Revision Note:</strong> <em>Intro text needs complete rewrite</em>.</p>
+<p>We&apos;ve dabbled in basic math already, and chances are high that in every-day programming, that might be all you ever need.  However, there are many problem domains that require a sophisticated understanding of advanced logic, Lisp&apos;s built-in tools for modular arithmetic and trigonometry, and the implementation of functions to support number theory, linear algebra, and calculus; for example, game development, artificial intelligence, computational physics, cryptography, FINTECH, and everything in the Crypto-Currency space.  Even as &quot;just a web developer&quot;, on-line security is becoming ever more important as developers are pushed to get the web experience ever closer to the desktop experience---and cryptography plays a central role in that.  As the saying goes, &quot;<em>the more you know...</em>&quot;</p>
+<p>Of course, by this point you should no longer be afraid of math, since every line of code you write in Lisp, no matter the paradigm, is formally expressed as an S-Expression in the Lambda Calculus.  While what you&apos;re doing may not conform to the conception of <em>pure functional programming</em>, every expression you write that is evaluated as a proper form returns some result.  At the end of the day, that&apos;s all math really is---a set of formally expressed rules that operate on quantitative data.  And <em>everything</em> in a computer is quantitative, whether you would normally think of it that way or not.  That Lisp adapts a purely mathematical model underneath in its implementation, and allows qualitative logic to be built on top of a quantifiable system is a feature---and an exciting one.  Lisp demonstrates how all qualitative systems can be reduced to quantitative.  In the age-old debate of philisophy vs. science, the importance of this cannot be understated.  And this should also serve as an explanation as to why Lisp Hackers always say that <em>programming is math</em>, while developers from other languages simply fail to see this basic tenet of computer science.</p>
+<p>But Math is more important than even that, to all programmers.  Every program that can be written can be abstracted and generalized to a formal mathematical definition, and in so doing, can be simplified and made more elegant.  Consider the problem of 3D Graphics, whether for gaming, simulation, virtual reality, augmented reality, or immersive interfaces.  You can use 3D Graphics applications such as CAD or Blender, or the myriad of robust proprietary alternatives, to visually create your 3D artwork and assets---there&apos;s nothing wrong with this, as for artists it is quite intuitive.  However, a mathematician can achieve the same end with pure code.  These 3D assets are all collections of vertices in cartesian space, and they can be generated procedurally just as easily---and sometimes more easily---than they can be created with a 3D graphics application.  It just depends on how well you understand the math behind 3D graphics.</p>
+<p>Lisp is particularly good for generating 3D graphics without having to use assets created in a third-party application.  In fact, that was one of the greatest strengths of the fabled Lisp Machines.  In Part Three we will be tackling this problem head-on, to create a complete 3D game without any third-party assets.  Just code.  <em>This</em> chapter will provide you with all the math you&apos;ll need to achieve that feat---any many, many more.</p>
+<h3 id="exercise-271">Exercise 2.7.1</h3>
+<p><strong>Formal Logic</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-272">Exercise 2.7.2</h3>
+<p><strong>Boolean Logic on Integers</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-273">Exercise 2.7.3</h3>
+<p><strong>Boolean Logic on Bit-Vectors</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-274">Exercise 2.7.4</h3>
+<p><strong>Prime Numbers</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-275">Exercise 2.7.5</h3>
+<p><strong>Prime Factorization</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-276">Exercise 2.7.6</h3>
+<p><strong>Modular Arithmetic</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-277">Exercise 2.7.7</h3>
+<p><strong>Imaginary Numbers</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-278">Exercise 2.7.8</h3>
+<p><strong>Complex Numbers</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-279">Exercise 2.7.9</h3>
+<p><strong>Trigonometry</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2710">Exercise 2.7.10</h3>
+<p><strong>More Trigonometry</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2711">Exercise 2.7.11</h3>
+<p><strong>Geometry</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2712">Exercise 2.7.12</h3>
+<p><strong>More Geometry</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2713">Exercise 2.7.13</h3>
+<p><strong>Even More Geometry</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2714">Exercise 2.7.14</h3>
+<p><strong>The GSLL Library</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2715">Exercise 2.7.15</h3>
+<p><strong>Linear Algebra with GSLL</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2716">Exercise 2.7.16</h3>
+<p><strong>More Linear Algebra</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2717">Exercise 2.7.17</h3>
+<p><strong>Even More Linear Algebra</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2718">Exercise 2.7.18</h3>
+<p><strong>Calculus with GSLL</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2719">Exercise 2.7.19</h3>
+<p><strong>More Calculus</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2720">Exercise 2.7.20</h3>
+<p><strong>Even More Calculus</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2721">Exercise 2.7.21</h3>
+<p><strong>Further Explorations with GSLL</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-06-0-threads-memos-parallel.html" class="navigation navigation-prev " aria-label="Previous page: Extra Credit: Concurrency and Memoization">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-08-0-number-theory.html" class="navigation navigation-next " aria-label="Next page: Extra Credit: Number Theory">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Logic and Advanced Math","level":"4.1.7","depth":2,"next":{"title":"Extra Credit: Number Theory","level":"4.1.8","depth":2,"path":"2-08-0-number-theory.md","ref":"./2-08-0-number-theory.md","articles":[]},"previous":{"title":"Extra Credit: Concurrency and Memoization","level":"4.1.6","depth":2,"path":"2-06-0-threads-memos-parallel.md","ref":"./2-06-0-threads-memos-parallel.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-07-0-logic-and-more-math.md","mtime":"2022-08-22T23:18:17.300Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-08-0-number-theory.html b/clones/llthw.common-lisp.dev/2-08-0-number-theory.html
new file mode 100644
index 00000000..64b69b37
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-08-0-number-theory.html
@@ -0,0 +1,1947 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Extra Credit: Number Theory · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-09-0-binary-octets-bits.html" />
+    
+    
+    <link rel="prev" href="2-07-0-logic-and-more-math.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Extra Credit: Number Theory</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-28-----extra-credit">Chapter 2.8 --- Extra Credit</h1>
+<h2 id="number-theory">Number Theory</h2>
+<blockquote>
+<p>&quot;Some people insist that &apos;mediocre&apos; is better than &apos;best.&apos; They delight in clipping wings because they themselves can&apos;t fly. They despise brains because they have none. Pfah!&quot;</p>
+<footer>Robert A. Heinlein, <em>Have Space Suit---Will Travel</em></footer>
+
+</blockquote>
+<p>Number Theory is a fun, but challenging domain for computer scientists---many aspects of it pose intractable problems for classical computation, forcing us to look to novel technologies for solutions, such as Quantum Computation.  But in the age of concurrency, there are some minor tweaks and adjustments that can be made to the established algorithms, so that while we still cannot efficiently factorize the multiplication of two large primes, we can at least push classical computing to its absolute limit.</p>
+<p>Through the excercises in this chapter, we will put together a Number Theory library that can be included in other projects, and contains a number of useful techniques for algorithm design, optimization, unit testing, and further develops on the iterative, incremental development pattern encouraged in Lisp.  We will approach each problem from its theoretical ideal, and then work towards a computational ideal that is as efficient as possible while retaining elegance in expression.</p>
+<h3 id="exercise-281">Exercise 2.8.1</h3>
+<p><strong>Prime Numbers, Revisited</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-282">Exercise 2.8.2</h3>
+<p><strong>Alternate Approaches to Factorization</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-283">Exercise 2.8.3</h3>
+<p><strong>Factorizing Primes with Look-up Tables</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-284">Exercise 2.8.4</h3>
+<p><strong>Factorizing Primes with Pollard&apos;s Rho Algorithm</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-285">Exercise 2.8.5</h3>
+<p><strong>Factorizing Primes with Lenstra&apos;s Elliptical Curve</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-286">Exercise 2.8.6</h3>
+<p><strong>Factorizing Primes with the Quadratic Sieve</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-287">Exercise 2.8.7</h3>
+<p><strong>Factorizing Primes with the General Number Field Sieve</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-288">Exercise 2.8.8</h3>
+<p><strong>Automatic Factorization Algorithm Selection</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-289">Exercise 2.8.9</h3>
+<p><strong>Polynomials</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2810">Exercise 2.8.10</h3>
+<p><strong>More Polynomials</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2811">Exercise 2.8.11</h3>
+<p><strong>Even More Polynomials</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2812">Exercise 2.8.12</h3>
+<p><strong>Modular Exponentiation</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2813">Exercise 2.8.13</h3>
+<p><strong>More Modular Exponentiation</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2814">Exercise 2.8.14</h3>
+<p><strong>Inverse Modulus</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2815">Exercise 2.8.15</h3>
+<p><strong>The Jacobi Function</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2816">Exercise 2.8.16</h3>
+<p><strong>The Euler Totient Function</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2817">Exercise 2.8.17</h3>
+<p><strong>The Carmichael Functions</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2818">Exercise 2.8.18</h3>
+<p><strong>More Carmichael Functions</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2819">Exercise 2.8.19</h3>
+<p><strong>Even More Carmichael Functions</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2820">Exercise 2.8.20</h3>
+<p><strong>Optimizing for Performance</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2821">Exercise 2.8.21</h3>
+<p><strong>Optimizing for Memory Use</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2822">Exercise 2.8.22</h3>
+<p><strong>Putting It All Together</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-07-0-logic-and-more-math.html" class="navigation navigation-prev " aria-label="Previous page: Logic and Advanced Math">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-09-0-binary-octets-bits.html" class="navigation navigation-next " aria-label="Next page: Binary Streams, Octet-Vectors, and Bit-Vectors">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Extra Credit: Number Theory","level":"4.1.8","depth":2,"next":{"title":"Binary Streams, Octet-Vectors, and Bit-Vectors","level":"4.1.9","depth":2,"path":"2-09-0-binary-octets-bits.md","ref":"./2-09-0-binary-octets-bits.md","articles":[]},"previous":{"title":"Logic and Advanced Math","level":"4.1.7","depth":2,"path":"2-07-0-logic-and-more-math.md","ref":"./2-07-0-logic-and-more-math.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-08-0-number-theory.md","mtime":"2022-08-22T23:18:17.300Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-09-0-binary-octets-bits.html b/clones/llthw.common-lisp.dev/2-09-0-binary-octets-bits.html
new file mode 100644
index 00000000..ba04c1b4
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-09-0-binary-octets-bits.html
@@ -0,0 +1,1923 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Binary Streams, Octet-Vectors, and Bit-Vectors · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-10-0-improved-text-adventure-engine.html" />
+    
+    
+    <link rel="prev" href="2-08-0-number-theory.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Binary Streams, Octet-Vectors, and Bit-Vectors</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-29">Chapter 2.9</h1>
+<h2 id="binary-streams-octet-vectors-and-bit-vectors">Binary Streams, Octet-Vectors, and Bit-Vectors</h2>
+<blockquote>
+<p>&quot;I counted to ten slowly, using binary notation.&quot;</p>
+<footer>Robert A. Heinlein, <em>The Door Into Summer</em></footer>
+
+</blockquote>
+<p>Everything that happens inside a computer, happens as binary-encoded instruction sequences---and everything that is stored in memory or on your filesystem, is also stored in binary.  When people think of &quot;machine language&quot;, they often think in terms of assembly language---but even that is a transliteration for the benefit of humans.  The machine---your computer---only understands 1&apos;s and 0&apos;s.</p>
+<p>You can do a lot with high-level programming constructs, but when performance is critical, or you need to get down to the nitty-gritty for fine-tuned control, binary is your friend.  And naturally, Lisp makes it as simple as possible to work with binary data, whether working over a network, accessing the file system, or connecting to hardware with a driver.</p>
+<p>In this chapter we will go into much more detail on the subject of binary streams, octet-vectors, and bit-vectors.  We&apos;ve seen them all before, but only in passing---now it&apos;s time to take on the subjects of signed and unsigned bytes, little-endian and big-endian bit ordering, manipulating bits, conversion between bit-vectors, octet-vectors, and their integer equivalents, and of course, bit-wise logic and binary arithmetic.  We have also already covered the binary, octet, and hexadecimal notation system for integers, but a formal tour of those notations will also be helpful to this discussion, so we&apos;ll tackle that first.</p>
+<h3 id="exercise-291">Exercise 2.9.1</h3>
+<p><strong>Base and Order</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-292">Exercise 2.9.2</h3>
+<p><strong>Byte-Vectors</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-293">Exercise 2.9.3</h3>
+<p><strong>Bit-Vectors</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-294">Exercise 2.9.4</h3>
+<p><strong>Integers as Bytes</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-295">Exercise 2.9.5</h3>
+<p><strong>Unsigned Bytes</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-296">Exercise 2.9.6</h3>
+<p><strong>Signed Bytes</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-297">Exercise 2.9.7</h3>
+<p><strong>Big-Endian Byte Ordering</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-298">Exercise 2.9.8</h3>
+<p><strong>Little-Endian Byte Ordering</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-299">Exercise 2.9.9</h3>
+<p><strong>Bit-Shifting</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2910">Exercise 2.9.10</h3>
+<p><strong>Bit-wise Logic</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2911">Exercise 2.9.11</h3>
+<p><strong>Byte-Vector Arithmetic</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2912">Exercise 2.9.12</h3>
+<p><strong>Bit-Vector Arithmetic</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2913">Exercise 2.9.13</h3>
+<p><strong>Binary Streams</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2914">Exercise 2.9.14</h3>
+<p><strong>Binary Sockets and Networks</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="extra-credit-exercise-2915">Extra Credit Exercise 2.9.15</h3>
+<p><strong>Simulating Hardware in Lisp</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="extra-credit-exercise-2916">Extra Credit Exercise 2.9.16</h3>
+<p><strong>Binary Instruction Sets</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="extra-credit-exercise-2917">Extra Credit Exercise 2.9.17</h3>
+<p><strong>Assembly Instructions</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-08-0-number-theory.html" class="navigation navigation-prev " aria-label="Previous page: Extra Credit: Number Theory">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-10-0-improved-text-adventure-engine.html" class="navigation navigation-next " aria-label="Next page: Extra Credit: An Improved Text Adventure Engine">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Binary Streams, Octet-Vectors, and Bit-Vectors","level":"4.1.9","depth":2,"next":{"title":"Extra Credit: An Improved Text Adventure Engine","level":"4.1.10","depth":2,"path":"2-10-0-improved-text-adventure-engine.md","ref":"./2-10-0-improved-text-adventure-engine.md","articles":[]},"previous":{"title":"Extra Credit: Number Theory","level":"4.1.8","depth":2,"path":"2-08-0-number-theory.md","ref":"./2-08-0-number-theory.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-09-0-binary-octets-bits.md","mtime":"2022-08-22T23:18:17.300Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-10-0-improved-text-adventure-engine.html b/clones/llthw.common-lisp.dev/2-10-0-improved-text-adventure-engine.html
new file mode 100644
index 00000000..6e0add48
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-10-0-improved-text-adventure-engine.html
@@ -0,0 +1,1904 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Extra Credit: An Improved Text Adventure Engine · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-11-0-conditions.html" />
+    
+    
+    <link rel="prev" href="2-09-0-binary-octets-bits.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Extra Credit: An Improved Text Adventure Engine</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-210-----extra-credit">Chapter 2.10 --- Extra Credit</h1>
+<h2 id="an-improved-text-adventure-engine">An Improved Text Adventure Engine</h2>
+<blockquote>
+<p>&quot;Oratory is a null program.&quot;</p>
+<footer>Robert A. Heinlein, <em>The Moon Is a Harsh Mistress</em></footer>
+
+</blockquote>
+<p>You&apos;ve been working hard, and now it&apos;s time to reward yourself with some more fun!  We will now take everything that we&apos;ve learned so far and put it together to make a Game Engine---one which you can use to create any text-based adventure you like, just by filling out a plain-text game script file.  This engine should also be general enough so that it can be extended later to include graphics and animation, but still lets you create your games with plain text files.</p>
+<p>Let&apos;s consider a few aspects of games that make them the most fun.  First of all, the game world should be comprehensively interactive.  Players expect to be able to interact with everything they see as they journey through your game world---and they like to be rewarded for their curiosity.  This point holds for characters, objects, and rooms---so, as we are implementing our game engine, we need to implement it in such a way that everything is interactive, and the game world is built dynamically from the objects, characters, and rooms you provide, without you having to manually, and redundantly, describe each room that is entered by a player.  This kind of approach will also help you manage your environment better, since whenever an object is added to a room, or an NPC or enemy character enters a room, the player can experience these changes to the game world effectively in real-time.  Players also like when a game keeps track of their journey through the game world, and notifies them of changes since the last time they were there.  It is also a nice touch when the game differentiates between changes that the player made versus changes that other characters made to the environment.  Players also like puzzles to solve, and various tests of their skills and progress---these challenges typically should scale to their ability, as well as scaling against their progress.  Naturally, Players also expect NPCs to have at least a basic AI---so NPCs and enemies should be able to do anything the player can do in the game world, and come to these decisions on their own, or in response to player actions. Lastly, players also like to know that their progress can be saved, so that if they need to stop playing the game and get back to work, or a challenge bests them and they die, they can go back and pick up where they left off.</p>
+<p>I know that seems like a lot of work! But Lisp helps manage the difficulty.  To aid in our efforts, we will be using CLOS to write a fully object-oriented game engine---which will help us trim down the code to the minimum through class inheritence, generic functions, and methods specialized on those classes.  Our games will then be built dynamically at run time from the game scripts we provide.</p>
+<p>As a final note, it bears mentioning that this isn&apos;t a book on AI---so we&apos;ll simply be using the best techniques for the current job without much justification or explanation.  For a broader introduction to specialized topics, you can turn to the References section of this website.</p>
+<h3 id="exercise-2101">Exercise 2.10.1</h3>
+<p><strong>The Player and Character Classes</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2102">Exercise 2.10.2</h3>
+<p><strong>The Room and Object Classes</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2103">Exercise 2.10.3</h3>
+<p><strong>Actions</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2104">Exercise 2.10.4</h3>
+<p><strong>The Game World</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2105">Exercise 2.10.5</h3>
+<p><strong>Navigation</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2106">Exercise 2.10.6</h3>
+<p><strong>Basic Agents</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2107">Exercise 2.10.7</h3>
+<p><strong>Agent Attitudes</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2108">Exercise 2.10.8</h3>
+<p><strong>Saved Game Files</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="extra-credit-exercise-2109">Extra Credit Exercise 2.10.9</h3>
+<p><strong>Multi-User Dungeons</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="extra-credit-exercise-21010">Extra Credit Exercise 2.10.10</h3>
+<p><strong>An Asynchronous Web App and Database</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="extra-credit-exercise-21011">Extra Credit Exercise 2.10.11</h3>
+<p><strong>Accounts and Authentication</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="extra-credit-exercise-21012">Extra Credit Exercise 2.10.12</h3>
+<p><strong>Auto-Save</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="extra-credit-exercise-21013">Extra Credit Exercise 2.10.13</h3>
+<p><strong>User-Created Assets</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-09-0-binary-octets-bits.html" class="navigation navigation-prev " aria-label="Previous page: Binary Streams, Octet-Vectors, and Bit-Vectors">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-11-0-conditions.html" class="navigation navigation-next " aria-label="Next page: Conditions and Error Handling">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Extra Credit: An Improved Text Adventure Engine","level":"4.1.10","depth":2,"next":{"title":"Conditions and Error Handling","level":"4.1.11","depth":2,"path":"2-11-0-conditions.md","ref":"./2-11-0-conditions.md","articles":[]},"previous":{"title":"Binary Streams, Octet-Vectors, and Bit-Vectors","level":"4.1.9","depth":2,"path":"2-09-0-binary-octets-bits.md","ref":"./2-09-0-binary-octets-bits.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-10-0-improved-text-adventure-engine.md","mtime":"2022-08-22T23:18:17.300Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-11-0-conditions.html b/clones/llthw.common-lisp.dev/2-11-0-conditions.html
new file mode 100644
index 00000000..fab957c6
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-11-0-conditions.html
@@ -0,0 +1,1903 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Conditions and Error Handling · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-12-0-2d-game.html" />
+    
+    
+    <link rel="prev" href="2-10-0-improved-text-adventure-engine.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Conditions and Error Handling</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-211">Chapter 2.11</h1>
+<h2 id="conditions-and-error-handling">Conditions and Error Handling</h2>
+<blockquote>
+<p>&quot;The death rate is the same for us as for anybody... one person, one death, sooner or later.&quot;</p>
+<footer>Robert A. Heinlein, <em>Tunnel in the Sky</em></footer>
+
+</blockquote>
+<p>No matter what you do, things will eventually go wrong in any program you write.  You may have overlooked a bug, pass a function an object of the wrong data type, overestimated the ability of your users to follow instructions, incorrectly guaged the needs of your users, or, most commonly, kept working when you&apos;re burned-out, and really messed up your code.  It happens to everyone.</p>
+<p>Thankfully, Lisp has a very mature and robust system for handling errors gracefully, so that your users can have a seamless experience.</p>
+<p>In this chapter, we&apos;ll take a tour through all of Lisp&apos;s built-in tools for handling, defining, and working with Conditions.</p>
+<h3 id="exercise-2111">Exercise 2.11.1</h3>
+<p><strong>Errors vs. Conditions</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2112">Exercise 2.11.2</h3>
+<p><strong>Signaling Conditions</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2113">Exercise 2.11.3</h3>
+<p><strong>ASSERT</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2114">Exercise 2.11.4</h3>
+<p><strong>More ASSERT</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2115">Exercise 2.11.5</h3>
+<p><strong>Handling Conditions</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2116">Exercise 2.11.6</h3>
+<p><strong>HANDLER-CASE</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2117">Exercise 2.11.7</h3>
+<p><strong>More HANDLER-CASE</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2118">Exercise 2.11.8</h3>
+<p><strong>Even More HANDLER-CASE</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2119">Exercise 2.11.9</h3>
+<p><strong>HANDLER-BIND</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21110">Exercise 2.11.10</h3>
+<p><strong>More HANDLER-BIND</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21111">Exercise 2.11.11</h3>
+<p><strong>Even More HANDLER-BIND</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21112">Exercise 2.11.12</h3>
+<p><strong>Defining Conditions</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21113">Exercise 2.11.13</h3>
+<p><strong>Defining Conditions, Again</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-10-0-improved-text-adventure-engine.html" class="navigation navigation-prev " aria-label="Previous page: Extra Credit: An Improved Text Adventure Engine">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-12-0-2d-game.html" class="navigation navigation-next " aria-label="Next page: Extra Credit: Write a 2D Game">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Conditions and Error Handling","level":"4.1.11","depth":2,"next":{"title":"Extra Credit: Write a 2D Game","level":"4.1.12","depth":2,"path":"2-12-0-2d-game.md","ref":"./2-12-0-2d-game.md","articles":[]},"previous":{"title":"Extra Credit: An Improved Text Adventure Engine","level":"4.1.10","depth":2,"path":"2-10-0-improved-text-adventure-engine.md","ref":"./2-10-0-improved-text-adventure-engine.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-11-0-conditions.md","mtime":"2022-08-22T23:18:17.300Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-12-0-2d-game.html b/clones/llthw.common-lisp.dev/2-12-0-2d-game.html
new file mode 100644
index 00000000..8c86f53c
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-12-0-2d-game.html
@@ -0,0 +1,1944 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Extra Credit: Write a 2D Game · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-13-0-compiler.html" />
+    
+    
+    <link rel="prev" href="2-11-0-conditions.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Extra Credit: Write a 2D Game</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-212-----extra-credit">Chapter 2.12 --- Extra Credit</h1>
+<h2 id="write-a-2d-game">Write a 2D Game</h2>
+<blockquote>
+<p>&quot;Going to dance at my wake?&quot;</p>
+<p>&quot;I don&apos;t dance,&quot; the lawyer answered, &quot;but you tempt me to learn.&quot;</p>
+<footer>Robert A. Heinlein, <em>I Will Fear No Evil</em></footer>
+
+</blockquote>
+<p>Hopefully you&apos;ve had a lot of fun writing and playing your own Text Adventures and MUD-like online games; but in today&apos;s gaming world, you may be hard-pressed to get your friends excited about working at the command line or out of a MUD console to try your new game.  So now it&apos;s time to make a paradigm shift and start thinking about graphics and user interfaces.</p>
+<p>We already have a game engine to work with, but it needs some major overhaul before we can write our first 2D game.  We also have to determine what we mean by 2D game, since there are so many varieties to choose from---room-based graphical adventures, like the old Sierra classics; side-scrollers, like the old Nintendo games; rogue-likes; the list goes on.  It would be useful if we could abstract all these different styles into our engine, so that we can use it to build all these different styles of 2D games.  Luckily, we&apos;re working with Lisp, and that&apos;s exactly what it was made for: endless abstraction.</p>
+<p>To support our endless whims and fancies, we will be using the <code>lispbuilder-sdl</code> library in our extended game engine, one of the better Lisp libraries available for working with graphics, audio, and all things gaming.  We will also be generating our graphics and environments procedurally, so that we can use a minimum of assets and textures from open-source graphic libraries.</p>
+<h3 id="exercise-2121">Exercise 2.12.1</h3>
+<p><strong>An Intro to LISPBUILDER-SDL</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2122">Exercise 2.12.2</h3>
+<p><strong>The Display</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2123">Exercise 2.12.3</h3>
+<p><strong>Display Types</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2124">Exercise 2.12.4</h3>
+<p><strong>Clearing and Redrawing the Display</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2125">Exercise 2.12.5</h3>
+<p><strong>Display Buffering and Memory</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2126">Exercise 2.12.6</h3>
+<p><strong>Audio</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2127">Exercise 2.12.7</h3>
+<p><strong>More Audio</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2128">Exercise 2.12.8</h3>
+<p><strong>Even More Audio</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2129">Exercise 2.12.9</h3>
+<p><strong>Primitives</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21210">Exercise 2.12.10</h3>
+<p><strong>Graphics and Other Resources</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21211">Exercise 2.12.11</h3>
+<p><strong>Surfaces</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21212">Exercise 2.12.12</h3>
+<p><strong>Procedural Content Generation</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21213">Exercise 2.12.13</h3>
+<p><strong>Game Physics</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21214">Exercise 2.12.14</h3>
+<p><strong>The Game Loop</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21215">Exercise 2.12.15</h3>
+<p><strong>Input</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21216">Exercise 2.12.16</h3>
+<p><strong>More Input</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21217">Exercise 2.12.17</h3>
+<p><strong>Fonts</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21218">Exercise 2.12.18</h3>
+<p><strong>More Fonts</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21219">Exercise 2.12.19</h3>
+<p><strong>The 2D Game Engine</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21220">Exercise 2.12.20</h3>
+<p><strong>Abstractions of Rooms and Worlds</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21221">Exercise 2.12.21</h3>
+<p><strong>Tidy Game Scripts</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-11-0-conditions.html" class="navigation navigation-prev " aria-label="Previous page: Conditions and Error Handling">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-13-0-compiler.html" class="navigation navigation-next " aria-label="Next page: The Compiler">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Extra Credit: Write a 2D Game","level":"4.1.12","depth":2,"next":{"title":"The Compiler","level":"4.1.13","depth":2,"path":"2-13-0-compiler.md","ref":"./2-13-0-compiler.md","articles":[]},"previous":{"title":"Conditions and Error Handling","level":"4.1.11","depth":2,"path":"2-11-0-conditions.md","ref":"./2-11-0-conditions.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-12-0-2d-game.md","mtime":"2022-08-22T23:18:17.300Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-13-0-compiler.html b/clones/llthw.common-lisp.dev/2-13-0-compiler.html
new file mode 100644
index 00000000..ee425c4e
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-13-0-compiler.html
@@ -0,0 +1,1918 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>The Compiler · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-14-0-tree-shaker.html" />
+    
+    
+    <link rel="prev" href="2-12-0-2d-game.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >The Compiler</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-213">Chapter 2.13</h1>
+<h2 id="the-compiler">The Compiler</h2>
+<blockquote>
+<p>&quot;I will accept the rules that you feel necessary to your freedom. I am free, no matter what rules surround me. If I find them tolerable, I tolerate them; if I find them too obnoxious, I break them. I am free because I know that I alone am morally responsible for everything I do.&quot;</p>
+<footer>Robert A. Heinlein, <em>The Moon Is a Harsh Mistress</em></footer>
+
+</blockquote>
+<p>One of the great things about Lisp is that you can write a full application with clean, straightforward, simple, dynamic code that always gives you exactly what you mean---and in fact, that&apos;s what we&apos;ve been doing so far; full-scale applications written this way won&apos;t be particularly performant and they&apos;ll be memory-hogs, but they will work, without you needing to worry about such things as Garbage Collection, static type declarations, memory allocation and deallocation, so on and so forth.  But at this stage of development, your application isn&apos;t <em>done</em>.  It&apos;s just a prototype.</p>
+<p>Another great thing about Lisp is that you can also optimize your applications to the point of absurdity, achieving twice the performance as heavily optimized C code---such as was done with the CL-PPCRE library.  That&apos;s what we&apos;ll be covering here---all the tools that the Common Lisp compiler offers that you&apos;ll need to milk your computer for every last GHz.</p>
+<p>We will also be covering relevant techniques for profiling the performance of your code-base, minimizing extraneous consing, reviewing the disassembly of your compiled code, and static type declarations.  And from here on out, we&apos;ll adopt all these techniques for subsequent exercises.</p>
+<h3 id="exercise-2131">Exercise 2.13.1</h3>
+<p><strong>TIME</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2132">Exercise 2.13.2</h3>
+<p><strong>Profiling with SB-PROFILE</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2133">Exercise 2.13.3</h3>
+<p><strong>Profiling with SB-SPROF</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2134">Exercise 2.13.4</h3>
+<p><strong>Consing</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2135">Exercise 2.13.5</h3>
+<p><strong>Less Consing</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2136">Exercise 2.13.6</h3>
+<p><strong>Even Less Consing</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2137">Exercise 2.13.7</h3>
+<p><strong>Static Typing</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2138">Exercise 2.13.8</h3>
+<p><strong>DECLARE</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2139">Exercise 2.13.9</h3>
+<p><strong>PROCLAIM</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21310">Exercise 2.13.10</h3>
+<p><strong>DECLAIM</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21311">Exercise 2.13.11</h3>
+<p><strong>EVAL-WHEN</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21312">Exercise 2.13.12</h3>
+<p><strong>DISASSEMBLE</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21313">Exercise 2.13.13</h3>
+<p><strong>Garbage Collection</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21314">Exercise 2.13.14</h3>
+<p><strong>More Garbage Collection</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21315">Exercise 2.13.15</h3>
+<p><strong>Even More Garbage Collection</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21316">Exercise 2.13.16</h3>
+<p><strong>Purifying Lisp Images</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-12-0-2d-game.html" class="navigation navigation-prev " aria-label="Previous page: Extra Credit: Write a 2D Game">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-14-0-tree-shaker.html" class="navigation navigation-next " aria-label="Next page: Extra Credit: Write a Tree-Shaker">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"The Compiler","level":"4.1.13","depth":2,"next":{"title":"Extra Credit: Write a Tree-Shaker","level":"4.1.14","depth":2,"path":"2-14-0-tree-shaker.md","ref":"./2-14-0-tree-shaker.md","articles":[]},"previous":{"title":"Extra Credit: Write a 2D Game","level":"4.1.12","depth":2,"path":"2-12-0-2d-game.md","ref":"./2-12-0-2d-game.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-13-0-compiler.md","mtime":"2022-08-22T23:18:17.300Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-14-0-tree-shaker.html b/clones/llthw.common-lisp.dev/2-14-0-tree-shaker.html
new file mode 100644
index 00000000..0414bf35
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-14-0-tree-shaker.html
@@ -0,0 +1,1912 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Extra Credit: Write a Tree-Shaker · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-15-0-docs-and-inspection.html" />
+    
+    
+    <link rel="prev" href="2-13-0-compiler.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Extra Credit: Write a Tree-Shaker</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-214-----extra-credit">Chapter 2.14 --- Extra Credit</h1>
+<h2 id="write-a-tree-shaker">Write a Tree-Shaker</h2>
+<blockquote>
+<p>&quot;Whatever the answers are, here&apos;s one monkey that&apos;s going to keep on climbing, and looking around him to see what he can see, as long as the tree holds out.&quot;</p>
+<footer>Robert A. Heinlein, <em>Methuselah&apos;s Children</em></footer>
+
+</blockquote>
+<p>You&apos;ve probably noticed in previous exercises, that when creating executable binaries of your Lisp programs to distribute or share, their size on your file system has been somewhat larger than you expected---over 80 MBs even for just a simple command-line application.  If you were to deploy this same Lisp application with a commercial implementation of ANSI Common Lisp, however, you would get a much smaller application: for a simple command-line application, probably less than 1 MB.  What gives, right?  That&apos;s a pretty big discrepancy!</p>
+<p>As it turns out, whenever you dump a Common Lisp environment to an executable binary, you&apos;re dumping <em>everything</em>.  The entire Lisp language, every contrib package, the REPL, the debugger, all the packages you&apos;ve loaded in as dependencies, and your application itself.  The commercial Lisps do this too---only they don&apos;t stop there, like the open-source implementations of Common Lisp---they then &quot;shake the tree&quot; of your Lisp application to prune all the unused symbols from the final executable.  Your final executable binary then only contains a subset of Lisp needed to execute your program, and strips out everything else not needed for run-time.</p>
+<p>There are pros and cons to both approaches.  Many Lisp Hackers consider shipping the full Common Lisp environment with each instance of the application to be a feature---after all, you can embed a SWANK server into every app, and work with the live instance on the target platform, debugging and testing as it continues working.  You can also provide a Lisp REPL to your users and let them customize everything in your program to their liking.</p>
+<p>Commercial Lisps take a more traditional approach, and provide a clear separation between developers and users.  So their binaries are stripped of everything that a user, in their view, should not have access to.</p>
+<p>Whether or not you care about providing your users the full power of Common Lisp as a part of the application run-time, writing a tree-shaker is an interesting exercise, and may give you a deeper understanding of Lisp&apos;s implementation and execution on the machine level.  To-date, the best example of a tree-shaker for SBCL was written several years ago by <a href="http://jsnell.iki.fi/blog/archive/2005-07-06.html" target="_blank">Juho Snellman</a>, but as SBCL has gone under considerable development since that time, it requires a fresh perspective---which is a perfect opportunity for learning!</p>
+<p><strong>Revision Note:</strong> A More recent tree-shaker example is available from <a href="https://gist.github.com/burtonsamograd/f08f561264ff94391300" target="_blank">Burton Samograd</a>, with some relevant chat history from IRC included.</p>
+<h3 id="exercise-2141">Exercise 2.14.1</h3>
+<p><strong>Shaking Trees vs. Stripping Binaries</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2142">Exercise 2.14.2</h3>
+<p><strong>Pruning Trees</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2143">Exercise 2.14.3</h3>
+<p><strong>Unneccessary Run-Time Packages</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2144">Exercise 2.14.4</h3>
+<p><strong>Full Garbage Collection</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2145">Exercise 2.14.5</h3>
+<p><strong>Disabling the Debugger</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2146">Exercise 2.14.6</h3>
+<p><strong>Type Safety</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2147">Exercise 2.14.7</h3>
+<p><strong>A Basic Tree-Shaker</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2148">Exercise 2.14.8</h3>
+<p><strong>Code-Walking</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2149">Exercise 2.14.9</h3>
+<p><strong>More Code-Walking</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21410">Exercise 2.14.10</h3>
+<p><strong>Even More Code-Walking</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21411">Exercise 2.14.11</h3>
+<p><strong>A Smart Tree-Shaker</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21412">Exercise 2.14.12</h3>
+<p><strong>NUKE-LISP-AND-DIE</strong></p>
+<p>aka, Optimize, Collect, Shake, Save, Purify, Compress and Die</p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21413">Exercise 2.14.13</h3>
+<p><strong>Packaging the Tree-Shaker</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21414">Exercise 2.14.14</h3>
+<p><strong>Revisiting the 2D Game Engine</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-13-0-compiler.html" class="navigation navigation-prev " aria-label="Previous page: The Compiler">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-15-0-docs-and-inspection.html" class="navigation navigation-next " aria-label="Next page: Documentation and Inspection">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Extra Credit: Write a Tree-Shaker","level":"4.1.14","depth":2,"next":{"title":"Documentation and Inspection","level":"4.1.15","depth":2,"path":"2-15-0-docs-and-inspection.md","ref":"./2-15-0-docs-and-inspection.md","articles":[]},"previous":{"title":"The Compiler","level":"4.1.13","depth":2,"path":"2-13-0-compiler.md","ref":"./2-13-0-compiler.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-14-0-tree-shaker.md","mtime":"2022-08-22T23:18:17.300Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-15-0-docs-and-inspection.html b/clones/llthw.common-lisp.dev/2-15-0-docs-and-inspection.html
new file mode 100644
index 00000000..00cc2206
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-15-0-docs-and-inspection.html
@@ -0,0 +1,1904 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Documentation and Inspection · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-16-0-foreign-libs.html" />
+    
+    
+    <link rel="prev" href="2-14-0-tree-shaker.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Documentation and Inspection</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-215">Chapter 2.15</h1>
+<h2 id="documentation-and-inspection">Documentation and Inspection</h2>
+<blockquote>
+<p>&quot;This non-system holds together by having no togetherness, no uniformity, never seeking perfection, no Utopias---just answers good enough to get by, with lots of looseness and room for many ways and attitudes.&quot;</p>
+<footer>Robert A. Heinlein, <em>Glory Road</em></footer>
+
+</blockquote>
+<p>When exploring a new library, documentation of the source code is invaluable.  In some cases, the ultimate failure or success of a project can rest squarely on how well it has been documented---but lets say you write a library that has no competition, so people use it anyway because it&apos;s the only tool available.  How much time and effort can you save answering questions and solving issues, by providing clear and instructive documentation, use-cases, and tutorials up-front?</p>
+<p>The same goes for commenting your source-code; sometimes you might think your code is perfectly self-explanatory, but then six-months down the road---or even the next day!---you come back to your code and have no idea what you were thinking when you implemented a critical function to your system.  Imagine how a newcomer to your source code might feel!</p>
+<p>Another problem can be the opaqueness of objects. In any serious project, you have all these complex, structured objects running in your program---they could be from any number of libraries, each of which could be using very different conventions.  If only there was some way to see inside these black boxes!</p>
+<p>Oh right, this is Lisp.  You can get into the REPL of any running Lisp application and inspect <em>everything</em>.</p>
+<h3 id="exercise-2151">Exercise 2.15.1</h3>
+<p><strong>Documentation and Comments</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2152">Exercise 2.15.2</h3>
+<p><strong>More Documentation and Comments</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2153">Exercise 2.15.3</h3>
+<p><strong>Even More Documentation and Comments</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2154">Exercise 2.15.4</h3>
+<p><strong>DOCUMENTATION</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2155">Exercise 2.15.5</h3>
+<p><strong>Unreadable Objects</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2156">Exercise 2.15.6</h3>
+<p><strong>Modifying the Lisp Printer</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2157">Exercise 2.15.7</h3>
+<p><strong>DESCRIBE</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2158">Exercise 2.15.8</h3>
+<p><strong>More DESCRIBE</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2159">Exercise 2.15.9</h3>
+<p><strong>Even More DESCRIBE</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21510">Exercise 2.15.10</h3>
+<p><strong>INSPECT</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21511">Exercise 2.15.11</h3>
+<p><strong>More INSPECT</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21512">Exercise 2.15.12</h3>
+<p><strong>Even More INSPECT</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="extra-credit-exercise-21513">Extra Credit Exercise 2.15.13</h3>
+<p><strong>Documentation and Inspection in Emacs+SLIME</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-14-0-tree-shaker.html" class="navigation navigation-prev " aria-label="Previous page: Extra Credit: Write a Tree-Shaker">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-16-0-foreign-libs.html" class="navigation navigation-next " aria-label="Next page: Extra Credit: Foreign Libraries in Lisp">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Documentation and Inspection","level":"4.1.15","depth":2,"next":{"title":"Extra Credit: Foreign Libraries in Lisp","level":"4.1.16","depth":2,"path":"2-16-0-foreign-libs.md","ref":"./2-16-0-foreign-libs.md","articles":[]},"previous":{"title":"Extra Credit: Write a Tree-Shaker","level":"4.1.14","depth":2,"path":"2-14-0-tree-shaker.md","ref":"./2-14-0-tree-shaker.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-15-0-docs-and-inspection.md","mtime":"2022-08-22T23:18:17.300Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-16-0-foreign-libs.html b/clones/llthw.common-lisp.dev/2-16-0-foreign-libs.html
new file mode 100644
index 00000000..0d5d9cbf
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-16-0-foreign-libs.html
@@ -0,0 +1,1882 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Extra Credit: Foreign Libraries in Lisp · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-17-0-debugging-testing.html" />
+    
+    
+    <link rel="prev" href="2-15-0-docs-and-inspection.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Extra Credit: Foreign Libraries in Lisp</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-216-----extra-credit">Chapter 2.16 --- Extra Credit</h1>
+<h2 id="foreign-libraries-in-lisp">Foreign Libraries in Lisp</h2>
+<blockquote>
+<p>&quot;I was indeed a total stranger in an utterly strange and confusing land... but I do not think, in retrospect, that I would have made my condition worse had I simply blurted out my predicament. I would not have been believed.&quot;</p>
+<footer>Robert A. Heinlein, <em>Job: A Comedy of Justice</em></footer>
+
+</blockquote>
+<p>Like many other languages these days, Lisp allows you to call foreign code libraries, compiled or otherwise, as if they were native code. Lisp was one of the first languages to include this feature, and the term &quot;Foreign Function Interface&quot; was introduced specifically for this functionality in Common Lisp.</p>
+<p>We have already seen some foreign libraries in action---such as <code>lispbuilder-sdl</code> in Chapter 2.12, and a few database libraries in Chapter 2.4. In this chapter we will be exploring a variety of foreign function interface libraries available in Quicklisp, so that you can get a feel for working with Lisp in a diverse ecosystem of code from many different sources---even Python libraries!</p>
+<h3 id="exercise-2161">Exercise 2.16.1</h3>
+<p><strong>CL-COLLIDER: an interface to SuperCollider</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2162">Exercise 2.16.2</h3>
+<p><strong>CL-COLLIDER: Live-Hacking Audio</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2163">Exercise 2.16.3</h3>
+<p><strong>CL-COLLIDER: Audio-Generating Macros</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2164">Exercise 2.16.4</h3>
+<p><strong>CL+SSL: an interface to OpenSSL</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2165">Exercise 2.16.5</h3>
+<p><strong>GSLL: an interface to the GNU Scientific Library</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2166">Exercise 2.16.6</h3>
+<p><strong>Burgled-Batteries: a Python--Lisp Bridge</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2167">Exercise 2.16.7</h3>
+<p><strong>Burgled-Batteries and SciPy</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2168">Exercise 2.16.8</h3>
+<p><strong>Burgled-Batteries and Python GUI Libraries</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2169">Exercise 2.16.9</h3>
+<p><strong>Burgled-Batteries: Python In Lisp</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-15-0-docs-and-inspection.html" class="navigation navigation-prev " aria-label="Previous page: Documentation and Inspection">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-17-0-debugging-testing.html" class="navigation navigation-next " aria-label="Next page: Debugging and Unit Testing">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Extra Credit: Foreign Libraries in Lisp","level":"4.1.16","depth":2,"next":{"title":"Debugging and Unit Testing","level":"4.1.17","depth":2,"path":"2-17-0-debugging-testing.md","ref":"./2-17-0-debugging-testing.md","articles":[]},"previous":{"title":"Documentation and Inspection","level":"4.1.15","depth":2,"path":"2-15-0-docs-and-inspection.md","ref":"./2-15-0-docs-and-inspection.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-16-0-foreign-libs.md","mtime":"2022-08-22T23:18:17.300Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-17-0-debugging-testing.html b/clones/llthw.common-lisp.dev/2-17-0-debugging-testing.html
new file mode 100644
index 00000000..18773b1b
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-17-0-debugging-testing.html
@@ -0,0 +1,1902 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Debugging and Unit Testing · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-18-0-ffi.html" />
+    
+    
+    <link rel="prev" href="2-16-0-foreign-libs.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Debugging and Unit Testing</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-217">Chapter 2.17</h1>
+<h2 id="debugging-and-unit-testing">Debugging and Unit Testing</h2>
+<blockquote>
+<p>&quot;I know, as the prime lesson of my profession, that good intentions are the source of more folly than all other causes put together.&quot;</p>
+<footer>Robert A. Heinlein, <em>Glory Road</em></footer>
+
+</blockquote>
+<p>No matter what you do, how hard you try, your code will eventually break.  You, or someone else maintaining your code, will make a mistake, or overlook that one use-case that brings your whole program down.  It happens.  Software is fragile by nature, and programmers <em>are</em> only human.  So remember this: the debugger is your friend.  It&apos;s only there to help you.</p>
+<p>You&apos;ve seen the interactive debugger enough times by now to have a general idea how it works, but Lisp has a lot more tools to help you debug as you go; you&apos;ve already seen how to write and handle Conditions in Chapter 2.11---but that&apos;s just a small piece of a much bigger puzzle.</p>
+<h3 id="exercise-2171">Exercise 2.17.1</h3>
+<p><strong>The Debugger</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2172">Exercise 2.17.2</h3>
+<p><strong>Control Stack</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2173">Exercise 2.17.3</h3>
+<p><strong>Backtrace</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2174">Exercise 2.17.4</h3>
+<p><strong>Restarts</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2175">Exercise 2.17.5</h3>
+<p><strong>Stepping</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2176">Exercise 2.17.6</h3>
+<p><strong>LDB, the low-level debugger</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2177">Exercise 2.17.7</h3>
+<p><strong>More LDB</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2178">Exercise 2.17.8</h3>
+<p><strong>Even More LDB</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2179">Exercise 2.17.9</h3>
+<p><strong>Writing Tests</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21710">Exercise 2.17.10</h3>
+<p><strong>Regression Testing with FiveAM</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21711">Exercise 2.17.11</h3>
+<p><strong>More FiveAM</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-11712">Exercise 1.17.12</h3>
+<p><strong>Even More FiveAM</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="extra-credit-exercise-21713">Extra Credit Exercise 2.17.13</h3>
+<p><strong>Interactive Debugging in Emacs+SLIME</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-16-0-foreign-libs.html" class="navigation navigation-prev " aria-label="Previous page: Extra Credit: Foreign Libraries in Lisp">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-18-0-ffi.html" class="navigation navigation-next " aria-label="Next page: Extra Credit: Write a Foreign Function Interface">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Debugging and Unit Testing","level":"4.1.17","depth":2,"next":{"title":"Extra Credit: Write a Foreign Function Interface","level":"4.1.18","depth":2,"path":"2-18-0-ffi.md","ref":"./2-18-0-ffi.md","articles":[]},"previous":{"title":"Extra Credit: Foreign Libraries in Lisp","level":"4.1.16","depth":2,"path":"2-16-0-foreign-libs.md","ref":"./2-16-0-foreign-libs.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-17-0-debugging-testing.md","mtime":"2022-08-22T23:18:17.300Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-18-0-ffi.html b/clones/llthw.common-lisp.dev/2-18-0-ffi.html
new file mode 100644
index 00000000..ad6a6a42
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-18-0-ffi.html
@@ -0,0 +1,1873 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Extra Credit: Write a Foreign Function Interface · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-19-0-essential-libs.html" />
+    
+    
+    <link rel="prev" href="2-17-0-debugging-testing.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Extra Credit: Write a Foreign Function Interface</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-218-----extra-credit">Chapter 2.18 --- Extra Credit</h1>
+<h2 id="write-a-foreign-function-interface">Write a Foreign Function Interface</h2>
+<blockquote>
+<p>&quot;Geniuses and supergeniuses always make their own rules... they do not accept the monkey customs of their lessers.&quot;</p>
+<footer>Robert A. Heinlein, <em>Friday</em></footer>
+
+</blockquote>
+<p><strong>Revision Note:</strong> <em>The intro text requires minor expansion, and there should be more exercises.</em></p>
+<p>Extending on Chapter 2.16, we will now write our own Foreign Function Interface for the Oculus Rift SDK using CFFI.  This particular use case poses some interesting challenges that will hopefully prove more generally useful to you in your career as a Lisp Hacker.</p>
+<p>We will also be using this library in Chapters 3.6 and 3.7; so that should be a good motivation to see this through to the end!</p>
+<h3 id="exercise-2181">Exercise 2.18.1</h3>
+<p><strong>CFFI</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2182">Exercise 2.18.2</h3>
+<p><strong>More CFFI</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2183">Exercise 2.18.3</h3>
+<p><strong>Even More CFFI</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2184">Exercise 2.18.4</h3>
+<p><strong>Grovelling</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2185">Exercise 2.18.5</h3>
+<p><strong>SWIG</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2186">Exercise 2.18.6</h3>
+<p><strong>The Oculus Rift SDK</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2187">Exercise 2.18.7</h3>
+<p><strong>A Basic 3D World</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-17-0-debugging-testing.html" class="navigation navigation-prev " aria-label="Previous page: Debugging and Unit Testing">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-19-0-essential-libs.html" class="navigation navigation-next " aria-label="Next page: Essential Lisp Libraries">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Extra Credit: Write a Foreign Function Interface","level":"4.1.18","depth":2,"next":{"title":"Essential Lisp Libraries","level":"4.1.19","depth":2,"path":"2-19-0-essential-libs.md","ref":"./2-19-0-essential-libs.md","articles":[]},"previous":{"title":"Debugging and Unit Testing","level":"4.1.17","depth":2,"path":"2-17-0-debugging-testing.md","ref":"./2-17-0-debugging-testing.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-18-0-ffi.md","mtime":"2022-08-22T23:18:17.300Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-19-0-essential-libs.html b/clones/llthw.common-lisp.dev/2-19-0-essential-libs.html
new file mode 100644
index 00000000..0965d023
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-19-0-essential-libs.html
@@ -0,0 +1,1952 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Essential Lisp Libraries · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-20-0-packaging-libs.html" />
+    
+    
+    <link rel="prev" href="2-18-0-ffi.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Essential Lisp Libraries</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-219">Chapter 2.19</h1>
+<h2 id="essential-lisp-libraries">Essential Lisp Libraries</h2>
+<blockquote>
+<p>&quot;He seeks order, not truth. Suppose truth defies order, will he accept it? Will you? I think not.&quot;</p>
+<footer>Robert A. Heinlein, <em>Life-Line</em></footer>
+
+</blockquote>
+<p><strong>Revision Note:</strong> <em>This chapter&apos;s intro text needs minor expansion.</em></p>
+<p>Introduce or review through exercises a number of essential lisp libraries that are included in nearly all serious projects, in some cases being considered extensions to the standard.</p>
+<p>For starters:</p>
+<ul>
+<li>ASDF</li>
+<li>Alexandria</li>
+<li>CL-PPCRE</li>
+<li>CL-FAD</li>
+<li>Flexi-Streams</li>
+<li>Babel</li>
+<li>Ironclad</li>
+</ul>
+<h3 id="exercise-2191">Exercise 2.19.1</h3>
+<p><strong>ASDF</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2192">Exercise 2.19.2</h3>
+<p><strong>More ASDF</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2193">Exercise 2.19.3</h3>
+<p><strong>Even More ASDF</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2194">Exercise 2.19.4</h3>
+<p><strong>Alexandria</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2195">Exercise 2.19.5</h3>
+<p><strong>More Alexandria</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2196">Exercise 2.19.6</h3>
+<p><strong>Even More Alexandria</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2197">Exercise 2.19.7</h3>
+<p><strong>CL-PPCRE</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2198">Exercise 2.19.8</h3>
+<p><strong>More CL-PPCRE</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2199">Exercise 2.19.9</h3>
+<p><strong>Even More CL-PPCRE</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21910">Exercise 2.19.10</h3>
+<p><strong>CL-FAD</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21911">Exercise 2.19.11</h3>
+<p><strong>More CL-FAD</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21912">Exercise 2.19.12</h3>
+<p><strong>Even More CL-FAD</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21913">Exercise 2.19.13</h3>
+<p><strong>Flexi-Streams</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21914">Exercise 2.19.14</h3>
+<p><strong>More Flexi-Streams</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21915">Exercise 2.19.15</h3>
+<p><strong>Even More Flexi-Streams</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21916">Exercise 2.19.16</h3>
+<p><strong>Babel</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21917">Exercise 2.19.17</h3>
+<p><strong>More Babel</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21918">Exercise 2.19.18</h3>
+<p><strong>Even More Babel</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21919">Exercise 2.19.19</h3>
+<p><strong>Ironclad</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21920">Exercise 2.19.20</h3>
+<p><strong>More Ironclad</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-21921">Exercise 2.19.21</h3>
+<p><strong>Even More Ironclad</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-18-0-ffi.html" class="navigation navigation-prev " aria-label="Previous page: Extra Credit: Write a Foreign Function Interface">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-20-0-packaging-libs.html" class="navigation navigation-next " aria-label="Next page: Extra Credit: Packaging Lisp Libraries">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Essential Lisp Libraries","level":"4.1.19","depth":2,"next":{"title":"Extra Credit: Packaging Lisp Libraries","level":"4.1.20","depth":2,"path":"2-20-0-packaging-libs.md","ref":"./2-20-0-packaging-libs.md","articles":[]},"previous":{"title":"Extra Credit: Write a Foreign Function Interface","level":"4.1.18","depth":2,"path":"2-18-0-ffi.md","ref":"./2-18-0-ffi.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-19-0-essential-libs.md","mtime":"2022-08-22T23:18:17.304Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-20-0-packaging-libs.html b/clones/llthw.common-lisp.dev/2-20-0-packaging-libs.html
new file mode 100644
index 00000000..04ca6ed4
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-20-0-packaging-libs.html
@@ -0,0 +1,1907 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Extra Credit: Packaging Lisp Libraries · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="2-21-0-review.html" />
+    
+    
+    <link rel="prev" href="2-19-0-essential-libs.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Extra Credit: Packaging Lisp Libraries</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-220-----extra-credit">Chapter 2.20 --- Extra Credit</h1>
+<h2 id="packaging-lisp-libraries">Packaging Lisp Libraries</h2>
+<blockquote>
+<p>&quot;A &apos;critic&apos; is a man who creates nothing and thereby feels qualified to judge the work of creative men. There is logic in this; he is unbiased---he hates all creative people equally.&quot;</p>
+<footer>Robert A. Heinlein, <em>Time Enough for Love</em></footer>
+
+</blockquote>
+<p>Now that you&apos;ve got a solid grounding in writing, optimizing, debugging and testing your Lisp software, it&apos;s time to learn all about packaging your code for the wild---namely with ASDF, to be distributed in the Quicklisp package manager.  You&apos;ve been using ASDF system files and Quicklisp to manage your projects since Part One, but now it&apos;s time to take a closer look at the structure of these ASDF files, and all the awesome power they can hold.</p>
+<p>But, as the famous saying goes, with great power comes great responsibility---there&apos;s a right way of packaging your libraries, and there are certain limitations as to what sort of project qualifies for inclusion in Quicklisp.  We&apos;ll be covering all this and more.</p>
+<h3 id="exercise-2201">Exercise 2.20.1</h3>
+<p><strong>Considerations for a Useful Library</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2202">Exercise 2.20.2</h3>
+<p><strong>Quicklisp Library Submission Guidelines</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2203">Exercise 2.20.3</h3>
+<p><strong>Required System Metadata</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2204">Exercise 2.20.4</h3>
+<p><strong>ASDF In More Detail</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2205">Exercise 2.20.5</h3>
+<p><strong>System Dependencies</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2206">Exercise 2.20.6</h3>
+<p><strong>More System Dependencies</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2207">Exercise 2.20.7</h3>
+<p><strong>Components: Files and Modules</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2208">Exercise 2.20.8</h3>
+<p><strong>Component Interdependency</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-2209">Exercise 2.20.9</h3>
+<p><strong>Multiple Systems and Packages</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-22010">Exercise 2.20.10</h3>
+<p><strong>Test Suites</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-22011">Exercise 2.20.11</h3>
+<p><strong>More Test Suites: FiveAM</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-22012">Exercise 2.20.12</h3>
+<p><strong>More Test Suites: Prove</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-22013">Exercise 2.20.13</h3>
+<p><strong>Continuous Integration Testing</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-22014">Exercise 2.20.14</h3>
+<p><strong>Code Coverage Testing</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-19-0-essential-libs.html" class="navigation navigation-prev " aria-label="Previous page: Essential Lisp Libraries">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="2-21-0-review.html" class="navigation navigation-next " aria-label="Next page: Detailed Syntax Review">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Extra Credit: Packaging Lisp Libraries","level":"4.1.20","depth":2,"next":{"title":"Detailed Syntax Review","level":"4.1.21","depth":2,"path":"2-21-0-review.md","ref":"./2-21-0-review.md","articles":[]},"previous":{"title":"Essential Lisp Libraries","level":"4.1.19","depth":2,"path":"2-19-0-essential-libs.md","ref":"./2-19-0-essential-libs.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-20-0-packaging-libs.md","mtime":"2022-08-22T23:18:17.304Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/2-21-0-review.html b/clones/llthw.common-lisp.dev/2-21-0-review.html
new file mode 100644
index 00000000..cfae4e0a
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/2-21-0-review.html
@@ -0,0 +1,1852 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Detailed Syntax Review · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-00-00-overview.html" />
+    
+    
+    <link rel="prev" href="2-20-0-packaging-libs.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Detailed Syntax Review</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-221">Chapter 2.21</h1>
+<h2 id="detailed-review-of-common-lisp">Detailed Review of Common Lisp</h2>
+<blockquote>
+<p>&quot;The best things in life are beyond money; their price is agony and sweat and devotion... and the price demanded for the most precious of all things in life is life itself---ultimate cost for perfect value.&quot;</p>
+<footer>Robert A. Heinlein, <em>Starship Troopers</em></footer>
+
+</blockquote>
+<p>Brutal though it may have been, you have reached the end of Part Two.  There is just one final challenge before you move on to the industry-themed practical challenges of Part Three---and that&apos;s to make your peace with the Common Lisp HyperSpec, and even learn to love it. The HyperSpec is, of course, the de-facto official specification of the Common Lisp language freely available to the public, its text at least partly extracted from the original standards document, ANSI X3.226 (which is now available in a revised version as <a href="http://webstore.ansi.org/RecordDetail.aspx?sku=ANSI%20INCITS%20226-1994%20(R2004)" target="_blank">ANSI INCITS 226-1994 (R2004)</a>). If you&apos;d prefer to use the official ANSI standard as your choice of reference over the HyperSpec, I don&apos;t think anyone in the Lisp community would fault you.</p>
+<p>Lisp as a language gets a lot of flak from outsiders and newcomers to the language, simply because the HyperSpec looks like it hasn&apos;t been updated since 1994.  As it so happens, it was created in 1996, so design-wise it looked old and out of date even then---and the current version is actually much improved over the original release, which had a silver background, and a harsh aqua banner with a slogan reading, &quot;the very definition of class.&quot;  But given that the HyperSpec is best viewed within Emacs beside your code in a text-based browser, so you can get right at the documentation text without any interference, it doesn&apos;t much matter what the HyperSpec looks like.  What matters is that, aside from the ANSI Standard itself, it is the most complete reference manual to the language available.  And it&apos;s free.</p>
+<p>What the HyperSpec is not, however, is a tutorial or implementation guide---<em>this</em> book, Learn Lisp the Hard Way, has been your tutorial; the last tutorial you need to start your career as a professional Lisp Hacker is how to use the CLHS, and appreciate the magnitude and detail of that document.  So that&apos;s what we&apos;ll cover here:</p>
+<ul>
+<li>The organization and structure of the CLHS</li>
+<li>Navigating the Chapters, Master Index, and Glossary</li>
+<li>Understanding formal definitions of Common Lisp symbols</li>
+<li>Searching the CLHS on the Web</li>
+<li>Accessing the CLHS with Emacs+SLIME</li>
+</ul>
+<p>The final challenge before you move on to Part Three is this:</p>
+<ul>
+<li>Read through all chapters of the CLHS three times, carefully, making notes for yourself as you go</li>
+<li>Study and memorize all symbols in the Common Lisp language, noting their class and type, and other interesting features about them</li>
+<li>Review the formal definitions of all symbols until, from memory, you can write down on paper the semantics of every symbol</li>
+</ul>
+<p>Only once you&apos;ve fully internalized the Common Lisp HyperSpec, can you proudly boast that you&apos;re a Lisp Hacker; and then you can move on to Part Three.  Good luck, and see you there!</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-20-0-packaging-libs.html" class="navigation navigation-prev " aria-label="Previous page: Extra Credit: Packaging Lisp Libraries">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-00-00-overview.html" class="navigation navigation-next " aria-label="Next page: Lisp So(u)rcery">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Detailed Syntax Review","level":"4.1.21","depth":2,"next":{"title":"Lisp So(u)rcery","level":"5.1","depth":1,"path":"3-00-00-overview.md","ref":"3-00-00-overview.md","articles":[{"title":"Real-world Web Apps","level":"5.1.1","depth":2,"path":"3-01-00-web-apps.md","ref":"./3-01-00-web-apps.md","articles":[]},{"title":"Typesetting","level":"5.1.2","depth":2,"path":"3-02-00-typesetting.md","ref":"./3-02-00-typesetting.md","articles":[]},{"title":"Native Mobile Applications","level":"5.1.3","depth":2,"path":"3-03-00-mobile.md","ref":"./3-03-00-mobile.md","articles":[]},{"title":"Cross-platform Desktop Applications","level":"5.1.4","depth":2,"path":"3-04-00-gui.md","ref":"./3-04-00-gui.md","articles":[]},{"title":"Drivers, Daemons, and System-Utilities","level":"5.1.5","depth":2,"path":"3-05-00-system-utils.md","ref":"./3-05-00-system-utils.md","articles":[]},{"title":"Reverse Engineering","level":"5.1.6","depth":2,"path":"3-06-00-reverse-engineering.md","ref":"./3-06-00-reverse-engineering.md","articles":[]},{"title":"Graphics Rendering","level":"5.1.7","depth":2,"path":"3-07-00-graphics.md","ref":"./3-07-00-graphics.md","articles":[]},{"title":"OpenGL, SDL, and 3D Game Development","level":"5.1.8","depth":2,"path":"3-08-00-gaming.md","ref":"./3-08-00-gaming.md","articles":[]},{"title":"Audio Generation and Manipulation","level":"5.1.9","depth":2,"path":"3-09-00-audio.md","ref":"./3-09-00-audio.md","articles":[]},{"title":"Data Aggregation and Analysis","level":"5.1.10","depth":2,"path":"3-10-00-data.md","ref":"./3-10-00-data.md","articles":[]},{"title":"Cryptography and Security","level":"5.1.11","depth":2,"path":"3-11-00-cryptosec.md","ref":"./3-11-00-cryptosec.md","articles":[]},{"title":"Financial Software and Crypto-Currencies","level":"5.1.12","depth":2,"path":"3-12-00-fintech.md","ref":"./3-12-00-fintech.md","articles":[]},{"title":"Scientific Computing","level":"5.1.13","depth":2,"path":"3-13-00-scientific-computing.md","ref":"./3-13-00-scientific-computing.md","articles":[]},{"title":"Computational Physics","level":"5.1.14","depth":2,"path":"3-14-00-computational-physics.md","ref":"./3-14-00-computational-physics.md","articles":[]},{"title":"Quantum Computing","level":"5.1.15","depth":2,"path":"3-15-00-quantum-computing.md","ref":"./3-15-00-quantum-computing.md","articles":[]},{"title":"Natural Language Processing","level":"5.1.16","depth":2,"path":"3-16-00-nlp.md","ref":"./3-16-00-nlp.md","articles":[]},{"title":"Artificial Intelligence","level":"5.1.17","depth":2,"path":"3-17-00-ai.md","ref":"./3-17-00-ai.md","articles":[]},{"title":"Robotics","level":"5.1.18","depth":2,"path":"3-18-00-robotics.md","ref":"./3-18-00-robotics.md","articles":[]},{"title":"Space Tech","level":"5.1.19","depth":2,"path":"3-19-00-space-tech.md","ref":"./3-19-00-space-tech.md","articles":[]},{"title":"Neuroscience and Thought-Controlled Computing","level":"5.1.20","depth":2,"path":"3-20-00-neurotech.md","ref":"./3-20-00-neurotech.md","articles":[]},{"title":"A Simple LispOS","level":"5.1.21","depth":2,"path":"3-21-00-lispos.md","ref":"./3-21-00-lispos.md","articles":[]},{"title":"Build Your Own Lisp Machine","level":"5.1.22","depth":2,"path":"3-22-00-lisp-machine.md","ref":"./3-22-00-lisp-machine.md","articles":[]},{"title":"Government and Military Grade Systems","level":"5.1.23","depth":2,"path":"3-23-00-gov-mil.md","ref":"./3-23-00-gov-mil.md","articles":[]}]},"previous":{"title":"Extra Credit: Packaging Lisp Libraries","level":"4.1.20","depth":2,"path":"2-20-0-packaging-libs.md","ref":"./2-20-0-packaging-libs.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"2-21-0-review.md","mtime":"2022-08-22T23:18:17.304Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-00-00-overview.html b/clones/llthw.common-lisp.dev/3-00-00-overview.html
new file mode 100644
index 00000000..f4463c37
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-00-00-overview.html
@@ -0,0 +1,1863 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Lisp So(u)rcery · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-01-00-web-apps.html" />
+    
+    
+    <link rel="prev" href="2-21-0-review.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter active" data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Lisp So(u)rcery</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="part-three">PART THREE</h1>
+<h2 id="lisp-sourcery">Lisp So(u)rcery</h2>
+<blockquote>
+<p>&quot;I would be disappointed if everything I saw turned out to be something Western Electric will build once Bell Labs works the bugs out. There ought to be some magic, somewhere, just for flavor.&quot;</p>
+<footer>Robert A. Heinlein, <em>Glory Road</em></footer>
+
+</blockquote>
+<p>Now that you&apos;ve gotten a solid grounding in the Common Lisp language and some popular Lisp libraries, it&apos;s time to really challenge yourself.  While up to this point, Extra Credit exercises have been mixed in-between fundamental language exercises, this part of the book is all practical exercises.  It will guide you through many of the popular use-cases you will come across as a professional Lisp developer, and by the end of it, you will be able to work some real programming magic.</p>
+<p>This part of the book will also be less prescriptive, and leave you to rely on your knowledge and instinct to complete the outlined projects.  I will guide you through system architecture, laying out a project into user stories, and finding relevant libraries which can save you time; but I&apos;m leaving the coding to you.  When you complete each chapter, you can then compare your implementation against my own reference implementation and those of your peers.  But remember, no cheating!  It&apos;s important that you finish the project on your own and get it to run with only the information I&apos;ve given you, before looking for alternate implementations to improve your style or methodology.</p>
+<h3 id="chapters">Chapters</h3>
+<ol>
+<li><a href="3-01-00-web-apps.html">Real-World Web Apps</a></li>
+<li><a href="3-02-00-typesetting.html">Typesetting</a></li>
+<li><a href="3-03-00-mobile.html">Native Mobile Applications</a></li>
+<li><a href="3-04-00-gui.html">Cross-Platform Desktop Applications</a></li>
+<li><a href="3-05-00-system-utils.html">Drivers, Daemons, and System-Utilities</a></li>
+<li><a href="3-06-00-reverse-engineering.html">Reverse Engineering</a></li>
+<li><a href="3-07-00-graphics.html">Graphics Rendering</a></li>
+<li><a href="3-08-00-gaming.html">OpenGL, SDL, and 3D Game Development</a></li>
+<li><a href="3-09-00-audio.html">Audio Generation and Manipulation</a></li>
+<li><a href="3-10-00-data.html">Data Aggregation and Analysis</a></li>
+<li><a href="3-11-00-cryptosec.html">Cryptography and Security</a></li>
+<li><a href="3-12-00-fintech.html">Financial Software and Crypto-Currencies</a></li>
+<li><a href="3-13-00-scientific-computing.html">Scientific Computing</a></li>
+<li><a href="3-14-00-computational-physics.html">Computational Physics</a></li>
+<li><a href="3-15-00-quantum-computing.html">Quantum Computing</a></li>
+<li><a href="3-16-00-nlp.html">Natural Language Processing</a></li>
+<li><a href="3-17-00-ai.html">Artificial Intelligence</a></li>
+<li><a href="3-18-00-robotics.html">Robotics</a></li>
+<li><a href="3-19-00-space-tech.html">Space-Tech</a></li>
+<li><a href="3-20-00-neurotech.html">Neuroscience and Thought-Controlled Computing</a></li>
+<li><a href="3-21-00-lispos.html">A Simple LispOS</a></li>
+<li><a href="3-22-00-lisp-machine.html">Build Your Own Lisp Machine</a></li>
+<li><a href="3-23-00-gov-mil.html">Government and Military Grade Systems</a></li>
+</ol>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="2-21-0-review.html" class="navigation navigation-prev " aria-label="Previous page: Detailed Syntax Review">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-01-00-web-apps.html" class="navigation navigation-next " aria-label="Next page: Real-world Web Apps">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Lisp So(u)rcery","level":"5.1","depth":1,"next":{"title":"Real-world Web Apps","level":"5.1.1","depth":2,"path":"3-01-00-web-apps.md","ref":"./3-01-00-web-apps.md","articles":[]},"previous":{"title":"Detailed Syntax Review","level":"4.1.21","depth":2,"path":"2-21-0-review.md","ref":"./2-21-0-review.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-00-00-overview.md","mtime":"2022-08-22T22:55:10.399Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-01-00-web-apps.html b/clones/llthw.common-lisp.dev/3-01-00-web-apps.html
new file mode 100644
index 00000000..3c2715d6
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-01-00-web-apps.html
@@ -0,0 +1,1899 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Real-world Web Apps · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-02-00-typesetting.html" />
+    
+    
+    <link rel="prev" href="3-00-00-overview.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter active" data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Real-world Web Apps</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-31">Chapter 3.1</h1>
+<h2 id="real-world-web-applications">Real-World Web Applications</h2>
+<blockquote>
+<p>&quot;Free will is a golden thread running through the frozen matrix of fixed events.&quot;</p>
+<footer>Robert A. Heinlein, <em>The Rolling Stones</em></footer>
+
+</blockquote>
+<p>There is no other problem-domain more complicated than the Web.  To be a successful web developer these days, you have to wear a lot of hats---you need to be a programmer, a graphic designer, a system administrator, a DBA, a security expert, you have to know the quirks of every platform and browser, mobile or desktop, you have to keep abreast of the cutting edge.  It&apos;s an endless journey, and you&apos;ll always find the need to be better than you are.</p>
+<p>One of the biggest problems with the Web is just how many languages you need to know to create a straightforward web application.  It&apos;s not just HTML, CSS, a splattering of JavaScript, and your choice of PHP, Python, or Perl anymore.  Now you need to learn a web framework, the language it&apos;s written in to write the server-side logic, an arbitrary templating language to create your interfaces, and new protocols like Comet or Websockets for real-time two-way communication between the server and client.</p>
+<p>Lisp solves all these issues, and will give you an edge over the competition.  You only need to know Lisp, and you can run a web server on any platform, generate your HTML, CSS, JavaScript front-end interfaces, JSON or XML data feeds, and communicate with your clients over AJAX, Comet, REST, or Websockets.  Using a sensible front-end library, you can also ensure a graceful experience for all your users on every platform.  And never have to write a single line of any other language.</p>
+<hr>
+<p>Extend upon the material covered earlier for building simple web apps; cover the feature and security requirements of web applications, REST endpoints, websockets, etc.</p>
+<p>Review web frameworks in Lisp: Weblocks, RESTAS, Clack/Caveman, Anti-Web, REDSHIFTNET; refresher on underlying servers, Hunchentoot, Wookie, IOLib, teepeedee2, etc., database libraries, crane, postmodern, etc., and other web-related libraries, cl-who, cl-css, parenscript, etc.</p>
+<p>Web app should be a live-updating feed, pulling from some standard data source in JSON.</p>
+<p>Focus on 100% Lisp to generate/parse web languages.</p>
+<p>Also, include an exercise that shows how to set up a secure load-balanced cloud lisp web application.</p>
+<h3 id="exercise-311">Exercise 3.1.1</h3>
+<p><strong>Full Featured Web Apps</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-312">Exercise 3.1.2</h3>
+<p><strong>Clack and Caveman</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-313">Exercise 3.1.3</h3>
+<p><strong>Wookie</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-314">Exercise 3.1.4</h3>
+<p><strong>CL-ASYNC</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-315">Exercise 3.1.5</h3>
+<p><strong>IOLib</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-316">Exercise 3.1.6</h3>
+<p><strong>IOLib</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-317">Exercise 3.1.7</h3>
+<p><strong>Websockets</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-318">Exercise 3.1.8</h3>
+<p><strong>Databases and ORMs for the Web</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-319">Exercise 3.1.9</h3>
+<p><strong>Serializing Data to JSON</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-3110">Project 3.1.10</h3>
+<p><strong>An All-in-One Asynchronous Web Framework</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3111">Exercise 3.1.11</h3>
+<p><strong>Deploying a Secure, Distributed Lisp Web Application in the Cloud</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-00-00-overview.html" class="navigation navigation-prev " aria-label="Previous page: Lisp So(u)rcery">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-02-00-typesetting.html" class="navigation navigation-next " aria-label="Next page: Typesetting">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Real-world Web Apps","level":"5.1.1","depth":2,"next":{"title":"Typesetting","level":"5.1.2","depth":2,"path":"3-02-00-typesetting.md","ref":"./3-02-00-typesetting.md","articles":[]},"previous":{"title":"Lisp So(u)rcery","level":"5.1","depth":1,"path":"3-00-00-overview.md","ref":"3-00-00-overview.md","articles":[{"title":"Real-world Web Apps","level":"5.1.1","depth":2,"path":"3-01-00-web-apps.md","ref":"./3-01-00-web-apps.md","articles":[]},{"title":"Typesetting","level":"5.1.2","depth":2,"path":"3-02-00-typesetting.md","ref":"./3-02-00-typesetting.md","articles":[]},{"title":"Native Mobile Applications","level":"5.1.3","depth":2,"path":"3-03-00-mobile.md","ref":"./3-03-00-mobile.md","articles":[]},{"title":"Cross-platform Desktop Applications","level":"5.1.4","depth":2,"path":"3-04-00-gui.md","ref":"./3-04-00-gui.md","articles":[]},{"title":"Drivers, Daemons, and System-Utilities","level":"5.1.5","depth":2,"path":"3-05-00-system-utils.md","ref":"./3-05-00-system-utils.md","articles":[]},{"title":"Reverse Engineering","level":"5.1.6","depth":2,"path":"3-06-00-reverse-engineering.md","ref":"./3-06-00-reverse-engineering.md","articles":[]},{"title":"Graphics Rendering","level":"5.1.7","depth":2,"path":"3-07-00-graphics.md","ref":"./3-07-00-graphics.md","articles":[]},{"title":"OpenGL, SDL, and 3D Game Development","level":"5.1.8","depth":2,"path":"3-08-00-gaming.md","ref":"./3-08-00-gaming.md","articles":[]},{"title":"Audio Generation and Manipulation","level":"5.1.9","depth":2,"path":"3-09-00-audio.md","ref":"./3-09-00-audio.md","articles":[]},{"title":"Data Aggregation and Analysis","level":"5.1.10","depth":2,"path":"3-10-00-data.md","ref":"./3-10-00-data.md","articles":[]},{"title":"Cryptography and Security","level":"5.1.11","depth":2,"path":"3-11-00-cryptosec.md","ref":"./3-11-00-cryptosec.md","articles":[]},{"title":"Financial Software and Crypto-Currencies","level":"5.1.12","depth":2,"path":"3-12-00-fintech.md","ref":"./3-12-00-fintech.md","articles":[]},{"title":"Scientific Computing","level":"5.1.13","depth":2,"path":"3-13-00-scientific-computing.md","ref":"./3-13-00-scientific-computing.md","articles":[]},{"title":"Computational Physics","level":"5.1.14","depth":2,"path":"3-14-00-computational-physics.md","ref":"./3-14-00-computational-physics.md","articles":[]},{"title":"Quantum Computing","level":"5.1.15","depth":2,"path":"3-15-00-quantum-computing.md","ref":"./3-15-00-quantum-computing.md","articles":[]},{"title":"Natural Language Processing","level":"5.1.16","depth":2,"path":"3-16-00-nlp.md","ref":"./3-16-00-nlp.md","articles":[]},{"title":"Artificial Intelligence","level":"5.1.17","depth":2,"path":"3-17-00-ai.md","ref":"./3-17-00-ai.md","articles":[]},{"title":"Robotics","level":"5.1.18","depth":2,"path":"3-18-00-robotics.md","ref":"./3-18-00-robotics.md","articles":[]},{"title":"Space Tech","level":"5.1.19","depth":2,"path":"3-19-00-space-tech.md","ref":"./3-19-00-space-tech.md","articles":[]},{"title":"Neuroscience and Thought-Controlled Computing","level":"5.1.20","depth":2,"path":"3-20-00-neurotech.md","ref":"./3-20-00-neurotech.md","articles":[]},{"title":"A Simple LispOS","level":"5.1.21","depth":2,"path":"3-21-00-lispos.md","ref":"./3-21-00-lispos.md","articles":[]},{"title":"Build Your Own Lisp Machine","level":"5.1.22","depth":2,"path":"3-22-00-lisp-machine.md","ref":"./3-22-00-lisp-machine.md","articles":[]},{"title":"Government and Military Grade Systems","level":"5.1.23","depth":2,"path":"3-23-00-gov-mil.md","ref":"./3-23-00-gov-mil.md","articles":[]}]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-01-00-web-apps.md","mtime":"2022-08-23T00:01:55.632Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-02-00-typesetting.html b/clones/llthw.common-lisp.dev/3-02-00-typesetting.html
new file mode 100644
index 00000000..13cd57de
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-02-00-typesetting.html
@@ -0,0 +1,1929 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Typesetting · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-03-00-mobile.html" />
+    
+    
+    <link rel="prev" href="3-01-00-web-apps.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Typesetting</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-32">Chapter 3.2</h1>
+<h2 id="typesetting">Typesetting</h2>
+<blockquote>
+<p>&quot;You don&apos;t pay back, you pay forward.&quot;</p>
+<footer>Robert A. Heinlein, <em>as quoted by Jerry Pournelle in Starswarm</em></footer>
+
+</blockquote>
+<p>The Web and Plain Text aren&apos;t the only document formats you can target with Common Lisp.  You can generate code for any other programming language, including the TeX Typesetting System, it&apos;s variants and extensions LaTeX, ConTeXt, and XeTeX, such as with the CL-Docutils library; or you can typeset your documents as PDF natively from within Lisp using the CL-Typesetting and CL-PDF libraries.</p>
+<p>In this chapter we will explore single-source documents with multiple output formats; structured text formats; native CL-Typesetting syntax; book design; fonts &amp; typography; in-line graphics; typesetting math; self-publishing your documents and books; and collect everything together in a library that will let you focus entirely on your writing while simultaneously publishing professional documents to every platform and medium.</p>
+<h3 id="exercise-321">Exercise 3.2.1</h3>
+<p><strong>CL-Typesetting Syntax</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-322">Exercise 3.2.2</h3>
+<p><strong>Markdown vs. reStructuredText</strong></p>
+<p>(and thus, CL-Typesetting vs. CL-Docutils)</p>
+<p>Note: we will prefer CL-Typesetting integrated with 3bmd for a Lispier solution; but CL-Docutils is useful for outputting LaTeX.</p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-323">Exercise 3.2.3</h3>
+<p><strong>Integrating 3bmd with CL-Typesetting</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-324">Exercise 3.2.4</h3>
+<p><strong>Target Templates</strong></p>
+<p>Highlight unique considerations for:</p>
+<ul>
+<li>LaTeX</li>
+<li>PDF/Print</li>
+<li>Ebook</li>
+<li>Web</li>
+<li>Screen Readers</li>
+</ul>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-325">Exercise 3.2.5</h3>
+<p><strong>Book Design</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-326">Exercise 3.2.6</h3>
+<p><strong>Fonts &amp; Typography</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-327">Exercise 3.2.7</h3>
+<p><strong>Document Structure</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-328">Exercise 3.2.8</h3>
+<p><strong>White-space and Black-space</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-329">Exercise 3.2.9</h3>
+<p><strong>Headers, Footers, and Margins</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3210">Exercise 3.2.10</h3>
+<p><strong>Footnotes, Citations, Bibliographies</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3211">Exercise 3.2.11</h3>
+<p><strong>Contents and Indices</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3212">Exercise 3.2.12</h3>
+<p><strong>In-Line Graphics and Plots</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3213">Exercise 3.2.13</h3>
+<p><strong>Typesetting Mathematical Notation</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3214">Exercise 3.2.14</h3>
+<p><strong>Self-Publishing Services</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-3215">Project 3.2.15</h3>
+<p><strong>CL-BookKit: A Single-Source Publishing Library for Typesetting in Common Lisp</strong></p>
+<p>Output to:</p>
+<ul>
+<li>PDF/Print</li>
+<li>Ebook</li>
+<li>Web</li>
+<li>Plain-Text</li>
+</ul>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-01-00-web-apps.html" class="navigation navigation-prev " aria-label="Previous page: Real-world Web Apps">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-03-00-mobile.html" class="navigation navigation-next " aria-label="Next page: Native Mobile Applications">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Typesetting","level":"5.1.2","depth":2,"next":{"title":"Native Mobile Applications","level":"5.1.3","depth":2,"path":"3-03-00-mobile.md","ref":"./3-03-00-mobile.md","articles":[]},"previous":{"title":"Real-world Web Apps","level":"5.1.1","depth":2,"path":"3-01-00-web-apps.md","ref":"./3-01-00-web-apps.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-02-00-typesetting.md","mtime":"2022-08-23T00:01:55.632Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-03-00-mobile.html b/clones/llthw.common-lisp.dev/3-03-00-mobile.html
new file mode 100644
index 00000000..d58b81b1
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-03-00-mobile.html
@@ -0,0 +1,1860 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Native Mobile Applications · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-04-00-gui.html" />
+    
+    
+    <link rel="prev" href="3-02-00-typesetting.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Native Mobile Applications</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-33">Chapter 3.3</h1>
+<h2 id="native-mobile-applications">Native Mobile Applications</h2>
+<blockquote>
+<p>&quot;Progress doesn&apos;t come from early risers---progress is made by lazy men looking for easier ways to do things.&quot;</p>
+<footer>Robert A. Heinlein, <em>Time Enough For Love</em></footer>
+
+</blockquote>
+<p>Mobile devices are ubiquitous---there are nearly 7 Billion mobile devices in use around the world <a href="http://www.itu.int/en/ITU-D/Statistics/Documents/facts/ICTFactsFigures2014-e.pdf" target="_blank">according to the ITU</a>, which is almost as many people as there are on the planet; thus, the importance of developing native applications to target mobile devices cannot be overstated.</p>
+<p>But each mobile platform is bogged down by its own proprietary environment, toolchain, and methodology.  Maintaining separate codebases is expensive and time-consuming, and not feasible for many organizations---leaving many to develop cumbersome, neutered mobile web applications instead.  If only there was some way to target all platforms natively, with one code-base.  Oh wait, this is a book on Lisp, so <em>of course</em> there is!</p>
+<p>The most popular library for native mobile development in Common Lisp is <a href="https://wukix.com/mocl" target="_blank">MOCL</a>---it currently supports Android, iOS, and OS X native apps, and support for the Apple Watch is also expected soon. <a href="http://www.lispworks.com/news/news31.html" target="_blank">LispWorks</a> has also begun to offer support for Android, and has a demo app available <a href="https://play.google.com/store/apps/developer?id=LispWorks+Ltd&amp;hl=en" target="_blank">on Google Play</a>.  But there are also open-source alternatives: SBCL runs natively on Android and ARM processors, Clozure CL can target iOS, ECL compiles to C code which can run on either iOS or on Android with the NDK, and there is the new implementation of Common Lisp, Clasp, which targets LLVM to interoperate with C++.  In other words, you have choices.</p>
+<p>That being said, mobile development is primarily a commercial endeavour, so in this chapter we will emphasize the commercial solutions to native mobile Common Lisp development, with MOCL and LispWorks.</p>
+<p>TO-DO: Profile CLASP, ECL, SBCL, and CCL native app development.</p>
+<h3 id="exercise-331">Exercise 3.3.1</h3>
+<p><strong>Getting Started with MOCL</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-332">Exercise 3.3.2</h3>
+<p><strong>iOS Development with MOCL</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-333">Exercise 3.3.3</h3>
+<p><strong>Android Development with MOCL</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-334">Project 3.3.4</h3>
+<p><strong>Cross-Platform Mobile App, for iOS and Android</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-02-00-typesetting.html" class="navigation navigation-prev " aria-label="Previous page: Typesetting">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-04-00-gui.html" class="navigation navigation-next " aria-label="Next page: Cross-platform Desktop Applications">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Native Mobile Applications","level":"5.1.3","depth":2,"next":{"title":"Cross-platform Desktop Applications","level":"5.1.4","depth":2,"path":"3-04-00-gui.md","ref":"./3-04-00-gui.md","articles":[]},"previous":{"title":"Typesetting","level":"5.1.2","depth":2,"path":"3-02-00-typesetting.md","ref":"./3-02-00-typesetting.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-03-00-mobile.md","mtime":"2022-08-23T00:01:55.632Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-04-00-gui.html b/clones/llthw.common-lisp.dev/3-04-00-gui.html
new file mode 100644
index 00000000..b1f45746
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-04-00-gui.html
@@ -0,0 +1,1880 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Cross-platform Desktop Applications · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-05-00-system-utils.html" />
+    
+    
+    <link rel="prev" href="3-03-00-mobile.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Cross-platform Desktop Applications</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-34">Chapter 3.4</h1>
+<h2 id="cross-platform-desktop-applications">Cross-Platform Desktop Applications</h2>
+<blockquote>
+<p>&quot;A skillful Artist in shapes and appearances does no more than necessary to create His effect.&quot;</p>
+<footer>Robert A. Heinlein, <em>Job: A Comedy of Justice</em></footer>
+
+</blockquote>
+<p>Assuming your target user-base is not comprised entirely of Lisp Hackers, your users will normally not be interested in receiving a source-code distribution or a command-line utility; they will expect a nice, clean installation package, an attractive and iconographically-appropriate icon, and a graphical user interface that is both familiar and novel.  This means a few different things---first, that your application&apos;s UI <em>looks</em> like other applications; it <em>works</em> like other applications; it fits into the Operating System like all other applications; but it tells its own story to users, like the best applications.  GUI design is not just a matter of calling widgets to simplify a command-line interface with toggle buttons and text areas, after all---you have to consider the User Experience.</p>
+<p>Typically, on large commercial software projects, there will be a UX developer either on staff or contract; so you don&apos;t have to know the ins-and-outs of UX as a software developer---but it is useful to know the language of UX, and why UX is so important.  Then, you will be able to make the most of the GUI tools available in Common Lisp.</p>
+<p>In Common Lisp, there are a lot of choices to provide desktop graphical user interfaces; but GUI applications are still a lot of work, and need to be carefully designed to support cross-platform deployment.  Unfortunately, there is no one-size-fits-all solution to this problem, but there are options which make the task manageable.</p>
+<p>For commercial, cross-platform desktop applications, the cleanest, simplest solution is the CAPI library included in all versions of LispWorks.  For 90% of your GUI-application projects, you will need the features and workflow that LispWorks provides; for the rest, an open-source alternative might be preferable, even though they all fall short of the CAPI feature-set.  In order to distribute binaries of your desktop app, you will need the professional version of LispWorks or above for each platform you wish to target---but you can write and test your applications with the free personal edition.</p>
+<hr>
+<p>Discuss Smoke/QT bindings, LTK, McCLIM, SDL + Dormouse, LispWorks CAPI, etc.</p>
+<p>LTK for developing rapid cross-platform guis.</p>
+<p>Develop a cross-platform LTK app for OS X, Windows, and Linux, package it for each OS appropriately.</p>
+<p>Note: consider a wrapper around Atom-Shell, for writing rapid web technology based cross-platform applications.</p>
+<hr>
+<h3 id="exercise-341">Exercise 3.4.1</h3>
+<p><strong>QTools and CommonQT</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-342">Exercise 3.4.2</h3>
+<p><strong>McCLIM</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-343">Exercise 3.4.3</h3>
+<p><strong>SDL and Dormouse</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-344">Exercise 3.4.4</h3>
+<p><strong>LTK</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-345">Exercise 3.4.5</h3>
+<p><strong>LispWorks: CAPI</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-346">Exercise 3.4.6</h3>
+<p><strong>Atom-Shell: GUI Apps built on Web Technologies</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-347">Project 3.4.7</h3>
+<p><strong>A Cross-Platform Native GUI App</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-03-00-mobile.html" class="navigation navigation-prev " aria-label="Previous page: Native Mobile Applications">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-05-00-system-utils.html" class="navigation navigation-next " aria-label="Next page: Drivers, Daemons, and System-Utilities">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Cross-platform Desktop Applications","level":"5.1.4","depth":2,"next":{"title":"Drivers, Daemons, and System-Utilities","level":"5.1.5","depth":2,"path":"3-05-00-system-utils.md","ref":"./3-05-00-system-utils.md","articles":[]},"previous":{"title":"Native Mobile Applications","level":"5.1.3","depth":2,"path":"3-03-00-mobile.md","ref":"./3-03-00-mobile.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-04-00-gui.md","mtime":"2022-08-23T00:01:55.632Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-05-00-system-utils.html b/clones/llthw.common-lisp.dev/3-05-00-system-utils.html
new file mode 100644
index 00000000..67059650
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-05-00-system-utils.html
@@ -0,0 +1,1878 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Drivers, Daemons, and System-Utilities · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-06-00-reverse-engineering.html" />
+    
+    
+    <link rel="prev" href="3-04-00-gui.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Drivers, Daemons, and System-Utilities</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-35">Chapter 3.5</h1>
+<h2 id="drivers-daemons-and-system-utilities">Drivers, Daemons, and System-Utilities</h2>
+<blockquote>
+<p>&quot;Anyone who considers protocol unimportant has never dealt with a cat.&quot;</p>
+<footer>Robert A. Heinlein, <em>The Cat Who Walks Through Walls</em></footer>
+
+</blockquote>
+<p>Not every application you write actually needs a GUI.  There&apos;s a wide class of drivers, daemons, and system-utilities which make more sense to distribute as command-line utilities.  Generally, when designing an application, you ask yourself who or what the user is; if the intended user is a sysadmin, or another application, a daemon is a really useful type of system-utility that runs in the background and provides low-level interfaces to system-critical functionality.  Conversely, if your application only needs to do one thing at a time and exit, then a simple command-line utility will do.  Drivers are a bit different, as the intention behind them is to provide an API to hardware that the computer otherwise does not know how to use; they often don&apos;t need to run as their own process, and can be embedded in the applications that need them, or linked to through Lisp&apos;s FFI.</p>
+<p>Drivers, much like any other library, are aptly suited for distribution through Quicklisp, whereas your full applications (daemons, command-line utilities, gui, mobile, and web apps) are best distributed through traditional means.  Naturally, to write a driver you need to be intimately familiar with the low-level protocol for the hardware device---this means working directly with binary streams, byte-vectors, and sockets, to recreate the protocol specification for the device in question, and provide your users with a high-level API to the device that can be used in their Lisp applications.</p>
+<p>There are a number of libraries already available in Quicklisp to make the writing of drivers, daemons, and system-utilities much simpler; many of which have already been touched upon in previous chapters.  In the following exercises we will be taking a deeper look at CLON (the Command-Line Options Nuker), SB-DAEMON, Nibbles; how to implement low-level protocols using sockets and streams; and the design of useful command-line interfaces and APIs.</p>
+<h3 id="exercise-351">Exercise 3.5.1</h3>
+<p><strong>Nibbles</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-352">Exercise 3.5.2</h3>
+<p><strong>SB-DAEMON</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-353">Exercise 3.5.3</h3>
+<p><strong>CLON, Revisited</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-354">Exercise 3.5.4</h3>
+<p><strong>Useful Command-Line Interfaces</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-355">Exercise 3.5.5</h3>
+<p><strong>Low-Level Protocols</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-356">Project 3.5.6</h3>
+<p><strong>A Hardware Driver</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-357">Project 3.5.7</h3>
+<p><strong>A Daemonized Service</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-358">Project 3.5.8</h3>
+<p><strong>A Suite of Command-Line Utilities</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-04-00-gui.html" class="navigation navigation-prev " aria-label="Previous page: Cross-platform Desktop Applications">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-06-00-reverse-engineering.html" class="navigation navigation-next " aria-label="Next page: Reverse Engineering">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Drivers, Daemons, and System-Utilities","level":"5.1.5","depth":2,"next":{"title":"Reverse Engineering","level":"5.1.6","depth":2,"path":"3-06-00-reverse-engineering.md","ref":"./3-06-00-reverse-engineering.md","articles":[]},"previous":{"title":"Cross-platform Desktop Applications","level":"5.1.4","depth":2,"path":"3-04-00-gui.md","ref":"./3-04-00-gui.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-05-00-system-utils.md","mtime":"2022-08-23T00:01:55.636Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-06-00-reverse-engineering.html b/clones/llthw.common-lisp.dev/3-06-00-reverse-engineering.html
new file mode 100644
index 00000000..1be1a0f9
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-06-00-reverse-engineering.html
@@ -0,0 +1,1893 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Reverse Engineering · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-07-00-graphics.html" />
+    
+    
+    <link rel="prev" href="3-05-00-system-utils.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Reverse Engineering</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-36">Chapter 3.6</h1>
+<h2 id="reverse-engineering">Reverse Engineering</h2>
+<blockquote>
+<p>&quot;Aside from a cold appreciation of my own genius I felt that I was a modest man.&quot;</p>
+<footer>Robert A. Heinlein, <em>Double Star</em></footer>
+
+</blockquote>
+<p><strong>Disclaimer:</strong> <em>Reverse engineering commercially licensed software may subject you to criminal prosecution. The material in this chapter is presented for informational purposes only, to aid in the authorized porting of software to the Common Lisp language, and the recovery of lost source code by the owners of the software; its use for criminal activities, including but not limited to, intellectual property theft, and circumvention of software authorization and digital-rights management protocols, in violation of the license agreements of commercial software and other digital assets is strictly prohibited.</em></p>
+<p>Reverse Engineering is an art, more than a science---that being said, it is also a highly skilled area that requires a deep understanding of all aspects of computer science.  While this chapter will cover the essential techniques to reverse engineer software using the Common Lisp language, it does not attempt to teach the methodology or theory behind reverse engineering.  For a complete, general introduction to the subject, please see the Resources section for texts related to this area.</p>
+<p>In this chapter we will explore the structure of binary applications as output by various compilers, the features available across the most popular reverse engineering tools, and what Lisp offers that other tools don&apos;t.  We will then tackle the specific reverse engineering tasks to progressively migrate a closed-source application to Lisp by parsing <code>objdump</code> files, generating header files (for software compiled from C/C++), parsing common patterns in Assembly Language to create low-level Lisp code, and then wrapping up everything together to generate high-level Lisp code that can be used to maintain and compile a new version of the reverse engineered software.</p>
+<h3 id="exercise-361">Exercise 3.6.1</h3>
+<p><strong>OBJDUMP: Dumping Binaries as Assembly</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-362">Exercise 3.6.2</h3>
+<p><strong>Operating System Kernels</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-363">Exercise 3.6.3</h3>
+<p><strong>x86 Assembly</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-364">Exercise 3.6.4</h3>
+<p><strong>x86-64 Assembly</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-365">Exercise 3.6.5</h3>
+<p><strong>Stripped Binaries</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-366">Exercise 3.6.6</h3>
+<p><strong>(Re)Generating Header Files</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-367">Exercise 3.6.7</h3>
+<p><strong>Obfuscation and Deobfuscation</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-368">Exercise 3.6.8</h3>
+<p><strong>Finding Compiler Patterns</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-369">Exercise 3.6.9</h3>
+<p><strong>Transforming Assembly to Low-Level Lisp</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3610">Exercise 3.6.10</h3>
+<p><strong>High-Level Transformations</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-3611">Project 3.6.11</h3>
+<p><strong>A Reverse Engineering Toolkit</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-05-00-system-utils.html" class="navigation navigation-prev " aria-label="Previous page: Drivers, Daemons, and System-Utilities">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-07-00-graphics.html" class="navigation navigation-next " aria-label="Next page: Graphics Rendering">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Reverse Engineering","level":"5.1.6","depth":2,"next":{"title":"Graphics Rendering","level":"5.1.7","depth":2,"path":"3-07-00-graphics.md","ref":"./3-07-00-graphics.md","articles":[]},"previous":{"title":"Drivers, Daemons, and System-Utilities","level":"5.1.5","depth":2,"path":"3-05-00-system-utils.md","ref":"./3-05-00-system-utils.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-06-00-reverse-engineering.md","mtime":"2022-08-23T00:01:55.636Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-07-00-graphics.html b/clones/llthw.common-lisp.dev/3-07-00-graphics.html
new file mode 100644
index 00000000..d90f3c13
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-07-00-graphics.html
@@ -0,0 +1,1893 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Graphics Rendering · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-08-00-gaming.html" />
+    
+    
+    <link rel="prev" href="3-06-00-reverse-engineering.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Graphics Rendering</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-37">Chapter 3.7</h1>
+<h2 id="graphics-rendering">Graphics Rendering</h2>
+<blockquote>
+<p>&quot;If you happen to be one of the fretful minority who can do creative work, never force an idea... Be patient and you&apos;ll give birth to it when the time is ripe. Learn to wait.&quot;</p>
+<footer>Robert A. Heinlein, <em>Time Enough for Love</em></footer>
+
+</blockquote>
+<p>Graphics rendering and generation is a fairly popular topic in Lisp, and as such there are a number of libraries already available to assist the developer, from vector art to procedurally generated 3D worlds.  Naturally, there are also libraries available for manipulating bitmap image formats, and converting between vector and bitmap images, so that you can process your images in a number of ways, such as with photo filters.</p>
+<p>A natural extension to this topic is the visualization of data---you could simply plot your data on a graph, but sometimes you want something more dynamic and engaging.  Lisp is a very useful ally in this task.</p>
+<p>In this chapter we will explore various methods for generating both vector and bitmap image files; plotting complex data; and creating a simple paint application with a GUI.</p>
+<h3 id="exercise-371">Exercise 3.7.1</h3>
+<p><strong>Vector Graphics with VECTO</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-372">Exercise 3.7.2</h3>
+<p><strong>More VECTO</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-373">Exercise 3.7.3</h3>
+<p><strong>Even More VECTO</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-374">Exercise 3.7.4</h3>
+<p><strong>Raster Graphics with CL-PNG</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-375">Exercise 3.7.5</h3>
+<p><strong>More CL-PNG</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-376">Exercise 3.7.6</h3>
+<p><strong>Even More CL-PNG</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-377">Exercise 3.7.7</h3>
+<p><strong>Plotting Data with VECTO</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-378">Exercise 3.7.8</h3>
+<p><strong>Plotting Data with CL-PLplot</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-379">Exercise 3.7.9</h3>
+<p><strong>Plotting Data for the Web</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-3710">Project 3.7.10</h3>
+<p><strong>A Web-Based Data Plotting Service</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-3711">Project 3.7.11</h3>
+<p><strong>A Simple Paint Application with VECTO and Qtools</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-06-00-reverse-engineering.html" class="navigation navigation-prev " aria-label="Previous page: Reverse Engineering">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-08-00-gaming.html" class="navigation navigation-next " aria-label="Next page: OpenGL, SDL, and 3D Game Development">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Graphics Rendering","level":"5.1.7","depth":2,"next":{"title":"OpenGL, SDL, and 3D Game Development","level":"5.1.8","depth":2,"path":"3-08-00-gaming.md","ref":"./3-08-00-gaming.md","articles":[]},"previous":{"title":"Reverse Engineering","level":"5.1.6","depth":2,"path":"3-06-00-reverse-engineering.md","ref":"./3-06-00-reverse-engineering.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-07-00-graphics.md","mtime":"2022-08-23T00:01:55.636Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-08-00-gaming.html b/clones/llthw.common-lisp.dev/3-08-00-gaming.html
new file mode 100644
index 00000000..ede677e4
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-08-00-gaming.html
@@ -0,0 +1,1885 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>OpenGL, SDL, and 3D Game Development · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-09-00-audio.html" />
+    
+    
+    <link rel="prev" href="3-07-00-graphics.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >OpenGL, SDL, and 3D Game Development</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-38">Chapter 3.8</h1>
+<h2 id="opengl-sdl-and-3d-game-development">OpenGL, SDL, and 3D Game Development</h2>
+<blockquote>
+<p>&quot;For modern man one of the most troubling aspects of eternity lies in getting used to the slippery quality of time.&quot;</p>
+<footer>Robert A. Heinlein, <em>Job: A Comedy of Justice</em></footer>
+
+</blockquote>
+<p><strong>Revision Note:</strong> <em>Chapter 2.18 already includes an FFI library for the Oculus Rift, so this chapter can focus on integration into a Lisp game engine.</em></p>
+<p>Game development is a highly competitive industry; there are a lot of development platforms and technology-stacks available for the would-be game developer, and all of them have their own particular strengths and advantages.  If you want an out of the box solution, and are working with 3D artists to create your assets, you will get everything you need with popular frameworks such as the Unreal Engine, or Unity3D; but creating a commercial platformer is not the only reason developers get into game development.  Sometimes, you just want to create something for yourself and your friends---and you want the satisfaction of knowing you did it your own way.</p>
+<p>Game development in Lisp has many options, and offers the unique strength that you can program everything---even the graphics and audio.  You don&apos;t need to work with a team of asset creators and audio engineers, you can do everything yourself with pure Lisp code.  Naturally, game development on any platform is still a lot of work---but building a 3D platformer in 100% Lisp source code requires no more effort than a game built in Unity3D, and as a programmer, you may find the pure source code approach more intuitive.  That being said, Lisp doesn&apos;t stop you from working with a 3D artist to create your assets; you can adopt the approach that works best for you.</p>
+<p>To create the immersive worlds of today&apos;s platformer games, you will have to start thinking in terms of spatial geometry and perspective.  The goal is not to programmatically recreate the material world from the atomic level up---the goal is to create the <em>effect</em> of the material world with adequate simulations, using physics and animation to create your scenes.  Game development is very math-heavy, but if you paid close attention in the preceding material from Part Two of this book, you&apos;ll have all the tools you need.</p>
+<p>In this chapter, we will be modelling a basic 3+1n Spacetime, to get you thinking in terms of the environments you will be building for your games, and transforming objects within them over time; reviewing the available libraries in Quicklisp for 3D game development; and creating a couple simple games---first, programmatically with procedurally generated environments and assets, and second, using assets created with the open-source 3D artwork platform, Blender.  As an extra credit exercise, we will also be writing a bridge to the Oculus Rift VR headset, so that you can create fully immersive virtual reality games.</p>
+<h3 id="exercise-381">Exercise 3.8.1</h3>
+<p><strong>Blackthorn 3D: OpenGL, SDL and Lisp</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-382">Exercise 3.8.2</h3>
+<p><strong>More Blackthorn 3D</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-383">Exercise 3.8.3</h3>
+<p><strong>Even More Blackthorn 3D</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-384">Exercise 3.8.4</h3>
+<p><strong>Physics Modelling in Lisp</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-385">Exercise 3.8.5</h3>
+<p><strong>Importing 3D Assets</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-386">Exercise 3.8.6</h3>
+<p><strong>Procedurally Generated 3D Environments</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-387">Exercise 3.8.7</h3>
+<p><strong>More Procedural Generation</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-388">Exercise 3.8.8</h3>
+<p><strong>Integrating Oculus Rift</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-389">Project 3.8.9</h3>
+<p><strong>Build a 3D Platform Game</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-07-00-graphics.html" class="navigation navigation-prev " aria-label="Previous page: Graphics Rendering">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-09-00-audio.html" class="navigation navigation-next " aria-label="Next page: Audio Generation and Manipulation">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"OpenGL, SDL, and 3D Game Development","level":"5.1.8","depth":2,"next":{"title":"Audio Generation and Manipulation","level":"5.1.9","depth":2,"path":"3-09-00-audio.md","ref":"./3-09-00-audio.md","articles":[]},"previous":{"title":"Graphics Rendering","level":"5.1.7","depth":2,"path":"3-07-00-graphics.md","ref":"./3-07-00-graphics.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-08-00-gaming.md","mtime":"2022-08-23T00:01:55.636Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-09-00-audio.html b/clones/llthw.common-lisp.dev/3-09-00-audio.html
new file mode 100644
index 00000000..4f5064f1
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-09-00-audio.html
@@ -0,0 +1,1889 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Audio Generation and Manipulation · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-10-00-data.html" />
+    
+    
+    <link rel="prev" href="3-08-00-gaming.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Audio Generation and Manipulation</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-39">Chapter 3.9</h1>
+<h2 id="audio-generation-and-manipulation">Audio Generation and Manipulation</h2>
+<blockquote>
+<p>&quot;You&apos;re not listening.&quot;<br>
+&quot;What were you doing talking,&quot; she answered reasonably, &quot;when I wasn&apos;t listening?&quot;</p>
+<footer>Robert A. Heinlein, <em>Have Space Suit---Will Travel</em></footer>
+
+</blockquote>
+<p>There is something strangely satisfying about creating music---and it doesn&apos;t much matter whether anyone else wants to hear it, because the real point of it is to express yourself, without filters, without judgement, without fear.  Now, there are a lot of ways to make music---you can pick up an instrument, bang your fingers on your desk the the rhythm of your heart, or hum a private tune to yourself; it doesn&apos;t much matter, because at the end of the day it&apos;s all about how you best express yourself.  Obviously, if you&apos;ve made it this far in the book, you&apos;re now a programmer; so what better way to express yourself than through the language that you have poured your blood, sweat, and tears into learning?</p>
+<p>There are a lot of solutions available in the Lisp world for working with audio; you can handle MIDI to control your hardware or software synthesizers, modify WAV files, even live-hack in Common Lisp to create music on the fly with custom instruments and audio samples.  There are no limits---it&apos;s just you and your computer, making noise with code; and as it turns out, it is one <em>powerful</em> medium.</p>
+<p>In this chapter, we will explore the variety of audio generation and manipulation libraries available for Lisp, with a particular emphasis on CL-Collider for algorithmic audio generation and live hacking.  If you have not set up Emacs Live yet, now will be a good time to do so, as it was specifically designed with live hacking in mind.  We will also revisit our 3D platformer game from the previous chapter, to embed a soundtrack and custom sound-effects, all generated with Lisp source code.</p>
+<h3 id="exercise-391">Exercise 3.9.1</h3>
+<p><strong>CL-Collider and SuperCollider</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-392">Exercise 3.9.2</h3>
+<p><strong>Notes and Chords</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-393">Exercise 3.9.3</h3>
+<p><strong>Instruments</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-394">Exercise 3.9.4</h3>
+<p><strong>Filters</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-395">Exercise 3.9.5</h3>
+<p><strong>Controlling MIDI Devices</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-396">Exercise 3.9.6</h3>
+<p><strong>MIDI Input</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-397">Exercise 3.9.7</h3>
+<p><strong>Bouncing Audio to Disk</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-398">Exercise 3.9.8</h3>
+<p><strong>Mixing and Mastering Audio</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-399">Exercise 3.9.9</h3>
+<p><strong>Live Hacking CL-Collider in Emacs Live</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-3910">Project 3.9.10</h3>
+<p><strong>Extending your 3D Game Engine with programmatic audio</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-08-00-gaming.html" class="navigation navigation-prev " aria-label="Previous page: OpenGL, SDL, and 3D Game Development">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-10-00-data.html" class="navigation navigation-next " aria-label="Next page: Data Aggregation and Analysis">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Audio Generation and Manipulation","level":"5.1.9","depth":2,"next":{"title":"Data Aggregation and Analysis","level":"5.1.10","depth":2,"path":"3-10-00-data.md","ref":"./3-10-00-data.md","articles":[]},"previous":{"title":"OpenGL, SDL, and 3D Game Development","level":"5.1.8","depth":2,"path":"3-08-00-gaming.md","ref":"./3-08-00-gaming.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-09-00-audio.md","mtime":"2022-08-23T00:01:55.636Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-10-00-data.html b/clones/llthw.common-lisp.dev/3-10-00-data.html
new file mode 100644
index 00000000..32f05eb5
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-10-00-data.html
@@ -0,0 +1,1874 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Data Aggregation and Analysis · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-11-00-cryptosec.html" />
+    
+    
+    <link rel="prev" href="3-09-00-audio.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Data Aggregation and Analysis</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-310">Chapter 3.10</h1>
+<h2 id="data-aggregation-and-analysis">Data Aggregation and Analysis</h2>
+<blockquote>
+<p>&quot;Mass psychology is not simply a summation of individual psychologies; that is a prime theorem of social psychodynamics---not just my opinion; no exception has ever been found to this theorem.&quot;</p>
+<footer>Robert A. Heinlein, <em>Methuselah&apos;s Children</em></footer>
+
+</blockquote>
+<p>These days, you hear the buzz-word &quot;Big Data&quot; being thrown around everywhere, as if it&apos;s something new and exciting.  It isn&apos;t, really; it is just the natural extension of data aggregation and analysis techniques that have existed for decades, applied to the surprising amount of personal information that is shared with the world on the internet through social media, blogging platforms, and community platforms.  Now, what can be <em>inferred</em> from this amount of data is what the buzz is really all about---and where a lot of companies are making all their money.</p>
+<p>At its core, Big Data is simple.  It starts with simple techniques for parsing the data available on the internet, from HTML, XML, JSON, and so forth; using concepts from the semantic web, it allows developers to infer more meaning about this data than would otherwise be possible; and then it aggregates large volumes of this data so that global trends and individual preferences can be exploited for profit.  And using techniques from artificial intelligence for designing knowledge-based systems, this simple set of techniques can be transformed into a multi-billion dollar enterprise.</p>
+<p>These types of tasks are Lisp&apos;s core strength.  Symbolic computation is aptly suited for representing knowledge-based systems and artificial intelligence problems, and can give new-comers to the business of Big Data a significant edge against their monolithic, corporate competitors.</p>
+<p>In this chapter we will look at the challenges of scraping websites, xml and json feeds; parsing the data intelligently; storing and indexing large quantities of data; analyzing and graphing such data in meaningful ways; and writing AI agents that can automate this process for you.  We will also look at considerations of privacy, and your responsibility in handling, using, and protecting personal information appropriately.</p>
+<h3 id="exercise-3101">Exercise 3.10.1</h3>
+<p><strong>Lisp-Based HTTP Clients</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3102">Exercise 3.10.2</h3>
+<p><strong>Scraping the Web</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3103">Exercise 3.10.3</h3>
+<p><strong>Parsing XML and HTML</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3104">Exercise 3.10.4</h3>
+<p><strong>Parsing JSON</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3105">Exercise 3.10.5</h3>
+<p><strong>Data Aggregation</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3106">Exercise 3.10.6</h3>
+<p><strong>Targeted Data Mining</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-3107">Project 3.10.7</h3>
+<p><strong>An Extensible Knowledge Engine</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-09-00-audio.html" class="navigation navigation-prev " aria-label="Previous page: Audio Generation and Manipulation">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-11-00-cryptosec.html" class="navigation navigation-next " aria-label="Next page: Cryptography and Security">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Data Aggregation and Analysis","level":"5.1.10","depth":2,"next":{"title":"Cryptography and Security","level":"5.1.11","depth":2,"path":"3-11-00-cryptosec.md","ref":"./3-11-00-cryptosec.md","articles":[]},"previous":{"title":"Audio Generation and Manipulation","level":"5.1.9","depth":2,"path":"3-09-00-audio.md","ref":"./3-09-00-audio.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-10-00-data.md","mtime":"2022-08-23T00:01:55.636Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-11-00-cryptosec.html b/clones/llthw.common-lisp.dev/3-11-00-cryptosec.html
new file mode 100644
index 00000000..3e31cac1
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-11-00-cryptosec.html
@@ -0,0 +1,1884 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Cryptography and Security · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-12-00-fintech.html" />
+    
+    
+    <link rel="prev" href="3-10-00-data.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Cryptography and Security</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-311">Chapter 3.11</h1>
+<h2 id="cryptography-and-security">Cryptography and Security</h2>
+<blockquote>
+<p>&quot;An armed society is a polite society.&quot;</p>
+<footer>Robert A. Heinlein, <em>Beyond This Horizon</em></footer>
+
+</blockquote>
+<p><strong>Revision Note:</strong> <em>Update chapter intro text to support more in-depth cryptography discussion.</em></p>
+<p>The tools available in the ANSI Common Lisp standard for handling binary data and advanced mathematics, among other more-or-less hidden features of Common Lisp compilers, make it an ideal environment for implementing robust cryptographic utilities and secure software.  Naturally, cryptography is a highly specialized subject, and requires deep exploration to grok fully. No general purpose programming language is a magic bullet that allows a layperson to write cryptographic software without extensive training; but <em>if</em> you are interested in cryptographic security as a specialization, this chapter will---hopefully---at least point you in the right direction.</p>
+<p>In this chapter we will review again the mathematics of cryptography, alongside the theory that makes it work and the code we have already written; we will take a deeper exploration of random and pseudo-random number generation; write a one-time pad cipher using CL-ISAAC, suitable for gaming; explore the use-cases of all the tools available to a developer using the Ironclad library; and try our hand at extending Ironclad to support more advanced cryptographic protocols.</p>
+<p>For a list of further readings on cryptography, please consult the Resources section of this site.</p>
+<h3 id="exercise-3111">Exercise 3.11.1</h3>
+<p><strong>The Math of Modern Cryptography</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3112">Exercise 3.11.2</h3>
+<p><strong>Post-Quantum Cryptography</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3113">Exercise 3.11.3</h3>
+<p><strong>Cryptographically Strong (Pseudo)-Random Number Generators</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3114">Exercise 3.11.4</h3>
+<p><strong>A One-Time Pad using CL-ISAAC</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3115">Exercise 3.11.5</h3>
+<p><strong>Ironclad: Authentication</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3116">Exercise 3.11.6</h3>
+<p><strong>Ironclad: Hashing</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3117">Exercise 3.11.7</h3>
+<p><strong>Ironclad: Encryption</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3118">Exercise 3.11.8</h3>
+<p><strong>Secure Coding Principles</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-3119">Project 3.11.9</h3>
+<p><strong>Extending Ironclad: Elliptical Curve Cryptography</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-10-00-data.html" class="navigation navigation-prev " aria-label="Previous page: Data Aggregation and Analysis">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-12-00-fintech.html" class="navigation navigation-next " aria-label="Next page: Financial Software and Crypto-Currencies">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Cryptography and Security","level":"5.1.11","depth":2,"next":{"title":"Financial Software and Crypto-Currencies","level":"5.1.12","depth":2,"path":"3-12-00-fintech.md","ref":"./3-12-00-fintech.md","articles":[]},"previous":{"title":"Data Aggregation and Analysis","level":"5.1.10","depth":2,"path":"3-10-00-data.md","ref":"./3-10-00-data.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-11-00-cryptosec.md","mtime":"2022-08-23T00:01:55.636Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-12-00-fintech.html b/clones/llthw.common-lisp.dev/3-12-00-fintech.html
new file mode 100644
index 00000000..68c9386d
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-12-00-fintech.html
@@ -0,0 +1,1913 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Financial Software and Crypto-Currencies · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-13-00-scientific-computing.html" />
+    
+    
+    <link rel="prev" href="3-11-00-cryptosec.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Financial Software and Crypto-Currencies</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-312">Chapter 3.12</h1>
+<h2 id="financial-software-and-crypto-currencies">Financial Software and Crypto-Currencies</h2>
+<blockquote>
+<p>&quot;&apos;Value&apos; has no meaning other than in relationship to living beings... This very personal relationship, &apos;value&apos;, has two factors... first, what he can do with a thing, its use to him... and second, what he must do to get it, its <em>cost</em> to him.&quot;</p>
+<footer>Robert A. Heinlein, <em>Starship Troopers</em></footer>
+
+</blockquote>
+<p>Out of all the commercial ventures available to a budding entrepreneur, the most dangerous undertaking is handling other people&apos;s money.  Not just for the obvious reasons, such as becoming a target for theft, exploitation, and blackmail---but the liability alone, the stifling regulatory systems, and compliance requirements make the financial industry a deeply uncomfortable place for newcomers.  With this in mind, you can wonder at the audacity of the Bitcoin and crypto-currency community, that has spearheaded a new digital economy without taking such factors into consideration; and then realize why so many Bitcoin companies are failing.  The biggest problem may be self-evident to certain people, but is not often discussed amongst members of commercial crypto-currency start-ups---Bitcoin was specifically designed to sabotage the financial industry through total decentralization, not to be used as a tool to build banks and other money service businesses for cheap.  With that point in mind, this chapter will adopt the attitude of personal, decentralized banking, where you take the control and security of <em>your</em> money into your own hands---however, many of the necessary skills needed to design a personal Bitcoin wallet are transferable to the financial industry as a whole.  And, as it so happens, Common Lisp is often used in financial industry software, so if this is your area of interest, you&apos;ll have no trouble fitting in.</p>
+<p>Naturally, security is of utmost concern; so if you have not already read it, worked through the exercises, and done the extra readings from the Resources section, you should go back and read Chapter 3.10 -- Cryptography and Security first.  In any banking system, the only factor more important than compliance with your local financial regulatory body is the security of that system.  Other factors that you will have to consider, even for a personal wallet, are accounting ledgers, transaction histories, and encrypting your wallet.  Money service businesses also have to maintain strict Know-Your-Customer and Anti-Money-Laundering policies.</p>
+<p>So in this chapter, we&apos;ll take an overview of the strongest encryption protocols available in Common Lisp, design a personal wallet that utilizes Bitcoin to store and transfer value, interface with the Bitcoin blockchain from Common Lisp, and review some of the more interesting Bitcoin Improvement Proposals (BIPs) to add valuable features to your personal wallet.  We will also point you to some important resources for learning how to do a basic security profile of your application, to harden your wallet against potential loss through theft or other malicious activity.</p>
+<h3 id="exercise-3121">Exercise 3.12.1</h3>
+<p><strong>Working with Crypto-Currencies in Common Lisp</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3122">Exercise 3.12.2</h3>
+<p><strong>JSON-RPC Interfaces</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3123">Exercise 3.12.3</h3>
+<p><strong>ECDSA, SHA256, and Ripemd160</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3124">Exercise 3.12.4</h3>
+<p><strong>Base-58 and Base-64 Representations</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3125">Exercise 3.12.5</h3>
+<p><strong>Transactions</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3126">Exercise 3.12.6</h3>
+<p><strong>Addresses</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3127">Exercise 3.12.7</h3>
+<p><strong>Op-Codes</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3128">Exercise 3.12.8</h3>
+<p><strong>Scripts</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3129">Exercise 3.12.9</h3>
+<p><strong>Unspent-Outs</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-31210">Exercise 3.12.10</h3>
+<p><strong>Wallets</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-31211">Exercise 3.12.11</h3>
+<p><strong>Writing an Encrypted Wallet</strong></p>
+<p>Two methods:</p>
+<ul>
+<li>Encrypt database fields individually</li>
+<li>Encrypt Wallet Instance Object</li>
+</ul>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-31212">Exercise 3.12.12</h3>
+<p><strong>Providing a RESTful API to the Blockchain</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-31213">Exercise 3.12.13</h3>
+<p><strong>Hierarchical--Deterministic Keychains</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-31214">Project 3.12.14</h3>
+<p><strong>A Personal Bitcoin Wallet Web-App</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-11-00-cryptosec.html" class="navigation navigation-prev " aria-label="Previous page: Cryptography and Security">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-13-00-scientific-computing.html" class="navigation navigation-next " aria-label="Next page: Scientific Computing">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Financial Software and Crypto-Currencies","level":"5.1.12","depth":2,"next":{"title":"Scientific Computing","level":"5.1.13","depth":2,"path":"3-13-00-scientific-computing.md","ref":"./3-13-00-scientific-computing.md","articles":[]},"previous":{"title":"Cryptography and Security","level":"5.1.11","depth":2,"path":"3-11-00-cryptosec.md","ref":"./3-11-00-cryptosec.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-12-00-fintech.md","mtime":"2022-08-23T00:01:55.636Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-13-00-scientific-computing.html b/clones/llthw.common-lisp.dev/3-13-00-scientific-computing.html
new file mode 100644
index 00000000..17a8810c
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-13-00-scientific-computing.html
@@ -0,0 +1,1878 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Scientific Computing · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-14-00-computational-physics.html" />
+    
+    
+    <link rel="prev" href="3-12-00-fintech.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Scientific Computing</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-313">Chapter 3.13</h1>
+<h2 id="scientific-computing">Scientific Computing</h2>
+<blockquote>
+<p>&quot;In this complex world, science, the scientific method, and the consequences of the scientific method are central to everything the human race is doing and to wherever we are going.&quot;</p>
+<footer>Robert A. Heinlein, <em>The Pragmatics of Patriotism</em></footer>
+
+</blockquote>
+<p>Scientific computing, also known as Computational Science, is now considered a third mode of science in addition to the traditional two modes of observation/experimentation and theory, and is thus an essential basic skill for researchers of every scientific field.  Typically, computational scientists favour R, Mathematica, MATLAB, Python&apos;s SciPy and PDL libraries, C, or Fortran to implement highly optimized numerical simulations; but Common Lisp has significant advantages over all these technologies for implementing robust, optimized, distributed algorithms for modelling scientific problems, running simulations, and further optimizing scenarios.</p>
+<p>At the most basic level, computational science requires featureful and fast algebra and plotting libraries; but advanced use-cases and computationally expensive simulations require massive concurrency, and resource intensive floating-point calculations.  Using LParallel, CL-GPU, GSLL, CL-PLPlot, and the optimization techniques you&apos;ve already learned, you can beat the performance of other platforms and technologies, and take advantage of all of Common Lisp&apos;s other intrinsic features, such as interactive programming at the REPL, for rapid prototyping of solutions to many of the most important problems in computational science.</p>
+<p>In this chapter we will review the Lisp syntax of the math necessary to model problems in computational science, translate a selection of problems in computational science from pseudo-code to Common Lisp, work heavily from the REPL to model systems interactively in real-time, graph and plot our results, and run exhaustive tests and benchmarks against other platforms as part of the optimization process, to prove to yourself and others that Common Lisp is the ideal platform for Scientific Computing.</p>
+<h3 id="exercise-3131">Exercise 3.13.1</h3>
+<p><strong>The Math of Scientific Computing</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3132">Exercise 3.13.2</h3>
+<p><strong>GSLL</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3133">Exercise 3.13.3</h3>
+<p><strong>Leveraging Massive Concurrency</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3134">Exercise 3.13.4</h3>
+<p><strong>Floating-Point Calculations using CL-GPU</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3135">Exercise 3.13.5</h3>
+<p><strong>Plotting Your Results</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3136">Exercise 3.13.6</h3>
+<p><strong>Performance Testing and Optimization</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3137">Exercise 3.13.7</h3>
+<p><strong>Proofing Results</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-3138">Project 3.13.8</h3>
+<p><strong>A Scientific Computing Application</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-12-00-fintech.html" class="navigation navigation-prev " aria-label="Previous page: Financial Software and Crypto-Currencies">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-14-00-computational-physics.html" class="navigation navigation-next " aria-label="Next page: Computational Physics">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Scientific Computing","level":"5.1.13","depth":2,"next":{"title":"Computational Physics","level":"5.1.14","depth":2,"path":"3-14-00-computational-physics.md","ref":"./3-14-00-computational-physics.md","articles":[]},"previous":{"title":"Financial Software and Crypto-Currencies","level":"5.1.12","depth":2,"path":"3-12-00-fintech.md","ref":"./3-12-00-fintech.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-13-00-scientific-computing.md","mtime":"2022-08-23T00:01:55.636Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-14-00-computational-physics.html b/clones/llthw.common-lisp.dev/3-14-00-computational-physics.html
new file mode 100644
index 00000000..1b047147
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-14-00-computational-physics.html
@@ -0,0 +1,1889 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Computational Physics · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-15-00-quantum-computing.html" />
+    
+    
+    <link rel="prev" href="3-13-00-scientific-computing.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Computational Physics</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-314">Chapter 3.14</h1>
+<h2 id="computational-physics">Computational Physics</h2>
+<blockquote>
+<p>&quot;Behind every mystery lies another mystery. Infinite recession. But you don&apos;t need to know final answers---if there be such---and neither do I.&quot;</p>
+<footer>Robert A. Heinlein, <em>Job: A Comedy of Justice</em></footer>
+
+</blockquote>
+<p>While Computational Science is generally useful for all scientific disciplines, as it allows scientists to refine and improve established theories and models to better match the observed data, computational science is of <em>fundamental importance</em> to Physicists, as it allows them to model underlying systems <em>which cannot yet be observed</em>; thus, the highly specialized branch of computational science dealing primarily with theoretical physics has its own name, Computational Physics, and is often treated as its own field---though obviously it inherits most of its techniques and tools from its parent.</p>
+<p>As a third modality of science, the results of computational simulations of these underlying physical systems can be used in lieu of observation and experiment to aid in the validation of various theories; and naturally, to aid in the modelling of experiments so that the more exotic phenomenon in theoretical physics can be observed, if the theories correctly predict the behaviour and nature of these systems.</p>
+<p>While modelling problems in M-Theory, Quantum Field Theory, or other novel approaches at harmonizing General Relativity with Quantum Mechanics are far beyond the scope of this book, it will be interesting to model some of the more approachable problems in physics and astrophysics to create 3D simulations using OpenGL; and write a general physics engine that is lightweight enough to be used anywhere, but accurate enough to simulate all the common physics problems that a student might face in an undergraduate Physics program.</p>
+<p>In this chapter, we will revisit the methodology from Chapters 3.12 on Scientific Computing, and 3.7 on 3D Game Development, to progressively build 3D OpenGL simulations of n-body problems, gravitational fields, relativistic systems that warp spacetime, and models of sub-atomic particle physics; and as a final exercise, we will explore Newtonian Mechanics as an emergent system of Quantum Mechanics.</p>
+<h3 id="exercise-3141">Exercise 3.14.1</h3>
+<p><strong>Common Problems in Computational Physics</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3142">Exercise 3.14.2</h3>
+<p><strong>The Ising Model</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3143">Exercise 3.14.3</h3>
+<p><strong>Simulating Physics with OpenGL</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3144">Exercise 3.14.4</h3>
+<p><strong>An n-body Problem</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3145">Exercise 3.14.5</h3>
+<p><strong>Gravitational Fields</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3146">Exercise 3.14.6</h3>
+<p><strong>Relativistic Velocities</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3147">Exercise 3.14.7</h3>
+<p><strong>Visualizing a Warped Space-Time</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3148">Exercise 3.14.8</h3>
+<p><strong>Modelling the sub-atomic world</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3149">Exercise 3.14.9</h3>
+<p><strong>Newtonian Mechanics as Emergent from Quantum Mechanics</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-31410">Project 3.14.10</h3>
+<p><strong>Extending the Computational Science Application for Physics Simulation</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-13-00-scientific-computing.html" class="navigation navigation-prev " aria-label="Previous page: Scientific Computing">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-15-00-quantum-computing.html" class="navigation navigation-next " aria-label="Next page: Quantum Computing">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Computational Physics","level":"5.1.14","depth":2,"next":{"title":"Quantum Computing","level":"5.1.15","depth":2,"path":"3-15-00-quantum-computing.md","ref":"./3-15-00-quantum-computing.md","articles":[]},"previous":{"title":"Scientific Computing","level":"5.1.13","depth":2,"path":"3-13-00-scientific-computing.md","ref":"./3-13-00-scientific-computing.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-14-00-computational-physics.md","mtime":"2022-08-23T00:01:55.636Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-15-00-quantum-computing.html b/clones/llthw.common-lisp.dev/3-15-00-quantum-computing.html
new file mode 100644
index 00000000..c50e7592
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-15-00-quantum-computing.html
@@ -0,0 +1,1918 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Quantum Computing · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-16-00-nlp.html" />
+    
+    
+    <link rel="prev" href="3-14-00-computational-physics.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Quantum Computing</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-315">Chapter 3.15</h1>
+<h2 id="quantum-computing">Quantum Computing</h2>
+<blockquote>
+<p>&quot;Who taught me that the world is not only stranger than we imagine but stranger than we <em>can</em> imagine? Who has already taken me into two universes that are <em>not</em> this one... and brought me safely home?&quot;</p>
+<footer>Robert A. Heinlein, <em>The Number of the Beast</em></footer>
+
+</blockquote>
+<p>Quantum Computing is built on functional programming.  Since the release of Selinger&apos;s seminal paper on the Quantum Lambda Calculus in 2007, the progress within the field shifted suddenly from puttering along like the earliest steam-engines, to a rocket blasting off into space; and along with it, the <em>circuit</em> model of quantum computation, that reformulates the gate model in terms of the actual quantum circuits that would be needed to build these gates, has allowed for concise expression and simulation of quantum hardware in a classical computer program.</p>
+<p>Meanwhile, a team in Vancouver was working on another model of quantum computation, that utilized quantum annealing on a chimera graph of superconducting flux qubits to solve <em>energy problems</em>; this work resulted in the first commercial adiabatic quantum computer, the D-Wave One, purpose-built for solving computationally expensive optimization problems efficiently. And its operating system was written entirely in Common Lisp, compiled with SBCL.  We are now on the eve of the release of the D-Wave Three, built on the Washington adiabatic processor---giving quantum hackers a full 2,048 physical qubits to play with.  With recent announcements from Google, and a handfull of VC-funded startups all announcing their upcoming quantum hardware, it is an exciting time in quantum computing---particularly for Lisp Hackers.</p>
+<p>Naturally, there are limitations to what can be simulated on a classical computer; on a quad-core processor with hyperthreading, the most you can simulate in realtime is a 4-qubit system---anything more than this has to be time-lagged to compensate for the inherent limitations of classical computing.  As the number of qubits grows, the number of simultaneous operations computable in a quantum system grows exponentially---and very quickly you get to a hard wall, where a quantum algorithm is no longer computable on classical hardware within the estimated lifespan of the universe.  This problem can be mitigated by simply adding more classical cores, such as is done when building supercomputer labs, but this is extremely inefficient and expensive. When running quantum algorithms, you need to be able to exploit the quantum phenomena directly, to get meaningful and timely results.</p>
+<p>That being said, time on D-Wave hardware is not exactly available to the general public; and the institutions which have made time available on the D-Wave One and Two to researchers and specialists are completely booked up.  At present, the average Lisp Hacker with an interest in quantum computer programming has no means to test any quantum algorithms they may write---and this is a problem.  Quantum Computing is the future of computing as a whole, so it needs to be accessible to everyone with an interest in it.</p>
+<p>With that aim in mind, in this chapter we will review the basic theory of quantum computing, including important phenomena such as superposition of states, entanglement, teleportation, and various models of quantum computing such as the Gate Model, the Circuit Model, the Adiabatic Model, and Quantum Turing Machines; the programming paradigms needed and used, such as quantum energy programming and the quantum lambda calculus; and write basic simulators in Common Lisp for the different models of quantum computers that are either being built or already commercially available, forcefully time-lagged to simulate superpositioning, and time-limited to the maximum number of qubits that can be handled by your system within a customizeable unit of classical computer time in seconds.</p>
+<p>Additional material for specialization in Quantum Computer Science will be listed under the Resources section of this site.</p>
+<h3 id="exercise-3151">Exercise 3.15.1</h3>
+<p><strong>The Qubit</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3152">Exercise 3.15.2</h3>
+<p><strong>State Preparation</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3153">Exercise 3.15.3</h3>
+<p><strong>Measurement</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3154">Exercise 3.15.4</h3>
+<p><strong>Probability and Superposition</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3155">Exercise 3.15.5</h3>
+<p><strong>Entanglement</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3156">Exercise 3.15.6</h3>
+<p><strong>Quantum Registers</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3157">Exercise 3.15.7</h3>
+<p><strong>Quantum Gates</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3158">Exercise 3.15.8</h3>
+<p><strong>The Hadamard Gate</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3159">Exercise 3.15.9</h3>
+<p><strong>The CNOT Gate</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-31510">Exercise 3.15.10</h3>
+<p><strong>Single-Qubit T-Gates</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-31511">Exercise 3.15.11</h3>
+<p><strong>Additional Quantum Gates</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-31512">Exercise 3.15.12</h3>
+<p><strong>Quantum Memory</strong></p>
+<p>Storing Unmeasured Quantum States</p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-31513">Exercise 3.15.13</h3>
+<p><strong>Universal Quantum Computers</strong></p>
+<p>Quantum Turing Completeness</p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-31514">Exercise 3.15.14</h3>
+<p><strong>Outputting Circuit Diagrams with LaTeX</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-31515">Project 3.15.15</h3>
+<p><strong>A Quantum Computer Simulator</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-14-00-computational-physics.html" class="navigation navigation-prev " aria-label="Previous page: Computational Physics">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-16-00-nlp.html" class="navigation navigation-next " aria-label="Next page: Natural Language Processing">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Quantum Computing","level":"5.1.15","depth":2,"next":{"title":"Natural Language Processing","level":"5.1.16","depth":2,"path":"3-16-00-nlp.md","ref":"./3-16-00-nlp.md","articles":[]},"previous":{"title":"Computational Physics","level":"5.1.14","depth":2,"path":"3-14-00-computational-physics.md","ref":"./3-14-00-computational-physics.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-15-00-quantum-computing.md","mtime":"2022-08-23T00:01:55.636Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-16-00-nlp.html b/clones/llthw.common-lisp.dev/3-16-00-nlp.html
new file mode 100644
index 00000000..8ce03592
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-16-00-nlp.html
@@ -0,0 +1,1882 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Natural Language Processing · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-17-00-ai.html" />
+    
+    
+    <link rel="prev" href="3-15-00-quantum-computing.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Natural Language Processing</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-316">Chapter 3.16</h1>
+<h2 id="natural-language-processing">Natural Language Processing</h2>
+<blockquote>
+<p>&quot;Language itself shapes a man&apos;s basic ideas.&quot;</p>
+<footer>Robert A. Heinlein, <em>Stranger in a Strange Land</em></footer>
+
+</blockquote>
+<p>Creating a programming language and writing a compiler for it is one thing; analyzing human speech is quite another.  Computer languages rely on precision, rigorous formal definitions, unambiguous code that compiles down to exact machine instructions; natural human languages rely on allusions, metaphors, nuances, idioms, and unspoken body language---writing is therefore an art-form, and not a science, as it takes a very special sort of person to convey the vast wealth of human interactions in the limited medium of the written word, allowing all readers to experience their emotions and perceptions.  But <em>all programmers</em> are expected to convey the degree of precision that a computer expects.</p>
+<p>In this chapter, we will review the current state of NLP as a field of research and the libraries available in Common Lisp for writing NLP software; we will explore the challenges of speech-recognition and leverage existing tools and APIs for transforming speech to text; and we will write a general purpose library for creating meaningful abstract syntax trees from English, to attempt to write Lisp software using natural, conversational language.</p>
+<h3 id="exercise-3161">Exercise 3.16.1</h3>
+<p><strong>Speech Recognition</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3162">Exercise 3.16.2</h3>
+<p><strong>Handling Audio Input</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3163">Exercise 3.16.3</h3>
+<p><strong>HTTP Interfaces with Drakma</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3164">Exercise 3.16.4</h3>
+<p><strong>An Interface to the Dragon Mobile SDK</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3165">Exercise 3.16.5</h3>
+<p><strong>Parsing Speech-to-Text with CL-LangUtils</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3166">Exercise 3.16.6</h3>
+<p><strong>More CL-LangUtils</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3167">Exercise 3.16.7</h3>
+<p><strong>Even More CL-LangUtils</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3168">Exercise 3.16.8</h3>
+<p><strong>Advanced NLP with CL-NLP and CL-NLTK</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-3169">Project 3.16.9</h3>
+<p><strong>A Conversational Speech-to-Software Tool</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-15-00-quantum-computing.html" class="navigation navigation-prev " aria-label="Previous page: Quantum Computing">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-17-00-ai.html" class="navigation navigation-next " aria-label="Next page: Artificial Intelligence">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Natural Language Processing","level":"5.1.16","depth":2,"next":{"title":"Artificial Intelligence","level":"5.1.17","depth":2,"path":"3-17-00-ai.md","ref":"./3-17-00-ai.md","articles":[]},"previous":{"title":"Quantum Computing","level":"5.1.15","depth":2,"path":"3-15-00-quantum-computing.md","ref":"./3-15-00-quantum-computing.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-16-00-nlp.md","mtime":"2022-08-23T00:01:55.636Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-17-00-ai.html b/clones/llthw.common-lisp.dev/3-17-00-ai.html
new file mode 100644
index 00000000..210dbc39
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-17-00-ai.html
@@ -0,0 +1,1917 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Artificial Intelligence · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-18-00-robotics.html" />
+    
+    
+    <link rel="prev" href="3-16-00-nlp.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Artificial Intelligence</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-317">Chapter 3.17</h1>
+<h2 id="artificial-intelligence">Artificial Intelligence</h2>
+<blockquote>
+<p>&quot;They kept hooking hardware into him---decision-action boxes to let him boss other computers, bank on bank of additional memories, more banks of associational neural nets, another tubful of twelve-digit random numbers, a greatly augmented temporary memory. Human brain has around ten-to-the-tenth neurons. By third year Mike had better than one and a half times that number of neuristors. And woke up.&quot;</p>
+<footer>Robert A. Heinlein, <em>The Moon Is a Harsh Mistress</em></footer>
+
+</blockquote>
+<p><strong>Revision Note:</strong> <em>Trim down intro text to focus on AI techniques in Lisp</em>.</p>
+<p>There is a strong historical association of the LISP-family of programming languages with Artificial Intelligence research; this is mostly accidental, as some notable early Lisp Hackers happened to also be AI researchers, and in particular, John McCarthy---the creator of the original LISP language---also managed to earn himself the title, &quot;the Father of Modern AI&quot;.  And of course, we can&apos;t forget that the ANSI Committee working on the Common Lisp standard itself was sponsored by DARPA primarily for military-grade artificial intelligence software.</p>
+<p>These days, however, there are many good choices for so-called &quot;AI Languages&quot;---and Common Lisp, the general-purpose, high-level, multi-paradigm, programmable programming language is just as strong a choice for AI as for any other problem domain.</p>
+<p>It may benefit the reader to know more about the different kinds of AI software that one can write.  Many people still hear the term &quot;AI&quot; and get scared---visions of hostile, AI-driven robots bent on the annihilation of humanity from a variety of Science Fiction stories spring to mind; combined with Elon Musk&apos;s recent outburst about AI-researchers &quot;summoning the devil&quot; by creating &quot;soulless&quot; beings.  But AI-research is <em>nowhere near</em> the sufficient level of sophistication to allow for <em>emergent machine intelligence</em>.  The reality of all AI software-agents written to date is that they are no more than highly complex, underwhelming <em>impersonations</em> of intelligent behaviour---and because their behaviour is entirely programmed, the emergence of genuine machine intelligence within them is not even possible.</p>
+<p>If you are one of those people that is afraid of the future, where we are either ruled or exterminated by our robot creations, you don&apos;t need to be; <em>the more behaviour you program into an AI agent, the less likely it is to develop sentience</em>.  In order to create a Strong, or General AI agent that supports the potential for emergent machine intelligence, you would have to recreate the exact conditions in which intelligence emerges naturally---and that is to say, we would not be creating a hostile, demonic, or soulless computational entity; by recreating the exact conditions in which intelligence already emerges naturally, we would simply be creating an artificial <em>human being</em>.  But therein also lies the challenge; there is still so much that we do not understand about the human brain, that creating an artificial one is not yet even a feasible undertaking.  And furthermore, there is still the question of just how much instinctual knowledge humans are born with, compared to some other species of animal life; and what instinct actually means, when you consider a computational model of consciousness.</p>
+<p>In short, the threat of hostile AI is not worth worrying about; as usual, the only threat is with the people who wield AI techniques for the exploitation of others.</p>
+<p>In this chapter, we will review a selection of current models of AI research and development, building on what you already learned in chapters 3.14 on Quantum Computing, and 3.15 on Natural Language Processing in order to create a Learning Agent version of the old Eliza program, that will appear to become smarter the more you use it; and then we&apos;ll revisit your game built for Chapter 3.7 and extended in Chapter 3.8, to add more sophisticated NPCs and Enemies that rely on Quantum AI.</p>
+<h3 id="exercise-3171">Exercise 3.17.1</h3>
+<p><strong>Artificial Intelligence Today</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3172">Exercise 3.17.2</h3>
+<p><strong>Heuristics</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3173">Exercise 3.17.3</h3>
+<p><strong>Decisions</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3174">Exercise 3.17.4</h3>
+<p><strong>Pathfinding</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3175">Exercise 3.17.5</h3>
+<p><strong>Learning and Neural Networks</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3176">Exercise 3.17.6</h3>
+<p><strong>The AI Agent&apos;s World</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3177">Exercise 3.17.7</h3>
+<p><strong>Knowledge and Information</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-3178">Project 3.17.8</h3>
+<p><strong>A Learning Eliza</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3179">Exercise 3.17.9</h3>
+<p><strong>An Intro to Quantum AI</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-31710">Exercise 3.17.10</h3>
+<p><strong>Quantum Learning Algorithms</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-31711">Exercise 3.17.11</h3>
+<p><strong>Quantum Pathfinding</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-31712">Exercise 3.17.12</h3>
+<p><strong>Quantum Optimization and Heuristics</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-31713">Project 3.17.13</h3>
+<p><strong>Upgrading Your Game Engine With Quantum AI</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-31714">Exercise 3.17.14</h3>
+<p><strong>The Turing Test</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-31715">Project 3.17.15</h3>
+<p><strong>A Quantum, Learning Eliza</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-16-00-nlp.html" class="navigation navigation-prev " aria-label="Previous page: Natural Language Processing">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-18-00-robotics.html" class="navigation navigation-next " aria-label="Next page: Robotics">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Artificial Intelligence","level":"5.1.17","depth":2,"next":{"title":"Robotics","level":"5.1.18","depth":2,"path":"3-18-00-robotics.md","ref":"./3-18-00-robotics.md","articles":[]},"previous":{"title":"Natural Language Processing","level":"5.1.16","depth":2,"path":"3-16-00-nlp.md","ref":"./3-16-00-nlp.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-17-00-ai.md","mtime":"2022-08-23T00:01:55.640Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-18-00-robotics.html b/clones/llthw.common-lisp.dev/3-18-00-robotics.html
new file mode 100644
index 00000000..bad87558
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-18-00-robotics.html
@@ -0,0 +1,1918 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Robotics · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-19-00-space-tech.html" />
+    
+    
+    <link rel="prev" href="3-17-00-ai.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Robotics</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-318">Chapter 3.18</h1>
+<h2 id="robotics">Robotics</h2>
+<blockquote>
+<p>&quot;Engineering is the art of the practical and depends more on the total state of the art than it does on the individual engineer.&quot;</p>
+<footer>Robert A. Heinlein, <em>The Door Into Summer</em></footer>
+
+</blockquote>
+<p><strong>Note:</strong> <em>the exercises in this chapter will require specialized hardware components to complete, and due to the prohibitive cost and lack of availability for some readers, it should be considered optional</em>.</p>
+<p>To many people in the tech community, robotics is the ultimate expression of human innovation and ingenuity; and in many ways, the progress of the field is also a direct reflection of how well we understand ourselves as a species, as roboticists work towards an idealized simulacrum of the human form captured in engineering.  Humanoid robots are also, of course, a cornerstone of the Technological Singularity; and having this technology will redefine what it means to be human.  It combines so many disparate areas of research into a single, autonomous physical agent---at the very least, robotics is a technological marvel, but some day, once our computers rival the raw power of the human brain, and we are able to harness portable power supplies of sufficient output, they could also become new homes for our True Selves---our Minds.</p>
+<p>At present, however, robotics is not nearly as advanced as we need it to be to achieve those goals---or advanced enough to give us any reason to fear robotics and the cynical science fiction trope of a robotic uprising.  Certain companies have been making great strides in the field, such as Boston Dynamics (recently acquired by Google); and we can be certain that for all the progress that has been made, that is public knowledge, there are likely even more impressive and terrifying classified military projects---but any ventures into that topic would be pure speculation.</p>
+<p>What is of more interest is the vast selection of components that are already available to hobby roboticists, a very different situation from only two decades ago, when you would have to build nearly every component from scratch, even down to designing, assembling, and sautering your own logic control board.  Now you can buy all these components, logic boards, servos, sensors, and more, to design, build, and program your own robots in a fraction of the time it used to take.  This allows you to put more time and energy into programming the AI of your robot, up to the computational limits of the platform.</p>
+<p>Programming in general is a highly satisfying career choice, as there is nothing quite like the feeling of building something that people need and want to use every day; but taking the next step, programming a robot, and watching it move around on its own, learning and adapting, is orders of magnitude greater.  A certain part of you can&apos;t help but feel like Dr. Frankenstein, laughing maniacally as you bring life to the inanimate---but that feeling is overwhelmed by an even greater wonder at the marvels of science and engineering, that awakens your inner child.</p>
+<p>In this chapter, we will review the field of robotics, AI-controlled automatons, and learning algorithms; suppliers for components and robot kits; write a library to allow us to program a kit robot in Common Lisp; extend this library with an architecture to support intent-based motion; and finally, integrate a basic AI that will allow your kit robot to walk around, explore, and make its own decisions based on the environment you put it in.</p>
+<h3 id="exercise-3181">Exercise 3.18.1</h3>
+<p><strong>The Basic Principles of Robotics</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3182">Exercise 3.18.2</h3>
+<p><strong>Programmable Kit Robots</strong></p>
+<p>The Bioloid Premium Robot Kit is probably the most cost-effective solution that offers a full complement of programmable kit robot features.</p>
+<p><a href="http://www.robotshop.com/" target="_blank">http://www.robotshop.com/</a></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3183">Exercise 3.18.3</h3>
+<p><strong>Handling Controllers, Servos, and Sensors</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3184">Exercise 3.18.4</h3>
+<p><strong>The Control Board</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3185">Exercise 3.18.5</h3>
+<p><strong>Dispatching to Servos</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3186">Exercise 3.18.6</h3>
+<p><strong>Sensors: Gyroscope</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3187">Exercise 3.18.7</h3>
+<p><strong>Sensors: Infrared</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3188">Exercise 3.18.8</h3>
+<p><strong>Sensors: Distance Measurement</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3189">Exercise 3.18.9</h3>
+<p><strong>USB Interfaces</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-31810">Project 3.18.10</h3>
+<p><strong>A Library for the BIOLOID Premium Robot Kit</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-31811">Exercise 3.18.11</h3>
+<p><strong>Robot AI</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-31812">Exercise 3.18.12</h3>
+<p><strong>Motion Teaching and Learning</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-31813">Exercise 3.18.13</h3>
+<p><strong>Intent-Based Motion</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-31814">Exercise 3.18.14</h3>
+<p><strong>Decision-Making, for Robots</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-31815">Project 3.18.15</h3>
+<p><strong>An Independent, Learning Automaton</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-17-00-ai.html" class="navigation navigation-prev " aria-label="Previous page: Artificial Intelligence">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-19-00-space-tech.html" class="navigation navigation-next " aria-label="Next page: Space Tech">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Robotics","level":"5.1.18","depth":2,"next":{"title":"Space Tech","level":"5.1.19","depth":2,"path":"3-19-00-space-tech.md","ref":"./3-19-00-space-tech.md","articles":[]},"previous":{"title":"Artificial Intelligence","level":"5.1.17","depth":2,"path":"3-17-00-ai.md","ref":"./3-17-00-ai.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-18-00-robotics.md","mtime":"2022-08-23T00:01:55.640Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-19-00-space-tech.html b/clones/llthw.common-lisp.dev/3-19-00-space-tech.html
new file mode 100644
index 00000000..d489b1d6
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-19-00-space-tech.html
@@ -0,0 +1,1905 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Space Tech · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-20-00-neurotech.html" />
+    
+    
+    <link rel="prev" href="3-18-00-robotics.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Space Tech</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-319">Chapter 3.19</h1>
+<h2 id="space-tech">Space-Tech</h2>
+<blockquote>
+<p>&quot;People don&apos;t really want change, any change at all... But we progress, as we must---if we are to go out to the stars.&quot;</p>
+<footer>Robert A. Heinlein, <em>Double Star</em></footer>
+
+</blockquote>
+<p>All software has bugs in it---it&apos;s just a part of life in a technologically-driven society---but not all bugs are actual mistakes, per se. Sometimes they can be no more than an application of the wrong algorithm to a given problem, which provides an apparently correct answer, say, 99% of the time, but then produces something completely wrong in that last 1% of the cases.  Here, on Earth, bugs in software can cause significant problems as it is, which is why so much time and effort is spent on QA and software updates; but imagine how much trouble a bug could be in a Probe, Satellite, or Space-Craft, where a technical support and development team can&apos;t directly access the hardware, and in dealing with the vast distances of space, have so much lag between any event, the notification of it, and the hardware getting the updated code.</p>
+<p>Traditional software development lifecycles and technologies are inherently at a disadvantage in Space Tech, an industry where you can&apos;t afford to make any mistakes.  One of the most important features needed in any space-based platform is the ability to immediately get inside the running application, identify a bug and fix it while the application is running.  <em>Lisp was designed to do this</em>.  And certainly, NASA validated this point quite strongly with Deep Space 1 and the Remote Agent Experiment (RAX).</p>
+<p>Now, imagine the relative convenience of a space-craft where all the systems are programmed in Lisp, and are thus live hackable; astronauts are already highly trained, highly intelligent and resourceful individuals who can cope with the stresses of life in space---and it would not be much of a stretch to add programming in Lisp to their list of necessary skills.  If they had the option to control all systems from a REPL, extend, test, and fix mission critical software interactively, on an as-needed basis, they would be significantly better equipped to handle any of the many issues that can arise in space, in a much more timely fashion than mission control on Earth can respond.  Those precious seconds of lag in communication between Earth and a space-craft can mean the difference between mission failure and success.</p>
+<p>Space Tech is a complex field of interrelated, specialized disciplines---and inevitably, after a cursory introduction to the field as a whole in an undergraduate program, students are expected to focus on one of the many specializations, such as astrophysics, propulsion, aerospace engineering, communications, etc.  But it is advantageous to have a big picture, wide-view of the field before choosing a specialization.</p>
+<p>In this chapter, we will explore a very high-level overview of a selection of the topics in the field of Space Tech, namely astrophysics, microgravity, properties of vacuums and near-vacuums, propulsion, aerospace engineering, and communication; design idealized model satellites and probes, integrating a basic AI that can be overridden by a controller on Earth; and implement an environment to simulate space-like conditions for testing these models.  And lastly, we will extend this text-based simulator to a 3D simulation, where you can see your model space-craft in action.</p>
+<h3 id="exercise-3191">Exercise 3.19.1</h3>
+<p><strong>Simulating Physics and Astrophysics</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3192">Exercise 3.19.2</h3>
+<p><strong>Microgravity</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3193">Exercise 3.19.3</h3>
+<p><strong>Vacuums and Near-Vacuums</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3194">Exercise 3.19.4</h3>
+<p><strong>Orbits</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3195">Exercise 3.19.5</h3>
+<p><strong>Simulating Space-Tech</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3196">Exercise 3.19.6</h3>
+<p><strong>Basic Principles of Aerospace Engineering</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3197">Exercise 3.19.7</h3>
+<p><strong>Propulsion</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3198">Exercise 3.19.8</h3>
+<p><strong>Communication</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3199">Exercise 3.19.9</h3>
+<p><strong>A Controller AI</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-31910">Exercise 3.19.10</h3>
+<p><strong>Unmanned Spacecraft</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-31911">Exercise 3.19.11</h3>
+<p><strong>Simulating Life-Support for Manned Spacecraft</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-31912">Exercise 3.19.12</h3>
+<p><strong>Live Hacking Mission-Critical Systems</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-31913">Project 3.19.13</h3>
+<p><strong>A 3D Space Simulator</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-18-00-robotics.html" class="navigation navigation-prev " aria-label="Previous page: Robotics">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-20-00-neurotech.html" class="navigation navigation-next " aria-label="Next page: Neuroscience and Thought-Controlled Computing">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Space Tech","level":"5.1.19","depth":2,"next":{"title":"Neuroscience and Thought-Controlled Computing","level":"5.1.20","depth":2,"path":"3-20-00-neurotech.md","ref":"./3-20-00-neurotech.md","articles":[]},"previous":{"title":"Robotics","level":"5.1.18","depth":2,"path":"3-18-00-robotics.md","ref":"./3-18-00-robotics.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-19-00-space-tech.md","mtime":"2022-08-23T00:01:55.640Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-20-00-neurotech.html b/clones/llthw.common-lisp.dev/3-20-00-neurotech.html
new file mode 100644
index 00000000..7aeb82e4
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-20-00-neurotech.html
@@ -0,0 +1,1907 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Neuroscience and Thought-Controlled Computing · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-21-00-lispos.html" />
+    
+    
+    <link rel="prev" href="3-19-00-space-tech.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Neuroscience and Thought-Controlled Computing</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-320">Chapter 3.20</h1>
+<h2 id="neuroscience-and-thought-controlled-computing">Neuroscience and Thought-Controlled Computing</h2>
+<blockquote>
+<p>&quot;Now that he knew himself to be self he was free to grok ever closer to his brothers, merge without let. Self&apos;s integrity was and is and ever had been.&quot;</p>
+<footer>Robert A. Heinlein, <em>Stranger in a Strange Land</em></footer>
+
+</blockquote>
+<p><strong>Note:</strong> <em>the exercises in this chapter will require specialized hardware components to complete, and due to the prohibitive cost and lack of availability for some readers, it should be considered optional</em>.</p>
+<p>Affordable Brain--Computer Interfaces are a relatively new thing.  They are not <em>new</em> in terms of actual technological innovation, being based on EEG systems that have existed for decades, but the application of specialized medical and scientific equipment to the average computer user as a potential replacement for the old-fashioned keyboard and mouse <em>is</em> quite novel.  Naturally, BCIs have been advertised primarily as accessibility devices and the next big thing for gaming, but their impact is far more significant than that.</p>
+<p>The real significance of BCIs is that they enable an individual user to become consciously aware of their own brainwaves, and then manipulate them arbitrarily for computational purposes.  Depending on the sophistication of the BCI, this may simply amount to a more interactive meditative experience that allows you to track your progress towards inner peace---but some models available on the market give a very complete picture of the brain&apos;s activity to the user, and with multiple sensors, can at least in theory be manipulated like a brainwave-powered stenographic keyboard.</p>
+<p>The one issue with available Brain--Computer Interfaces is the lack of software to make full use of the hardware.  Developer kits are available for every platform on the market, but surprisingly few developers have jumped on such an intriguing technology---given how many programmers suffer from carpal-tunnel syndrome, and other repetitive stress injuries, one would think that BCIs would be embraced more rapidly, as a more efficient and less physically damaging means to write software. Example BCI-based replacements for the keyboard and mouse interfaces already exist, however they suffer in terms of usability---once trained in the art of conscious brainwave manipulation, a number of more intuitive methodolgies exist for controlling a computer.  And we will cover them here.</p>
+<p>In this chapter, we will review the basic concepts of Neuroscience and the various BCIs available on the market, their specifications and SDKs; we will parse the resulting brainwave data in Lisp, and attempt to structure Neural-net models to get a better understanding of what our brains are doing; and write several brainwave controlled utility applications specifically designed for improving your Lisp workflow, including a brief introduction to Emacs Lisp that will enable us to map BCI input to Emacs keyboard commands.</p>
+<h3 id="exercise-3201">Exercise 3.20.1</h3>
+<p><strong>An Introduction to Neuroscience</strong></p>
+<p><em>Note:</em> illustrate concepts of neuroscience with a model neural net that produces externally visible brainwaves as a software interface.</p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3202">Exercise 3.20.2</h3>
+<p><strong>An Introduction to Thought-Controlled Computing</strong></p>
+<p><em>Note:</em> extend the previous exercise to demonstrate use of the visible brainwave interface.</p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3203">Exercise 3.20.3</h3>
+<p><strong>Commercial Brain--Computer Interfaces</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3204">Exercise 3.20.4</h3>
+<p><strong>Muse and OSC</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3205">Exercise 3.20.5</h3>
+<p><strong>Emotiv EPOC SDK</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3206">Exercise 3.20.6</h3>
+<p><strong>Analyzing Brainwave Data in Lisp</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3207">Exercise 3.20.7</h3>
+<p><strong>Mapping Mnemonic Brainwave Patterns</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3208">Exercise 3.20.8</h3>
+<p><strong>Training Your Brain to Activate BCI Sensors</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3209">Exercise 3.20.9</h3>
+<p><strong>Training Your Brain&apos;s Resting State</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-32010">Project 3.20.10</h3>
+<p><strong>Interactive Meditation and Self-Awareness</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-32011">Exercise 3.20.11</h3>
+<p><strong>Mapping Brainwave Data to Text Input</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-32012">Exercise 3.20.12</h3>
+<p><strong>Mapping Brainwave Data to Mouse Input</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-32013">Project 3.20.13</h3>
+<p><strong>An Emacs Extension for Thought-Controlled Computing</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-19-00-space-tech.html" class="navigation navigation-prev " aria-label="Previous page: Space Tech">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-21-00-lispos.html" class="navigation navigation-next " aria-label="Next page: A Simple LispOS">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Neuroscience and Thought-Controlled Computing","level":"5.1.20","depth":2,"next":{"title":"A Simple LispOS","level":"5.1.21","depth":2,"path":"3-21-00-lispos.md","ref":"./3-21-00-lispos.md","articles":[]},"previous":{"title":"Space Tech","level":"5.1.19","depth":2,"path":"3-19-00-space-tech.md","ref":"./3-19-00-space-tech.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-20-00-neurotech.md","mtime":"2022-08-23T00:01:55.640Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-21-00-lispos.html b/clones/llthw.common-lisp.dev/3-21-00-lispos.html
new file mode 100644
index 00000000..4671e5bd
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-21-00-lispos.html
@@ -0,0 +1,1890 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>A Simple LispOS · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-22-00-lisp-machine.html" />
+    
+    
+    <link rel="prev" href="3-20-00-neurotech.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >A Simple LispOS</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-321">Chapter 3.21</h1>
+<h2 id="a-simple-lispos">A Simple LispOS</h2>
+<blockquote>
+<p>&quot;The difference between science and the fuzzy subjects is that science requires reasoning, while those other subjects merely require scholarship.&quot;</p>
+<footer>Robert A. Heinlein, <em>Time Enough for Love</em></footer>
+
+</blockquote>
+<p><strong>Revision Note:</strong> <em>rewrite this chapter as a case-study on Mezzano.</em></p>
+<p><strong>Note:</strong> <em>the exercises in this chapter may require an additional computer to complete, and due to the prohibitive cost and lack of availability for some readers, it should be considered optional</em>.</p>
+<p>The elegance, power, and expressiveness of Lisp often encourages students of the language to wish for a more complete, live hackable, Lisp-based environment that extends beyond the Emacs+SLIME development environment; they usually start with either a Lisp-based window manager, such as StumpWM, or replacing their command-line shell with the Lisp REPL, and then quickly come to the conclusion, &quot;why can&apos;t the whole operating system be written in Lisp?&quot;  Well, it&apos;s not quite so easy as that... but it is still very much in the realm of possibility.</p>
+<p>If you already run a Linux-based Operating System, you can start by just replacing pieces of your distro one-by-one with Lisp-based equivalents; but it is probably much safer if you use a spare computer, or a virtual machine, so that if anything goes wrong you won&apos;t lose any personal data.</p>
+<p>In this chapter, we will review the basic organization of operating systems, and what software they typically need to contain; take a brief tour of the available open-source Common Lisp software for building an Operating System; and assemble a basic Lisp-based operating system which can be run on a virtual machine or installed on a spare computer for testing.</p>
+<h3 id="exercise-3211">Exercise 3.21.1</h3>
+<p><strong>The Scope of Operating Systems</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3212">Exercise 3.21.2</h3>
+<p><strong>The Kernel</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3213">Exercise 3.21.3</h3>
+<p><strong>The Shell</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3214">Exercise 3.21.4</h3>
+<p><strong>I/O</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3215">Exercise 3.21.5</h3>
+<p><strong>File Systems</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3216">Exercise 3.21.6</h3>
+<p><strong>Memory Management</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3217">Exercise 3.21.7</h3>
+<p><strong>Processes and Threads</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3218">Exercise 3.21.8</h3>
+<p><strong>Sandboxing</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3219">Exercise 3.21.9</h3>
+<p><strong>Window Managers and Graphical User Interfaces</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-32110">Project 3.21.10</h3>
+<p><strong>A Basic LispOS for Virtual Machines</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-20-00-neurotech.html" class="navigation navigation-prev " aria-label="Previous page: Neuroscience and Thought-Controlled Computing">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-22-00-lisp-machine.html" class="navigation navigation-next " aria-label="Next page: Build Your Own Lisp Machine">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"A Simple LispOS","level":"5.1.21","depth":2,"next":{"title":"Build Your Own Lisp Machine","level":"5.1.22","depth":2,"path":"3-22-00-lisp-machine.md","ref":"./3-22-00-lisp-machine.md","articles":[]},"previous":{"title":"Neuroscience and Thought-Controlled Computing","level":"5.1.20","depth":2,"path":"3-20-00-neurotech.md","ref":"./3-20-00-neurotech.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-21-00-lispos.md","mtime":"2022-08-23T00:01:55.640Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-22-00-lisp-machine.html b/clones/llthw.common-lisp.dev/3-22-00-lisp-machine.html
new file mode 100644
index 00000000..95731fb2
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-22-00-lisp-machine.html
@@ -0,0 +1,1911 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Build Your Own Lisp Machine · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="3-23-00-gov-mil.html" />
+    
+    
+    <link rel="prev" href="3-21-00-lispos.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Build Your Own Lisp Machine</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-322">Chapter 3.22</h1>
+<h2 id="build-your-own-lisp-machine">Build Your Own Lisp Machine</h2>
+<blockquote>
+<p>&quot;Revolution is an art that I pursue rather than a goal I expect to achieve. Nor is this a source of dismay; a lost cause can be as spiritually satisfying as a victory.&quot;</p>
+<footer>Robert A. Heinlein, <em>The Moon Is a Harsh Mistress</em></footer>
+
+</blockquote>
+<p><strong>Note:</strong> <em>the exercises in this chapter will require specialized hardware components to complete, and due to the prohibitive cost and lack of availability for some readers, it should be considered optional</em>.</p>
+<p>Few topics capture the imagination of budding Lisp Hackers more than the legendary Lisp Machines of the 70s and 80s---the first personal workstations in a world of time-shared, multi-user mainframes, with a fully integrated and interactive hardware and software environment, that seemed to offer unrivaled competitive-edge for the team that could afford them.  Unfortunately, with the rise of IBM-Compatible Personal Computers, available at a fraction of the cost, the highly specialized and costly Lisp Machines were the first casualties of the AI Winter. But the dream of the Lisp Machine has never died.</p>
+<p>Back in the 80s, there were a significant number of competing architectures, the various Lisp Machine chipsets being only a small number of them; but over the past 30 years, there has been a significant push by Intel to be the dominant architecture through a process of generalization---by developing a processor architecture that was more generally useful to multiple platforms and purposes, instead of being specialized, they were able to cater to more users and rapidly seize control of the largest market share---even going so far as to partner with Apple, to unify the underlying, previously competing architectures of Macintosh and IBM-Compatible PCs.</p>
+<p>But over the past decade, there has been a shift back towards specialized hardware, heavily prompted by the Internet-of-Things movement and the surprising success of mobile devices and smartphones.  These days, reprogrammable hardware is available for little more than a full professional workstation, and once a chipset design has been tested extensively on an FPGA-based board, it can be ported to an ASIC design for microfabrication by a host of companies with competitive rates.  These days, pretty much anyone can design, test, and implement a custom computer architecture, and get their design built and shipped to their front door as a big wafer.  In one sense, it&apos;s a little silly, since this plethora of home-built architectures means more and more platforms exist, for which there is no compatible software or compilers---but combined with a sensible use of an existing standard instruction set, it does make for a powerful toolchain for the home inventor.</p>
+<p>As we have already covered in previous chapters, it&apos;s common knowledge that Lisp can be defined in Lisp---so it stands to reason to also implement the architecture of a Lisp Machine in Lisp, that can be output to the synthesizable Verilog code that will be written to the FPGA or used to fabricate an ASIC.  And by implementing the core constructs of the language as the machine language of a Lisp Machine, you eliminate one of the most troublesome aspects of compiler design and optimization.</p>
+<p>This chapter will contain a review of available FPGA-based boards and ASIC manufacturers; a brief primer on synthesizable Verilog, and a DSL for producing Verilog/VHDL from Common Lisp source-code; and a schema for a 64-bit Lisp Machine.  As an extra credit exercise, we will modify an existing Common Lisp implementation to run directly on this Lisp Machine and use it as the basis for a LispOS for your new Lisp Machine.</p>
+<h3 id="exercise-3221">Exercise 3.22.1</h3>
+<p><strong>Hardware Prototyping and Fabrication</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3222">Exercise 3.22.2</h3>
+<p><strong>Field Programmable Gate Arrays</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3223">Exercise 3.22.3</h3>
+<p><strong>Application-Specific Integrated Circuits</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3224">Exercise 3.22.4</h3>
+<p><strong>Prototyping CPUs</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3225">Exercise 3.22.5</h3>
+<p><strong>Synthesizable Verilog</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3226">Exercise 3.22.6</h3>
+<p><strong>More Synthesizable Verilog</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3227">Exercise 3.22.7</h3>
+<p><strong>Even More Synthesizable Verilog</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3228">Exercise 3.22.8</h3>
+<p><strong>Generating Verilog/VHDL from Common Lisp</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-3229">Project 3.22.9</h3>
+<p><strong>A DSL for Verilog/VHDL</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-32210">Exercise 3.22.10</h3>
+<p><strong>Hardware Support for Common Lisp&apos;s Special Forms</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-32211">Exercise 3.22.11</h3>
+<p><strong>The Lisp Machine&apos;s Memory Model</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-32212">Exercise 3.22.12</h3>
+<p><strong>A 64-Bit Lisp Machine Architecture</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-32213">Project 3.22.13</h3>
+<p><strong>Common Lisp for the Lisp Machine</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-32214">Project 3.22.14</h3>
+<p><strong>Porting the LispOS to the Lisp Machine Architecture</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-21-00-lispos.html" class="navigation navigation-prev " aria-label="Previous page: A Simple LispOS">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="3-23-00-gov-mil.html" class="navigation navigation-next " aria-label="Next page: Government and Military Grade Systems">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Build Your Own Lisp Machine","level":"5.1.22","depth":2,"next":{"title":"Government and Military Grade Systems","level":"5.1.23","depth":2,"path":"3-23-00-gov-mil.md","ref":"./3-23-00-gov-mil.md","articles":[]},"previous":{"title":"A Simple LispOS","level":"5.1.21","depth":2,"path":"3-21-00-lispos.md","ref":"./3-21-00-lispos.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-22-00-lisp-machine.md","mtime":"2022-08-23T00:01:55.640Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/3-23-00-gov-mil.html b/clones/llthw.common-lisp.dev/3-23-00-gov-mil.html
new file mode 100644
index 00000000..2bc338d9
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/3-23-00-gov-mil.html
@@ -0,0 +1,1940 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Government and Military Grade Systems · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    
+    <link rel="prev" href="3-22-00-lisp-machine.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Government and Military Grade Systems</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="chapter-323">Chapter 3.23</h1>
+<h2 id="government-and-military-grade-systems">Government and Military Grade Systems</h2>
+<blockquote>
+<p>&quot;The difference [between the soldier and the civilian] lies in the field of civic virtue. A soldier accepts personal responsibility for the safety of the body politic of which he is a member, defending it, if need be, with his life. The civilian does not.&quot;</p>
+<footer>Robert A. Heinlein, <em>Starship Troopers</em></footer>
+
+</blockquote>
+<p>The technological needs of Government and Military organizations are, by necessity, far greater than the needs of civilians and businesses.  Governments are charged with the protection and care of their populace, and by extension, the security of information about them that could be harmful if leaked to the public or stolen by criminals.  Likewise, the Military is charged with the defense of the Nation, and everything it does is by necessity classified.  But a government is only as strong as the technology it uses and the people who are wielding this technology.  If an enemy nation, operative, or malicious hacker is able to compromise military communications, you can imagine how devastating this can be for national security---but such a breach of security is just as damaging to the individual, if their medical, income tax, or other personal information held by the government is leaked or stolen.</p>
+<p>Security is not a final destination, however, it&apos;s a process; and a complicated one at that.  In military operations, every action and piece of information is time-sensitive, so efficiency and flexibility are just as fundamental needs as adaptability and situational awareness.  You can see then, after everything that you&apos;ve learned so far, how important a dynamic, interactive general purpose programming language like Common Lisp is to the success of military operations, and to the secure and efficient operation of government in general.  But a number of other topics we&apos;ve covered also have direct application to military service, civilian military contracts, and the operation of government in the 21st century.</p>
+<p>The next generation of Military and Government contractors have a lot more work to do than just getting the jobs assigned to them done on time and in-budget; they also need to understand that the industry as a whole is full of bloat---inefficiencies, redundancies, and carelessness---and that this bloat is literally costing lives and putting civilians in harms way.  This bloat is as much an enemy of the state as a hostile dictatorship armed with weapons of mass destruction---and the best weapon to fight this bloat is a technology stack that is designed to eliminate bloat.  On average, an experienced Lisp Hacker can achieve what normally requires a team of 6 senior developers, in a fraction of the time; this has a lot to do with the type of programmers that have been attracted to Lisp, but it also has a lot to do with the interactive, iterative development process where code is progressively tested and optimized as it&apos;s written.  This essential feature of Lisp is a great advantage to military contractors, cyber-warfare soldiers, and TECHINT intelligence operatives.</p>
+<p>In this chapter, we will review the basic requirements of Government and Military Grade systems, in so far as these requirements are declassified; use our Lisp Verilog DSL and FPGA skills to create live-hackable battlefield hardware; and revisit the topic of cryptography, authentication, and authorization for handling extremely sensitive Need-To-Know classified information, in such a way that if it is leaked or intercepted, the person responsible can be held fully accountable with minimal delay.</p>
+<h3 id="exercise-3231">Exercise 3.23.1</h3>
+<p><strong>Battlefield Hardware</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3232">Exercise 3.23.2</h3>
+<p><strong>Drone Kits</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3233">Exercise 3.23.3</h3>
+<p><strong>Fail-Safes for Drones</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-3234">Project 3.23.4</h3>
+<p><strong>A Live-Hackable Drone</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3235">Exercise 3.23.5</h3>
+<p><strong>The Techniques of Cyber-Warfare</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3236">Exercise 3.23.6</h3>
+<p><strong>Deductive Reasoning</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3237">Exercise 3.23.7</h3>
+<p><strong>Intelligence</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3238">Exercise 3.23.8</h3>
+<p><strong>Automation and Abstraction</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-3239">Exercise 3.23.9</h3>
+<p><strong>Pre-Computation</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-32310">Exercise 3.23.10</h3>
+<p><strong>Obfuscation</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-32311">Exercise 3.23.11</h3>
+<p><strong>Cryptography, Revisited</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-32312">Exercise 3.23.12</h3>
+<p><strong>Hardware-Assisted Cryptography</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-32313">Project 3.23.13</h3>
+<p><strong>A Hardware Module for Hashing, Encryption, and Decryption</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-32314">Exercise 3.23.14</h3>
+<p><strong>Hierarchical--Deterministic Keychains</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-32315">Exercise 3.23.15</h3>
+<p><strong>Device-Locked Master Keys</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-32316">Exercise 3.23.16</h3>
+<p><strong>Users and Keys</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-32317">Exercise 3.23.17</h3>
+<p><strong>Accountability</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-32318">Exercise 3.23.18</h3>
+<p><strong>Data Permutation</strong></p>
+<p>(i.e., selectively mutating information to embed detectable signatures in decrypted classified data)</p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-32319">Exercise 3.23.19</h3>
+<p><strong>Role-Based Redaction</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="exercise-32320">Exercise 3.23.20</h3>
+<p><strong>Self-Destructing Hardware</strong></p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+<h3 id="project-32321">Project 3.23.21</h3>
+<p><strong>A Hardware-Assisted Intelligence Subnet with Strong Accountability</strong></p>
+<p>(Not actually military-grade, but useful to illustrate TECHINT principles)</p>
+<pre><code class="lang-lisp">
+
+</code></pre>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="3-22-00-lisp-machine.html" class="navigation navigation-prev navigation-unique" aria-label="Previous page: Build Your Own Lisp Machine">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Government and Military Grade Systems","level":"5.1.23","depth":2,"previous":{"title":"Build Your Own Lisp Machine","level":"5.1.22","depth":2,"path":"3-22-00-lisp-machine.md","ref":"./3-22-00-lisp-machine.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"3-23-00-gov-mil.md","mtime":"2022-08-23T00:01:55.640Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/CHANGELOG.html b/clones/llthw.common-lisp.dev/CHANGELOG.html
new file mode 100644
index 00000000..e6e1ac83
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/CHANGELOG.html
@@ -0,0 +1,1851 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>CHANGELOG · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="TODO.html" />
+    
+    
+    <link rel="prev" href="index.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >CHANGELOG</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="changelog">CHANGELOG</h1>
+<h2 id="2022-08-24">2022-08-24</h2>
+<ul>
+<li>Add book.json to manually define GitBook configuration; let&apos;s see if that helps with some outstanding oddities</li>
+<li>Add GitBook plugins:<ul>
+<li>&quot;hints&quot;</li>
+<li>&quot;folding-chapters&quot;</li>
+</ul>
+</li>
+</ul>
+<h2 id="2022-08-23">2022-08-23</h2>
+<ul>
+<li>Add CHANGELOG and TODO chapters</li>
+<li>Deprecate and remove old &quot;Draft Progress at a Glance&quot; section from title page</li>
+</ul>
+<h2 id="2022-08-22">2022-08-22</h2>
+<ul>
+<li>Re-launched Learn Lisp The Hard Way on common-lisp.net</li>
+<li>Cleaned-up markdown source files for GitBook on GitLab Pages</li>
+<li>Removed purposely absurd &quot;BigInt&quot; examples from all exercises of Chapter 1.6,
+Numbers and Math, because GitBook couldn&apos;t parse them without crashing</li>
+<li>Removed Extra Credit Exercise 1.1.9, Setting Up and Learning Emacs Live</li>
+</ul>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="index.html" class="navigation navigation-prev " aria-label="Previous page: Second Draft (in-progress)">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="TODO.html" class="navigation navigation-next " aria-label="Next page: TODO">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"CHANGELOG","level":"1.2","depth":1,"next":{"title":"TODO","level":"1.3","depth":1,"path":"TODO.md","ref":"TODO.md","articles":[]},"previous":{"title":"Second Draft (in-progress)","level":"1.1","depth":1,"path":"index.md","ref":"index.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"CHANGELOG.md","mtime":"2022-08-24T16:13:30.035Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/TODO.html b/clones/llthw.common-lisp.dev/TODO.html
new file mode 100644
index 00000000..1455f8a5
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/TODO.html
@@ -0,0 +1,1840 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>TODO · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="preface.html" />
+    
+    
+    <link rel="prev" href="CHANGELOG.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >TODO</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="todo">TODO</h1>
+<ul>
+<li>[ ] Chapter 1.3, &quot;Extra Credit: Getting Input From Users&quot;<ul>
+<li>[ ] Finish code examples</li>
+<li>[ ] Split code examples into separate &quot;In the REPL&quot; and &quot;What You Should See&quot; sections</li>
+</ul>
+</li>
+<li>[ ] Rewrite code examples and simplify discourse for Chapter 1.4, &quot;Lists and List Operations&quot;</li>
+<li>[ ] Rewrite code examples and simplify discourse for Chapter 1.5, &quot;Extra Credit: Look-up Lists and Trees&quot;</li>
+<li>[ ] Write code examples for Chapter 1.7, &quot;Extra Credit: Arrays and Vectors&quot;</li>
+<li>[ ] Write code examples for Chapter 1.8, &quot;Variables, Parameters, and Constants&quot;</li>
+</ul>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="CHANGELOG.html" class="navigation navigation-prev " aria-label="Previous page: CHANGELOG">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="preface.html" class="navigation navigation-next " aria-label="Next page: TANSTAAFL">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"TODO","level":"1.3","depth":1,"next":{"title":"TANSTAAFL","level":"2.1","depth":1,"path":"preface.md","ref":"preface.md","articles":[]},"previous":{"title":"CHANGELOG","level":"1.2","depth":1,"path":"CHANGELOG.md","ref":"CHANGELOG.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"TODO.md","mtime":"2022-08-23T14:13:07.437Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/acknowledgements.html b/clones/llthw.common-lisp.dev/acknowledgements.html
new file mode 100644
index 00000000..091ed9af
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/acknowledgements.html
@@ -0,0 +1,1838 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Acknowledgements · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="1-0-0-overview.html" />
+    
+    
+    <link rel="prev" href="introduction.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Acknowledgements</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="preface-pt-v">Preface pt. V</h1>
+<h2 id="acknowledgements">Acknowledgements</h2>
+<blockquote>
+<p>&quot;Age is not an accomplishment, and youth is not a sin.&quot;</p>
+<footer>Robert A. Heinlein, <em>Methuselah&apos;s Children</em></footer>
+
+</blockquote>
+<p>First, I would like to thank John McCarthy (1927--2011), the creator of LISP and father of modern AI.  His insights into axiomatizing computation led to the ultimate expression of the symmetry between the human mind and the universe through the art of programming.</p>
+<p>To the generations of Lisp Hackers before me, for keeping the language alive even through the dark years of the AI Winter, and for their excellent contributions to open-source software.  And to all those who&apos;ve lent a hand proofreading the first and second drafts of this work, for their time and feedback.</p>
+<p>And lastly, to Zed A. Shaw for creating and releasing to open-source the LxTHW package for writing your own Learn Code The Hard Way book, so that I could finally bring my ideas into being for a better Lisp book; he has already gone a long way on his own to improve programming education as a whole, and to make programming more accessible to people all over the world.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="introduction.html" class="navigation navigation-prev " aria-label="Previous page: Lisp: A Future History">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="1-0-0-overview.html" class="navigation navigation-next " aria-label="Next page: Grokking Lisp">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Acknowledgements","level":"2.5","depth":1,"next":{"title":"Grokking Lisp","level":"3.1","depth":1,"path":"1-0-0-overview.md","ref":"1-0-0-overview.md","articles":[{"title":"Common Lisp Bootcamp","level":"3.1.1","depth":2,"path":"1-01-00-lisp-bootcamp.md","ref":"1-01-00-lisp-bootcamp.md","articles":[{"title":"Syntax Overview in 5 Minutes","level":"3.1.1.1","depth":3,"path":"1-01-01-syntax-overview.md","ref":"1-01-01-syntax-overview.md","articles":[]},{"title":"The REPL","level":"3.1.1.2","depth":3,"path":"1-01-02-repl.md","ref":"./1-01-02-repl.md","articles":[]},{"title":"Expressions, Parentheses, and Return Values","level":"3.1.1.3","depth":3,"path":"1-01-03-expressions.md","ref":"./1-01-03-expressions.md","articles":[]},{"title":"Lists, Cons-Cells, and Memory","level":"3.1.1.4","depth":3,"path":"1-01-04-lists-cons-cells.md","ref":"./1-01-04-lists-cons-cells.md","articles":[]},{"title":"Symbols and Namespaces","level":"3.1.1.5","depth":3,"path":"1-01-05-symbols.md","ref":"./1-01-05-symbols.md","articles":[]},{"title":"Prefix Notation","level":"3.1.1.6","depth":3,"path":"1-01-06-prefix-notation.md","ref":"./1-01-06-prefix-notation.md","articles":[]},{"title":"Common Lisp Style Guide","level":"3.1.1.7","depth":3,"path":"1-01-07-style-guide.md","ref":"./1-01-07-style-guide.md","articles":[]},{"title":"Configuring Your Development Environment","level":"3.1.1.8","depth":3,"path":"1-01-08-configuration.md","ref":"./1-01-08-configuration.md","articles":[]}]},{"title":"Printing, Streams, and Strings","level":"3.1.2","depth":2,"path":"1-02-00-input-output.md","ref":"1-02-00-input-output.md","articles":[{"title":"Strings","level":"3.1.2.1","depth":3,"path":"1-02-01-strings.md","ref":"./1-02-01-strings.md","articles":[]},{"title":"More Strings","level":"3.1.2.2","depth":3,"path":"1-02-02-more-strings.md","ref":"./1-02-02-more-strings.md","articles":[]},{"title":"Unicode and Strings","level":"3.1.2.3","depth":3,"path":"1-02-03-unicode.md","ref":"./1-02-03-unicode.md","articles":[]},{"title":"Characters","level":"3.1.2.4","depth":3,"path":"1-02-04-chars.md","ref":"./1-02-04-chars.md","articles":[]},{"title":"More Characters","level":"3.1.2.5","depth":3,"path":"1-02-05-more-chars.md","ref":"./1-02-05-more-chars.md","articles":[]},{"title":"Character Codes","level":"3.1.2.6","depth":3,"path":"1-02-06-char-codes.md","ref":"./1-02-06-char-codes.md","articles":[]},{"title":"Strings from Chars","level":"3.1.2.7","depth":3,"path":"1-02-07-strings-from-chars.md","ref":"./1-02-07-strings-from-chars.md","articles":[]},{"title":"Printing","level":"3.1.2.8","depth":3,"path":"1-02-08-printing.md","ref":"./1-02-08-printing.md","articles":[]},{"title":"More Printing","level":"3.1.2.9","depth":3,"path":"1-02-09-more-printing.md","ref":"./1-02-09-more-printing.md","articles":[]},{"title":"Printing With prin1","level":"3.1.2.10","depth":3,"path":"1-02-10-prin1.md","ref":"./1-02-10-prin1.md","articles":[]},{"title":"Printing With princ","level":"3.1.2.11","depth":3,"path":"1-02-11-princ.md","ref":"./1-02-11-princ.md","articles":[]},{"title":"A Brief Introduction to Format","level":"3.1.2.12","depth":3,"path":"1-02-12-format.md","ref":"./1-02-12-format.md","articles":[]},{"title":"A Little Bit More on Format","level":"3.1.2.13","depth":3,"path":"1-02-13-more-format.md","ref":"./1-02-13-more-format.md","articles":[]},{"title":"Pathnames","level":"3.1.2.14","depth":3,"path":"1-02-14-pathnames.md","ref":"./1-02-14-pathnames.md","articles":[]},{"title":"Streams","level":"3.1.2.15","depth":3,"path":"1-02-15-streams.md","ref":"./1-02-15-streams.md","articles":[]},{"title":"File Streams","level":"3.1.2.16","depth":3,"path":"1-02-16-file-streams.md","ref":"./1-02-16-file-streams.md","articles":[]},{"title":"Binary Streams","level":"3.1.2.17","depth":3,"path":"1-02-17-binary-streams.md","ref":"./1-02-17-binary-streams.md","articles":[]},{"title":"Prompting Users","level":"3.1.2.18","depth":3,"path":"1-02-18-prompting-users.md","ref":"./1-02-18-prompting-users.md","articles":[]},{"title":"Pretty-Printing","level":"3.1.2.19","depth":3,"path":"1-02-19-pretty-printing.md","ref":"./1-02-19-pretty-printing.md","articles":[]}]},{"title":"Extra Credit: Getting Input from Users","level":"3.1.3","depth":2,"path":"1-03-0-getting-input-from-users.md","ref":"./1-03-0-getting-input-from-users.md","articles":[]},{"title":"Lists and List-Operations","level":"3.1.4","depth":2,"path":"1-04-0-lists.md","ref":"./1-04-0-lists.md","articles":[]},{"title":"Extra Credit: Look-up Lists and Trees","level":"3.1.5","depth":2,"path":"1-05-0-lookups-trees.md","ref":"./1-05-0-lookups-trees.md","articles":[]},{"title":"Numbers and Math","level":"3.1.6","depth":2,"path":"1-06-0-math.md","ref":"./1-06-0-math.md","articles":[{"title":"Integers","level":"3.1.6.1","depth":3,"path":"1-06-01-integers.md","ref":"./1-06-01-integers.md","articles":[]},{"title":"More Integers","level":"3.1.6.2","depth":3,"path":"1-06-02-more-integers.md","ref":"./1-06-02-more-integers.md","articles":[]},{"title":"Hexadecimal Integer Notation","level":"3.1.6.3","depth":3,"path":"1-06-03-hexadecimal-notation.md","ref":"./1-06-03-hexadecimal-notation.md","articles":[]},{"title":"Octal Integer Notation","level":"3.1.6.4","depth":3,"path":"1-06-04-octal-notation.md","ref":"./1-06-04-octal-notation.md","articles":[]},{"title":"Binary Integer Notation","level":"3.1.6.5","depth":3,"path":"1-06-05-binary-notation.md","ref":"./1-06-05-binary-notation.md","articles":[]},{"title":"Ratios and Rational Numbers","level":"3.1.6.6","depth":3,"path":"1-06-06-ratios.md","ref":"./1-06-06-ratios.md","articles":[]},{"title":"Floating-point Numbers","level":"3.1.6.7","depth":3,"path":"1-06-07-floating-point.md","ref":"./1-06-07-floating-point.md","articles":[]},{"title":"Numeric Constants","level":"3.1.6.8","depth":3,"path":"1-06-08-constants.md","ref":"./1-06-08-constants.md","articles":[]},{"title":"Complex Numbers","level":"3.1.6.9","depth":3,"path":"1-06-09-complex-numbers.md","ref":"./1-06-09-complex-numbers.md","articles":[]},{"title":"Arithmetic","level":"3.1.6.10","depth":3,"path":"1-06-10-arithmetic.md","ref":"./1-06-10-arithmetic.md","articles":[]},{"title":"More Arithmetic","level":"3.1.6.11","depth":3,"path":"1-06-11-more-arithmetic.md","ref":"./1-06-11-more-arithmetic.md","articles":[]},{"title":"Even More Arithmetic","level":"3.1.6.12","depth":3,"path":"1-06-12-even-more-arithmetic.md","ref":"./1-06-12-even-more-arithmetic.md","articles":[]},{"title":"Exponents","level":"3.1.6.13","depth":3,"path":"1-06-13-exponents.md","ref":"./1-06-13-exponents.md","articles":[]},{"title":"Logarithms","level":"3.1.6.14","depth":3,"path":"1-06-14-logarithms.md","ref":"./1-06-14-logarithms.md","articles":[]},{"title":"Trigonometry","level":"3.1.6.15","depth":3,"path":"1-06-15-trigonometry.md","ref":"./1-06-15-trigonometry.md","articles":[]},{"title":"Pseudo-Random Numbers","level":"3.1.6.16","depth":3,"path":"1-06-16-psuedorandom-numbers.md","ref":"./1-06-16-psuedorandom-numbers.md","articles":[]}]},{"title":"Extra Credit: Arrays and Vectors","level":"3.1.7","depth":2,"path":"1-07-0-arrays.md","ref":"./1-07-0-arrays.md","articles":[]},{"title":"Variables, Parameters, and Constants","level":"3.1.8","depth":2,"path":"1-08-0-variables.md","ref":"./1-08-0-variables.md","articles":[]},{"title":"Extra Credit: Closures","level":"3.1.9","depth":2,"path":"1-09-0-closures.md","ref":"./1-09-0-closures.md","articles":[]},{"title":"Functions and Macros","level":"3.1.10","depth":2,"path":"1-10-0-functions.md","ref":"./1-10-0-functions.md","articles":[]},{"title":"Extra Credit: A Simple Text Adventure","level":"3.1.11","depth":2,"path":"1-11-0-text-adventure.md","ref":"./1-11-0-text-adventure.md","articles":[]},{"title":"Namespaces, Symbols, Packages, and Systems","level":"3.1.12","depth":2,"path":"1-12-0-namespaces.md","ref":"./1-12-0-namespaces.md","articles":[]},{"title":"Extra Credit: A Simple Web Application","level":"3.1.13","depth":2,"path":"1-13-0-simple-web-app.md","ref":"./1-13-0-simple-web-app.md","articles":[]},{"title":"Conditionals","level":"3.1.14","depth":2,"path":"1-14-0-conditionals.md","ref":"./1-14-0-conditionals.md","articles":[]},{"title":"Extra Credit: Command-Line Utilities","level":"3.1.15","depth":2,"path":"1-15-0-command-line-utility.md","ref":"./1-15-0-command-line-utility.md","articles":[]},{"title":"Mapping and Looping","level":"3.1.16","depth":2,"path":"1-16-0-map-loop.md","ref":"./1-16-0-map-loop.md","articles":[]},{"title":"Extra Credit: Revisiting Loops with Iterate","level":"3.1.17","depth":2,"path":"1-17-0-iterate.md","ref":"./1-17-0-iterate.md","articles":[]},{"title":"Format Strings","level":"3.1.18","depth":2,"path":"1-18-0-format.md","ref":"./1-18-0-format.md","articles":[]},{"title":"Extra Credit: Domain Specific Languages","level":"3.1.19","depth":2,"path":"1-19-0-dsl.md","ref":"./1-19-0-dsl.md","articles":[]},{"title":"Part One in Review","level":"3.1.20","depth":2,"path":"1-20-0-review.md","ref":"./1-20-0-review.md","articles":[]}]},"previous":{"title":"Lisp: A Future History","level":"2.4","depth":1,"path":"introduction.md","ref":"introduction.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"acknowledgements.md","mtime":"2022-08-23T00:01:55.640Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/gitbook/fonts/fontawesome/fontawesome-webfont.eot? b/clones/llthw.common-lisp.dev/gitbook/fonts/fontawesome/fontawesome-webfont.eot?
new file mode 100644
index 0000000000000000000000000000000000000000..c7b00d2ba8896fd29de846b19f89fcf0d56ad152
GIT binary patch
literal 76518
zcmZ^JRZtvU(B;hF?rsAN?(R0YJHg%EL-4`f-QC?GxVuBJBzSNO0TKw=Z@2d0uiDz~
z>N?%0@9pZhTXpN4G6MmC{{r-%!vp@O0Rbuhwcr6N8vm31-}!&^|1owS^ws~H{tqAo
z$N}5{t^jX<6yPJk2H^Ey<?<f_0GI%+|IiNL18@dd06hO=AOOAp7|;LCIQ*YGU;r<G
z9l-xz@BqL7ZU85M>%R&Bp#T5O1phx10RX7B{Qt8t9Pl**$n*kadIQ|f;xC*hEUn@g
zl*^#1p2$%G{Blbw#9Q*e6@DYa223V18Ij|2&2%cPTvx@iNioUoZ)_KE6Q5=~WJfZ6
z@6#n=xTLp0OA@il+i|so^fL%AHC3|sOKFq@_?XQai){2qkS}<LEqfZ(UZu?78B25O
z-(D~b)*XzpWFCkmxOXwI=|>rMNBrJi`>xR3*k)Ld4_O*y=YyU9%ULX8Mt|3PGQJ(=
zu5_-C{h(64@}ws=y4%mO#^-0|S)8jKTS}tyTCRrQ#rm0C*{&43?>G$we1bThm2RqW
zr0DH!n;Ru#`mDbNA2wM$;x!?!a`4fw?Fo~yus67&r1abr>%F0xMWMH?N|{wiNZ+FY
zi_q&l)sRzB{O=MeHnz?|4E!7NzLgZx?>wKfMy~Tr<v1lrfDVJw5gal32%?U8Is!54
z5~`u(DiXFR6mS8Eh{G<814p7VmZJ(r##revH7r;@o#P1D5orH>DUE27f?^!K0pcyz
zKgVg~jz3oin*6AlFIecSs@o*bYRurv(wa@E+g$K~!LjVYF|>8*mz38zvT0|~_Z9-@
zFpwD~_2L(!Y&LKA6%F~|!5SJ(mBsg47{V^nyZ*x17OEqVyB;cG?Qs2f_ZtmwuJ*$;
zrV4&09S><k(iF>ZcsCt|3)l&E7&8T&q9=-bJiHDK3=i=dX9doW52uEMp^BA|^$Stu
z_bobQ9n=z83Z~xpsct18Hw06@v%p4TXJGmaJEDy&(-v74j^{YHE3)iSLyj)+MAzaq
zSB+BK=7$bIV5~T@od+AQJY2H9n&J;sL(S53?(5d<&xHEKF#(AEjDF0n9Jl27)uNRn
z=Zqk(EM~|62JY~o@N;`C!oum~!C=AiA|~s%&&I<OqHhoQ_=f%e0PE*Qi2ail7c7Dz
zBgYpEb^ku`{q$=@9B<sJQ#)H1F?O>k>G**GymPqvB`PYqZ;u*QIa+@iL!)+*8P-7K
zBA6oelJuQCvn?-o2%~luo8?Xb+G!NZ!7(~d1g2ttZM_#V^1$i{p!Qb*N$?!^+u*hF
zV7O^eAoMadrY~~UdHTy?%pjJPqalWC^&_g56Y~m9&?E}nU5>dTmN*NFuSg;4cIJNE
z2^EiW?@vNZ#r<pbwZlhE(SJpgDX)MKo)#*Wc=XMcVu>%d;BJ`>nq>m?N?9aCRC>Eh
zlV6Ugn6XebS>cYT-zx{MC|>X&wjrrzRb@<5rN9sBgK3+zcK*f~#(jWcq}V82ZaN6!
z3x!(uoZC?rX`+`TZExW@B_Jd`o0*~rUKsn%1&5+DXP_)=VVN6Rw_<%|IIeJXU{K?4
zkvpJ6ee4r5g*02SaFM0f$+GrDNoKlJ$fXCjeyCd_b;&|GDk?G#%7IhpGA~XrsRNoT
zSn_IST!)8|RdNz{EK?$GHsh7BU%UL{N}W5${L)#YgMB{m(WaRfq+Ozk=>6yo6i(u{
zf(b&PyZaNLrRm8d?nLwm4RCW`F=y{wXwBU<1oh#53u%tXKBrZtC;g$CQwJ|3=?DCD
zerFLv5RFMpC{V>kQ+TCYW{$YVXPdLvhk1i?2BH7*5zlBC=Eg2pWli#0yzi%PDl04!
zX&Dv67bLYow-X+mpm<<d)RJI(1Zia4)i>KPeKlSsQEOh60QCqd>_Y|7@=xfK+ngw^
zD9o5yHpH4sx!(oAf3Z~ut%84X+V41Y!;?fEQq#q#+CzZ?=oBqWXmCht%;@0qn-pXU
z6&ZLq5MdGq=bNj3NOl3&${$YR2TE&Oh0hG0G2EOV^jo8A(1&R<EC{XyN<Zfl2viTH
ze}H`A)~#IiU~kc}Cxg-#%uy3o5sq=i+D;JhXS`D~>ttcnDJzR-h1D#R0}zqpfOicY
zzq2MeIM+kW>E-B>q$uKRN2tGiHnK}WNo6&OL>_<E_Y<46C_(s&%@NMXT7#!zq#9va
z#4&@?gJEEiabc_0SJyK;YQG@8YEX<{d+3ahhzNrFP5CPUc}5$7e<PcvZc#xERi>t;
zV1rZISSu}XgE-OkNg2_I@hb}1C?6<}M=_hc-{W8<k2vO*6#{J7<BwlSv)}WI9!L69
zufx^TEKqe}5S2x+mHMN1{`lAmfe1mXq>hM8NN;GYL+>#KK0dwCHrBex*Uqk)i)Dqd
zU#lhxdi%<zG*ON!2A}cDN7z&PZI_i$p%N`mU4e=z-8=1_VWGr_!<{{`-Ju#i*Ik4D
z?Ou`Qnnsh3@=chssJU*I<g8FZCLfg<fV^LO9~hGh2+a6Mwu(c;pX#Q)-fpWfRVFv%
zTOPR$Zn2Noqih?9;x+VIR#sU{=PFoUKf~y2N;drv8cguOR%&i4$UATyh))5TPzN%r
zbDt{kgjaLYe3WMNJeg0$GOzX6S%BcKB~86yOs68B-Gq)b>Txp@ah5XeFm?k7_Yodp
z-!k}ec>%eSm}S5O#=xIi$W$Rq_rR|K6>k|OA9X3z72fKks33U6BPZizFb_rTqPa<4
z;wu%~I7|kQWi{Idir_c6&L3<@%aS;uJbxr9td_oX+zt<aY33-u&z^7YxGTXVr}djh
zHZ8`89HFA_W=KX;Mw+~#{vj4(=834TkkSeLXCnJJ^z4H`F=c~$z>x@{eMop15cA&f
zZiD^v=IYY`&ql<af-tJJb>v@6!HQpzSQKsQBb<*bcP;=jaHWhB2F^2tHq%Km@FhCs
z{w($Y`FD&xEyPe52lc_;IpIF-4O|#a2C?nfX+bMIXiumj=O%J`M;E)dMDr)&@>{8C
z<PgGE!J)j@g9_p4X;j|$qfQ{!62b?D`Uu+h8J1B<sB4*i#{F&iQ4mG3D$MpGe#Z6$
zla!P9*A)*s@7(A`npGNkF{ZEla3E?~b7IXb3rxGhhYj&IoixPhK<h=G5~ce_JjhvV
zCv~pQECXgev>3)nyTY?5I}>~fhpzYH!hfU7Dx2qW9CttqrJKu+NeWg8bK1ldYw%>#
z7D=t1FVzX${`^Rx_Q-`n#>5qB3-9K1!*Xpt%P!%+rm=Mzdi@Jv-Mdm(4nC<T#}ndL
zEv6o9=~Lk4Kh^m=ijsYh$8t&RV`f6n<@`;oCEuq-s6TkVNJLH7YfX`v0W&J;=j1nB
zj8OZ=c3iWty|%eLIX~tw655rlq&fM#o;@Q9gOOpNDUP5?yiiN2e8hHSLFiBMtbJ#5
zgBDtD0?Ka+c(erc4QLJE6voc9%zC@|$Im>kDi1#eo>L7qH7Xc{4y>=Zeb+Acl}PCs
zP|AstTnUNT8LcRAh$XiY&;YtB)*~5^(DOj|p#-~{ESml1S>;0Ihcen0Y@f$jkYvz2
zlW{_1tCm4;<wOlGg0#jTED`*yZdjqN$Qv07Kzz1U3hpt6HkZelbCAEkp>RV=Sq@*X
zmZs7>+b|O^;)AHk%5D8>7yOUqk}r&jH`_jC_&4r<?2dT@gck`Gz<~@X8KIA#%nVAe
zw97%7@)1gu?TNE!f0GY!tPDk`b(v~o*zwRFbf!`_4j<Dj6*`5IH;8L>N32Ui<x+<w
z0KvZ2gB9$K#~wZn?BXFA3W5)tb)0>k1G+>)%Ej{3OW%M*irgZsH)L#PyqEESx$?Bw
z(TuNjVL(pLO3PO3^)xyaV&7$hStYhzf%C&8Z|?JwE{VP<vQ?8@u3Ak4a-s_dL7dZ<
z(8~KTVFDrUg~WepH@1-~NkaVH-e3v}c}joxYTVSQA__y-_a0(H-4JOMHoruxVMUX|
z!PK=?w(KA@rpQkzdyj9ENbvY8>%s5F$D11$(l8@ST;pbV_A!S5i<$-LImWb|qUoY(
zgN-4291V9tZkzizQhq=oU!hNIw6!x{8rp<kdQ42H11Vz`dmyI=y~762zfRwj6_rw?
zGf$CYB{Fyi!Od5OHv0(l$yxirXX&u)mFq#gfy!An$$=>t=AC4u-<IhPUBlods9fZu
z(zEZ!RzB*^D|(_N<hss%+@Ls#8WVV}Dpv(<VRc6vsRycmiz#ctyvzek=`DMwn(i`#
z9|nzsxDSvrqqr_}Vo<+OmD}E%rjuu_yln7-cb!>pxG>Xjeqc9#7@E!m<4@k`?Xc3L
zGW*|?jHH~P{52A-aV(Q#{5es%%#G>8C-I`9`^(zDzJgCtLZ*03KIvH6jYvVe<N4d<
zpWV^Qrm5>~m9=<aXmzEGm5NtXBt*7XE!CgHtfA<DJ(9s$R$)!_Bi)Z_Q1c!PEttUW
z^g9~2ANw+^c2|0w{0{9UKwGoe8v^CNRn!dvfF-cB(ws0-r%-;=%DEXLhY@oF$x(Cf
zI+O?@_3(6StNeP%-->u?k})-Q$0N@CYmQMic;bnk2iJ>Vm8OKV6M&st{n4thcQ|8w
z7ghMeK(fX}mM?x8ly1=nqrOKo4P7{=2?9!(bUPhZ*cvf1)bY705uSXn9{deye9J<Z
z-@5WnKCs*k2d3M@3Zbq6SU=2%Cx~H;ajA@{84`b#bq{{y7Kh0myW!mfYz%n53^Ebx
z%wERrtXmtnq@G(XJ&mh9OFEW(+OIObN`~}I_t;q^49n1vm`kDju-$K&g{`l%Rvnfl
zK!R;_l5qFEmSeZf_#OW&I|!2qh4GBdzZC_fTkHQVjtL9pmA{1^zNxtTev<6sp^!U@
zGP9MM{9JV)BwZ2yoCh*~yvqzqP3EH{qoeKQ9MF`kW#qrlOz3tutZJov+T2)RPUKus
zAsY}H*|y{j^~(8tv<TdGIDZ|Vp@ddOe?VU&{;~@3(=(}W&N8r>velcco2b>1-ZJ}k
zFmR^35d_{lz01HTCO8%h4`fhpf)ySyi8hqDTcE(`V1*98k+0cyKPG&<t^5DY)m!6W
zDD$UaXuO9FU-#a+^F>K99MoPzY8H%gq4+vdug@>y;9pP%`0(vW5A;I|G%#vZOyK?F
z*(Px`vSR3C5JU%x4YH49uOow^77PJrF!ST?xHI~)rAc748p=xY%*3S*Qe3gKQg@pK
z49qeg8DkFigyGW><?6xTBO+w5QEOXww@mu6yw+w)wYuYEbW?oQ3@Ax(az^Q7b!d-9
zAiB;B$h3VyRyWo`0*;71Ebgz#mgDWKmiS-nKZcA1{B7SNkKG{<M;LSD?;AeQKEGqc
z`}EBiY8qb4X#b<dRj!;Rj@K2NN8Vp?_i4Tgs<#1cQhhvTmnEC37001T{#pAoY)SS}
zW0W6Z^}+p5yq!_bg387#H;Ud*@Lv;#eLd=Cdn32jW}d0P>y@|>zttBjSBN$SjknA5
z{#6t?XWP<2GvG6%gog<3*CmZL3)K(*_U>y|<wx%ajXvwMd4y8Zz}QMrgU<0#aI6}Y
zHQ|kU)q99F4iSOQavB5u2$5pU3@B$*B=_-Gd8Ul3vlO}T*U{-l;ba|E5uGVhhG{E`
z@55&*SU*a&J3sN`P&R#MNno2a1;3;1-ymn+dnvYqAB)p5Xvk38tXVU+G~*;gj7mbP
zs+NOW+>O^fpiv&bA|&5RY{7dxl^*^+goJg2=$S8q^swAAT(IoKD~`el<+<NqTTUyJ
zrdkUmqIvUNXZWpRYa2!;JXPsTbIZBgrz8}wYp>KI_b*qBp>Acw-d+=MRc4pnDWkV_
zE<-7i*`{-C#UsdI++oxdg-81&2=U7rtwb-4H(MnnJFYlY>jaoE&5kQC`6+!hPo3Y=
zbuYPeeaqMB&TtQ&zTJL@@s|{*iX`!P3ws)`oD8McaxEUl1P{3{P07T?i$-JOq)JIq
zgRQ`>ilyi5qi{KImy=g-y`U>FT$K`LUty3n>wG0d8N(dMSlmUn^@~JG65S6ak|v%X
z>G(IGs&}$r%!vWT1Fm@Eha|%nDG3II4qI;L3SHk4It}(`fHB3W@{Sx7Sz$$dK@)6~
zEMrYY=)_JoWHFc&Jy?*ozRL{n7UPAF_`8^_cxG5<(O0-YRVl5KkW}e?m3H!uh08E4
zcuqC?kiQ;5F5;Uerw;!g2G^M+XHOwy8XWG2d~gLlX^queZie2A3fFhiW7Jlz$8JSG
zZRy9o7nLFKFwK`I7JA_bG3~WM_|p1alZ)@~b;Mw<CNx<gNsLeRwZG@Mjkb@v6{IJ4
z4OEky_1cNXf=@+zYf~Uu5_B3w+&c>Ewv72`+N5ZECd|CyvsQNlYuxb%h{b6L)Yd4j
zJr90~RK>_YG^dJlW#khv(r~oQlosf#7ncRUWMR-q=P~X_f_i#ftf&oHchD~dt_g2A
z%SjtjfmS3Prw1h?V=Cl(OvJnPtL6{wwiNU}Qf(Vpe;`IjHGyRu^~q>>+p0uU2lw$x
zzX{EKe%A>2&+cpPB+z2=wR_UL_kp=Ktw&-BlZ(aDP&&}Rk9}#xnfy``eTj|gL?Rz;
zq5Rvq?aipr>Vy{d#RXNkh3YsJ+s}1u62e(X+T!j+fEOV-9x?NQ(Bk{uiNF@>*)Y@8
zK5|n2^0F4<(YBlU((CA|SGy|XtPpi{lvjSEv=Alv4>(f+IrX7c@bO2+5m;?P0&{fX
zxMlz*4#<E$9Ey^2|Bmc{5~>ik)>qCBM1YKaeT#(BXZ9Hf^y#EuDS{@-PIFz=<>Z4a
zaIz;#wAF~((i*{OJl~6H8L-h5knI+m*+y3Y)%XfVBDmPk^kz}>xpPodw4Vy%M+srn
zfa$)D7(JGeS`AZy<*vyv5lX1n@N`g>rDmI+t#5>9;vOmnHoYtg7Yv}5p7P2yCcRW|
zzlUBs$qrUX{3nw|v~_f`>(SgZ`Qa4+Tx1c*l+IzVLbwvDr;P1?$^^UUn!-^}@8Xnm
z%fd~=#ZUe-g`*?%S`N1GieL}Lb3o(#AsixR+*z4YGbFTgCQQT#pN*A}NAQIru4^_Q
zfGfqz&^(HDzlOh9nRMIRoK5pphXL(PjR^nzg-K|CT`_RkoAZ+(ni{!)1(8u4%#Ssa
zc8wPx(53`h2TV}su1f_>Xz;<;0JgxwSB_oVqd;c2Dhi)MZS6Xd44JM+PmT7)IS6ju
zrIlm;LReLX))zEtCvMC)>Sk4~wk0I`<4^kT@r8PsP{OfG?uC<28Hf$2oSF$cn$F+o
zG1)UiCyfq0t*RJBr7TA_ry@;aEmIS=;e)hq8My+vN-x70gEOKQIsIlGhsWQBCQ^h)
zW^)Cxr9?04EB4#0R0d^BS)IE<j|cUYyy3MxgBxc+y3gLAU#Exk-qzgkE*|wY;qCUV
z>zHm03mqmV4k(Y&49K$a)lfPC7}=$Pb{vS!aGJUz8u{xMruX(ZtQ$Vupj8u)z@a(<
zp2!M<olv!!eZASX6%m?q7SUi~3Zh<H3JJzeZx$L^ASCF**RNx*ca$z+YF!D8Q8Qu0
zNVi0^t;~8S;XjV-X{?c99gKu84Sh{O$8DBH2v>SE5l0Ph1{$p_A^p{yDwt=0Nu%Y}
zF5A7rB?;Mo@{eMwB!WE>5v-n-LtHT*sF}nfV1vaYt2(D26~VK_<qPe^RAF5&yU=Ct
zEnQ9ucX$flHZqMe25ljxI)yLF&b6EwJ8-zEaXk1`M5PTgT1Sa==0-NO7YSdDCh&aB
zVS)UbYzeDX0j`W&rpEkfPC^kQolCh%u<o(-pFM2r!#j&UuUoWlI{V}wo(v?$9D9Ut
zbsa~p^YxtTI@JL8e1<=jKf?;@v=hnj_9<`}gX--j!jz}<zO-T5>9Aos3VD(LL+qC(
zi;TPVQDWu#gBs})2zSe}9{sPpWd8|~1u=Jd*KFN%4FR`%Whxfr#}0H@%bb<?hXg(i
z$2E&t<Y(&6peYpx_y_X+c7ZD3BWh5nmhgU#?W{1RgiqhFRO26H1_??Uy~xUzOY~~&
zxNM`wV&p2&AjPY+U}tc!k%k`aARypFQCFw7R#<J`#;Ci^eY>CFGAM^X*lh$E+~aZQ
zXaUMlg<>2!by_7y1^eYlKdJos+F357hHF;RLdIlp@q3ddq;(KnP;bE{U5|d;1@D=w
zV>w)+K=!izn^)|>yBED~<j0ACc3*OVuYq&$iK`%AYwY@nIr?1c!}l*dPteR<B!<?q
zM12|B7Zx=Pd2_YjSacb<`pD<*R}jfj*SoBxQ#%zIix0xatOXecQZ{9K^{6z}4lP;m
z@tY_u6`^K0&Igv=+t*uQlr*K?ioe7kVla+Ts}!Wl+WV^$?{1hT;IS6Y3W3WEUOsH~
zL!_IWNozSet#MEZ_A7K`H3S*tb@bWZv~68P3@P;O<)qFX9f-|N%4ZD{sWRG#Btk{J
zi28t~D7{pIMwoORE{=ws<m~<GV`e*@93~Ak^PXM3YdVNT4o$Y)Z4b9jgWd~1*VBRo
zjIoB^SaKjEZr)?B&FGgB&HWF~=(2RIYv87o!ZjtFE_r3OJ_K9;-QytvuFU=5VY*(>
z5=r>LT7R54^@n!+@L61Y(Pw%u<Iwm>I-+@hw1~cV^8&2|fKr~4B(av<M2-(->!>$7
zrC(%zIs2p<y!_=d9K0Sj^<fEaxRfc*$kxNYZi;#vEkFn#L8(wU$ir{T2f)tUw_Lrb
zy-<{1m7o&SF*QlbsKGPyD=t_;_D6&eeJ@MGD^Z#}-U@{<gK5@{YYMZMoxN14_b#x`
zxea7$g<8gcgKI3}EU7~6RIY&zlD&ZIOXBW%QR2O;?FGm6U;Tp2A>NRwxiKNbtMy$>
zWtRM|L$1SJq!e6jiW^Rw%*s1-A{;-ulF{wX!>~nrl)Gi7bim2+gGp_F6|cOET9-MC
zIR7|-f0wiM>m?Oe^MJ*h^Gy_KK5cFLI_lfek(OL?t(NJUzeC$3`DCWWB6oxc?<LwC
zEkNE%$71jTT-f0t$Vl!~s6<LqlE^4lM_4c~;YG$~D4A9>t)4SW$=c1L-XR?gKjR6Z
z%?e3HKEkP$k8_FS8)D)1M++Ye?E;^@B2atFY;JXYNvE_jX|4nLe+4`QlIoU#r7-ZN
z9w%ORF!TdEE32>(PP*9f!4+1ypjF8X34VRdCG>HWCXSZ+4n3H)>6&dLmDWrcE<W1I
zT}Exjgt^4nJ5mR?_PBJu!8<URMpPxh9oG%IPD`-&A#KrIOmKM7M!M&g{Hha>a$2m$
z<{P|tfdhbDou2!+3#eDom0vm@rRTzdaNf?nr%1`}2fuAx?vw1XxNjyCVu`X4lfCPO
zQw{A&4#6$$$uk_U2))K_Xp5H)Ynj;M%OG+#5wovXa41<AFC}#m`A)|HYW{@%5`EN<
zBpsM@_=nh8id~-&35u9@=mW6aL?)ZXJ8CnEQiMz$RJ7D<+;GkWc+}a_(DS4I2^o45
zn}7dA1;?CLC<L;SkOgL&6b;KKLt@BkmXxU2*6QD0D$2`|EyHM`Z45EQU9`Fao4LdY
zHRPLv3GTL-79Y_51qYcX=lxh5EpjTYy-!k`u%vG<H-+}!We27OTu=3NUT>ut|FriC
zZ5?nF#JuH|{ni@Rb1?Wt0L4ckFaEV!VW!ox)2vWV@m0ortHgG<(|&aztcf*qm+?!L
z)zAGm9oxG%PF6M%JF9lvlniIsGlaGwZ)XwlR?d=41aBnzLpe1FoItFRR;`$mDLx}A
zXs(tnZMYsu$8goUuhiJ6uK@{%@GO~1CH!K6;^W6x_<&#;VzU=8n&L{Tu=AvTmmg1Y
z%U|1*!pwm5>I!81otTNe4X4)T`r@h)MLmIfania|o4YiMP_|=}<j~TsGhg9HxsmRK
zr5THY29-|U1nM*Tk^)2aZk*~l|L0G&9kfbexreiTNlVTVG@&56DvjaLlO(H?2V$wE
zP<2wSW#eTSC{|jM7t35&4gTKV{o@EH%8j-;UHw}wtqAMgG3GIFco?4z6DiI-OD>*4
zm_pWIwxkEH#`m|aw5Oj2cV-uB#SJ`daQMf&=~kRF@3xsN+UR(DDz5Yk8lDcaoW=`$
z;qNA4Vl#=JGw=*2{Zi7KlpC7JONZ1XD_bq&cHo~j$03Xtp1(JuD@k*#UgfxYMp_f1
zHeEc9Kcgq&|B5(vDZy+(Etf2hJ>k|_^m5d}rVF#m0M#V`Q9`v_-A*{>_qn*375dUg
z20xPEwUamwFwVaNtLQZ3gYac3D)sy^c<-eomp&)JqaRT_aA6r=N2r6`KOM+GMJ=uR
zJJSx}{}`IzagvLgClXz7Op`%JxJVWdnAdVtZ1L!MfI<jTBrW?WlIz|Y?hh2B^WHee
zX5PXY5S=>pFd5$mbn)VtpZ2Dq#c};nB58w+tL1@BkvVm+h71i)<m5-M*cDu1jL$qu
z`6{P-*fd(qUdYLdDTi77c;Ri<9tV~%)-D;yG@TEXR4lSmewz|40goEbnFyV!eG2+4
zZ}6i13c1?PC6-Iw*xxk3aeY*&L|s7p3rvR?d7}m)o2w!q7CXi+y*y-DqeTIdq6UYm
z>f_rIG$a3$o<TO|hQU#1@5Br>)nd2gZCgqZg~DGttbCOjwn?T1fRRA~iA+N6zr-;&
z7UpcL;{pJJf)iyuS*g7~6!ti&x@hgZ#xgHB8ZB0#Wgu+Hz!hHcArgMW)f)z%?s16(
zJeG`Z`(w!uZJjB~*T>P26oGK0$6Ra+4CRgGJkwbG9@u7+)h--#OMaS^94%|>j;>R~
zT%qfgW0)@wi&e~`^<*MZCoDx~+mYuARSCYEm>;`|buUuX)z=r)Q}WwRB&Vel;HOqY
zt?1$U*XyTspA5UDMs;VDIKkBMCB~1`(9)wALGvaW59!Wb<X(-q1s*nBG@LfifmrFi
z^zmZxvF38`)K2N+@Mex4B(l(vSnr$&tm4yFKTi$|wp6K&1^~TM-uc!#ZxwgN+K#J^
zTwex;P1s+=PVph(ZbmVIfL<{I)C7M)A>3>nh!}Np-waLby1tarvXP0A|3ysMqsnTY
z7IT-5SgV|NZN3<9`r9|e9fK*l^~72~4KML@f2-=7XWD<6>M0GD5j6}OvWt#l46g@+
zBn=-(Fs@xS?n)J$Xr>RwZ_#oKk$->E5KPBlHq*q3&L}J6YBw6pbza1XN073{97~#q
zTReDJZ>6J@;i^yfR}+Lp_`&iT@`z?ozx07)PYkFJXy~x!aMN}S`gwL~_GHQp#>HGX
zc~A1Bx|bR2FLSL3hpVg$;3TbFS7q&}#y9$O_!03nh!J87!{4e<Ww7x6{FylPK<D`+
zOR>)7zFtHXwl@hB7Ltnv=C{#bIp5A)l^z}mW$@fR7r0bAlUmCVRMlibs5x5Fq4U26
zSFZIg+>*5IGz!0zBUOpKJ^_PQ{#c44>MBlmvZ+1}#mCe>UnZt2iU;`b4=Ks`%8=u9
z<thdu{|nXUD_ioYjK1!PWX@BoloHUl-c}ux<!muzal}sj{wS?ovqO(|W2&1YM8*Vn
zIFcJCVigK9K}is9t-t?ekqZTHDcsorPs9~*Ds_tgMwJA>$TmiTS2eHRY>QENc*e&d
zSDHMkA*D}>uf!<*^B@wSh<S`W^;KoWTz~()`zP(}u-Vk&;iylNQV3mvMJQPoQo=-}
z=~^YB!^sVoVObqGD>{4gG$_){w<$pQR|-hgLw&6qP`8Ot%3y;b<*UB2J;84$BC@z(
z0JW2)PBTCCKjX|mU582DgEFE<$JPnr*zT}0k1YqgH^4CNNRbg-kp)`adn6aOvc~Tn
z<LO?Ge#iR_Jtn<nXB!@^1fMVuNlk%lN`X1ehdk(|k_->Z**XdG-;klXk22VA)~sxk
zl~ViCm}zxxbQj#Q`nC&yi@#^Z4_kTje7HHX#Z9r)ohqOEbpwy|I29~GU6A64V_oa-
zLeTsWwy=D=%p;5cn~o;lcCmBai<ymCiU8SO=a(l_Yblio`LC)`%Uwr!=6UdHzw}=!
zNZ@FnDl?uq<H|&Ake+!Fvk3TW(FX9-U9K2~DFit9;kZ6cp7dkpAEw$c9$8##a5|OO
zq+NNgYzhy$H==+_L@^>2-3vZ%ow2_$y+$xZE9a9NyBP=T&sy)Ht&2m;fC*D$x5eeA
zk|-3we#iLoM>`ak;r{MPxn_C^#s}X4GPjq<$1sEism9i!lz}3?-rmuB8BWatzqo_u
zwojq@6^6W+?#sB(9A-t6S&x7YT$vmtWaS;So$z-~JKO2G?-jkjqh>t+a_WEt+UFN2
zX@i+V!X=T>N6gbBpMIqWgnj>PP)q5?JS)9!FEc|K<zsNYgKnzlY%9s<n^Mu_ywAtB
z@Yup^=VTQrcd#~+xy!9sk5W(KG*3tIOXXuVn~*=J=jAa#MmSufnU1&*NAn*a$bMK8
z-eI^c3F7vMU6fUlrCYSSW(wx%$fNGLqEyyLku``wzfL^Ef%}OnNZfDuU1rpfSve_f
zWvGdUmA3fB4L*MfP{7Yaawdto`z8-726`g>N!IE{ij84)nbj-Fp?IQ>I3o*tsg#=d
zduJ2{dC>k_+kw1CyPEmT_g$u?`dcCuf3qeu{4TTVg=R*}j9DycOo`bl2sfcvQuTPx
z?po`60aA%Z<-w~g69NG@P}incHlH&rU9IM^nT~4%9$7g<Nf8gnImdLAtEL*!Grd+O
zyh2S<DJ|pUtV6a=M|6vFET1^R6EmkvL9v2|rsfy3$<R?)LQ9~=qcid&$_I&e4@|DR
z<o&O1V^1I|W7^t^^{GvUykg`SQdR7WaL@vcRaTDEPY!nB^;~L2{TQ#C%k+qH!0#OK
zk!hxZJSvY~rtwJ=Vg;Fp+>^@?rS!(MqgRJAhv=01gvcsK9^v8!<Avlxv@g+e!D)Y7
z5lS=EPmps`XV7J1#Uq*=r$KYx30lW5YH8SHZ$1o1e|aB6k)5-o4h!bFq|m4&Ly4()
z*eLl=Jw(*CY@xG73ZyB;IG*azC{#<LOq45J(pN&>{G&A@>6m%IkksPO8n*BL%HvD+
z#1N7N*nuKngpyM}cTkz$mIui*s@j$rcOKW;h8LAWl|eNQQ+A}^V=lrg45+OX9s2t8
zAYKBQRcHvp{l_zqn{q94ZJm+Q9>$`T9V9WCTy`4=i*k~7emc>orp&GxoJ`xJ@4OpD
z*Rn@(dYy_9^u3@7bxh7W)JC(!q&=JLC9+=wxj+;eROQ*+{T{CIb;eL{Yt^8Zu`zc<
z6ptq)CN(2r-zo;gjze{^RT84YICc<D_+(@vTRsP%r?gVDS`r|Sr*E~yLqFIqZUSp9
zy-WLK*7?|wo)sG9oDeULEF$2Yt`97b@DJi5r#7iEqR+Xj?WvgmL4lSjE0(`?Xyv!w
z;VN8bS+ZU<m*Vrk=5oS)$^QuRVB&U%<h>amlGLO+%Gl7MtQj`-vwL7&?an*?+sn~_
zt`vD-=Lpc(ZfZb7+HU?4^Om-*0Q>zK1gOU&R;H*WI9<0)Hmhh?85x07-0Ho$td7vV
z(N&g`doL6KXLkkXfHP59hv<!IhX&%)AI5SUEKZS0hO#pigCzZ<Uo^{A(-j(;-KmpG
z)z?+>X-7jiW1H`QI3|tb3JWmwKYdXIJ_(}J1UBkge6&iZ6@DsuDW^%3T)knHF{CVE
z%`NIrU76*s&S;^Ux)-wRNNKGyW0@S~o%L&f=^6HwcK7Zq?`uX^n3EUiTSg#O631ZK
zhePX`V<*B=tqBB-E2jueWZP5<LgGf~no!#x4p^xfOeH54%$U8qBhP{9>*2ZYJqU~6
zBthp-#yiU7$bn-vlO{XhsQf+=_^5EWB&PL>(qQ{5(}N~^_l1F9M0crNEp74zU!CK*
z5+0OcMd~LgQO6}Z{I{s$OauK+_pEI+*`E%*Qhn)cU&#&3uVg2pro5A_Js>f_SFWf|
zcNd_qX(H_|;#0s#1?X5;oeHPuVm^XdAWkDlU6o`E4+fXA(tI=sV*EvvJr^BUTjg;L
zRc>*Ov4>gW1(e#kqZJaVa=D$r3@~-;gkt_7CDSb-BI5{CVU1xd=d>b)(K?zRSwgi;
z`Ov)Xqi6P9&?ZzD^ZS5DaAU6Ejbx1W#ue3tB)PPgx}pxC<ZHZa8$atg*2_yj-Z`oa
zn(B95T4)**Tq24?bc0rEZ!0p_Eq(R$08rtNJSNXJnw&=KqTm<Oo~qNAl>Wbnu{7TB
zT5)79g_Sw+<3?74^>ArZ=-u%^Ox&LRnZA_Wv>%$&R=L83HBq0j6kvSW#Y`0dvfYAc
zwucJsR2@!xnRV+ksY}=3*80R548sDS$t9ZDG;8|8%B_QsRz7bpV@d6C#Pe>TJ17NV
zPS3X<+Dsc$rV!d}7La2q#0e-;nkB=jzDzIWm*iXVnd2wUjl266^DEuOIvAzaYfAwS
zMT;_^d3Wa)Pky!*tkS+&(k!z>7*v2O5{HaDz>TOYWc__NV^L^s&?A|2sO6nge%=ZY
z0|*A1n5qp&3XBKw*I0a1{O6+qroT(KmtZX$cGrM3Cg$8Q|B<w!r}?1s*MX-1G5%rU
zQ@iRX%q1qQdN=u<?Kc^Fuy%Kj5;4Gsj#5`t<^XY96VaC6pb!?tH0NhWI*Dr31`frr
z4m=a+IAh8MS>oVSrxnyM{uJ1TS$$|R;P07KaK|`q;h~KgahRhdM`*O!*o`&YmZ&TQ
zqx;X%9TI=&7eKZ$4H7tc@D6&*;=-7Vy_b6lfPYR&;r=jkYmHTbNnt8oB5s9!;m~48
z$T{?_x9Q>K5M&bdQD-N^4`e&2_iG-nl?uBCnu2-7t7;W(f&r*Faq}WFqxK}fGayft
z)2xxKu59kD<kX>-q$3x{4Id}%C@T?h4XV#XZE-RCr=F1}H^Y)jtRPPxHA0Uo&r+>O
z0g7T-m&;kfeyy1b(v1=qefXt98L}400}2#KTYOa9QP!$zVVa@l5Y3dB@kZoAmfX;R
zV>upE4WL$a_v6;N{@Q_<D{0O$JZ$sA^n+S)$h^~JqYfLO%0d=uv=4;kn<Eq%M<O-I
zeua4r2`Tbxn7Ghp86hjyuXsXmIbDpPneAjkxg>c2W1j3eW!$A88^N)*fdVT@zQkh3
zD*h+>;mydfvTvZwH$P2qyUz32NAK$g^se~NX6Bn};&&J>)-!r#zd!ES@T-VVcuNTs
z#3gC0WlM5X0whJV-AePkU&L%;{d8M7f7)W0Ay~S2(YrCc*DcM5v;mz_CebG?Xs89k
zw05F#M-qY;kE59naU7lOpeuO=QLnK{-i<-p@Ay#T@|5$}Fj$R~H?NH10z49&!d6^B
z7n)z_l=cXO)^NZr8Dw;KfXn!?50wcGz&ra9b@*Wu5y+`MMSa;Q)WzaIzhKO+lgsA<
ztmylLs$4O^cLMW=H_M;8?{_5F@j7rXnqGDvw!<yYYK}>>?tPW}heo1^k*f(ZXkR-y
z&s+%>H#vA}82FR_f<s;EjOo{|lCX}8SJ1RwF7T6|G5a-nsH;L*Viw8<wJ*prMnj0k
z__9gV@nl$m;~~+%z0v>(62_G4ts@x96YP>D3#@P<E>#f~cVJ~wNclR8P|^=TnxtH0
z!SXNPWDbP}(x}4cl|*h>{AkXKosER(+hLI#U!h1gw-EpNa#Cs03vcWxb6)|ux6snx
z?6YA;_4JOl@3*v+FocRkjV?s`#G<Zg6skfjNr{nAFDVLDNkRO$Rq+D;Nm3`*nBbpV
zEFZN`ai4h?m-7)t%0Hy47bzHqmDB-h2A^$tmCSh#gKX$^r9kq3Y0@3M@BzI@nlhw*
z-x;J1+fegH8%`zx@SZItjibQVAA8ILMTgj7fm>q{Lt)Am#mh`=sS>v82BBS)aD=Pp
z56y9Gct{k#+V=4#Ai|?q1q~N!V(!DfRu2XB3#SdAvc@ILjAo9ZvL44{LX`_S{@}91
zfLN7!wAQV06aYK5yr|AwF1hQ8*Ewn1<!aA^V&xwl{3|#nEIvMYfSF7tck~~sLgGmF
zrEa4kjY)0PZS+QYRDp-TLdWQ=C^dYoDxPCCmuae8#)vJ`c*i#{T)dj3H-SlK!s8PS
z_dTU2b%pza#OlnYB=sd{m%WyHiIPL)&#RJ@*#uP9KZ!T^ef5FTct2$`^Mow{A0p{j
zvIDebva<4B@<lrzaX|<XioPH%cvw3&S)+L*k>{%4<c8kgBRXM&B<GQWsjBoa?8e07
z)488o49Q3EAPH0x-2?T^CA06Cxj^#jx)`d`p|EoRelZt3m34b)!oIup2%hAFRHkvl
z@k2HC8g9uS8a@GFBo5A=2P8#8V_b@}lRUsrdV!;txF+)DNN-;F^k)BIBlKRGH}mAu
zW@W4_gx#7SEz;gdHu8i1lD$Ed4=uIL=y<CHO-C$r%U)zRL@2Wzb(PHtl%^n-{Zu!~
zX{;JnHH}w-t1E*#honmtAB(&OkA(f%k*IAQ0z!6A|BNr<bzt9VIH=6cO16;%u*%Jg
zM2cmEy!BhNjP1?-Ie@>(E%WPGXFcIMpF`Z8vXejimaC6#84x0ML*)wNq|d{d@v1!m
zby#$pb&l6P)aA0emeBo4ba?37pl?(#?p1N&$x@}a$)IVs@2S(xN+5tI-GG8^&y&&n
z&A+pD{IhPB&D{;zMrD{lhNURjPETasrX4R1uGuLkEib<iu=!DiGVM<)$s!PpKaha@
zcmeVueyI4p1eEWKf1-j7V@5GCDG-11+BynDWNGMPgtb;PhK7F$Jnko>=3f#TY9&6!
ze2&2$z}3R(a8k&G6q^`8kSig0ykqA9hf^5A)l7B5PH;+|<jRhAn~NYvb0yXqP^J{s
z(wFoA-m#k`|5B)!y~&TD#~5w%y&%iq&V6=LOUnSVJ^*M7*MSC>14qC6xgA6)^odb+
z!cfr{LF%gp?8;5^x?{Mk<D<`+0{-C+OBr&#T&z+7jyV}!eQ!_8I0HNCqVOWN?|{s)
zzUj2T9mz>Yt0&vvASrI^3q}VHY7l`GoV_y#EF8<Jv<uWFMnM?C3gEC0!TnZ#N~+BP
zb_L6*&F!GC3IUQ*!Bw4IiR&_4e{4K@)Bl{<RynMAxaoH{$clEQnMN0#56tBkaZ!dc
z_F#-rx;ZaZV8k{F0>3~NB0Ubl)E6~1Q=JFOq0Z6T44Kw#3WLy5tGrJ*^95D?mxR(m
zE0S>-2bJ0m-;E(Wn5@XSWW!OlRRWDCRcLhp1%O$TK<9~AWI4mt>f^K$i8Mmm>e&-{
zE=KIM7<r5<0rJXy2z%HTUu5A6_n!2f>Jz!v>+P#6pfhH~uEF9u)Qb`C_Z6W#$yrOb
z??i}Sau93jat+Q&t}qG42(E7Aes*_2m#Z7i#}&C(4Pd4G(7vGts2nLsO-cK05Z@pC
zEfQs7vPJeA(b|qp_uq{$D8QCtCHB!Y=~=D46fj)#H5Z^gh*DREuh2?`K+vw+R>}C$
zR%n>vs4tlj)fF;u+q2R6IKG(`&tV5&(~*NG%!iXnPdh6ACF@j{+M~<eOYFvScAnRv
zzGT|VGb{o)?6K)DmqF-0tp&20kP5Is3Gxp<Ilek=4KX<(UXGq4!8I+L-gs7S&9$!g
zkYcGrgw;d9%D5`Qw}bmXf^m+1G-eQFHHIYw%kZgm$OYQjNa->gq0^vT<dmt51%g4Q
z&D>ifT`DzkCqV)_^<Ljbpro$-;nMyX3tvXLmfLD*7=_qXyhq+3<@DT@S|iC}cOsOM
z+7RM1n}j|U_nwl~^-PsImAtZ|TU=Q9N-E!Ige<mVGwKn3ei8+o<5n+cOgfS!L~Y2#
zBZmb3^l#rbR*8eOsS+V^8qdP~D+TBS#DHpofcpKS$Kx9r0CQ%GhhV`UZm$V(>*;_t
z?%X=Gw?Q~DzH^#b`oxY<OP=}f2RpBPz#xmQ!6%87RCd=>O=scL@~qpi;O&x;(<7Sj
z_1rYs5pajTzTPm~H$)6JQxH5^NRQWJA;k&&xH03VVec6yQgAM<kxTLP^x8vA1358r
z=;(;M@_DYZ-yF6<NhmNi*t;gkuhT!v$Eggz@Ds*oOvGYFlCjO@Kcn3c7#!mMlyR=-
zRMz2`++`ev&t$^2*i%oo$zOztzpPCb<}Vu~^ifG17!hTLBjvKvY8r#woR^CTBpXmF
z<7K5F9IPb0Fy+7Sd^cqDKDqvg2Z<JEis@~GielmlHDUxiRQKx1H9+o?7I3+N)>Zly
zFbO9!{1N&0s`b>i!5KWMewhlKV}y|>tMMcbvWb(=HnL1Z(po8oTFR#YKc9{)O=9NY
zD1awJo$R7)(V-0=pp!o&o`%NU4wGJx=ltqD?$!2{&Du^P69~sB)Jk=M&=N|3Oi*c!
zY`Ot%&<(AGrt5X*p|&Ni<X@y}{1^|uJRf-b!-MK@MRnTw^7H6<pjI6HAD`k|-S0Z}
z6^n&yhJ}c2M-EF0x|#uU#*6Ufu|_VG2~p1wYb0mPDAd^5Q0e72V~aY$;{K$kF%i)#
z02LIWy39j#m^#tZ8?P2q=^N=1zpo>GTw$O-uG-Z&BD*c7!vO1?-c_7C1-ePl&M^NZ
z@sV%Dh(*wq1~%oo%N|$$&$;`_rnx_Pu0Q&7GkswF1nI~y>t#ElK(6*9#$uK>sej#e
z<`2ZEq^EAM&sdme`&eIKG2d+o2>ulmh#=l<MBcOf?ad!<{W_VbF>a54V{Ho+GpZO9
zaAzHB%$GQuL;t#}c3v)y8h(F-P?ezCBiW#90Ou^qX_yY*u8HiYdx47YA<urK?i1T`
zKYoUmpxM3_Iw<}xP3&y=(plwC@HxVFZWwskXA|~V^(1{|Pw_Ltk`ft<eS&?$H)J3}
zhH?tku7?uC$$Cu&7)87M&6IuW^VG$L1%X1$L#yl+rzR{~*oeF40~>~HkP9NOB+JY2
ztxPT;X?H>ES(<}W0z3Xp=1|T(b;$`f9{fb?bpVf`q8S?;`D3jgk9cQ?-~G#k_>ad0
zpaR9ya?fYn05QYxp_78F^0)M)k+9wMYdzg+x=fJe_~J2pEz75!`W!*iTY7&~^ODkB
zSr`xUC;-j2#MtCVK5d3`(<DMl-eJILROfu7|JGZ0xvLH*i9mAfokg4P?Amk}J!`y?
zDi~11Er<R4!}%p5k-~s=VWfU2vsAZ1*R0>%M@u^2iRkvJ$Z!3eq3D99duVFa!VKM4
zTtt=2VgVw8tiWbn9u{zx=3$P<6mxLF8zWLpDsy|F&xIs$s=&&=(%sD1gsB3mPwW@?
z0W<{G-)JN;CjPK6df$c(Sno(3zZ8g9i}vLm4ud~Gpvqr&eim_#c+S8wt-QW8+a#F>
zE&OC*u%p6Gsj=$Q=*uT3E;`ZCQGL?LNPHJ+G}k5M@?k8^>XZH_=rT4(CdTLIGhNLQ
z`~-J{`z=&^-b5=(vC}&jk5p8o?SLAj%@@4)#HJNNLQk=Lch<&^g@FC%PDAa6JP|J^
zSZMpiOprq3QzV+Nx(K88S5XNI<I(0DrYBp}0gZqm!<WP(B)ODoTD!XSLdyV13fFbl
z^IKyY7HuR&6!=6+GAVP@A6~XPutg!j<oRna4*fuEAtO0!h2eX&j6zO@%3iz*ql(Aq
zprI#;&gZ}y28fWF-Nv+4UC6kVG~u7|n8zr~A42Z=nlD<<GQ~&vE`phGdjI{EjSHco
z#0cNXxE0}8zw|CzdCC!}><VMy`y87KFs9r)4PrA0jpDl|?RZ!iHH<K&!^Re)8S3*j
zhDqp33Wpd^oJ)Q$6CKrSpV{0pYyHGM<WgqwjxH+#Q5z_+^66(Op1gk`_(-2}Stkxb
z!)9m$`A0K+i}5%_dWD|bVCwj+J*b@mZsf|QL*$Nme;^iu$PnPM*n>S?oK40@+?U*t
zzI?Bk#)1L50E!au_7e16j8_urA2D4l`QOGA#^hP-YMSlKH6RJY3o91sPXDkB;vm(v
zTG~b~JW^K5r4U<JqA2vuk9f+Xe7~*~t5ij&1Hu%)f)&cJ%jxXs9-}mKCD00o)~yRm
z18&#d+V1(Q;NJD)o6L~40;q|X#(K#@OFs>7qd{iTKBS-~fn5kcl_zZpbdHA>h$RPM
zhAGVabHg-B!$YQbocLrTH1fzsPpgbh&J#}cVkrmM>PiCf&0`32@81ZEV{z705cex9
zo8y#4k#|Rh%$^?I<IOyev2-Y+jv-HUz&#KpU*GN^6Vs$ba3bmyk5G3Qv%r;aCOMn?
zd2{;a#rzyb(4`8xe=S|SH&57on)n8nNcAX-^${><E)A6tYe{z^Vq$;gbZKF2D{Xic
zRTLnAwR$$tkOm&LGhHsoJcr1c8Q3I7Xid7L+ikU}d;Lh!*hfr<r0tAm>(qt~3#xpY
z`ga*dx}*Qe=m0eTrFx!M*~5bE1b!2cDV5MEvukT}Kukems{D+PZZ1$lqBL{qoQg{v
zSdoWv+CjVvCTUjtN)`q(b@W1h)6EKzTep)p+Jsz1?v;PPNn0a!Cz|jd$e}8GPfQ`v
z!deRYNY{)rR_U@y_cuXj8w>?YZv>h~hx1p*m@XbVW3&v=+4kM0@{^DGESiWsG}?#a
zj+!6QJoxL2G70jbu(DNe=(;V8*r5iVSEm`Vmo|>yhpEL?_})!wX;4do?(->kenzh|
zEglV5Vg9fgOSn#X@Dj#m-iOJ!))PzWU?X5(N-s2-T$*wl=2m=>ViWiw(fzYb^jy&#
zRP*+blhO{`KD~w!(B<Z{YHZ;bs22HKq|}8HUmV?x2wtcl9UdJN;bDQ`cYnG*iBjsG
zD3=Fmdd$=m#m-(53`-L>k^jyy3ziqZr8wZCWN($i?z_)3&hV6E6HC76k;S?AKK2)?
zC^`K=9B-KOdI~i-a`&uJi<`uWx_G~Xi5}{8{9ybvoWz=fgq9no*8Ffqb9`)SL}u*I
zVHBft;EZjVy$=KocSUB+SSuoK9eH<c%j{qS6Ec92GM*(D=5P;9Yvk1_Iw+GMPs{Dn
zEHP9OR_u^p>;G6ZHbV+v{DLD>ksJ+oDEv%^GTl^%!?m&7#%$v&m{2N~mV3zVocl-e
zV$E)08eyW|u{O@|LNL4Pedz3z;q|e8$opdQJ>bM850y4<3a4$@UU;i@Z^2okY9_X9
zInWaI#=Ds1KXsqr*t{U&L&)}d(Ganur`4Et)Gk^}a@5fe?SEHtRIR|K@S`?(3dR;G
zQ85L%VQXlZGd3PeRfD^rql`8>*#k8tMD?7JIFlR5&;G=RQvE5bB`R~AQ&zey&)M8N
zEmm^+TeHNfcGz}HDa}l81`7#$k8*O&WVdxLJXe|@VX(6D^?z@B?u;uJ(olj{z7>su
zC#}J{XiIxi)Ox>Qq_!s&`LXCxOJJT0UX{!{smJz^cpN~UvmoD*uOL9MJ&X>=S@LO4
zF}!``sYN>GQOKYinj)}6efP7(#vq?rz<SgKmwnrvxzctR_XC<(9MWLH?mbRTgNTQD
zlf`u#Ep6gcZKa$XDF)RrDWr|{;E^}<mKP>R$0z(tvmmivrvTCX*)a50Puil%3zZx9
zC}pf?tOP5ly5v^a`zReScF^$gfDS>Vh|snQuCA4q$_But2oqTIdM9uYK(A=}%kIqA
zWU6Ym^qE!W#saA+-t2HcC>Z%ILxNZ?of8*M(756UfpyxbWXKf_xmr`}@Q!ues=l3i
zd`2dIZf*su00o8FDgyHR3i_#~yam8aa+NGS-_g<o+P|t0A{F?bQlPlFfpHIeurfdm
zlY^uDvuT%G)JZCdf5uVXi`9N63U}Gth3LiE+2;3=7>|%*;Qs<KK+eB3>EbH^vRD!%
z8azp}Uq^dJIqoBJP!RN8;(y^m{qks;&CwDzBpzX~DvzYDP~1Oh76FOElR5{Rrb!<X
zySjwnM0#YwEqWhNHo9AiS<t>3w-4fvF@7eof?Fh#GzcMlmaC^$4%N3nv%yb*Qre+m
zOpR57XcKI+1X9nd=poXR_~gI}VA7pWp=PGAuhu0X$y59FM|{~NUQYzm=*GF?!fnp2
z)((Y}BQ#t}Mtf(E2%7>oXDMDMFHpLfX22S99VnI|a5XwQ_aN}Je)*kZPo64HYEmrG
z8u3Yp&HG1$G*gi|{SXY|Nvp>tj>h5*JexR(ezb^gl$FISb|d>ZNkR&xFi)}Nm;;71
z;Gmf1O%R{V;{Rc4Qb*#b->^1(NgTwg(}FhHFlHL?*S!l;XZK~<=x9CK?kCV58c<a1
zB*}9=fMdZm=X#lLR1Vim#&t25G6N4Rvezv<DI@1@2vp_1R3{g>@H|y(ETCdqd9|^8
z1u7`r7(XTk`dPjJ2G)Ug6;-F1{b+vym)!KCR6yX(G5J%!ouIwIFqzVV*S9<hFZYG{
zR@PUuRvYCsH_%&3BvOX=ZD*Z#U)uy<6=Sg0{AqE=Pe`aW3D;-gNKkXdw0jbuQ62zT
zCVI)Q-zep>h2!0a>0;YjB?@cm!8IXljZR!dmD2>tN<@_GK`1>0Z_Q;vNx4u}=)CBN
ziwPa99Dh<=X;EOYJ!Hf|TV!XGVFSYz&fzIB(J%*&ihBz*7J32D!+iPn$st7oSYakZ
zEO5d;MuUf7sgad}f&i*^<u(pXDp9B4lp+hPpc#wL6c9i(slc}LNR;wSc-2W~&4@{k
zHxt7F37e8WQDov&f~8SX)7|~oq;v)0;5jr#h@vmz3mp{l0q5#L0jwRs9pZYcVMwJB
zCt*yYqnR7T7?82pd+Pf0Y56LN4NL_x6n1zL4+t$>2jjWVvLHSH4BIz<L|k{_DAS7U
z`=!mpdiyE=Tmb<|Z)@Tn3GSe9<>b|b0A3fI07mknVqp&{Ax0Z&&JY&E#eg&ErHdwv
zw>B(=v+Uy9Vco6<tPh|m0y3dDo{0RHkR45gtkXtU)ey2sh7H;gsOIEL=-@9Cn@tSq
z5gSwmrH&D`7n6w7!juAWtgNvpl!*pkQ3@<{MUwtej)CXj8@FCtrmS)qP6RS=eR=a}
zu7)^cmBNIon!em_aG^lsa3AcCSj1PJ9={BAnLCNk;bz8<emx){V9nn1INT&UUQ2v-
zLSvdIVMnmqd8S;35yKCV{|IO<K6d?+_bDoZDR4WTf{UG`_BP+p06^{{evh8&i*r1{
zHz9KGhdf-6q4LzrEr69gJ%p`q%;{PjQP8>p)c{gO280b~lyn=KI5<fe6sL!j=-&Vt
z-2_s=S-<^A$OsWgMxRf6?7=hUhz^Ha<Q5%(Z0<ftfoM1)cugahIZgJt8J;v@;Syj&
z@93^|IqLWgpNC5^q)`qg!R=|4G5o#lw$4>k0`%M>1JO>uuuzhyVoy9Q-G+`ptjp>h
zo44w;?o6>{>g87d0KaU9htDJdlXSI=ql_e5u-#E`y}U{Y@nzMmFov+-!qy=PBi*~_
znq!TaZ~u6VKmj$~mY3aP`UuT~_JEfWCZba;;EVv;-BYi=%G9O{U6u;pA;~@GLO3UP
zgo>XDyFd=*Z;)kvCP&hf36EFSE^e)O8Pk!OUzl*Lx8q^o`_ufSMG;rAfHJP{7*H%}
zv_t~gAOM_70j?r9>BaQPPp8Hn)2x$82DKGSe@6Lwj8t7@<5__U66x>?N}IpQWTHIQ
z`cF&b>xtF0J2<tRlz!@tVj(DlL42|mt@7rk*e0TR`V?T7$5~N7j=wI{L+Nqme@9VH
z=^(p$m4(!W^01cIsksn~uIQBhNv3k~<FG)d9Y|ckimtP6W?^vA@kOcyd8!ml%BDh0
znYbUFud)>*MjML45y^-WQ)!31em$JWs<Wv3BBC#0;vhzrIbJ|=jb^xZ&ZahD59pv7
z2}qj`fd7O@ZO0XnZ)^r*x+I|&lgFmOH6+gk*#KzRy-oqXo`A5A3TO<Ti1)1-jy(rX
zqHzi$0k39uy>t0kS>&*smKjE9{jdr;I2ZP!3k_;LFtQGLQx}6bWvynfH6MW#_8+lh
z1rrb}PhtBCCvbcS#Km0|4$Yh3iZOdzlg;714m5YeQC9p*wlGXjd?*z1T?4UJ!Tc19
zb{W(8&?&X?6kPhof$EA8-NI!~H*hlY7%eipd53rjJ$;7px-5AOmzNcVOgbDEL)+p7
z!x(0*t|Ee>4@N+SR&BxX_G++9QVv8B5e`-s7AOD|Ee5sgBE%-1r7Vo2Qp&(4H$J<-
zFF&E>-P4#&+jM{|0FS{4a!jD*ZjP128{+qHvoJ1ZL*y3};TacT)BZ)TsSelUdF4N<
z?F)(+%(bq8<WKad=8-oEf@K>ajUARy9&)QFbQ#C;ax=@tIEMf*9}6^VQNakjPbcsA
z=%~tnDTyuWJk-;v`4J$Ru*|kBI@zoTWG%eVf4#j|l-~n1P$QsSL;$8A!9S%=!`9H}
za0x5~2cgdTg9$r5AsStY7$y80DT-dWEgaF-%_mp6C$eCazB$%4D^`17Dy5hV<rD9s
z#At=b;92pe#L8V%??SLdlU__frJerN6(zpftxCon9Mz%;fN4`YkdfMWoh)CWG%kN9
z5bM=^QUvPpCS5mCfGUUGh>v=d=aDRFjsnBzTD*sju)@q~_|wDb@)WxsaENW1K4>-w
zJ}KoiwT13~^-$|Xq{0U~qoGvhC-Y{5Gs*zp(}ZX)NGBG}>dU%*(S|M-3P3F!9fyG_
z*z)9WG#e4i>9Or1{=|WSC4|qyXZMp;cCIT->1WBV=0DG|7PHTAb5jAeYH?bytEr-Z
zat#7~;Xw#LH7GvL0|p3AFqX_Bz<PU|n<SQX5vcgg{sw-ul9-*extS~ka~$-@t7hPp
zc}yUqsv2-IpASlfEJl{F-KJ?n16L@qw1Fj!fPrVk{AM1?4;{;kDn*5dfI=$}MJINB
zhY_{QN(Rz&+Yu0C=|*5ji!^K%3E1d91nC>)pPwq@BjGX5jtGfWRO!V)=PRZG0Ye#}
zUKE|PqCwaV2hYnccj*E^itgl5@Y1EWxGr)oL-iWhAclQFic#`DA@qeyc8R$dS$>c^
zq-x=D-j|HioIsBZMqFV!EclL?*<`5~ZDE=6F$zhx{5s;*c0@EaMBpN(ie;p1h#IIW
z*SnSo0kVxC0?Sy)RPh!83B?BT(N}a<z~tlkU)cO~;mgdbd1OKgr5MkgozTmr9x(g&
z%Zw`ul4Lj-XNiy(QBv}klA$6WeO2AAB~3&bA@FjuuU6@}yho3Sh@~i4?BdXOQYIOx
z#`zGE_#`y||5_Y+HZ36tXocYa@?lnfe1e~XDXul^&JCj`HvOMPjP<px&IY0QcEItY
z@X+^QZD)T=1&erM$U&9V;kK+heKqB(PWi?NS!)28Fbpz_;y_E$DO8jdp1`)3VF+n<
zmgg0ieGM-V9-C&y#Wi(}{JO=J(juIF|6rY1oU1T}Fv56SXj+IX0kEnbf})F#|EY#1
zn44&Uj`T>C2#XC-sQx2MLPSY7Ye0&5jZU(gfiHMVmse9eny}OWE|_ss`HBl+m3WYr
zgNf-bi)Zw8+Y&8s0d?7ao717BRtpn#y2BS7B-DdJbG8m5!toU}12^UvAP~Y4C@oBt
z_VKw-4cI_nE)RK}Zan<9HK)en$NeugoFm$U4`-4B1ya|*xMd>6J87B|5d@+7`LESV
z^sk_GpIYwFB3}gn1!EwRuFBoF7*7HSD^h`BvFw6TxX@rO66y?DWUtl(oK6U_#(fv*
z<}ZntO77Prb--aU{TE1kK@!}ulUcyF3u@6{cheLxLa%MsfsF8e2Ucj~OJ=?n%ThT(
z@WneCLW~cHAwy>~_U)jeR6`SBqX0xMC!8b+k>%m9xbQ-PK1Di5@(V(B9{FUdkdgBU
zR6ww0h*M~bKq8C**wwK8QvL2L->5Q=BO4((Ig*SGqL51*^7&6hJfEaeFh|&$$$*bB
zn#J28P-jL65un5eHG|Ml>GTChl-6hrPS*=AY)dfdkb=S{L6I%;2p`RFN-ZbymsW~n
zpg4pZ2zwbmgz_{S7Cuu738@d`qHYkW62j9$^l>6A<bWt+&n&1w2EV{mEmM!qs^Ax<
zoT@!_&?$gtG{713{M~5!S!5Sx<=*U+%u~leN{0YhF!l*n`!Oh8*gZlz2$Xtcm0|QA
zON*S-!Nw)x7r~0R0Q~f0F_Cu;d7GL<2$b(KdId4On`kTqH^2TE&%Wvor9OnYQvgHA
z-#_XopYBKJX1$gy7q5Ws=grt0W6v~sWYe(bMT)jT#Vlt5p^!MdiCeLo){L)lSmTa&
zcJvx4!}~8!!jLgNl-ryJ71|q%^e}6UYjO}XPK{gOS9-a-bx8sG6qaICIWY$u6bo2M
z`cKq8`V_aA8kqSR#^_hwP0c-JO=H?<@mi_pf|%>ViD%Sw*T$O!qb~@GRw5v!z(^4~
zDO+V>5DQY3ZE(c(d_TTcfGVZwOHI{f<xOGBOr?4fP$>bS(ou7UOymr_hcK>~3$hqA
zsJlPVTAVE+lzT?|$^tW>T*fQPg6DXPJ_C$^%{3HSHRT&@4V?lyizRW*bS}qLA!zwo
zb=>k<xkbfVd`z^>its?_nscSE9;;`<=Gv(>uRE26gV7|L+69YEbcUnxP9`XU`-c#Q
zy}>AzqxiGcwAC61DO)7YRgxJsy~C$M5PO73!il3ZkPaxY`$^n+V>;qxg>{vTc~lj}
zU{rCL6!&94Vc5zkvf`4z`A;M>VE7HA;zWo(*7=*K?t9_lm|lR9N04|fIxsq+T{IN|
zf&MLru8%{Ch%C|87E1`O_n>XtipEGZ8H(~24)8*gmD_3O{wf>7DdLqm)$(Lu_2~vF
zYHvBCo<BGM8FMZ{pDDh<MnggeQ48p=3D&`dK^YOwC}szR8mDlq@tyI2#t%rm_=Vm`
zML6-xDg-6>lR*ebHraLdAz-*bZS@l$#lkLMWEg1pJ2K^weak6X2;+rlDkIEvsOj*`
ztPGBiwg^tv2(%6iTp`=;pQX{iqKu+^<Sn3EO66b|tYULkmG@nk=7~c<xEI^e;>0i`
z<v(JH3j{=%syxvrJRu))PHBc_3dIV0T!XL*DHH-_A5`-yD#=CcJ{%5sRv6+Nju-9t
zvy}7(KYA+)5g=fTx)#zW+aS|GkTxjhQ-mDTdUrHyy<P!`kSI!=oRBmeg~r4&11<E!
zY1X+%;4XR#<gVMWx6|JHl1g$D3X)E3xG|3u3jm%nUzCZWZ6Jot_2fBda%FZlBO>l{
za_YycuGTRZAz?+i3obzpw2O3ATAI#)eLfBH^$W5pzhYC4gkA_qnI;~^fe{ife|57;
zYzKn7nz()A$(=HV!Xhm}u;7q63P8d9qea<E;lqb*JVp{E0+$a!@4nNjK@0LQSq8eH
zB1lY1k)uwiEFdEgFbptJ{1FV%OY%6q=wTUvDc7pZGqS@NvB8cN){Lv(*0JCentg|m
zr&Uw}wl4z^g}F-Tbxr7i{vGq6WttOgQ~(TCLAG#?B49xuzPVPfEH>EywQSv#Ie1Iq
zk|Or<2`8;U#0x|vYZ+n48YbdRYb=@$L_?POJFFrpC^{ebT+YK#5}>zva-F6vbTCqU
z3u5p#4k)$M%qb==Q~*NK7{G4sFkE2{-P>?jbh0ENcQ>RV>O_K&OCCTI0<2_VPK}Jh
zS`r74775h?Bg9V<6^X(Fb|k@|qhJ`MB1S3{E?XfrnVW%}C++Xf;mh)&(B<51J|G(u
zM3B(E6j+@*|2BxxERh(i?3_glJ~R2tc%*He2*r8&2SM3*Yd{K<5+Nv8wb<J?Ph{XM
zMh@KCd=qebWqjoq2GxDy1dQP<O+BHn>bXrD{}PG^a|s5;iDU(;+#tQ&&&Ej+7j_~{
zpab$i28w|oY=yd!{K{?RM&)sESTUv+MBNS=5(QB65LN3-!Q&NuqCj?2TQC&tv(j80
z+%kYd$ovu(s4$5p?vnva4StrRQ3l7sML2`t7Z@=DaiEC~1wxw-*dI=EN6q#@NmD3Z
zaThw^U20ho?SLzwCpT}1ZxDde%oZnTS!4@3>ca}<pMe5}Z$S#e`bLz4aICUXJ52J~
z`feEK`$+#~u{e`0sW$u>0U2zNKqh&LLT0lrx)-Q)XUY9xlM%4alfrTq9*-7VEvfT+
zQQ^WwH&<Q^^hPfHASue%d_4wU`rbjhnTsb5K%Ru3e+p<(kL14gVtH~-o=J-7XQDQ%
z<uDs<)?d$*tEz@`eE3&(pyfkC%9t+XBtyG*7J45dE<7@Il8TRwILn+4g{I5Bmcm@+
zz^vpv-Gg-`UrW?!!2jtaE5zTSChI-vjfcn2mZeMof<y7tZ9&lDkRj^l1YzuO&FR)L
z<=qck;$q5poN>Flh7R7IPcMK~3Ubc|3Tz>O*1}#iAwQEcF+K>I2|Srnufix`i;$h=
z278e4xamMjL`qFLB}M{Myqi|ZnvYBrn0Y2=wY&)pihxe*hL!=s%LQgQ2ne>KQ0oVd
z0Gg-ZqjMzU`cs9F>LW5w{Km2!6gmbV4oaO0n{4JVI8*0bjd=nBem_f3jvRXclU>k7
z4pY({B@+*jmu)SP_Nn6}ofJ|Zf7~KrEaFklgcT&DEHsMpGfQ15d?D;w7iqYngT85I
z{5eEq)X*%?!?T62FLphO%ZNZa&Rc1m<TLF7-#q(lt8E{sBbT$oo?DQ4$jAw-dz@@n
z6Z;U@G6>R6GBQdxT3{6Jv9Mv-VQ>)XzjX~S2@JT8;#0jz2yDszST58KF5u+FhS97`
z7ma&gJyXC$29ei}<Z5A19gCBYw`ctYHb2Qutr`HCxJ&(@?Hw#C#P*vEI0t|9(?r0=
zLI-Yl=m2-(ekrD$8pPied?6pq-LU_RvS{#Pfu1C{pZkBe2oODe5sOkf<=?Y)RAyM$
zFrm)H)H<0}J$1Yw&;sLWJ2i-snQ{6u#vZJiq(%>lQaHkVsW~D@Z6^4Vvg`dbFdR{w
zaUR@M$C7w0T!+f4@{H$!pvZ`nMf%Niyxs?P5^iEW0BBYA8)gTIaPlZ8WsuE`N$*KH
zFoeFF^6m|yHszEC>acYgZULelP%qn}K)kolyJ^4~Ll@E#?$td<cU-t04v9rYv@4J|
z{X^|?F2#D_0iV^DXl0-VrSM!x3V@L^$WsajNgiZV0FYdU2Qb2fl|iqliRKH$mNaf2
zogf^NE?T6dQ;c1YnsRZx#Ur~EtxLb9sGg!}r4p3UQ;jDi^somDa#0fV$Px0ta|yGc
zqL7I4WabroF9QH88diRVefd7O*Q7z<+B~*zdypnFdUlm=-JUvA!KEd}O$#08d~g8t
z@j^S>66J(mpdx0XwBP|tE>8I`D1{ArPL$il`H7v6fQn>uulX0AP!Ih9Y=*tAE*k1{
zCGhzv*%pKExmPAvle^ggwl)apq5&F~?U^308=hL);s3-74Is|y3I>6+E*nxHJ}cB4
zSJLpI&ue-h`mt$yoo!kg0A-v@c0(D9+!gu|2t|zFZF}PcVZKZNd>Av%uO~Y;h__)l
zAc+a|{ys<AKBvOPdld;Amp})_Oj4ujIQVcVnLT+RLXZ#>!i~p#5)`C_;Vp({i>(aS
zbV@0)UfEv)R)DR&V00)%mOS#dRb@d}TY``Y9fI2;Qnd{!@yIO|w3Qg`EauL};)SEp
zEg4qjVK04QbJ#Qk*c2?0x30v;W65clhOu7rsbm94Yi_+1VDK~(1vFgieL(b=tPE`5
zxaMOeAY$m6F}!%L8-Wp`8A;UcfRiB)qAs;dwdQDQZ`7hXF4ATCi7|j06lyY8ti}4~
zs<hi$ff<vqh*V`!B^#5@7$))p3Rv70zq|!5^C&dV;ML?AM8acQxLkgxxvt5Ch+R!+
zGw#ypsJq2*id<|1Y_HuC_03iJ@VG?_!Ed;|faWXwgnoPl>o(Js72tm6=3K_*d@`t}
za{`FT;rZ}Fzw&ardlq&lkfQiACE}Rb%CUneo)Ew$i^n_wfC)XxR+R0NVBIPD0HV^8
zpqg-xgM`EyWA8x*qdu$_j1|Rz>>OEAlp8*aE#?c*2?$LOQ35htvM%x6v~Cj?Ia`=S
z827upiUD#9Fe*-fZ4D)SSf1WzH_{<XOyRA7MC=fmHR&$U?D7GM>$`v>Sz_*vsdNqw
z^Qen9qhv&mU-s?p!nJCMCpQEOFM`0r#6Nr%2Ttav$@VMCZOE3Vu4}P37J+-<nHOpE
zo$x#i6FGGm)a7H-;%6)pZ<TB(mlpc48@dl@VJ}J)LE*xpDX;h`swx2AaxI_1(|Rn%
zt6Jz>mBL-+c;G8|42x>NL3`Y@M9hV9hD$y=X2~N!7u=N-Qe9&ejSO3kJl$t;mp~Kt
zGHBgyP?1-qOm<VM5M;oA8AG#t?kiUT09tBOb0ITLErvX~KYC=x*(>R5XB<mU_MU5y
zO9V-TM*g&QjS=D5?8r%cxm;(5%d`L{*<}C~ghKUxOoY>SxZuW^@Wd2oz`OK91B-R8
zkxcBe1{s@}035)UU^v{N8bfuT#Vjoa$r1`1K<XrULpvBInLse3@1a1H#FfGRkzyYU
zY#4>G*la9GkXRy3?vzBPqrbXz42CXWTs<##xGy6XdzUMzlenhIWCP=ZfU3x3kI4Ir
zVriKO%Lj!jB&uC7qypu<oweFLM#(>BDRfkVW=5Ht+?|1swi$Ify+~#R?Mg`mWy=0E
z24+m-47sWxo1uC>57?Z4eOLfpw}LVfbUXkk6+4J&!57o%fd{;-WP+y-ON^yV!T~vw
z9t$w<=uQJX3bqI))jnifF;J#uSt7$S%SeYjH6$eRndvsNp)$f^)9BtUWw4=;Nwaw9
zdrp35%RvCaZj`)3Pr##Xw%TbU3<(yWm=T1esa=isE^)k+Ig(f#K3m}4azEnWgp{o?
zpDhicM>^D&GSR?-a6~+G-0Co3E;yn3<mxFkWPSn0DR`Q{&0r{+nPv>o6d~@AYYGtc
z@KG9NspyGX%WZHKHxbuAFWdlNyGEtbXV=b)<gxvf%kAr$xF&jbnOQE@X<fLmg_u8-
zabXL9gb<UYjp!bX1h<Cr$K;X(8f8I~2h*7Q1s%{aV)=E3MPa4{7Ul01MPM(hX5C>0
z#r(@F&Pu1uD;fED#{$tI+D;&4(Sl*6_+HzU>F$b#-0Iqu&DS<$J()e7Owy#okQNpI
z&|qKGk*iYm1`f_h1fik5I#5wE*F;(_2oKL{8ibgR5FZ~b9|_QbVu}$I^7b$nwm=5I
zWB9YTcrT<Fr=;{|Xo{ek(iNS&9%|eW;=k#Dtd8%PTMO1juXi#F6iITKAEl`;*(Qdf
zi4`l#g{wF?q!2Yfkk92+;)&#X(Bbx~0R+Sm8fdBAt*=7#q84;0A4xJN6s@~v0k4#(
zodzB|LMR-$%oWMR{7^y~7MEp;`xB&?A&sQeTngY!K~W&+bKkt+koYTS_zk4luAA+d
zA~hn<DnCsyN#YOs?l~E;@M4O4lQ29;<GZF^y@tcUrvt1X^L1;OSl}%Wfvn4fv_5q$
zsZ8M-K$|QQw#mX0Lst<_(`PiS2z;%y5(yL4vWoUZbt$k0CGk2iV!@QyT89{B#4Wgo
z*fetWwWz~p7)%-6;m7PCDaD`94)I{)>=gIzu(qh6onU3y8JZM{ZV*p~CX|01XY53=
zb1yVdB)3+?FGTqem7QQbK(NG<vz$wUk|et^=i#M_Tw_Lo*6Z!*eDp8lw?g=lIjWkP
zAh=<XqQY0ghRsfJEhvZx#p^L1&1fWuwk$p&zO6yVzV?y@vr#<I#lK+<5MvQ*#5KJ_
zv398u-%R@9!&>@#E_0a=NOb9Igx`{~Xe8N_BW(-RdZsOwG?8SWVW)5ioDaBGGhj8}
zGeWvScYqEnt;*a1Drzn8vM;n&<%ufrg`W${UD$3UoiO+(f-0Ce?F@xzYiLNdm!UXT
zhPvp7VnqP{igU{^7nj}9HZdtainm+f0e~gMlavNlvy!yE$b@Uj_M}tur5I?)P@OGb
zZ7;QS6ep)#@Gnwx5RMGijzxdbLxah~p!`I+hAz7&t<U$kMvNW+EdLduD%aZoKRdbT
zii6KLW+l)_rk*FrS3<z#@JJnz;yGoO_lt@a3`h@~-?W#jS#JJ-AmeGeN0p0cxw?ju
z&;f94?;s?MRkU$YVxV*+jf_Kg1Ea9d;hA-2D3)zP_PpRr<-%@x9R0XNY1_HZ=IxPT
zSl~zx`VMm=ZEKT}nyd0TwhW!hPKOQa3)i9uc{&L4<qWtw-A^b~nZqOUnrqPM0_iWA
z?^wXg@ud*R0tGXdT8)W2m^PH$GZDzI4tEQ$p)mbU-d<!4(CJ7JlL<fs2}qRhJu2EV
z6eI)!b5#&3yLd_4K2Hm_68TMHwJRH;+#^<s3X+nvmH*(_$dZF~T9PL+;t;k;(;Z0#
zZABr0pv1I}bgvtdB><MYVr2;so-99?M<VjLNf(qpK;#5o5jAyXQtfaUJeTny8^{(H
z!vP@S`$uI4Xd+ptc1vLiWryY_l-!sAi%8JvG?umhmsIZsg<zmJ)DW@d4`sGPocqn8
zOpJ%3G#HRUAXvum*PUVW1$gqteY;MIy0EH^fZ`vR3k+*NMK<R;BtHxx4ln|g>1bsH
zH!{kw>6<qY%D$xNW7`uSHomvGTaqNEczjSvVl{1g(jr6Yn=%4{9gzaL_N9F>yDdLa
z)WNxw)?mzm4T3ffui_Ng#Ttjh4--dqa@0q%9N}kG3d_ry9V%7<grsK*6*tn6$A3C9
zAFNF-+jH_^6y6OeU{QWO4njy-0*^bL`tSn0B$Fjl+gaV(1WbXfwL=aqhN4Fv?hQMT
z=Ok>YnD9g-EGBFeTE%kzu1PNKRh;5!J-Y*e>c@Bhbp|PdG{36+lFdLUHqbLIC4!qU
z>d^OgH^F7GwYpq9EDk{+E{-7w$tC^6`}0{1ur@y9#@u;QH|6c1M;djPaCj0UA+5l$
zgU~usjSW*kTOJ*T+fx#^c=H1B6v?I7U$AP{nR!U17|&-PNJuVN3(@X2YQz)ohwYxt
zAQHf9D82q=lIR!sW<UV%$W4;k6-<JK%nIkxWC37nG$78_fK#(43<D%KhHE-_9XElo
zy5t%JyyvE{kC>kw)pV<BacYU0CM6hE+1?>5(Q9tr*)9f86Qv}Qfa#B^7m8ltY%M&s
zu-}`6Ms)(M^%yX~Zgs_AqzN0oM9kB1i1%n)dAxaUI)$oR616uqxKp>G#DfBx`N2sI
z2Vjw9dd*;f1GXrNg{D|%A^s=+SfGt&JNKQ66`zA9SIU#fOpshIrZ(2aV2HHiFo8fZ
zbm3n?I0kF+kMb`S3wWwRCYJMH+GK@3xv($h@7Zx86XHpO5-o_8i5!3|)u+fA3`BCd
z8feA!AR6Vc9j;j9XJE<lH%C$($;(%x^J8l<H}lp89WKmMSD|xAz_m!Fx;4RSfpKDH
zQ>i8nCR>z+9%gG!^_cO{YKLqHCN|s?vor-tm5G<?#l{iV1+vTYWYNW(d<8AdK6Ljt
z-K2>G0$e4t(r8*u_CFKhweh}<iR`R#>19V24;x??DQ<M>aM1UBL{Gk}jWGGn1;?NL
z6`ThLooCqdGU^{WT)piy!&v2|)XD*%ie3N&1F2aZ&h|pRP2gUXV+RB@AcZ53`JYN1
z4+Akpwo3CqJx&31AZ3EP&xRSD_-}v<^f*CPIE^*?@JYMKus|dL5E}i{Y5LDziHKR7
zU?5L~&>=((g__SXBc)SmzB0f<5jNlD+rDd#xlFq=z?|q^bvk3Mu%Lwd_&)7KTrxVq
zS{^NxNmdqAifA?x$8S<2e5p!|^_abY$KJ*Mj##+kiu^gu(GhJG`f~@0ErzZj^1;Oj
zY@U9sxu$?;--I}h_!MY^x6Xucab^nu==L;SLV}lz#Kl;EF^`H5CT0sH6&PO?*fBH^
zZVXXTku5%LdG1k&jFEEE3<A>az+|x<6q$uZ*sLnxM_k>EXg6<_Lio+SCr3@;lKlrK
zf~)JKw3s92!<Q>`aA=O&WxF}CvMA~mU{UTF4*T3zr@%@j?FWVf{vQd|gR$TuCDf>o
zbf^y!jF`Mo9;3MoE>4|EBY>H#7gy9pzv5UG&L*aEL9<A=6EoApX7*%U37L~2D@I8W
zp!;q5F78ls6<H1w2r(=h0QZ+0V$)mCwJ#Y<qe`U$(9lD~U_^4<P%(qm>FhzEfN&6z
zq-q|!5Udh=9PExVuqo}vXqnL8W<6-sLrxG3@{1G@ig6s!Yh>#d9TEhQ+QfjsNq`va
zZd^3Lg%*JrRE@7{N>$;IX#O!<d+BxrJOyVBwwNHaUl&%%eBZul5*QFoc-1pa{QCf-
zLX85EwdDHWuK>19?iA@MNFY;%NVcd84>(R>p`_qxVve;xAp#0-G2|@%nMr`(JAbof
zx4%(oZ3855zl9w%$|2WodQm%67&Zg~V{`b?U^1tJCxrbvl)I!lM1q_!woy{Pq$?W9
zgxe>O=Q1*j$Mx$F>}R_3U02QIB)5?be2xViCwQmFHSVBdp?}+7p`>p}i$Rz*WV~^9
z{>nxBAp8;yu*|$<Le16K=7Ru%F(6f|v+|;%T4f8NK52FFUH2pwv;0Md1+ZLdjA=L+
z0mwcxGniWf4rd=eOR@qbS)swoy<t$2S~TYM3P7U%29*zSe?>VyfKaN5zb?8YX~=IZ
z-4%9~acKW`ft&SYhX4wj*<pPik_`shq-!;|wsv~k%kUXcZL0;27J}pGnc@Y6LI@Ip
z*1(;)*Y=wFABKx}7AlTY(DTBi1iY0PesIF4xv`^OWz{c8hB9f3aZF(*_86WmC@WUe
zx2{_bi2=~FH#=p32IwL4;A|e}1SUNxaI#Yho)oG`4Cc(D9W*NlVGIIDqDWu|%Y-PE
zxL^$vtqC>epuwKGEXgmCyeLfe`*>-TgkX?CcB{V7is-<QnEB%f6W+=Xb|%#XL-FuP
z3Jc>|C*s_z(8j_8&>s*>Qb`KsAxw)43(q7$nAWWztby(uG?d4&+W%#=SkTb`=$?F-
zM(E)Nm9l-?BP^7l-7+SQ3YbhH{=v|wNOtoK94Z_6Sw$pMxBoXo35l>%IS7*oOn*Nt
zG`LMKEQ&0S2O;>M**Xb)FYJW*7ibcpOHd)x;hFHk^R~`+8&ObOqA=^kSgfn+t}GjV
zrNkCOmhga0(&qbPo%*AjG}K?Jh*}6MlA6)IGvHBZ%TVC+2nz@Z7iA|0<@rQFaMvxS
z?pKy9fd%FO)(aTsOgl5g@IJS0SKlC=4z7Yxt$tDODjWAt8$rKH+?Cm?pe*K$Lh3Zu
zveYdTaf7i<@^3e4Zp>tIvPnsKJ4rgR0#$u<al}jD;MW;=sBv0KAjntC>O<;T;c=)a
zZc_ZYJs?8!h%u9sXyN7SH$qn9p|+Oxk@Qjq#FVf5pjNO&W_FYlCdK+Q0=W(R|DD2o
z*g{|CKG07|`zD_F<ys8qpGpH|u$(?Xwf?-qbE4+4=dU%p{Ug}na|5;#^yM}ee-S<*
z)uHyF-#wmUKCmw@e2K=zR7R#$p76g*E1~u$9on-dgzH!7WTdMh3i9-rrw}gNxI&jE
zwyM5rwc1WWfs~Q~u=H=7OmCPT70yG5U8YQ`5U$KTLx&Y#tK%tCHW-p~q8l}lmjVtG
zfK()_r2#&Bt!goATK=$=*GlSnl6ye?fSkkc;xGXa0K8_KOi00zG0)zZl7iEO-DC`P
z!AnHQ_zkKim!PvmOV~6z{m6z@gLs?)cxB`sX7=kw&K8w%zz_-sRX%IfQR8=34<)Zz
z`!I9_!XT?B`ithuJ)*+YXCnz6q2OnlF}%sTDw>i&)S=#(?ksXRbDum><{&+?FfL2x
z_#@qjGlkrZjE4iYNO-UY@PfDQ3e!Wg1PqPOk<eHyc}%f=XvRNy_j>nyGa>jjM-yz>
zVmL35PlSOUl!)M@L7uI9zkJ_7*M%%hrZMID?OmX7FE80dJ<)tfnfPL0sV(hwV(_s3
z=k<C^4zJsNi`iFm{J5UiNX7K=ZK#4RJb=f<r3+^q=(KLaDlc4ueMJmc|JbAO7mXW$
zPBF>4cidnlv5X;^(fN0j3tL>1mX9Lwa=~z$%<XMRni~;&{CJBFwI1xCCM0L#ft&qp
zYYa)FWrT8>BrPPwKc*=#GBLzGSOo4MDI~yI?XQ&&4Clvqm6za%WjF|%;3-jB!X=O%
zwrBGAgVSj;eiRcOz#zD+K)4y4b&PeHkhkb6c{ijAal#KeP%v8_k6u$PLRLweXk>9G
zy9Zdf*3t~lDFtqS_6R`f*hj5(Tq154uBv_SXch>tMko?g4ho&ON|d;zc3RVB;~=Q)
z4q5R`JV4h5rQzmpz7CA;CDu75G~l-&EBdUlKaki9x&?Y$_kUa%W^?gKZPk;3<e3FW
zZ?jBX&JN169}(bQT0|m9F-{=_6b}{zK}qL_Egm4(KESyIEfkdd;TYU3UOBlc*@~pL
zr9f!fLj^;3NsMGCGE(6Dl^{+}7}1{*U>5c8fK=Qnc!rKL9LPQAX%>WxG$+U=6%Ja<
zVTdd{_y<Iltt^){*0V$&dhv_=7krBzUig7La#YSDEiEcwf*H6*DxJX8Hp_L{6|*Y1
zBNESz;{5B37;|tgqaXc5b_0f7VN!7f0LkJoeZ>pl<~iodFM`+>#TVP`@tif|MHx^p
z+!0*zKu)b9dV-4gu|hwW1>a1V<b+ivqf#8$2fPzI$Sg2l`bfD=9pr5qe0qc9%@d9Y
z0Ffehu9F2J(a}4=kR*uL`H3<)&NN5_wdzO2NK*kbkHmwo$0?5#hY<u<Z)h5uWdb0j
z1`tGp0Jy1HxyWnoyrCMD4p?F!B?Q)^rG>ySJy@C37LiNoYXpWm5bx3|fm_y2FN@Di
zKYV~n|2qbx8ab*VgDQaG=qzGpE(4hG6Q8M|c#_e0stYJ%MMBeBw^^xcGM})U;!sZY
zXk~b2-y8WE_h*iw0>W6luRl*FH4X5O+}qz3J7VvS;F~%#0zhVPD|98u1zBG~c#!tS
zfR+XNj8UKPTcU>l#aUpXLih#Z*QB9QFzRkTidwp=ol=t^Zf=Wp<J@gB>syF(7XHa$
zLzP^u?Vykq8a8Z!$L+AYtzkSiQ>bVMEAL@8v!H0j%Eo~&t}PQ))f&%1U?f-?+7>x3
zt_)ZlC3{)4FZVC-J79rh2_K*fLt{vW)~FW{n=O#2Iduwd9b}~PaEpi29N{?T)B%`6
z46>^YsPR0JUshrLB6MLE!X}Qhk~edz6uIdEw>vMWK`5YS8;vLZEXFuW{Tg0;PRg=R
z0-sQP^QqXHpsWDZRdanUC3`W%1ZbreFqkBRK^|gW*n6KuE%nw-bIpwmZ9}zA^VNJa
zLSQp;4I<ao{$skY<uKxyB<Iz@bPI4SIbt#;W_-J#+^n?X=p1~+<zh!51Ru!?0i@Fr
zDxg|P(~1RA_O_&p4|@?5tdyLYv!ogjF(QWO0}ke(yf3$!QnSL;iFJQcBPqCv1Qkfa
z0KX%wc?<N$!okk+^#@Gj4?+h~fmlK(%3y)$T}gQ@Bf|vBEm6Hal$Rog8*Gb7AUSV2
z-R(^!f}x?diK2~KFpp!c#$MF$FYJP?a-?LWFXw{+Sry$ws?P2!_&%R?E=|h$s<8x+
zz^lj=@vItd&y2%g@Cgf^fO<UwN+}OB2yqA|MxIaMS`r$_C)2~`hC2+AB2=7_AjBHE
zVv6EN?!=A|Z}(~Q%{=84qj1_b5h)a83`>V8){Vgw;wcm_+Siy$k4?o<)}A0ggcC?A
z{CK6Zoq33EaLtOFD$s>x3>weGiXcPI9Aqmzf$*h!xSUsP3Md+|4hbAQC&)2q5h@IX
z;TZUJSEft}RZXKTU}uR!M1tfrfWXW2(y2<gWVz<_kcmMDD0&NtM9HkhpT(0u1*vj$
zO^1#fI~jq&lC?>a%xJ^XbP!{96qL&{SsC0eC|nwtb%ZkUzs|6lynd>89PrB#BqDu?
z1}{Q#EAP$*1ZE3Ro&uCWpWFUTJ@Mw6nai2Sm*p<1D{KYP8Nm6Nggld;J3b*J1X1AN
z|4+g2_c9p|{2alWsKJt&j7S*r>7*=GZw87^NFs67N>Nd`g|dX9qt<zv8OguFlXrIi
zB8e(BfU8&WI91h>A|8MeX{cu4N&Hg;{7sA?B;1Ydbtg>~vkil*0i_OvUq%AGMQc-_
zK_X;{o09>V7W&9p%gqDoqsn(sbhRLlaqD4JGoUom!lSk$Og6Z`)#fD%M^Pm;h*FDP
zDrrO!y4bbQNU=MEz(_n@j(A*Mut6ZXjrX}@GpeRh0FMtm-CTruC{o+s7ZL~h4UJbF
zG;@5PyT+!>i_b2%Dii^~h<?y`tN_m781q`Q7*pSSpn%0A7dSkOOi@@JBNJ#6fTo95
zVwO@q65o}rDMzCCOdT*6GL$Mv^vl=c_;JGOSQo+!yBKO1ue={uyclA6Sh%BL$ulH}
zm)T_Id7bg3P!m8l1Zh&^IM2Eug&J~{bH?ujSlbdA`9^?2i=;r*l2MpMZikGQ1B)54
zZ@+CSQy8KwJEo6mUd^vn)HjRYyv13rD!ALvbP|~R<bDN9<R`5gm=UnV96AD%b4!6U
zrJ$(P-c|V*k<do@zk$R7fa5hm<Kt`KUo5pb&AvKVBb(c_xtU;>I@Wb}!y=DL4de&-
z@JkAl)i4?n9T-c-$g1Z|dC7XU`c4-l4q&-bn*YO>j!(Pcm_B4UXy}c<k{blJ@V;ZF
z7IwZzO1pa5x9<(kgx5$^u-euEo)grO53A&jrQ|1ZJ>7(yl#Qa<Wqc*(n>=>x1YIFE
zLl0RL*u)}i%<nKP4gD0xAt@a1lhAqyN_gObJ#dZ@Y8+5zvJF7{7;A?rfCoQR2$wYj
z`=iZ>yjjMSXLHfpT!3y=Ab<o0iB)gyD_OEMVOS$1kWddR9w31U5Z{hRlg|~xxnq_%
z%FMKDj}M9}1D;g~FgZYi3Um%pH8jyP<`r`@g2~3f1^I+}$hO*t5S47njof@&t$J|C
z*s#pDC1YYQJ+PKYZ7g=Wj#7=tp;ES=mZ3{@ns)m_6cZ~Sy;wYG2b@Bm;q4*v9PhN?
zgeVe=U9>5CxFdw5)(tKY0f~U#xIh6$EffKCajU&rIa^g(U^0VgJs?Z~$4vEX3Bu?&
zvdLsG<eyCjoLB7rH`Vxb$mzA;66Sdzbd=>Rg^u|N7dj5UN%P_hJXUi(u^}T^$e|eN
z;<VKV3lfwk3}P{c0m$dS7K^w18D1C+wXPT6NZt9X+7KNFjsP^dpVUEkATzvL1Lkuq
zd{|zF1)p%j<`vj!ip?lK2=D#D+{C7}M}Is+PYiVji(8tZ-Xd4q(ES`bshX;^C8rcq
zf)s=h)7k_jZYUr@)ru6Z4qa(0L96(o_*4Rim{;&pr>6ud2oE!{&r|a*F3Ji2mpZaQ
z!GI@i3WT9SbZQ!1t6g%}zTB@|^WV{Mc56#QHXMBSZ#msxfnnU?CV~j47v2+DK`)n0
z(d|C=g3azCSLE5Rnt2&ySyqXcK*Tm1hZRKVdZrer@g(?Kp~+MknWB^xM4X~W6N7|)
z)6L}ftVbRPS##4mZ^wrtGp7Q*4iaKhVW+E5v&%to9>0<1k|MQ+U@!4b?`iW~4UEyd
zJ%aD5NHX0NLItNM`iNb@P*CQ~2&#uEPCHqsxPA|cGF8c(-6Hlh;Fq9i0hkIYxqocW
zoD{CvWK+&ewFv&iX^M~mO7f?#4AP(P0E6x!D1#UqIM#!xlWVs7*W=vRtwvp%kJJM8
zkI(Szj(A76L$qUO?t3&`o%Zc1fNe`520gp8qCU*_)21N@i5)l*Hz?|AqoC!zmEA1?
z1Ly=e@O+5BNyduzNRj$Pkukq<&x5Ojd-BII@JTZG?2xblooet`ga_QJHWVY^nxHTn
zD@`tqF8AgoI*YXbeiWorUts_T5la>>7Zqq*!V|1Qju&J=5Mvg*3R>gDk|07rg5o?Y
z&@Pj8)UR|CQmt%7;mT}?QMumNj}@Cd2!BQ{TWx~g^N*_NILR9gzF-g&jNtk?gOO%K
z1)|A<wzNPu!Wyc7lYrE+ul`hHaexak0pxV4=Nz{Qjh)XKJy^n3tR&;7)U(wva`e!%
zzpPHgK*NB=Fu9^hUvUfl88dT^SD^@ogas8|O*)lXO~^t!4!Pv|2D@X!gO?rbvtEIv
z9+0xMD}wvz!7&@d`WO~qGvR-iV&29?&7ROPVL(l|4hw1g)I*z{n@7INqmLp8L@-`(
z!Wv)9K|?e8>Ai!7IZ=&VUGRcH8Fv5MS3G<h%;T}?)PU$P%&fF}kHy==)QqgqP(uX&
zyW_ZGU}hNpNaQx#m`^ZYi7n6B{G#9J^Al;vxpr3jU1N6FFfYwScVA!K_dhXA68ofk
zR=dV}Dk~V6Q-rtr%+6iW#SVnTxaF|w-hjjr3G9Yb-6uZ<$393&Wt_lL;gkgFoTEZ$
z_Q5D+#AS+H0g7KDFkJ6KyA8{s9yC}uABg(uBsItNcKyT@AOa8|c>tS~KKZeW`|FUT
z`_%9Rc>OTc6e0lZ8Zfx1S8t3+c>4wCQkJp}Z`ws_2nd1_0)#sn1{4RH2v6}+Uj-?{
zc9{eU&6v|ku$U~wjc`l^(zk5AvY2Ge0ZpIm6-DJ3s)Y;w--!IN!G*aQe@~-Ho0>A%
zYS=1Eibv&~U+|#a>wM~o=^V(^msntciqw_Rh%r7i6y&Rb1=LMr^!ZLRl_wajU@jhA
z5*FcDg9W~c&`batC|Lkn0#E|47y=SFjF+1dE(L0}+GcZ(6$}DFS4SLTu%ZaF8}Jc>
zoO5I*!^JH9^I0-H+hTc?k>t4RTS=ln8GwR0v7rp`P+g@PggksQY6^*kR=cpsrb()-
z$ZzOnw?h<xLDp#E<`iTF0MXE@^-lB9z*vnw&O<+#LhVtj_%9vNxwU|&3txo6v;Y<A
zi(;x}0>uSN9k-7nI2l6#S`j?+Hs6WKz!GQKIQ|z$qM!)9*!&(FUJGIaI5Z2-9Yo_6
zF+YZxBnkvTTJ4Q#$a%h4-9q#^iR5sP1(3F8@R|6Nx)I<8#&ias%NvQ<E(S4U%ZdUl
z&pA_c6ka|CN*4n#Vk9sOrvw<5d7}BIE6y?zpctOaS1@7)X~H6wLvj7?au^%ZB}BGi
zp-gX5&IDU=w6`mX;RJCUqQar+(SRF{(eW;YYEjQxk%-ip5$%DdZWxj@0#69Qv!J>5
zB?@AKZV3qrNh%RSfH))h3yZ6<9`~YwX>cpC02pqCzU4g%p#W8QCCaB!%0DyT{kunD
z@IxRd5dG8cB%ivC{el@oX`~o+@gFaWStNM?<t@P|UIR#Q{!D#K_b@s@C1GvfFS|Yw
zjaa1MFb`v{zP>ePP2;oQjxznuvt`fZ6Byzy1|qLyFz*dy29Gc>q2odt5J?m?L$TUX
zDkVV<qzat&eT}qQ62X*9I7c&^q7V?J=DsUXXTVX%^n<_?sc<~$8xJ)aJQBQbFyW@c
z%LWC2(@bbZH-<X@3;T8S9n2(~$l+cE!0W|$Jz$|D{Xd6^N+92cc|W`g=bV26(m2_g
zzKCC*X@n>yveNVoHTCp_0uu7oG8q0}SJS!|KT7esIRQPOB*tZqA>e#2Olw(hWqzND
zAXED_xybmfrMW%CElQ8kQ5(saRqfyvW-qx`ty{aoUQTWf+PbI%R%KJpGJnZF20A8~
z*Fl;CsazvfsiZS;rUcHJ8uXu*?K=Box7X_C!fEEB2eGY8?D@Sx&H+iZpNEi`DOnA+
z!veHDyn89URFg6B+HWcRzy@O?NI1bdDr?wP2Z}&yU&|IF8EhA}qDQP9V@eCu=E3tk
zMiC6E{BZ2-^M~3=_Y<JHT2>^Y4HLa36K~dajGNYDV!C)LM!nS_!+N-IG4`8FBBNC;
zM!5T2FkyzpVCvONQkQ~_<fJzD-zNC%Q2CPkrY`Jd8{}8S5shReK<xJ(fy|T{FKKjo
zCX@S!7~3y1r2)1K7vpl`CrfKF>PM`$dUGs?-HT<%`5c)D7TpflP;xDCc4ab_^Mjn$
z?eT@RRaFivum$;@PFLsT$`}bwbB?e(g`!-yCsNXJEm%|UQ}h?PNv(-wD<?GT<EC{}
zR;Vr+k?9Ss{IZk}ft%Ik0#8v*7S=TSwzw<wmYYiR?wXqdlCKl7jO4hO%WVu0LjHgT
zY4eKhrmxkNbCpW}-<Qeg^kW{KCyDQ_oM{g0MzIC=AQs^5b%~m9;T2&5{_YZHgB0GC
zq*msWVg4%kG9)R4u!-EV1jEJZ?r)EepkcARe5<%XK<{82cYoJ<P6~A{Tv2%)#X6&m
z^}agncP#V97d%9z3sR`TQloh?M5*I$H4I}#3NWDg;GIFbctw&6WbIfmBN=tz)Ln?^
zv=0iV8gyPqm^vRzL)F_9m9@NhScPXW1Pe@8(Sl*T^l@g`1ebmlkie>7g~QRwxO=Q{
z<x<qzTmQ4{4kw$sST8BEZ65%N389#e?+{a&{y(n@74A0aa3UYwGajV#W3c2IAF`PZ
zt}T6>GUpj;eo~UqztIxFE0y9kDlzvI%V&6d!<I)uT$$@ZJ#)Bz&c=Hf04&v-MNsf^
zL^HkTjFQ0;xSosYaH^6B?sGb#BE+k0klSTMQ5_A@mIV@9WK$Cn!bsV=7MK`5U^Qhn
z6X%a%y$1>@kLJ+rkC9NA^&sT(sazwPlNWc1ndsVI>`t0uaDG^XK8q^@Z?AdE95Ap8
zK)H;*e66kf!!#c}lIpYjxfQrHcRC|4t+V^G9))cZ@kyp=me_<{_SQi_kjqMFpa6)j
z5Td355BKY-ORhPWNI3r47Mgh$4Nl-$%5uRcs3|LPnHIwxRwmXt<!KT)SmA~az)!>$
zP76lxKtOmhOU2)YB6Qu?88A#&MiBIAb}1Ou9l-=g6^;EOR^=o+QkiZ+iYC}4QB5OG
zpPOfat}EF=W&?Bx3<)&9<jV^olb2%!B@NiYkl{)wI|1i6MRl+$`H<)`F;UOA#9gfA
zP+5NvnEH==M6MdCV!!d2%0w`vsl~1Xjy=I9nNS}s**~8sy!(J}rsF7>%EovMk4lCY
zGV(4VKuHOpxnf-tG^`QkR@ueqBYxFt)|9+TjFu59h!#n$gp<Q9Q-B`oa*UibE#0rp
zN-fJJd5Ub0?fHgB7&Z*=oF%4@&bG+`jbh0R11`m!d8Lw=9?G>kSjlUPKRzKbPzsZQ
zgH|g;h5-L-6Hhn(5XLi&32W%1i9J8LRLo%fCQqG$9@?@Dqvd^RaF2*rc{;=hTnIQf
zADj!J2vp3hJv_Vx&B{`CNDx58PJtiMS`O)v;XA7sISZ=Npjy>=%}iJ@+ddQmZNu@0
zGWMhsB-~UEHQ&@-s@ARMOwpFER4Gptin;JeSi{IFSW@vUGd0+<RRnf1Iyq;R-j``<
zs(foBR-SXX&lb^y?l3qH=zGZQNV5PLY328wGTd+z4O_Vnpy{$`*2dPRgFrZhRMNza
z(C%U<qFWulqwGK?4x0L*oFIupZku^oE>IK>bidCpPQwXTg3$BV`D~&`h6#;iu*SA6
zEKlPXR9B#OQz_}8b^lta@csQ2<lU8hJk?bKG=I$G@If2^W+9{(s)Pgp05w3$zYm8o
zG7zz<RbUh3Tt|jPge(zsID{2<;3S_bjv|aomB9~y3x(KTkr!EOJG59@<pBf5gnSFy
z>4beamVrS>yzpU;(9E_W=Ik8;f~ANfy3Cb6Q+mQ30kCbSGbMGR5Qk!Ph-V>a_VQC^
z@LYqSHf^s^D5n!hXw1Je=0dc#bW@mI)?r|M<*v(I4$4xv?ZF0OL)xzJx8Ny1=6MGX
zq#cjc*Rlih<_{zR%44+*+@GtQbcUwa6q-ZH`9`A@VxN6T$x1R!vzmk})+LS-y)lpn
z5&@Nw(;$<1E)19v*0jGq2HZr<3i!0w`B<F$Eh*6rK?I4FM`Y*9B5<edF4$TbR|4t!
z(pYzLoX0v=DBz^zRvTS;ZlQ(QOR=)l%9RZ72A>Tt!n~8s3{l`krCF?Mw3H-41~skM
zp%}cIL6C^ZU;2VtQKFDV6BMK=X)tZoG1t|mdi(+RWeh7LaQ?rbxWAd1{rQ7Bj<<aH
z`iO@Y`9T_}sE1WV;*~R%DFsgLG0^wN&yES~O@>s2kFTWoOqt#X>rw+HHl`m%`v&Cf
zhqiZ;^W~)v4@rrbQ&<7w>^;|tRuW`@DpH{`!wG>S^T&~}9)=}bus_e-H2?#w2rN2B
zfy3{C-0Wns;iu!}8!EVs=D^9E?W#dB2@<rLKnB9(;9B@?uJ3}u$zeot*1Ju&m4^r@
zd2p*=B)(m(Tme0LY;vmMtOVZ_2e&3X8Pkz3N~E$Cj}9K0Fwp6)xN5}(9tC!Q%Y1_H
zs9XlEFywtPWc_9*>Hw;l_v4u=-Sy5D+mSCg6%~*CMC6TyfJue=I|NzQI|VY_+=61Q
z@UjAsPZi=&e#vmLm#uNkR{u-D=^+|aU=x)PfrBE$XB={*4SIYNS0^S3Oun;dB{*iQ
z#0COAiP~<Bt#d(?<JGp#Z>!1jz>3$>LgzwEbT5lDMzYYc5QuiNx}B-qx6Erf$!@9<
z$yTJ2B;A+JyW?<&QAuT8K)wP69RJ)xu%CBsgX5UTRjI7*Ypkl6_wz)1X&a6*Q(=)4
zr$E6`s%<eY_tw*5JKLH@Rxo$UiL&5Xl-FbqTP^vt<81HIIqYWdayuh3^sQlk^i9sn
z>`Dbmo0~{SW-JJ%Iy%wu@MtQS8-IRvN>6bJca37bWf~`RO6Pthn!zK2KQ{R=+5|aZ
zV3uxy%=Y-hu?u?_V|Z^Ai<n8Q6$a%AHrt8Jv9K6J`Kb0bc-d<R2i?vcaT$jg<0^A-
zQd`JyHc^CM+ZOO`S~+K#;Ula6`jr6{3k*O1R5>=*Bk?t%2!%p0QAc46-CDAZ$W*NQ
zGjtKFeC-AQ*L3QyB)ts~%wZnI?{Cf^>hdv06iFNH5e^{=1hbNg?L!!q+_`b_e<2j^
zet^5P2QSX-GH5qU_~>I2QMPw2Y>g&J?jTrH<eW<>VlbgLR)V1fslBUXMelpB^0Q}n
zs7SkO%di`ts6il36`mn@6^8&28(&=XP-BW%ICU(reX0VgxxSxi9Hf9Ax_=>P27|*%
zz(yPS<|?c_1EgXAvn9l$`C>jWBMxeg9UCG4g+Q=m+msb$&H<{5sGUg$L2aFgAnIJI
zJz0kJu~QN@i*dW0?n45!BQWwi<K+0>fozOmg+zh@K0(b_#lBs%M8l}AtxMM^LGI<y
zNk{;!n@<8lCjewAG9L<D3g4yb^P*0hgZ$IC$S<hv1RRCW7sQlS4EE1J+O0Nb$CB|Y
z!!Wc-2_x-xGHRzI<;n@Vscca)316dnL3=eO;OvY9gdo;9eWE1LXD&6os1DgwE02c1
z=GGl^q0D{C;F^G9vmmi&_*C7`NDar_02%cGy9JJ}0!SB=*|zs5V2b4=oB*;!Q$`ap
z+cFuqiGZK}IV%H1106gX$ARN;1%n}QRa!Xk2!wOhzwXwjz=u7U3_{C=Fu~y-n}FmF
z7CioI?ByN?VV17f&5o8T0$63mG+R-CLdB96H)t|K?yDdcM>GPvw{g@F21=$X3On4M
zo<QdE`R4}A$S*cRe6*0D7<%_Q1ImnW@JwWFRnXvy50+y%sx_v-z(nA_<OW1l88#c}
zy&yqxl`xcPNkNtexT<S+DjE^fgN5*qb!V@MGbo%13YDL@kVhy#M6`<;`$}wck`A~J
zv})SmN(#WCD|W%a#1h}Px>Saa6JTjbhd3+rp2j=Fk$}QT$jzD--8$rkfYfWQwX6-A
zQr87-##=eC)gluVaCzOkP2Xp^nh1yi#*?9xxQcRI?+;8YzTJk2MQ`zYCNfxIp=Pfn
z)-BLTmhXO)$^Bxi)JB2nPH<b2Fo{<PcIE}T;R$2P5SW3*5>L1S5c0emi{Sn8eKvQI
z0A2Q|iug{>1#IZb`8-wZ2bpuck92|jNi7SYzbpsbp(Tg}^~`en=fkd%5D@B3)eh&J
z_$71}%rgl|7v2w|K^A<OKvBDhp#}Z9Ijd16BZb|h1{pwbWD3L=6UYwlVU^L&H!;hM
zii81}5`wP%lt+;U90m0)L2+ckK%2-QJu&hhOCN6;#j>}rch~ALV;Sh=FIgAFS=6uI
zft4%}P&z2MqkmLlX$Uo%k7Bbos6h}h8d>-qm@uxkPqMMKK`o$bu)Hz!8LUIMb#*HG
zS3{6`j~)w2#p2-V0Qy_b6^In-bndCa*ENSg%SF`V81VZzmjvZkEls9sW3U?_an`LJ
z8O+osy|{9$m+YosffHoSm3TPRn6tY8q$>_fU^Jl7ED-nGAaX@QC#lFJ=8H@OVoU@m
zC@h*X@yr=$98^3}mH^^IV=NcBqrGsbMTh(pdMay1{!Xwpfz_Y#4o)qC!ZV4T93)Tz
z3c{&Bcz>bq>p3-0TDd)#Hd|JcH4p<(?f7#Z4FD)4S}GwATxBU&ued?*zm>{3naP2e
z;c_#vRXTl%5<|$*eBOwRa!RPn)?R3aVo{L)hd)GRa9j+LfVgp>#}Q#grK7*jyAuNt
z4{Q=O3`>P6vUO<n=I=aft;Hc&B1P%_2++TU({QM&J*GQ{@!9-HD;f$J&j3;dC~&=C
zaAlw#w;pBbJ6L$;7Df?$qf4?RNSEF<c^KQOge}aC*rRK74~9O52Gm2qvNuZ5htEhC
zO~aA@CCI_gJAhb(8zJ3c01XG2f6@)IG!51ab@Svxtf!fV7I-9zj$8_br56sE72U-k
zqKExCkYfe$5W-qtIS^&@w4hyIEti?QL9I>E!9SW3sPVf*a&}V?m?Lz<vG<r@=GQck
zPdL9=!s0-&=8SiL!zqqmw{zwA#iV7dlWk(bhhA30ng@qnlYpgc17PO)EJQB%!DDG9
z$#2!7Xf&nrN|L$Ed64%zbJ!=;29#j!1QTx|WDHJ+7DUbHS0m1^$HY<-H@!Nw)q)gb
z%ixV+wlocM4B16ftKN-;v`p%12Y@8Eobi)F>Sdb1gm-coW2Ni}7FmTe^Ff^?@6E-a
z@-6(Kbcs_hi7o*8EUBJeof?4}3(!7+KB~}x1z<>JY{?&JMzYw?u%1`FWO=+4wXpH~
zEFERds3%z%)+d=mz99LiQGfviKyN_|pCMQzexoDp`jPv}Q~G-_Os@NkZL)|Rg^_$y
z7*XITYy1Zo6c=_NLNTn!!m~^-bG&!c@MTbHbMQ2YHCT~^vtvddDUrb3#xldK$e2XH
z8gegt1>IVZpc*>LutJc4B2dU=KAL$Jmmvv--sl`_7^wkai%G|wbKg4JU-)RQ%!7k3
z{DnN`I=^qLoXKlA&u@<1<jDY?_cN%7yAI@3iebfpyaY(OHO3fh7C4BBo&&S_T^_;4
znV{Yf?nKxvZxv^{x}y~OevgK@OEn2WS*xo5NR38b3gvn{1QmN6p49sZPTO;!5fG!I
z^*NtF(0zms-bFu!-e6?-?*^A5P^OSLq|m0KK@n0=_xH<{{61}!fQ2H7jyZ+c)<T<+
zfJ!k5_GevK7+W|Zy##q$f|E3g0j*$>hlEE2)!y3Ohv**vVbN)Tb7|Heu(Q_+F-}kD
z{y3*-HJe*bIW(q)5=aAbhVLH=)sY1#6Wj)uH_CZLJlV7apM=~6<I0uzrk0A*!fN_e
z7#Vr0qesQpUDO0th12lK4X!B{P!6)yBqCyj?YXm_RveSzS3xjTAb$Xn8xScfo>-o1
zJ+93sq=29)s`pI{VUT>|{OB%fdi%^rjV#`i?G&s!^_*1bl+Wupg&<k2TDBsVKUpLv
zf!W$0_#q<rSMf4-O>A`#oo&T#WsoA|084|9)=9$fksz;?GjZdFQ%|$2Z>-zGMNX2A
znGZt2l09}bdKou$8t@V@K{<2rri)l5t_(B=p~T<uJo_4C%wFE?FV9R8=FXrY;BMd9
zJ}Uc}f)8#2(Bc9r3l3pyBAp5X$_<=trT3&PP{cFXhg0-6we*IN7J?9v522;67R~XS
zNMy4xX=GlNkU>_}%Fx7=)TYt!2oZumTfTXfhq|F|76iFSsOLA7c%}k>C#pT_-KH3h
z`#ET&H&;ah3%1vc2?9^NCF9U>Q>VgZ{12}pG2`;)D}w+PCOnk{6s*AFuKS}Kk{)q$
zZF7h>NNNgT!4yUVAfb#Lwf7w#Ik)XXC)_3|3<fo;D3HmO{6vR0K8+7e>dXaj^7UvM
zBwy$-?jd7`{BMDLJyKgSI2Fz~`gP&R?v|{H?N6nNi<}q~HHP26tzc(_)KvuxYfl-r
z)YD;JTZ2aExw~ktuV6{*IiPtk%4UxW9&u~3;*vgjaUA?ENN6<0BV-ym)-^<FPJwr@
z&u87?gl_CaC~etvjNlRP4Gap4NUHv{t^+;C8||RV0Es&Wb5FimiKzl;)HYcrJ0S_8
z1)U11b4$9l9dFciyV|w44iR;0`C5sHM^eHQOh#m(+D~0S(4eD?mdH-@JJjCOn<BjT
z8I(vDV%7ypJYk3QDF-x>P13-~O%m>Lw!xbAEUU6<o)Fj$f|#_OARsh-Faf|G=J2@3
zR*(NYiH_m`p#dPS;0E=Kf3E>bYqXHK=>lRRo1de`;RqsY$JUH4Nb&F`)h^<wv&<)`
zs<h#yoDdLsO%d2NjEm8$0)oxKIGUYBZa?b;k~p=HyRcy)CHku1L_}WT3=t0WT4!a?
z60%-7XN|{JbVx)Bpu>D*3{sv9uaeEgif1t^@om@;a&BcB8JfdER0F6@nXmaoJ7pYd
zpwP%&8+pw>Mz)~;p6Uh+iTPHN7zUm8kFZwmw=01ZDTW~QA861hHc~hvCD9xN0<a$Q
zfDa9=UuVUh@du-BVSAQn@)Y;k-=UZ%<_oIgZk4#H_K>bU`l_8{aEv_~)<qAN#GgU%
zlF#B4!}}%b#92aZ&}THE<K|F%dNMnG9riC{2`*qE3|WoxXJBU$FPmox!tm<N^pd%N
zjAj+iSklbHDq@~{so*MUv;sZiKW`={Nj?>@gR!@hU7-YhPG(g389Awe1`o9qVV@I0
z-XeabL6Gn09qT02ZuU$~PNjn4gCU1cd_D|Bub{xYXz;D*&`&%Z9oqMMpt)X@HclNd
z?qj|#l9H}OYo{ibBh8~uJ!A!qrC%4g;E9K$`gqo4*X$85#W&pgXKe7&gh;En=j6A*
z@tycbJ}6slkO5*!gvshnRQ=;H&6Ox$wi{%Z13A{jKr-md3!=mhLsk=?a-@uH7M<@U
zM(NPJ1Mqt3e{$IF(>d^7J>aA`=3<#$AQ~iKMrM^{fMr1El$?no-VCCfTI_mvOdQ#z
zj6NtSpZ%Apb)6l@AZo5C@DF2(%NVBf7sj`r3z0VIjA1mxP0C~Ab5!nF*=1@cjAEjw
zUMoYbNBhFq=xQ$RLRxXsWwuZpfppsNhuXViX=7SPrVjwOvqS0n{SpBB1e%5!1!?a$
zCqJ7*4~vMMym8}{kQjZL4B>2*1Muw<;WA}p^}58nF&-d4uM{XRQ4A3em{f}l)bg)7
zC7Z|tu?-B89Y0x<dsUpz?Ij>Ov)Dd#@K^f@ob**-ETu2S<5aUmqKR-M^oF38mAH!Z
zU=t3!69uJ(l=-v4;}`<iAhhLNO+t+<J8g*tJw=NIv1z?tL5|k>574129ybuNwJ5QR
z3FhJq01*^&uIpE{oM>D4-;1=bJSJ@fh>5U8I^A^~B*Vr_eK{o^s??_o6S!<fEHfOZ
z@9Y{4xe}PNdPSCO5$>DBu=QNGd;#J^Ftn4rQY0<(Qxc(E;MWaRBXsXm(s(RnQJbTY
z9TGr=z?w|}U`$-3M<QXrHqRVW^OrbIZEVDS5mFIN1&`^|5kGprmxnyiCM4#<e6edo
z<(^wDPO+ja(vzENSmEheFpci%3&2S`ELBxEi0uMjU`P?S4`aXCqcOc5n#i&uChhgc
z!-omS_e-0rOGlkZCr+MK6@}6qiBmAj4!D*AGPvj=;4>=Xf|{<`>;IM%NdkYFZbU&x
z!9ZpzRbZ1y(i$^6u!<35>KLU!WK*-M)`J2^WvEmB(QH8wkA|#WZvQimOu~!_P-_Td
zdZvSNDAjOFz)oG1Bz?#7R`NeoKF8W4W^rJwa|2aHqg%#T*pmOI&;khGVqo=ah<sZQ
z*S_*8N+X#TRH4QYrINJ8h~9oCZ9ua1Sb^ak+^PQcoI>j^q@JJa0<<8x^}}`T9o`?D
zOr%g)ZrTXqIXP~wpvo2(B7zr0CAgHBc#V4Y{5+0n?z1FYfKiAd@8Md5cw<f1lA3%q
zety!xaSd-t-MO-9?F~brj{qUdUWg%a9fCW41u;0k`ZlSz+79AkLtV!`#+g=`g-ivH
z6gKXHi4jF{wn*DuMal0)1nST<_4G9t_@wDTbbpG!mb6F-2%MC*4-#d|5U0Jl90^Jb
zRp$Ldy@!sUHrgV$kgNYNsD#D%*F^0HUf@e$QMEAd(}VAw6EH#^oU}|i8%yap1Z;cW
zapVR$f&K@wfWR9SMp_GZ<l%B3p<4E|3?Bn<b{>6*UG2;VhLza0Xek?e{}C{2_JoOy
z4ljYy?jKm5=s5x?jE$2e(w(#gw^NWD7&6vsRtx>`8vz6Y7rY0|%DS1o;THTO&7gwB
zBBvx_236z-Y8VBWvY+n-fN>}U|A3#5i|bNSDh{G31gZ_v_F@ANXf<$|vXDSl9fFUU
zW&?yh)Ept>a^J8TPV^{Af3I%%8r$`-#=NcMO4<emj1nUd`LY9ypy7eoaTZ}Y?=<8p
zNK-&8S-Bvf95wRGzU_?gSeiZ@+q_A5o<1?3OCEC&;U7wn#EZoai>m6A8t%Nc0Uz?L
zjC`Pm8?cR7jB+H7lJP6R850Zc>;*WD#PHyQHf2PqheXT0<e+5I&$&W^IOSHU$k-C{
zxHb_`A+Ha}PeDfhk-+K2r!0;N!w22CSNQ)K7G<9NaRez+7QRLotZFxyXV2tr68|A!
zkGzbi1F(U^FlQFqtBzYah7tVmf=;b-cLFdwC9HX}Fd$;OsHmH(;6Y_zG0{!6D45;~
zzA%a%flO0@fLHS?rLB|!0A2bp+=75{3u}!YBe(Dfr73GEY3qE_rE<?_mQGjqKL?2H
zm}N1nU7NhV%o_85hgP)(!&tu%ppb=|2VG#FYsj_}!WYabg|-R--CDN;BW@u5&^|#t
zVF3c*)B7$jj!5_KaR|<%XWpvHNu-7s=@PlBgq(tve!tqMa!)E`NJdn<+aztGzh97o
zJJX7K83mGNjA5%;iOIP3*1yJ5n6{=o*ix;0s8S;)5Js&XRLd+BEkYMa3Ue{M0?<j0
z?|t9}aEo|H5SPR7<Zew30p)s!g{Yh>H(%_52yW~NNEZLTb=?O88ge_p%V!rB2u-b|
zXJNx+LwqZjT$W@G-e)7DCt48`p;w3fpslZ|cLbX*<jTm+be?z6Xq#UknL9B<3l5)I
zH)H|JW$U$S<<nK;R<`~W<fH<BbRRP-hpJXXlFZurJzPQW@f-AHIS3rKvdk1+J4xw?
z<B_d0YE6ZdVQ&8Ef1QC{x36@w;QSsI;DM`Lc9Uuvm}$ILYqz?=iCz2t<*|Uw#5{>3
z#jpG|#|`EDs&QWoVo;6xO`ln!Eb;)Eu^ufSZ6nLur6f=ueb;@hin8)(!CLPmwY^QP
za+9x?Vr!M^_MLP%xL6YS?y*T0Q+<IX2y`)4)}#f29$QFEiY5ns4~J#VR-WXLW{rx!
zA3}|}Sy&pwg{1fT{k`m|$j~dwC@4bwek|YU-kGT}3gv6aQOnpSC@~rZ_O{+Xny~<B
zhj?5NXHW&_gGm-f4FtxKdvLTOBw`ilA?nq240r+Ju5~Y)mLN}*YJgsNEXB}bIgmS1
zLO_>5+F{)O2#}DDAf{~{w2jD-2xcCC(nKe)#Zb@(89V@D6=5P?Ys^0wU|`@Z6r1Q9
z96uvQlD%I!kT2`Lg!m0KRos{`Q0xE|fF^J3)DiRd_<ZlstGRe?ao)~wH0e+eNu{4G
zRV<Kj^HYw61<LXa$K2D9QN>=hAAOwneADXjwSHfB;fksIIF@8YN(Zq4QL@bkZtQHm
zp)C7YIFTOd3ku@`XLzH)zvG5;ujM{t6p2LSU~dpg3E9Fc{2Uv$#sbTG35iKTEQz_?
zQ$&h0DV;5MmH08q@5SS>?C4{f3GyH$g4&7s=W045rrnbbf~qOiY&(@jDexe&Iy)mX
z#SI(`E}sp~aqdv-*~1y@KXcbNIu6IpBg0?=?kKA{+XOI)%#M;2Z{mV^V%@BMWwP&E
z@iWEC57DVRO)LrE0j0VnB$f<nb&-F0pGN!~g^EqX^#^Py1Wf-%A7<Xewt${@7JRhr
za%VNexB9v(bc^PHu~cZ_CD|BjoV(%D;`sA3GOmJ=2?xZfvtsw)7DElL`<$j0j$gr}
zcC=CsrZCVs9}`D|Mr@{>c{yIpwJ>Ooh$=9OmyUAPAcF%Ufnyk{YpIJVBv1Y@BZ?DT
zbFQ%Gx@yLS76X6=%RaneMz2IQ8V=Uiy>d42`=1SJvm+qp(ppoYLkp(L*K!98&H|(%
zmliwyj8#7!i3+>v{zQSYAgz<Y<3<T?Q|W(RG>o4s2d<2*%18=Pbe^P4A&J^Rm7cB+
z+RPP<C{Z-^(h34VCMD$0+1P70TD@|Ixlfn2p|5u4$R7nIZHF~F+EIj<8a{bN8v6<q
zUreav@m;M>c1Ga(yzPLrD4VTyECL*%UyzPe#O@N9LxvAPL4FX0A;pIt$#&azo0*O`
zGc10|6zA$F0@MVwR0Gcq2MgGSLO?N%3yeLib02_zbskkr{X(aq)b#L}7wU&%U(MZ5
zF%DGOK~~k{o_YbmaBwRlu@e>z7ZoqsQ;pG)p4q@Z2zle3LCCx$p~HYGvs`|ST)?55
z;4e{!+Rt?M7)LQd2^JG?X<hy4cCGqZpl!^L)*n21li=iRILTaL3cA+jm36tO(r}NB
zf8E}Z=tiX=6`}PS102w0)>SGqus(GFXP3S}1}8Ppf(;l8e7da@`U+>Yb3PJ;07?&x
z)5{WF#=-FgQ5MJyqeW<)0g8;3*{ziI=<Ka^2M)^8bO%-<3^XY(2xg9C4%Gm+LUnap
z_Az!MnILr{hP?7XgfgxWKG7s3U?6G8PYgkT8MG0&&>}Fs+d^RANJiWlD%6}=qvF!L
z9yNJ-t(35D#hq`Li4EKZ1zTCsqT1Yav@kPcvWms)UDj9=47x+~zA>?%t%U<SlT3!R
z;TV>{sci#&8c>>b8C$S^HR#+?)9m+>Cri7=D*5uHl~~x;{0$C0TRSa=I|919_oi%R
zjgM474vHcf{8lhZg)ub0gCC0kV%27co%C6tQvRsGFraD%W-XK}oVMDx6wNsfiq>gh
zycG&Gg;XjcpMsTB<}!+~Xj9@I4si`Mf(~BgjqzaT6lI_+$E%T$QOUromM;gNW}?5k
z^Qg2pRvrK!5~H09&w3&xi==ccDbs5<|MmKVClW;m@q4alkl3{nXp$fDJ`*A*<cv6c
zQmlz>e2^$+&R97WmDxMgGHPH6*d;JV3=A8_qjL-<3>U-~w+NP$GF}NE@&owc+eths
zl_fU1u&E271H)ql!PocY!OQa_?YLE&)G=HRKwBc@CrIk<vuu%Y4}*u+wNqI6rfnr!
z{I6W#?g$BI^eYak0hMg^*iHo+{((h|<mLC+2NE#Rs3?QT8`K*ZjvVR1NZB~#AE_3K
z445>GYPEW*l6^oDQxcQFgXp!;CU^&YN?DQtz#+sEv>C&fcS^cfSCa?cn30Qj=E3n-
z2>~0GgSd)!wqB{t`E&VVXASrsW9AT(N+H!g57R`7&qkbNE}%AGg{3FVWdb9grR;U2
z6jNbvLE9}1-|3{WSCO3fi87nPi}C4l^+SgmlP1h=3gS(LWNkHxmYPhC#}O!gcyQ&Q
z>vUEraxB64UPmB&EAMsii=p)9eq76=s=#juGfp5@*R!QZN1Tk<fI*lL>vR%y)@Zp1
zFD@A&7dEWb7M5A)CIq3rlg+nZFvOoixX`p&sB$JY(pfpuPU5j5(J~{%8lxtmqpi`L
zlTaawVRoDsCvnU0-tsLrng7UE?2UA40CDDX!-JO>TxCBvBTE5tgu_gh1(d*ISm03k
zwuzMxpAy~vEWySL1VzusdUVfSNf=XLjcQ9T5Q$R`)+59`7&N1Qq)}(gm6(J^peaR>
zns0&P>~B%rIenl8Tt=F`{R#e97r@X)Tp)kckJWFbc;LY_;78B+Ch#rKD8g6lVkgtE
zZ3xAv`Jdux`lo3KA5GcS&-*_B>=Yg)0E6^+31q!=wHXi|E}NE>M24L7S@wsofCphG
zr?7+!cYwV;L9`u=W)4e+%!<qQM!U<5a~j+e1IcNy7W!y3C5vx}WR=tbpvRrMe9_ap
z3a$_WZXXc|ID?XTvuS#5F1Sw>jTtRAk=aaTmZZPAAEe>OW-hL7^!xeMH@RoI&j8&4
zt(%0g<Bv85fEB`Td(=K8kWrJLu;yRp$4Q?;r%8rf@1smQPcOm+ze><N@TFM;%$i_h
z1;3hdyd4LD04Ma0g`B6rmGbA5EBk{Z({Plm=jpA<7c>!d#8Cn1j3NtvWSOS;TnBg_
znQp@-H+N##fXrrFC(<eWgI};#z*}_3kY*`H&x#KYP!VGT*kW0SDhiI;iIU`3c03&C
zk)_KZ#?V)^#tQYmN4U{V0gqu$J@<kMb_gNPJ!_0BfacZ7v|7-!?Ux%yE+2f5iqAy@
zcL5=ID(wMX=S9>pKa-Ud4p3Xrp5_vW?LKqUHQWX+V@&>kRW$$_H8~8}KKwFlk+cRs
zfqz!a$UFpAV9DhPunM-{0Kz4JdK};8EIbS0bfr*a4nqp85D(dE=<5U&j3=O914}b-
zoa0?TebDCRO#B5R>Z8h1dEKab8@NUFk4(PON5M5O3bicm?HgoDal@h145Lr}x3G_n
z+xrlA2RGy$x&E>vM>Nd|%Spd*^;G_Es<7<0^AD$&TZk!=+#ImC8cbY}+nu4H8?|y=
zD{<TS+CVX=QY#QbGuL4&jVv$-#h6OrjSoc5+w)`(d9y**<f5Mo3SflvzmS4A@TQQX
z(bbNKMgapxo=?z8iVUEvpkQq3T6=hwsA-51i@9*>G8kbFw%ai@8UO^0rIAYtCX;l>
znnid?IB+@<)fYl;j?Hu66tG{3hlALiVJ370c-}TV^j6_)R8-0Tk1z{#=>V%q7g`9I
z539w&=&KRaY$~E&huX`tt~MLCrs*Qle8xlhPtL3MyST_wt*eOyww!#MQQ&0#*|!g_
zUV&dt%Tv4d;g*OvAyY5}OI;I73sU+jxo^HagFY@u7%B`|<m-l}v)o_2YX~#31}oQ#
zqAzU`D=Q2vtSHK_w<}}KR(M`lNNHn*U8mxS5e>UMN)RU8S0ny3QOze#a7tJw;nPII
zLv)PfQYcJmNOyPOp(SubPM07R^R?AL*jAd5ms=`On<ju%R0Zi;?fvn&m~ngxLvcg-
zM)lMa)qqT5-f`i!93lv)ADl|IXwk(lsI0&cDcNPS1t}+mSsX@Gy2hub1Supm*B=Li
z`ER$CR1LC44d)EcU2|yMfsi5GK_k{ZqDcfaK`tJt5oIx!o53==1cPQuMl=w#!m>xB
zqvn;4v>y%?P6Jyy+@RD)Q;{4e4ThJ*lr$0tfXGrro&kDmJQ?s|wI)Ql5&ZG)TVD$t
z4=Cklei8%Vu^`gZ<37lc%L<@$6B~d>)UjIwQWQN)4<YZ_6lc|U<ufg?#nEFkmj=<{
zWXgp~cKT6_W9ay6vdf+sMO{)H0Hrv&N8J^DGpuL>VbelGj|~!Efsm({J2i1M73;G0
zS6qxC3>+N0v>_Qe45Bj6hq2jfF58kOR#(+lK_=v~U`iR$1r)&WvTO8P7A;??w@-*^
z($3aMU3N*Dd+Sc=RxHE|z&sdhV1>@sn8bPG0twdxtME2Oexx0AaCQ`9(oNwgvXe^z
z9SF>FM5VHTk>!Dep(%e<ik{zsRMADjs()fLMJ^<m2kjbIk59zN{f$NE5y<Dpaehfh
z8_*c=j|v@D0;YK%Ks`cgWTTgrofi1r0T$5ERFOFV{VoA-b~|H(C+V9TD|5WE!3+G=
z$kR4}ZfvjPB2-tna;J(B;mR&Dz<IBgjFL>pu{;UjD_%#q_6LM`0pnH-aNw`d>j1rf
z&rD@^gri5rTKyF6z;zu(ollRE_B^A`>vJJJff@48Nb7bcO*!z8#@!ZmJ~~HO;)EZR
z<(8C(ADfLEOV_-@P)^f|yI3)dOJs<})LZg@Tz0ZRM=W6wD2grZ(at%6!CQ+SaHSRa
z>B05l;pP7&a-V#j9Mr&d8Z!i0h6gG$BP1SfvszZfX~55{2#MAfWX~u~O1CN^P54xV
z&!6Z743m@$+2P%%%KsV7$kv;U*#OhRuR@R-3D=ez31A<RB{vkIMYq94u^j{6&L9oj
zQZQut<uV^ZlvD(lvXKD*HnEi6qJ1QtXWsRwbv&~#xJ@*J#*Y$#9r1nez(RN``yJb^
z)lu+!4*N{r&$nr5j5<m)-cf|enoaJ;gEX*;`?-aZ!`Uz0?lEHFM%O>m@+h%h;i)js
z49XSnbFIh_dBVU7S$)k-WfR}4rkJyp%X20{E9IIdyacBwKpZXyPb05|(_;r8vO@_b
z?Ol2Z8?38fh{zCxpgI-8A|{;O{vDt$CBRu6!9AO{gujd$*^z(=dd0aM^1-Q$FoiLr
z&Jj!b?1BSuaPU@V5X);*orRV*&WZpgHvB8=6=I$R0kla~*kgbS#~!Q>t1jbBsLmRu
z@b{!}wIdHQpaIh%pn00=yrVM%-M1g;yOkeA9~e`G|0n_gWAE3PEX&eV{&INgL#aOf
z>2=VPs=-gfGBD0KkkE-`jTEQXSA9w_yliWT$Fg;pk#;8J777VT*aKf`t`LV?pV}3U
z@?q6+=uL5_GBz|W;%TtaQ$QENONE{u%-UXq-oL-o>=&n?hI8DE(uYO1&Qxv<zt``H
z!yP2*HF`!|=rpsb`<iFVm5G!}{Zzw8hCbk{h732q|HzW1+2$ixR%|N<7LdkqquOMN
zG|7kBif|N<z5ZUY`UlFB%xr7Asdu6sC~<YJkvUdV^E{w3FZ%ef2U3s7J(%y?dN`|Q
zIVe71?&*@2JTL4ANrr8FDj(|5SfElkO|$P`zI{H4xk(+->%~kU3+KCCP|z_k&7%%8
zQvuXAjMuFl!#CrV-9)=0rcb%_Ya#LNA;b|T&Jkv)l!|~>rqCwJngoz~E&(4T1Y6A?
z0;@<Fr}yBia>94QAps3<4J4v*v_^6E6M5Vr+NdVy)Of^}<){Misx*P-&=nzETu#gZ
zRg%pm2j?i}UB%Cxz=76enl51Hd<hZ~A~(XPW@!Q}qusHWMuXnwO^3d#51E5#_YEYm
ze@Sw)((ZxF{-+f3c_O$13$HUEM=kpljv6O~Xe=_6nTqCZbs*TmZZS+)A3!}phZ0lT
z!ZO-n`Jyp!7ihOiw{x%_8BE~KZo=|o7Al|W4=hO6hL-S-crUBenhL3DoXM%HIG{Er
zSRveKX^j|}-9w=uT!7gCpa~mn-nY)61z=E*CKi<UdE<=gAkZX$pi4cHNxcjxWr1^f
z4K@OldYCC$lJ+$f_H!9rqseKM11DUqC={I4RC1^x-Ip=qb`*d-79w#9{nztkGOW_6
zL331aka)kaWFebglyp_oNMl9-^5f7{%)%0jmCqi5^*3f=m0OclzEXs~I2_7aZzSl)
z4_(_34{51@uELmrjY9livtqag{?g=K^{z%Rdd$0ReXP**O>BbJV5_WX7bx9Q{lTh2
zk)r{6L7z%oRQnp#24s4Pb@!sR7iw!=s$w<l7j7>aM23=m4Lt#0Dr{u+Nvim~Y%P4W
zHn<nM<ikh+k~JqS619-G?NKLp$f8cQ2*B(k8BC7T^l#e~24EM+&<=U%{K1bw#2LZ}
zr^ql~AoLta>QFu@^Jr?^U)6iuJBFlk9$VY)A`TZ&3Sui;9xvx$;$>y@F%MY=0<G_R
zQf@{Vz6cpo1F67eL2v|T4lfW^0Ibzejgs1=zP`9=>6KzhqryVGZAmx@SV#{}1F1i&
zK?$sJ!+$;sM}n(JYz9NaY07LcIp!sj1nFdes8AQ!_?~?V(+ljIXym2v(w{Q5eSeo9
zdvCd+Q$ms+{7urVEY|C>Wh63m#1Z{IvLvz=D2d#Y+<95&IVAg(6WhL(5v;@{A1)z_
zS)Ow(k_m5gNSx+eNs#%)STuDaazE+^sfNg2?coUz9YjRvODvO8kcgVf;24c?ksYic
zTiEkNl^@oapHYftC9AmM&C1#zDVo3`7LPd@59lG`c>~!jc^VSpDAmj&^aH$?hTSRm
z<Fy*Hz3$!?-D5l;tUpj~#1tP&0`yR1lNKhb+818!oy8&>wXsv^R#n8Zl$w^rb0co>
zWUw;B(TM+PaRwg>SpbFw{OkSF_<-pH1^_wEBGe-n9?yGB?_r6&0yy!H=?~1q!>EGB
z-aSOvvekfQ4S)GXq?IAbUd+i46+UOZj^T#IDt2-LjbLHVAZ{;bG$SJmLOVhOMVUXi
zf!4w|I;j%0fyJNW7ASmhe@&x~i>w%VvARUFCsEK2Z5t#;7@|+#8vY9CA^yrMI8#kH
z(?#ioug~g-DrN(~(5=W|nHi}vEoGm_Vd^I5wx~WKe=0?zOov*Qr$BMw&rPs)OPgTi
zZdYxL(JcNJm6s~cAZ;dUeXt2Z0^&C+xD1|wwVnyGPz>wbP@Div7eWA6@Nu|!Tm1E4
zXv;7VX~=x$n(-rR=ls9sgwLCZxNK*fkUZr?UR4>@^kfF?gslsJ<TfSD%{`tjV+;6b
zH2Pt-oO4$6!4qQSs#TGYp`K|cc+KJ=DItp7Y^tS|=A_?~SzlDv1*l#uPvvMrb9O7#
z?#{B;^T0Dy12t)T`!$RxZUZFPXa;L5jnF|!E(0gv#%jk!d@^Uch)X#SE?NT4I6aev
z=F7O=&()H;)QTbTpvDYQ0IQ3jC<B@_%P3QjI$@mk8p(tNA)}6d9OZIN#anYd|3Omd
zPAI|_9~kBBSCKLyEi59J)6)Gb4fhY*@gnB)Gp=;?nnP)4E^==e=Qr?RuC7qb#!5pa
zfr+U=>N)|1loxIbSG+4Mp*C$mYth>TvH;3ZZ0#%q$<2O!0Ljbq1Fk3bNGO)!n6YRe
zOH5TuXniQV59Bxp^Tg5um;{Gunor{cA!67P0-1|JLCC<$h?tE5qZ_L_m~B%6{}WA@
zL}yi+y%tOtM~4=&FpiQXuL;z22N}^y8r3+W$yaE+VkC~lYIGX{)8AlwPeaYT^ek-H
zJZ2_u)>{F;l?Y<~ce2efjNTgk=4E~p>e)iHN+R-cBGq)O@fI1f<CI8hfIipw%o!r7
z4|hCdv@5_x$l|XHXaFC};Uzr7i?#-k2{p&$Tt?~zdqFs8FKXBBUGeXimcd@HRv#M_
z$?7Epg|XtQj&vsyaU7fSf1#|El4KkL@->X`M*4!-=zMA(!M7qCs$C*vH5NP=sj~$u
z{UDA}zzP*Gh0FlQVcsPGg8Uj2wE!9BMig*4zc?&6SY4^zn21^Rj1l6zp87*ac5Q&0
zSChB|>%W~ttcVjQGADJ%5}FNt7%vwLoL0b=<}6B#Rm%h)%HN$iht5e1F4U9a*LvF`
z3~(8ORA1mpPFW-p-hoYFmZN5=ay$izn><)C=x4=g3-1NQn&pzcgTDLmS6cm|864C2
zX$@lI-}<uPb+Iy2E(qa0lj#jD1LIf?imt&yG&!K|IKJ$HRgqrw1cpbDMU6YFN!^$d
zm-BH@s5N6fvbRVHMP-=_r{r2F*=m(ExHtRnodh=td{pjp$vb(*lDJ8_3(LILp5<XA
z;&V5Dk9GPTJkscBz#-UjdZ9Bv^JHugBu+snbPx$El29QR%};X-#c-`8N%fedn$}?o
zC_?0h0EW~9N-|n5bRNP(*x}GbzmK!tO(;Nco+1Y6_QA@JHW)2hWC=*|CK?qif@Q>{
zz#Jqd$Ms3(;!FczP=+nC-tgo8_i^)#NEP_X$e?QB&)9v1X_oJ(0_D66f^RTXqYs3p
ziOE=Z=WA7sl!4Y#Mb}vawI9=p{_7D^K&q7vI1ujNV%rnwN;?(V=!8E1S|iPDw-7{0
zP?Fw=WJ{}hVT=LrK~c!`kT5;lxrB3+q<2(5pRSl&@Lm<tAaav_`)3*m9qYTSdj8YG
z=naybzRY>%LW0)NR$X8PKM|qv4xtJY`5Nd0Mnx4dhzx=#O3}#m9#0hG(7kZ0C$o<*
zRlc?q$4T?^>whL|Hz+HOf#*jP@->8k{tnVScsrX=5VQubAlqo+8ep2HH9cA&yP%@3
zSE(q|<|pFnc(QRJF4NyTno(W?cX0C_s)(Fhf}Rt}2UDCR^w6Ns8hlL(s-@DjsLr5a
z6@bN(BRR>VEhDCQQ_Pj9t=XYnSh-JZHZGFN2`K`1hS+?S9airR=eKgf@E!Xw8G{$e
zk~^8L>zFYZyoxI0qX{i*=Gb8t>l`qkD$xFT=)hsE8x?k(F}5KPBcluL-9&!{fw2st
zwGYyYcinq+J0lNy7=;}+F#NT!c_Db(C9Oo59Dxo=RgBe3g&a*mao|ZcL^CF5lo01s
z5^#FqF(?HFWp#`xJqhczP^lVw8TY9M2zT&&ia!~zQOT^omAbsxqt;w88q1NOgzWa9
zxaNq78#=+jG$3FOtVk#;ZbTb{S})e7rW8SrHBE|a0gdq{&0so=Fc(qfhJGWEOYjWg
zLrg~vS}pMJmH;8g_~f$vRy~vBdlPY7j<AWl>{B#R*FlrhNk%H%j6?Q~BMUC!ONa1;
zv+yzYD|%87m2%X$dsW=JyVM_*;3yHYlKRaSjE@=l`&EBuw^GhvvAX5|fqx{{P;*s!
zqnb)HP*v1fk>zxww1_rPZaqb%QsWXCdAre|Lr*7Z3r=xF&o<I66`5_1GO>FTFV1=_
zP{=!R$AH32RKGjQt_t2|tm-CR9u_N9R`5-I_vcQNNQODri8-mOOWV{!nQIEHN=c}`
zNvNKyC-oGVoQ1NI2emB1Ab>Nzwa^vnZ<MhTd|hdEVP2J@b?Ocz5CGIhl8M($^rW^P
zwi*Ft7xJ$;wSgLFZg35jPB2Kn8aF>V3&6AyrP~@FSkZ7Zvx9Z>W<6XtDK&)tcz-E7
zFWT!Z7$H|c1b9p>yk4X6L$T1UL*b8oP=0Oy2JGXV#yLGfB>iQVlGoq}&;=02`+zIF
z9i_iOU0v5I@n|VC`VHh^^Ms8d0!Ay->IvVWeBs?yHE+_5SIXSUWWj5`q5DweLx4IZ
z*Wd}VH#Q}l$FjL^0J=DqboWqChQr|xA3m3mW)uejGBy;brz1G=;3O<MAaIhU&69pQ
z?=$y>K817SD-J-IR#_1WnFWWJBW6wwR@iLc7j$@J<n9|)eK8c$LI9!~ghCC8+Y!uL
zBAyH}lzAVg@9%AzH+;O$RH2$!BCi%~Jal1^5~%xl4)bD>keZ)YcTAHg_ut1x6HsX7
z@9Y*=!j0_FJ&BtLn%>Mcjt<5T8A!a3+F&r@bm9UrW+4o51rA_sUdjp#1C*+6$q-BN
zz>Kcsi7Mwk6aYoM6lfU%1Q(@+oz}NaHgRL=j=396UCOZAbGUUX^GMKy06*fA8jYe$
zWHsrssWD!c>RFacvBriV%|RpTpwW6C3e>aMF^R<B9NxlhC<gbfpT0vHqABkEU|Wd!
zd*!v0Wtu<CsfA(;GCFzkX3-^<+pn%3rt1)E=b;QlI_xIKmVIK34msul8vs)5<jbgn
z>yRo>PjHK&;kp~?hx6?fGU8kS4Fo1+s+Am4R4PakzYo0CL&l3<G6^0uEu4@}NN}()
zpd<;0vnKYEA<lq*CS-^zfDRb)m+i$%5Nytm&C$Ntf&$3K7Vr`EkQ?D;4;|1LD*1o+
zgC4h9lJQgYqO=!oyC)oJNGcdH4^EVt5>AAj^I`m5Quf{ukC)2i!qZ_il!HO2nuJiJ
z+Oq)B)E*i|qRgI0Ol(YqQb3B7SkMWJ`eG}MuaH9->aLEsNh<%t4FRg!0^2oqr*WgB
z$BjeO5SV?Dv!?Hm3OTm64LgK#(&x)GaCks-XKEkt0|%aV0ED#cA<P#ht7x*hu<!;k
ze?tm}T{<jNnM`n$f;K)dMvM1*pMipy>rQP0FvNr9q*T54xT{fn?GaoUE}RMpKk9{D
zaq@*PELdG~>T&Xy-5T2HxbA|f+!~ADHc09(RF+{w2X@n`-!gs`^LzevCpBZo3JH!D
zq-AiZQX&rymDozbI0S3bSp!#|c7Lg>DQzii*m|@l0p2ckORF-DkH%8GsdgkZb?w3#
zcUn=zz-QX^!i2(>HTX(Wr2;THX8(|Seemq1)d)42JcH(Oxn~HEaV&&$b$8Zh)OVkX
zce1XQyzS%FUxbu7P>oy$UvT!xK{Q}<!?bAwBL}fXM{S-v$@uqUehzH|YvSV=M%_eB
znW{H6RvOJSh^50GB-W=!unc&NgDh{Or<BtRKx<t^K5HS3Jq)^-V+Q9ODAn4DsMk>J
zdlWdw0gIfm9DhnCMnm~Nq{0^DQ3#BEJ$!@d&s>s+5qUrh6t0cm2$ErP41%fz`2yiT
zqjEk70W9PNV~!m_Hl3ut36QP~kU-)JT(44mCj-s?($$QOjmN{-ksf9q@j9b&#mRbU
z1iC3Jb+<Mt8wCn9a&<Oyl)u}N3RXyDR@Qfq@zg;f!bVOcpoauighaUB;_NyDiG`9z
zv>}ET(>W;sRe9qHV#)dUV?PKLja>*d!z7K|o#95`*?h@7olBbHHjO3?`Am;n{y=i2
zv^f#-AF_<$;vf+KBE)Y=RxAH%<I57ckMM<p&ngp0{9B%lrL0v}+49B}0S!_@m#iCq
zbRICjB<$^gsTYQiT48VG(nZIiGBa+9Hvd#I_x2gcI6bc~fJpQND1$I^34}}C4UcH0
zS4fD4>$MY$J2<z+hx#)jYDnLMh5tdBA2g5Va})`6IQ%g$lK9`5GS=I}gU0?GN1a1a
z=nv?<-F0{uq`D>zoBEnRFQXm+JDB)~fi#{TLW><I57>|;_0>&8J+JTtet|VP#@Q&f
zGS5zrsbK)3Gf36J&wa0DLgd`4V80B(1<_d?*h=sGW18E<F+i%|2<71_3YfVl<=9()
zkgH4hg(&k5Dwx5EI^Xq_n>c@n2@c(y#&wv!0@|<k9ISw~w`<8cLm6HN%}$O?c0rPy
zDLI)<Nb6^gXls1OpqMQu8hK0nCoOz)TtpcY@?Vx#Gq?U>2?T-&H)F@ANc!@a`WgN#
zT_FI8;ZjooDk55`I>jf94^Y691yO{-K<JW_02yi9dg>;us4q2XaUDhSq+aqIZz0LA
z5lsy8j@SK$J_XOCbR@PO6j+I5II;Vd5{uY)NE|UM)yCW^X0cQ7s&AI_uT!i<duc*e
zhbmHJ(eDLf@fNtiuL=gSHx>Kw<H0K>$c2S_o%JYM4-?smyGSb$e5a$r&WZ|WTwAQ7
zK4h-VJ#85rnp9cAP|EEn!X`=+hk1%h#YvEs<0mchQa#(&)y=mI9iz!WXGFgr%ED$d
zc(giqqi>I!CkVj512ZaNdEaik2zvsy9+|{<yxa6cBS)GpW$|mLMcv}ItE`Mra5$Gy
zyv!8!w8DW`+`#qfx}xI1$P@&Vq<6;$WvCICU4=!Y64p^74e@h7-h_5PfvS)bfTg1s
z1}sa4N0_2+qXBu0<n8u8Q}AFGD3aJQW2qPCZ?!waevTBN^ic)EYJ)`sZKhq@Tuac4
z6)+tV7J{zkHfX@i;iHUI22)hItOtB@=u=IKMp0(?XgYlC2B`o<AMd&pCf-4Mm{Xt9
zCYZGbQ7Ma6<EbC_z3cPK<$%=vEKKECvtD!xqCb+HQh<rwE>?mdPg=*y6UO1YYSc~~
zMHE<8Y&Iwnv4{VmC;_SLND3mly1;8nrg7*XgA6b)c}0)>+EqM=aXk+7wde9E;7`=3
zIDaP?NFu0GdiW_;;-|<5j)&8j5~wY<yUK4uPU$Mfj`60xiYB%5@k%jt%Laly1ybO`
zz`!+9p~7^#2hgCn;RcER(b_}SL`B{L0@&fu_S-1`Ho#2oKOD%Iz4K=3Pz8DP^dkq5
z7alAGoG|(H0be;D!>4lr!i{4%vB{yI;}09R0L!s?brBsiD0FD`n~7}mELwwUD45V*
zR=)*{(`tHnQi^hAa_tBmUc-j~i%<~!dH@Vh1~-Wf9RL+@ENL7Cw1}knAjYB)qsc@^
zoId#x$Z0MY?T&zf>RHRkq)O}(g!mw^?LSWmfnJ=7BeK0#6sAR?TK(g~rQxCS9b2c+
z(u`DMm%|Jc+j0?HhkwP`lf;fzVmbp*V_^x8g}{Lm5!^gTPAA_8pRcRcFEQmKhiqMu
zJ*H3|4FHh^i^4ui!eow|FT-#zivV~ef%)kKsg8F3g(~@^3ppNbS`f`dGoCCV8%TsZ
z<tYOz;iiq2Tj5lmOFd%Hp23;_fZ!b66;hJd7GrfNNKUFY)g<7el1y+a53jwj2Ix$J
zw<=M=%mCQNd2ng~gQ(NF(O`nmopn@dF@nzW2BBvZ#JBojbM$lwg(E+Vz_CJM%Ooe`
z2m$^!AVmFZG-vTPL#_UF5+ibU#nwqwssjWBbV#XK#f91R^3{2j+_4;bxY^hmg@DM|
z(4qlo6Og)I0Vr}0f>XS-R9MZzx;TJWeRx!MN0h+o3Y{~d^31x1*mxw|@#AP+C<I0n
zd>~{nM7!~}V9~;j5D8(*2B!*870GjPz~Qeo%~UoVAVYp^k{@5c{1^$jdl`Sqm$$lG
zR&OgRwyiq+Ne8f)QkSV_$lDF&8qqucW%h<ZOH4}$#8a75m<^UGQ1#rAZozn*i_4I(
z`S2htiRFoQk*n2r2-3+GQ&*S2&sioXX)g$zsOqe!omqvLkak8<Yl^>22qN4?Mdi|o
z@dM3$frMNnEsv$)!s7@#4ce*~fi4enOOT>!6`Q&n`JGE1!22XXHL{+{uo)o<G5Lf_
z60%IBqnw`Dgu>>Ok|S{qsM>s*vTp{F!<#!hhY|#cq>4zAbc*vF@G$g?R^g5aEzm~~
zq>F!f0|jIl9%P(IZKr;GqlcKc9efpPt0O24%QFE07)I4muy1d769b229$*;3S*F~f
zsa#59HFw6z?+HzvY3Dcq1|>TG$%u&W2q|vS7?Je>Pt0HNW7P72g`A)r{@BA#mfICo
zVcU?3g$Iu2;M^^+SmPEpu+{>${}D<JiBZZgE6mNm0yE3&ED8j9E*AX@ny1YG;6srD
z0XzUZK*YbZ93H4a1D-Y%fh|49mbJ4oi4k}n3rBtu)+zoGr$)jcfXJU(8>sO%xEdYy
z0`)<gyX7H93lVf3#3wu;XomwgYRwM!<@&}E6WI{Tf1uG_o??Cd#DVxYJb3W;CX=GB
zBPoLiFecSTt(`n;KV4#fVh@0*1L6+D<UOV&EBFssfo`PP7KX#}0U=89!~nu&J|r+-
zXk-upz9)v#WSoc1Vz-zG-n_dKsI2LIbUFAN(&ti_K4w9qdnBVS-+Zi2@YA$u53TZ^
zO6#2YF=FRQ-HFRn?e&p2649NcPzx=TemYJf74exQ#wzA!XMSmzaEuZO8I_rWCT=PW
zONLJ6i<=>iJSbshpFm(!BY_pR+Yy3ig9m7RE!=w<F(pfgN%nGiFvBhE-lM66^y+?!
zqp}7_F<pX7l!rJ8LI=BwB@pL7CnFk0zHw0iCU`;jT<JUI0l}eg1oj_>5Yo^cj%?~o
z8~PX6f|&U%584rT-33s=p=1FilPqY1{4st|=Rf%DwF{57i5hwc{pmqq!-B%$U9yv#
zeSWmH*rm4Om9-^v`QZo){Ab01U`Ti@@pC1)Cm)$gX|y6XC5Z*#BztUjlemznJa)WY
zfOMF5jQbsvMGf2GU6#%_a5M!EvXc@*6H_5fk8MtKIE@CTRD^_@(ibcTw$B=Z=_&4i
znP7RmbvD92Y4a$$!V!ng@xl%Hnd(Ne_VX|hM<9F$Azh+Xea=e~QrWe#ejb@b%ocr4
z#EVTx7>JoYN$!0}rSjH@wkbr=U|q0Sz-5NMVMDL#QA+W9+!O)@wpwDkDf@e#yAr-i
zl<hOaOSU;tof`lt`<XXAU}%0FN&E?ee6Mf_x{FlHxo*h!7IkY0fPw}J;Bx##WegA<
z3ItWIRl|HW{puIPW(|53k@laI<57TZeNFfHZC?oH!(q80St^A)rRjrJM*r+4<U`YH
zSy`U>9lUP6m<sqGX-GS7ikwR)7CeA-&(gyT9Yomy(fTkcP@sW>U8V=BVV$ZG62#&`
zR|=qK_~HKQ6fb6?mKh=X(@G{@S&fv2Xq!?&v8=Rug$ZQtY1v+6t^H#<B!tQ966mmu
zsEye2M`PlrA?g?F8=4@wv>Qmf6XHA$A;KPK87$whl$RDD5);QkByhlrQ?k8x(MAL-
zgO(IUMsZ<8(EO3sN#GnlJMG3#Tj+?9hqoZ*8_<WD_o%1?s~)@6mqf6(%NPp7F%BeK
z;4$ScSRxUB3Lr!SnG%*rj)76musM1nTJ5)mLWVpCLd`BkPjEPN8Pzl*2>J@Ps8>jF
zTPtr23neK;xz{3msSjd^XS6OnXg#}I>SeFkDx}GzQ;V>rFyL1$%800!qH*AB&4>>t
z+Gx}}GH^FAYJBVCp18Nfg<zGT52#(`)=HfRU0F#7QTvT!sR)^nlIP=&2Z%GHkLT$$
z?f{;1ijod#pYh0y%kVh`zHIX)IFL?K&N3tnP1F<38awD6F!(hjauKEljw07(wj7)8
ze$F`v-*7r+*cdHEN7j#&Q-|NLh|jhWjAAjZa}2IGt&n<Cu`1aeoOMWph;A#1PSn7w
zoXxoh|DkE4ft7t^Te3xX7QckMiY)#$5q3i*)}ZicS3@OXl(F*mE3~}QTqO|T0$8%4
zVKih_e6B2ScASKCrllCxS4K9^iQaq?%!zj)kti(rfmV*mKg3XvpA?cK@T#QMmMty9
zV>~p9x{4w2D#wFWndmU5s~4k<R45Sbujf96zM@+J)_qGZ7Gi`~Az%5`U!>hVw&`q`
z8BJ>xX|G$wf`m*noq95?H*1AV%*A>@#D@ZE%+-+Sks?f444yMtAPs7b@mbJ*KaDXU
z*xyYN`~#sg_otG5Sl<>U^TP1cHY*b2Gic`aI1r=m2VgF+s)UGWStj!pKpl?}Cg5m<
z9niH%(1;@zYQZQlqbSSxjU3nj{tPzUeC6SS4xR+LNIUR4CoR|4d0zzwWbA>b*X#yJ
zGegyw9NpRcCH8SfN8N>Q5f%>~?236Z)5D5=qniP$iP@<k98DOZK&>oF4D2-z8ht}c
zD-C^_AH@nX0OtZ#(`$ew=h2n3I!VQXGR`*al~=iK)l_Hshsx*9b+HgMS?AznM2{y?
z%T$w=5a%Ht?h|lD`>}Cwnrz)L=_YzkTYM3pw(J4yS}Mr+1f;Bbe*5}YPqp6;R0dN0
zG`@{Llp?`+X{l#lH7J8MLXuVc!GRxukzCNrA%s9q|LK*543VO0)}sE1R^VYgq>;9`
zHQWe*SYbK003suvL0-{Kw}=zp(&wS%LWAfvXkb{v5Gs-JpSrgK(xpp0N@G2cm`f51
zP24k&xFKBS*$W&N6%LqZbbxe@;RC1Fj4}ZU$zdFG6af{;8M+Wdx#CDawoK^-P^L!q
zDUAD!=YHU+)^DzC)6CYZz%CpvHw{F9O%cX1W$c&5K{MkJ1;1pwC4NhXi>1Ks3+^^6
z;%u|@H8H`(kO=yh&zlw{U8y5OZk#Al3L?R6xJ)4qpkj}Jy+K5pTqNi9-?mb`3`HTl
zSNR9D9|On$3kV*{aj5KRJOh;=;VIpDiHTwa4lOj-*)d>duKkU+T3Z^Thjg;2nkExk
zoe}iCjJq<;et-#gSQ|>g3u=|{`W|%b20%3^DCrj!jHCepWom&}r()g%QZLpF&1rit
z<aka2i!;}&j4_iEU^<*s!HBa+4^5`Lc5F;bBu|8rq4D5aVm}_u7Ue@jA26>ddP-ph
zg&JxxNgFUR`3-af-5G(@W?p-gJ-L}8kP2EvP+b>bF-D}r%Iw_&xbgh=&B7TN<GEf~
z(CjjbCS3d&l1f|IF!jm;^$Is7O_ZwR#h1jvx%~YTTiE;B;JN)`N-$$1Kw$jz)K>sw
z?q3GmRSY<fD5X$!rV*6DY?GoLLqWy8dk%;jI~RW;3!SnD#=y}FeZwgnk5)7JDy$?-
z;8R}BVQ~qd$cGJm#Z7t`OYOllwhZBFo8R1FKDmt_9W@!(^FTWr#|TUpBSkVSyScc4
zq`&?NMafxPNr95TO~_PwOTSl8ci5wdM=!2kvJ5ZX_R=L#6jf_Qp-}K>`0ef*?^5=G
zsI=^mGU~6JgSlm?XsM-c%SE`dzEhBZ<`}Xm?c_cVXPJH%a!XG}5%!ayEy!~|CzLS?
zc9Kz6pU~uu4NXwiO32T~!r%}2hg;SJfF6DDG|qIa<Xp>&rcKe@aiCaF<bJnxA<hP0
zE-QwVNeu$oAYI5WB6F8Wo%;;5p-vVCCF8ybO2LXB!RMgC?H#~Dm2^nEO^>Ai4O!kd
ze_%-m4HLz8;zQ@kkJ}Wt*?fH2cE>EB*uy<5z;{V(`D1etY>eWuXkoEz!EOmbb-}n%
zwGct+!A$!%!z*!arwm0q@<?Er*J>UgfzwN1!jyZ5K#^t!6uHj2KE>=?aaS8G7ar(^
zS8ZU^oMg{#TCaL46OQaFnK}SAHtPS=W3RS&ZWZjZMQG~}K$fn2-LTXb-GR8qrE!x+
zugIkh#<O}yc=Y(EM=^AH3Y|#QP>rbF?^GkwQT~3Y4T?W+mL!*inJw}GMs+VaU#37L
zY2IT84ec#2F93@W4ZXJ)8N!TrvDWbuW4)hK`ueMi;1r-aBiXgAG3lld7a<@Dh0Id&
zHes%%rp42Z!n$ZuAln)8hj`IYJw>xrOQ77#TPtO0vToGQxIP6oVQ3Q6#J}#NK`Rg~
z^|j$Djl&cX`kC9kY2d$~^2?}}+y_6(Em{L%0`E9o5N=dwg1&am^sKsskr=%QptUm`
zE{UO}vj+n3j9f#70z;D7(wEJH97H!cfD9lF2cWC^9Q|X}co3Z5VC-AQ#Pa#HnRS(i
zOJu103w%?J6ZohFfGyx^!wgYtxO}Drz^p~){>$A>sT%I<Fcv|*+p0sW!>{ad4evd$
z(^O@x!fD5WJy}IgP#zj^$6yHpr&#eqDTed>U^GsPJ8(=aB3O64bx39tV^#YK=Jtbe
zMw4bXBbvaR(2sQ}zc(p$HS~m!d!*UyN2L4dtpWM*l~&0o*sv@Ax^P9T-VCoER6Jw4
zGzAgE-P=^oqmV^DZU!l>$O_e9k5B)i5Z@w2(%$K(UbtQT5GW6sN3vNh?9cnam6jL*
z^pT)@K@^`&zPlfbCVCGBpt_I174gRma0je2B=j5NiyTYVWHfVGFkXNF1_jJBlDP?h
zuhcEQ4bWw7zK#U|gWN9IxA0B(e3%e!lPtUn1OfHYcp*A1iP|GEo3whOB3*}#EP(oL
zuUFA^FG|5EJCVi|mhRX4LO<Q97EJyHD@EjbT9`5b_SMu8N=66AOK3PXu>lWhL|<`o
zuHN=@g0KZqw<8}LvMiHI5$3kt$`L0gBQw{|0rN+u_uuX)2PYn(CJef-zMl7wEC>Bn
z$-?!)SzQd54-Y&84lsnK&`E)gv=U>93_s9Q?O<;3MA-PAc=Rz96Ghd>_^&+i%)%v*
z$DTei4Lp04EGpXg=`%J!Tvwj~b3{(q%98y3<RC=Uky&Md?>>2mmf#SnF5T4g9d29E
zS}G&VpJI&i?O0(=H8l!qDw?4}Rwx|BPG@XYScbQaG%;FoszO}K^J1$x#1m;c8!puT
zZ1YCmqb8-7D)v~IXn>AFhyVrh=mCj}+6;Z$fV^V(&})soB7F=S!5Lu2Hoc>mL+hGe
zP>KnRvaX9N-(onWC+_tDbD(BMB0`*c#1jY(<u<YlzsvRA@xG)NNl0~=uhb0o2ww#b
z1>ugus9bkU8dE=v#SOfSH#m6z#APDl3&k8}PvLdsL&CUCd8hwR!wxVOvj+fGj7;k=
z98+)Dqy&&iv+yOd;WhwgH$Guva|gYH<!-holrBQJiUOGnsb02)**U3-e?6u;os$=i
z8`@(n;~Iqj)BefWj+UEoxZ)0%vqTdn)<AG++>jHb;>8ydK%B^JSOhAImdX<JC(DMw
zsZ=(CRS$3&TP`FUaTR9hPYw`bkvK;}?!SGFNt-2`JfTa{(GnoKc)sNUupv~Rn#A<m
z!s<Hfdt~u=MJO2+;K;Ac#ei{l3>WaY1<Fx^t0Es25e`WJ%7%6N2a8ClcB4jFq`AeR
zMp{cnIuqt^e+6XVh`?!Yz4fLaBs^6^KfeC4KowNskojO)zv(Fh58x!#{CY8;AMX33
zd8{BJJOXpa3<h=qm<JstM15UquqUmXq{au7-62+Yw>)AZ)S@fc$=sa>lZq>{YD+7}
z;|h6SKG*Ap2f7pDR%ah-b7A8WTc~J=fxkq=lJWpmNRun!5=m&`6S~8k1S|G7%o+|M
zwg<6NFv<R71&#ww$x$LNfi?<)*(wVyLcVO*spFDJE%%*NTt}A_r%S5DoI~DjgYS6~
zA*7251=$zqWSfzfAI1J)5Ykk4LH+g+#Eh#GNx~ce9}&g&Z~mY<K(h$>;jd%wcK>o?
z2j}5YafuH_tF8lGBp^;O{~*RNa6>_;&^iIUqBr+JD@81s$G=oP4_H|8K2F-^fr1k%
zoc!&6xVgZPNxB*EC~n3L0DVa?_n)0-G>xGm*#;RmFD{R{1HzjmfID`IpyHCr_Dw`I
zSLr}fc1M;Hp3@GKfvve{tC=d)Q~}i@IFS$PQ|PI^UUG0-zo^z~$Wz;3Y++{e=t-#`
zY_wHOD5wc7-qC@YW1+h_Rh5+q{@s+^Xd^=!DAC94`<2+S$nVAO>iouJ`cx<=26AYv
zkT&sygn3EQe?!kf=0z>kdsK;&zJ!K;dWu^tbEAj{{7@yT05p30Cf0v^7h?W1mb0_j
zF~{`iln3L}x@@WWW0NI^&_ez}m;v7ov8D8x9C*GEDF?o-{PaShpDPy@|ETddFH{LM
zvjKD%{)89wfbax1EV7@ZpDqkv2HAsU`SK9Zw@k9+JOvaoa0!=ZFrY;*x^|RPaAZFr
z{Tfh==5lmv+%fM<V5ebau3BVczbe28tNRT1B;XAGdW)Mx3O8w1k^{e*sc&-RP2DnB
zN!Sq_mTnm=?8>u}x+p9WIg=M4eB=Rw+N}Xb#ujecQ{pHXg!QoM8D^gYoE0`z0ka|i
z-_w-c5%QHJ?g5MQj5B8NzgeS{5NDhN)i_#&!GuReF&0_>G$TL~5J00m3z{^TMoRe%
zJbZxBP#GHn6lX2Py35Eh5k*+&m3NlwNcADrc*KebiuutFg_B}wS+c^Y*(C<FydZL=
zTaLGcX060UaK$FQIs@xhxB-d|+pWF~ezP#oq;>6oKebOSau^u4Bf5sO&<{Pvz)%i>
zBwOo@X)@$z5hQ6Y!M7Mb6}b75NnL(WFV;hrvcgD!Xi0Ub8S9NDYAkZNK{N<=G$N@@
zw_ON*vVBBU4t}-8g7t|-kTMK4xqKpdn~reICdGn9vteL2&WZ8I{i^}BNW6CdJ{DJk
z&Asy-eLh(QzjS<2?Hk~vNQ2~nhi2kU?d0f&V(Fy{XlOA3G7ScH@CjWPMjO1~z)p`t
zHs;Jb))g3Z(4PE5&RC8+l_>!Oqz|m)g{xj=H5Z&Lv^F50&iTk9OG~ZR*PkeSXj6;8
z4LwCHEXXzpC^=sl;EKz^fbpB@Rxq9s85qJTb*FiblP_@4a4F3-h7WY@(3iR<W8VO-
z-BdZL4p(6zY-476i-3gyB@Zzd>5+kjAIeM2D>739S$7sjkIi9M4V>ZVjNRF*3Rq+G
zAHqM#QPnZTdiLOaz%C-r3t<r%F30K>4P*?VRsEW^fPIM81&TY@Mo%Nh{dj>hMH4I6
zG&gFpBEKQS8Oa5gxUaizFqO89N=6<Q1hhTqS=w8iWDE2Pad>>@=^4W}fK5G#1}&|Q
zaIP+n84u3N%mF);wyN1o2tA40wnI<X`_C<81a`t<H!dG=@~G<^A%0}W^P>yHcF@nQ
z@4&-WGW=%ervm7f8m6B~bs3DCs4et_PC!Wghfu{f*-MP(-Gw*$B#FNlKqH?p8y+5-
zox;*_K--T&HAGH8rw`Q6>+29(pBNXn2VeVfi;?z)9pc&`6P+a{BVQRF4S?bP3S!$~
zmc^YYVG+fYGHkDT6N9XRZwba02H`g;Wv@hA16vCQ<}B|N3aqQL&6`VtAE3b1I>MBV
zAPNvEA+=x_pGGZ%uxG7}B;A+#0-l`FAp$QLo@79Gi}*(VQ4H@4W(hoj28I=428M+2
zbV_H>O`KJ|dP+&Y!d67<<?{(M1h*e0YPS=60y1?OT87rQ4=7TN6Szjjy9}Epsw_$<
z<#9y(wS3s)iL?YoD;Jw~W&G<dx79f|28##@2~3vN)ou||95zbPO$Hd(KTI#DUy{m%
z>;Y)I{mOH3eI8gX!L4KwCgW&lm7|d<_7R2vEqC&vkHZ^`II!}hIJp&0Q7?mb%zR2r
zYv^fdx>VY)N6TlI$u5;N^D7gEBwur4k=+7`HcA?PDVh>o?ajt;{!&@uhY0GBL0OnI
zxS{v!{NZrGpPDtrLZKQ`OYATMJD$;&vxCXlLin*PDRh|O+IV&`uGh!RZzM7ZRhWO3
zo(~{mT{A0k`wRc0-?yBlb>p5B0nFK(`GQG7&U-PNSa#;zaqlD+!Vk*0`UJDu=aVwh
z!pwMZCA1yypaSX<97cG2oKV7ok(p~@skadz_C`n0B18-GerV%W;Ne}16SpDya#sK8
zhL?vTH*+*&UyY?0lFqk^aRkRcM2XfP1bG0uaUv<{Si8)$6H-(>5_sZz5|BcK%w-@Y
z{JOL<M8Iq@#X%045hzBVzqXnKAD)~JtT;ZpC-+ez9V~9eEZd|#xmowr13<kF_7l^A
z)lD%jdqz@bt-{;%0++fHPwEOfW_S?Jl+Uj+{|=&xPrVGJY%Z4Zj|9o*_zTOMOd-Es
zv9Sd7pNWA=fTAmxhe}g$BuN56Mg^U-#EoXibydW@U9nL|%e!O5VxhC+BZb`WC6Ntp
zon^)rT1VnIg4HF;a;5H!2>D+IFFEA{T_1?3CO|6*n>e!h&6|8$o$zx`WN1|M;clj*
zs|8@7heRW}?vf;?Ng6^Va~ivr;b5V4mgAf|7d58tV%5ja!?F?a{EL(}tG$TQTTxJw
zB1k|S!;l^xyf#%No50!f(g5%iuaG;NMBxa6q9CYG&&yUWxFvH+XR|z6ONxe(SKNpb
zkp`EIBh&CBeT<)HF2Y!p>}!ck^8v92ddwXF@O0oJm}5aZ3nPfaCOG-=ohoo(at>a!
zZs~n2Ik8&o#pCu68!Gvj*FNh#=IqA|IbvADisw<smViPC3f*u#i3V6D*E+ZE5}<-Q
zYiAN^5DMOJlSmz?1zvl!BFS;UJl$V{jUg78POx>4NS8Sj<zT3I3ZbX*N0$30tN;_M
zq$x@TOSScN)W8VBC(ftC0xd2!M%YrKjB13)L)D6qT(11){AMuji92A|!ZO*HCh2FG
zHf^Nn)QO&s$`HdRxYz@+o<NdR>mb>5Sz@QH>6liPb@T?^+p+^&lRViZ;3u@95HTiC
zO9rZ*VvU6a{I)$*sRYI+Ku3_Kk`xCxsTE6!NSKwnyB3{Z?HfG;U7#WZXE8D@SLZyX
zrGt{d={_Zu{&HxpO@myO6~p9Gf+yeT64+$HpV}xZ4M>pjN@emk5y%h8(2$21)Iz|b
zc^dSjkPi|OJ^+9-t=Ph3UAW(Tx+CJ;XwYJJ2!EJ@FRSQNsv&xmQ&YHxOlB3=W$A<h
zI0`obcbAsa0Y)GJRpX3O#S(KmH`NyoYxZ%IH3bkdlV$0L0Ad=56p?%3$2tYChRM{N
zi!$&2T`;HxzAfx-0AY|dT$QAX`o!cSYVl=$>K%QUAxe%<LDipl*BZOCKHFFuE<aV(
z0cZ>m1Oo}XOm!TeZjC3@O(=3=>!9ESxNawdpg5eA7y8||anN!Ii_*YK+liSFfd-Zb
z;<yIoJQ!C6Y!y5)=A7LPLGQc})jX~208bWv!39rCD`j6zB+=h?PQj#IGYF~CYYC$D
z_D^ke*E*V5Fxb`AVoiz2#XKJeyl~p0*AxaWlw#^sK%uONOW!_eKm#Q}s?8Gw0GzK&
z+UgQUKx05)s;M8l6$k(dg5D2OJ^DK|D0gMXo^llNiY)%U>b_|!`YzJNE})>@Ixw#i
z9|P<N476RJ3>0DuL8W{zOCaGFZQ5CuXeL}|7}~ptcP{`9Kp4)U5w91MM`vvUSxuZo
zPKu0D>d{^l1xE3q!7096J+4WY8>uOwlR)!f2idum+LgitK=ESd?D0^f{Q22*ZN?I^
zk26vdF{#ZQl0KIx0e1+53BrVxZ5Ed}Wa{9&^hxEXFFL>oc9MCpM*+t+4B&gNEjO$l
z*g&w|U*VVQ0wVg94_eihN|neeT+B-+?C-reS99l+k`a!{`vJUfc6mz_m5({xzc9I;
zEb*XcaKh#n=5_JKyovVR^&wI#?G}b$<8f;G&pqH97V(_?c<9ZLSl}@>k57=n6r!{l
zM8h{j_ejA|q=s=n{r=?Z`-HR1y<IfaJ;71r?+@gqD6pRlQjKnN+t#D4vr2uQGMP$Y
ztt3W^>N#1yBlc`uhBaiV{Z)4y%^@cFyraNoU>i9Sn#zb=GZ~<ccR7*2BcktYeOSlC
zo4etOJbF%XC6kD50@zG}I<!J_KVDOE9f3nRlZ0F14wm2p0Cj}6ht>;RPsS9L1!I0D
zNf3!eTwWAHa!@-!_`@`Bz`u;`KO|T|w4<NAV=b8tLk)@Ym*lImt&Gz$Z`&CM=cjzB
z#b|01;0#nXt$4Mu$gJ0m1n1OUX0e1c1^r`|v){^S4Ol7B_{JM)XJtUD&v(6O4Dk?J
zeFFrw=qnIEAIvx+%Jz1}Ja!>n&$a+?C+X1!S(yK2P<5F@3H&kGGFv3aVN?NuM9hL6
zRXYl?q&8$S>F5-Q(jxf-NSyLwCt8QrVth>3`G8m$oh@={XJRO6<w+4vbf3__9ql+i
z)t<r$<EKW1Tj*PNGj1Mb_SKJyZJ^eWKeH?B=c#D)jduYPM>_0m9ZtJJ)nvhZOczWp
z!V?7S>pRp4CF`t^{K%@2n|R6)q5MbI%ih<NKW&A-Qca0i<D@KfcP9=o0n4a-td4`e
zoH>gbQm&10GNp*yYe_40<gfAkDigC&d7j)E8%>_b67^vuAc@!*l5#%os{*10y)bcK
zr2vJ-|HS*QOo~CbcCsi!Q7}P*JY)NMUgb<$7q=qDJ>f8l*iPKc@j?VqwpPl<$fWEL
zqU@&ST4;>jrkD@gst9<&I4LdIn(%Gd=m!Q`6*K@l<}}&$^i)ON1%=saTZGTmu4(<Z
zdhrOju2MY5SNU(%U^ixQO?%-?b(8!Gx!46VV;78)PcaP5{(?~Dy$(gnhJA_Xb1b$~
zM&%lXXcBu^?i(d)-Iz2NNO$$q8-nui!2<3ZZWuy@ieYDOx4{4yg%`t_Al;~jgqoss
z$5Wa!N2WQ_(u8xdf;o!}=cPo!0@Fh209X_lDDfi2<#9|eiNu<i4y6`a6N3RQw*IQ2
z)YfR)k37EwuxF~eAdz~jgPBtz;l#frE@XIgdP}#4LTHxw<~f#g<WoU*VAmNHMG2yA
zGd6V3-z>Z;9bIG&Lvxok1vuo0Y#)#-Sk0a%4Kb_hE5zTgn08op-VIX7P$DKP^O}Aj
zB63T|hTLbq!R`y&G7+K5Z~Vmmn`KAK8dJa}R1+iD2*=DpY)M7PqY6V=nXDl+@CG~#
z@0fZ*v(+dSB|}+<J}M&!p{YRYoxBr_1&lIENw9n7kj*e8W1J5OhXEmgqv?WZUy}+&
z1S0G@iU}8_dPo>M5XyV;mQT*d-8sUy=+l#I><3k{U<7lig(xy%T}8TYbps&BpfUO?
z?f{?oO0|MC)e(6>3=1(qqv@p^&P5khW2;e^#$~KmI<JQa()<6!;*9r`6m}cD97<SI
zFvJ0Ns^&TE*jmmx0SLz9v|ydUxHuA+8=Ik&n*|<(gxp@)Y-}gI+xsfsVW~wS0){MF
zY%Qei0aMT)7S3#iLkTv-$E3b!<_f84SnUW!Q-TV#F_$-6c74DlRhR^!fc{Zf!Rca-
z1kB)wg}cawvVj8xSrCCpG!6(+frh|_2wzCYh=g3V#-o$g)}gd$sjy#4SLcUB6ieZb
zTQ+TF;8oOEsHSNvK|Ha32}O!~F+Z?i%#>)g#T4ir)5^smMZhbi>$L^Ac|$_=3U^}0
zN@WJDXvi8T4Swtni^6^VU`PivOJh-}^h8+F$C{FRojqu;5&M98_D^ayMO=dh3fpMl
z!Vsh`7tChJAVJV7^oY-gp&w_-k`S3+3Gp(a)87|F09II0Gid6D!ifPirgF5MZ=xC^
zUDcpN-I@wJzz6(Upr$)t)nRmw3aF41aVrY?AZ*fthYS@=P{xZkN-8!*<;DiZP6A3`
zXmEBKcvk*?((W<c+Y@3H85`4I^%jljFfw)d+IDFd6Cz{?BQAwB;QR5^awB(m%&e>G
z344d5sA^miUIQPmIC_-PGI^Z>Mp{rhysZ6Jj%4-vrYu;l|3B`{Ab^&X4x^x{T#Ve}
z2Ir^7b6pyHRk+oOh=qc-=&-$SEBc05^TmOp;Fmvw5IZ5$xZsi+xZ$kf<?p{eP^5r;
z)-5lp6+lWIqnN5%3aB)ws4Je2$TGDEzV#HzP6i{QN0OPE|Gj#1cmXuGW=6Rq2H!LZ
z>kuT93k-Pvuf#tG*+F^$^rGo$*Q5HABvpn6k^ucxq=bjhs-PILHuw=NBAGkJZa|3K
zaGrov45Z>C5ul5md{ii;QSfL`m52m&aZvw2h=em+5t5{V6f%*Gg$`*OCI@_*31#u>
z3JZKBR=FZgSz0lg5wNTQWG2AJZUy^@CK(6t3(L3DLX#Ji!IKFyF3Cz}<D$8s@#nfp
zRZE~OtL0rFR0jeT7xclBq^Nyo0T#6Ct%9Hc8WcO2rbyyWqY1Z3W2N445=4Z1(IA0i
zO3$l5UrQL&NLGQ0zDhtko~=rcd`cUSu43@b$&rFc2T{-*W>6MVVpGcwJQ%hFiAYm0
zUx8l!{<0+n3w%2Q@<&aCRnUbZi(q*KK|St5A3F+Q6J1b_AC@W%!W>yh#jM}bWS&MX
ze@zw?Qg(27u`rq3+v360SyN?L0BF>B=^bSO+2Mj`3p%BZsag|&M7c}~Yf)GRc@hCD
z9(5fDx8(q<Ef-th1xy09v1`oqJ%aPeA7Y{dsOSW@qNBvP1_7XoO-p(wREz;gI#lSm
zVwPTqO2+v70FSF2qM`$<8-$|2K*V)3`=JLC4NE@uZMG^PyXAo}Rx^3H&VsQ*p(ARB
z67M6C)_f45jzcacLhIIsjaL};!Y>yBPvqcMHLaQi5!3y4MKINJEd$17?LCRswuWPq
z|7~sPdgWe@GF(r1*q<7CrJA~S^PCDx8~0(kLk18P4T?^{UKJV?K6HY01PK@@4TSV5
zYxEXO53*u8K7qqCxk-AR!aY4IWAlLY0y)G?VC_kOqfltlgP|l7m_Q?(69bgVhyjP)
z``WGQR-V~AaHn$XjK;ZJ0T}l842u;#;9SABQS4$nj0;#(V*2ihCto@@X1MC|^{c3)
zQV1_VRo!r_yYg2~J-?>X<A4P^>B*0$PeDvhf~Ok$<slEo;M{4rS*|E>U_X~fFbM^S
z)FD&i(^9`FB836g<qHTxQCMS)44YB`&$3?z4ws%BA^ITpK!9tKKuqW#+b~8LH24+{
zWf<G50p;;uk=<3ypph!NUcgej{as%Yx*8B@D<pfHbK2$f&x=>95a1oIXHS(f0xRRK
zAba8su3CmhM8Ff89V&|RZGDywf-D<+k>hPn83Lqx+Ad)Wu_!)>?eKAKvJB}4laB$A
z>deSF_i59&?MB6#ie(P7;!fmMj&tY$&|%?7c(lqAk_wchdG9Tk<B&|0$Ywl%Js>Sw
zM;4OpC(=~bg87(dTA=ikF$Ouno`qR}1gIT!*#iBEjZnBrhfnh%PYksmc?V7&T)Iwh
zy8dSl(}|$+XbF_(!4KMHE%Iu7VVx5)p%EMEEP&jw2L_Y)k$Qc6N*A6t_wF~oW5Nm<
zt3t`5;>p##e|p%x`v+I46xd44N^*(f#CjgO9M9>^m<mxS@IHrkHB)@=`@IH=<<#UQ
zZ8;X&^eCX9Qt03@Bp5L$3Tf2&*_~~p$QO5ld8_B~QC0R-oD`&Yk*$R$T1b;fJ(qr9
zWq)KHli8VaAds8&`$`)99RX}PVKZ2Ng{Tki!qTQgB9$gXN&!x|BKu2NaH*H;P_?U+
zTu1Kbph+;T>Hg!!WEYwM6&^M(G-X{23NL$K-v*MLZ*A8=%$z8}M~YO2WjjL}rR!Wg
z+DFt%kuJMZ*qeXRg7IgpFA8bp%Pnes^(0ZPo;>D;;H*%JuMww(aNEGKe_fPR=Tiz}
zVLj_6(zgeVVVu7BT7>lw=D<|~e@vZCb1*p;Myz%?<GfLH%kDr697`q(gj9oPA%l$q
z+<=)emI~J49$A#(12YB;FhsSrU|=FU{~8H86lf<!6Pcw4ZI&ePF$V|mA|W>71QlET
zE?Srx8Ux7LRk@~J?9S%0WwssU1HHKu>3p&AF}0)aMI)=UwL`GOlxjK>8Q6=JxdJiI
zwzAzj0cA79t?gY#5-b@DP7rpqOv%j{kZBA<Av}xbNTi`jUd5<#3D6w*BQ#iu%reoe
zxnEh<pH8$t?HXmH-z+MiTpn@!5_2RMP9>y_>*qQW2rkegJUNK|X8B|+^2Nwcbvo&f
zX0*uWcwr_%uIakr?Sv^$T9|y(1NrwY4qgHg88#OOo<Q@cia@8>tTZ4Z)p0!W85x-Y
z{c-|;{$NA9H5~Nsx+<=Y``nMDJdX>+LZz5&rbn+8O4u7A@erZuE!9Y;HeSPFj<Mqe
zURm!*kRWj74l2^}nVuAV=--dHe>aQA`10N${KB9&Z#Nc2eXFi}V`k~Gm>YSdMDdFN
z#CCL?0s-_SGwXxJHyX#i5FG(iI<%U_F(&R>jiS^<Buw@SY8W)VNva4Inf28b;%VVQ
zYJs0{ZVoOsrskC^|3F=Xfi4lzEO{L$*;6wbE@nUuU(=yo%(G3}EVAN=rS~Vq&xMde
zXSOi3y_a(GH;XCwb?B`JADE4bacn`z+k68CF(mT~oxisz+(XVFk;mwfU}B+^{d3+v
za_d-o`mAiFtcbdpb}l!^x334tDj}z$M*BPe(TBDxtnUNi&%TrgMUH|&C><=r7No4o
zgr8Vi;$rd3Et+KK;G8Nnf{FNSkvH{h>Ok-rDjI=}M<E3AK=2Egw^6v6)SRG&a^4h(
zfFqkhHT#d{Osnf6=v&Yg(Z);01|Q0~1Sjq`e$dNtriShPEccl_jI%%>%Ex?HuLC0j
zizrq)cBRr<<3c<q2Npr$QewUOe9}S76f4Bnt8>fi3zY3%uH%W>cG)Ms&MXCjSJ)8=
zM4OxT?(8@nOyIAr;x(50!-~%;G4Un>oatJiip3*^-9_CU=x*F{ZW~6F4p0_Sgs8!j
zBFuecVQEOAJ<bI-Urz?n1Sm01=gpybMbkugqv7f9R&?sXCkS2b7~A(kNKv}5QW%^J
zje?TyX07^KqRHAb;g|ubM+82EBv?3OZ2;L^tQwFuWu*hDIh)Bq$T+ZHp&r)dyiu2d
zlw31uWBjv*W^@~{L>VgtK2(Yj6f%m6M@|A~zL^xI)NvzQKy2pHP+e&8f`PD{u7yd&
zj6B1#eH8O9=t!Qex77v<E~gRl8ctDnWx_6Ro8BHhG=SeIsaQ3i?>(I2isuL}Vw(Yt
zN25@L#WaYogEDKY7zvI-QW!SPXiA}|N>lKZgnI?1S~TG%gEcAyaG0DhQ;BEOfO`7+
zii-dJHk<|unqnOucu%`JIkJm6ea%+GnR29dWQ2g<aW6VMBCrk+m!$J7mV6X6VOdvh
z&t3~1$7LYN^RQpTq)=ydZ>Fq@PP_AXit9750&?^2BAU*}y+r75g&s@_EteQcF#YO?
zI`c41MP&x)07EFzyJA9NXi>l(&{B$ik@oYGRG-2WpFmq>wHRhLfyWACLLVBS+VcGr
z-Yd&OZLS8W$vuVIp8`9{t)f7|CCLsD2a<*%h#P>Dj{G=<STywe`IQDO$Op+oTRZ@m
zyuN2L=Qhw8wi!HG3kX{rAhvbR5Ig{j*nv4H;uUE7oH;>2v10^o+|go=j1?lUa&^jy
z2WavT-c^6lT~p0H33!*_jtqF;rY|b@z>6p!{FoIEi4ZXD;6iVpMzHDBl&*s^Km<AA
z)DlIo2R6Mfk2F7VV9CWCa{U@|!Q+@fNw%_vKEwV=*l`D4?tVJZGm$yD;>em~g<u)d
ztru2%H#j>CUxAFJTpFw0U#tGR8lgG2heZ_6XQhB3*Zs*p*zI6BJ;HpvqF_}HEQSRL
z)sJsNYXoQeBqAB_pmPwY2v5wH)06%yb{|<Uk`#j$tHFOyoJ-#~>IrZ`)fUBp9%a<3
zQE?pN|G%+S{a|utDq(xLDv(}NES*-u?yH|mL2yiZ@Eue0>zQQ`g`3+o6H*_3LSTja
z$VvS3QU5GrVnlX>;xc8#4ui|al!Dcjz(J8NI$x1#c3|JcD9xaP&viT=z?3LP7IL3c
zi^c!A4AnSNw@qy88^;h~(hh7w5XqYMr^4oyM=V5L#|+vO-2$LkcbDms!}AJKcj&;o
z3eVxDh;vOZ$oh+APuvDez!L$41kBxu%+#Zc5Zk=N2Hr0ic`Xs-2xqYh=nRz*V&FhE
z0MRE%nO8LPWF_1H=lbHT2FVXUm~>5v)@&>+>sOjG5XFSbl|nT1@fp`rq?3@?^IjBo
zkufr*sEhxNY$WEJ3F~E2^RyeJ&(epG0TIk#oU}t)qYpG-VTv@s;~+MImza&lgJUMW
zI&3HBil!pgQ|!Jg4b`UUOIr$A>HsbC8QviOBrl0&rIP_!Q^y{Zlmc5<sqk%;1K<+Y
z2C;k6l6ifT7)#zUbNlDB8@Nrlbg`@qx(PcRdW;Yvoe@B9yg@u85Svzw!#=G8Qdk31
z%0`3PF9gvYJU){03Z5+&Nq>(JvP4R8hwIf!rhE-zdg|yvt3ZR}7D2k<jZGz!Du}+e
zLdOjhDTo=vUEaPyM<@d8C*jFr5l|z}Brrr8<1iI4&PA}*yn_Q86{ahLD)ZI@qeohJ
zVk%9dqJSPEB($@#dK9bm-q*sHhKULR?6tMhYZ=#UF!MU*K(|adutbQWYe=i|KvT=a
zxIW2{lM;#^-E8=083ZX;g3mVynnr`3(Ns<^3)!lsQ>E*}gxA}kZ8cYi8qgFQNQB~9
zAFFwhZii`ngT=B2R8)m7?H>Ce(+(m8!PaiEFeQ~y-W}n13M9SJI(gXZQVwwM(FU-U
z0q#+?1&#-2)NQfzQ@uHan{{nDE1n1)dxL9O`MHQ};n$4Agl7q_SBNld@iwP<D8TAc
zWT#s82|>o?%?NG6NX-Ll%{BzS_wFwnyghuiDqj%jHOOFRP?6prFB7kb!$Ut1_p@jS
zd_C_l|HE_A?owD04%ik{#Gm|-l{O^UA&ayfI#42299wWP$~zOA)$IwbwB4PIW~sJX
z7xF!}lLKU?x5147^fx!&xON_iDTXs2?f@=ht`i0rh7FQ-PbBg2bh%@2v7{GNfI*Dd
zfi(g*1PI(sJLw==($xg<?xKX0;$mUAHxJUlqK_CDD|<qL))nsNM~T<%IrxBxr@6X)
z!LgyV1Mv<pZ6{)NHFhcZQ8gJ)<uWG8aNQ+>cu*DDhu`|LbLF!2_7YkOIzGb`j0R~d
zX~?yxp}dhWv)<9LDQ%EBz;N*-pq2W~+8YYh@^RhxOff)>RtNvMV{BAXmIXOaLcIdf
zdWhySXjehMP3TlmE6l#nS*88IFy+4fI~?eo>do-*!_io@4{=B%M|X}-@DcCblv@a%
zOGOux;6kxj<XeU~!bikP7Q=dm;xn0nK)Qi$7OSKpdM24Lq9mjPsOSzbSQI%`Vc5*`
zCmaoSqqPgXr4W@!$%h@LUuFCb@NR;rg%wLF*sXN+8pelu)S6WKFGb2W8jqlBcIVCc
zv46?YYa(HuqsLKhzlow{0QbPav2R<C1|U*Rk$q<{cP0@HFcQe}$|RbJDUfkP2NTEv
z1u~-G>HNMy+{c{Z)Rtg-8(e2c2t-<cnn_+;A|g|Yg#=yNuz@K;cx^C6yD?2I(L#`%
z2}G8U6odfLUt5;JFTU)$E65L&s1wWDW=jO5?JqcKHz6=ooU6FL3R6w-x3*&%lKA+7
z{uLF;he1@&96@C0u`9nLwHUao=v7)_$(m>8#(TF=;Exx6u3%l#%)xLZGHBZ0)bQ&(
z$Tr@|p)tjjh2NEU`I@dJL+kkrVIbb}%%MQF8bPZf%?Jop?`xBq@_<`|3-yJbSq?nC
z(uFjpc(Bt&Wg1CeM5tTUi+5Nu+8}^d#wA}f<B&KU?@>$nGFc=G+8tw32t_$zxrCy&
z+&9XKcVNX5KebgMNgJoTWhi~zSzorG?_noHY!_`-_ia=wRQO7@xi%6jhpwC;Jkj4N
zV66nJy};@7U6Dz4hnPTA!y%YgU{R?OIJyJ1X0T{PZ}3*_5I>$L)DnJU(3q%#jt5*5
zEEstN$d(PhdlM`fDNY0&g4+zAU&!B{mBsECDvMRR$oIM{g5=(!=m^VbKY+C&$-UgV
zWSU^*$c_UIH2u&n8=|UM0ZpA}Bn~Z;hF#Hl9@KUCxx5=n)w<|Mn@Tn&Ykk4}K#Q4_
z^-fZ+r-@gJec_G)UJV57H-|e(4wY%2&M#Lw7uXvlh-PHb3y4T5SwyO^_FA8)oD7s7
zA0MebVRopa*dSn25)(wg&!oyxGp?9W`|TT0WkkWY$<q5o(RZs@Pl>aD#}d)q#p7c>
zeoDH(r;xRvlRY?4&_p(th)0(#U4o|Fda6gWWy@;yQRBa@z_d7qIA`vJH}wi4+9b=p
z{`qZq{VeNb2RwUwb|^?UbH_Wv{LY}99hX7CA5e5Tsk-@mI5rRhQ<TpHR_o^{>0(Ln
zoR-v6E}^)Wy2;|_Ild&|&A71!09RMd#25!Oa?M)uv~1S*2eFJ5Z7NP$!-Z|BZ$0;{
zs|P{mEtwacUpVL)OxfY_mn*;(sS6JNt{mssJY5V8CL&F>h^U5=>ryBTpRCc6sERU$
zvI?dJ%rQqx%cLCNq8>&EwW800KnM($faW9Yit<OA;O$Rx&!Pa`%)9{2%dC10M@<#P
zMV8j^7zs!NE=E_RFzZ*lpsCIy<t<jK-Y1u~0{s*SI>3S~7Fa|H7Cny(5z0dHcuKW3
z51FVwhg?cRuzXY2+)?jU2~b<!3N}H^C&nt6XO$g2t3?)>5FR})F(ZK4Il4%l<rTrc
z93{Mn_@Vz4-hN<^S^!;rqYcRv2oT%u1DTsS8G~=c87M6pF{W;WBt(|Z%J0?Mk%=0#
z9-z?nUkGsF1@!@znd-6}A{~IVAV(Cl0wgcR+qAwufajz0$RK>#C>v^$Zr;&L;n^54
zdNy+rLN`z>8Y=%zd4b3RRG3AvYm<5wfuK~K8k<dyiH>Mqh-hdu_tdXQ3>fV4CL@F4
zQ9myxfs=FJ$LLx2tQZZ50&rKc=Md0fGl}aF;Z^F?%Wg1$!GdCW86^QlWsPcKjTK|S
zNK1JkWEq4xLlxS%8Bao*r2NvLunr{BpqTM+Jr33dW6SF}Lzp0Cn;9)_n$4RMg*D|+
zoT3~}E*;mm!kPzXT(W-sdda1=W>7K&2>9nHRCSfGzV82Ww=xLHX)m|!^hE=sG=B3v
zzl?&1S|r^n_g(IG*nxehYoEcVS|U-@;*X-XKp+W&*U}dV#f#QIBJ}e2TOg+R?iMX+
z7z82q_8SYkco9tlGZM`q0~RU1ojs<6`dp*=(Omd~TOAEjS8vC_4q~;vskmoxbN_uz
zcLOihA_NXn>0&7gX#u2izG<-22SO-FOE{vJ-86<#qq1R4VkSIT<Sd{ir)#DbNRsh}
zVH2DsNXe$)z;!sON59a4Ke#gd=D6&-V3C4hi-}2<wnbD6`fy@vYe)J@^KNWurKjry
zYBN!L@`WpRv}augg{BW^XHI@}DHCK0NC9M4#=x+uE?R6lwG#9J2*9?Wh%-=GvQQ0*
z96g{KAyan7A%vr9sp31=&=qvSZVf#kTz8dPP}My|swk!S3EAB|Jy3)Pecy;Nu-yH$
zkgfmfjp=M$HZE-f3LK3lD+<)yw{uVZJMoHhKVZh{<Wzb%OFJ!~$`Od_AEnwd{Zime
zDAI$G4kP=(=4KQ2VNsbJjOk%RRnFGk&9mV?V3TraMY$j*=i^qsNkuk*#P#_oOpb0t
zkJth9F}Y)kmMFBO^x%Cv*O@Y&XlM;s*XXN!>_!m!>v$zMv#tz*j)&x({ZA(9v#WA!
z=)R}DEpigrke+8R2e}iuL;|)hCIfO$Q@zSGU*Xc6H?Pe}+2#gUHyWh!0fN)YBVCyr
z?Ku`c`lBKaP9>?0j_}s{TzSy}t|RgqXWp!82~(4~ajz_~&wE@-OcY%YWr<foR}Bnp
z#$p5S;DLxx%Y)yNqErZjiwU7>nwT}m_)~!H+N~5n1!)wpLp$INqbM;k$3}}h56xIS
z&ul2ElLh3fRyl&o!B1C1jxoCY^kxHyp}^<SX;$OOL_R_rV^#tVOtiQcJgPX!t8t<1
z_W0+Uyd@LjWSB=Jf>>>rAm5CwYUea+vzu`55<P@r)!V@8$%>~{;gF1Tnv=+D>bupg
zC$Vi15sIM_K*c9aRhi-G;+O^Cjpvco1`Mi4N&cy>0A8vGMbODu<9o;o5)720L1@jv
zqz@4<Lm@fb;jQI38G1w#$c$7$+tVqc53S<MS-+|^;bYDyf01h4F1%GcQe9txRbUA~
zi<}l_ro^?K^IqUE7_BIwJ_j#S311gZm(qY7db*$p4u4zWk2GsFu}gFfm}dH^UQXp|
zoI0+3Pp;;l2FKki(a{9XLgsD}QL!rMp73hw-yPT8<VihngrPqDuoUPML!McXf52Ev
z6)9#=kz7RLS}`xtyOgw`0Rm#~zVBcMK%jS0u8q7K5Q2vh_b}|4!yOp=J)Q_ySQX>s
zu1{jY8=gW?>$KF+wS1e{ICi^^F)Hq3<uG+rz{2m4=_zJL^--V!oicIXGrczp6`&zO
zwrsZKM$ZNGacyTWZC|5KL}#5g{T@_HgIG9s^zBMXv2q0jDsEw2R9RVC{p-jSNKmJ!
zicA1W^)%p%vb{7N;F!C3e?&;F+MT<^18URm14-C`4y2P=3em)u#J5=S?9`w3gAs^}
zMyx+{qrFHLy@u5)7mbbqPZXRR2nY#my{%4~w~{ylz3VlA&sGmPcqk?#Fp)}HfasB@
z3^sT8%B^RZ;FzoDbooDEdvZ^+vxZWKU!yAgQ+Nf#N$BOFf5vjprf!a8EA*BMOv}BQ
zD|iPlw36#*9i0wZ%SslZnp$Bqe0~OYc<B#xM9wCNN(A!>Gx$WoGFnhRkAU-i!52y#
z9eR&nbwswURWRUozX*03i&_B&=7H>{BTW|q75HNOr^T`baH+zJYV%^VOU3WlIl^Bw
zNQ(IcA{N<oKT$pf%}0qs;wU<ld11Hw=HH;1EvF0YOyi(Ip9964gbMdwNILFBjQa9P
zp$5-$aY#`JApC5KA>J)y-TieZk2`Z#V)Q~Q8~Q7|Ru!}Q{-*Ty8Ey_at*sMdy)r`;
zwvl|Ppc2B^Q5h-+zqLA!-p<U{DxE}C=5ciycRMJL3L74sNWX_p>|+I#ZH5O`lDn7>
z*C0$2OUT!;<oE69@G*U2O{0acV!}Md=Bca(Fr*k-LcpSh!U#!-iUYIvU~%jRQgf0L
zk~~sgMsSy0PU%1av!QQklSzFRj*Q$_jFx4PPs5KjNr~PKwsWD3S9`vN$YLn5q_Stn
zsrp1qvs3*mAOl8V9CkFHn|3~rgCQmUdB~bczelu|8bm`#LEwwx_p?k^(e%^~L*=sr
zPUb3r<IVa7V<SEmwiYTAqp@rVQ3uB$3Azo+H^4J1TVRvhv2AvV`8nxM1co|i;ITXr
zMb;S)h<62!XcHB}5ji%fA(ph5TlgqWfiN36n)Wu$N*Npw8U_fv#sU&ejF!Sip!@hh
z3*nR8u24}zp*BQoamFgn%f@R42m^!0Cx_H$Ka<LTNfh>#MXAXuMWk&bb1ud~GW|O=
zJuQMGOCI1UrK?KdJ2#&t>w<z{w6upE?W#r6MSXb~OgKDPpTKd5^g=Jhf#k>^Oj7;_
zn37f)sK9Y~5^vHkkR`Qq<X>t{IzF1Ee6sA*LP)6gi02G1OygBr9rVbWb8Rx#Rb&p%
z0^vcOYaEq19^VhNM7Y5g8uPO#-U+PK8#^F*AW{e(qQ`LKOOvKI1VqB@=&qOCkfpV}
z2AK8}EbRKi>0i(g-g0&dN(FAiJsK+k7=)1i`w{UAo)GeR1{hPX=0A)&`m|swq*ek#
zUOwvLygDz+wi@Of5clii{BoJORwA{gi&WbDT{7;?a0j;0@0)5@2}XjgMidAiwj-+j
zvI^NJcsZ-^CKBefS4Tt}(ETDE`{r%dFB68?Km*-E^Im4!pcZvxyg1q~9&*#IphP1n
zq0muFNzD@sq{-h8mhYM_Tu$u+QtZVeHdIs~u0L<?d?MmGgjP(DSrv4wOM@FMISdx@
z5l^%$$l49;MTQo~e&)<`o6-?)6lziL#FTS>uy4c?cu;^0V@WOR>P)=44r8$g>N>zB
zJ-eadTgu%#FmO+@=Jv@fibqB8s_2`+L5QwA7)O#ttD}>Si}$o@;;V4QA|by(Nz?5T
zk;6;^OkdZpBo;nkkcj#aXjTEeDMHrFnifcfmg(CW1OtWvFr`iJ_$GI|C_m$}jX49`
zp#--KT!SoU<#UKR=md=5q~V;;lna-9Np(lMJTL->vsNO(jcqVxTRbJTtv}X^ivMMR
zgqGnuV~_D|+l7PIY0)o;7~hL4C|AQE(QoLfA^Vw2N{lJOP7bgx8biGY54KGGZs;DQ
znMFc|7{g#bZLZW_G#Le>Vmc&C$PprNEm1PDi8M?#O#<hNX91SAzW(S$is9r1dGa<O
zjpIOwc`&Br15gLe1`;D`fOsHanhB&QrQ;i4QweEscbF*w$dGo{BaqNQ4p!43Sssp<
z9)Dt8PwnLSA7jc?p0BjsA+Y&`Y<#|eCph`-8G%L+l%0u$r^y*CFqA4Mu-iig=sO1x
zn+;lF@7m4fgbXnUf#sUzil^jySr()%^RJ>}3}68cj_Nr}g&l7!KvB{D##~$7dU=jV
zWP{M~>Q3)59xdzNSWdIN_M2<It1(Jip{fQ?>h#D8YOhTx36$oiN?IA70+>0ciqt6s
z0!lzOl>p_kf~9CeMzs&YL9ny+$vlkf@B)}u?n3XBa{5-o4vvftqo74)%%JZI2tB;g
zJK6w#B}`4K0qgjQgF~$!^B*IE=RswqbY@@tlt3U2c0Z5C&cEd7VqL>Alx82hN;TDN
zR1HY11`^^*_mLSNl6X@$$D)@5*y>3suH>yal~QZy4kb+r!A*Bs(1|)iOK$lTqkkYj
z%~mW$Pti(68i$}lk&fSqjY0O`ZL%OS(%4D13GF-c{Wnfi67PwGte}BtWxfc|&dKgp
ztFqYu)#_H#WnG+b%9}EK<BBK|-`Im=L8>+@=sH_{W&toCq*z5xSB)wz$6y5o5kRy%
z3F0S>i=mUqo-iL1&HWHn?4m%X*SMt1Z2*f#lPUY)Ts&PDq82INisCUK27Xo$;Q(mL
zlofXto}ZEzlg-o%ZdW5c(HzlHsPkF`>n@SbIOK&%64+sZl@jBl4$1d*A}pX1Z82$u
zq<O#`Cx^+0!U_rjz}42Lp+I8vzTkG71yFX=Pprn)<7sFM*OhcMI+pW=Kp;e30H@l{
zRi<Ab8nY|(=xm9mz6$sag(Q&{awJ4C_}Lby>VzBZhr;9oWjiZkRT`!yb9bv&-p2ig
zbhMo_9|xF<K>r3<&&>`L5O^TPL9CPZ5mv%h*bkhBK-T}>r%v2As|G+Egn6F+P$MmV
zN)Se9E>!Cm{~dhGWbqmJQ7HBnE(D2w&Y7!nqCPWQvCvr&vOCUiziknqj;vjp%nO9;
z#818cp!SQu<@~#l&Oe+dPk|#z?<Iqj(+s!rZ^7I&@+a~a?ahmytH0zTZ%i;BGjjJn
zs@_^}8t;$Iu^CHjDg^hrd(sIv*smd5)8N8t5}UbsH!zgADskd?0!;Jr3XYD>pB<ch
z3AHgb*X~|qOf&*iF7mZjb<L~D83rh=y_As--x;MaA6ugvsm{z#>U;R<K#*TQ4Y;*n
z#iub95L{uo;^HYJW%`ulj#%c7c;H6{XlBCjDK!s1ZAjNI4N8lE9zsqd5lLs|jE)Bh
zgHidqE6{IvBDfQkC=0gDw!~P3uT(TjQ45AZ<jtVr?72Aj4NmM>>l?c@TjxsC7gPmt
zR*j1|fQgjuOb)SCXvI!R`CjT}5(ZZayOU}|1g0Y9M&`$WFXvnY-SBr~%MLG&md<E)
zpZhHhO}$p}F1w45ISyVNYeFf7Dx!)k3qng%Vpo6HfRK`8n7LJrj0cm*il%f{@`vYN
zUK-pFLFV*KYgLk4!Oouhf*8)HP<A@TBf=w=i8%en&0&NL+rTad6}m*(fd#?(#)Q!3
zNSvkV%EI7w5xwStM<EQ8>($1QueMht(wnEx^tqU9!9a$@1QF@l+02&`;&{xyaF)IN
zmBHl&xgEuXzyXz|#~v1nswlpu3Iwb}0~~_#|89zlIB(Pg!ll;ePt-xnfr#WV0e*e`
zk6v++;{hS8rd6g~3dtuNNCb(xr%%8#PwcV7I2av(qX5JjB2cNNZW!l?1R7I+9}8pw
zmL0Ua1Ld>Wj%%P}JcHW$EU$TTy%AVbsW&0ix_x@82WCl2e}xjXu%e3>!%0?pRE1Ds
zr7W7uAsv*&0KEDAn8au?GGOf7;}T5^Ykyt}BS}7W_C?eEYV|jr`)3T6X@w-YT=JR%
z{XkqbDhvi5;EWYL2!#Auj3mtLHxsT>iFILsKM6`P4W)Hhtk=42R*TvYx(W$jcwEa3
zxCmm<m)@^mbjWRood!3WQI#?O(ZYY)dC_2dEAvtg2ccwSMGh$9p@e(ic9~mXO|TcM
zogTrBZB_ys&J9KciUg|fa0nyp8KoD|D~1Ja=!ln<Z1_O*CEQiYb3Ew0+}Va&5lgNg
zVPmdRZUt`eF##~P7V%>k<`;=&L3(2J%!5}7Gz_<LCYfE55NvV50yKACf$W+xltQ=$
z`{yAeg%p`iYU?0`J)YiOoVHXzG9j(S{gqU!h5PN}Pjz)28w6JDARqxkD9HfaR6+aw
z5hlP8h-6w!{ZjJt48Z%gfo6z?8bn$E{3kUT=vw?I62>()w;6K|Fxtt2u%<x?MR%v^
z&<A)FKFG}8AEsntrQ~2?O!&>wLTz<lfgnf+-xJW8?lRR=?ro3}p9rIiPgRv~XF@oE
z@#+NmUpTZAf;a;Y+x$<ARK{Z+V6N+8RKr0!sYc(%A1W;s5MmL6HJYt62nY;TG^|I7
z%wC$4A?nqHB)WZ*02UdUh4D$Wg2;d(bo>$j;)<pc(9kK0#C)eFiD?+HgF`|R@(E<M
zk>NOKL&Fnlg1iT8ZHxj%7C9l)b<zc@ix*z2EO;@l&5WKtz#}{tW1Yr*RFEa8a603C
z&%_%o*L>>XvqN#83306<qQhaERZ2uwo&)?X_K?ycK;PFIRaEVl+CwA+caL6g8~Iez
z(Ly4CnGr`PQe??)ny9TN^&dn52vd4BzKKMK7Uo|R0mct|^3dX#08!;8${;|l_l@rc
zC~(vzXlgvRE%Buq7~<71R4wJR+7LU~F${j)c(KVbntC#+{%(aDWh@Ljs%+`F)8^!g
zhKQlAV+>QiJ|DfZ?e%9wIbW!=jW|{fFVWN$f2?1lG?E}bFP5^#aOOKO$7+a0>;o^Z
z{`8Nrl`#$8Vpxn~@h(^*SdZ69JWsJ|N%%hcuu6R3{TJM*3D+5C>lb#N*-&ChI${-)
zTC_p!bdxX(MPyKyfh414L8usjz=43x;z!HiiYBka$;Za@3@Q=v68I>D+u|6w2W&X~
zf#-+f2_iWO4uJGwcylxoY06<ot!PaOx)^co>Iv+jzJ}68Q$b+tCmEi$6w+bW1YU)l
z3II{dz}MgJK-0w6VlrmX1;W139bSTw`+Rgk>sn4z6ik?R3f|H-Kg4v;wiUG<g}cX+
z+9M=e`mo>y7Vu4<v4sk{cE!6Eg}fDU^w@zDKAp%&ytwfem>DR5@MxB5TTK=aTB}Fg
z6hq0gK>`9nvWQz9GfxOB5pn9YF)vQ2=4zM$^bZ&XmNJac$;zjau~jw|D|HveR8j$M
z)E%_;SjVJI=Np}6r1O)Powu-i5eHJTI5FIuwYGf0s2h4bP^=CR0urtY@`IFUW9azf
z2H3)yD<}l03qV~HDhkN>Mv0k--(o@K#p)zQhAx@kj>h}!8VG(z_CVjC((%6zW~6sw
zK_DCg0W7BGzi0*^@|RAhESKwumg~`CKw07`oIRPSNs0P=!xC>Z1{D`SUnk{;7|3@W
z-)B3NY6YBqqv7nXq?3QV`=3z|16IxE>B+*j0=#>H4EebPTqP<-@gZScLoEl96|2>R
z;bC)YZ9^OnxJb-{>Hw00UH#uQL$4kYDt;M7Iez~<sKhC!Z2f~<Sgt0<5V+|5_C)*#
z&YXRS&e6cw$r3UoKs&cuKmqKVA&+`<l2@!aLML7l!UB=!!39O~u>?dt;1Q~ii*Y+y
zIQr7u=}};-rp^^W(1Mrt#-_ZO6~nn}*bsD;Q{f;hnBFX?)@Xc!D!uE*r`o+3lsFx-
zb(Rolm*3uho7|2EFT-nJHW>-eIR{J|gj&HuC^r(^6ESHJ)_18OqH=P2PwPnVMT*IG
z`!fe*W%a6bd;#iXp-1(QRwYO;;V}sIRs@i=@d7eZdc4^jUC`1KYo7BN{5NNzhJQ_N
zzig5OTj+Fh=`VXg;L>LhBwcede~utonJw|SQ|^b~OePfH#Dkg_@^KbM!TIS~4me}B
z_BFYj`zBzo?VJx~a^>B#%)kp|g?NlW)j)Rzx{5{ou<DBSI|>C#RAZkKjcTy~)5BFT
z6*N%-hM0h-%SM9j1yE^5f@Gq6q0$ETZV}kEgCi`iP!DRl{SLM44S&KMpjNm}z`%eu
zutAMaIYnTE4FJjHf|3_}-J^J`!Xa-0L$E58OhBP}!G2GW#07+a9flhL{b_&{J<oKy
z_&jQ~&4XgTB69Z}s;*|@2va6la$LI>pzGaC9ic`8B<;M?Wc`I_AbfSsp^RfPn?!3g
zhJ5?qQ$lXX(UL6GF$0+JfAb9o1I6Eu62cbaW`(Zc+TbK0QqUEpHfxxvA2;sAjxY!`
zfJ?Qz*)`v%{A`XoqZ^4@fQ(f{V73chf`Y8G;}dY7c2Mrdv@>tn7R?{G+8Ba@3Kwvl
z#ZifJ^SbA*aTT&^$lst!E|FKp%|YeIf5UI+=FhJ3H6Bn5=EJwN)QW}2a<uFng(wYD
z9$*SaQ*HPr*W?}qTZPlvh%&dujVo;+PGLnu1+<k{n&8wPLR%YX`17oAV{E7Aaa=F?
zmGk7r>+~CuDVe&_p-`jiM5j7G8bAKq9Jn|p-v|2r_hWxHpj5#0+<ESGG3_sBB6|ok
zl*=)Nop=KdwiQ~1Kc9@0fQ6~i9KRfXG|S}7rPKsaz^D+bs7H}!)9u4M$G^J%M;!HH
zm!kLp#5os*H){9(EMM@yl#CQJ^1<96-AU5fW{g?6HuJd~W``w#PjV#&46hW&mRqUn
z$>t}et(B2Lt-O@|u_TwTTcj6f>G%a&Zk9uvK6yrBw!aDVi$u?g!t+|kjG9(PUfbvq
zN_pTGf<F6QgCGoocPb05YaljwR;Y1_9n+aDIF%60nk2P*&o(tmga_@yrb{Uk-;mgK
zy6IMzLnq);+9yIHp77a7b<>e`5oGqkfg6Neg^syIQC`+Hhgr$k%pz>4ot9!+5-$%J
zkh>mM==3gXj8xIL0xm3@Jz<5oEfRep78#Tvq&rOOhY;Mnz&nv9mj)K47VZ6D&su12
zbLOH2nUqwPL7(#5b(+SK^2a~~lMSmx=}u&3HMgqAtMxsf75CZe?$LHSRyPtqY%ii%
z?n^CPi*#q2^ZE-(3K^)MP`ULRlOk`}xspP`|Bmj2hDS)p*z6v`0Zn0>_rhpfze`Fe
z8kmd~XO0PA(8=<%I=U$o5l|H%B+d|RqL@&`pxQQ2;VM^P(4LGDOCRxFji0Om=v8d!
z%4>o7C{kfUxR#i1J9v23&tC#Vcg7_tKr{QRxQDN3=KdYV$+|D~lMZ#;!RlCbP+sg$
zY?vO&VoNCP;)-Ys*Iwbk1?)&B&uJ4+hE)Gg2uP|FlvP}TL>fiLjJRT~cVA;{1zo`O
z5DS$<F=WFWVLIhbdSm0$31of5wlJy5LcsTkuZ{*Q2V+t=<07Had8&NF(m$-Up=c*q
zE@eYfY&tuln@z3>H~#^P94YZu$=8$Ksmucr>u;%@2qt$5Jm46sKq!_D2-Q=K-X9~|
zm(u~L18Bq;!@^iwBDHG8c2+p;2fIyp!m%E3z_qO$h=g`nO#xnp5JPsoi*l0U<BV}D
zCT0c3l7hPfr7w8}Yecy~Se}uk^23$B`0N>P#DCp(Maz@;b+Ik-U&pV<D3%Y?(GYux
zL7ZKvqR5znwY>Ln*@)=VnLaAK)`q*;p|V83WG#t=%|*wwAm=EQgj@hmbwzVXLOhl?
zwV}h4$~7+U!4SnEgVPCz*uZxEYR@OO0;uUphCc^05zd_c7VI-3;TVj<b6t@j45eT)
zu%>ewHKbZso;8cuJC5C&1O_^>V}(3kC4esa#bw_>VKtnBC<b~Wz`lf80K|aU6T}yo
z2YUF(*bN{qTCoLzGl$?Pl_a+Kn&`Y2<a0zI9d!XvAh=fd8g+>;Vh-T?Wq5<p5QgOa
zh(6XI6-DA>;^l~QuZiP4vmjB<vB}|Yc1$cBD~cQG=@y8wk`m$AHn3xq2@DznEP&kD
zDz!T<WF+os>%ZivKrYymn_nUHM(Vjj-CF@D&|*U&2<FFq%UI&@F<dGLO&SB}8fj8m
zVn)vb>cez?T_(OaekXE}YU`?%+=s?}BZ|Q&w6^V#(iIL{i(tlxJOXelXY+GF3k+6e
zkiQ$Y%2BWc=J9)XprH{7VcZ!D3c?T|R8(9y!NTF<CyTZyLd6TwS=^x74cDTYi*(gQ
zEE9Of>JJ+|1Tm1xM3Sb7v=X_%1;bi<d#WT04>dCxivs~!WE|o1!w0#C*pQq5G1cjb
z7>9oC>`9;y_OiMnaS-|@Xv|C)DaJ_MXY<9XMU_>m@ZY?|qLxMlt`hQ7hFQ^EvaYtR
z7zNc{`5h&8RRz(ff-4=~7OLTI6L#RZ33Tq`-AQu$l$tX+6=q1Ii8zR&%NTYr)2ecE
zw(dkMO!kpz!H^<}e+75$m~muO%42d~@7*yql~!L5#aOh8O*<kdH}W^Q(aYP?)1NDH
z%B~f|hC4v>a@krd#affsAPCq9PG&AOWHJfS(@F4<1zC32<;6Na3`8kezkhIE-BJ7S
zI_%=#5o~-I{{$!pv@<DEX%Y|A3KVVb`Y=Pga78F$M6~1q5<Lb+rTDww1kV$Vl*#!O
zT5@^;u}xzo?$Z?23lcl1OND?stxyq!T+)$h8cu--9qj8V`R&4}mU%#;Fh&-dD=a+-
zQLUSLR)^d@Xetv~A@!jcD<($AOi+MOaIH>~jjdzU%Bx$GU)i+vp53@_W>KDa>L*C!
zJA?>`hE&+XoGLj`r2TNOGPDx~3y)$aEm3}O5MW=1*B-i21!n&pe*@ro$WRB{=mGI3
zksS~#`SA9E$f;>Jap#<H_8(m;Tk|TpFhV|*ehb3sL4dwMA36k^3>4rFHr78_P6YV7
z8fF%#R4Iq}5210H*8{T2SQu9ay*lGHJa|}@N^!sapP*PQX4-`k5?thT4I3!ij_(Z^
zxpFQ6B3{Wu8+4XO8<I~RUEZ#U0wzT9gjDgu6i(r8A8XTcXb@YGU9_sTfPB<o@puan
ziwsLpPvRBtMOBfrz$^&^17%Q91i;_eDpycd=%MKAXe-r4fhxl(9znd(#GtkVR7Vk6
zMzR5vK76@)+AmSMJa?YbL3pKnQ>93O;7UUcki9G6)Cv?!t;)~(kf>=%uo5}C%j-_O
z1cvvCb@B_yk&r88rkBq(Iu5Ogi^vxXMT2l2mUe<W7gy^W8_Pv6lSfxMMeVU7vnMZi
z$X4i~i-5&-InN}Vv?@KfGl>;*!BlQiMB&Go9ssavD4-I*6b=a$3^1F;Qh+7+1slm@
zp;@D9H}yp2FMnPhnpKIiF=*ml=t)3w{0NUwB`%>&5e%3e4XEi>gG0Q@W?Xv!Z?Oh1
ztCpZlP8t9ay<6Fc_C}J`{HR9K3~H_f3cQ<Nz~srq<kMtvB*UoM3QlpXR^t^$d?nK|
z+oQJOEtSeUW(W7ZJ^yxq-~<oePXay+8ILWFBI?vtN>r13b#WyAPzVZOk~1#Uf|61L
zNZBNre~s@#NdP>OA>E&+i^+NGL*1GAz&Hw0kqv#dw5Nblq5Z$!GL*9ZsaCcu37gOe
zRM?&BHqJ-VEn@CaEQL1GbhtIe0EdNoSU_VP#0TS=VFxf^Fqq>C7(vRnYLIhGbDDGi
z;=p;a9DmKb8>^Xx44tAjq9@NUn{t3+G$G70GI2cO5CMBDBPT5?(Qy-i#A7=xPu_#s
zuHYG`n04O4tX%8VA+O6tfZc?+$R!AS-)D$n(PtQj5)1<~nnOQ^=fi9J3dQvKwgLxl
z-|tEgE!f9>`&_Nd-7Fgaw=IMxk~*H*p!SxQ&3CZRZBVN&NQI~s#Oy%zNMQ?|fHCZA
zO~en3C_ky{8AQRbNGQt|me9Fb_d7xRJGEpuDg4gRzc801pxsjFw}2AuWw1SWXd_WV
z40J}s!`;QnK{G;*RU0WOd8k|gcJe;W3V#JcpZ3GD@_%Wmgtt?&;Mx^3;sn*)fM`rD
zmx`8yUAGuVkw&l~`pLQLVWkG&>z8f-;CI`A`~d87hpht&`)Sv}J;pvy8qLOau(57u
z!Ys%%2^P=r>Ci9C0Ks)~BPKZud<OBs*j?{|sAlR@I4A5O>e)b#>M|)^`Iw)_@E)Qe
zcGsQou*qPC-_HX4C{)F272hD?J`HT_X?)u(3NT<t#A^XPy@|R)`ho+K8fuf_Yw7cE
zy%F@2VQ+$v5#UdJ%dtmB!ky}XmVT*&`{{IwM7;tj>~+JAGdT>#dJ;S6)&3St0+qZK
z?1Q|W5qXsr%%rQStxYtfF(?&T551)U<WR@(?@ISf^HXPZRn(1Jb-eH3Af0Zh+Z$O~
z!WIJY@UJyDPVQ%^u3)-v4D}nyb>llK=`pm*9!N&xlpfNeidCv6k_!;69y%fnBNfVY
z`AtMUA!9v%%%GK3j2x417|_^5s5k7w$O$RHJ*#7~;Mo?B&@f{1rHf!Y0=)6HZ0wan
z@w68oysCSEWNb#!8(Q9Ej2*Ku7VaC*qTj#TBGy-+F{+j%)ToAW2s=Y4p4uIEWmR#Q
z-rgIf!_zm~%OdkqQ{`<xjN837PQxfXycg&Vtwq{Kg3vtK#F&nX>T%I%JyTE)1Ri_n
zHd=lcVFJ?0K)mY1mIC{%LFGcFw2dD#|C8f~J*+;=?)jyn8yQ?i&V+50u=aF67NS`T
zIsznMzh^;1CWXw%D;IB!GN4phx$yQ>Blb_R@u7IT6a3sr375{LPWAbJ*?sG3;zPP!
zjbNZP;({iCATuaPQ4FV|wLB7t3Q8(;p^;F%HwR2TDw`q$qe7%XhJhtzWTujlvHpM?
z!0p=g3D6@VM!u-=y%XX{d5t50b=hYfG3P+2=^QMNk7=v{9M1tkGNltSfuzzvcqJ<V
zsEK<eqXkki=rD044?C=R_(I>gweVNcOzU7zAYTv(7%(uli`z!#laBTiv&waQ)I_|n
z5b7_8SRJqMJzt)$z%M+&NED$t)?im{bcD}Ps6MdC#2>ZOL?kt_M`y{^z!TZTLMs|q
zO)S(y!MyG1H1nn?ost@h{B;k8(Ry9I#DQEMMk%=%4bDvmNk0zoEyqIZis3*gpryyG
zI&QSOE(cFbmC>5S)A;Yoamnj)M@LNjj|$EKV1pf22!Ft%n{0j~og}Q4qGV*P$r#84
zq2jovuy*`Aj=&%&dt8ySW(naXT$%!4NpT_EjRFZoei7<I2!Y`PvH@g#5C}AGi9$Rd
z43TO;^nz&vA~ndnAjpSuBN2KbmPGV~@)r({I8<?P=+We3=SP8##~u1Q(B)&ahmVhw
zA8b0@ae(eo-XpD!^gU4S18NOoH;~`sDMnh1lo$#%=+05CgE7V=j0_koH{ipuiK7dK
z_!$~A9A=QtafxF=#%GMj7|JrBV_?%kjN=%FL5w;U2q{!n7^87$1(A#E70xaMSvaxr
zb|U?R?1_O8SrS|(*h^@cF(!f|MCpki5X3?eC<G@HZYGdVK$dY3Q4HY_K{8?i1f2)~
ziB%KsCp1B1Fi<lrI-omXHGndtGJr9lG7L9>GDtD#HS{#7J7hVqHH12(GJrIUIUssa
zbf{~{UcEpH8A36ioDdW=JR$I<!rvLp46GF3Pr)~Y@D_kXkiNq62?P-kA^<?Jy@CS*
z9|p`4C?vo~AnOBm35YKM#s=^UAR169;I9Q75a=UNP@u>G%mVraatquQph`hvg9--<
z4!9MNBY<2$x<Ok7=n8Ng0Mr7!4$wcqQGl}nA^<cC&>LV|0AK(~G?9bAeSkXvngG}j
za1g*Qz-0jB0Fndz23QOr44^5#Z2YI@UzWau`0MZQlzzeZ-}B#)|I7CO@1K(X6a8<%
zFZ2I>__6sn_FuOD4f%)A|KNTZ^Dhwkf5jfy`!(;Ut)4ghS$Nj=AHcs&ya@V(;0N2^
z3O)zCS^8u3N##4F??~Q?ogRATbd2cn)x)U=Y2M0RQu{S@oa#f_7jo{*{akzdmVg3=
z9(q67Uhef*v;BVKe;s+D!ao39`{DzHP7pW}=l22J5Aw%^ZWFjU=C3aJWyfwt<-?3l
zPB@>&97o`HV!fd^3*Iws?XGt3+UCl3zuX&l?dmqN*yC-DxJE84633)^>c*XdodkOq
z!<d?b6F=f)%uQ2;f_NJj18ZPz3=GkJJBq&=oAHbogk29(wl!r)B!I+qMIg_zf%3V<
zrAMQelh8x-Fpgc=2*6cDINfkn4DdeuADICh6S#Z{xP)mR7LW4bj?6CN<ytJT0=Wq0
z>jVANf~PSmISj1k4=Ox`AP&oMh%q2~=rdbNg%J6`cP43cs10lo9t9*Qalp26P9?qR
zHo%-fb_KEN(*g*B<7a$q6RJ8h_YfgPm+(*{djb%E@Ndcnxx#c|%b*npK?O6i?G5X=
zVX~}1(G@?ASeAak(>Pk6xC=4QHCO7RIp>T96`F#$$f=luJ!^mHV8eN7atDjZ2J%h^
z1QbBCO-j6wSmfwpZU7$i=noJO0qjx-ho-I+L%=A&R4YwUfiy@wFZNH9V|f93X)s`D
zMM9_HD$j5#e8goHw1pDa!R;|Lu#Xb0<unQ2OKgmSKQ~}bV>EHQVY^^p3>WK=fk-oA
zAu}O&^p$)eMDn*-3Bqllu6T8Z0Ns*UmywW=(*6~C$|i^h;HCtwb6-mkmZ=V2`JIwT
zb>Ko#Nkp0sfVV=yc0{0XMrRPymr5m*3(>5KARkRkDWLdXje|VXq&}}ba}Vv}S8Knb
z0Kz<>PT!NaBk#tjyburpFUq(LoDnWIa1mMp?JPCpoWNQJ^{XL&EF(@qJaH7q((aJ1
zLWsOV62kC;x7!hwJpC^#;5dA>&7X8Y0T+WnuX%~XOC=f&WKK^9xHIrd8S1^9?g-eO
z9v5*vZ95YKb!XsDSZYCjJ}RdO^N2}MGVorS7**dRIZ*4tw6-`Xlsr;GNL*>eoeLL<
z1l$e1GGYA88(TX<)!PZ3n~lh;WyficA(MC<4GX3`pN>qSFl%h8;352i0WqzjwU|6X
z7-1B>nK*udYLYBOS;sjnn@NsV3sI-A;{FO{?1oc0AYoE!(I0$P`kF{pkq$xw*=Xc?
zRRPhbu+l{a*y@5ri%f(f6XOO<5@^i7;scS)!`n_sF@iV97q^%a2nDz!WdU$$&}F*1
zy8?0s-NMA5GrvM*-;P>Qr8CkFGuS%#TrA;+)<T15PN_KnCHFSKS-ZP3>o`G1P$Xzn
zk0Q<<|FUREIp}gI&$4P7Lg-7qXuoGClCSZ@#kYMV3O@`&kE+Ku(7OXDM^v`B6McVA
zT=Hl<ifZ}j1Yp=607Q_^riWfwL<Fj&rcQM|IY3Hg>9lE-S}>$H1mEB_PnwvMz(ES{
z?gjuYoGGc2YVy$W41Uv8ix~OX6tSELl2oN%pLX#`>sY^_DfXZg=801~a3*}?HrEpy
ztfdGkvpPz8=5Flq-O;1GOHD-=Gw9WZst*P;z4z@DxeI4eYS8!xl2}79^$HK7Bk-Fh
z02nw=k@)N`9A54d!XX)xF>}^(h9L##*T~AsX4oG2159o0j8tYPV@-Mm;>WbT2IciF
zP*@L<EOL;G9vj3MX5hMvv@BH30YY}p%NC!I_`q>8(Zm>pWP5|h{Y?2cc{htgnB5~(
z^4gd<_z7cDZ|#-zN+H<ylS`;$0f_=?Nr6R>Uqb3q0^9m9P+P^OAXMpu-oI~KtgQ#~
zd=q36FQ=yEB0x$#v8MlGA{xbR0=`yQAIhSBW{xcD?NqP$$F&q5erfT~f(pa{Drr&*
zCn+U$V%lIRU7ayuWCOG2l9w+moT20~W((<qM_{ze1o|rMBUfH6r#?aRNTK@my>634
zmJr1-oRDM`209QDceG<`BqInbt0be8QrV>ll=U`0>WQh_D8MAJotFu%W0Lhk+1Ldb
zY?uN^sOUn3XYP{?d05oj1ke;N1GreR{SQEwD%foqHTN(vj_$q)E_q+|k^dH&w14xe
z%=S^LE{JCc-VD$ZQ5*<@si^RLL~-dTxU=E<=uk@iyI>x|OuTbcU(_|(rjotr6%cr1
zBmpstr;Nus`UDOzE_2}th;c=-Bwaz4KfC!_h(b{BLU|yOS^G|M4c1GTV=l|z962Hr
zA+6#o$B89gdxR%K6dB~@wb+?~-N{N6-+js?a_joB8l^tu^ionWYhdDN<YC{OJ_5-y
zGql+J-G?dW7}%3Ec`Lo$X&4SAkj3N~!h7?#Fht^4=89~tTf(|kuC|29!(wpe3dScQ
z!Z`G2X}!2U*ntPPg7>%}DgOwkhTRO9IT$=sM^gcFW-L8)7-3ZDak^`CRx+;u1Z%+H
zraIVI!8VjFlp%C}<V2J!(w=KxSpZo)V!D!}$D0y>=e~kdF`(eitLgJoR1xtQsEK3e
zYseq1j?IZ8MKqUr5P<N^6~SF2#WX*f-iSY}Z}od(Z1Cvhk@b>mkO76F`1YtlEk^@V
z9!4@iAz>|J)fsd|0YsLO-sU)-DZ)+sNliOpU>wS{K`RikZBiqax=RM{kdFP}a-E<9
zdIGKE;ROY=xCH=%i--#V#3>+NC{B(1(1gE_ngeM8iC=^ktulJVXL1*_K`=-|W;g0h
z)sXW6A_OOb2`oD>6#=6(SJ3|2WHwATn@p3K-(FMz^;csO2qnwuO6Gb$E$e32!1hIM
zLv+l7lbeWK2>=2}9D40wg<d2?g9liFZ*6oqdZs`Tx;9;|HjqDY9#;l006(_?W><Pr
zKaVfrmc`lhk%Zi3m0Dt~QBUcy042z0lFEzJX+sla8Kc2AWSNtfA_EHl2p&Cc0IVvO
z|Et+4c5TxOk;xO30N7y%gdDvNeq(Q*N#c;wC6<HO4rGT1=k24W5A!T=bUK{KQocn;
z?rZ;+?FzPo^H2P0%M4zD-hG5QRD%%IIfhPzJI_!Mkr)+}HVKJP4{5=%hTLy}!m>u&
zeMKWcZZru{Giw&xt^0dOv~<{T`fWf1xB-*E6<7Ql{j$AcUN&%unDG;(Wl#xgmMyu`
zHs?BJyf)tG+Pi~l><yo=HhCzLeM%?-pTK7Or;f{#D(bw@pwCs0)oyRv0|<$4S?Gk#
z7)6#agPXNR)EC#Wv~8^#LP$2!&up=CGTIZab<E12GRqe!jhSs^#xoa6Ja{#WNn%8=
z=;>WTJ4Hj2nGl0Y`i#4%Q%zv3)-jZx-*s}@qO*dPvLL-G$T=5qR+gX)R8jP{K+~B6
zOXLg_6lpvGr0>R%DrN`J(ZOme9(Hb;qb0r`&bt^U4N*Ubv#tigv>O7zYs%5CYDTr>
zwH+w~Y63oy9T@tM2R?o#3c}FvlXMNp3L*XmKUMEh7n+0wB=fWsbD^9j=KG%1VBlMw
z08@CLOU-Sp28WrIXo1Z16Fkt#C$U^$feY1g?V7u22Z~R|kgFGEdq$vFCWV<fV&c6%
z8I|oC%~y)2K+3B{Q<&bOO$u^SmBlEka~sr4DMp+DV|s}LRA==FifodXaVi3&)kyYA
zH828^B!>df=d>A>1|oxT0s<gZ=oUH!ECNPA`UIZON3$v9ka2M00UOk&)-kmv0#k*=
zfX1`Atj1>}m)tIhmsEw85nN#PCu;$`nGhP-Pn{kDQHF_dt^k$9O6(G-qI{nX5(1RY
zB{KO$j8ANu020&$u@Xu!1fLBO0g_GxlJO*rLu`irAg0Hw+Qy~N^rFj!)O6;qA@Nsl
z<gX7%LCNrwo6;20<JGX`o#e2q#GwVStHhT_Bq4eXUf8`TFIfvvKqUJ(PzY8cD=iAh
zLbMpIu{uaju@bJfn}f7$)&R_H%w?I3gDs%t7mT8klvT1yPhHAED##|d<f9y}qQz1&
z8Gpkq!X=1Ag9xA@7km<sfK`vnIq^8YB{!th@RVK^(F9S@M?(|t0000000000pzzoz

literal 0
HcmV?d00001

diff --git a/clones/llthw.common-lisp.dev/gitbook/fonts/fontawesome/fontawesome-webfont.eot?v=4.6.3 b/clones/llthw.common-lisp.dev/gitbook/fonts/fontawesome/fontawesome-webfont.eot?v=4.6.3
new file mode 100644
index 0000000000000000000000000000000000000000..c7b00d2ba8896fd29de846b19f89fcf0d56ad152
GIT binary patch
literal 76518
zcmZ^JRZtvU(B;hF?rsAN?(R0YJHg%EL-4`f-QC?GxVuBJBzSNO0TKw=Z@2d0uiDz~
z>N?%0@9pZhTXpN4G6MmC{{r-%!vp@O0Rbuhwcr6N8vm31-}!&^|1owS^ws~H{tqAo
z$N}5{t^jX<6yPJk2H^Ey<?<f_0GI%+|IiNL18@dd06hO=AOOAp7|;LCIQ*YGU;r<G
z9l-xz@BqL7ZU85M>%R&Bp#T5O1phx10RX7B{Qt8t9Pl**$n*kadIQ|f;xC*hEUn@g
zl*^#1p2$%G{Blbw#9Q*e6@DYa223V18Ij|2&2%cPTvx@iNioUoZ)_KE6Q5=~WJfZ6
z@6#n=xTLp0OA@il+i|so^fL%AHC3|sOKFq@_?XQai){2qkS}<LEqfZ(UZu?78B25O
z-(D~b)*XzpWFCkmxOXwI=|>rMNBrJi`>xR3*k)Ld4_O*y=YyU9%ULX8Mt|3PGQJ(=
zu5_-C{h(64@}ws=y4%mO#^-0|S)8jKTS}tyTCRrQ#rm0C*{&43?>G$we1bThm2RqW
zr0DH!n;Ru#`mDbNA2wM$;x!?!a`4fw?Fo~yus67&r1abr>%F0xMWMH?N|{wiNZ+FY
zi_q&l)sRzB{O=MeHnz?|4E!7NzLgZx?>wKfMy~Tr<v1lrfDVJw5gal32%?U8Is!54
z5~`u(DiXFR6mS8Eh{G<814p7VmZJ(r##revH7r;@o#P1D5orH>DUE27f?^!K0pcyz
zKgVg~jz3oin*6AlFIecSs@o*bYRurv(wa@E+g$K~!LjVYF|>8*mz38zvT0|~_Z9-@
zFpwD~_2L(!Y&LKA6%F~|!5SJ(mBsg47{V^nyZ*x17OEqVyB;cG?Qs2f_ZtmwuJ*$;
zrV4&09S><k(iF>ZcsCt|3)l&E7&8T&q9=-bJiHDK3=i=dX9doW52uEMp^BA|^$Stu
z_bobQ9n=z83Z~xpsct18Hw06@v%p4TXJGmaJEDy&(-v74j^{YHE3)iSLyj)+MAzaq
zSB+BK=7$bIV5~T@od+AQJY2H9n&J;sL(S53?(5d<&xHEKF#(AEjDF0n9Jl27)uNRn
z=Zqk(EM~|62JY~o@N;`C!oum~!C=AiA|~s%&&I<OqHhoQ_=f%e0PE*Qi2ail7c7Dz
zBgYpEb^ku`{q$=@9B<sJQ#)H1F?O>k>G**GymPqvB`PYqZ;u*QIa+@iL!)+*8P-7K
zBA6oelJuQCvn?-o2%~luo8?Xb+G!NZ!7(~d1g2ttZM_#V^1$i{p!Qb*N$?!^+u*hF
zV7O^eAoMadrY~~UdHTy?%pjJPqalWC^&_g56Y~m9&?E}nU5>dTmN*NFuSg;4cIJNE
z2^EiW?@vNZ#r<pbwZlhE(SJpgDX)MKo)#*Wc=XMcVu>%d;BJ`>nq>m?N?9aCRC>Eh
zlV6Ugn6XebS>cYT-zx{MC|>X&wjrrzRb@<5rN9sBgK3+zcK*f~#(jWcq}V82ZaN6!
z3x!(uoZC?rX`+`TZExW@B_Jd`o0*~rUKsn%1&5+DXP_)=VVN6Rw_<%|IIeJXU{K?4
zkvpJ6ee4r5g*02SaFM0f$+GrDNoKlJ$fXCjeyCd_b;&|GDk?G#%7IhpGA~XrsRNoT
zSn_IST!)8|RdNz{EK?$GHsh7BU%UL{N}W5${L)#YgMB{m(WaRfq+Ozk=>6yo6i(u{
zf(b&PyZaNLrRm8d?nLwm4RCW`F=y{wXwBU<1oh#53u%tXKBrZtC;g$CQwJ|3=?DCD
zerFLv5RFMpC{V>kQ+TCYW{$YVXPdLvhk1i?2BH7*5zlBC=Eg2pWli#0yzi%PDl04!
zX&Dv67bLYow-X+mpm<<d)RJI(1Zia4)i>KPeKlSsQEOh60QCqd>_Y|7@=xfK+ngw^
zD9o5yHpH4sx!(oAf3Z~ut%84X+V41Y!;?fEQq#q#+CzZ?=oBqWXmCht%;@0qn-pXU
z6&ZLq5MdGq=bNj3NOl3&${$YR2TE&Oh0hG0G2EOV^jo8A(1&R<EC{XyN<Zfl2viTH
ze}H`A)~#IiU~kc}Cxg-#%uy3o5sq=i+D;JhXS`D~>ttcnDJzR-h1D#R0}zqpfOicY
zzq2MeIM+kW>E-B>q$uKRN2tGiHnK}WNo6&OL>_<E_Y<46C_(s&%@NMXT7#!zq#9va
z#4&@?gJEEiabc_0SJyK;YQG@8YEX<{d+3ahhzNrFP5CPUc}5$7e<PcvZc#xERi>t;
zV1rZISSu}XgE-OkNg2_I@hb}1C?6<}M=_hc-{W8<k2vO*6#{J7<BwlSv)}WI9!L69
zufx^TEKqe}5S2x+mHMN1{`lAmfe1mXq>hM8NN;GYL+>#KK0dwCHrBex*Uqk)i)Dqd
zU#lhxdi%<zG*ON!2A}cDN7z&PZI_i$p%N`mU4e=z-8=1_VWGr_!<{{`-Ju#i*Ik4D
z?Ou`Qnnsh3@=chssJU*I<g8FZCLfg<fV^LO9~hGh2+a6Mwu(c;pX#Q)-fpWfRVFv%
zTOPR$Zn2Noqih?9;x+VIR#sU{=PFoUKf~y2N;drv8cguOR%&i4$UATyh))5TPzN%r
zbDt{kgjaLYe3WMNJeg0$GOzX6S%BcKB~86yOs68B-Gq)b>Txp@ah5XeFm?k7_Yodp
z-!k}ec>%eSm}S5O#=xIi$W$Rq_rR|K6>k|OA9X3z72fKks33U6BPZizFb_rTqPa<4
z;wu%~I7|kQWi{Idir_c6&L3<@%aS;uJbxr9td_oX+zt<aY33-u&z^7YxGTXVr}djh
zHZ8`89HFA_W=KX;Mw+~#{vj4(=834TkkSeLXCnJJ^z4H`F=c~$z>x@{eMop15cA&f
zZiD^v=IYY`&ql<af-tJJb>v@6!HQpzSQKsQBb<*bcP;=jaHWhB2F^2tHq%Km@FhCs
z{w($Y`FD&xEyPe52lc_;IpIF-4O|#a2C?nfX+bMIXiumj=O%J`M;E)dMDr)&@>{8C
z<PgGE!J)j@g9_p4X;j|$qfQ{!62b?D`Uu+h8J1B<sB4*i#{F&iQ4mG3D$MpGe#Z6$
zla!P9*A)*s@7(A`npGNkF{ZEla3E?~b7IXb3rxGhhYj&IoixPhK<h=G5~ce_JjhvV
zCv~pQECXgev>3)nyTY?5I}>~fhpzYH!hfU7Dx2qW9CttqrJKu+NeWg8bK1ldYw%>#
z7D=t1FVzX${`^Rx_Q-`n#>5qB3-9K1!*Xpt%P!%+rm=Mzdi@Jv-Mdm(4nC<T#}ndL
zEv6o9=~Lk4Kh^m=ijsYh$8t&RV`f6n<@`;oCEuq-s6TkVNJLH7YfX`v0W&J;=j1nB
zj8OZ=c3iWty|%eLIX~tw655rlq&fM#o;@Q9gOOpNDUP5?yiiN2e8hHSLFiBMtbJ#5
zgBDtD0?Ka+c(erc4QLJE6voc9%zC@|$Im>kDi1#eo>L7qH7Xc{4y>=Zeb+Acl}PCs
zP|AstTnUNT8LcRAh$XiY&;YtB)*~5^(DOj|p#-~{ESml1S>;0Ihcen0Y@f$jkYvz2
zlW{_1tCm4;<wOlGg0#jTED`*yZdjqN$Qv07Kzz1U3hpt6HkZelbCAEkp>RV=Sq@*X
zmZs7>+b|O^;)AHk%5D8>7yOUqk}r&jH`_jC_&4r<?2dT@gck`Gz<~@X8KIA#%nVAe
zw97%7@)1gu?TNE!f0GY!tPDk`b(v~o*zwRFbf!`_4j<Dj6*`5IH;8L>N32Ui<x+<w
z0KvZ2gB9$K#~wZn?BXFA3W5)tb)0>k1G+>)%Ej{3OW%M*irgZsH)L#PyqEESx$?Bw
z(TuNjVL(pLO3PO3^)xyaV&7$hStYhzf%C&8Z|?JwE{VP<vQ?8@u3Ak4a-s_dL7dZ<
z(8~KTVFDrUg~WepH@1-~NkaVH-e3v}c}joxYTVSQA__y-_a0(H-4JOMHoruxVMUX|
z!PK=?w(KA@rpQkzdyj9ENbvY8>%s5F$D11$(l8@ST;pbV_A!S5i<$-LImWb|qUoY(
zgN-4291V9tZkzizQhq=oU!hNIw6!x{8rp<kdQ42H11Vz`dmyI=y~762zfRwj6_rw?
zGf$CYB{Fyi!Od5OHv0(l$yxirXX&u)mFq#gfy!An$$=>t=AC4u-<IhPUBlods9fZu
z(zEZ!RzB*^D|(_N<hss%+@Ls#8WVV}Dpv(<VRc6vsRycmiz#ctyvzek=`DMwn(i`#
z9|nzsxDSvrqqr_}Vo<+OmD}E%rjuu_yln7-cb!>pxG>Xjeqc9#7@E!m<4@k`?Xc3L
zGW*|?jHH~P{52A-aV(Q#{5es%%#G>8C-I`9`^(zDzJgCtLZ*03KIvH6jYvVe<N4d<
zpWV^Qrm5>~m9=<aXmzEGm5NtXBt*7XE!CgHtfA<DJ(9s$R$)!_Bi)Z_Q1c!PEttUW
z^g9~2ANw+^c2|0w{0{9UKwGoe8v^CNRn!dvfF-cB(ws0-r%-;=%DEXLhY@oF$x(Cf
zI+O?@_3(6StNeP%-->u?k})-Q$0N@CYmQMic;bnk2iJ>Vm8OKV6M&st{n4thcQ|8w
z7ghMeK(fX}mM?x8ly1=nqrOKo4P7{=2?9!(bUPhZ*cvf1)bY705uSXn9{deye9J<Z
z-@5WnKCs*k2d3M@3Zbq6SU=2%Cx~H;ajA@{84`b#bq{{y7Kh0myW!mfYz%n53^Ebx
z%wERrtXmtnq@G(XJ&mh9OFEW(+OIObN`~}I_t;q^49n1vm`kDju-$K&g{`l%Rvnfl
zK!R;_l5qFEmSeZf_#OW&I|!2qh4GBdzZC_fTkHQVjtL9pmA{1^zNxtTev<6sp^!U@
zGP9MM{9JV)BwZ2yoCh*~yvqzqP3EH{qoeKQ9MF`kW#qrlOz3tutZJov+T2)RPUKus
zAsY}H*|y{j^~(8tv<TdGIDZ|Vp@ddOe?VU&{;~@3(=(}W&N8r>velcco2b>1-ZJ}k
zFmR^35d_{lz01HTCO8%h4`fhpf)ySyi8hqDTcE(`V1*98k+0cyKPG&<t^5DY)m!6W
zDD$UaXuO9FU-#a+^F>K99MoPzY8H%gq4+vdug@>y;9pP%`0(vW5A;I|G%#vZOyK?F
z*(Px`vSR3C5JU%x4YH49uOow^77PJrF!ST?xHI~)rAc748p=xY%*3S*Qe3gKQg@pK
z49qeg8DkFigyGW><?6xTBO+w5QEOXww@mu6yw+w)wYuYEbW?oQ3@Ax(az^Q7b!d-9
zAiB;B$h3VyRyWo`0*;71Ebgz#mgDWKmiS-nKZcA1{B7SNkKG{<M;LSD?;AeQKEGqc
z`}EBiY8qb4X#b<dRj!;Rj@K2NN8Vp?_i4Tgs<#1cQhhvTmnEC37001T{#pAoY)SS}
zW0W6Z^}+p5yq!_bg387#H;Ud*@Lv;#eLd=Cdn32jW}d0P>y@|>zttBjSBN$SjknA5
z{#6t?XWP<2GvG6%gog<3*CmZL3)K(*_U>y|<wx%ajXvwMd4y8Zz}QMrgU<0#aI6}Y
zHQ|kU)q99F4iSOQavB5u2$5pU3@B$*B=_-Gd8Ul3vlO}T*U{-l;ba|E5uGVhhG{E`
z@55&*SU*a&J3sN`P&R#MNno2a1;3;1-ymn+dnvYqAB)p5Xvk38tXVU+G~*;gj7mbP
zs+NOW+>O^fpiv&bA|&5RY{7dxl^*^+goJg2=$S8q^swAAT(IoKD~`el<+<NqTTUyJ
zrdkUmqIvUNXZWpRYa2!;JXPsTbIZBgrz8}wYp>KI_b*qBp>Acw-d+=MRc4pnDWkV_
zE<-7i*`{-C#UsdI++oxdg-81&2=U7rtwb-4H(MnnJFYlY>jaoE&5kQC`6+!hPo3Y=
zbuYPeeaqMB&TtQ&zTJL@@s|{*iX`!P3ws)`oD8McaxEUl1P{3{P07T?i$-JOq)JIq
zgRQ`>ilyi5qi{KImy=g-y`U>FT$K`LUty3n>wG0d8N(dMSlmUn^@~JG65S6ak|v%X
z>G(IGs&}$r%!vWT1Fm@Eha|%nDG3II4qI;L3SHk4It}(`fHB3W@{Sx7Sz$$dK@)6~
zEMrYY=)_JoWHFc&Jy?*ozRL{n7UPAF_`8^_cxG5<(O0-YRVl5KkW}e?m3H!uh08E4
zcuqC?kiQ;5F5;Uerw;!g2G^M+XHOwy8XWG2d~gLlX^queZie2A3fFhiW7Jlz$8JSG
zZRy9o7nLFKFwK`I7JA_bG3~WM_|p1alZ)@~b;Mw<CNx<gNsLeRwZG@Mjkb@v6{IJ4
z4OEky_1cNXf=@+zYf~Uu5_B3w+&c>Ewv72`+N5ZECd|CyvsQNlYuxb%h{b6L)Yd4j
zJr90~RK>_YG^dJlW#khv(r~oQlosf#7ncRUWMR-q=P~X_f_i#ftf&oHchD~dt_g2A
z%SjtjfmS3Prw1h?V=Cl(OvJnPtL6{wwiNU}Qf(Vpe;`IjHGyRu^~q>>+p0uU2lw$x
zzX{EKe%A>2&+cpPB+z2=wR_UL_kp=Ktw&-BlZ(aDP&&}Rk9}#xnfy``eTj|gL?Rz;
zq5Rvq?aipr>Vy{d#RXNkh3YsJ+s}1u62e(X+T!j+fEOV-9x?NQ(Bk{uiNF@>*)Y@8
zK5|n2^0F4<(YBlU((CA|SGy|XtPpi{lvjSEv=Alv4>(f+IrX7c@bO2+5m;?P0&{fX
zxMlz*4#<E$9Ey^2|Bmc{5~>ik)>qCBM1YKaeT#(BXZ9Hf^y#EuDS{@-PIFz=<>Z4a
zaIz;#wAF~((i*{OJl~6H8L-h5knI+m*+y3Y)%XfVBDmPk^kz}>xpPodw4Vy%M+srn
zfa$)D7(JGeS`AZy<*vyv5lX1n@N`g>rDmI+t#5>9;vOmnHoYtg7Yv}5p7P2yCcRW|
zzlUBs$qrUX{3nw|v~_f`>(SgZ`Qa4+Tx1c*l+IzVLbwvDr;P1?$^^UUn!-^}@8Xnm
z%fd~=#ZUe-g`*?%S`N1GieL}Lb3o(#AsixR+*z4YGbFTgCQQT#pN*A}NAQIru4^_Q
zfGfqz&^(HDzlOh9nRMIRoK5pphXL(PjR^nzg-K|CT`_RkoAZ+(ni{!)1(8u4%#Ssa
zc8wPx(53`h2TV}su1f_>Xz;<;0JgxwSB_oVqd;c2Dhi)MZS6Xd44JM+PmT7)IS6ju
zrIlm;LReLX))zEtCvMC)>Sk4~wk0I`<4^kT@r8PsP{OfG?uC<28Hf$2oSF$cn$F+o
zG1)UiCyfq0t*RJBr7TA_ry@;aEmIS=;e)hq8My+vN-x70gEOKQIsIlGhsWQBCQ^h)
zW^)Cxr9?04EB4#0R0d^BS)IE<j|cUYyy3MxgBxc+y3gLAU#Exk-qzgkE*|wY;qCUV
z>zHm03mqmV4k(Y&49K$a)lfPC7}=$Pb{vS!aGJUz8u{xMruX(ZtQ$Vupj8u)z@a(<
zp2!M<olv!!eZASX6%m?q7SUi~3Zh<H3JJzeZx$L^ASCF**RNx*ca$z+YF!D8Q8Qu0
zNVi0^t;~8S;XjV-X{?c99gKu84Sh{O$8DBH2v>SE5l0Ph1{$p_A^p{yDwt=0Nu%Y}
zF5A7rB?;Mo@{eMwB!WE>5v-n-LtHT*sF}nfV1vaYt2(D26~VK_<qPe^RAF5&yU=Ct
zEnQ9ucX$flHZqMe25ljxI)yLF&b6EwJ8-zEaXk1`M5PTgT1Sa==0-NO7YSdDCh&aB
zVS)UbYzeDX0j`W&rpEkfPC^kQolCh%u<o(-pFM2r!#j&UuUoWlI{V}wo(v?$9D9Ut
zbsa~p^YxtTI@JL8e1<=jKf?;@v=hnj_9<`}gX--j!jz}<zO-T5>9Aos3VD(LL+qC(
zi;TPVQDWu#gBs})2zSe}9{sPpWd8|~1u=Jd*KFN%4FR`%Whxfr#}0H@%bb<?hXg(i
z$2E&t<Y(&6peYpx_y_X+c7ZD3BWh5nmhgU#?W{1RgiqhFRO26H1_??Uy~xUzOY~~&
zxNM`wV&p2&AjPY+U}tc!k%k`aARypFQCFw7R#<J`#;Ci^eY>CFGAM^X*lh$E+~aZQ
zXaUMlg<>2!by_7y1^eYlKdJos+F357hHF;RLdIlp@q3ddq;(KnP;bE{U5|d;1@D=w
zV>w)+K=!izn^)|>yBED~<j0ACc3*OVuYq&$iK`%AYwY@nIr?1c!}l*dPteR<B!<?q
zM12|B7Zx=Pd2_YjSacb<`pD<*R}jfj*SoBxQ#%zIix0xatOXecQZ{9K^{6z}4lP;m
z@tY_u6`^K0&Igv=+t*uQlr*K?ioe7kVla+Ts}!Wl+WV^$?{1hT;IS6Y3W3WEUOsH~
zL!_IWNozSet#MEZ_A7K`H3S*tb@bWZv~68P3@P;O<)qFX9f-|N%4ZD{sWRG#Btk{J
zi28t~D7{pIMwoORE{=ws<m~<GV`e*@93~Ak^PXM3YdVNT4o$Y)Z4b9jgWd~1*VBRo
zjIoB^SaKjEZr)?B&FGgB&HWF~=(2RIYv87o!ZjtFE_r3OJ_K9;-QytvuFU=5VY*(>
z5=r>LT7R54^@n!+@L61Y(Pw%u<Iwm>I-+@hw1~cV^8&2|fKr~4B(av<M2-(->!>$7
zrC(%zIs2p<y!_=d9K0Sj^<fEaxRfc*$kxNYZi;#vEkFn#L8(wU$ir{T2f)tUw_Lrb
zy-<{1m7o&SF*QlbsKGPyD=t_;_D6&eeJ@MGD^Z#}-U@{<gK5@{YYMZMoxN14_b#x`
zxea7$g<8gcgKI3}EU7~6RIY&zlD&ZIOXBW%QR2O;?FGm6U;Tp2A>NRwxiKNbtMy$>
zWtRM|L$1SJq!e6jiW^Rw%*s1-A{;-ulF{wX!>~nrl)Gi7bim2+gGp_F6|cOET9-MC
zIR7|-f0wiM>m?Oe^MJ*h^Gy_KK5cFLI_lfek(OL?t(NJUzeC$3`DCWWB6oxc?<LwC
zEkNE%$71jTT-f0t$Vl!~s6<LqlE^4lM_4c~;YG$~D4A9>t)4SW$=c1L-XR?gKjR6Z
z%?e3HKEkP$k8_FS8)D)1M++Ye?E;^@B2atFY;JXYNvE_jX|4nLe+4`QlIoU#r7-ZN
z9w%ORF!TdEE32>(PP*9f!4+1ypjF8X34VRdCG>HWCXSZ+4n3H)>6&dLmDWrcE<W1I
zT}Exjgt^4nJ5mR?_PBJu!8<URMpPxh9oG%IPD`-&A#KrIOmKM7M!M&g{Hha>a$2m$
z<{P|tfdhbDou2!+3#eDom0vm@rRTzdaNf?nr%1`}2fuAx?vw1XxNjyCVu`X4lfCPO
zQw{A&4#6$$$uk_U2))K_Xp5H)Ynj;M%OG+#5wovXa41<AFC}#m`A)|HYW{@%5`EN<
zBpsM@_=nh8id~-&35u9@=mW6aL?)ZXJ8CnEQiMz$RJ7D<+;GkWc+}a_(DS4I2^o45
zn}7dA1;?CLC<L;SkOgL&6b;KKLt@BkmXxU2*6QD0D$2`|EyHM`Z45EQU9`Fao4LdY
zHRPLv3GTL-79Y_51qYcX=lxh5EpjTYy-!k`u%vG<H-+}!We27OTu=3NUT>ut|FriC
zZ5?nF#JuH|{ni@Rb1?Wt0L4ckFaEV!VW!ox)2vWV@m0ortHgG<(|&aztcf*qm+?!L
z)zAGm9oxG%PF6M%JF9lvlniIsGlaGwZ)XwlR?d=41aBnzLpe1FoItFRR;`$mDLx}A
zXs(tnZMYsu$8goUuhiJ6uK@{%@GO~1CH!K6;^W6x_<&#;VzU=8n&L{Tu=AvTmmg1Y
z%U|1*!pwm5>I!81otTNe4X4)T`r@h)MLmIfania|o4YiMP_|=}<j~TsGhg9HxsmRK
zr5THY29-|U1nM*Tk^)2aZk*~l|L0G&9kfbexreiTNlVTVG@&56DvjaLlO(H?2V$wE
zP<2wSW#eTSC{|jM7t35&4gTKV{o@EH%8j-;UHw}wtqAMgG3GIFco?4z6DiI-OD>*4
zm_pWIwxkEH#`m|aw5Oj2cV-uB#SJ`daQMf&=~kRF@3xsN+UR(DDz5Yk8lDcaoW=`$
z;qNA4Vl#=JGw=*2{Zi7KlpC7JONZ1XD_bq&cHo~j$03Xtp1(JuD@k*#UgfxYMp_f1
zHeEc9Kcgq&|B5(vDZy+(Etf2hJ>k|_^m5d}rVF#m0M#V`Q9`v_-A*{>_qn*375dUg
z20xPEwUamwFwVaNtLQZ3gYac3D)sy^c<-eomp&)JqaRT_aA6r=N2r6`KOM+GMJ=uR
zJJSx}{}`IzagvLgClXz7Op`%JxJVWdnAdVtZ1L!MfI<jTBrW?WlIz|Y?hh2B^WHee
zX5PXY5S=>pFd5$mbn)VtpZ2Dq#c};nB58w+tL1@BkvVm+h71i)<m5-M*cDu1jL$qu
z`6{P-*fd(qUdYLdDTi77c;Ri<9tV~%)-D;yG@TEXR4lSmewz|40goEbnFyV!eG2+4
zZ}6i13c1?PC6-Iw*xxk3aeY*&L|s7p3rvR?d7}m)o2w!q7CXi+y*y-DqeTIdq6UYm
z>f_rIG$a3$o<TO|hQU#1@5Br>)nd2gZCgqZg~DGttbCOjwn?T1fRRA~iA+N6zr-;&
z7UpcL;{pJJf)iyuS*g7~6!ti&x@hgZ#xgHB8ZB0#Wgu+Hz!hHcArgMW)f)z%?s16(
zJeG`Z`(w!uZJjB~*T>P26oGK0$6Ra+4CRgGJkwbG9@u7+)h--#OMaS^94%|>j;>R~
zT%qfgW0)@wi&e~`^<*MZCoDx~+mYuARSCYEm>;`|buUuX)z=r)Q}WwRB&Vel;HOqY
zt?1$U*XyTspA5UDMs;VDIKkBMCB~1`(9)wALGvaW59!Wb<X(-q1s*nBG@LfifmrFi
z^zmZxvF38`)K2N+@Mex4B(l(vSnr$&tm4yFKTi$|wp6K&1^~TM-uc!#ZxwgN+K#J^
zTwex;P1s+=PVph(ZbmVIfL<{I)C7M)A>3>nh!}Np-waLby1tarvXP0A|3ysMqsnTY
z7IT-5SgV|NZN3<9`r9|e9fK*l^~72~4KML@f2-=7XWD<6>M0GD5j6}OvWt#l46g@+
zBn=-(Fs@xS?n)J$Xr>RwZ_#oKk$->E5KPBlHq*q3&L}J6YBw6pbza1XN073{97~#q
zTReDJZ>6J@;i^yfR}+Lp_`&iT@`z?ozx07)PYkFJXy~x!aMN}S`gwL~_GHQp#>HGX
zc~A1Bx|bR2FLSL3hpVg$;3TbFS7q&}#y9$O_!03nh!J87!{4e<Ww7x6{FylPK<D`+
zOR>)7zFtHXwl@hB7Ltnv=C{#bIp5A)l^z}mW$@fR7r0bAlUmCVRMlibs5x5Fq4U26
zSFZIg+>*5IGz!0zBUOpKJ^_PQ{#c44>MBlmvZ+1}#mCe>UnZt2iU;`b4=Ks`%8=u9
z<thdu{|nXUD_ioYjK1!PWX@BoloHUl-c}ux<!muzal}sj{wS?ovqO(|W2&1YM8*Vn
zIFcJCVigK9K}is9t-t?ekqZTHDcsorPs9~*Ds_tgMwJA>$TmiTS2eHRY>QENc*e&d
zSDHMkA*D}>uf!<*^B@wSh<S`W^;KoWTz~()`zP(}u-Vk&;iylNQV3mvMJQPoQo=-}
z=~^YB!^sVoVObqGD>{4gG$_){w<$pQR|-hgLw&6qP`8Ot%3y;b<*UB2J;84$BC@z(
z0JW2)PBTCCKjX|mU582DgEFE<$JPnr*zT}0k1YqgH^4CNNRbg-kp)`adn6aOvc~Tn
z<LO?Ge#iR_Jtn<nXB!@^1fMVuNlk%lN`X1ehdk(|k_->Z**XdG-;klXk22VA)~sxk
zl~ViCm}zxxbQj#Q`nC&yi@#^Z4_kTje7HHX#Z9r)ohqOEbpwy|I29~GU6A64V_oa-
zLeTsWwy=D=%p;5cn~o;lcCmBai<ymCiU8SO=a(l_Yblio`LC)`%Uwr!=6UdHzw}=!
zNZ@FnDl?uq<H|&Ake+!Fvk3TW(FX9-U9K2~DFit9;kZ6cp7dkpAEw$c9$8##a5|OO
zq+NNgYzhy$H==+_L@^>2-3vZ%ow2_$y+$xZE9a9NyBP=T&sy)Ht&2m;fC*D$x5eeA
zk|-3we#iLoM>`ak;r{MPxn_C^#s}X4GPjq<$1sEism9i!lz}3?-rmuB8BWatzqo_u
zwojq@6^6W+?#sB(9A-t6S&x7YT$vmtWaS;So$z-~JKO2G?-jkjqh>t+a_WEt+UFN2
zX@i+V!X=T>N6gbBpMIqWgnj>PP)q5?JS)9!FEc|K<zsNYgKnzlY%9s<n^Mu_ywAtB
z@Yup^=VTQrcd#~+xy!9sk5W(KG*3tIOXXuVn~*=J=jAa#MmSufnU1&*NAn*a$bMK8
z-eI^c3F7vMU6fUlrCYSSW(wx%$fNGLqEyyLku``wzfL^Ef%}OnNZfDuU1rpfSve_f
zWvGdUmA3fB4L*MfP{7Yaawdto`z8-726`g>N!IE{ij84)nbj-Fp?IQ>I3o*tsg#=d
zduJ2{dC>k_+kw1CyPEmT_g$u?`dcCuf3qeu{4TTVg=R*}j9DycOo`bl2sfcvQuTPx
z?po`60aA%Z<-w~g69NG@P}incHlH&rU9IM^nT~4%9$7g<Nf8gnImdLAtEL*!Grd+O
zyh2S<DJ|pUtV6a=M|6vFET1^R6EmkvL9v2|rsfy3$<R?)LQ9~=qcid&$_I&e4@|DR
z<o&O1V^1I|W7^t^^{GvUykg`SQdR7WaL@vcRaTDEPY!nB^;~L2{TQ#C%k+qH!0#OK
zk!hxZJSvY~rtwJ=Vg;Fp+>^@?rS!(MqgRJAhv=01gvcsK9^v8!<Avlxv@g+e!D)Y7
z5lS=EPmps`XV7J1#Uq*=r$KYx30lW5YH8SHZ$1o1e|aB6k)5-o4h!bFq|m4&Ly4()
z*eLl=Jw(*CY@xG73ZyB;IG*azC{#<LOq45J(pN&>{G&A@>6m%IkksPO8n*BL%HvD+
z#1N7N*nuKngpyM}cTkz$mIui*s@j$rcOKW;h8LAWl|eNQQ+A}^V=lrg45+OX9s2t8
zAYKBQRcHvp{l_zqn{q94ZJm+Q9>$`T9V9WCTy`4=i*k~7emc>orp&GxoJ`xJ@4OpD
z*Rn@(dYy_9^u3@7bxh7W)JC(!q&=JLC9+=wxj+;eROQ*+{T{CIb;eL{Yt^8Zu`zc<
z6ptq)CN(2r-zo;gjze{^RT84YICc<D_+(@vTRsP%r?gVDS`r|Sr*E~yLqFIqZUSp9
zy-WLK*7?|wo)sG9oDeULEF$2Yt`97b@DJi5r#7iEqR+Xj?WvgmL4lSjE0(`?Xyv!w
z;VN8bS+ZU<m*Vrk=5oS)$^QuRVB&U%<h>amlGLO+%Gl7MtQj`-vwL7&?an*?+sn~_
zt`vD-=Lpc(ZfZb7+HU?4^Om-*0Q>zK1gOU&R;H*WI9<0)Hmhh?85x07-0Ho$td7vV
z(N&g`doL6KXLkkXfHP59hv<!IhX&%)AI5SUEKZS0hO#pigCzZ<Uo^{A(-j(;-KmpG
z)z?+>X-7jiW1H`QI3|tb3JWmwKYdXIJ_(}J1UBkge6&iZ6@DsuDW^%3T)knHF{CVE
z%`NIrU76*s&S;^Ux)-wRNNKGyW0@S~o%L&f=^6HwcK7Zq?`uX^n3EUiTSg#O631ZK
zhePX`V<*B=tqBB-E2jueWZP5<LgGf~no!#x4p^xfOeH54%$U8qBhP{9>*2ZYJqU~6
zBthp-#yiU7$bn-vlO{XhsQf+=_^5EWB&PL>(qQ{5(}N~^_l1F9M0crNEp74zU!CK*
z5+0OcMd~LgQO6}Z{I{s$OauK+_pEI+*`E%*Qhn)cU&#&3uVg2pro5A_Js>f_SFWf|
zcNd_qX(H_|;#0s#1?X5;oeHPuVm^XdAWkDlU6o`E4+fXA(tI=sV*EvvJr^BUTjg;L
zRc>*Ov4>gW1(e#kqZJaVa=D$r3@~-;gkt_7CDSb-BI5{CVU1xd=d>b)(K?zRSwgi;
z`Ov)Xqi6P9&?ZzD^ZS5DaAU6Ejbx1W#ue3tB)PPgx}pxC<ZHZa8$atg*2_yj-Z`oa
zn(B95T4)**Tq24?bc0rEZ!0p_Eq(R$08rtNJSNXJnw&=KqTm<Oo~qNAl>Wbnu{7TB
zT5)79g_Sw+<3?74^>ArZ=-u%^Ox&LRnZA_Wv>%$&R=L83HBq0j6kvSW#Y`0dvfYAc
zwucJsR2@!xnRV+ksY}=3*80R548sDS$t9ZDG;8|8%B_QsRz7bpV@d6C#Pe>TJ17NV
zPS3X<+Dsc$rV!d}7La2q#0e-;nkB=jzDzIWm*iXVnd2wUjl266^DEuOIvAzaYfAwS
zMT;_^d3Wa)Pky!*tkS+&(k!z>7*v2O5{HaDz>TOYWc__NV^L^s&?A|2sO6nge%=ZY
z0|*A1n5qp&3XBKw*I0a1{O6+qroT(KmtZX$cGrM3Cg$8Q|B<w!r}?1s*MX-1G5%rU
zQ@iRX%q1qQdN=u<?Kc^Fuy%Kj5;4Gsj#5`t<^XY96VaC6pb!?tH0NhWI*Dr31`frr
z4m=a+IAh8MS>oVSrxnyM{uJ1TS$$|R;P07KaK|`q;h~KgahRhdM`*O!*o`&YmZ&TQ
zqx;X%9TI=&7eKZ$4H7tc@D6&*;=-7Vy_b6lfPYR&;r=jkYmHTbNnt8oB5s9!;m~48
z$T{?_x9Q>K5M&bdQD-N^4`e&2_iG-nl?uBCnu2-7t7;W(f&r*Faq}WFqxK}fGayft
z)2xxKu59kD<kX>-q$3x{4Id}%C@T?h4XV#XZE-RCr=F1}H^Y)jtRPPxHA0Uo&r+>O
z0g7T-m&;kfeyy1b(v1=qefXt98L}400}2#KTYOa9QP!$zVVa@l5Y3dB@kZoAmfX;R
zV>upE4WL$a_v6;N{@Q_<D{0O$JZ$sA^n+S)$h^~JqYfLO%0d=uv=4;kn<Eq%M<O-I
zeua4r2`Tbxn7Ghp86hjyuXsXmIbDpPneAjkxg>c2W1j3eW!$A88^N)*fdVT@zQkh3
zD*h+>;mydfvTvZwH$P2qyUz32NAK$g^se~NX6Bn};&&J>)-!r#zd!ES@T-VVcuNTs
z#3gC0WlM5X0whJV-AePkU&L%;{d8M7f7)W0Ay~S2(YrCc*DcM5v;mz_CebG?Xs89k
zw05F#M-qY;kE59naU7lOpeuO=QLnK{-i<-p@Ay#T@|5$}Fj$R~H?NH10z49&!d6^B
z7n)z_l=cXO)^NZr8Dw;KfXn!?50wcGz&ra9b@*Wu5y+`MMSa;Q)WzaIzhKO+lgsA<
ztmylLs$4O^cLMW=H_M;8?{_5F@j7rXnqGDvw!<yYYK}>>?tPW}heo1^k*f(ZXkR-y
z&s+%>H#vA}82FR_f<s;EjOo{|lCX}8SJ1RwF7T6|G5a-nsH;L*Viw8<wJ*prMnj0k
z__9gV@nl$m;~~+%z0v>(62_G4ts@x96YP>D3#@P<E>#f~cVJ~wNclR8P|^=TnxtH0
z!SXNPWDbP}(x}4cl|*h>{AkXKosER(+hLI#U!h1gw-EpNa#Cs03vcWxb6)|ux6snx
z?6YA;_4JOl@3*v+FocRkjV?s`#G<Zg6skfjNr{nAFDVLDNkRO$Rq+D;Nm3`*nBbpV
zEFZN`ai4h?m-7)t%0Hy47bzHqmDB-h2A^$tmCSh#gKX$^r9kq3Y0@3M@BzI@nlhw*
z-x;J1+fegH8%`zx@SZItjibQVAA8ILMTgj7fm>q{Lt)Am#mh`=sS>v82BBS)aD=Pp
z56y9Gct{k#+V=4#Ai|?q1q~N!V(!DfRu2XB3#SdAvc@ILjAo9ZvL44{LX`_S{@}91
zfLN7!wAQV06aYK5yr|AwF1hQ8*Ewn1<!aA^V&xwl{3|#nEIvMYfSF7tck~~sLgGmF
zrEa4kjY)0PZS+QYRDp-TLdWQ=C^dYoDxPCCmuae8#)vJ`c*i#{T)dj3H-SlK!s8PS
z_dTU2b%pza#OlnYB=sd{m%WyHiIPL)&#RJ@*#uP9KZ!T^ef5FTct2$`^Mow{A0p{j
zvIDebva<4B@<lrzaX|<XioPH%cvw3&S)+L*k>{%4<c8kgBRXM&B<GQWsjBoa?8e07
z)488o49Q3EAPH0x-2?T^CA06Cxj^#jx)`d`p|EoRelZt3m34b)!oIup2%hAFRHkvl
z@k2HC8g9uS8a@GFBo5A=2P8#8V_b@}lRUsrdV!;txF+)DNN-;F^k)BIBlKRGH}mAu
zW@W4_gx#7SEz;gdHu8i1lD$Ed4=uIL=y<CHO-C$r%U)zRL@2Wzb(PHtl%^n-{Zu!~
zX{;JnHH}w-t1E*#honmtAB(&OkA(f%k*IAQ0z!6A|BNr<bzt9VIH=6cO16;%u*%Jg
zM2cmEy!BhNjP1?-Ie@>(E%WPGXFcIMpF`Z8vXejimaC6#84x0ML*)wNq|d{d@v1!m
zby#$pb&l6P)aA0emeBo4ba?37pl?(#?p1N&$x@}a$)IVs@2S(xN+5tI-GG8^&y&&n
z&A+pD{IhPB&D{;zMrD{lhNURjPETasrX4R1uGuLkEib<iu=!DiGVM<)$s!PpKaha@
zcmeVueyI4p1eEWKf1-j7V@5GCDG-11+BynDWNGMPgtb;PhK7F$Jnko>=3f#TY9&6!
ze2&2$z}3R(a8k&G6q^`8kSig0ykqA9hf^5A)l7B5PH;+|<jRhAn~NYvb0yXqP^J{s
z(wFoA-m#k`|5B)!y~&TD#~5w%y&%iq&V6=LOUnSVJ^*M7*MSC>14qC6xgA6)^odb+
z!cfr{LF%gp?8;5^x?{Mk<D<`+0{-C+OBr&#T&z+7jyV}!eQ!_8I0HNCqVOWN?|{s)
zzUj2T9mz>Yt0&vvASrI^3q}VHY7l`GoV_y#EF8<Jv<uWFMnM?C3gEC0!TnZ#N~+BP
zb_L6*&F!GC3IUQ*!Bw4IiR&_4e{4K@)Bl{<RynMAxaoH{$clEQnMN0#56tBkaZ!dc
z_F#-rx;ZaZV8k{F0>3~NB0Ubl)E6~1Q=JFOq0Z6T44Kw#3WLy5tGrJ*^95D?mxR(m
zE0S>-2bJ0m-;E(Wn5@XSWW!OlRRWDCRcLhp1%O$TK<9~AWI4mt>f^K$i8Mmm>e&-{
zE=KIM7<r5<0rJXy2z%HTUu5A6_n!2f>Jz!v>+P#6pfhH~uEF9u)Qb`C_Z6W#$yrOb
z??i}Sau93jat+Q&t}qG42(E7Aes*_2m#Z7i#}&C(4Pd4G(7vGts2nLsO-cK05Z@pC
zEfQs7vPJeA(b|qp_uq{$D8QCtCHB!Y=~=D46fj)#H5Z^gh*DREuh2?`K+vw+R>}C$
zR%n>vs4tlj)fF;u+q2R6IKG(`&tV5&(~*NG%!iXnPdh6ACF@j{+M~<eOYFvScAnRv
zzGT|VGb{o)?6K)DmqF-0tp&20kP5Is3Gxp<Ilek=4KX<(UXGq4!8I+L-gs7S&9$!g
zkYcGrgw;d9%D5`Qw}bmXf^m+1G-eQFHHIYw%kZgm$OYQjNa->gq0^vT<dmt51%g4Q
z&D>ifT`DzkCqV)_^<Ljbpro$-;nMyX3tvXLmfLD*7=_qXyhq+3<@DT@S|iC}cOsOM
z+7RM1n}j|U_nwl~^-PsImAtZ|TU=Q9N-E!Ige<mVGwKn3ei8+o<5n+cOgfS!L~Y2#
zBZmb3^l#rbR*8eOsS+V^8qdP~D+TBS#DHpofcpKS$Kx9r0CQ%GhhV`UZm$V(>*;_t
z?%X=Gw?Q~DzH^#b`oxY<OP=}f2RpBPz#xmQ!6%87RCd=>O=scL@~qpi;O&x;(<7Sj
z_1rYs5pajTzTPm~H$)6JQxH5^NRQWJA;k&&xH03VVec6yQgAM<kxTLP^x8vA1358r
z=;(;M@_DYZ-yF6<NhmNi*t;gkuhT!v$Eggz@Ds*oOvGYFlCjO@Kcn3c7#!mMlyR=-
zRMz2`++`ev&t$^2*i%oo$zOztzpPCb<}Vu~^ifG17!hTLBjvKvY8r#woR^CTBpXmF
z<7K5F9IPb0Fy+7Sd^cqDKDqvg2Z<JEis@~GielmlHDUxiRQKx1H9+o?7I3+N)>Zly
zFbO9!{1N&0s`b>i!5KWMewhlKV}y|>tMMcbvWb(=HnL1Z(po8oTFR#YKc9{)O=9NY
zD1awJo$R7)(V-0=pp!o&o`%NU4wGJx=ltqD?$!2{&Du^P69~sB)Jk=M&=N|3Oi*c!
zY`Ot%&<(AGrt5X*p|&Ni<X@y}{1^|uJRf-b!-MK@MRnTw^7H6<pjI6HAD`k|-S0Z}
z6^n&yhJ}c2M-EF0x|#uU#*6Ufu|_VG2~p1wYb0mPDAd^5Q0e72V~aY$;{K$kF%i)#
z02LIWy39j#m^#tZ8?P2q=^N=1zpo>GTw$O-uG-Z&BD*c7!vO1?-c_7C1-ePl&M^NZ
z@sV%Dh(*wq1~%oo%N|$$&$;`_rnx_Pu0Q&7GkswF1nI~y>t#ElK(6*9#$uK>sej#e
z<`2ZEq^EAM&sdme`&eIKG2d+o2>ulmh#=l<MBcOf?ad!<{W_VbF>a54V{Ho+GpZO9
zaAzHB%$GQuL;t#}c3v)y8h(F-P?ezCBiW#90Ou^qX_yY*u8HiYdx47YA<urK?i1T`
zKYoUmpxM3_Iw<}xP3&y=(plwC@HxVFZWwskXA|~V^(1{|Pw_Ltk`ft<eS&?$H)J3}
zhH?tku7?uC$$Cu&7)87M&6IuW^VG$L1%X1$L#yl+rzR{~*oeF40~>~HkP9NOB+JY2
ztxPT;X?H>ES(<}W0z3Xp=1|T(b;$`f9{fb?bpVf`q8S?;`D3jgk9cQ?-~G#k_>ad0
zpaR9ya?fYn05QYxp_78F^0)M)k+9wMYdzg+x=fJe_~J2pEz75!`W!*iTY7&~^ODkB
zSr`xUC;-j2#MtCVK5d3`(<DMl-eJILROfu7|JGZ0xvLH*i9mAfokg4P?Amk}J!`y?
zDi~11Er<R4!}%p5k-~s=VWfU2vsAZ1*R0>%M@u^2iRkvJ$Z!3eq3D99duVFa!VKM4
zTtt=2VgVw8tiWbn9u{zx=3$P<6mxLF8zWLpDsy|F&xIs$s=&&=(%sD1gsB3mPwW@?
z0W<{G-)JN;CjPK6df$c(Sno(3zZ8g9i}vLm4ud~Gpvqr&eim_#c+S8wt-QW8+a#F>
zE&OC*u%p6Gsj=$Q=*uT3E;`ZCQGL?LNPHJ+G}k5M@?k8^>XZH_=rT4(CdTLIGhNLQ
z`~-J{`z=&^-b5=(vC}&jk5p8o?SLAj%@@4)#HJNNLQk=Lch<&^g@FC%PDAa6JP|J^
zSZMpiOprq3QzV+Nx(K88S5XNI<I(0DrYBp}0gZqm!<WP(B)ODoTD!XSLdyV13fFbl
z^IKyY7HuR&6!=6+GAVP@A6~XPutg!j<oRna4*fuEAtO0!h2eX&j6zO@%3iz*ql(Aq
zprI#;&gZ}y28fWF-Nv+4UC6kVG~u7|n8zr~A42Z=nlD<<GQ~&vE`phGdjI{EjSHco
z#0cNXxE0}8zw|CzdCC!}><VMy`y87KFs9r)4PrA0jpDl|?RZ!iHH<K&!^Re)8S3*j
zhDqp33Wpd^oJ)Q$6CKrSpV{0pYyHGM<WgqwjxH+#Q5z_+^66(Op1gk`_(-2}Stkxb
z!)9m$`A0K+i}5%_dWD|bVCwj+J*b@mZsf|QL*$Nme;^iu$PnPM*n>S?oK40@+?U*t
zzI?Bk#)1L50E!au_7e16j8_urA2D4l`QOGA#^hP-YMSlKH6RJY3o91sPXDkB;vm(v
zTG~b~JW^K5r4U<JqA2vuk9f+Xe7~*~t5ij&1Hu%)f)&cJ%jxXs9-}mKCD00o)~yRm
z18&#d+V1(Q;NJD)o6L~40;q|X#(K#@OFs>7qd{iTKBS-~fn5kcl_zZpbdHA>h$RPM
zhAGVabHg-B!$YQbocLrTH1fzsPpgbh&J#}cVkrmM>PiCf&0`32@81ZEV{z705cex9
zo8y#4k#|Rh%$^?I<IOyev2-Y+jv-HUz&#KpU*GN^6Vs$ba3bmyk5G3Qv%r;aCOMn?
zd2{;a#rzyb(4`8xe=S|SH&57on)n8nNcAX-^${><E)A6tYe{z^Vq$;gbZKF2D{Xic
zRTLnAwR$$tkOm&LGhHsoJcr1c8Q3I7Xid7L+ikU}d;Lh!*hfr<r0tAm>(qt~3#xpY
z`ga*dx}*Qe=m0eTrFx!M*~5bE1b!2cDV5MEvukT}Kukems{D+PZZ1$lqBL{qoQg{v
zSdoWv+CjVvCTUjtN)`q(b@W1h)6EKzTep)p+Jsz1?v;PPNn0a!Cz|jd$e}8GPfQ`v
z!deRYNY{)rR_U@y_cuXj8w>?YZv>h~hx1p*m@XbVW3&v=+4kM0@{^DGESiWsG}?#a
zj+!6QJoxL2G70jbu(DNe=(;V8*r5iVSEm`Vmo|>yhpEL?_})!wX;4do?(->kenzh|
zEglV5Vg9fgOSn#X@Dj#m-iOJ!))PzWU?X5(N-s2-T$*wl=2m=>ViWiw(fzYb^jy&#
zRP*+blhO{`KD~w!(B<Z{YHZ;bs22HKq|}8HUmV?x2wtcl9UdJN;bDQ`cYnG*iBjsG
zD3=Fmdd$=m#m-(53`-L>k^jyy3ziqZr8wZCWN($i?z_)3&hV6E6HC76k;S?AKK2)?
zC^`K=9B-KOdI~i-a`&uJi<`uWx_G~Xi5}{8{9ybvoWz=fgq9no*8Ffqb9`)SL}u*I
zVHBft;EZjVy$=KocSUB+SSuoK9eH<c%j{qS6Ec92GM*(D=5P;9Yvk1_Iw+GMPs{Dn
zEHP9OR_u^p>;G6ZHbV+v{DLD>ksJ+oDEv%^GTl^%!?m&7#%$v&m{2N~mV3zVocl-e
zV$E)08eyW|u{O@|LNL4Pedz3z;q|e8$opdQJ>bM850y4<3a4$@UU;i@Z^2okY9_X9
zInWaI#=Ds1KXsqr*t{U&L&)}d(Ganur`4Et)Gk^}a@5fe?SEHtRIR|K@S`?(3dR;G
zQ85L%VQXlZGd3PeRfD^rql`8>*#k8tMD?7JIFlR5&;G=RQvE5bB`R~AQ&zey&)M8N
zEmm^+TeHNfcGz}HDa}l81`7#$k8*O&WVdxLJXe|@VX(6D^?z@B?u;uJ(olj{z7>su
zC#}J{XiIxi)Ox>Qq_!s&`LXCxOJJT0UX{!{smJz^cpN~UvmoD*uOL9MJ&X>=S@LO4
zF}!``sYN>GQOKYinj)}6efP7(#vq?rz<SgKmwnrvxzctR_XC<(9MWLH?mbRTgNTQD
zlf`u#Ep6gcZKa$XDF)RrDWr|{;E^}<mKP>R$0z(tvmmivrvTCX*)a50Puil%3zZx9
zC}pf?tOP5ly5v^a`zReScF^$gfDS>Vh|snQuCA4q$_But2oqTIdM9uYK(A=}%kIqA
zWU6Ym^qE!W#saA+-t2HcC>Z%ILxNZ?of8*M(756UfpyxbWXKf_xmr`}@Q!ues=l3i
zd`2dIZf*su00o8FDgyHR3i_#~yam8aa+NGS-_g<o+P|t0A{F?bQlPlFfpHIeurfdm
zlY^uDvuT%G)JZCdf5uVXi`9N63U}Gth3LiE+2;3=7>|%*;Qs<KK+eB3>EbH^vRD!%
z8azp}Uq^dJIqoBJP!RN8;(y^m{qks;&CwDzBpzX~DvzYDP~1Oh76FOElR5{Rrb!<X
zySjwnM0#YwEqWhNHo9AiS<t>3w-4fvF@7eof?Fh#GzcMlmaC^$4%N3nv%yb*Qre+m
zOpR57XcKI+1X9nd=poXR_~gI}VA7pWp=PGAuhu0X$y59FM|{~NUQYzm=*GF?!fnp2
z)((Y}BQ#t}Mtf(E2%7>oXDMDMFHpLfX22S99VnI|a5XwQ_aN}Je)*kZPo64HYEmrG
z8u3Yp&HG1$G*gi|{SXY|Nvp>tj>h5*JexR(ezb^gl$FISb|d>ZNkR&xFi)}Nm;;71
z;Gmf1O%R{V;{Rc4Qb*#b->^1(NgTwg(}FhHFlHL?*S!l;XZK~<=x9CK?kCV58c<a1
zB*}9=fMdZm=X#lLR1Vim#&t25G6N4Rvezv<DI@1@2vp_1R3{g>@H|y(ETCdqd9|^8
z1u7`r7(XTk`dPjJ2G)Ug6;-F1{b+vym)!KCR6yX(G5J%!ouIwIFqzVV*S9<hFZYG{
zR@PUuRvYCsH_%&3BvOX=ZD*Z#U)uy<6=Sg0{AqE=Pe`aW3D;-gNKkXdw0jbuQ62zT
zCVI)Q-zep>h2!0a>0;YjB?@cm!8IXljZR!dmD2>tN<@_GK`1>0Z_Q;vNx4u}=)CBN
ziwPa99Dh<=X;EOYJ!Hf|TV!XGVFSYz&fzIB(J%*&ihBz*7J32D!+iPn$st7oSYakZ
zEO5d;MuUf7sgad}f&i*^<u(pXDp9B4lp+hPpc#wL6c9i(slc}LNR;wSc-2W~&4@{k
zHxt7F37e8WQDov&f~8SX)7|~oq;v)0;5jr#h@vmz3mp{l0q5#L0jwRs9pZYcVMwJB
zCt*yYqnR7T7?82pd+Pf0Y56LN4NL_x6n1zL4+t$>2jjWVvLHSH4BIz<L|k{_DAS7U
z`=!mpdiyE=Tmb<|Z)@Tn3GSe9<>b|b0A3fI07mknVqp&{Ax0Z&&JY&E#eg&ErHdwv
zw>B(=v+Uy9Vco6<tPh|m0y3dDo{0RHkR45gtkXtU)ey2sh7H;gsOIEL=-@9Cn@tSq
z5gSwmrH&D`7n6w7!juAWtgNvpl!*pkQ3@<{MUwtej)CXj8@FCtrmS)qP6RS=eR=a}
zu7)^cmBNIon!em_aG^lsa3AcCSj1PJ9={BAnLCNk;bz8<emx){V9nn1INT&UUQ2v-
zLSvdIVMnmqd8S;35yKCV{|IO<K6d?+_bDoZDR4WTf{UG`_BP+p06^{{evh8&i*r1{
zHz9KGhdf-6q4LzrEr69gJ%p`q%;{PjQP8>p)c{gO280b~lyn=KI5<fe6sL!j=-&Vt
z-2_s=S-<^A$OsWgMxRf6?7=hUhz^Ha<Q5%(Z0<ftfoM1)cugahIZgJt8J;v@;Syj&
z@93^|IqLWgpNC5^q)`qg!R=|4G5o#lw$4>k0`%M>1JO>uuuzhyVoy9Q-G+`ptjp>h
zo44w;?o6>{>g87d0KaU9htDJdlXSI=ql_e5u-#E`y}U{Y@nzMmFov+-!qy=PBi*~_
znq!TaZ~u6VKmj$~mY3aP`UuT~_JEfWCZba;;EVv;-BYi=%G9O{U6u;pA;~@GLO3UP
zgo>XDyFd=*Z;)kvCP&hf36EFSE^e)O8Pk!OUzl*Lx8q^o`_ufSMG;rAfHJP{7*H%}
zv_t~gAOM_70j?r9>BaQPPp8Hn)2x$82DKGSe@6Lwj8t7@<5__U66x>?N}IpQWTHIQ
z`cF&b>xtF0J2<tRlz!@tVj(DlL42|mt@7rk*e0TR`V?T7$5~N7j=wI{L+Nqme@9VH
z=^(p$m4(!W^01cIsksn~uIQBhNv3k~<FG)d9Y|ckimtP6W?^vA@kOcyd8!ml%BDh0
znYbUFud)>*MjML45y^-WQ)!31em$JWs<Wv3BBC#0;vhzrIbJ|=jb^xZ&ZahD59pv7
z2}qj`fd7O@ZO0XnZ)^r*x+I|&lgFmOH6+gk*#KzRy-oqXo`A5A3TO<Ti1)1-jy(rX
zqHzi$0k39uy>t0kS>&*smKjE9{jdr;I2ZP!3k_;LFtQGLQx}6bWvynfH6MW#_8+lh
z1rrb}PhtBCCvbcS#Km0|4$Yh3iZOdzlg;714m5YeQC9p*wlGXjd?*z1T?4UJ!Tc19
zb{W(8&?&X?6kPhof$EA8-NI!~H*hlY7%eipd53rjJ$;7px-5AOmzNcVOgbDEL)+p7
z!x(0*t|Ee>4@N+SR&BxX_G++9QVv8B5e`-s7AOD|Ee5sgBE%-1r7Vo2Qp&(4H$J<-
zFF&E>-P4#&+jM{|0FS{4a!jD*ZjP128{+qHvoJ1ZL*y3};TacT)BZ)TsSelUdF4N<
z?F)(+%(bq8<WKad=8-oEf@K>ajUARy9&)QFbQ#C;ax=@tIEMf*9}6^VQNakjPbcsA
z=%~tnDTyuWJk-;v`4J$Ru*|kBI@zoTWG%eVf4#j|l-~n1P$QsSL;$8A!9S%=!`9H}
za0x5~2cgdTg9$r5AsStY7$y80DT-dWEgaF-%_mp6C$eCazB$%4D^`17Dy5hV<rD9s
z#At=b;92pe#L8V%??SLdlU__frJerN6(zpftxCon9Mz%;fN4`YkdfMWoh)CWG%kN9
z5bM=^QUvPpCS5mCfGUUGh>v=d=aDRFjsnBzTD*sju)@q~_|wDb@)WxsaENW1K4>-w
zJ}KoiwT13~^-$|Xq{0U~qoGvhC-Y{5Gs*zp(}ZX)NGBG}>dU%*(S|M-3P3F!9fyG_
z*z)9WG#e4i>9Or1{=|WSC4|qyXZMp;cCIT->1WBV=0DG|7PHTAb5jAeYH?bytEr-Z
zat#7~;Xw#LH7GvL0|p3AFqX_Bz<PU|n<SQX5vcgg{sw-ul9-*extS~ka~$-@t7hPp
zc}yUqsv2-IpASlfEJl{F-KJ?n16L@qw1Fj!fPrVk{AM1?4;{;kDn*5dfI=$}MJINB
zhY_{QN(Rz&+Yu0C=|*5ji!^K%3E1d91nC>)pPwq@BjGX5jtGfWRO!V)=PRZG0Ye#}
zUKE|PqCwaV2hYnccj*E^itgl5@Y1EWxGr)oL-iWhAclQFic#`DA@qeyc8R$dS$>c^
zq-x=D-j|HioIsBZMqFV!EclL?*<`5~ZDE=6F$zhx{5s;*c0@EaMBpN(ie;p1h#IIW
z*SnSo0kVxC0?Sy)RPh!83B?BT(N}a<z~tlkU)cO~;mgdbd1OKgr5MkgozTmr9x(g&
z%Zw`ul4Lj-XNiy(QBv}klA$6WeO2AAB~3&bA@FjuuU6@}yho3Sh@~i4?BdXOQYIOx
z#`zGE_#`y||5_Y+HZ36tXocYa@?lnfe1e~XDXul^&JCj`HvOMPjP<px&IY0QcEItY
z@X+^QZD)T=1&erM$U&9V;kK+heKqB(PWi?NS!)28Fbpz_;y_E$DO8jdp1`)3VF+n<
zmgg0ieGM-V9-C&y#Wi(}{JO=J(juIF|6rY1oU1T}Fv56SXj+IX0kEnbf})F#|EY#1
zn44&Uj`T>C2#XC-sQx2MLPSY7Ye0&5jZU(gfiHMVmse9eny}OWE|_ss`HBl+m3WYr
zgNf-bi)Zw8+Y&8s0d?7ao717BRtpn#y2BS7B-DdJbG8m5!toU}12^UvAP~Y4C@oBt
z_VKw-4cI_nE)RK}Zan<9HK)en$NeugoFm$U4`-4B1ya|*xMd>6J87B|5d@+7`LESV
z^sk_GpIYwFB3}gn1!EwRuFBoF7*7HSD^h`BvFw6TxX@rO66y?DWUtl(oK6U_#(fv*
z<}ZntO77Prb--aU{TE1kK@!}ulUcyF3u@6{cheLxLa%MsfsF8e2Ucj~OJ=?n%ThT(
z@WneCLW~cHAwy>~_U)jeR6`SBqX0xMC!8b+k>%m9xbQ-PK1Di5@(V(B9{FUdkdgBU
zR6ww0h*M~bKq8C**wwK8QvL2L->5Q=BO4((Ig*SGqL51*^7&6hJfEaeFh|&$$$*bB
zn#J28P-jL65un5eHG|Ml>GTChl-6hrPS*=AY)dfdkb=S{L6I%;2p`RFN-ZbymsW~n
zpg4pZ2zwbmgz_{S7Cuu738@d`qHYkW62j9$^l>6A<bWt+&n&1w2EV{mEmM!qs^Ax<
zoT@!_&?$gtG{713{M~5!S!5Sx<=*U+%u~leN{0YhF!l*n`!Oh8*gZlz2$Xtcm0|QA
zON*S-!Nw)x7r~0R0Q~f0F_Cu;d7GL<2$b(KdId4On`kTqH^2TE&%Wvor9OnYQvgHA
z-#_XopYBKJX1$gy7q5Ws=grt0W6v~sWYe(bMT)jT#Vlt5p^!MdiCeLo){L)lSmTa&
zcJvx4!}~8!!jLgNl-ryJ71|q%^e}6UYjO}XPK{gOS9-a-bx8sG6qaICIWY$u6bo2M
z`cKq8`V_aA8kqSR#^_hwP0c-JO=H?<@mi_pf|%>ViD%Sw*T$O!qb~@GRw5v!z(^4~
zDO+V>5DQY3ZE(c(d_TTcfGVZwOHI{f<xOGBOr?4fP$>bS(ou7UOymr_hcK>~3$hqA
zsJlPVTAVE+lzT?|$^tW>T*fQPg6DXPJ_C$^%{3HSHRT&@4V?lyizRW*bS}qLA!zwo
zb=>k<xkbfVd`z^>its?_nscSE9;;`<=Gv(>uRE26gV7|L+69YEbcUnxP9`XU`-c#Q
zy}>AzqxiGcwAC61DO)7YRgxJsy~C$M5PO73!il3ZkPaxY`$^n+V>;qxg>{vTc~lj}
zU{rCL6!&94Vc5zkvf`4z`A;M>VE7HA;zWo(*7=*K?t9_lm|lR9N04|fIxsq+T{IN|
zf&MLru8%{Ch%C|87E1`O_n>XtipEGZ8H(~24)8*gmD_3O{wf>7DdLqm)$(Lu_2~vF
zYHvBCo<BGM8FMZ{pDDh<MnggeQ48p=3D&`dK^YOwC}szR8mDlq@tyI2#t%rm_=Vm`
zML6-xDg-6>lR*ebHraLdAz-*bZS@l$#lkLMWEg1pJ2K^weak6X2;+rlDkIEvsOj*`
ztPGBiwg^tv2(%6iTp`=;pQX{iqKu+^<Sn3EO66b|tYULkmG@nk=7~c<xEI^e;>0i`
z<v(JH3j{=%syxvrJRu))PHBc_3dIV0T!XL*DHH-_A5`-yD#=CcJ{%5sRv6+Nju-9t
zvy}7(KYA+)5g=fTx)#zW+aS|GkTxjhQ-mDTdUrHyy<P!`kSI!=oRBmeg~r4&11<E!
zY1X+%;4XR#<gVMWx6|JHl1g$D3X)E3xG|3u3jm%nUzCZWZ6Jot_2fBda%FZlBO>l{
za_YycuGTRZAz?+i3obzpw2O3ATAI#)eLfBH^$W5pzhYC4gkA_qnI;~^fe{ife|57;
zYzKn7nz()A$(=HV!Xhm}u;7q63P8d9qea<E;lqb*JVp{E0+$a!@4nNjK@0LQSq8eH
zB1lY1k)uwiEFdEgFbptJ{1FV%OY%6q=wTUvDc7pZGqS@NvB8cN){Lv(*0JCentg|m
zr&Uw}wl4z^g}F-Tbxr7i{vGq6WttOgQ~(TCLAG#?B49xuzPVPfEH>EywQSv#Ie1Iq
zk|Or<2`8;U#0x|vYZ+n48YbdRYb=@$L_?POJFFrpC^{ebT+YK#5}>zva-F6vbTCqU
z3u5p#4k)$M%qb==Q~*NK7{G4sFkE2{-P>?jbh0ENcQ>RV>O_K&OCCTI0<2_VPK}Jh
zS`r74775h?Bg9V<6^X(Fb|k@|qhJ`MB1S3{E?XfrnVW%}C++Xf;mh)&(B<51J|G(u
zM3B(E6j+@*|2BxxERh(i?3_glJ~R2tc%*He2*r8&2SM3*Yd{K<5+Nv8wb<J?Ph{XM
zMh@KCd=qebWqjoq2GxDy1dQP<O+BHn>bXrD{}PG^a|s5;iDU(;+#tQ&&&Ej+7j_~{
zpab$i28w|oY=yd!{K{?RM&)sESTUv+MBNS=5(QB65LN3-!Q&NuqCj?2TQC&tv(j80
z+%kYd$ovu(s4$5p?vnva4StrRQ3l7sML2`t7Z@=DaiEC~1wxw-*dI=EN6q#@NmD3Z
zaThw^U20ho?SLzwCpT}1ZxDde%oZnTS!4@3>ca}<pMe5}Z$S#e`bLz4aICUXJ52J~
z`feEK`$+#~u{e`0sW$u>0U2zNKqh&LLT0lrx)-Q)XUY9xlM%4alfrTq9*-7VEvfT+
zQQ^WwH&<Q^^hPfHASue%d_4wU`rbjhnTsb5K%Ru3e+p<(kL14gVtH~-o=J-7XQDQ%
z<uDs<)?d$*tEz@`eE3&(pyfkC%9t+XBtyG*7J45dE<7@Il8TRwILn+4g{I5Bmcm@+
zz^vpv-Gg-`UrW?!!2jtaE5zTSChI-vjfcn2mZeMof<y7tZ9&lDkRj^l1YzuO&FR)L
z<=qck;$q5poN>Flh7R7IPcMK~3Ubc|3Tz>O*1}#iAwQEcF+K>I2|Srnufix`i;$h=
z278e4xamMjL`qFLB}M{Myqi|ZnvYBrn0Y2=wY&)pihxe*hL!=s%LQgQ2ne>KQ0oVd
z0Gg-ZqjMzU`cs9F>LW5w{Km2!6gmbV4oaO0n{4JVI8*0bjd=nBem_f3jvRXclU>k7
z4pY({B@+*jmu)SP_Nn6}ofJ|Zf7~KrEaFklgcT&DEHsMpGfQ15d?D;w7iqYngT85I
z{5eEq)X*%?!?T62FLphO%ZNZa&Rc1m<TLF7-#q(lt8E{sBbT$oo?DQ4$jAw-dz@@n
z6Z;U@G6>R6GBQdxT3{6Jv9Mv-VQ>)XzjX~S2@JT8;#0jz2yDszST58KF5u+FhS97`
z7ma&gJyXC$29ei}<Z5A19gCBYw`ctYHb2Qutr`HCxJ&(@?Hw#C#P*vEI0t|9(?r0=
zLI-Yl=m2-(ekrD$8pPied?6pq-LU_RvS{#Pfu1C{pZkBe2oODe5sOkf<=?Y)RAyM$
zFrm)H)H<0}J$1Yw&;sLWJ2i-snQ{6u#vZJiq(%>lQaHkVsW~D@Z6^4Vvg`dbFdR{w
zaUR@M$C7w0T!+f4@{H$!pvZ`nMf%Niyxs?P5^iEW0BBYA8)gTIaPlZ8WsuE`N$*KH
zFoeFF^6m|yHszEC>acYgZULelP%qn}K)kolyJ^4~Ll@E#?$td<cU-t04v9rYv@4J|
z{X^|?F2#D_0iV^DXl0-VrSM!x3V@L^$WsajNgiZV0FYdU2Qb2fl|iqliRKH$mNaf2
zogf^NE?T6dQ;c1YnsRZx#Ur~EtxLb9sGg!}r4p3UQ;jDi^somDa#0fV$Px0ta|yGc
zqL7I4WabroF9QH88diRVefd7O*Q7z<+B~*zdypnFdUlm=-JUvA!KEd}O$#08d~g8t
z@j^S>66J(mpdx0XwBP|tE>8I`D1{ArPL$il`H7v6fQn>uulX0AP!Ih9Y=*tAE*k1{
zCGhzv*%pKExmPAvle^ggwl)apq5&F~?U^308=hL);s3-74Is|y3I>6+E*nxHJ}cB4
zSJLpI&ue-h`mt$yoo!kg0A-v@c0(D9+!gu|2t|zFZF}PcVZKZNd>Av%uO~Y;h__)l
zAc+a|{ys<AKBvOPdld;Amp})_Oj4ujIQVcVnLT+RLXZ#>!i~p#5)`C_;Vp({i>(aS
zbV@0)UfEv)R)DR&V00)%mOS#dRb@d}TY``Y9fI2;Qnd{!@yIO|w3Qg`EauL};)SEp
zEg4qjVK04QbJ#Qk*c2?0x30v;W65clhOu7rsbm94Yi_+1VDK~(1vFgieL(b=tPE`5
zxaMOeAY$m6F}!%L8-Wp`8A;UcfRiB)qAs;dwdQDQZ`7hXF4ATCi7|j06lyY8ti}4~
zs<hi$ff<vqh*V`!B^#5@7$))p3Rv70zq|!5^C&dV;ML?AM8acQxLkgxxvt5Ch+R!+
zGw#ypsJq2*id<|1Y_HuC_03iJ@VG?_!Ed;|faWXwgnoPl>o(Js72tm6=3K_*d@`t}
za{`FT;rZ}Fzw&ardlq&lkfQiACE}Rb%CUneo)Ew$i^n_wfC)XxR+R0NVBIPD0HV^8
zpqg-xgM`EyWA8x*qdu$_j1|Rz>>OEAlp8*aE#?c*2?$LOQ35htvM%x6v~Cj?Ia`=S
z827upiUD#9Fe*-fZ4D)SSf1WzH_{<XOyRA7MC=fmHR&$U?D7GM>$`v>Sz_*vsdNqw
z^Qen9qhv&mU-s?p!nJCMCpQEOFM`0r#6Nr%2Ttav$@VMCZOE3Vu4}P37J+-<nHOpE
zo$x#i6FGGm)a7H-;%6)pZ<TB(mlpc48@dl@VJ}J)LE*xpDX;h`swx2AaxI_1(|Rn%
zt6Jz>mBL-+c;G8|42x>NL3`Y@M9hV9hD$y=X2~N!7u=N-Qe9&ejSO3kJl$t;mp~Kt
zGHBgyP?1-qOm<VM5M;oA8AG#t?kiUT09tBOb0ITLErvX~KYC=x*(>R5XB<mU_MU5y
zO9V-TM*g&QjS=D5?8r%cxm;(5%d`L{*<}C~ghKUxOoY>SxZuW^@Wd2oz`OK91B-R8
zkxcBe1{s@}035)UU^v{N8bfuT#Vjoa$r1`1K<XrULpvBInLse3@1a1H#FfGRkzyYU
zY#4>G*la9GkXRy3?vzBPqrbXz42CXWTs<##xGy6XdzUMzlenhIWCP=ZfU3x3kI4Ir
zVriKO%Lj!jB&uC7qypu<oweFLM#(>BDRfkVW=5Ht+?|1swi$Ify+~#R?Mg`mWy=0E
z24+m-47sWxo1uC>57?Z4eOLfpw}LVfbUXkk6+4J&!57o%fd{;-WP+y-ON^yV!T~vw
z9t$w<=uQJX3bqI))jnifF;J#uSt7$S%SeYjH6$eRndvsNp)$f^)9BtUWw4=;Nwaw9
zdrp35%RvCaZj`)3Pr##Xw%TbU3<(yWm=T1esa=isE^)k+Ig(f#K3m}4azEnWgp{o?
zpDhicM>^D&GSR?-a6~+G-0Co3E;yn3<mxFkWPSn0DR`Q{&0r{+nPv>o6d~@AYYGtc
z@KG9NspyGX%WZHKHxbuAFWdlNyGEtbXV=b)<gxvf%kAr$xF&jbnOQE@X<fLmg_u8-
zabXL9gb<UYjp!bX1h<Cr$K;X(8f8I~2h*7Q1s%{aV)=E3MPa4{7Ul01MPM(hX5C>0
z#r(@F&Pu1uD;fED#{$tI+D;&4(Sl*6_+HzU>F$b#-0Iqu&DS<$J()e7Owy#okQNpI
z&|qKGk*iYm1`f_h1fik5I#5wE*F;(_2oKL{8ibgR5FZ~b9|_QbVu}$I^7b$nwm=5I
zWB9YTcrT<Fr=;{|Xo{ek(iNS&9%|eW;=k#Dtd8%PTMO1juXi#F6iITKAEl`;*(Qdf
zi4`l#g{wF?q!2Yfkk92+;)&#X(Bbx~0R+Sm8fdBAt*=7#q84;0A4xJN6s@~v0k4#(
zodzB|LMR-$%oWMR{7^y~7MEp;`xB&?A&sQeTngY!K~W&+bKkt+koYTS_zk4luAA+d
zA~hn<DnCsyN#YOs?l~E;@M4O4lQ29;<GZF^y@tcUrvt1X^L1;OSl}%Wfvn4fv_5q$
zsZ8M-K$|QQw#mX0Lst<_(`PiS2z;%y5(yL4vWoUZbt$k0CGk2iV!@QyT89{B#4Wgo
z*fetWwWz~p7)%-6;m7PCDaD`94)I{)>=gIzu(qh6onU3y8JZM{ZV*p~CX|01XY53=
zb1yVdB)3+?FGTqem7QQbK(NG<vz$wUk|et^=i#M_Tw_Lo*6Z!*eDp8lw?g=lIjWkP
zAh=<XqQY0ghRsfJEhvZx#p^L1&1fWuwk$p&zO6yVzV?y@vr#<I#lK+<5MvQ*#5KJ_
zv398u-%R@9!&>@#E_0a=NOb9Igx`{~Xe8N_BW(-RdZsOwG?8SWVW)5ioDaBGGhj8}
zGeWvScYqEnt;*a1Drzn8vM;n&<%ufrg`W${UD$3UoiO+(f-0Ce?F@xzYiLNdm!UXT
zhPvp7VnqP{igU{^7nj}9HZdtainm+f0e~gMlavNlvy!yE$b@Uj_M}tur5I?)P@OGb
zZ7;QS6ep)#@Gnwx5RMGijzxdbLxah~p!`I+hAz7&t<U$kMvNW+EdLduD%aZoKRdbT
zii6KLW+l)_rk*FrS3<z#@JJnz;yGoO_lt@a3`h@~-?W#jS#JJ-AmeGeN0p0cxw?ju
z&;f94?;s?MRkU$YVxV*+jf_Kg1Ea9d;hA-2D3)zP_PpRr<-%@x9R0XNY1_HZ=IxPT
zSl~zx`VMm=ZEKT}nyd0TwhW!hPKOQa3)i9uc{&L4<qWtw-A^b~nZqOUnrqPM0_iWA
z?^wXg@ud*R0tGXdT8)W2m^PH$GZDzI4tEQ$p)mbU-d<!4(CJ7JlL<fs2}qRhJu2EV
z6eI)!b5#&3yLd_4K2Hm_68TMHwJRH;+#^<s3X+nvmH*(_$dZF~T9PL+;t;k;(;Z0#
zZABr0pv1I}bgvtdB><MYVr2;so-99?M<VjLNf(qpK;#5o5jAyXQtfaUJeTny8^{(H
z!vP@S`$uI4Xd+ptc1vLiWryY_l-!sAi%8JvG?umhmsIZsg<zmJ)DW@d4`sGPocqn8
zOpJ%3G#HRUAXvum*PUVW1$gqteY;MIy0EH^fZ`vR3k+*NMK<R;BtHxx4ln|g>1bsH
zH!{kw>6<qY%D$xNW7`uSHomvGTaqNEczjSvVl{1g(jr6Yn=%4{9gzaL_N9F>yDdLa
z)WNxw)?mzm4T3ffui_Ng#Ttjh4--dqa@0q%9N}kG3d_ry9V%7<grsK*6*tn6$A3C9
zAFNF-+jH_^6y6OeU{QWO4njy-0*^bL`tSn0B$Fjl+gaV(1WbXfwL=aqhN4Fv?hQMT
z=Ok>YnD9g-EGBFeTE%kzu1PNKRh;5!J-Y*e>c@Bhbp|PdG{36+lFdLUHqbLIC4!qU
z>d^OgH^F7GwYpq9EDk{+E{-7w$tC^6`}0{1ur@y9#@u;QH|6c1M;djPaCj0UA+5l$
zgU~usjSW*kTOJ*T+fx#^c=H1B6v?I7U$AP{nR!U17|&-PNJuVN3(@X2YQz)ohwYxt
zAQHf9D82q=lIR!sW<UV%$W4;k6-<JK%nIkxWC37nG$78_fK#(43<D%KhHE-_9XElo
zy5t%JyyvE{kC>kw)pV<BacYU0CM6hE+1?>5(Q9tr*)9f86Qv}Qfa#B^7m8ltY%M&s
zu-}`6Ms)(M^%yX~Zgs_AqzN0oM9kB1i1%n)dAxaUI)$oR616uqxKp>G#DfBx`N2sI
z2Vjw9dd*;f1GXrNg{D|%A^s=+SfGt&JNKQ66`zA9SIU#fOpshIrZ(2aV2HHiFo8fZ
zbm3n?I0kF+kMb`S3wWwRCYJMH+GK@3xv($h@7Zx86XHpO5-o_8i5!3|)u+fA3`BCd
z8feA!AR6Vc9j;j9XJE<lH%C$($;(%x^J8l<H}lp89WKmMSD|xAz_m!Fx;4RSfpKDH
zQ>i8nCR>z+9%gG!^_cO{YKLqHCN|s?vor-tm5G<?#l{iV1+vTYWYNW(d<8AdK6Ljt
z-K2>G0$e4t(r8*u_CFKhweh}<iR`R#>19V24;x??DQ<M>aM1UBL{Gk}jWGGn1;?NL
z6`ThLooCqdGU^{WT)piy!&v2|)XD*%ie3N&1F2aZ&h|pRP2gUXV+RB@AcZ53`JYN1
z4+Akpwo3CqJx&31AZ3EP&xRSD_-}v<^f*CPIE^*?@JYMKus|dL5E}i{Y5LDziHKR7
zU?5L~&>=((g__SXBc)SmzB0f<5jNlD+rDd#xlFq=z?|q^bvk3Mu%Lwd_&)7KTrxVq
zS{^NxNmdqAifA?x$8S<2e5p!|^_abY$KJ*Mj##+kiu^gu(GhJG`f~@0ErzZj^1;Oj
zY@U9sxu$?;--I}h_!MY^x6Xucab^nu==L;SLV}lz#Kl;EF^`H5CT0sH6&PO?*fBH^
zZVXXTku5%LdG1k&jFEEE3<A>az+|x<6q$uZ*sLnxM_k>EXg6<_Lio+SCr3@;lKlrK
zf~)JKw3s92!<Q>`aA=O&WxF}CvMA~mU{UTF4*T3zr@%@j?FWVf{vQd|gR$TuCDf>o
zbf^y!jF`Mo9;3MoE>4|EBY>H#7gy9pzv5UG&L*aEL9<A=6EoApX7*%U37L~2D@I8W
zp!;q5F78ls6<H1w2r(=h0QZ+0V$)mCwJ#Y<qe`U$(9lD~U_^4<P%(qm>FhzEfN&6z
zq-q|!5Udh=9PExVuqo}vXqnL8W<6-sLrxG3@{1G@ig6s!Yh>#d9TEhQ+QfjsNq`va
zZd^3Lg%*JrRE@7{N>$;IX#O!<d+BxrJOyVBwwNHaUl&%%eBZul5*QFoc-1pa{QCf-
zLX85EwdDHWuK>19?iA@MNFY;%NVcd84>(R>p`_qxVve;xAp#0-G2|@%nMr`(JAbof
zx4%(oZ3855zl9w%$|2WodQm%67&Zg~V{`b?U^1tJCxrbvl)I!lM1q_!woy{Pq$?W9
zgxe>O=Q1*j$Mx$F>}R_3U02QIB)5?be2xViCwQmFHSVBdp?}+7p`>p}i$Rz*WV~^9
z{>nxBAp8;yu*|$<Le16K=7Ru%F(6f|v+|;%T4f8NK52FFUH2pwv;0Md1+ZLdjA=L+
z0mwcxGniWf4rd=eOR@qbS)swoy<t$2S~TYM3P7U%29*zSe?>VyfKaN5zb?8YX~=IZ
z-4%9~acKW`ft&SYhX4wj*<pPik_`shq-!;|wsv~k%kUXcZL0;27J}pGnc@Y6LI@Ip
z*1(;)*Y=wFABKx}7AlTY(DTBi1iY0PesIF4xv`^OWz{c8hB9f3aZF(*_86WmC@WUe
zx2{_bi2=~FH#=p32IwL4;A|e}1SUNxaI#Yho)oG`4Cc(D9W*NlVGIIDqDWu|%Y-PE
zxL^$vtqC>epuwKGEXgmCyeLfe`*>-TgkX?CcB{V7is-<QnEB%f6W+=Xb|%#XL-FuP
z3Jc>|C*s_z(8j_8&>s*>Qb`KsAxw)43(q7$nAWWztby(uG?d4&+W%#=SkTb`=$?F-
zM(E)Nm9l-?BP^7l-7+SQ3YbhH{=v|wNOtoK94Z_6Sw$pMxBoXo35l>%IS7*oOn*Nt
zG`LMKEQ&0S2O;>M**Xb)FYJW*7ibcpOHd)x;hFHk^R~`+8&ObOqA=^kSgfn+t}GjV
zrNkCOmhga0(&qbPo%*AjG}K?Jh*}6MlA6)IGvHBZ%TVC+2nz@Z7iA|0<@rQFaMvxS
z?pKy9fd%FO)(aTsOgl5g@IJS0SKlC=4z7Yxt$tDODjWAt8$rKH+?Cm?pe*K$Lh3Zu
zveYdTaf7i<@^3e4Zp>tIvPnsKJ4rgR0#$u<al}jD;MW;=sBv0KAjntC>O<;T;c=)a
zZc_ZYJs?8!h%u9sXyN7SH$qn9p|+Oxk@Qjq#FVf5pjNO&W_FYlCdK+Q0=W(R|DD2o
z*g{|CKG07|`zD_F<ys8qpGpH|u$(?Xwf?-qbE4+4=dU%p{Ug}na|5;#^yM}ee-S<*
z)uHyF-#wmUKCmw@e2K=zR7R#$p76g*E1~u$9on-dgzH!7WTdMh3i9-rrw}gNxI&jE
zwyM5rwc1WWfs~Q~u=H=7OmCPT70yG5U8YQ`5U$KTLx&Y#tK%tCHW-p~q8l}lmjVtG
zfK()_r2#&Bt!goATK=$=*GlSnl6ye?fSkkc;xGXa0K8_KOi00zG0)zZl7iEO-DC`P
z!AnHQ_zkKim!PvmOV~6z{m6z@gLs?)cxB`sX7=kw&K8w%zz_-sRX%IfQR8=34<)Zz
z`!I9_!XT?B`ithuJ)*+YXCnz6q2OnlF}%sTDw>i&)S=#(?ksXRbDum><{&+?FfL2x
z_#@qjGlkrZjE4iYNO-UY@PfDQ3e!Wg1PqPOk<eHyc}%f=XvRNy_j>nyGa>jjM-yz>
zVmL35PlSOUl!)M@L7uI9zkJ_7*M%%hrZMID?OmX7FE80dJ<)tfnfPL0sV(hwV(_s3
z=k<C^4zJsNi`iFm{J5UiNX7K=ZK#4RJb=f<r3+^q=(KLaDlc4ueMJmc|JbAO7mXW$
zPBF>4cidnlv5X;^(fN0j3tL>1mX9Lwa=~z$%<XMRni~;&{CJBFwI1xCCM0L#ft&qp
zYYa)FWrT8>BrPPwKc*=#GBLzGSOo4MDI~yI?XQ&&4Clvqm6za%WjF|%;3-jB!X=O%
zwrBGAgVSj;eiRcOz#zD+K)4y4b&PeHkhkb6c{ijAal#KeP%v8_k6u$PLRLweXk>9G
zy9Zdf*3t~lDFtqS_6R`f*hj5(Tq154uBv_SXch>tMko?g4ho&ON|d;zc3RVB;~=Q)
z4q5R`JV4h5rQzmpz7CA;CDu75G~l-&EBdUlKaki9x&?Y$_kUa%W^?gKZPk;3<e3FW
zZ?jBX&JN169}(bQT0|m9F-{=_6b}{zK}qL_Egm4(KESyIEfkdd;TYU3UOBlc*@~pL
zr9f!fLj^;3NsMGCGE(6Dl^{+}7}1{*U>5c8fK=Qnc!rKL9LPQAX%>WxG$+U=6%Ja<
zVTdd{_y<Iltt^){*0V$&dhv_=7krBzUig7La#YSDEiEcwf*H6*DxJX8Hp_L{6|*Y1
zBNESz;{5B37;|tgqaXc5b_0f7VN!7f0LkJoeZ>pl<~iodFM`+>#TVP`@tif|MHx^p
z+!0*zKu)b9dV-4gu|hwW1>a1V<b+ivqf#8$2fPzI$Sg2l`bfD=9pr5qe0qc9%@d9Y
z0Ffehu9F2J(a}4=kR*uL`H3<)&NN5_wdzO2NK*kbkHmwo$0?5#hY<u<Z)h5uWdb0j
z1`tGp0Jy1HxyWnoyrCMD4p?F!B?Q)^rG>ySJy@C37LiNoYXpWm5bx3|fm_y2FN@Di
zKYV~n|2qbx8ab*VgDQaG=qzGpE(4hG6Q8M|c#_e0stYJ%MMBeBw^^xcGM})U;!sZY
zXk~b2-y8WE_h*iw0>W6luRl*FH4X5O+}qz3J7VvS;F~%#0zhVPD|98u1zBG~c#!tS
zfR+XNj8UKPTcU>l#aUpXLih#Z*QB9QFzRkTidwp=ol=t^Zf=Wp<J@gB>syF(7XHa$
zLzP^u?Vykq8a8Z!$L+AYtzkSiQ>bVMEAL@8v!H0j%Eo~&t}PQ))f&%1U?f-?+7>x3
zt_)ZlC3{)4FZVC-J79rh2_K*fLt{vW)~FW{n=O#2Iduwd9b}~PaEpi29N{?T)B%`6
z46>^YsPR0JUshrLB6MLE!X}Qhk~edz6uIdEw>vMWK`5YS8;vLZEXFuW{Tg0;PRg=R
z0-sQP^QqXHpsWDZRdanUC3`W%1ZbreFqkBRK^|gW*n6KuE%nw-bIpwmZ9}zA^VNJa
zLSQp;4I<ao{$skY<uKxyB<Iz@bPI4SIbt#;W_-J#+^n?X=p1~+<zh!51Ru!?0i@Fr
zDxg|P(~1RA_O_&p4|@?5tdyLYv!ogjF(QWO0}ke(yf3$!QnSL;iFJQcBPqCv1Qkfa
z0KX%wc?<N$!okk+^#@Gj4?+h~fmlK(%3y)$T}gQ@Bf|vBEm6Hal$Rog8*Gb7AUSV2
z-R(^!f}x?diK2~KFpp!c#$MF$FYJP?a-?LWFXw{+Sry$ws?P2!_&%R?E=|h$s<8x+
zz^lj=@vItd&y2%g@Cgf^fO<UwN+}OB2yqA|MxIaMS`r$_C)2~`hC2+AB2=7_AjBHE
zVv6EN?!=A|Z}(~Q%{=84qj1_b5h)a83`>V8){Vgw;wcm_+Siy$k4?o<)}A0ggcC?A
z{CK6Zoq33EaLtOFD$s>x3>weGiXcPI9Aqmzf$*h!xSUsP3Md+|4hbAQC&)2q5h@IX
z;TZUJSEft}RZXKTU}uR!M1tfrfWXW2(y2<gWVz<_kcmMDD0&NtM9HkhpT(0u1*vj$
zO^1#fI~jq&lC?>a%xJ^XbP!{96qL&{SsC0eC|nwtb%ZkUzs|6lynd>89PrB#BqDu?
z1}{Q#EAP$*1ZE3Ro&uCWpWFUTJ@Mw6nai2Sm*p<1D{KYP8Nm6Nggld;J3b*J1X1AN
z|4+g2_c9p|{2alWsKJt&j7S*r>7*=GZw87^NFs67N>Nd`g|dX9qt<zv8OguFlXrIi
zB8e(BfU8&WI91h>A|8MeX{cu4N&Hg;{7sA?B;1Ydbtg>~vkil*0i_OvUq%AGMQc-_
zK_X;{o09>V7W&9p%gqDoqsn(sbhRLlaqD4JGoUom!lSk$Og6Z`)#fD%M^Pm;h*FDP
zDrrO!y4bbQNU=MEz(_n@j(A*Mut6ZXjrX}@GpeRh0FMtm-CTruC{o+s7ZL~h4UJbF
zG;@5PyT+!>i_b2%Dii^~h<?y`tN_m781q`Q7*pSSpn%0A7dSkOOi@@JBNJ#6fTo95
zVwO@q65o}rDMzCCOdT*6GL$Mv^vl=c_;JGOSQo+!yBKO1ue={uyclA6Sh%BL$ulH}
zm)T_Id7bg3P!m8l1Zh&^IM2Eug&J~{bH?ujSlbdA`9^?2i=;r*l2MpMZikGQ1B)54
zZ@+CSQy8KwJEo6mUd^vn)HjRYyv13rD!ALvbP|~R<bDN9<R`5gm=UnV96AD%b4!6U
zrJ$(P-c|V*k<do@zk$R7fa5hm<Kt`KUo5pb&AvKVBb(c_xtU;>I@Wb}!y=DL4de&-
z@JkAl)i4?n9T-c-$g1Z|dC7XU`c4-l4q&-bn*YO>j!(Pcm_B4UXy}c<k{blJ@V;ZF
z7IwZzO1pa5x9<(kgx5$^u-euEo)grO53A&jrQ|1ZJ>7(yl#Qa<Wqc*(n>=>x1YIFE
zLl0RL*u)}i%<nKP4gD0xAt@a1lhAqyN_gObJ#dZ@Y8+5zvJF7{7;A?rfCoQR2$wYj
z`=iZ>yjjMSXLHfpT!3y=Ab<o0iB)gyD_OEMVOS$1kWddR9w31U5Z{hRlg|~xxnq_%
z%FMKDj}M9}1D;g~FgZYi3Um%pH8jyP<`r`@g2~3f1^I+}$hO*t5S47njof@&t$J|C
z*s#pDC1YYQJ+PKYZ7g=Wj#7=tp;ES=mZ3{@ns)m_6cZ~Sy;wYG2b@Bm;q4*v9PhN?
zgeVe=U9>5CxFdw5)(tKY0f~U#xIh6$EffKCajU&rIa^g(U^0VgJs?Z~$4vEX3Bu?&
zvdLsG<eyCjoLB7rH`Vxb$mzA;66Sdzbd=>Rg^u|N7dj5UN%P_hJXUi(u^}T^$e|eN
z;<VKV3lfwk3}P{c0m$dS7K^w18D1C+wXPT6NZt9X+7KNFjsP^dpVUEkATzvL1Lkuq
zd{|zF1)p%j<`vj!ip?lK2=D#D+{C7}M}Is+PYiVji(8tZ-Xd4q(ES`bshX;^C8rcq
zf)s=h)7k_jZYUr@)ru6Z4qa(0L96(o_*4Rim{;&pr>6ud2oE!{&r|a*F3Ji2mpZaQ
z!GI@i3WT9SbZQ!1t6g%}zTB@|^WV{Mc56#QHXMBSZ#msxfnnU?CV~j47v2+DK`)n0
z(d|C=g3azCSLE5Rnt2&ySyqXcK*Tm1hZRKVdZrer@g(?Kp~+MknWB^xM4X~W6N7|)
z)6L}ftVbRPS##4mZ^wrtGp7Q*4iaKhVW+E5v&%to9>0<1k|MQ+U@!4b?`iW~4UEyd
zJ%aD5NHX0NLItNM`iNb@P*CQ~2&#uEPCHqsxPA|cGF8c(-6Hlh;Fq9i0hkIYxqocW
zoD{CvWK+&ewFv&iX^M~mO7f?#4AP(P0E6x!D1#UqIM#!xlWVs7*W=vRtwvp%kJJM8
zkI(Szj(A76L$qUO?t3&`o%Zc1fNe`520gp8qCU*_)21N@i5)l*Hz?|AqoC!zmEA1?
z1Ly=e@O+5BNyduzNRj$Pkukq<&x5Ojd-BII@JTZG?2xblooet`ga_QJHWVY^nxHTn
zD@`tqF8AgoI*YXbeiWorUts_T5la>>7Zqq*!V|1Qju&J=5Mvg*3R>gDk|07rg5o?Y
z&@Pj8)UR|CQmt%7;mT}?QMumNj}@Cd2!BQ{TWx~g^N*_NILR9gzF-g&jNtk?gOO%K
z1)|A<wzNPu!Wyc7lYrE+ul`hHaexak0pxV4=Nz{Qjh)XKJy^n3tR&;7)U(wva`e!%
zzpPHgK*NB=Fu9^hUvUfl88dT^SD^@ogas8|O*)lXO~^t!4!Pv|2D@X!gO?rbvtEIv
z9+0xMD}wvz!7&@d`WO~qGvR-iV&29?&7ROPVL(l|4hw1g)I*z{n@7INqmLp8L@-`(
z!Wv)9K|?e8>Ai!7IZ=&VUGRcH8Fv5MS3G<h%;T}?)PU$P%&fF}kHy==)QqgqP(uX&
zyW_ZGU}hNpNaQx#m`^ZYi7n6B{G#9J^Al;vxpr3jU1N6FFfYwScVA!K_dhXA68ofk
zR=dV}Dk~V6Q-rtr%+6iW#SVnTxaF|w-hjjr3G9Yb-6uZ<$393&Wt_lL;gkgFoTEZ$
z_Q5D+#AS+H0g7KDFkJ6KyA8{s9yC}uABg(uBsItNcKyT@AOa8|c>tS~KKZeW`|FUT
z`_%9Rc>OTc6e0lZ8Zfx1S8t3+c>4wCQkJp}Z`ws_2nd1_0)#sn1{4RH2v6}+Uj-?{
zc9{eU&6v|ku$U~wjc`l^(zk5AvY2Ge0ZpIm6-DJ3s)Y;w--!IN!G*aQe@~-Ho0>A%
zYS=1Eibv&~U+|#a>wM~o=^V(^msntciqw_Rh%r7i6y&Rb1=LMr^!ZLRl_wajU@jhA
z5*FcDg9W~c&`batC|Lkn0#E|47y=SFjF+1dE(L0}+GcZ(6$}DFS4SLTu%ZaF8}Jc>
zoO5I*!^JH9^I0-H+hTc?k>t4RTS=ln8GwR0v7rp`P+g@PggksQY6^*kR=cpsrb()-
z$ZzOnw?h<xLDp#E<`iTF0MXE@^-lB9z*vnw&O<+#LhVtj_%9vNxwU|&3txo6v;Y<A
zi(;x}0>uSN9k-7nI2l6#S`j?+Hs6WKz!GQKIQ|z$qM!)9*!&(FUJGIaI5Z2-9Yo_6
zF+YZxBnkvTTJ4Q#$a%h4-9q#^iR5sP1(3F8@R|6Nx)I<8#&ias%NvQ<E(S4U%ZdUl
z&pA_c6ka|CN*4n#Vk9sOrvw<5d7}BIE6y?zpctOaS1@7)X~H6wLvj7?au^%ZB}BGi
zp-gX5&IDU=w6`mX;RJCUqQar+(SRF{(eW;YYEjQxk%-ip5$%DdZWxj@0#69Qv!J>5
zB?@AKZV3qrNh%RSfH))h3yZ6<9`~YwX>cpC02pqCzU4g%p#W8QCCaB!%0DyT{kunD
z@IxRd5dG8cB%ivC{el@oX`~o+@gFaWStNM?<t@P|UIR#Q{!D#K_b@s@C1GvfFS|Yw
zjaa1MFb`v{zP>ePP2;oQjxznuvt`fZ6Byzy1|qLyFz*dy29Gc>q2odt5J?m?L$TUX
zDkVV<qzat&eT}qQ62X*9I7c&^q7V?J=DsUXXTVX%^n<_?sc<~$8xJ)aJQBQbFyW@c
z%LWC2(@bbZH-<X@3;T8S9n2(~$l+cE!0W|$Jz$|D{Xd6^N+92cc|W`g=bV26(m2_g
zzKCC*X@n>yveNVoHTCp_0uu7oG8q0}SJS!|KT7esIRQPOB*tZqA>e#2Olw(hWqzND
zAXED_xybmfrMW%CElQ8kQ5(saRqfyvW-qx`ty{aoUQTWf+PbI%R%KJpGJnZF20A8~
z*Fl;CsazvfsiZS;rUcHJ8uXu*?K=Box7X_C!fEEB2eGY8?D@Sx&H+iZpNEi`DOnA+
z!veHDyn89URFg6B+HWcRzy@O?NI1bdDr?wP2Z}&yU&|IF8EhA}qDQP9V@eCu=E3tk
zMiC6E{BZ2-^M~3=_Y<JHT2>^Y4HLa36K~dajGNYDV!C)LM!nS_!+N-IG4`8FBBNC;
zM!5T2FkyzpVCvONQkQ~_<fJzD-zNC%Q2CPkrY`Jd8{}8S5shReK<xJ(fy|T{FKKjo
zCX@S!7~3y1r2)1K7vpl`CrfKF>PM`$dUGs?-HT<%`5c)D7TpflP;xDCc4ab_^Mjn$
z?eT@RRaFivum$;@PFLsT$`}bwbB?e(g`!-yCsNXJEm%|UQ}h?PNv(-wD<?GT<EC{}
zR;Vr+k?9Ss{IZk}ft%Ik0#8v*7S=TSwzw<wmYYiR?wXqdlCKl7jO4hO%WVu0LjHgT
zY4eKhrmxkNbCpW}-<Qeg^kW{KCyDQ_oM{g0MzIC=AQs^5b%~m9;T2&5{_YZHgB0GC
zq*msWVg4%kG9)R4u!-EV1jEJZ?r)EepkcARe5<%XK<{82cYoJ<P6~A{Tv2%)#X6&m
z^}agncP#V97d%9z3sR`TQloh?M5*I$H4I}#3NWDg;GIFbctw&6WbIfmBN=tz)Ln?^
zv=0iV8gyPqm^vRzL)F_9m9@NhScPXW1Pe@8(Sl*T^l@g`1ebmlkie>7g~QRwxO=Q{
z<x<qzTmQ4{4kw$sST8BEZ65%N389#e?+{a&{y(n@74A0aa3UYwGajV#W3c2IAF`PZ
zt}T6>GUpj;eo~UqztIxFE0y9kDlzvI%V&6d!<I)uT$$@ZJ#)Bz&c=Hf04&v-MNsf^
zL^HkTjFQ0;xSosYaH^6B?sGb#BE+k0klSTMQ5_A@mIV@9WK$Cn!bsV=7MK`5U^Qhn
z6X%a%y$1>@kLJ+rkC9NA^&sT(sazwPlNWc1ndsVI>`t0uaDG^XK8q^@Z?AdE95Ap8
zK)H;*e66kf!!#c}lIpYjxfQrHcRC|4t+V^G9))cZ@kyp=me_<{_SQi_kjqMFpa6)j
z5Td355BKY-ORhPWNI3r47Mgh$4Nl-$%5uRcs3|LPnHIwxRwmXt<!KT)SmA~az)!>$
zP76lxKtOmhOU2)YB6Qu?88A#&MiBIAb}1Ou9l-=g6^;EOR^=o+QkiZ+iYC}4QB5OG
zpPOfat}EF=W&?Bx3<)&9<jV^olb2%!B@NiYkl{)wI|1i6MRl+$`H<)`F;UOA#9gfA
zP+5NvnEH==M6MdCV!!d2%0w`vsl~1Xjy=I9nNS}s**~8sy!(J}rsF7>%EovMk4lCY
zGV(4VKuHOpxnf-tG^`QkR@ueqBYxFt)|9+TjFu59h!#n$gp<Q9Q-B`oa*UibE#0rp
zN-fJJd5Ub0?fHgB7&Z*=oF%4@&bG+`jbh0R11`m!d8Lw=9?G>kSjlUPKRzKbPzsZQ
zgH|g;h5-L-6Hhn(5XLi&32W%1i9J8LRLo%fCQqG$9@?@Dqvd^RaF2*rc{;=hTnIQf
zADj!J2vp3hJv_Vx&B{`CNDx58PJtiMS`O)v;XA7sISZ=Npjy>=%}iJ@+ddQmZNu@0
zGWMhsB-~UEHQ&@-s@ARMOwpFER4Gptin;JeSi{IFSW@vUGd0+<RRnf1Iyq;R-j``<
zs(foBR-SXX&lb^y?l3qH=zGZQNV5PLY328wGTd+z4O_Vnpy{$`*2dPRgFrZhRMNza
z(C%U<qFWulqwGK?4x0L*oFIupZku^oE>IK>bidCpPQwXTg3$BV`D~&`h6#;iu*SA6
zEKlPXR9B#OQz_}8b^lta@csQ2<lU8hJk?bKG=I$G@If2^W+9{(s)Pgp05w3$zYm8o
zG7zz<RbUh3Tt|jPge(zsID{2<;3S_bjv|aomB9~y3x(KTkr!EOJG59@<pBf5gnSFy
z>4beamVrS>yzpU;(9E_W=Ik8;f~ANfy3Cb6Q+mQ30kCbSGbMGR5Qk!Ph-V>a_VQC^
z@LYqSHf^s^D5n!hXw1Je=0dc#bW@mI)?r|M<*v(I4$4xv?ZF0OL)xzJx8Ny1=6MGX
zq#cjc*Rlih<_{zR%44+*+@GtQbcUwa6q-ZH`9`A@VxN6T$x1R!vzmk})+LS-y)lpn
z5&@Nw(;$<1E)19v*0jGq2HZr<3i!0w`B<F$Eh*6rK?I4FM`Y*9B5<edF4$TbR|4t!
z(pYzLoX0v=DBz^zRvTS;ZlQ(QOR=)l%9RZ72A>Tt!n~8s3{l`krCF?Mw3H-41~skM
zp%}cIL6C^ZU;2VtQKFDV6BMK=X)tZoG1t|mdi(+RWeh7LaQ?rbxWAd1{rQ7Bj<<aH
z`iO@Y`9T_}sE1WV;*~R%DFsgLG0^wN&yES~O@>s2kFTWoOqt#X>rw+HHl`m%`v&Cf
zhqiZ;^W~)v4@rrbQ&<7w>^;|tRuW`@DpH{`!wG>S^T&~}9)=}bus_e-H2?#w2rN2B
zfy3{C-0Wns;iu!}8!EVs=D^9E?W#dB2@<rLKnB9(;9B@?uJ3}u$zeot*1Ju&m4^r@
zd2p*=B)(m(Tme0LY;vmMtOVZ_2e&3X8Pkz3N~E$Cj}9K0Fwp6)xN5}(9tC!Q%Y1_H
zs9XlEFywtPWc_9*>Hw;l_v4u=-Sy5D+mSCg6%~*CMC6TyfJue=I|NzQI|VY_+=61Q
z@UjAsPZi=&e#vmLm#uNkR{u-D=^+|aU=x)PfrBE$XB={*4SIYNS0^S3Oun;dB{*iQ
z#0COAiP~<Bt#d(?<JGp#Z>!1jz>3$>LgzwEbT5lDMzYYc5QuiNx}B-qx6Erf$!@9<
z$yTJ2B;A+JyW?<&QAuT8K)wP69RJ)xu%CBsgX5UTRjI7*Ypkl6_wz)1X&a6*Q(=)4
zr$E6`s%<eY_tw*5JKLH@Rxo$UiL&5Xl-FbqTP^vt<81HIIqYWdayuh3^sQlk^i9sn
z>`Dbmo0~{SW-JJ%Iy%wu@MtQS8-IRvN>6bJca37bWf~`RO6Pthn!zK2KQ{R=+5|aZ
zV3uxy%=Y-hu?u?_V|Z^Ai<n8Q6$a%AHrt8Jv9K6J`Kb0bc-d<R2i?vcaT$jg<0^A-
zQd`JyHc^CM+ZOO`S~+K#;Ula6`jr6{3k*O1R5>=*Bk?t%2!%p0QAc46-CDAZ$W*NQ
zGjtKFeC-AQ*L3QyB)ts~%wZnI?{Cf^>hdv06iFNH5e^{=1hbNg?L!!q+_`b_e<2j^
zet^5P2QSX-GH5qU_~>I2QMPw2Y>g&J?jTrH<eW<>VlbgLR)V1fslBUXMelpB^0Q}n
zs7SkO%di`ts6il36`mn@6^8&28(&=XP-BW%ICU(reX0VgxxSxi9Hf9Ax_=>P27|*%
zz(yPS<|?c_1EgXAvn9l$`C>jWBMxeg9UCG4g+Q=m+msb$&H<{5sGUg$L2aFgAnIJI
zJz0kJu~QN@i*dW0?n45!BQWwi<K+0>fozOmg+zh@K0(b_#lBs%M8l}AtxMM^LGI<y
zNk{;!n@<8lCjewAG9L<D3g4yb^P*0hgZ$IC$S<hv1RRCW7sQlS4EE1J+O0Nb$CB|Y
z!!Wc-2_x-xGHRzI<;n@Vscca)316dnL3=eO;OvY9gdo;9eWE1LXD&6os1DgwE02c1
z=GGl^q0D{C;F^G9vmmi&_*C7`NDar_02%cGy9JJ}0!SB=*|zs5V2b4=oB*;!Q$`ap
z+cFuqiGZK}IV%H1106gX$ARN;1%n}QRa!Xk2!wOhzwXwjz=u7U3_{C=Fu~y-n}FmF
z7CioI?ByN?VV17f&5o8T0$63mG+R-CLdB96H)t|K?yDdcM>GPvw{g@F21=$X3On4M
zo<QdE`R4}A$S*cRe6*0D7<%_Q1ImnW@JwWFRnXvy50+y%sx_v-z(nA_<OW1l88#c}
zy&yqxl`xcPNkNtexT<S+DjE^fgN5*qb!V@MGbo%13YDL@kVhy#M6`<;`$}wck`A~J
zv})SmN(#WCD|W%a#1h}Px>Saa6JTjbhd3+rp2j=Fk$}QT$jzD--8$rkfYfWQwX6-A
zQr87-##=eC)gluVaCzOkP2Xp^nh1yi#*?9xxQcRI?+;8YzTJk2MQ`zYCNfxIp=Pfn
z)-BLTmhXO)$^Bxi)JB2nPH<b2Fo{<PcIE}T;R$2P5SW3*5>L1S5c0emi{Sn8eKvQI
z0A2Q|iug{>1#IZb`8-wZ2bpuck92|jNi7SYzbpsbp(Tg}^~`en=fkd%5D@B3)eh&J
z_$71}%rgl|7v2w|K^A<OKvBDhp#}Z9Ijd16BZb|h1{pwbWD3L=6UYwlVU^L&H!;hM
zii81}5`wP%lt+;U90m0)L2+ckK%2-QJu&hhOCN6;#j>}rch~ALV;Sh=FIgAFS=6uI
zft4%}P&z2MqkmLlX$Uo%k7Bbos6h}h8d>-qm@uxkPqMMKK`o$bu)Hz!8LUIMb#*HG
zS3{6`j~)w2#p2-V0Qy_b6^In-bndCa*ENSg%SF`V81VZzmjvZkEls9sW3U?_an`LJ
z8O+osy|{9$m+YosffHoSm3TPRn6tY8q$>_fU^Jl7ED-nGAaX@QC#lFJ=8H@OVoU@m
zC@h*X@yr=$98^3}mH^^IV=NcBqrGsbMTh(pdMay1{!Xwpfz_Y#4o)qC!ZV4T93)Tz
z3c{&Bcz>bq>p3-0TDd)#Hd|JcH4p<(?f7#Z4FD)4S}GwATxBU&ued?*zm>{3naP2e
z;c_#vRXTl%5<|$*eBOwRa!RPn)?R3aVo{L)hd)GRa9j+LfVgp>#}Q#grK7*jyAuNt
z4{Q=O3`>P6vUO<n=I=aft;Hc&B1P%_2++TU({QM&J*GQ{@!9-HD;f$J&j3;dC~&=C
zaAlw#w;pBbJ6L$;7Df?$qf4?RNSEF<c^KQOge}aC*rRK74~9O52Gm2qvNuZ5htEhC
zO~aA@CCI_gJAhb(8zJ3c01XG2f6@)IG!51ab@Svxtf!fV7I-9zj$8_br56sE72U-k
zqKExCkYfe$5W-qtIS^&@w4hyIEti?QL9I>E!9SW3sPVf*a&}V?m?Lz<vG<r@=GQck
zPdL9=!s0-&=8SiL!zqqmw{zwA#iV7dlWk(bhhA30ng@qnlYpgc17PO)EJQB%!DDG9
z$#2!7Xf&nrN|L$Ed64%zbJ!=;29#j!1QTx|WDHJ+7DUbHS0m1^$HY<-H@!Nw)q)gb
z%ixV+wlocM4B16ftKN-;v`p%12Y@8Eobi)F>Sdb1gm-coW2Ni}7FmTe^Ff^?@6E-a
z@-6(Kbcs_hi7o*8EUBJeof?4}3(!7+KB~}x1z<>JY{?&JMzYw?u%1`FWO=+4wXpH~
zEFERds3%z%)+d=mz99LiQGfviKyN_|pCMQzexoDp`jPv}Q~G-_Os@NkZL)|Rg^_$y
z7*XITYy1Zo6c=_NLNTn!!m~^-bG&!c@MTbHbMQ2YHCT~^vtvddDUrb3#xldK$e2XH
z8gegt1>IVZpc*>LutJc4B2dU=KAL$Jmmvv--sl`_7^wkai%G|wbKg4JU-)RQ%!7k3
z{DnN`I=^qLoXKlA&u@<1<jDY?_cN%7yAI@3iebfpyaY(OHO3fh7C4BBo&&S_T^_;4
znV{Yf?nKxvZxv^{x}y~OevgK@OEn2WS*xo5NR38b3gvn{1QmN6p49sZPTO;!5fG!I
z^*NtF(0zms-bFu!-e6?-?*^A5P^OSLq|m0KK@n0=_xH<{{61}!fQ2H7jyZ+c)<T<+
zfJ!k5_GevK7+W|Zy##q$f|E3g0j*$>hlEE2)!y3Ohv**vVbN)Tb7|Heu(Q_+F-}kD
z{y3*-HJe*bIW(q)5=aAbhVLH=)sY1#6Wj)uH_CZLJlV7apM=~6<I0uzrk0A*!fN_e
z7#Vr0qesQpUDO0th12lK4X!B{P!6)yBqCyj?YXm_RveSzS3xjTAb$Xn8xScfo>-o1
zJ+93sq=29)s`pI{VUT>|{OB%fdi%^rjV#`i?G&s!^_*1bl+Wupg&<k2TDBsVKUpLv
zf!W$0_#q<rSMf4-O>A`#oo&T#WsoA|084|9)=9$fksz;?GjZdFQ%|$2Z>-zGMNX2A
znGZt2l09}bdKou$8t@V@K{<2rri)l5t_(B=p~T<uJo_4C%wFE?FV9R8=FXrY;BMd9
zJ}Uc}f)8#2(Bc9r3l3pyBAp5X$_<=trT3&PP{cFXhg0-6we*IN7J?9v522;67R~XS
zNMy4xX=GlNkU>_}%Fx7=)TYt!2oZumTfTXfhq|F|76iFSsOLA7c%}k>C#pT_-KH3h
z`#ET&H&;ah3%1vc2?9^NCF9U>Q>VgZ{12}pG2`;)D}w+PCOnk{6s*AFuKS}Kk{)q$
zZF7h>NNNgT!4yUVAfb#Lwf7w#Ik)XXC)_3|3<fo;D3HmO{6vR0K8+7e>dXaj^7UvM
zBwy$-?jd7`{BMDLJyKgSI2Fz~`gP&R?v|{H?N6nNi<}q~HHP26tzc(_)KvuxYfl-r
z)YD;JTZ2aExw~ktuV6{*IiPtk%4UxW9&u~3;*vgjaUA?ENN6<0BV-ym)-^<FPJwr@
z&u87?gl_CaC~etvjNlRP4Gap4NUHv{t^+;C8||RV0Es&Wb5FimiKzl;)HYcrJ0S_8
z1)U11b4$9l9dFciyV|w44iR;0`C5sHM^eHQOh#m(+D~0S(4eD?mdH-@JJjCOn<BjT
z8I(vDV%7ypJYk3QDF-x>P13-~O%m>Lw!xbAEUU6<o)Fj$f|#_OARsh-Faf|G=J2@3
zR*(NYiH_m`p#dPS;0E=Kf3E>bYqXHK=>lRRo1de`;RqsY$JUH4Nb&F`)h^<wv&<)`
zs<h#yoDdLsO%d2NjEm8$0)oxKIGUYBZa?b;k~p=HyRcy)CHku1L_}WT3=t0WT4!a?
z60%-7XN|{JbVx)Bpu>D*3{sv9uaeEgif1t^@om@;a&BcB8JfdER0F6@nXmaoJ7pYd
zpwP%&8+pw>Mz)~;p6Uh+iTPHN7zUm8kFZwmw=01ZDTW~QA861hHc~hvCD9xN0<a$Q
zfDa9=UuVUh@du-BVSAQn@)Y;k-=UZ%<_oIgZk4#H_K>bU`l_8{aEv_~)<qAN#GgU%
zlF#B4!}}%b#92aZ&}THE<K|F%dNMnG9riC{2`*qE3|WoxXJBU$FPmox!tm<N^pd%N
zjAj+iSklbHDq@~{so*MUv;sZiKW`={Nj?>@gR!@hU7-YhPG(g389Awe1`o9qVV@I0
z-XeabL6Gn09qT02ZuU$~PNjn4gCU1cd_D|Bub{xYXz;D*&`&%Z9oqMMpt)X@HclNd
z?qj|#l9H}OYo{ibBh8~uJ!A!qrC%4g;E9K$`gqo4*X$85#W&pgXKe7&gh;En=j6A*
z@tycbJ}6slkO5*!gvshnRQ=;H&6Ox$wi{%Z13A{jKr-md3!=mhLsk=?a-@uH7M<@U
zM(NPJ1Mqt3e{$IF(>d^7J>aA`=3<#$AQ~iKMrM^{fMr1El$?no-VCCfTI_mvOdQ#z
zj6NtSpZ%Apb)6l@AZo5C@DF2(%NVBf7sj`r3z0VIjA1mxP0C~Ab5!nF*=1@cjAEjw
zUMoYbNBhFq=xQ$RLRxXsWwuZpfppsNhuXViX=7SPrVjwOvqS0n{SpBB1e%5!1!?a$
zCqJ7*4~vMMym8}{kQjZL4B>2*1Muw<;WA}p^}58nF&-d4uM{XRQ4A3em{f}l)bg)7
zC7Z|tu?-B89Y0x<dsUpz?Ij>Ov)Dd#@K^f@ob**-ETu2S<5aUmqKR-M^oF38mAH!Z
zU=t3!69uJ(l=-v4;}`<iAhhLNO+t+<J8g*tJw=NIv1z?tL5|k>574129ybuNwJ5QR
z3FhJq01*^&uIpE{oM>D4-;1=bJSJ@fh>5U8I^A^~B*Vr_eK{o^s??_o6S!<fEHfOZ
z@9Y{4xe}PNdPSCO5$>DBu=QNGd;#J^Ftn4rQY0<(Qxc(E;MWaRBXsXm(s(RnQJbTY
z9TGr=z?w|}U`$-3M<QXrHqRVW^OrbIZEVDS5mFIN1&`^|5kGprmxnyiCM4#<e6edo
z<(^wDPO+ja(vzENSmEheFpci%3&2S`ELBxEi0uMjU`P?S4`aXCqcOc5n#i&uChhgc
z!-omS_e-0rOGlkZCr+MK6@}6qiBmAj4!D*AGPvj=;4>=Xf|{<`>;IM%NdkYFZbU&x
z!9ZpzRbZ1y(i$^6u!<35>KLU!WK*-M)`J2^WvEmB(QH8wkA|#WZvQimOu~!_P-_Td
zdZvSNDAjOFz)oG1Bz?#7R`NeoKF8W4W^rJwa|2aHqg%#T*pmOI&;khGVqo=ah<sZQ
z*S_*8N+X#TRH4QYrINJ8h~9oCZ9ua1Sb^ak+^PQcoI>j^q@JJa0<<8x^}}`T9o`?D
zOr%g)ZrTXqIXP~wpvo2(B7zr0CAgHBc#V4Y{5+0n?z1FYfKiAd@8Md5cw<f1lA3%q
zety!xaSd-t-MO-9?F~brj{qUdUWg%a9fCW41u;0k`ZlSz+79AkLtV!`#+g=`g-ivH
z6gKXHi4jF{wn*DuMal0)1nST<_4G9t_@wDTbbpG!mb6F-2%MC*4-#d|5U0Jl90^Jb
zRp$Ldy@!sUHrgV$kgNYNsD#D%*F^0HUf@e$QMEAd(}VAw6EH#^oU}|i8%yap1Z;cW
zapVR$f&K@wfWR9SMp_GZ<l%B3p<4E|3?Bn<b{>6*UG2;VhLza0Xek?e{}C{2_JoOy
z4ljYy?jKm5=s5x?jE$2e(w(#gw^NWD7&6vsRtx>`8vz6Y7rY0|%DS1o;THTO&7gwB
zBBvx_236z-Y8VBWvY+n-fN>}U|A3#5i|bNSDh{G31gZ_v_F@ANXf<$|vXDSl9fFUU
zW&?yh)Ept>a^J8TPV^{Af3I%%8r$`-#=NcMO4<emj1nUd`LY9ypy7eoaTZ}Y?=<8p
zNK-&8S-Bvf95wRGzU_?gSeiZ@+q_A5o<1?3OCEC&;U7wn#EZoai>m6A8t%Nc0Uz?L
zjC`Pm8?cR7jB+H7lJP6R850Zc>;*WD#PHyQHf2PqheXT0<e+5I&$&W^IOSHU$k-C{
zxHb_`A+Ha}PeDfhk-+K2r!0;N!w22CSNQ)K7G<9NaRez+7QRLotZFxyXV2tr68|A!
zkGzbi1F(U^FlQFqtBzYah7tVmf=;b-cLFdwC9HX}Fd$;OsHmH(;6Y_zG0{!6D45;~
zzA%a%flO0@fLHS?rLB|!0A2bp+=75{3u}!YBe(Dfr73GEY3qE_rE<?_mQGjqKL?2H
zm}N1nU7NhV%o_85hgP)(!&tu%ppb=|2VG#FYsj_}!WYabg|-R--CDN;BW@u5&^|#t
zVF3c*)B7$jj!5_KaR|<%XWpvHNu-7s=@PlBgq(tve!tqMa!)E`NJdn<+aztGzh97o
zJJX7K83mGNjA5%;iOIP3*1yJ5n6{=o*ix;0s8S;)5Js&XRLd+BEkYMa3Ue{M0?<j0
z?|t9}aEo|H5SPR7<Zew30p)s!g{Yh>H(%_52yW~NNEZLTb=?O88ge_p%V!rB2u-b|
zXJNx+LwqZjT$W@G-e)7DCt48`p;w3fpslZ|cLbX*<jTm+be?z6Xq#UknL9B<3l5)I
zH)H|JW$U$S<<nK;R<`~W<fH<BbRRP-hpJXXlFZurJzPQW@f-AHIS3rKvdk1+J4xw?
z<B_d0YE6ZdVQ&8Ef1QC{x36@w;QSsI;DM`Lc9Uuvm}$ILYqz?=iCz2t<*|Uw#5{>3
z#jpG|#|`EDs&QWoVo;6xO`ln!Eb;)Eu^ufSZ6nLur6f=ueb;@hin8)(!CLPmwY^QP
za+9x?Vr!M^_MLP%xL6YS?y*T0Q+<IX2y`)4)}#f29$QFEiY5ns4~J#VR-WXLW{rx!
zA3}|}Sy&pwg{1fT{k`m|$j~dwC@4bwek|YU-kGT}3gv6aQOnpSC@~rZ_O{+Xny~<B
zhj?5NXHW&_gGm-f4FtxKdvLTOBw`ilA?nq240r+Ju5~Y)mLN}*YJgsNEXB}bIgmS1
zLO_>5+F{)O2#}DDAf{~{w2jD-2xcCC(nKe)#Zb@(89V@D6=5P?Ys^0wU|`@Z6r1Q9
z96uvQlD%I!kT2`Lg!m0KRos{`Q0xE|fF^J3)DiRd_<ZlstGRe?ao)~wH0e+eNu{4G
zRV<Kj^HYw61<LXa$K2D9QN>=hAAOwneADXjwSHfB;fksIIF@8YN(Zq4QL@bkZtQHm
zp)C7YIFTOd3ku@`XLzH)zvG5;ujM{t6p2LSU~dpg3E9Fc{2Uv$#sbTG35iKTEQz_?
zQ$&h0DV;5MmH08q@5SS>?C4{f3GyH$g4&7s=W045rrnbbf~qOiY&(@jDexe&Iy)mX
z#SI(`E}sp~aqdv-*~1y@KXcbNIu6IpBg0?=?kKA{+XOI)%#M;2Z{mV^V%@BMWwP&E
z@iWEC57DVRO)LrE0j0VnB$f<nb&-F0pGN!~g^EqX^#^Py1Wf-%A7<Xewt${@7JRhr
za%VNexB9v(bc^PHu~cZ_CD|BjoV(%D;`sA3GOmJ=2?xZfvtsw)7DElL`<$j0j$gr}
zcC=CsrZCVs9}`D|Mr@{>c{yIpwJ>Ooh$=9OmyUAPAcF%Ufnyk{YpIJVBv1Y@BZ?DT
zbFQ%Gx@yLS76X6=%RaneMz2IQ8V=Uiy>d42`=1SJvm+qp(ppoYLkp(L*K!98&H|(%
zmliwyj8#7!i3+>v{zQSYAgz<Y<3<T?Q|W(RG>o4s2d<2*%18=Pbe^P4A&J^Rm7cB+
z+RPP<C{Z-^(h34VCMD$0+1P70TD@|Ixlfn2p|5u4$R7nIZHF~F+EIj<8a{bN8v6<q
zUreav@m;M>c1Ga(yzPLrD4VTyECL*%UyzPe#O@N9LxvAPL4FX0A;pIt$#&azo0*O`
zGc10|6zA$F0@MVwR0Gcq2MgGSLO?N%3yeLib02_zbskkr{X(aq)b#L}7wU&%U(MZ5
zF%DGOK~~k{o_YbmaBwRlu@e>z7ZoqsQ;pG)p4q@Z2zle3LCCx$p~HYGvs`|ST)?55
z;4e{!+Rt?M7)LQd2^JG?X<hy4cCGqZpl!^L)*n21li=iRILTaL3cA+jm36tO(r}NB
zf8E}Z=tiX=6`}PS102w0)>SGqus(GFXP3S}1}8Ppf(;l8e7da@`U+>Yb3PJ;07?&x
z)5{WF#=-FgQ5MJyqeW<)0g8;3*{ziI=<Ka^2M)^8bO%-<3^XY(2xg9C4%Gm+LUnap
z_Az!MnILr{hP?7XgfgxWKG7s3U?6G8PYgkT8MG0&&>}Fs+d^RANJiWlD%6}=qvF!L
z9yNJ-t(35D#hq`Li4EKZ1zTCsqT1Yav@kPcvWms)UDj9=47x+~zA>?%t%U<SlT3!R
z;TV>{sci#&8c>>b8C$S^HR#+?)9m+>Cri7=D*5uHl~~x;{0$C0TRSa=I|919_oi%R
zjgM474vHcf{8lhZg)ub0gCC0kV%27co%C6tQvRsGFraD%W-XK}oVMDx6wNsfiq>gh
zycG&Gg;XjcpMsTB<}!+~Xj9@I4si`Mf(~BgjqzaT6lI_+$E%T$QOUromM;gNW}?5k
z^Qg2pRvrK!5~H09&w3&xi==ccDbs5<|MmKVClW;m@q4alkl3{nXp$fDJ`*A*<cv6c
zQmlz>e2^$+&R97WmDxMgGHPH6*d;JV3=A8_qjL-<3>U-~w+NP$GF}NE@&owc+eths
zl_fU1u&E271H)ql!PocY!OQa_?YLE&)G=HRKwBc@CrIk<vuu%Y4}*u+wNqI6rfnr!
z{I6W#?g$BI^eYak0hMg^*iHo+{((h|<mLC+2NE#Rs3?QT8`K*ZjvVR1NZB~#AE_3K
z445>GYPEW*l6^oDQxcQFgXp!;CU^&YN?DQtz#+sEv>C&fcS^cfSCa?cn30Qj=E3n-
z2>~0GgSd)!wqB{t`E&VVXASrsW9AT(N+H!g57R`7&qkbNE}%AGg{3FVWdb9grR;U2
z6jNbvLE9}1-|3{WSCO3fi87nPi}C4l^+SgmlP1h=3gS(LWNkHxmYPhC#}O!gcyQ&Q
z>vUEraxB64UPmB&EAMsii=p)9eq76=s=#juGfp5@*R!QZN1Tk<fI*lL>vR%y)@Zp1
zFD@A&7dEWb7M5A)CIq3rlg+nZFvOoixX`p&sB$JY(pfpuPU5j5(J~{%8lxtmqpi`L
zlTaawVRoDsCvnU0-tsLrng7UE?2UA40CDDX!-JO>TxCBvBTE5tgu_gh1(d*ISm03k
zwuzMxpAy~vEWySL1VzusdUVfSNf=XLjcQ9T5Q$R`)+59`7&N1Qq)}(gm6(J^peaR>
zns0&P>~B%rIenl8Tt=F`{R#e97r@X)Tp)kckJWFbc;LY_;78B+Ch#rKD8g6lVkgtE
zZ3xAv`Jdux`lo3KA5GcS&-*_B>=Yg)0E6^+31q!=wHXi|E}NE>M24L7S@wsofCphG
zr?7+!cYwV;L9`u=W)4e+%!<qQM!U<5a~j+e1IcNy7W!y3C5vx}WR=tbpvRrMe9_ap
z3a$_WZXXc|ID?XTvuS#5F1Sw>jTtRAk=aaTmZZPAAEe>OW-hL7^!xeMH@RoI&j8&4
zt(%0g<Bv85fEB`Td(=K8kWrJLu;yRp$4Q?;r%8rf@1smQPcOm+ze><N@TFM;%$i_h
z1;3hdyd4LD04Ma0g`B6rmGbA5EBk{Z({Plm=jpA<7c>!d#8Cn1j3NtvWSOS;TnBg_
znQp@-H+N##fXrrFC(<eWgI};#z*}_3kY*`H&x#KYP!VGT*kW0SDhiI;iIU`3c03&C
zk)_KZ#?V)^#tQYmN4U{V0gqu$J@<kMb_gNPJ!_0BfacZ7v|7-!?Ux%yE+2f5iqAy@
zcL5=ID(wMX=S9>pKa-Ud4p3Xrp5_vW?LKqUHQWX+V@&>kRW$$_H8~8}KKwFlk+cRs
zfqz!a$UFpAV9DhPunM-{0Kz4JdK};8EIbS0bfr*a4nqp85D(dE=<5U&j3=O914}b-
zoa0?TebDCRO#B5R>Z8h1dEKab8@NUFk4(PON5M5O3bicm?HgoDal@h145Lr}x3G_n
z+xrlA2RGy$x&E>vM>Nd|%Spd*^;G_Es<7<0^AD$&TZk!=+#ImC8cbY}+nu4H8?|y=
zD{<TS+CVX=QY#QbGuL4&jVv$-#h6OrjSoc5+w)`(d9y**<f5Mo3SflvzmS4A@TQQX
z(bbNKMgapxo=?z8iVUEvpkQq3T6=hwsA-51i@9*>G8kbFw%ai@8UO^0rIAYtCX;l>
znnid?IB+@<)fYl;j?Hu66tG{3hlALiVJ370c-}TV^j6_)R8-0Tk1z{#=>V%q7g`9I
z539w&=&KRaY$~E&huX`tt~MLCrs*Qle8xlhPtL3MyST_wt*eOyww!#MQQ&0#*|!g_
zUV&dt%Tv4d;g*OvAyY5}OI;I73sU+jxo^HagFY@u7%B`|<m-l}v)o_2YX~#31}oQ#
zqAzU`D=Q2vtSHK_w<}}KR(M`lNNHn*U8mxS5e>UMN)RU8S0ny3QOze#a7tJw;nPII
zLv)PfQYcJmNOyPOp(SubPM07R^R?AL*jAd5ms=`On<ju%R0Zi;?fvn&m~ngxLvcg-
zM)lMa)qqT5-f`i!93lv)ADl|IXwk(lsI0&cDcNPS1t}+mSsX@Gy2hub1Supm*B=Li
z`ER$CR1LC44d)EcU2|yMfsi5GK_k{ZqDcfaK`tJt5oIx!o53==1cPQuMl=w#!m>xB
zqvn;4v>y%?P6Jyy+@RD)Q;{4e4ThJ*lr$0tfXGrro&kDmJQ?s|wI)Ql5&ZG)TVD$t
z4=Cklei8%Vu^`gZ<37lc%L<@$6B~d>)UjIwQWQN)4<YZ_6lc|U<ufg?#nEFkmj=<{
zWXgp~cKT6_W9ay6vdf+sMO{)H0Hrv&N8J^DGpuL>VbelGj|~!Efsm({J2i1M73;G0
zS6qxC3>+N0v>_Qe45Bj6hq2jfF58kOR#(+lK_=v~U`iR$1r)&WvTO8P7A;??w@-*^
z($3aMU3N*Dd+Sc=RxHE|z&sdhV1>@sn8bPG0twdxtME2Oexx0AaCQ`9(oNwgvXe^z
z9SF>FM5VHTk>!Dep(%e<ik{zsRMADjs()fLMJ^<m2kjbIk59zN{f$NE5y<Dpaehfh
z8_*c=j|v@D0;YK%Ks`cgWTTgrofi1r0T$5ERFOFV{VoA-b~|H(C+V9TD|5WE!3+G=
z$kR4}ZfvjPB2-tna;J(B;mR&Dz<IBgjFL>pu{;UjD_%#q_6LM`0pnH-aNw`d>j1rf
z&rD@^gri5rTKyF6z;zu(ollRE_B^A`>vJJJff@48Nb7bcO*!z8#@!ZmJ~~HO;)EZR
z<(8C(ADfLEOV_-@P)^f|yI3)dOJs<})LZg@Tz0ZRM=W6wD2grZ(at%6!CQ+SaHSRa
z>B05l;pP7&a-V#j9Mr&d8Z!i0h6gG$BP1SfvszZfX~55{2#MAfWX~u~O1CN^P54xV
z&!6Z743m@$+2P%%%KsV7$kv;U*#OhRuR@R-3D=ez31A<RB{vkIMYq94u^j{6&L9oj
zQZQut<uV^ZlvD(lvXKD*HnEi6qJ1QtXWsRwbv&~#xJ@*J#*Y$#9r1nez(RN``yJb^
z)lu+!4*N{r&$nr5j5<m)-cf|enoaJ;gEX*;`?-aZ!`Uz0?lEHFM%O>m@+h%h;i)js
z49XSnbFIh_dBVU7S$)k-WfR}4rkJyp%X20{E9IIdyacBwKpZXyPb05|(_;r8vO@_b
z?Ol2Z8?38fh{zCxpgI-8A|{;O{vDt$CBRu6!9AO{gujd$*^z(=dd0aM^1-Q$FoiLr
z&Jj!b?1BSuaPU@V5X);*orRV*&WZpgHvB8=6=I$R0kla~*kgbS#~!Q>t1jbBsLmRu
z@b{!}wIdHQpaIh%pn00=yrVM%-M1g;yOkeA9~e`G|0n_gWAE3PEX&eV{&INgL#aOf
z>2=VPs=-gfGBD0KkkE-`jTEQXSA9w_yliWT$Fg;pk#;8J777VT*aKf`t`LV?pV}3U
z@?q6+=uL5_GBz|W;%TtaQ$QENONE{u%-UXq-oL-o>=&n?hI8DE(uYO1&Qxv<zt``H
z!yP2*HF`!|=rpsb`<iFVm5G!}{Zzw8hCbk{h732q|HzW1+2$ixR%|N<7LdkqquOMN
zG|7kBif|N<z5ZUY`UlFB%xr7Asdu6sC~<YJkvUdV^E{w3FZ%ef2U3s7J(%y?dN`|Q
zIVe71?&*@2JTL4ANrr8FDj(|5SfElkO|$P`zI{H4xk(+->%~kU3+KCCP|z_k&7%%8
zQvuXAjMuFl!#CrV-9)=0rcb%_Ya#LNA;b|T&Jkv)l!|~>rqCwJngoz~E&(4T1Y6A?
z0;@<Fr}yBia>94QAps3<4J4v*v_^6E6M5Vr+NdVy)Of^}<){Misx*P-&=nzETu#gZ
zRg%pm2j?i}UB%Cxz=76enl51Hd<hZ~A~(XPW@!Q}qusHWMuXnwO^3d#51E5#_YEYm
ze@Sw)((ZxF{-+f3c_O$13$HUEM=kpljv6O~Xe=_6nTqCZbs*TmZZS+)A3!}phZ0lT
z!ZO-n`Jyp!7ihOiw{x%_8BE~KZo=|o7Al|W4=hO6hL-S-crUBenhL3DoXM%HIG{Er
zSRveKX^j|}-9w=uT!7gCpa~mn-nY)61z=E*CKi<UdE<=gAkZX$pi4cHNxcjxWr1^f
z4K@OldYCC$lJ+$f_H!9rqseKM11DUqC={I4RC1^x-Ip=qb`*d-79w#9{nztkGOW_6
zL331aka)kaWFebglyp_oNMl9-^5f7{%)%0jmCqi5^*3f=m0OclzEXs~I2_7aZzSl)
z4_(_34{51@uELmrjY9livtqag{?g=K^{z%Rdd$0ReXP**O>BbJV5_WX7bx9Q{lTh2
zk)r{6L7z%oRQnp#24s4Pb@!sR7iw!=s$w<l7j7>aM23=m4Lt#0Dr{u+Nvim~Y%P4W
zHn<nM<ikh+k~JqS619-G?NKLp$f8cQ2*B(k8BC7T^l#e~24EM+&<=U%{K1bw#2LZ}
zr^ql~AoLta>QFu@^Jr?^U)6iuJBFlk9$VY)A`TZ&3Sui;9xvx$;$>y@F%MY=0<G_R
zQf@{Vz6cpo1F67eL2v|T4lfW^0Ibzejgs1=zP`9=>6KzhqryVGZAmx@SV#{}1F1i&
zK?$sJ!+$;sM}n(JYz9NaY07LcIp!sj1nFdes8AQ!_?~?V(+ljIXym2v(w{Q5eSeo9
zdvCd+Q$ms+{7urVEY|C>Wh63m#1Z{IvLvz=D2d#Y+<95&IVAg(6WhL(5v;@{A1)z_
zS)Ow(k_m5gNSx+eNs#%)STuDaazE+^sfNg2?coUz9YjRvODvO8kcgVf;24c?ksYic
zTiEkNl^@oapHYftC9AmM&C1#zDVo3`7LPd@59lG`c>~!jc^VSpDAmj&^aH$?hTSRm
z<Fy*Hz3$!?-D5l;tUpj~#1tP&0`yR1lNKhb+818!oy8&>wXsv^R#n8Zl$w^rb0co>
zWUw;B(TM+PaRwg>SpbFw{OkSF_<-pH1^_wEBGe-n9?yGB?_r6&0yy!H=?~1q!>EGB
z-aSOvvekfQ4S)GXq?IAbUd+i46+UOZj^T#IDt2-LjbLHVAZ{;bG$SJmLOVhOMVUXi
zf!4w|I;j%0fyJNW7ASmhe@&x~i>w%VvARUFCsEK2Z5t#;7@|+#8vY9CA^yrMI8#kH
z(?#ioug~g-DrN(~(5=W|nHi}vEoGm_Vd^I5wx~WKe=0?zOov*Qr$BMw&rPs)OPgTi
zZdYxL(JcNJm6s~cAZ;dUeXt2Z0^&C+xD1|wwVnyGPz>wbP@Div7eWA6@Nu|!Tm1E4
zXv;7VX~=x$n(-rR=ls9sgwLCZxNK*fkUZr?UR4>@^kfF?gslsJ<TfSD%{`tjV+;6b
zH2Pt-oO4$6!4qQSs#TGYp`K|cc+KJ=DItp7Y^tS|=A_?~SzlDv1*l#uPvvMrb9O7#
z?#{B;^T0Dy12t)T`!$RxZUZFPXa;L5jnF|!E(0gv#%jk!d@^Uch)X#SE?NT4I6aev
z=F7O=&()H;)QTbTpvDYQ0IQ3jC<B@_%P3QjI$@mk8p(tNA)}6d9OZIN#anYd|3Omd
zPAI|_9~kBBSCKLyEi59J)6)Gb4fhY*@gnB)Gp=;?nnP)4E^==e=Qr?RuC7qb#!5pa
zfr+U=>N)|1loxIbSG+4Mp*C$mYth>TvH;3ZZ0#%q$<2O!0Ljbq1Fk3bNGO)!n6YRe
zOH5TuXniQV59Bxp^Tg5um;{Gunor{cA!67P0-1|JLCC<$h?tE5qZ_L_m~B%6{}WA@
zL}yi+y%tOtM~4=&FpiQXuL;z22N}^y8r3+W$yaE+VkC~lYIGX{)8AlwPeaYT^ek-H
zJZ2_u)>{F;l?Y<~ce2efjNTgk=4E~p>e)iHN+R-cBGq)O@fI1f<CI8hfIipw%o!r7
z4|hCdv@5_x$l|XHXaFC};Uzr7i?#-k2{p&$Tt?~zdqFs8FKXBBUGeXimcd@HRv#M_
z$?7Epg|XtQj&vsyaU7fSf1#|El4KkL@->X`M*4!-=zMA(!M7qCs$C*vH5NP=sj~$u
z{UDA}zzP*Gh0FlQVcsPGg8Uj2wE!9BMig*4zc?&6SY4^zn21^Rj1l6zp87*ac5Q&0
zSChB|>%W~ttcVjQGADJ%5}FNt7%vwLoL0b=<}6B#Rm%h)%HN$iht5e1F4U9a*LvF`
z3~(8ORA1mpPFW-p-hoYFmZN5=ay$izn><)C=x4=g3-1NQn&pzcgTDLmS6cm|864C2
zX$@lI-}<uPb+Iy2E(qa0lj#jD1LIf?imt&yG&!K|IKJ$HRgqrw1cpbDMU6YFN!^$d
zm-BH@s5N6fvbRVHMP-=_r{r2F*=m(ExHtRnodh=td{pjp$vb(*lDJ8_3(LILp5<XA
z;&V5Dk9GPTJkscBz#-UjdZ9Bv^JHugBu+snbPx$El29QR%};X-#c-`8N%fedn$}?o
zC_?0h0EW~9N-|n5bRNP(*x}GbzmK!tO(;Nco+1Y6_QA@JHW)2hWC=*|CK?qif@Q>{
zz#Jqd$Ms3(;!FczP=+nC-tgo8_i^)#NEP_X$e?QB&)9v1X_oJ(0_D66f^RTXqYs3p
ziOE=Z=WA7sl!4Y#Mb}vawI9=p{_7D^K&q7vI1ujNV%rnwN;?(V=!8E1S|iPDw-7{0
zP?Fw=WJ{}hVT=LrK~c!`kT5;lxrB3+q<2(5pRSl&@Lm<tAaav_`)3*m9qYTSdj8YG
z=naybzRY>%LW0)NR$X8PKM|qv4xtJY`5Nd0Mnx4dhzx=#O3}#m9#0hG(7kZ0C$o<*
zRlc?q$4T?^>whL|Hz+HOf#*jP@->8k{tnVScsrX=5VQubAlqo+8ep2HH9cA&yP%@3
zSE(q|<|pFnc(QRJF4NyTno(W?cX0C_s)(Fhf}Rt}2UDCR^w6Ns8hlL(s-@DjsLr5a
z6@bN(BRR>VEhDCQQ_Pj9t=XYnSh-JZHZGFN2`K`1hS+?S9airR=eKgf@E!Xw8G{$e
zk~^8L>zFYZyoxI0qX{i*=Gb8t>l`qkD$xFT=)hsE8x?k(F}5KPBcluL-9&!{fw2st
zwGYyYcinq+J0lNy7=;}+F#NT!c_Db(C9Oo59Dxo=RgBe3g&a*mao|ZcL^CF5lo01s
z5^#FqF(?HFWp#`xJqhczP^lVw8TY9M2zT&&ia!~zQOT^omAbsxqt;w88q1NOgzWa9
zxaNq78#=+jG$3FOtVk#;ZbTb{S})e7rW8SrHBE|a0gdq{&0so=Fc(qfhJGWEOYjWg
zLrg~vS}pMJmH;8g_~f$vRy~vBdlPY7j<AWl>{B#R*FlrhNk%H%j6?Q~BMUC!ONa1;
zv+yzYD|%87m2%X$dsW=JyVM_*;3yHYlKRaSjE@=l`&EBuw^GhvvAX5|fqx{{P;*s!
zqnb)HP*v1fk>zxww1_rPZaqb%QsWXCdAre|Lr*7Z3r=xF&o<I66`5_1GO>FTFV1=_
zP{=!R$AH32RKGjQt_t2|tm-CR9u_N9R`5-I_vcQNNQODri8-mOOWV{!nQIEHN=c}`
zNvNKyC-oGVoQ1NI2emB1Ab>Nzwa^vnZ<MhTd|hdEVP2J@b?Ocz5CGIhl8M($^rW^P
zwi*Ft7xJ$;wSgLFZg35jPB2Kn8aF>V3&6AyrP~@FSkZ7Zvx9Z>W<6XtDK&)tcz-E7
zFWT!Z7$H|c1b9p>yk4X6L$T1UL*b8oP=0Oy2JGXV#yLGfB>iQVlGoq}&;=02`+zIF
z9i_iOU0v5I@n|VC`VHh^^Ms8d0!Ay->IvVWeBs?yHE+_5SIXSUWWj5`q5DweLx4IZ
z*Wd}VH#Q}l$FjL^0J=DqboWqChQr|xA3m3mW)uejGBy;brz1G=;3O<MAaIhU&69pQ
z?=$y>K817SD-J-IR#_1WnFWWJBW6wwR@iLc7j$@J<n9|)eK8c$LI9!~ghCC8+Y!uL
zBAyH}lzAVg@9%AzH+;O$RH2$!BCi%~Jal1^5~%xl4)bD>keZ)YcTAHg_ut1x6HsX7
z@9Y*=!j0_FJ&BtLn%>Mcjt<5T8A!a3+F&r@bm9UrW+4o51rA_sUdjp#1C*+6$q-BN
zz>Kcsi7Mwk6aYoM6lfU%1Q(@+oz}NaHgRL=j=396UCOZAbGUUX^GMKy06*fA8jYe$
zWHsrssWD!c>RFacvBriV%|RpTpwW6C3e>aMF^R<B9NxlhC<gbfpT0vHqABkEU|Wd!
zd*!v0Wtu<CsfA(;GCFzkX3-^<+pn%3rt1)E=b;QlI_xIKmVIK34msul8vs)5<jbgn
z>yRo>PjHK&;kp~?hx6?fGU8kS4Fo1+s+Am4R4PakzYo0CL&l3<G6^0uEu4@}NN}()
zpd<;0vnKYEA<lq*CS-^zfDRb)m+i$%5Nytm&C$Ntf&$3K7Vr`EkQ?D;4;|1LD*1o+
zgC4h9lJQgYqO=!oyC)oJNGcdH4^EVt5>AAj^I`m5Quf{ukC)2i!qZ_il!HO2nuJiJ
z+Oq)B)E*i|qRgI0Ol(YqQb3B7SkMWJ`eG}MuaH9->aLEsNh<%t4FRg!0^2oqr*WgB
z$BjeO5SV?Dv!?Hm3OTm64LgK#(&x)GaCks-XKEkt0|%aV0ED#cA<P#ht7x*hu<!;k
ze?tm}T{<jNnM`n$f;K)dMvM1*pMipy>rQP0FvNr9q*T54xT{fn?GaoUE}RMpKk9{D
zaq@*PELdG~>T&Xy-5T2HxbA|f+!~ADHc09(RF+{w2X@n`-!gs`^LzevCpBZo3JH!D
zq-AiZQX&rymDozbI0S3bSp!#|c7Lg>DQzii*m|@l0p2ckORF-DkH%8GsdgkZb?w3#
zcUn=zz-QX^!i2(>HTX(Wr2;THX8(|Seemq1)d)42JcH(Oxn~HEaV&&$b$8Zh)OVkX
zce1XQyzS%FUxbu7P>oy$UvT!xK{Q}<!?bAwBL}fXM{S-v$@uqUehzH|YvSV=M%_eB
znW{H6RvOJSh^50GB-W=!unc&NgDh{Or<BtRKx<t^K5HS3Jq)^-V+Q9ODAn4DsMk>J
zdlWdw0gIfm9DhnCMnm~Nq{0^DQ3#BEJ$!@d&s>s+5qUrh6t0cm2$ErP41%fz`2yiT
zqjEk70W9PNV~!m_Hl3ut36QP~kU-)JT(44mCj-s?($$QOjmN{-ksf9q@j9b&#mRbU
z1iC3Jb+<Mt8wCn9a&<Oyl)u}N3RXyDR@Qfq@zg;f!bVOcpoauighaUB;_NyDiG`9z
zv>}ET(>W;sRe9qHV#)dUV?PKLja>*d!z7K|o#95`*?h@7olBbHHjO3?`Am;n{y=i2
zv^f#-AF_<$;vf+KBE)Y=RxAH%<I57ckMM<p&ngp0{9B%lrL0v}+49B}0S!_@m#iCq
zbRICjB<$^gsTYQiT48VG(nZIiGBa+9Hvd#I_x2gcI6bc~fJpQND1$I^34}}C4UcH0
zS4fD4>$MY$J2<z+hx#)jYDnLMh5tdBA2g5Va})`6IQ%g$lK9`5GS=I}gU0?GN1a1a
z=nv?<-F0{uq`D>zoBEnRFQXm+JDB)~fi#{TLW><I57>|;_0>&8J+JTtet|VP#@Q&f
zGS5zrsbK)3Gf36J&wa0DLgd`4V80B(1<_d?*h=sGW18E<F+i%|2<71_3YfVl<=9()
zkgH4hg(&k5Dwx5EI^Xq_n>c@n2@c(y#&wv!0@|<k9ISw~w`<8cLm6HN%}$O?c0rPy
zDLI)<Nb6^gXls1OpqMQu8hK0nCoOz)TtpcY@?Vx#Gq?U>2?T-&H)F@ANc!@a`WgN#
zT_FI8;ZjooDk55`I>jf94^Y691yO{-K<JW_02yi9dg>;us4q2XaUDhSq+aqIZz0LA
z5lsy8j@SK$J_XOCbR@PO6j+I5II;Vd5{uY)NE|UM)yCW^X0cQ7s&AI_uT!i<duc*e
zhbmHJ(eDLf@fNtiuL=gSHx>Kw<H0K>$c2S_o%JYM4-?smyGSb$e5a$r&WZ|WTwAQ7
zK4h-VJ#85rnp9cAP|EEn!X`=+hk1%h#YvEs<0mchQa#(&)y=mI9iz!WXGFgr%ED$d
zc(giqqi>I!CkVj512ZaNdEaik2zvsy9+|{<yxa6cBS)GpW$|mLMcv}ItE`Mra5$Gy
zyv!8!w8DW`+`#qfx}xI1$P@&Vq<6;$WvCICU4=!Y64p^74e@h7-h_5PfvS)bfTg1s
z1}sa4N0_2+qXBu0<n8u8Q}AFGD3aJQW2qPCZ?!waevTBN^ic)EYJ)`sZKhq@Tuac4
z6)+tV7J{zkHfX@i;iHUI22)hItOtB@=u=IKMp0(?XgYlC2B`o<AMd&pCf-4Mm{Xt9
zCYZGbQ7Ma6<EbC_z3cPK<$%=vEKKECvtD!xqCb+HQh<rwE>?mdPg=*y6UO1YYSc~~
zMHE<8Y&Iwnv4{VmC;_SLND3mly1;8nrg7*XgA6b)c}0)>+EqM=aXk+7wde9E;7`=3
zIDaP?NFu0GdiW_;;-|<5j)&8j5~wY<yUK4uPU$Mfj`60xiYB%5@k%jt%Laly1ybO`
zz`!+9p~7^#2hgCn;RcER(b_}SL`B{L0@&fu_S-1`Ho#2oKOD%Iz4K=3Pz8DP^dkq5
z7alAGoG|(H0be;D!>4lr!i{4%vB{yI;}09R0L!s?brBsiD0FD`n~7}mELwwUD45V*
zR=)*{(`tHnQi^hAa_tBmUc-j~i%<~!dH@Vh1~-Wf9RL+@ENL7Cw1}knAjYB)qsc@^
zoId#x$Z0MY?T&zf>RHRkq)O}(g!mw^?LSWmfnJ=7BeK0#6sAR?TK(g~rQxCS9b2c+
z(u`DMm%|Jc+j0?HhkwP`lf;fzVmbp*V_^x8g}{Lm5!^gTPAA_8pRcRcFEQmKhiqMu
zJ*H3|4FHh^i^4ui!eow|FT-#zivV~ef%)kKsg8F3g(~@^3ppNbS`f`dGoCCV8%TsZ
z<tYOz;iiq2Tj5lmOFd%Hp23;_fZ!b66;hJd7GrfNNKUFY)g<7el1y+a53jwj2Ix$J
zw<=M=%mCQNd2ng~gQ(NF(O`nmopn@dF@nzW2BBvZ#JBojbM$lwg(E+Vz_CJM%Ooe`
z2m$^!AVmFZG-vTPL#_UF5+ibU#nwqwssjWBbV#XK#f91R^3{2j+_4;bxY^hmg@DM|
z(4qlo6Og)I0Vr}0f>XS-R9MZzx;TJWeRx!MN0h+o3Y{~d^31x1*mxw|@#AP+C<I0n
zd>~{nM7!~}V9~;j5D8(*2B!*870GjPz~Qeo%~UoVAVYp^k{@5c{1^$jdl`Sqm$$lG
zR&OgRwyiq+Ne8f)QkSV_$lDF&8qqucW%h<ZOH4}$#8a75m<^UGQ1#rAZozn*i_4I(
z`S2htiRFoQk*n2r2-3+GQ&*S2&sioXX)g$zsOqe!omqvLkak8<Yl^>22qN4?Mdi|o
z@dM3$frMNnEsv$)!s7@#4ce*~fi4enOOT>!6`Q&n`JGE1!22XXHL{+{uo)o<G5Lf_
z60%IBqnw`Dgu>>Ok|S{qsM>s*vTp{F!<#!hhY|#cq>4zAbc*vF@G$g?R^g5aEzm~~
zq>F!f0|jIl9%P(IZKr;GqlcKc9efpPt0O24%QFE07)I4muy1d769b229$*;3S*F~f
zsa#59HFw6z?+HzvY3Dcq1|>TG$%u&W2q|vS7?Je>Pt0HNW7P72g`A)r{@BA#mfICo
zVcU?3g$Iu2;M^^+SmPEpu+{>${}D<JiBZZgE6mNm0yE3&ED8j9E*AX@ny1YG;6srD
z0XzUZK*YbZ93H4a1D-Y%fh|49mbJ4oi4k}n3rBtu)+zoGr$)jcfXJU(8>sO%xEdYy
z0`)<gyX7H93lVf3#3wu;XomwgYRwM!<@&}E6WI{Tf1uG_o??Cd#DVxYJb3W;CX=GB
zBPoLiFecSTt(`n;KV4#fVh@0*1L6+D<UOV&EBFssfo`PP7KX#}0U=89!~nu&J|r+-
zXk-upz9)v#WSoc1Vz-zG-n_dKsI2LIbUFAN(&ti_K4w9qdnBVS-+Zi2@YA$u53TZ^
zO6#2YF=FRQ-HFRn?e&p2649NcPzx=TemYJf74exQ#wzA!XMSmzaEuZO8I_rWCT=PW
zONLJ6i<=>iJSbshpFm(!BY_pR+Yy3ig9m7RE!=w<F(pfgN%nGiFvBhE-lM66^y+?!
zqp}7_F<pX7l!rJ8LI=BwB@pL7CnFk0zHw0iCU`;jT<JUI0l}eg1oj_>5Yo^cj%?~o
z8~PX6f|&U%584rT-33s=p=1FilPqY1{4st|=Rf%DwF{57i5hwc{pmqq!-B%$U9yv#
zeSWmH*rm4Om9-^v`QZo){Ab01U`Ti@@pC1)Cm)$gX|y6XC5Z*#BztUjlemznJa)WY
zfOMF5jQbsvMGf2GU6#%_a5M!EvXc@*6H_5fk8MtKIE@CTRD^_@(ibcTw$B=Z=_&4i
znP7RmbvD92Y4a$$!V!ng@xl%Hnd(Ne_VX|hM<9F$Azh+Xea=e~QrWe#ejb@b%ocr4
z#EVTx7>JoYN$!0}rSjH@wkbr=U|q0Sz-5NMVMDL#QA+W9+!O)@wpwDkDf@e#yAr-i
zl<hOaOSU;tof`lt`<XXAU}%0FN&E?ee6Mf_x{FlHxo*h!7IkY0fPw}J;Bx##WegA<
z3ItWIRl|HW{puIPW(|53k@laI<57TZeNFfHZC?oH!(q80St^A)rRjrJM*r+4<U`YH
zSy`U>9lUP6m<sqGX-GS7ikwR)7CeA-&(gyT9Yomy(fTkcP@sW>U8V=BVV$ZG62#&`
zR|=qK_~HKQ6fb6?mKh=X(@G{@S&fv2Xq!?&v8=Rug$ZQtY1v+6t^H#<B!tQ966mmu
zsEye2M`PlrA?g?F8=4@wv>Qmf6XHA$A;KPK87$whl$RDD5);QkByhlrQ?k8x(MAL-
zgO(IUMsZ<8(EO3sN#GnlJMG3#Tj+?9hqoZ*8_<WD_o%1?s~)@6mqf6(%NPp7F%BeK
z;4$ScSRxUB3Lr!SnG%*rj)76musM1nTJ5)mLWVpCLd`BkPjEPN8Pzl*2>J@Ps8>jF
zTPtr23neK;xz{3msSjd^XS6OnXg#}I>SeFkDx}GzQ;V>rFyL1$%800!qH*AB&4>>t
z+Gx}}GH^FAYJBVCp18Nfg<zGT52#(`)=HfRU0F#7QTvT!sR)^nlIP=&2Z%GHkLT$$
z?f{;1ijod#pYh0y%kVh`zHIX)IFL?K&N3tnP1F<38awD6F!(hjauKEljw07(wj7)8
ze$F`v-*7r+*cdHEN7j#&Q-|NLh|jhWjAAjZa}2IGt&n<Cu`1aeoOMWph;A#1PSn7w
zoXxoh|DkE4ft7t^Te3xX7QckMiY)#$5q3i*)}ZicS3@OXl(F*mE3~}QTqO|T0$8%4
zVKih_e6B2ScASKCrllCxS4K9^iQaq?%!zj)kti(rfmV*mKg3XvpA?cK@T#QMmMty9
zV>~p9x{4w2D#wFWndmU5s~4k<R45Sbujf96zM@+J)_qGZ7Gi`~Az%5`U!>hVw&`q`
z8BJ>xX|G$wf`m*noq95?H*1AV%*A>@#D@ZE%+-+Sks?f444yMtAPs7b@mbJ*KaDXU
z*xyYN`~#sg_otG5Sl<>U^TP1cHY*b2Gic`aI1r=m2VgF+s)UGWStj!pKpl?}Cg5m<
z9niH%(1;@zYQZQlqbSSxjU3nj{tPzUeC6SS4xR+LNIUR4CoR|4d0zzwWbA>b*X#yJ
zGegyw9NpRcCH8SfN8N>Q5f%>~?236Z)5D5=qniP$iP@<k98DOZK&>oF4D2-z8ht}c
zD-C^_AH@nX0OtZ#(`$ew=h2n3I!VQXGR`*al~=iK)l_Hshsx*9b+HgMS?AznM2{y?
z%T$w=5a%Ht?h|lD`>}Cwnrz)L=_YzkTYM3pw(J4yS}Mr+1f;Bbe*5}YPqp6;R0dN0
zG`@{Llp?`+X{l#lH7J8MLXuVc!GRxukzCNrA%s9q|LK*543VO0)}sE1R^VYgq>;9`
zHQWe*SYbK003suvL0-{Kw}=zp(&wS%LWAfvXkb{v5Gs-JpSrgK(xpp0N@G2cm`f51
zP24k&xFKBS*$W&N6%LqZbbxe@;RC1Fj4}ZU$zdFG6af{;8M+Wdx#CDawoK^-P^L!q
zDUAD!=YHU+)^DzC)6CYZz%CpvHw{F9O%cX1W$c&5K{MkJ1;1pwC4NhXi>1Ks3+^^6
z;%u|@H8H`(kO=yh&zlw{U8y5OZk#Al3L?R6xJ)4qpkj}Jy+K5pTqNi9-?mb`3`HTl
zSNR9D9|On$3kV*{aj5KRJOh;=;VIpDiHTwa4lOj-*)d>duKkU+T3Z^Thjg;2nkExk
zoe}iCjJq<;et-#gSQ|>g3u=|{`W|%b20%3^DCrj!jHCepWom&}r()g%QZLpF&1rit
z<aka2i!;}&j4_iEU^<*s!HBa+4^5`Lc5F;bBu|8rq4D5aVm}_u7Ue@jA26>ddP-ph
zg&JxxNgFUR`3-af-5G(@W?p-gJ-L}8kP2EvP+b>bF-D}r%Iw_&xbgh=&B7TN<GEf~
z(CjjbCS3d&l1f|IF!jm;^$Is7O_ZwR#h1jvx%~YTTiE;B;JN)`N-$$1Kw$jz)K>sw
z?q3GmRSY<fD5X$!rV*6DY?GoLLqWy8dk%;jI~RW;3!SnD#=y}FeZwgnk5)7JDy$?-
z;8R}BVQ~qd$cGJm#Z7t`OYOllwhZBFo8R1FKDmt_9W@!(^FTWr#|TUpBSkVSyScc4
zq`&?NMafxPNr95TO~_PwOTSl8ci5wdM=!2kvJ5ZX_R=L#6jf_Qp-}K>`0ef*?^5=G
zsI=^mGU~6JgSlm?XsM-c%SE`dzEhBZ<`}Xm?c_cVXPJH%a!XG}5%!ayEy!~|CzLS?
zc9Kz6pU~uu4NXwiO32T~!r%}2hg;SJfF6DDG|qIa<Xp>&rcKe@aiCaF<bJnxA<hP0
zE-QwVNeu$oAYI5WB6F8Wo%;;5p-vVCCF8ybO2LXB!RMgC?H#~Dm2^nEO^>Ai4O!kd
ze_%-m4HLz8;zQ@kkJ}Wt*?fH2cE>EB*uy<5z;{V(`D1etY>eWuXkoEz!EOmbb-}n%
zwGct+!A$!%!z*!arwm0q@<?Er*J>UgfzwN1!jyZ5K#^t!6uHj2KE>=?aaS8G7ar(^
zS8ZU^oMg{#TCaL46OQaFnK}SAHtPS=W3RS&ZWZjZMQG~}K$fn2-LTXb-GR8qrE!x+
zugIkh#<O}yc=Y(EM=^AH3Y|#QP>rbF?^GkwQT~3Y4T?W+mL!*inJw}GMs+VaU#37L
zY2IT84ec#2F93@W4ZXJ)8N!TrvDWbuW4)hK`ueMi;1r-aBiXgAG3lld7a<@Dh0Id&
zHes%%rp42Z!n$ZuAln)8hj`IYJw>xrOQ77#TPtO0vToGQxIP6oVQ3Q6#J}#NK`Rg~
z^|j$Djl&cX`kC9kY2d$~^2?}}+y_6(Em{L%0`E9o5N=dwg1&am^sKsskr=%QptUm`
zE{UO}vj+n3j9f#70z;D7(wEJH97H!cfD9lF2cWC^9Q|X}co3Z5VC-AQ#Pa#HnRS(i
zOJu103w%?J6ZohFfGyx^!wgYtxO}Drz^p~){>$A>sT%I<Fcv|*+p0sW!>{ad4evd$
z(^O@x!fD5WJy}IgP#zj^$6yHpr&#eqDTed>U^GsPJ8(=aB3O64bx39tV^#YK=Jtbe
zMw4bXBbvaR(2sQ}zc(p$HS~m!d!*UyN2L4dtpWM*l~&0o*sv@Ax^P9T-VCoER6Jw4
zGzAgE-P=^oqmV^DZU!l>$O_e9k5B)i5Z@w2(%$K(UbtQT5GW6sN3vNh?9cnam6jL*
z^pT)@K@^`&zPlfbCVCGBpt_I174gRma0je2B=j5NiyTYVWHfVGFkXNF1_jJBlDP?h
zuhcEQ4bWw7zK#U|gWN9IxA0B(e3%e!lPtUn1OfHYcp*A1iP|GEo3whOB3*}#EP(oL
zuUFA^FG|5EJCVi|mhRX4LO<Q97EJyHD@EjbT9`5b_SMu8N=66AOK3PXu>lWhL|<`o
zuHN=@g0KZqw<8}LvMiHI5$3kt$`L0gBQw{|0rN+u_uuX)2PYn(CJef-zMl7wEC>Bn
z$-?!)SzQd54-Y&84lsnK&`E)gv=U>93_s9Q?O<;3MA-PAc=Rz96Ghd>_^&+i%)%v*
z$DTei4Lp04EGpXg=`%J!Tvwj~b3{(q%98y3<RC=Uky&Md?>>2mmf#SnF5T4g9d29E
zS}G&VpJI&i?O0(=H8l!qDw?4}Rwx|BPG@XYScbQaG%;FoszO}K^J1$x#1m;c8!puT
zZ1YCmqb8-7D)v~IXn>AFhyVrh=mCj}+6;Z$fV^V(&})soB7F=S!5Lu2Hoc>mL+hGe
zP>KnRvaX9N-(onWC+_tDbD(BMB0`*c#1jY(<u<YlzsvRA@xG)NNl0~=uhb0o2ww#b
z1>ugus9bkU8dE=v#SOfSH#m6z#APDl3&k8}PvLdsL&CUCd8hwR!wxVOvj+fGj7;k=
z98+)Dqy&&iv+yOd;WhwgH$Guva|gYH<!-holrBQJiUOGnsb02)**U3-e?6u;os$=i
z8`@(n;~Iqj)BefWj+UEoxZ)0%vqTdn)<AG++>jHb;>8ydK%B^JSOhAImdX<JC(DMw
zsZ=(CRS$3&TP`FUaTR9hPYw`bkvK;}?!SGFNt-2`JfTa{(GnoKc)sNUupv~Rn#A<m
z!s<Hfdt~u=MJO2+;K;Ac#ei{l3>WaY1<Fx^t0Es25e`WJ%7%6N2a8ClcB4jFq`AeR
zMp{cnIuqt^e+6XVh`?!Yz4fLaBs^6^KfeC4KowNskojO)zv(Fh58x!#{CY8;AMX33
zd8{BJJOXpa3<h=qm<JstM15UquqUmXq{au7-62+Yw>)AZ)S@fc$=sa>lZq>{YD+7}
z;|h6SKG*Ap2f7pDR%ah-b7A8WTc~J=fxkq=lJWpmNRun!5=m&`6S~8k1S|G7%o+|M
zwg<6NFv<R71&#ww$x$LNfi?<)*(wVyLcVO*spFDJE%%*NTt}A_r%S5DoI~DjgYS6~
zA*7251=$zqWSfzfAI1J)5Ykk4LH+g+#Eh#GNx~ce9}&g&Z~mY<K(h$>;jd%wcK>o?
z2j}5YafuH_tF8lGBp^;O{~*RNa6>_;&^iIUqBr+JD@81s$G=oP4_H|8K2F-^fr1k%
zoc!&6xVgZPNxB*EC~n3L0DVa?_n)0-G>xGm*#;RmFD{R{1HzjmfID`IpyHCr_Dw`I
zSLr}fc1M;Hp3@GKfvve{tC=d)Q~}i@IFS$PQ|PI^UUG0-zo^z~$Wz;3Y++{e=t-#`
zY_wHOD5wc7-qC@YW1+h_Rh5+q{@s+^Xd^=!DAC94`<2+S$nVAO>iouJ`cx<=26AYv
zkT&sygn3EQe?!kf=0z>kdsK;&zJ!K;dWu^tbEAj{{7@yT05p30Cf0v^7h?W1mb0_j
zF~{`iln3L}x@@WWW0NI^&_ez}m;v7ov8D8x9C*GEDF?o-{PaShpDPy@|ETddFH{LM
zvjKD%{)89wfbax1EV7@ZpDqkv2HAsU`SK9Zw@k9+JOvaoa0!=ZFrY;*x^|RPaAZFr
z{Tfh==5lmv+%fM<V5ebau3BVczbe28tNRT1B;XAGdW)Mx3O8w1k^{e*sc&-RP2DnB
zN!Sq_mTnm=?8>u}x+p9WIg=M4eB=Rw+N}Xb#ujecQ{pHXg!QoM8D^gYoE0`z0ka|i
z-_w-c5%QHJ?g5MQj5B8NzgeS{5NDhN)i_#&!GuReF&0_>G$TL~5J00m3z{^TMoRe%
zJbZxBP#GHn6lX2Py35Eh5k*+&m3NlwNcADrc*KebiuutFg_B}wS+c^Y*(C<FydZL=
zTaLGcX060UaK$FQIs@xhxB-d|+pWF~ezP#oq;>6oKebOSau^u4Bf5sO&<{Pvz)%i>
zBwOo@X)@$z5hQ6Y!M7Mb6}b75NnL(WFV;hrvcgD!Xi0Ub8S9NDYAkZNK{N<=G$N@@
zw_ON*vVBBU4t}-8g7t|-kTMK4xqKpdn~reICdGn9vteL2&WZ8I{i^}BNW6CdJ{DJk
z&Asy-eLh(QzjS<2?Hk~vNQ2~nhi2kU?d0f&V(Fy{XlOA3G7ScH@CjWPMjO1~z)p`t
zHs;Jb))g3Z(4PE5&RC8+l_>!Oqz|m)g{xj=H5Z&Lv^F50&iTk9OG~ZR*PkeSXj6;8
z4LwCHEXXzpC^=sl;EKz^fbpB@Rxq9s85qJTb*FiblP_@4a4F3-h7WY@(3iR<W8VO-
z-BdZL4p(6zY-476i-3gyB@Zzd>5+kjAIeM2D>739S$7sjkIi9M4V>ZVjNRF*3Rq+G
zAHqM#QPnZTdiLOaz%C-r3t<r%F30K>4P*?VRsEW^fPIM81&TY@Mo%Nh{dj>hMH4I6
zG&gFpBEKQS8Oa5gxUaizFqO89N=6<Q1hhTqS=w8iWDE2Pad>>@=^4W}fK5G#1}&|Q
zaIP+n84u3N%mF);wyN1o2tA40wnI<X`_C<81a`t<H!dG=@~G<^A%0}W^P>yHcF@nQ
z@4&-WGW=%ervm7f8m6B~bs3DCs4et_PC!Wghfu{f*-MP(-Gw*$B#FNlKqH?p8y+5-
zox;*_K--T&HAGH8rw`Q6>+29(pBNXn2VeVfi;?z)9pc&`6P+a{BVQRF4S?bP3S!$~
zmc^YYVG+fYGHkDT6N9XRZwba02H`g;Wv@hA16vCQ<}B|N3aqQL&6`VtAE3b1I>MBV
zAPNvEA+=x_pGGZ%uxG7}B;A+#0-l`FAp$QLo@79Gi}*(VQ4H@4W(hoj28I=428M+2
zbV_H>O`KJ|dP+&Y!d67<<?{(M1h*e0YPS=60y1?OT87rQ4=7TN6Szjjy9}Epsw_$<
z<#9y(wS3s)iL?YoD;Jw~W&G<dx79f|28##@2~3vN)ou||95zbPO$Hd(KTI#DUy{m%
z>;Y)I{mOH3eI8gX!L4KwCgW&lm7|d<_7R2vEqC&vkHZ^`II!}hIJp&0Q7?mb%zR2r
zYv^fdx>VY)N6TlI$u5;N^D7gEBwur4k=+7`HcA?PDVh>o?ajt;{!&@uhY0GBL0OnI
zxS{v!{NZrGpPDtrLZKQ`OYATMJD$;&vxCXlLin*PDRh|O+IV&`uGh!RZzM7ZRhWO3
zo(~{mT{A0k`wRc0-?yBlb>p5B0nFK(`GQG7&U-PNSa#;zaqlD+!Vk*0`UJDu=aVwh
z!pwMZCA1yypaSX<97cG2oKV7ok(p~@skadz_C`n0B18-GerV%W;Ne}16SpDya#sK8
zhL?vTH*+*&UyY?0lFqk^aRkRcM2XfP1bG0uaUv<{Si8)$6H-(>5_sZz5|BcK%w-@Y
z{JOL<M8Iq@#X%045hzBVzqXnKAD)~JtT;ZpC-+ez9V~9eEZd|#xmowr13<kF_7l^A
z)lD%jdqz@bt-{;%0++fHPwEOfW_S?Jl+Uj+{|=&xPrVGJY%Z4Zj|9o*_zTOMOd-Es
zv9Sd7pNWA=fTAmxhe}g$BuN56Mg^U-#EoXibydW@U9nL|%e!O5VxhC+BZb`WC6Ntp
zon^)rT1VnIg4HF;a;5H!2>D+IFFEA{T_1?3CO|6*n>e!h&6|8$o$zx`WN1|M;clj*
zs|8@7heRW}?vf;?Ng6^Va~ivr;b5V4mgAf|7d58tV%5ja!?F?a{EL(}tG$TQTTxJw
zB1k|S!;l^xyf#%No50!f(g5%iuaG;NMBxa6q9CYG&&yUWxFvH+XR|z6ONxe(SKNpb
zkp`EIBh&CBeT<)HF2Y!p>}!ck^8v92ddwXF@O0oJm}5aZ3nPfaCOG-=ohoo(at>a!
zZs~n2Ik8&o#pCu68!Gvj*FNh#=IqA|IbvADisw<smViPC3f*u#i3V6D*E+ZE5}<-Q
zYiAN^5DMOJlSmz?1zvl!BFS;UJl$V{jUg78POx>4NS8Sj<zT3I3ZbX*N0$30tN;_M
zq$x@TOSScN)W8VBC(ftC0xd2!M%YrKjB13)L)D6qT(11){AMuji92A|!ZO*HCh2FG
zHf^Nn)QO&s$`HdRxYz@+o<NdR>mb>5Sz@QH>6liPb@T?^+p+^&lRViZ;3u@95HTiC
zO9rZ*VvU6a{I)$*sRYI+Ku3_Kk`xCxsTE6!NSKwnyB3{Z?HfG;U7#WZXE8D@SLZyX
zrGt{d={_Zu{&HxpO@myO6~p9Gf+yeT64+$HpV}xZ4M>pjN@emk5y%h8(2$21)Iz|b
zc^dSjkPi|OJ^+9-t=Ph3UAW(Tx+CJ;XwYJJ2!EJ@FRSQNsv&xmQ&YHxOlB3=W$A<h
zI0`obcbAsa0Y)GJRpX3O#S(KmH`NyoYxZ%IH3bkdlV$0L0Ad=56p?%3$2tYChRM{N
zi!$&2T`;HxzAfx-0AY|dT$QAX`o!cSYVl=$>K%QUAxe%<LDipl*BZOCKHFFuE<aV(
z0cZ>m1Oo}XOm!TeZjC3@O(=3=>!9ESxNawdpg5eA7y8||anN!Ii_*YK+liSFfd-Zb
z;<yIoJQ!C6Y!y5)=A7LPLGQc})jX~208bWv!39rCD`j6zB+=h?PQj#IGYF~CYYC$D
z_D^ke*E*V5Fxb`AVoiz2#XKJeyl~p0*AxaWlw#^sK%uONOW!_eKm#Q}s?8Gw0GzK&
z+UgQUKx05)s;M8l6$k(dg5D2OJ^DK|D0gMXo^llNiY)%U>b_|!`YzJNE})>@Ixw#i
z9|P<N476RJ3>0DuL8W{zOCaGFZQ5CuXeL}|7}~ptcP{`9Kp4)U5w91MM`vvUSxuZo
zPKu0D>d{^l1xE3q!7096J+4WY8>uOwlR)!f2idum+LgitK=ESd?D0^f{Q22*ZN?I^
zk26vdF{#ZQl0KIx0e1+53BrVxZ5Ed}Wa{9&^hxEXFFL>oc9MCpM*+t+4B&gNEjO$l
z*g&w|U*VVQ0wVg94_eihN|neeT+B-+?C-reS99l+k`a!{`vJUfc6mz_m5({xzc9I;
zEb*XcaKh#n=5_JKyovVR^&wI#?G}b$<8f;G&pqH97V(_?c<9ZLSl}@>k57=n6r!{l
zM8h{j_ejA|q=s=n{r=?Z`-HR1y<IfaJ;71r?+@gqD6pRlQjKnN+t#D4vr2uQGMP$Y
ztt3W^>N#1yBlc`uhBaiV{Z)4y%^@cFyraNoU>i9Sn#zb=GZ~<ccR7*2BcktYeOSlC
zo4etOJbF%XC6kD50@zG}I<!J_KVDOE9f3nRlZ0F14wm2p0Cj}6ht>;RPsS9L1!I0D
zNf3!eTwWAHa!@-!_`@`Bz`u;`KO|T|w4<NAV=b8tLk)@Ym*lImt&Gz$Z`&CM=cjzB
z#b|01;0#nXt$4Mu$gJ0m1n1OUX0e1c1^r`|v){^S4Ol7B_{JM)XJtUD&v(6O4Dk?J
zeFFrw=qnIEAIvx+%Jz1}Ja!>n&$a+?C+X1!S(yK2P<5F@3H&kGGFv3aVN?NuM9hL6
zRXYl?q&8$S>F5-Q(jxf-NSyLwCt8QrVth>3`G8m$oh@={XJRO6<w+4vbf3__9ql+i
z)t<r$<EKW1Tj*PNGj1Mb_SKJyZJ^eWKeH?B=c#D)jduYPM>_0m9ZtJJ)nvhZOczWp
z!V?7S>pRp4CF`t^{K%@2n|R6)q5MbI%ih<NKW&A-Qca0i<D@KfcP9=o0n4a-td4`e
zoH>gbQm&10GNp*yYe_40<gfAkDigC&d7j)E8%>_b67^vuAc@!*l5#%os{*10y)bcK
zr2vJ-|HS*QOo~CbcCsi!Q7}P*JY)NMUgb<$7q=qDJ>f8l*iPKc@j?VqwpPl<$fWEL
zqU@&ST4;>jrkD@gst9<&I4LdIn(%Gd=m!Q`6*K@l<}}&$^i)ON1%=saTZGTmu4(<Z
zdhrOju2MY5SNU(%U^ixQO?%-?b(8!Gx!46VV;78)PcaP5{(?~Dy$(gnhJA_Xb1b$~
zM&%lXXcBu^?i(d)-Iz2NNO$$q8-nui!2<3ZZWuy@ieYDOx4{4yg%`t_Al;~jgqoss
z$5Wa!N2WQ_(u8xdf;o!}=cPo!0@Fh209X_lDDfi2<#9|eiNu<i4y6`a6N3RQw*IQ2
z)YfR)k37EwuxF~eAdz~jgPBtz;l#frE@XIgdP}#4LTHxw<~f#g<WoU*VAmNHMG2yA
zGd6V3-z>Z;9bIG&Lvxok1vuo0Y#)#-Sk0a%4Kb_hE5zTgn08op-VIX7P$DKP^O}Aj
zB63T|hTLbq!R`y&G7+K5Z~Vmmn`KAK8dJa}R1+iD2*=DpY)M7PqY6V=nXDl+@CG~#
z@0fZ*v(+dSB|}+<J}M&!p{YRYoxBr_1&lIENw9n7kj*e8W1J5OhXEmgqv?WZUy}+&
z1S0G@iU}8_dPo>M5XyV;mQT*d-8sUy=+l#I><3k{U<7lig(xy%T}8TYbps&BpfUO?
z?f{?oO0|MC)e(6>3=1(qqv@p^&P5khW2;e^#$~KmI<JQa()<6!;*9r`6m}cD97<SI
zFvJ0Ns^&TE*jmmx0SLz9v|ydUxHuA+8=Ik&n*|<(gxp@)Y-}gI+xsfsVW~wS0){MF
zY%Qei0aMT)7S3#iLkTv-$E3b!<_f84SnUW!Q-TV#F_$-6c74DlRhR^!fc{Zf!Rca-
z1kB)wg}cawvVj8xSrCCpG!6(+frh|_2wzCYh=g3V#-o$g)}gd$sjy#4SLcUB6ieZb
zTQ+TF;8oOEsHSNvK|Ha32}O!~F+Z?i%#>)g#T4ir)5^smMZhbi>$L^Ac|$_=3U^}0
zN@WJDXvi8T4Swtni^6^VU`PivOJh-}^h8+F$C{FRojqu;5&M98_D^ayMO=dh3fpMl
z!Vsh`7tChJAVJV7^oY-gp&w_-k`S3+3Gp(a)87|F09II0Gid6D!ifPirgF5MZ=xC^
zUDcpN-I@wJzz6(Upr$)t)nRmw3aF41aVrY?AZ*fthYS@=P{xZkN-8!*<;DiZP6A3`
zXmEBKcvk*?((W<c+Y@3H85`4I^%jljFfw)d+IDFd6Cz{?BQAwB;QR5^awB(m%&e>G
z344d5sA^miUIQPmIC_-PGI^Z>Mp{rhysZ6Jj%4-vrYu;l|3B`{Ab^&X4x^x{T#Ve}
z2Ir^7b6pyHRk+oOh=qc-=&-$SEBc05^TmOp;Fmvw5IZ5$xZsi+xZ$kf<?p{eP^5r;
z)-5lp6+lWIqnN5%3aB)ws4Je2$TGDEzV#HzP6i{QN0OPE|Gj#1cmXuGW=6Rq2H!LZ
z>kuT93k-Pvuf#tG*+F^$^rGo$*Q5HABvpn6k^ucxq=bjhs-PILHuw=NBAGkJZa|3K
zaGrov45Z>C5ul5md{ii;QSfL`m52m&aZvw2h=em+5t5{V6f%*Gg$`*OCI@_*31#u>
z3JZKBR=FZgSz0lg5wNTQWG2AJZUy^@CK(6t3(L3DLX#Ji!IKFyF3Cz}<D$8s@#nfp
zRZE~OtL0rFR0jeT7xclBq^Nyo0T#6Ct%9Hc8WcO2rbyyWqY1Z3W2N445=4Z1(IA0i
zO3$l5UrQL&NLGQ0zDhtko~=rcd`cUSu43@b$&rFc2T{-*W>6MVVpGcwJQ%hFiAYm0
zUx8l!{<0+n3w%2Q@<&aCRnUbZi(q*KK|St5A3F+Q6J1b_AC@W%!W>yh#jM}bWS&MX
ze@zw?Qg(27u`rq3+v360SyN?L0BF>B=^bSO+2Mj`3p%BZsag|&M7c}~Yf)GRc@hCD
z9(5fDx8(q<Ef-th1xy09v1`oqJ%aPeA7Y{dsOSW@qNBvP1_7XoO-p(wREz;gI#lSm
zVwPTqO2+v70FSF2qM`$<8-$|2K*V)3`=JLC4NE@uZMG^PyXAo}Rx^3H&VsQ*p(ARB
z67M6C)_f45jzcacLhIIsjaL};!Y>yBPvqcMHLaQi5!3y4MKINJEd$17?LCRswuWPq
z|7~sPdgWe@GF(r1*q<7CrJA~S^PCDx8~0(kLk18P4T?^{UKJV?K6HY01PK@@4TSV5
zYxEXO53*u8K7qqCxk-AR!aY4IWAlLY0y)G?VC_kOqfltlgP|l7m_Q?(69bgVhyjP)
z``WGQR-V~AaHn$XjK;ZJ0T}l842u;#;9SABQS4$nj0;#(V*2ihCto@@X1MC|^{c3)
zQV1_VRo!r_yYg2~J-?>X<A4P^>B*0$PeDvhf~Ok$<slEo;M{4rS*|E>U_X~fFbM^S
z)FD&i(^9`FB836g<qHTxQCMS)44YB`&$3?z4ws%BA^ITpK!9tKKuqW#+b~8LH24+{
zWf<G50p;;uk=<3ypph!NUcgej{as%Yx*8B@D<pfHbK2$f&x=>95a1oIXHS(f0xRRK
zAba8su3CmhM8Ff89V&|RZGDywf-D<+k>hPn83Lqx+Ad)Wu_!)>?eKAKvJB}4laB$A
z>deSF_i59&?MB6#ie(P7;!fmMj&tY$&|%?7c(lqAk_wchdG9Tk<B&|0$Ywl%Js>Sw
zM;4OpC(=~bg87(dTA=ikF$Ouno`qR}1gIT!*#iBEjZnBrhfnh%PYksmc?V7&T)Iwh
zy8dSl(}|$+XbF_(!4KMHE%Iu7VVx5)p%EMEEP&jw2L_Y)k$Qc6N*A6t_wF~oW5Nm<
zt3t`5;>p##e|p%x`v+I46xd44N^*(f#CjgO9M9>^m<mxS@IHrkHB)@=`@IH=<<#UQ
zZ8;X&^eCX9Qt03@Bp5L$3Tf2&*_~~p$QO5ld8_B~QC0R-oD`&Yk*$R$T1b;fJ(qr9
zWq)KHli8VaAds8&`$`)99RX}PVKZ2Ng{Tki!qTQgB9$gXN&!x|BKu2NaH*H;P_?U+
zTu1Kbph+;T>Hg!!WEYwM6&^M(G-X{23NL$K-v*MLZ*A8=%$z8}M~YO2WjjL}rR!Wg
z+DFt%kuJMZ*qeXRg7IgpFA8bp%Pnes^(0ZPo;>D;;H*%JuMww(aNEGKe_fPR=Tiz}
zVLj_6(zgeVVVu7BT7>lw=D<|~e@vZCb1*p;Myz%?<GfLH%kDr697`q(gj9oPA%l$q
z+<=)emI~J49$A#(12YB;FhsSrU|=FU{~8H86lf<!6Pcw4ZI&ePF$V|mA|W>71QlET
zE?Srx8Ux7LRk@~J?9S%0WwssU1HHKu>3p&AF}0)aMI)=UwL`GOlxjK>8Q6=JxdJiI
zwzAzj0cA79t?gY#5-b@DP7rpqOv%j{kZBA<Av}xbNTi`jUd5<#3D6w*BQ#iu%reoe
zxnEh<pH8$t?HXmH-z+MiTpn@!5_2RMP9>y_>*qQW2rkegJUNK|X8B|+^2Nwcbvo&f
zX0*uWcwr_%uIakr?Sv^$T9|y(1NrwY4qgHg88#OOo<Q@cia@8>tTZ4Z)p0!W85x-Y
z{c-|;{$NA9H5~Nsx+<=Y``nMDJdX>+LZz5&rbn+8O4u7A@erZuE!9Y;HeSPFj<Mqe
zURm!*kRWj74l2^}nVuAV=--dHe>aQA`10N${KB9&Z#Nc2eXFi}V`k~Gm>YSdMDdFN
z#CCL?0s-_SGwXxJHyX#i5FG(iI<%U_F(&R>jiS^<Buw@SY8W)VNva4Inf28b;%VVQ
zYJs0{ZVoOsrskC^|3F=Xfi4lzEO{L$*;6wbE@nUuU(=yo%(G3}EVAN=rS~Vq&xMde
zXSOi3y_a(GH;XCwb?B`JADE4bacn`z+k68CF(mT~oxisz+(XVFk;mwfU}B+^{d3+v
za_d-o`mAiFtcbdpb}l!^x334tDj}z$M*BPe(TBDxtnUNi&%TrgMUH|&C><=r7No4o
zgr8Vi;$rd3Et+KK;G8Nnf{FNSkvH{h>Ok-rDjI=}M<E3AK=2Egw^6v6)SRG&a^4h(
zfFqkhHT#d{Osnf6=v&Yg(Z);01|Q0~1Sjq`e$dNtriShPEccl_jI%%>%Ex?HuLC0j
zizrq)cBRr<<3c<q2Npr$QewUOe9}S76f4Bnt8>fi3zY3%uH%W>cG)Ms&MXCjSJ)8=
zM4OxT?(8@nOyIAr;x(50!-~%;G4Un>oatJiip3*^-9_CU=x*F{ZW~6F4p0_Sgs8!j
zBFuecVQEOAJ<bI-Urz?n1Sm01=gpybMbkugqv7f9R&?sXCkS2b7~A(kNKv}5QW%^J
zje?TyX07^KqRHAb;g|ubM+82EBv?3OZ2;L^tQwFuWu*hDIh)Bq$T+ZHp&r)dyiu2d
zlw31uWBjv*W^@~{L>VgtK2(Yj6f%m6M@|A~zL^xI)NvzQKy2pHP+e&8f`PD{u7yd&
zj6B1#eH8O9=t!Qex77v<E~gRl8ctDnWx_6Ro8BHhG=SeIsaQ3i?>(I2isuL}Vw(Yt
zN25@L#WaYogEDKY7zvI-QW!SPXiA}|N>lKZgnI?1S~TG%gEcAyaG0DhQ;BEOfO`7+
zii-dJHk<|unqnOucu%`JIkJm6ea%+GnR29dWQ2g<aW6VMBCrk+m!$J7mV6X6VOdvh
z&t3~1$7LYN^RQpTq)=ydZ>Fq@PP_AXit9750&?^2BAU*}y+r75g&s@_EteQcF#YO?
zI`c41MP&x)07EFzyJA9NXi>l(&{B$ik@oYGRG-2WpFmq>wHRhLfyWACLLVBS+VcGr
z-Yd&OZLS8W$vuVIp8`9{t)f7|CCLsD2a<*%h#P>Dj{G=<STywe`IQDO$Op+oTRZ@m
zyuN2L=Qhw8wi!HG3kX{rAhvbR5Ig{j*nv4H;uUE7oH;>2v10^o+|go=j1?lUa&^jy
z2WavT-c^6lT~p0H33!*_jtqF;rY|b@z>6p!{FoIEi4ZXD;6iVpMzHDBl&*s^Km<AA
z)DlIo2R6Mfk2F7VV9CWCa{U@|!Q+@fNw%_vKEwV=*l`D4?tVJZGm$yD;>em~g<u)d
ztru2%H#j>CUxAFJTpFw0U#tGR8lgG2heZ_6XQhB3*Zs*p*zI6BJ;HpvqF_}HEQSRL
z)sJsNYXoQeBqAB_pmPwY2v5wH)06%yb{|<Uk`#j$tHFOyoJ-#~>IrZ`)fUBp9%a<3
zQE?pN|G%+S{a|utDq(xLDv(}NES*-u?yH|mL2yiZ@Eue0>zQQ`g`3+o6H*_3LSTja
z$VvS3QU5GrVnlX>;xc8#4ui|al!Dcjz(J8NI$x1#c3|JcD9xaP&viT=z?3LP7IL3c
zi^c!A4AnSNw@qy88^;h~(hh7w5XqYMr^4oyM=V5L#|+vO-2$LkcbDms!}AJKcj&;o
z3eVxDh;vOZ$oh+APuvDez!L$41kBxu%+#Zc5Zk=N2Hr0ic`Xs-2xqYh=nRz*V&FhE
z0MRE%nO8LPWF_1H=lbHT2FVXUm~>5v)@&>+>sOjG5XFSbl|nT1@fp`rq?3@?^IjBo
zkufr*sEhxNY$WEJ3F~E2^RyeJ&(epG0TIk#oU}t)qYpG-VTv@s;~+MImza&lgJUMW
zI&3HBil!pgQ|!Jg4b`UUOIr$A>HsbC8QviOBrl0&rIP_!Q^y{Zlmc5<sqk%;1K<+Y
z2C;k6l6ifT7)#zUbNlDB8@Nrlbg`@qx(PcRdW;Yvoe@B9yg@u85Svzw!#=G8Qdk31
z%0`3PF9gvYJU){03Z5+&Nq>(JvP4R8hwIf!rhE-zdg|yvt3ZR}7D2k<jZGz!Du}+e
zLdOjhDTo=vUEaPyM<@d8C*jFr5l|z}Brrr8<1iI4&PA}*yn_Q86{ahLD)ZI@qeohJ
zVk%9dqJSPEB($@#dK9bm-q*sHhKULR?6tMhYZ=#UF!MU*K(|adutbQWYe=i|KvT=a
zxIW2{lM;#^-E8=083ZX;g3mVynnr`3(Ns<^3)!lsQ>E*}gxA}kZ8cYi8qgFQNQB~9
zAFFwhZii`ngT=B2R8)m7?H>Ce(+(m8!PaiEFeQ~y-W}n13M9SJI(gXZQVwwM(FU-U
z0q#+?1&#-2)NQfzQ@uHan{{nDE1n1)dxL9O`MHQ};n$4Agl7q_SBNld@iwP<D8TAc
zWT#s82|>o?%?NG6NX-Ll%{BzS_wFwnyghuiDqj%jHOOFRP?6prFB7kb!$Ut1_p@jS
zd_C_l|HE_A?owD04%ik{#Gm|-l{O^UA&ayfI#42299wWP$~zOA)$IwbwB4PIW~sJX
z7xF!}lLKU?x5147^fx!&xON_iDTXs2?f@=ht`i0rh7FQ-PbBg2bh%@2v7{GNfI*Dd
zfi(g*1PI(sJLw==($xg<?xKX0;$mUAHxJUlqK_CDD|<qL))nsNM~T<%IrxBxr@6X)
z!LgyV1Mv<pZ6{)NHFhcZQ8gJ)<uWG8aNQ+>cu*DDhu`|LbLF!2_7YkOIzGb`j0R~d
zX~?yxp}dhWv)<9LDQ%EBz;N*-pq2W~+8YYh@^RhxOff)>RtNvMV{BAXmIXOaLcIdf
zdWhySXjehMP3TlmE6l#nS*88IFy+4fI~?eo>do-*!_io@4{=B%M|X}-@DcCblv@a%
zOGOux;6kxj<XeU~!bikP7Q=dm;xn0nK)Qi$7OSKpdM24Lq9mjPsOSzbSQI%`Vc5*`
zCmaoSqqPgXr4W@!$%h@LUuFCb@NR;rg%wLF*sXN+8pelu)S6WKFGb2W8jqlBcIVCc
zv46?YYa(HuqsLKhzlow{0QbPav2R<C1|U*Rk$q<{cP0@HFcQe}$|RbJDUfkP2NTEv
z1u~-G>HNMy+{c{Z)Rtg-8(e2c2t-<cnn_+;A|g|Yg#=yNuz@K;cx^C6yD?2I(L#`%
z2}G8U6odfLUt5;JFTU)$E65L&s1wWDW=jO5?JqcKHz6=ooU6FL3R6w-x3*&%lKA+7
z{uLF;he1@&96@C0u`9nLwHUao=v7)_$(m>8#(TF=;Exx6u3%l#%)xLZGHBZ0)bQ&(
z$Tr@|p)tjjh2NEU`I@dJL+kkrVIbb}%%MQF8bPZf%?Jop?`xBq@_<`|3-yJbSq?nC
z(uFjpc(Bt&Wg1CeM5tTUi+5Nu+8}^d#wA}f<B&KU?@>$nGFc=G+8tw32t_$zxrCy&
z+&9XKcVNX5KebgMNgJoTWhi~zSzorG?_noHY!_`-_ia=wRQO7@xi%6jhpwC;Jkj4N
zV66nJy};@7U6Dz4hnPTA!y%YgU{R?OIJyJ1X0T{PZ}3*_5I>$L)DnJU(3q%#jt5*5
zEEstN$d(PhdlM`fDNY0&g4+zAU&!B{mBsECDvMRR$oIM{g5=(!=m^VbKY+C&$-UgV
zWSU^*$c_UIH2u&n8=|UM0ZpA}Bn~Z;hF#Hl9@KUCxx5=n)w<|Mn@Tn&Ykk4}K#Q4_
z^-fZ+r-@gJec_G)UJV57H-|e(4wY%2&M#Lw7uXvlh-PHb3y4T5SwyO^_FA8)oD7s7
zA0MebVRopa*dSn25)(wg&!oyxGp?9W`|TT0WkkWY$<q5o(RZs@Pl>aD#}d)q#p7c>
zeoDH(r;xRvlRY?4&_p(th)0(#U4o|Fda6gWWy@;yQRBa@z_d7qIA`vJH}wi4+9b=p
z{`qZq{VeNb2RwUwb|^?UbH_Wv{LY}99hX7CA5e5Tsk-@mI5rRhQ<TpHR_o^{>0(Ln
zoR-v6E}^)Wy2;|_Ild&|&A71!09RMd#25!Oa?M)uv~1S*2eFJ5Z7NP$!-Z|BZ$0;{
zs|P{mEtwacUpVL)OxfY_mn*;(sS6JNt{mssJY5V8CL&F>h^U5=>ryBTpRCc6sERU$
zvI?dJ%rQqx%cLCNq8>&EwW800KnM($faW9Yit<OA;O$Rx&!Pa`%)9{2%dC10M@<#P
zMV8j^7zs!NE=E_RFzZ*lpsCIy<t<jK-Y1u~0{s*SI>3S~7Fa|H7Cny(5z0dHcuKW3
z51FVwhg?cRuzXY2+)?jU2~b<!3N}H^C&nt6XO$g2t3?)>5FR})F(ZK4Il4%l<rTrc
z93{Mn_@Vz4-hN<^S^!;rqYcRv2oT%u1DTsS8G~=c87M6pF{W;WBt(|Z%J0?Mk%=0#
z9-z?nUkGsF1@!@znd-6}A{~IVAV(Cl0wgcR+qAwufajz0$RK>#C>v^$Zr;&L;n^54
zdNy+rLN`z>8Y=%zd4b3RRG3AvYm<5wfuK~K8k<dyiH>Mqh-hdu_tdXQ3>fV4CL@F4
zQ9myxfs=FJ$LLx2tQZZ50&rKc=Md0fGl}aF;Z^F?%Wg1$!GdCW86^QlWsPcKjTK|S
zNK1JkWEq4xLlxS%8Bao*r2NvLunr{BpqTM+Jr33dW6SF}Lzp0Cn;9)_n$4RMg*D|+
zoT3~}E*;mm!kPzXT(W-sdda1=W>7K&2>9nHRCSfGzV82Ww=xLHX)m|!^hE=sG=B3v
zzl?&1S|r^n_g(IG*nxehYoEcVS|U-@;*X-XKp+W&*U}dV#f#QIBJ}e2TOg+R?iMX+
z7z82q_8SYkco9tlGZM`q0~RU1ojs<6`dp*=(Omd~TOAEjS8vC_4q~;vskmoxbN_uz
zcLOihA_NXn>0&7gX#u2izG<-22SO-FOE{vJ-86<#qq1R4VkSIT<Sd{ir)#DbNRsh}
zVH2DsNXe$)z;!sON59a4Ke#gd=D6&-V3C4hi-}2<wnbD6`fy@vYe)J@^KNWurKjry
zYBN!L@`WpRv}augg{BW^XHI@}DHCK0NC9M4#=x+uE?R6lwG#9J2*9?Wh%-=GvQQ0*
z96g{KAyan7A%vr9sp31=&=qvSZVf#kTz8dPP}My|swk!S3EAB|Jy3)Pecy;Nu-yH$
zkgfmfjp=M$HZE-f3LK3lD+<)yw{uVZJMoHhKVZh{<Wzb%OFJ!~$`Od_AEnwd{Zime
zDAI$G4kP=(=4KQ2VNsbJjOk%RRnFGk&9mV?V3TraMY$j*=i^qsNkuk*#P#_oOpb0t
zkJth9F}Y)kmMFBO^x%Cv*O@Y&XlM;s*XXN!>_!m!>v$zMv#tz*j)&x({ZA(9v#WA!
z=)R}DEpigrke+8R2e}iuL;|)hCIfO$Q@zSGU*Xc6H?Pe}+2#gUHyWh!0fN)YBVCyr
z?Ku`c`lBKaP9>?0j_}s{TzSy}t|RgqXWp!82~(4~ajz_~&wE@-OcY%YWr<foR}Bnp
z#$p5S;DLxx%Y)yNqErZjiwU7>nwT}m_)~!H+N~5n1!)wpLp$INqbM;k$3}}h56xIS
z&ul2ElLh3fRyl&o!B1C1jxoCY^kxHyp}^<SX;$OOL_R_rV^#tVOtiQcJgPX!t8t<1
z_W0+Uyd@LjWSB=Jf>>>rAm5CwYUea+vzu`55<P@r)!V@8$%>~{;gF1Tnv=+D>bupg
zC$Vi15sIM_K*c9aRhi-G;+O^Cjpvco1`Mi4N&cy>0A8vGMbODu<9o;o5)720L1@jv
zqz@4<Lm@fb;jQI38G1w#$c$7$+tVqc53S<MS-+|^;bYDyf01h4F1%GcQe9txRbUA~
zi<}l_ro^?K^IqUE7_BIwJ_j#S311gZm(qY7db*$p4u4zWk2GsFu}gFfm}dH^UQXp|
zoI0+3Pp;;l2FKki(a{9XLgsD}QL!rMp73hw-yPT8<VihngrPqDuoUPML!McXf52Ev
z6)9#=kz7RLS}`xtyOgw`0Rm#~zVBcMK%jS0u8q7K5Q2vh_b}|4!yOp=J)Q_ySQX>s
zu1{jY8=gW?>$KF+wS1e{ICi^^F)Hq3<uG+rz{2m4=_zJL^--V!oicIXGrczp6`&zO
zwrsZKM$ZNGacyTWZC|5KL}#5g{T@_HgIG9s^zBMXv2q0jDsEw2R9RVC{p-jSNKmJ!
zicA1W^)%p%vb{7N;F!C3e?&;F+MT<^18URm14-C`4y2P=3em)u#J5=S?9`w3gAs^}
zMyx+{qrFHLy@u5)7mbbqPZXRR2nY#my{%4~w~{ylz3VlA&sGmPcqk?#Fp)}HfasB@
z3^sT8%B^RZ;FzoDbooDEdvZ^+vxZWKU!yAgQ+Nf#N$BOFf5vjprf!a8EA*BMOv}BQ
zD|iPlw36#*9i0wZ%SslZnp$Bqe0~OYc<B#xM9wCNN(A!>Gx$WoGFnhRkAU-i!52y#
z9eR&nbwswURWRUozX*03i&_B&=7H>{BTW|q75HNOr^T`baH+zJYV%^VOU3WlIl^Bw
zNQ(IcA{N<oKT$pf%}0qs;wU<ld11Hw=HH;1EvF0YOyi(Ip9964gbMdwNILFBjQa9P
zp$5-$aY#`JApC5KA>J)y-TieZk2`Z#V)Q~Q8~Q7|Ru!}Q{-*Ty8Ey_at*sMdy)r`;
zwvl|Ppc2B^Q5h-+zqLA!-p<U{DxE}C=5ciycRMJL3L74sNWX_p>|+I#ZH5O`lDn7>
z*C0$2OUT!;<oE69@G*U2O{0acV!}Md=Bca(Fr*k-LcpSh!U#!-iUYIvU~%jRQgf0L
zk~~sgMsSy0PU%1av!QQklSzFRj*Q$_jFx4PPs5KjNr~PKwsWD3S9`vN$YLn5q_Stn
zsrp1qvs3*mAOl8V9CkFHn|3~rgCQmUdB~bczelu|8bm`#LEwwx_p?k^(e%^~L*=sr
zPUb3r<IVa7V<SEmwiYTAqp@rVQ3uB$3Azo+H^4J1TVRvhv2AvV`8nxM1co|i;ITXr
zMb;S)h<62!XcHB}5ji%fA(ph5TlgqWfiN36n)Wu$N*Npw8U_fv#sU&ejF!Sip!@hh
z3*nR8u24}zp*BQoamFgn%f@R42m^!0Cx_H$Ka<LTNfh>#MXAXuMWk&bb1ud~GW|O=
zJuQMGOCI1UrK?KdJ2#&t>w<z{w6upE?W#r6MSXb~OgKDPpTKd5^g=Jhf#k>^Oj7;_
zn37f)sK9Y~5^vHkkR`Qq<X>t{IzF1Ee6sA*LP)6gi02G1OygBr9rVbWb8Rx#Rb&p%
z0^vcOYaEq19^VhNM7Y5g8uPO#-U+PK8#^F*AW{e(qQ`LKOOvKI1VqB@=&qOCkfpV}
z2AK8}EbRKi>0i(g-g0&dN(FAiJsK+k7=)1i`w{UAo)GeR1{hPX=0A)&`m|swq*ek#
zUOwvLygDz+wi@Of5clii{BoJORwA{gi&WbDT{7;?a0j;0@0)5@2}XjgMidAiwj-+j
zvI^NJcsZ-^CKBefS4Tt}(ETDE`{r%dFB68?Km*-E^Im4!pcZvxyg1q~9&*#IphP1n
zq0muFNzD@sq{-h8mhYM_Tu$u+QtZVeHdIs~u0L<?d?MmGgjP(DSrv4wOM@FMISdx@
z5l^%$$l49;MTQo~e&)<`o6-?)6lziL#FTS>uy4c?cu;^0V@WOR>P)=44r8$g>N>zB
zJ-eadTgu%#FmO+@=Jv@fibqB8s_2`+L5QwA7)O#ttD}>Si}$o@;;V4QA|by(Nz?5T
zk;6;^OkdZpBo;nkkcj#aXjTEeDMHrFnifcfmg(CW1OtWvFr`iJ_$GI|C_m$}jX49`
zp#--KT!SoU<#UKR=md=5q~V;;lna-9Np(lMJTL->vsNO(jcqVxTRbJTtv}X^ivMMR
zgqGnuV~_D|+l7PIY0)o;7~hL4C|AQE(QoLfA^Vw2N{lJOP7bgx8biGY54KGGZs;DQ
znMFc|7{g#bZLZW_G#Le>Vmc&C$PprNEm1PDi8M?#O#<hNX91SAzW(S$is9r1dGa<O
zjpIOwc`&Br15gLe1`;D`fOsHanhB&QrQ;i4QweEscbF*w$dGo{BaqNQ4p!43Sssp<
z9)Dt8PwnLSA7jc?p0BjsA+Y&`Y<#|eCph`-8G%L+l%0u$r^y*CFqA4Mu-iig=sO1x
zn+;lF@7m4fgbXnUf#sUzil^jySr()%^RJ>}3}68cj_Nr}g&l7!KvB{D##~$7dU=jV
zWP{M~>Q3)59xdzNSWdIN_M2<It1(Jip{fQ?>h#D8YOhTx36$oiN?IA70+>0ciqt6s
z0!lzOl>p_kf~9CeMzs&YL9ny+$vlkf@B)}u?n3XBa{5-o4vvftqo74)%%JZI2tB;g
zJK6w#B}`4K0qgjQgF~$!^B*IE=RswqbY@@tlt3U2c0Z5C&cEd7VqL>Alx82hN;TDN
zR1HY11`^^*_mLSNl6X@$$D)@5*y>3suH>yal~QZy4kb+r!A*Bs(1|)iOK$lTqkkYj
z%~mW$Pti(68i$}lk&fSqjY0O`ZL%OS(%4D13GF-c{Wnfi67PwGte}BtWxfc|&dKgp
ztFqYu)#_H#WnG+b%9}EK<BBK|-`Im=L8>+@=sH_{W&toCq*z5xSB)wz$6y5o5kRy%
z3F0S>i=mUqo-iL1&HWHn?4m%X*SMt1Z2*f#lPUY)Ts&PDq82INisCUK27Xo$;Q(mL
zlofXto}ZEzlg-o%ZdW5c(HzlHsPkF`>n@SbIOK&%64+sZl@jBl4$1d*A}pX1Z82$u
zq<O#`Cx^+0!U_rjz}42Lp+I8vzTkG71yFX=Pprn)<7sFM*OhcMI+pW=Kp;e30H@l{
zRi<Ab8nY|(=xm9mz6$sag(Q&{awJ4C_}Lby>VzBZhr;9oWjiZkRT`!yb9bv&-p2ig
zbhMo_9|xF<K>r3<&&>`L5O^TPL9CPZ5mv%h*bkhBK-T}>r%v2As|G+Egn6F+P$MmV
zN)Se9E>!Cm{~dhGWbqmJQ7HBnE(D2w&Y7!nqCPWQvCvr&vOCUiziknqj;vjp%nO9;
z#818cp!SQu<@~#l&Oe+dPk|#z?<Iqj(+s!rZ^7I&@+a~a?ahmytH0zTZ%i;BGjjJn
zs@_^}8t;$Iu^CHjDg^hrd(sIv*smd5)8N8t5}UbsH!zgADskd?0!;Jr3XYD>pB<ch
z3AHgb*X~|qOf&*iF7mZjb<L~D83rh=y_As--x;MaA6ugvsm{z#>U;R<K#*TQ4Y;*n
z#iub95L{uo;^HYJW%`ulj#%c7c;H6{XlBCjDK!s1ZAjNI4N8lE9zsqd5lLs|jE)Bh
zgHidqE6{IvBDfQkC=0gDw!~P3uT(TjQ45AZ<jtVr?72Aj4NmM>>l?c@TjxsC7gPmt
zR*j1|fQgjuOb)SCXvI!R`CjT}5(ZZayOU}|1g0Y9M&`$WFXvnY-SBr~%MLG&md<E)
zpZhHhO}$p}F1w45ISyVNYeFf7Dx!)k3qng%Vpo6HfRK`8n7LJrj0cm*il%f{@`vYN
zUK-pFLFV*KYgLk4!Oouhf*8)HP<A@TBf=w=i8%en&0&NL+rTad6}m*(fd#?(#)Q!3
zNSvkV%EI7w5xwStM<EQ8>($1QueMht(wnEx^tqU9!9a$@1QF@l+02&`;&{xyaF)IN
zmBHl&xgEuXzyXz|#~v1nswlpu3Iwb}0~~_#|89zlIB(Pg!ll;ePt-xnfr#WV0e*e`
zk6v++;{hS8rd6g~3dtuNNCb(xr%%8#PwcV7I2av(qX5JjB2cNNZW!l?1R7I+9}8pw
zmL0Ua1Ld>Wj%%P}JcHW$EU$TTy%AVbsW&0ix_x@82WCl2e}xjXu%e3>!%0?pRE1Ds
zr7W7uAsv*&0KEDAn8au?GGOf7;}T5^Ykyt}BS}7W_C?eEYV|jr`)3T6X@w-YT=JR%
z{XkqbDhvi5;EWYL2!#Auj3mtLHxsT>iFILsKM6`P4W)Hhtk=42R*TvYx(W$jcwEa3
zxCmm<m)@^mbjWRood!3WQI#?O(ZYY)dC_2dEAvtg2ccwSMGh$9p@e(ic9~mXO|TcM
zogTrBZB_ys&J9KciUg|fa0nyp8KoD|D~1Ja=!ln<Z1_O*CEQiYb3Ew0+}Va&5lgNg
zVPmdRZUt`eF##~P7V%>k<`;=&L3(2J%!5}7Gz_<LCYfE55NvV50yKACf$W+xltQ=$
z`{yAeg%p`iYU?0`J)YiOoVHXzG9j(S{gqU!h5PN}Pjz)28w6JDARqxkD9HfaR6+aw
z5hlP8h-6w!{ZjJt48Z%gfo6z?8bn$E{3kUT=vw?I62>()w;6K|Fxtt2u%<x?MR%v^
z&<A)FKFG}8AEsntrQ~2?O!&>wLTz<lfgnf+-xJW8?lRR=?ro3}p9rIiPgRv~XF@oE
z@#+NmUpTZAf;a;Y+x$<ARK{Z+V6N+8RKr0!sYc(%A1W;s5MmL6HJYt62nY;TG^|I7
z%wC$4A?nqHB)WZ*02UdUh4D$Wg2;d(bo>$j;)<pc(9kK0#C)eFiD?+HgF`|R@(E<M
zk>NOKL&Fnlg1iT8ZHxj%7C9l)b<zc@ix*z2EO;@l&5WKtz#}{tW1Yr*RFEa8a603C
z&%_%o*L>>XvqN#83306<qQhaERZ2uwo&)?X_K?ycK;PFIRaEVl+CwA+caL6g8~Iez
z(Ly4CnGr`PQe??)ny9TN^&dn52vd4BzKKMK7Uo|R0mct|^3dX#08!;8${;|l_l@rc
zC~(vzXlgvRE%Buq7~<71R4wJR+7LU~F${j)c(KVbntC#+{%(aDWh@Ljs%+`F)8^!g
zhKQlAV+>QiJ|DfZ?e%9wIbW!=jW|{fFVWN$f2?1lG?E}bFP5^#aOOKO$7+a0>;o^Z
z{`8Nrl`#$8Vpxn~@h(^*SdZ69JWsJ|N%%hcuu6R3{TJM*3D+5C>lb#N*-&ChI${-)
zTC_p!bdxX(MPyKyfh414L8usjz=43x;z!HiiYBka$;Za@3@Q=v68I>D+u|6w2W&X~
zf#-+f2_iWO4uJGwcylxoY06<ot!PaOx)^co>Iv+jzJ}68Q$b+tCmEi$6w+bW1YU)l
z3II{dz}MgJK-0w6VlrmX1;W139bSTw`+Rgk>sn4z6ik?R3f|H-Kg4v;wiUG<g}cX+
z+9M=e`mo>y7Vu4<v4sk{cE!6Eg}fDU^w@zDKAp%&ytwfem>DR5@MxB5TTK=aTB}Fg
z6hq0gK>`9nvWQz9GfxOB5pn9YF)vQ2=4zM$^bZ&XmNJac$;zjau~jw|D|HveR8j$M
z)E%_;SjVJI=Np}6r1O)Powu-i5eHJTI5FIuwYGf0s2h4bP^=CR0urtY@`IFUW9azf
z2H3)yD<}l03qV~HDhkN>Mv0k--(o@K#p)zQhAx@kj>h}!8VG(z_CVjC((%6zW~6sw
zK_DCg0W7BGzi0*^@|RAhESKwumg~`CKw07`oIRPSNs0P=!xC>Z1{D`SUnk{;7|3@W
z-)B3NY6YBqqv7nXq?3QV`=3z|16IxE>B+*j0=#>H4EebPTqP<-@gZScLoEl96|2>R
z;bC)YZ9^OnxJb-{>Hw00UH#uQL$4kYDt;M7Iez~<sKhC!Z2f~<Sgt0<5V+|5_C)*#
z&YXRS&e6cw$r3UoKs&cuKmqKVA&+`<l2@!aLML7l!UB=!!39O~u>?dt;1Q~ii*Y+y
zIQr7u=}};-rp^^W(1Mrt#-_ZO6~nn}*bsD;Q{f;hnBFX?)@Xc!D!uE*r`o+3lsFx-
zb(Rolm*3uho7|2EFT-nJHW>-eIR{J|gj&HuC^r(^6ESHJ)_18OqH=P2PwPnVMT*IG
z`!fe*W%a6bd;#iXp-1(QRwYO;;V}sIRs@i=@d7eZdc4^jUC`1KYo7BN{5NNzhJQ_N
zzig5OTj+Fh=`VXg;L>LhBwcede~utonJw|SQ|^b~OePfH#Dkg_@^KbM!TIS~4me}B
z_BFYj`zBzo?VJx~a^>B#%)kp|g?NlW)j)Rzx{5{ou<DBSI|>C#RAZkKjcTy~)5BFT
z6*N%-hM0h-%SM9j1yE^5f@Gq6q0$ETZV}kEgCi`iP!DRl{SLM44S&KMpjNm}z`%eu
zutAMaIYnTE4FJjHf|3_}-J^J`!Xa-0L$E58OhBP}!G2GW#07+a9flhL{b_&{J<oKy
z_&jQ~&4XgTB69Z}s;*|@2va6la$LI>pzGaC9ic`8B<;M?Wc`I_AbfSsp^RfPn?!3g
zhJ5?qQ$lXX(UL6GF$0+JfAb9o1I6Eu62cbaW`(Zc+TbK0QqUEpHfxxvA2;sAjxY!`
zfJ?Qz*)`v%{A`XoqZ^4@fQ(f{V73chf`Y8G;}dY7c2Mrdv@>tn7R?{G+8Ba@3Kwvl
z#ZifJ^SbA*aTT&^$lst!E|FKp%|YeIf5UI+=FhJ3H6Bn5=EJwN)QW}2a<uFng(wYD
z9$*SaQ*HPr*W?}qTZPlvh%&dujVo;+PGLnu1+<k{n&8wPLR%YX`17oAV{E7Aaa=F?
zmGk7r>+~CuDVe&_p-`jiM5j7G8bAKq9Jn|p-v|2r_hWxHpj5#0+<ESGG3_sBB6|ok
zl*=)Nop=KdwiQ~1Kc9@0fQ6~i9KRfXG|S}7rPKsaz^D+bs7H}!)9u4M$G^J%M;!HH
zm!kLp#5os*H){9(EMM@yl#CQJ^1<96-AU5fW{g?6HuJd~W``w#PjV#&46hW&mRqUn
z$>t}et(B2Lt-O@|u_TwTTcj6f>G%a&Zk9uvK6yrBw!aDVi$u?g!t+|kjG9(PUfbvq
zN_pTGf<F6QgCGoocPb05YaljwR;Y1_9n+aDIF%60nk2P*&o(tmga_@yrb{Uk-;mgK
zy6IMzLnq);+9yIHp77a7b<>e`5oGqkfg6Neg^syIQC`+Hhgr$k%pz>4ot9!+5-$%J
zkh>mM==3gXj8xIL0xm3@Jz<5oEfRep78#Tvq&rOOhY;Mnz&nv9mj)K47VZ6D&su12
zbLOH2nUqwPL7(#5b(+SK^2a~~lMSmx=}u&3HMgqAtMxsf75CZe?$LHSRyPtqY%ii%
z?n^CPi*#q2^ZE-(3K^)MP`ULRlOk`}xspP`|Bmj2hDS)p*z6v`0Zn0>_rhpfze`Fe
z8kmd~XO0PA(8=<%I=U$o5l|H%B+d|RqL@&`pxQQ2;VM^P(4LGDOCRxFji0Om=v8d!
z%4>o7C{kfUxR#i1J9v23&tC#Vcg7_tKr{QRxQDN3=KdYV$+|D~lMZ#;!RlCbP+sg$
zY?vO&VoNCP;)-Ys*Iwbk1?)&B&uJ4+hE)Gg2uP|FlvP}TL>fiLjJRT~cVA;{1zo`O
z5DS$<F=WFWVLIhbdSm0$31of5wlJy5LcsTkuZ{*Q2V+t=<07Had8&NF(m$-Up=c*q
zE@eYfY&tuln@z3>H~#^P94YZu$=8$Ksmucr>u;%@2qt$5Jm46sKq!_D2-Q=K-X9~|
zm(u~L18Bq;!@^iwBDHG8c2+p;2fIyp!m%E3z_qO$h=g`nO#xnp5JPsoi*l0U<BV}D
zCT0c3l7hPfr7w8}Yecy~Se}uk^23$B`0N>P#DCp(Maz@;b+Ik-U&pV<D3%Y?(GYux
zL7ZKvqR5znwY>Ln*@)=VnLaAK)`q*;p|V83WG#t=%|*wwAm=EQgj@hmbwzVXLOhl?
zwV}h4$~7+U!4SnEgVPCz*uZxEYR@OO0;uUphCc^05zd_c7VI-3;TVj<b6t@j45eT)
zu%>ewHKbZso;8cuJC5C&1O_^>V}(3kC4esa#bw_>VKtnBC<b~Wz`lf80K|aU6T}yo
z2YUF(*bN{qTCoLzGl$?Pl_a+Kn&`Y2<a0zI9d!XvAh=fd8g+>;Vh-T?Wq5<p5QgOa
zh(6XI6-DA>;^l~QuZiP4vmjB<vB}|Yc1$cBD~cQG=@y8wk`m$AHn3xq2@DznEP&kD
zDz!T<WF+os>%ZivKrYymn_nUHM(Vjj-CF@D&|*U&2<FFq%UI&@F<dGLO&SB}8fj8m
zVn)vb>cez?T_(OaekXE}YU`?%+=s?}BZ|Q&w6^V#(iIL{i(tlxJOXelXY+GF3k+6e
zkiQ$Y%2BWc=J9)XprH{7VcZ!D3c?T|R8(9y!NTF<CyTZyLd6TwS=^x74cDTYi*(gQ
zEE9Of>JJ+|1Tm1xM3Sb7v=X_%1;bi<d#WT04>dCxivs~!WE|o1!w0#C*pQq5G1cjb
z7>9oC>`9;y_OiMnaS-|@Xv|C)DaJ_MXY<9XMU_>m@ZY?|qLxMlt`hQ7hFQ^EvaYtR
z7zNc{`5h&8RRz(ff-4=~7OLTI6L#RZ33Tq`-AQu$l$tX+6=q1Ii8zR&%NTYr)2ecE
zw(dkMO!kpz!H^<}e+75$m~muO%42d~@7*yql~!L5#aOh8O*<kdH}W^Q(aYP?)1NDH
z%B~f|hC4v>a@krd#affsAPCq9PG&AOWHJfS(@F4<1zC32<;6Na3`8kezkhIE-BJ7S
zI_%=#5o~-I{{$!pv@<DEX%Y|A3KVVb`Y=Pga78F$M6~1q5<Lb+rTDww1kV$Vl*#!O
zT5@^;u}xzo?$Z?23lcl1OND?stxyq!T+)$h8cu--9qj8V`R&4}mU%#;Fh&-dD=a+-
zQLUSLR)^d@Xetv~A@!jcD<($AOi+MOaIH>~jjdzU%Bx$GU)i+vp53@_W>KDa>L*C!
zJA?>`hE&+XoGLj`r2TNOGPDx~3y)$aEm3}O5MW=1*B-i21!n&pe*@ro$WRB{=mGI3
zksS~#`SA9E$f;>Jap#<H_8(m;Tk|TpFhV|*ehb3sL4dwMA36k^3>4rFHr78_P6YV7
z8fF%#R4Iq}5210H*8{T2SQu9ay*lGHJa|}@N^!sapP*PQX4-`k5?thT4I3!ij_(Z^
zxpFQ6B3{Wu8+4XO8<I~RUEZ#U0wzT9gjDgu6i(r8A8XTcXb@YGU9_sTfPB<o@puan
ziwsLpPvRBtMOBfrz$^&^17%Q91i;_eDpycd=%MKAXe-r4fhxl(9znd(#GtkVR7Vk6
zMzR5vK76@)+AmSMJa?YbL3pKnQ>93O;7UUcki9G6)Cv?!t;)~(kf>=%uo5}C%j-_O
z1cvvCb@B_yk&r88rkBq(Iu5Ogi^vxXMT2l2mUe<W7gy^W8_Pv6lSfxMMeVU7vnMZi
z$X4i~i-5&-InN}Vv?@KfGl>;*!BlQiMB&Go9ssavD4-I*6b=a$3^1F;Qh+7+1slm@
zp;@D9H}yp2FMnPhnpKIiF=*ml=t)3w{0NUwB`%>&5e%3e4XEi>gG0Q@W?Xv!Z?Oh1
ztCpZlP8t9ay<6Fc_C}J`{HR9K3~H_f3cQ<Nz~srq<kMtvB*UoM3QlpXR^t^$d?nK|
z+oQJOEtSeUW(W7ZJ^yxq-~<oePXay+8ILWFBI?vtN>r13b#WyAPzVZOk~1#Uf|61L
zNZBNre~s@#NdP>OA>E&+i^+NGL*1GAz&Hw0kqv#dw5Nblq5Z$!GL*9ZsaCcu37gOe
zRM?&BHqJ-VEn@CaEQL1GbhtIe0EdNoSU_VP#0TS=VFxf^Fqq>C7(vRnYLIhGbDDGi
z;=p;a9DmKb8>^Xx44tAjq9@NUn{t3+G$G70GI2cO5CMBDBPT5?(Qy-i#A7=xPu_#s
zuHYG`n04O4tX%8VA+O6tfZc?+$R!AS-)D$n(PtQj5)1<~nnOQ^=fi9J3dQvKwgLxl
z-|tEgE!f9>`&_Nd-7Fgaw=IMxk~*H*p!SxQ&3CZRZBVN&NQI~s#Oy%zNMQ?|fHCZA
zO~en3C_ky{8AQRbNGQt|me9Fb_d7xRJGEpuDg4gRzc801pxsjFw}2AuWw1SWXd_WV
z40J}s!`;QnK{G;*RU0WOd8k|gcJe;W3V#JcpZ3GD@_%Wmgtt?&;Mx^3;sn*)fM`rD
zmx`8yUAGuVkw&l~`pLQLVWkG&>z8f-;CI`A`~d87hpht&`)Sv}J;pvy8qLOau(57u
z!Ys%%2^P=r>Ci9C0Ks)~BPKZud<OBs*j?{|sAlR@I4A5O>e)b#>M|)^`Iw)_@E)Qe
zcGsQou*qPC-_HX4C{)F272hD?J`HT_X?)u(3NT<t#A^XPy@|R)`ho+K8fuf_Yw7cE
zy%F@2VQ+$v5#UdJ%dtmB!ky}XmVT*&`{{IwM7;tj>~+JAGdT>#dJ;S6)&3St0+qZK
z?1Q|W5qXsr%%rQStxYtfF(?&T551)U<WR@(?@ISf^HXPZRn(1Jb-eH3Af0Zh+Z$O~
z!WIJY@UJyDPVQ%^u3)-v4D}nyb>llK=`pm*9!N&xlpfNeidCv6k_!;69y%fnBNfVY
z`AtMUA!9v%%%GK3j2x417|_^5s5k7w$O$RHJ*#7~;Mo?B&@f{1rHf!Y0=)6HZ0wan
z@w68oysCSEWNb#!8(Q9Ej2*Ku7VaC*qTj#TBGy-+F{+j%)ToAW2s=Y4p4uIEWmR#Q
z-rgIf!_zm~%OdkqQ{`<xjN837PQxfXycg&Vtwq{Kg3vtK#F&nX>T%I%JyTE)1Ri_n
zHd=lcVFJ?0K)mY1mIC{%LFGcFw2dD#|C8f~J*+;=?)jyn8yQ?i&V+50u=aF67NS`T
zIsznMzh^;1CWXw%D;IB!GN4phx$yQ>Blb_R@u7IT6a3sr375{LPWAbJ*?sG3;zPP!
zjbNZP;({iCATuaPQ4FV|wLB7t3Q8(;p^;F%HwR2TDw`q$qe7%XhJhtzWTujlvHpM?
z!0p=g3D6@VM!u-=y%XX{d5t50b=hYfG3P+2=^QMNk7=v{9M1tkGNltSfuzzvcqJ<V
zsEK<eqXkki=rD044?C=R_(I>gweVNcOzU7zAYTv(7%(uli`z!#laBTiv&waQ)I_|n
z5b7_8SRJqMJzt)$z%M+&NED$t)?im{bcD}Ps6MdC#2>ZOL?kt_M`y{^z!TZTLMs|q
zO)S(y!MyG1H1nn?ost@h{B;k8(Ry9I#DQEMMk%=%4bDvmNk0zoEyqIZis3*gpryyG
zI&QSOE(cFbmC>5S)A;Yoamnj)M@LNjj|$EKV1pf22!Ft%n{0j~og}Q4qGV*P$r#84
zq2jovuy*`Aj=&%&dt8ySW(naXT$%!4NpT_EjRFZoei7<I2!Y`PvH@g#5C}AGi9$Rd
z43TO;^nz&vA~ndnAjpSuBN2KbmPGV~@)r({I8<?P=+We3=SP8##~u1Q(B)&ahmVhw
zA8b0@ae(eo-XpD!^gU4S18NOoH;~`sDMnh1lo$#%=+05CgE7V=j0_koH{ipuiK7dK
z_!$~A9A=QtafxF=#%GMj7|JrBV_?%kjN=%FL5w;U2q{!n7^87$1(A#E70xaMSvaxr
zb|U?R?1_O8SrS|(*h^@cF(!f|MCpki5X3?eC<G@HZYGdVK$dY3Q4HY_K{8?i1f2)~
ziB%KsCp1B1Fi<lrI-omXHGndtGJr9lG7L9>GDtD#HS{#7J7hVqHH12(GJrIUIUssa
zbf{~{UcEpH8A36ioDdW=JR$I<!rvLp46GF3Pr)~Y@D_kXkiNq62?P-kA^<?Jy@CS*
z9|p`4C?vo~AnOBm35YKM#s=^UAR169;I9Q75a=UNP@u>G%mVraatquQph`hvg9--<
z4!9MNBY<2$x<Ok7=n8Ng0Mr7!4$wcqQGl}nA^<cC&>LV|0AK(~G?9bAeSkXvngG}j
za1g*Qz-0jB0Fndz23QOr44^5#Z2YI@UzWau`0MZQlzzeZ-}B#)|I7CO@1K(X6a8<%
zFZ2I>__6sn_FuOD4f%)A|KNTZ^Dhwkf5jfy`!(;Ut)4ghS$Nj=AHcs&ya@V(;0N2^
z3O)zCS^8u3N##4F??~Q?ogRATbd2cn)x)U=Y2M0RQu{S@oa#f_7jo{*{akzdmVg3=
z9(q67Uhef*v;BVKe;s+D!ao39`{DzHP7pW}=l22J5Aw%^ZWFjU=C3aJWyfwt<-?3l
zPB@>&97o`HV!fd^3*Iws?XGt3+UCl3zuX&l?dmqN*yC-DxJE84633)^>c*XdodkOq
z!<d?b6F=f)%uQ2;f_NJj18ZPz3=GkJJBq&=oAHbogk29(wl!r)B!I+qMIg_zf%3V<
zrAMQelh8x-Fpgc=2*6cDINfkn4DdeuADICh6S#Z{xP)mR7LW4bj?6CN<ytJT0=Wq0
z>jVANf~PSmISj1k4=Ox`AP&oMh%q2~=rdbNg%J6`cP43cs10lo9t9*Qalp26P9?qR
zHo%-fb_KEN(*g*B<7a$q6RJ8h_YfgPm+(*{djb%E@Ndcnxx#c|%b*npK?O6i?G5X=
zVX~}1(G@?ASeAak(>Pk6xC=4QHCO7RIp>T96`F#$$f=luJ!^mHV8eN7atDjZ2J%h^
z1QbBCO-j6wSmfwpZU7$i=noJO0qjx-ho-I+L%=A&R4YwUfiy@wFZNH9V|f93X)s`D
zMM9_HD$j5#e8goHw1pDa!R;|Lu#Xb0<unQ2OKgmSKQ~}bV>EHQVY^^p3>WK=fk-oA
zAu}O&^p$)eMDn*-3Bqllu6T8Z0Ns*UmywW=(*6~C$|i^h;HCtwb6-mkmZ=V2`JIwT
zb>Ko#Nkp0sfVV=yc0{0XMrRPymr5m*3(>5KARkRkDWLdXje|VXq&}}ba}Vv}S8Knb
z0Kz<>PT!NaBk#tjyburpFUq(LoDnWIa1mMp?JPCpoWNQJ^{XL&EF(@qJaH7q((aJ1
zLWsOV62kC;x7!hwJpC^#;5dA>&7X8Y0T+WnuX%~XOC=f&WKK^9xHIrd8S1^9?g-eO
z9v5*vZ95YKb!XsDSZYCjJ}RdO^N2}MGVorS7**dRIZ*4tw6-`Xlsr;GNL*>eoeLL<
z1l$e1GGYA88(TX<)!PZ3n~lh;WyficA(MC<4GX3`pN>qSFl%h8;352i0WqzjwU|6X
z7-1B>nK*udYLYBOS;sjnn@NsV3sI-A;{FO{?1oc0AYoE!(I0$P`kF{pkq$xw*=Xc?
zRRPhbu+l{a*y@5ri%f(f6XOO<5@^i7;scS)!`n_sF@iV97q^%a2nDz!WdU$$&}F*1
zy8?0s-NMA5GrvM*-;P>Qr8CkFGuS%#TrA;+)<T15PN_KnCHFSKS-ZP3>o`G1P$Xzn
zk0Q<<|FUREIp}gI&$4P7Lg-7qXuoGClCSZ@#kYMV3O@`&kE+Ku(7OXDM^v`B6McVA
zT=Hl<ifZ}j1Yp=607Q_^riWfwL<Fj&rcQM|IY3Hg>9lE-S}>$H1mEB_PnwvMz(ES{
z?gjuYoGGc2YVy$W41Uv8ix~OX6tSELl2oN%pLX#`>sY^_DfXZg=801~a3*}?HrEpy
ztfdGkvpPz8=5Flq-O;1GOHD-=Gw9WZst*P;z4z@DxeI4eYS8!xl2}79^$HK7Bk-Fh
z02nw=k@)N`9A54d!XX)xF>}^(h9L##*T~AsX4oG2159o0j8tYPV@-Mm;>WbT2IciF
zP*@L<EOL;G9vj3MX5hMvv@BH30YY}p%NC!I_`q>8(Zm>pWP5|h{Y?2cc{htgnB5~(
z^4gd<_z7cDZ|#-zN+H<ylS`;$0f_=?Nr6R>Uqb3q0^9m9P+P^OAXMpu-oI~KtgQ#~
zd=q36FQ=yEB0x$#v8MlGA{xbR0=`yQAIhSBW{xcD?NqP$$F&q5erfT~f(pa{Drr&*
zCn+U$V%lIRU7ayuWCOG2l9w+moT20~W((<qM_{ze1o|rMBUfH6r#?aRNTK@my>634
zmJr1-oRDM`209QDceG<`BqInbt0be8QrV>ll=U`0>WQh_D8MAJotFu%W0Lhk+1Ldb
zY?uN^sOUn3XYP{?d05oj1ke;N1GreR{SQEwD%foqHTN(vj_$q)E_q+|k^dH&w14xe
z%=S^LE{JCc-VD$ZQ5*<@si^RLL~-dTxU=E<=uk@iyI>x|OuTbcU(_|(rjotr6%cr1
zBmpstr;Nus`UDOzE_2}th;c=-Bwaz4KfC!_h(b{BLU|yOS^G|M4c1GTV=l|z962Hr
zA+6#o$B89gdxR%K6dB~@wb+?~-N{N6-+js?a_joB8l^tu^ionWYhdDN<YC{OJ_5-y
zGql+J-G?dW7}%3Ec`Lo$X&4SAkj3N~!h7?#Fht^4=89~tTf(|kuC|29!(wpe3dScQ
z!Z`G2X}!2U*ntPPg7>%}DgOwkhTRO9IT$=sM^gcFW-L8)7-3ZDak^`CRx+;u1Z%+H
zraIVI!8VjFlp%C}<V2J!(w=KxSpZo)V!D!}$D0y>=e~kdF`(eitLgJoR1xtQsEK3e
zYseq1j?IZ8MKqUr5P<N^6~SF2#WX*f-iSY}Z}od(Z1Cvhk@b>mkO76F`1YtlEk^@V
z9!4@iAz>|J)fsd|0YsLO-sU)-DZ)+sNliOpU>wS{K`RikZBiqax=RM{kdFP}a-E<9
zdIGKE;ROY=xCH=%i--#V#3>+NC{B(1(1gE_ngeM8iC=^ktulJVXL1*_K`=-|W;g0h
z)sXW6A_OOb2`oD>6#=6(SJ3|2WHwATn@p3K-(FMz^;csO2qnwuO6Gb$E$e32!1hIM
zLv+l7lbeWK2>=2}9D40wg<d2?g9liFZ*6oqdZs`Tx;9;|HjqDY9#;l006(_?W><Pr
zKaVfrmc`lhk%Zi3m0Dt~QBUcy042z0lFEzJX+sla8Kc2AWSNtfA_EHl2p&Cc0IVvO
z|Et+4c5TxOk;xO30N7y%gdDvNeq(Q*N#c;wC6<HO4rGT1=k24W5A!T=bUK{KQocn;
z?rZ;+?FzPo^H2P0%M4zD-hG5QRD%%IIfhPzJI_!Mkr)+}HVKJP4{5=%hTLy}!m>u&
zeMKWcZZru{Giw&xt^0dOv~<{T`fWf1xB-*E6<7Ql{j$AcUN&%unDG;(Wl#xgmMyu`
zHs?BJyf)tG+Pi~l><yo=HhCzLeM%?-pTK7Or;f{#D(bw@pwCs0)oyRv0|<$4S?Gk#
z7)6#agPXNR)EC#Wv~8^#LP$2!&up=CGTIZab<E12GRqe!jhSs^#xoa6Ja{#WNn%8=
z=;>WTJ4Hj2nGl0Y`i#4%Q%zv3)-jZx-*s}@qO*dPvLL-G$T=5qR+gX)R8jP{K+~B6
zOXLg_6lpvGr0>R%DrN`J(ZOme9(Hb;qb0r`&bt^U4N*Ubv#tigv>O7zYs%5CYDTr>
zwH+w~Y63oy9T@tM2R?o#3c}FvlXMNp3L*XmKUMEh7n+0wB=fWsbD^9j=KG%1VBlMw
z08@CLOU-Sp28WrIXo1Z16Fkt#C$U^$feY1g?V7u22Z~R|kgFGEdq$vFCWV<fV&c6%
z8I|oC%~y)2K+3B{Q<&bOO$u^SmBlEka~sr4DMp+DV|s}LRA==FifodXaVi3&)kyYA
zH828^B!>df=d>A>1|oxT0s<gZ=oUH!ECNPA`UIZON3$v9ka2M00UOk&)-kmv0#k*=
zfX1`Atj1>}m)tIhmsEw85nN#PCu;$`nGhP-Pn{kDQHF_dt^k$9O6(G-qI{nX5(1RY
zB{KO$j8ANu020&$u@Xu!1fLBO0g_GxlJO*rLu`irAg0Hw+Qy~N^rFj!)O6;qA@Nsl
z<gX7%LCNrwo6;20<JGX`o#e2q#GwVStHhT_Bq4eXUf8`TFIfvvKqUJ(PzY8cD=iAh
zLbMpIu{uaju@bJfn}f7$)&R_H%w?I3gDs%t7mT8klvT1yPhHAED##|d<f9y}qQz1&
z8Gpkq!X=1Ag9xA@7km<sfK`vnIq^8YB{!th@RVK^(F9S@M?(|t0000000000pzzoz

literal 0
HcmV?d00001

diff --git a/clones/llthw.common-lisp.dev/gitbook/fonts/fontawesome/fontawesome-webfont.svg?v=4.6.3 b/clones/llthw.common-lisp.dev/gitbook/fonts/fontawesome/fontawesome-webfont.svg?v=4.6.3
new file mode 100644
index 00000000..8b66187f
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/gitbook/fonts/fontawesome/fontawesome-webfont.svg?v=4.6.3
@@ -0,0 +1,685 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd" >
+<svg xmlns="http://www.w3.org/2000/svg">
+<metadata></metadata>
+<defs>
+<font id="fontawesomeregular" horiz-adv-x="1536" >
+<font-face units-per-em="1792" ascent="1536" descent="-256" />
+<missing-glyph horiz-adv-x="448" />
+<glyph unicode=" "  horiz-adv-x="448" />
+<glyph unicode="&#x09;" horiz-adv-x="448" />
+<glyph unicode="&#xa0;" horiz-adv-x="448" />
+<glyph unicode="&#xa8;" horiz-adv-x="1792" />
+<glyph unicode="&#xa9;" horiz-adv-x="1792" />
+<glyph unicode="&#xae;" horiz-adv-x="1792" />
+<glyph unicode="&#xb4;" horiz-adv-x="1792" />
+<glyph unicode="&#xc6;" horiz-adv-x="1792" />
+<glyph unicode="&#xd8;" horiz-adv-x="1792" />
+<glyph unicode="&#x2000;" horiz-adv-x="768" />
+<glyph unicode="&#x2001;" horiz-adv-x="1537" />
+<glyph unicode="&#x2002;" horiz-adv-x="768" />
+<glyph unicode="&#x2003;" horiz-adv-x="1537" />
+<glyph unicode="&#x2004;" horiz-adv-x="512" />
+<glyph unicode="&#x2005;" horiz-adv-x="384" />
+<glyph unicode="&#x2006;" horiz-adv-x="256" />
+<glyph unicode="&#x2007;" horiz-adv-x="256" />
+<glyph unicode="&#x2008;" horiz-adv-x="192" />
+<glyph unicode="&#x2009;" horiz-adv-x="307" />
+<glyph unicode="&#x200a;" horiz-adv-x="85" />
+<glyph unicode="&#x202f;" horiz-adv-x="307" />
+<glyph unicode="&#x205f;" horiz-adv-x="384" />
+<glyph unicode="&#x2122;" horiz-adv-x="1792" />
+<glyph unicode="&#x221e;" horiz-adv-x="1792" />
+<glyph unicode="&#x2260;" horiz-adv-x="1792" />
+<glyph unicode="&#x25fc;" horiz-adv-x="500" d="M0 0z" />
+<glyph unicode="&#xf000;" horiz-adv-x="1792" d="M1699 1350q0 -35 -43 -78l-632 -632v-768h320q26 0 45 -19t19 -45t-19 -45t-45 -19h-896q-26 0 -45 19t-19 45t19 45t45 19h320v768l-632 632q-43 43 -43 78q0 23 18 36.5t38 17.5t43 4h1408q23 0 43 -4t38 -17.5t18 -36.5z" />
+<glyph unicode="&#xf001;" d="M1536 1312v-1120q0 -50 -34 -89t-86 -60.5t-103.5 -32t-96.5 -10.5t-96.5 10.5t-103.5 32t-86 60.5t-34 89t34 89t86 60.5t103.5 32t96.5 10.5q105 0 192 -39v537l-768 -237v-709q0 -50 -34 -89t-86 -60.5t-103.5 -32t-96.5 -10.5t-96.5 10.5t-103.5 32t-86 60.5t-34 89 t34 89t86 60.5t103.5 32t96.5 10.5q105 0 192 -39v967q0 31 19 56.5t49 35.5l832 256q12 4 28 4q40 0 68 -28t28 -68z" />
+<glyph unicode="&#xf002;" horiz-adv-x="1664" d="M1152 704q0 185 -131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5t316.5 131.5t131.5 316.5zM1664 -128q0 -52 -38 -90t-90 -38q-54 0 -90 38l-343 342q-179 -124 -399 -124q-143 0 -273.5 55.5t-225 150t-150 225t-55.5 273.5 t55.5 273.5t150 225t225 150t273.5 55.5t273.5 -55.5t225 -150t150 -225t55.5 -273.5q0 -220 -124 -399l343 -343q37 -37 37 -90z" />
+<glyph unicode="&#xf003;" horiz-adv-x="1792" d="M1664 32v768q-32 -36 -69 -66q-268 -206 -426 -338q-51 -43 -83 -67t-86.5 -48.5t-102.5 -24.5h-1h-1q-48 0 -102.5 24.5t-86.5 48.5t-83 67q-158 132 -426 338q-37 30 -69 66v-768q0 -13 9.5 -22.5t22.5 -9.5h1472q13 0 22.5 9.5t9.5 22.5zM1664 1083v11v13.5t-0.5 13 t-3 12.5t-5.5 9t-9 7.5t-14 2.5h-1472q-13 0 -22.5 -9.5t-9.5 -22.5q0 -168 147 -284q193 -152 401 -317q6 -5 35 -29.5t46 -37.5t44.5 -31.5t50.5 -27.5t43 -9h1h1q20 0 43 9t50.5 27.5t44.5 31.5t46 37.5t35 29.5q208 165 401 317q54 43 100.5 115.5t46.5 131.5z M1792 1120v-1088q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1472q66 0 113 -47t47 -113z" />
+<glyph unicode="&#xf004;" horiz-adv-x="1792" d="M896 -128q-26 0 -44 18l-624 602q-10 8 -27.5 26t-55.5 65.5t-68 97.5t-53.5 121t-23.5 138q0 220 127 344t351 124q62 0 126.5 -21.5t120 -58t95.5 -68.5t76 -68q36 36 76 68t95.5 68.5t120 58t126.5 21.5q224 0 351 -124t127 -344q0 -221 -229 -450l-623 -600 q-18 -18 -44 -18z" />
+<glyph unicode="&#xf005;" horiz-adv-x="1664" d="M1664 889q0 -22 -26 -48l-363 -354l86 -500q1 -7 1 -20q0 -21 -10.5 -35.5t-30.5 -14.5q-19 0 -40 12l-449 236l-449 -236q-22 -12 -40 -12q-21 0 -31.5 14.5t-10.5 35.5q0 6 2 20l86 500l-364 354q-25 27 -25 48q0 37 56 46l502 73l225 455q19 41 49 41t49 -41l225 -455 l502 -73q56 -9 56 -46z" />
+<glyph unicode="&#xf006;" horiz-adv-x="1664" d="M1137 532l306 297l-422 62l-189 382l-189 -382l-422 -62l306 -297l-73 -421l378 199l377 -199zM1664 889q0 -22 -26 -48l-363 -354l86 -500q1 -7 1 -20q0 -50 -41 -50q-19 0 -40 12l-449 236l-449 -236q-22 -12 -40 -12q-21 0 -31.5 14.5t-10.5 35.5q0 6 2 20l86 500 l-364 354q-25 27 -25 48q0 37 56 46l502 73l225 455q19 41 49 41t49 -41l225 -455l502 -73q56 -9 56 -46z" />
+<glyph unicode="&#xf007;" horiz-adv-x="1408" d="M1408 131q0 -120 -73 -189.5t-194 -69.5h-874q-121 0 -194 69.5t-73 189.5q0 53 3.5 103.5t14 109t26.5 108.5t43 97.5t62 81t85.5 53.5t111.5 20q9 0 42 -21.5t74.5 -48t108 -48t133.5 -21.5t133.5 21.5t108 48t74.5 48t42 21.5q61 0 111.5 -20t85.5 -53.5t62 -81 t43 -97.5t26.5 -108.5t14 -109t3.5 -103.5zM1088 1024q0 -159 -112.5 -271.5t-271.5 -112.5t-271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5t271.5 -112.5t112.5 -271.5z" />
+<glyph unicode="&#xf008;" horiz-adv-x="1920" d="M384 -64v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM384 320v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM384 704v128q0 26 -19 45t-45 19h-128 q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1408 -64v512q0 26 -19 45t-45 19h-768q-26 0 -45 -19t-19 -45v-512q0 -26 19 -45t45 -19h768q26 0 45 19t19 45zM384 1088v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45 t45 -19h128q26 0 45 19t19 45zM1792 -64v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1408 704v512q0 26 -19 45t-45 19h-768q-26 0 -45 -19t-19 -45v-512q0 -26 19 -45t45 -19h768q26 0 45 19t19 45zM1792 320v128 q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1792 704v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1792 1088v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19 t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1920 1248v-1344q0 -66 -47 -113t-113 -47h-1600q-66 0 -113 47t-47 113v1344q0 66 47 113t113 47h1600q66 0 113 -47t47 -113z" />
+<glyph unicode="&#xf009;" horiz-adv-x="1664" d="M768 512v-384q0 -52 -38 -90t-90 -38h-512q-52 0 -90 38t-38 90v384q0 52 38 90t90 38h512q52 0 90 -38t38 -90zM768 1280v-384q0 -52 -38 -90t-90 -38h-512q-52 0 -90 38t-38 90v384q0 52 38 90t90 38h512q52 0 90 -38t38 -90zM1664 512v-384q0 -52 -38 -90t-90 -38 h-512q-52 0 -90 38t-38 90v384q0 52 38 90t90 38h512q52 0 90 -38t38 -90zM1664 1280v-384q0 -52 -38 -90t-90 -38h-512q-52 0 -90 38t-38 90v384q0 52 38 90t90 38h512q52 0 90 -38t38 -90z" />
+<glyph unicode="&#xf00a;" horiz-adv-x="1792" d="M512 288v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM512 800v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1152 288v-192q0 -40 -28 -68t-68 -28h-320 q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM512 1312v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1152 800v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28 h320q40 0 68 -28t28 -68zM1792 288v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1152 1312v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1792 800v-192 q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1792 1312v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68z" />
+<glyph unicode="&#xf00b;" horiz-adv-x="1792" d="M512 288v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM512 800v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1792 288v-192q0 -40 -28 -68t-68 -28h-960 q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h960q40 0 68 -28t28 -68zM512 1312v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1792 800v-192q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v192q0 40 28 68t68 28 h960q40 0 68 -28t28 -68zM1792 1312v-192q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h960q40 0 68 -28t28 -68z" />
+<glyph unicode="&#xf00c;" horiz-adv-x="1792" d="M1671 970q0 -40 -28 -68l-724 -724l-136 -136q-28 -28 -68 -28t-68 28l-136 136l-362 362q-28 28 -28 68t28 68l136 136q28 28 68 28t68 -28l294 -295l656 657q28 28 68 28t68 -28l136 -136q28 -28 28 -68z" />
+<glyph unicode="&#xf00d;" horiz-adv-x="1408" d="M1298 214q0 -40 -28 -68l-136 -136q-28 -28 -68 -28t-68 28l-294 294l-294 -294q-28 -28 -68 -28t-68 28l-136 136q-28 28 -28 68t28 68l294 294l-294 294q-28 28 -28 68t28 68l136 136q28 28 68 28t68 -28l294 -294l294 294q28 28 68 28t68 -28l136 -136q28 -28 28 -68 t-28 -68l-294 -294l294 -294q28 -28 28 -68z" />
+<glyph unicode="&#xf00e;" horiz-adv-x="1664" d="M1024 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-224v-224q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v224h-224q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h224v224q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5v-224h224 q13 0 22.5 -9.5t9.5 -22.5zM1152 704q0 185 -131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5t316.5 131.5t131.5 316.5zM1664 -128q0 -53 -37.5 -90.5t-90.5 -37.5q-54 0 -90 38l-343 342q-179 -124 -399 -124q-143 0 -273.5 55.5 t-225 150t-150 225t-55.5 273.5t55.5 273.5t150 225t225 150t273.5 55.5t273.5 -55.5t225 -150t150 -225t55.5 -273.5q0 -220 -124 -399l343 -343q37 -37 37 -90z" />
+<glyph unicode="&#xf010;" horiz-adv-x="1664" d="M1024 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-576q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h576q13 0 22.5 -9.5t9.5 -22.5zM1152 704q0 185 -131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5t316.5 131.5t131.5 316.5z M1664 -128q0 -53 -37.5 -90.5t-90.5 -37.5q-54 0 -90 38l-343 342q-179 -124 -399 -124q-143 0 -273.5 55.5t-225 150t-150 225t-55.5 273.5t55.5 273.5t150 225t225 150t273.5 55.5t273.5 -55.5t225 -150t150 -225t55.5 -273.5q0 -220 -124 -399l343 -343q37 -37 37 -90z " />
+<glyph unicode="&#xf011;" d="M1536 640q0 -156 -61 -298t-164 -245t-245 -164t-298 -61t-298 61t-245 164t-164 245t-61 298q0 182 80.5 343t226.5 270q43 32 95.5 25t83.5 -50q32 -42 24.5 -94.5t-49.5 -84.5q-98 -74 -151.5 -181t-53.5 -228q0 -104 40.5 -198.5t109.5 -163.5t163.5 -109.5 t198.5 -40.5t198.5 40.5t163.5 109.5t109.5 163.5t40.5 198.5q0 121 -53.5 228t-151.5 181q-42 32 -49.5 84.5t24.5 94.5q31 43 84 50t95 -25q146 -109 226.5 -270t80.5 -343zM896 1408v-640q0 -52 -38 -90t-90 -38t-90 38t-38 90v640q0 52 38 90t90 38t90 -38t38 -90z" />
+<glyph unicode="&#xf012;" horiz-adv-x="1792" d="M256 96v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM640 224v-320q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v320q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1024 480v-576q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23 v576q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1408 864v-960q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v960q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1792 1376v-1472q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v1472q0 14 9 23t23 9h192q14 0 23 -9t9 -23z" />
+<glyph unicode="&#xf013;" d="M1024 640q0 106 -75 181t-181 75t-181 -75t-75 -181t75 -181t181 -75t181 75t75 181zM1536 749v-222q0 -12 -8 -23t-20 -13l-185 -28q-19 -54 -39 -91q35 -50 107 -138q10 -12 10 -25t-9 -23q-27 -37 -99 -108t-94 -71q-12 0 -26 9l-138 108q-44 -23 -91 -38 q-16 -136 -29 -186q-7 -28 -36 -28h-222q-14 0 -24.5 8.5t-11.5 21.5l-28 184q-49 16 -90 37l-141 -107q-10 -9 -25 -9q-14 0 -25 11q-126 114 -165 168q-7 10 -7 23q0 12 8 23q15 21 51 66.5t54 70.5q-27 50 -41 99l-183 27q-13 2 -21 12.5t-8 23.5v222q0 12 8 23t19 13 l186 28q14 46 39 92q-40 57 -107 138q-10 12 -10 24q0 10 9 23q26 36 98.5 107.5t94.5 71.5q13 0 26 -10l138 -107q44 23 91 38q16 136 29 186q7 28 36 28h222q14 0 24.5 -8.5t11.5 -21.5l28 -184q49 -16 90 -37l142 107q9 9 24 9q13 0 25 -10q129 -119 165 -170q7 -8 7 -22 q0 -12 -8 -23q-15 -21 -51 -66.5t-54 -70.5q26 -50 41 -98l183 -28q13 -2 21 -12.5t8 -23.5z" />
+<glyph unicode="&#xf014;" horiz-adv-x="1408" d="M512 800v-576q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h64q14 0 23 -9t9 -23zM768 800v-576q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h64q14 0 23 -9t9 -23zM1024 800v-576q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v576 q0 14 9 23t23 9h64q14 0 23 -9t9 -23zM1152 76v948h-896v-948q0 -22 7 -40.5t14.5 -27t10.5 -8.5h832q3 0 10.5 8.5t14.5 27t7 40.5zM480 1152h448l-48 117q-7 9 -17 11h-317q-10 -2 -17 -11zM1408 1120v-64q0 -14 -9 -23t-23 -9h-96v-948q0 -83 -47 -143.5t-113 -60.5h-832 q-66 0 -113 58.5t-47 141.5v952h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h309l70 167q15 37 54 63t79 26h320q40 0 79 -26t54 -63l70 -167h309q14 0 23 -9t9 -23z" />
+<glyph unicode="&#xf015;" horiz-adv-x="1664" d="M1408 544v-480q0 -26 -19 -45t-45 -19h-384v384h-256v-384h-384q-26 0 -45 19t-19 45v480q0 1 0.5 3t0.5 3l575 474l575 -474q1 -2 1 -6zM1631 613l-62 -74q-8 -9 -21 -11h-3q-13 0 -21 7l-692 577l-692 -577q-12 -8 -24 -7q-13 2 -21 11l-62 74q-8 10 -7 23.5t11 21.5 l719 599q32 26 76 26t76 -26l244 -204v195q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-408l219 -182q10 -8 11 -21.5t-7 -23.5z" />
+<glyph unicode="&#xf016;" d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z " />
+<glyph unicode="&#xf017;" d="M896 992v-448q0 -14 -9 -23t-23 -9h-320q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h224v352q0 14 9 23t23 9h64q14 0 23 -9t9 -23zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640 q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf018;" horiz-adv-x="1920" d="M1111 540v4l-24 320q-1 13 -11 22.5t-23 9.5h-186q-13 0 -23 -9.5t-11 -22.5l-24 -320v-4q-1 -12 8 -20t21 -8h244q12 0 21 8t8 20zM1870 73q0 -73 -46 -73h-704q13 0 22 9.5t8 22.5l-20 256q-1 13 -11 22.5t-23 9.5h-272q-13 0 -23 -9.5t-11 -22.5l-20 -256 q-1 -13 8 -22.5t22 -9.5h-704q-46 0 -46 73q0 54 26 116l417 1044q8 19 26 33t38 14h339q-13 0 -23 -9.5t-11 -22.5l-15 -192q-1 -14 8 -23t22 -9h166q13 0 22 9t8 23l-15 192q-1 13 -11 22.5t-23 9.5h339q20 0 38 -14t26 -33l417 -1044q26 -62 26 -116z" />
+<glyph unicode="&#xf019;" horiz-adv-x="1664" d="M1280 192q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1536 192q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1664 416v-320q0 -40 -28 -68t-68 -28h-1472q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h465l135 -136 q58 -56 136 -56t136 56l136 136h464q40 0 68 -28t28 -68zM1339 985q17 -41 -14 -70l-448 -448q-18 -19 -45 -19t-45 19l-448 448q-31 29 -14 70q17 39 59 39h256v448q0 26 19 45t45 19h256q26 0 45 -19t19 -45v-448h256q42 0 59 -39z" />
+<glyph unicode="&#xf01a;" d="M1120 608q0 -12 -10 -24l-319 -319q-11 -9 -23 -9t-23 9l-320 320q-15 16 -7 35q8 20 30 20h192v352q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-352h192q14 0 23 -9t9 -23zM768 1184q-148 0 -273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273 t-73 273t-198 198t-273 73zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf01b;" d="M1118 660q-8 -20 -30 -20h-192v-352q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v352h-192q-14 0 -23 9t-9 23q0 12 10 24l319 319q11 9 23 9t23 -9l320 -320q15 -16 7 -35zM768 1184q-148 0 -273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198 t73 273t-73 273t-198 198t-273 73zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf01c;" d="M1023 576h316q-1 3 -2.5 8t-2.5 8l-212 496h-708l-212 -496q-1 -2 -2.5 -8t-2.5 -8h316l95 -192h320zM1536 546v-482q0 -26 -19 -45t-45 -19h-1408q-26 0 -45 19t-19 45v482q0 62 25 123l238 552q10 25 36.5 42t52.5 17h832q26 0 52.5 -17t36.5 -42l238 -552 q25 -61 25 -123z" />
+<glyph unicode="&#xf01d;" d="M1184 640q0 -37 -32 -55l-544 -320q-15 -9 -32 -9q-16 0 -32 8q-32 19 -32 56v640q0 37 32 56q33 18 64 -1l544 -320q32 -18 32 -55zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640 q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf01e;" d="M1536 1280v-448q0 -26 -19 -45t-45 -19h-448q-42 0 -59 40q-17 39 14 69l138 138q-148 137 -349 137q-104 0 -198.5 -40.5t-163.5 -109.5t-109.5 -163.5t-40.5 -198.5t40.5 -198.5t109.5 -163.5t163.5 -109.5t198.5 -40.5q119 0 225 52t179 147q7 10 23 12q14 0 25 -9 l137 -138q9 -8 9.5 -20.5t-7.5 -22.5q-109 -132 -264 -204.5t-327 -72.5q-156 0 -298 61t-245 164t-164 245t-61 298t61 298t164 245t245 164t298 61q147 0 284.5 -55.5t244.5 -156.5l130 129q29 31 70 14q39 -17 39 -59z" />
+<glyph unicode="&#xf021;" d="M1511 480q0 -5 -1 -7q-64 -268 -268 -434.5t-478 -166.5q-146 0 -282.5 55t-243.5 157l-129 -129q-19 -19 -45 -19t-45 19t-19 45v448q0 26 19 45t45 19h448q26 0 45 -19t19 -45t-19 -45l-137 -137q71 -66 161 -102t187 -36q134 0 250 65t186 179q11 17 53 117 q8 23 30 23h192q13 0 22.5 -9.5t9.5 -22.5zM1536 1280v-448q0 -26 -19 -45t-45 -19h-448q-26 0 -45 19t-19 45t19 45l138 138q-148 137 -349 137q-134 0 -250 -65t-186 -179q-11 -17 -53 -117q-8 -23 -30 -23h-199q-13 0 -22.5 9.5t-9.5 22.5v7q65 268 270 434.5t480 166.5 q146 0 284 -55.5t245 -156.5l130 129q19 19 45 19t45 -19t19 -45z" />
+<glyph unicode="&#xf022;" horiz-adv-x="1792" d="M384 352v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 608v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z M384 864v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM1536 352v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-960q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h960q13 0 22.5 -9.5t9.5 -22.5z M1536 608v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-960q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h960q13 0 22.5 -9.5t9.5 -22.5zM1536 864v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-960q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h960q13 0 22.5 -9.5 t9.5 -22.5zM1664 160v832q0 13 -9.5 22.5t-22.5 9.5h-1472q-13 0 -22.5 -9.5t-9.5 -22.5v-832q0 -13 9.5 -22.5t22.5 -9.5h1472q13 0 22.5 9.5t9.5 22.5zM1792 1248v-1088q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1472q66 0 113 -47 t47 -113z" />
+<glyph unicode="&#xf023;" horiz-adv-x="1152" d="M320 768h512v192q0 106 -75 181t-181 75t-181 -75t-75 -181v-192zM1152 672v-576q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v576q0 40 28 68t68 28h32v192q0 184 132 316t316 132t316 -132t132 -316v-192h32q40 0 68 -28t28 -68z" />
+<glyph unicode="&#xf024;" horiz-adv-x="1792" d="M320 1280q0 -72 -64 -110v-1266q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v1266q-64 38 -64 110q0 53 37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1792 1216v-763q0 -25 -12.5 -38.5t-39.5 -27.5q-215 -116 -369 -116q-61 0 -123.5 22t-108.5 48 t-115.5 48t-142.5 22q-192 0 -464 -146q-17 -9 -33 -9q-26 0 -45 19t-19 45v742q0 32 31 55q21 14 79 43q236 120 421 120q107 0 200 -29t219 -88q38 -19 88 -19q54 0 117.5 21t110 47t88 47t54.5 21q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf025;" horiz-adv-x="1664" d="M1664 650q0 -166 -60 -314l-20 -49l-185 -33q-22 -83 -90.5 -136.5t-156.5 -53.5v-32q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-32q71 0 130 -35.5t93 -95.5l68 12q29 95 29 193q0 148 -88 279t-236.5 209t-315.5 78 t-315.5 -78t-236.5 -209t-88 -279q0 -98 29 -193l68 -12q34 60 93 95.5t130 35.5v32q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-576q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v32q-88 0 -156.5 53.5t-90.5 136.5l-185 33l-20 49q-60 148 -60 314q0 151 67 291t179 242.5 t266 163.5t320 61t320 -61t266 -163.5t179 -242.5t67 -291z" />
+<glyph unicode="&#xf026;" horiz-adv-x="768" d="M768 1184v-1088q0 -26 -19 -45t-45 -19t-45 19l-333 333h-262q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h262l333 333q19 19 45 19t45 -19t19 -45z" />
+<glyph unicode="&#xf027;" horiz-adv-x="1152" d="M768 1184v-1088q0 -26 -19 -45t-45 -19t-45 19l-333 333h-262q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h262l333 333q19 19 45 19t45 -19t19 -45zM1152 640q0 -76 -42.5 -141.5t-112.5 -93.5q-10 -5 -25 -5q-26 0 -45 18.5t-19 45.5q0 21 12 35.5t29 25t34 23t29 35.5 t12 57t-12 57t-29 35.5t-34 23t-29 25t-12 35.5q0 27 19 45.5t45 18.5q15 0 25 -5q70 -27 112.5 -93t42.5 -142z" />
+<glyph unicode="&#xf028;" horiz-adv-x="1664" d="M768 1184v-1088q0 -26 -19 -45t-45 -19t-45 19l-333 333h-262q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h262l333 333q19 19 45 19t45 -19t19 -45zM1152 640q0 -76 -42.5 -141.5t-112.5 -93.5q-10 -5 -25 -5q-26 0 -45 18.5t-19 45.5q0 21 12 35.5t29 25t34 23t29 35.5 t12 57t-12 57t-29 35.5t-34 23t-29 25t-12 35.5q0 27 19 45.5t45 18.5q15 0 25 -5q70 -27 112.5 -93t42.5 -142zM1408 640q0 -153 -85 -282.5t-225 -188.5q-13 -5 -25 -5q-27 0 -46 19t-19 45q0 39 39 59q56 29 76 44q74 54 115.5 135.5t41.5 173.5t-41.5 173.5 t-115.5 135.5q-20 15 -76 44q-39 20 -39 59q0 26 19 45t45 19q13 0 26 -5q140 -59 225 -188.5t85 -282.5zM1664 640q0 -230 -127 -422.5t-338 -283.5q-13 -5 -26 -5q-26 0 -45 19t-19 45q0 36 39 59q7 4 22.5 10.5t22.5 10.5q46 25 82 51q123 91 192 227t69 289t-69 289 t-192 227q-36 26 -82 51q-7 4 -22.5 10.5t-22.5 10.5q-39 23 -39 59q0 26 19 45t45 19q13 0 26 -5q211 -91 338 -283.5t127 -422.5z" />
+<glyph unicode="&#xf029;" horiz-adv-x="1408" d="M384 384v-128h-128v128h128zM384 1152v-128h-128v128h128zM1152 1152v-128h-128v128h128zM128 129h384v383h-384v-383zM128 896h384v384h-384v-384zM896 896h384v384h-384v-384zM640 640v-640h-640v640h640zM1152 128v-128h-128v128h128zM1408 128v-128h-128v128h128z M1408 640v-384h-384v128h-128v-384h-128v640h384v-128h128v128h128zM640 1408v-640h-640v640h640zM1408 1408v-640h-640v640h640z" />
+<glyph unicode="&#xf02a;" horiz-adv-x="1792" d="M63 0h-63v1408h63v-1408zM126 1h-32v1407h32v-1407zM220 1h-31v1407h31v-1407zM377 1h-31v1407h31v-1407zM534 1h-62v1407h62v-1407zM660 1h-31v1407h31v-1407zM723 1h-31v1407h31v-1407zM786 1h-31v1407h31v-1407zM943 1h-63v1407h63v-1407zM1100 1h-63v1407h63v-1407z M1226 1h-63v1407h63v-1407zM1352 1h-63v1407h63v-1407zM1446 1h-63v1407h63v-1407zM1635 1h-94v1407h94v-1407zM1698 1h-32v1407h32v-1407zM1792 0h-63v1408h63v-1408z" />
+<glyph unicode="&#xf02b;" d="M448 1088q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1515 512q0 -53 -37 -90l-491 -492q-39 -37 -91 -37q-53 0 -90 37l-715 716q-38 37 -64.5 101t-26.5 117v416q0 52 38 90t90 38h416q53 0 117 -26.5t102 -64.5 l715 -714q37 -39 37 -91z" />
+<glyph unicode="&#xf02c;" horiz-adv-x="1920" d="M448 1088q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1515 512q0 -53 -37 -90l-491 -492q-39 -37 -91 -37q-53 0 -90 37l-715 716q-38 37 -64.5 101t-26.5 117v416q0 52 38 90t90 38h416q53 0 117 -26.5t102 -64.5 l715 -714q37 -39 37 -91zM1899 512q0 -53 -37 -90l-491 -492q-39 -37 -91 -37q-36 0 -59 14t-53 45l470 470q37 37 37 90q0 52 -37 91l-715 714q-38 38 -102 64.5t-117 26.5h224q53 0 117 -26.5t102 -64.5l715 -714q37 -39 37 -91z" />
+<glyph unicode="&#xf02d;" horiz-adv-x="1664" d="M1639 1058q40 -57 18 -129l-275 -906q-19 -64 -76.5 -107.5t-122.5 -43.5h-923q-77 0 -148.5 53.5t-99.5 131.5q-24 67 -2 127q0 4 3 27t4 37q1 8 -3 21.5t-3 19.5q2 11 8 21t16.5 23.5t16.5 23.5q23 38 45 91.5t30 91.5q3 10 0.5 30t-0.5 28q3 11 17 28t17 23 q21 36 42 92t25 90q1 9 -2.5 32t0.5 28q4 13 22 30.5t22 22.5q19 26 42.5 84.5t27.5 96.5q1 8 -3 25.5t-2 26.5q2 8 9 18t18 23t17 21q8 12 16.5 30.5t15 35t16 36t19.5 32t26.5 23.5t36 11.5t47.5 -5.5l-1 -3q38 9 51 9h761q74 0 114 -56t18 -130l-274 -906 q-36 -119 -71.5 -153.5t-128.5 -34.5h-869q-27 0 -38 -15q-11 -16 -1 -43q24 -70 144 -70h923q29 0 56 15.5t35 41.5l300 987q7 22 5 57q38 -15 59 -43zM575 1056q-4 -13 2 -22.5t20 -9.5h608q13 0 25.5 9.5t16.5 22.5l21 64q4 13 -2 22.5t-20 9.5h-608q-13 0 -25.5 -9.5 t-16.5 -22.5zM492 800q-4 -13 2 -22.5t20 -9.5h608q13 0 25.5 9.5t16.5 22.5l21 64q4 13 -2 22.5t-20 9.5h-608q-13 0 -25.5 -9.5t-16.5 -22.5z" />
+<glyph unicode="&#xf02e;" horiz-adv-x="1280" d="M1164 1408q23 0 44 -9q33 -13 52.5 -41t19.5 -62v-1289q0 -34 -19.5 -62t-52.5 -41q-19 -8 -44 -8q-48 0 -83 32l-441 424l-441 -424q-36 -33 -83 -33q-23 0 -44 9q-33 13 -52.5 41t-19.5 62v1289q0 34 19.5 62t52.5 41q21 9 44 9h1048z" />
+<glyph unicode="&#xf02f;" horiz-adv-x="1664" d="M384 0h896v256h-896v-256zM384 640h896v384h-160q-40 0 -68 28t-28 68v160h-640v-640zM1536 576q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1664 576v-416q0 -13 -9.5 -22.5t-22.5 -9.5h-224v-160q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68 v160h-224q-13 0 -22.5 9.5t-9.5 22.5v416q0 79 56.5 135.5t135.5 56.5h64v544q0 40 28 68t68 28h672q40 0 88 -20t76 -48l152 -152q28 -28 48 -76t20 -88v-256h64q79 0 135.5 -56.5t56.5 -135.5z" />
+<glyph unicode="&#xf030;" horiz-adv-x="1920" d="M960 864q119 0 203.5 -84.5t84.5 -203.5t-84.5 -203.5t-203.5 -84.5t-203.5 84.5t-84.5 203.5t84.5 203.5t203.5 84.5zM1664 1280q106 0 181 -75t75 -181v-896q0 -106 -75 -181t-181 -75h-1408q-106 0 -181 75t-75 181v896q0 106 75 181t181 75h224l51 136 q19 49 69.5 84.5t103.5 35.5h512q53 0 103.5 -35.5t69.5 -84.5l51 -136h224zM960 128q185 0 316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
+<glyph unicode="&#xf031;" horiz-adv-x="1664" d="M725 977l-170 -450q33 0 136.5 -2t160.5 -2q19 0 57 2q-87 253 -184 452zM0 -128l2 79q23 7 56 12.5t57 10.5t49.5 14.5t44.5 29t31 50.5l237 616l280 724h75h53q8 -14 11 -21l205 -480q33 -78 106 -257.5t114 -274.5q15 -34 58 -144.5t72 -168.5q20 -45 35 -57 q19 -15 88 -29.5t84 -20.5q6 -38 6 -57q0 -4 -0.5 -13t-0.5 -13q-63 0 -190 8t-191 8q-76 0 -215 -7t-178 -8q0 43 4 78l131 28q1 0 12.5 2.5t15.5 3.5t14.5 4.5t15 6.5t11 8t9 11t2.5 14q0 16 -31 96.5t-72 177.5t-42 100l-450 2q-26 -58 -76.5 -195.5t-50.5 -162.5 q0 -22 14 -37.5t43.5 -24.5t48.5 -13.5t57 -8.5t41 -4q1 -19 1 -58q0 -9 -2 -27q-58 0 -174.5 10t-174.5 10q-8 0 -26.5 -4t-21.5 -4q-80 -14 -188 -14z" />
+<glyph unicode="&#xf032;" horiz-adv-x="1408" d="M555 15q74 -32 140 -32q376 0 376 335q0 114 -41 180q-27 44 -61.5 74t-67.5 46.5t-80.5 25t-84 10.5t-94.5 2q-73 0 -101 -10q0 -53 -0.5 -159t-0.5 -158q0 -8 -1 -67.5t-0.5 -96.5t4.5 -83.5t12 -66.5zM541 761q42 -7 109 -7q82 0 143 13t110 44.5t74.5 89.5t25.5 142 q0 70 -29 122.5t-79 82t-108 43.5t-124 14q-50 0 -130 -13q0 -50 4 -151t4 -152q0 -27 -0.5 -80t-0.5 -79q0 -46 1 -69zM0 -128l2 94q15 4 85 16t106 27q7 12 12.5 27t8.5 33.5t5.5 32.5t3 37.5t0.5 34v35.5v30q0 982 -22 1025q-4 8 -22 14.5t-44.5 11t-49.5 7t-48.5 4.5 t-30.5 3l-4 83q98 2 340 11.5t373 9.5q23 0 68.5 -0.5t67.5 -0.5q70 0 136.5 -13t128.5 -42t108 -71t74 -104.5t28 -137.5q0 -52 -16.5 -95.5t-39 -72t-64.5 -57.5t-73 -45t-84 -40q154 -35 256.5 -134t102.5 -248q0 -100 -35 -179.5t-93.5 -130.5t-138 -85.5t-163.5 -48.5 t-176 -14q-44 0 -132 3t-132 3q-106 0 -307 -11t-231 -12z" />
+<glyph unicode="&#xf033;" horiz-adv-x="1024" d="M0 -126l17 85q6 2 81.5 21.5t111.5 37.5q28 35 41 101q1 7 62 289t114 543.5t52 296.5v25q-24 13 -54.5 18.5t-69.5 8t-58 5.5l19 103q33 -2 120 -6.5t149.5 -7t120.5 -2.5q48 0 98.5 2.5t121 7t98.5 6.5q-5 -39 -19 -89q-30 -10 -101.5 -28.5t-108.5 -33.5 q-8 -19 -14 -42.5t-9 -40t-7.5 -45.5t-6.5 -42q-27 -148 -87.5 -419.5t-77.5 -355.5q-2 -9 -13 -58t-20 -90t-16 -83.5t-6 -57.5l1 -18q17 -4 185 -31q-3 -44 -16 -99q-11 0 -32.5 -1.5t-32.5 -1.5q-29 0 -87 10t-86 10q-138 2 -206 2q-51 0 -143 -9t-121 -11z" />
+<glyph unicode="&#xf034;" horiz-adv-x="1792" d="M1744 128q33 0 42 -18.5t-11 -44.5l-126 -162q-20 -26 -49 -26t-49 26l-126 162q-20 26 -11 44.5t42 18.5h80v1024h-80q-33 0 -42 18.5t11 44.5l126 162q20 26 49 26t49 -26l126 -162q20 -26 11 -44.5t-42 -18.5h-80v-1024h80zM81 1407l54 -27q12 -5 211 -5q44 0 132 2 t132 2q36 0 107.5 -0.5t107.5 -0.5h293q6 0 21 -0.5t20.5 0t16 3t17.5 9t15 17.5l42 1q4 0 14 -0.5t14 -0.5q2 -112 2 -336q0 -80 -5 -109q-39 -14 -68 -18q-25 44 -54 128q-3 9 -11 48t-14.5 73.5t-7.5 35.5q-6 8 -12 12.5t-15.5 6t-13 2.5t-18 0.5t-16.5 -0.5 q-17 0 -66.5 0.5t-74.5 0.5t-64 -2t-71 -6q-9 -81 -8 -136q0 -94 2 -388t2 -455q0 -16 -2.5 -71.5t0 -91.5t12.5 -69q40 -21 124 -42.5t120 -37.5q5 -40 5 -50q0 -14 -3 -29l-34 -1q-76 -2 -218 8t-207 10q-50 0 -151 -9t-152 -9q-3 51 -3 52v9q17 27 61.5 43t98.5 29t78 27 q19 42 19 383q0 101 -3 303t-3 303v117q0 2 0.5 15.5t0.5 25t-1 25.5t-3 24t-5 14q-11 12 -162 12q-33 0 -93 -12t-80 -26q-19 -13 -34 -72.5t-31.5 -111t-42.5 -53.5q-42 26 -56 44v383z" />
+<glyph unicode="&#xf035;" d="M81 1407l54 -27q12 -5 211 -5q44 0 132 2t132 2q70 0 246.5 1t304.5 0.5t247 -4.5q33 -1 56 31l42 1q4 0 14 -0.5t14 -0.5q2 -112 2 -336q0 -80 -5 -109q-39 -14 -68 -18q-25 44 -54 128q-3 9 -11 47.5t-15 73.5t-7 36q-10 13 -27 19q-5 2 -66 2q-30 0 -93 1t-103 1 t-94 -2t-96 -7q-9 -81 -8 -136l1 -152v52q0 -55 1 -154t1.5 -180t0.5 -153q0 -16 -2.5 -71.5t0 -91.5t12.5 -69q40 -21 124 -42.5t120 -37.5q5 -40 5 -50q0 -14 -3 -29l-34 -1q-76 -2 -218 8t-207 10q-50 0 -151 -9t-152 -9q-3 51 -3 52v9q17 27 61.5 43t98.5 29t78 27 q7 16 11.5 74t6 145.5t1.5 155t-0.5 153.5t-0.5 89q0 7 -2.5 21.5t-2.5 22.5q0 7 0.5 44t1 73t0 76.5t-3 67.5t-6.5 32q-11 12 -162 12q-41 0 -163 -13.5t-138 -24.5q-19 -12 -34 -71.5t-31.5 -111.5t-42.5 -54q-42 26 -56 44v383zM1310 125q12 0 42 -19.5t57.5 -41.5 t59.5 -49t36 -30q26 -21 26 -49t-26 -49q-4 -3 -36 -30t-59.5 -49t-57.5 -41.5t-42 -19.5q-13 0 -20.5 10.5t-10 28.5t-2.5 33.5t1.5 33t1.5 19.5h-1024q0 -2 1.5 -19.5t1.5 -33t-2.5 -33.5t-10 -28.5t-20.5 -10.5q-12 0 -42 19.5t-57.5 41.5t-59.5 49t-36 30q-26 21 -26 49 t26 49q4 3 36 30t59.5 49t57.5 41.5t42 19.5q13 0 20.5 -10.5t10 -28.5t2.5 -33.5t-1.5 -33t-1.5 -19.5h1024q0 2 -1.5 19.5t-1.5 33t2.5 33.5t10 28.5t20.5 10.5z" />
+<glyph unicode="&#xf036;" horiz-adv-x="1792" d="M1792 192v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1408 576v-128q0 -26 -19 -45t-45 -19h-1280q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1280q26 0 45 -19t19 -45zM1664 960v-128q0 -26 -19 -45 t-45 -19h-1536q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1536q26 0 45 -19t19 -45zM1280 1344v-128q0 -26 -19 -45t-45 -19h-1152q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1152q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf037;" horiz-adv-x="1792" d="M1792 192v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1408 576v-128q0 -26 -19 -45t-45 -19h-896q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h896q26 0 45 -19t19 -45zM1664 960v-128q0 -26 -19 -45t-45 -19 h-1408q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1408q26 0 45 -19t19 -45zM1280 1344v-128q0 -26 -19 -45t-45 -19h-640q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h640q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf038;" horiz-adv-x="1792" d="M1792 192v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 576v-128q0 -26 -19 -45t-45 -19h-1280q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1280q26 0 45 -19t19 -45zM1792 960v-128q0 -26 -19 -45 t-45 -19h-1536q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1536q26 0 45 -19t19 -45zM1792 1344v-128q0 -26 -19 -45t-45 -19h-1152q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1152q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf039;" horiz-adv-x="1792" d="M1792 192v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 576v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 960v-128q0 -26 -19 -45 t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 1344v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf03a;" horiz-adv-x="1792" d="M256 224v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-192q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h192q13 0 22.5 -9.5t9.5 -22.5zM256 608v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-192q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h192q13 0 22.5 -9.5 t9.5 -22.5zM256 992v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-192q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h192q13 0 22.5 -9.5t9.5 -22.5zM1792 224v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1344q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1344 q13 0 22.5 -9.5t9.5 -22.5zM256 1376v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-192q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h192q13 0 22.5 -9.5t9.5 -22.5zM1792 608v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1344q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5 t22.5 9.5h1344q13 0 22.5 -9.5t9.5 -22.5zM1792 992v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1344q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1344q13 0 22.5 -9.5t9.5 -22.5zM1792 1376v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1344q-13 0 -22.5 9.5t-9.5 22.5v192 q0 13 9.5 22.5t22.5 9.5h1344q13 0 22.5 -9.5t9.5 -22.5z" />
+<glyph unicode="&#xf03b;" horiz-adv-x="1792" d="M384 992v-576q0 -13 -9.5 -22.5t-22.5 -9.5q-14 0 -23 9l-288 288q-9 9 -9 23t9 23l288 288q9 9 23 9q13 0 22.5 -9.5t9.5 -22.5zM1792 224v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1728q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1728q13 0 22.5 -9.5 t9.5 -22.5zM1792 608v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1088q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1088q13 0 22.5 -9.5t9.5 -22.5zM1792 992v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1088q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1088 q13 0 22.5 -9.5t9.5 -22.5zM1792 1376v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1728q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1728q13 0 22.5 -9.5t9.5 -22.5z" />
+<glyph unicode="&#xf03c;" horiz-adv-x="1792" d="M352 704q0 -14 -9 -23l-288 -288q-9 -9 -23 -9q-13 0 -22.5 9.5t-9.5 22.5v576q0 13 9.5 22.5t22.5 9.5q14 0 23 -9l288 -288q9 -9 9 -23zM1792 224v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1728q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1728q13 0 22.5 -9.5 t9.5 -22.5zM1792 608v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1088q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1088q13 0 22.5 -9.5t9.5 -22.5zM1792 992v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1088q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1088 q13 0 22.5 -9.5t9.5 -22.5zM1792 1376v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1728q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1728q13 0 22.5 -9.5t9.5 -22.5z" />
+<glyph unicode="&#xf03d;" horiz-adv-x="1792" d="M1792 1184v-1088q0 -42 -39 -59q-13 -5 -25 -5q-27 0 -45 19l-403 403v-166q0 -119 -84.5 -203.5t-203.5 -84.5h-704q-119 0 -203.5 84.5t-84.5 203.5v704q0 119 84.5 203.5t203.5 84.5h704q119 0 203.5 -84.5t84.5 -203.5v-165l403 402q18 19 45 19q12 0 25 -5 q39 -17 39 -59z" />
+<glyph unicode="&#xf03e;" horiz-adv-x="1920" d="M640 960q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1664 576v-448h-1408v192l320 320l160 -160l512 512zM1760 1280h-1600q-13 0 -22.5 -9.5t-9.5 -22.5v-1216q0 -13 9.5 -22.5t22.5 -9.5h1600q13 0 22.5 9.5t9.5 22.5v1216 q0 13 -9.5 22.5t-22.5 9.5zM1920 1248v-1216q0 -66 -47 -113t-113 -47h-1600q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1600q66 0 113 -47t47 -113z" />
+<glyph unicode="&#xf040;" d="M363 0l91 91l-235 235l-91 -91v-107h128v-128h107zM886 928q0 22 -22 22q-10 0 -17 -7l-542 -542q-7 -7 -7 -17q0 -22 22 -22q10 0 17 7l542 542q7 7 7 17zM832 1120l416 -416l-832 -832h-416v416zM1515 1024q0 -53 -37 -90l-166 -166l-416 416l166 165q36 38 90 38 q53 0 91 -38l235 -234q37 -39 37 -91z" />
+<glyph unicode="&#xf041;" horiz-adv-x="1024" d="M768 896q0 106 -75 181t-181 75t-181 -75t-75 -181t75 -181t181 -75t181 75t75 181zM1024 896q0 -109 -33 -179l-364 -774q-16 -33 -47.5 -52t-67.5 -19t-67.5 19t-46.5 52l-365 774q-33 70 -33 179q0 212 150 362t362 150t362 -150t150 -362z" />
+<glyph unicode="&#xf042;" d="M768 96v1088q-148 0 -273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf043;" horiz-adv-x="1024" d="M512 384q0 36 -20 69q-1 1 -15.5 22.5t-25.5 38t-25 44t-21 50.5q-4 16 -21 16t-21 -16q-7 -23 -21 -50.5t-25 -44t-25.5 -38t-15.5 -22.5q-20 -33 -20 -69q0 -53 37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1024 512q0 -212 -150 -362t-362 -150t-362 150t-150 362 q0 145 81 275q6 9 62.5 90.5t101 151t99.5 178t83 201.5q9 30 34 47t51 17t51.5 -17t33.5 -47q28 -93 83 -201.5t99.5 -178t101 -151t62.5 -90.5q81 -127 81 -275z" />
+<glyph unicode="&#xf044;" horiz-adv-x="1792" d="M888 352l116 116l-152 152l-116 -116v-56h96v-96h56zM1328 1072q-16 16 -33 -1l-350 -350q-17 -17 -1 -33t33 1l350 350q17 17 1 33zM1408 478v-190q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h832 q63 0 117 -25q15 -7 18 -23q3 -17 -9 -29l-49 -49q-14 -14 -32 -8q-23 6 -45 6h-832q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832q66 0 113 47t47 113v126q0 13 9 22l64 64q15 15 35 7t20 -29zM1312 1216l288 -288l-672 -672h-288v288zM1756 1084l-92 -92 l-288 288l92 92q28 28 68 28t68 -28l152 -152q28 -28 28 -68t-28 -68z" />
+<glyph unicode="&#xf045;" horiz-adv-x="1664" d="M1408 547v-259q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h255v0q13 0 22.5 -9.5t9.5 -22.5q0 -27 -26 -32q-77 -26 -133 -60q-10 -4 -16 -4h-112q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832 q66 0 113 47t47 113v214q0 19 18 29q28 13 54 37q16 16 35 8q21 -9 21 -29zM1645 1043l-384 -384q-18 -19 -45 -19q-12 0 -25 5q-39 17 -39 59v192h-160q-323 0 -438 -131q-119 -137 -74 -473q3 -23 -20 -34q-8 -2 -12 -2q-16 0 -26 13q-10 14 -21 31t-39.5 68.5t-49.5 99.5 t-38.5 114t-17.5 122q0 49 3.5 91t14 90t28 88t47 81.5t68.5 74t94.5 61.5t124.5 48.5t159.5 30.5t196.5 11h160v192q0 42 39 59q13 5 25 5q26 0 45 -19l384 -384q19 -19 19 -45t-19 -45z" />
+<glyph unicode="&#xf046;" horiz-adv-x="1664" d="M1408 606v-318q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h832q63 0 117 -25q15 -7 18 -23q3 -17 -9 -29l-49 -49q-10 -10 -23 -10q-3 0 -9 2q-23 6 -45 6h-832q-66 0 -113 -47t-47 -113v-832 q0 -66 47 -113t113 -47h832q66 0 113 47t47 113v254q0 13 9 22l64 64q10 10 23 10q6 0 12 -3q20 -8 20 -29zM1639 1095l-814 -814q-24 -24 -57 -24t-57 24l-430 430q-24 24 -24 57t24 57l110 110q24 24 57 24t57 -24l263 -263l647 647q24 24 57 24t57 -24l110 -110 q24 -24 24 -57t-24 -57z" />
+<glyph unicode="&#xf047;" horiz-adv-x="1792" d="M1792 640q0 -26 -19 -45l-256 -256q-19 -19 -45 -19t-45 19t-19 45v128h-384v-384h128q26 0 45 -19t19 -45t-19 -45l-256 -256q-19 -19 -45 -19t-45 19l-256 256q-19 19 -19 45t19 45t45 19h128v384h-384v-128q0 -26 -19 -45t-45 -19t-45 19l-256 256q-19 19 -19 45 t19 45l256 256q19 19 45 19t45 -19t19 -45v-128h384v384h-128q-26 0 -45 19t-19 45t19 45l256 256q19 19 45 19t45 -19l256 -256q19 -19 19 -45t-19 -45t-45 -19h-128v-384h384v128q0 26 19 45t45 19t45 -19l256 -256q19 -19 19 -45z" />
+<glyph unicode="&#xf048;" horiz-adv-x="1024" d="M979 1395q19 19 32 13t13 -32v-1472q0 -26 -13 -32t-32 13l-710 710q-9 9 -13 19v-678q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-678q4 11 13 19z" />
+<glyph unicode="&#xf049;" horiz-adv-x="1792" d="M1747 1395q19 19 32 13t13 -32v-1472q0 -26 -13 -32t-32 13l-710 710q-9 9 -13 19v-710q0 -26 -13 -32t-32 13l-710 710q-9 9 -13 19v-678q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-678q4 11 13 19l710 710 q19 19 32 13t13 -32v-710q4 11 13 19z" />
+<glyph unicode="&#xf04a;" horiz-adv-x="1664" d="M1619 1395q19 19 32 13t13 -32v-1472q0 -26 -13 -32t-32 13l-710 710q-8 9 -13 19v-710q0 -26 -13 -32t-32 13l-710 710q-19 19 -19 45t19 45l710 710q19 19 32 13t13 -32v-710q5 11 13 19z" />
+<glyph unicode="&#xf04b;" horiz-adv-x="1408" d="M1384 609l-1328 -738q-23 -13 -39.5 -3t-16.5 36v1472q0 26 16.5 36t39.5 -3l1328 -738q23 -13 23 -31t-23 -31z" />
+<glyph unicode="&#xf04c;" d="M1536 1344v-1408q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h512q26 0 45 -19t19 -45zM640 1344v-1408q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h512q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf04d;" d="M1536 1344v-1408q0 -26 -19 -45t-45 -19h-1408q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h1408q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf04e;" horiz-adv-x="1664" d="M45 -115q-19 -19 -32 -13t-13 32v1472q0 26 13 32t32 -13l710 -710q8 -8 13 -19v710q0 26 13 32t32 -13l710 -710q19 -19 19 -45t-19 -45l-710 -710q-19 -19 -32 -13t-13 32v710q-5 -10 -13 -19z" />
+<glyph unicode="&#xf050;" horiz-adv-x="1792" d="M45 -115q-19 -19 -32 -13t-13 32v1472q0 26 13 32t32 -13l710 -710q8 -8 13 -19v710q0 26 13 32t32 -13l710 -710q8 -8 13 -19v678q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-1408q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v678q-5 -10 -13 -19l-710 -710 q-19 -19 -32 -13t-13 32v710q-5 -10 -13 -19z" />
+<glyph unicode="&#xf051;" horiz-adv-x="1024" d="M45 -115q-19 -19 -32 -13t-13 32v1472q0 26 13 32t32 -13l710 -710q8 -8 13 -19v678q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-1408q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v678q-5 -10 -13 -19z" />
+<glyph unicode="&#xf052;" horiz-adv-x="1538" d="M14 557l710 710q19 19 45 19t45 -19l710 -710q19 -19 13 -32t-32 -13h-1472q-26 0 -32 13t13 32zM1473 0h-1408q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h1408q26 0 45 -19t19 -45v-256q0 -26 -19 -45t-45 -19z" />
+<glyph unicode="&#xf053;" horiz-adv-x="1280" d="M1171 1235l-531 -531l531 -531q19 -19 19 -45t-19 -45l-166 -166q-19 -19 -45 -19t-45 19l-742 742q-19 19 -19 45t19 45l742 742q19 19 45 19t45 -19l166 -166q19 -19 19 -45t-19 -45z" />
+<glyph unicode="&#xf054;" horiz-adv-x="1280" d="M1107 659l-742 -742q-19 -19 -45 -19t-45 19l-166 166q-19 19 -19 45t19 45l531 531l-531 531q-19 19 -19 45t19 45l166 166q19 19 45 19t45 -19l742 -742q19 -19 19 -45t-19 -45z" />
+<glyph unicode="&#xf055;" d="M1216 576v128q0 26 -19 45t-45 19h-256v256q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-256h-256q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h256v-256q0 -26 19 -45t45 -19h128q26 0 45 19t19 45v256h256q26 0 45 19t19 45zM1536 640q0 -209 -103 -385.5 t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf056;" d="M1216 576v128q0 26 -19 45t-45 19h-768q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h768q26 0 45 19t19 45zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5 t103 -385.5z" />
+<glyph unicode="&#xf057;" d="M1149 414q0 26 -19 45l-181 181l181 181q19 19 19 45q0 27 -19 46l-90 90q-19 19 -46 19q-26 0 -45 -19l-181 -181l-181 181q-19 19 -45 19q-27 0 -46 -19l-90 -90q-19 -19 -19 -46q0 -26 19 -45l181 -181l-181 -181q-19 -19 -19 -45q0 -27 19 -46l90 -90q19 -19 46 -19 q26 0 45 19l181 181l181 -181q19 -19 45 -19q27 0 46 19l90 90q19 19 19 46zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf058;" d="M1284 802q0 28 -18 46l-91 90q-19 19 -45 19t-45 -19l-408 -407l-226 226q-19 19 -45 19t-45 -19l-91 -90q-18 -18 -18 -46q0 -27 18 -45l362 -362q19 -19 45 -19q27 0 46 19l543 543q18 18 18 45zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103 t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf059;" d="M896 160v192q0 14 -9 23t-23 9h-192q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h192q14 0 23 9t9 23zM1152 832q0 88 -55.5 163t-138.5 116t-170 41q-243 0 -371 -213q-15 -24 8 -42l132 -100q7 -6 19 -6q16 0 25 12q53 68 86 92q34 24 86 24q48 0 85.5 -26t37.5 -59 q0 -38 -20 -61t-68 -45q-63 -28 -115.5 -86.5t-52.5 -125.5v-36q0 -14 9 -23t23 -9h192q14 0 23 9t9 23q0 19 21.5 49.5t54.5 49.5q32 18 49 28.5t46 35t44.5 48t28 60.5t12.5 81zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5 t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf05a;" d="M1024 160v160q0 14 -9 23t-23 9h-96v512q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-160q0 -14 9 -23t23 -9h96v-320h-96q-14 0 -23 -9t-9 -23v-160q0 -14 9 -23t23 -9h448q14 0 23 9t9 23zM896 1056v160q0 14 -9 23t-23 9h-192q-14 0 -23 -9t-9 -23v-160q0 -14 9 -23 t23 -9h192q14 0 23 9t9 23zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf05b;" d="M1197 512h-109q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h109q-32 108 -112.5 188.5t-188.5 112.5v-109q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v109q-108 -32 -188.5 -112.5t-112.5 -188.5h109q26 0 45 -19t19 -45v-128q0 -26 -19 -45t-45 -19h-109 q32 -108 112.5 -188.5t188.5 -112.5v109q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-109q108 32 188.5 112.5t112.5 188.5zM1536 704v-128q0 -26 -19 -45t-45 -19h-143q-37 -161 -154.5 -278.5t-278.5 -154.5v-143q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v143 q-161 37 -278.5 154.5t-154.5 278.5h-143q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h143q37 161 154.5 278.5t278.5 154.5v143q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-143q161 -37 278.5 -154.5t154.5 -278.5h143q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf05c;" d="M1097 457l-146 -146q-10 -10 -23 -10t-23 10l-137 137l-137 -137q-10 -10 -23 -10t-23 10l-146 146q-10 10 -10 23t10 23l137 137l-137 137q-10 10 -10 23t10 23l146 146q10 10 23 10t23 -10l137 -137l137 137q10 10 23 10t23 -10l146 -146q10 -10 10 -23t-10 -23 l-137 -137l137 -137q10 -10 10 -23t-10 -23zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5 t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf05d;" d="M1171 723l-422 -422q-19 -19 -45 -19t-45 19l-294 294q-19 19 -19 45t19 45l102 102q19 19 45 19t45 -19l147 -147l275 275q19 19 45 19t45 -19l102 -102q19 -19 19 -45t-19 -45zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273t73 -273t198 -198 t273 -73t273 73t198 198t73 273zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf05e;" d="M1312 643q0 161 -87 295l-754 -753q137 -89 297 -89q111 0 211.5 43.5t173.5 116.5t116 174.5t43 212.5zM313 344l755 754q-135 91 -300 91q-148 0 -273 -73t-198 -199t-73 -274q0 -162 89 -299zM1536 643q0 -157 -61 -300t-163.5 -246t-245 -164t-298.5 -61t-298.5 61 t-245 164t-163.5 246t-61 300t61 299.5t163.5 245.5t245 164t298.5 61t298.5 -61t245 -164t163.5 -245.5t61 -299.5z" />
+<glyph unicode="&#xf060;" d="M1536 640v-128q0 -53 -32.5 -90.5t-84.5 -37.5h-704l293 -294q38 -36 38 -90t-38 -90l-75 -76q-37 -37 -90 -37q-52 0 -91 37l-651 652q-37 37 -37 90q0 52 37 91l651 650q38 38 91 38q52 0 90 -38l75 -74q38 -38 38 -91t-38 -91l-293 -293h704q52 0 84.5 -37.5 t32.5 -90.5z" />
+<glyph unicode="&#xf061;" d="M1472 576q0 -54 -37 -91l-651 -651q-39 -37 -91 -37q-51 0 -90 37l-75 75q-38 38 -38 91t38 91l293 293h-704q-52 0 -84.5 37.5t-32.5 90.5v128q0 53 32.5 90.5t84.5 37.5h704l-293 294q-38 36 -38 90t38 90l75 75q38 38 90 38q53 0 91 -38l651 -651q37 -35 37 -90z" />
+<glyph unicode="&#xf062;" horiz-adv-x="1664" d="M1611 565q0 -51 -37 -90l-75 -75q-38 -38 -91 -38q-54 0 -90 38l-294 293v-704q0 -52 -37.5 -84.5t-90.5 -32.5h-128q-53 0 -90.5 32.5t-37.5 84.5v704l-294 -293q-36 -38 -90 -38t-90 38l-75 75q-38 38 -38 90q0 53 38 91l651 651q35 37 90 37q54 0 91 -37l651 -651 q37 -39 37 -91z" />
+<glyph unicode="&#xf063;" horiz-adv-x="1664" d="M1611 704q0 -53 -37 -90l-651 -652q-39 -37 -91 -37q-53 0 -90 37l-651 652q-38 36 -38 90q0 53 38 91l74 75q39 37 91 37q53 0 90 -37l294 -294v704q0 52 38 90t90 38h128q52 0 90 -38t38 -90v-704l294 294q37 37 90 37q52 0 91 -37l75 -75q37 -39 37 -91z" />
+<glyph unicode="&#xf064;" horiz-adv-x="1792" d="M1792 896q0 -26 -19 -45l-512 -512q-19 -19 -45 -19t-45 19t-19 45v256h-224q-98 0 -175.5 -6t-154 -21.5t-133 -42.5t-105.5 -69.5t-80 -101t-48.5 -138.5t-17.5 -181q0 -55 5 -123q0 -6 2.5 -23.5t2.5 -26.5q0 -15 -8.5 -25t-23.5 -10q-16 0 -28 17q-7 9 -13 22 t-13.5 30t-10.5 24q-127 285 -127 451q0 199 53 333q162 403 875 403h224v256q0 26 19 45t45 19t45 -19l512 -512q19 -19 19 -45z" />
+<glyph unicode="&#xf065;" d="M755 480q0 -13 -10 -23l-332 -332l144 -144q19 -19 19 -45t-19 -45t-45 -19h-448q-26 0 -45 19t-19 45v448q0 26 19 45t45 19t45 -19l144 -144l332 332q10 10 23 10t23 -10l114 -114q10 -10 10 -23zM1536 1344v-448q0 -26 -19 -45t-45 -19t-45 19l-144 144l-332 -332 q-10 -10 -23 -10t-23 10l-114 114q-10 10 -10 23t10 23l332 332l-144 144q-19 19 -19 45t19 45t45 19h448q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf066;" d="M768 576v-448q0 -26 -19 -45t-45 -19t-45 19l-144 144l-332 -332q-10 -10 -23 -10t-23 10l-114 114q-10 10 -10 23t10 23l332 332l-144 144q-19 19 -19 45t19 45t45 19h448q26 0 45 -19t19 -45zM1523 1248q0 -13 -10 -23l-332 -332l144 -144q19 -19 19 -45t-19 -45 t-45 -19h-448q-26 0 -45 19t-19 45v448q0 26 19 45t45 19t45 -19l144 -144l332 332q10 10 23 10t23 -10l114 -114q10 -10 10 -23z" />
+<glyph unicode="&#xf067;" horiz-adv-x="1408" d="M1408 800v-192q0 -40 -28 -68t-68 -28h-416v-416q0 -40 -28 -68t-68 -28h-192q-40 0 -68 28t-28 68v416h-416q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h416v416q0 40 28 68t68 28h192q40 0 68 -28t28 -68v-416h416q40 0 68 -28t28 -68z" />
+<glyph unicode="&#xf068;" horiz-adv-x="1408" d="M1408 800v-192q0 -40 -28 -68t-68 -28h-1216q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h1216q40 0 68 -28t28 -68z" />
+<glyph unicode="&#xf069;" horiz-adv-x="1664" d="M1482 486q46 -26 59.5 -77.5t-12.5 -97.5l-64 -110q-26 -46 -77.5 -59.5t-97.5 12.5l-266 153v-307q0 -52 -38 -90t-90 -38h-128q-52 0 -90 38t-38 90v307l-266 -153q-46 -26 -97.5 -12.5t-77.5 59.5l-64 110q-26 46 -12.5 97.5t59.5 77.5l266 154l-266 154 q-46 26 -59.5 77.5t12.5 97.5l64 110q26 46 77.5 59.5t97.5 -12.5l266 -153v307q0 52 38 90t90 38h128q52 0 90 -38t38 -90v-307l266 153q46 26 97.5 12.5t77.5 -59.5l64 -110q26 -46 12.5 -97.5t-59.5 -77.5l-266 -154z" />
+<glyph unicode="&#xf06a;" d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM896 161v190q0 14 -9 23.5t-22 9.5h-192q-13 0 -23 -10t-10 -23v-190q0 -13 10 -23t23 -10h192 q13 0 22 9.5t9 23.5zM894 505l18 621q0 12 -10 18q-10 8 -24 8h-220q-14 0 -24 -8q-10 -6 -10 -18l17 -621q0 -10 10 -17.5t24 -7.5h185q14 0 23.5 7.5t10.5 17.5z" />
+<glyph unicode="&#xf06b;" d="M928 180v56v468v192h-320v-192v-468v-56q0 -25 18 -38.5t46 -13.5h192q28 0 46 13.5t18 38.5zM472 1024h195l-126 161q-26 31 -69 31q-40 0 -68 -28t-28 -68t28 -68t68 -28zM1160 1120q0 40 -28 68t-68 28q-43 0 -69 -31l-125 -161h194q40 0 68 28t28 68zM1536 864v-320 q0 -14 -9 -23t-23 -9h-96v-416q0 -40 -28 -68t-68 -28h-1088q-40 0 -68 28t-28 68v416h-96q-14 0 -23 9t-9 23v320q0 14 9 23t23 9h440q-93 0 -158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5q107 0 168 -77l128 -165l128 165q61 77 168 77q93 0 158.5 -65.5t65.5 -158.5 t-65.5 -158.5t-158.5 -65.5h440q14 0 23 -9t9 -23z" />
+<glyph unicode="&#xf06c;" horiz-adv-x="1792" d="M1280 832q0 26 -19 45t-45 19q-172 0 -318 -49.5t-259.5 -134t-235.5 -219.5q-19 -21 -19 -45q0 -26 19 -45t45 -19q24 0 45 19q27 24 74 71t67 66q137 124 268.5 176t313.5 52q26 0 45 19t19 45zM1792 1030q0 -95 -20 -193q-46 -224 -184.5 -383t-357.5 -268 q-214 -108 -438 -108q-148 0 -286 47q-15 5 -88 42t-96 37q-16 0 -39.5 -32t-45 -70t-52.5 -70t-60 -32q-30 0 -51 11t-31 24t-27 42q-2 4 -6 11t-5.5 10t-3 9.5t-1.5 13.5q0 35 31 73.5t68 65.5t68 56t31 48q0 4 -14 38t-16 44q-9 51 -9 104q0 115 43.5 220t119 184.5 t170.5 139t204 95.5q55 18 145 25.5t179.5 9t178.5 6t163.5 24t113.5 56.5l29.5 29.5t29.5 28t27 20t36.5 16t43.5 4.5q39 0 70.5 -46t47.5 -112t24 -124t8 -96z" />
+<glyph unicode="&#xf06d;" horiz-adv-x="1408" d="M1408 -160v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-1344q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h1344q13 0 22.5 -9.5t9.5 -22.5zM1152 896q0 -78 -24.5 -144t-64 -112.5t-87.5 -88t-96 -77.5t-87.5 -72t-64 -81.5t-24.5 -96.5q0 -96 67 -224l-4 1l1 -1 q-90 41 -160 83t-138.5 100t-113.5 122.5t-72.5 150.5t-27.5 184q0 78 24.5 144t64 112.5t87.5 88t96 77.5t87.5 72t64 81.5t24.5 96.5q0 94 -66 224l3 -1l-1 1q90 -41 160 -83t138.5 -100t113.5 -122.5t72.5 -150.5t27.5 -184z" />
+<glyph unicode="&#xf06e;" horiz-adv-x="1792" d="M1664 576q-152 236 -381 353q61 -104 61 -225q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 121 61 225q-229 -117 -381 -353q133 -205 333.5 -326.5t434.5 -121.5t434.5 121.5t333.5 326.5zM944 960q0 20 -14 34t-34 14q-125 0 -214.5 -89.5 t-89.5 -214.5q0 -20 14 -34t34 -14t34 14t14 34q0 86 61 147t147 61q20 0 34 14t14 34zM1792 576q0 -34 -20 -69q-140 -230 -376.5 -368.5t-499.5 -138.5t-499.5 139t-376.5 368q-20 35 -20 69t20 69q140 229 376.5 368t499.5 139t499.5 -139t376.5 -368q20 -35 20 -69z" />
+<glyph unicode="&#xf070;" horiz-adv-x="1792" d="M555 201l78 141q-87 63 -136 159t-49 203q0 121 61 225q-229 -117 -381 -353q167 -258 427 -375zM944 960q0 20 -14 34t-34 14q-125 0 -214.5 -89.5t-89.5 -214.5q0 -20 14 -34t34 -14t34 14t14 34q0 86 61 147t147 61q20 0 34 14t14 34zM1307 1151q0 -7 -1 -9 q-105 -188 -315 -566t-316 -567l-49 -89q-10 -16 -28 -16q-12 0 -134 70q-16 10 -16 28q0 12 44 87q-143 65 -263.5 173t-208.5 245q-20 31 -20 69t20 69q153 235 380 371t496 136q89 0 180 -17l54 97q10 16 28 16q5 0 18 -6t31 -15.5t33 -18.5t31.5 -18.5t19.5 -11.5 q16 -10 16 -27zM1344 704q0 -139 -79 -253.5t-209 -164.5l280 502q8 -45 8 -84zM1792 576q0 -35 -20 -69q-39 -64 -109 -145q-150 -172 -347.5 -267t-419.5 -95l74 132q212 18 392.5 137t301.5 307q-115 179 -282 294l63 112q95 -64 182.5 -153t144.5 -184q20 -34 20 -69z " />
+<glyph unicode="&#xf071;" horiz-adv-x="1792" d="M1024 161v190q0 14 -9.5 23.5t-22.5 9.5h-192q-13 0 -22.5 -9.5t-9.5 -23.5v-190q0 -14 9.5 -23.5t22.5 -9.5h192q13 0 22.5 9.5t9.5 23.5zM1022 535l18 459q0 12 -10 19q-13 11 -24 11h-220q-11 0 -24 -11q-10 -7 -10 -21l17 -457q0 -10 10 -16.5t24 -6.5h185 q14 0 23.5 6.5t10.5 16.5zM1008 1469l768 -1408q35 -63 -2 -126q-17 -29 -46.5 -46t-63.5 -17h-1536q-34 0 -63.5 17t-46.5 46q-37 63 -2 126l768 1408q17 31 47 49t65 18t65 -18t47 -49z" />
+<glyph unicode="&#xf072;" horiz-adv-x="1408" d="M1376 1376q44 -52 12 -148t-108 -172l-161 -161l160 -696q5 -19 -12 -33l-128 -96q-7 -6 -19 -6q-4 0 -7 1q-15 3 -21 16l-279 508l-259 -259l53 -194q5 -17 -8 -31l-96 -96q-9 -9 -23 -9h-2q-15 2 -24 13l-189 252l-252 189q-11 7 -13 23q-1 13 9 25l96 97q9 9 23 9 q6 0 8 -1l194 -53l259 259l-508 279q-14 8 -17 24q-2 16 9 27l128 128q14 13 30 8l665 -159l160 160q76 76 172 108t148 -12z" />
+<glyph unicode="&#xf073;" horiz-adv-x="1664" d="M128 -128h288v288h-288v-288zM480 -128h320v288h-320v-288zM128 224h288v320h-288v-320zM480 224h320v320h-320v-320zM128 608h288v288h-288v-288zM864 -128h320v288h-320v-288zM480 608h320v288h-320v-288zM1248 -128h288v288h-288v-288zM864 224h320v320h-320v-320z M512 1088v288q0 13 -9.5 22.5t-22.5 9.5h-64q-13 0 -22.5 -9.5t-9.5 -22.5v-288q0 -13 9.5 -22.5t22.5 -9.5h64q13 0 22.5 9.5t9.5 22.5zM1248 224h288v320h-288v-320zM864 608h320v288h-320v-288zM1248 608h288v288h-288v-288zM1280 1088v288q0 13 -9.5 22.5t-22.5 9.5h-64 q-13 0 -22.5 -9.5t-9.5 -22.5v-288q0 -13 9.5 -22.5t22.5 -9.5h64q13 0 22.5 9.5t9.5 22.5zM1664 1152v-1280q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h384v96q0 66 47 113t113 47 h64q66 0 113 -47t47 -113v-96h128q52 0 90 -38t38 -90z" />
+<glyph unicode="&#xf074;" horiz-adv-x="1792" d="M666 1055q-60 -92 -137 -273q-22 45 -37 72.5t-40.5 63.5t-51 56.5t-63 35t-81.5 14.5h-224q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h224q250 0 410 -225zM1792 256q0 -14 -9 -23l-320 -320q-9 -9 -23 -9q-13 0 -22.5 9.5t-9.5 22.5v192q-32 0 -85 -0.5t-81 -1t-73 1 t-71 5t-64 10.5t-63 18.5t-58 28.5t-59 40t-55 53.5t-56 69.5q59 93 136 273q22 -45 37 -72.5t40.5 -63.5t51 -56.5t63 -35t81.5 -14.5h256v192q0 14 9 23t23 9q12 0 24 -10l319 -319q9 -9 9 -23zM1792 1152q0 -14 -9 -23l-320 -320q-9 -9 -23 -9q-13 0 -22.5 9.5t-9.5 22.5 v192h-256q-48 0 -87 -15t-69 -45t-51 -61.5t-45 -77.5q-32 -62 -78 -171q-29 -66 -49.5 -111t-54 -105t-64 -100t-74 -83t-90 -68.5t-106.5 -42t-128 -16.5h-224q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h224q48 0 87 15t69 45t51 61.5t45 77.5q32 62 78 171q29 66 49.5 111 t54 105t64 100t74 83t90 68.5t106.5 42t128 16.5h256v192q0 14 9 23t23 9q12 0 24 -10l319 -319q9 -9 9 -23z" />
+<glyph unicode="&#xf075;" horiz-adv-x="1792" d="M1792 640q0 -174 -120 -321.5t-326 -233t-450 -85.5q-70 0 -145 8q-198 -175 -460 -242q-49 -14 -114 -22q-17 -2 -30.5 9t-17.5 29v1q-3 4 -0.5 12t2 10t4.5 9.5l6 9t7 8.5t8 9q7 8 31 34.5t34.5 38t31 39.5t32.5 51t27 59t26 76q-157 89 -247.5 220t-90.5 281 q0 130 71 248.5t191 204.5t286 136.5t348 50.5q244 0 450 -85.5t326 -233t120 -321.5z" />
+<glyph unicode="&#xf076;" d="M1536 704v-128q0 -201 -98.5 -362t-274 -251.5t-395.5 -90.5t-395.5 90.5t-274 251.5t-98.5 362v128q0 26 19 45t45 19h384q26 0 45 -19t19 -45v-128q0 -52 23.5 -90t53.5 -57t71 -30t64 -13t44 -2t44 2t64 13t71 30t53.5 57t23.5 90v128q0 26 19 45t45 19h384 q26 0 45 -19t19 -45zM512 1344v-384q0 -26 -19 -45t-45 -19h-384q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h384q26 0 45 -19t19 -45zM1536 1344v-384q0 -26 -19 -45t-45 -19h-384q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h384q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf077;" horiz-adv-x="1792" d="M1683 205l-166 -165q-19 -19 -45 -19t-45 19l-531 531l-531 -531q-19 -19 -45 -19t-45 19l-166 165q-19 19 -19 45.5t19 45.5l742 741q19 19 45 19t45 -19l742 -741q19 -19 19 -45.5t-19 -45.5z" />
+<glyph unicode="&#xf078;" horiz-adv-x="1792" d="M1683 728l-742 -741q-19 -19 -45 -19t-45 19l-742 741q-19 19 -19 45.5t19 45.5l166 165q19 19 45 19t45 -19l531 -531l531 531q19 19 45 19t45 -19l166 -165q19 -19 19 -45.5t-19 -45.5z" />
+<glyph unicode="&#xf079;" horiz-adv-x="1920" d="M1280 32q0 -13 -9.5 -22.5t-22.5 -9.5h-960q-8 0 -13.5 2t-9 7t-5.5 8t-3 11.5t-1 11.5v13v11v160v416h-192q-26 0 -45 19t-19 45q0 24 15 41l320 384q19 22 49 22t49 -22l320 -384q15 -17 15 -41q0 -26 -19 -45t-45 -19h-192v-384h576q16 0 25 -11l160 -192q7 -11 7 -21 zM1920 448q0 -24 -15 -41l-320 -384q-20 -23 -49 -23t-49 23l-320 384q-15 17 -15 41q0 26 19 45t45 19h192v384h-576q-16 0 -25 12l-160 192q-7 9 -7 20q0 13 9.5 22.5t22.5 9.5h960q8 0 13.5 -2t9 -7t5.5 -8t3 -11.5t1 -11.5v-13v-11v-160v-416h192q26 0 45 -19t19 -45z " />
+<glyph unicode="&#xf07a;" horiz-adv-x="1664" d="M640 0q0 -52 -38 -90t-90 -38t-90 38t-38 90t38 90t90 38t90 -38t38 -90zM1536 0q0 -52 -38 -90t-90 -38t-90 38t-38 90t38 90t90 38t90 -38t38 -90zM1664 1088v-512q0 -24 -16.5 -42.5t-40.5 -21.5l-1044 -122q13 -60 13 -70q0 -16 -24 -64h920q26 0 45 -19t19 -45 t-19 -45t-45 -19h-1024q-26 0 -45 19t-19 45q0 11 8 31.5t16 36t21.5 40t15.5 29.5l-177 823h-204q-26 0 -45 19t-19 45t19 45t45 19h256q16 0 28.5 -6.5t19.5 -15.5t13 -24.5t8 -26t5.5 -29.5t4.5 -26h1201q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf07b;" horiz-adv-x="1664" d="M1664 928v-704q0 -92 -66 -158t-158 -66h-1216q-92 0 -158 66t-66 158v960q0 92 66 158t158 66h320q92 0 158 -66t66 -158v-32h672q92 0 158 -66t66 -158z" />
+<glyph unicode="&#xf07c;" horiz-adv-x="1920" d="M1879 584q0 -31 -31 -66l-336 -396q-43 -51 -120.5 -86.5t-143.5 -35.5h-1088q-34 0 -60.5 13t-26.5 43q0 31 31 66l336 396q43 51 120.5 86.5t143.5 35.5h1088q34 0 60.5 -13t26.5 -43zM1536 928v-160h-832q-94 0 -197 -47.5t-164 -119.5l-337 -396l-5 -6q0 4 -0.5 12.5 t-0.5 12.5v960q0 92 66 158t158 66h320q92 0 158 -66t66 -158v-32h544q92 0 158 -66t66 -158z" />
+<glyph unicode="&#xf07d;" horiz-adv-x="768" d="M704 1216q0 -26 -19 -45t-45 -19h-128v-1024h128q26 0 45 -19t19 -45t-19 -45l-256 -256q-19 -19 -45 -19t-45 19l-256 256q-19 19 -19 45t19 45t45 19h128v1024h-128q-26 0 -45 19t-19 45t19 45l256 256q19 19 45 19t45 -19l256 -256q19 -19 19 -45z" />
+<glyph unicode="&#xf07e;" horiz-adv-x="1792" d="M1792 640q0 -26 -19 -45l-256 -256q-19 -19 -45 -19t-45 19t-19 45v128h-1024v-128q0 -26 -19 -45t-45 -19t-45 19l-256 256q-19 19 -19 45t19 45l256 256q19 19 45 19t45 -19t19 -45v-128h1024v128q0 26 19 45t45 19t45 -19l256 -256q19 -19 19 -45z" />
+<glyph unicode="&#xf080;" horiz-adv-x="2048" d="M640 640v-512h-256v512h256zM1024 1152v-1024h-256v1024h256zM2048 0v-128h-2048v1536h128v-1408h1920zM1408 896v-768h-256v768h256zM1792 1280v-1152h-256v1152h256z" />
+<glyph unicode="&#xf081;" d="M1280 926q-56 -25 -121 -34q68 40 93 117q-65 -38 -134 -51q-61 66 -153 66q-87 0 -148.5 -61.5t-61.5 -148.5q0 -29 5 -48q-129 7 -242 65t-192 155q-29 -50 -29 -106q0 -114 91 -175q-47 1 -100 26v-2q0 -75 50 -133.5t123 -72.5q-29 -8 -51 -8q-13 0 -39 4 q21 -63 74.5 -104t121.5 -42q-116 -90 -261 -90q-26 0 -50 3q148 -94 322 -94q112 0 210 35.5t168 95t120.5 137t75 162t24.5 168.5q0 18 -1 27q63 45 105 109zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5 t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf082;" d="M1248 1408q119 0 203.5 -84.5t84.5 -203.5v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-188v595h199l30 232h-229v148q0 56 23.5 84t91.5 28l122 1v207q-63 9 -178 9q-136 0 -217.5 -80t-81.5 -226v-171h-200v-232h200v-595h-532q-119 0 -203.5 84.5t-84.5 203.5v960 q0 119 84.5 203.5t203.5 84.5h960z" />
+<glyph unicode="&#xf083;" horiz-adv-x="1792" d="M928 704q0 14 -9 23t-23 9q-66 0 -113 -47t-47 -113q0 -14 9 -23t23 -9t23 9t9 23q0 40 28 68t68 28q14 0 23 9t9 23zM1152 574q0 -106 -75 -181t-181 -75t-181 75t-75 181t75 181t181 75t181 -75t75 -181zM128 0h1536v128h-1536v-128zM1280 574q0 159 -112.5 271.5 t-271.5 112.5t-271.5 -112.5t-112.5 -271.5t112.5 -271.5t271.5 -112.5t271.5 112.5t112.5 271.5zM256 1216h384v128h-384v-128zM128 1024h1536v118v138h-828l-64 -128h-644v-128zM1792 1280v-1280q0 -53 -37.5 -90.5t-90.5 -37.5h-1536q-53 0 -90.5 37.5t-37.5 90.5v1280 q0 53 37.5 90.5t90.5 37.5h1536q53 0 90.5 -37.5t37.5 -90.5z" />
+<glyph unicode="&#xf084;" horiz-adv-x="1792" d="M832 1024q0 80 -56 136t-136 56t-136 -56t-56 -136q0 -42 19 -83q-41 19 -83 19q-80 0 -136 -56t-56 -136t56 -136t136 -56t136 56t56 136q0 42 -19 83q41 -19 83 -19q80 0 136 56t56 136zM1683 320q0 -17 -49 -66t-66 -49q-9 0 -28.5 16t-36.5 33t-38.5 40t-24.5 26 l-96 -96l220 -220q28 -28 28 -68q0 -42 -39 -81t-81 -39q-40 0 -68 28l-671 671q-176 -131 -365 -131q-163 0 -265.5 102.5t-102.5 265.5q0 160 95 313t248 248t313 95q163 0 265.5 -102.5t102.5 -265.5q0 -189 -131 -365l355 -355l96 96q-3 3 -26 24.5t-40 38.5t-33 36.5 t-16 28.5q0 17 49 66t66 49q13 0 23 -10q6 -6 46 -44.5t82 -79.5t86.5 -86t73 -78t28.5 -41z" />
+<glyph unicode="&#xf085;" horiz-adv-x="1920" d="M896 640q0 106 -75 181t-181 75t-181 -75t-75 -181t75 -181t181 -75t181 75t75 181zM1664 128q0 52 -38 90t-90 38t-90 -38t-38 -90q0 -53 37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1664 1152q0 52 -38 90t-90 38t-90 -38t-38 -90q0 -53 37.5 -90.5t90.5 -37.5 t90.5 37.5t37.5 90.5zM1280 731v-185q0 -10 -7 -19.5t-16 -10.5l-155 -24q-11 -35 -32 -76q34 -48 90 -115q7 -10 7 -20q0 -12 -7 -19q-23 -30 -82.5 -89.5t-78.5 -59.5q-11 0 -21 7l-115 90q-37 -19 -77 -31q-11 -108 -23 -155q-7 -24 -30 -24h-186q-11 0 -20 7.5t-10 17.5 l-23 153q-34 10 -75 31l-118 -89q-7 -7 -20 -7q-11 0 -21 8q-144 133 -144 160q0 9 7 19q10 14 41 53t47 61q-23 44 -35 82l-152 24q-10 1 -17 9.5t-7 19.5v185q0 10 7 19.5t16 10.5l155 24q11 35 32 76q-34 48 -90 115q-7 11 -7 20q0 12 7 20q22 30 82 89t79 59q11 0 21 -7 l115 -90q34 18 77 32q11 108 23 154q7 24 30 24h186q11 0 20 -7.5t10 -17.5l23 -153q34 -10 75 -31l118 89q8 7 20 7q11 0 21 -8q144 -133 144 -160q0 -9 -7 -19q-12 -16 -42 -54t-45 -60q23 -48 34 -82l152 -23q10 -2 17 -10.5t7 -19.5zM1920 198v-140q0 -16 -149 -31 q-12 -27 -30 -52q51 -113 51 -138q0 -4 -4 -7q-122 -71 -124 -71q-8 0 -46 47t-52 68q-20 -2 -30 -2t-30 2q-14 -21 -52 -68t-46 -47q-2 0 -124 71q-4 3 -4 7q0 25 51 138q-18 25 -30 52q-149 15 -149 31v140q0 16 149 31q13 29 30 52q-51 113 -51 138q0 4 4 7q4 2 35 20 t59 34t30 16q8 0 46 -46.5t52 -67.5q20 2 30 2t30 -2q51 71 92 112l6 2q4 0 124 -70q4 -3 4 -7q0 -25 -51 -138q17 -23 30 -52q149 -15 149 -31zM1920 1222v-140q0 -16 -149 -31q-12 -27 -30 -52q51 -113 51 -138q0 -4 -4 -7q-122 -71 -124 -71q-8 0 -46 47t-52 68 q-20 -2 -30 -2t-30 2q-14 -21 -52 -68t-46 -47q-2 0 -124 71q-4 3 -4 7q0 25 51 138q-18 25 -30 52q-149 15 -149 31v140q0 16 149 31q13 29 30 52q-51 113 -51 138q0 4 4 7q4 2 35 20t59 34t30 16q8 0 46 -46.5t52 -67.5q20 2 30 2t30 -2q51 71 92 112l6 2q4 0 124 -70 q4 -3 4 -7q0 -25 -51 -138q17 -23 30 -52q149 -15 149 -31z" />
+<glyph unicode="&#xf086;" horiz-adv-x="1792" d="M1408 768q0 -139 -94 -257t-256.5 -186.5t-353.5 -68.5q-86 0 -176 16q-124 -88 -278 -128q-36 -9 -86 -16h-3q-11 0 -20.5 8t-11.5 21q-1 3 -1 6.5t0.5 6.5t2 6l2.5 5t3.5 5.5t4 5t4.5 5t4 4.5q5 6 23 25t26 29.5t22.5 29t25 38.5t20.5 44q-124 72 -195 177t-71 224 q0 139 94 257t256.5 186.5t353.5 68.5t353.5 -68.5t256.5 -186.5t94 -257zM1792 512q0 -120 -71 -224.5t-195 -176.5q10 -24 20.5 -44t25 -38.5t22.5 -29t26 -29.5t23 -25q1 -1 4 -4.5t4.5 -5t4 -5t3.5 -5.5l2.5 -5t2 -6t0.5 -6.5t-1 -6.5q-3 -14 -13 -22t-22 -7 q-50 7 -86 16q-154 40 -278 128q-90 -16 -176 -16q-271 0 -472 132q58 -4 88 -4q161 0 309 45t264 129q125 92 192 212t67 254q0 77 -23 152q129 -71 204 -178t75 -230z" />
+<glyph unicode="&#xf087;" d="M256 192q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1408 768q0 51 -39 89.5t-89 38.5h-352q0 58 48 159.5t48 160.5q0 98 -32 145t-128 47q-26 -26 -38 -85t-30.5 -125.5t-59.5 -109.5q-22 -23 -77 -91q-4 -5 -23 -30t-31.5 -41t-34.5 -42.5 t-40 -44t-38.5 -35.5t-40 -27t-35.5 -9h-32v-640h32q13 0 31.5 -3t33 -6.5t38 -11t35 -11.5t35.5 -12.5t29 -10.5q211 -73 342 -73h121q192 0 192 167q0 26 -5 56q30 16 47.5 52.5t17.5 73.5t-18 69q53 50 53 119q0 25 -10 55.5t-25 47.5q32 1 53.5 47t21.5 81zM1536 769 q0 -89 -49 -163q9 -33 9 -69q0 -77 -38 -144q3 -21 3 -43q0 -101 -60 -178q1 -139 -85 -219.5t-227 -80.5h-36h-93q-96 0 -189.5 22.5t-216.5 65.5q-116 40 -138 40h-288q-53 0 -90.5 37.5t-37.5 90.5v640q0 53 37.5 90.5t90.5 37.5h274q36 24 137 155q58 75 107 128 q24 25 35.5 85.5t30.5 126.5t62 108q39 37 90 37q84 0 151 -32.5t102 -101.5t35 -186q0 -93 -48 -192h176q104 0 180 -76t76 -179z" />
+<glyph unicode="&#xf088;" d="M256 1088q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1408 512q0 35 -21.5 81t-53.5 47q15 17 25 47.5t10 55.5q0 69 -53 119q18 32 18 69t-17.5 73.5t-47.5 52.5q5 30 5 56q0 85 -49 126t-136 41h-128q-131 0 -342 -73q-5 -2 -29 -10.5 t-35.5 -12.5t-35 -11.5t-38 -11t-33 -6.5t-31.5 -3h-32v-640h32q16 0 35.5 -9t40 -27t38.5 -35.5t40 -44t34.5 -42.5t31.5 -41t23 -30q55 -68 77 -91q41 -43 59.5 -109.5t30.5 -125.5t38 -85q96 0 128 47t32 145q0 59 -48 160.5t-48 159.5h352q50 0 89 38.5t39 89.5z M1536 511q0 -103 -76 -179t-180 -76h-176q48 -99 48 -192q0 -118 -35 -186q-35 -69 -102 -101.5t-151 -32.5q-51 0 -90 37q-34 33 -54 82t-25.5 90.5t-17.5 84.5t-31 64q-48 50 -107 127q-101 131 -137 155h-274q-53 0 -90.5 37.5t-37.5 90.5v640q0 53 37.5 90.5t90.5 37.5 h288q22 0 138 40q128 44 223 66t200 22h112q140 0 226.5 -79t85.5 -216v-5q60 -77 60 -178q0 -22 -3 -43q38 -67 38 -144q0 -36 -9 -69q49 -74 49 -163z" />
+<glyph unicode="&#xf089;" horiz-adv-x="896" d="M832 1504v-1339l-449 -236q-22 -12 -40 -12q-21 0 -31.5 14.5t-10.5 35.5q0 6 2 20l86 500l-364 354q-25 27 -25 48q0 37 56 46l502 73l225 455q19 41 49 41z" />
+<glyph unicode="&#xf08a;" horiz-adv-x="1792" d="M1664 940q0 81 -21.5 143t-55 98.5t-81.5 59.5t-94 31t-98 8t-112 -25.5t-110.5 -64t-86.5 -72t-60 -61.5q-18 -22 -49 -22t-49 22q-24 28 -60 61.5t-86.5 72t-110.5 64t-112 25.5t-98 -8t-94 -31t-81.5 -59.5t-55 -98.5t-21.5 -143q0 -168 187 -355l581 -560l580 559 q188 188 188 356zM1792 940q0 -221 -229 -450l-623 -600q-18 -18 -44 -18t-44 18l-624 602q-10 8 -27.5 26t-55.5 65.5t-68 97.5t-53.5 121t-23.5 138q0 220 127 344t351 124q62 0 126.5 -21.5t120 -58t95.5 -68.5t76 -68q36 36 76 68t95.5 68.5t120 58t126.5 21.5 q224 0 351 -124t127 -344z" />
+<glyph unicode="&#xf08b;" horiz-adv-x="1664" d="M640 96q0 -4 1 -20t0.5 -26.5t-3 -23.5t-10 -19.5t-20.5 -6.5h-320q-119 0 -203.5 84.5t-84.5 203.5v704q0 119 84.5 203.5t203.5 84.5h320q13 0 22.5 -9.5t9.5 -22.5q0 -4 1 -20t0.5 -26.5t-3 -23.5t-10 -19.5t-20.5 -6.5h-320q-66 0 -113 -47t-47 -113v-704 q0 -66 47 -113t113 -47h288h11h13t11.5 -1t11.5 -3t8 -5.5t7 -9t2 -13.5zM1568 640q0 -26 -19 -45l-544 -544q-19 -19 -45 -19t-45 19t-19 45v288h-448q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h448v288q0 26 19 45t45 19t45 -19l544 -544q19 -19 19 -45z" />
+<glyph unicode="&#xf08c;" d="M237 122h231v694h-231v-694zM483 1030q-1 52 -36 86t-93 34t-94.5 -34t-36.5 -86q0 -51 35.5 -85.5t92.5 -34.5h1q59 0 95 34.5t36 85.5zM1068 122h231v398q0 154 -73 233t-193 79q-136 0 -209 -117h2v101h-231q3 -66 0 -694h231v388q0 38 7 56q15 35 45 59.5t74 24.5 q116 0 116 -157v-371zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf08d;" horiz-adv-x="1152" d="M480 672v448q0 14 -9 23t-23 9t-23 -9t-9 -23v-448q0 -14 9 -23t23 -9t23 9t9 23zM1152 320q0 -26 -19 -45t-45 -19h-429l-51 -483q-2 -12 -10.5 -20.5t-20.5 -8.5h-1q-27 0 -32 27l-76 485h-404q-26 0 -45 19t-19 45q0 123 78.5 221.5t177.5 98.5v512q-52 0 -90 38 t-38 90t38 90t90 38h640q52 0 90 -38t38 -90t-38 -90t-90 -38v-512q99 0 177.5 -98.5t78.5 -221.5z" />
+<glyph unicode="&#xf08e;" horiz-adv-x="1792" d="M1408 608v-320q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h704q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-704q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832q66 0 113 47t47 113v320 q0 14 9 23t23 9h64q14 0 23 -9t9 -23zM1792 1472v-512q0 -26 -19 -45t-45 -19t-45 19l-176 176l-652 -652q-10 -10 -23 -10t-23 10l-114 114q-10 10 -10 23t10 23l652 652l-176 176q-19 19 -19 45t19 45t45 19h512q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf090;" d="M1184 640q0 -26 -19 -45l-544 -544q-19 -19 -45 -19t-45 19t-19 45v288h-448q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h448v288q0 26 19 45t45 19t45 -19l544 -544q19 -19 19 -45zM1536 992v-704q0 -119 -84.5 -203.5t-203.5 -84.5h-320q-13 0 -22.5 9.5t-9.5 22.5 q0 4 -1 20t-0.5 26.5t3 23.5t10 19.5t20.5 6.5h320q66 0 113 47t47 113v704q0 66 -47 113t-113 47h-288h-11h-13t-11.5 1t-11.5 3t-8 5.5t-7 9t-2 13.5q0 4 -1 20t-0.5 26.5t3 23.5t10 19.5t20.5 6.5h320q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf091;" horiz-adv-x="1664" d="M458 653q-74 162 -74 371h-256v-96q0 -78 94.5 -162t235.5 -113zM1536 928v96h-256q0 -209 -74 -371q141 29 235.5 113t94.5 162zM1664 1056v-128q0 -71 -41.5 -143t-112 -130t-173 -97.5t-215.5 -44.5q-42 -54 -95 -95q-38 -34 -52.5 -72.5t-14.5 -89.5q0 -54 30.5 -91 t97.5 -37q75 0 133.5 -45.5t58.5 -114.5v-64q0 -14 -9 -23t-23 -9h-832q-14 0 -23 9t-9 23v64q0 69 58.5 114.5t133.5 45.5q67 0 97.5 37t30.5 91q0 51 -14.5 89.5t-52.5 72.5q-53 41 -95 95q-113 5 -215.5 44.5t-173 97.5t-112 130t-41.5 143v128q0 40 28 68t68 28h288v96 q0 66 47 113t113 47h576q66 0 113 -47t47 -113v-96h288q40 0 68 -28t28 -68z" />
+<glyph unicode="&#xf092;" d="M519 336q4 6 -3 13q-9 7 -14 2q-4 -6 3 -13q9 -7 14 -2zM491 377q-5 7 -12 4q-6 -4 0 -12q7 -8 12 -5q6 4 0 13zM450 417q2 4 -5 8q-7 2 -8 -2q-3 -5 4 -8q8 -2 9 2zM471 394q2 1 1.5 4.5t-3.5 5.5q-6 7 -10 3t1 -11q6 -6 11 -2zM557 319q2 7 -9 11q-9 3 -13 -4 q-2 -7 9 -11q9 -3 13 4zM599 316q0 8 -12 8q-10 0 -10 -8t11 -8t11 8zM638 323q-2 7 -13 5t-9 -9q2 -8 12 -6t10 10zM1280 640q0 212 -150 362t-362 150t-362 -150t-150 -362q0 -167 98 -300.5t252 -185.5q18 -3 26.5 5t8.5 20q0 52 -1 95q-6 -1 -15.5 -2.5t-35.5 -2t-48 4 t-43.5 20t-29.5 41.5q-23 59 -57 74q-2 1 -4.5 3.5l-8 8t-7 9.5t4 7.5t19.5 3.5q6 0 15 -2t30 -15.5t33 -35.5q16 -28 37.5 -42t43.5 -14t38 3.5t30 9.5q7 47 33 69q-49 6 -86 18.5t-73 39t-55.5 76t-19.5 119.5q0 79 53 137q-24 62 5 136q19 6 54.5 -7.5t60.5 -29.5l26 -16 q58 17 128 17t128 -17q11 7 28.5 18t55.5 26t57 9q29 -74 5 -136q53 -58 53 -137q0 -57 -14 -100.5t-35.5 -70t-53.5 -44.5t-62.5 -26t-68.5 -12q35 -31 35 -95q0 -40 -0.5 -89t-0.5 -51q0 -12 8.5 -20t26.5 -5q154 52 252 185.5t98 300.5zM1536 1120v-960 q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf093;" horiz-adv-x="1664" d="M1280 64q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1536 64q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1664 288v-320q0 -40 -28 -68t-68 -28h-1472q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h427q21 -56 70.5 -92 t110.5 -36h256q61 0 110.5 36t70.5 92h427q40 0 68 -28t28 -68zM1339 936q-17 -40 -59 -40h-256v-448q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v448h-256q-42 0 -59 40q-17 39 14 69l448 448q18 19 45 19t45 -19l448 -448q31 -30 14 -69z" />
+<glyph unicode="&#xf094;" d="M1407 710q0 44 -7 113.5t-18 96.5q-12 30 -17 44t-9 36.5t-4 48.5q0 23 5 68.5t5 67.5q0 37 -10 55q-4 1 -13 1q-19 0 -58 -4.5t-59 -4.5q-60 0 -176 24t-175 24q-43 0 -94.5 -11.5t-85 -23.5t-89.5 -34q-137 -54 -202 -103q-96 -73 -159.5 -189.5t-88 -236t-24.5 -248.5 q0 -40 12.5 -120t12.5 -121q0 -23 -11 -66.5t-11 -65.5t12 -36.5t34 -14.5q24 0 72.5 11t73.5 11q57 0 169.5 -15.5t169.5 -15.5q181 0 284 36q129 45 235.5 152.5t166 245.5t59.5 275zM1535 712q0 -165 -70 -327.5t-196 -288t-281 -180.5q-124 -44 -326 -44 q-57 0 -170 14.5t-169 14.5q-24 0 -72.5 -14.5t-73.5 -14.5q-73 0 -123.5 55.5t-50.5 128.5q0 24 11 68t11 67q0 40 -12.5 120.5t-12.5 121.5q0 111 18 217.5t54.5 209.5t100.5 194t150 156q78 59 232 120q194 78 316 78q60 0 175.5 -24t173.5 -24q19 0 57 5t58 5 q81 0 118 -50.5t37 -134.5q0 -23 -5 -68t-5 -68q0 -10 1 -18.5t3 -17t4 -13.5t6.5 -16t6.5 -17q16 -40 25 -118.5t9 -136.5z" />
+<glyph unicode="&#xf095;" horiz-adv-x="1408" d="M1408 296q0 -27 -10 -70.5t-21 -68.5q-21 -50 -122 -106q-94 -51 -186 -51q-27 0 -52.5 3.5t-57.5 12.5t-47.5 14.5t-55.5 20.5t-49 18q-98 35 -175 83q-128 79 -264.5 215.5t-215.5 264.5q-48 77 -83 175q-3 9 -18 49t-20.5 55.5t-14.5 47.5t-12.5 57.5t-3.5 52.5 q0 92 51 186q56 101 106 122q25 11 68.5 21t70.5 10q14 0 21 -3q18 -6 53 -76q11 -19 30 -54t35 -63.5t31 -53.5q3 -4 17.5 -25t21.5 -35.5t7 -28.5q0 -20 -28.5 -50t-62 -55t-62 -53t-28.5 -46q0 -9 5 -22.5t8.5 -20.5t14 -24t11.5 -19q76 -137 174 -235t235 -174 q2 -1 19 -11.5t24 -14t20.5 -8.5t22.5 -5q18 0 46 28.5t53 62t55 62t50 28.5q14 0 28.5 -7t35.5 -21.5t25 -17.5q25 -15 53.5 -31t63.5 -35t54 -30q70 -35 76 -53q3 -7 3 -21z" />
+<glyph unicode="&#xf096;" horiz-adv-x="1408" d="M1120 1280h-832q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832q66 0 113 47t47 113v832q0 66 -47 113t-113 47zM1408 1120v-832q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h832 q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf097;" horiz-adv-x="1280" d="M1152 1280h-1024v-1242l423 406l89 85l89 -85l423 -406v1242zM1164 1408q23 0 44 -9q33 -13 52.5 -41t19.5 -62v-1289q0 -34 -19.5 -62t-52.5 -41q-19 -8 -44 -8q-48 0 -83 32l-441 424l-441 -424q-36 -33 -83 -33q-23 0 -44 9q-33 13 -52.5 41t-19.5 62v1289 q0 34 19.5 62t52.5 41q21 9 44 9h1048z" />
+<glyph unicode="&#xf098;" d="M1280 343q0 11 -2 16q-3 8 -38.5 29.5t-88.5 49.5l-53 29q-5 3 -19 13t-25 15t-21 5q-18 0 -47 -32.5t-57 -65.5t-44 -33q-7 0 -16.5 3.5t-15.5 6.5t-17 9.5t-14 8.5q-99 55 -170.5 126.5t-126.5 170.5q-2 3 -8.5 14t-9.5 17t-6.5 15.5t-3.5 16.5q0 13 20.5 33.5t45 38.5 t45 39.5t20.5 36.5q0 10 -5 21t-15 25t-13 19q-3 6 -15 28.5t-25 45.5t-26.5 47.5t-25 40.5t-16.5 18t-16 2q-48 0 -101 -22q-46 -21 -80 -94.5t-34 -130.5q0 -16 2.5 -34t5 -30.5t9 -33t10 -29.5t12.5 -33t11 -30q60 -164 216.5 -320.5t320.5 -216.5q6 -2 30 -11t33 -12.5 t29.5 -10t33 -9t30.5 -5t34 -2.5q57 0 130.5 34t94.5 80q22 53 22 101zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf099;" horiz-adv-x="1664" d="M1620 1128q-67 -98 -162 -167q1 -14 1 -42q0 -130 -38 -259.5t-115.5 -248.5t-184.5 -210.5t-258 -146t-323 -54.5q-271 0 -496 145q35 -4 78 -4q225 0 401 138q-105 2 -188 64.5t-114 159.5q33 -5 61 -5q43 0 85 11q-112 23 -185.5 111.5t-73.5 205.5v4q68 -38 146 -41 q-66 44 -105 115t-39 154q0 88 44 163q121 -149 294.5 -238.5t371.5 -99.5q-8 38 -8 74q0 134 94.5 228.5t228.5 94.5q140 0 236 -102q109 21 205 78q-37 -115 -142 -178q93 10 186 50z" />
+<glyph unicode="&#xf09a;" horiz-adv-x="1024" d="M959 1524v-264h-157q-86 0 -116 -36t-30 -108v-189h293l-39 -296h-254v-759h-306v759h-255v296h255v218q0 186 104 288.5t277 102.5q147 0 228 -12z" />
+<glyph unicode="&#xf09b;" d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5q0 -251 -146.5 -451.5t-378.5 -277.5q-27 -5 -40 7t-13 30q0 3 0.5 76.5t0.5 134.5q0 97 -52 142q57 6 102.5 18t94 39t81 66.5t53 105t20.5 150.5q0 119 -79 206q37 91 -8 204q-28 9 -81 -11t-92 -44l-38 -24 q-93 26 -192 26t-192 -26q-16 11 -42.5 27t-83.5 38.5t-85 13.5q-45 -113 -8 -204q-79 -87 -79 -206q0 -85 20.5 -150t52.5 -105t80.5 -67t94 -39t102.5 -18q-39 -36 -49 -103q-21 -10 -45 -15t-57 -5t-65.5 21.5t-55.5 62.5q-19 32 -48.5 52t-49.5 24l-20 3q-21 0 -29 -4.5 t-5 -11.5t9 -14t13 -12l7 -5q22 -10 43.5 -38t31.5 -51l10 -23q13 -38 44 -61.5t67 -30t69.5 -7t55.5 3.5l23 4q0 -38 0.5 -88.5t0.5 -54.5q0 -18 -13 -30t-40 -7q-232 77 -378.5 277.5t-146.5 451.5q0 209 103 385.5t279.5 279.5t385.5 103zM291 305q3 7 -7 12 q-10 3 -13 -2q-3 -7 7 -12q9 -6 13 2zM322 271q7 5 -2 16q-10 9 -16 3q-7 -5 2 -16q10 -10 16 -3zM352 226q9 7 0 19q-8 13 -17 6q-9 -5 0 -18t17 -7zM394 184q8 8 -4 19q-12 12 -20 3q-9 -8 4 -19q12 -12 20 -3zM451 159q3 11 -13 16q-15 4 -19 -7t13 -15q15 -6 19 6z M514 154q0 13 -17 11q-16 0 -16 -11q0 -13 17 -11q16 0 16 11zM572 164q-2 11 -18 9q-16 -3 -14 -15t18 -8t14 14z" />
+<glyph unicode="&#xf09c;" horiz-adv-x="1664" d="M1664 960v-256q0 -26 -19 -45t-45 -19h-64q-26 0 -45 19t-19 45v256q0 106 -75 181t-181 75t-181 -75t-75 -181v-192h96q40 0 68 -28t28 -68v-576q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v576q0 40 28 68t68 28h672v192q0 185 131.5 316.5t316.5 131.5 t316.5 -131.5t131.5 -316.5z" />
+<glyph unicode="&#xf09d;" horiz-adv-x="1920" d="M1760 1408q66 0 113 -47t47 -113v-1216q0 -66 -47 -113t-113 -47h-1600q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1600zM160 1280q-13 0 -22.5 -9.5t-9.5 -22.5v-224h1664v224q0 13 -9.5 22.5t-22.5 9.5h-1600zM1760 0q13 0 22.5 9.5t9.5 22.5v608h-1664v-608 q0 -13 9.5 -22.5t22.5 -9.5h1600zM256 128v128h256v-128h-256zM640 128v128h384v-128h-384z" />
+<glyph unicode="&#xf09e;" horiz-adv-x="1408" d="M384 192q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM896 69q2 -28 -17 -48q-18 -21 -47 -21h-135q-25 0 -43 16.5t-20 41.5q-22 229 -184.5 391.5t-391.5 184.5q-25 2 -41.5 20t-16.5 43v135q0 29 21 47q17 17 43 17h5q160 -13 306 -80.5 t259 -181.5q114 -113 181.5 -259t80.5 -306zM1408 67q2 -27 -18 -47q-18 -20 -46 -20h-143q-26 0 -44.5 17.5t-19.5 42.5q-12 215 -101 408.5t-231.5 336t-336 231.5t-408.5 102q-25 1 -42.5 19.5t-17.5 43.5v143q0 28 20 46q18 18 44 18h3q262 -13 501.5 -120t425.5 -294 q187 -186 294 -425.5t120 -501.5z" />
+<glyph unicode="&#xf0a0;" d="M1040 320q0 -33 -23.5 -56.5t-56.5 -23.5t-56.5 23.5t-23.5 56.5t23.5 56.5t56.5 23.5t56.5 -23.5t23.5 -56.5zM1296 320q0 -33 -23.5 -56.5t-56.5 -23.5t-56.5 23.5t-23.5 56.5t23.5 56.5t56.5 23.5t56.5 -23.5t23.5 -56.5zM1408 160v320q0 13 -9.5 22.5t-22.5 9.5 h-1216q-13 0 -22.5 -9.5t-9.5 -22.5v-320q0 -13 9.5 -22.5t22.5 -9.5h1216q13 0 22.5 9.5t9.5 22.5zM178 640h1180l-157 482q-4 13 -16 21.5t-26 8.5h-782q-14 0 -26 -8.5t-16 -21.5zM1536 480v-320q0 -66 -47 -113t-113 -47h-1216q-66 0 -113 47t-47 113v320q0 25 16 75 l197 606q17 53 63 86t101 33h782q55 0 101 -33t63 -86l197 -606q16 -50 16 -75z" />
+<glyph unicode="&#xf0a1;" horiz-adv-x="1792" d="M1664 896q53 0 90.5 -37.5t37.5 -90.5t-37.5 -90.5t-90.5 -37.5v-384q0 -52 -38 -90t-90 -38q-417 347 -812 380q-58 -19 -91 -66t-31 -100.5t40 -92.5q-20 -33 -23 -65.5t6 -58t33.5 -55t48 -50t61.5 -50.5q-29 -58 -111.5 -83t-168.5 -11.5t-132 55.5q-7 23 -29.5 87.5 t-32 94.5t-23 89t-15 101t3.5 98.5t22 110.5h-122q-66 0 -113 47t-47 113v192q0 66 47 113t113 47h480q435 0 896 384q52 0 90 -38t38 -90v-384zM1536 292v954q-394 -302 -768 -343v-270q377 -42 768 -341z" />
+<glyph unicode="&#xf0a2;" horiz-adv-x="1792" d="M912 -160q0 16 -16 16q-59 0 -101.5 42.5t-42.5 101.5q0 16 -16 16t-16 -16q0 -73 51.5 -124.5t124.5 -51.5q16 0 16 16zM246 128h1300q-266 300 -266 832q0 51 -24 105t-69 103t-121.5 80.5t-169.5 31.5t-169.5 -31.5t-121.5 -80.5t-69 -103t-24 -105q0 -532 -266 -832z M1728 128q0 -52 -38 -90t-90 -38h-448q0 -106 -75 -181t-181 -75t-181 75t-75 181h-448q-52 0 -90 38t-38 90q50 42 91 88t85 119.5t74.5 158.5t50 206t19.5 260q0 152 117 282.5t307 158.5q-8 19 -8 39q0 40 28 68t68 28t68 -28t28 -68q0 -20 -8 -39q190 -28 307 -158.5 t117 -282.5q0 -139 19.5 -260t50 -206t74.5 -158.5t85 -119.5t91 -88z" />
+<glyph unicode="&#xf0a3;" d="M1376 640l138 -135q30 -28 20 -70q-12 -41 -52 -51l-188 -48l53 -186q12 -41 -19 -70q-29 -31 -70 -19l-186 53l-48 -188q-10 -40 -51 -52q-12 -2 -19 -2q-31 0 -51 22l-135 138l-135 -138q-28 -30 -70 -20q-41 11 -51 52l-48 188l-186 -53q-41 -12 -70 19q-31 29 -19 70 l53 186l-188 48q-40 10 -52 51q-10 42 20 70l138 135l-138 135q-30 28 -20 70q12 41 52 51l188 48l-53 186q-12 41 19 70q29 31 70 19l186 -53l48 188q10 41 51 51q41 12 70 -19l135 -139l135 139q29 30 70 19q41 -10 51 -51l48 -188l186 53q41 12 70 -19q31 -29 19 -70 l-53 -186l188 -48q40 -10 52 -51q10 -42 -20 -70z" />
+<glyph unicode="&#xf0a4;" horiz-adv-x="1792" d="M256 192q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1664 768q0 51 -39 89.5t-89 38.5h-576q0 20 15 48.5t33 55t33 68t15 84.5q0 67 -44.5 97.5t-115.5 30.5q-24 0 -90 -139q-24 -44 -37 -65q-40 -64 -112 -145q-71 -81 -101 -106 q-69 -57 -140 -57h-32v-640h32q72 0 167 -32t193.5 -64t179.5 -32q189 0 189 167q0 26 -5 56q30 16 47.5 52.5t17.5 73.5t-18 69q53 50 53 119q0 25 -10 55.5t-25 47.5h331q52 0 90 38t38 90zM1792 769q0 -105 -75.5 -181t-180.5 -76h-169q-4 -62 -37 -119q3 -21 3 -43 q0 -101 -60 -178q1 -139 -85 -219.5t-227 -80.5q-133 0 -322 69q-164 59 -223 59h-288q-53 0 -90.5 37.5t-37.5 90.5v640q0 53 37.5 90.5t90.5 37.5h288q10 0 21.5 4.5t23.5 14t22.5 18t24 22.5t20.5 21.5t19 21.5t14 17q65 74 100 129q13 21 33 62t37 72t40.5 63t55 49.5 t69.5 17.5q125 0 206.5 -67t81.5 -189q0 -68 -22 -128h374q104 0 180 -76t76 -179z" />
+<glyph unicode="&#xf0a5;" horiz-adv-x="1792" d="M1376 128h32v640h-32q-35 0 -67.5 12t-62.5 37t-50 46t-49 54q-2 3 -3.5 4.5t-4 4.5t-4.5 5q-72 81 -112 145q-14 22 -38 68q-1 3 -10.5 22.5t-18.5 36t-20 35.5t-21.5 30.5t-18.5 11.5q-71 0 -115.5 -30.5t-44.5 -97.5q0 -43 15 -84.5t33 -68t33 -55t15 -48.5h-576 q-50 0 -89 -38.5t-39 -89.5q0 -52 38 -90t90 -38h331q-15 -17 -25 -47.5t-10 -55.5q0 -69 53 -119q-18 -32 -18 -69t17.5 -73.5t47.5 -52.5q-4 -24 -4 -56q0 -85 48.5 -126t135.5 -41q84 0 183 32t194 64t167 32zM1664 192q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45 t45 -19t45 19t19 45zM1792 768v-640q0 -53 -37.5 -90.5t-90.5 -37.5h-288q-59 0 -223 -59q-190 -69 -317 -69q-142 0 -230 77.5t-87 217.5l1 5q-61 76 -61 178q0 22 3 43q-33 57 -37 119h-169q-105 0 -180.5 76t-75.5 181q0 103 76 179t180 76h374q-22 60 -22 128 q0 122 81.5 189t206.5 67q38 0 69.5 -17.5t55 -49.5t40.5 -63t37 -72t33 -62q35 -55 100 -129q2 -3 14 -17t19 -21.5t20.5 -21.5t24 -22.5t22.5 -18t23.5 -14t21.5 -4.5h288q53 0 90.5 -37.5t37.5 -90.5z" />
+<glyph unicode="&#xf0a6;" d="M1280 -64q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1408 700q0 189 -167 189q-26 0 -56 -5q-16 30 -52.5 47.5t-73.5 17.5t-69 -18q-50 53 -119 53q-25 0 -55.5 -10t-47.5 -25v331q0 52 -38 90t-90 38q-51 0 -89.5 -39t-38.5 -89v-576 q-20 0 -48.5 15t-55 33t-68 33t-84.5 15q-67 0 -97.5 -44.5t-30.5 -115.5q0 -24 139 -90q44 -24 65 -37q64 -40 145 -112q81 -71 106 -101q57 -69 57 -140v-32h640v32q0 72 32 167t64 193.5t32 179.5zM1536 705q0 -133 -69 -322q-59 -164 -59 -223v-288q0 -53 -37.5 -90.5 t-90.5 -37.5h-640q-53 0 -90.5 37.5t-37.5 90.5v288q0 10 -4.5 21.5t-14 23.5t-18 22.5t-22.5 24t-21.5 20.5t-21.5 19t-17 14q-74 65 -129 100q-21 13 -62 33t-72 37t-63 40.5t-49.5 55t-17.5 69.5q0 125 67 206.5t189 81.5q68 0 128 -22v374q0 104 76 180t179 76 q105 0 181 -75.5t76 -180.5v-169q62 -4 119 -37q21 3 43 3q101 0 178 -60q139 1 219.5 -85t80.5 -227z" />
+<glyph unicode="&#xf0a7;" d="M1408 576q0 84 -32 183t-64 194t-32 167v32h-640v-32q0 -35 -12 -67.5t-37 -62.5t-46 -50t-54 -49q-9 -8 -14 -12q-81 -72 -145 -112q-22 -14 -68 -38q-3 -1 -22.5 -10.5t-36 -18.5t-35.5 -20t-30.5 -21.5t-11.5 -18.5q0 -71 30.5 -115.5t97.5 -44.5q43 0 84.5 15t68 33 t55 33t48.5 15v-576q0 -50 38.5 -89t89.5 -39q52 0 90 38t38 90v331q46 -35 103 -35q69 0 119 53q32 -18 69 -18t73.5 17.5t52.5 47.5q24 -4 56 -4q85 0 126 48.5t41 135.5zM1280 1344q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1536 580 q0 -142 -77.5 -230t-217.5 -87l-5 1q-76 -61 -178 -61q-22 0 -43 3q-54 -30 -119 -37v-169q0 -105 -76 -180.5t-181 -75.5q-103 0 -179 76t-76 180v374q-54 -22 -128 -22q-121 0 -188.5 81.5t-67.5 206.5q0 38 17.5 69.5t49.5 55t63 40.5t72 37t62 33q55 35 129 100 q3 2 17 14t21.5 19t21.5 20.5t22.5 24t18 22.5t14 23.5t4.5 21.5v288q0 53 37.5 90.5t90.5 37.5h640q53 0 90.5 -37.5t37.5 -90.5v-288q0 -59 59 -223q69 -190 69 -317z" />
+<glyph unicode="&#xf0a8;" d="M1280 576v128q0 26 -19 45t-45 19h-502l189 189q19 19 19 45t-19 45l-91 91q-18 18 -45 18t-45 -18l-362 -362l-91 -91q-18 -18 -18 -45t18 -45l91 -91l362 -362q18 -18 45 -18t45 18l91 91q18 18 18 45t-18 45l-189 189h502q26 0 45 19t19 45zM1536 640 q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf0a9;" d="M1285 640q0 27 -18 45l-91 91l-362 362q-18 18 -45 18t-45 -18l-91 -91q-18 -18 -18 -45t18 -45l189 -189h-502q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h502l-189 -189q-19 -19 -19 -45t19 -45l91 -91q18 -18 45 -18t45 18l362 362l91 91q18 18 18 45zM1536 640 q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf0aa;" d="M1284 641q0 27 -18 45l-362 362l-91 91q-18 18 -45 18t-45 -18l-91 -91l-362 -362q-18 -18 -18 -45t18 -45l91 -91q18 -18 45 -18t45 18l189 189v-502q0 -26 19 -45t45 -19h128q26 0 45 19t19 45v502l189 -189q19 -19 45 -19t45 19l91 91q18 18 18 45zM1536 640 q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf0ab;" d="M1284 639q0 27 -18 45l-91 91q-18 18 -45 18t-45 -18l-189 -189v502q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-502l-189 189q-19 19 -45 19t-45 -19l-91 -91q-18 -18 -18 -45t18 -45l362 -362l91 -91q18 -18 45 -18t45 18l91 91l362 362q18 18 18 45zM1536 640 q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf0ac;" d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM1042 887q-2 -1 -9.5 -9.5t-13.5 -9.5q2 0 4.5 5t5 11t3.5 7q6 7 22 15q14 6 52 12q34 8 51 -11 q-2 2 9.5 13t14.5 12q3 2 15 4.5t15 7.5l2 22q-12 -1 -17.5 7t-6.5 21q0 -2 -6 -8q0 7 -4.5 8t-11.5 -1t-9 -1q-10 3 -15 7.5t-8 16.5t-4 15q-2 5 -9.5 10.5t-9.5 10.5q-1 2 -2.5 5.5t-3 6.5t-4 5.5t-5.5 2.5t-7 -5t-7.5 -10t-4.5 -5q-3 2 -6 1.5t-4.5 -1t-4.5 -3t-5 -3.5 q-3 -2 -8.5 -3t-8.5 -2q15 5 -1 11q-10 4 -16 3q9 4 7.5 12t-8.5 14h5q-1 4 -8.5 8.5t-17.5 8.5t-13 6q-8 5 -34 9.5t-33 0.5q-5 -6 -4.5 -10.5t4 -14t3.5 -12.5q1 -6 -5.5 -13t-6.5 -12q0 -7 14 -15.5t10 -21.5q-3 -8 -16 -16t-16 -12q-5 -8 -1.5 -18.5t10.5 -16.5 q2 -2 1.5 -4t-3.5 -4.5t-5.5 -4t-6.5 -3.5l-3 -2q-11 -5 -20.5 6t-13.5 26q-7 25 -16 30q-23 8 -29 -1q-5 13 -41 26q-25 9 -58 4q6 1 0 15q-7 15 -19 12q3 6 4 17.5t1 13.5q3 13 12 23q1 1 7 8.5t9.5 13.5t0.5 6q35 -4 50 11q5 5 11.5 17t10.5 17q9 6 14 5.5t14.5 -5.5 t14.5 -5q14 -1 15.5 11t-7.5 20q12 -1 3 17q-5 7 -8 9q-12 4 -27 -5q-8 -4 2 -8q-1 1 -9.5 -10.5t-16.5 -17.5t-16 5q-1 1 -5.5 13.5t-9.5 13.5q-8 0 -16 -15q3 8 -11 15t-24 8q19 12 -8 27q-7 4 -20.5 5t-19.5 -4q-5 -7 -5.5 -11.5t5 -8t10.5 -5.5t11.5 -4t8.5 -3 q14 -10 8 -14q-2 -1 -8.5 -3.5t-11.5 -4.5t-6 -4q-3 -4 0 -14t-2 -14q-5 5 -9 17.5t-7 16.5q7 -9 -25 -6l-10 1q-4 0 -16 -2t-20.5 -1t-13.5 8q-4 8 0 20q1 4 4 2q-4 3 -11 9.5t-10 8.5q-46 -15 -94 -41q6 -1 12 1q5 2 13 6.5t10 5.5q34 14 42 7l5 5q14 -16 20 -25 q-7 4 -30 1q-20 -6 -22 -12q7 -12 5 -18q-4 3 -11.5 10t-14.5 11t-15 5q-16 0 -22 -1q-146 -80 -235 -222q7 -7 12 -8q4 -1 5 -9t2.5 -11t11.5 3q9 -8 3 -19q1 1 44 -27q19 -17 21 -21q3 -11 -10 -18q-1 2 -9 9t-9 4q-3 -5 0.5 -18.5t10.5 -12.5q-7 0 -9.5 -16t-2.5 -35.5 t-1 -23.5l2 -1q-3 -12 5.5 -34.5t21.5 -19.5q-13 -3 20 -43q6 -8 8 -9q3 -2 12 -7.5t15 -10t10 -10.5q4 -5 10 -22.5t14 -23.5q-2 -6 9.5 -20t10.5 -23q-1 0 -2.5 -1t-2.5 -1q3 -7 15.5 -14t15.5 -13q1 -3 2 -10t3 -11t8 -2q2 20 -24 62q-15 25 -17 29q-3 5 -5.5 15.5 t-4.5 14.5q2 0 6 -1.5t8.5 -3.5t7.5 -4t2 -3q-3 -7 2 -17.5t12 -18.5t17 -19t12 -13q6 -6 14 -19.5t0 -13.5q9 0 20 -10t17 -20q5 -8 8 -26t5 -24q2 -7 8.5 -13.5t12.5 -9.5l16 -8t13 -7q5 -2 18.5 -10.5t21.5 -11.5q10 -4 16 -4t14.5 2.5t13.5 3.5q15 2 29 -15t21 -21 q36 -19 55 -11q-2 -1 0.5 -7.5t8 -15.5t9 -14.5t5.5 -8.5q5 -6 18 -15t18 -15q6 4 7 9q-3 -8 7 -20t18 -10q14 3 14 32q-31 -15 -49 18q0 1 -2.5 5.5t-4 8.5t-2.5 8.5t0 7.5t5 3q9 0 10 3.5t-2 12.5t-4 13q-1 8 -11 20t-12 15q-5 -9 -16 -8t-16 9q0 -1 -1.5 -5.5t-1.5 -6.5 q-13 0 -15 1q1 3 2.5 17.5t3.5 22.5q1 4 5.5 12t7.5 14.5t4 12.5t-4.5 9.5t-17.5 2.5q-19 -1 -26 -20q-1 -3 -3 -10.5t-5 -11.5t-9 -7q-7 -3 -24 -2t-24 5q-13 8 -22.5 29t-9.5 37q0 10 2.5 26.5t3 25t-5.5 24.5q3 2 9 9.5t10 10.5q2 1 4.5 1.5t4.5 0t4 1.5t3 6q-1 1 -4 3 q-3 3 -4 3q7 -3 28.5 1.5t27.5 -1.5q15 -11 22 2q0 1 -2.5 9.5t-0.5 13.5q5 -27 29 -9q3 -3 15.5 -5t17.5 -5q3 -2 7 -5.5t5.5 -4.5t5 0.5t8.5 6.5q10 -14 12 -24q11 -40 19 -44q7 -3 11 -2t4.5 9.5t0 14t-1.5 12.5l-1 8v18l-1 8q-15 3 -18.5 12t1.5 18.5t15 18.5q1 1 8 3.5 t15.5 6.5t12.5 8q21 19 15 35q7 0 11 9q-1 0 -5 3t-7.5 5t-4.5 2q9 5 2 16q5 3 7.5 11t7.5 10q9 -12 21 -2q7 8 1 16q5 7 20.5 10.5t18.5 9.5q7 -2 8 2t1 12t3 12q4 5 15 9t13 5l17 11q3 4 0 4q18 -2 31 11q10 11 -6 20q3 6 -3 9.5t-15 5.5q3 1 11.5 0.5t10.5 1.5 q15 10 -7 16q-17 5 -43 -12zM879 10q206 36 351 189q-3 3 -12.5 4.5t-12.5 3.5q-18 7 -24 8q1 7 -2.5 13t-8 9t-12.5 8t-11 7q-2 2 -7 6t-7 5.5t-7.5 4.5t-8.5 2t-10 -1l-3 -1q-3 -1 -5.5 -2.5t-5.5 -3t-4 -3t0 -2.5q-21 17 -36 22q-5 1 -11 5.5t-10.5 7t-10 1.5t-11.5 -7 q-5 -5 -6 -15t-2 -13q-7 5 0 17.5t2 18.5q-3 6 -10.5 4.5t-12 -4.5t-11.5 -8.5t-9 -6.5t-8.5 -5.5t-8.5 -7.5q-3 -4 -6 -12t-5 -11q-2 4 -11.5 6.5t-9.5 5.5q2 -10 4 -35t5 -38q7 -31 -12 -48q-27 -25 -29 -40q-4 -22 12 -26q0 -7 -8 -20.5t-7 -21.5q0 -6 2 -16z" />
+<glyph unicode="&#xf0ad;" horiz-adv-x="1664" d="M384 64q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1028 484l-682 -682q-37 -37 -90 -37q-52 0 -91 37l-106 108q-38 36 -38 90q0 53 38 91l681 681q39 -98 114.5 -173.5t173.5 -114.5zM1662 919q0 -39 -23 -106q-47 -134 -164.5 -217.5 t-258.5 -83.5q-185 0 -316.5 131.5t-131.5 316.5t131.5 316.5t316.5 131.5q58 0 121.5 -16.5t107.5 -46.5q16 -11 16 -28t-16 -28l-293 -169v-224l193 -107q5 3 79 48.5t135.5 81t70.5 35.5q15 0 23.5 -10t8.5 -25z" />
+<glyph unicode="&#xf0ae;" horiz-adv-x="1792" d="M1024 128h640v128h-640v-128zM640 640h1024v128h-1024v-128zM1280 1152h384v128h-384v-128zM1792 320v-256q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 832v-256q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19 t-19 45v256q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 1344v-256q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h1664q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf0b0;" horiz-adv-x="1408" d="M1403 1241q17 -41 -14 -70l-493 -493v-742q0 -42 -39 -59q-13 -5 -25 -5q-27 0 -45 19l-256 256q-19 19 -19 45v486l-493 493q-31 29 -14 70q17 39 59 39h1280q42 0 59 -39z" />
+<glyph unicode="&#xf0b1;" horiz-adv-x="1792" d="M640 1280h512v128h-512v-128zM1792 640v-480q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v480h672v-160q0 -26 19 -45t45 -19h320q26 0 45 19t19 45v160h672zM1024 640v-128h-256v128h256zM1792 1120v-384h-1792v384q0 66 47 113t113 47h352v160q0 40 28 68 t68 28h576q40 0 68 -28t28 -68v-160h352q66 0 113 -47t47 -113z" />
+<glyph unicode="&#xf0b2;" d="M1283 995l-355 -355l355 -355l144 144q29 31 70 14q39 -17 39 -59v-448q0 -26 -19 -45t-45 -19h-448q-42 0 -59 40q-17 39 14 69l144 144l-355 355l-355 -355l144 -144q31 -30 14 -69q-17 -40 -59 -40h-448q-26 0 -45 19t-19 45v448q0 42 40 59q39 17 69 -14l144 -144 l355 355l-355 355l-144 -144q-19 -19 -45 -19q-12 0 -24 5q-40 17 -40 59v448q0 26 19 45t45 19h448q42 0 59 -40q17 -39 -14 -69l-144 -144l355 -355l355 355l-144 144q-31 30 -14 69q17 40 59 40h448q26 0 45 -19t19 -45v-448q0 -42 -39 -59q-13 -5 -25 -5q-26 0 -45 19z " />
+<glyph unicode="&#xf0c0;" horiz-adv-x="1920" d="M593 640q-162 -5 -265 -128h-134q-82 0 -138 40.5t-56 118.5q0 353 124 353q6 0 43.5 -21t97.5 -42.5t119 -21.5q67 0 133 23q-5 -37 -5 -66q0 -139 81 -256zM1664 3q0 -120 -73 -189.5t-194 -69.5h-874q-121 0 -194 69.5t-73 189.5q0 53 3.5 103.5t14 109t26.5 108.5 t43 97.5t62 81t85.5 53.5t111.5 20q10 0 43 -21.5t73 -48t107 -48t135 -21.5t135 21.5t107 48t73 48t43 21.5q61 0 111.5 -20t85.5 -53.5t62 -81t43 -97.5t26.5 -108.5t14 -109t3.5 -103.5zM640 1280q0 -106 -75 -181t-181 -75t-181 75t-75 181t75 181t181 75t181 -75 t75 -181zM1344 896q0 -159 -112.5 -271.5t-271.5 -112.5t-271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5t271.5 -112.5t112.5 -271.5zM1920 671q0 -78 -56 -118.5t-138 -40.5h-134q-103 123 -265 128q81 117 81 256q0 29 -5 66q66 -23 133 -23q59 0 119 21.5t97.5 42.5 t43.5 21q124 0 124 -353zM1792 1280q0 -106 -75 -181t-181 -75t-181 75t-75 181t75 181t181 75t181 -75t75 -181z" />
+<glyph unicode="&#xf0c1;" horiz-adv-x="1664" d="M1456 320q0 40 -28 68l-208 208q-28 28 -68 28q-42 0 -72 -32q3 -3 19 -18.5t21.5 -21.5t15 -19t13 -25.5t3.5 -27.5q0 -40 -28 -68t-68 -28q-15 0 -27.5 3.5t-25.5 13t-19 15t-21.5 21.5t-18.5 19q-33 -31 -33 -73q0 -40 28 -68l206 -207q27 -27 68 -27q40 0 68 26 l147 146q28 28 28 67zM753 1025q0 40 -28 68l-206 207q-28 28 -68 28q-39 0 -68 -27l-147 -146q-28 -28 -28 -67q0 -40 28 -68l208 -208q27 -27 68 -27q42 0 72 31q-3 3 -19 18.5t-21.5 21.5t-15 19t-13 25.5t-3.5 27.5q0 40 28 68t68 28q15 0 27.5 -3.5t25.5 -13t19 -15 t21.5 -21.5t18.5 -19q33 31 33 73zM1648 320q0 -120 -85 -203l-147 -146q-83 -83 -203 -83q-121 0 -204 85l-206 207q-83 83 -83 203q0 123 88 209l-88 88q-86 -88 -208 -88q-120 0 -204 84l-208 208q-84 84 -84 204t85 203l147 146q83 83 203 83q121 0 204 -85l206 -207 q83 -83 83 -203q0 -123 -88 -209l88 -88q86 88 208 88q120 0 204 -84l208 -208q84 -84 84 -204z" />
+<glyph unicode="&#xf0c2;" horiz-adv-x="1920" d="M1920 384q0 -159 -112.5 -271.5t-271.5 -112.5h-1088q-185 0 -316.5 131.5t-131.5 316.5q0 132 71 241.5t187 163.5q-2 28 -2 43q0 212 150 362t362 150q158 0 286.5 -88t187.5 -230q70 62 166 62q106 0 181 -75t75 -181q0 -75 -41 -138q129 -30 213 -134.5t84 -239.5z " />
+<glyph unicode="&#xf0c3;" horiz-adv-x="1664" d="M1527 88q56 -89 21.5 -152.5t-140.5 -63.5h-1152q-106 0 -140.5 63.5t21.5 152.5l503 793v399h-64q-26 0 -45 19t-19 45t19 45t45 19h512q26 0 45 -19t19 -45t-19 -45t-45 -19h-64v-399zM748 813l-272 -429h712l-272 429l-20 31v37v399h-128v-399v-37z" />
+<glyph unicode="&#xf0c4;" horiz-adv-x="1792" d="M960 640q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1260 576l507 -398q28 -20 25 -56q-5 -35 -35 -51l-128 -64q-13 -7 -29 -7q-17 0 -31 8l-690 387l-110 -66q-8 -4 -12 -5q14 -49 10 -97q-7 -77 -56 -147.5t-132 -123.5q-132 -84 -277 -84 q-136 0 -222 78q-90 84 -79 207q7 76 56 147t131 124q132 84 278 84q83 0 151 -31q9 13 22 22l122 73l-122 73q-13 9 -22 22q-68 -31 -151 -31q-146 0 -278 84q-82 53 -131 124t-56 147q-5 59 15.5 113t63.5 93q85 79 222 79q145 0 277 -84q83 -52 132 -123t56 -148 q4 -48 -10 -97q4 -1 12 -5l110 -66l690 387q14 8 31 8q16 0 29 -7l128 -64q30 -16 35 -51q3 -36 -25 -56zM579 836q46 42 21 108t-106 117q-92 59 -192 59q-74 0 -113 -36q-46 -42 -21 -108t106 -117q92 -59 192 -59q74 0 113 36zM494 91q81 51 106 117t-21 108 q-39 36 -113 36q-100 0 -192 -59q-81 -51 -106 -117t21 -108q39 -36 113 -36q100 0 192 59zM672 704l96 -58v11q0 36 33 56l14 8l-79 47l-26 -26q-3 -3 -10 -11t-12 -12q-2 -2 -4 -3.5t-3 -2.5zM896 480l96 -32l736 576l-128 64l-768 -431v-113l-160 -96l9 -8q2 -2 7 -6 q4 -4 11 -12t11 -12l26 -26zM1600 64l128 64l-520 408l-177 -138q-2 -3 -13 -7z" />
+<glyph unicode="&#xf0c5;" horiz-adv-x="1792" d="M1696 1152q40 0 68 -28t28 -68v-1216q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v288h-544q-40 0 -68 28t-28 68v672q0 40 20 88t48 76l408 408q28 28 76 48t88 20h416q40 0 68 -28t28 -68v-328q68 40 128 40h416zM1152 939l-299 -299h299v299zM512 1323l-299 -299 h299v299zM708 676l316 316v416h-384v-416q0 -40 -28 -68t-68 -28h-416v-640h512v256q0 40 20 88t48 76zM1664 -128v1152h-384v-416q0 -40 -28 -68t-68 -28h-416v-640h896z" />
+<glyph unicode="&#xf0c6;" horiz-adv-x="1408" d="M1404 151q0 -117 -79 -196t-196 -79q-135 0 -235 100l-777 776q-113 115 -113 271q0 159 110 270t269 111q158 0 273 -113l605 -606q10 -10 10 -22q0 -16 -30.5 -46.5t-46.5 -30.5q-13 0 -23 10l-606 607q-79 77 -181 77q-106 0 -179 -75t-73 -181q0 -105 76 -181 l776 -777q63 -63 145 -63q64 0 106 42t42 106q0 82 -63 145l-581 581q-26 24 -60 24q-29 0 -48 -19t-19 -48q0 -32 25 -59l410 -410q10 -10 10 -22q0 -16 -31 -47t-47 -31q-12 0 -22 10l-410 410q-63 61 -63 149q0 82 57 139t139 57q88 0 149 -63l581 -581q100 -98 100 -235 z" />
+<glyph unicode="&#xf0c7;" d="M384 0h768v384h-768v-384zM1280 0h128v896q0 14 -10 38.5t-20 34.5l-281 281q-10 10 -34 20t-39 10v-416q0 -40 -28 -68t-68 -28h-576q-40 0 -68 28t-28 68v416h-128v-1280h128v416q0 40 28 68t68 28h832q40 0 68 -28t28 -68v-416zM896 928v320q0 13 -9.5 22.5t-22.5 9.5 h-192q-13 0 -22.5 -9.5t-9.5 -22.5v-320q0 -13 9.5 -22.5t22.5 -9.5h192q13 0 22.5 9.5t9.5 22.5zM1536 896v-928q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1344q0 40 28 68t68 28h928q40 0 88 -20t76 -48l280 -280q28 -28 48 -76t20 -88z" />
+<glyph unicode="&#xf0c8;" d="M1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf0c9;" d="M1536 192v-128q0 -26 -19 -45t-45 -19h-1408q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1408q26 0 45 -19t19 -45zM1536 704v-128q0 -26 -19 -45t-45 -19h-1408q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1408q26 0 45 -19t19 -45zM1536 1216v-128q0 -26 -19 -45 t-45 -19h-1408q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1408q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf0ca;" horiz-adv-x="1792" d="M384 128q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM384 640q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1792 224v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1216q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5 t22.5 9.5h1216q13 0 22.5 -9.5t9.5 -22.5zM384 1152q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1792 736v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1216q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1216q13 0 22.5 -9.5t9.5 -22.5z M1792 1248v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1216q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1216q13 0 22.5 -9.5t9.5 -22.5z" />
+<glyph unicode="&#xf0cb;" horiz-adv-x="1792" d="M381 -84q0 -80 -54.5 -126t-135.5 -46q-106 0 -172 66l57 88q49 -45 106 -45q29 0 50.5 14.5t21.5 42.5q0 64 -105 56l-26 56q8 10 32.5 43.5t42.5 54t37 38.5v1q-16 0 -48.5 -1t-48.5 -1v-53h-106v152h333v-88l-95 -115q51 -12 81 -49t30 -88zM383 543v-159h-362 q-6 36 -6 54q0 51 23.5 93t56.5 68t66 47.5t56.5 43.5t23.5 45q0 25 -14.5 38.5t-39.5 13.5q-46 0 -81 -58l-85 59q24 51 71.5 79.5t105.5 28.5q73 0 123 -41.5t50 -112.5q0 -50 -34 -91.5t-75 -64.5t-75.5 -50.5t-35.5 -52.5h127v60h105zM1792 224v-192q0 -13 -9.5 -22.5 t-22.5 -9.5h-1216q-13 0 -22.5 9.5t-9.5 22.5v192q0 14 9 23t23 9h1216q13 0 22.5 -9.5t9.5 -22.5zM384 1123v-99h-335v99h107q0 41 0.5 122t0.5 121v12h-2q-8 -17 -50 -54l-71 76l136 127h106v-404h108zM1792 736v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1216q-13 0 -22.5 9.5 t-9.5 22.5v192q0 14 9 23t23 9h1216q13 0 22.5 -9.5t9.5 -22.5zM1792 1248v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1216q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1216q13 0 22.5 -9.5t9.5 -22.5z" />
+<glyph unicode="&#xf0cc;" horiz-adv-x="1792" d="M1760 640q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1728q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h1728zM483 704q-28 35 -51 80q-48 97 -48 188q0 181 134 309q133 127 393 127q50 0 167 -19q66 -12 177 -48q10 -38 21 -118q14 -123 14 -183q0 -18 -5 -45l-12 -3l-84 6 l-14 2q-50 149 -103 205q-88 91 -210 91q-114 0 -182 -59q-67 -58 -67 -146q0 -73 66 -140t279 -129q69 -20 173 -66q58 -28 95 -52h-743zM990 448h411q7 -39 7 -92q0 -111 -41 -212q-23 -55 -71 -104q-37 -35 -109 -81q-80 -48 -153 -66q-80 -21 -203 -21q-114 0 -195 23 l-140 40q-57 16 -72 28q-8 8 -8 22v13q0 108 -2 156q-1 30 0 68l2 37v44l102 2q15 -34 30 -71t22.5 -56t12.5 -27q35 -57 80 -94q43 -36 105 -57q59 -22 132 -22q64 0 139 27q77 26 122 86q47 61 47 129q0 84 -81 157q-34 29 -137 71z" />
+<glyph unicode="&#xf0cd;" d="M48 1313q-37 2 -45 4l-3 88q13 1 40 1q60 0 112 -4q132 -7 166 -7q86 0 168 3q116 4 146 5q56 0 86 2l-1 -14l2 -64v-9q-60 -9 -124 -9q-60 0 -79 -25q-13 -14 -13 -132q0 -13 0.5 -32.5t0.5 -25.5l1 -229l14 -280q6 -124 51 -202q35 -59 96 -92q88 -47 177 -47 q104 0 191 28q56 18 99 51q48 36 65 64q36 56 53 114q21 73 21 229q0 79 -3.5 128t-11 122.5t-13.5 159.5l-4 59q-5 67 -24 88q-34 35 -77 34l-100 -2l-14 3l2 86h84l205 -10q76 -3 196 10l18 -2q6 -38 6 -51q0 -7 -4 -31q-45 -12 -84 -13q-73 -11 -79 -17q-15 -15 -15 -41 q0 -7 1.5 -27t1.5 -31q8 -19 22 -396q6 -195 -15 -304q-15 -76 -41 -122q-38 -65 -112 -123q-75 -57 -182 -89q-109 -33 -255 -33q-167 0 -284 46q-119 47 -179 122q-61 76 -83 195q-16 80 -16 237v333q0 188 -17 213q-25 36 -147 39zM1536 -96v64q0 14 -9 23t-23 9h-1472 q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h1472q14 0 23 9t9 23z" />
+<glyph unicode="&#xf0ce;" horiz-adv-x="1664" d="M512 160v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM512 544v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1024 160v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23 v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM512 928v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1024 544v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1536 160v192 q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1024 928v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1536 544v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192 q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1536 928v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1664 1248v-1088q0 -66 -47 -113t-113 -47h-1344q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1344q66 0 113 -47t47 -113 z" />
+<glyph unicode="&#xf0d0;" horiz-adv-x="1664" d="M1190 955l293 293l-107 107l-293 -293zM1637 1248q0 -27 -18 -45l-1286 -1286q-18 -18 -45 -18t-45 18l-198 198q-18 18 -18 45t18 45l1286 1286q18 18 45 18t45 -18l198 -198q18 -18 18 -45zM286 1438l98 -30l-98 -30l-30 -98l-30 98l-98 30l98 30l30 98zM636 1276 l196 -60l-196 -60l-60 -196l-60 196l-196 60l196 60l60 196zM1566 798l98 -30l-98 -30l-30 -98l-30 98l-98 30l98 30l30 98zM926 1438l98 -30l-98 -30l-30 -98l-30 98l-98 30l98 30l30 98z" />
+<glyph unicode="&#xf0d1;" horiz-adv-x="1792" d="M640 128q0 52 -38 90t-90 38t-90 -38t-38 -90t38 -90t90 -38t90 38t38 90zM256 640h384v256h-158q-13 0 -22 -9l-195 -195q-9 -9 -9 -22v-30zM1536 128q0 52 -38 90t-90 38t-90 -38t-38 -90t38 -90t90 -38t90 38t38 90zM1792 1216v-1024q0 -15 -4 -26.5t-13.5 -18.5 t-16.5 -11.5t-23.5 -6t-22.5 -2t-25.5 0t-22.5 0.5q0 -106 -75 -181t-181 -75t-181 75t-75 181h-384q0 -106 -75 -181t-181 -75t-181 75t-75 181h-64q-3 0 -22.5 -0.5t-25.5 0t-22.5 2t-23.5 6t-16.5 11.5t-13.5 18.5t-4 26.5q0 26 19 45t45 19v320q0 8 -0.5 35t0 38 t2.5 34.5t6.5 37t14 30.5t22.5 30l198 198q19 19 50.5 32t58.5 13h160v192q0 26 19 45t45 19h1024q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf0d2;" d="M1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103q-111 0 -218 32q59 93 78 164q9 34 54 211q20 -39 73 -67.5t114 -28.5q121 0 216 68.5t147 188.5t52 270q0 114 -59.5 214t-172.5 163t-255 63q-105 0 -196 -29t-154.5 -77t-109 -110.5t-67 -129.5t-21.5 -134 q0 -104 40 -183t117 -111q30 -12 38 20q2 7 8 31t8 30q6 23 -11 43q-51 61 -51 151q0 151 104.5 259.5t273.5 108.5q151 0 235.5 -82t84.5 -213q0 -170 -68.5 -289t-175.5 -119q-61 0 -98 43.5t-23 104.5q8 35 26.5 93.5t30 103t11.5 75.5q0 50 -27 83t-77 33 q-62 0 -105 -57t-43 -142q0 -73 25 -122l-99 -418q-17 -70 -13 -177q-206 91 -333 281t-127 423q0 209 103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf0d3;" d="M1248 1408q119 0 203.5 -84.5t84.5 -203.5v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-725q85 122 108 210q9 34 53 209q21 -39 73.5 -67t112.5 -28q181 0 295.5 147.5t114.5 373.5q0 84 -35 162.5t-96.5 139t-152.5 97t-197 36.5q-104 0 -194.5 -28.5t-153 -76.5 t-107.5 -109.5t-66.5 -128t-21.5 -132.5q0 -102 39.5 -180t116.5 -110q13 -5 23.5 0t14.5 19q10 44 15 61q6 23 -11 42q-50 62 -50 150q0 150 103.5 256.5t270.5 106.5q149 0 232.5 -81t83.5 -210q0 -168 -67.5 -286t-173.5 -118q-60 0 -97 43.5t-23 103.5q8 34 26.5 92.5 t29.5 102t11 74.5q0 49 -26.5 81.5t-75.5 32.5q-61 0 -103.5 -56.5t-42.5 -139.5q0 -72 24 -121l-98 -414q-24 -100 -7 -254h-183q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960z" />
+<glyph unicode="&#xf0d4;" d="M917 631q0 26 -6 64h-362v-132h217q-3 -24 -16.5 -50t-37.5 -53t-66.5 -44.5t-96.5 -17.5q-99 0 -169 71t-70 171t70 171t169 71q92 0 153 -59l104 101q-108 100 -257 100q-160 0 -272 -112.5t-112 -271.5t112 -271.5t272 -112.5q165 0 266.5 105t101.5 270zM1262 585 h109v110h-109v110h-110v-110h-110v-110h110v-110h110v110zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf0d5;" horiz-adv-x="2304" d="M1437 623q0 -208 -87 -370.5t-248 -254t-369 -91.5q-149 0 -285 58t-234 156t-156 234t-58 285t58 285t156 234t234 156t285 58q286 0 491 -192l-199 -191q-117 113 -292 113q-123 0 -227.5 -62t-165.5 -168.5t-61 -232.5t61 -232.5t165.5 -168.5t227.5 -62 q83 0 152.5 23t114.5 57.5t78.5 78.5t49 83t21.5 74h-416v252h692q12 -63 12 -122zM2304 745v-210h-209v-209h-210v209h-209v210h209v209h210v-209h209z" />
+<glyph unicode="&#xf0d6;" horiz-adv-x="1920" d="M768 384h384v96h-128v448h-114l-148 -137l77 -80q42 37 55 57h2v-288h-128v-96zM1280 640q0 -70 -21 -142t-59.5 -134t-101.5 -101t-138 -39t-138 39t-101.5 101t-59.5 134t-21 142t21 142t59.5 134t101.5 101t138 39t138 -39t101.5 -101t59.5 -134t21 -142zM1792 384 v512q-106 0 -181 75t-75 181h-1152q0 -106 -75 -181t-181 -75v-512q106 0 181 -75t75 -181h1152q0 106 75 181t181 75zM1920 1216v-1152q0 -26 -19 -45t-45 -19h-1792q-26 0 -45 19t-19 45v1152q0 26 19 45t45 19h1792q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf0d7;" horiz-adv-x="1024" d="M1024 832q0 -26 -19 -45l-448 -448q-19 -19 -45 -19t-45 19l-448 448q-19 19 -19 45t19 45t45 19h896q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf0d8;" horiz-adv-x="1024" d="M1024 320q0 -26 -19 -45t-45 -19h-896q-26 0 -45 19t-19 45t19 45l448 448q19 19 45 19t45 -19l448 -448q19 -19 19 -45z" />
+<glyph unicode="&#xf0d9;" horiz-adv-x="640" d="M640 1088v-896q0 -26 -19 -45t-45 -19t-45 19l-448 448q-19 19 -19 45t19 45l448 448q19 19 45 19t45 -19t19 -45z" />
+<glyph unicode="&#xf0da;" horiz-adv-x="640" d="M576 640q0 -26 -19 -45l-448 -448q-19 -19 -45 -19t-45 19t-19 45v896q0 26 19 45t45 19t45 -19l448 -448q19 -19 19 -45z" />
+<glyph unicode="&#xf0db;" horiz-adv-x="1664" d="M160 0h608v1152h-640v-1120q0 -13 9.5 -22.5t22.5 -9.5zM1536 32v1120h-640v-1152h608q13 0 22.5 9.5t9.5 22.5zM1664 1248v-1216q0 -66 -47 -113t-113 -47h-1344q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1344q66 0 113 -47t47 -113z" />
+<glyph unicode="&#xf0dc;" horiz-adv-x="1024" d="M1024 448q0 -26 -19 -45l-448 -448q-19 -19 -45 -19t-45 19l-448 448q-19 19 -19 45t19 45t45 19h896q26 0 45 -19t19 -45zM1024 832q0 -26 -19 -45t-45 -19h-896q-26 0 -45 19t-19 45t19 45l448 448q19 19 45 19t45 -19l448 -448q19 -19 19 -45z" />
+<glyph unicode="&#xf0dd;" horiz-adv-x="1024" d="M1024 448q0 -26 -19 -45l-448 -448q-19 -19 -45 -19t-45 19l-448 448q-19 19 -19 45t19 45t45 19h896q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf0de;" horiz-adv-x="1024" d="M1024 832q0 -26 -19 -45t-45 -19h-896q-26 0 -45 19t-19 45t19 45l448 448q19 19 45 19t45 -19l448 -448q19 -19 19 -45z" />
+<glyph unicode="&#xf0e0;" horiz-adv-x="1792" d="M1792 826v-794q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v794q44 -49 101 -87q362 -246 497 -345q57 -42 92.5 -65.5t94.5 -48t110 -24.5h1h1q51 0 110 24.5t94.5 48t92.5 65.5q170 123 498 345q57 39 100 87zM1792 1120q0 -79 -49 -151t-122 -123 q-376 -261 -468 -325q-10 -7 -42.5 -30.5t-54 -38t-52 -32.5t-57.5 -27t-50 -9h-1h-1q-23 0 -50 9t-57.5 27t-52 32.5t-54 38t-42.5 30.5q-91 64 -262 182.5t-205 142.5q-62 42 -117 115.5t-55 136.5q0 78 41.5 130t118.5 52h1472q65 0 112.5 -47t47.5 -113z" />
+<glyph unicode="&#xf0e1;" d="M349 911v-991h-330v991h330zM370 1217q1 -73 -50.5 -122t-135.5 -49h-2q-82 0 -132 49t-50 122q0 74 51.5 122.5t134.5 48.5t133 -48.5t51 -122.5zM1536 488v-568h-329v530q0 105 -40.5 164.5t-126.5 59.5q-63 0 -105.5 -34.5t-63.5 -85.5q-11 -30 -11 -81v-553h-329 q2 399 2 647t-1 296l-1 48h329v-144h-2q20 32 41 56t56.5 52t87 43.5t114.5 15.5q171 0 275 -113.5t104 -332.5z" />
+<glyph unicode="&#xf0e2;" d="M1536 640q0 -156 -61 -298t-164 -245t-245 -164t-298 -61q-172 0 -327 72.5t-264 204.5q-7 10 -6.5 22.5t8.5 20.5l137 138q10 9 25 9q16 -2 23 -12q73 -95 179 -147t225 -52q104 0 198.5 40.5t163.5 109.5t109.5 163.5t40.5 198.5t-40.5 198.5t-109.5 163.5 t-163.5 109.5t-198.5 40.5q-98 0 -188 -35.5t-160 -101.5l137 -138q31 -30 14 -69q-17 -40 -59 -40h-448q-26 0 -45 19t-19 45v448q0 42 40 59q39 17 69 -14l130 -129q107 101 244.5 156.5t284.5 55.5q156 0 298 -61t245 -164t164 -245t61 -298z" />
+<glyph unicode="&#xf0e3;" horiz-adv-x="1792" d="M1771 0q0 -53 -37 -90l-107 -108q-39 -37 -91 -37q-53 0 -90 37l-363 364q-38 36 -38 90q0 53 43 96l-256 256l-126 -126q-14 -14 -34 -14t-34 14q2 -2 12.5 -12t12.5 -13t10 -11.5t10 -13.5t6 -13.5t5.5 -16.5t1.5 -18q0 -38 -28 -68q-3 -3 -16.5 -18t-19 -20.5 t-18.5 -16.5t-22 -15.5t-22 -9t-26 -4.5q-40 0 -68 28l-408 408q-28 28 -28 68q0 13 4.5 26t9 22t15.5 22t16.5 18.5t20.5 19t18 16.5q30 28 68 28q10 0 18 -1.5t16.5 -5.5t13.5 -6t13.5 -10t11.5 -10t13 -12.5t12 -12.5q-14 14 -14 34t14 34l348 348q14 14 34 14t34 -14 q-2 2 -12.5 12t-12.5 13t-10 11.5t-10 13.5t-6 13.5t-5.5 16.5t-1.5 18q0 38 28 68q3 3 16.5 18t19 20.5t18.5 16.5t22 15.5t22 9t26 4.5q40 0 68 -28l408 -408q28 -28 28 -68q0 -13 -4.5 -26t-9 -22t-15.5 -22t-16.5 -18.5t-20.5 -19t-18 -16.5q-30 -28 -68 -28 q-10 0 -18 1.5t-16.5 5.5t-13.5 6t-13.5 10t-11.5 10t-13 12.5t-12 12.5q14 -14 14 -34t-14 -34l-126 -126l256 -256q43 43 96 43q52 0 91 -37l363 -363q37 -39 37 -91z" />
+<glyph unicode="&#xf0e4;" horiz-adv-x="1792" d="M384 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM576 832q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1004 351l101 382q6 26 -7.5 48.5t-38.5 29.5 t-48 -6.5t-30 -39.5l-101 -382q-60 -5 -107 -43.5t-63 -98.5q-20 -77 20 -146t117 -89t146 20t89 117q16 60 -6 117t-72 91zM1664 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1024 1024q0 53 -37.5 90.5 t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1472 832q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1792 384q0 -261 -141 -483q-19 -29 -54 -29h-1402q-35 0 -54 29 q-141 221 -141 483q0 182 71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
+<glyph unicode="&#xf0e5;" horiz-adv-x="1792" d="M896 1152q-204 0 -381.5 -69.5t-282 -187.5t-104.5 -255q0 -112 71.5 -213.5t201.5 -175.5l87 -50l-27 -96q-24 -91 -70 -172q152 63 275 171l43 38l57 -6q69 -8 130 -8q204 0 381.5 69.5t282 187.5t104.5 255t-104.5 255t-282 187.5t-381.5 69.5zM1792 640 q0 -174 -120 -321.5t-326 -233t-450 -85.5q-70 0 -145 8q-198 -175 -460 -242q-49 -14 -114 -22h-5q-15 0 -27 10.5t-16 27.5v1q-3 4 -0.5 12t2 10t4.5 9.5l6 9t7 8.5t8 9q7 8 31 34.5t34.5 38t31 39.5t32.5 51t27 59t26 76q-157 89 -247.5 220t-90.5 281q0 174 120 321.5 t326 233t450 85.5t450 -85.5t326 -233t120 -321.5z" />
+<glyph unicode="&#xf0e6;" horiz-adv-x="1792" d="M704 1152q-153 0 -286 -52t-211.5 -141t-78.5 -191q0 -82 53 -158t149 -132l97 -56l-35 -84q34 20 62 39l44 31l53 -10q78 -14 153 -14q153 0 286 52t211.5 141t78.5 191t-78.5 191t-211.5 141t-286 52zM704 1280q191 0 353.5 -68.5t256.5 -186.5t94 -257t-94 -257 t-256.5 -186.5t-353.5 -68.5q-86 0 -176 16q-124 -88 -278 -128q-36 -9 -86 -16h-3q-11 0 -20.5 8t-11.5 21q-1 3 -1 6.5t0.5 6.5t2 6l2.5 5t3.5 5.5t4 5t4.5 5t4 4.5q5 6 23 25t26 29.5t22.5 29t25 38.5t20.5 44q-124 72 -195 177t-71 224q0 139 94 257t256.5 186.5 t353.5 68.5zM1526 111q10 -24 20.5 -44t25 -38.5t22.5 -29t26 -29.5t23 -25q1 -1 4 -4.5t4.5 -5t4 -5t3.5 -5.5l2.5 -5t2 -6t0.5 -6.5t-1 -6.5q-3 -14 -13 -22t-22 -7q-50 7 -86 16q-154 40 -278 128q-90 -16 -176 -16q-271 0 -472 132q58 -4 88 -4q161 0 309 45t264 129 q125 92 192 212t67 254q0 77 -23 152q129 -71 204 -178t75 -230q0 -120 -71 -224.5t-195 -176.5z" />
+<glyph unicode="&#xf0e7;" horiz-adv-x="896" d="M885 970q18 -20 7 -44l-540 -1157q-13 -25 -42 -25q-4 0 -14 2q-17 5 -25.5 19t-4.5 30l197 808l-406 -101q-4 -1 -12 -1q-18 0 -31 11q-18 15 -13 39l201 825q4 14 16 23t28 9h328q19 0 32 -12.5t13 -29.5q0 -8 -5 -18l-171 -463l396 98q8 2 12 2q19 0 34 -15z" />
+<glyph unicode="&#xf0e8;" horiz-adv-x="1792" d="M1792 288v-320q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h96v192h-512v-192h96q40 0 68 -28t28 -68v-320q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h96v192h-512v-192h96q40 0 68 -28t28 -68v-320 q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h96v192q0 52 38 90t90 38h512v192h-96q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h320q40 0 68 -28t28 -68v-320q0 -40 -28 -68t-68 -28h-96v-192h512q52 0 90 -38t38 -90v-192h96q40 0 68 -28t28 -68 z" />
+<glyph unicode="&#xf0e9;" horiz-adv-x="1664" d="M896 708v-580q0 -104 -76 -180t-180 -76t-180 76t-76 180q0 26 19 45t45 19t45 -19t19 -45q0 -50 39 -89t89 -39t89 39t39 89v580q33 11 64 11t64 -11zM1664 681q0 -13 -9.5 -22.5t-22.5 -9.5q-11 0 -23 10q-49 46 -93 69t-102 23q-68 0 -128 -37t-103 -97 q-7 -10 -17.5 -28t-14.5 -24q-11 -17 -28 -17q-18 0 -29 17q-4 6 -14.5 24t-17.5 28q-43 60 -102.5 97t-127.5 37t-127.5 -37t-102.5 -97q-7 -10 -17.5 -28t-14.5 -24q-11 -17 -29 -17q-17 0 -28 17q-4 6 -14.5 24t-17.5 28q-43 60 -103 97t-128 37q-58 0 -102 -23t-93 -69 q-12 -10 -23 -10q-13 0 -22.5 9.5t-9.5 22.5q0 5 1 7q45 183 172.5 319.5t298 204.5t360.5 68q140 0 274.5 -40t246.5 -113.5t194.5 -187t115.5 -251.5q1 -2 1 -7zM896 1408v-98q-42 2 -64 2t-64 -2v98q0 26 19 45t45 19t45 -19t19 -45z" />
+<glyph unicode="&#xf0ea;" horiz-adv-x="1792" d="M768 -128h896v640h-416q-40 0 -68 28t-28 68v416h-384v-1152zM1024 1312v64q0 13 -9.5 22.5t-22.5 9.5h-704q-13 0 -22.5 -9.5t-9.5 -22.5v-64q0 -13 9.5 -22.5t22.5 -9.5h704q13 0 22.5 9.5t9.5 22.5zM1280 640h299l-299 299v-299zM1792 512v-672q0 -40 -28 -68t-68 -28 h-960q-40 0 -68 28t-28 68v160h-544q-40 0 -68 28t-28 68v1344q0 40 28 68t68 28h1088q40 0 68 -28t28 -68v-328q21 -13 36 -28l408 -408q28 -28 48 -76t20 -88z" />
+<glyph unicode="&#xf0eb;" horiz-adv-x="1024" d="M736 960q0 -13 -9.5 -22.5t-22.5 -9.5t-22.5 9.5t-9.5 22.5q0 46 -54 71t-106 25q-13 0 -22.5 9.5t-9.5 22.5t9.5 22.5t22.5 9.5q50 0 99.5 -16t87 -54t37.5 -90zM896 960q0 72 -34.5 134t-90 101.5t-123 62t-136.5 22.5t-136.5 -22.5t-123 -62t-90 -101.5t-34.5 -134 q0 -101 68 -180q10 -11 30.5 -33t30.5 -33q128 -153 141 -298h228q13 145 141 298q10 11 30.5 33t30.5 33q68 79 68 180zM1024 960q0 -155 -103 -268q-45 -49 -74.5 -87t-59.5 -95.5t-34 -107.5q47 -28 47 -82q0 -37 -25 -64q25 -27 25 -64q0 -52 -45 -81q13 -23 13 -47 q0 -46 -31.5 -71t-77.5 -25q-20 -44 -60 -70t-87 -26t-87 26t-60 70q-46 0 -77.5 25t-31.5 71q0 24 13 47q-45 29 -45 81q0 37 25 64q-25 27 -25 64q0 54 47 82q-4 50 -34 107.5t-59.5 95.5t-74.5 87q-103 113 -103 268q0 99 44.5 184.5t117 142t164 89t186.5 32.5 t186.5 -32.5t164 -89t117 -142t44.5 -184.5z" />
+<glyph unicode="&#xf0ec;" horiz-adv-x="1792" d="M1792 352v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1376v-192q0 -13 -9.5 -22.5t-22.5 -9.5q-12 0 -24 10l-319 320q-9 9 -9 22q0 14 9 23l320 320q9 9 23 9q13 0 22.5 -9.5t9.5 -22.5v-192h1376q13 0 22.5 -9.5t9.5 -22.5zM1792 896q0 -14 -9 -23l-320 -320q-9 -9 -23 -9 q-13 0 -22.5 9.5t-9.5 22.5v192h-1376q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1376v192q0 14 9 23t23 9q12 0 24 -10l319 -319q9 -9 9 -23z" />
+<glyph unicode="&#xf0ed;" horiz-adv-x="1920" d="M1280 608q0 14 -9 23t-23 9h-224v352q0 13 -9.5 22.5t-22.5 9.5h-192q-13 0 -22.5 -9.5t-9.5 -22.5v-352h-224q-13 0 -22.5 -9.5t-9.5 -22.5q0 -14 9 -23l352 -352q9 -9 23 -9t23 9l351 351q10 12 10 24zM1920 384q0 -159 -112.5 -271.5t-271.5 -112.5h-1088 q-185 0 -316.5 131.5t-131.5 316.5q0 130 70 240t188 165q-2 30 -2 43q0 212 150 362t362 150q156 0 285.5 -87t188.5 -231q71 62 166 62q106 0 181 -75t75 -181q0 -76 -41 -138q130 -31 213.5 -135.5t83.5 -238.5z" />
+<glyph unicode="&#xf0ee;" horiz-adv-x="1920" d="M1280 672q0 14 -9 23l-352 352q-9 9 -23 9t-23 -9l-351 -351q-10 -12 -10 -24q0 -14 9 -23t23 -9h224v-352q0 -13 9.5 -22.5t22.5 -9.5h192q13 0 22.5 9.5t9.5 22.5v352h224q13 0 22.5 9.5t9.5 22.5zM1920 384q0 -159 -112.5 -271.5t-271.5 -112.5h-1088 q-185 0 -316.5 131.5t-131.5 316.5q0 130 70 240t188 165q-2 30 -2 43q0 212 150 362t362 150q156 0 285.5 -87t188.5 -231q71 62 166 62q106 0 181 -75t75 -181q0 -76 -41 -138q130 -31 213.5 -135.5t83.5 -238.5z" />
+<glyph unicode="&#xf0f0;" horiz-adv-x="1408" d="M384 192q0 -26 -19 -45t-45 -19t-45 19t-19 45t19 45t45 19t45 -19t19 -45zM1408 131q0 -121 -73 -190t-194 -69h-874q-121 0 -194 69t-73 190q0 68 5.5 131t24 138t47.5 132.5t81 103t120 60.5q-22 -52 -22 -120v-203q-58 -20 -93 -70t-35 -111q0 -80 56 -136t136 -56 t136 56t56 136q0 61 -35.5 111t-92.5 70v203q0 62 25 93q132 -104 295 -104t295 104q25 -31 25 -93v-64q-106 0 -181 -75t-75 -181v-89q-32 -29 -32 -71q0 -40 28 -68t68 -28t68 28t28 68q0 42 -32 71v89q0 52 38 90t90 38t90 -38t38 -90v-89q-32 -29 -32 -71q0 -40 28 -68 t68 -28t68 28t28 68q0 42 -32 71v89q0 68 -34.5 127.5t-93.5 93.5q0 10 0.5 42.5t0 48t-2.5 41.5t-7 47t-13 40q68 -15 120 -60.5t81 -103t47.5 -132.5t24 -138t5.5 -131zM1088 1024q0 -159 -112.5 -271.5t-271.5 -112.5t-271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5 t271.5 -112.5t112.5 -271.5z" />
+<glyph unicode="&#xf0f1;" horiz-adv-x="1408" d="M1280 832q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1408 832q0 -62 -35.5 -111t-92.5 -70v-395q0 -159 -131.5 -271.5t-316.5 -112.5t-316.5 112.5t-131.5 271.5v132q-164 20 -274 128t-110 252v512q0 26 19 45t45 19q6 0 16 -2q17 30 47 48 t65 18q53 0 90.5 -37.5t37.5 -90.5t-37.5 -90.5t-90.5 -37.5q-33 0 -64 18v-402q0 -106 94 -181t226 -75t226 75t94 181v402q-31 -18 -64 -18q-53 0 -90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5q35 0 65 -18t47 -48q10 2 16 2q26 0 45 -19t19 -45v-512q0 -144 -110 -252 t-274 -128v-132q0 -106 94 -181t226 -75t226 75t94 181v395q-57 21 -92.5 70t-35.5 111q0 80 56 136t136 56t136 -56t56 -136z" />
+<glyph unicode="&#xf0f2;" horiz-adv-x="1792" d="M640 1152h512v128h-512v-128zM288 1152v-1280h-64q-92 0 -158 66t-66 158v832q0 92 66 158t158 66h64zM1408 1152v-1280h-1024v1280h128v160q0 40 28 68t68 28h576q40 0 68 -28t28 -68v-160h128zM1792 928v-832q0 -92 -66 -158t-158 -66h-64v1280h64q92 0 158 -66 t66 -158z" />
+<glyph unicode="&#xf0f3;" horiz-adv-x="1792" d="M912 -160q0 16 -16 16q-59 0 -101.5 42.5t-42.5 101.5q0 16 -16 16t-16 -16q0 -73 51.5 -124.5t124.5 -51.5q16 0 16 16zM1728 128q0 -52 -38 -90t-90 -38h-448q0 -106 -75 -181t-181 -75t-181 75t-75 181h-448q-52 0 -90 38t-38 90q50 42 91 88t85 119.5t74.5 158.5 t50 206t19.5 260q0 152 117 282.5t307 158.5q-8 19 -8 39q0 40 28 68t68 28t68 -28t28 -68q0 -20 -8 -39q190 -28 307 -158.5t117 -282.5q0 -139 19.5 -260t50 -206t74.5 -158.5t85 -119.5t91 -88z" />
+<glyph unicode="&#xf0f4;" horiz-adv-x="1920" d="M1664 896q0 80 -56 136t-136 56h-64v-384h64q80 0 136 56t56 136zM0 128h1792q0 -106 -75 -181t-181 -75h-1280q-106 0 -181 75t-75 181zM1856 896q0 -159 -112.5 -271.5t-271.5 -112.5h-64v-32q0 -92 -66 -158t-158 -66h-704q-92 0 -158 66t-66 158v736q0 26 19 45 t45 19h1152q159 0 271.5 -112.5t112.5 -271.5z" />
+<glyph unicode="&#xf0f5;" horiz-adv-x="1408" d="M640 1472v-640q0 -61 -35.5 -111t-92.5 -70v-779q0 -52 -38 -90t-90 -38h-128q-52 0 -90 38t-38 90v779q-57 20 -92.5 70t-35.5 111v640q0 26 19 45t45 19t45 -19t19 -45v-416q0 -26 19 -45t45 -19t45 19t19 45v416q0 26 19 45t45 19t45 -19t19 -45v-416q0 -26 19 -45 t45 -19t45 19t19 45v416q0 26 19 45t45 19t45 -19t19 -45zM1408 1472v-1600q0 -52 -38 -90t-90 -38h-128q-52 0 -90 38t-38 90v512h-224q-13 0 -22.5 9.5t-9.5 22.5v800q0 132 94 226t226 94h256q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf0f6;" d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z M384 736q0 14 9 23t23 9h704q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-704q-14 0 -23 9t-9 23v64zM1120 512q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-704q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h704zM1120 256q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-704 q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h704z" />
+<glyph unicode="&#xf0f7;" horiz-adv-x="1408" d="M384 224v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z M640 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z M1152 224v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM896 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z M640 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 992v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z M1152 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM896 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z M640 992v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 1248v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z M1152 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM896 992v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z M640 1248v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM1152 992v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z M896 1248v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM1152 1248v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z M896 -128h384v1536h-1152v-1536h384v224q0 13 9.5 22.5t22.5 9.5h320q13 0 22.5 -9.5t9.5 -22.5v-224zM1408 1472v-1664q0 -26 -19 -45t-45 -19h-1280q-26 0 -45 19t-19 45v1664q0 26 19 45t45 19h1280q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf0f8;" horiz-adv-x="1408" d="M384 224v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z M640 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z M1152 224v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM896 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z M640 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM1152 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z M896 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM1152 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z M896 -128h384v1152h-256v-32q0 -40 -28 -68t-68 -28h-448q-40 0 -68 28t-28 68v32h-256v-1152h384v224q0 13 9.5 22.5t22.5 9.5h320q13 0 22.5 -9.5t9.5 -22.5v-224zM896 1056v320q0 13 -9.5 22.5t-22.5 9.5h-64q-13 0 -22.5 -9.5t-9.5 -22.5v-96h-128v96q0 13 -9.5 22.5 t-22.5 9.5h-64q-13 0 -22.5 -9.5t-9.5 -22.5v-320q0 -13 9.5 -22.5t22.5 -9.5h64q13 0 22.5 9.5t9.5 22.5v96h128v-96q0 -13 9.5 -22.5t22.5 -9.5h64q13 0 22.5 9.5t9.5 22.5zM1408 1088v-1280q0 -26 -19 -45t-45 -19h-1280q-26 0 -45 19t-19 45v1280q0 26 19 45t45 19h320 v288q0 40 28 68t68 28h448q40 0 68 -28t28 -68v-288h320q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf0f9;" horiz-adv-x="1920" d="M640 128q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM256 640h384v256h-158q-14 -2 -22 -9l-195 -195q-7 -12 -9 -22v-30zM1536 128q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5 t90.5 37.5t37.5 90.5zM1664 800v192q0 14 -9 23t-23 9h-224v224q0 14 -9 23t-23 9h-192q-14 0 -23 -9t-9 -23v-224h-224q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h224v-224q0 -14 9 -23t23 -9h192q14 0 23 9t9 23v224h224q14 0 23 9t9 23zM1920 1344v-1152 q0 -26 -19 -45t-45 -19h-192q0 -106 -75 -181t-181 -75t-181 75t-75 181h-384q0 -106 -75 -181t-181 -75t-181 75t-75 181h-128q-26 0 -45 19t-19 45t19 45t45 19v416q0 26 13 58t32 51l198 198q19 19 51 32t58 13h160v320q0 26 19 45t45 19h1152q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf0fa;" horiz-adv-x="1792" d="M1280 416v192q0 14 -9 23t-23 9h-224v224q0 14 -9 23t-23 9h-192q-14 0 -23 -9t-9 -23v-224h-224q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h224v-224q0 -14 9 -23t23 -9h192q14 0 23 9t9 23v224h224q14 0 23 9t9 23zM640 1152h512v128h-512v-128zM256 1152v-1280h-32 q-92 0 -158 66t-66 158v832q0 92 66 158t158 66h32zM1440 1152v-1280h-1088v1280h160v160q0 40 28 68t68 28h576q40 0 68 -28t28 -68v-160h160zM1792 928v-832q0 -92 -66 -158t-158 -66h-32v1280h32q92 0 158 -66t66 -158z" />
+<glyph unicode="&#xf0fb;" horiz-adv-x="1920" d="M1920 576q-1 -32 -288 -96l-352 -32l-224 -64h-64l-293 -352h69q26 0 45 -4.5t19 -11.5t-19 -11.5t-45 -4.5h-96h-160h-64v32h64v416h-160l-192 -224h-96l-32 32v192h32v32h128v8l-192 24v128l192 24v8h-128v32h-32v192l32 32h96l192 -224h160v416h-64v32h64h160h96 q26 0 45 -4.5t19 -11.5t-19 -11.5t-45 -4.5h-69l293 -352h64l224 -64l352 -32q261 -58 287 -93z" />
+<glyph unicode="&#xf0fc;" horiz-adv-x="1664" d="M640 640v384h-256v-256q0 -53 37.5 -90.5t90.5 -37.5h128zM1664 192v-192h-1152v192l128 192h-128q-159 0 -271.5 112.5t-112.5 271.5v320l-64 64l32 128h480l32 128h960l32 -192l-64 -32v-800z" />
+<glyph unicode="&#xf0fd;" d="M1280 192v896q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-320h-512v320q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-896q0 -26 19 -45t45 -19h128q26 0 45 19t19 45v320h512v-320q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1536 1120v-960 q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf0fe;" d="M1280 576v128q0 26 -19 45t-45 19h-320v320q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-320h-320q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h320v-320q0 -26 19 -45t45 -19h128q26 0 45 19t19 45v320h320q26 0 45 19t19 45zM1536 1120v-960 q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf100;" horiz-adv-x="1024" d="M627 160q0 -13 -10 -23l-50 -50q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l50 -50q10 -10 10 -23t-10 -23l-393 -393l393 -393q10 -10 10 -23zM1011 160q0 -13 -10 -23l-50 -50q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23 t10 23l466 466q10 10 23 10t23 -10l50 -50q10 -10 10 -23t-10 -23l-393 -393l393 -393q10 -10 10 -23z" />
+<glyph unicode="&#xf101;" horiz-adv-x="1024" d="M595 576q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l393 393l-393 393q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l466 -466q10 -10 10 -23zM979 576q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23 l393 393l-393 393q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l466 -466q10 -10 10 -23z" />
+<glyph unicode="&#xf102;" horiz-adv-x="1152" d="M1075 224q0 -13 -10 -23l-50 -50q-10 -10 -23 -10t-23 10l-393 393l-393 -393q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l466 -466q10 -10 10 -23zM1075 608q0 -13 -10 -23l-50 -50q-10 -10 -23 -10t-23 10l-393 393l-393 -393 q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l466 -466q10 -10 10 -23z" />
+<glyph unicode="&#xf103;" horiz-adv-x="1152" d="M1075 672q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l393 -393l393 393q10 10 23 10t23 -10l50 -50q10 -10 10 -23zM1075 1056q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23 t10 23l50 50q10 10 23 10t23 -10l393 -393l393 393q10 10 23 10t23 -10l50 -50q10 -10 10 -23z" />
+<glyph unicode="&#xf104;" horiz-adv-x="640" d="M627 992q0 -13 -10 -23l-393 -393l393 -393q10 -10 10 -23t-10 -23l-50 -50q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l50 -50q10 -10 10 -23z" />
+<glyph unicode="&#xf105;" horiz-adv-x="640" d="M595 576q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l393 393l-393 393q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l466 -466q10 -10 10 -23z" />
+<glyph unicode="&#xf106;" horiz-adv-x="1152" d="M1075 352q0 -13 -10 -23l-50 -50q-10 -10 -23 -10t-23 10l-393 393l-393 -393q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l466 -466q10 -10 10 -23z" />
+<glyph unicode="&#xf107;" horiz-adv-x="1152" d="M1075 800q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l393 -393l393 393q10 10 23 10t23 -10l50 -50q10 -10 10 -23z" />
+<glyph unicode="&#xf108;" horiz-adv-x="1920" d="M1792 544v832q0 13 -9.5 22.5t-22.5 9.5h-1600q-13 0 -22.5 -9.5t-9.5 -22.5v-832q0 -13 9.5 -22.5t22.5 -9.5h1600q13 0 22.5 9.5t9.5 22.5zM1920 1376v-1088q0 -66 -47 -113t-113 -47h-544q0 -37 16 -77.5t32 -71t16 -43.5q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19 t-19 45q0 14 16 44t32 70t16 78h-544q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1600q66 0 113 -47t47 -113z" />
+<glyph unicode="&#xf109;" horiz-adv-x="1920" d="M416 256q-66 0 -113 47t-47 113v704q0 66 47 113t113 47h1088q66 0 113 -47t47 -113v-704q0 -66 -47 -113t-113 -47h-1088zM384 1120v-704q0 -13 9.5 -22.5t22.5 -9.5h1088q13 0 22.5 9.5t9.5 22.5v704q0 13 -9.5 22.5t-22.5 9.5h-1088q-13 0 -22.5 -9.5t-9.5 -22.5z M1760 192h160v-96q0 -40 -47 -68t-113 -28h-1600q-66 0 -113 28t-47 68v96h160h1600zM1040 96q16 0 16 16t-16 16h-160q-16 0 -16 -16t16 -16h160z" />
+<glyph unicode="&#xf10a;" horiz-adv-x="1152" d="M640 128q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1024 288v960q0 13 -9.5 22.5t-22.5 9.5h-832q-13 0 -22.5 -9.5t-9.5 -22.5v-960q0 -13 9.5 -22.5t22.5 -9.5h832q13 0 22.5 9.5t9.5 22.5zM1152 1248v-1088q0 -66 -47 -113t-113 -47h-832 q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h832q66 0 113 -47t47 -113z" />
+<glyph unicode="&#xf10b;" horiz-adv-x="768" d="M464 128q0 33 -23.5 56.5t-56.5 23.5t-56.5 -23.5t-23.5 -56.5t23.5 -56.5t56.5 -23.5t56.5 23.5t23.5 56.5zM672 288v704q0 13 -9.5 22.5t-22.5 9.5h-512q-13 0 -22.5 -9.5t-9.5 -22.5v-704q0 -13 9.5 -22.5t22.5 -9.5h512q13 0 22.5 9.5t9.5 22.5zM480 1136 q0 16 -16 16h-160q-16 0 -16 -16t16 -16h160q16 0 16 16zM768 1152v-1024q0 -52 -38 -90t-90 -38h-512q-52 0 -90 38t-38 90v1024q0 52 38 90t90 38h512q52 0 90 -38t38 -90z" />
+<glyph unicode="&#xf10c;" d="M768 1184q-148 0 -273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273t-73 273t-198 198t-273 73zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103 t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf10d;" horiz-adv-x="1664" d="M768 576v-384q0 -80 -56 -136t-136 -56h-384q-80 0 -136 56t-56 136v704q0 104 40.5 198.5t109.5 163.5t163.5 109.5t198.5 40.5h64q26 0 45 -19t19 -45v-128q0 -26 -19 -45t-45 -19h-64q-106 0 -181 -75t-75 -181v-32q0 -40 28 -68t68 -28h224q80 0 136 -56t56 -136z M1664 576v-384q0 -80 -56 -136t-136 -56h-384q-80 0 -136 56t-56 136v704q0 104 40.5 198.5t109.5 163.5t163.5 109.5t198.5 40.5h64q26 0 45 -19t19 -45v-128q0 -26 -19 -45t-45 -19h-64q-106 0 -181 -75t-75 -181v-32q0 -40 28 -68t68 -28h224q80 0 136 -56t56 -136z" />
+<glyph unicode="&#xf10e;" horiz-adv-x="1664" d="M768 1216v-704q0 -104 -40.5 -198.5t-109.5 -163.5t-163.5 -109.5t-198.5 -40.5h-64q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h64q106 0 181 75t75 181v32q0 40 -28 68t-68 28h-224q-80 0 -136 56t-56 136v384q0 80 56 136t136 56h384q80 0 136 -56t56 -136zM1664 1216 v-704q0 -104 -40.5 -198.5t-109.5 -163.5t-163.5 -109.5t-198.5 -40.5h-64q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h64q106 0 181 75t75 181v32q0 40 -28 68t-68 28h-224q-80 0 -136 56t-56 136v384q0 80 56 136t136 56h384q80 0 136 -56t56 -136z" />
+<glyph unicode="&#xf110;" horiz-adv-x="1792" d="M526 142q0 -53 -37.5 -90.5t-90.5 -37.5q-52 0 -90 38t-38 90q0 53 37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1024 -64q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM320 640q0 -53 -37.5 -90.5t-90.5 -37.5 t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1522 142q0 -52 -38 -90t-90 -38q-53 0 -90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM558 1138q0 -66 -47 -113t-113 -47t-113 47t-47 113t47 113t113 47t113 -47t47 -113z M1728 640q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1088 1344q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1618 1138q0 -93 -66 -158.5t-158 -65.5q-93 0 -158.5 65.5t-65.5 158.5 q0 92 65.5 158t158.5 66q92 0 158 -66t66 -158z" />
+<glyph unicode="&#xf111;" d="M1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf112;" horiz-adv-x="1792" d="M1792 416q0 -166 -127 -451q-3 -7 -10.5 -24t-13.5 -30t-13 -22q-12 -17 -28 -17q-15 0 -23.5 10t-8.5 25q0 9 2.5 26.5t2.5 23.5q5 68 5 123q0 101 -17.5 181t-48.5 138.5t-80 101t-105.5 69.5t-133 42.5t-154 21.5t-175.5 6h-224v-256q0 -26 -19 -45t-45 -19t-45 19 l-512 512q-19 19 -19 45t19 45l512 512q19 19 45 19t45 -19t19 -45v-256h224q713 0 875 -403q53 -134 53 -333z" />
+<glyph unicode="&#xf113;" horiz-adv-x="1664" d="M640 320q0 -40 -12.5 -82t-43 -76t-72.5 -34t-72.5 34t-43 76t-12.5 82t12.5 82t43 76t72.5 34t72.5 -34t43 -76t12.5 -82zM1280 320q0 -40 -12.5 -82t-43 -76t-72.5 -34t-72.5 34t-43 76t-12.5 82t12.5 82t43 76t72.5 34t72.5 -34t43 -76t12.5 -82zM1440 320 q0 120 -69 204t-187 84q-41 0 -195 -21q-71 -11 -157 -11t-157 11q-152 21 -195 21q-118 0 -187 -84t-69 -204q0 -88 32 -153.5t81 -103t122 -60t140 -29.5t149 -7h168q82 0 149 7t140 29.5t122 60t81 103t32 153.5zM1664 496q0 -207 -61 -331q-38 -77 -105.5 -133t-141 -86 t-170 -47.5t-171.5 -22t-167 -4.5q-78 0 -142 3t-147.5 12.5t-152.5 30t-137 51.5t-121 81t-86 115q-62 123 -62 331q0 237 136 396q-27 82 -27 170q0 116 51 218q108 0 190 -39.5t189 -123.5q147 35 309 35q148 0 280 -32q105 82 187 121t189 39q51 -102 51 -218 q0 -87 -27 -168q136 -160 136 -398z" />
+<glyph unicode="&#xf114;" horiz-adv-x="1664" d="M1536 224v704q0 40 -28 68t-68 28h-704q-40 0 -68 28t-28 68v64q0 40 -28 68t-68 28h-320q-40 0 -68 -28t-28 -68v-960q0 -40 28 -68t68 -28h1216q40 0 68 28t28 68zM1664 928v-704q0 -92 -66 -158t-158 -66h-1216q-92 0 -158 66t-66 158v960q0 92 66 158t158 66h320 q92 0 158 -66t66 -158v-32h672q92 0 158 -66t66 -158z" />
+<glyph unicode="&#xf115;" horiz-adv-x="1920" d="M1781 605q0 35 -53 35h-1088q-40 0 -85.5 -21.5t-71.5 -52.5l-294 -363q-18 -24 -18 -40q0 -35 53 -35h1088q40 0 86 22t71 53l294 363q18 22 18 39zM640 768h768v160q0 40 -28 68t-68 28h-576q-40 0 -68 28t-28 68v64q0 40 -28 68t-68 28h-320q-40 0 -68 -28t-28 -68 v-853l256 315q44 53 116 87.5t140 34.5zM1909 605q0 -62 -46 -120l-295 -363q-43 -53 -116 -87.5t-140 -34.5h-1088q-92 0 -158 66t-66 158v960q0 92 66 158t158 66h320q92 0 158 -66t66 -158v-32h544q92 0 158 -66t66 -158v-160h192q54 0 99 -24.5t67 -70.5q15 -32 15 -68z " />
+<glyph unicode="&#xf116;" horiz-adv-x="1792" />
+<glyph unicode="&#xf117;" horiz-adv-x="1792" />
+<glyph unicode="&#xf118;" d="M1134 461q-37 -121 -138 -195t-228 -74t-228 74t-138 195q-8 25 4 48.5t38 31.5q25 8 48.5 -4t31.5 -38q25 -80 92.5 -129.5t151.5 -49.5t151.5 49.5t92.5 129.5q8 26 32 38t49 4t37 -31.5t4 -48.5zM640 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5 t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1152 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1408 640q0 130 -51 248.5t-136.5 204t-204 136.5t-248.5 51t-248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5 t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf119;" d="M1134 307q8 -25 -4 -48.5t-37 -31.5t-49 4t-32 38q-25 80 -92.5 129.5t-151.5 49.5t-151.5 -49.5t-92.5 -129.5q-8 -26 -31.5 -38t-48.5 -4q-26 8 -38 31.5t-4 48.5q37 121 138 195t228 74t228 -74t138 -195zM640 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5 t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1152 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1408 640q0 130 -51 248.5t-136.5 204t-204 136.5t-248.5 51t-248.5 -51t-204 -136.5t-136.5 -204 t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf11a;" d="M1152 448q0 -26 -19 -45t-45 -19h-640q-26 0 -45 19t-19 45t19 45t45 19h640q26 0 45 -19t19 -45zM640 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1152 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5 t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1408 640q0 130 -51 248.5t-136.5 204t-204 136.5t-248.5 51t-248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5zM1536 640 q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf11b;" horiz-adv-x="1920" d="M832 448v128q0 14 -9 23t-23 9h-192v192q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-192h-192q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h192v-192q0 -14 9 -23t23 -9h128q14 0 23 9t9 23v192h192q14 0 23 9t9 23zM1408 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5 t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1664 640q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1920 512q0 -212 -150 -362t-362 -150q-192 0 -338 128h-220q-146 -128 -338 -128q-212 0 -362 150 t-150 362t150 362t362 150h896q212 0 362 -150t150 -362z" />
+<glyph unicode="&#xf11c;" horiz-adv-x="1920" d="M384 368v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM512 624v-96q0 -16 -16 -16h-224q-16 0 -16 16v96q0 16 16 16h224q16 0 16 -16zM384 880v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1408 368v-96q0 -16 -16 -16 h-864q-16 0 -16 16v96q0 16 16 16h864q16 0 16 -16zM768 624v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM640 880v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1024 624v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16 h96q16 0 16 -16zM896 880v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1280 624v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1664 368v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1152 880v-96 q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1408 880v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1664 880v-352q0 -16 -16 -16h-224q-16 0 -16 16v96q0 16 16 16h112v240q0 16 16 16h96q16 0 16 -16zM1792 128v896h-1664v-896 h1664zM1920 1024v-896q0 -53 -37.5 -90.5t-90.5 -37.5h-1664q-53 0 -90.5 37.5t-37.5 90.5v896q0 53 37.5 90.5t90.5 37.5h1664q53 0 90.5 -37.5t37.5 -90.5z" />
+<glyph unicode="&#xf11d;" horiz-adv-x="1792" d="M1664 491v616q-169 -91 -306 -91q-82 0 -145 32q-100 49 -184 76.5t-178 27.5q-173 0 -403 -127v-599q245 113 433 113q55 0 103.5 -7.5t98 -26t77 -31t82.5 -39.5l28 -14q44 -22 101 -22q120 0 293 92zM320 1280q0 -35 -17.5 -64t-46.5 -46v-1266q0 -14 -9 -23t-23 -9 h-64q-14 0 -23 9t-9 23v1266q-29 17 -46.5 46t-17.5 64q0 53 37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1792 1216v-763q0 -39 -35 -57q-10 -5 -17 -9q-218 -116 -369 -116q-88 0 -158 35l-28 14q-64 33 -99 48t-91 29t-114 14q-102 0 -235.5 -44t-228.5 -102 q-15 -9 -33 -9q-16 0 -32 8q-32 19 -32 56v742q0 35 31 55q35 21 78.5 42.5t114 52t152.5 49.5t155 19q112 0 209 -31t209 -86q38 -19 89 -19q122 0 310 112q22 12 31 17q31 16 62 -2q31 -20 31 -55z" />
+<glyph unicode="&#xf11e;" horiz-adv-x="1792" d="M832 536v192q-181 -16 -384 -117v-185q205 96 384 110zM832 954v197q-172 -8 -384 -126v-189q215 111 384 118zM1664 491v184q-235 -116 -384 -71v224q-20 6 -39 15q-5 3 -33 17t-34.5 17t-31.5 15t-34.5 15.5t-32.5 13t-36 12.5t-35 8.5t-39.5 7.5t-39.5 4t-44 2 q-23 0 -49 -3v-222h19q102 0 192.5 -29t197.5 -82q19 -9 39 -15v-188q42 -17 91 -17q120 0 293 92zM1664 918v189q-169 -91 -306 -91q-45 0 -78 8v-196q148 -42 384 90zM320 1280q0 -35 -17.5 -64t-46.5 -46v-1266q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v1266 q-29 17 -46.5 46t-17.5 64q0 53 37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1792 1216v-763q0 -39 -35 -57q-10 -5 -17 -9q-218 -116 -369 -116q-88 0 -158 35l-28 14q-64 33 -99 48t-91 29t-114 14q-102 0 -235.5 -44t-228.5 -102q-15 -9 -33 -9q-16 0 -32 8 q-32 19 -32 56v742q0 35 31 55q35 21 78.5 42.5t114 52t152.5 49.5t155 19q112 0 209 -31t209 -86q38 -19 89 -19q122 0 310 112q22 12 31 17q31 16 62 -2q31 -20 31 -55z" />
+<glyph unicode="&#xf120;" horiz-adv-x="1664" d="M585 553l-466 -466q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l393 393l-393 393q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l466 -466q10 -10 10 -23t-10 -23zM1664 96v-64q0 -14 -9 -23t-23 -9h-960q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h960q14 0 23 -9 t9 -23z" />
+<glyph unicode="&#xf121;" horiz-adv-x="1920" d="M617 137l-50 -50q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l50 -50q10 -10 10 -23t-10 -23l-393 -393l393 -393q10 -10 10 -23t-10 -23zM1208 1204l-373 -1291q-4 -13 -15.5 -19.5t-23.5 -2.5l-62 17q-13 4 -19.5 15.5t-2.5 24.5 l373 1291q4 13 15.5 19.5t23.5 2.5l62 -17q13 -4 19.5 -15.5t2.5 -24.5zM1865 553l-466 -466q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l393 393l-393 393q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l466 -466q10 -10 10 -23t-10 -23z" />
+<glyph unicode="&#xf122;" horiz-adv-x="1792" d="M640 454v-70q0 -42 -39 -59q-13 -5 -25 -5q-27 0 -45 19l-512 512q-19 19 -19 45t19 45l512 512q29 31 70 14q39 -17 39 -59v-69l-397 -398q-19 -19 -19 -45t19 -45zM1792 416q0 -58 -17 -133.5t-38.5 -138t-48 -125t-40.5 -90.5l-20 -40q-8 -17 -28 -17q-6 0 -9 1 q-25 8 -23 34q43 400 -106 565q-64 71 -170.5 110.5t-267.5 52.5v-251q0 -42 -39 -59q-13 -5 -25 -5q-27 0 -45 19l-512 512q-19 19 -19 45t19 45l512 512q29 31 70 14q39 -17 39 -59v-262q411 -28 599 -221q169 -173 169 -509z" />
+<glyph unicode="&#xf123;" horiz-adv-x="1664" d="M1186 579l257 250l-356 52l-66 10l-30 60l-159 322v-963l59 -31l318 -168l-60 355l-12 66zM1638 841l-363 -354l86 -500q5 -33 -6 -51.5t-34 -18.5q-17 0 -40 12l-449 236l-449 -236q-23 -12 -40 -12q-23 0 -34 18.5t-6 51.5l86 500l-364 354q-32 32 -23 59.5t54 34.5 l502 73l225 455q20 41 49 41q28 0 49 -41l225 -455l502 -73q45 -7 54 -34.5t-24 -59.5z" />
+<glyph unicode="&#xf124;" horiz-adv-x="1408" d="M1401 1187l-640 -1280q-17 -35 -57 -35q-5 0 -15 2q-22 5 -35.5 22.5t-13.5 39.5v576h-576q-22 0 -39.5 13.5t-22.5 35.5t4 42t29 30l1280 640q13 7 29 7q27 0 45 -19q15 -14 18.5 -34.5t-6.5 -39.5z" />
+<glyph unicode="&#xf125;" horiz-adv-x="1664" d="M557 256h595v595zM512 301l595 595h-595v-595zM1664 224v-192q0 -14 -9 -23t-23 -9h-224v-224q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v224h-864q-14 0 -23 9t-9 23v864h-224q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h224v224q0 14 9 23t23 9h192q14 0 23 -9t9 -23 v-224h851l246 247q10 9 23 9t23 -9q9 -10 9 -23t-9 -23l-247 -246v-851h224q14 0 23 -9t9 -23z" />
+<glyph unicode="&#xf126;" horiz-adv-x="1024" d="M288 64q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM288 1216q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM928 1088q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM1024 1088q0 -52 -26 -96.5t-70 -69.5 q-2 -287 -226 -414q-68 -38 -203 -81q-128 -40 -169.5 -71t-41.5 -100v-26q44 -25 70 -69.5t26 -96.5q0 -80 -56 -136t-136 -56t-136 56t-56 136q0 52 26 96.5t70 69.5v820q-44 25 -70 69.5t-26 96.5q0 80 56 136t136 56t136 -56t56 -136q0 -52 -26 -96.5t-70 -69.5v-497 q54 26 154 57q55 17 87.5 29.5t70.5 31t59 39.5t40.5 51t28 69.5t8.5 91.5q-44 25 -70 69.5t-26 96.5q0 80 56 136t136 56t136 -56t56 -136z" />
+<glyph unicode="&#xf127;" horiz-adv-x="1664" d="M439 265l-256 -256q-10 -9 -23 -9q-12 0 -23 9q-9 10 -9 23t9 23l256 256q10 9 23 9t23 -9q9 -10 9 -23t-9 -23zM608 224v-320q0 -14 -9 -23t-23 -9t-23 9t-9 23v320q0 14 9 23t23 9t23 -9t9 -23zM384 448q0 -14 -9 -23t-23 -9h-320q-14 0 -23 9t-9 23t9 23t23 9h320 q14 0 23 -9t9 -23zM1648 320q0 -120 -85 -203l-147 -146q-83 -83 -203 -83q-121 0 -204 85l-334 335q-21 21 -42 56l239 18l273 -274q27 -27 68 -27.5t68 26.5l147 146q28 28 28 67q0 40 -28 68l-274 275l18 239q35 -21 56 -42l336 -336q84 -86 84 -204zM1031 1044l-239 -18 l-273 274q-28 28 -68 28q-39 0 -68 -27l-147 -146q-28 -28 -28 -67q0 -40 28 -68l274 -274l-18 -240q-35 21 -56 42l-336 336q-84 86 -84 204q0 120 85 203l147 146q83 83 203 83q121 0 204 -85l334 -335q21 -21 42 -56zM1664 960q0 -14 -9 -23t-23 -9h-320q-14 0 -23 9 t-9 23t9 23t23 9h320q14 0 23 -9t9 -23zM1120 1504v-320q0 -14 -9 -23t-23 -9t-23 9t-9 23v320q0 14 9 23t23 9t23 -9t9 -23zM1527 1353l-256 -256q-11 -9 -23 -9t-23 9q-9 10 -9 23t9 23l256 256q10 9 23 9t23 -9q9 -10 9 -23t-9 -23z" />
+<glyph unicode="&#xf128;" horiz-adv-x="1024" d="M704 280v-240q0 -16 -12 -28t-28 -12h-240q-16 0 -28 12t-12 28v240q0 16 12 28t28 12h240q16 0 28 -12t12 -28zM1020 880q0 -54 -15.5 -101t-35 -76.5t-55 -59.5t-57.5 -43.5t-61 -35.5q-41 -23 -68.5 -65t-27.5 -67q0 -17 -12 -32.5t-28 -15.5h-240q-15 0 -25.5 18.5 t-10.5 37.5v45q0 83 65 156.5t143 108.5q59 27 84 56t25 76q0 42 -46.5 74t-107.5 32q-65 0 -108 -29q-35 -25 -107 -115q-13 -16 -31 -16q-12 0 -25 8l-164 125q-13 10 -15.5 25t5.5 28q160 266 464 266q80 0 161 -31t146 -83t106 -127.5t41 -158.5z" />
+<glyph unicode="&#xf129;" horiz-adv-x="640" d="M640 192v-128q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h64v384h-64q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h384q26 0 45 -19t19 -45v-576h64q26 0 45 -19t19 -45zM512 1344v-192q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v192 q0 26 19 45t45 19h256q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf12a;" horiz-adv-x="640" d="M512 288v-224q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v224q0 26 19 45t45 19h256q26 0 45 -19t19 -45zM542 1344l-28 -768q-1 -26 -20.5 -45t-45.5 -19h-256q-26 0 -45.5 19t-20.5 45l-28 768q-1 26 17.5 45t44.5 19h320q26 0 44.5 -19t17.5 -45z" />
+<glyph unicode="&#xf12b;" d="M897 167v-167h-248l-159 252l-24 42q-8 9 -11 21h-3l-9 -21q-10 -20 -25 -44l-155 -250h-258v167h128l197 291l-185 272h-137v168h276l139 -228q2 -4 23 -42q8 -9 11 -21h3q3 9 11 21l25 42l140 228h257v-168h-125l-184 -267l204 -296h109zM1534 846v-206h-514l-3 27 q-4 28 -4 46q0 64 26 117t65 86.5t84 65t84 54.5t65 54t26 64q0 38 -29.5 62.5t-70.5 24.5q-51 0 -97 -39q-14 -11 -36 -38l-105 92q26 37 63 66q83 65 188 65q110 0 178 -59.5t68 -158.5q0 -56 -24.5 -103t-62 -76.5t-81.5 -58.5t-82 -50.5t-65.5 -51.5t-30.5 -63h232v80 h126z" />
+<glyph unicode="&#xf12c;" d="M897 167v-167h-248l-159 252l-24 42q-8 9 -11 21h-3l-9 -21q-10 -20 -25 -44l-155 -250h-258v167h128l197 291l-185 272h-137v168h276l139 -228q2 -4 23 -42q8 -9 11 -21h3q3 9 11 21l25 42l140 228h257v-168h-125l-184 -267l204 -296h109zM1536 -50v-206h-514l-4 27 q-3 45 -3 46q0 64 26 117t65 86.5t84 65t84 54.5t65 54t26 64q0 38 -29.5 62.5t-70.5 24.5q-51 0 -97 -39q-14 -11 -36 -38l-105 92q26 37 63 66q80 65 188 65q110 0 178 -59.5t68 -158.5q0 -66 -34.5 -118.5t-84 -86t-99.5 -62.5t-87 -63t-41 -73h232v80h126z" />
+<glyph unicode="&#xf12d;" horiz-adv-x="1920" d="M896 128l336 384h-768l-336 -384h768zM1909 1205q15 -34 9.5 -71.5t-30.5 -65.5l-896 -1024q-38 -44 -96 -44h-768q-38 0 -69.5 20.5t-47.5 54.5q-15 34 -9.5 71.5t30.5 65.5l896 1024q38 44 96 44h768q38 0 69.5 -20.5t47.5 -54.5z" />
+<glyph unicode="&#xf12e;" horiz-adv-x="1664" d="M1664 438q0 -81 -44.5 -135t-123.5 -54q-41 0 -77.5 17.5t-59 38t-56.5 38t-71 17.5q-110 0 -110 -124q0 -39 16 -115t15 -115v-5q-22 0 -33 -1q-34 -3 -97.5 -11.5t-115.5 -13.5t-98 -5q-61 0 -103 26.5t-42 83.5q0 37 17.5 71t38 56.5t38 59t17.5 77.5q0 79 -54 123.5 t-135 44.5q-84 0 -143 -45.5t-59 -127.5q0 -43 15 -83t33.5 -64.5t33.5 -53t15 -50.5q0 -45 -46 -89q-37 -35 -117 -35q-95 0 -245 24q-9 2 -27.5 4t-27.5 4l-13 2q-1 0 -3 1q-2 0 -2 1v1024q2 -1 17.5 -3.5t34 -5t21.5 -3.5q150 -24 245 -24q80 0 117 35q46 44 46 89 q0 22 -15 50.5t-33.5 53t-33.5 64.5t-15 83q0 82 59 127.5t144 45.5q80 0 134 -44.5t54 -123.5q0 -41 -17.5 -77.5t-38 -59t-38 -56.5t-17.5 -71q0 -57 42 -83.5t103 -26.5q64 0 180 15t163 17v-2q-1 -2 -3.5 -17.5t-5 -34t-3.5 -21.5q-24 -150 -24 -245q0 -80 35 -117 q44 -46 89 -46q22 0 50.5 15t53 33.5t64.5 33.5t83 15q82 0 127.5 -59t45.5 -143z" />
+<glyph unicode="&#xf130;" horiz-adv-x="1152" d="M1152 832v-128q0 -221 -147.5 -384.5t-364.5 -187.5v-132h256q26 0 45 -19t19 -45t-19 -45t-45 -19h-640q-26 0 -45 19t-19 45t19 45t45 19h256v132q-217 24 -364.5 187.5t-147.5 384.5v128q0 26 19 45t45 19t45 -19t19 -45v-128q0 -185 131.5 -316.5t316.5 -131.5 t316.5 131.5t131.5 316.5v128q0 26 19 45t45 19t45 -19t19 -45zM896 1216v-512q0 -132 -94 -226t-226 -94t-226 94t-94 226v512q0 132 94 226t226 94t226 -94t94 -226z" />
+<glyph unicode="&#xf131;" horiz-adv-x="1408" d="M271 591l-101 -101q-42 103 -42 214v128q0 26 19 45t45 19t45 -19t19 -45v-128q0 -53 15 -113zM1385 1193l-361 -361v-128q0 -132 -94 -226t-226 -94q-55 0 -109 19l-96 -96q97 -51 205 -51q185 0 316.5 131.5t131.5 316.5v128q0 26 19 45t45 19t45 -19t19 -45v-128 q0 -221 -147.5 -384.5t-364.5 -187.5v-132h256q26 0 45 -19t19 -45t-19 -45t-45 -19h-640q-26 0 -45 19t-19 45t19 45t45 19h256v132q-125 13 -235 81l-254 -254q-10 -10 -23 -10t-23 10l-82 82q-10 10 -10 23t10 23l1234 1234q10 10 23 10t23 -10l82 -82q10 -10 10 -23 t-10 -23zM1005 1325l-621 -621v512q0 132 94 226t226 94q102 0 184.5 -59t116.5 -152z" />
+<glyph unicode="&#xf132;" horiz-adv-x="1280" d="M1088 576v640h-448v-1137q119 63 213 137q235 184 235 360zM1280 1344v-768q0 -86 -33.5 -170.5t-83 -150t-118 -127.5t-126.5 -103t-121 -77.5t-89.5 -49.5t-42.5 -20q-12 -6 -26 -6t-26 6q-16 7 -42.5 20t-89.5 49.5t-121 77.5t-126.5 103t-118 127.5t-83 150 t-33.5 170.5v768q0 26 19 45t45 19h1152q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf133;" horiz-adv-x="1664" d="M128 -128h1408v1024h-1408v-1024zM512 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1280 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1664 1152v-1280 q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h384v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h128q52 0 90 -38t38 -90z" />
+<glyph unicode="&#xf134;" horiz-adv-x="1408" d="M512 1344q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1408 1376v-320q0 -16 -12 -25q-8 -7 -20 -7q-4 0 -7 1l-448 96q-11 2 -18 11t-7 20h-256v-102q111 -23 183.5 -111t72.5 -203v-800q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v800 q0 106 62.5 190.5t161.5 114.5v111h-32q-59 0 -115 -23.5t-91.5 -53t-66 -66.5t-40.5 -53.5t-14 -24.5q-17 -35 -57 -35q-16 0 -29 7q-23 12 -31.5 37t3.5 49q5 10 14.5 26t37.5 53.5t60.5 70t85 67t108.5 52.5q-25 42 -25 86q0 66 47 113t113 47t113 -47t47 -113 q0 -33 -14 -64h302q0 11 7 20t18 11l448 96q3 1 7 1q12 0 20 -7q12 -9 12 -25z" />
+<glyph unicode="&#xf135;" horiz-adv-x="1664" d="M1440 1088q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM1664 1376q0 -249 -75.5 -430.5t-253.5 -360.5q-81 -80 -195 -176l-20 -379q-2 -16 -16 -26l-384 -224q-7 -4 -16 -4q-12 0 -23 9l-64 64q-13 14 -8 32l85 276l-281 281l-276 -85q-3 -1 -9 -1 q-14 0 -23 9l-64 64q-17 19 -5 39l224 384q10 14 26 16l379 20q96 114 176 195q188 187 358 258t431 71q14 0 24 -9.5t10 -22.5z" />
+<glyph unicode="&#xf136;" horiz-adv-x="1792" d="M1745 763l-164 -763h-334l178 832q13 56 -15 88q-27 33 -83 33h-169l-204 -953h-334l204 953h-286l-204 -953h-334l204 953l-153 327h1276q101 0 189.5 -40.5t147.5 -113.5q60 -73 81 -168.5t0 -194.5z" />
+<glyph unicode="&#xf137;" d="M909 141l102 102q19 19 19 45t-19 45l-307 307l307 307q19 19 19 45t-19 45l-102 102q-19 19 -45 19t-45 -19l-454 -454q-19 -19 -19 -45t19 -45l454 -454q19 -19 45 -19t45 19zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5 t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf138;" d="M717 141l454 454q19 19 19 45t-19 45l-454 454q-19 19 -45 19t-45 -19l-102 -102q-19 -19 -19 -45t19 -45l307 -307l-307 -307q-19 -19 -19 -45t19 -45l102 -102q19 -19 45 -19t45 19zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5 t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf139;" d="M1165 397l102 102q19 19 19 45t-19 45l-454 454q-19 19 -45 19t-45 -19l-454 -454q-19 -19 -19 -45t19 -45l102 -102q19 -19 45 -19t45 19l307 307l307 -307q19 -19 45 -19t45 19zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5 t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf13a;" d="M813 237l454 454q19 19 19 45t-19 45l-102 102q-19 19 -45 19t-45 -19l-307 -307l-307 307q-19 19 -45 19t-45 -19l-102 -102q-19 -19 -19 -45t19 -45l454 -454q19 -19 45 -19t45 19zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5 t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf13b;" horiz-adv-x="1408" d="M1130 939l16 175h-884l47 -534h612l-22 -228l-197 -53l-196 53l-13 140h-175l22 -278l362 -100h4v1l359 99l50 544h-644l-15 181h674zM0 1408h1408l-128 -1438l-578 -162l-574 162z" />
+<glyph unicode="&#xf13c;" horiz-adv-x="1792" d="M275 1408h1505l-266 -1333l-804 -267l-698 267l71 356h297l-29 -147l422 -161l486 161l68 339h-1208l58 297h1209l38 191h-1208z" />
+<glyph unicode="&#xf13d;" horiz-adv-x="1792" d="M960 1280q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1792 352v-352q0 -22 -20 -30q-8 -2 -12 -2q-13 0 -23 9l-93 93q-119 -143 -318.5 -226.5t-429.5 -83.5t-429.5 83.5t-318.5 226.5l-93 -93q-9 -9 -23 -9q-4 0 -12 2q-20 8 -20 30v352 q0 14 9 23t23 9h352q22 0 30 -20q8 -19 -7 -35l-100 -100q67 -91 189.5 -153.5t271.5 -82.5v647h-192q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h192v163q-58 34 -93 92.5t-35 128.5q0 106 75 181t181 75t181 -75t75 -181q0 -70 -35 -128.5t-93 -92.5v-163h192q26 0 45 -19 t19 -45v-128q0 -26 -19 -45t-45 -19h-192v-647q149 20 271.5 82.5t189.5 153.5l-100 100q-15 16 -7 35q8 20 30 20h352q14 0 23 -9t9 -23z" />
+<glyph unicode="&#xf13e;" horiz-adv-x="1152" d="M1056 768q40 0 68 -28t28 -68v-576q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v576q0 40 28 68t68 28h32v320q0 185 131.5 316.5t316.5 131.5t316.5 -131.5t131.5 -316.5q0 -26 -19 -45t-45 -19h-64q-26 0 -45 19t-19 45q0 106 -75 181t-181 75t-181 -75t-75 -181 v-320h736z" />
+<glyph unicode="&#xf140;" d="M1024 640q0 -106 -75 -181t-181 -75t-181 75t-75 181t75 181t181 75t181 -75t75 -181zM1152 640q0 159 -112.5 271.5t-271.5 112.5t-271.5 -112.5t-112.5 -271.5t112.5 -271.5t271.5 -112.5t271.5 112.5t112.5 271.5zM1280 640q0 -212 -150 -362t-362 -150t-362 150 t-150 362t150 362t362 150t362 -150t150 -362zM1408 640q0 130 -51 248.5t-136.5 204t-204 136.5t-248.5 51t-248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5zM1536 640 q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf141;" horiz-adv-x="1408" d="M384 800v-192q0 -40 -28 -68t-68 -28h-192q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68zM896 800v-192q0 -40 -28 -68t-68 -28h-192q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68zM1408 800v-192q0 -40 -28 -68t-68 -28h-192 q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68z" />
+<glyph unicode="&#xf142;" horiz-adv-x="384" d="M384 288v-192q0 -40 -28 -68t-68 -28h-192q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68zM384 800v-192q0 -40 -28 -68t-68 -28h-192q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68zM384 1312v-192q0 -40 -28 -68t-68 -28h-192 q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68z" />
+<glyph unicode="&#xf143;" d="M512 256q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM863 162q-13 232 -177 396t-396 177q-14 1 -24 -9t-10 -23v-128q0 -13 8.5 -22t21.5 -10q154 -11 264 -121t121 -264q1 -13 10 -21.5t22 -8.5h128q13 0 23 10 t9 24zM1247 161q-5 154 -56 297.5t-139.5 260t-205 205t-260 139.5t-297.5 56q-14 1 -23 -9q-10 -10 -10 -23v-128q0 -13 9 -22t22 -10q204 -7 378 -111.5t278.5 -278.5t111.5 -378q1 -13 10 -22t22 -9h128q13 0 23 10q11 9 9 23zM1536 1120v-960q0 -119 -84.5 -203.5 t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf144;" d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM1152 585q32 18 32 55t-32 55l-544 320q-31 19 -64 1q-32 -19 -32 -56v-640q0 -37 32 -56 q16 -8 32 -8q17 0 32 9z" />
+<glyph unicode="&#xf145;" horiz-adv-x="1792" d="M1024 1084l316 -316l-572 -572l-316 316zM813 105l618 618q19 19 19 45t-19 45l-362 362q-18 18 -45 18t-45 -18l-618 -618q-19 -19 -19 -45t19 -45l362 -362q18 -18 45 -18t45 18zM1702 742l-907 -908q-37 -37 -90.5 -37t-90.5 37l-126 126q56 56 56 136t-56 136 t-136 56t-136 -56l-125 126q-37 37 -37 90.5t37 90.5l907 906q37 37 90.5 37t90.5 -37l125 -125q-56 -56 -56 -136t56 -136t136 -56t136 56l126 -125q37 -37 37 -90.5t-37 -90.5z" />
+<glyph unicode="&#xf146;" d="M1280 576v128q0 26 -19 45t-45 19h-896q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h896q26 0 45 19t19 45zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5 t84.5 -203.5z" />
+<glyph unicode="&#xf147;" horiz-adv-x="1408" d="M1152 736v-64q0 -14 -9 -23t-23 -9h-832q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h832q14 0 23 -9t9 -23zM1280 288v832q0 66 -47 113t-113 47h-832q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832q66 0 113 47t47 113zM1408 1120v-832q0 -119 -84.5 -203.5 t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h832q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf148;" horiz-adv-x="1024" d="M1018 933q-18 -37 -58 -37h-192v-864q0 -14 -9 -23t-23 -9h-704q-21 0 -29 18q-8 20 4 35l160 192q9 11 25 11h320v640h-192q-40 0 -58 37q-17 37 9 68l320 384q18 22 49 22t49 -22l320 -384q27 -32 9 -68z" />
+<glyph unicode="&#xf149;" horiz-adv-x="1024" d="M32 1280h704q13 0 22.5 -9.5t9.5 -23.5v-863h192q40 0 58 -37t-9 -69l-320 -384q-18 -22 -49 -22t-49 22l-320 384q-26 31 -9 69q18 37 58 37h192v640h-320q-14 0 -25 11l-160 192q-13 14 -4 34q9 19 29 19z" />
+<glyph unicode="&#xf14a;" d="M685 237l614 614q19 19 19 45t-19 45l-102 102q-19 19 -45 19t-45 -19l-467 -467l-211 211q-19 19 -45 19t-45 -19l-102 -102q-19 -19 -19 -45t19 -45l358 -358q19 -19 45 -19t45 19zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5 t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf14b;" d="M404 428l152 -152l-52 -52h-56v96h-96v56zM818 818q14 -13 -3 -30l-291 -291q-17 -17 -30 -3q-14 13 3 30l291 291q17 17 30 3zM544 128l544 544l-288 288l-544 -544v-288h288zM1152 736l92 92q28 28 28 68t-28 68l-152 152q-28 28 -68 28t-68 -28l-92 -92zM1536 1120 v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf14c;" d="M1280 608v480q0 26 -19 45t-45 19h-480q-42 0 -59 -39q-17 -41 14 -70l144 -144l-534 -534q-19 -19 -19 -45t19 -45l102 -102q19 -19 45 -19t45 19l534 534l144 -144q18 -19 45 -19q12 0 25 5q39 17 39 59zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960 q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf14d;" d="M1005 435l352 352q19 19 19 45t-19 45l-352 352q-30 31 -69 14q-40 -17 -40 -59v-160q-119 0 -216 -19.5t-162.5 -51t-114 -79t-76.5 -95.5t-44.5 -109t-21.5 -111.5t-5 -110.5q0 -181 167 -404q10 -12 25 -12q7 0 13 3q22 9 19 33q-44 354 62 473q46 52 130 75.5 t224 23.5v-160q0 -42 40 -59q12 -5 24 -5q26 0 45 19zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf14e;" d="M640 448l256 128l-256 128v-256zM1024 1039v-542l-512 -256v542zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103 t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf150;" d="M1145 861q18 -35 -5 -66l-320 -448q-19 -27 -52 -27t-52 27l-320 448q-23 31 -5 66q17 35 57 35h640q40 0 57 -35zM1280 160v960q0 13 -9.5 22.5t-22.5 9.5h-960q-13 0 -22.5 -9.5t-9.5 -22.5v-960q0 -13 9.5 -22.5t22.5 -9.5h960q13 0 22.5 9.5t9.5 22.5zM1536 1120 v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf151;" d="M1145 419q-17 -35 -57 -35h-640q-40 0 -57 35q-18 35 5 66l320 448q19 27 52 27t52 -27l320 -448q23 -31 5 -66zM1280 160v960q0 13 -9.5 22.5t-22.5 9.5h-960q-13 0 -22.5 -9.5t-9.5 -22.5v-960q0 -13 9.5 -22.5t22.5 -9.5h960q13 0 22.5 9.5t9.5 22.5zM1536 1120v-960 q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf152;" d="M1088 640q0 -33 -27 -52l-448 -320q-31 -23 -66 -5q-35 17 -35 57v640q0 40 35 57q35 18 66 -5l448 -320q27 -19 27 -52zM1280 160v960q0 14 -9 23t-23 9h-960q-14 0 -23 -9t-9 -23v-960q0 -14 9 -23t23 -9h960q14 0 23 9t9 23zM1536 1120v-960q0 -119 -84.5 -203.5 t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf153;" horiz-adv-x="1024" d="M976 229l35 -159q3 -12 -3 -22.5t-17 -14.5l-5 -1q-4 -2 -10.5 -3.5t-16 -4.5t-21.5 -5.5t-25.5 -5t-30 -5t-33.5 -4.5t-36.5 -3t-38.5 -1q-234 0 -409 130.5t-238 351.5h-95q-13 0 -22.5 9.5t-9.5 22.5v113q0 13 9.5 22.5t22.5 9.5h66q-2 57 1 105h-67q-14 0 -23 9 t-9 23v114q0 14 9 23t23 9h98q67 210 243.5 338t400.5 128q102 0 194 -23q11 -3 20 -15q6 -11 3 -24l-43 -159q-3 -13 -14 -19.5t-24 -2.5l-4 1q-4 1 -11.5 2.5l-17.5 3.5t-22.5 3.5t-26 3t-29 2.5t-29.5 1q-126 0 -226 -64t-150 -176h468q16 0 25 -12q10 -12 7 -26 l-24 -114q-5 -26 -32 -26h-488q-3 -37 0 -105h459q15 0 25 -12q9 -12 6 -27l-24 -112q-2 -11 -11 -18.5t-20 -7.5h-387q48 -117 149.5 -185.5t228.5 -68.5q18 0 36 1.5t33.5 3.5t29.5 4.5t24.5 5t18.5 4.5l12 3l5 2q13 5 26 -2q12 -7 15 -21z" />
+<glyph unicode="&#xf154;" horiz-adv-x="1024" d="M1020 399v-367q0 -14 -9 -23t-23 -9h-956q-14 0 -23 9t-9 23v150q0 13 9.5 22.5t22.5 9.5h97v383h-95q-14 0 -23 9.5t-9 22.5v131q0 14 9 23t23 9h95v223q0 171 123.5 282t314.5 111q185 0 335 -125q9 -8 10 -20.5t-7 -22.5l-103 -127q-9 -11 -22 -12q-13 -2 -23 7 q-5 5 -26 19t-69 32t-93 18q-85 0 -137 -47t-52 -123v-215h305q13 0 22.5 -9t9.5 -23v-131q0 -13 -9.5 -22.5t-22.5 -9.5h-305v-379h414v181q0 13 9 22.5t23 9.5h162q14 0 23 -9.5t9 -22.5z" />
+<glyph unicode="&#xf155;" horiz-adv-x="1024" d="M978 351q0 -153 -99.5 -263.5t-258.5 -136.5v-175q0 -14 -9 -23t-23 -9h-135q-13 0 -22.5 9.5t-9.5 22.5v175q-66 9 -127.5 31t-101.5 44.5t-74 48t-46.5 37.5t-17.5 18q-17 21 -2 41l103 135q7 10 23 12q15 2 24 -9l2 -2q113 -99 243 -125q37 -8 74 -8q81 0 142.5 43 t61.5 122q0 28 -15 53t-33.5 42t-58.5 37.5t-66 32t-80 32.5q-39 16 -61.5 25t-61.5 26.5t-62.5 31t-56.5 35.5t-53.5 42.5t-43.5 49t-35.5 58t-21 66.5t-8.5 78q0 138 98 242t255 134v180q0 13 9.5 22.5t22.5 9.5h135q14 0 23 -9t9 -23v-176q57 -6 110.5 -23t87 -33.5 t63.5 -37.5t39 -29t15 -14q17 -18 5 -38l-81 -146q-8 -15 -23 -16q-14 -3 -27 7q-3 3 -14.5 12t-39 26.5t-58.5 32t-74.5 26t-85.5 11.5q-95 0 -155 -43t-60 -111q0 -26 8.5 -48t29.5 -41.5t39.5 -33t56 -31t60.5 -27t70 -27.5q53 -20 81 -31.5t76 -35t75.5 -42.5t62 -50 t53 -63.5t31.5 -76.5t13 -94z" />
+<glyph unicode="&#xf156;" horiz-adv-x="898" d="M898 1066v-102q0 -14 -9 -23t-23 -9h-168q-23 -144 -129 -234t-276 -110q167 -178 459 -536q14 -16 4 -34q-8 -18 -29 -18h-195q-16 0 -25 12q-306 367 -498 571q-9 9 -9 22v127q0 13 9.5 22.5t22.5 9.5h112q132 0 212.5 43t102.5 125h-427q-14 0 -23 9t-9 23v102 q0 14 9 23t23 9h413q-57 113 -268 113h-145q-13 0 -22.5 9.5t-9.5 22.5v133q0 14 9 23t23 9h832q14 0 23 -9t9 -23v-102q0 -14 -9 -23t-23 -9h-233q47 -61 64 -144h171q14 0 23 -9t9 -23z" />
+<glyph unicode="&#xf157;" horiz-adv-x="1027" d="M603 0h-172q-13 0 -22.5 9t-9.5 23v330h-288q-13 0 -22.5 9t-9.5 23v103q0 13 9.5 22.5t22.5 9.5h288v85h-288q-13 0 -22.5 9t-9.5 23v104q0 13 9.5 22.5t22.5 9.5h214l-321 578q-8 16 0 32q10 16 28 16h194q19 0 29 -18l215 -425q19 -38 56 -125q10 24 30.5 68t27.5 61 l191 420q8 19 29 19h191q17 0 27 -16q9 -14 1 -31l-313 -579h215q13 0 22.5 -9.5t9.5 -22.5v-104q0 -14 -9.5 -23t-22.5 -9h-290v-85h290q13 0 22.5 -9.5t9.5 -22.5v-103q0 -14 -9.5 -23t-22.5 -9h-290v-330q0 -13 -9.5 -22.5t-22.5 -9.5z" />
+<glyph unicode="&#xf158;" horiz-adv-x="1280" d="M1043 971q0 100 -65 162t-171 62h-320v-448h320q106 0 171 62t65 162zM1280 971q0 -193 -126.5 -315t-326.5 -122h-340v-118h505q14 0 23 -9t9 -23v-128q0 -14 -9 -23t-23 -9h-505v-192q0 -14 -9.5 -23t-22.5 -9h-167q-14 0 -23 9t-9 23v192h-224q-14 0 -23 9t-9 23v128 q0 14 9 23t23 9h224v118h-224q-14 0 -23 9t-9 23v149q0 13 9 22.5t23 9.5h224v629q0 14 9 23t23 9h539q200 0 326.5 -122t126.5 -315z" />
+<glyph unicode="&#xf159;" horiz-adv-x="1792" d="M514 341l81 299h-159l75 -300q1 -1 1 -3t1 -3q0 1 0.5 3.5t0.5 3.5zM630 768l35 128h-292l32 -128h225zM822 768h139l-35 128h-70zM1271 340l78 300h-162l81 -299q0 -1 0.5 -3.5t1.5 -3.5q0 1 0.5 3t0.5 3zM1382 768l33 128h-297l34 -128h230zM1792 736v-64q0 -14 -9 -23 t-23 -9h-213l-164 -616q-7 -24 -31 -24h-159q-24 0 -31 24l-166 616h-209l-167 -616q-7 -24 -31 -24h-159q-11 0 -19.5 7t-10.5 17l-160 616h-208q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h175l-33 128h-142q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h109l-89 344q-5 15 5 28 q10 12 26 12h137q26 0 31 -24l90 -360h359l97 360q7 24 31 24h126q24 0 31 -24l98 -360h365l93 360q5 24 31 24h137q16 0 26 -12q10 -13 5 -28l-91 -344h111q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-145l-34 -128h179q14 0 23 -9t9 -23z" />
+<glyph unicode="&#xf15a;" horiz-adv-x="1280" d="M1167 896q18 -182 -131 -258q117 -28 175 -103t45 -214q-7 -71 -32.5 -125t-64.5 -89t-97 -58.5t-121.5 -34.5t-145.5 -15v-255h-154v251q-80 0 -122 1v-252h-154v255q-18 0 -54 0.5t-55 0.5h-200l31 183h111q50 0 58 51v402h16q-6 1 -16 1v287q-13 68 -89 68h-111v164 l212 -1q64 0 97 1v252h154v-247q82 2 122 2v245h154v-252q79 -7 140 -22.5t113 -45t82.5 -78t36.5 -114.5zM952 351q0 36 -15 64t-37 46t-57.5 30.5t-65.5 18.5t-74 9t-69 3t-64.5 -1t-47.5 -1v-338q8 0 37 -0.5t48 -0.5t53 1.5t58.5 4t57 8.5t55.5 14t47.5 21t39.5 30 t24.5 40t9.5 51zM881 827q0 33 -12.5 58.5t-30.5 42t-48 28t-55 16.5t-61.5 8t-58 2.5t-54 -1t-39.5 -0.5v-307q5 0 34.5 -0.5t46.5 0t50 2t55 5.5t51.5 11t48.5 18.5t37 27t27 38.5t9 51z" />
+<glyph unicode="&#xf15b;" d="M1024 1024v472q22 -14 36 -28l408 -408q14 -14 28 -36h-472zM896 992q0 -40 28 -68t68 -28h544v-1056q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h800v-544z" />
+<glyph unicode="&#xf15c;" d="M1468 1060q14 -14 28 -36h-472v472q22 -14 36 -28zM992 896h544v-1056q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h800v-544q0 -40 28 -68t68 -28zM1152 160v64q0 14 -9 23t-23 9h-704q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h704 q14 0 23 9t9 23zM1152 416v64q0 14 -9 23t-23 9h-704q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h704q14 0 23 9t9 23zM1152 672v64q0 14 -9 23t-23 9h-704q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h704q14 0 23 9t9 23z" />
+<glyph unicode="&#xf15d;" horiz-adv-x="1664" d="M1191 1128h177l-72 218l-12 47q-2 16 -2 20h-4l-3 -20q0 -1 -3.5 -18t-7.5 -29zM736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192q14 0 23 -9t9 -23zM1572 -23 v-233h-584v90l369 529q12 18 21 27l11 9v3q-2 0 -6.5 -0.5t-7.5 -0.5q-12 -3 -30 -3h-232v-115h-120v229h567v-89l-369 -530q-6 -8 -21 -26l-11 -11v-2l14 2q9 2 30 2h248v119h121zM1661 874v-106h-288v106h75l-47 144h-243l-47 -144h75v-106h-287v106h70l230 662h162 l230 -662h70z" />
+<glyph unicode="&#xf15e;" horiz-adv-x="1664" d="M1191 104h177l-72 218l-12 47q-2 16 -2 20h-4l-3 -20q0 -1 -3.5 -18t-7.5 -29zM736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192q14 0 23 -9t9 -23zM1661 -150 v-106h-288v106h75l-47 144h-243l-47 -144h75v-106h-287v106h70l230 662h162l230 -662h70zM1572 1001v-233h-584v90l369 529q12 18 21 27l11 9v3q-2 0 -6.5 -0.5t-7.5 -0.5q-12 -3 -30 -3h-232v-115h-120v229h567v-89l-369 -530q-6 -8 -21 -26l-11 -10v-3l14 3q9 1 30 1h248 v119h121z" />
+<glyph unicode="&#xf160;" horiz-adv-x="1792" d="M736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192q14 0 23 -9t9 -23zM1792 -32v-192q0 -14 -9 -23t-23 -9h-832q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h832 q14 0 23 -9t9 -23zM1600 480v-192q0 -14 -9 -23t-23 -9h-640q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h640q14 0 23 -9t9 -23zM1408 992v-192q0 -14 -9 -23t-23 -9h-448q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h448q14 0 23 -9t9 -23zM1216 1504v-192q0 -14 -9 -23t-23 -9h-256 q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h256q14 0 23 -9t9 -23z" />
+<glyph unicode="&#xf161;" horiz-adv-x="1792" d="M1216 -32v-192q0 -14 -9 -23t-23 -9h-256q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h256q14 0 23 -9t9 -23zM736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192 q14 0 23 -9t9 -23zM1408 480v-192q0 -14 -9 -23t-23 -9h-448q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h448q14 0 23 -9t9 -23zM1600 992v-192q0 -14 -9 -23t-23 -9h-640q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h640q14 0 23 -9t9 -23zM1792 1504v-192q0 -14 -9 -23t-23 -9h-832 q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h832q14 0 23 -9t9 -23z" />
+<glyph unicode="&#xf162;" d="M1346 223q0 63 -44 116t-103 53q-52 0 -83 -37t-31 -94t36.5 -95t104.5 -38q50 0 85 27t35 68zM736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192q14 0 23 -9t9 -23 zM1486 165q0 -62 -13 -121.5t-41 -114t-68 -95.5t-98.5 -65.5t-127.5 -24.5q-62 0 -108 16q-24 8 -42 15l39 113q15 -7 31 -11q37 -13 75 -13q84 0 134.5 58.5t66.5 145.5h-2q-21 -23 -61.5 -37t-84.5 -14q-106 0 -173 71.5t-67 172.5q0 105 72 178t181 73q123 0 205 -94.5 t82 -252.5zM1456 882v-114h-469v114h167v432q0 7 0.5 19t0.5 17v16h-2l-7 -12q-8 -13 -26 -31l-62 -58l-82 86l192 185h123v-654h165z" />
+<glyph unicode="&#xf163;" d="M1346 1247q0 63 -44 116t-103 53q-52 0 -83 -37t-31 -94t36.5 -95t104.5 -38q50 0 85 27t35 68zM736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192q14 0 23 -9 t9 -23zM1456 -142v-114h-469v114h167v432q0 7 0.5 19t0.5 17v16h-2l-7 -12q-8 -13 -26 -31l-62 -58l-82 86l192 185h123v-654h165zM1486 1189q0 -62 -13 -121.5t-41 -114t-68 -95.5t-98.5 -65.5t-127.5 -24.5q-62 0 -108 16q-24 8 -42 15l39 113q15 -7 31 -11q37 -13 75 -13 q84 0 134.5 58.5t66.5 145.5h-2q-21 -23 -61.5 -37t-84.5 -14q-106 0 -173 71.5t-67 172.5q0 105 72 178t181 73q123 0 205 -94.5t82 -252.5z" />
+<glyph unicode="&#xf164;" horiz-adv-x="1664" d="M256 192q0 26 -19 45t-45 19q-27 0 -45.5 -19t-18.5 -45q0 -27 18.5 -45.5t45.5 -18.5q26 0 45 18.5t19 45.5zM416 704v-640q0 -26 -19 -45t-45 -19h-288q-26 0 -45 19t-19 45v640q0 26 19 45t45 19h288q26 0 45 -19t19 -45zM1600 704q0 -86 -55 -149q15 -44 15 -76 q3 -76 -43 -137q17 -56 0 -117q-15 -57 -54 -94q9 -112 -49 -181q-64 -76 -197 -78h-36h-76h-17q-66 0 -144 15.5t-121.5 29t-120.5 39.5q-123 43 -158 44q-26 1 -45 19.5t-19 44.5v641q0 25 18 43.5t43 20.5q24 2 76 59t101 121q68 87 101 120q18 18 31 48t17.5 48.5 t13.5 60.5q7 39 12.5 61t19.5 52t34 50q19 19 45 19q46 0 82.5 -10.5t60 -26t40 -40.5t24 -45t12 -50t5 -45t0.5 -39q0 -38 -9.5 -76t-19 -60t-27.5 -56q-3 -6 -10 -18t-11 -22t-8 -24h277q78 0 135 -57t57 -135z" />
+<glyph unicode="&#xf165;" horiz-adv-x="1664" d="M256 960q0 -26 -19 -45t-45 -19q-27 0 -45.5 19t-18.5 45q0 27 18.5 45.5t45.5 18.5q26 0 45 -18.5t19 -45.5zM416 448v640q0 26 -19 45t-45 19h-288q-26 0 -45 -19t-19 -45v-640q0 -26 19 -45t45 -19h288q26 0 45 19t19 45zM1545 597q55 -61 55 -149q-1 -78 -57.5 -135 t-134.5 -57h-277q4 -14 8 -24t11 -22t10 -18q18 -37 27 -57t19 -58.5t10 -76.5q0 -24 -0.5 -39t-5 -45t-12 -50t-24 -45t-40 -40.5t-60 -26t-82.5 -10.5q-26 0 -45 19q-20 20 -34 50t-19.5 52t-12.5 61q-9 42 -13.5 60.5t-17.5 48.5t-31 48q-33 33 -101 120q-49 64 -101 121 t-76 59q-25 2 -43 20.5t-18 43.5v641q0 26 19 44.5t45 19.5q35 1 158 44q77 26 120.5 39.5t121.5 29t144 15.5h17h76h36q133 -2 197 -78q58 -69 49 -181q39 -37 54 -94q17 -61 0 -117q46 -61 43 -137q0 -32 -15 -76z" />
+<glyph unicode="&#xf166;" d="M919 233v157q0 50 -29 50q-17 0 -33 -16v-224q16 -16 33 -16q29 0 29 49zM1103 355h66v34q0 51 -33 51t-33 -51v-34zM532 621v-70h-80v-423h-74v423h-78v70h232zM733 495v-367h-67v40q-39 -45 -76 -45q-33 0 -42 28q-6 16 -6 54v290h66v-270q0 -24 1 -26q1 -15 15 -15 q20 0 42 31v280h67zM985 384v-146q0 -52 -7 -73q-12 -42 -53 -42q-35 0 -68 41v-36h-67v493h67v-161q32 40 68 40q41 0 53 -42q7 -21 7 -74zM1236 255v-9q0 -29 -2 -43q-3 -22 -15 -40q-27 -40 -80 -40q-52 0 -81 38q-21 27 -21 86v129q0 59 20 86q29 38 80 38t78 -38 q21 -28 21 -86v-76h-133v-65q0 -51 34 -51q24 0 30 26q0 1 0.5 7t0.5 16.5v21.5h68zM785 1079v-156q0 -51 -32 -51t-32 51v156q0 52 32 52t32 -52zM1318 366q0 177 -19 260q-10 44 -43 73.5t-76 34.5q-136 15 -412 15q-275 0 -411 -15q-44 -5 -76.5 -34.5t-42.5 -73.5 q-20 -87 -20 -260q0 -176 20 -260q10 -43 42.5 -73t75.5 -35q137 -15 412 -15t412 15q43 5 75.5 35t42.5 73q20 84 20 260zM563 1017l90 296h-75l-51 -195l-53 195h-78l24 -69t23 -69q35 -103 46 -158v-201h74v201zM852 936v130q0 58 -21 87q-29 38 -78 38q-51 0 -78 -38 q-21 -29 -21 -87v-130q0 -58 21 -87q27 -38 78 -38q49 0 78 38q21 27 21 87zM1033 816h67v370h-67v-283q-22 -31 -42 -31q-15 0 -16 16q-1 2 -1 26v272h-67v-293q0 -37 6 -55q11 -27 43 -27q36 0 77 45v-40zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960 q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf167;" d="M971 292v-211q0 -67 -39 -67q-23 0 -45 22v301q22 22 45 22q39 0 39 -67zM1309 291v-46h-90v46q0 68 45 68t45 -68zM343 509h107v94h-312v-94h105v-569h100v569zM631 -60h89v494h-89v-378q-30 -42 -57 -42q-18 0 -21 21q-1 3 -1 35v364h-89v-391q0 -49 8 -73 q12 -37 58 -37q48 0 102 61v-54zM1060 88v197q0 73 -9 99q-17 56 -71 56q-50 0 -93 -54v217h-89v-663h89v48q45 -55 93 -55q54 0 71 55q9 27 9 100zM1398 98v13h-91q0 -51 -2 -61q-7 -36 -40 -36q-46 0 -46 69v87h179v103q0 79 -27 116q-39 51 -106 51q-68 0 -107 -51 q-28 -37 -28 -116v-173q0 -79 29 -116q39 -51 108 -51q72 0 108 53q18 27 21 54q2 9 2 58zM790 1011v210q0 69 -43 69t-43 -69v-210q0 -70 43 -70t43 70zM1509 260q0 -234 -26 -350q-14 -59 -58 -99t-102 -46q-184 -21 -555 -21t-555 21q-58 6 -102.5 46t-57.5 99 q-26 112 -26 350q0 234 26 350q14 59 58 99t103 47q183 20 554 20t555 -20q58 -7 102.5 -47t57.5 -99q26 -112 26 -350zM511 1536h102l-121 -399v-271h-100v271q-14 74 -61 212q-37 103 -65 187h106l71 -263zM881 1203v-175q0 -81 -28 -118q-37 -51 -106 -51q-67 0 -105 51 q-28 38 -28 118v175q0 80 28 117q38 51 105 51q69 0 106 -51q28 -37 28 -117zM1216 1365v-499h-91v55q-53 -62 -103 -62q-46 0 -59 37q-8 24 -8 75v394h91v-367q0 -33 1 -35q3 -22 21 -22q27 0 57 43v381h91z" />
+<glyph unicode="&#xf168;" horiz-adv-x="1408" d="M597 869q-10 -18 -257 -456q-27 -46 -65 -46h-239q-21 0 -31 17t0 36l253 448q1 0 0 1l-161 279q-12 22 -1 37q9 15 32 15h239q40 0 66 -45zM1403 1511q11 -16 0 -37l-528 -934v-1l336 -615q11 -20 1 -37q-10 -15 -32 -15h-239q-42 0 -66 45l-339 622q18 32 531 942 q25 45 64 45h241q22 0 31 -15z" />
+<glyph unicode="&#xf169;" d="M685 771q0 1 -126 222q-21 34 -52 34h-184q-18 0 -26 -11q-7 -12 1 -29l125 -216v-1l-196 -346q-9 -14 0 -28q8 -13 24 -13h185q31 0 50 36zM1309 1268q-7 12 -24 12h-187q-30 0 -49 -35l-411 -729q1 -2 262 -481q20 -35 52 -35h184q18 0 25 12q8 13 -1 28l-260 476v1 l409 723q8 16 0 28zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf16a;" horiz-adv-x="1792" d="M1280 640q0 37 -30 54l-512 320q-31 20 -65 2q-33 -18 -33 -56v-640q0 -38 33 -56q16 -8 31 -8q20 0 34 10l512 320q30 17 30 54zM1792 640q0 -96 -1 -150t-8.5 -136.5t-22.5 -147.5q-16 -73 -69 -123t-124 -58q-222 -25 -671 -25t-671 25q-71 8 -124.5 58t-69.5 123 q-14 65 -21.5 147.5t-8.5 136.5t-1 150t1 150t8.5 136.5t22.5 147.5q16 73 69 123t124 58q222 25 671 25t671 -25q71 -8 124.5 -58t69.5 -123q14 -65 21.5 -147.5t8.5 -136.5t1 -150z" />
+<glyph unicode="&#xf16b;" horiz-adv-x="1792" d="M402 829l494 -305l-342 -285l-490 319zM1388 274v-108l-490 -293v-1l-1 1l-1 -1v1l-489 293v108l147 -96l342 284v2l1 -1l1 1v-2l343 -284zM554 1418l342 -285l-494 -304l-338 270zM1390 829l338 -271l-489 -319l-343 285zM1239 1418l489 -319l-338 -270l-494 304z" />
+<glyph unicode="&#xf16c;" d="M1289 -96h-1118v480h-160v-640h1438v640h-160v-480zM347 428l33 157l783 -165l-33 -156zM450 802l67 146l725 -339l-67 -145zM651 1158l102 123l614 -513l-102 -123zM1048 1536l477 -641l-128 -96l-477 641zM330 65v159h800v-159h-800z" />
+<glyph unicode="&#xf16d;" d="M1024 640q0 106 -75 181t-181 75t-181 -75t-75 -181t75 -181t181 -75t181 75t75 181zM1162 640q0 -164 -115 -279t-279 -115t-279 115t-115 279t115 279t279 115t279 -115t115 -279zM1270 1050q0 -38 -27 -65t-65 -27t-65 27t-27 65t27 65t65 27t65 -27t27 -65zM768 1270 q-7 0 -76.5 0.5t-105.5 0t-96.5 -3t-103 -10t-71.5 -18.5q-50 -20 -88 -58t-58 -88q-11 -29 -18.5 -71.5t-10 -103t-3 -96.5t0 -105.5t0.5 -76.5t-0.5 -76.5t0 -105.5t3 -96.5t10 -103t18.5 -71.5q20 -50 58 -88t88 -58q29 -11 71.5 -18.5t103 -10t96.5 -3t105.5 0t76.5 0.5 t76.5 -0.5t105.5 0t96.5 3t103 10t71.5 18.5q50 20 88 58t58 88q11 29 18.5 71.5t10 103t3 96.5t0 105.5t-0.5 76.5t0.5 76.5t0 105.5t-3 96.5t-10 103t-18.5 71.5q-20 50 -58 88t-88 58q-29 11 -71.5 18.5t-103 10t-96.5 3t-105.5 0t-76.5 -0.5zM1536 640q0 -229 -5 -317 q-10 -208 -124 -322t-322 -124q-88 -5 -317 -5t-317 5q-208 10 -322 124t-124 322q-5 88 -5 317t5 317q10 208 124 322t322 124q88 5 317 5t317 -5q208 -10 322 -124t124 -322q5 -88 5 -317z" />
+<glyph unicode="&#xf16e;" d="M1248 1408q119 0 203.5 -84.5t84.5 -203.5v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960zM698 640q0 88 -62 150t-150 62t-150 -62t-62 -150t62 -150t150 -62t150 62t62 150zM1262 640q0 88 -62 150 t-150 62t-150 -62t-62 -150t62 -150t150 -62t150 62t62 150z" />
+<glyph unicode="&#xf170;" d="M768 914l201 -306h-402zM1133 384h94l-459 691l-459 -691h94l104 160h522zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf171;" horiz-adv-x="1408" d="M815 677q8 -63 -50.5 -101t-111.5 -6q-39 17 -53.5 58t-0.5 82t52 58q36 18 72.5 12t64 -35.5t27.5 -67.5zM926 698q-14 107 -113 164t-197 13q-63 -28 -100.5 -88.5t-34.5 -129.5q4 -91 77.5 -155t165.5 -56q91 8 152 84t50 168zM1165 1240q-20 27 -56 44.5t-58 22 t-71 12.5q-291 47 -566 -2q-43 -7 -66 -12t-55 -22t-50 -43q30 -28 76 -45.5t73.5 -22t87.5 -11.5q228 -29 448 -1q63 8 89.5 12t72.5 21.5t75 46.5zM1222 205q-8 -26 -15.5 -76.5t-14 -84t-28.5 -70t-58 -56.5q-86 -48 -189.5 -71.5t-202 -22t-201.5 18.5q-46 8 -81.5 18 t-76.5 27t-73 43.5t-52 61.5q-25 96 -57 292l6 16l18 9q223 -148 506.5 -148t507.5 148q21 -6 24 -23t-5 -45t-8 -37zM1403 1166q-26 -167 -111 -655q-5 -30 -27 -56t-43.5 -40t-54.5 -31q-252 -126 -610 -88q-248 27 -394 139q-15 12 -25.5 26.5t-17 35t-9 34t-6 39.5 t-5.5 35q-9 50 -26.5 150t-28 161.5t-23.5 147.5t-22 158q3 26 17.5 48.5t31.5 37.5t45 30t46 22.5t48 18.5q125 46 313 64q379 37 676 -50q155 -46 215 -122q16 -20 16.5 -51t-5.5 -54z" />
+<glyph unicode="&#xf172;" d="M848 666q0 43 -41 66t-77 1q-43 -20 -42.5 -72.5t43.5 -70.5q39 -23 81 4t36 72zM928 682q8 -66 -36 -121t-110 -61t-119 40t-56 113q-2 49 25.5 93t72.5 64q70 31 141.5 -10t81.5 -118zM1100 1073q-20 -21 -53.5 -34t-53 -16t-63.5 -8q-155 -20 -324 0q-44 6 -63 9.5 t-52.5 16t-54.5 32.5q13 19 36 31t40 15.5t47 8.5q198 35 408 1q33 -5 51 -8.5t43 -16t39 -31.5zM1142 327q0 7 5.5 26.5t3 32t-17.5 16.5q-161 -106 -365 -106t-366 106l-12 -6l-5 -12q26 -154 41 -210q47 -81 204 -108q249 -46 428 53q34 19 49 51.5t22.5 85.5t12.5 71z M1272 1020q9 53 -8 75q-43 55 -155 88q-216 63 -487 36q-132 -12 -226 -46q-38 -15 -59.5 -25t-47 -34t-29.5 -54q8 -68 19 -138t29 -171t24 -137q1 -5 5 -31t7 -36t12 -27t22 -28q105 -80 284 -100q259 -28 440 63q24 13 39.5 23t31 29t19.5 40q48 267 80 473zM1536 1120 v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf173;" horiz-adv-x="1024" d="M944 207l80 -237q-23 -35 -111 -66t-177 -32q-104 -2 -190.5 26t-142.5 74t-95 106t-55.5 120t-16.5 118v544h-168v215q72 26 129 69.5t91 90t58 102t34 99t15 88.5q1 5 4.5 8.5t7.5 3.5h244v-424h333v-252h-334v-518q0 -30 6.5 -56t22.5 -52.5t49.5 -41.5t81.5 -14 q78 2 134 29z" />
+<glyph unicode="&#xf174;" d="M1136 75l-62 183q-44 -22 -103 -22q-36 -1 -62 10.5t-38.5 31.5t-17.5 40.5t-5 43.5v398h257v194h-256v326h-188q-8 0 -9 -10q-5 -44 -17.5 -87t-39 -95t-77 -95t-118.5 -68v-165h130v-418q0 -57 21.5 -115t65 -111t121 -85.5t176.5 -30.5q69 1 136.5 25t85.5 50z M1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf175;" horiz-adv-x="768" d="M765 237q8 -19 -5 -35l-350 -384q-10 -10 -23 -10q-14 0 -24 10l-355 384q-13 16 -5 35q9 19 29 19h224v1248q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1248h224q21 0 29 -19z" />
+<glyph unicode="&#xf176;" horiz-adv-x="768" d="M765 1043q-9 -19 -29 -19h-224v-1248q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v1248h-224q-21 0 -29 19t5 35l350 384q10 10 23 10q14 0 24 -10l355 -384q13 -16 5 -35z" />
+<glyph unicode="&#xf177;" horiz-adv-x="1792" d="M1792 736v-192q0 -14 -9 -23t-23 -9h-1248v-224q0 -21 -19 -29t-35 5l-384 350q-10 10 -10 23q0 14 10 24l384 354q16 14 35 6q19 -9 19 -29v-224h1248q14 0 23 -9t9 -23z" />
+<glyph unicode="&#xf178;" horiz-adv-x="1792" d="M1728 643q0 -14 -10 -24l-384 -354q-16 -14 -35 -6q-19 9 -19 29v224h-1248q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h1248v224q0 21 19 29t35 -5l384 -350q10 -10 10 -23z" />
+<glyph unicode="&#xf179;" horiz-adv-x="1408" d="M1393 321q-39 -125 -123 -250q-129 -196 -257 -196q-49 0 -140 32q-86 32 -151 32q-61 0 -142 -33q-81 -34 -132 -34q-152 0 -301 259q-147 261 -147 503q0 228 113 374q112 144 284 144q72 0 177 -30q104 -30 138 -30q45 0 143 34q102 34 173 34q119 0 213 -65 q52 -36 104 -100q-79 -67 -114 -118q-65 -94 -65 -207q0 -124 69 -223t158 -126zM1017 1494q0 -61 -29 -136q-30 -75 -93 -138q-54 -54 -108 -72q-37 -11 -104 -17q3 149 78 257q74 107 250 148q1 -3 2.5 -11t2.5 -11q0 -4 0.5 -10t0.5 -10z" />
+<glyph unicode="&#xf17a;" horiz-adv-x="1664" d="M682 530v-651l-682 94v557h682zM682 1273v-659h-682v565zM1664 530v-786l-907 125v661h907zM1664 1408v-794h-907v669z" />
+<glyph unicode="&#xf17b;" horiz-adv-x="1408" d="M493 1053q16 0 27.5 11.5t11.5 27.5t-11.5 27.5t-27.5 11.5t-27 -11.5t-11 -27.5t11 -27.5t27 -11.5zM915 1053q16 0 27 11.5t11 27.5t-11 27.5t-27 11.5t-27.5 -11.5t-11.5 -27.5t11.5 -27.5t27.5 -11.5zM103 869q42 0 72 -30t30 -72v-430q0 -43 -29.5 -73t-72.5 -30 t-73 30t-30 73v430q0 42 30 72t73 30zM1163 850v-666q0 -46 -32 -78t-77 -32h-75v-227q0 -43 -30 -73t-73 -30t-73 30t-30 73v227h-138v-227q0 -43 -30 -73t-73 -30q-42 0 -72 30t-30 73l-1 227h-74q-46 0 -78 32t-32 78v666h918zM931 1255q107 -55 171 -153.5t64 -215.5 h-925q0 117 64 215.5t172 153.5l-71 131q-7 13 5 20q13 6 20 -6l72 -132q95 42 201 42t201 -42l72 132q7 12 20 6q12 -7 5 -20zM1408 767v-430q0 -43 -30 -73t-73 -30q-42 0 -72 30t-30 73v430q0 43 30 72.5t72 29.5q43 0 73 -29.5t30 -72.5z" />
+<glyph unicode="&#xf17c;" d="M663 1125q-11 -1 -15.5 -10.5t-8.5 -9.5q-5 -1 -5 5q0 12 19 15h10zM750 1111q-4 -1 -11.5 6.5t-17.5 4.5q24 11 32 -2q3 -6 -3 -9zM399 684q-4 1 -6 -3t-4.5 -12.5t-5.5 -13.5t-10 -13q-7 -10 -1 -12q4 -1 12.5 7t12.5 18q1 3 2 7t2 6t1.5 4.5t0.5 4v3t-1 2.5t-3 2z M1254 325q0 18 -55 42q4 15 7.5 27.5t5 26t3 21.5t0.5 22.5t-1 19.5t-3.5 22t-4 20.5t-5 25t-5.5 26.5q-10 48 -47 103t-72 75q24 -20 57 -83q87 -162 54 -278q-11 -40 -50 -42q-31 -4 -38.5 18.5t-8 83.5t-11.5 107q-9 39 -19.5 69t-19.5 45.5t-15.5 24.5t-13 15t-7.5 7 q-14 62 -31 103t-29.5 56t-23.5 33t-15 40q-4 21 6 53.5t4.5 49.5t-44.5 25q-15 3 -44.5 18t-35.5 16q-8 1 -11 26t8 51t36 27q37 3 51 -30t4 -58q-11 -19 -2 -26.5t30 -0.5q13 4 13 36v37q-5 30 -13.5 50t-21 30.5t-23.5 15t-27 7.5q-107 -8 -89 -134q0 -15 -1 -15 q-9 9 -29.5 10.5t-33 -0.5t-15.5 5q1 57 -16 90t-45 34q-27 1 -41.5 -27.5t-16.5 -59.5q-1 -15 3.5 -37t13 -37.5t15.5 -13.5q10 3 16 14q4 9 -7 8q-7 0 -15.5 14.5t-9.5 33.5q-1 22 9 37t34 14q17 0 27 -21t9.5 -39t-1.5 -22q-22 -15 -31 -29q-8 -12 -27.5 -23.5 t-20.5 -12.5q-13 -14 -15.5 -27t7.5 -18q14 -8 25 -19.5t16 -19t18.5 -13t35.5 -6.5q47 -2 102 15q2 1 23 7t34.5 10.5t29.5 13t21 17.5q9 14 20 8q5 -3 6.5 -8.5t-3 -12t-16.5 -9.5q-20 -6 -56.5 -21.5t-45.5 -19.5q-44 -19 -70 -23q-25 -5 -79 2q-10 2 -9 -2t17 -19 q25 -23 67 -22q17 1 36 7t36 14t33.5 17.5t30 17t24.5 12t17.5 2.5t8.5 -11q0 -2 -1 -4.5t-4 -5t-6 -4.5t-8.5 -5t-9 -4.5t-10 -5t-9.5 -4.5q-28 -14 -67.5 -44t-66.5 -43t-49 -1q-21 11 -63 73q-22 31 -25 22q-1 -3 -1 -10q0 -25 -15 -56.5t-29.5 -55.5t-21 -58t11.5 -63 q-23 -6 -62.5 -90t-47.5 -141q-2 -18 -1.5 -69t-5.5 -59q-8 -24 -29 -3q-32 31 -36 94q-2 28 4 56q4 19 -1 18l-4 -5q-36 -65 10 -166q5 -12 25 -28t24 -20q20 -23 104 -90.5t93 -76.5q16 -15 17.5 -38t-14 -43t-45.5 -23q8 -15 29 -44.5t28 -54t7 -70.5q46 24 7 92 q-4 8 -10.5 16t-9.5 12t-2 6q3 5 13 9.5t20 -2.5q46 -52 166 -36q133 15 177 87q23 38 34 30q12 -6 10 -52q-1 -25 -23 -92q-9 -23 -6 -37.5t24 -15.5q3 19 14.5 77t13.5 90q2 21 -6.5 73.5t-7.5 97t23 70.5q15 18 51 18q1 37 34.5 53t72.5 10.5t60 -22.5zM626 1152 q3 17 -2.5 30t-11.5 15q-9 2 -9 -7q2 -5 5 -6q10 0 7 -15q-3 -20 8 -20q3 0 3 3zM1045 955q-2 8 -6.5 11.5t-13 5t-14.5 5.5q-5 3 -9.5 8t-7 8t-5.5 6.5t-4 4t-4 -1.5q-14 -16 7 -43.5t39 -31.5q9 -1 14.5 8t3.5 20zM867 1168q0 11 -5 19.5t-11 12.5t-9 3q-14 -1 -7 -7l4 -2 q14 -4 18 -31q0 -3 8 2zM921 1401q0 2 -2.5 5t-9 7t-9.5 6q-15 15 -24 15q-9 -1 -11.5 -7.5t-1 -13t-0.5 -12.5q-1 -4 -6 -10.5t-6 -9t3 -8.5q4 -3 8 0t11 9t15 9q1 1 9 1t15 2t9 7zM1486 60q20 -12 31 -24.5t12 -24t-2.5 -22.5t-15.5 -22t-23.5 -19.5t-30 -18.5 t-31.5 -16.5t-32 -15.5t-27 -13q-38 -19 -85.5 -56t-75.5 -64q-17 -16 -68 -19.5t-89 14.5q-18 9 -29.5 23.5t-16.5 25.5t-22 19.5t-47 9.5q-44 1 -130 1q-19 0 -57 -1.5t-58 -2.5q-44 -1 -79.5 -15t-53.5 -30t-43.5 -28.5t-53.5 -11.5q-29 1 -111 31t-146 43q-19 4 -51 9.5 t-50 9t-39.5 9.5t-33.5 14.5t-17 19.5q-10 23 7 66.5t18 54.5q1 16 -4 40t-10 42.5t-4.5 36.5t10.5 27q14 12 57 14t60 12q30 18 42 35t12 51q21 -73 -32 -106q-32 -20 -83 -15q-34 3 -43 -10q-13 -15 5 -57q2 -6 8 -18t8.5 -18t4.5 -17t1 -22q0 -15 -17 -49t-14 -48 q3 -17 37 -26q20 -6 84.5 -18.5t99.5 -20.5q24 -6 74 -22t82.5 -23t55.5 -4q43 6 64.5 28t23 48t-7.5 58.5t-19 52t-20 36.5q-121 190 -169 242q-68 74 -113 40q-11 -9 -15 15q-3 16 -2 38q1 29 10 52t24 47t22 42q8 21 26.5 72t29.5 78t30 61t39 54q110 143 124 195 q-12 112 -16 310q-2 90 24 151.5t106 104.5q39 21 104 21q53 1 106 -13.5t89 -41.5q57 -42 91.5 -121.5t29.5 -147.5q-5 -95 30 -214q34 -113 133 -218q55 -59 99.5 -163t59.5 -191q8 -49 5 -84.5t-12 -55.5t-20 -22q-10 -2 -23.5 -19t-27 -35.5t-40.5 -33.5t-61 -14 q-18 1 -31.5 5t-22.5 13.5t-13.5 15.5t-11.5 20.5t-9 19.5q-22 37 -41 30t-28 -49t7 -97q20 -70 1 -195q-10 -65 18 -100.5t73 -33t85 35.5q59 49 89.5 66.5t103.5 42.5q53 18 77 36.5t18.5 34.5t-25 28.5t-51.5 23.5q-33 11 -49.5 48t-15 72.5t15.5 47.5q1 -31 8 -56.5 t14.5 -40.5t20.5 -28.5t21 -19t21.5 -13t16.5 -9.5z" />
+<glyph unicode="&#xf17d;" d="M1024 36q-42 241 -140 498h-2l-2 -1q-16 -6 -43 -16.5t-101 -49t-137 -82t-131 -114.5t-103 -148l-15 11q184 -150 418 -150q132 0 256 52zM839 643q-21 49 -53 111q-311 -93 -673 -93q-1 -7 -1 -21q0 -124 44 -236.5t124 -201.5q50 89 123.5 166.5t142.5 124.5t130.5 81 t99.5 48l37 13q4 1 13 3.5t13 4.5zM732 855q-120 213 -244 378q-138 -65 -234 -186t-128 -272q302 0 606 80zM1416 536q-210 60 -409 29q87 -239 128 -469q111 75 185 189.5t96 250.5zM611 1277q-1 0 -2 -1q1 1 2 1zM1201 1132q-185 164 -433 164q-76 0 -155 -19 q131 -170 246 -382q69 26 130 60.5t96.5 61.5t65.5 57t37.5 40.5zM1424 647q-3 232 -149 410l-1 -1q-9 -12 -19 -24.5t-43.5 -44.5t-71 -60.5t-100 -65t-131.5 -64.5q25 -53 44 -95q2 -6 6.5 -17.5t7.5 -16.5q36 5 74.5 7t73.5 2t69 -1.5t64 -4t56.5 -5.5t48 -6.5t36.5 -6 t25 -4.5zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf17e;" d="M1173 473q0 50 -19.5 91.5t-48.5 68.5t-73 49t-82.5 34t-87.5 23l-104 24q-30 7 -44 10.5t-35 11.5t-30 16t-16.5 21t-7.5 30q0 77 144 77q43 0 77 -12t54 -28.5t38 -33.5t40 -29t48 -12q47 0 75.5 32t28.5 77q0 55 -56 99.5t-142 67.5t-182 23q-68 0 -132 -15.5 t-119.5 -47t-89 -87t-33.5 -128.5q0 -61 19 -106.5t56 -75.5t80 -48.5t103 -32.5l146 -36q90 -22 112 -36q32 -20 32 -60q0 -39 -40 -64.5t-105 -25.5q-51 0 -91.5 16t-65 38.5t-45.5 45t-46 38.5t-54 16q-50 0 -75.5 -30t-25.5 -75q0 -92 122 -157.5t291 -65.5 q73 0 140 18.5t122.5 53.5t88.5 93.5t33 131.5zM1536 256q0 -159 -112.5 -271.5t-271.5 -112.5q-130 0 -234 80q-77 -16 -150 -16q-143 0 -273.5 55.5t-225 150t-150 225t-55.5 273.5q0 73 16 150q-80 104 -80 234q0 159 112.5 271.5t271.5 112.5q130 0 234 -80 q77 16 150 16q143 0 273.5 -55.5t225 -150t150 -225t55.5 -273.5q0 -73 -16 -150q80 -104 80 -234z" />
+<glyph unicode="&#xf180;" horiz-adv-x="1280" d="M1000 1102l37 194q5 23 -9 40t-35 17h-712q-23 0 -38.5 -17t-15.5 -37v-1101q0 -7 6 -1l291 352q23 26 38 33.5t48 7.5h239q22 0 37 14.5t18 29.5q24 130 37 191q4 21 -11.5 40t-36.5 19h-294q-29 0 -48 19t-19 48v42q0 29 19 47.5t48 18.5h346q18 0 35 13.5t20 29.5z M1227 1324q-15 -73 -53.5 -266.5t-69.5 -350t-35 -173.5q-6 -22 -9 -32.5t-14 -32.5t-24.5 -33t-38.5 -21t-58 -10h-271q-13 0 -22 -10q-8 -9 -426 -494q-22 -25 -58.5 -28.5t-48.5 5.5q-55 22 -55 98v1410q0 55 38 102.5t120 47.5h888q95 0 127 -53t10 -159zM1227 1324 l-158 -790q4 17 35 173.5t69.5 350t53.5 266.5z" />
+<glyph unicode="&#xf181;" d="M704 192v1024q0 14 -9 23t-23 9h-480q-14 0 -23 -9t-9 -23v-1024q0 -14 9 -23t23 -9h480q14 0 23 9t9 23zM1376 576v640q0 14 -9 23t-23 9h-480q-14 0 -23 -9t-9 -23v-640q0 -14 9 -23t23 -9h480q14 0 23 9t9 23zM1536 1344v-1408q0 -26 -19 -45t-45 -19h-1408 q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h1408q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf182;" horiz-adv-x="1280" d="M1280 480q0 -40 -28 -68t-68 -28q-51 0 -80 43l-227 341h-45v-132l247 -411q9 -15 9 -33q0 -26 -19 -45t-45 -19h-192v-272q0 -46 -33 -79t-79 -33h-160q-46 0 -79 33t-33 79v272h-192q-26 0 -45 19t-19 45q0 18 9 33l247 411v132h-45l-227 -341q-29 -43 -80 -43 q-40 0 -68 28t-28 68q0 29 16 53l256 384q73 107 176 107h384q103 0 176 -107l256 -384q16 -24 16 -53zM864 1280q0 -93 -65.5 -158.5t-158.5 -65.5t-158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5t158.5 -65.5t65.5 -158.5z" />
+<glyph unicode="&#xf183;" horiz-adv-x="1024" d="M1024 832v-416q0 -40 -28 -68t-68 -28t-68 28t-28 68v352h-64v-912q0 -46 -33 -79t-79 -33t-79 33t-33 79v464h-64v-464q0 -46 -33 -79t-79 -33t-79 33t-33 79v912h-64v-352q0 -40 -28 -68t-68 -28t-68 28t-28 68v416q0 80 56 136t136 56h640q80 0 136 -56t56 -136z M736 1280q0 -93 -65.5 -158.5t-158.5 -65.5t-158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5t158.5 -65.5t65.5 -158.5z" />
+<glyph unicode="&#xf184;" d="M773 234l350 473q16 22 24.5 59t-6 85t-61.5 79q-40 26 -83 25.5t-73.5 -17.5t-54.5 -45q-36 -40 -96 -40q-59 0 -95 40q-24 28 -54.5 45t-73.5 17.5t-84 -25.5q-46 -31 -60.5 -79t-6 -85t24.5 -59zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103 t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf185;" horiz-adv-x="1792" d="M1472 640q0 117 -45.5 223.5t-123 184t-184 123t-223.5 45.5t-223.5 -45.5t-184 -123t-123 -184t-45.5 -223.5t45.5 -223.5t123 -184t184 -123t223.5 -45.5t223.5 45.5t184 123t123 184t45.5 223.5zM1748 363q-4 -15 -20 -20l-292 -96v-306q0 -16 -13 -26q-15 -10 -29 -4 l-292 94l-180 -248q-10 -13 -26 -13t-26 13l-180 248l-292 -94q-14 -6 -29 4q-13 10 -13 26v306l-292 96q-16 5 -20 20q-5 17 4 29l180 248l-180 248q-9 13 -4 29q4 15 20 20l292 96v306q0 16 13 26q15 10 29 4l292 -94l180 248q9 12 26 12t26 -12l180 -248l292 94 q14 6 29 -4q13 -10 13 -26v-306l292 -96q16 -5 20 -20q5 -16 -4 -29l-180 -248l180 -248q9 -12 4 -29z" />
+<glyph unicode="&#xf186;" d="M1262 233q-54 -9 -110 -9q-182 0 -337 90t-245 245t-90 337q0 192 104 357q-201 -60 -328.5 -229t-127.5 -384q0 -130 51 -248.5t136.5 -204t204 -136.5t248.5 -51q144 0 273.5 61.5t220.5 171.5zM1465 318q-94 -203 -283.5 -324.5t-413.5 -121.5q-156 0 -298 61 t-245 164t-164 245t-61 298q0 153 57.5 292.5t156 241.5t235.5 164.5t290 68.5q44 2 61 -39q18 -41 -15 -72q-86 -78 -131.5 -181.5t-45.5 -218.5q0 -148 73 -273t198 -198t273 -73q118 0 228 51q41 18 72 -13q14 -14 17.5 -34t-4.5 -38z" />
+<glyph unicode="&#xf187;" horiz-adv-x="1792" d="M1088 704q0 26 -19 45t-45 19h-256q-26 0 -45 -19t-19 -45t19 -45t45 -19h256q26 0 45 19t19 45zM1664 896v-960q0 -26 -19 -45t-45 -19h-1408q-26 0 -45 19t-19 45v960q0 26 19 45t45 19h1408q26 0 45 -19t19 -45zM1728 1344v-256q0 -26 -19 -45t-45 -19h-1536 q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h1536q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf188;" horiz-adv-x="1664" d="M1632 576q0 -26 -19 -45t-45 -19h-224q0 -171 -67 -290l208 -209q19 -19 19 -45t-19 -45q-18 -19 -45 -19t-45 19l-198 197q-5 -5 -15 -13t-42 -28.5t-65 -36.5t-82 -29t-97 -13v896h-128v-896q-51 0 -101.5 13.5t-87 33t-66 39t-43.5 32.5l-15 14l-183 -207 q-20 -21 -48 -21q-24 0 -43 16q-19 18 -20.5 44.5t15.5 46.5l202 227q-58 114 -58 274h-224q-26 0 -45 19t-19 45t19 45t45 19h224v294l-173 173q-19 19 -19 45t19 45t45 19t45 -19l173 -173h844l173 173q19 19 45 19t45 -19t19 -45t-19 -45l-173 -173v-294h224q26 0 45 -19 t19 -45zM1152 1152h-640q0 133 93.5 226.5t226.5 93.5t226.5 -93.5t93.5 -226.5z" />
+<glyph unicode="&#xf189;" horiz-adv-x="1920" d="M1917 1016q23 -64 -150 -294q-24 -32 -65 -85q-78 -100 -90 -131q-17 -41 14 -81q17 -21 81 -82h1l1 -1l1 -1l2 -2q141 -131 191 -221q3 -5 6.5 -12.5t7 -26.5t-0.5 -34t-25 -27.5t-59 -12.5l-256 -4q-24 -5 -56 5t-52 22l-20 12q-30 21 -70 64t-68.5 77.5t-61 58 t-56.5 15.5q-3 -1 -8 -3.5t-17 -14.5t-21.5 -29.5t-17 -52t-6.5 -77.5q0 -15 -3.5 -27.5t-7.5 -18.5l-4 -5q-18 -19 -53 -22h-115q-71 -4 -146 16.5t-131.5 53t-103 66t-70.5 57.5l-25 24q-10 10 -27.5 30t-71.5 91t-106 151t-122.5 211t-130.5 272q-6 16 -6 27t3 16l4 6 q15 19 57 19l274 2q12 -2 23 -6.5t16 -8.5l5 -3q16 -11 24 -32q20 -50 46 -103.5t41 -81.5l16 -29q29 -60 56 -104t48.5 -68.5t41.5 -38.5t34 -14t27 5q2 1 5 5t12 22t13.5 47t9.5 81t0 125q-2 40 -9 73t-14 46l-6 12q-25 34 -85 43q-13 2 5 24q17 19 38 30q53 26 239 24 q82 -1 135 -13q20 -5 33.5 -13.5t20.5 -24t10.5 -32t3.5 -45.5t-1 -55t-2.5 -70.5t-1.5 -82.5q0 -11 -1 -42t-0.5 -48t3.5 -40.5t11.5 -39t22.5 -24.5q8 -2 17 -4t26 11t38 34.5t52 67t68 107.5q60 104 107 225q4 10 10 17.5t11 10.5l4 3l5 2.5t13 3t20 0.5l288 2 q39 5 64 -2.5t31 -16.5z" />
+<glyph unicode="&#xf18a;" horiz-adv-x="1792" d="M675 252q21 34 11 69t-45 50q-34 14 -73 1t-60 -46q-22 -34 -13 -68.5t43 -50.5t74.5 -2.5t62.5 47.5zM769 373q8 13 3.5 26.5t-17.5 18.5q-14 5 -28.5 -0.5t-21.5 -18.5q-17 -31 13 -45q14 -5 29 0.5t22 18.5zM943 266q-45 -102 -158 -150t-224 -12 q-107 34 -147.5 126.5t6.5 187.5q47 93 151.5 139t210.5 19q111 -29 158.5 -119.5t2.5 -190.5zM1255 426q-9 96 -89 170t-208.5 109t-274.5 21q-223 -23 -369.5 -141.5t-132.5 -264.5q9 -96 89 -170t208.5 -109t274.5 -21q223 23 369.5 141.5t132.5 264.5zM1563 422 q0 -68 -37 -139.5t-109 -137t-168.5 -117.5t-226 -83t-270.5 -31t-275 33.5t-240.5 93t-171.5 151t-65 199.5q0 115 69.5 245t197.5 258q169 169 341.5 236t246.5 -7q65 -64 20 -209q-4 -14 -1 -20t10 -7t14.5 0.5t13.5 3.5l6 2q139 59 246 59t153 -61q45 -63 0 -178 q-2 -13 -4.5 -20t4.5 -12.5t12 -7.5t17 -6q57 -18 103 -47t80 -81.5t34 -116.5zM1489 1046q42 -47 54.5 -108.5t-6.5 -117.5q-8 -23 -29.5 -34t-44.5 -4q-23 8 -34 29.5t-4 44.5q20 63 -24 111t-107 35q-24 -5 -45 8t-25 37q-5 24 8 44.5t37 25.5q60 13 119 -5.5t101 -65.5z M1670 1209q87 -96 112.5 -222.5t-13.5 -241.5q-9 -27 -34 -40t-52 -4t-40 34t-5 52q28 82 10 172t-80 158q-62 69 -148 95.5t-173 8.5q-28 -6 -52 9.5t-30 43.5t9.5 51.5t43.5 29.5q123 26 244 -11.5t208 -134.5z" />
+<glyph unicode="&#xf18b;" d="M1133 -34q-171 -94 -368 -94q-196 0 -367 94q138 87 235.5 211t131.5 268q35 -144 132.5 -268t235.5 -211zM638 1394v-485q0 -252 -126.5 -459.5t-330.5 -306.5q-181 215 -181 495q0 187 83.5 349.5t229.5 269.5t325 137zM1536 638q0 -280 -181 -495 q-204 99 -330.5 306.5t-126.5 459.5v485q179 -30 325 -137t229.5 -269.5t83.5 -349.5z" />
+<glyph unicode="&#xf18c;" horiz-adv-x="1408" d="M1402 433q-32 -80 -76 -138t-91 -88.5t-99 -46.5t-101.5 -14.5t-96.5 8.5t-86.5 22t-69.5 27.5t-46 22.5l-17 10q-113 -228 -289.5 -359.5t-384.5 -132.5q-19 0 -32 13t-13 32t13 31.5t32 12.5q173 1 322.5 107.5t251.5 294.5q-36 -14 -72 -23t-83 -13t-91 2.5t-93 28.5 t-92 59t-84.5 100t-74.5 146q114 47 214 57t167.5 -7.5t124.5 -56.5t88.5 -77t56.5 -82q53 131 79 291q-7 -1 -18 -2.5t-46.5 -2.5t-69.5 0.5t-81.5 10t-88.5 23t-84 42.5t-75 65t-54.5 94.5t-28.5 127.5q70 28 133.5 36.5t112.5 -1t92 -30t73.5 -50t56 -61t42 -63t27.5 -56 t16 -39.5l4 -16q12 122 12 195q-8 6 -21.5 16t-49 44.5t-63.5 71.5t-54 93t-33 112.5t12 127t70 138.5q73 -25 127.5 -61.5t84.5 -76.5t48 -85t20.5 -89t-0.5 -85.5t-13 -76.5t-19 -62t-17 -42l-7 -15q1 -5 1 -50.5t-1 -71.5q3 7 10 18.5t30.5 43t50.5 58t71 55.5t91.5 44.5 t112 14.5t132.5 -24q-2 -78 -21.5 -141.5t-50 -104.5t-69.5 -71.5t-81.5 -45.5t-84.5 -24t-80 -9.5t-67.5 1t-46.5 4.5l-17 3q-23 -147 -73 -283q6 7 18 18.5t49.5 41t77.5 52.5t99.5 42t117.5 20t129 -23.5t137 -77.5z" />
+<glyph unicode="&#xf18d;" horiz-adv-x="1280" d="M1259 283v-66q0 -85 -57.5 -144.5t-138.5 -59.5h-57l-260 -269v269h-529q-81 0 -138.5 59.5t-57.5 144.5v66h1238zM1259 609v-255h-1238v255h1238zM1259 937v-255h-1238v255h1238zM1259 1077v-67h-1238v67q0 84 57.5 143.5t138.5 59.5h846q81 0 138.5 -59.5t57.5 -143.5z " />
+<glyph unicode="&#xf18e;" d="M1152 640q0 -14 -9 -23l-320 -320q-9 -9 -23 -9q-13 0 -22.5 9.5t-9.5 22.5v192h-352q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h352v192q0 14 9 23t23 9q12 0 24 -10l319 -319q9 -9 9 -23zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198 t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf190;" d="M1152 736v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-352v-192q0 -14 -9 -23t-23 -9q-12 0 -24 10l-319 319q-9 9 -9 23t9 23l320 320q9 9 23 9q13 0 22.5 -9.5t9.5 -22.5v-192h352q13 0 22.5 -9.5t9.5 -22.5zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198 t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf191;" d="M1024 960v-640q0 -26 -19 -45t-45 -19q-20 0 -37 12l-448 320q-27 19 -27 52t27 52l448 320q17 12 37 12q26 0 45 -19t19 -45zM1280 160v960q0 13 -9.5 22.5t-22.5 9.5h-960q-13 0 -22.5 -9.5t-9.5 -22.5v-960q0 -13 9.5 -22.5t22.5 -9.5h960q13 0 22.5 9.5t9.5 22.5z M1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf192;" d="M1024 640q0 -106 -75 -181t-181 -75t-181 75t-75 181t75 181t181 75t181 -75t75 -181zM768 1184q-148 0 -273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273t-73 273t-198 198t-273 73zM1536 640q0 -209 -103 -385.5t-279.5 -279.5 t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf193;" horiz-adv-x="1664" d="M1023 349l102 -204q-58 -179 -210 -290t-339 -111q-156 0 -288.5 77.5t-210 210t-77.5 288.5q0 181 104.5 330t274.5 211l17 -131q-122 -54 -195 -165.5t-73 -244.5q0 -185 131.5 -316.5t316.5 -131.5q126 0 232.5 65t165 175.5t49.5 236.5zM1571 249l58 -114l-256 -128 q-13 -7 -29 -7q-40 0 -57 35l-239 477h-472q-24 0 -42.5 16.5t-21.5 40.5l-96 779q-2 16 6 42q14 51 57 82.5t97 31.5q66 0 113 -47t47 -113q0 -69 -52 -117.5t-120 -41.5l37 -289h423v-128h-407l16 -128h455q40 0 57 -35l228 -455z" />
+<glyph unicode="&#xf194;" d="M1292 898q10 216 -161 222q-231 8 -312 -261q44 19 82 19q85 0 74 -96q-4 -57 -74 -167t-105 -110q-43 0 -82 169q-13 54 -45 255q-30 189 -160 177q-59 -7 -164 -100l-81 -72l-81 -72l52 -67q76 52 87 52q57 0 107 -179q15 -55 45 -164.5t45 -164.5q68 -179 164 -179 q157 0 383 294q220 283 226 444zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf195;" horiz-adv-x="1152" d="M1152 704q0 -191 -94.5 -353t-256.5 -256.5t-353 -94.5h-160q-14 0 -23 9t-9 23v611l-215 -66q-3 -1 -9 -1q-10 0 -19 6q-13 10 -13 26v128q0 23 23 31l233 71v93l-215 -66q-3 -1 -9 -1q-10 0 -19 6q-13 10 -13 26v128q0 23 23 31l233 71v250q0 14 9 23t23 9h160 q14 0 23 -9t9 -23v-181l375 116q15 5 28 -5t13 -26v-128q0 -23 -23 -31l-393 -121v-93l375 116q15 5 28 -5t13 -26v-128q0 -23 -23 -31l-393 -121v-487q188 13 318 151t130 328q0 14 9 23t23 9h160q14 0 23 -9t9 -23z" />
+<glyph unicode="&#xf196;" horiz-adv-x="1408" d="M1152 736v-64q0 -14 -9 -23t-23 -9h-352v-352q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v352h-352q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h352v352q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-352h352q14 0 23 -9t9 -23zM1280 288v832q0 66 -47 113t-113 47h-832 q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832q66 0 113 47t47 113zM1408 1120v-832q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h832q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf197;" horiz-adv-x="2176" d="M620 416q-110 -64 -268 -64h-128v64h-64q-13 0 -22.5 23.5t-9.5 56.5q0 24 7 49q-58 2 -96.5 10.5t-38.5 20.5t38.5 20.5t96.5 10.5q-7 25 -7 49q0 33 9.5 56.5t22.5 23.5h64v64h128q158 0 268 -64h1113q42 -7 106.5 -18t80.5 -14q89 -15 150 -40.5t83.5 -47.5t22.5 -40 t-22.5 -40t-83.5 -47.5t-150 -40.5q-16 -3 -80.5 -14t-106.5 -18h-1113zM1739 668q53 -36 53 -92t-53 -92l81 -30q68 48 68 122t-68 122zM625 400h1015q-217 -38 -456 -80q-57 0 -113 -24t-83 -48l-28 -24l-288 -288q-26 -26 -70.5 -45t-89.5 -19h-96l-93 464h29 q157 0 273 64zM352 816h-29l93 464h96q46 0 90 -19t70 -45l288 -288q4 -4 11 -10.5t30.5 -23t48.5 -29t61.5 -23t72.5 -10.5l456 -80h-1015q-116 64 -273 64z" />
+<glyph unicode="&#xf198;" horiz-adv-x="1664" d="M1519 760q62 0 103.5 -40.5t41.5 -101.5q0 -97 -93 -130l-172 -59l56 -167q7 -21 7 -47q0 -59 -42 -102t-101 -43q-47 0 -85.5 27t-53.5 72l-55 165l-310 -106l55 -164q8 -24 8 -47q0 -59 -42 -102t-102 -43q-47 0 -85 27t-53 72l-55 163l-153 -53q-29 -9 -50 -9 q-61 0 -101.5 40t-40.5 101q0 47 27.5 85t71.5 53l156 53l-105 313l-156 -54q-26 -8 -48 -8q-60 0 -101 40.5t-41 100.5q0 47 27.5 85t71.5 53l157 53l-53 159q-8 24 -8 47q0 60 42 102.5t102 42.5q47 0 85 -27t53 -72l54 -160l310 105l-54 160q-8 24 -8 47q0 59 42.5 102 t101.5 43q47 0 85.5 -27.5t53.5 -71.5l53 -161l162 55q21 6 43 6q60 0 102.5 -39.5t42.5 -98.5q0 -45 -30 -81.5t-74 -51.5l-157 -54l105 -316l164 56q24 8 46 8zM725 498l310 105l-105 315l-310 -107z" />
+<glyph unicode="&#xf199;" d="M1248 1408q119 0 203.5 -84.5t84.5 -203.5v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960zM1280 352v436q-31 -35 -64 -55q-34 -22 -132.5 -85t-151.5 -99q-98 -69 -164 -69v0v0q-66 0 -164 69 q-46 32 -141.5 92.5t-142.5 92.5q-12 8 -33 27t-31 27v-436q0 -40 28 -68t68 -28h832q40 0 68 28t28 68zM1280 925q0 41 -27.5 70t-68.5 29h-832q-40 0 -68 -28t-28 -68q0 -37 30.5 -76.5t67.5 -64.5q47 -32 137.5 -89t129.5 -83q3 -2 17 -11.5t21 -14t21 -13t23.5 -13 t21.5 -9.5t22.5 -7.5t20.5 -2.5t20.5 2.5t22.5 7.5t21.5 9.5t23.5 13t21 13t21 14t17 11.5l267 174q35 23 66.5 62.5t31.5 73.5z" />
+<glyph unicode="&#xf19a;" horiz-adv-x="1792" d="M127 640q0 163 67 313l367 -1005q-196 95 -315 281t-119 411zM1415 679q0 -19 -2.5 -38.5t-10 -49.5t-11.5 -44t-17.5 -59t-17.5 -58l-76 -256l-278 826q46 3 88 8q19 2 26 18.5t-2.5 31t-28.5 13.5l-205 -10q-75 1 -202 10q-12 1 -20.5 -5t-11.5 -15t-1.5 -18.5t9 -16.5 t19.5 -8l80 -8l120 -328l-168 -504l-280 832q46 3 88 8q19 2 26 18.5t-2.5 31t-28.5 13.5l-205 -10q-7 0 -23 0.5t-26 0.5q105 160 274.5 253.5t367.5 93.5q147 0 280.5 -53t238.5 -149h-10q-55 0 -92 -40.5t-37 -95.5q0 -12 2 -24t4 -21.5t8 -23t9 -21t12 -22.5t12.5 -21 t14.5 -24t14 -23q63 -107 63 -212zM909 573l237 -647q1 -6 5 -11q-126 -44 -255 -44q-112 0 -217 32zM1570 1009q95 -174 95 -369q0 -209 -104 -385.5t-279 -278.5l235 678q59 169 59 276q0 42 -6 79zM896 1536q182 0 348 -71t286 -191t191 -286t71 -348t-71 -348t-191 -286 t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71zM896 -215q173 0 331.5 68t273 182.5t182.5 273t68 331.5t-68 331.5t-182.5 273t-273 182.5t-331.5 68t-331.5 -68t-273 -182.5t-182.5 -273t-68 -331.5t68 -331.5t182.5 -273 t273 -182.5t331.5 -68z" />
+<glyph unicode="&#xf19b;" horiz-adv-x="1792" d="M1086 1536v-1536l-272 -128q-228 20 -414 102t-293 208.5t-107 272.5q0 140 100.5 263.5t275 205.5t391.5 108v-172q-217 -38 -356.5 -150t-139.5 -255q0 -152 154.5 -267t388.5 -145v1360zM1755 954l37 -390l-525 114l147 83q-119 70 -280 99v172q277 -33 481 -157z" />
+<glyph unicode="&#xf19c;" horiz-adv-x="2048" d="M960 1536l960 -384v-128h-128q0 -26 -20.5 -45t-48.5 -19h-1526q-28 0 -48.5 19t-20.5 45h-128v128zM256 896h256v-768h128v768h256v-768h128v768h256v-768h128v768h256v-768h59q28 0 48.5 -19t20.5 -45v-64h-1664v64q0 26 20.5 45t48.5 19h59v768zM1851 -64 q28 0 48.5 -19t20.5 -45v-128h-1920v128q0 26 20.5 45t48.5 19h1782z" />
+<glyph unicode="&#xf19d;" horiz-adv-x="2304" d="M1774 700l18 -316q4 -69 -82 -128t-235 -93.5t-323 -34.5t-323 34.5t-235 93.5t-82 128l18 316l574 -181q22 -7 48 -7t48 7zM2304 1024q0 -23 -22 -31l-1120 -352q-4 -1 -10 -1t-10 1l-652 206q-43 -34 -71 -111.5t-34 -178.5q63 -36 63 -109q0 -69 -58 -107l58 -433 q2 -14 -8 -25q-9 -11 -24 -11h-192q-15 0 -24 11q-10 11 -8 25l58 433q-58 38 -58 107q0 73 65 111q11 207 98 330l-333 104q-22 8 -22 31t22 31l1120 352q4 1 10 1t10 -1l1120 -352q22 -8 22 -31z" />
+<glyph unicode="&#xf19e;" d="M859 579l13 -707q-62 11 -105 11q-41 0 -105 -11l13 707q-40 69 -168.5 295.5t-216.5 374.5t-181 287q58 -15 108 -15q43 0 111 15q63 -111 133.5 -229.5t167 -276.5t138.5 -227q37 61 109.5 177.5t117.5 190t105 176t107 189.5q54 -14 107 -14q56 0 114 14v0 q-28 -39 -60 -88.5t-49.5 -78.5t-56.5 -96t-49 -84q-146 -248 -353 -610z" />
+<glyph unicode="&#xf1a0;" d="M768 750h725q12 -67 12 -128q0 -217 -91 -387.5t-259.5 -266.5t-386.5 -96q-157 0 -299 60.5t-245 163.5t-163.5 245t-60.5 299t60.5 299t163.5 245t245 163.5t299 60.5q300 0 515 -201l-209 -201q-123 119 -306 119q-129 0 -238.5 -65t-173.5 -176.5t-64 -243.5 t64 -243.5t173.5 -176.5t238.5 -65q87 0 160 24t120 60t82 82t51.5 87t22.5 78h-436v264z" />
+<glyph unicode="&#xf1a1;" horiz-adv-x="1792" d="M1095 369q16 -16 0 -31q-62 -62 -199 -62t-199 62q-16 15 0 31q6 6 15 6t15 -6q48 -49 169 -49q120 0 169 49q6 6 15 6t15 -6zM788 550q0 -37 -26 -63t-63 -26t-63.5 26t-26.5 63q0 38 26.5 64t63.5 26t63 -26.5t26 -63.5zM1183 550q0 -37 -26.5 -63t-63.5 -26t-63 26 t-26 63t26 63.5t63 26.5t63.5 -26t26.5 -64zM1434 670q0 49 -35 84t-85 35t-86 -36q-130 90 -311 96l63 283l200 -45q0 -37 26 -63t63 -26t63.5 26.5t26.5 63.5t-26.5 63.5t-63.5 26.5q-54 0 -80 -50l-221 49q-19 5 -25 -16l-69 -312q-180 -7 -309 -97q-35 37 -87 37 q-50 0 -85 -35t-35 -84q0 -35 18.5 -64t49.5 -44q-6 -27 -6 -56q0 -142 140 -243t337 -101q198 0 338 101t140 243q0 32 -7 57q30 15 48 43.5t18 63.5zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191 t348 71t348 -71t286 -191t191 -286t71 -348z" />
+<glyph unicode="&#xf1a2;" d="M939 407q13 -13 0 -26q-53 -53 -171 -53t-171 53q-13 13 0 26q5 6 13 6t13 -6q42 -42 145 -42t145 42q5 6 13 6t13 -6zM676 563q0 -31 -23 -54t-54 -23t-54 23t-23 54q0 32 22.5 54.5t54.5 22.5t54.5 -22.5t22.5 -54.5zM1014 563q0 -31 -23 -54t-54 -23t-54 23t-23 54 q0 32 22.5 54.5t54.5 22.5t54.5 -22.5t22.5 -54.5zM1229 666q0 42 -30 72t-73 30q-42 0 -73 -31q-113 78 -267 82l54 243l171 -39q1 -32 23.5 -54t53.5 -22q32 0 54.5 22.5t22.5 54.5t-22.5 54.5t-54.5 22.5q-48 0 -69 -43l-189 42q-17 5 -21 -13l-60 -268q-154 -6 -265 -83 q-30 32 -74 32q-43 0 -73 -30t-30 -72q0 -30 16 -55t42 -38q-5 -25 -5 -48q0 -122 120 -208.5t289 -86.5q170 0 290 86.5t120 208.5q0 25 -6 49q25 13 40.5 37.5t15.5 54.5zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960 q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf1a3;" d="M866 697l90 27v62q0 79 -58 135t-138 56t-138 -55.5t-58 -134.5v-283q0 -20 -14 -33.5t-33 -13.5t-32.5 13.5t-13.5 33.5v120h-151v-122q0 -82 57.5 -139t139.5 -57q81 0 138.5 56.5t57.5 136.5v280q0 19 13.5 33t33.5 14q19 0 32.5 -14t13.5 -33v-54zM1199 502v122h-150 v-126q0 -20 -13.5 -33.5t-33.5 -13.5q-19 0 -32.5 14t-13.5 33v123l-90 -26l-60 28v-123q0 -80 58 -137t139 -57t138.5 57t57.5 139zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103 t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf1a4;" horiz-adv-x="1920" d="M1062 824v118q0 42 -30 72t-72 30t-72 -30t-30 -72v-612q0 -175 -126 -299t-303 -124q-178 0 -303.5 125.5t-125.5 303.5v266h328v-262q0 -43 30 -72.5t72 -29.5t72 29.5t30 72.5v620q0 171 126.5 292t301.5 121q176 0 302 -122t126 -294v-136l-195 -58zM1592 602h328 v-266q0 -178 -125.5 -303.5t-303.5 -125.5q-177 0 -303 124.5t-126 300.5v268l131 -61l195 58v-270q0 -42 30 -71.5t72 -29.5t72 29.5t30 71.5v275z" />
+<glyph unicode="&#xf1a5;" d="M1472 160v480h-704v704h-480q-93 0 -158.5 -65.5t-65.5 -158.5v-480h704v-704h480q93 0 158.5 65.5t65.5 158.5zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5 t84.5 -203.5z" />
+<glyph unicode="&#xf1a6;" horiz-adv-x="2048" d="M328 1254h204v-983h-532v697h328v286zM328 435v369h-123v-369h123zM614 968v-697h205v697h-205zM614 1254v-204h205v204h-205zM901 968h533v-942h-533v163h328v82h-328v697zM1229 435v369h-123v-369h123zM1516 968h532v-942h-532v163h327v82h-327v697zM1843 435v369h-123 v-369h123z" />
+<glyph unicode="&#xf1a7;" d="M1046 516q0 -64 -38 -109t-91 -45q-43 0 -70 15v277q28 17 70 17q53 0 91 -45.5t38 -109.5zM703 944q0 -64 -38 -109.5t-91 -45.5q-43 0 -70 15v277q28 17 70 17q53 0 91 -45t38 -109zM1265 513q0 134 -88 229t-213 95q-20 0 -39 -3q-23 -78 -78 -136q-87 -95 -211 -101 v-636l211 41v206q51 -19 117 -19q125 0 213 95t88 229zM922 940q0 134 -88.5 229t-213.5 95q-74 0 -141 -36h-186v-840l211 41v206q55 -19 116 -19q125 0 213.5 95t88.5 229zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960 q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf1a8;" horiz-adv-x="2038" d="M1222 607q75 3 143.5 -20.5t118 -58.5t101 -94.5t84 -108t75.5 -120.5q33 -56 78.5 -109t75.5 -80.5t99 -88.5q-48 -30 -108.5 -57.5t-138.5 -59t-114 -47.5q-44 37 -74 115t-43.5 164.5t-33 180.5t-42.5 168.5t-72.5 123t-122.5 48.5l-10 -2l-6 -4q4 -5 13 -14 q6 -5 28 -23.5t25.5 -22t19 -18t18 -20.5t11.5 -21t10.5 -27.5t4.5 -31t4 -40.5l1 -33q1 -26 -2.5 -57.5t-7.5 -52t-12.5 -58.5t-11.5 -53q-35 1 -101 -9.5t-98 -10.5q-39 0 -72 10q-2 16 -2 47q0 74 3 96q2 13 31.5 41.5t57 59t26.5 51.5q-24 2 -43 -24 q-36 -53 -111.5 -99.5t-136.5 -46.5q-25 0 -75.5 63t-106.5 139.5t-84 96.5q-6 4 -27 30q-482 -112 -513 -112q-16 0 -28 11t-12 27q0 15 8.5 26.5t22.5 14.5l486 106q-8 14 -8 25t5.5 17.5t16 11.5t20 7t23 4.5t18.5 4.5q4 1 15.5 7.5t17.5 6.5q15 0 28 -16t20 -33 q163 37 172 37q17 0 29.5 -11t12.5 -28q0 -15 -8.5 -26t-23.5 -14l-182 -40l-1 -16q-1 -26 81.5 -117.5t104.5 -91.5q47 0 119 80t72 129q0 36 -23.5 53t-51 18.5t-51 11.5t-23.5 34q0 16 10 34l-68 19q43 44 43 117q0 26 -5 58q82 16 144 16q44 0 71.5 -1.5t48.5 -8.5 t31 -13.5t20.5 -24.5t15.5 -33.5t17 -47.5t24 -60l50 25q-3 -40 -23 -60t-42.5 -21t-40 -6.5t-16.5 -20.5zM1282 842q-5 5 -13.5 15.5t-12 14.5t-10.5 11.5t-10 10.5l-8 8t-8.5 7.5t-8 5t-8.5 4.5q-7 3 -14.5 5t-20.5 2.5t-22 0.5h-32.5h-37.5q-126 0 -217 -43 q16 30 36 46.5t54 29.5t65.5 36t46 36.5t50 55t43.5 50.5q12 -9 28 -31.5t32 -36.5t38 -13l12 1v-76l22 -1q247 95 371 190q28 21 50 39t42.5 37.5t33 31t29.5 34t24 31t24.5 37t23 38t27 47.5t29.5 53l7 9q-2 -53 -43 -139q-79 -165 -205 -264t-306 -142q-14 -3 -42 -7.5 t-50 -9.5t-39 -14q3 -19 24.5 -46t21.5 -34q0 -11 -26 -30zM1061 -79q39 26 131.5 47.5t146.5 21.5q9 0 22.5 -15.5t28 -42.5t26 -50t24 -51t14.5 -33q-121 -45 -244 -45q-61 0 -125 11zM822 568l48 12l109 -177l-73 -48zM1323 51q3 -15 3 -16q0 -7 -17.5 -14.5t-46 -13 t-54 -9.5t-53.5 -7.5t-32 -4.5l-7 43q21 2 60.5 8.5t72 10t60.5 3.5h14zM866 679l-96 -20l-6 17q10 1 32.5 7t34.5 6q19 0 35 -10zM1061 45h31l10 -83l-41 -12v95zM1950 1535v1v-1zM1950 1535l-1 -5l-2 -2l1 3zM1950 1535l1 1z" />
+<glyph unicode="&#xf1a9;" d="M1167 -50q-5 19 -24 5q-30 -22 -87 -39t-131 -17q-129 0 -193 49q-5 4 -13 4q-11 0 -26 -12q-7 -6 -7.5 -16t7.5 -20q34 -32 87.5 -46t102.5 -12.5t99 4.5q41 4 84.5 20.5t65 30t28.5 20.5q12 12 7 29zM1128 65q-19 47 -39 61q-23 15 -76 15q-47 0 -71 -10 q-29 -12 -78 -56q-26 -24 -12 -44q9 -8 17.5 -4.5t31.5 23.5q3 2 10.5 8.5t10.5 8.5t10 7t11.5 7t12.5 5t15 4.5t16.5 2.5t20.5 1q27 0 44.5 -7.5t23 -14.5t13.5 -22q10 -17 12.5 -20t12.5 1q23 12 14 34zM1483 346q0 22 -5 44.5t-16.5 45t-34 36.5t-52.5 14 q-33 0 -97 -41.5t-129 -83.5t-101 -42q-27 -1 -63.5 19t-76 49t-83.5 58t-100 49t-111 19q-115 -1 -197 -78.5t-84 -178.5q-2 -112 74 -164q29 -20 62.5 -28.5t103.5 -8.5q57 0 132 32.5t134 71t120 70.5t93 31q26 -1 65 -31.5t71.5 -67t68 -67.5t55.5 -32q35 -3 58.5 14 t55.5 63q28 41 42.5 101t14.5 106zM1536 506q0 -164 -62 -304.5t-166 -236t-242.5 -149.5t-290.5 -54t-293 57.5t-247.5 157t-170.5 241.5t-64 302q0 89 19.5 172.5t49 145.5t70.5 118.5t78.5 94t78.5 69.5t64.5 46.5t42.5 24.5q14 8 51 26.5t54.5 28.5t48 30t60.5 44 q36 28 58 72.5t30 125.5q129 -155 186 -193q44 -29 130 -68t129 -66q21 -13 39 -25t60.5 -46.5t76 -70.5t75 -95t69 -122t47 -148.5t19.5 -177.5z" />
+<glyph unicode="&#xf1aa;" d="M1070 463l-160 -160l-151 -152l-30 -30q-65 -64 -151.5 -87t-171.5 -2q-16 -70 -72 -115t-129 -45q-85 0 -145 60.5t-60 145.5q0 72 44.5 128t113.5 72q-22 86 1 173t88 152l12 12l151 -152l-11 -11q-37 -37 -37 -89t37 -90q37 -37 89 -37t89 37l30 30l151 152l161 160z M729 1145l12 -12l-152 -152l-12 12q-37 37 -89 37t-89 -37t-37 -89.5t37 -89.5l29 -29l152 -152l160 -160l-151 -152l-161 160l-151 152l-30 30q-68 67 -90 159.5t5 179.5q-70 15 -115 71t-45 129q0 85 60 145.5t145 60.5q76 0 133.5 -49t69.5 -123q84 20 169.5 -3.5 t149.5 -87.5zM1536 78q0 -85 -60 -145.5t-145 -60.5q-74 0 -131 47t-71 118q-86 -28 -179.5 -6t-161.5 90l-11 12l151 152l12 -12q37 -37 89 -37t89 37t37 89t-37 89l-30 30l-152 152l-160 160l152 152l160 -160l152 -152l29 -30q64 -64 87.5 -150.5t2.5 -171.5 q76 -11 126.5 -68.5t50.5 -134.5zM1534 1202q0 -77 -51 -135t-127 -69q26 -85 3 -176.5t-90 -158.5l-12 -12l-151 152l12 12q37 37 37 89t-37 89t-89 37t-89 -37l-30 -30l-152 -152l-160 -160l-152 152l161 160l152 152l29 30q67 67 159 89.5t178 -3.5q11 75 68.5 126 t135.5 51q85 0 145 -60.5t60 -145.5z" />
+<glyph unicode="&#xf1ab;" d="M654 458q-1 -3 -12.5 0.5t-31.5 11.5l-20 9q-44 20 -87 49q-7 5 -41 31.5t-38 28.5q-67 -103 -134 -181q-81 -95 -105 -110q-4 -2 -19.5 -4t-18.5 0q6 4 82 92q21 24 85.5 115t78.5 118q17 30 51 98.5t36 77.5q-8 1 -110 -33q-8 -2 -27.5 -7.5t-34.5 -9.5t-17 -5 q-2 -2 -2 -10.5t-1 -9.5q-5 -10 -31 -15q-23 -7 -47 0q-18 4 -28 21q-4 6 -5 23q6 2 24.5 5t29.5 6q58 16 105 32q100 35 102 35q10 2 43 19.5t44 21.5q9 3 21.5 8t14.5 5.5t6 -0.5q2 -12 -1 -33q0 -2 -12.5 -27t-26.5 -53.5t-17 -33.5q-25 -50 -77 -131l64 -28 q12 -6 74.5 -32t67.5 -28q4 -1 10.5 -25.5t4.5 -30.5zM449 944q3 -15 -4 -28q-12 -23 -50 -38q-30 -12 -60 -12q-26 3 -49 26q-14 15 -18 41l1 3q3 -3 19.5 -5t26.5 0t58 16q36 12 55 14q17 0 21 -17zM1147 815l63 -227l-139 42zM39 15l694 232v1032l-694 -233v-1031z M1280 332l102 -31l-181 657l-100 31l-216 -536l102 -31l45 110l211 -65zM777 1294l573 -184v380zM1088 -29l158 -13l-54 -160l-40 66q-130 -83 -276 -108q-58 -12 -91 -12h-84q-79 0 -199.5 39t-183.5 85q-8 7 -8 16q0 8 5 13.5t13 5.5q4 0 18 -7.5t30.5 -16.5t20.5 -11 q73 -37 159.5 -61.5t157.5 -24.5q95 0 167 14.5t157 50.5q15 7 30.5 15.5t34 19t28.5 16.5zM1536 1050v-1079l-774 246q-14 -6 -375 -127.5t-368 -121.5q-13 0 -18 13q0 1 -1 3v1078q3 9 4 10q5 6 20 11q106 35 149 50v384l558 -198q2 0 160.5 55t316 108.5t161.5 53.5 q20 0 20 -21v-418z" />
+<glyph unicode="&#xf1ac;" horiz-adv-x="1792" d="M288 1152q66 0 113 -47t47 -113v-1088q0 -66 -47 -113t-113 -47h-128q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h128zM1664 989q58 -34 93 -93t35 -128v-768q0 -106 -75 -181t-181 -75h-864q-66 0 -113 47t-47 113v1536q0 40 28 68t68 28h672q40 0 88 -20t76 -48 l152 -152q28 -28 48 -76t20 -88v-163zM928 0v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM928 256v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM928 512v128q0 14 -9 23 t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1184 0v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1184 256v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128 q14 0 23 9t9 23zM1184 512v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1440 0v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1440 256v128q0 14 -9 23t-23 9h-128 q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1440 512v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1536 896v256h-160q-40 0 -68 28t-28 68v160h-640v-512h896z" />
+<glyph unicode="&#xf1ad;" d="M1344 1536q26 0 45 -19t19 -45v-1664q0 -26 -19 -45t-45 -19h-1280q-26 0 -45 19t-19 45v1664q0 26 19 45t45 19h1280zM512 1248v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM512 992v-64q0 -14 9 -23t23 -9h64q14 0 23 9 t9 23v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM512 736v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM512 480v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM384 160v64 q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM384 416v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM384 672v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64 q14 0 23 9t9 23zM384 928v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM384 1184v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM896 -96v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9 t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM896 416v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM896 672v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM896 928v64 q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM896 1184v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1152 160v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64 q14 0 23 9t9 23zM1152 416v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1152 672v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1152 928v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9 t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1152 1184v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23z" />
+<glyph unicode="&#xf1ae;" horiz-adv-x="1280" d="M1188 988l-292 -292v-824q0 -46 -33 -79t-79 -33t-79 33t-33 79v384h-64v-384q0 -46 -33 -79t-79 -33t-79 33t-33 79v824l-292 292q-28 28 -28 68t28 68t68 28t68 -28l228 -228h368l228 228q28 28 68 28t68 -28t28 -68t-28 -68zM864 1152q0 -93 -65.5 -158.5 t-158.5 -65.5t-158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5t158.5 -65.5t65.5 -158.5z" />
+<glyph unicode="&#xf1b0;" horiz-adv-x="1664" d="M780 1064q0 -60 -19 -113.5t-63 -92.5t-105 -39q-76 0 -138 57.5t-92 135.5t-30 151q0 60 19 113.5t63 92.5t105 39q77 0 138.5 -57.5t91.5 -135t30 -151.5zM438 581q0 -80 -42 -139t-119 -59q-76 0 -141.5 55.5t-100.5 133.5t-35 152q0 80 42 139.5t119 59.5 q76 0 141.5 -55.5t100.5 -134t35 -152.5zM832 608q118 0 255 -97.5t229 -237t92 -254.5q0 -46 -17 -76.5t-48.5 -45t-64.5 -20t-76 -5.5q-68 0 -187.5 45t-182.5 45q-66 0 -192.5 -44.5t-200.5 -44.5q-183 0 -183 146q0 86 56 191.5t139.5 192.5t187.5 146t193 59zM1071 819 q-61 0 -105 39t-63 92.5t-19 113.5q0 74 30 151.5t91.5 135t138.5 57.5q61 0 105 -39t63 -92.5t19 -113.5q0 -73 -30 -151t-92 -135.5t-138 -57.5zM1503 923q77 0 119 -59.5t42 -139.5q0 -74 -35 -152t-100.5 -133.5t-141.5 -55.5q-77 0 -119 59t-42 139q0 74 35 152.5 t100.5 134t141.5 55.5z" />
+<glyph unicode="&#xf1b1;" horiz-adv-x="768" d="M704 1008q0 -145 -57 -243.5t-152 -135.5l45 -821q2 -26 -16 -45t-44 -19h-192q-26 0 -44 19t-16 45l45 821q-95 37 -152 135.5t-57 243.5q0 128 42.5 249.5t117.5 200t160 78.5t160 -78.5t117.5 -200t42.5 -249.5z" />
+<glyph unicode="&#xf1b2;" horiz-adv-x="1792" d="M896 -93l640 349v636l-640 -233v-752zM832 772l698 254l-698 254l-698 -254zM1664 1024v-768q0 -35 -18 -65t-49 -47l-704 -384q-28 -16 -61 -16t-61 16l-704 384q-31 17 -49 47t-18 65v768q0 40 23 73t61 47l704 256q22 8 44 8t44 -8l704 -256q38 -14 61 -47t23 -73z " />
+<glyph unicode="&#xf1b3;" horiz-adv-x="2304" d="M640 -96l384 192v314l-384 -164v-342zM576 358l404 173l-404 173l-404 -173zM1664 -96l384 192v314l-384 -164v-342zM1600 358l404 173l-404 173l-404 -173zM1152 651l384 165v266l-384 -164v-267zM1088 1030l441 189l-441 189l-441 -189zM2176 512v-416q0 -36 -19 -67 t-52 -47l-448 -224q-25 -14 -57 -14t-57 14l-448 224q-5 2 -7 4q-2 -2 -7 -4l-448 -224q-25 -14 -57 -14t-57 14l-448 224q-33 16 -52 47t-19 67v416q0 38 21.5 70t56.5 48l434 186v400q0 38 21.5 70t56.5 48l448 192q23 10 50 10t50 -10l448 -192q35 -16 56.5 -48t21.5 -70 v-400l434 -186q36 -16 57 -48t21 -70z" />
+<glyph unicode="&#xf1b4;" horiz-adv-x="2048" d="M1848 1197h-511v-124h511v124zM1596 771q-90 0 -146 -52.5t-62 -142.5h408q-18 195 -200 195zM1612 186q63 0 122 32t76 87h221q-100 -307 -427 -307q-214 0 -340.5 132t-126.5 347q0 208 130.5 345.5t336.5 137.5q138 0 240.5 -68t153 -179t50.5 -248q0 -17 -2 -47h-658 q0 -111 57.5 -171.5t166.5 -60.5zM277 236h296q205 0 205 167q0 180 -199 180h-302v-347zM277 773h281q78 0 123.5 36.5t45.5 113.5q0 144 -190 144h-260v-294zM0 1282h594q87 0 155 -14t126.5 -47.5t90 -96.5t31.5 -154q0 -181 -172 -263q114 -32 172 -115t58 -204 q0 -75 -24.5 -136.5t-66 -103.5t-98.5 -71t-121 -42t-134 -13h-611v1260z" />
+<glyph unicode="&#xf1b5;" d="M1248 1408q119 0 203.5 -84.5t84.5 -203.5v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960zM499 1041h-371v-787h382q117 0 197 57.5t80 170.5q0 158 -143 200q107 52 107 164q0 57 -19.5 96.5 t-56.5 60.5t-79 29.5t-97 8.5zM477 723h-176v184h163q119 0 119 -90q0 -94 -106 -94zM486 388h-185v217h189q124 0 124 -113q0 -104 -128 -104zM1136 356q-68 0 -104 38t-36 107h411q1 10 1 30q0 132 -74.5 220.5t-203.5 88.5q-128 0 -210 -86t-82 -216q0 -135 79 -217 t213 -82q205 0 267 191h-138q-11 -34 -47.5 -54t-75.5 -20zM1126 722q113 0 124 -122h-254q4 56 39 89t91 33zM964 988h319v-77h-319v77z" />
+<glyph unicode="&#xf1b6;" horiz-adv-x="1792" d="M1582 954q0 -101 -71.5 -172.5t-172.5 -71.5t-172.5 71.5t-71.5 172.5t71.5 172.5t172.5 71.5t172.5 -71.5t71.5 -172.5zM812 212q0 104 -73 177t-177 73q-27 0 -54 -6l104 -42q77 -31 109.5 -106.5t1.5 -151.5q-31 -77 -107 -109t-152 -1q-21 8 -62 24.5t-61 24.5 q32 -60 91 -96.5t130 -36.5q104 0 177 73t73 177zM1642 953q0 126 -89.5 215.5t-215.5 89.5q-127 0 -216.5 -89.5t-89.5 -215.5q0 -127 89.5 -216t216.5 -89q126 0 215.5 89t89.5 216zM1792 953q0 -189 -133.5 -322t-321.5 -133l-437 -319q-12 -129 -109 -218t-229 -89 q-121 0 -214 76t-118 192l-230 92v429l389 -157q79 48 173 48q13 0 35 -2l284 407q2 187 135.5 319t320.5 132q188 0 321.5 -133.5t133.5 -321.5z" />
+<glyph unicode="&#xf1b7;" d="M1242 889q0 80 -57 136.5t-137 56.5t-136.5 -57t-56.5 -136q0 -80 56.5 -136.5t136.5 -56.5t137 56.5t57 136.5zM632 301q0 -83 -58 -140.5t-140 -57.5q-56 0 -103 29t-72 77q52 -20 98 -40q60 -24 120 1.5t85 86.5q24 60 -1.5 120t-86.5 84l-82 33q22 5 42 5 q82 0 140 -57.5t58 -140.5zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v153l172 -69q20 -92 93.5 -152t168.5 -60q104 0 181 70t87 173l345 252q150 0 255.5 105.5t105.5 254.5q0 150 -105.5 255.5t-255.5 105.5 q-148 0 -253 -104.5t-107 -252.5l-225 -322q-9 1 -28 1q-75 0 -137 -37l-297 119v468q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5zM1289 887q0 -100 -71 -170.5t-171 -70.5t-170.5 70.5t-70.5 170.5t70.5 171t170.5 71q101 0 171.5 -70.5t70.5 -171.5z " />
+<glyph unicode="&#xf1b8;" horiz-adv-x="1792" d="M836 367l-15 -368l-2 -22l-420 29q-36 3 -67 31.5t-47 65.5q-11 27 -14.5 55t4 65t12 55t21.5 64t19 53q78 -12 509 -28zM449 953l180 -379l-147 92q-63 -72 -111.5 -144.5t-72.5 -125t-39.5 -94.5t-18.5 -63l-4 -21l-190 357q-17 26 -18 56t6 47l8 18q35 63 114 188 l-140 86zM1680 436l-188 -359q-12 -29 -36.5 -46.5t-43.5 -20.5l-18 -4q-71 -7 -219 -12l8 -164l-230 367l211 362l7 -173q170 -16 283 -5t170 33zM895 1360q-47 -63 -265 -435l-317 187l-19 12l225 356q20 31 60 45t80 10q24 -2 48.5 -12t42 -21t41.5 -33t36 -34.5 t36 -39.5t32 -35zM1550 1053l212 -363q18 -37 12.5 -76t-27.5 -74q-13 -20 -33 -37t-38 -28t-48.5 -22t-47 -16t-51.5 -14t-46 -12q-34 72 -265 436l313 195zM1407 1279l142 83l-220 -373l-419 20l151 86q-34 89 -75 166t-75.5 123.5t-64.5 80t-47 46.5l-17 13l405 -1 q31 3 58 -10.5t39 -28.5l11 -15q39 -61 112 -190z" />
+<glyph unicode="&#xf1b9;" horiz-adv-x="2048" d="M480 448q0 66 -47 113t-113 47t-113 -47t-47 -113t47 -113t113 -47t113 47t47 113zM516 768h1016l-89 357q-2 8 -14 17.5t-21 9.5h-768q-9 0 -21 -9.5t-14 -17.5zM1888 448q0 66 -47 113t-113 47t-113 -47t-47 -113t47 -113t113 -47t113 47t47 113zM2048 544v-384 q0 -14 -9 -23t-23 -9h-96v-128q0 -80 -56 -136t-136 -56t-136 56t-56 136v128h-1024v-128q0 -80 -56 -136t-136 -56t-136 56t-56 136v128h-96q-14 0 -23 9t-9 23v384q0 93 65.5 158.5t158.5 65.5h28l105 419q23 94 104 157.5t179 63.5h768q98 0 179 -63.5t104 -157.5 l105 -419h28q93 0 158.5 -65.5t65.5 -158.5z" />
+<glyph unicode="&#xf1ba;" horiz-adv-x="2048" d="M1824 640q93 0 158.5 -65.5t65.5 -158.5v-384q0 -14 -9 -23t-23 -9h-96v-64q0 -80 -56 -136t-136 -56t-136 56t-56 136v64h-1024v-64q0 -80 -56 -136t-136 -56t-136 56t-56 136v64h-96q-14 0 -23 9t-9 23v384q0 93 65.5 158.5t158.5 65.5h28l105 419q23 94 104 157.5 t179 63.5h128v224q0 14 9 23t23 9h448q14 0 23 -9t9 -23v-224h128q98 0 179 -63.5t104 -157.5l105 -419h28zM320 160q66 0 113 47t47 113t-47 113t-113 47t-113 -47t-47 -113t47 -113t113 -47zM516 640h1016l-89 357q-2 8 -14 17.5t-21 9.5h-768q-9 0 -21 -9.5t-14 -17.5z M1728 160q66 0 113 47t47 113t-47 113t-113 47t-113 -47t-47 -113t47 -113t113 -47z" />
+<glyph unicode="&#xf1bb;" d="M1504 64q0 -26 -19 -45t-45 -19h-462q1 -17 6 -87.5t5 -108.5q0 -25 -18 -42.5t-43 -17.5h-320q-25 0 -43 17.5t-18 42.5q0 38 5 108.5t6 87.5h-462q-26 0 -45 19t-19 45t19 45l402 403h-229q-26 0 -45 19t-19 45t19 45l402 403h-197q-26 0 -45 19t-19 45t19 45l384 384 q19 19 45 19t45 -19l384 -384q19 -19 19 -45t-19 -45t-45 -19h-197l402 -403q19 -19 19 -45t-19 -45t-45 -19h-229l402 -403q19 -19 19 -45z" />
+<glyph unicode="&#xf1bc;" d="M1127 326q0 32 -30 51q-193 115 -447 115q-133 0 -287 -34q-42 -9 -42 -52q0 -20 13.5 -34.5t35.5 -14.5q5 0 37 8q132 27 243 27q226 0 397 -103q19 -11 33 -11q19 0 33 13.5t14 34.5zM1223 541q0 40 -35 61q-237 141 -548 141q-153 0 -303 -42q-48 -13 -48 -64 q0 -25 17.5 -42.5t42.5 -17.5q7 0 37 8q122 33 251 33q279 0 488 -124q24 -13 38 -13q25 0 42.5 17.5t17.5 42.5zM1331 789q0 47 -40 70q-126 73 -293 110.5t-343 37.5q-204 0 -364 -47q-23 -7 -38.5 -25.5t-15.5 -48.5q0 -31 20.5 -52t51.5 -21q11 0 40 8q133 37 307 37 q159 0 309.5 -34t253.5 -95q21 -12 40 -12q29 0 50.5 20.5t21.5 51.5zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf1bd;" horiz-adv-x="1024" d="M1024 1233l-303 -582l24 -31h279v-415h-507l-44 -30l-142 -273l-30 -30h-301v303l303 583l-24 30h-279v415h507l44 30l142 273l30 30h301v-303z" />
+<glyph unicode="&#xf1be;" horiz-adv-x="2304" d="M784 164l16 241l-16 523q-1 10 -7.5 17t-16.5 7q-9 0 -16 -7t-7 -17l-14 -523l14 -241q1 -10 7.5 -16.5t15.5 -6.5q22 0 24 23zM1080 193l11 211l-12 586q0 16 -13 24q-8 5 -16 5t-16 -5q-13 -8 -13 -24l-1 -6l-10 -579q0 -1 11 -236v-1q0 -10 6 -17q9 -11 23 -11 q11 0 20 9q9 7 9 20zM35 533l20 -128l-20 -126q-2 -9 -9 -9t-9 9l-17 126l17 128q2 9 9 9t9 -9zM121 612l26 -207l-26 -203q-2 -9 -10 -9q-9 0 -9 10l-23 202l23 207q0 9 9 9q8 0 10 -9zM401 159zM213 650l25 -245l-25 -237q0 -11 -11 -11q-10 0 -12 11l-21 237l21 245 q2 12 12 12q11 0 11 -12zM307 657l23 -252l-23 -244q-2 -13 -14 -13q-13 0 -13 13l-21 244l21 252q0 13 13 13q12 0 14 -13zM401 639l21 -234l-21 -246q-2 -16 -16 -16q-6 0 -10.5 4.5t-4.5 11.5l-20 246l20 234q0 6 4.5 10.5t10.5 4.5q14 0 16 -15zM784 164zM495 785 l21 -380l-21 -246q0 -7 -5 -12.5t-12 -5.5q-16 0 -18 18l-18 246l18 380q2 18 18 18q7 0 12 -5.5t5 -12.5zM589 871l19 -468l-19 -244q0 -8 -5.5 -13.5t-13.5 -5.5q-18 0 -20 19l-16 244l16 468q2 19 20 19q8 0 13.5 -5.5t5.5 -13.5zM687 911l18 -506l-18 -242 q-2 -21 -22 -21q-19 0 -21 21l-16 242l16 506q0 9 6.5 15.5t14.5 6.5q9 0 15 -6.5t7 -15.5zM1079 169v0v0zM881 915l15 -510l-15 -239q0 -10 -7.5 -17.5t-17.5 -7.5t-17 7t-8 18l-14 239l14 510q0 11 7.5 18t17.5 7t17.5 -7t7.5 -18zM980 896l14 -492l-14 -236q0 -11 -8 -19 t-19 -8t-19 8t-9 19l-12 236l12 492q1 12 9 20t19 8t18.5 -8t8.5 -20zM1192 404l-14 -231v0q0 -13 -9 -22t-22 -9t-22 9t-10 22l-6 114l-6 117l12 636v3q2 15 12 24q9 7 20 7q8 0 15 -5q14 -8 16 -26zM2304 423q0 -117 -83 -199.5t-200 -82.5h-786q-13 2 -22 11t-9 22v899 q0 23 28 33q85 34 181 34q195 0 338 -131.5t160 -323.5q53 22 110 22q117 0 200 -83t83 -201z" />
+<glyph unicode="&#xf1c0;" d="M768 768q237 0 443 43t325 127v-170q0 -69 -103 -128t-280 -93.5t-385 -34.5t-385 34.5t-280 93.5t-103 128v170q119 -84 325 -127t443 -43zM768 0q237 0 443 43t325 127v-170q0 -69 -103 -128t-280 -93.5t-385 -34.5t-385 34.5t-280 93.5t-103 128v170q119 -84 325 -127 t443 -43zM768 384q237 0 443 43t325 127v-170q0 -69 -103 -128t-280 -93.5t-385 -34.5t-385 34.5t-280 93.5t-103 128v170q119 -84 325 -127t443 -43zM768 1536q208 0 385 -34.5t280 -93.5t103 -128v-128q0 -69 -103 -128t-280 -93.5t-385 -34.5t-385 34.5t-280 93.5 t-103 128v128q0 69 103 128t280 93.5t385 34.5z" />
+<glyph unicode="&#xf1c1;" d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z M894 465q33 -26 84 -56q59 7 117 7q147 0 177 -49q16 -22 2 -52q0 -1 -1 -2l-2 -2v-1q-6 -38 -71 -38q-48 0 -115 20t-130 53q-221 -24 -392 -83q-153 -262 -242 -262q-15 0 -28 7l-24 12q-1 1 -6 5q-10 10 -6 36q9 40 56 91.5t132 96.5q14 9 23 -6q2 -2 2 -4q52 85 107 197 q68 136 104 262q-24 82 -30.5 159.5t6.5 127.5q11 40 42 40h21h1q23 0 35 -15q18 -21 9 -68q-2 -6 -4 -8q1 -3 1 -8v-30q-2 -123 -14 -192q55 -164 146 -238zM318 54q52 24 137 158q-51 -40 -87.5 -84t-49.5 -74zM716 974q-15 -42 -2 -132q1 7 7 44q0 3 7 43q1 4 4 8 q-1 1 -1 2t-0.5 1.5t-0.5 1.5q-1 22 -13 36q0 -1 -1 -2v-2zM592 313q135 54 284 81q-2 1 -13 9.5t-16 13.5q-76 67 -127 176q-27 -86 -83 -197q-30 -56 -45 -83zM1238 329q-24 24 -140 24q76 -28 124 -28q14 0 18 1q0 1 -2 3z" />
+<glyph unicode="&#xf1c2;" d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z M233 768v-107h70l164 -661h159l128 485q7 20 10 46q2 16 2 24h4l3 -24q1 -3 3.5 -20t5.5 -26l128 -485h159l164 661h70v107h-300v-107h90l-99 -438q-5 -20 -7 -46l-2 -21h-4l-3 21q-1 5 -4 21t-5 25l-144 545h-114l-144 -545q-2 -9 -4.5 -24.5t-3.5 -21.5l-4 -21h-4l-2 21 q-2 26 -7 46l-99 438h90v107h-300z" />
+<glyph unicode="&#xf1c3;" d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z M429 106v-106h281v106h-75l103 161q5 7 10 16.5t7.5 13.5t3.5 4h2q1 -4 5 -10q2 -4 4.5 -7.5t6 -8t6.5 -8.5l107 -161h-76v-106h291v106h-68l-192 273l195 282h67v107h-279v-107h74l-103 -159q-4 -7 -10 -16.5t-9 -13.5l-2 -3h-2q-1 4 -5 10q-6 11 -17 23l-106 159h76v107 h-290v-107h68l189 -272l-194 -283h-68z" />
+<glyph unicode="&#xf1c4;" d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z M416 106v-106h327v106h-93v167h137q76 0 118 15q67 23 106.5 87t39.5 146q0 81 -37 141t-100 87q-48 19 -130 19h-368v-107h92v-555h-92zM769 386h-119v268h120q52 0 83 -18q56 -33 56 -115q0 -89 -62 -120q-31 -15 -78 -15z" />
+<glyph unicode="&#xf1c5;" d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z M1280 320v-320h-1024v192l192 192l128 -128l384 384zM448 512q-80 0 -136 56t-56 136t56 136t136 56t136 -56t56 -136t-56 -136t-136 -56z" />
+<glyph unicode="&#xf1c6;" d="M640 1152v128h-128v-128h128zM768 1024v128h-128v-128h128zM640 896v128h-128v-128h128zM768 768v128h-128v-128h128zM1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400 v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-128v-128h-128v128h-512v-1536h1280zM781 593l107 -349q8 -27 8 -52q0 -83 -72.5 -137.5t-183.5 -54.5t-183.5 54.5t-72.5 137.5q0 25 8 52q21 63 120 396v128h128v-128h79 q22 0 39 -13t23 -34zM640 128q53 0 90.5 19t37.5 45t-37.5 45t-90.5 19t-90.5 -19t-37.5 -45t37.5 -45t90.5 -19z" />
+<glyph unicode="&#xf1c7;" d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z M620 686q20 -8 20 -30v-544q0 -22 -20 -30q-8 -2 -12 -2q-12 0 -23 9l-166 167h-131q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h131l166 167q16 15 35 7zM1037 -3q31 0 50 24q129 159 129 363t-129 363q-16 21 -43 24t-47 -14q-21 -17 -23.5 -43.5t14.5 -47.5 q100 -123 100 -282t-100 -282q-17 -21 -14.5 -47.5t23.5 -42.5q18 -15 40 -15zM826 145q27 0 47 20q87 93 87 219t-87 219q-18 19 -45 20t-46 -17t-20 -44.5t18 -46.5q52 -57 52 -131t-52 -131q-19 -20 -18 -46.5t20 -44.5q20 -17 44 -17z" />
+<glyph unicode="&#xf1c8;" d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z M768 768q52 0 90 -38t38 -90v-384q0 -52 -38 -90t-90 -38h-384q-52 0 -90 38t-38 90v384q0 52 38 90t90 38h384zM1260 766q20 -8 20 -30v-576q0 -22 -20 -30q-8 -2 -12 -2q-14 0 -23 9l-265 266v90l265 266q9 9 23 9q4 0 12 -2z" />
+<glyph unicode="&#xf1c9;" d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z M480 768q8 11 21 12.5t24 -6.5l51 -38q11 -8 12.5 -21t-6.5 -24l-182 -243l182 -243q8 -11 6.5 -24t-12.5 -21l-51 -38q-11 -8 -24 -6.5t-21 12.5l-226 301q-14 19 0 38zM1282 467q14 -19 0 -38l-226 -301q-8 -11 -21 -12.5t-24 6.5l-51 38q-11 8 -12.5 21t6.5 24l182 243 l-182 243q-8 11 -6.5 24t12.5 21l51 38q11 8 24 6.5t21 -12.5zM662 6q-13 2 -20.5 13t-5.5 24l138 831q2 13 13 20.5t24 5.5l63 -10q13 -2 20.5 -13t5.5 -24l-138 -831q-2 -13 -13 -20.5t-24 -5.5z" />
+<glyph unicode="&#xf1ca;" d="M1497 709v-198q-101 -23 -198 -23q-65 -136 -165.5 -271t-181.5 -215.5t-128 -106.5q-80 -45 -162 3q-28 17 -60.5 43.5t-85 83.5t-102.5 128.5t-107.5 184t-105.5 244t-91.5 314.5t-70.5 390h283q26 -218 70 -398.5t104.5 -317t121.5 -235.5t140 -195q169 169 287 406 q-142 72 -223 220t-81 333q0 192 104 314.5t284 122.5q178 0 273 -105.5t95 -297.5q0 -159 -58 -286q-7 -1 -19.5 -3t-46 -2t-63 6t-62 25.5t-50.5 51.5q31 103 31 184q0 87 -29 132t-79 45q-53 0 -85 -49.5t-32 -140.5q0 -186 105 -293.5t267 -107.5q62 0 121 14z" />
+<glyph unicode="&#xf1cb;" horiz-adv-x="1792" d="M216 367l603 -402v359l-334 223zM154 511l193 129l-193 129v-258zM973 -35l603 402l-269 180l-334 -223v-359zM896 458l272 182l-272 182l-272 -182zM485 733l334 223v359l-603 -402zM1445 640l193 -129v258zM1307 733l269 180l-603 402v-359zM1792 913v-546 q0 -41 -34 -64l-819 -546q-21 -13 -43 -13t-43 13l-819 546q-34 23 -34 64v546q0 41 34 64l819 546q21 13 43 13t43 -13l819 -546q34 -23 34 -64z" />
+<glyph unicode="&#xf1cc;" horiz-adv-x="2048" d="M1800 764q111 -46 179.5 -145.5t68.5 -221.5q0 -164 -118 -280.5t-285 -116.5q-4 0 -11.5 0.5t-10.5 0.5h-1209h-1h-2h-5q-170 10 -288 125.5t-118 280.5q0 110 55 203t147 147q-12 39 -12 82q0 115 82 196t199 81q95 0 172 -58q75 154 222.5 248t326.5 94 q166 0 306 -80.5t221.5 -218.5t81.5 -301q0 -6 -0.5 -18t-0.5 -18zM468 498q0 -122 84 -193t208 -71q137 0 240 99q-16 20 -47.5 56.5t-43.5 50.5q-67 -65 -144 -65q-55 0 -93.5 33.5t-38.5 87.5q0 53 38.5 87t91.5 34q44 0 84.5 -21t73 -55t65 -75t69 -82t77 -75t97 -55 t121.5 -21q121 0 204.5 71.5t83.5 190.5q0 121 -84 192t-207 71q-143 0 -241 -97q14 -16 29.5 -34t34.5 -40t29 -34q66 64 142 64q52 0 92 -33t40 -84q0 -57 -37 -91.5t-94 -34.5q-43 0 -82.5 21t-72 55t-65.5 75t-69.5 82t-77.5 75t-96.5 55t-118.5 21q-122 0 -207 -70.5 t-85 -189.5z" />
+<glyph unicode="&#xf1cd;" horiz-adv-x="1792" d="M896 1536q182 0 348 -71t286 -191t191 -286t71 -348t-71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71zM896 1408q-190 0 -361 -90l194 -194q82 28 167 28t167 -28l194 194q-171 90 -361 90zM218 279l194 194 q-28 82 -28 167t28 167l-194 194q-90 -171 -90 -361t90 -361zM896 -128q190 0 361 90l-194 194q-82 -28 -167 -28t-167 28l-194 -194q171 -90 361 -90zM896 256q159 0 271.5 112.5t112.5 271.5t-112.5 271.5t-271.5 112.5t-271.5 -112.5t-112.5 -271.5t112.5 -271.5 t271.5 -112.5zM1380 473l194 -194q90 171 90 361t-90 361l-194 -194q28 -82 28 -167t-28 -167z" />
+<glyph unicode="&#xf1ce;" horiz-adv-x="1792" d="M1760 640q0 -176 -68.5 -336t-184 -275.5t-275.5 -184t-336 -68.5t-336 68.5t-275.5 184t-184 275.5t-68.5 336q0 213 97 398.5t265 305.5t374 151v-228q-221 -45 -366.5 -221t-145.5 -406q0 -130 51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5 t136.5 204t51 248.5q0 230 -145.5 406t-366.5 221v228q206 -31 374 -151t265 -305.5t97 -398.5z" />
+<glyph unicode="&#xf1d0;" horiz-adv-x="1792" d="M19 662q8 217 116 406t305 318h5q0 -1 -1 -3q-8 -8 -28 -33.5t-52 -76.5t-60 -110.5t-44.5 -135.5t-14 -150.5t39 -157.5t108.5 -154q50 -50 102 -69.5t90.5 -11.5t69.5 23.5t47 32.5l16 16q39 51 53 116.5t6.5 122.5t-21 107t-26.5 80l-14 29q-10 25 -30.5 49.5t-43 41 t-43.5 29.5t-35 19l-13 6l104 115q39 -17 78 -52t59 -61l19 -27q1 48 -18.5 103.5t-40.5 87.5l-20 31l161 183l160 -181q-33 -46 -52.5 -102.5t-22.5 -90.5l-4 -33q22 37 61.5 72.5t67.5 52.5l28 17l103 -115q-44 -14 -85 -50t-60 -65l-19 -29q-31 -56 -48 -133.5t-7 -170 t57 -156.5q33 -45 77.5 -60.5t85 -5.5t76 26.5t57.5 33.5l21 16q60 53 96.5 115t48.5 121.5t10 121.5t-18 118t-37 107.5t-45.5 93t-45 72t-34.5 47.5l-13 17q-14 13 -7 13l10 -3q40 -29 62.5 -46t62 -50t64 -58t58.5 -65t55.5 -77t45.5 -88t38 -103t23.5 -117t10.5 -136 q3 -259 -108 -465t-312 -321t-456 -115q-185 0 -351 74t-283.5 198t-184 293t-60.5 353z" />
+<glyph unicode="&#xf1d1;" horiz-adv-x="1792" d="M874 -102v-66q-208 6 -385 109.5t-283 275.5l58 34q29 -49 73 -99l65 57q148 -168 368 -212l-17 -86q65 -12 121 -13zM276 428l-83 -28q22 -60 49 -112l-57 -33q-98 180 -98 385t98 385l57 -33q-30 -56 -49 -112l82 -28q-35 -100 -35 -212q0 -109 36 -212zM1528 251 l58 -34q-106 -172 -283 -275.5t-385 -109.5v66q56 1 121 13l-17 86q220 44 368 212l65 -57q44 50 73 99zM1377 805l-233 -80q14 -42 14 -85t-14 -85l232 -80q-31 -92 -98 -169l-185 162q-57 -67 -147 -85l48 -241q-52 -10 -98 -10t-98 10l48 241q-90 18 -147 85l-185 -162 q-67 77 -98 169l232 80q-14 42 -14 85t14 85l-233 80q33 93 99 169l185 -162q59 68 147 86l-48 240q44 10 98 10t98 -10l-48 -240q88 -18 147 -86l185 162q66 -76 99 -169zM874 1448v-66q-65 -2 -121 -13l17 -86q-220 -42 -368 -211l-65 56q-38 -42 -73 -98l-57 33 q106 172 282 275.5t385 109.5zM1705 640q0 -205 -98 -385l-57 33q27 52 49 112l-83 28q36 103 36 212q0 112 -35 212l82 28q-19 56 -49 112l57 33q98 -180 98 -385zM1585 1063l-57 -33q-35 56 -73 98l-65 -56q-148 169 -368 211l17 86q-56 11 -121 13v66q209 -6 385 -109.5 t282 -275.5zM1748 640q0 173 -67.5 331t-181.5 272t-272 181.5t-331 67.5t-331 -67.5t-272 -181.5t-181.5 -272t-67.5 -331t67.5 -331t181.5 -272t272 -181.5t331 -67.5t331 67.5t272 181.5t181.5 272t67.5 331zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71 t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
+<glyph unicode="&#xf1d2;" d="M582 228q0 -66 -93 -66q-107 0 -107 63q0 64 98 64q102 0 102 -61zM546 694q0 -85 -74 -85q-77 0 -77 84q0 90 77 90q36 0 55 -25.5t19 -63.5zM712 769v125q-78 -29 -135 -29q-50 29 -110 29q-86 0 -145 -57t-59 -143q0 -50 29.5 -102t73.5 -67v-3q-38 -17 -38 -85 q0 -53 41 -77v-3q-113 -37 -113 -139q0 -45 20 -78.5t54 -51t72 -25.5t81 -8q224 0 224 188q0 67 -48 99t-126 46q-27 5 -51.5 20.5t-24.5 39.5q0 44 49 52q77 15 122 70t45 134q0 24 -10 52q37 9 49 13zM771 350h137q-2 27 -2 82v387q0 46 2 69h-137q3 -23 3 -71v-392 q0 -50 -3 -75zM1280 366v121q-30 -21 -68 -21q-53 0 -53 82v225h52q9 0 26.5 -1t26.5 -1v117h-105q0 82 3 102h-140q4 -24 4 -55v-47h-60v-117q36 3 37 3q3 0 11 -0.5t12 -0.5v-2h-2v-217q0 -37 2.5 -64t11.5 -56.5t24.5 -48.5t43.5 -31t66 -12q64 0 108 24zM924 1072 q0 36 -24 63.5t-60 27.5t-60.5 -27t-24.5 -64q0 -36 25 -62.5t60 -26.5t59.5 27t24.5 62zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf1d3;" horiz-adv-x="1792" d="M595 22q0 100 -165 100q-158 0 -158 -104q0 -101 172 -101q151 0 151 105zM536 777q0 61 -30 102t-89 41q-124 0 -124 -145q0 -135 124 -135q119 0 119 137zM805 1101v-202q-36 -12 -79 -22q16 -43 16 -84q0 -127 -73 -216.5t-197 -112.5q-40 -8 -59.5 -27t-19.5 -58 q0 -31 22.5 -51.5t58 -32t78.5 -22t86 -25.5t78.5 -37.5t58 -64t22.5 -98.5q0 -304 -363 -304q-69 0 -130 12.5t-116 41t-87.5 82t-32.5 127.5q0 165 182 225v4q-67 41 -67 126q0 109 63 137v4q-72 24 -119.5 108.5t-47.5 165.5q0 139 95 231.5t235 92.5q96 0 178 -47 q98 0 218 47zM1123 220h-222q4 45 4 134v609q0 94 -4 128h222q-4 -33 -4 -124v-613q0 -89 4 -134zM1724 442v-196q-71 -39 -174 -39q-62 0 -107 20t-70 50t-39.5 78t-18.5 92t-4 103v351h2v4q-7 0 -19 1t-18 1q-21 0 -59 -6v190h96v76q0 54 -6 89h227q-6 -41 -6 -165h171 v-190q-15 0 -43.5 2t-42.5 2h-85v-365q0 -131 87 -131q61 0 109 33zM1148 1389q0 -58 -39 -101.5t-96 -43.5q-58 0 -98 43.5t-40 101.5q0 59 39.5 103t98.5 44q58 0 96.5 -44.5t38.5 -102.5z" />
+<glyph unicode="&#xf1d4;" d="M809 532l266 499h-112l-157 -312q-24 -48 -44 -92l-42 92l-155 312h-120l263 -493v-324h101v318zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf1d5;" horiz-adv-x="1280" d="M842 964q0 -80 -57 -136.5t-136 -56.5q-60 0 -111 35q-62 -67 -115 -146q-247 -371 -202 -859q1 -22 -12.5 -38.5t-34.5 -18.5h-5q-20 0 -35 13.5t-17 33.5q-14 126 -3.5 247.5t29.5 217t54 186t69 155.5t74 125q61 90 132 165q-16 35 -16 77q0 80 56.5 136.5t136.5 56.5 t136.5 -56.5t56.5 -136.5zM1223 953q0 -158 -78 -292t-212.5 -212t-292.5 -78q-64 0 -131 14q-21 5 -32.5 23.5t-6.5 39.5q5 20 23 31.5t39 7.5q51 -13 108 -13q97 0 186 38t153 102t102 153t38 186t-38 186t-102 153t-153 102t-186 38t-186 -38t-153 -102t-102 -153 t-38 -186q0 -114 52 -218q10 -20 3.5 -40t-25.5 -30t-39.5 -3t-30.5 26q-64 123 -64 265q0 119 46.5 227t124.5 186t186 124t226 46q158 0 292.5 -78t212.5 -212.5t78 -292.5z" />
+<glyph unicode="&#xf1d6;" horiz-adv-x="1792" d="M270 730q-8 19 -8 52q0 20 11 49t24 45q-1 22 7.5 53t22.5 43q0 139 92.5 288.5t217.5 209.5q139 66 324 66q133 0 266 -55q49 -21 90 -48t71 -56t55 -68t42 -74t32.5 -84.5t25.5 -89.5t22 -98l1 -5q55 -83 55 -150q0 -14 -9 -40t-9 -38q0 -1 1.5 -3.5t3.5 -5t2 -3.5 q77 -114 120.5 -214.5t43.5 -208.5q0 -43 -19.5 -100t-55.5 -57q-9 0 -19.5 7.5t-19 17.5t-19 26t-16 26.5t-13.5 26t-9 17.5q-1 1 -3 1l-5 -4q-59 -154 -132 -223q20 -20 61.5 -38.5t69 -41.5t35.5 -65q-2 -4 -4 -16t-7 -18q-64 -97 -302 -97q-53 0 -110.5 9t-98 20 t-104.5 30q-15 5 -23 7q-14 4 -46 4.5t-40 1.5q-41 -45 -127.5 -65t-168.5 -20q-35 0 -69 1.5t-93 9t-101 20.5t-74.5 40t-32.5 64q0 40 10 59.5t41 48.5q11 2 40.5 13t49.5 12q4 0 14 2q2 2 2 4l-2 3q-48 11 -108 105.5t-73 156.5l-5 3q-4 0 -12 -20q-18 -41 -54.5 -74.5 t-77.5 -37.5h-1q-4 0 -6 4.5t-5 5.5q-23 54 -23 100q0 275 252 466z" />
+<glyph unicode="&#xf1d7;" horiz-adv-x="2048" d="M580 1075q0 41 -25 66t-66 25q-43 0 -76 -25.5t-33 -65.5q0 -39 33 -64.5t76 -25.5q41 0 66 24.5t25 65.5zM1323 568q0 28 -25.5 50t-65.5 22q-27 0 -49.5 -22.5t-22.5 -49.5q0 -28 22.5 -50.5t49.5 -22.5q40 0 65.5 22t25.5 51zM1087 1075q0 41 -24.5 66t-65.5 25 q-43 0 -76 -25.5t-33 -65.5q0 -39 33 -64.5t76 -25.5q41 0 65.5 24.5t24.5 65.5zM1722 568q0 28 -26 50t-65 22q-27 0 -49.5 -22.5t-22.5 -49.5q0 -28 22.5 -50.5t49.5 -22.5q39 0 65 22t26 51zM1456 965q-31 4 -70 4q-169 0 -311 -77t-223.5 -208.5t-81.5 -287.5 q0 -78 23 -152q-35 -3 -68 -3q-26 0 -50 1.5t-55 6.5t-44.5 7t-54.5 10.5t-50 10.5l-253 -127l72 218q-290 203 -290 490q0 169 97.5 311t264 223.5t363.5 81.5q176 0 332.5 -66t262 -182.5t136.5 -260.5zM2048 404q0 -117 -68.5 -223.5t-185.5 -193.5l55 -181l-199 109 q-150 -37 -218 -37q-169 0 -311 70.5t-223.5 191.5t-81.5 264t81.5 264t223.5 191.5t311 70.5q161 0 303 -70.5t227.5 -192t85.5 -263.5z" />
+<glyph unicode="&#xf1d8;" horiz-adv-x="1792" d="M1764 1525q33 -24 27 -64l-256 -1536q-5 -29 -32 -45q-14 -8 -31 -8q-11 0 -24 5l-453 185l-242 -295q-18 -23 -49 -23q-13 0 -22 4q-19 7 -30.5 23.5t-11.5 36.5v349l864 1059l-1069 -925l-395 162q-37 14 -40 55q-2 40 32 59l1664 960q15 9 32 9q20 0 36 -11z" />
+<glyph unicode="&#xf1d9;" horiz-adv-x="1792" d="M1764 1525q33 -24 27 -64l-256 -1536q-5 -29 -32 -45q-14 -8 -31 -8q-11 0 -24 5l-527 215l-298 -327q-18 -21 -47 -21q-14 0 -23 4q-19 7 -30 23.5t-11 36.5v452l-472 193q-37 14 -40 55q-3 39 32 59l1664 960q35 21 68 -2zM1422 26l221 1323l-1434 -827l336 -137 l863 639l-478 -797z" />
+<glyph unicode="&#xf1da;" d="M1536 640q0 -156 -61 -298t-164 -245t-245 -164t-298 -61q-172 0 -327 72.5t-264 204.5q-7 10 -6.5 22.5t8.5 20.5l137 138q10 9 25 9q16 -2 23 -12q73 -95 179 -147t225 -52q104 0 198.5 40.5t163.5 109.5t109.5 163.5t40.5 198.5t-40.5 198.5t-109.5 163.5 t-163.5 109.5t-198.5 40.5q-98 0 -188 -35.5t-160 -101.5l137 -138q31 -30 14 -69q-17 -40 -59 -40h-448q-26 0 -45 19t-19 45v448q0 42 40 59q39 17 69 -14l130 -129q107 101 244.5 156.5t284.5 55.5q156 0 298 -61t245 -164t164 -245t61 -298zM896 928v-448q0 -14 -9 -23 t-23 -9h-320q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h224v352q0 14 9 23t23 9h64q14 0 23 -9t9 -23z" />
+<glyph unicode="&#xf1db;" d="M768 1280q-130 0 -248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5t-51 248.5t-136.5 204t-204 136.5t-248.5 51zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103 t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf1dc;" horiz-adv-x="1792" d="M1682 -128q-44 0 -132.5 3.5t-133.5 3.5q-44 0 -132 -3.5t-132 -3.5q-24 0 -37 20.5t-13 45.5q0 31 17 46t39 17t51 7t45 15q33 21 33 140l-1 391q0 21 -1 31q-13 4 -50 4h-675q-38 0 -51 -4q-1 -10 -1 -31l-1 -371q0 -142 37 -164q16 -10 48 -13t57 -3.5t45 -15 t20 -45.5q0 -26 -12.5 -48t-36.5 -22q-47 0 -139.5 3.5t-138.5 3.5q-43 0 -128 -3.5t-127 -3.5q-23 0 -35.5 21t-12.5 45q0 30 15.5 45t36 17.5t47.5 7.5t42 15q33 23 33 143l-1 57v813q0 3 0.5 26t0 36.5t-1.5 38.5t-3.5 42t-6.5 36.5t-11 31.5t-16 18q-15 10 -45 12t-53 2 t-41 14t-18 45q0 26 12 48t36 22q46 0 138.5 -3.5t138.5 -3.5q42 0 126.5 3.5t126.5 3.5q25 0 37.5 -22t12.5 -48q0 -30 -17 -43.5t-38.5 -14.5t-49.5 -4t-43 -13q-35 -21 -35 -160l1 -320q0 -21 1 -32q13 -3 39 -3h699q25 0 38 3q1 11 1 32l1 320q0 139 -35 160 q-18 11 -58.5 12.5t-66 13t-25.5 49.5q0 26 12.5 48t37.5 22q44 0 132 -3.5t132 -3.5q43 0 129 3.5t129 3.5q25 0 37.5 -22t12.5 -48q0 -30 -17.5 -44t-40 -14.5t-51.5 -3t-44 -12.5q-35 -23 -35 -161l1 -943q0 -119 34 -140q16 -10 46 -13.5t53.5 -4.5t41.5 -15.5t18 -44.5 q0 -26 -12 -48t-36 -22z" />
+<glyph unicode="&#xf1dd;" horiz-adv-x="1280" d="M1278 1347v-73q0 -29 -18.5 -61t-42.5 -32q-50 0 -54 -1q-26 -6 -32 -31q-3 -11 -3 -64v-1152q0 -25 -18 -43t-43 -18h-108q-25 0 -43 18t-18 43v1218h-143v-1218q0 -25 -17.5 -43t-43.5 -18h-108q-26 0 -43.5 18t-17.5 43v496q-147 12 -245 59q-126 58 -192 179 q-64 117 -64 259q0 166 88 286q88 118 209 159q111 37 417 37h479q25 0 43 -18t18 -43z" />
+<glyph unicode="&#xf1de;" d="M352 128v-128h-352v128h352zM704 256q26 0 45 -19t19 -45v-256q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h256zM864 640v-128h-864v128h864zM224 1152v-128h-224v128h224zM1536 128v-128h-736v128h736zM576 1280q26 0 45 -19t19 -45v-256 q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h256zM1216 768q26 0 45 -19t19 -45v-256q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h256zM1536 640v-128h-224v128h224zM1536 1152v-128h-864v128h864z" />
+<glyph unicode="&#xf1e0;" d="M1216 512q133 0 226.5 -93.5t93.5 -226.5t-93.5 -226.5t-226.5 -93.5t-226.5 93.5t-93.5 226.5q0 12 2 34l-360 180q-92 -86 -218 -86q-133 0 -226.5 93.5t-93.5 226.5t93.5 226.5t226.5 93.5q126 0 218 -86l360 180q-2 22 -2 34q0 133 93.5 226.5t226.5 93.5 t226.5 -93.5t93.5 -226.5t-93.5 -226.5t-226.5 -93.5q-126 0 -218 86l-360 -180q2 -22 2 -34t-2 -34l360 -180q92 86 218 86z" />
+<glyph unicode="&#xf1e1;" d="M1280 341q0 88 -62.5 151t-150.5 63q-84 0 -145 -58l-241 120q2 16 2 23t-2 23l241 120q61 -58 145 -58q88 0 150.5 63t62.5 151t-62.5 150.5t-150.5 62.5t-151 -62.5t-63 -150.5q0 -7 2 -23l-241 -120q-62 57 -145 57q-88 0 -150.5 -62.5t-62.5 -150.5t62.5 -150.5 t150.5 -62.5q83 0 145 57l241 -120q-2 -16 -2 -23q0 -88 63 -150.5t151 -62.5t150.5 62.5t62.5 150.5zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf1e2;" horiz-adv-x="1792" d="M571 947q-10 25 -34 35t-49 0q-108 -44 -191 -127t-127 -191q-10 -25 0 -49t35 -34q13 -5 24 -5q42 0 60 40q34 84 98.5 148.5t148.5 98.5q25 11 35 35t0 49zM1513 1303l46 -46l-244 -243l68 -68q19 -19 19 -45.5t-19 -45.5l-64 -64q89 -161 89 -343q0 -143 -55.5 -273.5 t-150 -225t-225 -150t-273.5 -55.5t-273.5 55.5t-225 150t-150 225t-55.5 273.5t55.5 273.5t150 225t225 150t273.5 55.5q182 0 343 -89l64 64q19 19 45.5 19t45.5 -19l68 -68zM1521 1359q-10 -10 -22 -10q-13 0 -23 10l-91 90q-9 10 -9 23t9 23q10 9 23 9t23 -9l90 -91 q10 -9 10 -22.5t-10 -22.5zM1751 1129q-11 -9 -23 -9t-23 9l-90 91q-10 9 -10 22.5t10 22.5q9 10 22.5 10t22.5 -10l91 -90q9 -10 9 -23t-9 -23zM1792 1312q0 -14 -9 -23t-23 -9h-96q-14 0 -23 9t-9 23t9 23t23 9h96q14 0 23 -9t9 -23zM1600 1504v-96q0 -14 -9 -23t-23 -9 t-23 9t-9 23v96q0 14 9 23t23 9t23 -9t9 -23zM1751 1449l-91 -90q-10 -10 -22 -10q-13 0 -23 10q-10 9 -10 22.5t10 22.5l90 91q10 9 23 9t23 -9q9 -10 9 -23t-9 -23z" />
+<glyph unicode="&#xf1e3;" horiz-adv-x="1792" d="M609 720l287 208l287 -208l-109 -336h-355zM896 1536q182 0 348 -71t286 -191t191 -286t71 -348t-71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71zM1515 186q149 203 149 454v3l-102 -89l-240 224l63 323 l134 -12q-150 206 -389 282l53 -124l-287 -159l-287 159l53 124q-239 -76 -389 -282l135 12l62 -323l-240 -224l-102 89v-3q0 -251 149 -454l30 132l326 -40l139 -298l-116 -69q117 -39 240 -39t240 39l-116 69l139 298l326 40z" />
+<glyph unicode="&#xf1e4;" horiz-adv-x="1792" d="M448 224v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM256 608v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM832 224v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23 v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM640 608v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM66 768q-28 0 -47 19t-19 46v129h514v-129q0 -27 -19 -46t-46 -19h-383zM1216 224v-192q0 -14 -9 -23t-23 -9h-192 q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1024 608v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1600 224v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23 zM1408 608v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1792 1016v-13h-514v10q0 104 -382 102q-382 -1 -382 -102v-10h-514v13q0 17 8.5 43t34 64t65.5 75.5t110.5 76t160 67.5t224 47.5t293.5 18.5t293 -18.5t224 -47.5 t160.5 -67.5t110.5 -76t65.5 -75.5t34 -64t8.5 -43zM1792 608v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1792 962v-129q0 -27 -19 -46t-46 -19h-384q-27 0 -46 19t-19 46v129h514z" />
+<glyph unicode="&#xf1e5;" horiz-adv-x="1792" d="M704 1216v-768q0 -26 -19 -45t-45 -19v-576q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v512l249 873q7 23 31 23h424zM1024 1216v-704h-256v704h256zM1792 320v-512q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v576q-26 0 -45 19t-19 45v768h424q24 0 31 -23z M736 1504v-224h-352v224q0 14 9 23t23 9h288q14 0 23 -9t9 -23zM1408 1504v-224h-352v224q0 14 9 23t23 9h288q14 0 23 -9t9 -23z" />
+<glyph unicode="&#xf1e6;" horiz-adv-x="1792" d="M1755 1083q37 -37 37 -90t-37 -91l-401 -400l150 -150l-160 -160q-163 -163 -389.5 -186.5t-411.5 100.5l-362 -362h-181v181l362 362q-124 185 -100.5 411.5t186.5 389.5l160 160l150 -150l400 401q38 37 91 37t90 -37t37 -90.5t-37 -90.5l-400 -401l234 -234l401 400 q38 37 91 37t90 -37z" />
+<glyph unicode="&#xf1e7;" horiz-adv-x="1792" d="M873 796q0 -83 -63.5 -142.5t-152.5 -59.5t-152.5 59.5t-63.5 142.5q0 84 63.5 143t152.5 59t152.5 -59t63.5 -143zM1375 796q0 -83 -63 -142.5t-153 -59.5q-89 0 -152.5 59.5t-63.5 142.5q0 84 63.5 143t152.5 59q90 0 153 -59t63 -143zM1600 616v667q0 87 -32 123.5 t-111 36.5h-1112q-83 0 -112.5 -34t-29.5 -126v-673q43 -23 88.5 -40t81 -28t81 -18.5t71 -11t70 -4t58.5 -0.5t56.5 2t44.5 2q68 1 95 -27q6 -6 10 -9q26 -25 61 -51q7 91 118 87q5 0 36.5 -1.5t43 -2t45.5 -1t53 1t54.5 4.5t61 8.5t62 13.5t67 19.5t67.5 27t72 34.5z M1763 621q-121 -149 -372 -252q84 -285 -23 -465q-66 -113 -183 -148q-104 -32 -182 15q-86 51 -82 164l-1 326v1q-8 2 -24.5 6t-23.5 5l-1 -338q4 -114 -83 -164q-79 -47 -183 -15q-117 36 -182 150q-105 180 -22 463q-251 103 -372 252q-25 37 -4 63t60 -1q3 -2 11 -7 t11 -8v694q0 72 47 123t114 51h1257q67 0 114 -51t47 -123v-694l21 15q39 27 60 1t-4 -63z" />
+<glyph unicode="&#xf1e8;" horiz-adv-x="1792" d="M896 1102v-434h-145v434h145zM1294 1102v-434h-145v434h145zM1294 342l253 254v795h-1194v-1049h326v-217l217 217h398zM1692 1536v-1013l-434 -434h-326l-217 -217h-217v217h-398v1158l109 289h1483z" />
+<glyph unicode="&#xf1e9;" d="M773 217v-127q-1 -292 -6 -305q-12 -32 -51 -40q-54 -9 -181.5 38t-162.5 89q-13 15 -17 36q-1 12 4 26q4 10 34 47t181 216q1 0 60 70q15 19 39.5 24.5t49.5 -3.5q24 -10 37.5 -29t12.5 -42zM624 468q-3 -55 -52 -70l-120 -39q-275 -88 -292 -88q-35 2 -54 36 q-12 25 -17 75q-8 76 1 166.5t30 124.5t56 32q13 0 202 -77q70 -29 115 -47l84 -34q23 -9 35.5 -30.5t11.5 -48.5zM1450 171q-7 -54 -91.5 -161t-135.5 -127q-37 -14 -63 7q-14 10 -184 287l-47 77q-14 21 -11.5 46t19.5 46q35 43 83 26q1 -1 119 -40q203 -66 242 -79.5 t47 -20.5q28 -22 22 -61zM778 803q5 -102 -54 -122q-58 -17 -114 71l-378 598q-8 35 19 62q41 43 207.5 89.5t224.5 31.5q40 -10 49 -45q3 -18 22 -305.5t24 -379.5zM1440 695q3 -39 -26 -59q-15 -10 -329 -86q-67 -15 -91 -23l1 2q-23 -6 -46 4t-37 32q-30 47 0 87 q1 1 75 102q125 171 150 204t34 39q28 19 65 2q48 -23 123 -133.5t81 -167.5v-3z" />
+<glyph unicode="&#xf1ea;" horiz-adv-x="2048" d="M1024 1024h-384v-384h384v384zM1152 384v-128h-640v128h640zM1152 1152v-640h-640v640h640zM1792 384v-128h-512v128h512zM1792 640v-128h-512v128h512zM1792 896v-128h-512v128h512zM1792 1152v-128h-512v128h512zM256 192v960h-128v-960q0 -26 19 -45t45 -19t45 19 t19 45zM1920 192v1088h-1536v-1088q0 -33 -11 -64h1483q26 0 45 19t19 45zM2048 1408v-1216q0 -80 -56 -136t-136 -56h-1664q-80 0 -136 56t-56 136v1088h256v128h1792z" />
+<glyph unicode="&#xf1eb;" horiz-adv-x="2048" d="M1024 13q-20 0 -93 73.5t-73 93.5q0 32 62.5 54t103.5 22t103.5 -22t62.5 -54q0 -20 -73 -93.5t-93 -73.5zM1294 284q-2 0 -40 25t-101.5 50t-128.5 25t-128.5 -25t-101 -50t-40.5 -25q-18 0 -93.5 75t-75.5 93q0 13 10 23q78 77 196 121t233 44t233 -44t196 -121 q10 -10 10 -23q0 -18 -75.5 -93t-93.5 -75zM1567 556q-11 0 -23 8q-136 105 -252 154.5t-268 49.5q-85 0 -170.5 -22t-149 -53t-113.5 -62t-79 -53t-31 -22q-17 0 -92 75t-75 93q0 12 10 22q132 132 320 205t380 73t380 -73t320 -205q10 -10 10 -22q0 -18 -75 -93t-92 -75z M1838 827q-11 0 -22 9q-179 157 -371.5 236.5t-420.5 79.5t-420.5 -79.5t-371.5 -236.5q-11 -9 -22 -9q-17 0 -92.5 75t-75.5 93q0 13 10 23q187 186 445 288t527 102t527 -102t445 -288q10 -10 10 -23q0 -18 -75.5 -93t-92.5 -75z" />
+<glyph unicode="&#xf1ec;" horiz-adv-x="1792" d="M384 0q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM768 0q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM384 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5 t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1152 0q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM768 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5 t37.5 90.5zM384 768q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1152 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM768 768q0 53 -37.5 90.5t-90.5 37.5 t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1536 0v384q0 52 -38 90t-90 38t-90 -38t-38 -90v-384q0 -52 38 -90t90 -38t90 38t38 90zM1152 768q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5z M1536 1088v256q0 26 -19 45t-45 19h-1280q-26 0 -45 -19t-19 -45v-256q0 -26 19 -45t45 -19h1280q26 0 45 19t19 45zM1536 768q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1664 1408v-1536q0 -52 -38 -90t-90 -38 h-1408q-52 0 -90 38t-38 90v1536q0 52 38 90t90 38h1408q52 0 90 -38t38 -90z" />
+<glyph unicode="&#xf1ed;" d="M1519 890q18 -84 -4 -204q-87 -444 -565 -444h-44q-25 0 -44 -16.5t-24 -42.5l-4 -19l-55 -346l-2 -15q-5 -26 -24.5 -42.5t-44.5 -16.5h-251q-21 0 -33 15t-9 36q9 56 26.5 168t26.5 168t27 167.5t27 167.5q5 37 43 37h131q133 -2 236 21q175 39 287 144q102 95 155 246 q24 70 35 133q1 6 2.5 7.5t3.5 1t6 -3.5q79 -59 98 -162zM1347 1172q0 -107 -46 -236q-80 -233 -302 -315q-113 -40 -252 -42q0 -1 -90 -1l-90 1q-100 0 -118 -96q-2 -8 -85 -530q-1 -10 -12 -10h-295q-22 0 -36.5 16.5t-11.5 38.5l232 1471q5 29 27.5 48t51.5 19h598 q34 0 97.5 -13t111.5 -32q107 -41 163.5 -123t56.5 -196z" />
+<glyph unicode="&#xf1ee;" horiz-adv-x="1792" d="M441 864q32 0 52 -26q266 -364 362 -774h-446q-127 441 -367 749q-12 16 -3 33.5t29 17.5h373zM1000 507q-49 -199 -125 -393q-79 310 -256 594q40 221 44 449q211 -340 337 -650zM1099 1216q235 -324 384.5 -698.5t184.5 -773.5h-451q-41 665 -553 1472h435zM1792 640 q0 -424 -101 -812q-67 560 -359 1083q-25 301 -106 584q-4 16 5.5 28.5t25.5 12.5h359q21 0 38.5 -13t22.5 -33q115 -409 115 -850z" />
+<glyph unicode="&#xf1f0;" horiz-adv-x="2304" d="M1975 546h-138q14 37 66 179l3 9q4 10 10 26t9 26l12 -55zM531 611l-58 295q-11 54 -75 54h-268l-2 -13q311 -79 403 -336zM710 960l-162 -438l-17 89q-26 70 -85 129.5t-131 88.5l135 -510h175l261 641h-176zM849 318h166l104 642h-166zM1617 944q-69 27 -149 27 q-123 0 -201 -59t-79 -153q-1 -102 145 -174q48 -23 67 -41t19 -39q0 -30 -30 -46t-69 -16q-86 0 -156 33l-22 11l-23 -144q74 -34 185 -34q130 -1 208.5 59t80.5 160q0 106 -140 174q-49 25 -71 42t-22 38q0 22 24.5 38.5t70.5 16.5q70 1 124 -24l15 -8zM2042 960h-128 q-65 0 -87 -54l-246 -588h174l35 96h212q5 -22 20 -96h154zM2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h2048q52 0 90 -38t38 -90z" />
+<glyph unicode="&#xf1f1;" horiz-adv-x="2304" d="M671 603h-13q-47 0 -47 -32q0 -22 20 -22q17 0 28 15t12 39zM1066 639h62v3q1 4 0.5 6.5t-1 7t-2 8t-4.5 6.5t-7.5 5t-11.5 2q-28 0 -36 -38zM1606 603h-12q-48 0 -48 -32q0 -22 20 -22q17 0 28 15t12 39zM1925 629q0 41 -30 41q-19 0 -31 -20t-12 -51q0 -42 28 -42 q20 0 32.5 20t12.5 52zM480 770h87l-44 -262h-56l32 201l-71 -201h-39l-4 200l-34 -200h-53l44 262h81l2 -163zM733 663q0 -6 -4 -42q-16 -101 -17 -113h-47l1 22q-20 -26 -58 -26q-23 0 -37.5 16t-14.5 42q0 39 26 60.5t73 21.5q14 0 23 -1q0 3 0.5 5.5t1 4.5t0.5 3 q0 20 -36 20q-29 0 -59 -10q0 4 7 48q38 11 67 11q74 0 74 -62zM889 721l-8 -49q-22 3 -41 3q-27 0 -27 -17q0 -8 4.5 -12t21.5 -11q40 -19 40 -60q0 -72 -87 -71q-34 0 -58 6q0 2 7 49q29 -8 51 -8q32 0 32 19q0 7 -4.5 11.5t-21.5 12.5q-43 20 -43 59q0 72 84 72 q30 0 50 -4zM977 721h28l-7 -52h-29q-2 -17 -6.5 -40.5t-7 -38.5t-2.5 -18q0 -16 19 -16q8 0 16 2l-8 -47q-21 -7 -40 -7q-43 0 -45 47q0 12 8 56q3 20 25 146h55zM1180 648q0 -23 -7 -52h-111q-3 -22 10 -33t38 -11q30 0 58 14l-9 -54q-30 -8 -57 -8q-95 0 -95 95 q0 55 27.5 90.5t69.5 35.5q35 0 55.5 -21t20.5 -56zM1319 722q-13 -23 -22 -62q-22 2 -31 -24t-25 -128h-56l3 14q22 130 29 199h51l-3 -33q14 21 25.5 29.5t28.5 4.5zM1506 763l-9 -57q-28 14 -50 14q-31 0 -51 -27.5t-20 -70.5q0 -30 13.5 -47t38.5 -17q21 0 48 13 l-10 -59q-28 -8 -50 -8q-45 0 -71.5 30.5t-26.5 82.5q0 70 35.5 114.5t91.5 44.5q26 0 61 -13zM1668 663q0 -18 -4 -42q-13 -79 -17 -113h-46l1 22q-20 -26 -59 -26q-23 0 -37 16t-14 42q0 39 25.5 60.5t72.5 21.5q15 0 23 -1q2 7 2 13q0 20 -36 20q-29 0 -59 -10q0 4 8 48 q38 11 67 11q73 0 73 -62zM1809 722q-14 -24 -21 -62q-23 2 -31.5 -23t-25.5 -129h-56l3 14q19 104 29 199h52q0 -11 -4 -33q15 21 26.5 29.5t27.5 4.5zM1950 770h56l-43 -262h-53l3 19q-23 -23 -52 -23q-31 0 -49.5 24t-18.5 64q0 53 27.5 92t64.5 39q31 0 53 -29z M2061 640q0 148 -72.5 273t-198 198t-273.5 73q-181 0 -328 -110q127 -116 171 -284h-50q-44 150 -158 253q-114 -103 -158 -253h-50q44 168 171 284q-147 110 -328 110q-148 0 -273.5 -73t-198 -198t-72.5 -273t72.5 -273t198 -198t273.5 -73q181 0 328 110 q-120 111 -165 264h50q46 -138 152 -233q106 95 152 233h50q-45 -153 -165 -264q147 -110 328 -110q148 0 273.5 73t198 198t72.5 273zM2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h2048q52 0 90 -38t38 -90z" />
+<glyph unicode="&#xf1f2;" horiz-adv-x="2304" d="M313 759q0 -51 -36 -84q-29 -26 -89 -26h-17v220h17q61 0 89 -27q36 -31 36 -83zM2089 824q0 -52 -64 -52h-19v101h20q63 0 63 -49zM380 759q0 74 -50 120.5t-129 46.5h-95v-333h95q74 0 119 38q60 51 60 128zM410 593h65v333h-65v-333zM730 694q0 40 -20.5 62t-75.5 42 q-29 10 -39.5 19t-10.5 23q0 16 13.5 26.5t34.5 10.5q29 0 53 -27l34 44q-41 37 -98 37q-44 0 -74 -27.5t-30 -67.5q0 -35 18 -55.5t64 -36.5q37 -13 45 -19q19 -12 19 -34q0 -20 -14 -33.5t-36 -13.5q-48 0 -71 44l-42 -40q44 -64 115 -64q51 0 83 30.5t32 79.5zM1008 604 v77q-37 -37 -78 -37q-49 0 -80.5 32.5t-31.5 82.5q0 48 31.5 81.5t77.5 33.5q43 0 81 -38v77q-40 20 -80 20q-74 0 -125.5 -50.5t-51.5 -123.5t51 -123.5t125 -50.5q42 0 81 19zM2240 0v527q-65 -40 -144.5 -84t-237.5 -117t-329.5 -137.5t-417.5 -134.5t-504 -118h1569 q26 0 45 19t19 45zM1389 757q0 75 -53 128t-128 53t-128 -53t-53 -128t53 -128t128 -53t128 53t53 128zM1541 584l144 342h-71l-90 -224l-89 224h-71l142 -342h35zM1714 593h184v56h-119v90h115v56h-115v74h119v57h-184v-333zM2105 593h80l-105 140q76 16 76 94q0 47 -31 73 t-87 26h-97v-333h65v133h9zM2304 1274v-1268q0 -56 -38.5 -95t-93.5 -39h-2040q-55 0 -93.5 39t-38.5 95v1268q0 56 38.5 95t93.5 39h2040q55 0 93.5 -39t38.5 -95z" />
+<glyph unicode="&#xf1f3;" horiz-adv-x="2304" d="M119 854h89l-45 108zM740 328l74 79l-70 79h-163v-49h142v-55h-142v-54h159zM898 406l99 -110v217zM1186 453q0 33 -40 33h-84v-69h83q41 0 41 36zM1475 457q0 29 -42 29h-82v-61h81q43 0 43 32zM1197 923q0 29 -42 29h-82v-60h81q43 0 43 31zM1656 854h89l-44 108z M699 1009v-271h-66v212l-94 -212h-57l-94 212v-212h-132l-25 60h-135l-25 -60h-70l116 271h96l110 -257v257h106l85 -184l77 184h108zM1255 453q0 -20 -5.5 -35t-14 -25t-22.5 -16.5t-26 -10t-31.5 -4.5t-31.5 -1t-32.5 0.5t-29.5 0.5v-91h-126l-80 90l-83 -90h-256v271h260 l80 -89l82 89h207q109 0 109 -89zM964 794v-56h-217v271h217v-57h-152v-49h148v-55h-148v-54h152zM2304 235v-229q0 -55 -38.5 -94.5t-93.5 -39.5h-2040q-55 0 -93.5 39.5t-38.5 94.5v678h111l25 61h55l25 -61h218v46l19 -46h113l20 47v-47h541v99l10 1q10 0 10 -14v-86h279 v23q23 -12 55 -18t52.5 -6.5t63 0.5t51.5 1l25 61h56l25 -61h227v58l34 -58h182v378h-180v-44l-25 44h-185v-44l-23 44h-249q-69 0 -109 -22v22h-172v-22q-24 22 -73 22h-628l-43 -97l-43 97h-198v-44l-22 44h-169l-78 -179v391q0 55 38.5 94.5t93.5 39.5h2040 q55 0 93.5 -39.5t38.5 -94.5v-678h-120q-51 0 -81 -22v22h-177q-55 0 -78 -22v22h-316v-22q-31 22 -87 22h-209v-22q-23 22 -91 22h-234l-54 -58l-50 58h-349v-378h343l55 59l52 -59h211v89h21q59 0 90 13v-102h174v99h8q8 0 10 -2t2 -10v-87h529q57 0 88 24v-24h168 q60 0 95 17zM1546 469q0 -23 -12 -43t-34 -29q25 -9 34 -26t9 -46v-54h-65v45q0 33 -12 43.5t-46 10.5h-69v-99h-65v271h154q48 0 77 -15t29 -58zM1269 936q0 -24 -12.5 -44t-33.5 -29q26 -9 34.5 -25.5t8.5 -46.5v-53h-65q0 9 0.5 26.5t0 25t-3 18.5t-8.5 16t-17.5 8.5 t-29.5 3.5h-70v-98h-64v271l153 -1q49 0 78 -14.5t29 -57.5zM1798 327v-56h-216v271h216v-56h-151v-49h148v-55h-148v-54zM1372 1009v-271h-66v271h66zM2065 357q0 -86 -102 -86h-126v58h126q34 0 34 25q0 16 -17 21t-41.5 5t-49.5 3.5t-42 22.5t-17 55q0 39 26 60t66 21 h130v-57h-119q-36 0 -36 -25q0 -16 17.5 -20.5t42 -4t49 -2.5t42 -21.5t17.5 -54.5zM2304 407v-101q-24 -35 -88 -35h-125v58h125q33 0 33 25q0 13 -12.5 19t-31 5.5t-40 2t-40 8t-31 24t-12.5 48.5q0 39 26.5 60t66.5 21h129v-57h-118q-36 0 -36 -25q0 -20 29 -22t68.5 -5 t56.5 -26zM2139 1008v-270h-92l-122 203v-203h-132l-26 60h-134l-25 -60h-75q-129 0 -129 133q0 138 133 138h63v-59q-7 0 -28 1t-28.5 0.5t-23 -2t-21.5 -6.5t-14.5 -13.5t-11.5 -23t-3 -33.5q0 -38 13.5 -58t49.5 -20h29l92 213h97l109 -256v256h99l114 -188v188h66z" />
+<glyph unicode="&#xf1f4;" horiz-adv-x="2304" d="M745 630q0 -37 -25.5 -61.5t-62.5 -24.5q-29 0 -46.5 16t-17.5 44q0 37 25 62.5t62 25.5q28 0 46.5 -16.5t18.5 -45.5zM1530 779q0 -42 -22 -57t-66 -15l-32 -1l17 107q2 11 13 11h18q22 0 35 -2t25 -12.5t12 -30.5zM1881 630q0 -36 -25.5 -61t-61.5 -25q-29 0 -47 16 t-18 44q0 37 25 62.5t62 25.5q28 0 46.5 -16.5t18.5 -45.5zM513 801q0 59 -38.5 85.5t-100.5 26.5h-160q-19 0 -21 -19l-65 -408q-1 -6 3 -11t10 -5h76q20 0 22 19l18 110q1 8 7 13t15 6.5t17 1.5t19 -1t14 -1q86 0 135 48.5t49 134.5zM822 489l41 261q1 6 -3 11t-10 5h-76 q-14 0 -17 -33q-27 40 -95 40q-72 0 -122.5 -54t-50.5 -127q0 -59 34.5 -94t92.5 -35q28 0 58 12t48 32q-4 -12 -4 -21q0 -16 13 -16h69q19 0 22 19zM1269 752q0 5 -4 9.5t-9 4.5h-77q-11 0 -18 -10l-106 -156l-44 150q-5 16 -22 16h-75q-5 0 -9 -4.5t-4 -9.5q0 -2 19.5 -59 t42 -123t23.5 -70q-82 -112 -82 -120q0 -13 13 -13h77q11 0 18 10l255 368q2 2 2 7zM1649 801q0 59 -38.5 85.5t-100.5 26.5h-159q-20 0 -22 -19l-65 -408q-1 -6 3 -11t10 -5h82q12 0 16 13l18 116q1 8 7 13t15 6.5t17 1.5t19 -1t14 -1q86 0 135 48.5t49 134.5zM1958 489 l41 261q1 6 -3 11t-10 5h-76q-14 0 -17 -33q-26 40 -95 40q-72 0 -122.5 -54t-50.5 -127q0 -59 34.5 -94t92.5 -35q29 0 59 12t47 32q0 -1 -2 -9t-2 -12q0 -16 13 -16h69q19 0 22 19zM2176 898v1q0 14 -13 14h-74q-11 0 -13 -11l-65 -416l-1 -2q0 -5 4 -9.5t10 -4.5h66 q19 0 21 19zM392 764q-5 -35 -26 -46t-60 -11l-33 -1l17 107q2 11 13 11h19q40 0 58 -11.5t12 -48.5zM2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h2048q52 0 90 -38t38 -90z" />
+<glyph unicode="&#xf1f5;" horiz-adv-x="2304" d="M1597 633q0 -69 -21 -106q-19 -35 -52 -35q-23 0 -41 9v224q29 30 57 30q57 0 57 -122zM2035 669h-110q6 98 56 98q51 0 54 -98zM476 534q0 59 -33 91.5t-101 57.5q-36 13 -52 24t-16 25q0 26 38 26q58 0 124 -33l18 112q-67 32 -149 32q-77 0 -123 -38q-48 -39 -48 -109 q0 -58 32.5 -90.5t99.5 -56.5q39 -14 54.5 -25.5t15.5 -27.5q0 -31 -48 -31q-29 0 -70 12.5t-72 30.5l-18 -113q72 -41 168 -41q81 0 129 37q51 41 51 117zM771 749l19 111h-96v135l-129 -21l-18 -114l-46 -8l-17 -103h62v-219q0 -84 44 -120q38 -30 111 -30q32 0 79 11v118 q-32 -7 -44 -7q-42 0 -42 50v197h77zM1087 724v139q-15 3 -28 3q-32 0 -55.5 -16t-33.5 -46l-10 56h-131v-471h150v306q26 31 82 31q16 0 26 -2zM1124 389h150v471h-150v-471zM1746 638q0 122 -45 179q-40 52 -111 52q-64 0 -117 -56l-8 47h-132v-645l150 25v151 q36 -11 68 -11q83 0 134 56q61 65 61 202zM1278 986q0 33 -23 56t-56 23t-56 -23t-23 -56t23 -56.5t56 -23.5t56 23.5t23 56.5zM2176 629q0 113 -48 176q-50 64 -144 64q-96 0 -151.5 -66t-55.5 -180q0 -128 63 -188q55 -55 161 -55q101 0 160 40l-16 103q-57 -31 -128 -31 q-43 0 -63 19q-23 19 -28 66h248q2 14 2 52zM2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h2048q52 0 90 -38t38 -90z" />
+<glyph unicode="&#xf1f6;" horiz-adv-x="2048" d="M1558 684q61 -356 298 -556q0 -52 -38 -90t-90 -38h-448q0 -106 -75 -181t-181 -75t-180.5 74.5t-75.5 180.5zM1024 -176q16 0 16 16t-16 16q-59 0 -101.5 42.5t-42.5 101.5q0 16 -16 16t-16 -16q0 -73 51.5 -124.5t124.5 -51.5zM2026 1424q8 -10 7.5 -23.5t-10.5 -22.5 l-1872 -1622q-10 -8 -23.5 -7t-21.5 11l-84 96q-8 10 -7.5 23.5t10.5 21.5l186 161q-19 32 -19 66q50 42 91 88t85 119.5t74.5 158.5t50 206t19.5 260q0 152 117 282.5t307 158.5q-8 19 -8 39q0 40 28 68t68 28t68 -28t28 -68q0 -20 -8 -39q124 -18 219 -82.5t148 -157.5 l418 363q10 8 23.5 7t21.5 -11z" />
+<glyph unicode="&#xf1f7;" horiz-adv-x="2048" d="M1040 -160q0 16 -16 16q-59 0 -101.5 42.5t-42.5 101.5q0 16 -16 16t-16 -16q0 -73 51.5 -124.5t124.5 -51.5q16 0 16 16zM503 315l877 760q-42 88 -132.5 146.5t-223.5 58.5q-93 0 -169.5 -31.5t-121.5 -80.5t-69 -103t-24 -105q0 -384 -137 -645zM1856 128 q0 -52 -38 -90t-90 -38h-448q0 -106 -75 -181t-181 -75t-180.5 74.5t-75.5 180.5l149 129h757q-166 187 -227 459l111 97q61 -356 298 -556zM1942 1520l84 -96q8 -10 7.5 -23.5t-10.5 -22.5l-1872 -1622q-10 -8 -23.5 -7t-21.5 11l-84 96q-8 10 -7.5 23.5t10.5 21.5l186 161 q-19 32 -19 66q50 42 91 88t85 119.5t74.5 158.5t50 206t19.5 260q0 152 117 282.5t307 158.5q-8 19 -8 39q0 40 28 68t68 28t68 -28t28 -68q0 -20 -8 -39q124 -18 219 -82.5t148 -157.5l418 363q10 8 23.5 7t21.5 -11z" />
+<glyph unicode="&#xf1f8;" horiz-adv-x="1408" d="M512 160v704q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-704q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM768 160v704q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-704q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1024 160v704q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-704 q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM480 1152h448l-48 117q-7 9 -17 11h-317q-10 -2 -17 -11zM1408 1120v-64q0 -14 -9 -23t-23 -9h-96v-948q0 -83 -47 -143.5t-113 -60.5h-832q-66 0 -113 58.5t-47 141.5v952h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h309l70 167 q15 37 54 63t79 26h320q40 0 79 -26t54 -63l70 -167h309q14 0 23 -9t9 -23z" />
+<glyph unicode="&#xf1f9;" d="M1150 462v-109q0 -50 -36.5 -89t-94 -60.5t-118 -32.5t-117.5 -11q-205 0 -342.5 139t-137.5 346q0 203 136 339t339 136q34 0 75.5 -4.5t93 -18t92.5 -34t69 -56.5t28 -81v-109q0 -16 -16 -16h-118q-16 0 -16 16v70q0 43 -65.5 67.5t-137.5 24.5q-140 0 -228.5 -91.5 t-88.5 -237.5q0 -151 91.5 -249.5t233.5 -98.5q68 0 138 24t70 66v70q0 7 4.5 11.5t10.5 4.5h119q6 0 11 -4.5t5 -11.5zM768 1280q-130 0 -248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5 t-51 248.5t-136.5 204t-204 136.5t-248.5 51zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf1fa;" d="M972 761q0 108 -53.5 169t-147.5 61q-63 0 -124 -30.5t-110 -84.5t-79.5 -137t-30.5 -180q0 -112 53.5 -173t150.5 -61q96 0 176 66.5t122.5 166t42.5 203.5zM1536 640q0 -111 -37 -197t-98.5 -135t-131.5 -74.5t-145 -27.5q-6 0 -15.5 -0.5t-16.5 -0.5q-95 0 -142 53 q-28 33 -33 83q-52 -66 -131.5 -110t-173.5 -44q-161 0 -249.5 95.5t-88.5 269.5q0 157 66 290t179 210.5t246 77.5q87 0 155 -35.5t106 -99.5l2 19l11 56q1 6 5.5 12t9.5 6h118q5 0 13 -11q5 -5 3 -16l-120 -614q-5 -24 -5 -48q0 -39 12.5 -52t44.5 -13q28 1 57 5.5t73 24 t77 50t57 89.5t24 137q0 292 -174 466t-466 174q-130 0 -248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51q228 0 405 144q11 9 24 8t21 -12l41 -49q8 -12 7 -24q-2 -13 -12 -22q-102 -83 -227.5 -128t-258.5 -45q-156 0 -298 61 t-245 164t-164 245t-61 298t61 298t164 245t245 164t298 61q344 0 556 -212t212 -556z" />
+<glyph unicode="&#xf1fb;" horiz-adv-x="1792" d="M1698 1442q94 -94 94 -226.5t-94 -225.5l-225 -223l104 -104q10 -10 10 -23t-10 -23l-210 -210q-10 -10 -23 -10t-23 10l-105 105l-603 -603q-37 -37 -90 -37h-203l-256 -128l-64 64l128 256v203q0 53 37 90l603 603l-105 105q-10 10 -10 23t10 23l210 210q10 10 23 10 t23 -10l104 -104l223 225q93 94 225.5 94t226.5 -94zM512 64l576 576l-192 192l-576 -576v-192h192z" />
+<glyph unicode="&#xf1fc;" horiz-adv-x="1792" d="M1615 1536q70 0 122.5 -46.5t52.5 -116.5q0 -63 -45 -151q-332 -629 -465 -752q-97 -91 -218 -91q-126 0 -216.5 92.5t-90.5 219.5q0 128 92 212l638 579q59 54 130 54zM706 502q39 -76 106.5 -130t150.5 -76l1 -71q4 -213 -129.5 -347t-348.5 -134q-123 0 -218 46.5 t-152.5 127.5t-86.5 183t-29 220q7 -5 41 -30t62 -44.5t59 -36.5t46 -17q41 0 55 37q25 66 57.5 112.5t69.5 76t88 47.5t103 25.5t125 10.5z" />
+<glyph unicode="&#xf1fd;" horiz-adv-x="1792" d="M1792 128v-384h-1792v384q45 0 85 14t59 27.5t47 37.5q30 27 51.5 38t56.5 11t55.5 -11t52.5 -38q29 -25 47 -38t58 -27t86 -14q45 0 85 14.5t58 27t48 37.5q21 19 32.5 27t31 15t43.5 7q35 0 56.5 -11t51.5 -38q28 -24 47 -37.5t59 -27.5t85 -14t85 14t59 27.5t47 37.5 q30 27 51.5 38t56.5 11q34 0 55.5 -11t51.5 -38q28 -24 47 -37.5t59 -27.5t85 -14zM1792 448v-192q-35 0 -55.5 11t-52.5 38q-29 25 -47 38t-58 27t-85 14q-46 0 -86 -14t-58 -27t-47 -38q-22 -19 -33 -27t-31 -15t-44 -7q-35 0 -56.5 11t-51.5 38q-29 25 -47 38t-58 27 t-86 14q-45 0 -85 -14.5t-58 -27t-48 -37.5q-21 -19 -32.5 -27t-31 -15t-43.5 -7q-35 0 -56.5 11t-51.5 38q-28 24 -47 37.5t-59 27.5t-85 14q-46 0 -86 -14t-58 -27t-47 -38q-30 -27 -51.5 -38t-56.5 -11v192q0 80 56 136t136 56h64v448h256v-448h256v448h256v-448h256v448 h256v-448h64q80 0 136 -56t56 -136zM512 1312q0 -77 -36 -118.5t-92 -41.5q-53 0 -90.5 37.5t-37.5 90.5q0 29 9.5 51t23.5 34t31 28t31 31.5t23.5 44.5t9.5 67q38 0 83 -74t45 -150zM1024 1312q0 -77 -36 -118.5t-92 -41.5q-53 0 -90.5 37.5t-37.5 90.5q0 29 9.5 51 t23.5 34t31 28t31 31.5t23.5 44.5t9.5 67q38 0 83 -74t45 -150zM1536 1312q0 -77 -36 -118.5t-92 -41.5q-53 0 -90.5 37.5t-37.5 90.5q0 29 9.5 51t23.5 34t31 28t31 31.5t23.5 44.5t9.5 67q38 0 83 -74t45 -150z" />
+<glyph unicode="&#xf1fe;" horiz-adv-x="2048" d="M2048 0v-128h-2048v1536h128v-1408h1920zM1664 1024l256 -896h-1664v576l448 576l576 -576z" />
+<glyph unicode="&#xf200;" horiz-adv-x="1792" d="M768 646l546 -546q-106 -108 -247.5 -168t-298.5 -60q-209 0 -385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103v-762zM955 640h773q0 -157 -60 -298.5t-168 -247.5zM1664 768h-768v768q209 0 385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf201;" horiz-adv-x="2048" d="M2048 0v-128h-2048v1536h128v-1408h1920zM1920 1248v-435q0 -21 -19.5 -29.5t-35.5 7.5l-121 121l-633 -633q-10 -10 -23 -10t-23 10l-233 233l-416 -416l-192 192l585 585q10 10 23 10t23 -10l233 -233l464 464l-121 121q-16 16 -7.5 35.5t29.5 19.5h435q14 0 23 -9 t9 -23z" />
+<glyph unicode="&#xf202;" horiz-adv-x="1792" d="M1292 832q0 -6 10 -41q10 -29 25 -49.5t41 -34t44 -20t55 -16.5q325 -91 325 -332q0 -146 -105.5 -242.5t-254.5 -96.5q-59 0 -111.5 18.5t-91.5 45.5t-77 74.5t-63 87.5t-53.5 103.5t-43.5 103t-39.5 106.5t-35.5 95q-32 81 -61.5 133.5t-73.5 96.5t-104 64t-142 20 q-96 0 -183 -55.5t-138 -144.5t-51 -185q0 -160 106.5 -279.5t263.5 -119.5q177 0 258 95q56 63 83 116l84 -152q-15 -34 -44 -70l1 -1q-131 -152 -388 -152q-147 0 -269.5 79t-190.5 207.5t-68 274.5q0 105 43.5 206t116 176.5t172 121.5t204.5 46q87 0 159 -19t123.5 -50 t95 -80t72.5 -99t58.5 -117t50.5 -124.5t50 -130.5t55 -127q96 -200 233 -200q81 0 138.5 48.5t57.5 128.5q0 42 -19 72t-50.5 46t-72.5 31.5t-84.5 27t-87.5 34t-81 52t-65 82t-39 122.5q-3 16 -3 33q0 110 87.5 192t198.5 78q78 -3 120.5 -14.5t90.5 -53.5h-1 q12 -11 23 -24.5t26 -36t19 -27.5l-129 -99q-26 49 -54 70v1q-23 21 -97 21q-49 0 -84 -33t-35 -83z" />
+<glyph unicode="&#xf203;" d="M1432 484q0 173 -234 239q-35 10 -53 16.5t-38 25t-29 46.5q0 2 -2 8.5t-3 12t-1 7.5q0 36 24.5 59.5t60.5 23.5q54 0 71 -15h-1q20 -15 39 -51l93 71q-39 54 -49 64q-33 29 -67.5 39t-85.5 10q-80 0 -142 -57.5t-62 -137.5q0 -7 2 -23q16 -96 64.5 -140t148.5 -73 q29 -8 49 -15.5t45 -21.5t38.5 -34.5t13.5 -46.5v-5q1 -58 -40.5 -93t-100.5 -35q-97 0 -167 144q-23 47 -51.5 121.5t-48 125.5t-54 110.5t-74 95.5t-103.5 60.5t-147 24.5q-101 0 -192 -56t-144 -148t-50 -192v-1q4 -108 50.5 -199t133.5 -147.5t196 -56.5q186 0 279 110 q20 27 31 51l-60 109q-42 -80 -99 -116t-146 -36q-115 0 -191 87t-76 204q0 105 82 189t186 84q112 0 170 -53.5t104 -172.5q8 -21 25.5 -68.5t28.5 -76.5t31.5 -74.5t38.5 -74t45.5 -62.5t55.5 -53.5t66 -33t80 -13.5q107 0 183 69.5t76 174.5zM1536 1120v-960 q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf204;" horiz-adv-x="2048" d="M1152 640q0 104 -40.5 198.5t-109.5 163.5t-163.5 109.5t-198.5 40.5t-198.5 -40.5t-163.5 -109.5t-109.5 -163.5t-40.5 -198.5t40.5 -198.5t109.5 -163.5t163.5 -109.5t198.5 -40.5t198.5 40.5t163.5 109.5t109.5 163.5t40.5 198.5zM1920 640q0 104 -40.5 198.5 t-109.5 163.5t-163.5 109.5t-198.5 40.5h-386q119 -90 188.5 -224t69.5 -288t-69.5 -288t-188.5 -224h386q104 0 198.5 40.5t163.5 109.5t109.5 163.5t40.5 198.5zM2048 640q0 -130 -51 -248.5t-136.5 -204t-204 -136.5t-248.5 -51h-768q-130 0 -248.5 51t-204 136.5 t-136.5 204t-51 248.5t51 248.5t136.5 204t204 136.5t248.5 51h768q130 0 248.5 -51t204 -136.5t136.5 -204t51 -248.5z" />
+<glyph unicode="&#xf205;" horiz-adv-x="2048" d="M0 640q0 130 51 248.5t136.5 204t204 136.5t248.5 51h768q130 0 248.5 -51t204 -136.5t136.5 -204t51 -248.5t-51 -248.5t-136.5 -204t-204 -136.5t-248.5 -51h-768q-130 0 -248.5 51t-204 136.5t-136.5 204t-51 248.5zM1408 128q104 0 198.5 40.5t163.5 109.5 t109.5 163.5t40.5 198.5t-40.5 198.5t-109.5 163.5t-163.5 109.5t-198.5 40.5t-198.5 -40.5t-163.5 -109.5t-109.5 -163.5t-40.5 -198.5t40.5 -198.5t109.5 -163.5t163.5 -109.5t198.5 -40.5z" />
+<glyph unicode="&#xf206;" horiz-adv-x="2304" d="M762 384h-314q-40 0 -57.5 35t6.5 67l188 251q-65 31 -137 31q-132 0 -226 -94t-94 -226t94 -226t226 -94q115 0 203 72.5t111 183.5zM576 512h186q-18 85 -75 148zM1056 512l288 384h-480l-99 -132q105 -103 126 -252h165zM2176 448q0 132 -94 226t-226 94 q-60 0 -121 -24l174 -260q15 -23 10 -49t-27 -40q-15 -11 -36 -11q-35 0 -53 29l-174 260q-93 -95 -93 -225q0 -132 94 -226t226 -94t226 94t94 226zM2304 448q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 97 39.5 183.5t109.5 149.5l-65 98l-353 -469 q-18 -26 -51 -26h-197q-23 -164 -149 -274t-294 -110q-185 0 -316.5 131.5t-131.5 316.5t131.5 316.5t316.5 131.5q114 0 215 -55l137 183h-224q-26 0 -45 19t-19 45t19 45t45 19h384v-128h435l-85 128h-222q-26 0 -45 19t-19 45t19 45t45 19h256q33 0 53 -28l267 -400 q91 44 192 44q185 0 316.5 -131.5t131.5 -316.5z" />
+<glyph unicode="&#xf207;" d="M384 320q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1408 320q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1362 716l-72 384q-5 23 -22.5 37.5t-40.5 14.5 h-918q-23 0 -40.5 -14.5t-22.5 -37.5l-72 -384q-5 -30 14 -53t49 -23h1062q30 0 49 23t14 53zM1136 1328q0 20 -14 34t-34 14h-640q-20 0 -34 -14t-14 -34t14 -34t34 -14h640q20 0 34 14t14 34zM1536 603v-603h-128v-128q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5 t-37.5 90.5v128h-768v-128q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5v128h-128v603q0 112 25 223l103 454q9 78 97.5 137t230 89t312.5 30t312.5 -30t230 -89t97.5 -137l105 -454q23 -102 23 -223z" />
+<glyph unicode="&#xf208;" horiz-adv-x="2048" d="M1463 704q0 -35 -25 -60.5t-61 -25.5h-702q-36 0 -61 25.5t-25 60.5t25 60.5t61 25.5h702q36 0 61 -25.5t25 -60.5zM1677 704q0 86 -23 170h-982q-36 0 -61 25t-25 60q0 36 25 61t61 25h908q-88 143 -235 227t-320 84q-177 0 -327.5 -87.5t-238 -237.5t-87.5 -327 q0 -86 23 -170h982q36 0 61 -25t25 -60q0 -36 -25 -61t-61 -25h-908q88 -143 235.5 -227t320.5 -84q132 0 253 51.5t208 139t139 208t52 253.5zM2048 959q0 -35 -25 -60t-61 -25h-131q17 -85 17 -170q0 -167 -65.5 -319.5t-175.5 -263t-262.5 -176t-319.5 -65.5 q-246 0 -448.5 133t-301.5 350h-189q-36 0 -61 25t-25 61q0 35 25 60t61 25h132q-17 85 -17 170q0 167 65.5 319.5t175.5 263t262.5 176t320.5 65.5q245 0 447.5 -133t301.5 -350h188q36 0 61 -25t25 -61z" />
+<glyph unicode="&#xf209;" horiz-adv-x="1280" d="M953 1158l-114 -328l117 -21q165 451 165 518q0 56 -38 56q-57 0 -130 -225zM654 471l33 -88q37 42 71 67l-33 5.5t-38.5 7t-32.5 8.5zM362 1367q0 -98 159 -521q18 10 49 10q15 0 75 -5l-121 351q-75 220 -123 220q-19 0 -29 -17.5t-10 -37.5zM283 608q0 -36 51.5 -119 t117.5 -153t100 -70q14 0 25.5 13t11.5 27q0 24 -32 102q-13 32 -32 72t-47.5 89t-61.5 81t-62 32q-20 0 -45.5 -27t-25.5 -47zM125 273q0 -41 25 -104q59 -145 183.5 -227t281.5 -82q227 0 382 170q152 169 152 427q0 43 -1 67t-11.5 62t-30.5 56q-56 49 -211.5 75.5 t-270.5 26.5q-37 0 -49 -11q-12 -5 -12 -35q0 -34 21.5 -60t55.5 -40t77.5 -23.5t87.5 -11.5t85 -4t70 0h23q24 0 40 -19q15 -19 19 -55q-28 -28 -96 -54q-61 -22 -93 -46q-64 -46 -108.5 -114t-44.5 -137q0 -31 18.5 -88.5t18.5 -87.5l-3 -12q-4 -12 -4 -14 q-137 10 -146 216q-8 -2 -41 -2q2 -7 2 -21q0 -53 -40.5 -89.5t-94.5 -36.5q-82 0 -166.5 78t-84.5 159q0 34 33 67q52 -64 60 -76q77 -104 133 -104q12 0 26.5 8.5t14.5 20.5q0 34 -87.5 145t-116.5 111q-43 0 -70 -44.5t-27 -90.5zM11 264q0 101 42.5 163t136.5 88 q-28 74 -28 104q0 62 61 123t122 61q29 0 70 -15q-163 462 -163 567q0 80 41 130.5t119 50.5q131 0 325 -581q6 -17 8 -23q6 16 29 79.5t43.5 118.5t54 127.5t64.5 123t70.5 86.5t76.5 36q71 0 112 -49t41 -122q0 -108 -159 -550q61 -15 100.5 -46t58.5 -78t26 -93.5 t7 -110.5q0 -150 -47 -280t-132 -225t-211 -150t-278 -55q-111 0 -223 42q-149 57 -258 191.5t-109 286.5z" />
+<glyph unicode="&#xf20a;" horiz-adv-x="2048" d="M785 528h207q-14 -158 -98.5 -248.5t-214.5 -90.5q-162 0 -254.5 116t-92.5 316q0 194 93 311.5t233 117.5q148 0 232 -87t97 -247h-203q-5 64 -35.5 99t-81.5 35q-57 0 -88.5 -60.5t-31.5 -177.5q0 -48 5 -84t18 -69.5t40 -51.5t66 -18q95 0 109 139zM1497 528h206 q-14 -158 -98 -248.5t-214 -90.5q-162 0 -254.5 116t-92.5 316q0 194 93 311.5t233 117.5q148 0 232 -87t97 -247h-204q-4 64 -35 99t-81 35q-57 0 -88.5 -60.5t-31.5 -177.5q0 -48 5 -84t18 -69.5t39.5 -51.5t65.5 -18q49 0 76.5 38t33.5 101zM1856 647q0 207 -15.5 307 t-60.5 161q-6 8 -13.5 14t-21.5 15t-16 11q-86 63 -697 63q-625 0 -710 -63q-5 -4 -17.5 -11.5t-21 -14t-14.5 -14.5q-45 -60 -60 -159.5t-15 -308.5q0 -208 15 -307.5t60 -160.5q6 -8 15 -15t20.5 -14t17.5 -12q44 -33 239.5 -49t470.5 -16q610 0 697 65q5 4 17 11t20.5 14 t13.5 16q46 60 61 159t15 309zM2048 1408v-1536h-2048v1536h2048z" />
+<glyph unicode="&#xf20b;" d="M992 912v-496q0 -14 -9 -23t-23 -9h-160q-14 0 -23 9t-9 23v496q0 112 -80 192t-192 80h-272v-1152q0 -14 -9 -23t-23 -9h-160q-14 0 -23 9t-9 23v1344q0 14 9 23t23 9h464q135 0 249 -66.5t180.5 -180.5t66.5 -249zM1376 1376v-880q0 -135 -66.5 -249t-180.5 -180.5 t-249 -66.5h-464q-14 0 -23 9t-9 23v960q0 14 9 23t23 9h160q14 0 23 -9t9 -23v-768h272q112 0 192 80t80 192v880q0 14 9 23t23 9h160q14 0 23 -9t9 -23z" />
+<glyph unicode="&#xf20c;" d="M1311 694v-114q0 -24 -13.5 -38t-37.5 -14h-202q-24 0 -38 14t-14 38v114q0 24 14 38t38 14h202q24 0 37.5 -14t13.5 -38zM821 464v250q0 53 -32.5 85.5t-85.5 32.5h-133q-68 0 -96 -52q-28 52 -96 52h-130q-53 0 -85.5 -32.5t-32.5 -85.5v-250q0 -22 21 -22h55 q22 0 22 22v230q0 24 13.5 38t38.5 14h94q24 0 38 -14t14 -38v-230q0 -22 21 -22h54q22 0 22 22v230q0 24 14 38t38 14h97q24 0 37.5 -14t13.5 -38v-230q0 -22 22 -22h55q21 0 21 22zM1410 560v154q0 53 -33 85.5t-86 32.5h-264q-53 0 -86 -32.5t-33 -85.5v-410 q0 -21 22 -21h55q21 0 21 21v180q31 -42 94 -42h191q53 0 86 32.5t33 85.5zM1536 1176v-1072q0 -96 -68 -164t-164 -68h-1072q-96 0 -164 68t-68 164v1072q0 96 68 164t164 68h1072q96 0 164 -68t68 -164z" />
+<glyph unicode="&#xf20d;" d="M915 450h-294l147 551zM1001 128h311l-324 1024h-440l-324 -1024h311l383 314zM1536 1120v-960q0 -118 -85 -203t-203 -85h-960q-118 0 -203 85t-85 203v960q0 118 85 203t203 85h960q118 0 203 -85t85 -203z" />
+<glyph unicode="&#xf20e;" horiz-adv-x="2048" d="M2048 641q0 -21 -13 -36.5t-33 -19.5l-205 -356q3 -9 3 -18q0 -20 -12.5 -35.5t-32.5 -19.5l-193 -337q3 -8 3 -16q0 -23 -16.5 -40t-40.5 -17q-25 0 -41 18h-400q-17 -20 -43 -20t-43 20h-399q-17 -20 -43 -20q-23 0 -40 16.5t-17 40.5q0 8 4 20l-193 335 q-20 4 -32.5 19.5t-12.5 35.5q0 9 3 18l-206 356q-20 5 -32.5 20.5t-12.5 35.5q0 21 13.5 36.5t33.5 19.5l199 344q0 1 -0.5 3t-0.5 3q0 36 34 51l209 363q-4 10 -4 18q0 24 17 40.5t40 16.5q26 0 44 -21h396q16 21 43 21t43 -21h398q18 21 44 21q23 0 40 -16.5t17 -40.5 q0 -6 -4 -18l207 -358q23 -1 39 -17.5t16 -38.5q0 -13 -7 -27l187 -324q19 -4 31.5 -19.5t12.5 -35.5zM1063 -158h389l-342 354h-143l-342 -354h360q18 16 39 16t39 -16zM112 654q1 -4 1 -13q0 -10 -2 -15l208 -360q2 0 4.5 -1t5.5 -2.5l5 -2.5l188 199v347l-187 194 q-13 -8 -29 -10zM986 1438h-388l190 -200l554 200h-280q-16 -16 -38 -16t-38 16zM1689 226q1 6 5 11l-64 68l-17 -79h76zM1583 226l22 105l-252 266l-296 -307l63 -64h463zM1495 -142l16 28l65 310h-427l333 -343q8 4 13 5zM578 -158h5l342 354h-373v-335l4 -6q14 -5 22 -13 zM552 226h402l64 66l-309 321l-157 -166v-221zM359 226h163v189l-168 -177q4 -8 5 -12zM358 1051q0 -1 0.5 -2t0.5 -2q0 -16 -8 -29l171 -177v269zM552 1121v-311l153 -157l297 314l-223 236zM556 1425l-4 -8v-264l205 74l-191 201q-6 -2 -10 -3zM1447 1438h-16l-621 -224 l213 -225zM1023 946l-297 -315l311 -319l296 307zM688 634l-136 141v-284zM1038 270l-42 -44h85zM1374 618l238 -251l132 624l-3 5l-1 1zM1718 1018q-8 13 -8 29v2l-216 376q-5 1 -13 5l-437 -463l310 -327zM522 1142v223l-163 -282zM522 196h-163l163 -283v283zM1607 196 l-48 -227l130 227h-82zM1729 266l207 361q-2 10 -2 14q0 1 3 16l-171 296l-129 -612l77 -82q5 3 15 7z" />
+<glyph unicode="&#xf210;" d="M0 856q0 131 91.5 226.5t222.5 95.5h742l352 358v-1470q0 -132 -91.5 -227t-222.5 -95h-780q-131 0 -222.5 95t-91.5 227v790zM1232 102l-176 180v425q0 46 -32 79t-78 33h-484q-46 0 -78 -33t-32 -79v-492q0 -46 32.5 -79.5t77.5 -33.5h770z" />
+<glyph unicode="&#xf211;" d="M934 1386q-317 -121 -556 -362.5t-358 -560.5q-20 89 -20 176q0 208 102.5 384.5t278.5 279t384 102.5q82 0 169 -19zM1203 1267q93 -65 164 -155q-389 -113 -674.5 -400.5t-396.5 -676.5q-93 72 -155 162q112 386 395 671t667 399zM470 -67q115 356 379.5 622t619.5 384 q40 -92 54 -195q-292 -120 -516 -345t-343 -518q-103 14 -194 52zM1536 -125q-193 50 -367 115q-135 -84 -290 -107q109 205 274 370.5t369 275.5q-21 -152 -101 -284q65 -175 115 -370z" />
+<glyph unicode="&#xf212;" horiz-adv-x="2048" d="M1893 1144l155 -1272q-131 0 -257 57q-200 91 -393 91q-226 0 -374 -148q-148 148 -374 148q-193 0 -393 -91q-128 -57 -252 -57h-5l155 1272q224 127 482 127q233 0 387 -106q154 106 387 106q258 0 482 -127zM1398 157q129 0 232 -28.5t260 -93.5l-124 1021 q-171 78 -368 78q-224 0 -374 -141q-150 141 -374 141q-197 0 -368 -78l-124 -1021q105 43 165.5 65t148.5 39.5t178 17.5q202 0 374 -108q172 108 374 108zM1438 191l-55 907q-211 -4 -359 -155q-152 155 -374 155q-176 0 -336 -66l-114 -941q124 51 228.5 76t221.5 25 q209 0 374 -102q172 107 374 102z" />
+<glyph unicode="&#xf213;" horiz-adv-x="2048" d="M1500 165v733q0 21 -15 36t-35 15h-93q-20 0 -35 -15t-15 -36v-733q0 -20 15 -35t35 -15h93q20 0 35 15t15 35zM1216 165v531q0 20 -15 35t-35 15h-101q-20 0 -35 -15t-15 -35v-531q0 -20 15 -35t35 -15h101q20 0 35 15t15 35zM924 165v429q0 20 -15 35t-35 15h-101 q-20 0 -35 -15t-15 -35v-429q0 -20 15 -35t35 -15h101q20 0 35 15t15 35zM632 165v362q0 20 -15 35t-35 15h-101q-20 0 -35 -15t-15 -35v-362q0 -20 15 -35t35 -15h101q20 0 35 15t15 35zM2048 311q0 -166 -118 -284t-284 -118h-1244q-166 0 -284 118t-118 284 q0 116 63 214.5t168 148.5q-10 34 -10 73q0 113 80.5 193.5t193.5 80.5q102 0 180 -67q45 183 194 300t338 117q149 0 275 -73.5t199.5 -199.5t73.5 -275q0 -66 -14 -122q135 -33 221 -142.5t86 -247.5z" />
+<glyph unicode="&#xf214;" d="M0 1536h1536v-1392l-776 -338l-760 338v1392zM1436 209v926h-1336v-926l661 -294zM1436 1235v201h-1336v-201h1336zM181 937v-115h-37v115h37zM181 789v-115h-37v115h37zM181 641v-115h-37v115h37zM181 493v-115h-37v115h37zM181 345v-115h-37v115h37zM207 202l15 34 l105 -47l-15 -33zM343 142l15 34l105 -46l-15 -34zM478 82l15 34l105 -46l-15 -34zM614 23l15 33l104 -46l-15 -34zM797 10l105 46l15 -33l-105 -47zM932 70l105 46l15 -34l-105 -46zM1068 130l105 46l15 -34l-105 -46zM1203 189l105 47l15 -34l-105 -46zM259 1389v-36h-114 v36h114zM421 1389v-36h-115v36h115zM583 1389v-36h-115v36h115zM744 1389v-36h-114v36h114zM906 1389v-36h-114v36h114zM1068 1389v-36h-115v36h115zM1230 1389v-36h-115v36h115zM1391 1389v-36h-114v36h114zM181 1049v-79h-37v115h115v-36h-78zM421 1085v-36h-115v36h115z M583 1085v-36h-115v36h115zM744 1085v-36h-114v36h114zM906 1085v-36h-114v36h114zM1068 1085v-36h-115v36h115zM1230 1085v-36h-115v36h115zM1355 970v79h-78v36h115v-115h-37zM1355 822v115h37v-115h-37zM1355 674v115h37v-115h-37zM1355 526v115h37v-115h-37zM1355 378 v115h37v-115h-37zM1355 230v115h37v-115h-37zM760 265q-129 0 -221 91.5t-92 221.5q0 129 92 221t221 92q130 0 221.5 -92t91.5 -221q0 -130 -91.5 -221.5t-221.5 -91.5zM595 646q0 -36 19.5 -56.5t49.5 -25t64 -7t64 -2t49.5 -9t19.5 -30.5q0 -49 -112 -49q-97 0 -123 51 h-3l-31 -63q67 -42 162 -42q29 0 56.5 5t55.5 16t45.5 33t17.5 53q0 46 -27.5 69.5t-67.5 27t-79.5 3t-67 5t-27.5 25.5q0 21 20.5 33t40.5 15t41 3q34 0 70.5 -11t51.5 -34h3l30 58q-3 1 -21 8.5t-22.5 9t-19.5 7t-22 7t-20 4.5t-24 4t-23 1q-29 0 -56.5 -5t-54 -16.5 t-43 -34t-16.5 -53.5z" />
+<glyph unicode="&#xf215;" horiz-adv-x="2048" d="M863 504q0 112 -79.5 191.5t-191.5 79.5t-191 -79.5t-79 -191.5t79 -191t191 -79t191.5 79t79.5 191zM1726 505q0 112 -79 191t-191 79t-191.5 -79t-79.5 -191q0 -113 79.5 -192t191.5 -79t191 79.5t79 191.5zM2048 1314v-1348q0 -44 -31.5 -75.5t-76.5 -31.5h-1832 q-45 0 -76.5 31.5t-31.5 75.5v1348q0 44 31.5 75.5t76.5 31.5h431q44 0 76 -31.5t32 -75.5v-161h754v161q0 44 32 75.5t76 31.5h431q45 0 76.5 -31.5t31.5 -75.5z" />
+<glyph unicode="&#xf216;" horiz-adv-x="2048" d="M1430 953zM1690 749q148 0 253 -98.5t105 -244.5q0 -157 -109 -261.5t-267 -104.5q-85 0 -162 27.5t-138 73.5t-118 106t-109 126.5t-103.5 132.5t-108.5 126t-117 106t-136 73.5t-159 27.5q-154 0 -251.5 -91.5t-97.5 -244.5q0 -157 104 -250t263 -93q100 0 208 37.5 t193 98.5q5 4 21 18.5t30 24t22 9.5q14 0 24.5 -10.5t10.5 -24.5q0 -24 -60 -77q-101 -88 -234.5 -142t-260.5 -54q-133 0 -245.5 58t-180 165t-67.5 241q0 205 141.5 341t347.5 136q120 0 226.5 -43.5t185.5 -113t151.5 -153t139 -167.5t133.5 -153.5t149.5 -113 t172.5 -43.5q102 0 168.5 61.5t66.5 162.5q0 95 -64.5 159t-159.5 64q-30 0 -81.5 -18.5t-68.5 -18.5q-20 0 -35.5 15t-15.5 35q0 18 8.5 57t8.5 59q0 159 -107.5 263t-266.5 104q-58 0 -111.5 -18.5t-84 -40.5t-55.5 -40.5t-33 -18.5q-15 0 -25.5 10.5t-10.5 25.5 q0 19 25 46q59 67 147 103.5t182 36.5q191 0 318 -125.5t127 -315.5q0 -37 -4 -66q57 15 115 15z" />
+<glyph unicode="&#xf217;" horiz-adv-x="1664" d="M1216 832q0 26 -19 45t-45 19h-128v128q0 26 -19 45t-45 19t-45 -19t-19 -45v-128h-128q-26 0 -45 -19t-19 -45t19 -45t45 -19h128v-128q0 -26 19 -45t45 -19t45 19t19 45v128h128q26 0 45 19t19 45zM640 0q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5 t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1536 0q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1664 1088v-512q0 -24 -16 -42.5t-41 -21.5l-1044 -122q1 -7 4.5 -21.5t6 -26.5t2.5 -22q0 -16 -24 -64h920 q26 0 45 -19t19 -45t-19 -45t-45 -19h-1024q-26 0 -45 19t-19 45q0 14 11 39.5t29.5 59.5t20.5 38l-177 823h-204q-26 0 -45 19t-19 45t19 45t45 19h256q16 0 28.5 -6.5t20 -15.5t13 -24.5t7.5 -26.5t5.5 -29.5t4.5 -25.5h1201q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf218;" horiz-adv-x="1664" d="M1280 832q0 26 -19 45t-45 19t-45 -19l-147 -146v293q0 26 -19 45t-45 19t-45 -19t-19 -45v-293l-147 146q-19 19 -45 19t-45 -19t-19 -45t19 -45l256 -256q19 -19 45 -19t45 19l256 256q19 19 19 45zM640 0q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5 t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1536 0q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1664 1088v-512q0 -24 -16 -42.5t-41 -21.5l-1044 -122q1 -7 4.5 -21.5t6 -26.5t2.5 -22q0 -16 -24 -64h920 q26 0 45 -19t19 -45t-19 -45t-45 -19h-1024q-26 0 -45 19t-19 45q0 14 11 39.5t29.5 59.5t20.5 38l-177 823h-204q-26 0 -45 19t-19 45t19 45t45 19h256q16 0 28.5 -6.5t20 -15.5t13 -24.5t7.5 -26.5t5.5 -29.5t4.5 -25.5h1201q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf219;" horiz-adv-x="2048" d="M212 768l623 -665l-300 665h-323zM1024 -4l349 772h-698zM538 896l204 384h-262l-288 -384h346zM1213 103l623 665h-323zM683 896h682l-204 384h-274zM1510 896h346l-288 384h-262zM1651 1382l384 -512q14 -18 13 -41.5t-17 -40.5l-960 -1024q-18 -20 -47 -20t-47 20 l-960 1024q-16 17 -17 40.5t13 41.5l384 512q18 26 51 26h1152q33 0 51 -26z" />
+<glyph unicode="&#xf21a;" horiz-adv-x="2048" d="M1811 -19q19 19 45 19t45 -19l128 -128l-90 -90l-83 83l-83 -83q-18 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83 q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-128 128l90 90l83 -83l83 83q19 19 45 19t45 -19l83 -83l83 83q19 19 45 19t45 -19l83 -83l83 83q19 19 45 19t45 -19l83 -83l83 83q19 19 45 19t45 -19l83 -83l83 83q19 19 45 19t45 -19l83 -83l83 83 q19 19 45 19t45 -19l83 -83zM237 19q-19 -19 -45 -19t-45 19l-128 128l90 90l83 -82l83 82q19 19 45 19t45 -19l83 -82l64 64v293l-210 314q-17 26 -7 56.5t40 40.5l177 58v299h128v128h256v128h256v-128h256v-128h128v-299l177 -58q30 -10 40 -40.5t-7 -56.5l-210 -314 v-293l19 18q19 19 45 19t45 -19l83 -82l83 82q19 19 45 19t45 -19l128 -128l-90 -90l-83 83l-83 -83q-18 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83 q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83zM640 1152v-128l384 128l384 -128v128h-128v128h-512v-128h-128z" />
+<glyph unicode="&#xf21b;" d="M576 0l96 448l-96 128l-128 64zM832 0l128 640l-128 -64l-96 -128zM992 1010q-2 4 -4 6q-10 8 -96 8q-70 0 -167 -19q-7 -2 -21 -2t-21 2q-97 19 -167 19q-86 0 -96 -8q-2 -2 -4 -6q2 -18 4 -27q2 -3 7.5 -6.5t7.5 -10.5q2 -4 7.5 -20.5t7 -20.5t7.5 -17t8.5 -17t9 -14 t12 -13.5t14 -9.5t17.5 -8t20.5 -4t24.5 -2q36 0 59 12.5t32.5 30t14.5 34.5t11.5 29.5t17.5 12.5h12q11 0 17.5 -12.5t11.5 -29.5t14.5 -34.5t32.5 -30t59 -12.5q13 0 24.5 2t20.5 4t17.5 8t14 9.5t12 13.5t9 14t8.5 17t7.5 17t7 20.5t7.5 20.5q2 7 7.5 10.5t7.5 6.5 q2 9 4 27zM1408 131q0 -121 -73 -190t-194 -69h-874q-121 0 -194 69t-73 190q0 61 4.5 118t19 125.5t37.5 123.5t63.5 103.5t93.5 74.5l-90 220h214q-22 64 -22 128q0 12 2 32q-194 40 -194 96q0 57 210 99q17 62 51.5 134t70.5 114q32 37 76 37q30 0 84 -31t84 -31t84 31 t84 31q44 0 76 -37q36 -42 70.5 -114t51.5 -134q210 -42 210 -99q0 -56 -194 -96q7 -81 -20 -160h214l-82 -225q63 -33 107.5 -96.5t65.5 -143.5t29 -151.5t8 -148.5z" />
+<glyph unicode="&#xf21c;" horiz-adv-x="2304" d="M2301 500q12 -103 -22 -198.5t-99 -163.5t-158.5 -106t-196.5 -31q-161 11 -279.5 125t-134.5 274q-12 111 27.5 210.5t118.5 170.5l-71 107q-96 -80 -151 -194t-55 -244q0 -27 -18.5 -46.5t-45.5 -19.5h-256h-69q-23 -164 -149 -274t-294 -110q-185 0 -316.5 131.5 t-131.5 316.5t131.5 316.5t316.5 131.5q76 0 152 -27l24 45q-123 110 -304 110h-64q-26 0 -45 19t-19 45t19 45t45 19h128q78 0 145 -13.5t116.5 -38.5t71.5 -39.5t51 -36.5h512h115l-85 128h-222q-30 0 -49 22.5t-14 52.5q4 23 23 38t43 15h253q33 0 53 -28l70 -105 l114 114q19 19 46 19h101q26 0 45 -19t19 -45v-128q0 -26 -19 -45t-45 -19h-179l115 -172q131 63 275 36q143 -26 244 -134.5t118 -253.5zM448 128q115 0 203 72.5t111 183.5h-314q-35 0 -55 31q-18 32 -1 63l147 277q-47 13 -91 13q-132 0 -226 -94t-94 -226t94 -226 t226 -94zM1856 128q132 0 226 94t94 226t-94 226t-226 94q-60 0 -121 -24l174 -260q15 -23 10 -49t-27 -40q-15 -11 -36 -11q-35 0 -53 29l-174 260q-93 -95 -93 -225q0 -132 94 -226t226 -94z" />
+<glyph unicode="&#xf21d;" d="M1408 0q0 -63 -61.5 -113.5t-164 -81t-225 -46t-253.5 -15.5t-253.5 15.5t-225 46t-164 81t-61.5 113.5q0 49 33 88.5t91 66.5t118 44.5t131 29.5q26 5 48 -10.5t26 -41.5q5 -26 -10.5 -48t-41.5 -26q-58 -10 -106 -23.5t-76.5 -25.5t-48.5 -23.5t-27.5 -19.5t-8.5 -12 q3 -11 27 -26.5t73 -33t114 -32.5t160.5 -25t201.5 -10t201.5 10t160.5 25t114 33t73 33.5t27 27.5q-1 4 -8.5 11t-27.5 19t-48.5 23.5t-76.5 25t-106 23.5q-26 4 -41.5 26t-10.5 48q4 26 26 41.5t48 10.5q71 -12 131 -29.5t118 -44.5t91 -66.5t33 -88.5zM1024 896v-384 q0 -26 -19 -45t-45 -19h-64v-384q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v384h-64q-26 0 -45 19t-19 45v384q0 53 37.5 90.5t90.5 37.5h384q53 0 90.5 -37.5t37.5 -90.5zM928 1280q0 -93 -65.5 -158.5t-158.5 -65.5t-158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5 t158.5 -65.5t65.5 -158.5z" />
+<glyph unicode="&#xf21e;" horiz-adv-x="1792" d="M1280 512h305q-5 -6 -10 -10.5t-9 -7.5l-3 -4l-623 -600q-18 -18 -44 -18t-44 18l-624 602q-5 2 -21 20h369q22 0 39.5 13.5t22.5 34.5l70 281l190 -667q6 -20 23 -33t39 -13q21 0 38 13t23 33l146 485l56 -112q18 -35 57 -35zM1792 940q0 -145 -103 -300h-369l-111 221 q-8 17 -25.5 27t-36.5 8q-45 -5 -56 -46l-129 -430l-196 686q-6 20 -23.5 33t-39.5 13t-39 -13.5t-22 -34.5l-116 -464h-423q-103 155 -103 300q0 220 127 344t351 124q62 0 126.5 -21.5t120 -58t95.5 -68.5t76 -68q36 36 76 68t95.5 68.5t120 58t126.5 21.5q224 0 351 -124 t127 -344z" />
+<glyph unicode="&#xf221;" horiz-adv-x="1280" d="M1152 960q0 -221 -147.5 -384.5t-364.5 -187.5v-260h224q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-224v-224q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v224h-224q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h224v260q-150 16 -271.5 103t-186 224t-52.5 292 q11 134 80.5 249t182 188t245.5 88q170 19 319 -54t236 -212t87 -306zM128 960q0 -185 131.5 -316.5t316.5 -131.5t316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5z" />
+<glyph unicode="&#xf222;" d="M1472 1408q26 0 45 -19t19 -45v-416q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v262l-382 -383q126 -156 126 -359q0 -117 -45.5 -223.5t-123 -184t-184 -123t-223.5 -45.5t-223.5 45.5t-184 123t-123 184t-45.5 223.5t45.5 223.5t123 184t184 123t223.5 45.5 q203 0 359 -126l382 382h-261q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h416zM576 0q185 0 316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
+<glyph unicode="&#xf223;" horiz-adv-x="1280" d="M830 1220q145 -72 233.5 -210.5t88.5 -305.5q0 -221 -147.5 -384.5t-364.5 -187.5v-132h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96v-96q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v96h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96v132q-217 24 -364.5 187.5 t-147.5 384.5q0 167 88.5 305.5t233.5 210.5q-165 96 -228 273q-6 16 3.5 29.5t26.5 13.5h69q21 0 29 -20q44 -106 140 -171t214 -65t214 65t140 171q8 20 37 20h61q17 0 26.5 -13.5t3.5 -29.5q-63 -177 -228 -273zM576 256q185 0 316.5 131.5t131.5 316.5t-131.5 316.5 t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
+<glyph unicode="&#xf224;" d="M1024 1504q0 14 9 23t23 9h288q26 0 45 -19t19 -45v-288q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v134l-254 -255q126 -158 126 -359q0 -221 -147.5 -384.5t-364.5 -187.5v-132h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96v-96q0 -14 -9 -23t-23 -9h-64 q-14 0 -23 9t-9 23v96h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96v132q-149 16 -270.5 103t-186.5 223.5t-53 291.5q16 204 160 353.5t347 172.5q118 14 228 -19t198 -103l255 254h-134q-14 0 -23 9t-9 23v64zM576 256q185 0 316.5 131.5t131.5 316.5t-131.5 316.5 t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
+<glyph unicode="&#xf225;" horiz-adv-x="1792" d="M1280 1504q0 14 9 23t23 9h288q26 0 45 -19t19 -45v-288q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v134l-254 -255q126 -158 126 -359q0 -221 -147.5 -384.5t-364.5 -187.5v-132h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96v-96q0 -14 -9 -23t-23 -9h-64 q-14 0 -23 9t-9 23v96h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96v132q-217 24 -364.5 187.5t-147.5 384.5q0 201 126 359l-52 53l-101 -111q-9 -10 -22 -10.5t-23 7.5l-48 44q-10 8 -10.5 21.5t8.5 23.5l105 115l-111 112v-134q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9 t-9 23v288q0 26 19 45t45 19h288q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-133l106 -107l86 94q9 10 22 10.5t23 -7.5l48 -44q10 -8 10.5 -21.5t-8.5 -23.5l-90 -99l57 -56q158 126 359 126t359 -126l255 254h-134q-14 0 -23 9t-9 23v64zM832 256q185 0 316.5 131.5 t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
+<glyph unicode="&#xf226;" horiz-adv-x="1792" d="M1790 1007q12 -155 -52.5 -292t-186 -224t-271.5 -103v-260h224q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-224v-224q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v224h-512v-224q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v224h-224q-14 0 -23 9t-9 23v64q0 14 9 23 t23 9h224v260q-150 16 -271.5 103t-186 224t-52.5 292q17 206 164.5 356.5t352.5 169.5q206 21 377 -94q171 115 377 94q205 -19 352.5 -169.5t164.5 -356.5zM896 647q128 131 128 313t-128 313q-128 -131 -128 -313t128 -313zM576 512q115 0 218 57q-154 165 -154 391 q0 224 154 391q-103 57 -218 57q-185 0 -316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5zM1152 128v260q-137 15 -256 94q-119 -79 -256 -94v-260h512zM1216 512q185 0 316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5q-115 0 -218 -57q154 -167 154 -391 q0 -226 -154 -391q103 -57 218 -57z" />
+<glyph unicode="&#xf227;" horiz-adv-x="1920" d="M1536 1120q0 14 9 23t23 9h288q26 0 45 -19t19 -45v-288q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v134l-254 -255q76 -95 107.5 -214t9.5 -247q-31 -182 -166 -312t-318 -156q-210 -29 -384.5 80t-241.5 300q-117 6 -221 57.5t-177.5 133t-113.5 192.5t-32 230 q9 135 78 252t182 191.5t248 89.5q118 14 227.5 -19t198.5 -103l255 254h-134q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h288q26 0 45 -19t19 -45v-288q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v134l-254 -255q59 -74 93 -169q182 -9 328 -124l255 254h-134q-14 0 -23 9 t-9 23v64zM1024 704q0 20 -4 58q-162 -25 -271 -150t-109 -292q0 -20 4 -58q162 25 271 150t109 292zM128 704q0 -168 111 -294t276 -149q-3 29 -3 59q0 210 135 369.5t338 196.5q-53 120 -163.5 193t-245.5 73q-185 0 -316.5 -131.5t-131.5 -316.5zM1088 -128 q185 0 316.5 131.5t131.5 316.5q0 168 -111 294t-276 149q3 -29 3 -59q0 -210 -135 -369.5t-338 -196.5q53 -120 163.5 -193t245.5 -73z" />
+<glyph unicode="&#xf228;" horiz-adv-x="2048" d="M1664 1504q0 14 9 23t23 9h288q26 0 45 -19t19 -45v-288q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v134l-254 -255q76 -95 107.5 -214t9.5 -247q-32 -180 -164.5 -310t-313.5 -157q-223 -34 -409 90q-117 -78 -256 -93v-132h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23 t-23 -9h-96v-96q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v96h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96v132q-155 17 -279.5 109.5t-187 237.5t-39.5 307q25 187 159.5 322.5t320.5 164.5q224 34 410 -90q146 97 320 97q201 0 359 -126l255 254h-134q-14 0 -23 9 t-9 23v64zM896 391q128 131 128 313t-128 313q-128 -131 -128 -313t128 -313zM128 704q0 -185 131.5 -316.5t316.5 -131.5q117 0 218 57q-154 167 -154 391t154 391q-101 57 -218 57q-185 0 -316.5 -131.5t-131.5 -316.5zM1216 256q185 0 316.5 131.5t131.5 316.5 t-131.5 316.5t-316.5 131.5q-117 0 -218 -57q154 -167 154 -391t-154 -391q101 -57 218 -57z" />
+<glyph unicode="&#xf229;" d="M1472 1408q26 0 45 -19t19 -45v-416q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v262l-213 -214l140 -140q9 -10 9 -23t-9 -22l-46 -46q-9 -9 -22 -9t-23 9l-140 141l-78 -79q126 -156 126 -359q0 -117 -45.5 -223.5t-123 -184t-184 -123t-223.5 -45.5t-223.5 45.5 t-184 123t-123 184t-45.5 223.5t45.5 223.5t123 184t184 123t223.5 45.5q203 0 359 -126l78 78l-172 172q-9 10 -9 23t9 22l46 46q9 9 22 9t23 -9l172 -172l213 213h-261q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h416zM576 0q185 0 316.5 131.5t131.5 316.5t-131.5 316.5 t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
+<glyph unicode="&#xf22a;" horiz-adv-x="1280" d="M640 892q217 -24 364.5 -187.5t147.5 -384.5q0 -167 -87 -306t-236 -212t-319 -54q-133 15 -245.5 88t-182 188t-80.5 249q-12 155 52.5 292t186 224t271.5 103v132h-160q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h160v165l-92 -92q-10 -9 -23 -9t-22 9l-46 46q-9 9 -9 22 t9 23l202 201q19 19 45 19t45 -19l202 -201q9 -10 9 -23t-9 -22l-46 -46q-9 -9 -22 -9t-23 9l-92 92v-165h160q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-160v-132zM576 -128q185 0 316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5 t131.5 -316.5t316.5 -131.5z" />
+<glyph unicode="&#xf22b;" horiz-adv-x="2048" d="M1901 621q19 -19 19 -45t-19 -45l-294 -294q-9 -10 -22.5 -10t-22.5 10l-45 45q-10 9 -10 22.5t10 22.5l185 185h-294v-224q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v224h-132q-24 -217 -187.5 -364.5t-384.5 -147.5q-167 0 -306 87t-212 236t-54 319q15 133 88 245.5 t188 182t249 80.5q155 12 292 -52.5t224 -186t103 -271.5h132v224q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-224h294l-185 185q-10 9 -10 22.5t10 22.5l45 45q9 10 22.5 10t22.5 -10zM576 128q185 0 316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5 t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
+<glyph unicode="&#xf22c;" horiz-adv-x="1280" d="M1152 960q0 -221 -147.5 -384.5t-364.5 -187.5v-612q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v612q-217 24 -364.5 187.5t-147.5 384.5q0 117 45.5 223.5t123 184t184 123t223.5 45.5t223.5 -45.5t184 -123t123 -184t45.5 -223.5zM576 512q185 0 316.5 131.5 t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
+<glyph unicode="&#xf22d;" horiz-adv-x="1280" d="M1024 576q0 185 -131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5t316.5 131.5t131.5 316.5zM1152 576q0 -117 -45.5 -223.5t-123 -184t-184 -123t-223.5 -45.5t-223.5 45.5t-184 123t-123 184t-45.5 223.5t45.5 223.5t123 184t184 123 t223.5 45.5t223.5 -45.5t184 -123t123 -184t45.5 -223.5z" />
+<glyph unicode="&#xf22e;" horiz-adv-x="1792" />
+<glyph unicode="&#xf22f;" horiz-adv-x="1792" />
+<glyph unicode="&#xf230;" d="M1451 1408q35 0 60 -25t25 -60v-1366q0 -35 -25 -60t-60 -25h-391v595h199l30 232h-229v148q0 56 23.5 84t91.5 28l122 1v207q-63 9 -178 9q-136 0 -217.5 -80t-81.5 -226v-171h-200v-232h200v-595h-735q-35 0 -60 25t-25 60v1366q0 35 25 60t60 25h1366z" />
+<glyph unicode="&#xf231;" horiz-adv-x="1280" d="M0 939q0 108 37.5 203.5t103.5 166.5t152 123t185 78t202 26q158 0 294 -66.5t221 -193.5t85 -287q0 -96 -19 -188t-60 -177t-100 -149.5t-145 -103t-189 -38.5q-68 0 -135 32t-96 88q-10 -39 -28 -112.5t-23.5 -95t-20.5 -71t-26 -71t-32 -62.5t-46 -77.5t-62 -86.5 l-14 -5l-9 10q-15 157 -15 188q0 92 21.5 206.5t66.5 287.5t52 203q-32 65 -32 169q0 83 52 156t132 73q61 0 95 -40.5t34 -102.5q0 -66 -44 -191t-44 -187q0 -63 45 -104.5t109 -41.5q55 0 102 25t78.5 68t56 95t38 110.5t20 111t6.5 99.5q0 173 -109.5 269.5t-285.5 96.5 q-200 0 -334 -129.5t-134 -328.5q0 -44 12.5 -85t27 -65t27 -45.5t12.5 -30.5q0 -28 -15 -73t-37 -45q-2 0 -17 3q-51 15 -90.5 56t-61 94.5t-32.5 108t-11 106.5z" />
+<glyph unicode="&#xf232;" d="M985 562q13 0 97.5 -44t89.5 -53q2 -5 2 -15q0 -33 -17 -76q-16 -39 -71 -65.5t-102 -26.5q-57 0 -190 62q-98 45 -170 118t-148 185q-72 107 -71 194v8q3 91 74 158q24 22 52 22q6 0 18 -1.5t19 -1.5q19 0 26.5 -6.5t15.5 -27.5q8 -20 33 -88t25 -75q0 -21 -34.5 -57.5 t-34.5 -46.5q0 -7 5 -15q34 -73 102 -137q56 -53 151 -101q12 -7 22 -7q15 0 54 48.5t52 48.5zM782 32q127 0 243.5 50t200.5 134t134 200.5t50 243.5t-50 243.5t-134 200.5t-200.5 134t-243.5 50t-243.5 -50t-200.5 -134t-134 -200.5t-50 -243.5q0 -203 120 -368l-79 -233 l242 77q158 -104 345 -104zM782 1414q153 0 292.5 -60t240.5 -161t161 -240.5t60 -292.5t-60 -292.5t-161 -240.5t-240.5 -161t-292.5 -60q-195 0 -365 94l-417 -134l136 405q-108 178 -108 389q0 153 60 292.5t161 240.5t240.5 161t292.5 60z" />
+<glyph unicode="&#xf233;" horiz-adv-x="1792" d="M128 128h1024v128h-1024v-128zM128 640h1024v128h-1024v-128zM1696 192q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM128 1152h1024v128h-1024v-128zM1696 704q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM1696 1216 q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM1792 384v-384h-1792v384h1792zM1792 896v-384h-1792v384h1792zM1792 1408v-384h-1792v384h1792z" />
+<glyph unicode="&#xf234;" horiz-adv-x="2048" d="M704 640q-159 0 -271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5t271.5 -112.5t112.5 -271.5t-112.5 -271.5t-271.5 -112.5zM1664 512h352q13 0 22.5 -9.5t9.5 -22.5v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-352v-352q0 -13 -9.5 -22.5t-22.5 -9.5h-192q-13 0 -22.5 9.5 t-9.5 22.5v352h-352q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h352v352q0 13 9.5 22.5t22.5 9.5h192q13 0 22.5 -9.5t9.5 -22.5v-352zM928 288q0 -52 38 -90t90 -38h256v-238q-68 -50 -171 -50h-874q-121 0 -194 69t-73 190q0 53 3.5 103.5t14 109t26.5 108.5 t43 97.5t62 81t85.5 53.5t111.5 20q19 0 39 -17q79 -61 154.5 -91.5t164.5 -30.5t164.5 30.5t154.5 91.5q20 17 39 17q132 0 217 -96h-223q-52 0 -90 -38t-38 -90v-192z" />
+<glyph unicode="&#xf235;" horiz-adv-x="2048" d="M704 640q-159 0 -271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5t271.5 -112.5t112.5 -271.5t-112.5 -271.5t-271.5 -112.5zM1781 320l249 -249q9 -9 9 -23q0 -13 -9 -22l-136 -136q-9 -9 -22 -9q-14 0 -23 9l-249 249l-249 -249q-9 -9 -23 -9q-13 0 -22 9l-136 136 q-9 9 -9 22q0 14 9 23l249 249l-249 249q-9 9 -9 23q0 13 9 22l136 136q9 9 22 9q14 0 23 -9l249 -249l249 249q9 9 23 9q13 0 22 -9l136 -136q9 -9 9 -22q0 -14 -9 -23zM1283 320l-181 -181q-37 -37 -37 -91q0 -53 37 -90l83 -83q-21 -3 -44 -3h-874q-121 0 -194 69 t-73 190q0 53 3.5 103.5t14 109t26.5 108.5t43 97.5t62 81t85.5 53.5t111.5 20q19 0 39 -17q154 -122 319 -122t319 122q20 17 39 17q28 0 57 -6q-28 -27 -41 -50t-13 -56q0 -54 37 -91z" />
+<glyph unicode="&#xf236;" horiz-adv-x="2048" d="M256 512h1728q26 0 45 -19t19 -45v-448h-256v256h-1536v-256h-256v1216q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-704zM832 832q0 106 -75 181t-181 75t-181 -75t-75 -181t75 -181t181 -75t181 75t75 181zM2048 576v64q0 159 -112.5 271.5t-271.5 112.5h-704 q-26 0 -45 -19t-19 -45v-384h1152z" />
+<glyph unicode="&#xf237;" d="M1536 1536l-192 -448h192v-192h-274l-55 -128h329v-192h-411l-357 -832l-357 832h-411v192h329l-55 128h-274v192h192l-192 448h256l323 -768h378l323 768h256zM768 320l108 256h-216z" />
+<glyph unicode="&#xf238;" d="M1088 1536q185 0 316.5 -93.5t131.5 -226.5v-896q0 -130 -125.5 -222t-305.5 -97l213 -202q16 -15 8 -35t-30 -20h-1056q-22 0 -30 20t8 35l213 202q-180 5 -305.5 97t-125.5 222v896q0 133 131.5 226.5t316.5 93.5h640zM768 192q80 0 136 56t56 136t-56 136t-136 56 t-136 -56t-56 -136t56 -136t136 -56zM1344 768v512h-1152v-512h1152z" />
+<glyph unicode="&#xf239;" d="M1088 1536q185 0 316.5 -93.5t131.5 -226.5v-896q0 -130 -125.5 -222t-305.5 -97l213 -202q16 -15 8 -35t-30 -20h-1056q-22 0 -30 20t8 35l213 202q-180 5 -305.5 97t-125.5 222v896q0 133 131.5 226.5t316.5 93.5h640zM288 224q66 0 113 47t47 113t-47 113t-113 47 t-113 -47t-47 -113t47 -113t113 -47zM704 768v512h-544v-512h544zM1248 224q66 0 113 47t47 113t-47 113t-113 47t-113 -47t-47 -113t47 -113t113 -47zM1408 768v512h-576v-512h576z" />
+<glyph unicode="&#xf23a;" horiz-adv-x="1792" d="M597 1115v-1173q0 -25 -12.5 -42.5t-36.5 -17.5q-17 0 -33 8l-465 233q-21 10 -35.5 33.5t-14.5 46.5v1140q0 20 10 34t29 14q14 0 44 -15l511 -256q3 -3 3 -5zM661 1014l534 -866l-534 266v600zM1792 996v-1054q0 -25 -14 -40.5t-38 -15.5t-47 13l-441 220zM1789 1116 q0 -3 -256.5 -419.5t-300.5 -487.5l-390 634l324 527q17 28 52 28q14 0 26 -6l541 -270q4 -2 4 -6z" />
+<glyph unicode="&#xf23b;" d="M809 532l266 499h-112l-157 -312q-24 -48 -44 -92l-42 92l-155 312h-120l263 -493v-324h101v318zM1536 1408v-1536h-1536v1536h1536z" />
+<glyph unicode="&#xf23c;" horiz-adv-x="2296" d="M478 -139q-8 -16 -27 -34.5t-37 -25.5q-25 -9 -51.5 3.5t-28.5 31.5q-1 22 40 55t68 38q23 4 34 -21.5t2 -46.5zM1819 -139q7 -16 26 -34.5t38 -25.5q25 -9 51.5 3.5t27.5 31.5q2 22 -39.5 55t-68.5 38q-22 4 -33 -21.5t-2 -46.5zM1867 -30q13 -27 56.5 -59.5t77.5 -41.5 q45 -13 82 4.5t37 50.5q0 46 -67.5 100.5t-115.5 59.5q-40 5 -63.5 -37.5t-6.5 -76.5zM428 -30q-13 -27 -56 -59.5t-77 -41.5q-45 -13 -82 4.5t-37 50.5q0 46 67.5 100.5t115.5 59.5q40 5 63 -37.5t6 -76.5zM1158 1094h1q-41 0 -76 -15q27 -8 44 -30.5t17 -49.5 q0 -35 -27 -60t-65 -25q-52 0 -80 43q-5 -23 -5 -42q0 -74 56 -126.5t135 -52.5q80 0 136 52.5t56 126.5t-56 126.5t-136 52.5zM1462 1312q-99 109 -220.5 131.5t-245.5 -44.5q27 60 82.5 96.5t118 39.5t121.5 -17t99.5 -74.5t44.5 -131.5zM2212 73q8 -11 -11 -42 q7 -23 7 -40q1 -56 -44.5 -112.5t-109.5 -91.5t-118 -37q-48 -2 -92 21.5t-66 65.5q-687 -25 -1259 0q-23 -41 -66.5 -65t-92.5 -22q-86 3 -179.5 80.5t-92.5 160.5q2 22 7 40q-19 31 -11 42q6 10 31 1q14 22 41 51q-7 29 2 38q11 10 39 -4q29 20 59 34q0 29 13 37 q23 12 51 -16q35 5 61 -2q18 -4 38 -19v73q-11 0 -18 2q-53 10 -97 44.5t-55 87.5q-9 38 0 81q15 62 93 95q2 17 19 35.5t36 23.5t33 -7.5t19 -30.5h13q46 -5 60 -23q3 -3 5 -7q10 1 30.5 3.5t30.5 3.5q-15 11 -30 17q-23 40 -91 43q0 6 1 10q-62 2 -118.5 18.5t-84.5 47.5 q-32 36 -42.5 92t-2.5 112q16 126 90 179q23 16 52 4.5t32 -40.5q0 -1 1.5 -14t2.5 -21t3 -20t5.5 -19t8.5 -10q27 -14 76 -12q48 46 98 74q-40 4 -162 -14l47 46q61 58 163 111q145 73 282 86q-20 8 -41 15.5t-47 14t-42.5 10.5t-47.5 11t-43 10q595 126 904 -139 q98 -84 158 -222q85 -10 121 9h1q5 3 8.5 10t5.5 19t3 19.5t3 21.5l1 14q3 28 32 40t52 -5q73 -52 91 -178q7 -57 -3.5 -113t-42.5 -91q-28 -32 -83.5 -48.5t-115.5 -18.5v-10q-71 -2 -95 -43q-14 -5 -31 -17q11 -1 32 -3.5t30 -3.5q1 4 5 8q16 18 60 23h13q5 18 19 30t33 8 t36 -23t19 -36q79 -32 93 -95q9 -40 1 -81q-12 -53 -56 -88t-97 -44q-10 -2 -17 -2q0 -49 -1 -73q20 15 38 19q26 7 61 2q28 28 51 16q14 -9 14 -37q33 -16 59 -34q27 13 38 4q10 -10 2 -38q28 -30 41 -51q23 8 31 -1zM1937 1025q0 -29 -9 -54q82 -32 112 -132 q4 37 -9.5 98.5t-41.5 90.5q-20 19 -36 17t-16 -20zM1859 925q35 -42 47.5 -108.5t-0.5 -124.5q67 13 97 45q13 14 18 28q-3 64 -31 114.5t-79 66.5q-15 -15 -52 -21zM1822 921q-30 0 -44 1q42 -115 53 -239q21 0 43 3q16 68 1 135t-53 100zM258 839q30 100 112 132 q-9 25 -9 54q0 18 -16.5 20t-35.5 -17q-28 -29 -41.5 -90.5t-9.5 -98.5zM294 737q29 -31 97 -45q-13 58 -0.5 124.5t47.5 108.5v0q-37 6 -52 21q-51 -16 -78.5 -66t-31.5 -115q9 -17 18 -28zM471 683q14 124 73 235q-19 -4 -55 -18l-45 -19v1q-46 -89 -20 -196q25 -3 47 -3z M1434 644q8 -38 16.5 -108.5t11.5 -89.5q3 -18 9.5 -21.5t23.5 4.5q40 20 62 85.5t23 125.5q-24 2 -146 4zM1152 1285q-116 0 -199 -82.5t-83 -198.5q0 -117 83 -199.5t199 -82.5t199 82.5t83 199.5q0 116 -83 198.5t-199 82.5zM1380 646q-106 2 -211 0v1q-1 -27 2.5 -86 t13.5 -66q29 -14 93.5 -14.5t95.5 10.5q9 3 11 39t-0.5 69.5t-4.5 46.5zM1112 447q8 4 9.5 48t-0.5 88t-4 63v1q-212 -3 -214 -3q-4 -20 -7 -62t0 -83t14 -46q34 -15 101 -16t101 10zM718 636q-16 -59 4.5 -118.5t77.5 -84.5q15 -8 24 -5t12 21q3 16 8 90t10 103 q-69 -2 -136 -6zM591 510q3 -23 -34 -36q132 -141 271.5 -240t305.5 -154q172 49 310.5 146t293.5 250q-33 13 -30 34l3 9v1v-1q-17 2 -50 5.5t-48 4.5q-26 -90 -82 -132q-51 -38 -82 1q-5 6 -9 14q-7 13 -17 62q-2 -5 -5 -9t-7.5 -7t-8 -5.5t-9.5 -4l-10 -2.5t-12 -2 l-12 -1.5t-13.5 -1t-13.5 -0.5q-106 -9 -163 11q-4 -17 -10 -26.5t-21 -15t-23 -7t-36 -3.5q-2 0 -3 -0.5t-3 -0.5h-3q-179 -17 -203 40q-2 -63 -56 -54q-47 8 -91 54q-12 13 -20 26q-17 29 -26 65q-58 -6 -87 -10q1 -2 4 -10zM507 -118q3 14 3 30q-17 71 -51 130t-73 70 q-41 12 -101.5 -14.5t-104.5 -80t-39 -107.5q35 -53 100 -93t119 -42q51 -2 94 28t53 79zM510 53q23 -63 27 -119q195 113 392 174q-98 52 -180.5 120t-179.5 165q-6 -4 -29 -13q0 -2 -1 -5t-1 -4q31 -18 22 -37q-12 -23 -56 -34q-10 -13 -29 -24h-1q-2 -83 1 -150 q19 -34 35 -73zM579 -113q532 -21 1145 0q-254 147 -428 196q-76 -35 -156 -57q-8 -3 -16 0q-65 21 -129 49q-208 -60 -416 -188h-1v-1q1 0 1 1zM1763 -67q4 54 28 120q14 38 33 71l-1 -1q3 77 3 153q-15 8 -30 25q-42 9 -56 33q-9 20 22 38q-2 4 -2 9q-16 4 -28 12 q-204 -190 -383 -284q198 -59 414 -176zM2155 -90q5 54 -39 107.5t-104 80t-102 14.5q-38 -11 -72.5 -70.5t-51.5 -129.5q0 -16 3 -30q10 -49 53 -79t94 -28q54 2 119 42t100 93z" />
+<glyph unicode="&#xf23d;" horiz-adv-x="2304" d="M1524 -25q0 -68 -48 -116t-116 -48t-116.5 48t-48.5 116t48.5 116.5t116.5 48.5t116 -48.5t48 -116.5zM775 -25q0 -68 -48.5 -116t-116.5 -48t-116 48t-48 116t48 116.5t116 48.5t116.5 -48.5t48.5 -116.5zM0 1469q57 -60 110.5 -104.5t121 -82t136 -63t166 -45.5 t200 -31.5t250 -18.5t304 -9.5t372.5 -2.5q139 0 244.5 -5t181 -16.5t124 -27.5t71 -39.5t24 -51.5t-19.5 -64t-56.5 -76.5t-89.5 -91t-116 -104.5t-139 -119q-185 -157 -286 -247q29 51 76.5 109t94 105.5t94.5 98.5t83 91.5t54 80.5t13 70t-45.5 55.5t-116.5 41t-204 23.5 t-304 5q-168 -2 -314 6t-256 23t-204.5 41t-159.5 51.5t-122.5 62.5t-91.5 66.5t-68 71.5t-50.5 69.5t-40 68t-36.5 59.5z" />
+<glyph unicode="&#xf23e;" horiz-adv-x="1792" d="M896 1472q-169 0 -323 -66t-265.5 -177.5t-177.5 -265.5t-66 -323t66 -323t177.5 -265.5t265.5 -177.5t323 -66t323 66t265.5 177.5t177.5 265.5t66 323t-66 323t-177.5 265.5t-265.5 177.5t-323 66zM896 1536q182 0 348 -71t286 -191t191 -286t71 -348t-71 -348 t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71zM496 704q16 0 16 -16v-480q0 -16 -16 -16h-32q-16 0 -16 16v480q0 16 16 16h32zM896 640q53 0 90.5 -37.5t37.5 -90.5q0 -35 -17.5 -64t-46.5 -46v-114q0 -14 -9 -23 t-23 -9h-64q-14 0 -23 9t-9 23v114q-29 17 -46.5 46t-17.5 64q0 53 37.5 90.5t90.5 37.5zM896 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM544 928v-96 q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v96q0 93 65.5 158.5t158.5 65.5t158.5 -65.5t65.5 -158.5v-96q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v96q0 146 -103 249t-249 103t-249 -103t-103 -249zM1408 192v512q0 26 -19 45t-45 19h-896q-26 0 -45 -19t-19 -45v-512 q0 -26 19 -45t45 -19h896q26 0 45 19t19 45z" />
+<glyph unicode="&#xf240;" horiz-adv-x="2304" d="M1920 1024v-768h-1664v768h1664zM2048 448h128v384h-128v288q0 14 -9 23t-23 9h-1856q-14 0 -23 -9t-9 -23v-960q0 -14 9 -23t23 -9h1856q14 0 23 9t9 23v288zM2304 832v-384q0 -53 -37.5 -90.5t-90.5 -37.5v-160q0 -66 -47 -113t-113 -47h-1856q-66 0 -113 47t-47 113 v960q0 66 47 113t113 47h1856q66 0 113 -47t47 -113v-160q53 0 90.5 -37.5t37.5 -90.5z" />
+<glyph unicode="&#xf241;" horiz-adv-x="2304" d="M256 256v768h1280v-768h-1280zM2176 960q53 0 90.5 -37.5t37.5 -90.5v-384q0 -53 -37.5 -90.5t-90.5 -37.5v-160q0 -66 -47 -113t-113 -47h-1856q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h1856q66 0 113 -47t47 -113v-160zM2176 448v384h-128v288q0 14 -9 23t-23 9 h-1856q-14 0 -23 -9t-9 -23v-960q0 -14 9 -23t23 -9h1856q14 0 23 9t9 23v288h128z" />
+<glyph unicode="&#xf242;" horiz-adv-x="2304" d="M256 256v768h896v-768h-896zM2176 960q53 0 90.5 -37.5t37.5 -90.5v-384q0 -53 -37.5 -90.5t-90.5 -37.5v-160q0 -66 -47 -113t-113 -47h-1856q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h1856q66 0 113 -47t47 -113v-160zM2176 448v384h-128v288q0 14 -9 23t-23 9 h-1856q-14 0 -23 -9t-9 -23v-960q0 -14 9 -23t23 -9h1856q14 0 23 9t9 23v288h128z" />
+<glyph unicode="&#xf243;" horiz-adv-x="2304" d="M256 256v768h512v-768h-512zM2176 960q53 0 90.5 -37.5t37.5 -90.5v-384q0 -53 -37.5 -90.5t-90.5 -37.5v-160q0 -66 -47 -113t-113 -47h-1856q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h1856q66 0 113 -47t47 -113v-160zM2176 448v384h-128v288q0 14 -9 23t-23 9 h-1856q-14 0 -23 -9t-9 -23v-960q0 -14 9 -23t23 -9h1856q14 0 23 9t9 23v288h128z" />
+<glyph unicode="&#xf244;" horiz-adv-x="2304" d="M2176 960q53 0 90.5 -37.5t37.5 -90.5v-384q0 -53 -37.5 -90.5t-90.5 -37.5v-160q0 -66 -47 -113t-113 -47h-1856q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h1856q66 0 113 -47t47 -113v-160zM2176 448v384h-128v288q0 14 -9 23t-23 9h-1856q-14 0 -23 -9t-9 -23 v-960q0 -14 9 -23t23 -9h1856q14 0 23 9t9 23v288h128z" />
+<glyph unicode="&#xf245;" horiz-adv-x="1280" d="M1133 493q31 -30 14 -69q-17 -40 -59 -40h-382l201 -476q10 -25 0 -49t-34 -35l-177 -75q-25 -10 -49 0t-35 34l-191 452l-312 -312q-19 -19 -45 -19q-12 0 -24 5q-40 17 -40 59v1504q0 42 40 59q12 5 24 5q27 0 45 -19z" />
+<glyph unicode="&#xf246;" horiz-adv-x="1024" d="M832 1408q-320 0 -320 -224v-416h128v-128h-128v-544q0 -224 320 -224h64v-128h-64q-272 0 -384 146q-112 -146 -384 -146h-64v128h64q320 0 320 224v544h-128v128h128v416q0 224 -320 224h-64v128h64q272 0 384 -146q112 146 384 146h64v-128h-64z" />
+<glyph unicode="&#xf247;" horiz-adv-x="2048" d="M2048 1152h-128v-1024h128v-384h-384v128h-1280v-128h-384v384h128v1024h-128v384h384v-128h1280v128h384v-384zM1792 1408v-128h128v128h-128zM128 1408v-128h128v128h-128zM256 -128v128h-128v-128h128zM1664 0v128h128v1024h-128v128h-1280v-128h-128v-1024h128v-128 h1280zM1920 -128v128h-128v-128h128zM1280 896h384v-768h-896v256h-384v768h896v-256zM512 512h640v512h-640v-512zM1536 256v512h-256v-384h-384v-128h640z" />
+<glyph unicode="&#xf248;" horiz-adv-x="2304" d="M2304 768h-128v-640h128v-384h-384v128h-896v-128h-384v384h128v128h-384v-128h-384v384h128v640h-128v384h384v-128h896v128h384v-384h-128v-128h384v128h384v-384zM2048 1024v-128h128v128h-128zM1408 1408v-128h128v128h-128zM128 1408v-128h128v128h-128zM256 256 v128h-128v-128h128zM1536 384h-128v-128h128v128zM384 384h896v128h128v640h-128v128h-896v-128h-128v-640h128v-128zM896 -128v128h-128v-128h128zM2176 -128v128h-128v-128h128zM2048 128v640h-128v128h-384v-384h128v-384h-384v128h-384v-128h128v-128h896v128h128z" />
+<glyph unicode="&#xf249;" d="M1024 288v-416h-928q-40 0 -68 28t-28 68v1344q0 40 28 68t68 28h1344q40 0 68 -28t28 -68v-928h-416q-40 0 -68 -28t-28 -68zM1152 256h381q-15 -82 -65 -132l-184 -184q-50 -50 -132 -65v381z" />
+<glyph unicode="&#xf24a;" d="M1400 256h-248v-248q29 10 41 22l185 185q12 12 22 41zM1120 384h288v896h-1280v-1280h896v288q0 40 28 68t68 28zM1536 1312v-1024q0 -40 -20 -88t-48 -76l-184 -184q-28 -28 -76 -48t-88 -20h-1024q-40 0 -68 28t-28 68v1344q0 40 28 68t68 28h1344q40 0 68 -28t28 -68 z" />
+<glyph unicode="&#xf24b;" horiz-adv-x="2304" d="M1951 538q0 -26 -15.5 -44.5t-38.5 -23.5q-8 -2 -18 -2h-153v140h153q10 0 18 -2q23 -5 38.5 -23.5t15.5 -44.5zM1933 751q0 -25 -15 -42t-38 -21q-3 -1 -15 -1h-139v129h139q3 0 8.5 -0.5t6.5 -0.5q23 -4 38 -21.5t15 -42.5zM728 587v308h-228v-308q0 -58 -38 -94.5 t-105 -36.5q-108 0 -229 59v-112q53 -15 121 -23t109 -9l42 -1q328 0 328 217zM1442 403v113q-99 -52 -200 -59q-108 -8 -169 41t-61 142t61 142t169 41q101 -7 200 -58v112q-48 12 -100 19.5t-80 9.5l-28 2q-127 6 -218.5 -14t-140.5 -60t-71 -88t-22 -106t22 -106t71 -88 t140.5 -60t218.5 -14q101 4 208 31zM2176 518q0 54 -43 88.5t-109 39.5v3q57 8 89 41.5t32 79.5q0 55 -41 88t-107 36q-3 0 -12 0.5t-14 0.5h-455v-510h491q74 0 121.5 36.5t47.5 96.5zM2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90 t90 38h2048q52 0 90 -38t38 -90z" />
+<glyph unicode="&#xf24c;" horiz-adv-x="2304" d="M858 295v693q-106 -41 -172 -135.5t-66 -211.5t66 -211.5t172 -134.5zM1362 641q0 117 -66 211.5t-172 135.5v-694q106 41 172 135.5t66 211.5zM1577 641q0 -159 -78.5 -294t-213.5 -213.5t-294 -78.5q-119 0 -227.5 46.5t-187 125t-125 187t-46.5 227.5q0 159 78.5 294 t213.5 213.5t294 78.5t294 -78.5t213.5 -213.5t78.5 -294zM1960 634q0 139 -55.5 261.5t-147.5 205.5t-213.5 131t-252.5 48h-301q-176 0 -323.5 -81t-235 -230t-87.5 -335q0 -171 87 -317.5t236 -231.5t323 -85h301q129 0 251.5 50.5t214.5 135t147.5 202.5t55.5 246z M2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h2048q52 0 90 -38t38 -90z" />
+<glyph unicode="&#xf24d;" horiz-adv-x="1792" d="M1664 -96v1088q0 13 -9.5 22.5t-22.5 9.5h-1088q-13 0 -22.5 -9.5t-9.5 -22.5v-1088q0 -13 9.5 -22.5t22.5 -9.5h1088q13 0 22.5 9.5t9.5 22.5zM1792 992v-1088q0 -66 -47 -113t-113 -47h-1088q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1088q66 0 113 -47t47 -113 zM1408 1376v-160h-128v160q0 13 -9.5 22.5t-22.5 9.5h-1088q-13 0 -22.5 -9.5t-9.5 -22.5v-1088q0 -13 9.5 -22.5t22.5 -9.5h160v-128h-160q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1088q66 0 113 -47t47 -113z" />
+<glyph unicode="&#xf24e;" horiz-adv-x="2304" d="M1728 1088l-384 -704h768zM448 1088l-384 -704h768zM1269 1280q-14 -40 -45.5 -71.5t-71.5 -45.5v-1291h608q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1344q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h608v1291q-40 14 -71.5 45.5t-45.5 71.5h-491q-14 0 -23 9t-9 23v64 q0 14 9 23t23 9h491q21 57 70 92.5t111 35.5t111 -35.5t70 -92.5h491q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-491zM1088 1264q33 0 56.5 23.5t23.5 56.5t-23.5 56.5t-56.5 23.5t-56.5 -23.5t-23.5 -56.5t23.5 -56.5t56.5 -23.5zM2176 384q0 -73 -46.5 -131t-117.5 -91 t-144.5 -49.5t-139.5 -16.5t-139.5 16.5t-144.5 49.5t-117.5 91t-46.5 131q0 11 35 81t92 174.5t107 195.5t102 184t56 100q18 33 56 33t56 -33q4 -7 56 -100t102 -184t107 -195.5t92 -174.5t35 -81zM896 384q0 -73 -46.5 -131t-117.5 -91t-144.5 -49.5t-139.5 -16.5 t-139.5 16.5t-144.5 49.5t-117.5 91t-46.5 131q0 11 35 81t92 174.5t107 195.5t102 184t56 100q18 33 56 33t56 -33q4 -7 56 -100t102 -184t107 -195.5t92 -174.5t35 -81z" />
+<glyph unicode="&#xf250;" d="M1408 1408q0 -261 -106.5 -461.5t-266.5 -306.5q160 -106 266.5 -306.5t106.5 -461.5h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1472q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96q0 261 106.5 461.5t266.5 306.5q-160 106 -266.5 306.5t-106.5 461.5h-96q-14 0 -23 9 t-9 23v64q0 14 9 23t23 9h1472q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96zM874 700q77 29 149 92.5t129.5 152.5t92.5 210t35 253h-1024q0 -132 35 -253t92.5 -210t129.5 -152.5t149 -92.5q19 -7 30.5 -23.5t11.5 -36.5t-11.5 -36.5t-30.5 -23.5q-77 -29 -149 -92.5 t-129.5 -152.5t-92.5 -210t-35 -253h1024q0 132 -35 253t-92.5 210t-129.5 152.5t-149 92.5q-19 7 -30.5 23.5t-11.5 36.5t11.5 36.5t30.5 23.5z" />
+<glyph unicode="&#xf251;" d="M1408 1408q0 -261 -106.5 -461.5t-266.5 -306.5q160 -106 266.5 -306.5t106.5 -461.5h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1472q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96q0 261 106.5 461.5t266.5 306.5q-160 106 -266.5 306.5t-106.5 461.5h-96q-14 0 -23 9 t-9 23v64q0 14 9 23t23 9h1472q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96zM1280 1408h-1024q0 -66 9 -128h1006q9 61 9 128zM1280 -128q0 130 -34 249.5t-90.5 208t-126.5 152t-146 94.5h-230q-76 -31 -146 -94.5t-126.5 -152t-90.5 -208t-34 -249.5h1024z" />
+<glyph unicode="&#xf252;" d="M1408 1408q0 -261 -106.5 -461.5t-266.5 -306.5q160 -106 266.5 -306.5t106.5 -461.5h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1472q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96q0 261 106.5 461.5t266.5 306.5q-160 106 -266.5 306.5t-106.5 461.5h-96q-14 0 -23 9 t-9 23v64q0 14 9 23t23 9h1472q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96zM1280 1408h-1024q0 -206 85 -384h854q85 178 85 384zM1223 192q-54 141 -145.5 241.5t-194.5 142.5h-230q-103 -42 -194.5 -142.5t-145.5 -241.5h910z" />
+<glyph unicode="&#xf253;" d="M1408 1408q0 -261 -106.5 -461.5t-266.5 -306.5q160 -106 266.5 -306.5t106.5 -461.5h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1472q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96q0 261 106.5 461.5t266.5 306.5q-160 106 -266.5 306.5t-106.5 461.5h-96q-14 0 -23 9 t-9 23v64q0 14 9 23t23 9h1472q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96zM874 700q77 29 149 92.5t129.5 152.5t92.5 210t35 253h-1024q0 -132 35 -253t92.5 -210t129.5 -152.5t149 -92.5q19 -7 30.5 -23.5t11.5 -36.5t-11.5 -36.5t-30.5 -23.5q-137 -51 -244 -196 h700q-107 145 -244 196q-19 7 -30.5 23.5t-11.5 36.5t11.5 36.5t30.5 23.5z" />
+<glyph unicode="&#xf254;" d="M1504 -64q14 0 23 -9t9 -23v-128q0 -14 -9 -23t-23 -9h-1472q-14 0 -23 9t-9 23v128q0 14 9 23t23 9h1472zM130 0q3 55 16 107t30 95t46 87t53.5 76t64.5 69.5t66 60t70.5 55t66.5 47.5t65 43q-43 28 -65 43t-66.5 47.5t-70.5 55t-66 60t-64.5 69.5t-53.5 76t-46 87 t-30 95t-16 107h1276q-3 -55 -16 -107t-30 -95t-46 -87t-53.5 -76t-64.5 -69.5t-66 -60t-70.5 -55t-66.5 -47.5t-65 -43q43 -28 65 -43t66.5 -47.5t70.5 -55t66 -60t64.5 -69.5t53.5 -76t46 -87t30 -95t16 -107h-1276zM1504 1536q14 0 23 -9t9 -23v-128q0 -14 -9 -23t-23 -9 h-1472q-14 0 -23 9t-9 23v128q0 14 9 23t23 9h1472z" />
+<glyph unicode="&#xf255;" d="M768 1152q-53 0 -90.5 -37.5t-37.5 -90.5v-128h-32v93q0 48 -32 81.5t-80 33.5q-46 0 -79 -33t-33 -79v-429l-32 30v172q0 48 -32 81.5t-80 33.5q-46 0 -79 -33t-33 -79v-224q0 -47 35 -82l310 -296q39 -39 39 -102q0 -26 19 -45t45 -19h640q26 0 45 19t19 45v25 q0 41 10 77l108 436q10 36 10 77v246q0 48 -32 81.5t-80 33.5q-46 0 -79 -33t-33 -79v-32h-32v125q0 40 -25 72.5t-64 40.5q-14 2 -23 2q-46 0 -79 -33t-33 -79v-128h-32v122q0 51 -32.5 89.5t-82.5 43.5q-5 1 -13 1zM768 1280q84 0 149 -50q57 34 123 34q59 0 111 -27 t86 -76q27 7 59 7q100 0 170 -71.5t70 -171.5v-246q0 -51 -13 -108l-109 -436q-6 -24 -6 -71q0 -80 -56 -136t-136 -56h-640q-84 0 -138 58.5t-54 142.5l-308 296q-76 73 -76 175v224q0 99 70.5 169.5t169.5 70.5q11 0 16 -1q6 95 75.5 160t164.5 65q52 0 98 -21 q72 69 174 69z" />
+<glyph unicode="&#xf256;" horiz-adv-x="1792" d="M880 1408q-46 0 -79 -33t-33 -79v-656h-32v528q0 46 -33 79t-79 33t-79 -33t-33 -79v-528v-256l-154 205q-38 51 -102 51q-53 0 -90.5 -37.5t-37.5 -90.5q0 -43 26 -77l384 -512q38 -51 102 -51h688q34 0 61 22t34 56l76 405q5 32 5 59v498q0 46 -33 79t-79 33t-79 -33 t-33 -79v-272h-32v528q0 46 -33 79t-79 33t-79 -33t-33 -79v-528h-32v656q0 46 -33 79t-79 33zM880 1536q68 0 125.5 -35.5t88.5 -96.5q19 4 42 4q99 0 169.5 -70.5t70.5 -169.5v-17q105 6 180.5 -64t75.5 -175v-498q0 -40 -8 -83l-76 -404q-14 -79 -76.5 -131t-143.5 -52 h-688q-60 0 -114.5 27.5t-90.5 74.5l-384 512q-51 68 -51 154q0 106 75 181t181 75q78 0 128 -34v434q0 99 70.5 169.5t169.5 70.5q23 0 42 -4q31 61 88.5 96.5t125.5 35.5z" />
+<glyph unicode="&#xf257;" horiz-adv-x="1792" d="M1073 -128h-177q-163 0 -226 141q-23 49 -23 102v5q-62 30 -98.5 88.5t-36.5 127.5q0 38 5 48h-261q-106 0 -181 75t-75 181t75 181t181 75h113l-44 17q-74 28 -119.5 93.5t-45.5 145.5q0 106 75 181t181 75q46 0 91 -17l628 -239h401q106 0 181 -75t75 -181v-668 q0 -88 -54 -157.5t-140 -90.5l-339 -85q-92 -23 -186 -23zM1024 583l-155 -71l-163 -74q-30 -14 -48 -41.5t-18 -60.5q0 -46 33 -79t79 -33q26 0 46 10l338 154q-49 10 -80.5 50t-31.5 90v55zM1344 272q0 46 -33 79t-79 33q-26 0 -46 -10l-290 -132q-28 -13 -37 -17 t-30.5 -17t-29.5 -23.5t-16 -29t-8 -40.5q0 -50 31.5 -82t81.5 -32q20 0 38 9l352 160q30 14 48 41.5t18 60.5zM1112 1024l-650 248q-24 8 -46 8q-53 0 -90.5 -37.5t-37.5 -90.5q0 -40 22.5 -73t59.5 -47l526 -200v-64h-640q-53 0 -90.5 -37.5t-37.5 -90.5t37.5 -90.5 t90.5 -37.5h535l233 106v198q0 63 46 106l111 102h-69zM1073 0q82 0 155 19l339 85q43 11 70 45.5t27 78.5v668q0 53 -37.5 90.5t-90.5 37.5h-308l-136 -126q-36 -33 -36 -82v-296q0 -46 33 -77t79 -31t79 35t33 81v208h32v-208q0 -70 -57 -114q52 -8 86.5 -48.5t34.5 -93.5 q0 -42 -23 -78t-61 -53l-310 -141h91z" />
+<glyph unicode="&#xf258;" horiz-adv-x="2048" d="M1151 1536q61 0 116 -28t91 -77l572 -781q118 -159 118 -359v-355q0 -80 -56 -136t-136 -56h-384q-80 0 -136 56t-56 136v177l-286 143h-546q-80 0 -136 56t-56 136v32q0 119 84.5 203.5t203.5 84.5h420l42 128h-686q-100 0 -173.5 67.5t-81.5 166.5q-65 79 -65 182v32 q0 80 56 136t136 56h959zM1920 -64v355q0 157 -93 284l-573 781q-39 52 -103 52h-959q-26 0 -45 -19t-19 -45q0 -32 1.5 -49.5t9.5 -40.5t25 -43q10 31 35.5 50t56.5 19h832v-32h-832q-26 0 -45 -19t-19 -45q0 -44 3 -58q8 -44 44 -73t81 -29h640h91q40 0 68 -28t28 -68 q0 -15 -5 -30l-64 -192q-10 -29 -35 -47.5t-56 -18.5h-443q-66 0 -113 -47t-47 -113v-32q0 -26 19 -45t45 -19h561q16 0 29 -7l317 -158q24 -13 38.5 -36t14.5 -50v-197q0 -26 19 -45t45 -19h384q26 0 45 19t19 45z" />
+<glyph unicode="&#xf259;" horiz-adv-x="2048" d="M816 1408q-48 0 -79.5 -34t-31.5 -82q0 -14 3 -28l150 -624h-26l-116 482q-9 38 -39.5 62t-69.5 24q-47 0 -79 -34t-32 -81q0 -11 4 -29q3 -13 39 -161t68 -282t32 -138v-227l-307 230q-34 26 -77 26q-52 0 -89.5 -36.5t-37.5 -88.5q0 -67 56 -110l507 -379 q34 -26 76 -26h694q33 0 59 20.5t34 52.5l100 401q8 30 10 88t9 86l116 478q3 12 3 26q0 46 -33 79t-80 33q-38 0 -69 -25.5t-40 -62.5l-99 -408h-26l132 547q3 14 3 28q0 47 -32 80t-80 33q-38 0 -68.5 -24t-39.5 -62l-145 -602h-127l-164 682q-9 38 -39.5 62t-68.5 24z M1461 -256h-694q-85 0 -153 51l-507 380q-50 38 -78.5 94t-28.5 118q0 105 75 179t180 74q25 0 49.5 -5.5t41.5 -11t41 -20.5t35 -23t38.5 -29.5t37.5 -28.5l-123 512q-7 35 -7 59q0 93 60 162t152 79q14 87 80.5 144.5t155.5 57.5q83 0 148 -51.5t85 -132.5l103 -428 l83 348q20 81 85 132.5t148 51.5q87 0 152.5 -54t82.5 -139q93 -10 155 -78t62 -161q0 -30 -7 -57l-116 -477q-5 -22 -5 -67q0 -51 -13 -108l-101 -401q-19 -75 -79.5 -122.5t-137.5 -47.5z" />
+<glyph unicode="&#xf25a;" horiz-adv-x="1792" d="M640 1408q-53 0 -90.5 -37.5t-37.5 -90.5v-512v-384l-151 202q-41 54 -107 54q-52 0 -89 -38t-37 -90q0 -43 26 -77l384 -512q38 -51 102 -51h718q22 0 39.5 13.5t22.5 34.5l92 368q24 96 24 194v217q0 41 -28 71t-68 30t-68 -28t-28 -68h-32v61q0 48 -32 81.5t-80 33.5 q-46 0 -79 -33t-33 -79v-64h-32v90q0 55 -37 94.5t-91 39.5q-53 0 -90.5 -37.5t-37.5 -90.5v-96h-32v570q0 55 -37 94.5t-91 39.5zM640 1536q107 0 181.5 -77.5t74.5 -184.5v-220q22 2 32 2q99 0 173 -69q47 21 99 21q113 0 184 -87q27 7 56 7q94 0 159 -67.5t65 -161.5 v-217q0 -116 -28 -225l-92 -368q-16 -64 -68 -104.5t-118 -40.5h-718q-60 0 -114.5 27.5t-90.5 74.5l-384 512q-51 68 -51 154q0 105 74.5 180.5t179.5 75.5q71 0 130 -35v547q0 106 75 181t181 75zM768 128v384h-32v-384h32zM1024 128v384h-32v-384h32zM1280 128v384h-32 v-384h32z" />
+<glyph unicode="&#xf25b;" d="M1288 889q60 0 107 -23q141 -63 141 -226v-177q0 -94 -23 -186l-85 -339q-21 -86 -90.5 -140t-157.5 -54h-668q-106 0 -181 75t-75 181v401l-239 628q-17 45 -17 91q0 106 75 181t181 75q80 0 145.5 -45.5t93.5 -119.5l17 -44v113q0 106 75 181t181 75t181 -75t75 -181 v-261q27 5 48 5q69 0 127.5 -36.5t88.5 -98.5zM1072 896q-33 0 -60.5 -18t-41.5 -48l-74 -163l-71 -155h55q50 0 90 -31.5t50 -80.5l154 338q10 20 10 46q0 46 -33 79t-79 33zM1293 761q-22 0 -40.5 -8t-29 -16t-23.5 -29.5t-17 -30.5t-17 -37l-132 -290q-10 -20 -10 -46 q0 -46 33 -79t79 -33q33 0 60.5 18t41.5 48l160 352q9 18 9 38q0 50 -32 81.5t-82 31.5zM128 1120q0 -22 8 -46l248 -650v-69l102 111q43 46 106 46h198l106 233v535q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5v-640h-64l-200 526q-14 37 -47 59.5t-73 22.5 q-53 0 -90.5 -37.5t-37.5 -90.5zM1180 -128q44 0 78.5 27t45.5 70l85 339q19 73 19 155v91l-141 -310q-17 -38 -53 -61t-78 -23q-53 0 -93.5 34.5t-48.5 86.5q-44 -57 -114 -57h-208v32h208q46 0 81 33t35 79t-31 79t-77 33h-296q-49 0 -82 -36l-126 -136v-308 q0 -53 37.5 -90.5t90.5 -37.5h668z" />
+<glyph unicode="&#xf25c;" horiz-adv-x="1973" d="M857 992v-117q0 -13 -9.5 -22t-22.5 -9h-298v-812q0 -13 -9 -22.5t-22 -9.5h-135q-13 0 -22.5 9t-9.5 23v812h-297q-13 0 -22.5 9t-9.5 22v117q0 14 9 23t23 9h793q13 0 22.5 -9.5t9.5 -22.5zM1895 995l77 -961q1 -13 -8 -24q-10 -10 -23 -10h-134q-12 0 -21 8.5 t-10 20.5l-46 588l-189 -425q-8 -19 -29 -19h-120q-20 0 -29 19l-188 427l-45 -590q-1 -12 -10 -20.5t-21 -8.5h-135q-13 0 -23 10q-9 10 -9 24l78 961q1 12 10 20.5t21 8.5h142q20 0 29 -19l220 -520q10 -24 20 -51q3 7 9.5 24.5t10.5 26.5l221 520q9 19 29 19h141 q13 0 22 -8.5t10 -20.5z" />
+<glyph unicode="&#xf25d;" horiz-adv-x="1792" d="M1042 833q0 88 -60 121q-33 18 -117 18h-123v-281h162q66 0 102 37t36 105zM1094 548l205 -373q8 -17 -1 -31q-8 -16 -27 -16h-152q-20 0 -28 17l-194 365h-155v-350q0 -14 -9 -23t-23 -9h-134q-14 0 -23 9t-9 23v960q0 14 9 23t23 9h294q128 0 190 -24q85 -31 134 -109 t49 -180q0 -92 -42.5 -165.5t-115.5 -109.5q6 -10 9 -16zM896 1376q-150 0 -286 -58.5t-234.5 -157t-157 -234.5t-58.5 -286t58.5 -286t157 -234.5t234.5 -157t286 -58.5t286 58.5t234.5 157t157 234.5t58.5 286t-58.5 286t-157 234.5t-234.5 157t-286 58.5zM1792 640 q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
+<glyph unicode="&#xf25e;" horiz-adv-x="1792" d="M605 303q153 0 257 104q14 18 3 36l-45 82q-6 13 -24 17q-16 2 -27 -11l-4 -3q-4 -4 -11.5 -10t-17.5 -13t-23.5 -14.5t-28.5 -13.5t-33.5 -9.5t-37.5 -3.5q-76 0 -125 50t-49 127q0 76 48 125.5t122 49.5q37 0 71.5 -14t50.5 -28l16 -14q11 -11 26 -10q16 2 24 14l53 78 q13 20 -2 39q-3 4 -11 12t-30 23.5t-48.5 28t-67.5 22.5t-86 10q-148 0 -246 -96.5t-98 -240.5q0 -146 97 -241.5t247 -95.5zM1235 303q153 0 257 104q14 18 4 36l-45 82q-8 14 -25 17q-16 2 -27 -11l-4 -3q-4 -4 -11.5 -10t-17.5 -13t-23.5 -14.5t-28.5 -13.5t-33.5 -9.5 t-37.5 -3.5q-76 0 -125 50t-49 127q0 76 48 125.5t122 49.5q37 0 71.5 -14t50.5 -28l16 -14q11 -11 26 -10q16 2 24 14l53 78q13 20 -2 39q-3 4 -11 12t-30 23.5t-48.5 28t-67.5 22.5t-86 10q-147 0 -245.5 -96.5t-98.5 -240.5q0 -146 97 -241.5t247 -95.5zM896 1376 q-150 0 -286 -58.5t-234.5 -157t-157 -234.5t-58.5 -286t58.5 -286t157 -234.5t234.5 -157t286 -58.5t286 58.5t234.5 157t157 234.5t58.5 286t-58.5 286t-157 234.5t-234.5 157t-286 58.5zM896 1536q182 0 348 -71t286 -191t191 -286t71 -348t-71 -348t-191 -286t-286 -191 t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71z" />
+<glyph unicode="&#xf260;" horiz-adv-x="2048" d="M736 736l384 -384l-384 -384l-672 672l672 672l168 -168l-96 -96l-72 72l-480 -480l480 -480l193 193l-289 287zM1312 1312l672 -672l-672 -672l-168 168l96 96l72 -72l480 480l-480 480l-193 -193l289 -287l-96 -96l-384 384z" />
+<glyph unicode="&#xf261;" horiz-adv-x="1792" d="M717 182l271 271l-279 279l-88 -88l192 -191l-96 -96l-279 279l279 279l40 -40l87 87l-127 128l-454 -454zM1075 190l454 454l-454 454l-271 -271l279 -279l88 88l-192 191l96 96l279 -279l-279 -279l-40 40l-87 -88zM1792 640q0 -182 -71 -348t-191 -286t-286 -191 t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
+<glyph unicode="&#xf262;" horiz-adv-x="2304" d="M651 539q0 -39 -27.5 -66.5t-65.5 -27.5q-39 0 -66.5 27.5t-27.5 66.5q0 38 27.5 65.5t66.5 27.5q38 0 65.5 -27.5t27.5 -65.5zM1805 540q0 -39 -27.5 -66.5t-66.5 -27.5t-66.5 27.5t-27.5 66.5t27.5 66t66.5 27t66.5 -27t27.5 -66zM765 539q0 79 -56.5 136t-136.5 57 t-136.5 -56.5t-56.5 -136.5t56.5 -136.5t136.5 -56.5t136.5 56.5t56.5 136.5zM1918 540q0 80 -56.5 136.5t-136.5 56.5q-79 0 -136 -56.5t-57 -136.5t56.5 -136.5t136.5 -56.5t136.5 56.5t56.5 136.5zM850 539q0 -116 -81.5 -197.5t-196.5 -81.5q-116 0 -197.5 82t-81.5 197 t82 196.5t197 81.5t196.5 -81.5t81.5 -196.5zM2004 540q0 -115 -81.5 -196.5t-197.5 -81.5q-115 0 -196.5 81.5t-81.5 196.5t81.5 196.5t196.5 81.5q116 0 197.5 -81.5t81.5 -196.5zM1040 537q0 191 -135.5 326.5t-326.5 135.5q-125 0 -231 -62t-168 -168.5t-62 -231.5 t62 -231.5t168 -168.5t231 -62q191 0 326.5 135.5t135.5 326.5zM1708 1110q-254 111 -556 111q-319 0 -573 -110q117 0 223 -45.5t182.5 -122.5t122 -183t45.5 -223q0 115 43.5 219.5t118 180.5t177.5 123t217 50zM2187 537q0 191 -135 326.5t-326 135.5t-326.5 -135.5 t-135.5 -326.5t135.5 -326.5t326.5 -135.5t326 135.5t135 326.5zM1921 1103h383q-44 -51 -75 -114.5t-40 -114.5q110 -151 110 -337q0 -156 -77 -288t-209 -208.5t-287 -76.5q-133 0 -249 56t-196 155q-47 -56 -129 -179q-11 22 -53.5 82.5t-74.5 97.5 q-80 -99 -196.5 -155.5t-249.5 -56.5q-155 0 -287 76.5t-209 208.5t-77 288q0 186 110 337q-9 51 -40 114.5t-75 114.5h365q149 100 355 156.5t432 56.5q224 0 421 -56t348 -157z" />
+<glyph unicode="&#xf263;" horiz-adv-x="1280" d="M640 629q-188 0 -321 133t-133 320q0 188 133 321t321 133t321 -133t133 -321q0 -187 -133 -320t-321 -133zM640 1306q-92 0 -157.5 -65.5t-65.5 -158.5q0 -92 65.5 -157.5t157.5 -65.5t157.5 65.5t65.5 157.5q0 93 -65.5 158.5t-157.5 65.5zM1163 574q13 -27 15 -49.5 t-4.5 -40.5t-26.5 -38.5t-42.5 -37t-61.5 -41.5q-115 -73 -315 -94l73 -72l267 -267q30 -31 30 -74t-30 -73l-12 -13q-31 -30 -74 -30t-74 30q-67 68 -267 268l-267 -268q-31 -30 -74 -30t-73 30l-12 13q-31 30 -31 73t31 74l267 267l72 72q-203 21 -317 94 q-39 25 -61.5 41.5t-42.5 37t-26.5 38.5t-4.5 40.5t15 49.5q10 20 28 35t42 22t56 -2t65 -35q5 -4 15 -11t43 -24.5t69 -30.5t92 -24t113 -11q91 0 174 25.5t120 50.5l38 25q33 26 65 35t56 2t42 -22t28 -35z" />
+<glyph unicode="&#xf264;" d="M927 956q0 -66 -46.5 -112.5t-112.5 -46.5t-112.5 46.5t-46.5 112.5t46.5 112.5t112.5 46.5t112.5 -46.5t46.5 -112.5zM1141 593q-10 20 -28 32t-47.5 9.5t-60.5 -27.5q-10 -8 -29 -20t-81 -32t-127 -20t-124 18t-86 36l-27 18q-31 25 -60.5 27.5t-47.5 -9.5t-28 -32 q-22 -45 -2 -74.5t87 -73.5q83 -53 226 -67l-51 -52q-142 -142 -191 -190q-22 -22 -22 -52.5t22 -52.5l9 -9q22 -22 52.5 -22t52.5 22l191 191q114 -115 191 -191q22 -22 52.5 -22t52.5 22l9 9q22 22 22 52.5t-22 52.5l-191 190l-52 52q141 14 225 67q67 44 87 73.5t-2 74.5 zM1092 956q0 134 -95 229t-229 95t-229 -95t-95 -229t95 -229t229 -95t229 95t95 229zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf265;" horiz-adv-x="1720" d="M1565 1408q65 0 110 -45.5t45 -110.5v-519q0 -176 -68 -336t-182.5 -275t-274 -182.5t-334.5 -67.5q-176 0 -335.5 67.5t-274.5 182.5t-183 275t-68 336v519q0 64 46 110t110 46h1409zM861 344q47 0 82 33l404 388q37 35 37 85q0 49 -34.5 83.5t-83.5 34.5q-47 0 -82 -33 l-323 -310l-323 310q-35 33 -81 33q-49 0 -83.5 -34.5t-34.5 -83.5q0 -51 36 -85l405 -388q33 -33 81 -33z" />
+<glyph unicode="&#xf266;" horiz-adv-x="2304" d="M1494 -103l-295 695q-25 -49 -158.5 -305.5t-198.5 -389.5q-1 -1 -27.5 -0.5t-26.5 1.5q-82 193 -255.5 587t-259.5 596q-21 50 -66.5 107.5t-103.5 100.5t-102 43q0 5 -0.5 24t-0.5 27h583v-50q-39 -2 -79.5 -16t-66.5 -43t-10 -64q26 -59 216.5 -499t235.5 -540 q31 61 140 266.5t131 247.5q-19 39 -126 281t-136 295q-38 69 -201 71v50l513 -1v-47q-60 -2 -93.5 -25t-12.5 -69q33 -70 87 -189.5t86 -187.5q110 214 173 363q24 55 -10 79.5t-129 26.5q1 7 1 25v24q64 0 170.5 0.5t180 1t92.5 0.5v-49q-62 -2 -119 -33t-90 -81 l-213 -442q13 -33 127.5 -290t121.5 -274l441 1017q-14 38 -49.5 62.5t-65 31.5t-55.5 8v50l460 -4l1 -2l-1 -44q-139 -4 -201 -145q-526 -1216 -559 -1291h-49z" />
+<glyph unicode="&#xf267;" horiz-adv-x="1792" d="M949 643q0 -26 -16.5 -45t-41.5 -19q-26 0 -45 16.5t-19 41.5q0 26 17 45t42 19t44 -16.5t19 -41.5zM964 585l350 581q-9 -8 -67.5 -62.5t-125.5 -116.5t-136.5 -127t-117 -110.5t-50.5 -51.5l-349 -580q7 7 67 62t126 116.5t136 127t117 111t50 50.5zM1611 640 q0 -201 -104 -371q-3 2 -17 11t-26.5 16.5t-16.5 7.5q-13 0 -13 -13q0 -10 59 -44q-74 -112 -184.5 -190.5t-241.5 -110.5l-16 67q-1 10 -15 10q-5 0 -8 -5.5t-2 -9.5l16 -68q-72 -15 -146 -15q-199 0 -372 105q1 2 13 20.5t21.5 33.5t9.5 19q0 13 -13 13q-6 0 -17 -14.5 t-22.5 -34.5t-13.5 -23q-113 75 -192 187.5t-110 244.5l69 15q10 3 10 15q0 5 -5.5 8t-10.5 2l-68 -15q-14 72 -14 139q0 206 109 379q2 -1 18.5 -12t30 -19t17.5 -8q13 0 13 12q0 6 -12.5 15.5t-32.5 21.5l-20 12q77 112 189 189t244 107l15 -67q2 -10 15 -10q5 0 8 5.5 t2 10.5l-15 66q71 13 134 13q204 0 379 -109q-39 -56 -39 -65q0 -13 12 -13q11 0 48 64q111 -75 187.5 -186t107.5 -241l-56 -12q-10 -2 -10 -16q0 -5 5.5 -8t9.5 -2l57 13q14 -72 14 -140zM1696 640q0 163 -63.5 311t-170.5 255t-255 170.5t-311 63.5t-311 -63.5 t-255 -170.5t-170.5 -255t-63.5 -311t63.5 -311t170.5 -255t255 -170.5t311 -63.5t311 63.5t255 170.5t170.5 255t63.5 311zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191 t191 -286t71 -348z" />
+<glyph unicode="&#xf268;" horiz-adv-x="1792" d="M893 1536q240 2 451 -120q232 -134 352 -372l-742 39q-160 9 -294 -74.5t-185 -229.5l-276 424q128 159 311 245.5t383 87.5zM146 1131l337 -663q72 -143 211 -217t293 -45l-230 -451q-212 33 -385 157.5t-272.5 316t-99.5 411.5q0 267 146 491zM1732 962 q58 -150 59.5 -310.5t-48.5 -306t-153 -272t-246 -209.5q-230 -133 -498 -119l405 623q88 131 82.5 290.5t-106.5 277.5zM896 942q125 0 213.5 -88.5t88.5 -213.5t-88.5 -213.5t-213.5 -88.5t-213.5 88.5t-88.5 213.5t88.5 213.5t213.5 88.5z" />
+<glyph unicode="&#xf269;" horiz-adv-x="1792" d="M903 -256q-283 0 -504.5 150.5t-329.5 398.5q-58 131 -67 301t26 332.5t111 312t179 242.5l-11 -281q11 14 68 15.5t70 -15.5q42 81 160.5 138t234.5 59q-54 -45 -119.5 -148.5t-58.5 -163.5q25 -8 62.5 -13.5t63 -7.5t68 -4t50.5 -3q15 -5 9.5 -45.5t-30.5 -75.5 q-5 -7 -16.5 -18.5t-56.5 -35.5t-101 -34l15 -189l-139 67q-18 -43 -7.5 -81.5t36 -66.5t65.5 -41.5t81 -6.5q51 9 98 34.5t83.5 45t73.5 17.5q61 -4 89.5 -33t19.5 -65q-1 -2 -2.5 -5.5t-8.5 -12.5t-18 -15.5t-31.5 -10.5t-46.5 -1q-60 -95 -144.5 -135.5t-209.5 -29.5 q74 -61 162.5 -82.5t168.5 -6t154.5 52t128 87.5t80.5 104q43 91 39 192.5t-37.5 188.5t-78.5 125q87 -38 137 -79.5t77 -112.5q15 170 -57.5 343t-209.5 284q265 -77 412 -279.5t151 -517.5q2 -127 -40.5 -255t-123.5 -238t-189 -196t-247.5 -135.5t-288.5 -49.5z" />
+<glyph unicode="&#xf26a;" horiz-adv-x="1792" d="M1493 1308q-165 110 -359 110q-155 0 -293 -73t-240 -200q-75 -93 -119.5 -218t-48.5 -266v-42q4 -141 48.5 -266t119.5 -218q102 -127 240 -200t293 -73q194 0 359 110q-121 -108 -274.5 -168t-322.5 -60q-29 0 -43 1q-175 8 -333 82t-272 193t-181 281t-67 339 q0 182 71 348t191 286t286 191t348 71h3q168 -1 320.5 -60.5t273.5 -167.5zM1792 640q0 -192 -77 -362.5t-213 -296.5q-104 -63 -222 -63q-137 0 -255 84q154 56 253.5 233t99.5 405q0 227 -99 404t-253 234q119 83 254 83q119 0 226 -65q135 -125 210.5 -295t75.5 -361z " />
+<glyph unicode="&#xf26b;" horiz-adv-x="1792" d="M1792 599q0 -56 -7 -104h-1151q0 -146 109.5 -244.5t257.5 -98.5q99 0 185.5 46.5t136.5 130.5h423q-56 -159 -170.5 -281t-267.5 -188.5t-321 -66.5q-187 0 -356 83q-228 -116 -394 -116q-237 0 -237 263q0 115 45 275q17 60 109 229q199 360 475 606 q-184 -79 -427 -354q63 274 283.5 449.5t501.5 175.5q30 0 45 -1q255 117 433 117q64 0 116 -13t94.5 -40.5t66.5 -76.5t24 -115q0 -116 -75 -286q101 -182 101 -390zM1722 1239q0 83 -53 132t-137 49q-108 0 -254 -70q121 -47 222.5 -131.5t170.5 -195.5q51 135 51 216z M128 2q0 -86 48.5 -132.5t134.5 -46.5q115 0 266 83q-122 72 -213.5 183t-137.5 245q-98 -205 -98 -332zM632 715h728q-5 142 -113 237t-251 95q-144 0 -251.5 -95t-112.5 -237z" />
+<glyph unicode="&#xf26c;" horiz-adv-x="2048" d="M1792 288v960q0 13 -9.5 22.5t-22.5 9.5h-1600q-13 0 -22.5 -9.5t-9.5 -22.5v-960q0 -13 9.5 -22.5t22.5 -9.5h1600q13 0 22.5 9.5t9.5 22.5zM1920 1248v-960q0 -66 -47 -113t-113 -47h-736v-128h352q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-832q-14 0 -23 9t-9 23 v64q0 14 9 23t23 9h352v128h-736q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h1600q66 0 113 -47t47 -113z" />
+<glyph unicode="&#xf26d;" horiz-adv-x="1792" d="M138 1408h197q-70 -64 -126 -149q-36 -56 -59 -115t-30 -125.5t-8.5 -120t10.5 -132t21 -126t28 -136.5q4 -19 6 -28q51 -238 81 -329q57 -171 152 -275h-272q-48 0 -82 34t-34 82v1304q0 48 34 82t82 34zM1346 1408h308q48 0 82 -34t34 -82v-1304q0 -48 -34 -82t-82 -34 h-178q212 210 196 565l-469 -101q-2 -45 -12 -82t-31 -72t-59.5 -59.5t-93.5 -36.5q-123 -26 -199 40q-32 27 -53 61t-51.5 129t-64.5 258q-35 163 -45.5 263t-5.5 139t23 77q20 41 62.5 73t102.5 45q45 12 83.5 6.5t67 -17t54 -35t43 -48t34.5 -56.5l468 100 q-68 175 -180 287z" />
+<glyph unicode="&#xf26e;" d="M1401 -11l-6 -6q-113 -114 -259 -175q-154 -64 -317 -64q-165 0 -317 64q-148 63 -259 175q-113 112 -175 258q-42 103 -54 189q-4 28 48 36q51 8 56 -20q1 -1 1 -4q18 -90 46 -159q50 -124 152 -226q98 -98 226 -152q132 -56 276 -56q143 0 276 56q128 55 225 152l6 6 q10 10 25 6q12 -3 33 -22q36 -37 17 -58zM929 604l-66 -66l63 -63q21 -21 -7 -49q-17 -17 -32 -17q-10 0 -19 10l-62 61l-66 -66q-5 -5 -15 -5q-15 0 -31 16l-2 2q-18 15 -18 29q0 7 8 17l66 65l-66 66q-16 16 14 45q18 18 31 18q6 0 13 -5l65 -66l65 65q18 17 48 -13 q27 -27 11 -44zM1400 547q0 -118 -46 -228q-45 -105 -126 -186q-80 -80 -187 -126t-228 -46t-228 46t-187 126q-82 82 -125 186q-15 32 -15 40h-1q-9 27 43 44q50 16 60 -12q37 -99 97 -167h1v339v2q3 136 102 232q105 103 253 103q147 0 251 -103t104 -249 q0 -147 -104.5 -251t-250.5 -104q-58 0 -112 16q-28 11 -13 61q16 51 44 43l14 -3q14 -3 32.5 -6t30.5 -3q104 0 176 71.5t72 174.5q0 101 -72 171q-71 71 -175 71q-107 0 -178 -80q-64 -72 -64 -160v-413q110 -67 242 -67q96 0 185 36.5t156 103.5t103.5 155t36.5 183 q0 198 -141 339q-140 140 -339 140q-200 0 -340 -140q-53 -53 -77 -87l-2 -2q-8 -11 -13 -15.5t-21.5 -9.5t-38.5 3q-21 5 -36.5 16.5t-15.5 26.5v680q0 15 10.5 26.5t27.5 11.5h877q30 0 30 -55t-30 -55h-811v-483h1q40 42 102 84t108 61q109 46 231 46q121 0 228 -46 t187 -126q81 -81 126 -186q46 -112 46 -229zM1369 1128q9 -8 9 -18t-5.5 -18t-16.5 -21q-26 -26 -39 -26q-9 0 -16 7q-106 91 -207 133q-128 56 -276 56q-133 0 -262 -49q-27 -10 -45 37q-9 25 -8 38q3 16 16 20q130 57 299 57q164 0 316 -64q137 -58 235 -152z" />
+<glyph unicode="&#xf270;" horiz-adv-x="1792" d="M1551 60q15 6 26 3t11 -17.5t-15 -33.5q-13 -16 -44 -43.5t-95.5 -68t-141 -74t-188 -58t-229.5 -24.5q-119 0 -238 31t-209 76.5t-172.5 104t-132.5 105t-84 87.5q-8 9 -10 16.5t1 12t8 7t11.5 2t11.5 -4.5q192 -117 300 -166q389 -176 799 -90q190 40 391 135z M1758 175q11 -16 2.5 -69.5t-28.5 -102.5q-34 -83 -85 -124q-17 -14 -26 -9t0 24q21 45 44.5 121.5t6.5 98.5q-5 7 -15.5 11.5t-27 6t-29.5 2.5t-35 0t-31.5 -2t-31 -3t-22.5 -2q-6 -1 -13 -1.5t-11 -1t-8.5 -1t-7 -0.5h-5.5h-4.5t-3 0.5t-2 1.5l-1.5 3q-6 16 47 40t103 30 q46 7 108 1t76 -24zM1364 618q0 -31 13.5 -64t32 -58t37.5 -46t33 -32l13 -11l-227 -224q-40 37 -79 75.5t-58 58.5l-19 20q-11 11 -25 33q-38 -59 -97.5 -102.5t-127.5 -63.5t-140 -23t-137.5 21t-117.5 65.5t-83 113t-31 162.5q0 84 28 154t72 116.5t106.5 83t122.5 57 t130 34.5t119.5 18.5t99.5 6.5v127q0 65 -21 97q-34 53 -121 53q-6 0 -16.5 -1t-40.5 -12t-56 -29.5t-56 -59.5t-48 -96l-294 27q0 60 22 119t67 113t108 95t151.5 65.5t190.5 24.5q100 0 181 -25t129.5 -61.5t81 -83t45 -86t12.5 -73.5v-589zM692 597q0 -86 70 -133 q66 -44 139 -22q84 25 114 123q14 45 14 101v162q-59 -2 -111 -12t-106.5 -33.5t-87 -71t-32.5 -114.5z" />
+<glyph unicode="&#xf271;" horiz-adv-x="1792" d="M1536 1280q52 0 90 -38t38 -90v-1280q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h384v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h128zM1152 1376v-288q0 -14 9 -23t23 -9 h64q14 0 23 9t9 23v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM384 1376v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM1536 -128v1024h-1408v-1024h1408zM896 448h224q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-224 v-224q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v224h-224q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h224v224q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-224z" />
+<glyph unicode="&#xf272;" horiz-adv-x="1792" d="M1152 416v-64q0 -14 -9 -23t-23 -9h-576q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h576q14 0 23 -9t9 -23zM128 -128h1408v1024h-1408v-1024zM512 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1280 1088v288q0 14 -9 23 t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1664 1152v-1280q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h384v96q0 66 47 113t113 47h64q66 0 113 -47 t47 -113v-96h128q52 0 90 -38t38 -90z" />
+<glyph unicode="&#xf273;" horiz-adv-x="1792" d="M1111 151l-46 -46q-9 -9 -22 -9t-23 9l-188 189l-188 -189q-10 -9 -23 -9t-22 9l-46 46q-9 9 -9 22t9 23l189 188l-189 188q-9 10 -9 23t9 22l46 46q9 9 22 9t23 -9l188 -188l188 188q10 9 23 9t22 -9l46 -46q9 -9 9 -22t-9 -23l-188 -188l188 -188q9 -10 9 -23t-9 -22z M128 -128h1408v1024h-1408v-1024zM512 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1280 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1664 1152v-1280 q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h384v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h128q52 0 90 -38t38 -90z" />
+<glyph unicode="&#xf274;" horiz-adv-x="1792" d="M1303 572l-512 -512q-10 -9 -23 -9t-23 9l-288 288q-9 10 -9 23t9 22l46 46q9 9 22 9t23 -9l220 -220l444 444q10 9 23 9t22 -9l46 -46q9 -9 9 -22t-9 -23zM128 -128h1408v1024h-1408v-1024zM512 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23 t23 -9h64q14 0 23 9t9 23zM1280 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1664 1152v-1280q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47 t47 -113v-96h384v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h128q52 0 90 -38t38 -90z" />
+<glyph unicode="&#xf275;" horiz-adv-x="1792" d="M448 1536q26 0 45 -19t19 -45v-891l536 429q17 14 40 14q26 0 45 -19t19 -45v-379l536 429q17 14 40 14q26 0 45 -19t19 -45v-1152q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v1664q0 26 19 45t45 19h384z" />
+<glyph unicode="&#xf276;" horiz-adv-x="1024" d="M512 448q66 0 128 15v-655q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v655q61 -15 128 -15zM512 1536q212 0 362 -150t150 -362t-150 -362t-362 -150t-362 150t-150 362t150 362t362 150zM512 1312q14 0 23 9t9 23t-9 23t-23 9q-146 0 -249 -103t-103 -249 q0 -14 9 -23t23 -9t23 9t9 23q0 119 84.5 203.5t203.5 84.5z" />
+<glyph unicode="&#xf277;" horiz-adv-x="1792" d="M1745 1239q10 -10 10 -23t-10 -23l-141 -141q-28 -28 -68 -28h-1344q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h576v64q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-64h512q40 0 68 -28zM768 320h256v-512q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v512zM1600 768 q26 0 45 -19t19 -45v-256q0 -26 -19 -45t-45 -19h-1344q-40 0 -68 28l-141 141q-10 10 -10 23t10 23l141 141q28 28 68 28h512v192h256v-192h576z" />
+<glyph unicode="&#xf278;" horiz-adv-x="2048" d="M2020 1525q28 -20 28 -53v-1408q0 -20 -11 -36t-29 -23l-640 -256q-24 -11 -48 0l-616 246l-616 -246q-10 -5 -24 -5q-19 0 -36 11q-28 20 -28 53v1408q0 20 11 36t29 23l640 256q24 11 48 0l616 -246l616 246q32 13 60 -6zM736 1390v-1270l576 -230v1270zM128 1173 v-1270l544 217v1270zM1920 107v1270l-544 -217v-1270z" />
+<glyph unicode="&#xf279;" horiz-adv-x="1792" d="M512 1536q13 0 22.5 -9.5t9.5 -22.5v-1472q0 -20 -17 -28l-480 -256q-7 -4 -15 -4q-13 0 -22.5 9.5t-9.5 22.5v1472q0 20 17 28l480 256q7 4 15 4zM1760 1536q13 0 22.5 -9.5t9.5 -22.5v-1472q0 -20 -17 -28l-480 -256q-7 -4 -15 -4q-13 0 -22.5 9.5t-9.5 22.5v1472 q0 20 17 28l480 256q7 4 15 4zM640 1536q8 0 14 -3l512 -256q18 -10 18 -29v-1472q0 -13 -9.5 -22.5t-22.5 -9.5q-8 0 -14 3l-512 256q-18 10 -18 29v1472q0 13 9.5 22.5t22.5 9.5z" />
+<glyph unicode="&#xf27a;" horiz-adv-x="1792" d="M640 640q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1024 640q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1408 640q0 53 -37.5 90.5t-90.5 37.5 t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1792 640q0 -174 -120 -321.5t-326 -233t-450 -85.5q-110 0 -211 18q-173 -173 -435 -229q-52 -10 -86 -13q-12 -1 -22 6t-13 18q-4 15 20 37q5 5 23.5 21.5t25.5 23.5t23.5 25.5t24 31.5t20.5 37 t20 48t14.5 57.5t12.5 72.5q-146 90 -229.5 216.5t-83.5 269.5q0 174 120 321.5t326 233t450 85.5t450 -85.5t326 -233t120 -321.5z" />
+<glyph unicode="&#xf27b;" horiz-adv-x="1792" d="M640 640q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1024 640q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1408 640q0 -53 -37.5 -90.5t-90.5 -37.5 t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM896 1152q-204 0 -381.5 -69.5t-282 -187.5t-104.5 -255q0 -112 71.5 -213.5t201.5 -175.5l87 -50l-27 -96q-24 -91 -70 -172q152 63 275 171l43 38l57 -6q69 -8 130 -8q204 0 381.5 69.5t282 187.5 t104.5 255t-104.5 255t-282 187.5t-381.5 69.5zM1792 640q0 -174 -120 -321.5t-326 -233t-450 -85.5q-70 0 -145 8q-198 -175 -460 -242q-49 -14 -114 -22h-5q-15 0 -27 10.5t-16 27.5v1q-3 4 -0.5 12t2 10t4.5 9.5l6 9t7 8.5t8 9q7 8 31 34.5t34.5 38t31 39.5t32.5 51 t27 59t26 76q-157 89 -247.5 220t-90.5 281q0 130 71 248.5t191 204.5t286 136.5t348 50.5t348 -50.5t286 -136.5t191 -204.5t71 -248.5z" />
+<glyph unicode="&#xf27c;" horiz-adv-x="1024" d="M512 345l512 295v-591l-512 -296v592zM0 640v-591l512 296zM512 1527v-591l-512 -296v591zM512 936l512 295v-591z" />
+<glyph unicode="&#xf27d;" horiz-adv-x="1792" d="M1709 1018q-10 -236 -332 -651q-333 -431 -562 -431q-142 0 -240 263q-44 160 -132 482q-72 262 -157 262q-18 0 -127 -76l-77 98q24 21 108 96.5t130 115.5q156 138 241 146q95 9 153 -55.5t81 -203.5q44 -287 66 -373q55 -249 120 -249q51 0 154 161q101 161 109 246 q13 139 -109 139q-57 0 -121 -26q120 393 459 382q251 -8 236 -326z" />
+<glyph unicode="&#xf27e;" d="M0 1408h1536v-1536h-1536v1536zM1085 293l-221 631l221 297h-634l221 -297l-221 -631l317 -304z" />
+<glyph unicode="&#xf280;" d="M0 1408h1536v-1536h-1536v1536zM908 1088l-12 -33l75 -83l-31 -114l25 -25l107 57l107 -57l25 25l-31 114l75 83l-12 33h-95l-53 96h-32l-53 -96h-95zM641 925q32 0 44.5 -16t11.5 -63l174 21q0 55 -17.5 92.5t-50.5 56t-69 25.5t-85 7q-133 0 -199 -57.5t-66 -182.5v-72 h-96v-128h76q20 0 20 -8v-382q0 -14 -5 -20t-18 -7l-73 -7v-88h448v86l-149 14q-6 1 -8.5 1.5t-3.5 2.5t-0.5 4t1 7t0.5 10v387h191l38 128h-231q-6 0 -2 6t4 9v80q0 27 1.5 40.5t7.5 28t19.5 20t36.5 5.5zM1248 96v86l-54 9q-7 1 -9.5 2.5t-2.5 3t1 7.5t1 12v520h-275 l-23 -101l83 -22q23 -7 23 -27v-370q0 -14 -6 -18.5t-20 -6.5l-70 -9v-86h352z" />
+<glyph unicode="&#xf281;" horiz-adv-x="1792" d="M1792 690q0 -58 -29.5 -105.5t-79.5 -72.5q12 -46 12 -96q0 -155 -106.5 -287t-290.5 -208.5t-400 -76.5t-399.5 76.5t-290 208.5t-106.5 287q0 47 11 94q-51 25 -82 73.5t-31 106.5q0 82 58 140.5t141 58.5q85 0 145 -63q218 152 515 162l116 521q3 13 15 21t26 5 l369 -81q18 37 54 59.5t79 22.5q62 0 106 -43.5t44 -105.5t-44 -106t-106 -44t-105.5 43.5t-43.5 105.5l-334 74l-104 -472q300 -9 519 -160q58 61 143 61q83 0 141 -58.5t58 -140.5zM418 491q0 -62 43.5 -106t105.5 -44t106 44t44 106t-44 105.5t-106 43.5q-61 0 -105 -44 t-44 -105zM1228 136q11 11 11 26t-11 26q-10 10 -25 10t-26 -10q-41 -42 -121 -62t-160 -20t-160 20t-121 62q-11 10 -26 10t-25 -10q-11 -10 -11 -25.5t11 -26.5q43 -43 118.5 -68t122.5 -29.5t91 -4.5t91 4.5t122.5 29.5t118.5 68zM1225 341q62 0 105.5 44t43.5 106 q0 61 -44 105t-105 44q-62 0 -106 -43.5t-44 -105.5t44 -106t106 -44z" />
+<glyph unicode="&#xf282;" horiz-adv-x="1792" d="M69 741h1q16 126 58.5 241.5t115 217t167.5 176t223.5 117.5t276.5 43q231 0 414 -105.5t294 -303.5q104 -187 104 -442v-188h-1125q1 -111 53.5 -192.5t136.5 -122.5t189.5 -57t213 -3t208 46.5t173.5 84.5v-377q-92 -55 -229.5 -92t-312.5 -38t-316 53 q-189 73 -311.5 249t-124.5 372q-3 242 111 412t325 268q-48 -60 -78 -125.5t-46 -159.5h635q8 77 -8 140t-47 101.5t-70.5 66.5t-80.5 41t-75 20.5t-56 8.5l-22 1q-135 -5 -259.5 -44.5t-223.5 -104.5t-176 -140.5t-138 -163.5z" />
+<glyph unicode="&#xf283;" horiz-adv-x="2304" d="M0 32v608h2304v-608q0 -66 -47 -113t-113 -47h-1984q-66 0 -113 47t-47 113zM640 256v-128h384v128h-384zM256 256v-128h256v128h-256zM2144 1408q66 0 113 -47t47 -113v-224h-2304v224q0 66 47 113t113 47h1984z" />
+<glyph unicode="&#xf284;" horiz-adv-x="1792" d="M1549 857q55 0 85.5 -28.5t30.5 -83.5t-34 -82t-91 -27h-136v-177h-25v398h170zM1710 267l-4 -11l-5 -10q-113 -230 -330.5 -366t-474.5 -136q-182 0 -348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71q244 0 454.5 -124t329.5 -338l2 -4l8 -16 q-30 -15 -136.5 -68.5t-163.5 -84.5q-6 -3 -479 -268q384 -183 799 -366zM896 -234q250 0 462.5 132.5t322.5 357.5l-287 129q-72 -140 -206 -222t-292 -82q-151 0 -280 75t-204 204t-75 280t75 280t204 204t280 75t280 -73.5t204 -204.5l280 143q-116 208 -321 329 t-443 121q-119 0 -232.5 -31.5t-209 -87.5t-176.5 -137t-137 -176.5t-87.5 -209t-31.5 -232.5t31.5 -232.5t87.5 -209t137 -176.5t176.5 -137t209 -87.5t232.5 -31.5z" />
+<glyph unicode="&#xf285;" horiz-adv-x="1792" d="M1427 827l-614 386l92 151h855zM405 562l-184 116v858l1183 -743zM1424 697l147 -95v-858l-532 335zM1387 718l-500 -802h-855l356 571z" />
+<glyph unicode="&#xf286;" horiz-adv-x="1792" d="M640 528v224q0 16 -16 16h-96q-16 0 -16 -16v-224q0 -16 16 -16h96q16 0 16 16zM1152 528v224q0 16 -16 16h-96q-16 0 -16 -16v-224q0 -16 16 -16h96q16 0 16 16zM1664 496v-752h-640v320q0 80 -56 136t-136 56t-136 -56t-56 -136v-320h-640v752q0 16 16 16h96 q16 0 16 -16v-112h128v624q0 16 16 16h96q16 0 16 -16v-112h128v112q0 16 16 16h96q16 0 16 -16v-112h128v112q0 6 2.5 9.5t8.5 5t9.5 2t11.5 0t9 -0.5v391q-32 15 -32 50q0 23 16.5 39t38.5 16t38.5 -16t16.5 -39q0 -35 -32 -50v-17q45 10 83 10q21 0 59.5 -7.5t54.5 -7.5 q17 0 47 7.5t37 7.5q16 0 16 -16v-210q0 -15 -35 -21.5t-62 -6.5q-18 0 -54.5 7.5t-55.5 7.5q-40 0 -90 -12v-133q1 0 9 0.5t11.5 0t9.5 -2t8.5 -5t2.5 -9.5v-112h128v112q0 16 16 16h96q16 0 16 -16v-112h128v112q0 16 16 16h96q16 0 16 -16v-624h128v112q0 16 16 16h96 q16 0 16 -16z" />
+<glyph unicode="&#xf287;" horiz-adv-x="2304" d="M2288 731q16 -8 16 -27t-16 -27l-320 -192q-8 -5 -16 -5q-9 0 -16 4q-16 10 -16 28v128h-858q37 -58 83 -165q16 -37 24.5 -55t24 -49t27 -47t27 -34t31.5 -26t33 -8h96v96q0 14 9 23t23 9h320q14 0 23 -9t9 -23v-320q0 -14 -9 -23t-23 -9h-320q-14 0 -23 9t-9 23v96h-96 q-32 0 -61 10t-51 23.5t-45 40.5t-37 46t-33.5 57t-28.5 57.5t-28 60.5q-23 53 -37 81.5t-36 65t-44.5 53.5t-46.5 17h-360q-22 -84 -91 -138t-157 -54q-106 0 -181 75t-75 181t75 181t181 75q88 0 157 -54t91 -138h104q24 0 46.5 17t44.5 53.5t36 65t37 81.5q19 41 28 60.5 t28.5 57.5t33.5 57t37 46t45 40.5t51 23.5t61 10h107q21 57 70 92.5t111 35.5q80 0 136 -56t56 -136t-56 -136t-136 -56q-62 0 -111 35.5t-70 92.5h-107q-17 0 -33 -8t-31.5 -26t-27 -34t-27 -47t-24 -49t-24.5 -55q-46 -107 -83 -165h1114v128q0 18 16 28t32 -1z" />
+<glyph unicode="&#xf288;" horiz-adv-x="1792" d="M1150 774q0 -56 -39.5 -95t-95.5 -39h-253v269h253q56 0 95.5 -39.5t39.5 -95.5zM1329 774q0 130 -91.5 222t-222.5 92h-433v-896h180v269h253q130 0 222 91.5t92 221.5zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348 t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
+<glyph unicode="&#xf289;" horiz-adv-x="2304" d="M1645 438q0 59 -34 106.5t-87 68.5q-7 -45 -23 -92q-7 -24 -27.5 -38t-44.5 -14q-12 0 -24 3q-31 10 -45 38.5t-4 58.5q23 71 23 143q0 123 -61 227.5t-166 165.5t-228 61q-134 0 -247 -73t-167 -194q108 -28 188 -106q22 -23 22 -55t-22 -54t-54 -22t-55 22 q-75 75 -180 75q-106 0 -181 -74.5t-75 -180.5t75 -180.5t181 -74.5h1046q79 0 134.5 55.5t55.5 133.5zM1798 438q0 -142 -100.5 -242t-242.5 -100h-1046q-169 0 -289 119.5t-120 288.5q0 153 100 267t249 136q62 184 221 298t354 114q235 0 408.5 -158.5t196.5 -389.5 q116 -25 192.5 -118.5t76.5 -214.5zM2048 438q0 -175 -97 -319q-23 -33 -64 -33q-24 0 -43 13q-26 17 -32 48.5t12 57.5q71 104 71 233t-71 233q-18 26 -12 57t32 49t57.5 11.5t49.5 -32.5q97 -142 97 -318zM2304 438q0 -244 -134 -443q-23 -34 -64 -34q-23 0 -42 13 q-26 18 -32.5 49t11.5 57q108 164 108 358q0 195 -108 357q-18 26 -11.5 57.5t32.5 48.5q26 18 57 12t49 -33q134 -198 134 -442z" />
+<glyph unicode="&#xf28a;" d="M1500 -13q0 -89 -63 -152.5t-153 -63.5t-153.5 63.5t-63.5 152.5q0 90 63.5 153.5t153.5 63.5t153 -63.5t63 -153.5zM1267 268q-115 -15 -192.5 -102.5t-77.5 -205.5q0 -74 33 -138q-146 -78 -379 -78q-109 0 -201 21t-153.5 54.5t-110.5 76.5t-76 85t-44.5 83 t-23.5 66.5t-6 39.5q0 19 4.5 42.5t18.5 56t36.5 58t64 43.5t94.5 18t94 -17.5t63 -41t35.5 -53t17.5 -49t4 -33.5q0 -34 -23 -81q28 -27 82 -42t93 -17l40 -1q115 0 190 51t75 133q0 26 -9 48.5t-31.5 44.5t-49.5 41t-74 44t-93.5 47.5t-119.5 56.5q-28 13 -43 20 q-116 55 -187 100t-122.5 102t-72 125.5t-20.5 162.5q0 78 20.5 150t66 137.5t112.5 114t166.5 77t221.5 28.5q120 0 220 -26t164.5 -67t109.5 -94t64 -105.5t19 -103.5q0 -46 -15 -82.5t-36.5 -58t-48.5 -36t-49 -19.5t-39 -5h-8h-32t-39 5t-44 14t-41 28t-37 46t-24 70.5 t-10 97.5q-15 16 -59 25.5t-81 10.5l-37 1q-68 0 -117.5 -31t-70.5 -70t-21 -76q0 -24 5 -43t24 -46t53 -51t97 -53.5t150 -58.5q76 -25 138.5 -53.5t109 -55.5t83 -59t60.5 -59.5t41 -62.5t26.5 -62t14.5 -63.5t6 -62t1 -62.5z" />
+<glyph unicode="&#xf28b;" d="M704 352v576q0 14 -9 23t-23 9h-256q-14 0 -23 -9t-9 -23v-576q0 -14 9 -23t23 -9h256q14 0 23 9t9 23zM1152 352v576q0 14 -9 23t-23 9h-256q-14 0 -23 -9t-9 -23v-576q0 -14 9 -23t23 -9h256q14 0 23 9t9 23zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103 t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf28c;" d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM768 96q148 0 273 73t198 198t73 273t-73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273 t73 -273t198 -198t273 -73zM864 320q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-576q0 -14 -9 -23t-23 -9h-192zM480 320q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-576q0 -14 -9 -23t-23 -9h-192z" />
+<glyph unicode="&#xf28d;" d="M1088 352v576q0 14 -9 23t-23 9h-576q-14 0 -23 -9t-9 -23v-576q0 -14 9 -23t23 -9h576q14 0 23 9t9 23zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5 t103 -385.5z" />
+<glyph unicode="&#xf28e;" d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM768 96q148 0 273 73t198 198t73 273t-73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273 t73 -273t198 -198t273 -73zM480 320q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h576q14 0 23 -9t9 -23v-576q0 -14 -9 -23t-23 -9h-576z" />
+<glyph unicode="&#xf290;" horiz-adv-x="1792" d="M1757 128l35 -313q3 -28 -16 -50q-19 -21 -48 -21h-1664q-29 0 -48 21q-19 22 -16 50l35 313h1722zM1664 967l86 -775h-1708l86 775q3 24 21 40.5t43 16.5h256v-128q0 -53 37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5v128h384v-128q0 -53 37.5 -90.5t90.5 -37.5 t90.5 37.5t37.5 90.5v128h256q25 0 43 -16.5t21 -40.5zM1280 1152v-256q0 -26 -19 -45t-45 -19t-45 19t-19 45v256q0 106 -75 181t-181 75t-181 -75t-75 -181v-256q0 -26 -19 -45t-45 -19t-45 19t-19 45v256q0 159 112.5 271.5t271.5 112.5t271.5 -112.5t112.5 -271.5z" />
+<glyph unicode="&#xf291;" horiz-adv-x="2048" d="M1920 768q53 0 90.5 -37.5t37.5 -90.5t-37.5 -90.5t-90.5 -37.5h-15l-115 -662q-8 -46 -44 -76t-82 -30h-1280q-46 0 -82 30t-44 76l-115 662h-15q-53 0 -90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5h1792zM485 -32q26 2 43.5 22.5t15.5 46.5l-32 416q-2 26 -22.5 43.5 t-46.5 15.5t-43.5 -22.5t-15.5 -46.5l32 -416q2 -25 20.5 -42t43.5 -17h5zM896 32v416q0 26 -19 45t-45 19t-45 -19t-19 -45v-416q0 -26 19 -45t45 -19t45 19t19 45zM1280 32v416q0 26 -19 45t-45 19t-45 -19t-19 -45v-416q0 -26 19 -45t45 -19t45 19t19 45zM1632 27l32 416 q2 26 -15.5 46.5t-43.5 22.5t-46.5 -15.5t-22.5 -43.5l-32 -416q-2 -26 15.5 -46.5t43.5 -22.5h5q25 0 43.5 17t20.5 42zM476 1244l-93 -412h-132l101 441q19 88 89 143.5t160 55.5h167q0 26 19 45t45 19h384q26 0 45 -19t19 -45h167q90 0 160 -55.5t89 -143.5l101 -441 h-132l-93 412q-11 44 -45.5 72t-79.5 28h-167q0 -26 -19 -45t-45 -19h-384q-26 0 -45 19t-19 45h-167q-45 0 -79.5 -28t-45.5 -72z" />
+<glyph unicode="&#xf292;" horiz-adv-x="1792" d="M991 512l64 256h-254l-64 -256h254zM1759 1016l-56 -224q-7 -24 -31 -24h-327l-64 -256h311q15 0 25 -12q10 -14 6 -28l-56 -224q-5 -24 -31 -24h-327l-81 -328q-7 -24 -31 -24h-224q-16 0 -26 12q-9 12 -6 28l78 312h-254l-81 -328q-7 -24 -31 -24h-225q-15 0 -25 12 q-9 12 -6 28l78 312h-311q-15 0 -25 12q-9 12 -6 28l56 224q7 24 31 24h327l64 256h-311q-15 0 -25 12q-10 14 -6 28l56 224q5 24 31 24h327l81 328q7 24 32 24h224q15 0 25 -12q9 -12 6 -28l-78 -312h254l81 328q7 24 32 24h224q15 0 25 -12q9 -12 6 -28l-78 -312h311 q15 0 25 -12q9 -12 6 -28z" />
+<glyph unicode="&#xf293;" d="M841 483l148 -148l-149 -149zM840 1094l149 -149l-148 -148zM710 -130l464 464l-306 306l306 306l-464 464v-611l-255 255l-93 -93l320 -321l-320 -321l93 -93l255 255v-611zM1429 640q0 -209 -32 -365.5t-87.5 -257t-140.5 -162.5t-181.5 -86.5t-219.5 -24.5 t-219.5 24.5t-181.5 86.5t-140.5 162.5t-87.5 257t-32 365.5t32 365.5t87.5 257t140.5 162.5t181.5 86.5t219.5 24.5t219.5 -24.5t181.5 -86.5t140.5 -162.5t87.5 -257t32 -365.5z" />
+<glyph unicode="&#xf294;" horiz-adv-x="1024" d="M596 113l173 172l-173 172v-344zM596 823l173 172l-173 172v-344zM628 640l356 -356l-539 -540v711l-297 -296l-108 108l372 373l-372 373l108 108l297 -296v711l539 -540z" />
+<glyph unicode="&#xf295;" d="M1280 256q0 52 -38 90t-90 38t-90 -38t-38 -90t38 -90t90 -38t90 38t38 90zM512 1024q0 52 -38 90t-90 38t-90 -38t-38 -90t38 -90t90 -38t90 38t38 90zM1536 256q0 -159 -112.5 -271.5t-271.5 -112.5t-271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5t271.5 -112.5 t112.5 -271.5zM1440 1344q0 -20 -13 -38l-1056 -1408q-19 -26 -51 -26h-160q-26 0 -45 19t-19 45q0 20 13 38l1056 1408q19 26 51 26h160q26 0 45 -19t19 -45zM768 1024q0 -159 -112.5 -271.5t-271.5 -112.5t-271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5 t271.5 -112.5t112.5 -271.5z" />
+<glyph unicode="&#xf296;" horiz-adv-x="1792" d="M104 830l792 -1015l-868 630q-18 13 -25 34.5t0 42.5l101 308v0zM566 830h660l-330 -1015v0zM368 1442l198 -612h-462l198 612q8 23 33 23t33 -23zM1688 830l101 -308q7 -21 0 -42.5t-25 -34.5l-868 -630l792 1015v0zM1688 830h-462l198 612q8 23 33 23t33 -23z" />
+<glyph unicode="&#xf297;" horiz-adv-x="1792" d="M384 704h160v224h-160v-224zM1221 372v92q-104 -36 -243 -38q-135 -1 -259.5 46.5t-220.5 122.5l1 -96q88 -80 212 -128.5t272 -47.5q129 0 238 49zM640 704h640v224h-640v-224zM1792 736q0 -187 -99 -352q89 -102 89 -229q0 -157 -129.5 -268t-313.5 -111 q-122 0 -225 52.5t-161 140.5q-19 -1 -57 -1t-57 1q-58 -88 -161 -140.5t-225 -52.5q-184 0 -313.5 111t-129.5 268q0 127 89 229q-99 165 -99 352q0 209 120 385.5t326.5 279.5t449.5 103t449.5 -103t326.5 -279.5t120 -385.5z" />
+<glyph unicode="&#xf298;" d="M515 625v-128h-252v128h252zM515 880v-127h-252v127h252zM1273 369v-128h-341v128h341zM1273 625v-128h-672v128h672zM1273 880v-127h-672v127h672zM1408 20v1240q0 8 -6 14t-14 6h-32l-378 -256l-210 171l-210 -171l-378 256h-32q-8 0 -14 -6t-6 -14v-1240q0 -8 6 -14 t14 -6h1240q8 0 14 6t6 14zM553 1130l185 150h-406zM983 1130l221 150h-406zM1536 1260v-1240q0 -62 -43 -105t-105 -43h-1240q-62 0 -105 43t-43 105v1240q0 62 43 105t105 43h1240q62 0 105 -43t43 -105z" />
+<glyph unicode="&#xf299;" horiz-adv-x="1792" d="M896 720q-104 196 -160 278q-139 202 -347 318q-34 19 -70 36q-89 40 -94 32t34 -38l39 -31q62 -43 112.5 -93.5t94.5 -116.5t70.5 -113t70.5 -131q9 -17 13 -25q44 -84 84 -153t98 -154t115.5 -150t131 -123.5t148.5 -90.5q153 -66 154 -60q1 3 -49 37q-53 36 -81 57 q-77 58 -179 211t-185 310zM549 177q-76 60 -132.5 125t-98 143.5t-71 154.5t-58.5 186t-52 209t-60.5 252t-76.5 289q273 0 497.5 -36t379 -92t271 -144.5t185.5 -172.5t110 -198.5t56 -199.5t12.5 -198.5t-9.5 -173t-20 -143.5t-13 -107l323 -327h-104l-281 285 q-22 -2 -91.5 -14t-121.5 -19t-138 -6t-160.5 17t-167.5 59t-179 111z" />
+<glyph unicode="&#xf29a;" horiz-adv-x="1792" d="M1374 879q-6 26 -28.5 39.5t-48.5 7.5q-261 -62 -401 -62t-401 62q-26 6 -48.5 -7.5t-28.5 -39.5t7.5 -48.5t39.5 -28.5q194 -46 303 -58q-2 -158 -15.5 -269t-26.5 -155.5t-41 -115.5l-9 -21q-10 -25 1 -49t36 -34q9 -4 23 -4q44 0 60 41l8 20q54 139 71 259h42 q17 -120 71 -259l8 -20q16 -41 60 -41q14 0 23 4q25 10 36 34t1 49l-9 21q-28 71 -41 115.5t-26.5 155.5t-15.5 269q109 12 303 58q26 6 39.5 28.5t7.5 48.5zM1024 1024q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5z M1600 640q0 -143 -55.5 -273.5t-150 -225t-225 -150t-273.5 -55.5t-273.5 55.5t-225 150t-150 225t-55.5 273.5t55.5 273.5t150 225t225 150t273.5 55.5t273.5 -55.5t225 -150t150 -225t55.5 -273.5zM896 1408q-156 0 -298 -61t-245 -164t-164 -245t-61 -298t61 -298 t164 -245t245 -164t298 -61t298 61t245 164t164 245t61 298t-61 298t-164 245t-245 164t-298 61zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
+<glyph unicode="&#xf29b;" d="M1438 723q34 -35 29 -82l-44 -551q-4 -42 -34.5 -70t-71.5 -28q-6 0 -9 1q-44 3 -72.5 36.5t-25.5 77.5l35 429l-143 -8q55 -113 55 -240q0 -216 -148 -372l-137 137q91 101 91 235q0 145 -102.5 248t-247.5 103q-134 0 -236 -92l-137 138q120 114 284 141l264 300 l-149 87l-181 -161q-33 -30 -77 -27.5t-73 35.5t-26.5 77t34.5 73l239 213q26 23 60 26.5t64 -14.5l488 -283q36 -21 48 -68q17 -67 -26 -117l-205 -232l371 20q49 3 83 -32zM1240 1180q-74 0 -126 52t-52 126t52 126t126 52t126.5 -52t52.5 -126t-52.5 -126t-126.5 -52z M613 -62q106 0 196 61l139 -139q-146 -116 -335 -116q-148 0 -273.5 73t-198.5 198t-73 273q0 188 116 336l139 -139q-60 -88 -60 -197q0 -145 102.5 -247.5t247.5 -102.5z" />
+<glyph unicode="&#xf29c;" d="M880 336v-160q0 -14 -9 -23t-23 -9h-160q-14 0 -23 9t-9 23v160q0 14 9 23t23 9h160q14 0 23 -9t9 -23zM1136 832q0 -50 -15 -90t-45.5 -69t-52 -44t-59.5 -36q-32 -18 -46.5 -28t-26 -24t-11.5 -29v-32q0 -14 -9 -23t-23 -9h-160q-14 0 -23 9t-9 23v68q0 35 10.5 64.5 t24 47.5t39 35.5t41 25.5t44.5 21q53 25 75 43t22 49q0 42 -43.5 71.5t-95.5 29.5q-56 0 -95 -27q-29 -20 -80 -83q-9 -12 -25 -12q-11 0 -19 6l-108 82q-10 7 -12 20t5 23q122 192 349 192q129 0 238.5 -89.5t109.5 -214.5zM768 1280q-130 0 -248.5 -51t-204 -136.5 t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5t-51 248.5t-136.5 204t-204 136.5t-248.5 51zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5 t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf29d;" horiz-adv-x="1408" d="M366 1225q-64 0 -110 45.5t-46 110.5q0 64 46 109.5t110 45.5t109.5 -45.5t45.5 -109.5q0 -65 -45.5 -110.5t-109.5 -45.5zM917 583q0 -50 -30 -67.5t-63.5 -6.5t-47.5 34l-367 438q-7 12 -14 15.5t-11 1.5l-3 -3q-7 -8 4 -21l122 -139l1 -354l-161 -457 q-67 -192 -92 -234q-16 -26 -28 -32q-50 -26 -103 -1q-29 13 -41.5 43t-9.5 57q2 17 197 618l5 416l-85 -164l35 -222q4 -24 -1 -42t-14 -27.5t-19 -16t-17 -7.5l-7 -2q-19 -3 -34.5 3t-24 16t-14 22t-7.5 19.5t-2 9.5l-46 299l211 381q23 34 113 34q75 0 107 -40l424 -521 q7 -5 14 -17l3 -3l-1 -1q7 -13 7 -29zM514 433q43 -113 88.5 -225t69.5 -168l24 -55q36 -93 42 -125q11 -70 -36 -97q-35 -22 -66 -16t-51 22t-29 35h-1q-6 16 -8 25l-124 351zM1338 -159q31 -49 31 -57q0 -5 -3 -7q-9 -5 -14.5 0.5t-15.5 26t-16 30.5q-114 172 -423 661 q3 -1 7 1t7 4l3 2q11 9 11 17z" />
+<glyph unicode="&#xf29e;" horiz-adv-x="2304" d="M504 542h171l-1 265zM1530 641q0 87 -50.5 140t-146.5 53h-54v-388h52q91 0 145 57t54 138zM956 1018l1 -756q0 -14 -9.5 -24t-23.5 -10h-216q-14 0 -23.5 10t-9.5 24v62h-291l-55 -81q-10 -15 -28 -15h-267q-21 0 -30.5 18t3.5 35l556 757q9 14 27 14h332q14 0 24 -10 t10 -24zM1783 641q0 -193 -125.5 -303t-324.5 -110h-270q-14 0 -24 10t-10 24v756q0 14 10 24t24 10h268q200 0 326 -109t126 -302zM1939 640q0 -11 -0.5 -29t-8 -71.5t-21.5 -102t-44.5 -108t-73.5 -102.5h-51q38 45 66.5 104.5t41.5 112t21 98t9 72.5l1 27q0 8 -0.5 22.5 t-7.5 60t-20 91.5t-41 111.5t-66 124.5h43q41 -47 72 -107t45.5 -111.5t23 -96t10.5 -70.5zM2123 640q0 -11 -0.5 -29t-8 -71.5t-21.5 -102t-45 -108t-74 -102.5h-51q38 45 66.5 104.5t41.5 112t21 98t9 72.5l1 27q0 8 -0.5 22.5t-7.5 60t-19.5 91.5t-40.5 111.5t-66 124.5 h43q41 -47 72 -107t45.5 -111.5t23 -96t10.5 -70.5zM2304 640q0 -11 -0.5 -29t-8 -71.5t-21.5 -102t-44.5 -108t-73.5 -102.5h-51q38 45 66 104.5t41 112t21 98t9 72.5l1 27q0 8 -0.5 22.5t-7.5 60t-19.5 91.5t-40.5 111.5t-66 124.5h43q41 -47 72 -107t45.5 -111.5t23 -96 t9.5 -70.5z" />
+<glyph unicode="&#xf2a0;" horiz-adv-x="1408" d="M617 -153q0 11 -13 58t-31 107t-20 69q-1 4 -5 26.5t-8.5 36t-13.5 21.5q-15 14 -51 14q-23 0 -70 -5.5t-71 -5.5q-34 0 -47 11q-6 5 -11 15.5t-7.5 20t-6.5 24t-5 18.5q-37 128 -37 255t37 255q1 4 5 18.5t6.5 24t7.5 20t11 15.5q13 11 47 11q24 0 71 -5.5t70 -5.5 q36 0 51 14q9 8 13.5 21.5t8.5 36t5 26.5q2 9 20 69t31 107t13 58q0 22 -43.5 52.5t-75.5 42.5q-20 8 -45 8q-34 0 -98 -18q-57 -17 -96.5 -40.5t-71 -66t-46 -70t-45.5 -94.5q-6 -12 -9 -19q-49 -107 -68 -216t-19 -244t19 -244t68 -216q56 -122 83 -161q63 -91 179 -127 l6 -2q64 -18 98 -18q25 0 45 8q32 12 75.5 42.5t43.5 52.5zM776 760q-26 0 -45 19t-19 45.5t19 45.5q37 37 37 90q0 52 -37 91q-19 19 -19 45t19 45t45 19t45 -19q75 -75 75 -181t-75 -181q-21 -19 -45 -19zM957 579q-27 0 -45 19q-19 19 -19 45t19 45q112 114 112 272 t-112 272q-19 19 -19 45t19 45t45 19t45 -19q150 -150 150 -362t-150 -362q-18 -19 -45 -19zM1138 398q-27 0 -45 19q-19 19 -19 45t19 45q90 91 138.5 208t48.5 245t-48.5 245t-138.5 208q-19 19 -19 45t19 45t45 19t45 -19q109 -109 167 -249t58 -294t-58 -294t-167 -249 q-18 -19 -45 -19z" />
+<glyph unicode="&#xf2a1;" horiz-adv-x="2176" d="M192 352q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM704 352q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM704 864q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM1472 352 q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM1984 352q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM1472 864q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM1984 864 q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM1984 1376q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM384 192q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM896 192q0 -80 -56 -136 t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM384 704q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM896 704q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM384 1216q0 -80 -56 -136t-136 -56 t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1664 192q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM896 1216q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM2176 192q0 -80 -56 -136t-136 -56t-136 56 t-56 136t56 136t136 56t136 -56t56 -136zM1664 704q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM2176 704q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1664 1216q0 -80 -56 -136t-136 -56t-136 56t-56 136 t56 136t136 56t136 -56t56 -136zM2176 1216q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136z" />
+<glyph unicode="&#xf2a2;" horiz-adv-x="1792" d="M128 -192q0 -26 -19 -45t-45 -19t-45 19t-19 45t19 45t45 19t45 -19t19 -45zM320 0q0 -26 -19 -45t-45 -19t-45 19t-19 45t19 45t45 19t45 -19t19 -45zM365 365l256 -256l-90 -90l-256 256zM704 384q0 -26 -19 -45t-45 -19t-45 19t-19 45t19 45t45 19t45 -19t19 -45z M1411 704q0 -59 -11.5 -108.5t-37.5 -93.5t-44 -67.5t-53 -64.5q-31 -35 -45.5 -54t-33.5 -50t-26.5 -64t-7.5 -74q0 -159 -112.5 -271.5t-271.5 -112.5q-26 0 -45 19t-19 45t19 45t45 19q106 0 181 75t75 181q0 57 11.5 105.5t37 91t43.5 66.5t52 63q40 46 59.5 72 t37.5 74.5t18 103.5q0 185 -131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5q0 -26 -19 -45t-45 -19t-45 19t-19 45q0 117 45.5 223.5t123 184t184 123t223.5 45.5t223.5 -45.5t184 -123t123 -184t45.5 -223.5zM896 576q0 -26 -19 -45t-45 -19t-45 19t-19 45t19 45 t45 19t45 -19t19 -45zM1184 704q0 -26 -19 -45t-45 -19t-45 19t-19 45q0 93 -65.5 158.5t-158.5 65.5q-92 0 -158 -65.5t-66 -158.5q0 -26 -19 -45t-45 -19t-45 19t-19 45q0 146 103 249t249 103t249 -103t103 -249zM1578 993q10 -25 -1 -49t-36 -34q-9 -4 -23 -4 q-19 0 -35.5 11t-23.5 30q-68 178 -224 295q-21 16 -25 42t12 47q17 21 43 25t47 -12q183 -137 266 -351zM1788 1074q9 -25 -1.5 -49t-35.5 -34q-11 -4 -23 -4q-44 0 -60 41q-92 238 -297 393q-22 16 -25.5 42t12.5 47q16 22 42 25.5t47 -12.5q235 -175 341 -449z" />
+<glyph unicode="&#xf2a3;" horiz-adv-x="2304" d="M1032 576q-59 2 -84 55q-17 34 -48 53.5t-68 19.5q-53 0 -90.5 -37.5t-37.5 -90.5q0 -56 36 -89l10 -8q34 -31 82 -31q37 0 68 19.5t48 53.5q25 53 84 55zM1600 704q0 56 -36 89l-10 8q-34 31 -82 31q-37 0 -68 -19.5t-48 -53.5q-25 -53 -84 -55q59 -2 84 -55 q17 -34 48 -53.5t68 -19.5q53 0 90.5 37.5t37.5 90.5zM1174 925q-17 -35 -55 -48t-73 4q-62 31 -134 31q-51 0 -99 -17q3 0 9.5 0.5t9.5 0.5q92 0 170.5 -50t118.5 -133q17 -36 3.5 -73.5t-49.5 -54.5q-18 -9 -39 -9q21 0 39 -9q36 -17 49.5 -54.5t-3.5 -73.5 q-40 -83 -118.5 -133t-170.5 -50h-6q-16 2 -44 4l-290 27l-239 -120q-14 -7 -29 -7q-40 0 -57 35l-160 320q-11 23 -4 47.5t29 37.5l209 119l148 267q17 155 91.5 291.5t195.5 236.5q31 25 70.5 21.5t64.5 -34.5t21.5 -70t-34.5 -65q-70 -59 -117 -128q123 84 267 101 q40 5 71.5 -19t35.5 -64q5 -40 -19 -71.5t-64 -35.5q-84 -10 -159 -55q46 10 99 10q115 0 218 -50q36 -18 49 -55.5t-5 -73.5zM2137 1085l160 -320q11 -23 4 -47.5t-29 -37.5l-209 -119l-148 -267q-17 -155 -91.5 -291.5t-195.5 -236.5q-26 -22 -61 -22q-45 0 -74 35 q-25 31 -21.5 70t34.5 65q70 59 117 128q-123 -84 -267 -101q-4 -1 -12 -1q-36 0 -63.5 24t-31.5 60q-5 40 19 71.5t64 35.5q84 10 159 55q-46 -10 -99 -10q-115 0 -218 50q-36 18 -49 55.5t5 73.5q17 35 55 48t73 -4q62 -31 134 -31q51 0 99 17q-3 0 -9.5 -0.5t-9.5 -0.5 q-92 0 -170.5 50t-118.5 133q-17 36 -3.5 73.5t49.5 54.5q18 9 39 9q-21 0 -39 9q-36 17 -49.5 54.5t3.5 73.5q40 83 118.5 133t170.5 50h6h1q14 -2 42 -4l291 -27l239 120q14 7 29 7q40 0 57 -35z" />
+<glyph unicode="&#xf2a4;" horiz-adv-x="1792" d="M1056 704q0 -26 19 -45t45 -19t45 19t19 45q0 146 -103 249t-249 103t-249 -103t-103 -249q0 -26 19 -45t45 -19t45 19t19 45q0 93 66 158.5t158 65.5t158 -65.5t66 -158.5zM835 1280q-117 0 -223.5 -45.5t-184 -123t-123 -184t-45.5 -223.5q0 -26 19 -45t45 -19t45 19 t19 45q0 185 131.5 316.5t316.5 131.5t316.5 -131.5t131.5 -316.5q0 -55 -18 -103.5t-37.5 -74.5t-59.5 -72q-34 -39 -52 -63t-43.5 -66.5t-37 -91t-11.5 -105.5q0 -106 -75 -181t-181 -75q-26 0 -45 -19t-19 -45t19 -45t45 -19q159 0 271.5 112.5t112.5 271.5q0 41 7.5 74 t26.5 64t33.5 50t45.5 54q35 41 53 64.5t44 67.5t37.5 93.5t11.5 108.5q0 117 -45.5 223.5t-123 184t-184 123t-223.5 45.5zM591 561l226 -226l-579 -579q-12 -12 -29 -12t-29 12l-168 168q-12 12 -12 29t12 29zM1612 1524l168 -168q12 -12 12 -29t-12 -30l-233 -233 l-26 -25l-71 -71q-66 153 -195 258l91 91l207 207q13 12 30 12t29 -12z" />
+<glyph unicode="&#xf2a5;" d="M866 1021q0 -27 -13 -94q-11 -50 -31.5 -150t-30.5 -150q-2 -11 -4.5 -12.5t-13.5 -2.5q-20 -2 -31 -2q-58 0 -84 49.5t-26 113.5q0 88 35 174t103 124q28 14 51 14q28 0 36.5 -16.5t8.5 -47.5zM1352 597q0 14 -39 75.5t-52 66.5q-21 8 -34 8q-91 0 -226 -77l-2 2 q3 22 27.5 135t24.5 178q0 233 -242 233q-24 0 -68 -6q-94 -17 -168.5 -89.5t-111.5 -166.5t-37 -189q0 -146 80.5 -225t227.5 -79q25 0 25 -3t-1 -5q-4 -34 -26 -117q-14 -52 -51.5 -101t-82.5 -49q-42 0 -42 47q0 24 10.5 47.5t25 39.5t29.5 28.5t26 20t11 8.5q0 3 -7 10 q-24 22 -58.5 36.5t-65.5 14.5q-35 0 -63.5 -34t-41 -75t-12.5 -75q0 -88 51.5 -142t138.5 -54q82 0 155 53t117.5 126t65.5 153q6 22 15.5 66.5t14.5 66.5q3 12 14 18q118 60 227 60q48 0 127 -18q1 -1 4 -1q5 0 9.5 4.5t4.5 8.5zM1536 1120v-960q0 -119 -84.5 -203.5 t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf2a6;" horiz-adv-x="1535" d="M744 1231q0 24 -2 38.5t-8.5 30t-21 23t-37.5 7.5q-39 0 -78 -23q-105 -58 -159 -190.5t-54 -269.5q0 -44 8.5 -85.5t26.5 -80.5t52.5 -62.5t81.5 -23.5q4 0 18 -0.5t20 0t16 3t15 8.5t7 16q16 77 48 231.5t48 231.5q19 91 19 146zM1498 575q0 -7 -7.5 -13.5t-15.5 -6.5 l-6 1q-22 3 -62 11t-72 12.5t-63 4.5q-167 0 -351 -93q-15 -8 -21 -27q-10 -36 -24.5 -105.5t-22.5 -100.5q-23 -91 -70 -179.5t-112.5 -164.5t-154.5 -123t-185 -47q-135 0 -214.5 83.5t-79.5 219.5q0 53 19.5 117t63 116.5t97.5 52.5q38 0 120 -33.5t83 -61.5 q0 -1 -16.5 -12.5t-39.5 -31t-46 -44.5t-39 -61t-16 -74q0 -33 16.5 -53t48.5 -20q45 0 85 31.5t66.5 78t48 105.5t32.5 107t16 90v9q0 2 -3.5 3.5t-8.5 1.5h-10t-10 -0.5t-6 -0.5q-227 0 -352 122.5t-125 348.5q0 108 34.5 221t96 210t156 167.5t204.5 89.5q52 9 106 9 q374 0 374 -360q0 -98 -38 -273t-43 -211l3 -3q101 57 182.5 88t167.5 31q22 0 53 -13q19 -7 80 -102.5t61 -116.5z" />
+<glyph unicode="&#xf2a7;" horiz-adv-x="1664" d="M831 863q32 0 59 -18l222 -148q61 -40 110 -97l146 -170q40 -46 29 -106l-72 -413q-6 -32 -29.5 -53.5t-55.5 -25.5l-527 -56l-352 -32h-9q-39 0 -67.5 28t-28.5 68q0 37 27 64t65 32l260 32h-448q-41 0 -69.5 30t-26.5 71q2 39 32 65t69 26l442 1l-521 64q-41 5 -66 37 t-19 73q6 35 34.5 57.5t65.5 22.5h10l481 -60l-351 94q-38 10 -62 41.5t-18 68.5q6 36 33 58.5t62 22.5q6 0 20 -2l448 -96l217 -37q1 0 3 -0.5t3 -0.5q23 0 30.5 23t-12.5 36l-186 125q-35 23 -42 63.5t18 73.5q27 38 76 38zM761 661l186 -125l-218 37l-5 2l-36 38 l-238 262q-1 1 -2.5 3.5t-2.5 3.5q-24 31 -18.5 70t37.5 64q31 23 68 17.5t64 -33.5l142 -147l-4 -4t-5 -4q-32 -45 -23 -99t55 -85zM1648 1115l15 -266q4 -73 -11 -147l-48 -219q-12 -59 -67 -87l-106 -54q2 62 -39 109l-146 170q-53 61 -117 103l-222 148q-34 23 -76 23 q-51 0 -88 -37l-235 312q-25 33 -18 73.5t41 63.5q33 22 71.5 14t62.5 -40l266 -352l-262 455q-21 35 -10.5 75t47.5 59q35 18 72.5 6t57.5 -46l241 -420l-136 337q-15 35 -4.5 74t44.5 56q37 19 76 6t56 -51l193 -415l101 -196q8 -15 23 -17.5t27 7.5t11 26l-12 224 q-2 41 26 71t69 31q39 0 67 -28.5t30 -67.5z" />
+<glyph unicode="&#xf2a8;" horiz-adv-x="1792" d="M335 180q-2 0 -6 2q-86 57 -168.5 145t-139.5 180q-21 30 -21 69q0 9 2 19t4 18t7 18t8.5 16t10.5 17t10 15t12 15.5t11 14.5q184 251 452 365q-110 198 -110 211q0 19 17 29q116 64 128 64q18 0 28 -16l124 -229q92 19 192 19q266 0 497.5 -137.5t378.5 -369.5 q20 -31 20 -69t-20 -69q-91 -142 -218.5 -253.5t-278.5 -175.5q110 -198 110 -211q0 -20 -17 -29q-116 -64 -127 -64q-19 0 -29 16l-124 229l-64 119l-444 820l7 7q-58 -24 -99 -47q3 -5 127 -234t243 -449t119 -223q0 -7 -9 -9q-13 -3 -72 -3q-57 0 -60 7l-456 841 q-39 -28 -82 -68q24 -43 214 -393.5t190 -354.5q0 -10 -11 -10q-14 0 -82.5 22t-72.5 28l-106 197l-224 413q-44 -53 -78 -106q2 -3 18 -25t23 -34l176 -327q0 -10 -10 -10zM1165 282l49 -91q273 111 450 385q-180 277 -459 389q67 -64 103 -148.5t36 -176.5 q0 -106 -47 -200.5t-132 -157.5zM848 896q0 -20 14 -34t34 -14q86 0 147 -61t61 -147q0 -20 14 -34t34 -14t34 14t14 34q0 126 -89 215t-215 89q-20 0 -34 -14t-14 -34zM1214 961l-9 4l7 -7z" />
+<glyph unicode="&#xf2a9;" horiz-adv-x="1280" d="M1050 430q0 -215 -147 -374q-148 -161 -378 -161q-232 0 -378 161q-147 159 -147 374q0 147 68 270.5t189 196.5t268 73q96 0 182 -31q-32 -62 -39 -126q-66 28 -143 28q-167 0 -280.5 -123t-113.5 -291q0 -170 112.5 -288.5t281.5 -118.5t281 118.5t112 288.5 q0 89 -32 166q66 13 123 49q41 -98 41 -212zM846 619q0 -192 -79.5 -345t-238.5 -253l-14 -1q-29 0 -62 5q83 32 146.5 102.5t99.5 154.5t58.5 189t30 192.5t7.5 178.5q0 69 -3 103q55 -160 55 -326zM791 947v-2q-73 214 -206 440q88 -59 142.5 -186.5t63.5 -251.5z M1035 744q-83 0 -160 75q218 120 290 247q19 37 21 56q-42 -94 -139.5 -166.5t-204.5 -97.5q-35 54 -35 113q0 37 17 79t43 68q46 44 157 74q59 16 106 58.5t74 100.5q74 -105 74 -253q0 -109 -24 -170q-32 -77 -88.5 -130.5t-130.5 -53.5z" />
+<glyph unicode="&#xf2aa;" d="M1050 495q0 78 -28 147q-41 -25 -85 -34q22 -50 22 -114q0 -117 -77 -198.5t-193 -81.5t-193.5 81.5t-77.5 198.5q0 115 78 199.5t193 84.5q53 0 98 -19q4 43 27 87q-60 21 -125 21q-154 0 -257.5 -108.5t-103.5 -263.5t103.5 -261t257.5 -106t257.5 106.5t103.5 260.5z M872 850q2 -24 2 -71q0 -63 -5 -123t-20.5 -132.5t-40.5 -130t-68.5 -106t-100.5 -70.5q21 -3 42 -3h10q219 139 219 411q0 116 -38 225zM872 850q-4 80 -44 171.5t-98 130.5q92 -156 142 -302zM1207 955q0 102 -51 174q-41 -86 -124 -109q-69 -19 -109 -53.5t-40 -99.5 q0 -40 24 -77q74 17 140.5 67t95.5 115q-4 -52 -74.5 -111.5t-138.5 -97.5q52 -52 110 -52q51 0 90 37t60 90q17 43 17 117zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5 t84.5 -203.5z" />
+<glyph unicode="&#xf2ab;" d="M1279 388q0 22 -22 27q-67 15 -118 59t-80 108q-7 19 -7 25q0 15 19.5 26t43 17t43 20.5t19.5 36.5q0 19 -18.5 31.5t-38.5 12.5q-12 0 -32 -8t-31 -8q-4 0 -12 2q5 95 5 114q0 79 -17 114q-36 78 -103 121.5t-152 43.5q-199 0 -275 -165q-17 -35 -17 -114q0 -19 5 -114 q-4 -2 -14 -2q-12 0 -32 7.5t-30 7.5q-21 0 -38.5 -12t-17.5 -32q0 -21 19.5 -35.5t43 -20.5t43 -17t19.5 -26q0 -6 -7 -25q-64 -138 -198 -167q-22 -5 -22 -27q0 -46 137 -68q2 -5 6 -26t11.5 -30.5t23.5 -9.5q12 0 37.5 4.5t39.5 4.5q35 0 67 -15t54 -32.5t57.5 -32.5 t76.5 -15q43 0 79 15t57.5 32.5t53.5 32.5t67 15q14 0 39.5 -4t38.5 -4q16 0 23 10t11 30t6 25q137 22 137 68zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5 t103 -385.5z" />
+<glyph unicode="&#xf2ac;" horiz-adv-x="1664" d="M848 1408q134 1 240.5 -68.5t163.5 -192.5q27 -58 27 -179q0 -47 -9 -191q14 -7 28 -7q18 0 51 13.5t51 13.5q29 0 56 -18t27 -46q0 -32 -31.5 -54t-69 -31.5t-69 -29t-31.5 -47.5q0 -15 12 -43q37 -82 102.5 -150t144.5 -101q28 -12 80 -23q28 -6 28 -35 q0 -70 -219 -103q-7 -11 -11 -39t-14 -46.5t-33 -18.5q-20 0 -62 6.5t-64 6.5q-37 0 -62 -5q-32 -5 -63 -22.5t-58 -38t-58 -40.5t-76 -33.5t-99 -13.5q-52 0 -96.5 13.5t-75 33.5t-57.5 40.5t-58 38t-62 22.5q-26 5 -63 5q-24 0 -65.5 -7.5t-58.5 -7.5q-25 0 -35 18.5 t-14 47.5t-11 40q-219 33 -219 103q0 29 28 35q52 11 80 23q78 32 144.5 101t102.5 150q12 28 12 43q0 28 -31.5 47.5t-69.5 29.5t-69.5 31.5t-31.5 52.5q0 27 26 45.5t55 18.5q15 0 48 -13t53 -13q18 0 32 7q-9 142 -9 190q0 122 27 180q64 137 172 198t264 63z" />
+<glyph unicode="&#xf2ad;" d="M1280 388q0 22 -22 27q-67 14 -118 58t-80 109q-7 14 -7 25q0 15 19.5 26t42.5 17t42.5 20.5t19.5 36.5q0 19 -18.5 31.5t-38.5 12.5q-11 0 -31 -8t-32 -8q-4 0 -12 2q5 63 5 115q0 78 -17 114q-36 78 -102.5 121.5t-152.5 43.5q-198 0 -275 -165q-18 -38 -18 -115 q0 -38 6 -114q-10 -2 -15 -2q-11 0 -31.5 8t-30.5 8q-20 0 -37.5 -12.5t-17.5 -32.5q0 -21 19.5 -35.5t42.5 -20.5t42.5 -17t19.5 -26q0 -11 -7 -25q-64 -138 -198 -167q-22 -5 -22 -27q0 -47 138 -69q2 -5 6 -26t11 -30.5t23 -9.5q13 0 38.5 5t38.5 5q35 0 67.5 -15 t54.5 -32.5t57.5 -32.5t76.5 -15q43 0 79 15t57.5 32.5t54 32.5t67.5 15q13 0 39 -4.5t39 -4.5q15 0 22.5 9.5t11.5 31t5 24.5q138 22 138 69zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960 q119 0 203.5 -84.5t84.5 -203.5z" />
+<glyph unicode="&#xf2ae;" horiz-adv-x="2304" d="M2304 1536q-69 -46 -125 -92t-89 -81t-59.5 -71.5t-37.5 -57.5t-22 -44.5t-14 -29.5q-10 -18 -35.5 -136.5t-48.5 -164.5q-15 -29 -50 -60.5t-67.5 -50.5t-72.5 -41t-48 -28q-47 -31 -151 -231q-341 14 -630 -158q-92 -53 -303 -179q47 16 86 31t55 22l15 7 q71 27 163 64.5t133.5 53.5t108 34.5t142.5 31.5q186 31 465 -7q1 0 10 -3q11 -6 14 -17t-3 -22l-194 -345q-15 -29 -47 -22q-128 24 -354 24q-146 0 -402 -44.5t-392 -46.5q-82 -1 -149 13t-107 37t-61 40t-33 34l-1 1v2q0 6 6 6q138 0 371 55q192 366 374.5 524t383.5 158 q5 0 14.5 -0.5t38 -5t55 -12t61.5 -24.5t63 -39.5t54 -59t40 -82.5l102 177q2 4 21 42.5t44.5 86.5t61 109.5t84 133.5t100.5 137q66 82 128 141.5t121.5 96.5t92.5 53.5t88 39.5z" />
+<glyph unicode="&#xf2b0;" d="M1322 640q0 -45 -5 -76l-236 14l224 -78q-19 -73 -58 -141l-214 103l177 -158q-44 -61 -107 -108l-157 178l103 -215q-61 -37 -140 -59l-79 228l14 -240q-38 -6 -76 -6t-76 6l14 238l-78 -226q-74 19 -140 59l103 215l-157 -178q-59 43 -108 108l178 158l-214 -104 q-39 69 -58 141l224 79l-237 -14q-5 42 -5 76q0 35 5 77l238 -14l-225 79q19 73 58 140l214 -104l-177 159q46 61 107 108l158 -178l-103 215q67 39 140 58l77 -224l-13 236q36 6 75 6q38 0 76 -6l-14 -237l78 225q74 -19 140 -59l-103 -214l158 178q61 -47 107 -108 l-177 -159l213 104q37 -62 58 -141l-224 -78l237 14q5 -31 5 -77zM1352 640q0 160 -78.5 295.5t-213 214t-292.5 78.5q-119 0 -227 -46.5t-186.5 -125t-124.5 -187.5t-46 -229q0 -119 46 -228t124.5 -187.5t186.5 -125t227 -46.5q158 0 292.5 78.5t213 214t78.5 294.5z M1425 1023v-766l-657 -383l-657 383v766l657 383zM768 -183l708 412v823l-708 411l-708 -411v-823zM1536 1088v-896l-768 -448l-768 448v896l768 448z" />
+<glyph unicode="&#xf2b1;" horiz-adv-x="1664" d="M339 1318h691l-26 -72h-665q-110 0 -188.5 -79t-78.5 -189v-771q0 -95 60.5 -169.5t153.5 -93.5q23 -5 98 -5v-72h-45q-140 0 -239.5 100t-99.5 240v771q0 140 99.5 240t239.5 100zM1190 1536h247l-482 -1294q-23 -61 -40.5 -103.5t-45 -98t-54 -93.5t-64.5 -78.5 t-79.5 -65t-95.5 -41t-116 -18.5v195q163 26 220 182q20 52 20 105q0 54 -20 106l-285 733h228l187 -585zM1664 978v-1111h-795q37 55 45 73h678v1038q0 85 -49.5 155t-129.5 99l25 67q101 -34 163.5 -123.5t62.5 -197.5z" />
+<glyph unicode="&#xf2b2;" horiz-adv-x="1792" d="M852 1227q0 -29 -17 -52.5t-45 -23.5t-45 23.5t-17 52.5t17 52.5t45 23.5t45 -23.5t17 -52.5zM688 -149v114q0 30 -20.5 51.5t-50.5 21.5t-50 -21.5t-20 -51.5v-114q0 -30 20.5 -52t49.5 -22q30 0 50.5 22t20.5 52zM860 -149v114q0 30 -20 51.5t-50 21.5t-50.5 -21.5 t-20.5 -51.5v-114q0 -30 20.5 -52t50.5 -22q29 0 49.5 22t20.5 52zM1034 -149v114q0 30 -20.5 51.5t-50.5 21.5t-50.5 -21.5t-20.5 -51.5v-114q0 -30 20.5 -52t50.5 -22t50.5 22t20.5 52zM1208 -149v114q0 30 -20.5 51.5t-50.5 21.5t-50.5 -21.5t-20.5 -51.5v-114 q0 -30 20.5 -52t50.5 -22t50.5 22t20.5 52zM1476 535q-84 -160 -232 -259.5t-323 -99.5q-123 0 -229.5 51.5t-178.5 137t-113 197.5t-41 232q0 88 21 174q-104 -175 -104 -390q0 -162 65 -312t185 -251q30 57 91 57q56 0 86 -50q32 50 87 50q56 0 86 -50q32 50 87 50t87 -50 q30 50 86 50q28 0 52.5 -15.5t37.5 -40.5q112 94 177 231.5t73 287.5zM1326 564q0 75 -72 75q-17 0 -47 -6q-95 -19 -149 -19q-226 0 -226 243q0 86 30 204q-83 -127 -83 -275q0 -150 89 -260.5t235 -110.5q111 0 210 70q13 48 13 79zM884 1223q0 50 -32 89.5t-81 39.5 t-81 -39.5t-32 -89.5q0 -51 31.5 -90.5t81.5 -39.5t81.5 39.5t31.5 90.5zM1513 884q0 96 -37.5 179t-113 137t-173.5 54q-77 0 -149 -35t-127 -94q-48 -159 -48 -268q0 -104 45.5 -157t147.5 -53q53 0 142 19q36 6 53 6q51 0 77.5 -28t26.5 -80q0 -26 -4 -46 q75 68 117.5 165.5t42.5 200.5zM1792 667q0 -111 -33.5 -249.5t-93.5 -204.5q-58 -64 -195 -142.5t-228 -104.5l-4 -1v-114q0 -43 -29.5 -75t-72.5 -32q-56 0 -86 50q-32 -50 -87 -50t-87 50q-30 -50 -86 -50q-55 0 -87 50q-30 -50 -86 -50q-47 0 -75 33.5t-28 81.5 q-90 -68 -198 -68q-118 0 -211 80q54 1 106 20q-113 31 -182 127q32 -7 71 -7q89 0 164 46q-192 192 -240 306q-24 56 -24 160q0 57 9 125.5t31.5 146.5t55 141t86.5 105t120 42q59 0 81 -52q19 29 42 54q2 3 12 13t13 16q10 15 23 38t25 42t28 39q87 111 211.5 177 t260.5 66q35 0 62 -4q59 64 146 64q83 0 140 -57q5 -5 5 -12q0 -5 -6 -13.5t-12.5 -16t-16 -17l-10.5 -10.5q17 -6 36 -18t19 -24q0 -6 -16 -25q157 -138 197 -378q25 30 60 30q45 0 100 -49q90 -80 90 -279z" />
+<glyph unicode="&#xf2b3;" d="M917 631q0 33 -6 64h-362v-132h217q-12 -76 -74.5 -120.5t-142.5 -44.5q-99 0 -169 71.5t-70 170.5t70 170.5t169 71.5q93 0 153 -59l104 101q-108 100 -257 100q-160 0 -272 -112.5t-112 -271.5t112 -271.5t272 -112.5q165 0 266.5 105t101.5 270zM1262 585h109v110 h-109v110h-110v-110h-110v-110h110v-110h110v110zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+<glyph unicode="&#xf2b4;" d="M1536 1024v-839q0 -48 -49 -62q-174 -52 -338 -52q-73 0 -215.5 29.5t-227.5 29.5q-164 0 -370 -48v-338h-160v1368q-63 25 -101 81t-38 124q0 91 64 155t155 64t155 -64t64 -155q0 -68 -38 -124t-101 -81v-68q190 44 343 44q99 0 198 -15q14 -2 111.5 -22.5t149.5 -20.5 q77 0 165 18q11 2 80 21t89 19q26 0 45 -19t19 -45z" />
+<glyph unicode="&#xf2b5;" horiz-adv-x="1792" />
+<glyph unicode="&#xf2b6;" horiz-adv-x="1792" />
+<glyph unicode="&#xf2b7;" horiz-adv-x="1792" />
+<glyph unicode="&#xf2b8;" horiz-adv-x="1792" />
+<glyph unicode="&#xf2b9;" horiz-adv-x="1792" />
+<glyph unicode="&#xf2ba;" horiz-adv-x="1792" />
+<glyph unicode="&#xf2bb;" horiz-adv-x="1792" />
+<glyph unicode="&#xf2bc;" horiz-adv-x="1792" />
+<glyph unicode="&#xf2bd;" horiz-adv-x="1792" />
+<glyph unicode="&#xf2be;" horiz-adv-x="1792" />
+<glyph unicode="&#xf500;" horiz-adv-x="1792" />
+</font>
+</defs></svg> 
\ No newline at end of file
diff --git a/clones/llthw.common-lisp.dev/gitbook/fonts/fontawesome/fontawesome-webfont.ttf?v=4.6.3 b/clones/llthw.common-lisp.dev/gitbook/fonts/fontawesome/fontawesome-webfont.ttf?v=4.6.3
new file mode 100644
index 0000000000000000000000000000000000000000..f221e50a2ef60738ba30932d834530cdfe55cb3e
GIT binary patch
literal 152796
zcmd4434B!5**|{Ix!dgfl1wJaOfpLr43K1!u!SM)5H>+kKny5~;DQQ*xQ$9xkh*|U
zYO6-ARJ!uEwZGOD-)Y}g-!4+yTD$r7jcu)c>r$Y7ZH3I`|9#G#NhSfbeSh!g|Nleg
z-gE9f_uR8Q=Q+=QB_>IdOUg;I)HiF^vIQI7oY;aZZ{ru8J!9r9{u4=&BxXTAwrJ_t
z)_YpF*CXG6eBUKkt=aVG*v+pXe~%=|{PH!|Z#s1fHA%{D+_zkQ<&BqB@BdK_`G+K4
z{rmOn)?DiPx%4}U*KNc7j`g_UmTjLv{t)ts^;d1)wyYui4DzVcmb>zrOV;rFXY@+^
zoMp)GziQ34O|pweCEiKxi(S3us&(VPxT9L)T@Jke=1tdJzd88gWLe^q(4NZPt?Sla
z_L)P=+a<mX^+_6j)LZF?Q=a@0oqw=s@;EyGbj8XRamR&B1znLi@{E59NAw;!RIl~2
z2PBpHrnDh{mwD#bqtac-pY`9S8?U=w%1W{SMgvZvlqOzf9*PgeL=NLdV<$z61qP9$
z_C_Uz4dA>PwWw0N6qEX;gVGnIuShRQzlhmlV`CS`>*{Li`jUf3T}Nw<b{}1MboJ4z
zkKTIpzN3#F{ld{N9X)dNH%H$+Y8-PNt2x$ktozu)W2=u{eeBj__Z@re*cXmHf9%My
z-yD1Qm~q^7yykfK@rB1%AHVwet;g>>{@C#^9Dn}5CCsTL-uleYTcr_im5zFj#*b!?
zE<W0Kbkot?(Fcz9A3bz5fAr;}14oY@la6_g#g2_TmOZxkSl_Wt$8yIWIM#pc(6Rin
zmyZn`J9=C??l~Smo;|+!c;E3&$8*OYINpE!5WV%(?@nEM>Y`H@o?3Ql`l;3d`+vUq
zpI`gUd;f9rKc4$lttaZK@>F^%JYi4B6Z8Z;evi-N^(Y?M!#&I+xlg$bcfmdAKIuN;
ze&79f_ut&_x&Pb!SNC7s$KA)=N8NvRzvF(}{g(Sr?*DTC(fy|T5AHXdG~fT9{9}O4
z(yJLk8~w`v;U<B`{~!M8T7^Z8SZ$SOZ451$|KUFdSmXG=3H|k8P-ID$q|UfEE_>tN
z0hTwin|S{wHFjc?CY=!PC=Hv)jHh9|=#->ArRJn+WCA+###=)Htv+6tYVT-^ds!;e
z-p$(Ltu;)0s=06v%SKYE$Y73+EL*szInfYSbK!=BI;$SH3sR~*g+CybZO!%JDvPB`
zOcmZC;T_G$cmpn8*TUPod0T7PtB%aJcXYCjw$_j)%~*f=ip$r}!0DVTmKR25Q#Eqd
z;c4hnV<-Dt7d8ij%?mHZDa|Y2DNHKAAir4KW&={{A_zena%h7t#nE|>6r&$QSL@OY
zheV2dd>x6H67mHx3?U_Fyl>oRyw7xYovin^cO;C1Uw-X=<K*FMt~tz9R>Rc8*WApO
zCpii*-7IY6+Iv&%{F{eMTyxksdH-u)HV!5QNS?~+gcKvv6lsAZCB2%i=q}!j0b%J>
zGL`lQLKy1~?_}O0V-B=nARG$UD3f?=x7^v$+08n==Hz6&G(8xoTr6q)^|7|>RpS^N
zcU89SG2^evnBS@9oqncj4$FzG)4%syFKZL)I$Hva1zI}mCTcH#tK*{F>YfwXp4F>+
z)O^qCm@Fk~j_hb2H-7xM<{d|B5(UZW_bUzDXZ2cas^9s{=KW8r<0DC*FBuuHKE1#B
z!M>AtZgr1Bb(nKZeaiv=N(zRwMaiIrtu;K{En`AyOyx(~eT4^X^}UnF8Ux+8U$Z!o
zSbWXx-2=uOg$Hv!zQU5Y_|p5PzxMa$x!FV_JGc4oul>gxg=fsVKaaT^km`^@MSfIA
z^OjU`1b}w>2~0ba{*KnLU&WY2jEB!>!GJ$#Of{xrLWBH#<Dtqf_TKCM$^O^bdtLI4
zp@{LA;n1DIYRB7eJF0`4i~W_YtqLZsbJ>fHjmCtzR$3zjH|D#o1ie<4v}5w+q*`jn
z*_)wU%UX>UhYuSoSnFK2o!!V@6zys}d$V|eHFmRGjXS!HpBpP*d{MTQn%VjRt)w;r
zvN86xQW{WIgpl@bmBzo77Fvxed9+x{(-Bj1du|-ucjF#C80(m|Zi=;M=|}GR$kHC`
zly$Q@VnN-=zixc{_19VVo!joccUxxNmP;?5-q4(B#$Utqi!a@>PJYw8|GFgEX-(<$
zUN_!6R+=g;k}j66k#3XjmmZhCC`oFjJ=M(Wv}zUzO=1A+56LrcdrClkaT%~t<xk6h
zNcj(Y-{{4}a;b>GY-c$rQYuoA2=&Q04kA}7sFpoxAU#~_!|KE`d|xai4GSq-sxQSJ
zIa9I_;dpT>V$e|;E^=}>DVG;9hOeKw!skwicdKF%i;YO&$kKcgwibIq3Efl@!o=QC
z%755>S?X;!r1sw4b}o*?X*qYcJ6s|(+S|_P$bVRt87$9?xFd<hD)3LK?ZdDr0TqZ=
zPhlp~^p47pzW=|SAN@Wqbu}3IhOVv#mZjrxn&--Mg%P=t_eSPEsAPGKEGAw{2lk7h
zWMMcd4=2m6mL<<zpsX^JbHFw`3NQSx&%!@Gsw&2NP>i&UKA#*h`Xld^m-`=%)rg^x
zm~^A$((YEiB!#e>VDHkky0MI<+NUyXR#qHpnRa)yFy@}<;^;lbzG##ZEX5z7ynKAI
zxD~yJZJ>NKYW$Kvh%%`6>QnEkK4p(o4^}YXW?Eg^io;k`-Dw?Je<+|^nd%cY8^1Ds
zW!A(}NEP44QpMVTg{$H{XS-`YLA99lj7d|~V{e>+y&3DO**w&xrZDWywBjZKZR5}y
zs%F@Tz-$Q0OTv;oBju$?e&>MS39@AXB*<`b1U)uCb2fU651jTSRq}^2BJJ4?^Up%0
zmG{Xlg(dL2qj14L*8W1Cn$FRZf2P%<)BkWwP1+=<fwGnwr3_I<TvKA8V>9i(&W=zx
zr0FiSUQhtoNYgD0^kX>WBb;qwaH6xfA2EJ!{JZh{Bio<Y(|kp3%-yth<C0y6Up~BR
z$;P!!?pW=Hraey-a=q(&@yBzYq>|f@u;?eh%6hJfxtg1<h|PQT#`P$Ur`F&2>b%$$
zP0g;@RmSstUP0h-PDi4pK==y!x13&(k^*K*kkT4TqIIAd#12D1GdfSLFTa0UUh=u}
zE}uBC+&`D@D?RAD&JanKMNP*GBF!nyt{bG2OQuWg_z96wDO02sF(1Htx^y-2?WsB~
z5Nag|!ur%PBLU1vJ=UnE<3IHR%QdajLP({Ff(3n#OD&9+4G=_U>1rFWL<i`9v5ab2
zDBKCs8k_-<)h?!oYQc^u(!N*r?R$mq^Ekfl57f`GS*sohIb6HOjP*G6>fgA6EIPjN
zqc*q8ersB{xaat)T>r=E@z|epRW?kwStAdIoX(Mj@3Xp{j@uKWaKw$mJVbBU$FBN~
zBgCT}$<_-T5nJ*;>y=^mJ*`o%^J|{qMyvh04x7_q53a0i9bd(RPEod{Wx^7N!{$uf
zZ`)X2*tWIJ;xY@5i}Ik@JBqZdxsOkhrc0Ltwnxo6*v1i1FgouC{~M?wzO|dNI7T<F
z>8gM<JZKUyMeNiT$EXu0Rm*VTfF3cYIIy#%bAvgTTb8r3+g0de`Ek0<_&1v_U*mK2
zt?n5FJ=I4L!ZNem3u%8}=$^$gE}tAL10&a2(uErND}%j&d2dpgx5di2^<gw*uy^T=
zTb9aS6HWVcvb{a|X#zL!CJ_wSWvVRs#rhXrL&uBsS;opjod7gI7j}j;!5VSb0Hq>6
z4tm4jVnMAMxl^FIA}PkF@~P}UyDd)HX({v;dL0g@rQ5=7{7111Vt*Bj>DM;SV@3>x
zb42K}0j4naD<j3H&9icyPb>VZg>maVTa|?`k3@d>Z!{Lh`md5403sQZ0{~z7(Q@ot
zfZE{De3+zJSog+LX_kT<f^b0Gt9~=u(A984&?<7Sp)b0FZL>Ly7ai;pqpzW>ASpYd
zeGMmbL`P{^6phX>?x}XL362v!1v@?K7lIFZx4AY0*nh^D5JiAs?oi;S3E4=V78Y|c
zPYsK8NFEMs3ZVdG0x}SZi4g|GB(VNHCyZa5*t6#ZYdFEKJ7PR;tTrA$a)hm6PqH=g
zfH4F^1PcWNrBGHp!7nZ^dgO?h$5u(w7Xm$c0qqjY$SsW6CS49{A>x}@pdLbjG%gc&
zq{|wF1a&|cj3Bp;kc%irm;(hvVMs5QSFnKdIcI=XFrVYE4j+H7rI2;{SOAxeqqrVm
zK4&4@5@AnR5&^apSKPRA07cv=!j=XS7WPDhM-_%$%<nYvio@dpSL}B(i7uSNac)Pq
z67Wa;&OFU>-ihSNx4VT57<2*VSqEpBgsekK6menc>>n}h;ZW;TT74{}6CJ}+KyUG)
zfFlTjlxj+q7)h2=?FRr3m}pGxkMExN$%*%{mm9i_Z+L5stgpjoWNW?NCME$g!6PxL
z>41<&nNleh8>Y1H>FT<ti+dZZjjZ3#^3{!LmKUs5R=}wVD-}{g&;X#@itU;N9#w!!
z&<m*sF9J(9^Q4qAcv1Rn#<%Phb|de$SVDQRa4<$c9D<oWdrpHI-sf-_-?Ca+*5eN_
zf*Y67@8hjykaqYq&^bd}ffq5j<`!v6M~Kp7XK(B3vKHFdR5Y7q-9P!jralxf`l*4e
z&*ySD*i@_4$a~oPAJA0DC<wU&#+_p2$06{N<1#j{csNdbe37f{^qbf?><`JO*kmTN
zR|=C~!HG@2m}PliDslpds`6c1CL(7e8QZ&+JS*E|cGU222hTrg)X*fd-*!*o4V86u
zm4#nSDH|iVR7DaJqQk|e3pTd117mZRWv}$d3IlGh#}kXiYkBMg7d?M^p3lfzE&e3W
zCH+3Xk^jL5t$H?ukDwi)2}A$Wsi`bgU+3bW+1grZzXz_a0mq;Wi6`4y73}>W?Ev6L
zw#n<Q-SyD-O2pUJSLW&-mwl&|S*|j^|G8mOZ7=h0yaN!fN=7!4YDm}Y+F2y=)?aMn
z)?JoL+l~i`sAF9$dSv@G>u$#)8lo>j&m^STXk|d>QoJq!f@N3$0L}y3tZ1xQ7Nvy^
z{svtcqI0G&pA;8uZw;w$vaGS*cz2KS=Z&}fu{<NR^87nze`U>Gf1G7+0ysMTmDE36
zMfZvqUv&DXu}7GH4-0I(1COx*l^cIGzI^p%xBJa1QtkeoJ#+53&U<OtFZ=0nT-mkL
zyx`QCgDpVU{3!xO3ms15QAu`H<YG!YLu)8Aib5ToAH^Yv@}-@H2n#A-p7)QET9t-u
zNT!lA83AH}&XiJce^A_$F;HhqqY#OHO-b+wSug7ws`xKwNEOa>arj!HO%@Lg=25w_
zpj-$n*0_=r^lvT3F%GT+BJ3h`7b*G-Y2=6#3}HDF$tq_{Om~b~*d}I)HFU{Re#5?f
z8;pTMo)A3;y3c=&S&YAbE#F0OnJw}WUa3>S<q*OH5#0d@L!PMW7G7Uxiil~Q6U_{g
zxlIT}@%F43-0b`f^VNK1)z2T9a?7fF=jM&0UQZ-d8=Uy|*Ec?QYpS*5wu_cJBPmsy
zlRD|5@l=kd=49s2-%?O3t6ZDMw2#?iO-1-0VqsVHwuzJcP3=ttU|8S4cQh9BsfBJ1
z!oLVdG|xnARO5%moN4EvFnBOfOWXMnX=bAEDa0di^s1<u&~lRlUk~lPV3<mseM8-h
z>O&A0f64gyq3RiRH_RTscfrok*8`L98er|Lm$eVv#djTeXncI>#u(vl!Oys2vnM+)
zUi%Q!KKV)G#6xQ@c1)fv?wSN@Y~#}S_=gUBj8(j}efvwsAI*NnWJwtS4JYsxw(BCj
z*%rq}6Oyr4`;9LfCj=hW*a9q7rT-+YaJB&JG>2Vzfw=|=USdj4)OF68YlD=4CK3bC
zEw{JG7#-q!&h!qJJ8zcF9Z6Nx)m6|h6>-~Uo#DlXZ~vW9HCYv`4pz3zXsN`xDyf1x
zh1vo*`Rkao+34Fj(p+idKhq{`|HYOHJq`G6!Mus~mfZt~2SD_BIBt{9=b!BnJMS~Q
zosOzhx+^em>C$<Du5>Embna%KF@EX<n5Okwy(Mweu3a}JT96bsfBKJ)LZ@-WC`?jQ
zk#wNi-SO1dp6YN{2hxE4NnbVEjoVh@P9m&0mCDFU=3%YOvocbNY&d};D<xPJfXOGA
zCq1Mcw4Wa`lq%>3>Y*KI6KgeCpYh`t$B%(iq5pJdNU-8{@NSuUZ@o7jY|GGf`p<Is
zC+EO=5!*pODEo0dB^7c?4i|FBh;t!VKnn`uk}Tm`ZjiCtn0SWadLhSihPY00W<14F
zM3(3>{iq8bI*7gD^nRov=`#B=3HlDHt=`+_|G)T6#lKi=b#3jV`0MVzwYGMu_<MBf
zRQ%m4{#H+&dU*9}DmHbhnmcj3dfWf#NAqIt=?|-KA+3|fcSuH2q=>*ll(r#|MJx~G
zIDdn3L(&MQ+cU{RCY6C)zCV*o@gF1=JKdabWHU)4kWBI)CUY6q-`<-^6*`E>0u)H6
z9@aM&-vtTP2fs}<+W_tlI1vg&R!{i)!&<>|qH&3q8un_ETA0fW`~&SnZ_wyyEgr(l
z`1ey8v)Qs_1D|*!+PqA<6gDIh@g%_Az;WqRC)Cp&sm^Xrf*MMYL~UdOx3sVh_NBG-
zoUUQd0s98lI~`Jqb!#QrP6|~PS-G;jc6md{c*lSJw83=??vGZ4G=@EqJAztxj73(t
z9F>Dj3ey!Oq4>ut%)+@Vq*=U9e;}TQ)Y!@2pSL(<yqlPP(cmYl>~>qlHu)3P9Tql5
z=c$wLC=M6zb5<%rBntgVtUv9FQa54F;0@X38y8NWthBf+Rhm6eWlL>L*%~bNIxVrO
z&f20n>($7Xl%?Kk2}CT8WISCNVw!B-G;i>Rtux)8s#&!W`PZR(cMa{Af?6<$S}>Cs
zQozN>R0(4YT`_Bg5Q3xtLJS5$1;iC55MsYpc87!UbUN;@99M75HfATrn)x7X4y?|u
zx)Xn^>vCFR>>1;NIOSC<@<J6vxI8EJUm18QAWepl)I=si?h`M8BB=m{$l9dPXsZ$1
zbCLTb`de^%4A^H7zkY}ua!Sr*L?Ku<X_o<~|Jp^MV|YIV6#JtM*+thf;3t;rYUnSR
zyl2+vbNcZ#u7HK^Uvw>xk+5PvgcqlzYsFg0={dnO$05&^Br?N*5eA5aav8}a0y%=N
zS|*utbdNmu-Gc|;Jtz+l$#fz|$ALEgx(t^x>-=qn%ZDZ3av#bae3#GNw_#9}lX1Lf
z{OsA|?>U(xLkH820WSxQRT@8CT8vqeTR}K=rto$J+V)8hLHa{J%p92~-~iGlSO<b%
z(LwmPc0=)t%`K^cs;QCNNJ>dJwR(;J>@)EnP4K6d4}PDAd&ae;9PhA-`5BA+QhZON
z`~2#F+rP`Lv8hJ3*Z5Ofxs!!0L90{kK9?EYk#*5Ysa~1!iT^dxl9U(AKQ_7*UKqS#
zk#4v7)3tm(f5oL6v4zIRFRuHKiRU=n)mqB0_!N(eHP=T~?9Vob#q-3sWj@h(r!rLQ
z1Gkp8`T`c0iK~Di0h2*s_%+a?huUJ^_H+w)FCCo=Xf;e0v?IC(vQiI-J_iH_=vF4P
zj0a`MvW^6h7StSaFyNAP01r+8DvS(op4Y>+HCD~+xp?lxxlzWMMQfUV?)J596EEG|
z)4JHg3cu&>-3i^UsSw~KGA(VYvX=e+&hX06tdHEhsw;lZvhK_yFU{KW_%o}<92&F1
zxY`|Ki>~V#Gdb>6Y?)WuEnDYZ#9!4TQ#UW0b;YEpv-SIJRU0BLgPT?>6>djOGCDTc
zs>-i6Tbx!^VN1E6MJ6u0Wq$ke2@_)#^)Ebp>EoBpjA|jVK647K&k2$g6ezB<Bf`>|
z7M|`T))YvObPGCqsBs)gBCY9|Uv!k_*{gjl5p}Zd8(77Zg?@kh3%5)hx9+1+)m3wU
z(&Espyy`|T4?%puywAu^d$YZIb9C2?wy)iK9#8w~dvxB;?e&#TyDDGKt*UC}=~i3P
z?H?PT=zOT~`ZDX<bI)`8l&UeEa)3h;YQpLXw6{vS1vA$gB6S#vJ0Yz>n@H7$CX!$T
zpbBP{rU*-@8^TVc2s||%<QPx4$kYd7Tf+gE0cj=RMtuo_Uq}mq{5!nuoWzC%<J4VP
z@ZfQ;_Hx`8xHT{lKVN+D;_}S<Kkjh6h&fB#pI}L?#vXK8nv{UT)pT`bwd`>+&EeOp
zx%ZORg)u8rRMpn-OhT3GdX3*t!z{|)3$Lv3Ym6(h{bTWM0e?+A(&Wk|BTq)~msF%u
zYEV*6Rbg%!Q=N9kHVrJUb}3_)Sr^V^7OTt|Q<Np0s|#Ow!gI}>c(B>iU~{<{5BS=c
zwJH{IHL>&7v4_@e;Z@;iKyg&KoLevF5g!9nOk*qy-NqW}VF+-G<Csvwp;3dF!A4me
zL`a$;gg@&zcJp@7zeL+(vo9Y>MrK2#EWy%g!9Zu?flvUOFc`Wt)SF~bR0BhVV7xtr
zXP1~`I}5^BX=^-OKCmvESDjLG>*6b$tPBh8jN__XWmxoJ#1#9-8vp7s$5yRzOzzAo
zk%*G*oa}JART<``D%2sPt}1j@y$xf|AqS6@4f%pu%&Bp%s7pHcw|Bnq<eW1Pxo7hi
z@BW;uS6lRXbCz_djw-uj>v}QfCr+iubjZQ3pxiMg9Zb~Lb6#JY2%hnx;9W+^GlXWX
zT<$PhPVr%R9Wti(!LFquFsMqAu>Yh)ITc3|u$~Y(4M%Y=NB0yQ^CCqDcG-s{|6gji
zX|5=vF{0g~Q7VqYQb*)Cj{n>39&MlSVfm5cT|V07V~y*g#sBn3|3hQ_VQn0Je{`FN
z;iVjQ%G3YUD1V@wZnWl@+D2k;Q=`)w8l68AyqA|BeSdUcN9UOY#RrkKXE|uNe?r_-
zvrhksveF~(l$R<`4-D1Iu0K<9@GnDGmEi(qSI_*I(8G_y6^lUOfe<Ex4B%H`f&0&n
z#%ZII^E+KuV*m<`m=%IE75Vou4t}R5ntf6n6>+6JJzPc}ATtVjJW2=uhxV+jzY-J;
zr}wca_ZK8S<Ve>4>pu2T2ZdD7g(j*8|Jg3`BT=fsG!;S0u!>QkLs@6eoWztB`zS%e
zLh~m$s8XLwY<xAN=?sT-DGj-i&$#N~)<Smc!Gl|Qe(OQD*H`6mrb$55<W>D_?}5^t
zgIk|wd;BW20H$0Fyb0(l9lkF$QVXsL-lU@yELDbKAi>LmOA)*+UYrUOFb#<Xp(o32
z>ff}fU)gjb$Flt#)WrLuqgoa{-CJ$}sd%X1rUFdY^P(t=`JE@Jm{Y+cv6Ez}*rSlu
zq9k}c$TBuc8aTX4Xd0z>XIc-o1z9^NbOx#&JPX)vw9g9}ECa7jmJ}hjaphYpbNq&o
zO)vab$C20Q9jt#aZ}h2eB@Y;V2NE5b)LTiE+L)93LsZHZqEg>C`Udl?pATe`2U!2p
zsnnk!=@9g%pqF*XyGBSkT);<IQ$px1n+6(eU)*@eGj+~Xx3M?Q#;|AD7`bRyAzd|V
z@I*Y7ip$!pt6pJaj91LMi#8>YxF)@ILOne~IW0Xz+GY8nQEKQuC2K0=__5RVhG;WQ
zteOYEL$X(JI&wNyCrJ7rj8;05q$ekn6d4Qv<S;dI7}gO1Rvn7!3i!Mz<kta+e;`GB
z#kjzDWr=p}g;z(dt?g}==+zfqt1V%<M4UCpJHsANxHI0&;t5F2pMAwZzg~Ip4(n6*
z{_>(4_~Bgi%X^=)-e#^>?eBmw4KOxA>Xzo9Rpx9;Da>W4llg(*%b<$vUqG0Ha4ds9
zAb*hiAz4hhjtQsv4#?X!@88_VrI^=v(i`)#)k_X;9R&Oz+$v|McEFg!G2Z11hsbzi
zb&m`Xvu525eJob!GX|7ZtBiqFu#ejxWqqiotB>c0>M8u_d9#+S2P<`t7u9H*X#}#m
z=T;|b@$i?R#Xwa&x{AeCMNtdbX#q2&9{|7KEUgf$x2$X9g}pqu5V8U&tt<45M91Nf
z-_%{gzAmO~{*YMpWNqKAlcgPjID}>aHCO7Qbjs<EEa<Xnn@YX&MI#=6@Es#3R)4>7
z`1-Bq$YG1(vDrcsn(Fmn{iKE0?0R-XKTt-*&vJfVZxl-X^gFB6NS#vZ<*R<1v%+Js
zve%3p@I_Pp&Yi}gu$?<yb(i<;=o-JQZ}HM;6VoAqU{IvJ)c4yk*JFj%;7DXqoK~`l
zI(=dZlcE1&pCY!dXhB)t-Juz^Ic136%IDPP)U?2xgFmV0sW8s1sJI$urt`aTy1Ig|
zHojfzqB)f|J~WjErqU)`*eiIpf_*_eP+`1}N2wB;PX_)7=n?Zd9XVky074{AMgk&3
z8!NG+almkCmn9WYoETKva>b+(iwdn7Wpv4ZN`meLGHR$!C`kucoP%f;Nk8ZhXhFqo
zN>U!TVQ)@J{>VR9-aqnfqCYu-)5tHVL&%`e2RNt*8p{-tk!Y%;Q~s$x67d%%T9sjY
zc*Uw-?{`E_WFrngf5B=itPq@opj-<p>=v_rA!CPE#mM^4@)}X7qf;At+v)G*FZd&;
zy?NqUnt;NNNMWLA%l4wI5KdaBwS^`}^ix}E_7m=0=&c|9@<&w5sD7Gn!)y#!FZz13
zdYig~JSHIF6!eE!qw7z+9FE7s>bNjpQ>bwUB5FPoa3Yl;m=gPn!2M(kM>~8Ojxe>H
zW$4hf36N-<$w^=k{F*V8Q?q0?0p3j<%hL27f?Z%DtVj3hZy`&A;qoKu8Gcs7vlzSZ
zP}jncpHdHjxY1ipKZk~nzd%EWfuZ5U&=G{7!wzIEcK(7$VB~Pq5#cY`tV8ve;N-OW
z={2NEB?+l%@uHpajTR`bM9*<hEoXl_nsI=J$?PycV6&DtMvPNwO^j^I=td0nxBR^$
z`#b7I=q!2BN*cVj04GpL`c0%D=A4xgQ`A`(MzIKEw8qpIhNmdS&nXRYr0@r5TqWw!
zDICr5eB{(4$^rEcpqL~p51E$ZCe<&tN@Z{19q#x05710R0Ofx`;(%ZIY2ls1J0fXb
z!gVTR*0}<8URJEr6up%hp#uz*rKpOk@pC_F5tX9?zL(xWZ{qlG7NCM+EJ`p*x<d&Y
z8+HRwmgbI#4WE39U?gTb7Qs-kb%ep5lBX_<!Ka?nD2NOV2Fs2jlz28rk^ys=Mn1!u
zN0CnDYZ7y0wyV^d)7wzy2Xw}_n&5HTTgumdv(THik7Z;k0HJ1mom&XYK>Co)fG&=q
zHdxS+Ob(l3Ic=!i;(zv8zkh|lDnf}!6_Tf4VRw!i5%$;z6)#r6j+}LD!otRjS_?89
zWTj{;@BxwIu$3D&tW*`>O3b^l{<k=;gh}-VY9p`p4UTG&To?7B>BbemMQ?mjFf#i9
zOtrpwquM|^#}Y1^D9r-J49Fp%Dfyr=NNvF!XdnyG8q+8Qdosk?r4rbGq2)-FwUW#~
z^TNcDtb(sOu>3DMcX)^H@K`hPy7qDN8^%q&LX>EZ$Lc25R<hiv*7uj5_VF)Vu<zWT
zRroH|95X5^+T*E~P;|@m1Xb>z;`ar|kDWJVRF|aTJ`wLVvDBxc8Ijp+kP*ct(b@qs
zi4k2MVVNkwOu1yt+SezH_|Ukr4)W6)-|zBqiAo}2<i*J+--nEu{MP994zH21@CTHJ
z{Xih)9g@*NeE`}BjR)d}1_^_1+Qh(KTa>~5p|W@mRFWyzf$m|bES^Ih%IB}5rF&KE
zi7Ul&y7GzG=nL%nROJ5TTTh7lPrQ}9pB@->ftwiO3{MYL$Ho9roaOOieS{B(=ZkRH
zB#eM?`Vj|m{DBPHR7n)M6E{|FpyO;dh;#SYBDS47aoA&{GfpG&FO^wco@P|azIWz_
zhAOH2AS1;QeJR>alamn<vt|!W%}U^`29$e^6|}s6<@aBPGwcv?yv)D-gPP2Lif7=^
zD@uw-=vgwf{s0r|p)vmmJOO>ePZ%ZySmE7V6*iRsD&R%aKc?vCt;UuYTs!-(`QD!M
z2P^qs?tU6<v>Jn%)9>I9^E)zl0!rv&)i3copSY{wzHs@TAAFM^U%6-Sp(mlBe8Kpw
zaD=I06InH-FwL+_%YcrWFU61n^w!6*_W}0_xf<DPcL?zVs3K^eG-+CUA<L4f)O<2Q
zC~ScV#l55tnV(7-zvlV&X|PPm%r}0OxH8d;d%K09!md<mUTOmhkXadUT}I6p-$%3-
z`IZnj0cwF(3oNq4L<x>i%_j?6((P?&)X$QIZ2Pon?L2S%8t+fFXHxv$B+quBNHRGe
zFJQ^}8N8jP@OC^<*iujL%K*2|SF=(anNr7wNH25aFLo2iUYn1a$WQB6qAJl5RK@SD
z@9aQVlRWbQZK1Z(TB3J8i+AQqzTc(61pHCAh6upo*y5$sOW3Mx!AMbprFz@pfy7cY
ze)E$&k9(VGJW0kgKbbUsg|UXaDdr-DzT>Slt~t=0dGZq|@^Tp<SQk7<!b0y$HVQlq
zN2^X>ybVn-`89(WvVpaq`1rMJyX#fe>-IQwhg-fa^CbV?0Jt(P!2{lpQbdk8YCF!`
z(!Z{AhE{KN2fWq@cFO7lFW$xW5+#CC<upK;Xdr3{5XBG=0CG(%KjI58?<Km6&<kcB
zLbt!zjITU^mlZ8xA7H(}9M{QVH01%~E0ng`STB_z16=k_M3f&g$ffcqK3CY`(gP?T
z5f7jUnge>(dFrF;U)1X%^&%SWEbTa3yM-0s85(kycJu5R8^ZUVvDwr<%wy3Wjeu9I
z$01-HS|LLKgb`C=uVM6cHRRz?&?h_$`bCDpZbK%|+0(9y^2K*?Nri!k;Gx93N^8)p
z_hgnTR8WbiNz@BlRwfbeN&FLe@YTTi!Ue;Lp=PR@>9%tYG^A5OI)&At_9i=E0|FmE
zRsDWTRU{j^yv2A=K)Uf>%jL*dwJ;l!<}GG37lEyK%Xp9d0Z&|w+aEVx65iHrAIBqC
z<NhO$l<u%Lx?{XFbf<i8BOV2kLs)Ran$h%>A!@js){_10X}SO!)o&8&d@MQ092p{y
z_?LW8p9BIp__)tzbG_!W*$@)s>n^`KnhrVn=jUDifb)50z|St@S2;9`MROGP+T7q;
zA<D!*;NC3!3qs(Q=Mk0Ug`FYv5+P6)9jr}gm;)iWpb!b&)@u5UVW>?e8We^pGZ&Fh
zu((K)CYBqFTKkQBBASmTjIMvXHPVck<iF@@XpY?S?FM!T1XWkVNla{?pr*cd(Vcf*
zv~fx<H)SKG*w<XXuXM3j@_A!SS7lX|yzYtGuEkyWt9=5sf}-j(Ar0mbS(oq5=k8qa
z^wSG)@)7@E)L{e>S%KurFe8Cf5Iq9vN|t9ZHi1>XCYdro5Lzynrhr-^OWAIqCt-q0
z=4uN5pfu<3q=|gac<p!FvFIy;RjUI#nf}!XPX$_xw|@QVz(c#-d%~Wv&E3^CO#v^r
z$a43*?kKk||Jd_ab$;c`UwSxgO9$%G73rxlj|{t}OAg*0tN^yESna=gJ<~2;J79eK
zsw>B;^Rm6!P^4OMX->U<LB~YDGQ-xEx&9}QZ%z2zvNfHwrM+S6svVn!j05Wiax*t9
zL?!akqv<erFW86&1kz21g@9891`nre6w)OPYt~Ll;}`YyEgC;vVJmj;T+wOfdSo-#
zFLVcVQ2YybT(oq~oRw{TImQ~7ZNB|;YfD#F-%-3mLk{|l#$Cz5A1f|VkepN+Mk11s
zhr^E(z%J&3CZZKg8Q=ssPQ!h&PUyfntmXE<F~y7tGv$r_A7Kx&SJ;DvXQP2zz8r0c
zZa+UDUm4hKqzlK5^zJ}lH~S^*!+*J(XW!nk{>HCU(3!8_xPHsqFa6~&d_qI?%eMrg
z(ZKoJji1b@|AX-s3%yZ4qy7yRGXC@i$<0soqpbs=dn(~+HC;LnklzUlx^~#;_(r!g
zN$oT#5|A1wX0|xqDm+R_#_tC&1oI=5Bfk@X7@SZ$L1^>lh0E8XFQ4W+hkL>9W>*-i
zHjKCV9NRr(?mu=xAn<Ya0&`xtvcu+6BZ->0>`6X$2dl8Kd>}n*pRwgP^Il<B+<5(`
zr(XQU3E%tZ)ci*3r(y7`hr9V_oqx07IDDaJ7OI^;?H4<1du!if9`72D1AaB!W{kV{
zjaK&FIXh<6WtV*J`5nG@zxn0sH)X#BR)glw1AKZ^z*C$c3cLP?;3OF)o<kO%z_H*c
zq+z8lu#(gMn%!B%N={j-PkJZSosjA#d6V_B<efZg@)JNzeit3s4)z0wZnx_$qtoVe
z%7;$mrcSM{tE(o{-P%L~_#Xe%E7dC{`1}EVyAjN$I3G|`357;8Ba?q}1_EH!GC1>#
zbXdibSNq0fd!Oi6y*b^X$ZpN}FQbrAoqbjpcUun++Bvf!t?_R&*-%_Ex940Q{_+0a
zyxP~E?|q^$$M5RXnCxVOM&a9DSD%&J2M_BWr(=zkW#DBMw!kAe=Tsl>@6FOqMlq8x
zmZ#f6lQlP4KrfQ6hukl2T5%^wogv*8*4^UzknpC6k8!V5zH`*QGJh~|g+uIKd?*FP
zoP#sp0PBM*QQqhuo#q4LdXA1T6h}!Ijf;}Q4mBt<bRDLeNJG<DLKY0sNluX8dOKWa
zpbui^30Fi(7Ryp~@F8KbL5am!-aO+fkFgkOD~$mh2R|>0prJ987`nXRq(oICI$duc
z>16uMW3OcHuUOCO0JxY=*o8{)6>m|nhZfmi!ZbwZBMVJni<a)_tWnx%WQZE}4c&}m
zE5H(Vfx8}hluXxPo;*~VKQehisHUxL{+I#Uxdu+C8vOW3pB>xKwW7VZwWobz)udt(
z@`f(C`caWn(zu0_n<`>0)s54qEWc>m46}|=7fVkmwX2>zr*lqYwGfjGx}f&XL+zbs
zOx9iDx|S*Fi@qZ6V?%`Nq`b9Mpl0&amhP*1R%}~*ep_5TJmQL39OH&{Mfw+@Ln2K<
zkbp$jRN$~wI+N;1(H^LFQfP#3hD}q^rK85Bf1Ne|1>?l{Y2GSDR+$a{gZj8&V?~Yq
z(P!^F%6h;0SN2J{#rTx*%g<WAINfD|#UfKYiW@N%Etzmv%bbP_nYQnacRsi7v*x^E
zrKmYbzS@KrZ!jRJqS8(VNk@&0C|;%fhfDLnYdm4hF`oD?$a9Dt#!f!BrK#oI$z#nd
z1s@`pZ8JxKiH37LpZlKi{Ik!pp6`hgfZ9|@Q9{HB;R$}(aMAL|Xy7o8E2N-yK#7rj
zI0=yj`HmO4%A$^HF9~c<mj=J|bV<7Vv_IqLZ$Qdl<tL+ms`J!<c0hhh$ehdM2SeIB
zjRe7_yqPK=k_Pi%pbn}l<45hLU>dcfPLnpuDLH8U!3vu(uUh2E2%SJ0HNk~qL6DIy
z>C{NHO%c0<>_VUs_?LrMrgekZc5)P~KI!UIVE)0Z#jYznA4$1c7V*O14V#MOdDdg?
z*Lluu<YD3o$6j13<msB<Dd$U1V2vv_*uMr?KkEmH1;>?8$jEs?BpEq--p=+_c#T{*
z%)}*@bL6e|;YW-<F$bVOu!rRU%j7=|d0(PvZJ`v;<T0qLWVZ^YrAWVm-s>bwW3xj_
zm>57aYKQzo5xnDv@rsjgJ1gY<1T=$EB<1l`@qhWD03pd!>2fGKQ~o8AY8R0{%y=Ji
z-jFJi^7hF#&p0w;kJuY)$E$KD(oSD(Fr^n^1`{G|?Ey2R;TkGVic+^@)yeFt9XnPr
z9C`n$9dds`<mEhFjqN}U#W`J$HRP9?P!s0M+?Q!KO{;engy<hZbYL|KMu@mvQNO;t
z);QGsiJp`Bx=bxwjFghC%NPd-^Q(_cF}|p>;)`Q=`JCE%V{_Z=NKI`$+l@1u*njaH
zW3#4sm9oZ=EJxybP1x4J+66#F+&~e6gesQ?+f>~0JOqnaTIFh5$`;kK%CFifSXi0X
z7VA~$Yw-a70e7*iF3EY)@(KJ-C_4_&9ib@(teSELp%*@5g~M9kve$#uFE$Rf1E@~r
zEQF_MPj`aC4bq&!K8AilD6GvCay*9-z)zL_E&&+L3^`A6{D-BnbTS8wcOoa}3aE_b
zPUe&x%^_fy>K`X%QM0B)Wvhd60kIqgxk;xKq`)v32Zjb+Nhh!~-QZZ#9ixE<!I`Gb
zsGK%)%Btlzski@jQT58PnM>zZhn$h%#u=L*j8r`Ig-zety>2{s<0hCp2)ia3b{+C#
zmDYv@DQC}3%d7qR<~6Nd*G*xSeEt@fMVWdoTOqHWz4a3Zm-(#cFh2a$L5vUPqS$_@
zU|C7C=xyt)Csfgyp`KL3m9woBWur|QAhUsQzF70d*cscWUVqP1|NifVx9O6wz(AAu
z(my_ga9cmJ_V4-Z9}Ay{%?VnFS7H3|E}`3`SVL9VInt2tcjFFmdS%>2M{(V=cqT4+
zQZdaFicwmQ15EUC_j$1-<bI#4XSFZt>uPWvhllOHR|fY{{7)rUjO{o0I{D6Fng+j<
zE!?c-=4VbwFwTMOGBcllDe7C@L-asHmqmno8T@vR!8i4FdRW2y=Wp1R%bgStsB{!_
zK1bV&IS-PbI9e}eoBCifNHoC|IF9VMb>S?6Nf%TM99zj@0+@_-mfSmQ6gdkMFn?py
zVloAzv;1#sz1DPHv)uPubYW9Nw6NyT;iq1Dp0)Nr_0pZ}l0LbmF1FU|v}uc%T{uBL
z1QW8wO^tp$EY61HT^p-wp@$oq7DoBwcfRygKWlydrKb)bG9K-do3Y7x*V?oN=dS2M
z^Cc|$Q*PM19mNcJF)z1ChozIneo;IhvwvXyK(-dAiKI&)<0-}u`a-7aW0AvuBEPWD
z6odQ#k%4XhXF~jl+ROkycn4~v`Z1EJG>`+mN5l;RhXA?))E#Yn6z?$<2Cjgc8O&u+
z9<72H<bVFKoD)za@58PDlP~jV<XqNI*n@Rlx*p!@x7)5yHrO3{_&K|eh3gt`(4BVM
z1G=r-6L##kxrT~{wo%c#=JKKz2NiWpc8BdK%5x7pd~M2hZs~Oe0s&XAg>P5de2#}7
zc6!?srMs(mqpeX>wkd61=fnSO`C=HOQ-TNw0K;|))Ho8x17ElKSw(&0xal^VL$BGY
zukbsr99!YGecTqjP`7-f%4%~h42?-uFt2^6sNL$Y)ZC!2@VTyR8Bx^J8yZ&^=H9}<
zZjZaF^4dy8p1nHAd2sb?SwXhS?ZJ)eFx`L;_(ixiyOGbLd*N!geDr_v6v3~+!Gab}
z3b~Po0!X9@90_jVG67Cf5h4PLcZ-Fo*C^o{jo_A?meX2&j8<#{unMG1A%ebXeB)ow
zUvcvziB{R}hZ~8^RT+i~2~Ty<cJqDTWHZ^VY$l(4-_5pQwI`v%84$jTC>C(ECLXzY
z#reju?@g?Ef;DWu<*xAU`{a9#KfS%vb3ua@oF`m}G)0%Ov8IB_hKe~q*?RBWJ9id#
zZu{|^iiTt`r7_%8G)<RX9;RCxF7WJ7RxDd}^sWW-XTLf`cVo%w@bSB9IMNJOX?+~7
zBRCClLfFF5QxXTFU)`{Iq}xbzVu{c)p`V6eycmRG!y2fF$>S6J6}hsI(h{}=poQ9%
z0}ES?{=RHqq$1fE>QqvdV-k&N#0qgHtH*}NsXx8*#=Kfn@5=<-vF6-(YYNoq=RTUa
zsP7v$Z4Ma&gm9TJv2Nn{ig2nq-L~wmS>q0^-+zFrPVrpZf{8zvw03pmhL1FdXQ-{Q
zOnt&v$Z5LU;^lKc9jWomofm7JSvkeaRwXW+7f&ph9t^EpaPJf6G&ju8@LXno#hvpr
zl{fBaN>1Cg<)TaW11^ZJ1abqO)*&g{Gy<bx6lep+aL||lYw0dk&^$FNx%lxg3A$1l
z@?#}ph=xjFAF>+7|9DAwN^(h3<m$np5gi(?=9oK>@zvL;YnSKl{3(o{##Setv6v^_
zm>5%;QaVG8$%+WZll8SO%<W%)Xk2~$UCY|ibq)3k|F}u(62`k?%wnO<x#zFgwEOdH
zvYfJxSHxtb45@w<^G>Op*&3TS*HaTY@7%fEYjNvZA?HifXJW1DjBxWuZiuX2JLv}#
z7qni!|B{Ptm@#u&GQM`{`N7r&cft#iMy+AYn8$Xi3)Y2#(-$P-^8`Kcc{!^RKMp$S
zw1C5Mc65MYb>PHzPY)<uzAnk{6`pmlM34oS4rLM&@E9b12(T!)6cTt6%oXD&Yq{p>
zeXG`QTQ{e|*X^sAvu@k^RejT&zrknn8Q;tyfU@r_v6bb|ExCDai>GbD^k^s)oxY&W
z(=zwwCC_}L@G>9!&1WdUvhPfxmy7MiW*7s>*dS$z#|lBbJUr8wVDm!JM0Fysk&DzT
z>~Tr}VQR;C4&GO8M3ExGh$2cAvn2gsF`yu?W>e&Te_?=39<zce$&<<~)~CdR5vOUc
z4jXXFtnMj5B*PWm&RfAW4v+#XW-`Jo2C};_P_$VWur7m#N|JV^v&~x%tS5GCQzJkY
z6m@!AramM?iwDSUYaJ1-g!qeh-hA^tHf!_T*%R2LIehM$d$!#(m%k~?Z|d&JV>Yu_
z%E`{{{Hw3F&zRBPHgo3Sr`dgvJho+BPhmIPk@D4#f0SQePH7U3mXsXUqMhvNp~oar
z0_IE<?F%AsL`K3QOv^NmfCF!lu_JEJ3k);>>JEP#Jf^X<je8xeO6@hSjHDjDg!VEK
za<ToAM|nSkgaqauSsaZofC;U3c&peOsmM*=<&w$c8Paz#*=P@;P~g!t#WfgBh?AWL
zrhdp6xn%!I<v{8Ti3m!%$6@PZE*d}+W?EL8@zZjc+e3xTrVf(tK7=VGqeb3lLWm5q
zSrjZ;8Ix+nC!cGejCf9{BI!9&MT)j#t|5q&vgn3bL0}L^!k~4iPwfx~VQM?j3E=rA
zgjxq`6PH5DnLv<Te{d@~unU-Fq9>5(nJ`<t1}Yz_-7|qAYa@4yA;{%<6LKvkSPPt-
z6TGtqZfq__9!M4oD+!-R9Xk{JhlLyuTMxEmVJ|~VP)LykN(S<6DGHScP)Zyz`~JLB
z(qZM_PD%4VdN{ZAqc2_Clu1=jnLdAu&oziC*)o6nl<HKb>Dre*x)hPrVyk;NI>urR
zUHqd@{<v@9Gw=2N_{r*Lj^t)Puz8W%(O9>jtz+KGnKTWq?97$(I@%W0HFl_rHa{>s
z2hEp|VnUrsahQwz6Ui>Z;Aqp(qPI%7OAn%N9qAN>Lokn>9qD2|+<`p=*TZJMhTJy-
zophyxwM#K67=Up;_Mfzilg0ua7P~P#&qd%Vn!irOjDtQDRBtz2M`<f}$#f(x3h`Ek
z=DsL3;E1~qCurRoRzZL0sy3GE2vDzELY&E(Mb%bvyH&xj#bKMmL!1Zr9j2edcOLP1
zndWaF(`*UXan&x{U7D}S;b|TdbLo-s^X8;871jRPm63_NC)(?K{nZtjXmfT-s-Ag$
zk9>zo<@kav)^xmE*IRU1u~=kfyrRHkREB4^&UK5f&DIrJ$4~Ki+-R{yVKaqW$Sa>V
z{<~fFINF;bv$xhpCb^kvx9Cb$C>qtZu_3K8bIGhl6T9bWRUVJmtA}c|dEFBiO<0~u
zc$C^~!&>g}$nDI|?=Htl(4h*sQyz%GZQ_AayuQ+TWUQ(hibT-S377*j7a!83QY5pY
zMf=$z_kA{a$rL6{xg^LwD}whmk+CLOYMzoPs2R&6lpo92np?YhgoGYC)?&!)Idh<b
z?Q1CQ6bNa?@~{rf)&K+vA0US4Dd5)eh~a^KmVCRhH~>JzlY$6_q7*h+@Y@D-07htO
z0itlk9^mUl99_X;nPtU;K*B@=3YD-~R)AKG3>Z{zbJ-m>i_NB3{R;z=|2V1n^66bW
zr}f=7zA{u1s#sGw;q?j6UVi(}w&r#Ze&XiuPxx&YuFYK+s!YtyoxkvrZ*QOc=0tyQ
zV97iiR}?D(PVyJV+*?%>JtqRs|D=yu$Av3G9pmTz*Pm~1=x+=!A5$HwO`P*{7P$9m
z;~OVC$5dBeGq>V`aKjUg*Zl0rSEo&yvT&Sj-LmkCu+8hWg|vo8X-pU$M0^8il7YL>
zdkln0y+Lh>*acWa^nnTTupoM`24h3xLrDhjA2VzgC9%H3FqH_{gX>nWs%p#DF1D^+
zkTd?gXk5KqWB2K8U9FYNt6aLT-kyrN<!aZ2=@V>vkoA6NC$Do=S$$otlLM~mCZ%%1
zEdMM`W(`%#D_gtTbf3LOt{=CEd2<WaS{K)5+p1QrUKg|n;0@)UHK9^zs&)k?w|4og
zRjxX|^E<sPsM}Dtt6Fx)QucZu<SFJ}Ao^+A%#Yl&PIF9C`iA{OR{y5tF+<yrDwXyg
z@(1cKc?*Gl5%6WkFVTdZD+FhqVdnq9Kqfh;i9UVdh3wOgvqm(LPNvwt^UgCis4G4=
zwuyjmLEFqEZ7=z5F~t6a>Yqq*$XI|R2`7>T03}rrIU*7?cpoWTgRepWkVj)gRpRpO
zOh%1{Y`%$I9^LN<$(P*U$(@?sIKI&qkmZU<RoG@9muZ=ys!rX<C$kBk(#H83D-)gx
zdxPMLMxeIkcGc1xt(F6}X+65;<em3lB8L#=z}c8+cH2TxRXe9;JifLP+&jUOsBH9&
z(>`UqIGOu&r>f3q$;cDRF%!WrY_YUu*yBkbFT@~FnJXrzN_uQsyc9S&6c)PgkP;Sz
z6Qm%JKXz!#reDl@Kk=&Zlg}B)UaxO{{m>N$YU9!7rcHZiEbLi0=0>*i1<T>PcK2P?
zm%QR4W&PTjuIL>`;objp)q~0|e#;uw9{!gtN=hDc-_i@_Km27|Dsk80%YqZGpK23p
z>*7;6`Cmah3HdkB287Zw0$5QHE83J><$rzj{K+htHjE>uq*E_{ey{ph<L`6k95#MY
zu=2mLhF?AR66&!4Z+%+K>oRE-FxN)tR<}!cNcZ3#tZZO`0Ckp$$GWjxY4?QC2`1Jp
zAQ8gY>41*NkQw|d0Ysfv1G$~}$x~r14~&&g!KKgVAKG@!jo93FOS`W)W9#i~*Xx3T
z&el$B*`W?@8txds{$o{ywNF^NW?JK-<T=p|>C{CpT;$1I7d<Drs4=@{<%F~?IId?}
z*gq){2zoS!u7{d!HfQ&o=?LW%srsYw>m%pMHk&Nlto6Fprs0>cS}j(quhrskSgcOR
zG}!|l*FD{f?^8|W9*+_emOwu~X<V~Ft?<cvr>r?gtLRvC=XqO~ue{dUP*D+y*kk8d
zuU)x(>v?x9?x@fbklr*m#u^ma>T)6GLsvMQ8tX*ti_|*BSD`Lo51#xnTQhi@uF5L5
z--v3rYO39q(j876Mhh0Z!-}8Bt|}pz+c>%1$%A$-S73eshxjMxwInjw@<_l(gd|Nm
zwh(g880L|L-=~&K!5k|E5t^{{F+W5A%3Q?Tk@F@01d7{}?`kNEc=&Y+$Ai}a=piT0
zVLx-j#)G89&3N~ycLfF1fsh4%0Lm7-aR}mSilG({Y6C={nV%VP`ZZY3IQ{SA*vF(C
zL%pkehTUp$d0@clKM6$`??aF%Kf<HsNLxS+p*GO>lcpe3l1ak>k;VX^1*j8JNJIw$
zrtzsmces=ozUP3IgO8aG!F&_<`>OA*Oz@ELjW;S`trb!GS>oF3?&eN}C5hf2NixTm
zV32#u&nxQ#zKF~;_Mgvv<5lJnUc$zAqk&+&@(ngK#1oZwSNpuqyRW;}c<srmK%l<z
z=j={a{Us+$R^AV0$@%Ixo-^V!mY6>}5sg!eNK4>$N_{Em*WgwJ#$cG+!D?<XLob(M
z&9X?fif3%k*s(nfKm0vj?y!8aRr%zjN`-6ixT``@{>2<=&v(76I%QYqD(`naYz;kA
z{5x6-whU7N_73~4)9ZB>ZZ-0PP0m)f^3|E1o=oA%R<Q@&DRc)d_{JSU1967<Nl6!Q
zpo?Lfc0umkqI7hE;4!t%F#;OdE2&;ZgREmdg1H$N8(Sv!D5-$v8$UKx{q*Nr;Hy<7
z+q~PwI|ta88O#H7#tp_UcB7o5cyCZAvz2lG>W%66w6;l&H4|H_n!>kFzG2z59jklL
zRI;5IOvuj}KWQ|MLyrg8$wKaw2Y$2zey4#s2YnAj2J{kYV{yrgh)NKI1U-VuB)EcG
zMJhu$&PNh$M3p4T91viQEI;6xbYAT8xrH0lfbrhA6(4`@<15A~d2}R;1!iPnwQ%kQ
zQ__EW-U16d%kzIqPr2aSL$UKFc|3D3XXDry9%#FA?bNAjuWT#4ZM@RnORKK8y=m3n
z&m6yZKU1Ur0MVETYHgg{fA8_n>|KTS!<!QHq@ms-_%m=9z`ArCOEe^?C^}PkbvlxD
zzj^G0_#Jd`2N@EY$1oTaa^R(>@x0o%tH$PN_-4jYTiy8FI9sDbuMOONceJU|HtxB`
z>RLzUn+*<I&8|_U8msTVySi~?8J-*U7!T27_Qv7Lo1!DDZnQaS@4dIiZW~d?<VOWu
z>5!SMA1zN6Mup@)WBxZKgur{)jfUi@#1ar*G<6jr3{bf^6~V!X&V)50O)9YtrZiQB
zG_{bgNz`088}7BvhB>oqX3mbq<~;x1C5MYrR5l-w_^~SvDsdr6{m9`@O)82}W417?
z8C?~8TD`NOZtT?5El-8m4duerz=X`w=IK-J9TUthSyDNnkjrMvg{ZxmEB1F!FeRun
zCz+x^tKS=SN9B2)!E?K_^>=NbF&RQsp_>=u(+SK0+ovR?N`mI%H1Sw(*#3!XCPg*D
zcbq7%Fjx%Qph2X-{)9FQ2zrXVlwdUwEtz;&a&sYqAuf)vOCVYt20JiJ=!?bbr%i6C
z<`AvVX>e6Azb_QD%)SsKR>-$5L|Df8rgT+VvwYbL&$IP{YdSDLV+>6C)bqF9cZjhm
za$Grh#mDxqXE%hNx+OJrY+Zx1ej2ZERRt@;HWtgw&+%MEYg1g7HNGSp0(THkg{Mq!
zUYeN@SO8n#A@OQO?7VZcS(7iLxS5&xlV*Nmx7vGIC^(^e{}q?-pFCsxUG>@SbAz4p
zWDKI$Z-tRYQT{As^#Zn((ntUw=#b3mV9Yd~kT2n0jH(z*S}gP*L=~CuKtM`jsM0Rm
zq87OqkXhso3b?8U0;F6A%sI?a7%|oDZ3{+00|zwZXxgbKXPEZOhk;{-5YNk#%VF|t
zfP4Nw0HH(REbyd|&trVrq04}Lo_y7WA%Ktp(VBB9CJ^y9+TUrT$FUPa!%oT}o|gH=
zkpOTLtvii;s0gOK;)o!+wDz=;?F5FAIJs=LAg0}_o@vrsCYU01nsbQlpq*f;;#_x3
zqq**wcjMio=30o-C(YzpK;oPt;98WkfNeeL1e7)M6fv}g878RK=pPKKMZm_eiM=o<
z=;m5M84(c_@9ZeLAL<&sBpH2SfUW>JmHS7MJ+xsv?1%3mz8$a+9*8U11|*R<%-$of
z&>>TGgcpP9IwxPz!?0082`Z1G#y&iS#NpHj`f-Z3NoWEncBqQcC}0S3-fN4CCWhb}
z*;(#&sH&oFvoVHE$i&|(HkEBy$(*B`whl$n`eI`u!wp4gW0aHLFb`R5R~nlY+9euB
zgEiz?D?ZLJqFu`AJs)}*bB%7*Wsu}-pn=6Wo!*zihqVjJb2JM$0YoO&z3EIE2xALH
zBiV?#gfFR>hM~rgKdG1^w&C=4U1~OlX88;-Ae|c3u;ThO;mpo{!7Fg3-1h+zB?^p)
zy&ii!zO>Q}qZC*l24JhCk++aw%85fyVKt*LF=3E<wuxIhc(q`Nb_lwKxP#EF07z&@
zfsqxJ#1ASuRLko_sJpWR!nY72%8C+NIOPJP&(d{NWd~BIh6FVfnotYr#2*twh?>wi
z<gho3O2VC?F!(ziMK~Tt0`i^CklsNE7mwlLPM{P$j57&nQ775#gecgfkOe`AOWbA}
ziYoMh?$%SV7?K##kuXySs_HcFg~5!6;K!_`LGl4bqp{Q&j1t0!f`UM_8EOqRn(h#~
z7gt$Gd<&^Qgm!hdr#eHO;^n}4)Xr`gOtbb39-!eti&{J31X15XkK%3O)IsVUpa2XW
z#LgHaI;Z3g5*;8%lYrQd2!8|Xq!!5kFbgRZaN+Z;Oh-$oFK8L!LgKH;3=cuNJcGM6
zu0rqaai!|KJPcup%pG>7!7kfoL*Pa?#LBX&Ss-K9u(`^1+3m4uR#{h>J0M%yan_kL
zs>l(rq&jDsicpV!l22=DqB5>&x<lp&YU9x5dbjFStTw;ulC2J_Dm&a38}oWB%&J0!
z9JTqY^eRLUwcDH=hTu*c-l(b;S&!M23a_dtOom~2%Q*NPd3c>gb!j>}q;tjXvUs#T
z7wQOQ2<BX4&3+C$aSw#zkWn)(d!5cWTJCcwio?Rg(C#z2646){jYr%>m2eB5l5H-C
zPZ19$1nXPQosNL4R#|Kguj-EK2|onpI#(kq3L@-ktq-zp4w)yy90#}>Qe`K`i8HIl
z?GP0)Qv28Gh#dxl0tcdHqVX6;rZ;PDUFB+pT&c?FnQG$@ep?X3kukRppEj3Q3F6DT
z48v`Of0Sx<=$cw9>s(es+$+mIr_Ccftg@H8L*Bzj9+dsE4|WDtkIZd~UDIi*I19Q}
zhZVtCITn*DyR9z8$uV~@PK8k3U&SGmhiSwR5SaUe@m=O+HV4x!nr89y5Cd3*n8yi_
z;uv~sg{;~s60K^p!Hxps3I&p;z^+(RtQM|X70v3GHJ7S;ofeN`32H(gfU$8`s*sK#
zax25fr?fCltlOcu)e4NIjT|g|c!3oo6b9T?GPlLW9Bz!6Zbh_cW>XN~k|X4(TB#u3
zr2_2&1{A~Xj-Uxv=F(M<RgpE#p~)_c<l_5u#ysePokhJ0=FEj@WU;iu9OuY#17cE>
z%%on^qWI{Oi=N?urb<N(LRW$K)Im>(YgGZ8B?0+~hA&2WWd(h$Q~Va@^x0+2rzxtX
zg3HzJID_;Do+^r^Lbh^1F(9BCp@^Igw7@UB;e*5#OOwYI_j<S+MkSEr02*bhW_Lm#
zU*(fwJcF54T{Z}OxYw>jm}HTC2pp$c6u-xcH`(!(b4chdI>OarR8<SJE8K}5V5Ko`
z)6~H`5+BEVU|8y))><&l1Zgr}fMvxs6;NEMVddJn70MWNMz*y&YrU23kfK*vK(WbE
z@KjK{Rmewz<PBM(@<l{zVQJh6SsZLyNk)qh^Pp4V%!!YZL1Be7Gf6A{nZo(xr@8@V
z+6U7g<FAFszV%VlA!y=lWAFi{Uw=z|=q9V%Ytr8A_b8sck~~@Y!L=V_yVKL}`m`xn
zir3id><0%n$}49>Dk-6fB=SJ}Oka*FP)hJjPr{0jED6PLn5Y(d#L?e+9i3MsBK?h=
z0%K4PITAwYgPQvA2#`6HrN2Q)1x)K>9N8bvmLdLI1^;~$WHw~0in!{fP<Nnf&2L4u
zsyE^LPks^M4%V@TpFRSmN=?cy@qH(RF%iM-B!7hcfxUz8;9w}A>!R@xGe@?Un6Z&#
zKuTEBZXwK85Hao`P$RxfFlR-hW7srEhNM7xM&HpURXl^3uMcW{>3t{<7`y`M!zHY*
zXSFK9M%IX#B9(sXbU%h*fWBk^-2zD*`d3pwOS)57QChK)!FbP{6Ot&9cMy0*l8n&T
zOvo{aSV!3ZnL169D_DiZf%ru{DDJAV@hH3G0dyKfj`(2E1IDAqqYuykk@gIlvj^}c
zwMQTDM;wj@bOCX?ytTN5hs2k(^7yC(MFEq4cjo76(xaZDAYkNAOf`#lixTv1)i2->
zei}K9yBCuD36KUYl~$tb!Zt1AAtNg=G$4dbg9GrvBfnx@lscBaW{pyCmm-@bVML5)
zd9egv^5o@roxAB~ZT_}N(|c59<Y%vKJ&W(U=dQ&)w&G{62hG@g^7%yzSvkJx+`BG+
za*5hAebTo1+Rdf`BnK2OS;*EjHHVYc_ZD1d`9!wbD(q&B+Txe83y&{ca+A8{-s)ty
zxruEMHwpa6SM3396YNam@EExQqd+VRSm7FQd6?Q3narg{pb}6n#haiCi`P0!CPH$!
zLo&VbO+1svvq({h1`%%nau(u;Yngf|`Z7#lYvh>SuXi=LD<h6tIUYSy)z}c-8!b$W
z9*H)jtM^8uFIP2=E+yY~-rl9#Zd`g~=>->@zkS=XmzRyo<5P#IJto&WB9-ojF5PcO
z8n(JWs*3E1@;@RGt=bb!qfk}t$U=qJk1pM_^t>M}-FDOY7hHgvM`meVV6EnWyQ(lo
zg7b$OLm0aPjVjbPk|p6wS-ICAKbZ%*yl*o{l)=Xsn>4F$!@kDbpJBPjUx!oWj$d~~
z-O!*Py03fRhWS%#ehl96dg#2Js5^{VK-71!!a9W$2`zY%t3t}9vN+<OL!T2=|JF5g
z!^zx+nO*E}SU;xS3IzPd+s0A;@5a$U?t%+%yX```lHG6OXye)$#!~kA+9bQ*xHc)e
zA~9k2O$cZqG(8)nZPH!RZrq}`!O{ou-$}+us~c+^#5rhC%7`ycptoe%3#yea5&7Cd
zYH2}jlc8{N(t#{g(77oR)?ufC4hpn1<y^ocFvmv36;whs;}1`zp-m+MA1Wi(NpF=8
z2!5Ph$xcRPwI=8EcwL2sS6dX&#A}!Cc<`R{SJ?Hn=kD0EbcWTreY?{-W9gn9=dRV&
z#^&>OKDcA)S{)@VSMx8qydGz+MwO!{SGBY*S#{~Ww0UY-(%O=qcj+qg#9V!G*P@8*
zQb8yEypIn6WA<A?^SP9W+?Ol-{a?79o10|BxGs>W_hdox-PxnC@#7YJG_!2svYUGE
z%PgyPTIbHSI%}6@?(3a&WqQ%F_WKr$8_$#;cBe(pdg>E_T}?aMCMD=lnAEnTDIpHL
zf1*7Ru#An!9*{-szhXR_HI`i4XMsxIqeP5+mhImqW7EJU1pGz&MlB*zB;o6YFH10i
zZ;QCuM9}!$2XyHI5qGp9-Us4Q`e_p(=oNd(P(~B@pR_`S0s0~YqfbIm#DN);bH>kD
zGqzY9zr!XQIf^#Gr3U#IW>UcgGpqoM6~8@!hf#;|wT7P=KjWV@er9|M-_YwP7jt|O
zM{4LB{JWAfbAUF6Xz@GLo7J012SOfH05?<cXgW@byeWdCP%4CE#Yf#B&lHYTBg(5c
zKepxWO9%gU?Q4%ec0IqyHpSz#6`ovl*@iv6vSsSI*=17;--y&zrz+VaFba3rjLW88
z2T47jdFjWtJa(yUx&D)n|K{4llQxHEij7~qVBdx-dI$eDby@b@seEQdsybF>T!wqy
zHueZ4`q!bdwX}y9ZH;8C-SN^)^BW%wwtNV>3J!3Hpurb<iiSV1?<<KCOg~hL0x+zw
z15rj)T27YW(~`>tY{r|mac)y9m&0(&m?i|V918hNUtuqPo3tOF{$Lf+1|o#yoNK&|
zRoVh2=l+ut%_t^GD%0@z2Qe>Q4Jztvh#G&4_K7(u^$Fg$W!ffzinI|bcGxb!PQi31
zIfzHGpWvU+ZINaR6b(hlroNflA2TBM2jxe``YVOOQ*(soPKYC=^CCqD_J=biX>pv&
zgVxMSrj9KQPgYPgB`-E#afgOnd_?O?TDZ~IPme53jvd86^=P@a?S!dT9C@+4z{}z>
z_JBAQ`eD>(&ZYdj(O1}TbZv83-L&riAKu;rK&tZG8=v=->AmmFmMJ?k%T~58+ZfoT
zEOqH12rJD6RGNrNaYSrr6j9Mw!fG^XlxU3gh9sL<Vq*7d5))0<#P}IwOKyw`JBRQ0
zyk};2b^-O?|NVc;o;Ihv^?9HAd*si7f845>0jhnLW+%u2pEX?hT3@G2K>JV+%?M9q
zh4skgAw@ogHWA^49)d4a&~6~H)u_rN^s2tLj<`*&E&)%~(Z8S22)oXnvwq^Z>Tv~S
z>jL`fVwZh_eLb7GqPA5~4r;3=POK`(tBfx2uW0UC-8pv>yGZ^(Z3m~7aFmaxlpk(j
zg1&Uh73<{>bAQQgt@+){CN8ch$WQ8<j2&Z~OsKzk@mBLRA$h3SSv$Y3tlXCuY;LI?
zH*ZSKyvoMBR^{hvgIb*~@w`>5#@tzAcEn~}q@1Pf8v0>WyAIn^Y_K=2;j}d4Y^o01
z7}hXyO#(y#mN5!vvB9??v#@~@@ryn&OdJ4d$nihtet1L-@y+#(qzI$`!B}Fc1Qm;G
z2gr}{OYY6cp33))z3fsZ)oh!%(P*;D=K0o|`o$M+>Fk&|@r_Bn&9M*Jt-3M3v9YP$
zUEMpj%(;4;O;2*;T3ew_j#iYlw{#_^&#b7L6A=KTrg}(Poylm$8A~5cUF0$s$Gdm5
zI)jiYZ){rH(!98<qodtjneRWYNz`v#(^ws?9P9M>O6+F6)pFL@!g#D)h)j#?$Hj_0
z-e91$t#f`?0r-?GU06j{Cl@qc4OsNmI@L7ld>&LAh7q`V_*^-)RclP{AZRiG2R7D1
zgT{k`cvI2+UcwO0wj8Mwxk!<SL;V&9waDnGYZ}JJ^r9u$TDLc{aPGN<O@&NoO|~MJ
z5wmJ5qHT+p^e$>D8|x@`cyu<%+^$I3YO65+#Tn;A)~`r(X>Fq3s`Vg4-?Zr)&OUI@
zw(YHLUb`btUg)$Ar%{)~g0Pq&9t1MJHEA&9S<ka1w0~9J-#M!#T$S$(7w0!McilF7
z<@F0&Iy_M*0u~yf#fV#Uels&^Z2?`0$)#NW)Y&sCCp3=>g)6J3&)D95JDYhVulVSm
zY~R3@pZs<-+>b-0m4sxlLPPmKuhkp^<s4Oa$EfqsZS%i<KKgqj{VoyOi)ef`AvO1m
z&N&|Wi!$QAk-v>R`>H#0zeVD1KMAsO5~6EA%_G{dYlaS$;X`o<Hqn`LHRtf;H{`sG
z&C1O%O3PdD_^laC3K!&oDD)V$ke0!}7IVLE5`4({w1~xgL@8h-IK^K29*b=N(pstW
z=uy}Wo^?89E$xp!zj9?^A^zCTr=M<Z#h>`c%$4+aG6&+1`Lk~{(6e~7fu40fdmVqS
zaHTTHpKE<Oy*zV8D9jvS*h!iErNsZ+HGa*^VQmp3JZKW}cn~E88v+bTibrY5ghx1S
z!H}tf9~hZ-ICfFIO-3z|3HVlCV5#p|3{M$k)y1F9(7UW*b3!B!36f-!V!|A@y7UnD
z8Jt!v&$`A3p}vqbfw&qI0CkQA&s)+z;KATh|DeX^vqEvm$X|l~pdK?=eVENGsc-OB
z1tWM#pdUN|>IZo(!<S9NnTo{#!V8@}nZL;=5uS<&cLAB=MhGJCAZDQ8pkb6=kFS@Y
zWj-i63A2GxuxrT@_v*$CEiOZadwtslKkeQA=WEtIcG1$Z?wN&pU^i$TwXfcH(|uQN
zXq#r$#}NP6zA$f<LwZTcW@VqlEjppor$m037<c8T2e&-8ySZoAWgWfW37JE>vC!+c
zop#fkcU|)Rj~BH?w=F5EnYd*^SGBTy@`j~s=ilHlM#<WT>jt!rA-+FbJExi)EK@nU
z3LC;#RF0cwQFk?lI9;~DXDIiqYkl;ulXpC}zW32xr<Ki~Y4J!#S?j2I`JNl^xqN*q
zRnA*q-L}BL((iaYH_rIN#gPXSO)T-}`L|!tHLhpJr4!fQ7LtwDa)-~=zWCr9cV2w&
zhl^Sx+ZGj7PuM(fYPGU*^({le$b22<HdM-xO<8s85^x^l$;+s7e2sAoJUiB#h8O~7
z>cQh6&qD2J4pqESs~mh&431sUu<GioS1oJnJ?qB4fq}lepJz+XKKmT}$DFxtqQdq-
ze6PQ*A$rYo*R-rzP1={&w$p9r2$zoFZfX7du0bQ8ju}t7I)G~oC&do=bSRw_2pcrQ
z#6~DIy)hIJ#jLNbul2~c|3LZaD>o{iK7H=FPc!?CtnkHOZhLUYs~2AQ>W+C=oz_vL
zg<SQBSzPt%Yp=fgny~Q|<;RcHjjWW}pFX$$XPbAvG5E&L%1Mi7MF+=^r+Z#~mCs{r
zpqJ1f!(cxAQ%Mr!sY{`5p<tt8I8eih0e-m9YB7ZH&<v*V9VD)57){YBf<Cq7hMA=n
z(kqtE+<kEO%u;nHl&(K`EJgE9N*(+FDpt(XctD3OOZBk+E4yQEW#GN5_wSrFYv+D-
zr<5YMG9FO)R!kmC(Ib>I2on@zm?e?9Dusv>jT$Wj!4AEQ4Bb$kCSl#iCLTb-B=IzU
z?1FcF9ZhZiEC`rLIBR&8Gw>M{1Og!$#25I@*f8!ZL1%cK`fO5@5>gWXE{z<LH~GVW
zsz5*xKB|65O6I<YCksZI@oZ9kb|}J!BO(Y%US>EZ;AslO$rc_cib)OrQ^$5nPGR-1
zP}Wo6Mu%bFj$sQ8@93WBgWn@k8JvxDusv{p%w6xK)UiIG<48TnQZDJmVW-LEoImRa
zHaN8lv{WNo6%r4LT|@1}%R5}mQO)-IoR&CA8$z~%=3VpkeaCWNMD2h!MCN9-j9=4t
z=y$a}vwg?;Psl$SO@I(dhUdN4huC4EMc}sYSOdX_Y2c=UC|am5<K*|5S)6pxiIbwd
zd>mVU`M4?P)iPFl-js3QXH&<Ot?W{+SZ171)&|gc=4)sxn_yh3d_U5D&b*m&|AZA{
z^Wb~La)^QI_`g?`R#jJ5mG1asf-RiAzg9Vx)KwJ}JDtS^Rl4Ly{?hBm&+1*y`}`r$
zv$Jqy1CM|b!%d%Z0Ad=FM<Jb)SO(75;|M$La1HT9DYKlHovu8_R<JYY3v*YW`MuTB
zwaVjj7LH%wF)5FO?Pp!EbWJ&P{Qa+p*A9loKe3vwl`FfZopHwC+v(>7=eq5aY71-A
zzh&35Psfhk9~#?K^p{NAXVye`Yhq2LknCcp?np;VS~m)>;E5$+jvcAyCy+nMtJPfi
zlJf3t4=BGrTgUWQ8f|u6*X!GRf3k1RoP9s(UHQo5D|0mZdp0oF^|!J7m&ANP*}nVI
zh1cyh=IQqt1mlWc-2Mulnlf=;j^_U2H5&n73k4BuSbvv)N4QhrEWRsAU(g2vtOF}D
zETI{#4<g91EFd~KGpsAMxQ}%8TsH(AA=YyEW)c1^msHU9e~)b-Kvw0(c-e8yZfgl#
zKA~KL%~}ka0?vR1N|4@sgTae1kixjp?l1yJN3dGivXk8kP1lLH?q-@Y(o$`R)yK|?
z#TZ$}${4<7g;@aavm4`hx5;ZTkeaQ;g0Gr__&)57l1IR2@U0VXMX645>+a*4GSnqO
zTpaivJ~v3;LD^f$vH^#;EEAXAGgm_;EFFmLB!3Su2l1?xFndSVBaYe8eiTRL$Yy?L
z<a;}PJu|7h&(~;!HI=$Gt;_B1?pyY`?d8Hs{!99Kz7sO{UG*(j^yp<#*S84K3cB1G
zpI*cG4bugan!foE+a0K|1_R0-d1mX(eI?y9Ten#GPr~zjw@tmTUpe;2f`Yf1_Az?N
zHJ>Vv(6}bLfCd0v@Y4DRj~J3c36@@mu}$)6af3Zh2;>+y1jq%JXA~kAad*-TrB}KA
z)ob@G3i>N=-cdGgQrin`)vK?vIXO68vdw=2P}isIHugTdO-cbZVAJ!{YI>H=8Glw>
ztH0_)=KS!N!{A*W$4Riee!vp<-=A3@cpcoJZL4!@F;s`TI7;dL3M2*g)ffukZN(+X
zuKw@a*Y}(ejpUct&zk;iX1x9O^mhn5;mFq@EXd8@2wCA8Db@S%+POD3HO+Usij3CY
zhhKR3{VPBG8n}gHUwl2%!jAJ_1$|)0HR4XJqhZif*kLinLEjr)6crESgbNBT(s;Xd
zVhprF+~zc;-?bD-h(nW}QPxX(r^PA%O7h#;RHXm7pIr_6y!dOk|JaT^LC&{}C2N?;
z<`>6Vop}zuQK?>u!G$#|gONj#PC2?-2tD9Wa~1Cd%5>6e#MwY>${I>D*+M)hDi7Jv
zX`nIhCrxaRqTw3Zlb#`}TKyG<F1l9$d<gE&4NL6r&%TN78Ff}S1HY=z();1E-rqFL
zoAd+oYPM#HTF1;1g^5HSo((msmXX9J?wF)DJ6e9!DPPQ}o=}%*Xw@L6CFVhZ5MS}c
z)XlHl44c%f)w9CwV%TLdnX4B!cb;FS^GGI#(<FIxW!taV&QF~VetLdq^WthV5XxAE
z<~UpM)2o?f;O;O>Yf8&Y@h0Kv^pW11Z|)`DvS!w-8llq^x44XzmD5^{#af3$TWoBd
zmU~=TX>?g+;c@1;qWk*4>=T67RtmyOVoFJu4>|(Xu^tj}kR%Wp+!=LR_ypw&tSOn1
z0Pon`e&yPGQ6q922dwJ|Vo4`S$16bph~ZlXs|b2KYit1?Gy2J6qqP8xDY~bRh4}rn
zNuQ1T7o^e0Fwd)MdNQq8Y*-I^KqOSY68uyOQhW(C!epDI){mnPNM=IwXCfQi+&bs0
zg?}1(2x1u(h7m_d?BzjQyyvL*=no!g*pcWU2m`Kw>#RDeN6o6~eUmm`zVGsllRAxK
zj48{zmK64#sWU5DTBWMIyb8<sN_Y42Zg=H)OGRE@mDJi&apsci9{=g%*DVpz2rf%y
z4c-=-Q8#tx?23xnJEyLhZ7Mf?`?~ACjos`uw{EVUv9%_@Ar=hA>I!`R%9`@Jy7HPz
zzptQ<t~KP>Y@JcP`PNnUZ=Nt=^ZlIu_i_B$0FOiAYHcpagSSUDXzeG@?HaG0)H7%q
z-esyqf=k9c)s^LFpUYx4D?dlN$Rtk}*@M)NDj4O_J}S1{qvB7p9@GN=jJOX8Cb5ME
z-z9{zfRS9E4_y>cB&m-;Lb!}Z`H6r5fmmQzbF&s8Oc-v<q9lPd$HI}5+m&T#(FXX7
z2Ph$B4<)2rVHC2~=Bv*mYx8YPY?-nG*5*C;2tCLX(nF<IP%UJ^>_fFym|y2M=sj;W
z7Fu9~{=t6Opl7rfkqvrO8PRlV`a(d}4Ef<g^2Yf3iZaq?&<b}La|-(vW$Z)a^%!u!
z*$fcsJ}NEiaVa02qL3&em!mQ<V2d?9!xkO2?P$1)jZha;!~;<-Sm7`NyrD)608%3p
zXTYt9oE(ifk0<KL2eVKba_mq|y;A(Z1%n4KIADr3_jY=lC&TPBWnA7~HhFK}`hy{a
z_=KRa;`>Q0&}A9*ozT~tl>Uqx2Y~lLrgmMhZ{G!-yAN(%YOCvf-o3gFxMJOHtKHAH
z7xnfQwI>g*Us6y?v%Ium387~UpLK4J7$+3fmAY(8w;tRLyX!CBc?U>nXba+dQkk}Z
z{w~YEA@D`#a04K^4faRwm;*opGW($CB1oR*4S}H3EFk*8qZIgR1UG&D3m29Mg%YKX
z*L`owI2A(ruD6hb+30AEQp{Gk=m^svDGJkZwAEqM2I6nsMVH1+LF*7IH~uBtS9+9f
zhu(ST&|dfN_H$^B!ea1!PURe~y*uE<NpYb7ry$M#-?{hli&uG8wxek{Elz<SN}<O|
znvG%JK&2vcU`=jEh3r&Ilb0`{860)gNA-wO`Z%(q)HkRBNhKF3L9=&R5*H;z5+1{`
zh~s168T&YC9T@CiwpZ5dMVlsv;>4iS9T6o)BcD@OqW51J873ybVKCS?3jX3_UY7)a
zOT2xA_cV`sVkiy?^%$^aSz}$s6HA-g)SXOrfBC5n+LvRR^#^sycMc`@E+fQCQo<Y(
z$M$VfQt5uQx@5qZ3K0gTFhCi)Xk4M?u?|*fCZgT3&S5~QVyi<PQk>`EoB@xF!=NHA
zfsWOlpaqe*fQ-dkNKF~X!T-liQOCy6R@Ct8plL_;Qql>zKb^v~82pSTfoQ@+p|sc-
zB0aQaeWQ=R?B`fBSY*Y}-Xn2Zya`_lI~TMBDh}>E)B&#TIgA?(8lTP)ro5;S!l|H;
z%(H_@ZPa?177g{7FBNRmxqO8D95R;o6fEz1+4)AZ@=G&(*|1=zH3U4Ig`PqBq5-l~
zq?5EAz6w+5UiexZOVKdYVw{%bcPdvDnAte<QKtkxf%P5Lh@j;et6tx*b?-P{&)<d(
zMSW-b>}0m22Q@#_ysY_?<`ZyGHh9-mFhtLe&Rt!PC6iPWR9S-0A{_kO^U?Ryi2JJF
zN8dmC{QvdyU-!My^=07w)Yy59mJ=|Ukdbr<seAZ{xV<DTW7xn6bm&;jInKR)s^kAZ
z?iWr`hLL3^3{|Qd2grgp^%y24ayDW+kgb^OzlM&6DwuOEJ^b@mAN_CLsGRIG!zDX<
zJpqpns0>_=YcOdqzhcfjuK9!Jv;X(A<bN_siPr@Y16MmdUh_DcNi0tkOc3TN1uPQm
zApAROvDDL1F2+6d(JK9eCX!sihsW;l(a4c9eEpk@)^9rcj)UeYpo7OX*-^;9lT#k`
zko>&WvB{F4lKqf^lmBaD^lL`c;Pp}}L<Bo@EXBu_*sr=&_4IItyPvlFxMFzv5Uv%f
zHV_BXk<4HzsJ7Qu&8m^sSMs~mW!X6w@4ieQqBm7%h!%{KY;S@o=gYIooA9m5-JwTS
z+w9OX432C1dgXc8X07_C5Cx;*7oG>V&Q0h8w9X72A}Tu2pS9PfhztZ=&$^O<KGllD
zADvEST0!@e*_b}eb#%xqWOa^w54}>TB=Zlkc=U(mA4_=>Z{z;z;5oqDWOOWqEl~|`
zK*AyWCRP7NTp^d9PEtkKSKvRdq&W8@^&ji+8|D^6xX8%6;3T#A_$!%6aA*vF8eK|C
zaZ82P!gNuU1uqlpVV2WH6J!;vPt-S(A+sJXF}PX}69%~SGRA6sGT<w8DW<%m^bI7H
zKTM+L@99e>`}%uAp;Ui=DirGJr}G~AWfF@e2Uri25lWK`;eW_sRzryO4TSnbdVk8V
z$9{nIg>V(Tai|$tLx|VS_@8K@?*N|{28F04FED~@sCOh9!;N9ENkZzlW_msBPGFr6
zy^{>FfsoiAN>aSVaSgJ=CHwpP-#LUV6RA{xXmEh@k11})CH@Qf;<NOJtR1<Oh`26w
z6w?4E5|(8cA$?E;rK0ZmF->?}8VT{!5BnghPiZh{PbNDGfl&If7yn~~^)@3f4VOz*
z=?oQV$jc~GBot1aSfk6O^s8l~Z{S;Msqp!cB@>b;i(0DD4+za83nqZio+<v9R0}R{
z3`w+@{zGO-xZb;U1}2^CqOjFi1NcIv67goQ;h@H7RJOA#*}jurKFn|6H)5mSvR&D(
zK6k=p3||2&<V^8Dv*l9liQKmZ`CxeRMIXuqjSBblZydfT%%d`?pSu!Y;NN1ep<E}s
zEX-7^KvhBEDa#~PgkC^38-1C|HB<8~saBddqP<4uh;XXyHS(fV`*pR>6q*{7y@q6T
zC<x1`0Tqj#chbwey=H0-qg-3nat+&GVPMN<iRal-c<1I^M7d5`-IKI}fS#n5$?bEr
z6BX<vmx&f(d<k25Kay40pk{>38DbbnG;lJ5V(8T(T0l9;5J6oTjSXSm&^y2JAUIWT
z^LNf<7O7UGenmO?Ecj*}$j&}hpD@i#R)Kd?pHSU1GwT~PzF2XJ=2Yn$j~}veKM;@*
z&<M_7L9oo&^5F-PVauSBf=ytUw&^r3%a@!*&?dQUKRpl%krE^j4~5bLWMtODMlFOy
z{ESo}bgMX%T+m{3+AKtLtgYSg<w!4qTTv+u^wwOzNcqbsk{&b{VqBJ#a=91u)k|f=
zMP6270W&;fty}{L$B4U@_0gyKTPGgt16nBm{4so9?&(vZoBG5}c6%RUPGLtEP#_fr
zSL_*9aJvTQ^$?%agH?)(g=Gc>OhJ#MLv#xam04>etqLc$+HkQmaTe@*nHI26Yrqj=
z7%Oir*D?*L8s$MMtoY&xM?KyyBC!_qZSIYJs;>*Y30l}lju?FKD;yU|a~x_^4fO_S
zqN|^pppT7(jtBM^vdPrVSi#|wJ|!K0M&B>a42432{051(x$BP!<<V$DR%S0`Ata;b
z#>r4Ia2H|W6K_y{M|oy>w%HT1=}LV$iEDpy0zd$CH<>k^;<>o)CbNFE3nbK&MuV1M
z0)5~@{_w(k@*70WrfwzGy@^cxSmY38wEkdI$w2oe5gMkG{vagj@}_Q~pIig@@_2AP
zm|ykwlU%1FpIC0IfO2M)5fEB9>o7E`p=SE(8$`_sCEnD{P%trdiXWu@baHfw>48n%
zr?^h#)`OQ%YWtyYG9a3ekkM%VwPa!qh>e0$EE`pj-IG>{)UP$(?3K}b^$u>E@Cw%H
zNDeT4z0k%v?(|iBC#8A1fc4V{TbJ)$zI?Crsru{lP{3~L6ZY&~MwuU%?R^Tl5|CFw
z`9GXH7gR%f`WkxS^y%V1=+Wir@2WrU=K%=H7WK)!R6p>s8J`go&R{~%j#BOmnLGSM
z)weO@={V%42pulZVawbi3{F&U)T$ne`AWiehp++_oa%q&any$32ClhCv>|7$-R6+x
zX#2{|-@bL_06Au9kc3G?$!&#S-C582zNh>}7YP^~Zkr*h?QC4rw{1Z~k(mN``E9fz
zG*{*9%ZNUr4k^$9ns?Qj#i)rJ)~-qh%8X2VImbRSoROmmb}$tbikKtqq6@|{_zqM`
zWDet&F;#C)YIQO-L+PB?Hoq;8Ho~`u4xik2-k4jaJTT?vvh(&OS01=*?!9v_JFqf2
z&=$Y^`kx<MHY;_{zAM&;+ph@Lo^{uT>+if_@4CA-)CR9$z1{OWJLiww>^%QokICe@
z_x#0|Os}w7E2dw<^e^w6xv4d3(7ML7ub!~um5&b1U3~7^+4G~JxwF=uyJ$`ys+lvd
ze1u+^p}I7!zLNTKYnc|Jcsj|Y)_&Sj;@H&aBuWDU|Bc_qVFiWvM`u;yYk+PW)&K`q
zfJqosbwv5G7JJ;ZD8cfD7;s*ooPxorSjKvdQ1zU(lb4HI%za+%XZ6SWOO^(d-#hDJ
zLtU1~;?84NiBxD_B(iV=vU9&Yu2Olk>_Eq{{-NYgknH*!PV?G?)1zfY%8h<|w7iII
z@IKN<)l{o;KWnL<^xgJm<;MC+uom!VLwlF?Rab_nUAer<WeGR@E|H6qWGNJuKnUSf
zL+(_lSUdF2*{Pic_S4uag^*RS7Yd;KLuqTt|Kyz5ua#fN^!`9zl|JwCdoRz^kFD`5
zMn10v$nE&YrmwyKBW3WT``2R6q>t`@Zxr?ed+~xBZnyw1z-zi!t?CZ=;Z^oBpWgfh
z)6)t)MvrG+19H7wIrLJ_yghl{yd268O9z5A$>V~i&VQqBdVkH>Os%T&0)9Q!RcZY1
z)vY$K%AT#3USE}mstShxY28e)5D)?Zto*134Kl9(`sP(i#RF-`c!<7D1(f)IuO_Nd
zkUjd}Dtv~|!%kggXnp?%8j`F(S5~1^Y}ddJ7zHUN2#9cvn1o`)X-!$3&~@Y-3dzin
z%j}fbU++Kg)`9-l6<Cg67gMjZ{u7>|$Is-I%6NFat}Iqw2hKn_yO)9ffJ4Q9TrWbj
znEa?|t(=FrmkpZjnoD@(%Xc+DLd`sGtpA`>puj+&A38?fuAyVxgMPz3s0FMGL)S;$
z^R?G=zm<Coi@?ycU^ueJ^;9MoS&W96CvJyiDSM9{|5Ek=JN{+PU{4+d!zlLH(?h@W
z+lFr+ahkoXXw<g>U`qX6L$BRL@BcETgGS~{AjKhJ7Pf2?zvI)KZ94ZvJyvorWll0X
zrv7B-FR&|pREtmT6n{FHqCfhONL%VY!qP+mK+nC%k+%?iMdoDC1T38n@;MPWUI2KQ
z5oW`Tbub$pN632ILlcWCCB7iH*KB+oh<ob3E9Z`1eed$a?|pWp@r+fCjrrx{&Odf`
z6xlnIR%byJgHrB~8g;+FY4POz<m64wYn9Jd*qnBIs3^MVTX%JB`o*Sr?S)6YhN7Y(
z_IIIoX{fsKqV#>6ZLz$d)hlj}Ham`4X}nASbTpGuds|vgIA!VFs5M-ezqr|;cg2MF
zqHa%FTfDu|waF~ooe&|lLv@$IO_U<5z+}x9nul7Qr@_UyIEHs&qSAooAn!1Q{dv5#
zHTV&Y1dQtcFU=w*AASDCA3gB;Z^gg;{YJM-ZnD(4Dg))wa<4DoTKnh*m%Ft3{KNNM
zSrNYB*aQEgwi5jP_BBuTu!o+}pZAlEO4AePRtx|nDqri@xwIxp693p-Z_plb2)dsv
z)jwUzKK`FIB<Yqk+7#Cx6jSWf2}&fd8&feOqpFq(p^IxtM(bpx3Z#?3m~dJ}5HMj3
z=|Dy+jf?@Mg5N?LbqrS=zg{;_`UrY~V#<WW^NeO#(TvW`>jo$h!nd&4ff*qf>ys8!
zSVvzwLGvO^Qm&GG=5~ukV%yXM;aexIz?D=ZRppe?z;K<56h8VH9(G7Ri)>O4(!D3I
zTt>FUocuBHX<9h-BwjniTN7?2K=pjcWR6r<xEybEV!DD%j=0H#Pl1)?2sSFa4agQ{
ztIMUeM9S*(wR-rE<_TptCf~SY<UQ=xBlodqClk5~vFO;4Blsj`3q^6vY`$sNt|qgC
z=>u&4-BV^;j*YrcIhz0T!_+4NFm4Y6zi0rFktL`@1=?P8_+%0JUtJu-HAY^ZaPnl}
zv0^Te8lOupWYV3CDYs25Jk-M4Tg~h<<;I1w*XQsl<CXE)dF6%54IyU*`}aHUf_%?A
zNZaicI*!&ETiL|HwxWC4s)?*#`Ho@^$IKsoXpV*1zu3x9qppkna?BWIT$heG1Qmam
zWC$-Gt(@LLMGPT=_*aw!Nf<6jryM1+(Hl(nd!t6DTh>_YK_{|ieD|0pD#%f<kPMcW
zz-de8vO>`dz8Jm=DbP^?{3IMPVZQ@L0}Xrb&VluYY<i><L9MaOHSj1q65GKCH$taK
zp6!$qRHzW<!IUvCeOO9m4LE~+BP<u<ynkbq8VsKgz%NXLTYrzgp8nx`#2zf(+0)Mr
z2HgGc!NW9JxctO@49Wk*M_%PwJ&H4f_L=1|$oB|R9$3TzOczvyi+hdaHA3Vc7qCLW
zMZZ3C0iY4xP1%3K6a47rx^iKl^YYZZ@;b<}b>*2|!|KKfGfEQ<e(L8>Nl)<IRKD%0
zTau@|b5Xpkq<vB#Z%G{q?zkk@4IeAE0PwP6rLD6w7gfCb6p!V!!e1l~ETGeYg0l^r
z2+<^(Dr&@x*X<)=mFpjBynw16Vi;voRPw2oAapHg7Rmd+5pJMfpkT$-P)f`_9XXp2
z;0X;D%5FdW3N8m{UM-V`a_FP%@#7k!#cYD_o`$-wPtCbBkP{6n3n~bX^03GA33CMJ
z1_7R<eC&*RSoi$&O`j;AWB_%T6W5f7GMG7RmPfcI=QZhns;_1@9oLxrLmy;@;~G8|
z5R8c-QJWL+JHXRF^_@?+Ic&Bk>Qp`sG8JBjxjymWQwxRVPUg%&?kFFB>Oqkfp2r_h
ze&|`JrjOF(yz=f5A5&>U4<^bW=ADhlw(+@<oea>=5k(_kKT>M(DFV5KL`ewoMB6y=
zb|Sm7AoTme(fIj>wH76&lqbeC;>_mRGpnWM^tK6Q(Ww@v*>aaf)<d_~ednIJ%%6S0
zFHCJ%-qITM`sU|3iej#cdDlmS%~hqzg1po0`d!9C3p2L&-h={kJ(fUox{z{ek<SZ_
z6m{}ur!m-7xZGjhA^>&hXSxWbC)Wc*%f@wWlyn;hxH^nX*3V@QY#1){<8*&qTH8;O
z2yLhgE3qj=8Au;Yob-r~xDfk6WlD%~&b5+ZZTR(t`7A-F36{@dWSxz%&;Y%gHj*~2
zp<|J@oN8%+Nxnf7A$=F39Vx;;O0Yoyl5mO9`Y;DQsBIW8Ah1bv!L-O7iUF#w_D}+%
zGMWKdUL@dAh!=lx$PcVNgVA=YqNJXA@=D~F5j?me>hrE<Y}XSn2p^;sQL3AD+N`>k
zF}0Oe@47&2-nw(HsGh!fMx*%tJ@*Wj8q6NI|L8p|%Ix>PE5(6NX)b;DUgb08cfvg{
z1@oQB^&Lp(9*$QhOu=Qbf(hGKH7##xE^7^UtK&^3|1oh7>NNSA)JZ;doy2cgrw`ML
zB#x|8_gUv$F=^H6Y0}qJ>CKmd73{<sO<dQ}+?k*X0qh0x)<u{<A}F^eMkqjDQoZmI
zfMpcq2m?<{v2LKlJ*552X385(#hcTb_;@>xMI4JbP7$PxR3Dk1Kd31m6Tx1>p4LUp
z@wYhr?8ONN8b{2AZ-UMPm?yCKAbG>V)RfSNvm87(NFq}2AY2T>#Gs&MRo$tk{K3VB
zMh|HW315RE(=bl7sU@?=bX9c5&IvKEDRNP7W!wDdnCMw^=ATy>E3AxluQ+Ik87x4P
z6pCWv!4=)HN?bp0LHAj>Ykphu{VE24RDZO*!aJ_IyKL@K_ShWyX=mc*gbY^0SU)b-
zS<y9S_L8M@%et$_c`M4JenA30CX+Oy9?g_wTs=t3h_7)Pa6Bc!0uF5#*<vVZ3PpOT
z(~x-C`nZND0$0atLYZS)1wwok2zh~!^yZu751G|5FwL9Fo8&gZGj`zMxaNrR#S!wk
z6_csAl_&jsaS{La`q`AXQ}kd;#cZTwwpP*XJ#u6(oM4X}!AP*cZ+I)pXM&9Yt2x%D
zq2d@gxriimX!M*yo=|}Vw4}p02VQp!F6|BIBW7DeVHwgo<)$Nh8ykAgI14F6aN&gd
z>^cW{(#E++Sw*bxT%&Sf`uZb#*WNA6UUTL~wF31*p>k7d?-5r|Er8S1Yq?dmbSg$X
z8K76t9&ex;o~P1b)KLQ(sKrd?z73!?2(tyODHd2n3TAv_q@<GEzWnd~9jmT9cXz$r
zoNu<*?>_g+RUN96i;xsj$F3be?FsRrv}WObm+YL|70>|^HqbS9=Oy<oR0$!zM?8{d
z2ooYo^w0-ytYP1WtjE<z4~SfQQ!aCdsi3lXXi+RCM=|||ojpa(@G&L2IGQ3W6l`NK
z2r_ktD=A6S&q5>?DPZ}W)|}&6$GBNa#<quycs=SCCMwVi5$%=&53U2k(2!3#%E{+#
z418PIGt!wB9xQ-T$V_X>>Ps4aBI>#@0P-jb3sQyZO)h@V49r(iNt&$3H5;!}7rR}n
zLM@x7w7DfmiQVFJm}OVfgmq1MuuE83rPajxMS%U9Wp#M>DE)SWj`avm(^}s{TL%Yd
zq>G{T_Z4oeYMB<+M|I{JzcDm@!X#&DIn^y(WO52U0M@0t6(0|Aep?5N_)y&t#}8&f
zqzrr<wFlzG&=Hltv7s1~SMKA?Df8d-@SH6O2~|=$gV~g{$P1MJqkJf8t%jt-JYcl5
z9X;Jg*nB2i-IB_svecK#jX&z{Q7*L`2P8uh{I{FsEntSE%gs^<_1rS&$Je+}9?(+A
z#ILF{219fdfE$opFYF5APed6YV`yK!OL_QVOMbBFz892-Ur_!`+iy#QYkt_$S}Gh%
z%VM%A6ds%+K1qLU%ABsQpV4c<mt^cXZV((z4AAtDs<Qa>BpZ5ba?Ly9x7H%;`bAdj
za;+sPt{GwR&${Y_%SP#&aT`M3YjIy4ZlwG8&BAX-DV0ZmAD;$0OfVyqah8ziM}A*;
z5ua0Ehu5-N<waf)aq{TzQ>mzEYB68LeN>RI`#vI|`1i38@=wEgW#soIUjIyO_`B6g
zve6B|)D{?BST?!=PSOY2=7-~q+7P44AXc1EFSQd!EB!y>jevF<(P6^&lk`E7$BQ^f
zie-%$Sp-iLb;-5$F;_T&97A$UT5lh`x=L8>edcM)gI=~?VrSN*ciNODIh9KPH2n+l
z{s+?^yjx#?werDgwn_*+%HBA-^3FR^Kc+Fm7WyyHTxfa0Xb7&bPR4s(a3f<b`5ooo
zgKwoLPhn#U*!S3boyVp&OHam+O$B*-Uiplf*y`)=xP#4OV`#wAc(Ln1yg`Q$b(z&&
zV~r$2Q^m9}L}Cdd0WCwx340dNZdo21)HFxvBt4vJ`gS1t4f+q2>*?o2MO^FFOBUnl
z+m+2qow9lR>44eRyFoE~yn4NDb;oBn_7j!qZ=MWi$jQy>$&H_NthVX(Ue;rEO7HQd
zcd$?C^Xdh|>DS(K&$XumNSgoXcG*`i-Q^Z8=iK^tBikmE2jt{!k?-;g=?mPumaewD
z+)j1=bG{*p_9GEN<rt`f2*Ogcka9r>{4@ERNFlOUajRQND8m^9l041Vuo;Zw|0a1J
zuP3P*^mU~lO$wbumL{ljJ?B=k_79Cc9s<@%2sVPu->J-2Dr_zDX5yXL8ETSJuJV6i
z*v@oPbCvLc3R8OqBAV!VVLsUlRBJ(c_t#pgxDEx%la#2+I)uuSBMZ_JI@+s$^f^m4
zmB3KQHx!q7vSTrny*m7R&JndGbUFBTijRHnX)?MT1fG|bQK?*`&vVO>^X{SYu;DVW
z-whQf=P;wE;WkMfEL-(tY0c_sV#tgZ=T09K1zJey(HmlMp^^drL8o5#N>25M6Z0|(
zs+%zTzD0TBeXHAHx#cYrb6QdsH!%Iy{_t<gJGWR3MyKTkw(M0M|G{WtMY$L|&vTnl
z<b5{P!rXY!$xLtEVsW@Fx3HqW{cx?!ke`pP>Rwgudcoo}8pIbz`$%TTstI+|jL3Sy
zNjU@s$|M6>LQvBL4lNYo!{k;~6h@YJyTf(@T7LQ_=QJlvx}2_9Iu&#24d}~;<MrC-
z<zM5-MIK%Td3d#;g;G@mBT;=smr>OeVI4v86e#2%D72=ZR-R_-g!LfEly4+`5Gxom
zx`<Z|Zi{V*?QYuC*R(4Z6R*O_E;`vAlUkLh(}b@|PhmYn1{FMorSzavxOVW|7#`}|
zg!?wc#C<V5gp*yd4QPkqbyb!1NwS7*o!omM*PSH8X4XlT9A{7Bv8t*RMtZ37vCY>F
zHMZzPjl$RXa*<M!5<Wvi5AJ7#6ITkOq@N>*0!LIBz|SggtH3Nt>>GFY688+>b04M|
z%{K9<d=V_~K<(ykB&ak2ErP6L0RVj`k4xqik2*{GDd@_h*PHtcc9!ffaXO&YK>m7`
z42pNhNJ|P|(SG3i#$rV*<@LfDoTf7I!T5%TMw<(~7uVN-T_Bx$Ba!1Ui9d}EA#(ZZ
zFDVWx{dg%Hj~)0VR9dD!ivi$gF6-bO(?SZ~%Th)0n2<8{TisyxhWm}|50J~Vtk_U;
z886|kaWOqBstAV#tnr*3tN2gO=C~Nn#I?CI?IYZyvSPSLz4;cGcv<dj8m9YNP<M~&
z8OMA&azy8l3cUT0nu53_R1(ZduAD;p0(QgAbxl3&HLF8;+hMUffOD%H6GF;BdO%Dq
z%g?_#zdL`K(3e{<_Q1_`Jx%OCEcA%gLXV`ALWp5*Dg#2#GCXl}e*Uta+>++DQy%$7
zV-=+Ft<wS_I>WhffR7Vt7I}~>Ar2&;{y=RA!MooXG+Pp*hJ6nk0KWW~g8jIUw;b*R
zfV@zeTaw}aict(VvCbF>L^>l@EGeoIBOyTh2+vA78{K*0N2~|*pbv;Q+kbJ%8BJm1
zJw_W~vBmQBmG@p<Vm1ea_=x8E5$*>i=pj=|Ut;`<o(tEsKKds!(s!_x+v}?OU_}x7
zbBn0z={fxuz&JUffg~FWgP9sWClLR*x8aD?Qxv>Gfi{Xp4CS~Lp5Sx{OMi;ZPXGBh
z)QZa6+%fSecTyBqjN&mdGc$4qp<F@A;sZ*ZG#EIpQIukID@hkPeM-M;qD$%bIUOZJ
zs^n()e<sPPlKebJ_MCWnv`9$?gGkaHjiy5*96@s%=EO45v>GB3UtcCiNjg>HaQd)H
zOmwlNZ`-NM#J(GiMv*%_7*vu)%J08<nYeGVY6=Gc)z_9ON$<y}=v#ltwSSImBH@ml
zrbG>t{`7}rCCxk`zLeWe40KN;{ug+d9#ACM;BCms0xyxoko75^&Ewg^8UTAw+Fjg3
zCQ=#xayr7tC1Xff>r)R&(OgKlQW8kB&nvzX70pO#YjOF5=m6IT%AMm^P~T1z#11Od
z$_{qMz}jWViXxVYUW+8z+<Czw>+a`j*z0zKQS{3}#gCLI&)dKu_@M((c8z`hB4=??
zz6U8)EEe-$51Bobng!{GkZXp?Z@Vm;Ev|86oz^W@=W9&k!}l$R$RvvtM98+1+63f*
zErD34*=*ZnvTeH(X;oyr011$24WRZIM0<=U%A*qFk(zw2v*E@+)LW-T+9n>K1qw;h
z2EnXnG&$lRn!FRB#FjHwP)%2S{<9|!LPR(d`E-nOX-~z1URF&_p}fq#<FwuhCBe1I
zb#&)J4Eu{*mP@S8Ki&VwUHUxZMJ6T~<ox30Gk)u|USe@6mp+OIQB<a>12)cUkeOEE
z1g5qjmXkae(F4flF_!v_<ER4~tx}KDH4f>TfF4BMN7aD0Be_2UR!u9u_RB*~>*W^L
z#2ww8d9uTHrp|6N2%GoBVsmyB#=7eo5*4$mCXT7hb3A>!%W}EZIc`Hot5fSR&(Yhg
z7SY$(zNmD?`Hs@q^vbIGrk=)0Fe|M1_S=C6sWl!nlvmXH@vX~|^Ts5s3g{Qk&aa7#
z@p<gdXs~?DxRz;S_PtX0h{ff!KBSF=OYK^x`+yBOo<wJ~z_+k7P@V`zT~4>JD&9U}
zai-7qpwHUT2D|})bmgUF2H?IE;DXf-gmyV&mO-M+EMHD5n<^!GeGnMMJx=SrzSqBh
z4=c7B^`58f2IZxGKz(f5dxuw9Kz+k*ANQZvQPGI6aa#XY<+vZxVCh<`bN?gmhm~9G
zPN$h|e8FJ3$l_W!*J;HMn_ZSm>0TVR%_Er)nnUq8$_s8iOzLt9N2fAEOFU#aQdtgI
zyS+Y$uP)LJB07u$%G6<|;t25p=hg~KAHbj(puq%SAin>N@-w~O==_Dt_*+-ZI7as~
zz2|2Rqd~9y^0$1<{gFk~J*vW{Ijv_}Tnn7mUW-eZXt&#)%A)up|6&Kb%VoDZ(m!!o
zdacd{F3Xv~?0C%LB3_1sNz?%_MmVG;8o^UQC5VQHOExqZho}kRA!Vi$ckqy0dmx#@
zoWVAxpHm)SUs5|MI+x|1tXX=1t_&c4KKPt?=5srhB)db|{jc*zJFnrwjVSvz#KmJW
zkO~21(*q&X4iD`D%{dquuBZzpT|i(W!Yy2zh|&ds!KxQj8BydTMvU@(JRuI1c9<TD
zoE1dBKvze7lHGfC<jtfGB^{0gVa}oH!0kIXs=O6qcU%>n%nr@Ea}KU-3@g8l2;h(3
zxJ&0h<kx-g)qAivIfTAfsICu&uc6)9OOUI}eq}&Djh%Uh&cEBQTglEoT@GAnHyY)o
z8|jwoB0mDnSOB=7*BPjr%pO3rUK*k_GB?PuU$DceR0yLqeY4*$^kQo@3cZ}y#>a7;
zEw)+Ae&uG?>sPmCfDGN6xdB5|gNR(|eY9h(W-7-S@=~%B*zG*g`bfeP1+-`xYlQga
zs73m39M}758i9M-P>T(6Cf8L;K&1!pXidA8POvoKq+Kgr>%4K>xfWgRtaC4#drNoe
zEzYT~=ZZGgAQ7C=GGpWG$?z?6OKzEcVQ<^3h2>LP7uU?z>zm`9)e|bK3tdz4id$>C
z$|mUKmdM2NmUyvKOg%Ou|KL?q&YE21m5v`{gFrlZyp|nctf=!Y#s)tZJ{!~(wVaW@
zy|}43&#V=cA23li+XHaq_##{z_90UqgBpziDco07$@z2)A`GKUj3n9heKJW`Be-)(
z1OM2Yt=9Ct2p|m&!9s)}4*t$+ReG)7P)XCV0a7#&$^)hg*$cAoEy28*ic#r>&A<yF
z`4O*1=nlmI=ZbZsp}9w&%SZ6d60fy0w<t}|oeX{=7m9+8rDCg>ikyCWxU`fMBu#@y
zmCe`??1VGtkn|4`)M*#m$_SZeqGm2?R15i`KB~iFgtTKBKM5{AsRj-%Rl$T>&k(6h
zX$vstFrdO72Ij*<H`XJ8K|Lm@u9o($T9<Us52u<b{hgHl6aY))9ijA-CJurg%8!3y
zXZi`Y8F}-ND9!AA|9qiQxmIg4Sq+{qUQ-69SN&Jjbmg7N@7?*H)cgA?yX0mO^RdD#
z@Dns~au3z?XrJ@aznvyHoCaV{i(CJ?B>l18X@aqDyLj>X_51g)UoRX?uP5>{vfg!6
z@7Qp?$%&oxlo_!xr`{B4n_DySE8F24)cf`kwR4@a6^5$)=abc1862*jbkPY-U<CiQ
z9pe{$t)uZva@jaUYXdhfcFL*}Ma2NlENmw_K8$vR7=11boV=^0P_AYHBOslkz7w#;
ziISuf*3VClYxoJaJtwR6Fkn3UCm!Hq$$9ca>ht0H+lK2ux|XMI4{l`5X%E+^_8EOH
zp*F)6P(mkf4WVyTokz6Bum&bHRKYDLYYMhy==W1L03Y-6OPRUeL0-Ty&?rj%4DRyO
zV?G9l9a7LF;2=eJHb$`!kdr_IF<dkupzKBl5^^G;93=9@#VvL1U7a<P)89Eor9Tcd
zb#I&0Ug>uxZ1z}u{u;aBnNz<0vi)c8xT{bpyN4msq_cf)|BgS6Uq5ZjjE03Lt8-)f
z_Os_!+x5E5I?1wakuU$+HR}%iM5x-bg*~M6%XYKH*}U+{^p>IdK2-Nc?g2eq_phdN
zqpIins^<6xb$=zdeouWxLr9s*AN&5vYCkx-nsV()+k^N3lJAq?14s`Gyg{|s;qZaZ
z9F1a)VSv;g$Q?%c!?ZfWW2T&8u*;y6p(+6kVLMbN$TCPMzHs~iLm@zl^b+z!Fcu32
z;(gHKKs|#%`%oY*^)=eWN{7RiFf=DGEuP_+c-x|xJEDPjah|`ox-;wy7z{d7zS|Y3
z?5Yae;5F)UA}y%IJhQg+(@XG9AvhGYfeQ=AmxpGwHMNb4ZJIPgC<+FEy$}ls7w5$U
zVM}sR*x4E@O_aB~U7n(vlGZ|hd`5Xh>vvoEIH0!Bpe@Lcg0}_tf60vH(Gq;j>*3Nc
z(i6i8hC>)v3Xm6hdt{r0+M`9p%s>ugYB%?(8e&}|+dND8yQH^@P+u~GEnL-A8F0Dt
zO*(@i;0$+G_xkgS<ALaonTu|l=$KJ_X|manusIx+qL^)o^j}qIE#4jvwk@8u#p?EJ
zV<j`={=(Lhnj(+O-CCX~jkP+%i;`OeA(kgx3~w-276=vzGbU|{jYGrD2odspR_9~j
z{-I@>HjIqb$YXM~<~y2)HNU_psjnk%cnp$8fVM?E@D)QMyJ$V|-0Cw%yxNTV-hqL@
z4STqS*hkVb&=u9#2YG=zz5)mZ!DBUzbq#ft$B2SJYLG5~##cB*>Ey_72&N7o|Is)D
zd#_7SwrISomXe!-RB^k9s<`t3e1pd@K>R|+E`Bj9@MpEJ;!On(7!V4cm^d;0O!u@|
z?1vqRSlFPQh~zVFFB`8jkBNpmIzq)`%(`QOXb#rb6?ohQYlEIkBYrJYE>0!|kIOi*
z><Xmm`{;`D2}ZXYaN}1B@hbr}?oL}yn_gQ#OCQojP19J|Q&3$S^mu}`)dikMJ32Uo
zb%)l3x3kZ4)r5b$y#`Ss_eW}L-=C~3VfReltz1`9k#CQ)i1JUrU@Kz&jR)#HrDKZO
zM|YHzdLA<rSiR1Yc(CQ-mS8-d-#lYNZGf3QCb8+Z+S=Rd(&7*2mAA+?o7_^q=<q}H
z%UbEUwQN2jAxoZm%D2pSX5+8U-_u+Wj~6uaU9gpHQT|$F7yJyVVPj4>r0H|DN_=(z
zXX&q4D~89%QefWf(p;&zRr4U1)3GK{=!gvFudW8!9e}Irs12W_Te6*3kI_+2<EbH5
zALRoExJD;*EP5Wp4T4w=&w8uVhWHRc6eo>}5Fa6|Rz#;$&Y@aYcI*+OLR85Ifc_Il
zsQ7%s=k@v$Z0>2N4K{C3o?Ew?g_bNSL?U3eL~pJf+rSPRfSFsiWJ$%?2KaQ(T?(>R
z`J-T>qcf3TkeD<Tf{KvtTewhoIbdDf{6sqNMDr3$0LLwl3-9sc!NA%JR$HrL`Rk{!
z$MR#7I^y~H@s3Hcd^US&eNClBzm$p2U?D61&kirE@OD;Kb{<^5JpD`dv2t0dM+~vE
zlnbi;v9{&UbOo9k-b}9>+t?VKXQ?$7Pg->5>{xAWZ1!R7>VrXp_>0#jO?qu|deH~x
zwsdPf9&LBarjO}Z=XUFGELmX~{|B>8+jr)C<;%$r&cW01?gzW+C36)^V|&bB%l0YP
zg#~XJ+eJEiHCOJxVLeNrcagK0G%Ss-8n~PiPfw;99rI+BGOU5oMPY&Q^I-fFkK34L
z><;)m`#vcNh`%<O(x0+!lhNq?q|~n*b_y&n@ei-K#;HuJj8KXPOlq60f~~fD22W$@
zZ@V3~3gMiPcn!JuWY#N^|EVnS<Oh*}aLO$R9;9~h;=_%MUxB|iKWj)Zh$H0gO&n`>
z`U{75dy1ZLBFFcxr;*&*{$!C$Y}7e^T<B8PK-_kRo^T@TvogrOt^Y&r1O>PJcEn_M
z{EjK#vsx|1;v91{oe-386aqGTiwXZ}zhdNcQS~X%S&+{&tdAPi(vUT8BF7M|lb~>X
zEK_a|3dYQgW<()q3KdOJBpkNe5F!tSy<oH1*H8K5;O;+8*<iQYgv`0PCv(1Znu8_X
zPG>xwiaU|VJ$bPIth*<4t=8w|=~s76xcjV;r^Ndv!2|Tm`_Q^Bc$Egp%h(`!m?xpD
zhun{UjUIy;LifkY_Z6>Pu6Q9+`>tmTq3~Fgp2HR@PUQ!3C7Y}Gl>68s_BZ7Ric@S;
zURM6X#w+ihrThUmVj(`OhvmcfQc&KNey99Jd4*Y(e=7e_e$EQS-OA6Ef3mR<Kun-5
zpMkdMunOBU<ssbWC<64Nu|`=(sYK}yN!tzNy(Sxu-PtF9r*Cj>ShR)Hi#vojI@14I
zE394nCVM-jMAHw8p&mAXc#2f{?RVcM1P&;NuM-~Ikv_gd+>yShN4WUt9fuB~Ur2^e
zW$f(~7cpCNCiNCvGhhqOg2-kw4i-n^;BBbqL^y)N?Un5CBK+it140J^G?mb2v4B+~
zC+~3o#_hwMD`i|QLhmV0y!RfP%H}rAXlR(BOtD@y^@0TjH8b2M8+1Jwjy98fMoqzj
z3#MLm>Ys#jWaGQ9ELIv8zw)k8=Ev;UbS!weQwF<B{mOg%BMqr<_}Y<QRL(i^{rp>K
zsbRYewI0S08|m{>n{CUi7lWFjNS!V0mYomn-1(635Z}pUM;^*VIe0Jql=+wY9RVwl
z2j6jp<yr%)Z48fadDHw#IY($%uGA~_%X<YQJ2vD(z|LTIvNOa3%1Z;nkJ2;y7*aBw
z7&F~1Uo3wYx(|wq?4Yp#Piu52)b8l(N}99ibo8bR{ah?#G?4Q%I6jw^Vi>>|BUwpe
zJOj%DKR*`|+QTmqsRyCF$1jxYqOllpO@&OX(r>Fz6y(Q?yBarIpIteAx+q=0Z0UvX
zx~G;`D{m_wl~pF4h07XS-+gO*{j!C6o29&X;mgmQSvh5H(w!I5I{zdz4tTWoM*|Dw
z^0M%ta?2M7Y#xiO6AV#Lz#tYxnu-f|9br4zm|I)zOt^dejF4mQT!+)#;@GgIJpY18
zOH+FN&BBGjs6k&<tusaf`B8(eAYZSK4mtyCI=b9rt3-$19jTA@JZ(4JaDz6|BtCJE
z;xDYrckGS_H<=5@1nUen&+T|%YM`R9&}OQ1#uio1aJOSVXXlijQ|xBw71j~ehOHGm
zaYG{yL+2s(E@~g*pfQ6Qz*W2IkZTx3(FQdd{-=h817#wPgb%orW}JxY63H9R6PUa1
zxy5CyEHQtYe(~P*qR?0|`P#?a9f|T=?<<dYcr2BX!e?I#7uPhIWZNA|@115jV5_?Q
z%O6DwZI>GyWt)Dd07)ZWRx9bf#agD<IxXvd#KcGaMMctBR+2k5g<Hxhz3z2RWSE(F
zj(J%}^<sC?T-NLfXk|CFWO;6vUk78FtjkM_x<sC|e!bRwOVgZS<to>N^};Xfy^Z1V
zL370B9$VOX^{<QNI(Nj>?ap6namPLIp{p651@M$W!)ZF<i%!iN0T=G0WusCAlMDP}
zj6`x{@Ic#Gh!zwd>h?Xfr1$WqS>b!9Zs{EBmYGia7n`X(YzcLYo%QlZ(RL;@Ej$1G
zW+C+3z@pPPE~=1q%HqNF(ZafVBx209)vK9b6Hw>Ds~<Kna>@YVLpUt|Ry&N+BUe{x
zQ+s(!ab2E~A-%&9J(Kh5*L3bFTXgHHNtd%bbK7tF<6h<~8RKKu{DMt3mM`pGn0L3b
zeB8O~CkSk;RFzwO^5IAdY1AE&51LG_h|y{|;WN8MxzlK|8kO5EdV_mFje>*VWmi&&
z%S_o_E@^-iLdQb9Jw+J7({ew(Gvj+g%nc9GQv(5+S4a=N$78p!<@9#8$|AX3$3pZb
zX&`QAc)60Y<CW;6BolQSG0oq}H9^=wVaT!TDR>hiu}(uJ7*!}?0GgVC;cu+8@*41W
zYM7|)&%BfLa%A}$(l|li0v=4;PemA2D&Z0|1>hlbtAGZ=JJH4P4d0CRjPq#4j7Ub3
zR5T(Yd_(1!i6`e$8-9mg0E{;d@IUAv2%FFCl{Y8mU!1C5x^P0<oH?~O-+2AzO%F_6
z*Bhx=xpvC-<#lzlqZ9Ti?-Ue{Z)k{hh|{M%#E|rlP1v>T=};&f!HN9OcMt3@EQ~}Z
z6el}smv7$rtaM@9^y%XpoF?s!XKffG+Tk*;`on3szqgp-4q(NN!5xAk_tm}d{q#cm
z)20Tuk$aZlOmAC`Xv+VSK3k|yZy)@4mvEza&ft5(?WjM|CUBDSZoJI~-=jw0&@ILF
z8uA3wx~0q>xY6Xfsj`lM4Iq^^okFWceT(a4K&p38fFyay!x5pOi2Rj6#V|-|W~k3X
zBgWni`FtTSI}-AGL%zXdrL8RsTU({s$%^T%3tRWKmX)@$X_ZOg2OCm@t5Ro8(U~o}
zsViPzF;!<V>)1j1y|uKgRVwh&d(?j~x0Wh%%UWB@*bhouUFo%z$-mIqU({`~Qn-cP
z*!ax0ZO=4bV$o^MdrM3AnzcGh`o`>2Wi2gOM~UzH5>28<TSUNNxmhu*W>eTF7|_sk
zXfYgWeA>7Um11$CJ34UNP;iK?z}&7&5W@r74Sol-ntmkChp%*Tka0Spg%iJc;e=F=
z1rWIrqsUy8poH?c9V;n**KxcRA3}rh3SzE^sUq4h(vkpMw)){jTwM{cd{O|2m9#E#
z8l6^wlSF)mt~55l{Ef%de_E^=o(3#1Ae49|zNQwG+h7}L394;}%s}PwczrcGEyP!<
z5kL)4rG^A@Oj4Eczk58x33Luth&=eDm)LbU=M@T67%DYi`^kmE3adPC2zoy?0r7^c
zo)-{rD->Z$!5gWJq&cIvQcY0ycATTujX0;GHPB7``?wd2CVw;B0MJ6zsF@ejxA2id
zS-8n$K*C&knPf8}22Z(Fl4McT>9mMHM?4i=Di$;%C9Wvw5Cm_W7WIc0g-wYf8#5U^
zPK$+EBY9p)a+?yi7Oh_E&5Pw5O-}F>jy$h@gOeG?<cTbjA1n}<!J#v1C6ms<nA`7g
zGv+nu6U>4nkzQlaTh%C(21ByJB#Q>KyUS1>$ZNo&V9zUc#3SLL*CGg7tx0DQ^Jh1B
zJ*8fe6&6^WzS+oztkru$5|Wz9QgNkRBDwE1*u|nkeW|rFAz8FcbQ>$rzqH(EG7I>m
z)+71^!6A5U#jImi`VP^gH3)Dj5KSWcu3&IzWrM60L~E(jV0y%87Ogr#fLC~vY!Pkn
z>k|cL6eOtM^vrG*8r@z&=l8_|aeaJ6zGH3N=`%(O%NM$4xXY&$*X9@8m2@SG%lxu2
z!r<x3jMjyYLcgazR2wl^oPrr1ClOJMxG#?SS5NSjm5ENb@q)3P6($LU&snHLw#~Tv
z9IIIp>besX>em;Kn*?mE$g0LAHn18dV=&kdaR!|RtKf}0?QWN`>9mrTwyyfIrbH+l
z7Ol)`3)q9w8s=hJRE60@lSQk{WqLqt>5T%j8<Bks-7P4$IQ_P~puNBt(Ur+#&vCoQ
z-+69{AXQvgnP@G7FGKs>!eXyyLPRejn`BKL6DQ`m5Z|7Z3rjo(QNP<}5GCC>sKmw<
z*~*Iq(PUr+E^i?#EtYInvyWK=vfgKd1B-*14Gx1<i;{@iBFQCz`-Hm>Qtz4VE}KCz
z2=K$viokzr4VX>sMFvrqH-2nqf%e{U&b4~Kr)YeBKH_vHtTBfq-{l5dWr=8Osjl>Q
z>g{?#Ht6c?wyANwwlc57SHN87hCJ(*1e~#uNi1~)1h~&IoBJ1fq<9vMuuKZ}Mu|BG
zOb$J~3Slb`it>koRxj9?#iErgG87nQkx56NGw1odUU)4#CD*i|UFS3ucrlF8N%^5X
z##${H)@Fyvx5#848!I-LC8IME=?c4L(PAsr`psUGt<&l-X!G>ikX6){*G)(`ep)vz
zV({C&1(bn%Z9}K~+PY28p0=aR!wQ0>hdNhm-@LBnl||K4N(3PiL!;|m<^nlpo!>Zl
z*Muo@xH_7LYUP<s)25h<Y72uVTQ;VhbRJes2wIOypp>-3O0g0gU|fun(LMpqnHWz<
zVOpVmY6@Ra5|D|I9Eb8599l%zAjh$`<3w`B6Z90PJHUN{Ur<916r7|fT`36mh8uQY
z5w$(>!QM7cNcoj=kS*@6xqjb{cuaDhdH&9Q{UKH<zV+HK7me9?!{9%#pbN8~{9?xJ
zOSVqBa7wG~UGV@jxI3ornv~~)*|vD*<j&UmvO*&=4j#&twTkIUt!L(<Yi61b3fEV+
zpRTj+d}qm$TbFlQElmE+8+T9m=S`oq7Jc&G^uLN{Gj`owuJ6AdnAFhfQ6ld@%*=Vo
zab5ZKrCJ|`mk7x~7M{y}J;Bzgd=8iE+cnFvn$=Z`@Nh%WGOQHv>!4Uw*sPE_5PUP@
zmMD`smh4K{wWu{IR#i=wg^R_MI+zE<fg=J}Bzc|CWqYL?6U~cfR`(X>mpX0x%Q{Pn
z%L7&8Ha*bOncCP9pSG~|z-iu4_k`Lx)ulBBHMRe`uj{gn6WNA$4(;ik*>$aQ>?a%T
z-I)_6(+PXCW?n<N-{jZn?Dl|Trav6<Co3A4R2Gfj*wwbQHD)dLTHPgy+E7JBsI_9*
zC9%od_8)qu+rIH9Oun{jX73*LL^(z$XaiAG4!PlZtnX2HzjdM&kSP%QF!Hh|G!&@K
zu*#^{vR2)OMy(O+jD*{CTJQivp*e7eX$Ua!{g|BZNjLe5v@Gf?41eM+6#W*d$fNw8
zw8`u=XXHKG%yvnu^#*Ig%0DddPg?HnGB?hcE1th1>HUt>K2w_Y3tuGSKK3JgpeJA}
zu<dE{;MvlGSn%U6WtZ|xhu2f?bsG&zFi&Uj&XD&su2{c*@B;@M$1Xv&M(7+=Ddhx@
zRMpi2^@NYdi8d_(mRN;z@eEP{x3~_S!B}-PMRq0`+kQzyy#63<*)>9nPPjc*v<}}C
zr!o;=4P}x%z;iZ|=N`1-V$|cJfyKSsha?OPCRaT?l88ejU<#BFe0(-$2OuIPwFQ5v
z_}qYKrHPe&l@np>F??R}mx9`oCV;kfoyk&Xb^%XH>AB=TF1h4C82mcQ*n+*v8k-Yf
z+n-iWoLC7k(ty*(Zr!WgU)EGo;Ag1~8<dn^?4buPQOgP}kO5@mA@AM{qYI-6XLv{N
zVb+E0k}V(dnRGWLCoV&vD*kW`Fi-$&Dg(SUVv^FP0L#B;a1$@dE6P~fi~E&6e!UNn
z9_+>8a-{ei^=QJNYZ#JXd_cdb?J7yp=Jgfl&?r%6%VE5!Dp}a(FK%rq_O~q@Qwf8P
zw0IPO`GCFYoz_zn0Jl<7k{@A#qMm8qYfeHV%3=F^9bf@ALaNuON!CCRkb^b`vO;lc
z3BnXY$T_&PdIuCaaKR)Vvk^hT;3Z|SfJH0@rqbg8UkcAlAl39Qz4eU`-nezCx?>w9
zyYiOBW>wyL#27L@qP%6bS(LZn>S}o85rZt*SuuWO#g7;whDYF}XtS{5%#VU;_%(Q2
zy-n^>UV^uncKH_;%NNVFa3^CmJ+jSV{^ARZ9lx>~^;ff5{Z)AhzuGNdd|~E&o|1ox
zcnc>+s3t~qjmVmoQ$S?bjPXpeJWF~*F=vwrl7k$7aRPjvj~kjEQ-1wO@2`#{9Bj{i
zEST}-%B2IhQCiro&oJk=%N@?}!leg}-f-SIV~VW0zo9k_kM-Z(s{G)$djM9r<EiKW
z>%x~<{%zl8z87|Bg)w7_X1%=ihNA~+oki9X%xP60t=go^s5dyN;uCnZreU;=T1w`i
zUkGb+XE1&_s-fwu#a8$pkMU!g!6aScR#f)AVcZPNWI+=;-ly$>ZeSvLb79n%LHI>X
z5FZAhi_l2}9-%5TNC6cC*C>J=gc=5ML^K@27!(;$9|qYl<kj{7d86YM7_u9j&&uxP
z#Fb-HwQIUsthUG9`F=niJAU0fKm{5&>;g*aVR6P`V5GVZ4+NCS>C}&z@y7zvDBr*R
zRm2jwT+hh%F(KsC9!v!j35)e*IN8>_|FWeIVUR4YKB&G%`MsdI^v6HO1V4`W0NpNW
zismw$Kypy!IA3j%0B%5lpeJkNSRJ9klzeVDZ6LcUls<F?LKa860oOvSBy9`D8U%<#
z<bYQgp9&cLkZEAh0Hq@h9fK4@q6yMg2)-C(7~L-4VgHy}W=D}DNj$^1Y9N&8O96l2
zPrBWO-Qy<sMWf$kgRV+)Mz>BmxcPK{o-uk>@3&gDqGT&&PP12*?Rs~e&0f$@R+4WK
zv`&Lj7OXmLUaQ6F@YMgu+<JEq{5^Pjt;4E!MoQabtyL1ZazX1hvQVN%D}IrDFI2y}
zXiSNx4TZSmG}#s}%#&od+3Z<3sS5fke{@orEl(@EL}|=~4!_@6a!nu8e#`EawJz|R
zl4$bOY{)NYU0j_nGktM$Z&%4gi#cKtye?BfU}o7-6mG6t5;wI+s)`JP6ewHT-g|-3
z2J;dA39`*V77oqv?`uDor$fg~RIdt=vFl)E*TjZoVp@^8cnkp)k}X;qjfrMO+<q}+
zIhu?JXNMCG0r^sVtP`gs5F!;Y9K^}1*h*2f0JR|RPX2-h$d`C2UX7l_HM|oasl+H&
zMRei2fMJZx@_3z{bI#QxA!32fQD`lEwBpYjH_WN3dUgHA6_679l;a2fr2N5Z=ws}_
zpID5=r|ti_l2+bR{`JP5t5Wx|CDSHUNLs5+tG((sl@%3&Y&Dw4E$cjYex6HT=0m~U
zi^uy*B{|@4WeXP7CJZ$V0eyaPd;0^6^2eHs@^}1mFf!R@4TK|;Lcv=tK^dTFMON9g
zd~Hv0<jEDMFAEkt+S+r&WUKF^1M2RY&TB8}ZSUCr_*q+-l)CS-Y02xXW()(NrEUCH
zixpsZ&gON(isd_+@O6}7e2)cR_m7b+vwPB8g8^qvaPA|Wlj@z?qNXZs06-eU{KXb%
zNL-ZXouC8~5aPkQI{-95$&`zcSsBFAfrv}#?E9a2`u=@SMWRnBx29is6t3n{{i83W
zf5eLKi7a2f=!^aPzmVIM;GlBGs^2pIkJ+T(q)V0ef4hnu8f1Sh{EdPs3jHDR4;O-0
zLqs66io~vJHBgOU^#wh)3ecVaiB|A6(6LO%G89hrl`<rM$qF$CB&r>2kd>ygmJa0$
zLyMR9u3A33)$Z7=9D2ot)Gvow+1lc%%NMU)I4`{Axy!eV&#MpUyi+<?%w3qQ&`!Q+
z<-)ewuvZ3HLvTt{oi$$Db#`m9taZa?3K_{-)v$QQ#hpT;ZPtSMGg=%DUyas3y?gt)
z*RUUUpW7A^t%Z3;<Gae2ED+CQZyd2Y^_KE!yXRH8qqAm|U(&}!L39)}P1`y--{Bh5
zGJbru&3<8*);($3rp@2#%<JktZSlOx4e(W18qoR1*EbglzF8N|Z7XzQ{)pFKq4Tv=
z#)WE)r18Ly`R_2@kvF)T$4GH53tB-^(Lp8WpuZSg(NyL|`uo;7<CMYlCv&z+zd2T#
z{o6W6oHb`F3r<|HUHLC&*}h;Rn|vJ3##6Dmx}#(M_U$>mW*)dDteiZ?2NZv#A{LSX
z^PVC=OG;%DkY<x(stHK%`>J3q;hK}=A-(^rg0^zTE#)ZXWhIIX_kGTbs<4RMqaECw
z^OR+!T%%OL;S{Q@$KuKbtUn>L3>s{NPa;(+8&4Tc)l90&@vkhci1DuSe%W|bt}}(g
zoU_Exnx4SZQ(ZDjRn$Pz!~<@J8an21QylE61G>b1@{clSLch%M!DqigOczo-kUcZY
z_c~93^q;ZkmVOo9e<nhn<;Lfo2>Y+{<=WH1mwPk~paMS5l7UNeHewwB0ujVg7V~jx
zB%&$E69ch|P*uay;0k*X1%dDd@%Y+i<&_`brhI<utKWBAcmSw7yWiL*1e=co$*{!n
ziBjT^i9Leey0Bs5^4`uEyGL1P|G%_-cVJXi`u3b#ruW{H$+Yw`$z;+qDFg@!gwR6^
zz4wj?L$ia5QdE$rSWxU(P;|4pc12xWclBq%U0m0;_6C{j_nbQk1aw#TkB@Ta-gD1w
z=bn4cTb}oM$#a>8lVsw{559K;QS5z)WY=sieSa&+hc><IT$(`Mqj!CFR;70q*G{S*
zFhwT3pGf!xFm9&gN>PRv^8^ui>saW>m|`$wV#Z0Cbg9~md5dDQ5Ti}sbiX&rtCe?s
zG(0ynO2u8_&k1YNy_+iMxaPY`T2$o`U6rn}bKl?JIo02P#BTbVR4#mD>MVcfVCf4_
zsAUuFo%V*32V?&idk}_c7unEr#*YjS8pc*Q5)ynu)Pc<mmr}(<HG}HCK&|&*PocX#
z5bJ65hm5!Mtr$vaT3=|*Rxa^`aP$vdTH{|?sZyb_ecbnJ)S{5A(m8F&#gh6tN;t8U
z>HdRo^a<dar_~dwQlGHN2TnY*c8Y424=v}-w0zCPz7@fNQ2QsbkB&o_hv+k;@?rMI
zZ=)$w4<inIbg&b7CaCuU-^ls+#q(R9#&pxKJx&w%(mNoX;s)vb%?R&b)ECe6-y*(K
zzMO<SfpI$wxu;eFZZqnAqw+H}5it3~@GUlQ6ukv8hmc@;VKOmHZZ;aN>yyedAfUo9
z0a6{9zx*b2e;e^~#k?=X%wKq8BCavXDq34B5ONex+_;b%m%ULxZf#!P+Hv}g+0tlq
zcw^(~QS1+IeNn#H<pwNuTwdoy&%S-0iJkdl0Z`?%1(Cr4@_dhCIq8bW3w(A5W3U?-
zhuv2YkISsAt~fW4TdZTPvYx==fVc44LgCF&b|C_8Ai|T^$O-Zqg}ZVZpTp7?@BKb7
z(jlS%_-gbW3%DkG%}to8`LnCE57Otag(LCID%4KA)rb{Z=Gj%a2E>nEM@#_61zDc|
zqGrUzLuIm&l?AQ3nDAmuKC-HyMHjoyW2qh<%iTL?uhUx99?RVqP3-_!t5iOUR*v3m
zu~v<$%H22TfW4=Ol+F=eWPTi8J;hgfyTw^Kx-{?Bxd-evx^hcY(N>L<MoD?8d^kOQ
zbidtJHL5hPYfcxf63e|QCLLCpH&|CH{HaVXoSH)_DZN3zIh5k;p=r}r=syU6dl~}<
z9=aUieWE*qrZ}dSo4!c^22R=^q>&mv7OWxtK_o0_Au^tcPOYz>n*WCab+)oBlZ|JV
z#j<+3Gs~)j1rLQ;x7Ka4Tg(=_32Q7-`D@R`nw&mC4*Sj4^??Bc($}QRLvo=7#tLRe
zRz+E6aF`=~sgp6m(oF$2_%Si}*oM*P!b|OqpWxA(2TF!Zrbw26X#g`=h!I&WS<(3u
z(xvPgRC_X=Dar`>O9QYb+C-D17ak!Vp@CG=B<LfI%mf=HC^9fr!yl3kBc$F~DoGEN
zVmpLP15#{TH#Cq%fBH8s=XG)y*CKq9pKa2bOs@>tpf*U6fun8p9m2nQ%Vg=wIb_7M
z*AUelWvrRw)KVjQbFCl+r_1_{i|4QxOn&X&Pb+(FCi6+lm)p00DI6BA6%NxiM5J|)
z>JKlu<U`?U;WpuEy2d1K+0|p3OqRo#9j<bBXb`np!SamHLzM6?sf{KrkqeIsayH&q
z+V%L{&fzh&-Q?1F)d7Cq@#GpQpPSCL-}ChA!v2}eZ3pLNGbQI-xJA5~pB}m7LsEU-
zJ)r%m%`G9uuNW!A12OQS0R3D7F^iP5m^qt)n1b-7ML8Q+BYb&MxZ=$h$i%na5<Vu;
zPuRPI$#1S%brZ3?OjC;{%m<P?uK3}A^HAu-m3#i_<=enKymsk`CeI<?y52r45%Wc<
z;W;m)>;V>k?>q*^1>~`YNBYcv8aGH~&q^XDAQr_?wwvuvWVuf%-B}4DArdT7|0>;C
zKVe6u6e~YsMJf>z5LdwB@v{W%?fw3zC`G%m2m5=UUm?Mqpb_N-@GH}f5;O6jF%jj|
zjBpU&6}poQNm=Mj0fpU!CZYzcUVd64{kM@jB)lmc5Z*k*8JQYuiIr=!p6=q*Tyl9%
znY6Z|f>A1T-8zMmsi>$^jS(KSTDeZ_<~o_9!k-4L9DskM>LHno(dWwr=!VBKZkQ1m
zJRl?t)2i@COYRR17#w=_g4yzXIT9Qap$pHy05}9>b)}dVVhX`YVFDW|^=UxOGQyn^
zqpL+)jD_rYO-)W#T$3sMeBZ>1NKRwzwm)VEukKh~P#P_(aL4^al{=V*WVK4gJUxIs
zLozSd=@xyCJFEWqnpehXwc%+M7a4xUWoUolKM?0o3Gvad3^CHFFDp=-Zj<3IM1lp#
zS!~S5N|?W>9~SO?dmn6EYu3PawU6Zf_4NxL+4z5n#Q$v^vtv?|Pb#!9|8A&$OSr3>
zRv;C`eQeDOFRa@1zVPGwn+gX_Xb)oAJ~K|x*wqZlP|+iS7m`lxC(zfajV&UA4AEyI
za6C}8FJg^Ra+*-s1h@r-C7_8QPl4kOYof~s3l5e$0H$kTGdw#=V05r@1NHhE;omiS
z#9B)W*Q_p*8inH}&CzHx`9rk11Z$_8rUy1XRQo(F43;|IHAx2?-smrhGzDSXw?FeN
zvCF&xGV@oyN3uk(tEtiHrP87z=^Hp1`cg-bp0lLAs437PC9b?+Nwhf{DdH`{^RkX$
zQ<1+y=kjcS@x|@w4qf@<XGWIP2aYj@j;FMp`g8)Cg^7-*qP>cCTiQ;vnS!E`nl_Kv
zPPD;jL!og(;TR?f_;!B1snE)l)frx~{!<U6B=#<iCi+=aqv7>@_OWbUF9`WH`FZg?
z(w_SLD<BwYORg`yi{zzI-%Fw82?JMk{UUE}PF1>-|MK9SUrHTmq`1F`N_OL<IHy#a
zoh{v!mY**k+50;%yDDuc_f0rG7gx#2=8eL)($@5<Y;Q#4u&urO?zIlPrih&EFT|eJ
zm%JE#s?aWo`3GVpg;Eh=DdGb{{DW-ZA$+tKs8UU2;D|>DItL~>wPShLa(BqJds+MN
zWiGSHMK0Y%e>$p`-@J?rKhK`d9C6hQTfAtP@S)k|GOu3SzH~_&!DQ+-mA=1rz1ih9
zUEp+I(1rk{yU#bW(=qxMS%RMkEghpKtW~`?O=TSnne@&?cs9Lh86dwHQ|TUCEVYXZ
zRgJ9bx&MLFWDr)8_ukj@G`W%tI{m=?J)56K30t<3!ef$q@BQ)g14JpD0<a~AnSa;U
z-yXW8;wIty2TuQVA5m9V2w!JcR%Z8(nWDZzxlNEu2~qB}74h>+KM~)Zj0@=#H#6Pj
z#Kg_<{_nSooM5^)PZZLV@y(p4|C<thw-TpZ!u=CHT7j{d<`nZlBhSL~(<#E|K-@Gq
z-wmv#IBLRn6n_z;V8AqTc74#x$<N533&?e^yz)vrV@ZBW1__VSg6kPG_6!uj40!?f
z&z>yi2=*-zu0)-I%n{;!8H|!W?YFcaNEM!0?e~3AyOtmCBaW|*Hn<qK(Qi#pzb9%Y
zHpHUnR*bmqPi>t4`Eb^jXpYOB9TmRoU18SWccIy2i;Y=#ytw|t+wZ@yx#6+nvFZz1
zTmKeh8WSCe4>pkDiShI|Swz%NvO_B-OOso&j+vM_*bMYMidFLCx$UczWc{p=y@I)8
zljNx6MaePAJCc7$K9YPa`CLMgOQl{Gs)J3-$UtdAk)&Q3jMvx<(MP4zUk!til&Yu@
zHsL`}$=!5H#JDeN)Kp=`{2<jaQt`7AnT=y%I)Gr0m$${VAjQa+!A+Ho)4<#o^D?!>
z0`pvrycYI1OuM)srO#*S32{gC+9YO^QRxn|8W67_#Kmv~mADwCQHze$GTgI6E}b^3
zF2^^%YCz$dy@A{+S2%y#V1R8D(p*^@Z)AaOATqgu^>0ZJ`(Ws-jNwZR?5=jqSnQTs
z1aF$&ZqSl{%2gJV3;BnoI;ZRwg~4IaJxs{0)`F`FVg<^^9KO9KH<oR-DDCP9o0;b)
z)x1Hbl`3TlPNs7j3$*LU>oXf`Jp<+H^mMD*`olVRZk8iM>sRH-WlYwvp2OO*Tmzf)
zL-<Ik!sW3!m^Bwv$AzB?7YrshvHtSnGLQ-kt8)tjI;F}ywdr`8GK*b9fI%Y6WVWDb
z)s#VHb7R%sSgk&|_wJ)Rr!eq`@j;nK?R5mLK4)!K3;KjopVn;Elvi6AXLREF>&%>U
zu~o0Lv2(RnjgsRTqDeOdtp=Ty&D1*|=_(3jux7j7Xv!VzOxLpr)JTiF9hsSoO7|vj
zk?W)o;2D-9IbNSL-!(#^$a53YLMBhP1j4pFL%FF%r-+We_1PS-mn%%AGF8t=XHHsa
zei@&qVgu^?3x(I<qtK~f3(a9PGG@6M2$<x$5o&1>aP{=eDIM2{@#WvZftDf<!DdWr
zsje2L-;@X+M<0QQgjz>ZUzrH01H}Z@aA21QRsjq&=$%0MifWNKtJS2i&m!i_+&kBU
zmYa`>T{hOMA8}XmChyYbjd5PC(#eQCW8TzA)|ecbI@e^jMGNenBBxeiu(3LD-RiX_
zmCLV^D|w}jbSQ0kUSDEUz%_W-*u}AB2N<Ts)6i7DYvtN>=g_)=W`9At+Y?>)n((Rc
zn()uRB*K;LL)r^W+Gc;XH;^meSe|<*#}XLTFd`O?n6%c6B4`+9WxAVXIiE|W-cq2|
zDb=}lvs`9oG@KH+AV#Ov8Kj(=6j<}}+#^Pk%!-OkLT;F`xWsIzYlW+*dT<S4GxD=m
zA3Gp?^oRM&o+IwAaksBqG9>O%%7f-iyL;U58$zC;E{%P_pq1<I!e|C2mR=dci&?Tm
zvKr%o4lb@R{o1K=5DP)Uw#h(QYmL;htPL_1aGz<ctbl=2M5G(Vr*A8zIeu_Nn3~gL
zs0$V~HkL*`Dgf^T<V~5C!hkh`S&a?XGBv~|4jf#5*KTj!-J|r22aj4kZh$qvPQ6<d
z3<hThy}NIEQoTnVoZTGs?CIKl({68LuB)kI^{AF*>XCP`vsRC4UaB4ac%y2!SjW4k
z3x7TF0!zybW@d{szd?;1%{UK=Z`$K&cyzRC+0ap|$*Wy^yzzWXQ^%T7gBI&Y-&3dF
zqYBOr1!+abNUzvDhh7nXy$wgk=x}3erZ$@kPVXGGX3{`+ZlhQwbzXX^yGN;(akkdw
zs!@+L^xkjkUc3!?&LK0`q_9a)elh+IKpw{N$on-*G8b`xx1g<QbBWMTI(wkm#r_J{
z3BCaajZP;O+VL^&K?kAWOMDB|FGSUU89F-t!L))}ep)LAmlo<pc*N-i4Lq^2VGO%A
z!W-}k!>C1#U%hq_@mR=s^y30FnA%RmC79Ugbz%lSl8cenVqmrdy=>0Sku`D+4a4nR
z8Y^wFY}6VW8Tm|k7%nrUU$@zfN{&c_s)~Z?jIv&(aBv*MI^3+IB(A;?)K{;vGIhx7
zb=tHXVSVPpfXTo-S$p~EADM@f&D>ivADaHRnR&;Be5P7Bbz^DfrX3Z&k;A^Kl`G|(
z+s6&Qd*I}&M(NUmO0u)(ls1_!(}1`h@ji2Nn0y9`ZYAg}UStu8X7=z=X4cTjI`G$X
zW9<*Syq79S2BVTw?41()R-8d<V5F>G?`Qmg!2x(@VIt*xWVl;e!T`y8LZ`9m)T~YC
z#AnFCF}C9$*~#nv#mPTTmZmXRrzQWDwy=(^e3Yy^Wzclhk8r4m=F1cqI*d%P$P<tm
zphzc9zwo{E8xZnyrQpn@6Kdkwh4U=JBr#?f4o&m}ofwxlP%;KRVU^@!$!^K*l1C)n
z=npANPs&CK(G;0}&awPJ{H8gXEL1K;C6V)z!jdQ%%75Gb|6Sjdq9BGJDV;J{Cg_4c
z0rKFvJze#aKo8TE*$Jw{%w)RATl60nMDibZi93F4e<x5g$pi<w&9hmNZ^>9WASs!<
z3n`{0nPr){jn2%|i3GLZ(ghKh=dTLCTH3GfZ&o1N37|<`0whMN&+-ZJy;J;EEu!Wo
zOBTV4eWheSVuAl4c~$a0B(a}~4i>KhQhTN!oH6@DE~0UoeJO#ZVAB1cw%On4AHUUq
z&fib_6K?Jd=j!?U|JUvRwSWHB`T00C2%VPDCFxF4_?%_%`A=(!-&^r)Jq8`NUoxNn
zbmp@Mh-<VP$7u)r9~M$L@O~2QTv9BB6K4(;zW%M%2hLRJ$6fTBtEVZoP>K_VIeVkO
zd05Z?P`BU7Ad4`-H0il+zEjlxU@?SpOLf~mfE|3DXYoRPF{a!B;hkP|o$!vktj&Fr
zEI#ROD-*g>0K0dDcY2-|p>+u%AwuiQNC5lYCr_gGhbd%TpDiT;TbB-3FGeimaD0WB
zW~t6Yv)NN|QxtJ}MIHnlM>qgm#e6R?F!?iR(wAVr+So^eR4eKgr68NBLu0F3)>UEI
zdO?+N=g8KU%}wHhT(*)JAI+$(&uRRkwm#YX$l}{yBZI2PhN>=TrOS0>dh5uh%`J4n
zWme4_x@_-Yy1XHIylv&8z0GZ_7VRr|TKITbezix{F>c4`<M*sQK6GAH^9{?e9K3hg
z>{V^edl#*2Yu>jAcD*>_xw<hP(YR2^W-x@(87F2+Ju04*>0UZHj|m{TQh>>uymZvA
zJ9mv@zr6aHV9!hRlVYR6XRc0svv1!wcx|G;LUJbN2tHsQrsZ%R(a;x&C@ko4I5DL^
z5gCdhu_Ty8G7)DUOEx8&_)~$jWZYfvPR7#$z$<iHbFEBwD1RcE$gKN#i696}QsS>N
zAZiN%WQHm~E6J?a5{X<6a-e#8eTos1$m#gn7xP3Tw6Tka421jOsVqc)!+qQIzIfah
z0E)dUy*CJ$B22xoorx1K7GR4-zloD;h55pK{*8VcxvBLd!a!jl|5L~(#2s;m5a$_&
z?_CASqMtl~|J^o3o^|_k$OD1w&Tdk1VDa5|-<{mnx3>CLqCBwpi6@>&Rtueh8vO~a
z_5?V$82YQP36QQ(T>luk3d?S#vRfYy35y@o$5Z|kK`!BuzXW!ZG}zhmk;_d2A`Kr)
znMp$|q`P9qmjRbJeBo5Nmif%qpf3Vu5*SXXeb4X1rkJ9L?gmehPgW)%AhD-ov6SpF
z-d4NP@a}Zs$eT&RAG_?88BB8FveTs`^Ofg>KNH8$@lOgp!lz98m`hgF9$LD*XvES)
zQ*s}7_d4Ovb2^?*J`#_CR!;uc*NEwo_bxSf7p;lhe)!43tylfk-LQWAL+$Cetr>E`
z$O>ogJH#6lzdtW*Ke>34fnuJX^L$^_{v#SDar5~M@@+v%HTVAT7%hA#hn|>1rBkLQ
zHey2*CyPeu?*%(9Y$NMebX_?w+&r@NzFSsJIr79hM%g%s+(342OdPoJqE~7zQw=U!
zq7t~Kxd_nz<GCI%;p(2xmo2$5yJT_suxx|y)T14fg!|uGGCRFxfYQ9>{zIECKJbT(
zOtNroSv^s<;`u~9OXOsvJoRD70B4XA6uFr}WqB(9!@%OjScBN#zGo<nnI(Q2U6uh=
z!N9|uViSpICDQyWU%c|l7n9p|%yzkEx7MYl?P;;Jo6}bgoXx)W;Q9>@KDc51gS&+9
zjtWE6Pi<NAnB$*h>##{0E9DnZJ${s^xHNkFm8YM4ZHF{FZFfs+JWcMCR}E(0U;iME
zf8c=)PYB-&f86-Mp5+tB-TMj|vios3slLOl_tP8Yc%BAC1yTg6*z6I}FczXQZcrs~
z)41h6BUm+6Sg6twr0<YEql~3bPro~gnuew*Lbw1KczbErk|kY&etCP@Bu7bp)oO>m
zxVqhHZfAQ^X0b!&YbMXWUP;F7I(~fDwSQ(lP?(0)2!B1eitS!?@Q3ZsZ`(F~#x^#q
zYsu1KZA*mbZ(CMTXg1><Rjchjo>|Z%LLROgFk$r-vwDv2+;#l*YlSCCa20t2)a*jn
z^ljUo-@Z)(w(y@vOTPf-Sp$n~9(3d(lmQAZXTS^bwxB#&UC@?U(6i>#M2N94a9<GQ
zpq;TM+5(^g35HG3cfCB#=qW?^TL>jFHW;IzHNF%Qy_Id$F~S6V`zo1Ek--ejJ$y~=
zl)^NYdlE@!<^Ew;NE1iZMJD6GYvunuF1z#Z<;ift+rrbP56o?u_9B0wy^z`chEZkJ
zWCp5zO{$EKNcp<$?+6ojXS5HfG8o9tv{JPyOcn`OSv_od&{ftPm>^R#6~fjDgRY)4
z5=jbYII9fC+6zY~KM}6;_z}^>A0Ug!+`IKwEBipLaK+<lGCj@BF=lJ7qf~fC*clw^
zH)mL_N+Uan%zygx5yIu>(c`Y4*nq$|)}_-`r}{`7<5L17G_~nA^!5?hu#w&;pC;s!
z%KG>YDAwXk(5MflL<$+BCJ6M5N`m&I-NQ!V3*-dSBu(0~iT!aLV^<_43OmEIVv%6f
zb|QUdj|7WOt#R{2_Z-{JQ(4K>n{9L46E~Cf^tefY9L$iLO!A~7wF&nj;2Sh`W+Jr&
zt|Nikw@liwVUjR$v)I=W@`?GS7<py~(7t{~PwTzWU%TNHPcrV>gC37t?~9owXP=$=
zUSLg;!Djxew+?}nGWjLw1N?L<b-UC1JvZkQ%a{Z#>v)JbeTaB!dG;YrP$}*NeH0;G
zY$mcP)c`$@i<^)K(xIQ65T8#1xr*{v<GDoT1Jj`oUu2BFiZe^hkAP3&b@eX!6M%3;
zh%(?1x*Y)}5hBiziR}1LTs}jW2}<jpFom4YkR4clNOl0BZP*ra`2CL1HUm)H<eD>!
z1UTbyKuB01F8Yl%7UZsP6mc-UY*u3I5$qzOQ?N9KQW}TTSDH>;g{3Bx21Hw8UpYVo
z*il3J#Y%9qynht7UZ3r<^66U^{rxWB0^FVc&xIGR+g0dy$h>Pe65H!`t;0V*bG`7u
zeJ^*}(z4Q2o~`%nCwa3hCQr^Q=lOt0Q@Uwch9bx8k-KK8T%ToHwq<LI9e%lQoyJcL
z1-8LM3S>cVTDCmcSgp<)f1V?VP`jMSVE~qE1)+J>WULJObr@?gQ_ROngxBrFCh)o2
zy~1%)V279fG}cKT_j>ZNG+~NY_`*vHn1Noh-%AW$e0v7`zd|A5mLo<k2tBkCquC(I
zNW{oZ0}f+@WE=F+eUiJNj~<7oCq}<e4CwF;p#NeM%}Co;#+t!RmU6;Isbw$&2EWn>
zEcH^zz~LAo#t6)WfJf8vVgUTl?ntd87#tjC#Yib)LS!$kXTp{>cK%js7p-X}MJ(M*
zr$A6%(66a)3!!;dldMSG$C#p+acE~i+Gq4%QK+K@5*s}U>^^#;Q7W`rEzu~fBwMA{
zAaoLWOc4mHMf%s%pP7;6j4>D(?O3Oikt=LAg`7B#Ivgq`W3ezw)g+sZQEMy~jk*)t
zTB*WpR!FsEqwv1PqLk?wqmj|el#@&*l^ko>maC?s%xuC2m=@IJ(r0x#a1;@(R%g~t
z(`xlrJyENP-m3eH*61`6sZ<U008HjUtIxb`MbE!AM)#=Br-|1PEnjilfv*^qQma)a
zzxzt5DLKwG>*a`M)k~94kWYzHrc%f>WPW13La{!fXnOS}h4RH$75Fee{qA#>>htf^
ze9yNU&9^<8v`@ZALb>lhktzf$vq0GLy-a2No~$#fh6%af%2lRs$r~nBx*+}9V)>e!
z0$Y31z<eSwUnq52)fYriX|-O#{FzFxSA9l4Q|tAD{3DIgs9Cy#S%*kr880^`uU&B~
zW7M#l5fm)^)NQ>DT`x6`igr*9WCqHhDgi(zhM|VSFsc#L^<TF*45WQkOG+6Nd7JEA
zbqq<YJB1sMts;AWWBUl{B2$m`)j!5cMvuHRg~hmYWY3-bHb{2A4K5pX5~+Il!88C}
zLwp7kawq$NOqeEFAxTIs!JL3m6O))YZ1##XHkrXkQy>!xw5IM`IM>AfiQX%-pnp^S
z1I~+7Xb83O0^UaLuQcAEl0ip?X%~-;1tbeCqCjmJ<gg!>`A{?zHY3Oobz%91Z5NTN
zRv;rv_@i!^xlRGi1!PwOcDF5LwNfoSrzX>Auvt<9BCg`fifg=x;wI9%!i#F(z3aMh
zI*pz1N=`9plvcr%#2N#3jYgGbAvU#9L1W?7F~L<bs(3Kjh=?m_b(Ee$P1aq!ld<wG
z#jY|hv&z1_rBKUpTSWUBy*g!m&U7~lmw42qTz$%jSh!5mbxOhvcY0+-R%lm*gfe~h
zO5v1DO*o}9b5@=LWL={cU$VaahDfH)Qh<1L-h07-1A@zbQRY~7ZFYw&$Yye2`^FzD
zS|mBA)CIA)VZrD{Why%yRQ>x|>K#!{{&&0^lZ8?(qxGZ381f)$m_$lG7LE%)mCISb
zDA@VY+H7(3H(Pm5(}Dd784K2C!n29}2bzR8I;KH8#I}^VYUx!BPhciz_-P%#qs7?7
zyyQIcq1maI+u006dNMl^qS$P9S}c6Jg7GEaSEPZ(&S@qO&+GS{rJjGp?|Xg<|M$Zi
zP)R+&2=evQZ8p^iP)*PZa2*tYa1cC&CiXX<A8A+|LuT<x9&edLatU@`3-LF0KiwdF
z+&qg@Bjki|Qq|lR;l0Kup86e4@X6e{H_1$LPRhaQdehvw#6X<$=Ixi6I2Pwo??-!l
zDSSxB84*9!?;9<nlIQQ~0b&b4p@dHx-xu7Cl#vnG13IHnI?msI=5#V};-xLw4a1si
z3)_XOCJ=tr>XNjwnzY~dfVb;xiT2^EU8Z@-zYsf6fxh-}X^3wB<uhd?zWsMS6Na8B
zJU|>(s}N@Qn~%UHdL-S{=+V}-7-IDAxNm~gPu=v81nMvDg1B;KjO??=_`wbqlQfI$
z=m6RPY~ulpnf_XS`@Q%nIXa+;6kmW*6vLkh^!k|3nO^akNhE*`r2pBf|2p&~ko1Sy
zHcx)_dsoXX(-On18Art&Z5+}DocTk3Yy3(iFoL}<+~RVKSg>G(!&OUKfiD!C2q+Ad
z(02tv`kXnU99d;2{m!>Vfxc8;LWWAJ08!ls9&P}+^caHh722$Nk!mH3B1-*AOK<>m
z?caQ}1k#P1Q>$)6S`{QwxlK<Fr<pcx)R&qqykYuuaL^i`aGA%9F_wnFD^_A+Oy=M5
z_St;7HF<)jfV^F_72mE)4z%wld-hwT21C?xf$-D?mZ)BLt$AY4L=zK;n#->(H%E<B
z7CrwvrB>J9*Qd|33GsccCbC$9lIAyOKrwr;ATHVYv{|$Y;Rm8X63pN8$jCpOI+oxJ
zNO_s;rq5559Yl$~|BLq@gUw+4?|iZv8ZnBo)<*s12th>1iVsu*V!k1m7Z8#N8w12!
z2nf)LX<fQA{F_fqI^|APv5J*H{IHzGic|h~Egn{@{rmal!b**fxs0)DYI}cwSBv1x
zA)M)(Z*b-iu0Zk-dTSDnpI@Go;>;{PH7FM~J%7Xs^w03myZN{9+0ZB+h(%Hc;tWWI
zl+bppPAW6SXrMKf;V}$rNd{)){$@V@tr=75UbwlSt=(NWXZo_vF)reAj$N~M*uj<C
zZ+`9Y15Z}S91WFq#<Yq^H2&wCYnW%AwOt~7eUme<&=6gE<p*GLTKMYQ!fxS<XFCsm
zK8R!<>Hh9`_x=rpQ-{-M4Ik4nZTw?@?e*h}{#zFBSP3o42n)J{asrs(LFZ%0E*$JL
zG(%@I@Igo>_?}Z4^kB(I8NjW7W5x>)2oL@7k8Cm4z7Za1C3;L=UtUgzCU50l`J?a<
z(IjtWi!*v&vE*8MUdhN{i?M<NSa24SS?>onZtQu7>^S`XMGrsx@Wl7YEKp8<v5_!=
z!(@kWT~6}7EL-wDjfTmvWiiMr#AHB(e~%KvQ4BbJ5Pmge*N#-5q$(JuIyloY>xrTz
z6;Va3J^UL|npH7Eg-lvad<kA&gocKoQ+p9$DZUl#Oy$FpFS_)z+c_P3dLSZr@BD1x
z1oeRxlUs+7@PoGz`z_?u%Xh51be6tW-Ow6qZH?v*ud5q8d`aD!+wZvG%BkA4kg~p|
zq^-F;XINeR;PyqeYwu)w@}FCK;A5iv=+=dgm4<Vc-CS|~(VK+NZjsuBFV}9LW*)4q
zYbcF2W;eFCH)dbCYR&d3`arHaUSC{3AXT=FKC(C__xj!`?<S3?iJ|<wfPp|d;$|YY
z7yuY0v9J_*V6n^y%Z%xzVs2O-Brr%5Z)RTnCG4N+7Pj2=RQsLnPo4hiDYyHn4yK;0
zOBK9GQmJ0q=}&cZJO#x1ub_mr*x{y!(lgv8Y)L*T7Ld>fse|QD-IY2WzL#|5^ghA=
zRpP@NJPU3zQXs#CGPI=EP?LW+ifCKuiAz5cx`i&G`=d*rB5lXs72X9QftY1hc=z37
zr0pptaUb1z=|?1f-(SeGFVjxu30?oB90ZiP;Gd*3?_}DS0$LFvgP7O;ji#K29$#vV
zMT+n>aw3pK3}45nM1$a=_tVe~YWk&tcslS@0767pC_@F}-NjJ%d=6Sqv9-u6w;6kJ
z<tF*xo<XE|X1vVD4;~bm-3mB%*sXJcN-!%gTdSEJ9%?obz;kcv@`YK>I?U~!mD_GI
zrDd24eB*`>v|6eL+qv}YqAaaOD^q6X4J&HQDFkN{`<}4y=Oe=5Pq#9=-XgH&F!JJ=
ztM=@?ZD1s<Pc!I?H!q#;^*D-rPN{U6p~>kgT$G;n$V2%{GJL^-2E#J#Adjc)h9mL3
zG_%j3kFHy_Zt<)U)dqtGyrK1xw&t0$Hw{Ew_w;{W`y**j$v<LWQ$x?qguQB_WWHn#
z5I@&p(zApDVZhJu4@w>Ag=Ap6wZU2ps}+r4l);1n6p*cyMK?n!h3(kT1re7a1HgxN
zOS%`!2u^_0V8HCH7A_5dMHjn8+$9c((L=<eXjcHB`Ai@T6mA+Ab0$!RLg3lCuL(EK
zt?=a5UHguqF8TKnR#*AdspVc%yPua=%oT2Yt*p-Q&b4*9Yd_X%|CQEoq`afBWI{<{
zNBNP4w0~)}AN%T$RE{moou6Acw(>~5kX=_stB3sMb4e$spIYv+jtKbMP2O^Axj#fN
zQdajm!W%RfpA`OtIGI14y!hgiqzZ8>RVN?(l@DZQz4X;X8AXxuJ90;>8H2m3#CMon
zf7n-6=AOQIf$*=4L$89EUOhVZj`9dIzAbxncH4y3n;VQ@DV1Lt8*Xl$AQnw*xw+B!
zrBeB&vGL{>CRER;MrR)^%P#XBdNp~MF!Qjlq{=;O!Q$!evNB)DhaCsAN2?fIIw=wF
z4EK2UZkheRhRmn_$b{(2k|Ex@92Vm_l4TUx7=%%bGAgmXzt&h(>c=oj4VE?wmg2(8
z6vIJBL17emi$%E9R7~yQF+Y`acpL-je~h}tQ9mv7KvScGaIpmtc1qR+=TXWLQ+j?1
zQ>JO+ys0w-&8@A0&}~D@BUPhUR_2DXmSi@z<ecan>MAN~?N9~>Udk|+vgDK(!@a_<
zn8RMdRRsvEhZbi{D+|Si=L-iFMVgA3>HYD^C+lnDWap@n9mT;5J)WhbBeQj^p)qP_
zgER9Q{Q9E}aV?)_&z0*I4znXzdx|SYHs{-Hg~IBHVvVK!17=0L*`8Lg0?ZF@1xqVK
zcIIvHsssbk(h(_F4Rz}rOpWD@7>ABx9HQ+@ZJ6_cqC!><e+JEuz?Ps%=?eWasL}w5
z0S&`j^gb|=piQGxiHM4`9VWU6@l!;7xR}NU1R;HZ)hY^}eawj&vM8n3$DU#fP4#8K
zNmI@(aUNtw+<N1o-IZ09>(;Fznm~?z$GXgL-oVkL2j&So2drIK_i#h)pvg~O(b+zg
zJp3NVy~i;V2hOVLh<N0n&XZa~ozj0u@6wfPM~$gYemS(fqHS1Zg?0Mu8SI4W_Ny-@
zue_*M=45Sn&?XOs(~up|n>V6dc+F8huld$0E^E{RH)lUM{PH6OJx}J1W2Q{X@QqL2
zFz)_8g)^%<$5xWbpz?UKrPQCb?nzF#W;3T<K4wfs<ybTzWPslODdv?{5Rfa$VBP@4
zzRyoby)L3ZE{iA^@3Wh;Z&*!aGZ;A6&b|xAOuj)^$elpS1e0)-z3l9+gSbXHI0v4?
zJMxHJK~%_~wl3-cqh_xVV7Mt+Bf`N9kDZWc;Ut5sQNyH&g{YC4Qbglz0s9@{*yg3f
zs)}o(KjaaYg~u$XwS<})Gph&cmvoVT?-jneG2UPS$63HqTt4N2L`zHJfv50OqSS=4
zl<|ps|F-f*qT$S4OZ*MPgl&S|>SJ8y_22yAp-ojCL;TroOY-qyf4f)92XSRi(|b66
zrYxOp&NORH7i?ekx4jegVjeX1&VzF>DN>mTAlVqD6+w6MB26#tbd(FolJcWufa5cS
z>^@XlqPR^8DS;6Q3+mNHZ^H>-`-4UoMPUJ<u;)}GMfF50w*p6@J#yjYN49P)YOji9
zq?y$uW@Ne6G2wv1Vz8+6pl9JL2b)L4<bZ|8{~cX6Jg$>#<MOP#+x?9zN7k9sRF!59
z$tDX|Yj{p>9GnHy6SyGXHu=mIdTWjPa*|V3AG4HJ3~id$R>6;G(3YqP&y%Gu%+Fb>
zGpAe9V63@*fH|0-&Do_>j8+rRzyy~E0zzkLFf;67tRTz;_2CmWtU0TJL#p6>0>?#4
z?y7;j`IN{J?t`p6SmckT-zXjS#L=p6wUqhwVuH#Xh?i(gKt3Cm#R8O3gfh!f^oos2
zrh$-Nlvu4yV<ao5zCI_5brfg1^734n#h(?WN|-|>VOkO{5x!3g9~4gBV)Of)g*C2r
zMRJhv-qWP@nfpljac0q_D`L;>YNQozA?|}W5%*o3vOQ7^Dmh`YJ2%he&dViVoL_J!
zcfIh_-l5GbtK<yKhPPirHhAK`Wy{CO+7*8p^U#9ewy%lz>uuY<LI0ulfuHehz$*iO
zA(&I~1mPg1IHRLJl4nrnEGP@b5$Q>v6wW!9)}Yb|m0ugvGzycA?L2*4SP^8I3~54#
z8R0v7<|&B>zJMdbTQ&|D4>FPS_e{H4o0Vx|yQxYle)G5{{{yVn>E~QkOw>lN+Ivk9
zX7T{8_PcKKE8$I}N2@Sdh0Gw!`laA9c<J3!Gf5jeS;#nh^}h;7EaKJw^ha%0*vxiY
zPHFj^o@Xv)HuU_X_a0L7Vu?5=Q27IIE~V2JQ^~OR<41o0g%lb^w3@@<17T8p-IQ6F
z7N!g%qGuR1xDpU1p4@v#cyR#`{Ff?qdfDJNR?U9mvf;xodt&y~!%dgcbkYJ4ftg|N
zrg_A4&0a(uCQtPN_fCi~Jk~8dPr13S-lBBKFH<ne$+L0zYdFim`pb~On&Jp)X6=nL
z7Og$DCzWL_4(@_Z7*o!9HXUR>i6mXi=tVgk#3AQIl5G-tQj)bOg3r8*Tz#J7ke5L0
z?q5lG<QKld8jRmh@d?RR$dh!QLdOwDNsJ)WO@}6eqYi#LFN=`~`_8EmM!R7|$|t?*
z9KJzxG>lmkagGE?7=wLuEP~&ZPM37w`8CAzN_XVmpO<@IuHBiDTcP(6q6sD^hBU}w
zp^ry09rl7F`8juH+Z<_Gr8?}z7$w&#bXEBQyFLF%e)hp^ha)4WOy|dePUdkiHxR#Z
zc(KEQQ|27XaX9>W71)`fuPO-G6EazrBhAYxm6lcHVvCaFlonyzb}KShdeWS^GFi6W
z>qWj$+v;*QkIi>QGQxJLl5>mua-CimBUM^17rK%22dq>iemPcbA$lNoy5ab+UDh*v
z6<m0X$Lq|+`y&!N{I3Gq7+az@98HSm5m5?gI1!XcL32?tiw;^J(^+X2oRORmv`09n
zlnprMI|5hwo%5akYo@NRkB=R@W)X>y_Z<PgVX!Aoqz+Z|bixq`IJl=y*U(?`rMjSE
z&5G@}tzMZG42XIJ{az@ptuN;YMGrRs86}~%YKkuG?{Ok1Gr?L)f7$c*owrT14$(A|
zq*Lf(x+$oym)EVUr|ZNCsU(?x;%p%c#A#mzCVt{XPZu?p_LUF`m>jUpND?p}ClcH_
zdj#NC&r-(qRujj-)L0Ni`$nvKX*z8~%Cm=&9P?-po2BU}$C$`N6XHv`Zm_cn-#^X>
zdnT;M>elrW$ZUqvz0p-+4;%`!ComFP<?*d*>*3LK*XYAmb?Pvz*-?1Tw<_kfN2U!(
zdSRGTW3;2Egl93hSxoE)<qY%G83a?GWW-A@96Pf5D~9>1dgRy(FT8I(^Ht3Vtc)E|
z^A!U6$c6nyrR06<D^}~Z`qdQ(^}BGaOuxGP!uu{PU#*voy^uZ8Uv3hyjH2#nfQ6z4
zmgBL=Dz*%FEt-EtORwmlfK}K=dG-*mhq&ysiX55_-gpovpy8lkqg!GFX@9Ak{>)Zs
ziUx&Rmm^T8VOFOjD%|SgL?lw!!R29Q2AB&S^KZ*lnjIQdwlQPlNC*39{<n=LQ+(W_
zCxp|&-zhDtNT>SnO>tAy)OcE{)+om-6iTPEL-~%%uIf-K6)weiMLO^;)a=};y~pS_
z;@|G^w5k%-oXBf_eZ;KHy=}guP|0VG+?b&vcjtf8h!e(ddRU}>rPqM16TGkE;wDog
z$?ZK5XLfy|pi6~V^0;{JuHH)-jRX3wk2^}?RK>RCfXR=d-vxQr$DC&ZA^_RT5JVmd
z+xTEiDg!J5O=OGlCK&>%!=@lJ1;&lE1;Rf5mo^}7!Oodq)?T#hi>UB{@Imy8T^HAU
zIdi9%G+n-Y#rG?gUrw5s*Is)~xQ|Qxih_H3&`YP;aVJQF`dG`l{rlIo98(KVoEXQR
zerZdl@aBMUcmT=HL{9+CKUIA&Hl?_rYB8JAj3Ly*a5Hkx9i^i~>J6tRN<bgZ+omHL
z9lie3{vh4uLnZ%j)%@-KzGw;0iTn;V9PA8U4#5lOT%2yFW_1eH@21@Zi+-z2{8x*U
zPq{-36LK*>|LX4la1==-1!0r0DJd9=+qOLjlyVJGAKunhY&d(CkV{CoLNw7ts;pmj
zP@!L<(6g&MLavP)U7_Uva0t0fqnyo<8A^?zq-98JMKD;=Is}e|F=wwj5~sw8>FXAK
zC1T&D3~m&?1N4Nbt(}<w0HOgl2!Yb6){G)MH6RCoYGIU5X><IUH2|!gz-(dQ{z+zM
z{smPHqcq*bNPdT1*7FvnIU?zl?6+@?>rP^SvYXBXKpfApCF4wY4?JpOK^&lPiH*cg
zoS<zcF2yk({S<Pp8&7~SoT7!eFu?>BGQuJVG`LtuN~I4s2Zcqux^59Fj|jUSB6HUj
z+|soRkmtE5U;GKVI>dE0&js!oRSMRLHI9&HXqBsj&GT^RC*-Oip26|6TKW;LM>8H(
zAhwF4+eIlyWIqsvBr49F<$3b*kbMBUz~53EaL|YkmCB5Cric8^!bT9L(REPPLZAZ=
zl~P<luV!p9#7eE~oDC0bz(4Z+`i^lMHjL|7|3Q4%={rVL=8PXWzIdE_6w~OEa!$W&
z5npR-3=J$ET;2Tan$sia)vuU6bTmigJ{jT044b{8ZqA6)YaH2OWbv5Pz<t~>$r8?H
z-6K}58ZmO^%8|Xl!jH@iV+J=)NKUq8SP`wt5x10eILA}Qd{(N`+tTbiX9@o}yu_bg
zP`rdR!OBU5dzMBD(gRBm6W6Sr!4emvWSNHt&73(X*{pNHTggeLLzdi&Hlw~;9lROn
zRbm=3gDFO1?=1)pBt98+!J62_)lAyeS0_)8CQWZaU>+(w26mXG3%H@eQ1Sr%pOg!%
z>-0x&y~W+xqY{SV_afp;_1|$n6aG#<iA+&BkYR>OX3$Xz5~oaxmPKoe8ZayXUU(XG
zgcIW#L)gYdMBQAl9n%-V;w{AJ3&Wd0?m86F<Tjx5v{{WjHbHM5qbGzkCc<e@4K&ES
zI$Zj*U&9fetJ+N}bwv)lYZqIzTKL@HH>rVF%JyrXXv!ODbFk&IgT+Co_Raz=@^luG
zl`jpIyOSM!Wks2Ak=&I<S}QUYY>2sm_2`6W8-T#e*LuCA`ND|89W2}>eQN{Ai__(b
zN!dD!TB~e+u*sxSC_^V>y6{*g!x3qDsF7*)7y%3vj+VY@)>@Rr(rSrVa)9iscgd{G
z@R?@ASZ1`}l`~PN^c$0Zd_HVew&>*GWwjP$k{Nf^OHBsbyA(S`^V3jYPC|TlXEVY1
zA+wg@J>u<&5*{5CsHE5bKb2n*q)Yi65ERg#%E1=}w2*r9X)?HEf|tN&-tRvIJUF_g
z@PVs%#DXLixBUdvEI~&S5<f%uV<qBoSnKu4i@!Z_w!0@zM+z=}y4#l);@&<j;#9eK
z0*7WxG_p7G95jldoJQURdcRtWIR;}%hKPQLcu2v1A^{kfc_=y&@d~seIsh^vP^*gx
zd<9siV$3<^oH=vHh3yy4W?D9E+AxGQ?p6-{?4O?vRqmGjtWsa{uRWvg+AzI>G3-(T
zD@77y^%mtWL8W?7*dUY%8y-}t47))p%rQ=edtA9&bB#GYH#gn9E`mS1j2dO@*s-lj
zjd2&z%jZnXt*Ob~WmGG-?AWnIsYanrv2XwWeF|Ffv6o+dj8>EYO-^k9kbuRn?yN_u
z7QW&U@UP61T!4>LL<d_VeYxQJu+qQxmvTbF$|An$zGKekiPZOA<9x0=k{Cj<5#%ND
zM@ap!D8awptzRu<hqTOY!9Stz_`Wba9utLl^h+%zr$o;?k7ZN@V2I^I$V=jekoxJ}
z`qjcD`e#W?uNR*ASv(9`F~zA!)HQ@##WGfMN<!;N=@Q*o0aMBsX!9^^^3?Le_@EgB
zxetSz7yw0$l7K%^RZbj0(Aj{o!w>~HYZwY3EHtn_P|v%FMu$N9h0!`j$jEhscrM29
zVaI8UomKda0R<o0ymi*Si)TjdDuP(zVb|riy|?7@j*jU@W&}|QZvlt@FFw!1jLz6l
zIByBNcI0ZI(dRS?x9OZduchq7;`hsfj4eE8^6sWuDF~4(ADp-G<MvD-<~rrc@0B2(
z{evguG-Vy2V|ciiS4|0zv;!U|XjC?d33L~s(qdSb7@!1=CL=9T5Is1b#T`C;OGa`e
z-At67Lj8s>)kZUWpr~co{h8eH4?ZP1exW)`kZ`kSGzjlFhI1x8nPu_w%h*mQoE|gD
z5mKV}3pYIX6jGVG-#sZDB3BAWlO|yaa~&H_b_-*Lbxa`xAOLac9Zs__3q2inXOVx4
z=1;OiDyR`9R|zceAisvQkVi0xPsRnsgg~ZZP!^i}G$9Ax00w+2CPIsmS&I=?LBTIn
ztbuJP2=$FEj=_Rde10#MJ#v}01c|X&^{Gu2s<`kigRGdkn+?vDgD$?8@WI<=-^T12
z(00LI5HuHts=}k2thVMwoAxnR6y+A>gIkw$C+e)<-{XIS*If@=@{eM7l4FU?B-<4r
zsE@4%7C|#?g3vs!X_ZG{n2pKx%qG2S<)oQ|Yypcm-KV-LgRGuDx6zSdvHFNZenV;U
zaHqAIed@G$GG6SP`ZH~Vq-U_v1;Cv<41SGGlAYiQI3oFr<fP;q;vv8qVBDkLjZ!4C
zg&oJA!S`*${{dB1+{5}~GJjYGx<^}(c3^)jH6l{Y8o`WWW@-$Z*pi`nsrw0|XBY$k
zR0S5XZ`4m^E0+0b$`2@<qGCvG9K|*>*v?T)EJ~S&ATx#NHLzEP*GNy9vh9j>s3MPZ
zoqrnuaNxbAZsP3mAY~@8V%+}O`=va=sA;u9B*0Z*Y^Q7=dTK3%j}vblmxZGT&wW<(
zP072=eocYdU?o@7!2HBY6*4ztRu|HexYuNNn;oadkI5}d9~kB`fJ9(O39<_m5Oc`p
zDJjq@2nl$+vXG~FuiR>KDGZroGVC&sH66JRM|$VGWgeu|G0Ej}iz$bZv)0%%vPG=Z
z;dLv#uF0`%f7a!|m>czF5Fm?Lt?gxn+nSc?a#&nSw>2+1u*~@kr{VI6Ic#$m7hrzJ
z#pEH+;B8u&&0r{FP0A9a2HIDa6J>3lv|uclX1(C*)7L(9&4%1a?$V`LY`Es3YfoP-
zmaWc<<j<X(AIV!y%gB~<I_mgztG9{;UkrrrW~@iDGSjj%?-owI@WS)Y6X`8w(!dP0
z)tT-LgCi7anaoNqSH%?}nWbE2${GZ;YJuDYmIHHm5LaR-@UnWQKvtm6HLssz^H{Cg
zQu*ZA!0fOs%#_U3ZW`dT7=q>6SdKSCQz@@5X&Sf0Xdjl*dwx(_(6h7l5EGfLojq9v
z16HnZ%493dj1Kj@NGXsPF27^ftXaG6SiUet_`Gn@b(c+^eA#u27VhA*{XZFzPa!p)
zC=uI0GxFAhQDG{$HI^XH_GOam@vWfOfiV@`&l)s~D?BAi0HPB@Br<Jdt9KlU*l53^
z-ImId;!p#i2RfDLZ|&{FQCdZGT7WZ1&F~PM`sUT3m~GvJRPP8$O#LUtB1(x~F8T}4
z8YvHW5Sdl&4oJU@o6NO8jhH@c^5o{cDsNpKiD$(;7MI0i&&VpztqSA^<tDea(3YJ$
zusBYv!K|X%+WeeQW@huOna$bU4|V(DxjHDA1wra_hI;OvyKC;;U4*%6V8^(D+h2Qh
z)v{%)9wisI&1tDAn^LDBzSh`}a-eTwvL9ou%n!vr=R2-6P05U<%@c(OL&f7r>%TH{
z%}S$IZ*k=YW10Rey+*3Gnq9e>@#?JBU|poJA=GM~v13N^5k{9ecE`pm3Pa4F=tbws
z$><X&ggX^w9c9hs!h=`nhZd9w4{l`wr`2Uchn8{QVoAkT*vxz90tPvZwb0kxKqQ5r
zwGD%R=$Pd1lAmDlQIG(zB2$4jDFzo**bhIf-x9P%Z6yd5Lr_ZUhopY^V#N3QqZs!r
z{;;2peI`ROpgd+R2MajL5I*Cx#c-GfkY1dK{ud_|%<1s>VrVOl+KOWklVcHTukbRZ
zeT4?U1y>Ja7>fEWbdD0YWM_0iaR+w#Ea+YIzf6qN!3ojRz*+{S6KABWl#maUIB?oy
zm_=QRE*9NbVi_#+tXPQje&W8q+l0JMQXLqFK_teQT8RpD=q~jV;C{r;jeST&adsa<
ztqpz60ptOW$Ovgc^=SpFRBWB-s&RQtU31ed+qaYIX-{O19FawQ+3mw~giq*_yfiMi
z$67zBe9{)j#g3-soeSrVYGwAQ3~qbao~2mdHUgP4xVH9J7YOgZ_12ziujSuJ^{qvY
znB#5J5;NmL>NlG$o;6D0D0BQH<Ke@OBetIgWFE2?C9lZIdDePxXsR2oF81CZvk8An
zD|_A6_(^F*xP^>~l^nNJrrjf#bBv)p?T)Hsp55v&*4Z-#)Lma#A$;nvI1P1Rl2Y4@
zP4VlBAiw|ZZ@aI(R`|T0`C;bz^%=m5WRzrXS{3jY75Trg$1l9l=LqHm9ns8<D+3k7
zuAQ)Ui}NDKkd0ewW!btkP{6tZo(WSHOk2v1o}avE*s!8l>ClC5Rrv;FdaB9So~qFN
z0^zGS@TaPZ=)l)b9(^?VhS_TdwG|oP(Lr?M#`TmDT{(_RzW!ls*svILTXl7QenG)B
zq8)8Rm=9B3T~R^S=HibPf2K^y&3%wuOlu}PXaW6GQ6XGZSvgKKa~dZfW4E8SWhxXI
zp3*#@Wg5|WVV%LY&l^?vbylTpDnM19<Z@iK3|D0i(v<bd<)bScdZi3FqwI2r9=^Pw
zc80&gp@B<R74*_VGw5*Zg|A<Fsj6!0Wt9wJl?IO~l=&CDP03N14<+~}`@T;VV(I<(
zE=Ncf!r!!Cau1}D7wE`(W`@SlD)r06B=?Yr`<IKPG%{9-{uZI>O+-%;Zz@H{&p0b3
zAcvO4j2ak9Q4X3Y`hz0q?x`Iy68ybqqK<c*$`r+z0I5(W(xk*-Jm|ea@Z{qL#Sgw$
zM)<fm=<!E_?jUP`QfFXPMyu0KCKm@h0a|+Mj@Ftk6H|u-$1P^Y2u!}-%8s5&qFJ;=
z%eoo|%@|POt}=3(0VeX4oNrah=H~K-A-o)v1MM1Yg4kt!Yt4SMc#?KC_sf$w2hfvX
zKA<OgSJSK#tJa&Cp9b^U7)cnFDKj8jdd{@IGFX)E4i@`XXM4#!6=yjZh=|+UE2Ac1
zwp3|aD2J_Q%HIhuRr)gL53X#oo7D<ESmG4Qy}R@Zo>{tuTP)Wo$>Or!Lo~~Oc?i)%
zC^|&6DxniO22I4|x8ia(^8PtfF||eXj^|3q_7Pxm#$X(uFIg_RTyjHd9)=?)3PF(f
z(?##Ri;0;|yKt;w-lY;g^mcLDg?l6BkLrMXO@$gp(c7xQ(n%*^489<P#92(@3=V%M
z+&8^!i?K5kGV-m`%Du;jaXidS#ii$K2-0ec$!9Zq+~wrqh0;jzPoLE{2GT<n^~Q$w
z*8IY{hHzS;r#;O$sB?H>F$tSGHyZN|HMya|=>_TPY;vhilU|@yZr<fA(--X8#VpLr
z92k$vx9kd}k0`Dda`Wr+^Xu9B3L}#`7uCk*&ZyLv56m&!_#c^bwTU$Yf_}vb@93!?
zSJpW+R-|-UoE{1{Rn*zFHhr4IxFjo>Mf{5{wk(y;`oEC@uWF?%@{HqhHr-n$!0VVM
z+)MuY-rDk#vV!CVj@_!VI`Sua<pSZ;CAIM_OA}SG%votBQ-PMb|C|@cO0>`&zlKgs
zzjMkwWJF3MzmM8Y!+ZoHIz%5j%OG<yfC_+gQUrPkskCXD1u7O%&oL%6SaZR~ZLR(s
zT6uie8#@t*rPo)EN}t6Q%Zc*G`;;#ENUS_&inNcd4uA5b9I4Rc>z<5~o3V#EB<y{@
zq-E}|opbL^A62Q>51u8BD_x48?vyjiPE@!lJtKR<HFth}`5wZ%O=cQgW;Pi&P9*bC
zfsR*5Ja^_ftdJuhWN>G19*OToa}i_F({U^HbTJTQ#EcYa|C<lSr5<H)@&|T7_Cs4I
zUe{5`b@x5!PUgGYsuxw02Ks#e{Xy^ReK_(d^W)eRwNvL83ke~fdhm^p6a5rnFLwu?
z_xC+GeQxR(NQik3Qof)VMc05$AvJ`;@`J$;R=)qfO?>z?d|*O>*h^7vy#plPJ@pS2
z`(SsY_Kq}2Fjh)<6sI<REc(+J^<Ph(Al-#BrSP;;#x8=-Z&H0vcm1SJdK8H^>4s*K
zc;--D6Nze#T}(GEPKu}e59{o|S0DsYu@iNAT1Ko{F@k+my!`FpP!8TM=6dMGv*n6t
zK<cljv^>Z@L1|A|gpFb{z@wzb11i+_`MsF`gwx>G4_>yW{1xGIqJJr4#H{u*{Yw4j
zL08=W$o9r76w*~vWlw*I29VOfz;Tdc3nD{v@ZG%n645JMS%dNx==DuGMUU**{Y+tY
zlT4vtbAAiy(I2a)g=QlWpMk36c!(OzwSa6;@CRNWW;pt(8Zj(dZPc2A7Y_^#OGnmX
ze64zk59vFBNujC_UL|bhuzFG86eY?BowtO2dETVjwNtC-P3i0!#gsH(aK#X*NjAB_
z&6n(-bkqG?{=Rk0B_SAe6#Pms=rgN%N4mRWY<(e^(BJ7pi=Vt7@gG^>+f&Xwy;aP0
zC+4stW62%NPxIGS&%bTT;<a0!Gb}nZwU{BGps64GhkN!B<qZSlrZTBo#jBFn+wEZ|
zQG}~k4u$kTp|6RqQZT9_wOXSX(Lqm1%7EcnD^NHi?0T@Jihd?PwS7szd5W(Zo^k5)
zrWrH%Fyw(4<O-Ub4esz5nEArQB5gc6>4Vuy<)7h#o|C*a7=7tyNjwo`#?MKW&3=Dk
z&ofNCJJ~Ij92I_;`2K8E{IgQ53rZl#OHr||ST_5ENvGms-R{)=NCk|kdXd9e93drr
zHffm4C_3IM0hW!4QoJtG!%2rV&B+rEZ=JGc{X-L&^_4x3g)bgKIN`g$Uhw3y3Rz=W
zjV?>;r~}YkDw)_+J2rXw1>=uwNQ`6}N>6{^GT%DzFT%GIZ+>|t9|>m!>nBzQXwV=X
z8&d6(gPC}p<O<1NIyU$W=sGD=I_(W~9Y2_UX&y)Vsf+6-s0zUUP*V$H(do4Os~c2}
zfhIydMZJGh>WtVK(e2JU-hR0ull&yfYYVx(IZavVo<LiEUR%Ixv4!pa9Irdn)*<fl
zXNVhlez8hkep>)GhfG@Kmq&<uy*Yl6V9<;KslRYDoR$nKiw-flGu)<72lF2{64dSC
zcG+E4tIOeZdmIjvUTej+ySET)B;GCVbURZ!&#UKjxUAi9hja_^zW<9^ed~xJQBSTt
zJ*^^iZOeb$5c^F+^ylzY{`MgyS23`FKKz$Uew4sjKqNmUNH-J5>Zt@L=}9o?bIERr
zM8q~Er0A$PQV$;+I3q-G9X{?rF<_p^kAe5j89~yYF<1C-A2LWBJ4U9w{y598o_`=I
zd7Vr-#$1$qZ~khOlAE!Wl<X5eoXgzIN&rwh=ib2ZmAW@NRnRYter93u%fdH?`66N!
z?^h-X>(?YN#z*t9(AmulrYq#NHF|@EJP1+~@fl7Ctrmk=tFKb3P8bFPg6Bg2<;F-l
zsRRi$n+>`vhP!+za>vu2DUO3MJ0eWNCWTNB)tB~Vnj8d!JP4xTF+~5Q&O$%Hx3W+;
zO6LG%P*QqJ0zoq1_|D2XLt7%{-Xc|c<=EBjo%hWA%f9=Em$^pjJY=)*^EKaHGUn>%
z=8U;&7O>OV70%8}hc64&wvQRxT&800T{Lu5AyHes+(xI{)?C!Y#-)BwmJ0}&uXg+~
zSUS0F!?26o!{?06T=YO^*B6s(qkA#}WY3MTHP3l*_k>W*)ae&3+fn-bl(y`u^fX&u
z<(wwHVc`KFbF)>hJbqdctP}NU0y@5-wcsD4e4&^F@F|9oj~Pz}`PpxU2rYWUsH}@8
zr4yc&P6{+23-O_r)R-UZn<B&+!VCW7U&zAzo=^ONOa;dj1xjIVFii|AeFKWy)-n1i
z(><9H7a37GrO8$v9xyC1V#dRBS#IJz3m%(jR#jy$9k*=Hf!T|f=ga-ptU#=+C41hU
z+5Hhv<mBD;N=?wsXjDv~K&J}~ELD2U%i3i6&aoc3&Yk7tE1Iq<*g136prXZ(PABsp
zUb4_-U(hz_o)vTMn77I@xng{IW7u^$^I?Cql-Tb@A1LKiO#?rV<eaRu0ZI++qbXtF
z<E$Y@Fdjhn%V+fHC7?YcT%s4_nfhTx#Hg@-)#aD3BAb99eVs-?B_(~c8%x(1I|YTF
zbKLL_;alNl;oFYkmmxdYx%kf1`|G_&$|5hZLlLG|XL|33aAzRzP<iPU#p{UCSK_s~
z2hO=75qhDceJIhZ&$$_K+@}x-4F5Dj(GG9$1oRqw9uVBo`}OqO2p2=VhhN`n<3zH0
zip!^cMwA!QF@&Vk++85E!t_bS1e8!+4Z}JW2rWLC!o)R7Mh3$BQ^K>Ee*4k7L0gU<
z-LmYyTOKo(lO-fwNS`*x!t+PBR8`-jQ(AQvzww@lM~R$N2|o$jg`b8s)d~BJzGrMb
zcOZ8fGOsP2ap?)_C58|7!BOvtYZ9NCsK(DYLK02sr_+uKKOVjMi&3@LlEju-JO4!F
zN9{t7twgKx5N`6OEk}uXUYu#l-L+GN9Or>|5Zt+x$YPJcYYoU^NysfM2BcG*8%2%)
zih4)`CSeHeJ8+l6E#BvEHL=hdC`lD87<gkMJRO@5sC>W!(u5IxFe&=$M}!VMgK$4v
zZ6<54|CCF4Og)2mzpZDk&Cd_wLtZZA4SnP`ClhA3+sq`)<Pde1CM8%T9J3VnBO}{r
z;<{fk$3|5B{G*JTBy1j!O-Ok2^O=R2Zg-|TIX-!7B06M9G?7{|;}<U?&kkK#Rkd=c
zP%%@S7cRk^@+0Pjd>VgG<5$oX=v#yq9;TKMx=tCAM2I~GZ#u^MtVoqogRD$=|0ocV
z+7kNGQM;1HJW!btygHce`9~swWPKnK2{2Cvh}_nbP1o5g#tLuWeZO%0UK{%+E$CT3
zmW1!#^7TEl$+Adbvtjc)!mGD`FU*_v1l_v@+ob4@@5s(+M*|V&A5F!@O~s=}kBs;O
zkt^@GS9s(8zV%u6enqzUBcn#$F1-5gW}<v65)ijY(Yu?4@862hm;)66P2XWIr0>>+
z{=Y)x+GcG=>T?p~iSzMj08B+}@Hl2jSut@lCJb?2!6wF0DkmE-%BIMpFt&QRSOf<^
z%N0du%sm#^E#Q+vSQed?&?qsu4#bIvo>X==m^KBYHd$>o2%SZ3mIA05`dx)X40~kh
zid#eF!WCXNn4!-03$N@qrs=BI3@J33ht1lOp|z!JLgn=ybMcLi%AfZA<Ayzu|I36I
zmIc-7oW?O@+dX=jU9aQZjn(P#aY2^5R3Y~<!%N!_`by-jWopm8o}AL9qb9l6R(rB;
zX&<`zDa2RjXEoFe3l41GUp*|Oopfi<o<)myzRg`EJZd3NH<a}(Zj)y_7@3USI#n14
z3XjR}_<Oz!+;)XiYag24HZ@)<?8~aX`oNtB36oRUVl0ZPcyC6D+XO}vlPTbKTJ8Cl
z3`kq%RfEmw7$eh02k#x8;ft$h8`K%^jf>4#=WO=YtkscYbJ}JkA2&$#8x~$YW6;#W
z^Mxi|&7_I(T|&>33$x1!U=mcf$NVSCMNUMBQ~q@11)+^6c3nuTetf2)!4PwQ@IUS;
zg%Od?oFQL2Bw8pxc!M<Wg_ZNAQxfzVVuA?E8eY{N+;sDi$F8{c4$Vt^b#ZyE(pegw
z%)EI_dq-dS%Un%_mPf-yF|r^nPpWe>qm%oRSB~Nx25Fwxn<q8eq`Bl`Vq&I_;q3-K
z-`oA8gwfyl(7&F4>eG9=;!SH-6b@<#Tz-B*%fqieUoBS~nc7-Tr;%4Z_xfwkRm-(n
z-j`m7XnjT1v+PT!(8K8;$ORb4Iw2Q$z~v>P0iox@l>tT92hpr|gMR72PZ_{E)o1vG
zZV1O4Ml_0MrW@=DG3R2}V&O}11&aD>7oXfp5?fDREEG}=y$kBTelbviSV4Ary{OE8
zxwz|eg0At<&9|N;gL|&RQARD>Eh_bruEp$Ptl>7rcPPp*I(Ypl!bL>Y(_8G*#d*;o
z0=qB@DX}!}t8dq@Z3R)C4$gqLh&4q^$NAPhKFwu+(e8F*;S&BIbMGA(Rh9OS&$(q<
zrq^WBW|B;LPi7_wB$<RzLg+R0(0i{U!q8DbrK%vvidYZ}zV=3NSH%L0uDa@4qN}d%
ztFEuR>q3&bd_T{<NeGC$`|j`k<Cn?Yd*=3Y?m5qS>gRFQ1UA<tB-CvP)Hs3K7&kFC
z!5MTV#7+jsA98X7YXj1SKrM>N)u#frYqvGEop0K<tw|_s+QvP(gswshsWnhjT3Qom
zb-BKxZC`b*R~!h`)C8m%PUqv<HQb@gX9FCH@8aR$g(7>|`Qn+6J~GU4=ZnFsa`Ahl
z5BGe-Lele6Kk0e+E3D(@9AD8MUUB^R3ch*8arP3I(S94ae-*3X?!CPIICTdE`2!1=
zI><m|%AN*4qD7#7*TausE9Aeuh(NvzwD3OFan(cc6n;+iqUyBjH?X&nK3~HVAyby1
zOg=;%`#R_vCPGj*c^M1=l@C8CFB%b09|DnmDBxU;om9BAM8#4W_R!p+v7`GTKM{=g
z%;)ywvV@WecL5$s!;sy_f?^4T9Jh=2!8Zf=LK+wJRyfaX4O!hV$Rn#xhT5Mhx}7@C
zpJ5d>B|v8?;LvgS^b8#r;O(h)rm03&G(1)ea|g95kK-&K=QzzH9i>HDWG%Hyi>)4a
zig4Ny$Deb=#XDYQDQ^iWZXmAhummmaW*hDOt=p@4&K}pE!8S|BZ;_6(S+?x<ag009
ziE8fo=ZqHaere5%9FkF6a=AyC5Vj_{+NJla*-A@|G?ER}wl5OdC~3QZv9dcXy>aOD
z(fi@#`C!r=EbG%xg|nyB{7Or7&%4s^@m4dV*KcEAWshY3?>F(xrF~!2N)0U7-h32)
zLS^BG%-?eSgX;&1+<IrSAl<3cIk0*}t97T?91e#sR%>8`g=B|L$EJzN4jcn5i@?&%
zY_47#>vQ7I7ppc%2bj-gG)d13$?a#^6zQ;qPY{rr5%Cf{dzFoQNz1Y3GiNMqBh+Hu
z;MqtCbv7*Bn!tk61A-aHpHz!%RV}Nz_v05%YWV=boGiwZ%oroRc8FDc`-xV%(El~g
z(DGRhFhNhV67x>!i;r{Jwl)q;;Y5qUpH7g9kbLQ<Po=NgZ<M}d@qhedA2u5qBg|-n
zJBL9cr9La;;}b5NN;ax?X(92#yT-Yz<f)Au012Mj*#5VTPYLHA4d+V<`Qe&8zH#Fz
zHlww6(~B=|N_(6=Kseu$BfpnIcQ%6V+yDy&WxmcrPZv}?dI|*)BL6r2fUwDID!=kW
zBrlVo3O+3^9?2V}l$DONtm*tPHf=&*>H6r)3nx@9;)2rArN}8UHPa-0B!ySb<bQkm
z;jIVfv;J>7ht!C3u9Fg_(_==TXOqv~R5NyQ^t5z+zp-osSJBp!P2(IZ#?M?ORUt9F
zqqt^-`z&i%aQmi5I%ov)VEse(ktK>w?u;;Q&==I)9)ve{u*3^`Ewe51cAf-YxWFiR
z?lf}tBzMrQnSOBN+B2s=-@Eto(`O=U#Dgu2`{uxbZx|>2&-!zR);#!f%l`c>FF&|u
z_H~bref`9VA49*}d;2Gk9$B*Ht>teWJMp@(s!dxyZtvc4<-&z^bLO<&TVBIQ2kqQB
zsGZNrO`SI{h2JjRcCfa6cuDb$xnQP=pFV~;dYsHnQ<M^9j(??h{+Ig|UX=uq4q`)0
zr%YpDX#6P2F~N}}FQhM$9Mh?cg@o<bDvR5`y|*px-f!2=*8ghpj6r!U`-Oe&drVtT
z9OFKACM7wesdNE=9$^{%j+X2pT1vy^@*KImAIp31{r1~?m%WS-v&Fya_0*sDwC}4e
z^Zfy|Hv?@@CCd~7XguXHBXpQVpmb0!vpjfo1>oIU31sWu@Ov8wKi83n+n9i?eKSF)
z7b41MB`EbeSXplb7UwQ_e%+xu2G1`Q*b;<<%1d|{P=uHJ>M!6o-QB*FvZwnOt^zpo
zm%p^X#2Na9BisSni(vSleGw-j&jK`YFoa|WQNYxZN}e->L6Q%Xk%FEN=e$rpW)l;q
zR<&P<YQ;NS&v5&=qpfF#BHfSjS8bkcPR2J$Ue7WQo^77J3g7EG*6lS*m}4n(E@ciB
zE|=S$_Af;mzALx?FlcG#b^ZS6w)Iaxy?(<}Pe~tS^sMWdv1qb~Pwq7-F;tcs8ZtPP
zmFY~WH-jrr(<PZaE<<7{;DdVVR_S3jtcE|_K1KRa%zW)N>Aj^(_jdcgC8fY;O36>5
zuhEyEl9KN$n3$iEPu~dz2>X63?W#ZN#Nee@Zdy7x?TTyS`l(NCP@b0Ekd~zbYP7Sc
zq&i#g%1zEM(6AWf<pthX1vB$8yqZHEDw_9+zgUX#w-Yjt1^(1m%Cg{ee-^+dN8|)$
zhGWuQEr$=c@Y3OyyY6aXE!BA!-p{M9&SQ_{hPfZZx$Kd=YPOB`9i{^pEj}!iwLYI)
zU7ah|(ehWn!V-5Rel!#G>jSI_TL`&aWx*(4BXj2@87Zn}%<ZI{B%Xo{G+l5)3bUag
zJIOj{%;&N`8YcwB{Y=>V_J@Z@9$39(*32cVZXbT&*XQq=_WnrGo1is0drp`BzHakp
zTUq?MRqr0&wRy|2u`@QWpOiGy>PWW!{;rC-mBm`KGp@&@6HiG(IseR?FYi9|R%raH
z&6`$@4?T6qp=TQ^g+#m46dP!qx9q(wXPIU6_WSPNKKlCUlOp~khi#DKuJis}zte1w
z?^WOSqCe5x!P7=S`r@J2$$@r`S{;r!q(*>)4`~YEazlRhgx3Mdo8<0dp<_+Fsz#Kt
z_rdjbk~*m1$*EnI&yxgXsCNm7)gi@2gw!EQA^H_m1r2lfH{{hD-nh1Jkqk1Hznu<g
zha0rZ&z*czQJ+}i%rOFjMNWFs`75tNmy33Hz~-AJ6_VYr)+EO2ErmEZ-D4`L6L_G`
zq#JF?F25!nRqR%8#czGMTyHpTV5TO195}&97se1R$Ntkgiz=W&0}(oX5136mfQJAO
zt%~mXk85q;&HU6H(jRu)apg-YJ6$iOn{wsftULKID=`-w<~$vI5GfuD&0^Q_z6`q$
zSe$+zFEjRj#bhpLzX(A~<|}@OTPVH5zF`xheQtbHYL!~}D7L)N{t|cmP3e1XAsZ{T
zNUdxPi@;LX9=283+QSy82_iP15b^P<=uGa8_I6%~0G=_@{wMAZxxgYbB$che+OBdq
z1eLYG#=(CW5yP<kd<Qw89@(XiV1g#YmnK7oYyRhpkXw!!{l$e}Mttr#$O;$pYI1P&
zVSXXFOlVFtJYu6{Guyv$OXl<g1`;Q0?0CtMvBQVkg0|tqQU1jR9rVxk4{y!uxD*`~
ze%tCuIvHUq`b179IjnEfo#adW%iFOqG?9^rg#IEwo1M<P=2w2GYwj6-9i2N2I90>K
z%+D%3mHG;ngFxtr^lpW|(j&bh{lSKvIN+aLL_iX2`s*BjGQUhQTfI~(R4ShxCK$V!
z5nKu}iwfTe7FIS0=r9@c5R%E*SfvF?g?CLCz2QU91%uGim-axCBRl{)k%TaKFKd!`
zF5J{a4H0Q#Dvr~S>N8oBpqbof6fi~b7lVJ^AR1$=Hn%Y?->x^t7-Ecidw!bHZ3A$H
zXyEA(1ZdyA`?~i1*X`CN<_`^web2?c^tQEknm0FTUe9?+x!$zi*0*2M#J@MJdQ7$j
zp7&u2B??ElVu91zInEAv6Pu1l8aJQTqjhMIQ9CX*1t<ckNH}NEIIz(tKxd_EKYHCw
zH(gh`<i-V)Js*X`2KbAVXII^t?XRlxXWv?tU0#+sbns`sbw_TYc@w(%C}{WqaIA|k
zYa#I|tSPW#k->!KFJCI@nmQEVq?`b8rpDylz7o=iqSf$|tjbu)7}YtDLD7Ejya0GU
zV$mpFH`MN#3?OoNJKc5d+Nhy!!*er#^_|5qcyQmQ1^)O;s@`4d@Bss2uYV#e)BQnP
zrsgJcs-+`8NkXhidTi9^=(EHgKb>~|*V2u*-tzi|ca}ctmR?D9*sOaBa-oP9BT$cD
zse5OCn|W&608PvnM;5-?ckYlcHpFLiYRKdB7J%Ny7bm(Rc}ec1gxN~~)Q>smM0LF9
zgJ|2Xg~{GzNOYuthX(&jwY$Q9sNjdv0v>lT&4fPqCV0sg6`D182En{w5;RFLb?_k>
zd;+ZoOBIQES9+Xu#@BNlv!ocg{_NkS*1w;<zINHFzMfn`O!ibXm1iPqr*O)KQ}3MG
zFr|=Z=FIY@3Qw{q<a+w9T2?DXkosML9YE_f1Q?X#O>#b{>gkoq$(7Tqiv|Z%4Y(98
zsE?0zTZEY8)Fg)^DJ|I`m}1@W@KX2SdWO{CV1BTKW}q+GCFl!%JG)=W97VEgM2^Ld
zm%XQa1ak+AD8dpmpkE8c!`M%J4^n}^7u|=R1?6!JyphPN;8U1q^rR|`OqZx)MS$Su
zqq}USw&<;*g)MfaihW*Gr?{Lc>fL2FE@P&2%R+6cJuhbcZ`7%|DdI9|%uK1JYW>0?
zX=y_iuCHp5IF(w*3(@<5IzN`P#XDJCbh^U>VCXLwrLq&d4t{KPaAKA;jC<JOiFZnc
z2X}pRA*Vi^mKLthxj;M|2i<u@YzIFBYZ`N?G~}R6$m{S+R&<Imb#!X&toaOzQ@mlp
zmPR%se1(Yg!3Qm*|AS5uYC)yA|F7!}G21`ee4J%J48@gflOY=r-~6%k3`{uP4pm%>
z1k1zBc5usAyUq69(w}W)EmF>s`OFS`D4{s2Fz5&cL(z7U!pX$J#3vhq-3;~(QX-Zp
z&!)17&7O4m2GWML;|{+2=XVc|!)o~(ce1roo2;~)N#-KOJSF07OHH(usipOIzOh_6
znoe5F*2<S@ja;q^krG*#Aw)3mRw^-OfY4NF;P(BCO&Carr46ohpg5o(ARFi{G9}Td
zJ0F^_+I13*DnCh+d|RdXf%L)2UB{{s5Zc?R&29d+IaixlX|=1XqxW2{gz%ew(tqDa
zt-Pt*sd8~sEbII6eazXf>7*szF=xYuIgWVC$+ixY8MT4ZALO~F7WmDuJ<Ae9XL|!F
z0qy-S>PKA!`V<fW1Zt%RIx8ipD8jt+ZLGak{r3HJgTcbQZ>;#JQFUpH$rjyuxmqIn
z72Xb(Hq(|%hhMvP1<{GD2j65lZc}X^WQS>M>i)LmcO}PQ&LxD6|D<m8?x4%;g6HiR
zA)Q1_88&Xvx(-y|p!do~5dU=};3cmuov!of3-wGl8}4*rsyM~w+f1A1jOy4iw)`;L
zefU3YCF%yR9S$tiGi|OmUcYn^+Pd4znLDv#$JDa5Yk$^?r27HQP)msIE`x5r0aiw`
z(6~6HL;rcd_x%D9p&o)+(}i^8767mE#WF*J=@K-B0b>UjgNL{UUQ^WNkWN@KtpDqN
z`SmMw20ZYU<OUJdXU{$O;JLFbqkRupm*%B24;+}eR5mno7jIm-@<uNF3=Q>X<Q@E9
z4ocrYY`KCIb-O%M2+}zK8#|XSbpqNr`uavTZ{tP;L;h5L?DLlU$`zskCnCW-c(7S&
z2kR))x$^s3K0k(lZ9&B@sWn6!`T!GjB7Cy0(dWQEtKln_21}$&Sd~#D(=f<_-3J~l
zk@A3oKL{}@?keVoK?_rg3TVA(H#8R{(F}QjCNcFDJ#9d>D_Q#Sskf!0y_TQfGeoPq
z>GQ2C{xC-FKi%HE)Fb7|-SS2Rg5Lch{@Wv;9OIekjljoS(U5#I8W0;0N)Y&1XzD&9
zCw(7zQfl`ket1ef^XMllxBhvbSs8=j?nm{Xq+5y}B^`03$F<%kFYa%5Cnmkks{N~W
zOBdTUFy$*-q|?}fHdJ@mH~OOu$E#-jlQu-3`KN@plQ2Q2THMi;a^I6#y%1no(fhjk
zoCRGj(!FWWgkI?%Pkj39^6jWNyj;6c*Mk>taK|y@vn|i=e)zSHQK>=~MBK9GndQ?D
z9GJfR8NOWUeDcpLsTtbtaj88%Wz8V-&uO;x8J2SQbIhEWvSzY88voSM4S@}fNwWMt
z)_h-idso+!!uJtYfXt`J_O~987_OW%6&N9s>S$<nn>|C9Jtlu~9({L*PL~fNv}4ef
z^XZ@y%JviQ{_}bDy&ZZFE}+{v_{#Zp&<SPxiFf68{rNo0T@vJZwp`A6=mPFB2T(JZ
zcWuE?po>8X$g*yy<7cN+=;dy~DZVZiF7g4(cvyPx_~y^H#}H*XLhtm*c;z8phrsx{
zQlIh4j*FLPB7RM*^vuWiNq^pLH}C#x%Ry#)*rL3)W8;-`UbEX@Q!X_Am|UB-j@Khk
zv3NJIj%p&pT4;xBh;qt^;RM%I&AO3GHE3U22e$=ns_cj%hn01_C3ok{s+kYu^$!7w
zl&9A}BYh~}anmn7BTIiqug}B5ZQ;vR;*fa@mr!;*(?U(rf_dm+mfh7p%Eo7uyR?7z
zvw2m1H>4j@c*suvj3!LP0VQ#r4=b~a@+0B~9UNJ-i#;R~Lo<8yPI?Az8qHK4Tv+st
ztL_N`8xbOqh+zXIMpXWGb!V6j1eHRe<@2^)=KjFX!BXGF^>Kj?u25N_0>tCXV<)X^
z<iNmQf&dk;Lx7WobO&`Glph!+^3*Rrm|9$%DqZ(#(w7BwtE-o8J9_3!)JNOINO5ZG
z@zi2&_}6>O%GhspM|MB>b@U<Z7?ldw73E%{3UkB&vV@UbAkd&BonVFuSOu~}BiO|*
zwLA2Skm?bRL31U%RNx$<h6+BPZ`gF=m6?Z`<#_tA6(?raZAsLp#U#11i~T_1%NeWj
z&Kgo#*ElvDnpj;FZ~VifXQaQyCB`MWICIJ192fuKyi+&ND%~s{X?ptj`hnrHj6FG1
zbB5Iyi~2*!<G*BMlWJxS-#xUdwzaByc=4!N%V!rnbXtnOnmep8N0%^`HxHXTAJrlG
z`qFB&-4@6bRfO!Jg7JzbaFVHIIXk4}>_R0-S%HVAh#mR>$+ycf4%;*#m#q`33#W=?
z?X?B@H$4xCoYk_RpnUU`TL<)GeBamvb*#p2)@qA;iz#(wlMH(EqIKWgKW*Cm-$+=k
z8vNs7kagyMebuVhrEl)|^>Jy^wt1^w=ZYJ3qTZL25va=By=d-e?YLep-sp5}(>Uw(
z8f|?zP^ggxcU%Okb#EN|X5cJw23<rtCw=q!s)<|JzQ=xd2d+%+cleX#LIqdHF6)Rh
z&<c=PLQs|=EsL+y-wd&)U1eK`4;uNRkXto<BV_ESuiA^KnX)0RvE6>)H~w$Gh`T9Y
zAg^Gixt+F_3Es{UCm&W8^^%h_0A0G4U3N#2#!e1J&ZxY=-~;v^1IIxuY&UO`&UwJs
z;W*-?^Z-654k1erxi@u4Fes4L9|)l@eMSiOT$nW(?RKMd#BOXh+NC4(gEh%NqTT_e
zOjS3NR6`o4H`r%-C0w6wd+fHs4*RB&p8{+l(gA`m-SzXcmFq^EO9y;keA9J->C2~0
z>Xm7&#Gkck03~FhJ{ZybL#|(miVy%h>qk8iVFEI$guFx@s^uYuKmkf!N9r&c&sQT-
zj9M~|y<Ab3mv#fv7rpaxJ)gL!({0lkO}dL0btWT<RJdwO)cJ(pKiuiQqQVDQ{{s$t
zLSll)-&Nn}r@wrW%a?t^9}M`1^Oq~XdNqPs^L;^ohkgqzIy^xMRYFDY6s|w=NAdk}
zc6LKwmq!g#sUas{Qnf<aEh~XIgmmrS|Bg87v%8{UPdbOK@Nmao0mq^2qP_dWcYTI(
z1PzQi4LfC9s7v;CK_H(`0}V0U*#o`|U!a6^<VXORs#Y~OOW%iBy)<1qh|hFZACkUr
zZicqD7hBDGNve78t5s6CInvzT%+rbih>TZZx}y8gyH)N(b4@DhS1b^d44y`QRn<_n
zfF!4t*gBF0(RdPw?{9njU5mxl*5a~Q-hI3ceAy3j!XsQ6wEnrx?U4;ni?5qAGtIAy
zPjBEOo1bfKmh&62^8|-Pe`wSz?k$h)U%G#1vLd>FS0>P3e3s9Zyq@7Gta5UZg`>^C
z@K{PZRQ3`*R<!#MdPZ;-mu><bT7maZG4_NFgXRGNMgCfOuA*F?ZXJh>*hcyufH$L8
zLw*|>7i+ah1<pi=-IT;G@nOyt{j)GPq0lY$<>I23a;4R*&YEg6aEXF2u5B)oTYjT2
za0|;E3Fb>GerEe&rsw*!eIA!={D}XOZ$H(STg{mh)Y6a8GU2(<&KQ$~TZL$a?il3o
z!n+E092u9cL>m{5D_(H1su7pe+Ix_nSBX<DP}RY*-p<s_1}|Da=zLGsmknhTfz`N@
zJ;qM6_u1Dh$^k=BBt$V%yFfL8Oy5ej;*4~4NG_A;l&)5e!CZ@DSV;=v9F^G>w7><m
zUTHc+Elm{%U9StgGvLbUih|!nseuuf02ng3W++P_osfL%4s=X=WD5lwM^hct?zkDi
zSD<&6&kMTTK=OCH=n@F5#s@mnG`uHQsHBRg=q{QdDS%4@jC;Zpz-<77QUz@z?V%m&
zR2WT_dpccoXBY#Z_NOJ)4Cl~px}{o^lHqd0-8Egr{ZMh7j;o+yiYTs(&Ip0?2q3D0
z+9`>GghJ^m^0<VlAW+JuYXY!H%iGh%Dri0fYUs>qi=Q%6$xv*tMQB`tJD3)N8+yPg
z-&T!E;||(XH4-QzkSzrTWgE%+E<Q*AeCc=?s#P#V&mo@&9)ZHw)BvKva|!^i#t&Qx
z8=S>{s+A^)?1=cFI`XAN;E_|KkYg{No_(TCx5WiGHY^@>D%GUh<KWpe9DzUO#?dKx
z{kIlo7PKxgj#7&G+-oc=H9jSnUYZ~-8jK{nEmQxxCVt@!D~57E0vd&liv$ZBUD2V@
z-?&E?0d|%HE{r<P6tB_6BqSyo-3h54n<GXOXhe=t^B^uIJwY_)n|My2r8k@1b*yS}
zg4e0F^mkYA$QP&)<BJN5GglW>&e(OMBfHdBWdLMUU`o%CX-w1zu%hr4?s^+0%7leI
z`^EwpJX;6tM6OXxNKfGgn{--3V?eKA4x1-6!EN$+;$!sM1fyH}yKY#L5TD@i4oZzP
z_DV8}d|8RPf08LX#_6&oU3@WVn9gTUh|f%{GsdO*%_Sj0_pGUhJuNTa6UTp`weq~t
znwiUDrIxSnz4z;TgL7sxjXrUGvQ7}CAGN%|y~7D=bxg_@>2^z2x!DFJbg}nKynhpO
z-+O{N5BhlCT5I-{l|WCg(R0A#F(Cb_U6@lY7?LarNR7z;E0zlu<QlYAT}2`riu@57
zS=Tj+sT+bNql|9h*Dp^wHd*cFl68h$y&Wi4_K}=}n=U;(V2D;*6Fz^QG2w_1YeK>o
zvpL(OOXe(wH~;Guu1RcMm7U((%Iim!1UGEA_%*sXyQ@|dN}S!wjqx=)Ba+6>7sZh&
z-O56(S(_K1TAbsy_n$p`@9Yof=k@AYug;v``cX`>+gi4`562Y%%sQ)(;|~sZ*^*=Q
zI#*(%PH%FU619c|yfbq>r|%s|&#CfR{rWhY2=soSo5ZLyd9}d#lG7HItqoY*iOge(
zHSs1cKS8kNR|M*fTDSn4__fkMM%<*g^QKs{$&?UlEnQo_DAnsj2CXa+m=3`5#}#9>
z=~i!bW>%n&jw^~aqZcI@bO{!lQKwHxa%%ZU663tn{MRSig%#PGD~w)~DLma`*0ZH+
z__{4c)4XwsHo=~F{q|&2#pZ0a*)pxhTC--MfVLbn7odwf?KX|pv9Tw|Z9KMY`LScm
zmr3d9iSa8is$%$ly`B{s8`12J5yM0?cc#b6IIY@d*_+61a2t2N5-NJ>4x<x*N}Ps`
z&BlP#8jD1&TBID1Oy{uLV}MC!Ew9#T^Nq&DG_*-{lgZL|MT{XZHy9YgaXmk(E?Zn#
zx^1$c<3QQ%?igdt@Lnlroz6W)sV<&(CiIN3f?#dBj}07v&J*jf2}pGC;=~?1f^!3g
zn3a7jrXoE15Sd@-r2~*KcwIAjO(Wm+6<!%E32h3e6af@Tt*H|8u}aI=h<|I^HhJ>4
z=+epCnwqvn$Cl6CdgHI5S!Ct!Z~xtGlk@oOzVp@$d}ey$qzO%Z(hY+TNGI=?KKkf|
z4NL3ld<8jl5>BV3Sk!Y&LrJFF1kiDBL0P|{)92M38e6h#(u|=)dX^*up3Ra}TGGGA
zh!9CjvcG{G+p0vV5I*2c%60-niyFawu8vGTgnCGEPF+CI_F}L>u!&%fFA>1<fhEG1
zj3kxB5|sk>7>DC*T*MAS4%>qq6)ki8oxjq(>Z|brg)He|>CI0!ZTggzvSF;0O40d0
zM?zj=v3QYg`T98xsfn_9pO`vSjw|efyMJ5W46B^HJ|}&2j&FkZN`x3n0vs2cH+_nz
zsw?mIn`_`EM+aFXx>t)O+z?2uur488!4hjlYJhL(x*L<D8l~@>XlK)ejT<K@rQPSw
zwciYn3F2aDiIxRV*%3blNL$&$1U`)cYofa+DvWypnUf-hfMkLWETBY~qco9=5e@Wx
zHq(V>x}7FWvGNUpiM1CH2S2e^6Rw>YXb@Dy$3~l>Cic=%?KlcLjw2H6i$~}%UOxB;
z1twkbOz~aMq$q?b5UKkkIO8Z5DIJ?+>_<4Bz|Wt7UFGB$q3%y{)g$6@R9tgI;HpQ6
zHeLCQ%=>@wJUql&id_2t%k#jY=l`yKz~6TCAva`dNF}oB{@;32+JF8O{J-^nARJv1
zh3lb5O2FO0Ev5S4cA%t`B!L%dB!sIGqc6;t(_?ISP49?38CMu{N;+fr7z~-221C4!
zeTUQ+QW`clU^n{>_KDVPu_fCo+EsK96%Q^R{;ewJbrPtS)#1a^o1yl>Wz>r_34s!8
zsa$pkv4;;!&CpMT!(r)%MF=(thgleYFwIz77A<0yuo!8Pnj+DbmdNhikrvJyVMpYm
z(ww-T9NW;D4S^)C5U6+!?oXI7kS*n)X#f}l#mgrGc?&*C0V_be{CE)A{}oRu=bcqV
zU`U}>AIW4srxqhtinOVu2x(AYjE?}%_98Z_@oiJq61D>KI>JXVP@v8i@I+FCa^@;$
z3E1E9*NQWc3js^Yi9n?&S_~sB!qF(B6HqBVwV_UhHYDj)(GQitlYnwOz>A`Lt*)#a
z!Vf!Y$hy}OT1Y>n>&~iDmR)3VCW-)+lhQzt!~;4!5?sje#lQ0Cd<2h<aZa_4sv@m;
zWD(ys)D>00ms80bI#1yvR2Su3I+3IE<=<E-t<Z)N{c-q4@u5HX4|U#?8sM@VXhozd
zWYcb>6l#hTwcAI%Rs)3>a+jB7ibyF=S<EBs26OS##lsL|+N5kP%WQ8d>o*J=Ay1;6
zJLO9?=6TW!AW0gOI)1!qd`e}kNJ>c9op6e)E+iVBF-Si$ZyP#x89S4i@HDcSx2rmD
z%~TikIN}hG4#B*cW&9EBYr;WDbWV>3*ky`8#Jy#l(-_n#1HE$uB5^44vI~q52^c!c
zt`Zl3rWKJK`J$4U*B`(>_!vR7f&2qAfQf@v7pc%7kp`5^)WEYtEq)%rt+^}Nt<~Rg
zhhFP8Cb@aT_U*{T>Ta9;#eiP(t_y6-%4Yqz*QZXOw|e!w=~D}5B_ynSYD#YIl&98B
z=j%t+mWPMc@-|T_XaC)Q(v|Q;09p~b9h~?`af-m!Gogi*N^e%w_gG{`@+sfqQjK=X
zvs1L1l0^ojZ&zmyX<F7aBvUQi9PBOf+FtpgTAoQ<Js-RRdx-QWN;?tWfd}!aRn!Aa
zP$?n;H^UmF#5pob27)!b0+WNe<tSB~fJqI}snl%UIt)K{&ZbS=lubwuKJJk8<6SF1
zI5go9-f<N(aS02b{_95RcaKURJOVSu!z^$8-=AK{8oNVku?+5stQY?L0{*k2{j=Cx
z(o52hxWWf3?_#Dyhok}9|9)@N-O_u{J}CX+`1A+9<<(bINA7c~E?y11rFhjWe06jh
zdEH;0r)509E<QpXu^Zc<D771fu+biwSlcFZ0|HnFjJeKzM`T8UHa5{=9h-%Lmk*xE
zs*cFIR=OB2L&qW+HT6-IHi8xTu?FC+GExPFJ=AmfN0VvLy*hNiDT)V;557JWF07cM
zt1zRHbF!=+7CLoninRrLVBjc25iAfu4WXQLZBRFZcB(FdOz<l9gsD1{Ya*tnwOM9;
znlh_Rl9P(;znxRoOmVXRrXSJj+Jb`G0^!yPH}BcB=jI80mQ0%^*ap~yS<{yEX;WQm
zs}QE_1ko@b!6jS&E_0ajLX5#p<x+XyzU6Ykf@>Glwok5KR_pWCE~}5(@z#^iYJ5J;
zvroRYBj%c0yX!aepl?z!APl%{o$e0QCza4e3oJF9wZj@ozV>o^u_`{`!<dFL0(8K{
zJALTd(EOAJ#mKuyj=Zb1Nto*1)b(4G+bDX|z+0F0X;<}Gdh0;D+ij;`Lgz0rf}AW1
z=gg57N^O^`3<+@;M#L^AUfve%nYiw;A2)6K@v(J@8egVQbLCHkexj40f8@ar4Bq|!
zs~YAop94XG2%qLMQc=HuS*@0Km5%>jSGRb_fUgGZSX}q-*QB<pvbEQSznol`oV@Pj
zUp5f^CE9=a*(r|dfAe-ao*l7{cyxHx|Eo8GM<2<L8d)BEYUWonpTZmbci+Le#~y1p
z?R+ge`?Z}{_NTu8%O_5~vOlRcKEea}4?5G0bGhf|-iU7X?^ohy9jRp3t`h1|SG)%^
zEZg;<hgXr55S)?owHZE>R)Z|S_N(@iPXtJVJPfAro|KBBA*Ew-b8>RWlnyDXNb&GO
z`?a=CxqMdGW{S`+EW)8#qZ-2vc{NE12}w114dKR7vqIO}Mt(A#C!r3V{D}&)_#C_!
z+0siyTMl$k3K-K+my<>qQ!>VV$WBW-1Xf`jLN3`|#S9AJ1MQ>*P6V_>r}V}Y(pn64
zFxc`S58=ogF3hi$7pW|mfxIgai}myL^48)ElMXv;ibd^+n)2Envr^){({>o=s}~K4
zMn=q&-W;%VYK*AfKB+XnpAZ2+#Dv0Lh>9GZbb{6`1*y{e8Pz2A#$~0k$J4TYqRrkL
zGHbM4ZGL2R$v}}sic^9`np>v*R8lSth%FehX!!`1SwEv?>P|LkgR?h{HEJJ~x(Rfm
z2$`x>q!gCrWUS+$yQOBL#-Wx$vq0vMBSc6%?L4xpEf70~Tok;*l4TIa1c@gkR#R&n
z9$)LN9bbDOJsfBtH{3AyXi88sK*ToM?tOgQ(qy}P>dx7>X$P2Y7#bbYbAFl>DcL_~
zQ1Q;GZhNvAsm+fr;w%&z8vWst>TF3vASXpqmE@+decpKXqZ~8(L+1h9t@$tYtrT`n
zwW@c_mQ0yB(!9a5LIs?vZq%IpDeSSSJB3QBzs$qPc3yZkz(aBh<@p8fP6l2ksafCv
zF1w3kKq~bCX0$8{YD6_p{HJV42$3;H?lKxt#^(k2gujaMex(6jZe;FJa7RL9poDWA
z_EKX4iCC8L<p?8K)n)sHMih!p9<6p))r(Twoc;UfEY9seZvUM8JZ>3gg8lPGNe_*`
z<>1kzwAy_51rIB#W??ExpCs6FESBnG2eKL_rF|V;5$g&x<oP*MRF+6N_c!?q=MAf8
z!*haA5xluAjoQ7uw0C~G^m=4xQ9w*u-aB0nJD@dT<B&P~t$*1+CpxWhyK|(Qd$n(W
zQ^=QJt3RM0QhZ5;!X~5E<Mg|V!@47;5O2MpZ3tx6n$Cm~;xp%!>YN$vD*MQo-nrbJ
zfrhodBI*77sy_MW&-cmI4h>}Yvw~uF^gUS~Op~$k(33C>J9xrM=I>%w=q1n#L05u0
z3tdZAjS#*ph8iSAxs$?A+lMhp24T4iV#LZL+6|jWM=>a@t6Y%A^<1%Nh=imk(&y1n
zhAetuCA%j(I&9h=ZOx(~>gEa2UuT5dYY=Q@vFb~b`EYwP%G!Q;Tx48knHbgstFw3Q
zM2zJki;-2vB8daTs8*}WirW8r*BR*$%nL(K-m++jcjW_-ty2fj^bT2cv6)Rhw2n8H
zrhB}p`HtjtFH#qpax2O*&F1Dr|HN9aCtY*cm>>VLtiY1Tr0i!{1N>E@Sr~)%RLp3~
zaCCW4p^mQAH8x?=!T6M^mWEI5R>WxxQ4Df##!y5|8bwc&O^3)>JeX@*%R#wB%V+@e
zg@x7pe$O&pWkx|*;QNK8vne^H4P~q?C7XK^s3g<0f@T?CTaaF*o9fxbhYQmyb-UKx
zqpRd5Mf;Delf>fk{j=kWQVLxm{q>qv<4v2#4Bz0GIoz>f_~?z+32QXVMB{Y(bz-Eh
z&}53<%05potSgAI8Kw87zX^Z*%2Qw3D@WSw$?~#YNy`%0Ck9h~ZHZr+#ig1|1+|6g
z(R;b$>4g^~C2URlqN>?@V`7plIT}ut8av@8{ph7Lhe{*Z_@OiBjnr?OkQ6Vay7E8)
z7dF7HmBzbD_8Bgbkw~V>h+JslYfw9y1h7Zu@jE8~WhTJL%^>nGlQtr6os+@OiJu+h
z)YtJP{oQR@wWa+P0(cJ50pnxg*P%=k{eze=`UmIkbLpq{FDPByH$HLVhJ^8!S+&t(
zg&6Le-M7d7KYN*%{zc3Ql1hra9vo0A6GFraENYtaK~~SQ%u1RI!ec{&8v;#SMQCv3
z;M|Y6-p<jQtrI_3Heb3mJX9ftvu{h~Qs?Z4a~?SQ&TmH>5%1_%QKr|)K%amH%&p9K
zN)-bL9FqwmpeV5>nn;ZRBcNFZBa}O!8wq~o3DPBpP*C^8RBLyVe|)HO3Q@W>ljj#8
zLg4Zk>`-(EWcw^eI^q&BkVS3Jf}QS>&h3rSX><1f#kzmakc|me5UY4+@8!?>LZ<$G
zL&ZZtpK2d*`JEoEag)9_ADfTp!fiF$3o~-6Ujb!m2%j<4W<qzHklQ<Eq<yEgUv^-q
zHn-3D^Z9+M@}>8Sd}|v5{B`c?qbDbhmmV55Z$B7sZdqRboc-ha=Po8<EVYUCp|qr<
z2dj(NFo!3<cB{pbV@r@ep>kRhYqB|jl|9oH8(q<RVg5Iqn{=d58kzig4Xytj%wfap
zhmDh7PtWgNT23=x+BWIUfUG0NxQD^uahUw$pgofDRj%c^gFq8I6oO<5$cQ0)uN180
z1UOI%+7;kXf+`|{KoL#+7<lcxXESbv*Us;acA&e&8SR2;Ak*oMTMRaq|AN-J%AtEc
zkJ$`cje6Z6tZ#PcKGN%XqwulLvD0YdTb3Jb?eEAZ=h}?RO*Xr}z1kR~w;H$s(r5%@
zJ{Wz>VAbnQ{Aq*L9=#A7uSwM*=*vn~LWMeTEOm%%u2A9-2qYZxR?yv1mkgeiC{!uT
zixi|FlO$M?Vd%KRPy(ewmyv{wCW5V}Z^ZR?*Y+zttJP`kw>z{i9Yjb0@r^7!QZ;hQ
z$a;02^p5ny%gdL)%q%RIS>)1(*RVwJHH|)-^r!wGNZYL@i<Qln?xyPy98PTVoioPo
zNz?Pe<u6M=Ty;IE0bb;f|8VooKd=Fvrj+jW&I7HHGeR*~>7fzINXH}vE~9G*xk9Ae
z%Aj;GpusN6-}`SI_OqtB%7(;ExMP+n23SUx7(p;Q;*<RL0aKd#`+Hj~F=mT4U^MfV
z+`zEBy}x;hH{eixp4R#=4&C$eOBq*H9?gn)m3eFc)n9tNt0f9%*=)m%0%t`29+TOi
znKp31)C7|$hH-{L4!ZzUY{%(acb}r8U`ziOM+rsOXm;kj;)Y7o6JHU&)S_t?y|Pb<
zN+-BA89Ely@fjhv4$h+*#<dW!i#Bmb?r-WRd0ES8=~M0qcO=?`->gOQo@Tx#DZ;go
za+P+-htcL_I;i6?I_<M27NI^a%dE2Qi2PVGKss?JH+*s2p$wfE$_N3m7Lol|c3ti)
z@(_H}*xV$2!`zvp*GUz8E_+3)Ko$TuwlcT$P3CBRz%?rQB%;*Zji+!3ofyF>wd@s~
z`aihbDO?UGHUdiT=be)D)gM8(nTEEp!?vJgqU;Ssr*SG&gq#ICdu69(6<F`YyA}tb
z)I;|~iSh-=MpqY(kxPh<r_c_l{=kM6vvi+V10P{0T!lM5dF?(3<KWInBS<bC5YLI!
zr$M<yP9Z)*1`)XJaHI*rZ9ODx2n`B_2DN7_KC&49!urKS1}|BBq`mjirOS@q^VLyd
z!_j3+kK#xBr_%qNy5XHQYu>rx6#t+ky)B)VmcMhyxY7I0aYLmaktq}@71&yVt;?;_
zEjS=uIJo)iAqB%?MtX;Qv-zNO;lKi2RW6&qkKOrs3%iMnS8gBT=<dOZbkD_$nfwgR
z@{NzOuZ|x5>Zp{-)-v;&cU#|GBg8CRFz&!R%a^`&`$Tv?V>4a@ZYu~S>q>5W_D<=-
z9gC)xUGKWiKXvgPOnc|Ew_*FV#f#8qX21dO0Ona8-Ua-HRbF^kV}Xz?nGBF~4m^S=
zueSz_o{WeLuNWDy6}f=P>nI<o!N?CONdPS+$0DQ*=_zfKeqwqc_voelPjB4#^hTCz
z6pWd98B5R9vzVkLL-MHPUT37gCyzognZ@*bV@XC{CJxc36^4DHqqg6o@^Sb2(|zH>
zG;TSvFh7qg{q+2E?BK=;<2P;`KOuTwd|q0XFRtF%PriyVDX9+r$4N=Xq)~J|XMLP6
zD=jbHkz}%Y1XHTVg}mS%n<+`23nH@Lm<CvIRkF8ghXo%TDwJvPt|^d9<ay*q#ntfI
zbYVutPb`C_1sw6NoF(0hkX-N2RLFNt*fe3nCRU<P>yfNaU$bFFe0*|`G`%ac*YI0P
zZZ2}UbgoL*sU-uk)VW-zN_URvmD%@2>2EK-h=f3^yF;GBa}QUV5dFy!E5>PKGt+Fg
zI5F0d*CRJzD!sX|;{r<uD3^S()D+0=0k1W~i*z;ib$fW_0}rg^o3X^3C7wQ_ep-yc
zkB@x#WFb;UWdwk?JmX<%U<v~dszC!y7QEGoHDkAZDV=`gQR(zo+s22v(*>z)ufKN@
z<o_3>7gF<!dZ)2{J~1+`CVKHvsrjp|TfbuAM>$P+eB1jz0$MEU?UP<-L0|8pk`!qT
z>2(;M<#y13nbhY*L>9qZfha}<U!(#V%;z)#Q%~g%lIjz^Eg(7-4=(s+r6bFB06?rI
z*aVz0o0~yF7!c_-sWjqy(g$(U-)mT4m~?EEbKJ6A#`Vn@T59pI8}gDrblKlaOh3x8
zp1qvDdEN!pv2~MJ_}xABswKX6jbCcmGp4>hJnT)zwpT@e^v&d+DvDm(jJ#i`dB^L;
zOGk<6+F~xDBDF{Rt<x&m!R!q7MW8oV%nG>t{62rFdv9N;h|{F087tzdilsh2qzC3N
zrWcvu&&lNqJKMqy3STSJXg%yYOTg9c?nd!Q`b3B`s}hiL4NZZh32+V8$T|@68&1g}
zKpdiRM7u)ts?4P12oXFleiUHvg~;n2GdEaaN__$?0Ay51_zqV!2Bw80FOTlb%oU6b
z|Aa5jlb%wH%TClS-?DuYFCEpa+O%ULchf9BAx<#%=>PFX3-|^#v-Io#>O(BnZp0wr
z79URTt&b7wO!GNkykLxTI0m+CGIK^8XYO15<|7$~82`dMlFRflLb++=y7wStJuAKc
z-nw<~u}mbH&3y0EYfLcQMo&6Dj&C^ETRVTvhH>iX^O^<MZyeY2wd0)4Y}BVLI^^wz
zOV*iZbN(d3n3%~oe74C97y;b2U$1iyF_*=lwi^tK4kY0?vDP@hOlJ%?e6qp7Q5B5+
z{v_WVk8$~dxb@eVvSgaUI_6fFDuvK-7+Kf+>3ChiG#zsZAwC^5iN)`-A!<?WXF)C_
zjWAg-OYt}S@Vl>9MLkEPzm-VeM%aSr$82an<~s1zJJP+cs((|#Pdj(ZSJL0uzQ&m8
zQd#TCldUJ!DsJ_b?=y7w?PmAi^^i0#I{TKriBhHSB3t(niwW(QPDvj}hi^7<3pcXr
z6>6MuvX#aa;wYg@dQG+{cvZj#^#Bc~iqsS#8bk01B?_l;XQ*KitRnjXqUtdZW+bsH
zSP0Rt&|mQEg39jVOibXnN?%I7=T+GH+&(iVW{ENTyJf+Rnz)9Nky>+1oai1~X5Mad
zmJG=%nON_yEZ0GNa%FjXK5#?-lSlT=jnC2c${Rf`-n{EZ29hFhBkz7+`sR{~<z3jw
zMzG#2XM*%66K@^5gv<MFPc3*vCJs&2xC`|!^vW4n2KUF33{I#><1{v-mY*~<rZOkF
zenw#28xN<a5AS=Nja@iUnk&7$?vm=G6H_~A9O{qxEEQIL6%jFkoHk(=1xP0b1Azts
zj+J1(0Y8gGok&)PxeXhGKz8LaXxJbP@Vm!eIw*ZRqhX97jA@v`90y-IcAa$gfke|I
z(r>=lLOk}9{Qazm-E&~utQ9w|IPmH#2Uc!fId|)AV#0#m>n61B%--2LVcqTp^HwqK
z-tSr6$tQ_7Wh>h+G)oVztsYUvrhM^7Hl=)c%?;8CJU7WF7QD9~;OP;7t)vf81&t3v
zCxlY4E%elQNb<J`+5BqWrh;@rKxPQlftM?BMNr(4b1u%1JzSYDpL8`Kif!xvuy^W1
z#q7SaFQs$$Kli{F_kNdW9seqGJpI>dq~MH8GOI2<7M?Y-uwi<iIV0xnzV40QB^O_r
zJZkA}tDnlB!Y**{i|^lZ>+iYIWre$6o-pFBzil4AjA@o0>G=Sg_0wRax3IBEY`G^i
zrFPlzC)uOJr}Qa!VByxbHKQgB@At`;vt0k1Uwjc&ROTN|1oMws#s!ddkC<afw1#e1
zv1~d!4P0HCw*X2V@|a7bvKueL2nnhKQzcB1Q7>yE@u(f*5rnO#sF%E+)G$yoFE1b1
zjsxxd*>-G#r&5>>!vd%B&9W7fp38-K@y~cJH(8JE$OLKPslUjdj=Lj4j;t5VVL@Jm
zN<mF=g84w9#JCD#RQc0ydbv+o8eDQ?ZFYexNh+Tt{ZLp}Cw$FHu_}D*9gCF1IkE?a
zt{>pdu1raF>TQmZJ@W>Zmmn?MJFr%TN0zPFJonI~F?QYe;~tz<S188PiLGB3*1gT9
zPS5M#r^w)`jjwz0=+QHS(zC)wLyWti$UE&3YFjyXjd-1`FX^LtQ1voqRbpJIvnwCC
zal^Y@sT8^h$$Iny5(0VlP~fJ##B4&*D<O;n3SEI~GbP<LK_;fl1X9Tn9WLkAj)*HV
zJm40gAO)wRuLAx!oxo$9R`f%ftdyS+HL0~aUZVpl1^AiMJ@5no?F5zVd{jD_u17m@
z^Xt@$cON)<?DoA27guE)gwhg`*%FFpOo?o|^_I<%$!fjX;7pU8wbjl9t68tBsulHS
z3un{T)>@KmMzyA<#+DS%Ud_)NI^?|{-y1S4$INu4#d?2F#!sESchC8^c2@)w%ofOm
ze#5L=`}LhQw{LjCrl!ZX)bHH!>X{vZSWb&Pxz1##m7kxK)c!8ZT$4Y4^>yzJ8Jd@$
ztc!{97<HOC(<6H~uaCEZ^cgoiaL?^G#;BK6hQrm17VVxnDnYAFVEowLYi3LdmX(F@
z!~$>kbHn5()>qbw7S3$a=xb^%i8ise#+nr0f5n2?Lx+qXKV;Y}uQuLlNtjy4hI8AR
zW}e%<=e#ARxJ1kI>RV<`@6&fkzeZ_lulg;IPI_hMjvav%4r#)*qT9^fZ+0(`60=9x
z^T!VvI(rd2uXR|A9?iJyvLby!oY5kbhbyShBtj4Q8Tw2-`u#G}u=#@s95sR1<Wu_G
zDq?uy8z1yz&cKIYYQXISR?Wm`bC@aQxCg@Q11yy6W&$64*;FsW#z1c#1H~@~ASUsM
z@{)rQVAnG7YO~p8Hdd{_<I@!@zkmGLv=ptN)*Hp<d2BN~@FGKYKu1c6)uwY6SYfvC
z<l1wX+N9ON-hn*z>N&;vYotx_{&bV^kC}t)_83$8%5Ar9oK;oUc*Ck4Q;VG`qt(uy
zr9ExZhq+_do}4l5?#VTA(WXAN^&^r@J!Z|X>8VyH+AX1>y^5;FEuWC3GXo({SYGt#
zsLZ!5bBl&&ne_I&J6swa4`3nz{2#oIIZL5hV_**?*A{2T#I*PaIvg>s9-}kWg~M+d
zH)6+x`m6*Ux30z;;9UM;q4=IF<_#+<uAeYCC3<*NL9Q!qN?zIBoTC8hUxf#h^}ng0
zgXE<(7t~%MFP*L^JxHUeU;+8MN`6pE^0CD*g60Z2D6aa=pyee^I!q1FVqs{KDyx!|
znPj)<x};MrCk<8-XoC<Eu~b%<V7Tn0kkM{sA<_zGix#4tE%FiFilS;j>17|5CL+I0
z9ZLmSL-9=QR&KRX=ph%r`bzReuV^1LWKwD)@?z^Samp4L%n=OEOaBu4vzu>ESM3$d
zLZxZZRzd{MA<a}XE{xnzDiKu$SXx&z@T$vY28X6=v|6Ne06T({l>?)13##Uy)!8K1
zf6%oXibNpH|Ei8Ykpa#{?i2pYAZrxIeL0ezkkLpKM~0&RvvwFw5%|wPuf&+Y@PZO`
z-ue6a=XLGg|Ey_lLty?jE++^4)8(a>|8MQ(fE<+x)DU3BB3})GCZVaQf#k*iT?2`3
zNrmh)Qj5|uA2Fq=+M52eX5o5DD!?v#mG;Kf<jY1Y{)5IKSz6(F6FcY#34h>LI#!sX
zJ6R|OLn0Szb$2e)Jr`j(O!ue}jM=`KJ!FChyRvFiwqvR26#<%|0#czvj{htUb?M2W
z8&}k8esbVaRL8^y1UXf0l^pk3xr^P;a-pzol-}V~G)#7%vnALbV9n;}V!AnZi&+RO
z`=J@Xe*ku#+fB!<d;s_MV_f_}o}>H}YoVy1x+-*;ID#L>Sm;pSU#6x|VN-u7A-7)j
zTYCM@gv{1v`L1ClDpi%4(EdC_{ZUmuOnX|JGZS{oM{+8r5`K@jzB2(PR+T4R-XBhA
z`$+cl_wdaMKo}0EW15>~KAx~0+c2jp-ne*TvL_=yV1{3mnI+<apl5N5{-9_Tt$utM
z)|xL8T()Q=Ha2>D^me_;ZpBXyKe<`lEN@#Z7jA2Uvb`nRBL3asYmGR(8U!rH{PdF;
z<ACl3Kbic~c%V)HmGG0XP5*)LQ)^WC>4P>XTrcZ}t)QrZ&iMvUh1mfQgy#WKCFhAN
zwsac9X;{%?b1I|VDtR?ptXPXi`1*>UZTD-{oXTc5YSlo}v8%zXw}u^BC>ZUS+Z|do
z=FhkAmsEOtE0}bip&){1#}pv9qZjfJMX#8_my=U$hYq+ivr6Y08f{rR5{W|r>sY0M
z{6pB>UV)>WC=GL%f^pil`azoZw*}LYy}UHV;NXQ=(QopZJtnib`@SF8orvwclatTG
zsh9s*K9baZ@SyFXGCja+V$3elXYzXr3wvdZjo$Jw%XsiXdTyDHcYE%9n!Bz>Fcmtq
zjbuB4UIxq)(82+=43;?!@O}_TJ1azb>Oguh9g=yK2wfPwAQ|eF#I9MhZ=_k$p|@_?
zFgiXq|Mu&1%6nJ7$)>*b78^<x?$hv!)LK*{nqviCL{P1P(-b<hVv}MHJ#pD&#68ii
z#!Bs3Wc#-_E_$PXanrb=)$`KT+U?&m+qcs8htU|?M|zpGpfiF+FoP}B2Ha)&{W8Ze
z_5KatotQrT#CP(0)Cnr_ALxN<c&ZzTN&|`7%Hoht0&5Q97fi_VlFC3X&4`|q-se|F
zPqIwmFqOH%(g(B^Ey+~FE;Xwk62mebQZp$0`E(wdGED{v6rrHYZKHOiA~xDYm-->S
z^rG}%U*0?=x3S+y+x&sC_vha^a?&z)t}9eiGIP4txVk*NiVbh$TfdbiOGBCF2&-l4
z0aKi}W!|LKt=}$vHtOQ9el>Ethus*XrFX38QB{x^dGfs{XK=>bedxfzdsYdRAAcO(
z^6|&45)*@p9phHAEa~^r8>RDfF3I_d?iq}QDh#h~<$Ty_+#%R$kf0pM*Kl&vgveD{
zHu(c-hA4=c!Ra1SCwc7vHzb7|#NfY-O<?W<Rv!epj>G6N_#K9Z<hZ$W<B}T;lLFp=
zwBH-Y9!{<8SG0Lk(*TFwSkIdGsYL|Ool5_cTFV>axfMZ;$VuP1hr11?KJ@THvv2s4
zxbpJ2CBuD9O-H>2&QOEjwDg945v{brWMG=cQ6_{-3P|p<F=F6{#K$MbwEub(<RIRl
z=CspY8i#bVNyq6%$@QKl>tzby$2Sy~9<uW&#u&tp$p#oq8sx{|hyB<s$}S-^P6EhA
z<EHrxs*R2*1{!$a19u3ekQWh=OL+&=Y2KkJ$e~g7C^oz+-6{={cD)-@QnhUO$etgv
ztYv(xi7mGE%c*K?Tr*mFY!=J?L&eD9%UbUqy{56Ts<M#>Yp+j=$vSf6NLEaeJ|-sT
zwuy}sZ*#2~-B?-G$URmuDK5Vl2AexzLpfMb5I4DE*z)Sz^_<RV;fMP3aFx+j{iRIZ
zZI#QVKgl;~l$v6aV)Xj#%*<@PUY{J3Q>@b!U!a?fUW5L?RJ|{8>gO=O6_VzmiYF5k
zc{%u!ptK8F)dsMAP=VW^ywmuC`9cAtr{2sma@UKD?fny5uy9t}K{osT-~Ilz`tj0t
z(%m~>_&djc@w>vF7Vdhjw`%aPI+ttf#a9k+U#|Vr8~aB6?v>{*J-_hiFt4XqiL^D;
zp9|Krrr-R?Moj6sapJ(W1Is*so)iafxUI9V$}tEE5`DZ%g>HtPNV6|>Mz}o%Fw-g=
zb%{=eC@jbl6vRPcDr!gp|G+jc*AzVhv4Eve?1lhIqot)5?&Hdwq<$E6*I`boljkH^
zaDhSu@fs>$S7Om(AsMPjjT*Trid7+hS5`u=0KH2Z#7qI1mDI*iWnKBUIMyJDi=~0m
zr6)Vh;ZOdJ9b3t1lin>?OBt}bE^cKHERa6yC;jd4ZIZNqKN3;^$E$(GE|X?_zw(c#
z?p{<~z3A>!f8@uMF9@DwH%A|f(SIfVaG6YAcu%mH=O**gKc0$?V7kxN@3^PqBK!Aj
zyyg6l^4Z_Z7n0l23m&Eg^&}jZ4y=NZk7Za9s$m7%GZXhj4~*wWw?6T-aF=6G^jkJw
zGPFOyrU7tw!)@)KEaS&U<C-S5-^&Jb>)Jozzy`_lxjF)UA=!FwK-<aL$|3ndvO!uK
zNPbFL#2Zr_C9%f7L<AvrtOH$ZSno=#<Ol#3z@c%{XoD`N1P9BuRS;5VaWIL)xtGtu
zwGgc(|K=i=CJX*yXzf@>Bfz<c(&nzOXwU$M(U<G<=A}CaTC6=amOk;edV6LuvuF%r
z*Ku?mON-_5f7HUl<j^KHb3a%ti?~Ht$X~Sv$^f?2oa**^-Kl0P0^u!hn~i1zOg2!^
zDF<0B(OVY*{txc~-3&B)4%!Mz4uut~WIos}MOiq64pJtd)VoP&&KIHUNQLedlQ2;x
zXuY7(3RS6lKrw=!a?@l`=fm_(e5hNC=aZVXTAjwyey=~@Voi1@d#z2-OUlxr)NHaf
zc`I`B6EbXecS3GntaQ8Urbcq;X}rlbD>g4T!ELu?B;@B-c;`B&R8gg?ra0$Xk=QZW
zYRUHtW4#vc588BXvnc3ok&3zgv?_0!rHOcDx;R|@9r3~R0U23=^7@n!^Wd2@Z$wIc
zc_1reKzcCVQQjACrEj?<&0Ce`pIZ?Dpa3<?W!_MOd=oxwp-~9O7!{y~DdLMtS9%Qy
zYX_G_qh*YHYNIsx@#qF_>ox2*eAS{s%qabX2~Pt{&d6q8!>~g0;Rkpx8Sq!AfX!ku
z-VPkwNaF~-A^}-Y0tnD_AV`ocg_KH4^1NWEL#`oU4Ny%LEE#U-DmzZIWTeaLt29g3
zCQ?bs9D;g&T|i^eWW^c`$q9P*>bI}o@_BIH5La&4-7uS8hu|8#@Q&ARZu|2CKb+ZD
z#j1Y&-)x+F*&VHu-C3~+Y_#?5YcrHq+a@#B7I&80?lIct&9fOjo+=xAvd1K6UO{XE
zuP;yP+wc0fR`0$pVURnV>uT8d&c20%Za(vu2k!X7_4F6gum2SH+;xxK>N8raJ+l}$
z%TtwR^xRx0#lD(iv{iZTdFj`8d#bHALp=D6G~~AVNT!nuz+%d?B8}Ay88!$t&PU#>
zDjwL}vioi_sfbE}_Ccn3+5s~G_7MJ8YBtLk<cKiX5CQbXyOXryM{6Hnx9;(^-z+`o
z+x^Y_r>~y^SYus6-talYa^tn`gn1d6OZVIIf)gjyCzzMrJToh6+?H2YuR61SY<f~o
zFxSed?Vi%K`~-)&(eJODnypW-TRVEd4HN1MQ|x-qIA-0tF=N-QJ7s=kMgQ=i>|Ucr
z3@b6&3u;QzQVV)ym{JPjlQ=eGm?tkcy*Mw$s0oc-a^u87w{DzVUOH^f?2`QYoJ76e
zmL41(wAdM|8sv{n4;J=Fj4Ka@Lw$nv02rqJtMF7xe7gz`x{7;lhh>5EL>SdwmIm}@
zC1{;Qgk~GEzSG!YSh6dBMXn0{W=*6d>aH;AD6>n_L?s)p5})3U&r^JHV2eVueOI)+
z%3H-O`Op$Ei;MD~K(r!_6!C9Fey;e<6<itf&JMH8*4?{XrT4L9-_!HRV_(r?$wl$%
z2XA|LcWc*KgA`rY&#QrFyv*BD*2AB*WcQX6!riaHn*Ui_{j7a1zq1ZsrC(~DkkT4m
z#QC4L#sX>#<rV!engG@AMgwEuj|8`TKludWT|l6;Gcflc`98>M<Rss<E_Oj9ODt-~
z4BJr#?3w!GRNih+yckJ@?I~3~VbsMDqxiHq1n|#kkh6L+Ra~015n$<{(O42RSwwm@
z!R2(i5?DFkxBVioiS@}o^Bq|^eZRT{1q7)fh(dLi@A~XB6$nE|OtTYwQ~|Uk^%RGP
z{zP=VGZ=!<|HyeADttbl!4!-XYb7)?lyOlUyrOJ}AsF*3Z2MpY7@WDur&IQcbP@2S
z;tHNa>;ZLGqR;ZPnwM((<+rKw`)QY&$>)?!_oQ-OE~}K5{y267b;UnoFO+qY7yceu
z*q7=N<NR%FCv2K--!b++#h?AYu{-S3H%*A?orevCoqk_lZ=PB(Iw!wp&wOq_itR02
zmWLhjqzYMp*^WyIql`w9n&hUsTy|o6mXJz2vbYrCLund&rg0%1w6Ia?%kIoAqjDMg
zzYnzJQ}78qFzAszE0rh17}9aT8bvT~KAyDd)GJcEO4Lha9h3cXiN-T5YkZ09081sh
z0{>}P3iDE#22h$|7BcJgLYe51o*Al%ZL#Qe{2&RX&tS+x=`~v6NY*z@W%)?fcc><=
zMcLm~qU-2LRRy#9g_hV$Duc<?5-UB8>CM8*I@kEo63di*tRL-@&UCH~1{wo`YA)uP
zedtaU&uPUtP{DJ=>P9vM-pZ37A;b8WqcH*aAtP||^?Ud2+q;pSm(H<bsqoSS7M7YP
zs4j884KF-?`lr*!7lu0v?2mi*@jLeIZJ*4}15&G)osS+;U77$lhEq6!Edl|3^|duc
zMQdJT<sf+FN?943nZO7Df?LOPsr;b~r1P_r7J-~9vEoKNgg-Bv7X4EC{XDiz+A)u1
zaq){!oL~!1oQVF9bZ7Jn?p5jid2BgbJ`Wm&SEFB`j-B&{qGQTJ{E@0ltJI-wQd!h8
z(x06)V`NW(sLEtwEp+UG0c6&I0kfj`;$Il>nSxfh-q_Y+_o4?H1+To0Hg)WIla3p}
z%ZCq;k~_f-n;o{+h$r3Su!&eb*RdH5AgcIFebrI%8H{v2l&x;$14FJD$Sfgy7MzWU
zJOzsxuo>`<im2?K#mBba3DA(~>>RgOdNTUMD^l?*+G4SAx&}s$JNa1or<Sj3*KsS1
zIZjsEu2YYT-pNgKM>k7vI&+NCoA`g=ms{=^s!ODcYr&Wxiws%`f<P*hW6U$ac7=)w
zkq?GqNDt6lfqhE>YXZkgv=!QmG;uZ-IdX*WJ!|{ci%qQY!rt{#ri^_MnL0*_KE3)}
zg?)g%;@s+|rRbQcKd?jWD|YAyuDK=p&iFKrO=@TwGMTX(TAH6bHe=nPPi8kV);Rl<
zL+fT7dybOMW9FfL0=&#F-HIY-*<l&T>4*tO3<YI9Be}Kf3+k7HwDTHbFfsSaZU`*o
z6Y<||CZ@TE<J*xn=SS&5Hj-R+qfLB<LF<*ay#2Pc#j7<Kw8HyZh-}YDbGYpvWAXW@
zs<zCkQKPDa_p3&6iz5-$rFH8hLPt<3<@S5%j7zEqAH<l{wq@cP!o>ai_d711Mktds
zA46zF-%qAliQKm7qlUR1o;+~5B%3O2fe0&d8D0anlcelK?o5C{aeQP}+4l1(X=C&m
z8CBC81GzdOcgV7(dm8RQYLP&~z&E8~0~QbOQIX$}fnju-1-`jySdwTm8d<Md(w|)0
zXPwyhEO-7l!(Lxzw`N+Bl5?hSnmEF$9dXm~4a>c?YCa{+S%Hziw&#XJw}12sE8f;`
z(aHP2JpRX(BSyH9urZN~MG6m8q(d)?dJx(M;Zn>*?edvM@WPBM+nG%q=qtGV5^}K&
zl|U_uA}r2u#e`c9c>InLDO@FsfOF{X&z63*tRhY`<arQK`?b{O$uq=zUYgIvdlGbd
zSDen2YtaU++18-el55h%x%9dOPdqpOC6Dx!to-D*FMI)KelE4WuyElE2!ck+z!%_X
ze@6P^-0IcmSOP0!33BPowd9|XrSa;jDs_Bmo;u%f_>(bxopFVFA<MCS)vE1|EJ0rw
z=j=P?lf#C5^-)>vy7;O)(LLv_J|}%~)eWV>Ye-VW!_<L(lP-zcxF6aVvreZRWv9WZ
z$xt+8SclN<)$m`DfdHxf&CCzKR}w26a07LdQ~{j=3gCLgHFaXHP?@FXbIbYETS9wp
z9CvotmKis$x`%1^J>hGt5WRo#)FrX6(+t*}vutVB-dVHu&Tjv3&e-j{U)bBWd)fA$
zXStvH6huGBE@OPJT=tN5@w)f#ym9)LUFXK%v?QM8j{a4WSlgKRu3KZ1zH}D!D*oER
z9+*X!X??MB`?B4wd!OICy>b4ov#1rxjGg>GdGC(Jxacx=D~vP)XaKz26hpXd{sx?Y
zjC(=;B_t7&gRks>!g-M>D~a<~A#9W8w=T(mU(}Jt_y{2{B~|96dlTLACTDy}a$+EN
zbZJ>eVu{WYqn)Q0G^_u({tw?v?cY5(W5$EuF+pClT~{;3LvS(Wvh4HXAr(nZ8-Omo
zw5=|+M_Q`I7?+lu-6P&nZBP%>c=XNx#d_g#-7hOWb(N@r_Q<%zi(~NKb@1aDtZG6V
z(L5z<bHJj(TRWc=YRSxw44?SOa&<g;{>WnvLLx8cF=u3oAbds)J@N{Ihev991`^An
z=g^OI<|4PD0DCwxetcvc+tIU^N!kT}5ndCsn*FL*oW)QaNQ~pTUyCDCp`mbSH1=d`
zjFA63_t*w6yI%u^jYgWEGcGnZO&wE^T9pZlEw_f>lg#U49O@;~8$5hlVuaVm)r7~5
z3)e(bi&Nnd`=mj`@mk|{>97=P&i1H1amJqUR&ESCa?dBRX+Qwxc!ML>%&{DHLrP}!
zA4nC&jQ1{XDGN>T_K9~HympI@O_Cle(u$lIlchg_^l5-V)R8h@gHiKGok~amrHuji
zTm)>i>Bygn8IDKLff66Y{$Foj0v=V7wOv)Wx1>9rrL&Wb?17NAyOThGB!mdEMOkE%
z(CNNOnsmC`Uf4v9ii(Pgh>ngRsJM(eE{rpSj?VC@qqvMZjtlOn%nXj}I4-Er{O`H<
zb_k5~{onWe&+`XP*LKdSbE{6Bs#~`foBCN1Lw_0z;<_gKpop~tDN2am))0iwNyZX7
zTGNizGmQmO;r}2eiyyg{ON-@|PWv+7u_w6AdcbOnz1x(S7W*c{mL#eZ()es^x-{v>
zXJTJj)6=covY+3`lk+BzZ!B-g#mOn$n%i7HzG_N-s(1wPQ%=O^#N)A3L&0xW@#FDa
z6!3&Q&sr7R5aQ1rvk><wXC#-Vif^pxPsh%G2W{wUYkJIME**5O89!l-ciEURru=2g
zFP>Dpwtq=(?*B4gX}6ex(|?8CSIhB+auK=(OzzM^x^i^DG;xDd0&#;FPX53<1{r@^
zp^7<uO2?W!=q|l5(~>dzr}Pds*eseP0wKmdnAkI9Vl<8@OaLh{xO72@zza9{C{cI~
zHwteqMiwR<rdgV`BD*-rkf=BDvNCScCmNE9vsYx5CMP7AxG2p%t0*1s6)p3o<`){I
z`ttJn<}p(vlGIk5lU{Vz&fIcaSsC32IBQnMUMKEg3kE54!wt7nV5!Tsl!8N%$k0vZ
z6>Af86ULaVX0txSmaiMesZY2rQg1d}O=BkL64tITXHK@5(o$;|Hchh_2j7Z)_156}
zie;sor<p91rMs}T4pX}obe-X>S7+INO?S|Rcx#9vZip?uVLwGI`v+(LSVmDp=<;5O
z9mcC5X7uRCG>rEeb*x*6`8Mh$rlK#VyS94J9|v$I;05e5b`5U(qXCt=<Hla9xk7VK
zjXyO!f=92zDDU{!&QrgF#>4+N_dn5dp`L1do8qiceuWy~s&nk5kc#nrk#YjF2r5oY
zbxscH)yQM2qlJDFQ={W6Ro=?4SfMyE)lq-7xRU}$t;$)^iWot@<=+E8s&SI)XrZ4%
zR9UFwUuHOpet_zjPK%$7?~7jC2fP_W0j)Ninv2`cId)DdHKg{Im?A_QM2#uSIJKt7
zXeSU&ai}*g#OngPuPBb1t(J^Q4`r1g4gWFkNGIfC`6jI!r1hck2=%@HZ_3;Me9o5Q
zjrEsGKzy8KFD)s|FHimeO{zS1)eTvVrNxyMrRsGHz=_}Ma7@AHU2w1yXd|2#dFhM%
z3S~TJ8*A*`j$?3B?HRx2WeFKMW=nO-@;_x7Q&Q|1pWLZTI{aLndYEvWE#>SoHNYmh
z7uQymluzlX!ujKvm08u|T3A<6V|O*FH>{9M+NBY1D<o|cLq|Z8ivu99p`l%-ZBG;#
zL4eCIQHFY--;5w~*VgD_t%K<p>W9`~^s@(*@w_s-O~=B+o?(<*X2*&Z6f0~UhWE6j
z7IQU<{i6>uuzFOYv@sQ?a6DcIutp38tlXe!!*&@bZs`H3GR>_l+5{1hF`I?&$GGZO
ztqvsPZgLQ!t`xsIX--uJqe`Y&O=wi6;4$@s-CcSz$~x1eoYX00j#;IN#dT#<QgcK&
z?wh2g#1^H_E}1f;u}(^omhY%c9aEZ?k&#w9Cbe?MazhICD1Tv1u1wu!wr2i$Tk7@e
z3g<N#3%hF1-BLMKr?0DAFssH9?k~-i9vZ>OEt!y?qvGgHrA?!;(*B#QxHXTLP+p=<
z;JoZvj^?qZ!ir+YMVc#=Se{mrn_8I4J@ZRvr6we#&MKYn5n{|*V+n7|s!v+O%{TK@
zPmXcQ+}ugi7o<W$$eB1Hu_0~NhS)yBh<$T&><dq3Nui3t>q<v3O8*0I*j5_Ds_%6+
zeEFP9tJjq8+h|ioG~!m4P~o)`cU@~Cr6uCk4o4wTJEe~xghcHWll(YfA!}q$9=gF~
z+(?h1T7#~L8VJrsg|l(*#sRvI1YR_L+*MLqQCVEtn03P{(&3#SB$wwGmXzAFmfd{p
zi4TuGZYj3hZLt{I@bhu*X&o0Xdnu_{?9<eJtET?^Bf9#I0%|*Ha@lJt>K3|MRw>h(
zJFBn=tfZ=Tv3n9)&#}$K7F>%h1_OSRKF&GqChxMBF#B|3J~$m`zzk4nK*8xhDI><R
z%8-CQ4V7akfVCd94GJTC6i#CUI(=Z46w|j3^pDh{v_nzw30++lLW{{!UZ<X(CiNy^
zK!{Ocx_P3#t1~YvFO~moZc;|lvde^2|5bMNitA6m^|~Cc%e2m#FfJp%Ak&yVy|APu
zr~j-ow=T&r*z}Tl^-$eBF6k5Yp0siA*qCVz`y0#>7w)#j_mx}6##*fB>P>S*=7;Sc
z8&a=*tY_;j22niU-dmepTa<&wY0S*;JhOPQZ`IcB%q5u?Lu(pO5XnbR+QNrXD%Qj4
z-@;k-IT)wnTNy19F&a<~v;`~^+CWBt=4COgq7<bRY3>(=LtibkFiKSl4Wle5+c<T(
z7pal6u?Y7%8nXxuCPN&?hN`TJ3a>A<bb75W&yt=fQrc2%;;UqnA+x)!@UFedhQxeR
z){2Ywth{Vz#aYhs-F$3KO%Xouc00yr>Wx_Mz(4w7`niw$aa7{!*?LL7eNkqiZN2WL
z?EJ#ytckJjF0Y<Hw-)OSEQxctW6rW;cNvqol#+0^$yR!0;j)KrTyfVX$FO%=9?z<1
zm{C5qa_ZTuSB^^%6948y--l0JWlM<N*c-d8RBD-$Wc&kkh~qo^1z3AG8TZFshSH&B
zviMJL!QiYZ5}oM+t!SJ;Z-6wdt;fkZ6w#2S&r&{otM7)!tXhGYa`l^GA*?WlmY8J2
zi&QeFo$-pDHp24Kq9g2WQe2xBwxI+G$=QU%52hB4d2e$4)=KjXLv0ZzBX=cKv^dMT
zF4k7nf`h3m_@l?Zt7<S9TFMgn2eDhr>kI~GiNVVEy@>@6S;^^-mRNJfWIXzozVvf0
z@oaNZ;pt<p#+y@7nsi69F1gOqv`SQMb+o-#Jg%|qlN@XD*g4tQE&D@8Mp?<M^nY$j
z&L}RMoBCg}sURC0Oq;7Jnx&q!ZIvze)U?LjMdNkNMa`91i&)fJRbl6C`nIZ)39Ty<
zr<RpY5G%`gP11Q;XN)a>?z}Qljyn<byl`$#mO1Y__$T=IU9oRxp8ocvJm-|!dnS+D
zmQ}`^$DWaunNk$n#h)qZwxwkk$CmRmO6I28Z~?08sbqb6%E78uuH0qEju&8Fu@|*<
zHr@w<`07F(4z`)trx?%`!lh<kh_|gGMq_)_f$}bj*LT6ugW(h!dNoDwg<g-Y??M&V
zqMM_wP`324tWq2H1=8FABQpU~#je7FlvQM5Ero8;9W5DHzGSo-(!^eF@ux;CX^9(_
zd$4i&rR&nummU8ZqRh6$4Q;Vb<HRcI$ma=3lUgu;Uok$LZ!lXg*R48OT`Y=>4@&lW
zp8C+kv5%+CSP}E*r7v2aSDClxd>oCGV0>7#Jh;4|A|X8`-I8g_l70+5on%XFOZlrU
z_SxaW*@aiX-}ZD;dIBQWNOog(mOkc;&5-cUYm{c@RgOP4O_x}0_#@xpa7fjb*dvL3
z%L3SPl@V<F#qw2;i%FGv>ldZx<)xp$Csk*pVLtUOKhwqZUd$QRVy!2A$52a2GXhx#
zBg%lfnId{~!mS7u>6m=O?owO<RgqbdQI0);HtdMQFabplD)PaQQsHASTJCk*{&sll
zb(_ArZsnpPW5=AkKKg*4d9bLXrRs&9JFWR+=U*^mLbBA<H1m?hL&xUNd25DEjC*ph
zq&T-GFloh@)3b}t;rG9>^VVB;zH!}mTMMVO<$ZhiJ)eDc&yqPwrM<KE#a{GqebH5S
zzw*Gc>BYNl6R&?b>3HmsS!*vSv#q!`$2qBNL2h+H%EF1>Z9|jiVCTfBdHh^fh1uRt
zT2+S|4WSb8!717{uBE^;W4pFfLNs0`GbeGJE=c-@>l=Wqd`!nfl9H)Iu~X)Nb-8&}
z)tNs(eDn6OV}dTLwf*NWy~OP=?GcHE4QI7vWF)>_uIrw-oL|^jHGg_{_UV`8>#pjw
zPi&lv6_PVYcMklExzlqJ8rq__-yRMB!ZyA-<IUJ}ufE2QW!Fw!du`a2DP74^B17H3
zt=L}GH)BzjZF+lUS*oYqzNXxMx?}to|JEnO=fmbH>*|zeqN=7>XFM~S2URn5i?k1z
zruHaWz2^%(1jSMBfu=^z6zWLeV0vuybeQgV=Cr<iV?}L6S-PdttTX9TOD|pc%<NRG
zMX^*SW|Sbs*mh~=<-(MlVrjINv{j#0HGanUwi0V&Qi|0iF6aEz*|3e7`sBrJHbZiz
zB|p=alOlR-^GfEPbw|lOTaQT2PS41<WF{MISLEw6YcloYYzYM=1^91DuheJqA5WbJ
z<188Tg6H5JmsS_TD3iKURVq!N#tJaXG;u&$jLs2-5Z~)W<v|mkWO`IpM~Tr+CZffV
zn4)o(TKA=|wTwxyTGKkx@|{y>O|_I=JTK3l_cpFI$Vy+3S(Z~Y#W`iE)4pV~b4p=u
zS@!(YoOF}%ZJ^A(q|`EX_EdX*az}caHDOHK0sSz)^4y8*YPT52l;#yx+bZ&s^UmBf
z)?zl~ca1eSmnG@-B~_JU##C07==I5E6U}40@(pH7(G_O^u_AqZ;h3^q<JEQRCtkiD
zZQ#Ur`+0bmC+*kl=>M}0oO-%}o~e3J13fTTS`<CFWYN=e(lCR9u~a$+9*Q1ZAxzek
zq{gI@c2y7BOOotK$;l>u1!pHU1}K4baXYQ3)|6nXeQqg~pnOjGY>|?qDuLNbN>EEm
zkf<s_f^EE%DVa}c3!LVLm9wzP>RI*b@CQm>isj)`IA*&sxujR#pCki~C9!y`25SoJ
z4m+wjjiCwXvzn&pFsM#o(}Nw3%uFe<F)O*Nz1vhf5W6?_{_?-n&P_=^ZSVX`W<QEC
zcY@hqcp|xI_`|I+w&~1EyT@6$;fjy<@u6q+wiZWMv)$S!${SB}**i9@=`gUG<y|w!
z)f&=1tI3~QUTrAcZ@tfPeoBGSIA&H+SyEv+zPOuXcjX(imk6F$Q=E$VJwp@s;|8LH
z<l+f4YaY_gS$Xc3_A}R<K34svqMWbVg)#FAoDWTF+c3!w`#uVaE1HZr(c}cstUhe}
zD1dpy)p#d?UC_EpZCqKJW>eN|W1j+jbX9)z<Mf{%v{k(RQ1#Ru{gda-vzE^;x6VDi
zqkqSw`aQ2#*baWC*MI&2A=FI1rGMH?825^D72}r4H4nX3mH~`{9kGAivgW{!<;!;*
zSaS<c+A;H3;8;LhE1o*mdaPCd)G<c)8;Icvh1R(<JNs{$T)XFuvdlwY8VsL*Xsdi<
z&-nIR2By!LXB~%?P1bocrw!~R3}pVP!SLA!w#wJ{)K1<xFlF9cYhleUo{WQ--&(uo
zEjrOTSri--u?zVHBE~QH{&~J#YT~##?C7)7G8}2%#`obY^L^@j2~+lErK4|gqI}01
zwUtD8p~#>iC1!ui8oAYAq%E<qv%JxUjd<9#jjxLpO}N%+zW7z{v3~!Kb!TVIny~qq
zXQcPPixp&*G&yF^_f5IIB|Sa%(V^c-i;n)a%p~q~cjw6G>C0!_;y-$<=X#rd#{SKc
zw0ZwqKYTTLVPN(d^<%}8x!dgyr(L{z?6>@@AAix5rn4^GoIkDjS1<$WS@6pDLL=t<
z#^U7N7Fa_+Tg$evzaw3n@xf~n)_vgf2$@HE5BQ0|=mg9{(4t$ih)w7&(z0L|RZtup
zMVeMYFJv&HDh3%%r+RiB4Z852g5F2zYLpbkBBMR(Y45!bE8FRnmOdLR4wWi-&}CN;
zI$rwd)lTWe(JkR!MH#J=4Ahki4EM;=D*|Oo3yPbIi<>X1YOSowFQ~e&vbCzJAiwJV
zD!8q2hg%lJ4m@z~Yg^9D7`SL{!Q|$Gq9%a9sGvEoJ}G$7)iY8HdYm5?%-^#$;7*El
zwe_}5^-LAfSwHKYv!$tSS)XG`DHgx#W-a7d(^@CSK3}GrG+txS1SYl3OMR=)cG}OG
zUR1GU*1o#zv<dCLj!BueERilH=4Pjy_5G%jF_X@k-=eo9L0!sIc2wq+OlVrFJ3O(r
zc4F-h3ql3s#}|YOs;lwy-}uCHyPoO4_u$&aiynC6w%Dt3OM~)Pn6rZ0el^Qr``4n?
z7i_!X-L5*Zr(xc_hQ@jGVh2~=>Fb)bb7)|d&CqPmP49d%6o`G&(Y7O(hsL+5^wa7(
zySc4!rLksTsCl5}^6lp@u;arHHX+oMrw2Cb+FJBReQL6e8?tf0#uZ-{)OU}5htI*<
z5n3f+ufWv_^k%NiDrRXTFsNJ^)(_xH0o*i@(KvdLAzg2X-SDR6yl(gA&F-^X2YlD>
zI(Tr`9nbS6LqmT2@w8Kh5Ms^P!i}?+T=VoblVlIAuXtq*;raRMQ%467N7+k8-_k1(
zz*Z;d7>t||CnM6QPUUl%L0SEbaRStilq}Q0>hIq@GxpKK-7oH%I(zsx!?UOU{wBBE
z`lNl%V)GU0x#if)`beGCKB+EtzkYE}uyfh)@UqTePG@zps7e!b84UU)rsJ3E?DNxm
zl3TxFW@VJl{<3sg4K-PEj~~Yk4p{PzKNI?LqEP4zm?ff#U8EmR;99(rNI&9cX_(%c
z;9CgveJT+5p8`y=Fl?BisTRe>kb&`GB^#CTKKQYm5~sK;E~Sm;!@pL-XOonMQEB8S
z&{Le|A4P`~Hkm(;L$s7eF5x2{dk@txXd4tfEgX-JyF{lOR_NOZkDfyZm;6fJY=jTR
zC1S~ek`|YVaPVq0lK&_fPkPRgc;HjsL=$%v*(n~N$b&R3ZoTq68t&+HY>DHL<>!E<
z@n`uTxNQo~Fmr&HL&-zsokaO4c@4AmaXyqzapY={qT$5D$}=EssRF<y85KF<qAc5p
zjy{Qw=Be;PI=S(9DISJPaXPpo>F_Ifnj4o@sSAd*VOEXu?1|%0-6(P*P00&#AWdlg
zkvtWAq8|;zEQ9bsuaD=i)pd&Ih7r#-9NlPIiUTB*tHcj0vW-EQ@*l|uONtboCLJIU
z!>kQJ&!L3l@gsbI1Airj;~)*IGALz@c%o6#hE?A2GScwdMwiJ*8uE?PfX|4G;57k|
zq#I^)2p}5{2|f`fUIa*^I#!<xeoYpI5Amh25(ih4L&c>uK%5WKNRBq(CLwNuMk^qv
zAbNT>&0R_51n335o&fk<NkcsFlj7|YehKlV3NNA`1@!!gw@{i6eoCV_uK6j9G-o^>
z`AY<&dHj^0<kY|}T?D_xbR-Yu1GjmEW*A>L0f<)s@x=-ZtIw(7je$(`j0!z)+u%2A
zX(KXI7<qP*i@J~q2v^Bd<44annijHD6F$jC@{%9;N}Q6<Fe@?+A3sh!6ue;t7biTZ
z;Sm?{<k!KaJWK$p3yLFJ0&4rD?}!_U$CIo0hgCOjAB^9!s(9LHT*%o*eDQ3`a}mE0
znm8}qtWI%Sd=b&pvuSxN`HklNAN)AVQstq^Uj)}ieoY>woFPvO;?gKD4R3@$!c&l*
zJ(_<U=M*;wVGr<@XmXFEbc7S&R*>931;DiuXmuKwYebH?OmUawAU{F8EXWTTm3^n9
z<)rv{I8HN~Ua8yR5q{W;eS#;+4xWPI;1Zv>y%p3(!Ox(j3HX(EL3l)`J$IZ=3CHs%
zm+0aU$2A>c3+Q<${8Qybys7?)KK|UqBaR!Vi}O9zrF4S09ONe)<FD0tEv=1Q;)(qF
z6drrkFvV*SF9(Ge;xPJSR=D}2aN@X%%!n_ed`G9#vmktCTuv=*I_0hTi^z?K$pvm{
z96#<7j>dZ|;s(LDlF|@Qc0+weHB5e0--i`_l;Uk%%Vz{1-;K(k8)~1Z@lf)^nOx**
zvM9D8o(JN~$p7E`RU_^H7qlX;UFZQy0e3@nHv$f#Nbm)fN?x}XB{Ku1gn(%ao@hG&
zBiBU4n`Z-#pgRFw(k4{x3m5_*oPuyF_@(ZHsQ`@)FEh5Icv;@fSVj@xVW`4l#<J`%
z7of}j631h2V=UJP*o)(nX5flE#OH&q0Oe3{BbMtTuc8MT8=DSz3f;y697)%SY6eaj
z<Sh4~I(2}@7^{jfHm(xz4vMi3T{>tcK(3mV0Jyco0HoE~0pL~tFk=ni-MEo4`vL&M
zjyAw9zyWlJ@H;mEK+`k;*pDs^ay5fb^Q$n4kh=x$M94hJ0yxN6>lVf)1EwrzY%1iM
zinOW7yAAYh;M3j>0Pl{qj7`f1An$39LG8e6I`F3>tqbAPfOpza#%6-=%=;KSeKBLR
zUSJrW06;T$HUM(Y{hG0PFEiE+nYtn084CdW&}^y!n;DxAy!m?>TY&V1;JG*j0KQ8r
z8C$j-a5rPi!TaoVz{8BK=)|y+0U*Ol(D%+@%nce(DPyt)5CnXQrhkaBe(>x^o?ai|
zAY-dMXkOKTuNm|0Lie|lG5>7F0!R-cpL2j4W`OOCMeKkV7>f=tcJ4;THh}*I@Hh|g
z=K=5h`xv_bat|Z!!dAe8j9m;q8=C<~7`p_tmzn@u7`qJlZi2j*A7boE&~N^fv8#Z8
zHPWsD&6Z98(ym?0*w#7#;<nxmK-_gjfQ<mqY^wx#7`r|lu$!?PW-#`%Va9IUz}QV~
zc=Z?nyu;Yd$ZPvkjO_rwTadOh53mo-3F)^+7`v?-u%EHpmjhm4Z1*O{?f{>=A7<>{
zYR2vZuV1DB5We36Kwb~D0$ye8K_6oe=>XdSUoy6*6L2HoQ^tO^fw70P0oxe+btwRR
ze*<2>Il|a)4=}bj9RRvVfd6P70Q7PA-3yF8b~j^>dl>tDC1Za8zkP=pd!i2TAY)HL
zzNe7aQwJIQqaE-LV^8m8Z2w}$o;3kB1HNYLx&4ei5B|>|VeC&9z<rFpxP`Ho7yxN6
z?`G`J;PdBQjJ;9>fcuwH0ODWO0lFD`4e75v%-HK|8G8eCZ){}jz)HXijJ=7tH<9;S
zKETV2y<G=D9`7s$9AxZW;JycW-otagkF@unV(j3njD3Lk4>vLPQ8VBuV~1{J?61K8
z+X2S@4!pxU0OCLXlCggPJ^_6CDPx}<X6$o3*B40pDvz<REdbDdGaG>PZ`T5le#8#g
z&e->m_lFsb{Ro_+;CXZ#06dPh0=57SF&0By4DRtS@y5CtqxBciQ@o53!QG4}v;qz@
zo)`om-TV&YmJN(2=>P{9PxfF+#RNcH8t`rDfPI*b_A#CToDB3jnRWnhv$ivyy^`^q
z1&rq|W_(N?<9QD<o}UMRTL7AZgNzp<tq62ufe-u1iw`kgG6R6LQshz5$#~^cjKg+v
z*iBvo7ZXvu9&$JA#UzFaunE&p;Nh5!PeRpzql`C!PfHQtFyj;VGd^j6@z&)4<UJL9
zrhd(M`;Clu0Hy(8<M{M!#=8KgwK43PVtnQdz?Y1l{xIXS?qhuRS^&axk=6}31K~6G
zGCm*AH2(<W3riVa)C>UbS;%9t1pu5S?=Ze}CF9Fl0l;65=REsC##bP1CGvGaPS+O3
zd-0s^YQ{aojLXQo5BUAS8`#9S7yMSuW_$=~0mO&EGYbBzL9=Ev<7+oEz7BZnJ&d0V
zcSAN{7vtx51CW0Hr;J~)lJVgI#xDf!MU{XX8Nc{3#y9R}{1W&tL)s?rzr339D+snR
ze$@;B(ys=eYb=a!Nnw2JX2!3B3svIVjxc^b%JPQojNiDH@tdAv{AS>7*8yH-9CnD`
zk`6e;_|AQd-)ds~wmQadk1)RbKF06Z!1$fW<F0G~_}+E+1l+xV@n4iOeor1?KjZh_
z&G>!0v78X$Uv6ale&i4P#9^QK0|@{6Va9*sVI1~`@AUzWGX4m7!rt&lw=@1b;Qubj
z_+y=nKTd$S-y`2Yv@yO9&$I6_#{cUm<4?T9_>(s>{?u&7|5yY##P~Bh#`goB9cKJF
zq&@#N<9`Az><fQsfbo}CGXCcSjK2b!SCIB9@Lr2B{yOA%{Rrc4e98EmkpHc2#@`0K
zV*-52_`4e!e{Tlk2RAVO0q8zTXZ#S-{@Tp=-#P)i8UH(E`1{L@A0A-*W90cU{Qo$}
z_$PIMhXG$Q{^?=HKWBjL06fDNhZz47JpKuquaL*TkoI*c<KJ`w4lw@h7Qhk4zuSZj
zg^2qe;U6|L{v&XHge*tl9^K9OF+5KU`Ns}3fwiWB+nErZOi05_=sv|8#sCv0#3#Uy
zahFKK+@`gTiDbm3-~_<51x(n0pAN`CT;>cWvbvebZe=287ZbVg=e@v0z7KHde+8T|
zafisEnO^(}fI55HMnUB-mA!)3RIZ~TuX-8@`8mr(NR7u~WjGa6^-DPO`6A7)W94kO
z=GU`Q_MGN7fcA6EZ)CS|o#r>OY<{QaPhjc%_nP0##__leR@TaoYVrG7rfAmu&$2o(
zSMxu|OyYda|2#_+m#Y3ZC6+6;;2g;S3$k@MQ{0QSr2~+>2rD66Y&F)26|vLc^WzKQ
zI`|uK)=WLVW!1pn&V2Y+G>R&$gk%hOWW*A+2bf*p?g!6ytP!WQ0M_fsShpi1uP8XU
zfZK(YCUdd&Vm7ckaGJwB_`BG2e4Ffs|4b$HQ(THp;j;)_L&(Fc<XMFKe`*wI8%N3h
z)ADpf5*f0P?DR}B>r;3YLGl1%A}AM1`KhuZ8aFWFx%Pn~G>V48R06~$ggiXJA5xxs
z5OFTVQoI+ph(+OxbMb?ULT+G(wQ>w0hDv^PN&Zw#Q5{B5rxUS?rxs75=I=U*u13k}
ze~wv;5>ln{E2UJ6wf{0?j&m=9X4F7G7NDe}kdjX1Af2g))~LS|k=g>8>TxF930)cl
z7a6irnW@j-HBw&l**W0lMGDmj+OpOH|AQm$KmyJ&XIMMQu4Y%VE7(=|dU-9DzTt3i
ztU5Dt6V4J(<YsQcsUlXMjP>nX*)==`pQh8eji>Vro{3NM**Ie?myf|Ny?kukE96Cd
zEHB2s$WmU$%XtM(p0DELu!y>v(^9}%UWcu;4ZM-tagUx8+lrg95qTok2e$Ib*fozE
z?sz*+2Ajq^acp@PKaJ1eGx_O!7OvZw!{_pOyqllF&*bxQtocH|h@Zt5<1DkKd>LQP
z&*m#|MD|MV;=SC>JzVB}yq^znFJHw6ac#{IzVHWlke>sK^94)7+T1XYV5{<Kz6LjF
ztmEtXxqJgZ5BGXpfZMe%<QMUa`9>U-dnvz+Z{n9@NyU|XGrx*o&9C8Ga7*h}ejVS&
zuje=LpJB7mP5kHlW}Iuc11Cr9<h%H-*j{}*-_7sfck;V%Hsde&J^WsNAO9u4pFhAK
z<PY&Z{8#*8{%igl{#(8mM}$Ahf5#u=kMrO2Kk$9nCHe$^l0U`&i0fXS;rscs{5k$S
zZcX?Tf04h0&E0?IukgR{SNUuFb^ZoFz~AI=@wfRq{9XPYf1e-ZAMg+PNBj`~D|Y$*
z9jEPm%>ThZ;h*x)_~-l!{w4n>|BC;Mf6c$)-}3MH5&k{@f&a*l@?$*4j|(Qa5JD0<
zp%+-sE=(dpBnmUmvrEF>^kk7DQbn4uiFA=6GDQ|E7TF?4<ccvOPvi?6RgBXH#)@K5
zB1#2TG>QsQDXPRcF<w-Q3D_}PE9ykOXb_FUE*!!snnbf`5fjBE(JCg3DPpQ<6YZiy
zOcR}Ay66(8i5X(1I9<#Vv&9@SSIiUL;tX-7m@gKHg<_F7ODq;k#8R<LEEi{s6{1J1
z6fV)rUJ-8L5whqL{W#&#D^`g?;S)o`F9ISc&JiII77-B@tHm0zR;&~2#kpdGI8U4}
zE)c`wLUEC}SZoxRh)cy~Vw1RBTp_N+?b=s~tHm{93sz8U71xPv;(Bp|_?fs-+$4T3
zZWi0c4snaviQ9y36}O4o#cuSGcZ$2j-QpMG9&xX@PyABcFCGvNiigA=@hkDL__g?r
z_^sG09ubd<--*Y><Kp+?4`QGAFY$zUQamO8D4rJ2i2dSO@tk;GydeH0UKB5hm&KpO
zE8;KWRq>j5UA!R<h&RPs;%)Jccvrk9-WLbO2jWBVkvJs&D*h(^E)I*2#XrO+;#2XN
z_*{G;z7+oyUx|N-uf;dwTk)MZBEA<th#$pKfi)ZAxCGN62}zQ4l3p@knWPCP6eLP!
z$$~uxRtYys;k<%0$tI;s8CWBfC1p!FQm!;c%9HXX?8}piq_I-5R3ep1Wm36RAyrCM
z(l}|nR4q-AYNT4JPO6t0q(;e(osmwdNotl_q>0ibsa2XRVS}I4Cbdf)(ln`4nl5!o
zr%5xUnbPUfENQkhN17|mle(odq%)=Y(gF$B`buX>i=`#fQfZmATsm7?A@xWrC70AI
zxh0PzOMOzmG$47URnnm3lZGU}6p(__IZ{XpOA#q5t(MkEYo&G4dg)wggLIyBzI1^!
zEL|vFBwZ|RlrE7jl`fMuNta7kNLNamrK_Z?rE8=u(zVi7={mN}81;MW>e}nbZK$h@
zyY*VQL30~5*RHt^&2?&Sljb&SZj0u&t8PP=>N-@{(KSuq?{kI2`k`pp>o$aCSI9kJ
zlKrb?Umz&!2M~_v!Vy;}k$!sQp<ra4E*h3Yx<0RO$P^jq@wr0%vWN^A$?pwEL}1Vm
zl7|ATW#jrlV5rCIHz{r)8j%8heTJ~N-|zBC?m)jj5^{wHbOV7Q*#vHKkINU)MZ80@
zE);NiES|s`zYiXYHpK&mXprLcUVm?3tvTp(t?O}nLvEjpJcF_;VhqWBAvru?B2g5E
zzJPmB*XMKfC*ol|!GVBZ4kxY-_@YB{59BdxUdkXr^GAb*b3*QbM>h7NIN(YVSHBJr
z*7XJggC_bJa)k!<!I0M<F}Phra>%9Y3-}{Q_jwH7h|A}7n<MhtNY8-m?H`CFD*iQI
zPh=nwY5o2lpWGL*s9v}1kH{gj8VC`3lImX-4M)6v>vZ%iX0P7^Je5xKE4bD^ms_S%
z>sjsf$N^)}>yAW2vLPt@-CkefkSo|jvdSTY%R>xN!jMz;cq97ofGZ^H-2*a8h$<{8
z9Fc=Py)O6Q8du1Z)aODG#zUsKM@NOO54xZPP>ev(*cS*9x<x^c2NX_PKrgS7-4P4&
zSse<fPo5MHD36d3^hLuxq!@`qUccrwt4gFq8v}!in{-Z8Mv;ICAt!kKeF2p$><-DY
zKRghKBxz)-RwRH>^(FSY{Bf@<6bh_SO46))6)8-rKN?I_J&HysMMQc8al+p9a!+5>
z=d)=3@Q};rOOe;QeXb$bh*-LQZ(l^`lU;piBO%!&uY;nYHWJ9=_65SS1?A=U`ui2x
z^(arjY;wDNvftwh8A2|<Cop7m2Zn}F--aPqzh90d#>*=j94SYV59%ISBg>H_JbExl
zEZu0ZmOf~q98xngYXK4=SrdG<9Ey06W2zP&2!y=rp}sC(0yMtI4ZVn1B5S-6=%rfl
zq-3P_O30#Wd=D}Y1*AcFoer%zY|=yyCq)LLL%rdiXpjmnSqqW46i!eK$$-n(XI89>
zYEz6<p)e6iKCgce%Bj|{F&GUG;IWd>lH?G~1}uz!P%$B1zX6#C2iBSUy~v?g)dST!
zP&RrWY>;2Cw0E<j;%Y|Lc;i)ri3);3Y}6ju6n|EO%GnTw8FCMrp<-w>RKOl76b?%R
z9*?OP+JM6I>w0CM&+MjR?L)yv<ir6~V~?ucikI5EQSn8C35rVvlBz0a&k2o8J1ItC
zkbF{9G<Y%*v4IT_^vZ@cA+-4ceZ&<W3>#okQDzCfA+Ox$c7^3c(p<Hj==(!~Xb@(_
zKd6U7Mm>gJ*#!$BxuX$OWpG_$&=pkl#~ajzU906ps-2!*DC!_IE)arpiKtHme6ScH
z@1PtR0K@))geYuO2yA7@(Cd@+P+qSaW<Kg3Oh7e49yDL;h)*f@l>R`VAI5*g2AD@h
z=uwCAx<r(@9O<DaMLQuc8ma1`Vl}H?rL53yVA=g)T{sYes^Lc=Gb%nbo_NnjDuO;j
z)ioXD4nSf0q5mFqNxcEou~}1R!nDLyn*wCxBhc4~4BKjgriW1XE?7j^yhPac0T|7w
zuh#^-fO_titx6FqVo=v*QG=?c8mTMo8S<Dx8yN_MQTVbc9Q8)1#!RGCl%v6oj!Kr%
z!vtWJsi#!B6MBT+sMm+q(r*HBkouhj*AQ}d`Q5T%NcIeRBj!F53AwD2A-aryU_dE%
zU0+?FoazZgQBggR6TeiLX(z>~`gc+k^zWoF)k@+Cdb8?P2u-S=EULnvP>mirJcw??
z;By7ZQ4}R&84C2$b1ALSqUpP$Z;9tb0})j;v+7mr8Bgo?<6%@>J$irNx<t(spkPu)
zn?NeV<WXjj!in<QAT?2VQM;(XU|1P|=)*%0MBj%V!Y>WU1IB*z?m?Hw1T&}Tg^9)z
zL}pbyifMsfdrT-}^j<C>T98LhPy_;+FL}h?X$A<!MC~k;Mz3?jiX{+954y`iGB(gk
zT~9+(i+NPfVh%^qBGG)kL8x`KSM>p{xzQ4gu3t}O=at<uI#6Orqa5oAFAa1I;Q_Dg
z^H}2@jVetlbx}Pquh5~WH#~q64Z+yS)bXr!dtjinUR$vMih`UJqbkTrQDmS-6DbC2
zATs20=-lCOqXD`JlbNVmRVqluiiXiU+Mw^=VAvb(Ing1dj>N?~EnQDzT_c7J82XV=
z2J~c*7f%}>IS^0H<SUUTpN!!w*$maAXe>l@tG!u*V%CWjIM+8Ms$D*XsS`%Crk+hz
zkQ15$)g|mENsfl3{@$Pz4SOW7KP0URu9HI1UTHA2M(T~YX_zc0jI`Ml#SZnZgNVTa
zS1(#*Ph&$%+DL2!=Cn5&k;9q)9z~Cp6pvPHaOz1RN(Z|}JN-B;>(HA<du6q2(*nA+
zsOALvQKCn1s4$Hl=nV$dFzFZo#*G)oSP1urTtkLFjA;i$lFQ@Q_0>1kTYJ5cUKn;*
zW3?J!34I}RL~)d;WM2Roofu3djS5GDqf<$*Qbwh!O?(Z8xq&rdBbsR_;PvRyFrsTA
zrni^+mhj-ZAUd@`G!#B3icSH;0jNsA&<C^ZlXdh%9eBhWl)_P}TBp-UFE`%RveX;x
z7pn*LYh-V4051-H{0Bl)gH?HUGzZmkQ=C0ReSml$>{Ex}l;pH}0vHb{uOC|BH#J*U
zV<?VMsUj1wn(LC(o=u792~bo6{WQ`K)m5{Dew_5vL_f{+qrA3t)wkE7tX=hpX(6JP
zMhX&93lX&tQ40~Z5K&8uuE$=dQ1p@y6!tn~W3N+Q7Q5;@z{p+)B6}T(>~$cr*AY>D
z9sN*hJrUItQ9ZJ;*CQKyJyFyXMLki}YqCvKUQxU1rx9HP(KQfV1JN}QT?5fI5M2Y&
zHBe5Clv5*7;DiGF5JjUVUZ=*eQ+em@s_#@Vh_q455@!M9?HDP_+b&#UZYLgg%GFM}
z+9_ANl0c+(jdVI??4XPt#MVJX4kB_8k%NdFMC2eM2Z`z=3MWxuZ$5sA!l{YcrKAy&
zvk6twr=$^46D2eeQ4<k0Q9=`C(?r=cISJWKKFX$vD4L0)nJ7pv?4%cV(hEE3g`M=m
zPI_S{y|6bEMGH~15CtiP9ZG>8yRNT6sYWOTd`bdQkWx6H6!-y!gOtKSO5vzO9*#QX
z;UJB0kVZI2BOG-t`qeUQDZHc-4&vn?m2i+sI7lTNq!JEN2?wc!qn<KppiCNwf|S8Q
z%HSYnaF8-MNEsZY3=UET2PuPtl)*vD;2>pikTN*Pd^xaP13yI3NED4k(MS|_qOcQ%
zohYd49aQxWs(S1TpdX^J6NQ~997I9&?x1>iP`x{--W^o$4ytzt)w_f0-9h#4pn7*u
zy*sGh9aQhw!$Utr;Uo%FI(~@4*@Dsr1%8MEl@1?KP^CMl(jBOD{163Ix`Qg+L6z>H
zN_SADJE+nfROt??bO%+sgDTxYmF}QQcTlA}sL~x&=?<!N2Pz#uL_wCoL6*P)OVHQQ
zBrENtp;>KF4V06Us@_Re@6_x;L$lhP8Yn*}DS(p{z)2>-NxI~u`gc<OJE{JiRR2z@
ze<#(ylj`3|_3xzmcT)X3ss5c*|4yoZC)K}`>fcHA@1**7QvEv{)MnYB&UbY+w5x5t
zp<S8hLRgvSf~z*ThIUQVcD3a<v@7#mNLS{$;KunW^IQmbs3p)oO>;Xnce?6!XeHC3
z<=dg<+o9##q2=45<=dg<+o9##q2=45<=dg<+o9##q2=45<=ZhGYYFW4;BcA$1K@1#
ALjV8(

literal 0
HcmV?d00001

diff --git a/clones/llthw.common-lisp.dev/gitbook/fonts/fontawesome/fontawesome-webfont.woff2?v=4.6.3 b/clones/llthw.common-lisp.dev/gitbook/fonts/fontawesome/fontawesome-webfont.woff2?v=4.6.3
new file mode 100644
index 0000000000000000000000000000000000000000..7eb74fd127ee5eddf3b95fee6a20dc1684b0963b
GIT binary patch
literal 71896
zcmV(_K-9l?Pew8T0RR910T|c-4gdfE0#wKV0T_7z1ObTv00000000000000000000
z0000#Mn+Uk92y`7U;u^!5eN#1yHJMdO93_lBm<QI3zZlE1Rw>5d<U{jKX+wfW(He0
z;E@2<Z9A`Y1?kQD)79tb0An`7)|(ZU@IJg#tvIfG9Do^JKl}gx|35uxjG-lg<^WLD
z+OFEI`~S~oI5kR$FsiwA1P`*9X0fozWkRo9*z2YOMY(MI{pkIHL3fzeHiQuzX0s7S
zz>c6WY?}?kwoQRxJ870r-=0+y%ha*vYuUCUJ?P7_3+uzWik9+_!7nxs;V)%a4RNH^
zc4m8B@+|{zEa^4NCck}}Oy<ivoEpY39((X*{>G(NDl>kjf{My9O=ulWG&(tIM-}fv
z6A!D373NE?xA$4-m)kO95k0xyK*tYODl4ALJ?*1sxjWyV^(D%2EPt<aSw^~VYTxrj
z{(p4x_J7}ZS}}CPQ(Td+q)g(ChyJAZ+-oS~_5v|OOXqr@S|Q+RO@E&59(qWO*oKnk
z>O@;-V@{l;!qur0sm1n1+kORV!d6824O<n`FP@83M9BJ~%f9A+6{rveJV3%~8DnhA
zw7c7VoO9i0G!ul^M(JjgMw`St1l#OLg9-sf5D~CY0V7EjyD@wA99Xf<oYT4Ks$I3q
zaC4Emi2k4J(*BcPD5+Dnoi3}rosk1h!jA*2F;o8V-<<u=BtYAlq*MZ2)75JtM<Nv<
zRufth=4WO<lY9S;M4*~DW`U~g`jPGS$rY2Io;mxUxzA_dX%bwkh}Pxqjv(72*_L%)
zA1j3UiTowx`PX%?Q>u#3nIYjy1X(qjdu#foYPG3KvYpHl^J$>L@W~;6gmmj7y}hY+
z*%10elngK%mf>)kmtk|3oM#F%vwyz-seUsri!-}CbFaX$3j#~BowRibi*&DU5|<no
z9_8h9Q?Pu0q+OPNfecA1Alm^0NwNbDpyL5Id9dL{OhE9KLKP(wlKtOQR8;kPbzGU<
z-x%v<Vx(eC3ob2Y^gr4A_y8aXPje(ME?J`;pt*GmqBj@=MvYN5*hUT5t%?=f=#AWn
z9MKykrL+p70-~Z~V51n=Z`G^+2HJ1b`>l^-9DojV1KmJ3&?*~yNK2{0#ZVN1ITpSs
z)hb)%mHH+owyJyZ;=@<SFlCv*xZ9$XIP-ya#b~l&5#OIJw8$l%FZSbiXJ?;$lUzlk
zc*0&gNctU%M5dD{)k-F!wF8mr@<hUIZ+#O9F!Hx)qaLqkBiLzs(ufS`<}{cyX5*7P
zmTk8g`^?t-z;=5_Vo=ZH4pi6^BVb^=v3DdwVBJ`#iS?V{F@S&@V;r-P692!cR-XbC
z(akZ=Xq^k9c58gP8)bO+y{h7SuO7gv0!UUBKoJ0`764LG6^IrAkTV64)PhA)OHn;@
z*le$!-J|JsYOR~`K!H*dl+;U5Y9oy`*>2|SH_isxW<Q(B_H3H|Ao@Wb|Np;q)^7!q
zu-%ixE~Uk)JvnbfUaan`Qb|<`P?8X+B+CeJkgyq-ghL63k%WvvPD;=sv=8l`neWLs
z{E%M>XiDHvg^j1gB#B94B6P$PL*D(x<}Z8c<=-s-GKJNgzh3?2GDRN3z0T&pzuKy5
zEZSgX?$}|6u@yprg9vvZe-<DFEwC_=#8ZkeA&e{y*{tckNe$Q>G1=dzY9MP9KfI`m
zF9dV4Dyy<W$oTkQP;W2Wn=AflGP~D;A|}L1PP_1PbpAJ0C5T-sn?xA;`}Myg?Xzw+
zwQ@WMgAt{qkk>HdvHNuonakq%Z})dn-%>?ILFE+}GmvqYT!PvdS_xd~FC$J2OUk!l
z%#~<%=S>TDVW41I*<5F4PW=Cb00Hpk(YL$<@W$Mu>H*$ccI?5)Ybyi#10WFyc^d*9
zT@NTbOSECo`VV?Eur>U~%9S8~$K91%FJ7^dkl=ePDPVU1KT4Jdkx*U?+GziVn*ZNm
z5Ly&~RfHJE5TKH{G%~ix3^0v@=3$)LA+`D8|9u8QJP8m}&P_bPBfQPx@EC?6#+x9u
z_1@$IZu4!I$0sO?FCpgIyQv4-cKPrfii?1^7rz$?-~k8_VYCtR5D9|~OhT-9L7|MZ
z&De)b9BvT`c?5=3T5ZKWH2FWU$uXUn9o&g#QBPhznSb=-(SMJQ-jlvWk2wzDF+&Fj
zixv%P5LUoIrnI-)X}9XCEb=T(;%1}UX}6k<daW9DrMC(4&EgIT%eYA))mFce92Vd7
zcYlRE+ut`enW6zqemXQMk*1`tOWuwEGXwnp!6RegtM=ptD*mCDT->K6DwIl!(PUnZ
zodpVo#2~T5(+Y{UT;*~<pOj5&O33CM5b{Y{qVHekW4KsyY2v0>#?fFdq>}+jWzVpj
zD^#_xDk=o!(`H4DWN{OkJvuTv8G>h)GALN?mvB`^Dw6v;T-*|(!jWpiqsT=X5~if+
zT4<y~&gH01g1Bde;*bCkgb=1J)s*tMT;6+FiEBQ%L@z|44HVf1%@E;$lyN0bgIXTY
z<r3(C;D)%2N#>dex{{WPu<$a27AAm8mrz`uHrR?V_Y-t%O9ovX_rx3$c&hVA6Bo#2
zibMgz3{CqOigan0Pz_xxP<U9p6t`0@Jg>-+aq|pHZq*@VyYNgA0bOntBr=*fq$trp
zf#s#7I(cL%p^{>X@XF{2lg&y7f}C4Q(;7v;kT#5viE9Wy&5+EwCzjj)kRrnuIJn~d
z8SwB(@QWf7H*Au8PaAU+2!v2Hh)RT(Pwoc7+>>S!ny{Qf_$DcjfMiNw30-cw6_;oT
zX<M@sqUr{g`wxMsQ>!TY6tNIn@lSpj-W&ED<{K<FW<4_4akCit05y)~R^uN{Pr}iz
zt<IcCbH&{G0}(!2c3|vgyNNf8eKWmgZOB-^Ch=nn4ROc6?fm<|f->H5V1Bvl?jGsC
z`Q`?Ajw5S8mx(Y~I<NU8G5hli_uQ}#g83YU{UC5I3S=){a3V{{#YGfxA|}IXwceb1
z_UT0237Rs?PP#`B8^9o@4Vvbf7=w1kcKgU-M0Q`-X<|Ncb~cVgDbXdiU}DnfuGpCG
zo_Jz9=G#lYyKWbYBTv#nHaqW+w0?|vuSxnQn7zNcehbix7jWg?XV&sY(h0^8ap;+0
zy7N@Z-79={{Se<+q1(hL*irruLoNdm0qDq1*O!`+x#9JC>b>C?OKO{rN|o7DG{A!W
zKxQzo9Pl%yi|_Dq0=LZg_SM&WL6iam@eQqQ_k1MjZ+}l6>AlS+Hyy7(u#cGxs;~Xc
zJcK^~TJqb>FOVsX?3mj#XLSbATwbev44iR1j7dJ=qq>QRaJ&shK$roRrpOwmVOFnY
zk<*Uh(7UD^95cl936EzFwE$se_i4K1OLLI3yD1-LN?r46eN&0ddyx{SOU(6ewwp-y
z=bgwyta}0?KhM+53EWKrej{?$(j>QR0C<15+oE^SCNT(@peREXs>Rn&ef#7Ke3=oA
z_V!J?3^qY9^Dt-|LjYLq@~~|4&@Kf}tBxjR+bnrrG#1y_4jcr84UAJ#<wX=-y*}i@
zthD4}4`P<vc8Sdh&k~1?|L3QecV(vA|7jH6f2&Dr5-(4Vu}=V8@x-0rk$hX?+4Mg+
zq?~MLR>f}xkqIKI6#y3LRuRw7X9+t-{VpMl=_71_HY<WDk2bN+vOQqT8J3NVT_UaG
zUYU$Rfj=Jsm74C;eZM@MmczQ#3#}qn%K#6y@TAEPjIyH~kte?Q6G}VHEh?>DN^Hev
z?aq{SHIAAMAK#cAZ@TV4Y&A1-Po%t8GI;;ctaZLWtj-=ynw;sG4qs?4H(YmT*6N~l
zH@miZdmd1TpS5_9)aPnNHa@sq{MO$URk71S0B1)Mjjh?ASS}d$zvPlj-z?|pt%Lm2
zzKS4|W17$mRVh*>SV0&JlpMg+R2#D}vOOhYGjpZZZIkO}V!Gg&iY5%kZpc|zna*gP
zgL5{;u;|*d>#OP*xi++MzI-X5GNr*Q>*NnR6PnLAGAd>V^I52J<jJP1sOA|&c9LU<
zk>Gd=sosl8eXxHT<4IFVcG1Jv9|5oy6{Yrq88XTyGE4pP*}UJ<FyP!lX}rOePLh<-
zeDR2sN-~B~rYv(~@|l|{eJ2TtPN^*_7o3HApY+UoPeoFS6jAfa8yV4K*RR9g1@7aX
zcl-oD%fIo%X`zc3bMb#Q6?u#wktj|JY+v8E?et@qa&X-6e$%p<DbJ*ChpAOsgg`|u
z`xoWR6ec%CnLk?1;Hq4Q2gFJbvYx!<5Z7X|yV?q-bUfY|EGf~<N>POtX<FG&Y_HS>
zdw({brBa!E7I2Jbj;;<5E9Y0+C!V>!*^!3nZsTxfR>0XAR<HaZoMpyH$y;L{=5t2d
zy`Gn!0FuipG$p$?MkD&eY4v^RH+N+OD1v|(O}P^e1*11zPih(sGb?@kvm;WZwxp>#
zvlqsjOG9K#ST$fs`QcYK*tM-S-&eu}E0+Y{l_F)N*OU@VG@G?yO{q>vXdrgGPAQDT
z1p`ir8s`vmTh}V{W#Cc2+SHB<MtsSxshj4xm+hq~-E#=9J>hQO&7nr5VO}L2-jdJW
z!tr90Qc~v%E((!#Yy5{nWaqT?G-%Ya>CM2{ts^~}Yr#1*_<E>;OX>9e5VMoG^7yp5
z(Xy!snhKviAS%84VECkXgF9W}aIB?NERQbwm%<*G5pGX$6?aTDuwawnI7ARFdC}ak
zwed&n=_i^jF)t<$tNyi)9$PBJQTc69k&a8Dl`jIi<aFuM#3edHp1pQ?E<?-b%4|&4
zf8_;UI2qobub%3YtX>KW#tY50ZMs|;h8LrF#Bo~_5egI$UBiPF#4>~$OIauLay&K@
zX^#xuRO#VpcrY1`4~4XZi+w@)h6iXa$suYibVB&I&r|796R_bv)76ptIS^aJ!Hre-
z&kJ;ihj52R-@c$m@av0uDnBbKX=J;vziLB13U}cY>hI`p*5V2JM>k;D>m>Ud*xWKL
zy!2PNqc_$vf|DAxVNpw}N}ne(+{xIG{Qio1NuhECG{Rn#YK45b9q}Yb4TWy-qNft>
z=p~-^>r024RwC()MD7NG8{Xh5I9|sk5W(lqU0TH{h%Vlm`_OrJMaM>6qFnTrT<2@1
zShLW`*nRdGLad2(GqOcS-t4k0XmI0X2&7uhBgt8^#|KAJq^rMq(HA|DHj?eHH~p9<
zsJ##xGHjB7*|w{k2FWBNRM2XtC@i2wpP5^&fSm7JZD$Z_S=P)yg;*Mz%c%JDnrq@Y
zXhu>|xV}M`lyN#JyxD@eqseVU_b-SPSmoSmNK<Cs)}q7L_Th$l(GH~W$eE$OU@}kw
zJ(4ZID3W}vt%=V~NiUMLFwcWQE}1?%hq6?G@^zS80^WLz8i0@zbT~Oe6s91SQ9Fm+
zz^n?^vB}YFualL(foqov;#I(>*OU|sZ0d(*s%Kb3MY;B+8{X~j1ICPM?FR_k_x$rs
zikcbS^{mX+pp4uXN!aM+aB$&E7j;}o+bpAe=_-JfaOWYObIP;0oQb%4wZhZZ?A&8s
z3(o~>k-Ph3m#=W)6j<VyLeJtLFTFI?+P&SW)|weyB&TT0HBg#Omn29y_apXlK{ZgD
z*e~B7WdkPuJXk>KPlVe3Mx}X#Ch5)4y95VuCAzuMi;`fhkJLI})p)z-c9*Zwk*{R!
zoFhPXr1L<V{<3`Qo}=<s;U=5yJEnbD5i(&YIH;uLYR5W8Q$)l_==)IJ=D5A7Q%hc6
zOyeB^8foHkBZ4Q92Fro+N{PO(9vWhWMF`0L{YpBHts=EAh-xhm?h8Z)F$OIb<UZWs
z%HmTJseUHMv|jE7GEAc-q-x>jY60$HcnO7gNx5%q%-p$n9z%uzDO+?1BJ6cS!N}@$
zJGcJ2rsBMV1>n2YOjmmk5Sq0~MD?sdm~X=x<7Q$sHjn7=x@C4U0nRrs1bUysU|FcR
zbgqNN0=2AlH*qiIweEX0wP;_5sLalehDK&)%FzEI6qSgmk4e6N8C&jGXzMeg_S%~J
zRJ@?BZ_x{Zs94*~@=9QSz(Cmj8=iUFvX)AQkL7oS)k5Zkb^CUp00S&&L2%lS8t`jH
zXee`KcDjwn-I}<7xc%fMfgCCiV$+F>0cy98YsQ<t4Dn`=crTh)S!R~m%@V548&Y|?
zTBgEq?@_=9RX%!nWkYQv{{TKZG+LRRbcR+`0gGis)UJeBB^~)vj#F-4>Lsbm?uz<;
zo<<#oY6S1*<ef_kXtDG46~xV{T<zpqK8340-BibAM%LwK$bXa7S1A)W=!U|V30De9
z=*K7rh}$yGc(Oc|AkNBsD$mhK0^!z<^cKaXxB>plE5h@up~87iwLuNzy1e-Kdd}|s
zHuY&lM)(BZFh#4}IRPZWvmpH2daniN3yDPC4}>tT;n@|Wbm2VErvS_Kj$`P@K}ip+
zf`3{JnNf$!C}RM}moU!-pO<MaZ-Mk;E}M8}DBmX(f{%8viACLo*pA9oON5ZSp&#r$
zpf67HKv9gLwwbfTul|y6Ub$$>@e&*AYAeQ{sIdA%fB#`3{>TXGxbxLj{S7J*ih~|=
zOy!4Vm0Hvq#Zf^&BBunwW)*ok{~^U1))`tjSG^(i!*>nuRw=*enD(=Z?#ANzcotCv
zb*U(FfANyZ>+puUc`f;XNH`dI8QNwZvNNl2lXE*l>9oR7*r5vBlWR7=!Txx6fiL+m
z=kUhG9zyjtG;L`Y^U3%ijZ&J1kk<U@IpX*nW_)F0#@P(ElIu^N5T*x1LvXSK!Tu!T
z)yY{`E9B$LQ&UtauL<@Ll+KujFad%-Tjkp4@QPh-WD3m-$BhhkWsG!p(yw`yv)HUp
z<torn*;~sh&=-iTLUk>DL2FqBu)GG!14sdjiW`|$Gs9j~_K(Vl%!M9S(Il?dnH%lK
zv^Qmpe)<~=rHk9>Jf<=MHstZ;(2dh+{@Xu49$dJx&V#=)>1QUuAYmLL86g0cI?DaY
zOh6jD6{PTGtZk5jcXGR0X8dw+GJi}7X?t*!muZ?)4?PTc9c*OegpGws;aIgwCPAcD
z*6rRKUB)oD)Rg6GG7^;_<&-LG?f<`0<&Kto>79m(+r>#b@~e~<$#;mW=6xGOqvh=+
zHm81{kAIXL$su|mqnh=mFV>$sfJ=Zw93;r^s@!!ScUHR+&D(Ab8vaBRoka(M5^QAj
zE`8}Vxa`@mJjrC093k|D-b=7(wJRf+)=kM0&ER869hwSAS|gJ)R|AJsLPAhc=#m<U
zmMFK8NELI)0}ZZm;&j?Mu-L4jL07u`P*SYMMiK7YLp5MgA;O~zp`mPLUo%sg30*$x
z%vOVDmM!#Gzg`#zMOMf$^+x{BRq&jkw0lRJBUE(0Wz!?R;F98qrFbaBf@qBa+kGp|
z6U}6n>2zRBr9#=dK-oESBt5vPq%@>ch>>aVi$+hP5ap)n>L^QdM6#4tB2fav#1q1#
zx$$sPBk4N&Q}6Haya>19_MI)nR`AXS;DPUKV)?LdJ5IJ0ZcS`3QeSe5(YDMIkERg7
zqa@>FPgHj(cp$}6b=$gu>G0gfJ38<$7~*tWdv^KvHkkx1Y+@NtEWj8letj7%`{!uF
zV$0JpF~Vqrtc^5l6AVv|ftziV%hV2dQILX$;wbSCO|5j0gPal*kg$R_Z(t!6zkx?6
zd>suEuqruqYEBHY7sB-7Mq0M#A5lqcJ3RWTAvBAaBP1;aSL{?<ypQP-IduYJ$0+kd
zA674O^Cb8d(529hH0A9xx&&b=nLcsRjOI#pSw@^O>kIdWl@q~%@sWga43=cx;YfCu
z(K3u|?K(`;LG)Zibaz017;IzdLFE+;<KaJrWCz9MU*SkF2x)qOUSagg;P`Jc>_v%M
z<!Ltaz7(!~>$j@^#eua_G}wUL8&CQvDjh3$X~fN!g2m)ZXLx>x*MdpbI_$dv?b4n*
z#ac8i+v39p9*XaiL;ezLHLnSx@c!uFe;tpsm7k|K=J)OP6n0i51YB67LL1YRphO_-
z^oKRuXAe2ob??kazS*H?+uSXeiy&8O0&Od}c;T~DI>g%o_i9o!LWOIHf2+xl)*h_3
ztdVz*9C9_W*sg?rCJ5*CG~rCy%f132q@BYMu5(Az%KMv)-NG9a4=f`$mPg`l6F#!P
zPZ<&8!tnR?%dcsrghb-8onSH^PJYQ>A)>PqIqy$W{Xc5O;(soS>ChUz@?T5*FvfvG
zZuH=*Cs&V4#M^A5sQFo-t_<VL=#_L0sQ+}aa?_=0O82^qr6+ECYp*a7BWF&NQVA@9
zJGFjmtpCK(m%X~Rak*-atJT+bIBh;&tFCGWb`~8#ggTT|0v5^t5g#ZBZOTZQ;`>B8
z<+h;*v9>%Y)uP)xw-0BLC4iIrWj^|=Ie_Yy`Y-FzB_{*=)kyRaZ9bq9Z2E+lG>T#D
z|0T1Y%(FY@o_S;@XV+>ub(~KCjfj=C_<uvpRh~`XsGZfsmp74n$hq6=77VpPiG{jy
zYeK*1y}>GFn>k1%YF_21e|>xET2xUCY0|NkVY@u0kG#-Sl=VH%hbHBe^{(sl4NHLU
zD8NmDr|>yRz=;t)h+SC}ViOJO!r62v1P4X74q<1TMzTn+^`J&|?L)4GvhotG)@7AZ
z5Tnju%xo$c1XJ2%?O!ELvAXZ1y6l`Ia~5dZI*SvUD4fnroK(lG`J7SCrPK%L6ako{
zm?SDzng_F1t1WTm(!bn`7;DnkEuHzoNuy525+N@gj-`s}SC*riDpHf8YWdA7R_Zxw
z)ILVLRN+KfRWgwqJ2O411l5=)nU;bnQtHvFjF<)V<<|_$c?Hom$GO-M9`eK%LwRnX
zM=gx;$^G~70;LG<v<{CaR2CEzR#BGyKUnFqBh}r%a>I_9Z-*Jxeh7~QK{bpC^=PxP
zlVC->h_tUEiQH{5IyzV(syS1yD*!gZzvex;nGzVclJig{NzCf?5$0f0%D)u748e6b
z57~b>^5?bVFCA~YIH~eN8n1FoeqN4;qg>`pH;<Q=wt|wIm*U}ou*@kpxV|>5R%rD=
zF3YkjVON2%t4zzL@Xjdvum@jzOvSV65vSfVkk8Gpoz}F<zl&+7q=%)&7GEfh%|eN<
zQk6F{qoa1_jFf@x-f$T!4iBellsYKqm&+=*8kG=azyBuHT}i>y609-EVS0jO=iQ?q
zZ!+E9(8&BRZd|!Cg*+r4&!zh`l{6T_R+ql&moQEoDx|AT09x@^mGhBQV34MD!Q~!9
zKiige%VjLyhG-{i$O8hNC@-Icc&~kc6pweWk*VxhaB8ilYqf=6-gL^Ui+r<uflORD
ztqdbRcA2o#3|$f)tG*^ws}o|(Fg0epQOobyo21IlMVh83z6OGtR+64*{R4;7PmERu
zvz>+KM9(wmrjp5M>BhJOJa1#DEsr{oi@^*RmVy*2hc<|b&A@g6(@VQ)cN#1`wse9}
zvjNA?{a={<^fDE=AC?m@`(0UBSdq$?jI*lID<b!{C}!mFMlRsJLU7-0<`X{J7mrxG
zJX1YsZUNZcWY~*Fq^Sd=p?*<0XKAX(@@>qdGnvG@C2`YX2E9BlSxA>I%U@PF3(J+M
ztfsBhx8>NCgBL2iNgQe04N2QIv-#QW>WipmG0+JhP&>pGMhK-H+qBAe!+8&nE9_C|
zVAgmDG59jeVipd0hR7a}?|HQV(M+;uE{xme*RwAyKh#=_(~*LD+IOpIcYlB0sPnS7
z-w*BMv$9OCf5AkUd2*+|b9Z4#&aD@E+F=P69(Ggn>$2{hO{$%eki%9IETpd7G(C}B
zN)JLv3>!n#Ll&9dD_H+4;|TNqQhNw}IkO<$6@L;2(?m=NSan0+I1HJuM={%_Qn3`B
z;L2s0oW2#|;-jA#mlA5ZZ3PqGI&&1l&<E<M-Dp)W^3z##I0anS)6sT|4O0o6PRDXs
z%XY4&J{YZDfHIjyO+&$1TPL{K_zmB-v75rA4mzMZg^B%NW958VorL*#UQq=aOeX-M
zaqT)rx~!O9T9xC7udFg;AO$K;cnQ%SF!^q|Zo$knBNzp>qv;q;L)SrFM7z+247M@9
zE5ML(Ue^|t&K)hSe2<yv28vJ{C0z#Py#%?(D&@LOzI9u@y^<C+*8C9_WbC3T6@1S3
z=3v(atuhuCYg<>#AIU{yG1^yM$a?j}6@ZFI8*jYmQp+T7c{--pv_G&dS$gv{thY@%
zso^<tfII*C1tV3keQ_r_Ch`cQlsX&JfgZ$koi2=R$-G$lbuPIAn>>8Xp9xyfulP5A
z&Ymi^Hn37#N2sjTp*de0$89+zBd_{yiY_M}`~GUBa7Fb=MsDw!F1tpi(5&}upEV5+
zc#Xq>$$onGLc^FFcAhOHdVtGM`}h7k8a7R`(=%6FW|`Ss5@(FDb=EZWGUcaV<T-j%
z`bV$tudD3i7YPHL-eP|7H=xft`XDFpJi`v`SN*1i9Jgc%V!4)d7Hd5oktE<@vuV5&
zz=_tzdIWw5lOv137iPH`fkkht1*3JHQ$CE?(;EP;(_RPhbyhqOvrDT1uG4G+FkzyV
zH~Nswb?)Tp$69KWmMctDink3o@I;wQB`@Cjx{ObwT&UO~QBn1dvb=qJifDIO8)UBR
z0(vofZ7n0KsO=>)q&lK#75UB6X!8(A%gQm}-A0g?6;8(_EfrEfX3UsLXma2wWxrNT
zD=b=W-nP({n>QirDyOAHWjQJxUoBZjL`O*kD_<l$U&@b47;1lU@=!(ZIG^FNN_I8D
zNq3Vb&<d8JblDE^vZ4;x#N_0yO!Qa%TZC#ocBoEr4EXI1*s8*^=_}2Ih=Y}5a7wjU
ze5B&=?Zdal={~IYn_5m45>E?O_>s#*zv61#VX`4gkw5ubae8XXRy-$pT}F*%7So`7
zC3LAHOQxGfDmQ2ZJuunSVj<5XgWR}fTA`^|p3-BX5Q;VpLkM|`H2x{t^HWG9uEnv|
z4MUAwe5YvYM3MqeI?L1db^3!WNs_!W7Y*u;y|9YP3+ii0TycpPk18yl{zX4gzfCwA
zMVlxk04U0ycwDgu@w~zo9VC_lAEQ8NX!cpBG)%`3DJvzVM%emVC#sf#_@f>{@2fo1
z+E@;+GYYja*7Q<VjJ8WFIl}Ww-No`L48{(dQj(gMBK~>m>d$50OqJ8Zn2Q@}LhaQR
zIzTCNR0t)^CzB(B#fa)wDdC%%)Im|(skvm3^pRneYzv^d-wp$mlt?a$);UD0+)+xK
z=KoPx8jF-oA(g@)54w(CDk24y57Umjnk)vk;VLPq9KPD&aeA7F9Z*(CUU8$~S*aZQ
z%Ed{=Qg}MSX<&TEl$$)1h@Gg++oAO&rK*=!i@rS2L^V)m&O|1z^m{NjkU&sDZ7X>-
z7muSSBBBaY#cR<-sFAXda`f8AV7zFbch!2eYz<m-r3N#jXy?I-(iVh@FfU11Mq$xt
z8#-7Xu8&Y=oFN73{>VdH9Mau^DJ~^pNdDdRL12Z7x6mLNG~%JO65XGv7phC=n6oE>
zptAKH#9Fl!n40TS)UFwt9BRR|K1HvL4O8~M6|W79PTYWoLV*eL`EU+%#?}%F71I;R
zr5;USc?dG8q?>J%BYtzsy2qHJ0viUI{?qoER4bWAY2lSHBz<dCFalQ}q^`drV;l%9
zACyP*(lSCoE%k}e7|nDtO?5L+D04TkL6Ckd!aVzmuNu6Q?Qa4-MsUgia2b;-7o$km
z{~t`lHUlXP108Lj#OAr8L^KGvBM`F>Fr<J&O~r2ep&+``Wzv5_NXM^X;Jw}<*n>R_
zy-Oc5B?e;KgIujUDaweBs^%CV<ZP4B+2)kgHZ#Vx&s;e#7;#Q+acd>;i6<z9#|>Dt
z%E@}kToytRZoR;{r20VH&6n=3AoQk-SU-WL+cJP2>w;Afj-n$*^x9#YrH^NEhSX_X
zF{>d)s!AhNDzqTZW-p<d($f}#r)xL6evPXmhc)TsQY>-;w;)CT*m%m;PtY1qDkr&%
zk$qtlV7+&;MJ3Zb$si;3BC7T73AutHAhS#Egpy)22p?pwC!9RtHH90YE2G**2YObA
zZJlg#+3{rBcg5YlBNq049((6%9{Dx2i}LOpae4d<)hvYeJ}$4<n4Xb!F0SY?=rNSM
z8g>44j56X*w4mHa*)r3Hg#W4PGZc`M*l=Yl!gi3dFvo+kme;!U`i}0K(dp8A3-nvJ
zC4~CbGpb+URm9O`@3w&8B!6Od=LN0X<<Tt{gG6;hrIt6E=~@0==haOYU%g9Z=pENF
z{A=d2g5LBO<@x?9^6t=^jYkPv2`~T-nv!2V<Xduo%Vpp7x}_YuiMOcgOP!z}+woYw
zePTI--6<TXp|6un)QU`*`Yz(+ywjTY$SPFV_n5OpXDeJ;1>ezUYv~I*si+OJ^6Ro!
z&r@lX_@lQnqv;Gg7lC6C0E943?jzaAN%2QB7kg=Db(#PI{-155Hrix1Iu@Nk(lFjS
z-H*j5;(3s7;N*_3hAAIaar+XD1rCx{x2WZ5V~QQZO&7%UF_-hIoe!yHFTtr?(K1R-
zBj7=rdnPRSB3PJ{lC*`fE+KJiL5>V4ono)W4unO9)zviz1g#vK4}pg}!+`mV_ZRB6
z0RaUH5~LT|tlX7VhV}s+WS#Vama}_70BV<*1_}fO0uns&&w~=9__Ey&@b7Ez=Y{}I
zb$fv)4N4a6L9Tzpgx|j)b6a4ugT*M~@mhZ}syCdTwQ{_5itJHj7L2!6t_r(Wsg`ZY
z+^$etOV|M8?Qbn5GlFAw`_Q2u^Jf64dtqshX!mp7E@MAqgpECUKnAJsrQ^n>60OfN
zUg(2JW1Q%Yty^SqqM-^6GP=G1o&moP<i8;(aI+yDJkN;g7Z%}8V~*GKwo2{n$M`z7
z3B<vY2&xLUk0K#UQ{Qg|T1nB$W>JN*5Sh$0$ZTV&f6*gVqHF~#60<bzSP(wR-Y687
zGGu^cGTs1bXz{#jlobmrwn8Q^J|qb7-u@Y!h?Pec$1=k=bfEyS^1K*C;!6<uz&i1i
z#s<f{>aSK#+Nm4sylw~t)AG~wOWa*ZE6s?U+4A>TiB}?~)_os;Fn#93B$sHiJp~?P
zZ56^)(~>Ey;V6_<XOJ8w><+JJBj=HDoMV~3CHdi$3#f|u&ZT)_{FDSd73G@Y!W0)G
zRjqE%p%JNR+KafkBNAA0gvW`6t)xl{cHXm%DA&v>x|TRdjIf4Y=pZ$~={Lsh;m)M&
z16#WbP_EkG%BW+Xq5klP!KFpxN7AaioXv&Oub`j0Tf|o(2+N@g*1cjV2&U5-mE4|6
z-cTp39j|Cz*a2Fbz($2H|1JxfwaHxp_B9A!3u4PTVYW+`Lm`kW9x23{Dgp0L05M$p
z3%i<PE0yeK#~iPWTn&Lu9!=6nyj34i1F46dhVha04bpN5nl`KbGKNU%Wa^dT8FCin
zN!>Ok#QsVhC&RJ{LMN1~fu+zKhL_~);SVYfd-7X98niik3~^*$r^9gBUY~86mSCG0
z++cPS?Q2r#i_q({JZy2gy4<#}RB^!0gk{VKRi7?npdB&1CoAud&Dl1`?lka@<ViOq
zknr$+PDSPRY?GoP9uW6B1>!j=Y2qL=sQ2Ky<$JdPyXH^N!yOG)>$o?ZCJ$sIsf|Vk
zmuku-n;a0Gk{Hl2X}*3+4c;)gmP?`Qe!6!@{<VC)?C%o)rfd1kYj~)x-k_Py2H!);
z))2JyO_gycIprf2r5!b*%7+k}3WqI%&}O+C8VOi{=P=`?Fh*&xjvWm5ZY4OTI3z1W
zA>zWbxbiVW(|}#%bw<%R>0=W6<&xuB`!{*Hy()Y%2&@I-@!%K|DuE<M_#vS0w<VAQ
znjfYZk_Ms(Rf`mNe!PZ$+l_Q{x)igPZsStv{4|)(z_0X}5=Sjrm6O=Wg-g@|uW?In
zsj#_*vYw+Kc^%&&fZ7i?LcdFcB$52_9QB{tJM4QNgoeKlkro(;|E{YHVQ{Ap)&CBZ
zjqr|Ed^m(i8zpI)PR&1eyzo|5bhKa&cb1<9U7v%K5_gSQ;pT5!GxKtv6B&d#bHxO!
z3(^5wFsm0c$~c7F2l3x^3+vfUWQdGnNERi5%mYgr-HbthtB>L^Vm@6`Q~+2kMgz)t
z%O@bmdx_P=5)4rDOrlGGm})M5DO4g+;{+C{v6R#sP%(n>Ses{Q@*}SrFB$rTUm(8p
zxhE9y9$r?XrLj|+5yo6OESGZkkp3jIHC2Wfg60wM;WQ7rB{iVv=X>R6X!js~a|k||
zaxU9QiJ<77Q7)*o8<psGp+ne&DSBX@7yLx%ShCj1(p^N8s@vTV%fP|@rDuN~jdqF7
zyxaqsp`M<y=8Xo}gCJ?kzOCk_Gun?>kGm6E)8HdUMp<i$=Dt^p(x|&WZIz%&HaUCt
zx62tNKJY>B55_P?%hT*%#_nSE%y_mk+Gd3*S8c?e38(7awbfK^z~Z};x7DQ<uyPkg
z?%b3o{fmTti}%}d<Sz`1+(UDCnvLmg{o%lY;em|&v*m03EUeDE?dQw%;jKO#e7_Gj
z<V9mP1g+0v_lWQ{G%)Yt-Ht!p_x28V_qp?xW^=>Wo*IL)s6gm{<k@fQ{+4Mc60tAn
z&viEHYTeT`%@H%E-M>Sg<Aiyoi(Sn4&&Kl;W)U4mM6>ENK0Z!AHb;c(jq&zY__lQ2
zkOuV)S2$QzWN6ULH0>(C#?q?83-qfLMGGd9JY;B0;2Rea)LEoXG|Sog501{CZhy${
zZMe!as=son;=|~D(Vic6q9~n+OjOPCwUL%r?c@fYVXv@s+{{cSQZoXZs-GDgwL|b1
z;GqKtdkZJeY|b>U;eb|Xjjq`Y;u%J?M{V8p&7xV8p_Cu_pdek={4xh`hDN!Iqjuzk
zY};^m$ABU$-S-S2b@KXci|42VxJ-hp)@bm?Qj1{NRHP)ddoeR50-Shfs?~v$O<sw4
zQV4GfcRWe?CP;Dd3rVo%O%+%SKW$Dn|9So9KZ%!h^DC4s`W<S}v7cy?>0{0K1PBX{
z<fObm*8z=w;=QFPNyi_ii@R)4M=2c=Cm`i0YvNj;0T7Yq_<a$4g}I~fO53i|7t6rp
zV@$E$uwnrLpmxgw9rxQQwTJ4vaZq5RIcikjwAKzp(Fxr+VJm4xGh6t_zfwJ&YeN#@
zgLnBt7*%z*B%BFWnGs64uI8VTHI9%<yQ0=tqqt@W0iJ7kvdAi|_;t}A$h2G8dI8bT
zCY1hM9B|RkjnmH)cU*=zamsKFCDf2pHW|HSKUsscLccV%gek~|YFOUr?<QcfjQJB&
zvG>C()8f7^%SJ2oV_|q1sD*}^;7XqG8jw^ELl%fn0r{&Av|rml;t%W^%>`ynr7qmy
zMStM9X!MK51Hm6K(T}G)oAP<d#Hl_A0hYVrS<`39^%WW}hgpmPjZekaNok5+(ZD6h
z%|}kyc}1E$FrBvwmY~b1f}vqb^QAuE=0-bA2oGuMd(0k7O+qb`tMSw7o=jKC+z~LB
zd8d&tE2G4!*7iK-5|k``IF(kgBOdY1|68}Q!EjlvE|Ti<dUi$Ng;KcYOM71SaG)ft
z#L*!Bg2G#N_VUShvYH(m=67#SmYmFiL(ci+nPahF)QQKo#kS*ZphLrF4W=|CJfkZL
z$B1C-HMUZI-z|Z6H`zwu`9f*rpwS2{gi|Y#jy_~bBWTX^L(1AC7`_uLlQyx0jn&@s
zQ_4T^z)F}U5QffzYMKgb=?mV`zz^oHVo9C2oLUx)-N3jn{ArsW6*VRy7$ISacx1ex
z%3D+QfCY4otYfW>jdIOH9hN!CkyLW@#Hu5wOgA(7B!!oJCV12Y<uBH`9N7k+_d@7d
zcrj?Aw8F<qy87z$QF}Kyp~2R;rI(vTUgWXpwvxztb15JI54bar7>T(Z1}h3GZ@<62
zd~md_+eA{`DB;Qh_#F!nx_#H0!Z4Qqa5OdIGwFI8g2O3+4rh7xZId22a*+>?o@d8W
z*AJ28mPc${1u>t2quHizdqrNibjxni_<g&<M`#G6bl0B3tHwiK!ig<={;-?1z;SEp
zvS}@QBVzePcJmr+c>illCOZq#Bngpd*3j79hz~@aI&x{tD@YKSjx(X4d<3S_NN^!C
z7UbEf0?HfuYdexfc??vOg~A}~+yJMP^5fRQ%cL-w98K{9gd}DJ0#M?_rE{R`b#8Jj
zrK+Az1jnyjEj#A^W<4r70I>zeiMn{Se|bhEd+pX4Q}HV-(45BrCVuK{T6SQUuReOd
zl;PSmztnQ~AxsFAhkQg{o}iY(8&&Q=Sr;QF=}MZ4u7?;?==O)W&86R;7f-9iVA4JI
z4^)nWt&u6cEOTPzx1*F=_SlE#Jy6{ixuxigQ9ip&hb}~{qfB@~sM*7znAPkDsh8-&
zfml<5`*bg|F@9)mw&Q>jwq5?Ays~S3&zX+3_LK+rQufgmjfMAC^GKdDC6mzVbTI?L
zum9Cn5KoDp_R|0*r4nM^V3L?pK*s`m?(B5GXM&oX#AieHzP<SP_rKp~61sTcT;`&^
zcz^l|&Gh#lJTbK%aF=K=(#;rZ4ZwYNgq$t3OUD!wYgrZC*0htiG3alw{UoC-kmy|^
zCcLx^7*#m1t`3+!iW1}kp(ghBEFt6g1b`6=D8Y#Q&AVx5e0TLggEdy4$G_SmNi-;O
z{q|W-!a?OaT)?}d!0Ptz#P3ifzb?<OD;3;iAaRp$k;gzBwDjOwUvptfbM7W-T`f3a
z$1~<1P`V5>d`++QI|$ohoQphJD;?Nm2|KZ+S4XvIHC(KTuI7DzbGd-~&II_qb#CpM
zt&$0*LxGk?V{K_ScU?ZKx3o_VwVWP0>1%I#xODToKTHAaH?<_0Bthm17vd40Q|-g<
zT82=Yh02%6d;$H^B==J(IyKCZ<l+ALF-_=gofvFBHF&~%$^W7$-;S|j@VlZ0jJaeN
zpPXBJl~u~UBNC&JW!T`t;7MSB5}^|y1X*EYFi~Ks-A(%Z9bqlwh}#X6ByPZ3UDORr
z3YJO4j+54#Zzj^-1VLf3>|P=SSHgy2yF|YB{HH{tO53k3vfSG4W+!-q{4cp83-n0L
ziV|y;XUQUi=D~TV5!>=spl1qeO<T7m23NNaDLnjothI=>Bh5CTliiPh6RX=maFIS6
zl%SCGX6jb@!3#~$_puMy=D+Pu6GMWBoX?eeOtj>ToX`kd$2IuSB!ISqBhR<(ybl^y
z-(cixS3ARYivJY1OtHc+&dWXezxYikk|TB_wuUAmn%#_@fwn7bcYASY&2_fhHPz!o
zc#*KVbPQ40U2FViWzS@nvcw+CE74LJ*{<E8mW;7))k4r^%<OBMGbTCH^G_Q$R#>6Y
z=uwJYY7ToZw(X&xO*PjpSV@@&hPwFzVJ>*H5pFg8N3YiG2m5b60>MHsIe6Xwa0&ZU
z$wVq^EQr_bm`f0M&DXx(Sj=aUh{L;V^J8cVn5S8A5+4PZIswM^f_)itMr;eNBxz#H
zq<1<v>zfNDf<~J!y`$F`q;c?SAfGkI_f^5T4S^+Jao^UJ!MO2RLq2<6?5_di6Q%ON
zC=aBtFDxTb<hLj*Lu5J0pHoEwhiLy^JFRsr@@LupH8B#sg3oYe*d6T;!nePkmbkF{
zC%ubfmn)n6?k*{B-?yGLc4-#ch-G1B*D5jaXzJ{(I&jz&9fkR^X3?(%D-WiRD(60L
zLX<~mFI}wA@~3^07mt{pXkO(l9Vz9;73XA|hVBNVZgPs{2~l01bymrj#xET6hSJK3
zX`#?fli^aXM}wU=Z<^IB*y7aXOsSPej~GOJ$o$8$UKzDNyv`kPk}+YpA>6>G-g7MA
z2^@hIDzrzA^Cqp(DthnY@4g3<1|>1bc*UBd!14oc$gZ9C(Ra(hNaci?%nEY8nT>u>
zF^-<4n6)`P2|K1P&pN9hm^1izx2pyXhh~ABj4DC8bV6U>_sTF#4JvOh&wNvC6$l@3
zHF5O$y^ETb37|3R#=h-3TsUJN>Z--OV2bs^wtgKdhl|161GN{sK#&ZWs>^WkFEgK#
zB|GDnyE!oiw2cm3LFE)`L*pq*$zI=b<PA^{dm~A79KxN~Nu1Ov{gg$Mgv6$_fGO@V
z6p9DD*LWtANQVaFgUTt<+T10F9aL5ZMgFN1<#aqvd~SaAJ6lP9uaRAJv7;y5D?GE1
zbMp{<dZe6J1b5M9BCDLwi3`UpWT1ro-ihSOwo=8JAMPg=LZ%v=q_h;vIhS7NlZ6Va
z+hZ(BD$KF!sJz4|rOgfX$;sJ5;ll9f3$plZKPa#5ZV>_;tFo#JD=ctF!P|POWG|DD
z;B=Zcxswi59dzM`=%=6Yg;aTgUX@zTP})?`3Mpq<=9Go4DdQI;jFi&~10QLg6tKFH
z=HS&5vQS1delM-p5>3JCs@Ow2XVLL!Y-CcJIF}oaBm&h^Dp@Q}Wv9q0tE{lrS~)%A
zT1I50i)<{KJBi)3#S0h8N=at$!NH+3SXQ)0;qJl4OUs0`1Bfb!%bdk^Rle;46)TPJ
z#P71zcGXU7X%o@W?7b|{+8SM=gtBrSe*!Jf025sD7gjH4*>4=AT0P%b%a`M6WqOPi
z!K=V-d1*@Czn%t%uo=Z8srYr9s>^y!?|iQ4)-S0(nt%33X~zN1wcu>}FfaI(fM<Ug
zP;9m^k|X@U)r%Ka&3(I5i4ZAnNav#a=cFq#1b6SA|0$)%2=K(LF}qPMKLOTrWAUq3
zr!f*kLeL>T>clQ6%XDJP#pJa|gx5_zREr-awknAn2FqZg5Sx{Gsc?B@RaFJERnzT4
zyWUiFiP0liY&UC&`T5L3vRXX9E+ypC26NrxKV4*G&NAg&3xk``jQw-+P<ODu8>-@&
znO|mfL@m+mn`6s16ma7tqsB}u)-c*ei)pW8dZeh}5-OMKSp0-5WAKMt%)MBpCrefW
zRJtrp>l%Af2{F@JSF_efGsya{;e~_&lB{%Q-GmHs%?xE&h^G${W}!GYP)cf^&!};~
zdzAQ)<qjIZt87r6&Ziqv^9JFa<7<fdvoT3^*KOMnlkH8)mG&t*&<vHaPBd2^vtRfL
zwF8jM>2LkI0QXoIT(_EaQ~0<m$zIl)v{>}QOuG7k<=w-rqdqL7*F)-PW+NWBRU>@w
z!B*fS{(Q5OVNi2gW2eZRY;V46zt){3r?G+L6gutli{+2B#B?hq(PEY5xk(agbXp^W
zyZQ-M7bYsubPkm9rTrYeYt1>HCH8#tQb^^A(eI=<C0zZ}FEL-+eV@x+5AKnH;9-Uc
z9vCQ5nwxFN9a{2kclShr##hcd56_6kWmY@M0fzF49kZn2qy=4Qp^Vg)<8&*NU?L{h
z#HCKUU8e1rP!p3#o8^)btqbRX4sE;2h%$%X1^6?-dbylqLF}x|*gE>!-gZl1h4YWj
z<Y<GpnpI|wj=D8?azuc(Qo@MOt}sMj`=sY7O+|4U$0JGzAye|m^@vzxLVtAi_~I-z
zZbDF8qb11(rRRW|nVYAbeHw4dLr4?}pn9nY(V&HAPR}_=a4{&}D}O{Vj;m@3S!`dB
zR4a#!nEfepO+1zv<Ze7ck1dV_MrogWDZVfVV^!ZrhIWQQmrO{jW3V(%j)ZMrl>JZ+
zFM1g15?=1r_o<{Egn;CDkWoyIG5dLey;DSjLdCj&DZtS}b*y7)XHHD*Ilp2zSc6rn
zj6dA7yhu`YJ?uvH!m&{s<qz82$BoUYEN;=}hr2`8G59y_o31Q~nY<1k#4%CGRoAG6
zhyz1n5D1NYZtb^>&+aKfjN$-deftu3O1SEsV~ntR{EYV?)IO2fDp-zH62t-+@fPtu
zt4)Rn0W?;-0QBOzQW-O$0az^2H|3+j*954v7dJKGs7Fz7ke!?IV0@6k^$Z@Z2NBNN
z8;=e$zvfbIWr$r53S!{>Yoe9a6`x%?8@8;R=R+kj)Y2)KzYOLah!g;a`(=r*%O20j
zs;F}N4=0%ejIC^_50xE236@Q!ViZQg|EF?!WZM;UxCT=qJg8cl?cGV~Ne*%(vch(2
zj7N}Kue~B`)kzA_Dw7zE>3M&|KwnphH@bUL8lxC;n>*RaA*_TsNg7yOp5GzXMJoL)
zat$Qs)W@?|yEf%ky2#kUYQ+6tr5O@d4qc(@XOK4{ln`|N1gf!TF$^t-YazEfCn)Re
zyhZrJZnYdm+8%F6i16!HDpdh5n_KLL&J=I;9?U{u^V|3xrca(9edcLmM(EY1q|GCD
z>aIyFhx*z*0W;DQ!FDBL5O;}^p_Xe=%@P*u(lKNUdYz%$?5;WKhNqKOo{-=DLD$8|
z4j$Q${=_n?c=v=E$+=pUz_2K4pdp-UTjIRMI>e4^j>5qIWamL(sRfpWCJk4E+XeA@
zIx~6^&DWwIEu%D|8lyM-7j2@c>)`FFSWcEfi8?wGnuyb}R^^}Rz>e;(7HR?hkX`(5
zpE{Hn90;k<5(Ld!u?ia0{H%A%wv%M8?tT2h<fZ=|CeR^{3f7gvQ&hhU+L~2--*`Kk
z1|f)Fg&Drebp0jqj*|S{rnIIbRy|;SeerNVb1VyZf*6FIFVAJyTCa?XrkZ(wgt<X?
zkI6!b$7oPJ--cDP>X|^1fKVZ`&HCcFHw|6B><EskgO?dj9k+gcd~R%vVpfj70Ka?B
z;V`0BZpf)$+YCBfat|2q-IMJ`qx;L8{<h5+IHL*8$eDAc#Ra5yeHYg8;p2I(@Y2|a
zAuygA8av~-;|+Dm&eue*;geV&+VN)`Q@mzp07tguXfSdc0r%jONYW0sdsgJ-4DO$H
z)es$(HyT!2@bLjUjgI3nT8ydnFTBB#8RLES>d~3GQ)ni5^U7ysEqAkQsWB6JlO#-M
z@@4dL1>er8nsq7Vq5NjB3JmY50C-GjAr~H!s+j>8y3n=TGP2`IjCb{c{!3x@dWpv&
z1PDE$jI_s*;u=6wLqb&R$B)6Dq;K;R2w?~xe*u_;5tlJZHiQN)=d>1&0e~=mQd>?1
z6(1sb*CX=}JA_LxQQE<9gd1&{v+@~CBV&!MP|)G1xN0^QXHNBYlcrC|q@;<q^sj+?
z>=>EVzDl{19@$4pp|gTs_cGf69WQKHapw;}lsUZVU<P-g9T3B@gZ|}kcM|LdaW4)t
z2m%U0iL!U8%&N}Dy!TIpil=Nc_PvyD@*m>6Nh(kp{t;ide6DP7t`xm~Z%D7!vMTtu
zd2dwFMKhcXjqO9ZZ4kd4(L`20l|Klc$~}9rB+oBksP*&y>q&j1q-`TJ(GGfwrE5dW
zp(+?mHzP~l#7K4FcyN>5gNnlo?!Pe7`|_j~Bl8bzhv2-}?2Z~jwsz<LkQ_)YHk)OO
z^6P}%Sqbs`@*M9zm>fQIAlqZ-E00vdu4AoJ<>u9!4%Z{jgG>C?xPMO)A0Ev5F%-=E
z?0o$osyWP*`WO5~^MQmDkN-j*^FvDusKB+TfY1%kSa9-OUe?*aN#jjz2iU{iESoJK
z2{HuApjrBKF7?CwxMtDWw_|_ovsH0L)enR$@34Rv_(Kmk7%4*}%2QGq)&}d!>(*tm
zD<~8j%)VY|IG_S5FKVKE4ynmpqeM#g9=YtuwGqhQnNm5^I>h2W(Ur|Zi)Z7{y7q3%
zU0b&x_M>{mld!lLNXGM!m^m!W5Z@T~S4e8d?)OE-RrpoI%Qx~%N9FfzhU|%;H~Y2C
zd{qENK)S!Qb=3aa>k?(dh0CRH6AVUUP}&1yS2~6tiM3@z^}?mArG-<GDOOvUn>v3^
zJ5*O3;qWk4!n>3|GE~3d?7Ipp9PZv~$wTIy$~MB`+DqE3uUHB<+S3&3JhFG#>cUc1
zj0N@`qwsQ(f2G|;)4(pJ8R!s?<y8)ZG9hz*Pz|Qp`i*7N$Wr*A%6MKys4d<)my=sl
z=~b+X;cZrFAqQ%G2cFmHq6vq?mFgEmx5xF|nU;GV4+iQBjmHA=z=!tU^q1RD22Hw)
z#Sx?6Jf<<Mp4X0^!oq}r{qtPiP=ORx4p%XUA%}Uy=oWQ^XQUq1XHf`T6t)>lACoDI
zk7>fmz`h9De26v_D`UlsCtesrq-^X*=B{Te99RB}64$?mxwRLV>{}EQ?KTS*P^@yR
zkq{dgv%ulL^gh2|%D-|_8n&)}G`8_-;Pxws*<%FIr}x-NZJ1p~JFniRdZuV`qr}*#
z0^17qGNJMaQ<(iUe}q!-SB9#Ap@Z1x#<bZ)2n882`TTwPv{vIfZ}D2V${_l0>!%f$
z?9h^x6(t0lJ<vkCRI0ZZZ5@MlQhVLbVZ3n;2|Hr%RsmHuRxGcw-ZV%nebtDZi<DpS
znk{NWVx8iK226*U1P=Qa7KPS~(Q3y^BTQPzIzvN2!S_zHkz5goH)z8xeGSQ}{<?Qj
z5__IOUa1`9Oy4Y|ar#FXa)(!$C}L3ve~IhQM}bhy&P0j;&5PI<x=a$p(<^y%=_yE8
zK?AK6nSYPz@JD%{4v5lXW#h0%`dQ<Mv+CC$@rl;rmD@{S@E(27J<YgrVMB2GP`JdG
z+tO2}P-N+wqZTXnO+W}hQrdlk<dta2zP)G(R|bu5F`;02M*TL=(LE4d`b9K=>~?UB
z5&3amHwz&S>J*KN;5ZTit|hZeC=1U|vf)Kjtt*#HbRG52?ZGH}e7Jh7I+{WMp7~=w
zxG~MF`51_XIt8Mg?U;4iafER+p|}!`Nh?;+;VwpyWN)3dsU%!-X8a;(U2={_hig>#
z8V}IQFVz*dKN@8!k2V>sd=d%&7v7fy1$Y>?h&9avlj}Y}diz0wc6w-$0N3_pF&+qW
z9FO$q1(}EU6Ed%5AaL)|KF%4qZjH%)P3hFNait%3c-7;lTOQkDc!A}<ZbsHT2^UEv
zZD$#5yU4ArdGsagG-}|j?AI{7h9B4X47^M72kq|9yT_O$#JA^mVab7f6U;sH4Hb~z
zoLvhA68NTwG4lzDw1n4>gNa}h6pim$@J4VqRsuAOPlZ~RL<vSKk##_FEMGE4J6GBF
zg`MBh$yKp$Ej))bh9A#A`|Wpq<J#s8*sZtL{EoQ7iieYUz50&%{6QBH0&AZ?V?mlD
z^7*NEHyC#Un~YatEy^uK?IOm@*>-u`%3ga7CTF)+LD_EeYFTrU$FbpTMNr&<6~hwh
zzjF^?p!%_QsvVE&&kb>A+YNe%09KzT{=W4K<JQgzi?K!U0pl+gdiOgQLI%SycgfdH
zR<Wy|4_Ft$#x>g;pzT59MH92|PKm(h5j#zScYl^O;TMSq7VD82%3qq9wi;V)C~7SR
zBvRA~%lvF-vFgyA)|3_09oMo5X;q_^-Mh=P&YOnik_PWov43j9rq|kn>h{Yeh?8om
zz$u=f((hgv7c1(M$T1)m13AXdm&-0QoI4}d<P&-MFuwT9_cMhpx-Q%ZZj4bMzf@6O
zKcjuOi{k#AWs=ofKCaBe2Oo1b&yEGWtH_OY*P`=o`(^HA4be4E&?4f*;?Il=;GgiF
zQFs{;ajH;BBLb%JxlU82P)?<W!wuYhCYj~o3CY-&Po70DK9nF&N7j3t%ur9hM*fPg
z^oG^^7=3!K4H&b;`Up>VfsHsa3^<pu4$pB4Lmi{@XF0Z;=-IoMkSbc?KqYf>$qkJm
z)&|qDtOds}u1rrD8g@^OopG#!lO_`D$EXZ;zcuk_Ia^}yJMS_LJ5Na2lms)Vc6fmk
zjH%#?i)ZQdVhWm4aKxUzLNHu)rKnq5AV94A@^HUp(7awCTA^-+IatAoVILNR*UUww
z$4gMfLjAhy@(&h+mLZ*@A$$k%kb+;Jwc<2F!Hejj3x6LHfQN2`Yx(02p;=+rNwL;w
zE9>SbRX>mXjzr3mES3I!>mX`On;;QVQRk=WB%n&MHa?LFzrn8q;{_kxWa4qZjSqzb
z0@z+W8e5dapb~I!7z>6Y!2MsOj)x*Zh9ru`4Quac-&($0_V>%5<?7IC!p@=F6RG;b
zsDk_CN9d1sQVLMgB5;P&-{@gQGMxZx97(hdi_bS^9rrU_#Iyg9NLzOA^q8T#Bk=>1
zYkXYZ_5=hXCK48OCkqn8^ySE$=tGz~E1N^mXM&gQ>~=zrO-C)%a^8iIrF&I<@xhxk
z&!7D%T(tM?V@r2F#6$vwl2LOop@ii$ilbYJ>C-J`N5yc`@&0=jln+O-_KI?6x?#4g
zMQVB$RD_@^ZDag~<n-0QVKy@xQ@NCRqkOKcI_y950{9X6priDZvbG_w%NAH24xC|o
z7rksBDt+g>you@(oXv0K-aBI7slQ$B?pj)1{Kcyit>hC?I?$u$oL<8XZ8HWBb>Kx#
zAkeX>0=NQ6&GSFA%Ox!8$)iCHnX<Jw2gROATEq6S$stCr0LMp&tD1%76ky#sMYS!S
zgra0rJoIFRs}_g7;-mliAQm@zll;iC-)eAC!=%U0&7R~T`|fOLz^bE_39xBvIP&68
z!~A;as(Vn9y`1KL&hn~os4$1zm;1J&LOX?x3!Fjubn`@vO5vW>U73r{@EZAmpzKHN
zPT3T254=T!%6op^8Tefn8^y~Jdvw$CLHC1qIs<<i$v(B`|6VeMi_Sf5eW0w13?ja3
zd~+sx4&~SU)g4C4h=_e)hrJsQmFsT7J2l|EVcLIMK+;_+J^#IH7}x0DzP`BS*Y2=W
zTGegyCe*hY0<KDr4a4}$7~+BdvmRn~a&4o1b_3JMN+PRG@x0q49M+q~{K)Tph<b?x
z1fs)hS;5lZR9m;Fn6m@;b1tu?iUkpOtwC70?04Wwe=@mU)z?)Jo4uB@VaL{Dt#r%j
zoAfx(>{>GlO|@g1_4=u_-?CmYhLiKi@N#}*jNF_ia??=v<k?iSmL-Zhti<bUO?YI$
z;4zrhQru)srKBcnC}FeerafXBUzt(Pm))%m<lx=znC@TEYh5B}$4lIn*m3pOYP^1A
zYkc~WLZw(+w?wOQk$3I*#8s;0KJ(t9A-&DKyE-@$=pN~qM|+)o<B|CV1~-;9QyUO|
z<`yZLY70MZKtKlwq`KS5DU2*Z0>yl6#ttb7?)lUI`HghjN$x|4FcJ7E`~<eCDJf1*
zxXB{b{pG?FXbY1lAa$JDydSAal1gS`H`m+Hr|FXfAEl3r8oZuCG+c4^ybT%sCP~=G
zegyc9CW>oO7bSs2Bva=?jlR|VNtFe2PdoSgtR!>6c{U^}Gk!l+45Y?BgZO7|)lnU`
zfdJ`1v*ydQC2lC5j^{sw;^sF}Iki7PdFrebAtu6$SO3LBpa;g!-MuP}t?+a5V-pi2
z<HKj+xGzIY4*_xeiD))jOkQyTky0!vhBLOm3~cA`AFyV+Q|OeG<KSGWJIvAN3F5w<
zNMjq#j{8R{BRMSD7vu58aMN@HG2l`S0dVj`pJx$({vdshgHz1Cj~a`|bC*@s9lyNG
zbapu8Zn-!%K7~%*Ki}zVSW|8(u$C@!6RX>rezwJO`S#@43Sg7~&X-C6qNvUVJMDOG
z09z169{{$n+dAkQ%p0}6bzp!vWqFGgko4(U?zJTza=Wh)zVikvOyM@H_w_QdySke_
zcE9@q)!XO}(s=7;dswUvKj4;KHVK#~e4(lt9?sx~?TW2|2|QgRZ$J?&<E7&7zLpBy
zJL$p?^i7tURI;a=_uk)YF@h)0#VzJerwJd3veBDtEbZYUqc1pr_cr#ZIZn9FLO<*F
z)i^Dd%fgApQ?=|%Z&|8sdu@?KOev~%6o3+b<J<vHKKLMwF`HDz<vagpDIr8?Wp>H^
zRQVZjUIdLy_s9k0(fOEi)YH4skRE<Xj2IY(#IM*k+ZdxS4NKrqE`CM*fq2a)Ca798
zP=p4tyj;_sjZAx*)BBB7slp_FCiA61Nw?u=ye-q5-_WtjMs^GhjVWXrIVp9Ze@+tf
zktP}XJIzg%ldy@lsGzF)(3qJW>ppO5^aQpAU1p1(KLcFQwrpr+krq$*?36;4Zza&^
zQP9$;Fo#q70o~Qb;S1**ek@=~nrtzPq*j>!QXL#`>l0~Ihsr{l1Z?=Ap3)fA1hcsT
zE@6|^FAY;L?=`PQWXkg|Pt<K*{AHVKR8H%Pc6`mH!E_~50<Vr=_$|sMjL=yo-fDsy
z=Xj)Tm#<n>+~#{0Zo<Si7qD#K05FGxI>{XdjRk?W;D^J?QSE@WUq&D>iNlg*tKIjE
z7hvd=n`*52wH5Z{nW1zb8uNdLN%oaU@o-01_eQfx53guPmS9MU5++iTjoYM--LRyE
zPA13Llhl+HL8SalPqZ`>0W|U3%t8&%-1wzF4t^T`QI~4smik1&8L_U!1dqrRsVJ7M
z=DI!q7Sx7LM>PTN*aOKZvbKkDysJ$I6xBOy#EcEEs)iF@;H`hcHZQ3#e29VAE1j3O
zu!)I2cW)i*#i$~z_TmML6$pRneC4ipxX+B7`mZo3s$UEeP`la!2!R!OENgLfL%UP?
zbQVzrE&C$~T7!!@wc`b6Ot^`d^dubASog}G!ygtYr_9YEdv40j*h<E}pI=3leQ^w1
zmlA)xj}ue}=ewla6WbXd-u%ad+HgLdTnTNrjplOn;_dW924{fKuG@!do#XU;{zyS`
z*{yk|Fo%`OdX<nq>0tcU+~T*qojdiDo<fpq=k2i|UY@^TfE`>Fqf1CQy^c@Io{dB#
z>Y}st7pMZevtX{4b=Rn}T)9O@n1bJ+?J^a(I_wRwm%18d|H!bi;*NQ7hz+q__Xd_H
zxE`?vH?e8}iIiku5LD_7F5!Z{D$+-TG+*EQd}DvoBgX^rkw7mT;3@)E+Dd#k`Px`u
zaoB5jRq)#WzF@ipfDKXqH}Bu%vjzR{58^IDAzzvh(>fR%3ybMP$k+Lb-Hmtm_dmg)
zwFb(YfHAX?Sxo~l-lKvV-2wRl4fkEDxI;DZADJ>v>t7Z-dfaK%E%}c=pGrLZYL_k*
zf^P3oLNL7|1(PZZ)rX(Q3F2m&&bw%Opf}I?SQyV-W=C}`$3zfD8*!%!_1!;cWE9`f
z6XscKzzHAVQ2B%e<zzF*oXJN10*@Ip7fpc>|NNP6hp&74&%*fiK#cV@y(lld{6I*g
zOP(LYN|Cqju%|L;chaq$h5MHf#4>2dG1a-p*D<adeeZ!G3gTJzr!BZf^F(>XGY_t$
z3O6iFYR;-O?7~Z={CIM@8shUe8yU61E8s2NJLS}fFieO?Qovc~N}58Szi2Idg@tap
z4QSRKns+t`0-KExw(=gsi2uu#R;aoKO{JdCbW)BGPC}3`J&8F|{hzbsZsOw;`?AjF
zq#anuMgw`RrH<((HNRNwx7ghc7%L6h(``I+fVXA<<brDnzbp)Kw8eSNV=J`!zQ1+t
zNjLTr=!C?(QxIQqyfy6maKt5TZy$~^-!T!YqSj8(-rWG~Hlko`j4@Rk=%h%=ZO{Qa
zRm8UG#+n@+%3xQ_+2Ls{O=z0=W<$34mvg(2&I8E48N#l~8Vhm@&lN_w_KSQ2h{9%e
zWSneBjn$5}XeAPwpXRNEQ}0&fxhj~$rK(=4ixJr#Y2nRz>}8e2Q!Zgxqq*p9`C`j;
zKTD~T8ddn%a56U9w;+{sIH5j*c{lWfvHvG@+QPfzat4dfTpSvLWdz8CgIl?{^KKdb
zB9@^P8}BUW@_;yVs;~ul)*jngj2$HH0H+SQS|C}QaV$24cio_=;2&`IbWFMTn9me>
z0nO-woS3LgZHbOYo@&VrI&tSJRdwnDEX8}LAF;IXU2&SurQ4a+8r$H|mrO<~!Bm3n
zTOs*SiHHPnJ?h!%gS2RzAndtoMQY%9&d*&uD0I5<JzahNDV3?bn2`HRn`m*`eH#Ac
z*}!*ocz5?J=XEBps+!#>%y4DZE)DB|5dMxl4Ox{Uyyss!<*%ho-wF0NMW|UMTi|dw
z^pI&Lgc8X4ld@n1izfJd>oV7TE4Wu{JK}Oq#i~oS#VSw!A%+meELx@95(?AOPX-3X
z<8S1xWj@ss{a}GnEbx}7pRc>jaCfcm6aL_W!#&d;`1Aso9$UgQ!!Z~Vie|YlP}a~-
zxx(d@9J6Qdm5t%fJml4y0$=peVmnH@HP!(qii+u!C>x_VQ|=}ME+fhIuK0YJ{75W*
z?~!$9RelLogR98>6_UC!(K?2=>2|;WqZ`Lr{!G8odTXd(VaSD?dRaECk|@eU_iX;#
z-`1wjQ*O;qB{(V2HtuHO3QC$&*~ZFY#jM4(KQt=&3!Gx@kzyVKSgPDXe#B#KguL8t
z&Pq|dO2*SXG8KREr;qt^X@-1ThxR_;KV`{bF}e*G^ulslgu{$J52P0(_T{+v8?F+G
z-74}Mnu{v-u=5DwL4?r*-~wB2gOwy%_{nrOsunzUS&k~1Z&7iX-1N^rsU=8P(SIRL
z!xk#iLM`V3(1`+S>3#aZGPVrgMx$j6(tb4gK^0q48oo=RVeivW_iVWQ)_;bpVN^Px
zWKG#trLCwV70g!=&0(JE*<;QM(IYw?_y5|y{q5E1N2wHhzuA~GMCKfoi`gYvQ9mA_
zHD~owPFX{<$|&-NC5d6`R2(j_`b9&H+7+&B-&w5zBRC0U|2gv+sSI0?7QjPWi{Km6
zI~T>;-@P`;b}J*x_Lj<>WnXC@)OLGn-LvAXI?c<iTk)xu^G3NbS+d%<St+GO-Um~r
z{hoTuR8NZ%E$bJuTn3;st-gHu^=0kTFG($H_r6f^#}ksvHhZ`!r~~CoRl1KyY8z~)
zarHtRbewXvyun_tjMuEPXrgK0dN+dZx76MBb!{gFKRk6x=ZdDa-sf5*XVkdnR#v;n
z3v~@w&xzec%PErQ-P#NjQadMF8;m#gza05A&D)h5niX{|E1e%PN4y%C;913(dtH{)
z{vqgf*`t`b!ktxK!KLXHd&)LP<Vgn3CEkCA@1q4fmpOj)&?)0wC*`tzz!X;smpJ(J
zbY*Gw6nVMHEc$VOA(@Rja?vpQapRenmbWvd)qJCre!$_0Q?h4WbQN~pv~uoAEtL_(
z;YPuCOQG}IZH@Sp{`<jNq8(Axe!(ok=J`JW{d7YbZ*0r9l8?cSBA9&jyfF2PjJfnI
z-*ej{LdE;OI)Y0v;&GONUcIVObtX<T0$>D=iWhDMn{SyEY6J{l{6190rjF%--NaDJ
z{1gI2Wvi5=Kug&C$ktL*CouXEG6X2Fr5M%s!&7SZ<fV)xA-UI<s|ha*mOfin8Rw%g
zmm5s+46>@>q7^!h-*PD}%@j@4AG+Gfi-u7T05PGUGgCw#l|ZfcL(s<g0Vom}+TY!`
z`H5eoInYmG^I}Lh)pQN*)nJ(d1-Vd?Dk!xupd&%LJV6Hdip<a_a>B%y{pGq?m#Q>#
zvbRvp3Mx>-V7PH#T?h4>6_N<eOav%&LgIL0ePss<%4bXjgpR!NeLFBwNS&^NcuXb8
zZQ2C&3Jq$#Zlm(od2n<TJkK0UT$M#v?+=#pY^&cbt73DNpuyaSOHpa6?!<{i<PfdO
zX)cCe>jjs83WR>+F=+VU4-c9nCXCN=$<5nE`6G%K*hXsQ31L2A@sE+qTMlZhGSgM}
ziu5B}-enR*#J~*S)Kg+aEJCxskJE3B*G+mhxfbl7{Y(*!dQwItFWnRZ!^hR0tz*3)
zXZ(77wzqd1tv7VjO3irm78!yKH7EPSH0p48E*NN5kjgBVF%xNbGrXGNuoKi%D@;b1
zRe2{T#E)-D6{VaKb&+=4RM7Es3{i(Xig_v)I@-$&MDz4s42>pK>a+IAt>*(9ax0OO
z`(;Aks)q+Zuk0WatT+9BfwkG0D)QEIcFJCETbmJ+X4d%H;_YWxhiUypk2QCu`2=ul
zqatS`UYl={TqIc^`m4qM#zz6D;a=Qu)V0J;!%&De(#T$2yO}?)Kc@h}=8;EZp9mNF
z0Z^}SHED|KUF{~FIvO<=xGMP$l81?u(Vn~-!1T3(SQ(-Q<fSk~Hx7xDO-m%ZDJ;H(
zH^WGO)Bn4Tb0J`P|2(v(A%+^j@2BERlf|h`2ZPqJYuKPT4nSp|J#e|>w+z1c%>+0G
zE7_@JKd=-sT|Yf?sD>W24;ob&GV4__WjK>J;w$~{CZc<x4T0E5*f(wh!kUdi*KNxJ
zWQT3;t`D@5%BpxSSxV<0yH-_X4Gehh1Bi=%G&&IoBT;vbfWl<~A<1~14yk1&Y9TCr
zDDJdc7hX+Yjg@{ML7BVzAM4FzCksP4gK`rsi>d3mVQcs6wwH5vSi3H~>e=l5sa|QQ
zsJ*heE6%7$Pn9-y6OovY^*`VY{t{1wg;pmDHRcl<n;kA&y&}j{sKCV8LP@6S>!Nf?
zY@vnEoVQT-w8xKu9;6I!TIGPq;k4`eaf<VI*0`)<aj@LwOaKnFD6P~$@Z4ConoOs`
z=^IC3y2OZU-D#u`;7Bhbeb<HQ%6js$V6ST$TZ~W?Un!2c6vw_`E5OWsq<Bj^HF7DC
zHDb+`m0e+~H7mM<L?|i@)*+9;+*!1?|M1;ka;Epz8gzlm=@#%NBev+hBk{JY%3lRd
zQr7j@fI;zF!neNbP~Irp5OXmbeu`p%Io&f;)dq8E$n|>a{v~3=-THmX9PR#AGI4Sg
z0+dMN)aZ#3gxv^ck|1^XCj^g6e-fia_7_=QAi~MSr@$jpV5$Cr8|Ya`baBOSmxLhs
zU=kmpUl%FQqWZrUx74c?GfAqj+0oEjsraI0I<0~a>O#}tQX#Iel2|KMt%+h7=fw6P
z0F$MZT9_U*{(uo~_oL!K|J>Y0!C<lx?F==-UL_KHc)*%W8Y}U;_}btQxoc|jLJQ6D
zYLB&jeErh-hh=fTSeiLgNv2e0^%JdMJPMp#;F5nw9Bc$VeL_@C@;w`{OIh|kE%ogv
z3F%5hz5kE3U7@w04Wzi_9qG%rP-<%;rJIa0;ICO=-|XKpvWQPS9rMBv48mUA%BJ(?
z{=YBWS~q=jqY~yJ@u*%Sfor)S1P?(;OZCrUYk1-pS<WeOuiWgs_H}~&s}YwuA~k(K
zVS?e<Bc-wjUCmMSEZ|L{8Df}G3g5^5e6&I@h{Y;VMqmyRCqQ8szY!gP1yOcAqOELw
z|Jx^_AWfxTL9m{ez`sC%nEGW22<~2#=8_*$F_zNFf8Q(PGOQBtDi4}6GOwBF->;+M
zCyzwb-t&V8LPZxAWSGmWAS<8NMOA(moV138npw{QqDejjO}DLWxH*$cqRH%-OK2g%
zTBy^;Y|fnHqvFR)ol;}O6w!D_XlB3)GEQZjh+#!p87ZYPj(gk{s-&V`z_@v6Gh{@$
zP1`v9G>Cy%gsENyW5Ian799^wrBa?|6kC&BIsvdtVm9DZMu?YtCu@J^?4hqmA%>KR
z_cj-(T5(U?BL?#yFH*^)1{gW^Z}l7QKj+A_YjB*&cbZ9Lgfez$@Sk<h3V%3pvnsAU
zq5k~bqV)3ZED91p-vuf|OL`->=i-mScblzDJR&ZleWJg{moR+o_qn#G*^Rt2bTEeP
zps&4tJ4<p~f^&4tyUD*)d-}ZdPvWtpgAh$6P>Fe@p!R%i_LLfP)gE?dn~{TP2<QRX
zR{2Cz=%T?WNdZ@@YL$+<I#-YWiHhff7INJ&g1wo=0fF85kKNi$*?MuXlDE&uYBtLc
zJlp_1E`-9M<qgN7`lQQmUUl|?OV(JJEhD`T+3`E<F`f4sVfOqJy?)s1^K=J5FRU)5
zmZzaTsuk*3FWP=|JaH*S<Y|6C4blKD=c><$CMBLy!~19Z+t5pHJ*+<QFfF%y>XuJO
zKKYHY8@aC&oOplw8zbgIz6Qn<WGe|!f0}0#=&>vL<wx5oHjh2^k}c@_y7QGgAz|uJ
z;|-Facz@?HM{DfK1UHrL9S1q#UStk!udhK1a}8K*(Q%;SI&^>_x|Hlk+=uJVgWK%g
zcqoCZj#RSB!Ls3@<rpNNF1R{(od59*`=h2F#D)205R2dcB5`FuzTz6Ms-EN(=Hm^w
zc4I@bp!Fxds;d0r{wkub_I^?)TnPa_YardVkau+}*HB^c*}{yT{~6&v)%6NR4YlPK
zuD*Csmbf(GD-Zir#5H5iuGr@0j^yjpc^w3gWB4S(Z?F=K_T)=VSdRjWktxTpD@uT&
z!8TezA^{Vn=o7H-!mAVl=Jy8iPy#k8imNLfHJ0t2xHA$1Ew0bDqk31nck==rnt6B^
zXVBnF8b9XMkQ^U&d6O?k=HaHK^nwlDEagd%UgWD`Yt*wDZ;w3{Fy%^KqRj4s7S>AN
zC>9ec+L8r%MYCS*sf;OqL~s+hG2!(}haykwA{Ozexg$ur^k0<=l>1&268Gljxns8{
z@9V3uz2ws$zmR_@hcQuQ;W&@0#NFNKUU<2@I)=Aq(1t9AJ;x7Zw(K8;CKBjHbI&y0
z-Bs;Mg{nw9215R=fRfh{!|6&0HZcoum^^`U9G2jQ*ztrf7@UY%zXACD4Y@`PQUraV
z`a^tT_;_hJXLPJ+z&s`Ti{rO`XMVSK{)D(j@`%a14$f_E$g_1bqw@E+FF&Sn%c%mD
zK`YB=tHop0Cb4z<=oQ*Dv|JLcJ1U`5l70WP88Oon`^TFKQ<nJUo>sF=@}@f;iDp)v
z?-oEpG!W3x3<=!TCW*hEOb0~kyK8r=r1k%=VJwGy?T>iY6agz~W4qM;jvrwR$=hZx
zy?S~;YiqXa(7Xq0q<&T0(4^eSjdFKn`?>Pq93f(Oas1i|fj6S@L%GC^fdvB4sE>OS
zPQwq$-~4)lt9j_qp0C=GA_P^<?gyI_U5(TQ{i=hfB_|h=kzTLO2U<XRqSdm;ayKi3
z#z^N_@pD|;?<35SO#{d@CBtyf3byaqxMdRgyDp2XEw5_WqNVzoD_N0Z4POdZc(koW
z8q-3oTwlBbJR5M@c3;@idY9aN;LoU`oEF4o)>ZDA!d7G`%{}DixIG61MR9Aw0>6*p
zGA^m-q03f0*m&H8U_(bU=~UcZNt8@Ld`S`>7JMO+wedlW{JrGP<Vg2Il1|}d_bH5t
zj7pdLP}h1~nhDaIfnj%K`{JKM(M8>7ZO|SI)|MgP8Q8rZ2}Fwhj*MeYORW2Cz)X<n
z7EprBf8L9H(P|QDAK8_#>xmE-!ig=3yk#JydRkm*nb0F*U{-N)<a-h@Y<c}J8hcdo
zi9Q@Sv~39C0@iQN+Gh3tEgyXbm{EA?#AOD5>)C1*eO|rGMa2(q8xGZK%>=r{rOTPE
zj;S~9_|a&8ZR+r_lgur_US*y&(DGW#9&_8kMYTR^dkraETGsCzBfk&w`&yP;&xKUw
z?ilacJhv<gVzOz0G<6Zir<F!vRTx`?+p;RzSuMAM_$xZxlf!uf+Vwz(EfJ22JHE?h
z(__sIo50)|Cr7XSyyAZMZER!XoqlNsG+k{JW9-r3asSA@Y_e0V>khPE4pCbmclPIF
z*HHdA24Jzjm?fb~zMPK3bNUkcJnW^kFGN3)u;INjOE#}Aj%Ql~C7PWB2#Jp<>ZD!2
zG7hh$R%T2wCjVpSz9v*;G^3C5avG&Q{1NhWw(w_e8)CfOdO-TtoY#73@!IY7ef+(h
z1w&m2Jz-o-LlI-1qW8hH-$qeB$uow^>zn9e8R}6uFF=P>^~xQs|G)^zt~{4(B%hSf
zMdhwbWr+eF01%Th=B1Z4c$ULMMK+#E`q?OoFk=AIs=wqpBz;Lg@@KzK!dCNT6u+;X
zjICxl7+Jler)yc>RDfeyA^qtt2+&Wb9S*uoUumDL&g&W(>2a4TEA90yj+@Biw_saj
zQb{A;UrX%?A)+3#FdGJUQ5La1XKYH;j@sMj%4FXRZytrq6YAE+Y5wBpV_RPb>)N`7
zgWmT3HN?xcvoGA-Fm;7Wo}6T@_Xs!U&mBCJ)fFm8&JM2?n)tvqOi;N0(syng(+jfA
zXLO}tTCQBlo0zW`%#g_Ha0N*!fUuZnT0E|ntkF`eh5pv4{B)C+i-`C7iIQF0k~3xE
z!LTxQOxGJGPPh8bAvrlWadA@+qZ&;nWC)@t0Q@iJ0L@@G+Aqwp>;p6%_NH$Ce%<9p
zuk6FG!w0kB4jSM27*GOZ?sHZ<!wRW=C97Fo>R7{{dBRmg)cVWb#t=Jo1neLgCtU=%
z`*|t_2&Dx{pCPR*%bYeW2um8fA~C&m8ee=P?J0hkK@@kD`VBXV_FXCN1vX7A<17<a
zAyEotv)rk<>q68h@p7h%hck+RyGn1<13$QbC6@!QJFB{JdHBpX;YAYt#GK>6Ab+lH
zQ#{~r6r5hBmmXf0GS_HyW(|VBdC?)5kEk)^Iu8yFqW(`sYtks8GHqT3<AhEoVQb02
znODI1?dZkBXbo*^G>MAqyegUU-?%0cJ=G1;Ttz{rmYecR?wq0?&MZVG@x7#?YPZ59
zDJ}{%J#b$`*A$w)amOPi70}qgon~P-amG{}TirVK_j)v!b)o2$t#p`1ToeAZ`;~sy
z%6`}TOHKrC-8lqdPk&z$V!;Q=u(Uq=gb0*}?G?>GB89ucLb>%=lzlWyVN8UC&YWM%
z8N1M|uexVYbJ@6U>m;&PXyy4=JLh^;%TsMSz2<HJPG8D)6`?Pe+grsk{VVvDIV}4;
ze@|>x+O?Hu7}H?hx^AZD{1;rxY%JkY%~^<eM0Y?@(HI??b(u*(U%Mv|r+{f=?TkgR
ziiu4JQY^cE;p#PZ<oaW(vqiaS16zTn1|C&ayPL)8E68R21hGn%v=^(e1Ual-KI*7k
z7TZ6L0tGSpXN??HPK<uL;`#;XET1%sfI=I=?B}#iGk{m>yt{b*4oE-0)h_VZIY^+t
z`F(TrJVbKdv8w%~Hw($gi~%idCv{(*(i907TmrrCXUw(ieh)%>xB|2nm7Ki`6Oh-Y
zKtzeuF3PnaC>VlQ4kGxpnOzL8$9sDUJS)JqryyD&(h{QUM}%1`SnB|md<;CZja~)k
z6x+R<iL#^jKy`P)bqn1!chyF3fHB3#^oA3rH{u2<!K*2#XmN_lUcQm3*Rs=`$_0pL
z_t`tm#`+^Uy%on{ncNZ_(VGPry*~gojG+dd;h%_f;0}gBzUK>A&p>QAE@bHi;cZ}i
zf)YkynUT{!=IBa2^_NK;CGwRtsf<P2zC$DTe2j%M+Gx+t_Bn#O!24A3_5mfT`8;Fu
z_c_^T+CJXePJPsl1Up}%dY1ypXpvNRT2u1&$VWvg&lV6gYKKDoE}ZGHFNmKgj%hwL
zPd6E6%>Pt_lPb(GU2AtcGE+PWjDkr$qaI*P43XMN<K>NIneV8o0l*r$M9whi>OfF)
z;SNuSm>Q!b02o!d0cyk6i0DC@fIM;vfRLsf<@YQ&KibD>`Q2%cNnBt_?@A!xQM_Lb
z;7GkPB(g8lzFbG-2M{Ajil}`J4;RCW4j(Imn>HY%$y8CX_(9!Hg@OTS!Ghm|EG{o^
zvRW>v$3r0YlU=qF5!B_NuYgr8CJ}&*1yG^^n7Z_UDUgZT&{w`VbahSSfK$#C83G|s
zWzYvAUqvT};?oB7Dv*|*PP3t?h@VhJB@jKXlORju)_U@j$=SkH%7_2|wG?l#Dp89l
z1j2yLV+e>}y2^j}=*5eY7(lCPsAGAV^52aylt8i_fAX!fsl=2)F=j@6EzIn(_pbfU
zSvunv>ld(awE(*k73R0a^H{yXJg+c6&YHUO)n`m}hCXyrWXTJYXsaIVsVS%n#nmL^
z400ta+cCqNmg5^|CbyDG+O1YJ8<0FR&kR0OabM5MCRfrl!(MtV&2Co#`UV5zI_t!p
z8PV3upf5l-luIgu+xHd=&ocBzgE2gGr#3gxM(q*6C}}Q})0w7m0n6#_V*qw~d3#rk
zdm;)ZK?(wvhfWG=1R$iOSa-C^w7$!(31HUkjvjHfm65WALgi4gi=i<4Sa-BIpk4V@
zym0$QXWJn{*mCm$0*&52{XNPGAPN3AB6VjMI1vDpvoZ_^GdrtAc}UPc&l?`YfC3(m
zq{AC3ZUY=RwbYH)IA6W&T;~EHq?+}6$K``Xd$d+>ep}~^WpWGd*5rtfb$1*Ny`iAI
z&|})Vg1dKPOjzgqew&XO>n)h1>bbX(S$jJfw6FU%Cs-s_bZbjN6(uFre%8e-b-wg7
zV6@W9XpvV?rw0eOGhFZ({m0&UV{f7dJ7yfyy=L)3s^y)I{6imcoyYT;kFg-ycpt90
zJ8#qmyQ#iBH{S|f`^-1qaq8M$#;I>s0Y9#$ju<~$SWOd;TN-xv_bj4Xo$tt74!1C`
z%La2mR~fFszFcSU<6h%t01IQw!cK`@n#1U(qJ6wux0`xr76!s*rvu>rlXjIkgK>j7
z5uXQbn>4#+>9zUt@=Dpf+Jn&1dtH(C2*tTD7xbRYIo7&@CK(iJ7S%Y1b0)7KU=Xi=
zIaWLhJ*QvvoWfK-8aB_94?R~~N4mJ?>bDiYJAVG`jTbJWqHF$r@ah`i*cUf<jZo!W
zt|qq-^s8b+B`&8L(Y0yfMHk)Bby!qaU(y%E1ZzxzIq)!5NKV9Dh?<~N<l2A!xjhG<
zP8KXb;g+}5nzwFIP#q@$r7PwN7r2qsQiM5(5uu-Q!%-~sH%r#{GhE>!#uiPQBbMP2
z$U($R3b{@j7${VQJ4!a{hdqWNVAeqk_83Eb1eshxZn*)7*(#BL+r7OH)-9}4Fs7Xj
z@ha<PYunK1P+QwIL5&Jw`tH~<VuWq1^G@H`3M}T%lUxJ=fF(8PWnS^yXxpTePi5uk
zMa_j`G-BdKhZ7^^l%>bcF4?XDcO9@8yJPBa3>eB6SuE5NdgJ3+j0FjVcqAVKRa4Ix
zaz+veEB2Y!%J=+HIR<1<m#$AcRsx<}>;J`F`i6k`>x;L};w$6{i!yN`IiwkC69?NZ
zTA3i<cXaf(pU=6!)f;#F^=WHvXR9;vzgTZ*?`YGnDQF`NY#GfV)TsR8Mn{K<C3!h5
zhATP^kg<FT0g<AH0&R!z#d)~~1BVzcXNb>Ug6nGcq3&mAu6W(xT|VibU5Q@A;2`}Z
zI~=rU6}nK1(UYNu1MP-L*ilGZ0ey3Jx0bJ3Lk)culWQ?)yV%8;_L8hx701XANFN?l
zZ7NdcKvIwqJt~g~VHb4AVHfx7>6Kt~|0G+=0SW=8egD-*$Cp1iB%c4#`ELSgK-I5K
zom+2}kHj@vr;2;5xs$j-eLO?Xc*TAdH2SXUK;e<-CO4@lqS-P{EVZ;^L;<brT<1P)
zKhL(8wihH}^Ol{lY~Ko&GaY4;oHnutAy^iSD2E2pYV<s4eCy9f+)HeGfxUD;7Ec~t
zH`HSE<PxDS5K%_60N~-{vLs0h0*xyrgT@M1U{R+3ouU1(G_sZHJc46H8rwIL9h+25
zj;Kb8b0WiLz#HRcZ;4Lf+o4@<XVK144Bzbe@mxpgs(C~?JH9d97b9m_o%%!N_C1&W
zH{6Opg+W_-<)yz*zvEgT-)$qZsA<vnMI*}#Df;JeppOjwmD*)p(FHc=wDRzrc9&K|
zfsNusQN1h{09pfz6fkm9*mpe^Fd7-7=USHe8kX73uvgN{1cq4ZIRwJem=qvT4<bf`
z77|WwN<IeH9kU3yz)^WO4s2($GZ!5hZ{Freru)LhM2X&UvO4!MHtDFB$S<5{p(V5g
z3(f1-CSNYaa3r!WoR@2fq$Pj;c;>Cb)l%35LXTZVG<96qSKur(q9wqSFnYBJ#xDQl
z+`xhgf3{J;UJJTqse@^uBsQGrA5!UPQbu#Q9T(F8pX5auY4$*4F~51DQhP4Jv&X#J
zhmoG^ynFkI5wm*SHKWG%%>7(qh8*t}yAP|uG<t}njWkl--T=-^IwKA`n*$hSIN4}E
z9UnTs-lNlNVylgSr(?9^=NH<jv3mtXxpWf4!OV`|soLZ$;vNqvD-(g(B|QK1p`oHt
z13*GKK<w9i+^}KWggGy$-@b0mGwkY;06-Bgi8|RiJ|uu7H1;FIazs}R`^O3p95J==
zxY;#WG)WTuosixM3C^OL|HefheV=V~JHWAtcVz}E?9KDbcpUZMeC#`6x5>*W5*z}T
z{*RLd+FNO?!&{9Z8Kta_ivjw0&&jY;&{L4H3|lAkiIuT@6Bv|lKyZ6QiZS(tg<!z`
zSU(o6T2$dj-OM0U*%^2a%+2or3Ajx(g;WBrmx#EzL@BLv%Jd4?MY5u`=`lKEnn;8e
z>75rl1Nk)}9%p(WNl&|s;tRJX@~tT%qg(OLv7Bjh5Eh;ac}i?EN&#q}W~T<%)QHH&
z03ud#F2ePR?=bGl>D3v`jg`3@88gmlHhT~@dA;^Pb2c$-jZfG<v>aI@&Nqb8=U)hd
zbBKA6t@`ufZuU9wZv7oTH}Cdw6Ut7AyInBD)outG%|4SL!9-#qu=R|<^QcWIW;w~F
z8=?{)CIH14%uvxyE2Cq$XN2+)1F?3FW_`E3?6C_rdtf%)KHz0xd~ICyu(k(o4~G=b
zh6Wa&=`xWCY=Y1#pnM9KISECkf$$*MSJO~rGAv*v0$v37?Wvpzps)?GLOdU0OrnY|
z5(v1e4_`L1tU`K|r99K9KeGyIXk<+AoE<W&F^UUvt!C%-j!kKSQ6Fuvzf&I#WR43I
zIPW!AAjTUqijaG{H9<o2VFTUYKXA1q5^@?$sW*8Qo0dbjwSiffUZB1nm<}89Wa8|Q
z<?oC?*3&Q7d~pkV39;Op|3~<M%ZTWY{6m(QXG#_h3S=#d{tN@%7?iPSV8|KT@`Ya3
zHd?F1CM0K^16NR|RD<Si^w>g0Ev73Z-PMw|mld|{W%0Wz%dc%=Tn?6ZOjaT&ac9c4
zHVy367+KEH%iW-XqwI=uqYF5~nur0|c9wgW$!-}I!-@6p3I$gv2rUb>t&N1f6sX?v
zu@V!+X_3<V7iPaQJuVASU-*9~#G$@*Rok{zE$)uAWvG|vY<Wrp{NVWU;?gai4V6vC
z0$`FtnHZbvwX6(`dO5R?wb;56y5<3e%TnIH8Am8I82H)aXta42(>2dfl61T{HYS0|
z#wU~aEjcpQZaG-iuK9btKlz*2EP#hKNu}lr119wh^7Bj1^I7z5Wbqc>u@2mZHNbLn
zI8r9>E1LHC^+cAVIy`Vmyf=@6qvY)sUjle;MX`E$w+}Mz^oF)1m2FDuDZX!<wh&45
zXd)z3<i?1bfyf4pPPcaL2#iu|mXFPW_9CP?#rP8!s{;r|r6j$u!!CeF_PJEBOiO~`
zW~=tO589L~tfr5JY%KGHNos<-`#?z==#qE<p+J%}hv6|S$La6Dcp%WJyx+J44EZz3
z>DbU5U;XaBUYktQYqdD8tZ1$73KH=OO5ym?<zZ2ImMTu0OPFy4S;Y~#NrS+W=x*Kt
zO2PQzmG{GN^jaKoifJT!MSkyN7+Ba_+5fqQG01S|S2x0+3u_cLyLM>{ii?*UBU@V)
zaiC0&NN~$@9EqG^P^%g8^|sJY0vzqA<BT%^ql7WeId{6tb!-0M28^8ijJCRUf?|Xn
zK96WQeY(q>A7k;{Giv>o;D|Weq5P`=#l}n-^hp8i!wM@<R&xQhk>RQWup+xJ7XSkZ
zaj4CWLzPSrRCeThR^y+BU$teb8vheY%dgf&+YXlkRtFws%Oi|505A?DW`!;!oanor
zJLWb~MRb-eYqcxAd`_rW0?bjvuQ72bjetPP0yP7C6o*vOfV)-aPRB>%#E;#xf`L1r
z{(<3OoN>u<IA=|&*2{k75KqLpAXDOSMBLgXj~^TG2tc|xBlB}zJSsOg<bQs>MS)2I
z+skBbYi!BtEn&*v^><!oHf85p;=3etJtGO8C-(4Z`u<KkkM8x~JBqXg`We;pfyULw
z`l|uU#_bx=tRz)-nOa8Uy7gg;fX<LgJBedCZ#yWyh#MBO3dbk&-PMpFX|oD#tYv}R
zX8qjBH*Y4n{ZP7JpkCQ)GAbJpz-YhN+dIq{Ygdu6wMutfp%GbJ+)=mFnZ?^%TacS+
z8|q7agwh>#zcEZfDw|eDcYOKOl{8uUQ*`fO)FrR7!(TtINZC@LNc<hx6b_NP)iJMJ
zcByj#5E9<6U_y|2mFOHnf8rw7TUH?B@fjpyPG_%v9ad*|)Qcha=gJG@US5k5&>u*X
zGABl7PX>{Y<IgkeMDhwEN+iiUdlW#<BP0TA7+nS#Z<+->Sp`o9Whtr15m>pAxELQw
zcF}Pedh4JtnTQLg)sLstS$Hq@N6?F(M7TEa=dpk?l{dc>fu*bwi>0Pzj+v2hm7Iyp
zNVpQIFu=iZ_=%h&PkGHIThB^5R`#8r1zvu8@Xb5SSOCAjp9EFkzc_%u?w&zud6>>m
z*Le)F-(b1HD(x>rcpHHv#jaQCo0n}LbWTFWV}rDtU){yzEvFPO&%-=07!}6|O(@R0
zSq#$(OddVvTkqtY0QX&&en?r=+6#FCOT<iK2$-X=V3QbING72OJvfAYfL%L?#upfR
zVGm%1AO;+8xibk)PDeS#xGb79d|T$3`tgm{el?*r_nh0tet{e3Po5U+8Ed&Vj}yHr
zCs*G6Nv*91!AmNP6=*j*Omn{OEq30T0K|$Xku!FhXFb_av%<>}BWF0$)~Bb3chwnZ
z@5Oi<rI0dhpOE8zDY%(GJJ2C~(d*}c_+-VOVY;n$wItPB1eut73j9b9NN{5%z12|{
zeRIi*Bb7y-nY*laLU-s7@N$Op@MtZ~H$IishARh2Ov<XpdinDQ4<`lNw*{xEq$+j-
z8=oRpEA)6EIoBJ}rAszM%%<5qe1^OQJ0#Fb+0eUZl^&X!BQ<^YKuto0v$y$D&zEV4
z`A7LJkehbyt4A$ZiWD_<3RJ`?Aw$&r{0_?c4yE^*NTHtz2}S?`=YqNw@tMa8ec1at
zNPD4I87n^ML2?dFf6YCHPa3netnvOQE@0OFi@?wKl<n~XuhBQBZLH$r5hV4Pt<f^k
zO{m9j?$xg4&l(&Y{+NHV%_pqXTfBO<^T;E=rrQMV`|3j#`?i+FmnKto?{LWgAX7)N
zrDHQz$_;5ETtct8fO?3!v;>PkXBfLnD6#>!=j@Gi!UXh6jv4@*mFQq0It#J8eD(th
zquE6{8Ni>M9NVX`(x&8E!r4y}ssBNtlH;<=DJfmn(8ryJ|NcF;m1VgsMcrkM#2=SH
zp?}f0?c8^0^$)*|ZX6p6;Gd)b`Uu<kDi+8FQz(OGhZU5`U|a|sU@Y2`5@!zwE~DPu
z?v71TO5%jDh#-iJ*cf*)nfpo0Mr|Nq)CX!y0zZ_d)}X0Ac2=*D$B_a5H7s&!;DNNC
zMQj1jBxvbbw(;yAarRf2b}6M6bW)S-d{DL&>J)&X%FW`|uX9Ta+>dMk-UmY;@QMe9
ztKOb>fDd9Wtf>DHTwp>KBr9rSMbYxK@ESJ5_oysGaFwJ?2@^l^#y5TQ;hCJ?hEQN+
zdXTja5c3e&3gU5s<{PWC$(6l+ee40FC5;Q;eVh%*IrQy6aX>96b>~k}lMl=TSarUE
zER=-s_ekt-TiuS82Zek|e|W@ZbZ;^M0|o{8^;g%fsa{=W4Tr=$vyrxj1muspzln)M
zaUz695+-ZnuRddJ)>ex+PBH~vp&=T6)bKDAvWP5+3$wrL>^?KP5_bRNju@x;ee#xK
z*NsG@Tlyr4ZN^c_EY)}=FC_HWE5?Vb-zdUI*RX&vM6+q}PkZBPi>gE4Gz4Y;&~su;
zu6_99w`fsulGe28xLtW@31a!Z=KK}YhVGi%b<1^ACWN)qhbZsu;=|+cgtt!cnA-UJ
z$r|mdJm3!0|DHy2N4+B45Z+LU63z2PbW4<Kjz;YSnXN1i;~JGx5k(*%zc}1<QRtJ@
zDfx~9nKuLNAx~7+*DGCVI^)OX!Rk{k74fl4YG^=uCCBP4)v7<ZKtcy}O9wF({pq{Q
z&iHgy=d8nTi?lU;X9=0Cm9GQ|MyGq;kI61DUq2sld9A7euD{W>ZyM{{eD2jxGO}$T
z5Ch$5g0#NJEY<{T5J8o|`m;%0+TUr~OAP=W%uov!J%=;w8?;@Xp^ySAe-}&9H*3$(
z$5?-VlAHJm*DM2wunFS8dg1`TRx2^7K+8>+M>v2?O+}g&6LxV_DZk!d5CjN=0{j+M
ztk~XoWc8&>)8j`R!j6y2S&uYsPs>uNaK8}#G(dmbtcIgR0+}Q!If@FRx~AQ(nV?Tx
zTYK+J(tMZeOOKde*Nqr$QoBdea?R0Mh1Jz|7E8*KX$|K2M>P&dQKkmerS$fSq&zFs
z(Bfuev)tuz!taF#*BT96LwUR9JTr85QcYC_a@S%<u2^kZpkrkI^Wv3jse{+Ftd;l?
z>_J+1867UF@qy|GB;9d9h205AGKGF-35U}~WwfIMSUkd_OGwV)wpK1ryyb9Ky98e4
zU4gvx$L5ny(+ZkY7j@ySs{LeivQ1sgm~RvshO#q(>LDyhERF&&$9_A-9%^8(x>?l)
z=w`eo$<@`XZq)g%WuN^<@&<}p7RlR44{9r&qehMK8)A}eqH*V%`c0?!$>p-f)Q(TB
zL1><iwfZhtzP&Ht{LV`=5QKr@YB$vd_bh3;X3U|A+uj)+L6=At9}u;rBCrOwmG_ws
znorbQ>ZZEI^$g(*hvV-~^>&I~`V^3$^-Q+s>b!&&G%h;VT>yGEk1yn=YmNrhTj}^{
zZ0a)@b}zPVWKLr=4_-~JwP@RzK}c)?ncY?Cp;;5!wQB(a&I?Q4fTvaJr=?gYrre#!
z;miav<f#&+q3ya_{#o<!3=<>2&JmeS;RhCn5hLi)JznibRl{mZdKy`E!A&g^2I|8!
zLu+&9LbH;padZx&1xzI5;C(X<!;R$JFK&Sut&z4N`ep!&*75b$$F1{AR_<I5x)APx
znP@L>T9B8)o(qVGSzvS|Tb6u4tG0v%G$=T#;8a{rRd`Myo7P|-Z{I-3<E;tTCfKCd
z($oPBVcU)#RE5%o3x~8b%ws!^q%<1^&^N<baKCpLFoz(DZOW)`u^S5uAtNCXOJZW6
zA_>mjJqxsB7mFe5B0DSmLFw)eysvw?_vQDyFs8DSLnjhgs%VJ2ugYsU?)9RP-sRO@
zoJwfsODGju{<4{u`DDVTa{2AD49)dqVlrzY_m+vU@I`lto*4s{!q`9H#lY}0Xc#@4
z4wzsZL?HX-8Gt0Ik&&(RTm*uZ2{d!jVBs~G6??XKb=5pzhXcVOtQGK{0nwal*D6F8
zs)K2~N`s3l{ibdL^_*iff%rc)z|8}@(&XjE&|cN~O8ZxqUkNUO52__D0&zqvSIMtT
zVRjwU-k%fV(_^_#1Q$UVXLT9;QgF9U+RvsZ>4+^e5gp%t#&aF>S{X3UVpf(+siDc1
zNZF|{Zd$1nVQdy%#geD6(9?}h!pJx9mWKE%R2kKQ(4r!AmUjI~!!fa~4O(It%E8ZX
zt0{0pFgE#a#Ue=~d;V??`txSVpphSqE%C|n5pkPbxE3r%|5#6V&pHb})4P7+)^kPC
z&Wbg^UzG_#0gx%tIO4GQjN$Uu>wC7u_|TK^07F2$zh`~3*l|EySlF}Qi7FE&67&iM
z#a{Biz}^GpH|K+_IyW6zHXq|)7Ekpav^OIK>61NP+mQqFs5GOhb`of>Qa8V`|JWdK
zoUnATSJ*UC9n}=4=q1zWgIS&in>)9vN&3z$U8?{7T^G?{eaZEyNtC17#EF|x!gaJ)
z8u>X+T9%sMQD4^Xk%PjRF^^M0wXv`4V(j<^<S@USL<h4tBXhicbO+@x!YD`*0%JSH
z25L@Zx+u-q=gS)rvo#ebu+s-45DD5)0Vh-7D%$3rWt=8Tcg`XAMB6!Ar%`asRo={B
zZ#*wPuts$$!a9j&BZX8*K>L}KT>%Kx&l?Sh)ef}%DC^6kqQ1r6-T_RGga@z;2varE
zl06!G00@8q90Rzwbuc#3VV+%ZE~QiV7gVu`L6P|^D}Eqtf3i8z6?CTJO?Z0}J+hqo
z7CB`R&n2XpVA^4wIKx4AFYm_Xlf}ap_TJOVzGwtp{ZlH-o;>XmHSI3>jP7ohAfktq
z!bAkj^=5cW%AKU8Wo9s}Od12ABkyk>vMt(TGuvYx_;h<m4rJ|oH#OYEdR;MkXrcnH
zv=Bn&*20Cdq(ENvNXou*236b@hYz=Qr{or)R4!f>Iq_)*;K=XaOqWNK+3MroKED6|
z4F5Too4a@L>ZM)%_4I;G{q^d38MtOG5e7OuGd()u9n_9suwQFbO@hKJ#ine3zON=G
z&FMU5)4w6*LGw0c+>~HNjohzAD$<Zrj5^ZI6n_8EzyPh?j5yr>@1)~7Imt6?mYjaX
zMk|2qWFH_$6NlEk4CD^{ow}+<L^Sw}^l`_{v{>eJjz;A<=D4D3{)%?GUCqIT>ds4t
zWHwgco>sx0E07on9wlTMV0`%!`7=aXRFdME5SXEVNtWc9J*(rSNxV1CHLjOMs~B7_
ze0>WPOb!EJ@<>^}x;g5(AK-`x=H>l57r4?GXHS%CCmru-|3amDL1}@}+n7{<L5!iz
zTT9Bz%T{<=u4EAGT>2R_eblWTjV3OwJ8q#3T&I4MFeC<sKtH;9<lw;rHy;61k*fIk
zZ5M_dlCAhe3nXxM;N$n}M<08XVf#5H9(-bJKH3U&`f@5Ao*<93c8(1ERMO{FA#`Ot
z+zRuRn2hhi4$0GDdC_<y8PWVz()l$Gvy2B>HU?`<6*R)21X1f#c4^loE&3i!VGj;=
z*j5Rwt1W?OFvmua6C=q8?una~$L$W4$N;kg$b`_sxXjV`qlij03u2T2V&g8h82_N!
z-AR(59E#n}`_eV~8h+fkg4|j&>W8YxXbl+c;(hVh7&9bEotWY|bhO?d-e0p2N<6av
z-Id-0lF)^rt{r+T#}ysk(~;rMrFIJkB)wPO%}b6Pva8!ab|2Rm`M9MWT~}H=b?eKW
z9V<@-t3Rc8kbGa_Dz&D^#<FSD&W5vEUolI3U**E?JTd18<*Zb4q-sS27Ucu!iTO*`
z=5CKO1?OowteTD?SF3IUYo1dE&OWXqf_^?{`4Z-*Cq7N9I%*lI)k{->A?zFW1daCA
zED~`{0y|WHw;syF%Y96JV`J&ou2RW;GI-O3NoY;{a@T8}v2x7`iRYxprJBM()gEnM
z<Y~9#Dt+Ic5zq_w2*^TvnR;%FB2>F>pgNUNzp10%=h;VBU&$#R=x5vTXtS(BYtDY3
z1jMA^G0oFG=Jng&`JaR1eMUY13^qd~2!dA8YgZ|yt^*!Pjvo18!Czw8UKPavR0^J0
z8`Z%$7BhYRJGS!S2jA~A<I1uG65pHuLfSyfroMx{X6LV6le_)4PJzx1B=>;H%^*q2
zA}I^S)bVm74xsT`bemGl{ww_+I|~w(Ve0FVqzsfY=?l9r6a+o>byp_&i$4eVqZ}&_
zQ=7s(3(CrcMI+n005~)Dtd>mzjW-5_FTq>oyt);e{=q~3pOWweX<X3b@cV;seyd@G
zXOd&4RmTBw2a5IQ;bYwxW;`;YgMXr7<mUqfex1h-|6oMTb*$W<cz&+4l^Fh=(ei({
z_i{pBVD%WzZ1o?vrko%pU(aOqk6V~L`}<Wwbw@0PLj3{&#gBL8Mo>Z~+oO_eKertX
zjnZqlfgf5L10}y9LwFVpWKAx_ER>yy_n2b8_&zLd3(ZBqUO9VIx@3Esroj-G5hfEJ
zz7yu`j9ervQW55{*&<%stVt5YcELlFO7?l9p*9`hL_W;?gX;15|I6vIG`hy`oM`az
z*#D}$A29y49_W&pF5n;UvEH3NmB=z(*MAcKAOe53A7UP%WYl_UzYM_3AwJGzn3?FI
z+2h}03H5ITvs(2eHa&}EUq}i6aJvjI?iD4i$^-H4-mBZ<fmya)z<J0IC^t`I62gb!
ztu0TSFj3+?F!PSYeHHeF`Vcb+Z=nU0=`10Qy&`!rNYJt-8Q?Q8<A{|1F*S&YW6SK(
zSN6DiP{%8VE#b1qJJQ2_5rUNkw#;6p49<5hzs~%Khp73E_HYAg7);NZ$O&UZ1W*hf
zYGVXjoanrDf}I8RiV4p`W}mf0n9G1_*a;B=v?sv8Fb*VbgZym)L`LS7;@T7*)n-|$
z4Nf!VS>=Ga)iW^Ady?8W3htN?6e%VykcxCja~@4Z?LCsMWWBP;G(vb1m3VV=7~#^$
zFN?hmYykN>3XZz5;IjF^QVz}oEk@?I{9{H~E7}rf!e-OLZ2@qPY=8U8sCoQ!Gwyg>
zJZrh<@DtHfMYQvR(H(+H*xO7=zw7-mL4qg;%5HzUabpLGo?F;|5@Bw`HXc_<Bi!%e
zqiMp9H|rJ>qI0`7vycDb{NZkZtB~YPxO~~_DQP7(!XkB96yaDQO~Es~s--iPly}7k
zMjlHZ`<MS&H@#rdK*>;+@WC)f-|pWC`;#*=sAHO<Kt1a&#Br%XB+ffrC<>0exrBx=
z5A8re!#+Sf`gxkVL4W@hohE=z8B}X>&G$%?Yn5ppKg%49<?a$RlAhp;3m}fB;90dR
zq^077%tm8>%Ni>(U5;ijd)3e{<BT-sej-VSRac7vvbcGM%t%D?$#BekOrZMggxh8Y
zmx`q;^6IDHq4RoO8FDn;y~c`XX*^$>kFEfu3YlQx>eU57z!T2@oBg%8B``6Y*1m%u
zIo4K!h09lVSo$65>pgVzrRus10^dspJ~G@U4R{Q4I)7n(ij)owhD&Sfq={FrnDq@x
zxw6lzua(KJUmej~i2$`iH#R#vAv>}K`8O}TSMKO+^GB@pofTk@+bZukHM65Mzt6y&
zxdv3NNs&pa<^n@Oz<Lr(NAH&rP?63D7u(TsTh3twFYkWcVhbQ9O_z3ySxEnP;eK=4
zj8=LckG!{|v5>06-;f#yrmmC{+ad<LqJ+sZ^IBv;>M98;7?RQ5R-UU-JNr}j4pmWG
zgoK#6&^W-~uW(&rLib=(gp?q?*n!d;_PRpq-qza$#CfgsiNbupKiKoYp)E8#)h)+A
zoAU&p4Hdn5?xy?ayz02`N~^JyXbUdvcCc`a^F&Dq2Y!B|Vm*=SrOVq&CsdtCy7-BB
z%n2gXQcQ*>I*8MtK<hg0Ojyd%g}y3FimxMHBj6}~WA)Qk0fG8WTJxC%ck(17ss#W{
zD?Houb=o<gOol2pY^dnW&c+Yxmz1raxc_isMOj%|`j{pD65eV!DI-CUS1`CbFQ3oH
zw;6m0m&s(H^rK3(7UwEwVta;%Ke&f@OEbs2*zodlY0@>7DmxP}^c+zTU4JsH{V>gO
z>?`i>BFLnbPLotWM+F~8oE#WZV-!-wE--R9SD@CKnvzLPQx}PmZ&$o9W&-^?Rs0V9
zN^dHth8?cov9PCBvA$~6fyM>mqEtx%l^Uf)yE1p0fH@{ZHF%nf2Lvy}>&CHQsW2&{
zB9P35NXPPIwuBIwoItgDXXJE=9^#+qR*@VP!%dg6!|CCYV1|>a)+1vj#cvlDiH*$1
zS!KE?yU-t)5?De@23Y*g=7N!oQ%z1HN6K9yb*(Ax0szQ`J|W##5UNf%*r9E2hKuGA
zsi-3J)rKLMS`S;^PMOh^!-%gkrM`k5Lvu~?qtg5zB6mC)B#rI3@4LBWS)@`yPS$4{
zJ6L4LA&AHgWny$MzyEC&7E{2oLXd58A&;5d=e~lotEbocfjo?We)%0EQp|AyV8%>d
z3XPdGjwQ4qIniOza@aMOn;3V4{jylUtCbie66~>ZK-Ad?trla1$vFz=^6}qM&IV-l
zsK_`K+lPp9gDbeUlj)G_5P9Sk13t70O^CwiIbYPM&7(drO!%lWOf}*Jxd<Du+#B?Z
z=D8HGir7Qz=LJ^_$vh7}r5YEqTzJg1DJr-55>zE#404ePmOF=v5mKy0+GKO3%d^FX
zVXfO8J>oG<+Myw5PSh#_fOqnOmsdgF5cuD5LW(nu2{Yr|Y2-hzEOao_)luJ+DS7H(
zC*2i^rZZeGp3hcU68kW12GGy!%6cyddL6J4(|+Pa7bX-M4jU15b`r3;!1g|LP6KNq
znhjEG5T==c-m$I5J&pbK5eTnNvn!dbR{Ul>Imr%YQ(>jji~Ce*o_kChk<}11=alaf
zS9hc<`_q!L>I;vX7Uds|Zca&Q4Cqj5MH>X}ziO!`DGHcP{Lqa%+lMx+ZrarTKHrlY
z{jiK%Nljvflc=J2d8wRh$eKbhVR@J1|8Mwhsw5oNZFEV!8(D)^HU#eW(MHA|e8zhg
z>Ak+b_8_M~dmySYCAmJJU6GeCE^t5V=Q%D@K$)>iu1(Jju3Oo#q4jN^2RHiHQf?(h
z!3raS4snSkGEQ0M28V3?*go8Hfavflj6ARX0e|{?BrYPmYt=bm)6*_xXB1|yo}8JD
zZ-U9S7p9Ubi%XmmQX<>4J?Z4_#n-l~sE2M0;>u5+)ZwfQ2q`t_cIDWaqw~u4G~B4G
zx$~cbo?M-*CpcL}Q@RPmC%^AL;e@B$nz{+p0Lzh68y3s@y8=ZcXP{W!-1BbB{=kMN
z;hF{l8UE4X?$`spY{RZ@LRFRJt0cE609CvMck&o#M?jYYpoky$uKPR(@Po^=h$;h6
zhMkjN!+}YS!Jx6?L|<bc2I|8vPu}{W8x(%5dq+&_o&4H{JsHwS>w#s;jZt}&#LTti
z{;?vfn-x-JPk=zg6ZRr^Z>(iMYPFJwWcG8yYv2jeHL{SMC&P>&5Tme@TVx??;wkcX
zMh^=6C<);jVJI^$KOr5kzp;46e<s-h;GCA32n|oq<nr>=TeH=i-#uNp#Qe}|1tn2M
z+ePr_LKc0(;rx1_(lMXNJX6Z-)h7o<rO6n$kEflE0|jmQrd93TOL3p`IT^RJtH#mo
zKWjgWN$u*cuC{E@<>lCx^pB@&1(ZAlkW_hvlu(Ae68#i*%+1xWdn9;7pgVqcEwMA_
z9pUWSG)No82r3r}1XdjlaXWtD{K_-`V$zR`kRa*0F(CofS6{z8x9JXIkh}sGpr0{J
zD9+qa5&o&pX-eMd`b#eH2hs)q*#(AlkMX-h>^=qrmZn;v#1k)hJ<~k7Jrtwvhc=$d
zalq4N<pboQg#n*F@)s5X2sw3t@uF^NTF;HQ-6egO8vGPt7?n|qt#~NDK7UJx%Ea>$
zoVK;3;xlXw=Z?V5vtJsvIbvS@Oo23@6Paa??#+_suT@2=opCbKzN3CZtAJq$eF>J-
z*J+2{wD7jCanDAqG3{bx>Yhx#)Ins#1=5V!*_LxmcrP3!MMnr$XW&hV7fjjce%H8i
zJcl$&F!kGXtt+)0P6B0v2z6qedJ>RSx57v=u(XLrm=e4XL_trf5`yS!Fy>UvJ>kNj
z9C>MkGYq{%2p=mB26X@vV;jS$;?CyNNs|QINk@9_Y&Ey5TDORZoTeHsBSvX!bpVCo
zU=R?Sz5no$Z6~_XAv1kzp0K+ib3JLjL4#?&6L}d`xlK05s$6b3*Jm9Nu)K*Hu8LjB
zBt#b{@Z$h14urtiS~74}!h8qfK}wXy;ss0)II4z{gcU(O077Cpx%7l}y(8LD%bsTn
ziUx2}rOz49D_eBqyH_~8bMo%#v>;wN;~4T(NEV4Rj3L_%j^{5CP31(qb0Al^@h7uN
z#<P=l43r!KPbd%)tqHPX>5K-z0=;CjlG262QtcqzUNE(0F4{_rV;x<NODr{`r73fZ
zW>y;&+n%E8a_LIW7}wvfXWe3B*Zm47SF1Z1g>H50_lZ;8M6jyGbZdrKj(dn{iLE=d
zL_h5Mf7QPNXqu+F!R|&b#0fCW>$$64E3#AQ))A`9{odJetPwbI94o!;vR7YIHVe+a
zco2sx`Fj8<*&Xmbu7fkw@KI+ls;A6BSSB7Wqg!XkM^|uH8`hIycV^)rnf}Oc+!kp(
zs}`NO`S+c+umVTy+<a@*um5PHW>Jl8FMV{MmURBGogHU(UFpm6Gdp&A7=8OZTH0<|
zSla&CeQQ;_-Rj?Oo^s+bVfK>K4&R_T!Vt3AFfpS1G8#OoINf0*IcePD{;-S@^)2gG
zi>kkLb3zw3o+!iCae}<@C%Z~#ypky%un*y}{H{)NCULPHFQ(-jD&ADpqvxhsMZ7<j
z4#0+}xD(}LI@sLRwV9elL;SbMs{E7;Ta@kSEa`4l)}87e4AG7;*c+xL;1qvj`*+ee
z-cRz0<+A1+$Bu=dD43lSm^^kcn^*a!ytF6#oI+~M5fDR0aAy`v5Vpv>Ji5nlPI@4Q
zlgCOt^ofPB;H{ppG0mKTp6Y?K=uHb?cFCgwv!p^dx$wbA4`P>SR1=c#GBz>JWb)?_
zhs=x*wo%0RjOg?BR5a7^AiD`C;qVS)5jb&kkqpa+G!U7dQ&`tLxu&VCsU{zXK^Vu~
zJJfSY3Y_2F&w%4iU4Tte-S9~po=3`0u4@i=1kCBfJ0w*fW_6o0O(cm+^vB3|<LS_-
zfSJkA?lhp0I0NDqAtB4A$8i5y^$cYM>7I#&UKVj!IqgHg1amhk?!$}`#u#H$Q#(Nz
zKyj}+44_*9=`4e^(Wj<dEMoCk0KNXhJ6_)_vnuW}0s5$2!NWiBu!zND0>0u8nDBa$
zA%7nM`pDu?{Deja9|OuHTQ-7GkrVo`wudsTx4Za1E3*6v)_>hYc-Xdx{+x9abA8u}
zycG+k8HYJ18n$&@<CpI2rd_0;dOQ+PXR(M$I0ooXEx7$=xck$GU8eX*1J^Tp)?fDT
z)1q8DLS_mL3-a;qNjrC7N-AadivdKd#wScEU2f2YmX?Y^axtf|rKCuB>Ovkum%JX5
zC_wD&7XaYllN*meD9n?xNCQ^Svw`CGb+L~5R&!;OX-ssh%o@L!#nL~wr>AdgB2xrS
z$^}Eoq<$?6liFGn^H?+`rM0#t<t@6ln+UNbS|-NVEpYL9dLU;Gk$>i-3=~MX(m9ti
z;aQoQSVkH(U582=L(_pX_(tO5RG*{+=ua0r$~@?i0P5rvOJzpv{)XD_nM(gLGRts_
zd4|Y=)fHczL}^Xs4F+{!!Z%0*7MtmRD&36Ub&m!ML2Ky{d6BbPKQUNuw2s&<==97_
z$AX^q*WP!oU`S#s!*dI!6AENQxJ?61EN$4du<-e<ou|Zz+a`dTrA3;P4j@TBP3>!1
zZPC*C>7FD|kYcsbqTqQQa;}nU-FH9~cIW|MvH|sRB%gEJy;vn1nD%<WD_AqAqJ!8B
zSWa?s(J9$J{Uc!QyzEtbzW*P9xa#J$oiA%>qSmZ!0y0R=U+xROUrV@f?sg&Y%y*kM
zy~~7yCS<<Xq<SvBhJ&+qifb3R|Ao2vb=%N_+T&gt&glnH#}W6YNc@vvU_99EX9E#3
zse5)3%P0@&Nb`a++-3~)Ob%)v!o0{PxP@*S=+9Fl5Wu4UXc(7NmtE3vy@F6YN)+5K
zz(K>nJuH8`qd09;Y-OLkY&@sS0RUYIOh*Y}(iYyK%F7JUinlo%Qo5y|((PxQGPb^4
z5c93<Sfm=8#?|H>Kj>QPM<_S<U;I)HAMj<--*aA}3HzFjq(3MhN@C)UfAV%MHIB(M
zj7g4uL!2jS&b}~z&Q(~g^q98bmYnh|b&`tf50$32e|r2JAVO)AyKxsX4qQpux##p|
zy&DxrelGGFJh%T%`9RQ;qaUsAoRQD1!Gq@esSZPrNO`-X3nYG|V?7SFTa1sy^G~T@
zlT-bcO!>zsrNPM+rq5`ML7TcUm0Ul7_R<Q)v4$C5iDnLRlt;m?8z;}l%4w|}@_8ko
zf61q3o5%=>j%beAy=w6Jt)AND=CQ`AQPQ|CwG3s<ZleeE53G^0rh~^V|DsRPc*J;N
za>EwDtEGc~(g{?9`zz#Uwt3FDXQAZZh*M!Ufr$>tLcXbx;E*VLbuLrS@C{L}E*yY4
zPX&}$Obd*F9G`c+k(<z<3>`3T6fK78&fuMGKjeU*xrhaNZ)v!U1Ff!>X||&&wTec3
z|8o>G+QI1l@m+>l1>B9qRo`w{^M2WWn9Wamt%^uU+7B_ES)lY@VWsCwJ(-Moagu~g
zKv={gYTx=VaoKKanIoS&mXAmP!N4K?xpXN8y<w`zB988w5P_`K<i6&~jEum5Q1)bX
zU-huU1P1LR0fF2R2JGkn&q}aGe&jMjL^8QH9U9U#P7}K66Bnb}bNnhT?s&}HQ3qYK
zW^Qf+ElPs}CyhSitMKAXy0e|!((_p4qnRrrWOQUR{xeQR3YIkt1>ttkLj%&Janvn-
z?6~Vh%d@NJUksW*VP+q?GOi_CvIe*z4;?3-0P0HMMA^AcAD+cZtd*97<)O0%3iv~w
zA)V(8G8IdvfmIZ52FPH7DE!R&Un~BrsSSiR_rDzZ4PCE0#hJ%-Y#{eMB{2z{pss_v
z)gKpbt3Pahk^kGeE6@OUTTq-IL`#kr+QxbKOj;6tzL%1dIwFvQ`6Zpz*-`j({}`n!
z->Q)PCe-hWcXu9)7#qmdL|{=C8bg~!%Z}zMBX}<`gy;dhPo;^Zr-r<)C^$Iw2*Bsn
zXB9dL&YHbpNrfVR4(BH&$Gc>{ulrggf;vuY#%m0Oo-#?aH;&$o<5-IFlO%~%Dbhe!
zk?cM-_*X@!YPCa)vgH&60fm6<GZp*$r=cp8_Ny)WzKkidmR6+5#f3>Ce;lV9N4JQU
zN#ekl%%@ODunKB4m?HK%Zi`+84`BvM<EsFUlIb4tSa*!t!L-3^1MPQ=d{_?`W&`C7
z`Nhp;k`QCi|IkXC0qZ##IsSRYX#S3@J~wTSfxKn2vouAe4lg?3Zu^Wt#O7NTDu4VK
z!;FPVG<T5Kt$$4&HAO{$9|g+VTm>+sOt)BC8K3U=b{`rx0TdIqWwmzI=_E}Y?w<!;
z4*u|4P~ZeNZrV0QI`jg4lmv7HYqZ^S#8FbRIgGBGwL!xsYp@7{-(+Ld8W1sGX$fZ^
zOPRWf0!}*@J+QqTo4#Kn*n;`nvRq5q<WeEaEtYE^2^HYa=R@}Sg+}sZpq5eI9YiYu
zPlD$0SZFb|@>mKMj;`Dfq-a_WHFq5Jzt<G(-4`k<SJ~CG9%yIM4bU6rF3ThB93AZv
z*~ZxRIq0q#?eZ_RcB)d5c;RToDkH226j%PY`rlv+bJ^Kr<1X9LCl3Tev#B)hQlIa+
zbK)3|JIC?_h`P3L_&yV^Qb0csMqk8^Ta}#JD=Y0{;@tH`%({)-3#Vrx&M+@+<L^8C
z+I!rj$5byXx%^qT&f>Ps3$f3kJU>M|BeCq-PO;BVheNW`!ra@jyU$LqTP6Btg?uV*
z3LqT~$p`?k)-jw~>}--g>HaQ5Ysa6DE2Z<%en%`$><6*%7hlp5*%~!EvK)?CnwVDI
z*SGExfRHV^tl_23=qJ$VR9)Gp^mJOvx5g2>&cQ3qt9!jGSwt9`WwnFT(AI4Oq;K<S
zDcRW*bE3}P08IfV^E0rZ`2bTHg<~HO0OcD7t2oL=60}Plv8}{NY`b%FL%B7!<EZ^E
z&GB_-2k3`RK^*Zj9xQjLDc$a2`O??-HTs6wN{4|=4jbOTZ$5^`|0obIK*NVK-R54s
znlsHEhF|L##)uLoFB+#_yOxT)h(>-t)8P$--!Bto+NL~haL46;o>J8I4D!11PXyr&
z0JVp^&{Df3KOaZLG05uWtWo<GyX@~)6*8KdYHFceO=Ht97q!1ruWoGAS2Q*12uPt~
z6vU!lIdXR5+&0@5`ZR?#4k%eoS-qC*HxH{UN_qK-iDR93P`4;R!B<H2lz96%(slr9
zKw^c%rc4Svx!WO@6-HwWsgqf68asBmsS)gaclVGB=9a2c2rhL*_UNJUhc^!miKEn-
zsGA2K02~Lnx_805S;9(e6jU>b61}jeF`;T@TcDZUa>>eA|J~xn6#F1S;Xuxxlyc6}
zjW2#`SBi=T;v4E?O-aCH)hS-9mpVC8#jZ2R@Hn{c(K4J~c&u+=W^VQE^}?0oR%N>_
z85Sq8c=X-NTK|I)CAclmnTjChGm~K0m#5p7NKabPtn5IGY@q_3VC{rxsqwJ%=VZ4}
zJM92<+YOc8o<taOrDD@b=_@nr=Ye58ULBMELYm#CPdw}jr#KG0#BH=buv!*&+M;p|
zoRms>n*{fIkTNNz6yBbK7D~qwuw`>DO>t8*H=C7!-qaNz6tK}I?W8^anYeY;V{G$T
ztwZTFzIU0eL%E;x8!l9N5jWl?bSP!GSv1*IUTD|ahCkn}`W-Jnb><MD9A8{)O~4)&
zm?e?>r)pK!L`+jB|CE`{KOUYuFgU-{u`a8*XYu%`YFy<REYD6C+;gxp!!|K0cBor%
z5JSYS!V*E8nQHj_gN^h(SOT^UKXcpVrnS~08@i~|8~!w_HUG=g9)K)KYjI**NNVLG
zmz(kszlg-*Q$d`!a_g=;op`Qg&&jLnnFq$3lWkZ6cA_QEgT_9>l0$Zd4mK}czlh6B
zdl*d(P*uqp7>gzTJlw6v^h#Aot}4z8q$@!bHy{s7z;2-S-`KU0v~`Dh?o4l~{TY0(
zL&>qr?HFyCSxTBGqwFP{tqE8p-*T6-8@&W`%VSKe>R-P@Nc}jFdf(hx{Mj0l?Q3O6
z$z?hD-jd1n`U%_9q`_MoEW8v$eoD=W=`#D1go%YEQMB8@KL=}u;Y4vjc{c5j$pPwU
z&AEoU0&r25S2Ef9-`AfKEB_%PXnu1ZnDv%@a@Js-t(2L;C2E<ikYpR51CWKG0Tcd#
z034yqH{<kNcm2v<2K#Ib6k2Zz4S<lcsG==cy`_g<>wXehZ?4YPI8M+sYc)65$?Kpn
z^s($4XSjSjTfgWlM`5foVf{G1o57CLXw*!TXr^gWHN|NfHl`atJ{p{&EPe6xn(22*
z2?6I@1M=WNK&7*8(6SThBPtAH>Oz_+64=~ze?tepk1P{?f!#UNL&f10eF(833#|++
z-FzE>+?VXHFo@v$$oF958dHs1tom9S_ueia$AuUpQ7}Y5T)&4$hr(s38H1a)te+l@
z_J`;k#JCJF89h%9PlfK=8XfNnfExTW{o&Bi!<$MLQ)^h?A(&!Q6$iP0p!X@xpmhI2
zu8q#l)Ww%1?E~;uY4@@p9A&}b=8#l(5BQU5v!Q7y&Bi?pjNXuqjL)hBZ23(cUxwJ*
zz5xc+!FCeglvlrWPA)+zA8&$AHBkPpvNCVT!xjXD^nb<o2`F$c@Oe47>OO$i8pwNM
z^O(Os*PCz*4+tXB9{F_}Vb^sJ26&>vx}gHF5RM%CO!6WU(RoDzA^=He0|Kz?_hhCt
z&@+#fVr=~BjnuzYKw|Jjs>~%5<G5uUJ|mpzm>G41zY)E6ig&7ZE((!U;+bAgs;E9?
zFTM(V5;H1oqM<&a&Orq&eVO_FgM|&#$Cx1%H_O(~>FFWx(ERzx2Vqes=j-}_#Jb}>
z7#}ai@{CviVtHsR9mUbel>^J&=UvvBiB$|^OyXGe#Eh+`AoG{g{s1Pr=p7px@IcS<
zRfc}CD?`d}hHwK3v}JAzhJapgg&l~*w9ttyrJ8aZWi)_X*4&XbyCBA4LOA4)kk?%p
z8qbz*jr6`(?rEP;S`Hv!lYte|XJAi35+H0XPq2^E-L^nE*a>)!R$VV4AJya#434m{
zIjg&U83CX#wrPL%mA4R`S{R8v*m^4gUBMVPr4a<&c8D~<m7!mp@dj=30Lo_r(Iu~!
zi(HY*vvUOI;Y|u0fhLZ5?Grk~n@M2JHI>r+iYz>OQ+#kVEDeIil9OriC4I!41OA?-
zT;+S^%D=dlM>76BXvSoE?_KXmJm>G;;vRD@Yb`%U&_X5P9Frj^3d-oK%cvL>ua|)2
z?>lUz%cwD%+puKPklrne87C>W&XHszAbE2;mIu!o8F^jJ*N#9==JQ3TC8vWc-BYu0
zdFw9vvuhe-1g9McTLNROFUYlouyg*q$@DV1a|YQ42chBV7T%IgSg(~o^q%hXH+Bd2
zwvz84x0M_DN|YffLPmV7dP!kMR7P%e4m<fnT<rs6TQ4ZPAg(j4W_JiaZA<z&zYY^8
z(U!Y$L&^B__7TRNVN$CEu~W8L2s38CMzlGL&d53-+9f)h=FK5u0vvr{C$2N2nYVnR
zuWfik*WHT=S$&xN%GO>TE4oB4{h+_f)<dL4q&5F;!Yc=xRo!Qkfy4L-ySaJBvOJdY
z9`8Mp12iUGdQiMad_YQP(hej@eou`QibBp-iF*=CJs=iD=U?i9cSPpkpL=%kK2gGk
z{yPQ%G4<fKMMj?l>piA2_G~tTt%HPQO%JS~ezIx|FLuY;^>y>VP(i>A7^MDzoHb9Z
z&o67d2RReBaMgUo5tb)G7gmT|FvYFA1A#vhVdsg3^ZQ`;A*0u|_u9&&k_rAd=A=&v
z5T1?)`DsJGTVya-PeKZ@Yp^n$IyakT@{rbQKsGPE9%76Py9SbPQxM=}9{0gsZt|O#
z^tegUYc2!;`G{N8r;<BE0no+90pIR4$q#lCO!#B01pCTMVPdaapsWOQEes%TQ)euV
z>*AJxVcc!W2D{$=^IGiqdOEH5PPk&gVozp$E--G^s=w}`POCZq?#q-h?8G03G_$7F
zFQ0E4!$^XtZ)Nj(>rTL?R!3qlkoW;%JF$`QY8Tgo1*9Ch8XLJKj2~ckDH2-^@9r{y
zC{f&g39dA_`t<pAGbQ{2fRIpA!j+J47U+=OI!@EEa}5pKxIJ|W7Qn;$&N&P@K1sf?
z(+@IPGhzM*-$GFOFKe4C`69K8#8?s<#zEy3A*}LFm!<~3^RI@gVDWwWRFinUnxW@4
zZfwrH9!F@4-+K46)BOaFcJFhOUyWb;?*C`fDE&hXHUq7&=7{BX*Mw)GdH8!iB#GHK
z5lzK9lR|sk@BF0STk@Ah#D1r(k*|Yx&4T~xbG`p!^cKGhJm;V8*uuF$uBXrH`&wRM
zHhKLr-*$me&-GJ`1e5t+t-x65h_%F)G!3*j=gCN14-<JzahpYM0#t#IP@eQQ?F%~?
zO{CFtcdsLDBOQ#UInqzuM&CJ&yJ-e@qD6k!Tc>_Lo;x~~dywxm_EIPw#r$o%GtJf&
z#OAi1Z$_*u#@_R?W;CIa%raJo#+fK7z2+Aq;N=m>OF1F??4ZWG;~SqpCx)8y9nydC
z$l$u@UE21zB%l#noJ$jgHP{+A?6%v!^zvwWT4)JL5eUzMf7>R!`uf3Xdh#31^>Yve
zOoe~+p*`;Sh|Z-(eUKA?^%qlv0GeE)$&k|>w=}MD4bVmBuLH9nDzL&1;}sg{d;M+h
z`|Ii2F)QqFn*MrOBZ}$doIvO_N!QWd*>X@OXCc>9{ijb~rOo`|D?mL5D3VRuPFSS#
zF`%rV@){!=4QF%?DJ(gQ>M3T6%?P6d&_4K=7iGPr{X5lKR}B*voN1P8#;!^S36ul{
z4ooU<>^?{MRvYKSWAZ*kh4E-c&;kEKZowWus2voJ0(bv!zvL0T{YC#KM=i927&TYF
zI%<Crrgu4Ton~V5dhm>by+GBd!fA~cU$t7W+HE}>y%4zjsh#Sx-H346HsGoCf=hee
zX%1NjU`OB?Pq-``**cIHp+8lzyeeAfJFyyz4xP*QZOib#BT>#QJh!)Cb-`}bs0<yo
zvj6`m;6E>OvK1~vqB)2JjQxkc+D7l3t@ucg>!rz+;B8!?MkF{4MsSp5*=oGBR-rED
zsmM<Fm|wA{4ja7^t6QJ>{2fqt|B3*&Qx}0p9+HJJ644G^sd=_Fv`iv1(447DH<_|d
z$`C<%&9Pq#ObGQjNPA-w&(uslF?r6^x(l1yml8FphlV0NO9;_0Sn|S#Jm4yK;9m5K
z9idM(`0)*&)T_2A0#@#H<e0YY>~D@9gu(u;7yzk5q1$55(4geVh%H&?*~f#)$qBp-
z8GcYb`lG9sbd%iRnOY=}yQGHkf4p(32$Xn&wmAWMLc~mK`#;;4*PBOf2=DRe&evlg
zT$eRBs&LI%Yv0V7gG^J3qBRY~p>-@2LJNtFd&-3?SVBXKuU72sVJ&84wz<&U0=DY7
z(F$mUqMNBecsyA`GOXM+gBsY!zLAMX+;)S_bAAV9o;CYuU<eGdhmDd+;Z^s`0OE#u
zl?yqEnp>f!ub1eg8Qh~bnaD6&(IDc+M6?|rYCqxQO!1qWT<!kd{EyS-65bjQg&}Ti
z0Jijg6wF|%l!M~Pe)l4-yh67>96&P1nJI0tjwA!kw<_Ho#H6jAHAjL@1J%cWS8`8n
za1J#>GiOrgdF4iV)5XP$Zlg+Jry<GW`jCJeIhgMf)2-SFSHhDy)n;XB+JdC(SVf7E
zkI_``$~8#{#0;_b0XZ=VDf?mPO>8ufIkV#6CF7^nH0rlK+JDX2eo&wL*jw+{{n-Y9
zcv*f<1)$mQk;8%}MdvDx;LX0lH_aYHvL6wNdB)iJF-sw_VM%@KI+E(?=>j||?`G9>
z-I{LM$uF!W!nnncH_7Ks6(0mIi~NUQ*#BM#0R*?rul^O7VB5N}?6!(tr(%&7o;`g8
zecihQ^t#ZbJeNi_!@1qkeg&5(fcYq)yS=yG>8-i2YR=i;tMeX+e58ZQK!K5Yw$aaf
z$5_7+ggt?DqcVrXjL?4D$kN!^V6{r`R^mk~;>LNW_>tw@<Gtp|l=QEDe36JM7PBlz
zS+3!M!D(MxxBGQ?m3UJt3;LPL${Mpp0vo?y7W<7^>}L}gqG^TwZU*9;gS}4q?6CjI
z=qXvK7sXNKJ~sPAeJFHjxg>c>@o|+i16&iCDMZZ6_tu=i*0?CVJTi5Qorevkqk8H^
ztlD^grT{S7=*&-+)~YD^lzfAyRD4{Npb^L!0vVRn{6S`VY@tpkfd^y=!%k@3RV-!&
zH3Gt=CyBQ0KSuh9Sob16geni2+%ZI@e8{#>9qqQyA}@%UX1o417fmbB7&I1L#UC*+
z&B4h`VP6EGl8w^=n`+s>m^4jE-;iCC?E#q@9-CwUTJL_v-T#L0p>LAzd`I}1s6Nz0
z0jC<AW66;X$D=^^BNG*#`<-d%E5>^+aA^|tCVqNkWIFy0fRJGyGKz@t-^^1)h>Nf9
zdZzFCYZSXa@a9Q3UtdIod#b+0%ep?n6T3wY9<U47yD+5t1iOHQ!s{fLLyr4*IUbtK
zUh|Xt|6%tUN#i3m4nS)yPA6Tc{j&6zP!n1|T!ub-5!txZXoo%x8x@ptt$cu7IO<4c
zad^vzhZ?|;>qZ8z0Wg_!lS!hN>!e%2-#6%i6XeMOL4He{71h_TbtG&fY|ouyNdK0*
zXVUS8e!Suw28Xxx!TUp3BrcAj9$v8XPom4mmyRJ^;_ckRA<8AVY#mkw+8Evv<H($@
z<={a>{0|GLdGA;0&X?L|VfG2rm+<cp0HM3lA(>l}*);0244e0r?0zRCDvBWssbP;)
z;jC4LxEx2KEl%eH8x)ku(r7iEWBkH}nu(PN_wE$57wMT560#$fPW!hqj8O3Qzsn@$
zc!SGXypq&ykPTNGS;-4hTjq~bp#FYGAYp(%X7Z87%?=vNvtUA!v3E*IPU}2Vg2)<S
zt?LOzI6^8KU_mlWlfb6GayzEbRY(WJkPM}}n4ueK>^VDqsR;XU`j-PqLAj4piaZO<
z#QQ@sglX3jaxo<)8N1Eh^;5=%0khre5!LHGW)PXr7OPa;zW&C^Y^W#0LNQ(0aHv4n
z1Ji1^ZHw*TazRSafM@E|6G>Q4%+C+51yz^`@AdC$NQkEA=rUyKj`jTNwRxJ9ym)2G
z`+38W?4^~*5)%}v@bA2`PA5rky|cu8zbD<3v6-kK9Q?QM<DOclFa7}QUCxfAbEk%&
zTXFiQ$6`+Zl!K1)eEHw^jhEAQ|4dt0r}Dh33}5gLN4R>vKi|g`kiQ!M%A5DHL@~Pb
zSPd%+nuG~v&i^(jd8$EP1$M){QPNHjFr9fQj!j6{i$SMa%l)KHSZQg<1=0#mc~CsR
zi`Yt^&`4PjB{Uf?F_Ak{xHc6CZ*S*jd?ryYxFoa=4W?Ms_*G4_7?E6YDW=3?rHHO}
zEK-w2=E?9FL^z2_X)b~%81Qa=NQ{ZjFf~AwR7eo7*+UW(o5++A_+S$hO6_y#jIQRz
zh-|AZbdZJiK*Gb$w5W<|Ni+<NA%rb~oF>d<E#I1(<s85KO8U>rNIxclJOJRxMa4+;
zIXiSkNV;R&rbPIj961}Pb61GnF$Ti0fhwbL6UyS4bW;L5YeAMhfQPvy%7>@9b&I8Y
z&39AzoRoXnb)Vg%L!<g5Bl@Fzu32vPM6}kB1|PMgicfLDorZZ28BWpVbJ~~je$WpO
z?mL2fV;G86b3Mu{;(5?77nm9~-I&Xs(GB6WX9duwX8`dFjRv<jAztW-(K~r^!xWd^
z`{sc@+fK87VjgQit;<Q9DOAl6XaNKZSBHHs+<$pN->Kg4)Z$mhKMS5o1x+41tfU`1
zIo^F=({IVy#)d8D@dhK!E1x99{HK)rrahIq7ya&x_S$r3t=EUpFw#+P-E%IxMk7aI
zwcE2V>B7!p%0`_Gv=W**YI_9;M_>kX96ds;WHQ6Xdu;L&1LbS1b&cpU_i{)kVZRvc
z*C77V%jjZPy4{GX;q3_c>yGzF%ji<OnSCtxu~_e5b>emAhS3=&XG9}ZT8y#W2@hu-
zIb^R3AwP8#Amf|A<HJMaG83`0ZjoCvFl1R2IaJ{I-f6RAzSDG-1A5iiQ2xX>EtUL4
zi4%v!g+}m?j!U#I<Bn^ov69eOVdM1@;>Ie6SXm^S$8o|@JJ5KB#Av?gIK7ihu5@Bj
zV-thP!DP<S^^RKiY3CYyD$+40Cx%pTw=5YCXYYOjvp-d@%w*62KruIYa<ux>zQLj0
zsmAr0{`r>1#ZurMo1p%*yENZp-<=6ToeIUM@teD|)69G;FFpY@N7J;`=-=O;$#`EL
z+G0xbd0WRw_TbME(%o(inBB0!UNPW-W`6<|#`!Q2Vp8Qh^B18>hJVePd@|1&lO8?a
zZ<w2-GI#b1jkI(Y9ZhyEjPQyt_<igB3WTKIx}`+x9(f=<W7nCf>*{T}Z`ZnQ%MTzu
zljM@@T$E>$L~!;Bzm(X{XU{r4QUHVulS&BCKL7xd^5`i^xBBjXLo3hyNSnS--+9LZ
z{bcb{$;;QSfKj8{&EsAj=+ZuEHFMHsCmDOW4#Xmjh3NWw$LKIoX#kfNhCw$s2hah?
zxD$L}4gkpf8_3xci!xK)MZ-COl3j-hWSDAml|LiV-(X=XDNx*jXrjU!iWe$<AR2p1
z`>x9?o!22Up89#Oj-F$#>%>jsdPbOeo`c?8(A)e<bge+6WJ5Xzkaj99PuvUi|F@kF
z_zZA%4?nGQqbQJ$^(yLqKS}my1P;83>#MmUR3wq2Hh@FYEK6a_K<`hm{P|4_n&*Q(
zk>ZoTEH|#be7V**rnaE2WbN{xpU>U+slM`X%e@BeV|@TsHpC2uru#Bev69FG0AqRi
z^1ny6kNzz$s+51Ks|8w)pxgdpp3>Wg?tdcLn?8^!;VJ)>gfYEy2rY33jJy~ZY`h6P
zm8<iP7<^#wm8go`kJQC^5yP3@VV>L%@ytG>i>J?zgImPbK61%DxGpI~2*m6dx^#*0
zP8B>Ro;iGN_<3~5AnTFWBNq0G>{1xZvD{+)g&i{BV@c2$%<;=6ADfE=Rct)(us__v
z-C`I~6!^p@aKXy$%P7a8{^OR7o5sP`Iw`xCM9+_D1&H7riNnN;%1bA8B_e0kQQi)6
z?NGh6qFgGeC=)x{&63fY6w&plc1bg8$KV~;5a+Z|C)Sm3swfxlJdRHz?c}IxtA)sg
zfSm3B{oK3n&!2tfYNYkS$fJQpo4<eFGxzuF&aM-#edB6#GJo&iUvrj?9w&>nm3Qj^
zAdSh{$;G8i?3CFj9L|h09@YHf(mm7>wS9SA`KTzkeBcuE%H=B(ru}Zpv|7qxPm{8Y
zp-{WY)4ozR3z-Z+J&9r9CzAqqQ|7El=Ak-%N>@eG74)7X^(Y)#n5)QWFq(f|aE(K&
z->S8o_>GT8^E|3{9b}qklSBEhSo{iEaFU7#Z5L*F=T(F10JdIy?jc6(kLrkVFUkS;
zamG&Gg6&9}nmZ^Xc10e@dmq5`OGJRoxzz~15Zgw^`kJv=JPVg?1@KZ!;+n)br=0rI
z(ftwJr^PHp72XDU{ds;pdZ(Y~W;wnHi5t^w@-ic|5Nr@n_V8^C*6gK*_K!JuJxzN`
zLkucyXZ<juFdHwMtmU!v75W87-<soA)*d%i@a#uX!#V9?Sx<Y2q1FrH1AdgyojzP(
zh1br1|0|voi2uxJ$T+aSwbkT?V3QSpffnT_58nLW>HSu>st=fQ*6N{f<y-RS10u|}
zoi1!c)!H<8{);c?{#P)^37xbHf#?Z4`PKFX@&rp6(&S*d%1+#K8EtpHiDeev6}iR%
z0)Z2tBmk(t3Rl?PEj8mcd{&yG-e$sTSOvzJP-0Uwc1PAiV4E<m#4)t)B5Li8He|Zl
z`-r<u->-XE7z=kT7+?+;CWoNc7hE>=(1*9kye8GY39d@lQogzjm>z*-K#BthXB2pr
z>uOn*ppNpnM;HsLS#fyW)BopPY9v?J)Hz;1N-nf_s+c~bH=d01+3MC1R>tE=DDN%r
z`Eflj+$IMm>4oanwH)3Yv_lY?sG_l@RS`|R9e}p;>crTRp@%Z*PTNGXjdyV}S6)*q
z=OmRfY$#E-yJX<PnxRc9EfcL6kCqILj~yYr;?Y{A<#O{GSB8cH8pZ<;p;QFUGZfy|
zam7MbK}Dv8UxeKbVMJv<Iy|pD-O4A*`KUErIlJZqg+>4^{P?{*C)`3#3^30q1H6oc
znL55XJ<|4&g0?_eJ}#zE91fDx&Hc-A6GEQ<z^e1mJm;wWTQcaxFj^K(D9&gOdu}ER
zP_hjN?_ucej%Ar1<$3q;NF>0$BCpzRz!8v4-Zb$sodfNa<E9%s?D5WC(1!io7P0v6
z!A1hre(}nakfOaAznTtZJ$8k1VB-JX&5*}?y`FVif{mJkuk{bU3hKL*X?mb1-R+*y
zc8LxuzAj^Wl4B3gN92B7j&>a5QyZj%j^k#DA)kdGDh>2U^x;P#4r=aBdv;2{OQQL!
zS;nAKqAn7z{&Dx_R})Mi1mYwBn0s<LyLGnbps|H+1#mKD6R?Hru8TtKmKnfwuXhzQ
z@2x@Y>IE>Sj?d*GaGmZ!L3_YU_1tIbr6~)6QlgSY+M=M;AlXUQt5NL=&Pr`i;E14C
zHvCJv{<egt6CU;@e(M6>#E0gdQAsjxgUn##qC7npLTkhe&!3io012uWi8F^eC5ZJd
zh!MsK>MF?Ne%}?s+Hu!K1&Jf7go4%*<~UC*s}^6%>$`>3gwy+|I-$#ZxuLb{L!6ZM
zUlQ-|P;}|7bz84i_}=nV26-2F@Z8tcRtSMK*L}RMB3mPrRf~Dd@zx@NlvQcgO9Mf$
zPlM%Wley3vj!q=ZB4Z)|RakziR~Pwp_4-W!W(T4`dX(0ve<LkB@S}%KnS_FU+?S4N
zPtr~Xe#zYv@Ux{Rom`GNP}%6D%nJ0)`javG)s)iyonp@<nhtHUuF-Bb?^yRA6R{~n
zXU4hdxMMR5WvgPjoPeY{BDi$!ByW%1-UB_l_vEqMh<x?f?coiae)%Jv0J_b)=H{n=
zgX4>}MsZ7#r`M_}RZ`=J=_2;6|4eRQgWF!|ywsNQsDt1-R9sOjm<;#3x_<Xr;R$*|
zJV!Wi0#3da9@FVusfce%I5-<t?yg%~$H&))%gUqmbXNM!{zdgxQMp}n#Y9E<#y-me
zaha=6f}g((FYuh(zq%?VL!EHs!IAmpS~Hf)m(LtGBR3CBH0V}uZfsk=y7jW>iO!X3
zUwm<?dCk8_Z+X6%G)M|$?O|P7w5TtSPo!Pz?aguClI<@r1(&$-O$9>~8=oD9jr^~I
z!`8;ZW)|$+w?GfCvRB(&?7;=c%?%Fk_Oj3&-_cxiWGzkiJYj45XmDr-Cd_yZ<e;J6
zp~HrTVD_#4lci;oWiKPsW&Essa^6~AA&p9R?HAwPR~5dpF1+S!7(0<Hm7Xq~PbFis
zD!bIa8kKge*B~qQzcsh6ua=IsW?<?XWO!Dtv*S+-s;3$Kf28EBT6wO!?^u|T%YT*t
zqP*C;m@;h=e*fDJjkRBsM=Di_vUc5HJCqvF)(nJdO=Vo-@eDI#O=(EN{9d^hN<EZy
z49X#~ko|DI)z6Er=OVXk#66~T*beXfa98JX)Oso1OJuAog<1Tq{$owd?L4x1Q23cr
z$8!cu!X`8Ji+q>Ub?+92|2l7#-I^$mq_8nY8kvSh4}fPWM|T$hPnvQ!zBes1zmjqs
zDhxnog^^hF8oSw#Ifo@+HM;yIwFbau)FgxMY7yh2U4>3x*_;Jr1&dBEj0?sEDkPZ<
zcsW@u2-uN9l_4$6tP3MUow+m%aoH_#yFVI<=>#%(L>YVynEiq06z&8<+9$2xS~1Ec
zgMH79^3z0vmZa7sXPoQp6E!bO1X#;i*jtko|2oFZMy*jhsYXBBFr`m6Wd&H14yL>l
zc)jm-9vig$E~ew0Om5e(Ta0eh&9^S!01NS<)%6@9Z|=&NFz=bEdpFDCY%_QFm<>HE
zmQQlsb}2q_=jeJ$$Xwts@%P9o{3F}Y5LW#M1_%S2ai44q4KBm+(9p_de=@sdfVL!<
zUq^BA7v|wB&*F^?6cEEVGJB#stx@f*7`eR2PETs0S<~=Mcs<QJ#@p!{{SwX8z>s>L
zdd<L0pMLq!8`?M8JCudtg=LW6Ilh|{R1(p@-DiCo21EX8Q&SS1GLT<8zF+<$vfXRH
zx9>d5v!(9i;A~unzw7Hf5D4FE1@I|xd@#K6uix@LenZ54t!XOrJ&{HDU4LR7Br@)E
zKi_Y1=J2IGkG(GIeZMeY*g3#`D0-jI?dSbW%v*1jrxeoL+?o~FKk5%2&=m{<npzE_
z6fqA~2QyvTiqg-xO<<)JRc+Z^VS9>T)ns%e(nEccX^cPS9bL6{3$UHLw=Ak!wu5=K
zB9$=-AnU!O_UUvc8kch1zq7=7#A?vd@J)dBF12GG^oE+*u5%l{_WcnA2_TE)_zwQk
z1BV@Mqlh@%nL0qfHo7w@FEQx;A_7z#=~Sxh^lUPcphu3cXW2uHj*|N*NGQS-Qj1bK
zO+R}Unb_jXiE*^6e~nH?M#8dT<^UqVnj`UL^_r_zIF2w7VilhjUc`_)m)x#2teVGn
z##`G%W?7ECT$j(99vRcVNVjx1h4Z0uLCPCjJ>XLqR2ZLiknV(nbKxnpes+bu+jdMq
z06jp$zewO@Iz8=RO5tSW9{4(sUJ#Hs$r@rqpfE=gE61~7Tu=}>RVNXr>GXVuLjSyt
z5&O(-J>GrCZ_eK+D8v=2j@cY%Oh+^H+t9uR=`-Dd8)@hStyIFTdHY3LR+ttDH>yHc
zOP-d5CqMoWrQb9$DFcgVbEL-Y(dYTD1N`7^7|>hYCO#E55rhaI^M`ABiS<sho}$O_
zlR4D~X9=*v5VX_6^E`iVq7Zs}$2wrhNns=!n<u0hy<zRTrXwrel!AY|=2^am6-#lu
z-=grK3Z7mYkAtg1+>Z4d6BLQx+q-RBNd(F>YQ)78<$<4ST@I!z8z)2yh**S1Qo*=*
zvF-W>@z~StSa`^qzQWp}8H*Xq`aNIWQtR*V`)Z%s+`0}oU>o>RyZ<@<(#3SO)FtEi
zYkOXR^p109a;TZI&Yv(-<F7+(BzAK$qP8@<uVN_$8C{6EX6*DJCZ`rrcRDy_+qR1L
z3w@`2k4#?uc3|I;>ys0%&6+m)Ea>CzmKUasP8N|USqVpP-rD2^+$)J6)CeE@n=k6z
zAtrboSj%0{4S_8-dqlP~@kcy6eo%0eu&9Ijn_KRp6eZvTasFsRI8I<A&=b-A$f*jH
zZTwyo+;ygQ&AV4K@LAXq2o$l=;O&boMa4%_Nr$X;tEVbdf@t2b&%&;CMw6>Z(@4Dt
zIii03s`=e{S-;1tkI+D2q(Bit5-3SQVoOj7N;ncRz099lv$e0PZe~?of2R7$)6`{D
zia;Wg6Qa4Q=)eS)GU_{}gkIuLso%H~1g!%}qL`DI`J0kY9hVsI0MG$`vk8Z@WRrqE
zUGk<zD%B(IqIW?cR|Kf<3m{pEQdtEP?b25-C|w!_LcXtaH;-3@e7fxR;z1Bj^`bGa
z(A;c%!BIW1d2!iI^znEFupQL9bGz=84grLyDx>5&SF_i`2h>~GETo1fz&-l3eA2*H
zY$+rA@`F*`<nYbYnliPJ869B5D+-C9+&i`#!z(evCuYQ)S94hv$0h8bpx0*WNb?`j
zNv2{Fi!Ba0z-e%(hSjl3E%WT9-8Uv5nhb%)=Yr)BWk>+mF4tH?Yym6@eYmXm`P_kk
z;kQ5AB|yY@7VSDB^GfdK!O0!6sNwbZtr2pW1rskdPF-zC-M<bcGu-A&jB(i|#o`vn
z!Q9!*YgdhEC7=a9>b~{xdRf%onv^#occbsV6q%+f1oKlav^ZqwXV*m6$QFl;qV1nj
z2;5R%`rgbd5j#!Jzls|@#`Ebw!4Y9&2t{Q7l$?Lpf+mC1hBubw@CI3AGT)FptGXtK
zMoqe~s}rQoo_U33xa=@z-+Q_!gKx4da(KgiON6`@gea~dR9Dc;%eIoAKP9h-2M{t$
zNq66h2de*8$lR?+Dx`pEd7dLtJYiyr&`Y}3t0~AO+9g&|QLYG&(Hw<^sz{x%5^kQY
zFHMQ#<E&>7D^(OBW(}5RV-kpsD-=17t63Yn8If&5bT<#*CHhCdW|~KmK9-o78C2v-
zJy$xrhsIWkAh1txDD<uclku{O2Rc9C{;4*y;G$TF^zcW9|K=*~le2bXPVUaNuw999
zWQluYZ|D3P%S#u?+y7W<d-v6$YchS^fAXQq$#N#kCP?avFZ8Z+EOr6&cv}v-!xaK~
z;X63nC}V@9_xS#9jU*(?I9u`9BRMrA?6G}nW^&rxSs$LpE1B=?qSA|TS3%)=rASKD
zQMDjK`ZRX_><L^GHma~q8Rr4V&I?jR$B3e1$O$pz7$CflZ1$yWeWc#qKXoLs7Wqz<
z8LaD!KSx|czH^xlQ7kTwCQ0~F5%d}{DK{eDBU#mxzgisiK0t42h)wq4eGT|qqvnHc
z>^KU&Y=w+wrOIH?Bj`5KnLGG;J%8_M03l7Ml~XUXf}rWY5V3GbTED0!?cTCww-YKi
zS}p@t|0**>C0|8Y-S66O)#%<MKhn|c1P^mO;vh6*nr4wi2jEWON^24t!j(V*OBFvA
zSo@T7&4OVeYyO7-InixQ%^*m*#Wi-3OsV>VV+BD>`TDH<#;5wvO2e0$)1ejE2s-HK
z?HBQW<yw1qF9AyYQ+4dB0$xtzDB2)!7j~}D4)9VLh7<e)sUkn$ferKz8(e7;=;wUJ
z*ad_51-|<rg^*Xzj+>BuJ0<odn{9l`-)=m%3OO2#=5jnRU++$bAzJ=hz<ywMiM9QN
zv0&A?3759(uSzB>+V9MZjyQ0pV9<-P(Rt;n&!!4wH?ACho4$aO$$vDJ@O8=<%zE%1
z!Q#}Z`OiG6yHyiUO-^@$n=5WC?_3$==U}UaO};{+C~p?~vn7k{Y8@;lpS`^(6!>`3
z{1Xt@PX5K}rgidavZ$T(RqOhkS+;3PqqQx^IX4hx0pz!&kW@YDJC?bZ9~f-rkhV5^
zkT$eYy1VQC;otBou!3TC(qfu-#=ss_{E7L`ABg!ZOfM~T9x1fmj<hoBrn!A+j{6N+
zt8WX#7!u@__gY@>5|Z694YUyd3af2Xr}r}4FjE!3aeD!UVt#_LKtFA04=7z+j2Oz}
zVS4FPYp|Y0T2mD#aB<)@uLsy|uR{H^_o;^)rU8iFSNge%XyN$Pu>m9lo#0dir|0zI
z6Le2Z5yR8zbDu@3u*sELO{rY8HKs;cRqI#64Szx>0IKqSd!E!{IEJz^CJ3G<bGlht
z;GokR7OwN{EeZ-oEEGKzVqZ&R00a_bYeC8;Eoe&iu2gxm%hR$TRsIrZZ|S8KjgAyj
zfS4Z>jZI037eCdwTeHG(F*3FW%{4a8H8m!g$lU#i*mn>vNp|1YVG>)feLCEpJso@v
zdqs?d{oYX+xMi(%;ZjQXDO7-whfHUP@aS=G+4}J7S2`U>!Y#+fhZeU<$z+Q779Sdq
zUG|(fUHNa|Fd8!)pWKb<UdkAaOBr?k^}{yWHmhN@!?+vU!u_ZT(ppn~!wL;{>zIx7
zhBc~`<e-QRQIi!paO!tVdxx+fBpXO{*AQ}9)B6W5{Do!4ewvA=wO9;Z{=k<sm~Ir9
zu){%aE6P*xaV9qw_IKnGv(4ML$5N-N^!XD&$Y;pp11D#S*F?;5(<SLDU!muqiQKpa
z+F(4-;{RD;snvE^K@D^2A@v})2#O)VL;)eZm4bcImRv6j?k?9nAQ3N|58F6~A#&1;
z0S;&ZLGaqX2ymV@m*?g=zL^9TL6~m)BRyJfqveUpotH`)(XeaBFpg|cc#4|KEnp7x
z4-Srvty*<TIA52afAHYoHOz;cUA5|p85~^P6IsCJ7BV*c>(>K|BY}v16WN05eYlA%
zvAJsB+JDGoP1PyM=zL91X{uV%8;_xILXu=L^u(#H@g6Kn3YHfOTq0pmC76v0AGI`&
zFM=VSXq13-ijkEXcgD~3oKfw-zgaSuf?d?IN}Prz6v{=g62KItdKw^6rO{ytLJh0Z
z94yuDmty|SsvT+X&-3_)vsay-OaDz7;+#VX1;aoTJb35eP8O8W^YgzS&YS40yLaw~
zo!#_($6lZHH`Id%eXRvp03Ui+3p@jlX_Ed=_rE5w2y!KJm+XVMc|S4is@byoDbKo!
zXR9Q5c+AU90tg2z>1I}k1DP(TBFwa%gh5sAw!7xSfd?DOA%bZ+-0Bmk+V_$?2vfah
zODH^Z^?<XoMqaU_CopYeU8{$8{JOKeGq0oh3hOFJ=8c<=?*ZIX8h3<ITlUHRT>UUd
zO@ta=c1X$BsBon3hl7AnC5bM{HkZAHnlKOHum_HNh>}UH|4uS5I$OYC!trq9!_r)P
zM|D8gOQW?E7%WOt2Mus&c4%!9JO>zY$so~cI7sj==0yXwj9IzV{llU5wdK4{TPoiX
z*zB3@ISwTZ4iYVgo0_Ty4GJnTj3y2a{*Og%*g2|OaZW&78&HH$yax}!E;1C96f=N+
zOtJVhF8P;2-5=s!N9@*9B-^LsYAas<|MWT@E2&avcTDi>IR|VB8DYrZWq^!t>ya`_
zP4vQJ8z-?}cto-(SL5^_rJmc#c|s^Pf83_>X={dLQFrr7b8<6?YmAuNj5zk;32vi1
z^Mef`ZyriYe0v~}_&6Y^LS-a1FhKFCix$=`#{$nW6`W@J*F3+n)qr!q1{-abpE7o0
z!TcxjNg^tSnu$Lja6H&?&e-=M?D=)s?4mbHtM{C~lY&t;jPKJ3Zp&$-g?gIPY{U$T
zA3{U%r<aWa4J&Xx)8bWv=#!R*VwS31eYVIfO`H<22`dlcljzKfYPQRY|F^?++?I9O
zxEKuKR19(5comRNZae!=nZ4UdzQP-uLhbkSC~W}NS3%PAdg-P+C}<$W8zg;rY(yuQ
z|H0plQ%!qg{YFe-CrT5EP__suJs-fvcq=<L8ih>nBFDpEaD84>lZgq5i?+uokcRoY
z+10QDTu`0y;$6x>BbVFezpT&kVQ0-QI0hPpK~{+)jm5YOlpVsA=Ww0j8xv}+gTY}C
zGS~G1yfEICw+vPiZs&|NZ9|q>a-soT1+?fa6>DeGuD6=ciF7N3nWQrjeL*lh$+UC<
z%P!E(vd-MT$@y%KQBkq?YP#F;mfOavl*kB{m1lP+?|f^RolT}ouzd?sCC1*-T;z5g
zp}JRFyG_yUcaH3%1`8xCpQI?v*%D%;Ww1ktkt^TfB*Ql#)TV@L93M?X3Ax?S+nK2l
ze6~xlt;Qf(V&V8qGa48bVC2ZjW4en3qzIvfds^*9!NBi7gCl$T3Y&F-GorxNrFjk$
z)@U;ebVJ1lNB;B<{Pq^slmv~6g1d7w42%{%s;f$*emgR-Oa4th>WA3=q6hLJA?~PG
zDX<zNBju7Q1=q^_v(rQ>p^A5ICo@Sdq*7iBdebk;vG_F<*Lvf2*PufJ&!{JX6@h5f
zQ7XQ0=%g><J4GN=`G>`WB78he7$^_Y`SG%HhH`Uw0irUljf}rBhCCQ;c-IB7OTz=0
zD97-#OLFu3C4uNIj$$W2iJkFXD8H^h?@|-5i_-bmM9;SdinYCbn_#=!E}22p4l}m-
zH<!SmNWBh-WXGsM5do8x(aAxDvN~=8GhsTc&$-VjR+v`&;IO-gU!u3nAM5KHAoY}3
z+kY`N9uk)<lC2B9Chcq#(@8g6?bSWq-qqISqqEi&0+2H!4+{>jwMOlN9j?rDG#Df-
z5G6~K0UI3>D@nRu$obFZF7AQrsKbc!h*P>E^rf>PI0nEHY%N|Hx$>ScxZEq$HM_?g
z8*SuJ_}7pKG3a(#`P9wnQ0;-B-UBv;znN9&ozyCaN-MSR?~G0AM&Z8B2rl^5guB$e
z&bicB^h=kU)LhluIC^@mvLNPm9EJQoYg@LdzF0qo5dE6A&EwV|hpN~vq-zA#)}xZc
zOsCq6*l!@u&^pzlfSV)L0E+cKkY~$E18tUquu*)k%YEE^m$mU$W4jHf!2Re|<Tb}M
zbDR)PVQ70V-)O&9*Bb8Ojmr-(s{4S+Ed!fkn#`Q6x@4Pq?QXtYL5piO*9kQoY}7Be
zPOQ0fv3*%<S3pZgXN#0<(mVU)2uQ2)nc=#oPNx<ugOisp90PBvEU@0Lp)TIG-Y%d6
zqSorT&1ZZb!-7a1o|m!B%fri+LY{h*q0e0)iJv6df<s0%$Uw3!vRLl`5g~y^r>coh
z1#nDZu<Z3JPEH}0%<ztJIZPs(;W6H%Q)KgML=Y-BcRX-)2$GK|Vo+YGO&ct%*c5~L
zZTMH(6dCRr6XZt~j`kqvt~BHw;CdJak;3H(Kimw#V*F7I*%$;-jZ~0q3rp>2gTBD*
zA7YXqqQ>mW-ZlTSx7T<xa2^hhOP5`u4@Q+3rHTldvftdPGP+~zA6N!2hRQ~kD%_<(
zcYm;AKpD-U_yyh_?<%1^C6xL4sl&ec@o=^!noa{5S$-Rz=k;sku5>Q;ZRHP3E77@j
zTJIAK_T%!QrrS$I8(k0~;w4LQ;iKAf<-Q=hxxHhMw$=?R<Hv$GPSPIszF0p}xI-wV
z|J;)`C2bXkcUgJ4Gd5X^*n#0$!GF7IC+1?q%#(J;X1_aIcKZGX20(tg4PUmp1U&+*
zF<)9?96dBuBU9zGG<0Cx4hMqjkjHhBw3P*H$pC5@?IW4Kak}-(KW2AjM|z#88bjyF
z$&PV_;rrU79yUdq*laR!+mzb*tBuBox-^Gz?RgID1BZ77VDG$AEaC)J1k_TZuM+LA
zU$n8g$dT%2F(iUWwrw#UQH?JrS=O!gobI{3eM5UsEmHM{2C($nkyXg0xRcg*)RM6$
zeis$gWl-uoGV^1%q?SE?hGwcK+9S`45v6{!^_jilJP4Alm-1{vPN1$(W=zc;-L|~R
z;PFUHOeafaJA>##R3d6sn3_zsqi;8RZfT4U)g!bj*ef-`t2Gwyzs466i#PPv8X7E2
zmS#%-P3~w*+)<NeW<bsqVBwHKQsUAhO?JhNfjQcg6b9*XnKYjCq9dc!Xtj8Jw&w9{
zS`y*lq?B^<*tj4qf}9@!R!bU-5~K{MY_C_R)HNTN*BVk~O|&h<97A3}YoXL0V5w<C
zi`#Wa(kiB+FIQ&J!>Xrn{?jz7ER7qJYp%h9RtyaiVr@mnDf@m|>(lY?x#*-rs;EiS
zeMNDxqvw`;`{K!3rP>@PE(@Y8nlrJ%A)_h!r|^^}&~`AbFZv{Jr|ZB)&@+Ip02n^V
zR~l6b=(`2iz{9K)mOeho{mTKr7Qhhe5Uw8rG;olG>0Z}GOJ`IHu)M|0BR?Ngv;5{3
zF!a>XImGfROkwWy6aa9Mf(MnrXLnK5bJZ$Z-5b4nH8FPVn404RUcX*jy^N$(Su!)?
z7i7r3(K~LjTvf`Kp<9!y-L+hyBR@Gz<kHMcu<zK+61!<*lr_Fm&90K%z3Rz3A2#gB
ze)j(qY?iHkdJ<?Ig7kk|-U)_s6&HJ!oJq)4_Iu}fDpI4f-8w8QTn7hJE_8%dsKo)P
zAHz%)RHY5qEmCXfZHFw`HeCb@f<{vRfgFr~C^4iB9Dro_hcV?q@`e{%U&}3HE4!c`
z3@8`Nb+U$dnWy>Wj#;Wm1aV!3*o1{k(I~TBE-WzK#xODn_a<k0_m@PC@N!kv32Z%H
zmU*x=|1dNi0?SW4xT~c2Xj*a1jC+x#sFa<oTf3_we|jdTOji(GJr9===a=FVL9gUv
z0t$zEvR~vKNTglkr7;X~J0gzDd~IuWa*u@sKx?ZOUvq8U!4nHOn6zjY!2f=I1z-m!
zMj<1Ef3z`vIHq>tUzr=Hs=|qu?-^M2;UFP#QQ5G&em1R1n}-?+6`#f9JT7d7z35MR
zOYwAB&cx(a<|XdG%Bo&Ffz*VZ%y=+WeTVLGjynDK{<Z_8)nz#mU3-gSwJ_**Md}|r
zZ!O^AZoW7^F!unUZ*C}qF~|SLxmfsWSwRkKjDlDzP?+xK<CgxSO)N&k`vwN`?3x5a
zquW)$me3`XIhJId(-%%uVaN&qA;-x%N6iJPE1vrhy-sj#b)iXAG+K6xi}bX&-D_n`
zpZCnx9X7kSS??uieDZAmoV9Cr_UDQ=Po!5HJ~3*h)&AE9_}2A52F%j#9HBwqXKG)#
z;k)MWpSu8gptY1;iQ0TZ>EaXZK<{xC@wv3UOL%sKj<k(i>FzeWt221N+S`T0zglp!
z*0yzVtaGt6mhh^D$R$%waYcD=Nb~P=8~C+)!_$$CLmQyhEEM0N%!#P8IJ(;uH?4G5
z5S6en*m1lG?aLFwg3{^S&mT#hOn0ve(?Bw`-9Z0xsTtbZF;pEP-7p@811NQYnkdUj
zG;Z5NW*{l4G$J>$A>GNDYZ_ly6X#mUP)2U3BqyQmlq%F-W!o$$Rt&_|pR?HB?66F3
z(Z(ZJf<3*{F^RG@>9CDQ{uYjwmimvlJU{~@iHPf%4I6ehuG;_d-0354x(C*8MUPz!
z@nDLh<7+GMX1;V<gs<vm=M~I`^$a(?B#mQ=R4RSLBKQRdubW=Dq<p)BAot2HO^l~6
zvW&UNJU?|~9Ooq^vp8~Y1<Nig8l*Q_sqZt-p<x$~Q4F9r;|1&al<(#ypUNgCN+^T_
zCKNH(+MYHyKh>(sIvea6ZP&2;C|N<4)l}9I2a<0NRXEPlF3}cf6%e*DW?%pRFG(gN
zb*T35SGC$=|57QDX!I-EEIq@w;T6?B0^t^Dnd5+DLr2;RD%O#xGLorgSx5Qx*&lc<
zJt-bY(|WwRty3fB0?`hqc|$zw{@h3u1I)v>L*xS2{I!df8@E@2!U6-dfwED2C0$@f
zUL;-&<(nEoX!I{VFbQlijA4XuG<Ba07Wa|O1een#oVfjN@%b1C48k?Nk>_ek!#iM5
zE5A8?TZE#MW$b<>Q}Y>(DLhE`?DHHJcSL3OW43DD17c(*FatyK)oiFd9I<dF;ozyW
zUuI4=A31AzfwpX8^=*rhL`ugenA&Uqn(;-SDvSRENwa|pT{K{0qEf3wq&tL~J_=O=
zj&7NJFnwhGgfj`!=O=#tra8<#=h0C?^y9aWA4Qs8@;mxdm~$B#UobPh6zCTd5$_w`
zj&18UdHG;G%B%DJpSDsjAaN}Mdb>)dJ8;dBC4u~SvWadku3Ei`L7y@Xeb(@V&%BaD
zheL#$_=a?Wga#ySI&`$@MM@@Mw5@sXktTG_exx}F@Y=p>qmV)szR*sY_d-w+48&yS
z#nwK2Qtf4z6m#Q}I_1hWX?k}W$VzT6i-|93PGiR<7q^h2?eCnbNJrRZRrsc2vdn9a
zovP&KVLU#OCmnXlR>;<&i!S;3UoIrC4QT^+1Jw&_&36B4YKpoLfBea?$UZr~*K4C1
z5d_{$GxYUvuFLriiue}aa@A$M%;e<%JA~(ES9dpd_Ozm5j5eUwdJiY%!sdLPwl5yA
z@~&I3;Uz;Ok0!?CCgxk~!f!ZKO|8kCEw~5=j!)J;q&y<0lXcSMjP2}XCKpno+uUxK
z>+-uUS3rSQvAV76-oD-XK%45krn5N?gZ%RG$<jO_E$EQtZ$}3I_6_|Vq}^*}&)(a+
z=)5Qdh*tZS@V_L<i}DpR1F&(xB7o#~(f(ar6kF;nblhQZvtE6VbA(IpuV(x7;Z@!(
zY1m*h@h#;DYm!_brds2=HHq2~G4i)5uL>^8OUJc`M${kzdNYiMM3J{HohfsQgZ@+&
zlHjGA6;k6>;ac|XZ5-Fz*U-3k#`p3Xx!V17_(Yn0SXt^2?1REm#muh=bPp*BF%AX=
z)%Kkg_BamZ73={!zV+Vq)nS&*Tpvp?_H+BviWRfV`%TMdrAuSRO;#)~Dc^WFQ@9H-
znq>3Qwn7I4f3O+&@3HycX62WaI=%hMf#j1PY04RxIyJQX?zN3kV-a-;<u#i2yf%G<
zsYzWMAsacpcX;{L17jKY{3B!O|Lrrys<5=(8A|hfZO2l1>)qDN44W&})6vU&de$|s
zZ|PhUos!pHpQ|$HRc?7)B<cg%79k{0+`2m9R=~YXHpQuMq)s>5c2360AAe4G$Myk1
zE1c{G-DNqF(a|X}v{URQ`E9q{H3=NQHB!NP;{xB7^E`reIG0Yk{^M<qIof)^8gWCt
z7I@lw#c_x=Ok7$D{x_K!xxHL;P2i~MFr0D&ezaYCS&L+8rMKxNOX-9q-KL9LVu?1z
zU5|{-)Gtq&e)fQaDmOcQ=&wwtv~zSbgBeg>Z<jffOHP)msHiz%ppmTwx&ZCK2(mOC
zUnkQNC%`yi%NA3vW*&DZTmua{09c)MY5BmzY|7Q!!<VFL*IDzS;0&EsH5wvp1vZ~l
z>Gc#nkfNxx%MK*u+Gv*AHq#_CUMH;RwMaXpqwQ9z-6a2r@0oQdQaXlvhckE%Wr;f1
z%el|BN+(&YJL!ACcantON_50{rZ*+0KF+k%q|3HARLxEP^_EIzNjlDtioR)SrCJ>Q
z&BnCQGZr4Vpl`0#Yc*vV9rcIr3FA;k!mY5`*`x*j6Szg7f9jh>mhwbP+rfZ5<8i}x
zPi-bpMZxETeOLu5QStLeW0o<%ys_LQkdJAsEj|do1qXLvvK)?`2D)p^BbufKMWoYy
zn7K1^%FA)ix#g<m*k3l=>ebKaqhGvJaRPCrI~=vd%`@KJx{v(c=H{0u`IxlYxYcC<
zSs<;=xZ?566bT@tYDyS2SVyYiuuua>UAb@jhf^?}m7ib%|59-+%oC(L3i<+Nn*VPN
zdtcS6!i@F5^>aNj;A2t6(K%9s9bq9Q!Rso8H^?+yEfDdlnOq2)i6t26y)@jDhnjD`
zs9(y_0Ss@)<0BDHXnQAF?+fQrqR(t^*1GbNhb877XE*4!p4=MYAB16)UtgcKZjjd+
z7e`H2G+qOreLCNU^;v|k#(mjkAXtnTwsbz99c;#KB>E3-rGUVe(@kSq#Tw>G_Jc*%
zFK8OSTv0}ar{eOm`ffI&%CsERg|HFf*{K2FIn>PT>}Y#|Xl<42ver+K2YffH;^$HV
zkW7lsI{#S9I{<y<u5ri!T&BfYZpb#!q(q_^UJm=~*!us!rVSS-#EdL@MGGDkvlI=u
zM6JTym&Y*w|FMFc$sZVx{B9#A=VcP-o0b!Ein<4e{tlUU<W!WDuJ8+sthpt(K%VZ;
zi_7ZVP(Oq=<MECv-Tl#GosRHz>uTI)-BGZCG5D*zpew|y<Q-)W6LvW8B5pb98;gK6
z+)1<Ytf;XyPiDu~Z6H;*2Oj@R4{yg-2K#iEHC(FQD}m;%>t>&ft${k@7g!}<I(|m{
z2a4YGAO^OVe$yoFuHtB=(bcTJO(Bo;s`XntUOygb#a3YM$zzxE3bNpHV*Jc9_L%mT
zdCr|{t|m><9{ip$dWr%w8y^1Mj1F?Ug^9nwCDuIXZHt%b0sF1{9>AXwXg3>)-#_83
z{ra%ojK^k2>MDgj)|;@~I{e@J8$Hldw4-S30h1^6hX>WWFK(PMdpLa+>iUu;^t_6k
z!AV4Uxat65xb^@Kq2U4bPxAE5-mVTt*TZ(kXjgYo!u~ZW6wc1lMc2KUo<7u4ez5s_
z(Nk=t_z!L*wqs{|JD(eNY&Egwi5AD#CZvvb+HhX?`ExiTE~s$fu4;>a0&YNbRc|lk
zc@Mp$!CcCKQMZ3TZzp>(n~m=K@E)zF?CQ0&-HvVUoqgWZVmN{#=(c{r4K~woy!ris
zm`i~(17V~{b;m1nPRE!r`w^Bx!Y|@pA1B(7G+T)!=ZJum#|`F4Przugz9XHyYgNto
zo_fG+0q;cH!p+&|#F`a0%^Uw8S9>20+g@du4b(6?C>NHP4{c&*#rsPfIPyCk*ilxR
z)r+{eVs|h{rWq8+(L>{DG5^F%lf%KtbccAky@pYV&avBdZ*uM&3VPPYQF67@z=WAh
zg+37`gas5(ijrz)hX}JRhJ!LUGyG9Z42^F0%(Ut64Jc(7016)(??bC{F)q_1y_;7a
z)~QEPsm=9#%{WR*Wpd~tLtOEM{!RM&ne;dR0E9ICQ{-tcR;@{R^I5P#1GUH!p=-{c
zuc3w;7+BWfGaHj8JK6^F_ud{JF#?=p5IuL6%&BpqXGS{~wMRx;wzW@^P<xg@fjIz>
zzUW@Ot)-|dI*HP<%}AdxG=8KzXl^eew9JBUhfnZW<FOCG7I?e%NYxX{@F{#)Il%t=
zSC=)Wy{)YsgKhuy3wejX`E}rcDuToam(m=j>KLoxK?HB-a*iv{+&FC9ByM80l^Gei
zQ>vs1gSdu|%R^~clqW1HizMeJZ|Uw%65_aMdUAc=1!3QDeKP%EsZ28Zdzg@}R<!{o
zXQlsSlI3ap%oextmnV1WzrObGtJjTvf80BIt-$HGYIIxdGf$VBFjv5{n*tmGGRlSr
z#g`7G;W+{tc8&a?4`DdbBQjyNQ!5Sm*R?m?D@K)MvYqv#f6KMfJhSXHdo!P%EH|eU
z_C@=DH5+~o!;+}htd=^uHOd^j$HdAZBdNV|(_cwdNO;(zO+<I8ZH>a@o3o`d(7rU%
zr%Mf`gx6r1G)j3PTIP7=RmrzHWJSTZ%8<m^CC;U&U%A1FHX{m%rEtc?*;B$J9`&)~
z6>CM}L66{96Ho4D6?_e<Q_Pld8jULW;(}0buX<q~!6d#!&y;*oh9qxuBs*%OLm^Sn
zgCjuNhbpX(>$<z8plkb)lMh`l<R9`{LyG63QvH;S%^jWZgV+dE@_wq-^c2o+pt<MG
zbBz*;giV#OPkbd8SJ~A25lfc@K`dF3#fn{!|DDTgkRQ(HN(R(jmd-0YOdjqGZz7te
zMv%KB%|sAIVWgX@mGzK@LqIm=ph~}-EWz$I^np}Qqb3J*F!ATzR`PvHdqe{3aa;8P
zC6hB~;-Ke6TEkt)zi(pGyJf?0-SM;8`2E|NU19F7*%D0s;qc#ss{9?>&nwU~mxXqb
zId&iY3{0<CRv6Y%q&OwBBLf@enjPle#k7TS4m0ZcJy(>N^R#wLfcb@8L^e#OJ0i2H
zb1N~AI}Hhrr57~D4e+b*D>)wL^>o&)s8UwztF>$9RS7a?Sw$u3K`tZ*0x?8ZEV-%!
zZ(Cu$a0TW-IWz_qLxkLbLdA#(MA#a)4oLRdKYo?%uPGj(X8nN-$ngfAplK!b+*+qu
zd(^3srD(1I(q}@BoTVq%c)#*?F6u!kTXOc5e<{PlbM>3-_uc!l7m9~NcH(PIlU^P<
zJm0cu@FYZB7yJZljwq`NdTWWwJf>Gmh{QwgZh61R`E<!Ck4*9AHjP@Qg;F4o8}}X@
zwSqvxp$fCaOC(ed`A6R_dp<`*sVD<c|6L_t*G~GC<PSm}9jG_i0CZO1>)FxUO^-=N
zUk_hCvNP$No2rYcET|!l$1|!COnmS_6xl=4AOcijV13+-y5FGgTB)%Z6#$vt0l5yn
zc}XjHUE!zsSExQ#F7P{D*A3QC)vRlLf3}afFsGqV0M4(^NIsoho|d7?Ws1E;hZ4fa
zOn=}epz9&#xckgw;ucYbA3cU1VJz%pjZC;Qk%~9{|M8~LQUOASDQR}Rkd4u{d`EM0
z#z42NZm2!my<f88oM~9mC|e(<YGw@}wNn*WGgO-$^{A)gt*dp&9H&-rJW7~+F4E9K
zzfP+R9TTwCtfE?St!+y?|I`c`PdNVg39I-;pax9r!6U`fYoqR(@S>xQVgiOB_;c?k
zlt~BrZfgQ()uk$+b4t(W8L1Dq{?-3n(@_7=jLW{gbK47%hqi3Si77PP5j3!pF~)_3
z@i8t~3S}<Lp4aY7*5blKfLT0t<8*7NZH*Wq1G1=?v6W!O%Er7y`Itf7E`VS13F_6j
zQ1SLuv?-h#(z@;|HDPSBl23z0>m4z?MnVzPp{(T)K$|;@a7{d#x~^<q#gk7~NXl5U
zfuDYQt?Q|$x=L>dVqSp>4E!z}v?-=tE(@Q0G6oT-hW6LGZ-|l?8KvgK-NS~Z8J62b
zH`CdcT@78ZaY(vf+0yUTNMiVEdQojmS#YO~u19^5U7kkBLFVh#q#gwjQaVjk_E%%Q
zW5)ucz5L9OK-D}21^p(t8Ib{#^el3ctEg~To0KMul*p-27#?x<-#cD1#}ww2eL_fD
z$v>Fu*LL`g8B#SzuHPXUJLQ_!dJJZCtm=N^==#L_RbvS4CEo-a@9!%5c6iH|l(yhG
z-qbeBqno#K{kLzkZTXgQcw5msN*i)Ay=hT5<E`U(J%YBcK5kMsPKA(gKM|lv%d{r}
zt(?@ibdJ#7`_Kf8icc9;k*zslG=$~#A8x->yl>U1tVUFFQ2QjVxnP_hY|JlBw~9K1
zZC4<q6xYJLtNcd#9?g*mga98QAW)xu?=CT5!6F2bj1Do~GnVTxD-m%zQ)1K}_==N(
zCjAR4_A<Y;1ML9|%Apas_^1VH9%<W6NzN>w{qbWrFnYF8`LSf8cLCq+6@ZXXcV}a$
zo@<Fa6u`jxzc_a9J(p$qssS&Jjw@G-w@Xyeb4)?Wm0`_*u}U`{VarLC`Z#IK<gQ9w
zh<|L7?D*{FBlBG%R^)Hv8e=A>Yk1$idN<~Q@Ropjc;Z<AJKdf_v#-c?>8}5`IO{Ii
z;YhxD(#zHsPX5FB`-d(6^l6R7HVMMO?3)Hd&$oeHF9riqpq@4o3~N!4HI9g_?3}K?
zj6VtI3U(<&t8#t*5(_I63BG)F-cow^%5)1EBDu3Ag?PtT1w=pBmHldGBdQn)KmcQx
z!ez5{w7@~_a(Fn0OHJjEh@8Lrg)n8q4hZ)jZ!crLH+Kkg3P>$tNmuSyzuJIdtKj(>
z$y{uaQ@nmoq>L`t#+iWJM=?1E&-Z|yHSAdJwNgVedZ?bq^x-0!K?^LO<2t7_iW!?i
z7Rx{MS`%5HRM;a&Nh4FyeP>2|HgO+0c`WcSm}tqcnOBI2vW!gFqwTQK_HW<NqE8}}
zqiXDtlXVlJ`)3t;5!Uw$q6S%=m8H5*%;8P$8R;)YnZ~DpbegR+atDcFvz|phv9lf@
z<`+WsOp`N1Zm@6obVV{kNddv^IOa;g{sD+9bjEw0!BnmIDZQ!ehP|$R9Mgb(bt3y_
zfBm+cp%r>*vIGs5khREImcAja+4D9gTh?Gl02cQHw!(s6RP@m*D7e8lI@plF5mU=x
z>B&*D`$7Zh2)}t4;=IR(`B#n4U9rp{0im;xr`ucG4i;l{k6W(tLn(AS3kMrEpJD-j
zDtbu|B=XcmdhNgUP63C^qV(wlO|bHO-6L!36*Fr>eQq_Ut;Mu)g01bORC}N6Ej@Ai
z>Fq67E&kLUilT@ATW23t>Xkn@oa<!H_&=p!P5p9O|MaTvR5MI;b49YOCC^TrH7iY>
zus>fiWoscKG1089E#0l4{Gqok;irrqTV8br;D^|jhXD*r&bKIt+yLT^!(4mtd)^79
z4yv>VmJOjbe%QF(HxOi}ICFy|*f}*j#(4#h^!X#}@*jp7ru#8oNXmT_TU|36RwO@|
zXIzv}x}4oeyS6R)=Z~z(WpDD_Hr8O*>U8Yh#DI8HUF@rFujw7h=+sClO5RzRw0;X}
z8vIy}7Fz3yTT`65sM1|cvC$d|a~|hNgh%#6zg4Vtk>Mh*f#I-WOx%Xpy@DzVSyz6!
z$!wSj@jl71lonL@{{de#=$fD1%-oV)l=Hc-j9%pMmtDZzk=yu*%BkllK@7(oky2Yu
zc<M@$k*{q4NvzV%v$m(9g-m%`998HS2CHu)t||qj{@DtQ8OF-Siil~$m|<-!k>XZh
z30OLYBbzmZ-#BjBGmL3P<59K&hqsm4*OFTgZL$%f@aQ(oa0eFt^!WQUFCw?z*IPTn
zJMHpNua&$Cg9p@osIha9$U3J@3O1K;|59biD!tt(x$JnsvW(<H>NZY3Pj@@gG;>*A
zTH+ALGZ}irDadBtsZ*6W8vqk*Dv@*_94NT@%1b+VEL(GPrHv%f?#q^N!aL91_kBo$
z)NG+ZmBsUB82|Wx$I|BpqVVJs&*h_PiCyr>$;pAf<44g!G`;tQdg!9zQ~iX_bC}6A
zQ^|ia>VYRu^lI6}&97gdqGGe39K_-x)@@>J6driJ9=LK4i=|SPF(*&FGiXVyCR)*~
zKX*F()X~#IMDkOrB%b=cjJ!Pz-#i``@_l@2EHpT)7o3|AH;^nUE1xWMN{So@0nuGz
zQ8~&d&rQx-wW)k~r(djI^<wALScv4Dr`z-^RbCm6yuSd8Jyw6auI|ns0Q0Rs8FK*j
ze@O`CM`6|N_@!g<w=2pOHwK0-Cx!mqY=xyHM0J3nwL9aQ8;jQ*9Ua!wTe_^}WpPN>
z>#*7_iM8KW0p66fjO#5O)*C%oxTe*!d1vuR_ITN|+3sS1aH68x%;3=Bfs9p$59O|#
zug9Nh1<!Y4dSKE8k2BSiIc1y+WR9=7;iKq>hu=rPS12!>HMe*_^s@b6XzuHKiCnJM
zE>@rPxYY0Y<FlF4lgeS!ODWN*Yr{FQW}kn=f#|RQ+SAhd#Rxa+ci#MJD5k-;wZe01
z<*PN$!-@5@K&hk;W4>@9F3MBh4%a(+qO?N57msjUyb=>3p;_1aAT5s^5mVN@eA!Jp
z^KUwNathUCqD}hZdHjm)6UIJ&{*XJTCrd~LgHV2<*x@Ecco;(!7K)`gx)mD&Bne?7
zO#n#BYkUsr3_-XV^HPLOQudSO=jHJgI(d*0Lf==E8R{JUb;RLziB0yqyX)e7?mj*1
z%~%By0l;pDB3Q^~=6__-3-5Z3RMPPo5F{5Vn+8L`&f#XMCuI7-<THrcc=-2Cmi?|C
z(PbC})d}<LX1|!k@&Gx!31dWOh}+EDhl{b{NsP|QqK<~1mgE%gG-X~*aa(<FYf?%#
z`C|4)kG+fF7>wacztV@JjVv350TvMt!zq2O{m*X6fy}e@@IxkM+m`uf1Sou)%DNAY
zSSzDjV|<m@3br7Ow!<-KWTQJ-Q2b=LiD|8%TOs1%Sh<g-^wPEhjhU!Hg%t5dADOn)
z4O%1C+ONd;M!xb{;CuI`Z?lg9A;Xk(9~%ygi&Eq*@CkCO=4DIOhvz;M`lxlHLDGzN
zWARShaOfI#pZ)N#$;%VBvB|&AH$OlX$s(gyLuKi>tN-;$UpAvK14YVKbFYkw3y6Q`
z=K6mofv8g8e9)%wXLKV$=FM0eke6sq+gb{pv=qN9Er%pFUdwOenVUz#N}d^t8(DeD
zp>^29oeB&}z!x!A2+~Cy9`$5L6NERF*f!*zu|eEu?&mRQHDNlUF38;+kfL`%vGrWE
zMRqubh27W_*HvN~XfXnFgDi+#UU~oaEHw+HFLK#jczPLWFteGLmh=y-+o}OsURw3o
z4K6!zf5h6t@S2UTH@4}y_dk8#q1@Z@pi}A)Y(2nNGU)n~!;zg$n)vFDD%n`%`P64m
z&t(orRfl)h6o4xl*T{e}8RJr_9s1?eNczsSFxmRZjnBS@HE%eyA^dsyx(|9fn+a6H
zhV$8^KlUYjwe>>ICp)<<{j1yuYMc_CLNgVWyzMy+JAKW|@-q{Q2AQ=Xmo}(M!dIkk
zZjV-{DRgV3b?ifrY&%k~{N&z;ueyC?anG$IpiHp&)Ysb8`Y;ZgdRx+Is<Z1=qg!gf
zez8n%*PZs3MkYE3S7Dl=c}D9A8N?)!WB3PVip!2<4FXSB;sK-nM%)|8APB$j#*|Ig
zbVf0%qFXWp@rAWceEGlrN{{1an>d@u7Yu}ys6^?pi-Cr%Lafb=bmeY9*=7+{Qa%_v
z*3fG4hor+^CB<c>af6n5s3`YHUp|0U#2GUj8ZvV;Gxel4=Yhq|&Uz=cMn3j@r-JzQ
zF1Q3ARfhnZqK*f0Il~+`S7B<cS0e|h)a3^RD`bX@3WA77o6h)E1{d3CL&YM|-Gnay
z&N7K4K=V-_(rNEL&dqYCLn5HiwltMCZ)EuD<)Qv-SBKnG2cLd9eCs+BowK+vJD1I5
zv9yIO5rrMQp_taL-plFeQ14Nl@9ysEI(u$RO;wJpUuqVkdWGAD^C1+QmY4=Uht$={
zZWY+p*G%kxNW|hGt!=64^)~XJEyEattlX3wf4%cai_U(#X&2h=WP{80HAB)aS3vz$
z?DHt*v#UQFLPu$j?W?Okc<ztiT$!EbSnHKEu&6v%S%`1nJ{)!2ckR@6e1W}(RA5DK
z3=A1X_^6@1JItmbq1Q@uMo1VN0!hgYwg0&eRky(%LzO50a^cyN${>NK=Z>54m5NT^
zeng|4COob$Au+NyCasZE<JW7PrBBexMJOdwzK2MbP`xp+fmLyZO_Di$UdB|IS`DT-
zCU7QF70eK-HHRXjxn@3a*|aj-u1E+b18S2X&<=HacWF7LiST+g;sc1LzhJH*OM%YX
z8<-}>OKLoQWl&*r<W6Sm+9#Lnp~Ft4X(HQv=!ZF^QUt;QIep_H?3lPDD`Hz4U}w2c
z9koE20;ewzdS<dlm+D3LZ7|x2F)~B`#|dp^qicZWZpGs^(+{{}fRZ(yZJP_oagP#(
zjYAf3(QjQ`eQ%gC*4=$5iA|R~T;DR14S?Sv34_~4F*gx5>5V9t3l4R62O|qZNH<UZ
zW4{Mr<j5+jey(=4<`3WNh&9P@bOPTK4C{VKpa0+iRzJAk`H^4*Gn@bxc^dt#fl0_F
zGjr+wU`IY8`8Sz{&&|<E3i=6^!dsuSLzjTbmQ$@4uP6t(a|^=R)ppJ^AihckK7#)?
zHiM=43?^^=zL-a?F6tkPtm|*I9CF=P=Iy3h|4kPG2q^}Zn^IoL9G?xV(wP+y!0<*c
z9H8L6KW1;`D+Ie=E=o1F9*d!}jiQJ}0fNlRnKieUbwrvZ>zC`$J=Sjaa;LxLguL;b
zNs~x)XKnO9Rb5i^KPCW#OWQ-bK-shQLFEHMy#W(FLh(44Q<HQ4Qn&K<f+(lEHom`f
zPDNC)G3RnOVf(RL$&omo+>4EIXlW{I;;0P*l<5NOvPm^Eb~1XvDpY0%Ge9&Qv(Udp
zHo!uS1CDLtXL~AQ)ijtfQlCW43AfK9S77%~dFw}?&82p_#bnTqi^iw*N|(+Rjq;T@
zZns+yr*@N;SIXok9t;W0%Jpru*GocCY@5J%Wptxb*{D#&3;i_rtWEDN8I6+ZD&<e<
z@roFtMoGsBK749?lj)9O)9oE&{7K-uH=2%ZWbN3r#35Zjwt+O+|21Esq%y>XHdg?~
z9*9kS<g1<wM+SiWir0nLi%w@BTt1u$l(cM`3A@Gmnf{YP9bT6ZVarW|bUPkXe^WtD
zLccthT~GZ>Zp0<knFO+$Jd1oDmxNBohK8<y|4KO5FuVj{H9Y{ZUmF{*0;=^MS^TOE
zS(PF)OJ3!(A9FzcUYzq!MM_e1*A9B0zc7Yd@^U8*viF9uFo(Xa`K$6SN&jfNV3G8`
zzJ71t=06)u3ujFYzP%Q!R}4W02O&ZLWeXvF{;dvu<=2Nlf2eulb)tA`s`y0wvkw9S
z3H9al%nL{!P0npdU879gk2_qR!u|T%PSux@VwaH6>`vz>(_;XAc?(UD9%Ff^_LHHE
zPMhH~w%0OUnVGM#&rbDcNZUViBO4o>k@^3G^E`V27Ed^#hsWQ-F`tvX!#G%yz_|nR
zNxhF{9GDP4uYrE({hvNRrN`!(8l?ZW)x~pz3%<eL7eAdNXl}VCslg5(yt#+Rr~2jW
z59A!DX(_Uf!lcI@bW%dio#S}QnzKL05ADO>bN66ByYK<GIetFqcq<U65V`!c_&w}f
zaGqa^!S?q*0DHGrS+Fqb2j>4Mh(3JpzNQ_z-Ov4PU6FH5U+BD^z3%j6M$!M8UPsHF
zulFyfveXTAH>T?9Ry^%>tj%{81u4J<Fqg;6FIYV?jS}RcMMWi}!oHu*_EEQg{IGra
z?9&lS++ok>C*P%bpkI~KMi2h3-lOhU`#S~=9Hq0ep{<}!$HnjI>V?b7k6O;8S~>&`
zUZxkWK7F!qrPH;Z-unz7J;5Z`Hy>zjPEKhi?0*@(Ia+2tvaOP5(;M_#;XeO*MW&o2
z<4AT|lNK3+C&JAO!f+=xRa$e34i>s*mgrXJN--{%qmshXY&d4eUX(knipwka>q<`W
z>yK~k(42Rvuf8BQgeB*DYsDe1oK0y*kWeIv5gm4S4@u$lDTWBj7+G=tLJP;$QS{Iz
zH-!nG*65Pv$dUeO=51l7CITl@t}k@g86e4yVO+aL+bY*S=r6+SvgyZrA-2+M9lAF#
zNoc@sJT|#xg~HFgz&Y>gI8lM#UandIFuC4=xTxG4zKC?ayh)&E^6j1SM(OQl;AG!8
zUK<y+<5GxmBFoHjpjH7koK4wa6Pp|&27r)sQ!(3+vY}<{L4lL|1ie)(?n|T6C#3v|
z#cQ1;OA3mm!H>{NmnJcYpv%=>za%be&zQGWc9o>e+z7BU@iv;RGGo3yaeP)48H}TC
zg%8Ai0hGCa5J(^Yik!)&vBm3*TejTuX)Ip`JCv<)T*8lc*$JKh7ZyFm86u4~DX;Cc
zgwu%x5CUTF)BgT}fo=f(^u=RWuZF2G`Pu*ePfMeK4gx#&TIniERLQxGb&K|Y0tg8;
zqT&Uz)}6C%DAMpO>-2Pt^96x#VZN?XV8TAw1%@*q<_e#V8G-b`-+0C;E>cAd$H=D?
z2%RN%QVen8#*TWc0gN|!g|+>3QdGM9l955UHb9>K2|SPqr_--Mq%vFvt;-<f+%x$>
z3`Q`@RNqV%XL5F2BDG1&_UwVQg1?hhJV3QX^p|=VXt_OKx1>`8iwkL+Gs$B&Kp*a}
zy_(~yWDD5gxtvowfATEXCguKtzcBStJ$m&8fHDBIRrg)@-#`6#J;h^L7iCBcIpeyq
zf7(fXxGwR&{(?TcW^QVe!(`Y)raMsRSeZP(dP(QtgLq;dlkR)TqvDkSQP6AIC!Hmo
z7q9Aw_$2;BVadV?lx@UxYnd)mOBm9v+g{N!G>_*#DmQ`>l)DAdmmPLB1dz)br0ZkW
zy8dc=&fmeOld$M3DSb83u|Dhtb36PArWzgLYK&+;T1OX2r-KHw88W~+5(OwG%J*Ly
zgnQDUcJRWkErZ8xi%^i|j7Rh&V^;HMN_QL9=2tnX2VY~=fFJepzk{$%9Vw&j#w>ag
z;}K*-fyHs#)#^>{A52;1R=pL8^xT~vmH#;mq<i7|QUCm>eEtWWnGom`eZkV0z0-we
zjoZ0M&#6RvzkgYKdwkA{!AqA1TQgI;x~s~kF(%dn(FZ0mF>qHoJm$ZTch)G4r(R-+
zC-AhDS6)_-{I(5bYx)|kczCX&AUU?Dv$y>C$e)vpXW&@*u#M!dEF8RY35bM*ju(`p
z;K*~2MXsXrTO+@mDa5gH-;Pw7^H$?NUE=I=4^X%fqY6$6d+`<(`I0r!`86k>H{9F#
zUXeRpfO&S_kdQ(J_0JnaN(xBreJI+eu>ZMePvOrFIL(&29w0ORNpY<E_Z}zCr7kPP
z=~(z!<TUP)^Dr@1or-%0oAH9$THTtTn!^8U#xx@z2NZQ|u_}vyQdQ}hmSXPx#^P6P
zBP4~^kQ^N*o7FcmYu@CNTslj9!`7L3Y|{rnGB*R$vAT6JIr-{{c1db}dE7<tJJuX~
zN6631JVLy})`DWbX#H)WtpF<)&z))fbN_<1wHW(Ncxj@~4J|{#uzAL6kLpc?G?!|+
z78h@5sE@|P(^H*W;{*FVYfSR+N%VO-%^mezoECqO9?=dt1C<7#<r)iml6egcHovp;
zJ=Y=KkjA+bIY4WKakc+YVAy=cNa7`qW4fUc_d{Ffd>GBVhMtb1Mtl6{OvioEC4|H$
zo-w5*_}~jH9$*_#fpguu_>^)_EcOeB9{FE%tl8INvegmyzoU=^cpN<cJ7}OCKH&79
zJUB{AV}-;yRu66v+p4o4-sE`oZ$N+~(OXoYb08{c1^{V(%`k2%X%HrLb!w%5G^ETD
z*q3(2hDu%RUo2)Q;U#i^{9!%vR)-TN)c|_Fxa}{8EuPe7c`k10uy1K~jrC^Eoth<9
zdigy&osN}TW)>wcqC`sDsL^P(C{c=TO7~Pdw|fPVBfR{q|BuIPOsNma7Z}|($RTYO
zE?f7a<Jt6*5NXQ2<MTwiZ*b?3y<Ob)_K@yrw9T)C50}=ZWPkf3BIM0B0B!`Q+99_r
zQr1R`!ml;Od;bh+FKclsSNf>jj)Vr#v5(c_&#*~Y+Gw_~6vptkceJ;6#AA4{U*G>m
zv(t<}@AbfZth$BsgN{kJUQ4`I*>8>?8Nk=3zX?V%kwLG$-9i|(vVKJ6M`!jwoy^SN
z=7FOwD=f^3=Z<Kk-*>fV@actpRZtw@(j^+)HNl-gZ~_DmlAr+wcNi?V+b}qU;6q?=
zcMb0Du7gVm85jueE`RRbt=+fXx38+Zy8G+XRehdL%byGMWw=ETI*Tc$XIVkYXsCVZ
zb4N#6EZ-Qo#uYC<)!0ZG)(v6fHg4C8`jx{nW|IC1!LNG4AeKN2JV#qDHPM>^p6uL0
z>sDt<KD7<_u;3tyllc>9GR-_j@TKZ>xk9%<^4)$Z0~^cEDs)_gzV9)D&!BehM206+
zh}L?Gb?OHTpUvN2!?8v|DZ5qSjW+&#SXC&6!p~)oR}{k%ir*7xyU`bBw$B6F_y&R*
zJGXM)P!sN_x?Fwvcl}Vi*TwZFCLhL}Sy(Ak<iRUtOUM#cr+SXR4*1C3q(+a#3+p1t
z2q=&&yyM`yUM0iW?8w}cdBUd(n>Q-O#tK(cQ5gCw6b$%tTc447{$X@Gt4qYl@?zZo
zscT?q>xo+eXXdS<dzGx%kNGUBrAD#)y@Ey}Nf<T`=J{fhSjMh-UlW-x5v;PDokL3C
zYkHnJ!S>%1=jkXdHT!tFWA297sM4v?KP52N58N5zWb-#2Z3ReM_Sjzg<}dnBy|GvI
zhgapzrd3&*de)CZ!Oh~tL+K5NMR_+D@kp?5);fS&CFcwMo0!7w7ZNMm>><rzz_B~S
zHDSRG?PtV;Uif|!gy*N!60J*F937!F%~x*h`>QDX7GHBZh)p-i`3Cbr6`q-0WzGf<
z#>Iu=PybFT)E8et6+C+0Um{ezd0GY1nTz!3uAe@VzZLiSWS*nz{Y{by=d6LAtzeYw
zwGFvS3S3>F;Z>G1mx2%JKH*NCZ@aP`q&iJcG&4~6o1Nb+L3zU|_0UwVk)0xSg<pd7
z1Yd^?HRvzPsgnNfOTl|UJa*DE3eMc1oPi_w(+}Z>kcXu^f(UaE9@~0>ztQR=w#`0O
zTrZx+vX?#Jxh(CfeYELi=fpfM+DiYH6g-ONCiU95Jhw);kgSl7%Hx3zn2MfYJ5|Yw
z%F^3xg*>0(y?JanEA{+m;rFeV-Nv!=!<ny(9+UTjhKeWo&%kT{wYU}UxioLFKkMjj
z<E$SM@-L%g_*5`w-mR@lgwwUkjOyVrTJh(BFc_(pfBl_njNxqe$-A_mo7}PHmGMQX
zCpoq30^yZ4S)oUJB6l^wAFrQYg)Otj>HyviDdGTZA?t?eh+u7t43pT(@|jp?PPQyB
z&UIB|@1rjRjZ_2nFuxapx`I^gG<*>)xeBqb*N7X@Gbp)y4Fn=<PdtPdB2HvTPw-jb
zJ0sab^&G)$_AyG7uFhO179Uz3UBA(jdCK#k+NGzMsD^pgYj+8}$Z@ctbR!(X)yVGi
zRy>V4BpsuXeVYPhQCe2v)Dpw}5=9o9&dT&sh$KQK(W^O?86exnUfRayql~=x_>%Qb
z_eEOB9rl9IlYA9e5VbCk{M;Go+sVS<!S(w~yz<jfn>uW;xu(hOTUEsb+QU@N?brZ<
zP<L+mb&Ro#*oftZ1%(z7jXJ;JLjKd*RpFXz3?`5mE^~Ng!$ckjco+Poa{M8D5=iS|
zi0S5h!b?F{$LC8V4H|c2ZCf4r%f6O#rMt4^T<Ed!6B$?wc~g<hZI*}5ebEIb!{J&b
zQBets46zRX1OENSk71fUcL}p`8S;)$@Mc<?j2rXl*B{YeW5gER7AVV`wb?q{l<SEG
zUop^;Wvh%>P!)Lp=FXvUB#uOmpVE?c@_=>uMsh0184t<{R&1E~4kxh&46o=yQv<uq
z`0yW;H`ZFgm&lq8!iBDmT4QC)-cpzN)AtA<PjFZ;zD2^(Z?qsx=DG_gY_yN@Tpq1S
zBK7YqJ3@RSv*v>QyO!kDegF!4ilCORdzqdzD7sf@iwmJhn9yIaIg!5Xa@)TbSDB;6
zqE4I*l$1vwtNMi@am@s{^KJg*?NEo|?a-1oX+gLm(0jsb6vuWWVf|KwQuQI$83+&M
zr0QwGrj1}v{n+h(d6i)C3w^R{RyeTYaxAo!47T#IG%PLGJ2fl<UZ8im7gg@JA|Qc9
zP+sxM;nYRTv4NSO!uoj=cBnvtG-RR1?Jg<6D14Avtn&UHoh&__*~wmg&J-=Tes>;b
zGC<;obp}ZfmWeOoP$`xE&CT5}Qz!C8^h~*uA94@*(M7j1*OQ4Edm3;c0IhdttG>Vv
zfS@Q6sPL%p)H0|Z8B9ptnr$JWFEeRvm2dr+S2mc;-%J}1f{kAD_c~cSO@ZQR3rFW0
zy*U$ALMUmoIy82fhQQO#)$NImKA)Ep_w|y*{cbw7@fP2|zL6+!3Wy6se|P65FgAE^
z<O+yBD$hcu-rleT4%Am;FO{Dn65fl^UXt1HRnsjq<TDp;u`<elWj>i)tS>wpE^gak
zJ*1)MQQ<Vcz4I+(X2eo7Q|485{K9%B*w~T!jZt$LasbadC0q2XEa{a~8k1qNy&fIQ
z-xo{}>6l1LI4^O|40P$&tnN7Ha1^W?w>DbTVlPOr5;9=y^@E>BZIZDBHhZS2Imah>
z@~IG#=!yi*5(}P>-#a~*gd=+QMTmGtaK!n;*q<MnUA>$)UtdZ|Jnao%mtQ-3+Tj&1
z8ak3WU%N*pRJYo((O|@+o1l{l0Iu$3?Q~?zVmhXT%b9{L{^~DkvORw9qukbtK*wfM
z>yg{&mbJUR#+E@x8wro`mJT@$r)Xa_c$?7tM4s8v`ko*+VdZ(k9c{+7gNcsO!=GP@
zhn40Qh@a<&w+xHPXZJ(^;XQ{hJK<51R0fWe5#&qhBM#QKO#%D|-sEQCwMbue(x0H{
zJ()+CxWBQ6urBJv@ZRi+MD04)LHRvF)%p>97xuW7XqAF?R@96;@=*pjV+2Y(%{Z64
zg{$0_pl*F<Yz=Ur4L!krb6KJ^exyYt#cTBdP4xXav)MW`KLv%_0KSAU6*i=OLta5v
z=%W|T8?E9YSG}lb%rLvaWMi8<KJkD;-;8&F3Oag6L8^%=6+0SIa;-OGCWQG#ikRW&
z>YX#$&WR@}z)XEL*Jm3XjJW<yBvYJ2Q&sFT*qTaGF{X1?Huhf$#Aks-hqmPaTfnD6
z-Ge~=Ql(l`Omini=bp!rpoW2fujaNK6B5NKDp7ZHC?kw5$ON5en1P9nSAKXSq(>9Z
zGWc+Z{@B3W4SNt#*;VS~;9FyRv2x`1APF4JgUxSuKoWsIah$SQd-`AZso!9T{eyQ9
z?CSZ*2;W%#i>7EUTpe#<^%-Bc%$u+Iut&k#n+(D^O{HSik~y!P-#(`O02?pL2&Ix$
zlMBH_z{Jc|tO8Wu?qjW3C@tFCYvH#J-Ai_=^+W?&zWWnylWZ6P(~aX_U03R-zXasA
zK9-(50i8nv9Yo&Z7Uz?^Hb(|q3Y|lfNk<^7cmjVS9yk(~I6ohN?TEe)JfVqC6(Di;
zNwCmU!}ruh-@nnbWH7eDJIj(dIU}zTGSBKpg7>%&o#)yNOwq)xfT8RB2c@-zL(~Q9
zApv8k9vfO;X~M1EENU`MxFq!M(U??^>i^Kq(l5dC)bj7Rg6UAL|H|tI=rH0M*_geq
z3eUu}uc<ZhV$)-PAJ=SE;d{oH>74YQU*Q8d&Do0-GoFGJ6g1s95ljIR7<(O0jlI)G
z4|m{~-IY+6t%u4ZR6;=AGa&=*A~{}{d51QZ6f3-)bEtgaSN~`w&v2#}ZkUdnT(OA^
z+?0)mVG6qRBslfi4`Tmep;vfbx&HG8=UN?vfTc>*mRSkAOBxTumVF^^<=J!26+%3I
zmB7HYDc#=ksWY3(c5p4(%^<9*1PbB>yoL&~-a$gLQsOG6*z|eHV|EE`W!Q99)2jvW
z8-ZE##B8-cno^e3DB=#5TeNgS&z0@CsvS}&3xq;+zQSZOws`$(4PIp84J(^dpn8;F
zsXIlV?#VSF^qPt9=xBSCjmE0p?Xp`XzQV^<A|U?N#{7|8gzM=BHq1X$qM9V+FAncH
z8FX8_u@Mp<-q#<CzB@~nsxjqMq}=&;I+1I9+pn*!GA9ZhkeRPyDjpS1<im2f`-)a;
zVVF8l8a2XCJxw#>CPj2e`Xzg2W}5DI?_2U@Ao;@*`?wD;V`zJxUnhZ;=LweQ`=>{G
z_X8*r58bqMt=h)4u=k$woYL7nhhg<*w4$o7-x2ulhcE)6tRIqGTQ)8BLY|M{+i#%M
z>p-A6s|kcjf5|f`<7mb}-1yd)lJqV`DqE)^Rlp_P5meqJ(-}-n=VXdwMT@%_R({k;
zd0g^{uvjy5`&5EwTc!6|v0N-LHN0MM8_>0Xp*&%iCB`+R<)_>TUAIl-U+<#0OZ`<-
zX+$S^{bWM(tnZoE9*qrY9!HKrlKk=~af{He5xc2?P!u&2Nm+B|CMh-a2fq%D)_mPr
zuC=L?*w<3{RcLY-*mVX@o=0$hN#RXBq0ZGr!)+aioWlVxrGpWs%~bIGh@b(-f<Em2
zKDc#z65GsGaC)MCQPyBu^Wk8v+iZPCq;p%wdT<r3w4O+1s1STYlx+x?ph(KGezQLg
zpR)ECgaIWs3RS(>E|1!7HhIq~c1z+TVD*Wm=kWdW-NAF=dNcHHkFjp)qmKg7w$5P<
zzHxp;+9uaPBU}a-vwu3fyGgs-A>tpO^Q_PdD=Ms;f#|R7eNzxo-g?Sw%<nyaa_7sm
zNDri7VnwVQhaRBIqo`OPanWp!&x{v^#Y=wy=zts)d>H(m&xFYb_U1pZ(S0zwO*kP2
z3i+>%Zu?wZDqz=#!zK7+49R!XH9;=~o_tM*5qurY6}b+%Jz-Wvq|CVDA?o#$lEazq
zlTT#3od;swz9mIeL|>4k!?3K36zcNr+RP1_;Gh7)Pp&_#eKmAEVO~$XUoPsL9$ZCD
ze>OkB??8cF-QBeCQ#8g%mAg;pQe>i`qd@l-@h)k0V&y{qR+%z@eS>HxLvXx7%cw)`
z>LGr~_|e(@BNApWX4Dp%;w<j?SqS@RRQca;wkvT5cONMS71MX*^%qpvuKGnL$J>sE
zeK)2bp8l^hW-c>lc`;S7mDtZ+40BR8+hhtWZDGeH0=OX0K@;7sr_{*}%tz1BD+0E2
zeRg~AyF(B}7?Zo)w}lp|k~g=9%Njkob$*MIr|>ReY#X~sscLrr@>RkADh`Pd?VGf@
z3mS3wkeRCwN`hRmx~<2n#6g6MFF4qxwFnrg#j4A$Z5OLkB21}j9lc=fEn@5xzqE_N
zO#VK;GTT1qq3e&O{DMb+gTwIEBYn&t=E?K?%KhS_d-F_$)y6fv<9PQe0Bz7Er10yv
z9iNYA>OaV|VR*1Qnx%_S-Y5zS9W7O1m2oel>D}Qle(u7#<fE4Cmnw>c{}U8RE>(Rf
z{QublBzjET;J)9O%-FHLfBp;2|L@=b8x%$rcDM|O<9{)y2Z5oOxXYC{Y{)hGC&>R9
zh#~<}{egpMNhc4{$Q0UFjr%n3L9$2>1t&Y<NjUqj+vRIf;^T#PPdU!D-_vul8~a;-
z?h$*oY#O(Z(GECXMEm(D^Dqr=O}%#sZB_KH7Lwf{Q7>8d6rGn<HCfi($D@Ii&f{nk
z_JPl{zP<{KzT!+SdoIT497~r<qylHfA7X8V;Djvq4C%!O2%j!GjqItRhx%s*smEp3
z#PO6F@6~*_MK+}9w;I-&fJ<UDFfwcw9gekE5F_dX56@5}8~s#(THKcEW<T=m3(a)U
zqXLw`12mL3vO`61now#B&{Q_{7VE{JO1vVZL~}?@J0-f@v`T5cD{5%M78<0e#2kHr
zE&ToSkW*hLu*bo;Q}7d9L2|C8NaUX+sJo!yfnpJ>MrUMxTCj%wC$Hb#R}SPl@0`#B
zyMp^s%7_Q=Uu*h-g^%VqI2MiGjl7kV(l+VUW`@r{5p+%vmQmQu)eipI@WykhY6}Ir
zt*4XkdmwEoul;g#;Z`$)>Y>ce*Ni3ea1XIC6@x7GS>=d4T39do3lv1TX{YXDKW5=}
z0UpLJIc4?md|r$;kVi>N&xG5mh$fFm576b}+pE}G%u)<0@-o;_9k9nx?z?1DaEi?l
zr%9Ys+$q4-oO`P|CrFJhg9`F;SRsU`qJvun*mQ_xwQW~OhL60)Eky4ur=RNnc5Q76
zbsQHUO{=KF$=lU(a`{M6Cr5A@^ErOPOa2Rr;P<2&3!J-kxde-jr7fgTSz1F+od<22
z0+(ZMFx0L3>DZ)^J8i8|XDJHxhaXxy_7d2K>@BVI+PuDklz9`vt92BZ{sq@n>bM^?
zUog;cSw+uA-;C8A&=5OXxa$Tk$y->^MlBTRp-dODXWrNci*}5%*RJ8DRGzysy;i)p
zv5-(*&}vkHK5u2u^U1BWo7T+?s<*F%nS|_(WF`fD1=I|1fe5Kf3UeJg*omEh@x)b?
zy}#6R>^fo%pCbmRO#-^tbD=gpLXuJ-J(F2*+$f!BQTBqgA_U{?dqzZ5ft_M>%hl<6
z)Sp`6s$@f66p;imJdLrw?+o%{+O_OsIG>#i+Mx7VLXZ!+OF4BpYvej{Y-7ExN5kqY
zcWIg`rJ6c2omTNCCBlLDKNTUhV~%k*ckL3isopY6&yz4Znk(zRlhQtR=7s06z)_tJ
zA0(2XUTz)5BPH#Gcm1yd-TbKSt;p?C3r3y}ZOb_r?ECQrGXe4MQ6tJYQGcYq=y!H2
zvM|?b_2MX*Zj33QtrlU&C5Mi;HqNfzR7uev`BZGCl9=p+l|X-=9q~qvu}L_`5-O(A
z{XQivf^2z$CPb-rnix2EBjgo;CMb8)3UY0*Ysq~5{En}mQ(SqO<E@!8HCVT8{48&9
z<gp-=g&G^Yt-}||jw~LKYp!FzD_WF&Q=-xrq#3~>$85$y&~`DOQLcoB+UQ_v63sC)
zewy&oo|z1(`{t0pBM8i>T(?aS+M4XIg0+$hJ&?{jQNW-@XC}DEu$lCJgUPdFu}Q9w
zXT|nCH`h|I{rkb{@4KwF*na%h8tFYA@Pk}lMDO!}Glq)pPxRNaIlnns>5Fhhwh^hQ
z`C=7`rD|h)AJAEiQvlOen5Hg<h{QSY@6;~~)+_BYJ5eMB^t#ivBRzWY>=TkoH}|(s
z88guDw8K@AA8CX(o?8;zjuV&wEv~Nt5Pzu?=<L>K;HqIIMjh5YN$XTI7_2a@2h~e{
z*-9wY+~5pqBfwpq0?h{6kLNwNGfbCFFv&tiPo>y326>)+ZAg`4p;Uu8CTSMXQlSW^
zasQx<bewn*4JRd3#6s9Fi=_oB69r=kHBzYsVb~6;Y6Kj20g*%#K)~x_Rv}GhSLp5o
ziezb}51@4;>)p^x`uT09s&B*e<%n_d_}rUqp(5`M-3U}lkI+zTFfkcbhjalk$0iww
z#Ynxxs`ug>!ata-ochEaD3i)%wPxffFn#0YFt-R$V7t+hQhhj06iYHI9WALT*{wrN
z_hCO58X;=1!6ah+R%Wv~>olr>R8|6V4*Lr4GA!$XMq)LwN6_&`su%J?M^8y3F_M4z
z9rCH+KPk3+kBV#dV0YYA!A3ROtClEeXWbJyb??yC%c~exnn-?bBk5A1p3YE~<hTT_
zjL!~n4xlKWL+0z8<^{Sx>8kWkNu@$+A4<I@HbRBXckdDgtCaq{;?AMMz}rFYaJO@=
zqOjJbzD({*=<8DN=Yh}jNYZ9F{99S&aK5z{bd1Vi-OI~l4Ih})kfC(>T>Q6@qkHOQ
zN|dE!4Z6F{J_RTrHfn0m7u0E~0V<sX-w=`)!$blS2@H;4rCj1tG>*u8bKZ|O{@J~0
zzSO0NZ2vfh_P2c8amEX_9T6V_+7dDU?ZEe!+(BX4$rpB8T=?#I9n+Kmr4`usX3Q0*
zsVYbU6rfZF=(Uout@8Y<hG}egYQc=x>FGdYIJ{Wvisr*Yj|$!FeE!w>^3>rqM>y63
zvD?d{k0g}AWC#N&y)8-t3{hId@C}LVX6h!g?PlUIgb~VoCpJ`|pVgeg`e$dkndD^G
z;DD(Ab8c8Pu&+{nkv?~d2~h66>u)3{%oj#@!8-=klmW6Qn9ND83=1=2$i)BBaJXkA
hYQ7@;&$HadiZ^|NpN=W$zx?7q%qNRS@!^Hye*i}iX8r&G

literal 0
HcmV?d00001

diff --git a/clones/llthw.common-lisp.dev/gitbook/fonts/fontawesome/fontawesome-webfont.woff?v=4.6.3 b/clones/llthw.common-lisp.dev/gitbook/fonts/fontawesome/fontawesome-webfont.woff?v=4.6.3
new file mode 100644
index 0000000000000000000000000000000000000000..6e7483cf61b490c08ed644d6ef802c69472eb247
GIT binary patch
literal 90412
zcmZ6RQ;;T2u!hIBZQJ<9wr7Vswr$(CwPV}1ZQJ(j;Ou|mT%C$|J1d{g?CP%SsEdkp
zQxF#i0tNyC0ydxnLilGvRJZ=u|JVKhO<Y`6?q8tjKaTgGEKdOp5~5<_|Cs(ipYWfE
zKo)?&6jT^l{xSc5KL0=IhjVz68rc}w|6_gs<O>7@3X;R<ykutJ^pAlG{)>V7Pd`6E
zpk~${rvI2E5U>ab5D5Mee)_Dxxru=>5U{xaznFi|1>!(h1v)hU2mi6AfBt{tk|Bb^
zWSQGIyZ>WL|2|?D2nfbsl?t=W+Ro@-oYcQKh>CwK9VAXv*2ciy9tc=b|NnA{KoLOj
zYz=Ho{xSc5?^pV7d~fF3V0?Q!CubmFWhx*bgug&Q*s|!Oyr6C-hNl1KitJx5#DA)&
zQ)l~U|C>ReDZawl|Lmj!FVlZ^QA?Y_eZxrKSYLk+)DRj1N#F2a-&hNTOtX&{0tnU?
zXdURk`=*Zu*?oNzeFF=FhEsiga}Wg?k=R&RomhANffI#>5RecdwQ$yOKLOqx5aRJn
zq=_it5aK|ixlq4={^d_6_R3^AAdTF{%xevAl~*s*oM#EDqdOn~zsC0$ix@$i#`kj{
zF+#n=3Wp+GqXcqELONVf#gbrw7Os5Py=M2apKPjw3d8CE!XaPr5P7#CV@V4cE}p<V
z0uonYvfXY6by?G8lK<FdlIK-CMOZco>zPm9K9+ulXz&umnC-T(6)MS@OS5J!2BtO@
zvg@qC+nm+6APb=-NfL#?Ia1{Z!&qtzLf~+TZ<1g%2N%;Banovy)2KBzvpO>5?<xuK
zE1o0Ll$*;YWv*16G?$rFTk5R3sAN?TL3zuPMzA%E6@{}@lo{b?nG46r(wR!hXs<k|
zH8uRI_LXq)vYqdCyWQ%_a$=qS-X7du9(kXco;khdWFbCep(uKg7C$QPiZ{Sc6oQsX
z3m!r>9JT2=#@M}M*SjazyW`Hgr_QTm)_BMKIU@Yb>AgqxI~L*J`wBqJnH2E#;Cu3a
z5e^9cMsU_Wq+V*wo!_}xo&7uVodNZ;y0dFL&=>ySDgy!k`)@(qH@do^{Z*G!m_Bd1
z?aI3^mMg0(|Fw>lo6wt*m6FxM^>b4RK|yOJw0>}OFoy!P!oaowlKHY~@nkwyQ)WHG
zp>k`0CK&~>>0?%{oMB=_rh}|6YQg1wj+fpq7nenPz~d~W&h54j-|LRk4Bsg)f|E9P
z?3$>%J<6y_kYoIqkOvm}(v});(=Vv(4I0N%t`9_qUq2;EKj3Cu_teC*%K@Xr#N6rj
z+(U|W#F-OhK`fCaDtuJfvTq4*s!sRv$&cbiI|;l#g}?7-PVBenkGAjYm?**K#TYUp
z2MG7?W=`Te)k-T(T!iuQmgeCI)(!gM>A9AJlAv4ZqMu7xG?S$$ev@!oEt*&{Y_h@X
zsxa#P!n=(5keV@$YK0A06p0X<mN$DWl-WZcWWUAWsRSLPeU<_}cymQ)<TxsTN5KrP
z*=z&)B0jSef$Jy58|Lt$z}wStrGyKLnyn<Pcr7C&f!2}v6QD{_Meuh5_qC!lPS5Ar
zfs9B1C05S|RSUg89!N^dkUbA4yfB3`rljqo&GTc2v!{?CYHodh=7?N=kBf12n*OLQ
zoKCvSxPO`ngbE`@)Tm()+$blZ(;hZ}8z~2&b@KX@$DuIHn01{XIi-1AYSP(LKmQ>h
z{G)X=v7L4k$+D9r&0F?Mn=C&)Bv4Z*(0n0hA|pj)*HiAwe5{2F$+5{87cjKilhRJq
z+jFa0WB2vJUoh9oFW6T1GqiKkVzIc9`I>td7L~23^v2b4X_6zPI5lg_^U%aJja$D-
zx??f0D3N(f$g7jz?x7XRG1_G3F*EAG3ughF7m7jgxwb8$FMOV!7^d=a;1fD0s9p)!
za=KiW8Q3RR-`!xX>iN|rU^i;zybsIRZgztEW1gD_8|L(w^>aV+<6HSwrS^hpa1+`N
z0WXeD6+5FX>Q4z|u2!I*8AFv3tc|QM+jS8{o3L2GwXEBWNwE~6UV*sORD`&r+L6pT
z4|#nAk*4k=%PwVVmUEutChH<UANU>0u>>Ifct1-S5qJ6U=F=f*Q*O-_t|btQW@;uQ
zN#11kV12Vv6xMP2Z0mp^KPl2VgLs0mQa?PJ9za-H3$j(RyHxTksPQ>QH>BcZy+^M8
zV*@r8T3>r=2=t2_O6nQP`4iRI<Q;s50-~@*R&b24%i!n^9+KRQh}F!fwa4zg)b?lT
zf#2tKgge7uMH$wvV%PUkZmH4iRLAXF)^5vpJcRXd`rPy_YPRbx@fvrWu=$OXdq#3K
zS@g15c)I#GV{3Y6d}rq7^!6m*%opn@^toyiHhZ|s*#3nm(8}o@DL1-_qMjCnx%Vff
ztY6K?2qQ&uoag!s$9T|b;SPxeA6PEwmU*;dipsQlDL_4=4o<)rRw_6oxl*(sjM5RK
zI~~1hfl>g+*K<j#BB=~9uc!}GzP<yzCENq%&hXiLVcT;GYB}G5)HT+90RE3E13Odv
zz!moe#rwD+lSJ!$09v8KXA#ZpSR6&v{+gl5-`VxLG2+sd3fn);(gddxKZD=*&jvMo
zH5doi*AB@=vr3#Z>VG5O#}D~^CoDN(m?(Yn_0+P5l_)cqp0c4UU_g;F?HRuP@<QSS
zDnN#!>zF_cO54W|E4F`z>v34o>|M9}G>3TJ7@ZjI`ZI_l;H#m;RJx($q4{_(65PXT
zxsK&`QFe1K4D#XtifFqMUq@f$bQ5lr8?s;gc^|ai0`3J{l{24Wb&rtkNTVV6YGfQk
zPvNQfawgA4lWyE(d?;5{#?Px4watl&Xupd$6q{5(YKfmnjeJs+*}TO!8HMdRW)@7_
zG`;35pe>vhp*LB0QEC8SkjOL!x?9HSn6uO;2E%aXlT7(UMKjEA8h)NE-f)O{DM^4I
z#gIRIz3qM|WYrxCYBST#IpEENwO_*^)##`Enw6Sf0<JPLr#+Hs+N5bE>Bt!GKur`m
z4Q8wituo1UbDp8Vef^kLLjD3BI<6gNRy=IOjcz%Lezo6~AAeChbGg>MJ$(8$nhYiv
zzDD(Udi>5);pJ8YzfMYm6wn?)vmo{mPX$C&ZU6z^dG9zEoh<qmwjI26d(XHWLXKn2
z=b@{ZU<`JaEnqdOdIPYL)<GlIL7{%a;1YP-m~E2azuAZ)#xnC->_`LvX?cy>Fc>^u
z`Ja?dh^hE5R=-X}x!rs8jBRDN&o+=h8jx^;cLaucL7t;$Ad8r5K>TPnhycH#VT9`V
z$<vV`rzD|P%BcGNHY_!2m?J=x*~FD3`fiEKz~}q@!L#YZC=AfefPT#Qg2At6KrG>t
zfyFB6B?E~B`nLCz!VvR@!fZ<HsAA`MgL+>0)5aV8q${WCmcO!wBfJ-JZaFmQN3;zS
zX8^OhR_}VIS<`QU#T5LD`L8>-ELo!zJrZ{8S+?+vL%OtNBMe%D2F}O58Nb)kBFNOT
zx<beJK4`aAcu@J*KV7n%qITSEM)WzbbF8dT7A@-+rxse8Wc4gru&4ID;I%7Iab3w=
zFz6k!5P8<ul?F`MvCfZ79n&n_C7<bFPw!|2e*mA!w%0;bP(`?C<N-oj;0DkstInzO
ztxTa;aP``2*#n?*2QzU;^lHM6LzdJCg~D0JioHhhW6Q3SdmlZ>eWeiCXMavLFy~QC
z6I>9awXet&!NpUhw!{S9FUElSy72Zftyhhz{Ez}AAX0bhe7N5Mm0uZ>H0T~9HPwEM
zaBIaN`)DoSnydMT<e#+F5;b%{TH!fx%rI8T9T18%*Q4_5@L4c>rIz1td%yiF4|KPp
zz7^tTWT!d~1ReT}SuQ=D*ZlqPH1OYWwQ+ix_3;!z(dvuC8F0jTg?rVC+($t8QtzS<
zde4wn7@3wX?r3UXC3XvZR5*QN9)O#=Q{?MG=);^~^H;bL0-R+WnQ($wB`(DjF?64X
zHxEnKGNd2wg?4qD7WI|&m<ytog#^91d~5BPd;toFVqBevJ(?FeE);Cr&J#0(>#?C&
zhe4_<C7>@i)J5slEw{;ip^eS?{^0AMRPp=PSgtB-8wO^SbyDU$19cDxB9IE@y}T}W
zd(>zGAvJsj{53V|gaQsAI>EW3m<a~WAe?9zku-k*8WRDGRq~z(U|FMJdooe_Udg~4
z+{qO5;fd5J4v{!Hhfu&Ss6qPD*OH=OmZiWP5TeAb0k#Zu*xTH~&Tt7)ddETtkFchY
z4@8~kb`(6{`Niq1n+c$S%dbRR0aqu6HN#Q4b0PTV+`$^eM^t3>!YEB!$SVbuU2CJH
zt}Nx?JI0N`-R0@XCh+OAeNMh5VQy6X!&TQ=ruMnMrKPeG;b_oJj>t8*Ovwwn8osnf
zCEM51PYcUozfp#b6xn1n6>tQ(j`fA-+N7x_bR~fCuo6Rk9VJH105_tw!<)-?6VH}2
zx%HLpo|?A8f|<n9-VSmSDq0L5VIW2ByE)f)VaFo?_EM@c#Z@d3aB<G#3jN{15Nw3K
zvZhK98hLK$O)+Q<&v^O?^?q0ZbH!ehC#>bbU!_jyYXbqjgunDp_WB$1ArLcVFIt~G
zlN+fKAUH8x#$r)_#k+pe&1K|QZxEE)gyLui8U~s_wA9pE763mBH!971EXG-1fFihr
z+c*ZfMvVu1K6^InixB#XsxSvZM}nlUPawABV?m>Ebp_t&8>8VgM7H2|qGNIgbsz~*
zM(I%QhjcKAa`R$6=LW`9oG^wqr5$xy4C-0h$6`TwDl{9QGVqpvV4FR(@@;eJF3u^c
ze44l|V`;W)O%NBjbMZJ^gkWQ3Nu}}$piv=cn`F@=L9HD2NicYRK7n*<&0Qu#%}Ahi
z7Gn6mDOD2u+DNXt600|7j10x0!?JHN4$OUp_N<d3(Gy}xf+m>p6};wxDVJ;b-TM=8
zo0d?EPkAcC5#^9aa9*S8cNe0hdX1#qvIT*}U~f5t8#DU(_ccYaOAZsK&bPN_r0&%>
z6Q!ASH$q3<t_vMQiJc$y<fP%3f4ja27E<c`7Y-F7mnkax(Vwn5l`2|v-csE4b|NdD
z>}5YuZkMEww4e(=>-Jw#^XGvnrB_*hm!oWd7V(Tw{fjiq3%-IB&vdEp&>LAm`J$79
z#_Eqb#zI5EtG?yFCVr*uRG5p2s!a6sc(m%!>K&+s3pa|4efwznYYI~|A$639Qd3<}
z9Any><B4bThxzg9{JZL5k2WjM90*$k_ZcG+97v>xF|imKa*_dtd6Q9jLsz39XotUC
zK-BMR3Gs8truc*}4>8qP1J-d)*$KS(bPg>#HhC&NM3XUsAJdcr88l|lOvu|==J5pq
zP3Y$!_pSrz9EAK`n)nP2UpOMp`<IfX--nkWt}tosDEP!qnh<Fz@Q5v)(V_6lRUP1A
zIBYv~I;Uu65Xs!*ScQsSu`X1rz3qBbOH1De`!`vu+w8shJ(QbW^PXm-JiBWT1N8Hv
zrmx_W(>rB-(^0uCbFq)N5~sy~|F&X=WNJ;eP?u9fJ}WVPi}cx)Z?4amvlV9+9(!Sk
zOS~*%XfYFg&(w2S;(zK3{ZYYc!MSo?T0HCu%uF$WGY5m~ra?|O?3uiWU+q~gT07gi
z#5G;!EBzM!YWRpcy)b3}E#Ssx`^>+}iKo+wScHZnSiZk`|6PPA3(K&Jf+fZe>eMNV
zY3mLYk@p_$c@Y4Qnb~myA)c_%mwMc9fr#e=<)ORXeEI8HL8})e_%IAO%;+x$UKILT
zNYIGbUX|KXZCU9WKV4x+o$7nRqH{=52$JypRLBO-pF5Pj$EvDw)U*)`RH=-0vSs15
zlt8ZmfZ}%-H$)}pg@yUuoZgZZ`&350;j*uBoI>~#;4+(?zER6^PX`y-68mhx_Z2?9
zvAv4#v7J8ekDUFVRN-|#__@t!cU(e9Gy<T)?NFm+qS`-iYkb0|J~#gBs<<)DJQ#F(
zJ$>^8QJ&K$pl41Ovr|AN%;mb4(7SDZKQa3l_6=isKA%cs6_iVcrAW^scrGhbDtdl2
zM%7M3Kp#B4B_&JSR>TxnC)3_BZuAWWU=7vJEB>qap=4IvsH6|nQ;S}bq*qlir=h5=
z1oEG1T&HJRE};uBpMiHG(P{}nPw;0w(bD^Zoy8)Kk_dn#i$CNEN(A2tyz#opSNQ@1
z^QYJ~>8Fn#IMpZXolrmEZ}UV0^VXzL*W$(AY#67%Fy!B-kis>Eab*4QI&tap;LTo1
zN7&Oo7Np(}$K$hAzj1qY-!P%7YHR(_zCAr{%WH2<{Ni3-26pMM?0oEQ@1HL%8g_Jv
z{VvoDUj5D`PQ`c@3DI^;y_|K>;|hb3fx(puhT>t-^_{MEr}PMwa_Ut9%CZuRpww*1
zGZOcRq+JQ(FO}`iqAsE&ZxRXKIPk>~3-g8)Y9n%l$t}qj(s`8}La^W$h%cfzn9{z{
zYWcjd2(54Pm&iD23W$EuFU1=9wFE3eCU21QO)J&|*g&W4z#CnGoxz(BNU&@XAqzTn
z*^Sg1o%7a+rjuOKd58E&<Q?QI#mf9r&W%O{b9d=7NEw}&CWS?Rey8Yl(cLKT{;J7h
zZgAM|=8uyRwWlylQgK$8M+QbEbl|v`Ja}iSZF-Ols~;x6Fm6168u6yG93f=TI8gpU
z$@S_VBW)Hh>TgWqRZg2Pphk(!^-bf{yvuJ7bqg%w0*jS13%P?|JdOFCr`>EaKgG~9
zTv&-76RRcSEVG2Pij6yTw*ui4rH=r;bFHK!S?lEPQX<Kub|_3TZ>PiL_!YaZrhT35
z$@m^aYy7M}htaI)VENjP2wmK1m~3zL8)yV#k+p5E4`jyb+kX=~dN@#8PFpgkat6ND
z(zjH5>~i`VzVv%%&UOWSuJPi6=o!}Y?sC%0LwD(g1a<CH2XD2^h9deFl`hCojiJ7Z
z9gbd=KUYRyb5;WlO~-%R49r*LsU~FBD!9y$V8uSopwV&Ku+QjD(R<Eq2y>Rc2g1R5
z)*=oOoqdC~6d^N(IC2^e7@Du?4F@lODw4FP{|);lGtt^#oE5TN{0ta<5Qw)U7%rMb
z5#9Ay1fmV;<B#LjnqF*zK_pAg#Nw&F@_PEnZ_lDcI$e$l1&W|ib7kJ2yA$Np*uKXZ
z3#U{0&PQj0Uq@Kt9+Nl>tzf1RWIzrR;svh!mHG0b&}=+Yc<2g($%xbdT%i3^a=}kj
zK4AcOn6@Zb)rdl3vWyhzaD2Gmcl%ykDee3(Qh~mko)+V!Cx(ZoQkSFUy?*h_2|(Dd
zbvtyW+Du%<AH2g?qSl#mPFTLl_>IHuv&(1%q+p)!ZV^mknK6YW0s>5l8a+B}c<Cwv
zy8%l2L>!Gjz8?djKika9#?`1rFm|Ul7)y8$(Do3xvVcw0U5YjlpVpCIc953zC9OQp
zsVMl<GYphhcbE>phf?6i$~9o;bWxmVh(C}G+DM(@7nxSfAhqB4yfLLWiEL;K$#BRX
zQA-Df$$$vlL)OOjPQZQ4&5W+EdSFl8re2AooedYKOgcHpco^1K(liQ1hIfrF1L};?
zz>f|F&r|>O*$MXU9_n6ZK9*;#G((owoJk3MUSwa#33S>{IH_<{s%wIp-#7cHbOf^4
zN#@C(yVA7*^)h&PwN|G)d6dp(zX>(CHny4=UwZBsvA>h{sF?{9)pA}=c?L*K)(3Xs
z)7suBRA=rW-v#UX-X)GQ=3Jxd;MhzoK6B?BW|JomM;V@D;7uwopb4LC2ZHgTG4oPO
zXeHyEo!}Qf(nTSL_?R|Xu|7C6Dktv=Y;VoC+}q~q-|yniXNdCEbPJ6zbb=GVYZ`KJ
z;9j=8zsySeex*LzPZ3-s*~8$9u$vYMG7NeO%^hkCAl1`U_ai)l4s)uXankY3TAo^!
z8b^R`PS$zCY-mqz!?C8>Yc^*wb;K6Pb#KsPnM4ys{-^-_843vC>MjiTsHOd5_cdS(
zeDeR+Z5o8V(}Qv*W0u^(@_=34VRMI2GfNm`Be!F~t()98=Wjbi6@mJ`>?M*f=OX$g
zGIxVGVf1iDlN9crHJxR;L&k+@=*Z#MXC#;_{{hhHWow|#k?JDB-J1=9SYRpo34od=
zjGgN3D~Ses7<yB+Ef%~5?NG?@ANVZ5`XT4ic8YU-%hFHL3kR-;&#ml}yI}ZEz<d?1
zOO{e%5$Eb<>gau5pte+=g6B-PwDlW`tr;kg_}KJWSqPunh$32V#aeCiL)txPOz|)b
z>hf$<$1odo`A4-ua?4Z47^S;)j=&oNq#;A#4f&*b&QQ{g@x1I|?(``1Ib6w*(QymY
z$m^W7^z#>m!X}06<n<#9{Y6kc<De=T(<6m<iZ|9~gfNM1CFXSa>M(-nod4QsI*KI`
z^ap0y|0d@X0>NkAc~d;xwcc2R@l{dh81?G*X4o`g(FSK3K<>9BAe>lKG~kTp7UzXg
zg?}I59-}jyf|Y5MP+m{V%jUd~-)#AM#MdKI&XLz*va=9pTE>y%;izX8aG~HJ7s<Ys
zPs~7Z3cVD;3cDDbfd=J{IR%8~_1ms|^SoZ7U_Sefk%<i@s!m!^Xp%6EST1=*zKhnN
zjVeFf(M7{#{`N#T{V8&_I*26Gv*dh)Hj%<V8T<jgP8BHdv+k^v==7}mnI!%C`7?d$
z>NmjQ2bO31IbH9K@FQyfsC0jN!E=DdDq=<H5su^+=>aC_t>BO}EPFywlN?%;HOBq0
z8kv;G<a}U#Metq4yzD;r6iZqxwO9B<VXVkdB36rV`An7HnvM?qN!UOTSw&sCo-`Zd
z7FR+%s2Uw;`Z_<_?xnUp4*gf-;ICB|9u5BE?)4$jHPIoAR(`}ly~2i=_ke`VoTyk|
z@r8g8COZLX5@n6q<0w^`W8Ort3%+plAejSmWBE#ru7|Y*bL-(+J$_r=Ar`>6mOaBL
zS!jt276#zlgy&>Ex_FjPGKQ`ty<iRudwQyMCaJtZmIRbY6QfU5xwfw8u*4Tz9P_9h
z)?$l)(3(3@w1os=eIT-em=HTuU<oa`BaUiIkFoSSfLsh1i<d*6*BCn6)Y`g7F;N{X
z`^&}vmJ%dHeNc>xAw5QF<_~HykcfnTF6cCfF=vy4xW6~i1PFvIl8xrymkr*Y9h3OT
z-juzFFJ%b$7_=p!{p&F$mpgN=q}U$(09EY=<1sN6?B8t5h)ewmAUFeq=VMB2PtI%~
zry9^dN9^s0uNn+t;7Y#Y$;{mm6!`%Nkjs$P-H)Et7X?I_fw^KTl2SE+osKhO<@#(m
zWCz)_3Wd}c<IF7NFezAe`md@+45jUmXMCt0`dcweM0tz0d3S!fK6YjI7u*FvPYB1|
zAjKkv^AMp6JO%d|P~DWJa55lZf*?p-2d)M)0T;jdBOn2@knzW7yIXPG&wo0!_}W#w
zPChHWKSXKDA9Y;5*$<SH5h0bFm@Zq^x7PJpVL}(bzGm}O3-l;&d*yzXbb34bcIWnb
z_tf3^ig&B4)$a-C6p;0;0jq=4L24F_<6;I3I+}l?!EI=M42uKdm(!^0*nqd)kU5S~
zWVw?3NO@ZE*Ez!5{j2z?A&r}S&+G9?;U=VNIE~1M*rpBLI>oWDP=J_yW^f2a0}k>5
zQ?=Tq2(^#&z{>dW!pzq}ZHm;TZ-;43%C2~o3DzuVq>-6OV;?=*Q;L!By%h+U1yons
zVIY^@iW7+wZ;d<;rnb}W+?y8A@Hr);DlW5B_$RK^8`~zFFyLfL4)wnjim$!MJUa)-
zg7PPYd$z=GqBZXstU1HAC%YT}c5w{9*JPSi`bqNnZpW4nRUg_w1X+2iNIHfBFm<|r
z-ls+COx)4e#vLT-Q~#EyTY=kw>fIb)M)qITpFf?!vm^c$Q!$w3f97sQ&Z37;gTJxK
zYcaGRf566P#@y5=lB(Ex-DX;?mbFyOHP^DhoXyqfNTS}*`P6_Ooxf2tUDBsGSmS0-
z7n{EyO~~{7;JsjpJEd_ah290Ot>ks@{<yAJvFJ-FS2du47Y&ma)<yiFOzki7h0?Sj
zChyK<trIoiH%pzt9x*MfDr&d`GNJ{~L8$khSeVYZFPcz)lI5qCtgYLEO8tv1F9jS6
zQ-<WU07)e7-^5ZH$mJ>}SX7?GPlPjXKC~Yupy_F1ZS#v4r~)(DfS1bL)jB&nMP<f#
zd={-%o!a&6okq%|+djweA$P(<4#rp0j;e<GaLeDJmieOMNi1_TO+bpBPKkn6&61~6
z{<GnLuks{TDibI|ZpRSPYO)5Uw$e1P<qr)z<ErHf^iw%i6NeC|felkf(QsqW4%rpP
zi*gJ!ABtw{8qT)!1-l#58OFxeTVdhu)g26Y?I2tY6Q_9YoEBhz6t7~y{TERU+4C$L
zkodzgKQX8Dv#N^VJj+$;C3hu;1KcoMN%nkKA&2XY^y*eIfpk@CAzKOpzHbHsJ{%lA
zKNbMsIA?&0uR`jZ!L5I^XYg>42LB=bZo<V~>D|iv(vhsjt`q|(kp3mY>2bZs1po-X
zl?mx>r!!j_T5FGR7AkwWbQ@XWsUv6El?jOkLfI=%Iz+Zm*R2cwVimruj~>7Z;oCp1
zu;^Er6uF}R7D@_=^qlQe!JQ48<((o#{|3TBEgfZ$bL?s&oR3KsQ1!;7jdV<&3C7I-
zMBL-5xD%l5(e_T`ZYFY{W7Ep8%Ab;vG07zlmWS0r5VP<=rwTzw0N)d7f;b8I(E`b|
zhr3$r6p6Kb2@Y&1={Zae%0y6Lp|XnPwZN7SXHMh+-!S30G1K@-I57}5XumJyX;+?F
z_fULXca;6rAX@C2qV430Tk+&iQPnK^$e}=ls!>y#v7J?-g^Z4FUaZWnHbU2^{MkYv
zb#*RH;fZaBD()?dYpa&)r>nF=)vSAQw-Wexh16vBdvnf+Fr^DEP+k_mVM}o+rVVS(
zm7h{oZMz{&)2Ok`AJAGG;-Sv@g^_D@?b?)~7I1k@dT2s}>+M>m+5Oq7*t`uHJY^74
zqRmtTzucgUzlGPAK6)8ltc8RGNrKy$s0fuko(P_z()XTqy+3$3BtZLcu(d3q{>5(R
za+@N{;R9HUx4evNeb${J$qEVxjs3t$CS3g}h}7r)E?o{w``R+<6=j=#a98d(kD6@t
zF-;ez-HzPmu67Z6b=SwbMlJ3JO!y>92*usE(+WzCxOhZ25t_BarG{uivP+rRtGgiO
zEx!>%9huW{ErEEgkMoHXBmHe1X>~(G(8}0R5JUU}K1{=l37eRR23+VX;Ha)D>KQ+h
z7VsvmHKtBo1ZhHRK}?w3?{_cV5nltx>j17Tug;5%Md)7><#`*^^#%6GfA4yvizC1Q
z<dk$=1C~#nWX1>{oiYx`4DBkf@{!OKQ;&%uD&3h#r9`Qw(H=Wx%o6^Hh|?A7^LNi-
zPH;EW;agomng-d&??4vaZ(1UXB9ET4x^|%FQt5myUDf{~z9W?3R*!a~_>MpLjKZ(H
z;gS@b+7H454b6mF6C?9=Y1I0(l#9>I%yXa|%kb3&B&i%MKQPqdgPGh0pSZ5Ve4W$z
z`4zDSue{%{`_O`@D5S4OeR;S1r{X&nhPOX;F7`rq*ekcK+nmpDxu38nd{@uQ{wRP_
zsrIAcLz_b9Tmru=w&RRDohK=j<7rSb<tcRS%F?^JX+*>5LL;15ja7LVFH*GVOBJl3
zjSr>YZT@fkx4G&UJi{N;J#YT)+HZijm^;t`0+Ue4*Zf)FnW^Ml?LMhRfntTip-p`e
z<}Y{E4N>MuMJmzAO`~#SxCw~_Lk4yuaTv^{UBRz;RY2rz<lb)z;jDQ?^n6J_97_qM
zGJF=a)<yUnnL(^qSndj;xC#79eZGx;y$cGl-ya2J757h8YG{{GXd$;SCalO>Iv=DP
z!kZQQ80W0BB0293H*OwGGTRk<y2bS&(iV)1cfkpT2x$0{$10#y(xbHkfv`xeF|m}#
z_fHZe7qtdekPv6TMGJ20m9iTJ_q#<Wl{77*fWp#?{&?*K8ex4{B2pZ)beAZ@Sh^3A
z=JlA0C`ck1S5A{<R2jQ{NPT`8<To%$_|vFRuZM7{_?&cIi{Lgk4#n?W#6RnDQD4UP
zIPw5QnUN)jW4INxn^W6#iq<?l-kGtR)l^41&t3|dx4$hFdp+|Cp%;XoUkiXWo>oyf
zT`Kj8ZG(W}x6~7J#cn+{KOzMg<PgVCS-F2_0xx)JhN?D^^_uZJwce@k1FC(JnvEJ<
zSu<Lpaag1}9c%|e_e4-RIt?#{=blhyF6%+6QqYxwiKLa3y4QtDI;C7>${wH|^9$U0
zpk>h}7Sb*T6fx(`%N)E7wQejZ4kj?A$y3lp**B6F6f8;*jY5JLIVv70!ZSB!RJlOC
z_OF~^Q(nYbR8eJ<!S*5Pn|HEb8!(<hA<i!#>C*ywTfnjV%EgF-TA<*Hsh&ZfAfb9-
z3I(crCYH*Q@<Q(_iN5#4CYh<m*&6k#hg9<*lf^S8$hfYL@%_5K`IMBIae%lg3PbkP
zY$h4(-rpu&o%*lr`vzmLA%c$Kqxy+>=yvO<2Hbg%p8UFumGDl|rVzk&B5T<q06FF~
z1S}fW$DQ=%>ana&4Ed>;igZ%)kU0&F!LQ`&@Qs7$^2|rv8FS7f70>-_Fj1QP2Bl8Q
ztRac^3B=7vFX-L|&0jpN?pX#WcZ{2d(>qzc_!6_g1mKIXi{%C?dcFFyxv(wHr;pp(
zWw1WmhCh}(08Oegl?^LPtML)ai_NsALA@_j5j1$(!Q>K~w$l(k*gRiP;;t*4yy*EJ
zc~>tX+?l9o0oXEH^hqd6>NL$GHUgr;4$!9&Uh#h$d$EFNXKeYLJfcF35S0Isw~)`F
zTc^H<M|Sfi{@?f~cE(tM)>5nA<HsH7-)hM1mX(uSfM1fx2te2q<LRx=cUgo{C*$iv
zz2{SZ3dxCWh_`;nKSoq#J}Pc||EVwYu}a-`BX|gw6RvW%=OI$fK**Np^kL;5W1cPq
z!xVt#n@XI~b5k033$<A-N*IM@*r45Od&@D+5GDAYuT}v~9NlZ+P$$QEVhSe@>}u~e
zHM`jPXWpxUb*pJOC@89Q`e;5A^zVu>yB^`Zw+Q;Ui>_wVYvA$YNwplp39{wy`s)=&
zYpSrS-fA@E0rIo9N7WwQvFIaFqq<A0PkSXt;JU{4Ijm#Zz_g-9q`fj{VTc`DX1}9q
zTe-7}ztyC9!mmY1XWs{p{G-!)_rpG&YJf5HSWwHVw;mjxJ$pRC-T{oKN>HxXnHM=u
z@1P1;zr#?u&0UY@TEF4N!=Bo$tGjnRTDNk69Q2Q%4-Us}^h|V5*!CrX-eG6UFfy9B
z>Ql=$TU!b@0zuyv@cNRC(N<RBP0fQEVHg@$A#FTarWoakLv?=)VTRoLJP)q&!F6*w
z*l-S8-6l)Wr(^6cyC%#t1n2e++efyb?WReN<DH-1*Y@5x-O*F0wbNKvft*)}DB4H$
zoADB1FtKadgBLG;+V&_qzJo5aPr7fji@knsb_TH5r4<L2;+^k=D8BXP0N)-P1hh?o
z!?eE_kQck+9PcDqQuVZJ`7PVeY9KyLF1OjCTMLX`O{?E&n7xkMD_d!dOD8iBe;2*r
zas$x{Nlv$tpd6*pp%p|KdEP2IwboLmMmVES7HW(sep8XSabzFh0FEWY?HyOMYbf=N
zl<A%VUJ3~_$%>R3$~1%4WpjB_Zm+AY%*%=jJD>OM&t*G=+X62>`(JFtq%$`07fDCn
zZN*iO@@PQoZ6xE^TDASj8R6u|;dz<K#yrM{P%F#6JGEqCPlUR`wVy{NqOq|1=nw2j
z3m-57V?3hZ{XEU{iQr0LKo!tVsZ)iJky&w+qIOg1gFLPAxEa=`N}`^qVxSx^tvQT#
z=y>_r;)^KPv9Dtfthvt`z@7|m0I^PKf7(b7cgi;O40e)V4lA739UKxIa7f7=88u8K
z`cfo-U9jK_v$Yh%Mmq1AoKDY^?Ab(}Dn*Jc+2Tu3Vl^xR<|UH}C36fnF5jPh+IyZQ
zy@bNm?1)Aijvc9(K#q$7UqTh}1c52;rQs2yy%Wd_uwj1n!z!>EQG)P7o<9%dzu-~L
zGuP#Y7~~r^Y_Y56DOm1T4xvrBt!+bvXJRm?j(@xxE2@wRzDOG*#e!%Iq*_8l(sZO=
zBh!}O59+|`d>c3TO)#n0@R5gmHVfW1f@W>5{((U8DUaQlQAVi%)=_&dlA5u%iR#GY
z4M^=6$=I%BSmTzVHTtd3jj7jr^IpF05#tg)%w%{!udMGwEJ_yDSy0U5+OMw3yDX&I
zE9RPv`qt^G?OAiB-RLwvVH|HlfLcgS*zFf^9bZ`DAKw>=0=_m_Snte+T5OgdUtEIh
ziS(;5sqJ-1=9{DR$K-jb3EPog0nE6Mg07hxm(TaGXm<CJ0OxIEcg{>Q>O=EcJ#Y2v
zQ8o&p^D4acUd^z-qp7poMEBF1jG*Uwo6-97QzKJgyvaQWArw7Dfo09_lWbmuhH{g;
z{e4#@Pw})|!CPT*!~9xnWnrnIs`A&P@}WqDX-Ktky7^KV?E7scBi|42#owM0Ls@uH
z9p2l*V5DP2JwRp?Ks!R9E7U1c;vMMtSp1J=CCM>Qg-A5JHwNe1a_QvOc4<me;I4AA
zVRa(IV_4X5(a|-F-&@rt&ppy1V%{+PNN+HUxuyk`>O9t>LZdMI78RnIbFig`1xKxx
zB<6*<QIjrv&JR)NGo#*6adQ?|jFyQwUpS(qkEc4Ny=s`eS+YA^Q!x5*G6VQ=m69Fs
zsr3gj^l7za|NOopEL)XEzJcm)O*ZHXmmQMHd_d?NQoaVuMCWfy-4{gzR-^uK1TSOu
zTUSzy;D?gH9j;6<{Hg=OV{kdYj-U;<`9Jh;3t5(M(jeWWHCUHM<^(BhD}bTSj3w~K
z4I$qlT>%(R`Cg-!c+x3<!nt$~ZTjzpI5zRt>Jh^O@*%%*TsdYL!VN;|vTRCWR~Kw+
z8`bD-E9<H}ig>!V=@(Bk)ksGp=WRT*UBYE%T?yaYj>UEtuh$xpyCIRwm&5{+$0QIR
zh!?e+q2gbPu><TDOFga(X}`A1RZ*4`1(hwW-xn%8pW9C)KIAcR7M{(a+unYQXz_6<
zYxosvf0+TN&>-~L>H0`+r)FP1uZGP5yBEb4z@C<Git3(J;)r-~<1vKGwuBl9vVGII
zJsn_R>L<i>mQ;6`9{c4KUN&D~q@L2G)oi>KWDg|-s;R%<xPQvsuX*i5!{T*6<GW32
zcP!Jd>(8gSWKH?+1J1L-P2@mnsVI*d5Kj%j_9*Rt_JFY15r5?tKJbtVI^@g@#=60n
z|EmmZu9sh2=9*|UKXkl$ngAlGATF>K<UFUv0S#V~b0FxWJ&$@g_cx3%nb|;Vf5C3F
zG@ZK9ZM_iRU)g1-(caALG4{=wymGP4XukHXJq_^N_}B);Ed{pOa<(3YO0pse!5<wn
zV*hv>C~LnR`Q;MXbX_R=w|Tn^;?=J8>}|)y99~nvZIpCWZS7eFnPA$*dP>JU{h}n9
z;rYmzL$o#08Zhy8MQqk!Z9+PZxcJG~bKqC$vQo2idE<Sd_tX4_0B=YFt;nVOT?)Ce
zIUn~d0x9rQdVty7!G>bAM1U|{S>~z<yQ)(7R8jXLtGPjwj^Nm0F4)u#vLqJ>M4{aL
z(PiokZ!Sf1WMCJky<^5AK^j*6rNFP(aLxHZu^bv?8|%%f-X%5lTB_i1{{7tqrSNHz
z=i@`jH+gssph#tVxaO^p;Imtp;+^u_|M+_Uv`7`oSKv5(91@9^&(TiwD_oo!v)KR#
z^iM6A!p2J7pn%FH4auwzl3&KJH_#O4QMOl$Xs3*nkZa4>J><YQ@UP6tLhRnrTSoqk
z#N>1PELYbPjwmSA-40?PAfty5fNxkQV$gK>c7E8JTd9`G#7U_xZk-s%1+nK6JaJzn
zA@ud0tyF+77?P>wclqRgo)=nx3(M~6Ct~>BQlel)YHwDhtm}?wDjDjrK8=4WuRiW#
z@fDOij;@{(LwG8I_5OZD;adUsNkoA<L>5$*if4_`M3BlSJseQxjzk+(!P#k0>;KS<
zlK<<$kCJtqm5L;6U-I8sUM=5pm)KAE{Q4Y&)D3>*yuA*YEt}L0X0+>(t$CL&3oiVt
zR475#rt^?~Iho7#A1U0-%A^Zfw(|1H3l3rBY`-~Ug@?{M+r9&PE;>*^SCqnr93sDY
zY7+16qHd%lN93nGKXn%2=bv*K)94u{GCZJkg*3bipIs)ZF;q+IEDNS|vL6JC7{iXj
zWg~X)jXhqy1)mBvyE-~Yxd_jA>nbw#3pv2g^8!xiabzm9lnrQ23j}9s)F7nw%0{M@
zr8|pTH>%O;M|&`&UG*{qvWqQFz+eC@k)<tZuE^n*i`v7EAGx}iZSej8@(5=`1RSnu
ziNAh>ia+%0U9_0st&qNfv_IpU7>tFg1vf<~i1TnLFpa^rGO7?`#qMWXij}P=S2mG2
zIOswwI0*@{b)^%IZO5q?8}4?X>0ynREeqGBwE=L1sycEaw`|1SAZN8^`S<B7&!<BE
zTT7Om+pcH&R`K_Hj!(<71D|59D2kXaiK_J=c7)f-m-DF3?bW9GR_i0>Bkz4UD-B8b
zk(d$*25#ch{c=n9XD0gPPN$E-&(<ofJLh87<v|TzGh5KvwK<K*?I~?C65jrtinO6{
zuO|{7SF#uc?LxmA#NUYNbcBU7UujJ8;_R{+XtMmm`Alw{@3X>S09!illP5_`4IN>1
z28wO;ItZ}SpPJ=uicjlVc<_G0hEn_$K_}l#ewej$%o_wfrnhO_*7hZX4nGnvccW3Z
zIGznWnVL2q`Aw&+So0T4d;a#i!>}CO6|dSK)kd$>c&I-j242jJ(rP);rviu1n<tD=
zWTvamljb^apWyv>0~zwGBOz{l%+1_8c_Z)6y=Dr29VemPatYXfTlMVkk!uY7BE}P4
zRkG%P@n}U)yFlP!#~6@kg4y(eRUCwEI}^s0loQbMAx(DTCE*mGG}DwK0>N+hlbM-_
z(he@;)d3b>;`P?*XnIf0gtI!E84MA?tm{Yak~69DT-e2Vb+HuK(lwF=8qV8W6whAJ
z$2CN@&XhI)oT1CTb<D7BEysEt-j@N4g$yXm3Ww}p(kZajB93m;SEBm;-dVd|I}Ps|
zE1Kl>>8)WR=YqoN$F|=~&pXe!0Kc_*CWrNeD8@G5l`HIoz0hOYoQM!F-i@;1Qdtk{
zygK`$Np2?tt~S9&K3T_T0!ZF-I+<QF&Yi?sChrR`v#g71-89u(7eIG`HF30bY0;WK
zvAr<}Uo!oE`r#F2)cZ+B&?U$97T2uNZN1lt%~rd`_TJQq-NCy1O4NI6<m)D7eYI>)
z-BZaseaq2627lTlr<1|L3d>JP@vLv-8;-5dy{4u9I)B3Xu@d$&&=sje<fIrL18mI*
zYj&}JVzepbOVWgmCV7S{Pv|2Sv|8f?8C$tnd1BfFA5!xGeH2749QCjPP4Jj?bP-55
z3oP6NaOr9lbTO^ziRP~Q)N}P{m+?>p+B8T6DETG?u%L6)pvjjW{A@8tnZM~2#WB*A
z=he`PEm#?tSWvQT*l)0{D<s!g38CGuLqY*Tr<UnF9(<RX!N(tW`_r7qdqU{<BIE1K
z2KbyRaUQq*+V0#;cG{F|KCdHe=h?wHo82{aUjG;I>jI0ogUbqLxsg}X7UgKwTmp--
z;3<3P4Isk;iax_&C4r1Tze%pBnkfen*x=UiKMnGkmyf0BvJ|VC@^$xP_&ptlj|?vk
zB<_(64e_T4GCmXpgI6++w4T(KybfQPO6T2aUb|tg#a`#vL|y$Z**bfcg}>1+qfocs
zV<Ha?SNsiYNW7+|3Y7{LPa`**Dh0gvxW!OahJq{$=z=FvQo-#rh{YSCVb~hHuOQ-2
ziqsQ|T8g*O<S7G$e2Nvysr0$Y<w6wepjC!cU>)yK1Bg0q)(|TCX7n-YbIS(F)9FKi
zQ-AJ;^1~B{f1@8A1VXd};Hzkx_*1+%ogUA1L~y7C)XDIjCGA<b@i)#x)`}H82%7#P
zw~(vwkdT)scSMqi3uxGf^33?1!nN+*9KIjB^?J&w0JK*58vQ!ASwK`8y8TSubp91-
zPFK1y+Qk(CHAOdYgWkJ(za|M_|9-lH3=;5YxLHSiZ-2GXrZdLD#h_q?U71;-o1D_^
zBue_dHuta8*{;*hmVc+_p7C6)tVdceK$(4s<Q<Kne|utE!Nkf)$r3@x%apY~aW^Nx
zwvO}hZ}~?ksf-9qxTQQ7zN`JfyK(>12nb+G-biu`PGSCiQoQkrAMK<avQy`2uO3NC
zWj-|W>Tn-hrt1&p-YEvqPdr#Xx(o_Q;!FrKvP)na2JSQOr<QD}?bX0qfZgH~UeDh;
z9r41%%!Mi^PW^t#XpH$C;|6vGXbrO4Ch$i?3xyn(){#wz{6Q=n#S2~wJ*OHT9N~tq
z{acb6&t5?pQRs`*KNt~r0Q~*Zd)^c9Ky)$#Dar^Z@?6QgLmLj-CXLaeby@nOBi4(b
zG!hP#3T)&*wXd#P3HnP?-qn+*NkeLB8c99wGY7G`;D*)H6qAXQj0|Vz8oWNg0M>_>
zPWSL@#-!B7LvE_KQYKl@;2dt&gm31ZK2v?B6f*sCo!YB~W#o-0e{EPMee&FNw_@6E
zqH@k2r`+{W(YyXAr<rkCF2SK+F`0#YoRN+E-8h}LvKtM$e_)9LP1RCFV?V9UZXCe&
z@3+_@f66wo97n@6R_~L=Ck&^lu(>imz>95A<{H+$(u7=r`!u)E6p!gGk%G0fz&3w}
zZq9GtG-Sheh5)Tq$KdYxURw8FpL+3Og>X}-bny6{8)aG2%l-8}Y5Vma`x%fRVf)el
zwA&)G_8C)?dH4A_A%^JZrM^nYlMFn%01h$r=xN<}m{z*=>+)6Zxns41#PyGzlh^MI
zi^rcY0oxcv_6~Kqa;N36(r*y%8&9pTlk=<Oj*iMxFSX7?1vcHUM^wG6`StFy={koH
zub54uNr*HoKj$hsu;phbrVX?+htO^ZXQ_MgL9wYCI(>X!*;WEe{`3pmzY(S!Q2^%U
zIiv@KBB#R-m*(-`UnpOpAs){H7_A}UyXI+$*Abb&nlZ)+Sj0iql+7~uojQaZ3j=O%
z2H{h+y1V)2kL#A$@7WhmshmUu51K12QLd%NZJ&}9Hx0>7F>U7<%V){0R;zc<*Z|>B
z=OwFmaxNGW>V?}iwasjMKD+pW^5Z}z+85#MNbI3k%I|oUYjMXj#pxr6u@_-gKdnmW
ziTI;nHQq0CZ3XjC*H<f7Y2lglBG@L|lJAlt6z|9gd`{o*XV{B>Fyz`6m7L$Y9+##E
zGUHloSSF0J<m|l4Z!j#ymT1JJBzmMl`~l#Cj_Ks)`955&dip0HGp5Z3ESxzQ-V8zA
zMcWkA6qxOAJ9HdT%7;zjK|x4ytt&Q6EydcV(1Dr_hYW0AjfPp>^%T}wzGLS&t<BXe
zFde3P_zqa6Pf~^0X1CqxZL*QZws4%<@C<oG@-`V5dpa{Bi#Ge2;$B&An$IZ=)@f6L
zOqJwvC2^;dasjNqA^AQ{p$;r{;P*Ji(zo@^>YR@4>)WkSZfVw5O5aA}znLF}+3v<J
zFBE$7zfZFYPB`;AKh1sSR=1j-=c>efqDr>>S9+>=eE$aY(?XJ_>Gj!dFl`=m%F%xx
z`{{TH^b+oRC+Iu-S?~~&tK4Yzbo}(!VioRh#_3&T`|8vNG+z&}dOR@t^DuvN9wI?V
zg>PggG<R}5Fvitf2`8ji<Z=z>cw9$?1^1T!q;uZ3eM}Y-{NNA!eGOD*);wmIt##Gx
zt@O_{hjhkn4sVZamrJd4;b)UsZYouUl`i4nWvbB_Zi7$-YH!9;Rm>ro0L>G9ARpuQ
z$32m>%=c?4lwL_6uT}fT-7g$+le2T-uZyORq=36E?S7W8L@6(>>arC%I2c#hInjCc
zPhzeutbUY;V{o1@Xz}ow+P6GU+tcPCge_8Jl8rB0Go^c-OgpzHw7w`@*vV&0z(EMZ
zeZ>Fa48McDd<Jyy<j!Tt0=n1Pg4X;;nrD)28md7zt-bxFK)#NeJfDU8jVQx97&B=+
zS)yLETaA`Cteza=MlabRN-k<OJ1s{&TIt8#hwfy93fh^GP9t^<k-<bdH}P%QNps_D
zkFE&}h&z6s6z0T8JIMo}>_0uhi*(VVL(7a=WCA&>STmpQ8nMB5hNBX(ai`ZThK7o8
zomP>tjZy&8lziMPYKX&QKwij?N{rbmVG0BUcwc=$`X^I62-L|g@MV0t!d_hy2m735
z+_{n4&Nd2_)ayitBkSPO0PH0t*RZK4;<J)8ITc(>p;9i{S7y2Km8x)$VQV%1;8UW5
z2dD|1UCs(M*#5ym(_^;M^m~1Wu_{Fs3lBL8aVkH7@=j^cwPI%ObLN4z%;X^G%2^Xk
z8s>D^xRH!>cuzTEEW6>z?wi<5CfD*^?@EfZ<n93^7(J(J{IzI&*WK<NC>9^huN==u
zMoVFY&NL$AuRP42cfdkZ@bc|D-i-dVws{L|nAJ^L<KziXO}Dtu;kZ^9sp=za6Xdeb
zdNc|9D@eVu?^hOMS$|?KwR(qk<tYwz>R?Q#o>SaUjclE@C$^k<d1`C(OLNOhf!d2_
zmzKf1bKuWZQP(KTL(lNwquzq}#tWZ^PO3)3<<af>oS2Um$HyxHPIGF=j#w}IWJ9~V
zOoZ&rGTGgSvz}hZn{i+cuoo6%L5K{qd44kSXInV<iy&;E(MI4|d+xXzT@EDG98w0V
zvF?<L?u4Lpx8nBB{HO$ep^uhT)6F?!lcY+DmSMbGJs@meeXg=Rpv$wngK%5$A^J88
zN6;#0;)A|^FWT6wsFze}^Qfo!@&kR<c;!{;Z{d5ul4N>U{&$m-PjAG1j-we@!cH+Z
zu&)`AL$0CwFVJEO#rPx@dVeha(imjUt3xp7@N)vQSxXE)YQk}OPA<p1>c_4=lgFr4
zScK=G7WO>f{Y9&dHxOqsNLbnFVhEH;HMi04&%_!Zsm_~Xfzb|iMlS|?-O_1}AC{%i
z5`Bq>Nciq<+!{%YT_uGQh_eb@N%m@<r}o!dKp<G&LH^`y!Q0ZJ#Es{VQ`ky9dmM0{
zYDgBg55!W4xrqYJ0wZ&VRYZn*>8$REaPh3QxYr8nqtw&6tA#=)?gMPl-!BN2&*7%>
zo|^j*4v`|M3b!qXu-fwZxffw0oo?zc!!6^xTf(%8`kPpu3!KrC{&$D<x+qgtj#yKx
zhZy>fdHsssONQQgCJMP@TodP<(ssGS_j1{?_=;J{;!XGo;$WZJ%sj0V<Vf;ROR1#R
zXp1K(wArI(?L7UEEE+tWWGakLgP(UNJ|6-n@15U2SM33PU1>e7Pwo*>ksrV)gdLw)
zgvQxR3iv<PW)U$sOl^EKT2YX*P#K5t)!p-1d5#5_l^Nx+=jX@Mtev-+2UGMqTCCma
zv&R(~WuWJiaZj?VTxE?s>}vVC2|j9sn(;0Sm*XL}yX=*hQ0nabnrqxOhi#I|EA|Xi
zSOrVESbP!nNj}~1Er^jG?P8w$<C1R#Y_X|^f5aIVYz^5wNwJsgF=^sXU!vgnaN)p&
zSvw9~(xKdSw+@6Nw~v>m`3S|UG$iS8Bny0FIw$m+EQco<3*>Nym-E!Zcm)0~+<4`R
zlx2av8>I<28>4pYJTFbp@2rHjakGJX(KXA*ZTf?pfAh|Gp~wjdi*~V{f?N<`xwy?*
z>*nU(Xr#-+tFBe%_IXS?wwqfx{|^8$K+eC5Fj$?lA2}clT<UU8?>Tb$Wk<SZ?Ycdb
z>sjW^E+8<7vZC*=w*Oy(ExtSw)LcUgYGC)olC0f+%FKMP_60olpB-<ESua+dd@VwW
zddX<t4`fUdz+ounS0+D?j+yGzS<rw18uE17ixW@#Wuw5cM*F;BS2avd2DmFf2833?
znX4Y36xT)h^Hf)j2?8)45dClAH6X%CnGvmNnc}@JSaH;cE0!l<ZxY#^54&rnDyb!d
zwM+u6N|TgQa=BcQO}k#0XwqAzkIs3%M9r7xIx~aLb!Nd0cZ{2BwthNi;~YTZyb|E*
z_({Mvq(Lp|W<y(?rGctn`e;xs0rpsWsGea)OeZs&DXAYyqN5%m`h@`+GEPU6%0sJ$
z<BGDDemmgsTDyHM+6+!`97i8et<Z_IHjit{iZneWRS!cha2)?=Jx<m(E=527MD-z|
zQ5C&W)<jn#i?Y>Phl0S$)*7Q47?$`!si|o5T4WyIw2c|o`ch-OqYZ`B>ZH1wrFO+M
zJx!!Fr59B+YuU#c!eezd&+2)lGGrOws!LgG?UVGSc&>J}vf-)-h-%8D4mV=W8e<2A
z>XJ^-b2}TAv)gsa=qyhF1KgR9(uFgkUt-TV-3JSj5}K(*IOC&~mC}pEXv`s{qGGH}
zlv4^l3ac3sQ)(*{jU`!>1hksdMNbGC1+<vUf~_<={FmsDrtU#$dKDRRG1-4Oc3qj6
zi=`0VQ469qG|(b5v_OUdx~M@t(Irv(m=c6k!a2jla3rk|ch=>OQo#VAA!GDdr@Wu6
zOUf_|g|^F;g)K#L!&@vdh7fqDu}8)W%4Re})(JmU#9~7Um&P$-HvcHA0gB3Mag-Q$
zWix3p1}Gn8V6(h*ltgC(y@>50QO1{}a+{Qn??EgSxtO3t$d#dVX*BD~vdUrCqwVZL
zfPAIWkU_htjU}=TfUjq0R?20juS|+fNG8PC&M-#w9VHni0w2qiY(GjC;-<_(X5BIh
z2`oHyK}-A$<D+&V;cvVa3z>zjA{GQB+APrq8M_Jb5Nt9cQE$NpgNU#dBSHjGCm|xj
z;Yy6eYBPv>A_>UqAi5O1C1m#T#0w;;gpnxl#HdjIv?zpYf}$vy2qt=Dl1RuZn0dWH
z5iCS+(hJ07)ftd%(;>Z}(-EIRsg-I)0T~TuY!R{905uANjz|Fm?~w(bM})VKmNroo
zY`8%uSVRdrBw^la(b>d<=Su>QfjAdYvx12k*$|N=XdNc9*&KwH+f6)g(qT731d$qo
zFfU@Sm0~4W2f2vB;=rO!r+0~hh_Tt^AVRIqV3Gx^PYNqoFiKeP3XssDv((!Kf-$eh
zB0>%<xCCN`al%M1Vxvis5WV(qkjx4dC@}GuHXeo%NzI~F60qPQH3EU22?lJ`NjgOT
zStWx3S!CWRN<4z$)=PpQ=uMI+)DsC4-i2jC>}G?FnDj)(R+oJI#Qj7eb`eQ>8^H$N
zC`xpyFmhT2linx_7#5R2ta=M?#xQqS!90<aTFl#Q=qx2A^?OK01{0EWqNr1_3jtWT
zkj)Grg<<IR9wHd2C0fB?zzD&(VkC$>;%y?Y*I_}=i+Y8K7D1BDIvcNZitIiB#>QGB
z==5f@UO*Nr5#4lRttQ?ocwj6IRKday73g7v+yHkq$f~m-lNH8H(n}C%;1SF#@8E?R
zUQZB@B^?YX47b$_P0%BYB-r#k5k-?oEHIKw?vW6(K^Kh3C-X387MMm9i1ElYm5{g&
zVahWJiK0&rn;Ff69Zfa7;N%I^COK^`EY>;<y09pjMFWOG=b^6+yrM&9yOD@?kr#9x
zOzNybqzAZ>?7YrH^cbKRAOLU$o7n^{P>5AW2<CN7HbYRhVJkt@hABWJ(Theil7(73
z;R%2*5iEu{xMZWG)9ZD_uIQ1V;}x48YBCZVHW_p}NfI%Ps-Qzg9-E;Du+k7Vh{DKi
z;ZH+7fGn73YjrTq6w(M(0Lu!C0zh$%2rJi!^@O)UXNVzTu9s`9E?%nDF%1dl8K-y)
zqnn&m8?ub$>q}a>REE_LV9vxQI2*^lMd6SHr(63Rg@#(;&lOivJ=M+8C_WZ@2*2TO
zefw@rA*f^b6q`-`&9{UHZq!@l(w)ffA$jBqs>zCvZFmSBh|RqH8I7?N^cx$D$A-6%
zwR0U@^*1>+U5;8fT|0q#38sUn{5!|DT*v!)j-vi*p65ouMI{RH$Fc^=%=E+GNUqHK
zq9!o@Fqwza-vZFzHwqk+Rdq=fQ+HJ9n0+fMA>1g}s|vGlcZO3`g?<D|;F|bfHP)$0
z(aVh6af%oH0liz-7#p>P$!3nqUbeFDl~j#E&{?)S6><jIcL>H`v10lK0gf+yTZLZ5
z(~qMMo`JGI<kt70L5+=v2K&|vT)xPu0ga_HM7uTwLqL^J@_p+yqu}eSWl!f)+bon-
z;2ixjke;1DW#&_cDh5gAj~Hoov#byl)5e2lWU&HKA4M162c0f|Fz7z@QT5UL=m3>I
z26P{~7y=Zp$rPt|X)F!87&5UhX%)OtW(AD=ZsL6Y*tlHO2pG*pQ?R;O3R<_IXtI?Y
zvvV$U)41u}3~o8MmT~kcfnw9R30Z1bd*ZKHmpF9guURwm5lm)@2@ykHTuOnLK6%;g
z%eLMm_V4VR*(dO0KYMNHTXOrIw=d~4ls<bsqS@vnD@zixB)E0i?Uy~dROp-8xwBuq
zNfUs?0EJ5zp^KWD-I2Pxik3+}ku4;ce4$!j`ciiB@kL8-6t>@07jZW?q0KC^tgCjP
zxK((M3vx5L%S#qhfE4!gjBEo^Y}B|*29=G!l*6)R5h3EvaGEy0w$H>$b^uBWWR%b1
zW-j45-)p{jlb-~Piqsyr)_6_zB<MR)+Zgv9@)c+JPWa-nx<fwSYqgEzQ<2^09a_Hg
zhUF)guU@@!*UlBMtr+J=xj2*_AoV71jWymbDMoNN#eF}n^&a%$KY_znd(anyM78x}
z6BXZlZ~4LH=lyv3&Kp;*UJWIW^_J{h=9ztOPJ;`M8fl?s73l}DwCh;OkEHyYkDo5U
zc6rY>jHaA?457|BgPRXG-uf)cKmI1{p?iOm@mWuzDbL;0b9i%qum2}NZ(Ij!&dhY|
zgVgFfgSxCH-CvTpX{N_O5XI7RNOlT;Z=b#Sbbj;fcJ%jL*}PWNn^WIW-^2f^zURoV
zK7aS_^GOZ5w<MT$%`9~}`eJ<q-K$;`(Y75_lFyX5Mcg`WGq;nwojWjU^It%W$H?|L
zhMZeUOP%5DNhX}j<TM-DH)PngG{d&3pm1r@DT6V?OmQ=EBAFmP%xn;pMSaxb3KYVu
zxFZR2#gJ2C#{9vZrL_``d4{e)r+q~5=gl_RQe1SEjt880!}7iN-??&)QQEL<@4@A>
z^yXc=%=%f&5AI#IK@u99&)awZ-sKx4NU6IDf7v42%z3{+e5cp7B$lqbWI;@OwJc4v
z#1>q#PJ1ECV9>JIODqE5NxvAx!?0rx=>g}n@Ln>QFaG08*od`5(yLzU2#0JrK>7Cc
z@n~Ax!n@Ne7Ol8(;GXn~db581e7(7TMf#qB&MRVzSETM)*ftIEeQ1wP%Gp9;$Nr|h
z$<8o+6g!i9o5JjYhdPX5hpyF2Y=9P_e-GeXPF;G<pbqoAjrXdB96GX}@Y-FBc5c*j
z4P1mv(l1Mlxr-^CkY$Y(r<_SjD5yt4g&rcMPjsd-6^}Snz7;AC(=S3G`bh|CTVPgK
zUi~?0F0$u$QJ2cB6JRb*eyKV6idg{^D1CbZGD8{a*W*7|e~v$|{#^Ym>Y{o@^s5z!
ziw}<cgU@R|#@FW0>=kYjZeo_89c9ZJn)Qy7kbX&X12JY(s><&imtMH(vF&$UGV=Fp
z-gx}6>+l7JZkyRqd~)%nn-2~UUGK8oir(Tky$yBI8uYNC$7V99m-b$}Y;`xDeaS=H
zAG?I;uKUd6|8`CBNrTDOZNL{UJiPhxfsw!WuE;Ix#j`!px<IXZDa7>{(8JxUmt6~m
zZ5SitNA<L4Yv1@_a((RkF{8Tua<a_w8n1^sUhmFLu{8QYAdcko4ukqfLz`8*mCM6$
z6BuqaU!@(KuY8-74Zp`1XCEiZTc#OMjloe??mx|G)*>)hb;F~Kuvme8wN(9+Z}8l<
z_^Pki`N6SQ<k}q_yW7%i9)Du%-eYb3P3Eq$;Qfb*oa~G*NYoaCcE=XuvJ|5!Yq8nO
zH;3bD=Ozh1+p;vfJJkM!_o{E(PUR;EtaiV~vZ4DlBf~=#W6I=r<3rG2t1K<kVYM>-
z(!X<lSn&g}YhS_L1ls{y1zBx%NU<KAO*e=k_8}`cj}&K+F<rGglUNVCAg0XRWcqAl
z<iT_@MX^m$ie;1XIS1k9E0=EWn?7xNUGwE$-L$Y`n_=6G7G9X_!s=nMwXd(WuBIh)
zp69}j`IpREHXH30{;Z9I-J%VY`lT%h>zd}?xmkFpI;MKGRxDZ9w|Z)wFQ;oa%xttH
zoIbMpI@1E2dpvAUu1Gacao5y#bS9@SpPN|TlC9}dzom_t#jcR+FTS|($+$_54D42~
zP;ah8j2l-{r301bHnP2RjF4kQQ;^AMhGDgjNKl0ucCb}02S~7FF}Hjprzy2iyg8lK
zB$nJIdv8<<Ok~Q+A2Ml1^c|nO?e<S0KC!*;YJ<@tm{wR4>D9Zgoi($s@8`2Obwu7l
zk4TN~w#d9C^OxLs?a~9&tvX6KUTXDQh0xUIp3eEX{)JOpmp0)1=(qQBp{W<GeLlZi
zF@>W`ZtSwx0!{f~``XTq)$?c0>~XaCJZHFA`s$6@X`z-jyVD)FnRFKO6>a`#WD0Ir
z5Y<hOgq^NhZ&&xM74z$=_@WonTPG#jsu{y&eM)2{w^P&x#N~7=RlU`E+@cMc6#;0u
zU0HW!uxNUh;u;;fnD*T|83t**ZNs*Rj+kq^QhOU#F5BjB_aoeu>r%`JS;VQK?$zgS
zTGig%CWmFGWCfaAX=uL0f>*pcuoGzgsj>N@mFO&@)9Q^b=-+bX!DqJb=<0Ua<Qie6
z-7@+abs>oHYQ#$fXnadfudlIOZ;pv?seig@QD?B#XAg#b?H%(!vv|Xym7O!4A%w|F
z12N;MS@M{WQM7ucxKUB>_|BCBEi*c%2ZAlF{R2CeJc<^+SQ9>VTX}Bm9A~J=ag6`2
zz`fk#n$?KvzRTnM=zrKhzP|C_2&LaCulhuNm3wTA%1s{k@l#g2DY?t!5d<n0SFvk|
z?x{G{Q75rX6nf4CRfVBN)n6E;`*7`<M@lv+6s9xTOs#wX;fumd?z^>O%QWJqJ4G)-
zlf3z(D6&QU4Q{fZI%Ut;U$)x?k-ks;@c%OR9`J1xY5(}nY*AlHyK0tfS;dkZ7df^p
z$=!<W6emvN^n@giNyBjh=>!rIL<l9J2MC>*cGMgkotJRvj&dA5yl@<MaA)o~UXG((
z;ef>2{AXrY#U%;%{{O$<=MS-Vc6WAnW_EVwdFFYZ?|1ofw;TO|^Im+hsR{kje^8F3
zZ&woZv*g<MV)$BgX$)U0ynGEg>0T}kk?WdXO!p{9pj%0hwTDDj{x?w$YI>fP9pgb`
z6)zi_W47>2&@VehkY6N#$%-EmWLjtp3Pm6?BDsKX>2;92-Jp3v!^$rHpi3?CUVVth
zN-5T46Ld)L<wZ48+ySEz4KItWu7RMFL7I#l69AF0h^{xJe@b?l)DUH~^BNie>@R`;
z0H8Iz-H35b)iGO@%ZF~_OvxYuIT>bZ7K;H7L|C=QVMYX~h{iF%vJpaI!IVWx%%K-m
z;$Q7FXUCWg*t)}EOWcw5Ya2yPrKP|5+@JSt`_q+co;-hXdG~a;8tNfujvTrFhWq!f
zZJx@j1NK-=%lv{BX68*PgCIJKtkZgyPWJsQRKNF|1Djsi)zG{1;`YAVJ$jF7JZHBw
zpLW9scVGCxR|}f`TNf4Av~8N#SuOQUTDusW_tzt`6)0D?t~|LvQ#(N>2U99X2H%rb
z&Oa=MI9)!^uBouDX?o%>lXg7W-}l7M)5>Q~H&_`h%b9E5y7&5fFX?Z>m9s^wo98)}
zJIqhz#~E*5=zBO+2SR_Ed)v94^}RbTYFmA)ht={GX1mz3@W6X_UU1(R3z~de7Zg`d
z*f?iOwX}TY&Dmh&oNdcR<TdP7>a|9A1yZ2K9>=9NVL>MliTa~R#<51Mk&zNAeLW`~
z_<(kepBGzk`Q<B?H21B$eqeBL;GWmOqBGAt3;hR#d>IyQa|ZV~YGeK@U%9ez)k?hj
z^3FD#?JRiFFzFW0e|KppcBz5~Y=L>C*dDuzxO7`c52NGWsMi*-Vlm7gjYK0>_O_o&
zKY#mr>6;g~Y<Urwt_SWnezo=C9Y?lrKeA)aWv8_lb4agxTu-k!^3IVX@4)qMOV2)q
zGlDW;dT~qY`HknjH}u|l;fV`p_=j3sah@YbvTKMKr$J8@QWZoKB-EuUdkhB~l^{{i
z7lyShum<TAX88-o;X77u?WhqQN6;rXT{peVfY%kvrtdniYkHZyfo1&%jwSJT$0QGY
z9(4XdRvc6qR5;lSQhU1t7HRO)%db9f#*Fi>mN!xvr0@k2`K1#%&Y+-zH^3nMhB9QL
zWeBDLDh5M|QUW7(CPYG*M4v{|B1nm~8LS7SHd1s#zE<Y?mYw}E2+0t^9Y|r^ffOLV
z5~A#wFJGIWk`SW=7_!W|3cLZ<>~jxd68ZNLGknTPm|*hCEQ1N!0ZfoG%g@4LIGMr+
zmFEtRu_>ach?n?B1~4Dw=(%+O_NJ2}duBQbdu8hE?0m;0j|~_^57T=rDKc;5bCKZw
znPO!8IoHTm6-Knv@HP&PXtv+wwZs^0NS=cpcglA+>_*D9G^LdB6z`56`P^Jgu@fVb
z<i2~Gow2)NBP6!(Kn%l&Q7WD(ha|Y5gjjJEswjD(yrLfTUs6B$><9pnvnSU-0H)NJ
zFYlBtU80>(-W;=|={eS1K0&)!dcfCm)|}~VYQi$QVdzuhiSMiq{(D7PRdsb$*^WPi
z!2Fq4N2Fs3RaH@mAe0nUsS;m0%C2pl(bq%X`6FmNTSwym$`y<Yo9wQOJqpQ+zD!YX
zHG2h974Ta9B-9ctm7WC4z!`Jl?3HKyWF>Qz^wg~Rt@Erp=_w@kgHC8En|wy=gKyJU
z4SDH5f|}0d%R8r@e)`Zy=~tkzX4}MwJCc4MTm`-vKmKaZ_`2dh569TAC37MU$u0>6
zF$6#auexEM9x``usu9cl803#Zs`>UerB7~sNP6{56;SWh8cnLscenLDw{O<0eb4nR
ze|*y3yp{RgYk_#}t)TEtx=?yW`sB^+*X+?2sP}20c3B_F{x-U5a@)SVmHP`;t>6A8
zDr4z!EB80{w-|TII}ErM2dTO_9Q4a7$66Q?63yC`E)?c4dH}1e9q|kaFJVI%|2BgM
z`?tVa!n=EYu>3f+i!bG&l`%1Dx{!A1oPyI(S}64uYBV;Tn|24aCbQPeSs>4YC1Yg;
zH;$2Y7of`VD%ILRG_WoZ0N65C4$!lBXyH&MlQxJh(AhK^vQlP1x6--LP1We;R)`*h
zo;5lvD%BWScO9q7QC&hg91q#27_+xx%f_@^e05fs6Jue3BiV_+2j&tk8IdF75eG~v
z+3sV`Fu#K&VL=8udGp;W&Q%jut!nBqS-NlDXE9a4<>XBIHL`(9zRRu<{YNkMi&tPo
zE3gi9eRCxsXQn}g9{C{H<*ejgPH8tgy=nTs((dU^n|L|LYh<%k&X<yo{h_GnBfve0
zZ*t`~(&L$NLB`#(;rWk3f*O*2Ff6?)CL_|9#7sdZ2grpX2!<na5uoTUsZYA?$W^-+
zxE$ddca+ypY<?ZAIC2Ec%ERemjgC=3UEhFP!DrxBCVANxdpEo`wWfFRtk!iwPJP)I
zK=|TUIq)v4c?|5XpMubX59Zb&aQsFCju^|;B3p;rAbtxcK~exG$524xAH7I=Q~LL9
z{k^CAeT5a#8Pje8+S_hR-;S{p4xa*Hfo=Fv$O>07$-YNd&%Uv)ZmvZv*7ALizW(TE
zd%rjZ+`_T%PmQ#&<D4UCd;rHO`aCp-d1X7SY=DT1tZbZ69OBU^K?iWq%T_^`{=`tk
zXw7EkC8?iL3kHGxHRCXWDWa2o5L~WiMEX^W<JgV@$QGLD(p5lbbkOy@P+(STrRwD{
zpZ{at@byrn^dR|kBsub!$B5z9Kb%0L99X>ylAwyJE0seFdnJmj$d0+!RSV^P5`b9R
z3o&|MX<dF;Vk(u%J;q*bS1NNYKAP&PP1WUOlN8csXHtt4xhUiGj?r_>u^M@m5vxsH
z#uS9T$-szRGMUNv1ThNF8rUQRtU;fO+>TD(`1Xy#+Te_pGrTRdS2XDK)e9Rs&M8+}
z8J$_sF;-RiwoA8>UBOIt&*^AbSgqF?L{Lc`2lIY@IWP>~;{|D|tfCCN{=S$#+;`)R
zeOQF4nK7dVcIbizQ5z0VZPJ!-W;0i!ZJL^&4u`d(frU>2^QGO_{&^pS?<|LKITlKp
ztX)NoG-4OlKv=JAOYx3cEb(SzxtoU*qmb2m8cDWz-CaszhQ>5m&4ejb2MUx+??EbO
zY^f_{P|9k=b3qa><%0p>$>PPP&qVp>rO7)VkeBJPX~kef^FeP`t|WXgCaRQLLTr;H
zyj;<lQ1dI14HlUxI}(%0lr7l9EsKwVHA51#Mc!QI5BrlxiRu91py(9W)#7s1te7@1
zas4IxE?GaZLpx5JG<;%6qHRa=jLOC)rmCQz($E^VboX>y!mWnNf`Tfhsj>2mMb|v_
z^QW#^M3a@*a1FYfr>l0#c{3|3XP!4@)l6N5?xt(5xe0A%uDWGob=T&a!dSrN3e*<a
z9pRda+S-bmu)|(di;u+$Yc_XPZ@gv2gBvGI*!UnB|7HAHCy7HL%hWmBkjy1X+$BtT
z*p$Isz`6`+W;i+^8uWVU7a9#n5W2`-Oo&L3CXWsfq~Bf{NfPv;TA+Vgln=8mCNN5*
z2)!A=NV2q?g@w%E1QLFtD2W9w&sl&nwk%8%$ezTm%u)hBNNzlc2`PIqA>}eH%vhT*
zKO0+{Zv}MY<YoN_#_hfr_VNPgC3c<x!h$(~s<ll2F0n!H{xI$~ybCIRdUeZz{;rnd
zBcsb0B96;4PDR!aH=-azoUn}eF{l;p(B>8PBxM}naZONuy`C2&(#D`yl)gMcA*p<h
zbQQIb>djen*sQMx9Y<d&0V|Nf32-E)CyqJ*{(3WrW+5^h4ciZfYOxQdo5?zM$fjN<
zD7$Uw0u6l~wuVU?1~yEtFW3Vn?J4L#;Hm4b^K|ufk?q7r02r;hqpu;LlTwNs$M1*<
zd*`|P_MO|Y>%iv4#@de8EGwJ4H*Dx`UTJx)rMR!JxFvC*e^F5x{<zDE7Gd0s++N2v
zpLRlVZJB6Xy!pT``nQThM>fV>Zj0$TNiUAnAG3w=lwi^lg=UnPeaIJq-lZod`{I)|
zA^Gj$kYTHQhDZ`M*|3Gl^)iI?-5&;>oYvgr$8PW5;=@3FxY&!+{wA}Qa|S=W8y~8l
zj9Q15oemN$%dOJZgCBo<aF6A;R}*LrcL|c>1nDfYdbeLdJ0)(2Il`{~tz{26c$sy1
z3u+pL?^Cv`Vr@1c`$n-jh;*boMY66?3XXat;}Ind5M)PYV2Db}E>Mu#vm}8IGD!>^
zw`U2B(#MdzC3`*%4yBgtVW~Z+O>=Q#kr7d1KRz;yPW;GVupbrtCCi2hMYi{mH%%%F
zymF^U9kzS~=PH-n(49zh|L~29I?#WN>OY`Le0(smX9-5U#EUQo>G1;_q+~jUp3i7d
zpYq`Lf`gc$D~E?(Nwvw+fGQhhDt9T;Wo$AA%kVUt&FRnQUY%S|!2jzf=ff%BC>Dww
zN5jP7J=oQbO{J6Qvl#joe+0A+eJD_di0viLcmpHTKM>vwh(>SPv*)mE_m$&UL^K=7
zIJk2NtATZ-kzHl>VqR3B%<yI~3}z-6Wk*;6M_L8h!`RP3vAicsdkgn~bF_NtS9-95
zxHnK3csK(+!wYaQlgd9T@XVgV-qK@9d>4*b;X9;Di}avge^g*7EDju{=-!Och#$yV
z_l{G!G>-btV%U$iB|S_%PrXI`k@^}*P)1M;DnavT?&|1>eRjltU<|J6lbsLz|Lpox
z<sVsJj0$efcw3IbWWwCiSurh#*-hor$Me$k363BCznCAM;P~(|V+>VXHv*7F<ukw!
zW^4M-(G|}-mj34$2mkqhFr)O(la}o0wHSDGP!{0w+=1~5<Vn7nr>Ngk-~QkKO8z&!
zH0zg<*Ix@jhI7Cl9qw(^3?kOi821rxR)hIJ(z}0b?>mk)VKffnwA>5Hsl4(emHTD-
zCP<)B5_91s{y*!Zr|3~b*D^^D9<V*flB8eJDY>A%y;;X9IbE6id;qyZ8Vn+#Ba!7Y
z$F|odYQ=EtD}iy%h;t%&eOU$xe}+cFnthu!F&PA6n1MD(tg|uMHk+M>$+DaD8c5#G
zt6xw-mLdmUL()1ib<6nqnIz_`Ol9n~<hyZ-FN+E1fNaH4mhg~<3so=Zwdq4-pZ1Kp
z4^F}`HveQSx7eq1z?ndIBmU~a48DYnT_2*V(YM$sM^T=#>OV><B-+y$RZPp$Vv<Nd
zOzK!_ASW$)&_OUTc5S{osSugL=pfke*iyk6fXXk6;N^5QV)m>2A#4?lhN5w7$c)A#
zc62n_2xVVi5V5n2-KI(c>0@bNFd_YZB5wZPfka{;)$8#jQ>moK)0@KkL>QU~0tw7M
z!8!p<c+mey592i+FfiyzdDM=iLyfkBV8Elnnqb1y;HR;imr(pqIMfS?bpngIR&O*;
z+A|dQ#=S^P!kF9Bq70fClF5S~Cp=)#L#I3m9B*-)icXUfsZ{FYgCLPeCR3iF!C}0q
znEfP2nL5JnQHBU1IEbT=fQTQTMCG_^VTL_5-*%glZC98EBV)tD1A>IT0O<c3;hQ+3
zTt9}-b*yqpDY<MZ`B`$Q5+h3{6S^kk(ha`=HViKqL~{0Y`kzb$Npa(_Mmv%ZSET{W
zSO?)|ZH?BcmBLyrcn2kFv|4E!*bDZJdH4`Xkt66w&azF~rXBmR%&msX_1~FtQ90k1
z9Iq}j)<HN2KU}`=Ui1WVQ}7Nd*I0+)bh)f#Z!g%ZlsK#%`!Fuobm|Hw!ps@gUc)&e
zgs~1XkyF)r*x@fn6%{`poIU1YN-ozSRIbhW?KOgDLKy2HD%T0CJH}ynX!OfPIdH+o
zIE=?4)W6_n@*Z)iG+-p<GU`Z5?qU6g{&MWbBI6tC8*onco<F)1oak+ndrk)iCPL4V
z@A)6RKyc=X-U+^ECA#P4TsePa<I|NVXimirEz6BnGHz-<QjcuQx45$!d2I`b=8YkE
zsqqIQB5(;}+fNUAJTg(b$CD;7NgNL5^3X)47$UyG)3FO$U{<pMk0E?hcQEIUmgfUv
zBoXU)Y#VNA@Pj=3Ib2pO0xB|NgsrJXBcLS$2C`0WZN~;g14ABvEQJ?B2W04`0eXYU
zG+;6TN=6ZtQE=(r+yb{aG>0r!_o7)U>krPzvW^|i>{&S{FlMXeFB!-<4?j^_z(C85
zmBYhZO%@Oa<rU>2Tmt%yVUBu?TmZ6eVwb(qPxN$1nxGMkq%i<*6Hp}TIFjlpQb+Wg
z!c8y$#&^|9l)U;-+qF!_P9jYpulLi_Js!^x$-v;>{P{<R%0p2KTWt%FjgwiX=j*b>
zwEOpuqNZgA@`!7n8w=|}nbW<50Vr3W7T5?fWXD-5vV6*)u`|%rhHfd@y#br}$!wPB
zKTuaX*u8;Hp5O#b;KLibVG6qjkg4xLKN5cB>|-3K#w<4v^VA$9>yddnpQ`BO8E9%$
z!8UY*Brf*}PB5u-Vq}Q{De(!8Qv@$BaXdlR3pJFPAfw^$uThCLkfC&HvJr!s=mLwp
z{F;k57(0jTwFmiW(b}$Q{jga!u3ttrOq$RI^iLaV>e<uNvxoUcF}=&6X1n(+!OV|K
z_Po$P4QG`8N0!!QLwfp3e8Xwe=)dDjd(wBwC*_a?X_I{Ap5Z<tI@ymh(@VLLs3eMS
zV_s(*#$gLAG=@}Az)Z0}I9op4|H^8PctkWho=+R~D!s{QW?6sB@{Kp$vK$lFN|cCo
zNc6$OU*8!813!`etnxWEW{Xkd=Q`r62DZ+N73*=#F3E;}Fq*4$=EYe|S&Dpj)zm^f
z6Y#(n2DOA~FE4GEk)?bg*+0@vW6CmGw5WK-?+Y`bjAcw-H^<BBWbqd!3!3LP7vLXw
zQ#Sd`zO%>OJo%x?H<q8hFR^_8#k235eewR~iNWUJCD;Dqz>*osd-q-1?`^r%6<K%p
z+H3E;ZqJ&#*G62Ig1+v#9UXIr|D1QueO8^$dfzz<FPv7%^Oe&s1nRfWo4%pRui?aT
zEh{JNc>BwPvlnhzJ#((#GkeDBEemE14F9g|_$?^o9{y@hI{M0tNk|n>CvxUzOdLCk
zL}?I`bBQdhApC43tCGxRxs}CSmLVJ=1!`p=JJiAiycfg*-ss4JA;p!=u`lJ9i&)I<
zHtyT#u~g||r}R4^$|Opc6o8;`>@u3l;1}XT1FGU`wmvL<P`<zYSSnj?q}ionr`e2f
zslU8fy53>(R}_P_w#Nr@Re2CJMkn6Y(jZ+QotUf4l7Z^5C(B`^aFQ2NB~&e88X_jt
zAb}epxX>-Y4Mqa{QKm5T@X+LjXyh02iOSCkyehpKP&=FjRqBFE?z^NwJ-)^vX=PuU
zX|gZPwABxODGh!3;A*r5%$E;-I+AStjdQQN?p$;OberxKE4rNyQx$ltU%r}r`Vziu
zb?!E3xE}G{j$Jn!f%22>{n+CIe=h$)-PDen@k*_#3Y-o#uB#OP&*~N_s4``$rAD_w
zRfU@WZQXRlcfTB4`7?fqxQqSxDkX!?G|@L<(kTW1vzo|8LGZ+XRCq<sLmPRPY5#F6
zB+Ll^t`ZaF_l5kN3<2S-p%Vh168I!9$Po{jBuprkQ8v=M@22*DxIgu-^e(7)mrlM5
zQlqZH$umfG6b~<gSDs9Q3UD95Oy<Vyx(FVNu^%;_E9X$lsI}BK>O!*edKdK=vErjT
zq2U14Bc7KI<)u*`^xjY!)go}>Jf}Q<qBNVIHfPgOye|@lvXM3cQ?CjAOPU5v=%2F3
zP^KXyFw(uIboM;ifU$QoTZvNkb6a%V4fui|(6l-&`UAnw#3-6z1Ih7C-f#MwQHP{4
zc9ac}H_AV0faEjb_|u^z{=*NV@h_!dY07JLHmZ!8kEOMYZ;;AN_(BLa02pC5RIG!U
z=s4_X%4E?a;>7JW6ETJc_vHP1XSc4rujkOG-yV*iz9Jqktf)Wd*qQz!V(%*QqrSza
z{94uTZdf>}FfnOE!)oc<Wk$hd@)Y|QTyb~jhF@+7Mz$ZeX^M-B!QWutVo!Da{Pg`B
zje!CeZ=*N*8_dUeVt@OGxd9usx2D;Uz%pC>yw_d0utB311MpM7#aiARY>A5-^sGs+
z;Mku`-C5Lw%cvS^6153`hn&h96Ui@1hoWex)S%|Dl1kaFs9xwKs;kxZ|EgK&#1pT*
z@z_J}zEA)4Z`WHyw$4x^hMg7u3Y*<2u6|;zXep~c=g|FoE4|kpd+2}FR?v|$t$L;x
zJo1wI?B~`?bx&`p9ON`~A?HwuoQ`4WKQu%&++j0RJ-1l>Vj1}Af7g(BZ3)RGWc{E-
zX5<{PeqghVj6a2)V=X9XnM#2lB8E^Jk6Po#UPX~A^CItXAFe!pt!fVQC3$|m!ZSL2
zdCg|gpcx$#rQtw&3}ZcJG2xoAR@=02qI4N!*S8o94A?3s;1y$5VDH!~QH=NKx9DOs
zV>hrmIg#!gyK*_-_-83A#?%4U3_K045XP+}fOVLVLiUpsu)E%fOjh&+B+3#58(G{g
z8W)l_iy~+6l}8IXwS}V#VEOfl_wE>;2i$V_e(>@njIN@{-q;a*qO=J|0!(kXVdu^|
zy&0&T;OcuO&omqxkxx2W_=`ibtO}1G;&!ovl$I(*b*MybPn+#59nt`iV7LYd_Yr13
ziecg-B!P>p8!&eQAl=&LKG+Can)KjX>H7Js&2F|!tx_x6*x32fbsnJ-{QF}|QK9u?
z@b5|iwjZt4Hi5RG=HmOniZ&3HZkP1lfc}dw^Z_sCO!CB4m@;XcRNtwJXYqHF#K)M*
z0qc8x81N0q*ca@%>7==o)!JO?l+CXdEG%U(xdfw%x$79^hpgWQ6RwI<EljFJeq07?
z6U*ihjV5&j#a{!wvIQ_}=JP7P6tbe5BchI@-iO!mh|^0YoRdzXze7wiW2zV$7-qSk
z=lmP>7memSV%R}he~12h^Q;?mZ=QwYJB<eA{`b%!fl_#km>i$VwA?z1Fv4dX`yR<$
zF-3qZfDv^so*Cz?c<e)BF&kA50PHuF`3IjSn;UB@;9$ok$vG9ZNE@xKP&ToZ@d;gJ
zAv4)^kV}}S$z}@q?X6u@Abos(u)MToqO)L8EmqvoA-Xn~mW<9~b3vf2X{K^e#=B3F
zSWcdDQbB40wUk;zZAFrZ@|KmQN1MeiJH-+wmtda2$Yz5SLKs~OjSATNKW;-q15jnr
za_m4AB;JUvN+bf4cMFhrYZk9iW*-WkI!<W~dYwiCDE#^cWX`3*yl7Y!${;w>qgLzJ
z!0ejsy0)-T`bzLyLHFGB4PQ%ND}XvcK*yv<6wDkj!wRp=yG{BZ@~y!Q$0?m7`#_*M
zPLaL<$R?5(kUL2751fO6a==WhUy#0X0U2Hgh+kXLqvpdN0SF4@j`Y<xR#c?<XOj!0
zpIO()^ifpaE$<ojFnLVqMIXu#S=(%qeLII)zwwC1=N~1`?g~6KnNLAn@L~tnlmkgL
z4)Oz<ibIntLgV6S&uHB}qp@ab^MrE$6oa5Q+-+dh17Ljjox5iPN9F<toD%D4Y;xJ`
za|_JH0kLw<wSHGaRav5_;53tZr`Bx%+Lpc>GWs^e-?STZYUQI}$aKA#$;^tsTYBUS
zmz39mgU&=ELy3(NNtu^M1|!QtUx1`y980Hy%xYp>l7n9%wH*Dpv-~3?9wO4RP936y
zN*s6o?cIeSgm*)r5CpJwHUK<>_$2;exHQQ~6HqifYEi7juBCi<y(?h#;|PC0h7IyY
zBO>jOdI{)3B-RSORzEEQtCu(wGnqFOlG$uXtWG3KU-11whnl7}TH`H}lzi!#y})uA
zw4x)ly5MpEc0T<&{5&nuOzn)*X4E#0i-dXG8fRe6nzJsgp0=<nPJedqy+dUhz18A4
zdN1$;(|w;XL5*IcFZ<*^>09Zy@ZL9Fg+ijgy*1q84OWMAt|ft@3ENiG^)xn=H+j3|
z{>EbeF?u(u)1)6$C-%g3qJLzazDP?9J-klc>(07#;)<11nNw8hgEw83V04Yz*0eWt
zgt|$60MfV4XJw2zDuDggZFuR0^nf6lyYOmh5_G32=@IT*qpn~m8Ei;X!B!JW(<n`&
zG{M$mqP}T`LsZ2$AKEf#E3ff=NXE}T85fHnW@8Llt53y48SyzAZ;T0jlvsf(;0yVp
zW{iu0g<Bl7oC#7Ult`E$#)?-AF}{XO{DYK&MKi~BR(1r=@&KF8cYa^Ed9Ht)f8DIP
zXS)OLaG-nH0Zl+-01(3B0DWLtcOZ<8pFOX89m+MgIq_K)U|HbsS5(^StGml*F9uJ}
z!l%v)-56q#sG*J42RbS{$IV={cy@Vrb-k^!!ta0#ga9zqh)b1{)JNSTo~FoROp@@}
zMacI@sjOL+bmDX#r0~~BR@*6$lE$-uhs**V8<Uhi_<%qUDr*dY`at>sFBuSEMU*&B
z9hSa7jD2qDMDio)8OI*kp>mG{O#Vn7B4o@)f{e3TqV^m<ya(c6>`{wkna#w<wH?pq
z=!V(iXn^cFuR@KUSIAKn2&wXM4s4bHkb%#EaTN~BVAe=C9NrU;^`5@&8B*R+_1Srr
zghu+=S}pSq*-G2f*B;)p`W`rQ)fwyM3Phn>x*@seu-F?>D&ibgRYQlQMOQlUE$|lI
z0oU;CtZ%f;kK~hm8_;(tnk_s_$S$+^<4i(IZ0q@3s(r=YExV#7eWBhI-L+-!igww_
z1twtf*j24lpQay4Q}ge?@VwcbPR!Qk?3{hxh4;^w2SP<gqOzC}emox9y=HG<gvZ0^
z{Si?@ig1@rp%z7x$x-zA<(xg~JjYK=ba9k0Ehc-~FngZ7K}V3pmI59EoIzx|y!4D?
z#4N?)=pn+IC;xVlcB6@$JBVbxuAEPKK!I`$gmHM&aA(?h6r&9&pEZs}%Q{7S(a8XT
zh=H;<IsFs8TF=l@LdPGc)?Xt}b~{&i8aGUCwlL;WlfiD*vtr$ZHFX6&dwO^f=5-)N
zGw3Q-e&@YX%A`?&UMT2R+aK9HM5ZR%(|^BveO2RBuiCHD*EqDEX%i+2Wfizq-eR2q
zdx1)W>sE5y!^yVD$~@*-3zk@E%)m!bdysmOP2uv#V<p(&G(dz?;JD$@S(_}7my#-t
zUY9Vi^Q8ZgzMwf?lQ8QCwI;BmxBD=d3s~O5$Wkgu{vcidSa+{<kx4tqXz)w3fP#5I
zlMpQ+$wSMgS<hZ6W_f*%$T|j~y_h4Z9B;kokM<HwYwpP1(xZ<W3SD*gzb-xcy7VXf
zdlNIX>Sv8jW$;*<r4w}?@6crW8T<z(&+6=aez@-o9&o5YJXVXesti6oM<P)2%{%lJ
zt3^?I14Kk|HP+%9L=n6!*20TNtYlt+&w>cbS1aNx8syCI{S#uU%g;xT4k;k?c8vn~
zp8tIK26~))J9JwRk=`H$p(l-eJ}wn5nq15`P(FOcsh$twu}p-E412E`@qFfryxNGl
zN`jFM0OS@JSy=G?Xzcbe+JH2_Cesij-$CW5ddV+g<Z|+tq!C8GFt}}uHb{_o5i{vw
zan!Rg42@r8Bhi594FNCB2AF=+(B)NdrR}8`4G-HuKLgIFNuOtw>eys5{qyuM=?5Q9
zfBs1{db#xZO0WWYo&fJ1U4G}Cr2p!VC%AtpxN%+$6ul}I-B<L+y+C9?mi|5TVS3VJ
zFs=yv1bo_YY)S+3Oz_wgG`zhgeG7D8<+XR*0p@^l&ns<ZQpr3W^YXq`c^s+&9BQS|
zDC}7`u;;1Dc}k}>lCf-?TR=PmP)n!eQE9bB%^0*xw@DkNT5039r5c`5ThNHvYg4O@
zE8D-lUKXw!CLMV9z@!Fw=lXBkR~pr78|dW)=2J2@4Gl;GHZ{~Nz3Se3uUe{s@=1$m
zTDf?q1ztj=^}BpqCt(lBNn3q)kpt;-Ejt&lG>H~L{{D&F;2*`Ug?%^)3#o!0K$v<N
zPmavXqeun{%~#G0M(}?VgvaX{Typ$$DK*@NCF}J>TFIf?20fg~=AlfK@^>OThzwf`
zY)ZTnI9(<wB}@Jfox%_TKbK)@PX{d@<Llwv?4=dyU8l6>kTnz}vM1>bhSn$zkv*0F
zbh56Lv{MRueU6=`J(<*)KUqH)ki+sCRSxqh_Vddz)(^;)0sMBXWIo@tigHm=Y-!E<
zyI_J%VjCj72!O~QK^O)ln7M%*w=sfzVl*!!l--2E0|x2o&v=X3aPx;cAQ+Mc3pk%$
z{j<MHAK%Ptw1VMvu;hq}oY3k(alSXC9L4YZ3`{Wq3py_V-G?_D%ofAVp!lypTg?Kk
zmK;?bk?wxoAZRu88zX%rb9Ot|2-XWSloLW8qDzcoMtBsvRTX<Z9+Syz9EFyjzCoBO
zfP^TBfpjt;sx|0c#*Rn1*VtEyEQj8uhRw|uc#xKtfn%s`RiTUoOjf__HVaY|n$j;y
zFM>6&9}UQuZzO#HjobY~jJ|AWYhZ0)SKWqzx}AXleHq%>iFbAdm?r7PG{#rOSJmR&
z_^MibJ-ljYO8{LoumR;;8=&_E&_!rxXJGBHc9C`ckzvYX_^--NvUGAxk5zd|VYr7X
zJ&ez^YK#?yQ}}Y>Madzu%0tWOZ8;~dWIo?19L%oKOErWJRnAH8&Zj;_<0L8(eUv?)
zD#X6k<sb)8jy=HrIqF~fs8E{1fmT+vT0fvMfkdiQFgrm)XhE;sMc)&^tE7U(n9{*y
zAW#gFHk*|6khu)W!RQ$j?rmaby+&~##1w*NFOd*q9_;d!DlKtIDRfgQ<us#5N-179
zV9;n-O5}&`nCg+xeL=D~7=TG#inoZvWr31BSpbA`vcRa%@DN<B%<h%{t%w6yCR&~U
z7Qck66<Gk~ku%>c(ii8y&)m4rp^@FHyi>ahJE9Xv1=4;R+6)u|Bjaelxa)4Lt?LEv
z@Mh^Fvw=4Qzgap4J<?!$kWMZsEWEL>yKo5{7{<o>(2cddb>P1Y_!8cLFG(k$2cU0L
z8ic(|&=ofp7B1;M(RW{feQFh7OBGj~VF`)@c>!TePi+r@gin7iHw3g@Ex7cC(1>o|
z3y=~K8drq#k(NXGMAi(;@=KB{M*zo1YchjQ5%BS>yhIU?g&-y`miI=Xl6?t!(MuU{
zhf25o^1{>WyxM!UMipnHEBeFtU0$l!J7I8Gb3KOgqmiH&n@9#it;>41uWEYYk9u0;
z0L!=4Rt=PyS(qBuSh?{ZqBkp0Zel|LW?)8>H&DC{hfz=A;0+vTBT=*`&#iEj(;-MD
zlVE20Psb^wk$*%S6Xo1+*@!7Qhv9}%t|}Fb4*8=&%`kGL7}-k9xq@9viEW~kvJ2)?
zm@K_f@$EFw1U@0ZiRh*NVkzNrfmE^IpY{xM1RXJcjVO~mTquLYsmo+8O(#puf*s8g
zZ6Zk6x1P96;4Z)4Ukp+%my{@$e)r?cM0}HFn{UhxPFbb|zQ137*6;J}pCdZ=9eGV@
z#%-Jaf+iy|xq^N(zf45_r2mP^)Qd(WyNxpfUgh^up{z(9jAxTEim-Gep_`aUSq%Ik
z3*o4soLx@hg=T^)#k67rBmK6Y*6UctAUa&=1&E(ZceXCW4b%qdc3i0C?cnsm)k}05
zjxMKd28J<O3S7nfu2*WnyC#j6cCaqVLDS$hBa#ptP|!&`$G>*IP*PlIH8HHgp#RH3
zy%kfla4gF*5U?MKhK&ZXe!ReM;)QnrWk=699K<GBKr=KAlN<DUev>oMq1PKX=!{$U
z(hRx~Kvtzv^l^F!wMT2tlXmz@zKraGjej^~3v+DA%*&ZjVRL3BhaN&r-oXo^;q+y=
zrpvy2{+R<vML0uaFlgDb-pYA>pqd1ay#;O;_&d>yyh^$T=RAPA*!iO2LSFdegMZkm
zF3_H@15m>jmh^PJFYp%{MCqa@WFTWe)gGtlcaZ+DT;^BLikR4Qu@!?o*~iPUym-Bp
z4u#d&IG0^(!ra_SH53L(3@1dt^Q(gbe~CeC+tJ-oz?zL`s7yu;+_*asn6<+l=&p^0
zDrZ!+jSCl;U%X8;T*3?WYulRy&a9uMHu47A9&cGtw(J~pSzubYDq7bYpBQk0WjB4~
zd>FUJ!<vf9hyy+A5-o%}xWcKPKeMpLH_mP~34T|_xcbJa<MzGnejGzXKf?LEWhPFr
z>^A~hOAG!Y`}_`PMabnB1&h5Z*fL?E^3Hanch-`T!FiyvDGb3ODwK5?j%Nj!U`7tl
zgnyR<n;lzcb_@J{_IDq+7nJZ?we<y)MtT$Ddu-TqhfSJC*3@pR|L<#X(P;Ah{k6*c
zAkqfQR`bHuk6Rv<ZZ-*m9;|;|V>sU+&Yvyt=)^|Ra1qXnlFf4j0%V9p4Z@>NdHo7_
zzXDB??QXKjQG-#Hk@_l<G#XbUnQmsybvO$L7e9nL1&K=p9(ns4>3OwUEBsQ_zApx}
z<5bV9t<Rga8nyJR_er1o1MtaPR248);Lk9K^8~)nAi_42$s|Y%f(slA&ERg)#GBL4
ziH1I2m?s*};05VPgQ)P`%X&v0(baLs$NVVyCChfk+^3UG$)g%0?(WBtT>W5u`W5LR
z@B>+}REdUrGiK?Gts1&sq0e~bJShS0kaqp+?2*oE=)m=;>|1#uk8?;(>5;TkfJWQ1
zP|pzkqRnEjjfruu-5Uw{@d2a+$p>T|ktRKc_R}(hG@UJNZakzj@5L()+uBrgcELe~
z?elQf!D#@1Eq>`k54htp|0Hm5#+|d!k@a5beS+Ej-rXw4L5J!mNA5*iof!_ijqCHU
z_e#7ua}lf6n)W)`)4&<0s~o!=s^#F!rL1$WNvmZSug6)g@jZsdjCr6Osm}~%^?E3o
zOs0`4Exm_!(4j-gqzCoV^o<S&>_fl27WNTYTV7cP3ylW7L%I?4Ipklx!6@CQWWf4u
z-EoTf47Fo~nnG}fY?$nXXH-^y)EBb)%|7%Q#gP<bjs*Q??38G)iAN*W7zRIe({yc^
z@e$zBnidZ4ps4}vv~bK-!u4CX7*vrNTh5<-b9dRz!W8k9;`KFZ6Q?zFt$#P+y?J)&
z%`><6H6L+TOm13OGgGZ@2zFFY2v@ts$ps}%HJ#-XRBWTKt)eklBGAbvy9y6nHhJBo
zDjReB7#O0CgQp^3KLEuYcLOl=9sG7kRor-b`nHm~k^(&krJn+t)tj8YF!<gZ@!GW<
z0MZ+1dQkKB;;@W`LGUD$7)fl`x3hAbVBVC>P&OXi$n)v@>Pn#}3k%^v>fmpAUh3m*
zp3=HwgBg?unZqM{-%|A5Ou=nx_nI+~{P4JJi%mQQH227T_Aq*8sg3W*FG}4jW5G|1
zOfx0C4Hr56Vy?6prz-8q>Sll+D~aV#AF9(%4kMeFP;Jy~RHF!{1M;iTWCUdFrHuL{
zPdY@aVllZ@tQBC|0_^#MnF|0CKCC!nRK%<VA-^huw_-$O?)}*mJ*K~7(%)#MUtsSD
zDTP<!QpA4+ySj9wp9UNC8cdX?7d|@&#-*z`qmI{Dzkf#>oL2SEs%g^4lRmxkQ>O2C
zRVKy)eEMVV4Dgdlw6Fwj<LH2J(O*x4W<jH&0loPzi_%}I1s#NN8+}24|J7Ib_rn9}
ze%bbuU+-F6??A5J><Q})M%0WxX*>LgdfzszcH#+JAzSS~ja6%DC|5n^{83GyMe^4+
z)PH>nRvOmJ>ZwkQ8y7gqD;~aLK>vsPaB%D@GoJjF1+3~PNk>kS9Z4ovNRgf66xl()
zy<^on5AOXRr%1}vU8erVT>VGZGH{YtKVk*t6#LAu3P_%@TLTV^sPnMa$hDIvTa`^?
zH3iso>INWvo_$m4^X=FRI6#d2#BzV)J|D1PIPXv}6qn`DxF2&7Dv?h31HhmKNJhX8
z7np;DZClt_+tS%lGbw%h2`c@Sv#xvV#Fnr_2pLU*;M`RvXq{EjfAQ64?zr16mEQ}X
zN-ea^PVM+(YyZ?uU9tIN)j8g>?abNLCbep#iZN_mU@yFC)tdd!!KzK0z#}RLYtkEp
zhWXE=H&LVN9w#2qxw@ZxoEuR+@np^MBkKNke*IoJNkcG7<&QluR_%vIR+Ej4*&Z3J
z$b_;EyCn10WrvNC>wYXo7PP5sgg=Z^VLWC)sCtRnn7|NX2v#Vg_*yNP2n?$5@)8wv
zx&i^0GdK`*O2ozsJkB695I53cv)LHZG$bx6=`y$7x?uVazcW};;OMLF@Cr_iMx`sX
zh|X|lmDi{NqA1Y3ngP}sn~2p0-4nX9K^y3I07pQ$zkX|lr>nWHxjwLAVizoSIm-bE
zIN=2a0SGrG7I=lGKv}4w$s$^dYf78kj$l`Xk8@b~O;naEJwf8iTnhGL_T`P#-~%=*
z(T1TNJHZeLV@&u9W$I$3NpO2K(wH}m{HZJ_YKS#)uyKa;H%86Vf?xp}qqnLv>=Z49
zI+aG_6ucePeU5^Xpwqu&`hr{A%v~iHB^op#quCs$=}b$c|01^mX^)4S7tYwkTO3@V
zbb8R?ZYr%Qwu+XficndgN$@U6Y=SUQ055O`04R65iecBp4S{;pa9tjZJfB(1&=5OP
zIn|6>V<mMybvboA^(ggA!exTJ;qfY21jDHXkidxkkFw}bG2%s(<$E)$_z0maSbW5*
z3|32q83qlA#PPKV_^lR{yEayfd5myiMh&PXRCHbsK_pcGFFmB6A@N=n@)H0|YXp;<
z5??JOF3Agb7<|L5l*6x-W7GoP4Mk>?$z1ewTU+|2?x{1t&)P!)uZC*_fVbE{t4cr4
z?`?1Ql#J7>jzL=Qiq;lcEk&zc){A@&4oDXy63{AY+sZGMzL37Wv|@tRV$n`0-wT6#
z%TYRQIBi-aIz#PI`E^r)*IHB^aapadNOh6*iS~8^VcpK@(A~jz`3pRMy{*PHXnN2W
ziF`ImS_JN$v`f0Cw6f3?1U~5>4rnX}j`jO%t!3j%z?XNFmRX<F6!A8pH0Wx)pwSf!
z7B+NEh&X}Xs-x>}jYMv(P18S{Q_;v8jcjAZf<uqYEpNi<rt-OTBPf001^W{F8S!7A
zv%8@v7%XZa8&?z9B>kn>1RcO6{XQVLDuH_V8ZP=e(0KV55+j@GAB(9K)J|$Ibqn<{
z(bF+9A$r#=5_)QD0uhX%YmRuwcrBTi7e&1zN?u+d>L(qh8AL|C*f?gj@uA%s!g{OX
zJfw?Ym~hl9Jfw$!2#xNJ0h1$Qrtiu94EMdj7(JAJEo8UZ>>)7ww9|$f)=ICeSqVIg
z7P(yl4Hl{O;qftWNMnxGlrLITIX-6AfZ2=DuoiyI6>9GY6&8giPC<$aOb^VT58ra~
z3mcwJJD+Y?WN@N%<5Tcck{)udK6fQw6)5bV44y0uOl%Jp76#iV1`5H<#nGCuLA@Bz
zg3Ap`{=3}<Ds3I%aL0k3p7gK4SJK60R@wvBN#|BO0?j=ybvo-}AEeiekH=ke3=wU~
z#06)}3`8P<nTOCO>T+r5U%oSO;yaVl3qIe{*v(n3TzBJ!uW(vrv8Yg*;iZkz-+^)J
zzBA@ZKTLXf7P>mv{ctzF$!y6GZwWXeV4rl27uw3fPT7YNbLIY<5^=;o;A9OtF4lxH
z3Nv06wq_P(Kn&o6aGv%%SMY1AMVkiT4!ure|GLykzpB%vzX9Dkt=9H+nL|1xKu{3+
zyNzBYNK?Z;%vFG1q0v|gR+_9sr-AfM7PGMup5>vhtfYo<iilZG5xm}mEeKYcvtuu;
zI3P!W4UoN92p}=sKFavA%Ub-jpjN4OzNpctP0tjIbX;YA)-6h_kh*R0JT0iy8fggJ
zr2hS|MQR#+<kRWRzXj4yc-~M#&(izTAt-tMNWlgl0{GviOGo3>P%@r5!Iz+hn>Rs;
zMJCLY`!eSC0J+|bL0H`qRqXS6O-2h3Dd>hqqp5%LABJ}QVe(oNZ-mM|y<6E|Jk<;m
z7C{K6lR-hP1&ITxb@xo@T&XT7P_OKqaL>BoyOfMy#iiJN#6F6di;K~x%~*joq>3WF
zAN`A4HF~6Ue<eL2+1LunhIDHCwO~E~U_p8om@f&^PuVb-E!m~}!2<AC>8FxFH%o6x
ze+I46C+no&6CU-zx?WI-S<a+SnBPi&mfi-u^bhIp(l0;}y-WIq^bar|3E(<3wtP$c
zM0BXV<nmzLX1^Kz1>&p<Q;Fg~8mKhbdyUl`yK{iOePC#|mo|FS3)|s)?dgB5hO1Y9
z06t1e{`8}?rxy&SlQ3Cv+da2J=YHwXHSozD>Ek=-9qIFX;RQ$UICyXj|B0E@8F_g7
z3W#h5pSHvoM6wNjbF|IEVKD%`EIL+W!x9jBfpn0d&*C>qQ>MJJ%9MM#8CMI>r_$4(
zehQ|5*|DxztV^2AUpD33c||o{7M+pBEyo&lmadwjdFM{K?8K+wS*-Sxw--vWg>QeN
zWl0*miqp_WoHD@O@>4z~4~Zpz<ZXwalFk}^f07>dZ5jza$4H--NH$_M6J<guisY{a
z+<e|6=biTme1vQ={6q3rG;|+6ru@r)4n#8$=I<80Y(xVhaqlp9E9%$MSuoZkMWtv@
zAJl?lBM}bvOK%Rs$I{aWK=oL0#og=$>|IDFz)_LyxGw-37sByDG4$@j_?ty95xq?j
zz2_1Z^#<(xj3hph#4sQ^kVbP*D?lQP8*m~=@Dc*(FoVxvu8VjHi~Tp~D)rWAsHiYl
z(ivaRzr4J48qHk0WbyV-EK@3~rH`a9%fku5y(HfB$%n1cCG*urLq*B_w_Z9UJb8A)
zQsCi)Kf?H+l`}ozoX1v_dxxZ(zu#}P8dw$7_^nP2UF54Paqm0~c7SoWG?@Urr?tyt
zo;}+v=o`&zH&qm#J8^MRt-cX%clkBys%n+i=PdMVR7HhqwSP!(u4?bJjIW~2YKt%G
z?|spvx$Zj7S4Tg6ujFvo7MgbjT^sa8<6O0xnpbu_G{srzb{lnJA+R9aWoaS!t@684
zlM%ZC>D7dlI!GvlV{sCOPD1QO+&)->#tH<Is>Rw^FoZrDBOu&^xM5?M2Z7~Oa$CD;
zbezHZhA>LF>z-Xw4$4Dwr>Yn3>8D}5a?({#TG~Sux7=S5Y_}T1KKIM-cuQ*Pbgc0X
zsqaob>oiu~_QPX7xA78<xqQQKrN8g#36@6~wXK8$YECe$c?{4`IEssz@t|~=MegSE
zu+6eYu*aI)&eAVwuU=>=o(&qTPL8!$I8}i~bf}PWz^V$;v?^4<^!Ic6o9kw|!YjlH
z{qR>&Tin~~())~-@$QbxUoBy4Ek0ehrEsyq60`yxs2MSr0ICDWZlPxNVVfQvR>Cxr
zrlP1n5oAEG)oZr6Q47+KblV?U)OTpZ4DWqYHg$}*ut3H93rv?DHF(;`&v@%ge+z(h
zOU^l`0eaqdE?ByLK_#n_77nG4x@)6u0P}72GV^PQ^K)SsHG8AjDFY3BDkRk5XSIM)
z_RI|}6^$je1zG@(Q-{@nEr_n_*j>KhmK75(0e9xN-?XP}z+O7e4zBzqn53<k-#5SD
z9;v5(OaBB2#xqsJ?V0rP1Wcp4W3(OH*lIca)?|?G)EaoLbeln~u_!oyNbxdBNv#$n
zO`^yUyTh@JUkC-$Yzp5~@jc1H9mkc}E||{V$7(Ww9(;GO!oY~)G2(>H3<gaA-CRnV
z6izBYt0+26?wLWa&tTWvWzY*1g-bA^P;hYgGnVtD1`0<O&83uk%C_a<sP~u+CxweJ
zqEzrg)D*Y#>ijC82Fm)>Z$#}GB+-hBN`?h)zmJAdMPkNsH__T;ZcmWmM3o8Z>=qll
zF*NsrWcA|t6PjnuirjepwHr4)G-XYnuX6e7$=iBrYiIf=?2|q&a<|4}fp&V@)JFh~
zW|#>(cfRQHcztMx{l_Q!uXekAz6m9X_DIjh^Im4QH&2_^8WVKf_3PG-qfIoU&-&yO
z3~^aHpny4GCM-<K7Cw-kkN>#j&{pi81%>q19#{$gCw(T2rne1!wG&=XpEdL;yp8Za
z61-S;7n$!1ku*6S=`j>l6C?8zqik7u7Lz--3_(c(A)B$vN)`x0#LkBUB(aA)_C_tn
zt_V25TSdMM<-@44fsZ_PyT=9&du%q3edt(OQ{()mCT3=$a$3{;rhQH2WldmeI01jU
zHaWB+xo)ybZ%|EH_U^JNDuZ4H4&d`mW#vswksaSh{`Xc>nKZk+si_?Nw5&-?uMQ{v
zjQ9R5|0crlW^jG{rL9|EieG3@ar!-FWqb6T%8<T3b5(g`BbrCC-1P(D$}mzsBw<-V
z38)5>!Pf)_#gD0&YV2H4g(?Mtc-&EOc>Hdmn?Mi=;aK32<sH1#flgw{hs<=rn6e~-
z2YEE=$B~MU4s&*kKa9FDCY0wecM;a^R3wPWUSs1(&?%W>X*~ARcuD{=Hwl_0g7S=j
zrcWFI!sAsJEK(x@nGA_GoCUuJBj98ynq2IL))<;#(0GL|Ch_<9X2b>?BaHVgNN2$1
zvD)l4Dh{cyxJHaTQ-x~Ll+Tf1F-t3`#iE>_M=B3`qz&JoCI;LP7X}bO6`DW}p+Pbv
zHw3;vZUQ3QM@a$E-Q2Xwg71k7h*!?YdRh>lBr9pC)^T}uj1UMKm6F#+<W6#1)IzvX
zl^ZMV>}KH&It{~$>=MSPb*O3S7KUMITBYI`GXo$5ke(N3R5T4$Km)W>{SNN}uP#(<
z1UijXFc<*uE3h$)MHezQa%#?25Gd5@1SC_K3v8yf0?>>rpn<Q@RRn>?tkQCfPGttb
z;xJnPuxZpGU|_YpP3y8%#bKGt!)kOat<hULH5JZ+7@8DJ1!d--&+D=oAmlim%0L&+
zjM=PZHX68#41#^88Ujvj^)QfQSf(V*mNJ(6G$y*(tuEukA;!P~+M*4gb5Vs|r-$f~
zoRzjiXofap322{@zJu0r8c1ttT1SJspvKIx8kU1JUnXdDk8AZbuY!<g)OD<ZHfl61
z4S^OijG9*i6A$AS8&o;$0cTJhTvlja9Te<ZpSxnd*k!4hToNfPx;r5zO3EFq)&~F@
zzP0>(v)f^fdLllJL4bOe0X~}cSuXH9R!*>&m(zkpd+zv-N*#j+KEbV02W&yhS-hTs
zwcVi!(f*S9i7b*4R>T(>k*J~5x?C}z;1V=Ev;_r|Mby@vR@&Iy86B?+dAwel2fWc~
zaxtrb2sl&~V5D^hPMQtWW|mcJAuwraHGbVtx>;}-3tXlmtxr|Xjz7y{X}xnxDP$_Q
zheJ)pf*!QYc9+<!6MSmg4M0sTpxX*Wql!te?oz9UR_`)uXhv1v20(qWv7#8#It?fi
zZEjFj!WenI9q>+8Z8z!wGy}cHtl>FS5}GS!L<UKp3}dtdpf`y|4Wof9%W$*`@J&v=
zuBBK*s|s4jcNB5=)eEcD4r_61VW9}v39IxT#(s&$7%ruajn!dChuWlutVUI9GENDq
zxo|<dy$Fa~Jk~XfoI=2(qsz=r2sJD)T7Ick(G0ESQ~;Xd3=jr&W;FmD0E~-fzkr+?
z8iB#UF$R{SQL_Q&=qvgHyUk{{7z9R~>N2SWO_2?CWAu^=Jp}+X8Bn*@n|1aDI@9<-
ziAK+81)s0eYhh`Fv5a%*Z8~EIZ`N=HYR<#cTt)4Kkoo7eQ+*nT$yS6JxL3zIELYWT
zc=@y)<yKJSDm&P*Y}>{)jc+fgo?Hr{FMt|dE$WNd06#ZAY3GE=thd@<fT~rX(@mYM
zFOIlfI%6iL9m`=n<v}uZn5v;#sQK6{C=jIm*l3S=!RTO!@!}cUE>rlTkpvAB9yX}L
zBOLIlVl1B9(GDX9L-;B(mb8ExH)D?tivTEF4xuS_-L6ah#-~5u(`@xfzm^Vwh21sR
z?%NRzFv1z<oVPFK0b%;XcYd{C-1_T={*ESeIP;nByJlXvdE)lTO~y~?{Xk=BpSE*i
zfe1Bp$@EDbP0@0<cKZk&tOQ@lS*I_!a=PvSytcY!sfs`E<3)>Z>FMANfc?#T_e}W5
z4PQ4EfBosSztCp_aLwJ~1MfN~#+s~>@3TjNz93QGSr{$j?5KOuNHbvJD`R0OD(%-o
z^<dp2OjiNScO0p4)3WarW)Frqp0yYdK6o7WN@wgKEl?)Q;s`sej2MR{q8KJo6fj;K
zbA6~`;q>Z0cVU@eyt=%jw4}mWRlnh(-j3w@_Tbd{P5V!?dAcV=W>uHf6xBrjb${o@
z>)XKEj}Pwdo8EbqbnLnHrfy{iuy_Z2P%|f1;m|o$DwD}+p6>Aa9Er;KqHuBR`p)LX
zO#!~d##>555l>~Mr>Szug@H+1uRi#3w`u)zfW4}7df#q&M>>Xgh;Cki^oG|+EJ`cY
zK_aFy_KY~e6t5xF!ofT%Wh~BVu}cVX&;^);E(>`|$DDxvEWj38({=V@4*2bE@7Fdr
z?JzLKR_S+mH5r^H_&zmGZ(%sj=Bn{Ze>Z5<Qje`uAMct?pR+7syPav7&dm6w-RH9$
zdkj6G*J&&=?ryfCYs-oPuCF?!ozkz&Hfx2=qSZ*Q0+q(r#qN$T>+c`>+zjf$h17^O
z2U$xQ<!N~eTvBXTCh{^ER4lI9y@8<fC^4z9=r_d>d+iWK$iyMB#1eZf&F3-&v;2iD
z#SRkAM%juKqWxCUM*NV55vtV2#i*ZF7}iMaHj?8rF*__(R~jk$bLDrMpflAL9tgLk
zoI%ZZm47aZl-8L5)p-U;p3w;?lhk|Re_eRte}Tc$x^ggYkF?4tID^tR;kLFgFa@20
z5!|vzda%5%w8#OHYu8Fi2i=P=xKJ)DgUcEqp0tXf>p#I(ZnG?=8dcX_muOqkM*dKG
zLpMxzZ;%E_Y3PI`bKCU}Z6GCiTN;nI^wko<<pTrV8#aJ9a^;ZUqZKm&22hs_hJqO;
zI=s+kvzO#A?y#W8WG<>Io!{&zX=*HSG|wLwE;5^#g(C)-&%p<_slCNcB(0Q|7W#m*
zxOb}U$}z@>3Zz@S%N|Gls1vXH5t21DAk?&g02)?soLVSAVx(E()*A?77fdW;#skF1
zmyHvGc!Imb5=UCQjZH1S<-O0}yJfMw0qYr)^r6AXOCLV2^=KcLKIDxC=|dC4Y94=F
z!!jmNf=+^x$2C69<Ddkc1SQHzsLS03ZK6iDS9;T=)p9-G8w}s~a9XVi)bz4Ov;O<<
z4JLFJ)W~P`dikvMCOT^}eE+>((ffYRo=*v=hf)DNuHj*gBO_p>rX;{I%1|f7N{E<@
zAvv()FOkBTuVQsiO0PcN_v_=UAN+Fn)o8*D_DB~E-im2qH@^ggn<~tLcmCr2N3T2k
ztZ~J>>aVCau_sgaG)X^wfA^OUuHNy&YyaH-CMdl1CSZSkCkMxkE1vPz=If5`j|jzl
zsf<U)r4*ZVx#EFH%<<k)e)yweQxbXT7jSj{7mUsvC1*IyUG)<gvX2@f$Q;Cq3VxEq
z%^<iNp5p^tFPoy;us0V)I2lxSn}u`(G%ljg!WV{B8M?$)pb#}Q0&@s|AH@XKM*;N#
zUJL}l^#+}T?Qe^s5EEWzEs3_}<CBq9osGQlDNCV46lwFT4Kh5(Au(7h9-_MriM2uT
z(4bSAlukYiw9mrRYJ(4MJ0jMKqWBVP8s~9hKsQ$?WZ>VjnuMt3&zlBt#e(vM@@=Hw
zLF%GspG6<|@#7Rw?PMlX7Zaa9PS)e>kz$CX0f-bmmJ6cUkw)Xb-9m^f@S+bsf|M+R
zc7voAJWJwVH(e8NVF>yIQMYhkK{}0vAh?h<alDp?^b#bGKzjh`FshyQLymDX^yXr7
z0?Q0n)F7oqT^2k}IT99&ySsjZgVs7kBTzAn;NLv?z{aJH0<C{t-xW<9%^1soptrHC
zNo}b$nu=oOrG*B_2^uX6c@<aCWDv~O=zq<QT3krJM>0KU=GB6)tR>J?#UQC1auzM{
zglahY`^2Z7=*r@8rPgLthzn0+jX`$-!&>xu>->pTYQQ@D6U&VS94peyxC!kJhqm;}
z0l-~hvay_q<V}XwS!>o77BwxbE@Xkaq@k~~w9TORX`oHiIU&%q=3;L{?V_Nr#aC6V
zfsC_!aZBI1S|d#Z^bfK|jm+`;0QVg`jna})uZo&St)b3GUu0G%#xpWWA_df*!RbWJ
z8VG|Dq|4!tF&--kAiWojj5t14K)YBWbYsUeY*<I1E>SL_8z?}ZF{EG0N@ai?BZop*
zxs_FPco#O`&am2qj#*pO8UtUXGP`;A6P15jzjjtt)sg=7%aE2hARXWTN9p&xW&nWw
ze*^&#oO<;yq_p&@^so1JUzWTdESfr@lHqtG$6fZDaAhTAd9A*FNynDC1){p#jtXX3
z*y<=_Sf`^2%v%r%X=-9lbzw<M%R>ta$Los=cl=|>H_6C5y}pSa*DVGY%jyipJge(j
z-CN>&X4%puuA(QJdas+r+rQi|Z?5dP>cYO3_H9qC+YFfG{TEM7T*K>8H-L@Jt(y(J
z4)v&pHE>zajym*oREE}G1A4k+9BY`_o8Ihl3N^0Tk9SOr3S4nr73Z9mFJEk;G?a*W
z-U%-)(zV@q%@e9HnQ{p*snB3)wlM;8=7TT2_~5=5eEt`tThgyTaW5!gqEEb@ehie{
z>+9)R@cq?Sf6q2ct|96474HMbvtZ(H(q+<T@2>y{hrnOlzmc9*Fq$cLJCfDb;<XnV
zi>n-^B1j!*Jmw)b9{}`u#c-O%X|@=|qG1+k{tS=Q95h7XwGkeF${bFz+dT_=`d0MJ
zY%-ZQN(bK-olfx(C|_MNrDx&t`E$IRUb$pbYeCehvQ6$-HhX@elACn?^7+jXuZ?B&
zYS-ktT0R)*JhQ2U<t&0)g>)poDz<Rh1syQdJY(M6u12%jUc))2b#L2pCHPtQmSzvl
zy9>11Poy7!GgtuLJIo7eL&elxbE+)<8C?|@4gea`=Ayc(n<o{T#c_?Tt<^@;_D;?+
zaq5PRS9BC~cAvIz&ZL;p$S!uO?5)v;VrZXn{_JMAfW9C4+DldT#&8f;Bhkf*<d?s(
z6!8YPkQgZ<WdYgm9$39*{1>ohn3R~mZJt#x4W+-HwVC<Nv9iqH=2`TNS(|~YZQeHN
zpTMwfUK^NnoH`Dspr6az+vjfEmM3c#AZe*uiSZeee$;k?04*k|5RhibF=YbM`%f0E
z1+N@~hxEad1#JzJi<PntXHm^3Q58;DR?Ibu3z(x&#SEkaCoSxtQbf>-8BJv-Rq6Oi
zOFK%2m)A^l#RR8{o}z+Ii&+jGGh1*R>`8*mQrJIAuY`W-gF`R>h?p)F`u2-+vGl?T
zkp2~WZrRE3{*?%M;5jMmzv8F96v^dQDu$yuiAaVevbY`3u2cjIrgkzK(K7f~oRETI
zOM~dOdU3>-NFQI_Aie$Ut<rb59C^UJeLqk=v+KRB(A999GMGxuUrVKq0No4K{QOv3
zPhUp>+$*gyfnSxHKLJZ$f9wyp0L`sWfU=egV}HEp8R>`JA2~NARetc1*Foz{&PZ!d
z+r-mV(jSvazf?a4A5Sb4q|xhBVHZewSradg+U58vY*!G4Q67eR?Sua_t0Fj0$6W3&
z4;eh}-HmHp>s+;6y80Spld+@swm*G%blCgc{aa2g{Zs6%|M33Uub<PamO6SJ?X{1^
ze;<Dg1c3{jKg@y#viucT2ev>)R>iVTLaiX0pU#9*A<?A>$$qRglQ739<s_4QPCESj
z057~xb6SnT{@2V_;L$;_&FHjC+my{=z>uRb^}KZWIe~{O+5o3DCGG0TOS7q?ShIX$
z3v0o9=Pu18qyhu5{2Y7h=Hj>g3Tm`f2^EqnlO2q*R<R!$(=Ewtl+plEfP3XQlHOBB
zc#q0Y?sT$<ZzZ->jqx`_gsHDvw!TGWMK}y(I%4c6k9v!jNHB_<OdL&ab{wti<y1Z-
zpaLG013FSe`$Y_`3*1bE^#<X(vu;nKPg>P5eR_jRG$fL@pT#UHyTG()du8SJMWzeN
zxM*}%N5`>w^miY8UBAIqC=EInRrW3|y6v{2rM=;WPT*nqs+!Ic@XC;83m8Zws=ST@
zXm*%kfx}ysNT_VIF;Y=d5i!y>)lkWX68HG)#!J5mmW_8fuxBTD8w`TCv6m-f@D^CR
z6Uz62@jzx1A7lKnVl7d&A|b^xm&_0=v;sPp3@NUtNXyJ66>vJ#5Mn$A0yN8h-7;tC
zLv^aTjaAc)ap~2#dTvuymoa`*k+peNyyDh1w>oW2v*Q)FMdcGQ5R0kj;mpxHt+u9l
zO%=DTx!W-`1Y&EXSK;@wnosvO-fML>&W}~z(|@<ajuUr9HQmkV+9;@xsb}H4L=QUb
zP4i-v18W9wmUzV-ac*W~Wv4MFy;!G~j;;ZXYe%lvj3b<IBYZ@FSs|dW2MPs!Na?Ye
z4y<5aa5XJ#JkSF2ok-}xVz2L|=<>F<<>BY6^kv$*(*K9H_W+El%Km`gz3;tw)7zUq
zlbKAWrYAF*ne<Ew0YVy~hZcH=(5o;s6%`beqJl(4RP2fcMK|K=x)#*ME&8|MF1l-5
zdjT?+@80(&1!Vua-~amp^WLqm+;_`4_nh-PbUaub%k1e67FYQ49}mzDwS%`94Mq!(
zLo`r$sxH<wIe!`)^%zX+y@Lj&uTGcxrKpiOL70(QS{(GXSksr-ATQI&h|&u_@$f-&
z3)L%26zm6B+?xke!>K9MVv6GN3g(9bswFK5fBYJ8UxRQ@d|y(A-xKu`*W03*CZ_gT
z-eeZmK>TeX$44VYR62u~YDj=`{CK&EQt93(j{Ax44jeaas0E9D|8G{xYNU3i5q*}I
z#jAP#^<f*7Iti^&wywGd{VSEmrOW4l5ii{c6m#UU28K~e^td-yA<373S--J!4!w5r
zn-6_n)^i7#4;sJTvEyrW6y1c5k`NdL+Cjy~S6}@xdI23qFOU#S+_|TRpA41(DIX|z
zw5u*qbSce3cN&lb8BpqZHISmGkd%)1rgl9uw_|urY2ob}r_#&LJC$55VRO=%wg+E$
z3mu#Z58pd43l?2;<3{0O&OUkd$DrbpXXx|cMA~0Z^u>UV^?S(}@y3i2#%N&7I>7s4
z{y>B=GnMG;Gw8a%{1Hri=N<GZh<rvr;7fjY<I3BC@ipRFG+{WD+;!bghiv!zPhY?9
z6DQk>s?eGxBkI%ccdzT!6BqnNDJefyK+pq>o>Uk1M1Wft)(!ae<G-=J!7$xTcPBC(
z=j4ve1i))jqW6E9Bl9fID3jp8&p05VP(noUxIiWGjr)Hhq$u%3m+1BJoREq3=Y(G1
zO+rVB@vJEnOZmz25zASlf#XwpnmCtCw$Yfc*B_VU-+JbL^cQpp{pEf}4=YVYCZ^SN
zzKc;Z$z|EalB&{DD3@uvH8MFYEv;6JL64bCOb5<pI^c2i`#~!P;s2ogagKx9JSoDw
z;mM3!XLyGW@}m~D0{^MOBmO}{{co(DEzOgH4ggRWe*Xm*66}qlP7C0Pkb?J9kjOMJ
zo255b(lHV&B%pNkcvWR~W?U6S7apEi8p^J#+Wvf&Z)f|e{Ai@O)DibI%Xh)rWQ9Tj
zUl;^l1i@=HnnhpYC#(4M#@ENF)q!cHSL%LF`Lba@64p=(xXCCJ_q_1P@`lsR9DWLc
z$is9N9dpwZ{Il{2^w7Hp(3z8~SDyrq10d(GZ>@cD<NqWQ|Fdz-u1WQ732KD@uB~_n
z-PcVDfKuQ%x%!WPT)F8(^z(<C3WiK*^ND(8;ygiYS2L()K_X!y%7K1C5uWU^g}f=C
z<q(^qI88AEPU8>oX5yJ!KqkfX6fNOW#u{dPV8S79qzH3^-T|`&o*higV6C<i{ku}D
zmFOh}t5+3D^ypMkLnP7weivyd!lCo^)4iJ>uX>pz`l7b?dC8!o8$Cs#dY?-IEHAzU
zES%E|W?p7Ig2h@*Wu-<dkrWn6-o_WheW~3?u36MpSnq9@0DG>lDAEuK6|zS3GS}{_
zFZ7gZ>}fk*d1XhsRa5fJB^Sh@i?OUUf)^$-p9<}ik!mN>OupV`GO>N3n9w->K+H_O
z-G68*(PBREOT8ufK9wr+MMR}ywQSbOELMw9US(cxJQuWy=f9R`XSo*N61@-Px`^zh
z!1%0=DZgcrGbg(|-Nt@>?~$)1Ru>3ggdwpPUld<cBFV~<>~ZDg2{lva!CB?5X6Cy<
zdJevNb{4Bg-%Fa(%d?yzmDRlFfd|%DEviCr=JI@r6VE;bMLCuN5bIM*5nfPKIY|R-
zB&DcQ0l0vXbfAmWB&W77>ssdU+xISQ8@|+T;O$`B9&&0gUv|e*F#J;f<(R#)rE^gW
z`q*H%8&<7pTe7$n;KkIzM?YM%-e7m|Yi*9TtxJ}G2QKAm$Q*SimtZFf&n;jZi4QHB
z$@e*(7ap2p-Mu;Hn3%=*%SV>?Jo4yyFa!sZ4?W!T0=OOwIsfP*J)2*^DRl7)q8^jn
z|Ip9p9|dxBF1xHO8_vJ)+wbqcy7YGR<D=)#J`9u<rRdwNva+m!{0hPBpnSwVxaijO
zGW0Rqos6UOiJM_JI6ZN5eBk%(0;gg3=7}gh8Q;vLU97Mt#Xp;rVm`q=T88hV6D-z!
z0`?7A9^6*o(E+?t(8h3tC-@ThpHGL=28M^cmiz(?SqpA{{q@(|pfUM57=oT63AaE4
z&KZo3fx&B;PkJ)pF`Ty;U60EQhR1;Owb#(!d)n@7J0vFd1qX~TnSgIvKzssG0^3dO
zHU@;WDe!Gh7bEr=P>6fP$S)XiQ)49C?#POuA5sCh{^2VOyg4>z-KlWR6?Z>!MMLe=
zr(zXX(B_MjDC-jK8er6c;fe9&oGb*&=ji6r$&%!j%#%EvgQMP_r*IJbd~y5Asmu#9
z?sYt$ZlaD;uTUqc_o#nR|D-;pzNCoeQq)Of*1@cXTpsHonxsz71xz^V7mYxQVwDh2
z4}?V(bZ;1u*d|LNp7#Zg+T2TFLrDs0g9u9kWC9WF+{`gGZI0z}fjpQ+T&7^M)CsGA
z(Ts^ZX_ct6L=;vrmqwEd;wKU)yO@~+BCK?v5{B{6B$<2|r$&q#Pz9NnhHaZRt2)~~
zzI;%@>iyoFa(f_e+EBTKkx6nm7ptcw002&^qdi;F18zvevKStT-n|vp8J!M^5jkC2
zi%tzbkt&S5on_1tjg7lgrnBlaPXKV2DgTE2SiZb2n{BJiiDem#a*HxV2Xj53g4J<q
ziJX%$oW`clSFazh4c1kq4VEg?(@jd#PwN~xnbr)oN0BY%U}j6tQFU>Sj?Vrma4agb
zr<tvA_1cO!I$N+{D7c;Wl!S{J&e&4zK!Z9Y@?0f<$|cXFR|81?O{VkfS56sHJU3S1
zj8$oU`yV*IdkSP&8SCTHluoP9<hE61HsU@Z*SZ=^s*(yLv_&SazuCapI!#)QnVzdQ
zspJd`fht|+GwC!YI;gch*;VMxpbZwSp3fO-OV`qBmDd$_Sc5^R(ENopN;MKpz(bk=
z*-p1D&ptvX%XI*}0!^N5^ajkix)Q!oBa4i_>!oa3CYSM1PSG>cmhFn>6|=bt+N*q|
z0KKUJoJJw#KsHoyaG5~|l*x4?l#)UKge!|Yt{#uEe^X{mlT9Q(2v~n=H-zZVl8t=9
zVp33R7Dt(&Qpe#=BIuS!K@mZqA?kNTB181Q1d2q|eHL`S45_s~QiS`R&}CyO{)oAr
z<(*3!HpW@0Lc;-R#=NPa%rV)VGKV*qBl(uJLYrEqGt(N0TBcR=3cE)km9ug)XqTIF
zo$kaYuYG9C*v{C}Ll8Em)z+8nS+OSF)?7W<;K@&Sq(#=fi9SbfqEG&u2$Z!AYs=@=
z4W0_8H%Gd$B<KEYqjyy8h*%)Rt4$e&n8Ps0(;YO;xb2*BOTJnoSLRp@QqBNXjGU3s
zP@~r9B#aW|n{sm<BSwN?X=xCETW53@8FbZ6aR4fYRsuRBFLTw&L+GEso4@oAz|l4C
z?sbcY#na?cpCM>*j2nKdKdsrWvJ4usV*P#8K>RExUM1V9Rd_zoKs5;T+T_Okn5#B(
z5(6eDs%YAb355)a!9{cVFb~A?L@XdY{!OAGXn<^|$IOHP%co;5B2jSy+92Ufg7q)a
z7S+&!Dp*OBYH&p+uWPTf`hii}&Y`1LjT>ajt5)t+_<X+EKIh)spHuEr`erxy()M-j
zy?w8<F2`QqzG_tCQsv0|=vk{qH7rq&ex^>bS19A$*M<M3#q*7gGvLfdTVAaaXEe+f
zGH&0OR{PXw#nR?ctH2vw`<(GSV}1MTQA0YlqaUnR?o;??`+cM!)RQ|l%prHg|D3hQ
z#%S<^t)ALo$Unb()aprt9XWMEk=dymI^z$FQY>Z6P0JLco~%thZz`)c*EVeCYEd^y
z#Jw0qjits@lc`zMTxuJ2C)v;O=L;_80-`c!Af=-i^ONaNVh|NM@jt<Em?&T3u|VWP
zf{v%Cvq=jQN)IU&6Qp6W5Ni$qpN<7)I)JBLGhlW26Ovm9s4n8Zh)|c9U*o|Abb>fL
zP!!M!8ZI#%8_L0%MjhM%%mzbFHdn{g)(*EYE?UxP+^E*oLFr6szzHE>ZDxyJ&H#x|
zQJOy;%4-xdE5ktA>Y%Mfape^(qk4nplzykvW>zzRb{h)3ybeBBb?y0|;S<RQ=AD_3
zPygG@+*2qIR-kjYMT47mmAXf^d{ZTrOBsio8T!EB$v2GBxO{T3yXTxbna8PEq7bc_
zn+@|IW^~IK19*kzq%uPq8-cT$Cu<-BnX#59?9Od6kO37^qI)N2IgZgubWlQTwI1kU
zXgL5%BMg<Wq2Ufm5d?+cv_@stC~33ChKC`eR>EEX$V%S)FGl)lGU|dmUCDpB7FN?`
zPl0vkbgHhJ5mse$9w)<7haUP0)4ZGxGt!CkfBaGMoeDrEDgzR-pe9~gIM0YC2{yyM
z_zA==Z!k3m_k@+yRn%VUZt6*@yKkqb&#5bWG3+>@ABayTW54@55mR0FEAjuo%kv^Q
zm|F+Z$$n;n9N5#P^?T;_bk$5M4#KWrhhv{3m`oSIivHsPQ2)35j;>&FGQlJ!)%1Hs
zzB6ORpd>YS&!id&6)X<o$LI*2PxMs->dOU@`u|!0>;P18unSSd3pdfBmryC$O%>IG
z=YU1j2Ep^+L)7o6H>eLWC3XR5fD7b<s>|&7^*J{b+g<lx#_9j^d;XUGaVZ$j|MhzR
zUp^lzD6E_pHC4L%T?hQ{hs19!*nfc30DnTixfY=Q`#VV}zwNBB&n3Y}GypdC+g}Sl
z`YSL-mk*v-_ko|l|Dsxt`v2A4g#F3*1ufIfb_m=bCA(D74h+;6>a{Ut4x#r_+I8qX
zM{%p;4Cp-LXe~xvqJrIf=)Ino1=YF)N(icT#lVa69cRwq(jSYOb-jBjBHnMBATb(F
zWM3lBL%i9O1yl6(0#eH-8)EdtngY*!o(!BpoWA%5lqT37KEbz(NJ?SaOz9t6(YUT0
zADh;eqa!1m8aLMq2XM^_pnoc(swTVctE!r0!;_tNzX^s^jP;kVZ6e2YV0zQY`pu2x
zzy!<ZH80&ilpJqOo@!mOXn#ZN%0&nAUqGKO&8tXLw2#|0`qYCfPBqUfZ@6_SJ`UZ#
zboR>DhW(3Hv^E@AL~O4vP>}fVHj0>uyeVa@E<QYdcG$gSaxV1Rx@}&VJ9){dJxBJ8
zqQBnxqOa#wK@%+EdvRyty8{Ql>&FD?wK;O(#soSxkPB4g1BytfDXb4+0~J#&37AMG
z;_&HYeX^cC=XE9Hjv7ZY?(*jOVYeyA1iSrt6Tw8d?$gBxA(*5*<vNtmYC%F*?xCq*
zjT%r==><w%Bbtrl`%6VXB>fiAIE(cO&%uJ!InWy?&&876UQDlwfz$)~gadv`Vd2FG
zC^!L%gPYKNG@pHYKqN;DA47xDVD_xvjpEk06~$Qy*;LT&&-Q>v@vqw)HG^(XHh9#V
z)zJ+~4|P89zyrzcy`fci0r{cMXP<pGS%EsdmD<y4^=XLz$XQ$I1zrBQ_GxefK6cCH
z-P*Vxbv~_)i}DmCrC5mHTZY@+Pvue7WT)2XrU^2spT^W(7`ihs<3ou(l5-nOK6fZm
z<Z(ybgirUleZ*53&Jj8+?QwI(2!IPc?VS>^Pk*>-h3@_7=-6M9fIWH5>oZ_-;nMR_
z5Pba)=ug1fJpMV<gFc6CW3FCab^nrOg(H?E>XQeU2iBoK&1ruj`D8qXUI)^@z6toN
zKiH;oE?OPB`{;8+n{N24qjvrH$J^2muO7B`WT`Fn4SV-8op|);;5Qj8`02T1CFF&j
zC$g_VHW_G71XHPo)QQDq+|fusIuC&sqC;j69(uS@21>zBq3vM(@~-RW1sX;+J$&cN
zDaW2&2jz7`z^!2S#>Ao9u6(`n8pY7U#R|mK&jnTJ`HLlBXlKutOBdgkRn%G1lBGi@
zo@$?j9(iZ+?DWP#a>JHK?%#CPq2FZ$!NN7gH9+3f%V%-DIQ0R7uG;5yK-hmZ_v)Sn
z2vrUSAPmI}lm`fNNIo7{g6a$bqNOBx*S~W8^{*ti@0xA5&u*%Ax%M?0+YIR|2G6G7
zd~E%O#~$0T{;@sihvR6N^2C<aPg_3$TU#cnOaxy*@yv0cU|gjB_2-{^bC)E`wYRY;
z?vlEt<wNNY*FT2qKl<o~XVH)7`Hhe6TQ&haaG(H!z0UwC`hmKLZ<ONqsim4yC;(*Z
zloB~X!E`x_A3EB<30Bd|bofH4@5IsM?R~v_%VL`l#_-)GU5giYA?>oZ;z`z`yz*66
zOSq!VWN4#%#4mBb;l|0cZ;^v>drqC&bJL&TM>2j`CHkxQfqvTY^7if1XKbf4yB05L
zX<dw7KD@NFz+k}FC|_l9vv7g<F>f9;VbyiBdQR=$bLy>|&~w1I61<JmQP=eC+h5+X
zouGwZ7%lmVy+EmOzs$uv@-PAQh~|8P;1x4ZCOhVqX$_!>c55^i0L0n|VD60ONeci8
z?F;ZkBatN%Cr-_Bew-4ceKDf6#zrwkZ=&lo5KX{iU%_c)8L&C$=#5oV3S2bvoDOnQ
zPs??Z#BpUIuOEDq^pjKEk-wKD1NrZw7x<41twBqnr@&GG_r9%Hm{dV;g}Yvn@lQ~)
zZpV9Q;@*t5LFGCf*zJlc6#=ja-C#<iOMLd?2JZw;2}{w|2}5?y8EG_v8MbnrzUqq6
z$<NTuX&##4*h63unEQa%WTGFfLf1W`1k+s(1{zE`)+l-r?e;Z$3>hYqTu%=H^I!OK
z1iIERdfY7&YgH;h+claBv5&;1VxK2_y0!gC5xg6>79k+HzLbGRqwZeg(OyR&xcx}?
zFcb9!aC*{~Nt3p0qJJI-EwUsfvp|*>l8|2A(b?76L*YY*TEBUsV~+WbsWdh94)Ywx
z#LZwmDKrV31~a5QFHKs-D1|V&o*?cr6XFrmatU1e&Pf|KOhOYki#D}VGTnx$GR(s_
z4dB!Mmj@PclHDnfR%X7}W)}3ndn$!XpSbz5kDd@w?Goe#&Ylw=clv<$X52y=Ol+P=
zULsB&KQ12oUqS?sC9i_gg=PYq#0KbjMu=j1ARY53r-k>Uykwv{d$Ib+1`u(779(%g
zcNBd969q!?$e#AwPzcDqR@80v$^i=5{5;t8v2c8m91{fAJ;D2JFM?h8_%YbkUgXzp
z_gg(4tAD%Bk8^MAJ0y4>;R=4VKsXGTYm8JjRVV1dq(G0vSw3Zg9gX2s_kh%NA(h9e
zUSTh>uQVgL*8>C9(q=iIM_X^nvYXiSEsOqsAFt*e9iA`IA8+1M;IVSfH5-BXEsNUf
znIBw_9)0+=F0(7srAXWQ;6ac(%gCo?zkVrve0@5<G((ncNR!%UDePYajoY(SVXH^#
zUZ?T^UA}qfuzb$vbY)3>brs6Y@s|jKfare~e-oZi!o;r{M{}6J4&YFXkGUBNy=4Jr
z#OCa9qEjH>f<6W3aTw$>ZzZ30p(#%El@sK{!A@|{33N_8_H_7nos43ZQEI%x5-;@S
z)DUVUHI<r1EympFcFd0+pzg!`=qchYi}cbAVlzr+Y#hbSNZOX84d!0({|MO`%*ZE}
zy)iRU!ifZ8MR>NS&78p_q=zxV-k;%0Ded40&XED0GYFoIh+AV*?9!MR5pBW?X_8Bp
zK%Pi2&3!RUu9|qRP>4Z35>46R3-HSVQAZLeK|VoiF$JlT%hYN$P{~XnOQBRrwNe$3
zD<m?tLMA)^g~0&TP^W|Hu{Il&%FJe&6xfbitqM6b8lhY<$!vy7mC>kDcHp>LA~P6d
z5;fR}J~SHToEBnMNz2J6@w`HcLpUx~OvPyi9!FGCnG$S!Nu$wVjzF!}7&Oz=YOP5N
zluDpAY5uI%+w?#pQ9`*)A?4JNnR$45&%afA$Ec1MfKwMKS$_D?H&7v0tL4cbzLBen
zPQeDPlx3w_N%C3nIgoP-8K(mC6YFKN^$A)18?Vabue>3{1M~AAzEmi_{6Wd~e6Lb{
z-=lJU_M=wD{rH(ghD>k)+VUf((EkY5=@l&~=X<Gw{~o-}E7FnVTchz?a89ODC3WyK
z1izAN)QYbFQmEBVWcWg%)hfOKUnsR&B>ksKuU9Qu4%g8d8OKWX$(xqn1@$U=vss>j
z&UTv)_xlSZeOiTS27(|;QR&_oo@&VMd<8K5?=eOImlmT%QOJXL!Tyye(QT*$-F9*%
z*#9f>W1tI6J=q&SNmHXo9uajhj*RR%G9Uu721J-Fd`gHhd>XKq%TqSWLrubCXE~Li
zuEulHFZb%qoX$;LAPb7tM0^VbNg3I|m2gIJznp`D-#uc@4v1}tk?g+`dxJ6<5{&Qh
zYvTi^EYtu<%y^QE33`A2h(BQ9Xi_#nE+b+69x^D4*yE019|CeB*x}d$R>_s<4@xkN
z7@H+2h}_|_(i@#xH3X9Cf-9@uzwhR88kGgGaz-|3lv)OhVs&1NN~Lfafmx}S5nFg=
z4B3lDg@=NT8WnyX0iHq$)?Kw5n%Ks$z1Rs?T9!2ys2OI9u)o%eqa1Y9p{vuBphS62
z&rrmo?HmP%+nijX33FEf_=9ds89K))0VB5sXXVN?5RU4+dVSlip`gZ?FM%}cTs!Cx
zvRkeUj-}URwR1i?$S?v}mI=2=a!%Ba$>Q1tqZbt`EDit$_A~Jt4gYQ5hBp#GV%++X
zFxgngVF8klmS}*7(B-s8AnZK2wdru=S6g{b{h@;ij)n{kSUPd=P(6CPeH!Ktaa;m#
zSaJho0mEQsaa#LtXfZl5FF6l<Y_Msi7CJ+Q>~QzId8ol)GaA`+8FVK<l({5Eqs;)G
znD>kKAMxAXpQ!(P2pA`k07Dn>kT@+i0w=sV?xguZi1YNXzCXwX)?u?)Ig7tC16huq
z*9bgy-7nOlPa9@2N*Z@6MxvP8h(4%$_QY>!g3sp8y`AHwjD+E2%<XgM0v)i;n|F}o
z85&<lc@Ve9*XZM3y_kXTUo7bV{?-=2oTTVa8&enrkr8-wWW*AX#9x2sbTD}0w#Ka5
zmWHZ=Hgv-Tz^+_X<SMRo{k9jpTVqbN4PRyF=OzCPEI_Guw~cdYF85AZROmO(I68ME
zW(JI?B4zm1S6~u7R5#i5Xzl96wCHbmZqSXoyGfNqC#gaZFMFT0cRz+aZ;WaX(9t6v
zBOCFgrOw7*e+Lf%1=j(=GFZ@jj`EQ(ac&4x<TFeV#X$0-%m3H6OC%5lx6hOA{9vcl
zI4#j)$~Z3gXk!us{=l!jaUy|du(!~icI$`*3r1M&RiG)6upyh^SFumeb-=eOp&A7Z
zw%@cq7<;`v_BmXLMF~KoHXx#@nY04bN+3kMdFBC<Vh~b(y>nvfM#?A^hc^?3VDn)u
zIO^gzZq!B%Mpid{x{fvKpS2stjL}E^kS{9YA#eCCGgF?_lsrvbK;A9v72mB%4z?Tw
z`wki<I$gxL7M)mYjA%7C87B5j<e@iWD7mS`5Yg){)2G9~b(~(hC&c!)nt);%4*mKH
zD0mM>!jYa&nnf)`KLMHSH!WXuqPH%<M~L6Qo4h}ew*$HCGT%Q&4I`LIzv;~?iNz=&
z8t=reR4`d_n>bqVHw1`!J26?r<Six;c(E+W4E*}X?~vLQVFfLH;t45@12*a3)%a!A
z>c3x_j#j8N@ET}RRi)0qsYUP={P;@WeTT2$$5#TmJpMzcE=^BL@D*utX*mw`JdXpI
z*9lzM%f5r#i)iIyvPc3&hdgr3?U-zYW{UayJf-77K-7>1Zu7D4%$QRB$2;;{+Z@$%
zrZ4RnV+VHI*wt%V?p?9tjyI1!`dleztu3q8yGlcm_@C~mgfG5iz8ZadyDhgs7g=)s
zM}Pwh-*^}8MPI$taqpKyK=4@i52v~hZUBrjkUnepnD%MopZ;q~j?annnuL;LE=rF%
zQY*m(;DOG^#sV_n>)mL^Je!X7Vah~jNI3%|yoks;{|$~ukD|w)f1VEG(0Az3CZNTO
z*VosA=Hy+>>(8Udfhu_y9nR=^-I!zSc|9Y84&wk$0E^H<FzZ9_#*IDifn7&Gyz+@B
zo|yO{n1vRiuQmecJqmWAo3oQ2WSWy7s8le+oCz~B%`gL#@E@4_a8{)hy9)QqcCk+i
zyLBFSHWVZqeZU<=*Ith^fxt8q4TWBuZzmg0?cNcD!Ib8gCqwjyC0(@bi@O;OeSR>2
z?2#`PPEa0NKDlWa2t0NeSndSpUb|=AwprRLWo=WesVR~(yt;bm@Ws`u@4jd4^;6X@
zzr3cgsI{RayQR8jXxpNyHAi4i-XGQ+`V`3jdDp_Hqk-(Dca+|8{C4!koe~TBdd-e$
zhN0@}+GwOMtFEoBF6;W0t9MM%dUKTVnsCV=F>U+Bwg)2aCb6iA2|hJ1G8pitb7q1{
z24eoASU{qs((y4P!0FSYf^S&Xj3;8wWPq>yQtcmhqb>KHXgkt&;`}!!9F7z1um-FX
z6JANVdZnkIXm3B^kWiP=5>~g9O1LVia39)|d`?IJ{*T1U(i8WImlO7D(j}+azY-J(
z(68L2CyM+O!6!(sBwPN0h>6ilPH+1s>PB6t`=8rRfYy`mqxVyOX=kGM-#-ajPr$^(
zBy-z8LHyxAgQZ`)&g7!5Pd15eXg7TVI&#mrzDC=LJ~)r(wSVI_oQ8XRR38f!;?c+m
ziX?*hIv_^wWK%OnOgEx}CJ-SUNv04`3pVkhse2xSxt_48&?z<RQ+nmR^lvY+KpKn}
zyV;>bLbIDHwc3C~V^^u=nYmeN)$BmCfd>Jj;r1?ffM!fB4#%vVHlBB781miYh7UFw
z%ZFN+^sK^6wMxy&gSjn*b=d_D9?&14g%^&Yqn~eud)@(S@JNw{XRh40`|#jUK<m<J
z!<&~(ccxhj-8PA2sjl8;FIbfBdh+qS#TjnjV4ZHMdPrJY@vX<=xh{iSr;V&zxvq28
zhzgxfMW<!dgjySB&fYW_CDHUxZu%LtiS&=q*OZvg4N|StL~1^@n%YL)O#Ef|y~OhY
z{*ReD4j=v6m|4ORm1|<b$VH;DKs08K(i}13k`T2WGwy;he}HIglWs|J@iBxifG>k5
z%v7;J)JtjcQPjJ{6=I}{P>Xa0YJedOBO1nBqykUReG}a_w=^xM`lk1E)ycn)Fxg9{
zPAzfrZ5~!yIv3scW^uLdy_>3Y)_kf~|I1Z-tfal5XhKmzd&#j{*T2;2Pu(@g%ElJt
z%+DzpTXw7lWmOlG;(kxbT+qR2r<T}FBfOqA-dSQQ@%YJ2imTrO9YA%}8T5N}82$dt
zRacz><)9supLy&u17v26<c<3?3PUCL<cwBAouj<SeH7es)LmTcnBKVn{VU`CHzYMc
zIXdT_k`Nr<nl(DBbwbk}wfb-5@^AFDcQj29k|s9ZQK$b}F8^9zcSj@i*FeSStb2>I
zirx3Wk-QJhJnAkgcg$MQIo(lQ?Do5H#=Tji6%gMVuc740t{V8X@ZjY%^SJ>wv06<1
z4Wi~y060L$ze|Z`qt8I3#NiN~I-6n<iKkcP-bm2<$$`L&5cY#i#{wr3i1J}!_3#in
zhmDB1?;%q-;vs3oEdZH>!$uFTObfyzQ4kZo)P*UmpEz&oOm9O|lh=Q^xg=CRdPP}|
zKXY-gt}**`N3*@Ku&G_{8@vs|Z8SLN#M8aZBb!5C$CP^kt;JlN-c{_6qn8VY6o%>x
z;q-wbu`@MQaj<*T$o8=BinO#PqeHVbw5~2<p?x!RYdzZIwQ)7;vgAlL3tKD>8Jc2`
zfz5ela{*cvlC3tjeFT@c87!{+<urir_@ZTg3w+lbi~78g=!i@3T_sc<o`;SL_}5xt
z4|6`Xl6d9tWDx%dG+CKQfQ$^m6S{!R!Wy;i3_&e9LYRn1N{(+10T0or4}^)Dz0WA1
zT19l>NQQv8PvG@&PS{9Xed!D-t#5H1gd^^{?f$)G<z?&EtpqA>wszOLU?6w!=+T37
z(e6QO7FIt|TQy|zbJumWO$ASUz%U;$aN^)umF=N4Dda2?qrXG)56OL+67{Gt70Iug
zOG;Z?%1TYsXV0J~RJ8593cUV`Ql6c;;W4w+A8=)wjn3Q=CFo6S$-IWU%9+ej3mlB)
z-r?6C%kOzEcO0BDDZ@QJdF!}Gejf;ycZ@9qlNl&^t}*J#T=yJ<ZrseMmyH=yS~m8V
zex+r=L*vPV_5fY@7q%XmK;C)4V#vC672syTzh0z}ZUEomu8=bU6eAuTr?0u#cWlW8
ziunWnMri_8kO&UOK_USo+g^SVw~?5m5bJOO8%DsKB$~S-un^f~7J!e5Vg)8f=!PXN
z<>AW6Pr1NuWbrUj8~ycl!HU7!#a-av`_Xr|#cPdbmh~FLB~u<vG&Uw4J%LX}a+N<*
z9-p}XZ!2yCD#p;Y*i+krwj+zl4ef^Y-~I0KP37&wJXx)a^YFm_e!rUa;X5;`RCRos
zvShX)Xi)QOcdY!|{t5f>I;c;rg9N2Hr6e08up-22TjC-b>tq}QV~V;W7?d84U~8I1
zw5F6x7(vMv_cqZn4B1Z?U}A`<LTsdn7O15r70{`VU2*NPty>G*%0n40gA&B_G}AOD
z;FTG5Muiq&QmbsJVMI&{88-g!$kO3)jZ__%W<Jp7sar9!+Tc=@85lW)1*=pnBh?Sh
z1Pnu);k&%sP^vXmDz63E<ux&5w6wW?T5BmgqE=m`1S|`d{BeHv5{)6<=z@T`Wst#_
zm&I5lQ}iaDg$w|>L0V&r`htNpXaW#ITJdZpZOE);WFVRc_+GlJ64RR}1dMPurj>^Z
z__6)O`#@1QynHgiL5B1PVQ>bxn3o`m5M()`y<!$Y=d=RFYJzp4%<P()>`dAk4%%~b
z?ZNODg<=Z4zbHUb0!8RYSKwZB=1#N6Z7Zm>x5<)2&<8JorWYRuC8yw`ZOdbS*i%Oe
z+zA}_-VPl1G4i%hI2Z_{$&Q>{yCXLTe06EU5#|<jc7JmNP0JY_-0<$Jz;!Qh+_~k`
zWYzLNk9mB7Z~M2v`R(@Y--*~Ik_)(LoGD+y0`KahMTn#b<{b!fmVoOZIpdaGpjf+F
zr%<7?Z}l#fj5pIA=TD*KJ{o375*oZB{9p;5qtdie_85A{%y4c4n8<i~rrn{=4Dxih
ztRE}k0{au@NYgL6E9kvz>YjiHtPBjiZ}J=T7k!#q#+y*kN7Eij!h>FY|J+Q_N>4@^
z{dfN>I%X8^{`=?EnE?acZ9J!DvwL3L1~>Hl<Dz+|NSG4{{ei!n$kT>RDYbn;n;(Bw
z6W2Qv2~fep$7L^eNGqD|OQ<y`(V6}CqgNJiK)Ow?(Q-rIUOD^OYlaWM=Goa(kJfJ^
z?xa!N<_`v(o8|%j#{Ix?GI_37aqqOCfJQse%LJQi=N7qDdW{UqC(p*!-^5oLTyu>x
z5F~np#IyFs8H?7O+=u!!`8s-a*ZTEW?1ZmSL#;rEYxBTGmSmeyk4RYyB>2qxz|Knq
zhb)CN2Npt4{z5ibiSKm+-)k$TCsW#I!Yqkr5F(}%zzB`B!R(|{+}*$u0o-l`br|%z
zZNei=;NghIxsfNLJvW()_@Y1_ynG4ax{_TvkL2b&oMW+N<dkaN0H}P)iGCFTK5aY{
zv|93y<z*kqGFx4lQH`76Sg}&IOjDlcwOI0w<z?NQWwmBx7i&DYq76P{#T7mJ;bE&4
zUo!jtY^&9iTZ%I?wB`9;OM>Gvtu7}cmm61ttBi7nksHzW9VWR1q`7Q49G7KrI$62g
zysCuGrSt5ejDSTVXB<Laj?HO@61nkO)NNGIw89AD*W!TLpUQLqR&KtgXZT8^oP%jj
zTaJJ)WVw)F5N_j~6n2DQdeX0)?db~<#e304IGRbYE|AX>Vr&xHYn^ZPUhlEZw|Q=y
zy1phpcI@g!AOt?NdfD2cX>lO2DkA3-R<GB}oH$=e&fsfhe(CDvI}Wc}k?Hdad<5xJ
z)Bv9&M0>cF8jPtOqdVgJg_f{8!W%sia;7iMyL8VCmm_W_K?mxBf_tnKu3J}6*Xh#|
zDw%$|Kao!KhhhBm>7FjKQ#t@d&JS=LQi((l{xKKjAZlPNRZNs`r+mv3Z3^N!1h*l<
z*~2qAUPpbTbEe~TJUg+N6Jn!G_ts~gK|ekN(Y^`mad7MU31BuPaBn1t_CW|{Pk<CD
z^2}DH>F8*ZHTtMYDOSTF3r@UftO|bZy`ueV6thgGu(+j+mm03uxm`>!hW&*ZA4^>^
zc4Wmj5PnlJa_kjXJiH!$Q#k?$#*V1`2Cjb?TrrSTN<O^4bd^@ET~)gNVO)gMt}40W
z;VVj3X}Pgi(5DB|O<W)EsKej7l4_*JQqwW_Kv8+3102C;p6K7pOmOxz0{THeBNrx^
z>LC~4g-v9Ckq|NArE_2`D)wDr{tTp4R|K)Ti0e`$!lD`AAVYz5{^1<C!KzYZ=`%Kt
zw9-%IeP74(@o@w<75$ySvI=mjPuw2oBYfR?xl$z`FO$h_@^<-q3X7s$E|=M5<7Mf3
zwE%k3p?*;B(BuDm$CILRT+Aky(YJ&Q@|?r-tp##6IC5i#0z8oST^+t){PriV@4W|b
z65Q8uah|UOIjM^H%J#2>qfAJ7M!0rY>Q;LFpx*oACrV)wkhWzg1Nrj6$I@<i$rccZ
z5))wF><^e(UrfTqcw!K2j<Gyv3dI7v4^9Ct;97tVu)o{`VixS4`E}Kmd%lXGkI+Yv
zul8J3`Sr}*PEddCvgJQ6Uv@31hi|_5CVH4jT!z6tKjhW(^tjWYR(Y~<-NA$F8c!<G
zv!}<==U?3tM1L6+2n+&QK}zsFm-6r2Yfms#@EAgN81A4RrH+%?q1W?t$`$)1aquho
zzFws!5BNV`iOfYsEF*wAR5Ex4bTYb2is<?re*)3Vqv-0fKM3QOO-`P0_#yP$;f4RE
z7Dyx!+JrVGkuKc2{V|{dl|XrPduv$NU&e1o3A_JvzaP+k@1SVO<x+R~?Hf1R{mK8L
z3b;lkpAEqbxk^{mIIOAE=PPX*)>wqb^p_ZkFNrVQC;v-fA{Yeiostv=Sl_(F6Eq_t
z@as(wL<%7@=!11*`$DkWZ}Zy_o{-OS7Wgj$Z!1ReOn#4r>v@O39D#HK_S+j`x|29R
zDJ&I`qUV^CaoF9HK&eFmFA|g)#7_4+Ef?ur;h7!87m0x*+CoeK;04OBuL5R31d<#%
zOP*-(p+$ST?nGtB(4NP^+;#bPcI^Q-_~+vE&d<P3Khx1L*N-}Jk^FT+iDTeJQe>yE
zVIHpf8MwiR-@$r8Dfy@1bI(YX3f_nYq90twPo<N^lucA{SP(UboUoF`BVI3B-Non#
zk@~0nB=CaM1t&14=6|Cu7B$gxHaxlk{|7&=Zy&c|!?^bKAH`eF-!q~td;H+>;c<>p
zu+A=FY#weATV<~E4-OBlXn1M$`H}N#md|b;%>b#J1I(C~*~_cvj5xpAniZh6^rTwm
z)7nYKKo;#7v2x{zkt<e=Or6os@YXRy>n0>8n=?!rToX7XwAD7AAm-B&h1Tq{?4E`G
zadfdKJwLn{)B`95=)onS{B-Y<qrg6Ex39<!<urU^$jq5Tk_{Sr5t#|6<F#;qN>)p7
zByg`1+=%J;7_q%K#()mEIU<7P>BLUx+PO1%el)0m2NTTA=;?RfK}!}e&8QhXN`6Tx
zqV4DZ`OZ7cksbwV#^)=6TkOB%E&%ojo5WmTHlDGXsTpLJf~2Vh0!rk71>nwrL<1PX
zp3#rvcp)NUE<hH)fS(pXIa3}U2-bz*+{R13pq|B17Ejm`5oc9Ur@_T&7O=`d^nypl
z0G27=3(7QwR*QWPUAPK;sq^qkR;thPsGhCQ9ci}GCEUGXpG|!vU(M<~1z^Ri%~D6Q
zoh>UZMpsJhnV_jOD5L%GRys|CUaGYKbDrAi1Pxb&WDZ}!9?3f!(0i(Mscce~#;8=w
z8y>6Y6*9U1OiU9P3p1>t#>eYmQ<^?QmW_@_|6))Z<-piv3>mX^AW&oHOmO&2gKjJw
z?XhQ1)W|*h<nu2F4Dv>e6k=i|KL}>rS0mwd=J!hkyM9rYleoz4!A^NF%}RXL;IAi8
zcsc>zF>=w5(67P<p<8F*E`oA!M;HnbX?{|$(qJis38wxZCh+`4eo5jSrC?vh^jv4_
z*+gq6ph%?)n6jfOp&r#IlNWwHak^Us5oY4&yWK87^X_>;PnC%$aMdhI#r;LVS#aTb
zZ8)aMQlr*rh-F|#C1pVqBg%dP0GNP#<;ft9gay(YuPZ`2kEs_NPT_&|r!$7&t}EKE
zm<<~@Y}zo4*6)=!fAPr|&GNm}1%>kJf9)G}--hX>P`5|E1*`%Iuxg8Z4^k)|LmN;r
z+VGe{q1!8e1~SkFnP=pCRW};ab8^xR>q7W%k6tBj8auX0uF~%TTIrl=IhB<;d-O{A
zmR-BH$dx!zBRg>L-~kya`1EV9JxvM{4LHGOM%cp~D3Pk7hEXG^Y1BMwEgqbg_=2PU
z%QL}*6w&NL(Sd0LG48Yj^sfifw;(Z$=th87g%c7_^ss@k%O=vp8fQ1+|ERZquNfYT
zk3!O`jYa1K={bv!k-1`R@*lh^oY1QSW0y@#CP2RgA6^i%x&=sTk=H<X328KSjw0nG
z<VZZ>U7*;nBm_@ykgx{=-5vsuM_>a411Pd7Sq22ZH^Kx$6fHzoP6kf^Gk~<vM6q6N
zbWD(br8kX1897!z%fuiXu%0(sXqiXvm9hTKTW3AgIWuBW0GeT1Zq94{VDYu>?bG#e
z1W=%NOlkDL*xWQYI%7k@yv6jIk*iRh+s32A8k^f`EI!@&VX+UI19K+tt*?^MfG&G%
z-o{Vcf)IcXY4S(8+r<7Z&2Qr~50N=MkXmQulpfFELBdg)Dc%ifKW6+S9HgT$J+CJz
zGN7f2XB)q$f1n4)(hWe~foe8<t<)RnLxqhkj|7=hAAJt8J*XlRQOxWawdg(TaE8}{
zSw;`Ll<u%$x^*Tv28y&Ebn72ZfGBXhe+JzTu1Cj{JX#EIrUS`tG#0Ic1yBKUfn960
z8PF_IE+P|cMl_TKQw5cx4|(8;66s;g%+k1Ta*R)K2*ig09p*i(U?oC89gL!SFlP#z
zh^n`^fgg1NA7<a^a4c*xhcE5L+>_U+i)cnkE6;5zRm9Qv5X6Ay4xMeqkgFa7tncvb
z!*JiA*0uWq*j3;!4~(uinHv^uIsmUL%qh&Pk7_`7qT2N1gPylp%`J(>qMwECB*jOV
z;oBjTr^{ojKp?7WnSdI`)vruL5N=Gahnuwa6_aKTF?)^9bhqM$46thY+&XK9(c}hJ
z>8;V^(GF7sed4@uF;?iC+P=2o@HezkUaF94q2^PYsNK|^)G_MM)EVkKkOqkV0a3aU
z^@StRJjRp3_Qs2Z4O1b9_QW_(fb;NSvyXIOPppsnF&7b;5^gflbr~lJON3c9kP#>%
zEU=*aM&wiGFy|rr@R;Eg7(=qh5jGn*4*_`*l0<q6(@cJH51h;4&&c)LUvd4nz4S4n
z10JHkzJXkTJbr&cf)gzGWbqI+S5Gw74?7m~2f{=<BrM^Ced0^ST?bY92Av69R|yD(
zB;y>=pe!IMaVKwa7_8^UkI5-c9~@vZB00k$C}OlA9~k`Rw4!{q3;=JMlk=xF?3bE&
zyG$1xlVRb~OzARR_DJV^2bTtAEH9NxjeItg(x%vp+#=d$bvk5D`{Y=bC-YjB3^SI+
zn1Bq^YV&I{hshPRTa9+P!;~8tTx@%hQ89VI5HLH!`FMTDH<S9)hHh7LW}U8>=H*3<
z#(bbSJ3^b&T)vpkWm>!Q{7sMFxFIK$vt$WAY`F39o6heP(pKe$^5)LX3+1jNX<*Am
z9d&%V$yrV_tPB(14LBUi47##{51?~@{Nu|n1IeAm67LM9$(C*lWCNOIfI-gWD40T8
zCzW!1<`5u(`BI*fNezJ^Opz|%No!#~m#@q*te;~}Gnv#;>EzhptbjQHi)N}f4RRZG
zz7lmT+nJ#%lU5Yfk6Wy_v}B~N&q;)<(-uDr%~sEztiW`14m!u13xbj6v{wim@WN&H
z?3p!d&ppc)is-)!7u|f#<jL3EylCMrMm=!Ih(6ebF(apR!tPiNHHMl>&7~GoS5Vhb
zw+LPU31X_?)Y>2fSYjxy>ve$6rsS-opT&A5vAy1H0z#(}<gKZ$80p;<0y;HNLe|~C
zuKEOT>wGLsG)ToC2n$+D<aUu?NY+4!H?3T!t8jQFU&nbv)!7l#TP9C#$SrqPSA%$F
zEX`;)rdcvFOLEG+c|IxcFcp}yat4Rvz~sv;tg6b(_6LIvvt~AAF+WuwM88M(A_GDa
zx6R-4z}!7^=k5XUhQaOQ2Jd+Dsg+BYu6zny)jFrKvUp0h47i(OKTBgxO)>80SQGpy
z?6$pUcd3eIENPgC9`lFCfu?^2a}095T5GiD_+mj%rdB0Unhf@wV7wx;$yXgJsP#7)
zX6%}gd=hGcV|Q)5uD}m}Pi{I_3PztkjgH8Q+lw1Y&|}wWoAZm%V_Tv3yt25txtRGL
z9|_s2@B4NTQ?6>vuQ@Q?>c?DL3pJiPN&THV3s@inUQh+5QWPH!fLOp|Br<NFIbtr#
z2F7s6C!T<KV#5LAxE#-WMo+*)=008*HphTL&1CpJIE}*uu{nmT89h33A@b`pbkgAk
z#2k*8!!b-A$3kSk!U?0ji8_xlK>iaS>_)Oi2{EpZ7Zft^&uzq?oBTMzP6yY;J<Ujt
z0*-i$JhVZ=Iq^*H5xNF>l#n3C64HvId9;vdCOans9+M!Pi5-|A!sUsm%SK`9jygfi
zDCy0U2z&OaJSU)az0HB=YMh$kS2F@OL`-O%$jWiKu)3lC&K)~I#k6OGBS&NccUIf*
zZ1fp9f>+1o^q6WUl}y@Vy~<j@tYhKaQB824Lg%mqESa+Pts^c_fN5=eV*z^qop<)#
zbQAlw*tZs0W7c>1#Rixrmjkmoo;gZpEw=t6<B6lzW9GAig7;erlh<Wuzht_%S?q?Z
z!p=uxX7qbk@muD)&!Qo8Cm0heI%O<#Jt&njP*>u*r#zW!F<JH1mW)Bww-l73&#gwA
zt{PzG&aAJG-&~04_rLvZ?@c$MFKggWGuN-r$S4eD6a_b}^m+;lJzrVkS6tz?`m%l2
zNO0o{Z)wX-6V`08U1=S*acdQqrEw{B61z8T!juKmme8Z;C$DU2DU3y%7rs;O9u!Qg
z0N<vS`{(DQZ{Eg#<>f$wE&%Y<Q^~gtPJ@brV0?Q!(2N_`Qw%gExL)$Dk7F$@F?hJ5
zA}=pLe;QDaHY=3?R#cRhf;Bn#&xHS`Ov%Z43|vJ@CfiM^ztU24Wm(xc)y!#(bd1Gv
z-W-(4GSZ^CZsRndae{j+IPP{vWFC!4&P@dxkd|DA?^=xS3hyN@>yyhyms+)Q&hHIm
zl~}bhAn~bZcuK7*C14dkCrLCg5?F)2ef8Dy@~zjDK|srOX}mx9XZ$s(<HyPPRP>Ec
z1?EmXcwCO47E)WOgVckV8u??&V^eBB1$Su=Cpfvs6!E}x0hEKIB?Oa$=zIy1B$kf~
z$pb8$@fnw(gyI??II9-~=w>k^27dFE3}OvFQY4h;45G7p%s`3{X!-?>@M+kW<_Y;6
zK3a#FIvrH#O*RXd9QLMpN$R<Knku_^SPi6-Mg!CXrCw{IM^6QjOp>Ce?R7(D3@UY$
z>lxJ`9-NS}O$u&q4yzl+N&~r|O@*V>1+c!U@}NPuNSl)R<wb0R$VKpaKrZsWszD(X
zt>NL>p==hONuYucdbuSRE$b_Mh3O7o*u5&t3Favn<GtRH5Z_T2;n8e~oL?xF({Re)
z0V|QagY$=$)msconHCu3GWq^JS{VzMY+*X3DmmyZPE}DY`(+iN#YEBlK&?O>kd^U(
z_n7eQ%;3X|mSVCO(YF?Bs1P*-uf*dq{kn|0mbz73hw*|MA<EgFsIUqP>uze<<x+^%
z#Hos3SaxGk5c5PdbU0;dC@MX%!UBvZUtO5sF7m<(E?9yFQfP~@enwZwkfiDd1i?li
z{0q!VNrjPjoAqgq67a-ANho~wi<&xby1%qWU)$D{S5RFWa22Grx%5Lih8Kh}Q_`_f
zpQo$L@efVUPgiDvZ5ma2zFfX}kF8jnzh@6zm>V1%k4U%d@urUmSD>7{n!LOk`r(4m
zq>e>ZvAHwKv?YVH4QBRdcriDzdXUc}JMA1j_0zIytIDLdxjWPSf%?*Fi`uMpS@nxE
zeVM?s=qlq9>8$@5>2)eraG@8i*V5_EVw4F&F7y!i>j!H}ii-1-Ypr_~#ns^V<j(o%
z^Tk#1ElU#RvEVEh&*!V*BNu%*no?ul@mmQcjB|oKq&JfWBKxKRHdG{xWwOcu6M^y|
zXk}62!>N)XZWeksY4GA@CTi&tQ^l8<E06Dadp7`-R$DeIeHIgz0{PDm%k9#UIPf$d
zY8zV-`0P1paci-3-E$Fe2hM@_qx~-zHO}3$d+tN&qsp|}p|d1$xm|Ylh!n~@aDm&?
zGqNV!c;wq__W{<y8;CBtf!A-G2<G7eqHSUSdzdgC(M)zv`W`+k11a}~TG01)F}I(N
z>4~QOuf7-~zRJ+#PxOMU$G1+rxxIkt?tRhS@Q1?{iz-0v$X|WYhf^;HK8HV#U0yYH
zei$WCTzv73&j9Tdw4b@B<F~$e9|ka+=#vG-h;|L}?<Y*5IuQ-&*W$p9hlX3ivAw?c
z!~x>z^^p)0_d8s~6AGj*4`VbioIDM>3phD?LC(>O^y&`L!GR!@1Ce@7a}dOX&6;`;
zQR};)Anr&CRsTbn{`YbjgtFZ@+|xK>_3{z)Q^IZT_7xTR?$!^$`pprv0g1ex!17Qc
z><OJlD5s2yff_}<q9^#D^fZ|DLzk{Dc^!QTw6A82nAKLSU7_7P<hn<m+);O(OtMlU
z@A)-74sdcos5u*tn>StsTA4j_NbUlywm!S?$z6M2EXb<oWHLJY*EBr_%Bt1Gm#Od$
zge4d3*IA;Fks;1(sV!2yfW}xQdaE>>@QO*w;!drl+!?~Vk~xw<P6&8|1K_+V`n7qJ
zs@6=cm^Y=PYZNSMSbN<t3C~T=cd$hVC*A(YmcMTubG08TfQ((iN?EvywWd2t$JP{}
zL+HI;ZSgaYC~VS9DS+~s=eG*J?gSrpU@W)?o}Is@V*cSNoolxKLAU7ssbL5r?oiFx
z-#vH$$Zs7S=Zhsu1*=HjVzC5lKo+Q2(Tu783B65pgA6JPl}eRtL_4`8C<cy`YtYy}
z-6moG%R~0QD3g}h&log-$h?Wi3^u?M&ygv?Ht`1`0|8)^)E%Gn(QLW=PjZ`lPVz2a
z<kbsQJmG`m=ZI;uKb+X}B8+z@yCu|d^wY!-XXC^_$%V3sIG|pQ2xWz|*&j_h7Z=KQ
zr*y55Agjwv`LN(9uFrv`;Ml-Kd5AVD(btVtGLn}1Il1WQ)+wvkKRyAjFY9?aaMcLF
zpdbFa_PM2{TwQUcCR1&#ZkRb+LQSl%8k@X!?f7FG5+h-4^!$&F^G$>QjJ}_E$7?It
zP$0usGqKF8xkzT1jaTAz)OFN;5y3emU`&z?Oc)lzFf2sGbTQ0hRv{n)t8xOy)#W3E
zjUlR7?!JE_J0q$aF_C`3+b<&=b(YF)^*fx|^_l5u-qyU_R<F}&4p=<dPKUp>UC8oe
z2$5WmP$W06)thEA1xb-#)(~=WmCn{U@faZfi??>3r-l?qhVhOJ2k&o(|1pvvVh@Mi
zVmF!WR+}TuYUQ<R6OKDli8ut}-9o0rCT3nz&Stfnx?4LzH;VWEI%#dwh+&bm980>Z
z)PGase~gG@U6ALng#LCLiFX9duH&DS`kBJh0HDq$KsSuz;JE}t^&}wfbII;LpCR4C
z`lrP!Ace_(!5b2u&BDB!_{YHCozc@2%$SQlKJb<}&%E^v&90h%C`rAA=Nous@`L%S
zdS{;`bpU-l7v4crcw)Qg*<8KPMwSXP!pJZS2qTLasF9^YcwUYQXjdn%!UN<})X@!x
zk^p#fwN_^YkE!+IJDf&MMx9Wqw~$ySpilWB;wWYe)j=pog6GSK`m~Y&@jToI=pouq
z;57@1s=~xMh=@Wh5x`D~6wu>@X3ifF2uM~bmphBRJ}~Ii?y@<}jiC}}p(4F(?5eho
z2WS5Iz$3$p?ISg5U^BXK;}2Jl+4+Y#V{Vu=rnD@p)Yh?W_)>pW+nBKp#R~eNMa`oM
zfYRh-HrgEKhQfL}F7c#g+Ew!L-|Twc7oFU?q2)@)@Hu0HiyrOh`f74jWM76C?7Izs
zU2|U9JHcN$b^4V{cST>G(wbGC?lR|=&8gSw79L_~bC$xM%T6ma0%OfZYrq&mrcLzn
z0!6*sRvr^3p#vgThe1Gu#S5NEQ0in!8<~yboFD6h^c4m;7rqRB`@YXS-k^+uh2E$R
z82E_+xqDE!bsf}BnVuF5*};giDfQ-(z@V1Ih#61JrJ0EjE_iyPK~bKyWZcqyhh}#!
z%aeLcnci4&W7fQVvoFH;Kl4D1T;+2>l>&P6H5%{Ws65TEw3X9#j7^hj9GNz@wEl+t
z-7{AXDeQb|I+*{&;)Qn0g4Q7qE}wJHyp_hurQ=KL0`_a+#}^v|&?y<Hh^-mE#4D|r
zD3iL0dJpHuQN0#VUc?AMi+hP1GpkG@rQ<1{XhCBXtzUWVwJX7<+0S0{7FpAhRPX9W
zlMuA@SLi*pqwmpc===8J*MPe(p$i7s+))CGJY@mm-C^o!0Mn=Pj#=Km`^@aSH}mL4
zcLXSP>0a7l=S2@A%=<(I0-uP5q6Je$1hEQ#=PIH|Ezy#(5eQ@Q9=JJ^nGwM1iC(_o
zCymex>39lBC%(I40kV9OeuGm8uO_%|4dc-tNQDR(SvUmGp_hUl%kk<VTaF*!vh?9Q
zpVpUv#ULG}Pn%<8+2dQvD<0IyO&X&||KP;qKnlvyS+oP4ZK<zD2leh3%{})VLuUbZ
zY{`smg4!WSfX7CCASw;I4L~t|#xannPe1QEj($GA^Q%!+H-W^KS-XD^q{l6&$6TaV
zqyc8~rY*;Ta9w<*DGyXlMcKAP?*R@h0bJ}!e~~{yMAr_~nKRJ#m=k(VHo=;sE|ItL
zy+BR0M39xji+t>QF2#P*6%olGF{Lu|z4B8=lx?OBVLj%axn>VLg!MZaztjIuhas6T
zI2;C;Fo63>;Ut9*3F|D`Bft(u1N$SgIcA_3ARmQFkT9pEnNh--mj@RH9gd(QIX-z;
zA~I}PBq1K*_|8S(rREjo<tv&|=}ci=xElAppYghoN9^w@amWkb4)e|;##7i$5RwEH
zd$(xK={7M$85<CWKvXcqeIOvtA7wxwG`$2@2hSz!lOb=i#v2NG;d5RfHTPtZFn!%v
z^zH+Xpi>W->A#SKo@HY};DIgQJ~$gJ4S6@~Hou47xcf&mZ`!jYcMFb#!h3!IyQdxZ
zhTuQy!{Pey=+PrX9&hOSdmch>KhhhX_0Tt9izhT{)ZOTf_csIiJ0Y(S1BLHzMnAq2
zA~pw#3l#H1>f73J|6eX(ZPR8wkvR$W#CiDD2+ok1z|To&!ErOOniD+Q6U}MCk+ZId
zSZa914GJd{3kldlB2+gXCq|s?4@f*Imt>f@Go=<DVVk1gm{wGy=1t~GR?wrSi2^kg
zQSKpqY{~Mw{3Yl*C+*8nW_i%-2lXyZ`RZW>yrE^*mJGEyUF9#SNi&3RvzDDb@Q+*f
z;qO$8{<zeqRA$$W8QYeo<t$na<EX1hkB{@w%r=?S4TneD?sXSQn~Ifb52a;CmyDX^
zSW}Ufd1qVm<`WVq$;+&*Z1D|lJ6O@;S5G?9vu{!7?su6h(Njk7LTzzRXR9>J3OSD6
zIu(tRvtaUjo}M4Php)4#EzRkzQ{z!|AhT-cp(FPKm|f7QFN`QyXGW2OXBf!yUWd(O
z$-8=xYpGMIgz}S+Q%8pGAD-ckD`)GJ86S*`%~)q^a8|C-fRl4tXC$A|Nwgal?wm1X
z>d^V9UQ;<~Vtfzkd2V4=2~hR>!6WORjfx8R=@bYLT+BSF)sHN6zW<mL^^r{{81TE(
z3AnoO1&QAa6XQ-NAn28V$K)%mdqaKiraO*3eces>s9t3&!X;I5TQo2k{^g|lp5FA=
zn92}Ij|2*1V1X-FqH(~{$pgvjN3m9&B-iQ8mFUfq9B>uj;nXp#MaSkjyMLyj_O{3W
z_40|&AMA?PuU=j-q}F@wr3sBsyzz2{RH=tmRg6X@E&sz?Z~mb|s#de^^lC<}mX*Im
zzj}^LTfOTF+kx99jVcqh0aL)?{sEp2g^@0J;#Gs*#lF|$VYD|wpB8*Bc6Fk!g#c#M
z-@NL~R*=|w<|<S`;>1s*wzEqJ&^I8hQ0D8-uJZ!mHH+Ett!Kc{o*Qs2y_y!8cdDzC
z?iB4Km;v??m4b!~b*bhkD`Gfvy+F=5tvBm(F<+!lkwwT$;gDZK(YWlES1b+(KG>0|
zI<mFS;i%gbsW!$i=|0KgFh)%d%M?u9$BeM4CW3yB)Zn12>UWWv^;dVCf3xH2t2>y2
zj;rAlOUPBo0iBCf7Zp`U&Y4V~khD+w&MR(-R98pPOr!B=Ry91(U;FBTKK&qGnu(U3
z+Ya31pX?VlcQ>MUZ~PR*&~Y>b9S1S60nR<Lq9?xM$dMIv_lhIn1Pt`-#ne9qO5x%D
z^dqD@nES8_o2XILbZQ>eiD$pH)F$fxVeZQVn>eojcV>6By6?l5ZCSD`$)|kCl5B%z
zVa#D{z?jS2<~Fyv2_YbE5+LDDfIw&nxgZDmHur%^n}i%tl7^JrPMV}io22=sX$rPA
z{AOk)TQ)T9x8Ls{Kd^RZXJ=<;W@p~KdGp@qZN=-qeau1T9!v`#U>;^3VV+=~XI^5?
zGQVXmh&aG3wU%UKyPpmT`H6ImrN*eNh!9{XAyI}HZF2<3PlRSLP>fl8#1(S_d<W22
z;%gwN^GF2Xu()ux1SL~&23cSML4yMXcpqNmSj?;=2sFUw7tA^%dCsB>>MWoD2)dw0
z;&Sp9lMK2%I$rPri=hDGj>Eb=GU#UwP6H4s0rk|T0G5E1u^P{_$;Pv+BPm&nT685k
zv{+}gWN>GV$?OGVa*FXaknuK`VX^AL4sAdSZr78$zq8nd=MBl79<Uibd<S|MH0yIZ
zCjfX6@)G#M^C~TT5UqI$=Af^&dGIm7g>^P_C%Rk-R%-j9(O{^wvxNs^&~^@wl|5nf
z=8?0<ALM}ar0pQc{`6Ds{22+mQXAcS3H<?o)vV~v+rU>jqk-%DO)M}=FY{7V3j&?3
z$MHX|qHsgj?;v|}{ZJmRH>GpvZkf!8Pmf8ZmJGeoXmlh=m0&oRZj{Nu3_jh6(||_6
zflLjUCzmEUO!%K8NuorDfWxd(qZhdJ&huazI;v$;IhmYCcR?1s1}3~Lg`oA^Ic>)%
z312;Y4v?esVYDk11kgjA2B$wQ;lZjZ(C_|_Upy^k{Qv^3>NHR((CbG)`L~})(Ul>u
zLuK1%x#$&i7Wgzf(H9@*fo&ZSH-!ne7+3{3RD_-dKYxn8>bw<w2~z&}$AMsuoWtKb
zD|&YWE6PhKK0d*PW9TsG8Wi}0Cn&5vy%Bx|nx5X+`P0Uyxr>j7y(rZi?w8LtZaf2K
zwO4I=>7`AXzXlHxoNr|G_7~~SMm+9rVdT{FHIc_~3`-ao%)juM{lyn}u?h5yOT6HT
zmPvpKN(3`|Kl%;ISZO>Dnl3hg8IuN~o1?ERniOh*0d#yR)Pd<)YV;8bubj>P?(Cym
z4=(^i-ZItq<LBOl($Lv)V=scK=WpvbesT0Hx_R(;umP5L^aV4ZamB>ht567is5Tb&
z8)Z2UY8T$M>9H7%kTTpqsE#b5=myaX4&5Qi1%?1-w*x*qk=(HHc$O@9F+(FdZxg8Z
zBul^|%sjkt?YXm`@7wqJ*>jOK{NXkLzd3a18vxONufK3)&B<5V4jgEE<>Z<<H$6W7
zjZ>$74E}!KU7tLDY{{Cpm%n}D)EnHY4r$qhefuVqaaY#Oo!fDLSwA*9Z0F8loosHN
zbN>7cb~|_H;i}G&zT#Q)c#)qzf#>K6T{a05|L1b(>#n;&NE1*=D2=fJ{v(@llF>#F
z=nI>1CJEyM`sl`Ce%rVAcVyoG?b<o=UoD<BEFa{&xW99+dh4kZ@MDwBW{NsVLTDhz
z=y&7@9wA3Gl7{Ef@Bw_h|Nd{ky?@y&#TlN(zv}<=pZ9j|uPSwX$PleU=2}Q1+Lwra
z%uLjinS=T=%V&xhKU2n3F#VVTObw>bBQS*?$4p|T;#K`TW)ZWLS&1q2I%YF-E3=c?
z&Fsh2`UG<cj|d_Ha?zvTVIme@mfpXhMM(S+mpzF;Krpm^;YaTKOu>J0*FyAJOu`L*
zt~jSffnsbhU?y959;ZO<xc!)YmbgVce6z(D^h${ETEcW*iAwpq+t0!M@Ob;V5w7^Z
zO3fTiI{w+{xmh!Oj%Lm({JSZ3?(DY&7?%RmQea#{|6<{eXIx9~?H&Kau%%rYyQ16H
zKl9A`4NpIf-uLva?(1opYGu>=Pe}`wI)nAYgV|Z8j2aE*$}?p)wbiUl3;G=rrhONB
z6g2c>k9JN&AMjbPzmDEpx^!Q{-yInR4t0h%gZxwuZ$^gKQ83w?;U&LG1sPuM?aW^P
z(5c}|d&Vpsp4lT${O5dngIHQ{OJ=r=2L@A-uQEq&&P(?e2tZ*pB}vSda-d-qtOUv}
z`Ed;XrFi`9q?iafz1FffGGL3jStSg|lzZBa9&KaM(YAZ;X#;JQ`ByIIS61eO$MVAP
z$8a8aEWZ+LBlnJyge{AYa;5Dr<W*MY@zvz`t6$+`j33Ry^y__mCfGuJ92iLG-k+zU
zW`d>1iJlagL^z?C=73+^<cO<$iw^|&1AyE2&Id<FA6mVndG?Z3ca1#sn~V3%xICJ-
zr%KhPzBAF^*KPi6D@eJp>eA8Oo41@8KWp>)DYn@<W4i7S_mt18D3)qW$$cK5d<Jo4
z?6YsZvggR#!HKIjZ(21m`1HXe&(&6NX$F%z$=^7C*?U{g1MS%D4?MVi?9DT$L|itb
zewgu|i>^GENn=RqU(@lDD@_yQX^DSsqH~|ijHRufEBb6q15{P451>FC1g|5G_s+%6
z2I_@?V(;UR5GQpZ5M<-B6&pvE;~a5dOQaXn$1M#+zY=w=MV0F}?a3YA0)bCr?;=S$
z8LQjuf~VgS#V6Wije-*ZciQS^d*(s{(L@DowiPi+E_St$mL%5}5<EMr+E>l7K^#=+
z)6Fiy-HrWD>MiQ6j}&{GCa!KyJ%m|+xi|>^(>n8vyTq^;zjiNXHVuFw@X<_k?|)ot
z!ye!wH_(TB3^?a&jDh5r@jtJ-=xajc<B7LQCAG)Gw+u4Y;W0R5(BX2hl(Bb-TjtdJ
z1+nFK6u%1>p?ASIU{ZA8t#6@r)W$|}%!{2b!-wBO-@`><JZeMjU>u03p|&%uFV}a5
zwNMQrdIuMAuuOC|JlNUEa?~e9=bzv~8UT@5h|w45IvJypV{`?2$PimcTuI?OJQvk4
zcQVKD1Wm;Af``I2|MDRy8j$|egDWwSjwRdXIv;VvX(Di$#E${1>rVZzUI|Pt-cP0(
z!GJ$<Wc<jH`hb4qNF4sB2a@QQ?vHHGPe>JhM`yI1j)<E<k<&J#?j1v7PQUm%5C+5)
z2I2l9W@z|lzhAg}6S>>aU@$a<feVydE9B)Mml#l^OXczkD|!`usK+-OelZiyD#BC7
z#~&Z}cha9(!7vU3Zb^d%fS8lSjF_)P(aoWZIA|u?Su74nMdRVFvBw5IK0;_kVoTJq
z&BYYR1W?dZv)~hKEDSd_k%ovg0R}?(n1NG;RAK7CF>>Ok1S;?!tK?M*o!+9#^cv(U
zg;JrC8@!n+i(aQt@k&-fQ-OQ;+|+sCraiJW?+E|+_ssC+cXR_X?RmEOedpWq?3n{}
z@4PIeyw^}UE=LPmBVl4n6pp}R4oVFW8l;fZ%UD6+98#;)C@48D*_n}?oZ(F7IHh33
zkq%A}SXt-sn{K=9rivxEE}UxpC>&NAvr5ZyLc4NYp^z(QS16~fG;750&m8NH-4WYA
zh+<k+hdI_3Vilr>#QMNZH%zD~)R`avcX!!M+n~kaBNEXd-D@Y^JtmyMth$BlIbjYq
z=n!3qQ?Yv%2wW#?mqwM<8=jy2tM9bR;ll?tEp(+^V+M4I!|UpjZhn%QO+|)nnVy#h
znWdvYvAKE9ofLH#2QD$B%p^DeYw5;acf4`s-KCFP(5p_PUbnX(Z_^7e@DU(=p{MK}
z{51Q_wmL!a#j!=N4VqW~#fB75Ttc3bzYvqUl;SjVB;RJSrOsJmz^}EsPgSN^-;Z|e
zUX*T6$16G_fPbO4*gfV0h>!4Xn8zJXW<rNi4eeeiVosQel8u@ZY#i|vPQfRrsUIuK
ztP(X&y7cm5GX@{I`TXBe``^#sT(xY~AZs4Sr(4UL%Ca<oEu6OD%)4hcOe<u8CabKe
z+?vjFdDcOzmQ|sM+Zq;4fpF{9`a#5B+eH0ARnDwPPp_C+Su{N0RN|~~hVqmoi<VQQ
zJ8edzEi+xosgo=za-0*+Pw5N{XNM!=a4RD2OOT(xwiY}ndX9o!eqB<i_LPIb+=+OP
z9tZyZDM0jhVz8J2p7RKZt3*)X8G-C7IAVB;&=O*aAe{k4yqsgByY(gd=q_Fh7Mq>?
zz?UQ$W>bb_PpKYyW}`b6Nu7p##roe$oOv1iGBj>BY74DjRG*nyzi54^4M9dCW4Y*q
zdOaKu^(iKh9Gz*jT8-e#7AH8h`|!s)BjmGD1ANqIO);Uu!@EDal3Nqb%naA$ULiaj
zyvA@5z7z8^J|Y!j1f4J5tGfhtUD&ibFM!lLE2qySdq()jMbP{2w{-)nh`|GYTd!1X
z|7`QaAm`CeM(lB94~T937(I*oQbJNuoru#u3iOA!e6>eo*n|G87k72YQ;GYb#AdFi
z&qV4i7-o1O-3YdT7+8!?EE}WcTdi*T0<>Z6gu|EqeChB6d|LkI-C!;1phC;p@uH!t
zJpS59R9lju^>@FyTue<KS_{_FY}zB;b?MSY;RtQ65N*u#CftOkUuZ(Vo1q$KnBowX
z9UGw<l#&RNc%j+Q?$fwYMN|X&S~2)OdjIt96O|H!Zh%Re*ZOU1o;0mOXOL7z@9VAv
z_uIkfFAtDb-jwht4Q@&TgFb!$m<BhU)}|QeZrCu_n4&%1@lisRXn&w{O%*eQ>^;X6
z-s9CE0BirEex!>87(xVGWPHaf#WBRLJpMJ--l%^2|F%J?1@<>reALKX+oIM-w<dfW
z+*$C~p<QOnwWF`!xPrJ7=?=dIaxLnrfk?0JXiEHAu*(K>9zodnPwGa#UC<+R!SkAW
zNZsR;L9h$eH(>AC2>icp1pJZLmdun{<%Mz}o3n`C!9>VTZf>4CCU#?d*-^0P=zrKs
zq#L|`)W1j$q<PX5`O=mxw9m)OHE(k4#`My)Yp-iXBKv_v--(YhrA&yaWg6%XjTuUA
zL^>S*gouzHf@e)LgC|LkM9UUahQv)LUZ5i~IUOj*VPXkJ*b)g+uK(MC1d4%}UgSmx
zJm)W*JbB?f@O19QtV`?C*@q6zUP@<Hc=gtmD{qD2XGtxdr8n5W9!B3ks_j9Ft|v$r
zK)%7Wbg9XJejj~fBbdK&Bie_4E<5pg+XH1{lVgUQ(+nT3L7gB*8_FJN`}{;1;oHD9
zi9q_>K&GCV%*?-0pTq34gb^f}9xoddr%qRw9%j$ZX^9OeP(m3MO9;4(W(#gLCP;R@
zFkNJbB_Hj?HX!NI)9NbC>FCF&-$BRwFTc3AUMjoo^Q|jB97p?4V!A#VPwk<Rh~e)2
z0RMGHJ~_bx^_%{Wx8jCmTX6&82=pV4;F=Qq+LZ4jPoYk0+6QMOvyXqWa_gV>Ys4`a
zPE0jqifk#4L&uEn<n{;X;lWNzn(ZA>=~}f1UF{Sw7bM1@vp5E~p(M7yF$A~aM5g%{
z+7S1de~U0tmmFeK(!NJoy`Wo5dS6$c)8Z}{>D7dG^p7V$eQx>o>&EQitG8H^f$F)o
z=k`4MdTdlO5n@u0tFwIOp+hs5Kg*VhosVAj9H+SLevLX)GS&>!Tt8TK&w`A5p9h+>
zj5Sl~X#7*G8-hio`;|QaS|2Fu?CN?b{6JX`9il!IWj%4u6uOipg`Tr#uv=sDpU$I~
zcF1I2OoVm}>p7neJ0-@Sy7bHQ>U%rnR-90_b9m4Bb=WB}{?w&^GS9+m9Gz#&sLw+)
zV=_XHZtv;?L4Ws07DV79u^RDuc6SRHs}GF44?K^e_a5H-*>(k?EOZm}*hH}qZ{W4y
z8)AJXiZ`xy*M?n_gr5EQ0rclR2F;$Ywj2ifN44T-J26pw=5>SNbupufC+LliNY8l)
zujqsbw>DlEiWn}II)PkD7^2T7a$9DL&mZ3mb;JRi;@?JCU@)K$WGS+Ix%^r5L5#-#
zlQIJLvvPSpPTUdht`b~;D~vu6Z#*kfK|BvV3Ua#IM~r+{d`std*UhW++YtGX$U}C4
zr7>hhfLY!yHh{2;v?TZiv5y}W5?Yrsh|#;LPWTKmQ^k5o^vz!H!~{0N5&LNZbRJ_y
znXc|kw7nQ~wTqA3+TC062_(#!(BB=8PfP+<S!RMiN}VrAbYFczs!~WmczwDqaJ7@p
z;$kPd={4Jz1=Xu7mu@?L?p)MC;`m6hv;ARbF&z2zzS2_gJK3>4C%=w9f^Up*7BjJT
z@r1tBk)1HIF5t}6F=vL`qm~fkDEv}=uv_dd>Vk7rXiCAq#ob#kTf6DhtFw;+?ZfVd
z6{lubZ%LD9Ds1MQVwYN`$sI4)o9ip88^?!(lPil-R3AQm4*iszmTWUajc<6anLRoG
z%<au3o6)hRXC7WZG+gT0n>#(Xp{AIZA4#A1B^Yn(*F191h)`8~sB&cSnC9hk3LZI&
zqOavO6z0lO$FrJ-c?;rl>D9RHw&3+dh#-3~B7z6iJ*VsJpy;#9OtlgLtq{fI!4YgC
z7OW67>*G*e1QX6cm5|uCtPk-}r(IZ3wt3pFy1{@Ql$0t-5)2xtw0HoYQC&JkDc7{D
z`{uzJGamc~;nS+&KOV(o9a!F2wdxJ@&B5P1jHYaxzv>NG+$iJaj$DsFl)tBC-dO2`
z{$^HXGHw%0HF7~(6ZRJhXm~6Wd|LPBiEoBB^Rq}M=mPrYja8Gkfc;PW{vgho`ap?c
zbcwh+1}Y==;8wsZmY~D$(BWT~sZv5%--X9PeYembQT1iWPhu~vFD<QaPfEBD|L(fV
z5Or$ui%{^EyXXzh9uGk=Wz<dthLGt#cI`V-?15ZjIm6i9T7ta?Vk~TeHc5OQaKyDp
zr~`0QT$sfB;wu=UnM%CJO+hbzMiA^_7&NI21{FGHP_?QI=oq;GP4psauPXse^=u*<
z5={2Mz?l^W<M2D5xO2GCuxa$CC3P?o1Hni4T>rF~Z?v_f?)&1~Zt~AuK4VJ%EL{cu
zr)#P!iR(rS|Dg5rF=G<yM|z?Lh^P`GUY@_Ck`6I~NJ?co<VgA}PgKCtL1IPCc3Mr!
ze0A6J$*VHiHknE-yLwfoR^cEC^oog^o^-iJnk+pkd<YCVWHh9vrCMEG^^Jb|&ok+c
zdD0c|yGF9zm0!JDCrR--0<Hx8SP@l%0hCn|RrO<^Fy8eXT^cojk>L6L8q<ymITZrI
z@PT&^9C()>^VvPoFuo*cVPQbXJjDY;W^(sH_@2*jIMR(bOX!%HYP+yLlS6Qr95T|^
zJr2K*rK&FmJgc>~qVI#C2F*l=@&B2iCWyXoZ3PVI4_1Tzh?##`!k}<#q_wk^B`44t
z#nr;oRk!bHCN|eN34P`Wea1Wu{Zy5r>*-9NKJI-J*PA1Jf5)#cX|?8#HnUcH>DL{Y
zFZ+QyJi<9+TL1j!&d7#m_%}3JS(-QaXEv~r&Cj>DQvXKaB7s5b>61x(cdjUnxbgd8
z!uy$jS(eX5zn<Y}8;eA@pJ8H!a>HVY?oh$Yq*&3!i}+s6ZI}+NpuS2{DK?CbP7pDd
z*F;ESw#XpyvF>q^xmpIqNH{t<NvA~xrZl5LZ3EZXFf>R1%*{(Jw4gySIeIM*tp?RP
zr&<ZqIBr76ykw{J8+n0+TV_nvTw~bTokxKj4(#|mIbHP;`z70XW)NHrHK`KxBkX}e
zuIY_I?$Gtd9dBoPp^bA7i&}6=%&2P;>3#gQn4NL~Q_T!zI)Mb}K?-nTI^P!z0wcg=
zFdwW0Pk^)FGWZ%qp%Q;Sf+*&ucw%OrNV|!*Vvk!Aq+tqzA`#ON1%!YZ_%ehT2#qJU
zomt|>OD!P;Z2*`t?`#%x<XqH|Gr>0}i;LK?L|orm{IO||?1f@Bj!bnSK*T?ulAt&C
z9A5PqZLEa=5xE75Mdal?nFNj~=nJvLy2~PpRDob3+Nik1B#|!!Z1fIA3UwNVfcQ=m
zLAS#Nv;=^W97)Z{B1!Z#h?hwj9<!ww*Pa(W3sOH*7ThpJ#IB4y5yYH_Ut*!{WFxZM
zpqq*L81R>{Zow}xi}7wA|2%$)Q*`y=l29+uIK4!`1>h`!%pe{UeiMBy1=jPZrA~=Q
z%?cTk3>*;S$a>$*1_%J3TMaDY*P(j5<T=bEm?<ig6Bo(CQ7`Ti`i#?5>>{-i0)7!y
zj(ADLS@8i8KGi6e5_}?c>y!NuG^F4<l?ZM_vLC>aDQ0t-YHUXSkgbJT1?@{zW5l2r
zz7DdTDH#EGNh;qmyuPKSZTjEVq%68+#R&ML)F6Nfkw9UiIXWWxTg%v@G0y|Y8>EtC
zb&4QUq^8+amQ<%zZ&V2WMukkK83r@lsl3XoW}!S=uF+VkL1=NR-6Yixv6Qnc<ODvY
zsIWL|bwS0f-M1QZN*p0290~l>`i{;7yud*S*m6sa9?u)8i~0^qQtK2sGQer`RD7yC
z0}fZqq{>FWTmVMB)tPEhJFF=RxinQ}L4TJu*tnEbqkWh&S=HaB;@MK4W{6FlqcEAZ
zwyQ7M8e|SbYD!jGwJO=^()fa$>^XHGLuS6$n#{g0)v>Hfmz4*SP}|q{-~aXffw^;l
zAWvJLF5`Igqm<>~yO5Je6aYs+xW5@&&|TW>GL4>P<@|t`S=T0Dx&IU}9d@v+u1aGq
z^`-NiAcqo}pp<H*25xQ{r?hEPA>_b+CBZ;Jo>Holm8XFbtghOVeN!Xv+z{}MQCYa(
zyfW>?REY(q%anO?1AweyG&I7Q=+U}*skC4C;za<sV_cHj09cJCM=eW-TIE~+^(t)Q
z8&~DH2k2P&7++w+cCAa0B^%6DJm)hdgd0=($y82<cLC3j&PWJzRT^o2inBP^Vi+=K
z&b~PxEXeQQw?>k+p#397x<yyIcp!uYImyY{g^)cw(yUKc$YtiVG?`p&RHsRmsrZ{|
zYM^|8-<=zB=v?w-J+EguzypOOi<NNDk)GL7y4J6?qyeioNzJOEH<i<S%l$PfsYWGL
zvun{mM%^Yiu<9g@TAiAtD_L9C;<P)U9A@)MK-@^;9FwGOoxL(E+dohSi;^_B7o{p?
zsam~CCQr4Qr0ip9$@Uqpo6`*3ik!{mD!W=8o~hNy!O}Hs^_HR;_T)4@XGptwd%C)O
zbB;u#ozYL%Z_OeOx8=BbtjE36pckaZjeQ~9cw*V|6DO80LvGv?Q&!+nrC<m5e~xQx
z#LaFT)xc}uxjrkCr4qe%UmDzCQSE#+SoHEil}QEw6u|f#JRqg2B3>%ti4RC1GwKWq
z76M&arA+EosnRlWn?yIMwS!hDl>T`Ee?5eKKdLNUTv4)ZDkp=OvKuT4m11Q7jPoYb
z-Xf=&WlgDlBcLEq<#vFfb-42+8TA~`Nne`WXGdV3U#VC*P^&J&Wv{3FLVp?HU!+`l
zAL{SAhlT>M;WqUZ+c->-BtnSy;!~zq;D2h`Hg)Q@=+dd%nwqvn$Cu69dh2h_0}m*>
zy#4ogPR(a?2F+hH^x2tdQzkVHbSsA+LZ=@@AAR)VhNacjj)GkB&{X>9RKBS1xLRM9
zMa|1C_JY#EBWBL;cVxV8*_2r$>ihcAwJg-yN_<25j0%p3>l?)UR;5$q%vxqP@pi)W
z^yEWO4|~8E8;UU-f_Zj4$NM<CP!zgE2}JP*+BtpP-q~Oh_3cCuXw31)uiSP?Z@fS*
z8$F8N`gGH#PeBQ203{?8U2r`T@)E7quGNB@=hiyY=<+_zIYP8*j+;rpL!&o7w~?MN
zppP!FO>S#vBn~*vw{H3rz18b&zr6u&a&(v$k$1Ie!?k{Axo!!O6)e$}JN;~JFQaVq
zy(mhXv~lAkF|_Bxh0fa{MGmA;wsD&>nTWe?p*$T~hxv5QUQOYroRq1zT2--Gh+K^b
zcpau!U!jWd0=18?^-r$4(poina+MISn(VLT7{bR!TR}t==68yA@5fNYUwe!sV`<`J
zwM?%vrF4}kCX47*1XD7&uBe!$=NU+Cgc3{9tBANb3~a6S_bNiPsb?91{r{poEMC_B
z|5P4`xzYc#^1!b0Sn#N2{wF1o{&FeUf9w53j>K~}i`dJ6`qD7OT}o1qAMTiIbPKnD
zy2se?y4;v_I=N7B2AwllmCCFvr7}eizO#9<P$rJ9#kaw4@jYIb!?)$=c!P-V%n~^t
z!SJ`62wIiS=)gz2N8)h$eRjVNA9W=(Yzg2yY#6mhA|M<NqaRvY&=27-2uC8Q6`!>&
zEkGOQBW<WD5^ZaX?Aa4(gZ2nGMuTE=#%&wo-Vkyr;zb`SH6@rZR0&B(Mk+r09lVJ;
zEB5RBPLm54gle<mQc}OOF?)4#rsnG=DIT#X(!n6&1UAAmfZ*8@af$^0I>a-=v7I;-
z8zD|aqqqlO!|937T=6N60dYUF?L^>@BSfDFBot+64~jt2i^u~p+#FmnT&MId`H(N>
z<6&&iTJ@}(&Ka*ENUWvP<a0T?t4h4=I`9woGruF26<&$^WwfrOCiqV*I!nYxMB541
zI?6=aaU_p_9ry;Wg6Ow_M8qFqDb%m{EcrotMlmP4^w<$=3P`s;qT(IgZn1Zg2IyV~
z>hM~Q0lLJ|fiEN$2kEr}$8<Ik@Do0qRZ3m?f?G7j&lEQRJ8BYROS3wgN(VRKNDY%{
zZzG}phZ*7|tr7%Wamfdv-NYeb4{M=SSJITvD$$R?-hn%IDL9vv`b=t5RwomGHDIpD
zaf%}>?hwG9RmvX2_nL5`tXLu9K9AzqSxNYt_G3mdGpOZd7Z_onD{S_edFo6Ak4X~&
zhOoQ*1QWZ2t`&(pC^xlc4pQ?qzv!8o`0La;t~YlQ?n$>u<p&SSr52UV!Ya3KXBEKG
zG3SfA{_}70Z_CaBgW(&~XU<=}dj8Dmh0Up{>z<yLmpAR{bu-zTF;!*ZhALLiqcZT9
zAyaz76P1*>c(?=dj}>QdU_Id4KnZ%Qyrxf!Mhk#rafu+E_S`h7;A>H8Ae3a)H!W+b
z&ysMr2L|x0w7)l4#R3Ft*gy~LA-=1f2;PB}@iHOO1Js!R$i$V@1sLiX%u8Kc+Brat
zxv7<^p2M{b!Rsui#?Rff2~OKIcP^N41pRo=%J+{<I)cA(2&iG|qG$fL5&iyg^!{Uy
zf}BS|{`$W^vj{XM))IK&li4r+`9=Jf9UYPl-bOE@A8`)vue=ASj~qdD+y8!l)4k}u
z=T4#zAD;Qpx2&Wm1{T|cSHrv|-;1_ihp}vOb{nyoDP~_cE>*;!>S!gBO)ji5L?%~t
zP*Ts~=>U(N_`PGt;*m`xSuC0x+MReZ2pu~XzY~eY#r&a43GF6&tbV3~8O<ypau_0^
zBUtOYF4=FF#22r<yDlhvNIVG_muHE)EmWy6P;9YreD4TJE2f>yRYE}-@T9sj3sNqu
zoz8BsDXUVAOmqhOi)q@LX(sR&x^-AtRZvh>!0noJ``%4^Z=W=9$&6-BU#I7qXDk`m
z!Q3d83lr}I(J&jqS+@VZ8=8n$;Fr=+*`PsXG@vaY*>_H@Sytt6R4uDf?0EaB=LCmC
zc<!mUcPMTcn<(GRXNKZltA&DDA6Iwic2T9(2i;JYuz^o+gAnU?;4y8n5vw~jYjWVO
z?eXFyeB{!xW0%A>p+#=$y5>cj%G-wSS~{?k8Mt)UP=m!{AXi-cijSZUv}o>Jv<P)1
zAT#k`Hy#nY0iS@-)HiM26F+X+^y3rj(ga7AL+E*#C|Av=^U?pThPl9Dv^a?QH1s%e
z{r+XO+Bz8-`@O7s@s7H$>UJ!y{`YHA6{=|Ozu~W^*QKYgJN?%UJ!QhA?0x>Tva`6i
zJMlR9cZxom9W%Nt@bv7jW<MSH_e*}^i6=VMJ73Sqd3|Tk{xs-+*PkSU!~LIird#L1
z7v|mizw1c8-Mf8a7fSdJ8m5eReB*nOlwe32^h!MrwN$W4Erwoq`L^zoPh+ha<wf-+
z<MMKI^Tw6b7nNsNS+4U&vD3Pr3hUL>IvF3r!R9fI;oAIuw$xNxzx>*8<Cx~)jpB%&
zO#Gn)y$J@-;&btLp*y`X*W)^m7{H~rkUb(w<8jf0hCmE#Oib%Z40?*G$837Q4^n_G
zaZ&(cwTmsH2_K6WNA_@`w~8K|AmDLZAzl{C=gVnqu}3Y#r+&q}bX32xsy@vbDfSsV
zR0||6_0h<v`RJ{>ozoS(Wc!p7?_e%c>yJz->|f<YBW<V1xvjv7E_*7;vNt(96Z|?e
z`)3kuza^`m6jpg7t9?Ux5Gl?G6bX0C_}N#6>XHiTTb7RkSv9lTrtbt(Hkbx<@AEX_
zZ(PI>FfP(8PSFk|8N>k?0c{!FEdH2<h%@2b)fNG=L?YhoNo#mO%;Hbnq6n}@Csx_3
zCRQDChyArg4L1xQ&j<*0e3ck)|Mj+|=?2U6opbJ#)~Rn95v}jLAQMG=2j&hd-Z|Z3
zNarI}-e?Qd64TJ=57(IUzFL2724Z}98DPIX1^h^DMt_JWfV;de531mHPS;6x%t7j`
zTr_`pbFct1)nn!!$N*1F-^o>U;qTFXUN@dahcMHKpI@G=uS79R&>^aeccD!4F;yjj
zm#~EY6d{brW(@5z0#EUINmK~1t~ew$Z;IiL1j*JUOYe$y{zA;ZLj~|rvq&Q7;klyI
z$15$N8Xk4bJ#b*|;=Caf4$SrD!)15?ADBM|Ju>l*!^drzRbHzRG!#{WFbSbgQuVo7
zZDp}h51MS5Uq@FYnf<l-E~t*u6)CiQ<6Shrp$3f14d5l{TiY^8yO)&=@Ve0(k)1_;
z-nM*zTYli(1G?0W^>YvC{(4|;bVlQL(`XBPZO{;P(BZ9;AClJ>Ut@4!lS*nexy;33
z*)esH)m@R+`m?Ik=fbsfYv;aNnLDeKF^pCW$b)zLYu7r8&}DCEp!ed%fqBvq{+z+O
zon3v8t_L$IHXiOtpv%c!1#opSE94`1#4ym6;I2hkE`l#hfDKKK7;=)&K{YC3s{%5t
zNx!x51erM|{90GBFcbD&(Nd2h^)2Z0=qL3p53L0E<wP51?3MOwsh6})ivGqE?(AoE
zvs#_pm(GSeTX9%AI3GqPWR>z^d2u=#P&FBk<sz*LR3xPlg>tJ~!ju+u{_UP~=m_zO
za{7*zdi%<UB3q{qpKY&ix!MY*A6dt$O59ev(`!t3+uhbYbzXUCmPXT>=9*k(x4MO+
zDsRdwRDdPo;St`hAG3_oEL=T<lZ|6UnXR}&u3lp^1jzUlflF9tLJ&U&9Mp(OR95FK
ztXuS0OUPIXhylhCqg+DE$N**w3oF?J)@8B^PeGVt2Zz!5jNFpiQqYl+1D|q~NM}en
zVHsOh;10>ATQ{-cLU)C1_qzLJ6>v&)$mnXs7ndEFlU$ThXb#G67FJDEZyq;tgK_pq
z<A#xAH|i#>5ti|)nTDJANOhrF9o+>!cNbO{DD*0H8U4il@hfXhN&j55*_v$!yKT!-
z!6!<!x60>2&Csb<7gQCxqxZvy-Gx^pKCs5!5}LD5p|ELl1;{v)Cfz0<yL9#lGzv@{
zF?;@K`L;>66y!ALV+y#ac1nEDm$a>qB9Tm|h+H?Ob`_!{Zl^zCE)WBF<a#K{^U>L$
zdosA5_!(l}n8=UF@9xa5Dj6aYzzb$4KQXDazEqqhh6M10F(fc=zga$gNI}WsK`CjI
zH>6I~HdjT9MPj&r&Y(UA{%i+!^2g&j0Wm1@Mxd^Q62cS{Xla`Ees<r|tO_z0gvSSm
z*ZP}ad2o2-@Vt-U0Ml4u>*V*BEkL`%BSca-=T0Yd&OOi`vqKYq3H#zM>gjbVvw?af
zNvxt@$Hr8c(t(JzN&tP$LWV>`!3b#wv}CB+7=ooZeU!NIRBJF1{rF&f3K6?Ch_yIN
z(O*2`+B!fNR~kT;U%a$$!A{F))Aq*bjJXH?syi^Zeq*W*6RQ-{faT9Qg6biIg2nZi
zK2<$tcA2bF)h2nB7e^nHg**C5uguD=d=*os+VDAbRhGY&OU)ag7;V_88=T`GA<Y|j
z@uGKN$cru)Io8(t*_$kt$4^h5h#na;{{ZHf;Ie%0+yfJa<Siz|7<KS9!A#rn!<9v#
z!D#hXZPjXX^{MC+63(=NCcUw^63jLyMOO@1<oyO(2<?qVpxTvR+y0k8E*M$UFaf>c
z_6{g1BQsy-HuRRiwhIqN_%+8c$&`mQ-B@#{*vuQu0*&=32)<VaK2Zla9=G2h0*4yt
zrnEuCh8bs2q4)HvtttchgUX;+v&kw0rydGqa@7{49(Z4rnpPQQFXRKga;r)%8-~xf
z8)YBK<*bVPSZ3U*(z9*LRr=0%>BD(?)pE7oAn&YHDdajOtV3fB25>U^gi<G$tJ$+k
zogsQ9DMfI~pwys?>oADxY8jKml#6x<9?^|Mz!IyAhjsRZyb+bj1T*ZlQNko_l8{Xk
zPT$ut>gIc^2A7<d%A|(7jMA46>(!zjv^x?SJ#BQ2Bp<ztet2d1@>hTs<N+-WeQ<-F
z2)19NLy!J6<bAYVr`GDg0(39Qhrr<^rQbbk;@(U-8(97d`k_~TsJ2%|IFwlLd`xSo
zM<`Gn3=|L}KRikCT`))K#AQ(><`9WH7&2TO|6a1|nx@wt5}b6fS*^&I=(P%t(->21
zE<@e4rXj8YTCGB(mHJg0R-5N<$lv$dmsurFD$ked{zcNgue|KJzA>ZsUB7_@3Yzu$
z1{DWYET>d!l){Xmb<<PTY6XDGVMYU|O;0wS-L>ZoNu_50RVuFN2F(skH~5BR9EGp7
z39Y=H>Xa}t&LVhZASh!!L5mCs_&;nTgf7|yk3HBl7}-JFS@bD929HIX@HJ>d_Ormz
zgd(tw2s+6Pnv6uJlSHv(<gw41K!oWbJ0kD&VA6@-WD#V*67<OUpeHB;9-(*Fh3A0=
zebd<5guVfmtg-7*IhzMwMdj$ffd$6`3;HH&EL(SjN<Kx5Q5w(SB;>&eexwS#iXZ)N
zoZT6m9e%J8T)jc3B=YKyWDK8)%V}UzW1c7nFe7mfjr8;i5Z_tlW9nrA>S&kxN};I;
z)z6HDe4?7Y8c-lMKp?t`ZO~K_f^kh=gF{W#(}_fosC3}vIfXBVeyTR(pbo;}_MqDn
z40_x_ZbNWbFgUE!v-sFz{Ku_dTt9rt;$xiyjxSwy{JyV_a~qB?TY4N{bbgBd`^+ux
zu37W$Eoa!12)%>OqUG-%oG^C(1vmozh&B+H3Scb<*5!p{3lE_yhc|y+U(lc!ZLj}k
z^I>%5&_Y=#4=mUZ?*6<D+y+y`*9Readtfqo=i<eHmZ6ot_&C77ua2WEuoh_6Tx!3x
zhEptBIN{K{%a^`=*W{=`qVZ?IujM%3I^Uho-HomsY?)qqv-u|1^u-5(^zP^G#PKs0
zx8OcA>l(uyqIA(f^o1#CBR-gn-O4$@28h>g!4gw`$1Bj7a(R$w9eG(%56Q-1T1pg)
zY=G^HwxOSa9IOIzbl{nd8=u(-@>HBEE8ny9Tn$jzY|8X8>HW{4zo(DE!E~S){N@r*
zeilw5&nyf(cw^Pzma+-=yWEa&VJ2J-<j=o=bNcy(=fUBPlO}H5IB`<+ft38rY)5j9
zX)w)2WwTYELqFMYU<}F6RFmw;&dg6S+SGb0r*>M+zT{-9UTsUj5fhjI6QbIx@tu1w
zkO*p+;Vz&dqIqN?T0%xl_wbC0FYz%@QUD3>3bk&#L~FKRCqlkw(xyq1HUXbJvroF*
zy=KFTl$7*7nR0Vh|B-k2ZZ9&MW#$U=nI%K<QD!!uDcL!yf7YOv&`&SD1e9=fBIGHH
zNKTWYKO2+yWNA`Xre2@SCmHkm<oVSlw-?4TSXw7$`BI76pVtTIf$}Ai8~C~>&Z#Je
zcm~&7FZy>Q3mvKnjmbgG!FLddTsx*3U96}it>5@<U!t>*J&w+PwQXV;o-J^KeXapT
zc>Vt(deP}E8juP0JNU?ie$lIsqt>ssZv6^`ABRGCV#j3%0a`2?;6QJHfMY<BF9WS{
z#B|i}!Zctu>2o|FrZ#TBn<1FcC2qgNq=ptVV<AfF5cf7eZxS`QsCr$X#9xe83^+<)
z&3X&)LY#nnCPv`jL+>Y}zxM<F26SSKX~MER00((SlxVHsmi+V&%!c>U+{Yp4+u!7v
zZ(mrMR6PZRFYPsimN+h{z7)W->Op<1;4J{QhoV0^X2Yk8qSrP90M4?;H;R{z;oZ_=
zm|E`a)46L#1vs4J0blqBz+zAUz21R;t$uHRum}p75&()|s2B}&M3IiY>Ml|POjYu@
zogLxY1Uzjylf*2+T<x9&ibqzTYEA$l&Sew`JT`8BTuZttNT*w_1Q3U!W@CC4B%ew{
z`1~NjCd3y7)B_&jbPMRZfVy%cx`@;{MkOAYqLxSEjNM~4V4rj(TiqGOINQmx<y*E-
zVbO76)utVj;cd-qYBHzlGvwoqTFekgfOhbZ*B${$1{EG8aPiUf0dfUjtzG~fDV!?V
zXdK$MNdr|lon}zwTaS5^3fH28>7{Z7SEe4l?mfK7dJbKFZ{520Ko%GXvflgj1``b2
zXmyj~I7Y$&(gkZaOpruh5EkCNaYEnMABK93N}kbj#NHogS*@7^T{cdYmc`b7wn@V(
z$!iDqzwih!Yn2j%QrU9IhSTv?ss*JoRk-$(4N6F=pc?!q`to&&1%m7U86O2=bE}!j
zAm})N?5?@o_;Up^Wx&h@SvQ_Zv@WwAVv6Ac0qDsj_#~LHu($m1`>$6;t;f($KJ;w_
zER22(Mhph#Ltnj%?te}4+j4fsg*(1NKY{&?ikYai{q*Vf(-H=*-txUi_P`$S;60C^
z`O!Id>`Oxxj;mnZM?eugfX<+gqa!z~;i8S8a)snHd5DZFNctE5I^9vQGafgzf*>0r
zVu~OcLoC(#go4E*u@OTcg0-RM@I2_T0b&;9B>@XAJI5HzPz^YCEBX=*m|w0Rc-L%&
zVu>o}yJdlmLUOHdv{a)=<}Kq(HQV(jUwyW3a*eB^Ooo?F=4@-<hi(~i`q=(?DY?@A
z`D16KXm;NUFiGLy=zA}tZ>}*Q|H?)%3Jd_blhB{ktZu{-nE$)JQq1@PeuPu76v|)h
zpF6ZPMUeSCkSouGf?g$Mr;Jck<fhlm@=tj4QMY^KpohWuMMKd%^vb$x%txoD_rmcH
z;ugRohodU4MEw)bPeE$<;U)x+z|Z!<-whZcg;EIU{Uy*ty#?y|ODA4FjJ};!JC5VV
z)y@LO!!Mt>37vl^P5l`9?H5}}-*}3B5EOy?4sB~*aqEghuf2L`<<^z+w%*C7F5I(j
zQv1%Fo$Zs>?O8Z~6_D=x9#o%xiu5F~vhzwSI=QxTR4JJD#UH`6vXT96L8oHt6D|I3
zKQOtBpQ&U9QhzrNan*|17E)?lNTP2M)Vn0Cp24dV0%S&DaLg<v+2p$cD)%EAuE0ST
zwU{V&tp9M|^hb)p1EpW03lBd3&=>cAm#>@n8ZbWdw@UCVNVaL1YfprmM;F%495{E>
z{5?0lIly=I)v05a-nsf|?=)})Ugj^~vFi_TY-!=1S0;_R=cmmhmjPkvvAz$1=AVb7
z@9=~(1uVA)r&TR`_$l!C$Y}!$9$K`uW6hXJBL{!7<vbj6`%5pyWo;2b^fN+m0dBan
zX}WID(4V+D%@|Zy>8_<j+|i8M0o{z~q?-|-DQYL1mXdJQWMF4$!cMZM$)4{NbztIq
z4w0DNi&!o*o)`a&%Vi<E#|9tSPZO1(@&DM{v%Ab411wMU`aE>IO>_~BN0rNc+baW0
zGrejyNpIkw&sH`C{ZLq4&3z3@@Tu^LceN-N8gqsQZ?3cFRAe|!a=meM-~6FvKBo@6
zTg^wpqf1w8o_A!*ID_o_2`8JY3;87SVEfmF)$f4mGxLWGEK*vlQmS7%e*D}pcXn8%
zR9Fg%>@yzg@?FE<MCBy|nUl;bcvcleh!9a1nkbMHCGMD66kWuTAYLJuh3l<Xf-%z-
zi<vi4sNxKoiQh@{vG{Z`iz`u;9Y>~vIQ+5bi%AzlZxb)^8j`eD>@ymP<y#CVhLnLd
z8@q~1Qd7-#IuLP<7VkN9{KQ@R7A+3tD7g|J5A><Uv!+Eh?Yd)gWU552QJON5sjAYH
zs?*42p(<Xk(L%kns!D6qt0Y3detKI9c+HzXqW--f->YxP)c{#ZvE0=cu+!)4+k5ft
zJ>`K^jTW!=T*~HMg9kOw8x&r+sp*L=H9L2_c5a712}<P-vnk!AV;9(LotHq?8t;PD
zH@#OsBHx=XQz)z|nJ{-|WZ&lXDSAx$R2v?;@2*=Fk|h=4aAix&p4nqkrP5TujvugQ
z*0exrX%Lr~V+}6YKuavIsN%IyqZZ`-s<df(zN(+jmNI0;!Z{=ACr+$yXtqmJblTME
z)nFvt)-?OVp1l{fiejIXWhHmao;h$({oqD4y?@P?$EUoybH@&U22{x8Qr@D04{9t6
zQCiL@gLh*6h&e6bqSUBWS%nEXrA6|BWR;dH3zw5VlXi`fd?q2-V<Bc4k+8V}W+R>s
zoEcu?K9@Q#ws5Y1i=fS54h?s9%<Ze8Q_bc;5#T0ZCYXKcgdri)0yRsw>iMAf<?%pq
zQ3FI9YXU}Uj1Z^*YF47rm^G@<`h%aYSo!_0Pt3@WauT_UZ=DY|gF`QYyA(QOhEJ!L
znF@5g$zjbi<N}FWD&r+A3xH&9v3CvHl;U!$Re#JHW-ut!?v>kiZEOyeHr}#o$Mj-T
z##o7|Z%JQ0`XF!o+S9XU+&i^ja<pk+Rm~`yx=-_hetjj9G=nxcqJL3n!tzPkGL4J}
z-14Hw$7H>uomVt6TP-)_A2bUx77~SW@()67p+r!EhtjKxa}<g;*HEKTVeT_FOHw%U
zjtQf7OsdIFmBDrW?0#r=H3U=ou9)9YR9rJ@ct-T-n1VcW^0fTYd!eyl3X>@Rbz(Y5
zw6x|W*o4N>mAh?oyF#uQrlmiIamn|(7IjR2!CF0LtVLZ}#~f&5LP&_Ec)FJ8fGHu&
zMcN}Qa~&Xys13o?m2~T{G!gRK6g!Hx=%Q9(LbzQ|Ob=nWcTP0eqkS~g+kua2v6&L*
zgkm$%x%<~xp#P#laa(bCQizJGBg8ipUKJ8aba&O+ME_Kg8@3vb0mtHL^wD=XruDiy
zi{W86Zm7DReZqq|7uqLW-4JJPN|n2O55?@zEoS5YSv!m+R^~6fAljI}_@Zca9>0F!
z1zD&4KWmyhZ=7A%HER3cwU-gEqq3M%f)y(hL6c&w6tmX<ziJ@ff*83~j@rbce+0z3
zbTs{E%>w%(MkWJxu|aTdG}~zTf6y49i|0*?(GftW=J+W=Issa(ZkVLA#E)+4RjMm5
zVcgcv&EOHW+ls_fhZv8KqFj+9`73d2Q~UK`mz>-jM?Y}Ut&%R8Q2;VkA!_$ou^T)H
z^3c1e5xol;Qk^{)^r`xXK&vLYn7jnuq2a>feUJwptiv}i>>=q^K7`-x!r%ErI!C#v
z9u5^jb&FfNKNdl1iWjS!n#O<|2pegVye*gSOwDSi_NFi_TBR~sshuwX(L|M{IBD&z
zS*bf|N{HK*`vd;!J5vcDBt-&qTf?axA5lGjE88jpgyG~QO>3(tZ<jKB2h}YmW0?{6
zlLa90xcIo%bRdYiFWwd4b-d1n{{ws$zDPCeqmiVf=v~pf<Z6QsUqXBdn_;uPBMF8(
znxLI)i?;E9H#*uQM!Rs0Q7C@?nO7JcJh=q)Qgx_9{uTGLszd%h_j7xc`}zG2d7^As
zhfC#;&o=^)i28!KJdPX0#5cpqup-5VjLM)xc0r0ypiSVu?s3`ipi}}Gy+I|FAbgTw
zX1zUZl;X}~z;nA%3P_-L410}{8`?3G&H^0ZG0z^~udxecm=hZt3sZW%XO;L_)bR93
zcnLMd42Fat*=Hu|o=|k40^aO-`T@=OY2nOAP<u&+(#Ud2yi4uSSk)SS&jUYzyTRAs
zZdjWD>nZ*LFS-xCe^UQQshkCBg~rS~)GljbVSmr~=pBy&&&iWax4*Qma(gMFYcKnt
z_?hgT;Ng-^@Z2yzPWbZ7fYuF+T@@m7YQH<+Caxv;AoWc}oWt0_4QuudYDP!izGK7K
zlqBz6H|LfOsCWxZfBS7Pf>d~5?W?H0s2{IM;#eNYp%My(rtBn};>eTTq7L}v_4STy
z|Mu3FH-{8AO&C!*-z|}D{}$-KMcW_6jUj!kzgmjv45#HZm@Sn0Ev4SUS>u4@z=rQm
z&767aJNg}E9K-(u_dp3FXH<kr>+l~)2J}qKcoF^&=?@RMaljKjjV`k*qo+X@ca((T
zaP&TjrE<fDYps$;_%NkI62Le!ST_ra_tsF%>QyhUZ-N0Fsprj-N95=w^j}}zJ}s|t
z@M!&lp-B&V?;bs6nI+F0?B|<3Q>t2B7G4ELcChW=qN!*E5RQQ=AgP;Xx-;uGscijr
z^x2rJzxvha?N)HBLdx{O!C}c>2DJcS4G!FaB}_ZRRebz$bj!ydg9<z`FyI7S39`{2
zqPL=pOb;Ixc$#3s%&6G&0>#`8dV(I}Xq(3?-5^m_j)8&@J1o40GCBNs)k(B=d_iXh
z(G3Ve;HP?eew_m^<YLK4G1wi-+Vtdk^ODnRl~eq7KRRGf29G+c1{ZDK)Kq7bt7<^&
zehCi&IOG14M9L~t;EI62L-d_xq(!M7ND9xjIz}!@E-Oo3GSbo1blhHG3f8*ROK%w*
zk)jQ1B@i0Nr~%+OIS)2Qlx%%UN}8hcH)HTRh*e6Ubf#G_qTAInC>ulTJ%iF8vez?$
zco-#mhIBK=9@~J4!Lz#zAz<ODN(dPzeizG8<pw||7COa%0A5^V#1^G^y=WBu4!YwI
z&_;pjQ>?s%cA<K-`;x*JS~hZY-w#0cGB!yK7V8J+h8i2!j73j0gS-#RM~__Ae(%^d
zjg6s-Mi#U7a+@Oi*s){T3Y%P^$h~uN<K#QdYsNNKgc{)!<x`Tq#fQ<Ag9m~1a6v)x
z)bfVqm3PUZOr>Q<xbkr>V?#qwmh8@o<>*iJC5@;_VN=NEIaygba=AQRky|X26<;AQ
z8@q<~=K<HC<ayjKg+%fYV#yX1(Q<IuSlpp?5+!E)2p~~V4FpHP%N5|&(*U3yz568q
z_WcPgT-4lg7|eO__kVc3W+M6y-MjO}zeDzm-xv1P!keY`(C~(8vw7>)R}aB2*Z%3v
z{bPRr>hsrLSaiI>Ztd?wTZ2PjpawMk_D3*kTHlS6hpru3YSjS158rTSysuK-dJ%~}
zg<)_vi?I`=GZG_`E=I{GV<uN!!ORUY;vi-!63n0c1IO86Q<SKfgA8iIf;phJwyMcp
zx}A^Gy(cGAP3I)KaB=DYp5qxumt)alE*%ncbijdPCg|$&N@(XSF5+5A%^7W+L=~*4
zF58w2YB_!}8j7wx6&K?^^%FR;5=w2C$|T4GB4}|tcxWN|Y%u!i=$!~1H~=8<0$2-@
zmZ4eSul(bgds`|iTkbvcM|ND<!oX>8d-Mr~{44ZBH<`Th9;emJOJ~tPo{o+Jvd`A<
zxG$E;fxR2=xcDP|`g@uYZAUw<XIl(wH-=RZbO4VIq+=Qg9f02(Jv5OW+y3M;+&#v<
z(Qm;-r0jeM%wYR~4R>~avWy)cO>Uafc|RBq*L8jZ`^4KW!v8?`dT+sPN4=GIxwYvE
z^TbkxYPsMuzQ(+4{Os>KhoIS~>+)A@5}|bPF-_c=z=YIP9I(M2&)~C3C!S$M+oZ*R
zkcpq8k(OgEQ4-zt<CTII*d2Ked%oK=RIBSNXa}a~YYbV%Kr1Nu#I#V`rtSWVYC)JN
zw4qk`gI3!DTkwJYBm#?9=36yRi`{N<YIJgqM*EINrBQAMfE6Syv4qiGEn3kJB<;&{
zMRY8Y6{`Rav&F_!o<9x%C$2J`8D5@v@^VmRAkh;Pk!S@&l0G0toXG4<Iv-J&CN3hS
zxO}KpDwPS^&ih?ntuEb?Zr3$oE}pIj5ME|B*~|01sUE$-lA4#Fgzhrm)<_h38gDZ<
zC*|j*S`2zmsyDCPKF>5QL@FJcW}2t7<9u{luZtUR*TN5_ZfPse$@P))d9KWmJyY8h
z&s?u=GNuIFb)Ia0Sxv^M`3K%TFn?4=O_@L2Q|At(7|RCXuQI4in`sYay5^Nf^hQNb
zy#WD_atGyCsA3GGB{o7n8tSF+vUYfBG+GMa(;Lz7Uq?5<tvAwS3AGFZD)bM)J<}Nh
zDlq2;8!LpyypO+&2Xo5h%ur@3^-t`P#Ic>o9+xP`He1Ma;1Rd~sdikqXAjYjoDEn+
z7xCmVt;bEpSDD(bC?b-g9D-y)wO`N**-1)edaB&A`kkA%d>)uzZ_W!_YUhy8!I_6I
zI{5nS9e;l4hjaTwAoQERfC-jm2ivDwvXcx}rGC&Ly|ScIKNT=rEZG)=Ri&RlU$3%S
zLwfL3pDCvNf}~VdUS=CK_~y4)@3|>;m?fNNuHFCc{zb!XKlj&%4t`;N<_q+jKP5kZ
z(__0FDqW?u8Ng<1C{ty<y&5IGmZ8#ztoObAn|rO5I=wOl^BbAh82%$lCl_KClg^4{
ztcsY8#5)2{%wvd<ji~RY1M0Vw^N_81e_Z@V@xPooz{^pKFzWf###(Gr{-d?OUbpVo
zYrk1~*s<rE1<%|(E#OqjQu9a7ZOBWJT2kkGvX&mu=LaTFs!7!>yM1<c_Jl33tzLC*
z{dl)6H;|`;5`(oQ)0=A4G`d{X({tqR>a}C*Zkbe5m|>7Z)wp%*#*JUM?u_QK6+^<q
za{7-M)!<Vb3i|mnodtb7>WqRE8w9f&toeEF;`|Ji5FEec*2%+mZJb(G(lB?9&s&q5
zCYS5ofw2Lt0f5jjSCTtW*e5NyED#P34Al4%?es+Z_Um>QT)nOnopi%iz4{tml>&SO
zJ+C6Y{c$%zI+D8uMzJus*30WQmw-)Up%NWpZQo@r&)7pi>&1(Epf$S^{i!9&A!66C
zpr_3{I0~}b_v~p$m+=vNPs-5RT_}3sdl$Up(LL>5PYvr)^n`E^-j;YhysjmCxHk_c
z<^WoMsjaSSAGTNf{L|J6CfaiTtJYZ9U7!C!6ZF=daxoPQ<1$c#X9~RzFmq3}yhSDX
zu5+=O2#!Q=d9;nhaKLVseC%WmhP11ZG=qV4N+ylDI%*7?nG6`Zpdtq*ITLMkm$)&F
z#zz9x6+y41noTBiDkx(IbzWtKBuAoGPRFmVF`{1zLZRZ}dp`RtW`{>kCW>Cvhp8cU
zcrk7&t`8jZj)CVc59<YLU@_Q$&lNAZSsW!@VMBoEzpxTA=>-7mq&l6k&p>r+iOy_p
z+yeli&$N`9rP9IP4#qoJx>Q51!Az?Y+F^DHIl7X;G2#@X#0?^`bCVr9OS17jr<G53
zb*!DVX{KSv_y<IN_6NrAFwERENiiV*0RjnzBk~8Zqy?jMy?y(7;Q<`%Y=hZWaLnrD
zvaP5oIU|h21csrBHcxlhgu~gKlU!uO4DJIo13cTfh}>S(hz5bX^GZp$6!(7z?w6m^
z_1SRZJ<G|GjWGx7D7KiX;EAQ0qPSN$yF#RwP#IG~hyrn&1=iOUA~~?1hEbSBr9u*V
zHVlFqxtuHIt?1biLQ<PnE@Ouw9QsT{L$8w)P6-BuNtmVtgGLC+ZJJohScv2!BciHn
z47k#kbd6D})on@W89cpdL23Mq4{b?6yaxu8ICL(4Rw~7{={!8o?2p-V>ZnD&MbKFU
zR>taBqDKhu_@~yGc#u*APPS&>{{8zlf{W+^C`N_XCV?<&oy1&&zY8yV`0USTA6^uW
z2f!cq?PquF-`6=6Tm;4V|HbGL=Gr852A#nVfEGMfUweH`QPG;$K^Y#eWnx$yn_1Tw
z_HtLb7+27v3wjJhia?Yq@d=K41pl*x8PPA%ALfH)Xvchz4O14MIt3P<Iu-qIba(U%
z_!_!AA1nvU=cCK;wdfb3-AzmnjL2%TnIeYik}7pcmn0PF&p;$&RJKSYV}v+!u{%6d
z*IZZE9Ic}#uI@7t#c#c;qs?H)Jy6Bj={edIyYm)FSI5%ibtpX!`qygIx8qK3HR^eM
zdOj9SWlHR|L6Ru{ER~>WaY@sNuNdMI#*hs_5g|{3VnAF%$UqSZTbkLV&b#$$VJ5f$
z_o1hvKfH>HUzHZ~g);@UzVmK2iC#+CP^S#8Q01CHNvBLQA$m8QVTo==Z<%sc(c9R6
z;44dlEUpcI39=(oM0}_Eoq*bydk7j9MW5u2WH~RYR%VEbm7+@!GFjlc^w=?WK=byk
zSDQfNm3`|`7R5e@Odp4$&#b;sZm2VqUs(MNijJH912_V{0!My;t!>eFCuTx0rM9Vl
zDgd{%wLX7h*198~%xMIman2`4*3CNc{M+JW5XW|i%T~m7mVwE_{D5c^ZgTn!)JvJ8
z`$x9{fJdN4EwL#MugrM-*Gs1lvYnls?2qUq7)?}mqfM+wDYc_5@4SPy*riIPl)Eg&
zOSWgxT)6#XeE57!s3R*hW=x2?92x@`M<UF%b?Xp8M_|No=Y8afYs|@$cuYz=vTz>U
z<O2r|7`q=E(?g#noy<xgwwW(U2Sk&{V&ll3Dv80XPab;gN*qsC$|m3hYUqV*q`7qa
z#f;2xa*ro8v(cX?<MQg4E!|st5P)KT>d?1PL*3$$eagMH9z2ZB0{=I+HQ0EyN(K5i
zqd%FqH=o-79K873hBuZObXi(kdhX0klSk>Kqi%b6!*Y9-gw4n_mE)1Ww(o``cYX9K
zDBd=><@AGJKK#d(qefZKvmgy7siA!glc4ujKzFyO7kb7E1kUbqtLZ+o8e;lNl@l-p
z4f=?xxvw}FBCz<-LwNkyh~#>$MVNn~oX^it=37w*`Wkgu^OY&qmlwbkYpP6cPL`?j
zw9<esM;DN4^VG6rvs{*HO@RwuwxXx0@Dpxd^df%pbJX$TqD3zP9@qf?BC18_&=(h0
zuf70MK`BV3p>sD{|BNn4k%U5$l#+ajS9$c4af3|Bg>o+2xP8^C?Z#|QUYKkeH13n5
zO0VQN6}2wz^(GRUzxo3DqSp&i;f++(aIde%^!xc(8xO`YW@;)!S3d>{dGCp7cjETM
z-Cp7aR9}~%H{!|71x1BwBPb5iRRys<Bszp<eoZx>$5muY*t{~<c}H;HtrO1g-ZJaf
zRrdku{wE!c<-Gl`)@mF0I#a33Jr9;<?`v+}H>dN1x#PF*d2wIIo@Lwno`*jVEQr3J
zQwrGrdEgQ0;&qqrzIEo7-4`a_wj>4Qjs2C4uWC%YWD)e}OH)Dr;;)V1p=Odz`%4wu
zm+fia_rkvIjSF_4zs?WvFzP3+mmgq)A|R-txDigHLu`=ZUQm}tRMW*PDxg5S8ftCO
z9)g(VOyqCbmY5r3;<lKvRph$uX%>2AO7W$q`SZq>lzP&9GOa>7U(N}u|G56c?@{M>
zCuhw%`5oZs8SL)O6xYXd)Pv89>&tB>y)jio_xP%veKMU|RdQx}PM;KGrBc!$Smmw%
z1^VOc60=25_hO}Sdw8y~{5ZNk3}LRNiP+G_r8&3-+{Ew>kF9iIV5uGlT@9xY%^y1E
z@FI~lh<KgpKp^;x>7+xD?%{C~tRL!ZkEnY9Gf^AzgGVD1|6glY0v|<{=Id2;RrOhY
zRCo1}zS389=jcw-S2}0sAO><mI07BQEr$dUl^~!*1qDP!Ks+D>@xW_Ta8}V>cUg4>
zbrya*<B6kk%(yTPIK!;tD0H#!Rdpgko!$NYHovZZ^<KZKO27Wzcf9v~-@j)d12$JR
zFv9&bBO_?lD)4B7Ri`eCJFEo$COOF~QyPpk&ARj|S@<{RX)SK>6iq{AO6V)hSS&tD
z74g;t6@bFm5ZhdYLS>|u3-1wff>6oc$<(DYnRH#&Tju4=;AJ(96LQVn!fqjXsK7?q
zteUDkJw6redHi#WkJSL2P#Y~;9O|RDc!Jq)Ni_j9PhNkbJUQLnl*g&vtWE)D2)`(m
zlQ^jgDW3ypfegnLaxpg=ft^-hGCSn7DyTh|VlCJ_Y%P*-1R2Z42LW~jc|x=a0umG(
z(g3cI5s>Bx+KW<a#=-<2brP=sMT;5y?O8x{&zqTuWfo`O04(z{!wR1zl?LG(6RW|C
z6b8`B7>UY@hlLA_(Z~Sx5%3Vu+N%qrfs{=L0AOt8fx=LYLyx}-+iQMkw+^?zoa<jc
zx*gz7pm=i1B4N#P@NQO(?p`xq>(k@kFvhoqTYn4Z(0?&TVXn$|-K_q?;{Ju1yga!h
z({o2<Waa#+HrxNPUD_KZ2gnQ9IIIU+D7Qng5JTxoab5y$<l&eEVo8+fLtKFr5!LZr
z^gAsk(?ceq`3Eny8o)xHB`xhhdN*^BP&p5}30eRWTXeM408Pq3t_eyB8eeFGnuT1U
z(E7~17LSHfl5*hp139UrG#*Q@*{4+~<N){CrnrsJu1Iy%I$RV{8VHn@=hfaw5NVIq
z=$<lU3$T7a!UJq+F&#`8Sa#VmRNJxRF;tm0Yt}SW?Yr^DzK2!4D;2WhJUOFMktWt5
z8xRH%TqLPdG4i}(nPO$HimO)34f@EWWP_T%?znK__;suJj1K^VTwP7<3&dGJ{H6%b
zu;u+0_8$-i-EvU195w6^x_2Bw4Vgax><<~#)CWc0uY@yV4t1lL!+Bst*L8`wM@g&}
z%3_4IH3Q1yrC2|t{JXIGum`arF%Dncaq;C!JXc=b{<HnA+U@+g`u|k^-1PvLvKsFd
z3+aXLy|OL4_s2cHbBh_6@nvEmEc=NXDHYjKwV&*ntAUxlKRf}K3ZeJMZKEoem_5?f
z=moa?xN=b{h*7nl>L|T(xy`6c6gHAAz7?B@EyPx1o1rR@8@0qRiYB1JaCDU<EeX>|
zAXP$yTtib&j06(b8%29>c<lXBo8<2yEl0XJzl2GL6jTYDjU%~Xzs_8PWcPn5zIOp^
z8njq{Ay)9S=9tgxas;#|hma+{XoorK^8|UHgr@-e4C6Xv#r~iP7I#eVSqF=wz;_gE
z67@MYpKjb`lI!#_(<{KQFj-aVB3;kFbF@wuGkx`>xajbRwDeGX8Jh;MyQB(MIj1`k
z@&;<^LqjLgs?4I)tVtz&I5sOOA*`VPDF+(ysd$O#34&5UqH^oeqxT`zj$;qp1Rn(d
zfsN}$Rqy;xScOl|`REdtF?lxUgE1d_QPk&i5%r?Bn?M=5B4XrC4tNnsA4Uudr^_UF
zSu~<$qSro@cLCln!2luzO*UajCY&g2iB9D3^5B`6P2Vpj?jtD4(;cmXCx?G4@m$go
zYeW}>q-W%VXs)>u=gcHx$})MSRbS(exA>Hv5`T@}ir+ANR+;-mn5=L0)-*>;2o2FQ
z7}V$a3?`Gom!}U7_E0*z@cGw_HmKjDVz~d<u7BWWS4SD`YKpAh60DVxCBca;;rI>n
zeKunMNDrI0*kP6W$mG7{mAwpq=TU&M121|Op2p)Iz9n9sFL&{t`0cq87h8eBYty^*
zU~ZSMMXylkTYOz}aXfD&?FDIbsiq&Ob^`reD_zrWs~j^?51$SHPi3*P%+Rt%ID~o#
z-|Q5=p38Y%QV&q#8|mTunR}0lM`p1`sKfT4{czE7D&QV*p@Pb(h+84n#F+?9yWBjb
z#Lxg~o)Tz}1ZwfaF?k4!hY0Y<4Nm4p6GZs!QCO@yxNZTOLWtl+*b^Tg^!TFY9g7eR
z51rHo94@afX3p%)zHuu1y4s_DO0A~S@a?San)=%^$21=NP>$TU=ExtMMo>MdBF&TJ
ztXP;YnKUc4NL<z&3f0#HyrD?<oJu%*vYXLu;axpyih}Q&v({@KUYI$izH$xUh;@sI
zObFgX%0Zsn<3TO}IaPp1sytE&a51i5@=*7B&|U|Wk7!2alA_dzdB$_j<k25zPa|e)
zph5_>LZhl8*3@V>+x6hfc8y7sxeF&sFIb9t9~k%OHY<>EOiOWr$>HQ^%NUn8Wt~4|
z!q%xKiX{ovioTK#K#+=qqXPG`c@1Sp%2Wiv=cK!z3o!XYidjv{+i>nw-C0V1|3A&x
zx|_m1U9s5_OT=x3lauBgjT1cGix+L}<fd|Js>%QqxOQ|1AJkI)P=`8BUdF6YPsPN1
zcF>~15oik>AQZu4kdRq<=@W4j39n}aLfwc62n`L9gv3@LxqFESn^Cvkh|^N)ASb}j
z$TSW!&o5l8_l=3j>}sPD*QIqVenBgzxX!d|-$5;<bjZ!UcN~~`*APD?5qKQrhr{lC
zcX4ODkRxfOQVC9fKW6poOJWJIqLn1(JvNzhv8!aqEDo2}Tp@hBv8by(0syI2wt;wC
zCcBT;079pjE@ypryE6M9>fN^?KCrOC4$OR6b09xhJAK8>0tHThZ%!>f^~OD{LU?Gl
zu-8YVYBcn}KpFy2{;ef1V%69LsK;OkQ57vCAS)Q&IY&q+rwhtFQVb;C21vhnf)eYP
z%cS5rWFXPz2u=(;xw}w4JBkA=S_IYt6d5n_X_}C>6cs=!*<784BZxXBl90%1-Fcr^
zmu?NJnyH98`)6T~f=?v^KqjO^DIBlj!E4!XLuC||@+-kf;n6?|MJ2ox0}g!xWWcO7
zzUF1Dd8XHnlfLtS02Y<oH7@U7XgRqJ#1mSXwnUv=gon1q)1P|^qW-U}j3>X%0+hn{
zCX?UWV*K+4t;yqW*Z=E0xzhsFczK8~CuSJ72UE|4tAsi3LRq=HJm^o5?y3+U18FiH
z@)lS1Dr^0|Vtl3_gf+LA$L9y$y~U3Q00l_kYPXtI_HFRIcrn-~{B`WOPb=+-n#eQN
z1>4PjP@X>?YTa&O4>;`YWDORN&;!PM+x4t1Ak2D8OB!`2LRBCo@jxeyk+b2iH67Xm
zP=)bJzy^>WDJTljTB{g`0!b4?y1f*>Et>DR2nS#TQk92N55aeNQRFTmf*G(zzuCv)
zeldjuhA5uPaZ>oR`FS(wz-5!4NSS0ZCCyL<{2)*-(ch>xDA)AN1xj#io6(rL{2**n
zvC1`Rp^>f#5q~?c&{U=fp`0(YfHf*+qioTMA`kASUnF9sK)?T&!r6xAUSWydIC+&l
zXg_eP5lm3fzr<57_BeTkQD;<hax-yp`P&*+nb!TD70#V;wYu*8BK@|;sDKUqM2xnW
zNg*LL6VT?RiLv%zVYWf0ETaAm494R`ky?0Fd2MDXFaXoC^wT|yUdJng_EnROcDwP`
z19}-f>|^$zOduCREk7b+=^}0_xt@wlz)aCOPhB^%oDxZnH{x30;SmHB&+(=J?}UaG
zT69BhM-ux*j8p<$lG(Ox|MJY%Z5u9Zn>pD{*SGCEeG*JK;jT}Gel;}2IP$yJHWzD&
zWOD5K?!IhS+wo==FL?7hug4Z%TG^X7&f>lvJpa+qqmK@KwC&riu9~#{uTMR5?%Xp|
z+cdt}Er*1oa{=kT=c!-6kQw9IvlsvHROMyi)s~fO{cP|3)<mU$qOHiOn^duIdtY_i
zb;J3yMA>1(LRc8e(}`ks57E7h%B2!O7#bpivO7VDU|2L)2@-lFEqIQMi5>?c03!Ov
zIaTZ`VIi~GLq*&pXLjzoAzmyqSJgdo>==k0JAf-)Wm8fnlk(Gmth1sA+!hUWjp?+E
zTknwF(-^CWwwv@|?3Ka+eBD0Aswhj}^w?uJ-S9M9SY-M{c=!DeK-LneU3vcvvpC{z
zpu4fJ^A&zq=-TGVW_C<n(666c7wZqi#>ET2{*g=={{9`JUtMf?4&jo9j$#{gViCmw
zn<bYXO2YX<>p>`U6)rmbpaQ}6NuqP~cJF1b;aUgHM|i(c9aPEWq~3Suq{FRxQl?Y~
zl_oFzgihbdZN%kTojS^R(?!>W3Y!blUM8y1F>-t(09UVut>Z{-cbcWNoZ7*$RvkWr
z?eMlwdBWSl&cL-6qsgJ>v=qC^L2_Y^EMOH*uM@uH#vsXoi&w9M0Za?W;d(d@XcQ6>
zMwsNtBw`YZ3A)TV=rCOJYs$qsNy8)!n?&l!g94Y5P(;gez~)5fogbv~6bxgiH#ict
zEwyU@9Ub<V{Zm?QG#e*!eyh7CQ8O(On_8WyaoPNqF1^(#r$2>V+SmKkwXL-=hqm5m
zU=(@jkI4aW_v(t9BU|V^pWR)=@^-C#!iIdcigGmNtIGWvlJtgxd3nK*mn60R3RQlS
zgHoy8o5sVAys^-g=eN=KmaMASxaukznDPHg16OA^ATfy!!jKMBLA6K+>nFe6W}uX4
zam@%750MTw;c`Z&iE6xc5*^feH8G7=D+ikZHfl0JB4E1fkVkcn2x?>PK8<|^OdP=1
zC&hj77B5bV71xEL#ihmF-QAtyUVQQ5#l0-cvK05leG4tn0%a+-`1POM_uVCzyIdxD
z^JbEnWahm|e)ID3e#)3pU2nOX+Eo?GtVu`}NJu%^n6+EtFyGZS6%xGtYZMzSyc<mT
zs!j$;aI2iu^sEz&hc~n0K|ve*f?hrD3^!re2I(MTi9E{Qw@oE{y@c;N)pjd3N;*+%
zw4uB5DxI68gc5Riqw(3SrhngZ<#u_cY^G6LXOY(U8d}$g-em<VF2-_x>n0I`d(ki7
zRu}joD5aMQpwL`E*<i6?p=I^Gq`DQ0bi$MOxR!`Qr-^0C=gh=Uvv9`6>rS`{P1ftR
zRcTC@`fwERcpd|-memlwK2q-J6$9-ypG#41u-aDaqt}hWk1^+H2_HTYg9|r7xYUnR
z13Ct26`Urixq9gzCkAvGK)8zgBI!`3g`H;e1-0S4g9%@+d$Nb^vzt+J?x*jM73+gH
zOZ4>WWx~*o^oCLyL!)4Xd<oDijdiwEfgZNhcOaS)H&qN!2KpPsUq>KB2N`B$zw`Co
z$uJ!MqQ38m5S=4To93P79X=i1nb5au80&6hhCGwjKDJ&T6@d}3;7I@V8Mq@?ES4F@
zmXXjl><$^s-zTny?(tYkjEHc*kOLxyo|JVCG}{IN0EPN^szu)p!6qa_89hikFx2kJ
z>(jhZvSfRYC#_*Jf#pfSX_T1)*)hewS#bQADGdo6LBfwloQg6^@={{rj%t}b1j!Hz
zaemC^xvPvU|Mv(84qha*y)7+OW*$(J{)Jga5HX%xJYb95|FxgHI~@-ow+Q7Do8Gns
zce;2@+q|mO5qs#1U}d+s?YBsi5wBU0IHeMp1BZ-P9jD+Jw%v@`N3VwdKwUqt=iqUp
zw<t^>aN3|u=CDRNtQkP#lC?O91nlAV?_v(vT*aP;&g9J|{InT1#P=RzTUB)>xGI%V
zV16t3Dq~U;mu*YSK&cetb)J$Wo>APORF<E+7-e15J8bH>l$Ot*+=$wU=gSqq5(nQz
z?-R!|zlXBw9QUhBrX;Y9^qf~HGJAiqjeOqQJT{K2lfaTpoY&zuUn`$trf#I-^B#kL
z{==WMPdg0t_#f$J=6nY0wa0$p0vV(2mOP&=lE<b0i*63);#FgHH~Z@6Np7hGa(hWm
zo>Udub?<C^37Am^dHd6^e)UaLa#WqwT$yPc_HYjJ^xw#}RoP!h>6S{<<aMf}?|-bv
z{~oHOZ<OCBOU97-*D2XRUF%yD<KBKv7v1aD7fDA{D+b<Qs71+CixfqF_7QD^CtjJo
zdfyoJgKUlnyK#H>htOI<lJaNfzYpJj&cNgjyd88h&reIfpZ*b-dRimr>f;zd&YORK
z2&xk}o3%T^I#%PMxXT;oT6W(#Gx~rRUiPK3l6!rg36y{HW4C&u9D<c>STAKSC<5sX
ztwZXC1<zsUKCiAiqE)4le0Ef*5)a_vv&dNQIa*HSkI#AYe%%w=<6F#K%<S~O+3uO0
zj{MC%hlA5WjtH3YJlPzbUwVgv-m6UbK<JIK-J|0s?R6ozy7rZX^X$np)z!1a+uRxP
zBGK6b^G?e%j1bL#WIf+PES)WO$WS<h26ZHX5fB%%qs6;zNVE60=?{yuqenLDQAz_B
z9Ay!d&wbW&(qocNIreu){kNXHQ7`3sGWDmvO=BrnQ|RB`@7csHWHZQot?BYZ{ES*&
zj|dN(q1&G}H0gHEo~O#N$}{J&vd&?Ho!fT%8QIudzFg>;S~vVWERQWk0)3>F$;y*Q
zLknEDv9z_cw6r?5<;SB+Jm|iefKJb#q32arTv}c{Jv~v2QLnu<CB|mQE+a-mf55Z-
z?=?24Stt}bj%36Yqo$5z9*cAmK?_D=b^O~iRbS18LYCxDkneShSN1T8PE3ocT!k$k
zWG;D%iJ?D1`~`{Pw`9&}4j<=x>PNs}rHtygjoVB0C3U|wE22<cEkD0YgXV4B!B7Dd
zmsZNFaAG8TI=<&HtJ)Ydntf#A!Kqvcp}?Q<^WkQ5i0>JAHTeja){kim1M>DM(~Yi_
zKL+T#LKn7oOy4!mRMLR6W7g4d7y=IYOYZla`<z0gvuCFn!>ewZ)ebDZRBSYEcH9T2
zK>Q^V1M+ndO8oVafoa_q5ZU~hv2}MXyzbTOeA&0aAp4E~M_aN;>V)Wl?50Qk%fD}y
zY*S2B_nm7VSbqG-A@6Ku>g5|TQ=K_r&Zke>s9&E|3I7OrS+xE@yP*%0%r~12;^_F%
zUTvH^=*#vq)vt3m>C#FdzzR_oGLno^Jdr3Mmz>r+s6i>EAv-bcYX=u_Jx$Q}M0a!+
zz&#xik~Ja5m&y4W+eeO%_9%1s8X2A14Bq$(zZR4h)J@vLN9Pswka9qNgzwE~;4v|&
zSQ55O$uxeAvAnna+IlNAaeb=+BBx*7CG~DZiUQ~_h<?kE#<VSHDSB1*`#TXm&Q{3r
z$L^k_ve3U$?OTCVrfJG)rx_gdOIF{9oY{7CSO3`B+kuuG7izEb9R}!+WyH1?Y$s1+
zp4{Aj1u>W0i(Gqk{+(hynEq_x30!}Qpk*P>7d*2-+t^LB**(WSQiExFho?Mn@m}v&
z_27et9|?BDitalyaCp2{BDd^giGrR|vp^O)@!>>iw5dr0I!8*)b&!kxlUS|aXIXcu
z;BGsR&Z^`(SL>exSpB`x_XZt0UoD}Csq<WjPtfkRyDk6;u~?urKYI~^2x$|&V)+xY
zQu@Gu!?>sA;!W*el(FIyCVPqs&t8%Fa9`5l)ckw(%G)dRlok~Z7>NJeeDU-q?GAYH
zV0f02{WQPbGzF>LVJU(DOxoU=-WClouJjHJz+FP;{`q%*Zir!ez>AU7(@9(=3Z~eu
zPBTN?@<x&gCsLCSxJ<ULZELY0_9FQPL&yCLeg~?_UL6xnd2e@HIY)jjf`N7EtMq~E
z*{@A^!8_M?pg#xUB|F!ux7W?XPq-c}#scn^mA2DZLGR<V>zJ#PK2)hbzPFP;-u?V~
zyv(qEBB)ckOt+1rDfo---e=ux4;+X~X0!fR-J*PnC@8ylwX$Z@OTBtp?xpijphTZ=
z&Lyo+Gz!r|bxfD0Vjc>nHew>0S%un@e({Toq_)b_*s9YHtfHaj9}l>`XGzj+0hF5+
zRhs)^OpPxxjL8<r%o|~7v!d2$B7ol^84bdr>luAK{UKQ^*{A*xG_!THto8G4X&RCR
zCUjdBbL3y<bc3`-(rx-6|7ahFkjU`uiwE{V0{Sq-&zR}>b;!57tQrDvUq&C7guf5=
z;veh)8E?PQ0m&|g(Ccr_9P3ya|9EE>3ATbOeJnz6$rb=+w}b7Bf<bpF6u32SQI|F8
zkB2g7B^XqyvM8+blefn)W7NlJW0Eh5<q$7mQ*z@#%*Ky%Pud;yADe~{Bue+V_5xY?
zp8FE`yp`<F_C+KtXyj-37wHJDTQ8*3j8ba;1d1ub+|a)cXgwsZa_AgjgmPqu2=q}5
z6IL8L;D1%GEOq?*F55=pVBxGtc2@8^{m>e>zaN!Pp?pcNIU4YQ^sa#Z?a|F*YTPNh
zSeWcROwNh)F}an8i9M}kw<Rob|Lj;%%Ha%|c)%UiuU;08&Y$R*rQB5I*!rp1OzG5O
z-iA!F1!QLUY=v^lldUsrt+aW(8-GKT7j4?W#$t%LN%5fbqJ=nYWl%7V-cYL~^{|gR
ztSiHXtI+*t2yLNz<+6Y9<_zyi<c6j_m^{_L;+(hVbT^=dAbjToS5C3YPtkVTe*f$M
zK<`!ADBxIw2E354k^Cerb`pX@zx(bLSptCXFx^V2LoU#N;Re&mHdG=f%k;5>9V)EY
z!yaQFjgCk7eWgcu>1>)te;r}oXlb8QY-;h>Sj^oB`2bT-2>U^7vqt-+sa<PQvxAp(
z2jUkwF(L=8r8U<ChXI*A$%he%X1$oBlOVI|D@xxUn7KvVj-K-m7|V0_f!z=y>6OEC
ziLRq5Ccu`v=Ob<Krmc*7+s=(AIPS^Kw>QS(Sto(mKr+=eG)y}Id!SO5Gz<v6!ktd~
zRhPd?cGZP>XM>U&F;8NzS`0<ssW~1N40Zj{!B0RdK9O%hE%B-K!%tAo`Tbq_lp2BE
z>*7y!p-Lm}mFkop+Alx&kwMLQ3`V4ltAiCiRjTcK)OjSKMsD{<V$r_Tqsr7Ap&)D9
z-@)jiM{JW~@#Bk(oC_}vtIOk4CW#A_cq1KbtZ5F$g$DOkO+VcC%4oEQ7VJNw710Wt
zUuJvFW_<r6v{_V5IlCN%w(SPDU5C}U{fnuHuU}?5?VzvPN@Ubja+Q^88VMA$*n;Js
zb%u@Yec)bTQ>o@U#O~Qs4{#`8D645sk(osc#4M9<)-BjJvAtEt3cVhp!o58Qq7lnp
zQ0TrE9MjmR=Zie;Tg2_cL4o7bV&<7K!{m{Gs#zxFizJ?uuS4I(r8Mm^!_s0S#QIYz
zt{m@25zl2KY{o^?9@#C6#%|(&faD(26K?XwHH*2<@xn_5DxIV%zd!Fcw#PP}hDujz
z+q2VI&skAH+ULDQ!e+%^3W_S)Gn}5c4rfI?qmzzEQz%eG8pek42jyz>&B(HsgyKmV
zv1KdosLgv*pQ}}r{zMujS_s@_fLMlrw)(9c4f#0N8Ae0kW%%S*&H@Tw<5}J?wNxVH
z*4u3&EWQ@fVu<{L#$jI~wYxoI7u1ex$K;n4?PYH%;dS=f%(eS|NBm>2hdRyI>Q<bP
z@$oR5t3eN$$Gf!?jN`?@1H>_jA3*Tb_g3XyGGn56bl1Ci7L0zu0uA=fi0V>qPr|S?
z8%f#OnuMR>{5A6@gzF_$?jrnatKLXSt@P&zuV<;eZK8SKBe3Y3qfLFs?ASM{_h}vu
z%7=({-7EB@yG)Mf-Nd%52P8dvhCDhVB?9V#@~%VfrT<j!g$3_J-ozd1DMTn<=qdmJ
zi2Dq>2$J&znh0wyrAadHT<AGJm~rTc&%f$ZJ4dLDVuJ%pDkeF#CUxEJ;)CYHUv#72
zER%r~ZTGf%37LAW+WJ+vM*bj!@5N7jUw-?yIR}o_j~B#f=$}Nj{YISPg2Wn*_!`X1
zxE(x<E)6D~p?#AoMybrQj}e11ys)_5|Hf*@6RhK9|6rZ^+bP^wLPBCoX$&;#f9cu(
z!D>3an&>(dK*6$Tc2@R}FB%g0si<6OV!mNNccs81>lCn}hPL3>mbbRFT+ybS34WoJ
zl#GD!wIIQg0D8i>f~md(_k)r<hDamu5XR6Ej_1hEAa?Wxohx%>$p{1YuD%Ul?pf^_
zX6~E0z^wjK8m;exNay1r@Y&~9MxT-P5kW)#k2L73LJ*;F*|`*#`=o?|<$ncUgDTHx
ztEVM#A_7}1w{2*7I_BTu9MqPn{-pBH7^QTr09LT8PMIVyMRP8bGHX`M%zFFz4YxbF
z884Yx+a(=q*k||Tni3GLb3ftpj%PTy;m0ep#E0p-G0F0cuJUUB;}1;|O&h))^5M?z
z)BRk}^TiADzVA0&y5yBSb`hPKm7d9`xJhd}wV8U`k*%EHugHjMa-AfbO4>?lndxUZ
z`PWJMg-8CTT*Wp+f#F7l9TQwhss{{`FoF8eO*Or^_UR(RbK05N^ouxK_!HL<nCYFy
z2NB}ESckz*vrjps5WSobL$Q}?78U$q?D<;=YQ@b<2I00<-MN2RYNmCJBP^yFM<D7;
z=1Y(A4@o!w>=b5z^=U(y%ulZXC>UjDU(MekWzK+;TQJYH;bzk6`YJk#TkxDg@R(mv
z@ce{daERf2%RGmbBRk;KZ2NOVU)9c%*;7Cc2)6k25TEXY@k*W4@^{o?e_hD?>ly}C
zAR(sH*jp;^jCgd4a?B5Jhy+_+`&s<XT#RX<S%w;~KJ$+)wscs<@{ilH3|PguitV@b
zSjD-Dd$5cULnDrjL0F1m62}c8JjKw{Vk;4jV%YZOgp{>%L=-Qy<Ha4Jt)6sr01jxP
zCmD$Fd@k0ng+T<WB!;CKw}9{!!<dO}N4SdN%*34|LVM77W0MiqJ(#?4lL+q~^rqMb
zgtOzIu%#TW#2gk8@Nfu?dlgf@#R}8L6Z)^FR>5L+of8rok0xgrsc0B&w~D?3^Ya95
zqKU#ZJOww=yJ2pglAF&0U}m18n;6%yFi#mNGyqH<`9=yo9cF_R3Y3t-D8ZYJb{O(O
z^dhAKrNL<CxO~yihtv>NNHH*>IdOBO0jvSBgro`N0TY`8JR(J5MTlu6RUj9bXq)&n
zG62?x*g`S{@__-{0LDlFEFLk0Bt>zC5=s-7Mry%o5DQ3Z6n7}GG{7Q~4@Qn;LkWap
zLGUeNnukOYMMxf$NGJ}3U?=8u2!M!3vY`0yF~jj?VoHbj5P3*0l<+-vIDr=I6mgBj
zL9yK9JrYJl4ZwB~r$_*b<DTG==qak^O<ZI`tkaYwl~4XCI#p}z2eDMa9(;p68q;J+
zL|PB|pOn7OSEFWLqMP*BP@oszzpv_Gn3v2ZBLIqV_EPEvU{L<-jTBuvl;w<5iY9%~
zh}#CM!B9R9d)bSaHjtYkesm8nkhvt5V^2!Ni@s@;sE1T*@WYvq6#Xnz@QhoEc6QL`
zOiGH84@z*x41U2ksCFg*rfY_BoxKLrm;@3Pu4)3K=#MK#7_Ph`soY^q>tZl|iNjs{
zi@8xWc~hvODa>v&dS%xy5V##Fx~mZ=xE<ZS>lP@v9Tl)^7AU$MbG;iDC?g#S*p)}U
zk&aH^wLuAmN=RdrCeFef_I!}ND5+3s2%1F#AME*_8nOx{1|hUaYla%^HXxT!G@(2Y
zVvBSSsOWAHavDVy$^{|XNjrrG?DiqIPz<4b5Wr44BNVV3j~qgg-gAZ%%A}P-wRUTe
z3n=P)?r>t6bPFioE;)+rULYK6Ajx8=c~2BsgyOju3C9^o-WfXG10du78HfK7Ga^Z5
zsC17HnTO)K7k<Q!NY>gtMP8$D?pYr3o>C$P2X=RmrzpTZ$0Na0>eFCN!Uqf{(yCYT
zMiV+E_`09TH0Fh-=Uy9YxH$gHD3F9}b_kxx^}*dcBu`{R;N~5oC-Qgj@D3UJw>WTF
z-#7Gf@o+0&F?!i|a2;PEdii$UYJ9yqr6j`o1v=qFLy5Gs8uCL0iA2rnAZNIQu@<c(
zOR-!H+{ss>Sk?h<<SSAve*h2il{S0(9IoigZzh)qxAPS@lQn?r`3iR)(g@UP(ErY=
zX1H{EOXXI<v?f%+Fa85=|97k=QqH(c(YV5HU2X;L=L_6=D+<@}72J~RhP(MnZpj9~
z&3r|-<gejjzB0hK0J!|c8=zczHN#|_jf=m3xW22MzrXclVk2u;;i|E<o^|TCWpc^9
zRVC{K8<VvcCX^<fUS`!EMUYbJILOlY?fQj8448q>al^~c9=iAP1gF~IQ+3rl_ZARw
z*hy7LE^q=TCf6-EEOqcDN7y7_j@ljw^rrH4Pu@#0UKV3C;vgLRb=d}4Vk{Ez1BJ6A
z)gv+(#8`?CmV75WVtg%Aeb;@a{^+h4(QRyI{<^o#ATr~pcG>jLRc&(P?Uu-0X%)Wn
z?WF!8wRPShGd8JTf#p^ssDAC*Zt-KtcPmP8IoxZobtu#QEL>H^fQ}+7{Lo%BgubT1
z$4#(}BL6|?>3YF!lzP94x?uawUhuNmnEzDf)s*inHO~F!ANxjVN2BJeIW<|Avc|`k
zoJtRh4YY(w_g`e(*S<biAKpr1z**-S#?Ue^O}i_SlW7T_bP`t^rwO>}f01`l8Q>6X
z|4wbum_Xk^Qhen%W_e9}6GH%ZpP0Z_?y+8oQ9BobcWhAUR~Ibm2+LrJ1!~8%3=)wO
zoOQR(=^4-Yi?0j7Y<V&2pB%*<n83Y4Zgi@Td;7s@9OobAkFsSu-V2N!YJ4SEZ!N`|
zP1KSGQY*aU?D0SBR(LU-`HyL(%1}W^=75kzvR{0Wj%;MS)-p9jlki-!WZ5PHfw_Rk
zt*;mr<<-0@GMe4=D`>{LBmMnms()tsU3rmIIt6K*vhTNzvqqk;O9XBquYcXKEOZ$h
zRi(M5O*L+)UN<sKY8C+@EG08Xc2qR&IvJXy{-MBO9cq)k@QdJ&d*aJCX--F8D;I4g
z;(sJ6O-HFy^Y@O&j??|LLEpH1yGL}cM!f-4oy65QhfQ2+{wSE{rD5E9a&b;pl&h6q
z+Zomg7FCF8b_!0KgPYY&p??(R&Tm57Ov`zE!#pp9qAl~CqYxz*WOxP`|1ns6x_fPw
z!{n+aMpn%E4s3w8S#Qg_k>kar%8Ie@C#T|=?BEmV%j7HT^{x?lDhIj=5bZ67^s>+n
z!-?0r<M<wDoZ%j~WB|@&6=axUy_I<P_@%pm$Wder*L6RIij=>QU@!Qr<wZY<q#7}(
z6eLXB3?drMl2_&ChX|1&c!MBXF}xP|`WQGKAa|DyUO(0^Kw{UjWQ=Nloq$Ek&Yu<L
zha-Yy8N#j1CL0vJ{(S|GQF<F1aeuB}8h!NXSy*0EOh3JUNuK{WH|wqRbBN*}^bMh3
zSW(n*57iO~o5kDe_$Dw!gV(p#B_b}b%|V#2npbK4H8Y%B^rVR3E9aS0r%|oEK4`DC
z<W0wXtGG?zvNjHed5a8ZEGSRPT>qS5y=$f=u#vdtrbUqZO)8iX0ueL`(OEUPrmvZ;
zSu4a)<zg3@DmUl#p7J9p7Geyz$r>p>Bpco0)DQI#i%Wm#I1S_$cHa#lyF~p}e{G_x
z%WkZ84xy(~FTLFPnYHMjzxSTmA;`y>`J}eOGYw$a9JRk$=-?JI)jv+1>0>^htI=Ud
zbs}|uwcp$9P(jkoPU-rZVMKLW<&|6NSGEysjL`$c5tz|9>P_x*oy1Ysc!Hc|Q!Bce
ziTAH6y_w%R#^+9R93D^~t8Tr@XSs4ula!EzZ<SMi3T|V&YEwC17G8;x1yu*P1N*Cw
zV%;*~hRh7VJo*X@BQ`WzAG>HLdy_VhRg}<sOr6au=ca}Sro7ZIZeOjL|3NC28lHnB
z_dVT;Q)Q3g>2h*bwb8A72kDc*srba5Y0t~<ykwQv2<R8{0`y9u4rZc>p4vRq-Z=g~
z^)lLlyt8-UO!f5U<$R^!j3b{WpK14!1=G*T;83-(B0(JvRh}>V?j<%;OOqW7e}}ab
zM7}kzHFWLwu|D$>NK97rjaZ<cvBrv0?xj<0v(l?J$qBCPsA&6ipW(r3VKHfE6o1k)
z+B~gSv*|fWl~`OQSx8XJ&1nT%TXs`qG{;ce*eXydPYh^RQq@gf`bLA#69FZ?6kBt8
zC8bu(%TfDz9hIG)+qp5#is$_E6KieG9;Yl(bY>%*ey7>qs0bvG?4_@vFjbJ)ut)qQ
zVDgeDLQ&SZ-Ov4f2fXpOYbQzA?f9)x$&ZH_*E{co2|v)^%5iYx4Lq4}PxJFCD(Hfm
zwCeIuwWI#0DnIXyjv~TkcE$L$33rB@s@1QF4L^AKyN52d@*Osp<9YUg0&t6lyhrA`
z>^tdfKdYl+Gy0$9UARN^`EHQRM(3(l|07rEuMT?b^_`oDnjeM>*}ph(n%CSZepc&u
z8fPnM@c0N5ZH&ui$p$An@p5ZO1G^wBgHwJ+-1j=uuZjmQ*vFFxS_3z)r*yhTcRJ+L
zr+919y!)jVx}yC#%e5R4>W(2*s|p_)T;u888s0B(jg<HOtvhtSO!5jHetsjkVszmX
zssSARZI7~!RRe1@@N^C{^7ff7g67Ue<ELIk5Vz=pT+<iY8W-To&j8$c_u93>DWLnF
zRw|*+A!%Mh!Q^#k$@?Lzsfc^IegX30eqnL&)RKQvw@_WLzp2lUO#TJGXi9*sySsCg
z%<xTv&^r0-)U@Vk4o{(@xPV?}_3Knm;hN9<pX<~FIW#WX-E4xwb8XymgQ}Uzl=MEL
zJLA?em3@q)L3b8{H?F(JI;u4@Yv>gkgN@s{G2{!s3i-fsYo)kSrFj1NNSU_=4O{BV
ziD*uO3ed6Jma8?E0ja5?C*`0X=6@;QKIlp5Vd+pR=#ebhh8$&Mt>lr@_A|{n?|S#E
ze#ta60<*g;esj?PFMo6434S?ejK1|UEk{hh?F(7P|7ux{G|_J`t#Dx^v6-%ZHW%t|
zm5TSal1uPvc>%xC>k0nT?N;-;|NaQx%q;1tBe2#a@rfoeTU2;1Jg=zXt3&=jRX0r%
zB3U6!rixl&%=y}?kemc1Dy-`YoM;jqPAV)>JEzxh-Ksj3%Ky3{mi97nH*W*ha$6p@
zENy1I|0VROI4Hf|lg1{<CcgOee-)qk^!{^nJ=p|oT|E+E*+onp@>uQW*kHCru5xp{
zOVwHfVOdUD+*8#+16Uu~b`G*BHh>Mx_1z5bf14tdeGyFp&tbxqCs7Y>hT*zn4u1C0
zB9Z$_2G=tq@sq{<rK)W3pHWUmQ>-uBXD%i)y#I4b7?Y{stqQw#79K_RcEh3{>%zpQ
zt2MO)?&U{q57wJ9ff_QGF<Y}jai`T%CS!rv2ziv~|F3v`*7;?MLlVTt(UrC8Y@OXW
z!(mb^N@k*UY--JMG|kafu<Dm+R=P^m>c$>kl(=KR+g*VAf2sQ)pU?~Oo1D?mo*4+$
IH>08b4`|GD*#H0l

literal 0
HcmV?d00001

diff --git a/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-folding-chapters/folding-chapters.css b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-folding-chapters/folding-chapters.css
new file mode 100644
index 00000000..8f1a287d
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-folding-chapters/folding-chapters.css
@@ -0,0 +1,22 @@
+.book .book-summary .chapter > .articles {
+	overflow: hidden;
+	max-height: 0px;
+}
+
+.book .book-summary .chapter.expanded > .articles {
+	max-height: 9999px;
+}
+
+.book .book-summary ul.summary li a,
+.book .book-summary ul.summary li span {
+	cursor: pointer;
+}
+
+.book .book-summary .exc-trigger:before {
+  	content: "\f054";
+}
+
+.book .book-summary .expanded > a .exc-trigger:before,
+.book .book-summary .expanded > span .exc-trigger:before {
+	content: "\f078";
+}
diff --git a/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-folding-chapters/folding-chapters.js b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-folding-chapters/folding-chapters.js
new file mode 100644
index 00000000..430a2ce3
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-folding-chapters/folding-chapters.js
@@ -0,0 +1,70 @@
+require(['gitbook', 'jQuery'], function(gitbook, $) {
+  var TOGGLE_CLASSNAME = 'expanded',
+      CHAPTER = '.chapter',
+      ARTICLES = '.articles',
+      TRIGGER_TEMPLATE = '<i class="exc-trigger fa"></i>',
+      LS_NAMESPACE = 'expChapters';
+  var init = function () {
+    // adding the trigger element to each ARTICLES parent and binding the event
+    $(ARTICLES)
+      .parents(CHAPTER)
+      .children('a,span')
+      .prepend(TRIGGER_TEMPLATE)
+      .filter('span')
+      .on('click', function(e) {
+        e.preventDefault();
+        e.stopPropagation();
+        toggle($(e.target).closest(CHAPTER));
+      });
+
+    expand(lsItem());
+    //expand current selected chapter with it's parents
+    var activeChapter = $(CHAPTER + '.active');
+    expand(activeChapter);
+    expand(activeChapter.parents(CHAPTER));
+
+
+  }
+  var toggle = function ($chapter) {
+    if ($chapter.hasClass('expanded')) {
+      collapse($chapter);
+    } else {
+      expand($chapter);
+    }
+  }
+  var collapse = function ($chapter) {
+    if ($chapter.length && $chapter.hasClass(TOGGLE_CLASSNAME)) {
+      $chapter.removeClass(TOGGLE_CLASSNAME);
+      lsItem($chapter);
+      $chapter.find(ARTICLES).hide()
+    }
+  }
+  var expand = function ($chapter) {
+    if ($chapter.length && !$chapter.hasClass(TOGGLE_CLASSNAME)) {
+      $chapter.addClass(TOGGLE_CLASSNAME);
+      lsItem($chapter);
+      $chapter.find(ARTICLES).show()
+    }
+  }
+  var lsItem = function () {
+    var map = JSON.parse(localStorage.getItem(LS_NAMESPACE)) || {}
+    if (arguments.length) {
+      var $chapters = arguments[0];
+      $chapters.each(function (index, element) {
+        var level = $(this).data('level');
+        var value = $(this).hasClass(TOGGLE_CLASSNAME);
+        map[level] = value;
+      })
+      localStorage.setItem(LS_NAMESPACE, JSON.stringify(map));
+    } else {
+      return $(CHAPTER).map(function(index, element){
+        if (map[$(this).data('level')]) {
+          return this;
+        }
+      })
+    }
+  }
+  gitbook.events.bind('page.change', function() {
+    init()
+  });
+});
diff --git a/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-fontsettings/fontsettings.js b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-fontsettings/fontsettings.js
new file mode 100644
index 00000000..ff7be714
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-fontsettings/fontsettings.js
@@ -0,0 +1,240 @@
+require(['gitbook', 'jquery'], function(gitbook, $) {
+    // Configuration
+    var MAX_SIZE       = 4,
+        MIN_SIZE       = 0,
+        BUTTON_ID;
+
+    // Current fontsettings state
+    var fontState;
+
+    // Default themes
+    var THEMES = [
+        {
+            config: 'white',
+            text: 'White',
+            id: 0
+        },
+        {
+            config: 'sepia',
+            text: 'Sepia',
+            id: 1
+        },
+        {
+            config: 'night',
+            text: 'Night',
+            id: 2
+        }
+    ];
+
+    // Default font families
+    var FAMILIES = [
+        {
+            config: 'serif',
+            text: 'Serif',
+            id: 0
+        },
+        {
+            config: 'sans',
+            text: 'Sans',
+            id: 1
+        }
+    ];
+
+    // Return configured themes
+    function getThemes() {
+        return THEMES;
+    }
+
+    // Modify configured themes
+    function setThemes(themes) {
+        THEMES = themes;
+        updateButtons();
+    }
+
+    // Return configured font families
+    function getFamilies() {
+        return FAMILIES;
+    }
+
+    // Modify configured font families
+    function setFamilies(families) {
+        FAMILIES = families;
+        updateButtons();
+    }
+
+    // Save current font settings
+    function saveFontSettings() {
+        gitbook.storage.set('fontState', fontState);
+        update();
+    }
+
+    // Increase font size
+    function enlargeFontSize(e) {
+        e.preventDefault();
+        if (fontState.size >= MAX_SIZE) return;
+
+        fontState.size++;
+        saveFontSettings();
+    }
+
+    // Decrease font size
+    function reduceFontSize(e) {
+        e.preventDefault();
+        if (fontState.size <= MIN_SIZE) return;
+
+        fontState.size--;
+        saveFontSettings();
+    }
+
+    // Change font family
+    function changeFontFamily(configName, e) {
+        if (e && e instanceof Event) {
+            e.preventDefault();
+        }
+
+        var familyId = getFontFamilyId(configName);
+        fontState.family = familyId;
+        saveFontSettings();
+    }
+
+    // Change type of color theme
+    function changeColorTheme(configName, e) {
+        if (e && e instanceof Event) {
+            e.preventDefault();
+        }
+
+        var $book = gitbook.state.$book;
+
+        // Remove currently applied color theme
+        if (fontState.theme !== 0)
+            $book.removeClass('color-theme-'+fontState.theme);
+
+        // Set new color theme
+        var themeId = getThemeId(configName);
+        fontState.theme = themeId;
+        if (fontState.theme !== 0)
+            $book.addClass('color-theme-'+fontState.theme);
+
+        saveFontSettings();
+    }
+
+    // Return the correct id for a font-family config key
+    // Default to first font-family
+    function getFontFamilyId(configName) {
+        // Search for plugin configured font family
+        var configFamily = $.grep(FAMILIES, function(family) {
+            return family.config == configName;
+        })[0];
+        // Fallback to default font family
+        return (!!configFamily)? configFamily.id : 0;
+    }
+
+    // Return the correct id for a theme config key
+    // Default to first theme
+    function getThemeId(configName) {
+        // Search for plugin configured theme
+        var configTheme = $.grep(THEMES, function(theme) {
+            return theme.config == configName;
+        })[0];
+        // Fallback to default theme
+        return (!!configTheme)? configTheme.id : 0;
+    }
+
+    function update() {
+        var $book = gitbook.state.$book;
+
+        $('.font-settings .font-family-list li').removeClass('active');
+        $('.font-settings .font-family-list li:nth-child('+(fontState.family+1)+')').addClass('active');
+
+        $book[0].className = $book[0].className.replace(/\bfont-\S+/g, '');
+        $book.addClass('font-size-'+fontState.size);
+        $book.addClass('font-family-'+fontState.family);
+
+        if(fontState.theme !== 0) {
+            $book[0].className = $book[0].className.replace(/\bcolor-theme-\S+/g, '');
+            $book.addClass('color-theme-'+fontState.theme);
+        }
+    }
+
+    function init(config) {
+        // Search for plugin configured font family
+        var configFamily = getFontFamilyId(config.family),
+            configTheme = getThemeId(config.theme);
+
+        // Instantiate font state object
+        fontState = gitbook.storage.get('fontState', {
+            size:   config.size || 2,
+            family: configFamily,
+            theme:  configTheme
+        });
+
+        update();
+    }
+
+    function updateButtons() {
+        // Remove existing fontsettings buttons
+        if (!!BUTTON_ID) {
+            gitbook.toolbar.removeButton(BUTTON_ID);
+        }
+
+        // Create buttons in toolbar
+        BUTTON_ID = gitbook.toolbar.createButton({
+            icon: 'fa fa-font',
+            label: 'Font Settings',
+            className: 'font-settings',
+            dropdown: [
+                [
+                    {
+                        text: 'A',
+                        className: 'font-reduce',
+                        onClick: reduceFontSize
+                    },
+                    {
+                        text: 'A',
+                        className: 'font-enlarge',
+                        onClick: enlargeFontSize
+                    }
+                ],
+                $.map(FAMILIES, function(family) {
+                    family.onClick = function(e) {
+                        return changeFontFamily(family.config, e);
+                    };
+
+                    return family;
+                }),
+                $.map(THEMES, function(theme) {
+                    theme.onClick = function(e) {
+                        return changeColorTheme(theme.config, e);
+                    };
+
+                    return theme;
+                })
+            ]
+        });
+    }
+
+    // Init configuration at start
+    gitbook.events.bind('start', function(e, config) {
+        var opts = config.fontsettings;
+
+        // Generate buttons at start
+        updateButtons();
+
+        // Init current settings
+        init(opts);
+    });
+
+    // Expose API
+    gitbook.fontsettings = {
+        enlargeFontSize: enlargeFontSize,
+        reduceFontSize:  reduceFontSize,
+        setTheme:        changeColorTheme,
+        setFamily:       changeFontFamily,
+        getThemes:       getThemes,
+        setThemes:       setThemes,
+        getFamilies:     getFamilies,
+        setFamilies:     setFamilies
+    };
+});
+
+
diff --git a/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-fontsettings/website.css b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-fontsettings/website.css
new file mode 100644
index 00000000..26591fe8
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-fontsettings/website.css
@@ -0,0 +1,291 @@
+/*
+ * Theme 1
+ */
+.color-theme-1 .dropdown-menu {
+  background-color: #111111;
+  border-color: #7e888b;
+}
+.color-theme-1 .dropdown-menu .dropdown-caret .caret-inner {
+  border-bottom: 9px solid #111111;
+}
+.color-theme-1 .dropdown-menu .buttons {
+  border-color: #7e888b;
+}
+.color-theme-1 .dropdown-menu .button {
+  color: #afa790;
+}
+.color-theme-1 .dropdown-menu .button:hover {
+  color: #73553c;
+}
+/*
+ * Theme 2
+ */
+.color-theme-2 .dropdown-menu {
+  background-color: #2d3143;
+  border-color: #272a3a;
+}
+.color-theme-2 .dropdown-menu .dropdown-caret .caret-inner {
+  border-bottom: 9px solid #2d3143;
+}
+.color-theme-2 .dropdown-menu .buttons {
+  border-color: #272a3a;
+}
+.color-theme-2 .dropdown-menu .button {
+  color: #62677f;
+}
+.color-theme-2 .dropdown-menu .button:hover {
+  color: #f4f4f5;
+}
+.book .book-header .font-settings .font-enlarge {
+  line-height: 30px;
+  font-size: 1.4em;
+}
+.book .book-header .font-settings .font-reduce {
+  line-height: 30px;
+  font-size: 1em;
+}
+.book.color-theme-1 .book-body {
+  color: #704214;
+  background: #f3eacb;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section {
+  background: #f3eacb;
+}
+.book.color-theme-2 .book-body {
+  color: #bdcadb;
+  background: #1c1f2b;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section {
+  background: #1c1f2b;
+}
+.book.font-size-0 .book-body .page-inner section {
+  font-size: 1.2rem;
+}
+.book.font-size-1 .book-body .page-inner section {
+  font-size: 1.4rem;
+}
+.book.font-size-2 .book-body .page-inner section {
+  font-size: 1.6rem;
+}
+.book.font-size-3 .book-body .page-inner section {
+  font-size: 2.2rem;
+}
+.book.font-size-4 .book-body .page-inner section {
+  font-size: 4rem;
+}
+.book.font-family-0 {
+  font-family: Georgia, serif;
+}
+.book.font-family-1 {
+  font-family: "Helvetica Neue", Helvetica, Arial, sans-serif;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal {
+  color: #704214;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal a {
+  color: inherit;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal h1,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal h2,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal h3,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal h4,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal h5,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal h6 {
+  color: inherit;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal h1,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal h2 {
+  border-color: inherit;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal h6 {
+  color: inherit;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal hr {
+  background-color: inherit;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal blockquote {
+  border-color: inherit;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code {
+  background: #fdf6e3;
+  color: #657b83;
+  border-color: #f8df9c;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal .highlight {
+  background-color: inherit;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal table th,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal table td {
+  border-color: #f5d06c;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal table tr {
+  color: inherit;
+  background-color: #fdf6e3;
+  border-color: #444444;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal table tr:nth-child(2n) {
+  background-color: #fbeecb;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal {
+  color: #bdcadb;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal a {
+  color: #3eb1d0;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal h1,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal h2,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal h3,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal h4,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal h5,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal h6 {
+  color: #fffffa;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal h1,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal h2 {
+  border-color: #373b4e;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal h6 {
+  color: #373b4e;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal hr {
+  background-color: #373b4e;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal blockquote {
+  border-color: #373b4e;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code {
+  color: #9dbed8;
+  background: #2d3143;
+  border-color: #2d3143;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal .highlight {
+  background-color: #282a39;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal table th,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal table td {
+  border-color: #3b3f54;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal table tr {
+  color: #b6c2d2;
+  background-color: #2d3143;
+  border-color: #3b3f54;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal table tr:nth-child(2n) {
+  background-color: #35394b;
+}
+.book.color-theme-1 .book-header {
+  color: #afa790;
+  background: transparent;
+}
+.book.color-theme-1 .book-header .btn {
+  color: #afa790;
+}
+.book.color-theme-1 .book-header .btn:hover {
+  color: #73553c;
+  background: none;
+}
+.book.color-theme-1 .book-header h1 {
+  color: #704214;
+}
+.book.color-theme-2 .book-header {
+  color: #7e888b;
+  background: transparent;
+}
+.book.color-theme-2 .book-header .btn {
+  color: #3b3f54;
+}
+.book.color-theme-2 .book-header .btn:hover {
+  color: #fffff5;
+  background: none;
+}
+.book.color-theme-2 .book-header h1 {
+  color: #bdcadb;
+}
+.book.color-theme-1 .book-body .navigation {
+  color: #afa790;
+}
+.book.color-theme-1 .book-body .navigation:hover {
+  color: #73553c;
+}
+.book.color-theme-2 .book-body .navigation {
+  color: #383f52;
+}
+.book.color-theme-2 .book-body .navigation:hover {
+  color: #fffff5;
+}
+/*
+ * Theme 1
+ */
+.book.color-theme-1 .book-summary {
+  color: #afa790;
+  background: #111111;
+  border-right: 1px solid rgba(0, 0, 0, 0.07);
+}
+.book.color-theme-1 .book-summary .book-search {
+  background: transparent;
+}
+.book.color-theme-1 .book-summary .book-search input,
+.book.color-theme-1 .book-summary .book-search input:focus {
+  border: 1px solid transparent;
+}
+.book.color-theme-1 .book-summary ul.summary li.divider {
+  background: #7e888b;
+  box-shadow: none;
+}
+.book.color-theme-1 .book-summary ul.summary li i.fa-check {
+  color: #33cc33;
+}
+.book.color-theme-1 .book-summary ul.summary li.done > a {
+  color: #877f6a;
+}
+.book.color-theme-1 .book-summary ul.summary li a,
+.book.color-theme-1 .book-summary ul.summary li span {
+  color: #877f6a;
+  background: transparent;
+  font-weight: normal;
+}
+.book.color-theme-1 .book-summary ul.summary li.active > a,
+.book.color-theme-1 .book-summary ul.summary li a:hover {
+  color: #704214;
+  background: transparent;
+  font-weight: normal;
+}
+/*
+ * Theme 2
+ */
+.book.color-theme-2 .book-summary {
+  color: #bcc1d2;
+  background: #2d3143;
+  border-right: none;
+}
+.book.color-theme-2 .book-summary .book-search {
+  background: transparent;
+}
+.book.color-theme-2 .book-summary .book-search input,
+.book.color-theme-2 .book-summary .book-search input:focus {
+  border: 1px solid transparent;
+}
+.book.color-theme-2 .book-summary ul.summary li.divider {
+  background: #272a3a;
+  box-shadow: none;
+}
+.book.color-theme-2 .book-summary ul.summary li i.fa-check {
+  color: #33cc33;
+}
+.book.color-theme-2 .book-summary ul.summary li.done > a {
+  color: #62687f;
+}
+.book.color-theme-2 .book-summary ul.summary li a,
+.book.color-theme-2 .book-summary ul.summary li span {
+  color: #c1c6d7;
+  background: transparent;
+  font-weight: 600;
+}
+.book.color-theme-2 .book-summary ul.summary li.active > a,
+.book.color-theme-2 .book-summary ul.summary li a:hover {
+  color: #f4f4f5;
+  background: #252737;
+  font-weight: 600;
+}
diff --git a/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-highlight/website.css b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-highlight/website.css
new file mode 100644
index 00000000..6674448f
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-highlight/website.css
@@ -0,0 +1,434 @@
+.book .book-body .page-wrapper .page-inner section.normal pre,
+.book .book-body .page-wrapper .page-inner section.normal code {
+  /* http://jmblog.github.com/color-themes-for-google-code-highlightjs */
+  /* Tomorrow Comment */
+  /* Tomorrow Red */
+  /* Tomorrow Orange */
+  /* Tomorrow Yellow */
+  /* Tomorrow Green */
+  /* Tomorrow Aqua */
+  /* Tomorrow Blue */
+  /* Tomorrow Purple */
+}
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs-comment,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs-comment,
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs-title,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs-title {
+  color: #8e908c;
+}
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs-variable,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs-variable,
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs-attribute,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs-attribute,
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs-tag,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs-tag,
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs-regexp,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs-regexp,
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs-deletion,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs-deletion,
+.book .book-body .page-wrapper .page-inner section.normal pre .ruby .hljs-constant,
+.book .book-body .page-wrapper .page-inner section.normal code .ruby .hljs-constant,
+.book .book-body .page-wrapper .page-inner section.normal pre .xml .hljs-tag .hljs-title,
+.book .book-body .page-wrapper .page-inner section.normal code .xml .hljs-tag .hljs-title,
+.book .book-body .page-wrapper .page-inner section.normal pre .xml .hljs-pi,
+.book .book-body .page-wrapper .page-inner section.normal code .xml .hljs-pi,
+.book .book-body .page-wrapper .page-inner section.normal pre .xml .hljs-doctype,
+.book .book-body .page-wrapper .page-inner section.normal code .xml .hljs-doctype,
+.book .book-body .page-wrapper .page-inner section.normal pre .html .hljs-doctype,
+.book .book-body .page-wrapper .page-inner section.normal code .html .hljs-doctype,
+.book .book-body .page-wrapper .page-inner section.normal pre .css .hljs-id,
+.book .book-body .page-wrapper .page-inner section.normal code .css .hljs-id,
+.book .book-body .page-wrapper .page-inner section.normal pre .css .hljs-class,
+.book .book-body .page-wrapper .page-inner section.normal code .css .hljs-class,
+.book .book-body .page-wrapper .page-inner section.normal pre .css .hljs-pseudo,
+.book .book-body .page-wrapper .page-inner section.normal code .css .hljs-pseudo {
+  color: #c82829;
+}
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs-number,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs-number,
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs-preprocessor,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs-preprocessor,
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs-pragma,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs-pragma,
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs-built_in,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs-built_in,
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs-literal,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs-literal,
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs-params,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs-params,
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs-constant,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs-constant {
+  color: #f5871f;
+}
+.book .book-body .page-wrapper .page-inner section.normal pre .ruby .hljs-class .hljs-title,
+.book .book-body .page-wrapper .page-inner section.normal code .ruby .hljs-class .hljs-title,
+.book .book-body .page-wrapper .page-inner section.normal pre .css .hljs-rules .hljs-attribute,
+.book .book-body .page-wrapper .page-inner section.normal code .css .hljs-rules .hljs-attribute {
+  color: #eab700;
+}
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs-string,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs-string,
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs-value,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs-value,
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs-inheritance,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs-inheritance,
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs-header,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs-header,
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs-addition,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs-addition,
+.book .book-body .page-wrapper .page-inner section.normal pre .ruby .hljs-symbol,
+.book .book-body .page-wrapper .page-inner section.normal code .ruby .hljs-symbol,
+.book .book-body .page-wrapper .page-inner section.normal pre .xml .hljs-cdata,
+.book .book-body .page-wrapper .page-inner section.normal code .xml .hljs-cdata {
+  color: #718c00;
+}
+.book .book-body .page-wrapper .page-inner section.normal pre .css .hljs-hexcolor,
+.book .book-body .page-wrapper .page-inner section.normal code .css .hljs-hexcolor {
+  color: #3e999f;
+}
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs-function,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs-function,
+.book .book-body .page-wrapper .page-inner section.normal pre .python .hljs-decorator,
+.book .book-body .page-wrapper .page-inner section.normal code .python .hljs-decorator,
+.book .book-body .page-wrapper .page-inner section.normal pre .python .hljs-title,
+.book .book-body .page-wrapper .page-inner section.normal code .python .hljs-title,
+.book .book-body .page-wrapper .page-inner section.normal pre .ruby .hljs-function .hljs-title,
+.book .book-body .page-wrapper .page-inner section.normal code .ruby .hljs-function .hljs-title,
+.book .book-body .page-wrapper .page-inner section.normal pre .ruby .hljs-title .hljs-keyword,
+.book .book-body .page-wrapper .page-inner section.normal code .ruby .hljs-title .hljs-keyword,
+.book .book-body .page-wrapper .page-inner section.normal pre .perl .hljs-sub,
+.book .book-body .page-wrapper .page-inner section.normal code .perl .hljs-sub,
+.book .book-body .page-wrapper .page-inner section.normal pre .javascript .hljs-title,
+.book .book-body .page-wrapper .page-inner section.normal code .javascript .hljs-title,
+.book .book-body .page-wrapper .page-inner section.normal pre .coffeescript .hljs-title,
+.book .book-body .page-wrapper .page-inner section.normal code .coffeescript .hljs-title {
+  color: #4271ae;
+}
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs-keyword,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs-keyword,
+.book .book-body .page-wrapper .page-inner section.normal pre .javascript .hljs-function,
+.book .book-body .page-wrapper .page-inner section.normal code .javascript .hljs-function {
+  color: #8959a8;
+}
+.book .book-body .page-wrapper .page-inner section.normal pre .hljs,
+.book .book-body .page-wrapper .page-inner section.normal code .hljs {
+  display: block;
+  background: white;
+  color: #4d4d4c;
+  padding: 0.5em;
+}
+.book .book-body .page-wrapper .page-inner section.normal pre .coffeescript .javascript,
+.book .book-body .page-wrapper .page-inner section.normal code .coffeescript .javascript,
+.book .book-body .page-wrapper .page-inner section.normal pre .javascript .xml,
+.book .book-body .page-wrapper .page-inner section.normal code .javascript .xml,
+.book .book-body .page-wrapper .page-inner section.normal pre .tex .hljs-formula,
+.book .book-body .page-wrapper .page-inner section.normal code .tex .hljs-formula,
+.book .book-body .page-wrapper .page-inner section.normal pre .xml .javascript,
+.book .book-body .page-wrapper .page-inner section.normal code .xml .javascript,
+.book .book-body .page-wrapper .page-inner section.normal pre .xml .vbscript,
+.book .book-body .page-wrapper .page-inner section.normal code .xml .vbscript,
+.book .book-body .page-wrapper .page-inner section.normal pre .xml .css,
+.book .book-body .page-wrapper .page-inner section.normal code .xml .css,
+.book .book-body .page-wrapper .page-inner section.normal pre .xml .hljs-cdata,
+.book .book-body .page-wrapper .page-inner section.normal code .xml .hljs-cdata {
+  opacity: 0.5;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code {
+  /*
+
+Orginal Style from ethanschoonover.com/solarized (c) Jeremy Hull <sourdrums@gmail.com>
+
+*/
+  /* Solarized Green */
+  /* Solarized Cyan */
+  /* Solarized Blue */
+  /* Solarized Yellow */
+  /* Solarized Orange */
+  /* Solarized Red */
+  /* Solarized Violet */
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs {
+  display: block;
+  padding: 0.5em;
+  background: #fdf6e3;
+  color: #657b83;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-comment,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-comment,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-template_comment,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-template_comment,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .diff .hljs-header,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .diff .hljs-header,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-doctype,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-doctype,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-pi,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-pi,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .lisp .hljs-string,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .lisp .hljs-string,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-javadoc,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-javadoc {
+  color: #93a1a1;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-keyword,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-keyword,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-winutils,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-winutils,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .method,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .method,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-addition,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-addition,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .css .hljs-tag,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .css .hljs-tag,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-request,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-request,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-status,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-status,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .nginx .hljs-title,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .nginx .hljs-title {
+  color: #859900;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-number,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-number,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-command,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-command,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-string,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-string,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-tag .hljs-value,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-tag .hljs-value,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-rules .hljs-value,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-rules .hljs-value,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-phpdoc,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-phpdoc,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .tex .hljs-formula,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .tex .hljs-formula,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-regexp,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-regexp,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-hexcolor,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-hexcolor,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-link_url,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-link_url {
+  color: #2aa198;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-title,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-title,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-localvars,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-localvars,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-chunk,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-chunk,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-decorator,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-decorator,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-built_in,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-built_in,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-identifier,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-identifier,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .vhdl .hljs-literal,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .vhdl .hljs-literal,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-id,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-id,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .css .hljs-function,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .css .hljs-function {
+  color: #268bd2;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-attribute,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-attribute,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-variable,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-variable,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .lisp .hljs-body,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .lisp .hljs-body,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .smalltalk .hljs-number,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .smalltalk .hljs-number,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-constant,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-constant,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-class .hljs-title,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-class .hljs-title,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-parent,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-parent,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .haskell .hljs-type,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .haskell .hljs-type,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-link_reference,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-link_reference {
+  color: #b58900;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-preprocessor,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-preprocessor,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-preprocessor .hljs-keyword,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-preprocessor .hljs-keyword,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-pragma,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-pragma,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-shebang,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-shebang,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-symbol,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-symbol,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-symbol .hljs-string,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-symbol .hljs-string,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .diff .hljs-change,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .diff .hljs-change,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-special,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-special,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-attr_selector,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-attr_selector,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-subst,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-subst,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-cdata,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-cdata,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .clojure .hljs-title,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .clojure .hljs-title,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .css .hljs-pseudo,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .css .hljs-pseudo,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-header,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-header {
+  color: #cb4b16;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-deletion,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-deletion,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-important,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-important {
+  color: #dc322f;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .hljs-link_label,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .hljs-link_label {
+  color: #6c71c4;
+}
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal pre .tex .hljs-formula,
+.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code .tex .hljs-formula {
+  background: #eee8d5;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code {
+  /* Tomorrow Night Bright Theme */
+  /* Original theme - https://github.com/chriskempson/tomorrow-theme */
+  /* http://jmblog.github.com/color-themes-for-google-code-highlightjs */
+  /* Tomorrow Comment */
+  /* Tomorrow Red */
+  /* Tomorrow Orange */
+  /* Tomorrow Yellow */
+  /* Tomorrow Green */
+  /* Tomorrow Aqua */
+  /* Tomorrow Blue */
+  /* Tomorrow Purple */
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs-comment,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs-comment,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs-title,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs-title {
+  color: #969896;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs-variable,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs-variable,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs-attribute,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs-attribute,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs-tag,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs-tag,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs-regexp,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs-regexp,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs-deletion,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs-deletion,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .ruby .hljs-constant,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .ruby .hljs-constant,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .xml .hljs-tag .hljs-title,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .xml .hljs-tag .hljs-title,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .xml .hljs-pi,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .xml .hljs-pi,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .xml .hljs-doctype,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .xml .hljs-doctype,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .html .hljs-doctype,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .html .hljs-doctype,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .css .hljs-id,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .css .hljs-id,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .css .hljs-class,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .css .hljs-class,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .css .hljs-pseudo,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .css .hljs-pseudo {
+  color: #d54e53;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs-number,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs-number,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs-preprocessor,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs-preprocessor,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs-pragma,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs-pragma,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs-built_in,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs-built_in,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs-literal,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs-literal,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs-params,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs-params,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs-constant,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs-constant {
+  color: #e78c45;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .ruby .hljs-class .hljs-title,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .ruby .hljs-class .hljs-title,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .css .hljs-rules .hljs-attribute,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .css .hljs-rules .hljs-attribute {
+  color: #e7c547;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs-string,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs-string,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs-value,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs-value,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs-inheritance,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs-inheritance,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs-header,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs-header,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs-addition,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs-addition,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .ruby .hljs-symbol,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .ruby .hljs-symbol,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .xml .hljs-cdata,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .xml .hljs-cdata {
+  color: #b9ca4a;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .css .hljs-hexcolor,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .css .hljs-hexcolor {
+  color: #70c0b1;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs-function,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs-function,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .python .hljs-decorator,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .python .hljs-decorator,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .python .hljs-title,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .python .hljs-title,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .ruby .hljs-function .hljs-title,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .ruby .hljs-function .hljs-title,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .ruby .hljs-title .hljs-keyword,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .ruby .hljs-title .hljs-keyword,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .perl .hljs-sub,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .perl .hljs-sub,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .javascript .hljs-title,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .javascript .hljs-title,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .coffeescript .hljs-title,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .coffeescript .hljs-title {
+  color: #7aa6da;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs-keyword,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs-keyword,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .javascript .hljs-function,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .javascript .hljs-function {
+  color: #c397d8;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .hljs,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .hljs {
+  display: block;
+  background: black;
+  color: #eaeaea;
+  padding: 0.5em;
+}
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .coffeescript .javascript,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .coffeescript .javascript,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .javascript .xml,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .javascript .xml,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .tex .hljs-formula,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .tex .hljs-formula,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .xml .javascript,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .xml .javascript,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .xml .vbscript,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .xml .vbscript,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .xml .css,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .xml .css,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal pre .xml .hljs-cdata,
+.book.color-theme-2 .book-body .page-wrapper .page-inner section.normal code .xml .hljs-cdata {
+  opacity: 0.5;
+}
diff --git a/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-hints/plugin-hints.css b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-hints/plugin-hints.css
new file mode 100644
index 00000000..ed4480c5
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-hints/plugin-hints.css
@@ -0,0 +1,9 @@
+.hints-icon {
+    display: table-cell;
+    padding-right: 15px;
+    padding-left: 5px;
+}
+
+.hints-container {
+    display: table-cell;
+}
diff --git a/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-lunr/lunr.min.js b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-lunr/lunr.min.js
new file mode 100644
index 00000000..6aa6bc7d
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-lunr/lunr.min.js
@@ -0,0 +1,7 @@
+/**
+ * lunr - http://lunrjs.com - A bit like Solr, but much smaller and not as bright - 0.5.12
+ * Copyright (C) 2015 Oliver Nightingale
+ * MIT Licensed
+ * @license
+ */
+!function(){var t=function(e){var n=new t.Index;return n.pipeline.add(t.trimmer,t.stopWordFilter,t.stemmer),e&&e.call(n,n),n};t.version="0.5.12",t.utils={},t.utils.warn=function(t){return function(e){t.console&&console.warn&&console.warn(e)}}(this),t.EventEmitter=function(){this.events={}},t.EventEmitter.prototype.addListener=function(){var t=Array.prototype.slice.call(arguments),e=t.pop(),n=t;if("function"!=typeof e)throw new TypeError("last argument must be a function");n.forEach(function(t){this.hasHandler(t)||(this.events[t]=[]),this.events[t].push(e)},this)},t.EventEmitter.prototype.removeListener=function(t,e){if(this.hasHandler(t)){var n=this.events[t].indexOf(e);this.events[t].splice(n,1),this.events[t].length||delete this.events[t]}},t.EventEmitter.prototype.emit=function(t){if(this.hasHandler(t)){var e=Array.prototype.slice.call(arguments,1);this.events[t].forEach(function(t){t.apply(void 0,e)})}},t.EventEmitter.prototype.hasHandler=function(t){return t in this.events},t.tokenizer=function(t){return arguments.length&&null!=t&&void 0!=t?Array.isArray(t)?t.map(function(t){return t.toLowerCase()}):t.toString().trim().toLowerCase().split(/[\s\-]+/):[]},t.Pipeline=function(){this._stack=[]},t.Pipeline.registeredFunctions={},t.Pipeline.registerFunction=function(e,n){n in this.registeredFunctions&&t.utils.warn("Overwriting existing registered function: "+n),e.label=n,t.Pipeline.registeredFunctions[e.label]=e},t.Pipeline.warnIfFunctionNotRegistered=function(e){var n=e.label&&e.label in this.registeredFunctions;n||t.utils.warn("Function is not registered with pipeline. This may cause problems when serialising the index.\n",e)},t.Pipeline.load=function(e){var n=new t.Pipeline;return e.forEach(function(e){var i=t.Pipeline.registeredFunctions[e];if(!i)throw new Error("Cannot load un-registered function: "+e);n.add(i)}),n},t.Pipeline.prototype.add=function(){var e=Array.prototype.slice.call(arguments);e.forEach(function(e){t.Pipeline.warnIfFunctionNotRegistered(e),this._stack.push(e)},this)},t.Pipeline.prototype.after=function(e,n){t.Pipeline.warnIfFunctionNotRegistered(n);var i=this._stack.indexOf(e);if(-1==i)throw new Error("Cannot find existingFn");i+=1,this._stack.splice(i,0,n)},t.Pipeline.prototype.before=function(e,n){t.Pipeline.warnIfFunctionNotRegistered(n);var i=this._stack.indexOf(e);if(-1==i)throw new Error("Cannot find existingFn");this._stack.splice(i,0,n)},t.Pipeline.prototype.remove=function(t){var e=this._stack.indexOf(t);-1!=e&&this._stack.splice(e,1)},t.Pipeline.prototype.run=function(t){for(var e=[],n=t.length,i=this._stack.length,o=0;n>o;o++){for(var r=t[o],s=0;i>s&&(r=this._stack[s](r,o,t),void 0!==r);s++);void 0!==r&&e.push(r)}return e},t.Pipeline.prototype.reset=function(){this._stack=[]},t.Pipeline.prototype.toJSON=function(){return this._stack.map(function(e){return t.Pipeline.warnIfFunctionNotRegistered(e),e.label})},t.Vector=function(){this._magnitude=null,this.list=void 0,this.length=0},t.Vector.Node=function(t,e,n){this.idx=t,this.val=e,this.next=n},t.Vector.prototype.insert=function(e,n){this._magnitude=void 0;var i=this.list;if(!i)return this.list=new t.Vector.Node(e,n,i),this.length++;if(e<i.idx)return this.list=new t.Vector.Node(e,n,i),this.length++;for(var o=i,r=i.next;void 0!=r;){if(e<r.idx)return o.next=new t.Vector.Node(e,n,r),this.length++;o=r,r=r.next}return o.next=new t.Vector.Node(e,n,r),this.length++},t.Vector.prototype.magnitude=function(){if(this._magnitude)return this._magnitude;for(var t,e=this.list,n=0;e;)t=e.val,n+=t*t,e=e.next;return this._magnitude=Math.sqrt(n)},t.Vector.prototype.dot=function(t){for(var e=this.list,n=t.list,i=0;e&&n;)e.idx<n.idx?e=e.next:e.idx>n.idx?n=n.next:(i+=e.val*n.val,e=e.next,n=n.next);return i},t.Vector.prototype.similarity=function(t){return this.dot(t)/(this.magnitude()*t.magnitude())},t.SortedSet=function(){this.length=0,this.elements=[]},t.SortedSet.load=function(t){var e=new this;return e.elements=t,e.length=t.length,e},t.SortedSet.prototype.add=function(){var t,e;for(t=0;t<arguments.length;t++)e=arguments[t],~this.indexOf(e)||this.elements.splice(this.locationFor(e),0,e);this.length=this.elements.length},t.SortedSet.prototype.toArray=function(){return this.elements.slice()},t.SortedSet.prototype.map=function(t,e){return this.elements.map(t,e)},t.SortedSet.prototype.forEach=function(t,e){return this.elements.forEach(t,e)},t.SortedSet.prototype.indexOf=function(t){for(var e=0,n=this.elements.length,i=n-e,o=e+Math.floor(i/2),r=this.elements[o];i>1;){if(r===t)return o;t>r&&(e=o),r>t&&(n=o),i=n-e,o=e+Math.floor(i/2),r=this.elements[o]}return r===t?o:-1},t.SortedSet.prototype.locationFor=function(t){for(var e=0,n=this.elements.length,i=n-e,o=e+Math.floor(i/2),r=this.elements[o];i>1;)t>r&&(e=o),r>t&&(n=o),i=n-e,o=e+Math.floor(i/2),r=this.elements[o];return r>t?o:t>r?o+1:void 0},t.SortedSet.prototype.intersect=function(e){for(var n=new t.SortedSet,i=0,o=0,r=this.length,s=e.length,a=this.elements,h=e.elements;;){if(i>r-1||o>s-1)break;a[i]!==h[o]?a[i]<h[o]?i++:a[i]>h[o]&&o++:(n.add(a[i]),i++,o++)}return n},t.SortedSet.prototype.clone=function(){var e=new t.SortedSet;return e.elements=this.toArray(),e.length=e.elements.length,e},t.SortedSet.prototype.union=function(t){var e,n,i;return this.length>=t.length?(e=this,n=t):(e=t,n=this),i=e.clone(),i.add.apply(i,n.toArray()),i},t.SortedSet.prototype.toJSON=function(){return this.toArray()},t.Index=function(){this._fields=[],this._ref="id",this.pipeline=new t.Pipeline,this.documentStore=new t.Store,this.tokenStore=new t.TokenStore,this.corpusTokens=new t.SortedSet,this.eventEmitter=new t.EventEmitter,this._idfCache={},this.on("add","remove","update",function(){this._idfCache={}}.bind(this))},t.Index.prototype.on=function(){var t=Array.prototype.slice.call(arguments);return this.eventEmitter.addListener.apply(this.eventEmitter,t)},t.Index.prototype.off=function(t,e){return this.eventEmitter.removeListener(t,e)},t.Index.load=function(e){e.version!==t.version&&t.utils.warn("version mismatch: current "+t.version+" importing "+e.version);var n=new this;return n._fields=e.fields,n._ref=e.ref,n.documentStore=t.Store.load(e.documentStore),n.tokenStore=t.TokenStore.load(e.tokenStore),n.corpusTokens=t.SortedSet.load(e.corpusTokens),n.pipeline=t.Pipeline.load(e.pipeline),n},t.Index.prototype.field=function(t,e){var e=e||{},n={name:t,boost:e.boost||1};return this._fields.push(n),this},t.Index.prototype.ref=function(t){return this._ref=t,this},t.Index.prototype.add=function(e,n){var i={},o=new t.SortedSet,r=e[this._ref],n=void 0===n?!0:n;this._fields.forEach(function(n){var r=this.pipeline.run(t.tokenizer(e[n.name]));i[n.name]=r,t.SortedSet.prototype.add.apply(o,r)},this),this.documentStore.set(r,o),t.SortedSet.prototype.add.apply(this.corpusTokens,o.toArray());for(var s=0;s<o.length;s++){var a=o.elements[s],h=this._fields.reduce(function(t,e){var n=i[e.name].length;if(!n)return t;var o=i[e.name].filter(function(t){return t===a}).length;return t+o/n*e.boost},0);this.tokenStore.add(a,{ref:r,tf:h})}n&&this.eventEmitter.emit("add",e,this)},t.Index.prototype.remove=function(t,e){var n=t[this._ref],e=void 0===e?!0:e;if(this.documentStore.has(n)){var i=this.documentStore.get(n);this.documentStore.remove(n),i.forEach(function(t){this.tokenStore.remove(t,n)},this),e&&this.eventEmitter.emit("remove",t,this)}},t.Index.prototype.update=function(t,e){var e=void 0===e?!0:e;this.remove(t,!1),this.add(t,!1),e&&this.eventEmitter.emit("update",t,this)},t.Index.prototype.idf=function(t){var e="@"+t;if(Object.prototype.hasOwnProperty.call(this._idfCache,e))return this._idfCache[e];var n=this.tokenStore.count(t),i=1;return n>0&&(i=1+Math.log(this.documentStore.length/n)),this._idfCache[e]=i},t.Index.prototype.search=function(e){var n=this.pipeline.run(t.tokenizer(e)),i=new t.Vector,o=[],r=this._fields.reduce(function(t,e){return t+e.boost},0),s=n.some(function(t){return this.tokenStore.has(t)},this);if(!s)return[];n.forEach(function(e,n,s){var a=1/s.length*this._fields.length*r,h=this,l=this.tokenStore.expand(e).reduce(function(n,o){var r=h.corpusTokens.indexOf(o),s=h.idf(o),l=1,u=new t.SortedSet;if(o!==e){var c=Math.max(3,o.length-e.length);l=1/Math.log(c)}return r>-1&&i.insert(r,a*s*l),Object.keys(h.tokenStore.get(o)).forEach(function(t){u.add(t)}),n.union(u)},new t.SortedSet);o.push(l)},this);var a=o.reduce(function(t,e){return t.intersect(e)});return a.map(function(t){return{ref:t,score:i.similarity(this.documentVector(t))}},this).sort(function(t,e){return e.score-t.score})},t.Index.prototype.documentVector=function(e){for(var n=this.documentStore.get(e),i=n.length,o=new t.Vector,r=0;i>r;r++){var s=n.elements[r],a=this.tokenStore.get(s)[e].tf,h=this.idf(s);o.insert(this.corpusTokens.indexOf(s),a*h)}return o},t.Index.prototype.toJSON=function(){return{version:t.version,fields:this._fields,ref:this._ref,documentStore:this.documentStore.toJSON(),tokenStore:this.tokenStore.toJSON(),corpusTokens:this.corpusTokens.toJSON(),pipeline:this.pipeline.toJSON()}},t.Index.prototype.use=function(t){var e=Array.prototype.slice.call(arguments,1);e.unshift(this),t.apply(this,e)},t.Store=function(){this.store={},this.length=0},t.Store.load=function(e){var n=new this;return n.length=e.length,n.store=Object.keys(e.store).reduce(function(n,i){return n[i]=t.SortedSet.load(e.store[i]),n},{}),n},t.Store.prototype.set=function(t,e){this.has(t)||this.length++,this.store[t]=e},t.Store.prototype.get=function(t){return this.store[t]},t.Store.prototype.has=function(t){return t in this.store},t.Store.prototype.remove=function(t){this.has(t)&&(delete this.store[t],this.length--)},t.Store.prototype.toJSON=function(){return{store:this.store,length:this.length}},t.stemmer=function(){var t={ational:"ate",tional:"tion",enci:"ence",anci:"ance",izer:"ize",bli:"ble",alli:"al",entli:"ent",eli:"e",ousli:"ous",ization:"ize",ation:"ate",ator:"ate",alism:"al",iveness:"ive",fulness:"ful",ousness:"ous",aliti:"al",iviti:"ive",biliti:"ble",logi:"log"},e={icate:"ic",ative:"",alize:"al",iciti:"ic",ical:"ic",ful:"",ness:""},n="[^aeiou]",i="[aeiouy]",o=n+"[^aeiouy]*",r=i+"[aeiou]*",s="^("+o+")?"+r+o,a="^("+o+")?"+r+o+"("+r+")?$",h="^("+o+")?"+r+o+r+o,l="^("+o+")?"+i,u=new RegExp(s),c=new RegExp(h),f=new RegExp(a),d=new RegExp(l),p=/^(.+?)(ss|i)es$/,m=/^(.+?)([^s])s$/,v=/^(.+?)eed$/,y=/^(.+?)(ed|ing)$/,g=/.$/,S=/(at|bl|iz)$/,w=new RegExp("([^aeiouylsz])\\1$"),x=new RegExp("^"+o+i+"[^aeiouwxy]$"),k=/^(.+?[^aeiou])y$/,b=/^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/,E=/^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/,_=/^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/,F=/^(.+?)(s|t)(ion)$/,O=/^(.+?)e$/,P=/ll$/,N=new RegExp("^"+o+i+"[^aeiouwxy]$"),T=function(n){var i,o,r,s,a,h,l;if(n.length<3)return n;if(r=n.substr(0,1),"y"==r&&(n=r.toUpperCase()+n.substr(1)),s=p,a=m,s.test(n)?n=n.replace(s,"$1$2"):a.test(n)&&(n=n.replace(a,"$1$2")),s=v,a=y,s.test(n)){var T=s.exec(n);s=u,s.test(T[1])&&(s=g,n=n.replace(s,""))}else if(a.test(n)){var T=a.exec(n);i=T[1],a=d,a.test(i)&&(n=i,a=S,h=w,l=x,a.test(n)?n+="e":h.test(n)?(s=g,n=n.replace(s,"")):l.test(n)&&(n+="e"))}if(s=k,s.test(n)){var T=s.exec(n);i=T[1],n=i+"i"}if(s=b,s.test(n)){var T=s.exec(n);i=T[1],o=T[2],s=u,s.test(i)&&(n=i+t[o])}if(s=E,s.test(n)){var T=s.exec(n);i=T[1],o=T[2],s=u,s.test(i)&&(n=i+e[o])}if(s=_,a=F,s.test(n)){var T=s.exec(n);i=T[1],s=c,s.test(i)&&(n=i)}else if(a.test(n)){var T=a.exec(n);i=T[1]+T[2],a=c,a.test(i)&&(n=i)}if(s=O,s.test(n)){var T=s.exec(n);i=T[1],s=c,a=f,h=N,(s.test(i)||a.test(i)&&!h.test(i))&&(n=i)}return s=P,a=c,s.test(n)&&a.test(n)&&(s=g,n=n.replace(s,"")),"y"==r&&(n=r.toLowerCase()+n.substr(1)),n};return T}(),t.Pipeline.registerFunction(t.stemmer,"stemmer"),t.stopWordFilter=function(e){return e&&t.stopWordFilter.stopWords[e]!==e?e:void 0},t.stopWordFilter.stopWords={a:"a",able:"able",about:"about",across:"across",after:"after",all:"all",almost:"almost",also:"also",am:"am",among:"among",an:"an",and:"and",any:"any",are:"are",as:"as",at:"at",be:"be",because:"because",been:"been",but:"but",by:"by",can:"can",cannot:"cannot",could:"could",dear:"dear",did:"did","do":"do",does:"does",either:"either","else":"else",ever:"ever",every:"every","for":"for",from:"from",get:"get",got:"got",had:"had",has:"has",have:"have",he:"he",her:"her",hers:"hers",him:"him",his:"his",how:"how",however:"however",i:"i","if":"if","in":"in",into:"into",is:"is",it:"it",its:"its",just:"just",least:"least",let:"let",like:"like",likely:"likely",may:"may",me:"me",might:"might",most:"most",must:"must",my:"my",neither:"neither",no:"no",nor:"nor",not:"not",of:"of",off:"off",often:"often",on:"on",only:"only",or:"or",other:"other",our:"our",own:"own",rather:"rather",said:"said",say:"say",says:"says",she:"she",should:"should",since:"since",so:"so",some:"some",than:"than",that:"that",the:"the",their:"their",them:"them",then:"then",there:"there",these:"these",they:"they","this":"this",tis:"tis",to:"to",too:"too",twas:"twas",us:"us",wants:"wants",was:"was",we:"we",were:"were",what:"what",when:"when",where:"where",which:"which","while":"while",who:"who",whom:"whom",why:"why",will:"will","with":"with",would:"would",yet:"yet",you:"you",your:"your"},t.Pipeline.registerFunction(t.stopWordFilter,"stopWordFilter"),t.trimmer=function(t){var e=t.replace(/^\W+/,"").replace(/\W+$/,"");return""===e?void 0:e},t.Pipeline.registerFunction(t.trimmer,"trimmer"),t.TokenStore=function(){this.root={docs:{}},this.length=0},t.TokenStore.load=function(t){var e=new this;return e.root=t.root,e.length=t.length,e},t.TokenStore.prototype.add=function(t,e,n){var n=n||this.root,i=t[0],o=t.slice(1);return i in n||(n[i]={docs:{}}),0===o.length?(n[i].docs[e.ref]=e,void(this.length+=1)):this.add(o,e,n[i])},t.TokenStore.prototype.has=function(t){if(!t)return!1;for(var e=this.root,n=0;n<t.length;n++){if(!e[t[n]])return!1;e=e[t[n]]}return!0},t.TokenStore.prototype.getNode=function(t){if(!t)return{};for(var e=this.root,n=0;n<t.length;n++){if(!e[t[n]])return{};e=e[t[n]]}return e},t.TokenStore.prototype.get=function(t,e){return this.getNode(t,e).docs||{}},t.TokenStore.prototype.count=function(t,e){return Object.keys(this.get(t,e)).length},t.TokenStore.prototype.remove=function(t,e){if(t){for(var n=this.root,i=0;i<t.length;i++){if(!(t[i]in n))return;n=n[t[i]]}delete n.docs[e]}},t.TokenStore.prototype.expand=function(t,e){var n=this.getNode(t),i=n.docs||{},e=e||[];return Object.keys(i).length&&e.push(t),Object.keys(n).forEach(function(n){"docs"!==n&&e.concat(this.expand(t+n,e))},this),e},t.TokenStore.prototype.toJSON=function(){return{root:this.root,length:this.length}},function(t,e){"function"==typeof define&&define.amd?define(e):"object"==typeof exports?module.exports=e():t.lunr=e()}(this,function(){return t})}();
\ No newline at end of file
diff --git a/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-lunr/search-lunr.js b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-lunr/search-lunr.js
new file mode 100644
index 00000000..d6ec76fb
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-lunr/search-lunr.js
@@ -0,0 +1,59 @@
+require([
+    'gitbook',
+    'jquery'
+], function(gitbook, $) {
+    // Define global search engine
+    function LunrSearchEngine() {
+        this.index = null;
+        this.store = {};
+        this.name = 'LunrSearchEngine';
+    }
+
+    // Initialize lunr by fetching the search index
+    LunrSearchEngine.prototype.init = function() {
+        var that = this;
+        var d = $.Deferred();
+
+        $.getJSON(gitbook.state.basePath+'/search_index.json')
+        .then(function(data) {
+            // eslint-disable-next-line no-undef
+            that.index = lunr.Index.load(data.index);
+            that.store = data.store;
+            d.resolve();
+        });
+
+        return d.promise();
+    };
+
+    // Search for a term and return results
+    LunrSearchEngine.prototype.search = function(q, offset, length) {
+        var that = this;
+        var results = [];
+
+        if (this.index) {
+            results = $.map(this.index.search(q), function(result) {
+                var doc = that.store[result.ref];
+
+                return {
+                    title: doc.title,
+                    url: doc.url,
+                    body: doc.summary || doc.body
+                };
+            });
+        }
+
+        return $.Deferred().resolve({
+            query: q,
+            results: results.slice(0, length),
+            count: results.length
+        }).promise();
+    };
+
+    // Set gitbook research
+    gitbook.events.bind('start', function(e, config) {
+        var engine = gitbook.search.getEngine();
+        if (!engine) {
+            gitbook.search.setEngine(LunrSearchEngine, config);
+        }
+    });
+});
diff --git a/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-search/search-engine.js b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-search/search-engine.js
new file mode 100644
index 00000000..50883464
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-search/search-engine.js
@@ -0,0 +1,50 @@
+require([
+    'gitbook',
+    'jquery'
+], function(gitbook, $) {
+    // Global search objects
+    var engine      = null;
+    var initialized = false;
+
+    // Set a new search engine
+    function setEngine(Engine, config) {
+        initialized = false;
+        engine      = new Engine(config);
+
+        init(config);
+    }
+
+    // Initialize search engine with config
+    function init(config) {
+        if (!engine) throw new Error('No engine set for research. Set an engine using gitbook.research.setEngine(Engine).');
+
+        return engine.init(config)
+        .then(function() {
+            initialized = true;
+            gitbook.events.trigger('search.ready');
+        });
+    }
+
+    // Launch search for query q
+    function query(q, offset, length) {
+        if (!initialized) throw new Error('Search has not been initialized');
+        return engine.search(q, offset, length);
+    }
+
+    // Get stats about search
+    function getEngine() {
+        return engine? engine.name : null;
+    }
+
+    function isInitialized() {
+        return initialized;
+    }
+
+    // Initialize gitbook.search
+    gitbook.search = {
+        setEngine:     setEngine,
+        getEngine:     getEngine,
+        query:         query,
+        isInitialized: isInitialized
+    };
+});
\ No newline at end of file
diff --git a/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-search/search.css b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-search/search.css
new file mode 100644
index 00000000..5d47a3ce
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-search/search.css
@@ -0,0 +1,35 @@
+/*
+    This CSS only styled the search results section, not the search input
+    It defines the basic interraction to hide content when displaying results, etc
+*/
+#book-search-results .search-results {
+  display: none;
+}
+#book-search-results .search-results ul.search-results-list {
+  list-style-type: none;
+  padding-left: 0;
+}
+#book-search-results .search-results ul.search-results-list li {
+  margin-bottom: 1.5rem;
+  padding-bottom: 0.5rem;
+  /* Highlight results */
+}
+#book-search-results .search-results ul.search-results-list li p em {
+  background-color: rgba(255, 220, 0, 0.4);
+  font-style: normal;
+}
+#book-search-results .search-results .no-results {
+  display: none;
+}
+#book-search-results.open .search-results {
+  display: block;
+}
+#book-search-results.open .search-noresults {
+  display: none;
+}
+#book-search-results.no-results .search-results .has-results {
+  display: none;
+}
+#book-search-results.no-results .search-results .no-results {
+  display: block;
+}
diff --git a/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-search/search.js b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-search/search.js
new file mode 100644
index 00000000..7a0c2321
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-search/search.js
@@ -0,0 +1,213 @@
+require([
+    'gitbook',
+    'jquery'
+], function(gitbook, $) {
+    var MAX_RESULTS = 15;
+    var MAX_DESCRIPTION_SIZE = 500;
+
+    var usePushState = (typeof history.pushState !== 'undefined');
+
+    // DOM Elements
+    var $body = $('body');
+    var $bookSearchResults;
+    var $searchInput;
+    var $searchList;
+    var $searchTitle;
+    var $searchResultsCount;
+    var $searchQuery;
+
+    // Throttle search
+    function throttle(fn, wait) {
+        var timeout;
+
+        return function() {
+            var ctx = this, args = arguments;
+            if (!timeout) {
+                timeout = setTimeout(function() {
+                    timeout = null;
+                    fn.apply(ctx, args);
+                }, wait);
+            }
+        };
+    }
+
+    function displayResults(res) {
+        $bookSearchResults.addClass('open');
+
+        var noResults = res.count == 0;
+        $bookSearchResults.toggleClass('no-results', noResults);
+
+        // Clear old results
+        $searchList.empty();
+
+        // Display title for research
+        $searchResultsCount.text(res.count);
+        $searchQuery.text(res.query);
+
+        // Create an <li> element for each result
+        res.results.forEach(function(res) {
+            var $li = $('<li>', {
+                'class': 'search-results-item'
+            });
+
+            var $title = $('<h3>');
+
+            var $link = $('<a>', {
+                'href': gitbook.state.basePath + '/' + res.url,
+                'text': res.title
+            });
+
+            var content = res.body.trim();
+            if (content.length > MAX_DESCRIPTION_SIZE) {
+                content = content.slice(0, MAX_DESCRIPTION_SIZE).trim()+'...';
+            }
+            var $content = $('<p>').html(content);
+
+            $link.appendTo($title);
+            $title.appendTo($li);
+            $content.appendTo($li);
+            $li.appendTo($searchList);
+        });
+    }
+
+    function launchSearch(q) {
+        // Add class for loading
+        $body.addClass('with-search');
+        $body.addClass('search-loading');
+
+        // Launch search query
+        throttle(gitbook.search.query(q, 0, MAX_RESULTS)
+        .then(function(results) {
+            displayResults(results);
+        })
+        .always(function() {
+            $body.removeClass('search-loading');
+        }), 1000);
+    }
+
+    function closeSearch() {
+        $body.removeClass('with-search');
+        $bookSearchResults.removeClass('open');
+    }
+
+    function launchSearchFromQueryString() {
+        var q = getParameterByName('q');
+        if (q && q.length > 0) {
+            // Update search input
+            $searchInput.val(q);
+
+            // Launch search
+            launchSearch(q);
+        }
+    }
+
+    function bindSearch() {
+        // Bind DOM
+        $searchInput        = $('#book-search-input input');
+        $bookSearchResults  = $('#book-search-results');
+        $searchList         = $bookSearchResults.find('.search-results-list');
+        $searchTitle        = $bookSearchResults.find('.search-results-title');
+        $searchResultsCount = $searchTitle.find('.search-results-count');
+        $searchQuery        = $searchTitle.find('.search-query');
+
+        // Launch query based on input content
+        function handleUpdate() {
+            var q = $searchInput.val();
+
+            if (q.length == 0) {
+                closeSearch();
+            }
+            else {
+                launchSearch(q);
+            }
+        }
+
+        // Detect true content change in search input
+        // Workaround for IE < 9
+        var propertyChangeUnbound = false;
+        $searchInput.on('propertychange', function(e) {
+            if (e.originalEvent.propertyName == 'value') {
+                handleUpdate();
+            }
+        });
+
+        // HTML5 (IE9 & others)
+        $searchInput.on('input', function(e) {
+            // Unbind propertychange event for IE9+
+            if (!propertyChangeUnbound) {
+                $(this).unbind('propertychange');
+                propertyChangeUnbound = true;
+            }
+
+            handleUpdate();
+        });
+
+        // Push to history on blur
+        $searchInput.on('blur', function(e) {
+            // Update history state
+            if (usePushState) {
+                var uri = updateQueryString('q', $(this).val());
+                history.pushState({ path: uri }, null, uri);
+            }
+        });
+    }
+
+    gitbook.events.on('page.change', function() {
+        bindSearch();
+        closeSearch();
+
+        // Launch search based on query parameter
+        if (gitbook.search.isInitialized()) {
+            launchSearchFromQueryString();
+        }
+    });
+
+    gitbook.events.on('search.ready', function() {
+        bindSearch();
+
+        // Launch search from query param at start
+        launchSearchFromQueryString();
+    });
+
+    function getParameterByName(name) {
+        var url = window.location.href;
+        name = name.replace(/[\[\]]/g, '\\$&');
+        var regex = new RegExp('[?&]' + name + '(=([^&#]*)|&|#|$)', 'i'),
+            results = regex.exec(url);
+        if (!results) return null;
+        if (!results[2]) return '';
+        return decodeURIComponent(results[2].replace(/\+/g, ' '));
+    }
+
+    function updateQueryString(key, value) {
+        value = encodeURIComponent(value);
+
+        var url = window.location.href;
+        var re = new RegExp('([?&])' + key + '=.*?(&|#|$)(.*)', 'gi'),
+            hash;
+
+        if (re.test(url)) {
+            if (typeof value !== 'undefined' && value !== null)
+                return url.replace(re, '$1' + key + '=' + value + '$2$3');
+            else {
+                hash = url.split('#');
+                url = hash[0].replace(re, '$1$3').replace(/(&|\?)$/, '');
+                if (typeof hash[1] !== 'undefined' && hash[1] !== null)
+                    url += '#' + hash[1];
+                return url;
+            }
+        }
+        else {
+            if (typeof value !== 'undefined' && value !== null) {
+                var separator = url.indexOf('?') !== -1 ? '&' : '?';
+                hash = url.split('#');
+                url = hash[0] + separator + key + '=' + value;
+                if (typeof hash[1] !== 'undefined' && hash[1] !== null)
+                    url += '#' + hash[1];
+                return url;
+            }
+            else
+                return url;
+        }
+    }
+});
diff --git a/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-sharing/buttons.js b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-sharing/buttons.js
new file mode 100644
index 00000000..709a4e4c
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/gitbook/gitbook-plugin-sharing/buttons.js
@@ -0,0 +1,90 @@
+require(['gitbook', 'jquery'], function(gitbook, $) {
+    var SITES = {
+        'facebook': {
+            'label': 'Facebook',
+            'icon': 'fa fa-facebook',
+            'onClick': function(e) {
+                e.preventDefault();
+                window.open('http://www.facebook.com/sharer/sharer.php?s=100&p[url]='+encodeURIComponent(location.href));
+            }
+        },
+        'twitter': {
+            'label': 'Twitter',
+            'icon': 'fa fa-twitter',
+            'onClick': function(e) {
+                e.preventDefault();
+                window.open('http://twitter.com/home?status='+encodeURIComponent(document.title+' '+location.href));
+            }
+        },
+        'google': {
+            'label': 'Google+',
+            'icon': 'fa fa-google-plus',
+            'onClick': function(e) {
+                e.preventDefault();
+                window.open('https://plus.google.com/share?url='+encodeURIComponent(location.href));
+            }
+        },
+        'weibo': {
+            'label': 'Weibo',
+            'icon': 'fa fa-weibo',
+            'onClick': function(e) {
+                e.preventDefault();
+                window.open('http://service.weibo.com/share/share.php?content=utf-8&url='+encodeURIComponent(location.href)+'&title='+encodeURIComponent(document.title));
+            }
+        },
+        'instapaper': {
+            'label': 'Instapaper',
+            'icon': 'fa fa-instapaper',
+            'onClick': function(e) {
+                e.preventDefault();
+                window.open('http://www.instapaper.com/text?u='+encodeURIComponent(location.href));
+            }
+        },
+        'vk': {
+            'label': 'VK',
+            'icon': 'fa fa-vk',
+            'onClick': function(e) {
+                e.preventDefault();
+                window.open('http://vkontakte.ru/share.php?url='+encodeURIComponent(location.href));
+            }
+        }
+    };
+
+
+
+    gitbook.events.bind('start', function(e, config) {
+        var opts = config.sharing;
+
+        // Create dropdown menu
+        var menu = $.map(opts.all, function(id) {
+            var site = SITES[id];
+
+            return {
+                text: site.label,
+                onClick: site.onClick
+            };
+        });
+
+        // Create main button with dropdown
+        if (menu.length > 0) {
+            gitbook.toolbar.createButton({
+                icon: 'fa fa-share-alt',
+                label: 'Share',
+                position: 'right',
+                dropdown: [menu]
+            });
+        }
+
+        // Direct actions to share
+        $.each(SITES, function(sideId, site) {
+            if (!opts[sideId]) return;
+
+            gitbook.toolbar.createButton({
+                icon: site.icon,
+                label: site.text,
+                position: 'right',
+                onClick: site.onClick
+            });
+        });
+    });
+});
diff --git a/clones/llthw.common-lisp.dev/gitbook/gitbook.js b/clones/llthw.common-lisp.dev/gitbook/gitbook.js
new file mode 100644
index 00000000..13077b45
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/gitbook/gitbook.js
@@ -0,0 +1,4 @@
+!function e(t,n,r){function o(s,a){if(!n[s]){if(!t[s]){var u="function"==typeof require&&require;if(!a&&u)return u(s,!0);if(i)return i(s,!0);var c=new Error("Cannot find module '"+s+"'");throw c.code="MODULE_NOT_FOUND",c}var l=n[s]={exports:{}};t[s][0].call(l.exports,function(e){var n=t[s][1][e];return o(n?n:e)},l,l.exports,e,t,n,r)}return n[s].exports}for(var i="function"==typeof require&&require,s=0;s<r.length;s++)o(r[s]);return o}({1:[function(e,t,n){!function(e,n){"use strict";"object"==typeof t&&"object"==typeof t.exports?t.exports=e.document?n(e,!0):function(e){if(!e.document)throw new Error("jQuery requires a window with a document");return n(e)}:n(e)}("undefined"!=typeof window?window:this,function(e,t){"use strict";function n(e,t){t=t||te;var n=t.createElement("script");n.text=e,t.head.appendChild(n).parentNode.removeChild(n)}function r(e){var t=!!e&&"length"in e&&e.length,n=de.type(e);return"function"!==n&&!de.isWindow(e)&&("array"===n||0===t||"number"==typeof t&&t>0&&t-1 in e)}function o(e,t,n){return de.isFunction(t)?de.grep(e,function(e,r){return!!t.call(e,r,e)!==n}):t.nodeType?de.grep(e,function(e){return e===t!==n}):"string"!=typeof t?de.grep(e,function(e){return se.call(t,e)>-1!==n}):je.test(t)?de.filter(t,e,n):(t=de.filter(t,e),de.grep(e,function(e){return se.call(t,e)>-1!==n&&1===e.nodeType}))}function i(e,t){for(;(e=e[t])&&1!==e.nodeType;);return e}function s(e){var t={};return de.each(e.match(qe)||[],function(e,n){t[n]=!0}),t}function a(e){return e}function u(e){throw e}function c(e,t,n){var r;try{e&&de.isFunction(r=e.promise)?r.call(e).done(t).fail(n):e&&de.isFunction(r=e.then)?r.call(e,t,n):t.call(void 0,e)}catch(e){n.call(void 0,e)}}function l(){te.removeEventListener("DOMContentLoaded",l),e.removeEventListener("load",l),de.ready()}function f(){this.expando=de.expando+f.uid++}function p(e){return"true"===e||"false"!==e&&("null"===e?null:e===+e+""?+e:Ie.test(e)?JSON.parse(e):e)}function h(e,t,n){var r;if(void 0===n&&1===e.nodeType)if(r="data-"+t.replace(Pe,"-$&").toLowerCase(),n=e.getAttribute(r),"string"==typeof n){try{n=p(n)}catch(e){}Re.set(e,t,n)}else n=void 0;return n}function d(e,t,n,r){var o,i=1,s=20,a=r?function(){return r.cur()}:function(){return de.css(e,t,"")},u=a(),c=n&&n[3]||(de.cssNumber[t]?"":"px"),l=(de.cssNumber[t]||"px"!==c&&+u)&&$e.exec(de.css(e,t));if(l&&l[3]!==c){c=c||l[3],n=n||[],l=+u||1;do i=i||".5",l/=i,de.style(e,t,l+c);while(i!==(i=a()/u)&&1!==i&&--s)}return n&&(l=+l||+u||0,o=n[1]?l+(n[1]+1)*n[2]:+n[2],r&&(r.unit=c,r.start=l,r.end=o)),o}function g(e){var t,n=e.ownerDocument,r=e.nodeName,o=Ue[r];return o?o:(t=n.body.appendChild(n.createElement(r)),o=de.css(t,"display"),t.parentNode.removeChild(t),"none"===o&&(o="block"),Ue[r]=o,o)}function m(e,t){for(var n,r,o=[],i=0,s=e.length;i<s;i++)r=e[i],r.style&&(n=r.style.display,t?("none"===n&&(o[i]=Fe.get(r,"display")||null,o[i]||(r.style.display="")),""===r.style.display&&Be(r)&&(o[i]=g(r))):"none"!==n&&(o[i]="none",Fe.set(r,"display",n)));for(i=0;i<s;i++)null!=o[i]&&(e[i].style.display=o[i]);return e}function v(e,t){var n;return n="undefined"!=typeof e.getElementsByTagName?e.getElementsByTagName(t||"*"):"undefined"!=typeof e.querySelectorAll?e.querySelectorAll(t||"*"):[],void 0===t||t&&de.nodeName(e,t)?de.merge([e],n):n}function y(e,t){for(var n=0,r=e.length;n<r;n++)Fe.set(e[n],"globalEval",!t||Fe.get(t[n],"globalEval"))}function x(e,t,n,r,o){for(var i,s,a,u,c,l,f=t.createDocumentFragment(),p=[],h=0,d=e.length;h<d;h++)if(i=e[h],i||0===i)if("object"===de.type(i))de.merge(p,i.nodeType?[i]:i);else if(Ye.test(i)){for(s=s||f.appendChild(t.createElement("div")),a=(Xe.exec(i)||["",""])[1].toLowerCase(),u=Ge[a]||Ge._default,s.innerHTML=u[1]+de.htmlPrefilter(i)+u[2],l=u[0];l--;)s=s.lastChild;de.merge(p,s.childNodes),s=f.firstChild,s.textContent=""}else p.push(t.createTextNode(i));for(f.textContent="",h=0;i=p[h++];)if(r&&de.inArray(i,r)>-1)o&&o.push(i);else if(c=de.contains(i.ownerDocument,i),s=v(f.appendChild(i),"script"),c&&y(s),n)for(l=0;i=s[l++];)Ve.test(i.type||"")&&n.push(i);return f}function b(){return!0}function w(){return!1}function T(){try{return te.activeElement}catch(e){}}function C(e,t,n,r,o,i){var s,a;if("object"==typeof t){"string"!=typeof n&&(r=r||n,n=void 0);for(a in t)C(e,a,n,r,t[a],i);return e}if(null==r&&null==o?(o=n,r=n=void 0):null==o&&("string"==typeof n?(o=r,r=void 0):(o=r,r=n,n=void 0)),o===!1)o=w;else if(!o)return e;return 1===i&&(s=o,o=function(e){return de().off(e),s.apply(this,arguments)},o.guid=s.guid||(s.guid=de.guid++)),e.each(function(){de.event.add(this,t,o,r,n)})}function j(e,t){return de.nodeName(e,"table")&&de.nodeName(11!==t.nodeType?t:t.firstChild,"tr")?e.getElementsByTagName("tbody")[0]||e:e}function k(e){return e.type=(null!==e.getAttribute("type"))+"/"+e.type,e}function E(e){var t=rt.exec(e.type);return t?e.type=t[1]:e.removeAttribute("type"),e}function S(e,t){var n,r,o,i,s,a,u,c;if(1===t.nodeType){if(Fe.hasData(e)&&(i=Fe.access(e),s=Fe.set(t,i),c=i.events)){delete s.handle,s.events={};for(o in c)for(n=0,r=c[o].length;n<r;n++)de.event.add(t,o,c[o][n])}Re.hasData(e)&&(a=Re.access(e),u=de.extend({},a),Re.set(t,u))}}function N(e,t){var n=t.nodeName.toLowerCase();"input"===n&&ze.test(e.type)?t.checked=e.checked:"input"!==n&&"textarea"!==n||(t.defaultValue=e.defaultValue)}function A(e,t,r,o){t=oe.apply([],t);var i,s,a,u,c,l,f=0,p=e.length,h=p-1,d=t[0],g=de.isFunction(d);if(g||p>1&&"string"==typeof d&&!pe.checkClone&&nt.test(d))return e.each(function(n){var i=e.eq(n);g&&(t[0]=d.call(this,n,i.html())),A(i,t,r,o)});if(p&&(i=x(t,e[0].ownerDocument,!1,e,o),s=i.firstChild,1===i.childNodes.length&&(i=s),s||o)){for(a=de.map(v(i,"script"),k),u=a.length;f<p;f++)c=i,f!==h&&(c=de.clone(c,!0,!0),u&&de.merge(a,v(c,"script"))),r.call(e[f],c,f);if(u)for(l=a[a.length-1].ownerDocument,de.map(a,E),f=0;f<u;f++)c=a[f],Ve.test(c.type||"")&&!Fe.access(c,"globalEval")&&de.contains(l,c)&&(c.src?de._evalUrl&&de._evalUrl(c.src):n(c.textContent.replace(ot,""),l))}return e}function q(e,t,n){for(var r,o=t?de.filter(t,e):e,i=0;null!=(r=o[i]);i++)n||1!==r.nodeType||de.cleanData(v(r)),r.parentNode&&(n&&de.contains(r.ownerDocument,r)&&y(v(r,"script")),r.parentNode.removeChild(r));return e}function D(e,t,n){var r,o,i,s,a=e.style;return n=n||at(e),n&&(s=n.getPropertyValue(t)||n[t],""!==s||de.contains(e.ownerDocument,e)||(s=de.style(e,t)),!pe.pixelMarginRight()&&st.test(s)&&it.test(t)&&(r=a.width,o=a.minWidth,i=a.maxWidth,a.minWidth=a.maxWidth=a.width=s,s=n.width,a.width=r,a.minWidth=o,a.maxWidth=i)),void 0!==s?s+"":s}function O(e,t){return{get:function(){return e()?void delete this.get:(this.get=t).apply(this,arguments)}}}function L(e){if(e in pt)return e;for(var t=e[0].toUpperCase()+e.slice(1),n=ft.length;n--;)if(e=ft[n]+t,e in pt)return e}function H(e,t,n){var r=$e.exec(t);return r?Math.max(0,r[2]-(n||0))+(r[3]||"px"):t}function F(e,t,n,r,o){var i,s=0;for(i=n===(r?"border":"content")?4:"width"===t?1:0;i<4;i+=2)"margin"===n&&(s+=de.css(e,n+We[i],!0,o)),r?("content"===n&&(s-=de.css(e,"padding"+We[i],!0,o)),"margin"!==n&&(s-=de.css(e,"border"+We[i]+"Width",!0,o))):(s+=de.css(e,"padding"+We[i],!0,o),"padding"!==n&&(s+=de.css(e,"border"+We[i]+"Width",!0,o)));return s}function R(e,t,n){var r,o=!0,i=at(e),s="border-box"===de.css(e,"boxSizing",!1,i);if(e.getClientRects().length&&(r=e.getBoundingClientRect()[t]),r<=0||null==r){if(r=D(e,t,i),(r<0||null==r)&&(r=e.style[t]),st.test(r))return r;o=s&&(pe.boxSizingReliable()||r===e.style[t]),r=parseFloat(r)||0}return r+F(e,t,n||(s?"border":"content"),o,i)+"px"}function I(e,t,n,r,o){return new I.prototype.init(e,t,n,r,o)}function P(){dt&&(e.requestAnimationFrame(P),de.fx.tick())}function M(){return e.setTimeout(function(){ht=void 0}),ht=de.now()}function $(e,t){var n,r=0,o={height:e};for(t=t?1:0;r<4;r+=2-t)n=We[r],o["margin"+n]=o["padding"+n]=e;return t&&(o.opacity=o.width=e),o}function W(e,t,n){for(var r,o=(U.tweeners[t]||[]).concat(U.tweeners["*"]),i=0,s=o.length;i<s;i++)if(r=o[i].call(n,t,e))return r}function B(e,t,n){var r,o,i,s,a,u,c,l,f="width"in t||"height"in t,p=this,h={},d=e.style,g=e.nodeType&&Be(e),v=Fe.get(e,"fxshow");n.queue||(s=de._queueHooks(e,"fx"),null==s.unqueued&&(s.unqueued=0,a=s.empty.fire,s.empty.fire=function(){s.unqueued||a()}),s.unqueued++,p.always(function(){p.always(function(){s.unqueued--,de.queue(e,"fx").length||s.empty.fire()})}));for(r in t)if(o=t[r],gt.test(o)){if(delete t[r],i=i||"toggle"===o,o===(g?"hide":"show")){if("show"!==o||!v||void 0===v[r])continue;g=!0}h[r]=v&&v[r]||de.style(e,r)}if(u=!de.isEmptyObject(t),u||!de.isEmptyObject(h)){f&&1===e.nodeType&&(n.overflow=[d.overflow,d.overflowX,d.overflowY],c=v&&v.display,null==c&&(c=Fe.get(e,"display")),l=de.css(e,"display"),"none"===l&&(c?l=c:(m([e],!0),c=e.style.display||c,l=de.css(e,"display"),m([e]))),("inline"===l||"inline-block"===l&&null!=c)&&"none"===de.css(e,"float")&&(u||(p.done(function(){d.display=c}),null==c&&(l=d.display,c="none"===l?"":l)),d.display="inline-block")),n.overflow&&(d.overflow="hidden",p.always(function(){d.overflow=n.overflow[0],d.overflowX=n.overflow[1],d.overflowY=n.overflow[2]})),u=!1;for(r in h)u||(v?"hidden"in v&&(g=v.hidden):v=Fe.access(e,"fxshow",{display:c}),i&&(v.hidden=!g),g&&m([e],!0),p.done(function(){g||m([e]),Fe.remove(e,"fxshow");for(r in h)de.style(e,r,h[r])})),u=W(g?v[r]:0,r,p),r in v||(v[r]=u.start,g&&(u.end=u.start,u.start=0))}}function _(e,t){var n,r,o,i,s;for(n in e)if(r=de.camelCase(n),o=t[r],i=e[n],de.isArray(i)&&(o=i[1],i=e[n]=i[0]),n!==r&&(e[r]=i,delete e[n]),s=de.cssHooks[r],s&&"expand"in s){i=s.expand(i),delete e[r];for(n in i)n in e||(e[n]=i[n],t[n]=o)}else t[r]=o}function U(e,t,n){var r,o,i=0,s=U.prefilters.length,a=de.Deferred().always(function(){delete u.elem}),u=function(){if(o)return!1;for(var t=ht||M(),n=Math.max(0,c.startTime+c.duration-t),r=n/c.duration||0,i=1-r,s=0,u=c.tweens.length;s<u;s++)c.tweens[s].run(i);return a.notifyWith(e,[c,i,n]),i<1&&u?n:(a.resolveWith(e,[c]),!1)},c=a.promise({elem:e,props:de.extend({},t),opts:de.extend(!0,{specialEasing:{},easing:de.easing._default},n),originalProperties:t,originalOptions:n,startTime:ht||M(),duration:n.duration,tweens:[],createTween:function(t,n){var r=de.Tween(e,c.opts,t,n,c.opts.specialEasing[t]||c.opts.easing);return c.tweens.push(r),r},stop:function(t){var n=0,r=t?c.tweens.length:0;if(o)return this;for(o=!0;n<r;n++)c.tweens[n].run(1);return t?(a.notifyWith(e,[c,1,0]),a.resolveWith(e,[c,t])):a.rejectWith(e,[c,t]),this}}),l=c.props;for(_(l,c.opts.specialEasing);i<s;i++)if(r=U.prefilters[i].call(c,e,l,c.opts))return de.isFunction(r.stop)&&(de._queueHooks(c.elem,c.opts.queue).stop=de.proxy(r.stop,r)),r;return de.map(l,W,c),de.isFunction(c.opts.start)&&c.opts.start.call(e,c),de.fx.timer(de.extend(u,{elem:e,anim:c,queue:c.opts.queue})),c.progress(c.opts.progress).done(c.opts.done,c.opts.complete).fail(c.opts.fail).always(c.opts.always)}function z(e){var t=e.match(qe)||[];return t.join(" ")}function X(e){return e.getAttribute&&e.getAttribute("class")||""}function V(e,t,n,r){var o;if(de.isArray(t))de.each(t,function(t,o){n||Et.test(e)?r(e,o):V(e+"["+("object"==typeof o&&null!=o?t:"")+"]",o,n,r)});else if(n||"object"!==de.type(t))r(e,t);else for(o in t)V(e+"["+o+"]",t[o],n,r)}function G(e){return function(t,n){"string"!=typeof t&&(n=t,t="*");var r,o=0,i=t.toLowerCase().match(qe)||[];if(de.isFunction(n))for(;r=i[o++];)"+"===r[0]?(r=r.slice(1)||"*",(e[r]=e[r]||[]).unshift(n)):(e[r]=e[r]||[]).push(n)}}function Y(e,t,n,r){function o(a){var u;return i[a]=!0,de.each(e[a]||[],function(e,a){var c=a(t,n,r);return"string"!=typeof c||s||i[c]?s?!(u=c):void 0:(t.dataTypes.unshift(c),o(c),!1)}),u}var i={},s=e===Pt;return o(t.dataTypes[0])||!i["*"]&&o("*")}function Q(e,t){var n,r,o=de.ajaxSettings.flatOptions||{};for(n in t)void 0!==t[n]&&((o[n]?e:r||(r={}))[n]=t[n]);return r&&de.extend(!0,e,r),e}function J(e,t,n){for(var r,o,i,s,a=e.contents,u=e.dataTypes;"*"===u[0];)u.shift(),void 0===r&&(r=e.mimeType||t.getResponseHeader("Content-Type"));if(r)for(o in a)if(a[o]&&a[o].test(r)){u.unshift(o);break}if(u[0]in n)i=u[0];else{for(o in n){if(!u[0]||e.converters[o+" "+u[0]]){i=o;break}s||(s=o)}i=i||s}if(i)return i!==u[0]&&u.unshift(i),n[i]}function K(e,t,n,r){var o,i,s,a,u,c={},l=e.dataTypes.slice();if(l[1])for(s in e.converters)c[s.toLowerCase()]=e.converters[s];for(i=l.shift();i;)if(e.responseFields[i]&&(n[e.responseFields[i]]=t),!u&&r&&e.dataFilter&&(t=e.dataFilter(t,e.dataType)),u=i,i=l.shift())if("*"===i)i=u;else if("*"!==u&&u!==i){if(s=c[u+" "+i]||c["* "+i],!s)for(o in c)if(a=o.split(" "),a[1]===i&&(s=c[u+" "+a[0]]||c["* "+a[0]])){s===!0?s=c[o]:c[o]!==!0&&(i=a[0],l.unshift(a[1]));break}if(s!==!0)if(s&&e.throws)t=s(t);else try{t=s(t)}catch(e){return{state:"parsererror",error:s?e:"No conversion from "+u+" to "+i}}}return{state:"success",data:t}}function Z(e){return de.isWindow(e)?e:9===e.nodeType&&e.defaultView}var ee=[],te=e.document,ne=Object.getPrototypeOf,re=ee.slice,oe=ee.concat,ie=ee.push,se=ee.indexOf,ae={},ue=ae.toString,ce=ae.hasOwnProperty,le=ce.toString,fe=le.call(Object),pe={},he="3.1.1",de=function(e,t){return new de.fn.init(e,t)},ge=/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g,me=/^-ms-/,ve=/-([a-z])/g,ye=function(e,t){return t.toUpperCase()};de.fn=de.prototype={jquery:he,constructor:de,length:0,toArray:function(){return re.call(this)},get:function(e){return null==e?re.call(this):e<0?this[e+this.length]:this[e]},pushStack:function(e){var t=de.merge(this.constructor(),e);return t.prevObject=this,t},each:function(e){return de.each(this,e)},map:function(e){return this.pushStack(de.map(this,function(t,n){return e.call(t,n,t)}))},slice:function(){return this.pushStack(re.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},eq:function(e){var t=this.length,n=+e+(e<0?t:0);return this.pushStack(n>=0&&n<t?[this[n]]:[])},end:function(){return this.prevObject||this.constructor()},push:ie,sort:ee.sort,splice:ee.splice},de.extend=de.fn.extend=function(){var e,t,n,r,o,i,s=arguments[0]||{},a=1,u=arguments.length,c=!1;for("boolean"==typeof s&&(c=s,s=arguments[a]||{},a++),"object"==typeof s||de.isFunction(s)||(s={}),a===u&&(s=this,a--);a<u;a++)if(null!=(e=arguments[a]))for(t in e)n=s[t],r=e[t],s!==r&&(c&&r&&(de.isPlainObject(r)||(o=de.isArray(r)))?(o?(o=!1,i=n&&de.isArray(n)?n:[]):i=n&&de.isPlainObject(n)?n:{},s[t]=de.extend(c,i,r)):void 0!==r&&(s[t]=r));return s},de.extend({expando:"jQuery"+(he+Math.random()).replace(/\D/g,""),isReady:!0,error:function(e){throw new Error(e)},noop:function(){},isFunction:function(e){return"function"===de.type(e)},isArray:Array.isArray,isWindow:function(e){return null!=e&&e===e.window},isNumeric:function(e){var t=de.type(e);return("number"===t||"string"===t)&&!isNaN(e-parseFloat(e))},isPlainObject:function(e){var t,n;return!(!e||"[object Object]"!==ue.call(e))&&(!(t=ne(e))||(n=ce.call(t,"constructor")&&t.constructor,"function"==typeof n&&le.call(n)===fe))},isEmptyObject:function(e){var t;for(t in e)return!1;return!0},type:function(e){return null==e?e+"":"object"==typeof e||"function"==typeof e?ae[ue.call(e)]||"object":typeof e},globalEval:function(e){n(e)},camelCase:function(e){return e.replace(me,"ms-").replace(ve,ye)},nodeName:function(e,t){return e.nodeName&&e.nodeName.toLowerCase()===t.toLowerCase()},each:function(e,t){var n,o=0;if(r(e))for(n=e.length;o<n&&t.call(e[o],o,e[o])!==!1;o++);else for(o in e)if(t.call(e[o],o,e[o])===!1)break;return e},trim:function(e){return null==e?"":(e+"").replace(ge,"")},makeArray:function(e,t){var n=t||[];return null!=e&&(r(Object(e))?de.merge(n,"string"==typeof e?[e]:e):ie.call(n,e)),n},inArray:function(e,t,n){return null==t?-1:se.call(t,e,n)},merge:function(e,t){for(var n=+t.length,r=0,o=e.length;r<n;r++)e[o++]=t[r];return e.length=o,e},grep:function(e,t,n){for(var r,o=[],i=0,s=e.length,a=!n;i<s;i++)r=!t(e[i],i),r!==a&&o.push(e[i]);return o},map:function(e,t,n){var o,i,s=0,a=[];if(r(e))for(o=e.length;s<o;s++)i=t(e[s],s,n),null!=i&&a.push(i);else for(s in e)i=t(e[s],s,n),null!=i&&a.push(i);return oe.apply([],a)},guid:1,proxy:function(e,t){var n,r,o;if("string"==typeof t&&(n=e[t],t=e,e=n),de.isFunction(e))return r=re.call(arguments,2),o=function(){return e.apply(t||this,r.concat(re.call(arguments)))},o.guid=e.guid=e.guid||de.guid++,o},now:Date.now,support:pe}),"function"==typeof Symbol&&(de.fn[Symbol.iterator]=ee[Symbol.iterator]),de.each("Boolean Number String Function Array Date RegExp Object Error Symbol".split(" "),function(e,t){ae["[object "+t+"]"]=t.toLowerCase()});var xe=function(e){function t(e,t,n,r){var o,i,s,a,u,c,l,p=t&&t.ownerDocument,d=t?t.nodeType:9;if(n=n||[],"string"!=typeof e||!e||1!==d&&9!==d&&11!==d)return n;if(!r&&((t?t.ownerDocument||t:W)!==L&&O(t),t=t||L,F)){if(11!==d&&(u=ve.exec(e)))if(o=u[1]){if(9===d){if(!(s=t.getElementById(o)))return n;if(s.id===o)return n.push(s),n}else if(p&&(s=p.getElementById(o))&&M(t,s)&&s.id===o)return n.push(s),n}else{if(u[2])return K.apply(n,t.getElementsByTagName(e)),n;if((o=u[3])&&T.getElementsByClassName&&t.getElementsByClassName)return K.apply(n,t.getElementsByClassName(o)),n}if(T.qsa&&!X[e+" "]&&(!R||!R.test(e))){if(1!==d)p=t,l=e;else if("object"!==t.nodeName.toLowerCase()){for((a=t.getAttribute("id"))?a=a.replace(we,Te):t.setAttribute("id",a=$),c=E(e),i=c.length;i--;)c[i]="#"+a+" "+h(c[i]);l=c.join(","),p=ye.test(e)&&f(t.parentNode)||t}if(l)try{return K.apply(n,p.querySelectorAll(l)),n}catch(e){}finally{a===$&&t.removeAttribute("id")}}}return N(e.replace(ae,"$1"),t,n,r)}function n(){function e(n,r){return t.push(n+" ")>C.cacheLength&&delete e[t.shift()],e[n+" "]=r}var t=[];return e}function r(e){return e[$]=!0,e}function o(e){var t=L.createElement("fieldset");try{return!!e(t)}catch(e){return!1}finally{t.parentNode&&t.parentNode.removeChild(t),t=null}}function i(e,t){for(var n=e.split("|"),r=n.length;r--;)C.attrHandle[n[r]]=t}function s(e,t){var n=t&&e,r=n&&1===e.nodeType&&1===t.nodeType&&e.sourceIndex-t.sourceIndex;if(r)return r;if(n)for(;n=n.nextSibling;)if(n===t)return-1;return e?1:-1}function a(e){return function(t){var n=t.nodeName.toLowerCase();return"input"===n&&t.type===e}}function u(e){return function(t){var n=t.nodeName.toLowerCase();return("input"===n||"button"===n)&&t.type===e}}function c(e){return function(t){return"form"in t?t.parentNode&&t.disabled===!1?"label"in t?"label"in t.parentNode?t.parentNode.disabled===e:t.disabled===e:t.isDisabled===e||t.isDisabled!==!e&&je(t)===e:t.disabled===e:"label"in t&&t.disabled===e}}function l(e){return r(function(t){return t=+t,r(function(n,r){for(var o,i=e([],n.length,t),s=i.length;s--;)n[o=i[s]]&&(n[o]=!(r[o]=n[o]))})})}function f(e){return e&&"undefined"!=typeof e.getElementsByTagName&&e}function p(){}function h(e){for(var t=0,n=e.length,r="";t<n;t++)r+=e[t].value;return r}function d(e,t,n){var r=t.dir,o=t.next,i=o||r,s=n&&"parentNode"===i,a=_++;return t.first?function(t,n,o){for(;t=t[r];)if(1===t.nodeType||s)return e(t,n,o);return!1}:function(t,n,u){var c,l,f,p=[B,a];if(u){for(;t=t[r];)if((1===t.nodeType||s)&&e(t,n,u))return!0}else for(;t=t[r];)if(1===t.nodeType||s)if(f=t[$]||(t[$]={}),l=f[t.uniqueID]||(f[t.uniqueID]={}),o&&o===t.nodeName.toLowerCase())t=t[r]||t;else{if((c=l[i])&&c[0]===B&&c[1]===a)return p[2]=c[2];if(l[i]=p,p[2]=e(t,n,u))return!0}return!1}}function g(e){return e.length>1?function(t,n,r){for(var o=e.length;o--;)if(!e[o](t,n,r))return!1;return!0}:e[0]}function m(e,n,r){for(var o=0,i=n.length;o<i;o++)t(e,n[o],r);return r}function v(e,t,n,r,o){for(var i,s=[],a=0,u=e.length,c=null!=t;a<u;a++)(i=e[a])&&(n&&!n(i,r,o)||(s.push(i),c&&t.push(a)));return s}function y(e,t,n,o,i,s){return o&&!o[$]&&(o=y(o)),i&&!i[$]&&(i=y(i,s)),r(function(r,s,a,u){var c,l,f,p=[],h=[],d=s.length,g=r||m(t||"*",a.nodeType?[a]:a,[]),y=!e||!r&&t?g:v(g,p,e,a,u),x=n?i||(r?e:d||o)?[]:s:y;if(n&&n(y,x,a,u),o)for(c=v(x,h),o(c,[],a,u),l=c.length;l--;)(f=c[l])&&(x[h[l]]=!(y[h[l]]=f));if(r){if(i||e){if(i){for(c=[],l=x.length;l--;)(f=x[l])&&c.push(y[l]=f);i(null,x=[],c,u)}for(l=x.length;l--;)(f=x[l])&&(c=i?ee(r,f):p[l])>-1&&(r[c]=!(s[c]=f))}}else x=v(x===s?x.splice(d,x.length):x),i?i(null,s,x,u):K.apply(s,x)})}function x(e){for(var t,n,r,o=e.length,i=C.relative[e[0].type],s=i||C.relative[" "],a=i?1:0,u=d(function(e){return e===t},s,!0),c=d(function(e){return ee(t,e)>-1},s,!0),l=[function(e,n,r){var o=!i&&(r||n!==A)||((t=n).nodeType?u(e,n,r):c(e,n,r));return t=null,o}];a<o;a++)if(n=C.relative[e[a].type])l=[d(g(l),n)];else{if(n=C.filter[e[a].type].apply(null,e[a].matches),n[$]){for(r=++a;r<o&&!C.relative[e[r].type];r++);return y(a>1&&g(l),a>1&&h(e.slice(0,a-1).concat({value:" "===e[a-2].type?"*":""})).replace(ae,"$1"),n,a<r&&x(e.slice(a,r)),r<o&&x(e=e.slice(r)),r<o&&h(e))}l.push(n)}return g(l)}function b(e,n){var o=n.length>0,i=e.length>0,s=function(r,s,a,u,c){var l,f,p,h=0,d="0",g=r&&[],m=[],y=A,x=r||i&&C.find.TAG("*",c),b=B+=null==y?1:Math.random()||.1,w=x.length;for(c&&(A=s===L||s||c);d!==w&&null!=(l=x[d]);d++){if(i&&l){for(f=0,s||l.ownerDocument===L||(O(l),a=!F);p=e[f++];)if(p(l,s||L,a)){u.push(l);break}c&&(B=b)}o&&((l=!p&&l)&&h--,r&&g.push(l))}if(h+=d,o&&d!==h){for(f=0;p=n[f++];)p(g,m,s,a);if(r){if(h>0)for(;d--;)g[d]||m[d]||(m[d]=Q.call(u));m=v(m)}K.apply(u,m),c&&!r&&m.length>0&&h+n.length>1&&t.uniqueSort(u)}return c&&(B=b,A=y),g};return o?r(s):s}var w,T,C,j,k,E,S,N,A,q,D,O,L,H,F,R,I,P,M,$="sizzle"+1*new Date,W=e.document,B=0,_=0,U=n(),z=n(),X=n(),V=function(e,t){return e===t&&(D=!0),0},G={}.hasOwnProperty,Y=[],Q=Y.pop,J=Y.push,K=Y.push,Z=Y.slice,ee=function(e,t){for(var n=0,r=e.length;n<r;n++)if(e[n]===t)return n;return-1},te="checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped",ne="[\\x20\\t\\r\\n\\f]",re="(?:\\\\.|[\\w-]|[^\0-\\xa0])+",oe="\\["+ne+"*("+re+")(?:"+ne+"*([*^$|!~]?=)"+ne+"*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|("+re+"))|)"+ne+"*\\]",ie=":("+re+")(?:\\((('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|((?:\\\\.|[^\\\\()[\\]]|"+oe+")*)|.*)\\)|)",se=new RegExp(ne+"+","g"),ae=new RegExp("^"+ne+"+|((?:^|[^\\\\])(?:\\\\.)*)"+ne+"+$","g"),ue=new RegExp("^"+ne+"*,"+ne+"*"),ce=new RegExp("^"+ne+"*([>+~]|"+ne+")"+ne+"*"),le=new RegExp("="+ne+"*([^\\]'\"]*?)"+ne+"*\\]","g"),fe=new RegExp(ie),pe=new RegExp("^"+re+"$"),he={ID:new RegExp("^#("+re+")"),CLASS:new RegExp("^\\.("+re+")"),TAG:new RegExp("^("+re+"|[*])"),ATTR:new RegExp("^"+oe),PSEUDO:new RegExp("^"+ie),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+ne+"*(even|odd|(([+-]|)(\\d*)n|)"+ne+"*(?:([+-]|)"+ne+"*(\\d+)|))"+ne+"*\\)|)","i"),bool:new RegExp("^(?:"+te+")$","i"),needsContext:new RegExp("^"+ne+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+ne+"*((?:-\\d)?\\d*)"+ne+"*\\)|)(?=[^-]|$)","i")},de=/^(?:input|select|textarea|button)$/i,ge=/^h\d$/i,me=/^[^{]+\{\s*\[native \w/,ve=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,ye=/[+~]/,xe=new RegExp("\\\\([\\da-f]{1,6}"+ne+"?|("+ne+")|.)","ig"),be=function(e,t,n){var r="0x"+t-65536;return r!==r||n?t:r<0?String.fromCharCode(r+65536):String.fromCharCode(r>>10|55296,1023&r|56320)},we=/([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,Te=function(e,t){return t?"\0"===e?"�":e.slice(0,-1)+"\\"+e.charCodeAt(e.length-1).toString(16)+" ":"\\"+e},Ce=function(){O()},je=d(function(e){return e.disabled===!0&&("form"in e||"label"in e)},{dir:"parentNode",next:"legend"});try{K.apply(Y=Z.call(W.childNodes),W.childNodes),Y[W.childNodes.length].nodeType}catch(e){K={apply:Y.length?function(e,t){J.apply(e,Z.call(t))}:function(e,t){for(var n=e.length,r=0;e[n++]=t[r++];);e.length=n-1}}}T=t.support={},k=t.isXML=function(e){var t=e&&(e.ownerDocument||e).documentElement;return!!t&&"HTML"!==t.nodeName},O=t.setDocument=function(e){var t,n,r=e?e.ownerDocument||e:W;return r!==L&&9===r.nodeType&&r.documentElement?(L=r,H=L.documentElement,F=!k(L),W!==L&&(n=L.defaultView)&&n.top!==n&&(n.addEventListener?n.addEventListener("unload",Ce,!1):n.attachEvent&&n.attachEvent("onunload",Ce)),T.attributes=o(function(e){return e.className="i",!e.getAttribute("className")}),T.getElementsByTagName=o(function(e){return e.appendChild(L.createComment("")),!e.getElementsByTagName("*").length}),T.getElementsByClassName=me.test(L.getElementsByClassName),T.getById=o(function(e){return H.appendChild(e).id=$,!L.getElementsByName||!L.getElementsByName($).length}),T.getById?(C.filter.ID=function(e){var t=e.replace(xe,be);return function(e){return e.getAttribute("id")===t}},C.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&F){var n=t.getElementById(e);return n?[n]:[]}}):(C.filter.ID=function(e){var t=e.replace(xe,be);return function(e){var n="undefined"!=typeof e.getAttributeNode&&e.getAttributeNode("id");return n&&n.value===t}},C.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&F){var n,r,o,i=t.getElementById(e);if(i){if(n=i.getAttributeNode("id"),n&&n.value===e)return[i];for(o=t.getElementsByName(e),r=0;i=o[r++];)if(n=i.getAttributeNode("id"),n&&n.value===e)return[i]}return[]}}),C.find.TAG=T.getElementsByTagName?function(e,t){return"undefined"!=typeof t.getElementsByTagName?t.getElementsByTagName(e):T.qsa?t.querySelectorAll(e):void 0}:function(e,t){var n,r=[],o=0,i=t.getElementsByTagName(e);if("*"===e){for(;n=i[o++];)1===n.nodeType&&r.push(n);return r}return i},C.find.CLASS=T.getElementsByClassName&&function(e,t){if("undefined"!=typeof t.getElementsByClassName&&F)return t.getElementsByClassName(e)},I=[],R=[],(T.qsa=me.test(L.querySelectorAll))&&(o(function(e){H.appendChild(e).innerHTML="<a id='"+$+"'></a><select id='"+$+"-\r\\' msallowcapture=''><option selected=''></option></select>",e.querySelectorAll("[msallowcapture^='']").length&&R.push("[*^$]="+ne+"*(?:''|\"\")"),e.querySelectorAll("[selected]").length||R.push("\\["+ne+"*(?:value|"+te+")"),e.querySelectorAll("[id~="+$+"-]").length||R.push("~="),e.querySelectorAll(":checked").length||R.push(":checked"),e.querySelectorAll("a#"+$+"+*").length||R.push(".#.+[+~]")}),o(function(e){e.innerHTML="<a href='' disabled='disabled'></a><select disabled='disabled'><option/></select>";var t=L.createElement("input");t.setAttribute("type","hidden"),e.appendChild(t).setAttribute("name","D"),e.querySelectorAll("[name=d]").length&&R.push("name"+ne+"*[*^$|!~]?="),2!==e.querySelectorAll(":enabled").length&&R.push(":enabled",":disabled"),H.appendChild(e).disabled=!0,2!==e.querySelectorAll(":disabled").length&&R.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),R.push(",.*:")})),(T.matchesSelector=me.test(P=H.matches||H.webkitMatchesSelector||H.mozMatchesSelector||H.oMatchesSelector||H.msMatchesSelector))&&o(function(e){T.disconnectedMatch=P.call(e,"*"),P.call(e,"[s!='']:x"),I.push("!=",ie)}),R=R.length&&new RegExp(R.join("|")),I=I.length&&new RegExp(I.join("|")),t=me.test(H.compareDocumentPosition),M=t||me.test(H.contains)?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)for(;t=t.parentNode;)if(t===e)return!0;return!1},V=t?function(e,t){if(e===t)return D=!0,0;var n=!e.compareDocumentPosition-!t.compareDocumentPosition;return n?n:(n=(e.ownerDocument||e)===(t.ownerDocument||t)?e.compareDocumentPosition(t):1,1&n||!T.sortDetached&&t.compareDocumentPosition(e)===n?e===L||e.ownerDocument===W&&M(W,e)?-1:t===L||t.ownerDocument===W&&M(W,t)?1:q?ee(q,e)-ee(q,t):0:4&n?-1:1)}:function(e,t){if(e===t)return D=!0,0;var n,r=0,o=e.parentNode,i=t.parentNode,a=[e],u=[t];if(!o||!i)return e===L?-1:t===L?1:o?-1:i?1:q?ee(q,e)-ee(q,t):0;if(o===i)return s(e,t);for(n=e;n=n.parentNode;)a.unshift(n);for(n=t;n=n.parentNode;)u.unshift(n);for(;a[r]===u[r];)r++;return r?s(a[r],u[r]):a[r]===W?-1:u[r]===W?1:0},L):L},t.matches=function(e,n){return t(e,null,null,n)},t.matchesSelector=function(e,n){if((e.ownerDocument||e)!==L&&O(e),n=n.replace(le,"='$1']"),T.matchesSelector&&F&&!X[n+" "]&&(!I||!I.test(n))&&(!R||!R.test(n)))try{var r=P.call(e,n);if(r||T.disconnectedMatch||e.document&&11!==e.document.nodeType)return r}catch(e){}return t(n,L,null,[e]).length>0},t.contains=function(e,t){return(e.ownerDocument||e)!==L&&O(e),M(e,t)},t.attr=function(e,t){(e.ownerDocument||e)!==L&&O(e);var n=C.attrHandle[t.toLowerCase()],r=n&&G.call(C.attrHandle,t.toLowerCase())?n(e,t,!F):void 0;return void 0!==r?r:T.attributes||!F?e.getAttribute(t):(r=e.getAttributeNode(t))&&r.specified?r.value:null},t.escape=function(e){return(e+"").replace(we,Te)},t.error=function(e){throw new Error("Syntax error, unrecognized expression: "+e)},t.uniqueSort=function(e){var t,n=[],r=0,o=0;if(D=!T.detectDuplicates,q=!T.sortStable&&e.slice(0),e.sort(V),D){for(;t=e[o++];)t===e[o]&&(r=n.push(o));for(;r--;)e.splice(n[r],1)}return q=null,e},j=t.getText=function(e){var t,n="",r=0,o=e.nodeType;if(o){if(1===o||9===o||11===o){if("string"==typeof e.textContent)return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=j(e)}else if(3===o||4===o)return e.nodeValue}else for(;t=e[r++];)n+=j(t);return n},C=t.selectors={cacheLength:50,createPseudo:r,match:he,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace(xe,be),e[3]=(e[3]||e[4]||e[5]||"").replace(xe,be),"~="===e[2]&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),"nth"===e[1].slice(0,3)?(e[3]||t.error(e[0]),e[4]=+(e[4]?e[5]+(e[6]||1):2*("even"===e[3]||"odd"===e[3])),e[5]=+(e[7]+e[8]||"odd"===e[3])):e[3]&&t.error(e[0]),e},PSEUDO:function(e){var t,n=!e[6]&&e[2];return he.CHILD.test(e[0])?null:(e[3]?e[2]=e[4]||e[5]||"":n&&fe.test(n)&&(t=E(n,!0))&&(t=n.indexOf(")",n.length-t)-n.length)&&(e[0]=e[0].slice(0,t),e[2]=n.slice(0,t)),e.slice(0,3))}},filter:{TAG:function(e){var t=e.replace(xe,be).toLowerCase();return"*"===e?function(){return!0}:function(e){return e.nodeName&&e.nodeName.toLowerCase()===t}},CLASS:function(e){var t=U[e+" "];return t||(t=new RegExp("(^|"+ne+")"+e+"("+ne+"|$)"))&&U(e,function(e){return t.test("string"==typeof e.className&&e.className||"undefined"!=typeof e.getAttribute&&e.getAttribute("class")||"")})},ATTR:function(e,n,r){return function(o){var i=t.attr(o,e);return null==i?"!="===n:!n||(i+="","="===n?i===r:"!="===n?i!==r:"^="===n?r&&0===i.indexOf(r):"*="===n?r&&i.indexOf(r)>-1:"$="===n?r&&i.slice(-r.length)===r:"~="===n?(" "+i.replace(se," ")+" ").indexOf(r)>-1:"|="===n&&(i===r||i.slice(0,r.length+1)===r+"-"))}},CHILD:function(e,t,n,r,o){var i="nth"!==e.slice(0,3),s="last"!==e.slice(-4),a="of-type"===t;return 1===r&&0===o?function(e){return!!e.parentNode}:function(t,n,u){var c,l,f,p,h,d,g=i!==s?"nextSibling":"previousSibling",m=t.parentNode,v=a&&t.nodeName.toLowerCase(),y=!u&&!a,x=!1;if(m){if(i){for(;g;){for(p=t;p=p[g];)if(a?p.nodeName.toLowerCase()===v:1===p.nodeType)return!1;d=g="only"===e&&!d&&"nextSibling"}return!0}if(d=[s?m.firstChild:m.lastChild],s&&y){for(p=m,f=p[$]||(p[$]={}),l=f[p.uniqueID]||(f[p.uniqueID]={}),c=l[e]||[],h=c[0]===B&&c[1],x=h&&c[2],p=h&&m.childNodes[h];p=++h&&p&&p[g]||(x=h=0)||d.pop();)if(1===p.nodeType&&++x&&p===t){l[e]=[B,h,x];break}}else if(y&&(p=t,f=p[$]||(p[$]={}),l=f[p.uniqueID]||(f[p.uniqueID]={}),c=l[e]||[],h=c[0]===B&&c[1],x=h),x===!1)for(;(p=++h&&p&&p[g]||(x=h=0)||d.pop())&&((a?p.nodeName.toLowerCase()!==v:1!==p.nodeType)||!++x||(y&&(f=p[$]||(p[$]={}),l=f[p.uniqueID]||(f[p.uniqueID]={}),l[e]=[B,x]),p!==t)););return x-=o,x===r||x%r===0&&x/r>=0}}},PSEUDO:function(e,n){var o,i=C.pseudos[e]||C.setFilters[e.toLowerCase()]||t.error("unsupported pseudo: "+e);return i[$]?i(n):i.length>1?(o=[e,e,"",n],C.setFilters.hasOwnProperty(e.toLowerCase())?r(function(e,t){for(var r,o=i(e,n),s=o.length;s--;)r=ee(e,o[s]),e[r]=!(t[r]=o[s])}):function(e){return i(e,0,o)}):i}},pseudos:{not:r(function(e){var t=[],n=[],o=S(e.replace(ae,"$1"));return o[$]?r(function(e,t,n,r){for(var i,s=o(e,null,r,[]),a=e.length;a--;)(i=s[a])&&(e[a]=!(t[a]=i))}):function(e,r,i){return t[0]=e,o(t,null,i,n),t[0]=null,!n.pop()}}),has:r(function(e){return function(n){
+return t(e,n).length>0}}),contains:r(function(e){return e=e.replace(xe,be),function(t){return(t.textContent||t.innerText||j(t)).indexOf(e)>-1}}),lang:r(function(e){return pe.test(e||"")||t.error("unsupported lang: "+e),e=e.replace(xe,be).toLowerCase(),function(t){var n;do if(n=F?t.lang:t.getAttribute("xml:lang")||t.getAttribute("lang"))return n=n.toLowerCase(),n===e||0===n.indexOf(e+"-");while((t=t.parentNode)&&1===t.nodeType);return!1}}),target:function(t){var n=e.location&&e.location.hash;return n&&n.slice(1)===t.id},root:function(e){return e===H},focus:function(e){return e===L.activeElement&&(!L.hasFocus||L.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},enabled:c(!1),disabled:c(!0),checked:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&!!e.checked||"option"===t&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,e.selected===!0},empty:function(e){for(e=e.firstChild;e;e=e.nextSibling)if(e.nodeType<6)return!1;return!0},parent:function(e){return!C.pseudos.empty(e)},header:function(e){return ge.test(e.nodeName)},input:function(e){return de.test(e.nodeName)},button:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&"button"===e.type||"button"===t},text:function(e){var t;return"input"===e.nodeName.toLowerCase()&&"text"===e.type&&(null==(t=e.getAttribute("type"))||"text"===t.toLowerCase())},first:l(function(){return[0]}),last:l(function(e,t){return[t-1]}),eq:l(function(e,t,n){return[n<0?n+t:n]}),even:l(function(e,t){for(var n=0;n<t;n+=2)e.push(n);return e}),odd:l(function(e,t){for(var n=1;n<t;n+=2)e.push(n);return e}),lt:l(function(e,t,n){for(var r=n<0?n+t:n;--r>=0;)e.push(r);return e}),gt:l(function(e,t,n){for(var r=n<0?n+t:n;++r<t;)e.push(r);return e})}},C.pseudos.nth=C.pseudos.eq;for(w in{radio:!0,checkbox:!0,file:!0,password:!0,image:!0})C.pseudos[w]=a(w);for(w in{submit:!0,reset:!0})C.pseudos[w]=u(w);return p.prototype=C.filters=C.pseudos,C.setFilters=new p,E=t.tokenize=function(e,n){var r,o,i,s,a,u,c,l=z[e+" "];if(l)return n?0:l.slice(0);for(a=e,u=[],c=C.preFilter;a;){r&&!(o=ue.exec(a))||(o&&(a=a.slice(o[0].length)||a),u.push(i=[])),r=!1,(o=ce.exec(a))&&(r=o.shift(),i.push({value:r,type:o[0].replace(ae," ")}),a=a.slice(r.length));for(s in C.filter)!(o=he[s].exec(a))||c[s]&&!(o=c[s](o))||(r=o.shift(),i.push({value:r,type:s,matches:o}),a=a.slice(r.length));if(!r)break}return n?a.length:a?t.error(e):z(e,u).slice(0)},S=t.compile=function(e,t){var n,r=[],o=[],i=X[e+" "];if(!i){for(t||(t=E(e)),n=t.length;n--;)i=x(t[n]),i[$]?r.push(i):o.push(i);i=X(e,b(o,r)),i.selector=e}return i},N=t.select=function(e,t,n,r){var o,i,s,a,u,c="function"==typeof e&&e,l=!r&&E(e=c.selector||e);if(n=n||[],1===l.length){if(i=l[0]=l[0].slice(0),i.length>2&&"ID"===(s=i[0]).type&&9===t.nodeType&&F&&C.relative[i[1].type]){if(t=(C.find.ID(s.matches[0].replace(xe,be),t)||[])[0],!t)return n;c&&(t=t.parentNode),e=e.slice(i.shift().value.length)}for(o=he.needsContext.test(e)?0:i.length;o--&&(s=i[o],!C.relative[a=s.type]);)if((u=C.find[a])&&(r=u(s.matches[0].replace(xe,be),ye.test(i[0].type)&&f(t.parentNode)||t))){if(i.splice(o,1),e=r.length&&h(i),!e)return K.apply(n,r),n;break}}return(c||S(e,l))(r,t,!F,n,!t||ye.test(e)&&f(t.parentNode)||t),n},T.sortStable=$.split("").sort(V).join("")===$,T.detectDuplicates=!!D,O(),T.sortDetached=o(function(e){return 1&e.compareDocumentPosition(L.createElement("fieldset"))}),o(function(e){return e.innerHTML="<a href='#'></a>","#"===e.firstChild.getAttribute("href")})||i("type|href|height|width",function(e,t,n){if(!n)return e.getAttribute(t,"type"===t.toLowerCase()?1:2)}),T.attributes&&o(function(e){return e.innerHTML="<input/>",e.firstChild.setAttribute("value",""),""===e.firstChild.getAttribute("value")})||i("value",function(e,t,n){if(!n&&"input"===e.nodeName.toLowerCase())return e.defaultValue}),o(function(e){return null==e.getAttribute("disabled")})||i(te,function(e,t,n){var r;if(!n)return e[t]===!0?t.toLowerCase():(r=e.getAttributeNode(t))&&r.specified?r.value:null}),t}(e);de.find=xe,de.expr=xe.selectors,de.expr[":"]=de.expr.pseudos,de.uniqueSort=de.unique=xe.uniqueSort,de.text=xe.getText,de.isXMLDoc=xe.isXML,de.contains=xe.contains,de.escapeSelector=xe.escape;var be=function(e,t,n){for(var r=[],o=void 0!==n;(e=e[t])&&9!==e.nodeType;)if(1===e.nodeType){if(o&&de(e).is(n))break;r.push(e)}return r},we=function(e,t){for(var n=[];e;e=e.nextSibling)1===e.nodeType&&e!==t&&n.push(e);return n},Te=de.expr.match.needsContext,Ce=/^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i,je=/^.[^:#\[\.,]*$/;de.filter=function(e,t,n){var r=t[0];return n&&(e=":not("+e+")"),1===t.length&&1===r.nodeType?de.find.matchesSelector(r,e)?[r]:[]:de.find.matches(e,de.grep(t,function(e){return 1===e.nodeType}))},de.fn.extend({find:function(e){var t,n,r=this.length,o=this;if("string"!=typeof e)return this.pushStack(de(e).filter(function(){for(t=0;t<r;t++)if(de.contains(o[t],this))return!0}));for(n=this.pushStack([]),t=0;t<r;t++)de.find(e,o[t],n);return r>1?de.uniqueSort(n):n},filter:function(e){return this.pushStack(o(this,e||[],!1))},not:function(e){return this.pushStack(o(this,e||[],!0))},is:function(e){return!!o(this,"string"==typeof e&&Te.test(e)?de(e):e||[],!1).length}});var ke,Ee=/^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/,Se=de.fn.init=function(e,t,n){var r,o;if(!e)return this;if(n=n||ke,"string"==typeof e){if(r="<"===e[0]&&">"===e[e.length-1]&&e.length>=3?[null,e,null]:Ee.exec(e),!r||!r[1]&&t)return!t||t.jquery?(t||n).find(e):this.constructor(t).find(e);if(r[1]){if(t=t instanceof de?t[0]:t,de.merge(this,de.parseHTML(r[1],t&&t.nodeType?t.ownerDocument||t:te,!0)),Ce.test(r[1])&&de.isPlainObject(t))for(r in t)de.isFunction(this[r])?this[r](t[r]):this.attr(r,t[r]);return this}return o=te.getElementById(r[2]),o&&(this[0]=o,this.length=1),this}return e.nodeType?(this[0]=e,this.length=1,this):de.isFunction(e)?void 0!==n.ready?n.ready(e):e(de):de.makeArray(e,this)};Se.prototype=de.fn,ke=de(te);var Ne=/^(?:parents|prev(?:Until|All))/,Ae={children:!0,contents:!0,next:!0,prev:!0};de.fn.extend({has:function(e){var t=de(e,this),n=t.length;return this.filter(function(){for(var e=0;e<n;e++)if(de.contains(this,t[e]))return!0})},closest:function(e,t){var n,r=0,o=this.length,i=[],s="string"!=typeof e&&de(e);if(!Te.test(e))for(;r<o;r++)for(n=this[r];n&&n!==t;n=n.parentNode)if(n.nodeType<11&&(s?s.index(n)>-1:1===n.nodeType&&de.find.matchesSelector(n,e))){i.push(n);break}return this.pushStack(i.length>1?de.uniqueSort(i):i)},index:function(e){return e?"string"==typeof e?se.call(de(e),this[0]):se.call(this,e.jquery?e[0]:e):this[0]&&this[0].parentNode?this.first().prevAll().length:-1},add:function(e,t){return this.pushStack(de.uniqueSort(de.merge(this.get(),de(e,t))))},addBack:function(e){return this.add(null==e?this.prevObject:this.prevObject.filter(e))}}),de.each({parent:function(e){var t=e.parentNode;return t&&11!==t.nodeType?t:null},parents:function(e){return be(e,"parentNode")},parentsUntil:function(e,t,n){return be(e,"parentNode",n)},next:function(e){return i(e,"nextSibling")},prev:function(e){return i(e,"previousSibling")},nextAll:function(e){return be(e,"nextSibling")},prevAll:function(e){return be(e,"previousSibling")},nextUntil:function(e,t,n){return be(e,"nextSibling",n)},prevUntil:function(e,t,n){return be(e,"previousSibling",n)},siblings:function(e){return we((e.parentNode||{}).firstChild,e)},children:function(e){return we(e.firstChild)},contents:function(e){return e.contentDocument||de.merge([],e.childNodes)}},function(e,t){de.fn[e]=function(n,r){var o=de.map(this,t,n);return"Until"!==e.slice(-5)&&(r=n),r&&"string"==typeof r&&(o=de.filter(r,o)),this.length>1&&(Ae[e]||de.uniqueSort(o),Ne.test(e)&&o.reverse()),this.pushStack(o)}});var qe=/[^\x20\t\r\n\f]+/g;de.Callbacks=function(e){e="string"==typeof e?s(e):de.extend({},e);var t,n,r,o,i=[],a=[],u=-1,c=function(){for(o=e.once,r=t=!0;a.length;u=-1)for(n=a.shift();++u<i.length;)i[u].apply(n[0],n[1])===!1&&e.stopOnFalse&&(u=i.length,n=!1);e.memory||(n=!1),t=!1,o&&(i=n?[]:"")},l={add:function(){return i&&(n&&!t&&(u=i.length-1,a.push(n)),function t(n){de.each(n,function(n,r){de.isFunction(r)?e.unique&&l.has(r)||i.push(r):r&&r.length&&"string"!==de.type(r)&&t(r)})}(arguments),n&&!t&&c()),this},remove:function(){return de.each(arguments,function(e,t){for(var n;(n=de.inArray(t,i,n))>-1;)i.splice(n,1),n<=u&&u--}),this},has:function(e){return e?de.inArray(e,i)>-1:i.length>0},empty:function(){return i&&(i=[]),this},disable:function(){return o=a=[],i=n="",this},disabled:function(){return!i},lock:function(){return o=a=[],n||t||(i=n=""),this},locked:function(){return!!o},fireWith:function(e,n){return o||(n=n||[],n=[e,n.slice?n.slice():n],a.push(n),t||c()),this},fire:function(){return l.fireWith(this,arguments),this},fired:function(){return!!r}};return l},de.extend({Deferred:function(t){var n=[["notify","progress",de.Callbacks("memory"),de.Callbacks("memory"),2],["resolve","done",de.Callbacks("once memory"),de.Callbacks("once memory"),0,"resolved"],["reject","fail",de.Callbacks("once memory"),de.Callbacks("once memory"),1,"rejected"]],r="pending",o={state:function(){return r},always:function(){return i.done(arguments).fail(arguments),this},catch:function(e){return o.then(null,e)},pipe:function(){var e=arguments;return de.Deferred(function(t){de.each(n,function(n,r){var o=de.isFunction(e[r[4]])&&e[r[4]];i[r[1]](function(){var e=o&&o.apply(this,arguments);e&&de.isFunction(e.promise)?e.promise().progress(t.notify).done(t.resolve).fail(t.reject):t[r[0]+"With"](this,o?[e]:arguments)})}),e=null}).promise()},then:function(t,r,o){function i(t,n,r,o){return function(){var c=this,l=arguments,f=function(){var e,f;if(!(t<s)){if(e=r.apply(c,l),e===n.promise())throw new TypeError("Thenable self-resolution");f=e&&("object"==typeof e||"function"==typeof e)&&e.then,de.isFunction(f)?o?f.call(e,i(s,n,a,o),i(s,n,u,o)):(s++,f.call(e,i(s,n,a,o),i(s,n,u,o),i(s,n,a,n.notifyWith))):(r!==a&&(c=void 0,l=[e]),(o||n.resolveWith)(c,l))}},p=o?f:function(){try{f()}catch(e){de.Deferred.exceptionHook&&de.Deferred.exceptionHook(e,p.stackTrace),t+1>=s&&(r!==u&&(c=void 0,l=[e]),n.rejectWith(c,l))}};t?p():(de.Deferred.getStackHook&&(p.stackTrace=de.Deferred.getStackHook()),e.setTimeout(p))}}var s=0;return de.Deferred(function(e){n[0][3].add(i(0,e,de.isFunction(o)?o:a,e.notifyWith)),n[1][3].add(i(0,e,de.isFunction(t)?t:a)),n[2][3].add(i(0,e,de.isFunction(r)?r:u))}).promise()},promise:function(e){return null!=e?de.extend(e,o):o}},i={};return de.each(n,function(e,t){var s=t[2],a=t[5];o[t[1]]=s.add,a&&s.add(function(){r=a},n[3-e][2].disable,n[0][2].lock),s.add(t[3].fire),i[t[0]]=function(){return i[t[0]+"With"](this===i?void 0:this,arguments),this},i[t[0]+"With"]=s.fireWith}),o.promise(i),t&&t.call(i,i),i},when:function(e){var t=arguments.length,n=t,r=Array(n),o=re.call(arguments),i=de.Deferred(),s=function(e){return function(n){r[e]=this,o[e]=arguments.length>1?re.call(arguments):n,--t||i.resolveWith(r,o)}};if(t<=1&&(c(e,i.done(s(n)).resolve,i.reject),"pending"===i.state()||de.isFunction(o[n]&&o[n].then)))return i.then();for(;n--;)c(o[n],s(n),i.reject);return i.promise()}});var De=/^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;de.Deferred.exceptionHook=function(t,n){e.console&&e.console.warn&&t&&De.test(t.name)&&e.console.warn("jQuery.Deferred exception: "+t.message,t.stack,n)},de.readyException=function(t){e.setTimeout(function(){throw t})};var Oe=de.Deferred();de.fn.ready=function(e){return Oe.then(e).catch(function(e){de.readyException(e)}),this},de.extend({isReady:!1,readyWait:1,holdReady:function(e){e?de.readyWait++:de.ready(!0)},ready:function(e){(e===!0?--de.readyWait:de.isReady)||(de.isReady=!0,e!==!0&&--de.readyWait>0||Oe.resolveWith(te,[de]))}}),de.ready.then=Oe.then,"complete"===te.readyState||"loading"!==te.readyState&&!te.documentElement.doScroll?e.setTimeout(de.ready):(te.addEventListener("DOMContentLoaded",l),e.addEventListener("load",l));var Le=function(e,t,n,r,o,i,s){var a=0,u=e.length,c=null==n;if("object"===de.type(n)){o=!0;for(a in n)Le(e,t,a,n[a],!0,i,s)}else if(void 0!==r&&(o=!0,de.isFunction(r)||(s=!0),c&&(s?(t.call(e,r),t=null):(c=t,t=function(e,t,n){return c.call(de(e),n)})),t))for(;a<u;a++)t(e[a],n,s?r:r.call(e[a],a,t(e[a],n)));return o?e:c?t.call(e):u?t(e[0],n):i},He=function(e){return 1===e.nodeType||9===e.nodeType||!+e.nodeType};f.uid=1,f.prototype={cache:function(e){var t=e[this.expando];return t||(t={},He(e)&&(e.nodeType?e[this.expando]=t:Object.defineProperty(e,this.expando,{value:t,configurable:!0}))),t},set:function(e,t,n){var r,o=this.cache(e);if("string"==typeof t)o[de.camelCase(t)]=n;else for(r in t)o[de.camelCase(r)]=t[r];return o},get:function(e,t){return void 0===t?this.cache(e):e[this.expando]&&e[this.expando][de.camelCase(t)]},access:function(e,t,n){return void 0===t||t&&"string"==typeof t&&void 0===n?this.get(e,t):(this.set(e,t,n),void 0!==n?n:t)},remove:function(e,t){var n,r=e[this.expando];if(void 0!==r){if(void 0!==t){de.isArray(t)?t=t.map(de.camelCase):(t=de.camelCase(t),t=t in r?[t]:t.match(qe)||[]),n=t.length;for(;n--;)delete r[t[n]]}(void 0===t||de.isEmptyObject(r))&&(e.nodeType?e[this.expando]=void 0:delete e[this.expando])}},hasData:function(e){var t=e[this.expando];return void 0!==t&&!de.isEmptyObject(t)}};var Fe=new f,Re=new f,Ie=/^(?:\{[\w\W]*\}|\[[\w\W]*\])$/,Pe=/[A-Z]/g;de.extend({hasData:function(e){return Re.hasData(e)||Fe.hasData(e)},data:function(e,t,n){return Re.access(e,t,n)},removeData:function(e,t){Re.remove(e,t)},_data:function(e,t,n){return Fe.access(e,t,n)},_removeData:function(e,t){Fe.remove(e,t)}}),de.fn.extend({data:function(e,t){var n,r,o,i=this[0],s=i&&i.attributes;if(void 0===e){if(this.length&&(o=Re.get(i),1===i.nodeType&&!Fe.get(i,"hasDataAttrs"))){for(n=s.length;n--;)s[n]&&(r=s[n].name,0===r.indexOf("data-")&&(r=de.camelCase(r.slice(5)),h(i,r,o[r])));Fe.set(i,"hasDataAttrs",!0)}return o}return"object"==typeof e?this.each(function(){Re.set(this,e)}):Le(this,function(t){var n;if(i&&void 0===t){if(n=Re.get(i,e),void 0!==n)return n;if(n=h(i,e),void 0!==n)return n}else this.each(function(){Re.set(this,e,t)})},null,t,arguments.length>1,null,!0)},removeData:function(e){return this.each(function(){Re.remove(this,e)})}}),de.extend({queue:function(e,t,n){var r;if(e)return t=(t||"fx")+"queue",r=Fe.get(e,t),n&&(!r||de.isArray(n)?r=Fe.access(e,t,de.makeArray(n)):r.push(n)),r||[]},dequeue:function(e,t){t=t||"fx";var n=de.queue(e,t),r=n.length,o=n.shift(),i=de._queueHooks(e,t),s=function(){de.dequeue(e,t)};"inprogress"===o&&(o=n.shift(),r--),o&&("fx"===t&&n.unshift("inprogress"),delete i.stop,o.call(e,s,i)),!r&&i&&i.empty.fire()},_queueHooks:function(e,t){var n=t+"queueHooks";return Fe.get(e,n)||Fe.access(e,n,{empty:de.Callbacks("once memory").add(function(){Fe.remove(e,[t+"queue",n])})})}}),de.fn.extend({queue:function(e,t){var n=2;return"string"!=typeof e&&(t=e,e="fx",n--),arguments.length<n?de.queue(this[0],e):void 0===t?this:this.each(function(){var n=de.queue(this,e,t);de._queueHooks(this,e),"fx"===e&&"inprogress"!==n[0]&&de.dequeue(this,e)})},dequeue:function(e){return this.each(function(){de.dequeue(this,e)})},clearQueue:function(e){return this.queue(e||"fx",[])},promise:function(e,t){var n,r=1,o=de.Deferred(),i=this,s=this.length,a=function(){--r||o.resolveWith(i,[i])};for("string"!=typeof e&&(t=e,e=void 0),e=e||"fx";s--;)n=Fe.get(i[s],e+"queueHooks"),n&&n.empty&&(r++,n.empty.add(a));return a(),o.promise(t)}});var Me=/[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/.source,$e=new RegExp("^(?:([+-])=|)("+Me+")([a-z%]*)$","i"),We=["Top","Right","Bottom","Left"],Be=function(e,t){return e=t||e,"none"===e.style.display||""===e.style.display&&de.contains(e.ownerDocument,e)&&"none"===de.css(e,"display")},_e=function(e,t,n,r){var o,i,s={};for(i in t)s[i]=e.style[i],e.style[i]=t[i];o=n.apply(e,r||[]);for(i in t)e.style[i]=s[i];return o},Ue={};de.fn.extend({show:function(){return m(this,!0)},hide:function(){return m(this)},toggle:function(e){return"boolean"==typeof e?e?this.show():this.hide():this.each(function(){Be(this)?de(this).show():de(this).hide()})}});var ze=/^(?:checkbox|radio)$/i,Xe=/<([a-z][^\/\0>\x20\t\r\n\f]+)/i,Ve=/^$|\/(?:java|ecma)script/i,Ge={option:[1,"<select multiple='multiple'>","</select>"],thead:[1,"<table>","</table>"],col:[2,"<table><colgroup>","</colgroup></table>"],tr:[2,"<table><tbody>","</tbody></table>"],td:[3,"<table><tbody><tr>","</tr></tbody></table>"],_default:[0,"",""]};Ge.optgroup=Ge.option,Ge.tbody=Ge.tfoot=Ge.colgroup=Ge.caption=Ge.thead,Ge.th=Ge.td;var Ye=/<|&#?\w+;/;!function(){var e=te.createDocumentFragment(),t=e.appendChild(te.createElement("div")),n=te.createElement("input");n.setAttribute("type","radio"),n.setAttribute("checked","checked"),n.setAttribute("name","t"),t.appendChild(n),pe.checkClone=t.cloneNode(!0).cloneNode(!0).lastChild.checked,t.innerHTML="<textarea>x</textarea>",pe.noCloneChecked=!!t.cloneNode(!0).lastChild.defaultValue}();var Qe=te.documentElement,Je=/^key/,Ke=/^(?:mouse|pointer|contextmenu|drag|drop)|click/,Ze=/^([^.]*)(?:\.(.+)|)/;de.event={global:{},add:function(e,t,n,r,o){var i,s,a,u,c,l,f,p,h,d,g,m=Fe.get(e);if(m)for(n.handler&&(i=n,n=i.handler,o=i.selector),o&&de.find.matchesSelector(Qe,o),n.guid||(n.guid=de.guid++),(u=m.events)||(u=m.events={}),(s=m.handle)||(s=m.handle=function(t){return"undefined"!=typeof de&&de.event.triggered!==t.type?de.event.dispatch.apply(e,arguments):void 0}),t=(t||"").match(qe)||[""],c=t.length;c--;)a=Ze.exec(t[c])||[],h=g=a[1],d=(a[2]||"").split(".").sort(),h&&(f=de.event.special[h]||{},h=(o?f.delegateType:f.bindType)||h,f=de.event.special[h]||{},l=de.extend({type:h,origType:g,data:r,handler:n,guid:n.guid,selector:o,needsContext:o&&de.expr.match.needsContext.test(o),namespace:d.join(".")},i),(p=u[h])||(p=u[h]=[],p.delegateCount=0,f.setup&&f.setup.call(e,r,d,s)!==!1||e.addEventListener&&e.addEventListener(h,s)),f.add&&(f.add.call(e,l),l.handler.guid||(l.handler.guid=n.guid)),o?p.splice(p.delegateCount++,0,l):p.push(l),de.event.global[h]=!0)},remove:function(e,t,n,r,o){var i,s,a,u,c,l,f,p,h,d,g,m=Fe.hasData(e)&&Fe.get(e);if(m&&(u=m.events)){for(t=(t||"").match(qe)||[""],c=t.length;c--;)if(a=Ze.exec(t[c])||[],h=g=a[1],d=(a[2]||"").split(".").sort(),h){for(f=de.event.special[h]||{},h=(r?f.delegateType:f.bindType)||h,p=u[h]||[],a=a[2]&&new RegExp("(^|\\.)"+d.join("\\.(?:.*\\.|)")+"(\\.|$)"),s=i=p.length;i--;)l=p[i],!o&&g!==l.origType||n&&n.guid!==l.guid||a&&!a.test(l.namespace)||r&&r!==l.selector&&("**"!==r||!l.selector)||(p.splice(i,1),l.selector&&p.delegateCount--,f.remove&&f.remove.call(e,l));s&&!p.length&&(f.teardown&&f.teardown.call(e,d,m.handle)!==!1||de.removeEvent(e,h,m.handle),delete u[h])}else for(h in u)de.event.remove(e,h+t[c],n,r,!0);de.isEmptyObject(u)&&Fe.remove(e,"handle events")}},dispatch:function(e){var t,n,r,o,i,s,a=de.event.fix(e),u=new Array(arguments.length),c=(Fe.get(this,"events")||{})[a.type]||[],l=de.event.special[a.type]||{};for(u[0]=a,t=1;t<arguments.length;t++)u[t]=arguments[t];if(a.delegateTarget=this,!l.preDispatch||l.preDispatch.call(this,a)!==!1){for(s=de.event.handlers.call(this,a,c),t=0;(o=s[t++])&&!a.isPropagationStopped();)for(a.currentTarget=o.elem,n=0;(i=o.handlers[n++])&&!a.isImmediatePropagationStopped();)a.rnamespace&&!a.rnamespace.test(i.namespace)||(a.handleObj=i,a.data=i.data,r=((de.event.special[i.origType]||{}).handle||i.handler).apply(o.elem,u),void 0!==r&&(a.result=r)===!1&&(a.preventDefault(),a.stopPropagation()));return l.postDispatch&&l.postDispatch.call(this,a),a.result}},handlers:function(e,t){var n,r,o,i,s,a=[],u=t.delegateCount,c=e.target;if(u&&c.nodeType&&!("click"===e.type&&e.button>=1))for(;c!==this;c=c.parentNode||this)if(1===c.nodeType&&("click"!==e.type||c.disabled!==!0)){for(i=[],s={},n=0;n<u;n++)r=t[n],o=r.selector+" ",void 0===s[o]&&(s[o]=r.needsContext?de(o,this).index(c)>-1:de.find(o,this,null,[c]).length),s[o]&&i.push(r);i.length&&a.push({elem:c,handlers:i})}return c=this,u<t.length&&a.push({elem:c,handlers:t.slice(u)}),a},addProp:function(e,t){Object.defineProperty(de.Event.prototype,e,{enumerable:!0,configurable:!0,get:de.isFunction(t)?function(){if(this.originalEvent)return t(this.originalEvent)}:function(){if(this.originalEvent)return this.originalEvent[e]},set:function(t){Object.defineProperty(this,e,{enumerable:!0,configurable:!0,writable:!0,value:t})}})},fix:function(e){return e[de.expando]?e:new de.Event(e)},special:{load:{noBubble:!0},focus:{trigger:function(){if(this!==T()&&this.focus)return this.focus(),!1},delegateType:"focusin"},blur:{trigger:function(){if(this===T()&&this.blur)return this.blur(),!1},delegateType:"focusout"},click:{trigger:function(){if("checkbox"===this.type&&this.click&&de.nodeName(this,"input"))return this.click(),!1},_default:function(e){return de.nodeName(e.target,"a")}},beforeunload:{postDispatch:function(e){void 0!==e.result&&e.originalEvent&&(e.originalEvent.returnValue=e.result)}}}},de.removeEvent=function(e,t,n){e.removeEventListener&&e.removeEventListener(t,n)},de.Event=function(e,t){return this instanceof de.Event?(e&&e.type?(this.originalEvent=e,this.type=e.type,this.isDefaultPrevented=e.defaultPrevented||void 0===e.defaultPrevented&&e.returnValue===!1?b:w,this.target=e.target&&3===e.target.nodeType?e.target.parentNode:e.target,this.currentTarget=e.currentTarget,this.relatedTarget=e.relatedTarget):this.type=e,t&&de.extend(this,t),this.timeStamp=e&&e.timeStamp||de.now(),void(this[de.expando]=!0)):new de.Event(e,t)},de.Event.prototype={constructor:de.Event,isDefaultPrevented:w,isPropagationStopped:w,isImmediatePropagationStopped:w,isSimulated:!1,preventDefault:function(){var e=this.originalEvent;this.isDefaultPrevented=b,e&&!this.isSimulated&&e.preventDefault()},stopPropagation:function(){var e=this.originalEvent;this.isPropagationStopped=b,e&&!this.isSimulated&&e.stopPropagation()},stopImmediatePropagation:function(){var e=this.originalEvent;this.isImmediatePropagationStopped=b,e&&!this.isSimulated&&e.stopImmediatePropagation(),this.stopPropagation()}},de.each({altKey:!0,bubbles:!0,cancelable:!0,changedTouches:!0,ctrlKey:!0,detail:!0,eventPhase:!0,metaKey:!0,pageX:!0,pageY:!0,shiftKey:!0,view:!0,char:!0,charCode:!0,key:!0,keyCode:!0,button:!0,buttons:!0,clientX:!0,clientY:!0,offsetX:!0,offsetY:!0,pointerId:!0,pointerType:!0,screenX:!0,screenY:!0,targetTouches:!0,toElement:!0,touches:!0,which:function(e){var t=e.button;return null==e.which&&Je.test(e.type)?null!=e.charCode?e.charCode:e.keyCode:!e.which&&void 0!==t&&Ke.test(e.type)?1&t?1:2&t?3:4&t?2:0:e.which}},de.event.addProp),de.each({mouseenter:"mouseover",mouseleave:"mouseout",pointerenter:"pointerover",pointerleave:"pointerout"},function(e,t){de.event.special[e]={delegateType:t,bindType:t,handle:function(e){var n,r=this,o=e.relatedTarget,i=e.handleObj;return o&&(o===r||de.contains(r,o))||(e.type=i.origType,n=i.handler.apply(this,arguments),e.type=t),n}}}),de.fn.extend({on:function(e,t,n,r){return C(this,e,t,n,r)},one:function(e,t,n,r){return C(this,e,t,n,r,1)},off:function(e,t,n){var r,o;if(e&&e.preventDefault&&e.handleObj)return r=e.handleObj,de(e.delegateTarget).off(r.namespace?r.origType+"."+r.namespace:r.origType,r.selector,r.handler),this;if("object"==typeof e){for(o in e)this.off(o,t,e[o]);return this}return t!==!1&&"function"!=typeof t||(n=t,t=void 0),n===!1&&(n=w),this.each(function(){de.event.remove(this,e,n,t)})}});var et=/<(?!area|br|col|embed|hr|img|input|link|meta|param)(([a-z][^\/\0>\x20\t\r\n\f]*)[^>]*)\/>/gi,tt=/<script|<style|<link/i,nt=/checked\s*(?:[^=]|=\s*.checked.)/i,rt=/^true\/(.*)/,ot=/^\s*<!(?:\[CDATA\[|--)|(?:\]\]|--)>\s*$/g;de.extend({htmlPrefilter:function(e){return e.replace(et,"<$1></$2>")},clone:function(e,t,n){var r,o,i,s,a=e.cloneNode(!0),u=de.contains(e.ownerDocument,e);if(!(pe.noCloneChecked||1!==e.nodeType&&11!==e.nodeType||de.isXMLDoc(e)))for(s=v(a),i=v(e),r=0,o=i.length;r<o;r++)N(i[r],s[r]);if(t)if(n)for(i=i||v(e),s=s||v(a),r=0,o=i.length;r<o;r++)S(i[r],s[r]);else S(e,a);return s=v(a,"script"),s.length>0&&y(s,!u&&v(e,"script")),a},cleanData:function(e){for(var t,n,r,o=de.event.special,i=0;void 0!==(n=e[i]);i++)if(He(n)){if(t=n[Fe.expando]){if(t.events)for(r in t.events)o[r]?de.event.remove(n,r):de.removeEvent(n,r,t.handle);n[Fe.expando]=void 0}n[Re.expando]&&(n[Re.expando]=void 0)}}}),de.fn.extend({detach:function(e){return q(this,e,!0)},remove:function(e){return q(this,e)},text:function(e){return Le(this,function(e){return void 0===e?de.text(this):this.empty().each(function(){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||(this.textContent=e)})},null,e,arguments.length)},append:function(){return A(this,arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=j(this,e);t.appendChild(e)}})},prepend:function(){return A(this,arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=j(this,e);t.insertBefore(e,t.firstChild)}})},before:function(){return A(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this)})},after:function(){return A(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this.nextSibling)})},empty:function(){for(var e,t=0;null!=(e=this[t]);t++)1===e.nodeType&&(de.cleanData(v(e,!1)),e.textContent="");return this},clone:function(e,t){return e=null!=e&&e,t=null==t?e:t,this.map(function(){return de.clone(this,e,t)})},html:function(e){return Le(this,function(e){var t=this[0]||{},n=0,r=this.length;if(void 0===e&&1===t.nodeType)return t.innerHTML;if("string"==typeof e&&!tt.test(e)&&!Ge[(Xe.exec(e)||["",""])[1].toLowerCase()]){e=de.htmlPrefilter(e);try{for(;n<r;n++)t=this[n]||{},1===t.nodeType&&(de.cleanData(v(t,!1)),t.innerHTML=e);t=0}catch(e){}}t&&this.empty().append(e)},null,e,arguments.length)},replaceWith:function(){var e=[];return A(this,arguments,function(t){var n=this.parentNode;de.inArray(this,e)<0&&(de.cleanData(v(this)),n&&n.replaceChild(t,this))},e)}}),de.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(e,t){de.fn[e]=function(e){for(var n,r=[],o=de(e),i=o.length-1,s=0;s<=i;s++)n=s===i?this:this.clone(!0),de(o[s])[t](n),ie.apply(r,n.get());return this.pushStack(r)}});var it=/^margin/,st=new RegExp("^("+Me+")(?!px)[a-z%]+$","i"),at=function(t){var n=t.ownerDocument.defaultView;return n&&n.opener||(n=e),n.getComputedStyle(t)};!function(){function t(){if(a){a.style.cssText="box-sizing:border-box;position:relative;display:block;margin:auto;border:1px;padding:1px;top:1%;width:50%",a.innerHTML="",Qe.appendChild(s);var t=e.getComputedStyle(a);n="1%"!==t.top,i="2px"===t.marginLeft,r="4px"===t.width,a.style.marginRight="50%",o="4px"===t.marginRight,Qe.removeChild(s),a=null}}var n,r,o,i,s=te.createElement("div"),a=te.createElement("div");a.style&&(a.style.backgroundClip="content-box",a.cloneNode(!0).style.backgroundClip="",pe.clearCloneStyle="content-box"===a.style.backgroundClip,s.style.cssText="border:0;width:8px;height:0;top:0;left:-9999px;padding:0;margin-top:1px;position:absolute",s.appendChild(a),de.extend(pe,{pixelPosition:function(){return t(),n},boxSizingReliable:function(){return t(),r},pixelMarginRight:function(){return t(),o},reliableMarginLeft:function(){return t(),i}}))}();var ut=/^(none|table(?!-c[ea]).+)/,ct={position:"absolute",visibility:"hidden",display:"block"},lt={letterSpacing:"0",fontWeight:"400"},ft=["Webkit","Moz","ms"],pt=te.createElement("div").style;de.extend({cssHooks:{opacity:{get:function(e,t){if(t){var n=D(e,"opacity");return""===n?"1":n}}}},cssNumber:{animationIterationCount:!0,columnCount:!0,fillOpacity:!0,flexGrow:!0,flexShrink:!0,fontWeight:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{float:"cssFloat"},style:function(e,t,n,r){if(e&&3!==e.nodeType&&8!==e.nodeType&&e.style){var o,i,s,a=de.camelCase(t),u=e.style;return t=de.cssProps[a]||(de.cssProps[a]=L(a)||a),s=de.cssHooks[t]||de.cssHooks[a],void 0===n?s&&"get"in s&&void 0!==(o=s.get(e,!1,r))?o:u[t]:(i=typeof n,"string"===i&&(o=$e.exec(n))&&o[1]&&(n=d(e,t,o),i="number"),null!=n&&n===n&&("number"===i&&(n+=o&&o[3]||(de.cssNumber[a]?"":"px")),pe.clearCloneStyle||""!==n||0!==t.indexOf("background")||(u[t]="inherit"),s&&"set"in s&&void 0===(n=s.set(e,n,r))||(u[t]=n)),void 0)}},css:function(e,t,n,r){var o,i,s,a=de.camelCase(t);return t=de.cssProps[a]||(de.cssProps[a]=L(a)||a),s=de.cssHooks[t]||de.cssHooks[a],s&&"get"in s&&(o=s.get(e,!0,n)),void 0===o&&(o=D(e,t,r)),"normal"===o&&t in lt&&(o=lt[t]),""===n||n?(i=parseFloat(o),n===!0||isFinite(i)?i||0:o):o}}),de.each(["height","width"],function(e,t){de.cssHooks[t]={get:function(e,n,r){if(n)return!ut.test(de.css(e,"display"))||e.getClientRects().length&&e.getBoundingClientRect().width?R(e,t,r):_e(e,ct,function(){return R(e,t,r)})},set:function(e,n,r){var o,i=r&&at(e),s=r&&F(e,t,r,"border-box"===de.css(e,"boxSizing",!1,i),i);return s&&(o=$e.exec(n))&&"px"!==(o[3]||"px")&&(e.style[t]=n,n=de.css(e,t)),H(e,n,s)}}}),de.cssHooks.marginLeft=O(pe.reliableMarginLeft,function(e,t){if(t)return(parseFloat(D(e,"marginLeft"))||e.getBoundingClientRect().left-_e(e,{marginLeft:0},function(){return e.getBoundingClientRect().left}))+"px"}),de.each({margin:"",padding:"",border:"Width"},function(e,t){de.cssHooks[e+t]={expand:function(n){for(var r=0,o={},i="string"==typeof n?n.split(" "):[n];r<4;r++)o[e+We[r]+t]=i[r]||i[r-2]||i[0];return o}},it.test(e)||(de.cssHooks[e+t].set=H)}),de.fn.extend({css:function(e,t){return Le(this,function(e,t,n){var r,o,i={},s=0;if(de.isArray(t)){for(r=at(e),o=t.length;s<o;s++)i[t[s]]=de.css(e,t[s],!1,r);return i}return void 0!==n?de.style(e,t,n):de.css(e,t)},e,t,arguments.length>1)}}),de.Tween=I,I.prototype={constructor:I,init:function(e,t,n,r,o,i){this.elem=e,this.prop=n,this.easing=o||de.easing._default,this.options=t,this.start=this.now=this.cur(),this.end=r,this.unit=i||(de.cssNumber[n]?"":"px")},cur:function(){var e=I.propHooks[this.prop];return e&&e.get?e.get(this):I.propHooks._default.get(this)},run:function(e){var t,n=I.propHooks[this.prop];return this.options.duration?this.pos=t=de.easing[this.easing](e,this.options.duration*e,0,1,this.options.duration):this.pos=t=e,this.now=(this.end-this.start)*t+this.start,this.options.step&&this.options.step.call(this.elem,this.now,this),n&&n.set?n.set(this):I.propHooks._default.set(this),this}},I.prototype.init.prototype=I.prototype,I.propHooks={_default:{get:function(e){var t;return 1!==e.elem.nodeType||null!=e.elem[e.prop]&&null==e.elem.style[e.prop]?e.elem[e.prop]:(t=de.css(e.elem,e.prop,""),t&&"auto"!==t?t:0)},set:function(e){de.fx.step[e.prop]?de.fx.step[e.prop](e):1!==e.elem.nodeType||null==e.elem.style[de.cssProps[e.prop]]&&!de.cssHooks[e.prop]?e.elem[e.prop]=e.now:de.style(e.elem,e.prop,e.now+e.unit)}}},I.propHooks.scrollTop=I.propHooks.scrollLeft={set:function(e){e.elem.nodeType&&e.elem.parentNode&&(e.elem[e.prop]=e.now)}},de.easing={linear:function(e){return e},swing:function(e){return.5-Math.cos(e*Math.PI)/2},_default:"swing"},de.fx=I.prototype.init,de.fx.step={};var ht,dt,gt=/^(?:toggle|show|hide)$/,mt=/queueHooks$/;de.Animation=de.extend(U,{tweeners:{"*":[function(e,t){var n=this.createTween(e,t);return d(n.elem,e,$e.exec(t),n),n}]},tweener:function(e,t){de.isFunction(e)?(t=e,e=["*"]):e=e.match(qe);for(var n,r=0,o=e.length;r<o;r++)n=e[r],U.tweeners[n]=U.tweeners[n]||[],U.tweeners[n].unshift(t)},prefilters:[B],prefilter:function(e,t){t?U.prefilters.unshift(e):U.prefilters.push(e)}}),de.speed=function(e,t,n){var r=e&&"object"==typeof e?de.extend({},e):{complete:n||!n&&t||de.isFunction(e)&&e,duration:e,easing:n&&t||t&&!de.isFunction(t)&&t};return de.fx.off||te.hidden?r.duration=0:"number"!=typeof r.duration&&(r.duration in de.fx.speeds?r.duration=de.fx.speeds[r.duration]:r.duration=de.fx.speeds._default),null!=r.queue&&r.queue!==!0||(r.queue="fx"),r.old=r.complete,r.complete=function(){de.isFunction(r.old)&&r.old.call(this),r.queue&&de.dequeue(this,r.queue)},r},de.fn.extend({fadeTo:function(e,t,n,r){return this.filter(Be).css("opacity",0).show().end().animate({opacity:t},e,n,r)},animate:function(e,t,n,r){
+var o=de.isEmptyObject(e),i=de.speed(t,n,r),s=function(){var t=U(this,de.extend({},e),i);(o||Fe.get(this,"finish"))&&t.stop(!0)};return s.finish=s,o||i.queue===!1?this.each(s):this.queue(i.queue,s)},stop:function(e,t,n){var r=function(e){var t=e.stop;delete e.stop,t(n)};return"string"!=typeof e&&(n=t,t=e,e=void 0),t&&e!==!1&&this.queue(e||"fx",[]),this.each(function(){var t=!0,o=null!=e&&e+"queueHooks",i=de.timers,s=Fe.get(this);if(o)s[o]&&s[o].stop&&r(s[o]);else for(o in s)s[o]&&s[o].stop&&mt.test(o)&&r(s[o]);for(o=i.length;o--;)i[o].elem!==this||null!=e&&i[o].queue!==e||(i[o].anim.stop(n),t=!1,i.splice(o,1));!t&&n||de.dequeue(this,e)})},finish:function(e){return e!==!1&&(e=e||"fx"),this.each(function(){var t,n=Fe.get(this),r=n[e+"queue"],o=n[e+"queueHooks"],i=de.timers,s=r?r.length:0;for(n.finish=!0,de.queue(this,e,[]),o&&o.stop&&o.stop.call(this,!0),t=i.length;t--;)i[t].elem===this&&i[t].queue===e&&(i[t].anim.stop(!0),i.splice(t,1));for(t=0;t<s;t++)r[t]&&r[t].finish&&r[t].finish.call(this);delete n.finish})}}),de.each(["toggle","show","hide"],function(e,t){var n=de.fn[t];de.fn[t]=function(e,r,o){return null==e||"boolean"==typeof e?n.apply(this,arguments):this.animate($(t,!0),e,r,o)}}),de.each({slideDown:$("show"),slideUp:$("hide"),slideToggle:$("toggle"),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"},fadeToggle:{opacity:"toggle"}},function(e,t){de.fn[e]=function(e,n,r){return this.animate(t,e,n,r)}}),de.timers=[],de.fx.tick=function(){var e,t=0,n=de.timers;for(ht=de.now();t<n.length;t++)e=n[t],e()||n[t]!==e||n.splice(t--,1);n.length||de.fx.stop(),ht=void 0},de.fx.timer=function(e){de.timers.push(e),e()?de.fx.start():de.timers.pop()},de.fx.interval=13,de.fx.start=function(){dt||(dt=e.requestAnimationFrame?e.requestAnimationFrame(P):e.setInterval(de.fx.tick,de.fx.interval))},de.fx.stop=function(){e.cancelAnimationFrame?e.cancelAnimationFrame(dt):e.clearInterval(dt),dt=null},de.fx.speeds={slow:600,fast:200,_default:400},de.fn.delay=function(t,n){return t=de.fx?de.fx.speeds[t]||t:t,n=n||"fx",this.queue(n,function(n,r){var o=e.setTimeout(n,t);r.stop=function(){e.clearTimeout(o)}})},function(){var e=te.createElement("input"),t=te.createElement("select"),n=t.appendChild(te.createElement("option"));e.type="checkbox",pe.checkOn=""!==e.value,pe.optSelected=n.selected,e=te.createElement("input"),e.value="t",e.type="radio",pe.radioValue="t"===e.value}();var vt,yt=de.expr.attrHandle;de.fn.extend({attr:function(e,t){return Le(this,de.attr,e,t,arguments.length>1)},removeAttr:function(e){return this.each(function(){de.removeAttr(this,e)})}}),de.extend({attr:function(e,t,n){var r,o,i=e.nodeType;if(3!==i&&8!==i&&2!==i)return"undefined"==typeof e.getAttribute?de.prop(e,t,n):(1===i&&de.isXMLDoc(e)||(o=de.attrHooks[t.toLowerCase()]||(de.expr.match.bool.test(t)?vt:void 0)),void 0!==n?null===n?void de.removeAttr(e,t):o&&"set"in o&&void 0!==(r=o.set(e,n,t))?r:(e.setAttribute(t,n+""),n):o&&"get"in o&&null!==(r=o.get(e,t))?r:(r=de.find.attr(e,t),null==r?void 0:r))},attrHooks:{type:{set:function(e,t){if(!pe.radioValue&&"radio"===t&&de.nodeName(e,"input")){var n=e.value;return e.setAttribute("type",t),n&&(e.value=n),t}}}},removeAttr:function(e,t){var n,r=0,o=t&&t.match(qe);if(o&&1===e.nodeType)for(;n=o[r++];)e.removeAttribute(n)}}),vt={set:function(e,t,n){return t===!1?de.removeAttr(e,n):e.setAttribute(n,n),n}},de.each(de.expr.match.bool.source.match(/\w+/g),function(e,t){var n=yt[t]||de.find.attr;yt[t]=function(e,t,r){var o,i,s=t.toLowerCase();return r||(i=yt[s],yt[s]=o,o=null!=n(e,t,r)?s:null,yt[s]=i),o}});var xt=/^(?:input|select|textarea|button)$/i,bt=/^(?:a|area)$/i;de.fn.extend({prop:function(e,t){return Le(this,de.prop,e,t,arguments.length>1)},removeProp:function(e){return this.each(function(){delete this[de.propFix[e]||e]})}}),de.extend({prop:function(e,t,n){var r,o,i=e.nodeType;if(3!==i&&8!==i&&2!==i)return 1===i&&de.isXMLDoc(e)||(t=de.propFix[t]||t,o=de.propHooks[t]),void 0!==n?o&&"set"in o&&void 0!==(r=o.set(e,n,t))?r:e[t]=n:o&&"get"in o&&null!==(r=o.get(e,t))?r:e[t]},propHooks:{tabIndex:{get:function(e){var t=de.find.attr(e,"tabindex");return t?parseInt(t,10):xt.test(e.nodeName)||bt.test(e.nodeName)&&e.href?0:-1}}},propFix:{for:"htmlFor",class:"className"}}),pe.optSelected||(de.propHooks.selected={get:function(e){var t=e.parentNode;return t&&t.parentNode&&t.parentNode.selectedIndex,null},set:function(e){var t=e.parentNode;t&&(t.selectedIndex,t.parentNode&&t.parentNode.selectedIndex)}}),de.each(["tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable"],function(){de.propFix[this.toLowerCase()]=this}),de.fn.extend({addClass:function(e){var t,n,r,o,i,s,a,u=0;if(de.isFunction(e))return this.each(function(t){de(this).addClass(e.call(this,t,X(this)))});if("string"==typeof e&&e)for(t=e.match(qe)||[];n=this[u++];)if(o=X(n),r=1===n.nodeType&&" "+z(o)+" "){for(s=0;i=t[s++];)r.indexOf(" "+i+" ")<0&&(r+=i+" ");a=z(r),o!==a&&n.setAttribute("class",a)}return this},removeClass:function(e){var t,n,r,o,i,s,a,u=0;if(de.isFunction(e))return this.each(function(t){de(this).removeClass(e.call(this,t,X(this)))});if(!arguments.length)return this.attr("class","");if("string"==typeof e&&e)for(t=e.match(qe)||[];n=this[u++];)if(o=X(n),r=1===n.nodeType&&" "+z(o)+" "){for(s=0;i=t[s++];)for(;r.indexOf(" "+i+" ")>-1;)r=r.replace(" "+i+" "," ");a=z(r),o!==a&&n.setAttribute("class",a)}return this},toggleClass:function(e,t){var n=typeof e;return"boolean"==typeof t&&"string"===n?t?this.addClass(e):this.removeClass(e):de.isFunction(e)?this.each(function(n){de(this).toggleClass(e.call(this,n,X(this),t),t)}):this.each(function(){var t,r,o,i;if("string"===n)for(r=0,o=de(this),i=e.match(qe)||[];t=i[r++];)o.hasClass(t)?o.removeClass(t):o.addClass(t);else void 0!==e&&"boolean"!==n||(t=X(this),t&&Fe.set(this,"__className__",t),this.setAttribute&&this.setAttribute("class",t||e===!1?"":Fe.get(this,"__className__")||""))})},hasClass:function(e){var t,n,r=0;for(t=" "+e+" ";n=this[r++];)if(1===n.nodeType&&(" "+z(X(n))+" ").indexOf(t)>-1)return!0;return!1}});var wt=/\r/g;de.fn.extend({val:function(e){var t,n,r,o=this[0];{if(arguments.length)return r=de.isFunction(e),this.each(function(n){var o;1===this.nodeType&&(o=r?e.call(this,n,de(this).val()):e,null==o?o="":"number"==typeof o?o+="":de.isArray(o)&&(o=de.map(o,function(e){return null==e?"":e+""})),t=de.valHooks[this.type]||de.valHooks[this.nodeName.toLowerCase()],t&&"set"in t&&void 0!==t.set(this,o,"value")||(this.value=o))});if(o)return t=de.valHooks[o.type]||de.valHooks[o.nodeName.toLowerCase()],t&&"get"in t&&void 0!==(n=t.get(o,"value"))?n:(n=o.value,"string"==typeof n?n.replace(wt,""):null==n?"":n)}}}),de.extend({valHooks:{option:{get:function(e){var t=de.find.attr(e,"value");return null!=t?t:z(de.text(e))}},select:{get:function(e){var t,n,r,o=e.options,i=e.selectedIndex,s="select-one"===e.type,a=s?null:[],u=s?i+1:o.length;for(r=i<0?u:s?i:0;r<u;r++)if(n=o[r],(n.selected||r===i)&&!n.disabled&&(!n.parentNode.disabled||!de.nodeName(n.parentNode,"optgroup"))){if(t=de(n).val(),s)return t;a.push(t)}return a},set:function(e,t){for(var n,r,o=e.options,i=de.makeArray(t),s=o.length;s--;)r=o[s],(r.selected=de.inArray(de.valHooks.option.get(r),i)>-1)&&(n=!0);return n||(e.selectedIndex=-1),i}}}}),de.each(["radio","checkbox"],function(){de.valHooks[this]={set:function(e,t){if(de.isArray(t))return e.checked=de.inArray(de(e).val(),t)>-1}},pe.checkOn||(de.valHooks[this].get=function(e){return null===e.getAttribute("value")?"on":e.value})});var Tt=/^(?:focusinfocus|focusoutblur)$/;de.extend(de.event,{trigger:function(t,n,r,o){var i,s,a,u,c,l,f,p=[r||te],h=ce.call(t,"type")?t.type:t,d=ce.call(t,"namespace")?t.namespace.split("."):[];if(s=a=r=r||te,3!==r.nodeType&&8!==r.nodeType&&!Tt.test(h+de.event.triggered)&&(h.indexOf(".")>-1&&(d=h.split("."),h=d.shift(),d.sort()),c=h.indexOf(":")<0&&"on"+h,t=t[de.expando]?t:new de.Event(h,"object"==typeof t&&t),t.isTrigger=o?2:3,t.namespace=d.join("."),t.rnamespace=t.namespace?new RegExp("(^|\\.)"+d.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,t.result=void 0,t.target||(t.target=r),n=null==n?[t]:de.makeArray(n,[t]),f=de.event.special[h]||{},o||!f.trigger||f.trigger.apply(r,n)!==!1)){if(!o&&!f.noBubble&&!de.isWindow(r)){for(u=f.delegateType||h,Tt.test(u+h)||(s=s.parentNode);s;s=s.parentNode)p.push(s),a=s;a===(r.ownerDocument||te)&&p.push(a.defaultView||a.parentWindow||e)}for(i=0;(s=p[i++])&&!t.isPropagationStopped();)t.type=i>1?u:f.bindType||h,l=(Fe.get(s,"events")||{})[t.type]&&Fe.get(s,"handle"),l&&l.apply(s,n),l=c&&s[c],l&&l.apply&&He(s)&&(t.result=l.apply(s,n),t.result===!1&&t.preventDefault());return t.type=h,o||t.isDefaultPrevented()||f._default&&f._default.apply(p.pop(),n)!==!1||!He(r)||c&&de.isFunction(r[h])&&!de.isWindow(r)&&(a=r[c],a&&(r[c]=null),de.event.triggered=h,r[h](),de.event.triggered=void 0,a&&(r[c]=a)),t.result}},simulate:function(e,t,n){var r=de.extend(new de.Event,n,{type:e,isSimulated:!0});de.event.trigger(r,null,t)}}),de.fn.extend({trigger:function(e,t){return this.each(function(){de.event.trigger(e,t,this)})},triggerHandler:function(e,t){var n=this[0];if(n)return de.event.trigger(e,t,n,!0)}}),de.each("blur focus focusin focusout resize scroll click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup contextmenu".split(" "),function(e,t){de.fn[t]=function(e,n){return arguments.length>0?this.on(t,null,e,n):this.trigger(t)}}),de.fn.extend({hover:function(e,t){return this.mouseenter(e).mouseleave(t||e)}}),pe.focusin="onfocusin"in e,pe.focusin||de.each({focus:"focusin",blur:"focusout"},function(e,t){var n=function(e){de.event.simulate(t,e.target,de.event.fix(e))};de.event.special[t]={setup:function(){var r=this.ownerDocument||this,o=Fe.access(r,t);o||r.addEventListener(e,n,!0),Fe.access(r,t,(o||0)+1)},teardown:function(){var r=this.ownerDocument||this,o=Fe.access(r,t)-1;o?Fe.access(r,t,o):(r.removeEventListener(e,n,!0),Fe.remove(r,t))}}});var Ct=e.location,jt=de.now(),kt=/\?/;de.parseXML=function(t){var n;if(!t||"string"!=typeof t)return null;try{n=(new e.DOMParser).parseFromString(t,"text/xml")}catch(e){n=void 0}return n&&!n.getElementsByTagName("parsererror").length||de.error("Invalid XML: "+t),n};var Et=/\[\]$/,St=/\r?\n/g,Nt=/^(?:submit|button|image|reset|file)$/i,At=/^(?:input|select|textarea|keygen)/i;de.param=function(e,t){var n,r=[],o=function(e,t){var n=de.isFunction(t)?t():t;r[r.length]=encodeURIComponent(e)+"="+encodeURIComponent(null==n?"":n)};if(de.isArray(e)||e.jquery&&!de.isPlainObject(e))de.each(e,function(){o(this.name,this.value)});else for(n in e)V(n,e[n],t,o);return r.join("&")},de.fn.extend({serialize:function(){return de.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var e=de.prop(this,"elements");return e?de.makeArray(e):this}).filter(function(){var e=this.type;return this.name&&!de(this).is(":disabled")&&At.test(this.nodeName)&&!Nt.test(e)&&(this.checked||!ze.test(e))}).map(function(e,t){var n=de(this).val();return null==n?null:de.isArray(n)?de.map(n,function(e){return{name:t.name,value:e.replace(St,"\r\n")}}):{name:t.name,value:n.replace(St,"\r\n")}}).get()}});var qt=/%20/g,Dt=/#.*$/,Ot=/([?&])_=[^&]*/,Lt=/^(.*?):[ \t]*([^\r\n]*)$/gm,Ht=/^(?:about|app|app-storage|.+-extension|file|res|widget):$/,Ft=/^(?:GET|HEAD)$/,Rt=/^\/\//,It={},Pt={},Mt="*/".concat("*"),$t=te.createElement("a");$t.href=Ct.href,de.extend({active:0,lastModified:{},etag:{},ajaxSettings:{url:Ct.href,type:"GET",isLocal:Ht.test(Ct.protocol),global:!0,processData:!0,async:!0,contentType:"application/x-www-form-urlencoded; charset=UTF-8",accepts:{"*":Mt,text:"text/plain",html:"text/html",xml:"application/xml, text/xml",json:"application/json, text/javascript"},contents:{xml:/\bxml\b/,html:/\bhtml/,json:/\bjson\b/},responseFields:{xml:"responseXML",text:"responseText",json:"responseJSON"},converters:{"* text":String,"text html":!0,"text json":JSON.parse,"text xml":de.parseXML},flatOptions:{url:!0,context:!0}},ajaxSetup:function(e,t){return t?Q(Q(e,de.ajaxSettings),t):Q(de.ajaxSettings,e)},ajaxPrefilter:G(It),ajaxTransport:G(Pt),ajax:function(t,n){function r(t,n,r,a){var c,p,h,b,w,T=n;l||(l=!0,u&&e.clearTimeout(u),o=void 0,s=a||"",C.readyState=t>0?4:0,c=t>=200&&t<300||304===t,r&&(b=J(d,C,r)),b=K(d,b,C,c),c?(d.ifModified&&(w=C.getResponseHeader("Last-Modified"),w&&(de.lastModified[i]=w),w=C.getResponseHeader("etag"),w&&(de.etag[i]=w)),204===t||"HEAD"===d.type?T="nocontent":304===t?T="notmodified":(T=b.state,p=b.data,h=b.error,c=!h)):(h=T,!t&&T||(T="error",t<0&&(t=0))),C.status=t,C.statusText=(n||T)+"",c?v.resolveWith(g,[p,T,C]):v.rejectWith(g,[C,T,h]),C.statusCode(x),x=void 0,f&&m.trigger(c?"ajaxSuccess":"ajaxError",[C,d,c?p:h]),y.fireWith(g,[C,T]),f&&(m.trigger("ajaxComplete",[C,d]),--de.active||de.event.trigger("ajaxStop")))}"object"==typeof t&&(n=t,t=void 0),n=n||{};var o,i,s,a,u,c,l,f,p,h,d=de.ajaxSetup({},n),g=d.context||d,m=d.context&&(g.nodeType||g.jquery)?de(g):de.event,v=de.Deferred(),y=de.Callbacks("once memory"),x=d.statusCode||{},b={},w={},T="canceled",C={readyState:0,getResponseHeader:function(e){var t;if(l){if(!a)for(a={};t=Lt.exec(s);)a[t[1].toLowerCase()]=t[2];t=a[e.toLowerCase()]}return null==t?null:t},getAllResponseHeaders:function(){return l?s:null},setRequestHeader:function(e,t){return null==l&&(e=w[e.toLowerCase()]=w[e.toLowerCase()]||e,b[e]=t),this},overrideMimeType:function(e){return null==l&&(d.mimeType=e),this},statusCode:function(e){var t;if(e)if(l)C.always(e[C.status]);else for(t in e)x[t]=[x[t],e[t]];return this},abort:function(e){var t=e||T;return o&&o.abort(t),r(0,t),this}};if(v.promise(C),d.url=((t||d.url||Ct.href)+"").replace(Rt,Ct.protocol+"//"),d.type=n.method||n.type||d.method||d.type,d.dataTypes=(d.dataType||"*").toLowerCase().match(qe)||[""],null==d.crossDomain){c=te.createElement("a");try{c.href=d.url,c.href=c.href,d.crossDomain=$t.protocol+"//"+$t.host!=c.protocol+"//"+c.host}catch(e){d.crossDomain=!0}}if(d.data&&d.processData&&"string"!=typeof d.data&&(d.data=de.param(d.data,d.traditional)),Y(It,d,n,C),l)return C;f=de.event&&d.global,f&&0===de.active++&&de.event.trigger("ajaxStart"),d.type=d.type.toUpperCase(),d.hasContent=!Ft.test(d.type),i=d.url.replace(Dt,""),d.hasContent?d.data&&d.processData&&0===(d.contentType||"").indexOf("application/x-www-form-urlencoded")&&(d.data=d.data.replace(qt,"+")):(h=d.url.slice(i.length),d.data&&(i+=(kt.test(i)?"&":"?")+d.data,delete d.data),d.cache===!1&&(i=i.replace(Ot,"$1"),h=(kt.test(i)?"&":"?")+"_="+jt++ +h),d.url=i+h),d.ifModified&&(de.lastModified[i]&&C.setRequestHeader("If-Modified-Since",de.lastModified[i]),de.etag[i]&&C.setRequestHeader("If-None-Match",de.etag[i])),(d.data&&d.hasContent&&d.contentType!==!1||n.contentType)&&C.setRequestHeader("Content-Type",d.contentType),C.setRequestHeader("Accept",d.dataTypes[0]&&d.accepts[d.dataTypes[0]]?d.accepts[d.dataTypes[0]]+("*"!==d.dataTypes[0]?", "+Mt+"; q=0.01":""):d.accepts["*"]);for(p in d.headers)C.setRequestHeader(p,d.headers[p]);if(d.beforeSend&&(d.beforeSend.call(g,C,d)===!1||l))return C.abort();if(T="abort",y.add(d.complete),C.done(d.success),C.fail(d.error),o=Y(Pt,d,n,C)){if(C.readyState=1,f&&m.trigger("ajaxSend",[C,d]),l)return C;d.async&&d.timeout>0&&(u=e.setTimeout(function(){C.abort("timeout")},d.timeout));try{l=!1,o.send(b,r)}catch(e){if(l)throw e;r(-1,e)}}else r(-1,"No Transport");return C},getJSON:function(e,t,n){return de.get(e,t,n,"json")},getScript:function(e,t){return de.get(e,void 0,t,"script")}}),de.each(["get","post"],function(e,t){de[t]=function(e,n,r,o){return de.isFunction(n)&&(o=o||r,r=n,n=void 0),de.ajax(de.extend({url:e,type:t,dataType:o,data:n,success:r},de.isPlainObject(e)&&e))}}),de._evalUrl=function(e){return de.ajax({url:e,type:"GET",dataType:"script",cache:!0,async:!1,global:!1,throws:!0})},de.fn.extend({wrapAll:function(e){var t;return this[0]&&(de.isFunction(e)&&(e=e.call(this[0])),t=de(e,this[0].ownerDocument).eq(0).clone(!0),this[0].parentNode&&t.insertBefore(this[0]),t.map(function(){for(var e=this;e.firstElementChild;)e=e.firstElementChild;return e}).append(this)),this},wrapInner:function(e){return de.isFunction(e)?this.each(function(t){de(this).wrapInner(e.call(this,t))}):this.each(function(){var t=de(this),n=t.contents();n.length?n.wrapAll(e):t.append(e)})},wrap:function(e){var t=de.isFunction(e);return this.each(function(n){de(this).wrapAll(t?e.call(this,n):e)})},unwrap:function(e){return this.parent(e).not("body").each(function(){de(this).replaceWith(this.childNodes)}),this}}),de.expr.pseudos.hidden=function(e){return!de.expr.pseudos.visible(e)},de.expr.pseudos.visible=function(e){return!!(e.offsetWidth||e.offsetHeight||e.getClientRects().length)},de.ajaxSettings.xhr=function(){try{return new e.XMLHttpRequest}catch(e){}};var Wt={0:200,1223:204},Bt=de.ajaxSettings.xhr();pe.cors=!!Bt&&"withCredentials"in Bt,pe.ajax=Bt=!!Bt,de.ajaxTransport(function(t){var n,r;if(pe.cors||Bt&&!t.crossDomain)return{send:function(o,i){var s,a=t.xhr();if(a.open(t.type,t.url,t.async,t.username,t.password),t.xhrFields)for(s in t.xhrFields)a[s]=t.xhrFields[s];t.mimeType&&a.overrideMimeType&&a.overrideMimeType(t.mimeType),t.crossDomain||o["X-Requested-With"]||(o["X-Requested-With"]="XMLHttpRequest");for(s in o)a.setRequestHeader(s,o[s]);n=function(e){return function(){n&&(n=r=a.onload=a.onerror=a.onabort=a.onreadystatechange=null,"abort"===e?a.abort():"error"===e?"number"!=typeof a.status?i(0,"error"):i(a.status,a.statusText):i(Wt[a.status]||a.status,a.statusText,"text"!==(a.responseType||"text")||"string"!=typeof a.responseText?{binary:a.response}:{text:a.responseText},a.getAllResponseHeaders()))}},a.onload=n(),r=a.onerror=n("error"),void 0!==a.onabort?a.onabort=r:a.onreadystatechange=function(){4===a.readyState&&e.setTimeout(function(){n&&r()})},n=n("abort");try{a.send(t.hasContent&&t.data||null)}catch(e){if(n)throw e}},abort:function(){n&&n()}}}),de.ajaxPrefilter(function(e){e.crossDomain&&(e.contents.script=!1)}),de.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/\b(?:java|ecma)script\b/},converters:{"text script":function(e){return de.globalEval(e),e}}}),de.ajaxPrefilter("script",function(e){void 0===e.cache&&(e.cache=!1),e.crossDomain&&(e.type="GET")}),de.ajaxTransport("script",function(e){if(e.crossDomain){var t,n;return{send:function(r,o){t=de("<script>").prop({charset:e.scriptCharset,src:e.url}).on("load error",n=function(e){t.remove(),n=null,e&&o("error"===e.type?404:200,e.type)}),te.head.appendChild(t[0])},abort:function(){n&&n()}}}});var _t=[],Ut=/(=)\?(?=&|$)|\?\?/;de.ajaxSetup({jsonp:"callback",jsonpCallback:function(){var e=_t.pop()||de.expando+"_"+jt++;return this[e]=!0,e}}),de.ajaxPrefilter("json jsonp",function(t,n,r){var o,i,s,a=t.jsonp!==!1&&(Ut.test(t.url)?"url":"string"==typeof t.data&&0===(t.contentType||"").indexOf("application/x-www-form-urlencoded")&&Ut.test(t.data)&&"data");if(a||"jsonp"===t.dataTypes[0])return o=t.jsonpCallback=de.isFunction(t.jsonpCallback)?t.jsonpCallback():t.jsonpCallback,a?t[a]=t[a].replace(Ut,"$1"+o):t.jsonp!==!1&&(t.url+=(kt.test(t.url)?"&":"?")+t.jsonp+"="+o),t.converters["script json"]=function(){return s||de.error(o+" was not called"),s[0]},t.dataTypes[0]="json",i=e[o],e[o]=function(){s=arguments},r.always(function(){void 0===i?de(e).removeProp(o):e[o]=i,t[o]&&(t.jsonpCallback=n.jsonpCallback,_t.push(o)),s&&de.isFunction(i)&&i(s[0]),s=i=void 0}),"script"}),pe.createHTMLDocument=function(){var e=te.implementation.createHTMLDocument("").body;return e.innerHTML="<form></form><form></form>",2===e.childNodes.length}(),de.parseHTML=function(e,t,n){if("string"!=typeof e)return[];"boolean"==typeof t&&(n=t,t=!1);var r,o,i;return t||(pe.createHTMLDocument?(t=te.implementation.createHTMLDocument(""),r=t.createElement("base"),r.href=te.location.href,t.head.appendChild(r)):t=te),o=Ce.exec(e),i=!n&&[],o?[t.createElement(o[1])]:(o=x([e],t,i),i&&i.length&&de(i).remove(),de.merge([],o.childNodes))},de.fn.load=function(e,t,n){var r,o,i,s=this,a=e.indexOf(" ");return a>-1&&(r=z(e.slice(a)),e=e.slice(0,a)),de.isFunction(t)?(n=t,t=void 0):t&&"object"==typeof t&&(o="POST"),s.length>0&&de.ajax({url:e,type:o||"GET",dataType:"html",data:t}).done(function(e){i=arguments,s.html(r?de("<div>").append(de.parseHTML(e)).find(r):e)}).always(n&&function(e,t){s.each(function(){n.apply(this,i||[e.responseText,t,e])})}),this},de.each(["ajaxStart","ajaxStop","ajaxComplete","ajaxError","ajaxSuccess","ajaxSend"],function(e,t){de.fn[t]=function(e){return this.on(t,e)}}),de.expr.pseudos.animated=function(e){return de.grep(de.timers,function(t){return e===t.elem}).length},de.offset={setOffset:function(e,t,n){var r,o,i,s,a,u,c,l=de.css(e,"position"),f=de(e),p={};"static"===l&&(e.style.position="relative"),a=f.offset(),i=de.css(e,"top"),u=de.css(e,"left"),c=("absolute"===l||"fixed"===l)&&(i+u).indexOf("auto")>-1,c?(r=f.position(),s=r.top,o=r.left):(s=parseFloat(i)||0,o=parseFloat(u)||0),de.isFunction(t)&&(t=t.call(e,n,de.extend({},a))),null!=t.top&&(p.top=t.top-a.top+s),null!=t.left&&(p.left=t.left-a.left+o),"using"in t?t.using.call(e,p):f.css(p)}},de.fn.extend({offset:function(e){if(arguments.length)return void 0===e?this:this.each(function(t){de.offset.setOffset(this,e,t)});var t,n,r,o,i=this[0];if(i)return i.getClientRects().length?(r=i.getBoundingClientRect(),r.width||r.height?(o=i.ownerDocument,n=Z(o),t=o.documentElement,{top:r.top+n.pageYOffset-t.clientTop,left:r.left+n.pageXOffset-t.clientLeft}):r):{top:0,left:0}},position:function(){if(this[0]){var e,t,n=this[0],r={top:0,left:0};return"fixed"===de.css(n,"position")?t=n.getBoundingClientRect():(e=this.offsetParent(),t=this.offset(),de.nodeName(e[0],"html")||(r=e.offset()),r={top:r.top+de.css(e[0],"borderTopWidth",!0),left:r.left+de.css(e[0],"borderLeftWidth",!0)}),{top:t.top-r.top-de.css(n,"marginTop",!0),left:t.left-r.left-de.css(n,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){for(var e=this.offsetParent;e&&"static"===de.css(e,"position");)e=e.offsetParent;return e||Qe})}}),de.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(e,t){var n="pageYOffset"===t;de.fn[e]=function(r){return Le(this,function(e,r,o){var i=Z(e);return void 0===o?i?i[t]:e[r]:void(i?i.scrollTo(n?i.pageXOffset:o,n?o:i.pageYOffset):e[r]=o)},e,r,arguments.length)}}),de.each(["top","left"],function(e,t){de.cssHooks[t]=O(pe.pixelPosition,function(e,n){if(n)return n=D(e,t),st.test(n)?de(e).position()[t]+"px":n})}),de.each({Height:"height",Width:"width"},function(e,t){de.each({padding:"inner"+e,content:t,"":"outer"+e},function(n,r){de.fn[r]=function(o,i){var s=arguments.length&&(n||"boolean"!=typeof o),a=n||(o===!0||i===!0?"margin":"border");return Le(this,function(t,n,o){var i;return de.isWindow(t)?0===r.indexOf("outer")?t["inner"+e]:t.document.documentElement["client"+e]:9===t.nodeType?(i=t.documentElement,Math.max(t.body["scroll"+e],i["scroll"+e],t.body["offset"+e],i["offset"+e],i["client"+e])):void 0===o?de.css(t,n,a):de.style(t,n,o,a)},t,s?o:void 0,s)}})}),de.fn.extend({bind:function(e,t,n){return this.on(e,null,t,n)},unbind:function(e,t){return this.off(e,null,t)},delegate:function(e,t,n,r){return this.on(t,e,n,r)},undelegate:function(e,t,n){return 1===arguments.length?this.off(e,"**"):this.off(t,e||"**",n)}}),de.parseJSON=JSON.parse,"function"==typeof define&&define.amd&&define("jquery",[],function(){return de});var zt=e.jQuery,Xt=e.$;return de.noConflict=function(t){return e.$===de&&(e.$=Xt),t&&e.jQuery===de&&(e.jQuery=zt),de},t||(e.jQuery=e.$=de),de})},{}],2:[function(e,t,n){(function(e){function t(e,t){for(var n=0,r=e.length-1;r>=0;r--){var o=e[r];"."===o?e.splice(r,1):".."===o?(e.splice(r,1),n++):n&&(e.splice(r,1),n--)}if(t)for(;n--;n)e.unshift("..");return e}function r(e,t){if(e.filter)return e.filter(t);for(var n=[],r=0;r<e.length;r++)t(e[r],r,e)&&n.push(e[r]);return n}var o=/^(\/?|)([\s\S]*?)((?:\.{1,2}|[^\/]+?|)(\.[^.\/]*|))(?:[\/]*)$/,i=function(e){return o.exec(e).slice(1)};n.resolve=function(){for(var n="",o=!1,i=arguments.length-1;i>=-1&&!o;i--){var s=i>=0?arguments[i]:e.cwd();if("string"!=typeof s)throw new TypeError("Arguments to path.resolve must be strings");s&&(n=s+"/"+n,o="/"===s.charAt(0))}return n=t(r(n.split("/"),function(e){return!!e}),!o).join("/"),(o?"/":"")+n||"."},n.normalize=function(e){var o=n.isAbsolute(e),i="/"===s(e,-1);return e=t(r(e.split("/"),function(e){return!!e}),!o).join("/"),e||o||(e="."),e&&i&&(e+="/"),(o?"/":"")+e},n.isAbsolute=function(e){return"/"===e.charAt(0)},n.join=function(){var e=Array.prototype.slice.call(arguments,0);return n.normalize(r(e,function(e,t){if("string"!=typeof e)throw new TypeError("Arguments to path.join must be strings");return e}).join("/"))},n.relative=function(e,t){function r(e){for(var t=0;t<e.length&&""===e[t];t++);for(var n=e.length-1;n>=0&&""===e[n];n--);return t>n?[]:e.slice(t,n-t+1)}e=n.resolve(e).substr(1),t=n.resolve(t).substr(1);for(var o=r(e.split("/")),i=r(t.split("/")),s=Math.min(o.length,i.length),a=s,u=0;u<s;u++)if(o[u]!==i[u]){a=u;break}for(var c=[],u=a;u<o.length;u++)c.push("..");return c=c.concat(i.slice(a)),c.join("/")},n.sep="/",n.delimiter=":",n.dirname=function(e){var t=i(e),n=t[0],r=t[1];return n||r?(r&&(r=r.substr(0,r.length-1)),n+r):"."},n.basename=function(e,t){var n=i(e)[2];return t&&n.substr(-1*t.length)===t&&(n=n.substr(0,n.length-t.length)),n},n.extname=function(e){return i(e)[3]};var s="b"==="ab".substr(-1)?function(e,t,n){return e.substr(t,n)}:function(e,t,n){return t<0&&(t=e.length+t),e.substr(t,n)}}).call(this,e("_process"))},{_process:3}],3:[function(e,t,n){function r(){throw new Error("setTimeout has not been defined")}function o(){throw new Error("clearTimeout has not been defined")}function i(e){if(f===setTimeout)return setTimeout(e,0);if((f===r||!f)&&setTimeout)return f=setTimeout,setTimeout(e,0);try{return f(e,0)}catch(t){try{return f.call(null,e,0)}catch(t){return f.call(this,e,0)}}}function s(e){if(p===clearTimeout)return clearTimeout(e);if((p===o||!p)&&clearTimeout)return p=clearTimeout,clearTimeout(e);try{return p(e)}catch(t){try{return p.call(null,e)}catch(t){return p.call(this,e)}}}function a(){m&&d&&(m=!1,d.length?g=d.concat(g):v=-1,g.length&&u())}function u(){if(!m){var e=i(a);m=!0;for(var t=g.length;t;){for(d=g,g=[];++v<t;)d&&d[v].run();v=-1,t=g.length}d=null,m=!1,s(e)}}function c(e,t){this.fun=e,this.array=t}function l(){}var f,p,h=t.exports={};!function(){try{f="function"==typeof setTimeout?setTimeout:r}catch(e){f=r}try{p="function"==typeof clearTimeout?clearTimeout:o}catch(e){p=o}}();var d,g=[],m=!1,v=-1;h.nextTick=function(e){var t=new Array(arguments.length-1);if(arguments.length>1)for(var n=1;n<arguments.length;n++)t[n-1]=arguments[n];g.push(new c(e,t)),1!==g.length||m||i(u)},c.prototype.run=function(){this.fun.apply(null,this.array)},h.title="browser",h.browser=!0,h.env={},h.argv=[],h.version="",h.versions={},h.on=l,h.addListener=l,h.once=l,h.off=l,h.removeListener=l,h.removeAllListeners=l,h.emit=l,h.prependListener=l,h.prependOnceListener=l,h.listeners=function(e){return[]},h.binding=function(e){throw new Error("process.binding is not supported")},h.cwd=function(){return"/"},h.chdir=function(e){throw new Error("process.chdir is not supported")},h.umask=function(){return 0}},{}],4:[function(e,t,n){(function(e){!function(r){function o(e){throw new RangeError(L[e])}function i(e,t){for(var n=e.length,r=[];n--;)r[n]=t(e[n]);return r}function s(e,t){var n=e.split("@"),r="";n.length>1&&(r=n[0]+"@",e=n[1]),e=e.replace(O,".");var o=e.split("."),s=i(o,t).join(".");return r+s}function a(e){for(var t,n,r=[],o=0,i=e.length;o<i;)t=e.charCodeAt(o++),t>=55296&&t<=56319&&o<i?(n=e.charCodeAt(o++),56320==(64512&n)?r.push(((1023&t)<<10)+(1023&n)+65536):(r.push(t),o--)):r.push(t);return r}function u(e){return i(e,function(e){var t="";return e>65535&&(e-=65536,t+=R(e>>>10&1023|55296),e=56320|1023&e),t+=R(e)}).join("")}function c(e){return e-48<10?e-22:e-65<26?e-65:e-97<26?e-97:T}function l(e,t){return e+22+75*(e<26)-((0!=t)<<5)}function f(e,t,n){var r=0;for(e=n?F(e/E):e>>1,e+=F(e/t);e>H*j>>1;r+=T)e=F(e/H);return F(r+(H+1)*e/(e+k))}function p(e){var t,n,r,i,s,a,l,p,h,d,g=[],m=e.length,v=0,y=N,x=S;for(n=e.lastIndexOf(A),n<0&&(n=0),r=0;r<n;++r)e.charCodeAt(r)>=128&&o("not-basic"),g.push(e.charCodeAt(r));for(i=n>0?n+1:0;i<m;){for(s=v,a=1,l=T;i>=m&&o("invalid-input"),p=c(e.charCodeAt(i++)),(p>=T||p>F((w-v)/a))&&o("overflow"),v+=p*a,h=l<=x?C:l>=x+j?j:l-x,!(p<h);l+=T)d=T-h,a>F(w/d)&&o("overflow"),a*=d;t=g.length+1,x=f(v-s,t,0==s),F(v/t)>w-y&&o("overflow"),y+=F(v/t),v%=t,g.splice(v++,0,y)}return u(g)}function h(e){var t,n,r,i,s,u,c,p,h,d,g,m,v,y,x,b=[];for(e=a(e),m=e.length,t=N,n=0,s=S,u=0;u<m;++u)g=e[u],g<128&&b.push(R(g));for(r=i=b.length,i&&b.push(A);r<m;){for(c=w,u=0;u<m;++u)g=e[u],g>=t&&g<c&&(c=g);for(v=r+1,c-t>F((w-n)/v)&&o("overflow"),n+=(c-t)*v,t=c,u=0;u<m;++u)if(g=e[u],g<t&&++n>w&&o("overflow"),g==t){for(p=n,h=T;d=h<=s?C:h>=s+j?j:h-s,!(p<d);h+=T)x=p-d,y=T-d,b.push(R(l(d+x%y,0))),p=F(x/y);b.push(R(l(p,0))),s=f(n,v,r==i),n=0,++r}++n,++t}return b.join("")}function d(e){return s(e,function(e){return q.test(e)?p(e.slice(4).toLowerCase()):e})}function g(e){return s(e,function(e){return D.test(e)?"xn--"+h(e):e})}var m="object"==typeof n&&n&&!n.nodeType&&n,v="object"==typeof t&&t&&!t.nodeType&&t,y="object"==typeof e&&e;y.global!==y&&y.window!==y&&y.self!==y||(r=y);var x,b,w=2147483647,T=36,C=1,j=26,k=38,E=700,S=72,N=128,A="-",q=/^xn--/,D=/[^\x20-\x7E]/,O=/[\x2E\u3002\uFF0E\uFF61]/g,L={overflow:"Overflow: input needs wider integers to process","not-basic":"Illegal input >= 0x80 (not a basic code point)","invalid-input":"Invalid input"},H=T-C,F=Math.floor,R=String.fromCharCode;if(x={version:"1.4.1",ucs2:{decode:a,encode:u},decode:p,encode:h,toASCII:g,toUnicode:d},"function"==typeof define&&"object"==typeof define.amd&&define.amd)define("punycode",function(){return x});else if(m&&v)if(t.exports==m)v.exports=x;else for(b in x)x.hasOwnProperty(b)&&(m[b]=x[b]);else r.punycode=x}(this)}).call(this,"undefined"!=typeof global?global:"undefined"!=typeof self?self:"undefined"!=typeof window?window:{})},{}],5:[function(e,t,n){"use strict";function r(e,t){return Object.prototype.hasOwnProperty.call(e,t)}t.exports=function(e,t,n,i){t=t||"&",n=n||"=";var s={};if("string"!=typeof e||0===e.length)return s;var a=/\+/g;e=e.split(t);var u=1e3;i&&"number"==typeof i.maxKeys&&(u=i.maxKeys);var c=e.length;u>0&&c>u&&(c=u);for(var l=0;l<c;++l){var f,p,h,d,g=e[l].replace(a,"%20"),m=g.indexOf(n);m>=0?(f=g.substr(0,m),p=g.substr(m+1)):(f=g,p=""),h=decodeURIComponent(f),d=decodeURIComponent(p),r(s,h)?o(s[h])?s[h].push(d):s[h]=[s[h],d]:s[h]=d}return s};var o=Array.isArray||function(e){return"[object Array]"===Object.prototype.toString.call(e)}},{}],6:[function(e,t,n){"use strict";function r(e,t){if(e.map)return e.map(t);for(var n=[],r=0;r<e.length;r++)n.push(t(e[r],r));return n}var o=function(e){switch(typeof e){case"string":return e;case"boolean":return e?"true":"false";case"number":return isFinite(e)?e:"";default:return""}};t.exports=function(e,t,n,a){return t=t||"&",n=n||"=",null===e&&(e=void 0),"object"==typeof e?r(s(e),function(s){var a=encodeURIComponent(o(s))+n;return i(e[s])?r(e[s],function(e){return a+encodeURIComponent(o(e))}).join(t):a+encodeURIComponent(o(e[s]))}).join(t):a?encodeURIComponent(o(a))+n+encodeURIComponent(o(e)):""};var i=Array.isArray||function(e){return"[object Array]"===Object.prototype.toString.call(e)},s=Object.keys||function(e){var t=[];for(var n in e)Object.prototype.hasOwnProperty.call(e,n)&&t.push(n);return t}},{}],7:[function(e,t,n){"use strict";n.decode=n.parse=e("./decode"),n.encode=n.stringify=e("./encode")},{"./decode":5,"./encode":6}],8:[function(e,t,n){"use strict";function r(){this.protocol=null,this.slashes=null,this.auth=null,this.host=null,this.port=null,this.hostname=null,this.hash=null,this.search=null,this.query=null,this.pathname=null,this.path=null,this.href=null}function o(e,t,n){
+if(e&&c.isObject(e)&&e instanceof r)return e;var o=new r;return o.parse(e,t,n),o}function i(e){return c.isString(e)&&(e=o(e)),e instanceof r?e.format():r.prototype.format.call(e)}function s(e,t){return o(e,!1,!0).resolve(t)}function a(e,t){return e?o(e,!1,!0).resolveObject(t):t}var u=e("punycode"),c=e("./util");n.parse=o,n.resolve=s,n.resolveObject=a,n.format=i,n.Url=r;var l=/^([a-z0-9.+-]+:)/i,f=/:[0-9]*$/,p=/^(\/\/?(?!\/)[^\?\s]*)(\?[^\s]*)?$/,h=["<",">",'"',"`"," ","\r","\n","\t"],d=["{","}","|","\\","^","`"].concat(h),g=["'"].concat(d),m=["%","/","?",";","#"].concat(g),v=["/","?","#"],y=255,x=/^[+a-z0-9A-Z_-]{0,63}$/,b=/^([+a-z0-9A-Z_-]{0,63})(.*)$/,w={javascript:!0,"javascript:":!0},T={javascript:!0,"javascript:":!0},C={http:!0,https:!0,ftp:!0,gopher:!0,file:!0,"http:":!0,"https:":!0,"ftp:":!0,"gopher:":!0,"file:":!0},j=e("querystring");r.prototype.parse=function(e,t,n){if(!c.isString(e))throw new TypeError("Parameter 'url' must be a string, not "+typeof e);var r=e.indexOf("?"),o=r!==-1&&r<e.indexOf("#")?"?":"#",i=e.split(o),s=/\\/g;i[0]=i[0].replace(s,"/"),e=i.join(o);var a=e;if(a=a.trim(),!n&&1===e.split("#").length){var f=p.exec(a);if(f)return this.path=a,this.href=a,this.pathname=f[1],f[2]?(this.search=f[2],t?this.query=j.parse(this.search.substr(1)):this.query=this.search.substr(1)):t&&(this.search="",this.query={}),this}var h=l.exec(a);if(h){h=h[0];var d=h.toLowerCase();this.protocol=d,a=a.substr(h.length)}if(n||h||a.match(/^\/\/[^@\/]+@[^@\/]+/)){var k="//"===a.substr(0,2);!k||h&&T[h]||(a=a.substr(2),this.slashes=!0)}if(!T[h]&&(k||h&&!C[h])){for(var E=-1,S=0;S<v.length;S++){var N=a.indexOf(v[S]);N!==-1&&(E===-1||N<E)&&(E=N)}var A,q;q=E===-1?a.lastIndexOf("@"):a.lastIndexOf("@",E),q!==-1&&(A=a.slice(0,q),a=a.slice(q+1),this.auth=decodeURIComponent(A)),E=-1;for(var S=0;S<m.length;S++){var N=a.indexOf(m[S]);N!==-1&&(E===-1||N<E)&&(E=N)}E===-1&&(E=a.length),this.host=a.slice(0,E),a=a.slice(E),this.parseHost(),this.hostname=this.hostname||"";var D="["===this.hostname[0]&&"]"===this.hostname[this.hostname.length-1];if(!D)for(var O=this.hostname.split(/\./),S=0,L=O.length;S<L;S++){var H=O[S];if(H&&!H.match(x)){for(var F="",R=0,I=H.length;R<I;R++)F+=H.charCodeAt(R)>127?"x":H[R];if(!F.match(x)){var P=O.slice(0,S),M=O.slice(S+1),$=H.match(b);$&&(P.push($[1]),M.unshift($[2])),M.length&&(a="/"+M.join(".")+a),this.hostname=P.join(".");break}}}this.hostname.length>y?this.hostname="":this.hostname=this.hostname.toLowerCase(),D||(this.hostname=u.toASCII(this.hostname));var W=this.port?":"+this.port:"",B=this.hostname||"";this.host=B+W,this.href+=this.host,D&&(this.hostname=this.hostname.substr(1,this.hostname.length-2),"/"!==a[0]&&(a="/"+a))}if(!w[d])for(var S=0,L=g.length;S<L;S++){var _=g[S];if(a.indexOf(_)!==-1){var U=encodeURIComponent(_);U===_&&(U=escape(_)),a=a.split(_).join(U)}}var z=a.indexOf("#");z!==-1&&(this.hash=a.substr(z),a=a.slice(0,z));var X=a.indexOf("?");if(X!==-1?(this.search=a.substr(X),this.query=a.substr(X+1),t&&(this.query=j.parse(this.query)),a=a.slice(0,X)):t&&(this.search="",this.query={}),a&&(this.pathname=a),C[d]&&this.hostname&&!this.pathname&&(this.pathname="/"),this.pathname||this.search){var W=this.pathname||"",V=this.search||"";this.path=W+V}return this.href=this.format(),this},r.prototype.format=function(){var e=this.auth||"";e&&(e=encodeURIComponent(e),e=e.replace(/%3A/i,":"),e+="@");var t=this.protocol||"",n=this.pathname||"",r=this.hash||"",o=!1,i="";this.host?o=e+this.host:this.hostname&&(o=e+(this.hostname.indexOf(":")===-1?this.hostname:"["+this.hostname+"]"),this.port&&(o+=":"+this.port)),this.query&&c.isObject(this.query)&&Object.keys(this.query).length&&(i=j.stringify(this.query));var s=this.search||i&&"?"+i||"";return t&&":"!==t.substr(-1)&&(t+=":"),this.slashes||(!t||C[t])&&o!==!1?(o="//"+(o||""),n&&"/"!==n.charAt(0)&&(n="/"+n)):o||(o=""),r&&"#"!==r.charAt(0)&&(r="#"+r),s&&"?"!==s.charAt(0)&&(s="?"+s),n=n.replace(/[?#]/g,function(e){return encodeURIComponent(e)}),s=s.replace("#","%23"),t+o+n+s+r},r.prototype.resolve=function(e){return this.resolveObject(o(e,!1,!0)).format()},r.prototype.resolveObject=function(e){if(c.isString(e)){var t=new r;t.parse(e,!1,!0),e=t}for(var n=new r,o=Object.keys(this),i=0;i<o.length;i++){var s=o[i];n[s]=this[s]}if(n.hash=e.hash,""===e.href)return n.href=n.format(),n;if(e.slashes&&!e.protocol){for(var a=Object.keys(e),u=0;u<a.length;u++){var l=a[u];"protocol"!==l&&(n[l]=e[l])}return C[n.protocol]&&n.hostname&&!n.pathname&&(n.path=n.pathname="/"),n.href=n.format(),n}if(e.protocol&&e.protocol!==n.protocol){if(!C[e.protocol]){for(var f=Object.keys(e),p=0;p<f.length;p++){var h=f[p];n[h]=e[h]}return n.href=n.format(),n}if(n.protocol=e.protocol,e.host||T[e.protocol])n.pathname=e.pathname;else{for(var d=(e.pathname||"").split("/");d.length&&!(e.host=d.shift()););e.host||(e.host=""),e.hostname||(e.hostname=""),""!==d[0]&&d.unshift(""),d.length<2&&d.unshift(""),n.pathname=d.join("/")}if(n.search=e.search,n.query=e.query,n.host=e.host||"",n.auth=e.auth,n.hostname=e.hostname||e.host,n.port=e.port,n.pathname||n.search){var g=n.pathname||"",m=n.search||"";n.path=g+m}return n.slashes=n.slashes||e.slashes,n.href=n.format(),n}var v=n.pathname&&"/"===n.pathname.charAt(0),y=e.host||e.pathname&&"/"===e.pathname.charAt(0),x=y||v||n.host&&e.pathname,b=x,w=n.pathname&&n.pathname.split("/")||[],d=e.pathname&&e.pathname.split("/")||[],j=n.protocol&&!C[n.protocol];if(j&&(n.hostname="",n.port=null,n.host&&(""===w[0]?w[0]=n.host:w.unshift(n.host)),n.host="",e.protocol&&(e.hostname=null,e.port=null,e.host&&(""===d[0]?d[0]=e.host:d.unshift(e.host)),e.host=null),x=x&&(""===d[0]||""===w[0])),y)n.host=e.host||""===e.host?e.host:n.host,n.hostname=e.hostname||""===e.hostname?e.hostname:n.hostname,n.search=e.search,n.query=e.query,w=d;else if(d.length)w||(w=[]),w.pop(),w=w.concat(d),n.search=e.search,n.query=e.query;else if(!c.isNullOrUndefined(e.search)){if(j){n.hostname=n.host=w.shift();var k=!!(n.host&&n.host.indexOf("@")>0)&&n.host.split("@");k&&(n.auth=k.shift(),n.host=n.hostname=k.shift())}return n.search=e.search,n.query=e.query,c.isNull(n.pathname)&&c.isNull(n.search)||(n.path=(n.pathname?n.pathname:"")+(n.search?n.search:"")),n.href=n.format(),n}if(!w.length)return n.pathname=null,n.search?n.path="/"+n.search:n.path=null,n.href=n.format(),n;for(var E=w.slice(-1)[0],S=(n.host||e.host||w.length>1)&&("."===E||".."===E)||""===E,N=0,A=w.length;A>=0;A--)E=w[A],"."===E?w.splice(A,1):".."===E?(w.splice(A,1),N++):N&&(w.splice(A,1),N--);if(!x&&!b)for(;N--;N)w.unshift("..");!x||""===w[0]||w[0]&&"/"===w[0].charAt(0)||w.unshift(""),S&&"/"!==w.join("/").substr(-1)&&w.push("");var q=""===w[0]||w[0]&&"/"===w[0].charAt(0);if(j){n.hostname=n.host=q?"":w.length?w.shift():"";var k=!!(n.host&&n.host.indexOf("@")>0)&&n.host.split("@");k&&(n.auth=k.shift(),n.host=n.hostname=k.shift())}return x=x||n.host&&w.length,x&&!q&&w.unshift(""),w.length?n.pathname=w.join("/"):(n.pathname=null,n.path=null),c.isNull(n.pathname)&&c.isNull(n.search)||(n.path=(n.pathname?n.pathname:"")+(n.search?n.search:"")),n.auth=e.auth||n.auth,n.slashes=n.slashes||e.slashes,n.href=n.format(),n},r.prototype.parseHost=function(){var e=this.host,t=f.exec(e);t&&(t=t[0],":"!==t&&(this.port=t.substr(1)),e=e.substr(0,e.length-t.length)),e&&(this.hostname=e)}},{"./util":9,punycode:4,querystring:7}],9:[function(e,t,n){"use strict";t.exports={isString:function(e){return"string"==typeof e},isObject:function(e){return"object"==typeof e&&null!==e},isNull:function(e){return null===e},isNullOrUndefined:function(e){return null==e}}},{}],10:[function(e,t,n){var r=e("jquery");t.exports=r({})},{jquery:1}],11:[function(e,t,n){var r=e("jquery"),o=e("./events"),i=e("./storage"),s=e("./page"),a=!1,u=window.gitbook||[],c={events:o,page:s,state:s.getState(),storage:i,push:function(e){a?e():u.push(e)}},l={gitbook:c,jquery:r};window.gitbook=c,window.$=r,window.jQuery=r,window.require=function(e,t){e=e.map(function(e){if(e=e.toLowerCase(),!l[e])throw new Error("GitBook module "+e+" doesn't exist");return l[e]}),t.apply(null,e)},r(document).ready(function(){a=!0,r.each(u,function(e,t){t()})})},{"./events":10,"./page":12,"./storage":13,jquery:1}],12:[function(e,t,n){function r(e){console.log("page has changed",e),o(e),l||(l=!0,c.trigger("start",e.config.pluginsConfig)),c.trigger("page.change")}function o(e){f.page=e.page,f.file=e.file,f.gitbook=e.gitbook,f.config=e.config,f.basePath=e.basePath,f.book=e.book,f.$book=s(".book"),f.revision=f.gitbook.time,f.level=f.page.level,f.filepath=f.file.path,f.chapterTitle=f.page.title,f.innerLanguage=f.book.language||"",f.root=a.resolve(location.protocol+"//"+location.host,u.dirname(u.resolve(location.pathname.replace(/\/$/,"/index.html"),f.basePath))).replace(/\/?$/,"/"),f.bookRoot=f.innerLanguage?a.resolve(f.root,".."):f.root}function i(){return f}var s=e("jquery"),a=e("url"),u=e("path"),c=e("./events"),l=!1,f={};t.exports={hasChanged:r,setState:o,getState:i}},{"./events":10,jquery:1,path:2,url:8}],13:[function(e,t,n){var r="";t.exports={setBaseKey:function(e){r=e},set:function(e,t){e=r+":"+e;try{localStorage[e]=JSON.stringify(t)}catch(e){}},get:function(e,t){var n;e=r+":"+e;try{n=localStorage[e]}catch(e){}if(void 0===n)return t;try{var o=JSON.parse(n);return null==o?t:o}catch(e){return n||t}},remove:function(e){e=r+":"+e;try{localStorage.removeItem(e)}catch(e){}}}},{}]},{},[11]);
diff --git a/clones/llthw.common-lisp.dev/gitbook/images/apple-touch-icon-precomposed-152.png b/clones/llthw.common-lisp.dev/gitbook/images/apple-touch-icon-precomposed-152.png
new file mode 100644
index 0000000000000000000000000000000000000000..f0adcfd0bbeec43834757908ec281bc024cbe407
GIT binary patch
literal 4817
zcmb_gS5#A7m`wly=}me^5&h`~1VoS?1OzldC_y@*x6q3qy-SfIC{<7?g8WJeC3FSp
zf(Qf%NUzeX%wgtb=3yRYty%f*y(=g8+<Wqsz4v!w^&V+ZQ?OG&AP{OzxawnY&AL3u
zNx_-5jh7ExNbHq#lpv7mWXdzkE8sh?HT<y-1QH+!frLgtASYlbbQuEi7KcDqEg%p%
z@BkL~+y;Gl@B^upmWC?i;_{Q<RGJ1xuDZjGy&w=u#>)c=d6mlwfzXd=swyG;CN}WF
z+Kh)hWZS;C(v?T~iLSkaE9t$s`oy7B#_B=oY>8JD+g-C<N=Kwwf|r+|R>pDF%0cEy
zccJK=$+`ALW{q5~N0^wA!qBg2|5PBH7P6nqXDUz5@SJMmn1yJ&4^5gs7V9Tt*Op9Y
zrchhWhxd~@t*S!{S?81+AU*X%q527h&>~hfVs(i)(gZ6eYSvC6cJVlUm<3Z28YiUw
zf4ZT^TbR-b#-61unAK+o35}1ZG((|U7d%_%|IBV~()jxNZXXBL)eQ>Q=<Djz1_T6H
zNM@gy+tv8v@@nk**!NFlt?SFs_y%vEf!?KEK00z<I&yLERRnpYvY)@dk`R;C$==HL
zpFd&A$+Tx@XR`!?M0MULMh6#{Nb`>x*46^AUcDL|ACD>3%`0qb;(Go1_44xa0}Tz0
znVG<VfGCu`o!#QQHMS9E=j&9Y#K86f&Z~AQNQh!o`AJAg51KlxB#4NK37eY=`ZsC}
zwX`VT$oosq8lX^#B_)EaiR!}()Z&&<j@YCm8Z?X@4SNM0L7AD+v9iVt4h}-a6!LT%
zY`S35(#mfiD^(b(R2a?=6=|TIoCHuAcqCg@D{#v)Mh@8T-@hS8Vwi%0f|$5CWdwqW
zUqFDcvZC4WLx05avyiB$y0I}E;`X&yIXRk{FhQDY;-=s2yk^`EBPm&M1b1=!eopw?
z$6swEzrVSkgNapfbaGM&2~pU@W1~}38KP-_><X^)<}szfNwT%0ZfIrjN=l|;WFeu8
zi*`ax6u{CmGuv$>Q$!u$*0NuHPeS*XwziTxI#jO<3bsv71}e`?qG9}EVzj@0{Svx$
zD@=g;sxq;(vZ$!2-=9vFl=Sq7@o}X3%-XlKn{}8K22U@qq3P*I4J$=+bfve(JDjD9
zs;cNBBO_nHufuh8)XdB{WjOomnlwB-BqZ<L@i^Q>MNgO{)@s&YsZkSV7Lby<)|)BD
z^JFkCF3$aA&*9yu<FF3<T?~tClCp|QN=izYtk+@!y1u99VbI0-q0m472;d_;G<;L$
z-+lVTfc4!{fBcw1+GPT^F8le*7wNO@cG|D~{cnC?+gb<z8I(o}Gk;z1w6U?_RaAU7
zc<hRAh@@3Gf*4hr6%g1-sK@Dmn?1H?m2&R~`aB42z+yf2mi0Lmf>=dFM2dTDq#EKm
zqdKix>%ErrjE!SaSf7HjGRo7#t?u?{TFuNwx|l1@=O_DBNMW>tgVK{HjNoxYAPxKb
z9}VZl>Kq>*A1xOp4~~q4M@5kiFHptxE&v~M+_C$P+glmoW1;}&vDDAS-@?>El#!cD
zrKqS_wt_;T-hKS25gdFU1XusblknA5M}&a^NSUzZ>POz*Qq_l>1MTg^R@JOfD3qL>
z9QQr@4j)78?9vjMo10rssqu#o9|VnXr1Jzq*smJ<$ws(~IBWjMO8%(hX~V93&=DPJ
zco^na!mPW@_Tixh98P|n;VQ7_&!5k(t!XvDu+^d#Dumr*a!N`SBoa9Ti|-_=FpQ6j
zqY!%eF#YArg68HonD<3(^MB~*>BC}T$iL^@r6mvubmSz(z3hz96j>siG-R!<t>iQ`
zT^|g}09<-|3yFxRSz7XeKo5?Nsx^F9ij0Whm6m268XC&F=PPQ4;`-ZS16gwHyNFfg
z2X$GFtR`w|Y62l|uQ083-(A$1W671}q~Yi1-`?pJQxQzF>`GuORuom2wZ)Ob21l<+
zNJzxQ#<q@Cm|o`D+5XR`LPA1WgJM+8&CSTqj@L58o^I-O>sc@CK{*DIMn<5Jfc+R7
zQx?sf-&yEQ2+@p*iNURXY@vCNkh|rE&p|-f+!nuQkAJeIoc5ci&Q*NIZES43ys^Pm
zyB`gfFCs!6&n&`^M-&RW;NJY%*-;J%kQ*yE4j0f!dhi~R<PaRBz_ZnSDw>*>*8TZe
zcG0V#$#o?X5|Y`$0+rwyRSgwhy4kNO0>~OWYU-aCL!tZa1a~?H2FcZhD@0Jc{#?xl
zwsK_v(LIEu);Ig5MnX(_?-7G*`{Fr$+dDhYRry=zI^(OIe@T`$Pfn)DAaIv;G}m!8
zhvl^sNFGyD%1Gs~C#8=FuYISLK&jkk=KpR<<g@sl?d)uKz^89=dOB&oJGtoHJ91D=
zCB!9kzv;Ry0E~XQXLgRS_ab{5yl*gbWc#DT`kc8Oly=M6PJCb9{k47&d_9nxo13m>
z{+BP^oRV!kKbS1ev8o*#GX!<KydMDg03bO0I>XWFX_}}@2a-#?=2t@6O<fb6C3hLW
zjn6+{q^1&yiHSij5`Sdo<ivxO8dJONO}e#MF7&)CZz0Xf%S)blcEPo<ups?0jg*9h
zS5}s-%;;lOP7cS4=SJHq$_AjHqoZSa$<}x^@m9-4$kRFquCI?eHa7O?WbLDb%f!FX
z-NS<e5aTr0{(KWt)9PmzA)GSq5L;W@aPx?dm6ct-Gr`fcif44R-15ArFDN8eRb!)k
znS)lQsG614Tz)SIm_=`fh~daJiYqIN<HbMMs_h53nV6Wyo3uea9&F;{3k&&&7ii;0
zp*7y8=c}V-(I`;`h3VC(U$0)VkKy&KVC>ayGtK(@`*+zBWiZQh|C)%b*iprT`=wY-
z-QBmVdOhmRas&kKN=c=-4nyqwb6blvl1W`uKy?C&AmgOivlnM||NWKTaAvP}H9W|a
zC$|aZ=-k&`a&bv}bIFQ-tBz}oo(5mzkak|am+>!B7-T>0&wO`<Yj#<Ac}HK)-OEH7
z*7+1WYAS9T-eG`1P+`sN?MwSmWH}8t0ldygN7KzT`rjEI86gYOC%DVRBqny=oe3i5
z;o&K>{Zvz<dDmXAoCbM;jeb+_PH3w#EsSRoGjVApA|gUc$y8Mk?`?0pmp^R@8MH0Y
z%}d(b!<4POef!oY(N~wKjQ9&?<#CzA?UxicALX*bYydn;51fb@e~Q3(kq)k43`e3)
ze9jWI1>4haJt5Uz+t~Q*FBeUX45s?x_s0s*bm4~&jyO!c8BL;kczQaMs=9g`2y`-!
zV%I`%rVC9`$NZlvpeBa<*l=TborB!>AjtqchCY1D?i1{cTMhM);dGw-LY?>QZ@mFJ
z{oxH7Zh7?2fa!oW5kszL(2K~w$EBX*fxEF4BO>zL$(S@}t9?-hNMTV?wa0vyz8DV&
zNBoZ;h~d5}eumicl9%b}RM=eekF^tpv|kjYErM|ni}omLxRw@&$4sSdZw4VvSHaRY
zuL=NUnFHV)B^Q^C7rn0)f+rlEM496yfWQIK_{K*>3UO;b7Np^nffVS;tT)PY(>gdf
z939Ok8)MgEl9Ov+jp6Z$!KVkmsImbYW#6%P-(NMrj&(AZE06}70}-LhKU7sj!Jep|
zV@fWa4barwk8mYDBZDT(+`u4`>z)rUA0L#GSs0QxpkZKet<t>7akspswDcyxrOTKC
znPFcOeCo44@wxW{PtFip)zFan)2B~SsO}6AQzSN!gcHrOk^oea52*81zALGzsa2i}
z4~P3$8K_w;L7{X`Hw9{7UWT<3cmbzResK{%{jEadkPmLZoLe3$@^Se#H8r)pQkrKq
zQle9S=5r>`E}j7tU3FQl29Sh>g@y1;r@LSb?c(wodoM)*AEiOu#c)8AxH&gBr`PU0
z99kWrUR3R*kOBt~Wj-(%TCM8uUys_YK4<$qPz1FOd-H}HyLB6gT6OILy>Wb=({!VM
zaW5A=yLg+nAY;h+z7ckDe{Zkj`4vidraV8)A_CQb`L-FzVQp>AwaRh*0kL}e!?$gq
zkkE%`SFc_z*5a067gy$%_X`zkK5E;<h5<=J&&8$Fuukt)zEQylK=^A<Puu$^rR68T
zX>UkLjTZDjyRSkltt5BvUP@Y8I4F)JKjFCLW%L-{$6kzGoYYvD`RsJ71!$Bm#fvj*
zuh2$99TqDfAkfZNYYw4i6<}v)e*tDX{j5wpzEy8p>*~E+edvJe(l;_<Q8-<{Qx<Yi
z^x0>_1hC_COiforNIa*8i;K%Vb7ftfjPrD3HYTkr!L=1Bq@cik&v%m~v-bw7Cu=CQ
zTKnNcis9km+{It1FbiQIIb#zNs2b09dW*H#jKByTBV#y7lyOe8{-L2z`rk`S(TCH4
zv|1U$9^<=a?FCQ)+`s_s`}gnR+S-`9X?lT$sS0a)78Vv^vpTwej4E>xv@xYnYr4FF
zZa_(==FZ$I&u?`Q9V}!%ZNuZa%tTpSU0t&zZ7E80a!3pGV%YB3T|SUMg&eRmjkiKf
zJHdj`772&LA2>S;&mW5WU@-ZWl{7#(05#M-QmQ*NJp3F`3&z{K70ArmTHo)P<?8WB
z9JfLc`ezV$0T4tr_5<qf?&522#)k49@ZzeiyII*PN35#zOG-!q@USP6np7~GRE#aQ
z-yV<H$HLRT{W!E-TwF{QwTBahSxmLrN@nL9mg$?A#O>^O0u~#i*}KOyM&>LD{&_1N
z>#L7IL<|o<#*$sJyHiTV8r|Nit9Tv(^fQp;*eLw<R;%g<Zyys5HYV$WPo+T@q1;gH
zv6K$2K?>{LehKX8VA4(E+25d!&Q3m2(f(EA)a#CA@801OIqv4`3FZG>(|l%@;Mo(p
zZ!ev5xeV~KTzP*6plyI_LbU~R21~mPjg00eK0DQgoXf4QfeFHlT`R<6dEac5fxx1m
zq?EAjVe07ao_}d%9;V7~`THDnJg!r9Ve9M8K)?<6-L!gqrM%_fzz2w9U=h*L0<yCH
zQ{1tKM}MrrfLTk(>(NpJL85NSsA!=|)7m7=`TRp6CS_sf$@{~7yCg(Vpo+rh=B$Qw
z*o?BXvy04qhFx2o0cx@NQ2i~yU@$VMx-LggGmp111^=zf{E^kHmXV&GkHvD}@py4o
zDqw~eu5NA`PEKo~ncr;q@td06K-(%8&;guS3-k{NQ0Aq>jf^mIb91}<`jX`hL<8yv
z-6dglm4byOQ{q0-SsThxk(89wte};cn21KBAE>Ah1HYX9&0SwgR(}pe_s^d!{3-9Y
z7XDKqZ#A>z4cvUpkrMi=sHTQ-baWJu4=}&8BMFQg*Xru(dWc0>4dIVpmXs4S5XHRA
z@qEnj^h``7De#VoN7?1n;}!|(0^r^sj#8jk180of>ygN$-Ua^a*GVibEy<~=)zD}m
zFc-;D+$v*+bCzJG^4p$;ZqBqM1Gga%i1GWLyr$cJ^1%7lf6tCVH`vzbzl%KmcRIyA
zF7*BY8aDU${1micN=iy$`0({dFhIiprC3$f)O65WNwIV3&_Ht+7m=NvofnyzWN#m9
zVtj9dh4S#wzDM*R#b~6nnV@UBAAbtmyh&#C(Ok{IU^Jp}sism1pc~Nk0_XJF?=)Ge
z{sJl#ecGHbHD$JUaFBF*vef@N-g|9KNia?JoNFpP`v)|zq`sc*+27-vzddCqCMLQX
zo7Li(`EJ~}vb!{J6Azn1<4#sqSKB({SyHmIWj~m9m<O!faGt882Tee6P8&PSLK-B+
z?E0^o7rhHUs4<54PPneFhPF1<%CK=XsWUk!%kCtuaFdEJ$6mCww9eyIP=JBnb&UCp
zk)+P7b~S8E19{z`n<2}c2EFBYjXmwz`MGB1S4WtIPlN9kHw}+M0_eLy8*6oXu<^*F
z<h29LLLh$#4U98n{UlcPa;M_}{r3N9%j17+np_Zz<n=4@+_7K=dp<WXYDkQYCB|0H
z+S3+XAd=z|QX=Bgzz`BJIhc$b4EB$>q@1|;<kc5c|6_uSn~j5=|NlPW145_@On_*r
LJyNYyws`&@>^1t~

literal 0
HcmV?d00001

diff --git a/clones/llthw.common-lisp.dev/gitbook/images/favicon.ico b/clones/llthw.common-lisp.dev/gitbook/images/favicon.ico
new file mode 100644
index 0000000000000000000000000000000000000000..9ee99fa211606fdd2dbb112f099ba9d2c5d13a55
GIT binary patch
literal 4286
zcmeH~%S#(k6o)5;Vxa~5pzWd?p$l#41NsldO+fJdCTaz#NVIg}BBF?zAQe}xY^CBx
zrE23MxNJ9-iVC6&Q4u6sLkmhR5-~O*O>+7>*WMwScH$TxbkQ5`+}AnhJ9Fl~q9`W(
z($W-uDq~j_<(8r-8OZ2TGLgAoB#hm-e3%bA{y&qAfW>0DoR^pP2H90oQgS_6JIB>4
zEiJtQ=JVX#+%G7Jb52gqca(OFr5@Lw5qYp~BU_Q*g5#H5Z3#bqpzj^a78VxrG(0lZ
z)zw{Ozq7Nm?;t;ht_ArS?7T#F!{%o#$7mb69>}_2&x!ie{QUe(w9~V)vTmBq=1c6H
zQCt6t9NvN2+S;g~px|e$Pv{FG=3+j?_McY0p`n3BM@MOEYl}F6&)-_*`Tc&{-Q6X(
z+f8=6o!HOVaijH$iVCW&t)-Th7IHWos*Ty%S;3VLEq`fgiK5Y{944R7M^jT%G%zqA
z;)QueY#V+=6ZxVVK!ur7_9#BfF=K3Oj5rp0sjRH*o3#12GFI=nd}*(`x|$Xj7h_GS
z^|Ru4cXt!^K{Z}QMMbo{ysUC%<*fJ|^Miu}a=BdU+~au^3WX$ElxNA8puxdGH4f9$
z)3W>A_}kmtD!;$K|J?ce`}<T=Q$tl%Rn*nh6}K*r6aUG{N%cK=EypJ9`j=}i5{Xb_
zV<YhzV0LkFF%1t7tExu%J3Bk#9dI^@d0k&$PyAjo>G4-rSB1|Wk4K13OiYl~YL#ka
zl+XK?&1MsGdT(z}_`-8rCO!Vz+M3|6tgHx8)~T$llxl|gJv}|t+1aV;@qWxc$)v~U
zJ-E5KnK{(d)Fjs8`1rU~Gt8fxn-jV`e|vj-`Me>HtxS4+9uEeC;vDMh>!XvbKb~`~
zt*zAF-cIxL^Aat}MEp2GO~dH-*Qmuc*VotoIRCZ&#VN!zlI4fPVOm&NAl~Qo&i0Ou
z4iRsTzg{xJ4+H|_^?GS$W`;&aM#$-OQh9l~x);cEPOs#1h`-y=(2%$TY;0_Zb;Ld$
z#n*mUJqG#%xL3aTeYcDxkW>A}{Vargs3F+|_W1tt9)8}FmuuL3g1!$4bW|TsAmhcm
z_QrB0UzV5`4<XY7hBsLb-X#p(udwq8<!fYHBBo?(OW4VP4gMeT3gt(X>{HyG8EwMY
zBmD1p0LESZ&w@F8L2K)@+H4!FYlu@C*y+gkPs?_)cGPtmHWT?$i5w<^EmN}g66%>8
QijuOaDCV$|LbS>3U(n?Tr2qf`

literal 0
HcmV?d00001

diff --git a/clones/llthw.common-lisp.dev/gitbook/style.css b/clones/llthw.common-lisp.dev/gitbook/style.css
new file mode 100644
index 00000000..bc3e4636
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/gitbook/style.css
@@ -0,0 +1,9 @@
+/*! normalize.css v2.1.0 | MIT License | git.io/normalize */article,aside,details,figcaption,figure,footer,header,hgroup,main,nav,section,summary{display:block}audio,canvas,video{display:inline-block}audio:not([controls]){display:none;height:0}[hidden]{display:none}html{font-family:sans-serif;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%}body{margin:0}a:focus{outline:thin dotted}a:active,a:hover{outline:0}h1{font-size:2em;margin:.67em 0}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:700}dfn{font-style:italic}hr{-moz-box-sizing:content-box;box-sizing:content-box;height:0}mark{background:#ff0;color:#000}code,kbd,pre,samp{font-family:monospace,serif;font-size:1em}pre{white-space:pre-wrap}q{quotes:"\201C" "\201D" "\2018" "\2019"}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sup{top:-.5em}sub{bottom:-.25em}img{border:0}svg:not(:root){overflow:hidden}figure{margin:0}fieldset{border:1px solid silver;margin:0 2px;padding:.35em .625em .75em}legend{border:0;padding:0}button,input,select,textarea{font-family:inherit;font-size:100%;margin:0}button,input{line-height:normal}button,select{text-transform:none}button,html input[type=button],input[type=reset],input[type=submit]{-webkit-appearance:button;cursor:pointer}button[disabled],html input[disabled]{cursor:default}input[type=checkbox],input[type=radio]{box-sizing:border-box;padding:0}input[type=search]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}input[type=search]::-webkit-search-cancel-button,input[type=search]::-webkit-search-decoration{-webkit-appearance:none}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}textarea{overflow:auto;vertical-align:top}table{border-collapse:collapse;border-spacing:0}.link-inherit{color:inherit}.link-inherit:focus,.link-inherit:hover{color:inherit}.hidden{display:none}.alert{padding:15px;margin-bottom:20px;color:#444;background:#eee;border-bottom:5px solid #ddd}.alert-success{background:#dff0d8;border-color:#d6e9c6;color:#3c763d}.alert-info{background:#d9edf7;border-color:#bce8f1;color:#31708f}.alert-danger{background:#f2dede;border-color:#ebccd1;color:#a94442}.alert-warning{background:#fcf8e3;border-color:#faebcc;color:#8a6d3b}/*!
+ *  Font Awesome 4.6.3 by @davegandy - http://fontawesome.io - @fontawesome
+ *  License - http://fontawesome.io/license (Font: SIL OFL 1.1, CSS: MIT License)
+ */@font-face{font-family:FontAwesome;src:url(fonts/fontawesome/fontawesome-webfont.eot%3Fv=4.6.3);src:url(fonts/fontawesome/fontawesome-webfont.eot%3F) format('embedded-opentype'),url(fonts/fontawesome/fontawesome-webfont.woff2%3Fv=4.6.3) format('woff2'),url(fonts/fontawesome/fontawesome-webfont.woff%3Fv=4.6.3) format('woff'),url(fonts/fontawesome/fontawesome-webfont.ttf%3Fv=4.6.3) format('truetype'),url(fonts/fontawesome/fontawesome-webfont.svg%3Fv=4.6.3) format('svg');font-weight:400;font-style:normal}.fa{display:inline-block;font:normal normal normal 14px/1 FontAwesome;font-size:inherit;text-rendering:auto;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.fa-lg{font-size:1.33333333em;line-height:.75em;vertical-align:-15%}.fa-2x{font-size:2em}.fa-3x{font-size:3em}.fa-4x{font-size:4em}.fa-5x{font-size:5em}.fa-fw{width:1.28571429em;text-align:center}.fa-ul{padding-left:0;margin-left:2.14285714em;list-style-type:none}.fa-ul>li{position:relative}.fa-li{position:absolute;left:-2.14285714em;width:2.14285714em;top:.14285714em;text-align:center}.fa-li.fa-lg{left:-1.85714286em}.fa-border{padding:.2em .25em .15em;border:solid .08em #eee;border-radius:.1em}.fa-pull-left{float:left}.fa-pull-right{float:right}.fa.fa-pull-left{margin-right:.3em}.fa.fa-pull-right{margin-left:.3em}.pull-right{float:right}.pull-left{float:left}.fa.pull-left{margin-right:.3em}.fa.pull-right{margin-left:.3em}.fa-spin{-webkit-animation:fa-spin 2s infinite linear;animation:fa-spin 2s infinite linear}.fa-pulse{-webkit-animation:fa-spin 1s infinite steps(8);animation:fa-spin 1s infinite steps(8)}@-webkit-keyframes fa-spin{0%{-webkit-transform:rotate(0);transform:rotate(0)}100%{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}@keyframes fa-spin{0%{-webkit-transform:rotate(0);transform:rotate(0)}100%{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}.fa-rotate-90{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=1)";-webkit-transform:rotate(90deg);-ms-transform:rotate(90deg);transform:rotate(90deg)}.fa-rotate-180{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2)";-webkit-transform:rotate(180deg);-ms-transform:rotate(180deg);transform:rotate(180deg)}.fa-rotate-270{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=3)";-webkit-transform:rotate(270deg);-ms-transform:rotate(270deg);transform:rotate(270deg)}.fa-flip-horizontal{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=0, mirror=1)";-webkit-transform:scale(-1,1);-ms-transform:scale(-1,1);transform:scale(-1,1)}.fa-flip-vertical{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2, mirror=1)";-webkit-transform:scale(1,-1);-ms-transform:scale(1,-1);transform:scale(1,-1)}:root .fa-flip-horizontal,:root .fa-flip-vertical,:root .fa-rotate-180,:root .fa-rotate-270,:root .fa-rotate-90{filter:none}.fa-stack{position:relative;display:inline-block;width:2em;height:2em;line-height:2em;vertical-align:middle}.fa-stack-1x,.fa-stack-2x{position:absolute;left:0;width:100%;text-align:center}.fa-stack-1x{line-height:inherit}.fa-stack-2x{font-size:2em}.fa-inverse{color:#fff}.fa-glass:before{content:"\f000"}.fa-music:before{content:"\f001"}.fa-search:before{content:"\f002"}.fa-envelope-o:before{content:"\f003"}.fa-heart:before{content:"\f004"}.fa-star:before{content:"\f005"}.fa-star-o:before{content:"\f006"}.fa-user:before{content:"\f007"}.fa-film:before{content:"\f008"}.fa-th-large:before{content:"\f009"}.fa-th:before{content:"\f00a"}.fa-th-list:before{content:"\f00b"}.fa-check:before{content:"\f00c"}.fa-close:before,.fa-remove:before,.fa-times:before{content:"\f00d"}.fa-search-plus:before{content:"\f00e"}.fa-search-minus:before{content:"\f010"}.fa-power-off:before{content:"\f011"}.fa-signal:before{content:"\f012"}.fa-cog:before,.fa-gear:before{content:"\f013"}.fa-trash-o:before{content:"\f014"}.fa-home:before{content:"\f015"}.fa-file-o:before{content:"\f016"}.fa-clock-o:before{content:"\f017"}.fa-road:before{content:"\f018"}.fa-download:before{content:"\f019"}.fa-arrow-circle-o-down:before{content:"\f01a"}.fa-arrow-circle-o-up:before{content:"\f01b"}.fa-inbox:before{content:"\f01c"}.fa-play-circle-o:before{content:"\f01d"}.fa-repeat:before,.fa-rotate-right:before{content:"\f01e"}.fa-refresh:before{content:"\f021"}.fa-list-alt:before{content:"\f022"}.fa-lock:before{content:"\f023"}.fa-flag:before{content:"\f024"}.fa-headphones:before{content:"\f025"}.fa-volume-off:before{content:"\f026"}.fa-volume-down:before{content:"\f027"}.fa-volume-up:before{content:"\f028"}.fa-qrcode:before{content:"\f029"}.fa-barcode:before{content:"\f02a"}.fa-tag:before{content:"\f02b"}.fa-tags:before{content:"\f02c"}.fa-book:before{content:"\f02d"}.fa-bookmark:before{content:"\f02e"}.fa-print:before{content:"\f02f"}.fa-camera:before{content:"\f030"}.fa-font:before{content:"\f031"}.fa-bold:before{content:"\f032"}.fa-italic:before{content:"\f033"}.fa-text-height:before{content:"\f034"}.fa-text-width:before{content:"\f035"}.fa-align-left:before{content:"\f036"}.fa-align-center:before{content:"\f037"}.fa-align-right:before{content:"\f038"}.fa-align-justify:before{content:"\f039"}.fa-list:before{content:"\f03a"}.fa-dedent:before,.fa-outdent:before{content:"\f03b"}.fa-indent:before{content:"\f03c"}.fa-video-camera:before{content:"\f03d"}.fa-image:before,.fa-photo:before,.fa-picture-o:before{content:"\f03e"}.fa-pencil:before{content:"\f040"}.fa-map-marker:before{content:"\f041"}.fa-adjust:before{content:"\f042"}.fa-tint:before{content:"\f043"}.fa-edit:before,.fa-pencil-square-o:before{content:"\f044"}.fa-share-square-o:before{content:"\f045"}.fa-check-square-o:before{content:"\f046"}.fa-arrows:before{content:"\f047"}.fa-step-backward:before{content:"\f048"}.fa-fast-backward:before{content:"\f049"}.fa-backward:before{content:"\f04a"}.fa-play:before{content:"\f04b"}.fa-pause:before{content:"\f04c"}.fa-stop:before{content:"\f04d"}.fa-forward:before{content:"\f04e"}.fa-fast-forward:before{content:"\f050"}.fa-step-forward:before{content:"\f051"}.fa-eject:before{content:"\f052"}.fa-chevron-left:before{content:"\f053"}.fa-chevron-right:before{content:"\f054"}.fa-plus-circle:before{content:"\f055"}.fa-minus-circle:before{content:"\f056"}.fa-times-circle:before{content:"\f057"}.fa-check-circle:before{content:"\f058"}.fa-question-circle:before{content:"\f059"}.fa-info-circle:before{content:"\f05a"}.fa-crosshairs:before{content:"\f05b"}.fa-times-circle-o:before{content:"\f05c"}.fa-check-circle-o:before{content:"\f05d"}.fa-ban:before{content:"\f05e"}.fa-arrow-left:before{content:"\f060"}.fa-arrow-right:before{content:"\f061"}.fa-arrow-up:before{content:"\f062"}.fa-arrow-down:before{content:"\f063"}.fa-mail-forward:before,.fa-share:before{content:"\f064"}.fa-expand:before{content:"\f065"}.fa-compress:before{content:"\f066"}.fa-plus:before{content:"\f067"}.fa-minus:before{content:"\f068"}.fa-asterisk:before{content:"\f069"}.fa-exclamation-circle:before{content:"\f06a"}.fa-gift:before{content:"\f06b"}.fa-leaf:before{content:"\f06c"}.fa-fire:before{content:"\f06d"}.fa-eye:before{content:"\f06e"}.fa-eye-slash:before{content:"\f070"}.fa-exclamation-triangle:before,.fa-warning:before{content:"\f071"}.fa-plane:before{content:"\f072"}.fa-calendar:before{content:"\f073"}.fa-random:before{content:"\f074"}.fa-comment:before{content:"\f075"}.fa-magnet:before{content:"\f076"}.fa-chevron-up:before{content:"\f077"}.fa-chevron-down:before{content:"\f078"}.fa-retweet:before{content:"\f079"}.fa-shopping-cart:before{content:"\f07a"}.fa-folder:before{content:"\f07b"}.fa-folder-open:before{content:"\f07c"}.fa-arrows-v:before{content:"\f07d"}.fa-arrows-h:before{content:"\f07e"}.fa-bar-chart-o:before,.fa-bar-chart:before{content:"\f080"}.fa-twitter-square:before{content:"\f081"}.fa-facebook-square:before{content:"\f082"}.fa-camera-retro:before{content:"\f083"}.fa-key:before{content:"\f084"}.fa-cogs:before,.fa-gears:before{content:"\f085"}.fa-comments:before{content:"\f086"}.fa-thumbs-o-up:before{content:"\f087"}.fa-thumbs-o-down:before{content:"\f088"}.fa-star-half:before{content:"\f089"}.fa-heart-o:before{content:"\f08a"}.fa-sign-out:before{content:"\f08b"}.fa-linkedin-square:before{content:"\f08c"}.fa-thumb-tack:before{content:"\f08d"}.fa-external-link:before{content:"\f08e"}.fa-sign-in:before{content:"\f090"}.fa-trophy:before{content:"\f091"}.fa-github-square:before{content:"\f092"}.fa-upload:before{content:"\f093"}.fa-lemon-o:before{content:"\f094"}.fa-phone:before{content:"\f095"}.fa-square-o:before{content:"\f096"}.fa-bookmark-o:before{content:"\f097"}.fa-phone-square:before{content:"\f098"}.fa-twitter:before{content:"\f099"}.fa-facebook-f:before,.fa-facebook:before{content:"\f09a"}.fa-github:before{content:"\f09b"}.fa-unlock:before{content:"\f09c"}.fa-credit-card:before{content:"\f09d"}.fa-feed:before,.fa-rss:before{content:"\f09e"}.fa-hdd-o:before{content:"\f0a0"}.fa-bullhorn:before{content:"\f0a1"}.fa-bell:before{content:"\f0f3"}.fa-certificate:before{content:"\f0a3"}.fa-hand-o-right:before{content:"\f0a4"}.fa-hand-o-left:before{content:"\f0a5"}.fa-hand-o-up:before{content:"\f0a6"}.fa-hand-o-down:before{content:"\f0a7"}.fa-arrow-circle-left:before{content:"\f0a8"}.fa-arrow-circle-right:before{content:"\f0a9"}.fa-arrow-circle-up:before{content:"\f0aa"}.fa-arrow-circle-down:before{content:"\f0ab"}.fa-globe:before{content:"\f0ac"}.fa-wrench:before{content:"\f0ad"}.fa-tasks:before{content:"\f0ae"}.fa-filter:before{content:"\f0b0"}.fa-briefcase:before{content:"\f0b1"}.fa-arrows-alt:before{content:"\f0b2"}.fa-group:before,.fa-users:before{content:"\f0c0"}.fa-chain:before,.fa-link:before{content:"\f0c1"}.fa-cloud:before{content:"\f0c2"}.fa-flask:before{content:"\f0c3"}.fa-cut:before,.fa-scissors:before{content:"\f0c4"}.fa-copy:before,.fa-files-o:before{content:"\f0c5"}.fa-paperclip:before{content:"\f0c6"}.fa-floppy-o:before,.fa-save:before{content:"\f0c7"}.fa-square:before{content:"\f0c8"}.fa-bars:before,.fa-navicon:before,.fa-reorder:before{content:"\f0c9"}.fa-list-ul:before{content:"\f0ca"}.fa-list-ol:before{content:"\f0cb"}.fa-strikethrough:before{content:"\f0cc"}.fa-underline:before{content:"\f0cd"}.fa-table:before{content:"\f0ce"}.fa-magic:before{content:"\f0d0"}.fa-truck:before{content:"\f0d1"}.fa-pinterest:before{content:"\f0d2"}.fa-pinterest-square:before{content:"\f0d3"}.fa-google-plus-square:before{content:"\f0d4"}.fa-google-plus:before{content:"\f0d5"}.fa-money:before{content:"\f0d6"}.fa-caret-down:before{content:"\f0d7"}.fa-caret-up:before{content:"\f0d8"}.fa-caret-left:before{content:"\f0d9"}.fa-caret-right:before{content:"\f0da"}.fa-columns:before{content:"\f0db"}.fa-sort:before,.fa-unsorted:before{content:"\f0dc"}.fa-sort-desc:before,.fa-sort-down:before{content:"\f0dd"}.fa-sort-asc:before,.fa-sort-up:before{content:"\f0de"}.fa-envelope:before{content:"\f0e0"}.fa-linkedin:before{content:"\f0e1"}.fa-rotate-left:before,.fa-undo:before{content:"\f0e2"}.fa-gavel:before,.fa-legal:before{content:"\f0e3"}.fa-dashboard:before,.fa-tachometer:before{content:"\f0e4"}.fa-comment-o:before{content:"\f0e5"}.fa-comments-o:before{content:"\f0e6"}.fa-bolt:before,.fa-flash:before{content:"\f0e7"}.fa-sitemap:before{content:"\f0e8"}.fa-umbrella:before{content:"\f0e9"}.fa-clipboard:before,.fa-paste:before{content:"\f0ea"}.fa-lightbulb-o:before{content:"\f0eb"}.fa-exchange:before{content:"\f0ec"}.fa-cloud-download:before{content:"\f0ed"}.fa-cloud-upload:before{content:"\f0ee"}.fa-user-md:before{content:"\f0f0"}.fa-stethoscope:before{content:"\f0f1"}.fa-suitcase:before{content:"\f0f2"}.fa-bell-o:before{content:"\f0a2"}.fa-coffee:before{content:"\f0f4"}.fa-cutlery:before{content:"\f0f5"}.fa-file-text-o:before{content:"\f0f6"}.fa-building-o:before{content:"\f0f7"}.fa-hospital-o:before{content:"\f0f8"}.fa-ambulance:before{content:"\f0f9"}.fa-medkit:before{content:"\f0fa"}.fa-fighter-jet:before{content:"\f0fb"}.fa-beer:before{content:"\f0fc"}.fa-h-square:before{content:"\f0fd"}.fa-plus-square:before{content:"\f0fe"}.fa-angle-double-left:before{content:"\f100"}.fa-angle-double-right:before{content:"\f101"}.fa-angle-double-up:before{content:"\f102"}.fa-angle-double-down:before{content:"\f103"}.fa-angle-left:before{content:"\f104"}.fa-angle-right:before{content:"\f105"}.fa-angle-up:before{content:"\f106"}.fa-angle-down:before{content:"\f107"}.fa-desktop:before{content:"\f108"}.fa-laptop:before{content:"\f109"}.fa-tablet:before{content:"\f10a"}.fa-mobile-phone:before,.fa-mobile:before{content:"\f10b"}.fa-circle-o:before{content:"\f10c"}.fa-quote-left:before{content:"\f10d"}.fa-quote-right:before{content:"\f10e"}.fa-spinner:before{content:"\f110"}.fa-circle:before{content:"\f111"}.fa-mail-reply:before,.fa-reply:before{content:"\f112"}.fa-github-alt:before{content:"\f113"}.fa-folder-o:before{content:"\f114"}.fa-folder-open-o:before{content:"\f115"}.fa-smile-o:before{content:"\f118"}.fa-frown-o:before{content:"\f119"}.fa-meh-o:before{content:"\f11a"}.fa-gamepad:before{content:"\f11b"}.fa-keyboard-o:before{content:"\f11c"}.fa-flag-o:before{content:"\f11d"}.fa-flag-checkered:before{content:"\f11e"}.fa-terminal:before{content:"\f120"}.fa-code:before{content:"\f121"}.fa-mail-reply-all:before,.fa-reply-all:before{content:"\f122"}.fa-star-half-empty:before,.fa-star-half-full:before,.fa-star-half-o:before{content:"\f123"}.fa-location-arrow:before{content:"\f124"}.fa-crop:before{content:"\f125"}.fa-code-fork:before{content:"\f126"}.fa-chain-broken:before,.fa-unlink:before{content:"\f127"}.fa-question:before{content:"\f128"}.fa-info:before{content:"\f129"}.fa-exclamation:before{content:"\f12a"}.fa-superscript:before{content:"\f12b"}.fa-subscript:before{content:"\f12c"}.fa-eraser:before{content:"\f12d"}.fa-puzzle-piece:before{content:"\f12e"}.fa-microphone:before{content:"\f130"}.fa-microphone-slash:before{content:"\f131"}.fa-shield:before{content:"\f132"}.fa-calendar-o:before{content:"\f133"}.fa-fire-extinguisher:before{content:"\f134"}.fa-rocket:before{content:"\f135"}.fa-maxcdn:before{content:"\f136"}.fa-chevron-circle-left:before{content:"\f137"}.fa-chevron-circle-right:before{content:"\f138"}.fa-chevron-circle-up:before{content:"\f139"}.fa-chevron-circle-down:before{content:"\f13a"}.fa-html5:before{content:"\f13b"}.fa-css3:before{content:"\f13c"}.fa-anchor:before{content:"\f13d"}.fa-unlock-alt:before{content:"\f13e"}.fa-bullseye:before{content:"\f140"}.fa-ellipsis-h:before{content:"\f141"}.fa-ellipsis-v:before{content:"\f142"}.fa-rss-square:before{content:"\f143"}.fa-play-circle:before{content:"\f144"}.fa-ticket:before{content:"\f145"}.fa-minus-square:before{content:"\f146"}.fa-minus-square-o:before{content:"\f147"}.fa-level-up:before{content:"\f148"}.fa-level-down:before{content:"\f149"}.fa-check-square:before{content:"\f14a"}.fa-pencil-square:before{content:"\f14b"}.fa-external-link-square:before{content:"\f14c"}.fa-share-square:before{content:"\f14d"}.fa-compass:before{content:"\f14e"}.fa-caret-square-o-down:before,.fa-toggle-down:before{content:"\f150"}.fa-caret-square-o-up:before,.fa-toggle-up:before{content:"\f151"}.fa-caret-square-o-right:before,.fa-toggle-right:before{content:"\f152"}.fa-eur:before,.fa-euro:before{content:"\f153"}.fa-gbp:before{content:"\f154"}.fa-dollar:before,.fa-usd:before{content:"\f155"}.fa-inr:before,.fa-rupee:before{content:"\f156"}.fa-cny:before,.fa-jpy:before,.fa-rmb:before,.fa-yen:before{content:"\f157"}.fa-rouble:before,.fa-rub:before,.fa-ruble:before{content:"\f158"}.fa-krw:before,.fa-won:before{content:"\f159"}.fa-bitcoin:before,.fa-btc:before{content:"\f15a"}.fa-file:before{content:"\f15b"}.fa-file-text:before{content:"\f15c"}.fa-sort-alpha-asc:before{content:"\f15d"}.fa-sort-alpha-desc:before{content:"\f15e"}.fa-sort-amount-asc:before{content:"\f160"}.fa-sort-amount-desc:before{content:"\f161"}.fa-sort-numeric-asc:before{content:"\f162"}.fa-sort-numeric-desc:before{content:"\f163"}.fa-thumbs-up:before{content:"\f164"}.fa-thumbs-down:before{content:"\f165"}.fa-youtube-square:before{content:"\f166"}.fa-youtube:before{content:"\f167"}.fa-xing:before{content:"\f168"}.fa-xing-square:before{content:"\f169"}.fa-youtube-play:before{content:"\f16a"}.fa-dropbox:before{content:"\f16b"}.fa-stack-overflow:before{content:"\f16c"}.fa-instagram:before{content:"\f16d"}.fa-flickr:before{content:"\f16e"}.fa-adn:before{content:"\f170"}.fa-bitbucket:before{content:"\f171"}.fa-bitbucket-square:before{content:"\f172"}.fa-tumblr:before{content:"\f173"}.fa-tumblr-square:before{content:"\f174"}.fa-long-arrow-down:before{content:"\f175"}.fa-long-arrow-up:before{content:"\f176"}.fa-long-arrow-left:before{content:"\f177"}.fa-long-arrow-right:before{content:"\f178"}.fa-apple:before{content:"\f179"}.fa-windows:before{content:"\f17a"}.fa-android:before{content:"\f17b"}.fa-linux:before{content:"\f17c"}.fa-dribbble:before{content:"\f17d"}.fa-skype:before{content:"\f17e"}.fa-foursquare:before{content:"\f180"}.fa-trello:before{content:"\f181"}.fa-female:before{content:"\f182"}.fa-male:before{content:"\f183"}.fa-gittip:before,.fa-gratipay:before{content:"\f184"}.fa-sun-o:before{content:"\f185"}.fa-moon-o:before{content:"\f186"}.fa-archive:before{content:"\f187"}.fa-bug:before{content:"\f188"}.fa-vk:before{content:"\f189"}.fa-weibo:before{content:"\f18a"}.fa-renren:before{content:"\f18b"}.fa-pagelines:before{content:"\f18c"}.fa-stack-exchange:before{content:"\f18d"}.fa-arrow-circle-o-right:before{content:"\f18e"}.fa-arrow-circle-o-left:before{content:"\f190"}.fa-caret-square-o-left:before,.fa-toggle-left:before{content:"\f191"}.fa-dot-circle-o:before{content:"\f192"}.fa-wheelchair:before{content:"\f193"}.fa-vimeo-square:before{content:"\f194"}.fa-try:before,.fa-turkish-lira:before{content:"\f195"}.fa-plus-square-o:before{content:"\f196"}.fa-space-shuttle:before{content:"\f197"}.fa-slack:before{content:"\f198"}.fa-envelope-square:before{content:"\f199"}.fa-wordpress:before{content:"\f19a"}.fa-openid:before{content:"\f19b"}.fa-bank:before,.fa-institution:before,.fa-university:before{content:"\f19c"}.fa-graduation-cap:before,.fa-mortar-board:before{content:"\f19d"}.fa-yahoo:before{content:"\f19e"}.fa-google:before{content:"\f1a0"}.fa-reddit:before{content:"\f1a1"}.fa-reddit-square:before{content:"\f1a2"}.fa-stumbleupon-circle:before{content:"\f1a3"}.fa-stumbleupon:before{content:"\f1a4"}.fa-delicious:before{content:"\f1a5"}.fa-digg:before{content:"\f1a6"}.fa-pied-piper-pp:before{content:"\f1a7"}.fa-pied-piper-alt:before{content:"\f1a8"}.fa-drupal:before{content:"\f1a9"}.fa-joomla:before{content:"\f1aa"}.fa-language:before{content:"\f1ab"}.fa-fax:before{content:"\f1ac"}.fa-building:before{content:"\f1ad"}.fa-child:before{content:"\f1ae"}.fa-paw:before{content:"\f1b0"}.fa-spoon:before{content:"\f1b1"}.fa-cube:before{content:"\f1b2"}.fa-cubes:before{content:"\f1b3"}.fa-behance:before{content:"\f1b4"}.fa-behance-square:before{content:"\f1b5"}.fa-steam:before{content:"\f1b6"}.fa-steam-square:before{content:"\f1b7"}.fa-recycle:before{content:"\f1b8"}.fa-automobile:before,.fa-car:before{content:"\f1b9"}.fa-cab:before,.fa-taxi:before{content:"\f1ba"}.fa-tree:before{content:"\f1bb"}.fa-spotify:before{content:"\f1bc"}.fa-deviantart:before{content:"\f1bd"}.fa-soundcloud:before{content:"\f1be"}.fa-database:before{content:"\f1c0"}.fa-file-pdf-o:before{content:"\f1c1"}.fa-file-word-o:before{content:"\f1c2"}.fa-file-excel-o:before{content:"\f1c3"}.fa-file-powerpoint-o:before{content:"\f1c4"}.fa-file-image-o:before,.fa-file-photo-o:before,.fa-file-picture-o:before{content:"\f1c5"}.fa-file-archive-o:before,.fa-file-zip-o:before{content:"\f1c6"}.fa-file-audio-o:before,.fa-file-sound-o:before{content:"\f1c7"}.fa-file-movie-o:before,.fa-file-video-o:before{content:"\f1c8"}.fa-file-code-o:before{content:"\f1c9"}.fa-vine:before{content:"\f1ca"}.fa-codepen:before{content:"\f1cb"}.fa-jsfiddle:before{content:"\f1cc"}.fa-life-bouy:before,.fa-life-buoy:before,.fa-life-ring:before,.fa-life-saver:before,.fa-support:before{content:"\f1cd"}.fa-circle-o-notch:before{content:"\f1ce"}.fa-ra:before,.fa-rebel:before,.fa-resistance:before{content:"\f1d0"}.fa-empire:before,.fa-ge:before{content:"\f1d1"}.fa-git-square:before{content:"\f1d2"}.fa-git:before{content:"\f1d3"}.fa-hacker-news:before,.fa-y-combinator-square:before,.fa-yc-square:before{content:"\f1d4"}.fa-tencent-weibo:before{content:"\f1d5"}.fa-qq:before{content:"\f1d6"}.fa-wechat:before,.fa-weixin:before{content:"\f1d7"}.fa-paper-plane:before,.fa-send:before{content:"\f1d8"}.fa-paper-plane-o:before,.fa-send-o:before{content:"\f1d9"}.fa-history:before{content:"\f1da"}.fa-circle-thin:before{content:"\f1db"}.fa-header:before{content:"\f1dc"}.fa-paragraph:before{content:"\f1dd"}.fa-sliders:before{content:"\f1de"}.fa-share-alt:before{content:"\f1e0"}.fa-share-alt-square:before{content:"\f1e1"}.fa-bomb:before{content:"\f1e2"}.fa-futbol-o:before,.fa-soccer-ball-o:before{content:"\f1e3"}.fa-tty:before{content:"\f1e4"}.fa-binoculars:before{content:"\f1e5"}.fa-plug:before{content:"\f1e6"}.fa-slideshare:before{content:"\f1e7"}.fa-twitch:before{content:"\f1e8"}.fa-yelp:before{content:"\f1e9"}.fa-newspaper-o:before{content:"\f1ea"}.fa-wifi:before{content:"\f1eb"}.fa-calculator:before{content:"\f1ec"}.fa-paypal:before{content:"\f1ed"}.fa-google-wallet:before{content:"\f1ee"}.fa-cc-visa:before{content:"\f1f0"}.fa-cc-mastercard:before{content:"\f1f1"}.fa-cc-discover:before{content:"\f1f2"}.fa-cc-amex:before{content:"\f1f3"}.fa-cc-paypal:before{content:"\f1f4"}.fa-cc-stripe:before{content:"\f1f5"}.fa-bell-slash:before{content:"\f1f6"}.fa-bell-slash-o:before{content:"\f1f7"}.fa-trash:before{content:"\f1f8"}.fa-copyright:before{content:"\f1f9"}.fa-at:before{content:"\f1fa"}.fa-eyedropper:before{content:"\f1fb"}.fa-paint-brush:before{content:"\f1fc"}.fa-birthday-cake:before{content:"\f1fd"}.fa-area-chart:before{content:"\f1fe"}.fa-pie-chart:before{content:"\f200"}.fa-line-chart:before{content:"\f201"}.fa-lastfm:before{content:"\f202"}.fa-lastfm-square:before{content:"\f203"}.fa-toggle-off:before{content:"\f204"}.fa-toggle-on:before{content:"\f205"}.fa-bicycle:before{content:"\f206"}.fa-bus:before{content:"\f207"}.fa-ioxhost:before{content:"\f208"}.fa-angellist:before{content:"\f209"}.fa-cc:before{content:"\f20a"}.fa-ils:before,.fa-shekel:before,.fa-sheqel:before{content:"\f20b"}.fa-meanpath:before{content:"\f20c"}.fa-buysellads:before{content:"\f20d"}.fa-connectdevelop:before{content:"\f20e"}.fa-dashcube:before{content:"\f210"}.fa-forumbee:before{content:"\f211"}.fa-leanpub:before{content:"\f212"}.fa-sellsy:before{content:"\f213"}.fa-shirtsinbulk:before{content:"\f214"}.fa-simplybuilt:before{content:"\f215"}.fa-skyatlas:before{content:"\f216"}.fa-cart-plus:before{content:"\f217"}.fa-cart-arrow-down:before{content:"\f218"}.fa-diamond:before{content:"\f219"}.fa-ship:before{content:"\f21a"}.fa-user-secret:before{content:"\f21b"}.fa-motorcycle:before{content:"\f21c"}.fa-street-view:before{content:"\f21d"}.fa-heartbeat:before{content:"\f21e"}.fa-venus:before{content:"\f221"}.fa-mars:before{content:"\f222"}.fa-mercury:before{content:"\f223"}.fa-intersex:before,.fa-transgender:before{content:"\f224"}.fa-transgender-alt:before{content:"\f225"}.fa-venus-double:before{content:"\f226"}.fa-mars-double:before{content:"\f227"}.fa-venus-mars:before{content:"\f228"}.fa-mars-stroke:before{content:"\f229"}.fa-mars-stroke-v:before{content:"\f22a"}.fa-mars-stroke-h:before{content:"\f22b"}.fa-neuter:before{content:"\f22c"}.fa-genderless:before{content:"\f22d"}.fa-facebook-official:before{content:"\f230"}.fa-pinterest-p:before{content:"\f231"}.fa-whatsapp:before{content:"\f232"}.fa-server:before{content:"\f233"}.fa-user-plus:before{content:"\f234"}.fa-user-times:before{content:"\f235"}.fa-bed:before,.fa-hotel:before{content:"\f236"}.fa-viacoin:before{content:"\f237"}.fa-train:before{content:"\f238"}.fa-subway:before{content:"\f239"}.fa-medium:before{content:"\f23a"}.fa-y-combinator:before,.fa-yc:before{content:"\f23b"}.fa-optin-monster:before{content:"\f23c"}.fa-opencart:before{content:"\f23d"}.fa-expeditedssl:before{content:"\f23e"}.fa-battery-4:before,.fa-battery-full:before{content:"\f240"}.fa-battery-3:before,.fa-battery-three-quarters:before{content:"\f241"}.fa-battery-2:before,.fa-battery-half:before{content:"\f242"}.fa-battery-1:before,.fa-battery-quarter:before{content:"\f243"}.fa-battery-0:before,.fa-battery-empty:before{content:"\f244"}.fa-mouse-pointer:before{content:"\f245"}.fa-i-cursor:before{content:"\f246"}.fa-object-group:before{content:"\f247"}.fa-object-ungroup:before{content:"\f248"}.fa-sticky-note:before{content:"\f249"}.fa-sticky-note-o:before{content:"\f24a"}.fa-cc-jcb:before{content:"\f24b"}.fa-cc-diners-club:before{content:"\f24c"}.fa-clone:before{content:"\f24d"}.fa-balance-scale:before{content:"\f24e"}.fa-hourglass-o:before{content:"\f250"}.fa-hourglass-1:before,.fa-hourglass-start:before{content:"\f251"}.fa-hourglass-2:before,.fa-hourglass-half:before{content:"\f252"}.fa-hourglass-3:before,.fa-hourglass-end:before{content:"\f253"}.fa-hourglass:before{content:"\f254"}.fa-hand-grab-o:before,.fa-hand-rock-o:before{content:"\f255"}.fa-hand-paper-o:before,.fa-hand-stop-o:before{content:"\f256"}.fa-hand-scissors-o:before{content:"\f257"}.fa-hand-lizard-o:before{content:"\f258"}.fa-hand-spock-o:before{content:"\f259"}.fa-hand-pointer-o:before{content:"\f25a"}.fa-hand-peace-o:before{content:"\f25b"}.fa-trademark:before{content:"\f25c"}.fa-registered:before{content:"\f25d"}.fa-creative-commons:before{content:"\f25e"}.fa-gg:before{content:"\f260"}.fa-gg-circle:before{content:"\f261"}.fa-tripadvisor:before{content:"\f262"}.fa-odnoklassniki:before{content:"\f263"}.fa-odnoklassniki-square:before{content:"\f264"}.fa-get-pocket:before{content:"\f265"}.fa-wikipedia-w:before{content:"\f266"}.fa-safari:before{content:"\f267"}.fa-chrome:before{content:"\f268"}.fa-firefox:before{content:"\f269"}.fa-opera:before{content:"\f26a"}.fa-internet-explorer:before{content:"\f26b"}.fa-television:before,.fa-tv:before{content:"\f26c"}.fa-contao:before{content:"\f26d"}.fa-500px:before{content:"\f26e"}.fa-amazon:before{content:"\f270"}.fa-calendar-plus-o:before{content:"\f271"}.fa-calendar-minus-o:before{content:"\f272"}.fa-calendar-times-o:before{content:"\f273"}.fa-calendar-check-o:before{content:"\f274"}.fa-industry:before{content:"\f275"}.fa-map-pin:before{content:"\f276"}.fa-map-signs:before{content:"\f277"}.fa-map-o:before{content:"\f278"}.fa-map:before{content:"\f279"}.fa-commenting:before{content:"\f27a"}.fa-commenting-o:before{content:"\f27b"}.fa-houzz:before{content:"\f27c"}.fa-vimeo:before{content:"\f27d"}.fa-black-tie:before{content:"\f27e"}.fa-fonticons:before{content:"\f280"}.fa-reddit-alien:before{content:"\f281"}.fa-edge:before{content:"\f282"}.fa-credit-card-alt:before{content:"\f283"}.fa-codiepie:before{content:"\f284"}.fa-modx:before{content:"\f285"}.fa-fort-awesome:before{content:"\f286"}.fa-usb:before{content:"\f287"}.fa-product-hunt:before{content:"\f288"}.fa-mixcloud:before{content:"\f289"}.fa-scribd:before{content:"\f28a"}.fa-pause-circle:before{content:"\f28b"}.fa-pause-circle-o:before{content:"\f28c"}.fa-stop-circle:before{content:"\f28d"}.fa-stop-circle-o:before{content:"\f28e"}.fa-shopping-bag:before{content:"\f290"}.fa-shopping-basket:before{content:"\f291"}.fa-hashtag:before{content:"\f292"}.fa-bluetooth:before{content:"\f293"}.fa-bluetooth-b:before{content:"\f294"}.fa-percent:before{content:"\f295"}.fa-gitlab:before{content:"\f296"}.fa-wpbeginner:before{content:"\f297"}.fa-wpforms:before{content:"\f298"}.fa-envira:before{content:"\f299"}.fa-universal-access:before{content:"\f29a"}.fa-wheelchair-alt:before{content:"\f29b"}.fa-question-circle-o:before{content:"\f29c"}.fa-blind:before{content:"\f29d"}.fa-audio-description:before{content:"\f29e"}.fa-volume-control-phone:before{content:"\f2a0"}.fa-braille:before{content:"\f2a1"}.fa-assistive-listening-systems:before{content:"\f2a2"}.fa-american-sign-language-interpreting:before,.fa-asl-interpreting:before{content:"\f2a3"}.fa-deaf:before,.fa-deafness:before,.fa-hard-of-hearing:before{content:"\f2a4"}.fa-glide:before{content:"\f2a5"}.fa-glide-g:before{content:"\f2a6"}.fa-sign-language:before,.fa-signing:before{content:"\f2a7"}.fa-low-vision:before{content:"\f2a8"}.fa-viadeo:before{content:"\f2a9"}.fa-viadeo-square:before{content:"\f2aa"}.fa-snapchat:before{content:"\f2ab"}.fa-snapchat-ghost:before{content:"\f2ac"}.fa-snapchat-square:before{content:"\f2ad"}.fa-pied-piper:before{content:"\f2ae"}.fa-first-order:before{content:"\f2b0"}.fa-yoast:before{content:"\f2b1"}.fa-themeisle:before{content:"\f2b2"}.fa-google-plus-circle:before,.fa-google-plus-official:before{content:"\f2b3"}.fa-fa:before,.fa-font-awesome:before{content:"\f2b4"}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);border:0}.sr-only-focusable:active,.sr-only-focusable:focus{position:static;width:auto;height:auto;margin:0;overflow:visible;clip:auto}/*!
+ * Preboot v2
+ *
+ * Open sourced under MIT license by @mdo.
+ * Some variables and mixins from Bootstrap (Apache 2 license).
+ */.book-langs-index{width:100%;height:100%;padding:40px 0;margin:0;overflow:auto}@media (max-width:600px){.book-langs-index{padding:0}}.book-langs-index .inner{max-width:600px;width:100%;margin:0 auto;padding:30px;background:#fff;border-radius:3px}.book-langs-index .inner h3{margin:0}.book-langs-index .inner .languages{list-style:none;padding:20px 30px;margin-top:20px;border-top:1px solid #eee}.book-langs-index .inner .languages:after,.book-langs-index .inner .languages:before{content:" ";display:table;line-height:0}.book-langs-index .inner .languages:after{clear:both}.book-langs-index .inner .languages li{width:50%;float:left;padding:10px 5px;font-size:16px}@media (max-width:600px){.book-langs-index .inner .languages li{width:100%;max-width:100%}}.book-header{font-family:"Helvetica Neue",Helvetica,Arial,sans-serif;overflow:visible;height:50px;padding:0 8px;z-index:2;font-size:.85em;color:#7e888b;background:0 0}.book-header .btn{display:block;height:50px;padding:0 15px;border-bottom:none;color:#ccc;text-transform:uppercase;line-height:50px;-webkit-box-shadow:none!important;box-shadow:none!important;position:relative;font-size:14px}.book-header .btn:hover{position:relative;text-decoration:none;color:#444;background:0 0}.book-header .btn:focus{outline:0}.book-header h1{margin:0;font-size:20px;font-weight:200;text-align:center;line-height:50px;opacity:0;-webkit-transition:opacity ease .4s;-moz-transition:opacity ease .4s;-o-transition:opacity ease .4s;transition:opacity ease .4s;padding-left:200px;padding-right:200px;-webkit-transition:opacity .2s ease;-moz-transition:opacity .2s ease;-o-transition:opacity .2s ease;transition:opacity .2s ease;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.book-header h1 a,.book-header h1 a:hover{color:inherit;text-decoration:none}@media (max-width:1000px){.book-header h1{display:none}}.book-header h1 i{display:none}.book-header:hover h1{opacity:1}.book.is-loading .book-header h1 i{display:inline-block}.book.is-loading .book-header h1 a{display:none}.dropdown{position:relative}.dropdown-menu{position:absolute;top:100%;left:0;z-index:100;display:none;float:left;min-width:160px;padding:0;margin:2px 0 0;list-style:none;font-size:14px;background-color:#fafafa;border:1px solid rgba(0,0,0,.07);border-radius:1px;-webkit-box-shadow:0 6px 12px rgba(0,0,0,.175);box-shadow:0 6px 12px rgba(0,0,0,.175);background-clip:padding-box}.dropdown-menu.open{display:block}.dropdown-menu.dropdown-left{left:auto;right:4%}.dropdown-menu.dropdown-left .dropdown-caret{right:14px;left:auto}.dropdown-menu .dropdown-caret{position:absolute;top:-8px;left:14px;width:18px;height:10px;float:left;overflow:hidden}.dropdown-menu .dropdown-caret .caret-outer{position:absolute;border-left:9px solid transparent;border-right:9px solid transparent;border-bottom:9px solid rgba(0,0,0,.1);height:auto;left:0;top:0;width:auto;display:inline-block;margin-left:-1px}.dropdown-menu .dropdown-caret .caret-inner{position:absolute;display:inline-block;margin-top:-1px;top:0;top:1px;border-left:9px solid transparent;border-right:9px solid transparent;border-bottom:9px solid #fafafa}.dropdown-menu .buttons{border-bottom:1px solid rgba(0,0,0,.07)}.dropdown-menu .buttons:after,.dropdown-menu .buttons:before{content:" ";display:table;line-height:0}.dropdown-menu .buttons:after{clear:both}.dropdown-menu .buttons:last-child{border-bottom:none}.dropdown-menu .buttons .button{border:0;background-color:transparent;color:#a6a6a6;width:100%;text-align:center;float:left;line-height:1.42857143;padding:8px 4px}.dropdown-menu .buttons .button:hover{color:#444}.dropdown-menu .buttons .button:focus,.dropdown-menu .buttons .button:hover{outline:0}.dropdown-menu .buttons .button.size-2{width:50%}.dropdown-menu .buttons .button.size-3{width:33%}.book-summary{font-family:"Helvetica Neue",Helvetica,Arial,sans-serif;position:absolute;top:0;left:-300px;bottom:0;z-index:1;overflow-y:auto;width:300px;color:#364149;background:#fafafa;border-right:1px solid rgba(0,0,0,.07);-webkit-transition:left 250ms ease;-moz-transition:left 250ms ease;-o-transition:left 250ms ease;transition:left 250ms ease}.book-summary ul.summary{list-style:none;margin:0;padding:0;-webkit-transition:top .5s ease;-moz-transition:top .5s ease;-o-transition:top .5s ease;transition:top .5s ease}.book-summary ul.summary li{list-style:none}.book-summary ul.summary li.header{padding:10px 15px;padding-top:20px;text-transform:uppercase;color:#939da3}.book-summary ul.summary li.divider{height:1px;margin:7px 0;overflow:hidden;background:rgba(0,0,0,.07)}.book-summary ul.summary li i.fa-check{display:none;position:absolute;right:9px;top:16px;font-size:9px;color:#3c3}.book-summary ul.summary li.done>a{color:#364149;font-weight:400}.book-summary ul.summary li.done>a i{display:inline}.book-summary ul.summary li a,.book-summary ul.summary li span{display:block;padding:10px 15px;border-bottom:none;color:#364149;background:0 0;text-overflow:ellipsis;overflow:hidden;white-space:nowrap;position:relative}.book-summary ul.summary li a:hover{text-decoration:underline}.book-summary ul.summary li a:focus{outline:0}.book-summary ul.summary li.active>a{color:#008cff;background:0 0;text-decoration:none}.book-summary ul.summary li ul{padding-left:20px}@media (max-width:600px){.book-summary{width:calc(100% - 60px);bottom:0;left:-100%}}.book.with-summary .book-summary{left:0}.book.without-animation .book-summary{-webkit-transition:none!important;-moz-transition:none!important;-o-transition:none!important;transition:none!important}.book{position:relative;width:100%;height:100%}@media (min-width:600px){.book.with-summary .book-body{left:300px}}@media (max-width:600px){.book.with-summary{overflow:hidden}.book.with-summary .book-body{-webkit-transform:translate(calc(100% - 60px),0);-moz-transform:translate(calc(100% - 60px),0);-ms-transform:translate(calc(100% - 60px),0);-o-transform:translate(calc(100% - 60px),0);transform:translate(calc(100% - 60px),0)}}.book.without-animation .book-body{-webkit-transition:none!important;-moz-transition:none!important;-o-transition:none!important;transition:none!important}.book-body{position:absolute;top:0;right:0;left:0;bottom:0;overflow-y:auto;color:#000;background:#fff;-webkit-transition:left 250ms ease;-moz-transition:left 250ms ease;-o-transition:left 250ms ease;transition:left 250ms ease}.book-body .body-inner{position:absolute;top:0;right:0;left:0;bottom:0;overflow-y:auto}@media (max-width:1240px){.book-body{-webkit-transition:-webkit-transform 250ms ease;-moz-transition:-moz-transform 250ms ease;-o-transition:-o-transform 250ms ease;transition:transform 250ms ease;padding-bottom:20px}.book-body .body-inner{position:static;min-height:calc(100% - 50px)}}.page-wrapper{position:relative;outline:0}.page-inner{position:relative;max-width:800px;margin:0 auto;padding:20px 15px 40px 15px}.page-inner .btn-group .btn{border-radius:0;background:#eee;border:0}.buttons:after,.buttons:before{content:" ";display:table;line-height:0}.buttons:after{clear:both}.button{border:0;background-color:transparent;background:#eee;color:#666;width:100%;text-align:center;float:left;line-height:1.42857143;padding:8px 4px}.button:hover{color:#444}.button:focus,.button:hover{outline:0}.button.size-2{width:50%}.button.size-3{width:33%}.markdown-section{display:block;word-wrap:break-word;overflow:hidden;color:#333;line-height:1.7;text-size-adjust:100%;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%;-moz-text-size-adjust:100%}.markdown-section *{box-sizing:border-box;-webkit-box-sizing:border-box;font-size:inherit}.markdown-section>:first-child{margin-top:0!important}.markdown-section>:last-child{margin-bottom:0!important}.markdown-section blockquote,.markdown-section code,.markdown-section figure,.markdown-section img,.markdown-section pre,.markdown-section table,.markdown-section tr{page-break-inside:avoid}.markdown-section h2,.markdown-section h3,.markdown-section h4,.markdown-section h5,.markdown-section p{orphans:3;widows:3}.markdown-section h1,.markdown-section h2,.markdown-section h3,.markdown-section h4,.markdown-section h5{page-break-after:avoid}.markdown-section b,.markdown-section strong{font-weight:700}.markdown-section em{font-style:italic}.markdown-section blockquote,.markdown-section dl,.markdown-section ol,.markdown-section p,.markdown-section table,.markdown-section ul{margin-top:0;margin-bottom:.85em}.markdown-section a{color:#4183c4;text-decoration:none;background:0 0}.markdown-section a:active,.markdown-section a:focus,.markdown-section a:hover{outline:0;text-decoration:underline}.markdown-section img{border:0;max-width:100%}.markdown-section hr{height:4px;padding:0;margin:1.7em 0;overflow:hidden;background-color:#e7e7e7;border:none}.markdown-section hr:after,.markdown-section hr:before{display:table;content:" "}.markdown-section hr:after{clear:both}.markdown-section h1,.markdown-section h2,.markdown-section h3,.markdown-section h4,.markdown-section h5,.markdown-section h6{margin-top:1.275em;margin-bottom:.85em;font-weight:700}.markdown-section h1{font-size:2em}.markdown-section h2{font-size:1.75em}.markdown-section h3{font-size:1.5em}.markdown-section h4{font-size:1.25em}.markdown-section h5{font-size:1em}.markdown-section h6{font-size:1em;color:#777}.markdown-section code,.markdown-section pre{font-family:Consolas,"Liberation Mono",Menlo,Courier,monospace;direction:ltr;margin:0;padding:0;border:none;color:inherit}.markdown-section pre{overflow:auto;word-wrap:normal;margin:0;padding:.85em 1em;margin-bottom:1.275em;background:#f7f7f7}.markdown-section pre>code{display:inline;max-width:initial;padding:0;margin:0;overflow:initial;line-height:inherit;font-size:.85em;white-space:pre;background:0 0}.markdown-section pre>code:after,.markdown-section pre>code:before{content:normal}.markdown-section code{padding:.2em;margin:0;font-size:.85em;background-color:#f7f7f7}.markdown-section code:after,.markdown-section code:before{letter-spacing:-.2em;content:"\00a0"}.markdown-section table{display:table;width:100%;border-collapse:collapse;border-spacing:0;overflow:auto}.markdown-section table td,.markdown-section table th{padding:6px 13px;border:1px solid #ddd}.markdown-section table tr{background-color:#fff;border-top:1px solid #ccc}.markdown-section table tr:nth-child(2n){background-color:#f8f8f8}.markdown-section table th{font-weight:700}.markdown-section ol,.markdown-section ul{padding:0;margin:0;margin-bottom:.85em;padding-left:2em}.markdown-section ol ol,.markdown-section ol ul,.markdown-section ul ol,.markdown-section ul ul{margin-top:0;margin-bottom:0}.markdown-section ol ol{list-style-type:lower-roman}.markdown-section blockquote{margin:0;margin-bottom:.85em;padding:0 15px;color:#858585;border-left:4px solid #e5e5e5}.markdown-section blockquote:first-child{margin-top:0}.markdown-section blockquote:last-child{margin-bottom:0}.markdown-section dl{padding:0}.markdown-section dl dt{padding:0;margin-top:.85em;font-style:italic;font-weight:700}.markdown-section dl dd{padding:0 .85em;margin-bottom:.85em}.markdown-section dd{margin-left:0}.markdown-section .glossary-term{cursor:help;text-decoration:underline}.navigation{position:absolute;top:50px;bottom:0;margin:0;max-width:150px;min-width:90px;display:flex;justify-content:center;align-content:center;flex-direction:column;font-size:40px;color:#ccc;text-align:center;-webkit-transition:all 350ms ease;-moz-transition:all 350ms ease;-o-transition:all 350ms ease;transition:all 350ms ease}.navigation:hover{text-decoration:none;color:#444}.navigation.navigation-next{right:0}.navigation.navigation-prev{left:0}@media (max-width:1240px){.navigation{position:static;top:auto;max-width:50%;width:50%;display:inline-block;float:left}.navigation.navigation-unique{max-width:100%;width:100%}}#book-search-input{padding:6px;background:0 0;transition:top .5s ease;background:#fff;border-bottom:1px solid rgba(0,0,0,.07);border-top:1px solid rgba(0,0,0,.07);margin-bottom:10px;margin-top:-1px}#book-search-input input,#book-search-input input:focus,#book-search-input input:hover{width:100%;background:0 0;border:1px solid transparent;box-shadow:none;outline:0;line-height:22px;padding:7px 7px;color:inherit}#book-search-results{opacity:1}#book-search-results .search-results .search-results-title{text-transform:uppercase;text-align:center;font-weight:200;margin-bottom:35px;opacity:.6}#book-search-results .search-results .has-results .search-results-item{display:block;word-wrap:break-word;overflow:hidden;color:#333;line-height:1.7;text-size-adjust:100%;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%;-moz-text-size-adjust:100%}#book-search-results .search-results .has-results .search-results-item *{box-sizing:border-box;-webkit-box-sizing:border-box;font-size:inherit}#book-search-results .search-results .has-results .search-results-item>:first-child{margin-top:0!important}#book-search-results .search-results .has-results .search-results-item>:last-child{margin-bottom:0!important}#book-search-results .search-results .has-results .search-results-item blockquote,#book-search-results .search-results .has-results .search-results-item code,#book-search-results .search-results .has-results .search-results-item figure,#book-search-results .search-results .has-results .search-results-item img,#book-search-results .search-results .has-results .search-results-item pre,#book-search-results .search-results .has-results .search-results-item table,#book-search-results .search-results .has-results .search-results-item tr{page-break-inside:avoid}#book-search-results .search-results .has-results .search-results-item h2,#book-search-results .search-results .has-results .search-results-item h3,#book-search-results .search-results .has-results .search-results-item h4,#book-search-results .search-results .has-results .search-results-item h5,#book-search-results .search-results .has-results .search-results-item p{orphans:3;widows:3}#book-search-results .search-results .has-results .search-results-item h1,#book-search-results .search-results .has-results .search-results-item h2,#book-search-results .search-results .has-results .search-results-item h3,#book-search-results .search-results .has-results .search-results-item h4,#book-search-results .search-results .has-results .search-results-item h5{page-break-after:avoid}#book-search-results .search-results .has-results .search-results-item b,#book-search-results .search-results .has-results .search-results-item strong{font-weight:700}#book-search-results .search-results .has-results .search-results-item em{font-style:italic}#book-search-results .search-results .has-results .search-results-item blockquote,#book-search-results .search-results .has-results .search-results-item dl,#book-search-results .search-results .has-results .search-results-item ol,#book-search-results .search-results .has-results .search-results-item p,#book-search-results .search-results .has-results .search-results-item table,#book-search-results .search-results .has-results .search-results-item ul{margin-top:0;margin-bottom:.85em}#book-search-results .search-results .has-results .search-results-item a{color:#4183c4;text-decoration:none;background:0 0}#book-search-results .search-results .has-results .search-results-item a:active,#book-search-results .search-results .has-results .search-results-item a:focus,#book-search-results .search-results .has-results .search-results-item a:hover{outline:0;text-decoration:underline}#book-search-results .search-results .has-results .search-results-item img{border:0;max-width:100%}#book-search-results .search-results .has-results .search-results-item hr{height:4px;padding:0;margin:1.7em 0;overflow:hidden;background-color:#e7e7e7;border:none}#book-search-results .search-results .has-results .search-results-item hr:after,#book-search-results .search-results .has-results .search-results-item hr:before{display:table;content:" "}#book-search-results .search-results .has-results .search-results-item hr:after{clear:both}#book-search-results .search-results .has-results .search-results-item h1,#book-search-results .search-results .has-results .search-results-item h2,#book-search-results .search-results .has-results .search-results-item h3,#book-search-results .search-results .has-results .search-results-item h4,#book-search-results .search-results .has-results .search-results-item h5,#book-search-results .search-results .has-results .search-results-item h6{margin-top:1.275em;margin-bottom:.85em;font-weight:700}#book-search-results .search-results .has-results .search-results-item h1{font-size:2em}#book-search-results .search-results .has-results .search-results-item h2{font-size:1.75em}#book-search-results .search-results .has-results .search-results-item h3{font-size:1.5em}#book-search-results .search-results .has-results .search-results-item h4{font-size:1.25em}#book-search-results .search-results .has-results .search-results-item h5{font-size:1em}#book-search-results .search-results .has-results .search-results-item h6{font-size:1em;color:#777}#book-search-results .search-results .has-results .search-results-item code,#book-search-results .search-results .has-results .search-results-item pre{font-family:Consolas,"Liberation Mono",Menlo,Courier,monospace;direction:ltr;margin:0;padding:0;border:none;color:inherit}#book-search-results .search-results .has-results .search-results-item pre{overflow:auto;word-wrap:normal;margin:0;padding:.85em 1em;margin-bottom:1.275em;background:#f7f7f7}#book-search-results .search-results .has-results .search-results-item pre>code{display:inline;max-width:initial;padding:0;margin:0;overflow:initial;line-height:inherit;font-size:.85em;white-space:pre;background:0 0}#book-search-results .search-results .has-results .search-results-item pre>code:after,#book-search-results .search-results .has-results .search-results-item pre>code:before{content:normal}#book-search-results .search-results .has-results .search-results-item code{padding:.2em;margin:0;font-size:.85em;background-color:#f7f7f7}#book-search-results .search-results .has-results .search-results-item code:after,#book-search-results .search-results .has-results .search-results-item code:before{letter-spacing:-.2em;content:"\00a0"}#book-search-results .search-results .has-results .search-results-item table{display:table;width:100%;border-collapse:collapse;border-spacing:0;overflow:auto}#book-search-results .search-results .has-results .search-results-item table td,#book-search-results .search-results .has-results .search-results-item table th{padding:6px 13px;border:1px solid #ddd}#book-search-results .search-results .has-results .search-results-item table tr{background-color:#fff;border-top:1px solid #ccc}#book-search-results .search-results .has-results .search-results-item table tr:nth-child(2n){background-color:#f8f8f8}#book-search-results .search-results .has-results .search-results-item table th{font-weight:700}#book-search-results .search-results .has-results .search-results-item ol,#book-search-results .search-results .has-results .search-results-item ul{padding:0;margin:0;margin-bottom:.85em;padding-left:2em}#book-search-results .search-results .has-results .search-results-item ol ol,#book-search-results .search-results .has-results .search-results-item ol ul,#book-search-results .search-results .has-results .search-results-item ul ol,#book-search-results .search-results .has-results .search-results-item ul ul{margin-top:0;margin-bottom:0}#book-search-results .search-results .has-results .search-results-item ol ol{list-style-type:lower-roman}#book-search-results .search-results .has-results .search-results-item blockquote{margin:0;margin-bottom:.85em;padding:0 15px;color:#858585;border-left:4px solid #e5e5e5}#book-search-results .search-results .has-results .search-results-item blockquote:first-child{margin-top:0}#book-search-results .search-results .has-results .search-results-item blockquote:last-child{margin-bottom:0}#book-search-results .search-results .has-results .search-results-item dl{padding:0}#book-search-results .search-results .has-results .search-results-item dl dt{padding:0;margin-top:.85em;font-style:italic;font-weight:700}#book-search-results .search-results .has-results .search-results-item dl dd{padding:0 .85em;margin-bottom:.85em}#book-search-results .search-results .has-results .search-results-item dd{margin-left:0}#book-search-results .search-results .has-results .search-results-item h3{margin-top:0;margin-bottom:0}#book-search-results .search-results .no-results{padding:40px 0}body.search-loading #book-search-results{opacity:.3}body.with-search .navigation{display:none}*{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box;-webkit-overflow-scrolling:touch;-webkit-tap-highlight-color:transparent;-webkit-text-size-adjust:none;-webkit-touch-callout:none;-webkit-font-smoothing:antialiased}a{text-decoration:none}body,html{height:100%}html{font-size:62.5%}body{text-rendering:optimizeLegibility;font-smoothing:antialiased;font-family:"Helvetica Neue",Helvetica,Arial,sans-serif;font-size:14px;letter-spacing:.2px;text-size-adjust:100%;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}
\ No newline at end of file
diff --git a/clones/llthw.common-lisp.dev/gitbook/theme.js b/clones/llthw.common-lisp.dev/gitbook/theme.js
new file mode 100644
index 00000000..268002af
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/gitbook/theme.js
@@ -0,0 +1,4 @@
+!function e(t,n,r){function o(a,s){if(!n[a]){if(!t[a]){var u="function"==typeof require&&require;if(!s&&u)return u(a,!0);if(i)return i(a,!0);var l=new Error("Cannot find module '"+a+"'");throw l.code="MODULE_NOT_FOUND",l}var c=n[a]={exports:{}};t[a][0].call(c.exports,function(e){var n=t[a][1][e];return o(n?n:e)},c,c.exports,e,t,n,r)}return n[a].exports}for(var i="function"==typeof require&&require,a=0;a<r.length;a++)o(r[a]);return o}({1:[function(e,t,n){!function(e,n){"use strict";"object"==typeof t&&"object"==typeof t.exports?t.exports=e.document?n(e,!0):function(e){if(!e.document)throw new Error("jQuery requires a window with a document");return n(e)}:n(e)}("undefined"!=typeof window?window:this,function(e,t){"use strict";function n(e,t){t=t||te;var n=t.createElement("script");n.text=e,t.head.appendChild(n).parentNode.removeChild(n)}function r(e){var t=!!e&&"length"in e&&e.length,n=de.type(e);return"function"!==n&&!de.isWindow(e)&&("array"===n||0===t||"number"==typeof t&&t>0&&t-1 in e)}function o(e,t,n){return de.isFunction(t)?de.grep(e,function(e,r){return!!t.call(e,r,e)!==n}):t.nodeType?de.grep(e,function(e){return e===t!==n}):"string"!=typeof t?de.grep(e,function(e){return ae.call(t,e)>-1!==n}):ke.test(t)?de.filter(t,e,n):(t=de.filter(t,e),de.grep(e,function(e){return ae.call(t,e)>-1!==n&&1===e.nodeType}))}function i(e,t){for(;(e=e[t])&&1!==e.nodeType;);return e}function a(e){var t={};return de.each(e.match(qe)||[],function(e,n){t[n]=!0}),t}function s(e){return e}function u(e){throw e}function l(e,t,n){var r;try{e&&de.isFunction(r=e.promise)?r.call(e).done(t).fail(n):e&&de.isFunction(r=e.then)?r.call(e,t,n):t.call(void 0,e)}catch(e){n.call(void 0,e)}}function c(){te.removeEventListener("DOMContentLoaded",c),e.removeEventListener("load",c),de.ready()}function f(){this.expando=de.expando+f.uid++}function p(e){return"true"===e||"false"!==e&&("null"===e?null:e===+e+""?+e:Ie.test(e)?JSON.parse(e):e)}function h(e,t,n){var r;if(void 0===n&&1===e.nodeType)if(r="data-"+t.replace(Re,"-$&").toLowerCase(),n=e.getAttribute(r),"string"==typeof n){try{n=p(n)}catch(e){}Pe.set(e,t,n)}else n=void 0;return n}function d(e,t,n,r){var o,i=1,a=20,s=r?function(){return r.cur()}:function(){return de.css(e,t,"")},u=s(),l=n&&n[3]||(de.cssNumber[t]?"":"px"),c=(de.cssNumber[t]||"px"!==l&&+u)&&$e.exec(de.css(e,t));if(c&&c[3]!==l){l=l||c[3],n=n||[],c=+u||1;do i=i||".5",c/=i,de.style(e,t,c+l);while(i!==(i=s()/u)&&1!==i&&--a)}return n&&(c=+c||+u||0,o=n[1]?c+(n[1]+1)*n[2]:+n[2],r&&(r.unit=l,r.start=c,r.end=o)),o}function g(e){var t,n=e.ownerDocument,r=e.nodeName,o=Ue[r];return o?o:(t=n.body.appendChild(n.createElement(r)),o=de.css(t,"display"),t.parentNode.removeChild(t),"none"===o&&(o="block"),Ue[r]=o,o)}function m(e,t){for(var n,r,o=[],i=0,a=e.length;i<a;i++)r=e[i],r.style&&(n=r.style.display,t?("none"===n&&(o[i]=Fe.get(r,"display")||null,o[i]||(r.style.display="")),""===r.style.display&&We(r)&&(o[i]=g(r))):"none"!==n&&(o[i]="none",Fe.set(r,"display",n)));for(i=0;i<a;i++)null!=o[i]&&(e[i].style.display=o[i]);return e}function v(e,t){var n;return n="undefined"!=typeof e.getElementsByTagName?e.getElementsByTagName(t||"*"):"undefined"!=typeof e.querySelectorAll?e.querySelectorAll(t||"*"):[],void 0===t||t&&de.nodeName(e,t)?de.merge([e],n):n}function y(e,t){for(var n=0,r=e.length;n<r;n++)Fe.set(e[n],"globalEval",!t||Fe.get(t[n],"globalEval"))}function b(e,t,n,r,o){for(var i,a,s,u,l,c,f=t.createDocumentFragment(),p=[],h=0,d=e.length;h<d;h++)if(i=e[h],i||0===i)if("object"===de.type(i))de.merge(p,i.nodeType?[i]:i);else if(Ge.test(i)){for(a=a||f.appendChild(t.createElement("div")),s=(Xe.exec(i)||["",""])[1].toLowerCase(),u=Ve[s]||Ve._default,a.innerHTML=u[1]+de.htmlPrefilter(i)+u[2],c=u[0];c--;)a=a.lastChild;de.merge(p,a.childNodes),a=f.firstChild,a.textContent=""}else p.push(t.createTextNode(i));for(f.textContent="",h=0;i=p[h++];)if(r&&de.inArray(i,r)>-1)o&&o.push(i);else if(l=de.contains(i.ownerDocument,i),a=v(f.appendChild(i),"script"),l&&y(a),n)for(c=0;i=a[c++];)Ke.test(i.type||"")&&n.push(i);return f}function x(){return!0}function w(){return!1}function C(){try{return te.activeElement}catch(e){}}function T(e,t,n,r,o,i){var a,s;if("object"==typeof t){"string"!=typeof n&&(r=r||n,n=void 0);for(s in t)T(e,s,n,r,t[s],i);return e}if(null==r&&null==o?(o=n,r=n=void 0):null==o&&("string"==typeof n?(o=r,r=void 0):(o=r,r=n,n=void 0)),o===!1)o=w;else if(!o)return e;return 1===i&&(a=o,o=function(e){return de().off(e),a.apply(this,arguments)},o.guid=a.guid||(a.guid=de.guid++)),e.each(function(){de.event.add(this,t,o,r,n)})}function k(e,t){return de.nodeName(e,"table")&&de.nodeName(11!==t.nodeType?t:t.firstChild,"tr")?e.getElementsByTagName("tbody")[0]||e:e}function j(e){return e.type=(null!==e.getAttribute("type"))+"/"+e.type,e}function E(e){var t=rt.exec(e.type);return t?e.type=t[1]:e.removeAttribute("type"),e}function N(e,t){var n,r,o,i,a,s,u,l;if(1===t.nodeType){if(Fe.hasData(e)&&(i=Fe.access(e),a=Fe.set(t,i),l=i.events)){delete a.handle,a.events={};for(o in l)for(n=0,r=l[o].length;n<r;n++)de.event.add(t,o,l[o][n])}Pe.hasData(e)&&(s=Pe.access(e),u=de.extend({},s),Pe.set(t,u))}}function S(e,t){var n=t.nodeName.toLowerCase();"input"===n&&ze.test(e.type)?t.checked=e.checked:"input"!==n&&"textarea"!==n||(t.defaultValue=e.defaultValue)}function A(e,t,r,o){t=oe.apply([],t);var i,a,s,u,l,c,f=0,p=e.length,h=p-1,d=t[0],g=de.isFunction(d);if(g||p>1&&"string"==typeof d&&!pe.checkClone&&nt.test(d))return e.each(function(n){var i=e.eq(n);g&&(t[0]=d.call(this,n,i.html())),A(i,t,r,o)});if(p&&(i=b(t,e[0].ownerDocument,!1,e,o),a=i.firstChild,1===i.childNodes.length&&(i=a),a||o)){for(s=de.map(v(i,"script"),j),u=s.length;f<p;f++)l=i,f!==h&&(l=de.clone(l,!0,!0),u&&de.merge(s,v(l,"script"))),r.call(e[f],l,f);if(u)for(c=s[s.length-1].ownerDocument,de.map(s,E),f=0;f<u;f++)l=s[f],Ke.test(l.type||"")&&!Fe.access(l,"globalEval")&&de.contains(c,l)&&(l.src?de._evalUrl&&de._evalUrl(l.src):n(l.textContent.replace(ot,""),c))}return e}function q(e,t,n){for(var r,o=t?de.filter(t,e):e,i=0;null!=(r=o[i]);i++)n||1!==r.nodeType||de.cleanData(v(r)),r.parentNode&&(n&&de.contains(r.ownerDocument,r)&&y(v(r,"script")),r.parentNode.removeChild(r));return e}function D(e,t,n){var r,o,i,a,s=e.style;return n=n||st(e),n&&(a=n.getPropertyValue(t)||n[t],""!==a||de.contains(e.ownerDocument,e)||(a=de.style(e,t)),!pe.pixelMarginRight()&&at.test(a)&&it.test(t)&&(r=s.width,o=s.minWidth,i=s.maxWidth,s.minWidth=s.maxWidth=s.width=a,a=n.width,s.width=r,s.minWidth=o,s.maxWidth=i)),void 0!==a?a+"":a}function O(e,t){return{get:function(){return e()?void delete this.get:(this.get=t).apply(this,arguments)}}}function L(e){if(e in pt)return e;for(var t=e[0].toUpperCase()+e.slice(1),n=ft.length;n--;)if(e=ft[n]+t,e in pt)return e}function H(e,t,n){var r=$e.exec(t);return r?Math.max(0,r[2]-(n||0))+(r[3]||"px"):t}function F(e,t,n,r,o){var i,a=0;for(i=n===(r?"border":"content")?4:"width"===t?1:0;i<4;i+=2)"margin"===n&&(a+=de.css(e,n+_e[i],!0,o)),r?("content"===n&&(a-=de.css(e,"padding"+_e[i],!0,o)),"margin"!==n&&(a-=de.css(e,"border"+_e[i]+"Width",!0,o))):(a+=de.css(e,"padding"+_e[i],!0,o),"padding"!==n&&(a+=de.css(e,"border"+_e[i]+"Width",!0,o)));return a}function P(e,t,n){var r,o=!0,i=st(e),a="border-box"===de.css(e,"boxSizing",!1,i);if(e.getClientRects().length&&(r=e.getBoundingClientRect()[t]),r<=0||null==r){if(r=D(e,t,i),(r<0||null==r)&&(r=e.style[t]),at.test(r))return r;o=a&&(pe.boxSizingReliable()||r===e.style[t]),r=parseFloat(r)||0}return r+F(e,t,n||(a?"border":"content"),o,i)+"px"}function I(e,t,n,r,o){return new I.prototype.init(e,t,n,r,o)}function R(){dt&&(e.requestAnimationFrame(R),de.fx.tick())}function M(){return e.setTimeout(function(){ht=void 0}),ht=de.now()}function $(e,t){var n,r=0,o={height:e};for(t=t?1:0;r<4;r+=2-t)n=_e[r],o["margin"+n]=o["padding"+n]=e;return t&&(o.opacity=o.width=e),o}function _(e,t,n){for(var r,o=(U.tweeners[t]||[]).concat(U.tweeners["*"]),i=0,a=o.length;i<a;i++)if(r=o[i].call(n,t,e))return r}function W(e,t,n){var r,o,i,a,s,u,l,c,f="width"in t||"height"in t,p=this,h={},d=e.style,g=e.nodeType&&We(e),v=Fe.get(e,"fxshow");n.queue||(a=de._queueHooks(e,"fx"),null==a.unqueued&&(a.unqueued=0,s=a.empty.fire,a.empty.fire=function(){a.unqueued||s()}),a.unqueued++,p.always(function(){p.always(function(){a.unqueued--,de.queue(e,"fx").length||a.empty.fire()})}));for(r in t)if(o=t[r],gt.test(o)){if(delete t[r],i=i||"toggle"===o,o===(g?"hide":"show")){if("show"!==o||!v||void 0===v[r])continue;g=!0}h[r]=v&&v[r]||de.style(e,r)}if(u=!de.isEmptyObject(t),u||!de.isEmptyObject(h)){f&&1===e.nodeType&&(n.overflow=[d.overflow,d.overflowX,d.overflowY],l=v&&v.display,null==l&&(l=Fe.get(e,"display")),c=de.css(e,"display"),"none"===c&&(l?c=l:(m([e],!0),l=e.style.display||l,c=de.css(e,"display"),m([e]))),("inline"===c||"inline-block"===c&&null!=l)&&"none"===de.css(e,"float")&&(u||(p.done(function(){d.display=l}),null==l&&(c=d.display,l="none"===c?"":c)),d.display="inline-block")),n.overflow&&(d.overflow="hidden",p.always(function(){d.overflow=n.overflow[0],d.overflowX=n.overflow[1],d.overflowY=n.overflow[2]})),u=!1;for(r in h)u||(v?"hidden"in v&&(g=v.hidden):v=Fe.access(e,"fxshow",{display:l}),i&&(v.hidden=!g),g&&m([e],!0),p.done(function(){g||m([e]),Fe.remove(e,"fxshow");for(r in h)de.style(e,r,h[r])})),u=_(g?v[r]:0,r,p),r in v||(v[r]=u.start,g&&(u.end=u.start,u.start=0))}}function B(e,t){var n,r,o,i,a;for(n in e)if(r=de.camelCase(n),o=t[r],i=e[n],de.isArray(i)&&(o=i[1],i=e[n]=i[0]),n!==r&&(e[r]=i,delete e[n]),a=de.cssHooks[r],a&&"expand"in a){i=a.expand(i),delete e[r];for(n in i)n in e||(e[n]=i[n],t[n]=o)}else t[r]=o}function U(e,t,n){var r,o,i=0,a=U.prefilters.length,s=de.Deferred().always(function(){delete u.elem}),u=function(){if(o)return!1;for(var t=ht||M(),n=Math.max(0,l.startTime+l.duration-t),r=n/l.duration||0,i=1-r,a=0,u=l.tweens.length;a<u;a++)l.tweens[a].run(i);return s.notifyWith(e,[l,i,n]),i<1&&u?n:(s.resolveWith(e,[l]),!1)},l=s.promise({elem:e,props:de.extend({},t),opts:de.extend(!0,{specialEasing:{},easing:de.easing._default},n),originalProperties:t,originalOptions:n,startTime:ht||M(),duration:n.duration,tweens:[],createTween:function(t,n){var r=de.Tween(e,l.opts,t,n,l.opts.specialEasing[t]||l.opts.easing);return l.tweens.push(r),r},stop:function(t){var n=0,r=t?l.tweens.length:0;if(o)return this;for(o=!0;n<r;n++)l.tweens[n].run(1);return t?(s.notifyWith(e,[l,1,0]),s.resolveWith(e,[l,t])):s.rejectWith(e,[l,t]),this}}),c=l.props;for(B(c,l.opts.specialEasing);i<a;i++)if(r=U.prefilters[i].call(l,e,c,l.opts))return de.isFunction(r.stop)&&(de._queueHooks(l.elem,l.opts.queue).stop=de.proxy(r.stop,r)),r;return de.map(c,_,l),de.isFunction(l.opts.start)&&l.opts.start.call(e,l),de.fx.timer(de.extend(u,{elem:e,anim:l,queue:l.opts.queue})),l.progress(l.opts.progress).done(l.opts.done,l.opts.complete).fail(l.opts.fail).always(l.opts.always)}function z(e){var t=e.match(qe)||[];return t.join(" ")}function X(e){return e.getAttribute&&e.getAttribute("class")||""}function K(e,t,n,r){var o;if(de.isArray(t))de.each(t,function(t,o){n||Et.test(e)?r(e,o):K(e+"["+("object"==typeof o&&null!=o?t:"")+"]",o,n,r)});else if(n||"object"!==de.type(t))r(e,t);else for(o in t)K(e+"["+o+"]",t[o],n,r)}function V(e){return function(t,n){"string"!=typeof t&&(n=t,t="*");var r,o=0,i=t.toLowerCase().match(qe)||[];if(de.isFunction(n))for(;r=i[o++];)"+"===r[0]?(r=r.slice(1)||"*",(e[r]=e[r]||[]).unshift(n)):(e[r]=e[r]||[]).push(n)}}function G(e,t,n,r){function o(s){var u;return i[s]=!0,de.each(e[s]||[],function(e,s){var l=s(t,n,r);return"string"!=typeof l||a||i[l]?a?!(u=l):void 0:(t.dataTypes.unshift(l),o(l),!1)}),u}var i={},a=e===Rt;return o(t.dataTypes[0])||!i["*"]&&o("*")}function Y(e,t){var n,r,o=de.ajaxSettings.flatOptions||{};for(n in t)void 0!==t[n]&&((o[n]?e:r||(r={}))[n]=t[n]);return r&&de.extend(!0,e,r),e}function Q(e,t,n){for(var r,o,i,a,s=e.contents,u=e.dataTypes;"*"===u[0];)u.shift(),void 0===r&&(r=e.mimeType||t.getResponseHeader("Content-Type"));if(r)for(o in s)if(s[o]&&s[o].test(r)){u.unshift(o);break}if(u[0]in n)i=u[0];else{for(o in n){if(!u[0]||e.converters[o+" "+u[0]]){i=o;break}a||(a=o)}i=i||a}if(i)return i!==u[0]&&u.unshift(i),n[i]}function J(e,t,n,r){var o,i,a,s,u,l={},c=e.dataTypes.slice();if(c[1])for(a in e.converters)l[a.toLowerCase()]=e.converters[a];for(i=c.shift();i;)if(e.responseFields[i]&&(n[e.responseFields[i]]=t),!u&&r&&e.dataFilter&&(t=e.dataFilter(t,e.dataType)),u=i,i=c.shift())if("*"===i)i=u;else if("*"!==u&&u!==i){if(a=l[u+" "+i]||l["* "+i],!a)for(o in l)if(s=o.split(" "),s[1]===i&&(a=l[u+" "+s[0]]||l["* "+s[0]])){a===!0?a=l[o]:l[o]!==!0&&(i=s[0],c.unshift(s[1]));break}if(a!==!0)if(a&&e.throws)t=a(t);else try{t=a(t)}catch(e){return{state:"parsererror",error:a?e:"No conversion from "+u+" to "+i}}}return{state:"success",data:t}}function Z(e){return de.isWindow(e)?e:9===e.nodeType&&e.defaultView}var ee=[],te=e.document,ne=Object.getPrototypeOf,re=ee.slice,oe=ee.concat,ie=ee.push,ae=ee.indexOf,se={},ue=se.toString,le=se.hasOwnProperty,ce=le.toString,fe=ce.call(Object),pe={},he="3.1.1",de=function(e,t){return new de.fn.init(e,t)},ge=/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g,me=/^-ms-/,ve=/-([a-z])/g,ye=function(e,t){return t.toUpperCase()};de.fn=de.prototype={jquery:he,constructor:de,length:0,toArray:function(){return re.call(this)},get:function(e){return null==e?re.call(this):e<0?this[e+this.length]:this[e]},pushStack:function(e){var t=de.merge(this.constructor(),e);return t.prevObject=this,t},each:function(e){return de.each(this,e)},map:function(e){return this.pushStack(de.map(this,function(t,n){return e.call(t,n,t)}))},slice:function(){return this.pushStack(re.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},eq:function(e){var t=this.length,n=+e+(e<0?t:0);return this.pushStack(n>=0&&n<t?[this[n]]:[])},end:function(){return this.prevObject||this.constructor()},push:ie,sort:ee.sort,splice:ee.splice},de.extend=de.fn.extend=function(){var e,t,n,r,o,i,a=arguments[0]||{},s=1,u=arguments.length,l=!1;for("boolean"==typeof a&&(l=a,a=arguments[s]||{},s++),"object"==typeof a||de.isFunction(a)||(a={}),s===u&&(a=this,s--);s<u;s++)if(null!=(e=arguments[s]))for(t in e)n=a[t],r=e[t],a!==r&&(l&&r&&(de.isPlainObject(r)||(o=de.isArray(r)))?(o?(o=!1,i=n&&de.isArray(n)?n:[]):i=n&&de.isPlainObject(n)?n:{},a[t]=de.extend(l,i,r)):void 0!==r&&(a[t]=r));return a},de.extend({expando:"jQuery"+(he+Math.random()).replace(/\D/g,""),isReady:!0,error:function(e){throw new Error(e)},noop:function(){},isFunction:function(e){return"function"===de.type(e)},isArray:Array.isArray,isWindow:function(e){return null!=e&&e===e.window},isNumeric:function(e){var t=de.type(e);return("number"===t||"string"===t)&&!isNaN(e-parseFloat(e))},isPlainObject:function(e){var t,n;return!(!e||"[object Object]"!==ue.call(e))&&(!(t=ne(e))||(n=le.call(t,"constructor")&&t.constructor,"function"==typeof n&&ce.call(n)===fe))},isEmptyObject:function(e){var t;for(t in e)return!1;return!0},type:function(e){return null==e?e+"":"object"==typeof e||"function"==typeof e?se[ue.call(e)]||"object":typeof e},globalEval:function(e){n(e)},camelCase:function(e){return e.replace(me,"ms-").replace(ve,ye)},nodeName:function(e,t){return e.nodeName&&e.nodeName.toLowerCase()===t.toLowerCase()},each:function(e,t){var n,o=0;if(r(e))for(n=e.length;o<n&&t.call(e[o],o,e[o])!==!1;o++);else for(o in e)if(t.call(e[o],o,e[o])===!1)break;return e},trim:function(e){return null==e?"":(e+"").replace(ge,"")},makeArray:function(e,t){var n=t||[];return null!=e&&(r(Object(e))?de.merge(n,"string"==typeof e?[e]:e):ie.call(n,e)),n},inArray:function(e,t,n){return null==t?-1:ae.call(t,e,n)},merge:function(e,t){for(var n=+t.length,r=0,o=e.length;r<n;r++)e[o++]=t[r];return e.length=o,e},grep:function(e,t,n){for(var r,o=[],i=0,a=e.length,s=!n;i<a;i++)r=!t(e[i],i),r!==s&&o.push(e[i]);return o},map:function(e,t,n){var o,i,a=0,s=[];if(r(e))for(o=e.length;a<o;a++)i=t(e[a],a,n),null!=i&&s.push(i);else for(a in e)i=t(e[a],a,n),null!=i&&s.push(i);return oe.apply([],s)},guid:1,proxy:function(e,t){var n,r,o;if("string"==typeof t&&(n=e[t],t=e,e=n),de.isFunction(e))return r=re.call(arguments,2),o=function(){return e.apply(t||this,r.concat(re.call(arguments)))},o.guid=e.guid=e.guid||de.guid++,o},now:Date.now,support:pe}),"function"==typeof Symbol&&(de.fn[Symbol.iterator]=ee[Symbol.iterator]),de.each("Boolean Number String Function Array Date RegExp Object Error Symbol".split(" "),function(e,t){se["[object "+t+"]"]=t.toLowerCase()});var be=function(e){function t(e,t,n,r){var o,i,a,s,u,l,c,p=t&&t.ownerDocument,d=t?t.nodeType:9;if(n=n||[],"string"!=typeof e||!e||1!==d&&9!==d&&11!==d)return n;if(!r&&((t?t.ownerDocument||t:_)!==L&&O(t),t=t||L,F)){if(11!==d&&(u=ve.exec(e)))if(o=u[1]){if(9===d){if(!(a=t.getElementById(o)))return n;if(a.id===o)return n.push(a),n}else if(p&&(a=p.getElementById(o))&&M(t,a)&&a.id===o)return n.push(a),n}else{if(u[2])return J.apply(n,t.getElementsByTagName(e)),n;if((o=u[3])&&C.getElementsByClassName&&t.getElementsByClassName)return J.apply(n,t.getElementsByClassName(o)),n}if(C.qsa&&!X[e+" "]&&(!P||!P.test(e))){if(1!==d)p=t,c=e;else if("object"!==t.nodeName.toLowerCase()){for((s=t.getAttribute("id"))?s=s.replace(we,Ce):t.setAttribute("id",s=$),l=E(e),i=l.length;i--;)l[i]="#"+s+" "+h(l[i]);c=l.join(","),p=ye.test(e)&&f(t.parentNode)||t}if(c)try{return J.apply(n,p.querySelectorAll(c)),n}catch(e){}finally{s===$&&t.removeAttribute("id")}}}return S(e.replace(se,"$1"),t,n,r)}function n(){function e(n,r){return t.push(n+" ")>T.cacheLength&&delete e[t.shift()],e[n+" "]=r}var t=[];return e}function r(e){return e[$]=!0,e}function o(e){var t=L.createElement("fieldset");try{return!!e(t)}catch(e){return!1}finally{t.parentNode&&t.parentNode.removeChild(t),t=null}}function i(e,t){for(var n=e.split("|"),r=n.length;r--;)T.attrHandle[n[r]]=t}function a(e,t){var n=t&&e,r=n&&1===e.nodeType&&1===t.nodeType&&e.sourceIndex-t.sourceIndex;if(r)return r;if(n)for(;n=n.nextSibling;)if(n===t)return-1;return e?1:-1}function s(e){return function(t){var n=t.nodeName.toLowerCase();return"input"===n&&t.type===e}}function u(e){return function(t){var n=t.nodeName.toLowerCase();return("input"===n||"button"===n)&&t.type===e}}function l(e){return function(t){return"form"in t?t.parentNode&&t.disabled===!1?"label"in t?"label"in t.parentNode?t.parentNode.disabled===e:t.disabled===e:t.isDisabled===e||t.isDisabled!==!e&&ke(t)===e:t.disabled===e:"label"in t&&t.disabled===e}}function c(e){return r(function(t){return t=+t,r(function(n,r){for(var o,i=e([],n.length,t),a=i.length;a--;)n[o=i[a]]&&(n[o]=!(r[o]=n[o]))})})}function f(e){return e&&"undefined"!=typeof e.getElementsByTagName&&e}function p(){}function h(e){for(var t=0,n=e.length,r="";t<n;t++)r+=e[t].value;return r}function d(e,t,n){var r=t.dir,o=t.next,i=o||r,a=n&&"parentNode"===i,s=B++;return t.first?function(t,n,o){for(;t=t[r];)if(1===t.nodeType||a)return e(t,n,o);return!1}:function(t,n,u){var l,c,f,p=[W,s];if(u){for(;t=t[r];)if((1===t.nodeType||a)&&e(t,n,u))return!0}else for(;t=t[r];)if(1===t.nodeType||a)if(f=t[$]||(t[$]={}),c=f[t.uniqueID]||(f[t.uniqueID]={}),o&&o===t.nodeName.toLowerCase())t=t[r]||t;else{if((l=c[i])&&l[0]===W&&l[1]===s)return p[2]=l[2];if(c[i]=p,p[2]=e(t,n,u))return!0}return!1}}function g(e){return e.length>1?function(t,n,r){for(var o=e.length;o--;)if(!e[o](t,n,r))return!1;return!0}:e[0]}function m(e,n,r){for(var o=0,i=n.length;o<i;o++)t(e,n[o],r);return r}function v(e,t,n,r,o){for(var i,a=[],s=0,u=e.length,l=null!=t;s<u;s++)(i=e[s])&&(n&&!n(i,r,o)||(a.push(i),l&&t.push(s)));return a}function y(e,t,n,o,i,a){return o&&!o[$]&&(o=y(o)),i&&!i[$]&&(i=y(i,a)),r(function(r,a,s,u){var l,c,f,p=[],h=[],d=a.length,g=r||m(t||"*",s.nodeType?[s]:s,[]),y=!e||!r&&t?g:v(g,p,e,s,u),b=n?i||(r?e:d||o)?[]:a:y;if(n&&n(y,b,s,u),o)for(l=v(b,h),o(l,[],s,u),c=l.length;c--;)(f=l[c])&&(b[h[c]]=!(y[h[c]]=f));if(r){if(i||e){if(i){for(l=[],c=b.length;c--;)(f=b[c])&&l.push(y[c]=f);i(null,b=[],l,u)}for(c=b.length;c--;)(f=b[c])&&(l=i?ee(r,f):p[c])>-1&&(r[l]=!(a[l]=f))}}else b=v(b===a?b.splice(d,b.length):b),i?i(null,a,b,u):J.apply(a,b)})}function b(e){for(var t,n,r,o=e.length,i=T.relative[e[0].type],a=i||T.relative[" "],s=i?1:0,u=d(function(e){return e===t},a,!0),l=d(function(e){return ee(t,e)>-1},a,!0),c=[function(e,n,r){var o=!i&&(r||n!==A)||((t=n).nodeType?u(e,n,r):l(e,n,r));return t=null,o}];s<o;s++)if(n=T.relative[e[s].type])c=[d(g(c),n)];else{if(n=T.filter[e[s].type].apply(null,e[s].matches),n[$]){for(r=++s;r<o&&!T.relative[e[r].type];r++);return y(s>1&&g(c),s>1&&h(e.slice(0,s-1).concat({value:" "===e[s-2].type?"*":""})).replace(se,"$1"),n,s<r&&b(e.slice(s,r)),r<o&&b(e=e.slice(r)),r<o&&h(e))}c.push(n)}return g(c)}function x(e,n){var o=n.length>0,i=e.length>0,a=function(r,a,s,u,l){var c,f,p,h=0,d="0",g=r&&[],m=[],y=A,b=r||i&&T.find.TAG("*",l),x=W+=null==y?1:Math.random()||.1,w=b.length;for(l&&(A=a===L||a||l);d!==w&&null!=(c=b[d]);d++){if(i&&c){for(f=0,a||c.ownerDocument===L||(O(c),s=!F);p=e[f++];)if(p(c,a||L,s)){u.push(c);break}l&&(W=x)}o&&((c=!p&&c)&&h--,r&&g.push(c))}if(h+=d,o&&d!==h){for(f=0;p=n[f++];)p(g,m,a,s);if(r){if(h>0)for(;d--;)g[d]||m[d]||(m[d]=Y.call(u));m=v(m)}J.apply(u,m),l&&!r&&m.length>0&&h+n.length>1&&t.uniqueSort(u)}return l&&(W=x,A=y),g};return o?r(a):a}var w,C,T,k,j,E,N,S,A,q,D,O,L,H,F,P,I,R,M,$="sizzle"+1*new Date,_=e.document,W=0,B=0,U=n(),z=n(),X=n(),K=function(e,t){return e===t&&(D=!0),0},V={}.hasOwnProperty,G=[],Y=G.pop,Q=G.push,J=G.push,Z=G.slice,ee=function(e,t){for(var n=0,r=e.length;n<r;n++)if(e[n]===t)return n;return-1},te="checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped",ne="[\\x20\\t\\r\\n\\f]",re="(?:\\\\.|[\\w-]|[^\0-\\xa0])+",oe="\\["+ne+"*("+re+")(?:"+ne+"*([*^$|!~]?=)"+ne+"*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|("+re+"))|)"+ne+"*\\]",ie=":("+re+")(?:\\((('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|((?:\\\\.|[^\\\\()[\\]]|"+oe+")*)|.*)\\)|)",ae=new RegExp(ne+"+","g"),se=new RegExp("^"+ne+"+|((?:^|[^\\\\])(?:\\\\.)*)"+ne+"+$","g"),ue=new RegExp("^"+ne+"*,"+ne+"*"),le=new RegExp("^"+ne+"*([>+~]|"+ne+")"+ne+"*"),ce=new RegExp("="+ne+"*([^\\]'\"]*?)"+ne+"*\\]","g"),fe=new RegExp(ie),pe=new RegExp("^"+re+"$"),he={ID:new RegExp("^#("+re+")"),CLASS:new RegExp("^\\.("+re+")"),TAG:new RegExp("^("+re+"|[*])"),ATTR:new RegExp("^"+oe),PSEUDO:new RegExp("^"+ie),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+ne+"*(even|odd|(([+-]|)(\\d*)n|)"+ne+"*(?:([+-]|)"+ne+"*(\\d+)|))"+ne+"*\\)|)","i"),bool:new RegExp("^(?:"+te+")$","i"),needsContext:new RegExp("^"+ne+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+ne+"*((?:-\\d)?\\d*)"+ne+"*\\)|)(?=[^-]|$)","i")},de=/^(?:input|select|textarea|button)$/i,ge=/^h\d$/i,me=/^[^{]+\{\s*\[native \w/,ve=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,ye=/[+~]/,be=new RegExp("\\\\([\\da-f]{1,6}"+ne+"?|("+ne+")|.)","ig"),xe=function(e,t,n){var r="0x"+t-65536;return r!==r||n?t:r<0?String.fromCharCode(r+65536):String.fromCharCode(r>>10|55296,1023&r|56320)},we=/([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,Ce=function(e,t){return t?"\0"===e?"�":e.slice(0,-1)+"\\"+e.charCodeAt(e.length-1).toString(16)+" ":"\\"+e},Te=function(){O()},ke=d(function(e){return e.disabled===!0&&("form"in e||"label"in e)},{dir:"parentNode",next:"legend"});try{J.apply(G=Z.call(_.childNodes),_.childNodes),G[_.childNodes.length].nodeType}catch(e){J={apply:G.length?function(e,t){Q.apply(e,Z.call(t))}:function(e,t){for(var n=e.length,r=0;e[n++]=t[r++];);e.length=n-1}}}C=t.support={},j=t.isXML=function(e){var t=e&&(e.ownerDocument||e).documentElement;return!!t&&"HTML"!==t.nodeName},O=t.setDocument=function(e){var t,n,r=e?e.ownerDocument||e:_;return r!==L&&9===r.nodeType&&r.documentElement?(L=r,H=L.documentElement,F=!j(L),_!==L&&(n=L.defaultView)&&n.top!==n&&(n.addEventListener?n.addEventListener("unload",Te,!1):n.attachEvent&&n.attachEvent("onunload",Te)),C.attributes=o(function(e){return e.className="i",!e.getAttribute("className")}),C.getElementsByTagName=o(function(e){return e.appendChild(L.createComment("")),!e.getElementsByTagName("*").length}),C.getElementsByClassName=me.test(L.getElementsByClassName),C.getById=o(function(e){return H.appendChild(e).id=$,!L.getElementsByName||!L.getElementsByName($).length}),C.getById?(T.filter.ID=function(e){var t=e.replace(be,xe);return function(e){return e.getAttribute("id")===t}},T.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&F){var n=t.getElementById(e);return n?[n]:[]}}):(T.filter.ID=function(e){var t=e.replace(be,xe);return function(e){var n="undefined"!=typeof e.getAttributeNode&&e.getAttributeNode("id");return n&&n.value===t}},T.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&F){var n,r,o,i=t.getElementById(e);if(i){if(n=i.getAttributeNode("id"),n&&n.value===e)return[i];for(o=t.getElementsByName(e),r=0;i=o[r++];)if(n=i.getAttributeNode("id"),n&&n.value===e)return[i]}return[]}}),T.find.TAG=C.getElementsByTagName?function(e,t){return"undefined"!=typeof t.getElementsByTagName?t.getElementsByTagName(e):C.qsa?t.querySelectorAll(e):void 0}:function(e,t){var n,r=[],o=0,i=t.getElementsByTagName(e);if("*"===e){for(;n=i[o++];)1===n.nodeType&&r.push(n);return r}return i},T.find.CLASS=C.getElementsByClassName&&function(e,t){if("undefined"!=typeof t.getElementsByClassName&&F)return t.getElementsByClassName(e)},I=[],P=[],(C.qsa=me.test(L.querySelectorAll))&&(o(function(e){H.appendChild(e).innerHTML="<a id='"+$+"'></a><select id='"+$+"-\r\\' msallowcapture=''><option selected=''></option></select>",e.querySelectorAll("[msallowcapture^='']").length&&P.push("[*^$]="+ne+"*(?:''|\"\")"),e.querySelectorAll("[selected]").length||P.push("\\["+ne+"*(?:value|"+te+")"),e.querySelectorAll("[id~="+$+"-]").length||P.push("~="),e.querySelectorAll(":checked").length||P.push(":checked"),e.querySelectorAll("a#"+$+"+*").length||P.push(".#.+[+~]")}),o(function(e){e.innerHTML="<a href='' disabled='disabled'></a><select disabled='disabled'><option/></select>";var t=L.createElement("input");t.setAttribute("type","hidden"),e.appendChild(t).setAttribute("name","D"),e.querySelectorAll("[name=d]").length&&P.push("name"+ne+"*[*^$|!~]?="),2!==e.querySelectorAll(":enabled").length&&P.push(":enabled",":disabled"),H.appendChild(e).disabled=!0,2!==e.querySelectorAll(":disabled").length&&P.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),P.push(",.*:")})),(C.matchesSelector=me.test(R=H.matches||H.webkitMatchesSelector||H.mozMatchesSelector||H.oMatchesSelector||H.msMatchesSelector))&&o(function(e){C.disconnectedMatch=R.call(e,"*"),R.call(e,"[s!='']:x"),I.push("!=",ie)}),P=P.length&&new RegExp(P.join("|")),I=I.length&&new RegExp(I.join("|")),t=me.test(H.compareDocumentPosition),M=t||me.test(H.contains)?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)for(;t=t.parentNode;)if(t===e)return!0;return!1},K=t?function(e,t){if(e===t)return D=!0,0;var n=!e.compareDocumentPosition-!t.compareDocumentPosition;return n?n:(n=(e.ownerDocument||e)===(t.ownerDocument||t)?e.compareDocumentPosition(t):1,1&n||!C.sortDetached&&t.compareDocumentPosition(e)===n?e===L||e.ownerDocument===_&&M(_,e)?-1:t===L||t.ownerDocument===_&&M(_,t)?1:q?ee(q,e)-ee(q,t):0:4&n?-1:1)}:function(e,t){if(e===t)return D=!0,0;var n,r=0,o=e.parentNode,i=t.parentNode,s=[e],u=[t];if(!o||!i)return e===L?-1:t===L?1:o?-1:i?1:q?ee(q,e)-ee(q,t):0;if(o===i)return a(e,t);for(n=e;n=n.parentNode;)s.unshift(n);for(n=t;n=n.parentNode;)u.unshift(n);for(;s[r]===u[r];)r++;return r?a(s[r],u[r]):s[r]===_?-1:u[r]===_?1:0},L):L},t.matches=function(e,n){return t(e,null,null,n)},t.matchesSelector=function(e,n){if((e.ownerDocument||e)!==L&&O(e),n=n.replace(ce,"='$1']"),C.matchesSelector&&F&&!X[n+" "]&&(!I||!I.test(n))&&(!P||!P.test(n)))try{var r=R.call(e,n);if(r||C.disconnectedMatch||e.document&&11!==e.document.nodeType)return r}catch(e){}return t(n,L,null,[e]).length>0},t.contains=function(e,t){return(e.ownerDocument||e)!==L&&O(e),M(e,t)},t.attr=function(e,t){(e.ownerDocument||e)!==L&&O(e);var n=T.attrHandle[t.toLowerCase()],r=n&&V.call(T.attrHandle,t.toLowerCase())?n(e,t,!F):void 0;return void 0!==r?r:C.attributes||!F?e.getAttribute(t):(r=e.getAttributeNode(t))&&r.specified?r.value:null},t.escape=function(e){return(e+"").replace(we,Ce)},t.error=function(e){throw new Error("Syntax error, unrecognized expression: "+e)},t.uniqueSort=function(e){var t,n=[],r=0,o=0;if(D=!C.detectDuplicates,q=!C.sortStable&&e.slice(0),e.sort(K),D){for(;t=e[o++];)t===e[o]&&(r=n.push(o));for(;r--;)e.splice(n[r],1)}return q=null,e},k=t.getText=function(e){var t,n="",r=0,o=e.nodeType;if(o){if(1===o||9===o||11===o){if("string"==typeof e.textContent)return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=k(e)}else if(3===o||4===o)return e.nodeValue}else for(;t=e[r++];)n+=k(t);return n},T=t.selectors={cacheLength:50,createPseudo:r,match:he,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace(be,xe),e[3]=(e[3]||e[4]||e[5]||"").replace(be,xe),"~="===e[2]&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),"nth"===e[1].slice(0,3)?(e[3]||t.error(e[0]),e[4]=+(e[4]?e[5]+(e[6]||1):2*("even"===e[3]||"odd"===e[3])),e[5]=+(e[7]+e[8]||"odd"===e[3])):e[3]&&t.error(e[0]),e},PSEUDO:function(e){var t,n=!e[6]&&e[2];return he.CHILD.test(e[0])?null:(e[3]?e[2]=e[4]||e[5]||"":n&&fe.test(n)&&(t=E(n,!0))&&(t=n.indexOf(")",n.length-t)-n.length)&&(e[0]=e[0].slice(0,t),e[2]=n.slice(0,t)),e.slice(0,3))}},filter:{TAG:function(e){var t=e.replace(be,xe).toLowerCase();return"*"===e?function(){return!0}:function(e){return e.nodeName&&e.nodeName.toLowerCase()===t}},CLASS:function(e){var t=U[e+" "];return t||(t=new RegExp("(^|"+ne+")"+e+"("+ne+"|$)"))&&U(e,function(e){return t.test("string"==typeof e.className&&e.className||"undefined"!=typeof e.getAttribute&&e.getAttribute("class")||"")})},ATTR:function(e,n,r){return function(o){var i=t.attr(o,e);return null==i?"!="===n:!n||(i+="","="===n?i===r:"!="===n?i!==r:"^="===n?r&&0===i.indexOf(r):"*="===n?r&&i.indexOf(r)>-1:"$="===n?r&&i.slice(-r.length)===r:"~="===n?(" "+i.replace(ae," ")+" ").indexOf(r)>-1:"|="===n&&(i===r||i.slice(0,r.length+1)===r+"-"))}},CHILD:function(e,t,n,r,o){var i="nth"!==e.slice(0,3),a="last"!==e.slice(-4),s="of-type"===t;return 1===r&&0===o?function(e){return!!e.parentNode}:function(t,n,u){var l,c,f,p,h,d,g=i!==a?"nextSibling":"previousSibling",m=t.parentNode,v=s&&t.nodeName.toLowerCase(),y=!u&&!s,b=!1;if(m){if(i){for(;g;){for(p=t;p=p[g];)if(s?p.nodeName.toLowerCase()===v:1===p.nodeType)return!1;d=g="only"===e&&!d&&"nextSibling"}return!0}if(d=[a?m.firstChild:m.lastChild],a&&y){for(p=m,f=p[$]||(p[$]={}),c=f[p.uniqueID]||(f[p.uniqueID]={}),l=c[e]||[],h=l[0]===W&&l[1],b=h&&l[2],p=h&&m.childNodes[h];p=++h&&p&&p[g]||(b=h=0)||d.pop();)if(1===p.nodeType&&++b&&p===t){c[e]=[W,h,b];break}}else if(y&&(p=t,f=p[$]||(p[$]={}),c=f[p.uniqueID]||(f[p.uniqueID]={}),l=c[e]||[],h=l[0]===W&&l[1],b=h),b===!1)for(;(p=++h&&p&&p[g]||(b=h=0)||d.pop())&&((s?p.nodeName.toLowerCase()!==v:1!==p.nodeType)||!++b||(y&&(f=p[$]||(p[$]={}),c=f[p.uniqueID]||(f[p.uniqueID]={}),c[e]=[W,b]),p!==t)););return b-=o,b===r||b%r===0&&b/r>=0}}},PSEUDO:function(e,n){var o,i=T.pseudos[e]||T.setFilters[e.toLowerCase()]||t.error("unsupported pseudo: "+e);return i[$]?i(n):i.length>1?(o=[e,e,"",n],T.setFilters.hasOwnProperty(e.toLowerCase())?r(function(e,t){for(var r,o=i(e,n),a=o.length;a--;)r=ee(e,o[a]),e[r]=!(t[r]=o[a])}):function(e){return i(e,0,o)}):i}},pseudos:{not:r(function(e){var t=[],n=[],o=N(e.replace(se,"$1"));return o[$]?r(function(e,t,n,r){for(var i,a=o(e,null,r,[]),s=e.length;s--;)(i=a[s])&&(e[s]=!(t[s]=i))}):function(e,r,i){return t[0]=e,o(t,null,i,n),t[0]=null,!n.pop()}}),has:r(function(e){return function(n){
+return t(e,n).length>0}}),contains:r(function(e){return e=e.replace(be,xe),function(t){return(t.textContent||t.innerText||k(t)).indexOf(e)>-1}}),lang:r(function(e){return pe.test(e||"")||t.error("unsupported lang: "+e),e=e.replace(be,xe).toLowerCase(),function(t){var n;do if(n=F?t.lang:t.getAttribute("xml:lang")||t.getAttribute("lang"))return n=n.toLowerCase(),n===e||0===n.indexOf(e+"-");while((t=t.parentNode)&&1===t.nodeType);return!1}}),target:function(t){var n=e.location&&e.location.hash;return n&&n.slice(1)===t.id},root:function(e){return e===H},focus:function(e){return e===L.activeElement&&(!L.hasFocus||L.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},enabled:l(!1),disabled:l(!0),checked:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&!!e.checked||"option"===t&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,e.selected===!0},empty:function(e){for(e=e.firstChild;e;e=e.nextSibling)if(e.nodeType<6)return!1;return!0},parent:function(e){return!T.pseudos.empty(e)},header:function(e){return ge.test(e.nodeName)},input:function(e){return de.test(e.nodeName)},button:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&"button"===e.type||"button"===t},text:function(e){var t;return"input"===e.nodeName.toLowerCase()&&"text"===e.type&&(null==(t=e.getAttribute("type"))||"text"===t.toLowerCase())},first:c(function(){return[0]}),last:c(function(e,t){return[t-1]}),eq:c(function(e,t,n){return[n<0?n+t:n]}),even:c(function(e,t){for(var n=0;n<t;n+=2)e.push(n);return e}),odd:c(function(e,t){for(var n=1;n<t;n+=2)e.push(n);return e}),lt:c(function(e,t,n){for(var r=n<0?n+t:n;--r>=0;)e.push(r);return e}),gt:c(function(e,t,n){for(var r=n<0?n+t:n;++r<t;)e.push(r);return e})}},T.pseudos.nth=T.pseudos.eq;for(w in{radio:!0,checkbox:!0,file:!0,password:!0,image:!0})T.pseudos[w]=s(w);for(w in{submit:!0,reset:!0})T.pseudos[w]=u(w);return p.prototype=T.filters=T.pseudos,T.setFilters=new p,E=t.tokenize=function(e,n){var r,o,i,a,s,u,l,c=z[e+" "];if(c)return n?0:c.slice(0);for(s=e,u=[],l=T.preFilter;s;){r&&!(o=ue.exec(s))||(o&&(s=s.slice(o[0].length)||s),u.push(i=[])),r=!1,(o=le.exec(s))&&(r=o.shift(),i.push({value:r,type:o[0].replace(se," ")}),s=s.slice(r.length));for(a in T.filter)!(o=he[a].exec(s))||l[a]&&!(o=l[a](o))||(r=o.shift(),i.push({value:r,type:a,matches:o}),s=s.slice(r.length));if(!r)break}return n?s.length:s?t.error(e):z(e,u).slice(0)},N=t.compile=function(e,t){var n,r=[],o=[],i=X[e+" "];if(!i){for(t||(t=E(e)),n=t.length;n--;)i=b(t[n]),i[$]?r.push(i):o.push(i);i=X(e,x(o,r)),i.selector=e}return i},S=t.select=function(e,t,n,r){var o,i,a,s,u,l="function"==typeof e&&e,c=!r&&E(e=l.selector||e);if(n=n||[],1===c.length){if(i=c[0]=c[0].slice(0),i.length>2&&"ID"===(a=i[0]).type&&9===t.nodeType&&F&&T.relative[i[1].type]){if(t=(T.find.ID(a.matches[0].replace(be,xe),t)||[])[0],!t)return n;l&&(t=t.parentNode),e=e.slice(i.shift().value.length)}for(o=he.needsContext.test(e)?0:i.length;o--&&(a=i[o],!T.relative[s=a.type]);)if((u=T.find[s])&&(r=u(a.matches[0].replace(be,xe),ye.test(i[0].type)&&f(t.parentNode)||t))){if(i.splice(o,1),e=r.length&&h(i),!e)return J.apply(n,r),n;break}}return(l||N(e,c))(r,t,!F,n,!t||ye.test(e)&&f(t.parentNode)||t),n},C.sortStable=$.split("").sort(K).join("")===$,C.detectDuplicates=!!D,O(),C.sortDetached=o(function(e){return 1&e.compareDocumentPosition(L.createElement("fieldset"))}),o(function(e){return e.innerHTML="<a href='#'></a>","#"===e.firstChild.getAttribute("href")})||i("type|href|height|width",function(e,t,n){if(!n)return e.getAttribute(t,"type"===t.toLowerCase()?1:2)}),C.attributes&&o(function(e){return e.innerHTML="<input/>",e.firstChild.setAttribute("value",""),""===e.firstChild.getAttribute("value")})||i("value",function(e,t,n){if(!n&&"input"===e.nodeName.toLowerCase())return e.defaultValue}),o(function(e){return null==e.getAttribute("disabled")})||i(te,function(e,t,n){var r;if(!n)return e[t]===!0?t.toLowerCase():(r=e.getAttributeNode(t))&&r.specified?r.value:null}),t}(e);de.find=be,de.expr=be.selectors,de.expr[":"]=de.expr.pseudos,de.uniqueSort=de.unique=be.uniqueSort,de.text=be.getText,de.isXMLDoc=be.isXML,de.contains=be.contains,de.escapeSelector=be.escape;var xe=function(e,t,n){for(var r=[],o=void 0!==n;(e=e[t])&&9!==e.nodeType;)if(1===e.nodeType){if(o&&de(e).is(n))break;r.push(e)}return r},we=function(e,t){for(var n=[];e;e=e.nextSibling)1===e.nodeType&&e!==t&&n.push(e);return n},Ce=de.expr.match.needsContext,Te=/^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i,ke=/^.[^:#\[\.,]*$/;de.filter=function(e,t,n){var r=t[0];return n&&(e=":not("+e+")"),1===t.length&&1===r.nodeType?de.find.matchesSelector(r,e)?[r]:[]:de.find.matches(e,de.grep(t,function(e){return 1===e.nodeType}))},de.fn.extend({find:function(e){var t,n,r=this.length,o=this;if("string"!=typeof e)return this.pushStack(de(e).filter(function(){for(t=0;t<r;t++)if(de.contains(o[t],this))return!0}));for(n=this.pushStack([]),t=0;t<r;t++)de.find(e,o[t],n);return r>1?de.uniqueSort(n):n},filter:function(e){return this.pushStack(o(this,e||[],!1))},not:function(e){return this.pushStack(o(this,e||[],!0))},is:function(e){return!!o(this,"string"==typeof e&&Ce.test(e)?de(e):e||[],!1).length}});var je,Ee=/^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/,Ne=de.fn.init=function(e,t,n){var r,o;if(!e)return this;if(n=n||je,"string"==typeof e){if(r="<"===e[0]&&">"===e[e.length-1]&&e.length>=3?[null,e,null]:Ee.exec(e),!r||!r[1]&&t)return!t||t.jquery?(t||n).find(e):this.constructor(t).find(e);if(r[1]){if(t=t instanceof de?t[0]:t,de.merge(this,de.parseHTML(r[1],t&&t.nodeType?t.ownerDocument||t:te,!0)),Te.test(r[1])&&de.isPlainObject(t))for(r in t)de.isFunction(this[r])?this[r](t[r]):this.attr(r,t[r]);return this}return o=te.getElementById(r[2]),o&&(this[0]=o,this.length=1),this}return e.nodeType?(this[0]=e,this.length=1,this):de.isFunction(e)?void 0!==n.ready?n.ready(e):e(de):de.makeArray(e,this)};Ne.prototype=de.fn,je=de(te);var Se=/^(?:parents|prev(?:Until|All))/,Ae={children:!0,contents:!0,next:!0,prev:!0};de.fn.extend({has:function(e){var t=de(e,this),n=t.length;return this.filter(function(){for(var e=0;e<n;e++)if(de.contains(this,t[e]))return!0})},closest:function(e,t){var n,r=0,o=this.length,i=[],a="string"!=typeof e&&de(e);if(!Ce.test(e))for(;r<o;r++)for(n=this[r];n&&n!==t;n=n.parentNode)if(n.nodeType<11&&(a?a.index(n)>-1:1===n.nodeType&&de.find.matchesSelector(n,e))){i.push(n);break}return this.pushStack(i.length>1?de.uniqueSort(i):i)},index:function(e){return e?"string"==typeof e?ae.call(de(e),this[0]):ae.call(this,e.jquery?e[0]:e):this[0]&&this[0].parentNode?this.first().prevAll().length:-1},add:function(e,t){return this.pushStack(de.uniqueSort(de.merge(this.get(),de(e,t))))},addBack:function(e){return this.add(null==e?this.prevObject:this.prevObject.filter(e))}}),de.each({parent:function(e){var t=e.parentNode;return t&&11!==t.nodeType?t:null},parents:function(e){return xe(e,"parentNode")},parentsUntil:function(e,t,n){return xe(e,"parentNode",n)},next:function(e){return i(e,"nextSibling")},prev:function(e){return i(e,"previousSibling")},nextAll:function(e){return xe(e,"nextSibling")},prevAll:function(e){return xe(e,"previousSibling")},nextUntil:function(e,t,n){return xe(e,"nextSibling",n)},prevUntil:function(e,t,n){return xe(e,"previousSibling",n)},siblings:function(e){return we((e.parentNode||{}).firstChild,e)},children:function(e){return we(e.firstChild)},contents:function(e){return e.contentDocument||de.merge([],e.childNodes)}},function(e,t){de.fn[e]=function(n,r){var o=de.map(this,t,n);return"Until"!==e.slice(-5)&&(r=n),r&&"string"==typeof r&&(o=de.filter(r,o)),this.length>1&&(Ae[e]||de.uniqueSort(o),Se.test(e)&&o.reverse()),this.pushStack(o)}});var qe=/[^\x20\t\r\n\f]+/g;de.Callbacks=function(e){e="string"==typeof e?a(e):de.extend({},e);var t,n,r,o,i=[],s=[],u=-1,l=function(){for(o=e.once,r=t=!0;s.length;u=-1)for(n=s.shift();++u<i.length;)i[u].apply(n[0],n[1])===!1&&e.stopOnFalse&&(u=i.length,n=!1);e.memory||(n=!1),t=!1,o&&(i=n?[]:"")},c={add:function(){return i&&(n&&!t&&(u=i.length-1,s.push(n)),function t(n){de.each(n,function(n,r){de.isFunction(r)?e.unique&&c.has(r)||i.push(r):r&&r.length&&"string"!==de.type(r)&&t(r)})}(arguments),n&&!t&&l()),this},remove:function(){return de.each(arguments,function(e,t){for(var n;(n=de.inArray(t,i,n))>-1;)i.splice(n,1),n<=u&&u--}),this},has:function(e){return e?de.inArray(e,i)>-1:i.length>0},empty:function(){return i&&(i=[]),this},disable:function(){return o=s=[],i=n="",this},disabled:function(){return!i},lock:function(){return o=s=[],n||t||(i=n=""),this},locked:function(){return!!o},fireWith:function(e,n){return o||(n=n||[],n=[e,n.slice?n.slice():n],s.push(n),t||l()),this},fire:function(){return c.fireWith(this,arguments),this},fired:function(){return!!r}};return c},de.extend({Deferred:function(t){var n=[["notify","progress",de.Callbacks("memory"),de.Callbacks("memory"),2],["resolve","done",de.Callbacks("once memory"),de.Callbacks("once memory"),0,"resolved"],["reject","fail",de.Callbacks("once memory"),de.Callbacks("once memory"),1,"rejected"]],r="pending",o={state:function(){return r},always:function(){return i.done(arguments).fail(arguments),this},catch:function(e){return o.then(null,e)},pipe:function(){var e=arguments;return de.Deferred(function(t){de.each(n,function(n,r){var o=de.isFunction(e[r[4]])&&e[r[4]];i[r[1]](function(){var e=o&&o.apply(this,arguments);e&&de.isFunction(e.promise)?e.promise().progress(t.notify).done(t.resolve).fail(t.reject):t[r[0]+"With"](this,o?[e]:arguments)})}),e=null}).promise()},then:function(t,r,o){function i(t,n,r,o){return function(){var l=this,c=arguments,f=function(){var e,f;if(!(t<a)){if(e=r.apply(l,c),e===n.promise())throw new TypeError("Thenable self-resolution");f=e&&("object"==typeof e||"function"==typeof e)&&e.then,de.isFunction(f)?o?f.call(e,i(a,n,s,o),i(a,n,u,o)):(a++,f.call(e,i(a,n,s,o),i(a,n,u,o),i(a,n,s,n.notifyWith))):(r!==s&&(l=void 0,c=[e]),(o||n.resolveWith)(l,c))}},p=o?f:function(){try{f()}catch(e){de.Deferred.exceptionHook&&de.Deferred.exceptionHook(e,p.stackTrace),t+1>=a&&(r!==u&&(l=void 0,c=[e]),n.rejectWith(l,c))}};t?p():(de.Deferred.getStackHook&&(p.stackTrace=de.Deferred.getStackHook()),e.setTimeout(p))}}var a=0;return de.Deferred(function(e){n[0][3].add(i(0,e,de.isFunction(o)?o:s,e.notifyWith)),n[1][3].add(i(0,e,de.isFunction(t)?t:s)),n[2][3].add(i(0,e,de.isFunction(r)?r:u))}).promise()},promise:function(e){return null!=e?de.extend(e,o):o}},i={};return de.each(n,function(e,t){var a=t[2],s=t[5];o[t[1]]=a.add,s&&a.add(function(){r=s},n[3-e][2].disable,n[0][2].lock),a.add(t[3].fire),i[t[0]]=function(){return i[t[0]+"With"](this===i?void 0:this,arguments),this},i[t[0]+"With"]=a.fireWith}),o.promise(i),t&&t.call(i,i),i},when:function(e){var t=arguments.length,n=t,r=Array(n),o=re.call(arguments),i=de.Deferred(),a=function(e){return function(n){r[e]=this,o[e]=arguments.length>1?re.call(arguments):n,--t||i.resolveWith(r,o)}};if(t<=1&&(l(e,i.done(a(n)).resolve,i.reject),"pending"===i.state()||de.isFunction(o[n]&&o[n].then)))return i.then();for(;n--;)l(o[n],a(n),i.reject);return i.promise()}});var De=/^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;de.Deferred.exceptionHook=function(t,n){e.console&&e.console.warn&&t&&De.test(t.name)&&e.console.warn("jQuery.Deferred exception: "+t.message,t.stack,n)},de.readyException=function(t){e.setTimeout(function(){throw t})};var Oe=de.Deferred();de.fn.ready=function(e){return Oe.then(e).catch(function(e){de.readyException(e)}),this},de.extend({isReady:!1,readyWait:1,holdReady:function(e){e?de.readyWait++:de.ready(!0)},ready:function(e){(e===!0?--de.readyWait:de.isReady)||(de.isReady=!0,e!==!0&&--de.readyWait>0||Oe.resolveWith(te,[de]))}}),de.ready.then=Oe.then,"complete"===te.readyState||"loading"!==te.readyState&&!te.documentElement.doScroll?e.setTimeout(de.ready):(te.addEventListener("DOMContentLoaded",c),e.addEventListener("load",c));var Le=function(e,t,n,r,o,i,a){var s=0,u=e.length,l=null==n;if("object"===de.type(n)){o=!0;for(s in n)Le(e,t,s,n[s],!0,i,a)}else if(void 0!==r&&(o=!0,de.isFunction(r)||(a=!0),l&&(a?(t.call(e,r),t=null):(l=t,t=function(e,t,n){return l.call(de(e),n)})),t))for(;s<u;s++)t(e[s],n,a?r:r.call(e[s],s,t(e[s],n)));return o?e:l?t.call(e):u?t(e[0],n):i},He=function(e){return 1===e.nodeType||9===e.nodeType||!+e.nodeType};f.uid=1,f.prototype={cache:function(e){var t=e[this.expando];return t||(t={},He(e)&&(e.nodeType?e[this.expando]=t:Object.defineProperty(e,this.expando,{value:t,configurable:!0}))),t},set:function(e,t,n){var r,o=this.cache(e);if("string"==typeof t)o[de.camelCase(t)]=n;else for(r in t)o[de.camelCase(r)]=t[r];return o},get:function(e,t){return void 0===t?this.cache(e):e[this.expando]&&e[this.expando][de.camelCase(t)]},access:function(e,t,n){return void 0===t||t&&"string"==typeof t&&void 0===n?this.get(e,t):(this.set(e,t,n),void 0!==n?n:t)},remove:function(e,t){var n,r=e[this.expando];if(void 0!==r){if(void 0!==t){de.isArray(t)?t=t.map(de.camelCase):(t=de.camelCase(t),t=t in r?[t]:t.match(qe)||[]),n=t.length;for(;n--;)delete r[t[n]]}(void 0===t||de.isEmptyObject(r))&&(e.nodeType?e[this.expando]=void 0:delete e[this.expando])}},hasData:function(e){var t=e[this.expando];return void 0!==t&&!de.isEmptyObject(t)}};var Fe=new f,Pe=new f,Ie=/^(?:\{[\w\W]*\}|\[[\w\W]*\])$/,Re=/[A-Z]/g;de.extend({hasData:function(e){return Pe.hasData(e)||Fe.hasData(e)},data:function(e,t,n){return Pe.access(e,t,n)},removeData:function(e,t){Pe.remove(e,t)},_data:function(e,t,n){return Fe.access(e,t,n)},_removeData:function(e,t){Fe.remove(e,t)}}),de.fn.extend({data:function(e,t){var n,r,o,i=this[0],a=i&&i.attributes;if(void 0===e){if(this.length&&(o=Pe.get(i),1===i.nodeType&&!Fe.get(i,"hasDataAttrs"))){for(n=a.length;n--;)a[n]&&(r=a[n].name,0===r.indexOf("data-")&&(r=de.camelCase(r.slice(5)),h(i,r,o[r])));Fe.set(i,"hasDataAttrs",!0)}return o}return"object"==typeof e?this.each(function(){Pe.set(this,e)}):Le(this,function(t){var n;if(i&&void 0===t){if(n=Pe.get(i,e),void 0!==n)return n;if(n=h(i,e),void 0!==n)return n}else this.each(function(){Pe.set(this,e,t)})},null,t,arguments.length>1,null,!0)},removeData:function(e){return this.each(function(){Pe.remove(this,e)})}}),de.extend({queue:function(e,t,n){var r;if(e)return t=(t||"fx")+"queue",r=Fe.get(e,t),n&&(!r||de.isArray(n)?r=Fe.access(e,t,de.makeArray(n)):r.push(n)),r||[]},dequeue:function(e,t){t=t||"fx";var n=de.queue(e,t),r=n.length,o=n.shift(),i=de._queueHooks(e,t),a=function(){de.dequeue(e,t)};"inprogress"===o&&(o=n.shift(),r--),o&&("fx"===t&&n.unshift("inprogress"),delete i.stop,o.call(e,a,i)),!r&&i&&i.empty.fire()},_queueHooks:function(e,t){var n=t+"queueHooks";return Fe.get(e,n)||Fe.access(e,n,{empty:de.Callbacks("once memory").add(function(){Fe.remove(e,[t+"queue",n])})})}}),de.fn.extend({queue:function(e,t){var n=2;return"string"!=typeof e&&(t=e,e="fx",n--),arguments.length<n?de.queue(this[0],e):void 0===t?this:this.each(function(){var n=de.queue(this,e,t);de._queueHooks(this,e),"fx"===e&&"inprogress"!==n[0]&&de.dequeue(this,e)})},dequeue:function(e){return this.each(function(){de.dequeue(this,e)})},clearQueue:function(e){return this.queue(e||"fx",[])},promise:function(e,t){var n,r=1,o=de.Deferred(),i=this,a=this.length,s=function(){--r||o.resolveWith(i,[i])};for("string"!=typeof e&&(t=e,e=void 0),e=e||"fx";a--;)n=Fe.get(i[a],e+"queueHooks"),n&&n.empty&&(r++,n.empty.add(s));return s(),o.promise(t)}});var Me=/[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/.source,$e=new RegExp("^(?:([+-])=|)("+Me+")([a-z%]*)$","i"),_e=["Top","Right","Bottom","Left"],We=function(e,t){return e=t||e,"none"===e.style.display||""===e.style.display&&de.contains(e.ownerDocument,e)&&"none"===de.css(e,"display")},Be=function(e,t,n,r){var o,i,a={};for(i in t)a[i]=e.style[i],e.style[i]=t[i];o=n.apply(e,r||[]);for(i in t)e.style[i]=a[i];return o},Ue={};de.fn.extend({show:function(){return m(this,!0)},hide:function(){return m(this)},toggle:function(e){return"boolean"==typeof e?e?this.show():this.hide():this.each(function(){We(this)?de(this).show():de(this).hide()})}});var ze=/^(?:checkbox|radio)$/i,Xe=/<([a-z][^\/\0>\x20\t\r\n\f]+)/i,Ke=/^$|\/(?:java|ecma)script/i,Ve={option:[1,"<select multiple='multiple'>","</select>"],thead:[1,"<table>","</table>"],col:[2,"<table><colgroup>","</colgroup></table>"],tr:[2,"<table><tbody>","</tbody></table>"],td:[3,"<table><tbody><tr>","</tr></tbody></table>"],_default:[0,"",""]};Ve.optgroup=Ve.option,Ve.tbody=Ve.tfoot=Ve.colgroup=Ve.caption=Ve.thead,Ve.th=Ve.td;var Ge=/<|&#?\w+;/;!function(){var e=te.createDocumentFragment(),t=e.appendChild(te.createElement("div")),n=te.createElement("input");n.setAttribute("type","radio"),n.setAttribute("checked","checked"),n.setAttribute("name","t"),t.appendChild(n),pe.checkClone=t.cloneNode(!0).cloneNode(!0).lastChild.checked,t.innerHTML="<textarea>x</textarea>",pe.noCloneChecked=!!t.cloneNode(!0).lastChild.defaultValue}();var Ye=te.documentElement,Qe=/^key/,Je=/^(?:mouse|pointer|contextmenu|drag|drop)|click/,Ze=/^([^.]*)(?:\.(.+)|)/;de.event={global:{},add:function(e,t,n,r,o){var i,a,s,u,l,c,f,p,h,d,g,m=Fe.get(e);if(m)for(n.handler&&(i=n,n=i.handler,o=i.selector),o&&de.find.matchesSelector(Ye,o),n.guid||(n.guid=de.guid++),(u=m.events)||(u=m.events={}),(a=m.handle)||(a=m.handle=function(t){return"undefined"!=typeof de&&de.event.triggered!==t.type?de.event.dispatch.apply(e,arguments):void 0}),t=(t||"").match(qe)||[""],l=t.length;l--;)s=Ze.exec(t[l])||[],h=g=s[1],d=(s[2]||"").split(".").sort(),h&&(f=de.event.special[h]||{},h=(o?f.delegateType:f.bindType)||h,f=de.event.special[h]||{},c=de.extend({type:h,origType:g,data:r,handler:n,guid:n.guid,selector:o,needsContext:o&&de.expr.match.needsContext.test(o),namespace:d.join(".")},i),(p=u[h])||(p=u[h]=[],p.delegateCount=0,f.setup&&f.setup.call(e,r,d,a)!==!1||e.addEventListener&&e.addEventListener(h,a)),f.add&&(f.add.call(e,c),c.handler.guid||(c.handler.guid=n.guid)),o?p.splice(p.delegateCount++,0,c):p.push(c),de.event.global[h]=!0)},remove:function(e,t,n,r,o){var i,a,s,u,l,c,f,p,h,d,g,m=Fe.hasData(e)&&Fe.get(e);if(m&&(u=m.events)){for(t=(t||"").match(qe)||[""],l=t.length;l--;)if(s=Ze.exec(t[l])||[],h=g=s[1],d=(s[2]||"").split(".").sort(),h){for(f=de.event.special[h]||{},h=(r?f.delegateType:f.bindType)||h,p=u[h]||[],s=s[2]&&new RegExp("(^|\\.)"+d.join("\\.(?:.*\\.|)")+"(\\.|$)"),a=i=p.length;i--;)c=p[i],!o&&g!==c.origType||n&&n.guid!==c.guid||s&&!s.test(c.namespace)||r&&r!==c.selector&&("**"!==r||!c.selector)||(p.splice(i,1),c.selector&&p.delegateCount--,f.remove&&f.remove.call(e,c));a&&!p.length&&(f.teardown&&f.teardown.call(e,d,m.handle)!==!1||de.removeEvent(e,h,m.handle),delete u[h])}else for(h in u)de.event.remove(e,h+t[l],n,r,!0);de.isEmptyObject(u)&&Fe.remove(e,"handle events")}},dispatch:function(e){var t,n,r,o,i,a,s=de.event.fix(e),u=new Array(arguments.length),l=(Fe.get(this,"events")||{})[s.type]||[],c=de.event.special[s.type]||{};for(u[0]=s,t=1;t<arguments.length;t++)u[t]=arguments[t];if(s.delegateTarget=this,!c.preDispatch||c.preDispatch.call(this,s)!==!1){for(a=de.event.handlers.call(this,s,l),t=0;(o=a[t++])&&!s.isPropagationStopped();)for(s.currentTarget=o.elem,n=0;(i=o.handlers[n++])&&!s.isImmediatePropagationStopped();)s.rnamespace&&!s.rnamespace.test(i.namespace)||(s.handleObj=i,s.data=i.data,r=((de.event.special[i.origType]||{}).handle||i.handler).apply(o.elem,u),void 0!==r&&(s.result=r)===!1&&(s.preventDefault(),s.stopPropagation()));return c.postDispatch&&c.postDispatch.call(this,s),s.result}},handlers:function(e,t){var n,r,o,i,a,s=[],u=t.delegateCount,l=e.target;if(u&&l.nodeType&&!("click"===e.type&&e.button>=1))for(;l!==this;l=l.parentNode||this)if(1===l.nodeType&&("click"!==e.type||l.disabled!==!0)){for(i=[],a={},n=0;n<u;n++)r=t[n],o=r.selector+" ",void 0===a[o]&&(a[o]=r.needsContext?de(o,this).index(l)>-1:de.find(o,this,null,[l]).length),a[o]&&i.push(r);i.length&&s.push({elem:l,handlers:i})}return l=this,u<t.length&&s.push({elem:l,handlers:t.slice(u)}),s},addProp:function(e,t){Object.defineProperty(de.Event.prototype,e,{enumerable:!0,configurable:!0,get:de.isFunction(t)?function(){if(this.originalEvent)return t(this.originalEvent)}:function(){if(this.originalEvent)return this.originalEvent[e]},set:function(t){Object.defineProperty(this,e,{enumerable:!0,configurable:!0,writable:!0,value:t})}})},fix:function(e){return e[de.expando]?e:new de.Event(e)},special:{load:{noBubble:!0},focus:{trigger:function(){if(this!==C()&&this.focus)return this.focus(),!1},delegateType:"focusin"},blur:{trigger:function(){if(this===C()&&this.blur)return this.blur(),!1},delegateType:"focusout"},click:{trigger:function(){if("checkbox"===this.type&&this.click&&de.nodeName(this,"input"))return this.click(),!1},_default:function(e){return de.nodeName(e.target,"a")}},beforeunload:{postDispatch:function(e){void 0!==e.result&&e.originalEvent&&(e.originalEvent.returnValue=e.result)}}}},de.removeEvent=function(e,t,n){e.removeEventListener&&e.removeEventListener(t,n)},de.Event=function(e,t){return this instanceof de.Event?(e&&e.type?(this.originalEvent=e,this.type=e.type,this.isDefaultPrevented=e.defaultPrevented||void 0===e.defaultPrevented&&e.returnValue===!1?x:w,this.target=e.target&&3===e.target.nodeType?e.target.parentNode:e.target,this.currentTarget=e.currentTarget,this.relatedTarget=e.relatedTarget):this.type=e,t&&de.extend(this,t),this.timeStamp=e&&e.timeStamp||de.now(),void(this[de.expando]=!0)):new de.Event(e,t)},de.Event.prototype={constructor:de.Event,isDefaultPrevented:w,isPropagationStopped:w,isImmediatePropagationStopped:w,isSimulated:!1,preventDefault:function(){var e=this.originalEvent;this.isDefaultPrevented=x,e&&!this.isSimulated&&e.preventDefault()},stopPropagation:function(){var e=this.originalEvent;this.isPropagationStopped=x,e&&!this.isSimulated&&e.stopPropagation()},stopImmediatePropagation:function(){var e=this.originalEvent;this.isImmediatePropagationStopped=x,e&&!this.isSimulated&&e.stopImmediatePropagation(),this.stopPropagation()}},de.each({altKey:!0,bubbles:!0,cancelable:!0,changedTouches:!0,ctrlKey:!0,detail:!0,eventPhase:!0,metaKey:!0,pageX:!0,pageY:!0,shiftKey:!0,view:!0,char:!0,charCode:!0,key:!0,keyCode:!0,button:!0,buttons:!0,clientX:!0,clientY:!0,offsetX:!0,offsetY:!0,pointerId:!0,pointerType:!0,screenX:!0,screenY:!0,targetTouches:!0,toElement:!0,touches:!0,which:function(e){var t=e.button;return null==e.which&&Qe.test(e.type)?null!=e.charCode?e.charCode:e.keyCode:!e.which&&void 0!==t&&Je.test(e.type)?1&t?1:2&t?3:4&t?2:0:e.which}},de.event.addProp),de.each({mouseenter:"mouseover",mouseleave:"mouseout",pointerenter:"pointerover",pointerleave:"pointerout"},function(e,t){de.event.special[e]={delegateType:t,bindType:t,handle:function(e){var n,r=this,o=e.relatedTarget,i=e.handleObj;return o&&(o===r||de.contains(r,o))||(e.type=i.origType,n=i.handler.apply(this,arguments),e.type=t),n}}}),de.fn.extend({on:function(e,t,n,r){return T(this,e,t,n,r)},one:function(e,t,n,r){return T(this,e,t,n,r,1)},off:function(e,t,n){var r,o;if(e&&e.preventDefault&&e.handleObj)return r=e.handleObj,de(e.delegateTarget).off(r.namespace?r.origType+"."+r.namespace:r.origType,r.selector,r.handler),this;if("object"==typeof e){for(o in e)this.off(o,t,e[o]);return this}return t!==!1&&"function"!=typeof t||(n=t,t=void 0),n===!1&&(n=w),this.each(function(){de.event.remove(this,e,n,t)})}});var et=/<(?!area|br|col|embed|hr|img|input|link|meta|param)(([a-z][^\/\0>\x20\t\r\n\f]*)[^>]*)\/>/gi,tt=/<script|<style|<link/i,nt=/checked\s*(?:[^=]|=\s*.checked.)/i,rt=/^true\/(.*)/,ot=/^\s*<!(?:\[CDATA\[|--)|(?:\]\]|--)>\s*$/g;de.extend({htmlPrefilter:function(e){return e.replace(et,"<$1></$2>")},clone:function(e,t,n){var r,o,i,a,s=e.cloneNode(!0),u=de.contains(e.ownerDocument,e);if(!(pe.noCloneChecked||1!==e.nodeType&&11!==e.nodeType||de.isXMLDoc(e)))for(a=v(s),i=v(e),r=0,o=i.length;r<o;r++)S(i[r],a[r]);if(t)if(n)for(i=i||v(e),a=a||v(s),r=0,o=i.length;r<o;r++)N(i[r],a[r]);else N(e,s);return a=v(s,"script"),a.length>0&&y(a,!u&&v(e,"script")),s},cleanData:function(e){for(var t,n,r,o=de.event.special,i=0;void 0!==(n=e[i]);i++)if(He(n)){if(t=n[Fe.expando]){if(t.events)for(r in t.events)o[r]?de.event.remove(n,r):de.removeEvent(n,r,t.handle);n[Fe.expando]=void 0}n[Pe.expando]&&(n[Pe.expando]=void 0)}}}),de.fn.extend({detach:function(e){return q(this,e,!0)},remove:function(e){return q(this,e)},text:function(e){return Le(this,function(e){return void 0===e?de.text(this):this.empty().each(function(){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||(this.textContent=e)})},null,e,arguments.length)},append:function(){return A(this,arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=k(this,e);t.appendChild(e)}})},prepend:function(){return A(this,arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=k(this,e);t.insertBefore(e,t.firstChild)}})},before:function(){return A(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this)})},after:function(){return A(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this.nextSibling)})},empty:function(){for(var e,t=0;null!=(e=this[t]);t++)1===e.nodeType&&(de.cleanData(v(e,!1)),e.textContent="");return this},clone:function(e,t){return e=null!=e&&e,t=null==t?e:t,this.map(function(){return de.clone(this,e,t)})},html:function(e){return Le(this,function(e){var t=this[0]||{},n=0,r=this.length;if(void 0===e&&1===t.nodeType)return t.innerHTML;if("string"==typeof e&&!tt.test(e)&&!Ve[(Xe.exec(e)||["",""])[1].toLowerCase()]){e=de.htmlPrefilter(e);try{for(;n<r;n++)t=this[n]||{},1===t.nodeType&&(de.cleanData(v(t,!1)),t.innerHTML=e);t=0}catch(e){}}t&&this.empty().append(e)},null,e,arguments.length)},replaceWith:function(){var e=[];return A(this,arguments,function(t){var n=this.parentNode;de.inArray(this,e)<0&&(de.cleanData(v(this)),n&&n.replaceChild(t,this))},e)}}),de.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(e,t){de.fn[e]=function(e){for(var n,r=[],o=de(e),i=o.length-1,a=0;a<=i;a++)n=a===i?this:this.clone(!0),de(o[a])[t](n),ie.apply(r,n.get());return this.pushStack(r)}});var it=/^margin/,at=new RegExp("^("+Me+")(?!px)[a-z%]+$","i"),st=function(t){var n=t.ownerDocument.defaultView;return n&&n.opener||(n=e),n.getComputedStyle(t)};!function(){function t(){if(s){s.style.cssText="box-sizing:border-box;position:relative;display:block;margin:auto;border:1px;padding:1px;top:1%;width:50%",s.innerHTML="",Ye.appendChild(a);var t=e.getComputedStyle(s);n="1%"!==t.top,i="2px"===t.marginLeft,r="4px"===t.width,s.style.marginRight="50%",o="4px"===t.marginRight,Ye.removeChild(a),s=null}}var n,r,o,i,a=te.createElement("div"),s=te.createElement("div");s.style&&(s.style.backgroundClip="content-box",s.cloneNode(!0).style.backgroundClip="",pe.clearCloneStyle="content-box"===s.style.backgroundClip,a.style.cssText="border:0;width:8px;height:0;top:0;left:-9999px;padding:0;margin-top:1px;position:absolute",a.appendChild(s),de.extend(pe,{pixelPosition:function(){return t(),n},boxSizingReliable:function(){return t(),r},pixelMarginRight:function(){return t(),o},reliableMarginLeft:function(){return t(),i}}))}();var ut=/^(none|table(?!-c[ea]).+)/,lt={position:"absolute",visibility:"hidden",display:"block"},ct={letterSpacing:"0",fontWeight:"400"},ft=["Webkit","Moz","ms"],pt=te.createElement("div").style;de.extend({cssHooks:{opacity:{get:function(e,t){if(t){var n=D(e,"opacity");return""===n?"1":n}}}},cssNumber:{animationIterationCount:!0,columnCount:!0,fillOpacity:!0,flexGrow:!0,flexShrink:!0,fontWeight:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{float:"cssFloat"},style:function(e,t,n,r){if(e&&3!==e.nodeType&&8!==e.nodeType&&e.style){var o,i,a,s=de.camelCase(t),u=e.style;return t=de.cssProps[s]||(de.cssProps[s]=L(s)||s),a=de.cssHooks[t]||de.cssHooks[s],void 0===n?a&&"get"in a&&void 0!==(o=a.get(e,!1,r))?o:u[t]:(i=typeof n,"string"===i&&(o=$e.exec(n))&&o[1]&&(n=d(e,t,o),i="number"),null!=n&&n===n&&("number"===i&&(n+=o&&o[3]||(de.cssNumber[s]?"":"px")),pe.clearCloneStyle||""!==n||0!==t.indexOf("background")||(u[t]="inherit"),a&&"set"in a&&void 0===(n=a.set(e,n,r))||(u[t]=n)),void 0)}},css:function(e,t,n,r){var o,i,a,s=de.camelCase(t);return t=de.cssProps[s]||(de.cssProps[s]=L(s)||s),a=de.cssHooks[t]||de.cssHooks[s],a&&"get"in a&&(o=a.get(e,!0,n)),void 0===o&&(o=D(e,t,r)),"normal"===o&&t in ct&&(o=ct[t]),""===n||n?(i=parseFloat(o),n===!0||isFinite(i)?i||0:o):o}}),de.each(["height","width"],function(e,t){de.cssHooks[t]={get:function(e,n,r){if(n)return!ut.test(de.css(e,"display"))||e.getClientRects().length&&e.getBoundingClientRect().width?P(e,t,r):Be(e,lt,function(){return P(e,t,r)})},set:function(e,n,r){var o,i=r&&st(e),a=r&&F(e,t,r,"border-box"===de.css(e,"boxSizing",!1,i),i);return a&&(o=$e.exec(n))&&"px"!==(o[3]||"px")&&(e.style[t]=n,n=de.css(e,t)),H(e,n,a)}}}),de.cssHooks.marginLeft=O(pe.reliableMarginLeft,function(e,t){if(t)return(parseFloat(D(e,"marginLeft"))||e.getBoundingClientRect().left-Be(e,{marginLeft:0},function(){return e.getBoundingClientRect().left}))+"px"}),de.each({margin:"",padding:"",border:"Width"},function(e,t){de.cssHooks[e+t]={expand:function(n){for(var r=0,o={},i="string"==typeof n?n.split(" "):[n];r<4;r++)o[e+_e[r]+t]=i[r]||i[r-2]||i[0];return o}},it.test(e)||(de.cssHooks[e+t].set=H)}),de.fn.extend({css:function(e,t){return Le(this,function(e,t,n){var r,o,i={},a=0;if(de.isArray(t)){for(r=st(e),o=t.length;a<o;a++)i[t[a]]=de.css(e,t[a],!1,r);return i}return void 0!==n?de.style(e,t,n):de.css(e,t)},e,t,arguments.length>1)}}),de.Tween=I,I.prototype={constructor:I,init:function(e,t,n,r,o,i){this.elem=e,this.prop=n,this.easing=o||de.easing._default,this.options=t,this.start=this.now=this.cur(),this.end=r,this.unit=i||(de.cssNumber[n]?"":"px")},cur:function(){var e=I.propHooks[this.prop];return e&&e.get?e.get(this):I.propHooks._default.get(this)},run:function(e){var t,n=I.propHooks[this.prop];return this.options.duration?this.pos=t=de.easing[this.easing](e,this.options.duration*e,0,1,this.options.duration):this.pos=t=e,this.now=(this.end-this.start)*t+this.start,this.options.step&&this.options.step.call(this.elem,this.now,this),n&&n.set?n.set(this):I.propHooks._default.set(this),this}},I.prototype.init.prototype=I.prototype,I.propHooks={_default:{get:function(e){var t;return 1!==e.elem.nodeType||null!=e.elem[e.prop]&&null==e.elem.style[e.prop]?e.elem[e.prop]:(t=de.css(e.elem,e.prop,""),t&&"auto"!==t?t:0)},set:function(e){de.fx.step[e.prop]?de.fx.step[e.prop](e):1!==e.elem.nodeType||null==e.elem.style[de.cssProps[e.prop]]&&!de.cssHooks[e.prop]?e.elem[e.prop]=e.now:de.style(e.elem,e.prop,e.now+e.unit)}}},I.propHooks.scrollTop=I.propHooks.scrollLeft={set:function(e){e.elem.nodeType&&e.elem.parentNode&&(e.elem[e.prop]=e.now)}},de.easing={linear:function(e){return e},swing:function(e){return.5-Math.cos(e*Math.PI)/2},_default:"swing"},de.fx=I.prototype.init,de.fx.step={};var ht,dt,gt=/^(?:toggle|show|hide)$/,mt=/queueHooks$/;de.Animation=de.extend(U,{tweeners:{"*":[function(e,t){var n=this.createTween(e,t);return d(n.elem,e,$e.exec(t),n),n}]},tweener:function(e,t){de.isFunction(e)?(t=e,e=["*"]):e=e.match(qe);for(var n,r=0,o=e.length;r<o;r++)n=e[r],U.tweeners[n]=U.tweeners[n]||[],U.tweeners[n].unshift(t)},prefilters:[W],prefilter:function(e,t){t?U.prefilters.unshift(e):U.prefilters.push(e)}}),de.speed=function(e,t,n){var r=e&&"object"==typeof e?de.extend({},e):{complete:n||!n&&t||de.isFunction(e)&&e,duration:e,easing:n&&t||t&&!de.isFunction(t)&&t};return de.fx.off||te.hidden?r.duration=0:"number"!=typeof r.duration&&(r.duration in de.fx.speeds?r.duration=de.fx.speeds[r.duration]:r.duration=de.fx.speeds._default),null!=r.queue&&r.queue!==!0||(r.queue="fx"),r.old=r.complete,r.complete=function(){de.isFunction(r.old)&&r.old.call(this),r.queue&&de.dequeue(this,r.queue)},r},de.fn.extend({fadeTo:function(e,t,n,r){return this.filter(We).css("opacity",0).show().end().animate({opacity:t},e,n,r)},animate:function(e,t,n,r){
+var o=de.isEmptyObject(e),i=de.speed(t,n,r),a=function(){var t=U(this,de.extend({},e),i);(o||Fe.get(this,"finish"))&&t.stop(!0)};return a.finish=a,o||i.queue===!1?this.each(a):this.queue(i.queue,a)},stop:function(e,t,n){var r=function(e){var t=e.stop;delete e.stop,t(n)};return"string"!=typeof e&&(n=t,t=e,e=void 0),t&&e!==!1&&this.queue(e||"fx",[]),this.each(function(){var t=!0,o=null!=e&&e+"queueHooks",i=de.timers,a=Fe.get(this);if(o)a[o]&&a[o].stop&&r(a[o]);else for(o in a)a[o]&&a[o].stop&&mt.test(o)&&r(a[o]);for(o=i.length;o--;)i[o].elem!==this||null!=e&&i[o].queue!==e||(i[o].anim.stop(n),t=!1,i.splice(o,1));!t&&n||de.dequeue(this,e)})},finish:function(e){return e!==!1&&(e=e||"fx"),this.each(function(){var t,n=Fe.get(this),r=n[e+"queue"],o=n[e+"queueHooks"],i=de.timers,a=r?r.length:0;for(n.finish=!0,de.queue(this,e,[]),o&&o.stop&&o.stop.call(this,!0),t=i.length;t--;)i[t].elem===this&&i[t].queue===e&&(i[t].anim.stop(!0),i.splice(t,1));for(t=0;t<a;t++)r[t]&&r[t].finish&&r[t].finish.call(this);delete n.finish})}}),de.each(["toggle","show","hide"],function(e,t){var n=de.fn[t];de.fn[t]=function(e,r,o){return null==e||"boolean"==typeof e?n.apply(this,arguments):this.animate($(t,!0),e,r,o)}}),de.each({slideDown:$("show"),slideUp:$("hide"),slideToggle:$("toggle"),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"},fadeToggle:{opacity:"toggle"}},function(e,t){de.fn[e]=function(e,n,r){return this.animate(t,e,n,r)}}),de.timers=[],de.fx.tick=function(){var e,t=0,n=de.timers;for(ht=de.now();t<n.length;t++)e=n[t],e()||n[t]!==e||n.splice(t--,1);n.length||de.fx.stop(),ht=void 0},de.fx.timer=function(e){de.timers.push(e),e()?de.fx.start():de.timers.pop()},de.fx.interval=13,de.fx.start=function(){dt||(dt=e.requestAnimationFrame?e.requestAnimationFrame(R):e.setInterval(de.fx.tick,de.fx.interval))},de.fx.stop=function(){e.cancelAnimationFrame?e.cancelAnimationFrame(dt):e.clearInterval(dt),dt=null},de.fx.speeds={slow:600,fast:200,_default:400},de.fn.delay=function(t,n){return t=de.fx?de.fx.speeds[t]||t:t,n=n||"fx",this.queue(n,function(n,r){var o=e.setTimeout(n,t);r.stop=function(){e.clearTimeout(o)}})},function(){var e=te.createElement("input"),t=te.createElement("select"),n=t.appendChild(te.createElement("option"));e.type="checkbox",pe.checkOn=""!==e.value,pe.optSelected=n.selected,e=te.createElement("input"),e.value="t",e.type="radio",pe.radioValue="t"===e.value}();var vt,yt=de.expr.attrHandle;de.fn.extend({attr:function(e,t){return Le(this,de.attr,e,t,arguments.length>1)},removeAttr:function(e){return this.each(function(){de.removeAttr(this,e)})}}),de.extend({attr:function(e,t,n){var r,o,i=e.nodeType;if(3!==i&&8!==i&&2!==i)return"undefined"==typeof e.getAttribute?de.prop(e,t,n):(1===i&&de.isXMLDoc(e)||(o=de.attrHooks[t.toLowerCase()]||(de.expr.match.bool.test(t)?vt:void 0)),void 0!==n?null===n?void de.removeAttr(e,t):o&&"set"in o&&void 0!==(r=o.set(e,n,t))?r:(e.setAttribute(t,n+""),n):o&&"get"in o&&null!==(r=o.get(e,t))?r:(r=de.find.attr(e,t),null==r?void 0:r))},attrHooks:{type:{set:function(e,t){if(!pe.radioValue&&"radio"===t&&de.nodeName(e,"input")){var n=e.value;return e.setAttribute("type",t),n&&(e.value=n),t}}}},removeAttr:function(e,t){var n,r=0,o=t&&t.match(qe);if(o&&1===e.nodeType)for(;n=o[r++];)e.removeAttribute(n)}}),vt={set:function(e,t,n){return t===!1?de.removeAttr(e,n):e.setAttribute(n,n),n}},de.each(de.expr.match.bool.source.match(/\w+/g),function(e,t){var n=yt[t]||de.find.attr;yt[t]=function(e,t,r){var o,i,a=t.toLowerCase();return r||(i=yt[a],yt[a]=o,o=null!=n(e,t,r)?a:null,yt[a]=i),o}});var bt=/^(?:input|select|textarea|button)$/i,xt=/^(?:a|area)$/i;de.fn.extend({prop:function(e,t){return Le(this,de.prop,e,t,arguments.length>1)},removeProp:function(e){return this.each(function(){delete this[de.propFix[e]||e]})}}),de.extend({prop:function(e,t,n){var r,o,i=e.nodeType;if(3!==i&&8!==i&&2!==i)return 1===i&&de.isXMLDoc(e)||(t=de.propFix[t]||t,o=de.propHooks[t]),void 0!==n?o&&"set"in o&&void 0!==(r=o.set(e,n,t))?r:e[t]=n:o&&"get"in o&&null!==(r=o.get(e,t))?r:e[t]},propHooks:{tabIndex:{get:function(e){var t=de.find.attr(e,"tabindex");return t?parseInt(t,10):bt.test(e.nodeName)||xt.test(e.nodeName)&&e.href?0:-1}}},propFix:{for:"htmlFor",class:"className"}}),pe.optSelected||(de.propHooks.selected={get:function(e){var t=e.parentNode;return t&&t.parentNode&&t.parentNode.selectedIndex,null},set:function(e){var t=e.parentNode;t&&(t.selectedIndex,t.parentNode&&t.parentNode.selectedIndex)}}),de.each(["tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable"],function(){de.propFix[this.toLowerCase()]=this}),de.fn.extend({addClass:function(e){var t,n,r,o,i,a,s,u=0;if(de.isFunction(e))return this.each(function(t){de(this).addClass(e.call(this,t,X(this)))});if("string"==typeof e&&e)for(t=e.match(qe)||[];n=this[u++];)if(o=X(n),r=1===n.nodeType&&" "+z(o)+" "){for(a=0;i=t[a++];)r.indexOf(" "+i+" ")<0&&(r+=i+" ");s=z(r),o!==s&&n.setAttribute("class",s)}return this},removeClass:function(e){var t,n,r,o,i,a,s,u=0;if(de.isFunction(e))return this.each(function(t){de(this).removeClass(e.call(this,t,X(this)))});if(!arguments.length)return this.attr("class","");if("string"==typeof e&&e)for(t=e.match(qe)||[];n=this[u++];)if(o=X(n),r=1===n.nodeType&&" "+z(o)+" "){for(a=0;i=t[a++];)for(;r.indexOf(" "+i+" ")>-1;)r=r.replace(" "+i+" "," ");s=z(r),o!==s&&n.setAttribute("class",s)}return this},toggleClass:function(e,t){var n=typeof e;return"boolean"==typeof t&&"string"===n?t?this.addClass(e):this.removeClass(e):de.isFunction(e)?this.each(function(n){de(this).toggleClass(e.call(this,n,X(this),t),t)}):this.each(function(){var t,r,o,i;if("string"===n)for(r=0,o=de(this),i=e.match(qe)||[];t=i[r++];)o.hasClass(t)?o.removeClass(t):o.addClass(t);else void 0!==e&&"boolean"!==n||(t=X(this),t&&Fe.set(this,"__className__",t),this.setAttribute&&this.setAttribute("class",t||e===!1?"":Fe.get(this,"__className__")||""))})},hasClass:function(e){var t,n,r=0;for(t=" "+e+" ";n=this[r++];)if(1===n.nodeType&&(" "+z(X(n))+" ").indexOf(t)>-1)return!0;return!1}});var wt=/\r/g;de.fn.extend({val:function(e){var t,n,r,o=this[0];{if(arguments.length)return r=de.isFunction(e),this.each(function(n){var o;1===this.nodeType&&(o=r?e.call(this,n,de(this).val()):e,null==o?o="":"number"==typeof o?o+="":de.isArray(o)&&(o=de.map(o,function(e){return null==e?"":e+""})),t=de.valHooks[this.type]||de.valHooks[this.nodeName.toLowerCase()],t&&"set"in t&&void 0!==t.set(this,o,"value")||(this.value=o))});if(o)return t=de.valHooks[o.type]||de.valHooks[o.nodeName.toLowerCase()],t&&"get"in t&&void 0!==(n=t.get(o,"value"))?n:(n=o.value,"string"==typeof n?n.replace(wt,""):null==n?"":n)}}}),de.extend({valHooks:{option:{get:function(e){var t=de.find.attr(e,"value");return null!=t?t:z(de.text(e))}},select:{get:function(e){var t,n,r,o=e.options,i=e.selectedIndex,a="select-one"===e.type,s=a?null:[],u=a?i+1:o.length;for(r=i<0?u:a?i:0;r<u;r++)if(n=o[r],(n.selected||r===i)&&!n.disabled&&(!n.parentNode.disabled||!de.nodeName(n.parentNode,"optgroup"))){if(t=de(n).val(),a)return t;s.push(t)}return s},set:function(e,t){for(var n,r,o=e.options,i=de.makeArray(t),a=o.length;a--;)r=o[a],(r.selected=de.inArray(de.valHooks.option.get(r),i)>-1)&&(n=!0);return n||(e.selectedIndex=-1),i}}}}),de.each(["radio","checkbox"],function(){de.valHooks[this]={set:function(e,t){if(de.isArray(t))return e.checked=de.inArray(de(e).val(),t)>-1}},pe.checkOn||(de.valHooks[this].get=function(e){return null===e.getAttribute("value")?"on":e.value})});var Ct=/^(?:focusinfocus|focusoutblur)$/;de.extend(de.event,{trigger:function(t,n,r,o){var i,a,s,u,l,c,f,p=[r||te],h=le.call(t,"type")?t.type:t,d=le.call(t,"namespace")?t.namespace.split("."):[];if(a=s=r=r||te,3!==r.nodeType&&8!==r.nodeType&&!Ct.test(h+de.event.triggered)&&(h.indexOf(".")>-1&&(d=h.split("."),h=d.shift(),d.sort()),l=h.indexOf(":")<0&&"on"+h,t=t[de.expando]?t:new de.Event(h,"object"==typeof t&&t),t.isTrigger=o?2:3,t.namespace=d.join("."),t.rnamespace=t.namespace?new RegExp("(^|\\.)"+d.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,t.result=void 0,t.target||(t.target=r),n=null==n?[t]:de.makeArray(n,[t]),f=de.event.special[h]||{},o||!f.trigger||f.trigger.apply(r,n)!==!1)){if(!o&&!f.noBubble&&!de.isWindow(r)){for(u=f.delegateType||h,Ct.test(u+h)||(a=a.parentNode);a;a=a.parentNode)p.push(a),s=a;s===(r.ownerDocument||te)&&p.push(s.defaultView||s.parentWindow||e)}for(i=0;(a=p[i++])&&!t.isPropagationStopped();)t.type=i>1?u:f.bindType||h,c=(Fe.get(a,"events")||{})[t.type]&&Fe.get(a,"handle"),c&&c.apply(a,n),c=l&&a[l],c&&c.apply&&He(a)&&(t.result=c.apply(a,n),t.result===!1&&t.preventDefault());return t.type=h,o||t.isDefaultPrevented()||f._default&&f._default.apply(p.pop(),n)!==!1||!He(r)||l&&de.isFunction(r[h])&&!de.isWindow(r)&&(s=r[l],s&&(r[l]=null),de.event.triggered=h,r[h](),de.event.triggered=void 0,s&&(r[l]=s)),t.result}},simulate:function(e,t,n){var r=de.extend(new de.Event,n,{type:e,isSimulated:!0});de.event.trigger(r,null,t)}}),de.fn.extend({trigger:function(e,t){return this.each(function(){de.event.trigger(e,t,this)})},triggerHandler:function(e,t){var n=this[0];if(n)return de.event.trigger(e,t,n,!0)}}),de.each("blur focus focusin focusout resize scroll click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup contextmenu".split(" "),function(e,t){de.fn[t]=function(e,n){return arguments.length>0?this.on(t,null,e,n):this.trigger(t)}}),de.fn.extend({hover:function(e,t){return this.mouseenter(e).mouseleave(t||e)}}),pe.focusin="onfocusin"in e,pe.focusin||de.each({focus:"focusin",blur:"focusout"},function(e,t){var n=function(e){de.event.simulate(t,e.target,de.event.fix(e))};de.event.special[t]={setup:function(){var r=this.ownerDocument||this,o=Fe.access(r,t);o||r.addEventListener(e,n,!0),Fe.access(r,t,(o||0)+1)},teardown:function(){var r=this.ownerDocument||this,o=Fe.access(r,t)-1;o?Fe.access(r,t,o):(r.removeEventListener(e,n,!0),Fe.remove(r,t))}}});var Tt=e.location,kt=de.now(),jt=/\?/;de.parseXML=function(t){var n;if(!t||"string"!=typeof t)return null;try{n=(new e.DOMParser).parseFromString(t,"text/xml")}catch(e){n=void 0}return n&&!n.getElementsByTagName("parsererror").length||de.error("Invalid XML: "+t),n};var Et=/\[\]$/,Nt=/\r?\n/g,St=/^(?:submit|button|image|reset|file)$/i,At=/^(?:input|select|textarea|keygen)/i;de.param=function(e,t){var n,r=[],o=function(e,t){var n=de.isFunction(t)?t():t;r[r.length]=encodeURIComponent(e)+"="+encodeURIComponent(null==n?"":n)};if(de.isArray(e)||e.jquery&&!de.isPlainObject(e))de.each(e,function(){o(this.name,this.value)});else for(n in e)K(n,e[n],t,o);return r.join("&")},de.fn.extend({serialize:function(){return de.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var e=de.prop(this,"elements");return e?de.makeArray(e):this}).filter(function(){var e=this.type;return this.name&&!de(this).is(":disabled")&&At.test(this.nodeName)&&!St.test(e)&&(this.checked||!ze.test(e))}).map(function(e,t){var n=de(this).val();return null==n?null:de.isArray(n)?de.map(n,function(e){return{name:t.name,value:e.replace(Nt,"\r\n")}}):{name:t.name,value:n.replace(Nt,"\r\n")}}).get()}});var qt=/%20/g,Dt=/#.*$/,Ot=/([?&])_=[^&]*/,Lt=/^(.*?):[ \t]*([^\r\n]*)$/gm,Ht=/^(?:about|app|app-storage|.+-extension|file|res|widget):$/,Ft=/^(?:GET|HEAD)$/,Pt=/^\/\//,It={},Rt={},Mt="*/".concat("*"),$t=te.createElement("a");$t.href=Tt.href,de.extend({active:0,lastModified:{},etag:{},ajaxSettings:{url:Tt.href,type:"GET",isLocal:Ht.test(Tt.protocol),global:!0,processData:!0,async:!0,contentType:"application/x-www-form-urlencoded; charset=UTF-8",accepts:{"*":Mt,text:"text/plain",html:"text/html",xml:"application/xml, text/xml",json:"application/json, text/javascript"},contents:{xml:/\bxml\b/,html:/\bhtml/,json:/\bjson\b/},responseFields:{xml:"responseXML",text:"responseText",json:"responseJSON"},converters:{"* text":String,"text html":!0,"text json":JSON.parse,"text xml":de.parseXML},flatOptions:{url:!0,context:!0}},ajaxSetup:function(e,t){return t?Y(Y(e,de.ajaxSettings),t):Y(de.ajaxSettings,e)},ajaxPrefilter:V(It),ajaxTransport:V(Rt),ajax:function(t,n){function r(t,n,r,s){var l,p,h,x,w,C=n;c||(c=!0,u&&e.clearTimeout(u),o=void 0,a=s||"",T.readyState=t>0?4:0,l=t>=200&&t<300||304===t,r&&(x=Q(d,T,r)),x=J(d,x,T,l),l?(d.ifModified&&(w=T.getResponseHeader("Last-Modified"),w&&(de.lastModified[i]=w),w=T.getResponseHeader("etag"),w&&(de.etag[i]=w)),204===t||"HEAD"===d.type?C="nocontent":304===t?C="notmodified":(C=x.state,p=x.data,h=x.error,l=!h)):(h=C,!t&&C||(C="error",t<0&&(t=0))),T.status=t,T.statusText=(n||C)+"",l?v.resolveWith(g,[p,C,T]):v.rejectWith(g,[T,C,h]),T.statusCode(b),b=void 0,f&&m.trigger(l?"ajaxSuccess":"ajaxError",[T,d,l?p:h]),y.fireWith(g,[T,C]),f&&(m.trigger("ajaxComplete",[T,d]),--de.active||de.event.trigger("ajaxStop")))}"object"==typeof t&&(n=t,t=void 0),n=n||{};var o,i,a,s,u,l,c,f,p,h,d=de.ajaxSetup({},n),g=d.context||d,m=d.context&&(g.nodeType||g.jquery)?de(g):de.event,v=de.Deferred(),y=de.Callbacks("once memory"),b=d.statusCode||{},x={},w={},C="canceled",T={readyState:0,getResponseHeader:function(e){var t;if(c){if(!s)for(s={};t=Lt.exec(a);)s[t[1].toLowerCase()]=t[2];t=s[e.toLowerCase()]}return null==t?null:t},getAllResponseHeaders:function(){return c?a:null},setRequestHeader:function(e,t){return null==c&&(e=w[e.toLowerCase()]=w[e.toLowerCase()]||e,x[e]=t),this},overrideMimeType:function(e){return null==c&&(d.mimeType=e),this},statusCode:function(e){var t;if(e)if(c)T.always(e[T.status]);else for(t in e)b[t]=[b[t],e[t]];return this},abort:function(e){var t=e||C;return o&&o.abort(t),r(0,t),this}};if(v.promise(T),d.url=((t||d.url||Tt.href)+"").replace(Pt,Tt.protocol+"//"),d.type=n.method||n.type||d.method||d.type,d.dataTypes=(d.dataType||"*").toLowerCase().match(qe)||[""],null==d.crossDomain){l=te.createElement("a");try{l.href=d.url,l.href=l.href,d.crossDomain=$t.protocol+"//"+$t.host!=l.protocol+"//"+l.host}catch(e){d.crossDomain=!0}}if(d.data&&d.processData&&"string"!=typeof d.data&&(d.data=de.param(d.data,d.traditional)),G(It,d,n,T),c)return T;f=de.event&&d.global,f&&0===de.active++&&de.event.trigger("ajaxStart"),d.type=d.type.toUpperCase(),d.hasContent=!Ft.test(d.type),i=d.url.replace(Dt,""),d.hasContent?d.data&&d.processData&&0===(d.contentType||"").indexOf("application/x-www-form-urlencoded")&&(d.data=d.data.replace(qt,"+")):(h=d.url.slice(i.length),d.data&&(i+=(jt.test(i)?"&":"?")+d.data,delete d.data),d.cache===!1&&(i=i.replace(Ot,"$1"),h=(jt.test(i)?"&":"?")+"_="+kt++ +h),d.url=i+h),d.ifModified&&(de.lastModified[i]&&T.setRequestHeader("If-Modified-Since",de.lastModified[i]),de.etag[i]&&T.setRequestHeader("If-None-Match",de.etag[i])),(d.data&&d.hasContent&&d.contentType!==!1||n.contentType)&&T.setRequestHeader("Content-Type",d.contentType),T.setRequestHeader("Accept",d.dataTypes[0]&&d.accepts[d.dataTypes[0]]?d.accepts[d.dataTypes[0]]+("*"!==d.dataTypes[0]?", "+Mt+"; q=0.01":""):d.accepts["*"]);for(p in d.headers)T.setRequestHeader(p,d.headers[p]);if(d.beforeSend&&(d.beforeSend.call(g,T,d)===!1||c))return T.abort();if(C="abort",y.add(d.complete),T.done(d.success),T.fail(d.error),o=G(Rt,d,n,T)){if(T.readyState=1,f&&m.trigger("ajaxSend",[T,d]),c)return T;d.async&&d.timeout>0&&(u=e.setTimeout(function(){T.abort("timeout")},d.timeout));try{c=!1,o.send(x,r)}catch(e){if(c)throw e;r(-1,e)}}else r(-1,"No Transport");return T},getJSON:function(e,t,n){return de.get(e,t,n,"json")},getScript:function(e,t){return de.get(e,void 0,t,"script")}}),de.each(["get","post"],function(e,t){de[t]=function(e,n,r,o){return de.isFunction(n)&&(o=o||r,r=n,n=void 0),de.ajax(de.extend({url:e,type:t,dataType:o,data:n,success:r},de.isPlainObject(e)&&e))}}),de._evalUrl=function(e){return de.ajax({url:e,type:"GET",dataType:"script",cache:!0,async:!1,global:!1,throws:!0})},de.fn.extend({wrapAll:function(e){var t;return this[0]&&(de.isFunction(e)&&(e=e.call(this[0])),t=de(e,this[0].ownerDocument).eq(0).clone(!0),this[0].parentNode&&t.insertBefore(this[0]),t.map(function(){for(var e=this;e.firstElementChild;)e=e.firstElementChild;return e}).append(this)),this},wrapInner:function(e){return de.isFunction(e)?this.each(function(t){de(this).wrapInner(e.call(this,t))}):this.each(function(){var t=de(this),n=t.contents();n.length?n.wrapAll(e):t.append(e)})},wrap:function(e){var t=de.isFunction(e);return this.each(function(n){de(this).wrapAll(t?e.call(this,n):e)})},unwrap:function(e){return this.parent(e).not("body").each(function(){de(this).replaceWith(this.childNodes)}),this}}),de.expr.pseudos.hidden=function(e){return!de.expr.pseudos.visible(e)},de.expr.pseudos.visible=function(e){return!!(e.offsetWidth||e.offsetHeight||e.getClientRects().length)},de.ajaxSettings.xhr=function(){try{return new e.XMLHttpRequest}catch(e){}};var _t={0:200,1223:204},Wt=de.ajaxSettings.xhr();pe.cors=!!Wt&&"withCredentials"in Wt,pe.ajax=Wt=!!Wt,de.ajaxTransport(function(t){var n,r;if(pe.cors||Wt&&!t.crossDomain)return{send:function(o,i){var a,s=t.xhr();if(s.open(t.type,t.url,t.async,t.username,t.password),t.xhrFields)for(a in t.xhrFields)s[a]=t.xhrFields[a];t.mimeType&&s.overrideMimeType&&s.overrideMimeType(t.mimeType),t.crossDomain||o["X-Requested-With"]||(o["X-Requested-With"]="XMLHttpRequest");for(a in o)s.setRequestHeader(a,o[a]);n=function(e){return function(){n&&(n=r=s.onload=s.onerror=s.onabort=s.onreadystatechange=null,"abort"===e?s.abort():"error"===e?"number"!=typeof s.status?i(0,"error"):i(s.status,s.statusText):i(_t[s.status]||s.status,s.statusText,"text"!==(s.responseType||"text")||"string"!=typeof s.responseText?{binary:s.response}:{text:s.responseText},s.getAllResponseHeaders()))}},s.onload=n(),r=s.onerror=n("error"),void 0!==s.onabort?s.onabort=r:s.onreadystatechange=function(){4===s.readyState&&e.setTimeout(function(){n&&r()})},n=n("abort");try{s.send(t.hasContent&&t.data||null)}catch(e){if(n)throw e}},abort:function(){n&&n()}}}),de.ajaxPrefilter(function(e){e.crossDomain&&(e.contents.script=!1)}),de.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/\b(?:java|ecma)script\b/},converters:{"text script":function(e){return de.globalEval(e),e}}}),de.ajaxPrefilter("script",function(e){void 0===e.cache&&(e.cache=!1),e.crossDomain&&(e.type="GET")}),de.ajaxTransport("script",function(e){if(e.crossDomain){var t,n;return{send:function(r,o){t=de("<script>").prop({charset:e.scriptCharset,src:e.url}).on("load error",n=function(e){t.remove(),n=null,e&&o("error"===e.type?404:200,e.type)}),te.head.appendChild(t[0])},abort:function(){n&&n()}}}});var Bt=[],Ut=/(=)\?(?=&|$)|\?\?/;de.ajaxSetup({jsonp:"callback",jsonpCallback:function(){var e=Bt.pop()||de.expando+"_"+kt++;return this[e]=!0,e}}),de.ajaxPrefilter("json jsonp",function(t,n,r){var o,i,a,s=t.jsonp!==!1&&(Ut.test(t.url)?"url":"string"==typeof t.data&&0===(t.contentType||"").indexOf("application/x-www-form-urlencoded")&&Ut.test(t.data)&&"data");if(s||"jsonp"===t.dataTypes[0])return o=t.jsonpCallback=de.isFunction(t.jsonpCallback)?t.jsonpCallback():t.jsonpCallback,s?t[s]=t[s].replace(Ut,"$1"+o):t.jsonp!==!1&&(t.url+=(jt.test(t.url)?"&":"?")+t.jsonp+"="+o),t.converters["script json"]=function(){return a||de.error(o+" was not called"),a[0]},t.dataTypes[0]="json",i=e[o],e[o]=function(){a=arguments},r.always(function(){void 0===i?de(e).removeProp(o):e[o]=i,t[o]&&(t.jsonpCallback=n.jsonpCallback,Bt.push(o)),a&&de.isFunction(i)&&i(a[0]),a=i=void 0}),"script"}),pe.createHTMLDocument=function(){var e=te.implementation.createHTMLDocument("").body;return e.innerHTML="<form></form><form></form>",2===e.childNodes.length}(),de.parseHTML=function(e,t,n){if("string"!=typeof e)return[];"boolean"==typeof t&&(n=t,t=!1);var r,o,i;return t||(pe.createHTMLDocument?(t=te.implementation.createHTMLDocument(""),r=t.createElement("base"),r.href=te.location.href,t.head.appendChild(r)):t=te),o=Te.exec(e),i=!n&&[],o?[t.createElement(o[1])]:(o=b([e],t,i),i&&i.length&&de(i).remove(),de.merge([],o.childNodes))},de.fn.load=function(e,t,n){var r,o,i,a=this,s=e.indexOf(" ");return s>-1&&(r=z(e.slice(s)),e=e.slice(0,s)),de.isFunction(t)?(n=t,t=void 0):t&&"object"==typeof t&&(o="POST"),a.length>0&&de.ajax({url:e,type:o||"GET",dataType:"html",data:t}).done(function(e){i=arguments,a.html(r?de("<div>").append(de.parseHTML(e)).find(r):e)}).always(n&&function(e,t){a.each(function(){n.apply(this,i||[e.responseText,t,e])})}),this},de.each(["ajaxStart","ajaxStop","ajaxComplete","ajaxError","ajaxSuccess","ajaxSend"],function(e,t){de.fn[t]=function(e){return this.on(t,e)}}),de.expr.pseudos.animated=function(e){return de.grep(de.timers,function(t){return e===t.elem}).length},de.offset={setOffset:function(e,t,n){var r,o,i,a,s,u,l,c=de.css(e,"position"),f=de(e),p={};"static"===c&&(e.style.position="relative"),s=f.offset(),i=de.css(e,"top"),u=de.css(e,"left"),l=("absolute"===c||"fixed"===c)&&(i+u).indexOf("auto")>-1,l?(r=f.position(),a=r.top,o=r.left):(a=parseFloat(i)||0,o=parseFloat(u)||0),de.isFunction(t)&&(t=t.call(e,n,de.extend({},s))),null!=t.top&&(p.top=t.top-s.top+a),null!=t.left&&(p.left=t.left-s.left+o),"using"in t?t.using.call(e,p):f.css(p)}},de.fn.extend({offset:function(e){if(arguments.length)return void 0===e?this:this.each(function(t){de.offset.setOffset(this,e,t)});var t,n,r,o,i=this[0];if(i)return i.getClientRects().length?(r=i.getBoundingClientRect(),r.width||r.height?(o=i.ownerDocument,n=Z(o),t=o.documentElement,{top:r.top+n.pageYOffset-t.clientTop,left:r.left+n.pageXOffset-t.clientLeft}):r):{top:0,left:0}},position:function(){if(this[0]){var e,t,n=this[0],r={top:0,left:0};return"fixed"===de.css(n,"position")?t=n.getBoundingClientRect():(e=this.offsetParent(),t=this.offset(),de.nodeName(e[0],"html")||(r=e.offset()),r={top:r.top+de.css(e[0],"borderTopWidth",!0),left:r.left+de.css(e[0],"borderLeftWidth",!0)}),{top:t.top-r.top-de.css(n,"marginTop",!0),left:t.left-r.left-de.css(n,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){for(var e=this.offsetParent;e&&"static"===de.css(e,"position");)e=e.offsetParent;return e||Ye})}}),de.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(e,t){var n="pageYOffset"===t;de.fn[e]=function(r){return Le(this,function(e,r,o){var i=Z(e);return void 0===o?i?i[t]:e[r]:void(i?i.scrollTo(n?i.pageXOffset:o,n?o:i.pageYOffset):e[r]=o)},e,r,arguments.length)}}),de.each(["top","left"],function(e,t){de.cssHooks[t]=O(pe.pixelPosition,function(e,n){if(n)return n=D(e,t),at.test(n)?de(e).position()[t]+"px":n})}),de.each({Height:"height",Width:"width"},function(e,t){de.each({padding:"inner"+e,content:t,"":"outer"+e},function(n,r){de.fn[r]=function(o,i){var a=arguments.length&&(n||"boolean"!=typeof o),s=n||(o===!0||i===!0?"margin":"border");return Le(this,function(t,n,o){var i;return de.isWindow(t)?0===r.indexOf("outer")?t["inner"+e]:t.document.documentElement["client"+e]:9===t.nodeType?(i=t.documentElement,Math.max(t.body["scroll"+e],i["scroll"+e],t.body["offset"+e],i["offset"+e],i["client"+e])):void 0===o?de.css(t,n,s):de.style(t,n,o,s)},t,a?o:void 0,a)}})}),de.fn.extend({bind:function(e,t,n){return this.on(e,null,t,n)},unbind:function(e,t){return this.off(e,null,t)},delegate:function(e,t,n,r){return this.on(t,e,n,r)},undelegate:function(e,t,n){return 1===arguments.length?this.off(e,"**"):this.off(t,e||"**",n)}}),de.parseJSON=JSON.parse,"function"==typeof define&&define.amd&&define("jquery",[],function(){return de});var zt=e.jQuery,Xt=e.$;return de.noConflict=function(t){return e.$===de&&(e.$=Xt),t&&e.jQuery===de&&(e.jQuery=zt),de},t||(e.jQuery=e.$=de),de})},{}],2:[function(e,t,n){!function(e,n,r){function o(e,t,n){return e.addEventListener?void e.addEventListener(t,n,!1):void e.attachEvent("on"+t,n)}function i(e){if("keypress"==e.type){var t=String.fromCharCode(e.which);return e.shiftKey||(t=t.toLowerCase()),t}return y[e.which]?y[e.which]:b[e.which]?b[e.which]:String.fromCharCode(e.which).toLowerCase()}function a(e,t){return e.sort().join(",")===t.sort().join(",")}function s(e){var t=[];return e.shiftKey&&t.push("shift"),e.altKey&&t.push("alt"),e.ctrlKey&&t.push("ctrl"),e.metaKey&&t.push("meta"),t}function u(e){return e.preventDefault?void e.preventDefault():void(e.returnValue=!1)}function l(e){return e.stopPropagation?void e.stopPropagation():void(e.cancelBubble=!0)}function c(e){return"shift"==e||"ctrl"==e||"alt"==e||"meta"==e}function f(){if(!v){v={};for(var e in y)e>95&&e<112||y.hasOwnProperty(e)&&(v[y[e]]=e)}return v}function p(e,t,n){return n||(n=f()[e]?"keydown":"keypress"),"keypress"==n&&t.length&&(n="keydown"),n}function h(e){return"+"===e?["+"]:(e=e.replace(/\+{2}/g,"+plus"),e.split("+"))}function d(e,t){var n,r,o,i=[];for(n=h(e),o=0;o<n.length;++o)r=n[o],w[r]&&(r=w[r]),t&&"keypress"!=t&&x[r]&&(r=x[r],i.push("shift")),c(r)&&i.push(r);return t=p(r,i,t),{key:r,modifiers:i,action:t}}function g(e,t){return null!==e&&e!==n&&(e===t||g(e.parentNode,t))}function m(e){function t(e){e=e||{};var t,n=!1;for(t in x)e[t]?n=!0:x[t]=0;n||(T=!1)}function r(e,t,n,r,o,i){var s,u,l=[],f=n.type;if(!y._callbacks[e])return[];for("keyup"==f&&c(e)&&(t=[e]),s=0;s<y._callbacks[e].length;++s)if(u=y._callbacks[e][s],(r||!u.seq||x[u.seq]==u.level)&&f==u.action&&("keypress"==f&&!n.metaKey&&!n.ctrlKey||a(t,u.modifiers))){var p=!r&&u.combo==o,h=r&&u.seq==r&&u.level==i;(p||h)&&y._callbacks[e].splice(s,1),l.push(u)}return l}function f(e,t,n,r){y.stopCallback(t,t.target||t.srcElement,n,r)||e(t,n)===!1&&(u(t),l(t))}function p(e){"number"!=typeof e.which&&(e.which=e.keyCode);var t=i(e);if(t)return"keyup"==e.type&&w===t?void(w=!1):void y.handleKey(t,s(e),e)}function h(){clearTimeout(b),b=setTimeout(t,1e3)}function g(e,n,r,o){function a(t){return function(){T=t,++x[e],h()}}function s(n){f(r,n,e),"keyup"!==o&&(w=i(n)),setTimeout(t,10)}x[e]=0;for(var u=0;u<n.length;++u){var l=u+1===n.length,c=l?s:a(o||d(n[u+1]).action);v(n[u],c,o,e,u)}}function v(e,t,n,o,i){y._directMap[e+":"+n]=t,e=e.replace(/\s+/g," ");var a,s=e.split(" ");return s.length>1?void g(e,s,t,n):(a=d(e,n),y._callbacks[a.key]=y._callbacks[a.key]||[],r(a.key,a.modifiers,{type:a.action},o,e,i),void y._callbacks[a.key][o?"unshift":"push"]({callback:t,modifiers:a.modifiers,action:a.action,seq:o,level:i,combo:e}))}var y=this;if(e=e||n,!(y instanceof m))return new m(e);y.target=e,y._callbacks={},y._directMap={};var b,x={},w=!1,C=!1,T=!1;y._handleKey=function(e,n,o){var i,a=r(e,n,o),s={},u=0,l=!1;for(i=0;i<a.length;++i)a[i].seq&&(u=Math.max(u,a[i].level));for(i=0;i<a.length;++i)if(a[i].seq){if(a[i].level!=u)continue;l=!0,s[a[i].seq]=1,f(a[i].callback,o,a[i].combo,a[i].seq)}else l||f(a[i].callback,o,a[i].combo);var p="keypress"==o.type&&C;o.type!=T||c(e)||p||t(s),C=l&&"keydown"==o.type},y._bindMultiple=function(e,t,n){for(var r=0;r<e.length;++r)v(e[r],t,n)},o(e,"keypress",p),o(e,"keydown",p),o(e,"keyup",p)}if(e){for(var v,y={8:"backspace",9:"tab",13:"enter",16:"shift",17:"ctrl",18:"alt",20:"capslock",27:"esc",32:"space",33:"pageup",34:"pagedown",35:"end",36:"home",37:"left",38:"up",39:"right",40:"down",45:"ins",46:"del",91:"meta",93:"meta",224:"meta"},b={106:"*",107:"+",109:"-",110:".",111:"/",186:";",187:"=",188:",",189:"-",190:".",191:"/",192:"`",219:"[",220:"\\",221:"]",222:"'"},x={"~":"`","!":"1","@":"2","#":"3",$:"4","%":"5","^":"6","&":"7","*":"8","(":"9",")":"0",_:"-","+":"=",":":";",'"':"'","<":",",">":".","?":"/","|":"\\"},w={option:"alt",command:"meta",return:"enter",escape:"esc",plus:"+",mod:/Mac|iPod|iPhone|iPad/.test(navigator.platform)?"meta":"ctrl"},C=1;C<20;++C)y[111+C]="f"+C;for(C=0;C<=9;++C)y[C+96]=C;m.prototype.bind=function(e,t,n){var r=this;return e=e instanceof Array?e:[e],r._bindMultiple.call(r,e,t,n),r},m.prototype.unbind=function(e,t){var n=this;return n.bind.call(n,e,function(){},t)},m.prototype.trigger=function(e,t){var n=this;return n._directMap[e+":"+t]&&n._directMap[e+":"+t]({},e),n},m.prototype.reset=function(){var e=this;return e._callbacks={},e._directMap={},e},m.prototype.stopCallback=function(e,t){var n=this;return!((" "+t.className+" ").indexOf(" mousetrap ")>-1)&&(!g(t,n.target)&&("INPUT"==t.tagName||"SELECT"==t.tagName||"TEXTAREA"==t.tagName||t.isContentEditable))},m.prototype.handleKey=function(){var e=this;return e._handleKey.apply(e,arguments)},m.addKeycodes=function(e){for(var t in e)e.hasOwnProperty(t)&&(y[t]=e[t]);v=null},m.init=function(){var e=m(n);for(var t in e)"_"!==t.charAt(0)&&(m[t]=function(t){return function(){return e[t].apply(e,arguments)}}(t))},m.init(),e.Mousetrap=m,"undefined"!=typeof t&&t.exports&&(t.exports=m),"function"==typeof define&&define.amd&&define(function(){return m})}}("undefined"!=typeof window?window:null,"undefined"!=typeof window?document:null)},{}],3:[function(e,t,n){(function(e){!function(r){function o(e){throw new RangeError(L[e])}function i(e,t){for(var n=e.length,r=[];n--;)r[n]=t(e[n]);return r}function a(e,t){var n=e.split("@"),r="";n.length>1&&(r=n[0]+"@",e=n[1]),e=e.replace(O,".");var o=e.split("."),a=i(o,t).join(".");return r+a}function s(e){for(var t,n,r=[],o=0,i=e.length;o<i;)t=e.charCodeAt(o++),t>=55296&&t<=56319&&o<i?(n=e.charCodeAt(o++),56320==(64512&n)?r.push(((1023&t)<<10)+(1023&n)+65536):(r.push(t),o--)):r.push(t);return r}function u(e){return i(e,function(e){var t="";return e>65535&&(e-=65536,t+=P(e>>>10&1023|55296),e=56320|1023&e),t+=P(e)}).join("")}function l(e){return e-48<10?e-22:e-65<26?e-65:e-97<26?e-97:C}function c(e,t){return e+22+75*(e<26)-((0!=t)<<5)}function f(e,t,n){var r=0;for(e=n?F(e/E):e>>1,e+=F(e/t);e>H*k>>1;r+=C)e=F(e/H);return F(r+(H+1)*e/(e+j))}function p(e){var t,n,r,i,a,s,c,p,h,d,g=[],m=e.length,v=0,y=S,b=N;for(n=e.lastIndexOf(A),n<0&&(n=0),r=0;r<n;++r)e.charCodeAt(r)>=128&&o("not-basic"),g.push(e.charCodeAt(r));for(i=n>0?n+1:0;i<m;){for(a=v,s=1,c=C;i>=m&&o("invalid-input"),p=l(e.charCodeAt(i++)),(p>=C||p>F((w-v)/s))&&o("overflow"),v+=p*s,h=c<=b?T:c>=b+k?k:c-b,!(p<h);c+=C)d=C-h,s>F(w/d)&&o("overflow"),s*=d;t=g.length+1,b=f(v-a,t,0==a),F(v/t)>w-y&&o("overflow"),y+=F(v/t),v%=t,g.splice(v++,0,y)}return u(g)}function h(e){var t,n,r,i,a,u,l,p,h,d,g,m,v,y,b,x=[];for(e=s(e),m=e.length,t=S,n=0,a=N,u=0;u<m;++u)g=e[u],g<128&&x.push(P(g));for(r=i=x.length,i&&x.push(A);r<m;){for(l=w,u=0;u<m;++u)g=e[u],g>=t&&g<l&&(l=g);for(v=r+1,l-t>F((w-n)/v)&&o("overflow"),n+=(l-t)*v,t=l,u=0;u<m;++u)if(g=e[u],g<t&&++n>w&&o("overflow"),g==t){for(p=n,h=C;d=h<=a?T:h>=a+k?k:h-a,!(p<d);h+=C)b=p-d,y=C-d,x.push(P(c(d+b%y,0))),p=F(b/y);x.push(P(c(p,0))),a=f(n,v,r==i),n=0,++r}++n,++t}return x.join("")}function d(e){return a(e,function(e){return q.test(e)?p(e.slice(4).toLowerCase()):e})}function g(e){return a(e,function(e){return D.test(e)?"xn--"+h(e):e})}var m="object"==typeof n&&n&&!n.nodeType&&n,v="object"==typeof t&&t&&!t.nodeType&&t,y="object"==typeof e&&e;y.global!==y&&y.window!==y&&y.self!==y||(r=y);var b,x,w=2147483647,C=36,T=1,k=26,j=38,E=700,N=72,S=128,A="-",q=/^xn--/,D=/[^\x20-\x7E]/,O=/[\x2E\u3002\uFF0E\uFF61]/g,L={overflow:"Overflow: input needs wider integers to process","not-basic":"Illegal input >= 0x80 (not a basic code point)","invalid-input":"Invalid input"},H=C-T,F=Math.floor,P=String.fromCharCode;if(b={version:"1.4.1",ucs2:{decode:s,encode:u},decode:p,encode:h,toASCII:g,toUnicode:d},"function"==typeof define&&"object"==typeof define.amd&&define.amd)define("punycode",function(){return b});else if(m&&v)if(t.exports==m)v.exports=b;else for(x in b)b.hasOwnProperty(x)&&(m[x]=b[x]);else r.punycode=b}(this)}).call(this,"undefined"!=typeof global?global:"undefined"!=typeof self?self:"undefined"!=typeof window?window:{})},{}],4:[function(e,t,n){"use strict";function r(e,t){return Object.prototype.hasOwnProperty.call(e,t)}t.exports=function(e,t,n,i){t=t||"&",n=n||"=";var a={};if("string"!=typeof e||0===e.length)return a;var s=/\+/g;e=e.split(t);var u=1e3;i&&"number"==typeof i.maxKeys&&(u=i.maxKeys);var l=e.length;u>0&&l>u&&(l=u);for(var c=0;c<l;++c){var f,p,h,d,g=e[c].replace(s,"%20"),m=g.indexOf(n);m>=0?(f=g.substr(0,m),p=g.substr(m+1)):(f=g,p=""),h=decodeURIComponent(f),d=decodeURIComponent(p),
+r(a,h)?o(a[h])?a[h].push(d):a[h]=[a[h],d]:a[h]=d}return a};var o=Array.isArray||function(e){return"[object Array]"===Object.prototype.toString.call(e)}},{}],5:[function(e,t,n){"use strict";function r(e,t){if(e.map)return e.map(t);for(var n=[],r=0;r<e.length;r++)n.push(t(e[r],r));return n}var o=function(e){switch(typeof e){case"string":return e;case"boolean":return e?"true":"false";case"number":return isFinite(e)?e:"";default:return""}};t.exports=function(e,t,n,s){return t=t||"&",n=n||"=",null===e&&(e=void 0),"object"==typeof e?r(a(e),function(a){var s=encodeURIComponent(o(a))+n;return i(e[a])?r(e[a],function(e){return s+encodeURIComponent(o(e))}).join(t):s+encodeURIComponent(o(e[a]))}).join(t):s?encodeURIComponent(o(s))+n+encodeURIComponent(o(e)):""};var i=Array.isArray||function(e){return"[object Array]"===Object.prototype.toString.call(e)},a=Object.keys||function(e){var t=[];for(var n in e)Object.prototype.hasOwnProperty.call(e,n)&&t.push(n);return t}},{}],6:[function(e,t,n){"use strict";n.decode=n.parse=e("./decode"),n.encode=n.stringify=e("./encode")},{"./decode":4,"./encode":5}],7:[function(e,t,n){"use strict";function r(){this.protocol=null,this.slashes=null,this.auth=null,this.host=null,this.port=null,this.hostname=null,this.hash=null,this.search=null,this.query=null,this.pathname=null,this.path=null,this.href=null}function o(e,t,n){if(e&&l.isObject(e)&&e instanceof r)return e;var o=new r;return o.parse(e,t,n),o}function i(e){return l.isString(e)&&(e=o(e)),e instanceof r?e.format():r.prototype.format.call(e)}function a(e,t){return o(e,!1,!0).resolve(t)}function s(e,t){return e?o(e,!1,!0).resolveObject(t):t}var u=e("punycode"),l=e("./util");n.parse=o,n.resolve=a,n.resolveObject=s,n.format=i,n.Url=r;var c=/^([a-z0-9.+-]+:)/i,f=/:[0-9]*$/,p=/^(\/\/?(?!\/)[^\?\s]*)(\?[^\s]*)?$/,h=["<",">",'"',"`"," ","\r","\n","\t"],d=["{","}","|","\\","^","`"].concat(h),g=["'"].concat(d),m=["%","/","?",";","#"].concat(g),v=["/","?","#"],y=255,b=/^[+a-z0-9A-Z_-]{0,63}$/,x=/^([+a-z0-9A-Z_-]{0,63})(.*)$/,w={javascript:!0,"javascript:":!0},C={javascript:!0,"javascript:":!0},T={http:!0,https:!0,ftp:!0,gopher:!0,file:!0,"http:":!0,"https:":!0,"ftp:":!0,"gopher:":!0,"file:":!0},k=e("querystring");r.prototype.parse=function(e,t,n){if(!l.isString(e))throw new TypeError("Parameter 'url' must be a string, not "+typeof e);var r=e.indexOf("?"),o=r!==-1&&r<e.indexOf("#")?"?":"#",i=e.split(o),a=/\\/g;i[0]=i[0].replace(a,"/"),e=i.join(o);var s=e;if(s=s.trim(),!n&&1===e.split("#").length){var f=p.exec(s);if(f)return this.path=s,this.href=s,this.pathname=f[1],f[2]?(this.search=f[2],t?this.query=k.parse(this.search.substr(1)):this.query=this.search.substr(1)):t&&(this.search="",this.query={}),this}var h=c.exec(s);if(h){h=h[0];var d=h.toLowerCase();this.protocol=d,s=s.substr(h.length)}if(n||h||s.match(/^\/\/[^@\/]+@[^@\/]+/)){var j="//"===s.substr(0,2);!j||h&&C[h]||(s=s.substr(2),this.slashes=!0)}if(!C[h]&&(j||h&&!T[h])){for(var E=-1,N=0;N<v.length;N++){var S=s.indexOf(v[N]);S!==-1&&(E===-1||S<E)&&(E=S)}var A,q;q=E===-1?s.lastIndexOf("@"):s.lastIndexOf("@",E),q!==-1&&(A=s.slice(0,q),s=s.slice(q+1),this.auth=decodeURIComponent(A)),E=-1;for(var N=0;N<m.length;N++){var S=s.indexOf(m[N]);S!==-1&&(E===-1||S<E)&&(E=S)}E===-1&&(E=s.length),this.host=s.slice(0,E),s=s.slice(E),this.parseHost(),this.hostname=this.hostname||"";var D="["===this.hostname[0]&&"]"===this.hostname[this.hostname.length-1];if(!D)for(var O=this.hostname.split(/\./),N=0,L=O.length;N<L;N++){var H=O[N];if(H&&!H.match(b)){for(var F="",P=0,I=H.length;P<I;P++)F+=H.charCodeAt(P)>127?"x":H[P];if(!F.match(b)){var R=O.slice(0,N),M=O.slice(N+1),$=H.match(x);$&&(R.push($[1]),M.unshift($[2])),M.length&&(s="/"+M.join(".")+s),this.hostname=R.join(".");break}}}this.hostname.length>y?this.hostname="":this.hostname=this.hostname.toLowerCase(),D||(this.hostname=u.toASCII(this.hostname));var _=this.port?":"+this.port:"",W=this.hostname||"";this.host=W+_,this.href+=this.host,D&&(this.hostname=this.hostname.substr(1,this.hostname.length-2),"/"!==s[0]&&(s="/"+s))}if(!w[d])for(var N=0,L=g.length;N<L;N++){var B=g[N];if(s.indexOf(B)!==-1){var U=encodeURIComponent(B);U===B&&(U=escape(B)),s=s.split(B).join(U)}}var z=s.indexOf("#");z!==-1&&(this.hash=s.substr(z),s=s.slice(0,z));var X=s.indexOf("?");if(X!==-1?(this.search=s.substr(X),this.query=s.substr(X+1),t&&(this.query=k.parse(this.query)),s=s.slice(0,X)):t&&(this.search="",this.query={}),s&&(this.pathname=s),T[d]&&this.hostname&&!this.pathname&&(this.pathname="/"),this.pathname||this.search){var _=this.pathname||"",K=this.search||"";this.path=_+K}return this.href=this.format(),this},r.prototype.format=function(){var e=this.auth||"";e&&(e=encodeURIComponent(e),e=e.replace(/%3A/i,":"),e+="@");var t=this.protocol||"",n=this.pathname||"",r=this.hash||"",o=!1,i="";this.host?o=e+this.host:this.hostname&&(o=e+(this.hostname.indexOf(":")===-1?this.hostname:"["+this.hostname+"]"),this.port&&(o+=":"+this.port)),this.query&&l.isObject(this.query)&&Object.keys(this.query).length&&(i=k.stringify(this.query));var a=this.search||i&&"?"+i||"";return t&&":"!==t.substr(-1)&&(t+=":"),this.slashes||(!t||T[t])&&o!==!1?(o="//"+(o||""),n&&"/"!==n.charAt(0)&&(n="/"+n)):o||(o=""),r&&"#"!==r.charAt(0)&&(r="#"+r),a&&"?"!==a.charAt(0)&&(a="?"+a),n=n.replace(/[?#]/g,function(e){return encodeURIComponent(e)}),a=a.replace("#","%23"),t+o+n+a+r},r.prototype.resolve=function(e){return this.resolveObject(o(e,!1,!0)).format()},r.prototype.resolveObject=function(e){if(l.isString(e)){var t=new r;t.parse(e,!1,!0),e=t}for(var n=new r,o=Object.keys(this),i=0;i<o.length;i++){var a=o[i];n[a]=this[a]}if(n.hash=e.hash,""===e.href)return n.href=n.format(),n;if(e.slashes&&!e.protocol){for(var s=Object.keys(e),u=0;u<s.length;u++){var c=s[u];"protocol"!==c&&(n[c]=e[c])}return T[n.protocol]&&n.hostname&&!n.pathname&&(n.path=n.pathname="/"),n.href=n.format(),n}if(e.protocol&&e.protocol!==n.protocol){if(!T[e.protocol]){for(var f=Object.keys(e),p=0;p<f.length;p++){var h=f[p];n[h]=e[h]}return n.href=n.format(),n}if(n.protocol=e.protocol,e.host||C[e.protocol])n.pathname=e.pathname;else{for(var d=(e.pathname||"").split("/");d.length&&!(e.host=d.shift()););e.host||(e.host=""),e.hostname||(e.hostname=""),""!==d[0]&&d.unshift(""),d.length<2&&d.unshift(""),n.pathname=d.join("/")}if(n.search=e.search,n.query=e.query,n.host=e.host||"",n.auth=e.auth,n.hostname=e.hostname||e.host,n.port=e.port,n.pathname||n.search){var g=n.pathname||"",m=n.search||"";n.path=g+m}return n.slashes=n.slashes||e.slashes,n.href=n.format(),n}var v=n.pathname&&"/"===n.pathname.charAt(0),y=e.host||e.pathname&&"/"===e.pathname.charAt(0),b=y||v||n.host&&e.pathname,x=b,w=n.pathname&&n.pathname.split("/")||[],d=e.pathname&&e.pathname.split("/")||[],k=n.protocol&&!T[n.protocol];if(k&&(n.hostname="",n.port=null,n.host&&(""===w[0]?w[0]=n.host:w.unshift(n.host)),n.host="",e.protocol&&(e.hostname=null,e.port=null,e.host&&(""===d[0]?d[0]=e.host:d.unshift(e.host)),e.host=null),b=b&&(""===d[0]||""===w[0])),y)n.host=e.host||""===e.host?e.host:n.host,n.hostname=e.hostname||""===e.hostname?e.hostname:n.hostname,n.search=e.search,n.query=e.query,w=d;else if(d.length)w||(w=[]),w.pop(),w=w.concat(d),n.search=e.search,n.query=e.query;else if(!l.isNullOrUndefined(e.search)){if(k){n.hostname=n.host=w.shift();var j=!!(n.host&&n.host.indexOf("@")>0)&&n.host.split("@");j&&(n.auth=j.shift(),n.host=n.hostname=j.shift())}return n.search=e.search,n.query=e.query,l.isNull(n.pathname)&&l.isNull(n.search)||(n.path=(n.pathname?n.pathname:"")+(n.search?n.search:"")),n.href=n.format(),n}if(!w.length)return n.pathname=null,n.search?n.path="/"+n.search:n.path=null,n.href=n.format(),n;for(var E=w.slice(-1)[0],N=(n.host||e.host||w.length>1)&&("."===E||".."===E)||""===E,S=0,A=w.length;A>=0;A--)E=w[A],"."===E?w.splice(A,1):".."===E?(w.splice(A,1),S++):S&&(w.splice(A,1),S--);if(!b&&!x)for(;S--;S)w.unshift("..");!b||""===w[0]||w[0]&&"/"===w[0].charAt(0)||w.unshift(""),N&&"/"!==w.join("/").substr(-1)&&w.push("");var q=""===w[0]||w[0]&&"/"===w[0].charAt(0);if(k){n.hostname=n.host=q?"":w.length?w.shift():"";var j=!!(n.host&&n.host.indexOf("@")>0)&&n.host.split("@");j&&(n.auth=j.shift(),n.host=n.hostname=j.shift())}return b=b||n.host&&w.length,b&&!q&&w.unshift(""),w.length?n.pathname=w.join("/"):(n.pathname=null,n.path=null),l.isNull(n.pathname)&&l.isNull(n.search)||(n.path=(n.pathname?n.pathname:"")+(n.search?n.search:"")),n.auth=e.auth||n.auth,n.slashes=n.slashes||e.slashes,n.href=n.format(),n},r.prototype.parseHost=function(){var e=this.host,t=f.exec(e);t&&(t=t[0],":"!==t&&(this.port=t.substr(1)),e=e.substr(0,e.length-t.length)),e&&(this.hostname=e)}},{"./util":8,punycode:3,querystring:6}],8:[function(e,t,n){"use strict";t.exports={isString:function(e){return"string"==typeof e},isObject:function(e){return"object"==typeof e&&null!==e},isNull:function(e){return null===e},isNullOrUndefined:function(e){return null==e}}},{}],9:[function(e,t,n){function r(e){var t=a(e.currentTarget).parent().find(".dropdown-menu");t.toggleClass("open"),e.stopPropagation(),e.preventDefault()}function o(e){a(".dropdown-menu").removeClass("open")}function i(){a(document).on("click",".toggle-dropdown",r),a(document).on("click",".dropdown-menu",function(e){e.stopPropagation()}),a(document).on("click",o)}var a=e("jquery");t.exports={init:i}},{jquery:1}],10:[function(e,t,n){function r(){s.init(),i.init(),o.init(),a.init(),u.createButton({index:0,icon:"fa fa-align-justify",onClick:function(e){e.preventDefault(),s.toggle()}})}var o=e("./dropdown"),i=e("./keyboard"),a=e("./navigation"),s=e("./sidebar"),u=e("./toolbar"),l=window.gitbook;l.events.on("start",r),l.keyboard=i,l.navigation=a,l.sidebar=s,l.toolbar=u},{"./dropdown":9,"./keyboard":11,"./navigation":13,"./sidebar":15,"./toolbar":16}],11:[function(e,t,n){function r(e,t){i.bind(e,function(e){return t(),!1})}function o(){r(["right"],function(e){a.goNext()}),r(["left"],function(e){a.goPrev()}),r(["s"],function(e){s.toggle()})}var i=e("mousetrap"),a=e("./navigation"),s=e("./sidebar");t.exports={init:o,bind:r}},{"./navigation":13,"./sidebar":15,mousetrap:2}],12:[function(e,t,n){function r(e){return o.state.$book.addClass("is-loading"),e.always(function(){o.state.$book.removeClass("is-loading")}),e}var o=window.gitbook;t.exports={show:r}},{}],13:[function(e,t,n){function r(){return T(E.isSmallScreen()?".book-body":".body-inner")}function o(e){var t=r(),n=0;i(e)&&(e&&(n=u(e)),t.unbind("scroll"),t.animate({scrollTop:n},800,"swing",function(){t.scroll(f)}),l(null,e))}function i(e){var t=r(),n=t.find(e);return!!n.length}function a(e){return 0===e.length}function s(e,t){return e.length>0&&e.filter(t).length>0}function u(e){var t=r(),n=t.find(".page-inner"),o=t.find(e),i=o.offsetParent(),u=0;if(s([t,n,o,i],a))return 0;u=o.position().top;for(var l=10,c=0;c<l&&(!i.is(n)&&!i.is(i.offsetParent()));c++)o=i,u+=o.position().top,i=o.offsetParent();return Math.floor(u)}function l(e,t){if(e||t||(e=w.first()),t&&(e=w.length>1?w.filter(function(){var e=c(T(this));return e==t}).first():w.first()),!e.is(C)){C=e,w.removeClass("active"),e.addClass("active"),t=c(e);var n=window.location.pathname+window.location.hash,r=window.location.pathname+t;r!=n&&history.replaceState({path:r},null,r)}}function c(e){var t=e.children("a"),n=t.attr("href").split("#")[1];return n&&(n="#"+n),n?n:""}function f(){var e=r(),t=e.scrollTop(),n=e.prop("scrollHeight"),o=e.prop("clientHeight"),i=w.length,a=null;T(w.get().reverse()).each(function(e){var n,r=c(T(this));r&&!a&&(n=u(r),t>=n&&(a=T(this))),e!=i-1||a||(a=T(this))}),a||t||(a=w.first()),t&&n-t==o&&(a=w.last()),l(a)}function p(e,t){var n=k.parse(A),r=k.resolve(window.location.pathname,e),i=k.parse(r),a=i.hash,s=i.pathname!==n.pathname,u=Boolean(i.hostname);if(!S||u)return void(location.href=e);if(!s)return t&&history.pushState({path:r},null,r),o(a);A=r;var l=T.Deferred(function(e){T.ajax({type:"GET",url:r,cache:!0,headers:{"Access-Control-Expose-Headers":"X-Current-Location"},success:function(n,i,s){var u=s.getResponseHeader("X-Current-Location")||r;n=n.replace(/<(\/?)(html|head|body)([^>]*)>/gi,function(e,t,n,r){return"<"+t+"div"+(t?"":' data-element="'+n+'"')+r+">"});var l,c=T(n),f=c.find(".book");if(0===f.length){var p=new Error("Invalid gitbook page, redirecting...");return e.reject(p)}t&&history.pushState({path:u},null,u),c=T(n),l=c.find("[data-element=head]"),f=c.find(".book"),document.title=l.find("title").text();var h=T("head");h.find("link[rel=prev]").remove(),h.find("link[rel=next]").remove(),h.append(l.find("link[rel=prev]")),h.append(l.find("link[rel=next]"));var g=T(".book").attr("class"),m=T(".book-summary").scrollTop();f.toggleClass("with-summary",T(".book").hasClass("with-summary")),T(".book").replaceWith(f),T(".book").attr("class",g),T(".book-summary").scrollTop(m),N.state.$book=T(".book"),d(!a),a&&o(a),e.resolve()}})}).promise();return j.show(l.fail(function(e){console.log(e)}))}function h(){var e,t;e=parseInt(T(".body-inner").css("width"),10),t=parseInt(T(".page-wrapper").css("width"),10),T(".navigation-next").css("margin-right",e-t+"px");var n=r();n.unbind("scroll"),n.scroll(f)}function d(e){var t=T(".book-body"),n=t.find(".body-inner"),o=n.find(".page-wrapper");h(),o.focus();var i=r();e!==!1&&i.scrollTop(0),w=T(".book-summary .summary .chapter").filter(function(){var e=T(this).children("a"),t=null;if(!e.length)return!1;t=e.attr("href").split("#")[0];var n=k.resolve(window.location.pathname,t);return window.location.pathname==n}),w.length>1?i.scroll(f):C=w.first()}function g(e){return 0===e.button}function m(e){return!!(e.metaKey||e.altKey||e.ctrlKey||e.shiftKey)}function v(e){var t=T(this),n=t.attr("target");if(!m(e)&&g(e)&&!n){e.stopPropagation(),e.preventDefault();var r=t.attr("href");r&&p(r,!0)}}function y(){var e=T(".navigation-next").attr("href");e&&p(e,!0)}function b(){var e=T(".navigation-prev").attr("href");e&&p(e,!0)}function x(){T.ajaxSetup({cache:!1}),history.replaceState({path:window.location.href},""),window.onpopstate=function(e){if(null!==e.state)return p(e.state.path,!1)},T(document).on("click",".navigation-prev",v),T(document).on("click",".navigation-next",v),T(document).on("click",".summary [data-path] a",v),T(document).on("click",".page-inner a",v),T(window).resize(h),d(!1)}var w,C,T=e("jquery"),k=e("url"),j=e("./loading"),E=e("./platform"),N=window.gitbook,S="undefined"!=typeof history.pushState,A=location.href;t.exports={init:x,goNext:y,goPrev:b}},{"./loading":12,"./platform":14,jquery:1,url:7}],14:[function(e,t,n){var r=e("jquery");t.exports={isMobile:function(){return r(document).width()<=600},isSmallScreen:function(){return r(document).width()<=1240}}},{jquery:1}],15:[function(e,t,n){function r(e,t){null!=l.state&&o()==e||(null==t&&(t=!0),l.state.$book.toggleClass("without-animation",!t),l.state.$book.toggleClass("with-summary",e),l.storage.set("sidebar",o()))}function o(){return l.state.$book.hasClass("with-summary")}function i(){u.isMobile()||r(l.storage.get("sidebar",!0),!1),s(document).on("click",".book-summary li.chapter a",function(e){u.isMobile()&&r(!1,!1)})}function a(e){var t=s(".book-summary");t.find("li").each(function(){var t=s(this).data("path"),n=null==e||e.indexOf(t)!==-1;s(this).toggle(n),n&&s(this).parents("li").show()})}var s=e("jquery"),u=e("./platform"),l=window.gitbook;t.exports={init:i,isOpen:o,toggle:r,filter:a}},{"./platform":14,jquery:1}],16:[function(e,t,n){function r(){return"btn-"+g++}function o(e,t,n,r){var o=e.children(t).length;n<0&&(n=Math.max(0,o+1+n)),e.append(r),n<o&&e.children(t).eq(n).before(e.children(t).last())}function i(e){e.preventDefault()}function a(e){var t=p("<div>",{class:"dropdown-menu",html:'<div class="dropdown-caret"><span class="caret-outer"></span><span class="caret-inner"></span></div>'});if("string"==typeof e)t.append(e);else{var n=e.map(function(e){return p.isArray(e)?e:[e]});n.forEach(function(e){var n=p("<div>",{class:"buttons"}),r="size-"+e.length;e.forEach(function(e){e=p.extend({text:"",className:"",onClick:i},e||{});var t=p("<button>",{class:"button "+r+" "+e.className,text:e.text});t.click(e.onClick),n.append(t)}),t.append(n)})}return t}function s(e){return e=p.extend({label:"",icon:"",text:"",position:"left",className:"",onClick:i,dropdown:null,index:null,id:r()},e||{}),d.push(e),u(e),e.id}function u(e){var t,n=p(".book-header"),r=n.find("h1"),i="pull-"+e.position,s=p("<a>",{class:"btn",text:e.text?" "+e.text:"","aria-label":e.label,href:"#"});if(s.click(e.onClick),e.icon&&p("<i>",{class:e.icon}).prependTo(s),e.dropdown){var u=p("<div>",{class:"dropdown "+i+" "+e.className});s.addClass("toggle-dropdown"),u.append(s);var l=a(e.dropdown);l.addClass("dropdown-"+("right"==e.position?"left":"right")),u.append(l),t=u}else s.addClass(i),s.addClass(e.className),t=s;t.addClass("js-toolbar-action"),p.isNumeric(e.index)&&e.index>=0?o(n,".btn, .dropdown, h1",e.index,t):t.insertBefore(r)}function l(){p(".js-toolbar-action").remove(),d.forEach(u)}function c(e){d=p.grep(d,function(t){return t.id!=e}),l()}function f(e){d=p.grep(d,function(t){return e.indexOf(t.id)==-1}),l()}var p=e("jquery"),h=window.gitbook,d=[],g=0;h.events.on("page.change",function(){l()}),t.exports={createButton:s,removeButton:c,removeButtons:f}},{jquery:1}]},{},[10]);
diff --git a/clones/llthw.common-lisp.dev/index.html b/clones/llthw.common-lisp.dev/index.html
new file mode 100644
index 00000000..4224a117
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/index.html
@@ -0,0 +1,1882 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Second Draft (in-progress) · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="CHANGELOG.html" />
+    
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter active" data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Second Draft (in-progress)</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <p align="center">
+  <span style="font-size:36px;font-weight:bold;">Learn Lisp The Hard Way</span><br>
+  <span style="font-size:18px;">by the</span><br>
+  <span style="font-size:32px;">&quot;the Phoeron&quot; Colin J.E. Lupton</span>
+  
+</p>
+
+<pre><code class="lang-lisp"><span class="hljs-comment">;; Welcome to L(&#x3BB;)THW!</span>
+(<span class="hljs-name">let</span> ((<span class="hljs-name">llthw</span> &apos;(learn lisp the hard way)))
+  (<span class="hljs-name">format</span> <span class="hljs-literal">t</span> <span class="hljs-string">&quot;~{~@(~A~)~^ ~}, because ~{~A~^ ~} is easier!&quot;</span> llthw (<span class="hljs-name">cddr</span> llthw)))
+
+<span class="hljs-comment">;; Common Lisp: Powerful, Expressive, Programmable, General Purpose, Multi-Paradigm.</span>
+</code></pre>
+<p align="center">
+  <span style="font-size:18px;">Past Contributors:</span><br>
+  <span style="font-size:24px;">
+  Leo &quot;Inaimathi&quot; Zovic<br>
+  Dann Toliver<br>
+  Gaelen D&apos;Costa<br>
+  Josh Teneycke
+  </span>
+</p>
+
+<p align="center">
+<a rel="license" href="http://creativecommons.org/licenses/by-nd/4.0/" target="_blank"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-nd/4.0/88x31.png"></a><br><span xmlns:dct="http://purl.org/dc/terms/" property="dct:title">Learn Lisp The Hard Way</span> by <a xmlns:cc="http://creativecommons.org/ns#" href="https://thephoeron.common-lisp.dev" property="cc:attributionName" rel="cc:attributionURL" target="_blank">&quot;the Phoeron&quot; Colin J.E. Lupton</a> is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-nd/4.0/" target="_blank">Creative Commons Attribution-NoDerivatives 4.0 International License</a>.
+</p>
+
+<!--
+<div class="alert alert-danger">
+  <p>
+    <i class="fa fa-exclamation-triangle"></i> This is a draft-in-progress edition of Learn Lisp the Hard Way.  Content is being constantly added and revised.  Please check back often for updates.
+  </p>
+</div>
+-->
+<p><div class="alert alert-danger hints-alert"><div class="hints-icon"><i class="fa fa-exclamation-circle"></i></div><div class="hints-container"><p>This is a draft-in-progress edition of Learn Lisp the Hard Way. Content is being constantly added and revised. Please check back often for updates.</p>
+</div></div></p>
+<h2 id="supporting-this-project">Supporting This Project</h2>
+<p>If you would like to show your support for this project, please consider sponsoring the author through GitHub Sponsors:</p>
+<p><a href="https://github.com/sponsors/thephoeron" target="_blank">https://github.com/sponsors/thephoeron</a></p>
+<h2 id="recent-updates">Recent Updates</h2>
+<p>For a list of recent updates, please see the commit history on the source-control
+repository at:</p>
+<p><a href="https://gitlab.common-lisp.net/llthw/llthw.common-lisp.dev/-/commits/master" target="_blank">https://gitlab.common-lisp.net/llthw/llthw.common-lisp.dev/-/commits/master</a></p>
+<p>Updates to the LLTHW repository are automatically built and deployed to the live
+server, typically within 5 minutes or less.</p>
+<h2 id="issues">Issues</h2>
+<p>To report technical problems with the content of this book, please create an
+Issue on the source-control repository at:</p>
+<p><a href="https://gitlab.common-lisp.net/llthw/llthw.common-lisp.dev/-/issues" target="_blank">https://gitlab.common-lisp.net/llthw/llthw.common-lisp.dev/-/issues</a></p>
+<h2 id="faq">FAQ</h2>
+<p><strong>How long does this book take to complete?</strong></p>
+<p>You should take as long as you need with each module to fully grasp the material.
+It&apos;s not a race, and the only deadlines are the ones you set for yourself.</p>
+<p>Assuming you already have some programming experience and can do at least one
+module a day, you should expect to spend at least three months.</p>
+<p><strong>What kind of computer do I need?</strong></p>
+<p>Common Lisp is available for nearly every platform. Your personal computer,
+whether it be a Mac, Windows, or Linux platform, will be fine.  For all the
+features of this website, however, you may need to update your browser to the
+latest version of Edge, Chrome, Firefox, or Safari.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                
+                <a href="CHANGELOG.html" class="navigation navigation-next navigation-unique" aria-label="Next page: CHANGELOG">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"page.title":"Learn Lisp The Hard Way","author":"\\\"the Phoeron\\\" Colin J.E. Lupton","title":"Second Draft (in-progress)","level":"1.1","depth":1,"next":{"title":"CHANGELOG","level":"1.2","depth":1,"path":"CHANGELOG.md","ref":"CHANGELOG.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"index.md","mtime":"2022-08-24T15:49:02.031Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/introduction.html b/clones/llthw.common-lisp.dev/introduction.html
new file mode 100644
index 00000000..52a038d0
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/introduction.html
@@ -0,0 +1,1853 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Lisp: A Future History · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="acknowledgements.html" />
+    
+    
+    <link rel="prev" href="preface-part-three.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Lisp: A Future History</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="preface-pt-iv">Preface pt. IV</h1>
+<h2 id="lisp-a-future-history">Lisp, a Future History</h2>
+<blockquote>
+<p>&quot;The future is better than the past. Despite the crepehangers, romanticists, and anti-intellectuals, the world steadily grows better because the human mind, applying itself to environment, makes it better. With hands...with tools...with horse sense and science and engineering.&quot;</p>
+<footer>Robert A. Heinlein, <em>The Door Into Summer</em></footer>
+
+</blockquote>
+<p>Many of the books about Common Lisp currently available on the market start off with a review of Lisp&apos;s history.  This is sensible, being that the Lisp family of languages has such a long and rich lineage, there is much to tell.  Rather than present another take on the past, however, I wish to share my vision for the future of Lisp.  If the history of the Lisp language and its community interests you, which it should, please check out the many fine books listed under the Resources section of this site.</p>
+<h3 id="a-technology-driven-culture">A Technology Driven Culture</h3>
+<p>Human society has always been a technology-driven culture.  In every period of history, society was driven by innovation, ever since the very beginning of history when the ancient Sumerians first began carving words into clay tablets, to capture and preserve the fleeting vocalizations that would otherwise be lost in time the moment they had been spoken.  Even that innovation was not enough for them---they kept pushing the boundaries of what writing could do, from the very first accounting records to the hero&apos;s journey of Gilgamesh.</p>
+<p>We are no different today---we build on the work of those who came before us, we adapt and modify what already exists to suit our needs at the time, and sometimes, we stumble upon an innovation so important that it changes the world.  John McCarthy&apos;s first paper on Lisp was such an innovation.</p>
+<h3 id="programming-languages-today">Programming Languages Today</h3>
+<p>Today, Common Lisp is still setting the standard in the programming world, as no other language has yet come to match it in terms of speed, expressiveness, interactivity, and features.  Every so often, a new programming language comes out, or a new version of an old one, luring in software developers and system architects alike with empty promises of game-changing innovation; meanwhile, Lisp Hackers are having a private chuckle amongst themselves at the naivety of developers in the outer circle of tech.</p>
+<p>Specifically, such languages as Swift, Python, C++11, and Java 8 have been boasting recently about their ground-breaking new features, such as generics, functional programming constructs, lambda expressions, streams, and tail-call optimization, to name only a few. All of these features were established in the ANSI standardization of Common Lisp in the 1980s, plus countless more.  Lisp Hackers have had decades to use these feature sets, and push innovation further still.</p>
+<p>However, because of popular opinions in the programming world, such as &quot;Lisp is old and crufty&quot;, or &quot;Lisp is too hard to learn for the average programmer&quot;, the Lisp community has gotten smaller and smaller, and Lisp Hackers more and more expensive to hire.  As a result, many companies get scared when Lisp is pitched as the technology for a project, even when it is obviously the best choice.  Safe choices like C++, Java, .NET, Ruby, or Python are preferred, despite the many disadvantages and notorious bugginess.</p>
+<p>But a number of companies around the world have changed their tune---they&apos;re tired of the marketing gimmicks.  They&apos;re tired of paying for proprietary platforms, languages, and IDEs, riddled with bugs which need constant, daily security patches.  They&apos;re tired of building their product line in a language so unstable that they have to rewrite large sections of code every time there is one of these updates.  They&apos;re tired of feeling like every new programming language is just digital snake-oil.  They want a platform that works everywhere the same, to write code that doesn&apos;t break between security updates, to build a product that stands the test of time.  And as a result, more and more companies are turning to Lisp for answers---the only problem now is that there aren&apos;t enough Lisp Hackers to go around.</p>
+<h3 id="the-lisp-community">The Lisp Community</h3>
+<p>The Lisp community, albeit relatively small compared to languages such as Python or Haskell, is a much friendlier place.  Mostly because the Lisp language is itself inclusive, supporting every programming paradigm in the world, and allowing Lisp Hackers to create and implement their own paradigms easily.</p>
+<h3 id="lisp-consciousness">Lisp Consciousness</h3>
+<p>There&apos;s just something about Lisp---it changes the way you think, the way you see the world, the way you act.  Lisp Hackers have long known and proudly vocalized the near-mystical experience that comes with writing software in this language; they have adopted the Heinleinian terminology of &apos;grokking&apos; to describe the state of consciousness a programmer achieves when they stop just writing code in Lisp and start becoming one with their software; they have incorporated religious and mystical concepts from Gnosticism, Zen Buddhism, Hinduism, Sufism, and Western Occultism into the Lisp mythos.  Lisp teachers cannot simply teach a programming language as any other is taught; no, they feel compelled by a fire in their hearts to <em>preach the gospel</em> of Lisp.  Naturally, other people---particularly non-Lisp programmers---find this extremely off-putting.</p>
+<p>There is a rational explanation of this phenomenon, however; as it so happens, the syntax of Lisp software, in practice, follows the structure of the central nervous system.  Lisp models the brain.  The mind, which is itself very much like software, recognizes this shared structure and responds positively to it.  In other words, your mind, consciously or otherwise, sees itself and its underlying structure in Lisp as soon as it is able to make sense of what it is seeing, and as a result, awakens you to Lisp, just as you awakened once as a child the first time you looked into a mirror and realized you were seeing your own reflection. This is the moment you &apos;grok&apos; Lisp.</p>
+<p>But it doesn&apos;t stop there---grokking is just the beginning of your Lisp journey.  When the human brain and the computer are perfectly synchronized through a shared language that accurately models the underlying systems of both, the human mind naturally extends itself into the machine and experiences gestalt consciousness.  The mind is capable of unconsciously understanding the structure of the computer through the Lisp language, and as such, is able to interface with the computer as if it was an extension to its own nervous system.  This is Lisp Consciousness, where programmer and computer are one and the same; they drink of each other, and drink deep; and at least as long as the Lisp Hacker is there in the flow, riding the current of pure creativity and genius with their trusty companions Emacs and SLIME, neither programmer nor computer know where one ends and the other begins.  In a manner of speaking, Lispers already know machine intelligence---and it is beautiful.</p>
+<h3 id="convergence-theory-and-the-technological-singularity">Convergence Theory and the Technological Singularity</h3>
+<p>The mysterious force driving human society towards the technological singularity, true and total unification of human with technology, also seems to be shaping all programming languages into Lisp, and all computers into Lisp Machines.  Lisp, after all, can do everything, and do it every way; that Lisp is not already the de-facto programming language is just a reflection of the state of the world as a whole---only a very small percentage of the population are excited for the technological singularity, but the singularity is coming no matter how much people complain.  One way or another, every programmer is going to end up being a Lisper, because every programming language continues to adopt features and syntax from Lisp, one piece at a time.  It is in every programmer&apos;s interest to master Lisp now, before the world at large realizes how essential Lisp will become over the next two decades.</p>
+<p>Quantum Computing, the next big leap in computing and a fundamental aspect of the singularity, also currently happens to rely entirely on Lisp.  There are efforts underway to adapt quantum computer programming to all sorts of languages and familiar syntaxes, but the only real quantum computers currently available are effectively Quantum Lisp Machines, and have their operating system written in Common Lisp.  The power, simplicity, and elegance of Lisp really shines where it matters most: quantum computer programming is nearly impossible to understand unless you&apos;re a Lisp Hacker, but for a Lisp Hacker, it makes more sense than classical computing.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="preface-part-three.html" class="navigation navigation-prev " aria-label="Previous page: Who Is This Book For?">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="acknowledgements.html" class="navigation navigation-next " aria-label="Next page: Acknowledgements">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Lisp: A Future History","level":"2.4","depth":1,"next":{"title":"Acknowledgements","level":"2.5","depth":1,"path":"acknowledgements.md","ref":"acknowledgements.md","articles":[]},"previous":{"title":"Who Is This Book For?","level":"2.3","depth":1,"path":"preface-part-three.md","ref":"preface-part-three.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"introduction.md","mtime":"2022-08-23T00:01:55.640Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/preface-part-three.html b/clones/llthw.common-lisp.dev/preface-part-three.html
new file mode 100644
index 00000000..85e7a7ad
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/preface-part-three.html
@@ -0,0 +1,1859 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>Who Is This Book For? · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="introduction.html" />
+    
+    
+    <link rel="prev" href="preface-part-two.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >Who Is This Book For?</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="preface-pt-iii">Preface pt. III</h1>
+<h2 id="who-is-this-book-for">Who Is This Book For?</h2>
+<blockquote>
+<p>&quot;Do not handicap your children by making their lives easy.&quot;</p>
+<footer>Robert A. Heinlein, <em>Time Enough for Love</em></footer>
+
+</blockquote>
+<p>Programming books can be tedious, and usually come in only one of two bland flavours---so basic an introduction you know less about the language after reading the book, or so dense a tome it is not useful outside an ivy-league university&apos;s computer science program.  <em>The Hard Way</em> is different.</p>
+<p>You don&apos;t have to know anything about programming or computer science to learn Lisp with this book, but I&apos;m not going to talk down to you either.  I&apos;m going to assume that you know that learning any new skill is hard for everyone, and that you need to work hard in order to succeed.</p>
+<p>Sometimes, you might not understand what I&apos;m talking about, so I also expect you to take advantage of all the free research tools available on the internet---search engines, dictionaries, thesauri, encyclopedias, reference works, academic papers, programming blogs, and more.  Any time you feel completely boggled, you should turn to these.  I will be as casual as possible in my presentation, but sometimes it makes more sense to be formal.</p>
+<p>That being said, Lispers of all experience levels should benefit from this book.  We&apos;ll be exploring the language through real, immediately useful source code examples, and dissecting the language down to its core.  Later on in the book, we&apos;ll also be covering a wide variety of advanced, relevant practical applications using a selection of the most popular and powerful libraries from the Lisp community.</p>
+<p>So in summary, this book is for you if:</p>
+<ul>
+<li>You know nothing about programming, but want to learn</li>
+<li>You tried to learn Lisp before, but other books made it seem too hard or not useful</li>
+<li>You are an experienced programmer considering a move to Lisp</li>
+<li>You are already a Lisper, but want to take your code to the next level, or</li>
+<li>You simply haven&apos;t seen what all the fuss is about when it comes to Lisp---but you keep hearing how amazing Lisp is, so here you are reading another book about it</li>
+</ul>
+<h3 id="practice-and-persistence">Practice and Persistence</h3>
+<p>To learn any new skill, you have to take the time, while applying the five rules of learning the hard way.  You&apos;ll have good days and bad, times when you feel inspired and everything makes perfect sense, and times when you would rather just veg-out in front of the TV because you feel completely brain-dead already.  Keep in mind that to maintain a skill, the rule of thumb is to spend <em>at least</em> two hours a day practicing.  To improve an existing skill or learn a new one, it may require a lot more commitment from you.</p>
+<p>Once again, don&apos;t let yourself be disheartened if some days you can&apos;t seem to make sense of the exercises and material.  Learning any new skill takes a considerable shift in the way you think, as well as effort.  Also, don&apos;t let yourself get disheartened if you feel like you&apos;re not progressing fast enough---there&apos;s no timeline for the exercises, you&apos;re not competing with anyone else for the top grade.  You should take the time you need to complete each exercise at your own pace, so that you actually learn the material that the exercise covers.</p>
+<p>The best advice I can offer for when you hit the wall is to stick to the five steps of the Hard Way, no matter what.  Force yourself to work through the next exercise, even if it makes no sense.  You might just wake up the next day and suddenly get it---or you may need to repeat it a few times.  Persistence pays off, and if you stick with this methodology no matter what challenges you face, you will triumph.</p>
+<h3 id="attitude-and-intelligence">Attitude and Intelligence</h3>
+<p>Some of you will think I&apos;m joking when I say, &quot;forget everything you know.&quot;  I assure you, I&apos;m not.  Lisp is different than other languages---it&apos;s not imperative, procedural, object-oriented, or functional; it&apos;s <em>multi-paradigm</em>.  You need to be willing to set your ego aside and remember that everyone has more to learn than they have yet learned or ever can be learned.  Yes, Lisp is <em>that</em> different from other languages, even from other multi-paradigm programming languages.  If you take this to heart, you will discover that there is always something new to discover.</p>
+<p>From a technical perspective, intelligence is more of an attitude problem than a measure of ability.  When you think you are smart, you tend to think you already know everything and have all the answers.  This makes learning new skills an uphill battle.  You might not be guaranteed to fail at everything new when you already think you know everything, but you will find yourself easily discouraged by &quot;boredom&quot; as new knowledge is beaten away by your ever-swelling ego.</p>
+<p>Recognizing your own ignorance up-front allows you to learn without self-sabotage.  It is the wisdom of the ancients, every great artist&apos;s secret weapon, and an indispensable tool to a programmer.  And since The Lisp Way is so fundamentally different from other approaches to programming, this minor attitude adjustment will help you see Lisp without the blinders of previous experience.</p>
+<h3 id="the-end-goal">The End-Goal</h3>
+<p>The end-goal of teaching Lisp is to somehow convey the concept of &apos;grokking&apos; Lisp to new students of the language.  The main challenge with this task, in my humble opinion, is that not enough emphasis has been placed on first forgetting everything you know, and second on the core syntax of Lisp where the symmetry with the human mind and the fractal cosmology model of the universe are most obvious.  While other books on Lisp leave the matter of grokking open, hoping that by the end the reader will just grok grokking for themselves, in this book, grokking is a first-class citizen of your Lisp education.  It&apos;s that important.</p>
+<p>Lisp is, at its heart, a very mystical language which blurs the line between programming and magic.  It is so inspired that, as one of my blog readers suggested, it seems more as though it was created by the ancient Egyptian god of writing and magic, Thoth, and handed down to John McCarthy in revelation.  Several notable Lispers have even described that moment of their sudden awakening to understanding of Lisp as a religious experience, a suffusion of blue inspiring deep spiritual sentiments and a tendency towards prophesy.</p>
+<p>This is where the term &apos;grokking&apos; comes into the picture.  It was coined by speculative/science fiction author Robert A. Heinlein in his novel, Stranger in a Strange Land, to describe the experience of knowing something so deeply that you become a part of it as much as it becomes a part of you.  In short, Grokking is gnosis for the transhuman age.  So being that learning Lisp shares so much in common with mystical initiation, using the initiatory techniques of Occult orders in teaching Lisp makes a lot of sense.  This is why the Hard Way is the road to the Lisp Way, and why even experienced Lisp, Scheme, Clojure, Haskell, and OCaml programmers will benefit as greatly from this book as an absolute beginner.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="preface-part-two.html" class="navigation navigation-prev " aria-label="Previous page: The Hard Way is Easier">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="introduction.html" class="navigation navigation-next " aria-label="Next page: Lisp: A Future History">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Who Is This Book For?","level":"2.3","depth":1,"next":{"title":"Lisp: A Future History","level":"2.4","depth":1,"path":"introduction.md","ref":"introduction.md","articles":[]},"previous":{"title":"The Hard Way is Easier","level":"2.2","depth":1,"path":"preface-part-two.md","ref":"preface-part-two.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"preface-part-three.md","mtime":"2022-08-23T00:01:55.640Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/preface-part-two.html b/clones/llthw.common-lisp.dev/preface-part-two.html
new file mode 100644
index 00000000..ddc5548c
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/preface-part-two.html
@@ -0,0 +1,1864 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>The Hard Way is Easier · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="preface-part-three.html" />
+    
+    
+    <link rel="prev" href="preface.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter " data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >The Hard Way is Easier</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="preface-pt-ii">Preface pt. II</h1>
+<h2 id="the-hard-way-is-easier">The Hard Way Is Easier</h2>
+<blockquote>
+<p>&quot;The hardest part about gaining any new idea is sweeping out the false idea occupying that niche.  As long as that niche is occupied, evidence and proof and logical demonstration get nowhere.  But once the niche is emptied of the wrong idea that has been filling it---once you can honestly say, &apos;I don&apos;t know,&apos; then it becomes possible to get at the truth.&quot;</p>
+<footer>Robert A. Heinlein, <em>The Cat Who Walks Through Walls</em></footer>
+
+</blockquote>
+<p>Whatever you think you know about programming, forget it.  Lisp is different from other programming languages.</p>
+<p>If you&apos;re coming to Lisp as an experienced developer, it is only fair to tell you up-front that your experience will hold you back.  It will make you feel bored when the material isn&apos;t &quot;challenging you&quot;.  It will make you skip over sections you think you already understand.  It will tell you reading the code examples once is enough to learn it, that it&apos;s okay to copy-and-paste.  <em>But this experience is a lie</em>. If you slack off now, you&apos;ll only be making things harder for yourself later.</p>
+<p>No matter who you are or what your background is, if you stick to the steps of learning <em>The Hard Way</em>, you&apos;ll see that it is actually easier in the long run.  You&apos;ll have to work hard, but you&apos;ll learn what you need to learn the first time, and you won&apos;t forget it.</p>
+<p>Learning the hard way means following these five steps every day until you&apos;ve completed this book:</p>
+<ol>
+<li>Forget everything you know</li>
+<li>Work through each exercise from beginning to end</li>
+<li>Type in each example <em>exactly</em></li>
+<li>Make the code run</li>
+<li>Reflect on what you&apos;ve seen</li>
+</ol>
+<p>And that&apos;s all.</p>
+<p>Depending on your level of self-discipline, you may have a more difficult time sticking to these steps than some---but this isn&apos;t a contest.  Don&apos;t worry about how long it takes you to work through an exercise, don&apos;t panic if you have to miss a day, and don&apos;t compare yourself to others.  If you do your best to apply these steps every day, you will develop the self-discipline required to see this book through to the end.</p>
+<p>An important theme of this book is also on the skills necessary for programming in general, while using Lisp to reinforce them.  These skills are: reading and writing, attention to detail, spotting differences, and mathematics.  Thus, once you finish this book, you won&apos;t just be a Lisp Hacker, you&apos;ll be ready to tackle other programming languages too---and in the process you might just discover that learning a new skill is more fun than any hobby, game, movie, or tv show.</p>
+<h3 id="reading-and-writing">Reading and Writing</h3>
+<p>Programming, much like human language, involves the intentional use of a specific set of language-dependent characters that have <em>meaning</em>, some of which you might not be used to typing. Programming is significantly more exact than human languages---if you have trouble reading, writing, or typing, you will struggle writing code.</p>
+<p>Take the time to read over the code examples carefully, and double-check your work once you have typed it.  This will save you from many stress headaches along the way.</p>
+<h3 id="attention-to-detail">Attention to Detail</h3>
+<p>More than any other skill, what separates a professional from an amateur in every field and trade is attention to detail.  In programming, this is especially obvious; it makes the difference between sluggish, buggy software that regularly crashes and leads to hair-loss in its users, and a refined, user-friendly, indispensable tool.</p>
+<p>By manually typing each exercise <em>exactly</em> as you work through this book, you will be training your brain to focus on the subtle details of what you are doing, while you are doing it.</p>
+<h3 id="spotting-differences">Spotting Differences</h3>
+<p>The natural extension to the first two skills is the ability to spot differences.  With careful reading, typing, and attention to detail, you will also be training your brain to highlight subtle differences for you, so that when you make a mistake, you notice, and can correct it immediately.</p>
+<p>Naturally, this skill will also help you more quickly spot and correct bugs in other people&apos;s code that you have to upgrade and maintain.</p>
+<h3 id="mathematics">Mathematics</h3>
+<p>Remember in high school, there was always at least one classmate that would demand to know when, in life, any of you would ever need to know half the stuff they taught you?  You may have even been that student.  If so, you may be disappointed to know that many problem domains a professional programmer has to deal with on a daily basis require nearly the entire high school and university level math curricula.  I&apos;m not talking about highly specialized fields either, like Quantum Computing; Currency, Stock, and Commodity exchange; or Cryptography---junior game, mobile, and web developers need math too.  As <a href="http://zedshaw.com/archive/programmers-need-to-learn-statistics-or-i-will-kill-them-all/" target="_blank">Zed Shaw argued</a> in an excellent, albeit <em>angry rant</em> essay, at the very least you should know Statistics.  But Algebra, Geometry, Trigonometry, Calculus, Lambda Calculus---and of course, Algorithms---are extremely useful tools that will help you reason about and abstract your code at a whole new level.</p>
+<p>If the very idea of math makes your heart skip a beat, your hands shake, and your brow drip with sweat, just remember the infamous words inscribed on the cover of the Hitchhiker&apos;s Guide to the Galaxy: DON&apos;T PANIC. You <em>don&apos;t have to be a math-whiz</em> to learn programming <em>or</em> Lisp, and this book assumes little to no familiarity with math above the grade-school level. You can learn the math you need along the way, when you need it---and you will probably understand it better this time because you&apos;ll see its practical value.  Just remember that math is your friend---even when it&apos;s not essential, formal quantitative reasoning, analysis, and deductive reasoning will give you an edge over other developers, and help you write better software.  Oh right, and <em>make sure you know where your towel is</em>.</p>
+<h3 id="no-copy-and-paste">No Copy-and-Paste</h3>
+<p>If you copy-and-paste the code from the exercises into the Lisp REPL instead of typing them out yourself, you might as well not do them at all.  As both teacher and student for the duration of this book, you have to force yourself to type in every example.  No matter how easy or self-evident a code example appears to be, you have to stop yourself from cheating.</p>
+<p>The point of these exercises is to train your hands, your eyes, your brain, and your mind how to read, write, see, think, and dream code.  When you cheat here, you&apos;re only cheating yourself.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="preface.html" class="navigation navigation-prev " aria-label="Previous page: TANSTAAFL">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="preface-part-three.html" class="navigation navigation-next " aria-label="Next page: Who Is This Book For?">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"The Hard Way is Easier","level":"2.2","depth":1,"next":{"title":"Who Is This Book For?","level":"2.3","depth":1,"path":"preface-part-three.md","ref":"preface-part-three.md","articles":[]},"previous":{"title":"TANSTAAFL","level":"2.1","depth":1,"path":"preface.md","ref":"preface.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"preface-part-two.md","mtime":"2022-08-23T00:01:55.640Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+
diff --git a/clones/llthw.common-lisp.dev/preface.html b/clones/llthw.common-lisp.dev/preface.html
new file mode 100644
index 00000000..dceca8a9
--- /dev/null
+++ b/clones/llthw.common-lisp.dev/preface.html
@@ -0,0 +1,1838 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <meta charset="UTF-8">
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <title>TANSTAAFL · Learn Lisp The Hard Way</title>
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.2.3">
+        <meta name="author" content=""the Phoeron" Colin J.E. Lupton">
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-hints/plugin-hints.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-folding-chapters/folding-chapters.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="preface-part-two.html" />
+    
+    
+    <link rel="prev" href="TODO.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        <li class="header">LEARN LISP THE HARD WAY</li>
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="index.html">
+            
+                    
+                    Second Draft (in-progress)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="CHANGELOG.html">
+            
+                <a href="CHANGELOG.html">
+            
+                    
+                    CHANGELOG
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="TODO.html">
+            
+                <a href="TODO.html">
+            
+                    
+                    TODO
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PREFACE</li>
+        
+        
+    
+        <li class="chapter active" data-level="2.1" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    TANSTAAFL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.2" data-path="preface-part-two.html">
+            
+                <a href="preface-part-two.html">
+            
+                    
+                    The Hard Way is Easier
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.3" data-path="preface-part-three.html">
+            
+                <a href="preface-part-three.html">
+            
+                    
+                    Who Is This Book For?
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.4" data-path="introduction.html">
+            
+                <a href="introduction.html">
+            
+                    
+                    Lisp: A Future History
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="2.5" data-path="acknowledgements.html">
+            
+                <a href="acknowledgements.html">
+            
+                    
+                    Acknowledgements
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART ONE</li>
+        
+        
+    
+        <li class="chapter " data-level="3.1" data-path="1-0-0-overview.html">
+            
+                <a href="1-0-0-overview.html">
+            
+                    
+                    Grokking Lisp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1" data-path="1-01-00-lisp-bootcamp.html">
+            
+                <a href="1-01-00-lisp-bootcamp.html">
+            
+                    
+                    Common Lisp Bootcamp
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.1.1" data-path="1-01-01-syntax-overview.html">
+            
+                <a href="1-01-01-syntax-overview.html">
+            
+                    
+                    Syntax Overview in 5 Minutes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.2" data-path="1-01-02-repl.html">
+            
+                <a href="1-01-02-repl.html">
+            
+                    
+                    The REPL
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.3" data-path="1-01-03-expressions.html">
+            
+                <a href="1-01-03-expressions.html">
+            
+                    
+                    Expressions, Parentheses, and Return Values
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.4" data-path="1-01-04-lists-cons-cells.html">
+            
+                <a href="1-01-04-lists-cons-cells.html">
+            
+                    
+                    Lists, Cons-Cells, and Memory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.5" data-path="1-01-05-symbols.html">
+            
+                <a href="1-01-05-symbols.html">
+            
+                    
+                    Symbols and Namespaces
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.6" data-path="1-01-06-prefix-notation.html">
+            
+                <a href="1-01-06-prefix-notation.html">
+            
+                    
+                    Prefix Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.7" data-path="1-01-07-style-guide.html">
+            
+                <a href="1-01-07-style-guide.html">
+            
+                    
+                    Common Lisp Style Guide
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.1.8" data-path="1-01-08-configuration.html">
+            
+                <a href="1-01-08-configuration.html">
+            
+                    
+                    Configuring Your Development Environment
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2" data-path="1-02-00-input-output.html">
+            
+                <a href="1-02-00-input-output.html">
+            
+                    
+                    Printing, Streams, and Strings
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.2.1" data-path="1-02-01-strings.html">
+            
+                <a href="1-02-01-strings.html">
+            
+                    
+                    Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.2" data-path="1-02-02-more-strings.html">
+            
+                <a href="1-02-02-more-strings.html">
+            
+                    
+                    More Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.3" data-path="1-02-03-unicode.html">
+            
+                <a href="1-02-03-unicode.html">
+            
+                    
+                    Unicode and Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.4" data-path="1-02-04-chars.html">
+            
+                <a href="1-02-04-chars.html">
+            
+                    
+                    Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.5" data-path="1-02-05-more-chars.html">
+            
+                <a href="1-02-05-more-chars.html">
+            
+                    
+                    More Characters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.6" data-path="1-02-06-char-codes.html">
+            
+                <a href="1-02-06-char-codes.html">
+            
+                    
+                    Character Codes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.7" data-path="1-02-07-strings-from-chars.html">
+            
+                <a href="1-02-07-strings-from-chars.html">
+            
+                    
+                    Strings from Chars
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.8" data-path="1-02-08-printing.html">
+            
+                <a href="1-02-08-printing.html">
+            
+                    
+                    Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.9" data-path="1-02-09-more-printing.html">
+            
+                <a href="1-02-09-more-printing.html">
+            
+                    
+                    More Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.10" data-path="1-02-10-prin1.html">
+            
+                <a href="1-02-10-prin1.html">
+            
+                    
+                    Printing With prin1
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.11" data-path="1-02-11-princ.html">
+            
+                <a href="1-02-11-princ.html">
+            
+                    
+                    Printing With princ
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.12" data-path="1-02-12-format.html">
+            
+                <a href="1-02-12-format.html">
+            
+                    
+                    A Brief Introduction to Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.13" data-path="1-02-13-more-format.html">
+            
+                <a href="1-02-13-more-format.html">
+            
+                    
+                    A Little Bit More on Format
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.14" data-path="1-02-14-pathnames.html">
+            
+                <a href="1-02-14-pathnames.html">
+            
+                    
+                    Pathnames
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.15" data-path="1-02-15-streams.html">
+            
+                <a href="1-02-15-streams.html">
+            
+                    
+                    Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.16" data-path="1-02-16-file-streams.html">
+            
+                <a href="1-02-16-file-streams.html">
+            
+                    
+                    File Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.17" data-path="1-02-17-binary-streams.html">
+            
+                <a href="1-02-17-binary-streams.html">
+            
+                    
+                    Binary Streams
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.18" data-path="1-02-18-prompting-users.html">
+            
+                <a href="1-02-18-prompting-users.html">
+            
+                    
+                    Prompting Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.2.19" data-path="1-02-19-pretty-printing.html">
+            
+                <a href="1-02-19-pretty-printing.html">
+            
+                    
+                    Pretty-Printing
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.3" data-path="1-03-0-getting-input-from-users.html">
+            
+                <a href="1-03-0-getting-input-from-users.html">
+            
+                    
+                    Extra Credit: Getting Input from Users
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.4" data-path="1-04-0-lists.html">
+            
+                <a href="1-04-0-lists.html">
+            
+                    
+                    Lists and List-Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.5" data-path="1-05-0-lookups-trees.html">
+            
+                <a href="1-05-0-lookups-trees.html">
+            
+                    
+                    Extra Credit: Look-up Lists and Trees
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6" data-path="1-06-0-math.html">
+            
+                <a href="1-06-0-math.html">
+            
+                    
+                    Numbers and Math
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="3.1.6.1" data-path="1-06-01-integers.html">
+            
+                <a href="1-06-01-integers.html">
+            
+                    
+                    Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.2" data-path="1-06-02-more-integers.html">
+            
+                <a href="1-06-02-more-integers.html">
+            
+                    
+                    More Integers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.3" data-path="1-06-03-hexadecimal-notation.html">
+            
+                <a href="1-06-03-hexadecimal-notation.html">
+            
+                    
+                    Hexadecimal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.4" data-path="1-06-04-octal-notation.html">
+            
+                <a href="1-06-04-octal-notation.html">
+            
+                    
+                    Octal Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.5" data-path="1-06-05-binary-notation.html">
+            
+                <a href="1-06-05-binary-notation.html">
+            
+                    
+                    Binary Integer Notation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.6" data-path="1-06-06-ratios.html">
+            
+                <a href="1-06-06-ratios.html">
+            
+                    
+                    Ratios and Rational Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.7" data-path="1-06-07-floating-point.html">
+            
+                <a href="1-06-07-floating-point.html">
+            
+                    
+                    Floating-point Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.8" data-path="1-06-08-constants.html">
+            
+                <a href="1-06-08-constants.html">
+            
+                    
+                    Numeric Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.9" data-path="1-06-09-complex-numbers.html">
+            
+                <a href="1-06-09-complex-numbers.html">
+            
+                    
+                    Complex Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.10" data-path="1-06-10-arithmetic.html">
+            
+                <a href="1-06-10-arithmetic.html">
+            
+                    
+                    Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.11" data-path="1-06-11-more-arithmetic.html">
+            
+                <a href="1-06-11-more-arithmetic.html">
+            
+                    
+                    More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.12" data-path="1-06-12-even-more-arithmetic.html">
+            
+                <a href="1-06-12-even-more-arithmetic.html">
+            
+                    
+                    Even More Arithmetic
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.13" data-path="1-06-13-exponents.html">
+            
+                <a href="1-06-13-exponents.html">
+            
+                    
+                    Exponents
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.14" data-path="1-06-14-logarithms.html">
+            
+                <a href="1-06-14-logarithms.html">
+            
+                    
+                    Logarithms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.15" data-path="1-06-15-trigonometry.html">
+            
+                <a href="1-06-15-trigonometry.html">
+            
+                    
+                    Trigonometry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.6.16" data-path="1-06-16-psuedorandom-numbers.html">
+            
+                <a href="1-06-16-psuedorandom-numbers.html">
+            
+                    
+                    Pseudo-Random Numbers
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.7" data-path="1-07-0-arrays.html">
+            
+                <a href="1-07-0-arrays.html">
+            
+                    
+                    Extra Credit: Arrays and Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.8" data-path="1-08-0-variables.html">
+            
+                <a href="1-08-0-variables.html">
+            
+                    
+                    Variables, Parameters, and Constants
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.9" data-path="1-09-0-closures.html">
+            
+                <a href="1-09-0-closures.html">
+            
+                    
+                    Extra Credit: Closures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.10" data-path="1-10-0-functions.html">
+            
+                <a href="1-10-0-functions.html">
+            
+                    
+                    Functions and Macros
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.11" data-path="1-11-0-text-adventure.html">
+            
+                <a href="1-11-0-text-adventure.html">
+            
+                    
+                    Extra Credit: A Simple Text Adventure
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.12" data-path="1-12-0-namespaces.html">
+            
+                <a href="1-12-0-namespaces.html">
+            
+                    
+                    Namespaces, Symbols, Packages, and Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.13" data-path="1-13-0-simple-web-app.html">
+            
+                <a href="1-13-0-simple-web-app.html">
+            
+                    
+                    Extra Credit: A Simple Web Application
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.14" data-path="1-14-0-conditionals.html">
+            
+                <a href="1-14-0-conditionals.html">
+            
+                    
+                    Conditionals
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.15" data-path="1-15-0-command-line-utility.html">
+            
+                <a href="1-15-0-command-line-utility.html">
+            
+                    
+                    Extra Credit: Command-Line Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.16" data-path="1-16-0-map-loop.html">
+            
+                <a href="1-16-0-map-loop.html">
+            
+                    
+                    Mapping and Looping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.17" data-path="1-17-0-iterate.html">
+            
+                <a href="1-17-0-iterate.html">
+            
+                    
+                    Extra Credit: Revisiting Loops with Iterate
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.18" data-path="1-18-0-format.html">
+            
+                <a href="1-18-0-format.html">
+            
+                    
+                    Format Strings
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.19" data-path="1-19-0-dsl.html">
+            
+                <a href="1-19-0-dsl.html">
+            
+                    
+                    Extra Credit: Domain Specific Languages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="3.1.20" data-path="1-20-0-review.html">
+            
+                <a href="1-20-0-review.html">
+            
+                    
+                    Part One in Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART TWO</li>
+        
+        
+    
+        <li class="chapter " data-level="4.1" data-path="2-0-0-overview.html">
+            
+                <a href="2-0-0-overview.html">
+            
+                    
+                    The Suffusion of Blue
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="4.1.1" data-path="2-01-0-programming-paradigms.html">
+            
+                <a href="2-01-0-programming-paradigms.html">
+            
+                    
+                    Programming Paradigms
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.2" data-path="2-02-0-regex.html">
+            
+                <a href="2-02-0-regex.html">
+            
+                    
+                    Extra Credit: Regular Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.3" data-path="2-03-0-objects-control.html">
+            
+                <a href="2-03-0-objects-control.html">
+            
+                    
+                    Objects and Control Structures
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.4" data-path="2-04-0-data-persistence.html">
+            
+                <a href="2-04-0-data-persistence.html">
+            
+                    
+                    Extra Credit: Persistence and Databases
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.5" data-path="2-05-0-extended-types.html">
+            
+                <a href="2-05-0-extended-types.html">
+            
+                    
+                    Extended Types
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.6" data-path="2-06-0-threads-memos-parallel.html">
+            
+                <a href="2-06-0-threads-memos-parallel.html">
+            
+                    
+                    Extra Credit: Concurrency and Memoization
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.7" data-path="2-07-0-logic-and-more-math.html">
+            
+                <a href="2-07-0-logic-and-more-math.html">
+            
+                    
+                    Logic and Advanced Math
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.8" data-path="2-08-0-number-theory.html">
+            
+                <a href="2-08-0-number-theory.html">
+            
+                    
+                    Extra Credit: Number Theory
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.9" data-path="2-09-0-binary-octets-bits.html">
+            
+                <a href="2-09-0-binary-octets-bits.html">
+            
+                    
+                    Binary Streams, Octet-Vectors, and Bit-Vectors
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.10" data-path="2-10-0-improved-text-adventure-engine.html">
+            
+                <a href="2-10-0-improved-text-adventure-engine.html">
+            
+                    
+                    Extra Credit: An Improved Text Adventure Engine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.11" data-path="2-11-0-conditions.html">
+            
+                <a href="2-11-0-conditions.html">
+            
+                    
+                    Conditions and Error Handling
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.12" data-path="2-12-0-2d-game.html">
+            
+                <a href="2-12-0-2d-game.html">
+            
+                    
+                    Extra Credit: Write a 2D Game
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.13" data-path="2-13-0-compiler.html">
+            
+                <a href="2-13-0-compiler.html">
+            
+                    
+                    The Compiler
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.14" data-path="2-14-0-tree-shaker.html">
+            
+                <a href="2-14-0-tree-shaker.html">
+            
+                    
+                    Extra Credit: Write a Tree-Shaker
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.15" data-path="2-15-0-docs-and-inspection.html">
+            
+                <a href="2-15-0-docs-and-inspection.html">
+            
+                    
+                    Documentation and Inspection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.16" data-path="2-16-0-foreign-libs.html">
+            
+                <a href="2-16-0-foreign-libs.html">
+            
+                    
+                    Extra Credit: Foreign Libraries in Lisp
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.17" data-path="2-17-0-debugging-testing.html">
+            
+                <a href="2-17-0-debugging-testing.html">
+            
+                    
+                    Debugging and Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.18" data-path="2-18-0-ffi.html">
+            
+                <a href="2-18-0-ffi.html">
+            
+                    
+                    Extra Credit: Write a Foreign Function Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.19" data-path="2-19-0-essential-libs.html">
+            
+                <a href="2-19-0-essential-libs.html">
+            
+                    
+                    Essential Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.20" data-path="2-20-0-packaging-libs.html">
+            
+                <a href="2-20-0-packaging-libs.html">
+            
+                    
+                    Extra Credit: Packaging Lisp Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="4.1.21" data-path="2-21-0-review.html">
+            
+                <a href="2-21-0-review.html">
+            
+                    
+                    Detailed Syntax Review
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+        
+        <li class="header">PART THREE</li>
+        
+        
+    
+        <li class="chapter " data-level="5.1" data-path="3-00-00-overview.html">
+            
+                <a href="3-00-00-overview.html">
+            
+                    
+                    Lisp So(u)rcery
+            
+                </a>
+            
+
+            
+            <ul class="articles">
+                
+    
+        <li class="chapter " data-level="5.1.1" data-path="3-01-00-web-apps.html">
+            
+                <a href="3-01-00-web-apps.html">
+            
+                    
+                    Real-world Web Apps
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.2" data-path="3-02-00-typesetting.html">
+            
+                <a href="3-02-00-typesetting.html">
+            
+                    
+                    Typesetting
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.3" data-path="3-03-00-mobile.html">
+            
+                <a href="3-03-00-mobile.html">
+            
+                    
+                    Native Mobile Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.4" data-path="3-04-00-gui.html">
+            
+                <a href="3-04-00-gui.html">
+            
+                    
+                    Cross-platform Desktop Applications
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.5" data-path="3-05-00-system-utils.html">
+            
+                <a href="3-05-00-system-utils.html">
+            
+                    
+                    Drivers, Daemons, and System-Utilities
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.6" data-path="3-06-00-reverse-engineering.html">
+            
+                <a href="3-06-00-reverse-engineering.html">
+            
+                    
+                    Reverse Engineering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.7" data-path="3-07-00-graphics.html">
+            
+                <a href="3-07-00-graphics.html">
+            
+                    
+                    Graphics Rendering
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.8" data-path="3-08-00-gaming.html">
+            
+                <a href="3-08-00-gaming.html">
+            
+                    
+                    OpenGL, SDL, and 3D Game Development
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.9" data-path="3-09-00-audio.html">
+            
+                <a href="3-09-00-audio.html">
+            
+                    
+                    Audio Generation and Manipulation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.10" data-path="3-10-00-data.html">
+            
+                <a href="3-10-00-data.html">
+            
+                    
+                    Data Aggregation and Analysis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.11" data-path="3-11-00-cryptosec.html">
+            
+                <a href="3-11-00-cryptosec.html">
+            
+                    
+                    Cryptography and Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.12" data-path="3-12-00-fintech.html">
+            
+                <a href="3-12-00-fintech.html">
+            
+                    
+                    Financial Software and Crypto-Currencies
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.13" data-path="3-13-00-scientific-computing.html">
+            
+                <a href="3-13-00-scientific-computing.html">
+            
+                    
+                    Scientific Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.14" data-path="3-14-00-computational-physics.html">
+            
+                <a href="3-14-00-computational-physics.html">
+            
+                    
+                    Computational Physics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.15" data-path="3-15-00-quantum-computing.html">
+            
+                <a href="3-15-00-quantum-computing.html">
+            
+                    
+                    Quantum Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.16" data-path="3-16-00-nlp.html">
+            
+                <a href="3-16-00-nlp.html">
+            
+                    
+                    Natural Language Processing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.17" data-path="3-17-00-ai.html">
+            
+                <a href="3-17-00-ai.html">
+            
+                    
+                    Artificial Intelligence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.18" data-path="3-18-00-robotics.html">
+            
+                <a href="3-18-00-robotics.html">
+            
+                    
+                    Robotics
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.19" data-path="3-19-00-space-tech.html">
+            
+                <a href="3-19-00-space-tech.html">
+            
+                    
+                    Space Tech
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.20" data-path="3-20-00-neurotech.html">
+            
+                <a href="3-20-00-neurotech.html">
+            
+                    
+                    Neuroscience and Thought-Controlled Computing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.21" data-path="3-21-00-lispos.html">
+            
+                <a href="3-21-00-lispos.html">
+            
+                    
+                    A Simple LispOS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.22" data-path="3-22-00-lisp-machine.html">
+            
+                <a href="3-22-00-lisp-machine.html">
+            
+                    
+                    Build Your Own Lisp Machine
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="5.1.23" data-path="3-23-00-gov-mil.html">
+            
+                <a href="3-23-00-gov-mil.html">
+            
+                    
+                    Government and Military Grade Systems
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+            </ul>
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="index.html" >TANSTAAFL</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="preface-pt-i">Preface pt. I</h1>
+<h2 id="tanstaafl">TANSTAAFL</h2>
+<blockquote>
+<p>&quot;There Ain&apos;t No Such Thing As A Free Lunch... anything free costs twice as much in the long run or turns out worthless.&quot;</p>
+<footer>Robert A. Heinlein, <em>The Moon Is A Harsh Mistress</em></footer>
+
+</blockquote>
+<p>Programming is hard.  Anyone who says differently is either trying to make you feel inferior to them or sell you something.  In the case of many &quot;easy-to-learn&quot; programming languages, both happen to be true.  But you&apos;re not here for inefficient, glorified, instant-gratification scripting languages that pigeon-hole you into prescribed execution control-flows and common use cases.  You&apos;re not here for monolithic imperative languages that have to be tamed into submission for the simplest tasks.  You&apos;ve sought out <em>the Hard Way</em>, and the hardest language to master, Common Lisp.  You&apos;re not afraid of working for what you want or committing to a new way of thinking---you&apos;re here because you want to be a Lisp Hacker, and you&apos;re not going to let anything get in your way.</p>
+<p>That being said, learning Lisp is not an impossible dream.  Like any skill, practice makes perfect---and that&apos;s what <em>the Hard Way</em> is all about.  Lisp may seem like an ancient mystical secret, cherished and protected by an impenetrable cabal of hacker elites, but that, much like the language&apos;s popular association solely with Artificial Intelligence, is a misconception.  You don&apos;t have to be a genius or Black Hat to crack the mystery surrounding the language and the open-source subculture where it thrives.  You just have to follow a few essential steps, and apply them without fail.</p>
+<p>The biggest secret to Lisp is that it is actually the simplest programming language ever created---and that, coupled with its expressiveness and elegance, is why it is favored exclusively by the best programmers in the world.  With hard work, attention to detail, and careful reflection over the subject material, you will be up and running with Lisp and writing real applications much earlier than you could with other, lesser languages.</p>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="TODO.html" class="navigation navigation-prev " aria-label="Previous page: TODO">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="preface-part-two.html" class="navigation navigation-next " aria-label="Next page: The Hard Way is Easier">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"TANSTAAFL","level":"2.1","depth":1,"next":{"title":"The Hard Way is Easier","level":"2.2","depth":1,"path":"preface-part-two.md","ref":"preface-part-two.md","articles":[]},"previous":{"title":"TODO","level":"1.3","depth":1,"path":"TODO.md","ref":"TODO.md","articles":[]},"dir":"ltr"},"config":{"plugins":["hints","folding-chapters"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"hints":{"danger":"fa fa-exclamation-circle","info":"fa fa-info-circle","tip":"fa fa-mortar-board","working":"fa fa-wrench"},"folding-chapters":{},"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"\"the Phoeron\" Colin J.E. Lupton","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"index.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Learn Lisp The Hard Way","gitbook":"*"},"file":{"path":"preface.md","mtime":"2022-08-23T00:01:55.640Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2022-08-24T16:15:01.957Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-folding-chapters/folding-chapters.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+